@cube-dev/ui-kit 0.151.0 → 0.153.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (532) hide show
  1. package/README.md +17 -0
  2. package/dist/CHANGELOG.md +120 -0
  3. package/dist/README.md +17 -0
  4. package/dist/_internal/hooks/use-chained-callback.js +1 -1
  5. package/dist/_internal/hooks/use-debounced-value.js +1 -1
  6. package/dist/_internal/hooks/use-deprecation-warning.js +1 -1
  7. package/dist/_internal/hooks/use-event.js +1 -1
  8. package/dist/_internal/hooks/use-is-first-render.js +1 -1
  9. package/dist/_internal/hooks/use-sync-ref.js +1 -1
  10. package/dist/_internal/hooks/use-timer/timer.js +1 -1
  11. package/dist/_internal/hooks/use-timer/use-timer.js +1 -1
  12. package/dist/_internal/hooks/use-warn.js +1 -1
  13. package/dist/components/Block.js +1 -1
  14. package/dist/components/CollectionItem.js +1 -1
  15. package/dist/components/GlobalStyles.js +3 -2
  16. package/dist/components/GlobalStyles.js.map +1 -1
  17. package/dist/components/GridProvider.js +1 -1
  18. package/dist/components/HiddenInput.js +1 -1
  19. package/dist/components/Root.d.ts +16 -0
  20. package/dist/components/Root.js +7 -3
  21. package/dist/components/Root.js.map +1 -1
  22. package/dist/components/actions/Action/Action.js +1 -1
  23. package/dist/components/actions/Banner/Banner.js +1 -1
  24. package/dist/components/actions/Button/Button.d.ts +0 -1
  25. package/dist/components/actions/Button/Button.js +1 -1
  26. package/dist/components/actions/ButtonGroup/ButtonGroup.js +1 -1
  27. package/dist/components/actions/ButtonSplit/ButtonSplit.js +1 -1
  28. package/dist/components/actions/ButtonSplit/context.js +1 -1
  29. package/dist/components/actions/CommandMenu/CommandMenu.js +1 -1
  30. package/dist/components/actions/CommandMenu/styled.js +1 -1
  31. package/dist/components/actions/ItemAction/ItemAction.js +1 -1
  32. package/dist/components/actions/ItemActionContext.js +1 -1
  33. package/dist/components/actions/ItemButton/ItemButton.js +1 -1
  34. package/dist/components/actions/Link/Link.js +1 -1
  35. package/dist/components/actions/Menu/Menu.js +1 -1
  36. package/dist/components/actions/Menu/MenuItem.js +1 -1
  37. package/dist/components/actions/Menu/MenuSection.js +1 -1
  38. package/dist/components/actions/Menu/MenuTrigger.js +1 -1
  39. package/dist/components/actions/Menu/SubMenuTrigger.js +1 -1
  40. package/dist/components/actions/Menu/SubmenuTriggerContext.js +1 -1
  41. package/dist/components/actions/Menu/context.js +1 -1
  42. package/dist/components/actions/Menu/styled.js +1 -1
  43. package/dist/components/actions/index.js +1 -1
  44. package/dist/components/actions/use-action.js +1 -1
  45. package/dist/components/actions/use-anchored-menu.js +1 -1
  46. package/dist/components/actions/use-context-menu.js +1 -1
  47. package/dist/components/content/ActiveZone/ActiveZone.js +1 -1
  48. package/dist/components/content/Alert/Alert.js +1 -1
  49. package/dist/components/content/Alert/use-alert.js +1 -1
  50. package/dist/components/content/Avatar/Avatar.js +1 -1
  51. package/dist/components/content/Badge/Badge.js +1 -1
  52. package/dist/components/content/Card/Card.js +1 -1
  53. package/dist/components/content/Content.js +1 -1
  54. package/dist/components/content/CopyPasteBlock/CopyPasteBlock.js +1 -1
  55. package/dist/components/content/CopySnippet/CopySnippet.js +1 -1
  56. package/dist/components/content/Disclosure/Disclosure.js +1 -1
  57. package/dist/components/content/Divider.js +1 -1
  58. package/dist/components/content/Footer.js +1 -1
  59. package/dist/components/content/Header.js +1 -1
  60. package/dist/components/content/HotKeys/HotKeys.js +1 -1
  61. package/dist/components/content/InfoBadge/InfoBadge.js +1 -1
  62. package/dist/components/content/InlineInput/InlineInput.js +1 -1
  63. package/dist/components/content/Item/Item.js +1 -1
  64. package/dist/components/content/ItemBadge/ItemBadge.js +1 -1
  65. package/dist/components/content/ItemCard/ItemCard.js +1 -1
  66. package/dist/components/content/Layout/GridLayout.js +1 -1
  67. package/dist/components/content/Layout/Layout.js +1 -1
  68. package/dist/components/content/Layout/LayoutBlock.js +1 -1
  69. package/dist/components/content/Layout/LayoutCenter.js +1 -1
  70. package/dist/components/content/Layout/LayoutContainer.js +1 -1
  71. package/dist/components/content/Layout/LayoutContent.js +1 -1
  72. package/dist/components/content/Layout/LayoutContext.js +1 -1
  73. package/dist/components/content/Layout/LayoutFlex.js +1 -1
  74. package/dist/components/content/Layout/LayoutFooter.js +1 -1
  75. package/dist/components/content/Layout/LayoutGrid.js +1 -1
  76. package/dist/components/content/Layout/LayoutHeader.js +1 -1
  77. package/dist/components/content/Layout/LayoutPane.js +1 -1
  78. package/dist/components/content/Layout/LayoutPanel.js +1 -1
  79. package/dist/components/content/Layout/LayoutPanelHeader.js +1 -1
  80. package/dist/components/content/Layout/LayoutToolbar.js +1 -1
  81. package/dist/components/content/Layout/hooks/useTinyScrollbar.js +1 -1
  82. package/dist/components/content/Layout/index.js +1 -1
  83. package/dist/components/content/Layout/utils.js +1 -1
  84. package/dist/components/content/Paragraph.js +1 -1
  85. package/dist/components/content/Placeholder/Placeholder.js +1 -1
  86. package/dist/components/content/PrismCode/PrismCode.js +1 -1
  87. package/dist/components/content/PrismCode/prismSetup.js +1 -1
  88. package/dist/components/content/PrismDiffCode/PrismDiffCode.js +1 -1
  89. package/dist/components/content/Result/Result.js +1 -1
  90. package/dist/components/content/Skeleton/Skeleton.js +1 -1
  91. package/dist/components/content/Tag/Tag.js +1 -1
  92. package/dist/components/content/Text.d.ts +14 -14
  93. package/dist/components/content/Text.js +1 -1
  94. package/dist/components/content/TextItem/TextItem.js +1 -1
  95. package/dist/components/content/Title.js +1 -1
  96. package/dist/components/content/Tree/Tree.js +1 -1
  97. package/dist/components/content/Tree/TreeNode.js +1 -1
  98. package/dist/components/content/Tree/TreeNode.js.map +1 -1
  99. package/dist/components/content/Tree/styled.js +1 -1
  100. package/dist/components/content/Tree/tree-index.js +1 -1
  101. package/dist/components/content/Tree/use-checkbox-tree.js +1 -1
  102. package/dist/components/content/Tree/use-load-data.js +1 -1
  103. package/dist/components/content/highlightText.js +1 -1
  104. package/dist/components/content/use-auto-tooltip.js +1 -1
  105. package/dist/components/fields/Checkbox/Checkbox.d.ts +2 -2
  106. package/dist/components/fields/Checkbox/Checkbox.js +2 -2
  107. package/dist/components/fields/Checkbox/Checkbox.js.map +1 -1
  108. package/dist/components/fields/Checkbox/CheckboxGroup.js +1 -1
  109. package/dist/components/fields/Checkbox/context.js +1 -1
  110. package/dist/components/fields/ComboBox/ComboBox.js +1 -1
  111. package/dist/components/fields/CommandTextArea/CommandTextArea.js +1 -1
  112. package/dist/components/fields/CommandTextArea/caretPosition.js +1 -1
  113. package/dist/components/fields/CommandTextArea/useCaretAnchor.js +1 -1
  114. package/dist/components/fields/DatePicker/DateInput.js +1 -1
  115. package/dist/components/fields/DatePicker/DateInputBase.js +1 -1
  116. package/dist/components/fields/DatePicker/DatePicker.js +1 -1
  117. package/dist/components/fields/DatePicker/DatePickerButton.js +1 -1
  118. package/dist/components/fields/DatePicker/DatePickerElement.js +1 -1
  119. package/dist/components/fields/DatePicker/DatePickerInput.js +1 -1
  120. package/dist/components/fields/DatePicker/DatePickerSegment.js +1 -1
  121. package/dist/components/fields/DatePicker/DateRangePicker.js +1 -1
  122. package/dist/components/fields/DatePicker/DateRangeSeparatedPicker.js +1 -1
  123. package/dist/components/fields/DatePicker/TimeInput.js +1 -1
  124. package/dist/components/fields/DatePicker/parseDate.js +1 -1
  125. package/dist/components/fields/DatePicker/props.js +1 -1
  126. package/dist/components/fields/DatePicker/utils.js +1 -1
  127. package/dist/components/fields/FileInput/FileInput.js +1 -1
  128. package/dist/components/fields/FilterListBox/FilterListBox.js +1 -1
  129. package/dist/components/fields/FilterPicker/FilterPicker.js +1 -1
  130. package/dist/components/fields/Input/Input.js +1 -1
  131. package/dist/components/fields/ListBox/DraggableListBox.js +1 -1
  132. package/dist/components/fields/ListBox/ListBox.js +1 -1
  133. package/dist/components/fields/ListBoxPopover/ListBoxPopover.js +1 -1
  134. package/dist/components/fields/ListBoxPopover/index.d.ts +0 -1
  135. package/dist/components/fields/ListBoxPopover/listNavigation.js +1 -1
  136. package/dist/components/fields/ListBoxPopover/useCompositeFocus.js +1 -1
  137. package/dist/components/fields/NumberInput/NumberInput.js +1 -1
  138. package/dist/components/fields/NumberInput/StepButton.js +1 -1
  139. package/dist/components/fields/PasswordInput/PasswordInput.js +1 -1
  140. package/dist/components/fields/Picker/Picker.js +1 -1
  141. package/dist/components/fields/RadioGroup/Radio.js +2 -2
  142. package/dist/components/fields/RadioGroup/Radio.js.map +1 -1
  143. package/dist/components/fields/RadioGroup/RadioGroup.js +1 -1
  144. package/dist/components/fields/RadioGroup/context.js +1 -1
  145. package/dist/components/fields/SearchComboBox/SearchComboBox.js +1 -1
  146. package/dist/components/fields/SearchInput/SearchInput.js +1 -1
  147. package/dist/components/fields/Select/Select.js +1 -1
  148. package/dist/components/fields/Slider/Gradation.js +1 -1
  149. package/dist/components/fields/Slider/HueSlider.js +1 -1
  150. package/dist/components/fields/Slider/RangeSlider.js +1 -1
  151. package/dist/components/fields/Slider/Slider.js +1 -1
  152. package/dist/components/fields/Slider/SliderBase.js +1 -1
  153. package/dist/components/fields/Slider/SliderThumb.js +1 -1
  154. package/dist/components/fields/Slider/SliderTrack.js +1 -1
  155. package/dist/components/fields/Slider/elements.js +1 -1
  156. package/dist/components/fields/Slider/index.js +1 -1
  157. package/dist/components/fields/Switch/Switch.d.ts +2 -2
  158. package/dist/components/fields/Switch/Switch.js +1 -1
  159. package/dist/components/fields/Switch/Switch.js.map +1 -1
  160. package/dist/components/fields/TextArea/TextArea.js +1 -1
  161. package/dist/components/fields/TextInput/TextInput.js +1 -1
  162. package/dist/components/fields/TextInput/TextInputBase.js +1 -1
  163. package/dist/components/fields/TextInputMapper/TextInputMapper.js +1 -1
  164. package/dist/components/form/FieldWrapper/FieldWrapper.js +1 -1
  165. package/dist/components/form/Form/Field.js +1 -1
  166. package/dist/components/form/Form/Form.js +1 -1
  167. package/dist/components/form/Form/ResetButton/ResetButton.js +1 -1
  168. package/dist/components/form/Form/SubmitButton/SubmitButton.js +1 -1
  169. package/dist/components/form/Form/SubmitError.js +1 -1
  170. package/dist/components/form/Form/index.js +1 -1
  171. package/dist/components/form/Form/use-field/use-field-props.js +1 -1
  172. package/dist/components/form/Form/use-field/use-field.js +1 -1
  173. package/dist/components/form/Form/use-form.js +1 -1
  174. package/dist/components/form/Form/validation.js +1 -1
  175. package/dist/components/form/Label.js +1 -1
  176. package/dist/components/form/validation/ValidationIndicator.js +1 -1
  177. package/dist/components/form/validation/resolve-validation-props.js +1 -1
  178. package/dist/components/form/validation/use-validation-props.js +1 -1
  179. package/dist/components/form/wrapper.js +1 -1
  180. package/dist/components/helpers/DisplayTransition/DisplayTransition.js +1 -1
  181. package/dist/components/helpers/IconSwitch/IconSwitch.js +1 -1
  182. package/dist/components/layout/Board/Board.js +1 -1
  183. package/dist/components/layout/Board/BoardProvider.js +1 -1
  184. package/dist/components/layout/Board/BoardResponsive.js +1 -1
  185. package/dist/components/layout/Board/Widget.js +1 -1
  186. package/dist/components/layout/Board/WidgetHost.js +1 -1
  187. package/dist/components/layout/Board/board-context.js +1 -1
  188. package/dist/components/layout/Board/board-store.js +1 -1
  189. package/dist/components/layout/Board/grid-core/calculate.js +1 -1
  190. package/dist/components/layout/Board/grid-core/collision.js +1 -1
  191. package/dist/components/layout/Board/grid-core/compactors.js +1 -1
  192. package/dist/components/layout/Board/grid-core/constraints.js +1 -1
  193. package/dist/components/layout/Board/grid-core/layout.js +1 -1
  194. package/dist/components/layout/Board/grid-core/sort.js +1 -1
  195. package/dist/components/layout/Board/index.js +1 -1
  196. package/dist/components/layout/Board/responsive-utils.js +1 -1
  197. package/dist/components/layout/Board/use-board-layout.js +1 -1
  198. package/dist/components/layout/Board/use-board-registry.js +1 -1
  199. package/dist/components/layout/Flex.js +1 -1
  200. package/dist/components/layout/Flow.js +1 -1
  201. package/dist/components/layout/Grid.js +1 -1
  202. package/dist/components/layout/Panel.js +1 -1
  203. package/dist/components/layout/Prefix.js +1 -1
  204. package/dist/components/layout/ResizablePanel.js +1 -1
  205. package/dist/components/layout/Space.js +1 -1
  206. package/dist/components/layout/Suffix.js +1 -1
  207. package/dist/components/navigation/Tabs/DraggableTabList.js +1 -1
  208. package/dist/components/navigation/Tabs/TabButton.js +1 -1
  209. package/dist/components/navigation/Tabs/TabDropIndicator.js +1 -1
  210. package/dist/components/navigation/Tabs/TabPanel.js +1 -1
  211. package/dist/components/navigation/Tabs/TabPicker.js +1 -1
  212. package/dist/components/navigation/Tabs/Tabs.js +1 -1
  213. package/dist/components/navigation/Tabs/TabsAction.js +1 -1
  214. package/dist/components/navigation/Tabs/TabsContext.js +1 -1
  215. package/dist/components/navigation/Tabs/popover-placement.js +1 -1
  216. package/dist/components/navigation/Tabs/styled.js +1 -1
  217. package/dist/components/navigation/Tabs/types.js +1 -1
  218. package/dist/components/navigation/Tabs/use-tab-editing.js +1 -1
  219. package/dist/components/navigation/Tabs/use-tab-indicator.js +1 -1
  220. package/dist/components/organisms/FileTabs/FileTabs.js +1 -1
  221. package/dist/components/organisms/StatsCard/StatsCard.js +1 -1
  222. package/dist/components/other/Calendar/Calendar.js +1 -1
  223. package/dist/components/other/Calendar/CalendarCell.js +1 -1
  224. package/dist/components/other/Calendar/CalendarGrid.js +1 -1
  225. package/dist/components/other/Calendar/RangeCalendar.js +1 -1
  226. package/dist/components/other/CubeLogo/CubeLogo.d.ts +10 -3
  227. package/dist/components/other/CubeLogo/CubeLogo.js +31 -4
  228. package/dist/components/other/CubeLogo/CubeLogo.js.map +1 -1
  229. package/dist/components/overlays/AlertDialog/AlertDialog.js +1 -1
  230. package/dist/components/overlays/AlertDialog/AlertDialogApiProvider.js +1 -1
  231. package/dist/components/overlays/AlertDialog/AlertDialogZone.js +1 -1
  232. package/dist/components/overlays/Dialog/Dialog.js +1 -1
  233. package/dist/components/overlays/Dialog/DialogContainer.js +1 -1
  234. package/dist/components/overlays/Dialog/DialogForm.js +1 -1
  235. package/dist/components/overlays/Dialog/DialogTrigger.js +1 -1
  236. package/dist/components/overlays/Dialog/context.js +1 -1
  237. package/dist/components/overlays/Dialog/use-dialog-container.js +1 -1
  238. package/dist/components/overlays/Modal/Modal.d.ts +1 -2
  239. package/dist/components/overlays/Modal/Modal.js +1 -1
  240. package/dist/components/overlays/Modal/OpenTransitionContext.js +1 -1
  241. package/dist/components/overlays/Modal/Overlay.d.ts +0 -1
  242. package/dist/components/overlays/Modal/Overlay.js +1 -1
  243. package/dist/components/overlays/Modal/Popover.js +1 -1
  244. package/dist/components/overlays/Modal/Tray.js +1 -1
  245. package/dist/components/overlays/Modal/Underlay.js +1 -1
  246. package/dist/components/overlays/Modal/types.d.ts +0 -1
  247. package/dist/components/overlays/Notifications/Notification.js +1 -1
  248. package/dist/components/overlays/Notifications/NotificationAction.js +1 -1
  249. package/dist/components/overlays/Notifications/NotificationCard.js +1 -1
  250. package/dist/components/overlays/Notifications/NotificationContext.d.ts +0 -2
  251. package/dist/components/overlays/Notifications/NotificationContext.js +1 -1
  252. package/dist/components/overlays/Notifications/NotificationItem.js +1 -1
  253. package/dist/components/overlays/Notifications/OverlayContainer.js +1 -1
  254. package/dist/components/overlays/Notifications/OverlayProvider.js +1 -1
  255. package/dist/components/overlays/Notifications/PersistentNotificationsList.js +1 -1
  256. package/dist/components/overlays/Notifications/dismissed-storage.js +1 -1
  257. package/dist/components/overlays/Notifications/format-relative-time.js +1 -1
  258. package/dist/components/overlays/Notifications/index.js +1 -1
  259. package/dist/components/overlays/Notifications/use-notification-state.js +1 -1
  260. package/dist/components/overlays/Notifications/use-notifications.js +1 -1
  261. package/dist/components/overlays/Notifications/use-overlay-timers.js +1 -1
  262. package/dist/components/overlays/Notifications/use-persistent-notifications.js +1 -1
  263. package/dist/components/overlays/Notifications/use-persistent-state.js +1 -1
  264. package/dist/components/overlays/Notifications/use-toast-state.js +1 -1
  265. package/dist/components/overlays/Toast/ToastItem.js +1 -1
  266. package/dist/components/overlays/Toast/index.js +1 -1
  267. package/dist/components/overlays/Toast/useProgressToast.js +1 -1
  268. package/dist/components/overlays/Toast/useToast.js +1 -1
  269. package/dist/components/overlays/Tooltip/Tooltip.js +1 -1
  270. package/dist/components/overlays/Tooltip/TooltipProvider.js +1 -1
  271. package/dist/components/overlays/Tooltip/TooltipTrigger.js +1 -1
  272. package/dist/components/overlays/Tooltip/context.js +1 -1
  273. package/dist/components/portal/Portal.js +1 -1
  274. package/dist/components/portal/PortalProvider.js +1 -1
  275. package/dist/components/portal/index.d.ts +0 -1
  276. package/dist/components/portal/usePortal.js +1 -1
  277. package/dist/components/shared/DraggableCollection.js +1 -1
  278. package/dist/components/shared/InvalidIcon.js +1 -1
  279. package/dist/components/shared/ValidIcon.js +1 -1
  280. package/dist/components/status/LoadingAnimation/LoadingAnimation.js +1 -1
  281. package/dist/components/status/Spin/Cube.js +1 -1
  282. package/dist/components/status/Spin/InternalSpinner.js +1 -1
  283. package/dist/components/status/Spin/Spin.js +1 -1
  284. package/dist/components/status/Spin/SpinsContainer.js +1 -1
  285. package/dist/data/item-themes.js +1 -1
  286. package/dist/data/themes.d.ts +5 -5
  287. package/dist/data/themes.js +6 -6
  288. package/dist/data/themes.js.map +1 -1
  289. package/dist/eslint-plugin/defaults.generated.d.ts +8 -0
  290. package/dist/eslint-plugin/defaults.generated.js +1561 -0
  291. package/dist/eslint-plugin/defaults.generated.js.map +1 -0
  292. package/dist/eslint-plugin/index.d.ts +75 -0
  293. package/dist/eslint-plugin/index.js +37 -0
  294. package/dist/eslint-plugin/index.js.map +1 -0
  295. package/dist/eslint-plugin/rules/no-redundant-default-prop.d.ts +43 -0
  296. package/dist/eslint-plugin/rules/no-redundant-default-prop.js +145 -0
  297. package/dist/eslint-plugin/rules/no-redundant-default-prop.js.map +1 -0
  298. package/dist/eslint-plugin/types.d.ts +68 -0
  299. package/dist/i18n/I18nProvider.js +1 -1
  300. package/dist/i18n/createFormatter.js +1 -1
  301. package/dist/i18n/index.js +1 -1
  302. package/dist/i18n/instance.js +1 -1
  303. package/dist/i18n/locales/de-DE/uikit.js +1 -1
  304. package/dist/i18n/locales/en-US/uikit.js +1 -1
  305. package/dist/i18n/locales/es-ES/uikit.js +1 -1
  306. package/dist/i18n/locales/es-MX/uikit.js +1 -1
  307. package/dist/i18n/locales/fr-FR/uikit.js +1 -1
  308. package/dist/i18n/locales/it-IT/uikit.js +1 -1
  309. package/dist/i18n/locales/ja-JP/uikit.js +1 -1
  310. package/dist/i18n/locales/nb-NO/uikit.js +1 -1
  311. package/dist/i18n/locales/pt-BR/uikit.js +1 -1
  312. package/dist/i18n/locales/pt-PT/uikit.js +1 -1
  313. package/dist/i18n/locales/sv-SE/uikit.js +1 -1
  314. package/dist/i18n/locales/vi-VN/uikit.js +1 -1
  315. package/dist/i18n/locales.js +1 -1
  316. package/dist/i18n/useFormatter.js +1 -1
  317. package/dist/i18n/useI18n.js +1 -1
  318. package/dist/icons/AdjustmentsHorizontalIcon.js +1 -1
  319. package/dist/icons/AdjustmentsIcon.js +1 -1
  320. package/dist/icons/AiIcon.js +1 -1
  321. package/dist/icons/AreaChartIcon.js +1 -1
  322. package/dist/icons/BackwardIcon.js +1 -1
  323. package/dist/icons/BarChartIcon.js +1 -1
  324. package/dist/icons/BellFilledIcon.js +1 -1
  325. package/dist/icons/BellIcon.js +1 -1
  326. package/dist/icons/BooleanIcon.js +1 -1
  327. package/dist/icons/CalendarEditIcon.js +1 -1
  328. package/dist/icons/CalendarIcon.js +1 -1
  329. package/dist/icons/CaretDownIcon.js +1 -1
  330. package/dist/icons/CaretUpIcon.js +1 -1
  331. package/dist/icons/ChartAreaStackedIcon.js +1 -1
  332. package/dist/icons/ChartAreaStackedPercentageIcon.js +1 -1
  333. package/dist/icons/ChartBarGroupedHorizontalIcon.js +1 -1
  334. package/dist/icons/ChartBarGroupedIcon.js +1 -1
  335. package/dist/icons/ChartBarHorizontalIcon.js +1 -1
  336. package/dist/icons/ChartBarLineIcon.js +1 -1
  337. package/dist/icons/ChartBarStackedHorizontalIcon.js +1 -1
  338. package/dist/icons/ChartBarStackedIcon.js +1 -1
  339. package/dist/icons/ChartBarStackedPercentageHorizontalIcon.js +1 -1
  340. package/dist/icons/ChartBarStackedPercentageIcon.js +1 -1
  341. package/dist/icons/ChartBoxPlot2Icon.js +1 -1
  342. package/dist/icons/ChartBoxPlotIcon.js +1 -1
  343. package/dist/icons/ChartBubbleIcon.js +1 -1
  344. package/dist/icons/ChartDonut2Icon.js +1 -1
  345. package/dist/icons/ChartFunnelIcon.js +1 -1
  346. package/dist/icons/ChartHeatmapIcon.js +1 -1
  347. package/dist/icons/ChartKPIIcon.js +1 -1
  348. package/dist/icons/ChartPie2Icon.js +1 -1
  349. package/dist/icons/ChartScatterIcon.js +1 -1
  350. package/dist/icons/CheckCircleFilledIcon.js +1 -1
  351. package/dist/icons/CheckCircleIcon.js +1 -1
  352. package/dist/icons/CheckIcon.js +1 -1
  353. package/dist/icons/CircleFilledIcon.js +1 -1
  354. package/dist/icons/ClearIcon.js +1 -1
  355. package/dist/icons/CloseCircleFilledIcon.js +1 -1
  356. package/dist/icons/CloseCircleIcon.js +1 -1
  357. package/dist/icons/CloseIcon.js +1 -1
  358. package/dist/icons/CodeIcon.js +1 -1
  359. package/dist/icons/ColumnTotalIcon.js +1 -1
  360. package/dist/icons/CopyIcon.js +1 -1
  361. package/dist/icons/CountIcon.js +1 -1
  362. package/dist/icons/CubeIcon.js +1 -1
  363. package/dist/icons/CubePauseIcon.js +1 -1
  364. package/dist/icons/CubePlayIcon.js +1 -1
  365. package/dist/icons/CurrencyDollarIcon.js +1 -1
  366. package/dist/icons/DangerIcon.js +1 -1
  367. package/dist/icons/DashboardIcon.js +1 -1
  368. package/dist/icons/DatabaseIcon.js +1 -1
  369. package/dist/icons/DecimalDecreaseIcon.js +1 -1
  370. package/dist/icons/DecimalIncreaseIcon.js +1 -1
  371. package/dist/icons/DirectionIcon.js +1 -1
  372. package/dist/icons/DonutIcon.js +1 -1
  373. package/dist/icons/DownIcon.js +1 -1
  374. package/dist/icons/EditIcon.js +1 -1
  375. package/dist/icons/ExclamationCircleFilledIcon.js +1 -1
  376. package/dist/icons/ExclamationCircleIcon.js +1 -1
  377. package/dist/icons/ExclamationIcon.js +1 -1
  378. package/dist/icons/EyeIcon.js +1 -1
  379. package/dist/icons/EyeInvisibleIcon.js +1 -1
  380. package/dist/icons/FilterIcon.js +1 -1
  381. package/dist/icons/FolderFilledIcon.js +1 -1
  382. package/dist/icons/FolderIcon.js +1 -1
  383. package/dist/icons/FolderOpenFilledIcon.js +1 -1
  384. package/dist/icons/FolderOpenIcon.js +1 -1
  385. package/dist/icons/ForwardIcon.js +1 -1
  386. package/dist/icons/GripVerticalIcon.js +1 -1
  387. package/dist/icons/HierarchyIcon.js +1 -1
  388. package/dist/icons/HierarchyOpenIcon.js +1 -1
  389. package/dist/icons/Icon.js +1 -1
  390. package/dist/icons/InfoCircleIcon.js +1 -1
  391. package/dist/icons/InfoIcon.js +1 -1
  392. package/dist/icons/KeyIcon.js +1 -1
  393. package/dist/icons/LeftIcon.js +1 -1
  394. package/dist/icons/LineChartIcon.js +1 -1
  395. package/dist/icons/LoadingIcon.js +1 -1
  396. package/dist/icons/LockFilledIcon.js +1 -1
  397. package/dist/icons/LockIcon.js +1 -1
  398. package/dist/icons/MoreIcon.js +1 -1
  399. package/dist/icons/NotAllowedIcon.js +1 -1
  400. package/dist/icons/Number123Icon.js +1 -1
  401. package/dist/icons/NumberIcon.js +1 -1
  402. package/dist/icons/PauseCircleFilledIcon.js +1 -1
  403. package/dist/icons/PauseCircleIcon.js +1 -1
  404. package/dist/icons/PauseIcon.js +1 -1
  405. package/dist/icons/PercentageIcon.js +1 -1
  406. package/dist/icons/PieChartIcon.js +1 -1
  407. package/dist/icons/PlayCircleIcon.js +1 -1
  408. package/dist/icons/PlayIcon.js +1 -1
  409. package/dist/icons/PlusIcon.js +1 -1
  410. package/dist/icons/ProgressBarIcon.js +1 -1
  411. package/dist/icons/ReloadIcon.js +1 -1
  412. package/dist/icons/ReportIcon.js +1 -1
  413. package/dist/icons/ReturnIcon.js +1 -1
  414. package/dist/icons/RightIcon.js +1 -1
  415. package/dist/icons/RowTotalsIcon.js +1 -1
  416. package/dist/icons/SchemeIcon.js +1 -1
  417. package/dist/icons/SearchIcon.js +1 -1
  418. package/dist/icons/SemanticQueryIcon.js +1 -1
  419. package/dist/icons/SettingsIcon.js +1 -1
  420. package/dist/icons/ShieldFilledIcon.js +1 -1
  421. package/dist/icons/ShieldIcon.js +1 -1
  422. package/dist/icons/SlashIcon.js +1 -1
  423. package/dist/icons/SparklesIcon.js +1 -1
  424. package/dist/icons/SqlIcon.js +1 -1
  425. package/dist/icons/StatsIcon.js +1 -1
  426. package/dist/icons/StopIcon.js +1 -1
  427. package/dist/icons/StringIcon.js +1 -1
  428. package/dist/icons/SubtotalsIcon.js +1 -1
  429. package/dist/icons/SwitchIcon.js +1 -1
  430. package/dist/icons/TableIcon.js +1 -1
  431. package/dist/icons/ThumbsDownIcon.js +1 -1
  432. package/dist/icons/ThumbsUpIcon.js +1 -1
  433. package/dist/icons/ThunderboltCrossedIcon.js +1 -1
  434. package/dist/icons/ThunderboltFilledIcon.js +1 -1
  435. package/dist/icons/ThunderboltIcon.js +1 -1
  436. package/dist/icons/TimeIcon.js +1 -1
  437. package/dist/icons/TrashIcon.js +1 -1
  438. package/dist/icons/UnlockIcon.js +1 -1
  439. package/dist/icons/UpIcon.js +1 -1
  440. package/dist/icons/UserGroupIcon.js +1 -1
  441. package/dist/icons/UserIcon.js +1 -1
  442. package/dist/icons/UserLockIcon.js +1 -1
  443. package/dist/icons/ViewIcon.js +1 -1
  444. package/dist/icons/WarningFilledIcon.js +1 -1
  445. package/dist/icons/WarningIcon.js +1 -1
  446. package/dist/icons/wrap-icon.js +1 -1
  447. package/dist/index.d.ts +6 -5
  448. package/dist/index.js +6 -5
  449. package/dist/index.js.map +1 -1
  450. package/dist/provider.js +1 -1
  451. package/dist/providers/TrackingProvider.js +1 -1
  452. package/dist/providers/navigationAdapter.default.js +1 -1
  453. package/dist/shared/form.d.ts +27 -1
  454. package/dist/shared/index.d.ts +1 -1
  455. package/dist/tokens/base.js +1 -1
  456. package/dist/tokens/colors.d.ts +41 -2
  457. package/dist/tokens/colors.js +77 -9
  458. package/dist/tokens/colors.js.map +1 -1
  459. package/dist/tokens/index.d.ts +3 -2
  460. package/dist/tokens/index.js +23 -16
  461. package/dist/tokens/index.js.map +1 -1
  462. package/dist/tokens/layout.js +1 -1
  463. package/dist/tokens/lazy-styles.js +10 -6
  464. package/dist/tokens/lazy-styles.js.map +1 -1
  465. package/dist/tokens/palette-config.d.ts +222 -0
  466. package/dist/tokens/palette-config.js +309 -0
  467. package/dist/tokens/palette-config.js.map +1 -0
  468. package/dist/tokens/palette.d.ts +45 -5
  469. package/dist/tokens/palette.js +578 -405
  470. package/dist/tokens/palette.js.map +1 -1
  471. package/dist/tokens/shadows.js +1 -1
  472. package/dist/tokens/sizes.js +1 -1
  473. package/dist/tokens/spacing.js +1 -1
  474. package/dist/tokens/typography.js +1 -1
  475. package/dist/utils/ResizeSensor.js +1 -1
  476. package/dist/utils/is-dev-env.js +1 -1
  477. package/dist/utils/modules.js +1 -1
  478. package/dist/utils/promise.js +1 -1
  479. package/dist/utils/raf.js +1 -1
  480. package/dist/utils/random.js +1 -1
  481. package/dist/utils/range.js +1 -1
  482. package/dist/utils/react/RenderCache.js +1 -1
  483. package/dist/utils/react/Slots.js +1 -1
  484. package/dist/utils/react/chain.js +1 -1
  485. package/dist/utils/react/forwardRefWithGenerics.js +1 -1
  486. package/dist/utils/react/index.js +1 -1
  487. package/dist/utils/react/interactions.js +1 -1
  488. package/dist/utils/react/isTextOnly.js +1 -1
  489. package/dist/utils/react/mapProps.js +1 -1
  490. package/dist/utils/react/mergeProps.js +1 -1
  491. package/dist/utils/react/nullableValue.js +1 -1
  492. package/dist/utils/react/resolveIcon.js +1 -1
  493. package/dist/utils/react/sharedStore.js +1 -1
  494. package/dist/utils/react/useCombinedRefs.js +1 -1
  495. package/dist/utils/react/useControlledFocusVisible.js +1 -1
  496. package/dist/utils/react/useEventBus.js +1 -1
  497. package/dist/utils/react/useId.js +1 -1
  498. package/dist/utils/react/useIsDarwin.js +1 -1
  499. package/dist/utils/react/useKeySymbols.js +1 -1
  500. package/dist/utils/react/useLayoutEffect.js +1 -1
  501. package/dist/utils/react/useLocalStorage.js +1 -1
  502. package/dist/utils/react/useMergeStyles.js +1 -1
  503. package/dist/utils/react/usePopoverSync.js +1 -1
  504. package/dist/utils/react/useQaProps.js +1 -1
  505. package/dist/utils/react/useViewportSize.js +1 -1
  506. package/dist/utils/react/wrapNodeIfPlain.js +1 -1
  507. package/dist/utils/selection.js +1 -1
  508. package/dist/utils/styles.js +1 -1
  509. package/dist/utils/tree.js +1 -1
  510. package/dist/utils/warnings.js +1 -1
  511. package/dist/version.js +3 -3
  512. package/docs/Colors.md +4 -0
  513. package/docs/Theming.md +375 -0
  514. package/docs/Usage.md +30 -3
  515. package/docs/components/Root.md +1 -0
  516. package/docs/components/fields/DatePicker.md +1 -1
  517. package/docs/components/fields/RadioGroup.md +1 -1
  518. package/docs/components/fields/Switch.md +1 -1
  519. package/docs/components/navigation/Tabs.md +1 -1
  520. package/docs/components/other/CubeLogo.md +27 -1
  521. package/docs/components/overlays/Dialog.md +1 -1
  522. package/docs/components/overlays/DialogContainer.md +1 -1
  523. package/docs/glaze/api.md +156 -8
  524. package/docs/glaze/methodology.md +21 -1
  525. package/docs/glaze/okhst.md +13 -0
  526. package/docs/tasty/README.md +1 -0
  527. package/docs/tasty/ai-agents.md +206 -0
  528. package/docs/tasty/injector.md +15 -0
  529. package/docs/tasty/react-api.md +21 -2
  530. package/package.json +9 -3
  531. package/dist/components/fields/ListBoxPopover/useCompositeFocus.d.ts +0 -2
  532. package/dist/components/portal/PortalProvider.d.ts +0 -2
package/dist/tokens/palette-config.d.ts ADDED
@@ -0,0 +1,222 @@
1
+
2
+ //#region src/tokens/palette-config.d.ts
3
+ /** Hue / saturation seed override for one colored theme. */
4
+ interface PaletteThemeSeed {
5
+ /** Hue in degrees (0–360). */
6
+ hue?: number;
7
+ /** Saturation (0–100). Defaults to the palette-level `saturation`. */
8
+ saturation?: number;
9
+ }
10
+ /**
11
+ * The `code-*` syntax family takes a saturation and nothing else.
12
+ *
13
+ * Its hues are absolute literals by design, so syntax colors never rotate with the
14
+ * brand — strings would collide with numbers the moment the brand went green. And
15
+ * unlike every other theme, its saturation does **not** inherit the palette-level
16
+ * one: the code palette is calibrated once and stays there, so re-seeding the app
17
+ * cannot quietly wash out a code block.
18
+ */
19
+ interface PaletteCodeSeed {
20
+ /** Saturation (0–100). Defaults to {@link DEFAULT_SATURATION}, not to `saturation`. */
21
+ saturation?: number;
22
+ }
23
+ /** Names of the themes whose seeds can be overridden individually. */
24
+ type PaletteThemeName = 'success' | 'danger' | 'warning' | 'note' | 'code';
25
+ /**
26
+ * Palette tuning. Every field is optional; omitted fields keep their default,
27
+ * and per-theme fields left unset inherit the palette-level value.
28
+ */
29
+ interface PaletteConfig {
30
+ /**
31
+ * Accent hue in degrees (0–360) — the brand.
32
+ *
33
+ * Drives the `accent-*` family on every theme, `primary` / `purple` / `special`,
34
+ * and the brand-tinted odds and ends (`focus`, the loading faces, the disabled
35
+ * chip). Also the default for {@link PaletteConfig.baseHue}.
36
+ */
37
+ hue?: number;
38
+ /**
39
+ * Hue of the **base** zone in degrees (0–360): the neutral chrome — `surface`
40
+ * and its ladder, the `surface-text*` ramp, `border`, `placeholder`. Defaults to
41
+ * `hue`, so the chrome carries a faint tint of the brand unless you say otherwise.
42
+ *
43
+ * Splitting it lets the chrome sit on a different hue from the accent — a warm
44
+ * grey UI with a cool blue brand, say. Only the `default` theme is affected: a
45
+ * colored theme's tinted `surface` deliberately follows *its own* hue, because a
46
+ * danger banner should read as red.
47
+ */
48
+ baseHue?: number;
49
+ /**
50
+ * Seed saturation (0–100), and the fallback for every theme that does not set
51
+ * its own.
52
+ *
53
+ * One scale for the whole theme, by design. Every color's own `saturation` is a
54
+ * 0–1 factor of this seed — `surface` at 0.12, `border` at 0.175, the text ramp
55
+ * at 0.2, the accent family at ~1.0 — so moving it rescales the palette while
56
+ * keeping those proportions. Unlike hue, which is configured separately for the
57
+ * brand and for each status theme, saturation is deliberately not split: the
58
+ * ratio between a subtle surface tint and a saturated accent is part of the
59
+ * design.
60
+ */
61
+ saturation?: number;
62
+ /**
63
+ * Global. Widens the usable chroma range by relaxing the sRGB-safe limit,
64
+ * producing a softer, more even palette across hues. Glaze treats `pastel` as
65
+ * instance-level, so it is threaded into every theme.
66
+ */
67
+ pastel?: boolean;
68
+ /**
69
+ * Global. `'auto'` (the default) keeps the two-tier model: normal colors plus
70
+ * a separate high-contrast tier driven by `<html data-contrast="high">` /
71
+ * `prefers-contrast: more`.
72
+ *
73
+ * A number (0–100) replaces that switch with a slider — and, because a manual
74
+ * level already carries the contrast preference, **drops the high-contrast
75
+ * tier entirely**. `0` reproduces the normal output and `100` the
76
+ * high-contrast output, bit for bit.
77
+ */
78
+ contrastLevel?: number | 'auto';
79
+ /** Per-theme seed overrides. */
80
+ themes?: {
81
+ success?: PaletteThemeSeed;
82
+ danger?: PaletteThemeSeed;
83
+ warning?: PaletteThemeSeed;
84
+ note?: PaletteThemeSeed;
85
+ code?: PaletteCodeSeed;
86
+ };
87
+ }
88
+ /** {@link PaletteConfig} with every field resolved to a concrete value. */
89
+ interface ResolvedPaletteConfig {
90
+ hue: number;
91
+ baseHue: number;
92
+ saturation: number;
93
+ pastel: boolean;
94
+ contrastLevel: number | 'auto';
95
+ themes: {
96
+ success: {
97
+ hue: number;
98
+ saturation: number;
99
+ };
100
+ danger: {
101
+ hue: number;
102
+ saturation: number;
103
+ };
104
+ warning: {
105
+ hue: number;
106
+ saturation: number;
107
+ };
108
+ note: {
109
+ hue: number;
110
+ saturation: number;
111
+ };
112
+ code: {
113
+ saturation: number;
114
+ };
115
+ };
116
+ }
117
+ /**
118
+ * The palette as it ships, with no tuning applied. Frozen — it is the baseline
119
+ * every resolution falls back to, so a stray write to it would move the defaults
120
+ * for the whole process.
121
+ */
122
+ declare const DEFAULT_PALETTE_CONFIG: ResolvedPaletteConfig;
123
+ /**
124
+ * Set the palette config.
125
+ *
126
+ * **Replaces**, like `useState` — the config you pass *is* the config, resolved
127
+ * against the shipped defaults. Nothing accumulates, so a field you leave out is a
128
+ * field you do not have: dropping a customization means dropping it from the
129
+ * object, and re-applying the same object twice is the same as applying it once.
130
+ *
131
+ * ```ts
132
+ * setPaletteConfig({ hue: 200, baseHue: 60 });
133
+ * setPaletteConfig({ hue: 200 }); // baseHue is gone — back to inheriting `hue`
134
+ * ```
135
+ *
136
+ * To adjust one field of the config already in place — a slider in a settings UI —
137
+ * pass an updater. It receives the config as written, sparse, so spreading it
138
+ * preserves which fields are pinned and which still inherit:
139
+ *
140
+ * ```ts
141
+ * setPaletteConfig((config) => ({ ...config, hue: 200 }));
142
+ * ```
143
+ *
144
+ * The palette is rebuilt lazily on the next token read, and any mounted `<Root>`
145
+ * re-injects the token block — no component re-render is involved, because every
146
+ * color in the kit resolves through a CSS custom property.
147
+ */
148
+ declare function setPaletteConfig(config: PaletteConfig | ((previous: PaletteConfig) => PaletteConfig)): void;
149
+ /**
150
+ * Drop all tuning and restore the palette the kit ships with. Identical to
151
+ * `setPaletteConfig({})`; it exists to be readable at a call site.
152
+ */
153
+ declare function resetPaletteConfig(): void;
154
+ /**
155
+ * Force every token to re-resolve without changing the palette config.
156
+ *
157
+ * Only needed if you drive Glaze directly — `glaze.configure({ darkTone })` and
158
+ * the like. Glaze invalidates its own caches, but the kit's token maps are
159
+ * memoized against *this* module's version, so they need telling. Calling it
160
+ * before the first paint is unnecessary; nothing has been resolved yet.
161
+ */
162
+ declare function invalidatePaletteTokens(): void;
163
+ /** The current config, with every field resolved to a concrete value. */
164
+ declare function getPaletteConfig(): ResolvedPaletteConfig;
165
+ /**
166
+ * The config **as set**, sparse — omitted fields are the ones still inheriting.
167
+ *
168
+ * {@link getPaletteConfig} resolves everything to concrete values, which loses the
169
+ * distinction between "explicitly 80" and "80 because it follows the brand". A
170
+ * settings UI needs that distinction to show an inherited value as inherited, and
171
+ * to offer a way back:
172
+ *
173
+ * ```ts
174
+ * const pinned = getPaletteConfigInput().baseHue !== undefined;
175
+ *
176
+ * // Re-link it to the brand by dropping the field.
177
+ * setPaletteConfig(({ baseHue, ...config }) => config);
178
+ * ```
179
+ *
180
+ * It is also the value handed to a {@link setPaletteConfig} updater.
181
+ */
182
+ declare function getPaletteConfigInput(): PaletteConfig;
183
+ /**
184
+ * Resolve a patch **over** the current config, without applying it.
185
+ *
186
+ * This one layers, unlike {@link setPaletteConfig}: a preview wants "the theme in
187
+ * use, but in dark", so the fields it does not mention have to come from the live
188
+ * config rather than from the defaults. The store is not touched and no listener
189
+ * fires.
190
+ */
191
+ declare function resolvePaletteConfig(config?: PaletteConfig): ResolvedPaletteConfig;
192
+ /** Subscribe to palette config changes. Returns an unsubscribe function. */
193
+ declare function subscribePaletteConfig(listener: () => void): () => void;
194
+ /**
195
+ * Re-render on palette config changes. Returns the version, not the config, so
196
+ * the snapshot is a primitive and React never warns about an uncached snapshot.
197
+ */
198
+ declare function usePaletteVersion(): number;
199
+ /**
200
+ * Read and tune the palette from React, `useState`-style — including the part
201
+ * where the setter *replaces*. A control that changes one field wants the updater
202
+ * form, or it will drop every other field:
203
+ *
204
+ * ```tsx
205
+ * const [palette, setPalette] = usePaletteConfig();
206
+ *
207
+ * <HueSlider
208
+ * value={palette.hue}
209
+ * onChange={(hue) => setPalette((config) => ({ ...config, hue }))}
210
+ * />
211
+ * ```
212
+ *
213
+ * The first element is the *resolved* config, so `palette.hue` is always a number.
214
+ * The updater's argument is the sparse one — see {@link getPaletteConfigInput}.
215
+ *
216
+ * The config is global process state, so every consumer of this hook — and every
217
+ * mounted `<Root>` — sees the same palette.
218
+ */
219
+ declare function usePaletteConfig(): readonly [ResolvedPaletteConfig, typeof setPaletteConfig];
220
+ //#endregion
221
+ export { DEFAULT_PALETTE_CONFIG, PaletteCodeSeed, PaletteConfig, PaletteThemeName, PaletteThemeSeed, ResolvedPaletteConfig, getPaletteConfig, getPaletteConfigInput, invalidatePaletteTokens, resetPaletteConfig, resolvePaletteConfig, setPaletteConfig, subscribePaletteConfig, usePaletteConfig, usePaletteVersion };
222
+ //# sourceMappingURL=palette-config.d.ts.map
package/dist/tokens/palette-config.js ADDED
@@ -0,0 +1,309 @@
1
+ /** @license MIT | @cube-dev/ui-kit v0.153.0 | Cube Dev Team */
2
+ import { useSyncExternalStore } from "react";
3
+
4
+ //#region src/tokens/palette-config.ts
5
+ /**
6
+ * Runtime configuration for the Glaze-generated color palette.
7
+ *
8
+ * The palette recipe itself lives in `./palette.ts`; this module owns only the
9
+ * *seeds* it is built from, plus a version counter the token caches watch. It
10
+ * deliberately imports nothing else — not the token modules, not `glaze` — so
11
+ * there is no import cycle and no ordering hazard.
12
+ *
13
+ * Reading is free; writing rebuilds the palette on the next token read. See
14
+ * `Getting Started/Theming` in Storybook for the full contract.
15
+ */
16
+ /** Brand hue. Drives the `default`, `primary`, `purple` and `special` themes. */
17
+ const DEFAULT_HUE = 280.3;
18
+ const DEFAULT_SUCCESS_HUE = 156.9;
19
+ const DEFAULT_DANGER_HUE = 23.1;
20
+ const DEFAULT_WARNING_HUE = 84.3;
21
+ const DEFAULT_NOTE_HUE = 302.3;
22
+ /** Seed saturation. Per-color `saturation` in the recipe is a 0–1 factor of it. */
23
+ const DEFAULT_SATURATION = 80;
24
+ const DEFAULT_THEME_HUES = {
25
+ success: DEFAULT_SUCCESS_HUE,
26
+ danger: DEFAULT_DANGER_HUE,
27
+ warning: DEFAULT_WARNING_HUE,
28
+ note: DEFAULT_NOTE_HUE
29
+ };
30
+ function resolveConfig(input) {
31
+ const saturation = input.saturation ?? DEFAULT_SATURATION;
32
+ const themes = input.themes ?? {};
33
+ const hue = input.hue ?? DEFAULT_HUE;
34
+ return {
35
+ hue,
36
+ baseHue: input.baseHue ?? hue,
37
+ saturation,
38
+ pastel: input.pastel ?? false,
39
+ contrastLevel: input.contrastLevel ?? "auto",
40
+ themes: {
41
+ success: {
42
+ hue: themes.success?.hue ?? DEFAULT_THEME_HUES.success,
43
+ saturation: themes.success?.saturation ?? saturation
44
+ },
45
+ danger: {
46
+ hue: themes.danger?.hue ?? DEFAULT_THEME_HUES.danger,
47
+ saturation: themes.danger?.saturation ?? saturation
48
+ },
49
+ warning: {
50
+ hue: themes.warning?.hue ?? DEFAULT_THEME_HUES.warning,
51
+ saturation: themes.warning?.saturation ?? saturation
52
+ },
53
+ note: {
54
+ hue: themes.note?.hue ?? DEFAULT_THEME_HUES.note,
55
+ saturation: themes.note?.saturation ?? saturation
56
+ },
57
+ code: { saturation: themes.code?.saturation ?? DEFAULT_SATURATION }
58
+ }
59
+ };
60
+ }
61
+ /**
62
+ * The palette as it ships, with no tuning applied. Frozen — it is the baseline
63
+ * every resolution falls back to, so a stray write to it would move the defaults
64
+ * for the whole process.
65
+ */
66
+ const DEFAULT_PALETTE_CONFIG = freezeConfig(resolveConfig({}));
67
+ /**
68
+ * The last config *as written*, sparse — not the resolved one. Keeping the sparse
69
+ * form is what makes inheritance live: a `saturation` with no `themes.danger.
70
+ * saturation` beside it means danger genuinely follows the palette, rather than
71
+ * having been frozen at whatever the palette read when it was set.
72
+ */
73
+ let input = {};
74
+ let resolved = DEFAULT_PALETTE_CONFIG;
75
+ let version = 0;
76
+ const listeners = /* @__PURE__ */ new Set();
77
+ function mergeSeed(base, patch) {
78
+ if (!base) return patch;
79
+ if (!patch) return base;
80
+ return {
81
+ ...base,
82
+ ...patch
83
+ };
84
+ }
85
+ /**
86
+ * Layer a patch over a base config. Used by {@link resolvePaletteConfig} for
87
+ * previews — *not* by {@link setPaletteConfig}, which replaces.
88
+ */
89
+ function mergeInput(base, patch) {
90
+ const next = {
91
+ ...base,
92
+ ...patch
93
+ };
94
+ if (base.themes || patch.themes) next.themes = {
95
+ success: mergeSeed(base.themes?.success, patch.themes?.success),
96
+ danger: mergeSeed(base.themes?.danger, patch.themes?.danger),
97
+ warning: mergeSeed(base.themes?.warning, patch.themes?.warning),
98
+ note: mergeSeed(base.themes?.note, patch.themes?.note),
99
+ code: mergeSeed(base.themes?.code, patch.themes?.code)
100
+ };
101
+ return next;
102
+ }
103
+ function isSameConfig(a, b) {
104
+ return a.hue === b.hue && a.baseHue === b.baseHue && a.saturation === b.saturation && a.pastel === b.pastel && a.contrastLevel === b.contrastLevel && a.themes.code.saturation === b.themes.code.saturation && [
105
+ "success",
106
+ "danger",
107
+ "warning",
108
+ "note"
109
+ ].every((name) => a.themes[name].hue === b.themes[name].hue && a.themes[name].saturation === b.themes[name].saturation);
110
+ }
111
+ /**
112
+ * Which fields are *explicitly set*, as an order-independent signature.
113
+ *
114
+ * Two configs can resolve to identical values yet differ in which of those values
115
+ * are pinned rather than inherited — pinning `primary.saturation` to the number it
116
+ * already inherited is the obvious case. That difference is invisible to
117
+ * {@link isSameConfig} but visible through {@link getPaletteConfigInput}, so it has
118
+ * to count as a change or a settings UI reading it would never re-render.
119
+ */
120
+ function pinSignature(config) {
121
+ const set = (value) => value === void 0 ? "0" : "1";
122
+ return [
123
+ set(config.hue),
124
+ set(config.baseHue),
125
+ set(config.saturation),
126
+ set(config.pastel),
127
+ set(config.contrastLevel),
128
+ set(config.themes?.code?.saturation),
129
+ ...[
130
+ "success",
131
+ "danger",
132
+ "warning",
133
+ "note"
134
+ ].flatMap((name) => [set(config.themes?.[name]?.hue), set(config.themes?.[name]?.saturation)])
135
+ ].join("");
136
+ }
137
+ /**
138
+ * Snapshot a config so the store owns it outright.
139
+ *
140
+ * Two hazards this closes. The caller's object stays theirs, so mutating it after
141
+ * the call cannot desync `input` from `resolved`. And what we hand back from
142
+ * {@link getPaletteConfig} / {@link getPaletteConfigInput} is frozen, so a caller
143
+ * who writes to it gets a clear failure rather than silently corrupting the store
144
+ * — the version would not bump, and every token cache would go on serving values
145
+ * that no longer match the config.
146
+ */
147
+ function freezeConfig(config) {
148
+ const themes = config.themes;
149
+ if (themes) {
150
+ for (const seed of Object.values(themes)) if (seed) Object.freeze(seed);
151
+ Object.freeze(themes);
152
+ }
153
+ return Object.freeze(config);
154
+ }
155
+ /** {@link freezeConfig} on a copy, for a config we did not create ourselves. */
156
+ function snapshotConfig(config) {
157
+ const themes = config.themes;
158
+ return freezeConfig({
159
+ ...config,
160
+ ...themes ? { themes: {
161
+ ...themes.success ? { success: { ...themes.success } } : null,
162
+ ...themes.danger ? { danger: { ...themes.danger } } : null,
163
+ ...themes.warning ? { warning: { ...themes.warning } } : null,
164
+ ...themes.note ? { note: { ...themes.note } } : null,
165
+ ...themes.code ? { code: { ...themes.code } } : null
166
+ } } : null
167
+ });
168
+ }
169
+ function commit(nextInput) {
170
+ const nextResolved = resolveConfig(nextInput);
171
+ if (isSameConfig(resolved, nextResolved) && pinSignature(input) === pinSignature(nextInput)) return;
172
+ input = snapshotConfig(nextInput);
173
+ resolved = freezeConfig(nextResolved);
174
+ version++;
175
+ listeners.forEach((listener) => listener());
176
+ }
177
+ /**
178
+ * Set the palette config.
179
+ *
180
+ * **Replaces**, like `useState` — the config you pass *is* the config, resolved
181
+ * against the shipped defaults. Nothing accumulates, so a field you leave out is a
182
+ * field you do not have: dropping a customization means dropping it from the
183
+ * object, and re-applying the same object twice is the same as applying it once.
184
+ *
185
+ * ```ts
186
+ * setPaletteConfig({ hue: 200, baseHue: 60 });
187
+ * setPaletteConfig({ hue: 200 }); // baseHue is gone — back to inheriting `hue`
188
+ * ```
189
+ *
190
+ * To adjust one field of the config already in place — a slider in a settings UI —
191
+ * pass an updater. It receives the config as written, sparse, so spreading it
192
+ * preserves which fields are pinned and which still inherit:
193
+ *
194
+ * ```ts
195
+ * setPaletteConfig((config) => ({ ...config, hue: 200 }));
196
+ * ```
197
+ *
198
+ * The palette is rebuilt lazily on the next token read, and any mounted `<Root>`
199
+ * re-injects the token block — no component re-render is involved, because every
200
+ * color in the kit resolves through a CSS custom property.
201
+ */
202
+ function setPaletteConfig(config) {
203
+ commit(typeof config === "function" ? config(input) : config);
204
+ }
205
+ /**
206
+ * Drop all tuning and restore the palette the kit ships with. Identical to
207
+ * `setPaletteConfig({})`; it exists to be readable at a call site.
208
+ */
209
+ function resetPaletteConfig() {
210
+ commit({});
211
+ }
212
+ /**
213
+ * Force every token to re-resolve without changing the palette config.
214
+ *
215
+ * Only needed if you drive Glaze directly — `glaze.configure({ darkTone })` and
216
+ * the like. Glaze invalidates its own caches, but the kit's token maps are
217
+ * memoized against *this* module's version, so they need telling. Calling it
218
+ * before the first paint is unnecessary; nothing has been resolved yet.
219
+ */
220
+ function invalidatePaletteTokens() {
221
+ version++;
222
+ listeners.forEach((listener) => listener());
223
+ }
224
+ /** The current config, with every field resolved to a concrete value. */
225
+ function getPaletteConfig() {
226
+ return resolved;
227
+ }
228
+ /**
229
+ * The config **as set**, sparse — omitted fields are the ones still inheriting.
230
+ *
231
+ * {@link getPaletteConfig} resolves everything to concrete values, which loses the
232
+ * distinction between "explicitly 80" and "80 because it follows the brand". A
233
+ * settings UI needs that distinction to show an inherited value as inherited, and
234
+ * to offer a way back:
235
+ *
236
+ * ```ts
237
+ * const pinned = getPaletteConfigInput().baseHue !== undefined;
238
+ *
239
+ * // Re-link it to the brand by dropping the field.
240
+ * setPaletteConfig(({ baseHue, ...config }) => config);
241
+ * ```
242
+ *
243
+ * It is also the value handed to a {@link setPaletteConfig} updater.
244
+ */
245
+ function getPaletteConfigInput() {
246
+ return input;
247
+ }
248
+ /**
249
+ * Resolve a patch **over** the current config, without applying it.
250
+ *
251
+ * This one layers, unlike {@link setPaletteConfig}: a preview wants "the theme in
252
+ * use, but in dark", so the fields it does not mention have to come from the live
253
+ * config rather than from the defaults. The store is not touched and no listener
254
+ * fires.
255
+ */
256
+ function resolvePaletteConfig(config) {
257
+ if (!config) return resolved;
258
+ return resolveConfig(mergeInput(input, config));
259
+ }
260
+ /**
261
+ * Increments whenever the resolved config changes. The token caches in
262
+ * `./palette.ts`, `./colors.ts` and `./index.ts` compare against it instead of
263
+ * memoizing forever — the same idiom Glaze uses for its own config version.
264
+ */
265
+ function getPaletteVersion() {
266
+ return version;
267
+ }
268
+ /** Subscribe to palette config changes. Returns an unsubscribe function. */
269
+ function subscribePaletteConfig(listener) {
270
+ listeners.add(listener);
271
+ return () => {
272
+ listeners.delete(listener);
273
+ };
274
+ }
275
+ /**
276
+ * Re-render on palette config changes. Returns the version, not the config, so
277
+ * the snapshot is a primitive and React never warns about an uncached snapshot.
278
+ */
279
+ function usePaletteVersion() {
280
+ return useSyncExternalStore(subscribePaletteConfig, getPaletteVersion, getPaletteVersion);
281
+ }
282
+ /**
283
+ * Read and tune the palette from React, `useState`-style — including the part
284
+ * where the setter *replaces*. A control that changes one field wants the updater
285
+ * form, or it will drop every other field:
286
+ *
287
+ * ```tsx
288
+ * const [palette, setPalette] = usePaletteConfig();
289
+ *
290
+ * <HueSlider
291
+ * value={palette.hue}
292
+ * onChange={(hue) => setPalette((config) => ({ ...config, hue }))}
293
+ * />
294
+ * ```
295
+ *
296
+ * The first element is the *resolved* config, so `palette.hue` is always a number.
297
+ * The updater's argument is the sparse one — see {@link getPaletteConfigInput}.
298
+ *
299
+ * The config is global process state, so every consumer of this hook — and every
300
+ * mounted `<Root>` — sees the same palette.
301
+ */
302
+ function usePaletteConfig() {
303
+ usePaletteVersion();
304
+ return [getPaletteConfig(), setPaletteConfig];
305
+ }
306
+
307
+ //#endregion
308
+ export { DEFAULT_PALETTE_CONFIG, getPaletteConfig, getPaletteConfigInput, getPaletteVersion, invalidatePaletteTokens, resetPaletteConfig, resolvePaletteConfig, setPaletteConfig, subscribePaletteConfig, usePaletteConfig, usePaletteVersion };
309
+ //# sourceMappingURL=palette-config.js.map
package/dist/tokens/palette-config.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"palette-config.js","names":[],"sources":["../../src/tokens/palette-config.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\n/**\n * Runtime configuration for the Glaze-generated color palette.\n *\n * The palette recipe itself lives in `./palette.ts`; this module owns only the\n * *seeds* it is built from, plus a version counter the token caches watch. It\n * deliberately imports nothing else — not the token modules, not `glaze` — so\n * there is no import cycle and no ordering hazard.\n *\n * Reading is free; writing rebuilds the palette on the next token read. See\n * `Getting Started/Theming` in Storybook for the full contract.\n */\n\n// ============================================================================\n// Default seeds\n// ============================================================================\n\n/** Brand hue. Drives the `default`, `primary`, `purple` and `special` themes. */\nexport const DEFAULT_HUE = 280.3;\nexport const DEFAULT_SUCCESS_HUE = 156.9;\nexport const DEFAULT_DANGER_HUE = 23.1;\nexport const DEFAULT_WARNING_HUE = 84.3;\nexport const DEFAULT_NOTE_HUE = 302.3;\n\n/** Seed saturation. Per-color `saturation` in the recipe is a 0–1 factor of it. */\nexport const DEFAULT_SATURATION = 80;\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** Hue / saturation seed override for one colored theme. */\nexport interface PaletteThemeSeed {\n /** Hue in degrees (0–360). */\n hue?: number;\n /** Saturation (0–100). Defaults to the palette-level `saturation`. */\n saturation?: number;\n}\n\n/**\n * The `code-*` syntax family takes a saturation and nothing else.\n *\n * Its hues are absolute literals by design, so syntax colors never rotate with the\n * brand — strings would collide with numbers the moment the brand went green. And\n * unlike every other theme, its saturation does **not** inherit the palette-level\n * one: the code palette is calibrated once and stays there, so re-seeding the app\n * cannot quietly wash out a code block.\n */\nexport interface PaletteCodeSeed {\n /** Saturation (0–100). Defaults to {@link DEFAULT_SATURATION}, not to `saturation`. */\n saturation?: number;\n}\n\n/** Names of the themes whose seeds can be overridden individually. */\nexport type PaletteThemeName =\n | 'success'\n | 'danger'\n | 'warning'\n | 'note'\n | 'code';\n\n/**\n * Palette tuning. Every field is optional; omitted fields keep their default,\n * and per-theme fields left unset inherit the palette-level value.\n */\nexport interface PaletteConfig {\n /**\n * Accent hue in degrees (0–360) — the brand.\n *\n * Drives the `accent-*` family on every theme, `primary` / `purple` / `special`,\n * and the brand-tinted odds and ends (`focus`, the loading faces, the disabled\n * chip). Also the default for {@link PaletteConfig.baseHue}.\n */\n hue?: number;\n /**\n * Hue of the **base** zone in degrees (0–360): the neutral chrome — `surface`\n * and its ladder, the `surface-text*` ramp, `border`, `placeholder`. Defaults to\n * `hue`, so the chrome carries a faint tint of the brand unless you say otherwise.\n *\n * Splitting it lets the chrome sit on a different hue from the accent — a warm\n * grey UI with a cool blue brand, say. Only the `default` theme is affected: a\n * colored theme's tinted `surface` deliberately follows *its own* hue, because a\n * danger banner should read as red.\n */\n baseHue?: number;\n /**\n * Seed saturation (0–100), and the fallback for every theme that does not set\n * its own.\n *\n * One scale for the whole theme, by design. Every color's own `saturation` is a\n * 0–1 factor of this seed — `surface` at 0.12, `border` at 0.175, the text ramp\n * at 0.2, the accent family at ~1.0 — so moving it rescales the palette while\n * keeping those proportions. Unlike hue, which is configured separately for the\n * brand and for each status theme, saturation is deliberately not split: the\n * ratio between a subtle surface tint and a saturated accent is part of the\n * design.\n */\n saturation?: number;\n /**\n * Global. Widens the usable chroma range by relaxing the sRGB-safe limit,\n * producing a softer, more even palette across hues. Glaze treats `pastel` as\n * instance-level, so it is threaded into every theme.\n */\n pastel?: boolean;\n /**\n * Global. `'auto'` (the default) keeps the two-tier model: normal colors plus\n * a separate high-contrast tier driven by `<html data-contrast=\"high\">` /\n * `prefers-contrast: more`.\n *\n * A number (0–100) replaces that switch with a slider — and, because a manual\n * level already carries the contrast preference, **drops the high-contrast\n * tier entirely**. `0` reproduces the normal output and `100` the\n * high-contrast output, bit for bit.\n */\n contrastLevel?: number | 'auto';\n /** Per-theme seed overrides. */\n themes?: {\n success?: PaletteThemeSeed;\n danger?: PaletteThemeSeed;\n warning?: PaletteThemeSeed;\n note?: PaletteThemeSeed;\n code?: PaletteCodeSeed;\n };\n}\n\n/** {@link PaletteConfig} with every field resolved to a concrete value. */\nexport interface ResolvedPaletteConfig {\n hue: number;\n baseHue: number;\n saturation: number;\n pastel: boolean;\n contrastLevel: number | 'auto';\n themes: {\n success: { hue: number; saturation: number };\n danger: { hue: number; saturation: number };\n warning: { hue: number; saturation: number };\n note: { hue: number; saturation: number };\n code: { saturation: number };\n };\n}\n\n// ============================================================================\n// Resolution\n// ============================================================================\n\nconst DEFAULT_THEME_HUES = {\n success: DEFAULT_SUCCESS_HUE,\n danger: DEFAULT_DANGER_HUE,\n warning: DEFAULT_WARNING_HUE,\n note: DEFAULT_NOTE_HUE,\n} as const;\n\nfunction resolveConfig(input: PaletteConfig): ResolvedPaletteConfig {\n const saturation = input.saturation ?? DEFAULT_SATURATION;\n const themes = input.themes ?? {};\n\n const hue = input.hue ?? DEFAULT_HUE;\n\n return {\n hue,\n baseHue: input.baseHue ?? hue,\n saturation,\n pastel: input.pastel ?? false,\n contrastLevel: input.contrastLevel ?? 'auto',\n themes: {\n success: {\n hue: themes.success?.hue ?? DEFAULT_THEME_HUES.success,\n saturation: themes.success?.saturation ?? saturation,\n },\n danger: {\n hue: themes.danger?.hue ?? DEFAULT_THEME_HUES.danger,\n saturation: themes.danger?.saturation ?? saturation,\n },\n warning: {\n hue: themes.warning?.hue ?? DEFAULT_THEME_HUES.warning,\n saturation: themes.warning?.saturation ?? saturation,\n },\n note: {\n hue: themes.note?.hue ?? DEFAULT_THEME_HUES.note,\n saturation: themes.note?.saturation ?? saturation,\n },\n // Deliberately NOT `?? saturation`: the code palette is calibrated once and\n // does not follow the palette-level seed. See `PaletteCodeSeed`.\n code: { saturation: themes.code?.saturation ?? DEFAULT_SATURATION },\n },\n };\n}\n\n/**\n * The palette as it ships, with no tuning applied. Frozen — it is the baseline\n * every resolution falls back to, so a stray write to it would move the defaults\n * for the whole process.\n */\nexport const DEFAULT_PALETTE_CONFIG: ResolvedPaletteConfig = freezeConfig(\n resolveConfig({}),\n);\n\n// ============================================================================\n// Store\n// ============================================================================\n\n/**\n * The last config *as written*, sparse — not the resolved one. Keeping the sparse\n * form is what makes inheritance live: a `saturation` with no `themes.danger.\n * saturation` beside it means danger genuinely follows the palette, rather than\n * having been frozen at whatever the palette read when it was set.\n */\nlet input: PaletteConfig = {};\nlet resolved: ResolvedPaletteConfig = DEFAULT_PALETTE_CONFIG;\nlet version = 0;\n\nconst listeners = new Set<() => void>();\n\nfunction mergeSeed<T extends PaletteThemeSeed | PaletteCodeSeed>(\n base: T | undefined,\n patch: T | undefined,\n): T | undefined {\n if (!base) return patch;\n // A patch that omits the theme entirely says nothing about it, so the base\n // survives. Clearing one of its fields is `{ theme: { hue: undefined } }`.\n if (!patch) return base;\n\n return { ...base, ...patch };\n}\n\n/**\n * Layer a patch over a base config. Used by {@link resolvePaletteConfig} for\n * previews — *not* by {@link setPaletteConfig}, which replaces.\n */\nfunction mergeInput(base: PaletteConfig, patch: PaletteConfig): PaletteConfig {\n const next: PaletteConfig = { ...base, ...patch };\n\n if (base.themes || patch.themes) {\n next.themes = {\n success: mergeSeed(base.themes?.success, patch.themes?.success),\n danger: mergeSeed(base.themes?.danger, patch.themes?.danger),\n warning: mergeSeed(base.themes?.warning, patch.themes?.warning),\n note: mergeSeed(base.themes?.note, patch.themes?.note),\n code: mergeSeed(base.themes?.code, patch.themes?.code),\n };\n }\n\n return next;\n}\n\nfunction isSameConfig(a: ResolvedPaletteConfig, b: ResolvedPaletteConfig) {\n return (\n a.hue === b.hue &&\n a.baseHue === b.baseHue &&\n a.saturation === b.saturation &&\n a.pastel === b.pastel &&\n a.contrastLevel === b.contrastLevel &&\n a.themes.code.saturation === b.themes.code.saturation &&\n (['success', 'danger', 'warning', 'note'] as const).every(\n (name) =>\n a.themes[name].hue === b.themes[name].hue &&\n a.themes[name].saturation === b.themes[name].saturation,\n )\n );\n}\n\n/**\n * Which fields are *explicitly set*, as an order-independent signature.\n *\n * Two configs can resolve to identical values yet differ in which of those values\n * are pinned rather than inherited — pinning `primary.saturation` to the number it\n * already inherited is the obvious case. That difference is invisible to\n * {@link isSameConfig} but visible through {@link getPaletteConfigInput}, so it has\n * to count as a change or a settings UI reading it would never re-render.\n */\nfunction pinSignature(config: PaletteConfig): string {\n const set = (value: unknown) => (value === undefined ? '0' : '1');\n\n return [\n set(config.hue),\n set(config.baseHue),\n set(config.saturation),\n set(config.pastel),\n set(config.contrastLevel),\n set(config.themes?.code?.saturation),\n ...(['success', 'danger', 'warning', 'note'] as const).flatMap((name) => [\n set(config.themes?.[name]?.hue),\n set(config.themes?.[name]?.saturation),\n ]),\n ].join('');\n}\n\n/**\n * Snapshot a config so the store owns it outright.\n *\n * Two hazards this closes. The caller's object stays theirs, so mutating it after\n * the call cannot desync `input` from `resolved`. And what we hand back from\n * {@link getPaletteConfig} / {@link getPaletteConfigInput} is frozen, so a caller\n * who writes to it gets a clear failure rather than silently corrupting the store\n * — the version would not bump, and every token cache would go on serving values\n * that no longer match the config.\n */\nfunction freezeConfig<T extends PaletteConfig | ResolvedPaletteConfig>(\n config: T,\n): T {\n const themes = config.themes;\n\n if (themes) {\n for (const seed of Object.values(themes)) {\n if (seed) Object.freeze(seed);\n }\n Object.freeze(themes);\n }\n\n return Object.freeze(config);\n}\n\n/** {@link freezeConfig} on a copy, for a config we did not create ourselves. */\nfunction snapshotConfig(config: PaletteConfig): PaletteConfig {\n const themes = config.themes;\n\n return freezeConfig({\n ...config,\n ...(themes\n ? {\n themes: {\n ...(themes.success ? { success: { ...themes.success } } : null),\n ...(themes.danger ? { danger: { ...themes.danger } } : null),\n ...(themes.warning ? { warning: { ...themes.warning } } : null),\n ...(themes.note ? { note: { ...themes.note } } : null),\n ...(themes.code ? { code: { ...themes.code } } : null),\n },\n }\n : null),\n });\n}\n\nfunction commit(nextInput: PaletteConfig) {\n const nextResolved = resolveConfig(nextInput);\n\n // Bail before bumping the version when nothing observable moved, so re-applying\n // the same config — an inline `<Root palette={{ … }}>` literal on every\n // render, a StrictMode double render — costs nothing.\n if (\n isSameConfig(resolved, nextResolved) &&\n pinSignature(input) === pinSignature(nextInput)\n ) {\n return;\n }\n\n input = snapshotConfig(nextInput);\n resolved = freezeConfig(nextResolved);\n version++;\n\n listeners.forEach((listener) => listener());\n}\n\n/**\n * Set the palette config.\n *\n * **Replaces**, like `useState` — the config you pass *is* the config, resolved\n * against the shipped defaults. Nothing accumulates, so a field you leave out is a\n * field you do not have: dropping a customization means dropping it from the\n * object, and re-applying the same object twice is the same as applying it once.\n *\n * ```ts\n * setPaletteConfig({ hue: 200, baseHue: 60 });\n * setPaletteConfig({ hue: 200 }); // baseHue is gone — back to inheriting `hue`\n * ```\n *\n * To adjust one field of the config already in place — a slider in a settings UI —\n * pass an updater. It receives the config as written, sparse, so spreading it\n * preserves which fields are pinned and which still inherit:\n *\n * ```ts\n * setPaletteConfig((config) => ({ ...config, hue: 200 }));\n * ```\n *\n * The palette is rebuilt lazily on the next token read, and any mounted `<Root>`\n * re-injects the token block — no component re-render is involved, because every\n * color in the kit resolves through a CSS custom property.\n */\nexport function setPaletteConfig(\n config: PaletteConfig | ((previous: PaletteConfig) => PaletteConfig),\n): void {\n commit(typeof config === 'function' ? config(input) : config);\n}\n\n/**\n * Drop all tuning and restore the palette the kit ships with. Identical to\n * `setPaletteConfig({})`; it exists to be readable at a call site.\n */\nexport function resetPaletteConfig(): void {\n commit({});\n}\n\n/**\n * Force every token to re-resolve without changing the palette config.\n *\n * Only needed if you drive Glaze directly — `glaze.configure({ darkTone })` and\n * the like. Glaze invalidates its own caches, but the kit's token maps are\n * memoized against *this* module's version, so they need telling. Calling it\n * before the first paint is unnecessary; nothing has been resolved yet.\n */\nexport function invalidatePaletteTokens(): void {\n version++;\n listeners.forEach((listener) => listener());\n}\n\n/** The current config, with every field resolved to a concrete value. */\nexport function getPaletteConfig(): ResolvedPaletteConfig {\n return resolved;\n}\n\n/**\n * The config **as set**, sparse — omitted fields are the ones still inheriting.\n *\n * {@link getPaletteConfig} resolves everything to concrete values, which loses the\n * distinction between \"explicitly 80\" and \"80 because it follows the brand\". A\n * settings UI needs that distinction to show an inherited value as inherited, and\n * to offer a way back:\n *\n * ```ts\n * const pinned = getPaletteConfigInput().baseHue !== undefined;\n *\n * // Re-link it to the brand by dropping the field.\n * setPaletteConfig(({ baseHue, ...config }) => config);\n * ```\n *\n * It is also the value handed to a {@link setPaletteConfig} updater.\n */\nexport function getPaletteConfigInput(): PaletteConfig {\n return input;\n}\n\n/**\n * Resolve a patch **over** the current config, without applying it.\n *\n * This one layers, unlike {@link setPaletteConfig}: a preview wants \"the theme in\n * use, but in dark\", so the fields it does not mention have to come from the live\n * config rather than from the defaults. The store is not touched and no listener\n * fires.\n */\nexport function resolvePaletteConfig(\n config?: PaletteConfig,\n): ResolvedPaletteConfig {\n if (!config) return resolved;\n\n return resolveConfig(mergeInput(input, config));\n}\n\n/**\n * Increments whenever the resolved config changes. The token caches in\n * `./palette.ts`, `./colors.ts` and `./index.ts` compare against it instead of\n * memoizing forever — the same idiom Glaze uses for its own config version.\n */\nexport function getPaletteVersion(): number {\n return version;\n}\n\n/** Subscribe to palette config changes. Returns an unsubscribe function. */\nexport function subscribePaletteConfig(listener: () => void): () => void {\n listeners.add(listener);\n\n return () => {\n listeners.delete(listener);\n };\n}\n\n// ============================================================================\n// React bindings\n// ============================================================================\n\n/**\n * Re-render on palette config changes. Returns the version, not the config, so\n * the snapshot is a primitive and React never warns about an uncached snapshot.\n */\nexport function usePaletteVersion(): number {\n return useSyncExternalStore(\n subscribePaletteConfig,\n getPaletteVersion,\n getPaletteVersion,\n );\n}\n\n/**\n * Read and tune the palette from React, `useState`-style — including the part\n * where the setter *replaces*. A control that changes one field wants the updater\n * form, or it will drop every other field:\n *\n * ```tsx\n * const [palette, setPalette] = usePaletteConfig();\n *\n * <HueSlider\n * value={palette.hue}\n * onChange={(hue) => setPalette((config) => ({ ...config, hue }))}\n * />\n * ```\n *\n * The first element is the *resolved* config, so `palette.hue` is always a number.\n * The updater's argument is the sparse one — see {@link getPaletteConfigInput}.\n *\n * The config is global process state, so every consumer of this hook — and every\n * mounted `<Root>` — sees the same palette.\n */\nexport function usePaletteConfig(): readonly [\n ResolvedPaletteConfig,\n typeof setPaletteConfig,\n] {\n usePaletteVersion();\n\n return [getPaletteConfig(), setPaletteConfig];\n}\n"],"mappings":"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"}
package/dist/tokens/palette.d.ts CHANGED
@@ -1,15 +1,55 @@
1
1
 
2
- import { Styles } from "@tenphi/tasty";
3
- import "@tenphi/glaze";
2
+ import { PaletteConfig } from "./palette-config.js";
3
+ import { Styles, Tokens } from "@tenphi/tasty";
4
+ import { GlazePalette, GlazeTheme } from "@tenphi/glaze";
4
5
 
5
6
  //#region src/tokens/palette.d.ts
7
+ /** Which resolved scheme variant {@link renderPaletteTokens} should return. */
8
+ interface RenderPaletteOptions extends PaletteConfig {
9
+ /** Color scheme to resolve. Default: `'light'`. */
10
+ scheme?: 'light' | 'dark';
11
+ /** Resolve the high-contrast variant of that scheme. Default: `false`. */
12
+ highContrast?: boolean;
13
+ }
14
+ /**
15
+ * Resolve Glaze palette tokens against the current palette config.
16
+ *
17
+ * Memoized against the config version (see `./palette-config.ts`), so repeated
18
+ * reads are free and `setPaletteConfig()` invalidates them. Resolution is
19
+ * deferred rather than done at module import, so host apps can call
20
+ * `setPaletteConfig(...)` / `glaze.configure(...)` after importing
21
+ * `@cube-dev/ui-kit` and still affect the first paint.
22
+ *
23
+ * Keys use `#name` syntax; values are state maps:
24
+ * '#surface': { '': 'oklch(...)', '@dark': 'oklch(...)', '@hc': 'oklch(...)' }
25
+ */
6
26
  declare function getPaletteTokens(): Styles;
27
+ /** The live `GlazePalette`. Rebuilt whenever the palette config changes. */
28
+ declare function getPalette(): GlazePalette;
29
+ /**
30
+ * The live theme behind the `code-*` tokens. Separate from {@link getPalette}
31
+ * because it carries its own saturation seed — see {@link CODE_COLORS}.
32
+ */
33
+ declare function getCodeTheme(): GlazeTheme;
34
+ /**
35
+ * Resolve one scheme variant of a palette to flat, literal color values.
36
+ *
37
+ * Unlike {@link getPaletteTokens}, which emits state maps (`@dark` / `@hc`) for
38
+ * the whole document, this collapses the palette to the single variant you ask
39
+ * for. That is what makes a **region** preview possible: applied through a tasty
40
+ * `tokens` prop, the values override the inherited ones for that subtree only, so
41
+ * a dark or high-contrast theme can be shown inside a light page.
42
+ *
43
+ * Prefer `renderColorTokens()` from `./colors` unless you specifically want the
44
+ * palette without the legacy aliases.
45
+ */
46
+ declare function renderPaletteTokens(options?: RenderPaletteOptions): Tokens;
7
47
  /**
8
48
  * Lazy proxy of {@link getPaletteTokens}. Prefer `getPaletteTokens()` in new
9
- * code. First property / enumeration access resolves against the live glaze
10
- * config (same memo as the getter).
49
+ * code. Property / enumeration access always reflects the current palette
50
+ * config.
11
51
  */
12
52
  declare const PALETTE_TOKENS: Styles;
13
53
  //#endregion
14
- export { PALETTE_TOKENS, getPaletteTokens };
54
+ export { PALETTE_TOKENS, RenderPaletteOptions, getCodeTheme, getPalette, getPaletteTokens, renderPaletteTokens };
15
55
  //# sourceMappingURL=palette.d.ts.map