@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
@@ -0,0 +1,306 @@
1
+ import type { CSSProperties } from "react";
2
+
3
+ /** How the lens bends the backdrop. See {@link LiquidGlassOptions.profile}. */
4
+ export type LiquidProfile = "rim" | "full" | "dome" | "crystal";
5
+
6
+ /** What the surface does under the pointer. See {@link LiquidGlassOptions.interactive}. */
7
+ export type LiquidInteractive = "none" | "press" | "drag";
8
+
9
+ /** Named spring of the surface motion, or `false` for none. See {@link LiquidGlassOptions.motion}. */
10
+ export type LiquidMotion = false | "snappy" | "smooth" | "soft" | "jelly";
11
+
12
+ /**
13
+ * Everything that shapes a Liquid Glass surface. Every field is optional and maps to one
14
+ * `--liquid-*` custom property (see {@link liquidStyle}), so the same configuration can come from
15
+ * a prop, a scope (`style`, a class) or the theme (`:root { --liquid-frost: 3px }`): the lens
16
+ * engine and the CSS read the same variables, and they inherit.
17
+ *
18
+ * Omitted fields keep the theme's look ({@link LIQUID_DEFAULTS}). The contrast guarantee of the
19
+ * kit (ink 4.5:1 over the supported backdrops) holds for the defaults only: a lower `opacity`, a
20
+ * `tint`, `grain` or a thinner `frost` can leave text without it.
21
+ */
22
+ export interface LiquidGlassOptions {
23
+ /**
24
+ * Strength of the bend, 0 to 1, as a fraction of the strongest offset that cannot fold the
25
+ * backdrop back on itself. `0` is flat glass. Default 1. With `profile: "crystal"` the range is
26
+ * 0 to 2: a minifying lens cannot fold, so it can be pushed further (1.67 is a thick lens).
27
+ */
28
+ refraction?: number;
29
+ /**
30
+ * Thickness of the glass edge in px. For `profile: "rim"` it is the width of the refracting
31
+ * band; for `"full"` and `"dome"` it caps the largest offset. Default: derived from the corner
32
+ * radius and the size (up to 24 px for the whole-surface profiles).
33
+ */
34
+ bevelWidth?: number;
35
+ /**
36
+ * `"full"` (default): a superellipse dome over the whole surface. `"dome"`: a rounder,
37
+ * elliptical drop that is flatter in the middle. `"rim"`: only a bevel along the edge, the
38
+ * middle shows the backdrop undisplaced. `"crystal"`: a thick convex lens that minifies the
39
+ * backdrop (it shows a wider area than the surface covers), bending steeply towards the rim;
40
+ * meant to be clear (`frost: 0`, `opacity: 0`) and has no contrast guarantee.
41
+ */
42
+ profile?: LiquidProfile;
43
+ /** Chromatic dispersion, 0 to 0.2: how far apart the colour channels are pulled. Default 0. Small surfaces only. */
44
+ dispersion?: number;
45
+ /** Backdrop blur (frost) in px. Default 2 (regular), 0.6 (clear). */
46
+ frost?: number;
47
+ /** Backdrop saturation, 1 is unchanged. Default 1.5. */
48
+ saturation?: number;
49
+ /** Backdrop brightness, 1 is unchanged. Default 1. */
50
+ brightness?: number;
51
+ /** A colour laid over the glass: `amount` (0 to 1, default 0.2) is its opacity. */
52
+ tint?: { color: string; amount?: number };
53
+ /** Strength of the edge highlight (the lit and the opposite rim), 0 to 2. Default 1. */
54
+ rim?: number;
55
+ /** The highlight on the walls facing the light. `angle` is degrees clockwise from +x (default -120, upper left). */
56
+ specular?: { intensity?: number; angle?: number };
57
+ /** Extra glow that grows towards the edge, 0 to 1. Default 0. */
58
+ fresnel?: number;
59
+ /** Film grain over the glass, 0 to 1. Default 0. */
60
+ grain?: number;
61
+ /** Corner radius in px. Default: the component's own. */
62
+ radius?: number;
63
+ /**
64
+ * Opacity of the legibility veil, 0 to 1. Default 1. Lower values let the backdrop through and
65
+ * drop the contrast guarantee.
66
+ */
67
+ opacity?: number;
68
+ /** Outer shadow: `opacity` multiplies its colour, `spread` adds to its blur (px), `offsetY` drops it (px). */
69
+ shadow?: { opacity?: number; spread?: number; offsetY?: number };
70
+ /**
71
+ * Pointer behaviour. `"press"`: the lens deepens and the surface swells while pressed.
72
+ * `"drag"`: the surface can also be dragged (rubber-banded) and squashes with the speed.
73
+ * `"none"`: static. Default: `"press"` on buttons, links and `data-glass-interactive`
74
+ * elements, `"none"` elsewhere.
75
+ */
76
+ interactive?: LiquidInteractive;
77
+ /** Spring of the motion above, or `false` to turn it off. Default `"snappy"`. */
78
+ motion?: LiquidMotion;
79
+ }
80
+
81
+ /** What each field resolves to when nothing sets it. `undefined` means "derived at run time". */
82
+ export const LIQUID_DEFAULTS = {
83
+ refraction: 1,
84
+ bevelWidth: undefined,
85
+ profile: "full",
86
+ dispersion: 0,
87
+ frost: 2,
88
+ saturation: 1.5,
89
+ brightness: 1,
90
+ tint: { color: "transparent", amount: 0.2 },
91
+ rim: 1,
92
+ specular: { intensity: 1, angle: -120 },
93
+ fresnel: 0,
94
+ grain: 0,
95
+ radius: undefined,
96
+ opacity: 1,
97
+ shadow: { opacity: 1, spread: 0, offsetY: 10 },
98
+ interactive: undefined,
99
+ motion: "snappy",
100
+ } as const satisfies LiquidGlassOptions;
101
+
102
+ /** Names of the `data-glass` presets. */
103
+ export type LiquidPresetName = "clear" | "regular" | "thick" | "crystal";
104
+
105
+ /** The `clear` preset (`data-glass="liquid-clear"`): thin, lighter frost and veil. */
106
+ export const LIQUID_PRESET_CLEAR: LiquidGlassOptions = {
107
+ frost: 0.6,
108
+ opacity: 0.75,
109
+ refraction: 0.9,
110
+ shadow: { opacity: 0.7 },
111
+ specular: { intensity: 1.1 },
112
+ };
113
+
114
+ /** The `regular` preset: the theme's look. */
115
+ export const LIQUID_PRESET_REGULAR: LiquidGlassOptions = {};
116
+
117
+ /**
118
+ * The `crystal` preset: a thick, fully clear convex lens. The backdrop is minified and bent hard
119
+ * towards the rim, the colour channels split at the edge, no frost, no veil, a thin bright rim.
120
+ * Over busy content text is not legible: there is no contrast guarantee, put short bold labels
121
+ * with a text shadow on it. On a lensed surface it loads the crystal and dispersion parts.
122
+ */
123
+ export const LIQUID_PRESET_CRYSTAL: LiquidGlassOptions = {
124
+ profile: "crystal",
125
+ refraction: 1.67,
126
+ dispersion: 0.05,
127
+ frost: 0,
128
+ saturation: 1,
129
+ opacity: 0,
130
+ tint: { color: "transparent", amount: 0 },
131
+ rim: 0.6,
132
+ specular: { intensity: 0 },
133
+ fresnel: 1,
134
+ shadow: { opacity: 0.8 },
135
+ };
136
+
137
+ /** The `thick` preset (`data-glass="liquid-thick"`): a wide bevel, more frost, a deeper shadow. */
138
+ export const LIQUID_PRESET_THICK: LiquidGlassOptions = {
139
+ bevelWidth: 32,
140
+ frost: 3,
141
+ refraction: 1,
142
+ rim: 1.25,
143
+ fresnel: 0.35,
144
+ shadow: { opacity: 1.2, spread: 12, offsetY: 16 },
145
+ };
146
+
147
+ /**
148
+ * The same presets that `data-glass="liquid-clear|liquid-regular|liquid-thick"` selects in
149
+ * `base.css`. `regular` is the theme's look.
150
+ */
151
+ export const LIQUID_PRESETS: Record<LiquidPresetName, LiquidGlassOptions> = {
152
+ clear: LIQUID_PRESET_CLEAR,
153
+ regular: LIQUID_PRESET_REGULAR,
154
+ crystal: LIQUID_PRESET_CRYSTAL,
155
+ thick: LIQUID_PRESET_THICK,
156
+ };
157
+
158
+ const clamp = (value: number, min: number, max: number) => Math.min(Math.max(value, min), max);
159
+ const round = (value: number) => Math.round(value * 1000) / 1000;
160
+ const finite = (value: unknown): value is number =>
161
+ typeof value === "number" && Number.isFinite(value);
162
+
163
+ /** Names of the motion springs, in the order a control lists them. */
164
+ export const LIQUID_MOTIONS = ["snappy", "smooth", "soft", "jelly"] as const;
165
+
166
+ /** Merges a preset under explicit options (one level deep for the grouped fields). */
167
+ export function mergeLiquid(
168
+ base: LiquidGlassOptions | undefined,
169
+ over: LiquidGlassOptions | undefined,
170
+ ): LiquidGlassOptions {
171
+ const out: LiquidGlassOptions = { ...base, ...over };
172
+ if (base?.specular || over?.specular) out.specular = { ...base?.specular, ...over?.specular };
173
+ if (base?.shadow || over?.shadow) out.shadow = { ...base?.shadow, ...over?.shadow };
174
+ if (base?.tint || over?.tint)
175
+ out.tint = { ...base?.tint, ...over?.tint } as LiquidGlassOptions["tint"];
176
+ return out;
177
+ }
178
+
179
+ /** Highlight alphas are themed tokens (`--liquid-rim-lit|back|ring`); this scales them. */
180
+ export function liquidRim(strength = 1, angle = -120, fresnel = 0): string {
181
+ const radians = (angle * Math.PI) / 180;
182
+ const x = round(-Math.cos(radians) * 2);
183
+ const y = round(-Math.sin(radians) * 2);
184
+ const s = round(clamp(strength, 0, 2));
185
+ const white = (alpha: string) =>
186
+ `color-mix(in srgb, white min(100%, calc(${alpha} * 100%)), transparent)`;
187
+ const layers = [
188
+ `inset ${x}px ${y}px 0 -.5px ${white(`var(--liquid-rim-lit, .95) * ${s}`)}`,
189
+ `inset ${-x}px ${-y}px 0 -.5px ${white(`var(--liquid-rim-back, .7) * ${s}`)}`,
190
+ `inset 0 0 0 1px ${white(`var(--liquid-rim-ring, .5) * ${s}`)}`,
191
+ ];
192
+ const f = clamp(fresnel, 0, 1);
193
+ if (f > 0) layers.push(`inset 0 0 18px ${white(String(round(f * 0.4)))}`);
194
+ return layers.join(", ");
195
+ }
196
+
197
+ /**
198
+ * The outer shadow of a surface. Its blur and drop scale with `--liquid-size`, which the lens
199
+ * engine sets from the size of the surface (a bigger piece of glass is thicker, so its shadow is
200
+ * deeper); without the engine the variable is 1. What is not configured comes from the themed
201
+ * tokens (`--liquid-shadow-drop`, `-blur`, `-contact`, `-ink`, `-alpha`), so the shadow the
202
+ * engine paints is the one the theme's `--liquid-shadow` describes, in light and in dark.
203
+ */
204
+ export function liquidShadow({
205
+ opacity = 1,
206
+ spread,
207
+ offsetY,
208
+ }: NonNullable<LiquidGlassOptions["shadow"]> = {}): string {
209
+ const a = round(clamp(opacity, 0, 2));
210
+ const alpha = "var(--liquid-shadow-alpha, .2)";
211
+ const ink = (factor: string) =>
212
+ `color-mix(in srgb, var(--liquid-shadow-ink, black) min(100%, calc(${alpha} * ${factor} * 100%)), transparent)`;
213
+ const k = "var(--liquid-size, 1)";
214
+ const drop = offsetY === undefined ? "var(--liquid-shadow-drop, 10px)" : `${round(offsetY)}px`;
215
+ const blur = spread === undefined ? "var(--liquid-shadow-blur, 30px)" : `${round(30 + spread)}px`;
216
+ return [
217
+ `0 calc(${drop} * ${k}) calc(${blur} * ${k}) -6px ${ink(String(a))}`,
218
+ `0 calc(2px * ${k}) calc(6px * ${k}) ${ink(`${a} * var(--liquid-shadow-contact, .4)`)}`,
219
+ ].join(", ");
220
+ }
221
+
222
+ /** A tiling film-grain image for `--glass-noise`: white speckle whose opacity follows `amount`. */
223
+ export function liquidGrain(amount: number): string {
224
+ const a = round(clamp(amount, 0, 1) * 0.5);
225
+ const svg =
226
+ `<svg xmlns='http://www.w3.org/2000/svg' width='160' height='160'><filter id='n'>` +
227
+ `<feTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='2' stitchTiles='stitch'/>` +
228
+ `<feColorMatrix values='0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 ${a} 0 0 0 0'/></filter>` +
229
+ `<rect width='100%' height='100%' filter='url(#n)'/></svg>`;
230
+ return `url("data:image/svg+xml,${encodeURIComponent(svg)}")`;
231
+ }
232
+
233
+ type Vars = Record<string, string>;
234
+
235
+ /**
236
+ * The custom properties of a configuration, only for the fields that are set. Spread them into a
237
+ * `style` prop (or a class, or `:root`). The numeric ones are what the lens engine reads; the
238
+ * composite ones (`--liquid-rim-custom`, `--liquid-shadow-custom`, `--glass-noise`) are what the
239
+ * CSS utilities paint.
240
+ */
241
+ export function liquidVars(options: LiquidGlassOptions = {}): Vars {
242
+ const out: Vars = {};
243
+ const set = (name: string, value: string | number | undefined) => {
244
+ if (value !== undefined) out[`--liquid-${name}`] = String(value);
245
+ };
246
+ const num = (value: unknown, min: number, max: number) =>
247
+ finite(value) ? round(clamp(value, min, max)) : undefined;
248
+ set("refraction", num(options.refraction, 0, 2));
249
+ const bevel = num(options.bevelWidth, 0, 120);
250
+ if (bevel !== undefined) set("bevel", `${bevel}px`);
251
+ if (options.profile) set("profile", options.profile);
252
+ set("dispersion", num(options.dispersion, 0, 0.2));
253
+ const frost = num(options.frost, 0, 40);
254
+ if (frost !== undefined) set("frost", `${frost}px`);
255
+ set("saturation", num(options.saturation, 0, 4));
256
+ const brightness = num(options.brightness, 0, 3);
257
+ set("brightness", brightness);
258
+ // The filter takes the whole function so that an unset option leaves no `brightness(1)` behind.
259
+ if (brightness !== undefined) set("brightness-fn", `brightness(${brightness})`);
260
+ if (options.tint) {
261
+ set("tint-color", options.tint.color);
262
+ set("tint-amount", num(options.tint.amount ?? LIQUID_DEFAULTS.tint.amount, 0, 1));
263
+ }
264
+ const rim = num(options.rim, 0, 2);
265
+ set("rim-strength", rim);
266
+ const intensity = num(options.specular?.intensity, 0, 2);
267
+ set("specular", intensity);
268
+ const angle = finite(options.specular?.angle) ? round(options.specular.angle) : undefined;
269
+ set("specular-angle", angle);
270
+ const fresnel = num(options.fresnel, 0, 1);
271
+ set("fresnel", fresnel);
272
+ if (rim !== undefined || angle !== undefined || fresnel !== undefined)
273
+ set("rim-custom", liquidRim(rim ?? 1, angle ?? -120, fresnel ?? 0));
274
+ const grain = num(options.grain, 0, 1);
275
+ set("grain", grain);
276
+ if (grain) out["--glass-noise"] = liquidGrain(grain);
277
+ const radius = num(options.radius, 0, 999);
278
+ if (radius !== undefined) set("radius", `${radius}px`);
279
+ set("opacity", num(options.opacity, 0, 1));
280
+ if (options.shadow) {
281
+ const { opacity, spread, offsetY } = options.shadow;
282
+ set("shadow-opacity", num(opacity, 0, 2));
283
+ set("shadow-spread", num(spread, 0, 80));
284
+ set("shadow-offset", num(offsetY, -40, 80));
285
+ set(
286
+ "shadow-custom",
287
+ liquidShadow({
288
+ opacity: num(opacity, 0, 2),
289
+ spread: num(spread, 0, 80),
290
+ offsetY: num(offsetY, -40, 80),
291
+ }),
292
+ );
293
+ }
294
+ if (options.interactive) set("interactive", options.interactive);
295
+ if (options.motion !== undefined)
296
+ set("motion", options.motion === false ? "off" : options.motion);
297
+ return out;
298
+ }
299
+
300
+ /** {@link liquidVars} as a `style` object (adds `border-radius` when `radius` is set). */
301
+ export function liquidStyle(options: LiquidGlassOptions = {}): CSSProperties {
302
+ const vars = liquidVars(options);
303
+ if (vars["--liquid-radius"])
304
+ return { ...vars, borderRadius: "var(--liquid-radius)" } as CSSProperties;
305
+ return vars as CSSProperties;
306
+ }