@15gifts/back-office-kit 0.0.0-stage → 0.1.0-alpha.1

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 (475) hide show
  1. package/LICENSE +39 -0
  2. package/README.md +49 -2
  3. package/bin/back-office-kit.js +35 -0
  4. package/dist/browser/back-office-kit.js +22186 -0
  5. package/dist/components/Alert/Alert.css.d.ts +33 -0
  6. package/dist/components/Alert/Alert.d.ts +24 -0
  7. package/dist/components/Alert/Alert.js +63 -0
  8. package/dist/components/Alert/Alert.js.map +1 -0
  9. package/dist/components/Alert/Alert.styles.js +17 -0
  10. package/dist/components/Alert/Alert.styles.js.map +1 -0
  11. package/dist/components/Alert/index.d.ts +2 -0
  12. package/dist/components/AppShell/AppShell.css.d.ts +9 -0
  13. package/dist/components/AppShell/AppShell.d.ts +22 -0
  14. package/dist/components/AppShell/AppShell.js +48 -0
  15. package/dist/components/AppShell/AppShell.js.map +1 -0
  16. package/dist/components/AppShell/AppShell.styles.js +7 -0
  17. package/dist/components/AppShell/AppShell.styles.js.map +1 -0
  18. package/dist/components/AppShell/index.d.ts +2 -0
  19. package/dist/components/Avatar/Avatar.css.d.ts +22 -0
  20. package/dist/components/Avatar/Avatar.d.ts +14 -0
  21. package/dist/components/Avatar/Avatar.js +30 -0
  22. package/dist/components/Avatar/Avatar.js.map +1 -0
  23. package/dist/components/Avatar/Avatar.styles.js +16 -0
  24. package/dist/components/Avatar/Avatar.styles.js.map +1 -0
  25. package/dist/components/Avatar/index.d.ts +2 -0
  26. package/dist/components/Badge/Badge.css.d.ts +16 -0
  27. package/dist/components/Badge/Badge.d.ts +14 -0
  28. package/dist/components/Badge/Badge.js +18 -0
  29. package/dist/components/Badge/Badge.js.map +1 -0
  30. package/dist/components/Badge/Badge.styles.js +87 -0
  31. package/dist/components/Badge/Badge.styles.js.map +1 -0
  32. package/dist/components/Badge/index.d.ts +2 -0
  33. package/dist/components/Breadcrumbs/Breadcrumbs.css.d.ts +7 -0
  34. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +24 -0
  35. package/dist/components/Breadcrumbs/Breadcrumbs.js +51 -0
  36. package/dist/components/Breadcrumbs/Breadcrumbs.js.map +1 -0
  37. package/dist/components/Breadcrumbs/Breadcrumbs.styles.js +7 -0
  38. package/dist/components/Breadcrumbs/Breadcrumbs.styles.js.map +1 -0
  39. package/dist/components/Breadcrumbs/index.d.ts +2 -0
  40. package/dist/components/Button/Button.css.d.ts +74 -0
  41. package/dist/components/Button/Button.d.ts +30 -0
  42. package/dist/components/Button/Button.js +54 -0
  43. package/dist/components/Button/Button.js.map +1 -0
  44. package/dist/components/Button/Button.styles.js +29 -0
  45. package/dist/components/Button/Button.styles.js.map +1 -0
  46. package/dist/components/Button/index.d.ts +2 -0
  47. package/dist/components/Card/Card.css.d.ts +37 -0
  48. package/dist/components/Card/Card.d.ts +18 -0
  49. package/dist/components/Card/Card.js +38 -0
  50. package/dist/components/Card/Card.js.map +1 -0
  51. package/dist/components/Card/Card.styles.js +18 -0
  52. package/dist/components/Card/Card.styles.js.map +1 -0
  53. package/dist/components/Card/index.d.ts +2 -0
  54. package/dist/components/ChatTranscript/ChatTranscript.css.d.ts +15 -0
  55. package/dist/components/ChatTranscript/ChatTranscript.d.ts +94 -0
  56. package/dist/components/ChatTranscript/ChatTranscript.js +162 -0
  57. package/dist/components/ChatTranscript/ChatTranscript.js.map +1 -0
  58. package/dist/components/ChatTranscript/ChatTranscript.styles.js +6 -0
  59. package/dist/components/ChatTranscript/ChatTranscript.styles.js.map +1 -0
  60. package/dist/components/ChatTranscript/index.d.ts +2 -0
  61. package/dist/components/Checkbox/Checkbox.css.d.ts +3 -0
  62. package/dist/components/Checkbox/Checkbox.d.ts +11 -0
  63. package/dist/components/Checkbox/Checkbox.js +46 -0
  64. package/dist/components/Checkbox/Checkbox.js.map +1 -0
  65. package/dist/components/Checkbox/Checkbox.styles.js +8 -0
  66. package/dist/components/Checkbox/Checkbox.styles.js.map +1 -0
  67. package/dist/components/Checkbox/index.d.ts +2 -0
  68. package/dist/components/CheckboxGroup/CheckboxGroup.css.d.ts +2 -0
  69. package/dist/components/CheckboxGroup/CheckboxGroup.d.ts +28 -0
  70. package/dist/components/CheckboxGroup/CheckboxGroup.js +66 -0
  71. package/dist/components/CheckboxGroup/CheckboxGroup.js.map +1 -0
  72. package/dist/components/CheckboxGroup/CheckboxGroup.styles.js +10 -0
  73. package/dist/components/CheckboxGroup/CheckboxGroup.styles.js.map +1 -0
  74. package/dist/components/CheckboxGroup/index.d.ts +2 -0
  75. package/dist/components/Chip/Chip.css.d.ts +4 -0
  76. package/dist/components/Chip/Chip.d.ts +18 -0
  77. package/dist/components/Chip/Chip.js +40 -0
  78. package/dist/components/Chip/Chip.js.map +1 -0
  79. package/dist/components/Chip/Chip.styles.js +7 -0
  80. package/dist/components/Chip/Chip.styles.js.map +1 -0
  81. package/dist/components/Chip/index.d.ts +2 -0
  82. package/dist/components/ColorPicker/ColorPicker.css.d.ts +5 -0
  83. package/dist/components/ColorPicker/ColorPicker.d.ts +19 -0
  84. package/dist/components/ColorPicker/ColorPicker.js +79 -0
  85. package/dist/components/ColorPicker/ColorPicker.js.map +1 -0
  86. package/dist/components/ColorPicker/ColorPicker.styles.js +6 -0
  87. package/dist/components/ColorPicker/ColorPicker.styles.js.map +1 -0
  88. package/dist/components/ColorPicker/color.d.ts +14 -0
  89. package/dist/components/ColorPicker/color.js +39 -0
  90. package/dist/components/ColorPicker/color.js.map +1 -0
  91. package/dist/components/ColorPicker/index.d.ts +2 -0
  92. package/dist/components/Combobox/Combobox.d.ts +82 -0
  93. package/dist/components/Combobox/Combobox.js +177 -0
  94. package/dist/components/Combobox/Combobox.js.map +1 -0
  95. package/dist/components/Combobox/index.d.ts +2 -0
  96. package/dist/components/CopyButton/CopyButton.d.ts +11 -0
  97. package/dist/components/CopyButton/CopyButton.js +40 -0
  98. package/dist/components/CopyButton/CopyButton.js.map +1 -0
  99. package/dist/components/CopyButton/index.d.ts +2 -0
  100. package/dist/components/DateRangePicker/DateRangePicker.css.d.ts +31 -0
  101. package/dist/components/DateRangePicker/DateRangePicker.d.ts +58 -0
  102. package/dist/components/DateRangePicker/DateRangePicker.js +258 -0
  103. package/dist/components/DateRangePicker/DateRangePicker.js.map +1 -0
  104. package/dist/components/DateRangePicker/DateRangePicker.styles.js +8 -0
  105. package/dist/components/DateRangePicker/DateRangePicker.styles.js.map +1 -0
  106. package/dist/components/DateRangePicker/index.d.ts +4 -0
  107. package/dist/components/DateRangePicker/presets.d.ts +27 -0
  108. package/dist/components/DateRangePicker/presets.js +62 -0
  109. package/dist/components/DateRangePicker/presets.js.map +1 -0
  110. package/dist/components/DateTimeInput/DateTimeInput.css.d.ts +1 -0
  111. package/dist/components/DateTimeInput/DateTimeInput.d.ts +9 -0
  112. package/dist/components/DateTimeInput/DateTimeInput.js +29 -0
  113. package/dist/components/DateTimeInput/DateTimeInput.js.map +1 -0
  114. package/dist/components/DateTimeInput/DateTimeInput.styles.js +8 -0
  115. package/dist/components/DateTimeInput/DateTimeInput.styles.js.map +1 -0
  116. package/dist/components/DateTimeInput/index.d.ts +2 -0
  117. package/dist/components/DescriptionList/DescriptionList.css.d.ts +62 -0
  118. package/dist/components/DescriptionList/DescriptionList.d.ts +23 -0
  119. package/dist/components/DescriptionList/DescriptionList.js +27 -0
  120. package/dist/components/DescriptionList/DescriptionList.js.map +1 -0
  121. package/dist/components/DescriptionList/DescriptionList.styles.js +42 -0
  122. package/dist/components/DescriptionList/DescriptionList.styles.js.map +1 -0
  123. package/dist/components/DescriptionList/index.d.ts +2 -0
  124. package/dist/components/DetailsSummary/DetailsSummary.css.d.ts +5 -0
  125. package/dist/components/DetailsSummary/DetailsSummary.d.ts +11 -0
  126. package/dist/components/DetailsSummary/DetailsSummary.js +26 -0
  127. package/dist/components/DetailsSummary/DetailsSummary.js.map +1 -0
  128. package/dist/components/DetailsSummary/DetailsSummary.styles.js +15 -0
  129. package/dist/components/DetailsSummary/DetailsSummary.styles.js.map +1 -0
  130. package/dist/components/DetailsSummary/index.d.ts +2 -0
  131. package/dist/components/Drawer/Drawer.css.d.ts +14 -0
  132. package/dist/components/Drawer/Drawer.d.ts +42 -0
  133. package/dist/components/Drawer/Drawer.js +75 -0
  134. package/dist/components/Drawer/Drawer.js.map +1 -0
  135. package/dist/components/Drawer/Drawer.styles.js +17 -0
  136. package/dist/components/Drawer/Drawer.styles.js.map +1 -0
  137. package/dist/components/Drawer/index.d.ts +2 -0
  138. package/dist/components/EmptyLine/EmptyLine.css.d.ts +11 -0
  139. package/dist/components/EmptyLine/EmptyLine.d.ts +7 -0
  140. package/dist/components/EmptyLine/EmptyLine.js +19 -0
  141. package/dist/components/EmptyLine/EmptyLine.js.map +1 -0
  142. package/dist/components/EmptyLine/EmptyLine.styles.js +12 -0
  143. package/dist/components/EmptyLine/EmptyLine.styles.js.map +1 -0
  144. package/dist/components/EmptyLine/index.d.ts +2 -0
  145. package/dist/components/EmptyState/EmptyState.css.d.ts +16 -0
  146. package/dist/components/EmptyState/EmptyState.d.ts +15 -0
  147. package/dist/components/EmptyState/EmptyState.js +37 -0
  148. package/dist/components/EmptyState/EmptyState.js.map +1 -0
  149. package/dist/components/EmptyState/EmptyState.styles.js +15 -0
  150. package/dist/components/EmptyState/EmptyState.styles.js.map +1 -0
  151. package/dist/components/EmptyState/index.d.ts +2 -0
  152. package/dist/components/EnvironmentChip/EnvironmentChip.css.d.ts +24 -0
  153. package/dist/components/EnvironmentChip/EnvironmentChip.d.ts +17 -0
  154. package/dist/components/EnvironmentChip/EnvironmentChip.js +32 -0
  155. package/dist/components/EnvironmentChip/EnvironmentChip.js.map +1 -0
  156. package/dist/components/EnvironmentChip/EnvironmentChip.styles.js +17 -0
  157. package/dist/components/EnvironmentChip/EnvironmentChip.styles.js.map +1 -0
  158. package/dist/components/EnvironmentChip/index.d.ts +2 -0
  159. package/dist/components/Field/Field.css.d.ts +13 -0
  160. package/dist/components/Field/Field.d.ts +57 -0
  161. package/dist/components/Field/Field.js +58 -0
  162. package/dist/components/Field/Field.js.map +1 -0
  163. package/dist/components/Field/Field.styles.js +6 -0
  164. package/dist/components/Field/Field.styles.js.map +1 -0
  165. package/dist/components/Field/index.d.ts +2 -0
  166. package/dist/components/Fieldset/Fieldset.css.d.ts +6 -0
  167. package/dist/components/Fieldset/Fieldset.d.ts +11 -0
  168. package/dist/components/Fieldset/Fieldset.js +32 -0
  169. package/dist/components/Fieldset/Fieldset.js.map +1 -0
  170. package/dist/components/Fieldset/Fieldset.styles.js +6 -0
  171. package/dist/components/Fieldset/Fieldset.styles.js.map +1 -0
  172. package/dist/components/Fieldset/index.d.ts +2 -0
  173. package/dist/components/Grid/Grid.css.d.ts +22 -0
  174. package/dist/components/Grid/Grid.d.ts +21 -0
  175. package/dist/components/Grid/Grid.js +23 -0
  176. package/dist/components/Grid/Grid.js.map +1 -0
  177. package/dist/components/Grid/Grid.styles.js +28 -0
  178. package/dist/components/Grid/Grid.styles.js.map +1 -0
  179. package/dist/components/Grid/index.d.ts +2 -0
  180. package/dist/components/Heading/Heading.css.d.ts +21 -0
  181. package/dist/components/Heading/Heading.d.ts +11 -0
  182. package/dist/components/Heading/Heading.js +22 -0
  183. package/dist/components/Heading/Heading.js.map +1 -0
  184. package/dist/components/Heading/Heading.styles.js +18 -0
  185. package/dist/components/Heading/Heading.styles.js.map +1 -0
  186. package/dist/components/Heading/index.d.ts +2 -0
  187. package/dist/components/Icon/Icon.css.d.ts +1 -0
  188. package/dist/components/Icon/Icon.d.ts +24 -0
  189. package/dist/components/Icon/Icon.js +24 -0
  190. package/dist/components/Icon/Icon.js.map +1 -0
  191. package/dist/components/Icon/Icon.styles.js +6 -0
  192. package/dist/components/Icon/Icon.styles.js.map +1 -0
  193. package/dist/components/Icon/index.d.ts +2 -0
  194. package/dist/components/List/List.css.d.ts +4 -0
  195. package/dist/components/List/List.d.ts +13 -0
  196. package/dist/components/List/List.js +28 -0
  197. package/dist/components/List/List.js.map +1 -0
  198. package/dist/components/List/List.styles.js +6 -0
  199. package/dist/components/List/List.styles.js.map +1 -0
  200. package/dist/components/List/index.d.ts +2 -0
  201. package/dist/components/Loader/Loader.css.d.ts +1 -0
  202. package/dist/components/Loader/Loader.d.ts +12 -0
  203. package/dist/components/Loader/Loader.js +27 -0
  204. package/dist/components/Loader/Loader.js.map +1 -0
  205. package/dist/components/Loader/Loader.styles.js +7 -0
  206. package/dist/components/Loader/Loader.styles.js.map +1 -0
  207. package/dist/components/Loader/index.d.ts +2 -0
  208. package/dist/components/Menu/Menu.css.d.ts +9 -0
  209. package/dist/components/Menu/Menu.d.ts +114 -0
  210. package/dist/components/Menu/Menu.js +140 -0
  211. package/dist/components/Menu/Menu.js.map +1 -0
  212. package/dist/components/Menu/Menu.styles.js +6 -0
  213. package/dist/components/Menu/Menu.styles.js.map +1 -0
  214. package/dist/components/Menu/index.d.ts +2 -0
  215. package/dist/components/MetricBar/MetricBar.css.d.ts +10 -0
  216. package/dist/components/MetricBar/MetricBar.d.ts +28 -0
  217. package/dist/components/MetricBar/MetricBar.js +51 -0
  218. package/dist/components/MetricBar/MetricBar.js.map +1 -0
  219. package/dist/components/MetricBar/MetricBar.styles.js +20 -0
  220. package/dist/components/MetricBar/MetricBar.styles.js.map +1 -0
  221. package/dist/components/MetricBar/index.d.ts +2 -0
  222. package/dist/components/Modal/Modal.css.d.ts +24 -0
  223. package/dist/components/Modal/Modal.d.ts +22 -0
  224. package/dist/components/Modal/Modal.js +64 -0
  225. package/dist/components/Modal/Modal.js.map +1 -0
  226. package/dist/components/Modal/Modal.styles.js +17 -0
  227. package/dist/components/Modal/Modal.styles.js.map +1 -0
  228. package/dist/components/Modal/index.d.ts +2 -0
  229. package/dist/components/NavRail/HumaraLogo.d.ts +5 -0
  230. package/dist/components/NavRail/HumaraLogo.js +33 -0
  231. package/dist/components/NavRail/HumaraLogo.js.map +1 -0
  232. package/dist/components/NavRail/NavRail.css.d.ts +11 -0
  233. package/dist/components/NavRail/NavRail.d.ts +68 -0
  234. package/dist/components/NavRail/NavRail.js +129 -0
  235. package/dist/components/NavRail/NavRail.js.map +1 -0
  236. package/dist/components/NavRail/NavRail.styles.js +8 -0
  237. package/dist/components/NavRail/NavRail.styles.js.map +1 -0
  238. package/dist/components/NavRail/index.d.ts +2 -0
  239. package/dist/components/NumberInput/NumberInput.d.ts +21 -0
  240. package/dist/components/NumberInput/NumberInput.js +59 -0
  241. package/dist/components/NumberInput/NumberInput.js.map +1 -0
  242. package/dist/components/NumberInput/index.d.ts +2 -0
  243. package/dist/components/PageHeader/PageHeader.css.d.ts +8 -0
  244. package/dist/components/PageHeader/PageHeader.d.ts +15 -0
  245. package/dist/components/PageHeader/PageHeader.js +40 -0
  246. package/dist/components/PageHeader/PageHeader.js.map +1 -0
  247. package/dist/components/PageHeader/PageHeader.styles.js +6 -0
  248. package/dist/components/PageHeader/PageHeader.styles.js.map +1 -0
  249. package/dist/components/PageHeader/index.d.ts +2 -0
  250. package/dist/components/Pagination/Pagination.css.d.ts +3 -0
  251. package/dist/components/Pagination/Pagination.d.ts +19 -0
  252. package/dist/components/Pagination/Pagination.js +61 -0
  253. package/dist/components/Pagination/Pagination.js.map +1 -0
  254. package/dist/components/Pagination/Pagination.styles.js +6 -0
  255. package/dist/components/Pagination/Pagination.styles.js.map +1 -0
  256. package/dist/components/Pagination/index.d.ts +2 -0
  257. package/dist/components/Popover/Popover.css.d.ts +4 -0
  258. package/dist/components/Popover/Popover.d.ts +26 -0
  259. package/dist/components/Popover/Popover.js +44 -0
  260. package/dist/components/Popover/Popover.js.map +1 -0
  261. package/dist/components/Popover/Popover.styles.js +7 -0
  262. package/dist/components/Popover/Popover.styles.js.map +1 -0
  263. package/dist/components/Popover/index.d.ts +2 -0
  264. package/dist/components/PortalContainer/PortalContainer.d.ts +18 -0
  265. package/dist/components/PortalContainer/PortalContainer.js +17 -0
  266. package/dist/components/PortalContainer/PortalContainer.js.map +1 -0
  267. package/dist/components/PortalContainer/index.d.ts +2 -0
  268. package/dist/components/ProgressBar/ProgressBar.css.d.ts +8 -0
  269. package/dist/components/ProgressBar/ProgressBar.d.ts +22 -0
  270. package/dist/components/ProgressBar/ProgressBar.js +64 -0
  271. package/dist/components/ProgressBar/ProgressBar.js.map +1 -0
  272. package/dist/components/ProgressBar/ProgressBar.styles.js +11 -0
  273. package/dist/components/ProgressBar/ProgressBar.styles.js.map +1 -0
  274. package/dist/components/ProgressBar/index.d.ts +2 -0
  275. package/dist/components/RadioCards/RadioCards.css.d.ts +6 -0
  276. package/dist/components/RadioCards/RadioCards.d.ts +26 -0
  277. package/dist/components/RadioCards/RadioCards.js +65 -0
  278. package/dist/components/RadioCards/RadioCards.js.map +1 -0
  279. package/dist/components/RadioCards/RadioCards.styles.js +6 -0
  280. package/dist/components/RadioCards/RadioCards.styles.js.map +1 -0
  281. package/dist/components/RadioCards/index.d.ts +2 -0
  282. package/dist/components/SaveBar/SaveBar.css.d.ts +5 -0
  283. package/dist/components/SaveBar/SaveBar.d.ts +19 -0
  284. package/dist/components/SaveBar/SaveBar.js +44 -0
  285. package/dist/components/SaveBar/SaveBar.js.map +1 -0
  286. package/dist/components/SaveBar/SaveBar.styles.js +6 -0
  287. package/dist/components/SaveBar/SaveBar.styles.js.map +1 -0
  288. package/dist/components/SaveBar/index.d.ts +2 -0
  289. package/dist/components/Select/Select.css.d.ts +5 -0
  290. package/dist/components/Select/Select.d.ts +56 -0
  291. package/dist/components/Select/Select.js +118 -0
  292. package/dist/components/Select/Select.js.map +1 -0
  293. package/dist/components/Select/Select.styles.js +8 -0
  294. package/dist/components/Select/Select.styles.js.map +1 -0
  295. package/dist/components/Select/index.d.ts +2 -0
  296. package/dist/components/Skeleton/Skeleton.css.d.ts +16 -0
  297. package/dist/components/Skeleton/Skeleton.d.ts +16 -0
  298. package/dist/components/Skeleton/Skeleton.js +38 -0
  299. package/dist/components/Skeleton/Skeleton.js.map +1 -0
  300. package/dist/components/Skeleton/Skeleton.styles.js +17 -0
  301. package/dist/components/Skeleton/Skeleton.styles.js.map +1 -0
  302. package/dist/components/Skeleton/index.d.ts +2 -0
  303. package/dist/components/Stack/Stack.css.d.ts +54 -0
  304. package/dist/components/Stack/Stack.d.ts +16 -0
  305. package/dist/components/Stack/Stack.js +21 -0
  306. package/dist/components/Stack/Stack.js.map +1 -0
  307. package/dist/components/Stack/Stack.styles.js +39 -0
  308. package/dist/components/Stack/Stack.styles.js.map +1 -0
  309. package/dist/components/Stack/index.d.ts +2 -0
  310. package/dist/components/StatCard/StatCard.css.d.ts +4 -0
  311. package/dist/components/StatCard/StatCard.d.ts +11 -0
  312. package/dist/components/StatCard/StatCard.js +27 -0
  313. package/dist/components/StatCard/StatCard.js.map +1 -0
  314. package/dist/components/StatCard/StatCard.styles.js +6 -0
  315. package/dist/components/StatCard/StatCard.styles.js.map +1 -0
  316. package/dist/components/StatCard/index.d.ts +2 -0
  317. package/dist/components/StatsGrid/StatsGrid.css.d.ts +1 -0
  318. package/dist/components/StatsGrid/StatsGrid.d.ts +4 -0
  319. package/dist/components/StatsGrid/StatsGrid.js +13 -0
  320. package/dist/components/StatsGrid/StatsGrid.js.map +1 -0
  321. package/dist/components/StatsGrid/StatsGrid.styles.js +6 -0
  322. package/dist/components/StatsGrid/StatsGrid.styles.js.map +1 -0
  323. package/dist/components/StatsGrid/index.d.ts +2 -0
  324. package/dist/components/StatusBadge/StatusBadge.css.d.ts +53 -0
  325. package/dist/components/StatusBadge/StatusBadge.d.ts +10 -0
  326. package/dist/components/StatusBadge/StatusBadge.js +17 -0
  327. package/dist/components/StatusBadge/StatusBadge.js.map +1 -0
  328. package/dist/components/StatusBadge/StatusBadge.styles.js +19 -0
  329. package/dist/components/StatusBadge/StatusBadge.styles.js.map +1 -0
  330. package/dist/components/StatusBadge/index.d.ts +2 -0
  331. package/dist/components/Switch/Switch.css.d.ts +3 -0
  332. package/dist/components/Switch/Switch.d.ts +11 -0
  333. package/dist/components/Switch/Switch.js +37 -0
  334. package/dist/components/Switch/Switch.js.map +1 -0
  335. package/dist/components/Switch/Switch.styles.js +8 -0
  336. package/dist/components/Switch/Switch.styles.js.map +1 -0
  337. package/dist/components/Switch/index.d.ts +2 -0
  338. package/dist/components/Switcher/Switcher.css.d.ts +32 -0
  339. package/dist/components/Switcher/Switcher.d.ts +80 -0
  340. package/dist/components/Switcher/Switcher.js +158 -0
  341. package/dist/components/Switcher/Switcher.js.map +1 -0
  342. package/dist/components/Switcher/Switcher.styles.js +16 -0
  343. package/dist/components/Switcher/Switcher.styles.js.map +1 -0
  344. package/dist/components/Switcher/index.d.ts +2 -0
  345. package/dist/components/Table/Table.css.d.ts +31 -0
  346. package/dist/components/Table/Table.d.ts +163 -0
  347. package/dist/components/Table/Table.js +248 -0
  348. package/dist/components/Table/Table.js.map +1 -0
  349. package/dist/components/Table/Table.styles.js +12 -0
  350. package/dist/components/Table/Table.styles.js.map +1 -0
  351. package/dist/components/Table/index.d.ts +2 -0
  352. package/dist/components/TableAction/TableAction.d.ts +10 -0
  353. package/dist/components/TableAction/TableAction.js +19 -0
  354. package/dist/components/TableAction/TableAction.js.map +1 -0
  355. package/dist/components/TableAction/index.d.ts +2 -0
  356. package/dist/components/Tabs/Tabs.css.d.ts +6 -0
  357. package/dist/components/Tabs/Tabs.d.ts +69 -0
  358. package/dist/components/Tabs/Tabs.js +67 -0
  359. package/dist/components/Tabs/Tabs.js.map +1 -0
  360. package/dist/components/Tabs/Tabs.styles.js +7 -0
  361. package/dist/components/Tabs/Tabs.styles.js.map +1 -0
  362. package/dist/components/Tabs/index.d.ts +2 -0
  363. package/dist/components/Tag/Tag.css.d.ts +42 -0
  364. package/dist/components/Tag/Tag.d.ts +10 -0
  365. package/dist/components/Tag/Tag.js +30 -0
  366. package/dist/components/Tag/Tag.js.map +1 -0
  367. package/dist/components/Tag/Tag.styles.js +23 -0
  368. package/dist/components/Tag/Tag.styles.js.map +1 -0
  369. package/dist/components/Tag/index.d.ts +2 -0
  370. package/dist/components/TextInput/TextInput.css.d.ts +1 -0
  371. package/dist/components/TextInput/TextInput.d.ts +27 -0
  372. package/dist/components/TextInput/TextInput.js +59 -0
  373. package/dist/components/TextInput/TextInput.js.map +1 -0
  374. package/dist/components/TextInput/TextInput.styles.js +6 -0
  375. package/dist/components/TextInput/TextInput.styles.js.map +1 -0
  376. package/dist/components/TextInput/index.d.ts +2 -0
  377. package/dist/components/TextInput/useCharCount.d.ts +15 -0
  378. package/dist/components/TextInput/useCharCount.js +14 -0
  379. package/dist/components/TextInput/useCharCount.js.map +1 -0
  380. package/dist/components/Textarea/Textarea.css.d.ts +4 -0
  381. package/dist/components/Textarea/Textarea.d.ts +19 -0
  382. package/dist/components/Textarea/Textarea.js +59 -0
  383. package/dist/components/Textarea/Textarea.js.map +1 -0
  384. package/dist/components/Textarea/Textarea.styles.js +8 -0
  385. package/dist/components/Textarea/Textarea.styles.js.map +1 -0
  386. package/dist/components/Textarea/index.d.ts +2 -0
  387. package/dist/components/ThemeMenu/ThemeMenu.d.ts +13 -0
  388. package/dist/components/ThemeMenu/ThemeMenu.js +52 -0
  389. package/dist/components/ThemeMenu/ThemeMenu.js.map +1 -0
  390. package/dist/components/ThemeMenu/index.d.ts +2 -0
  391. package/dist/components/ThemePicker/ThemePicker.css.d.ts +10 -0
  392. package/dist/components/ThemePicker/ThemePicker.d.ts +26 -0
  393. package/dist/components/ThemePicker/ThemePicker.js +76 -0
  394. package/dist/components/ThemePicker/ThemePicker.js.map +1 -0
  395. package/dist/components/ThemePicker/ThemePicker.styles.js +7 -0
  396. package/dist/components/ThemePicker/ThemePicker.styles.js.map +1 -0
  397. package/dist/components/ThemePicker/index.d.ts +2 -0
  398. package/dist/components/TimeInput/TimeInput.d.ts +10 -0
  399. package/dist/components/TimeInput/TimeInput.js +29 -0
  400. package/dist/components/TimeInput/TimeInput.js.map +1 -0
  401. package/dist/components/TimeInput/index.d.ts +2 -0
  402. package/dist/components/ToggleGroup/ToggleGroup.css.d.ts +4 -0
  403. package/dist/components/ToggleGroup/ToggleGroup.d.ts +43 -0
  404. package/dist/components/ToggleGroup/ToggleGroup.js +69 -0
  405. package/dist/components/ToggleGroup/ToggleGroup.js.map +1 -0
  406. package/dist/components/ToggleGroup/ToggleGroup.styles.js +13 -0
  407. package/dist/components/ToggleGroup/ToggleGroup.styles.js.map +1 -0
  408. package/dist/components/ToggleGroup/index.d.ts +2 -0
  409. package/dist/components/Tooltip/Tooltip.css.d.ts +1 -0
  410. package/dist/components/Tooltip/Tooltip.d.ts +22 -0
  411. package/dist/components/Tooltip/Tooltip.js +33 -0
  412. package/dist/components/Tooltip/Tooltip.js.map +1 -0
  413. package/dist/components/Tooltip/Tooltip.styles.js +6 -0
  414. package/dist/components/Tooltip/Tooltip.styles.js.map +1 -0
  415. package/dist/components/Tooltip/index.d.ts +2 -0
  416. package/dist/components/TopBar/TopBar.css.d.ts +3 -0
  417. package/dist/components/TopBar/TopBar.d.ts +9 -0
  418. package/dist/components/TopBar/TopBar.js +20 -0
  419. package/dist/components/TopBar/TopBar.js.map +1 -0
  420. package/dist/components/TopBar/TopBar.styles.js +6 -0
  421. package/dist/components/TopBar/TopBar.styles.js.map +1 -0
  422. package/dist/components/TopBar/index.d.ts +2 -0
  423. package/dist/components/UserMenu/UserMenu.css.d.ts +5 -0
  424. package/dist/components/UserMenu/UserMenu.d.ts +27 -0
  425. package/dist/components/UserMenu/UserMenu.js +55 -0
  426. package/dist/components/UserMenu/UserMenu.js.map +1 -0
  427. package/dist/components/UserMenu/UserMenu.styles.js +7 -0
  428. package/dist/components/UserMenu/UserMenu.styles.js.map +1 -0
  429. package/dist/components/UserMenu/index.d.ts +2 -0
  430. package/dist/examples/Crm.css.d.ts +3 -0
  431. package/dist/examples/ExampleShell.d.ts +28 -0
  432. package/dist/examples/Expenses.css.d.ts +2 -0
  433. package/dist/examples/HiringTracker.css.d.ts +13 -0
  434. package/dist/examples/SalesPipeline.css.d.ts +11 -0
  435. package/dist/foundations/Foundations.css.d.ts +12 -0
  436. package/dist/index.d.ts +66 -0
  437. package/dist/index.js +67 -0
  438. package/dist/styles/input.css.d.ts +26 -0
  439. package/dist/styles/input.styles.js +7 -0
  440. package/dist/styles/input.styles.js.map +1 -0
  441. package/dist/styles/shared.css.d.ts +13 -0
  442. package/dist/styles/shared.styles.js +6 -0
  443. package/dist/styles/shared.styles.js.map +1 -0
  444. package/dist/styles.css +4 -0
  445. package/dist/theme/fontSize.d.ts +15 -0
  446. package/dist/theme/fontSize.js +16 -0
  447. package/dist/theme/fontSize.js.map +1 -0
  448. package/dist/theme/htmlSetting.d.ts +14 -0
  449. package/dist/theme/htmlSetting.js +33 -0
  450. package/dist/theme/htmlSetting.js.map +1 -0
  451. package/dist/theme/theme.d.ts +29 -0
  452. package/dist/theme/theme.js +37 -0
  453. package/dist/theme/theme.js.map +1 -0
  454. package/dist/tokens/contract.css.d.ts +120 -0
  455. package/dist/tokens/contract.styles.js +68 -0
  456. package/dist/tokens/contract.styles.js.map +1 -0
  457. package/dist/tokens/global.css.d.ts +0 -0
  458. package/dist/tokens/global.styles.js +2 -0
  459. package/dist/tokens/index.d.ts +7 -0
  460. package/dist/tokens/palette.d.ts +16 -0
  461. package/dist/tokens/palette.js +18 -0
  462. package/dist/tokens/palette.js.map +1 -0
  463. package/dist/tokens/scale.d.ts +51 -0
  464. package/dist/tokens/scale.js +47 -0
  465. package/dist/tokens/scale.js.map +1 -0
  466. package/dist/tokens/themes.css.d.ts +387 -0
  467. package/dist/tokens.js +4 -0
  468. package/package.json +111 -4
  469. package/skills/back-office-kit/SKILL.md +49 -0
  470. package/skills/back-office-kit/references/artifact-template.html +103 -0
  471. package/skills/back-office-kit/references/components.md +1470 -0
  472. package/skills/back-office-kit/references/install.md +210 -0
  473. package/skills/back-office-kit/references/migrate.md +142 -0
  474. package/skills/back-office-kit/references/patterns.md +294 -0
  475. package/skills/back-office-kit/references/testing.md +162 -0
@@ -0,0 +1,210 @@
1
+ # Installing @15gifts/back-office-kit
2
+
3
+ ## Vite / React 19 app
4
+
5
+ ```bash
6
+ npm install --save-exact @15gifts/back-office-kit
7
+ # Use the same lucide-react version as the library, so the app doesn't bundle two copies:
8
+ npm install --save-exact lucide-react@$(npm view @15gifts/back-office-kit dependencies.lucide-react)
9
+ # If the app has forms (most do): react-hook-form, pinned exactly.
10
+ # Pick the newest 7.x release that's at least two weeks old (`npm view react-hook-form time`).
11
+ npm install --save-exact react-hook-form@<version>
12
+ ```
13
+
14
+ The package is public on npm. In Humara repos whose `.npmrc` routes the `@15gifts` scope to our private registry, it comes through that registry's npm upstream, so no extra setup is needed. No Vanilla Extract or bundler plugin is needed, because the package ships compiled CSS.
15
+
16
+ - **Peer dependencies:** `react` and `react-dom` `^19.0.0`. The app installs them; the kit never bundles its own React.
17
+ - **lucide-react:** the kit pins an exact version (currently `1.68.0`). Install that same version in the app, then check `npm ls lucide-react` lists one version. A second copy bloats the bundle.
18
+
19
+ **Fonts.** The kit needs **Poppins** 400, 500 and 600, and **JetBrains Mono** 400 and 500. Its font stacks name the families `'Poppins'` and `'JetBrains Mono'`, so any source that registers those names works.
20
+
21
+ Self-hosted (no request to Google), with pinned `@fontsource/poppins` and `@fontsource/jetbrains-mono`:
22
+
23
+ ```ts
24
+ // src/main.tsx, before the kit's styles
25
+ import '@fontsource/poppins/400.css'
26
+ import '@fontsource/poppins/500.css'
27
+ import '@fontsource/poppins/600.css'
28
+ import '@fontsource/jetbrains-mono/400.css'
29
+ import '@fontsource/jetbrains-mono/500.css'
30
+ ```
31
+
32
+ Or from Google Fonts, in **index.html** `<head>`:
33
+
34
+ ```html
35
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
36
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
37
+ <link
38
+ rel="stylesheet"
39
+ href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500&family=Poppins:wght@400;500;600&display=swap"
40
+ />
41
+ ```
42
+
43
+ **src/main.tsx**: import the styles once and apply the saved theme and text size before rendering:
44
+
45
+ ```tsx
46
+ import '@15gifts/back-office-kit/styles.css'
47
+ import { applyStoredFontSize, applyStoredTheme } from '@15gifts/back-office-kit'
48
+ import { createRoot } from 'react-dom/client'
49
+ import { App } from './App'
50
+
51
+ applyStoredTheme() // reads localStorage, defaults to 'system' (pass 'light' to default to light)
52
+ applyStoredFontSize() // reads localStorage, defaults to 'md' (14px body text)
53
+ createRoot(document.getElementById('root')!).render(<App />)
54
+ ```
55
+
56
+ The library CSS lives in the `bok` cascade layer, so **unlayered** app CSS always wins without specificity battles. That includes the app's resets: an unlayered `button { color: inherit }` beats the kit's button colours. Move resets into a layer before `bok` ([migrate.md](migrate.md#keep-app-resets-below-the-kit)); delete global `body` styles (the library sets `body` background, colour and font).
57
+
58
+ **If the app uses cascade layers** (Mantine's layered CSS, Tailwind v4, its own `@layer`), declare the order once, before any other CSS, with `bok` after resets and other UI libraries and before the app:
59
+
60
+ ```css
61
+ @layer reset, mantine, bok, app;
62
+ ```
63
+
64
+ Otherwise another library's element styles (e.g. Mantine's `button { font: inherit }`) override library components.
65
+
66
+ **Text size.** The library sets the root font size and sizes everything in rem/em, so one setting scales the whole UI: `md` (default, 14px body text, a 16px root), `sm` (about 6% smaller) or `lg` (about 6% larger). Use `setFontSize('sm' | 'md' | 'lg')` or `useFontSize()` for a user setting (saved in localStorage); `applyStoredFontSize()` restores it. Don't set `html { font-size }` in the app, and size your own UI in rem/em (never px, except 1px borders) so it scales too.
67
+
68
+ ## Theming
69
+
70
+ - Themes: `light`, `dark`, `sand`, and `system` (follows the OS).
71
+ - `setTheme('dark')` sets `<html data-theme="dark">` and remembers it. `useTheme()` returns `[theme, setTheme]` for UI such as `ThemePicker`.
72
+ - To force a theme for a section, put `data-theme="light"`, `"dark"` or `"sand"` on any wrapper element. `system` only works on `<html>`.
73
+ - `getColorScheme()` / `useColorScheme()` return the resolved `'light' | 'dark'` (`system` follows the OS and `sand` is light). Use them to drive another library's dark mode while both coexist, e.g. Mantine: `<MantineProvider forceColorScheme={useColorScheme()}>`.
74
+ - The choice is saved under `THEME_STORAGE_KEY` (`bok-theme`). To keep users' choices from an older theme setting, pass `migrate`: `applyStoredTheme({ migrate: () => readOldSetting() })`. It runs only when nothing is saved yet, and the result is saved.
75
+
76
+ ## Popups inside native dialogs
77
+
78
+ Select, Combobox, Menu, Popover and Tooltip portal to `document.body`. Inside the library `Modal` or `Drawer` that's handled automatically. Inside an app's own `<dialog>` opened with `showModal()` (the top layer), wrap the dialog content so popups render inside it:
79
+
80
+ ```tsx
81
+ <dialog ref={dialogRef}>
82
+ <PortalContainer container={dialogRef}>…</PortalContainer>
83
+ </dialog>
84
+ ```
85
+
86
+ ## Routing
87
+
88
+ Library components never import a router. Pass links through `render`:
89
+
90
+ ```tsx
91
+ import { Link } from 'react-router'
92
+
93
+ export const ViewRuns = () => <Button render={<Link to="/runs" />}>View runs</Button>
94
+ ```
95
+
96
+ ## Your own styles
97
+
98
+ - **Colours, fonts, shadows:** CSS variables only, never raw values: `--bok-bg`, `--bok-surface`, `--bok-surface-sunken`, `--bok-border`, `--bok-ink`, `--bok-ink-muted`, `--bok-primary`, `--bok-accent`, `--bok-accent-ink`, `--bok-success`, `--bok-warning`, `--bok-danger`, `--bok-font-sans`, `--bok-font-mono`, `--bok-shadow-md`, and so on. The base tones (`--bok-accent`, `--bok-success`, …) are fills; text uses the `-ink` variants.
99
+ - **Scale:** the kit's sizes are CSS variables too: `--bok-space-*`, `--bok-radius-*`, `--bok-font-size-*`, `--bok-font-weight-*`, `--bok-line-height-*` (list in [migrate.md](migrate.md#scale-variables)).
100
+ - **Sizes:** rem for layout (spacing on a 0.25rem grid: `0.5rem`, `0.75rem`, `1rem`, `1.5rem`, `2rem`; radius `0.5rem` for controls, `0.75rem`–`1rem` for cards), and em for things that should follow their own text (icon sizes `1em`, gaps inside a button). No px except 1px borders. This keeps the global text-size setting working.
101
+
102
+ Vanilla Extract apps can import typed tokens instead:
103
+
104
+ ```ts
105
+ import { vars, space, radius } from '@15gifts/back-office-kit/tokens'
106
+ export const panel = style({
107
+ background: vars.color.surface,
108
+ padding: space['4'],
109
+ borderRadius: radius.xl,
110
+ })
111
+ ```
112
+
113
+ ## Linting
114
+
115
+ Use **ESLint** with our shared config, `@15gifts/eslint-config-humara`, not oxlint or Biome. The Vite React template now ships oxlint: remove it (its dependency, its config file and the `lint` script) and set up ESLint instead.
116
+
117
+ 1. `@15gifts/*` packages come from our private registry. Copy the `@15gifts:registry=…` line from an existing Humara repo's `.npmrc` (e.g. `back-office-kit` or `indy-backoffice`) into the app's `.npmrc`, keep `registry=https://registry.npmjs.org/` for everything else, and log in with `aws codeartifact login` (needs the VPN).
118
+ 2. `npm install --save-dev --save-exact eslint@9 @15gifts/eslint-config-humara @eslint/compat` (the shared config targets ESLint 9).
119
+ - **TypeScript version:** the shared config's typescript-eslint supports TypeScript up to 6.0, but the Vite template now installs TypeScript 7, which crashes ESLint. Pin TypeScript 6 (`npm install --save-dev --save-exact typescript@6.0.3`) _before_ installing the config, then check `npm ls typescript` shows one version. If you installed the config first, reinstall it after pinning.
120
+ - **Prettier:** the shared config runs Prettier as a lint rule. Add our house `.prettierrc` (below), or lint reports every line formatted differently.
121
+ 3. `eslint.config.js`:
122
+
123
+ ```js
124
+ import path from 'node:path'
125
+ import { base, react, typescript, vitest } from '@15gifts/eslint-config-humara'
126
+ import { includeIgnoreFile } from '@eslint/compat'
127
+
128
+ const dir = path.dirname(new URL(import.meta.url).pathname)
129
+
130
+ export default [
131
+ includeIgnoreFile(path.resolve(dir, '.gitignore')),
132
+ { ignores: ['eslint.config.js'] },
133
+ ...base,
134
+ ...react,
135
+ ...typescript,
136
+ ...vitest,
137
+ {
138
+ files: ['**/*.{ts,tsx}'],
139
+ languageOptions: {
140
+ parserOptions: { project: ['tsconfig.app.json', 'tsconfig.node.json'], tsconfigRootDir: dir },
141
+ },
142
+ },
143
+ {
144
+ // Our components and recipes use named exports; the shared config prefers default exports.
145
+ rules: { 'import/prefer-default-export': 'off' },
146
+ },
147
+ ]
148
+ ```
149
+
150
+ 4. `.prettierrc`:
151
+
152
+ ```json
153
+ {
154
+ "endOfLine": "lf",
155
+ "semi": false,
156
+ "singleQuote": true,
157
+ "tabWidth": 2,
158
+ "trailingComma": "all",
159
+ "printWidth": 100
160
+ }
161
+ ```
162
+
163
+ Vite's entry file `src/main.tsx` may trip the shared config's filename rule; turn `check-file/filename-naming-convention` off for that file only.
164
+
165
+ Add `...storybook` from the same package if the app has Storybook. The `"lint": "eslint ."` script replaces oxlint's.
166
+
167
+ ## Claude artifacts
168
+
169
+ Artifacts are single HTML pages with no bundler. They can load scripts only from public CDNs (jsdelivr, unpkg, …) at an **exact version at least two weeks old**, and stylesheets only from Google Fonts. The package ships a browser build for exactly this: `dist/browser/back-office-kit.js` bundles everything **except React**, which the page provides once through an import map. It also includes the styles and adds them to the page when imported, so **don't fetch or paste `styles.css`**. Start from [artifact-template.html](artifact-template.html).
170
+
171
+ 1. **Pick versions.** Use the newest `@15gifts/back-office-kit` release that's at least two weeks old (`npm view @15gifts/back-office-kit time --json`). Then find the React version jsdelivr pins inside React DOM:
172
+
173
+ ```bash
174
+ curl -s https://cdn.jsdelivr.net/npm/react-dom@<react-version>/client/+esm | grep -o '/npm/react@[^/]*'
175
+ ```
176
+
177
+ Use that same exact React version for `react`, `react/jsx-runtime`, `react-dom` and `react-dom/client` in the import map. If the versions differ, the page loads two Reacts and components crash with "Invalid hook call".
178
+
179
+ 2. **Fonts.** Keep the Google Fonts `<link>` for Poppins and JetBrains Mono from the template. The component styles need nothing: importing the library adds them.
180
+ 3. **Import map:**
181
+
182
+ ```html
183
+ <script type="importmap">
184
+ {
185
+ "imports": {
186
+ "react": "https://cdn.jsdelivr.net/npm/react@19.3.1/+esm",
187
+ "react/jsx-runtime": "https://cdn.jsdelivr.net/npm/react@19.3.1/jsx-runtime/+esm",
188
+ "react-dom": "https://cdn.jsdelivr.net/npm/react-dom@19.3.1/+esm",
189
+ "react-dom/client": "https://cdn.jsdelivr.net/npm/react-dom@19.3.1/client/+esm",
190
+ "htm": "https://cdn.jsdelivr.net/npm/htm@3.1.1/+esm",
191
+ "react-hook-form": "https://cdn.jsdelivr.net/npm/react-hook-form@7.91.0/+esm",
192
+ "lucide-react": "https://cdn.jsdelivr.net/npm/lucide-react@<library's lucide version>/+esm",
193
+ "@15gifts/back-office-kit": "https://cdn.jsdelivr.net/npm/@15gifts/back-office-kit@<version>/dist/browser/back-office-kit.js"
194
+ }
195
+ }
196
+ </script>
197
+ ```
198
+
199
+ Use the lucide-react version from `npm view @15gifts/back-office-kit@<version> dependencies.lucide-react`. jsdelivr resolves its React to the same URL as above, so there's still one React.
200
+
201
+ `react-hook-form` is for forms, as in apps (checked: it shares the page's React). Drop the line if the artifact has no form.
202
+
203
+ 4. **Write the UI with `htm`, not JSX.** There's no compiler. `htm` gives JSX-like templates: `` html`<${Button} variant="secondary">Cancel</${Button}>` `` (bind it with `htm.bind(createElement)`). Components, props, `render` links and theming all work exactly as in an app.
204
+ 5. **Theme:** set `<html data-theme="light">` (or `dark`, `sand`, `system`), or call `setTheme`. Text size works too, via `data-font-size` or `setFontSize`.
205
+
206
+ Checked against the browser build: one React, styles injected on import, popups work inside Modal, light/dark switching, and lucide icons.
207
+
208
+ ## Claude skill for this app
209
+
210
+ `npx back-office-kit skill` links this skill into the project's `.claude/skills/`, so it stays version-locked to the installed package.
@@ -0,0 +1,142 @@
1
+ # Migrating existing UI to @15gifts/back-office-kit
2
+
3
+ Work page by page. Keep each step shippable.
4
+
5
+ ## Steps
6
+
7
+ 1. **Install and wire up** ([install.md](install.md)). Import `@15gifts/back-office-kit/styles.css` once and add the fonts.
8
+ 2. **Tame the conflicting globals:** move CSS resets into a layer below the kit ([below](#keep-app-resets-below-the-kit)), delete `body` font/colour/background, and turn off Tailwind preflight (`corePlugins: { preflight: false }`) if Tailwind stays for layout.
9
+ 3. **Swap the shell first** (`AppShell`, `NavRail`, `TopBar`, `PageHeader`). It gives the biggest visual win.
10
+ 4. **Swap leaf components** using the table below, one page at a time.
11
+ 5. **Replace colours.** Search for hex/rgb literals and colour utility classes, and map them to tokens (below).
12
+ 6. **Delete dead CSS**, and uninstall the old UI library once nothing imports it.
13
+ 7. **Check** each migrated page in light and dark (`setTheme('dark')`), and tab through it with the keyboard.
14
+
15
+ ## Keep app resets below the kit
16
+
17
+ The kit's CSS is in `@layer bok`, and unlayered CSS beats any layer. So an app reset such as `button { color: inherit }` or a global `:focus-visible { box-shadow: … }` overrides kit components. Don't delete the resets: layer them.
18
+
19
+ 1. A file imported **before** the kit's CSS declares the order:
20
+
21
+ ```css
22
+ /* src/layers.css */
23
+ @layer reset, bok;
24
+ ```
25
+
26
+ ```ts
27
+ // src/main.tsx
28
+ import './layers.css'
29
+ import '@15gifts/back-office-kit/styles.css'
30
+ ```
31
+
32
+ 2. Wrap the app's resets in that layer:
33
+
34
+ ```css
35
+ @layer reset {
36
+ button {
37
+ color: inherit;
38
+ font: inherit;
39
+ }
40
+ :focus-visible {
41
+ box-shadow: 0 0 0 2px var(--bok-focus-ring);
42
+ }
43
+ }
44
+ ```
45
+
46
+ `bok` now beats the resets, while the app's other, unlayered CSS still beats `bok`. With more libraries, list every layer once, e.g. `@layer reset, mantine, bok, app;`.
47
+
48
+ ## Scale variables
49
+
50
+ For plain CSS (CSS modules, Sass, Tailwind arbitrary values), the kit's scale is on `:root` as CSS variables, from the same source as the components:
51
+
52
+ | Group | Variables |
53
+ | ----------- | ------------------------------------------------------------------------------------------------- |
54
+ | Spacing | `--bok-space-0` … `--bok-space-12` (4px steps; `--bok-space-0-5` is 2px, `--bok-space-4` is 1rem) |
55
+ | Radius | `--bok-radius-sm`, `-md`, `-lg`, `-xl`, `-2xl`, `-full` |
56
+ | Font size | `--bok-font-size-xs`, `-sm`, `-md` (body), `-lg`, `-xl`, `-2xl`, `-3xl` |
57
+ | Font weight | `--bok-font-weight-normal`, `-medium`, `-semibold` |
58
+ | Line height | `--bok-line-height-tight`, `-normal` |
59
+
60
+ Half steps use a dash: `--bok-space-0-5`, `--bok-space-1-5`, `--bok-space-2-5`. Sizes are rem, so they follow the text-size setting.
61
+
62
+ ```css
63
+ .panel {
64
+ padding: var(--bok-space-4);
65
+ border-radius: var(--bok-radius-xl);
66
+ font-size: var(--bok-font-size-sm);
67
+ }
68
+ ```
69
+
70
+ ## Component mapping
71
+
72
+ | From (shadcn / MUI / Mantine / hand-rolled) | To |
73
+ | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
74
+ | `<button>`, `Button` (variant default/outline/ghost/destructive) | `Button` (`primary` / `secondary` / `ghost` / `danger`) |
75
+ | `<a className="btn">`, `Button asChild` + `Link`, `Button component={Link}` | `Button render={<Link to="…" />}` |
76
+ | `Card`, `Paper`, bordered `div` | `Card` (`heading`, `actions`) |
77
+ | `Badge`, `Chip` (status) | `StatusBadge` for run/job states, `Badge tone=…` otherwise |
78
+ | `Chip` / toggle pills (filters) | `Chip` (pressed state) |
79
+ | `Input` + `Label` + helper text, `TextField` | `TextInput label description error` |
80
+ | `Textarea`, `TextField multiline` | `Textarea` |
81
+ | `Select`, native `<select>`, `Autocomplete` | `Select` (fixed list), `Combobox` (filterable), `Autocomplete` (free text + suggestions) |
82
+ | `Switch`, `Checkbox`, `RadioGroup` | `Switch`, `Checkbox`, `RadioCards` (or `ToggleGroup` for 2–4 short options) |
83
+ | Date range pickers | `DateRangePicker` (quick ranges built in) |
84
+ | `Tabs` | `Tabs items=[…]` (supports `count`) |
85
+ | `Dialog`, `Modal` | `Modal` (centred, blocking) or `Drawer` (side panel) |
86
+ | `DropdownMenu`, `Menu` | `Menu` (`items`, `'separator'`) |
87
+ | `Popover`, `Tooltip` | `Popover`, `Tooltip` |
88
+ | `Table`, `DataGrid` (simple) | `Table columns rows getRowKey` (or `Table.Root/Row/Cell` parts) |
89
+ | `Progress`, `LinearProgress` | `ProgressBar` (done/running/failed/total) or `MetricBar` (a percentage with segments) |
90
+ | Spinner | `Loader`, or `Button loading`, or `Skeleton` for placeholders |
91
+ | `Alert`, toast-style inline banners | `Alert tone=…` |
92
+ | `Avatar` | `Avatar name src` |
93
+ | Pagination | `Pagination page pageCount onPageChange` |
94
+ | Stat / KPI tiles | `StatCard` inside `StatsGrid` |
95
+ | Flex/stack wrappers | `Stack direction gap` |
96
+ | Icon sets (heroicons, MUI icons, react-icons) | `lucide-react` equivalents |
97
+
98
+ ## Colour mapping
99
+
100
+ | Was | Token |
101
+ | -------------------------------------- | ------------------------------------------------------------------ |
102
+ | page background (`gray-50`, `#f8f8f8`) | `--bok-bg` |
103
+ | card/panel background (`white`) | `--bok-surface` |
104
+ | subtle/inset background (`gray-100`) | `--bok-surface-sunken`, hover `--bok-surface-hover` |
105
+ | borders (`gray-200`) | `--bok-border` (strong: `--bok-border-strong`) |
106
+ | body text (`gray-900`) | `--bok-ink` |
107
+ | secondary text (`gray-500/600`) | `--bok-ink-muted` (tertiary: `--bok-ink-subtle`) |
108
+ | brand / primary actions | `--bok-primary`, text on it `--bok-on-primary` |
109
+ | highlights, selected states | `--bok-accent`, `--bok-accent-subtle`, `--bok-accent-ink` |
110
+ | green / amber / red / blue states | `--bok-success*`, `--bok-warning*`, `--bok-danger*`, `--bok-info*` |
111
+ | monospace | `--bok-font-mono` |
112
+
113
+ Never translate a colour to a palette hex. If nothing fits, the design probably needs a library component instead. Flag it to the user.
114
+
115
+ ## Running alongside Mantine (or another UI library)
116
+
117
+ Migrate page by page with both libraries loaded:
118
+
119
+ 1. Layer order: `@layer reset, mantine, bok, app;` (see install.md).
120
+ 2. Theme: the library owns `data-theme`. Derive the other library's scheme from it: `forceColorScheme={useColorScheme()}`.
121
+ 3. Old tokens: re-point the app's own CSS variables at `--bok-*` (e.g. `--app-text: var(--bok-ink)`), so unmigrated screens match in every theme.
122
+ 4. Saved theme: `applyStoredTheme({ migrate })` carries over the old setting.
123
+ 5. Remove the other library once nothing imports it. Bundle size peaks while both are loaded.
124
+
125
+ ## Behaviour differences that affect tests
126
+
127
+ Library components follow ARIA patterns closely, so tests written against older components often need new queries:
128
+
129
+ | Component | Library behaviour | Update tests to |
130
+ | ----------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
131
+ | Alert | `info`/`success` are `role="status"`; `warning`/`danger` are `role="alert"` | query by the role for the tone |
132
+ | Loader | `role="status"` with visually hidden text "Loading" (or `label`) | `getByRole('status')`, not `progressbar` |
133
+ | Button `loading` | `aria-disabled="true"` + `aria-busy`, not native `disabled` (keeps focus) | `toHaveAttribute('aria-disabled', 'true')` |
134
+ | Switch | `role="switch"` plus a hidden native checkbox for forms | `getByRole('switch', { name })`, not `getByLabelText` |
135
+ | TextInput `maxLength` + `showCount` | hard limit: typing stops at the limit | for "allow over, show red" use `countLimit` (soft limit, sets `data-over`) |
136
+ | EnvironmentChip | includes visually hidden "Environment: " text | match with a regex or `getByText('staging')` |
137
+ | Select | `onValueChange` fires only when the value changes | |
138
+ | Badge | colour prop is `tone` (`color` is a type error) | |
139
+
140
+ ## Tailwind apps
141
+
142
+ Tailwind can stay for layout (flex, grid, gap, padding). Replace colour, font, radius and shadow utilities with library components, or with arbitrary values over tokens (`bg-[var(--bok-surface)]`). Don't restyle library components with utility classes. Use their props.
@@ -0,0 +1,294 @@
1
+ # Page patterns
2
+
3
+ Compose these from library components. Check exact props in [components.md](components.md).
4
+
5
+ ## 1. App shell (every internal app)
6
+
7
+ ```tsx
8
+ import {
9
+ AppShell,
10
+ Breadcrumbs,
11
+ EnvironmentChip,
12
+ NavRail,
13
+ TopBar,
14
+ UserMenu,
15
+ type BreadcrumbItem,
16
+ } from '@15gifts/back-office-kit'
17
+ import { Activity, LayoutDashboard, Settings } from 'lucide-react'
18
+ import { Link, Outlet, useLocation } from 'react-router'
19
+
20
+ // `user`, `signOut` and `crumbs` come from your app (auth, route metadata).
21
+ export function Layout({
22
+ user,
23
+ signOut,
24
+ crumbs,
25
+ }: {
26
+ user: { name: string }
27
+ signOut: () => void
28
+ crumbs: BreadcrumbItem[]
29
+ }) {
30
+ const { pathname } = useLocation()
31
+ const nav = [
32
+ { label: 'Dashboard', to: '/', icon: <LayoutDashboard size="1.25rem" aria-hidden /> },
33
+ { label: 'Runs', to: '/runs', icon: <Activity size="1.25rem" aria-hidden /> },
34
+ { label: 'Settings', to: '/settings', icon: <Settings size="1.25rem" aria-hidden /> },
35
+ ]
36
+ return (
37
+ <AppShell
38
+ rail={
39
+ <NavRail
40
+ appName="Persona Service"
41
+ brandRender={<Link to="/" />}
42
+ items={nav.map((n) => ({ ...n, render: <Link to={n.to} />, active: pathname === n.to }))}
43
+ footer={(expanded) => (
44
+ <UserMenu name={user.name} showName={expanded} onSignOut={signOut} />
45
+ )}
46
+ />
47
+ }
48
+ topBar={
49
+ <TopBar
50
+ start={<Breadcrumbs items={crumbs} />}
51
+ end={<EnvironmentChip environment="staging" />}
52
+ />
53
+ }
54
+ >
55
+ <Outlet />
56
+ </AppShell>
57
+ )
58
+ }
59
+ ```
60
+
61
+ **More than about six sections?** Group them: an `items` entry can be `{ group: 'Set up', items: [...] }`. Groups show their heading when the rail is expanded and a divider when it's collapsed. Use groups for every item or none.
62
+
63
+ **Rail footer.** `footer` sits at the bottom (pass a function to vary it with `expanded`): the `UserMenu`, and optionally small app-wide controls such as a `ThemeMenu` (an icon button that opens a theme menu, fits the collapsed rail) or service-status lines. A ghost `Button` in the rail takes the rail's colours. Return less (or nothing) when collapsed, since the rail is only icon-wide.
64
+
65
+ **Skip link.** `AppShell` renders a "Skip to content" link as the first Tab stop, which moves focus to `<main>` (`skipLinkLabel` changes the text). Don't add your own.
66
+
67
+ **Environment.** `EnvironmentChip` picks its colour from the name (production/live red, staging/UAT/QA/test amber-lime, dev/ephemeral/preview blue, anything else grey). Pass the real environment name; there's no colour prop.
68
+
69
+ The rail starts collapsed and remembers the user's choice in localStorage (`persistKey`, default `'bok-rail-expanded'`; `null` turns it off). Pass `expanded` and `onExpandedChange` to control it yourself; nothing is stored then.
70
+
71
+ **Switchers in the trail.** A crumb's `label` can be any control. For a customer or branch switcher, pass a `Switcher` (`size="sm"`) as the label with `current: false`: `{ label: <Switcher label="Customer" size="sm" value={id} items={customers} onSelect={…} />, current: false }`.
72
+
73
+ **Side panel.** Pass `sidePanel` only on pages that have section navigation. Leave it `undefined` elsewhere (don't pass an empty component), and the content sits right next to the rail.
74
+
75
+ **Logo and app name.** The Humara logo is built into `NavRail` (the wordmark when expanded, the fan mark when collapsed) and follows the theme. Don't add your own logo. Set `appName` to the tool's name, e.g. `"Back Office"` or `"Persona Service"`: it shows under the wordmark and names the home link ("Persona Service home").
76
+
77
+ **No router?** Use `href` instead of `render`: `items={[{ label: 'Runs', href: '/runs', icon, active: true }]}`, `brandHref="/"`, and `{ label: 'Home', href: '/' }` in `Breadcrumbs`.
78
+
79
+ `AppShell` already spaces its direct children (1.5rem gap) and caps the content width. Put page sections straight inside it, without a wrapping `Stack`. Pass `contained={false}` for full-width content.
80
+
81
+ Each page then starts with a `PageHeader` (one h1, an optional facts line, and the page's primary action at the top right).
82
+
83
+ ## 2. Data table page
84
+
85
+ ```tsx
86
+ <PageHeader title="Runs" facts={[`${runs.length} runs`]} actions={<Button icon={<Play size="1em" aria-hidden />}>Start run</Button>} />
87
+ <Stack direction="row" gap="4" wrap>
88
+ {/* filters, each with a label: Select, TextInput, Combobox */}
89
+ <DateRangePicker label="Started" value={range} onValueChange={setRange} />
90
+ </Stack>
91
+ <Table
92
+ aria-label="Runs"
93
+ columns={[
94
+ { key: 'run', header: 'Run', render: (r) => <>{r.startedAt}<Table.Secondary>{r.id}</Table.Secondary></> },
95
+ { key: 'status', header: 'Status', render: (r) => <StatusBadge status={r.status} /> },
96
+ { key: 'duration', header: 'Duration', align: 'right' },
97
+ { key: 'actions', header: 'Actions', align: 'right',
98
+ render: (r) => <TableAction aria-label="Open run" icon={<ExternalLink size="1em" aria-hidden />} onClick={() => open(r)} /> },
99
+ ]}
100
+ rows={runs}
101
+ getRowKey={(r) => r.id}
102
+ loading={isLoading}
103
+ empty="No runs yet"
104
+ />
105
+ <Pagination page={page} pageCount={pageCount} onPageChange={setPage} />
106
+ ```
107
+
108
+ - Status always goes through `StatusBadge`. IDs and codes go in `Table.Secondary` (mono).
109
+ - Use `loading` for skeleton rows, never a spinner over the table.
110
+ - Wide tables scroll horizontally inside themselves. Don't wrap `Table` in your own overflow container.
111
+ - `DateRangePicker` passes the chosen quick range as `{ preset }`, so a preset like "Past hour" can switch on a live mode. Build custom quick ranges with `lastDuration`, `today`, `yesterday`, `thisMonth` or `getDefaultPresets`.
112
+
113
+ ## 3. Dashboard
114
+
115
+ ```tsx
116
+ <PageHeader title="Overview" />
117
+ <StatsGrid>
118
+ <StatCard label="Objective achieved" value="64%" caption="7 of 11 judged" />
119
+ <StatCard label="Median duration" value="2m 12s" caption="Across loaded runs" />
120
+ </StatsGrid>
121
+ <Card heading="Progress">
122
+ <ProgressBar label="In progress" done={3} running={1} total={8} />
123
+ </Card>
124
+ <Card heading="Outcomes">
125
+ <MetricBar label="Achieved" value={83} tone="success" />
126
+ </Card>
127
+ ```
128
+
129
+ ## 4. Detail view
130
+
131
+ - Side detail without leaving the list: `Drawer` (right side), with `title`, `description` and `footer` actions.
132
+ - Grouped detail sections: `Tabs` with `count` for each section ("Conversation 13").
133
+ - Blocking confirmation: `Modal` with `footer` buttons. Put the destructive action in `variant="danger"`.
134
+
135
+ ## 5. Settings form
136
+
137
+ Build every form with **react-hook-form**: it owns values, dirty state and validation; library fields render them. This recipe is tested in the library's Storybook (`Recipes/React Hook Form`).
138
+
139
+ ```tsx
140
+ import { Controller, useForm } from 'react-hook-form'
141
+ import {
142
+ Fieldset,
143
+ NumberInput,
144
+ PageHeader,
145
+ SaveBar,
146
+ Select,
147
+ Switch,
148
+ TextInput,
149
+ } from '@15gifts/back-office-kit'
150
+
151
+ interface Settings {
152
+ greeting: string
153
+ strategy: string | null
154
+ results: number | null
155
+ outOfStock: boolean
156
+ }
157
+
158
+ export function RecommendationSettings({ settings, save }: Props) {
159
+ const { register, control, handleSubmit, reset, formState } = useForm<Settings>({
160
+ defaultValues: settings,
161
+ })
162
+ const { errors, dirtyFields, isSubmitting } = formState
163
+ // handleSubmit validates, then calls save. `void` because it returns a promise (lint rule).
164
+ const submit = () => void handleSubmit((values) => save(values))()
165
+
166
+ return (
167
+ <form
168
+ noValidate
169
+ onSubmit={(event) => {
170
+ event.preventDefault()
171
+ submit()
172
+ }}
173
+ >
174
+ <PageHeader title="Recommendation settings" />
175
+ <Fieldset legend="Matching" description="How products are picked for a shopper.">
176
+ <TextInput
177
+ label="Greeting"
178
+ required
179
+ error={errors.greeting?.message}
180
+ {...register('greeting', { required: 'Enter a greeting' })}
181
+ />
182
+ <Controller
183
+ name="strategy"
184
+ control={control}
185
+ render={({ field }) => (
186
+ <Select
187
+ label="Strategy"
188
+ options={[
189
+ { value: 'best', label: 'Best match' },
190
+ { value: 'cheapest', label: 'Cheapest' },
191
+ ]}
192
+ value={field.value}
193
+ onValueChange={field.onChange}
194
+ />
195
+ )}
196
+ />
197
+ <Controller
198
+ name="results"
199
+ control={control}
200
+ render={({ field }) => (
201
+ <NumberInput
202
+ label="Results to show"
203
+ min={1}
204
+ max={10}
205
+ value={field.value}
206
+ onValueChange={(value) => field.onChange(value)}
207
+ />
208
+ )}
209
+ />
210
+ <Controller
211
+ name="outOfStock"
212
+ control={control}
213
+ render={({ field }) => (
214
+ <Switch
215
+ label="Include out-of-stock products"
216
+ checked={field.value}
217
+ onCheckedChange={(checked) => field.onChange(checked)}
218
+ />
219
+ )}
220
+ />
221
+ </Fieldset>
222
+ <SaveBar
223
+ changes={Object.keys(dirtyFields).length}
224
+ onSave={submit}
225
+ onDiscard={() => reset()}
226
+ saving={isSubmitting}
227
+ />
228
+ </form>
229
+ )
230
+ }
231
+ ```
232
+
233
+ - Every input takes `label`, `description`, `error`, `required` and `disabled` directly. Don't wrap it in your own label.
234
+ - `register` works on TextInput, Textarea, DateTimeInput and ColorPicker (they forward `ref`, `name`, `onChange` and `onBlur`). Use `<Controller>` for the rest: `value`/`onValueChange` on Select, Combobox, Autocomplete, RadioCards, NumberInput, ToggleGroup and DateRangePicker, and `checked`/`onCheckedChange` on Switch and Checkbox.
235
+ - Show validation messages through each field's `error` prop (`errors.x?.message`). Use a `Alert` above the form only for errors that aren't about one field (e.g. the save request failed).
236
+ - Don't keep form values in `useState`, and don't add another form library.
237
+ - Required fields: put `required` on the field (it adds the asterisk, `aria-required` and browser validation). Required fields are always marked with `*`; optional fields have no mark. react-hook-form does the validation, so keep `required` on the fields (for the asterisk and `aria-required`), put the rule in `register`/`rules`, and add `noValidate` to the `<form>`.
238
+ - **Don't nest cards.** A top-level `Fieldset` is already a card, so don't put Fieldsets inside a `Card` (or Cards inside a Fieldset). A `Drawer` is not a card: Cards and Fieldsets inside it are fine.
239
+ - **Forms in a Drawer:** pass `onSubmit` to `Drawer`. It wraps the body and footer in one `<form>`, so a `type="submit"` footer button submits it: `<Drawer onSubmit={handleSubmit(save)} footer={<Button type="submit">Save</Button>}>`. Or put your own `<form id="edit-run">` in the body and give the footer button `form="edit-run"`.
240
+ - **Labelling from outside:** every input takes `label`; use it. When the label must live elsewhere (a table header, a sentence), pass `id` to the kit input, leave out `label`, and point a native `<label htmlFor={id}>` at it.
241
+ - **Layout wrappers:** `Stack` passes native `div` props through (`id`, `aria-*`, `data-*`, `style`, event handlers), so use it instead of a styled `div`.
242
+ - `ToggleGroup` suits 2–4 short mutually exclusive options (`size="sm"` in toolbars and filter rows). Use `Select` for longer lists, and `Combobox` when the list needs filtering.
243
+ - **Where does Save go?**
244
+ - `SaveBar`: settings pages with many fields, where edits accumulate and Save/Discard must stay reachable while scrolling. Show the change count.
245
+ - A primary `Button` in `PageHeader` `actions`: short pages where Save is the page's one main action and is always visible.
246
+ - Footer buttons: forms inside a `Modal` or `Drawer`.
247
+ - Use one of these per page, never both.
248
+ - Appearance settings: `ThemePicker` (it drives the app theme by itself), and a `ToggleGroup` of `sm`/`md`/`lg` over `useFontSize()` for text size.
249
+
250
+ ## 6. Conversation view
251
+
252
+ Show a shopper ↔ assistant conversation with `ChatTranscript`. Don't hand-roll bubbles.
253
+
254
+ ```tsx
255
+ import { Button, ChatTranscript, type ChatMessage } from '@15gifts/back-office-kit'
256
+ import { Info } from 'lucide-react'
257
+
258
+ const messages: ChatMessage[] = turns.map((turn) => ({
259
+ id: turn.id,
260
+ role: turn.speaker === 'shopper' ? 'user' : 'assistant', // or 'system' for events
261
+ content: turn.text, // any ReactNode: markdown, product cards, buttons
262
+ timestamp: formatTime(turn.at),
263
+ actions:
264
+ turn.speaker === 'assistant' ? (
265
+ <Button variant="ghost" size="sm" icon={<Info size="1em" aria-hidden />} onClick={() => openTurn(turn)}>
266
+ Turn details
267
+ </Button>
268
+ ) : undefined,
269
+ }))
270
+
271
+ <ChatTranscript
272
+ label="Conversation with Tech enthusiast"
273
+ messages={messages}
274
+ assistantName="Sales assistant"
275
+ typing={run.status === 'running'}
276
+ live={run.status === 'running'} // announce new messages only while it's live
277
+ labels={{ user: 'Shopper', assistant: 'Assistant' }}
278
+ empty="No messages yet"
279
+ />
280
+ ```
281
+
282
+ - Consecutive messages from the same speaker group automatically. Use `role: 'system'` for events like "Conversation started".
283
+ - For custom layouts (e.g. turns with per-turn panels), compose `ChatTranscript.Root`, `.Message`, `.Bubble`, `.Meta`, `.Divider` and `.Typing`.
284
+
285
+ ## Feedback and empty states
286
+
287
+ - Page-level messages: `Alert` (`tone` info, success, warning or danger). Danger and warning are announced.
288
+ - Inline empty lists: `EmptyLine`, `Table`'s `empty` prop, or `List`'s `emptyState`.
289
+ - Loading: `Skeleton` for content placeholders, `Loader` inside buttons and small regions, and `Button loading` while saving. Numeric `width`/`height`/`size` are px at the 16px base, converted to rem; prefer rem/em strings.
290
+ - Labels and filters: `Chip` for toggleable filters (`static` for a display-only chip showing a choice, `pressed` ticks it), `Tag` for small mono labels (`tone` for meaning), and `Badge` for neutral or tone counts (`mono` for IDs and versions).
291
+
292
+ ## App CSS next to the kit
293
+
294
+ The kit's CSS is in `@layer bok`, so unlayered app CSS wins. Keep app resets in a lower layer (`@layer reset, bok;` imported before the kit's CSS), and use the `--bok-*` colour and scale variables in your own CSS. Recipe: [migrate.md](migrate.md#keep-app-resets-below-the-kit).