@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
@@ -23,29 +23,47 @@ export interface TagInputLabels {
23
23
  empty: string;
24
24
  }
25
25
  export interface TagInputProps {
26
+ /** The field's label and accessible name. */
26
27
  label: ReactNode;
28
+ /** Visually hide the label (it still names the control). Prefer visible labels. */
27
29
  labelHidden?: boolean | undefined;
30
+ /** Help text shown below the field. */
28
31
  description?: ReactNode;
32
+ /** Your own error; it replaces the field's own messages. */
29
33
  error?: ReactNode;
34
+ /** The tags (controlled). */
30
35
  value?: string[] | undefined;
36
+ /** Starting tags when uncontrolled. */
31
37
  defaultValue?: string[];
38
+ /** Called with the full list of tags whenever one is added or removed. */
32
39
  onChange?: ((tags: string[]) => void) | undefined;
33
40
  /** Offered while typing (and with Arrow Down). Free text is still allowed. */
34
41
  suggestions?: string[] | undefined;
35
42
  /** Typing one of these adds the text as a tag (Enter always does). Pasted text is split on them. Default: [","]. */
36
43
  separators?: string[];
44
+ /** Allows the same tag more than once. Otherwise a tag already in the list (ignoring case) is refused. */
37
45
  allowDuplicates?: boolean;
46
+ /** The most tags allowed; more are refused with a message. */
38
47
  maxTags?: number | undefined;
39
48
  /** Return a message to refuse a tag (shown as the field's error), or null to accept it. */
40
49
  validate?: ((tag: string, tags: string[]) => string | null) | undefined;
50
+ /** Form field name; each tag is submitted as its own value under it. */
41
51
  name?: string | undefined;
52
+ /** `id` of the form the tags are submitted with, when the field sits outside it. */
42
53
  form?: string | undefined;
54
+ /** The form cannot be submitted while there are no tags. */
43
55
  required?: boolean | undefined;
56
+ /** Blocks typing and removing tags, and leaves the tags out of the form submission. */
44
57
  disabled?: boolean | undefined;
58
+ /** Hint shown in the input while nothing is typed. */
45
59
  placeholder?: string | undefined;
60
+ /** Field height and text size. Default "md". */
46
61
  size?: Size;
62
+ /** `outline` or `soft` (tinted, borderless until focus). Default "outline". */
47
63
  variant?: "outline" | "soft";
64
+ /** Replace the built-in English text: the tag list's name, the remove buttons, announcements and refusals. */
48
65
  labels?: Partial<TagInputLabels>;
66
+ /** Added to the root element, for layout. */
49
67
  className?: string;
50
68
  /** Layout only. Restyle through --cy-tag-input-* tokens. */
51
69
  style?: CSSProperties;
@@ -2,10 +2,10 @@
2
2
  import { useControllableState as ie } from "../../foundations/controllable.js";
3
3
  import { IconButton as ue } from "../IconButton/IconButton.js";
4
4
  import { close as fe } from "../../icons/close.js";
5
- import { HiddenValue as F } from "../../foundations/HiddenValue/HiddenValue.js";
6
5
  import { isComposing as pe } from "../../foundations/keys.js";
7
- import { useListboxLayer as me } from "../../overlay/listbox-layer.js";
8
- import { TextField as de } from "../TextField/TextField.js";
6
+ import { TextField as me } from "../TextField/TextField.js";
7
+ import { HiddenValue as F } from "../../foundations/HiddenValue/HiddenValue.js";
8
+ import { useListboxLayer as de } from "../../overlay/listbox-layer.js";
9
9
  import { useEffect as he, useId as ye, useLayoutEffect as ge, useRef as $, useState as h } from "react";
10
10
  import { jsx as n, jsxs as O } from "react/jsx-runtime";
11
11
  var ve = {
@@ -41,7 +41,7 @@ function Me({ label: a, labelHidden: _, description: z, error: H, value: G, defa
41
41
  `].reduce((t, o) => t.flatMap((s) => s.split(o)), [e]);
42
42
  ge(() => {
43
43
  P.current = D.current?.closest(".cy-text-field") ?? null;
44
- }), me({
44
+ }), de({
45
45
  anchor: P,
46
46
  list: R,
47
47
  open: m,
@@ -103,7 +103,7 @@ function Me({ label: a, labelHidden: _, description: z, error: H, value: G, defa
103
103
  "data-size": T,
104
104
  style: te,
105
105
  children: [
106
- /* @__PURE__ */ n(de, {
106
+ /* @__PURE__ */ n(me, {
107
107
  ref: D,
108
108
  label: a,
109
109
  labelHidden: _,
@@ -1 +1 @@
1
- {"version":3,"file":"TagInput.js","names":["useControllableState","IconButton","close","HiddenValue","isComposing","useListboxLayer","TextField","useEffect","useId","useLayoutEffect","useRef","useState","jsx","jsxs","DEFAULT_LABELS","tag","max","TagInput","label","labelHidden","description","error","value","defaultValue","onChange","suggestions","separators","allowDuplicates","maxTags","validate","name","form","required","disabled","placeholder","size","variant","labels","className","style","text","listId","tags","update","resetTags","typed","setTyped","problem","setProblem","said","setSaid","open","setOpen","active","setActive","input","anchor","list","chips","same","a","b","query","matches","s","listOpen","add","candidates","next","issue","raw","t","refusal","remove","index","_","i","commitTyped","split","parts","sep","p","removeButtons","onKeyDown","event","el","pick","onTagKeyDown","buttons","toInput","left","pasted","e"],"sources":["../../../src/components/TagInput/TagInput.tsx"],"sourcesContent":["import {\n type ClipboardEvent,\n type CSSProperties,\n type KeyboardEvent,\n type ReactNode,\n useEffect,\n useId,\n useLayoutEffect,\n useRef,\n useState,\n} from \"react\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { HiddenValue } from \"../../foundations/HiddenValue/HiddenValue.js\";\nimport { isComposing } from \"../../foundations/keys.js\";\nimport { close } from \"../../icons/close.js\";\nimport { useListboxLayer } from \"../../overlay/listbox-layer.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\nimport { TextField } from \"../TextField/TextField.js\";\n\nexport interface TagInputTokens {\n /** Background of a tag. */\n tagBackground: string;\n /** Corner radius of a tag. */\n tagRadius: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n tagInput: TagInputTokens;\n }\n}\n\nexport interface TagInputLabels {\n /** Name of the list of tags. Default: \"Tags\". */\n tags: string;\n remove: (tag: string) => string;\n added: (tag: string) => string;\n removed: (tag: string) => string;\n duplicate: (tag: string) => string;\n tooMany: (max: number) => string;\n /** Shown in the suggestion list when nothing matches. Default: \"No suggestions\". */\n empty: string;\n}\n\nexport interface TagInputProps {\n label: ReactNode;\n labelHidden?: boolean | undefined;\n description?: ReactNode;\n error?: ReactNode;\n value?: string[] | undefined;\n defaultValue?: string[];\n onChange?: ((tags: string[]) => void) | undefined;\n /** Offered while typing (and with Arrow Down). Free text is still allowed. */\n suggestions?: string[] | undefined;\n /** Typing one of these adds the text as a tag (Enter always does). Pasted text is split on them. Default: [\",\"]. */\n separators?: string[];\n allowDuplicates?: boolean;\n maxTags?: number | undefined;\n /** Return a message to refuse a tag (shown as the field's error), or null to accept it. */\n validate?: ((tag: string, tags: string[]) => string | null) | undefined;\n name?: string | undefined;\n form?: string | undefined;\n required?: boolean | undefined;\n disabled?: boolean | undefined;\n placeholder?: string | undefined;\n size?: Size;\n variant?: \"outline\" | \"soft\";\n labels?: Partial<TagInputLabels>;\n className?: string;\n /** Layout only. Restyle through --cy-tag-input-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: TagInputLabels = {\n tags: \"Tags\",\n remove: (tag) => `Remove ${tag}`,\n added: (tag) => `${tag} added`,\n removed: (tag) => `${tag} removed`,\n duplicate: (tag) => `${tag} is already added`,\n tooMany: (max) => `Up to ${max} tags`,\n empty: \"No suggestions\",\n};\n\n/**\n * Several short values in one field: type and press Enter (or a comma), pick a suggestion, or paste a list. Tags can\n * be removed with their buttons, Backspace, or the arrow keys. Each tag is submitted under `name`.\n */\nexport function TagInput({\n label,\n labelHidden,\n description,\n error,\n value,\n defaultValue = [],\n onChange,\n suggestions,\n separators = [\",\"],\n allowDuplicates = false,\n maxTags,\n validate,\n name,\n form,\n required,\n disabled,\n placeholder,\n size = \"md\",\n variant = \"outline\",\n labels,\n className,\n style,\n}: TagInputProps) {\n const text = { ...DEFAULT_LABELS, ...labels };\n const id = useId();\n const listId = `${id}-list`;\n const [tags, update, resetTags] = useControllableState(value, defaultValue, onChange);\n const [typed, setTyped] = useState(\"\");\n const [problem, setProblem] = useState<string | null>(null);\n const [said, setSaid] = useState(\"\");\n const [open, setOpen] = useState(false);\n const [active, setActive] = useState(0);\n const input = useRef<HTMLInputElement>(null);\n const anchor = useRef<HTMLElement | null>(null);\n const list = useRef<HTMLDivElement>(null);\n const chips = useRef<HTMLUListElement>(null);\n\n const same = (a: string, b: string) => a.toLocaleLowerCase() === b.toLocaleLowerCase();\n const query = typed.trim();\n const matches = (suggestions ?? []).filter(\n (s) => !tags.some((t) => same(t, s)) && s.toLocaleLowerCase().includes(query.toLocaleLowerCase()),\n );\n const listOpen = open && suggestions !== undefined && !disabled;\n\n /** Adds each candidate that passes the checks; reports the first problem. Returns whether all were added. */\n const add = (candidates: string[]) => {\n let next = [...tags];\n let issue: string | null = null;\n for (const raw of candidates) {\n const tag = raw.trim();\n if (!tag) continue;\n if (!allowDuplicates && next.some((t) => same(t, tag))) issue ??= text.duplicate(tag);\n else if (maxTags !== undefined && next.length >= maxTags) issue ??= text.tooMany(maxTags);\n else {\n const refusal = validate?.(tag, next) ?? null;\n if (refusal) issue ??= refusal;\n else next = [...next, tag];\n }\n }\n setProblem(issue);\n if (next.length !== tags.length) {\n setSaid(text.added(next.slice(tags.length).join(\", \")));\n update(next);\n }\n return issue === null;\n };\n\n const remove = (index: number) => {\n const tag = tags[index] as string;\n setProblem(null);\n setSaid(text.removed(tag));\n update(tags.filter((_, i) => i !== index));\n };\n\n const commitTyped = () => {\n if (!query) return false;\n if (add([query])) setTyped(\"\");\n return true;\n };\n\n const split = (s: string) =>\n [...separators, \"\\n\"].reduce<string[]>((parts, sep) => parts.flatMap((p) => p.split(sep)), [s]);\n\n // The list drops from the whole field (chips and input), found before the layer shows.\n useLayoutEffect(() => {\n anchor.current = input.current?.closest<HTMLElement>(\".cy-text-field\") ?? null;\n });\n useListboxLayer({ anchor, list, open: listOpen, onClose: () => setOpen(false) });\n useEffect(() => {\n if (active >= matches.length) setActive(Math.max(0, matches.length - 1));\n }, [active, matches.length]);\n\n const removeButtons = () => [...(chips.current?.querySelectorAll<HTMLButtonElement>(\"button\") ?? [])];\n\n const onKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {\n if (isComposing(event)) return;\n const el = event.currentTarget;\n if (separators.includes(event.key)) {\n event.preventDefault();\n commitTyped();\n return;\n }\n switch (event.key) {\n case \"Enter\": {\n const pick = listOpen ? matches[active] : undefined;\n if (pick) {\n event.preventDefault();\n if (add([pick])) setTyped(\"\");\n } else if (commitTyped()) event.preventDefault();\n return;\n }\n case \"Backspace\":\n if (el.value === \"\" && tags.length) {\n event.preventDefault();\n remove(tags.length - 1);\n }\n return;\n case \"ArrowLeft\":\n if (el.selectionStart === 0 && el.selectionEnd === 0 && tags.length) {\n event.preventDefault();\n removeButtons().at(-1)?.focus();\n }\n return;\n case \"ArrowDown\":\n case \"ArrowUp\":\n if (!suggestions) return;\n event.preventDefault();\n if (!listOpen) {\n setOpen(true);\n setActive(event.key === \"ArrowUp\" ? Math.max(0, matches.length - 1) : 0);\n } else\n setActive((a) =>\n Math.min(Math.max(a + (event.key === \"ArrowDown\" ? 1 : -1), 0), Math.max(0, matches.length - 1)),\n );\n return;\n case \"Escape\":\n if (listOpen) {\n event.preventDefault();\n setOpen(false);\n }\n return;\n }\n };\n\n const onTagKeyDown = (index: number) => (event: KeyboardEvent<HTMLButtonElement>) => {\n const buttons = removeButtons();\n const toInput = () => input.current?.focus();\n switch (event.key) {\n case \"ArrowLeft\":\n event.preventDefault();\n buttons[Math.max(0, index - 1)]?.focus();\n return;\n case \"ArrowRight\":\n event.preventDefault();\n if (index >= buttons.length - 1) toInput();\n else buttons[index + 1]?.focus();\n return;\n case \"Backspace\":\n case \"Delete\":\n event.preventDefault();\n remove(index);\n // Focus the tag before it, or the input when none is left on that side.\n requestAnimationFrame(() => {\n const left = removeButtons();\n if (left.length && index > 0) left[index - 1]?.focus();\n else toInput();\n });\n return;\n case \"Escape\":\n toInput();\n return;\n }\n };\n\n return (\n <div className={className ? `cy-tag-input ${className}` : \"cy-tag-input\"} data-size={size} style={style}>\n <TextField\n ref={input}\n label={label}\n labelHidden={labelHidden}\n description={description}\n error={error ?? problem ?? undefined}\n size={size}\n variant={variant}\n placeholder={placeholder}\n disabled={disabled}\n required={required && tags.length === 0}\n form={form}\n autoComplete=\"off\"\n value={typed}\n {...(suggestions\n ? {\n role: \"combobox\",\n \"aria-autocomplete\": \"list\" as const,\n \"aria-expanded\": listOpen,\n \"aria-controls\": listId,\n \"aria-activedescendant\": listOpen && matches.length ? `${listId}-${active}` : undefined,\n }\n : {})}\n onChange={(next) => {\n setTyped(next);\n setProblem(null);\n if (suggestions) setOpen(next.trim() !== \"\");\n }}\n onKeyDown={onKeyDown}\n onPaste={(event: ClipboardEvent<HTMLInputElement>) => {\n const pasted = event.clipboardData.getData(\"text\");\n const parts = split(pasted);\n if (parts.length < 2) return;\n event.preventDefault();\n add(parts);\n }}\n onBlur={() => {\n setOpen(false);\n commitTyped();\n }}\n />\n {tags.length > 0 && (\n <ul ref={chips} className=\"cy-tag-input-tags cy-reset\" aria-label={text.tags}>\n {tags.map((tag, index) => (\n <li key={`${tag}-${index}`} className=\"cy-tag-input-tag cy-reset\">\n <span className=\"cy-tag-input-text cy-reset\">{tag}</span>\n {!disabled && (\n <IconButton\n icon={close}\n label={text.remove(tag)}\n variant=\"ghost\"\n size=\"sm\"\n tabIndex={-1}\n onClick={() => {\n remove(index);\n input.current?.focus();\n }}\n onKeyDown={onTagKeyDown(index)}\n />\n )}\n </li>\n ))}\n </ul>\n )}\n {suggestions && (\n <div\n ref={list}\n id={listId}\n role=\"listbox\"\n aria-label={typeof label === \"string\" ? label : undefined}\n className=\"cy-combobox-list\"\n {...{ popover: \"manual\" }}\n >\n {matches.length === 0 ? (\n <div\n role=\"option\"\n aria-disabled=\"true\"\n aria-selected=\"false\"\n tabIndex={-1}\n className=\"cy-combobox-note\"\n >\n {text.empty}\n </div>\n ) : (\n matches.map((s, index) => (\n <div\n key={s}\n id={`${listId}-${index}`}\n role=\"option\"\n aria-selected={index === active}\n data-active={index === active ? \"\" : undefined}\n className=\"cy-combobox-option\"\n tabIndex={-1}\n onPointerMove={() => setActive(index)}\n onPointerDown={(e) => e.preventDefault()}\n onClick={() => {\n if (add([s])) setTyped(\"\");\n setOpen(false);\n }}\n onKeyDown={() => {}}\n >\n <span className=\"cy-combobox-option-text\">\n <span className=\"cy-combobox-option-label\">{s}</span>\n </span>\n </div>\n ))\n )}\n </div>\n )}\n <span className=\"cy-tag-input-status cy-reset\" role=\"status\">\n {said}\n </span>\n {tags.map((tag, index) => (\n <HiddenValue key={`${tag}-${index}`} name={name} form={form} value={tag} disabled={disabled} />\n ))}\n {/* Not submitted: only listens for the form's reset to restore defaultValue. */}\n <HiddenValue\n form={form}\n value=\"\"\n disabled\n onReset={() => {\n setTyped(\"\");\n setProblem(null);\n resetTags(defaultValue);\n }}\n />\n </div>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"TagInput.js","names":["useControllableState","IconButton","close","isComposing","TextField","HiddenValue","useListboxLayer","useEffect","useId","useLayoutEffect","useRef","useState","jsx","jsxs","DEFAULT_LABELS","tag","max","TagInput","label","labelHidden","description","error","value","defaultValue","onChange","suggestions","separators","allowDuplicates","maxTags","validate","name","form","required","disabled","placeholder","size","variant","labels","className","style","text","listId","tags","update","resetTags","typed","setTyped","problem","setProblem","said","setSaid","open","setOpen","active","setActive","input","anchor","list","chips","same","a","b","query","matches","s","listOpen","add","candidates","next","issue","raw","t","refusal","remove","index","_","i","commitTyped","split","parts","sep","p","removeButtons","onKeyDown","event","el","pick","onTagKeyDown","buttons","toInput","left","pasted","e"],"sources":["../../../src/components/TagInput/TagInput.tsx"],"sourcesContent":["import {\n type ClipboardEvent,\n type CSSProperties,\n type KeyboardEvent,\n type ReactNode,\n useEffect,\n useId,\n useLayoutEffect,\n useRef,\n useState,\n} from \"react\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { HiddenValue } from \"../../foundations/HiddenValue/HiddenValue.js\";\nimport { isComposing } from \"../../foundations/keys.js\";\nimport { close } from \"../../icons/close.js\";\nimport { useListboxLayer } from \"../../overlay/listbox-layer.js\";\nimport type { Size } from \"../../tokens/schema.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\nimport { TextField } from \"../TextField/TextField.js\";\n\nexport interface TagInputTokens {\n /** Background of a tag. */\n tagBackground: string;\n /** Corner radius of a tag. */\n tagRadius: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n tagInput: TagInputTokens;\n }\n}\n\nexport interface TagInputLabels {\n /** Name of the list of tags. Default: \"Tags\". */\n tags: string;\n remove: (tag: string) => string;\n added: (tag: string) => string;\n removed: (tag: string) => string;\n duplicate: (tag: string) => string;\n tooMany: (max: number) => string;\n /** Shown in the suggestion list when nothing matches. Default: \"No suggestions\". */\n empty: string;\n}\n\nexport interface TagInputProps {\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 /** Your own error; it replaces the field's own messages. */\n error?: ReactNode;\n /** The tags (controlled). */\n value?: string[] | undefined;\n /** Starting tags when uncontrolled. */\n defaultValue?: string[];\n /** Called with the full list of tags whenever one is added or removed. */\n onChange?: ((tags: string[]) => void) | undefined;\n /** Offered while typing (and with Arrow Down). Free text is still allowed. */\n suggestions?: string[] | undefined;\n /** Typing one of these adds the text as a tag (Enter always does). Pasted text is split on them. Default: [\",\"]. */\n separators?: string[];\n /** Allows the same tag more than once. Otherwise a tag already in the list (ignoring case) is refused. */\n allowDuplicates?: boolean;\n /** The most tags allowed; more are refused with a message. */\n maxTags?: number | undefined;\n /** Return a message to refuse a tag (shown as the field's error), or null to accept it. */\n validate?: ((tag: string, tags: string[]) => string | null) | undefined;\n /** Form field name; each tag is submitted as its own value under it. */\n name?: string | undefined;\n /** `id` of the form the tags are submitted with, when the field sits outside it. */\n form?: string | undefined;\n /** The form cannot be submitted while there are no tags. */\n required?: boolean | undefined;\n /** Blocks typing and removing tags, and leaves the tags out of the form submission. */\n disabled?: boolean | undefined;\n /** Hint shown in the input while nothing is typed. */\n placeholder?: string | undefined;\n /** Field height and text size. 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 tag list's name, the remove buttons, announcements and refusals. */\n labels?: Partial<TagInputLabels>;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only. Restyle through --cy-tag-input-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: TagInputLabels = {\n tags: \"Tags\",\n remove: (tag) => `Remove ${tag}`,\n added: (tag) => `${tag} added`,\n removed: (tag) => `${tag} removed`,\n duplicate: (tag) => `${tag} is already added`,\n tooMany: (max) => `Up to ${max} tags`,\n empty: \"No suggestions\",\n};\n\n/**\n * Several short values in one field: type and press Enter (or a comma), pick a suggestion, or paste a list. Tags can\n * be removed with their buttons, Backspace, or the arrow keys. Each tag is submitted under `name`.\n */\nexport function TagInput({\n label,\n labelHidden,\n description,\n error,\n value,\n defaultValue = [],\n onChange,\n suggestions,\n separators = [\",\"],\n allowDuplicates = false,\n maxTags,\n validate,\n name,\n form,\n required,\n disabled,\n placeholder,\n size = \"md\",\n variant = \"outline\",\n labels,\n className,\n style,\n}: TagInputProps) {\n const text = { ...DEFAULT_LABELS, ...labels };\n const id = useId();\n const listId = `${id}-list`;\n const [tags, update, resetTags] = useControllableState(value, defaultValue, onChange);\n const [typed, setTyped] = useState(\"\");\n const [problem, setProblem] = useState<string | null>(null);\n const [said, setSaid] = useState(\"\");\n const [open, setOpen] = useState(false);\n const [active, setActive] = useState(0);\n const input = useRef<HTMLInputElement>(null);\n const anchor = useRef<HTMLElement | null>(null);\n const list = useRef<HTMLDivElement>(null);\n const chips = useRef<HTMLUListElement>(null);\n\n const same = (a: string, b: string) => a.toLocaleLowerCase() === b.toLocaleLowerCase();\n const query = typed.trim();\n const matches = (suggestions ?? []).filter(\n (s) => !tags.some((t) => same(t, s)) && s.toLocaleLowerCase().includes(query.toLocaleLowerCase()),\n );\n const listOpen = open && suggestions !== undefined && !disabled;\n\n /** Adds each candidate that passes the checks; reports the first problem. Returns whether all were added. */\n const add = (candidates: string[]) => {\n let next = [...tags];\n let issue: string | null = null;\n for (const raw of candidates) {\n const tag = raw.trim();\n if (!tag) continue;\n if (!allowDuplicates && next.some((t) => same(t, tag))) issue ??= text.duplicate(tag);\n else if (maxTags !== undefined && next.length >= maxTags) issue ??= text.tooMany(maxTags);\n else {\n const refusal = validate?.(tag, next) ?? null;\n if (refusal) issue ??= refusal;\n else next = [...next, tag];\n }\n }\n setProblem(issue);\n if (next.length !== tags.length) {\n setSaid(text.added(next.slice(tags.length).join(\", \")));\n update(next);\n }\n return issue === null;\n };\n\n const remove = (index: number) => {\n const tag = tags[index] as string;\n setProblem(null);\n setSaid(text.removed(tag));\n update(tags.filter((_, i) => i !== index));\n };\n\n const commitTyped = () => {\n if (!query) return false;\n if (add([query])) setTyped(\"\");\n return true;\n };\n\n const split = (s: string) =>\n [...separators, \"\\n\"].reduce<string[]>((parts, sep) => parts.flatMap((p) => p.split(sep)), [s]);\n\n // The list drops from the whole field (chips and input), found before the layer shows.\n useLayoutEffect(() => {\n anchor.current = input.current?.closest<HTMLElement>(\".cy-text-field\") ?? null;\n });\n useListboxLayer({ anchor, list, open: listOpen, onClose: () => setOpen(false) });\n useEffect(() => {\n if (active >= matches.length) setActive(Math.max(0, matches.length - 1));\n }, [active, matches.length]);\n\n const removeButtons = () => [...(chips.current?.querySelectorAll<HTMLButtonElement>(\"button\") ?? [])];\n\n const onKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {\n if (isComposing(event)) return;\n const el = event.currentTarget;\n if (separators.includes(event.key)) {\n event.preventDefault();\n commitTyped();\n return;\n }\n switch (event.key) {\n case \"Enter\": {\n const pick = listOpen ? matches[active] : undefined;\n if (pick) {\n event.preventDefault();\n if (add([pick])) setTyped(\"\");\n } else if (commitTyped()) event.preventDefault();\n return;\n }\n case \"Backspace\":\n if (el.value === \"\" && tags.length) {\n event.preventDefault();\n remove(tags.length - 1);\n }\n return;\n case \"ArrowLeft\":\n if (el.selectionStart === 0 && el.selectionEnd === 0 && tags.length) {\n event.preventDefault();\n removeButtons().at(-1)?.focus();\n }\n return;\n case \"ArrowDown\":\n case \"ArrowUp\":\n if (!suggestions) return;\n event.preventDefault();\n if (!listOpen) {\n setOpen(true);\n setActive(event.key === \"ArrowUp\" ? Math.max(0, matches.length - 1) : 0);\n } else\n setActive((a) =>\n Math.min(Math.max(a + (event.key === \"ArrowDown\" ? 1 : -1), 0), Math.max(0, matches.length - 1)),\n );\n return;\n case \"Escape\":\n if (listOpen) {\n event.preventDefault();\n setOpen(false);\n }\n return;\n }\n };\n\n const onTagKeyDown = (index: number) => (event: KeyboardEvent<HTMLButtonElement>) => {\n const buttons = removeButtons();\n const toInput = () => input.current?.focus();\n switch (event.key) {\n case \"ArrowLeft\":\n event.preventDefault();\n buttons[Math.max(0, index - 1)]?.focus();\n return;\n case \"ArrowRight\":\n event.preventDefault();\n if (index >= buttons.length - 1) toInput();\n else buttons[index + 1]?.focus();\n return;\n case \"Backspace\":\n case \"Delete\":\n event.preventDefault();\n remove(index);\n // Focus the tag before it, or the input when none is left on that side.\n requestAnimationFrame(() => {\n const left = removeButtons();\n if (left.length && index > 0) left[index - 1]?.focus();\n else toInput();\n });\n return;\n case \"Escape\":\n toInput();\n return;\n }\n };\n\n return (\n <div className={className ? `cy-tag-input ${className}` : \"cy-tag-input\"} data-size={size} style={style}>\n <TextField\n ref={input}\n label={label}\n labelHidden={labelHidden}\n description={description}\n error={error ?? problem ?? undefined}\n size={size}\n variant={variant}\n placeholder={placeholder}\n disabled={disabled}\n required={required && tags.length === 0}\n form={form}\n autoComplete=\"off\"\n value={typed}\n {...(suggestions\n ? {\n role: \"combobox\",\n \"aria-autocomplete\": \"list\" as const,\n \"aria-expanded\": listOpen,\n \"aria-controls\": listId,\n \"aria-activedescendant\": listOpen && matches.length ? `${listId}-${active}` : undefined,\n }\n : {})}\n onChange={(next) => {\n setTyped(next);\n setProblem(null);\n if (suggestions) setOpen(next.trim() !== \"\");\n }}\n onKeyDown={onKeyDown}\n onPaste={(event: ClipboardEvent<HTMLInputElement>) => {\n const pasted = event.clipboardData.getData(\"text\");\n const parts = split(pasted);\n if (parts.length < 2) return;\n event.preventDefault();\n add(parts);\n }}\n onBlur={() => {\n setOpen(false);\n commitTyped();\n }}\n />\n {tags.length > 0 && (\n <ul ref={chips} className=\"cy-tag-input-tags cy-reset\" aria-label={text.tags}>\n {tags.map((tag, index) => (\n <li key={`${tag}-${index}`} className=\"cy-tag-input-tag cy-reset\">\n <span className=\"cy-tag-input-text cy-reset\">{tag}</span>\n {!disabled && (\n <IconButton\n icon={close}\n label={text.remove(tag)}\n variant=\"ghost\"\n size=\"sm\"\n tabIndex={-1}\n onClick={() => {\n remove(index);\n input.current?.focus();\n }}\n onKeyDown={onTagKeyDown(index)}\n />\n )}\n </li>\n ))}\n </ul>\n )}\n {suggestions && (\n <div\n ref={list}\n id={listId}\n role=\"listbox\"\n aria-label={typeof label === \"string\" ? label : undefined}\n className=\"cy-combobox-list\"\n {...{ popover: \"manual\" }}\n >\n {matches.length === 0 ? (\n <div\n role=\"option\"\n aria-disabled=\"true\"\n aria-selected=\"false\"\n tabIndex={-1}\n className=\"cy-combobox-note\"\n >\n {text.empty}\n </div>\n ) : (\n matches.map((s, index) => (\n <div\n key={s}\n id={`${listId}-${index}`}\n role=\"option\"\n aria-selected={index === active}\n data-active={index === active ? \"\" : undefined}\n className=\"cy-combobox-option\"\n tabIndex={-1}\n onPointerMove={() => setActive(index)}\n onPointerDown={(e) => e.preventDefault()}\n onClick={() => {\n if (add([s])) setTyped(\"\");\n setOpen(false);\n }}\n onKeyDown={() => {}}\n >\n <span className=\"cy-combobox-option-text\">\n <span className=\"cy-combobox-option-label\">{s}</span>\n </span>\n </div>\n ))\n )}\n </div>\n )}\n <span className=\"cy-tag-input-status cy-reset\" role=\"status\">\n {said}\n </span>\n {tags.map((tag, index) => (\n <HiddenValue key={`${tag}-${index}`} name={name} form={form} value={tag} disabled={disabled} />\n ))}\n {/* Not submitted: only listens for the form's reset to restore defaultValue. */}\n <HiddenValue\n form={form}\n value=\"\"\n disabled\n onReset={() => {\n setTyped(\"\");\n setProblem(null);\n resetTags(defaultValue);\n }}\n />\n </div>\n );\n}\n"],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ import { type CSSProperties, type ReactNode } from "react";
2
+ import type { Tone } from "../../tokens/schema.js";
3
+ export interface TextTokens {
4
+ /** Line height of every variant. */
5
+ lineHeight: string;
6
+ /** Font size of the `lead` variant. */
7
+ leadSize: string;
8
+ /** Font size of the `caption` variant. */
9
+ captionSize: string;
10
+ /** Font size of the `eyebrow` variant. */
11
+ eyebrowSize: string;
12
+ /** Letter spacing of the `eyebrow` variant. */
13
+ eyebrowTracking: string;
14
+ /** Colour of `tone="muted"` and of the muted variants (lead, caption, eyebrow). */
15
+ muted: string;
16
+ }
17
+ declare module "../../tokens/schema.js" {
18
+ interface ComponentTokens {
19
+ text: TextTokens;
20
+ }
21
+ }
22
+ export interface TextProps {
23
+ /**
24
+ * Element to render. `strong` is bold unless `weight` says otherwise; `p`, `div` and `figcaption` are blocks, the
25
+ * rest are inline. Default "span".
26
+ */
27
+ as?: "span" | "p" | "div" | "label" | "strong" | "em" | "small" | "time" | "figcaption";
28
+ /**
29
+ * Preset: `lead` is larger muted intro text, `caption` is small and muted, `eyebrow` is the small uppercase tracked
30
+ * label, `code` uses the mono face. A preset only sets defaults: `size`, `weight` and `tone` still win.
31
+ * Default "body".
32
+ */
33
+ variant?: "body" | "lead" | "caption" | "eyebrow" | "code";
34
+ /**
35
+ * Font size, from the `--cy-font-size-*` tokens. Default: from the variant ("md" for body). A Text placed directly
36
+ * inside another Text takes the outer size.
37
+ */
38
+ size?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
39
+ /**
40
+ * Font weight. Default "regular" ("bold" for the eyebrow variant and for `as="strong"`). A Text placed directly
41
+ * inside another Text takes the outer weight.
42
+ */
43
+ weight?: "regular" | "medium" | "bold";
44
+ /**
45
+ * Colour. `inherit` takes the surrounding colour, `neutral` is the ink, `muted` the secondary ink; the others are
46
+ * the readable text colour of that tone. Default "inherit" ("muted" for lead, caption and eyebrow).
47
+ */
48
+ tone?: Tone | "inherit" | "muted";
49
+ /** Horizontal alignment; `start` and `end` follow the reading direction. Makes an inline element a block. */
50
+ align?: "start" | "center" | "end";
51
+ /**
52
+ * Cuts text that does not fit and ends it with an ellipsis: `true` keeps one line, a number keeps that many lines.
53
+ * An inline element becomes an inline block (one line) or a block (several lines). Default false.
54
+ */
55
+ truncate?: boolean | number;
56
+ /** Tabular figures, so digits in a column line up. Default false. */
57
+ numeric?: boolean;
58
+ /** Id of the control this text labels. Used with `as="label"`. */
59
+ htmlFor?: string | undefined;
60
+ /** Machine-readable date or time. Used with `as="time"`. */
61
+ dateTime?: string | undefined;
62
+ /** Id of the element, for `aria-labelledby` and `aria-describedby`. */
63
+ id?: string | undefined;
64
+ /** Added to the root element, for layout. */
65
+ className?: string | undefined;
66
+ /** Layout only. Restyle through --cy-text-* tokens. */
67
+ style?: CSSProperties | undefined;
68
+ /** The text. */
69
+ children?: ReactNode;
70
+ }
71
+ /** One piece of text in Cynosure's type scale: labels, captions, leads, helper lines and values. */
72
+ export declare const Text: import("react").ForwardRefExoticComponent<TextProps & import("react").RefAttributes<HTMLElement>>;
@@ -0,0 +1,30 @@
1
+ "use client";
2
+ import { forwardRef as y } from "react";
3
+ import { jsx as c } from "react/jsx-runtime";
4
+ var j = y(function({ as: t = "span", variant: a = "body", size: r, weight: n = t === "strong" ? "bold" : void 0, tone: s, align: l, truncate: e = !1, numeric: f = !1, htmlFor: m, dateTime: x, id: b, className: i, style: d, children: p }, v) {
5
+ const o = typeof e == "number" && e > 0 ? Math.floor(e) : 0;
6
+ return /* @__PURE__ */ c(t, {
7
+ ref: v,
8
+ id: b,
9
+ className: i ? `cy-text ${i}` : "cy-text",
10
+ "data-variant": a === "body" ? void 0 : a,
11
+ "data-size": r,
12
+ "data-weight": n,
13
+ "data-tone": s,
14
+ "data-align": l,
15
+ "data-truncate": o ? "lines" : e === !0 ? "" : void 0,
16
+ "data-numeric": f ? "" : void 0,
17
+ ...t === "label" && { htmlFor: m },
18
+ ...t === "time" && { dateTime: x },
19
+ style: o ? {
20
+ "--_lines": o,
21
+ ...d
22
+ } : d,
23
+ children: p
24
+ });
25
+ });
26
+ export {
27
+ j as Text
28
+ };
29
+
30
+ //# sourceMappingURL=Text.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Text.js","names":["forwardRef","jsx","Text","Tag","variant","size","weight","tone","align","truncate","numeric","htmlFor","dateTime","id","className","style","children","ref","lines"],"sources":["../../../src/components/Text/Text.tsx"],"sourcesContent":["import { type CSSProperties, forwardRef, type ReactNode } from \"react\";\nimport type { Tone } from \"../../tokens/schema.js\";\n\nexport interface TextTokens {\n /** Line height of every variant. */\n lineHeight: string;\n /** Font size of the `lead` variant. */\n leadSize: string;\n /** Font size of the `caption` variant. */\n captionSize: string;\n /** Font size of the `eyebrow` variant. */\n eyebrowSize: string;\n /** Letter spacing of the `eyebrow` variant. */\n eyebrowTracking: string;\n /** Colour of `tone=\"muted\"` and of the muted variants (lead, caption, eyebrow). */\n muted: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n text: TextTokens;\n }\n}\n\nexport interface TextProps {\n /**\n * Element to render. `strong` is bold unless `weight` says otherwise; `p`, `div` and `figcaption` are blocks, the\n * rest are inline. Default \"span\".\n */\n as?: \"span\" | \"p\" | \"div\" | \"label\" | \"strong\" | \"em\" | \"small\" | \"time\" | \"figcaption\";\n /**\n * Preset: `lead` is larger muted intro text, `caption` is small and muted, `eyebrow` is the small uppercase tracked\n * label, `code` uses the mono face. A preset only sets defaults: `size`, `weight` and `tone` still win.\n * Default \"body\".\n */\n variant?: \"body\" | \"lead\" | \"caption\" | \"eyebrow\" | \"code\";\n /**\n * Font size, from the `--cy-font-size-*` tokens. Default: from the variant (\"md\" for body). A Text placed directly\n * inside another Text takes the outer size.\n */\n size?: \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n /**\n * Font weight. Default \"regular\" (\"bold\" for the eyebrow variant and for `as=\"strong\"`). A Text placed directly\n * inside another Text takes the outer weight.\n */\n weight?: \"regular\" | \"medium\" | \"bold\";\n /**\n * Colour. `inherit` takes the surrounding colour, `neutral` is the ink, `muted` the secondary ink; the others are\n * the readable text colour of that tone. Default \"inherit\" (\"muted\" for lead, caption and eyebrow).\n */\n tone?: Tone | \"inherit\" | \"muted\";\n /** Horizontal alignment; `start` and `end` follow the reading direction. Makes an inline element a block. */\n align?: \"start\" | \"center\" | \"end\";\n /**\n * Cuts text that does not fit and ends it with an ellipsis: `true` keeps one line, a number keeps that many lines.\n * An inline element becomes an inline block (one line) or a block (several lines). Default false.\n */\n truncate?: boolean | number;\n /** Tabular figures, so digits in a column line up. Default false. */\n numeric?: boolean;\n /** Id of the control this text labels. Used with `as=\"label\"`. */\n htmlFor?: string | undefined;\n /** Machine-readable date or time. Used with `as=\"time\"`. */\n dateTime?: string | undefined;\n /** Id of the element, for `aria-labelledby` and `aria-describedby`. */\n id?: string | undefined;\n /** Added to the root element, for layout. */\n className?: string | undefined;\n /** Layout only. Restyle through --cy-text-* tokens. */\n style?: CSSProperties | undefined;\n /** The text. */\n children?: ReactNode;\n}\n\n/** One piece of text in Cynosure's type scale: labels, captions, leads, helper lines and values. */\nexport const Text = forwardRef<HTMLElement, TextProps>(function Text(\n {\n as: Tag = \"span\",\n variant = \"body\",\n size,\n weight = Tag === \"strong\" ? \"bold\" : undefined,\n tone,\n align,\n truncate = false,\n numeric = false,\n htmlFor,\n dateTime,\n id,\n className,\n style,\n children,\n },\n ref,\n) {\n const lines = typeof truncate === \"number\" && truncate > 0 ? Math.floor(truncate) : 0;\n return (\n <Tag\n // One component, nine elements: the ref is the element's own, typed as the common HTMLElement.\n ref={ref as never}\n id={id}\n className={className ? `cy-text ${className}` : \"cy-text\"}\n data-variant={variant === \"body\" ? undefined : variant}\n data-size={size}\n data-weight={weight}\n data-tone={tone}\n data-align={align}\n data-truncate={lines ? \"lines\" : truncate === true ? \"\" : undefined}\n data-numeric={numeric ? \"\" : undefined}\n {...(Tag === \"label\" && { htmlFor })}\n {...(Tag === \"time\" && { dateTime })}\n style={lines ? ({ \"--_lines\": lines, ...style } as CSSProperties) : style}\n >\n {children}\n </Tag>\n );\n});\n"],"mappings":";;;AA2EA,IAAaE,IAAOF,EAAmC,SACrD,EACE,IAAIG,IAAM,QACV,SAAAC,IAAU,QACV,MAAAC,GACA,QAAAC,IAASH,MAAQ,WAAW,SAAS,QACrC,MAAAI,GACA,OAAAC,GACA,UAAAC,IAAW,IACX,SAAAC,IAAU,IACV,SAAAC,GACA,UAAAC,GACA,IAAAC,GACA,WAAAC,GACA,OAAAC,GACA,UAAAC,EAAA,GAEFC,GACA;AACA,QAAMC,IAAQ,OAAOT,KAAa,YAAYA,IAAW,IAAI,KAAK,MAAMA,CAAQ,IAAI;AACpF,SACE,gBAAAR,EAACE,GAAD;AAAA,IAEO,KAAAc;AAAA,IACD,IAAAJ;AAAA,IACJ,WAAWC,IAAY,WAAWA,CAAA,KAAc;AAAA,IAChD,gBAAcV,MAAY,SAAS,SAAYA;AAAA,IAC/C,aAAWC;AAAA,IACX,eAAaC;AAAA,IACb,aAAWC;AAAA,IACX,cAAYC;AAAA,IACZ,iBAAeU,IAAQ,UAAUT,MAAa,KAAO,KAAK;AAAA,IAC1D,gBAAcC,IAAU,KAAK;AAAA,IAC7B,GAAKP,MAAQ,WAAW,EAAE,SAAAQ,EAAQ;AAAA,IAClC,GAAKR,MAAQ,UAAU,EAAE,UAAAS,EAAS;AAAA,IAClC,OAAOM,IAAS;AAAA,MAAE,YAAYA;AAAA,MAAO,GAAGH;AAAA,IAAM,IAAsBA;AAAA,IAEnE,UAAAC;AAAA,EACE,CAAA;AAET,CAAC"}
@@ -0,0 +1 @@
1
+ export { Text, type TextProps, type TextTokens } from "./Text.js";
@@ -15,13 +15,19 @@ declare module "../../tokens/schema.js" {
15
15
  }
16
16
  type NativeArea = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "value" | "defaultValue" | "onChange" | "rows" | "className" | "style" | "children">;
17
17
  export interface TextAreaProps extends NativeArea {
18
+ /** The field's label and accessible name. */
18
19
  label: ReactNode;
19
20
  /** Visually hide the label (it still names the control). Prefer visible labels. */
20
21
  labelHidden?: boolean | undefined;
22
+ /** Help text shown below the field. */
21
23
  description?: ReactNode;
24
+ /** Error message shown below the field; it is announced and marks the field invalid. */
22
25
  error?: ReactNode;
26
+ /** The text (controlled). */
23
27
  value?: string;
28
+ /** Starting text when uncontrolled. */
24
29
  defaultValue?: string;
30
+ /** Called with the new text on every edit. */
25
31
  onChange?: (value: string) => void;
26
32
  /** Show a corner grip to drag the height (pointer and touch). Content growth still applies. */
27
33
  resizable?: boolean;
@@ -31,11 +37,15 @@ export interface TextAreaProps extends NativeArea {
31
37
  maxRows?: number;
32
38
  /** Shows a live character counter. */
33
39
  showCount?: boolean;
40
+ /** Text size of the field and its label. Default "md". */
34
41
  size?: Size;
42
+ /** `outline` or `soft` (tinted, borderless until focus). Default "outline". */
35
43
  variant?: "outline" | "soft";
44
+ /** Replace the built-in English text: the character counter. */
36
45
  labels?: {
37
46
  count?: (count: number, max?: number) => string;
38
47
  };
48
+ /** Added to the root element, for layout. */
39
49
  className?: string;
40
50
  /** Layout only. */
41
51
  style?: CSSProperties;
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
  import { Icon as J } from "../../foundations/Icon/Icon.js";
3
- import { useDrag as K } from "../../foundations/drag.js";
4
- import { Field as O } from "../Field/Field.js";
3
+ import { Field as K } from "../Field/Field.js";
4
+ import { useDrag as O } from "../../foundations/drag.js";
5
5
  import { TextAreaBase as P } from "../../foundations/TextAreaBase/TextAreaBase.js";
6
6
  import { resizeCorner as Q } from "../../icons/resize-corner.js";
7
7
  import { forwardRef as U, useCallback as M, useEffect as E, useLayoutEffect as X, useRef as h, useState as Z } from "react";
@@ -20,7 +20,7 @@ var V = (d, u) => u ? `${d} / ${u}` : `${d} characters`, it = U(function({ label
20
20
  const C = t.scrollHeight + Number.parseFloat(e.borderTopWidth) + Number.parseFloat(e.borderBottomWidth), G = Math.min(Math.max(C, q), T);
21
21
  t.style.height = `${G}px`, t.style.overflowY = C > T ? "auto" : "hidden";
22
22
  }, [m, x]);
23
- return K(B, {
23
+ return O(B, {
24
24
  onStart: () => {
25
25
  f.current = {
26
26
  height: o.current.getBoundingClientRect().height,
@@ -42,7 +42,7 @@ var V = (d, u) => u ? `${d} / ${u}` : `${d} characters`, it = U(function({ label
42
42
  g(o.current?.value.length ?? 0), a();
43
43
  });
44
44
  return t.addEventListener("reset", e), () => t.removeEventListener("reset", e);
45
- }, [a]), /* @__PURE__ */ s(O, {
45
+ }, [a]), /* @__PURE__ */ s(K, {
46
46
  label: u,
47
47
  labelHidden: A,
48
48
  description: R,
@@ -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":";;;;;;;;;;AAoFA,IAAMc,IAAA,CAAkBC,GAAyBC,MAAkB;AACjE,SAAO,yBAAyB,iBAAiB,WAAW,OAAO,GAAG,KAAK,KAAKD,GAAOC,CAAK,GAC5FD,EAAM,cAAc,IAAI,MAAM,SAAS,EAAE,SAAS,GAAK,CAAC,CAAC;AAC3D,GAGaE,KAAYV,EAA6C,SACpE,EACE,OAAAW,GACA,aAAAC,GACA,aAAAC,GACA,OAAAC,GACA,OAAAL,GACA,cAAAM,GACA,UAAAC,GACA,MAAAC,IAAO,QACP,MAAAC,IAAO,MACP,SAAAC,IAAU,WACV,WAAAC,GACA,SAAAC,GACA,WAAAC,IAAY,IACZ,YAAAC,IAAa,IACb,UAAAC,GACA,QAAAC,GACA,UAAAC,GACA,UAAAC,GACA,IAAAC,GACA,WAAAC,GACA,OAAAC,GACA,WAAAC,GACA,GAAGC,EAAA,GAELC,GACA;AACA,QAAMC,IAAQ/B,EAAgC,IAAI,GAC5C,CAACgC,GAAOC,CAAA,IAAYhC,EAAS,EAAK,GAClCiC,IAASpB,MAAS,cAAcM,GAChC,CAACe,GAAQC,CAAA,IAAanC,EAAS,GAAQK,KAASM,EAAa,GAC7DyB,IAAa/B,MAAU;AAC7B,EAAAP,EAAA,MAAgB;AACd,IAAIsC,KAAYD,EAAU,EAAQ9B,CAAM;AAAA,EAC1C,GAAG,CAAC+B,GAAY/B,CAAK,CAAC,GACtBP,EAAA,MAAgB;AACd,UAAMuC,IAAOP,EAAM,SAAS;AAC5B,QAAI,CAACO,EAAM;AAEX,UAAMC,IAAA,MAAgB,sBAAA,MAA4BH,EAAU,EAAQL,EAAM,SAAS,KAAM,CAAC;AAC1F,WAAAO,EAAK,iBAAiB,SAASC,CAAO,GACtC,MAAaD,EAAK,oBAAoB,SAASC,CAAO;AAAA,EACxD,GAAG,CAAC,CAAC;AACL,QAAMC,IAAM1C,EAAA,CACT2C,MAAkC;AACjC,IAAAV,EAAM,UAAUU,GACZ,OAAOX,KAAc,aAAYA,EAAUW,CAAI,IAC1CX,MAAWA,EAAU,UAAUW;AAAA,EAC1C,GACA,CAACX,CAAS,CACZ,GACMY,IAAA,MAAc;AAClB,IAAKX,EAAM,YACX3B,EAAe2B,EAAM,SAAS,EAAE,GAChCA,EAAM,QAAQ,MAAM;AAAA,EACtB;AAEA,SACE,gBAAA7B,EAACT,GAAD;AAAA,IACS,OAAAe;AAAA,IACM,aAAAC;AAAA,IACA,aAAAC;AAAA,IACN,OAAAC;AAAA,IACG,UAAAY;AAAA,IACJ,MAAAR;AAAA,IACF,IAAAU;AAAA,IACO,WAAAC;AAAA,IACJ,OAAAC;AAAA,IAEL,UAAA,CAAAgB,MACA,gBAAAxC,EAAC,OAAD;AAAA,MACE,WAAU;AAAA,MACV,aAAWY;AAAA,MACX,gBAAcC;AAAA,MACd,gBAAc2B,EAAM,UAAU,KAAK;AAAA,MACnC,iBAAenB,IAAW,KAAK;AAAA,MALjC,UAAA;AAAA,QAOGP,KAAa,gBAAAf,EAACZ,GAAD;AAAA,UAAM,MAAM2B;AAAA,UAAW,WAAU;AAAA,QAAsB,CAAA;AAAA,QACrE,gBAAAf,EAACR,GAAD;AAAA,UACO,KAAA8C;AAAA,UACL,GAAIX;AAAA,UACJ,IAAIc,EAAM;AAAA,UACV,MAAMT,KAAUF,IAAQ,SAASlB;AAAA,UACjC,WAAU;AAAA,UACV,oBAAkB6B,EAAM;AAAA,UACxB,SAASA,EAAM;AAAA,UACL,UAAApB;AAAA,UACA,UAAAC;AAAA,UACV,GAAKa,IAAa,EAAE,OAAA/B,EAAM,IAAI,EAAE,cAAAM,EAAa;AAAA,UAC7C,UAAA,CAAWgC,MAAM;AACf,YAAAR,EAAU,EAAQQ,EAAE,cAAc,KAAM,GACxC/B,IAAW+B,EAAE,cAAc,KAAK;AAAA,UAClC;AAAA,UACA,WAAA,CAAYA,MAAuChB,IAAYgB,CAAC;AAAA,QACjE,CAAA;AAAA,QACAzB,KAAagB,KAAU,CAACX,KACvB,gBAAAtB,EAACX,GAAD;AAAA,UACE,MAAMC;AAAA,UACN,OAAO8B,GAAQ,SAAS;AAAA,UACxB,SAAQ;AAAA,UACR,MAAK;AAAA,UACL,SAASoB;AAAA,UACT,WAAU;AAAA,QACX,CAAA;AAAA,QAEFR,KAAU,CAACV,KACV,gBAAAtB,EAACX,GAAD;AAAA,UACE,MAAMyC,IAAQpC,IAASD;AAAA,UACvB,OAAOqC,IAASV,GAAQ,QAAQ,SAAWA,GAAQ,QAAQ;AAAA,UAC3D,gBAAcU;AAAA,UACd,SAAQ;AAAA,UACR,MAAK;AAAA,UACL,SAAA,MAAeC,EAAS,CAACD,CAAK;AAAA,UAC9B,WAAU;AAAA,QACX,CAAA;AAAA,QAEFd,KAAW,gBAAAhB,EAACZ,GAAD;AAAA,UAAM,MAAM4B;AAAA,UAAS,WAAU;AAAA,QAAsB,CAAA;AAAA,QAChEG;AAAA,MACE;AAAA,I;A,EAEF,CAAA;AAEX,CAAC"}
@@ -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;