@jcsoftdev/ui 0.2.3 → 0.4.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 (601) hide show
  1. package/CHANGELOG.md +390 -7
  2. package/README.md +57 -3
  3. package/bin/ui-theme.mjs +1162 -25
  4. package/dist/ai/attachment/attachment.js +1 -1
  5. package/dist/ai/chat-list/group.js +3 -1
  6. package/dist/ai/conversation/conversation.js +1 -1
  7. package/dist/ai/internal/use-copy.d.ts +1 -5
  8. package/dist/ai/internal/use-copy.js +1 -32
  9. package/dist/ai/markdown/parse.js +59 -17
  10. package/dist/ai/source/source.js +1 -1
  11. package/dist/atoms/avatar/avatar.d.ts +13 -3
  12. package/dist/atoms/avatar/avatar.js +40 -2
  13. package/dist/atoms/avatar/index.d.ts +1 -1
  14. package/dist/atoms/avatar/index.js +3 -1
  15. package/dist/atoms/button/button.d.ts +4 -1
  16. package/dist/atoms/button/button.js +4 -2
  17. package/dist/atoms/checkbox/checkbox.d.ts +8 -3
  18. package/dist/atoms/checkbox/checkbox.js +26 -3
  19. package/dist/atoms/chip/chip.d.ts +19 -5
  20. package/dist/atoms/chip/chip.js +34 -5
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +6 -1
  23. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  24. package/dist/atoms/due-chip/due-chip.js +41 -0
  25. package/dist/atoms/due-chip/index.d.ts +2 -0
  26. package/dist/atoms/due-chip/index.js +6 -0
  27. package/dist/atoms/due-chip/model.d.ts +25 -0
  28. package/dist/atoms/due-chip/model.js +44 -0
  29. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  30. package/dist/atoms/icon-button/icon-button.js +38 -0
  31. package/dist/atoms/icon-button/index.d.ts +1 -0
  32. package/dist/atoms/icon-button/index.js +8 -0
  33. package/dist/atoms/index.d.ts +5 -0
  34. package/dist/atoms/index.js +5 -0
  35. package/dist/atoms/internal/hit-area.d.ts +6 -0
  36. package/dist/atoms/internal/hit-area.js +4 -0
  37. package/dist/atoms/kbd/index.d.ts +1 -0
  38. package/dist/atoms/kbd/index.js +4 -0
  39. package/dist/atoms/kbd/kbd.d.ts +7 -0
  40. package/dist/atoms/kbd/kbd.js +17 -0
  41. package/dist/atoms/radio-group/radio-group.js +6 -2
  42. package/dist/atoms/seal/index.d.ts +1 -0
  43. package/dist/atoms/seal/index.js +4 -0
  44. package/dist/atoms/seal/seal.d.ts +30 -0
  45. package/dist/atoms/seal/seal.js +71 -0
  46. package/dist/atoms/spinner/index.d.ts +1 -0
  47. package/dist/atoms/spinner/index.js +5 -0
  48. package/dist/atoms/spinner/spinner.d.ts +19 -0
  49. package/dist/atoms/spinner/spinner.js +31 -0
  50. package/dist/atoms/status-dot/index.d.ts +1 -1
  51. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  52. package/dist/atoms/status-dot/status-dot.js +5 -1
  53. package/dist/atoms/switch/switch.js +3 -1
  54. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  55. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  56. package/dist/calendar/date-calendar/index.d.ts +1 -0
  57. package/dist/calendar/date-calendar/index.js +6 -0
  58. package/dist/calendar/index.d.ts +1 -0
  59. package/dist/calendar/index.js +1 -0
  60. package/dist/calendar/internal/date-utils.d.ts +26 -0
  61. package/dist/calendar/internal/date-utils.js +95 -1
  62. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  63. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  64. package/dist/charts/chord-chart/chord-chart.js +13 -5
  65. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  66. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  67. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  68. package/dist/charts/core/cartesian/layout.js +14 -5
  69. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  70. package/dist/charts/core/cartesian/marks.js +1 -1
  71. package/dist/charts/core/cartesian/types.d.ts +28 -2
  72. package/dist/charts/core/category-explorer.d.ts +2 -2
  73. package/dist/charts/core/category-explorer.js +8 -4
  74. package/dist/charts/core/chart-dock.d.ts +26 -0
  75. package/dist/charts/core/chart-dock.js +45 -0
  76. package/dist/charts/core/chart-frame.d.ts +9 -2
  77. package/dist/charts/core/chart-frame.js +105 -25
  78. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  79. package/dist/charts/core/distribution/explorer.js +12 -5
  80. package/dist/charts/core/distribution/xy-points.js +1 -1
  81. package/dist/charts/core/index.d.ts +3 -0
  82. package/dist/charts/core/index.js +3 -0
  83. package/dist/charts/core/leave-grace.d.ts +11 -0
  84. package/dist/charts/core/leave-grace.js +26 -0
  85. package/dist/charts/core/nearest.d.ts +14 -0
  86. package/dist/charts/core/nearest.js +22 -0
  87. package/dist/charts/core/plot-overlay.js +9 -3
  88. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  89. package/dist/charts/core/pointer.test-utils.js +123 -0
  90. package/dist/charts/core/tooltip.d.ts +25 -2
  91. package/dist/charts/core/tooltip.js +115 -40
  92. package/dist/charts/core/touch-select.d.ts +20 -0
  93. package/dist/charts/core/touch-select.js +184 -0
  94. package/dist/charts/core/types.d.ts +8 -4
  95. package/dist/charts/core/types.js +5 -0
  96. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  97. package/dist/charts/core/use-index-navigation.js +47 -10
  98. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  99. package/dist/charts/donut-chart/donut-chart.js +40 -1
  100. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  101. package/dist/charts/donut-chart/slice-labels.js +20 -0
  102. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  103. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  104. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  105. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  106. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  107. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  108. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  109. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  110. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  111. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  112. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  113. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  114. package/dist/charts/maps/geo/map-viewport.js +1 -1
  115. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  116. package/dist/charts/progress-units/progress-units.js +1 -0
  117. package/dist/charts/radar-chart/radar-chart.js +1 -1
  118. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  119. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  120. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  121. package/dist/charts/tree-chart/tree-chart.js +1 -0
  122. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  123. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  124. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  125. package/dist/containers/action-bar/action-bar.js +4 -1
  126. package/dist/containers/aside/aside.d.ts +14 -0
  127. package/dist/containers/aside/aside.js +25 -0
  128. package/dist/containers/aside/index.d.ts +1 -0
  129. package/dist/containers/aside/index.js +5 -0
  130. package/dist/containers/banner/banner.d.ts +4 -1
  131. package/dist/containers/banner/banner.js +9 -1
  132. package/dist/containers/card/card.d.ts +21 -3
  133. package/dist/containers/card/card.js +20 -5
  134. package/dist/containers/description-list/description-list.d.ts +29 -6
  135. package/dist/containers/description-list/description-list.js +47 -6
  136. package/dist/containers/feed/feed.d.ts +23 -0
  137. package/dist/containers/feed/feed.js +77 -0
  138. package/dist/containers/feed/index.d.ts +2 -0
  139. package/dist/containers/feed/index.js +10 -0
  140. package/dist/containers/feed/model.d.ts +19 -0
  141. package/dist/containers/feed/model.js +38 -0
  142. package/dist/containers/grid/grid.d.ts +15 -0
  143. package/dist/containers/grid/grid.js +24 -0
  144. package/dist/containers/grid/index.d.ts +1 -0
  145. package/dist/containers/grid/index.js +4 -0
  146. package/dist/containers/index.d.ts +9 -0
  147. package/dist/containers/index.js +9 -0
  148. package/dist/containers/kpi/kpi.d.ts +60 -7
  149. package/dist/containers/kpi/kpi.js +142 -28
  150. package/dist/containers/kpi-group/index.d.ts +1 -1
  151. package/dist/containers/kpi-group/index.js +3 -1
  152. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  153. package/dist/containers/kpi-group/kpi-group.js +11 -1
  154. package/dist/containers/list-detail/index.d.ts +1 -0
  155. package/dist/containers/list-detail/index.js +20 -0
  156. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  157. package/dist/containers/list-detail/list-detail.js +221 -0
  158. package/dist/containers/note/index.d.ts +1 -0
  159. package/dist/containers/note/index.js +4 -0
  160. package/dist/containers/note/note.d.ts +13 -0
  161. package/dist/containers/note/note.js +27 -0
  162. package/dist/containers/page/index.d.ts +1 -0
  163. package/dist/containers/page/index.js +4 -0
  164. package/dist/containers/page/page.d.ts +7 -0
  165. package/dist/containers/page/page.js +14 -0
  166. package/dist/containers/page-header/page-header.d.ts +8 -3
  167. package/dist/containers/page-header/page-header.js +35 -8
  168. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  169. package/dist/containers/responsive-list/responsive-list.js +6 -3
  170. package/dist/containers/section/index.d.ts +1 -0
  171. package/dist/containers/section/index.js +6 -0
  172. package/dist/containers/section/section.d.ts +68 -0
  173. package/dist/containers/section/section.js +198 -0
  174. package/dist/containers/shortcuts/index.d.ts +1 -0
  175. package/dist/containers/shortcuts/index.js +8 -0
  176. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  177. package/dist/containers/shortcuts/shortcuts.js +50 -0
  178. package/dist/containers/stack/index.d.ts +1 -0
  179. package/dist/containers/stack/index.js +6 -0
  180. package/dist/containers/stack/stack.d.ts +15 -0
  181. package/dist/containers/stack/stack.js +43 -0
  182. package/dist/containers/table/selection.d.ts +9 -0
  183. package/dist/containers/table/selection.js +20 -0
  184. package/dist/containers/table/table.d.ts +66 -4
  185. package/dist/containers/table/table.js +128 -7
  186. package/dist/containers/timeline/index.d.ts +1 -1
  187. package/dist/containers/timeline/index.js +4 -2
  188. package/dist/containers/timeline/timeline.d.ts +32 -5
  189. package/dist/containers/timeline/timeline.js +154 -90
  190. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  191. package/dist/forms/chip-group/chip-group.js +114 -0
  192. package/dist/forms/chip-group/index.d.ts +1 -0
  193. package/dist/forms/chip-group/index.js +6 -0
  194. package/dist/forms/combobox/combobox.d.ts +60 -0
  195. package/dist/forms/combobox/combobox.js +281 -0
  196. package/dist/forms/combobox/index.d.ts +1 -0
  197. package/dist/forms/combobox/index.js +6 -0
  198. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  199. package/dist/forms/copy-field/copy-field.js +72 -0
  200. package/dist/forms/copy-field/index.d.ts +1 -0
  201. package/dist/forms/copy-field/index.js +4 -0
  202. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  203. package/dist/forms/date-picker/date-picker.js +183 -0
  204. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  205. package/dist/forms/date-picker/date-time-picker.js +121 -0
  206. package/dist/forms/date-picker/index.d.ts +2 -0
  207. package/dist/forms/date-picker/index.js +10 -0
  208. package/dist/forms/date-picker/model.d.ts +35 -0
  209. package/dist/forms/date-picker/model.js +83 -0
  210. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  211. package/dist/forms/dropzone/dropzone.js +153 -23
  212. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  213. package/dist/forms/field/field.d.ts +16 -10
  214. package/dist/forms/field/field.js +41 -5
  215. package/dist/forms/form/form.d.ts +15 -0
  216. package/dist/forms/form/form.js +29 -0
  217. package/dist/forms/form/index.d.ts +1 -0
  218. package/dist/forms/form/index.js +10 -0
  219. package/dist/forms/index.d.ts +6 -0
  220. package/dist/forms/index.js +6 -0
  221. package/dist/forms/input/index.d.ts +1 -1
  222. package/dist/forms/input/index.js +6 -2
  223. package/dist/forms/input/input.d.ts +23 -3
  224. package/dist/forms/input/input.js +78 -7
  225. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  226. package/dist/forms/internal/listbox-items.d.ts +18 -0
  227. package/dist/forms/internal/listbox-items.js +88 -0
  228. package/dist/forms/internal/listbox.d.ts +44 -0
  229. package/dist/forms/internal/listbox.js +74 -0
  230. package/dist/forms/number-stepper/model.d.ts +16 -0
  231. package/dist/forms/number-stepper/model.js +23 -0
  232. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  233. package/dist/forms/number-stepper/number-stepper.js +86 -37
  234. package/dist/forms/select-menu/index.d.ts +1 -0
  235. package/dist/forms/select-menu/index.js +6 -0
  236. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  237. package/dist/forms/select-menu/select-menu.js +230 -0
  238. package/dist/glass/crystal-map.d.ts +70 -0
  239. package/dist/glass/crystal-map.js +88 -0
  240. package/dist/glass/displacement-map.d.ts +117 -0
  241. package/dist/glass/displacement-map.js +201 -0
  242. package/dist/glass/index.d.ts +8 -0
  243. package/dist/glass/index.js +63 -0
  244. package/dist/glass/lens-crystal.d.ts +29 -0
  245. package/dist/glass/lens-crystal.js +161 -0
  246. package/dist/glass/lens-dispersion.d.ts +11 -0
  247. package/dist/glass/lens-dispersion.js +19 -0
  248. package/dist/glass/liquid-glass.d.ts +41 -0
  249. package/dist/glass/liquid-glass.js +256 -0
  250. package/dist/glass/liquid-motion.d.ts +53 -0
  251. package/dist/glass/liquid-motion.js +302 -0
  252. package/dist/glass/liquid-options.d.ts +162 -0
  253. package/dist/glass/liquid-options.js +179 -0
  254. package/dist/glass/refraction.d.ts +100 -0
  255. package/dist/glass/refraction.js +714 -0
  256. package/dist/glass/specular-map.d.ts +26 -0
  257. package/dist/glass/specular-map.js +75 -0
  258. package/dist/glass/spring.d.ts +79 -0
  259. package/dist/glass/spring.js +58 -0
  260. package/dist/glass/support.d.ts +13 -0
  261. package/dist/glass/support.js +14 -0
  262. package/dist/glass/use-glass-refraction.d.ts +8 -0
  263. package/dist/glass/use-glass-refraction.js +16 -0
  264. package/dist/i18n/strings.d.ts +113 -0
  265. package/dist/i18n/strings.js +70 -2
  266. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  267. package/dist/i18n/ui-strings-provider.js +6 -2
  268. package/dist/icons/index.d.ts +2 -0
  269. package/dist/icons/index.js +4 -0
  270. package/dist/icons/key.d.ts +2 -0
  271. package/dist/icons/key.js +12 -0
  272. package/dist/icons/webhook.d.ts +2 -0
  273. package/dist/icons/webhook.js +12 -0
  274. package/dist/liquid/index.d.ts +3 -0
  275. package/dist/liquid/index.js +29 -0
  276. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  277. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  278. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  279. package/dist/navigation/breadcrumbs/index.js +6 -0
  280. package/dist/navigation/index.d.ts +2 -0
  281. package/dist/navigation/index.js +2 -0
  282. package/dist/navigation/segmented/index.d.ts +1 -1
  283. package/dist/navigation/segmented/model.d.ts +5 -0
  284. package/dist/navigation/segmented/model.js +6 -0
  285. package/dist/navigation/segmented/segmented.d.ts +17 -3
  286. package/dist/navigation/segmented/segmented.js +20 -4
  287. package/dist/navigation/stepper/index.d.ts +1 -1
  288. package/dist/navigation/stepper/index.js +3 -1
  289. package/dist/navigation/stepper/stepper.d.ts +8 -0
  290. package/dist/navigation/stepper/stepper.js +68 -45
  291. package/dist/navigation/tabs/index.d.ts +1 -0
  292. package/dist/navigation/tabs/index.js +6 -0
  293. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  294. package/dist/navigation/tabs/tabs-nav.js +57 -0
  295. package/dist/navigation/wizard/index.d.ts +1 -0
  296. package/dist/navigation/wizard/index.js +6 -0
  297. package/dist/navigation/wizard/model.d.ts +33 -0
  298. package/dist/navigation/wizard/model.js +34 -0
  299. package/dist/navigation/wizard/wizard.d.ts +45 -0
  300. package/dist/navigation/wizard/wizard.js +169 -0
  301. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  302. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  303. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  304. package/dist/overlays/alert-dialog/index.js +26 -0
  305. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  306. package/dist/overlays/context-menu/context-menu.js +4 -1
  307. package/dist/overlays/dialog/dialog.d.ts +9 -1
  308. package/dist/overlays/dialog/dialog.js +3 -0
  309. package/dist/overlays/drawer/drawer.d.ts +9 -1
  310. package/dist/overlays/drawer/drawer.js +3 -0
  311. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +25 -1
  312. package/dist/overlays/dropdown-menu/dropdown-menu.js +14 -4
  313. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  314. package/dist/overlays/dropdown-menu/index.js +8 -2
  315. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  316. package/dist/overlays/hover-card/hover-card.js +4 -1
  317. package/dist/overlays/index.d.ts +2 -0
  318. package/dist/overlays/index.js +2 -0
  319. package/dist/overlays/popover/popover.d.ts +9 -1
  320. package/dist/overlays/popover/popover.js +3 -0
  321. package/dist/overlays/testing/index.d.ts +5 -0
  322. package/dist/overlays/testing/index.js +4 -0
  323. package/dist/overlays/toaster/index.d.ts +2 -1
  324. package/dist/overlays/toaster/index.js +4 -2
  325. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  326. package/dist/overlays/toaster/toast.d.ts +3 -0
  327. package/dist/overlays/toaster/toast.js +3 -0
  328. package/dist/overlays/toaster/toaster.d.ts +3 -0
  329. package/dist/overlays/toaster/toaster.js +36 -3
  330. package/dist/overlays/tooltip/index.d.ts +1 -0
  331. package/dist/overlays/tooltip/index.js +4 -0
  332. package/dist/overlays/tooltip/model.d.ts +10 -0
  333. package/dist/overlays/tooltip/model.js +13 -0
  334. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  335. package/dist/overlays/tooltip/tooltip.js +116 -0
  336. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  337. package/dist/palette/command-palette/command-palette.js +5 -0
  338. package/dist/primitives/command/command.d.ts +3 -2
  339. package/dist/primitives/command/command.js +2 -0
  340. package/dist/primitives/menu/menu.js +1 -1
  341. package/dist/primitives/popper/popper.js +5 -0
  342. package/dist/primitives/use-dismissable-layer.js +1 -1
  343. package/dist/rich-text/rich-text-editor.js +94 -8
  344. package/dist/rich-text/sanitize.js +70 -20
  345. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  346. package/dist/shell/app-shell/app-shell.js +44 -4
  347. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  348. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  349. package/dist/shell/bottom-nav/index.d.ts +2 -0
  350. package/dist/shell/bottom-nav/index.js +9 -0
  351. package/dist/shell/bottom-nav/split.d.ts +11 -0
  352. package/dist/shell/bottom-nav/split.js +10 -0
  353. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  354. package/dist/shell/sidebar/sidebar.js +46 -4
  355. package/dist/shell/topbar/topbar.d.ts +20 -9
  356. package/dist/shell/topbar/topbar.js +16 -9
  357. package/dist/states/empty-state/empty-state.d.ts +3 -1
  358. package/dist/states/empty-state/empty-state.js +9 -1
  359. package/dist/states/error-state/error-state.d.ts +8 -1
  360. package/dist/states/error-state/error-state.js +15 -9
  361. package/dist/states/index.d.ts +1 -0
  362. package/dist/states/index.js +1 -0
  363. package/dist/states/live-status-bar/index.d.ts +1 -0
  364. package/dist/states/live-status-bar/index.js +6 -0
  365. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  366. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  367. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  368. package/dist/states/offline-banner/offline-banner.js +8 -4
  369. package/dist/states/skeleton/skeleton.d.ts +8 -2
  370. package/dist/states/skeleton/skeleton.js +44 -2
  371. package/dist/utils/class-groups.js +17 -0
  372. package/dist/utils/index.d.ts +1 -0
  373. package/dist/utils/index.js +2 -0
  374. package/dist/utils/material.d.ts +13 -0
  375. package/dist/utils/material.js +6 -0
  376. package/dist/utils/tone.d.ts +8 -0
  377. package/dist/utils/tone.js +17 -0
  378. package/dist/utils/use-copy.d.ts +5 -0
  379. package/dist/utils/use-copy.js +35 -0
  380. package/icons/svg/key.svg +5 -0
  381. package/icons/svg/webhook.svg +5 -0
  382. package/package.json +31 -21
  383. package/scripts/build-theme.d.mts +22 -0
  384. package/scripts/build-theme.mjs +248 -5
  385. package/src/ai/attachment/attachment.tsx +1 -1
  386. package/src/ai/chat-list/group.ts +3 -1
  387. package/src/ai/conversation/conversation.tsx +1 -1
  388. package/src/ai/internal/use-copy.ts +1 -38
  389. package/src/ai/markdown/parse.ts +74 -17
  390. package/src/ai/source/source.tsx +1 -1
  391. package/src/atoms/avatar/avatar.tsx +57 -4
  392. package/src/atoms/avatar/index.ts +8 -1
  393. package/src/atoms/button/button.tsx +8 -3
  394. package/src/atoms/checkbox/checkbox.tsx +33 -4
  395. package/src/atoms/chip/chip.tsx +55 -8
  396. package/src/atoms/chip/index.ts +9 -1
  397. package/src/atoms/due-chip/due-chip.tsx +75 -0
  398. package/src/atoms/due-chip/index.ts +2 -0
  399. package/src/atoms/due-chip/model.ts +67 -0
  400. package/src/atoms/icon-button/icon-button.tsx +58 -0
  401. package/src/atoms/icon-button/index.ts +6 -0
  402. package/src/atoms/index.ts +5 -0
  403. package/src/atoms/internal/hit-area.ts +7 -0
  404. package/src/atoms/kbd/index.ts +1 -0
  405. package/src/atoms/kbd/kbd.tsx +20 -0
  406. package/src/atoms/radio-group/radio-group.tsx +8 -2
  407. package/src/atoms/seal/index.ts +1 -0
  408. package/src/atoms/seal/seal.tsx +107 -0
  409. package/src/atoms/spinner/index.ts +1 -0
  410. package/src/atoms/spinner/spinner.tsx +49 -0
  411. package/src/atoms/status-dot/index.ts +1 -0
  412. package/src/atoms/status-dot/status-dot.tsx +15 -3
  413. package/src/atoms/switch/switch.tsx +3 -1
  414. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  415. package/src/calendar/date-calendar/index.ts +5 -0
  416. package/src/calendar/index.ts +1 -0
  417. package/src/calendar/internal/date-utils.ts +115 -0
  418. package/src/charts/README.md +21 -0
  419. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  420. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  421. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  422. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  423. package/src/charts/core/cartesian/layout.ts +29 -10
  424. package/src/charts/core/cartesian/marks.tsx +3 -3
  425. package/src/charts/core/cartesian/types.ts +30 -2
  426. package/src/charts/core/category-explorer.tsx +12 -6
  427. package/src/charts/core/chart-dock.tsx +68 -0
  428. package/src/charts/core/chart-frame.tsx +116 -27
  429. package/src/charts/core/distribution/explorer.tsx +17 -7
  430. package/src/charts/core/distribution/xy-points.tsx +1 -1
  431. package/src/charts/core/index.ts +3 -0
  432. package/src/charts/core/leave-grace.ts +35 -0
  433. package/src/charts/core/nearest.ts +38 -0
  434. package/src/charts/core/plot-overlay.tsx +9 -3
  435. package/src/charts/core/pointer.test-utils.ts +146 -0
  436. package/src/charts/core/tooltip.tsx +129 -15
  437. package/src/charts/core/touch-select.ts +250 -0
  438. package/src/charts/core/types.ts +13 -4
  439. package/src/charts/core/use-index-navigation.ts +70 -11
  440. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  441. package/src/charts/donut-chart/slice-labels.ts +39 -0
  442. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  443. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  444. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  445. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  446. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  447. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  448. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  449. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  450. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  451. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  452. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  453. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  454. package/src/charts/progress-units/progress-units.tsx +1 -0
  455. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  456. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  457. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  458. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  459. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  460. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  461. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  462. package/src/containers/action-bar/action-bar.tsx +13 -2
  463. package/src/containers/aside/aside.tsx +40 -0
  464. package/src/containers/aside/index.ts +1 -0
  465. package/src/containers/banner/banner.tsx +18 -1
  466. package/src/containers/card/card.tsx +43 -4
  467. package/src/containers/description-list/description-list.tsx +85 -9
  468. package/src/containers/feed/feed.tsx +99 -0
  469. package/src/containers/feed/index.ts +8 -0
  470. package/src/containers/feed/model.ts +54 -0
  471. package/src/containers/grid/grid.tsx +37 -0
  472. package/src/containers/grid/index.ts +1 -0
  473. package/src/containers/index.ts +9 -0
  474. package/src/containers/kpi/kpi.tsx +231 -38
  475. package/src/containers/kpi-group/index.ts +7 -1
  476. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  477. package/src/containers/list-detail/index.ts +15 -0
  478. package/src/containers/list-detail/list-detail.tsx +293 -0
  479. package/src/containers/note/index.ts +1 -0
  480. package/src/containers/note/note.tsx +38 -0
  481. package/src/containers/page/index.ts +1 -0
  482. package/src/containers/page/page.tsx +17 -0
  483. package/src/containers/page-header/page-header.tsx +38 -8
  484. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  485. package/src/containers/section/index.ts +11 -0
  486. package/src/containers/section/section.tsx +281 -0
  487. package/src/containers/shortcuts/index.ts +6 -0
  488. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  489. package/src/containers/stack/index.ts +7 -0
  490. package/src/containers/stack/stack.tsx +55 -0
  491. package/src/containers/table/selection.ts +26 -0
  492. package/src/containers/table/table.tsx +215 -13
  493. package/src/containers/timeline/index.ts +3 -0
  494. package/src/containers/timeline/timeline.tsx +204 -93
  495. package/src/forms/chip-group/chip-group.tsx +184 -0
  496. package/src/forms/chip-group/index.ts +8 -0
  497. package/src/forms/combobox/combobox.tsx +359 -0
  498. package/src/forms/combobox/index.ts +7 -0
  499. package/src/forms/copy-field/copy-field.tsx +88 -0
  500. package/src/forms/copy-field/index.ts +1 -0
  501. package/src/forms/date-picker/date-picker.tsx +239 -0
  502. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  503. package/src/forms/date-picker/index.ts +10 -0
  504. package/src/forms/date-picker/model.ts +108 -0
  505. package/src/forms/dropzone/dropzone.tsx +217 -35
  506. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  507. package/src/forms/field/field.tsx +72 -7
  508. package/src/forms/form/form.tsx +46 -0
  509. package/src/forms/form/index.ts +8 -0
  510. package/src/forms/index.ts +6 -0
  511. package/src/forms/input/index.ts +8 -1
  512. package/src/forms/input/input.tsx +103 -7
  513. package/src/forms/input-icon/input-icon.tsx +1 -1
  514. package/src/forms/internal/listbox-items.tsx +103 -0
  515. package/src/forms/internal/listbox.ts +124 -0
  516. package/src/forms/number-stepper/model.ts +35 -0
  517. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  518. package/src/forms/select-menu/index.ts +7 -0
  519. package/src/forms/select-menu/select-menu.tsx +280 -0
  520. package/src/glass/crystal-map.ts +150 -0
  521. package/src/glass/displacement-map.ts +317 -0
  522. package/src/glass/index.ts +43 -0
  523. package/src/glass/lens-crystal.ts +226 -0
  524. package/src/glass/lens-dispersion.ts +34 -0
  525. package/src/glass/liquid-glass.tsx +371 -0
  526. package/src/glass/liquid-motion.ts +395 -0
  527. package/src/glass/liquid-options.ts +306 -0
  528. package/src/glass/refraction.ts +1010 -0
  529. package/src/glass/specular-map.ts +95 -0
  530. package/src/glass/spring.ts +98 -0
  531. package/src/glass/support.ts +27 -0
  532. package/src/glass/use-glass-refraction.ts +21 -0
  533. package/src/i18n/strings.ts +113 -0
  534. package/src/i18n/ui-strings-provider.tsx +15 -4
  535. package/src/icons/index.ts +2 -0
  536. package/src/icons/key.tsx +13 -0
  537. package/src/icons/webhook.tsx +13 -0
  538. package/src/liquid/index.ts +24 -0
  539. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  540. package/src/navigation/breadcrumbs/index.ts +8 -0
  541. package/src/navigation/index.ts +2 -0
  542. package/src/navigation/segmented/index.ts +1 -0
  543. package/src/navigation/segmented/model.ts +11 -0
  544. package/src/navigation/segmented/segmented.tsx +45 -6
  545. package/src/navigation/stepper/index.ts +7 -1
  546. package/src/navigation/stepper/stepper.tsx +41 -5
  547. package/src/navigation/tabs/index.ts +7 -0
  548. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  549. package/src/navigation/wizard/index.ts +7 -0
  550. package/src/navigation/wizard/model.ts +61 -0
  551. package/src/navigation/wizard/wizard.tsx +222 -0
  552. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  553. package/src/overlays/alert-dialog/index.ts +19 -0
  554. package/src/overlays/context-menu/context-menu.tsx +11 -1
  555. package/src/overlays/dialog/dialog.tsx +10 -0
  556. package/src/overlays/drawer/drawer.tsx +10 -0
  557. package/src/overlays/dropdown-menu/dropdown-menu.tsx +38 -4
  558. package/src/overlays/dropdown-menu/index.ts +3 -0
  559. package/src/overlays/hover-card/hover-card.tsx +12 -1
  560. package/src/overlays/index.ts +2 -0
  561. package/src/overlays/popover/popover.tsx +10 -0
  562. package/src/overlays/testing/index.ts +5 -0
  563. package/src/overlays/toaster/index.ts +2 -0
  564. package/src/overlays/toaster/toast-store.ts +6 -2
  565. package/src/overlays/toaster/toast.ts +6 -0
  566. package/src/overlays/toaster/toaster.tsx +44 -2
  567. package/src/overlays/tooltip/index.ts +1 -0
  568. package/src/overlays/tooltip/model.ts +18 -0
  569. package/src/overlays/tooltip/tooltip.tsx +166 -0
  570. package/src/palette/command-palette/command-palette.tsx +15 -1
  571. package/src/primitives/command/command.tsx +4 -0
  572. package/src/primitives/menu/menu.tsx +1 -1
  573. package/src/primitives/popper/popper.tsx +10 -0
  574. package/src/primitives/use-dismissable-layer.ts +7 -2
  575. package/src/rich-text/rich-text-editor.tsx +116 -13
  576. package/src/rich-text/sanitize.ts +94 -23
  577. package/src/shell/app-shell/app-shell.tsx +60 -4
  578. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  579. package/src/shell/bottom-nav/index.ts +8 -0
  580. package/src/shell/bottom-nav/split.ts +20 -0
  581. package/src/shell/sidebar/sidebar.tsx +51 -5
  582. package/src/shell/topbar/topbar.tsx +81 -58
  583. package/src/states/empty-state/empty-state.tsx +11 -1
  584. package/src/states/error-state/error-state.tsx +23 -8
  585. package/src/states/index.ts +1 -0
  586. package/src/states/live-status-bar/index.ts +6 -0
  587. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  588. package/src/states/offline-banner/offline-banner.tsx +13 -5
  589. package/src/states/skeleton/skeleton.tsx +68 -2
  590. package/src/utils/class-groups.ts +17 -0
  591. package/src/utils/index.ts +1 -0
  592. package/src/utils/material.ts +16 -0
  593. package/src/utils/tone.ts +29 -0
  594. package/src/utils/use-copy.ts +38 -0
  595. package/styles/Theme.kt +64 -3
  596. package/styles/base.css +51 -0
  597. package/styles/tailwind.css +836 -0
  598. package/styles/theme.css +579 -34
  599. package/styles/tokens.css +788 -15
  600. package/tokens/default.json +918 -29
  601. package/scripts/build-theme.d.ts +0 -18
@@ -1,5 +1,6 @@
1
1
  export {
2
2
  DropdownMenu,
3
+ DropdownMenuAnchor,
3
4
  DropdownMenuArrow,
4
5
  DropdownMenuCheckboxItem,
5
6
  type DropdownMenuCheckboxItemProps,
@@ -20,4 +21,6 @@ export {
20
21
  DropdownMenuSubTrigger,
21
22
  type DropdownMenuSubTriggerProps,
22
23
  DropdownMenuTrigger,
24
+ dropdownMenuItemClasses,
25
+ dropdownMenuSurfaceClasses,
23
26
  } from "./dropdown-menu.js";
@@ -16,6 +16,7 @@ import {
16
16
  } from "react";
17
17
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
18
18
  import { cn } from "../../utils/cn.js";
19
+ import { type Material, materialClass } from "../../utils/material.js";
19
20
  import { Slot } from "../../utils/slot.js";
20
21
 
21
22
  interface HoverCardContextValue {
@@ -141,6 +142,14 @@ export interface HoverCardContentProps
141
142
  extends Omit<PopoverPrimitive.PopoverContentProps, "onOpenAutoFocus"> {
142
143
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
143
144
  container?: HTMLElement | null;
145
+ /**
146
+ * Surface material. Omitted keeps the overlay surface (`surface-overlay`: glass in the `glass`
147
+ * preset, opaque elsewhere); `"solid"` forces the opaque `surface-solid` fill; `"glass"` and
148
+ * `"glass-clear"` are frosted glass, `"liquid"` and `"liquid-clear"` Liquid Glass (with its
149
+ * fallbacks). Liquid options go in `style` (`liquidStyle()` from
150
+ * `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
151
+ */
152
+ material?: Material;
144
153
  }
145
154
 
146
155
  export function HoverCardContent({
@@ -151,6 +160,7 @@ export function HoverCardContent({
151
160
  onMouseLeave,
152
161
  onCloseAutoFocus,
153
162
  container,
163
+ material,
154
164
  ...props
155
165
  }: HoverCardContentProps) {
156
166
  const card = useHoverCard();
@@ -176,7 +186,8 @@ export function HoverCardContent({
176
186
  card.schedule(false, card.closeDelay);
177
187
  }}
178
188
  className={cn(
179
- "z-85 w-72 max-w-(--ui-popper-available-width) rounded-popover border-card surface-overlay bg-surface-overlay p-card text-body text-ink shadow-overlay",
189
+ "z-85 w-72 max-w-(--ui-popper-available-width) rounded-popover border-card surface-overlay p-card text-body text-ink shadow-overlay",
190
+ materialClass(material, "surface-solid"),
180
191
  className,
181
192
  )}
182
193
  {...props}
@@ -1,3 +1,4 @@
1
+ export * from "./alert-dialog/index.js";
1
2
  export * from "./context-menu/index.js";
2
3
  export * from "./dialog/index.js";
3
4
  export * from "./drawer/index.js";
@@ -6,3 +7,4 @@ export * from "./focus-return/index.js";
6
7
  export * from "./hover-card/index.js";
7
8
  export * from "./popover/index.js";
8
9
  export * from "./toaster/index.js";
10
+ export * from "./tooltip/index.js";
@@ -2,6 +2,7 @@
2
2
 
3
3
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
4
4
  import { cn } from "../../utils/cn.js";
5
+ import { type Material, materialClass } from "../../utils/material.js";
5
6
 
6
7
  export const Popover = PopoverPrimitive.Root;
7
8
  export const PopoverTrigger = PopoverPrimitive.Trigger;
@@ -12,6 +13,13 @@ export const PopoverArrow = PopoverPrimitive.Arrow;
12
13
  export interface PopoverContentProps extends PopoverPrimitive.PopoverContentProps {
13
14
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
14
15
  container?: HTMLElement | null;
16
+ /**
17
+ * Surface material. Omitted keeps the default for this layer; `"glass"` and `"glass-clear"`
18
+ * are frosted glass, `"liquid"` and `"liquid-clear"` Liquid Glass (with its fallbacks), `"solid"`
19
+ * forces an opaque surface. Liquid options go in `style` (`liquidStyle()` from
20
+ * `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
21
+ */
22
+ material?: Material;
15
23
  }
16
24
 
17
25
  /** Positioned contextual panel; flips and shifts to stay inside the viewport. */
@@ -20,6 +28,7 @@ export function PopoverContent({
20
28
  sideOffset = 6,
21
29
  collisionPadding = 8,
22
30
  container,
31
+ material,
23
32
  ...props
24
33
  }: PopoverContentProps) {
25
34
  return (
@@ -29,6 +38,7 @@ export function PopoverContent({
29
38
  collisionPadding={collisionPadding}
30
39
  className={cn(
31
40
  "z-85 min-w-[min(14.375rem,var(--ui-popper-available-width))] max-h-(--ui-popper-available-height) max-w-(--ui-popper-available-width) overflow-y-auto rounded-popover surface-overlay p-1.5 text-ink shadow-overlay",
41
+ materialClass(material, "surface-solid"),
32
42
  className,
33
43
  )}
34
44
  {...props}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Test-only helpers for overlays, kept off the main `@jcsoftdev/ui/overlays` entry so production
3
+ * bundles never carry them: `import { resetToasts } from "@jcsoftdev/ui/overlays/testing"`.
4
+ */
5
+ export { reset as resetToasts } from "../toaster/toast-store.js";
@@ -1,3 +1,4 @@
1
+ export type { ToastTone } from "./toast-store.js";
1
2
  export {
2
3
  type ToastAction,
3
4
  Toaster,
@@ -6,4 +7,5 @@ export {
6
7
  type ToasterProps,
7
8
  type ToastOptions,
8
9
  toast,
10
+ toastToneClasses,
9
11
  } from "./toaster.js";
@@ -1,6 +1,7 @@
1
1
  import type { ReactNode } from "react";
2
2
 
3
- export type ToastTone = "default" | "success" | "error";
3
+ /** `error` is the danger toast (kept under its original name); `info` and `warning` are neutral-status additions. */
4
+ export type ToastTone = "default" | "success" | "error" | "info" | "warning";
4
5
 
5
6
  export interface ToastAction {
6
7
  label: ReactNode;
@@ -93,7 +94,10 @@ export function selectVisible(list: readonly ToastRecord[], limit: number): Toas
93
94
  return list.filter((t) => t.state === "closed" || shown.has(t));
94
95
  }
95
96
 
96
- /** Test hook: empties the store without notifying callbacks. */
97
+ /**
98
+ * Test hook: empties the store and resets the id counter. Mounted toasters clear at once;
99
+ * `onDismiss` callbacks do not run. Public as `resetToasts` from `@jcsoftdev/ui/overlays/testing`.
100
+ */
97
101
  export function reset() {
98
102
  counter = 0;
99
103
  commit(EMPTY);
@@ -13,6 +13,12 @@ toast.success = (message: ReactNode, options?: ToastOptions): ToastId =>
13
13
  publish(message, "success", options);
14
14
  toast.error = (message: ReactNode, options?: ToastOptions): ToastId =>
15
15
  publish(message, "error", options);
16
+ toast.info = (message: ReactNode, options?: ToastOptions): ToastId =>
17
+ publish(message, "info", options);
18
+ toast.warning = (message: ReactNode, options?: ToastOptions): ToastId =>
19
+ publish(message, "warning", options);
20
+ /** Same toast as `toast.error`, under the status-tone name the other components use. */
21
+ toast.danger = toast.error;
16
22
  toast.dismiss = (id?: ToastId): void => dismiss(id);
17
23
 
18
24
  export { toast };
@@ -8,6 +8,7 @@ import {
8
8
  useState,
9
9
  useSyncExternalStore,
10
10
  } from "react";
11
+ import { type StatusTone, statusIcon } from "../../atoms/internal/status-icons.js";
11
12
  import { useUiStrings } from "../../i18n/ui-strings-provider.js";
12
13
  import { Portal } from "../../primitives/portal.js";
13
14
  import type { ClassNames } from "../../utils/class-names.js";
@@ -21,6 +22,7 @@ import {
21
22
  selectVisible,
22
23
  subscribe,
23
24
  type ToastRecord,
25
+ type ToastTone,
24
26
  } from "./toast-store.js";
25
27
 
26
28
  export type { ToastAction, ToastOptions } from "./toast.js";
@@ -56,6 +58,38 @@ export interface ToasterProps {
56
58
  dir?: "ltr" | "rtl";
57
59
  }
58
60
 
61
+ /** Class map behind each tone. `default` is the inverted neutral toast; the others tint the surface. */
62
+ export const toastToneClasses: Readonly<Record<ToastTone, string>> = {
63
+ default: "bg-toast-bg text-toast-ink",
64
+ success: "border border-success/40 bg-success-soft text-ink",
65
+ info: "border border-info/40 bg-info-soft text-ink",
66
+ warning: "border border-warning/40 bg-warning-soft text-ink",
67
+ error: "border border-danger/40 bg-danger-soft text-ink",
68
+ };
69
+
70
+ const toneActionClasses: Readonly<Record<ToastTone, string>> = {
71
+ default: "bg-toast-ink/18 text-toast-ink",
72
+ success: "bg-ink/10 text-ink hover:bg-ink/15",
73
+ info: "bg-ink/10 text-ink hover:bg-ink/15",
74
+ warning: "bg-ink/10 text-ink hover:bg-ink/15",
75
+ error: "bg-ink/10 text-ink hover:bg-ink/15",
76
+ };
77
+
78
+ const toneGlyph: Readonly<Record<ToastTone, StatusTone | null>> = {
79
+ default: null,
80
+ success: "success",
81
+ info: "info",
82
+ warning: "warning",
83
+ error: "danger",
84
+ };
85
+
86
+ const toneGlyphColor: Readonly<Record<StatusTone, string>> = {
87
+ success: "text-success",
88
+ info: "text-info",
89
+ warning: "text-warning",
90
+ danger: "text-danger",
91
+ };
92
+
59
93
  const EXIT_MS = 200;
60
94
  const SWIPE_THRESHOLD = 60;
61
95
 
@@ -164,6 +198,7 @@ function ToastItem({ record, duration, reducedMotion, classNames }: ToastItemPro
164
198
  };
165
199
 
166
200
  const isError = tone === "error";
201
+ const glyph = toneGlyph[tone];
167
202
  const closed = state === "closed";
168
203
  const swiping = dragX !== 0;
169
204
 
@@ -193,7 +228,8 @@ function ToastItem({ record, duration, reducedMotion, classNames }: ToastItemPro
193
228
  : undefined
194
229
  }
195
230
  className={cn(
196
- "pointer-events-auto flex min-h-11 w-max max-w-[min(92vw,26rem)] touch-pan-y items-center gap-3 rounded-button bg-toast-bg py-1.5 pr-2 pl-4 text-control text-toast-ink shadow-overlay",
231
+ "pointer-events-auto flex min-h-11 w-max max-w-[min(92vw,26rem)] touch-pan-y items-center gap-3 rounded-button py-1.5 pr-2 pl-4 text-control shadow-overlay",
232
+ toastToneClasses[tone],
197
233
  "transition-[opacity,transform] duration-200 ease-out motion-reduce:transition-none",
198
234
  !entered && "opacity-0 data-[state=open]:translate-y-2",
199
235
  closed && "opacity-0",
@@ -201,6 +237,11 @@ function ToastItem({ record, duration, reducedMotion, classNames }: ToastItemPro
201
237
  classNames?.toast,
202
238
  )}
203
239
  >
240
+ {glyph ? (
241
+ <span data-slot="glyph" className={cn("shrink-0", toneGlyphColor[glyph])}>
242
+ {statusIcon(glyph, "size-4")}
243
+ </span>
244
+ ) : null}
204
245
  <div className="min-w-0 flex-1">
205
246
  <div className={classNames?.title}>{record.message}</div>
206
247
  {record.description ? (
@@ -211,7 +252,8 @@ function ToastItem({ record, duration, reducedMotion, classNames }: ToastItemPro
211
252
  <button
212
253
  type="button"
213
254
  className={cn(
214
- "h-8 shrink-0 rounded-button bg-toast-ink/18 px-3 font-bold text-toast-ink focus-ring",
255
+ "h-8 shrink-0 rounded-button px-3 font-bold focus-ring",
256
+ toneActionClasses[tone],
215
257
  classNames?.action,
216
258
  )}
217
259
  onClick={(event) => {
@@ -0,0 +1 @@
1
+ export { Tooltip, type TooltipPart, type TooltipProps } from "./tooltip.js";
@@ -0,0 +1,18 @@
1
+ /** Hover opens a tooltip for a mouse or pen, never for a finger: a tap must reach the control. */
2
+ export function opensOnHover(pointerType: string): boolean {
3
+ return pointerType !== "touch";
4
+ }
5
+
6
+ /**
7
+ * Focus opens a tooltip only when it came from the keyboard (`:focus-visible`) and not from a
8
+ * press that has just closed it, so clicking a button never makes its tooltip flicker back.
9
+ */
10
+ export function opensOnFocus({
11
+ pressed,
12
+ focusVisible,
13
+ }: {
14
+ pressed: boolean;
15
+ focusVisible: boolean;
16
+ }): boolean {
17
+ return focusVisible && !pressed;
18
+ }
@@ -0,0 +1,166 @@
1
+ "use client";
2
+
3
+ import {
4
+ type FocusEvent,
5
+ type PointerEvent,
6
+ type ReactElement,
7
+ type ReactNode,
8
+ useCallback,
9
+ useEffect,
10
+ useId,
11
+ useRef,
12
+ } from "react";
13
+ import { Kbd } from "../../atoms/kbd/kbd.js";
14
+ import * as PopoverPrimitive from "../../primitives/popover/popover.js";
15
+ import type { Align, Side } from "../../primitives/popper/geometry.js";
16
+ import type { ClassNames } from "../../utils/class-names.js";
17
+ import { cn } from "../../utils/cn.js";
18
+ import { type Material, materialClass } from "../../utils/material.js";
19
+ import { Slot } from "../../utils/slot.js";
20
+ import { useControllableState } from "../../utils/use-controllable-state.js";
21
+ import { opensOnFocus, opensOnHover } from "./model.js";
22
+
23
+ export type TooltipPart = "content" | "shortcut";
24
+
25
+ export interface TooltipProps {
26
+ /** The hint. It repeats or complements the trigger's name; never put information only here. */
27
+ content: ReactNode;
28
+ /** Keyboard shortcut shown next to the hint, rendered as a `Kbd`. */
29
+ shortcut?: ReactNode;
30
+ side?: Side;
31
+ align?: Align;
32
+ /** Gap between the trigger and the tooltip, in px. */
33
+ sideOffset?: number;
34
+ /** ms the pointer must rest on the trigger before the tooltip opens. Keyboard focus opens at once. */
35
+ openDelay?: number;
36
+ /** ms before closing after the pointer leaves, so it can travel onto the tooltip (WCAG 1.4.13). */
37
+ closeDelay?: number;
38
+ /** Controlled open state. */
39
+ open?: boolean;
40
+ defaultOpen?: boolean;
41
+ onOpenChange?: (open: boolean) => void;
42
+ /** Never show the tooltip, e.g. when the label is already visible. */
43
+ disabled?: boolean;
44
+ /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
45
+ container?: HTMLElement | null;
46
+ /** Surface material; see `PopoverContent`. */
47
+ material?: Material;
48
+ className?: string;
49
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the content and is merged last. */
50
+ classNames?: ClassNames<TooltipPart>;
51
+ /** The element that gets the tooltip. It receives `aria-describedby` while the tooltip is open. */
52
+ children: ReactElement;
53
+ }
54
+
55
+ function focusIsVisible(element: Element): boolean {
56
+ try {
57
+ return element.matches(":focus-visible");
58
+ } catch {
59
+ return true;
60
+ }
61
+ }
62
+
63
+ /**
64
+ * Short, non-interactive hint for a control. Opens on hover (after `openDelay`) and on keyboard
65
+ * focus, closes on Escape, blur, press and pointer leave. Touch never opens it by hover, so a tap
66
+ * always reaches the control. The trigger is described by it (`aria-describedby`), and the
67
+ * tooltip never takes focus.
68
+ */
69
+ export function Tooltip({
70
+ content,
71
+ shortcut,
72
+ side = "top",
73
+ align = "center",
74
+ sideOffset = 6,
75
+ openDelay = 300,
76
+ closeDelay = 100,
77
+ open: openProp,
78
+ defaultOpen = false,
79
+ onOpenChange,
80
+ disabled = false,
81
+ container,
82
+ material,
83
+ className,
84
+ classNames,
85
+ children,
86
+ }: TooltipProps) {
87
+ const [openState, setOpen] = useControllableState({
88
+ prop: openProp,
89
+ defaultProp: defaultOpen,
90
+ onChange: onOpenChange,
91
+ });
92
+ const open = openState && !disabled;
93
+ const contentId = useId();
94
+ const timer = useRef<number | undefined>(undefined);
95
+ const pressed = useRef(false);
96
+
97
+ const schedule = useCallback(
98
+ (next: boolean, delay: number) => {
99
+ window.clearTimeout(timer.current);
100
+ if (delay <= 0) setOpen(next);
101
+ else timer.current = window.setTimeout(() => setOpen(next), delay);
102
+ },
103
+ [setOpen],
104
+ );
105
+
106
+ useEffect(() => () => window.clearTimeout(timer.current), []);
107
+
108
+ const trigger = (
109
+ <Slot
110
+ aria-describedby={open ? contentId : undefined}
111
+ onPointerEnter={(event: PointerEvent<HTMLElement>) => {
112
+ if (opensOnHover(event.pointerType)) schedule(true, openDelay);
113
+ }}
114
+ onPointerLeave={(event: PointerEvent<HTMLElement>) => {
115
+ if (opensOnHover(event.pointerType)) schedule(false, closeDelay);
116
+ }}
117
+ onPointerDown={() => {
118
+ pressed.current = true;
119
+ schedule(false, 0);
120
+ }}
121
+ onFocus={(event: FocusEvent<HTMLElement>) => {
122
+ if (
123
+ opensOnFocus({ pressed: pressed.current, focusVisible: focusIsVisible(event.target) })
124
+ ) {
125
+ schedule(true, 0);
126
+ }
127
+ }}
128
+ onBlur={() => {
129
+ pressed.current = false;
130
+ schedule(false, 0);
131
+ }}
132
+ >
133
+ {children}
134
+ </Slot>
135
+ );
136
+
137
+ return (
138
+ <PopoverPrimitive.Root open={open} onOpenChange={setOpen}>
139
+ <PopoverPrimitive.Anchor asChild>{trigger}</PopoverPrimitive.Anchor>
140
+ <PopoverPrimitive.Portal container={container}>
141
+ <PopoverPrimitive.Content
142
+ id={contentId}
143
+ role="tooltip"
144
+ side={side}
145
+ align={align}
146
+ sideOffset={sideOffset}
147
+ collisionPadding={8}
148
+ // A hint: focus stays on the trigger, going in and out.
149
+ onOpenAutoFocus={(event) => event.preventDefault()}
150
+ onCloseAutoFocus={(event) => event.preventDefault()}
151
+ onMouseEnter={() => schedule(true, 0)}
152
+ onMouseLeave={() => schedule(false, closeDelay)}
153
+ className={cn(
154
+ "z-85 flex w-max max-w-[min(16rem,var(--ui-popper-available-width))] items-center gap-2 rounded-popover surface-overlay px-2.5 py-1.5 text-meta text-ink shadow-overlay",
155
+ materialClass(material, "surface-solid"),
156
+ classNames?.content,
157
+ className,
158
+ )}
159
+ >
160
+ <span className="min-w-0 break-words">{content}</span>
161
+ {shortcut === undefined ? null : <Kbd className={classNames?.shortcut}>{shortcut}</Kbd>}
162
+ </PopoverPrimitive.Content>
163
+ </PopoverPrimitive.Portal>
164
+ </PopoverPrimitive.Root>
165
+ );
166
+ }
@@ -1,10 +1,11 @@
1
1
  "use client";
2
2
 
3
- import type { ReactNode } from "react";
3
+ import type { CSSProperties, ReactNode } from "react";
4
4
  import { Search } from "../../icons/index.js";
5
5
  import * as Command from "../../primitives/command/command.js";
6
6
  import type { ClassNames } from "../../utils/class-names.js";
7
7
  import { cn } from "../../utils/cn.js";
8
+ import { type Material, materialClass } from "../../utils/material.js";
8
9
 
9
10
  export interface CommandPaletteItem {
10
11
  id: string;
@@ -48,7 +49,16 @@ export interface CommandPaletteProps {
48
49
  /** Controlled query, so the parent can react to typing (e.g. debounced remote search). */
49
50
  query?: string;
50
51
  onQueryChange?: (query: string) => void;
52
+ /**
53
+ * Surface material. Omitted keeps the default for this layer; `"glass"` and `"glass-clear"`
54
+ * are frosted glass, `"liquid"` and `"liquid-clear"` Liquid Glass (with its fallbacks), `"solid"`
55
+ * forces an opaque surface. Liquid options go in `style` (`liquidStyle()` from
56
+ * `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
57
+ */
58
+ material?: Material;
51
59
  className?: string;
60
+ /** Inline style of the root (for example `liquidStyle()` options). */
61
+ style?: CSSProperties;
52
62
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
53
63
  classNames?: ClassNames<CommandPalettePart>;
54
64
  }
@@ -84,7 +94,9 @@ export function CommandPalette({
84
94
  closeKeyLabel = "Esc",
85
95
  query,
86
96
  onQueryChange,
97
+ material,
87
98
  className,
99
+ style,
88
100
  classNames,
89
101
  }: CommandPaletteProps) {
90
102
  return (
@@ -97,9 +109,11 @@ export function CommandPalette({
97
109
  overlayClassName={cn("fixed inset-0 z-50 bg-scrim", classNames?.overlay)}
98
110
  contentClassName={cn(
99
111
  "@container/palette fixed top-[9vh] left-1/2 z-50 flex max-h-[70vh] w-[min(560px,calc(100vw-1rem))] -translate-x-1/2 flex-col overflow-hidden rounded-dialog surface-overlay shadow-overlay",
112
+ materialClass(material, "surface-solid"),
100
113
  classNames?.root,
101
114
  className,
102
115
  )}
116
+ contentStyle={style}
103
117
  >
104
118
  <div
105
119
  className={cn(
@@ -3,6 +3,7 @@
3
3
  import {
4
4
  type ChangeEvent,
5
5
  type ComponentProps,
6
+ type CSSProperties,
6
7
  createContext,
7
8
  type KeyboardEvent as ReactKeyboardEvent,
8
9
  type ReactNode,
@@ -572,6 +573,7 @@ export interface CommandDialogProps extends CommandRootProps {
572
573
  container?: HTMLElement | null;
573
574
  overlayClassName?: string;
574
575
  contentClassName?: string;
576
+ contentStyle?: CSSProperties;
575
577
  onOpenAutoFocus?: (event: Event) => void;
576
578
  onCloseAutoFocus?: (event: Event) => void;
577
579
  onEscapeKeyDown?: (event: KeyboardEvent) => void;
@@ -584,6 +586,7 @@ export function Dialog({
584
586
  container,
585
587
  overlayClassName,
586
588
  contentClassName,
589
+ contentStyle,
587
590
  onOpenAutoFocus,
588
591
  onCloseAutoFocus,
589
592
  onEscapeKeyDown,
@@ -604,6 +607,7 @@ export function Dialog({
604
607
  aria-labelledby={undefined}
605
608
  aria-describedby={undefined}
606
609
  className={contentClassName}
610
+ style={contentStyle}
607
611
  data-ui-command-dialog=""
608
612
  {...(onOpenAutoFocus ? { onOpenAutoFocus } : {})}
609
613
  {...(onCloseAutoFocus ? { onCloseAutoFocus } : {})}
@@ -515,7 +515,7 @@ function ContentImpl({
515
515
  tabIndex={-1}
516
516
  {...props}
517
517
  ref={ref ?? nodeRef}
518
- style={{ outline: "none", ...(root.modal ? { pointerEvents: "auto" } : null), ...style }}
518
+ style={root.modal ? { pointerEvents: "auto", ...style } : style}
519
519
  onPointerDownCapture={composeHandlers(
520
520
  onPointerDownCapture,
521
521
  layerProps.onPointerDownCapture,
@@ -168,6 +168,9 @@ function containingBlockOrigin(node: HTMLElement): { x: number; y: number } {
168
168
  return { x: 0, y: 0 };
169
169
  }
170
170
 
171
+ /** Surfaces that blur their backdrop: an overlay opened from inside one must not blur again. */
172
+ const GLASS_ANCESTORS = ".glass, .glass-clear, .liquid, .liquid-clear, .surface-overlay";
173
+
171
174
  export function Content({
172
175
  side = "bottom",
173
176
  align = "center",
@@ -202,6 +205,13 @@ export function Content({
202
205
  const paddingRef = useRef(collisionPadding);
203
206
  paddingRef.current = collisionPadding;
204
207
 
208
+ // A panel portaled out of a glass surface is not its DOM descendant, so the CSS nesting rule
209
+ // cannot see it: mark it so the glass utilities drop the second blur (glass on glass).
210
+ useLayoutEffect(() => {
211
+ if (!content || !anchor || typeof anchor.closest !== "function") return;
212
+ content.toggleAttribute("data-glass-nested", anchor.closest(GLASS_ANCESTORS) !== null);
213
+ }, [content, anchor]);
214
+
205
215
  // The wrapper owns the stacking context; the styled content decides its z-index.
206
216
  useLayoutEffect(() => {
207
217
  if (content && wrapperRef.current) {
@@ -27,8 +27,13 @@ export interface DismissableLayerOptions {
27
27
  onDismiss: () => void;
28
28
  }
29
29
 
30
- /** Layers from libraries outside this stack that can be open inside a dialog (a third-party combobox listbox). */
31
- const FOREIGN_LAYER = "[role=listbox][data-state=open], [role=combobox][aria-expanded=true]";
30
+ /**
31
+ * Layers from libraries outside this stack that can be open inside a dialog (a third-party combobox
32
+ * listbox). The library's own `SelectMenu` and `Combobox` carry `data-ui-layer` because their popup
33
+ * is a layer of this stack and Escape must reach it.
34
+ */
35
+ const FOREIGN_LAYER =
36
+ "[role=listbox][data-state=open]:not([data-ui-layer]), [role=combobox][aria-expanded=true]:not([data-ui-layer])";
32
37
 
33
38
  /**
34
39
  * Elements carrying this attribute are branches of every layer: pointer and focus