@gemologic/sheen 0.1.0-rc.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 (271) hide show
  1. package/LICENSE +19 -0
  2. package/README.md +32 -0
  3. package/dist/core.d.ts +52 -0
  4. package/dist/core.js +29 -0
  5. package/dist/formisch.d.ts +5 -0
  6. package/dist/formisch.js +22 -0
  7. package/dist/forms.d.ts +34 -0
  8. package/dist/forms.js +18 -0
  9. package/dist/index.d.ts +144 -0
  10. package/dist/index.js +75 -0
  11. package/dist/layout/Layout.d.ts +28 -0
  12. package/dist/layout/Layout.js +121 -0
  13. package/dist/metadata.d.ts +46 -0
  14. package/dist/metadata.js +47 -0
  15. package/dist/navigation.d.ts +30 -0
  16. package/dist/navigation.js +16 -0
  17. package/dist/overlays.d.ts +28 -0
  18. package/dist/overlays.js +15 -0
  19. package/dist/primitives/Accordion.d.ts +16 -0
  20. package/dist/primitives/Accordion.js +223 -0
  21. package/dist/primitives/ActivityTimeline.d.ts +20 -0
  22. package/dist/primitives/ActivityTimeline.js +104 -0
  23. package/dist/primitives/AlertDialog.d.ts +7 -0
  24. package/dist/primitives/AlertDialog.js +8 -0
  25. package/dist/primitives/Avatar.d.ts +22 -0
  26. package/dist/primitives/Avatar.js +115 -0
  27. package/dist/primitives/Breadcrumb.d.ts +11 -0
  28. package/dist/primitives/Breadcrumb.js +66 -0
  29. package/dist/primitives/Button.d.ts +11 -0
  30. package/dist/primitives/Button.js +59 -0
  31. package/dist/primitives/ButtonGroup.d.ts +7 -0
  32. package/dist/primitives/ButtonGroup.js +33 -0
  33. package/dist/primitives/Checkbox.d.ts +22 -0
  34. package/dist/primitives/Checkbox.js +93 -0
  35. package/dist/primitives/CheckboxGroup.d.ts +18 -0
  36. package/dist/primitives/CheckboxGroup.js +122 -0
  37. package/dist/primitives/Collapsible.d.ts +9 -0
  38. package/dist/primitives/Collapsible.js +72 -0
  39. package/dist/primitives/Combobox.d.ts +41 -0
  40. package/dist/primitives/Combobox.js +684 -0
  41. package/dist/primitives/CommandPalette.d.ts +42 -0
  42. package/dist/primitives/CommandPalette.js +319 -0
  43. package/dist/primitives/ConfirmDialog.d.ts +11 -0
  44. package/dist/primitives/ConfirmDialog.js +42 -0
  45. package/dist/primitives/ContextMenu.d.ts +16 -0
  46. package/dist/primitives/ContextMenu.js +132 -0
  47. package/dist/primitives/DescriptionList.d.ts +11 -0
  48. package/dist/primitives/DescriptionList.js +44 -0
  49. package/dist/primitives/Dialog.d.ts +21 -0
  50. package/dist/primitives/Dialog.js +141 -0
  51. package/dist/primitives/Drawer.d.ts +9 -0
  52. package/dist/primitives/Drawer.js +21 -0
  53. package/dist/primitives/DropdownMenu.d.ts +59 -0
  54. package/dist/primitives/DropdownMenu.js +441 -0
  55. package/dist/primitives/EditableTextField.d.ts +11 -0
  56. package/dist/primitives/EditableTextField.js +126 -0
  57. package/dist/primitives/EmptyState.d.ts +7 -0
  58. package/dist/primitives/EmptyState.js +45 -0
  59. package/dist/primitives/Field.d.ts +18 -0
  60. package/dist/primitives/Field.js +72 -0
  61. package/dist/primitives/FileDropzone.d.ts +40 -0
  62. package/dist/primitives/FileDropzone.js +261 -0
  63. package/dist/primitives/IconButton.d.ts +8 -0
  64. package/dist/primitives/IconButton.js +34 -0
  65. package/dist/primitives/Input.d.ts +7 -0
  66. package/dist/primitives/Input.js +55 -0
  67. package/dist/primitives/InputGroup.d.ts +7 -0
  68. package/dist/primitives/InputGroup.js +73 -0
  69. package/dist/primitives/Link.d.ts +7 -0
  70. package/dist/primitives/Link.js +35 -0
  71. package/dist/primitives/LinkTooltip.d.ts +11 -0
  72. package/dist/primitives/LinkTooltip.js +88 -0
  73. package/dist/primitives/NavList.d.ts +17 -0
  74. package/dist/primitives/NavList.js +143 -0
  75. package/dist/primitives/Notice.d.ts +8 -0
  76. package/dist/primitives/Notice.js +64 -0
  77. package/dist/primitives/NumberField.d.ts +22 -0
  78. package/dist/primitives/NumberField.js +177 -0
  79. package/dist/primitives/Pagination.d.ts +12 -0
  80. package/dist/primitives/Pagination.js +127 -0
  81. package/dist/primitives/Popover.d.ts +12 -0
  82. package/dist/primitives/Popover.js +103 -0
  83. package/dist/primitives/Progress.d.ts +17 -0
  84. package/dist/primitives/Progress.js +98 -0
  85. package/dist/primitives/RadioGroup.d.ts +19 -0
  86. package/dist/primitives/RadioGroup.js +173 -0
  87. package/dist/primitives/Resizable.d.ts +36 -0
  88. package/dist/primitives/Resizable.js +196 -0
  89. package/dist/primitives/ScrollArea.d.ts +6 -0
  90. package/dist/primitives/ScrollArea.js +178 -0
  91. package/dist/primitives/SearchInput.d.ts +12 -0
  92. package/dist/primitives/SearchInput.js +89 -0
  93. package/dist/primitives/SegmentedControl.d.ts +25 -0
  94. package/dist/primitives/SegmentedControl.js +188 -0
  95. package/dist/primitives/Select.d.ts +24 -0
  96. package/dist/primitives/Select.js +320 -0
  97. package/dist/primitives/Separator.d.ts +6 -0
  98. package/dist/primitives/Separator.js +31 -0
  99. package/dist/primitives/ShortcutPending.d.ts +6 -0
  100. package/dist/primitives/ShortcutPending.js +40 -0
  101. package/dist/primitives/ShortcutProvider.d.ts +32 -0
  102. package/dist/primitives/ShortcutProvider.js +172 -0
  103. package/dist/primitives/ShortcutScope.d.ts +6 -0
  104. package/dist/primitives/ShortcutScope.js +29 -0
  105. package/dist/primitives/ShortcutSheet.d.ts +5 -0
  106. package/dist/primitives/ShortcutSheet.js +87 -0
  107. package/dist/primitives/Skeleton.d.ts +5 -0
  108. package/dist/primitives/Skeleton.js +23 -0
  109. package/dist/primitives/Slider.d.ts +35 -0
  110. package/dist/primitives/Slider.js +210 -0
  111. package/dist/primitives/Spinner.d.ts +7 -0
  112. package/dist/primitives/Spinner.js +44 -0
  113. package/dist/primitives/Status.d.ts +15 -0
  114. package/dist/primitives/Status.js +78 -0
  115. package/dist/primitives/Stepper.d.ts +32 -0
  116. package/dist/primitives/Stepper.js +147 -0
  117. package/dist/primitives/Surface.d.ts +11 -0
  118. package/dist/primitives/Surface.js +58 -0
  119. package/dist/primitives/Switch.d.ts +4 -0
  120. package/dist/primitives/Switch.js +7 -0
  121. package/dist/primitives/Table.d.ts +23 -0
  122. package/dist/primitives/Table.js +101 -0
  123. package/dist/primitives/Tabs.d.ts +17 -0
  124. package/dist/primitives/Tabs.js +157 -0
  125. package/dist/primitives/TagInput.d.ts +33 -0
  126. package/dist/primitives/TagInput.js +288 -0
  127. package/dist/primitives/Textarea.d.ts +8 -0
  128. package/dist/primitives/Textarea.js +106 -0
  129. package/dist/primitives/Toast.d.ts +10 -0
  130. package/dist/primitives/Toast.js +78 -0
  131. package/dist/primitives/Toaster.d.ts +9 -0
  132. package/dist/primitives/Toaster.js +183 -0
  133. package/dist/primitives/Tooltip.d.ts +13 -0
  134. package/dist/primitives/Tooltip.js +84 -0
  135. package/dist/primitives/Tree.d.ts +23 -0
  136. package/dist/primitives/Tree.js +275 -0
  137. package/dist/primitives/Typography.d.ts +16 -0
  138. package/dist/primitives/Typography.js +82 -0
  139. package/dist/primitives/boolean-input-state.d.ts +14 -0
  140. package/dist/primitives/boolean-input-state.js +39 -0
  141. package/dist/primitives/button-variants.d.ts +9 -0
  142. package/dist/primitives/button-variants.js +7 -0
  143. package/dist/primitives/choice-options.d.ts +7 -0
  144. package/dist/primitives/choice-options.js +35 -0
  145. package/dist/primitives/create-confirm.d.ts +15 -0
  146. package/dist/primitives/create-confirm.js +49 -0
  147. package/dist/primitives/create-toaster.d.ts +51 -0
  148. package/dist/primitives/create-toaster.js +87 -0
  149. package/dist/primitives/link-focus.d.ts +2 -0
  150. package/dist/primitives/link-focus.js +38 -0
  151. package/dist/primitives/menu-focus.d.ts +3 -0
  152. package/dist/primitives/menu-focus.js +32 -0
  153. package/dist/primitives/tooltip-layer.d.ts +14 -0
  154. package/dist/primitives/tooltip-layer.js +84 -0
  155. package/dist/theme/ThemeProvider.d.ts +59 -0
  156. package/dist/theme/ThemeProvider.js +239 -0
  157. package/dist/theme/intl.d.ts +6 -0
  158. package/dist/theme/intl.js +13 -0
  159. package/dist/theme/keyboard-script.d.ts +2 -0
  160. package/dist/theme/keyboard-script.js +6 -0
  161. package/dist/theme/layers.d.ts +7 -0
  162. package/dist/theme/layers.js +23 -0
  163. package/dist/theme/messages.d.ts +235 -0
  164. package/dist/theme/messages.js +115 -0
  165. package/dist/theme/script.d.ts +9 -0
  166. package/dist/theme/script.js +49 -0
  167. package/dist/theme/state.d.ts +27 -0
  168. package/dist/theme/state.js +55 -0
  169. package/dist/utils/browser-status.d.ts +5 -0
  170. package/dist/utils/browser-status.js +22 -0
  171. package/dist/utils/cn.d.ts +3 -0
  172. package/dist/utils/cn.js +7 -0
  173. package/dist/utils/optimistic.d.ts +6 -0
  174. package/dist/utils/optimistic.js +16 -0
  175. package/dist/utils/polymorphic.d.ts +1 -0
  176. package/dist/utils/shortcut-platform.d.ts +2 -0
  177. package/dist/utils/shortcut-platform.js +10 -0
  178. package/dist/utils/shortcut-registry.d.ts +61 -0
  179. package/dist/utils/shortcut-registry.js +186 -0
  180. package/package.json +100 -0
  181. package/src/core.ts +55 -0
  182. package/src/formisch.ts +28 -0
  183. package/src/forms.ts +34 -0
  184. package/src/index.ts +144 -0
  185. package/src/layout/Layout.tsx +43 -0
  186. package/src/metadata.d.ts +46 -0
  187. package/src/metadata.ts +66 -0
  188. package/src/navigation.ts +30 -0
  189. package/src/overlays.ts +28 -0
  190. package/src/primitives/Accordion.tsx +145 -0
  191. package/src/primitives/ActivityTimeline.tsx +72 -0
  192. package/src/primitives/AlertDialog.tsx +8 -0
  193. package/src/primitives/Avatar.tsx +85 -0
  194. package/src/primitives/Breadcrumb.tsx +41 -0
  195. package/src/primitives/Button.tsx +27 -0
  196. package/src/primitives/ButtonGroup.tsx +18 -0
  197. package/src/primitives/Checkbox.tsx +51 -0
  198. package/src/primitives/CheckboxGroup.tsx +73 -0
  199. package/src/primitives/Collapsible.tsx +43 -0
  200. package/src/primitives/Combobox.tsx +402 -0
  201. package/src/primitives/CommandPalette.tsx +234 -0
  202. package/src/primitives/ConfirmDialog.tsx +25 -0
  203. package/src/primitives/ContextMenu.tsx +100 -0
  204. package/src/primitives/DescriptionList.tsx +26 -0
  205. package/src/primitives/Dialog.tsx +81 -0
  206. package/src/primitives/Drawer.tsx +26 -0
  207. package/src/primitives/DropdownMenu.tsx +221 -0
  208. package/src/primitives/EditableTextField.tsx +91 -0
  209. package/src/primitives/EmptyState.tsx +21 -0
  210. package/src/primitives/Field.tsx +38 -0
  211. package/src/primitives/FileDropzone.tsx +189 -0
  212. package/src/primitives/IconButton.tsx +22 -0
  213. package/src/primitives/Input.tsx +17 -0
  214. package/src/primitives/InputGroup.tsx +23 -0
  215. package/src/primitives/Link.tsx +19 -0
  216. package/src/primitives/LinkTooltip.tsx +31 -0
  217. package/src/primitives/NavList.tsx +58 -0
  218. package/src/primitives/Notice.tsx +25 -0
  219. package/src/primitives/NumberField.tsx +168 -0
  220. package/src/primitives/Pagination.tsx +64 -0
  221. package/src/primitives/Popover.tsx +44 -0
  222. package/src/primitives/Progress.tsx +62 -0
  223. package/src/primitives/RadioGroup.tsx +104 -0
  224. package/src/primitives/Resizable.tsx +170 -0
  225. package/src/primitives/ScrollArea.tsx +115 -0
  226. package/src/primitives/SearchInput.tsx +98 -0
  227. package/src/primitives/SegmentedControl.tsx +140 -0
  228. package/src/primitives/Select.tsx +171 -0
  229. package/src/primitives/Separator.tsx +13 -0
  230. package/src/primitives/ShortcutPending.tsx +21 -0
  231. package/src/primitives/ShortcutProvider.tsx +179 -0
  232. package/src/primitives/ShortcutScope.tsx +17 -0
  233. package/src/primitives/ShortcutSheet.tsx +35 -0
  234. package/src/primitives/Skeleton.tsx +12 -0
  235. package/src/primitives/Slider.tsx +153 -0
  236. package/src/primitives/Spinner.tsx +19 -0
  237. package/src/primitives/Status.tsx +33 -0
  238. package/src/primitives/Stepper.tsx +106 -0
  239. package/src/primitives/Surface.tsx +21 -0
  240. package/src/primitives/Switch.tsx +9 -0
  241. package/src/primitives/Table.tsx +57 -0
  242. package/src/primitives/Tabs.tsx +96 -0
  243. package/src/primitives/TagInput.tsx +282 -0
  244. package/src/primitives/Textarea.tsx +77 -0
  245. package/src/primitives/Toast.tsx +36 -0
  246. package/src/primitives/Toaster.tsx +175 -0
  247. package/src/primitives/Tooltip.tsx +41 -0
  248. package/src/primitives/Tree.tsx +256 -0
  249. package/src/primitives/Typography.tsx +39 -0
  250. package/src/primitives/boolean-input-state.ts +65 -0
  251. package/src/primitives/button-variants.ts +20 -0
  252. package/src/primitives/choice-options.ts +39 -0
  253. package/src/primitives/create-confirm.tsx +56 -0
  254. package/src/primitives/create-toaster.ts +128 -0
  255. package/src/primitives/link-focus.ts +38 -0
  256. package/src/primitives/menu-focus.ts +43 -0
  257. package/src/primitives/tooltip-layer.tsx +53 -0
  258. package/src/styles.css +655 -0
  259. package/src/theme/ThemeProvider.tsx +215 -0
  260. package/src/theme/intl.ts +14 -0
  261. package/src/theme/keyboard-script.ts +4 -0
  262. package/src/theme/layers.ts +16 -0
  263. package/src/theme/messages.ts +157 -0
  264. package/src/theme/script.ts +70 -0
  265. package/src/theme/state.ts +48 -0
  266. package/src/utils/browser-status.ts +36 -0
  267. package/src/utils/cn.ts +5 -0
  268. package/src/utils/optimistic.ts +22 -0
  269. package/src/utils/polymorphic.ts +1 -0
  270. package/src/utils/shortcut-platform.ts +4 -0
  271. package/src/utils/shortcut-registry.ts +216 -0
@@ -0,0 +1,216 @@
1
+ export interface ShortcutDefinition {
2
+ readonly keys: string;
3
+ readonly scope: string;
4
+ readonly label: string;
5
+ readonly group: string;
6
+ readonly developmentOnly?: boolean;
7
+ readonly run: () => void | Promise<void>;
8
+ }
9
+ export interface ShortcutAction {
10
+ readonly keys: string;
11
+ readonly label: string;
12
+ readonly group: string;
13
+ readonly scope?: string;
14
+ readonly developmentOnly?: boolean;
15
+ }
16
+ export interface ShortcutInput {
17
+ readonly key: string;
18
+ readonly ctrlKey: boolean;
19
+ readonly metaKey: boolean;
20
+ readonly altKey: boolean;
21
+ readonly shiftKey: boolean;
22
+ readonly editing: boolean;
23
+ readonly composing?: boolean;
24
+ readonly repeat?: boolean;
25
+ readonly characterShortcuts?: boolean;
26
+ }
27
+ export interface ShortcutRegistryOptions {
28
+ readonly platform: "mac" | "other";
29
+ readonly development: boolean;
30
+ readonly warn?: (message: string) => void;
31
+ readonly onError?: (error: unknown) => void;
32
+ readonly onPending?: (pending: readonly PendingShortcut[]) => void;
33
+ readonly onChange?: (bindings: readonly ShortcutBinding[]) => void;
34
+ }
35
+ export interface ShortcutBinding {
36
+ readonly id: number;
37
+ readonly scope: string;
38
+ readonly keys: string;
39
+ readonly displayKeys: string;
40
+ readonly label: string;
41
+ readonly group: string;
42
+ readonly characterOnly: boolean;
43
+ readonly shadowed: boolean;
44
+ }
45
+ export interface PendingShortcut {
46
+ readonly keys: string;
47
+ readonly displayKeys: string;
48
+ readonly label: string;
49
+ readonly scope: string;
50
+ readonly completed: number;
51
+ }
52
+ type ShortcutEntry = { definition: ShortcutDefinition; chords: string[]; displayKeys: string; characterOnly: boolean; id: number; active: boolean };
53
+ interface Chord {
54
+ readonly key: string;
55
+ readonly ctrl: boolean;
56
+ readonly meta: boolean;
57
+ readonly alt: boolean;
58
+ readonly shift: boolean;
59
+ }
60
+ const aliases = new Map([["esc", "escape"], ["return", "enter"], ["space", " "], ["plus", "+"]]);
61
+ const normalizeKey = (key: string) => aliases.get(key.toLowerCase()) ?? key.toLowerCase();
62
+ const identity = (chord: Chord) => JSON.stringify([chord.ctrl, chord.meta, chord.alt, chord.shift, chord.key]);
63
+ const protectedChord = (chord: Chord) => (chord.ctrl || chord.meta) && ["r", "l", "t", "w"].includes(chord.key);
64
+
65
+ function parseChord(keys: string, platform: ShortcutRegistryOptions["platform"]): Chord {
66
+ const parts = keys.trim().toLowerCase().split("+").map(part => part.trim());
67
+ const keyPart = parts.pop();
68
+ if (!keyPart || /\s/.test(keyPart)) throw new Error(`Expected one shortcut chord: ${keys}`);
69
+ const modifiers = new Set<string>();
70
+ for (const part of parts) {
71
+ const modifier = part === "mod" ? platform === "mac" ? "meta" : "ctrl" : part;
72
+ if (!["ctrl", "meta", "alt", "shift"].includes(modifier) || modifiers.has(modifier)) throw new Error(`Invalid or duplicate shortcut modifier: ${keys}`);
73
+ modifiers.add(modifier);
74
+ }
75
+ const key = normalizeKey(keyPart);
76
+ if (["ctrl", "meta", "alt", "shift", "mod"].includes(key)) throw new Error(`Shortcut requires a non-modifier key: ${keys}`);
77
+ // KeyboardEvent.key already includes the shift used to produce punctuation such as '?'.
78
+ const shift = modifiers.has("shift") && !(key.length === 1 && /[^a-z0-9 ]/.test(key));
79
+ const chord = { key, ctrl: modifiers.has("ctrl"), meta: modifiers.has("meta"), alt: modifiers.has("alt"), shift };
80
+ if (protectedChord(chord)) throw new Error(`Reserved browser shortcut: ${keys}`);
81
+ return chord;
82
+ }
83
+
84
+ /** Pure registry core. The browser owner supplies active scopes, input context, and event prevention. */
85
+ export function createShortcutRegistry(options: ShortcutRegistryOptions) {
86
+ const scopes = new Map<string, Map<string, ShortcutEntry[]>>();
87
+ let nextId = 0;
88
+ let disposed = false;
89
+ let pending: { entries: ShortcutEntry[]; completed: number; scopes: string; expires: number; characterShortcuts: boolean } | undefined;
90
+ let timer: ReturnType<typeof setTimeout> | undefined;
91
+ const snapshot = (): readonly ShortcutBinding[] => Object.freeze([...scopes].flatMap(([scope, bindings]) => [...bindings.values()].flatMap(entries => entries.map((entry, index) => Object.freeze({
92
+ id: entry.id, scope, keys: entry.definition.keys, displayKeys: entry.displayKeys, label: entry.definition.label, group: entry.definition.group, characterOnly: entry.characterOnly, shadowed: index < entries.length - 1,
93
+ })))));
94
+ const cancelPending = () => {
95
+ if (timer !== undefined) clearTimeout(timer);
96
+ timer = undefined;
97
+ if (!pending) return;
98
+ pending = undefined;
99
+ options.onPending?.(Object.freeze([]));
100
+ };
101
+ const execute = (entry: ShortcutEntry): void => {
102
+ const result = entry.definition.run();
103
+ if (result) void Promise.resolve(result).catch(error => {
104
+ if (disposed || !entry.active) return;
105
+ try {
106
+ if (options.onError) options.onError(error);
107
+ else queueMicrotask(() => { throw error; });
108
+ } catch (reportingError) { queueMicrotask(() => { throw reportingError; }); }
109
+ });
110
+ };
111
+ const advance = (entries: ShortcutEntry[], completed: number, activeScopes: readonly string[], characterShortcuts: boolean, beforeRun?: () => void): boolean => {
112
+ cancelPending();
113
+ beforeRun?.();
114
+ const complete = entries.find(entry => entry.chords.length === completed);
115
+ if (complete) execute(complete);
116
+ else {
117
+ pending = { entries, completed, scopes: JSON.stringify(activeScopes), expires: performance.now() + 1000, characterShortcuts };
118
+ timer = setTimeout(cancelPending, 1000);
119
+ options.onPending?.(Object.freeze(entries.map(entry => Object.freeze({ keys: entry.definition.keys, displayKeys: entry.displayKeys, label: entry.definition.label, scope: entry.definition.scope, completed }))));
120
+ }
121
+ return true;
122
+ };
123
+ return {
124
+ cancelPending,
125
+ register(definition: ShortcutDefinition): () => void {
126
+ if (disposed) throw new Error("Cannot register a shortcut on a disposed registry");
127
+ if (definition.developmentOnly && !options.development) return () => {};
128
+ if (!definition.scope.trim() || !definition.label.trim() || !definition.group.trim()) throw new Error("Shortcuts require nonempty scope, label, and group");
129
+ const parsed = definition.keys.trim().replace(/\s*\+\s*/g, "+").split(/\s+/).map((keys, index) => {
130
+ const chord = parseChord(keys, options.platform);
131
+ if (index > 0 && chord.key === "escape" && !chord.ctrl && !chord.meta && !chord.alt && !chord.shift) throw new Error("Escape is reserved for cancelling a pending sequence");
132
+ return chord;
133
+ });
134
+ const chords = parsed.map(identity);
135
+ const keyLabels = new Map([["escape", "Esc"], [" ", "Space"], ["enter", "Enter"]]);
136
+ const displayKeys = parsed.map(chord => [chord.ctrl ? "Ctrl" : "", chord.alt ? options.platform === "mac" ? "⌥" : "Alt" : "", chord.shift ? options.platform === "mac" ? "⇧" : "Shift" : "", chord.meta ? options.platform === "mac" ? "⌘" : "Meta" : "", keyLabels.get(chord.key) ?? chord.key.toUpperCase()].filter(Boolean).join("+")).join(" → ");
137
+ const characterOnly = parsed.every(chord => !chord.ctrl && !chord.meta && !chord.alt && Array.from(chord.key).length === 1);
138
+ const key = JSON.stringify(chords);
139
+ const scope = scopes.get(definition.scope) ?? new Map<string, ShortcutEntry[]>();
140
+ for (const existing of scope.values()) {
141
+ const previous = existing.at(-1);
142
+ if (previous && previous.chords.length !== chords.length && previous.chords.slice(0, Math.min(previous.chords.length, chords.length)).every((chord, index) => chord === chords[index])) {
143
+ throw new Error(`Ambiguous shortcut prefix in ${definition.scope}: "${previous.definition.label}" and "${definition.label}"`);
144
+ }
145
+ }
146
+ const entries = scope.get(key) ?? [];
147
+ const previous = entries.at(-1);
148
+ if (previous) {
149
+ const message = `Shortcut collision in ${definition.scope}: "${previous.definition.label}" and "${definition.label}" (${definition.keys})`;
150
+ if (options.development) throw new Error(message);
151
+ (options.warn ?? console.warn)(message);
152
+ }
153
+ cancelPending();
154
+ const entry = { definition: Object.freeze({ ...definition }), chords, displayKeys, characterOnly, id: ++nextId, active: true };
155
+ entries.push(entry);
156
+ scope.set(key, entries);
157
+ scopes.set(definition.scope, scope);
158
+ options.onChange?.(snapshot());
159
+ return () => {
160
+ if (pending?.entries.includes(entry)) cancelPending();
161
+ entry.active = false;
162
+ const index = entries.indexOf(entry);
163
+ if (index < 0) return;
164
+ entries.splice(index, 1);
165
+ if (!entries.length) scope.delete(key);
166
+ if (!scope.size) scopes.delete(definition.scope);
167
+ options.onChange?.(snapshot());
168
+ };
169
+ },
170
+ /** Scopes are ordered outermost to innermost. Only the winning action executes. */
171
+ dispatch(input: ShortcutInput, activeScopes: readonly string[], beforeRun?: () => void): boolean {
172
+ if (disposed || input.repeat) return false;
173
+ if (input.composing) { cancelPending(); return false; }
174
+ const key = normalizeKey(input.key);
175
+ const characterShortcuts = input.characterShortcuts !== false;
176
+ const chord: Chord = { key, ctrl: input.ctrlKey, meta: input.metaKey, alt: input.altKey,
177
+ shift: input.shiftKey && !(key.length === 1 && /[^a-z0-9 ]/.test(key)) };
178
+ if (protectedChord(chord) || (input.editing && !chord.ctrl && !chord.meta)) { cancelPending(); return false; }
179
+ if (pending && (pending.characterShortcuts !== characterShortcuts || pending.scopes !== JSON.stringify(activeScopes) || performance.now() >= pending.expires)) cancelPending();
180
+ if (pending) {
181
+ if (key === "escape" && !chord.ctrl && !chord.meta && !chord.alt && !chord.shift) { cancelPending(); beforeRun?.(); return true; }
182
+ // Modifier presses between strokes do not interrupt modified sequences.
183
+ if (["control", "meta", "alt", "shift"].includes(key)) return false;
184
+ const current = pending;
185
+ const completed = current.completed + 1;
186
+ const candidates = current.entries.filter(entry => entry.active && entry.chords[current.completed] === identity(chord));
187
+ if (candidates.length) return advance(candidates, completed, activeScopes, characterShortcuts, beforeRun);
188
+ cancelPending();
189
+ }
190
+ for (const scope of [...activeScopes].reverse()) {
191
+ const entries = [...(scopes.get(scope)?.values() ?? [])].flatMap(entries => {
192
+ const entry = entries.at(-1);
193
+ return entry?.chords[0] === identity(chord) && (characterShortcuts || !entry.characterOnly) ? [entry] : [];
194
+ });
195
+ if (entries.length) return advance(entries, 1, activeScopes, characterShortcuts, beforeRun);
196
+ }
197
+ return false;
198
+ },
199
+ snapshot,
200
+ run(id: number): boolean {
201
+ if (disposed || !Number.isSafeInteger(id)) return false;
202
+ for (const scope of scopes.values()) {
203
+ for (const entries of scope.values()) {
204
+ const entry = entries.at(-1);
205
+ if (entry?.id === id && entry.active) {
206
+ cancelPending();
207
+ execute(entry);
208
+ return true;
209
+ }
210
+ }
211
+ }
212
+ return false;
213
+ },
214
+ dispose(): void { if (disposed) return; disposed = true; cancelPending(); scopes.clear(); options.onChange?.(snapshot()); },
215
+ };
216
+ }