@arshad-shah/cynosure 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (275) hide show
  1. package/README.md +9 -8
  2. package/dist/components/Accordion/Accordion.d.ts +14 -0
  3. package/dist/components/Accordion/Accordion.js.map +1 -1
  4. package/dist/components/Announcer/Announcer.d.ts +1 -0
  5. package/dist/components/Announcer/Announcer.js.map +1 -1
  6. package/dist/components/AppShell/AppShell.d.ts +22 -1
  7. package/dist/components/AppShell/AppShell.js +95 -83
  8. package/dist/components/AppShell/AppShell.js.map +1 -1
  9. package/dist/components/AppShell/index.d.ts +1 -1
  10. package/dist/components/AspectRatio/AspectRatio.d.ts +29 -0
  11. package/dist/components/AspectRatio/AspectRatio.js +21 -0
  12. package/dist/components/AspectRatio/AspectRatio.js.map +1 -0
  13. package/dist/components/AspectRatio/index.d.ts +1 -0
  14. package/dist/components/Avatar/Avatar.d.ts +96 -0
  15. package/dist/components/Avatar/Avatar.js +90 -0
  16. package/dist/components/Avatar/Avatar.js.map +1 -0
  17. package/dist/components/Avatar/index.d.ts +1 -0
  18. package/dist/components/Badge/Badge.d.ts +6 -0
  19. package/dist/components/Badge/Badge.js.map +1 -1
  20. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +55 -0
  21. package/dist/components/Breadcrumbs/Breadcrumbs.js +85 -0
  22. package/dist/components/Breadcrumbs/Breadcrumbs.js.map +1 -0
  23. package/dist/components/Breadcrumbs/index.d.ts +1 -0
  24. package/dist/components/Button/Button.d.ts +13 -2
  25. package/dist/components/Button/Button.js +28 -26
  26. package/dist/components/Button/Button.js.map +1 -1
  27. package/dist/components/Calendar/Calendar.d.ts +65 -7
  28. package/dist/components/Calendar/Calendar.js +207 -95
  29. package/dist/components/Calendar/Calendar.js.map +1 -1
  30. package/dist/components/Calendar/dates.d.ts +4 -0
  31. package/dist/components/Calendar/dates.js +41 -27
  32. package/dist/components/Calendar/dates.js.map +1 -1
  33. package/dist/components/Calendar/index.d.ts +1 -1
  34. package/dist/components/Card/Card.d.ts +27 -0
  35. package/dist/components/Card/Card.js +48 -36
  36. package/dist/components/Card/Card.js.map +1 -1
  37. package/dist/components/Card/index.d.ts +1 -1
  38. package/dist/components/Checkbox/Checkbox.d.ts +8 -1
  39. package/dist/components/Checkbox/Checkbox.js +7 -6
  40. package/dist/components/Checkbox/Checkbox.js.map +1 -1
  41. package/dist/components/Checkbox/ChoiceRow.d.ts +17 -1
  42. package/dist/components/Checkbox/ChoiceRow.js +19 -18
  43. package/dist/components/Checkbox/ChoiceRow.js.map +1 -1
  44. package/dist/components/Checklist/Checklist.d.ts +65 -0
  45. package/dist/components/Checklist/Checklist.js +163 -0
  46. package/dist/components/Checklist/Checklist.js.map +1 -0
  47. package/dist/components/Checklist/index.d.ts +1 -0
  48. package/dist/components/CodeBlock/CodeBlock.d.ts +5 -0
  49. package/dist/components/CodeBlock/CodeBlock.js.map +1 -1
  50. package/dist/components/ColorField/ColorField.d.ts +12 -0
  51. package/dist/components/ColorField/ColorField.js +19 -19
  52. package/dist/components/ColorField/ColorField.js.map +1 -1
  53. package/dist/components/ColorSwatches/ColorSwatches.d.ts +5 -0
  54. package/dist/components/ColorSwatches/ColorSwatches.js +6 -6
  55. package/dist/components/ColorSwatches/ColorSwatches.js.map +1 -1
  56. package/dist/components/Combobox/Combobox.d.ts +20 -1
  57. package/dist/components/Combobox/Combobox.js +38 -34
  58. package/dist/components/Combobox/Combobox.js.map +1 -1
  59. package/dist/components/CommandPalette/CommandPalette.d.ts +9 -0
  60. package/dist/components/CommandPalette/CommandPalette.js +10 -10
  61. package/dist/components/CommandPalette/CommandPalette.js.map +1 -1
  62. package/dist/components/CompareSlider/CompareSlider.d.ts +4 -0
  63. package/dist/components/CompareSlider/CompareSlider.js +4 -4
  64. package/dist/components/CompareSlider/CompareSlider.js.map +1 -1
  65. package/dist/components/Container/Container.d.ts +44 -0
  66. package/dist/components/Container/Container.js +24 -0
  67. package/dist/components/Container/Container.js.map +1 -0
  68. package/dist/components/Container/index.d.ts +1 -0
  69. package/dist/components/ContextMenu/ContextMenu.d.ts +11 -0
  70. package/dist/components/ContextMenu/ContextMenu.js.map +1 -1
  71. package/dist/components/CopyButton/CopyButton.d.ts +8 -0
  72. package/dist/components/CopyButton/CopyButton.js.map +1 -1
  73. package/dist/components/DateField/DateField.d.ts +17 -0
  74. package/dist/components/DateField/DateField.js +6 -6
  75. package/dist/components/DateField/DateField.js.map +1 -1
  76. package/dist/components/DescriptionList/DescriptionList.d.ts +3 -0
  77. package/dist/components/DescriptionList/DescriptionList.js.map +1 -1
  78. package/dist/components/Dialog/Dialog.d.ts +16 -2
  79. package/dist/components/Dialog/Dialog.js +82 -70
  80. package/dist/components/Dialog/Dialog.js.map +1 -1
  81. package/dist/components/Disclosure/Disclosure.d.ts +7 -0
  82. package/dist/components/Disclosure/Disclosure.js.map +1 -1
  83. package/dist/components/Divider/Divider.d.ts +59 -0
  84. package/dist/components/Divider/Divider.js +32 -0
  85. package/dist/components/Divider/Divider.js.map +1 -0
  86. package/dist/components/Divider/index.d.ts +1 -0
  87. package/dist/components/DocumentViewport/DocumentViewport.d.ts +8 -0
  88. package/dist/components/DocumentViewport/DocumentViewport.js.map +1 -1
  89. package/dist/components/EmptyState/EmptyState.d.ts +3 -0
  90. package/dist/components/EmptyState/EmptyState.js.map +1 -1
  91. package/dist/components/Field/Field.d.ts +6 -0
  92. package/dist/components/Field/Field.js.map +1 -1
  93. package/dist/components/FileDrop/FileDrop.d.ts +8 -0
  94. package/dist/components/FileDrop/FileDrop.js.map +1 -1
  95. package/dist/components/FloatingToolbar/FloatingToolbar.d.ts +4 -0
  96. package/dist/components/FloatingToolbar/FloatingToolbar.js +4 -4
  97. package/dist/components/FloatingToolbar/FloatingToolbar.js.map +1 -1
  98. package/dist/components/Grid/Grid.d.ts +33 -7
  99. package/dist/components/Grid/Grid.js +46 -25
  100. package/dist/components/Grid/Grid.js.map +1 -1
  101. package/dist/components/Grid/index.d.ts +1 -1
  102. package/dist/components/Heading/Heading.d.ts +57 -0
  103. package/dist/components/Heading/Heading.js +33 -0
  104. package/dist/components/Heading/Heading.js.map +1 -0
  105. package/dist/components/Heading/index.d.ts +1 -0
  106. package/dist/components/HoverCard/HoverCard.d.ts +1 -0
  107. package/dist/components/HoverCard/HoverCard.js.map +1 -1
  108. package/dist/components/IconButton/IconButton.d.ts +1 -0
  109. package/dist/components/IconButton/IconButton.js.map +1 -1
  110. package/dist/components/Image/Image.d.ts +62 -0
  111. package/dist/components/Image/Image.js +75 -0
  112. package/dist/components/Image/Image.js.map +1 -0
  113. package/dist/components/Image/index.d.ts +1 -0
  114. package/dist/components/Inline/Inline.d.ts +7 -3
  115. package/dist/components/Inline/Inline.js +19 -13
  116. package/dist/components/Inline/Inline.js.map +1 -1
  117. package/dist/components/Kbd/Kbd.d.ts +2 -0
  118. package/dist/components/Kbd/Kbd.js.map +1 -1
  119. package/dist/components/KeyValueEditor/KeyValueEditor.d.ts +7 -0
  120. package/dist/components/KeyValueEditor/KeyValueEditor.js +8 -8
  121. package/dist/components/KeyValueEditor/KeyValueEditor.js.map +1 -1
  122. package/dist/components/Link/Link.d.ts +7 -0
  123. package/dist/components/Link/Link.js.map +1 -1
  124. package/dist/components/LoadingDots/LoadingDots.d.ts +2 -0
  125. package/dist/components/LoadingDots/LoadingDots.js.map +1 -1
  126. package/dist/components/Menu/Menu.d.ts +13 -1
  127. package/dist/components/Menu/Menu.js +37 -35
  128. package/dist/components/Menu/Menu.js.map +1 -1
  129. package/dist/components/Notice/Notice.d.ts +5 -0
  130. package/dist/components/Notice/Notice.js.map +1 -1
  131. package/dist/components/NumberField/NumberField.d.ts +17 -0
  132. package/dist/components/NumberField/NumberField.js +8 -8
  133. package/dist/components/NumberField/NumberField.js.map +1 -1
  134. package/dist/components/PageHeader/PageHeader.d.ts +61 -0
  135. package/dist/components/PageHeader/PageHeader.js +63 -0
  136. package/dist/components/PageHeader/PageHeader.js.map +1 -0
  137. package/dist/components/PageHeader/index.d.ts +1 -0
  138. package/dist/components/Pagination/Pagination.d.ts +77 -0
  139. package/dist/components/Pagination/Pagination.js +120 -0
  140. package/dist/components/Pagination/Pagination.js.map +1 -0
  141. package/dist/components/Pagination/index.d.ts +1 -0
  142. package/dist/components/PanZoomCanvas/PanZoomCanvas.d.ts +4 -0
  143. package/dist/components/PanZoomCanvas/PanZoomCanvas.js.map +1 -1
  144. package/dist/components/Popover/Popover.d.ts +10 -0
  145. package/dist/components/Popover/Popover.js.map +1 -1
  146. package/dist/components/ProgressBar/ProgressBar.d.ts +5 -0
  147. package/dist/components/ProgressBar/ProgressBar.js.map +1 -1
  148. package/dist/components/ProgressOverlay/ProgressOverlay.d.ts +3 -0
  149. package/dist/components/ProgressOverlay/ProgressOverlay.js.map +1 -1
  150. package/dist/components/Prose/Prose.d.ts +1 -0
  151. package/dist/components/Prose/Prose.js.map +1 -1
  152. package/dist/components/RadioGroup/RadioGroup.d.ts +13 -0
  153. package/dist/components/RadioGroup/RadioGroup.js.map +1 -1
  154. package/dist/components/SegmentedControl/SegmentedControl.d.ts +9 -0
  155. package/dist/components/SegmentedControl/SegmentedControl.js +35 -27
  156. package/dist/components/SegmentedControl/SegmentedControl.js.map +1 -1
  157. package/dist/components/Select/Select.d.ts +18 -1
  158. package/dist/components/Select/Select.js +97 -88
  159. package/dist/components/Select/Select.js.map +1 -1
  160. package/dist/components/Select/index.d.ts +1 -0
  161. package/dist/components/SelectionFrame/SelectionFrame.d.ts +6 -0
  162. package/dist/components/SelectionFrame/SelectionFrame.js.map +1 -1
  163. package/dist/components/SideNav/SideNav.d.ts +37 -1
  164. package/dist/components/SideNav/SideNav.js +100 -73
  165. package/dist/components/SideNav/SideNav.js.map +1 -1
  166. package/dist/components/SideNav/index.d.ts +1 -1
  167. package/dist/components/SignaturePad/SignaturePad.d.ts +3 -0
  168. package/dist/components/SignaturePad/SignaturePad.js.map +1 -1
  169. package/dist/components/Skeleton/Skeleton.d.ts +1 -0
  170. package/dist/components/Skeleton/Skeleton.js.map +1 -1
  171. package/dist/components/Slider/Slider.d.ts +11 -0
  172. package/dist/components/Slider/Slider.js +6 -6
  173. package/dist/components/Slider/Slider.js.map +1 -1
  174. package/dist/components/SortableList/SortableList.d.ts +6 -0
  175. package/dist/components/SortableList/SortableList.js.map +1 -1
  176. package/dist/components/SplitPane/SplitPane.d.ts +5 -0
  177. package/dist/components/SplitPane/SplitPane.js +4 -4
  178. package/dist/components/SplitPane/SplitPane.js.map +1 -1
  179. package/dist/components/Stack/Stack.d.ts +7 -3
  180. package/dist/components/Stack/Stack.js +18 -12
  181. package/dist/components/Stack/Stack.js.map +1 -1
  182. package/dist/components/Stack/index.d.ts +1 -0
  183. package/dist/components/Stack/space.d.ts +18 -0
  184. package/dist/components/Stack/space.js +12 -0
  185. package/dist/components/Stack/space.js.map +1 -0
  186. package/dist/components/Steps/Steps.d.ts +4 -0
  187. package/dist/components/Steps/Steps.js.map +1 -1
  188. package/dist/components/Table/Table.d.ts +12 -0
  189. package/dist/components/Table/Table.js.map +1 -1
  190. package/dist/components/Tabs/Tabs.d.ts +14 -0
  191. package/dist/components/Tabs/Tabs.js +4 -4
  192. package/dist/components/Tabs/Tabs.js.map +1 -1
  193. package/dist/components/TagInput/TagInput.d.ts +18 -0
  194. package/dist/components/TagInput/TagInput.js +5 -5
  195. package/dist/components/TagInput/TagInput.js.map +1 -1
  196. package/dist/components/Text/Text.d.ts +72 -0
  197. package/dist/components/Text/Text.js +30 -0
  198. package/dist/components/Text/Text.js.map +1 -0
  199. package/dist/components/Text/index.d.ts +1 -0
  200. package/dist/components/TextArea/TextArea.d.ts +10 -0
  201. package/dist/components/TextArea/TextArea.js +4 -4
  202. package/dist/components/TextArea/TextArea.js.map +1 -1
  203. package/dist/components/TextField/TextField.d.ts +13 -0
  204. package/dist/components/TextField/TextField.js +4 -4
  205. package/dist/components/TextField/TextField.js.map +1 -1
  206. package/dist/components/ThemeToggle/ThemeToggle.d.ts +4 -0
  207. package/dist/components/ThemeToggle/ThemeToggle.js.map +1 -1
  208. package/dist/components/TimeField/TimeField.d.ts +62 -8
  209. package/dist/components/TimeField/TimeField.js +308 -72
  210. package/dist/components/TimeField/TimeField.js.map +1 -1
  211. package/dist/components/Toast/Toast.d.ts +25 -1
  212. package/dist/components/Toast/Toast.js +134 -125
  213. package/dist/components/Toast/Toast.js.map +1 -1
  214. package/dist/components/Toast/index.d.ts +1 -1
  215. package/dist/components/Toolbar/Toolbar.d.ts +3 -0
  216. package/dist/components/Toolbar/Toolbar.js.map +1 -1
  217. package/dist/components/Tooltip/Tooltip.d.ts +1 -0
  218. package/dist/components/Tooltip/Tooltip.js.map +1 -1
  219. package/dist/components/Tree/Tree.d.ts +8 -0
  220. package/dist/components/Tree/Tree.js.map +1 -1
  221. package/dist/components/VirtualList/VirtualList.d.ts +8 -0
  222. package/dist/components/VirtualList/VirtualList.js +4 -4
  223. package/dist/components/VirtualList/VirtualList.js.map +1 -1
  224. package/dist/components/ZoomControls/ZoomControls.d.ts +4 -0
  225. package/dist/components/ZoomControls/ZoomControls.js.map +1 -1
  226. package/dist/foundations/ChoiceBase/ChoiceBase.d.ts +1 -0
  227. package/dist/foundations/ChoiceBase/ChoiceBase.js.map +1 -1
  228. package/dist/foundations/HiddenValue/HiddenValue.d.ts +3 -0
  229. package/dist/foundations/HiddenValue/HiddenValue.js.map +1 -1
  230. package/dist/foundations/Icon/Icon.d.ts +3 -0
  231. package/dist/foundations/Icon/Icon.js.map +1 -1
  232. package/dist/foundations/image-outcome.d.ts +15 -0
  233. package/dist/foundations/image-outcome.js +39 -0
  234. package/dist/foundations/image-outcome.js.map +1 -0
  235. package/dist/foundations/option-icon.d.ts +26 -0
  236. package/dist/foundations/option-icon.js +16 -0
  237. package/dist/foundations/option-icon.js.map +1 -0
  238. package/dist/icons/index.d.ts +1 -0
  239. package/dist/icons/index.js +476 -474
  240. package/dist/icons/keywords.d.ts +249 -0
  241. package/dist/icons/keywords.js +1728 -0
  242. package/dist/icons/keywords.js.map +1 -0
  243. package/dist/index.d.ts +20 -9
  244. package/dist/index.js +240 -213
  245. package/dist/styles/app-shell.css +1 -1
  246. package/dist/styles/aspect-ratio.css +1 -0
  247. package/dist/styles/avatar.css +1 -0
  248. package/dist/styles/breadcrumbs.css +1 -0
  249. package/dist/styles/calendar.css +1 -1
  250. package/dist/styles/card.css +1 -1
  251. package/dist/styles/checkbox.css +1 -1
  252. package/dist/styles/checklist.css +1 -0
  253. package/dist/styles/container.css +1 -0
  254. package/dist/styles/divider.css +1 -0
  255. package/dist/styles/generated-css.d.ts +1 -1
  256. package/dist/styles/generated-css.js +1 -1
  257. package/dist/styles/generated-css.js.map +1 -1
  258. package/dist/styles/grid.css +1 -1
  259. package/dist/styles/heading.css +1 -0
  260. package/dist/styles/image.css +1 -0
  261. package/dist/styles/menu.css +1 -1
  262. package/dist/styles/page-header.css +1 -0
  263. package/dist/styles/pagination.css +1 -0
  264. package/dist/styles/segmented-control.css +1 -1
  265. package/dist/styles/side-nav.css +1 -1
  266. package/dist/styles/stack.css +1 -1
  267. package/dist/styles/text.css +1 -0
  268. package/dist/styles/time-field.css +1 -1
  269. package/dist/styles/toast.css +1 -1
  270. package/dist/styles.css +1 -1
  271. package/dist/theme/CynosureTheme.d.ts +4 -0
  272. package/dist/theme/CynosureTheme.js.map +1 -1
  273. package/dist/tokens/to-css.js +12 -12
  274. package/dist/tokens/to-css.js.map +1 -1
  275. package/package.json +4 -3
@@ -1 +1 @@
1
- {"version":3,"file":"TextArea.js","names":["Icon","useDrag","Field","TextAreaBase","resizeCorner","forwardRef","useCallback","useEffect","useLayoutEffect","useRef","useState","jsx","jsxs","defaultCount","n","max","TextArea","label","labelHidden","description","error","value","defaultValue","onChange","rows","maxRows","resizable","showCount","size","variant","labels","maxLength","required","disabled","id","className","style","rest","forwarded","inner","count","setCount","manual","grip","dragFrom","ref","node","resize","area","cs","line","chrome","min","wanted","height","delta","_","cancelled","form","onReset","field","countId","describedBy","e"],"sources":["../../../src/components/TextArea/TextArea.tsx"],"sourcesContent":["import {\n type CSSProperties,\n forwardRef,\n type ReactNode,\n type TextareaHTMLAttributes,\n useCallback,\n useEffect,\n useLayoutEffect,\n useRef,\n useState,\n} from \"react\";\nimport { useDrag } from \"../../foundations/drag.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { TextAreaBase } from \"../../foundations/TextAreaBase/TextAreaBase.js\";\nimport { resizeCorner } from \"../../icons/resize-corner.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { Field } from \"../Field/Field.js\";\n\nexport interface TextAreaTokens {\n radius: string;\n paddingInline: string;\n paddingBlock: string;\n bg: string;\n border: string;\n softBg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n textArea: TextAreaTokens;\n }\n}\n\ntype NativeArea = Omit<\n TextareaHTMLAttributes<HTMLTextAreaElement>,\n \"value\" | \"defaultValue\" | \"onChange\" | \"rows\" | \"className\" | \"style\" | \"children\"\n>;\n\nexport interface TextAreaProps extends NativeArea {\n label: ReactNode;\n /** Visually hide the label (it still names the control). Prefer visible labels. */\n labelHidden?: boolean | undefined;\n description?: ReactNode;\n error?: ReactNode;\n value?: string;\n defaultValue?: string;\n onChange?: (value: string) => void;\n /** Show a corner grip to drag the height (pointer and touch). Content growth still applies. */\n resizable?: boolean;\n /** Minimum visible rows. */\n rows?: number;\n /** Auto-grow cap; content beyond scrolls. */\n maxRows?: number;\n /** Shows a live character counter. */\n showCount?: boolean;\n size?: Size;\n variant?: \"outline\" | \"soft\";\n labels?: { count?: (count: number, max?: number) => string };\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n}\n\nconst defaultCount = (n: number, max?: number) => (max ? `${n} / ${max}` : `${n} characters`);\n\n/** Multi-line input that grows with its content up to `maxRows`, with an optional announced counter. */\nexport const TextArea = forwardRef<HTMLTextAreaElement, TextAreaProps>(function TextArea(\n {\n label,\n labelHidden,\n description,\n error,\n value,\n defaultValue,\n onChange,\n rows = 3,\n maxRows = 12,\n resizable = true,\n showCount = false,\n size = \"md\",\n variant = \"outline\",\n labels,\n maxLength,\n required,\n disabled,\n id,\n className,\n style,\n ...rest\n },\n forwarded,\n) {\n const inner = useRef<HTMLTextAreaElement | null>(null);\n const [count, setCount] = useState((value ?? defaultValue ?? \"\").length);\n // Height chosen with the grip: becomes the floor (and lifts the cap) for content-driven sizing.\n const manual = useRef(0);\n const grip = useRef<HTMLSpanElement>(null);\n const dragFrom = useRef({ height: 0, manual: 0 });\n const ref = useCallback(\n (node: HTMLTextAreaElement | null) => {\n inner.current = node;\n if (typeof forwarded === \"function\") forwarded(node);\n else if (forwarded) forwarded.current = node;\n },\n [forwarded],\n );\n\n const resize = useCallback(() => {\n const area = inner.current;\n if (!area) return;\n const cs = getComputedStyle(area);\n const line = Number.parseFloat(cs.lineHeight) || Number.parseFloat(cs.fontSize) * 1.5;\n const chrome =\n Number.parseFloat(cs.paddingTop) +\n Number.parseFloat(cs.paddingBottom) +\n Number.parseFloat(cs.borderTopWidth) +\n Number.parseFloat(cs.borderBottomWidth);\n const min = Math.max(rows * line + chrome, manual.current);\n const max = Math.max(Math.max(rows, maxRows) * line + chrome, manual.current);\n area.style.height = \"auto\";\n const wanted =\n area.scrollHeight + Number.parseFloat(cs.borderTopWidth) + Number.parseFloat(cs.borderBottomWidth);\n const height = Math.min(Math.max(wanted, min), max);\n area.style.height = `${height}px`;\n area.style.overflowY = wanted > max ? \"auto\" : \"hidden\";\n }, [rows, maxRows]);\n\n // The grip drags through detent; Escape puts the height back.\n useDrag(grip, {\n onStart: () => {\n dragFrom.current = {\n height: (inner.current as HTMLTextAreaElement).getBoundingClientRect().height,\n manual: manual.current,\n };\n },\n onMove: ({ delta }) => {\n manual.current = dragFrom.current.height + delta.y;\n resize();\n // Below the row minimum the floor wins: remember what is actually shown.\n manual.current = inner.current?.getBoundingClientRect().height ?? manual.current;\n },\n onEnd: (_, cancelled) => {\n if (!cancelled) return;\n manual.current = dragFrom.current.manual;\n resize();\n },\n });\n\n useLayoutEffect(resize, [resize, value]);\n useEffect(() => {\n if (value !== undefined) setCount(value.length);\n }, [value]);\n useEffect(() => {\n const form = inner.current?.form;\n if (!form) return;\n const onReset = () =>\n requestAnimationFrame(() => {\n setCount(inner.current?.value.length ?? 0);\n resize();\n });\n form.addEventListener(\"reset\", onReset);\n return () => form.removeEventListener(\"reset\", onReset);\n }, [resize]);\n\n return (\n <Field\n label={label}\n labelHidden={labelHidden}\n description={description}\n error={error}\n required={required}\n size={size}\n id={id}\n className={className}\n style={style}\n >\n {(field) => {\n const countId = `${field.id}-count`;\n const describedBy =\n [field.describedBy, showCount ? countId : \"\"].filter(Boolean).join(\" \") || undefined;\n return (\n <div\n className=\"cy-text-area\"\n data-size={size}\n data-variant={variant}\n data-disabled={disabled ? \"\" : undefined}\n >\n <div className=\"cy-text-area-box\">\n <TextAreaBase\n ref={ref}\n {...rest}\n id={field.id}\n className=\"cy-text-area-input\"\n rows={rows}\n maxLength={maxLength}\n required={required}\n disabled={disabled}\n invalid={field.invalid}\n aria-describedby={describedBy}\n {...(value !== undefined ? { value } : { defaultValue })}\n onChange={(e) => {\n setCount(e.currentTarget.value.length);\n resize();\n onChange?.(e.currentTarget.value);\n }}\n />\n {resizable && !disabled && (\n <span ref={grip} className=\"cy-text-area-grip\" aria-hidden=\"true\">\n <Icon icon={resizeCorner} />\n </span>\n )}\n </div>\n {showCount && (\n <span id={countId} className=\"cy-text-area-count\" aria-live=\"polite\">\n {(labels?.count ?? defaultCount)(count, maxLength)}\n </span>\n )}\n </div>\n );\n }}\n </Field>\n );\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"TextArea.js","names":["Icon","Field","useDrag","TextAreaBase","resizeCorner","forwardRef","useCallback","useEffect","useLayoutEffect","useRef","useState","jsx","jsxs","defaultCount","n","max","TextArea","label","labelHidden","description","error","value","defaultValue","onChange","rows","maxRows","resizable","showCount","size","variant","labels","maxLength","required","disabled","id","className","style","rest","forwarded","inner","count","setCount","manual","grip","dragFrom","ref","node","resize","area","cs","line","chrome","min","wanted","height","delta","_","cancelled","form","onReset","field","countId","describedBy","e"],"sources":["../../../src/components/TextArea/TextArea.tsx"],"sourcesContent":["import {\n type CSSProperties,\n forwardRef,\n type ReactNode,\n type TextareaHTMLAttributes,\n useCallback,\n useEffect,\n useLayoutEffect,\n useRef,\n useState,\n} from \"react\";\nimport { useDrag } from \"../../foundations/drag.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { TextAreaBase } from \"../../foundations/TextAreaBase/TextAreaBase.js\";\nimport { resizeCorner } from \"../../icons/resize-corner.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { Field } from \"../Field/Field.js\";\n\nexport interface TextAreaTokens {\n radius: string;\n paddingInline: string;\n paddingBlock: string;\n bg: string;\n border: string;\n softBg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n textArea: TextAreaTokens;\n }\n}\n\ntype NativeArea = Omit<\n TextareaHTMLAttributes<HTMLTextAreaElement>,\n \"value\" | \"defaultValue\" | \"onChange\" | \"rows\" | \"className\" | \"style\" | \"children\"\n>;\n\nexport interface TextAreaProps extends NativeArea {\n /** The field's label and accessible name. */\n label: ReactNode;\n /** Visually hide the label (it still names the control). Prefer visible labels. */\n labelHidden?: boolean | undefined;\n /** Help text shown below the field. */\n description?: ReactNode;\n /** Error message shown below the field; it is announced and marks the field invalid. */\n error?: ReactNode;\n /** The text (controlled). */\n value?: string;\n /** Starting text when uncontrolled. */\n defaultValue?: string;\n /** Called with the new text on every edit. */\n onChange?: (value: string) => void;\n /** Show a corner grip to drag the height (pointer and touch). Content growth still applies. */\n resizable?: boolean;\n /** Minimum visible rows. */\n rows?: number;\n /** Auto-grow cap; content beyond scrolls. */\n maxRows?: number;\n /** Shows a live character counter. */\n showCount?: boolean;\n /** Text size of the field and its label. Default \"md\". */\n size?: Size;\n /** `outline` or `soft` (tinted, borderless until focus). Default \"outline\". */\n variant?: \"outline\" | \"soft\";\n /** Replace the built-in English text: the character counter. */\n labels?: { count?: (count: number, max?: number) => string };\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n}\n\nconst defaultCount = (n: number, max?: number) => (max ? `${n} / ${max}` : `${n} characters`);\n\n/** Multi-line input that grows with its content up to `maxRows`, with an optional announced counter. */\nexport const TextArea = forwardRef<HTMLTextAreaElement, TextAreaProps>(function TextArea(\n {\n label,\n labelHidden,\n description,\n error,\n value,\n defaultValue,\n onChange,\n rows = 3,\n maxRows = 12,\n resizable = true,\n showCount = false,\n size = \"md\",\n variant = \"outline\",\n labels,\n maxLength,\n required,\n disabled,\n id,\n className,\n style,\n ...rest\n },\n forwarded,\n) {\n const inner = useRef<HTMLTextAreaElement | null>(null);\n const [count, setCount] = useState((value ?? defaultValue ?? \"\").length);\n // Height chosen with the grip: becomes the floor (and lifts the cap) for content-driven sizing.\n const manual = useRef(0);\n const grip = useRef<HTMLSpanElement>(null);\n const dragFrom = useRef({ height: 0, manual: 0 });\n const ref = useCallback(\n (node: HTMLTextAreaElement | null) => {\n inner.current = node;\n if (typeof forwarded === \"function\") forwarded(node);\n else if (forwarded) forwarded.current = node;\n },\n [forwarded],\n );\n\n const resize = useCallback(() => {\n const area = inner.current;\n if (!area) return;\n const cs = getComputedStyle(area);\n const line = Number.parseFloat(cs.lineHeight) || Number.parseFloat(cs.fontSize) * 1.5;\n const chrome =\n Number.parseFloat(cs.paddingTop) +\n Number.parseFloat(cs.paddingBottom) +\n Number.parseFloat(cs.borderTopWidth) +\n Number.parseFloat(cs.borderBottomWidth);\n const min = Math.max(rows * line + chrome, manual.current);\n const max = Math.max(Math.max(rows, maxRows) * line + chrome, manual.current);\n area.style.height = \"auto\";\n const wanted =\n area.scrollHeight + Number.parseFloat(cs.borderTopWidth) + Number.parseFloat(cs.borderBottomWidth);\n const height = Math.min(Math.max(wanted, min), max);\n area.style.height = `${height}px`;\n area.style.overflowY = wanted > max ? \"auto\" : \"hidden\";\n }, [rows, maxRows]);\n\n // The grip drags through detent; Escape puts the height back.\n useDrag(grip, {\n onStart: () => {\n dragFrom.current = {\n height: (inner.current as HTMLTextAreaElement).getBoundingClientRect().height,\n manual: manual.current,\n };\n },\n onMove: ({ delta }) => {\n manual.current = dragFrom.current.height + delta.y;\n resize();\n // Below the row minimum the floor wins: remember what is actually shown.\n manual.current = inner.current?.getBoundingClientRect().height ?? manual.current;\n },\n onEnd: (_, cancelled) => {\n if (!cancelled) return;\n manual.current = dragFrom.current.manual;\n resize();\n },\n });\n\n useLayoutEffect(resize, [resize, value]);\n useEffect(() => {\n if (value !== undefined) setCount(value.length);\n }, [value]);\n useEffect(() => {\n const form = inner.current?.form;\n if (!form) return;\n const onReset = () =>\n requestAnimationFrame(() => {\n setCount(inner.current?.value.length ?? 0);\n resize();\n });\n form.addEventListener(\"reset\", onReset);\n return () => form.removeEventListener(\"reset\", onReset);\n }, [resize]);\n\n return (\n <Field\n label={label}\n labelHidden={labelHidden}\n description={description}\n error={error}\n required={required}\n size={size}\n id={id}\n className={className}\n style={style}\n >\n {(field) => {\n const countId = `${field.id}-count`;\n const describedBy =\n [field.describedBy, showCount ? countId : \"\"].filter(Boolean).join(\" \") || undefined;\n return (\n <div\n className=\"cy-text-area\"\n data-size={size}\n data-variant={variant}\n data-disabled={disabled ? \"\" : undefined}\n >\n <div className=\"cy-text-area-box\">\n <TextAreaBase\n ref={ref}\n {...rest}\n id={field.id}\n className=\"cy-text-area-input\"\n rows={rows}\n maxLength={maxLength}\n required={required}\n disabled={disabled}\n invalid={field.invalid}\n aria-describedby={describedBy}\n {...(value !== undefined ? { value } : { defaultValue })}\n onChange={(e) => {\n setCount(e.currentTarget.value.length);\n resize();\n onChange?.(e.currentTarget.value);\n }}\n />\n {resizable && !disabled && (\n <span ref={grip} className=\"cy-text-area-grip\" aria-hidden=\"true\">\n <Icon icon={resizeCorner} />\n </span>\n )}\n </div>\n {showCount && (\n <span id={countId} className=\"cy-text-area-count\" aria-live=\"polite\">\n {(labels?.count ?? defaultCount)(count, maxLength)}\n </span>\n )}\n </div>\n );\n }}\n </Field>\n );\n});\n"],"mappings":"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"}
@@ -18,24 +18,35 @@ declare module "../../tokens/schema.js" {
18
18
  }
19
19
  type NativeInput = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "value" | "defaultValue" | "onChange" | "onSubmit" | "type" | "className" | "style" | "children">;
20
20
  export interface TextFieldProps extends NativeInput {
21
+ /** The field's label and accessible name. */
21
22
  label: ReactNode;
22
23
  /** Visually hide the label (it still names the control). Prefer visible labels. */
23
24
  labelHidden?: boolean | undefined;
25
+ /** Help text shown below the field. */
24
26
  description?: ReactNode;
27
+ /** Error message shown below the field; it is announced and marks the field invalid. */
25
28
  error?: ReactNode;
29
+ /** The text (controlled). */
26
30
  value?: string;
31
+ /** Starting text when uncontrolled. */
27
32
  defaultValue?: string;
33
+ /** Called with the new text on every edit. */
28
34
  onChange?: (value: string) => void;
35
+ /** The native input type. Default "text". */
29
36
  type?: "text" | "email" | "url" | "tel" | "password" | "number" | "search";
37
+ /** Field height and text size. Default "md". */
30
38
  size?: Size;
31
39
  /** `outline` (default) or `soft` (tinted, borderless until focus). */
32
40
  variant?: "outline" | "soft";
41
+ /** Icon shown before the input. */
33
42
  iconStart?: IconData | undefined;
43
+ /** Icon shown at the end of the field, after the input and its clear or reveal button. */
34
44
  iconEnd?: IconData | undefined;
35
45
  /** Shows a clear button while the field has a value. */
36
46
  clearable?: boolean;
37
47
  /** Controls inside the field's end, after the input (NumberField's steppers). */
38
48
  addonEnd?: ReactNode;
49
+ /** Replace the built-in English text: the names of the clear, show and hide buttons. */
39
50
  labels?: {
40
51
  clear?: string;
41
52
  show?: string;
@@ -43,9 +54,11 @@ export interface TextFieldProps extends NativeInput {
43
54
  };
44
55
  /** With `type="password"`: a button to show and hide the value (API keys, tokens, passwords). */
45
56
  revealable?: boolean;
57
+ /** Added to the root element, for layout. */
46
58
  className?: string;
47
59
  /** Layout only. */
48
60
  style?: CSSProperties;
61
+ /** Test id, set on the native input. */
49
62
  "data-testid"?: string;
50
63
  }
51
64
  /** Single-line text input with label, description, error, icons and an optional clear button. */
@@ -2,8 +2,8 @@
2
2
  import { Icon as N } from "../../foundations/Icon/Icon.js";
3
3
  import { IconButton as b } from "../IconButton/IconButton.js";
4
4
  import { close as P } from "../../icons/close.js";
5
- import { InputBase as q } from "../../foundations/InputBase/InputBase.js";
6
- import { Field as G } from "../Field/Field.js";
5
+ import { Field as q } from "../Field/Field.js";
6
+ import { InputBase as G } from "../../foundations/InputBase/InputBase.js";
7
7
  import { eye as J } from "../../icons/eye.js";
8
8
  import { eyeOff as Q } from "../../icons/eye-off.js";
9
9
  import { forwardRef as U, useCallback as V, useEffect as g, useRef as W, useState as w } from "react";
@@ -25,7 +25,7 @@ var Y = (a, l) => {
25
25
  }, [i]), M = () => {
26
26
  r.current && (Y(r.current, ""), r.current.focus());
27
27
  };
28
- return /* @__PURE__ */ n(G, {
28
+ return /* @__PURE__ */ n(q, {
29
29
  label: l,
30
30
  labelHidden: C,
31
31
  description: E,
@@ -46,7 +46,7 @@ var Y = (a, l) => {
46
46
  icon: y,
47
47
  className: "cy-text-field-icon"
48
48
  }),
49
- /* @__PURE__ */ n(q, {
49
+ /* @__PURE__ */ n(G, {
50
50
  ref: K,
51
51
  ...H,
52
52
  id: e.id,
@@ -1 +1 @@
1
- {"version":3,"file":"TextField.js","names":["Icon","IconButton","close","InputBase","Field","eye","eyeOff","forwardRef","useCallback","useEffect","useRef","useState","jsx","jsxs","setNativeValue","input","value","TextField","label","labelHidden","description","error","defaultValue","onChange","type","size","variant","iconStart","iconEnd","clearable","revealable","addonEnd","labels","required","disabled","id","className","style","onKeyDown","rest","forwarded","inner","shown","setShown","secret","filled","setFilled","controlled","form","onReset","ref","node","clear","field","e"],"sources":["../../../src/components/TextField/TextField.tsx"],"sourcesContent":["import {\n type CSSProperties,\n forwardRef,\n type InputHTMLAttributes,\n type KeyboardEvent,\n type ReactNode,\n useCallback,\n useEffect,\n useRef,\n useState,\n} from \"react\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { InputBase } from \"../../foundations/InputBase/InputBase.js\";\nimport { close } from \"../../icons/close.js\";\nimport { eye } from \"../../icons/eye.js\";\nimport { eyeOff } from \"../../icons/eye-off.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { Field } from \"../Field/Field.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\n\nexport interface TextFieldTokens {\n heightSm: string;\n heightMd: string;\n heightLg: string;\n radius: string;\n paddingInline: string;\n bg: string;\n border: string;\n softBg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n textField: TextFieldTokens;\n }\n}\n\ntype NativeInput = Omit<\n InputHTMLAttributes<HTMLInputElement>,\n \"size\" | \"value\" | \"defaultValue\" | \"onChange\" | \"onSubmit\" | \"type\" | \"className\" | \"style\" | \"children\"\n>;\n\nexport interface TextFieldProps extends NativeInput {\n label: ReactNode;\n /** Visually hide the label (it still names the control). Prefer visible labels. */\n labelHidden?: boolean | undefined;\n description?: ReactNode;\n error?: ReactNode;\n value?: string;\n defaultValue?: string;\n onChange?: (value: string) => void;\n type?: \"text\" | \"email\" | \"url\" | \"tel\" | \"password\" | \"number\" | \"search\";\n size?: Size;\n /** `outline` (default) or `soft` (tinted, borderless until focus). */\n variant?: \"outline\" | \"soft\";\n iconStart?: IconData | undefined;\n iconEnd?: IconData | undefined;\n /** Shows a clear button while the field has a value. */\n clearable?: boolean;\n /** Controls inside the field's end, after the input (NumberField's steppers). */\n addonEnd?: ReactNode;\n labels?: { clear?: string; show?: string; hide?: string };\n /** With `type=\"password\"`: a button to show and hide the value (API keys, tokens, passwords). */\n revealable?: boolean;\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n \"data-testid\"?: string;\n}\n\nconst setNativeValue = (input: HTMLInputElement, value: string) => {\n Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, \"value\")?.set?.call(input, value);\n input.dispatchEvent(new Event(\"input\", { bubbles: true }));\n};\n\n/** Single-line text input with label, description, error, icons and an optional clear button. */\nexport const TextField = forwardRef<HTMLInputElement, TextFieldProps>(function TextField(\n {\n label,\n labelHidden,\n description,\n error,\n value,\n defaultValue,\n onChange,\n type = \"text\",\n size = \"md\",\n variant = \"outline\",\n iconStart,\n iconEnd,\n clearable = false,\n revealable = false,\n addonEnd,\n labels,\n required,\n disabled,\n id,\n className,\n style,\n onKeyDown,\n ...rest\n },\n forwarded,\n) {\n const inner = useRef<HTMLInputElement | null>(null);\n const [shown, setShown] = useState(false);\n const secret = type === \"password\" && revealable;\n const [filled, setFilled] = useState(Boolean(value ?? defaultValue));\n const controlled = value !== undefined;\n useEffect(() => {\n if (controlled) setFilled(Boolean(value));\n }, [controlled, value]);\n useEffect(() => {\n const form = inner.current?.form;\n if (!form) return;\n // After the browser restores the default value on reset, sync the clear button.\n const onReset = () => requestAnimationFrame(() => setFilled(Boolean(inner.current?.value)));\n form.addEventListener(\"reset\", onReset);\n return () => form.removeEventListener(\"reset\", onReset);\n }, []);\n const ref = useCallback(\n (node: HTMLInputElement | null) => {\n inner.current = node;\n if (typeof forwarded === \"function\") forwarded(node);\n else if (forwarded) forwarded.current = node;\n },\n [forwarded],\n );\n const clear = () => {\n if (!inner.current) return;\n setNativeValue(inner.current, \"\");\n inner.current.focus();\n };\n\n return (\n <Field\n label={label}\n labelHidden={labelHidden}\n description={description}\n error={error}\n required={required}\n size={size}\n id={id}\n className={className}\n style={style}\n >\n {(field) => (\n <div\n className=\"cy-text-field\"\n data-size={size}\n data-variant={variant}\n data-invalid={field.invalid ? \"\" : undefined}\n data-disabled={disabled ? \"\" : undefined}\n >\n {iconStart && <Icon icon={iconStart} className=\"cy-text-field-icon\" />}\n <InputBase\n ref={ref}\n {...rest}\n id={field.id}\n type={secret && shown ? \"text\" : type}\n className=\"cy-text-field-input\"\n aria-describedby={field.describedBy}\n invalid={field.invalid}\n required={required}\n disabled={disabled}\n {...(controlled ? { value } : { defaultValue })}\n onChange={(e) => {\n setFilled(Boolean(e.currentTarget.value));\n onChange?.(e.currentTarget.value);\n }}\n onKeyDown={(e: KeyboardEvent<HTMLInputElement>) => onKeyDown?.(e)}\n />\n {clearable && filled && !disabled && (\n <IconButton\n icon={close}\n label={labels?.clear ?? \"Clear\"}\n variant=\"ghost\"\n size=\"sm\"\n onClick={clear}\n className=\"cy-text-field-clear\"\n />\n )}\n {secret && !disabled && (\n <IconButton\n icon={shown ? eyeOff : eye}\n label={shown ? (labels?.hide ?? \"Hide\") : (labels?.show ?? \"Show\")}\n aria-pressed={shown}\n variant=\"ghost\"\n size=\"sm\"\n onClick={() => setShown(!shown)}\n className=\"cy-text-field-clear\"\n />\n )}\n {iconEnd && <Icon icon={iconEnd} className=\"cy-text-field-icon\" />}\n {addonEnd}\n </div>\n )}\n </Field>\n );\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"TextField.js","names":["Icon","IconButton","close","Field","InputBase","eye","eyeOff","forwardRef","useCallback","useEffect","useRef","useState","jsx","jsxs","setNativeValue","input","value","TextField","label","labelHidden","description","error","defaultValue","onChange","type","size","variant","iconStart","iconEnd","clearable","revealable","addonEnd","labels","required","disabled","id","className","style","onKeyDown","rest","forwarded","inner","shown","setShown","secret","filled","setFilled","controlled","form","onReset","ref","node","clear","field","e"],"sources":["../../../src/components/TextField/TextField.tsx"],"sourcesContent":["import {\n type CSSProperties,\n forwardRef,\n type InputHTMLAttributes,\n type KeyboardEvent,\n type ReactNode,\n useCallback,\n useEffect,\n useRef,\n useState,\n} from \"react\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { InputBase } from \"../../foundations/InputBase/InputBase.js\";\nimport { close } from \"../../icons/close.js\";\nimport { eye } from \"../../icons/eye.js\";\nimport { eyeOff } from \"../../icons/eye-off.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { Field } from \"../Field/Field.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\n\nexport interface TextFieldTokens {\n heightSm: string;\n heightMd: string;\n heightLg: string;\n radius: string;\n paddingInline: string;\n bg: string;\n border: string;\n softBg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n textField: TextFieldTokens;\n }\n}\n\ntype NativeInput = Omit<\n InputHTMLAttributes<HTMLInputElement>,\n \"size\" | \"value\" | \"defaultValue\" | \"onChange\" | \"onSubmit\" | \"type\" | \"className\" | \"style\" | \"children\"\n>;\n\nexport interface TextFieldProps extends NativeInput {\n /** The field's label and accessible name. */\n label: ReactNode;\n /** Visually hide the label (it still names the control). Prefer visible labels. */\n labelHidden?: boolean | undefined;\n /** Help text shown below the field. */\n description?: ReactNode;\n /** Error message shown below the field; it is announced and marks the field invalid. */\n error?: ReactNode;\n /** The text (controlled). */\n value?: string;\n /** Starting text when uncontrolled. */\n defaultValue?: string;\n /** Called with the new text on every edit. */\n onChange?: (value: string) => void;\n /** The native input type. Default \"text\". */\n type?: \"text\" | \"email\" | \"url\" | \"tel\" | \"password\" | \"number\" | \"search\";\n /** Field height and text size. Default \"md\". */\n size?: Size;\n /** `outline` (default) or `soft` (tinted, borderless until focus). */\n variant?: \"outline\" | \"soft\";\n /** Icon shown before the input. */\n iconStart?: IconData | undefined;\n /** Icon shown at the end of the field, after the input and its clear or reveal button. */\n iconEnd?: IconData | undefined;\n /** Shows a clear button while the field has a value. */\n clearable?: boolean;\n /** Controls inside the field's end, after the input (NumberField's steppers). */\n addonEnd?: ReactNode;\n /** Replace the built-in English text: the names of the clear, show and hide buttons. */\n labels?: { clear?: string; show?: string; hide?: string };\n /** With `type=\"password\"`: a button to show and hide the value (API keys, tokens, passwords). */\n revealable?: boolean;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n /** Test id, set on the native input. */\n \"data-testid\"?: string;\n}\n\nconst setNativeValue = (input: HTMLInputElement, value: string) => {\n Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, \"value\")?.set?.call(input, value);\n input.dispatchEvent(new Event(\"input\", { bubbles: true }));\n};\n\n/** Single-line text input with label, description, error, icons and an optional clear button. */\nexport const TextField = forwardRef<HTMLInputElement, TextFieldProps>(function TextField(\n {\n label,\n labelHidden,\n description,\n error,\n value,\n defaultValue,\n onChange,\n type = \"text\",\n size = \"md\",\n variant = \"outline\",\n iconStart,\n iconEnd,\n clearable = false,\n revealable = false,\n addonEnd,\n labels,\n required,\n disabled,\n id,\n className,\n style,\n onKeyDown,\n ...rest\n },\n forwarded,\n) {\n const inner = useRef<HTMLInputElement | null>(null);\n const [shown, setShown] = useState(false);\n const secret = type === \"password\" && revealable;\n const [filled, setFilled] = useState(Boolean(value ?? defaultValue));\n const controlled = value !== undefined;\n useEffect(() => {\n if (controlled) setFilled(Boolean(value));\n }, [controlled, value]);\n useEffect(() => {\n const form = inner.current?.form;\n if (!form) return;\n // After the browser restores the default value on reset, sync the clear button.\n const onReset = () => requestAnimationFrame(() => setFilled(Boolean(inner.current?.value)));\n form.addEventListener(\"reset\", onReset);\n return () => form.removeEventListener(\"reset\", onReset);\n }, []);\n const ref = useCallback(\n (node: HTMLInputElement | null) => {\n inner.current = node;\n if (typeof forwarded === \"function\") forwarded(node);\n else if (forwarded) forwarded.current = node;\n },\n [forwarded],\n );\n const clear = () => {\n if (!inner.current) return;\n setNativeValue(inner.current, \"\");\n inner.current.focus();\n };\n\n return (\n <Field\n label={label}\n labelHidden={labelHidden}\n description={description}\n error={error}\n required={required}\n size={size}\n id={id}\n className={className}\n style={style}\n >\n {(field) => (\n <div\n className=\"cy-text-field\"\n data-size={size}\n data-variant={variant}\n data-invalid={field.invalid ? \"\" : undefined}\n data-disabled={disabled ? \"\" : undefined}\n >\n {iconStart && <Icon icon={iconStart} className=\"cy-text-field-icon\" />}\n <InputBase\n ref={ref}\n {...rest}\n id={field.id}\n type={secret && shown ? \"text\" : type}\n className=\"cy-text-field-input\"\n aria-describedby={field.describedBy}\n invalid={field.invalid}\n required={required}\n disabled={disabled}\n {...(controlled ? { value } : { defaultValue })}\n onChange={(e) => {\n setFilled(Boolean(e.currentTarget.value));\n onChange?.(e.currentTarget.value);\n }}\n onKeyDown={(e: KeyboardEvent<HTMLInputElement>) => onKeyDown?.(e)}\n />\n {clearable && filled && !disabled && (\n <IconButton\n icon={close}\n label={labels?.clear ?? \"Clear\"}\n variant=\"ghost\"\n size=\"sm\"\n onClick={clear}\n className=\"cy-text-field-clear\"\n />\n )}\n {secret && !disabled && (\n <IconButton\n icon={shown ? eyeOff : eye}\n label={shown ? (labels?.hide ?? \"Hide\") : (labels?.show ?? \"Show\")}\n aria-pressed={shown}\n variant=\"ghost\"\n size=\"sm\"\n onClick={() => setShown(!shown)}\n className=\"cy-text-field-clear\"\n />\n )}\n {iconEnd && <Icon icon={iconEnd} className=\"cy-text-field-icon\" />}\n {addonEnd}\n </div>\n )}\n </Field>\n );\n});\n"],"mappings":"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"}
@@ -4,15 +4,18 @@ import type { Size } from "../../tokens/schema.js";
4
4
  export interface ThemeToggleProps {
5
5
  /** Controlled mode; omit to manage and persist it internally. */
6
6
  value?: ColorMode;
7
+ /** Called with the mode the person picks. */
7
8
  onChange?: (mode: ColorMode) => void;
8
9
  /** Persistence for uncontrolled use (localStorage by default; chrome.storage works too). */
9
10
  storage?: ColorModeStorage;
11
+ /** Size of the control. Default "md". */
10
12
  size?: Size;
11
13
  /**
12
14
  * `segmented` (default): three choices side by side. `cycle`: one icon button that steps light → dark → system
13
15
  * (for tight headers); its name says the current mode and the next one ("Colour mode: Light. Switch to Dark").
14
16
  */
15
17
  variant?: "segmented" | "cycle";
18
+ /** Replace the built-in English text: the control's name and the names of the three modes. */
16
19
  labels?: {
17
20
  label?: string;
18
21
  light?: string;
@@ -21,6 +24,7 @@ export interface ThemeToggleProps {
21
24
  /** The cycle button's name. Default "Colour mode: Light. Switch to Dark". */
22
25
  cycle?: (current: string, next: string) => string;
23
26
  };
27
+ /** Added to the control, for layout. */
24
28
  className?: string;
25
29
  /** Layout only. */
26
30
  style?: CSSProperties;
@@ -1 +1 @@
1
- {"version":3,"file":"ThemeToggle.js","names":["IconButton","SegmentedControl","monitor","moon","sun","useColorMode","jsx","ThemeToggle","value","onChange","storage","size","variant","labels","className","style","color","mode","set","next","order","names","icons","name","c","n"],"sources":["../../../src/components/ThemeToggle/ThemeToggle.tsx"],"sourcesContent":["import type { CSSProperties } from \"react\";\nimport { monitor } from \"../../icons/monitor.js\";\nimport { moon } from \"../../icons/moon.js\";\nimport { sun } from \"../../icons/sun.js\";\nimport { type ColorMode, type ColorModeStorage, useColorMode } from \"../../theme/use-color-mode.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\nimport { SegmentedControl } from \"../SegmentedControl/SegmentedControl.js\";\n\nexport interface ThemeToggleProps {\n /** Controlled mode; omit to manage and persist it internally. */\n value?: ColorMode;\n onChange?: (mode: ColorMode) => void;\n /** Persistence for uncontrolled use (localStorage by default; chrome.storage works too). */\n storage?: ColorModeStorage;\n size?: Size;\n /**\n * `segmented` (default): three choices side by side. `cycle`: one icon button that steps light → dark → system\n * (for tight headers); its name says the current mode and the next one (\"Colour mode: Light. Switch to Dark\").\n */\n variant?: \"segmented\" | \"cycle\";\n labels?: {\n label?: string;\n light?: string;\n dark?: string;\n system?: string;\n /** The cycle button's name. Default \"Colour mode: Light. Switch to Dark\". */\n cycle?: (current: string, next: string) => string;\n };\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n}\n\n/** Light / dark / system switch: a SegmentedControl with Facet icons. Pair with `<CynosureTheme mode={…}>`. */\nexport function ThemeToggle({\n value,\n onChange,\n storage,\n size = \"md\",\n variant = \"segmented\",\n labels,\n className,\n style,\n}: ThemeToggleProps) {\n const color = useColorMode(storage ? { storage } : {});\n const mode = value ?? color.mode;\n const set = (next: ColorMode) => {\n if (value === undefined) color.setMode(next);\n onChange?.(next);\n };\n if (variant === \"cycle\") {\n const order: ColorMode[] = [\"light\", \"dark\", \"system\"];\n const names = {\n light: labels?.light ?? \"Light\",\n dark: labels?.dark ?? \"Dark\",\n system: labels?.system ?? \"System\",\n };\n const icons = { light: sun, dark: moon, system: monitor };\n const next = order[(order.indexOf(mode) + 1) % order.length] as ColorMode;\n const name = (labels?.cycle ?? ((c, n) => `${labels?.label ?? \"Colour mode\"}: ${c}. Switch to ${n}`))(\n names[mode],\n names[next],\n );\n return (\n <IconButton\n icon={icons[mode]}\n label={name}\n variant=\"ghost\"\n size={size}\n className={className ? `cy-theme-toggle-cycle ${className}` : \"cy-theme-toggle-cycle\"}\n {...(style ? { style } : {})}\n onClick={() => set(next)}\n />\n );\n }\n return (\n <SegmentedControl\n label={labels?.label ?? \"Colour mode\"}\n iconOnly\n size={size}\n className={className}\n style={style}\n value={mode}\n onChange={(next) => set(next as ColorMode)}\n options={[\n { value: \"light\", label: labels?.light ?? \"Light\", icon: sun },\n { value: \"dark\", label: labels?.dark ?? \"Dark\", icon: moon },\n { value: \"system\", label: labels?.system ?? \"System\", icon: monitor },\n ]}\n />\n );\n}\n"],"mappings":";;;;;;;;AAmCA,SAAgBO,EAAY,EAC1B,OAAAC,GACA,UAAAC,GACA,SAAAC,GACA,MAAAC,IAAO,MACP,SAAAC,IAAU,aACV,QAAAC,GACA,WAAAC,GACA,OAAAC,EAAA,GACmB;AACnB,QAAMC,IAAQX,EAAaK,IAAU,EAAE,SAAAA,EAAQ,IAAI,CAAC,CAAC,GAC/CO,IAAOT,KAASQ,EAAM,MACtBE,IAAA,CAAOC,MAAoB;AAC/B,IAAIX,MAAU,UAAWQ,EAAM,QAAQG,CAAI,GAC3CV,IAAWU,CAAI;AAAA,EACjB;AACA,MAAIP,MAAY,SAAS;AACvB,UAAMQ,IAAqB;AAAA,MAAC;AAAA,MAAS;AAAA,MAAQ;AAAA,IAAQ,GAC/CC,IAAQ;AAAA,MACZ,OAAOR,GAAQ,SAAS;AAAA,MACxB,MAAMA,GAAQ,QAAQ;AAAA,MACtB,QAAQA,GAAQ,UAAU;AAAA,IAC5B,GACMS,IAAQ;AAAA,MAAE,OAAOlB;AAAA,MAAK,MAAMD;AAAA,MAAM,QAAQD;AAAA,IAAQ,GAClDiB,IAAOC,GAAOA,EAAM,QAAQH,CAAI,IAAI,KAAKG,EAAM,MAAA,GAC/CG,KAAQV,GAAQ,UAAA,CAAWW,GAAGC,MAAM,GAAGZ,GAAQ,SAAS,aAAA,KAAkBW,CAAA,eAAgBC,CAAA,KAC9FJ,EAAMJ,CAAA,GACNI,EAAMF,CAAA,CACR;AACA,WACE,gBAAAb,EAACN,GAAD;AAAA,MACE,MAAMsB,EAAML,CAAA;AAAA,MACZ,OAAOM;AAAA,MACP,SAAQ;AAAA,MACF,MAAAZ;AAAA,MACN,WAAWG,IAAY,yBAAyBA,CAAA,KAAc;AAAA,MAC9D,GAAKC,IAAQ,EAAE,OAAAA,EAAM,IAAI,CAAC;AAAA,MAC1B,SAAA,MAAeG,EAAIC,CAAI;AAAA,IACxB,CAAA;AAAA,EAEL;AACA,SACE,gBAAAb,EAACL,GAAD;AAAA,IACE,OAAOY,GAAQ,SAAS;AAAA,IACxB,UAAA;AAAA,IACM,MAAAF;AAAA,IACK,WAAAG;AAAA,IACJ,OAAAC;AAAA,IACP,OAAOE;AAAA,IACP,UAAA,CAAWE,MAASD,EAAIC,CAAiB;AAAA,IACzC,SAAS;AAAA,MACP;AAAA,QAAE,OAAO;AAAA,QAAS,OAAON,GAAQ,SAAS;AAAA,QAAS,MAAMT;AAAA,MAAI;AAAA,MAC7D;AAAA,QAAE,OAAO;AAAA,QAAQ,OAAOS,GAAQ,QAAQ;AAAA,QAAQ,MAAMV;AAAA,MAAK;AAAA,MAC3D;AAAA,QAAE,OAAO;AAAA,QAAU,OAAOU,GAAQ,UAAU;AAAA,QAAU,MAAMX;AAAA,MAAQ;AAAA,IACtE;AAAA,EACD,CAAA;AAEL"}
1
+ {"version":3,"file":"ThemeToggle.js","names":["IconButton","SegmentedControl","monitor","moon","sun","useColorMode","jsx","ThemeToggle","value","onChange","storage","size","variant","labels","className","style","color","mode","set","next","order","names","icons","name","c","n"],"sources":["../../../src/components/ThemeToggle/ThemeToggle.tsx"],"sourcesContent":["import type { CSSProperties } from \"react\";\nimport { monitor } from \"../../icons/monitor.js\";\nimport { moon } from \"../../icons/moon.js\";\nimport { sun } from \"../../icons/sun.js\";\nimport { type ColorMode, type ColorModeStorage, useColorMode } from \"../../theme/use-color-mode.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\nimport { SegmentedControl } from \"../SegmentedControl/SegmentedControl.js\";\n\nexport interface ThemeToggleProps {\n /** Controlled mode; omit to manage and persist it internally. */\n value?: ColorMode;\n /** Called with the mode the person picks. */\n onChange?: (mode: ColorMode) => void;\n /** Persistence for uncontrolled use (localStorage by default; chrome.storage works too). */\n storage?: ColorModeStorage;\n /** Size of the control. Default \"md\". */\n size?: Size;\n /**\n * `segmented` (default): three choices side by side. `cycle`: one icon button that steps light → dark → system\n * (for tight headers); its name says the current mode and the next one (\"Colour mode: Light. Switch to Dark\").\n */\n variant?: \"segmented\" | \"cycle\";\n /** Replace the built-in English text: the control's name and the names of the three modes. */\n labels?: {\n label?: string;\n light?: string;\n dark?: string;\n system?: string;\n /** The cycle button's name. Default \"Colour mode: Light. Switch to Dark\". */\n cycle?: (current: string, next: string) => string;\n };\n /** Added to the control, for layout. */\n className?: string;\n /** Layout only. */\n style?: CSSProperties;\n}\n\n/** Light / dark / system switch: a SegmentedControl with Facet icons. Pair with `<CynosureTheme mode={…}>`. */\nexport function ThemeToggle({\n value,\n onChange,\n storage,\n size = \"md\",\n variant = \"segmented\",\n labels,\n className,\n style,\n}: ThemeToggleProps) {\n const color = useColorMode(storage ? { storage } : {});\n const mode = value ?? color.mode;\n const set = (next: ColorMode) => {\n if (value === undefined) color.setMode(next);\n onChange?.(next);\n };\n if (variant === \"cycle\") {\n const order: ColorMode[] = [\"light\", \"dark\", \"system\"];\n const names = {\n light: labels?.light ?? \"Light\",\n dark: labels?.dark ?? \"Dark\",\n system: labels?.system ?? \"System\",\n };\n const icons = { light: sun, dark: moon, system: monitor };\n const next = order[(order.indexOf(mode) + 1) % order.length] as ColorMode;\n const name = (labels?.cycle ?? ((c, n) => `${labels?.label ?? \"Colour mode\"}: ${c}. Switch to ${n}`))(\n names[mode],\n names[next],\n );\n return (\n <IconButton\n icon={icons[mode]}\n label={name}\n variant=\"ghost\"\n size={size}\n className={className ? `cy-theme-toggle-cycle ${className}` : \"cy-theme-toggle-cycle\"}\n {...(style ? { style } : {})}\n onClick={() => set(next)}\n />\n );\n }\n return (\n <SegmentedControl\n label={labels?.label ?? \"Colour mode\"}\n iconOnly\n size={size}\n className={className}\n style={style}\n value={mode}\n onChange={(next) => set(next as ColorMode)}\n options={[\n { value: \"light\", label: labels?.light ?? \"Light\", icon: sun },\n { value: \"dark\", label: labels?.dark ?? \"Dark\", icon: moon },\n { value: \"system\", label: labels?.system ?? \"System\", icon: monitor },\n ]}\n />\n );\n}\n"],"mappings":";;;;;;;;AAuCA,SAAgBO,EAAY,EAC1B,OAAAC,GACA,UAAAC,GACA,SAAAC,GACA,MAAAC,IAAO,MACP,SAAAC,IAAU,aACV,QAAAC,GACA,WAAAC,GACA,OAAAC,EAAA,GACmB;AACnB,QAAMC,IAAQX,EAAaK,IAAU,EAAE,SAAAA,EAAQ,IAAI,CAAC,CAAC,GAC/CO,IAAOT,KAASQ,EAAM,MACtBE,IAAA,CAAOC,MAAoB;AAC/B,IAAIX,MAAU,UAAWQ,EAAM,QAAQG,CAAI,GAC3CV,IAAWU,CAAI;AAAA,EACjB;AACA,MAAIP,MAAY,SAAS;AACvB,UAAMQ,IAAqB;AAAA,MAAC;AAAA,MAAS;AAAA,MAAQ;AAAA,IAAQ,GAC/CC,IAAQ;AAAA,MACZ,OAAOR,GAAQ,SAAS;AAAA,MACxB,MAAMA,GAAQ,QAAQ;AAAA,MACtB,QAAQA,GAAQ,UAAU;AAAA,IAC5B,GACMS,IAAQ;AAAA,MAAE,OAAOlB;AAAA,MAAK,MAAMD;AAAA,MAAM,QAAQD;AAAA,IAAQ,GAClDiB,IAAOC,GAAOA,EAAM,QAAQH,CAAI,IAAI,KAAKG,EAAM,MAAA,GAC/CG,KAAQV,GAAQ,UAAA,CAAWW,GAAGC,MAAM,GAAGZ,GAAQ,SAAS,aAAA,KAAkBW,CAAA,eAAgBC,CAAA,KAC9FJ,EAAMJ,CAAA,GACNI,EAAMF,CAAA,CACR;AACA,WACE,gBAAAb,EAACN,GAAD;AAAA,MACE,MAAMsB,EAAML,CAAA;AAAA,MACZ,OAAOM;AAAA,MACP,SAAQ;AAAA,MACF,MAAAZ;AAAA,MACN,WAAWG,IAAY,yBAAyBA,CAAA,KAAc;AAAA,MAC9D,GAAKC,IAAQ,EAAE,OAAAA,EAAM,IAAI,CAAC;AAAA,MAC1B,SAAA,MAAeG,EAAIC,CAAI;AAAA,IACxB,CAAA;AAAA,EAEL;AACA,SACE,gBAAAb,EAACL,GAAD;AAAA,IACE,OAAOY,GAAQ,SAAS;AAAA,IACxB,UAAA;AAAA,IACM,MAAAF;AAAA,IACK,WAAAG;AAAA,IACJ,OAAAC;AAAA,IACP,OAAOE;AAAA,IACP,UAAA,CAAWE,MAASD,EAAIC,CAAiB;AAAA,IACzC,SAAS;AAAA,MACP;AAAA,QAAE,OAAO;AAAA,QAAS,OAAON,GAAQ,SAAS;AAAA,QAAS,MAAMT;AAAA,MAAI;AAAA,MAC7D;AAAA,QAAE,OAAO;AAAA,QAAQ,OAAOS,GAAQ,QAAQ;AAAA,QAAQ,MAAMV;AAAA,MAAK;AAAA,MAC3D;AAAA,QAAE,OAAO;AAAA,QAAU,OAAOU,GAAQ,UAAU;AAAA,QAAU,MAAMX;AAAA,MAAQ;AAAA,IACtE;AAAA,EACD,CAAA;AAEL"}
@@ -1,36 +1,89 @@
1
1
  import { type CSSProperties, type ReactNode } from "react";
2
2
  import type { Size } from "../../tokens/schema.js";
3
+ export interface TimeFieldTokens {
4
+ rowHeight: string;
5
+ columnWidth: string;
6
+ lensBackground: string;
7
+ night: string;
8
+ day: string;
9
+ }
10
+ declare module "../../tokens/schema.js" {
11
+ interface ComponentTokens {
12
+ timeField: TimeFieldTokens;
13
+ }
14
+ }
3
15
  export interface TimeFieldLabels {
4
- /** Shown when the text is not a time. Default "Enter a time as HH:MM" (or HH:MM:SS with `seconds`). */
16
+ /** Shown when the text is not a time. Default "Enter a time as HH:MM" (the field's own placeholder). */
5
17
  invalid: string;
6
18
  /** Shown when the time is outside `min` and `max`. Default "This time is not available". */
7
19
  unavailable: string;
20
+ /** The button that opens the picker, and the picker's name. Default "Choose a time". */
21
+ open: string;
22
+ /** The picker's columns. Defaults "Hours", "Minutes" and "Seconds". */
23
+ hours: string;
24
+ minutes: string;
25
+ seconds: string;
26
+ /** The two halves of the day with `hourCycle={12}`, and the name of their switch. Defaults "AM", "PM", "AM or PM". */
27
+ am: string;
28
+ pm: string;
29
+ period: string;
30
+ /** The strip of the whole day under the columns. Default "Time of day". */
31
+ dayTrack: string;
32
+ /** The button that sets the current time. Default "Now". */
33
+ now: string;
8
34
  }
9
35
  export interface TimeFieldProps {
36
+ /** The field's visible label, and its accessible name. */
10
37
  label: ReactNode;
38
+ /** Hide the label visually; it still names the field. */
11
39
  labelHidden?: boolean;
40
+ /** Help text under the field, read with it by screen readers. */
12
41
  description?: ReactNode;
13
42
  /** Your own error; it replaces the field's own messages. */
14
43
  error?: ReactNode;
15
- /** `HH:MM` (or `HH:MM:SS` with `seconds`), 24-hour, or null when empty. */
44
+ /** `HH:MM` (or `HH:MM:SS` with `seconds`), 24-hour whatever `hourCycle` shows, or null when empty. */
16
45
  value?: string | null;
46
+ /** The starting time when `value` is not given, in the same form. */
17
47
  defaultValue?: string | null;
18
- /** A valid time (or null when cleared), when typing is finished or the arrows step it. */
48
+ /** A valid time (or null when cleared), when typing is finished, the arrows step it or the picker chooses it. */
19
49
  onChange?: (time: string | null) => void;
20
- /** Earliest and latest times, in the same form. */
50
+ /** The earliest time allowed, in the same form. Earlier times are explained and not reported. */
21
51
  min?: string | undefined;
52
+ /** The latest time allowed, in the same form. Later times are explained and not reported. */
22
53
  max?: string | undefined;
23
- /** Minutes the arrows move the minutes by. Default 1 (Shift: ten steps). */
54
+ /** Minutes between the picker's minutes, and what the arrows move the minutes by. Default 1 (Shift: ten steps). */
24
55
  step?: number;
25
56
  /** Include seconds. */
26
57
  seconds?: boolean;
58
+ /**
59
+ * How the time is shown: `24` as `21:30`, `12` as `9:30 PM` (with an AM/PM switch in the picker), or `"auto"` to
60
+ * follow the person's own language and region. The value is 24-hour either way. Default "auto".
61
+ */
62
+ hourCycle?: 12 | 24 | "auto";
63
+ /** The language and region `hourCycle="auto"` follows, such as `en-GB`. Default: the browser's. */
64
+ locale?: string | undefined;
65
+ /**
66
+ * Add a clock button that opens a picker: columns for hours and minutes that roll under one lens. Without it the
67
+ * field is only typed in.
68
+ */
69
+ picker?: boolean;
70
+ /** With `picker`: the strip of the whole day under the columns, to click or drag to a time. Default `true`. */
71
+ dayTrack?: boolean;
72
+ /** Form field name. The form receives the 24-hour `HH:MM`, however the time is shown. */
27
73
  name?: string | undefined;
74
+ /** The `id` of a form elsewhere on the page that the field belongs to. */
28
75
  form?: string | undefined;
76
+ /** The form cannot be submitted while the field is empty. */
29
77
  required?: boolean | undefined;
78
+ /** Cannot be focused, changed or submitted. */
30
79
  disabled?: boolean | undefined;
80
+ /** Shown and submitted but not changed: no typing, no arrows and no picker button. */
31
81
  readOnly?: boolean | undefined;
82
+ /** Height and text size of the field. Default "md". */
32
83
  size?: Size;
84
+ /** Replace the built-in English text: the two messages and the picker's names. */
33
85
  labels?: Partial<TimeFieldLabels>;
86
+ /** Added to the root element, for layout. */
34
87
  className?: string;
35
88
  /** Layout only. */
36
89
  style?: CSSProperties;
@@ -43,7 +96,8 @@ export declare function parseTime(text: string): number | null;
43
96
  /** `HH:MM` (or `HH:MM:SS`) from seconds since midnight. */
44
97
  export declare const formatTime: (total: number, seconds?: boolean) => string;
45
98
  /**
46
- * A time of day in a form, typed in 24-hour `HH:MM`. Forgiving as it reads (`930`, `9:30 pm`), strict in what it
47
- * reports, and Up/Down step the hours, minutes or seconds the caret is in.
99
+ * A time of day in a form: type it, step it with the arrows, or pick it from columns that roll under a lens, with a
100
+ * strip of the whole day to jump along. Forgiving as it reads (`930`, `9:30 pm`), strict in what it reports: always
101
+ * 24-hour `HH:MM`, however it is shown.
48
102
  */
49
- export declare function TimeField({ label, labelHidden, description, error, value, defaultValue, onChange, min, max, step, seconds, name, form, required, disabled, readOnly, size, labels, className, style, }: TimeFieldProps): import("react").JSX.Element;
103
+ export declare function TimeField({ label, labelHidden, description, error, value, defaultValue, onChange, min, max, step, seconds, hourCycle, locale, picker, dayTrack, name, form, required, disabled, readOnly, size, labels, className, style, }: TimeFieldProps): import("react").JSX.Element;