@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
package/CHANGELOG.md CHANGED
@@ -1,25 +1,383 @@
1
1
  # Changelog
2
2
 
3
- ## 0.2.3 (2026-10-13)
3
+ ## 0.4.0 (2026-10-21)
4
+
5
+ ### Blocks for application screens
6
+
7
+ New components, all additive and source compatible, with no new runtime dependency. Defaults come
8
+ from `UiStringsProvider` (en/es), layout follows container queries, and hit areas follow
9
+ `data-density="touch"`. Guide with examples: `/docs/blocks/`.
10
+
11
+ #### Added
12
+
13
+ - **Atoms.** `Spinner` (`size`, `label`, decorative `label={false}`), `Kbd`, `IconButton`
14
+ (required `label`, `variant`, `size`, `loading`, `asChild`, `iconButtonSizeClasses`), `DueChip`
15
+ (`date`, `today`, `soonDays`, `done`, `locale`) and `Seal` (`title`, `icon`, `tone`, `label`).
16
+ - **Overlays.** `Tooltip` (`content`, `shortcut`, `side`, `align`, `openDelay`, `closeDelay`,
17
+ controlled `open`) and `AlertDialog` (`role="alertdialog"`, `tone`, async `onConfirm` with a
18
+ pending state and inline failure message, focus on Cancel).
19
+ - **Forms.** `SelectMenu` (custom listbox select over `options`), `Combobox` (filter, async
20
+ `onSearchChange`, `loading`, `clearable`, `valueLabel`), `DatePicker` and `DateTimePicker` (ISO
21
+ values, `min`, `max`, `isDateDisabled`, locale-derived format and week start, time-zone safe) and
22
+ `ChipGroup` (multiple or single toggle chips with roving focus).
23
+ - **Calendar.** `DateCalendar`, the standalone keyboard date grid behind the pickers.
24
+ - **Navigation.** `Wizard` (`steps`, async `canAdvance`, `onBeforeNext`, `onComplete`) and
25
+ `TabsNav` / `TabsNavLink` (link strip with `aria-current="page"`, `renderLink`, `asChild`).
26
+ - **Containers.** `Section`, `Note`, `Aside` / `AsideHeader`, `ListDetail` (with its parts and
27
+ `useListDetail`), `Feed` / `FeedEvent` and `Shortcuts` / `ShortcutsItem`.
28
+ - **Banner `appearance="outline"`.** Page surface where only the border carries the tone (default
29
+ `soft`).
30
+ - **`DescriptionList`** `layout` (`auto`, `inline`, `stacked`), `columns` (1 to 3), `valueAlign` and
31
+ `DescriptionListItem` (dash placeholder for `null`, `undefined`, `false` and `""`).
32
+ - **`Chip` `size="sm"`** and `chipSizeClasses`; `ref` is a regular prop.
33
+ - **`Skeleton` variants** `list`, `kpis`, `key-value` and `bar`, with `count`.
34
+ - **`ErrorState` `actions`.**
35
+ - **Toast tones.** `toast.info`, `toast.warning`, `toast.danger` and `toastToneClasses`.
36
+ - **`resetToasts()`** in the new `@jcsoftdev/ui/overlays/testing` entry, for resetting the toast
37
+ store between tests.
38
+ - **Form gaps found while migrating an app.** `Input` takes `start` / `end` adornments, a
39
+ 30px `size="xs"` and `variant="bare"`; `Dropzone` has `mode="field"` (a real labelled
40
+ `<input type="file">` with `accept`, `multiple`, `onChange` and removable selections);
41
+ `NumberStepper` has a string mode (`mode="string"`: empty state, caller-owned text, change event);
42
+ `Field` accepts a node `label` and several children.
43
+ - **Table.** `flush` (`true`, `"start"`, `"end"`) drops the outer cell padding so the first and last
44
+ column sit on the container edge; `stickyHeader`; `maxHeight` (the capped wrapper is focusable);
45
+ row selection with `selectedKeys`, `defaultSelectedKeys`, `onSelectedKeysChange`, `rowKey` on
46
+ `TableRow` / `TableLinkRow` (`aria-selected`), `TableSelectCell` and `TableSelectAllCell` (checked,
47
+ mixed, unchecked); `TableActionsCell`, which wraps inline actions under a narrow table container
48
+ (a named container query) or swaps them for an overflow `menu` you pass.
49
+ - **Section parts.** `Section.Header`, `.Title`, `.Count`, `.Description`, `.Actions` and `.Body`
50
+ next to the props API; a part as a direct child switches to composed rendering.
51
+ - **Kpi parts and chrome.** `Kpi.Label`, `.Value` (`mono`, `suffix`, `trend`) and `.Description`;
52
+ `card` (border and radius); `trailing` (content at the end of the label row that stays exposed to
53
+ assistive tech, unlike the decorative `icon`).
54
+ - **Timeline** `status` per item (`done`, `current`, `error`, `pending`) with a glyph, a spoken state
55
+ and `aria-current="step"`, and `Timeline.Item` children next to `items`.
56
+ - **Stepper** `status` per step (`done`, `current`, `error`, `pending`) with a check or cross and a
57
+ spoken state; the default stays `current` for `currentStepId` and `pending` otherwise.
58
+ - **AlertDialog** `confirmDisabled` and `cancelDisabled`, and a compound API: `AlertDialog.Root`,
59
+ `.Trigger`, `.Content`, `.Header`, `.Title`, `.Description`, `.Body`, `.Footer`, `.Cancel` and
60
+ `.Action`. Cancel and Action close the dialog after their `onClick` unless it calls
61
+ `preventDefault()`; use the props API for an async confirm with a pending state.
62
+ - **ListDetail** `onBack`.
63
+ - **DueChip** `state` forces `overdue`, `soon`, `ok` or `done` whatever the date says.
64
+ - **Seal** `tone="institutional"` (strong neutral, ink frame) and any tone declared in
65
+ `tonePalettes`, by name, as `Kpi` does.
66
+ - **DropdownMenu** `bare` content (layering and size limits only, so a custom menu draws its own
67
+ surface), `DropdownMenuAnchor`, and `dropdownMenuItemClasses` / `dropdownMenuSurfaceClasses`.
68
+ - **UI strings** (en/es) for the new components: `noResults`, `clear`, `selectPlaceholder`,
69
+ `calendar`, `openCalendar`, `previousMonth`, `nextMonth`, `time`, `locale`, the day, month and
70
+ year placeholders, `back`, `next`, `finish`, `stepOf`, `steps`, `aside`, `backToList`, `overdue`,
71
+ `dueSoon`, `stepDone`, `stepError`, `selectRow`, `selectAll` and `rowActions`.
72
+
73
+ #### Changed (behavior to check when upgrading)
74
+
75
+ - **`ErrorState` markup.** The retry button now sits inside a wrapper `div` that also holds
76
+ `actions`. Selectors or tests that expect the button as a direct child need updating.
77
+ - **Toast tint.** Success and error toasts are tinted with their tone (`*-soft` surface, tone
78
+ border, status glyph) instead of the inverted neutral look. `default` is unchanged and roles are
79
+ unchanged (only error is an alert).
80
+ - **`Checkbox` and `Switch` touch target.** The 44px target is an invisible `::after` of the control
81
+ instead of a larger root, so under touch density the layout box is 40px (it was 44px) and the hit
82
+ target can overlap a neighbour by 2px per side. Default density is unchanged.
83
+ - **`Section` `divider` is off by default.** A kit whose section header always drew a hairline
84
+ needs `divider`.
85
+ - **`RadioGroup`** radios now carry `aria-labelledby` and `aria-describedby`, so they have
86
+ accessible names without relying on `<label for>`.
87
+ - **`theme.css` no longer emits self-referencing variables.** Entries such as
88
+ `--radius-input: var(--radius-input)` (radii, shadows, `--font-sans`) now sit in an
89
+ `@theme reference inline` block, so the utilities resolve to the raw token and nothing is declared
90
+ in Tailwind's theme layer. Consumers no longer need to reorder layers; verified on Tailwind 4.3.3.
91
+ - **Locale reaches the date pickers.** `UiStringsProvider` ignores `undefined` and empty entries
92
+ instead of letting them overwrite the preset, so `strings={{ locale: undefined }}` no longer sends
93
+ Intl to the system locale; its context is shared across duplicate module copies.
94
+ - **`Combobox` `required`** sets `aria-required` only and no longer blocks native submit before your
95
+ own validation; `nativeRequired` opts back in.
96
+ - **`Section` and titleless wrappers.** A `Section` with no title no longer takes a heading level or
97
+ tightens the spacing of what it wraps, so a titled section inside a wrapper keeps the level it
98
+ would have had without it (it moves up one level compared with the earlier 0.3.0 previews).
99
+ - **`ListDetail` back action.** It calls `onBack` and never `onValueChange(null)`; `onValueChange`
100
+ is typed `(value: string) => void`. Both only affect the earlier 0.3.0 previews, since `ListDetail`
101
+ is new in 0.3.0.
102
+ - **`Table` selected rows.** A row with a `rowKey` in a table with selection props reports
103
+ `aria-selected` and highlights; tables without selection props render as before.
104
+ - **Escape inside the library's own comboboxes.** The dismissable-layer primitive no longer treats
105
+ the library's own open `role="combobox"` widgets as a foreign layer, so Escape closes them.
106
+
107
+ ### Components for app shells
108
+
109
+ - **`Sidebar` rail.** `collapsed` turns the sidebar into an icons-only rail (labels as `title` tooltips and screen-reader text, badges as dots). It is ignored while the sidebar is a drawer, so the default behavior is unchanged.
110
+ - **`Chip` `onRemove`.** Appends a remove button named from the new `remove` UI string ("Remove" / "Quitar", or `removeLabel`), keyboard operable, with a 44px hit area under touch density.
111
+ - **`ResponsiveList` follows its own width.** It is a container (`@container/responsive-list`) and swaps cards for the table at 42rem of its own width instead of the viewport `md`, so it stays right in a narrow column or beside a sidebar.
112
+ - **`Input` `size="lg"`.** A thumb-friendly field at the height of the large `Button` (`h-control-lg`); `size` defaults to `md`. `size` is now the `md | lg` prop, no longer the native numeric attribute.
113
+ - **Key and Webhook icons.** `Key` and `Webhook` join the icon set (Lucide sources in `icons/svg`), with their lazy `<ui-icon>` glyphs.
114
+ ### Liquid Glass on phones
115
+
116
+ - **Cheaper lens maps.** The displacement and specular maps are rasterised at no more than 1.5
117
+ pixels per CSS pixel (they are smooth fields that `feImage` stretches), and a large surface drops
118
+ toward one, so a 3x phone no longer builds a map 4x the size of the surface on the main thread.
119
+ The specular map (contour and glint) keeps up to 1.5 even where the large-surface cap has taken
120
+ the refraction map down to one. The crystal map, which mostly covers the margin its layer clips
121
+ away, is lowered toward 48,000 pixels but never below half a pixel per CSS pixel (so a very
122
+ large layer can still exceed that). `computeCrystalField` now accepts a `dpr` from 0.5. The
123
+ whole-surface field computes its per-column terms once, with the same output. Sample positions use
124
+ the effective ratio after rounding the map size, so a fractional size no longer drifts.
125
+ - **Lens work is spread over frames.** The per-frame pass that installs and resizes lenses stops
126
+ after about 12 ms and leaves the rest for the next frame, so several lenses built at once no
127
+ longer land in one task. A single lens build still runs whole (the budget is checked between
128
+ tasks, not inside one), the leftover tasks run first in the next pass so one slow task cannot
129
+ starve the others, and a lens that is undone drops its pending work.
130
+ - **A crystal lens no longer drops while an ancestor changes.** `<LiquidGlass />` read the crystal
131
+ surface (whose backdrop filter moves to its own layer) as not painting one, so any class, style or
132
+ `data-*` change above it, such as dragging, released and rebuilt the lens. The lens is kept only
133
+ while the surface itself still resolves to a backdrop filter, so a crystal surface whose own
134
+ liquid class stops applying (`data-[state=open]:liquid` closing) under a lensed ancestor releases.
135
+
136
+ ### Liquid Glass is opt-in (breaking for the 0.3.0 previews)
137
+
138
+ Liquid Glass now costs nothing until an app asks for it. This replaces the material objects and
139
+ the per-component lens of the earlier 0.3.0 previews, which were never published (0.2.x users have
140
+ nothing to change).
141
+
142
+ - **Non-liquid components carry no liquid code.** Card, Dialog, Drawer, Popover, DropdownMenu,
143
+ ContextMenu, HoverCard, Topbar, Sidebar, ActionBar and CommandPalette are back to plain class
144
+ names: no lens hook, no option mapping, no glass-card detection, no ref composition, and no
145
+ chunk they could fetch later. `check:treeshake` asserts that no chunk of the `atoms`, `ai`,
146
+ `containers`, `forms`, `navigation`, `overlays`, `palette`, `primitives`, `shell` and `utils`
147
+ entries, eager or lazy, holds a glass module, so a page without Liquid Glass cannot fetch one at
148
+ run time. Sizes match the build before Liquid Glass (#35) within 15 bytes gzip (`shell` 10057 B, `overlays` 27125 B,
149
+ `containers` 89025 B, `utils` 7678 B).
150
+ - **New `@jcsoftdev/ui/liquid` entry** for the declarative API: `<LiquidGlass />`,
151
+ `startLiquidGlass()`, `liquidStyle()`, `liquidVars()`, `mergeLiquid()`, `LIQUID_DEFAULTS`,
152
+ `LIQUID_PRESETS`, `LIQUID_PRESET_CLEAR`, `LIQUID_PRESET_REGULAR`, `LIQUID_PRESET_THICK`,
153
+ `LIQUID_PRESET_CRYSTAL`, `supportsBackdropRefraction()` and the option types. It holds no static
154
+ import of the lens engine, so even a bundler that splits by file (esbuild) keeps the engine out
155
+ of the first load. `@jcsoftdev/ui/glass` keeps the imperative engine and the map builders.
156
+ - **`<LiquidGlass />`** (or `startLiquidGlass()`, which returns its stop; calls are counted) is the
157
+ only thing that loads the lens. Render it once near the root. It watches the document (classes,
158
+ `data-glass`, `data-glass-lens`, `data-style`, `data-theme`, added and removed nodes, and the
159
+ transparency, contrast and motion preferences) and gives the lens to every surface whose CSS
160
+ resolves to `--glass-lens: 1` with a backdrop filter (computed, so `md:liquid`, `dark:liquid`,
161
+ `data-[state=open]:liquid`, `aria-*` and `group-*` variants, container queries and an inline
162
+ `--glass-lens` count; pseudo-class variants such as `hover:liquid` are not followed; a custom
163
+ `@apply liquid` class needs `data-glass-lens="on"`),
164
+ fetching the engine the first time one does and retrying a failed fetch with a backoff (six attempts at most). It does
165
+ nothing on the server and nothing where the lens cannot paint (Safari, Firefox).
166
+ - **A lens applied by code and the watcher share an element safely.** Each element's lens keeps one
167
+ claim per owner: `applyGlassRefraction` / `useGlassRefraction` options win over the automatic
168
+ ones, the watcher never stops a manual lens, and after the manual cleanup the automatic lens takes
169
+ over again. A release left over from an ended claim is a no-op.
170
+ - **Lens slots go to surfaces that can show one.** Hidden (`display: none`), zero-area and
171
+ far-offscreen surfaces take none of the 8 slots, and are lensed once they show.
172
+ - **Options are `style={liquidStyle(options)}`**: synchronous custom properties, so the server
173
+ markup and the first client paint are already right, nothing changes at hydration, and no option
174
+ can go stale after it.
175
+ - The engine is split along its features: the crystal layer (`lens-crystal`, with `crystal-map`)
176
+ and the dispersion passes (`lens-dispersion`) are lazy chunks fetched only for a surface that
177
+ uses them. The specular and crystal map builders moved out of `displacement-map` into
178
+ `specular-map` and `crystal-map` (same exports from `@jcsoftdev/ui/glass`). The specular layer
179
+ and the motion stay in the engine chunk: every lensed surface uses both on its first frame.
180
+ - Topbar, Sidebar and CommandPalette accept `style` on their root.
181
+ - `check:size` measures the liquid tiers (Topbar alone, plus `liquidStyle`, plus `<LiquidGlass />`,
182
+ plus the lazy engine, plus the crystal and dispersion chunks).
183
+
184
+ ### Migration
185
+
186
+ From the 0.3.0 previews (`main` before this change):
187
+
188
+ - `material={{ type: "liquid", ...options }}` becomes
189
+ `material="liquid" style={liquidStyle(options)}` (`"liquid-clear"` the same way). `material` only
190
+ takes `"solid" | "glass" | "glass-clear" | "liquid" | "liquid-clear"`.
191
+ - `material={{ type: "liquid", preset: "thick", radius: 24 }}` becomes
192
+ `material="liquid" style={liquidStyle(mergeLiquid(LIQUID_PRESET_THICK, { radius: 24 }))}`.
193
+ - The lens no longer turns on by itself: render `<LiquidGlass />` once (from
194
+ `@jcsoftdev/ui/liquid`) in an app that wants it. Without it, liquid surfaces keep the CSS look.
195
+ - `useGlassLens(ref?)` is removed. Drop the ref: with `<LiquidGlass />` mounted, any element with
196
+ the `liquid` or `liquid-clear` class (or a glass surface under `data-glass="liquid"`) is lensed.
197
+ `applyGlassRefraction()` and `useGlassRefraction()` remain for manual control.
198
+ - `materialStyle()`, `withMaterialStyle()`, `MaterialName`, `LiquidMaterial` and
199
+ `liquidOptionsOf()` are removed. `@jcsoftdev/ui/utils` exports `Material` (now a string union)
200
+ and `materialClass()` only.
201
+ - Import `LiquidGlass` and `startLiquidGlass` from `@jcsoftdev/ui/liquid`; the options, presets
202
+ and `liquidStyle` are exported from both `@jcsoftdev/ui/liquid` and `@jcsoftdev/ui/glass`.
203
+ - The automatic lens reads the pointer mode (`interactive`) only from the surface itself, on every
204
+ surface (before, only the overlays did).
205
+ - A surface that leaves the page releases its lens when the DOM mutation is observed (a microtask later), not synchronously.
206
+
207
+ From 0.2.x: nothing changes unless you adopt Liquid Glass.
208
+
209
+ ### Security
210
+
211
+ - **RichTextEditor sanitizer: `javascript:` href bypass via Unicode whitespace.** The URL check ignored only ASCII and a few invisible characters, while the emitted `href` was `decodeEntities(href).trim()`, and `trim()` also strips U+00A0, U+1680, U+2000-200A, U+202F, U+205F and U+3000. A link such as `<a href="&nbsp;javascript:alert(1)">` passed the check and was emitted as `href="javascript:alert(1)"` (stored XSS for apps that render sanitized HTML as markup); the output was not idempotent. The href is now normalized once, that exact string is validated (all whitespace and format characters ignored, then a protocol allowlist through `new URL`), and the same string is emitted. Anyone using `sanitizeHtml` or `isSafeUrl` should upgrade; stored content is re-sanitized on the next pass.
212
+ - **Markdown parser (low): bounded nesting and link scan.** Blockquote and list nesting is capped at 32 levels (deeper levels render as literal text), which removes a stack overflow on `>` x 20000 and a multi-second parse on deeply nested lists, and the link-target scan is bounded so `[](` repeated thousands of times is no longer quadratic.
213
+
214
+ ### App-level building blocks
215
+
216
+ - **Tone palettes.** `tonePalettes` in a token file (optional) emits `--tone-<name>`, `--tone-<name>-soft` and `--tone-<name>-ink` for light and dark, plus `--color-tone-*` in `theme.css`. Names are kebab-case; `fill` and `soft` are required, `ink` falls back to `fill`. `buildTheme`, `buildTokensCss`, `buildThemeCss` and `ui-theme build` all honour it; files without the section build byte-identically.
217
+ - **Open `tone`.** `Chip`, `StatusDot`, `Kpi` and `Avatar` accept any tone name besides the built-in ones (`ChipTone`, `StatusDotTone`, `KpiTone`, `AvatarTone` are the built-in union plus `string & {}`; `ChipBuiltinTone` and friends keep the closed unions). Unknown names resolve through `--tone-<name>` variables set inline, so no class needs generating.
218
+ - **Kpi**: `tone`, `dot`, `icon`, `trend`. **KpiGroup**: `layout="auto-fit"` with `minItemWidth` (default 150) for separate cards in as many columns as fit.
219
+ - **Avatar**: `tone`, and `status` + `statusLabel` for a small status dot at the bottom-right.
220
+ - **EmptyState / ErrorState**: `variant="outlined"` (dashed border / danger border).
221
+ - **PageHeader**: `compact` (centred, tighter, body-size lede) and `breadcrumbs` (trail on its own row above the title).
222
+ - **Topbar**: `onSearch`, `searchLabel`, `searchPlaceholder`, `breadcrumbs` and `breadcrumbsLabel` are optional; missing parts render nothing (and Cmd/Ctrl+K is only bound with `onSearch`).
223
+ - **CardHeader**: `icon`, `title` and `action` slots; children still render as before.
224
+ - **Segmented**: `options` (`{ value, label, disabled? }[]`), `block` (full width, control-height items) and `allowDeselect` (default `false`: the pressed item stays selected; `true` lets a second press clear it).
225
+ - **Button**: while `loading` without a `loadingLabel`, the children stay and the UI string `loading` is announced.
226
+ - **CopyField**: label, monospace read-only value and a copy button with a 1.5 s copied state and a live region; strings `copy` and `copied` join the UI strings (`en`, `es`).
227
+ - **Layout**: `Page`, `Stack` and `Grid` (`@jcsoftdev/ui/containers/page`, `/stack`, `/grid`). `Page` is the `page` container, so `Cols` and `SettingsLayout` inside it react to the page width. `Grid` is intrinsic by default (`minColumnWidth`) or fixed with `columns`; `Stack` takes `direction`, `gap` and `align`.
228
+ - **Forms**: `Form`, `FormError` (`role="alert"`) and `FormStatus` (`role="status"`) in `@jcsoftdev/ui/forms/form`; the two messages render nothing for `null`, `undefined` or an empty `message`.
229
+ - **`Breadcrumbs`** (`@jcsoftdev/ui/navigation/breadcrumbs`): a named `nav` with an ordered list, `aria-current="page"` on the last item and a `renderLink` hook.
230
+ - **`LiveStatusBar`** (`@jcsoftdev/ui/states/live-status-bar`): `live`, `reconnecting` and `offline` states as a polite `role="status"` with a dot and localized text.
231
+ - **`BottomNav`** (`@jcsoftdev/ui/shell/bottom-nav`): phone navigation bar for `Sidebar` items; the items past the fifth slot go behind a "More" button that opens a drawer. It hides itself once the `AppShell` is 900 px wide.
232
+ - New localized strings: `breadcrumbs`, `live`, `reconnecting`, `offline`, `more`.
233
+
234
+ ### Chart gaps
235
+
236
+ - **Cartesian charts** (`BarChart`, `AreaChart`, `LineChart`, `ComboChart`): `tooltipRows({ index, category, rows })` returns `{ title?, rows?, footer? }` to replace parts of the tooltip (the default is unchanged when absent; the hidden data table is untouched); `categoryTickEvery` (a step or `(index, label) => boolean`) overrides the automatic thinning of the category labels; `markers` also takes an array of indices of `categories` to dot only those points.
237
+ - **`ValueAxisOptions.min` / `max`** accept a function of the data bound, e.g. `max: (dataMax) => Math.ceil(dataMax / 400) * 400`. `resolveAxisBound` and `AxisBound` are exported from `core/types`; the horizontal bar, lollipop, dumbbell, range area and waterfall axes honour it too.
238
+ - **`HeatmapChart`**: `cellDetail(row, column, value)` returns extra `TooltipRow`s under the cell value; `ChartTooltip` gained a `footer` slot.
239
+ - **`DonutChart`**: `sliceLabels` (`true`, `"percent"` or `"value"`) draws the share or the formatted value inside the ring and skips slices too small to hold it; it combines with `outsideLabels`.
240
+
241
+ ### Behavior change
242
+
243
+ - **`Segmented` keeps the selected item selected.** Pressing the selected `SegmentedItem` again used to clear the selection (value `""`); a single-select group now stays on it. `Segmented` takes `allowDeselect` (default `false`) to keep the old behavior.
4
244
 
5
245
  ### Fixes
6
246
 
247
+ - **PolarAreaChart hover no longer flickers.** The hovered sector steps out by 6px and was also the pointer target, so a still pointer near its inner edge fell outside the moved sector: hover, tooltip and dimming toggled about 25 times a second. Pointer events now go to invisible sectors at rest, with no gap between neighbours and covering the stepped-out area, as in DonutChart since 0.2.1. The tooltip stays inside the chart vertically too.
248
+ - **DonutChart, PieChart and PolarAreaChart keep a tapped slice.** On touch and pen, lifting the finger fires `pointerleave`, which dropped the slice right after the tap: tooltip, centre value and dimming flashed for a frame and vanished. A tap now pins the slice until the next tap on another slice or outside the chart; the mouse still drops the hover when it leaves. `useIndexNavigation` returns `pointerLeave` for this.
249
+ - **Chart tooltips stop swapping sides under the pointer.** On pointer-following tooltips (Sankey, Chord, Treemap, Icicle, Sunburst, Radar, horizontal Bar and Funnel, Scatter, ...) a 1-2px move across 60% of the width swapped the card from one side of the pointer to the other, and the 100ms transform transition animated the swap across the cursor. The side now has a dead zone (right of the pointer until 65% of the width, left of it until 55%, or until the card would overflow) and a swap jumps instead of sliding.
250
+ - **Waffle, Parliament and Pictogram keep the category over the gaps between its units** instead of hiding the tooltip until the pointer reaches the next unit; Treemap and Icicle snap to the nearest cell across the 1-6px gutters, and Sankey, Chord, RadialBar and every `useIndexNavigation` chart wait 60ms before clearing, so crossing a gutter goes from one mark to the next without an empty frame.
251
+ - **Charts react to taps on touch screens.** `ChartFrame` now owns touch selection for every chart: a tap pins the mark's (or category's) details, tapping it again, tapping outside or pressing Escape unpins, tapping another mark moves the pin, and a swipe or scroll (more than 10px) never selects. Lifting a finger no longer counts as leaving, and a tap snaps to the nearest mark within 44px. Cartesian charts (Bar, Line, Area, Combo, ChartGrid) pin the tapped category instead of ignoring the tap and picking the first one on focus; focusing a chart by pointer no longer selects the first item (only the keyboard does).
252
+ - **Chart details dock on phones.** `ChartTooltip` gets `dock="auto" | "always" | "never"` (default `auto`). `auto` docks the details in a full-width panel under the plot, in normal flow, based on the device: a coarse primary pointer or a viewport 480px wide or less. A narrow card on a desktop with a mouse keeps the floating card and reserves nothing. The panel reserves a fixed 160px (it scrolls past that) through CSS, so the reservation also holds on the server render and only exists while docking applies; its rows are at least 44px tall. A separate polite live region announces the pinned or keyboard-selected category, debounced and never for mouse hover. `ChartFrame` takes `dock` too, and `BarChart`, `LineChart`, `AreaChart`, `ComboChart` and `ChartGrid` forward it. Charts with `tooltip={false}` reserve nothing.
253
+ - **`AppShell` no longer re-renders the page during hydration.** Its context value changed in the first layout effect after hydration, which made Next.js client-render still-dehydrated Suspense boundaries (a hidden `div#S:0` stayed in the page). The value is now a store that never changes identity and reads `false` on the server and on the first client render; only `useAppShell` consumers update, once the width is measured.
254
+ - **`OfflineBanner` takes an `action`** (for example a retry button) after the queue counter.
255
+ - **`Checkbox` takes a `label`**: it renders a `<label>` bound to the box, so it names the checkbox and a click on it toggles. New `wrapper` and `label` parts.
7
256
  - **Checkbox looks like a checkbox.** The box is square (`rounded-xs`, the 4px small-radius token, 3px in the compact theme) instead of a circle, and the checked and indeterminate fill is the accent (as in Switch and the selected RadioGroup row) instead of the success green. Round plus green read as a radio button in multi-select lists. Sizes, 44px touch hit area, focus ring, disabled state and the `box`/`indicator`/`icon` parts are unchanged; The indeterminate state draws a dash instead of a check mark, and a disabled checkbox is dimmed (`opacity-50`, `cursor-not-allowed`) like the other form controls. RadioGroup stays round.
8
257
 
9
- ## 0.2.2 (2026-10-13)
258
+ ### Theme builder
10
259
 
11
- ### Fixes
260
+ - **`@jcsoftdev/ui/theme-builder` stays available.** The subpath published in 0.2.2 (`buildTheme`, `buildTokensCss`, `buildThemeCss`, `buildFontsCss`, `buildThemeKt`; `buildTheme(tokens, { kotlin: false })`) is re-exported from `@jcsoftdev/ui-tokens` and shipped inside this package, so 0.2.2 consumers upgrade unchanged and nothing extra is installed.
261
+
262
+ ### Crystal lens
263
+
264
+ - **`profile: "crystal"`** and the `crystal` preset (`data-glass="liquid-crystal"`): a thick, fully clear convex lens that minifies the backdrop, bends it hard towards the rim, splits colour at the edge and has no frost, veil or tint. `refraction` accepts 0 to 2 for it (defaults and the other profiles are unchanged; above 1 they behave as 1). The minifying map cannot fold; the filter runs on a layer that extends past the surface and is clipped to it. No contrast guarantee.
12
265
 
13
- - **`ui-theme build --no-kotlin` no longer builds Kotlin.** It used to generate `Theme.kt` and discard it, so `var(...)` and `oklch(...)` colors still threw "Unsupported color for Kotlin". Without the flag, the error now names the token and suggests `--no-kotlin`.
266
+ ### Configurable Liquid Glass and liquid motion
14
267
 
15
- ### Added
268
+ - **`LiquidGlassOptions`**: `style={liquidStyle(options)}` on any liquid surface. Options: `refraction`,
269
+ `bevelWidth`, `profile` (`"full"`, `"dome"`, `"rim"`), `dispersion`, `frost`, `saturation`,
270
+ `brightness`, `tint`, `rim`, `specular`, `fresnel`, `grain`, `radius`, `opacity`, `shadow`,
271
+ `interactive`, `motion`. Each maps to a `--liquid-*` custom property that the CSS and the lens
272
+ read, so a scope or the theme can set them and a change applies live. Exported from
273
+ `@jcsoftdev/ui/liquid` with `LIQUID_DEFAULTS`, `LIQUID_PRESETS`, `liquidStyle` and `liquidVars`.
274
+ - **`data-glass` presets**: `liquid-clear`, `liquid-regular` and `liquid-thick` (in `base.css`).
275
+ The global switch is now `[data-glass^="liquid"]`.
276
+ - **Optics**: the `dome` profile (round contours), a size-scaled outer shadow, fresnel glow, film
277
+ grain, and a specular glint that follows `specular.angle`. Defaults are unchanged.
278
+ - **Motion**: an in-house spring and one rAF loop: the lens materialises by spring, a press deepens
279
+ it, swells the surface and lights a touch glow that follows the pointer (the rim light turns
280
+ towards it), and `interactive: "drag"` pulls the surface through a rubber band with a velocity
281
+ squash (mismatched X/Y springs) and a jelly settle. Off under `prefers-reduced-motion` and with
282
+ `motion: false`.
283
+ - New tokens: `liquid-rim-lit`, `liquid-rim-back`, `liquid-rim-ring`, `liquid-shadow-ink`,
284
+ `liquid-shadow-alpha`, `liquid-shadow-drop`, `liquid-shadow-blur`, `liquid-shadow-contact` (the
285
+ engine's size-scaled shadow now follows the theme in light and dark). The liquid utilities compose their backdrop filter from the blur and
286
+ saturate tokens and the per-surface options; overriding `--liquid-regular-filter` alone no longer
287
+ changes anything.
288
+ - A lower `opacity`, a `tint` or `grain` void the contrast guarantee of the defaults.
289
+ - Fix: a removed element released its lens only after the rebuild throttle; it is now immediate.
290
+ - Motion hardening: the motion is written to `translate`/`scale` composed with the author's own
291
+ (an author `transform` is untouched; inline values are restored at rest, nothing is pinned); a
292
+ drag ignores presses on buttons, links and fields inside the surface, captures the pointer only
293
+ after 6 px, and swallows just its own gesture's click (within ~350 ms); no style reads per frame
294
+ and no config refresh from the motion's own writes; `--liquid-motion` and `--liquid-interactive`
295
+ are live; a moved surface follows its new ancestors.
16
296
 
17
- - **`@jcsoftdev/ui/theme-builder`** exports `buildTheme`, `buildTokensCss`, `buildThemeCss`, `buildFontsCss` and `buildThemeKt`, typed. `buildTheme` takes `kotlin: false` to skip `Theme.kt`.
297
+ ### Liquid variant of the glass (lensing)
18
298
 
19
- ## 0.2.1 (2026-10-13)
299
+ Frosted glass is unchanged; Apple-style Liquid Glass is a second look next to it.
300
+
301
+ - **`liquid` and `liquid-clear` utilities and `material="liquid" | "liquid-clear"`**: thin blur, higher
302
+ saturation, specular rim (lit top-left edge and a fainter opposite one), inner highlight, edge
303
+ glow and lower inner shadow for thickness, press flex on interactive surfaces (brightens and
304
+ scales; no transition under reduced motion; `backdrop-filter` is never animated). `glass` and
305
+ `glass-clear` render exactly as in 0.2 (a golden test pins their CSS).
306
+ - **Global switch**: `data-glass="liquid"` on `<html>` or any scope makes `glass`, `glass-clear` and
307
+ the glass-preset chrome surfaces render liquid. Content (`surface-card`) stays solid.
308
+ - **Lens for liquid surfaces in Chromium** once `<LiquidGlass />` is mounted (see above). The displacement map is rasterised from a
309
+ rounded-rect signed distance field with a Snell's-law squircle profile, DPR aware; chromatic
310
+ dispersion on surfaces up to 100,000 px squared; the blur and legibility veil move into the
311
+ filter so the rim stays sharp while the middle stays frosted. Budgets: 8 lenses, 640,000 px
312
+ squared, rebuilds throttled, one coalesced pass per frame. Opt out with `data-glass-lens="off"`
313
+ (element or ancestor) or `--glass-lens: 0`. Other engines get the base liquid look.
314
+ - **Closer to Apple** (liquid only): refraction only across a bevel as wide as the corner radius
315
+ (centre shows the backdrop undisplaced), strength equal to the bevel width, blur 4px / 1.5px,
316
+ saturation 1.5, thinner veil (regular .6 light / .54 dark, clear .47 / .38) with a text halo
317
+ (`--liquid-halo`), a directional specular layer in the filter (glint tinted by the backdrop,
318
+ dark contour, faint inner shadow, second `feImage`), dispersion 0.05, a materialise ramp and a
319
+ press lift on the refraction, and a `--liquid-shadow` token. Liquid contrast floors are now
320
+ documented per variant (regular 4.5 / 3.5, clear 4.5 / 2).
321
+ - **Full-surface lens** (liquid): the lens now bends the whole surface (smooth dome, strongest at the
322
+ rim, 24 px cap) instead of a bevel only; `coverage: "rim"` / `--glass-lens-coverage: rim` keeps the
323
+ old extent. The serrated edge of the first lenses was a fold-over of the displacement (offset
324
+ falling faster than 1 px per px); both profiles are now fold-free, with a regression test. The
325
+ veil moved fully into the filter and is adaptive (only where the backdrop is close to the ink), the
326
+ tint is dropped while the lens is on, blur is 2 px / 0.6 px, the rim glint is brighter and wider,
327
+ and dispersion is off by default (`--glass-lens-dispersion` or the option turns it on).
328
+ - The full-surface lens is a crease-free superellipse dome (pull along the gradient of `r = (|u|^3 + |v|^3)^(1/3)`), not a per-axis or edge-distance field, so it no longer reads as a four-faced diamond; tests check direction continuity across the diagonals and a positive 2D Jacobian.
329
+ - **Fixes**: `Card` stays a server component; the lens follows class, `data-glass`, opt-out and
330
+ preference changes at runtime; area and dispersion budgets are enforced on every resize;
331
+ surfaces waiting for one of the 8 slots get one when it frees. New `check:rsc` script.
332
+ - `@jcsoftdev/ui/glass`: new `computeDisplacementField`, `lensProfile`;
333
+ `createDisplacementMap` now returns a PNG data URI (browser only); `applyGlassRefraction` gains
334
+ `dispersion`, `veil` and `auto`, and moves the blur into the filter. The default `scale` is 20.
335
+ - New shared tokens `--liquid-*` (blur, saturate, filters, tints, dim, rim, depth).
336
+ - Material components and the `cn` merge group accept the new values. Card and ActionBar type
337
+ their `ref` prop (it reaches the root).
338
+
339
+ ### Liquid Glass
340
+
341
+ Apple-style glass for the control and navigation layer, with content kept solid.
342
+
343
+ - **Glass material tokens in every preset**: `--glass-regular-*` and `--glass-clear-*` (`tint`,
344
+ `blur`, `saturate`, `filter`, `border`, `edge`, `shadow`, `dim`, `fallback`) plus
345
+ `--glass-sheen`, `--glass-noise` (off) and `--glass-nested-tint`. The `glass` preset now tunes
346
+ them. `Theme.kt` exports `UiGlass` / `GlassMaterial`.
347
+ - **`glass` and `glass-clear` utilities** with an opaque base and the blur behind
348
+ `@supports (backdrop-filter)`; `prefers-reduced-transparency`, `prefers-contrast: more` and
349
+ `forced-colors` fall back to a solid fill with a border. Glass nested in glass drops its blur.
350
+ Specular edge highlight and sheen are built in. Both variants carry a legibility veil (stronger
351
+ for clear) so `text-ink` and `text-ink-2` keep 4.5:1 over white, black, split and striped
352
+ backdrops in both themes; `text-ink-3` and tinted text are not covered.
353
+ - **`material` prop** (`"solid" | "glass" | "glass-clear"`) on Card, Dialog, Drawer, Popover,
354
+ DropdownMenu, ContextMenu, HoverCard, CommandPalette, ActionBar, Topbar and Sidebar; every other
355
+ surface opts in with `glass`, `glass-clear` or `surface-solid` in `className`. The `cn` merge
356
+ treats the surface utilities as one group (the last one wins).
357
+ - **New `surface-nav`, `surface-side` and `surface-solid` utilities**; Topbar and Sidebar are glass
358
+ in the `glass` preset and unchanged elsewhere.
359
+ - **Opt-in refraction** in the new `@jcsoftdev/ui/glass` entry: `useGlassRefraction`,
360
+ `applyGlassRefraction`, `supportsBackdropRefraction`, `createDisplacementMap`. Chromium only,
361
+ never on by default, skipped under reduced transparency, more contrast, forced colors and reduced
362
+ motion. No dependencies.
363
+ - New [Liquid Glass guide](https://ui.jcsoftdev.com/docs/glass), stories and real-browser tests
364
+ (`pnpm test:glass`) including measured text contrast over a worst-case backdrop.
365
+
366
+ ### Platform
367
+
368
+ - **Tokens live in `@jcsoftdev/ui-tokens`.** `@jcsoftdev/ui` still ships the same `styles/*`,
369
+ `tokens/*` and `ui-theme` bin; they are synced from ui-tokens at build time.
370
+ - **The `ui-theme` bin is now a single bundled file** (it inlines the theme engine from ui-tokens);
371
+ invoke it exactly as before. It is no longer a thin script next to `scripts/build-theme.mjs`.
372
+ - **`ui-theme build` also writes `tailwind.css`** next to `tokens.css`, `theme.css` and `fonts.css`.
373
+ - **`ui-theme generate`** derives a WCAG AA color set from `--brand` (and optional `--accent`,
374
+ `--neutral`, `--danger`) and writes `tokens.json` plus the CSS outputs; a bad hex prints a clean
375
+ error and exits 1. The same engine is available as `createTheme`, `toCss` and `applyTheme` in
376
+ `@jcsoftdev/ui-tokens`.
20
377
 
21
378
  ### Fixes
22
379
 
380
+ - **`ui-theme build --no-kotlin` no longer builds Kotlin.** It used to generate `Theme.kt` and discard it, so `var(...)` and `oklch(...)` colors still threw "Unsupported color for Kotlin". Without the flag, the error now names the token and suggests `--no-kotlin`. The builders in `@jcsoftdev/ui-tokens/build` take `kotlin: false` and have typed `buildTokensCss`, `buildThemeCss`, `buildFontsCss` and `buildThemeKt`.
23
381
  - **DonutChart / PieChart no longer flicker on hover.** The hovered slice steps out by `explode`
24
382
  and was also the pointer target, so a still pointer near its edge ended up outside the moved
25
383
  slice, the hover dropped, the slice slid back under the pointer and the loop repeated (tooltip,
@@ -28,6 +386,31 @@
28
386
  - `ChartTooltip` takes an optional `containerHeight` and keeps the card inside it vertically
29
387
  (DonutChart passes it), so a slice near the top no longer pushes the card past the chart edge.
30
388
 
389
+ ### Migration notes
390
+
391
+ - **Cards no longer blur.** `surface-card` is now an opaque fill with no `backdrop-filter`, in every
392
+ preset. In the `glass` preset cards (`surface-card`, `surface-control`) are opaque instead of
393
+ translucent. To get the old look on one card use `material="glass"` (or `className="glass"`).
394
+ - `--surface-alpha` is now `1` in every preset and is only kept as an alias. `--surface-blur` and
395
+ `--surface-filter` still exist; in the `glass` preset they equal `--glass-regular-blur` and
396
+ `--glass-regular-filter`, and `--surface-overlay` equals `--glass-regular-tint`.
397
+ - Translucent `bg-surface-overlay` without a blur was replaced by the `surface-overlay` utility in
398
+ the map controls, attachment preview, emoji picker, source card and conversation button.
399
+ - `cn("surface-card", "surface-overlay")` now returns `surface-overlay`.
400
+ - A menu or popover portaled out of a glass dialog is not a DOM descendant, so it is not detected as
401
+ nested glass; pass `material="solid"` if you want it opaque.
402
+ - Non-glass presets are unchanged: overlays, the top bar and the sidebar keep their 0.2.0 fills in
403
+ every media mode (new `--surface-overlay-fallback`, `--surface-nav-fallback` and
404
+ `--surface-side-fallback` default to the surface's own token). In the `glass` preset, browsers
405
+ without `backdrop-filter` and users with reduced transparency or more contrast now get an opaque
406
+ overlay instead of a translucent one, plus a ring (more contrast) or outline (forced colors).
407
+ - In the `glass` preset `--shadow-card` changed (an inset highlight plus a large drop shadow became
408
+ a 1px ring plus a softer drop), and the overlay fill went from 82% `--float` to the regular
409
+ glass tint (72% white in light, 62% near-black in dark) plus the veil, which only the
410
+ `surface-overlay` / `surface-nav` / `surface-side` utilities paint: a bare `bg-surface-overlay`
411
+ is a translucent colour without blur or veil, use the utility.
412
+ - The unprefixed `glass` class can collide with an existing `.glass` in your CSS; see the guide.
413
+
31
414
  ## 0.2.0 (2026-10-11)
32
415
 
33
416
  Zero runtime dependencies, a published headless layer, per-part customization and a configurable
package/README.md CHANGED
@@ -24,6 +24,7 @@ Set these on `<html>` (or any element to restyle only its subtree); no rebuild i
24
24
  | `data-style="<preset>"` | Style preset (radii, borders, shadows, glass, ...). See https://ui.jcsoftdev.com/docs/theming/. |
25
25
  | `data-density="<level>"` | Control and spacing density: `compact`, `normal`, `comfortable`, `touch`. |
26
26
  | `data-radius="<level>"` | Global corner radius scale. |
27
+ | `data-glass="liquid\|liquid-clear\|liquid-regular\|liquid-thick\|liquid-crystal"` | Switch glass surfaces to Liquid Glass (lensing, specular rim) with a preset. Configure one surface with `style={liquidStyle(options)}` and mount `<LiquidGlass />` once for the lens (both from `@jcsoftdev/ui/liquid`); see https://ui.jcsoftdev.com/docs/glass/. |
27
28
 
28
29
  ### Subpath exports
29
30
 
@@ -51,6 +52,8 @@ npx ui-theme build my-tokens.json --out src/theme # optional: your own look (d
51
52
  @source "../node_modules/@jcsoftdev/ui/dist"; /* lets Tailwind see the classes used by the components */
52
53
  ```
53
54
 
55
+ Import order is free: `theme.css` declares nothing in Tailwind's `theme` layer that points back at itself (tokens such as `--radius-input` are mapped with `@theme reference inline`, so `rounded-input` reads the raw variable directly). `tokens.css` and `base.css` can sit unlayered, or in a layer of your own (`@import "…/tokens.css" layer(ui);`) declared before or after `theme`, with no `@layer` reordering and no re-declared names. Verified with Tailwind 4.3.3.
56
+
54
57
  ```tsx
55
58
  import { Button } from "@jcsoftdev/ui/atoms/button";
56
59
  <Button variant="primary">Save</Button>;
@@ -65,7 +68,7 @@ import { Button } from "@jcsoftdev/ui/atoms/button";
65
68
  | `tokens.css` | CSS variables. Light by default, dark through `prefers-color-scheme` and the `[data-theme="dark"]` / `[data-theme="light"]` override, brand palettes through `[data-accent="<id>"]`. |
66
69
  | `theme.css` | Tailwind v4 `@theme inline` mapping variables to utilities (`bg-surface`, `text-ink`, `rounded-card`, `shadow-flat`, `text-page-title`, `h-control-height`, ...). |
67
70
  | `fonts.css` | Optional `@import` for the Google Fonts declared in the tokens. Skip it when the app loads fonts itself (for example `next/font`, then override `--font-sans`). |
68
- | `Theme.kt` | Compose Multiplatform colors (per theme), palettes, shapes, sizes and text styles, so a Kotlin app shares the same tokens. |
71
+ | `Theme.kt` | Compose Multiplatform colors (per theme), palettes, shapes, sizes and text styles, so a Kotlin app shares the same tokens. Needs hex or `rgb(a)` colors: pass `--no-kotlin` to skip it when tokens use `var(...)` or `oklch(...)`. |
69
72
 
70
73
  Without a tokens argument the bundled default (`tokens/default.json`) is used; its output is already shipped as
71
74
  `@jcsoftdev/ui/styles/{tokens,theme,fonts}.css`.
@@ -146,9 +149,60 @@ older components already ship (NumberStepper, Carousel, AI set) are not routed t
146
149
  | --- | --- |
147
150
  | `Button` | `loadingLabel` (shown instead of the children while `loading`, announced through a status region), `block` (full width), `size="lg"` (52px at normal density, scaled like the other controls). |
148
151
  | `Field` | `optional` appends the localized "(optional)" marker to the label; `error` also accepts `null`. |
149
- | `Banner` | `title`; a default glyph per tone when `icon` is not passed (`icon={null}` hides it, so status never relies on color alone); only `danger` is `role="alert"`, the rest are `role="status"`; the `info` tone uses the `info` tokens. |
152
+ | `Banner` | `appearance="outline"` (page surface, only the border carries the tone; default `soft`), `title`; a default glyph per tone when `icon` is not passed (`icon={null}` hides it, so status never relies on color alone); only `danger` is `role="alert"`, the rest are `role="status"`; the `info` tone uses the `info` tokens. |
150
153
  | `Chip` | `icon`, `statusIcon` (prefixes `info`, `success`, `warning`, `danger` chips with their glyph), and an `info` tone. |
151
- | `ErrorState` | `title` and `description` (`message` keeps working as the headline); an `Error` or any non-renderable value is never printed, a generic localized sentence is shown instead. |
154
+ | `ErrorState` | `title` and `description` (`message` keeps working as the headline), `actions`; an `Error` or any non-renderable value is never printed, a generic localized sentence is shown instead. |
155
+
156
+ ## Blocks for application screens (additive)
157
+
158
+ New components, all zero-dependency, localized through `UiStringsProvider`, laid out with container
159
+ queries and sized for touch density. Props, accessibility notes and type-checked examples:
160
+ https://ui.jcsoftdev.com/docs/blocks/
161
+
162
+ | Component | Entry | What it is |
163
+ | --- | --- | --- |
164
+ | `Spinner`, `Kbd` | `atoms` | Loading ring (`size`, `label`, `label={false}` for decorative) and a styled `<kbd>`. |
165
+ | `IconButton` | `atoms` | Square `Button` with a required `label` (`aria-label`), `variant`, `size`, `loading`. |
166
+ | `DueChip` | `atoms` | Due-date chip: overdue, soon (`soonDays`) and ok states with a glyph and sr-only suffix; time-zone safe. |
167
+ | `Seal` | `atoms` | Stamp mark: `title`, `icon`, `tone`, optional named `label`. |
168
+ | `Tooltip` | `overlays` | Hover and focus tip: `content`, `shortcut`, `side`, `openDelay`, `closeDelay`; `role="tooltip"`. |
169
+ | `AlertDialog` | `overlays` | `role="alertdialog"` with cancel and confirm, `tone="danger"`, async `onConfirm` with a pending state. |
170
+ | `SelectMenu` | `forms` | Custom listbox select over `options` (groups, disabled options, typeahead, hidden `name` input). |
171
+ | `Combobox` | `forms` | Filterable, async-friendly (`onSearchChange`, `loading`), `clearable`, `emptyText`. |
172
+ | `DatePicker`, `DateTimePicker` | `forms` | Typed masked input plus calendar popover; ISO values, `min`, `max`, `isDateDisabled`, locale week start. |
173
+ | `DateCalendar` | `calendar` | Standalone keyboard date grid behind the pickers. |
174
+ | `ChipGroup` | `forms` | Multi or single toggle chips (`aria-pressed`, roving focus, `count`, `name`). |
175
+ | `Wizard` | `navigation` | `Stepper` plus Back/Next/Finish: `steps`, async `canAdvance`, `onBeforeNext`, `onComplete`. |
176
+ | `TabsNav`, `TabsNavLink` | `navigation` | Link-mode sub-navigation strip (`aria-current="page"`, `renderLink` or `asChild`). |
177
+ | `Section`, `Note`, `Aside` | `containers` | Titled block with `actions` and optional `divider`, a text note with a `tone`, and a complementary region. |
178
+ | `ListDetail` | `containers` | Master-detail that collapses to one pane under 641px of its own width. |
179
+ | `Feed`, `FeedEvent` | `containers` | Activity log with a mark, text and `<time>` (absolute or `relative`). |
180
+ | `Shortcuts`, `ShortcutsItem` | `containers` | Link or button tiles with `icon`, `count`, `kbd`. |
181
+
182
+ Additive props on existing components:
183
+
184
+ | Component | Added |
185
+ | --- | --- |
186
+ | `DescriptionList` | `layout` (`auto`, `inline`, `stacked`), `columns` (1 to 3), `valueAlign` (`end`, `start`); `DescriptionListItem` with a dash placeholder for empty values. |
187
+ | `Chip` | `size="sm"` (compact; a tag is `<Chip size="sm" square>`). |
188
+ | `Skeleton` | `variant` `list`, `kpis`, `key-value`, `bar` and `count`. |
189
+ | `ErrorState` | `actions` node, rendered in the same row as the retry button (the retry button now sits inside a wrapper `div`). |
190
+ | `RadioGroup` | Each radio is named by its label and described by its description. |
191
+ | `Checkbox`, `Switch` | The 44px touch target is an invisible `::after`; under touch density the layout box stays 40px. |
192
+ | `Table` | `flush` (`true`, `"start"`, `"end"`), `stickyHeader`, `maxHeight`, selection (`selectedKeys`, `defaultSelectedKeys`, `onSelectedKeysChange`, `rowKey`, `TableSelectCell`, `TableSelectAllCell`), `TableActionsCell` (wraps, or swaps for your overflow `menu`, under a narrow table container). |
193
+ | `Section` | Parts `Section.Header`, `.Title`, `.Count`, `.Description`, `.Actions`, `.Body` next to the props; a titleless wrapper takes no heading level. |
194
+ | `Kpi` | Parts `Kpi.Label`, `.Value` (`mono`, `suffix`, `trend`), `.Description`; `card` chrome; `trailing` slot. |
195
+ | `Timeline` | `status` per item (`done`, `current`, `error`, `pending`) and `Timeline.Item` children. |
196
+ | `Stepper` | `status` per step with a glyph and a spoken state. |
197
+ | `AlertDialog` | `confirmDisabled`, `cancelDisabled`; compound `AlertDialog.Root`, `.Trigger`, `.Content`, `.Title`, `.Description`, `.Cancel`, `.Action`. |
198
+ | `ListDetail` | `onBack` for the back action; `onValueChange` never receives `null`. |
199
+ | `DueChip` | `state` forces `overdue`, `soon`, `ok` or `done`. |
200
+ | `Seal` | `tone="institutional"` and any `tonePalettes` tone by name. |
201
+ | `DropdownMenu` | `DropdownMenuContent bare` (no panel look), `DropdownMenuAnchor`, `dropdownMenuItemClasses`, `dropdownMenuSurfaceClasses` for custom menus. |
202
+ | `toast` | `toast.info`, `toast.warning`, `toast.danger`; success, info, warning and error toasts are tinted with a glyph. |
203
+
204
+ In tests, reset the toast store with `import { resetToasts } from "@jcsoftdev/ui/overlays/testing"`
205
+ (kept off the `overlays` entry so production bundles never carry it).
152
206
 
153
207
  ## ConfirmAction and ResponsiveList
154
208