@arshad-shah/cynosure 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (275) hide show
  1. package/README.md +9 -8
  2. package/dist/components/Accordion/Accordion.d.ts +14 -0
  3. package/dist/components/Accordion/Accordion.js.map +1 -1
  4. package/dist/components/Announcer/Announcer.d.ts +1 -0
  5. package/dist/components/Announcer/Announcer.js.map +1 -1
  6. package/dist/components/AppShell/AppShell.d.ts +22 -1
  7. package/dist/components/AppShell/AppShell.js +95 -83
  8. package/dist/components/AppShell/AppShell.js.map +1 -1
  9. package/dist/components/AppShell/index.d.ts +1 -1
  10. package/dist/components/AspectRatio/AspectRatio.d.ts +29 -0
  11. package/dist/components/AspectRatio/AspectRatio.js +21 -0
  12. package/dist/components/AspectRatio/AspectRatio.js.map +1 -0
  13. package/dist/components/AspectRatio/index.d.ts +1 -0
  14. package/dist/components/Avatar/Avatar.d.ts +96 -0
  15. package/dist/components/Avatar/Avatar.js +90 -0
  16. package/dist/components/Avatar/Avatar.js.map +1 -0
  17. package/dist/components/Avatar/index.d.ts +1 -0
  18. package/dist/components/Badge/Badge.d.ts +6 -0
  19. package/dist/components/Badge/Badge.js.map +1 -1
  20. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +55 -0
  21. package/dist/components/Breadcrumbs/Breadcrumbs.js +85 -0
  22. package/dist/components/Breadcrumbs/Breadcrumbs.js.map +1 -0
  23. package/dist/components/Breadcrumbs/index.d.ts +1 -0
  24. package/dist/components/Button/Button.d.ts +13 -2
  25. package/dist/components/Button/Button.js +28 -26
  26. package/dist/components/Button/Button.js.map +1 -1
  27. package/dist/components/Calendar/Calendar.d.ts +65 -7
  28. package/dist/components/Calendar/Calendar.js +207 -95
  29. package/dist/components/Calendar/Calendar.js.map +1 -1
  30. package/dist/components/Calendar/dates.d.ts +4 -0
  31. package/dist/components/Calendar/dates.js +41 -27
  32. package/dist/components/Calendar/dates.js.map +1 -1
  33. package/dist/components/Calendar/index.d.ts +1 -1
  34. package/dist/components/Card/Card.d.ts +27 -0
  35. package/dist/components/Card/Card.js +48 -36
  36. package/dist/components/Card/Card.js.map +1 -1
  37. package/dist/components/Card/index.d.ts +1 -1
  38. package/dist/components/Checkbox/Checkbox.d.ts +8 -1
  39. package/dist/components/Checkbox/Checkbox.js +7 -6
  40. package/dist/components/Checkbox/Checkbox.js.map +1 -1
  41. package/dist/components/Checkbox/ChoiceRow.d.ts +17 -1
  42. package/dist/components/Checkbox/ChoiceRow.js +19 -18
  43. package/dist/components/Checkbox/ChoiceRow.js.map +1 -1
  44. package/dist/components/Checklist/Checklist.d.ts +65 -0
  45. package/dist/components/Checklist/Checklist.js +163 -0
  46. package/dist/components/Checklist/Checklist.js.map +1 -0
  47. package/dist/components/Checklist/index.d.ts +1 -0
  48. package/dist/components/CodeBlock/CodeBlock.d.ts +5 -0
  49. package/dist/components/CodeBlock/CodeBlock.js.map +1 -1
  50. package/dist/components/ColorField/ColorField.d.ts +12 -0
  51. package/dist/components/ColorField/ColorField.js +19 -19
  52. package/dist/components/ColorField/ColorField.js.map +1 -1
  53. package/dist/components/ColorSwatches/ColorSwatches.d.ts +5 -0
  54. package/dist/components/ColorSwatches/ColorSwatches.js +6 -6
  55. package/dist/components/ColorSwatches/ColorSwatches.js.map +1 -1
  56. package/dist/components/Combobox/Combobox.d.ts +20 -1
  57. package/dist/components/Combobox/Combobox.js +38 -34
  58. package/dist/components/Combobox/Combobox.js.map +1 -1
  59. package/dist/components/CommandPalette/CommandPalette.d.ts +9 -0
  60. package/dist/components/CommandPalette/CommandPalette.js +10 -10
  61. package/dist/components/CommandPalette/CommandPalette.js.map +1 -1
  62. package/dist/components/CompareSlider/CompareSlider.d.ts +4 -0
  63. package/dist/components/CompareSlider/CompareSlider.js +4 -4
  64. package/dist/components/CompareSlider/CompareSlider.js.map +1 -1
  65. package/dist/components/Container/Container.d.ts +44 -0
  66. package/dist/components/Container/Container.js +24 -0
  67. package/dist/components/Container/Container.js.map +1 -0
  68. package/dist/components/Container/index.d.ts +1 -0
  69. package/dist/components/ContextMenu/ContextMenu.d.ts +11 -0
  70. package/dist/components/ContextMenu/ContextMenu.js.map +1 -1
  71. package/dist/components/CopyButton/CopyButton.d.ts +8 -0
  72. package/dist/components/CopyButton/CopyButton.js.map +1 -1
  73. package/dist/components/DateField/DateField.d.ts +17 -0
  74. package/dist/components/DateField/DateField.js +6 -6
  75. package/dist/components/DateField/DateField.js.map +1 -1
  76. package/dist/components/DescriptionList/DescriptionList.d.ts +3 -0
  77. package/dist/components/DescriptionList/DescriptionList.js.map +1 -1
  78. package/dist/components/Dialog/Dialog.d.ts +16 -2
  79. package/dist/components/Dialog/Dialog.js +82 -70
  80. package/dist/components/Dialog/Dialog.js.map +1 -1
  81. package/dist/components/Disclosure/Disclosure.d.ts +7 -0
  82. package/dist/components/Disclosure/Disclosure.js.map +1 -1
  83. package/dist/components/Divider/Divider.d.ts +59 -0
  84. package/dist/components/Divider/Divider.js +32 -0
  85. package/dist/components/Divider/Divider.js.map +1 -0
  86. package/dist/components/Divider/index.d.ts +1 -0
  87. package/dist/components/DocumentViewport/DocumentViewport.d.ts +8 -0
  88. package/dist/components/DocumentViewport/DocumentViewport.js.map +1 -1
  89. package/dist/components/EmptyState/EmptyState.d.ts +3 -0
  90. package/dist/components/EmptyState/EmptyState.js.map +1 -1
  91. package/dist/components/Field/Field.d.ts +6 -0
  92. package/dist/components/Field/Field.js.map +1 -1
  93. package/dist/components/FileDrop/FileDrop.d.ts +8 -0
  94. package/dist/components/FileDrop/FileDrop.js.map +1 -1
  95. package/dist/components/FloatingToolbar/FloatingToolbar.d.ts +4 -0
  96. package/dist/components/FloatingToolbar/FloatingToolbar.js +4 -4
  97. package/dist/components/FloatingToolbar/FloatingToolbar.js.map +1 -1
  98. package/dist/components/Grid/Grid.d.ts +33 -7
  99. package/dist/components/Grid/Grid.js +46 -25
  100. package/dist/components/Grid/Grid.js.map +1 -1
  101. package/dist/components/Grid/index.d.ts +1 -1
  102. package/dist/components/Heading/Heading.d.ts +57 -0
  103. package/dist/components/Heading/Heading.js +33 -0
  104. package/dist/components/Heading/Heading.js.map +1 -0
  105. package/dist/components/Heading/index.d.ts +1 -0
  106. package/dist/components/HoverCard/HoverCard.d.ts +1 -0
  107. package/dist/components/HoverCard/HoverCard.js.map +1 -1
  108. package/dist/components/IconButton/IconButton.d.ts +1 -0
  109. package/dist/components/IconButton/IconButton.js.map +1 -1
  110. package/dist/components/Image/Image.d.ts +62 -0
  111. package/dist/components/Image/Image.js +75 -0
  112. package/dist/components/Image/Image.js.map +1 -0
  113. package/dist/components/Image/index.d.ts +1 -0
  114. package/dist/components/Inline/Inline.d.ts +7 -3
  115. package/dist/components/Inline/Inline.js +19 -13
  116. package/dist/components/Inline/Inline.js.map +1 -1
  117. package/dist/components/Kbd/Kbd.d.ts +2 -0
  118. package/dist/components/Kbd/Kbd.js.map +1 -1
  119. package/dist/components/KeyValueEditor/KeyValueEditor.d.ts +7 -0
  120. package/dist/components/KeyValueEditor/KeyValueEditor.js +8 -8
  121. package/dist/components/KeyValueEditor/KeyValueEditor.js.map +1 -1
  122. package/dist/components/Link/Link.d.ts +7 -0
  123. package/dist/components/Link/Link.js.map +1 -1
  124. package/dist/components/LoadingDots/LoadingDots.d.ts +2 -0
  125. package/dist/components/LoadingDots/LoadingDots.js.map +1 -1
  126. package/dist/components/Menu/Menu.d.ts +13 -1
  127. package/dist/components/Menu/Menu.js +37 -35
  128. package/dist/components/Menu/Menu.js.map +1 -1
  129. package/dist/components/Notice/Notice.d.ts +5 -0
  130. package/dist/components/Notice/Notice.js.map +1 -1
  131. package/dist/components/NumberField/NumberField.d.ts +17 -0
  132. package/dist/components/NumberField/NumberField.js +8 -8
  133. package/dist/components/NumberField/NumberField.js.map +1 -1
  134. package/dist/components/PageHeader/PageHeader.d.ts +61 -0
  135. package/dist/components/PageHeader/PageHeader.js +63 -0
  136. package/dist/components/PageHeader/PageHeader.js.map +1 -0
  137. package/dist/components/PageHeader/index.d.ts +1 -0
  138. package/dist/components/Pagination/Pagination.d.ts +77 -0
  139. package/dist/components/Pagination/Pagination.js +120 -0
  140. package/dist/components/Pagination/Pagination.js.map +1 -0
  141. package/dist/components/Pagination/index.d.ts +1 -0
  142. package/dist/components/PanZoomCanvas/PanZoomCanvas.d.ts +4 -0
  143. package/dist/components/PanZoomCanvas/PanZoomCanvas.js.map +1 -1
  144. package/dist/components/Popover/Popover.d.ts +10 -0
  145. package/dist/components/Popover/Popover.js.map +1 -1
  146. package/dist/components/ProgressBar/ProgressBar.d.ts +5 -0
  147. package/dist/components/ProgressBar/ProgressBar.js.map +1 -1
  148. package/dist/components/ProgressOverlay/ProgressOverlay.d.ts +3 -0
  149. package/dist/components/ProgressOverlay/ProgressOverlay.js.map +1 -1
  150. package/dist/components/Prose/Prose.d.ts +1 -0
  151. package/dist/components/Prose/Prose.js.map +1 -1
  152. package/dist/components/RadioGroup/RadioGroup.d.ts +13 -0
  153. package/dist/components/RadioGroup/RadioGroup.js.map +1 -1
  154. package/dist/components/SegmentedControl/SegmentedControl.d.ts +9 -0
  155. package/dist/components/SegmentedControl/SegmentedControl.js +35 -27
  156. package/dist/components/SegmentedControl/SegmentedControl.js.map +1 -1
  157. package/dist/components/Select/Select.d.ts +18 -1
  158. package/dist/components/Select/Select.js +97 -88
  159. package/dist/components/Select/Select.js.map +1 -1
  160. package/dist/components/Select/index.d.ts +1 -0
  161. package/dist/components/SelectionFrame/SelectionFrame.d.ts +6 -0
  162. package/dist/components/SelectionFrame/SelectionFrame.js.map +1 -1
  163. package/dist/components/SideNav/SideNav.d.ts +37 -1
  164. package/dist/components/SideNav/SideNav.js +100 -73
  165. package/dist/components/SideNav/SideNav.js.map +1 -1
  166. package/dist/components/SideNav/index.d.ts +1 -1
  167. package/dist/components/SignaturePad/SignaturePad.d.ts +3 -0
  168. package/dist/components/SignaturePad/SignaturePad.js.map +1 -1
  169. package/dist/components/Skeleton/Skeleton.d.ts +1 -0
  170. package/dist/components/Skeleton/Skeleton.js.map +1 -1
  171. package/dist/components/Slider/Slider.d.ts +11 -0
  172. package/dist/components/Slider/Slider.js +6 -6
  173. package/dist/components/Slider/Slider.js.map +1 -1
  174. package/dist/components/SortableList/SortableList.d.ts +6 -0
  175. package/dist/components/SortableList/SortableList.js.map +1 -1
  176. package/dist/components/SplitPane/SplitPane.d.ts +5 -0
  177. package/dist/components/SplitPane/SplitPane.js +4 -4
  178. package/dist/components/SplitPane/SplitPane.js.map +1 -1
  179. package/dist/components/Stack/Stack.d.ts +7 -3
  180. package/dist/components/Stack/Stack.js +18 -12
  181. package/dist/components/Stack/Stack.js.map +1 -1
  182. package/dist/components/Stack/index.d.ts +1 -0
  183. package/dist/components/Stack/space.d.ts +18 -0
  184. package/dist/components/Stack/space.js +12 -0
  185. package/dist/components/Stack/space.js.map +1 -0
  186. package/dist/components/Steps/Steps.d.ts +4 -0
  187. package/dist/components/Steps/Steps.js.map +1 -1
  188. package/dist/components/Table/Table.d.ts +12 -0
  189. package/dist/components/Table/Table.js.map +1 -1
  190. package/dist/components/Tabs/Tabs.d.ts +14 -0
  191. package/dist/components/Tabs/Tabs.js +4 -4
  192. package/dist/components/Tabs/Tabs.js.map +1 -1
  193. package/dist/components/TagInput/TagInput.d.ts +18 -0
  194. package/dist/components/TagInput/TagInput.js +5 -5
  195. package/dist/components/TagInput/TagInput.js.map +1 -1
  196. package/dist/components/Text/Text.d.ts +72 -0
  197. package/dist/components/Text/Text.js +30 -0
  198. package/dist/components/Text/Text.js.map +1 -0
  199. package/dist/components/Text/index.d.ts +1 -0
  200. package/dist/components/TextArea/TextArea.d.ts +10 -0
  201. package/dist/components/TextArea/TextArea.js +4 -4
  202. package/dist/components/TextArea/TextArea.js.map +1 -1
  203. package/dist/components/TextField/TextField.d.ts +13 -0
  204. package/dist/components/TextField/TextField.js +4 -4
  205. package/dist/components/TextField/TextField.js.map +1 -1
  206. package/dist/components/ThemeToggle/ThemeToggle.d.ts +4 -0
  207. package/dist/components/ThemeToggle/ThemeToggle.js.map +1 -1
  208. package/dist/components/TimeField/TimeField.d.ts +62 -8
  209. package/dist/components/TimeField/TimeField.js +308 -72
  210. package/dist/components/TimeField/TimeField.js.map +1 -1
  211. package/dist/components/Toast/Toast.d.ts +25 -1
  212. package/dist/components/Toast/Toast.js +134 -125
  213. package/dist/components/Toast/Toast.js.map +1 -1
  214. package/dist/components/Toast/index.d.ts +1 -1
  215. package/dist/components/Toolbar/Toolbar.d.ts +3 -0
  216. package/dist/components/Toolbar/Toolbar.js.map +1 -1
  217. package/dist/components/Tooltip/Tooltip.d.ts +1 -0
  218. package/dist/components/Tooltip/Tooltip.js.map +1 -1
  219. package/dist/components/Tree/Tree.d.ts +8 -0
  220. package/dist/components/Tree/Tree.js.map +1 -1
  221. package/dist/components/VirtualList/VirtualList.d.ts +8 -0
  222. package/dist/components/VirtualList/VirtualList.js +4 -4
  223. package/dist/components/VirtualList/VirtualList.js.map +1 -1
  224. package/dist/components/ZoomControls/ZoomControls.d.ts +4 -0
  225. package/dist/components/ZoomControls/ZoomControls.js.map +1 -1
  226. package/dist/foundations/ChoiceBase/ChoiceBase.d.ts +1 -0
  227. package/dist/foundations/ChoiceBase/ChoiceBase.js.map +1 -1
  228. package/dist/foundations/HiddenValue/HiddenValue.d.ts +3 -0
  229. package/dist/foundations/HiddenValue/HiddenValue.js.map +1 -1
  230. package/dist/foundations/Icon/Icon.d.ts +3 -0
  231. package/dist/foundations/Icon/Icon.js.map +1 -1
  232. package/dist/foundations/image-outcome.d.ts +15 -0
  233. package/dist/foundations/image-outcome.js +39 -0
  234. package/dist/foundations/image-outcome.js.map +1 -0
  235. package/dist/foundations/option-icon.d.ts +26 -0
  236. package/dist/foundations/option-icon.js +16 -0
  237. package/dist/foundations/option-icon.js.map +1 -0
  238. package/dist/icons/index.d.ts +1 -0
  239. package/dist/icons/index.js +476 -474
  240. package/dist/icons/keywords.d.ts +249 -0
  241. package/dist/icons/keywords.js +1728 -0
  242. package/dist/icons/keywords.js.map +1 -0
  243. package/dist/index.d.ts +20 -9
  244. package/dist/index.js +240 -213
  245. package/dist/styles/app-shell.css +1 -1
  246. package/dist/styles/aspect-ratio.css +1 -0
  247. package/dist/styles/avatar.css +1 -0
  248. package/dist/styles/breadcrumbs.css +1 -0
  249. package/dist/styles/calendar.css +1 -1
  250. package/dist/styles/card.css +1 -1
  251. package/dist/styles/checkbox.css +1 -1
  252. package/dist/styles/checklist.css +1 -0
  253. package/dist/styles/container.css +1 -0
  254. package/dist/styles/divider.css +1 -0
  255. package/dist/styles/generated-css.d.ts +1 -1
  256. package/dist/styles/generated-css.js +1 -1
  257. package/dist/styles/generated-css.js.map +1 -1
  258. package/dist/styles/grid.css +1 -1
  259. package/dist/styles/heading.css +1 -0
  260. package/dist/styles/image.css +1 -0
  261. package/dist/styles/menu.css +1 -1
  262. package/dist/styles/page-header.css +1 -0
  263. package/dist/styles/pagination.css +1 -0
  264. package/dist/styles/segmented-control.css +1 -1
  265. package/dist/styles/side-nav.css +1 -1
  266. package/dist/styles/stack.css +1 -1
  267. package/dist/styles/text.css +1 -0
  268. package/dist/styles/time-field.css +1 -1
  269. package/dist/styles/toast.css +1 -1
  270. package/dist/styles.css +1 -1
  271. package/dist/theme/CynosureTheme.d.ts +4 -0
  272. package/dist/theme/CynosureTheme.js.map +1 -1
  273. package/dist/tokens/to-css.js +12 -12
  274. package/dist/tokens/to-css.js.map +1 -1
  275. package/package.json +4 -3
@@ -0,0 +1,61 @@
1
+ import { type CSSProperties, type ReactNode } from "react";
2
+ export interface PageHeaderTokens {
3
+ /** Space between the breadcrumbs, the title block, the actions and the content below them. */
4
+ gap: string;
5
+ /** Space between the eyebrow, the title, the description and the meta row. */
6
+ textGap: string;
7
+ /** Space between two actions and between items of the meta row. */
8
+ actionsGap: string;
9
+ /** Longest line of the description. */
10
+ descriptionMaxWidth: string;
11
+ /** Colour of the bottom border drawn by `divider`. */
12
+ dividerColor: string;
13
+ /** Space between the header's content and the bottom border drawn by `divider`. */
14
+ dividerSpace: string;
15
+ }
16
+ declare module "../../tokens/schema.js" {
17
+ interface ComponentTokens {
18
+ pageHeader: PageHeaderTokens;
19
+ }
20
+ }
21
+ export interface PageHeaderProps {
22
+ /** What the page or section is. Rendered as the header's one heading. */
23
+ title: ReactNode;
24
+ /** Heading level of the title, to fit the page outline. Default 1. */
25
+ headingLevel?: 1 | 2 | 3;
26
+ /**
27
+ * Size of the title. "md" is the usual size of the heading level (level 1 "2xl", level 2 "xl", level 3 "lg" in
28
+ * Heading's sizes); "lg" is the hero "display" size for a landing page. Default "md".
29
+ */
30
+ size?: "md" | "lg";
31
+ /** A short label above the title that says where the page belongs. It comes before the title in reading order. */
32
+ eyebrow?: ReactNode | undefined;
33
+ /** One or two sentences under the title, as a lead paragraph. Pass inline content only. */
34
+ description?: ReactNode | undefined;
35
+ /** The trail to this page, shown above the eyebrow and the title. Pass a `Breadcrumbs`. */
36
+ breadcrumbs?: ReactNode | undefined;
37
+ /**
38
+ * The page's buttons. They sit at the inline end, level with the top of the title block, and move below the text
39
+ * when the header itself is narrower than 36rem or when `align` is "center".
40
+ */
41
+ actions?: ReactNode | undefined;
42
+ /** A row under the description for badges, dates and authors. It wraps. */
43
+ meta?: ReactNode | undefined;
44
+ /** Anything below the rest of the header, at full width: tabs, a search field. */
45
+ children?: ReactNode;
46
+ /** "start" for pages; "center" centres the text and puts the actions below it, for landing pages. Default "start". */
47
+ align?: "start" | "center";
48
+ /** Draws a bottom border with space above it, to separate the header from the page. Default false. */
49
+ divider?: boolean;
50
+ /**
51
+ * The element rendered. A `header` inside `main` is not a banner landmark, so no choice adds a landmark.
52
+ * Default "header".
53
+ */
54
+ as?: "header" | "div" | "section";
55
+ /** Added to the root element, for layout. */
56
+ className?: string | undefined;
57
+ /** Layout only. Restyle through --cy-page-header-* tokens. */
58
+ style?: CSSProperties | undefined;
59
+ }
60
+ /** The top of a page or a major section: where you are, what this is, a sentence about it and the page's actions. */
61
+ export declare const PageHeader: import("react").ForwardRefExoticComponent<PageHeaderProps & import("react").RefAttributes<HTMLElement>>;
@@ -0,0 +1,63 @@
1
+ "use client";
2
+ import { Heading as f } from "../Heading/Heading.js";
3
+ import { Text as m } from "../Text/Text.js";
4
+ import { forwardRef as x } from "react";
5
+ import { jsx as e, jsxs as a } from "react/jsx-runtime";
6
+ var P = x(function({ title: p, headingLevel: y = 1, size: r = "md", eyebrow: d, description: c, breadcrumbs: s, actions: i, meta: l, children: t, align: n = "start", divider: g = !1, as: o = "header", className: h, style: v }, N) {
7
+ return /* @__PURE__ */ a(o, {
8
+ ref: N,
9
+ className: h ? `cy-page-header ${h}` : "cy-page-header",
10
+ "data-size": r,
11
+ "data-align": n,
12
+ "data-divider": g ? "" : void 0,
13
+ style: v,
14
+ children: [
15
+ s && /* @__PURE__ */ e("div", {
16
+ className: "cy-page-header-breadcrumbs cy-reset",
17
+ children: s
18
+ }),
19
+ /* @__PURE__ */ a("div", {
20
+ className: "cy-page-header-main cy-reset",
21
+ children: [/* @__PURE__ */ a("div", {
22
+ className: "cy-page-header-text cy-reset",
23
+ children: [
24
+ d && /* @__PURE__ */ e(m, {
25
+ as: "p",
26
+ variant: "eyebrow",
27
+ className: "cy-page-header-eyebrow",
28
+ children: d
29
+ }),
30
+ /* @__PURE__ */ e(f, {
31
+ level: y,
32
+ ...r === "lg" ? { size: "display" } : {},
33
+ className: "cy-page-header-title",
34
+ children: p
35
+ }),
36
+ c && /* @__PURE__ */ e(m, {
37
+ as: "p",
38
+ variant: "lead",
39
+ className: "cy-page-header-description",
40
+ children: c
41
+ }),
42
+ l && /* @__PURE__ */ e("div", {
43
+ className: "cy-page-header-meta",
44
+ children: l
45
+ })
46
+ ]
47
+ }), i && /* @__PURE__ */ e("div", {
48
+ className: "cy-page-header-actions cy-reset",
49
+ children: i
50
+ })]
51
+ }),
52
+ t && /* @__PURE__ */ e("div", {
53
+ className: "cy-page-header-body cy-reset",
54
+ children: t
55
+ })
56
+ ]
57
+ });
58
+ });
59
+ export {
60
+ P as PageHeader
61
+ };
62
+
63
+ //# sourceMappingURL=PageHeader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PageHeader.js","names":["Heading","Text","forwardRef","jsx","jsxs","PageHeader","title","headingLevel","size","eyebrow","description","breadcrumbs","actions","meta","children","align","divider","Tag","className","style","ref"],"sources":["../../../src/components/PageHeader/PageHeader.tsx"],"sourcesContent":["import { type CSSProperties, forwardRef, type ReactNode } from \"react\";\nimport { Heading } from \"../Heading/Heading.js\";\nimport { Text } from \"../Text/Text.js\";\n\nexport interface PageHeaderTokens {\n /** Space between the breadcrumbs, the title block, the actions and the content below them. */\n gap: string;\n /** Space between the eyebrow, the title, the description and the meta row. */\n textGap: string;\n /** Space between two actions and between items of the meta row. */\n actionsGap: string;\n /** Longest line of the description. */\n descriptionMaxWidth: string;\n /** Colour of the bottom border drawn by `divider`. */\n dividerColor: string;\n /** Space between the header's content and the bottom border drawn by `divider`. */\n dividerSpace: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n pageHeader: PageHeaderTokens;\n }\n}\n\nexport interface PageHeaderProps {\n /** What the page or section is. Rendered as the header's one heading. */\n title: ReactNode;\n /** Heading level of the title, to fit the page outline. Default 1. */\n headingLevel?: 1 | 2 | 3;\n /**\n * Size of the title. \"md\" is the usual size of the heading level (level 1 \"2xl\", level 2 \"xl\", level 3 \"lg\" in\n * Heading's sizes); \"lg\" is the hero \"display\" size for a landing page. Default \"md\".\n */\n size?: \"md\" | \"lg\";\n /** A short label above the title that says where the page belongs. It comes before the title in reading order. */\n eyebrow?: ReactNode | undefined;\n /** One or two sentences under the title, as a lead paragraph. Pass inline content only. */\n description?: ReactNode | undefined;\n /** The trail to this page, shown above the eyebrow and the title. Pass a `Breadcrumbs`. */\n breadcrumbs?: ReactNode | undefined;\n /**\n * The page's buttons. They sit at the inline end, level with the top of the title block, and move below the text\n * when the header itself is narrower than 36rem or when `align` is \"center\".\n */\n actions?: ReactNode | undefined;\n /** A row under the description for badges, dates and authors. It wraps. */\n meta?: ReactNode | undefined;\n /** Anything below the rest of the header, at full width: tabs, a search field. */\n children?: ReactNode;\n /** \"start\" for pages; \"center\" centres the text and puts the actions below it, for landing pages. Default \"start\". */\n align?: \"start\" | \"center\";\n /** Draws a bottom border with space above it, to separate the header from the page. Default false. */\n divider?: boolean;\n /**\n * The element rendered. A `header` inside `main` is not a banner landmark, so no choice adds a landmark.\n * Default \"header\".\n */\n as?: \"header\" | \"div\" | \"section\";\n /** Added to the root element, for layout. */\n className?: string | undefined;\n /** Layout only. Restyle through --cy-page-header-* tokens. */\n style?: CSSProperties | undefined;\n}\n\n/** The top of a page or a major section: where you are, what this is, a sentence about it and the page's actions. */\nexport const PageHeader = forwardRef<HTMLElement, PageHeaderProps>(function PageHeader(\n {\n title,\n headingLevel = 1,\n size = \"md\",\n eyebrow,\n description,\n breadcrumbs,\n actions,\n meta,\n children,\n align = \"start\",\n divider = false,\n as: Tag = \"header\",\n className,\n style,\n },\n ref,\n) {\n return (\n <Tag\n // One component, three elements: the ref is the element's own, typed as the common HTMLElement.\n ref={ref as never}\n className={className ? `cy-page-header ${className}` : \"cy-page-header\"}\n data-size={size}\n data-align={align}\n data-divider={divider ? \"\" : undefined}\n style={style}\n >\n {breadcrumbs && <div className=\"cy-page-header-breadcrumbs cy-reset\">{breadcrumbs}</div>}\n <div className=\"cy-page-header-main cy-reset\">\n <div className=\"cy-page-header-text cy-reset\">\n {eyebrow && (\n <Text as=\"p\" variant=\"eyebrow\" className=\"cy-page-header-eyebrow\">\n {eyebrow}\n </Text>\n )}\n <Heading\n level={headingLevel}\n {...(size === \"lg\" ? { size: \"display\" as const } : {})}\n className=\"cy-page-header-title\"\n >\n {title}\n </Heading>\n {description && (\n <Text as=\"p\" variant=\"lead\" className=\"cy-page-header-description\">\n {description}\n </Text>\n )}\n {meta && <div className=\"cy-page-header-meta\">{meta}</div>}\n </div>\n {actions && <div className=\"cy-page-header-actions cy-reset\">{actions}</div>}\n </div>\n {children && <div className=\"cy-page-header-body cy-reset\">{children}</div>}\n </Tag>\n );\n});\n"],"mappings":";;;;;AAkEA,IAAaK,IAAaH,EAAyC,SACjE,EACE,OAAAI,GACA,cAAAC,IAAe,GACf,MAAAC,IAAO,MACP,SAAAC,GACA,aAAAC,GACA,aAAAC,GACA,SAAAC,GACA,MAAAC,GACA,UAAAC,GACA,OAAAC,IAAQ,SACR,SAAAC,IAAU,IACV,IAAIC,IAAM,UACV,WAAAC,GACA,OAAAC,EAAA,GAEFC,GACA;AACA,SACE,gBAAAhB,EAACa,GAAD;AAAA,IAEO,KAAAG;AAAA,IACL,WAAWF,IAAY,kBAAkBA,CAAA,KAAc;AAAA,IACvD,aAAWV;AAAA,IACX,cAAYO;AAAA,IACZ,gBAAcC,IAAU,KAAK;AAAA,IACtB,OAAAG;AAAA,IAPT,UAAA;AAAA,MASGR,KAAe,gBAAAR,EAAC,OAAD;AAAA,QAAK,WAAU;AAAA,QAAuC,UAAAQ;AAAA,MAAiB,CAAA;AAAA,MACvF,gBAAAP,EAAC,OAAD;AAAA,QAAK,WAAU;AAAA,QAAf,UAAA,CACE,gBAAAA,EAAC,OAAD;AAAA,UAAK,WAAU;AAAA,UAAf,UAAA;AAAA,YACGK,KACC,gBAAAN,EAACF,GAAD;AAAA,cAAM,IAAG;AAAA,cAAI,SAAQ;AAAA,cAAU,WAAU;AAAA,cACtC,UAAAQ;AAAA,YACG,CAAA;AAAA,YAER,gBAAAN,EAACH,GAAD;AAAA,cACE,OAAOO;AAAA,cACP,GAAKC,MAAS,OAAO,EAAE,MAAM,UAAmB,IAAI,CAAC;AAAA,cACrD,WAAU;AAAA,cAET,UAAAF;AAAA,YACM,CAAA;AAAA,YACRI,KACC,gBAAAP,EAACF,GAAD;AAAA,cAAM,IAAG;AAAA,cAAI,SAAQ;AAAA,cAAO,WAAU;AAAA,cACnC,UAAAS;AAAA,YACG,CAAA;AAAA,YAEPG,KAAQ,gBAAAV,EAAC,OAAD;AAAA,cAAK,WAAU;AAAA,cAAuB,UAAAU;AAAA,YAAU,CAAA;AAAA,UACtD;AAAA,QACJ,CAAA,GAAAD,KAAW,gBAAAT,EAAC,OAAD;AAAA,UAAK,WAAU;AAAA,UAAmC,UAAAS;AAAA,QAAa,CAAA,CACxE;AAAA,M;A,MACJE,KAAY,gBAAAX,EAAC,OAAD;AAAA,QAAK,WAAU;AAAA,QAAgC,UAAAW;AAAA,MAAc,CAAA;AAAA,IACvE;AAAA,E;AAET,CAAC"}
@@ -0,0 +1 @@
1
+ export { PageHeader, type PageHeaderProps, type PageHeaderTokens } from "./PageHeader.js";
@@ -0,0 +1,77 @@
1
+ import { type CSSProperties, type MouseEvent } from "react";
2
+ export interface PaginationTokens {
3
+ /** Space between the controls. */
4
+ gap: string;
5
+ /** Inline padding of a page number (its width is never less than its height). */
6
+ pagePadding: string;
7
+ /** Colour of the ellipsis and of the "Page 3 of 10" text. */
8
+ mutedColor: string;
9
+ }
10
+ declare module "../../tokens/schema.js" {
11
+ interface ComponentTokens {
12
+ pagination: PaginationTokens;
13
+ }
14
+ }
15
+ export interface PaginationLabels {
16
+ /** Name of the navigation landmark. */
17
+ nav: string;
18
+ /** Name of the previous-page control. */
19
+ previous: string;
20
+ /** Name of the next-page control. */
21
+ next: string;
22
+ /** Name of the first-page control. */
23
+ first: string;
24
+ /** Name of the last-page control. */
25
+ last: string;
26
+ /** Name of a page number. The current one also carries `aria-current="page"`, so do not add "current" here. */
27
+ page: (page: number) => string;
28
+ /** Text of the compact variant, also announced when the page changes. */
29
+ status: (page: number, count: number) => string;
30
+ }
31
+ /** How many pages `total` items make at `pageSize` items a page: never less than 1. */
32
+ export declare function pageCount(total: number, pageSize: number): number;
33
+ /**
34
+ * The pages to show for `page` of `count`, in order, with `"gap"` where pages are left out. `boundaries` pages are
35
+ * always shown at each end and `siblings` each side of the current one. The list has the same length on every page
36
+ * (so the controls do not move under the pointer), and a gap never stands for a single page.
37
+ */
38
+ export declare function pageRange(page: number, count: number, siblings?: number, boundaries?: number): (number | "gap")[];
39
+ export interface PaginationProps {
40
+ /** How many pages there are. From a number of items, use `pageCount(total, pageSize)`. One page or fewer renders nothing. */
41
+ count: number;
42
+ /** The current page, from 1 (controlled). Values outside 1 to `count` are clamped. */
43
+ page?: number | undefined;
44
+ /** The page shown first when uncontrolled. Default 1. */
45
+ defaultPage?: number;
46
+ /**
47
+ * Called with the new page when a control is pressed, and with the click event. With `getHref`, a client-side router
48
+ * calls `event.preventDefault()` here to stop the browser following the link, then navigates itself.
49
+ */
50
+ onChange?: ((page: number, event: MouseEvent<HTMLElement>) => void) | undefined;
51
+ /** Pages shown each side of the current one. Default 1. */
52
+ siblings?: number;
53
+ /** Pages always shown at each end. Default 1. */
54
+ boundaries?: number;
55
+ /** `pages` shows numbered pages; `compact` shows only previous and next around "Page 3 of 10", for phones and tight spaces. Default "pages". */
56
+ variant?: "pages" | "compact";
57
+ /** Adds first-page and last-page controls. Default false. */
58
+ showEdges?: boolean;
59
+ /**
60
+ * The address of a page. When given, every page number and every control that leads to another page is a real link
61
+ * to it (works without JavaScript, opens in a new tab); the current page is a link with `aria-current="page"`.
62
+ * `onChange` still fires on a plain click.
63
+ */
64
+ getHref?: ((page: number) => string) | undefined;
65
+ /** Disables every control. Default false. */
66
+ disabled?: boolean;
67
+ /** Height and text size of the controls. Default "md". */
68
+ size?: "sm" | "md";
69
+ /** Replaces the built-in English strings. */
70
+ labels?: Partial<PaginationLabels> | undefined;
71
+ /** Added to the `nav` element, for layout. */
72
+ className?: string | undefined;
73
+ /** Layout only. Restyle through `--cy-pagination-*` tokens. */
74
+ style?: CSSProperties | undefined;
75
+ }
76
+ /** Moves between the pages of a list or table: a `nav` landmark of Buttons, with the current page marked. */
77
+ export declare const Pagination: import("react").ForwardRefExoticComponent<PaginationProps & import("react").RefAttributes<HTMLElement>>;
@@ -0,0 +1,120 @@
1
+ "use client";
2
+ import { useControllableState as F } from "../../foundations/controllable.js";
3
+ import { Icon as I } from "../../foundations/Icon/Icon.js";
4
+ import { useClientLayoutEffect as S } from "../../foundations/client-layout-effect.js";
5
+ import { Button as T } from "../Button/Button.js";
6
+ import { clamp as B } from "../../foundations/math.js";
7
+ import { IconButton as q } from "../IconButton/IconButton.js";
8
+ import { chevronRight as w } from "../../icons/chevron-right.js";
9
+ import { moreHorizontal as V } from "../../icons/more-horizontal.js";
10
+ import { chevronLeft as _ } from "../../icons/chevron-left.js";
11
+ import { chevronFirst as D } from "../../icons/chevron-first.js";
12
+ import { chevronLast as G } from "../../icons/chevron-last.js";
13
+ import { forwardRef as H, useRef as K } from "react";
14
+ import { jsx as i, jsxs as J } from "react/jsx-runtime";
15
+ var O = {
16
+ nav: "Pagination",
17
+ previous: "Previous page",
18
+ next: "Next page",
19
+ first: "First page",
20
+ last: "Last page",
21
+ page: (n) => `Page ${n}`,
22
+ status: (n, o) => `Page ${n} of ${o}`
23
+ }, y = (n, o) => Math.max(o, Math.floor(n) || 0);
24
+ function it(n, o) {
25
+ return o > 0 ? y(Math.ceil(n / o), 1) : 1;
26
+ }
27
+ function Q(n, o, N = 1, C = 1) {
28
+ const e = y(o, 0), f = y(N, 0), r = y(C, 0), s = (m, d) => Array.from({ length: d - m + 1 }, (M, v) => m + v);
29
+ if (e <= r * 2 + f * 2 + 3) return s(1, e);
30
+ const p = B(n - f, r + 2, e - r - f * 2 - 1), h = p + f * 2;
31
+ return [
32
+ ...s(1, r),
33
+ p > r + 2 ? "gap" : r + 1,
34
+ ...s(p, h),
35
+ h < e - r - 1 ? "gap" : e - r,
36
+ ...s(e - r + 1, e)
37
+ ];
38
+ }
39
+ var st = H(function({ count: o, page: N, defaultPage: C = 1, onChange: e, siblings: f = 1, boundaries: r = 1, variant: s = "pages", showEdges: p = !1, getHref: h, disabled: m = !1, size: d = "md", labels: M, className: v, style: j }, k) {
40
+ const l = {
41
+ ...O,
42
+ ...M
43
+ }, g = y(o, 1), [A, E] = F(N, C), c = B(Math.round(A) || 1, 1, g), P = K(null), L = K(null);
44
+ if (S(() => {
45
+ const t = L.current;
46
+ if (L.current = null, !t || t.isConnected && !t.matches(":disabled")) return;
47
+ const a = (u) => P.current?.querySelector(u);
48
+ (a("[aria-current]") ?? a(".cy-button:not(:disabled)"))?.focus();
49
+ }), g <= 1) return null;
50
+ const $ = (t) => (a) => {
51
+ if (h && (a.metaKey || a.ctrlKey || a.shiftKey || a.altKey)) return;
52
+ const u = a.currentTarget;
53
+ u.getRootNode().activeElement === u && (L.current = u), t !== c && (E(t), e?.(t, a));
54
+ }, b = (t, a) => a ? void 0 : h?.(t), x = (t, a, u) => {
55
+ const R = m || t === c;
56
+ return /* @__PURE__ */ i("li", {
57
+ className: "cy-reset cy-pagination-item",
58
+ children: /* @__PURE__ */ i(q, {
59
+ icon: a,
60
+ label: u,
61
+ size: d,
62
+ variant: "ghost",
63
+ disabled: R,
64
+ href: b(t, R),
65
+ onClick: $(t)
66
+ })
67
+ });
68
+ };
69
+ return /* @__PURE__ */ i("nav", {
70
+ ref: k,
71
+ className: `cy-pagination${v ? ` ${v}` : ""}`,
72
+ "aria-label": l.nav,
73
+ "data-size": d,
74
+ "data-variant": s,
75
+ style: j,
76
+ children: /* @__PURE__ */ J("ol", {
77
+ ref: P,
78
+ className: "cy-reset cy-pagination-list",
79
+ children: [
80
+ p && x(1, D, l.first),
81
+ x(Math.max(1, c - 1), _, l.previous),
82
+ s === "compact" ? /* @__PURE__ */ i("li", {
83
+ className: "cy-reset cy-pagination-item",
84
+ children: /* @__PURE__ */ i("span", {
85
+ className: "cy-reset cy-pagination-status",
86
+ role: "status",
87
+ children: l.status(c, g)
88
+ })
89
+ }) : Q(c, g, f, r).map((t, a) => t === "gap" ? /* @__PURE__ */ i("li", {
90
+ className: "cy-reset cy-pagination-gap",
91
+ "aria-hidden": "true",
92
+ children: /* @__PURE__ */ i(I, { icon: V })
93
+ }, `gap-${a}`) : /* @__PURE__ */ i("li", {
94
+ className: "cy-reset cy-pagination-item",
95
+ children: /* @__PURE__ */ i(T, {
96
+ className: "cy-pagination-page",
97
+ size: d,
98
+ variant: t === c ? "soft" : "ghost",
99
+ tone: t === c ? "accent" : "neutral",
100
+ "aria-label": l.page(t),
101
+ "aria-current": t === c ? "page" : void 0,
102
+ disabled: m,
103
+ href: b(t, m),
104
+ onClick: $(t),
105
+ children: t
106
+ })
107
+ }, t)),
108
+ x(Math.min(g, c + 1), w, l.next),
109
+ p && x(g, G, l.last)
110
+ ]
111
+ })
112
+ });
113
+ });
114
+ export {
115
+ st as Pagination,
116
+ it as pageCount,
117
+ Q as pageRange
118
+ };
119
+
120
+ //# sourceMappingURL=Pagination.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Pagination.js","names":["useControllableState","Icon","useClientLayoutEffect","Button","clamp","IconButton","chevronRight","moreHorizontal","chevronLeft","chevronFirst","chevronLast","forwardRef","useRef","jsx","jsxs","LABELS","page","count","whole","least","pageCount","total","pageSize","pageRange","siblings","boundaries","last","side","edge","run","from","to","_","i","Pagination","defaultPage","onChange","variant","showEdges","getHref","disabled","size","labels","className","style","ref","text","value","setValue","current","list","pressed","find","selector","go","event","control","hrefTo","off","step","icon","label","item","index"],"sources":["../../../src/components/Pagination/Pagination.tsx"],"sourcesContent":["import { type CSSProperties, forwardRef, type MouseEvent, useRef } from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { Icon } from \"../../foundations/Icon/Icon.js\";\nimport { clamp } from \"../../foundations/math.js\";\nimport { chevronFirst } from \"../../icons/chevron-first.js\";\nimport { chevronLast } from \"../../icons/chevron-last.js\";\nimport { chevronLeft } from \"../../icons/chevron-left.js\";\nimport { chevronRight } from \"../../icons/chevron-right.js\";\nimport { moreHorizontal } from \"../../icons/more-horizontal.js\";\nimport type { IconData } from \"../../icons/types.js\";\nimport { Button } from \"../Button/Button.js\";\nimport { IconButton } from \"../IconButton/IconButton.js\";\n\nexport interface PaginationTokens {\n /** Space between the controls. */\n gap: string;\n /** Inline padding of a page number (its width is never less than its height). */\n pagePadding: string;\n /** Colour of the ellipsis and of the \"Page 3 of 10\" text. */\n mutedColor: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n pagination: PaginationTokens;\n }\n}\n\nexport interface PaginationLabels {\n /** Name of the navigation landmark. */\n nav: string;\n /** Name of the previous-page control. */\n previous: string;\n /** Name of the next-page control. */\n next: string;\n /** Name of the first-page control. */\n first: string;\n /** Name of the last-page control. */\n last: string;\n /** Name of a page number. The current one also carries `aria-current=\"page\"`, so do not add \"current\" here. */\n page: (page: number) => string;\n /** Text of the compact variant, also announced when the page changes. */\n status: (page: number, count: number) => string;\n}\n\nconst LABELS: PaginationLabels = {\n nav: \"Pagination\",\n previous: \"Previous page\",\n next: \"Next page\",\n first: \"First page\",\n last: \"Last page\",\n page: (page) => `Page ${page}`,\n status: (page, count) => `Page ${page} of ${count}`,\n};\n\nconst whole = (n: number, least: number) => Math.max(least, Math.floor(n) || 0);\n\n/** How many pages `total` items make at `pageSize` items a page: never less than 1. */\nexport function pageCount(total: number, pageSize: number): number {\n return pageSize > 0 ? whole(Math.ceil(total / pageSize), 1) : 1;\n}\n\n/**\n * The pages to show for `page` of `count`, in order, with `\"gap\"` where pages are left out. `boundaries` pages are\n * always shown at each end and `siblings` each side of the current one. The list has the same length on every page\n * (so the controls do not move under the pointer), and a gap never stands for a single page.\n */\nexport function pageRange(page: number, count: number, siblings = 1, boundaries = 1): (number | \"gap\")[] {\n const last = whole(count, 0);\n const side = whole(siblings, 0);\n const edge = whole(boundaries, 0);\n const run = (from: number, to: number) => Array.from({ length: to - from + 1 }, (_, i) => from + i);\n if (last <= edge * 2 + side * 2 + 3) return run(1, last);\n const from = clamp(page - side, edge + 2, last - edge - side * 2 - 1);\n const to = from + side * 2;\n return [\n ...run(1, edge),\n from > edge + 2 ? \"gap\" : edge + 1,\n ...run(from, to),\n to < last - edge - 1 ? \"gap\" : last - edge,\n ...run(last - edge + 1, last),\n ];\n}\n\nexport interface PaginationProps {\n /** How many pages there are. From a number of items, use `pageCount(total, pageSize)`. One page or fewer renders nothing. */\n count: number;\n /** The current page, from 1 (controlled). Values outside 1 to `count` are clamped. */\n page?: number | undefined;\n /** The page shown first when uncontrolled. Default 1. */\n defaultPage?: number;\n /**\n * Called with the new page when a control is pressed, and with the click event. With `getHref`, a client-side router\n * calls `event.preventDefault()` here to stop the browser following the link, then navigates itself.\n */\n onChange?: ((page: number, event: MouseEvent<HTMLElement>) => void) | undefined;\n /** Pages shown each side of the current one. Default 1. */\n siblings?: number;\n /** Pages always shown at each end. Default 1. */\n boundaries?: number;\n /** `pages` shows numbered pages; `compact` shows only previous and next around \"Page 3 of 10\", for phones and tight spaces. Default \"pages\". */\n variant?: \"pages\" | \"compact\";\n /** Adds first-page and last-page controls. Default false. */\n showEdges?: boolean;\n /**\n * The address of a page. When given, every page number and every control that leads to another page is a real link\n * to it (works without JavaScript, opens in a new tab); the current page is a link with `aria-current=\"page\"`.\n * `onChange` still fires on a plain click.\n */\n getHref?: ((page: number) => string) | undefined;\n /** Disables every control. Default false. */\n disabled?: boolean;\n /** Height and text size of the controls. Default \"md\". */\n size?: \"sm\" | \"md\";\n /** Replaces the built-in English strings. */\n labels?: Partial<PaginationLabels> | undefined;\n /** Added to the `nav` element, for layout. */\n className?: string | undefined;\n /** Layout only. Restyle through `--cy-pagination-*` tokens. */\n style?: CSSProperties | undefined;\n}\n\n/** Moves between the pages of a list or table: a `nav` landmark of Buttons, with the current page marked. */\nexport const Pagination = forwardRef<HTMLElement, PaginationProps>(function Pagination(\n {\n count,\n page,\n defaultPage = 1,\n onChange,\n siblings = 1,\n boundaries = 1,\n variant = \"pages\",\n showEdges = false,\n getHref,\n disabled = false,\n size = \"md\",\n labels,\n className,\n style,\n },\n ref,\n) {\n const text = { ...LABELS, ...labels };\n const last = whole(count, 1);\n const [value, setValue] = useControllableState(page, defaultPage);\n const current = clamp(Math.round(value) || 1, 1, last);\n const list = useRef<HTMLOListElement>(null);\n const pressed = useRef<Element | null>(null);\n\n // The pressed control had focus and can no longer hold it (previous on reaching page 1, where it is disabled or,\n // as a link, replaced by a button): focus goes to the current page, or to the control that still works.\n useClientLayoutEffect(() => {\n const from = pressed.current;\n pressed.current = null;\n if (!from || (from.isConnected && !from.matches(\":disabled\"))) return;\n const find = (selector: string) => list.current?.querySelector<HTMLElement>(selector);\n (find(\"[aria-current]\") ?? find(\".cy-button:not(:disabled)\"))?.focus();\n });\n\n if (last <= 1) return null;\n\n const go = (to: number) => (event: MouseEvent<HTMLElement>) => {\n // A link opened in a new tab or window leaves this page where it is.\n if (getHref && (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)) return;\n const control = event.currentTarget;\n if ((control.getRootNode() as Document | ShadowRoot).activeElement === control) pressed.current = control;\n if (to === current) return;\n setValue(to);\n onChange?.(to, event);\n };\n const hrefTo = (to: number, off: boolean) => (off ? undefined : getHref?.(to));\n const step = (to: number, icon: IconData, label: string) => {\n const off = disabled || to === current;\n return (\n <li className=\"cy-reset cy-pagination-item\">\n <IconButton\n icon={icon}\n label={label}\n size={size}\n variant=\"ghost\"\n disabled={off}\n href={hrefTo(to, off)}\n onClick={go(to)}\n />\n </li>\n );\n };\n\n return (\n <nav\n ref={ref}\n className={`cy-pagination${className ? ` ${className}` : \"\"}`}\n aria-label={text.nav}\n data-size={size}\n data-variant={variant}\n style={style}\n >\n <ol ref={list} className=\"cy-reset cy-pagination-list\">\n {showEdges && step(1, chevronFirst, text.first)}\n {step(Math.max(1, current - 1), chevronLeft, text.previous)}\n {variant === \"compact\" ? (\n <li className=\"cy-reset cy-pagination-item\">\n <span className=\"cy-reset cy-pagination-status\" role=\"status\">\n {text.status(current, last)}\n </span>\n </li>\n ) : (\n pageRange(current, last, siblings, boundaries).map((item, index) =>\n item === \"gap\" ? (\n // Not a control and nothing to read: the page names on each side already say what is left out.\n <li key={`gap-${index}`} className=\"cy-reset cy-pagination-gap\" aria-hidden=\"true\">\n <Icon icon={moreHorizontal} />\n </li>\n ) : (\n <li key={item} className=\"cy-reset cy-pagination-item\">\n <Button\n className=\"cy-pagination-page\"\n size={size}\n variant={item === current ? \"soft\" : \"ghost\"}\n tone={item === current ? \"accent\" : \"neutral\"}\n aria-label={text.page(item)}\n aria-current={item === current ? \"page\" : undefined}\n disabled={disabled}\n href={hrefTo(item, disabled)}\n onClick={go(item)}\n >\n {item}\n </Button>\n </li>\n ),\n )\n )}\n {step(Math.min(last, current + 1), chevronRight, text.next)}\n {showEdges && step(last, chevronLast, text.last)}\n </ol>\n </nav>\n );\n});\n"],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export { Pagination, type PaginationLabels, type PaginationProps, type PaginationTokens, pageCount, pageRange, } from "./Pagination.js";
@@ -44,9 +44,11 @@ export interface PanZoomCanvasLabels {
44
44
  export interface PanZoomCanvasProps {
45
45
  /** Names the canvas ("Schema diagram"). */
46
46
  label: string;
47
+ /** Controlled view: the pan offset and the zoom. */
47
48
  view?: CanvasView | undefined;
48
49
  /** Where it starts. Default: `bounds` fitted in view (or the origin at 100% without bounds). */
49
50
  defaultView?: CanvasView;
51
+ /** Called with the new view on every pan and zoom. */
50
52
  onViewChange?: ((view: CanvasView) => void) | undefined;
51
53
  /** The content's extent in canvas units, for fitting and the minimap. */
52
54
  bounds?: CanvasRect | undefined;
@@ -62,7 +64,9 @@ export interface PanZoomCanvasProps {
62
64
  renderScreen?: (screen: CanvasScreen) => ReactNode;
63
65
  /** The content, placed in canvas units (absolutely positioned children). */
64
66
  children?: ReactNode;
67
+ /** Replace the built-in English text: the zoom announcement. */
65
68
  labels?: Partial<PanZoomCanvasLabels>;
69
+ /** Added to the root element, for layout. */
66
70
  className?: string;
67
71
  /** Layout only (give it a height). Restyle through --cy-pan-zoom-canvas-* tokens. */
68
72
  style?: CSSProperties;
@@ -1 +1 @@
1
- {"version":3,"file":"PanZoomCanvas.js","names":["_Fragment","useControllableState","useClientLayoutEffect","clamp","useDrag","clampPercent","useZoomGestures","forwardRef","useImperativeHandle","useRef","useState","Fragment$1","jsx","jsxs","DEFAULT_LABELS","percent","MIN","MAX","STEP","PanZoomCanvas","label","view","defaultView","onViewChange","bounds","minimap","renderMinimap","renderScreen","children","labels","className","style","ref","text","surface","current","setView","latest","size","setSize","el","measure","s","observer","go","next","zoomAround","scale","at","v","centre","fit","rect","pad","centreOn","p","fitted","gestures","dx","dy","onKeyDown","event","by","move","said","setSaid","map","mapWidth","setMapWidth","w","k","seen","lookAt","mx","my","point","r"],"sources":["../../../src/components/PanZoomCanvas/PanZoomCanvas.tsx"],"sourcesContent":["import {\n type CSSProperties,\n forwardRef,\n type KeyboardEvent,\n type ReactNode,\n useImperativeHandle,\n useRef,\n useState,\n} from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { useDrag } from \"../../foundations/drag.js\";\nimport { clamp } from \"../../foundations/math.js\";\nimport { clampPercent, MAX_PERCENT, MIN_PERCENT } from \"../../foundations/zoom.js\";\nimport { useZoomGestures, type ZoomAnchor } from \"../../foundations/zoom-gestures.js\";\n\nexport interface PanZoomCanvasTokens {\n /** Behind the content. */\n background: string;\n /** Width of the minimap. */\n minimapWidth: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n panZoomCanvas: PanZoomCanvasTokens;\n }\n}\n\n/** Where the canvas is: a point at canvas (x, y) shows at screen (x times scale plus view.x, y times scale plus view.y). */\nexport interface CanvasView {\n x: number;\n y: number;\n /** 1 = 100%; kept between 25% and 800%. */\n scale: number;\n}\n\nexport interface CanvasRect {\n x: number;\n y: number;\n width: number;\n height: number;\n}\n\nexport interface PanZoomCanvasHandle {\n /** Fits `bounds` (or a given rect) in view. */\n fit: (rect?: CanvasRect) => void;\n /** Zooms to a percent around the viewport's centre. */\n zoomTo: (percent: number) => void;\n /** Centres a rect (a node) without changing the zoom. */\n centreOn: (rect: CanvasRect) => void;\n}\n\n/** What `renderScreen` draws from: the current view and the canvas's size in CSS pixels. */\nexport interface CanvasScreen {\n view: CanvasView;\n width: number;\n height: number;\n}\n\nexport interface PanZoomCanvasLabels {\n /** Announced when the zoom changes. Default \"Zoom 125%\". */\n zoom: (percent: number) => string;\n}\n\nexport interface PanZoomCanvasProps {\n /** Names the canvas (\"Schema diagram\"). */\n label: string;\n view?: CanvasView | undefined;\n /** Where it starts. Default: `bounds` fitted in view (or the origin at 100% without bounds). */\n defaultView?: CanvasView;\n onViewChange?: ((view: CanvasView) => void) | undefined;\n /** The content's extent in canvas units, for fitting and the minimap. */\n bounds?: CanvasRect | undefined;\n /** Show a minimap of `bounds` with the view on it (drag it, or press where to look). */\n minimap?: boolean;\n /** A small drawing of the content for the minimap, in canvas units (it is scaled down). */\n renderMinimap?: () => ReactNode;\n /**\n * A layer in screen pixels under the content, redrawn with every view change: for an engine that paints the whole\n * scene into a `<canvas>` (a canvas point (x, y) is at (x * scale + view.x, y * scale + view.y)). It does not take\n * the pointer, so pressing it pans like the background.\n */\n renderScreen?: (screen: CanvasScreen) => ReactNode;\n /** The content, placed in canvas units (absolutely positioned children). */\n children?: ReactNode;\n labels?: Partial<PanZoomCanvasLabels>;\n className?: string;\n /** Layout only (give it a height). Restyle through --cy-pan-zoom-canvas-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: PanZoomCanvasLabels = { zoom: (percent) => `Zoom ${percent}%` };\nconst MIN = MIN_PERCENT / 100;\nconst MAX = MAX_PERCENT / 100;\n/** Pixels an arrow key pans (Shift: five times as far). */\nconst STEP = 40;\n\n/**\n * A surface to pan and zoom freely in both directions, for diagrams, maps and boards: products place their content in\n * canvas units and keep their own layout and drawing. Drag the empty background (or hold Space and drag) to pan, the\n * wheel pans, Ctrl/Cmd+wheel and a pinch zoom around the pointer, one finger pans on touch; arrow keys pan, Ctrl/Cmd\n * and = - 0 zoom, Shift+1 fits. On the same zoom core as DocumentViewport.\n */\nexport const PanZoomCanvas = forwardRef<PanZoomCanvasHandle, PanZoomCanvasProps>(function PanZoomCanvas(\n {\n label,\n view,\n defaultView,\n onViewChange,\n bounds,\n minimap = false,\n renderMinimap,\n renderScreen,\n children,\n labels,\n className,\n style,\n },\n ref,\n) {\n const text = { ...DEFAULT_LABELS, ...labels };\n const surface = useRef<HTMLElement>(null);\n const [current, setView] = useControllableState(\n view,\n defaultView ?? { x: 0, y: 0, scale: 1 },\n onViewChange,\n );\n const latest = useRef(current);\n latest.current = current;\n const [size, setSize] = useState({ width: 0, height: 0 });\n useClientLayoutEffect(() => {\n const el = surface.current as HTMLElement;\n const measure = () =>\n setSize((s) =>\n s.width === el.clientWidth && s.height === el.clientHeight\n ? s\n : { width: el.clientWidth, height: el.clientHeight },\n );\n measure();\n const observer = new ResizeObserver(measure);\n observer.observe(el);\n return () => observer.disconnect();\n }, []);\n\n const go = (next: CanvasView) => {\n latest.current = next;\n setView(next);\n };\n const zoomAround = (scale: number, at: { x: number; y: number }) => {\n const v = latest.current;\n const s = clamp(scale, MIN, MAX);\n go({ x: at.x - ((at.x - v.x) * s) / v.scale, y: at.y - ((at.y - v.y) * s) / v.scale, scale: s });\n };\n const centre = () => ({ x: size.width / 2, y: size.height / 2 });\n const fit = (rect = bounds) => {\n if (!rect || !size.width || !size.height) return;\n const pad = Math.min(size.width, size.height) * 0.05;\n const s = clamp(\n Math.min((size.width - 2 * pad) / rect.width, (size.height - 2 * pad) / rect.height),\n MIN,\n MAX,\n );\n go({\n x: (size.width - rect.width * s) / 2 - rect.x * s,\n y: (size.height - rect.height * s) / 2 - rect.y * s,\n scale: s,\n });\n };\n const centreOn = (rect: CanvasRect) => {\n const { scale } = latest.current;\n go({\n x: size.width / 2 - (rect.x + rect.width / 2) * scale,\n y: size.height / 2 - (rect.y + rect.height / 2) * scale,\n scale,\n });\n };\n useImperativeHandle(ref, () => ({\n fit,\n zoomTo: (p) => zoomAround(clampPercent(p) / 100, centre()),\n centreOn,\n }));\n\n // Without a starting view, fit the content once the canvas has a size.\n const fitted = useRef(view !== undefined || defaultView !== undefined);\n useClientLayoutEffect(() => {\n if (fitted.current || !size.width) return;\n fitted.current = true;\n fit();\n });\n\n const percent = Math.round(current.scale * 100);\n const gestures = useZoomGestures(surface, {\n percent,\n onZoom: (p, at: ZoomAnchor) => zoomAround(p / 100, at ?? centre()),\n onPan: (dx, dy) => go({ ...latest.current, x: latest.current.x + dx, y: latest.current.y + dy }),\n });\n const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {\n gestures.onKeyDown(event);\n if (event.defaultPrevented || event.target !== event.currentTarget) return;\n if (event.key === \"!\" || (event.shiftKey && event.key === \"1\")) {\n event.preventDefault();\n fit();\n return;\n }\n const by = event.shiftKey ? STEP * 5 : STEP;\n const moves: Record<string, [number, number]> = {\n ArrowLeft: [by, 0],\n ArrowRight: [-by, 0],\n ArrowUp: [0, by],\n ArrowDown: [0, -by],\n };\n const move = moves[event.key];\n if (!move) return;\n event.preventDefault();\n go({ ...current, x: current.x + move[0], y: current.y + move[1] });\n };\n\n // Zoom changes are announced; the first value is not.\n const [said, setSaid] = useState({ percent, text: \"\" });\n if (said.percent !== percent) setSaid({ percent, text: text.zoom(percent) });\n\n // The minimap: `bounds` scaled to its width, with the view drawn on it. Dragging it (or pressing) moves the view.\n const map = useRef<HTMLDivElement>(null);\n // Measured into state (not a ref), so the view box is redrawn once the minimap's real width is known.\n const [mapWidth, setMapWidth] = useState(160);\n useClientLayoutEffect(() => {\n const w = map.current?.clientWidth;\n if (w && w !== mapWidth) setMapWidth(w);\n });\n const k = bounds ? mapWidth / bounds.width : 1;\n const seen = {\n x: (-current.x / current.scale - (bounds?.x ?? 0)) * k,\n y: (-current.y / current.scale - (bounds?.y ?? 0)) * k,\n width: (size.width / current.scale) * k,\n height: (size.height / current.scale) * k,\n };\n /** Centres the view on a point of the minimap (its own pixels). */\n const lookAt = (mx: number, my: number) => {\n if (!bounds) return;\n const { scale } = latest.current;\n go({\n x: size.width / 2 - (bounds.x + mx / k) * scale,\n y: size.height / 2 - (bounds.y + my / k) * scale,\n scale,\n });\n };\n useDrag(map, {\n onStart: ({ point }) => {\n const r = (map.current as HTMLDivElement).getBoundingClientRect();\n lookAt(point.x - r.left, point.y - r.top);\n },\n onMove: ({ point }) => {\n const r = (map.current as HTMLDivElement).getBoundingClientRect();\n lookAt(point.x - r.left, point.y - r.top);\n },\n });\n\n return (\n <>\n <section\n ref={surface}\n aria-label={label}\n // biome-ignore lint/a11y/noNoninteractiveTabindex: arrows pan and Ctrl/Cmd keys zoom the canvas\n tabIndex={0}\n className={className ? `cy-pan-zoom-canvas ${className}` : \"cy-pan-zoom-canvas\"}\n data-panning={gestures.panning ? \"\" : undefined}\n style={style}\n onKeyDown={onKeyDown}\n onKeyUp={gestures.onKeyUp}\n onBlur={gestures.onBlur}\n >\n {renderScreen && size.width > 0 && (\n <div className=\"cy-pan-zoom-canvas-screen cy-reset\">\n {renderScreen({ view: current, width: size.width, height: size.height })}\n </div>\n )}\n <div\n className=\"cy-pan-zoom-canvas-content cy-reset\"\n style={{ transform: `translate(${current.x}px, ${current.y}px) scale(${current.scale})` }}\n >\n {children}\n </div>\n {minimap && bounds && (\n <div\n ref={map}\n className=\"cy-pan-zoom-canvas-minimap cy-reset\"\n style={{ blockSize: bounds.height * k }}\n aria-hidden=\"true\"\n >\n {renderMinimap && (\n <div\n className=\"cy-pan-zoom-canvas-minimap-content cy-reset\"\n style={{ transform: `scale(${k}) translate(${-bounds.x}px, ${-bounds.y}px)` }}\n >\n {renderMinimap()}\n </div>\n )}\n <div\n className=\"cy-pan-zoom-canvas-minimap-view cy-reset\"\n style={{\n insetInlineStart: seen.x,\n insetBlockStart: seen.y,\n inlineSize: seen.width,\n blockSize: seen.height,\n }}\n />\n </div>\n )}\n </section>\n <span className=\"cy-visually-hidden\" role=\"status\">\n {said.text}\n </span>\n </>\n );\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"PanZoomCanvas.js","names":["_Fragment","useControllableState","useClientLayoutEffect","clamp","useDrag","clampPercent","useZoomGestures","forwardRef","useImperativeHandle","useRef","useState","Fragment$1","jsx","jsxs","DEFAULT_LABELS","percent","MIN","MAX","STEP","PanZoomCanvas","label","view","defaultView","onViewChange","bounds","minimap","renderMinimap","renderScreen","children","labels","className","style","ref","text","surface","current","setView","latest","size","setSize","el","measure","s","observer","go","next","zoomAround","scale","at","v","centre","fit","rect","pad","centreOn","p","fitted","gestures","dx","dy","onKeyDown","event","by","move","said","setSaid","map","mapWidth","setMapWidth","w","k","seen","lookAt","mx","my","point","r"],"sources":["../../../src/components/PanZoomCanvas/PanZoomCanvas.tsx"],"sourcesContent":["import {\n type CSSProperties,\n forwardRef,\n type KeyboardEvent,\n type ReactNode,\n useImperativeHandle,\n useRef,\n useState,\n} from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { useDrag } from \"../../foundations/drag.js\";\nimport { clamp } from \"../../foundations/math.js\";\nimport { clampPercent, MAX_PERCENT, MIN_PERCENT } from \"../../foundations/zoom.js\";\nimport { useZoomGestures, type ZoomAnchor } from \"../../foundations/zoom-gestures.js\";\n\nexport interface PanZoomCanvasTokens {\n /** Behind the content. */\n background: string;\n /** Width of the minimap. */\n minimapWidth: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n panZoomCanvas: PanZoomCanvasTokens;\n }\n}\n\n/** Where the canvas is: a point at canvas (x, y) shows at screen (x times scale plus view.x, y times scale plus view.y). */\nexport interface CanvasView {\n x: number;\n y: number;\n /** 1 = 100%; kept between 25% and 800%. */\n scale: number;\n}\n\nexport interface CanvasRect {\n x: number;\n y: number;\n width: number;\n height: number;\n}\n\nexport interface PanZoomCanvasHandle {\n /** Fits `bounds` (or a given rect) in view. */\n fit: (rect?: CanvasRect) => void;\n /** Zooms to a percent around the viewport's centre. */\n zoomTo: (percent: number) => void;\n /** Centres a rect (a node) without changing the zoom. */\n centreOn: (rect: CanvasRect) => void;\n}\n\n/** What `renderScreen` draws from: the current view and the canvas's size in CSS pixels. */\nexport interface CanvasScreen {\n view: CanvasView;\n width: number;\n height: number;\n}\n\nexport interface PanZoomCanvasLabels {\n /** Announced when the zoom changes. Default \"Zoom 125%\". */\n zoom: (percent: number) => string;\n}\n\nexport interface PanZoomCanvasProps {\n /** Names the canvas (\"Schema diagram\"). */\n label: string;\n /** Controlled view: the pan offset and the zoom. */\n view?: CanvasView | undefined;\n /** Where it starts. Default: `bounds` fitted in view (or the origin at 100% without bounds). */\n defaultView?: CanvasView;\n /** Called with the new view on every pan and zoom. */\n onViewChange?: ((view: CanvasView) => void) | undefined;\n /** The content's extent in canvas units, for fitting and the minimap. */\n bounds?: CanvasRect | undefined;\n /** Show a minimap of `bounds` with the view on it (drag it, or press where to look). */\n minimap?: boolean;\n /** A small drawing of the content for the minimap, in canvas units (it is scaled down). */\n renderMinimap?: () => ReactNode;\n /**\n * A layer in screen pixels under the content, redrawn with every view change: for an engine that paints the whole\n * scene into a `<canvas>` (a canvas point (x, y) is at (x * scale + view.x, y * scale + view.y)). It does not take\n * the pointer, so pressing it pans like the background.\n */\n renderScreen?: (screen: CanvasScreen) => ReactNode;\n /** The content, placed in canvas units (absolutely positioned children). */\n children?: ReactNode;\n /** Replace the built-in English text: the zoom announcement. */\n labels?: Partial<PanZoomCanvasLabels>;\n /** Added to the root element, for layout. */\n className?: string;\n /** Layout only (give it a height). Restyle through --cy-pan-zoom-canvas-* tokens. */\n style?: CSSProperties;\n}\n\nconst DEFAULT_LABELS: PanZoomCanvasLabels = { zoom: (percent) => `Zoom ${percent}%` };\nconst MIN = MIN_PERCENT / 100;\nconst MAX = MAX_PERCENT / 100;\n/** Pixels an arrow key pans (Shift: five times as far). */\nconst STEP = 40;\n\n/**\n * A surface to pan and zoom freely in both directions, for diagrams, maps and boards: products place their content in\n * canvas units and keep their own layout and drawing. Drag the empty background (or hold Space and drag) to pan, the\n * wheel pans, Ctrl/Cmd+wheel and a pinch zoom around the pointer, one finger pans on touch; arrow keys pan, Ctrl/Cmd\n * and = - 0 zoom, Shift+1 fits. On the same zoom core as DocumentViewport.\n */\nexport const PanZoomCanvas = forwardRef<PanZoomCanvasHandle, PanZoomCanvasProps>(function PanZoomCanvas(\n {\n label,\n view,\n defaultView,\n onViewChange,\n bounds,\n minimap = false,\n renderMinimap,\n renderScreen,\n children,\n labels,\n className,\n style,\n },\n ref,\n) {\n const text = { ...DEFAULT_LABELS, ...labels };\n const surface = useRef<HTMLElement>(null);\n const [current, setView] = useControllableState(\n view,\n defaultView ?? { x: 0, y: 0, scale: 1 },\n onViewChange,\n );\n const latest = useRef(current);\n latest.current = current;\n const [size, setSize] = useState({ width: 0, height: 0 });\n useClientLayoutEffect(() => {\n const el = surface.current as HTMLElement;\n const measure = () =>\n setSize((s) =>\n s.width === el.clientWidth && s.height === el.clientHeight\n ? s\n : { width: el.clientWidth, height: el.clientHeight },\n );\n measure();\n const observer = new ResizeObserver(measure);\n observer.observe(el);\n return () => observer.disconnect();\n }, []);\n\n const go = (next: CanvasView) => {\n latest.current = next;\n setView(next);\n };\n const zoomAround = (scale: number, at: { x: number; y: number }) => {\n const v = latest.current;\n const s = clamp(scale, MIN, MAX);\n go({ x: at.x - ((at.x - v.x) * s) / v.scale, y: at.y - ((at.y - v.y) * s) / v.scale, scale: s });\n };\n const centre = () => ({ x: size.width / 2, y: size.height / 2 });\n const fit = (rect = bounds) => {\n if (!rect || !size.width || !size.height) return;\n const pad = Math.min(size.width, size.height) * 0.05;\n const s = clamp(\n Math.min((size.width - 2 * pad) / rect.width, (size.height - 2 * pad) / rect.height),\n MIN,\n MAX,\n );\n go({\n x: (size.width - rect.width * s) / 2 - rect.x * s,\n y: (size.height - rect.height * s) / 2 - rect.y * s,\n scale: s,\n });\n };\n const centreOn = (rect: CanvasRect) => {\n const { scale } = latest.current;\n go({\n x: size.width / 2 - (rect.x + rect.width / 2) * scale,\n y: size.height / 2 - (rect.y + rect.height / 2) * scale,\n scale,\n });\n };\n useImperativeHandle(ref, () => ({\n fit,\n zoomTo: (p) => zoomAround(clampPercent(p) / 100, centre()),\n centreOn,\n }));\n\n // Without a starting view, fit the content once the canvas has a size.\n const fitted = useRef(view !== undefined || defaultView !== undefined);\n useClientLayoutEffect(() => {\n if (fitted.current || !size.width) return;\n fitted.current = true;\n fit();\n });\n\n const percent = Math.round(current.scale * 100);\n const gestures = useZoomGestures(surface, {\n percent,\n onZoom: (p, at: ZoomAnchor) => zoomAround(p / 100, at ?? centre()),\n onPan: (dx, dy) => go({ ...latest.current, x: latest.current.x + dx, y: latest.current.y + dy }),\n });\n const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {\n gestures.onKeyDown(event);\n if (event.defaultPrevented || event.target !== event.currentTarget) return;\n if (event.key === \"!\" || (event.shiftKey && event.key === \"1\")) {\n event.preventDefault();\n fit();\n return;\n }\n const by = event.shiftKey ? STEP * 5 : STEP;\n const moves: Record<string, [number, number]> = {\n ArrowLeft: [by, 0],\n ArrowRight: [-by, 0],\n ArrowUp: [0, by],\n ArrowDown: [0, -by],\n };\n const move = moves[event.key];\n if (!move) return;\n event.preventDefault();\n go({ ...current, x: current.x + move[0], y: current.y + move[1] });\n };\n\n // Zoom changes are announced; the first value is not.\n const [said, setSaid] = useState({ percent, text: \"\" });\n if (said.percent !== percent) setSaid({ percent, text: text.zoom(percent) });\n\n // The minimap: `bounds` scaled to its width, with the view drawn on it. Dragging it (or pressing) moves the view.\n const map = useRef<HTMLDivElement>(null);\n // Measured into state (not a ref), so the view box is redrawn once the minimap's real width is known.\n const [mapWidth, setMapWidth] = useState(160);\n useClientLayoutEffect(() => {\n const w = map.current?.clientWidth;\n if (w && w !== mapWidth) setMapWidth(w);\n });\n const k = bounds ? mapWidth / bounds.width : 1;\n const seen = {\n x: (-current.x / current.scale - (bounds?.x ?? 0)) * k,\n y: (-current.y / current.scale - (bounds?.y ?? 0)) * k,\n width: (size.width / current.scale) * k,\n height: (size.height / current.scale) * k,\n };\n /** Centres the view on a point of the minimap (its own pixels). */\n const lookAt = (mx: number, my: number) => {\n if (!bounds) return;\n const { scale } = latest.current;\n go({\n x: size.width / 2 - (bounds.x + mx / k) * scale,\n y: size.height / 2 - (bounds.y + my / k) * scale,\n scale,\n });\n };\n useDrag(map, {\n onStart: ({ point }) => {\n const r = (map.current as HTMLDivElement).getBoundingClientRect();\n lookAt(point.x - r.left, point.y - r.top);\n },\n onMove: ({ point }) => {\n const r = (map.current as HTMLDivElement).getBoundingClientRect();\n lookAt(point.x - r.left, point.y - r.top);\n },\n });\n\n return (\n <>\n <section\n ref={surface}\n aria-label={label}\n // biome-ignore lint/a11y/noNoninteractiveTabindex: arrows pan and Ctrl/Cmd keys zoom the canvas\n tabIndex={0}\n className={className ? `cy-pan-zoom-canvas ${className}` : \"cy-pan-zoom-canvas\"}\n data-panning={gestures.panning ? \"\" : undefined}\n style={style}\n onKeyDown={onKeyDown}\n onKeyUp={gestures.onKeyUp}\n onBlur={gestures.onBlur}\n >\n {renderScreen && size.width > 0 && (\n <div className=\"cy-pan-zoom-canvas-screen cy-reset\">\n {renderScreen({ view: current, width: size.width, height: size.height })}\n </div>\n )}\n <div\n className=\"cy-pan-zoom-canvas-content cy-reset\"\n style={{ transform: `translate(${current.x}px, ${current.y}px) scale(${current.scale})` }}\n >\n {children}\n </div>\n {minimap && bounds && (\n <div\n ref={map}\n className=\"cy-pan-zoom-canvas-minimap cy-reset\"\n style={{ blockSize: bounds.height * k }}\n aria-hidden=\"true\"\n >\n {renderMinimap && (\n <div\n className=\"cy-pan-zoom-canvas-minimap-content cy-reset\"\n style={{ transform: `scale(${k}) translate(${-bounds.x}px, ${-bounds.y}px)` }}\n >\n {renderMinimap()}\n </div>\n )}\n <div\n className=\"cy-pan-zoom-canvas-minimap-view cy-reset\"\n style={{\n insetInlineStart: seen.x,\n insetBlockStart: seen.y,\n inlineSize: seen.width,\n blockSize: seen.height,\n }}\n />\n </div>\n )}\n </section>\n <span className=\"cy-visually-hidden\" role=\"status\">\n {said.text}\n </span>\n </>\n );\n});\n"],"mappings":"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"}
@@ -16,10 +16,15 @@ declare module "../../tokens/schema.js" {
16
16
  }
17
17
  /** Spread onto the trigger (a Button or IconButton). */
18
18
  export interface PopoverTriggerProps {
19
+ /** Spread onto the trigger: the panel is placed against it and focus returns to it on close. */
19
20
  ref: Ref<HTMLButtonElement>;
21
+ /** Spread onto the trigger: opens the panel, or closes it when open. */
20
22
  onClick: () => void;
23
+ /** Spread onto the trigger: whether the panel is open. */
21
24
  "aria-expanded": boolean;
25
+ /** Spread onto the trigger: the id of the panel. */
22
26
  "aria-controls": string;
27
+ /** Spread onto the trigger: tells assistive technology it opens a dialog. */
23
28
  "aria-haspopup": "dialog";
24
29
  }
25
30
  export interface PopoverProps {
@@ -38,8 +43,11 @@ export interface PopoverProps {
38
43
  } | VirtualAnchor | undefined;
39
44
  /** Accessible name of the panel (a non-modal dialog). */
40
45
  label: string;
46
+ /** Controlled open state. */
41
47
  open?: boolean;
48
+ /** Open at first, when uncontrolled. */
42
49
  defaultOpen?: boolean;
50
+ /** Called with the new state when the trigger, Escape or an outside click opens or closes it. */
43
51
  onOpenChange?: (open: boolean) => void;
44
52
  /** Preferred side; flips when it does not fit. `start`/`end` follow the reading direction. */
45
53
  placement?: Placement;
@@ -47,9 +55,11 @@ export interface PopoverProps {
47
55
  size?: Size;
48
56
  /** Keep Tab inside the panel until it closes. */
49
57
  modal?: boolean;
58
+ /** Added to the panel, for layout. */
50
59
  className?: string;
51
60
  /** Layout only, applied to the panel. */
52
61
  style?: CSSProperties;
62
+ /** The panel's content. Focus moves to its first focusable element on open. */
53
63
  children?: ReactNode;
54
64
  }
55
65
  /** Floating panel in the top layer, anchored to its trigger. Escape, outside clicks and focus return are shared. */
@@ -1 +1 @@
1
- {"version":3,"file":"Popover.js","names":["_Fragment","useControllableState","useDismiss","usePopover","useAnchoredPosition","useId","useRef","Fragment$1","jsx","jsxs","FOCUSABLE","Popover","trigger","anchor","label","open","defaultOpen","onOpenChange","placement","size","modal","className","style","children","id","isOpen","setOpen","triggerRef","panel","placed","before","wasOpen","returnTo","el","trap","event","items","first","last","active"],"sources":["../../../src/components/Popover/Popover.tsx"],"sourcesContent":["import { type CSSProperties, type KeyboardEvent, type ReactNode, type Ref, useId, useRef } from \"react\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { useDismiss } from \"../../overlay/dismiss.js\";\nimport { usePopover } from \"../../overlay/floating.js\";\nimport type { Placement } from \"../../overlay/position.js\";\nimport { useAnchoredPosition, type VirtualAnchor } from \"../../overlay/use-anchored-position.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface PopoverTokens {\n padding: string;\n radius: string;\n widthSm: string;\n widthMd: string;\n widthLg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n popover: PopoverTokens;\n }\n}\n\n/** Spread onto the trigger (a Button or IconButton). */\nexport interface PopoverTriggerProps {\n ref: Ref<HTMLButtonElement>;\n onClick: () => void;\n \"aria-expanded\": boolean;\n \"aria-controls\": string;\n \"aria-haspopup\": \"dialog\";\n}\n\nexport interface PopoverProps {\n /**\n * Render the trigger: `(props) => <Button {...props}>Filters</Button>`. Optional with `anchor`: a popover opened\n * at a point (a canvas click) has no trigger, and is controlled with `open`.\n */\n trigger?: ((props: PopoverTriggerProps) => ReactNode) | undefined;\n /**\n * Place it at a point (`{ x, y }` in viewport pixels, such as where a canvas was clicked) or beside any element or\n * virtual anchor, instead of the trigger. Focus goes back to where it was when it closes.\n */\n anchor?: { x: number; y: number } | VirtualAnchor | undefined;\n /** Accessible name of the panel (a non-modal dialog). */\n label: string;\n open?: boolean;\n defaultOpen?: boolean;\n onOpenChange?: (open: boolean) => void;\n /** Preferred side; flips when it does not fit. `start`/`end` follow the reading direction. */\n placement?: Placement;\n /** Panel width preset. */\n size?: Size;\n /** Keep Tab inside the panel until it closes. */\n modal?: boolean;\n className?: string;\n /** Layout only, applied to the panel. */\n style?: CSSProperties;\n children?: ReactNode;\n}\n\nconst FOCUSABLE =\n 'button:not([disabled]), [href], input:not([disabled]):not([type=\"hidden\"]):not([aria-hidden=\"true\"]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])';\n\n/** Floating panel in the top layer, anchored to its trigger. Escape, outside clicks and focus return are shared. */\nexport function Popover({\n trigger,\n anchor,\n label,\n open,\n defaultOpen = false,\n onOpenChange,\n placement = \"bottom\",\n size = \"md\",\n modal = false,\n className,\n style,\n children,\n}: PopoverProps) {\n const id = useId();\n const [isOpen, setOpen] = useControllableState(open, defaultOpen, onOpenChange);\n const triggerRef = useRef<HTMLButtonElement>(null);\n const panel = useRef<HTMLDivElement>(null);\n // An `anchor` replaces the trigger as what the panel is placed against.\n const placed = useRef<HTMLElement | VirtualAnchor | null>(null);\n placed.current = !anchor\n ? triggerRef.current\n : \"getBoundingClientRect\" in anchor\n ? anchor\n : { getBoundingClientRect: () => new DOMRect(anchor.x, anchor.y, 0, 0) };\n // Without a trigger, focus returns to whatever had it when the panel opened.\n const before = useRef<HTMLElement | null>(null);\n const wasOpen = useRef(false);\n if (isOpen && !wasOpen.current && typeof document !== \"undefined\")\n before.current = document.activeElement as HTMLElement | null;\n wasOpen.current = isOpen;\n const returnTo = useRef<HTMLElement | null>(null);\n returnTo.current = trigger ? triggerRef.current : before.current;\n\n // Show before positioning (the panel must be laid out to be measured), then move focus inside.\n usePopover(panel, isOpen, (el) => {\n const first = el.querySelector<HTMLElement>(FOCUSABLE);\n (first ?? el).focus({ preventScroll: true });\n });\n useAnchoredPosition(anchor ? placed : triggerRef, panel, isOpen, placement, 6, \"start\");\n useDismiss({\n open: isOpen,\n onClose: () => setOpen(false),\n inside: [triggerRef, panel],\n returnFocus: returnTo,\n });\n\n const trap = (event: KeyboardEvent<HTMLDivElement>) => {\n if (!modal || event.key !== \"Tab\") return;\n const items = [...event.currentTarget.querySelectorAll<HTMLElement>(FOCUSABLE)];\n if (!items.length) return;\n const first = items[0] as HTMLElement;\n const last = items[items.length - 1] as HTMLElement;\n const active = event.currentTarget.ownerDocument.activeElement;\n if (event.shiftKey && (active === first || active === event.currentTarget)) {\n event.preventDefault();\n last.focus();\n } else if (!event.shiftKey && active === last) {\n event.preventDefault();\n first.focus();\n }\n };\n\n return (\n <>\n {trigger?.({\n ref: triggerRef,\n onClick: () => setOpen(!isOpen),\n \"aria-expanded\": isOpen,\n \"aria-controls\": `${id}-panel`,\n \"aria-haspopup\": \"dialog\",\n })}\n <div\n ref={panel}\n id={`${id}-panel`}\n role=\"dialog\"\n aria-label={label}\n aria-modal={modal || undefined}\n tabIndex={-1}\n {...{ popover: \"manual\" }}\n className={className ? `cy-popover ${className}` : \"cy-popover\"}\n data-size={size}\n style={style}\n onKeyDown={trap}\n >\n {children}\n </div>\n </>\n );\n}\n"],"mappings":";;;;;;;AA2DA,IAAMU,IACJ;AAGF,SAAgBC,EAAQ,EACtB,SAAAC,GACA,QAAAC,GACA,OAAAC,GACA,MAAAC,GACA,aAAAC,IAAc,IACd,cAAAC,GACA,WAAAC,IAAY,UACZ,MAAAC,IAAO,MACP,OAAAC,IAAQ,IACR,WAAAC,GACA,OAAAC,GACA,UAAAC,EAAA,GACe;AACf,QAAMC,IAAKnB,EAAM,GACX,CAACoB,GAAQC,CAAA,IAAWzB,EAAqBc,GAAMC,GAAaC,CAAY,GACxEU,IAAarB,EAA0B,IAAI,GAC3CsB,IAAQtB,EAAuB,IAAI,GAEnCuB,IAASvB,EAA2C,IAAI;AAC9D,EAAAuB,EAAO,UAAWhB,IAEd,2BAA2BA,IACzBA,IACA,EAAE,uBAAA,MAA6B,IAAI,QAAQA,EAAO,GAAGA,EAAO,GAAG,GAAG,CAAC,EAAE,IAHvEc,EAAW;AAKf,QAAMG,IAASxB,EAA2B,IAAI,GACxCyB,IAAUzB,EAAO,EAAK;AAC5B,EAAImB,KAAU,CAACM,EAAQ,WAAW,OAAO,WAAa,QACpDD,EAAO,UAAU,SAAS,gBAC5BC,EAAQ,UAAUN;AAClB,QAAMO,IAAW1B,EAA2B,IAAI;AAChD,EAAA0B,EAAS,UAAUpB,IAAUe,EAAW,UAAUG,EAAO,SAGzD3B,EAAWyB,GAAOH,GAAA,CAASQ,MAAO;AAEhC,KADcA,EAAG,cAA2BvB,CAC3C,KAASuB,GAAI,MAAM,EAAE,eAAe,GAAK,CAAC;AAAA,EAC7C,CAAC,GACD7B,EAAoBS,IAASgB,IAASF,GAAYC,GAAOH,GAAQP,GAAW,GAAG,OAAO,GACtFhB,EAAW;AAAA,IACT,MAAMuB;AAAA,IACN,SAAA,MAAeC,EAAQ,EAAK;AAAA,IAC5B,QAAQ,CAACC,GAAYC,CAAK;AAAA,IAC1B,aAAaI;AAAA,EACf,CAAC;AAED,QAAME,IAAA,CAAQC,MAAyC;AACrD,QAAI,CAACf,KAASe,EAAM,QAAQ,MAAO;AACnC,UAAMC,IAAQ,CAAC,GAAGD,EAAM,cAAc,iBAA8BzB,CAAS,CAAC;AAC9E,QAAI,CAAC0B,EAAM,OAAQ;AACnB,UAAMC,IAAQD,EAAM,CAAA,GACdE,IAAOF,EAAMA,EAAM,SAAS,CAAA,GAC5BG,IAASJ,EAAM,cAAc,cAAc;AACjD,IAAIA,EAAM,aAAaI,MAAWF,KAASE,MAAWJ,EAAM,kBAC1DA,EAAM,eAAe,GACrBG,EAAK,MAAM,KACF,CAACH,EAAM,YAAYI,MAAWD,MACvCH,EAAM,eAAe,GACrBE,EAAM,MAAM;AAAA,EAEhB;AAEA,SACE,gBAAA5B,EAAAT,GAAA,EAAA,UAAA,CACGY,IAAU;AAAA,IACT,KAAKe;AAAA,IACL,SAAA,MAAeD,EAAQ,CAACD,CAAM;AAAA,IAC9B,iBAAiBA;AAAA,IACjB,iBAAiB,GAAGD,CAAA;AAAA,IACpB,iBAAiB;AAAA,EACnB,CAAC,GACD,gBAAAhB,EAAC,OAAD;AAAA,IACE,KAAKoB;AAAA,IACL,IAAI,GAAGJ,CAAA;AAAA,IACP,MAAK;AAAA,IACL,cAAYV;AAAA,IACZ,cAAYM,KAAS;AAAA,IACrB,UAAU;AAAA,IACJ,SAAS;AAAA,IACf,WAAWC,IAAY,cAAcA,CAAA,KAAc;AAAA,IACnD,aAAWF;AAAA,IACJ,OAAAG;AAAA,IACP,WAAWY;AAAA,IAEV,UAAAX;AAAA,EACE,CAAA,CACL,EAAA,CAAA;AAEN"}
1
+ {"version":3,"file":"Popover.js","names":["_Fragment","useControllableState","useDismiss","usePopover","useAnchoredPosition","useId","useRef","Fragment$1","jsx","jsxs","FOCUSABLE","Popover","trigger","anchor","label","open","defaultOpen","onOpenChange","placement","size","modal","className","style","children","id","isOpen","setOpen","triggerRef","panel","placed","before","wasOpen","returnTo","el","trap","event","items","first","last","active"],"sources":["../../../src/components/Popover/Popover.tsx"],"sourcesContent":["import { type CSSProperties, type KeyboardEvent, type ReactNode, type Ref, useId, useRef } from \"react\";\nimport { useControllableState } from \"../../foundations/controllable.js\";\nimport { useDismiss } from \"../../overlay/dismiss.js\";\nimport { usePopover } from \"../../overlay/floating.js\";\nimport type { Placement } from \"../../overlay/position.js\";\nimport { useAnchoredPosition, type VirtualAnchor } from \"../../overlay/use-anchored-position.js\";\nimport type { Size } from \"../../tokens/schema.js\";\n\nexport interface PopoverTokens {\n padding: string;\n radius: string;\n widthSm: string;\n widthMd: string;\n widthLg: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n popover: PopoverTokens;\n }\n}\n\n/** Spread onto the trigger (a Button or IconButton). */\nexport interface PopoverTriggerProps {\n /** Spread onto the trigger: the panel is placed against it and focus returns to it on close. */\n ref: Ref<HTMLButtonElement>;\n /** Spread onto the trigger: opens the panel, or closes it when open. */\n onClick: () => void;\n /** Spread onto the trigger: whether the panel is open. */\n \"aria-expanded\": boolean;\n /** Spread onto the trigger: the id of the panel. */\n \"aria-controls\": string;\n /** Spread onto the trigger: tells assistive technology it opens a dialog. */\n \"aria-haspopup\": \"dialog\";\n}\n\nexport interface PopoverProps {\n /**\n * Render the trigger: `(props) => <Button {...props}>Filters</Button>`. Optional with `anchor`: a popover opened\n * at a point (a canvas click) has no trigger, and is controlled with `open`.\n */\n trigger?: ((props: PopoverTriggerProps) => ReactNode) | undefined;\n /**\n * Place it at a point (`{ x, y }` in viewport pixels, such as where a canvas was clicked) or beside any element or\n * virtual anchor, instead of the trigger. Focus goes back to where it was when it closes.\n */\n anchor?: { x: number; y: number } | VirtualAnchor | undefined;\n /** Accessible name of the panel (a non-modal dialog). */\n label: string;\n /** Controlled open state. */\n open?: boolean;\n /** Open at first, when uncontrolled. */\n defaultOpen?: boolean;\n /** Called with the new state when the trigger, Escape or an outside click opens or closes it. */\n onOpenChange?: (open: boolean) => void;\n /** Preferred side; flips when it does not fit. `start`/`end` follow the reading direction. */\n placement?: Placement;\n /** Panel width preset. */\n size?: Size;\n /** Keep Tab inside the panel until it closes. */\n modal?: boolean;\n /** Added to the panel, for layout. */\n className?: string;\n /** Layout only, applied to the panel. */\n style?: CSSProperties;\n /** The panel's content. Focus moves to its first focusable element on open. */\n children?: ReactNode;\n}\n\nconst FOCUSABLE =\n 'button:not([disabled]), [href], input:not([disabled]):not([type=\"hidden\"]):not([aria-hidden=\"true\"]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])';\n\n/** Floating panel in the top layer, anchored to its trigger. Escape, outside clicks and focus return are shared. */\nexport function Popover({\n trigger,\n anchor,\n label,\n open,\n defaultOpen = false,\n onOpenChange,\n placement = \"bottom\",\n size = \"md\",\n modal = false,\n className,\n style,\n children,\n}: PopoverProps) {\n const id = useId();\n const [isOpen, setOpen] = useControllableState(open, defaultOpen, onOpenChange);\n const triggerRef = useRef<HTMLButtonElement>(null);\n const panel = useRef<HTMLDivElement>(null);\n // An `anchor` replaces the trigger as what the panel is placed against.\n const placed = useRef<HTMLElement | VirtualAnchor | null>(null);\n placed.current = !anchor\n ? triggerRef.current\n : \"getBoundingClientRect\" in anchor\n ? anchor\n : { getBoundingClientRect: () => new DOMRect(anchor.x, anchor.y, 0, 0) };\n // Without a trigger, focus returns to whatever had it when the panel opened.\n const before = useRef<HTMLElement | null>(null);\n const wasOpen = useRef(false);\n if (isOpen && !wasOpen.current && typeof document !== \"undefined\")\n before.current = document.activeElement as HTMLElement | null;\n wasOpen.current = isOpen;\n const returnTo = useRef<HTMLElement | null>(null);\n returnTo.current = trigger ? triggerRef.current : before.current;\n\n // Show before positioning (the panel must be laid out to be measured), then move focus inside.\n usePopover(panel, isOpen, (el) => {\n const first = el.querySelector<HTMLElement>(FOCUSABLE);\n (first ?? el).focus({ preventScroll: true });\n });\n useAnchoredPosition(anchor ? placed : triggerRef, panel, isOpen, placement, 6, \"start\");\n useDismiss({\n open: isOpen,\n onClose: () => setOpen(false),\n inside: [triggerRef, panel],\n returnFocus: returnTo,\n });\n\n const trap = (event: KeyboardEvent<HTMLDivElement>) => {\n if (!modal || event.key !== \"Tab\") return;\n const items = [...event.currentTarget.querySelectorAll<HTMLElement>(FOCUSABLE)];\n if (!items.length) return;\n const first = items[0] as HTMLElement;\n const last = items[items.length - 1] as HTMLElement;\n const active = event.currentTarget.ownerDocument.activeElement;\n if (event.shiftKey && (active === first || active === event.currentTarget)) {\n event.preventDefault();\n last.focus();\n } else if (!event.shiftKey && active === last) {\n event.preventDefault();\n first.focus();\n }\n };\n\n return (\n <>\n {trigger?.({\n ref: triggerRef,\n onClick: () => setOpen(!isOpen),\n \"aria-expanded\": isOpen,\n \"aria-controls\": `${id}-panel`,\n \"aria-haspopup\": \"dialog\",\n })}\n <div\n ref={panel}\n id={`${id}-panel`}\n role=\"dialog\"\n aria-label={label}\n aria-modal={modal || undefined}\n tabIndex={-1}\n {...{ popover: \"manual\" }}\n className={className ? `cy-popover ${className}` : \"cy-popover\"}\n data-size={size}\n style={style}\n onKeyDown={trap}\n >\n {children}\n </div>\n </>\n );\n}\n"],"mappings":";;;;;;;AAqEA,IAAMU,IACJ;AAGF,SAAgBC,EAAQ,EACtB,SAAAC,GACA,QAAAC,GACA,OAAAC,GACA,MAAAC,GACA,aAAAC,IAAc,IACd,cAAAC,GACA,WAAAC,IAAY,UACZ,MAAAC,IAAO,MACP,OAAAC,IAAQ,IACR,WAAAC,GACA,OAAAC,GACA,UAAAC,EAAA,GACe;AACf,QAAMC,IAAKnB,EAAM,GACX,CAACoB,GAAQC,CAAA,IAAWzB,EAAqBc,GAAMC,GAAaC,CAAY,GACxEU,IAAarB,EAA0B,IAAI,GAC3CsB,IAAQtB,EAAuB,IAAI,GAEnCuB,IAASvB,EAA2C,IAAI;AAC9D,EAAAuB,EAAO,UAAWhB,IAEd,2BAA2BA,IACzBA,IACA,EAAE,uBAAA,MAA6B,IAAI,QAAQA,EAAO,GAAGA,EAAO,GAAG,GAAG,CAAC,EAAE,IAHvEc,EAAW;AAKf,QAAMG,IAASxB,EAA2B,IAAI,GACxCyB,IAAUzB,EAAO,EAAK;AAC5B,EAAImB,KAAU,CAACM,EAAQ,WAAW,OAAO,WAAa,QACpDD,EAAO,UAAU,SAAS,gBAC5BC,EAAQ,UAAUN;AAClB,QAAMO,IAAW1B,EAA2B,IAAI;AAChD,EAAA0B,EAAS,UAAUpB,IAAUe,EAAW,UAAUG,EAAO,SAGzD3B,EAAWyB,GAAOH,GAAA,CAASQ,MAAO;AAEhC,KADcA,EAAG,cAA2BvB,CAC3C,KAASuB,GAAI,MAAM,EAAE,eAAe,GAAK,CAAC;AAAA,EAC7C,CAAC,GACD7B,EAAoBS,IAASgB,IAASF,GAAYC,GAAOH,GAAQP,GAAW,GAAG,OAAO,GACtFhB,EAAW;AAAA,IACT,MAAMuB;AAAA,IACN,SAAA,MAAeC,EAAQ,EAAK;AAAA,IAC5B,QAAQ,CAACC,GAAYC,CAAK;AAAA,IAC1B,aAAaI;AAAA,EACf,CAAC;AAED,QAAME,IAAA,CAAQC,MAAyC;AACrD,QAAI,CAACf,KAASe,EAAM,QAAQ,MAAO;AACnC,UAAMC,IAAQ,CAAC,GAAGD,EAAM,cAAc,iBAA8BzB,CAAS,CAAC;AAC9E,QAAI,CAAC0B,EAAM,OAAQ;AACnB,UAAMC,IAAQD,EAAM,CAAA,GACdE,IAAOF,EAAMA,EAAM,SAAS,CAAA,GAC5BG,IAASJ,EAAM,cAAc,cAAc;AACjD,IAAIA,EAAM,aAAaI,MAAWF,KAASE,MAAWJ,EAAM,kBAC1DA,EAAM,eAAe,GACrBG,EAAK,MAAM,KACF,CAACH,EAAM,YAAYI,MAAWD,MACvCH,EAAM,eAAe,GACrBE,EAAM,MAAM;AAAA,EAEhB;AAEA,SACE,gBAAA5B,EAAAT,GAAA,EAAA,UAAA,CACGY,IAAU;AAAA,IACT,KAAKe;AAAA,IACL,SAAA,MAAeD,EAAQ,CAACD,CAAM;AAAA,IAC9B,iBAAiBA;AAAA,IACjB,iBAAiB,GAAGD,CAAA;AAAA,IACpB,iBAAiB;AAAA,EACnB,CAAC,GACD,gBAAAhB,EAAC,OAAD;AAAA,IACE,KAAKoB;AAAA,IACL,IAAI,GAAGJ,CAAA;AAAA,IACP,MAAK;AAAA,IACL,cAAYV;AAAA,IACZ,cAAYM,KAAS;AAAA,IACrB,UAAU;AAAA,IACJ,SAAS;AAAA,IACf,WAAWC,IAAY,cAAcA,CAAA,KAAc;AAAA,IACnD,aAAWF;AAAA,IACJ,OAAAG;AAAA,IACP,WAAWY;AAAA,IAEV,UAAAX;AAAA,EACE,CAAA,CACL,EAAA,CAAA;AAEN"}
@@ -27,9 +27,11 @@ export interface ProgressSegment {
27
27
  export interface ProgressBarProps {
28
28
  /** Accessible name, shown above the bar unless `labelHidden`. */
29
29
  label: string;
30
+ /** Visually hide the label (it still names the bar). */
30
31
  labelHidden?: boolean;
31
32
  /** Current value between 0 and `max`. Leave it out (or pass `indeterminate`) when progress is unknown. */
32
33
  value?: number | undefined;
34
+ /** The value that means complete. Default 100. */
33
35
  max?: number;
34
36
  /** Progress is happening but its amount is unknown. */
35
37
  indeterminate?: boolean;
@@ -46,10 +48,13 @@ export interface ProgressBarProps {
46
48
  marker?: number | undefined;
47
49
  /** Read with the value when there is a marker. Default "marker at 75%". */
48
50
  markerLabel?: string | undefined;
51
+ /** Colour of the fill. Default "accent". */
49
52
  tone?: Exclude<Tone, "neutral"> | "neutral";
50
53
  /** Bar thickness. */
51
54
  size?: Size;
55
+ /** Replace the built-in English text: the value text. */
52
56
  labels?: Partial<ProgressBarLabels>;
57
+ /** Added to the root element, for layout. */
53
58
  className?: string;
54
59
  /** Layout only. Restyle through --cy-progress-bar-* tokens. */
55
60
  style?: CSSProperties;