@glasshome/ui 1.42.0 → 1.43.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (147) hide show
  1. package/dist/index.js +2 -2
  2. package/dist/lib/anchor-placement.d.ts +4 -0
  3. package/dist/lib/balance-rows.d.ts +10 -4
  4. package/dist/lib/behavior/anchored.d.ts +16 -2
  5. package/dist/lib/behavior/button-root.d.ts +7 -0
  6. package/dist/lib/behavior/collection.d.ts +8 -0
  7. package/dist/lib/behavior/dismiss.d.ts +6 -4
  8. package/dist/lib/behavior/focus-scope.d.ts +7 -1
  9. package/dist/lib/behavior/hide-outside.d.ts +1 -1
  10. package/dist/lib/behavior/layer-stack.d.ts +3 -2
  11. package/dist/lib/behavior/menu.d.ts +59 -0
  12. package/dist/lib/behavior/modal-root.d.ts +2 -0
  13. package/dist/lib/behavior/range.d.ts +44 -0
  14. package/dist/lib/color/color.d.ts +41 -0
  15. package/dist/lib/color/index.d.ts +2 -0
  16. package/dist/lib/color/intl.d.ts +40 -0
  17. package/dist/lib/dock-slot-classes.d.ts +2 -0
  18. package/dist/lib/hold.d.ts +1 -1
  19. package/dist/lib/locale.d.ts +3 -0
  20. package/dist/lib/menu-classes.d.ts +2 -0
  21. package/dist/lib/motion-classes.d.ts +1 -1
  22. package/dist/lib/overlay-classes.d.ts +1 -0
  23. package/dist/lib/scroll-track.d.ts +3 -2
  24. package/dist/lib/section-tokens.d.ts +1 -1
  25. package/dist/lib/segment-classes.d.ts +2 -0
  26. package/dist/lib/shadow-layer.d.ts +0 -45
  27. package/dist/lib/toggle-set.d.ts +44 -0
  28. package/dist/lib/visually-hidden.d.ts +3 -0
  29. package/dist/solid/accordion.d.ts +35 -11
  30. package/dist/solid/avatar.d.ts +8 -4
  31. package/dist/solid/bottom-sheet/bottom-sheet.d.ts +1 -1
  32. package/dist/solid/button.d.ts +5 -4
  33. package/dist/solid/charts.d.ts +1 -1
  34. package/dist/solid/checkbox.d.ts +14 -4
  35. package/dist/solid/collapsible.d.ts +33 -5
  36. package/dist/solid/color-disc.d.ts +1 -1
  37. package/dist/solid/color-slider.d.ts +1 -1
  38. package/dist/solid/color-wheel.d.ts +1 -1
  39. package/dist/solid/context-menu.d.ts +58 -24
  40. package/dist/solid/dialog-parts.d.ts +8 -8
  41. package/dist/solid/dropdown-menu.d.ts +55 -24
  42. package/dist/solid/empty.d.ts +1 -1
  43. package/dist/solid/form.d.ts +5 -6
  44. package/dist/solid/hover-card.d.ts +65 -9
  45. package/dist/solid/index.d.ts +1 -1
  46. package/dist/solid/index.js +7725 -13458
  47. package/dist/solid/input-group.d.ts +6 -6
  48. package/dist/solid/item.d.ts +1 -1
  49. package/dist/solid/menu-parts.d.ts +175 -24
  50. package/dist/solid/option-card.d.ts +1 -4
  51. package/dist/solid/picker-row.d.ts +2 -0
  52. package/dist/solid/popover.d.ts +77 -12
  53. package/dist/solid/progress.d.ts +11 -3
  54. package/dist/solid/radio-group.d.ts +31 -6
  55. package/dist/solid/responsive-dialog.d.ts +1 -1
  56. package/dist/solid/scroll-area.d.ts +1 -1
  57. package/dist/solid/section-card.d.ts +2 -3
  58. package/dist/solid/select.d.ts +107 -10
  59. package/dist/solid/selection.d.ts +10 -1
  60. package/dist/solid/sheet.d.ts +1 -1
  61. package/dist/solid/sliding-indicator.d.ts +1 -1
  62. package/dist/solid/sonner.d.ts +1 -1
  63. package/dist/solid/toggle.d.ts +11 -3
  64. package/dist/solid/tooltip.d.ts +22 -22
  65. package/dist/tokens/index.js +54 -51
  66. package/dist/{utils-CxAii-e9.js → utils-3Codx-NZ.js} +527 -489
  67. package/package.json +3 -6
  68. package/src/lib/anchor-placement.ts +10 -3
  69. package/src/lib/balance-rows.ts +115 -40
  70. package/src/lib/behavior/anchored.ts +26 -8
  71. package/src/lib/behavior/button-root.tsx +103 -0
  72. package/src/lib/behavior/collection.ts +66 -29
  73. package/src/lib/behavior/dismiss.ts +61 -21
  74. package/src/lib/behavior/focus-scope.ts +31 -6
  75. package/src/lib/behavior/hide-outside.ts +2 -2
  76. package/src/lib/behavior/layer-stack.ts +33 -8
  77. package/src/lib/behavior/menu.ts +470 -0
  78. package/src/lib/behavior/modal-root.tsx +24 -18
  79. package/src/lib/behavior/polymorphic.tsx +1 -1
  80. package/src/lib/behavior/presence.ts +1 -1
  81. package/src/lib/behavior/range.ts +212 -0
  82. package/src/lib/clipboard.ts +2 -3
  83. package/src/lib/color/color.ts +746 -0
  84. package/src/lib/color/index.ts +2 -0
  85. package/src/lib/color/intl.ts +60 -0
  86. package/src/lib/dock-slot-classes.ts +3 -0
  87. package/src/lib/hold.ts +1 -1
  88. package/src/lib/locale.ts +62 -0
  89. package/src/lib/menu-classes.ts +3 -0
  90. package/src/lib/motion-classes.ts +7 -7
  91. package/src/lib/overlay-classes.ts +1 -3
  92. package/src/lib/scroll-track.ts +11 -6
  93. package/src/lib/section-tokens.ts +1 -1
  94. package/src/lib/segment-classes.ts +3 -0
  95. package/src/lib/shadow-layer.ts +0 -118
  96. package/src/lib/toggle-set.ts +133 -0
  97. package/src/lib/visually-hidden.ts +15 -0
  98. package/src/solid/accordion.tsx +294 -20
  99. package/src/solid/area-picker.tsx +3 -2
  100. package/src/solid/avatar.tsx +98 -24
  101. package/src/solid/bottom-sheet/bottom-sheet.tsx +1 -1
  102. package/src/solid/button.tsx +12 -6
  103. package/src/solid/charts.tsx +1 -1
  104. package/src/solid/checkbox.tsx +167 -44
  105. package/src/solid/collapsible.tsx +260 -12
  106. package/src/solid/color-disc.tsx +11 -12
  107. package/src/solid/color-slider.tsx +114 -47
  108. package/src/solid/color-wheel.tsx +137 -39
  109. package/src/solid/context-menu.tsx +285 -94
  110. package/src/solid/dialog-parts.tsx +9 -9
  111. package/src/solid/dock.tsx +3 -2
  112. package/src/solid/dropdown-menu.tsx +252 -115
  113. package/src/solid/empty.tsx +1 -1
  114. package/src/solid/entity-selector.tsx +3 -2
  115. package/src/solid/face-toggle.tsx +43 -18
  116. package/src/solid/form.tsx +5 -6
  117. package/src/solid/glyph-tile.tsx +48 -21
  118. package/src/solid/hover-card.tsx +287 -25
  119. package/src/solid/image-picker.tsx +2 -2
  120. package/src/solid/index.ts +1 -3
  121. package/src/solid/input-group.tsx +2 -2
  122. package/src/solid/item.tsx +1 -1
  123. package/src/solid/menu-parts.tsx +619 -145
  124. package/src/solid/option-card.tsx +6 -10
  125. package/src/solid/picker-row.tsx +5 -1
  126. package/src/solid/popover.tsx +424 -79
  127. package/src/solid/preview-tile.tsx +1 -1
  128. package/src/solid/progress.tsx +84 -15
  129. package/src/solid/radio-group.tsx +271 -34
  130. package/src/solid/responsive-dialog.tsx +1 -1
  131. package/src/solid/schema-form.tsx +1 -6
  132. package/src/solid/scroll-area.tsx +1 -1
  133. package/src/solid/section-card.tsx +3 -4
  134. package/src/solid/select.tsx +950 -95
  135. package/src/solid/selection.tsx +142 -66
  136. package/src/solid/sheet.tsx +1 -1
  137. package/src/solid/slider.tsx +115 -65
  138. package/src/solid/sliding-indicator.tsx +1 -1
  139. package/src/solid/sonner.tsx +1 -1
  140. package/src/solid/tabs.tsx +12 -6
  141. package/src/solid/term.tsx +3 -4
  142. package/src/solid/toggle-group.tsx +29 -99
  143. package/src/solid/toggle.tsx +43 -9
  144. package/src/solid/tooltip.tsx +24 -24
  145. package/src/styles/globals.css +61 -7
  146. package/src/styles/theme.css +7 -4
  147. package/src/tokens/material.ts +11 -2
@@ -1,14 +1,16 @@
1
1
  import type { Accessor } from "solid-js";
2
- import { type Layer, type LayerHandle, layerStack } from "./layer-stack";
3
- import { effect } from "./solid";
2
+ import { type Layer, type LayerHandle, layerStack } from "./layer-stack.js";
3
+ import { effect } from "./solid.js";
4
4
 
5
- export type DismissReason = "escape" | "outside-press";
5
+ export type DismissReason = "escape" | "outside-press" | "focus-outside";
6
6
 
7
7
  export interface DismissOptions {
8
8
  layer: LayerHandle;
9
- /** `event` is the keydown for `escape` and the pointerdown for `outside-press`. */
10
- onDismiss: (reason: DismissReason, event: KeyboardEvent | PointerEvent) => void;
9
+ /** `event` is the keydown for `escape`, the pointerdown for `outside-press` and the focusin for `focus-outside`. */
10
+ onDismiss: (reason: DismissReason, event: KeyboardEvent | PointerEvent | FocusEvent) => void;
11
11
  outsidePress?: Accessor<boolean>;
12
+ /** Off unless asked: a non-modal layer closes when focus lands outside it. */
13
+ focusOutside?: Accessor<boolean>;
12
14
  escapeFrom?: "layer" | "document";
13
15
  }
14
16
 
@@ -21,24 +23,63 @@ function rootOf(element: HTMLElement): Document | ShadowRoot {
21
23
 
22
24
  const takesKeys = (entry: Layer): boolean => entry.element() !== undefined;
23
25
 
26
+ // A layer in a shadow root tops its own root: layers newer in other roots never shield it.
27
+ function topsItsRoot(layer: LayerHandle, mine: Layer): boolean {
28
+ if (layer.isTop()) return true;
29
+ const root = mine.element()?.getRootNode();
30
+ if (root?.nodeType !== SHADOW_ROOT_NODE) return false;
31
+ return !layer
32
+ .above()
33
+ .some((other) => other.kind !== "tooltip" && other.element()?.getRootNode() === root);
34
+ }
35
+
36
+ function isOutside(layer: LayerHandle, event: Event): boolean {
37
+ const mine = layer.layer();
38
+ if (!mine || (mine.kind !== "menu" && !topsItsRoot(layer, mine))) return false;
39
+ const full = event.composedPath();
40
+ const listener = event.currentTarget;
41
+ const end = listener === document || !listener ? -1 : full.indexOf(listener);
42
+ return !layer.containsPath(end >= 0 ? full.slice(0, end) : full);
43
+ }
44
+
45
+ function listenersFor(element: HTMLElement) {
46
+ const root = rootOf(element);
47
+ const host = root === document ? undefined : (root as ShadowRoot).host;
48
+ return { host, targets: host ? [root, document] : [root] };
49
+ }
50
+
51
+ function createFocusOutside(options: DismissOptions) {
52
+ const { layer } = options;
53
+ effect(
54
+ () => [layer.layer()?.element(), options.focusOutside?.() ?? false] as const,
55
+ ([element, enabled]) => {
56
+ if (!element || !enabled) return;
57
+ const { host, targets } = listenersFor(element);
58
+ const onFocus = (event: FocusEvent) => {
59
+ if (event.currentTarget === document && host && event.target === host) return;
60
+ if (isOutside(layer, event)) options.onDismiss("focus-outside", event);
61
+ };
62
+ const listener = onFocus as EventListener;
63
+ // After the tick that opened it: focus moved by the opening itself is never outside.
64
+ const timer = setTimeout(() => {
65
+ for (const target of targets) target.addEventListener("focusin", listener, true);
66
+ }, 0);
67
+ return () => {
68
+ clearTimeout(timer);
69
+ for (const target of targets) target.removeEventListener("focusin", listener, true);
70
+ };
71
+ },
72
+ );
73
+ }
74
+
24
75
  function createOutsidePress(options: DismissOptions) {
25
76
  const { layer } = options;
26
77
  effect(
27
78
  () => [layer.layer()?.element(), options.outsidePress?.() ?? true] as const,
28
79
  ([element, enabled]) => {
29
80
  if (!element || !enabled) return;
30
- const root = rootOf(element);
31
- const host = root === document ? undefined : (root as ShadowRoot).host;
32
- const targets = host ? [root, document] : [root];
33
-
34
- const outside = (event: Event): boolean => {
35
- const mine = layer.layer();
36
- if (!mine || (mine.kind !== "menu" && !layer.isTop())) return false;
37
- const full = event.composedPath();
38
- const listener = event.currentTarget;
39
- const end = listener === document || !listener ? -1 : full.indexOf(listener);
40
- return !layer.containsPath(end >= 0 ? full.slice(0, end) : full);
41
- };
81
+ const { host, targets } = listenersFor(element);
82
+ const outside = (event: Event): boolean => isOutside(layer, event);
42
83
 
43
84
  let pending: { target: EventTarget; click: (e: Event) => void } | undefined;
44
85
  const dropPending = () => {
@@ -105,20 +146,18 @@ function createEscape(options: DismissOptions) {
105
146
  if (!entry || !element) return;
106
147
  if (from === "tooltip") return createTooltipEscape(options);
107
148
  escapeHandlers.set(entry, (event) => options.onDismiss("escape", event));
108
- // The root element, so the key is taken before Kobalte's document listeners hear it.
149
+ // The root element, so the key is taken before any document listener hears it.
109
150
  const target = from === "document" ? document.documentElement : element;
110
151
  const onKey = (event: KeyboardEvent) => {
111
152
  if (event.key !== "Escape" || event.isComposing || claimedKeys.has(event)) return;
112
153
  const mine = layer.layer();
113
154
  if (!mine || !takesKeys(mine)) return;
114
155
  const stack = layerStack.layers().slice(layerStack.layers().indexOf(mine));
115
- const topmost = stack.findLast((other) => other.kind !== "tooltip" && takesKeys(other));
116
- if (from === "document" && topmost !== mine && topmost?.readsOwnEscape) return;
117
156
  const claims = stack.findLast(
118
157
  (other) =>
119
158
  other.kind !== "tooltip" &&
120
159
  takesKeys(other) &&
121
- (other.escape() || (other.kind === "modal" && !other.readsOwnEscape)),
160
+ (other.escape() || other.kind === "modal"),
122
161
  );
123
162
  if (!claims) return;
124
163
  claimedKeys.add(event);
@@ -141,5 +180,6 @@ function createEscape(options: DismissOptions) {
141
180
 
142
181
  export function createDismiss(options: DismissOptions): void {
143
182
  createOutsidePress(options);
183
+ createFocusOutside(options);
144
184
  createEscape(options);
145
185
  }
@@ -1,6 +1,6 @@
1
1
  import { type Accessor, onCleanup, untrack } from "solid-js";
2
- import { layerStack } from "./layer-stack";
3
- import { effect } from "./solid";
2
+ import { layerStack } from "./layer-stack.js";
3
+ import { effect } from "./solid.js";
4
4
 
5
5
  export const CANDIDATES =
6
6
  'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), summary, [contenteditable]:not([contenteditable="false"]), [tabindex]:not([tabindex="-1"])';
@@ -33,11 +33,36 @@ export interface FocusScope {
33
33
  untrap(): void;
34
34
  }
35
35
 
36
- type FocusRoot = Document | ShadowRoot;
37
-
38
- const activeOf = (el: Element): Element | null => (el.getRootNode() as FocusRoot).activeElement;
36
+ const DOCUMENT_NODE = 9;
37
+ const SHADOW_ROOT_NODE = 11;
38
+
39
+ /** The focused element in the node's own root, or null while focus is in another root. */
40
+ export function activeOf(node: Node): Element | null {
41
+ const root = node.getRootNode();
42
+ if (root.nodeType === DOCUMENT_NODE) return (root as Document).activeElement;
43
+ if (root.nodeType !== SHADOW_ROOT_NODE) return null;
44
+ let host = (root as ShadowRoot).host;
45
+ for (let up = host.getRootNode(); up.nodeType === SHADOW_ROOT_NODE; up = host.getRootNode())
46
+ host = (up as ShadowRoot).host;
47
+ // A shadow root holds focus only while the document's focus sits on its outermost host.
48
+ return host.ownerDocument.activeElement === host ? (root as ShadowRoot).activeElement : null;
49
+ }
39
50
 
40
- export const hasFocus = (el: Element): boolean => activeOf(el) === el;
51
+ /** Whether `el` holds focus, from its own focus and blur events, which a sealed widget receives without asking the page. */
52
+ export function trackFocus(el: Element): { has: () => boolean; stop: () => void } {
53
+ let has = false;
54
+ const on = () => (has = true);
55
+ const off = () => (has = false);
56
+ el.addEventListener("focus", on);
57
+ el.addEventListener("blur", off);
58
+ return {
59
+ has: () => has,
60
+ stop: () => {
61
+ el.removeEventListener("focus", on);
62
+ el.removeEventListener("blur", off);
63
+ },
64
+ };
65
+ }
41
66
 
42
67
  export function focusWithoutTracking(
43
68
  el: HTMLElement | null | undefined,
@@ -1,6 +1,6 @@
1
1
  import { type Accessor, onCleanup } from "solid-js";
2
- import type { LayerHandle } from "./layer-stack";
3
- import { effect } from "./solid";
2
+ import type { LayerHandle } from "./layer-stack.js";
3
+ import { effect } from "./solid.js";
4
4
 
5
5
  const KEPT = '[aria-live], [role="status"], [role="alert"], [data-kb-top-layer]';
6
6
  const ELEMENT = 1;
@@ -1,5 +1,5 @@
1
1
  import { type Accessor, createMemo, createRoot, createSignal } from "solid-js";
2
- import { effect } from "./solid";
2
+ import { effect } from "./solid.js";
3
3
 
4
4
  export type LayerKind = "modal" | "popover" | "menu" | "tooltip" | "tour";
5
5
  export type TopLayer = "auto" | "manual";
@@ -9,19 +9,20 @@ export interface LayerOptions {
9
9
  open: Accessor<boolean>;
10
10
  kind: LayerKind;
11
11
  escape: Accessor<boolean>;
12
- readsOwnEscape?: boolean;
13
12
  dismiss?: () => void;
14
13
  trigger?: Accessor<Element | undefined>;
15
14
  topLayer?: TopLayer;
15
+ /** While open, the page takes no pointer events; this layer and the ones above it still do. */
16
+ blockPointer?: Accessor<boolean>;
16
17
  }
17
18
 
18
19
  export interface Layer {
19
20
  readonly id: number;
20
21
  readonly kind: LayerKind;
21
- readonly readsOwnEscape: boolean;
22
22
  element(): HTMLElement | undefined;
23
23
  trigger(): Element | undefined;
24
24
  escape(): boolean;
25
+ readonly blocksPointer: boolean;
25
26
  dismiss?: () => void;
26
27
  }
27
28
 
@@ -45,6 +46,30 @@ export const layerStack: {
45
46
 
46
47
  let nextId = 0;
47
48
 
49
+ function blockPointerBelow(above: readonly HTMLElement[]): () => void {
50
+ const body = document.body;
51
+ const prior = body.style.pointerEvents;
52
+ body.style.pointerEvents = "none";
53
+ const kept = above.map((element) => [element, element.style.pointerEvents] as const);
54
+ for (const [element] of kept) element.style.pointerEvents = "auto";
55
+ return () => {
56
+ body.style.pointerEvents = prior;
57
+ if (body.getAttribute("style") === "") body.removeAttribute("style");
58
+ for (const [element, value] of kept) element.style.pointerEvents = value;
59
+ };
60
+ }
61
+
62
+ let releasePointer: (() => void) | undefined;
63
+
64
+ function setStack(list: readonly Layer[]): void {
65
+ setLayers(list);
66
+ releasePointer?.();
67
+ releasePointer = undefined;
68
+ const from = list.findLastIndex((layer) => layer.blocksPointer);
69
+ if (from >= 0)
70
+ releasePointer = blockPointerBelow(list.slice(from).flatMap((layer) => layer.element() ?? []));
71
+ }
72
+
48
73
  function enterTopLayer(element: HTMLElement, mode: TopLayer, dismiss: (() => void) | undefined) {
49
74
  if (typeof element.showPopover !== "function") return undefined;
50
75
  element.setAttribute("popover", mode);
@@ -72,19 +97,19 @@ export function registerLayer(options: LayerOptions): LayerHandle {
72
97
  const [layer, setLayer] = createSignal<Layer | undefined>();
73
98
 
74
99
  effect(
75
- () => [options.element(), options.open()] as const,
76
- ([element, open]) => {
100
+ () => [options.element(), options.open(), options.blockPointer?.() ?? false] as const,
101
+ ([element, open, blocksPointer]) => {
77
102
  if (!element || !open) return;
78
103
  const entry: Layer = {
79
104
  id: ++nextId,
80
105
  kind: options.kind,
81
- readsOwnEscape: options.readsOwnEscape ?? false,
82
106
  element: options.element,
83
107
  trigger: () => options.trigger?.(),
84
108
  escape: options.escape,
109
+ blocksPointer,
85
110
  dismiss: options.dismiss,
86
111
  };
87
- setLayers([...layers(), entry]);
112
+ setStack([...layers(), entry]);
88
113
  setLayer(entry);
89
114
  const leaveTopLayer = options.topLayer
90
115
  ? enterTopLayer(element, options.topLayer, () => {
@@ -93,7 +118,7 @@ export function registerLayer(options: LayerOptions): LayerHandle {
93
118
  : undefined;
94
119
  return () => {
95
120
  leaveTopLayer?.();
96
- setLayers(layers().filter((other) => other !== entry));
121
+ setStack(layers().filter((other) => other !== entry));
97
122
  setLayer(undefined);
98
123
  };
99
124
  },