@vokality/design-system 0.0.0-stage → 1.2.3

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 +97 -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,20 @@
1
+ # Textarea
2
+
3
+ A multi-line text control for notes, descriptions and messages.
4
+
5
+ ## Anatomy
6
+ Same box as `Input` (`card` fill, `input-border` edge, square, 0.6rem 0.75rem padding), 5 rows by default, at least 8rem tall, line height 1.6, resizable vertically only.
7
+
8
+ ## States
9
+ Identical to `Input`: focus adds a `primary` border and the 2px `ring` outline; invalid gets a `primary` border; disabled is transparent with a dashed edge and `muted-subtle` text.
10
+
11
+ ## Character count
12
+ `showCount` with `maxLength` shows a live "120 / 280" counter under the field, announced as it nears the limit.
13
+
14
+ ## Props
15
+ - `showCount`, and any `<textarea>` attribute: `rows`, `name`, `value` or `defaultValue`, `placeholder`, `maxLength`, `required`, `disabled`.
16
+ - The ref is the `<textarea>`.
17
+
18
+ ## Rules
19
+ - Render inside a `Field`. When there is a length limit, state it in the hint ("Up to 500 characters").
20
+ - Size the rows to the text you expect; let people resize rather than scrolling inside a tiny box.
@@ -0,0 +1,47 @@
1
+ # ThemeScript and useTheme
2
+
3
+ Theme switching without a flash of the wrong theme. `ThemeScript` sets `data-theme` on `<html>` before the page paints; `useTheme` reads and changes it.
4
+
5
+ ## Setup (Next.js App Router)
6
+ ```tsx
7
+ // app/layout.tsx
8
+ import { ThemeScript } from "@vokality/design-system";
9
+
10
+ export default function RootLayout({ children }) {
11
+ return (
12
+ <html lang="en" suppressHydrationWarning>
13
+ <head><ThemeScript /></head>
14
+ <body>{children}</body>
15
+ </html>
16
+ );
17
+ }
18
+ ```
19
+ `suppressHydrationWarning` is needed because the script changes `data-theme` before React hydrates.
20
+
21
+ ## Switching
22
+ ```tsx
23
+ "use client";
24
+ import { SegmentedControl, useTheme } from "@vokality/design-system";
25
+
26
+ export function ThemeSwitch() {
27
+ const { theme, setTheme } = useTheme();
28
+ return <SegmentedControl label="Theme" value={theme} onChange={setTheme}
29
+ options={[{ value: "system", label: "System" }, { value: "dark", label: "Dark" }, { value: "light", label: "Light" }, { value: "contrast", label: "High contrast" }]} />;
30
+ }
31
+ ```
32
+ - `theme` is the saved preference, or `"system"` when none is saved. `resolvedTheme` is the theme in effect. `setTheme("system")` clears the saved choice.
33
+ - Every `useTheme` on the page updates together, and other tabs follow through the `storage` event. While on `"system"`, the theme follows OS changes live.
34
+ - On the server, `useTheme` returns `"system"` and `defaultTheme`; the real values arrive after hydration. Don't render theme-specific markup on the server.
35
+
36
+ ## Options (both)
37
+ - `defaultTheme`: `dark` (default), `light` or `contrast`, used when nothing is saved and the system has no preference.
38
+ - `followSystem`: `true` (default) uses `prefers-contrast: more` (→ `contrast`) and `prefers-color-scheme`.
39
+ - `storageKey`: `vk-theme` by default. Use the same options on `ThemeScript` and `useTheme`.
40
+ - `ThemeScript` also takes `nonce` for a Content-Security-Policy.
41
+
42
+ ## Without React
43
+ `themeScript(options)` returns the same script as a string, for an inline `<script>` in any HTML page.
44
+
45
+ ## Rules
46
+ - Offer `contrast` as a choice, never as the default.
47
+ - Put the switch in settings or the account menu, not in the main navigation.
@@ -0,0 +1,12 @@
1
+ # TileGrid
2
+
3
+ A grid of outlined link tiles for moving between sibling pages: settings sections, regions, workspaces. The current page is marked.
4
+
5
+ ## What you provide
6
+ - `heading` and `headingId`, or a `label` for the nav when there is no visible heading.
7
+ - `items`: `{ label, href, active }[]`. Mark the current page `active`.
8
+
9
+ ## Rules
10
+ - Three columns, two under 52rem, one under 28rem.
11
+ - Tiles are outline-only; hover warms the border to `primary-line`. The active tile gets `primary-tint` and a `primary-hover` border, plus `aria-current="page"`.
12
+ - Keep labels to two or three words.
@@ -0,0 +1,19 @@
1
+ # TimePicker
2
+
3
+ A time field: type a time or pick one from a list in steps. Values are `HH:MM` (24-hour); the display follows the locale (2:30 PM in `en-US`, 14:30 in `nl-CW`).
4
+
5
+ ## Anatomy
6
+ The `Input` box with a `clock` icon, opening the `Select` list of times every `step` minutes. The chosen time is marked with a check. The list is a Radix Popover anchored to the field: rendered at the end of the page (so scrolling containers, dialogs and drawers never clip it), 4px below the field and as wide as it, flipping above when there's no room, at most 16rem tall. It fades and rises 0.5rem over `motion-normal`; no motion under reduced motion.
7
+
8
+ ## Typing
9
+ Accepts `9`, `930`, `9:30`, `9.30`, `9:30pm`, `21:30`. On Enter or leaving the field, a valid time is kept and reformatted; anything else shows "Enter a time like 2:30 PM." below the field.
10
+
11
+ ## Keyboard
12
+ ↓ / ↑ open the list near the current value and move through it; Enter chooses; Esc closes (only the list, inside a `Dialog` or `Drawer`). Focus stays in the input throughout (`role="combobox"` with `aria-activedescendant`). Clicking the field opens the list, clicking a time chooses it, and clicking outside or tabbing away closes it.
13
+
14
+ ## Props
15
+ - `value` + `onChange("HH:MM" | null)`, or `defaultValue`. `step` (minutes, 30), `min`, `max` ("08:00"), `locale`, `placeholder`, `name`, `disabled`, `defaultOpen`, `invalidMessage`.
16
+ - `ref`: the input.
17
+
18
+ ## Rules
19
+ - Pair with `DatePicker` for a date and time. Store times with their time zone elsewhere; this field holds a wall-clock time only.
@@ -0,0 +1,12 @@
1
+ # Timeline
2
+
3
+ A vertical sequence of events, newest first or oldest first: an invoice's history, an audit log, a delivery's progress.
4
+
5
+ ## Anatomy
6
+ A 20px square marker per event (an optional 14px icon inside), joined by a 1px `border-subtle` rule. Title in `small` 600, description in `muted-foreground`, time in Space Grotesk `muted-subtle`. A `status` colors the marker (`success`, `info`, `warning`, `danger`, `primary`) and adds the status word for screen readers.
7
+
8
+ ## Props
9
+ - `items`: `{ title, description, time, dateTime, status, icon }[]`, `label`.
10
+
11
+ ## Rules
12
+ - Pick one order per product and keep it. Show relative times for the last day ("2h ago") and dates after that, with the full date and time in `dateTime`.
@@ -0,0 +1,34 @@
1
+ # Toaster
2
+
3
+ Short, temporary notifications about an action someone just took ("Changes saved"), stacked in a corner. Render one `Toaster` per app and call `toast()` from anywhere. Built on Radix Toast.
4
+
5
+ ## Anatomy
6
+ 1. **Region**: fixed bottom-right (or `position="top"`), 24rem wide, with a 1rem inset that respects safe areas. Above everything (`z-tooltip`).
7
+ 2. **Toast**: `surface-elevated` panel, 1px `border`, square, with the status icon, title, optional description, an optional action (outline `Button`, `sm`) and a dismiss button.
8
+ 3. At most three toasts show at once (`max`); older ones leave as new ones arrive.
9
+
10
+ ## Timing
11
+ - Info, success and warning toasts dismiss after 5 seconds. Danger toasts stay until dismissed.
12
+ - The timer pauses while the pointer is over the stack, focus is inside it, or the window is in the background.
13
+ - Toasts slide up 0.5rem on entry; that motion stops under reduced motion.
14
+
15
+ ## API
16
+ ```js
17
+ Vokality.toast({ title, description, status, action: { label, onClick }, duration }) // returns an id
18
+ Vokality.toast.success('Project archived')
19
+ Vokality.toast.danger({ title: 'Couldn’t sync', description: 'Check your connection and try again.' })
20
+ Vokality.toast.dismiss(id) // or dismiss() for all
21
+ ```
22
+ `duration: 0` keeps a toast until dismissed. Showing a toast again with the same `id` replaces it, moves it to the end, announces it again and restarts its timer.
23
+
24
+ ## Accessibility
25
+ Each new toast is announced once through Radix's live region ("Notification", the status word, title, description and the action's label): politely, while danger toasts are assertive and interrupt. The stack is a labelled region (`label`, default "Notifications"; `{hotkey}` in it reads as F8). Every toast has a visible dismiss button.
26
+
27
+ ## Keyboard and touch
28
+ - F8 moves focus to the stack; Tab then moves through the toasts and their buttons. Esc dismisses the focused toast or, with focus elsewhere and nothing open above the stack, the newest one.
29
+ - A swipe to the right dismisses a toast on touch screens.
30
+
31
+ ## Rules
32
+ - One short sentence for the title, in the past tense for completed actions ("Invoice sent").
33
+ - Never put the only path to something important in a toast; it disappears. Use an `Alert` or `Dialog` for that.
34
+ - An action in a toast must also be available elsewhere (Undo is the classic case).
@@ -0,0 +1,23 @@
1
+ # Tooltip
2
+
3
+ A short text label that appears on hover or keyboard focus, for an icon-only control or a term that needs a one-line explanation. Built on Radix Tooltip.
4
+
5
+ ## Anatomy
6
+ Inverted for contrast: `foreground` fill with `background` text (14.6:1), 12px IBM Plex Sans 500, 0.35rem 0.55rem padding, square, at most 16rem wide. It sits 6px above the trigger (or below with `placement="bottom"`), flips when there's no room, and is centered (or start-aligned with `align="start"`).
7
+
8
+ ## Behaviour
9
+ - Appears 400ms after the pointer enters (`delay`), immediately on keyboard focus. Moving straight to another tooltip within 300ms shows it at once.
10
+ - Disappears when the pointer leaves, focus moves, or Esc is pressed.
11
+
12
+ ## Props
13
+ - `content`, `children` (exactly one focusable element; a custom component must forward its ref, as every component in the system does), `placement` (`top` or `bottom`), `align`, `delay`.
14
+
15
+ ## Touch
16
+ On touch screens a tap on the trigger runs its action and shows the tooltip for 1.5 seconds (`touchDuration`). Nothing essential may live only in a tooltip.
17
+
18
+ ## Accessibility
19
+ `role="tooltip"`, linked to the trigger with `aria-describedby` while visible. It describes; it doesn't name. An `IconButton` still needs its own `label`.
20
+
21
+ ## Rules
22
+ - Plain text only: no links, buttons or anything interactive. Use `Popover` for that.
23
+ - Never hide information someone needs to finish a task in a tooltip; touch screens can't hover.
@@ -0,0 +1,15 @@
1
+ # TreeView
2
+
3
+ A nested hierarchy people expand and select in: folders, an org chart, categories.
4
+
5
+ ## Anatomy
6
+ Rows of 32px with a chevron (turns 90° when open), an optional icon, the label and optional meta, indented 1.25rem per level. The selected row gets `primary-tint` and a `primary` icon.
7
+
8
+ ## Keyboard
9
+ ↓ ↑ move; → opens a branch or moves into it; ← closes it or moves to the parent; Home / End jump to the ends; Enter or Space selects; `*` opens every sibling branch; letters jump to the next match.
10
+
11
+ ## Accessibility
12
+ WAI-ARIA tree: `role="tree"`, `treeitem`s with `aria-level`, `aria-setsize`, `aria-posinset`, `aria-expanded` and `aria-selected`, and a roving tab stop.
13
+
14
+ ## Props
15
+ - `items`: `{ id, label, icon, meta, children }[]`, `selected` + `onSelect(id, item)`, or `defaultSelected`, `defaultExpanded` (ids), `toggleOnSelect` (true), `label`.
package/package.json CHANGED
@@ -1,6 +1,78 @@
1
1
  {
2
2
  "name": "@vokality/design-system",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.2.3",
4
+ "description": "Vokality's design system: tokens, themes and React components for every Vokality project.",
5
+ "license": "UNLICENSED",
6
+ "private": false,
7
+ "type": "module",
8
+ "main": "./dist/index.js",
9
+ "module": "./dist/index.js",
10
+ "types": "./dist/index.d.ts",
11
+ "exports": {
12
+ ".": {
13
+ "types": "./dist/index.d.ts",
14
+ "import": "./dist/index.js"
15
+ },
16
+ "./vokality.css": "./dist/vokality.css",
17
+ "./tokens.css": "./dist/tokens.css",
18
+ "./components.css": "./dist/components.css",
19
+ "./fonts.css": "./dist/fonts.css",
20
+ "./tailwind.css": "./dist/tailwind.css",
21
+ "./tokens.json": "./dist/tokens.json",
22
+ "./tokens.dtcg.json": "./dist/tokens.dtcg.json",
23
+ "./icons/*": "./dist/icons/*",
24
+ "./fonts/*": "./dist/fonts/*",
25
+ "./iife": "./dist/vokality.iife.js"
26
+ },
27
+ "files": [
28
+ "dist",
29
+ "README.md",
30
+ "CHANGELOG.md",
31
+ "docs/brand.md",
32
+ "docs/components/*/README.md"
33
+ ],
34
+ "sideEffects": [
35
+ "*.css"
36
+ ],
37
+ "scripts": {
38
+ "build": "bun scripts/build.mjs",
39
+ "test": "bun run build && bun test test/",
40
+ "test:browser": "bun run build && bun test --timeout 30000 e2e/",
41
+ "typecheck": "tsc -p tsconfig.json",
42
+ "preview": "bun run build && bun scripts/preview.mjs",
43
+ "artifact": "bun run build && bun scripts/build-artifact.mjs",
44
+ "prepack": "bun run build",
45
+ "verify:docs": "bun scripts/verify-docs-page.mjs"
46
+ },
47
+ "peerDependencies": {
48
+ "react": ">=18",
49
+ "react-dom": ">=18"
50
+ },
51
+ "devDependencies": {
52
+ "@types/react": "^18",
53
+ "@types/react-dom": "^18",
54
+ "playwright": "1.56.1",
55
+ "react": "18.3.1",
56
+ "react-dom": "18.3.1",
57
+ "typescript": "^7.0.2"
58
+ },
59
+ "publishConfig": {
60
+ "registry": "https://registry.npmjs.org",
61
+ "access": "public"
62
+ },
63
+ "repository": {
64
+ "type": "git",
65
+ "url": "https://github.com/Vokality/design-system.git"
66
+ },
67
+ "homepage": "https://github.com/Vokality/design-system#readme",
68
+ "bugs": {
69
+ "url": "https://github.com/Vokality/design-system/issues"
70
+ },
71
+ "packageManager": "bun@1.4.3",
72
+ "engines": {
73
+ "bun": ">=1.4.3"
74
+ },
75
+ "dependencies": {
76
+ "radix-ui": "1.8.0"
77
+ }
78
+ }