@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.
- package/LICENSE +21 -0
- package/README.md +99 -0
- package/dist/a11y-contracts/index.d.ts +23 -0
- package/dist/a11y-contracts/index.js +1 -0
- package/dist/accordion/index.d.ts +78 -0
- package/dist/accordion/index.js +264 -0
- package/dist/adapters/index.d.ts +9 -0
- package/dist/adapters/index.js +1 -0
- package/dist/alert/index.d.ts +33 -0
- package/dist/alert/index.js +54 -0
- package/dist/alert-dialog/index.d.ts +69 -0
- package/dist/alert-dialog/index.js +94 -0
- package/dist/badge/index.d.ts +48 -0
- package/dist/badge/index.js +89 -0
- package/dist/breadcrumb/index.d.ts +55 -0
- package/dist/breadcrumb/index.js +77 -0
- package/dist/button/index.d.ts +46 -0
- package/dist/button/index.js +86 -0
- package/dist/callout/index.d.ts +41 -0
- package/dist/callout/index.js +63 -0
- package/dist/card/index.d.ts +54 -0
- package/dist/card/index.js +103 -0
- package/dist/carousel/index.d.ts +98 -0
- package/dist/carousel/index.js +243 -0
- package/dist/checkbox/index.d.ts +50 -0
- package/dist/checkbox/index.js +87 -0
- package/dist/combobox/index.d.ts +114 -0
- package/dist/combobox/index.js +431 -0
- package/dist/command-palette/index.d.ts +73 -0
- package/dist/command-palette/index.js +147 -0
- package/dist/context-menu/index.d.ts +111 -0
- package/dist/context-menu/index.js +372 -0
- package/dist/copy-button/index.d.ts +62 -0
- package/dist/copy-button/index.js +183 -0
- package/dist/core/index.d.ts +20 -0
- package/dist/core/index.js +2 -0
- package/dist/core/selection.d.ts +5 -0
- package/dist/core/selection.js +39 -0
- package/dist/core/value-range.d.ts +49 -0
- package/dist/core/value-range.js +134 -0
- package/dist/date-picker/index.d.ts +210 -0
- package/dist/date-picker/index.js +895 -0
- package/dist/dialog/index.d.ts +95 -0
- package/dist/dialog/index.js +153 -0
- package/dist/disclosure/index.d.ts +52 -0
- package/dist/disclosure/index.js +159 -0
- package/dist/drawer/index.d.ts +30 -0
- package/dist/drawer/index.js +39 -0
- package/dist/feed/index.d.ts +77 -0
- package/dist/feed/index.js +260 -0
- package/dist/grid/index.d.ts +103 -0
- package/dist/grid/index.js +415 -0
- package/dist/index.d.ts +51 -0
- package/dist/index.js +51 -0
- package/dist/input/index.d.ts +86 -0
- package/dist/input/index.js +156 -0
- package/dist/interactions/composite-navigation.d.ts +69 -0
- package/dist/interactions/composite-navigation.js +169 -0
- package/dist/interactions/index.d.ts +15 -0
- package/dist/interactions/index.js +4 -0
- package/dist/interactions/keyboard-intents.d.ts +16 -0
- package/dist/interactions/keyboard-intents.js +33 -0
- package/dist/interactions/overlay-focus.d.ts +40 -0
- package/dist/interactions/overlay-focus.js +93 -0
- package/dist/interactions/typeahead.d.ts +20 -0
- package/dist/interactions/typeahead.js +41 -0
- package/dist/landmarks/index.d.ts +39 -0
- package/dist/landmarks/index.js +58 -0
- package/dist/link/index.d.ts +34 -0
- package/dist/link/index.js +39 -0
- package/dist/listbox/index.d.ts +92 -0
- package/dist/listbox/index.js +337 -0
- package/dist/menu/index.d.ts +132 -0
- package/dist/menu/index.js +541 -0
- package/dist/menu-button/index.d.ts +71 -0
- package/dist/menu-button/index.js +121 -0
- package/dist/meter/index.d.ts +45 -0
- package/dist/meter/index.js +106 -0
- package/dist/number/index.d.ts +113 -0
- package/dist/number/index.js +252 -0
- package/dist/popover/index.d.ts +70 -0
- package/dist/popover/index.js +126 -0
- package/dist/progress/index.d.ts +49 -0
- package/dist/progress/index.js +79 -0
- package/dist/radio-group/index.d.ts +61 -0
- package/dist/radio-group/index.js +150 -0
- package/dist/select/index.d.ts +92 -0
- package/dist/select/index.js +239 -0
- package/dist/sidebar/index.d.ts +74 -0
- package/dist/sidebar/index.js +186 -0
- package/dist/slider/index.d.ts +61 -0
- package/dist/slider/index.js +150 -0
- package/dist/slider-multi-thumb/index.d.ts +70 -0
- package/dist/slider-multi-thumb/index.js +222 -0
- package/dist/spinbutton/index.d.ts +75 -0
- package/dist/spinbutton/index.js +214 -0
- package/dist/spinner/index.d.ts +1 -0
- package/dist/spinner/index.js +1 -0
- package/dist/spinner/spinner.d.ts +23 -0
- package/dist/spinner/spinner.js +25 -0
- package/dist/switch/index.d.ts +40 -0
- package/dist/switch/index.js +61 -0
- package/dist/table/index.d.ts +117 -0
- package/dist/table/index.js +377 -0
- package/dist/tabs/index.d.ts +63 -0
- package/dist/tabs/index.js +174 -0
- package/dist/textarea/index.d.ts +68 -0
- package/dist/textarea/index.js +137 -0
- package/dist/toast/index.d.ts +67 -0
- package/dist/toast/index.js +145 -0
- package/dist/toolbar/index.d.ts +59 -0
- package/dist/toolbar/index.js +139 -0
- package/dist/tooltip/index.d.ts +52 -0
- package/dist/tooltip/index.js +169 -0
- package/dist/treegrid/index.d.ts +101 -0
- package/dist/treegrid/index.js +463 -0
- package/dist/treeview/index.d.ts +68 -0
- package/dist/treeview/index.js +370 -0
- package/dist/window-splitter/index.d.ts +65 -0
- package/dist/window-splitter/index.js +204 -0
- package/package.json +92 -0
- package/specs/ADR-001-headless-architecture.md +461 -0
- package/specs/ADR-002-repo-release-model.md +108 -0
- package/specs/ADR-003-public-api-versioning.md +136 -0
- package/specs/ADR-004-focus-selection-policy.md +117 -0
- package/specs/IMPLEMENTATION-ROADMAP.md +237 -0
- package/specs/ISSUE-BACKLOG.md +681 -0
- package/specs/RELEASE-CANDIDATE.md +30 -0
- package/specs/components/accordion.md +130 -0
- package/specs/components/alert-dialog.md +72 -0
- package/specs/components/alert.md +65 -0
- package/specs/components/badge.md +220 -0
- package/specs/components/breadcrumb.md +74 -0
- package/specs/components/button.md +115 -0
- package/specs/components/callout.md +195 -0
- package/specs/components/card.md +280 -0
- package/specs/components/carousel.md +140 -0
- package/specs/components/checkbox.md +172 -0
- package/specs/components/combobox.md +423 -0
- package/specs/components/command-palette.md +92 -0
- package/specs/components/context-menu.md +556 -0
- package/specs/components/copy-button.md +293 -0
- package/specs/components/date-picker.md +400 -0
- package/specs/components/dialog.md +298 -0
- package/specs/components/disclosure.md +257 -0
- package/specs/components/drawer.md +353 -0
- package/specs/components/feed.md +265 -0
- package/specs/components/grid.md +186 -0
- package/specs/components/input.md +254 -0
- package/specs/components/landmarks.md +136 -0
- package/specs/components/link.md +134 -0
- package/specs/components/listbox.md +351 -0
- package/specs/components/menu-button.md +76 -0
- package/specs/components/menu.md +623 -0
- package/specs/components/meter.md +149 -0
- package/specs/components/number.md +393 -0
- package/specs/components/popover.md +252 -0
- package/specs/components/progress.md +188 -0
- package/specs/components/radio-group.md +151 -0
- package/specs/components/select.md +144 -0
- package/specs/components/sidebar.md +321 -0
- package/specs/components/slider-multi-thumb.md +78 -0
- package/specs/components/slider.md +84 -0
- package/specs/components/spinbutton.md +140 -0
- package/specs/components/spinner.md +132 -0
- package/specs/components/switch.md +175 -0
- package/specs/components/table.md +403 -0
- package/specs/components/tabs.md +265 -0
- package/specs/components/textarea.md +185 -0
- package/specs/components/toast.md +198 -0
- package/specs/components/toolbar.md +278 -0
- package/specs/components/tooltip.md +252 -0
- package/specs/components/treegrid.md +281 -0
- package/specs/components/treeview.md +91 -0
- package/specs/components/window-splitter.md +297 -0
- package/specs/ops/git-shard-sync.md +107 -0
- package/specs/ops/release-checklist.md +76 -0
- package/specs/release/GAP-TO-GREEN-ISSUES.md +88 -0
- package/specs/release/api-freeze-candidate.md +54 -0
- package/specs/release/changelog-automation.md +76 -0
- package/specs/release/changelog.generated.md +53 -0
- package/specs/release/changelog.patch.generated.md +46 -0
- package/specs/release/consumer-integration.md +53 -0
- package/specs/release/migration-notes-pre-v1.md +40 -0
- package/specs/release/mvp-changelog.md +57 -0
- package/specs/release/release-notes-template.md +61 -0
- package/specs/release/release-rehearsal.md +113 -0
- package/specs/release/semver-deprecation-dry-run.md +89 -0
- package/specs/release/shard-release-drill-report.md +50 -0
- package/specs/release/shard-release-follow-ups.md +31 -0
- 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;
|