@arshad-shah/cynosure 0.1.0 → 0.3.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 (275) hide show
  1. package/README.md +9 -8
  2. package/dist/components/Accordion/Accordion.d.ts +14 -0
  3. package/dist/components/Accordion/Accordion.js.map +1 -1
  4. package/dist/components/Announcer/Announcer.d.ts +1 -0
  5. package/dist/components/Announcer/Announcer.js.map +1 -1
  6. package/dist/components/AppShell/AppShell.d.ts +22 -1
  7. package/dist/components/AppShell/AppShell.js +95 -83
  8. package/dist/components/AppShell/AppShell.js.map +1 -1
  9. package/dist/components/AppShell/index.d.ts +1 -1
  10. package/dist/components/AspectRatio/AspectRatio.d.ts +29 -0
  11. package/dist/components/AspectRatio/AspectRatio.js +21 -0
  12. package/dist/components/AspectRatio/AspectRatio.js.map +1 -0
  13. package/dist/components/AspectRatio/index.d.ts +1 -0
  14. package/dist/components/Avatar/Avatar.d.ts +96 -0
  15. package/dist/components/Avatar/Avatar.js +90 -0
  16. package/dist/components/Avatar/Avatar.js.map +1 -0
  17. package/dist/components/Avatar/index.d.ts +1 -0
  18. package/dist/components/Badge/Badge.d.ts +6 -0
  19. package/dist/components/Badge/Badge.js.map +1 -1
  20. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +55 -0
  21. package/dist/components/Breadcrumbs/Breadcrumbs.js +85 -0
  22. package/dist/components/Breadcrumbs/Breadcrumbs.js.map +1 -0
  23. package/dist/components/Breadcrumbs/index.d.ts +1 -0
  24. package/dist/components/Button/Button.d.ts +13 -2
  25. package/dist/components/Button/Button.js +28 -26
  26. package/dist/components/Button/Button.js.map +1 -1
  27. package/dist/components/Calendar/Calendar.d.ts +65 -7
  28. package/dist/components/Calendar/Calendar.js +207 -95
  29. package/dist/components/Calendar/Calendar.js.map +1 -1
  30. package/dist/components/Calendar/dates.d.ts +4 -0
  31. package/dist/components/Calendar/dates.js +41 -27
  32. package/dist/components/Calendar/dates.js.map +1 -1
  33. package/dist/components/Calendar/index.d.ts +1 -1
  34. package/dist/components/Card/Card.d.ts +27 -0
  35. package/dist/components/Card/Card.js +48 -36
  36. package/dist/components/Card/Card.js.map +1 -1
  37. package/dist/components/Card/index.d.ts +1 -1
  38. package/dist/components/Checkbox/Checkbox.d.ts +8 -1
  39. package/dist/components/Checkbox/Checkbox.js +7 -6
  40. package/dist/components/Checkbox/Checkbox.js.map +1 -1
  41. package/dist/components/Checkbox/ChoiceRow.d.ts +17 -1
  42. package/dist/components/Checkbox/ChoiceRow.js +19 -18
  43. package/dist/components/Checkbox/ChoiceRow.js.map +1 -1
  44. package/dist/components/Checklist/Checklist.d.ts +65 -0
  45. package/dist/components/Checklist/Checklist.js +163 -0
  46. package/dist/components/Checklist/Checklist.js.map +1 -0
  47. package/dist/components/Checklist/index.d.ts +1 -0
  48. package/dist/components/CodeBlock/CodeBlock.d.ts +5 -0
  49. package/dist/components/CodeBlock/CodeBlock.js.map +1 -1
  50. package/dist/components/ColorField/ColorField.d.ts +12 -0
  51. package/dist/components/ColorField/ColorField.js +19 -19
  52. package/dist/components/ColorField/ColorField.js.map +1 -1
  53. package/dist/components/ColorSwatches/ColorSwatches.d.ts +5 -0
  54. package/dist/components/ColorSwatches/ColorSwatches.js +6 -6
  55. package/dist/components/ColorSwatches/ColorSwatches.js.map +1 -1
  56. package/dist/components/Combobox/Combobox.d.ts +20 -1
  57. package/dist/components/Combobox/Combobox.js +38 -34
  58. package/dist/components/Combobox/Combobox.js.map +1 -1
  59. package/dist/components/CommandPalette/CommandPalette.d.ts +9 -0
  60. package/dist/components/CommandPalette/CommandPalette.js +10 -10
  61. package/dist/components/CommandPalette/CommandPalette.js.map +1 -1
  62. package/dist/components/CompareSlider/CompareSlider.d.ts +4 -0
  63. package/dist/components/CompareSlider/CompareSlider.js +4 -4
  64. package/dist/components/CompareSlider/CompareSlider.js.map +1 -1
  65. package/dist/components/Container/Container.d.ts +44 -0
  66. package/dist/components/Container/Container.js +24 -0
  67. package/dist/components/Container/Container.js.map +1 -0
  68. package/dist/components/Container/index.d.ts +1 -0
  69. package/dist/components/ContextMenu/ContextMenu.d.ts +11 -0
  70. package/dist/components/ContextMenu/ContextMenu.js.map +1 -1
  71. package/dist/components/CopyButton/CopyButton.d.ts +8 -0
  72. package/dist/components/CopyButton/CopyButton.js.map +1 -1
  73. package/dist/components/DateField/DateField.d.ts +17 -0
  74. package/dist/components/DateField/DateField.js +6 -6
  75. package/dist/components/DateField/DateField.js.map +1 -1
  76. package/dist/components/DescriptionList/DescriptionList.d.ts +3 -0
  77. package/dist/components/DescriptionList/DescriptionList.js.map +1 -1
  78. package/dist/components/Dialog/Dialog.d.ts +16 -2
  79. package/dist/components/Dialog/Dialog.js +82 -70
  80. package/dist/components/Dialog/Dialog.js.map +1 -1
  81. package/dist/components/Disclosure/Disclosure.d.ts +7 -0
  82. package/dist/components/Disclosure/Disclosure.js.map +1 -1
  83. package/dist/components/Divider/Divider.d.ts +59 -0
  84. package/dist/components/Divider/Divider.js +32 -0
  85. package/dist/components/Divider/Divider.js.map +1 -0
  86. package/dist/components/Divider/index.d.ts +1 -0
  87. package/dist/components/DocumentViewport/DocumentViewport.d.ts +8 -0
  88. package/dist/components/DocumentViewport/DocumentViewport.js.map +1 -1
  89. package/dist/components/EmptyState/EmptyState.d.ts +3 -0
  90. package/dist/components/EmptyState/EmptyState.js.map +1 -1
  91. package/dist/components/Field/Field.d.ts +6 -0
  92. package/dist/components/Field/Field.js.map +1 -1
  93. package/dist/components/FileDrop/FileDrop.d.ts +8 -0
  94. package/dist/components/FileDrop/FileDrop.js.map +1 -1
  95. package/dist/components/FloatingToolbar/FloatingToolbar.d.ts +4 -0
  96. package/dist/components/FloatingToolbar/FloatingToolbar.js +4 -4
  97. package/dist/components/FloatingToolbar/FloatingToolbar.js.map +1 -1
  98. package/dist/components/Grid/Grid.d.ts +33 -7
  99. package/dist/components/Grid/Grid.js +46 -25
  100. package/dist/components/Grid/Grid.js.map +1 -1
  101. package/dist/components/Grid/index.d.ts +1 -1
  102. package/dist/components/Heading/Heading.d.ts +57 -0
  103. package/dist/components/Heading/Heading.js +33 -0
  104. package/dist/components/Heading/Heading.js.map +1 -0
  105. package/dist/components/Heading/index.d.ts +1 -0
  106. package/dist/components/HoverCard/HoverCard.d.ts +1 -0
  107. package/dist/components/HoverCard/HoverCard.js.map +1 -1
  108. package/dist/components/IconButton/IconButton.d.ts +1 -0
  109. package/dist/components/IconButton/IconButton.js.map +1 -1
  110. package/dist/components/Image/Image.d.ts +62 -0
  111. package/dist/components/Image/Image.js +75 -0
  112. package/dist/components/Image/Image.js.map +1 -0
  113. package/dist/components/Image/index.d.ts +1 -0
  114. package/dist/components/Inline/Inline.d.ts +7 -3
  115. package/dist/components/Inline/Inline.js +19 -13
  116. package/dist/components/Inline/Inline.js.map +1 -1
  117. package/dist/components/Kbd/Kbd.d.ts +2 -0
  118. package/dist/components/Kbd/Kbd.js.map +1 -1
  119. package/dist/components/KeyValueEditor/KeyValueEditor.d.ts +7 -0
  120. package/dist/components/KeyValueEditor/KeyValueEditor.js +8 -8
  121. package/dist/components/KeyValueEditor/KeyValueEditor.js.map +1 -1
  122. package/dist/components/Link/Link.d.ts +7 -0
  123. package/dist/components/Link/Link.js.map +1 -1
  124. package/dist/components/LoadingDots/LoadingDots.d.ts +2 -0
  125. package/dist/components/LoadingDots/LoadingDots.js.map +1 -1
  126. package/dist/components/Menu/Menu.d.ts +13 -1
  127. package/dist/components/Menu/Menu.js +37 -35
  128. package/dist/components/Menu/Menu.js.map +1 -1
  129. package/dist/components/Notice/Notice.d.ts +5 -0
  130. package/dist/components/Notice/Notice.js.map +1 -1
  131. package/dist/components/NumberField/NumberField.d.ts +17 -0
  132. package/dist/components/NumberField/NumberField.js +8 -8
  133. package/dist/components/NumberField/NumberField.js.map +1 -1
  134. package/dist/components/PageHeader/PageHeader.d.ts +61 -0
  135. package/dist/components/PageHeader/PageHeader.js +63 -0
  136. package/dist/components/PageHeader/PageHeader.js.map +1 -0
  137. package/dist/components/PageHeader/index.d.ts +1 -0
  138. package/dist/components/Pagination/Pagination.d.ts +77 -0
  139. package/dist/components/Pagination/Pagination.js +120 -0
  140. package/dist/components/Pagination/Pagination.js.map +1 -0
  141. package/dist/components/Pagination/index.d.ts +1 -0
  142. package/dist/components/PanZoomCanvas/PanZoomCanvas.d.ts +4 -0
  143. package/dist/components/PanZoomCanvas/PanZoomCanvas.js.map +1 -1
  144. package/dist/components/Popover/Popover.d.ts +10 -0
  145. package/dist/components/Popover/Popover.js.map +1 -1
  146. package/dist/components/ProgressBar/ProgressBar.d.ts +5 -0
  147. package/dist/components/ProgressBar/ProgressBar.js.map +1 -1
  148. package/dist/components/ProgressOverlay/ProgressOverlay.d.ts +3 -0
  149. package/dist/components/ProgressOverlay/ProgressOverlay.js.map +1 -1
  150. package/dist/components/Prose/Prose.d.ts +1 -0
  151. package/dist/components/Prose/Prose.js.map +1 -1
  152. package/dist/components/RadioGroup/RadioGroup.d.ts +13 -0
  153. package/dist/components/RadioGroup/RadioGroup.js.map +1 -1
  154. package/dist/components/SegmentedControl/SegmentedControl.d.ts +9 -0
  155. package/dist/components/SegmentedControl/SegmentedControl.js +35 -27
  156. package/dist/components/SegmentedControl/SegmentedControl.js.map +1 -1
  157. package/dist/components/Select/Select.d.ts +18 -1
  158. package/dist/components/Select/Select.js +97 -88
  159. package/dist/components/Select/Select.js.map +1 -1
  160. package/dist/components/Select/index.d.ts +1 -0
  161. package/dist/components/SelectionFrame/SelectionFrame.d.ts +6 -0
  162. package/dist/components/SelectionFrame/SelectionFrame.js.map +1 -1
  163. package/dist/components/SideNav/SideNav.d.ts +37 -1
  164. package/dist/components/SideNav/SideNav.js +100 -73
  165. package/dist/components/SideNav/SideNav.js.map +1 -1
  166. package/dist/components/SideNav/index.d.ts +1 -1
  167. package/dist/components/SignaturePad/SignaturePad.d.ts +3 -0
  168. package/dist/components/SignaturePad/SignaturePad.js.map +1 -1
  169. package/dist/components/Skeleton/Skeleton.d.ts +1 -0
  170. package/dist/components/Skeleton/Skeleton.js.map +1 -1
  171. package/dist/components/Slider/Slider.d.ts +11 -0
  172. package/dist/components/Slider/Slider.js +6 -6
  173. package/dist/components/Slider/Slider.js.map +1 -1
  174. package/dist/components/SortableList/SortableList.d.ts +6 -0
  175. package/dist/components/SortableList/SortableList.js.map +1 -1
  176. package/dist/components/SplitPane/SplitPane.d.ts +5 -0
  177. package/dist/components/SplitPane/SplitPane.js +4 -4
  178. package/dist/components/SplitPane/SplitPane.js.map +1 -1
  179. package/dist/components/Stack/Stack.d.ts +7 -3
  180. package/dist/components/Stack/Stack.js +18 -12
  181. package/dist/components/Stack/Stack.js.map +1 -1
  182. package/dist/components/Stack/index.d.ts +1 -0
  183. package/dist/components/Stack/space.d.ts +18 -0
  184. package/dist/components/Stack/space.js +12 -0
  185. package/dist/components/Stack/space.js.map +1 -0
  186. package/dist/components/Steps/Steps.d.ts +4 -0
  187. package/dist/components/Steps/Steps.js.map +1 -1
  188. package/dist/components/Table/Table.d.ts +12 -0
  189. package/dist/components/Table/Table.js.map +1 -1
  190. package/dist/components/Tabs/Tabs.d.ts +14 -0
  191. package/dist/components/Tabs/Tabs.js +4 -4
  192. package/dist/components/Tabs/Tabs.js.map +1 -1
  193. package/dist/components/TagInput/TagInput.d.ts +18 -0
  194. package/dist/components/TagInput/TagInput.js +5 -5
  195. package/dist/components/TagInput/TagInput.js.map +1 -1
  196. package/dist/components/Text/Text.d.ts +72 -0
  197. package/dist/components/Text/Text.js +30 -0
  198. package/dist/components/Text/Text.js.map +1 -0
  199. package/dist/components/Text/index.d.ts +1 -0
  200. package/dist/components/TextArea/TextArea.d.ts +10 -0
  201. package/dist/components/TextArea/TextArea.js +4 -4
  202. package/dist/components/TextArea/TextArea.js.map +1 -1
  203. package/dist/components/TextField/TextField.d.ts +13 -0
  204. package/dist/components/TextField/TextField.js +4 -4
  205. package/dist/components/TextField/TextField.js.map +1 -1
  206. package/dist/components/ThemeToggle/ThemeToggle.d.ts +4 -0
  207. package/dist/components/ThemeToggle/ThemeToggle.js.map +1 -1
  208. package/dist/components/TimeField/TimeField.d.ts +62 -8
  209. package/dist/components/TimeField/TimeField.js +308 -72
  210. package/dist/components/TimeField/TimeField.js.map +1 -1
  211. package/dist/components/Toast/Toast.d.ts +25 -1
  212. package/dist/components/Toast/Toast.js +134 -125
  213. package/dist/components/Toast/Toast.js.map +1 -1
  214. package/dist/components/Toast/index.d.ts +1 -1
  215. package/dist/components/Toolbar/Toolbar.d.ts +3 -0
  216. package/dist/components/Toolbar/Toolbar.js.map +1 -1
  217. package/dist/components/Tooltip/Tooltip.d.ts +1 -0
  218. package/dist/components/Tooltip/Tooltip.js.map +1 -1
  219. package/dist/components/Tree/Tree.d.ts +8 -0
  220. package/dist/components/Tree/Tree.js.map +1 -1
  221. package/dist/components/VirtualList/VirtualList.d.ts +8 -0
  222. package/dist/components/VirtualList/VirtualList.js +4 -4
  223. package/dist/components/VirtualList/VirtualList.js.map +1 -1
  224. package/dist/components/ZoomControls/ZoomControls.d.ts +4 -0
  225. package/dist/components/ZoomControls/ZoomControls.js.map +1 -1
  226. package/dist/foundations/ChoiceBase/ChoiceBase.d.ts +1 -0
  227. package/dist/foundations/ChoiceBase/ChoiceBase.js.map +1 -1
  228. package/dist/foundations/HiddenValue/HiddenValue.d.ts +3 -0
  229. package/dist/foundations/HiddenValue/HiddenValue.js.map +1 -1
  230. package/dist/foundations/Icon/Icon.d.ts +3 -0
  231. package/dist/foundations/Icon/Icon.js.map +1 -1
  232. package/dist/foundations/image-outcome.d.ts +15 -0
  233. package/dist/foundations/image-outcome.js +39 -0
  234. package/dist/foundations/image-outcome.js.map +1 -0
  235. package/dist/foundations/option-icon.d.ts +26 -0
  236. package/dist/foundations/option-icon.js +16 -0
  237. package/dist/foundations/option-icon.js.map +1 -0
  238. package/dist/icons/index.d.ts +1 -0
  239. package/dist/icons/index.js +476 -474
  240. package/dist/icons/keywords.d.ts +249 -0
  241. package/dist/icons/keywords.js +1728 -0
  242. package/dist/icons/keywords.js.map +1 -0
  243. package/dist/index.d.ts +20 -9
  244. package/dist/index.js +240 -213
  245. package/dist/styles/app-shell.css +1 -1
  246. package/dist/styles/aspect-ratio.css +1 -0
  247. package/dist/styles/avatar.css +1 -0
  248. package/dist/styles/breadcrumbs.css +1 -0
  249. package/dist/styles/calendar.css +1 -1
  250. package/dist/styles/card.css +1 -1
  251. package/dist/styles/checkbox.css +1 -1
  252. package/dist/styles/checklist.css +1 -0
  253. package/dist/styles/container.css +1 -0
  254. package/dist/styles/divider.css +1 -0
  255. package/dist/styles/generated-css.d.ts +1 -1
  256. package/dist/styles/generated-css.js +1 -1
  257. package/dist/styles/generated-css.js.map +1 -1
  258. package/dist/styles/grid.css +1 -1
  259. package/dist/styles/heading.css +1 -0
  260. package/dist/styles/image.css +1 -0
  261. package/dist/styles/menu.css +1 -1
  262. package/dist/styles/page-header.css +1 -0
  263. package/dist/styles/pagination.css +1 -0
  264. package/dist/styles/segmented-control.css +1 -1
  265. package/dist/styles/side-nav.css +1 -1
  266. package/dist/styles/stack.css +1 -1
  267. package/dist/styles/text.css +1 -0
  268. package/dist/styles/time-field.css +1 -1
  269. package/dist/styles/toast.css +1 -1
  270. package/dist/styles.css +1 -1
  271. package/dist/theme/CynosureTheme.d.ts +4 -0
  272. package/dist/theme/CynosureTheme.js.map +1 -1
  273. package/dist/tokens/to-css.js +12 -12
  274. package/dist/tokens/to-css.js.map +1 -1
  275. package/package.json +4 -3
@@ -1,21 +1,22 @@
1
1
  "use client";
2
2
  import { useControllableState as ee } from "../../foundations/controllable.js";
3
- import { ButtonBase as te } from "../../foundations/ButtonBase/ButtonBase.js";
4
- import { Icon as A } from "../../foundations/Icon/Icon.js";
5
- import { chevronDown as ae } from "../../icons/chevron-down.js";
6
- import { HiddenValue as re } from "../../foundations/HiddenValue/HiddenValue.js";
7
- import { isComposing as se } from "../../foundations/keys.js";
8
- import { Field as le } from "../Field/Field.js";
9
- import { useListboxLayer as oe } from "../../overlay/listbox-layer.js";
10
- import { isTypeaheadKey as L, seekEnabled as ce, useTypeahead as ne } from "../../foundations/listbox.js";
11
- import { Fragment as ie, useCallback as de, useEffect as ue, useId as pe, useRef as j, useState as P } from "react";
3
+ import { ButtonBase as ae } from "../../foundations/ButtonBase/ButtonBase.js";
4
+ import { Icon as te } from "../../foundations/Icon/Icon.js";
5
+ import { chevronDown as re } from "../../icons/chevron-down.js";
6
+ import { isTypeaheadKey as K, seekEnabled as se, useTypeahead as le } from "../../foundations/listbox.js";
7
+ import { OptionIcon as L } from "../../foundations/option-icon.js";
8
+ import { isComposing as ce } from "../../foundations/keys.js";
9
+ import { Field as oe } from "../Field/Field.js";
10
+ import { HiddenValue as ne } from "../../foundations/HiddenValue/HiddenValue.js";
11
+ import { useListboxLayer as ie } from "../../overlay/listbox-layer.js";
12
+ import { Fragment as de, useCallback as ue, useEffect as pe, useId as me, useRef as O, useState as P } from "react";
12
13
  import { jsx as s, jsxs as v } from "react/jsx-runtime";
13
- var F = 10;
14
- function fe(N) {
14
+ var j = 10;
15
+ function fe(D) {
15
16
  const d = [];
16
- return N.forEach((u, h) => {
17
- const a = d[d.length - 1];
18
- a && a.group === u.group ? a.items.push({
17
+ return D.forEach((u, h) => {
18
+ const t = d[d.length - 1];
19
+ t && t.group === u.group ? t.items.push({
19
20
  option: u,
20
21
  index: h
21
22
  }) : d.push({
@@ -28,113 +29,117 @@ function fe(N) {
28
29
  });
29
30
  }), d;
30
31
  }
31
- function xe({ label: N, labelHidden: d, description: u, error: h, options: a, value: H, defaultValue: k = "", onChange: O, placeholder: R, name: G, required: $, disabled: M, size: S = "md", variant: V = "outline", labels: b, className: W, style: z }) {
32
- const p = `cy-select-${pe().replace(/:/g, "")}`, y = j(null), I = j(null), [n, T, J] = ee(H, k, O), [c, U] = P(!1), [r, w] = P(-1), Q = ne(), [X, x] = P(!1), g = (t) => t >= 0 && t < a.length && !a[t]?.disabled, f = (t, e) => ce(a.length, t, e, g), q = () => f(-1, 1), B = () => f(a.length, -1), C = de((t) => {
33
- const e = a[t];
34
- !e || e.disabled || (x(!1), e.value !== n && T(e.value));
32
+ function Ee({ label: D, labelHidden: d, description: u, error: h, options: t, value: F, defaultValue: k = "", onChange: H, placeholder: R, name: G, required: $, disabled: I, size: M = "md", variant: V = "outline", labels: g, className: W, style: z }) {
33
+ const p = `cy-select-${me().replace(/:/g, "")}`, b = O(null), x = O(null), [n, S, J] = ee(F, k, H), [o, T] = P(!1), [r, w] = P(-1), Q = le(), [X, C] = P(!1), y = (a) => a >= 0 && a < t.length && !t[a]?.disabled, m = (a, e) => se(t.length, a, e, y), U = () => m(-1, 1), q = () => m(t.length, -1), E = ue((a) => {
34
+ const e = t[a];
35
+ !e || e.disabled || (C(!1), e.value !== n && S(e.value));
35
36
  }, [
36
- a,
37
+ t,
37
38
  n,
38
- T
39
- ]), m = (t = !0) => {
40
- U(!1), t && y.current?.focus();
41
- }, E = (t) => {
42
- const e = a.findIndex((o) => o.value === n);
43
- w(t ?? (g(e) ? e : q())), U(!0);
39
+ S
40
+ ]), f = (a = !0) => {
41
+ T(!1), a && b.current?.focus();
42
+ }, A = (a) => {
43
+ const e = t.findIndex((c) => c.value === n);
44
+ w(a ?? (y(e) ? e : U())), T(!0);
44
45
  };
45
- oe({
46
- anchor: y,
47
- list: I,
48
- open: c,
49
- onClose: () => m(!1),
46
+ ie({
47
+ anchor: b,
48
+ list: x,
49
+ open: o,
50
+ onClose: () => f(!1),
50
51
  capWidth: !0
51
- }), ue(() => {
52
- !c || r < 0 || I.current?.querySelector(`[data-index="${r}"]`)?.scrollIntoView({ block: "nearest" });
53
- }, [c, r]);
54
- const K = (t) => {
55
- const e = Q(t, a.map((o, l) => g(l) ? o.label : null), r);
56
- e >= 0 && (c ? w(e) : E(e));
57
- }, Y = (t) => {
58
- if (se(t)) return;
59
- const { key: e } = t;
60
- if (!c) {
52
+ }), pe(() => {
53
+ !o || r < 0 || x.current?.querySelector(`[data-index="${r}"]`)?.scrollIntoView({ block: "nearest" });
54
+ }, [o, r]);
55
+ const B = (a) => {
56
+ const e = Q(a, t.map((c, l) => y(l) ? c.label : null), r);
57
+ e >= 0 && (o ? w(e) : A(e));
58
+ }, Y = (a) => {
59
+ if (ce(a)) return;
60
+ const { key: e } = a;
61
+ if (!o) {
61
62
  [
62
63
  "ArrowDown",
63
64
  "ArrowUp",
64
65
  "Enter",
65
66
  " "
66
- ].includes(e) ? (t.preventDefault(), E(e === "ArrowUp" ? B() : void 0)) : L(t) && K(e);
67
+ ].includes(e) ? (a.preventDefault(), A(e === "ArrowUp" ? q() : void 0)) : K(a) && B(e);
67
68
  return;
68
69
  }
69
- const o = {
70
- ArrowDown: () => f(r, 1),
71
- ArrowUp: () => f(r, -1),
72
- Home: q,
73
- End: B,
74
- PageDown: () => f(Math.min(r + F - 1, a.length - 1), 1),
75
- PageUp: () => f(Math.max(r - F + 1, 0), -1)
70
+ const c = {
71
+ ArrowDown: () => m(r, 1),
72
+ ArrowUp: () => m(r, -1),
73
+ Home: U,
74
+ End: q,
75
+ PageDown: () => m(Math.min(r + j - 1, t.length - 1), 1),
76
+ PageUp: () => m(Math.max(r - j + 1, 0), -1)
76
77
  };
77
- o[e] ? (t.preventDefault(), w(o[e]())) : e === "Enter" || e === " " ? (t.preventDefault(), C(r), m()) : e === "Escape" ? (t.preventDefault(), m()) : e === "Tab" ? (C(r), m(!1)) : L(t) && K(e);
78
- }, D = a.find((t) => t.value === n), Z = R ?? b?.placeholder ?? "Select…";
79
- return /* @__PURE__ */ s(le, {
80
- label: N,
78
+ c[e] ? (a.preventDefault(), w(c[e]())) : e === "Enter" || e === " " ? (a.preventDefault(), E(r), f()) : e === "Escape" ? (a.preventDefault(), f()) : e === "Tab" ? (E(r), f(!1)) : K(a) && B(e);
79
+ }, N = t.find((a) => a.value === n), Z = R ?? g?.placeholder ?? "Select…";
80
+ return /* @__PURE__ */ s(oe, {
81
+ label: D,
81
82
  labelHidden: d,
82
83
  description: u,
83
- error: h ?? (X && !n ? b?.required ?? "Please choose a value." : void 0),
84
+ error: h ?? (X && !n ? g?.required ?? "Please choose a value." : void 0),
84
85
  required: $,
85
- size: S,
86
+ size: M,
86
87
  className: W,
87
88
  style: z,
88
- children: (t) => /* @__PURE__ */ v("div", {
89
+ children: (a) => /* @__PURE__ */ v("div", {
89
90
  className: "cy-select",
90
- "data-size": S,
91
+ "data-size": M,
91
92
  "data-variant": V,
92
93
  children: [
93
- /* @__PURE__ */ v(te, {
94
- ref: y,
95
- id: t.id,
94
+ /* @__PURE__ */ v(ae, {
95
+ ref: b,
96
+ id: a.id,
96
97
  role: "combobox",
97
98
  className: "cy-select-trigger",
98
- "aria-labelledby": t.labelId,
99
- "aria-describedby": t.describedBy,
100
- "aria-invalid": t.invalid || void 0,
99
+ "aria-labelledby": a.labelId,
100
+ "aria-describedby": a.describedBy,
101
+ "aria-invalid": a.invalid || void 0,
101
102
  "aria-required": $ || void 0,
102
103
  "aria-haspopup": "listbox",
103
- "aria-expanded": c,
104
+ "aria-expanded": o,
104
105
  "aria-controls": p,
105
- "aria-activedescendant": c && r >= 0 ? `${p}-${r}` : void 0,
106
- disabled: M,
107
- onClick: () => c ? m() : E(),
106
+ "aria-activedescendant": o && r >= 0 ? `${p}-${r}` : void 0,
107
+ disabled: I,
108
+ onClick: () => o ? f() : A(),
108
109
  onKeyDown: Y,
109
110
  children: [
110
- D?.icon && /* @__PURE__ */ s(A, { icon: D.icon }),
111
+ N && /* @__PURE__ */ s(L, {
112
+ option: N,
113
+ plain: I,
114
+ className: "cy-select-icon"
115
+ }),
111
116
  /* @__PURE__ */ s("span", {
112
117
  className: "cy-select-value",
113
- "data-placeholder": D ? void 0 : "",
114
- children: D?.label ?? Z
118
+ "data-placeholder": N ? void 0 : "",
119
+ children: N?.label ?? Z
115
120
  }),
116
- /* @__PURE__ */ s(A, {
117
- icon: ae,
121
+ /* @__PURE__ */ s(te, {
122
+ icon: re,
118
123
  className: "cy-select-chevron"
119
124
  })
120
125
  ]
121
126
  }),
122
127
  /* @__PURE__ */ v("div", {
123
- ref: I,
128
+ ref: x,
124
129
  id: p,
125
130
  role: "listbox",
126
- "aria-labelledby": t.labelId,
131
+ "aria-labelledby": a.labelId,
127
132
  className: "cy-select-list",
128
133
  popover: "manual",
129
- children: [a.length === 0 && /* @__PURE__ */ s("div", {
134
+ children: [t.length === 0 && /* @__PURE__ */ s("div", {
130
135
  role: "option",
131
136
  "aria-disabled": "true",
132
137
  "aria-selected": "false",
133
138
  tabIndex: -1,
134
139
  className: "cy-select-empty",
135
- children: b?.empty ?? "No options"
136
- }), fe(a).map((e) => {
137
- const o = e.items.map(({ option: l, index: i }) => /* @__PURE__ */ v("div", {
140
+ children: g?.empty ?? "No options"
141
+ }), fe(t).map((e) => {
142
+ const c = e.items.map(({ option: l, index: i }) => /* @__PURE__ */ v("div", {
138
143
  id: `${p}-${i}`,
139
144
  role: "option",
140
145
  "data-index": i,
@@ -143,14 +148,18 @@ function xe({ label: N, labelHidden: d, description: u, error: h, options: a, va
143
148
  "data-active": i === r ? "" : void 0,
144
149
  className: "cy-select-option",
145
150
  tabIndex: -1,
146
- onPointerMove: () => g(i) && w(i),
151
+ onPointerMove: () => y(i) && w(i),
147
152
  onPointerDown: (_) => _.preventDefault(),
148
153
  onClick: () => {
149
- g(i) && (C(i), m());
154
+ y(i) && (E(i), f());
150
155
  },
151
156
  onKeyDown: () => {
152
157
  },
153
- children: [l.icon && /* @__PURE__ */ s(A, { icon: l.icon }), /* @__PURE__ */ v("span", {
158
+ children: [/* @__PURE__ */ s(L, {
159
+ option: l,
160
+ plain: l.disabled,
161
+ className: "cy-select-icon"
162
+ }), /* @__PURE__ */ v("span", {
154
163
  className: "cy-select-option-text",
155
164
  children: [/* @__PURE__ */ s("span", {
156
165
  className: "cy-select-option-label",
@@ -161,7 +170,7 @@ function xe({ label: N, labelHidden: d, description: u, error: h, options: a, va
161
170
  })]
162
171
  })]
163
172
  }, l.value));
164
- return e.group === void 0 ? /* @__PURE__ */ s(ie, { children: o }, `run-${e.start}`) : /* @__PURE__ */ v("div", {
173
+ return e.group === void 0 ? /* @__PURE__ */ s(de, { children: c }, `run-${e.start}`) : /* @__PURE__ */ v("div", {
165
174
  role: "group",
166
175
  "aria-labelledby": `${p}-g${e.start}`,
167
176
  children: [/* @__PURE__ */ s("div", {
@@ -169,21 +178,21 @@ function xe({ label: N, labelHidden: d, description: u, error: h, options: a, va
169
178
  className: "cy-select-group",
170
179
  role: "presentation",
171
180
  children: e.group
172
- }), o]
181
+ }), c]
173
182
  }, `group-${e.start}`);
174
183
  })]
175
184
  }),
176
- /* @__PURE__ */ s(re, {
185
+ /* @__PURE__ */ s(ne, {
177
186
  name: G,
178
187
  value: n,
179
188
  required: $,
180
- disabled: M,
181
- requiredMessage: b?.required ?? "Please choose a value.",
189
+ disabled: I,
190
+ requiredMessage: g?.required ?? "Please choose a value.",
182
191
  onReset: () => {
183
- J(k), x(!1);
192
+ J(k), C(!1);
184
193
  },
185
194
  onInvalid: (e) => {
186
- e.preventDefault(), x(!0), y.current?.focus();
195
+ e.preventDefault(), C(!0), b.current?.focus();
187
196
  }
188
197
  })
189
198
  ]
@@ -191,7 +200,7 @@ function xe({ label: N, labelHidden: d, description: u, error: h, options: a, va
191
200
  });
192
201
  }
193
202
  export {
194
- xe as Select
203
+ Ee as Select
195
204
  };
196
205
 
197
206
  //# sourceMappingURL=Select.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Select.js","names":["useControllableState","ButtonBase","Icon","chevronDown","HiddenValue","isComposing","Field","useListboxLayer","isTypeaheadKey","seekEnabled","useTypeahead","Fragment","useCallback","useEffect","useId","useRef","useState","jsx","jsxs","PAGE","groupsOf","options","runs","option","index","last","Select","label","labelHidden","description","error","value","defaultValue","onChange","placeholder","name","required","disabled","size","variant","labels","className","style","listId","trigger","list","current","setCurrent","resetCurrent","open","setOpen","active","setActive","typeTo","missing","setMissing","enabled","i","step","from","delta","first","choose","close","focus","openList","at","selected","typeahead","key","hit","onKeyDown","e","moves","o","placeholderText","field","run","rows","event"],"sources":["../../../src/components/Select/Select.tsx"],"sourcesContent":["import {\n type CSSProperties,\n Fragment,\n type KeyboardEvent,\n type ReactNode,\n useCallback,\n useEffect,\n useId,\n useRef,\n useState,\n} from \"react\";\nimport { ButtonBase } from \"../../foundations/ButtonBase/ButtonBase.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { HiddenValue } from \"../../foundations/HiddenValue/HiddenValue.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { isComposing } from \"../../foundations/keys.js\";\nimport { isTypeaheadKey, seekEnabled, useTypeahead } from \"../../foundations/listbox.js\";\nimport { chevronDown } from \"../../icons/chevron-down.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport { useListboxLayer } from \"../../overlay/listbox-layer.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { Field } from \"../Field/Field.js\";\n\nexport interface SelectTokens {\n radius: string;\n bg: string;\n border: string;\n listBg: string;\n listShadow: string;\n listMaxHeight: string;\n optionActiveBg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n select: SelectTokens;\n }\n}\n\nexport interface SelectOption {\n value: string;\n label: string;\n description?: string;\n icon?: IconData;\n disabled?: boolean;\n /** Options next to each other with the same `group` are listed under that heading. */\n group?: string;\n}\n\nexport interface SelectProps {\n label: ReactNode;\n /** Visually hide the label (it still names the control). Prefer visible labels. */\n labelHidden?: boolean | undefined;\n description?: ReactNode;\n error?: ReactNode;\n options: SelectOption[];\n value?: string;\n defaultValue?: string;\n onChange?: (value: string) => void;\n placeholder?: string;\n name?: string;\n required?: boolean;\n disabled?: boolean;\n size?: Size;\n variant?: \"outline\" | \"soft\";\n labels?: { placeholder?: string; empty?: string; required?: string };\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n}\n\nconst PAGE = 10;\n\n/** Select-only combobox (WAI-ARIA APG): listbox in the top layer, typeahead, forms via HiddenValue. */\n/** Consecutive options that share a group, in order (ungrouped runs have no group). */\nfunction groupsOf(options: SelectOption[]) {\n const runs: {\n group: string | undefined;\n start: number;\n items: { option: SelectOption; index: number }[];\n }[] = [];\n options.forEach((option, index) => {\n const last = runs[runs.length - 1];\n if (last && last.group === option.group) last.items.push({ option, index });\n else runs.push({ group: option.group, start: index, items: [{ option, index }] });\n });\n return runs;\n}\n\nexport function Select({\n label,\n labelHidden,\n description,\n error,\n options,\n value,\n defaultValue = \"\",\n onChange,\n placeholder,\n name,\n required,\n disabled,\n size = \"md\",\n variant = \"outline\",\n labels,\n className,\n style,\n}: SelectProps) {\n const listId = `cy-select-${useId().replace(/:/g, \"\")}`;\n const trigger = useRef<HTMLButtonElement | null>(null);\n const list = useRef<HTMLDivElement | null>(null);\n const [current, setCurrent, resetCurrent] = useControllableState(value, defaultValue, onChange);\n const [open, setOpen] = useState(false);\n const [active, setActive] = useState(-1);\n const typeTo = useTypeahead();\n // Shown after a blocked submit: the hidden input cannot be focused or explained, so the trigger is.\n const [missing, setMissing] = useState(false);\n\n const enabled = (i: number) => i >= 0 && i < options.length && !options[i]?.disabled;\n const step = (from: number, delta: 1 | -1) => seekEnabled(options.length, from, delta, enabled);\n const first = () => step(-1, 1);\n const last = () => step(options.length, -1);\n\n const choose = useCallback(\n (index: number) => {\n const option = options[index];\n if (!option || option.disabled) return;\n setMissing(false);\n if (option.value !== current) setCurrent(option.value);\n },\n [options, current, setCurrent],\n );\n const close = (focus = true) => {\n setOpen(false);\n if (focus) trigger.current?.focus();\n };\n const openList = (at?: number) => {\n const selected = options.findIndex((o) => o.value === current);\n setActive(at ?? (enabled(selected) ? selected : first()));\n setOpen(true);\n };\n\n // As wide as the trigger, never wider than max(trigger, 20rem): long labels truncate instead of overflowing.\n useListboxLayer({ anchor: trigger, list, open, onClose: () => close(false), capWidth: true });\n useEffect(() => {\n if (!open || active < 0) return;\n list.current?.querySelector(`[data-index=\"${active}\"]`)?.scrollIntoView({ block: \"nearest\" });\n }, [open, active]);\n\n const typeahead = (key: string) => {\n const hit = typeTo(\n key,\n options.map((o, i) => (enabled(i) ? o.label : null)),\n active,\n );\n if (hit >= 0) {\n if (!open) openList(hit);\n else setActive(hit);\n }\n };\n\n const onKeyDown = (e: KeyboardEvent<HTMLButtonElement>) => {\n if (isComposing(e)) return;\n const { key } = e;\n if (!open) {\n if ([\"ArrowDown\", \"ArrowUp\", \"Enter\", \" \"].includes(key)) {\n e.preventDefault();\n openList(key === \"ArrowUp\" ? last() : undefined);\n } else if (isTypeaheadKey(e)) typeahead(key);\n return;\n }\n const moves: Record<string, () => number> = {\n ArrowDown: () => step(active, 1),\n ArrowUp: () => step(active, -1),\n Home: first,\n End: last,\n PageDown: () => step(Math.min(active + PAGE - 1, options.length - 1), 1),\n PageUp: () => step(Math.max(active - PAGE + 1, 0), -1),\n };\n if (moves[key]) {\n e.preventDefault();\n setActive(moves[key]());\n } else if (key === \"Enter\" || key === \" \") {\n e.preventDefault();\n choose(active);\n close();\n } else if (key === \"Escape\") {\n e.preventDefault();\n close();\n } else if (key === \"Tab\") {\n choose(active);\n close(false);\n } else if (isTypeaheadKey(e)) typeahead(key);\n };\n\n const selected = options.find((o) => o.value === current);\n const placeholderText = placeholder ?? labels?.placeholder ?? \"Select…\";\n\n return (\n <Field\n label={label}\n labelHidden={labelHidden}\n description={description}\n error={error ?? (missing && !current ? (labels?.required ?? \"Please choose a value.\") : undefined)}\n required={required}\n size={size}\n className={className}\n style={style}\n >\n {(field) => (\n <div className=\"cy-select\" data-size={size} data-variant={variant}>\n <ButtonBase\n ref={trigger}\n id={field.id}\n role=\"combobox\"\n className=\"cy-select-trigger\"\n aria-labelledby={field.labelId}\n aria-describedby={field.describedBy}\n aria-invalid={field.invalid || undefined}\n aria-required={required || undefined}\n aria-haspopup=\"listbox\"\n aria-expanded={open}\n aria-controls={listId}\n aria-activedescendant={open && active >= 0 ? `${listId}-${active}` : undefined}\n disabled={disabled}\n onClick={() => (open ? close() : openList())}\n onKeyDown={onKeyDown}\n >\n {selected?.icon && <Icon icon={selected.icon} />}\n <span className=\"cy-select-value\" data-placeholder={selected ? undefined : \"\"}>\n {selected?.label ?? placeholderText}\n </span>\n <Icon icon={chevronDown} className=\"cy-select-chevron\" />\n </ButtonBase>\n <div\n ref={list}\n id={listId}\n role=\"listbox\"\n aria-labelledby={field.labelId}\n className=\"cy-select-list\"\n {...{ popover: \"manual\" }}\n >\n {options.length === 0 && (\n <div\n role=\"option\"\n aria-disabled=\"true\"\n aria-selected=\"false\"\n tabIndex={-1}\n className=\"cy-select-empty\"\n >\n {labels?.empty ?? \"No options\"}\n </div>\n )}\n {groupsOf(options).map((run) => {\n const rows = run.items.map(({ option, index }) => (\n <div\n key={option.value}\n id={`${listId}-${index}`}\n role=\"option\"\n data-index={index}\n aria-selected={option.value === current}\n aria-disabled={option.disabled || undefined}\n data-active={index === active ? \"\" : undefined}\n className=\"cy-select-option\"\n tabIndex={-1}\n onPointerMove={() => enabled(index) && setActive(index)}\n onPointerDown={(e) => e.preventDefault()}\n onClick={() => {\n if (!enabled(index)) return;\n choose(index);\n close();\n }}\n onKeyDown={() => {}}\n >\n {option.icon && <Icon icon={option.icon} />}\n <span className=\"cy-select-option-text\">\n <span className=\"cy-select-option-label\">{option.label}</span>\n {option.description && (\n <span className=\"cy-select-option-description\">{option.description}</span>\n )}\n </span>\n </div>\n ));\n return run.group === undefined ? (\n <Fragment key={`run-${run.start}`}>{rows}</Fragment>\n ) : (\n // biome-ignore lint/a11y/useSemanticElements: a group of options inside a listbox; a fieldset is a form control\n <div key={`group-${run.start}`} role=\"group\" aria-labelledby={`${listId}-g${run.start}`}>\n <div id={`${listId}-g${run.start}`} className=\"cy-select-group\" role=\"presentation\">\n {run.group}\n </div>\n {rows}\n </div>\n );\n })}\n </div>\n <HiddenValue\n name={name}\n value={current}\n required={required}\n disabled={disabled}\n requiredMessage={labels?.required ?? \"Please choose a value.\"}\n onReset={() => {\n resetCurrent(defaultValue);\n setMissing(false);\n }}\n onInvalid={(event) => {\n event.preventDefault();\n setMissing(true);\n trigger.current?.focus();\n }}\n />\n </div>\n )}\n </Field>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"Select.js","names":["useControllableState","ButtonBase","Icon","chevronDown","isTypeaheadKey","seekEnabled","useTypeahead","OptionIcon","isComposing","Field","HiddenValue","useListboxLayer","Fragment","useCallback","useEffect","useId","useRef","useState","jsx","jsxs","PAGE","groupsOf","options","runs","option","index","last","Select","label","labelHidden","description","error","value","defaultValue","onChange","placeholder","name","required","disabled","size","variant","labels","className","style","listId","trigger","list","current","setCurrent","resetCurrent","open","setOpen","active","setActive","typeTo","missing","setMissing","enabled","i","step","from","delta","first","choose","close","focus","openList","at","selected","o","typeahead","key","hit","onKeyDown","e","moves","placeholderText","field","run","rows","event"],"sources":["../../../src/components/Select/Select.tsx"],"sourcesContent":["import {\n type CSSProperties,\n Fragment,\n type KeyboardEvent,\n type ReactNode,\n useCallback,\n useEffect,\n useId,\n useRef,\n useState,\n} from \"react\";\nimport { ButtonBase } from \"../../foundations/ButtonBase/ButtonBase.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { HiddenValue } from \"../../foundations/HiddenValue/HiddenValue.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { isComposing } from \"../../foundations/keys.js\";\nimport { isTypeaheadKey, seekEnabled, useTypeahead } from \"../../foundations/listbox.js\";\nimport { OptionIcon, type OptionIconColor } from \"../../foundations/option-icon.js\";\nimport { chevronDown } from \"../../icons/chevron-down.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport { useListboxLayer } from \"../../overlay/listbox-layer.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { Field } from \"../Field/Field.js\";\n\nexport interface SelectTokens {\n radius: string;\n bg: string;\n border: string;\n listBg: string;\n listShadow: string;\n listMaxHeight: string;\n optionActiveBg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n select: SelectTokens;\n }\n}\n\nexport interface SelectOption extends OptionIconColor {\n value: string;\n label: string;\n description?: string;\n /** Icon before the label, in the list and in the trigger when chosen. Colour it with `iconTone` or `iconColor`. */\n icon?: IconData;\n disabled?: boolean;\n /** Options next to each other with the same `group` are listed under that heading. */\n group?: string;\n}\n\nexport interface SelectProps {\n /** Names the control, shown above it. */\n label: ReactNode;\n /** Visually hide the label (it still names the control). Prefer visible labels. */\n labelHidden?: boolean | undefined;\n /** Help text shown below the control. */\n description?: ReactNode;\n /** Your own error; it replaces the built-in required message. */\n error?: ReactNode;\n /** The choices: `{ value, label, description?, icon?, iconTone?, iconColor?, disabled?, group? }`. */\n options: SelectOption[];\n /** Controlled selected value. */\n value?: string;\n /** Selected value at first, when uncontrolled. */\n defaultValue?: string;\n /** Called with the chosen option's value when it changes. */\n onChange?: (value: string) => void;\n /** Shown while nothing is chosen. Default \"Select…\". */\n placeholder?: string;\n /** Submits the value with its form under this name. */\n name?: string;\n /** The form will not submit until a value is chosen; also draws the required marker. */\n required?: boolean;\n /** Cannot be opened or changed, and is not submitted. */\n disabled?: boolean;\n /** Height and text size of the control. Default \"md\". */\n size?: Size;\n /** `outline`, or `soft` (tinted, no border). Default \"outline\". */\n variant?: \"outline\" | \"soft\";\n /** Replace the built-in English text: the placeholder, the empty list and the required message. */\n labels?: { placeholder?: string; empty?: string; required?: string };\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n}\n\nconst PAGE = 10;\n\n/** Select-only combobox (WAI-ARIA APG): listbox in the top layer, typeahead, forms via HiddenValue. */\n/** Consecutive options that share a group, in order (ungrouped runs have no group). */\nfunction groupsOf(options: SelectOption[]) {\n const runs: {\n group: string | undefined;\n start: number;\n items: { option: SelectOption; index: number }[];\n }[] = [];\n options.forEach((option, index) => {\n const last = runs[runs.length - 1];\n if (last && last.group === option.group) last.items.push({ option, index });\n else runs.push({ group: option.group, start: index, items: [{ option, index }] });\n });\n return runs;\n}\n\nexport function Select({\n label,\n labelHidden,\n description,\n error,\n options,\n value,\n defaultValue = \"\",\n onChange,\n placeholder,\n name,\n required,\n disabled,\n size = \"md\",\n variant = \"outline\",\n labels,\n className,\n style,\n}: SelectProps) {\n const listId = `cy-select-${useId().replace(/:/g, \"\")}`;\n const trigger = useRef<HTMLButtonElement | null>(null);\n const list = useRef<HTMLDivElement | null>(null);\n const [current, setCurrent, resetCurrent] = useControllableState(value, defaultValue, onChange);\n const [open, setOpen] = useState(false);\n const [active, setActive] = useState(-1);\n const typeTo = useTypeahead();\n // Shown after a blocked submit: the hidden input cannot be focused or explained, so the trigger is.\n const [missing, setMissing] = useState(false);\n\n const enabled = (i: number) => i >= 0 && i < options.length && !options[i]?.disabled;\n const step = (from: number, delta: 1 | -1) => seekEnabled(options.length, from, delta, enabled);\n const first = () => step(-1, 1);\n const last = () => step(options.length, -1);\n\n const choose = useCallback(\n (index: number) => {\n const option = options[index];\n if (!option || option.disabled) return;\n setMissing(false);\n if (option.value !== current) setCurrent(option.value);\n },\n [options, current, setCurrent],\n );\n const close = (focus = true) => {\n setOpen(false);\n if (focus) trigger.current?.focus();\n };\n const openList = (at?: number) => {\n const selected = options.findIndex((o) => o.value === current);\n setActive(at ?? (enabled(selected) ? selected : first()));\n setOpen(true);\n };\n\n // As wide as the trigger, never wider than max(trigger, 20rem): long labels truncate instead of overflowing.\n useListboxLayer({ anchor: trigger, list, open, onClose: () => close(false), capWidth: true });\n useEffect(() => {\n if (!open || active < 0) return;\n list.current?.querySelector(`[data-index=\"${active}\"]`)?.scrollIntoView({ block: \"nearest\" });\n }, [open, active]);\n\n const typeahead = (key: string) => {\n const hit = typeTo(\n key,\n options.map((o, i) => (enabled(i) ? o.label : null)),\n active,\n );\n if (hit >= 0) {\n if (!open) openList(hit);\n else setActive(hit);\n }\n };\n\n const onKeyDown = (e: KeyboardEvent<HTMLButtonElement>) => {\n if (isComposing(e)) return;\n const { key } = e;\n if (!open) {\n if ([\"ArrowDown\", \"ArrowUp\", \"Enter\", \" \"].includes(key)) {\n e.preventDefault();\n openList(key === \"ArrowUp\" ? last() : undefined);\n } else if (isTypeaheadKey(e)) typeahead(key);\n return;\n }\n const moves: Record<string, () => number> = {\n ArrowDown: () => step(active, 1),\n ArrowUp: () => step(active, -1),\n Home: first,\n End: last,\n PageDown: () => step(Math.min(active + PAGE - 1, options.length - 1), 1),\n PageUp: () => step(Math.max(active - PAGE + 1, 0), -1),\n };\n if (moves[key]) {\n e.preventDefault();\n setActive(moves[key]());\n } else if (key === \"Enter\" || key === \" \") {\n e.preventDefault();\n choose(active);\n close();\n } else if (key === \"Escape\") {\n e.preventDefault();\n close();\n } else if (key === \"Tab\") {\n choose(active);\n close(false);\n } else if (isTypeaheadKey(e)) typeahead(key);\n };\n\n const selected = options.find((o) => o.value === current);\n const placeholderText = placeholder ?? labels?.placeholder ?? \"Select…\";\n\n return (\n <Field\n label={label}\n labelHidden={labelHidden}\n description={description}\n error={error ?? (missing && !current ? (labels?.required ?? \"Please choose a value.\") : undefined)}\n required={required}\n size={size}\n className={className}\n style={style}\n >\n {(field) => (\n <div className=\"cy-select\" data-size={size} data-variant={variant}>\n <ButtonBase\n ref={trigger}\n id={field.id}\n role=\"combobox\"\n className=\"cy-select-trigger\"\n aria-labelledby={field.labelId}\n aria-describedby={field.describedBy}\n aria-invalid={field.invalid || undefined}\n aria-required={required || undefined}\n aria-haspopup=\"listbox\"\n aria-expanded={open}\n aria-controls={listId}\n aria-activedescendant={open && active >= 0 ? `${listId}-${active}` : undefined}\n disabled={disabled}\n onClick={() => (open ? close() : openList())}\n onKeyDown={onKeyDown}\n >\n {selected && <OptionIcon option={selected} plain={disabled} className=\"cy-select-icon\" />}\n <span className=\"cy-select-value\" data-placeholder={selected ? undefined : \"\"}>\n {selected?.label ?? placeholderText}\n </span>\n <Icon icon={chevronDown} className=\"cy-select-chevron\" />\n </ButtonBase>\n <div\n ref={list}\n id={listId}\n role=\"listbox\"\n aria-labelledby={field.labelId}\n className=\"cy-select-list\"\n {...{ popover: \"manual\" }}\n >\n {options.length === 0 && (\n <div\n role=\"option\"\n aria-disabled=\"true\"\n aria-selected=\"false\"\n tabIndex={-1}\n className=\"cy-select-empty\"\n >\n {labels?.empty ?? \"No options\"}\n </div>\n )}\n {groupsOf(options).map((run) => {\n const rows = run.items.map(({ option, index }) => (\n <div\n key={option.value}\n id={`${listId}-${index}`}\n role=\"option\"\n data-index={index}\n aria-selected={option.value === current}\n aria-disabled={option.disabled || undefined}\n data-active={index === active ? \"\" : undefined}\n className=\"cy-select-option\"\n tabIndex={-1}\n onPointerMove={() => enabled(index) && setActive(index)}\n onPointerDown={(e) => e.preventDefault()}\n onClick={() => {\n if (!enabled(index)) return;\n choose(index);\n close();\n }}\n onKeyDown={() => {}}\n >\n <OptionIcon option={option} plain={option.disabled} className=\"cy-select-icon\" />\n <span className=\"cy-select-option-text\">\n <span className=\"cy-select-option-label\">{option.label}</span>\n {option.description && (\n <span className=\"cy-select-option-description\">{option.description}</span>\n )}\n </span>\n </div>\n ));\n return run.group === undefined ? (\n <Fragment key={`run-${run.start}`}>{rows}</Fragment>\n ) : (\n // biome-ignore lint/a11y/useSemanticElements: a group of options inside a listbox; a fieldset is a form control\n <div key={`group-${run.start}`} role=\"group\" aria-labelledby={`${listId}-g${run.start}`}>\n <div id={`${listId}-g${run.start}`} className=\"cy-select-group\" role=\"presentation\">\n {run.group}\n </div>\n {rows}\n </div>\n );\n })}\n </div>\n <HiddenValue\n name={name}\n value={current}\n required={required}\n disabled={disabled}\n requiredMessage={labels?.required ?? \"Please choose a value.\"}\n onReset={() => {\n resetCurrent(defaultValue);\n setMissing(false);\n }}\n onInvalid={(event) => {\n event.preventDefault();\n setMissing(true);\n trigger.current?.focus();\n }}\n />\n </div>\n )}\n </Field>\n );\n}\n"],"mappings":"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"}
@@ -1 +1,2 @@
1
+ export type { OptionIconColor } from "../../foundations/option-icon.js";
1
2
  export { Select, type SelectOption, type SelectProps, type SelectTokens } from "./Select.js";
@@ -31,7 +31,9 @@ export interface SelectionFrameProps {
31
31
  rotate?: number;
32
32
  /** CSS pixels per unit (the zoom). Default 1. */
33
33
  scale?: number;
34
+ /** Show the eight resize handles; Alt+arrows resize too. */
34
35
  resizable?: boolean;
36
+ /** Show the rotate handle; the [ and ] keys turn it by 15 degrees. */
35
37
  rotatable?: boolean;
36
38
  /** Keep the width-to-height ratio while resizing (Shift does it for one drag). */
37
39
  keepAspect?: boolean;
@@ -44,6 +46,7 @@ export interface SelectionFrameProps {
44
46
  } | undefined;
45
47
  /** Arrow keys move (and Alt+arrows resize) by this many units; Shift by `largeStep`. Defaults 1 and 10. */
46
48
  step?: number;
49
+ /** Units the arrow keys move (and Alt+arrows resize) by with Shift held. Default 10. */
47
50
  largeStep?: number;
48
51
  /** Adjust every proposed box, e.g. snap to a grid or to other objects. */
49
52
  snap?: ((box: FrameBox) => FrameBox) | undefined;
@@ -51,8 +54,11 @@ export interface SelectionFrameProps {
51
54
  onChange?: ((box: FrameBox, rotate: number) => void) | undefined;
52
55
  /** The end of one change: pointer up, key up or Enter. One undo step. */
53
56
  onCommit: (box: FrameBox, rotate: number) => void;
57
+ /** Ids of text that describes the frame, such as its keys. */
54
58
  "aria-describedby"?: string | undefined;
59
+ /** Replace the built-in English text: how screen readers call the frame and the drawing area. */
55
60
  labels?: Partial<SelectionFrameLabels>;
61
+ /** Added to the frame element, for layout. */
56
62
  className?: string;
57
63
  /** Layout only. Restyle through --cy-selection-frame-* tokens. */
58
64
  style?: CSSProperties;
@@ -1 +1 @@
1
- {"version":3,"file":"SelectionFrame.js","names":["bindPointer","_Fragment","N","useDrag","angleFrom","contain","moveBy","resizeBy","resizeByKey","useEffect","useRef","useState","Fragment$1","jsx","jsxs","HANDLES","ARROWS","SelectionFrame","label","box","rotate","scale","draw","resizable","rotatable","keepAspect","minSize","bounds","step","largeStep","snap","onChange","onCommit","describedBy","labels","className","style","frame","surface","live","setLive","liveRef","props","limits","limitsRef","seen","latest","set","next","change","nextBox","nextRotate","p","start","snapped","commit","current","cancel","units","point","k","b","x","y","origin","a","drawn","_","cancelled","place","el","area","placed","focusFrame","begin","from","end","bound","session","delta","b0","r0","handle","event","name","r","deg","aspect","onKeyDown","by","dir","onKeyUp","shown"],"sources":["../../../src/components/SelectionFrame/SelectionFrame.tsx"],"sourcesContent":["import { bindPointer } from \"@arshad-shah/detent\";\nimport { type CSSProperties, type KeyboardEvent, useEffect, useRef, useState } from \"react\";\nimport { useDrag } from \"../../foundations/drag.js\";\nimport {\n angleFrom,\n contain,\n type FrameBox,\n type FrameHandle,\n type FrameLimits,\n moveBy,\n resizeBy,\n resizeByKey,\n} from \"./frame-math.js\";\n\nexport interface SelectionFrameTokens {\n /** Outline and handle colour. */\n color: string;\n /** Visible size of a handle. */\n handleSize: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n selectionFrame: SelectionFrameTokens;\n }\n}\n\nexport interface SelectionFrameLabels {\n /** How screen readers call the frame. Default: \"selection\". */\n roleDescription: string;\n /** With `draw` and no box: how screen readers call the empty area. Default: \"drawing area\". */\n drawArea: string;\n}\n\nexport interface SelectionFrameProps {\n /** Accessible name, e.g. \"Text box: Hello\". Describe the keys nearby with `aria-describedby`. */\n label: string;\n /** Where the object is, in your units (page points, canvas pixels). `null` before one is drawn (with `draw`). */\n box: FrameBox | null;\n /**\n * Draw a new box by dragging anywhere on the layer (a region select, a crop, a grid area). A press on the frame\n * still moves it. With no box yet, the layer is focusable and Enter places one in the middle for the keyboard.\n */\n draw?: boolean;\n /** Degrees, clockwise. */\n rotate?: number;\n /** CSS pixels per unit (the zoom). Default 1. */\n scale?: number;\n resizable?: boolean;\n rotatable?: boolean;\n /** Keep the width-to-height ratio while resizing (Shift does it for one drag). */\n keepAspect?: boolean;\n /** Smallest width and height, in units. Default 1. */\n minSize?: number;\n /** Keep the object inside this area (units). */\n bounds?: { width: number; height: number } | undefined;\n /** Arrow keys move (and Alt+arrows resize) by this many units; Shift by `largeStep`. Defaults 1 and 10. */\n step?: number;\n largeStep?: number;\n /** Adjust every proposed box, e.g. snap to a grid or to other objects. */\n snap?: ((box: FrameBox) => FrameBox) | undefined;\n /** Every change while dragging or holding a key (a preview). */\n onChange?: ((box: FrameBox, rotate: number) => void) | undefined;\n /** The end of one change: pointer up, key up or Enter. One undo step. */\n onCommit: (box: FrameBox, rotate: number) => void;\n \"aria-describedby\"?: string | undefined;\n labels?: Partial<SelectionFrameLabels>;\n className?: string;\n /** Layout only. Restyle through --cy-selection-frame-* tokens. */\n style?: CSSProperties;\n}\n\nconst HANDLES: FrameHandle[] = [\"nw\", \"n\", \"ne\", \"e\", \"se\", \"s\", \"sw\", \"w\"];\nconst ARROWS: Record<string, [number, number]> = {\n ArrowLeft: [-1, 0],\n ArrowRight: [1, 0],\n ArrowUp: [0, -1],\n ArrowDown: [0, 1],\n};\n\ninterface Live {\n box: FrameBox;\n rotate: number;\n /** Where the change began; `box` is null while the first box is being drawn. */\n start: { box: FrameBox | null; rotate: number };\n}\n\n/**\n * Move, resize and rotate one selected object: drag it or its handles (mouse, pen or touch, through detent), or focus\n * it and use the keys. You own the geometry: `onChange` previews, `onCommit` ends each change (one undo step), and\n * Escape cancels back to where it started. Place it in a positioned layer over your canvas or page.\n */\nexport function SelectionFrame({\n label,\n box,\n rotate = 0,\n scale = 1,\n draw = false,\n resizable = false,\n rotatable = false,\n keepAspect = false,\n minSize = 1,\n bounds,\n step = 1,\n largeStep = 10,\n snap,\n onChange,\n onCommit,\n \"aria-describedby\": describedBy,\n labels,\n className,\n style,\n}: SelectionFrameProps) {\n const frame = useRef<HTMLDivElement>(null);\n const surface = useRef<HTMLDivElement>(null);\n const [live, setLive] = useState<Live | null>(null);\n const liveRef = useRef<Live | null>(null);\n // Pointer handlers are bound once; they read the latest props through this ref.\n const props = useRef({ box, rotate, scale, keepAspect, snap, onChange, onCommit });\n props.current = { box, rotate, scale, keepAspect, snap, onChange, onCommit };\n const limits: FrameLimits = { minSize, bounds };\n const limitsRef = useRef(limits);\n limitsRef.current = limits;\n\n // The last committed geometry, until new props arrive: a second key press or drag can begin before the parent\n // re-renders with the first one's result.\n const seen = useRef({ box, rotate });\n const latest = useRef({ box, rotate });\n if (seen.current.box !== box || seen.current.rotate !== rotate) {\n seen.current = { box, rotate };\n latest.current = { box, rotate };\n }\n\n const set = (next: Live | null) => {\n liveRef.current = next;\n setLive(next);\n };\n const change = (nextBox: FrameBox, nextRotate: number) => {\n const p = props.current;\n const start = liveRef.current?.start ?? latest.current;\n const snapped = p.snap ? p.snap(nextBox) : nextBox;\n set({ box: snapped, rotate: nextRotate, start });\n p.onChange?.(snapped, nextRotate);\n };\n const commit = () => {\n const current = liveRef.current;\n if (!current) return;\n set(null);\n latest.current = { box: current.box, rotate: current.rotate };\n props.current.onCommit(current.box, current.rotate);\n };\n const cancel = () => {\n const current = liveRef.current;\n if (!current) return;\n set(null);\n if (current.start.box) props.current.onChange?.(current.start.box, current.start.rotate);\n };\n\n // Drawing a new box: from where the press landed to where the pointer is, in units, kept inside `bounds`.\n const units = (point: { x: number; y: number }) => {\n const r = (surface.current as HTMLDivElement).getBoundingClientRect();\n const k = props.current.scale;\n const b = limitsRef.current.bounds;\n const x = (point.x - r.left) / k;\n const y = (point.y - r.top) / k;\n return b ? { x: Math.min(Math.max(x, 0), b.width), y: Math.min(Math.max(y, 0), b.height) } : { x, y };\n };\n useDrag(surface, {\n distance: 3,\n onStart: () => {\n if (!draw) return false;\n set(null);\n },\n onMove: ({ origin, point }) => {\n const a = units(origin);\n const b = units(point);\n const drawn = {\n x: Math.min(a.x, b.x),\n y: Math.min(a.y, b.y),\n width: Math.abs(b.x - a.x),\n height: Math.abs(b.y - a.y),\n };\n const start = liveRef.current?.start ?? latest.current;\n const snapped = props.current.snap ? props.current.snap(drawn) : drawn;\n set({ box: snapped, rotate: 0, start });\n props.current.onChange?.(snapped, 0);\n },\n onEnd: (_, cancelled) => {\n const current = liveRef.current;\n // Too small to be a box (a slip of the pointer): drop it, like a cancel.\n if (cancelled || !current || current.box.width < minSize || current.box.height < minSize) cancel();\n else commit();\n },\n });\n /** The keyboard's way to draw: a box half the area's size, in its middle. */\n const place = () => {\n const el = surface.current as HTMLDivElement;\n const area = bounds ?? { width: el.clientWidth / scale, height: el.clientHeight / scale };\n const placed = contain(\n { x: area.width / 4, y: area.height / 4, width: area.width / 2, height: area.height / 2 },\n limits,\n );\n focusFrame.current = true;\n latest.current = { box: placed, rotate: 0 };\n onCommit(placed, 0);\n };\n const focusFrame = useRef(false);\n useEffect(() => {\n if (!focusFrame.current || !frame.current) return;\n focusFrame.current = false;\n frame.current.focus({ preventScroll: true });\n });\n\n // Pointer gestures through detent: the frame moves, each handle resizes or rotates. Escape cancels a drag.\n const hasFrame = (live ?? box) !== null;\n useEffect(() => {\n const el = frame.current;\n if (!el) return;\n const begin = () => {\n const from = latest.current as { box: FrameBox; rotate: number };\n set({ ...from, start: from });\n el.focus({ preventScroll: true });\n };\n const end = (_: unknown, cancelled: boolean) => (cancelled ? cancel() : commit());\n const bound = [\n bindPointer(el, {\n cancel: \"[data-handle]\",\n onStart: (session) => {\n if (session.event.button !== 0) return false;\n begin();\n },\n onMove: ({ delta }) => {\n const { box: b0, rotate: r0 } = (liveRef.current as Live).start as {\n box: FrameBox;\n rotate: number;\n };\n const k = props.current.scale;\n change(moveBy(b0, delta.x / k, delta.y / k, limitsRef.current), r0);\n },\n onEnd: end,\n }),\n ...[...el.querySelectorAll<HTMLElement>(\"[data-handle]\")].map((handle) =>\n bindPointer(handle, {\n distance: 0,\n delay: 0,\n onStart: () => begin(),\n onMove: ({ delta, point, event }) => {\n const { box: b0, rotate: r0 } = (liveRef.current as Live).start as {\n box: FrameBox;\n rotate: number;\n };\n const name = handle.dataset.handle as FrameHandle | \"rotate\";\n if (name === \"rotate\") {\n const r = el.getBoundingClientRect();\n const deg = angleFrom(r.left + r.width / 2, r.top + r.height / 2, point.x, point.y);\n change(b0, event.shiftKey ? Math.round(deg / 15) * 15 : deg);\n return;\n }\n const k = props.current.scale;\n const aspect = props.current.keepAspect || event.shiftKey;\n change(resizeBy(b0, name, delta.x / k, delta.y / k, r0, aspect, limitsRef.current), r0);\n },\n onEnd: end,\n }),\n ),\n ];\n return () => {\n for (const b of bound) b.destroy();\n };\n // Rebind when the set of handles changes.\n }, [resizable, rotatable, hasFrame]);\n\n const onKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {\n if (event.target !== event.currentTarget) return;\n const current = (liveRef.current ?? latest.current) as { box: FrameBox; rotate: number };\n const by = event.shiftKey ? largeStep : step;\n if (event.key === \"Escape\" || event.key === \"Enter\") {\n if (!liveRef.current) return;\n event.preventDefault();\n event.stopPropagation();\n if (event.key === \"Escape\") cancel();\n else commit();\n return;\n }\n if (rotatable && (event.key === \"[\" || event.key === \"]\")) {\n event.preventDefault();\n change(current.box, current.rotate + (event.key === \"]\" ? 15 : -15));\n return;\n }\n const dir = ARROWS[event.key];\n if (!dir) return;\n // Alt+Left would otherwise go back in history.\n event.preventDefault();\n if (event.altKey) {\n if (resizable)\n change(resizeByKey(current.box, event.key, by, current.rotate, keepAspect, limits), current.rotate);\n return;\n }\n change(moveBy(current.box, dir[0] * by, dir[1] * by, limits), current.rotate);\n };\n const onKeyUp = (event: KeyboardEvent<HTMLDivElement>) => {\n if (ARROWS[event.key] || event.key === \"[\" || event.key === \"]\") commit();\n };\n\n const shown = live ?? (box ? { box, rotate } : null);\n const area = draw && (\n <div\n ref={surface}\n className=\"cy-selection-frame-surface cy-reset\"\n {...(shown\n ? { \"aria-hidden\": true }\n : {\n role: \"group\",\n \"aria-label\": label,\n \"aria-roledescription\": labels?.drawArea ?? \"drawing area\",\n \"aria-describedby\": describedBy,\n tabIndex: 0,\n onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => {\n if (event.key !== \"Enter\" && event.key !== \" \") return;\n event.preventDefault();\n place();\n },\n })}\n />\n );\n if (!shown) return area || null;\n return (\n <>\n {area}\n {/* biome-ignore lint/a11y/useSemanticElements: an object frame, not a group of form controls (fieldset) */}\n <div\n ref={frame}\n role=\"group\"\n aria-label={label}\n aria-roledescription={labels?.roleDescription ?? \"selection\"}\n aria-describedby={describedBy}\n // biome-ignore lint/a11y/noNoninteractiveTabindex: the frame is the keyboard handle for moving the object\n tabIndex={0}\n className={className ? `cy-selection-frame ${className}` : \"cy-selection-frame\"}\n data-moving={live ? \"\" : undefined}\n style={\n {\n \"--_x\": `${shown.box.x * scale}px`,\n \"--_y\": `${shown.box.y * scale}px`,\n \"--_w\": `${shown.box.width * scale}px`,\n \"--_h\": `${shown.box.height * scale}px`,\n \"--_r\": `${shown.rotate}deg`,\n ...style,\n } as CSSProperties\n }\n onKeyDown={onKeyDown}\n onKeyUp={onKeyUp}\n >\n {resizable &&\n HANDLES.map((name) => (\n <span\n key={name}\n data-handle={name}\n className=\"cy-selection-frame-handle cy-reset\"\n aria-hidden=\"true\"\n />\n ))}\n {rotatable && (\n <span\n data-handle=\"rotate\"\n className=\"cy-selection-frame-handle cy-selection-frame-rotate cy-reset\"\n aria-hidden=\"true\"\n />\n )}\n </div>\n </>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"SelectionFrame.js","names":["bindPointer","_Fragment","N","useDrag","angleFrom","contain","moveBy","resizeBy","resizeByKey","useEffect","useRef","useState","Fragment$1","jsx","jsxs","HANDLES","ARROWS","SelectionFrame","label","box","rotate","scale","draw","resizable","rotatable","keepAspect","minSize","bounds","step","largeStep","snap","onChange","onCommit","describedBy","labels","className","style","frame","surface","live","setLive","liveRef","props","limits","limitsRef","seen","latest","set","next","change","nextBox","nextRotate","p","start","snapped","commit","current","cancel","units","point","k","b","x","y","origin","a","drawn","_","cancelled","place","el","area","placed","focusFrame","begin","from","end","bound","session","delta","b0","r0","handle","event","name","r","deg","aspect","onKeyDown","by","dir","onKeyUp","shown"],"sources":["../../../src/components/SelectionFrame/SelectionFrame.tsx"],"sourcesContent":["import { bindPointer } from \"@arshad-shah/detent\";\nimport { type CSSProperties, type KeyboardEvent, useEffect, useRef, useState } from \"react\";\nimport { useDrag } from \"../../foundations/drag.js\";\nimport {\n angleFrom,\n contain,\n type FrameBox,\n type FrameHandle,\n type FrameLimits,\n moveBy,\n resizeBy,\n resizeByKey,\n} from \"./frame-math.js\";\n\nexport interface SelectionFrameTokens {\n /** Outline and handle colour. */\n color: string;\n /** Visible size of a handle. */\n handleSize: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n selectionFrame: SelectionFrameTokens;\n }\n}\n\nexport interface SelectionFrameLabels {\n /** How screen readers call the frame. Default: \"selection\". */\n roleDescription: string;\n /** With `draw` and no box: how screen readers call the empty area. Default: \"drawing area\". */\n drawArea: string;\n}\n\nexport interface SelectionFrameProps {\n /** Accessible name, e.g. \"Text box: Hello\". Describe the keys nearby with `aria-describedby`. */\n label: string;\n /** Where the object is, in your units (page points, canvas pixels). `null` before one is drawn (with `draw`). */\n box: FrameBox | null;\n /**\n * Draw a new box by dragging anywhere on the layer (a region select, a crop, a grid area). A press on the frame\n * still moves it. With no box yet, the layer is focusable and Enter places one in the middle for the keyboard.\n */\n draw?: boolean;\n /** Degrees, clockwise. */\n rotate?: number;\n /** CSS pixels per unit (the zoom). Default 1. */\n scale?: number;\n /** Show the eight resize handles; Alt+arrows resize too. */\n resizable?: boolean;\n /** Show the rotate handle; the [ and ] keys turn it by 15 degrees. */\n rotatable?: boolean;\n /** Keep the width-to-height ratio while resizing (Shift does it for one drag). */\n keepAspect?: boolean;\n /** Smallest width and height, in units. Default 1. */\n minSize?: number;\n /** Keep the object inside this area (units). */\n bounds?: { width: number; height: number } | undefined;\n /** Arrow keys move (and Alt+arrows resize) by this many units; Shift by `largeStep`. Defaults 1 and 10. */\n step?: number;\n /** Units the arrow keys move (and Alt+arrows resize) by with Shift held. Default 10. */\n largeStep?: number;\n /** Adjust every proposed box, e.g. snap to a grid or to other objects. */\n snap?: ((box: FrameBox) => FrameBox) | undefined;\n /** Every change while dragging or holding a key (a preview). */\n onChange?: ((box: FrameBox, rotate: number) => void) | undefined;\n /** The end of one change: pointer up, key up or Enter. One undo step. */\n onCommit: (box: FrameBox, rotate: number) => void;\n /** Ids of text that describes the frame, such as its keys. */\n \"aria-describedby\"?: string | undefined;\n /** Replace the built-in English text: how screen readers call the frame and the drawing area. */\n labels?: Partial<SelectionFrameLabels>;\n /** Added to the frame element, for layout. */\n className?: string;\n /** Layout only. Restyle through --cy-selection-frame-* tokens. */\n style?: CSSProperties;\n}\n\nconst HANDLES: FrameHandle[] = [\"nw\", \"n\", \"ne\", \"e\", \"se\", \"s\", \"sw\", \"w\"];\nconst ARROWS: Record<string, [number, number]> = {\n ArrowLeft: [-1, 0],\n ArrowRight: [1, 0],\n ArrowUp: [0, -1],\n ArrowDown: [0, 1],\n};\n\ninterface Live {\n box: FrameBox;\n rotate: number;\n /** Where the change began; `box` is null while the first box is being drawn. */\n start: { box: FrameBox | null; rotate: number };\n}\n\n/**\n * Move, resize and rotate one selected object: drag it or its handles (mouse, pen or touch, through detent), or focus\n * it and use the keys. You own the geometry: `onChange` previews, `onCommit` ends each change (one undo step), and\n * Escape cancels back to where it started. Place it in a positioned layer over your canvas or page.\n */\nexport function SelectionFrame({\n label,\n box,\n rotate = 0,\n scale = 1,\n draw = false,\n resizable = false,\n rotatable = false,\n keepAspect = false,\n minSize = 1,\n bounds,\n step = 1,\n largeStep = 10,\n snap,\n onChange,\n onCommit,\n \"aria-describedby\": describedBy,\n labels,\n className,\n style,\n}: SelectionFrameProps) {\n const frame = useRef<HTMLDivElement>(null);\n const surface = useRef<HTMLDivElement>(null);\n const [live, setLive] = useState<Live | null>(null);\n const liveRef = useRef<Live | null>(null);\n // Pointer handlers are bound once; they read the latest props through this ref.\n const props = useRef({ box, rotate, scale, keepAspect, snap, onChange, onCommit });\n props.current = { box, rotate, scale, keepAspect, snap, onChange, onCommit };\n const limits: FrameLimits = { minSize, bounds };\n const limitsRef = useRef(limits);\n limitsRef.current = limits;\n\n // The last committed geometry, until new props arrive: a second key press or drag can begin before the parent\n // re-renders with the first one's result.\n const seen = useRef({ box, rotate });\n const latest = useRef({ box, rotate });\n if (seen.current.box !== box || seen.current.rotate !== rotate) {\n seen.current = { box, rotate };\n latest.current = { box, rotate };\n }\n\n const set = (next: Live | null) => {\n liveRef.current = next;\n setLive(next);\n };\n const change = (nextBox: FrameBox, nextRotate: number) => {\n const p = props.current;\n const start = liveRef.current?.start ?? latest.current;\n const snapped = p.snap ? p.snap(nextBox) : nextBox;\n set({ box: snapped, rotate: nextRotate, start });\n p.onChange?.(snapped, nextRotate);\n };\n const commit = () => {\n const current = liveRef.current;\n if (!current) return;\n set(null);\n latest.current = { box: current.box, rotate: current.rotate };\n props.current.onCommit(current.box, current.rotate);\n };\n const cancel = () => {\n const current = liveRef.current;\n if (!current) return;\n set(null);\n if (current.start.box) props.current.onChange?.(current.start.box, current.start.rotate);\n };\n\n // Drawing a new box: from where the press landed to where the pointer is, in units, kept inside `bounds`.\n const units = (point: { x: number; y: number }) => {\n const r = (surface.current as HTMLDivElement).getBoundingClientRect();\n const k = props.current.scale;\n const b = limitsRef.current.bounds;\n const x = (point.x - r.left) / k;\n const y = (point.y - r.top) / k;\n return b ? { x: Math.min(Math.max(x, 0), b.width), y: Math.min(Math.max(y, 0), b.height) } : { x, y };\n };\n useDrag(surface, {\n distance: 3,\n onStart: () => {\n if (!draw) return false;\n set(null);\n },\n onMove: ({ origin, point }) => {\n const a = units(origin);\n const b = units(point);\n const drawn = {\n x: Math.min(a.x, b.x),\n y: Math.min(a.y, b.y),\n width: Math.abs(b.x - a.x),\n height: Math.abs(b.y - a.y),\n };\n const start = liveRef.current?.start ?? latest.current;\n const snapped = props.current.snap ? props.current.snap(drawn) : drawn;\n set({ box: snapped, rotate: 0, start });\n props.current.onChange?.(snapped, 0);\n },\n onEnd: (_, cancelled) => {\n const current = liveRef.current;\n // Too small to be a box (a slip of the pointer): drop it, like a cancel.\n if (cancelled || !current || current.box.width < minSize || current.box.height < minSize) cancel();\n else commit();\n },\n });\n /** The keyboard's way to draw: a box half the area's size, in its middle. */\n const place = () => {\n const el = surface.current as HTMLDivElement;\n const area = bounds ?? { width: el.clientWidth / scale, height: el.clientHeight / scale };\n const placed = contain(\n { x: area.width / 4, y: area.height / 4, width: area.width / 2, height: area.height / 2 },\n limits,\n );\n focusFrame.current = true;\n latest.current = { box: placed, rotate: 0 };\n onCommit(placed, 0);\n };\n const focusFrame = useRef(false);\n useEffect(() => {\n if (!focusFrame.current || !frame.current) return;\n focusFrame.current = false;\n frame.current.focus({ preventScroll: true });\n });\n\n // Pointer gestures through detent: the frame moves, each handle resizes or rotates. Escape cancels a drag.\n const hasFrame = (live ?? box) !== null;\n useEffect(() => {\n const el = frame.current;\n if (!el) return;\n const begin = () => {\n const from = latest.current as { box: FrameBox; rotate: number };\n set({ ...from, start: from });\n el.focus({ preventScroll: true });\n };\n const end = (_: unknown, cancelled: boolean) => (cancelled ? cancel() : commit());\n const bound = [\n bindPointer(el, {\n cancel: \"[data-handle]\",\n onStart: (session) => {\n if (session.event.button !== 0) return false;\n begin();\n },\n onMove: ({ delta }) => {\n const { box: b0, rotate: r0 } = (liveRef.current as Live).start as {\n box: FrameBox;\n rotate: number;\n };\n const k = props.current.scale;\n change(moveBy(b0, delta.x / k, delta.y / k, limitsRef.current), r0);\n },\n onEnd: end,\n }),\n ...[...el.querySelectorAll<HTMLElement>(\"[data-handle]\")].map((handle) =>\n bindPointer(handle, {\n distance: 0,\n delay: 0,\n onStart: () => begin(),\n onMove: ({ delta, point, event }) => {\n const { box: b0, rotate: r0 } = (liveRef.current as Live).start as {\n box: FrameBox;\n rotate: number;\n };\n const name = handle.dataset.handle as FrameHandle | \"rotate\";\n if (name === \"rotate\") {\n const r = el.getBoundingClientRect();\n const deg = angleFrom(r.left + r.width / 2, r.top + r.height / 2, point.x, point.y);\n change(b0, event.shiftKey ? Math.round(deg / 15) * 15 : deg);\n return;\n }\n const k = props.current.scale;\n const aspect = props.current.keepAspect || event.shiftKey;\n change(resizeBy(b0, name, delta.x / k, delta.y / k, r0, aspect, limitsRef.current), r0);\n },\n onEnd: end,\n }),\n ),\n ];\n return () => {\n for (const b of bound) b.destroy();\n };\n // Rebind when the set of handles changes.\n }, [resizable, rotatable, hasFrame]);\n\n const onKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {\n if (event.target !== event.currentTarget) return;\n const current = (liveRef.current ?? latest.current) as { box: FrameBox; rotate: number };\n const by = event.shiftKey ? largeStep : step;\n if (event.key === \"Escape\" || event.key === \"Enter\") {\n if (!liveRef.current) return;\n event.preventDefault();\n event.stopPropagation();\n if (event.key === \"Escape\") cancel();\n else commit();\n return;\n }\n if (rotatable && (event.key === \"[\" || event.key === \"]\")) {\n event.preventDefault();\n change(current.box, current.rotate + (event.key === \"]\" ? 15 : -15));\n return;\n }\n const dir = ARROWS[event.key];\n if (!dir) return;\n // Alt+Left would otherwise go back in history.\n event.preventDefault();\n if (event.altKey) {\n if (resizable)\n change(resizeByKey(current.box, event.key, by, current.rotate, keepAspect, limits), current.rotate);\n return;\n }\n change(moveBy(current.box, dir[0] * by, dir[1] * by, limits), current.rotate);\n };\n const onKeyUp = (event: KeyboardEvent<HTMLDivElement>) => {\n if (ARROWS[event.key] || event.key === \"[\" || event.key === \"]\") commit();\n };\n\n const shown = live ?? (box ? { box, rotate } : null);\n const area = draw && (\n <div\n ref={surface}\n className=\"cy-selection-frame-surface cy-reset\"\n {...(shown\n ? { \"aria-hidden\": true }\n : {\n role: \"group\",\n \"aria-label\": label,\n \"aria-roledescription\": labels?.drawArea ?? \"drawing area\",\n \"aria-describedby\": describedBy,\n tabIndex: 0,\n onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => {\n if (event.key !== \"Enter\" && event.key !== \" \") return;\n event.preventDefault();\n place();\n },\n })}\n />\n );\n if (!shown) return area || null;\n return (\n <>\n {area}\n {/* biome-ignore lint/a11y/useSemanticElements: an object frame, not a group of form controls (fieldset) */}\n <div\n ref={frame}\n role=\"group\"\n aria-label={label}\n aria-roledescription={labels?.roleDescription ?? \"selection\"}\n aria-describedby={describedBy}\n // biome-ignore lint/a11y/noNoninteractiveTabindex: the frame is the keyboard handle for moving the object\n tabIndex={0}\n className={className ? `cy-selection-frame ${className}` : \"cy-selection-frame\"}\n data-moving={live ? \"\" : undefined}\n style={\n {\n \"--_x\": `${shown.box.x * scale}px`,\n \"--_y\": `${shown.box.y * scale}px`,\n \"--_w\": `${shown.box.width * scale}px`,\n \"--_h\": `${shown.box.height * scale}px`,\n \"--_r\": `${shown.rotate}deg`,\n ...style,\n } as CSSProperties\n }\n onKeyDown={onKeyDown}\n onKeyUp={onKeyUp}\n >\n {resizable &&\n HANDLES.map((name) => (\n <span\n key={name}\n data-handle={name}\n className=\"cy-selection-frame-handle cy-reset\"\n aria-hidden=\"true\"\n />\n ))}\n {rotatable && (\n <span\n data-handle=\"rotate\"\n className=\"cy-selection-frame-handle cy-selection-frame-rotate cy-reset\"\n aria-hidden=\"true\"\n />\n )}\n </div>\n </>\n );\n}\n"],"mappings":"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"}
@@ -8,6 +8,10 @@ export interface SideNavTokens {
8
8
  railWidth: string;
9
9
  /** Corner radius of item highlights. */
10
10
  radius: string;
11
+ /** Diameter of the round action button in the bar. */
12
+ actionSize: string;
13
+ /** How far the action button rises above the bar's row. */
14
+ actionLift: string;
11
15
  }
12
16
  declare module "../../tokens/schema.js" {
13
17
  interface ComponentTokens {
@@ -31,18 +35,47 @@ export interface NavSection {
31
35
  label: string;
32
36
  items: NavItem[];
33
37
  }
34
- export type NavEntry = NavItem | NavSection;
38
+ /**
39
+ * A primary action among the items, such as "Add": a button, not a place. It is never the current page (even when
40
+ * its `id` equals `current`), does not call `onNavigate`, and belongs at the top level, not in a section or group.
41
+ * In a bar it is a raised round accent button showing only the icon; in the column, a filled accent button with the
42
+ * icon and label; in the collapsed rail, a filled icon button. Give a navigation one at most.
43
+ */
44
+ export interface NavAction {
45
+ /** Marks the entry as an action instead of a destination. */
46
+ kind: "action";
47
+ /** Unique among the entries. */
48
+ id: string;
49
+ /** The button's accessible name; its visible text in the column, a tooltip in the bar and the rail. */
50
+ label: string;
51
+ /** The Facet icon shown in the button. */
52
+ icon: IconData;
53
+ /** Called when the action is pressed. */
54
+ onClick: (event: MouseEvent<HTMLElement>) => void;
55
+ /** The button cannot be pressed. */
56
+ disabled?: boolean;
57
+ }
58
+ export type NavEntry = NavItem | NavSection | NavAction;
35
59
  /** What `renderLink` receives: spread it onto your router's link component. */
36
60
  export interface NavLinkProps {
61
+ /** The item's `href`. */
37
62
  href: string;
63
+ /** The item's styling; keep it on the link. */
38
64
  className: string;
65
+ /** Set to "page" on the current item. */
39
66
  "aria-current"?: "page";
67
+ /** Calls `onNavigate` with the item's id; keep it on the link. */
40
68
  onClick: (event: MouseEvent<HTMLElement>) => void;
69
+ /** The item's icon, label and badge. */
41
70
  children: ReactNode;
42
71
  }
43
72
  export interface SideNavProps {
44
73
  /** Accessible name of the navigation landmark, e.g. "Main". */
45
74
  label: string;
75
+ /**
76
+ * Items and sections (`{ label, items }`), in order. One entry may be a primary action
77
+ * (`{ kind: "action", id, label, icon, onClick }`): a button that sits where it is placed.
78
+ */
46
79
  items: NavEntry[];
47
80
  /** `id` of the page being shown: marked `aria-current="page"`; groups holding it start expanded. */
48
81
  current?: string | undefined;
@@ -55,6 +88,7 @@ export interface SideNavProps {
55
88
  * open inside the rail: choosing one calls `onCollapsedChange(false)` so you can widen the navigation.
56
89
  */
57
90
  collapsed?: boolean;
91
+ /** Called with `false` when a group is chosen in the collapsed rail. */
58
92
  onCollapsedChange?: (collapsed: boolean) => void;
59
93
  /** Group ids expanded at first (groups holding `current` always are). */
60
94
  defaultExpanded?: string[];
@@ -64,7 +98,9 @@ export interface SideNavProps {
64
98
  * with its id (a bar has no room to open it). Give a bar three to five items, each with an icon.
65
99
  */
66
100
  layout?: "column" | "bar";
101
+ /** Height and text size of the items. Default "md". */
67
102
  size?: Size;
103
+ /** Added to the root element, for layout. */
68
104
  className?: string;
69
105
  /** Layout only. Restyle through --cy-side-nav-* tokens. */
70
106
  style?: CSSProperties;