@arshad-shah/cynosure 0.2.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 (272) hide show
  1. package/README.md +3 -3
  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.map +1 -1
  156. package/dist/components/Select/Select.d.ts +18 -1
  157. package/dist/components/Select/Select.js +97 -88
  158. package/dist/components/Select/Select.js.map +1 -1
  159. package/dist/components/Select/index.d.ts +1 -0
  160. package/dist/components/SelectionFrame/SelectionFrame.d.ts +6 -0
  161. package/dist/components/SelectionFrame/SelectionFrame.js.map +1 -1
  162. package/dist/components/SideNav/SideNav.d.ts +37 -1
  163. package/dist/components/SideNav/SideNav.js +100 -73
  164. package/dist/components/SideNav/SideNav.js.map +1 -1
  165. package/dist/components/SideNav/index.d.ts +1 -1
  166. package/dist/components/SignaturePad/SignaturePad.d.ts +3 -0
  167. package/dist/components/SignaturePad/SignaturePad.js.map +1 -1
  168. package/dist/components/Skeleton/Skeleton.d.ts +1 -0
  169. package/dist/components/Skeleton/Skeleton.js.map +1 -1
  170. package/dist/components/Slider/Slider.d.ts +11 -0
  171. package/dist/components/Slider/Slider.js +6 -6
  172. package/dist/components/Slider/Slider.js.map +1 -1
  173. package/dist/components/SortableList/SortableList.d.ts +6 -0
  174. package/dist/components/SortableList/SortableList.js.map +1 -1
  175. package/dist/components/SplitPane/SplitPane.d.ts +5 -0
  176. package/dist/components/SplitPane/SplitPane.js +4 -4
  177. package/dist/components/SplitPane/SplitPane.js.map +1 -1
  178. package/dist/components/Stack/Stack.d.ts +7 -3
  179. package/dist/components/Stack/Stack.js +18 -12
  180. package/dist/components/Stack/Stack.js.map +1 -1
  181. package/dist/components/Stack/index.d.ts +1 -0
  182. package/dist/components/Stack/space.d.ts +18 -0
  183. package/dist/components/Stack/space.js +12 -0
  184. package/dist/components/Stack/space.js.map +1 -0
  185. package/dist/components/Steps/Steps.d.ts +4 -0
  186. package/dist/components/Steps/Steps.js.map +1 -1
  187. package/dist/components/Table/Table.d.ts +12 -0
  188. package/dist/components/Table/Table.js.map +1 -1
  189. package/dist/components/Tabs/Tabs.d.ts +14 -0
  190. package/dist/components/Tabs/Tabs.js +4 -4
  191. package/dist/components/Tabs/Tabs.js.map +1 -1
  192. package/dist/components/TagInput/TagInput.d.ts +18 -0
  193. package/dist/components/TagInput/TagInput.js +5 -5
  194. package/dist/components/TagInput/TagInput.js.map +1 -1
  195. package/dist/components/Text/Text.d.ts +72 -0
  196. package/dist/components/Text/Text.js +30 -0
  197. package/dist/components/Text/Text.js.map +1 -0
  198. package/dist/components/Text/index.d.ts +1 -0
  199. package/dist/components/TextArea/TextArea.d.ts +10 -0
  200. package/dist/components/TextArea/TextArea.js +4 -4
  201. package/dist/components/TextArea/TextArea.js.map +1 -1
  202. package/dist/components/TextField/TextField.d.ts +13 -0
  203. package/dist/components/TextField/TextField.js +4 -4
  204. package/dist/components/TextField/TextField.js.map +1 -1
  205. package/dist/components/ThemeToggle/ThemeToggle.d.ts +4 -0
  206. package/dist/components/ThemeToggle/ThemeToggle.js.map +1 -1
  207. package/dist/components/TimeField/TimeField.d.ts +62 -8
  208. package/dist/components/TimeField/TimeField.js +308 -72
  209. package/dist/components/TimeField/TimeField.js.map +1 -1
  210. package/dist/components/Toast/Toast.d.ts +25 -1
  211. package/dist/components/Toast/Toast.js +134 -125
  212. package/dist/components/Toast/Toast.js.map +1 -1
  213. package/dist/components/Toast/index.d.ts +1 -1
  214. package/dist/components/Toolbar/Toolbar.d.ts +3 -0
  215. package/dist/components/Toolbar/Toolbar.js.map +1 -1
  216. package/dist/components/Tooltip/Tooltip.d.ts +1 -0
  217. package/dist/components/Tooltip/Tooltip.js.map +1 -1
  218. package/dist/components/Tree/Tree.d.ts +8 -0
  219. package/dist/components/Tree/Tree.js.map +1 -1
  220. package/dist/components/VirtualList/VirtualList.d.ts +8 -0
  221. package/dist/components/VirtualList/VirtualList.js +4 -4
  222. package/dist/components/VirtualList/VirtualList.js.map +1 -1
  223. package/dist/components/ZoomControls/ZoomControls.d.ts +4 -0
  224. package/dist/components/ZoomControls/ZoomControls.js.map +1 -1
  225. package/dist/foundations/ChoiceBase/ChoiceBase.d.ts +1 -0
  226. package/dist/foundations/ChoiceBase/ChoiceBase.js.map +1 -1
  227. package/dist/foundations/HiddenValue/HiddenValue.d.ts +3 -0
  228. package/dist/foundations/HiddenValue/HiddenValue.js.map +1 -1
  229. package/dist/foundations/Icon/Icon.d.ts +3 -0
  230. package/dist/foundations/Icon/Icon.js.map +1 -1
  231. package/dist/foundations/image-outcome.d.ts +15 -0
  232. package/dist/foundations/image-outcome.js +39 -0
  233. package/dist/foundations/image-outcome.js.map +1 -0
  234. package/dist/foundations/option-icon.d.ts +26 -0
  235. package/dist/foundations/option-icon.js +16 -0
  236. package/dist/foundations/option-icon.js.map +1 -0
  237. package/dist/icons/index.d.ts +1 -0
  238. package/dist/icons/index.js +476 -474
  239. package/dist/icons/keywords.d.ts +249 -0
  240. package/dist/icons/keywords.js +1728 -0
  241. package/dist/icons/keywords.js.map +1 -0
  242. package/dist/index.d.ts +20 -9
  243. package/dist/index.js +240 -213
  244. package/dist/styles/aspect-ratio.css +1 -0
  245. package/dist/styles/avatar.css +1 -0
  246. package/dist/styles/breadcrumbs.css +1 -0
  247. package/dist/styles/calendar.css +1 -1
  248. package/dist/styles/card.css +1 -1
  249. package/dist/styles/checkbox.css +1 -1
  250. package/dist/styles/checklist.css +1 -0
  251. package/dist/styles/container.css +1 -0
  252. package/dist/styles/divider.css +1 -0
  253. package/dist/styles/generated-css.d.ts +1 -1
  254. package/dist/styles/generated-css.js +1 -1
  255. package/dist/styles/generated-css.js.map +1 -1
  256. package/dist/styles/grid.css +1 -1
  257. package/dist/styles/heading.css +1 -0
  258. package/dist/styles/image.css +1 -0
  259. package/dist/styles/menu.css +1 -1
  260. package/dist/styles/page-header.css +1 -0
  261. package/dist/styles/pagination.css +1 -0
  262. package/dist/styles/side-nav.css +1 -1
  263. package/dist/styles/stack.css +1 -1
  264. package/dist/styles/text.css +1 -0
  265. package/dist/styles/time-field.css +1 -1
  266. package/dist/styles/toast.css +1 -1
  267. package/dist/styles.css +1 -1
  268. package/dist/theme/CynosureTheme.d.ts +4 -0
  269. package/dist/theme/CynosureTheme.js.map +1 -1
  270. package/dist/tokens/to-css.js +12 -12
  271. package/dist/tokens/to-css.js.map +1 -1
  272. package/package.json +3 -3
@@ -1 +1 @@
1
- {"version":3,"file":"SideNav.js","names":["_Fragment","ButtonBase","Icon","chevronDown","LinkBase","Tooltip","useEffect","useId","useState","Fragment$1","jsx","jsxs","isSection","entry","ancestors","items","id","trail","item","found","defaultLink","props","SideNav","label","current","onNavigate","renderLink","collapsed","onCollapsedChange","defaultExpanded","layout","size","className","style","bar","all","expanded","setExpanded","path","open","g","toggle","group","next","content","control","isCurrent","o","onClick","event","list","entries","depth","listId","hidden","labelledBy","blocks","last","block","i"],"sources":["../../../src/components/SideNav/SideNav.tsx"],"sourcesContent":["import {\n type CSSProperties,\n type MouseEvent,\n type ReactElement,\n type ReactNode,\n useEffect,\n useId,\n useState,\n} from \"react\";\nimport { ButtonBase } from \"../../foundations/ButtonBase/ButtonBase.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { LinkBase } from \"../../foundations/LinkBase/LinkBase.js\";\nimport { chevronDown } from \"../../icons/chevron-down.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { Tooltip } from \"../Tooltip/Tooltip.js\";\n\nexport interface SideNavTokens {\n /** Width of the expanded navigation. */\n width: string;\n /** Width of the collapsed, icon-only rail. */\n railWidth: string;\n /** Corner radius of item highlights. */\n radius: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n sideNav: SideNavTokens;\n }\n}\n\nexport interface NavItem {\n id: string;\n label: string;\n /** A link. Without it the item is a button that calls `onNavigate` (or, with `items`, a group). */\n href?: string;\n icon?: IconData;\n /** A count or status after the label, e.g. a Badge. Read as part of the item's name. */\n badge?: ReactNode;\n /** Child items: the item becomes a group that expands and collapses. */\n items?: NavItem[];\n disabled?: boolean;\n}\n\nexport interface NavSection {\n /** Heading shown above the section's items. */\n label: string;\n items: NavItem[];\n}\n\nexport type NavEntry = NavItem | NavSection;\n\n/** What `renderLink` receives: spread it onto your router's link component. */\nexport interface NavLinkProps {\n href: string;\n className: string;\n \"aria-current\"?: \"page\";\n onClick: (event: MouseEvent<HTMLElement>) => void;\n children: ReactNode;\n}\n\nexport interface SideNavProps {\n /** Accessible name of the navigation landmark, e.g. \"Main\". */\n label: string;\n items: NavEntry[];\n /** `id` of the page being shown: marked `aria-current=\"page\"`; groups holding it start expanded. */\n current?: string | undefined;\n /** Called when an item is chosen (links too: call `event.preventDefault()` to route on the client). */\n onNavigate?: ((id: string, event: MouseEvent<HTMLElement>) => void) | undefined;\n /** Render links with your router: `(props) => <RouterLink to={props.href} {...props} />`. Default: a plain link. */\n renderLink?: (props: NavLinkProps) => ReactElement;\n /**\n * Icon-only rail; labels show in tooltips and stay the accessible names. Give top-level items icons. Groups do not\n * open inside the rail: choosing one calls `onCollapsedChange(false)` so you can widen the navigation.\n */\n collapsed?: boolean;\n onCollapsedChange?: (collapsed: boolean) => void;\n /** Group ids expanded at first (groups holding `current` always are). */\n defaultExpanded?: string[];\n /**\n * `column` (default): the vertical navigation. `bar`: one row of top-level items, icon over label, for a phone's\n * bottom tab bar (AppShell's `tabs`). Section headings are left out, and a group is one item that calls `onNavigate`\n * with its id (a bar has no room to open it). Give a bar three to five items, each with an icon.\n */\n layout?: \"column\" | \"bar\";\n size?: Size;\n className?: string;\n /** Layout only. Restyle through --cy-side-nav-* tokens. */\n style?: CSSProperties;\n}\n\nconst isSection = (entry: NavEntry): entry is NavSection => !(\"id\" in entry);\n\n/** Ids of the groups that lead to `id`. */\nfunction ancestors(items: NavItem[], id: string | undefined, trail: string[] = []): string[] | null {\n if (!id) return null;\n for (const item of items) {\n if (item.id === id) return trail;\n const found = item.items && ancestors(item.items, id, [...trail, item.id]);\n if (found) return found;\n }\n return null;\n}\n\nconst defaultLink = (props: NavLinkProps) => <LinkBase {...props} />;\n\n/** Vertical site or app navigation: links in sections, expandable groups, the current page marked, an icon rail. */\nexport function SideNav({\n label,\n items,\n current,\n onNavigate,\n renderLink = defaultLink,\n collapsed = false,\n onCollapsedChange,\n defaultExpanded = [],\n layout = \"column\",\n size = \"md\",\n className,\n style,\n}: SideNavProps) {\n const id = useId();\n const bar = layout === \"bar\";\n const all = items.flatMap((entry) => (isSection(entry) ? entry.items : [entry]));\n const [expanded, setExpanded] = useState(\n () => new Set([...defaultExpanded, ...(ancestors(all, current) ?? [])]),\n );\n const path = ancestors(all, current)?.join(\" \");\n // Navigating somewhere else opens the groups on the way to it (never closes any).\n useEffect(() => {\n if (!path) return;\n setExpanded((open) =>\n path.split(\" \").every((g) => open.has(g)) ? open : new Set([...open, ...path.split(\" \")]),\n );\n }, [path]);\n\n const toggle = (group: string) =>\n setExpanded((open) => {\n const next = new Set(open);\n if (!next.delete(group)) next.add(group);\n return next;\n });\n\n const content = (item: NavItem, group?: boolean) => (\n <>\n {item.icon && <Icon icon={item.icon} className=\"cy-side-nav-icon\" />}\n <span className=\"cy-side-nav-label cy-reset\">{item.label}</span>\n {item.badge != null && <span className=\"cy-side-nav-badge cy-reset\">{item.badge}</span>}\n {group && !bar && <Icon icon={chevronDown} className=\"cy-side-nav-chevron\" />}\n </>\n );\n\n const control = (item: NavItem): ReactElement<Record<string, unknown>> => {\n const isCurrent = item.id === current;\n if (item.items && !bar) {\n const open = expanded.has(item.id);\n return (\n <ButtonBase\n className=\"cy-side-nav-link cy-reset\"\n aria-expanded={collapsed ? undefined : open}\n aria-controls={collapsed ? undefined : `${id}-${item.id}`}\n aria-disabled={item.disabled || undefined}\n onClick={() => {\n if (item.disabled) return;\n if (collapsed) {\n // The rail has no room for children: ask for the full navigation with this group open.\n setExpanded((o) => new Set([...o, item.id]));\n onCollapsedChange?.(false);\n } else toggle(item.id);\n }}\n >\n {content(item, true)}\n </ButtonBase>\n );\n }\n const onClick = (event: MouseEvent<HTMLElement>) => {\n if (item.disabled) {\n event.preventDefault();\n return;\n }\n onNavigate?.(item.id, event);\n };\n if (item.href && !item.disabled)\n return renderLink({\n href: item.href,\n className: \"cy-side-nav-link cy-reset\",\n ...(isCurrent ? { \"aria-current\": \"page\" as const } : {}),\n onClick,\n children: content(item),\n }) as ReactElement<Record<string, unknown>>;\n return (\n <ButtonBase\n className=\"cy-side-nav-link cy-reset\"\n aria-current={isCurrent ? \"page\" : undefined}\n aria-disabled={item.disabled || undefined}\n onClick={onClick}\n >\n {content(item)}\n </ButtonBase>\n );\n };\n\n const list = (\n entries: NavItem[],\n depth: number,\n listId?: string,\n hidden?: boolean,\n labelledBy?: string,\n ) => (\n <ul\n className=\"cy-side-nav-list cy-reset\"\n id={listId}\n hidden={hidden}\n aria-labelledby={labelledBy}\n data-depth={depth}\n >\n {entries.map((item) => (\n <li key={item.id} className=\"cy-side-nav-item cy-reset\">\n {collapsed && !bar ? (\n <Tooltip content={item.label} placement=\"end\">\n {control(item)}\n </Tooltip>\n ) : (\n control(item)\n )}\n {item.items &&\n !collapsed &&\n !bar &&\n list(item.items, depth + 1, `${id}-${item.id}`, !expanded.has(item.id))}\n </li>\n ))}\n </ul>\n );\n\n // Consecutive plain items share one list; each section gets its own heading and list.\n const blocks: ({ section: NavSection } | { items: NavItem[] })[] = [];\n if (bar) blocks.push({ items: all });\n else\n for (const entry of items) {\n const last = blocks[blocks.length - 1];\n if (isSection(entry)) blocks.push({ section: entry });\n else if (last && \"items\" in last) last.items.push(entry);\n else blocks.push({ items: [entry] });\n }\n\n return (\n <nav\n className={className ? `cy-side-nav ${className}` : \"cy-side-nav\"}\n aria-label={label}\n data-size={size}\n data-collapsed={collapsed && !bar ? \"\" : undefined}\n data-layout={layout}\n style={style}\n >\n {blocks.map((block, i) =>\n \"section\" in block ? (\n <div key={`section-${block.section.label}`} className=\"cy-side-nav-section cy-reset\">\n <span className=\"cy-side-nav-heading cy-reset\" id={`${id}-s${i}`}>\n {block.section.label}\n </span>\n {list(block.section.items, 0, undefined, false, `${id}-s${i}`)}\n </div>\n ) : (\n <div key={i} className=\"cy-side-nav-section cy-reset\">\n {list(block.items, 0)}\n </div>\n ),\n )}\n </nav>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"SideNav.js","names":["_Fragment","ButtonBase","Icon","chevronDown","LinkBase","Button","Tooltip","IconButton","useEffect","useId","useState","Fragment$1","jsx","jsxs","isSection","entry","isAction","ancestors","items","id","trail","item","found","defaultLink","props","SideNav","label","current","onNavigate","renderLink","collapsed","onCollapsedChange","defaultExpanded","layout","size","className","style","bar","all","places","expanded","setExpanded","path","open","g","toggle","group","next","content","action","shared","control","isCurrent","o","onClick","event","list","entries","depth","listId","hidden","labelledBy","blocks","last","block","i"],"sources":["../../../src/components/SideNav/SideNav.tsx"],"sourcesContent":["import {\n type CSSProperties,\n type MouseEvent,\n type ReactElement,\n type ReactNode,\n useEffect,\n useId,\n useState,\n} from \"react\";\nimport { ButtonBase } from \"../../foundations/ButtonBase/ButtonBase.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { LinkBase } from \"../../foundations/LinkBase/LinkBase.js\";\nimport { chevronDown } from \"../../icons/chevron-down.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { Button } from \"../Button/Button.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\nimport { Tooltip } from \"../Tooltip/Tooltip.js\";\n\nexport interface SideNavTokens {\n /** Width of the expanded navigation. */\n width: string;\n /** Width of the collapsed, icon-only rail. */\n railWidth: string;\n /** Corner radius of item highlights. */\n radius: string;\n /** Diameter of the round action button in the bar. */\n actionSize: string;\n /** How far the action button rises above the bar's row. */\n actionLift: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n sideNav: SideNavTokens;\n }\n}\n\nexport interface NavItem {\n id: string;\n label: string;\n /** A link. Without it the item is a button that calls `onNavigate` (or, with `items`, a group). */\n href?: string;\n icon?: IconData;\n /** A count or status after the label, e.g. a Badge. Read as part of the item's name. */\n badge?: ReactNode;\n /** Child items: the item becomes a group that expands and collapses. */\n items?: NavItem[];\n disabled?: boolean;\n}\n\nexport interface NavSection {\n /** Heading shown above the section's items. */\n label: string;\n items: NavItem[];\n}\n\n/**\n * A primary action among the items, such as \"Add\": a button, not a place. It is never the current page (even when\n * its `id` equals `current`), does not call `onNavigate`, and belongs at the top level, not in a section or group.\n * In a bar it is a raised round accent button showing only the icon; in the column, a filled accent button with the\n * icon and label; in the collapsed rail, a filled icon button. Give a navigation one at most.\n */\nexport interface NavAction {\n /** Marks the entry as an action instead of a destination. */\n kind: \"action\";\n /** Unique among the entries. */\n id: string;\n /** The button's accessible name; its visible text in the column, a tooltip in the bar and the rail. */\n label: string;\n /** The Facet icon shown in the button. */\n icon: IconData;\n /** Called when the action is pressed. */\n onClick: (event: MouseEvent<HTMLElement>) => void;\n /** The button cannot be pressed. */\n disabled?: boolean;\n}\n\nexport type NavEntry = NavItem | NavSection | NavAction;\n\n/** What `renderLink` receives: spread it onto your router's link component. */\nexport interface NavLinkProps {\n /** The item's `href`. */\n href: string;\n /** The item's styling; keep it on the link. */\n className: string;\n /** Set to \"page\" on the current item. */\n \"aria-current\"?: \"page\";\n /** Calls `onNavigate` with the item's id; keep it on the link. */\n onClick: (event: MouseEvent<HTMLElement>) => void;\n /** The item's icon, label and badge. */\n children: ReactNode;\n}\n\nexport interface SideNavProps {\n /** Accessible name of the navigation landmark, e.g. \"Main\". */\n label: string;\n /**\n * Items and sections (`{ label, items }`), in order. One entry may be a primary action\n * (`{ kind: \"action\", id, label, icon, onClick }`): a button that sits where it is placed.\n */\n items: NavEntry[];\n /** `id` of the page being shown: marked `aria-current=\"page\"`; groups holding it start expanded. */\n current?: string | undefined;\n /** Called when an item is chosen (links too: call `event.preventDefault()` to route on the client). */\n onNavigate?: ((id: string, event: MouseEvent<HTMLElement>) => void) | undefined;\n /** Render links with your router: `(props) => <RouterLink to={props.href} {...props} />`. Default: a plain link. */\n renderLink?: (props: NavLinkProps) => ReactElement;\n /**\n * Icon-only rail; labels show in tooltips and stay the accessible names. Give top-level items icons. Groups do not\n * open inside the rail: choosing one calls `onCollapsedChange(false)` so you can widen the navigation.\n */\n collapsed?: boolean;\n /** Called with `false` when a group is chosen in the collapsed rail. */\n onCollapsedChange?: (collapsed: boolean) => void;\n /** Group ids expanded at first (groups holding `current` always are). */\n defaultExpanded?: string[];\n /**\n * `column` (default): the vertical navigation. `bar`: one row of top-level items, icon over label, for a phone's\n * bottom tab bar (AppShell's `tabs`). Section headings are left out, and a group is one item that calls `onNavigate`\n * with its id (a bar has no room to open it). Give a bar three to five items, each with an icon.\n */\n layout?: \"column\" | \"bar\";\n /** Height and text size of the items. Default \"md\". */\n size?: Size;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. Restyle through --cy-side-nav-* tokens. */\n style?: CSSProperties;\n}\n\nconst isSection = (entry: NavEntry): entry is NavSection => !(\"id\" in entry);\nconst isAction = (entry: NavItem | NavAction): entry is NavAction => \"kind\" in entry;\n\n/** Ids of the groups that lead to `id`. */\nfunction ancestors(items: NavItem[], id: string | undefined, trail: string[] = []): string[] | null {\n if (!id) return null;\n for (const item of items) {\n if (item.id === id) return trail;\n const found = item.items && ancestors(item.items, id, [...trail, item.id]);\n if (found) return found;\n }\n return null;\n}\n\nconst defaultLink = (props: NavLinkProps) => <LinkBase {...props} />;\n\n/** Vertical site or app navigation: links in sections, expandable groups, the current page marked, an icon rail. */\nexport function SideNav({\n label,\n items,\n current,\n onNavigate,\n renderLink = defaultLink,\n collapsed = false,\n onCollapsedChange,\n defaultExpanded = [],\n layout = \"column\",\n size = \"md\",\n className,\n style,\n}: SideNavProps) {\n const id = useId();\n const bar = layout === \"bar\";\n const all = items.flatMap((entry) => (isSection(entry) ? entry.items : [entry]));\n const places = all.filter((entry) => !isAction(entry)) as NavItem[];\n const [expanded, setExpanded] = useState(\n () => new Set([...defaultExpanded, ...(ancestors(places, current) ?? [])]),\n );\n const path = ancestors(places, current)?.join(\" \");\n // Navigating somewhere else opens the groups on the way to it (never closes any).\n useEffect(() => {\n if (!path) return;\n setExpanded((open) =>\n path.split(\" \").every((g) => open.has(g)) ? open : new Set([...open, ...path.split(\" \")]),\n );\n }, [path]);\n\n const toggle = (group: string) =>\n setExpanded((open) => {\n const next = new Set(open);\n if (!next.delete(group)) next.add(group);\n return next;\n });\n\n const content = (item: NavItem, group?: boolean) => (\n <>\n {item.icon && <Icon icon={item.icon} className=\"cy-side-nav-icon\" />}\n <span className=\"cy-side-nav-label cy-reset\">{item.label}</span>\n {item.badge != null && <span className=\"cy-side-nav-badge cy-reset\">{item.badge}</span>}\n {group && !bar && <Icon icon={chevronDown} className=\"cy-side-nav-chevron\" />}\n </>\n );\n\n // The primary action: Cynosure's own buttons, so it presses, focuses and names itself like any other button.\n const action = (item: NavAction) => {\n const shared = {\n className: \"cy-side-nav-action\",\n variant: \"solid\",\n tone: \"accent\",\n disabled: item.disabled,\n onClick: item.onClick,\n } as const;\n return bar || collapsed ? (\n <IconButton\n {...shared}\n icon={item.icon}\n label={item.label}\n size={bar ? \"lg\" : size}\n tooltipPlacement={bar ? \"top\" : \"end\"}\n />\n ) : (\n <Button {...shared} icon={item.icon} size={size} fullWidth>\n {item.label}\n </Button>\n );\n };\n\n const control = (item: NavItem): ReactElement<Record<string, unknown>> => {\n const isCurrent = item.id === current;\n if (item.items && !bar) {\n const open = expanded.has(item.id);\n return (\n <ButtonBase\n className=\"cy-side-nav-link cy-reset\"\n aria-expanded={collapsed ? undefined : open}\n aria-controls={collapsed ? undefined : `${id}-${item.id}`}\n aria-disabled={item.disabled || undefined}\n onClick={() => {\n if (item.disabled) return;\n if (collapsed) {\n // The rail has no room for children: ask for the full navigation with this group open.\n setExpanded((o) => new Set([...o, item.id]));\n onCollapsedChange?.(false);\n } else toggle(item.id);\n }}\n >\n {content(item, true)}\n </ButtonBase>\n );\n }\n const onClick = (event: MouseEvent<HTMLElement>) => {\n if (item.disabled) {\n event.preventDefault();\n return;\n }\n onNavigate?.(item.id, event);\n };\n if (item.href && !item.disabled)\n return renderLink({\n href: item.href,\n className: \"cy-side-nav-link cy-reset\",\n ...(isCurrent ? { \"aria-current\": \"page\" as const } : {}),\n onClick,\n children: content(item),\n }) as ReactElement<Record<string, unknown>>;\n return (\n <ButtonBase\n className=\"cy-side-nav-link cy-reset\"\n aria-current={isCurrent ? \"page\" : undefined}\n aria-disabled={item.disabled || undefined}\n onClick={onClick}\n >\n {content(item)}\n </ButtonBase>\n );\n };\n\n const list = (\n entries: (NavItem | NavAction)[],\n depth: number,\n listId?: string,\n hidden?: boolean,\n labelledBy?: string,\n ) => (\n <ul\n className=\"cy-side-nav-list cy-reset\"\n id={listId}\n hidden={hidden}\n aria-labelledby={labelledBy}\n data-depth={depth}\n >\n {entries.map((item) =>\n isAction(item) ? (\n <li key={item.id} className=\"cy-side-nav-item cy-reset\" data-action=\"\">\n {action(item)}\n </li>\n ) : (\n <li key={item.id} className=\"cy-side-nav-item cy-reset\">\n {collapsed && !bar ? (\n <Tooltip content={item.label} placement=\"end\">\n {control(item)}\n </Tooltip>\n ) : (\n control(item)\n )}\n {item.items &&\n !collapsed &&\n !bar &&\n list(item.items, depth + 1, `${id}-${item.id}`, !expanded.has(item.id))}\n </li>\n ),\n )}\n </ul>\n );\n\n // Consecutive plain items share one list; each section gets its own heading and list.\n const blocks: ({ section: NavSection } | { items: (NavItem | NavAction)[] })[] = [];\n if (bar) blocks.push({ items: all });\n else\n for (const entry of items) {\n const last = blocks[blocks.length - 1];\n if (isSection(entry)) blocks.push({ section: entry });\n else if (last && \"items\" in last) last.items.push(entry);\n else blocks.push({ items: [entry] });\n }\n\n return (\n <nav\n className={className ? `cy-side-nav ${className}` : \"cy-side-nav\"}\n aria-label={label}\n data-size={size}\n data-collapsed={collapsed && !bar ? \"\" : undefined}\n data-layout={layout}\n style={style}\n >\n {blocks.map((block, i) =>\n \"section\" in block ? (\n <div key={`section-${block.section.label}`} className=\"cy-side-nav-section cy-reset\">\n <span className=\"cy-side-nav-heading cy-reset\" id={`${id}-s${i}`}>\n {block.section.label}\n </span>\n {list(block.section.items, 0, undefined, false, `${id}-s${i}`)}\n </div>\n ) : (\n <div key={i} className=\"cy-side-nav-section cy-reset\">\n {list(block.items, 0)}\n </div>\n ),\n )}\n </nav>\n );\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- export { type NavEntry, type NavItem, type NavLinkProps, type NavSection, SideNav, type SideNavProps, type SideNavTokens, } from "./SideNav.js";
1
+ export { type NavAction, type NavEntry, type NavItem, type NavLinkProps, type NavSection, SideNav, type SideNavProps, type SideNavTokens, } from "./SideNav.js";
@@ -36,10 +36,13 @@ export interface SignaturePadProps {
36
36
  } | undefined;
37
37
  /** Fixed size in CSS pixels. Default: the full width, and the height token. */
38
38
  width?: number | undefined;
39
+ /** Fixed height in CSS pixels. Default: the height token. */
39
40
  height?: number | undefined;
41
+ /** Stops drawing; the strokes so far stay shown. */
40
42
  disabled?: boolean;
41
43
  /** Ids of text that explains the pad (e.g. "Or type your name instead"). */
42
44
  "aria-describedby"?: string | undefined;
45
+ /** Added to the root element, for layout. */
43
46
  className?: string;
44
47
  /** Layout only. Restyle through --cy-signature-pad-* tokens. */
45
48
  style?: CSSProperties;
@@ -1 +1 @@
1
- {"version":3,"file":"SignaturePad.js","names":["inkPath","inkPoint","useCallback","useEffect","useRef","useState","jsx","MIN_STEP","PALM_MS","SignaturePad","label","value","onChange","ink","weight","space","width","height","disabled","describedBy","className","style","canvas","liveRef","pointer","penSeen","live","setLive","committed","size","setSize","el","measure","s","observer","paint","dpr","ctx","stroke","sample","event","rect","scale","native","samples","out","e","prev","p","ours","notePen","finish"],"sources":["../../../src/components/SignaturePad/SignaturePad.tsx"],"sourcesContent":["import { type CSSProperties, type PointerEvent, useCallback, useEffect, useRef, useState } from \"react\";\nimport { type InkPoint, type InkStroke, type InkWeight, inkPath, inkPoint } from \"./ink.js\";\n\nexport interface SignaturePadTokens {\n /** Ink colour when no `ink` is given (follows light and dark modes). */\n ink: string;\n /** Background of the pad. */\n background: string;\n /** Height when no `height` is given. */\n height: string;\n /** Colour of the guide line people sign on. */\n guide: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n signaturePad: SignaturePadTokens;\n }\n}\n\nexport interface SignaturePadProps {\n /** Accessible name, e.g. \"Draw your signature\". */\n label: string;\n /** The strokes so far, in the pad's coordinate space. */\n value: InkStroke[];\n /** Called once per finished stroke with the new list. Undo and clear are yours (slice or empty the list). */\n onChange: (strokes: InkStroke[]) => void;\n /** Ink colour (any CSS colour). Default: the ink token, so it follows dark mode on screen. */\n ink?: string | undefined;\n /** Nib size. Default `medium`. */\n weight?: InkWeight;\n /**\n * The coordinate space strokes are recorded in. Without it strokes are in shown CSS pixels; with it a signature keeps\n * its shape and weight however big the pad is shown (phone width, text size, a resize while drawing).\n */\n space?: { width: number; height: number } | undefined;\n /** Fixed size in CSS pixels. Default: the full width, and the height token. */\n width?: number | undefined;\n height?: number | undefined;\n disabled?: boolean;\n /** Ids of text that explains the pad (e.g. \"Or type your name instead\"). */\n \"aria-describedby\"?: string | undefined;\n className?: string;\n /** Layout only. Restyle through --cy-signature-pad-* tokens. */\n style?: CSSProperties;\n}\n\n/** Samples closer than this (pad units) to the last one add nothing. */\nconst MIN_STEP = 0.75;\n/** Touches are ignored for this long after a pen was last seen: a resting palm. */\nconst PALM_MS = 3000;\n\n/**\n * A pad to draw a signature with a mouse, finger or pen. A pen's pressure and tilt shape the line; mouse and touch draw\n * a steady line. One pointer draws at a time, and a palm resting while a pen is in use is ignored. It draws, nothing\n * more: offer typing or uploading a signature beside it for people who cannot draw.\n */\nexport function SignaturePad({\n label,\n value,\n onChange,\n ink,\n weight = \"medium\",\n space,\n width,\n height,\n disabled = false,\n \"aria-describedby\": describedBy,\n className,\n style,\n}: SignaturePadProps) {\n const canvas = useRef<HTMLCanvasElement>(null);\n // Several pointer events can arrive between renders: the stroke in progress lives in a ref; state mirrors it.\n const liveRef = useRef<InkStroke | null>(null);\n const pointer = useRef<number | null>(null);\n const penSeen = useRef(Number.NEGATIVE_INFINITY);\n const [live, setLive] = useState<InkStroke | null>(null);\n // The latest list, updated the moment a stroke ends: a second stroke can finish before React re-renders.\n const committed = useRef(value);\n committed.current = value;\n const [size, setSize] = useState({ width: 0, height: 0 });\n\n useEffect(() => {\n const el = canvas.current as HTMLCanvasElement;\n const measure = () =>\n setSize((s) =>\n s.width === el.clientWidth && s.height === el.clientHeight\n ? s\n : { width: el.clientWidth, height: el.clientHeight },\n );\n measure();\n const observer = new ResizeObserver(measure);\n observer.observe(el);\n return () => observer.disconnect();\n }, []);\n\n const paint = useCallback(() => {\n const el = canvas.current as HTMLCanvasElement;\n const dpr = window.devicePixelRatio;\n el.width = Math.round(size.width * dpr);\n el.height = Math.round(size.height * dpr);\n const ctx = el.getContext(\"2d\") as CanvasRenderingContext2D;\n ctx.setTransform(dpr, 0, 0, dpr, 0, 0);\n if (space && size.width > 0) ctx.scale(size.width / space.width, size.height / space.height);\n ctx.fillStyle = ink ?? getComputedStyle(el).color;\n for (const stroke of live ? [...value, live] : value) {\n // Every stroke has at least its first sample, so it always has an outline.\n ctx.fill(new Path2D(inkPath(stroke, weight)));\n }\n }, [value, live, ink, weight, space, size]);\n useEffect(paint, [paint]);\n\n const sample = (event: PointerEvent<HTMLCanvasElement>, stroke: InkStroke): InkStroke => {\n const rect = event.currentTarget.getBoundingClientRect();\n const scale = space ? { x: space.width / rect.width, y: space.height / rect.height } : undefined;\n const native = event.nativeEvent;\n // Coalesced events keep a fast stroke smooth: the browser batches several samples into one event.\n const samples = native.getCoalescedEvents?.() ?? [];\n let out = stroke;\n for (const e of samples.length ? samples : [native]) {\n const prev: InkPoint | null = out[out.length - 1] ?? null;\n const p = inkPoint(e, rect, prev, scale);\n if (prev && Math.hypot(p.x - prev.x, p.y - prev.y) < MIN_STEP) continue;\n out = [...out, p];\n }\n return out;\n };\n\n const ours = (event: PointerEvent) => liveRef.current !== null && event.pointerId === pointer.current;\n const notePen = (event: PointerEvent) => {\n if (event.pointerType === \"pen\") penSeen.current = event.timeStamp;\n };\n const finish = (event: PointerEvent<HTMLCanvasElement>) => {\n notePen(event);\n if (!ours(event)) return;\n const stroke = liveRef.current as InkStroke;\n liveRef.current = null;\n pointer.current = null;\n setLive(null);\n committed.current = [...committed.current, stroke];\n onChange(committed.current);\n };\n\n return (\n <div\n className={className ? `cy-signature-pad ${className}` : \"cy-signature-pad\"}\n data-disabled={disabled ? \"\" : undefined}\n style={{ ...(width ? { inlineSize: width } : {}), ...(height ? { blockSize: height } : {}), ...style }}\n >\n <canvas\n ref={canvas}\n role=\"img\"\n aria-label={label}\n aria-describedby={describedBy}\n aria-disabled={disabled || undefined}\n className=\"cy-signature-pad-canvas cy-reset\"\n onPointerDown={(event) => {\n notePen(event);\n // One stroke at a time: a second finger or a resting palm does not take over.\n if (disabled || liveRef.current) return;\n // Only the tip (or the main mouse button) draws, not a pen's barrel button or eraser.\n if (event.pointerType !== \"touch\" && event.button !== 0) return;\n if (event.pointerType === \"touch\" && event.timeStamp - penSeen.current < PALM_MS) return;\n try {\n event.currentTarget.setPointerCapture(event.pointerId);\n } catch {\n // Synthetic events have no active pointer to capture.\n }\n pointer.current = event.pointerId;\n liveRef.current = sample(event, []);\n setLive(liveRef.current);\n }}\n onPointerMove={(event) => {\n notePen(event);\n if (!ours(event)) return;\n liveRef.current = sample(event, liveRef.current as InkStroke);\n setLive(liveRef.current);\n }}\n onPointerUp={finish}\n onPointerCancel={finish}\n // A long press opens the context menu on Windows and Android, which would cancel the stroke.\n onContextMenu={(event) => event.preventDefault()}\n />\n </div>\n );\n}\n"],"mappings":";;;;AAgDA,IAAMO,IAAW,MAEXC,IAAU;AAOhB,SAAgBC,EAAa,EAC3B,OAAAC,GACA,OAAAC,GACA,UAAAC,GACA,KAAAC,GACA,QAAAC,IAAS,UACT,OAAAC,GACA,OAAAC,GACA,QAAAC,GACA,UAAAC,IAAW,IACX,oBAAoBC,GACpB,WAAAC,GACA,OAAAC,EAAA,GACoB;AACpB,QAAMC,IAASlB,EAA0B,IAAI,GAEvCmB,IAAUnB,EAAyB,IAAI,GACvCoB,IAAUpB,EAAsB,IAAI,GACpCqB,IAAUrB,EAAO,OAAO,iBAAiB,GACzC,CAACsB,GAAMC,CAAA,IAAWtB,EAA2B,IAAI,GAEjDuB,IAAYxB,EAAOO,CAAK;AAC9B,EAAAiB,EAAU,UAAUjB;AACpB,QAAM,CAACkB,GAAMC,CAAA,IAAWzB,EAAS;AAAA,IAAE,OAAO;AAAA,IAAG,QAAQ;AAAA,EAAE,CAAC;AAExD,EAAAF,EAAA,MAAgB;AACd,UAAM4B,IAAKT,EAAO,SACZU,IAAA,MACJF,EAAA,CAASG,MACPA,EAAE,UAAUF,EAAG,eAAeE,EAAE,WAAWF,EAAG,eAC1CE,IACA;AAAA,MAAE,OAAOF,EAAG;AAAA,MAAa,QAAQA,EAAG;AAAA,IAAa,CACvD;AACF,IAAAC,EAAQ;AACR,UAAME,IAAW,IAAI,eAAeF,CAAO;AAC3C,WAAAE,EAAS,QAAQH,CAAE,GACnB,MAAaG,EAAS,WAAW;AAAA,EACnC,GAAG,CAAC,CAAC;AAEL,QAAMC,IAAQjC,EAAA,MAAkB;AAC9B,UAAM6B,IAAKT,EAAO,SACZc,IAAM,OAAO;AACnB,IAAAL,EAAG,QAAQ,KAAK,MAAMF,EAAK,QAAQO,CAAG,GACtCL,EAAG,SAAS,KAAK,MAAMF,EAAK,SAASO,CAAG;AACxC,UAAMC,IAAMN,EAAG,WAAW,IAAI;AAC9B,IAAAM,EAAI,aAAaD,GAAK,GAAG,GAAGA,GAAK,GAAG,CAAC,GACjCrB,KAASc,EAAK,QAAQ,KAAGQ,EAAI,MAAMR,EAAK,QAAQd,EAAM,OAAOc,EAAK,SAASd,EAAM,MAAM,GAC3FsB,EAAI,YAAYxB,KAAO,iBAAiBkB,CAAE,EAAE;AAC5C,eAAWO,KAAUZ,IAAO,CAAC,GAAGf,GAAOe,CAAI,IAAIf,EAE7C,CAAA0B,EAAI,KAAK,IAAI,OAAOrC,EAAQsC,GAAQxB,CAAM,CAAC,CAAC;AAAA,EAEhD,GAAG;AAAA,IAACH;AAAA,IAAOe;AAAA,IAAMb;AAAA,IAAKC;AAAA,IAAQC;AAAA,IAAOc;AAAA,EAAI,CAAC;AAC1C,EAAA1B,EAAUgC,GAAO,CAACA,CAAK,CAAC;AAExB,QAAMI,IAAA,CAAUC,GAAwCF,MAAiC;AACvF,UAAMG,IAAOD,EAAM,cAAc,sBAAsB,GACjDE,IAAQ3B,IAAQ;AAAA,MAAE,GAAGA,EAAM,QAAQ0B,EAAK;AAAA,MAAO,GAAG1B,EAAM,SAAS0B,EAAK;AAAA,IAAO,IAAI,QACjFE,IAASH,EAAM,aAEfI,IAAUD,EAAO,qBAAqB,KAAK,CAAC;AAClD,QAAIE,IAAMP;AACV,eAAWQ,KAAKF,EAAQ,SAASA,IAAU,CAACD,CAAM,GAAG;AACnD,YAAMI,IAAwBF,EAAIA,EAAI,SAAS,CAAA,KAAM,MAC/CG,IAAI/C,EAAS6C,GAAGL,GAAMM,GAAML,CAAK;AACvC,MAAIK,KAAQ,KAAK,MAAMC,EAAE,IAAID,EAAK,GAAGC,EAAE,IAAID,EAAK,CAAC,IAAIxC,MACrDsC,IAAM,CAAC,GAAGA,GAAKG,CAAC;AAAA,IAClB;AACA,WAAOH;AAAA,EACT,GAEMI,IAAA,CAAQT,MAAwBjB,EAAQ,YAAY,QAAQiB,EAAM,cAAchB,EAAQ,SACxF0B,IAAA,CAAWV,MAAwB;AACvC,IAAIA,EAAM,gBAAgB,UAAOf,EAAQ,UAAUe,EAAM;AAAA,EAC3D,GACMW,IAAA,CAAUX,MAA2C;AAEzD,QADAU,EAAQV,CAAK,GACT,CAACS,EAAKT,CAAK,EAAG;AAClB,UAAMF,IAASf,EAAQ;AACvB,IAAAA,EAAQ,UAAU,MAClBC,EAAQ,UAAU,MAClBG,EAAQ,IAAI,GACZC,EAAU,UAAU,CAAC,GAAGA,EAAU,SAASU,CAAM,GACjD1B,EAASgB,EAAU,OAAO;AAAA,EAC5B;AAEA,SACE,gBAAAtB,EAAC,OAAD;AAAA,IACE,WAAWc,IAAY,oBAAoBA,CAAA,KAAc;AAAA,IACzD,iBAAeF,IAAW,KAAK;AAAA,IAC/B,OAAO;AAAA,MAAE,GAAIF,IAAQ,EAAE,YAAYA,EAAM,IAAI,CAAC;AAAA,MAAI,GAAIC,IAAS,EAAE,WAAWA,EAAO,IAAI,CAAC;AAAA,MAAI,GAAGI;AAAA,IAAM;AAAA,IAErG,UAAA,gBAAAf,EAAC,UAAD;AAAA,MACE,KAAKgB;AAAA,MACL,MAAK;AAAA,MACL,cAAYZ;AAAA,MACZ,oBAAkBS;AAAA,MAClB,iBAAeD,KAAY;AAAA,MAC3B,WAAU;AAAA,MACV,eAAA,CAAgBsB,MAAU;AAGxB,YAFAU,EAAQV,CAAK,GAET,EAAAtB,KAAYK,EAAQ,YAEpB,EAAAiB,EAAM,gBAAgB,WAAWA,EAAM,WAAW,MAClD,EAAAA,EAAM,gBAAgB,WAAWA,EAAM,YAAYf,EAAQ,UAAUjB,IACzE;AAAA,cAAI;AACF,YAAAgC,EAAM,cAAc,kBAAkBA,EAAM,SAAS;AAAA,UACvD,QAAQ;AAAA,UAER;AACA,UAAAhB,EAAQ,UAAUgB,EAAM,WACxBjB,EAAQ,UAAUgB,EAAOC,GAAO,CAAC,CAAC,GAClCb,EAAQJ,EAAQ,OAAO;AAAA;AAAA,MACzB;AAAA,MACA,eAAA,CAAgBiB,MAAU;AAExB,QADAU,EAAQV,CAAK,GACRS,EAAKT,CAAK,MACfjB,EAAQ,UAAUgB,EAAOC,GAAOjB,EAAQ,OAAoB,GAC5DI,EAAQJ,EAAQ,OAAO;AAAA,MACzB;AAAA,MACA,aAAa4B;AAAA,MACb,iBAAiBA;AAAA,MAEjB,eAAA,CAAgBX,MAAUA,EAAM,eAAe;AAAA,IAChD,CAAA;AAAA,EACE,CAAA;AAET"}
1
+ {"version":3,"file":"SignaturePad.js","names":["inkPath","inkPoint","useCallback","useEffect","useRef","useState","jsx","MIN_STEP","PALM_MS","SignaturePad","label","value","onChange","ink","weight","space","width","height","disabled","describedBy","className","style","canvas","liveRef","pointer","penSeen","live","setLive","committed","size","setSize","el","measure","s","observer","paint","dpr","ctx","stroke","sample","event","rect","scale","native","samples","out","e","prev","p","ours","notePen","finish"],"sources":["../../../src/components/SignaturePad/SignaturePad.tsx"],"sourcesContent":["import { type CSSProperties, type PointerEvent, useCallback, useEffect, useRef, useState } from \"react\";\nimport { type InkPoint, type InkStroke, type InkWeight, inkPath, inkPoint } from \"./ink.js\";\n\nexport interface SignaturePadTokens {\n /** Ink colour when no `ink` is given (follows light and dark modes). */\n ink: string;\n /** Background of the pad. */\n background: string;\n /** Height when no `height` is given. */\n height: string;\n /** Colour of the guide line people sign on. */\n guide: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n signaturePad: SignaturePadTokens;\n }\n}\n\nexport interface SignaturePadProps {\n /** Accessible name, e.g. \"Draw your signature\". */\n label: string;\n /** The strokes so far, in the pad's coordinate space. */\n value: InkStroke[];\n /** Called once per finished stroke with the new list. Undo and clear are yours (slice or empty the list). */\n onChange: (strokes: InkStroke[]) => void;\n /** Ink colour (any CSS colour). Default: the ink token, so it follows dark mode on screen. */\n ink?: string | undefined;\n /** Nib size. Default `medium`. */\n weight?: InkWeight;\n /**\n * The coordinate space strokes are recorded in. Without it strokes are in shown CSS pixels; with it a signature keeps\n * its shape and weight however big the pad is shown (phone width, text size, a resize while drawing).\n */\n space?: { width: number; height: number } | undefined;\n /** Fixed size in CSS pixels. Default: the full width, and the height token. */\n width?: number | undefined;\n /** Fixed height in CSS pixels. Default: the height token. */\n height?: number | undefined;\n /** Stops drawing; the strokes so far stay shown. */\n disabled?: boolean;\n /** Ids of text that explains the pad (e.g. \"Or type your name instead\"). */\n \"aria-describedby\"?: string | undefined;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. Restyle through --cy-signature-pad-* tokens. */\n style?: CSSProperties;\n}\n\n/** Samples closer than this (pad units) to the last one add nothing. */\nconst MIN_STEP = 0.75;\n/** Touches are ignored for this long after a pen was last seen: a resting palm. */\nconst PALM_MS = 3000;\n\n/**\n * A pad to draw a signature with a mouse, finger or pen. A pen's pressure and tilt shape the line; mouse and touch draw\n * a steady line. One pointer draws at a time, and a palm resting while a pen is in use is ignored. It draws, nothing\n * more: offer typing or uploading a signature beside it for people who cannot draw.\n */\nexport function SignaturePad({\n label,\n value,\n onChange,\n ink,\n weight = \"medium\",\n space,\n width,\n height,\n disabled = false,\n \"aria-describedby\": describedBy,\n className,\n style,\n}: SignaturePadProps) {\n const canvas = useRef<HTMLCanvasElement>(null);\n // Several pointer events can arrive between renders: the stroke in progress lives in a ref; state mirrors it.\n const liveRef = useRef<InkStroke | null>(null);\n const pointer = useRef<number | null>(null);\n const penSeen = useRef(Number.NEGATIVE_INFINITY);\n const [live, setLive] = useState<InkStroke | null>(null);\n // The latest list, updated the moment a stroke ends: a second stroke can finish before React re-renders.\n const committed = useRef(value);\n committed.current = value;\n const [size, setSize] = useState({ width: 0, height: 0 });\n\n useEffect(() => {\n const el = canvas.current as HTMLCanvasElement;\n const measure = () =>\n setSize((s) =>\n s.width === el.clientWidth && s.height === el.clientHeight\n ? s\n : { width: el.clientWidth, height: el.clientHeight },\n );\n measure();\n const observer = new ResizeObserver(measure);\n observer.observe(el);\n return () => observer.disconnect();\n }, []);\n\n const paint = useCallback(() => {\n const el = canvas.current as HTMLCanvasElement;\n const dpr = window.devicePixelRatio;\n el.width = Math.round(size.width * dpr);\n el.height = Math.round(size.height * dpr);\n const ctx = el.getContext(\"2d\") as CanvasRenderingContext2D;\n ctx.setTransform(dpr, 0, 0, dpr, 0, 0);\n if (space && size.width > 0) ctx.scale(size.width / space.width, size.height / space.height);\n ctx.fillStyle = ink ?? getComputedStyle(el).color;\n for (const stroke of live ? [...value, live] : value) {\n // Every stroke has at least its first sample, so it always has an outline.\n ctx.fill(new Path2D(inkPath(stroke, weight)));\n }\n }, [value, live, ink, weight, space, size]);\n useEffect(paint, [paint]);\n\n const sample = (event: PointerEvent<HTMLCanvasElement>, stroke: InkStroke): InkStroke => {\n const rect = event.currentTarget.getBoundingClientRect();\n const scale = space ? { x: space.width / rect.width, y: space.height / rect.height } : undefined;\n const native = event.nativeEvent;\n // Coalesced events keep a fast stroke smooth: the browser batches several samples into one event.\n const samples = native.getCoalescedEvents?.() ?? [];\n let out = stroke;\n for (const e of samples.length ? samples : [native]) {\n const prev: InkPoint | null = out[out.length - 1] ?? null;\n const p = inkPoint(e, rect, prev, scale);\n if (prev && Math.hypot(p.x - prev.x, p.y - prev.y) < MIN_STEP) continue;\n out = [...out, p];\n }\n return out;\n };\n\n const ours = (event: PointerEvent) => liveRef.current !== null && event.pointerId === pointer.current;\n const notePen = (event: PointerEvent) => {\n if (event.pointerType === \"pen\") penSeen.current = event.timeStamp;\n };\n const finish = (event: PointerEvent<HTMLCanvasElement>) => {\n notePen(event);\n if (!ours(event)) return;\n const stroke = liveRef.current as InkStroke;\n liveRef.current = null;\n pointer.current = null;\n setLive(null);\n committed.current = [...committed.current, stroke];\n onChange(committed.current);\n };\n\n return (\n <div\n className={className ? `cy-signature-pad ${className}` : \"cy-signature-pad\"}\n data-disabled={disabled ? \"\" : undefined}\n style={{ ...(width ? { inlineSize: width } : {}), ...(height ? { blockSize: height } : {}), ...style }}\n >\n <canvas\n ref={canvas}\n role=\"img\"\n aria-label={label}\n aria-describedby={describedBy}\n aria-disabled={disabled || undefined}\n className=\"cy-signature-pad-canvas cy-reset\"\n onPointerDown={(event) => {\n notePen(event);\n // One stroke at a time: a second finger or a resting palm does not take over.\n if (disabled || liveRef.current) return;\n // Only the tip (or the main mouse button) draws, not a pen's barrel button or eraser.\n if (event.pointerType !== \"touch\" && event.button !== 0) return;\n if (event.pointerType === \"touch\" && event.timeStamp - penSeen.current < PALM_MS) return;\n try {\n event.currentTarget.setPointerCapture(event.pointerId);\n } catch {\n // Synthetic events have no active pointer to capture.\n }\n pointer.current = event.pointerId;\n liveRef.current = sample(event, []);\n setLive(liveRef.current);\n }}\n onPointerMove={(event) => {\n notePen(event);\n if (!ours(event)) return;\n liveRef.current = sample(event, liveRef.current as InkStroke);\n setLive(liveRef.current);\n }}\n onPointerUp={finish}\n onPointerCancel={finish}\n // A long press opens the context menu on Windows and Android, which would cancel the stroke.\n onContextMenu={(event) => event.preventDefault()}\n />\n </div>\n );\n}\n"],"mappings":";;;;AAmDA,IAAMO,IAAW,MAEXC,IAAU;AAOhB,SAAgBC,EAAa,EAC3B,OAAAC,GACA,OAAAC,GACA,UAAAC,GACA,KAAAC,GACA,QAAAC,IAAS,UACT,OAAAC,GACA,OAAAC,GACA,QAAAC,GACA,UAAAC,IAAW,IACX,oBAAoBC,GACpB,WAAAC,GACA,OAAAC,EAAA,GACoB;AACpB,QAAMC,IAASlB,EAA0B,IAAI,GAEvCmB,IAAUnB,EAAyB,IAAI,GACvCoB,IAAUpB,EAAsB,IAAI,GACpCqB,IAAUrB,EAAO,OAAO,iBAAiB,GACzC,CAACsB,GAAMC,CAAA,IAAWtB,EAA2B,IAAI,GAEjDuB,IAAYxB,EAAOO,CAAK;AAC9B,EAAAiB,EAAU,UAAUjB;AACpB,QAAM,CAACkB,GAAMC,CAAA,IAAWzB,EAAS;AAAA,IAAE,OAAO;AAAA,IAAG,QAAQ;AAAA,EAAE,CAAC;AAExD,EAAAF,EAAA,MAAgB;AACd,UAAM4B,IAAKT,EAAO,SACZU,IAAA,MACJF,EAAA,CAASG,MACPA,EAAE,UAAUF,EAAG,eAAeE,EAAE,WAAWF,EAAG,eAC1CE,IACA;AAAA,MAAE,OAAOF,EAAG;AAAA,MAAa,QAAQA,EAAG;AAAA,IAAa,CACvD;AACF,IAAAC,EAAQ;AACR,UAAME,IAAW,IAAI,eAAeF,CAAO;AAC3C,WAAAE,EAAS,QAAQH,CAAE,GACnB,MAAaG,EAAS,WAAW;AAAA,EACnC,GAAG,CAAC,CAAC;AAEL,QAAMC,IAAQjC,EAAA,MAAkB;AAC9B,UAAM6B,IAAKT,EAAO,SACZc,IAAM,OAAO;AACnB,IAAAL,EAAG,QAAQ,KAAK,MAAMF,EAAK,QAAQO,CAAG,GACtCL,EAAG,SAAS,KAAK,MAAMF,EAAK,SAASO,CAAG;AACxC,UAAMC,IAAMN,EAAG,WAAW,IAAI;AAC9B,IAAAM,EAAI,aAAaD,GAAK,GAAG,GAAGA,GAAK,GAAG,CAAC,GACjCrB,KAASc,EAAK,QAAQ,KAAGQ,EAAI,MAAMR,EAAK,QAAQd,EAAM,OAAOc,EAAK,SAASd,EAAM,MAAM,GAC3FsB,EAAI,YAAYxB,KAAO,iBAAiBkB,CAAE,EAAE;AAC5C,eAAWO,KAAUZ,IAAO,CAAC,GAAGf,GAAOe,CAAI,IAAIf,EAE7C,CAAA0B,EAAI,KAAK,IAAI,OAAOrC,EAAQsC,GAAQxB,CAAM,CAAC,CAAC;AAAA,EAEhD,GAAG;AAAA,IAACH;AAAA,IAAOe;AAAA,IAAMb;AAAA,IAAKC;AAAA,IAAQC;AAAA,IAAOc;AAAA,EAAI,CAAC;AAC1C,EAAA1B,EAAUgC,GAAO,CAACA,CAAK,CAAC;AAExB,QAAMI,IAAA,CAAUC,GAAwCF,MAAiC;AACvF,UAAMG,IAAOD,EAAM,cAAc,sBAAsB,GACjDE,IAAQ3B,IAAQ;AAAA,MAAE,GAAGA,EAAM,QAAQ0B,EAAK;AAAA,MAAO,GAAG1B,EAAM,SAAS0B,EAAK;AAAA,IAAO,IAAI,QACjFE,IAASH,EAAM,aAEfI,IAAUD,EAAO,qBAAqB,KAAK,CAAC;AAClD,QAAIE,IAAMP;AACV,eAAWQ,KAAKF,EAAQ,SAASA,IAAU,CAACD,CAAM,GAAG;AACnD,YAAMI,IAAwBF,EAAIA,EAAI,SAAS,CAAA,KAAM,MAC/CG,IAAI/C,EAAS6C,GAAGL,GAAMM,GAAML,CAAK;AACvC,MAAIK,KAAQ,KAAK,MAAMC,EAAE,IAAID,EAAK,GAAGC,EAAE,IAAID,EAAK,CAAC,IAAIxC,MACrDsC,IAAM,CAAC,GAAGA,GAAKG,CAAC;AAAA,IAClB;AACA,WAAOH;AAAA,EACT,GAEMI,IAAA,CAAQT,MAAwBjB,EAAQ,YAAY,QAAQiB,EAAM,cAAchB,EAAQ,SACxF0B,IAAA,CAAWV,MAAwB;AACvC,IAAIA,EAAM,gBAAgB,UAAOf,EAAQ,UAAUe,EAAM;AAAA,EAC3D,GACMW,IAAA,CAAUX,MAA2C;AAEzD,QADAU,EAAQV,CAAK,GACT,CAACS,EAAKT,CAAK,EAAG;AAClB,UAAMF,IAASf,EAAQ;AACvB,IAAAA,EAAQ,UAAU,MAClBC,EAAQ,UAAU,MAClBG,EAAQ,IAAI,GACZC,EAAU,UAAU,CAAC,GAAGA,EAAU,SAASU,CAAM,GACjD1B,EAASgB,EAAU,OAAO;AAAA,EAC5B;AAEA,SACE,gBAAAtB,EAAC,OAAD;AAAA,IACE,WAAWc,IAAY,oBAAoBA,CAAA,KAAc;AAAA,IACzD,iBAAeF,IAAW,KAAK;AAAA,IAC/B,OAAO;AAAA,MAAE,GAAIF,IAAQ,EAAE,YAAYA,EAAM,IAAI,CAAC;AAAA,MAAI,GAAIC,IAAS,EAAE,WAAWA,EAAO,IAAI,CAAC;AAAA,MAAI,GAAGI;AAAA,IAAM;AAAA,IAErG,UAAA,gBAAAf,EAAC,UAAD;AAAA,MACE,KAAKgB;AAAA,MACL,MAAK;AAAA,MACL,cAAYZ;AAAA,MACZ,oBAAkBS;AAAA,MAClB,iBAAeD,KAAY;AAAA,MAC3B,WAAU;AAAA,MACV,eAAA,CAAgBsB,MAAU;AAGxB,YAFAU,EAAQV,CAAK,GAET,EAAAtB,KAAYK,EAAQ,YAEpB,EAAAiB,EAAM,gBAAgB,WAAWA,EAAM,WAAW,MAClD,EAAAA,EAAM,gBAAgB,WAAWA,EAAM,YAAYf,EAAQ,UAAUjB,IACzE;AAAA,cAAI;AACF,YAAAgC,EAAM,cAAc,kBAAkBA,EAAM,SAAS;AAAA,UACvD,QAAQ;AAAA,UAER;AACA,UAAAhB,EAAQ,UAAUgB,EAAM,WACxBjB,EAAQ,UAAUgB,EAAOC,GAAO,CAAC,CAAC,GAClCb,EAAQJ,EAAQ,OAAO;AAAA;AAAA,MACzB;AAAA,MACA,eAAA,CAAgBiB,MAAU;AAExB,QADAU,EAAQV,CAAK,GACRS,EAAKT,CAAK,MACfjB,EAAQ,UAAUgB,EAAOC,GAAOjB,EAAQ,OAAoB,GAC5DI,EAAQJ,EAAQ,OAAO;AAAA,MACzB;AAAA,MACA,aAAa4B;AAAA,MACb,iBAAiBA;AAAA,MAEjB,eAAA,CAAgBX,MAAUA,EAAM,eAAe;AAAA,IAChD,CAAA;AAAA,EACE,CAAA;AAET"}
@@ -24,6 +24,7 @@ export interface SkeletonProps {
24
24
  width?: string | undefined;
25
25
  /** Any CSS length. Default: one line of text (block) or the circle's diameter (circle). */
26
26
  height?: string | undefined;
27
+ /** Added to the root element, for layout. */
27
28
  className?: string;
28
29
  /** Layout only. Restyle through --cy-skeleton-* tokens. */
29
30
  style?: CSSProperties;
@@ -1 +1 @@
1
- {"version":3,"file":"Skeleton.js","names":["jsx","Skeleton","shape","lines","size","width","height","className","style","count","_"],"sources":["../../../src/components/Skeleton/Skeleton.tsx"],"sourcesContent":["import type { CSSProperties } from \"react\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface SkeletonTokens {\n /** Placeholder fill. */\n color: string;\n /** The band that sweeps across while loading. */\n highlight: string;\n /** Corner radius of text and block shapes. */\n radius: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n skeleton: SkeletonTokens;\n }\n}\n\nexport interface SkeletonProps {\n /** `text`: lines the height of text at `size`. `block`: a box. `circle`: an avatar or icon. */\n shape?: \"text\" | \"block\" | \"circle\";\n /** Text shape only: how many lines. The last of several is shorter, like a paragraph. */\n lines?: number;\n /** Text size the lines stand in for (shared vocabulary: docs/conventions.md). */\n size?: Size;\n /** Any CSS length. Default: the full width (text, block) or the height (circle). */\n width?: string | undefined;\n /** Any CSS length. Default: one line of text (block) or the circle's diameter (circle). */\n height?: string | undefined;\n className?: string;\n /** Layout only. Restyle through --cy-skeleton-* tokens. */\n style?: CSSProperties;\n}\n\n/**\n * A placeholder in the shape of content that is still loading. It is hidden from assistive technology: mark the region\n * that owns it `aria-busy=\"true\"` while it loads.\n */\nexport function Skeleton({\n shape = \"text\",\n lines = 1,\n size = \"md\",\n width,\n height,\n className,\n style,\n}: SkeletonProps) {\n const count = shape === \"text\" ? Math.max(1, Math.floor(lines) || 1) : 1;\n return (\n <span\n className={className ? `cy-skeleton ${className}` : \"cy-skeleton\"}\n data-shape={shape}\n data-size={size}\n aria-hidden=\"true\"\n style={{ \"--_w\": width, \"--_h\": height, ...style } as CSSProperties}\n >\n {Array.from({ length: count }, (_, i) => (\n <span key={i} className=\"cy-skeleton-bone cy-reset\" />\n ))}\n </span>\n );\n}\n"],"mappings":";;AAsCA,SAAgBC,EAAS,EACvB,OAAAC,IAAQ,QACR,OAAAC,IAAQ,GACR,MAAAC,IAAO,MACP,OAAAC,GACA,QAAAC,GACA,WAAAC,GACA,OAAAC,EAAA,GACgB;AAChB,QAAMC,IAAQP,MAAU,SAAS,KAAK,IAAI,GAAG,KAAK,MAAMC,CAAK,KAAK,CAAC,IAAI;AACvE,SACE,gBAAAH,EAAC,QAAD;AAAA,IACE,WAAWO,IAAY,eAAeA,CAAA,KAAc;AAAA,IACpD,cAAYL;AAAA,IACZ,aAAWE;AAAA,IACX,eAAY;AAAA,IACZ,OAAO;AAAA,MAAE,QAAQC;AAAA,MAAO,QAAQC;AAAA,MAAQ,GAAGE;AAAA,IAAM;AAAA,IAEhD,UAAA,MAAM,KAAK,EAAE,QAAQC,EAAM,GAAA,CAAIC,GAAG,MACjC,gBAAAV,EAAC,QAAD,EAAc,WAAU,4BAA6B,GAA1C,CAA0C,CACtD;AAAA,EACG,CAAA;AAEV"}
1
+ {"version":3,"file":"Skeleton.js","names":["jsx","Skeleton","shape","lines","size","width","height","className","style","count","_"],"sources":["../../../src/components/Skeleton/Skeleton.tsx"],"sourcesContent":["import type { CSSProperties } from \"react\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface SkeletonTokens {\n /** Placeholder fill. */\n color: string;\n /** The band that sweeps across while loading. */\n highlight: string;\n /** Corner radius of text and block shapes. */\n radius: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n skeleton: SkeletonTokens;\n }\n}\n\nexport interface SkeletonProps {\n /** `text`: lines the height of text at `size`. `block`: a box. `circle`: an avatar or icon. */\n shape?: \"text\" | \"block\" | \"circle\";\n /** Text shape only: how many lines. The last of several is shorter, like a paragraph. */\n lines?: number;\n /** Text size the lines stand in for (shared vocabulary: docs/conventions.md). */\n size?: Size;\n /** Any CSS length. Default: the full width (text, block) or the height (circle). */\n width?: string | undefined;\n /** Any CSS length. Default: one line of text (block) or the circle's diameter (circle). */\n height?: string | undefined;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. Restyle through --cy-skeleton-* tokens. */\n style?: CSSProperties;\n}\n\n/**\n * A placeholder in the shape of content that is still loading. It is hidden from assistive technology: mark the region\n * that owns it `aria-busy=\"true\"` while it loads.\n */\nexport function Skeleton({\n shape = \"text\",\n lines = 1,\n size = \"md\",\n width,\n height,\n className,\n style,\n}: SkeletonProps) {\n const count = shape === \"text\" ? Math.max(1, Math.floor(lines) || 1) : 1;\n return (\n <span\n className={className ? `cy-skeleton ${className}` : \"cy-skeleton\"}\n data-shape={shape}\n data-size={size}\n aria-hidden=\"true\"\n style={{ \"--_w\": width, \"--_h\": height, ...style } as CSSProperties}\n >\n {Array.from({ length: count }, (_, i) => (\n <span key={i} className=\"cy-skeleton-bone cy-reset\" />\n ))}\n </span>\n );\n}\n"],"mappings":";;AAuCA,SAAgBC,EAAS,EACvB,OAAAC,IAAQ,QACR,OAAAC,IAAQ,GACR,MAAAC,IAAO,MACP,OAAAC,GACA,QAAAC,GACA,WAAAC,GACA,OAAAC,EAAA,GACgB;AAChB,QAAMC,IAAQP,MAAU,SAAS,KAAK,IAAI,GAAG,KAAK,MAAMC,CAAK,KAAK,CAAC,IAAI;AACvE,SACE,gBAAAH,EAAC,QAAD;AAAA,IACE,WAAWO,IAAY,eAAeA,CAAA,KAAc;AAAA,IACpD,cAAYL;AAAA,IACZ,aAAWE;AAAA,IACX,eAAY;AAAA,IACZ,OAAO;AAAA,MAAE,QAAQC;AAAA,MAAO,QAAQC;AAAA,MAAQ,GAAGE;AAAA,IAAM;AAAA,IAEhD,UAAA,MAAM,KAAK,EAAE,QAAQC,EAAM,GAAA,CAAIC,GAAG,MACjC,gBAAAV,EAAC,QAAD,EAAc,WAAU,4BAA6B,GAA1C,CAA0C,CACtD;AAAA,EACG,CAAA;AAEV"}
@@ -33,20 +33,27 @@ export interface SliderMark {
33
33
  export interface SliderProps {
34
34
  /** Accessible name, shown above the slider unless `labelHidden`. */
35
35
  label: string;
36
+ /** Visually hide the label (it still names the slider). */
36
37
  labelHidden?: boolean;
37
38
  /** A number, `[from, to]` for a range, or more numbers for more thumbs (each stays between its neighbours). */
38
39
  value?: SliderValue;
40
+ /** Starting value when uncontrolled. Default: `min`. */
39
41
  defaultValue?: SliderValue;
40
42
  /** Every change while dragging or pressing keys. */
41
43
  onChange?: (value: SliderValue) => void;
42
44
  /** When a change is finished: pointer released, or after each key press. */
43
45
  onCommit?: (value: SliderValue) => void;
46
+ /** Lowest value. Default 0. */
44
47
  min?: number;
48
+ /** Highest value. Default 100. */
45
49
  max?: number;
50
+ /** Values snap to this step, and the arrow keys move by it. Default 1. */
46
51
  step?: number;
47
52
  /** Page Up and Page Down step (default a tenth of the range). */
48
53
  largeStep?: number;
54
+ /** `vertical` runs bottom to top. Default "horizontal". */
49
55
  orientation?: "horizontal" | "vertical";
56
+ /** Ticks on the track, with optional text under them. */
50
57
  marks?: SliderMark[];
51
58
  /**
52
59
  * Your own drawing of the track (a gradient, a histogram, a waveform), filling it under the thumbs. The accent fill
@@ -57,9 +64,13 @@ export interface SliderProps {
57
64
  showValue?: boolean;
58
65
  /** Form field name; a range submits two values under it. */
59
66
  name?: string;
67
+ /** Not focusable, cannot be changed and not submitted. */
60
68
  disabled?: boolean;
69
+ /** Track and thumb size. Default "md". */
61
70
  size?: Size;
71
+ /** Replace the built-in English text: the thumb names and the value text. */
62
72
  labels?: Partial<SliderLabels>;
73
+ /** Added to the root element, for layout. */
63
74
  className?: string;
64
75
  /** Layout only. Restyle through --cy-slider-* tokens. */
65
76
  style?: CSSProperties;
@@ -2,9 +2,9 @@
2
2
  import { useControllableState as re } from "../../foundations/controllable.js";
3
3
  import { isRtl as z } from "../../foundations/dir.js";
4
4
  import { clamp as B } from "../../foundations/math.js";
5
- import { useDrag as te } from "../../foundations/drag.js";
6
- import { HiddenValue as ae } from "../../foundations/HiddenValue/HiddenValue.js";
7
- import { stepKey as se } from "../../foundations/keys.js";
5
+ import { stepKey as te } from "../../foundations/keys.js";
6
+ import { useDrag as ae } from "../../foundations/drag.js";
7
+ import { HiddenValue as se } from "../../foundations/HiddenValue/HiddenValue.js";
8
8
  import { useCallback as le, useId as oe, useRef as R } from "react";
9
9
  import { jsx as n, jsxs as T } from "react/jsx-runtime";
10
10
  var ce = {
@@ -35,7 +35,7 @@ function pe({ label: l, labelHidden: v = !1, value: F, defaultValue: I, onChange
35
35
  let o = A ? (r.bottom - e.y) / r.height : (e.x - r.left) / r.width;
36
36
  return a && (o = 1 - o), s + B(o) * (c - s);
37
37
  };
38
- te(y, {
38
+ ae(y, {
39
39
  touchAction: "css",
40
40
  onStart: ({ point: e }) => {
41
41
  if (m) return !1;
@@ -52,7 +52,7 @@ function pe({ label: l, labelHidden: v = !1, value: F, defaultValue: I, onChange
52
52
  }
53
53
  });
54
54
  const Y = (e) => (r) => {
55
- const a = t[e], o = !A && z(r.currentTarget), u = se(r, {
55
+ const a = t[e], o = !A && z(r.currentTarget), u = te(r, {
56
56
  value: a,
57
57
  min: s,
58
58
  max: c,
@@ -132,7 +132,7 @@ function pe({ label: l, labelHidden: v = !1, value: F, defaultValue: I, onChange
132
132
  }, r))
133
133
  ]
134
134
  }),
135
- t.map((e, r) => /* @__PURE__ */ n(ae, {
135
+ t.map((e, r) => /* @__PURE__ */ n(se, {
136
136
  name: G,
137
137
  value: String(e),
138
138
  disabled: m,
@@ -1 +1 @@
1
- {"version":3,"file":"Slider.js","names":["useControllableState","isRtl","clamp","useDrag","HiddenValue","stepKey","useCallback","useId","useRef","jsx","jsxs","DEFAULT_LABELS","index","v","decimals","n","Slider","label","labelHidden","value","defaultValue","onChange","onCommit","min","max","step","largeStep","orientation","marks","trackContent","showValue","name","disabled","size","labels","className","style","id","text","initial","current","setCurrent","resetCurrent","range","values","track","thumbs","drag","big","vertical","snap","stepped","withThumb","next","set","commit","i","fromPoint","point","box","rtl","ratio","distances","nearest","tied","d","cancelled","onKeyDown","event","now","target","position","valueText","fill","thumbName","mark","el"],"sources":["../../../src/components/Slider/Slider.tsx"],"sourcesContent":["import { type CSSProperties, type KeyboardEvent, type ReactNode, useCallback, useId, useRef } from \"react\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { isRtl } from \"../../foundations/dir.js\";\nimport { useDrag } from \"../../foundations/drag.js\";\nimport { HiddenValue } from \"../../foundations/HiddenValue/HiddenValue.js\";\nimport { stepKey } from \"../../foundations/keys.js\";\nimport { clamp } from \"../../foundations/math.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface SliderTokens {\n trackSm: string;\n trackMd: string;\n trackLg: string;\n thumbSm: string;\n thumbMd: string;\n thumbLg: string;\n track: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n slider: SliderTokens;\n }\n}\n\n/** One number, or several: `[from, to]` for a range, or more (gradient stops), one thumb each. */\nexport type SliderValue = number | number[];\n\nexport interface SliderLabels {\n /** Names of the two thumbs of a range, added to the label (\"Price, minimum\"). */\n minimum: string;\n maximum: string;\n /** Names of the thumbs when there are more than two, added to the label. Default \"stop 3\". */\n thumb: (index: number, count: number) => string;\n /** Text for a value, shown with `showValue` and read by screen readers. Default: the number. */\n value: (value: number) => string;\n}\n\nexport interface SliderMark {\n value: number;\n /** Short text under the track; marks without one are ticks. */\n label?: string;\n}\n\nexport interface SliderProps {\n /** Accessible name, shown above the slider unless `labelHidden`. */\n label: string;\n labelHidden?: boolean;\n /** A number, `[from, to]` for a range, or more numbers for more thumbs (each stays between its neighbours). */\n value?: SliderValue;\n defaultValue?: SliderValue;\n /** Every change while dragging or pressing keys. */\n onChange?: (value: SliderValue) => void;\n /** When a change is finished: pointer released, or after each key press. */\n onCommit?: (value: SliderValue) => void;\n min?: number;\n max?: number;\n step?: number;\n /** Page Up and Page Down step (default a tenth of the range). */\n largeStep?: number;\n orientation?: \"horizontal\" | \"vertical\";\n marks?: SliderMark[];\n /**\n * Your own drawing of the track (a gradient, a histogram, a waveform), filling it under the thumbs. The accent fill\n * is not drawn then.\n */\n trackContent?: ReactNode;\n /** Show the current value (or range) at the end of the label row. */\n showValue?: boolean;\n /** Form field name; a range submits two values under it. */\n name?: string;\n disabled?: boolean;\n size?: Size;\n labels?: Partial<SliderLabels>;\n className?: string;\n /** Layout only. Restyle through --cy-slider-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: SliderLabels = {\n minimum: \"minimum\",\n maximum: \"maximum\",\n thumb: (index) => `stop ${index + 1}`,\n value: (v) => String(v),\n};\nconst decimals = (n: number) => (String(n).split(\".\")[1] ?? \"\").length;\n\n/** Picks a number (or a range) by dragging or with the keyboard: APG slider, with pointer, touch and forms. */\n/** The thumb being dragged, and the value to go back to if the drag is cancelled. */\ninterface Drag {\n index: number;\n from: SliderValue;\n}\n\nexport function Slider({\n label,\n labelHidden = false,\n value,\n defaultValue,\n onChange,\n onCommit,\n min = 0,\n max = 100,\n step = 1,\n largeStep,\n orientation = \"horizontal\",\n marks,\n trackContent,\n showValue = false,\n name,\n disabled = false,\n size = \"md\",\n labels,\n className,\n style,\n}: SliderProps) {\n const id = useId();\n const text = { ...DEFAULT_LABELS, ...labels };\n const initial = defaultValue ?? min;\n const [current, setCurrent, resetCurrent] = useControllableState<SliderValue>(value, initial, onChange);\n const range = Array.isArray(current);\n const values: number[] = range ? [...current] : [current];\n const track = useRef<HTMLDivElement>(null);\n const thumbs = useRef<(HTMLDivElement | null)[]>([]);\n const drag = useRef<Drag | null>(null);\n const big = largeStep ?? Math.max(step, (max - min) / 10);\n const vertical = orientation === \"vertical\";\n\n const snap = useCallback(\n (v: number) => {\n const stepped = min + Math.round((v - min) / step) * step;\n return Number(Math.min(Math.max(stepped, min), max).toFixed(decimals(step)));\n },\n [min, max, step],\n );\n /** New value with thumb `index` moved to `v`; thumbs stop at their neighbours instead of crossing. */\n const withThumb = (index: number, v: number): SliderValue => {\n if (!range) return snap(v);\n const next = [...values];\n next[index] = clamp(snap(v), values[index - 1] ?? min, values[index + 1] ?? max);\n return next;\n };\n const set = (next: SliderValue, commit: boolean) => {\n const same = Array.isArray(next) ? next.every((n, i) => n === values[i]) : next === values[0];\n if (!same) {\n setCurrent(next);\n }\n if (commit) onCommit?.(next);\n };\n\n const fromPoint = (point: { x: number; y: number }) => {\n const box = (track.current as HTMLDivElement).getBoundingClientRect();\n const rtl = !vertical && isRtl(track.current as HTMLDivElement);\n let ratio = vertical ? (box.bottom - point.y) / box.height : (point.x - box.left) / box.width;\n if (rtl) ratio = 1 - ratio;\n return min + clamp(ratio) * (max - min);\n };\n // Dragging through detent: the press moves the nearest thumb there, a drag follows, Escape puts it back.\n useDrag(track, {\n // The track's CSS keeps pan-y (pan-x when vertical), so a swipe across it still scrolls the page.\n touchAction: \"css\",\n onStart: ({ point }) => {\n if (disabled) return false;\n const v = fromPoint(point);\n // The nearest thumb takes the press; among thumbs on one spot, the one that can still move that way.\n const distances = values.map((n) => Math.abs(n - v));\n const nearest = Math.min(...distances);\n const tied = distances.flatMap((d, i) => (d === nearest ? [i] : []));\n const index = (v < (values[tied[0] as number] as number) ? tied[0] : tied[tied.length - 1]) as number;\n drag.current = { index, from: range ? [...values] : (values[0] as number) };\n thumbs.current[index]?.focus({ preventScroll: true });\n set(withThumb(index, v), false);\n },\n onMove: ({ point }) => set(withThumb((drag.current as Drag).index, fromPoint(point)), false),\n onEnd: ({ point }, cancelled) => {\n const d = drag.current as Drag;\n drag.current = null;\n set(cancelled ? d.from : withThumb(d.index, fromPoint(point)), true);\n },\n });\n\n const onKeyDown = (index: number) => (event: KeyboardEvent<HTMLDivElement>) => {\n const now = values[index] as number;\n const rtl = !vertical && isRtl(event.currentTarget);\n const target = stepKey(event, { value: now, min, max, step, big, rtl });\n if (target === undefined) return;\n event.preventDefault();\n set(withThumb(index, target), true);\n };\n\n const position = (v: number) => `${((v - min) / (max - min || 1)) * 100}%`;\n const valueText = range\n ? values.map(text.value).join(values.length === 2 ? \" – \" : \", \")\n : text.value(values[0] as number);\n const fill = range\n ? { \"--_from\": position(values[0] as number), \"--_to\": position(values[values.length - 1] as number) }\n : { \"--_from\": \"0%\", \"--_to\": position(values[0] as number) };\n const thumbName = (index: number) =>\n values.length === 2 ? (index === 0 ? text.minimum : text.maximum) : text.thumb(index, values.length);\n\n return (\n <div\n className={className ? `cy-slider ${className}` : \"cy-slider\"}\n // A range is a group of two sliders named by the label; a single slider is named directly.\n {...(range\n ? { role: \"group\", ...(labelHidden ? { \"aria-label\": label } : { \"aria-labelledby\": `${id}-label` }) }\n : {})}\n data-orientation={orientation}\n data-range={range || undefined}\n data-size={size}\n data-disabled={disabled || undefined}\n style={style}\n >\n {(!labelHidden || showValue) && (\n <div className=\"cy-slider-head cy-reset\">\n {!labelHidden && (\n <span id={`${id}-label`} className=\"cy-slider-label cy-reset\">\n {label}\n </span>\n )}\n {showValue && (\n <span className=\"cy-slider-value cy-reset\" aria-hidden=\"true\">\n {valueText}\n </span>\n )}\n </div>\n )}\n <div\n ref={track}\n className=\"cy-slider-track cy-reset\"\n style={fill as CSSProperties}\n data-custom={trackContent !== undefined ? \"\" : undefined}\n >\n {trackContent !== undefined ? (\n <div className=\"cy-slider-drawing cy-reset\" aria-hidden=\"true\">\n {trackContent}\n </div>\n ) : (\n <div className=\"cy-slider-fill cy-reset\" />\n )}\n {marks?.map((mark) => (\n <span\n key={mark.value}\n className=\"cy-slider-mark cy-reset\"\n aria-hidden=\"true\"\n style={{ \"--_pos\": position(mark.value) } as CSSProperties}\n data-label={mark.label ? \"\" : undefined}\n >\n {mark.label && <span className=\"cy-slider-mark-label cy-reset\">{mark.label}</span>}\n </span>\n ))}\n {values.map((v, index) => (\n <div\n key={index}\n ref={(el) => {\n thumbs.current[index] = el;\n }}\n role=\"slider\"\n tabIndex={disabled ? undefined : 0}\n className=\"cy-slider-thumb cy-reset\"\n aria-orientation={orientation}\n aria-valuemin={values[index - 1] ?? min}\n aria-valuemax={values[index + 1] ?? max}\n aria-valuenow={v}\n aria-valuetext={text.value(v)}\n aria-disabled={disabled || undefined}\n {...(range\n ? { \"aria-label\": `${label}, ${thumbName(index)}` }\n : labelHidden\n ? { \"aria-label\": label }\n : { \"aria-labelledby\": `${id}-label` })}\n style={{ \"--_pos\": position(v) } as CSSProperties}\n onKeyDown={disabled ? undefined : onKeyDown(index)}\n />\n ))}\n </div>\n {values.map((v, index) => (\n <HiddenValue\n key={index}\n name={name}\n value={String(v)}\n disabled={disabled}\n onReset={() => {\n resetCurrent(initial);\n }}\n />\n ))}\n </div>\n );\n}\n"],"mappings":";;;;;;;;;AA+EA,IAAMW,KAA+B;AAAA,EACnC,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAA,CAAQC,MAAU,QAAQA,IAAQ,CAAA;AAAA,EAClC,OAAA,CAAQC,MAAM,OAAOA,CAAC;AACxB,GACMC,KAAA,CAAYC,OAAe,OAAOA,CAAC,EAAE,MAAM,GAAG,EAAE,CAAA,KAAM,IAAI;AAShE,SAAgBC,GAAO,EACrB,OAAAC,GACA,aAAAC,IAAc,IACd,OAAAC,GACA,cAAAC,GACA,UAAAC,GACA,UAAAC,GACA,KAAAC,IAAM,GACN,KAAAC,IAAM,KACN,MAAAC,IAAO,GACP,WAAAC,GACA,aAAAC,IAAc,cACd,OAAAC,GACA,cAAAC,GACA,WAAAC,IAAY,IACZ,MAAAC,GACA,UAAAC,IAAW,IACX,MAAAC,IAAO,MACP,QAAAC,GACA,WAAAC,GACA,OAAAC,EAAA,GACc;AACd,QAAMC,IAAK9B,GAAM,GACX+B,IAAO;AAAA,IAAE,GAAG3B;AAAA,IAAgB,GAAGuB;AAAA,EAAO,GACtCK,IAAUnB,KAAgBG,GAC1B,CAACiB,GAASC,GAAYC,CAAA,IAAgB1C,GAAkCmB,GAAOoB,GAASlB,CAAQ,GAChGsB,IAAQ,MAAM,QAAQH,CAAO,GAC7BI,IAAmBD,IAAQ,CAAC,GAAGH,CAAO,IAAI,CAACA,CAAO,GAClDK,IAAQrC,EAAuB,IAAI,GACnCsC,IAAStC,EAAkC,CAAC,CAAC,GAC7CuC,IAAOvC,EAAoB,IAAI,GAC/BwC,IAAMtB,KAAa,KAAK,IAAID,IAAOD,IAAMD,KAAO,EAAE,GAClD0B,IAAWtB,MAAgB,YAE3BuB,IAAO5C,GAAA,CACVO,MAAc;AACb,UAAMsC,IAAU5B,IAAM,KAAK,OAAOV,IAAIU,KAAOE,CAAI,IAAIA;AACrD,WAAO,OAAO,KAAK,IAAI,KAAK,IAAI0B,GAAS5B,CAAG,GAAGC,CAAG,EAAE,QAAQV,GAASW,CAAI,CAAC,CAAC;AAAA,EAC7E,GACA;AAAA,IAACF;AAAA,IAAKC;AAAA,IAAKC;AAAA,EAAI,CACjB,GAEM2B,IAAA,CAAaxC,GAAeC,MAA2B;AAC3D,QAAI,CAAC8B,EAAO,QAAOO,EAAKrC,CAAC;AACzB,UAAMwC,IAAO,CAAC,GAAGT,CAAM;AACvB,WAAAS,EAAKzC,CAAA,IAASV,EAAMgD,EAAKrC,CAAC,GAAG+B,EAAOhC,IAAQ,CAAA,KAAMW,GAAKqB,EAAOhC,IAAQ,CAAA,KAAMY,CAAG,GACxE6B;AAAA,EACT,GACMC,IAAA,CAAOD,GAAmBE,MAAoB;AAElD,KADa,MAAM,QAAQF,CAAI,IAAIA,EAAK,MAAA,CAAOtC,GAAGyC,MAAMzC,MAAM6B,EAAOY,CAAA,CAAE,IAAIH,MAAST,EAAO,CAAA,MAEzFH,EAAWY,CAAI,GAEbE,KAAQjC,IAAW+B,CAAI;AAAA,EAC7B,GAEMI,IAAA,CAAaC,MAAoC;AACrD,UAAMC,IAAOd,EAAM,QAA2B,sBAAsB,GAC9De,IAAM,CAACX,KAAYhD,EAAM4C,EAAM,OAAyB;AAC9D,QAAIgB,IAAQZ,KAAYU,EAAI,SAASD,EAAM,KAAKC,EAAI,UAAUD,EAAM,IAAIC,EAAI,QAAQA,EAAI;AACxF,WAAIC,MAAKC,IAAQ,IAAIA,IACdtC,IAAMrB,EAAM2D,CAAK,KAAKrC,IAAMD;AAAA,EACrC;AAEA,EAAApB,GAAQ0C,GAAO;AAAA,IAEb,aAAa;AAAA,IACb,SAAA,CAAU,EAAE,OAAAa,EAAA,MAAY;AACtB,UAAI1B,EAAU,QAAO;AACrB,YAAMnB,IAAI4C,EAAUC,CAAK,GAEnBI,IAAYlB,EAAO,IAAA,CAAK7B,MAAM,KAAK,IAAIA,IAAIF,CAAC,CAAC,GAC7CkD,IAAU,KAAK,IAAI,GAAGD,CAAS,GAC/BE,IAAOF,EAAU,QAAA,CAASG,GAAGT,OAAOS,MAAMF,IAAU,CAACP,EAAC,IAAI,CAAC,CAAE,GAC7D5C,IAASC,IAAK+B,EAAOoB,EAAK,CAAA,CAAA,IAA2BA,EAAK,CAAA,IAAKA,EAAKA,EAAK,SAAS,CAAA;AACxF,MAAAjB,EAAK,UAAU;AAAA,QAAE,OAAAnC;AAAA,QAAO,MAAM+B,IAAQ,CAAC,GAAGC,CAAM,IAAKA,EAAO,CAAA;AAAA,MAAc,GAC1EE,EAAO,QAAQlC,CAAA,GAAQ,MAAM,EAAE,eAAe,GAAK,CAAC,GACpD0C,EAAIF,EAAUxC,GAAOC,CAAC,GAAG,EAAK;AAAA,IAChC;AAAA,IACA,QAAA,CAAS,EAAE,OAAA6C,EAAA,MAAYJ,EAAIF,EAAWL,EAAK,QAAiB,OAAOU,EAAUC,CAAK,CAAC,GAAG,EAAK;AAAA,IAC3F,OAAA,CAAQ,EAAE,OAAAA,EAAA,GAASQ,MAAc;AAC/B,YAAMD,IAAIlB,EAAK;AACf,MAAAA,EAAK,UAAU,MACfO,EAAIY,IAAYD,EAAE,OAAOb,EAAUa,EAAE,OAAOR,EAAUC,CAAK,CAAC,GAAG,EAAI;AAAA,IACrE;AAAA,EACF,CAAC;AAED,QAAMS,IAAA,CAAavD,MAAA,CAAmBwD,MAAyC;AAC7E,UAAMC,IAAMzB,EAAOhC,CAAA,GACbgD,IAAM,CAACX,KAAYhD,EAAMmE,EAAM,aAAa,GAC5CE,IAASjE,GAAQ+D,GAAO;AAAA,MAAE,OAAOC;AAAA,MAAK,KAAA9C;AAAA,MAAK,KAAAC;AAAA,MAAK,MAAAC;AAAA,MAAM,KAAAuB;AAAA,MAAK,KAAAY;AAAA,IAAI,CAAC;AACtE,IAAIU,MAAW,WACfF,EAAM,eAAe,GACrBd,EAAIF,EAAUxC,GAAO0D,CAAM,GAAG,EAAI;AAAA,EACpC,GAEMC,IAAA,CAAY1D,MAAc,IAAKA,IAAIU,MAAQC,IAAMD,KAAO,KAAM,GAAA,KAC9DiD,IAAY7B,IACdC,EAAO,IAAIN,EAAK,KAAK,EAAE,KAAKM,EAAO,WAAW,IAAI,QAAQ,IAAI,IAC9DN,EAAK,MAAMM,EAAO,CAAA,CAAY,GAC5B6B,IAAO9B,IACT;AAAA,IAAE,WAAW4B,EAAS3B,EAAO,CAAA,CAAY;AAAA,IAAG,SAAS2B,EAAS3B,EAAOA,EAAO,SAAS,CAAA,CAAY;AAAA,EAAE,IACnG;AAAA,IAAE,WAAW;AAAA,IAAM,SAAS2B,EAAS3B,EAAO,CAAA,CAAY;AAAA,EAAE,GACxD8B,IAAA,CAAa9D,MACjBgC,EAAO,WAAW,IAAKhC,MAAU,IAAI0B,EAAK,UAAUA,EAAK,UAAWA,EAAK,MAAM1B,GAAOgC,EAAO,MAAM;AAErG,SACE,gBAAAlC,EAAC,OAAD;AAAA,IACE,WAAWyB,IAAY,aAAaA,CAAA,KAAc;AAAA,IAElD,GAAKQ,IACD;AAAA,MAAE,MAAM;AAAA,MAAS,GAAIzB,IAAc,EAAE,cAAcD,EAAM,IAAI,EAAE,mBAAmB,GAAGoB,CAAA,SAAW;AAAA,IAAG,IACnG,CAAC;AAAA,IACL,oBAAkBV;AAAA,IAClB,cAAYgB,KAAS;AAAA,IACrB,aAAWV;AAAA,IACX,iBAAeD,KAAY;AAAA,IACpB,OAAAI;AAAA,IAVT,UAAA;AAAA,OAYI,CAAClB,KAAeY,MAChB,gBAAApB,EAAC,OAAD;AAAA,QAAK,WAAU;AAAA,QAAf,UAAA,CACG,CAACQ,KACA,gBAAAT,EAAC,QAAD;AAAA,UAAM,IAAI,GAAG4B,CAAA;AAAA,UAAY,WAAU;AAAA,UAChC,UAAApB;AAAA,QACG,CAAA,GAEPa,KACC,gBAAArB,EAAC,QAAD;AAAA,UAAM,WAAU;AAAA,UAA2B,eAAY;AAAA,UACpD,UAAA+D;AAAA,QACG,CAAA,CAEL;AAAA,M;A,MAEP,gBAAA9D,EAAC,OAAD;AAAA,QACE,KAAKmC;AAAA,QACL,WAAU;AAAA,QACV,OAAO4B;AAAA,QACP,eAAa5C,MAAiB,SAAY,KAAK;AAAA,QAJjD,UAAA;AAAA,UAMGA,MAAiB,SAChB,gBAAApB,EAAC,OAAD;AAAA,YAAK,WAAU;AAAA,YAA6B,eAAY;AAAA,YACrD,UAAAoB;AAAA,UACE,CAAA,IAEL,gBAAApB,EAAC,OAAD,EAAK,WAAU,0BAA2B,CAAA;AAAA,UAE3CmB,GAAO,IAAA,CAAK+C,MACX,gBAAAlE,EAAC,QAAD;AAAA,YAEE,WAAU;AAAA,YACV,eAAY;AAAA,YACZ,OAAO,EAAE,UAAU8D,EAASI,EAAK,KAAK,EAAE;AAAA,YACxC,cAAYA,EAAK,QAAQ,KAAK;AAAA,YAE7B,UAAAA,EAAK,SAAS,gBAAAlE,EAAC,QAAD;AAAA,cAAM,WAAU;AAAA,cAAiC,UAAAkE,EAAK;AAAA,YAAY,CAAA;AAAA,UAC7E,GAPCA,EAAK,KAON,CACP;AAAA,UACA/B,EAAO,IAAA,CAAK/B,GAAGD,MACd,gBAAAH,EAAC,OAAD;AAAA,YAEE,KAAA,CAAMmE,MAAO;AACX,cAAA9B,EAAO,QAAQlC,CAAA,IAASgE;AAAA,YAC1B;AAAA,YACA,MAAK;AAAA,YACL,UAAU5C,IAAW,SAAY;AAAA,YACjC,WAAU;AAAA,YACV,oBAAkBL;AAAA,YAClB,iBAAeiB,EAAOhC,IAAQ,CAAA,KAAMW;AAAA,YACpC,iBAAeqB,EAAOhC,IAAQ,CAAA,KAAMY;AAAA,YACpC,iBAAeX;AAAA,YACf,kBAAgByB,EAAK,MAAMzB,CAAC;AAAA,YAC5B,iBAAemB,KAAY;AAAA,YAC3B,GAAKW,IACD,EAAE,cAAc,GAAG1B,CAAA,KAAUyD,EAAU9D,CAAK,CAAA,GAAI,IAChDM,IACE,EAAE,cAAcD,EAAM,IACtB,EAAE,mBAAmB,GAAGoB,CAAA,SAAW;AAAA,YACzC,OAAO,EAAE,UAAUkC,EAAS1D,CAAC,EAAE;AAAA,YAC/B,WAAWmB,IAAW,SAAYmC,EAAUvD,CAAK;AAAA,UAClD,GApBMA,CAoBN,CACF;AAAA,QACE;AAAA,M;A,MACJgC,EAAO,IAAA,CAAK/B,GAAGD,MACd,gBAAAH,EAACL,IAAD;AAAA,QAEQ,MAAA2B;AAAA,QACN,OAAO,OAAOlB,CAAC;AAAA,QACL,UAAAmB;AAAA,QACV,SAAA,MAAe;AACb,UAAAU,EAAaH,CAAO;AAAA,QACtB;AAAA,MACD,GAPM3B,CAON,CACF;AAAA,IACE;AAAA,E;AAET"}
1
+ {"version":3,"file":"Slider.js","names":["useControllableState","isRtl","clamp","stepKey","useDrag","HiddenValue","useCallback","useId","useRef","jsx","jsxs","DEFAULT_LABELS","index","v","decimals","n","Slider","label","labelHidden","value","defaultValue","onChange","onCommit","min","max","step","largeStep","orientation","marks","trackContent","showValue","name","disabled","size","labels","className","style","id","text","initial","current","setCurrent","resetCurrent","range","values","track","thumbs","drag","big","vertical","snap","stepped","withThumb","next","set","commit","i","fromPoint","point","box","rtl","ratio","distances","nearest","tied","d","cancelled","onKeyDown","event","now","target","position","valueText","fill","thumbName","mark","el"],"sources":["../../../src/components/Slider/Slider.tsx"],"sourcesContent":["import { type CSSProperties, type KeyboardEvent, type ReactNode, useCallback, useId, useRef } from \"react\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { isRtl } from \"../../foundations/dir.js\";\nimport { useDrag } from \"../../foundations/drag.js\";\nimport { HiddenValue } from \"../../foundations/HiddenValue/HiddenValue.js\";\nimport { stepKey } from \"../../foundations/keys.js\";\nimport { clamp } from \"../../foundations/math.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface SliderTokens {\n trackSm: string;\n trackMd: string;\n trackLg: string;\n thumbSm: string;\n thumbMd: string;\n thumbLg: string;\n track: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n slider: SliderTokens;\n }\n}\n\n/** One number, or several: `[from, to]` for a range, or more (gradient stops), one thumb each. */\nexport type SliderValue = number | number[];\n\nexport interface SliderLabels {\n /** Names of the two thumbs of a range, added to the label (\"Price, minimum\"). */\n minimum: string;\n maximum: string;\n /** Names of the thumbs when there are more than two, added to the label. Default \"stop 3\". */\n thumb: (index: number, count: number) => string;\n /** Text for a value, shown with `showValue` and read by screen readers. Default: the number. */\n value: (value: number) => string;\n}\n\nexport interface SliderMark {\n value: number;\n /** Short text under the track; marks without one are ticks. */\n label?: string;\n}\n\nexport interface SliderProps {\n /** Accessible name, shown above the slider unless `labelHidden`. */\n label: string;\n /** Visually hide the label (it still names the slider). */\n labelHidden?: boolean;\n /** A number, `[from, to]` for a range, or more numbers for more thumbs (each stays between its neighbours). */\n value?: SliderValue;\n /** Starting value when uncontrolled. Default: `min`. */\n defaultValue?: SliderValue;\n /** Every change while dragging or pressing keys. */\n onChange?: (value: SliderValue) => void;\n /** When a change is finished: pointer released, or after each key press. */\n onCommit?: (value: SliderValue) => void;\n /** Lowest value. Default 0. */\n min?: number;\n /** Highest value. Default 100. */\n max?: number;\n /** Values snap to this step, and the arrow keys move by it. Default 1. */\n step?: number;\n /** Page Up and Page Down step (default a tenth of the range). */\n largeStep?: number;\n /** `vertical` runs bottom to top. Default \"horizontal\". */\n orientation?: \"horizontal\" | \"vertical\";\n /** Ticks on the track, with optional text under them. */\n marks?: SliderMark[];\n /**\n * Your own drawing of the track (a gradient, a histogram, a waveform), filling it under the thumbs. The accent fill\n * is not drawn then.\n */\n trackContent?: ReactNode;\n /** Show the current value (or range) at the end of the label row. */\n showValue?: boolean;\n /** Form field name; a range submits two values under it. */\n name?: string;\n /** Not focusable, cannot be changed and not submitted. */\n disabled?: boolean;\n /** Track and thumb size. Default \"md\". */\n size?: Size;\n /** Replace the built-in English text: the thumb names and the value text. */\n labels?: Partial<SliderLabels>;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. Restyle through --cy-slider-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: SliderLabels = {\n minimum: \"minimum\",\n maximum: \"maximum\",\n thumb: (index) => `stop ${index + 1}`,\n value: (v) => String(v),\n};\nconst decimals = (n: number) => (String(n).split(\".\")[1] ?? \"\").length;\n\n/** Picks a number (or a range) by dragging or with the keyboard: APG slider, with pointer, touch and forms. */\n/** The thumb being dragged, and the value to go back to if the drag is cancelled. */\ninterface Drag {\n index: number;\n from: SliderValue;\n}\n\nexport function Slider({\n label,\n labelHidden = false,\n value,\n defaultValue,\n onChange,\n onCommit,\n min = 0,\n max = 100,\n step = 1,\n largeStep,\n orientation = \"horizontal\",\n marks,\n trackContent,\n showValue = false,\n name,\n disabled = false,\n size = \"md\",\n labels,\n className,\n style,\n}: SliderProps) {\n const id = useId();\n const text = { ...DEFAULT_LABELS, ...labels };\n const initial = defaultValue ?? min;\n const [current, setCurrent, resetCurrent] = useControllableState<SliderValue>(value, initial, onChange);\n const range = Array.isArray(current);\n const values: number[] = range ? [...current] : [current];\n const track = useRef<HTMLDivElement>(null);\n const thumbs = useRef<(HTMLDivElement | null)[]>([]);\n const drag = useRef<Drag | null>(null);\n const big = largeStep ?? Math.max(step, (max - min) / 10);\n const vertical = orientation === \"vertical\";\n\n const snap = useCallback(\n (v: number) => {\n const stepped = min + Math.round((v - min) / step) * step;\n return Number(Math.min(Math.max(stepped, min), max).toFixed(decimals(step)));\n },\n [min, max, step],\n );\n /** New value with thumb `index` moved to `v`; thumbs stop at their neighbours instead of crossing. */\n const withThumb = (index: number, v: number): SliderValue => {\n if (!range) return snap(v);\n const next = [...values];\n next[index] = clamp(snap(v), values[index - 1] ?? min, values[index + 1] ?? max);\n return next;\n };\n const set = (next: SliderValue, commit: boolean) => {\n const same = Array.isArray(next) ? next.every((n, i) => n === values[i]) : next === values[0];\n if (!same) {\n setCurrent(next);\n }\n if (commit) onCommit?.(next);\n };\n\n const fromPoint = (point: { x: number; y: number }) => {\n const box = (track.current as HTMLDivElement).getBoundingClientRect();\n const rtl = !vertical && isRtl(track.current as HTMLDivElement);\n let ratio = vertical ? (box.bottom - point.y) / box.height : (point.x - box.left) / box.width;\n if (rtl) ratio = 1 - ratio;\n return min + clamp(ratio) * (max - min);\n };\n // Dragging through detent: the press moves the nearest thumb there, a drag follows, Escape puts it back.\n useDrag(track, {\n // The track's CSS keeps pan-y (pan-x when vertical), so a swipe across it still scrolls the page.\n touchAction: \"css\",\n onStart: ({ point }) => {\n if (disabled) return false;\n const v = fromPoint(point);\n // The nearest thumb takes the press; among thumbs on one spot, the one that can still move that way.\n const distances = values.map((n) => Math.abs(n - v));\n const nearest = Math.min(...distances);\n const tied = distances.flatMap((d, i) => (d === nearest ? [i] : []));\n const index = (v < (values[tied[0] as number] as number) ? tied[0] : tied[tied.length - 1]) as number;\n drag.current = { index, from: range ? [...values] : (values[0] as number) };\n thumbs.current[index]?.focus({ preventScroll: true });\n set(withThumb(index, v), false);\n },\n onMove: ({ point }) => set(withThumb((drag.current as Drag).index, fromPoint(point)), false),\n onEnd: ({ point }, cancelled) => {\n const d = drag.current as Drag;\n drag.current = null;\n set(cancelled ? d.from : withThumb(d.index, fromPoint(point)), true);\n },\n });\n\n const onKeyDown = (index: number) => (event: KeyboardEvent<HTMLDivElement>) => {\n const now = values[index] as number;\n const rtl = !vertical && isRtl(event.currentTarget);\n const target = stepKey(event, { value: now, min, max, step, big, rtl });\n if (target === undefined) return;\n event.preventDefault();\n set(withThumb(index, target), true);\n };\n\n const position = (v: number) => `${((v - min) / (max - min || 1)) * 100}%`;\n const valueText = range\n ? values.map(text.value).join(values.length === 2 ? \" – \" : \", \")\n : text.value(values[0] as number);\n const fill = range\n ? { \"--_from\": position(values[0] as number), \"--_to\": position(values[values.length - 1] as number) }\n : { \"--_from\": \"0%\", \"--_to\": position(values[0] as number) };\n const thumbName = (index: number) =>\n values.length === 2 ? (index === 0 ? text.minimum : text.maximum) : text.thumb(index, values.length);\n\n return (\n <div\n className={className ? `cy-slider ${className}` : \"cy-slider\"}\n // A range is a group of two sliders named by the label; a single slider is named directly.\n {...(range\n ? { role: \"group\", ...(labelHidden ? { \"aria-label\": label } : { \"aria-labelledby\": `${id}-label` }) }\n : {})}\n data-orientation={orientation}\n data-range={range || undefined}\n data-size={size}\n data-disabled={disabled || undefined}\n style={style}\n >\n {(!labelHidden || showValue) && (\n <div className=\"cy-slider-head cy-reset\">\n {!labelHidden && (\n <span id={`${id}-label`} className=\"cy-slider-label cy-reset\">\n {label}\n </span>\n )}\n {showValue && (\n <span className=\"cy-slider-value cy-reset\" aria-hidden=\"true\">\n {valueText}\n </span>\n )}\n </div>\n )}\n <div\n ref={track}\n className=\"cy-slider-track cy-reset\"\n style={fill as CSSProperties}\n data-custom={trackContent !== undefined ? \"\" : undefined}\n >\n {trackContent !== undefined ? (\n <div className=\"cy-slider-drawing cy-reset\" aria-hidden=\"true\">\n {trackContent}\n </div>\n ) : (\n <div className=\"cy-slider-fill cy-reset\" />\n )}\n {marks?.map((mark) => (\n <span\n key={mark.value}\n className=\"cy-slider-mark cy-reset\"\n aria-hidden=\"true\"\n style={{ \"--_pos\": position(mark.value) } as CSSProperties}\n data-label={mark.label ? \"\" : undefined}\n >\n {mark.label && <span className=\"cy-slider-mark-label cy-reset\">{mark.label}</span>}\n </span>\n ))}\n {values.map((v, index) => (\n <div\n key={index}\n ref={(el) => {\n thumbs.current[index] = el;\n }}\n role=\"slider\"\n tabIndex={disabled ? undefined : 0}\n className=\"cy-slider-thumb cy-reset\"\n aria-orientation={orientation}\n aria-valuemin={values[index - 1] ?? min}\n aria-valuemax={values[index + 1] ?? max}\n aria-valuenow={v}\n aria-valuetext={text.value(v)}\n aria-disabled={disabled || undefined}\n {...(range\n ? { \"aria-label\": `${label}, ${thumbName(index)}` }\n : labelHidden\n ? { \"aria-label\": label }\n : { \"aria-labelledby\": `${id}-label` })}\n style={{ \"--_pos\": position(v) } as CSSProperties}\n onKeyDown={disabled ? undefined : onKeyDown(index)}\n />\n ))}\n </div>\n {values.map((v, index) => (\n <HiddenValue\n key={index}\n name={name}\n value={String(v)}\n disabled={disabled}\n onReset={() => {\n resetCurrent(initial);\n }}\n />\n ))}\n </div>\n );\n}\n"],"mappings":"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"}
@@ -33,15 +33,21 @@ export interface SortableListLabels {
33
33
  export interface SortableListProps {
34
34
  /** Accessible name of the list. */
35
35
  label: string;
36
+ /** Controlled items, in order: `{ id, label, content? }`. */
36
37
  items?: SortableItem[] | undefined;
38
+ /** Starting items when uncontrolled. */
37
39
  defaultItems?: SortableItem[];
38
40
  /** Called with the items in their new order after a move is dropped. */
39
41
  onReorder?: ((items: SortableItem[]) => void) | undefined;
42
+ /** Disables the handles, so nothing can be moved. */
40
43
  disabled?: boolean;
41
44
  /** `list` (rows, default) or `grid` (tiles that wrap: file grids, page thumbnails). */
42
45
  layout?: "list" | "grid";
46
+ /** Text size of the rows. Default "md". */
43
47
  size?: Size;
48
+ /** Replace the built-in English text: the handle name, the instructions and the announcements. */
44
49
  labels?: Partial<SortableListLabels>;
50
+ /** Added to the root element, for layout. */
45
51
  className?: string;
46
52
  /** Layout only. Restyle through --cy-sortable-list-* tokens. */
47
53
  style?: CSSProperties;
@@ -1 +1 @@
1
- {"version":3,"file":"SortableList.js","names":["sortable","useControllableState","useClientLayoutEffect","isRtl","IconButton","vt","grip","useId","useRef","useState","jsx","jsxs","DEFAULT_LABELS","label","p","n","moveItem","list","from","to","next","item","SortableList","items","defaultItems","onReorder","disabled","layout","size","labels","className","style","text","id","committed","setCommitted","preview","setPreviewState","moving","setMovingState","previewRef","movingRef","setPreview","setMoving","said","setSaid","shown","total","handleOf","itemId","start","drop","i","at","changed","cancel","columns","tiles","top","t","shift","delta","onKeyDown","event","active","across","row","move","latest","el","sorted","itemOf","node","bound","reduced","base","now","words","cancelled"],"sources":["../../../src/components/SortableList/SortableList.tsx"],"sourcesContent":["import { sortable } from \"@arshad-shah/detent\";\nimport { type CSSProperties, type KeyboardEvent, type ReactNode, useId, useRef, useState } from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { isRtl } from \"../../foundations/dir.js\";\nimport { grip } from \"../../icons/grip.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\n\nexport interface SortableListTokens {\n /** Background of a row. */\n itemBackground: string;\n /** Corner radius of a row. */\n radius: string;\n /** Smallest tile width in the grid layout. */\n tileMin: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n sortableList: SortableListTokens;\n }\n}\n\nexport interface SortableItem {\n id: string;\n /** Plain text: used in announcements and the handle's name. Shown when there is no `content`. */\n label: string;\n /** What the row shows, if more than the label. */\n content?: ReactNode;\n}\n\nexport interface SortableListLabels {\n /** Handle name. Default: \"Move Docs\". */\n handle: (label: string) => string;\n /** Read with every handle. */\n instructions: string;\n pickedUp: (label: string, position: number, total: number) => string;\n moved: (label: string, position: number, total: number) => string;\n dropped: (label: string, position: number, total: number) => string;\n cancelled: (label: string) => string;\n}\n\nexport interface SortableListProps {\n /** Accessible name of the list. */\n label: string;\n items?: SortableItem[] | undefined;\n defaultItems?: SortableItem[];\n /** Called with the items in their new order after a move is dropped. */\n onReorder?: ((items: SortableItem[]) => void) | undefined;\n disabled?: boolean;\n /** `list` (rows, default) or `grid` (tiles that wrap: file grids, page thumbnails). */\n layout?: \"list\" | \"grid\";\n size?: Size;\n labels?: Partial<SortableListLabels>;\n className?: string;\n /** Layout only. Restyle through --cy-sortable-list-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: SortableListLabels = {\n handle: (label) => `Move ${label}`,\n instructions: \"Press Space to pick up, the arrow keys to move, Space to drop, Escape to cancel.\",\n pickedUp: (label, p, n) => `${label} picked up. Position ${p} of ${n}.`,\n moved: (label, p, n) => `${label} moved to position ${p} of ${n}.`,\n dropped: (label, p, n) => `${label} dropped at position ${p} of ${n}.`,\n cancelled: (label) => `Move cancelled. ${label} is back where it was.`,\n};\n\nconst moveItem = <T,>(list: T[], from: number, to: number) => {\n const next = [...list];\n const [item] = next.splice(from, 1);\n next.splice(to, 0, item as T);\n return next;\n};\n\n/**\n * A list people put in order: drag a row by its handle (mouse, pen or touch), or focus the handle, press Space and\n * move it with the arrow keys. Every step is announced.\n */\nexport function SortableList({\n label,\n items,\n defaultItems = [],\n onReorder,\n disabled = false,\n layout = \"list\",\n size = \"md\",\n labels,\n className,\n style,\n}: SortableListProps) {\n const text = { ...DEFAULT_LABELS, ...labels };\n const id = useId();\n const [committed, setCommitted] = useControllableState(items, defaultItems, onReorder);\n /**\n * While moving: the order being previewed, and the row being moved. Kept in refs too, so events that arrive before\n * React re-renders (a fast drag's move and release) always see the latest values.\n */\n type Moving = { id: string; by: \"keyboard\" | \"pointer\" };\n const [preview, setPreviewState] = useState<SortableItem[] | null>(null);\n const [moving, setMovingState] = useState<Moving | null>(null);\n const previewRef = useRef<SortableItem[] | null>(null);\n const movingRef = useRef<Moving | null>(null);\n const setPreview = (next: SortableItem[] | null) => {\n previewRef.current = next;\n setPreviewState(next);\n };\n const setMoving = (next: Moving | null) => {\n movingRef.current = next;\n setMovingState(next);\n };\n const [said, setSaid] = useState(\"\");\n const list = useRef<HTMLUListElement>(null);\n const shown = preview ?? committed;\n const total = shown.length;\n\n const handleOf = (itemId: string) =>\n list.current?.querySelector<HTMLButtonElement>(\n `[data-id=\"${CSS.escape(itemId)}\"] .cy-sortable-list-handle`,\n );\n\n const start = (item: SortableItem) => {\n setPreview(committed);\n setMoving({ id: item.id, by: \"keyboard\" });\n setSaid(text.pickedUp(item.label, committed.indexOf(item) + 1, committed.length));\n };\n // drop, cancel and shift run only while a row is moving (their callers check), so the refs are set.\n const drop = () => {\n const moving = movingRef.current as Moving;\n const preview = previewRef.current as SortableItem[];\n const item = preview.find((i) => i.id === moving.id) as SortableItem;\n const at = preview.indexOf(item);\n const changed = preview.some((i, n) => i.id !== committed[n]?.id);\n setSaid(text.dropped(item.label, at + 1, preview.length));\n if (changed) {\n setCommitted(preview);\n }\n setPreview(null);\n setMoving(null);\n };\n const cancel = () => {\n const moving = movingRef.current as Moving;\n const item = committed.find((i) => i.id === moving.id) as SortableItem;\n setSaid(text.cancelled(item.label));\n setPreview(null);\n setMoving(null);\n };\n /** Tiles in one row of the grid, measured from the layout (1 for a list). */\n const columns = () => {\n const tiles = [...(list.current as HTMLUListElement).children] as HTMLElement[];\n const top = tiles[0]?.offsetTop;\n const n = tiles.findIndex((t) => t.offsetTop !== top);\n return n < 0 ? tiles.length : n;\n };\n const shift = (delta: number) => {\n const moving = movingRef.current as Moving;\n const preview = previewRef.current as SortableItem[];\n const from = preview.findIndex((i) => i.id === moving.id);\n const to = Math.min(Math.max(from + delta, 0), preview.length - 1);\n if (to === from) return;\n setPreview(moveItem(preview, from, to));\n setSaid(text.moved((preview[from] as SortableItem).label, to + 1, preview.length));\n // The moved row's handle keeps focus as it changes place.\n requestAnimationFrame(() => handleOf(moving.id)?.focus());\n };\n\n // A disabled handle cannot be focused, so it never gets key presses.\n const onKeyDown = (item: SortableItem) => (event: KeyboardEvent<HTMLButtonElement>) => {\n const moving = movingRef.current;\n const active = moving?.id === item.id && moving.by === \"keyboard\";\n if (event.key === \" \" || event.key === \"Enter\") {\n event.preventDefault();\n if (active) drop();\n else if (!moving) start(item);\n return;\n }\n if (!active) return;\n // In a grid, Left and Right move one place (following the reading direction) and Up and Down a whole row.\n const across = isRtl(event.currentTarget) ? -1 : 1;\n const row = layout === \"grid\" ? columns() : 1;\n const moves: Record<string, () => void> = {\n ArrowUp: () => shift(-row),\n ArrowDown: () => shift(row),\n ...(layout === \"grid\" ? { ArrowLeft: () => shift(-across), ArrowRight: () => shift(across) } : {}),\n Home: () => shift(-total),\n End: () => shift(total),\n Escape: cancel,\n Tab: drop,\n };\n const move = moves[event.key];\n if (!move) return;\n if (event.key !== \"Tab\") event.preventDefault();\n move();\n };\n\n // Pointer, touch and pen dragging come from detent (one input path, FLIP animation, auto-scroll). Its own keyboard\n // mode stays off: Cynosure's keyboard mode above has labelled, overridable announcements inside the app.\n const latest = useRef({ committed, text, disabled });\n latest.current = { committed, text, disabled };\n useClientLayoutEffect(() => {\n const el = list.current as HTMLUListElement;\n let sorted = false;\n const itemOf = (node: HTMLElement) =>\n latest.current.committed.find((i) => i.id === node.dataset.id) as SortableItem;\n const bound = sortable(el, {\n handle: \".cy-sortable-list-handle\",\n direction: layout === \"grid\" ? \"grid\" : \"y\",\n keyboard: false,\n // The grip is a dedicated handle that never scrolls the page, so touch needs no press-and-hold.\n delay: 0,\n get animation() {\n const reduced = globalThis.matchMedia?.(\"(prefers-reduced-motion: reduce)\").matches;\n const base = Number.parseFloat(getComputedStyle(el).getPropertyValue(\"--cy-motion-slow\"));\n return reduced ? 0 : Number.isFinite(base) ? base : 180;\n },\n get disabled() {\n return latest.current.disabled;\n },\n onStart: (node, from) => {\n if (movingRef.current) return false;\n const item = itemOf(node);\n sorted = false;\n setMoving({ id: item.id, by: \"pointer\" });\n setSaid(latest.current.text.pickedUp(item.label, from.index + 1, latest.current.committed.length));\n },\n onSort: ({ item: node, from, to }) => {\n sorted = true;\n // Put the node back where React rendered it, then let React apply the new order: React stays the DOM's owner.\n node.remove();\n el.insertBefore(node, el.children[from.index] ?? null);\n const { committed: now, text: words } = latest.current;\n const next = moveItem(now, from.index, to.index);\n setSaid(words.dropped((now[from.index] as SortableItem).label, to.index + 1, next.length));\n setCommitted(next);\n },\n onEnd: (node, cancelled) => {\n const item = itemOf(node);\n setMoving(null);\n if (cancelled) setSaid(latest.current.text.cancelled(item.label));\n else if (!sorted) {\n const at = latest.current.committed.indexOf(item);\n setSaid(latest.current.text.dropped(item.label, at + 1, latest.current.committed.length));\n }\n },\n });\n return () => bound.destroy();\n }, [layout]);\n\n return (\n <div\n className={className ? `cy-sortable-list ${className}` : \"cy-sortable-list\"}\n data-size={size}\n data-layout={layout}\n style={style}\n >\n <ul ref={list} className=\"cy-sortable-list-items cy-reset\" aria-label={label}>\n {shown.map((item) => (\n <li\n key={item.id}\n data-id={item.id}\n className=\"cy-sortable-list-item cy-reset\"\n data-moving={moving?.id === item.id ? \"\" : undefined}\n >\n <IconButton\n icon={grip}\n label={text.handle(item.label)}\n variant=\"ghost\"\n tone=\"neutral\"\n size=\"sm\"\n disabled={disabled}\n className=\"cy-sortable-list-handle\"\n aria-describedby={`${id}-how`}\n aria-pressed={moving?.id === item.id}\n tooltipPlacement=\"start\"\n onKeyDown={onKeyDown(item)}\n />\n <div className=\"cy-sortable-list-content cy-reset\">{item.content ?? item.label}</div>\n </li>\n ))}\n </ul>\n <span id={`${id}-how`} className=\"cy-sortable-list-hidden cy-reset\">\n {text.instructions}\n </span>\n <span className=\"cy-sortable-list-hidden cy-reset\" role=\"status\">\n {said}\n </span>\n </div>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"SortableList.js","names":["sortable","useControllableState","useClientLayoutEffect","isRtl","IconButton","vt","grip","useId","useRef","useState","jsx","jsxs","DEFAULT_LABELS","label","p","n","moveItem","list","from","to","next","item","SortableList","items","defaultItems","onReorder","disabled","layout","size","labels","className","style","text","id","committed","setCommitted","preview","setPreviewState","moving","setMovingState","previewRef","movingRef","setPreview","setMoving","said","setSaid","shown","total","handleOf","itemId","start","drop","i","at","changed","cancel","columns","tiles","top","t","shift","delta","onKeyDown","event","active","across","row","move","latest","el","sorted","itemOf","node","bound","reduced","base","now","words","cancelled"],"sources":["../../../src/components/SortableList/SortableList.tsx"],"sourcesContent":["import { sortable } from \"@arshad-shah/detent\";\nimport { type CSSProperties, type KeyboardEvent, type ReactNode, useId, useRef, useState } from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { isRtl } from \"../../foundations/dir.js\";\nimport { grip } from \"../../icons/grip.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\n\nexport interface SortableListTokens {\n /** Background of a row. */\n itemBackground: string;\n /** Corner radius of a row. */\n radius: string;\n /** Smallest tile width in the grid layout. */\n tileMin: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n sortableList: SortableListTokens;\n }\n}\n\nexport interface SortableItem {\n id: string;\n /** Plain text: used in announcements and the handle's name. Shown when there is no `content`. */\n label: string;\n /** What the row shows, if more than the label. */\n content?: ReactNode;\n}\n\nexport interface SortableListLabels {\n /** Handle name. Default: \"Move Docs\". */\n handle: (label: string) => string;\n /** Read with every handle. */\n instructions: string;\n pickedUp: (label: string, position: number, total: number) => string;\n moved: (label: string, position: number, total: number) => string;\n dropped: (label: string, position: number, total: number) => string;\n cancelled: (label: string) => string;\n}\n\nexport interface SortableListProps {\n /** Accessible name of the list. */\n label: string;\n /** Controlled items, in order: `{ id, label, content? }`. */\n items?: SortableItem[] | undefined;\n /** Starting items when uncontrolled. */\n defaultItems?: SortableItem[];\n /** Called with the items in their new order after a move is dropped. */\n onReorder?: ((items: SortableItem[]) => void) | undefined;\n /** Disables the handles, so nothing can be moved. */\n disabled?: boolean;\n /** `list` (rows, default) or `grid` (tiles that wrap: file grids, page thumbnails). */\n layout?: \"list\" | \"grid\";\n /** Text size of the rows. Default \"md\". */\n size?: Size;\n /** Replace the built-in English text: the handle name, the instructions and the announcements. */\n labels?: Partial<SortableListLabels>;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. Restyle through --cy-sortable-list-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: SortableListLabels = {\n handle: (label) => `Move ${label}`,\n instructions: \"Press Space to pick up, the arrow keys to move, Space to drop, Escape to cancel.\",\n pickedUp: (label, p, n) => `${label} picked up. Position ${p} of ${n}.`,\n moved: (label, p, n) => `${label} moved to position ${p} of ${n}.`,\n dropped: (label, p, n) => `${label} dropped at position ${p} of ${n}.`,\n cancelled: (label) => `Move cancelled. ${label} is back where it was.`,\n};\n\nconst moveItem = <T,>(list: T[], from: number, to: number) => {\n const next = [...list];\n const [item] = next.splice(from, 1);\n next.splice(to, 0, item as T);\n return next;\n};\n\n/**\n * A list people put in order: drag a row by its handle (mouse, pen or touch), or focus the handle, press Space and\n * move it with the arrow keys. Every step is announced.\n */\nexport function SortableList({\n label,\n items,\n defaultItems = [],\n onReorder,\n disabled = false,\n layout = \"list\",\n size = \"md\",\n labels,\n className,\n style,\n}: SortableListProps) {\n const text = { ...DEFAULT_LABELS, ...labels };\n const id = useId();\n const [committed, setCommitted] = useControllableState(items, defaultItems, onReorder);\n /**\n * While moving: the order being previewed, and the row being moved. Kept in refs too, so events that arrive before\n * React re-renders (a fast drag's move and release) always see the latest values.\n */\n type Moving = { id: string; by: \"keyboard\" | \"pointer\" };\n const [preview, setPreviewState] = useState<SortableItem[] | null>(null);\n const [moving, setMovingState] = useState<Moving | null>(null);\n const previewRef = useRef<SortableItem[] | null>(null);\n const movingRef = useRef<Moving | null>(null);\n const setPreview = (next: SortableItem[] | null) => {\n previewRef.current = next;\n setPreviewState(next);\n };\n const setMoving = (next: Moving | null) => {\n movingRef.current = next;\n setMovingState(next);\n };\n const [said, setSaid] = useState(\"\");\n const list = useRef<HTMLUListElement>(null);\n const shown = preview ?? committed;\n const total = shown.length;\n\n const handleOf = (itemId: string) =>\n list.current?.querySelector<HTMLButtonElement>(\n `[data-id=\"${CSS.escape(itemId)}\"] .cy-sortable-list-handle`,\n );\n\n const start = (item: SortableItem) => {\n setPreview(committed);\n setMoving({ id: item.id, by: \"keyboard\" });\n setSaid(text.pickedUp(item.label, committed.indexOf(item) + 1, committed.length));\n };\n // drop, cancel and shift run only while a row is moving (their callers check), so the refs are set.\n const drop = () => {\n const moving = movingRef.current as Moving;\n const preview = previewRef.current as SortableItem[];\n const item = preview.find((i) => i.id === moving.id) as SortableItem;\n const at = preview.indexOf(item);\n const changed = preview.some((i, n) => i.id !== committed[n]?.id);\n setSaid(text.dropped(item.label, at + 1, preview.length));\n if (changed) {\n setCommitted(preview);\n }\n setPreview(null);\n setMoving(null);\n };\n const cancel = () => {\n const moving = movingRef.current as Moving;\n const item = committed.find((i) => i.id === moving.id) as SortableItem;\n setSaid(text.cancelled(item.label));\n setPreview(null);\n setMoving(null);\n };\n /** Tiles in one row of the grid, measured from the layout (1 for a list). */\n const columns = () => {\n const tiles = [...(list.current as HTMLUListElement).children] as HTMLElement[];\n const top = tiles[0]?.offsetTop;\n const n = tiles.findIndex((t) => t.offsetTop !== top);\n return n < 0 ? tiles.length : n;\n };\n const shift = (delta: number) => {\n const moving = movingRef.current as Moving;\n const preview = previewRef.current as SortableItem[];\n const from = preview.findIndex((i) => i.id === moving.id);\n const to = Math.min(Math.max(from + delta, 0), preview.length - 1);\n if (to === from) return;\n setPreview(moveItem(preview, from, to));\n setSaid(text.moved((preview[from] as SortableItem).label, to + 1, preview.length));\n // The moved row's handle keeps focus as it changes place.\n requestAnimationFrame(() => handleOf(moving.id)?.focus());\n };\n\n // A disabled handle cannot be focused, so it never gets key presses.\n const onKeyDown = (item: SortableItem) => (event: KeyboardEvent<HTMLButtonElement>) => {\n const moving = movingRef.current;\n const active = moving?.id === item.id && moving.by === \"keyboard\";\n if (event.key === \" \" || event.key === \"Enter\") {\n event.preventDefault();\n if (active) drop();\n else if (!moving) start(item);\n return;\n }\n if (!active) return;\n // In a grid, Left and Right move one place (following the reading direction) and Up and Down a whole row.\n const across = isRtl(event.currentTarget) ? -1 : 1;\n const row = layout === \"grid\" ? columns() : 1;\n const moves: Record<string, () => void> = {\n ArrowUp: () => shift(-row),\n ArrowDown: () => shift(row),\n ...(layout === \"grid\" ? { ArrowLeft: () => shift(-across), ArrowRight: () => shift(across) } : {}),\n Home: () => shift(-total),\n End: () => shift(total),\n Escape: cancel,\n Tab: drop,\n };\n const move = moves[event.key];\n if (!move) return;\n if (event.key !== \"Tab\") event.preventDefault();\n move();\n };\n\n // Pointer, touch and pen dragging come from detent (one input path, FLIP animation, auto-scroll). Its own keyboard\n // mode stays off: Cynosure's keyboard mode above has labelled, overridable announcements inside the app.\n const latest = useRef({ committed, text, disabled });\n latest.current = { committed, text, disabled };\n useClientLayoutEffect(() => {\n const el = list.current as HTMLUListElement;\n let sorted = false;\n const itemOf = (node: HTMLElement) =>\n latest.current.committed.find((i) => i.id === node.dataset.id) as SortableItem;\n const bound = sortable(el, {\n handle: \".cy-sortable-list-handle\",\n direction: layout === \"grid\" ? \"grid\" : \"y\",\n keyboard: false,\n // The grip is a dedicated handle that never scrolls the page, so touch needs no press-and-hold.\n delay: 0,\n get animation() {\n const reduced = globalThis.matchMedia?.(\"(prefers-reduced-motion: reduce)\").matches;\n const base = Number.parseFloat(getComputedStyle(el).getPropertyValue(\"--cy-motion-slow\"));\n return reduced ? 0 : Number.isFinite(base) ? base : 180;\n },\n get disabled() {\n return latest.current.disabled;\n },\n onStart: (node, from) => {\n if (movingRef.current) return false;\n const item = itemOf(node);\n sorted = false;\n setMoving({ id: item.id, by: \"pointer\" });\n setSaid(latest.current.text.pickedUp(item.label, from.index + 1, latest.current.committed.length));\n },\n onSort: ({ item: node, from, to }) => {\n sorted = true;\n // Put the node back where React rendered it, then let React apply the new order: React stays the DOM's owner.\n node.remove();\n el.insertBefore(node, el.children[from.index] ?? null);\n const { committed: now, text: words } = latest.current;\n const next = moveItem(now, from.index, to.index);\n setSaid(words.dropped((now[from.index] as SortableItem).label, to.index + 1, next.length));\n setCommitted(next);\n },\n onEnd: (node, cancelled) => {\n const item = itemOf(node);\n setMoving(null);\n if (cancelled) setSaid(latest.current.text.cancelled(item.label));\n else if (!sorted) {\n const at = latest.current.committed.indexOf(item);\n setSaid(latest.current.text.dropped(item.label, at + 1, latest.current.committed.length));\n }\n },\n });\n return () => bound.destroy();\n }, [layout]);\n\n return (\n <div\n className={className ? `cy-sortable-list ${className}` : \"cy-sortable-list\"}\n data-size={size}\n data-layout={layout}\n style={style}\n >\n <ul ref={list} className=\"cy-sortable-list-items cy-reset\" aria-label={label}>\n {shown.map((item) => (\n <li\n key={item.id}\n data-id={item.id}\n className=\"cy-sortable-list-item cy-reset\"\n data-moving={moving?.id === item.id ? \"\" : undefined}\n >\n <IconButton\n icon={grip}\n label={text.handle(item.label)}\n variant=\"ghost\"\n tone=\"neutral\"\n size=\"sm\"\n disabled={disabled}\n className=\"cy-sortable-list-handle\"\n aria-describedby={`${id}-how`}\n aria-pressed={moving?.id === item.id}\n tooltipPlacement=\"start\"\n onKeyDown={onKeyDown(item)}\n />\n <div className=\"cy-sortable-list-content cy-reset\">{item.content ?? item.label}</div>\n </li>\n ))}\n </ul>\n <span id={`${id}-how`} className=\"cy-sortable-list-hidden cy-reset\">\n {text.instructions}\n </span>\n <span className=\"cy-sortable-list-hidden cy-reset\" role=\"status\">\n {said}\n </span>\n </div>\n );\n}\n"],"mappings":"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"}
@@ -13,6 +13,7 @@ declare module "../../tokens/schema.js" {
13
13
  export interface SplitPaneProps {
14
14
  /** The first pane (left, or right in right-to-left text; top when vertical). Its size is what the divider sets. */
15
15
  start: ReactNode;
16
+ /** The second pane (right, or left in right-to-left text; bottom when vertical). */
16
17
  end: ReactNode;
17
18
  /** Accessible name of the divider, e.g. "Resize the file list". */
18
19
  label: string;
@@ -25,15 +26,19 @@ export interface SplitPaneProps {
25
26
  unit?: "percent" | "px";
26
27
  /** Size of the start pane, in `unit`. */
27
28
  size?: number | undefined;
29
+ /** Starting size of the start pane when uncontrolled, in `unit`. Default 50 percent, or 240 pixels. */
28
30
  defaultSize?: number | undefined;
31
+ /** Called with the new size as the divider moves. */
29
32
  onSizeChange?: ((size: number) => void) | undefined;
30
33
  /** Limits for the start pane, in `unit`. Defaults: 10 and 90 percent, or 120 and 600 pixels. */
31
34
  min?: number;
35
+ /** Largest size of the start pane, in `unit`. Default 90 percent, or 600 pixels. */
32
36
  max?: number;
33
37
  /** Arrow keys move by this much, in `unit`. Default 5 percent, or 16 pixels. */
34
38
  step?: number;
35
39
  /** Enter collapses the start pane to 0 and restores it. */
36
40
  collapsible?: boolean;
41
+ /** Added to the root element, for layout. */
37
42
  className?: string;
38
43
  /** Layout only. Restyle through --cy-split-pane-* tokens. */
39
44
  style?: CSSProperties;
@@ -2,8 +2,8 @@
2
2
  import { useControllableState as F } from "../../foundations/controllable.js";
3
3
  import { isRtl as D } from "../../foundations/dir.js";
4
4
  import { clamp as T } from "../../foundations/math.js";
5
- import { useDrag as q } from "../../foundations/drag.js";
6
- import { stepKey as G } from "../../foundations/keys.js";
5
+ import { stepKey as q } from "../../foundations/keys.js";
6
+ import { useDrag as G } from "../../foundations/drag.js";
7
7
  import { useId as H, useRef as c, useState as J } from "react";
8
8
  import { jsx as f, jsxs as L } from "react/jsx-runtime";
9
9
  var O = (l) => Math.round(l * 10) / 10;
@@ -15,7 +15,7 @@ function tt({ start: l, end: M, label: b, orientation: v = "horizontal", unit: z
15
15
  const e = p.current.getBoundingClientRect(), a = !s && D(p.current), o = s ? t.y - e.top : a ? e.right - t.x : t.x - e.left;
16
16
  i(n ? o : ((s ? o / e.height : o / e.width) || 0) * 100);
17
17
  };
18
- q(m, {
18
+ G(m, {
19
19
  onStart: () => {
20
20
  S.current = r, m.current?.focus({ preventScroll: !0 }), h(!0);
21
21
  },
@@ -25,7 +25,7 @@ function tt({ start: l, end: M, label: b, orientation: v = "horizontal", unit: z
25
25
  }
26
26
  });
27
27
  const B = (t) => {
28
- const e = G(t, {
28
+ const e = q(t, {
29
29
  value: r,
30
30
  min: u,
31
31
  max: d,