1. 1
2. 2
3. 3
4. 4
5. 5
6. 6
7. 7
8. 8
9. 9
10. 10
11. 11
12. 12
13. 13
14. 14
15. 15
16. 16
17. 17
18. 18
19. 19
20. 20
21. 21
22. 22
23. 23
24. 24
25. 25
26. 26
27. 27
28. 28
29. 29
30. 30
31. 31
32. 32
33. 33
34. 34
35. 35
36. 36
37. 37
38. 38
39. 39
40. 40
41. 41
42. 42
43. 43
44. 44
45. 45
46. 46
47. 47
48. 48
49. 49
50. 50
51. 51
52. 52
53. 53
54. 54
55. 55
56. 56
57. 57
58. 58
59. 59
60. 60
61. 61
62. 62
63. 63
64. 64
65. 65
66. 66
67. 67
68. 68
69. 69
70. 70
71. 71
72. 72
73. 73
74. 74
75. 75
76. 76
77. 77

// SPDX-FileCopyrightText: 2024 Shota FUJI <pockawoooh@gmail.com>
// SPDX-License-Identifier: AGPL-3.0-only

export interface UIComponent<
	TagName extends string,
	Element extends CustomElementConstructor,
> {
	readonly tagName: TagName;
	readonly constructor: Element;
	register(): boolean;
}

/**
 * CustomElement を使いやすい I/F にラップする。
 * 渡された CustomElement は自動的に `nonUAMixin` が適用され、
 * `:is(:state(nonua), :--nonua, [nonua])` でクエリできるようになる。
 */
export function component<
	TagName extends string,
	Element extends CustomElementConstructor,
>(tagName: TagName, constructor: Element): UIComponent<TagName, Element> {
	return {
		tagName,
		constructor,
		register() {
			if (customElements.get(tagName)) {
				return false;
			}

			customElements.define(tagName, nonUAMixin(constructor));
			return true;
		},
	};
}

/**
 * Custom Element を "nonua" というキーワードで CSS からセレクトできるようにする mixin 。
 *
 * CSS では未だにビルトインのタグとユーザ定義のタグをセレクトできず、また UA のスタイルを
 * 無効化する仕様も存在しない。そのため、UA が勝手に定義したスタイルを削除するためには、
 * 1. Custom Element に識別用のマーカーを設定
 * 2. マーカーのついていないものを全てリセット
 * とするしかない。この手法だと 3rd party の要素までもリセットされてしまうが、
 * このプロジェクトにおいては 3rd party の Custom Element は利用しないためこの手法で
 * 問題はない。
 *
 * 付与するマーカーは以下の通り:
 *
 * A) CustomStateSet の `nonua` ステート (Evergreen Browser)
 * B) CustomStateSet の `--nonua` ステート (Chromium v90 <= x < v125)
 * C) `nonua` 属性
 *
 * 全てのマーカーに対応するには以下のようなセレクタが必要。
 *
 * ```css
 * :is(:state(nonua), :--nonua, [nonua])
 * ```
 */
function nonUAMixin<T extends CustomElementConstructor>(ctor: T): T {
	return class WithNonUA extends ctor {
		constructor(...params: any[]) {
			super(...params);

			const internals = this.attachInternals();
			if (internals && internals.states) {
				// https://developer.mozilla.org/en-US/docs/Web/API/CustomStateSet#compatibility_with_dashed-ident_syntax
				try {
					internals.states.add("nonua");
				} catch {
					internals.states.add("--nonua");
				}
			} else {
				this.setAttribute("nonua", "");
			}
		}
	};
}