@vokality/design-system 0.0.0-stage → 1.2.2

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 (350) hide show
  1. package/CHANGELOG.md +92 -0
  2. package/README.md +134 -2
  3. package/dist/charts/chart.d.ts +52 -0
  4. package/dist/charts/chart.js +108 -0
  5. package/dist/components/Accordion/Accordion.d.ts +15 -0
  6. package/dist/components/Accordion/Accordion.js +16 -0
  7. package/dist/components/Alert/Alert.d.ts +14 -0
  8. package/dist/components/Alert/Alert.js +12 -0
  9. package/dist/components/AppShell/AppShell.d.ts +21 -0
  10. package/dist/components/AppShell/AppShell.js +48 -0
  11. package/dist/components/Avatar/Avatar.d.ts +11 -0
  12. package/dist/components/Avatar/Avatar.js +19 -0
  13. package/dist/components/AvatarGroup/AvatarGroup.d.ts +11 -0
  14. package/dist/components/AvatarGroup/AvatarGroup.js +13 -0
  15. package/dist/components/Badge/Badge.d.ts +9 -0
  16. package/dist/components/Badge/Badge.js +6 -0
  17. package/dist/components/BarChart/BarChart.d.ts +7 -0
  18. package/dist/components/BarChart/BarChart.js +45 -0
  19. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +11 -0
  20. package/dist/components/Breadcrumbs/Breadcrumbs.js +11 -0
  21. package/dist/components/Button/Button.d.ts +17 -0
  22. package/dist/components/Button/Button.js +23 -0
  23. package/dist/components/Calendar/Calendar.d.ts +21 -0
  24. package/dist/components/Calendar/Calendar.js +144 -0
  25. package/dist/components/Card/Card.d.ts +16 -0
  26. package/dist/components/Card/Card.js +11 -0
  27. package/dist/components/Checkbox/Checkbox.d.ts +12 -0
  28. package/dist/components/Checkbox/Checkbox.js +24 -0
  29. package/dist/components/Code/Code.d.ts +7 -0
  30. package/dist/components/Code/Code.js +6 -0
  31. package/dist/components/CodeBlock/CodeBlock.d.ts +10 -0
  32. package/dist/components/CodeBlock/CodeBlock.js +43 -0
  33. package/dist/components/Combobox/Combobox.d.ts +23 -0
  34. package/dist/components/Combobox/Combobox.js +188 -0
  35. package/dist/components/Combobox/ListPanel.d.ts +16 -0
  36. package/dist/components/Combobox/ListPanel.js +75 -0
  37. package/dist/components/CommandPalette/CommandPalette.d.ts +23 -0
  38. package/dist/components/CommandPalette/CommandPalette.js +86 -0
  39. package/dist/components/Container/Container.d.ts +10 -0
  40. package/dist/components/Container/Container.js +7 -0
  41. package/dist/components/ContextMenu/ContextMenu.d.ts +11 -0
  42. package/dist/components/ContextMenu/ContextMenu.js +56 -0
  43. package/dist/components/DatePicker/DatePicker.d.ts +25 -0
  44. package/dist/components/DatePicker/DatePicker.js +198 -0
  45. package/dist/components/DescriptionList/DescriptionList.d.ts +12 -0
  46. package/dist/components/DescriptionList/DescriptionList.js +6 -0
  47. package/dist/components/Dialog/Dialog.d.ts +23 -0
  48. package/dist/components/Dialog/Dialog.js +53 -0
  49. package/dist/components/Divider/Divider.d.ts +6 -0
  50. package/dist/components/Divider/Divider.js +10 -0
  51. package/dist/components/Drawer/Drawer.d.ts +6 -0
  52. package/dist/components/Drawer/Drawer.js +6 -0
  53. package/dist/components/EmptyState/EmptyState.d.ts +11 -0
  54. package/dist/components/EmptyState/EmptyState.js +10 -0
  55. package/dist/components/ErrorSummary/ErrorSummary.d.ts +10 -0
  56. package/dist/components/ErrorSummary/ErrorSummary.js +28 -0
  57. package/dist/components/FaqList/FaqList.d.ts +10 -0
  58. package/dist/components/FaqList/FaqList.js +6 -0
  59. package/dist/components/Field/Field.d.ts +12 -0
  60. package/dist/components/Field/Field.js +25 -0
  61. package/dist/components/Figure/Figure.d.ts +11 -0
  62. package/dist/components/Figure/Figure.js +6 -0
  63. package/dist/components/FileUpload/FileUpload.d.ts +25 -0
  64. package/dist/components/FileUpload/FileUpload.js +47 -0
  65. package/dist/components/Grid/Grid.d.ts +12 -0
  66. package/dist/components/Grid/Grid.js +10 -0
  67. package/dist/components/HatchDivider/HatchDivider.d.ts +2 -0
  68. package/dist/components/HatchDivider/HatchDivider.js +5 -0
  69. package/dist/components/Heading/Heading.d.ts +12 -0
  70. package/dist/components/Heading/Heading.js +11 -0
  71. package/dist/components/Icon/Icon.d.ts +8 -0
  72. package/dist/components/Icon/Icon.js +17 -0
  73. package/dist/components/IconButton/IconButton.d.ts +11 -0
  74. package/dist/components/IconButton/IconButton.js +16 -0
  75. package/dist/components/Inline/Inline.d.ts +13 -0
  76. package/dist/components/Inline/Inline.js +8 -0
  77. package/dist/components/Input/Input.d.ts +10 -0
  78. package/dist/components/Input/Input.js +25 -0
  79. package/dist/components/Kbd/Kbd.d.ts +7 -0
  80. package/dist/components/Kbd/Kbd.js +6 -0
  81. package/dist/components/LineChart/LineChart.d.ts +7 -0
  82. package/dist/components/LineChart/LineChart.js +53 -0
  83. package/dist/components/Link/Link.d.ts +7 -0
  84. package/dist/components/Link/Link.js +12 -0
  85. package/dist/components/LinkProvider/LinkProvider.d.ts +22 -0
  86. package/dist/components/LinkProvider/LinkProvider.js +21 -0
  87. package/dist/components/List/List.d.ts +24 -0
  88. package/dist/components/List/List.js +24 -0
  89. package/dist/components/MediaCard/MediaCard.d.ts +19 -0
  90. package/dist/components/MediaCard/MediaCard.js +25 -0
  91. package/dist/components/Menu/Menu.d.ts +14 -0
  92. package/dist/components/Menu/Menu.js +53 -0
  93. package/dist/components/Menu/entries.d.ts +40 -0
  94. package/dist/components/Menu/entries.js +146 -0
  95. package/dist/components/MultiSelect/MultiSelect.d.ts +24 -0
  96. package/dist/components/MultiSelect/MultiSelect.js +166 -0
  97. package/dist/components/NavList/NavList.d.ts +19 -0
  98. package/dist/components/NavList/NavList.js +10 -0
  99. package/dist/components/NumberInput/NumberInput.d.ts +13 -0
  100. package/dist/components/NumberInput/NumberInput.js +90 -0
  101. package/dist/components/OtpInput/OtpInput.d.ts +19 -0
  102. package/dist/components/OtpInput/OtpInput.js +75 -0
  103. package/dist/components/PageHeader/PageHeader.d.ts +18 -0
  104. package/dist/components/PageHeader/PageHeader.js +11 -0
  105. package/dist/components/Pagination/Pagination.d.ts +15 -0
  106. package/dist/components/Pagination/Pagination.js +22 -0
  107. package/dist/components/PasswordInput/PasswordInput.d.ts +7 -0
  108. package/dist/components/PasswordInput/PasswordInput.js +11 -0
  109. package/dist/components/Popover/Popover.d.ts +18 -0
  110. package/dist/components/Popover/Popover.js +26 -0
  111. package/dist/components/Progress/Progress.d.ts +13 -0
  112. package/dist/components/Progress/Progress.js +24 -0
  113. package/dist/components/Prose/Prose.d.ts +8 -0
  114. package/dist/components/Prose/Prose.js +7 -0
  115. package/dist/components/Quote/Quote.d.ts +10 -0
  116. package/dist/components/Quote/Quote.js +7 -0
  117. package/dist/components/Radio/Radio.d.ts +7 -0
  118. package/dist/components/Radio/Radio.js +9 -0
  119. package/dist/components/RadioGroup/RadioGroup.d.ts +21 -0
  120. package/dist/components/RadioGroup/RadioGroup.js +41 -0
  121. package/dist/components/SearchInput/SearchInput.d.ts +10 -0
  122. package/dist/components/SearchInput/SearchInput.js +39 -0
  123. package/dist/components/SectionHeader/SectionHeader.d.ts +10 -0
  124. package/dist/components/SectionHeader/SectionHeader.js +9 -0
  125. package/dist/components/SegmentedControl/SegmentedControl.d.ts +19 -0
  126. package/dist/components/SegmentedControl/SegmentedControl.js +21 -0
  127. package/dist/components/Select/Select.d.ts +26 -0
  128. package/dist/components/Select/Select.js +262 -0
  129. package/dist/components/Skeleton/Skeleton.d.ts +8 -0
  130. package/dist/components/Skeleton/Skeleton.js +13 -0
  131. package/dist/components/Slider/Slider.d.ts +21 -0
  132. package/dist/components/Slider/Slider.js +43 -0
  133. package/dist/components/Sparkline/Sparkline.d.ts +11 -0
  134. package/dist/components/Sparkline/Sparkline.js +15 -0
  135. package/dist/components/Spinner/Spinner.d.ts +8 -0
  136. package/dist/components/Spinner/Spinner.js +8 -0
  137. package/dist/components/SquareGlyph/SquareGlyph.d.ts +7 -0
  138. package/dist/components/SquareGlyph/SquareGlyph.js +6 -0
  139. package/dist/components/Stack/Stack.d.ts +11 -0
  140. package/dist/components/Stack/Stack.js +8 -0
  141. package/dist/components/Stat/Stat.d.ts +13 -0
  142. package/dist/components/Stat/Stat.js +22 -0
  143. package/dist/components/Steps/Steps.d.ts +13 -0
  144. package/dist/components/Steps/Steps.js +13 -0
  145. package/dist/components/Switch/Switch.d.ts +7 -0
  146. package/dist/components/Switch/Switch.js +16 -0
  147. package/dist/components/Table/Table.d.ts +48 -0
  148. package/dist/components/Table/Table.js +144 -0
  149. package/dist/components/Tabs/Tabs.d.ts +19 -0
  150. package/dist/components/Tabs/Tabs.js +29 -0
  151. package/dist/components/Tag/Tag.d.ts +12 -0
  152. package/dist/components/Tag/Tag.js +8 -0
  153. package/dist/components/Text/Text.d.ts +10 -0
  154. package/dist/components/Text/Text.js +7 -0
  155. package/dist/components/Textarea/Textarea.d.ts +6 -0
  156. package/dist/components/Textarea/Textarea.js +17 -0
  157. package/dist/components/ThemeScript/ThemeScript.d.ts +7 -0
  158. package/dist/components/ThemeScript/ThemeScript.js +9 -0
  159. package/dist/components/TileGrid/TileGrid.d.ts +13 -0
  160. package/dist/components/TileGrid/TileGrid.js +8 -0
  161. package/dist/components/TimePicker/TimePicker.d.ts +28 -0
  162. package/dist/components/TimePicker/TimePicker.js +192 -0
  163. package/dist/components/Timeline/Timeline.d.ts +16 -0
  164. package/dist/components/Timeline/Timeline.js +10 -0
  165. package/dist/components/Toaster/Toaster.d.ts +50 -0
  166. package/dist/components/Toaster/Toaster.js +63 -0
  167. package/dist/components/Tooltip/Tooltip.d.ts +11 -0
  168. package/dist/components/Tooltip/Tooltip.js +21 -0
  169. package/dist/components/TreeView/TreeView.d.ts +30 -0
  170. package/dist/components/TreeView/TreeView.js +127 -0
  171. package/dist/components.css +1798 -0
  172. package/dist/fonts/FONT-NOTICES.txt +20 -0
  173. package/dist/fonts/IBMPlexSans-Latin.woff2 +0 -0
  174. package/dist/fonts/IBMPlexSans-OFL.txt +93 -0
  175. package/dist/fonts/Manrope-Latin.woff2 +0 -0
  176. package/dist/fonts/Manrope-OFL.txt +93 -0
  177. package/dist/fonts/SpaceGrotesk-Latin.woff2 +0 -0
  178. package/dist/fonts/SpaceGrotesk-OFL.txt +93 -0
  179. package/dist/fonts.css +23 -0
  180. package/dist/hooks/useTheme.d.ts +16 -0
  181. package/dist/hooks/useTheme.js +82 -0
  182. package/dist/icons/arrow-down.svg +1 -0
  183. package/dist/icons/arrow-up-right.svg +1 -0
  184. package/dist/icons/arrow-up.svg +1 -0
  185. package/dist/icons/calendar.svg +1 -0
  186. package/dist/icons/chart.svg +1 -0
  187. package/dist/icons/check.svg +1 -0
  188. package/dist/icons/chevron-down.svg +1 -0
  189. package/dist/icons/chevron-left.svg +1 -0
  190. package/dist/icons/chevron-right.svg +1 -0
  191. package/dist/icons/chevrons-up-down.svg +1 -0
  192. package/dist/icons/circle-alert.svg +1 -0
  193. package/dist/icons/circle-check.svg +1 -0
  194. package/dist/icons/clock.svg +1 -0
  195. package/dist/icons/copy.svg +1 -0
  196. package/dist/icons/ellipsis.svg +1 -0
  197. package/dist/icons/file.svg +1 -0
  198. package/dist/icons/folder.svg +1 -0
  199. package/dist/icons/home.svg +1 -0
  200. package/dist/icons/info.svg +1 -0
  201. package/dist/icons/map-pin.svg +1 -0
  202. package/dist/icons/menu.svg +1 -0
  203. package/dist/icons/minus.svg +1 -0
  204. package/dist/icons/pencil.svg +1 -0
  205. package/dist/icons/phone.svg +1 -0
  206. package/dist/icons/plus.svg +1 -0
  207. package/dist/icons/quote.svg +1 -0
  208. package/dist/icons/search.svg +1 -0
  209. package/dist/icons/sidebar.svg +1 -0
  210. package/dist/icons/trash.svg +1 -0
  211. package/dist/icons/triangle-alert.svg +1 -0
  212. package/dist/icons/upload.svg +1 -0
  213. package/dist/icons/users.svg +1 -0
  214. package/dist/icons/x.svg +1 -0
  215. package/dist/index.d.ts +178 -0
  216. package/dist/index.js +93 -0
  217. package/dist/internal/CharCount.d.ts +17 -0
  218. package/dist/internal/CharCount.js +23 -0
  219. package/dist/internal/choice.d.ts +65 -0
  220. package/dist/internal/choice.js +111 -0
  221. package/dist/internal/focusables.d.ts +3 -0
  222. package/dist/internal/focusables.js +8 -0
  223. package/dist/internal/options.d.ts +15 -0
  224. package/dist/internal/options.js +30 -0
  225. package/dist/internal/status.d.ts +6 -0
  226. package/dist/internal/status.js +5 -0
  227. package/dist/internal/useIsoLayoutEffect.d.ts +3 -0
  228. package/dist/internal/useIsoLayoutEffect.js +4 -0
  229. package/dist/internal/useScrollActive.d.ts +3 -0
  230. package/dist/internal/useScrollActive.js +12 -0
  231. package/dist/internal/useUid.d.ts +2 -0
  232. package/dist/internal/useUid.js +6 -0
  233. package/dist/lib/cx.d.ts +2 -0
  234. package/dist/lib/cx.js +4 -0
  235. package/dist/lib/dates.d.ts +10 -0
  236. package/dist/lib/dates.js +107 -0
  237. package/dist/lib/format.d.ts +15 -0
  238. package/dist/lib/format.js +50 -0
  239. package/dist/lib/icons.d.ts +220 -0
  240. package/dist/lib/icons.js +54 -0
  241. package/dist/lib/intl.d.ts +4 -0
  242. package/dist/lib/intl.js +19 -0
  243. package/dist/lib/math.d.ts +5 -0
  244. package/dist/lib/math.js +36 -0
  245. package/dist/lib/omit.d.ts +2 -0
  246. package/dist/lib/omit.js +10 -0
  247. package/dist/lib/space.d.ts +4 -0
  248. package/dist/lib/space.js +9 -0
  249. package/dist/lib/text.d.ts +8 -0
  250. package/dist/lib/text.js +12 -0
  251. package/dist/lib/theme.d.ts +16 -0
  252. package/dist/lib/theme.js +14 -0
  253. package/dist/lib/utils.d.ts +17 -0
  254. package/dist/lib/utils.js +5 -0
  255. package/dist/tailwind.css +110 -0
  256. package/dist/tokens.css +316 -0
  257. package/dist/tokens.dtcg.json +1606 -0
  258. package/dist/tokens.json +1217 -0
  259. package/dist/types.d.ts +67 -0
  260. package/dist/types.js +1 -0
  261. package/dist/vokality.css +2139 -0
  262. package/dist/vokality.iife.js +19408 -0
  263. package/docs/brand.md +163 -0
  264. package/docs/components/Accordion/README.md +24 -0
  265. package/docs/components/Alert/README.md +31 -0
  266. package/docs/components/AppShell/README.md +20 -0
  267. package/docs/components/Avatar/README.md +17 -0
  268. package/docs/components/AvatarGroup/README.md +12 -0
  269. package/docs/components/Badge/README.md +24 -0
  270. package/docs/components/BarChart/README.md +30 -0
  271. package/docs/components/Breadcrumbs/README.md +16 -0
  272. package/docs/components/Button/README.md +43 -0
  273. package/docs/components/Calendar/README.md +43 -0
  274. package/docs/components/Card/README.md +16 -0
  275. package/docs/components/Checkbox/README.md +30 -0
  276. package/docs/components/Code/README.md +9 -0
  277. package/docs/components/CodeBlock/README.md +15 -0
  278. package/docs/components/Combobox/README.md +43 -0
  279. package/docs/components/CommandPalette/README.md +20 -0
  280. package/docs/components/Container/README.md +10 -0
  281. package/docs/components/ContextMenu/README.md +13 -0
  282. package/docs/components/Dashboard/README.md +12 -0
  283. package/docs/components/DatePicker/README.md +34 -0
  284. package/docs/components/DescriptionList/README.md +18 -0
  285. package/docs/components/Dialog/README.md +28 -0
  286. package/docs/components/Divider/README.md +15 -0
  287. package/docs/components/Drawer/README.md +16 -0
  288. package/docs/components/EmptyState/README.md +17 -0
  289. package/docs/components/ErrorPage/README.md +11 -0
  290. package/docs/components/ErrorSummary/README.md +16 -0
  291. package/docs/components/FaqList/README.md +11 -0
  292. package/docs/components/Field/README.md +27 -0
  293. package/docs/components/Figure/README.md +9 -0
  294. package/docs/components/FileUpload/README.md +20 -0
  295. package/docs/components/FormPage/README.md +11 -0
  296. package/docs/components/Grid/README.md +11 -0
  297. package/docs/components/HatchDivider/README.md +10 -0
  298. package/docs/components/Heading/README.md +10 -0
  299. package/docs/components/Icon/README.md +23 -0
  300. package/docs/components/IconButton/README.md +28 -0
  301. package/docs/components/Inline/README.md +9 -0
  302. package/docs/components/Input/README.md +31 -0
  303. package/docs/components/Kbd/README.md +13 -0
  304. package/docs/components/LineChart/README.md +27 -0
  305. package/docs/components/Link/README.md +31 -0
  306. package/docs/components/List/README.md +21 -0
  307. package/docs/components/ListDetail/README.md +11 -0
  308. package/docs/components/MediaCard/README.md +16 -0
  309. package/docs/components/Menu/README.md +45 -0
  310. package/docs/components/MultiSelect/README.md +41 -0
  311. package/docs/components/NavList/README.md +21 -0
  312. package/docs/components/NumberInput/README.md +19 -0
  313. package/docs/components/OtpInput/README.md +17 -0
  314. package/docs/components/PageHeader/README.md +17 -0
  315. package/docs/components/Pagination/README.md +22 -0
  316. package/docs/components/PasswordInput/README.md +13 -0
  317. package/docs/components/Popover/README.md +23 -0
  318. package/docs/components/Progress/README.md +19 -0
  319. package/docs/components/Prose/README.md +12 -0
  320. package/docs/components/Quote/README.md +13 -0
  321. package/docs/components/Radio/README.md +25 -0
  322. package/docs/components/RadioGroup/README.md +23 -0
  323. package/docs/components/SearchInput/README.md +23 -0
  324. package/docs/components/SectionHeader/README.md +14 -0
  325. package/docs/components/SegmentedControl/README.md +19 -0
  326. package/docs/components/Select/README.md +52 -0
  327. package/docs/components/SettingsPage/README.md +11 -0
  328. package/docs/components/SignIn/README.md +11 -0
  329. package/docs/components/Skeleton/README.md +16 -0
  330. package/docs/components/Slider/README.md +22 -0
  331. package/docs/components/Sparkline/README.md +13 -0
  332. package/docs/components/Spinner/README.md +16 -0
  333. package/docs/components/SquareGlyph/README.md +18 -0
  334. package/docs/components/Stack/README.md +11 -0
  335. package/docs/components/Stat/README.md +20 -0
  336. package/docs/components/Steps/README.md +22 -0
  337. package/docs/components/Switch/README.md +27 -0
  338. package/docs/components/Table/README.md +35 -0
  339. package/docs/components/Tabs/README.md +26 -0
  340. package/docs/components/Tag/README.md +21 -0
  341. package/docs/components/Text/README.md +11 -0
  342. package/docs/components/Textarea/README.md +20 -0
  343. package/docs/components/ThemeScript/README.md +47 -0
  344. package/docs/components/TileGrid/README.md +12 -0
  345. package/docs/components/TimePicker/README.md +19 -0
  346. package/docs/components/Timeline/README.md +12 -0
  347. package/docs/components/Toaster/README.md +34 -0
  348. package/docs/components/Tooltip/README.md +23 -0
  349. package/docs/components/TreeView/README.md +15 -0
  350. package/package.json +76 -4
@@ -0,0 +1,16 @@
1
+ import { type ReactElement, type RefObject } from "react";
2
+ export interface ListPanelProps {
3
+ /** The component's root: presses and Escape inside it are the component's own to handle. */
4
+ rootRef: RefObject<HTMLElement | null>;
5
+ /** data-index of the active option, kept scrolled into view. */
6
+ active: number;
7
+ /** The listbox (or the empty-state status): one element, which becomes the Radix content. */
8
+ children: ReactElement;
9
+ }
10
+ /**
11
+ * The listbox panel of Combobox and MultiSelect: Radix Popover content, portalled to the body and
12
+ * placed 4px from the field (Popover.Anchor), at least as wide, flipping above when there's no room.
13
+ * Non-modal and never focused: focus stays in the input, which drives it with aria-activedescendant.
14
+ * Must render inside a Popover.Root whose onOpenChange(false) closes the component.
15
+ */
16
+ export declare function ListPanel({ rootRef, active, children }: ListPanelProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,75 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useCallback, useEffect, useRef, useState } from "react";
4
+ import { Popover as Primitive } from "radix-ui";
5
+ // The shared `.vk-select-menu` rules still place an in-flow panel (absolute, under its trigger),
6
+ // so the Radix-placed panel resets them here: it sits in Radix's fixed popper wrapper.
7
+ const PANEL_STYLE = {
8
+ position: "relative",
9
+ top: "auto",
10
+ left: "auto",
11
+ right: "auto",
12
+ zIndex: "var(--z-popover)",
13
+ // Inside a modal Dialog, Radix sometimes leaves this non-modal layer at pointer-events: none
14
+ // (it orders layers by registration, which races with the dialog's), making options unclickable.
15
+ // The list closes when focus leaves the field, so it never needs Radix to block its pointer events.
16
+ pointerEvents: "auto",
17
+ minWidth: "var(--radix-popper-anchor-width)",
18
+ maxWidth: "var(--radix-popper-available-width)",
19
+ // `.vk-select-menu` caps its height at min(16rem, --vk-float-max).
20
+ "--vk-float-max": "max(96px, var(--radix-popper-available-height))",
21
+ };
22
+ const inside = (root, target) => Boolean(root.current && target instanceof Node && root.current.contains(target));
23
+ const prevent = (e) => e.preventDefault();
24
+ /**
25
+ * The listbox panel of Combobox and MultiSelect: Radix Popover content, portalled to the body and
26
+ * placed 4px from the field (Popover.Anchor), at least as wide, flipping above when there's no room.
27
+ * Non-modal and never focused: focus stays in the input, which drives it with aria-activedescendant.
28
+ * Must render inside a Popover.Root whose onOpenChange(false) closes the component.
29
+ */
30
+ export function ListPanel({ rootRef, active, children }) {
31
+ // The panel mounts a render after the list opens (it is portalled): `shown` re-runs the effects
32
+ // once it is there, and the element itself stays in a ref since scrolling writes to it.
33
+ const nodeRef = useRef(null);
34
+ const [shown, setShown] = useState(false);
35
+ const ref = useCallback((el) => {
36
+ nodeRef.current = el;
37
+ setShown(el !== null);
38
+ }, []);
39
+ // Radix reports an outside press on click; by then a press in the field may have removed its
40
+ // own target (a tag's remove button), so remember what was pressed inside.
41
+ const pressed = useRef(null);
42
+ useEffect(() => {
43
+ const root = rootRef.current;
44
+ if (!shown || !root)
45
+ return undefined;
46
+ const onDown = (e) => { pressed.current = e.target; };
47
+ root.addEventListener("pointerdown", onDown, true);
48
+ return () => {
49
+ root.removeEventListener("pointerdown", onDown, true);
50
+ pressed.current = null;
51
+ };
52
+ }, [shown, rootRef]);
53
+ const ours = (target) => inside(rootRef, target) || (target !== null && target === pressed.current);
54
+ useEffect(() => {
55
+ const node = nodeRef.current;
56
+ if (!shown || !node || active < 0)
57
+ return;
58
+ const el = node.querySelector(`[data-index="${active}"]`);
59
+ if (!el)
60
+ return;
61
+ // Scroll the list only (scrollIntoView could also scroll the page).
62
+ const top = el.offsetTop, bottom = top + el.offsetHeight;
63
+ if (top < node.scrollTop)
64
+ node.scrollTop = top;
65
+ else if (bottom > node.scrollTop + node.clientHeight)
66
+ node.scrollTop = bottom - node.clientHeight;
67
+ }, [shown, active]);
68
+ return (_jsx(Primitive.Portal, { children: _jsx(Primitive.Content, { asChild: true, ref: ref, side: "bottom", align: "start", sideOffset: 4, collisionPadding: 8, onOpenAutoFocus: prevent, onCloseAutoFocus: prevent,
69
+ // The input handles its own Escape (close, then clear); Radix dismisses only from elsewhere.
70
+ onEscapeKeyDown: (e) => { if (inside(rootRef, e.target))
71
+ e.preventDefault(); }, onInteractOutside: (e) => { if (ours(e.target))
72
+ e.preventDefault(); },
73
+ // Keep focus in the input when the panel itself is pressed.
74
+ onMouseDown: (e) => e.preventDefault(), tabIndex: undefined, style: PANEL_STYLE, children: children }) }));
75
+ }
@@ -0,0 +1,23 @@
1
+ import { type ReactNode } from "react";
2
+ import type { IconName } from "../../types.js";
3
+ export interface Command {
4
+ id?: string;
5
+ label: string;
6
+ group?: string;
7
+ icon?: IconName;
8
+ shortcut?: string;
9
+ keywords?: string[];
10
+ disabled?: boolean;
11
+ onSelect?: () => void;
12
+ }
13
+ export interface CommandPaletteProps {
14
+ commands: Command[];
15
+ open?: boolean;
16
+ onOpenChange?: (open: boolean) => void;
17
+ hotkey?: boolean;
18
+ placeholder?: string;
19
+ emptyText?: ReactNode;
20
+ title?: string;
21
+ }
22
+ /** A searchable list of every action and destination in an app, opened with ⌘K (Ctrl+K). Its shell is the Radix-based Dialog. */
23
+ export declare function CommandPalette({ commands, open: openProp, onOpenChange, hotkey, placeholder, emptyText, title }: CommandPaletteProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,86 @@
1
+ "use client";
2
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useEffect, useRef, useState } from "react";
4
+ import { Dialog } from "../Dialog/Dialog.js";
5
+ import { Icon } from "../Icon/Icon.js";
6
+ import { Kbd } from "../Kbd/Kbd.js";
7
+ import { highlight } from "../../internal/options.js";
8
+ import { useIsoLayoutEffect } from "../../internal/useIsoLayoutEffect.js";
9
+ import { useScrollActive } from "../../internal/useScrollActive.js";
10
+ import { useUid } from "../../internal/useUid.js";
11
+ import { cx } from "../../lib/cx.js";
12
+ /** A searchable list of every action and destination in an app, opened with ⌘K (Ctrl+K). Its shell is the Radix-based Dialog. */
13
+ export function CommandPalette({ commands, open: openProp, onOpenChange, hotkey, placeholder, emptyText, title }) {
14
+ const controlled = openProp !== undefined;
15
+ const [openState, setOpenState] = useState(false);
16
+ const open = openProp ?? openState;
17
+ const setOpen = (v) => {
18
+ if (!controlled)
19
+ setOpenState(v);
20
+ onOpenChange?.(v);
21
+ };
22
+ const uid = useUid("vk-cmd");
23
+ // The hotkey listener toggles from the latest state without re-subscribing on every change.
24
+ const toggleRef = useRef(() => setOpen(!open));
25
+ useIsoLayoutEffect(() => { toggleRef.current = () => setOpen(!open); });
26
+ useEffect(() => {
27
+ if (hotkey === false)
28
+ return undefined;
29
+ const onKey = (e) => {
30
+ if ((e.metaKey || e.ctrlKey) && (e.key === "k" || e.key === "K")) {
31
+ e.preventDefault();
32
+ toggleRef.current();
33
+ }
34
+ };
35
+ document.addEventListener("keydown", onKey);
36
+ return () => document.removeEventListener("keydown", onKey);
37
+ }, [hotkey]);
38
+ return (_jsxs(Dialog, { open: open, onClose: () => setOpen(false), title: title || "Command palette", className: "vk-cmd", size: "md", closeOnBackdrop: true, children: [_jsx(PaletteSearch, { uid: uid, commands: commands, placeholder: placeholder, emptyText: emptyText, close: () => setOpen(false) }), _jsxs("div", { className: "vk-cmd-footer", "aria-hidden": "true", children: [_jsx(Kbd, { children: "↑" }), _jsx(Kbd, { children: "↓" }), " to move ", _jsx(Kbd, { children: "Enter" }), " to run ", _jsx(Kbd, { children: "Esc" }), " to close"] })] }));
39
+ }
40
+ /** The search box and the matching commands. */
41
+ function PaletteSearch({ uid, commands, placeholder, emptyText, close }) {
42
+ const [query, setQuery] = useState("");
43
+ const [active, setActive] = useState(0);
44
+ const listRef = useRef(null);
45
+ const cmds = (commands || []).filter((c) => {
46
+ if (!query)
47
+ return true;
48
+ const q = query.toLowerCase();
49
+ return String(c.label).toLowerCase().includes(q) || (c.keywords || []).some((k) => k.toLowerCase().includes(q)) || (c.group && c.group.toLowerCase().includes(q));
50
+ });
51
+ useScrollActive(true, listRef, active);
52
+ const run = (c) => {
53
+ if (!c || c.disabled)
54
+ return;
55
+ close();
56
+ c.onSelect?.();
57
+ };
58
+ // Consecutive commands with the same group share a heading.
59
+ const groups = [];
60
+ cmds.forEach((c, i) => {
61
+ const g = c.group || "";
62
+ const last = groups[groups.length - 1];
63
+ if (!last || last.name !== g)
64
+ groups.push({ name: g, items: [] });
65
+ groups[groups.length - 1].items.push({ c, i });
66
+ });
67
+ return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "vk-cmd-search", children: [_jsx(Icon, { name: "search", size: 16, className: "vk-search-icon" }), _jsx("input", { "data-autofocus": "", type: "text", role: "combobox", className: "vk-input vk-search-input", placeholder: placeholder || "Type a command or search", autoComplete: "off", value: query, "aria-expanded": "true", "aria-controls": uid + "-list", "aria-activedescendant": cmds.length ? uid + "-" + active : undefined, "aria-autocomplete": "list", onChange: (e) => { setQuery(e.target.value); setActive(0); }, onKeyDown: (e) => {
68
+ if (e.key === "ArrowDown") {
69
+ e.preventDefault();
70
+ setActive(Math.min(cmds.length - 1, active + 1));
71
+ }
72
+ else if (e.key === "ArrowUp") {
73
+ e.preventDefault();
74
+ setActive(Math.max(0, active - 1));
75
+ }
76
+ else if (e.key === "Enter") {
77
+ e.preventDefault();
78
+ run(cmds[active]);
79
+ }
80
+ } })] }), cmds.length
81
+ ? (_jsx("div", { ref: listRef, id: uid + "-list", role: "listbox", "aria-label": "Commands", className: "vk-cmd-list", children: groups.map((g) => (_jsxs("div", { role: "group", "aria-label": g.name || undefined, children: [g.name ? _jsx("div", { className: "vk-menu-label", "aria-hidden": "true", children: g.name }) : null, g.items.map(({ c, i }) => (_jsxs("div", { id: uid + "-" + i, "data-index": i, role: "option", "aria-selected": i === active ? "true" : "false", "aria-disabled": c.disabled ? "true" : undefined, className: cx("vk-menu-item", "vk-cmd-item", i === active ? "vk-cmd-item-active" : null), onMouseMove: () => { if (active !== i)
82
+ setActive(i); },
83
+ // Keep focus in the search box while clicking a command.
84
+ onMouseDown: (e) => e.preventDefault(), onClick: () => run(c), children: [c.icon ? _jsx(Icon, { name: c.icon, size: 16, className: "vk-menu-item-icon" }) : _jsx("span", { className: "vk-menu-item-icon" }), _jsx("span", { className: "vk-menu-item-label", children: highlight(c.label, query) }), c.shortcut ? _jsx("kbd", { className: "vk-menu-shortcut", children: c.shortcut }) : null] }, c.id || c.label)))] }, g.name || "_"))) }))
85
+ : _jsx("p", { className: "vk-select-empty", role: "status", children: emptyText || "No commands match “" + query + "”" })] }));
86
+ }
@@ -0,0 +1,10 @@
1
+ import type { ReactNode } from "react";
2
+ import type { AsProp } from "../../types.js";
3
+ export interface ContainerProps extends AsProp {
4
+ size?: 'content' | 'prose';
5
+ padded?: boolean;
6
+ children?: ReactNode;
7
+ className?: string;
8
+ }
9
+ /** Centers content at the frame width or the reading width, with the page gutter on each side. */
10
+ export declare function Container({ as, size, padded, children, className }: ContainerProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,7 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { cx } from "../../lib/cx.js";
3
+ /** Centers content at the frame width or the reading width, with the page gutter on each side. */
4
+ export function Container({ as, size, padded, children, className }) {
5
+ const Tag = as || "div";
6
+ return _jsx(Tag, { className: cx("vk-container", size === "prose" ? "vk-container-prose" : null, padded === false ? null : "vk-container-padded", className), children: children });
7
+ }
@@ -0,0 +1,11 @@
1
+ import { type ReactNode } from "react";
2
+ import type { MenuEntry } from "../../types.js";
3
+ export interface ContextMenuProps {
4
+ items: MenuEntry[];
5
+ children: ReactNode;
6
+ label?: string;
7
+ disabled?: boolean;
8
+ className?: string;
9
+ }
10
+ /** Right-click (or Shift+F10) actions for a region: a file, a row, a canvas object. Built on Radix ContextMenu. */
11
+ export declare function ContextMenu({ items, children, label, disabled, className }: ContextMenuProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,56 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useEffect, useState } from "react";
4
+ import { ContextMenu as Primitive } from "radix-ui";
5
+ import { cx } from "../../lib/cx.js";
6
+ import { MenuEntries, useDeferredSelect, useFocusOnOpen, moveFocusNow } from "../Menu/entries.js";
7
+ /** Right-click (or Shift+F10) actions for a region: a file, a row, a canvas object. Built on Radix ContextMenu. */
8
+ export function ContextMenu({ items, children, label, disabled, className }) {
9
+ // Opening goes through "opening": Radix moves its anchor to the new point in an effect; opening in the
10
+ // same render would place the menu against the previous point for a frame (the viewport's corner, the first time).
11
+ const [state, setState] = useState("closed");
12
+ const open = state === "open";
13
+ const { defer, flush } = useDeferredSelect();
14
+ const { arm, onFocus } = useFocusOnOpen();
15
+ const onOpenChange = (next) => {
16
+ arm(next ? "first" : null);
17
+ // An open menu stays open while Radix moves it to a new point.
18
+ setState((s) => (!next ? "closed" : s === "open" ? "open" : "opening"));
19
+ };
20
+ useEffect(() => {
21
+ if (state === "opening")
22
+ setState("open");
23
+ }, [state]);
24
+ // Scrolling the page (not the menu itself) closes it: the menu is anchored to a point, not an element.
25
+ useEffect(() => {
26
+ if (!open)
27
+ return undefined;
28
+ const onScroll = (e) => {
29
+ if (e.target instanceof Element && e.target.closest(".vk-menu"))
30
+ return;
31
+ arm(null);
32
+ setState("closed");
33
+ };
34
+ window.addEventListener("scroll", onScroll, true);
35
+ return () => window.removeEventListener("scroll", onScroll, true);
36
+ }, [open, arm]);
37
+ return (_jsxs(Primitive.Root, { open: open, onOpenChange: onOpenChange, modal: false, children: [_jsx(Primitive.Trigger, { asChild: true, disabled: disabled, children: _jsx("div", { className: cx("vk-context-target", className), onContextMenu: (e) => {
38
+ // React bubbles events through portals: ignore right-clicks inside the open menu.
39
+ if (!e.currentTarget.contains(e.target))
40
+ e.preventDefault();
41
+ }, onKeyDown: (e) => {
42
+ if (disabled || !e.currentTarget.contains(e.target))
43
+ return;
44
+ if ((e.key === "F10" && e.shiftKey) || e.key === "ContextMenu") {
45
+ // Radix opens on the contextmenu event only, which not every browser sends for these keys:
46
+ // open it at the focused element instead, as a right-click there would.
47
+ e.preventDefault();
48
+ const target = e.target;
49
+ const r = target.getBoundingClientRect();
50
+ target.dispatchEvent(new MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: r.left + 8, clientY: r.bottom }));
51
+ }
52
+ }, children: children }) }), _jsx(Primitive.Portal, { children: _jsx(Primitive.Content, { className: "vk-menu vk-context-menu", "aria-label": label || "Actions", collisionPadding: 8, loop: true, onFocus: onFocus, onKeyDownCapture: moveFocusNow, onCloseAutoFocus: () => flush(), onKeyDown: (e) => { if (e.key === "Tab") {
53
+ e.preventDefault();
54
+ onOpenChange(false);
55
+ } }, children: _jsx(MenuEntries, { parts: Primitive, items: items || [], defer: defer }) }) })] }));
56
+ }
@@ -0,0 +1,25 @@
1
+ import { type CalendarProps } from "../Calendar/Calendar.js";
2
+ import type { DateRange, ISODate } from "../../types.js";
3
+ /** Field that opens a Calendar in a popover dialog. */
4
+ export interface DatePickerProps extends Omit<CalendarProps, 'autoFocus' | 'defaultMonth' | 'onChange'> {
5
+ /** Receives null when a single date is cleared. */
6
+ onChange?: (next: ISODate | DateRange | null) => void;
7
+ placeholder?: string;
8
+ /** Single mode: let people type the date (default true). */
9
+ allowTyping?: boolean;
10
+ invalidMessage?: string;
11
+ /** Posts name=YYYY-MM-DD, or name_start and name_end in range mode. */
12
+ name?: string;
13
+ disabled?: boolean;
14
+ defaultOpen?: boolean;
15
+ dialogLabel?: string;
16
+ id?: string;
17
+ 'aria-labelledby'?: string;
18
+ 'aria-describedby'?: string;
19
+ 'aria-invalid'?: boolean;
20
+ }
21
+ /**
22
+ * Field that opens a Calendar in a popover dialog (Radix Popover). The ref goes
23
+ * to the text input, or to the trigger button when typing is off.
24
+ */
25
+ export declare const DatePicker: import("react").ForwardRefExoticComponent<DatePickerProps & import("react").RefAttributes<HTMLElement>>;
@@ -0,0 +1,198 @@
1
+ "use client";
2
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { forwardRef, useCallback, useRef, useState } from "react";
4
+ import { Popover as Primitive } from "radix-ui";
5
+ import { Button } from "../Button/Button.js";
6
+ import { Calendar } from "../Calendar/Calendar.js";
7
+ import { Icon } from "../Icon/Icon.js";
8
+ import { focusables } from "../../internal/focusables.js";
9
+ import { useUid } from "../../internal/useUid.js";
10
+ import { cx } from "../../lib/cx.js";
11
+ import { parseDateInput, parseISO, toISO } from "../../lib/dates.js";
12
+ import { resolveLocale } from "../../lib/format.js";
13
+ import { dateFormat } from "../../lib/intl.js";
14
+ import { omit } from "../../lib/omit.js";
15
+ const tabbable = (el) => focusables(el).filter((n) => n.tabIndex >= 0);
16
+ /**
17
+ * Where Tab goes when it leaves the portalled panel: back to the picker's last
18
+ * tab stop, or on to the first one after the picker (inside an enclosing modal,
19
+ * wrapping to its first), as if the panel still sat in the picker's DOM.
20
+ */
21
+ function tabTarget(root, content, back) {
22
+ if (back)
23
+ return tabbable(root).pop() || null;
24
+ const scope = root.closest('[aria-modal="true"]');
25
+ const all = tabbable(scope || document.body).filter((n) => !root.contains(n) && !content.contains(n));
26
+ return all.find((n) => root.compareDocumentPosition(n) & Node.DOCUMENT_POSITION_FOLLOWING) || (scope ? all[0] || null : null);
27
+ }
28
+ /** The field's label for a value: a date, a range, or a range still open at the end. */
29
+ function dateLabel(fmt, range, value) {
30
+ const rangeValue = value && typeof value === "object" ? value : null;
31
+ const start = range ? parseISO(rangeValue?.start) : parseISO(typeof value === "string" ? value : null);
32
+ const end = range ? parseISO(rangeValue?.end) : null;
33
+ if (start && range && end)
34
+ return fmt.formatRange ? fmt.formatRange(start, end) : fmt.format(start) + " – " + fmt.format(end);
35
+ if (start && range)
36
+ return fmt.format(start) + " – …";
37
+ if (start)
38
+ return fmt.format(start);
39
+ return null;
40
+ }
41
+ /**
42
+ * The value (controlled or not) and the typed draft. A draft lasts only while the value it was
43
+ * typed against does: a new value, chosen here or passed in, shows its own label again.
44
+ */
45
+ function useDateValue(props, range) {
46
+ const valueProp = props.value;
47
+ const controlled = valueProp !== undefined;
48
+ const [uncontrolled, setUncontrolled] = useState(props.defaultValue !== undefined ? props.defaultValue : range ? { start: null, end: null } : null);
49
+ const value = controlled ? valueProp : uncontrolled;
50
+ const [draft, setDraft] = useState(null);
51
+ const set = (next) => {
52
+ setDraft(null);
53
+ if (!controlled)
54
+ setUncontrolled(next);
55
+ props.onChange?.(next);
56
+ };
57
+ return { value, set, draft: draft && draft.value === value ? draft : null, setDraft };
58
+ }
59
+ /** Whether a typed date (already parsed) may be chosen. */
60
+ function allowedDate(iso, props) {
61
+ const d = parseISO(iso), minD = parseISO(props.min), maxD = parseISO(props.max);
62
+ return iso !== null && d !== null && !(minD && d < minD) && !(maxD && d > maxD) && !props.isDateDisabled?.(iso);
63
+ }
64
+ /** Typing mode: a text input, with a button that opens the calendar. */
65
+ function TypedField(p) {
66
+ return (_jsx(Primitive.Anchor, { asChild: true, children: _jsxs("div", { className: "vk-combobox-field vk-date-field", children: [_jsx("input", { ref: p.fieldRef, id: p.id, type: "text", autoComplete: "off", className: "vk-input vk-date-input", placeholder: p.placeholder, disabled: p.disabled, value: p.text, onChange: (e) => p.onType(e.target.value), onKeyDown: (e) => {
67
+ if (e.key === "Enter") {
68
+ e.preventDefault();
69
+ p.onCommit();
70
+ }
71
+ else if (e.key === "ArrowDown" && e.altKey) {
72
+ e.preventDefault();
73
+ p.onOpen();
74
+ }
75
+ }, onBlur: (e) => {
76
+ if (!(p.popRef.current && p.popRef.current.contains(e.relatedTarget)))
77
+ p.onCommit();
78
+ }, ...p.a11y, "aria-invalid": p.invalid || p.a11y["aria-invalid"] ? true : undefined, ...(p.invalid ? { "aria-describedby": cx(p.a11y["aria-describedby"], p.errId) } : null) }), _jsx(Primitive.Trigger, { asChild: true, children: _jsx("button", { type: "button", className: "vk-field-clear vk-date-button", disabled: p.disabled, "aria-label": (p.dialogLabel || "Choose a date") + (p.label ? ", " + p.label : ""), onClick: p.onButtonClick, children: _jsx(Icon, { name: "calendar", size: 16 }) }) })] }) }));
79
+ }
80
+ /** Without typing: a button that shows the chosen date(s) and opens the calendar. */
81
+ function ButtonField({ fieldRef, id, disabled, open, label, placeholder, range, a11y, onOpen }) {
82
+ return (_jsx(Primitive.Trigger, { asChild: true, children: _jsxs("button", { ref: fieldRef, id: id, type: "button", className: "vk-input vk-select-trigger vk-date-trigger", disabled: disabled, onKeyDown: (e) => {
83
+ if (e.key === "ArrowDown" && !open) {
84
+ e.preventDefault();
85
+ onOpen();
86
+ }
87
+ }, ...a11y, children: [_jsx(Icon, { name: "calendar", size: 16, className: "vk-date-icon" }), _jsx("span", { className: label ? "vk-select-value" : "vk-select-value vk-select-placeholder", children: label || placeholder || (range ? "Select dates" : "Select a date") })] }) }));
88
+ }
89
+ /** The portalled popover dialog: the Calendar, with Clear and (single mode) Today. */
90
+ function DatePanel({ props, range, locale, value, todayISO, rootRef, popRef, refocus, changeOpen, set }) {
91
+ const close = () => changeOpen(false);
92
+ return (_jsx(Primitive.Portal, { children: _jsxs(Primitive.Content, { ref: popRef, "aria-label": props.dialogLabel || (range ? "Choose dates" : "Choose a date"), className: "vk-popover vk-date-popover", side: "bottom", align: "start", sideOffset: 4, collisionPadding: 8, onInteractOutside: (e) => {
93
+ // The field and its button belong to the picker: pressing them keeps it open (the button toggles it).
94
+ if (rootRef.current && rootRef.current.contains(e.target))
95
+ e.preventDefault();
96
+ else
97
+ refocus.current = false;
98
+ }, onCloseAutoFocus: (e) => e.preventDefault(), onKeyDown: (e) => {
99
+ // Radix closes the panel on Escape; an enclosing dialog stays open.
100
+ if (e.key === "Escape")
101
+ e.stopPropagation();
102
+ if (e.key !== "Tab" || e.altKey || e.ctrlKey || e.metaKey || !rootRef.current)
103
+ return;
104
+ const content = e.currentTarget, stops = tabbable(content), at = document.activeElement;
105
+ if (e.shiftKey ? at !== stops[0] && at !== content : at !== stops[stops.length - 1])
106
+ return;
107
+ // Tabbing off either end of the panel closes it and moves on in page order.
108
+ e.preventDefault();
109
+ e.stopPropagation();
110
+ const next = tabTarget(rootRef.current, content, e.shiftKey);
111
+ refocus.current = !next;
112
+ changeOpen(false);
113
+ next?.focus();
114
+ }, children: [_jsx(Calendar, { mode: props.mode, locale: locale, value: value, min: props.min, max: props.max, isDateDisabled: props.isDateDisabled, weekStartsOn: props.weekStartsOn, today: props.today, autoFocus: true, onChange: (next) => {
115
+ set(next);
116
+ if (!range || (typeof next === "object" && next.start && next.end))
117
+ close();
118
+ } }), _jsxs("div", { className: "vk-popover-footer", children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: () => {
119
+ set(range ? { start: null, end: null } : null);
120
+ close();
121
+ }, children: "Clear" }), range ? null : (_jsx(Button, { variant: "outline", size: "sm", onClick: () => {
122
+ set(todayISO);
123
+ close();
124
+ }, children: "Today" }))] })] }) }));
125
+ }
126
+ function InvalidDate({ id, message, example }) {
127
+ return _jsx("span", { id: id, className: "vk-field-error vk-inline-error", children: message || "Enter a date like " + example + "." });
128
+ }
129
+ /** The value for forms: name=YYYY-MM-DD, or name_start and name_end in range mode. */
130
+ function HiddenDate({ name, range, value }) {
131
+ if (!range)
132
+ return _jsx("input", { type: "hidden", name: name, value: typeof value === "string" ? value : "" });
133
+ const rangeValue = value && typeof value === "object" ? value : null;
134
+ return (_jsxs(_Fragment, { children: [_jsx("input", { type: "hidden", name: name + "_start", value: rangeValue?.start || "" }), _jsx("input", { type: "hidden", name: name + "_end", value: rangeValue?.end || "" })] }));
135
+ }
136
+ /**
137
+ * Field that opens a Calendar in a popover dialog (Radix Popover). The ref goes
138
+ * to the text input, or to the trigger button when typing is off.
139
+ */
140
+ export const DatePicker = forwardRef(function DatePicker(props, ref) {
141
+ const range = props.mode === "range";
142
+ const locale = resolveLocale(props.locale);
143
+ const base = useUid("vk-date");
144
+ const triggerId = props.id || base + "-trigger";
145
+ const { value, set, draft, setDraft } = useDateValue(props, range);
146
+ const [open, setOpen] = useState(Boolean(props.defaultOpen));
147
+ const rootRef = useRef(null), popRef = useRef(null);
148
+ // The input in typing mode, else the trigger button: where focus returns on close.
149
+ const fieldRef = useRef(null);
150
+ const setFieldRef = useCallback((el) => {
151
+ fieldRef.current = el;
152
+ if (typeof ref === "function")
153
+ ref(el);
154
+ else if (ref)
155
+ ref.current = el;
156
+ }, [ref]);
157
+ // False when the panel closes because people clicked or tabbed elsewhere: focus stays there.
158
+ const refocus = useRef(true);
159
+ const changeOpen = (next) => {
160
+ if (next)
161
+ refocus.current = true;
162
+ setOpen(next);
163
+ // Focus returns right away rather than after the exit animation.
164
+ if (!next && refocus.current)
165
+ fieldRef.current?.focus();
166
+ };
167
+ const fmt = dateFormat(locale, { month: "short", day: "numeric", year: "numeric" });
168
+ const label = dateLabel(fmt, range, value);
169
+ const todayISO = props.today || toISO(new Date());
170
+ const typing = !range && props.allowTyping !== false;
171
+ const text = draft ? draft.text : label || "";
172
+ const invalid = Boolean(draft?.invalid);
173
+ const commitTyped = () => {
174
+ if (!text.trim()) {
175
+ if (value)
176
+ set(null);
177
+ else
178
+ setDraft({ text, invalid: false, value });
179
+ return;
180
+ }
181
+ const iso = parseDateInput(text, locale);
182
+ if (!allowedDate(iso, props))
183
+ setDraft({ text, invalid: true, value });
184
+ else if (iso !== value)
185
+ set(iso);
186
+ else
187
+ setDraft(null);
188
+ };
189
+ const a11y = omit(props, ["mode", "locale", "id", "value", "defaultValue", "onChange", "placeholder", "min", "max", "isDateDisabled", "weekStartsOn", "name", "disabled", "defaultOpen", "className", "today", "dialogLabel", "allowTyping", "invalidMessage"]);
190
+ const errId = base + "-err";
191
+ const example = fmt.format(parseISO(todayISO) || new Date());
192
+ const trigger = typing ? (_jsx(TypedField, { fieldRef: setFieldRef, id: triggerId, placeholder: props.placeholder || example, disabled: props.disabled, text: text, invalid: invalid, errId: errId, a11y: a11y, dialogLabel: props.dialogLabel, label: label, onType: (t) => setDraft({ text: t, invalid: false, value }), onCommit: commitTyped, onOpen: () => changeOpen(true), onButtonClick: () => {
193
+ // Closing with the button leaves focus on it.
194
+ if (open)
195
+ refocus.current = false;
196
+ }, popRef: popRef })) : (_jsx(ButtonField, { fieldRef: setFieldRef, id: triggerId, disabled: props.disabled, open: open, label: label, placeholder: props.placeholder, range: range, a11y: a11y, onOpen: () => changeOpen(true) }));
197
+ return (_jsx(Primitive.Root, { open: open, onOpenChange: changeOpen, children: _jsxs("div", { ref: rootRef, className: cx("vk-select", "vk-datepicker", props.className), "data-state": open ? "open" : "closed", children: [trigger, _jsx(DatePanel, { props: props, range: range, locale: locale, value: value, todayISO: todayISO, rootRef: rootRef, popRef: popRef, refocus: refocus, changeOpen: changeOpen, set: set }), invalid ? _jsx(InvalidDate, { id: errId, message: props.invalidMessage, example: example }) : null, props.name ? _jsx(HiddenDate, { name: props.name, range: range, value: value }) : null] }) }));
198
+ });
@@ -0,0 +1,12 @@
1
+ import type { ReactNode } from "react";
2
+ export interface DescriptionListProps {
3
+ items: {
4
+ term: ReactNode;
5
+ description: ReactNode;
6
+ }[];
7
+ layout?: "inline" | "stacked";
8
+ columns?: 1 | 2;
9
+ className?: string;
10
+ }
11
+ /** Label and value pairs for a record's details. */
12
+ export declare function DescriptionList({ items, layout, columns, className }: DescriptionListProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,6 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { cx } from "../../lib/cx.js";
3
+ /** Label and value pairs for a record's details. */
4
+ export function DescriptionList({ items, layout, columns, className }) {
5
+ return (_jsx("dl", { className: cx("vk-dl", layout === "stacked" && "vk-dl-stacked", columns === 2 && "vk-dl-2", className), children: (items || []).map((it, i) => (_jsxs("div", { className: "vk-dl-row", children: [_jsx("dt", { children: it.term }), _jsx("dd", { children: it.description })] }, (typeof it.term === "string" ? it.term : "") + "#" + i))) }));
6
+ }
@@ -0,0 +1,23 @@
1
+ import { type ReactNode } from "react";
2
+ export interface DialogProps {
3
+ open: boolean;
4
+ onClose?: () => void;
5
+ title: ReactNode;
6
+ description?: ReactNode;
7
+ children?: ReactNode;
8
+ footer?: ReactNode;
9
+ size?: 'sm' | 'md' | 'lg';
10
+ role?: 'dialog' | 'alertdialog';
11
+ dismissible?: boolean;
12
+ closeOnBackdrop?: boolean;
13
+ closeLabel?: string;
14
+ className?: string;
15
+ }
16
+ /**
17
+ * Modal dialog (Radix Dialog; Radix AlertDialog for `role="alertdialog"`): focus moves in and is
18
+ * trapped, the page behind is inert and can't scroll, and closing returns focus to the opener.
19
+ */
20
+ export declare function Dialog(props: DialogProps & {
21
+ /** Set by Drawer: renders the panel as a sheet on this side. */
22
+ side?: 'right' | 'left';
23
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,53 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useRef } from "react";
4
+ import { AlertDialog, Dialog as Primitive } from "radix-ui";
5
+ import { IconButton } from "../IconButton/IconButton.js";
6
+ import { focusables } from "../../internal/focusables.js";
7
+ import { useIsoLayoutEffect } from "../../internal/useIsoLayoutEffect.js";
8
+ import { cx } from "../../lib/cx.js";
9
+ import { para } from "../../lib/text.js";
10
+ /**
11
+ * Modal dialog (Radix Dialog; Radix AlertDialog for `role="alertdialog"`): focus moves in and is
12
+ * trapped, the page behind is inert and can't scroll, and closing returns focus to the opener.
13
+ */
14
+ export function Dialog(props) {
15
+ const { open, title, description, children, footer, size, role, closeLabel, className, side } = props;
16
+ const alert = role === "alertdialog";
17
+ // The same Radix parts either way; AlertDialog also ignores outside presses.
18
+ const P = (alert ? AlertDialog : Primitive);
19
+ const panelRef = useRef(null);
20
+ const restoreRef = useRef(null);
21
+ const dismissible = props.dismissible !== false && !alert;
22
+ const closeOnBackdrop = dismissible && props.closeOnBackdrop !== false;
23
+ // Handlers read the latest onClose.
24
+ const onCloseRef = useRef(props.onClose);
25
+ useIsoLayoutEffect(() => { onCloseRef.current = props.onClose; });
26
+ // There is no Radix trigger: remember what had focus when the dialog opened, to return to it.
27
+ useIsoLayoutEffect(() => {
28
+ if (open)
29
+ restoreRef.current = document.activeElement;
30
+ }, [open]);
31
+ const Description = para(description);
32
+ return (_jsx(P.Root, { open: open, onOpenChange: (next) => { if (!next)
33
+ onCloseRef.current?.(); }, children: _jsx(P.Portal, { children: _jsx(P.Overlay, { className: cx("vk-overlay", side ? "vk-overlay-drawer" : null), children: _jsxs(P.Content, { ref: panelRef, "aria-modal": "true", className: cx("vk-dialog", side ? "vk-drawer vk-drawer-" + side : "vk-dialog-" + (size || "md"), className), onOpenAutoFocus: (e) => {
34
+ // The first field in the body (or [data-autofocus]), else the first footer button, else the panel.
35
+ e.preventDefault();
36
+ const panel = panelRef.current;
37
+ if (!panel)
38
+ return;
39
+ const target = panel.querySelector("[data-autofocus]") || focusables(panel.querySelector(".vk-dialog-body"))[0] || focusables(panel.querySelector(".vk-dialog-footer"))[0] || panel;
40
+ target.focus();
41
+ }, onCloseAutoFocus: (e) => {
42
+ e.preventDefault();
43
+ const r = restoreRef.current;
44
+ if (r && r.focus && document.contains(r))
45
+ r.focus();
46
+ }, onEscapeKeyDown: (e) => { if (!dismissible)
47
+ e.preventDefault(); }, onPointerDownOutside: (e) => { if (!closeOnBackdrop)
48
+ e.preventDefault(); }, children: [_jsxs("div", { className: "vk-dialog-header", children: [_jsxs("div", { className: "vk-dialog-heading", children: [_jsx(P.Title, { className: "vk-dialog-title", children: title }), description
49
+ ? _jsx(P.Description, { asChild: true, children: _jsx(Description, { className: "vk-dialog-description", children: description }) })
50
+ : null] }), dismissible
51
+ ? _jsx(P.Close, { asChild: true, children: _jsx(IconButton, { icon: "x", label: closeLabel || "Close", className: "vk-dialog-close" }) })
52
+ : null] }), children ? _jsx("div", { className: "vk-dialog-body", children: children }) : null, footer ? _jsx("div", { className: "vk-dialog-footer", children: footer }) : null] }) }) }) }));
53
+ }
@@ -0,0 +1,6 @@
1
+ export interface DividerProps {
2
+ variant?: 'solid' | 'strong' | 'dashed' | 'hatch';
3
+ className?: string;
4
+ }
5
+ /** Horizontal rule. */
6
+ export declare function Divider(props: DividerProps): import("react/jsx-runtime").JSX.Element;