@chromvoid/headless-ui 0.1.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 (191) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +99 -0
  3. package/dist/a11y-contracts/index.d.ts +23 -0
  4. package/dist/a11y-contracts/index.js +1 -0
  5. package/dist/accordion/index.d.ts +78 -0
  6. package/dist/accordion/index.js +264 -0
  7. package/dist/adapters/index.d.ts +9 -0
  8. package/dist/adapters/index.js +1 -0
  9. package/dist/alert/index.d.ts +33 -0
  10. package/dist/alert/index.js +54 -0
  11. package/dist/alert-dialog/index.d.ts +69 -0
  12. package/dist/alert-dialog/index.js +94 -0
  13. package/dist/badge/index.d.ts +48 -0
  14. package/dist/badge/index.js +89 -0
  15. package/dist/breadcrumb/index.d.ts +55 -0
  16. package/dist/breadcrumb/index.js +77 -0
  17. package/dist/button/index.d.ts +46 -0
  18. package/dist/button/index.js +86 -0
  19. package/dist/callout/index.d.ts +41 -0
  20. package/dist/callout/index.js +63 -0
  21. package/dist/card/index.d.ts +54 -0
  22. package/dist/card/index.js +103 -0
  23. package/dist/carousel/index.d.ts +98 -0
  24. package/dist/carousel/index.js +243 -0
  25. package/dist/checkbox/index.d.ts +50 -0
  26. package/dist/checkbox/index.js +87 -0
  27. package/dist/combobox/index.d.ts +114 -0
  28. package/dist/combobox/index.js +431 -0
  29. package/dist/command-palette/index.d.ts +73 -0
  30. package/dist/command-palette/index.js +147 -0
  31. package/dist/context-menu/index.d.ts +111 -0
  32. package/dist/context-menu/index.js +372 -0
  33. package/dist/copy-button/index.d.ts +62 -0
  34. package/dist/copy-button/index.js +183 -0
  35. package/dist/core/index.d.ts +20 -0
  36. package/dist/core/index.js +2 -0
  37. package/dist/core/selection.d.ts +5 -0
  38. package/dist/core/selection.js +39 -0
  39. package/dist/core/value-range.d.ts +49 -0
  40. package/dist/core/value-range.js +134 -0
  41. package/dist/date-picker/index.d.ts +210 -0
  42. package/dist/date-picker/index.js +895 -0
  43. package/dist/dialog/index.d.ts +95 -0
  44. package/dist/dialog/index.js +153 -0
  45. package/dist/disclosure/index.d.ts +52 -0
  46. package/dist/disclosure/index.js +159 -0
  47. package/dist/drawer/index.d.ts +30 -0
  48. package/dist/drawer/index.js +39 -0
  49. package/dist/feed/index.d.ts +77 -0
  50. package/dist/feed/index.js +260 -0
  51. package/dist/grid/index.d.ts +103 -0
  52. package/dist/grid/index.js +415 -0
  53. package/dist/index.d.ts +51 -0
  54. package/dist/index.js +51 -0
  55. package/dist/input/index.d.ts +86 -0
  56. package/dist/input/index.js +156 -0
  57. package/dist/interactions/composite-navigation.d.ts +69 -0
  58. package/dist/interactions/composite-navigation.js +169 -0
  59. package/dist/interactions/index.d.ts +15 -0
  60. package/dist/interactions/index.js +4 -0
  61. package/dist/interactions/keyboard-intents.d.ts +16 -0
  62. package/dist/interactions/keyboard-intents.js +33 -0
  63. package/dist/interactions/overlay-focus.d.ts +40 -0
  64. package/dist/interactions/overlay-focus.js +93 -0
  65. package/dist/interactions/typeahead.d.ts +20 -0
  66. package/dist/interactions/typeahead.js +41 -0
  67. package/dist/landmarks/index.d.ts +39 -0
  68. package/dist/landmarks/index.js +58 -0
  69. package/dist/link/index.d.ts +34 -0
  70. package/dist/link/index.js +39 -0
  71. package/dist/listbox/index.d.ts +92 -0
  72. package/dist/listbox/index.js +337 -0
  73. package/dist/menu/index.d.ts +132 -0
  74. package/dist/menu/index.js +541 -0
  75. package/dist/menu-button/index.d.ts +71 -0
  76. package/dist/menu-button/index.js +121 -0
  77. package/dist/meter/index.d.ts +45 -0
  78. package/dist/meter/index.js +106 -0
  79. package/dist/number/index.d.ts +113 -0
  80. package/dist/number/index.js +252 -0
  81. package/dist/popover/index.d.ts +70 -0
  82. package/dist/popover/index.js +126 -0
  83. package/dist/progress/index.d.ts +49 -0
  84. package/dist/progress/index.js +79 -0
  85. package/dist/radio-group/index.d.ts +61 -0
  86. package/dist/radio-group/index.js +150 -0
  87. package/dist/select/index.d.ts +92 -0
  88. package/dist/select/index.js +239 -0
  89. package/dist/sidebar/index.d.ts +74 -0
  90. package/dist/sidebar/index.js +186 -0
  91. package/dist/slider/index.d.ts +61 -0
  92. package/dist/slider/index.js +150 -0
  93. package/dist/slider-multi-thumb/index.d.ts +70 -0
  94. package/dist/slider-multi-thumb/index.js +222 -0
  95. package/dist/spinbutton/index.d.ts +75 -0
  96. package/dist/spinbutton/index.js +214 -0
  97. package/dist/spinner/index.d.ts +1 -0
  98. package/dist/spinner/index.js +1 -0
  99. package/dist/spinner/spinner.d.ts +23 -0
  100. package/dist/spinner/spinner.js +25 -0
  101. package/dist/switch/index.d.ts +40 -0
  102. package/dist/switch/index.js +61 -0
  103. package/dist/table/index.d.ts +117 -0
  104. package/dist/table/index.js +377 -0
  105. package/dist/tabs/index.d.ts +63 -0
  106. package/dist/tabs/index.js +174 -0
  107. package/dist/textarea/index.d.ts +68 -0
  108. package/dist/textarea/index.js +137 -0
  109. package/dist/toast/index.d.ts +67 -0
  110. package/dist/toast/index.js +145 -0
  111. package/dist/toolbar/index.d.ts +59 -0
  112. package/dist/toolbar/index.js +139 -0
  113. package/dist/tooltip/index.d.ts +52 -0
  114. package/dist/tooltip/index.js +169 -0
  115. package/dist/treegrid/index.d.ts +101 -0
  116. package/dist/treegrid/index.js +463 -0
  117. package/dist/treeview/index.d.ts +68 -0
  118. package/dist/treeview/index.js +370 -0
  119. package/dist/window-splitter/index.d.ts +65 -0
  120. package/dist/window-splitter/index.js +204 -0
  121. package/package.json +92 -0
  122. package/specs/ADR-001-headless-architecture.md +461 -0
  123. package/specs/ADR-002-repo-release-model.md +108 -0
  124. package/specs/ADR-003-public-api-versioning.md +136 -0
  125. package/specs/ADR-004-focus-selection-policy.md +117 -0
  126. package/specs/IMPLEMENTATION-ROADMAP.md +237 -0
  127. package/specs/ISSUE-BACKLOG.md +681 -0
  128. package/specs/RELEASE-CANDIDATE.md +30 -0
  129. package/specs/components/accordion.md +130 -0
  130. package/specs/components/alert-dialog.md +72 -0
  131. package/specs/components/alert.md +65 -0
  132. package/specs/components/badge.md +220 -0
  133. package/specs/components/breadcrumb.md +74 -0
  134. package/specs/components/button.md +115 -0
  135. package/specs/components/callout.md +195 -0
  136. package/specs/components/card.md +280 -0
  137. package/specs/components/carousel.md +140 -0
  138. package/specs/components/checkbox.md +172 -0
  139. package/specs/components/combobox.md +423 -0
  140. package/specs/components/command-palette.md +92 -0
  141. package/specs/components/context-menu.md +556 -0
  142. package/specs/components/copy-button.md +293 -0
  143. package/specs/components/date-picker.md +400 -0
  144. package/specs/components/dialog.md +298 -0
  145. package/specs/components/disclosure.md +257 -0
  146. package/specs/components/drawer.md +353 -0
  147. package/specs/components/feed.md +265 -0
  148. package/specs/components/grid.md +186 -0
  149. package/specs/components/input.md +254 -0
  150. package/specs/components/landmarks.md +136 -0
  151. package/specs/components/link.md +134 -0
  152. package/specs/components/listbox.md +351 -0
  153. package/specs/components/menu-button.md +76 -0
  154. package/specs/components/menu.md +623 -0
  155. package/specs/components/meter.md +149 -0
  156. package/specs/components/number.md +393 -0
  157. package/specs/components/popover.md +252 -0
  158. package/specs/components/progress.md +188 -0
  159. package/specs/components/radio-group.md +151 -0
  160. package/specs/components/select.md +144 -0
  161. package/specs/components/sidebar.md +321 -0
  162. package/specs/components/slider-multi-thumb.md +78 -0
  163. package/specs/components/slider.md +84 -0
  164. package/specs/components/spinbutton.md +140 -0
  165. package/specs/components/spinner.md +132 -0
  166. package/specs/components/switch.md +175 -0
  167. package/specs/components/table.md +403 -0
  168. package/specs/components/tabs.md +265 -0
  169. package/specs/components/textarea.md +185 -0
  170. package/specs/components/toast.md +198 -0
  171. package/specs/components/toolbar.md +278 -0
  172. package/specs/components/tooltip.md +252 -0
  173. package/specs/components/treegrid.md +281 -0
  174. package/specs/components/treeview.md +91 -0
  175. package/specs/components/window-splitter.md +297 -0
  176. package/specs/ops/git-shard-sync.md +107 -0
  177. package/specs/ops/release-checklist.md +76 -0
  178. package/specs/release/GAP-TO-GREEN-ISSUES.md +88 -0
  179. package/specs/release/api-freeze-candidate.md +54 -0
  180. package/specs/release/changelog-automation.md +76 -0
  181. package/specs/release/changelog.generated.md +53 -0
  182. package/specs/release/changelog.patch.generated.md +46 -0
  183. package/specs/release/consumer-integration.md +53 -0
  184. package/specs/release/migration-notes-pre-v1.md +40 -0
  185. package/specs/release/mvp-changelog.md +57 -0
  186. package/specs/release/release-notes-template.md +61 -0
  187. package/specs/release/release-rehearsal.md +113 -0
  188. package/specs/release/semver-deprecation-dry-run.md +89 -0
  189. package/specs/release/shard-release-drill-report.md +50 -0
  190. package/specs/release/shard-release-follow-ups.md +31 -0
  191. package/specs/signals.md +208 -0
@@ -0,0 +1,169 @@
1
+ import { action, atom } from '@reatom/core';
2
+ function parseTriggerModes(trigger) {
3
+ return new Set(trigger.trim().split(/\s+/).filter(Boolean));
4
+ }
5
+ export function createTooltip(options = {}) {
6
+ const idBase = options.idBase ?? 'tooltip';
7
+ const showDelay = Math.max(options.showDelay ?? 0, 0);
8
+ const hideDelay = Math.max(options.hideDelay ?? 0, 0);
9
+ const triggerModes = parseTriggerModes(options.trigger ?? 'hover focus');
10
+ const hasHover = triggerModes.has('hover');
11
+ const hasFocus = triggerModes.has('focus');
12
+ const hasClick = triggerModes.has('click');
13
+ const hasManual = triggerModes.has('manual');
14
+ const manualOnly = hasManual && !hasHover && !hasFocus && !hasClick;
15
+ const isOpenAtom = atom(options.initialOpen ?? false, `${idBase}.isOpen`);
16
+ const isDisabledAtom = atom(options.isDisabled ?? false, `${idBase}.isDisabled`);
17
+ let showTimer = null;
18
+ let hideTimer = null;
19
+ const clearShowTimer = () => {
20
+ if (showTimer == null)
21
+ return;
22
+ clearTimeout(showTimer);
23
+ showTimer = null;
24
+ };
25
+ const clearHideTimer = () => {
26
+ if (hideTimer == null)
27
+ return;
28
+ clearTimeout(hideTimer);
29
+ hideTimer = null;
30
+ };
31
+ const clearTimers = () => {
32
+ clearShowTimer();
33
+ clearHideTimer();
34
+ };
35
+ const open = action(() => {
36
+ if (isDisabledAtom())
37
+ return;
38
+ clearTimers();
39
+ isOpenAtom.set(true);
40
+ }, `${idBase}.open`);
41
+ const close = action(() => {
42
+ clearTimers();
43
+ isOpenAtom.set(false);
44
+ }, `${idBase}.close`);
45
+ const setDisabled = action((value) => {
46
+ isDisabledAtom.set(value);
47
+ if (value) {
48
+ close();
49
+ }
50
+ }, `${idBase}.setDisabled`);
51
+ const scheduleOpen = () => {
52
+ if (isDisabledAtom())
53
+ return;
54
+ clearHideTimer();
55
+ if (showDelay === 0) {
56
+ open();
57
+ return;
58
+ }
59
+ clearShowTimer();
60
+ showTimer = setTimeout(() => {
61
+ showTimer = null;
62
+ open();
63
+ }, showDelay);
64
+ };
65
+ const scheduleClose = () => {
66
+ clearShowTimer();
67
+ if (hideDelay === 0) {
68
+ close();
69
+ return;
70
+ }
71
+ clearHideTimer();
72
+ hideTimer = setTimeout(() => {
73
+ hideTimer = null;
74
+ close();
75
+ }, hideDelay);
76
+ };
77
+ const show = action(() => {
78
+ scheduleOpen();
79
+ }, `${idBase}.show`);
80
+ const hide = action(() => {
81
+ scheduleClose();
82
+ }, `${idBase}.hide`);
83
+ const handlePointerEnter = action(() => {
84
+ if (!hasHover || manualOnly)
85
+ return;
86
+ scheduleOpen();
87
+ }, `${idBase}.handlePointerEnter`);
88
+ const handlePointerLeave = action(() => {
89
+ if (!hasHover || manualOnly)
90
+ return;
91
+ scheduleClose();
92
+ }, `${idBase}.handlePointerLeave`);
93
+ const handleFocus = action(() => {
94
+ if (!hasFocus || manualOnly)
95
+ return;
96
+ scheduleOpen();
97
+ }, `${idBase}.handleFocus`);
98
+ const handleBlur = action(() => {
99
+ if (!hasFocus || manualOnly)
100
+ return;
101
+ scheduleClose();
102
+ }, `${idBase}.handleBlur`);
103
+ const handleClick = action(() => {
104
+ if (!hasClick || manualOnly)
105
+ return;
106
+ if (isDisabledAtom())
107
+ return;
108
+ clearTimers();
109
+ isOpenAtom.set(!isOpenAtom());
110
+ }, `${idBase}.handleClick`);
111
+ const handleKeyDown = action((event) => {
112
+ if (event.key === 'Escape') {
113
+ close();
114
+ }
115
+ }, `${idBase}.handleKeyDown`);
116
+ const triggerId = `${idBase}-trigger`;
117
+ const tooltipId = `${idBase}-content`;
118
+ const actions = {
119
+ open,
120
+ close,
121
+ show,
122
+ hide,
123
+ setDisabled,
124
+ handleKeyDown,
125
+ handlePointerEnter,
126
+ handlePointerLeave,
127
+ handleFocus,
128
+ handleBlur,
129
+ handleClick,
130
+ };
131
+ const contracts = {
132
+ getTriggerProps() {
133
+ const props = {
134
+ id: triggerId,
135
+ 'aria-describedby': isDisabledAtom() ? undefined : tooltipId,
136
+ onKeyDown: handleKeyDown,
137
+ };
138
+ if (hasHover && !manualOnly) {
139
+ props.onPointerEnter = handlePointerEnter;
140
+ props.onPointerLeave = handlePointerLeave;
141
+ }
142
+ if (hasFocus && !manualOnly) {
143
+ props.onFocus = handleFocus;
144
+ props.onBlur = handleBlur;
145
+ }
146
+ if (hasClick && !manualOnly) {
147
+ props.onClick = handleClick;
148
+ }
149
+ return props;
150
+ },
151
+ getTooltipProps() {
152
+ return {
153
+ id: tooltipId,
154
+ role: 'tooltip',
155
+ tabindex: '-1',
156
+ hidden: !isOpenAtom(),
157
+ };
158
+ },
159
+ };
160
+ const state = {
161
+ isOpen: isOpenAtom,
162
+ isDisabled: isDisabledAtom,
163
+ };
164
+ return {
165
+ state,
166
+ actions,
167
+ contracts,
168
+ };
169
+ }
@@ -0,0 +1,101 @@
1
+ import { type Atom, type Computed } from '@reatom/core';
2
+ export type TreegridSelectionMode = 'single' | 'multiple';
3
+ export type TreegridCellRole = 'gridcell' | 'rowheader' | 'columnheader';
4
+ export interface TreegridRow {
5
+ id: string;
6
+ index?: number;
7
+ disabled?: boolean;
8
+ children?: readonly TreegridRow[];
9
+ }
10
+ export interface TreegridColumn {
11
+ id: string;
12
+ index?: number;
13
+ disabled?: boolean;
14
+ cellRole?: TreegridCellRole;
15
+ }
16
+ export interface TreegridCellId {
17
+ rowId: string;
18
+ colId: string;
19
+ }
20
+ export interface TreegridKeyboardEventLike {
21
+ key: string;
22
+ shiftKey?: boolean;
23
+ ctrlKey?: boolean;
24
+ metaKey?: boolean;
25
+ altKey?: boolean;
26
+ }
27
+ export interface CreateTreegridOptions {
28
+ rows: readonly TreegridRow[];
29
+ columns: readonly TreegridColumn[];
30
+ disabledCells?: readonly TreegridCellId[];
31
+ idBase?: string;
32
+ ariaLabel?: string;
33
+ ariaLabelledBy?: string;
34
+ selectionMode?: TreegridSelectionMode;
35
+ initialExpandedRowIds?: readonly string[];
36
+ initialActiveCellId?: TreegridCellId | null;
37
+ initialSelectedRowIds?: readonly string[];
38
+ }
39
+ export interface TreegridState {
40
+ activeCellId: Atom<TreegridCellId | null>;
41
+ expandedRowIds: Atom<Set<string>>;
42
+ selectedRowIds: Atom<Set<string>>;
43
+ rowCount: Computed<number>;
44
+ columnCount: Computed<number>;
45
+ }
46
+ export interface TreegridActions {
47
+ moveUp(): void;
48
+ moveDown(): void;
49
+ moveLeft(): void;
50
+ moveRight(): void;
51
+ moveRowStart(): void;
52
+ moveRowEnd(): void;
53
+ expandRow(rowId: string): void;
54
+ collapseRow(rowId: string): void;
55
+ toggleRowExpanded(rowId: string): void;
56
+ selectRow(rowId: string): void;
57
+ toggleRowSelection(rowId: string): void;
58
+ handleKeyDown(event: TreegridKeyboardEventLike): void;
59
+ }
60
+ export interface TreegridProps {
61
+ id: string;
62
+ role: 'treegrid';
63
+ tabindex: '-1';
64
+ 'aria-label'?: string;
65
+ 'aria-labelledby'?: string;
66
+ 'aria-multiselectable': 'true' | 'false';
67
+ 'aria-rowcount': number;
68
+ 'aria-colcount': number;
69
+ }
70
+ export interface TreegridRowProps {
71
+ id: string;
72
+ role: 'row';
73
+ 'aria-level': number;
74
+ 'aria-posinset': number;
75
+ 'aria-setsize': number;
76
+ 'aria-rowindex': number;
77
+ 'aria-expanded'?: 'true' | 'false';
78
+ 'aria-selected': 'true' | 'false';
79
+ 'aria-disabled'?: 'true';
80
+ }
81
+ export interface TreegridCellProps {
82
+ id: string;
83
+ role: TreegridCellRole;
84
+ tabindex: '0' | '-1';
85
+ 'aria-colindex': number;
86
+ 'aria-selected': 'true' | 'false';
87
+ 'aria-disabled'?: 'true';
88
+ 'data-active': 'true' | 'false';
89
+ onFocus: () => void;
90
+ }
91
+ export interface TreegridContracts {
92
+ getTreegridProps(): TreegridProps;
93
+ getRowProps(rowId: string): TreegridRowProps;
94
+ getCellProps(rowId: string, colId: string): TreegridCellProps;
95
+ }
96
+ export interface TreegridModel {
97
+ readonly state: TreegridState;
98
+ readonly actions: TreegridActions;
99
+ readonly contracts: TreegridContracts;
100
+ }
101
+ export declare function createTreegrid(options: CreateTreegridOptions): TreegridModel;