@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,162 @@
1
+ import type { CSSProperties } from "react";
2
+ /** How the lens bends the backdrop. See {@link LiquidGlassOptions.profile}. */
3
+ export type LiquidProfile = "rim" | "full" | "dome" | "crystal";
4
+ /** What the surface does under the pointer. See {@link LiquidGlassOptions.interactive}. */
5
+ export type LiquidInteractive = "none" | "press" | "drag";
6
+ /** Named spring of the surface motion, or `false` for none. See {@link LiquidGlassOptions.motion}. */
7
+ export type LiquidMotion = false | "snappy" | "smooth" | "soft" | "jelly";
8
+ /**
9
+ * Everything that shapes a Liquid Glass surface. Every field is optional and maps to one
10
+ * `--liquid-*` custom property (see {@link liquidStyle}), so the same configuration can come from
11
+ * a prop, a scope (`style`, a class) or the theme (`:root { --liquid-frost: 3px }`): the lens
12
+ * engine and the CSS read the same variables, and they inherit.
13
+ *
14
+ * Omitted fields keep the theme's look ({@link LIQUID_DEFAULTS}). The contrast guarantee of the
15
+ * kit (ink 4.5:1 over the supported backdrops) holds for the defaults only: a lower `opacity`, a
16
+ * `tint`, `grain` or a thinner `frost` can leave text without it.
17
+ */
18
+ export interface LiquidGlassOptions {
19
+ /**
20
+ * Strength of the bend, 0 to 1, as a fraction of the strongest offset that cannot fold the
21
+ * backdrop back on itself. `0` is flat glass. Default 1. With `profile: "crystal"` the range is
22
+ * 0 to 2: a minifying lens cannot fold, so it can be pushed further (1.67 is a thick lens).
23
+ */
24
+ refraction?: number;
25
+ /**
26
+ * Thickness of the glass edge in px. For `profile: "rim"` it is the width of the refracting
27
+ * band; for `"full"` and `"dome"` it caps the largest offset. Default: derived from the corner
28
+ * radius and the size (up to 24 px for the whole-surface profiles).
29
+ */
30
+ bevelWidth?: number;
31
+ /**
32
+ * `"full"` (default): a superellipse dome over the whole surface. `"dome"`: a rounder,
33
+ * elliptical drop that is flatter in the middle. `"rim"`: only a bevel along the edge, the
34
+ * middle shows the backdrop undisplaced. `"crystal"`: a thick convex lens that minifies the
35
+ * backdrop (it shows a wider area than the surface covers), bending steeply towards the rim;
36
+ * meant to be clear (`frost: 0`, `opacity: 0`) and has no contrast guarantee.
37
+ */
38
+ profile?: LiquidProfile;
39
+ /** Chromatic dispersion, 0 to 0.2: how far apart the colour channels are pulled. Default 0. Small surfaces only. */
40
+ dispersion?: number;
41
+ /** Backdrop blur (frost) in px. Default 2 (regular), 0.6 (clear). */
42
+ frost?: number;
43
+ /** Backdrop saturation, 1 is unchanged. Default 1.5. */
44
+ saturation?: number;
45
+ /** Backdrop brightness, 1 is unchanged. Default 1. */
46
+ brightness?: number;
47
+ /** A colour laid over the glass: `amount` (0 to 1, default 0.2) is its opacity. */
48
+ tint?: {
49
+ color: string;
50
+ amount?: number;
51
+ };
52
+ /** Strength of the edge highlight (the lit and the opposite rim), 0 to 2. Default 1. */
53
+ rim?: number;
54
+ /** The highlight on the walls facing the light. `angle` is degrees clockwise from +x (default -120, upper left). */
55
+ specular?: {
56
+ intensity?: number;
57
+ angle?: number;
58
+ };
59
+ /** Extra glow that grows towards the edge, 0 to 1. Default 0. */
60
+ fresnel?: number;
61
+ /** Film grain over the glass, 0 to 1. Default 0. */
62
+ grain?: number;
63
+ /** Corner radius in px. Default: the component's own. */
64
+ radius?: number;
65
+ /**
66
+ * Opacity of the legibility veil, 0 to 1. Default 1. Lower values let the backdrop through and
67
+ * drop the contrast guarantee.
68
+ */
69
+ opacity?: number;
70
+ /** Outer shadow: `opacity` multiplies its colour, `spread` adds to its blur (px), `offsetY` drops it (px). */
71
+ shadow?: {
72
+ opacity?: number;
73
+ spread?: number;
74
+ offsetY?: number;
75
+ };
76
+ /**
77
+ * Pointer behaviour. `"press"`: the lens deepens and the surface swells while pressed.
78
+ * `"drag"`: the surface can also be dragged (rubber-banded) and squashes with the speed.
79
+ * `"none"`: static. Default: `"press"` on buttons, links and `data-glass-interactive`
80
+ * elements, `"none"` elsewhere.
81
+ */
82
+ interactive?: LiquidInteractive;
83
+ /** Spring of the motion above, or `false` to turn it off. Default `"snappy"`. */
84
+ motion?: LiquidMotion;
85
+ }
86
+ /** What each field resolves to when nothing sets it. `undefined` means "derived at run time". */
87
+ export declare const LIQUID_DEFAULTS: {
88
+ readonly refraction: 1;
89
+ readonly bevelWidth: undefined;
90
+ readonly profile: "full";
91
+ readonly dispersion: 0;
92
+ readonly frost: 2;
93
+ readonly saturation: 1.5;
94
+ readonly brightness: 1;
95
+ readonly tint: {
96
+ readonly color: "transparent";
97
+ readonly amount: 0.2;
98
+ };
99
+ readonly rim: 1;
100
+ readonly specular: {
101
+ readonly intensity: 1;
102
+ readonly angle: -120;
103
+ };
104
+ readonly fresnel: 0;
105
+ readonly grain: 0;
106
+ readonly radius: undefined;
107
+ readonly opacity: 1;
108
+ readonly shadow: {
109
+ readonly opacity: 1;
110
+ readonly spread: 0;
111
+ readonly offsetY: 10;
112
+ };
113
+ readonly interactive: undefined;
114
+ readonly motion: "snappy";
115
+ };
116
+ /** Names of the `data-glass` presets. */
117
+ export type LiquidPresetName = "clear" | "regular" | "thick" | "crystal";
118
+ /** The `clear` preset (`data-glass="liquid-clear"`): thin, lighter frost and veil. */
119
+ export declare const LIQUID_PRESET_CLEAR: LiquidGlassOptions;
120
+ /** The `regular` preset: the theme's look. */
121
+ export declare const LIQUID_PRESET_REGULAR: LiquidGlassOptions;
122
+ /**
123
+ * The `crystal` preset: a thick, fully clear convex lens. The backdrop is minified and bent hard
124
+ * towards the rim, the colour channels split at the edge, no frost, no veil, a thin bright rim.
125
+ * Over busy content text is not legible: there is no contrast guarantee, put short bold labels
126
+ * with a text shadow on it. On a lensed surface it loads the crystal and dispersion parts.
127
+ */
128
+ export declare const LIQUID_PRESET_CRYSTAL: LiquidGlassOptions;
129
+ /** The `thick` preset (`data-glass="liquid-thick"`): a wide bevel, more frost, a deeper shadow. */
130
+ export declare const LIQUID_PRESET_THICK: LiquidGlassOptions;
131
+ /**
132
+ * The same presets that `data-glass="liquid-clear|liquid-regular|liquid-thick"` selects in
133
+ * `base.css`. `regular` is the theme's look.
134
+ */
135
+ export declare const LIQUID_PRESETS: Record<LiquidPresetName, LiquidGlassOptions>;
136
+ /** Names of the motion springs, in the order a control lists them. */
137
+ export declare const LIQUID_MOTIONS: readonly ["snappy", "smooth", "soft", "jelly"];
138
+ /** Merges a preset under explicit options (one level deep for the grouped fields). */
139
+ export declare function mergeLiquid(base: LiquidGlassOptions | undefined, over: LiquidGlassOptions | undefined): LiquidGlassOptions;
140
+ /** Highlight alphas are themed tokens (`--liquid-rim-lit|back|ring`); this scales them. */
141
+ export declare function liquidRim(strength?: number, angle?: number, fresnel?: number): string;
142
+ /**
143
+ * The outer shadow of a surface. Its blur and drop scale with `--liquid-size`, which the lens
144
+ * engine sets from the size of the surface (a bigger piece of glass is thicker, so its shadow is
145
+ * deeper); without the engine the variable is 1. What is not configured comes from the themed
146
+ * tokens (`--liquid-shadow-drop`, `-blur`, `-contact`, `-ink`, `-alpha`), so the shadow the
147
+ * engine paints is the one the theme's `--liquid-shadow` describes, in light and in dark.
148
+ */
149
+ export declare function liquidShadow({ opacity, spread, offsetY, }?: NonNullable<LiquidGlassOptions["shadow"]>): string;
150
+ /** A tiling film-grain image for `--glass-noise`: white speckle whose opacity follows `amount`. */
151
+ export declare function liquidGrain(amount: number): string;
152
+ type Vars = Record<string, string>;
153
+ /**
154
+ * The custom properties of a configuration, only for the fields that are set. Spread them into a
155
+ * `style` prop (or a class, or `:root`). The numeric ones are what the lens engine reads; the
156
+ * composite ones (`--liquid-rim-custom`, `--liquid-shadow-custom`, `--glass-noise`) are what the
157
+ * CSS utilities paint.
158
+ */
159
+ export declare function liquidVars(options?: LiquidGlassOptions): Vars;
160
+ /** {@link liquidVars} as a `style` object (adds `border-radius` when `radius` is set). */
161
+ export declare function liquidStyle(options?: LiquidGlassOptions): CSSProperties;
162
+ export {};
@@ -0,0 +1,179 @@
1
+ const LIQUID_DEFAULTS = {
2
+ refraction: 1,
3
+ bevelWidth: void 0,
4
+ profile: "full",
5
+ dispersion: 0,
6
+ frost: 2,
7
+ saturation: 1.5,
8
+ brightness: 1,
9
+ tint: { color: "transparent", amount: 0.2 },
10
+ rim: 1,
11
+ specular: { intensity: 1, angle: -120 },
12
+ fresnel: 0,
13
+ grain: 0,
14
+ radius: void 0,
15
+ opacity: 1,
16
+ shadow: { opacity: 1, spread: 0, offsetY: 10 },
17
+ interactive: void 0,
18
+ motion: "snappy"
19
+ };
20
+ const LIQUID_PRESET_CLEAR = {
21
+ frost: 0.6,
22
+ opacity: 0.75,
23
+ refraction: 0.9,
24
+ shadow: { opacity: 0.7 },
25
+ specular: { intensity: 1.1 }
26
+ };
27
+ const LIQUID_PRESET_REGULAR = {};
28
+ const LIQUID_PRESET_CRYSTAL = {
29
+ profile: "crystal",
30
+ refraction: 1.67,
31
+ dispersion: 0.05,
32
+ frost: 0,
33
+ saturation: 1,
34
+ opacity: 0,
35
+ tint: { color: "transparent", amount: 0 },
36
+ rim: 0.6,
37
+ specular: { intensity: 0 },
38
+ fresnel: 1,
39
+ shadow: { opacity: 0.8 }
40
+ };
41
+ const LIQUID_PRESET_THICK = {
42
+ bevelWidth: 32,
43
+ frost: 3,
44
+ refraction: 1,
45
+ rim: 1.25,
46
+ fresnel: 0.35,
47
+ shadow: { opacity: 1.2, spread: 12, offsetY: 16 }
48
+ };
49
+ const LIQUID_PRESETS = {
50
+ clear: LIQUID_PRESET_CLEAR,
51
+ regular: LIQUID_PRESET_REGULAR,
52
+ crystal: LIQUID_PRESET_CRYSTAL,
53
+ thick: LIQUID_PRESET_THICK
54
+ };
55
+ const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
56
+ const round = (value) => Math.round(value * 1e3) / 1e3;
57
+ const finite = (value) => typeof value === "number" && Number.isFinite(value);
58
+ const LIQUID_MOTIONS = ["snappy", "smooth", "soft", "jelly"];
59
+ function mergeLiquid(base, over) {
60
+ const out = { ...base, ...over };
61
+ if (base?.specular || over?.specular) out.specular = { ...base?.specular, ...over?.specular };
62
+ if (base?.shadow || over?.shadow) out.shadow = { ...base?.shadow, ...over?.shadow };
63
+ if (base?.tint || over?.tint)
64
+ out.tint = { ...base?.tint, ...over?.tint };
65
+ return out;
66
+ }
67
+ function liquidRim(strength = 1, angle = -120, fresnel = 0) {
68
+ const radians = angle * Math.PI / 180;
69
+ const x = round(-Math.cos(radians) * 2);
70
+ const y = round(-Math.sin(radians) * 2);
71
+ const s = round(clamp(strength, 0, 2));
72
+ const white = (alpha) => `color-mix(in srgb, white min(100%, calc(${alpha} * 100%)), transparent)`;
73
+ const layers = [
74
+ `inset ${x}px ${y}px 0 -.5px ${white(`var(--liquid-rim-lit, .95) * ${s}`)}`,
75
+ `inset ${-x}px ${-y}px 0 -.5px ${white(`var(--liquid-rim-back, .7) * ${s}`)}`,
76
+ `inset 0 0 0 1px ${white(`var(--liquid-rim-ring, .5) * ${s}`)}`
77
+ ];
78
+ const f = clamp(fresnel, 0, 1);
79
+ if (f > 0) layers.push(`inset 0 0 18px ${white(String(round(f * 0.4)))}`);
80
+ return layers.join(", ");
81
+ }
82
+ function liquidShadow({
83
+ opacity = 1,
84
+ spread,
85
+ offsetY
86
+ } = {}) {
87
+ const a = round(clamp(opacity, 0, 2));
88
+ const alpha = "var(--liquid-shadow-alpha, .2)";
89
+ const ink = (factor) => `color-mix(in srgb, var(--liquid-shadow-ink, black) min(100%, calc(${alpha} * ${factor} * 100%)), transparent)`;
90
+ const k = "var(--liquid-size, 1)";
91
+ const drop = offsetY === void 0 ? "var(--liquid-shadow-drop, 10px)" : `${round(offsetY)}px`;
92
+ const blur = spread === void 0 ? "var(--liquid-shadow-blur, 30px)" : `${round(30 + spread)}px`;
93
+ return [
94
+ `0 calc(${drop} * ${k}) calc(${blur} * ${k}) -6px ${ink(String(a))}`,
95
+ `0 calc(2px * ${k}) calc(6px * ${k}) ${ink(`${a} * var(--liquid-shadow-contact, .4)`)}`
96
+ ].join(", ");
97
+ }
98
+ function liquidGrain(amount) {
99
+ const a = round(clamp(amount, 0, 1) * 0.5);
100
+ const svg = `<svg xmlns='http://www.w3.org/2000/svg' width='160' height='160'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='2' stitchTiles='stitch'/><feColorMatrix values='0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 ${a} 0 0 0 0'/></filter><rect width='100%' height='100%' filter='url(#n)'/></svg>`;
101
+ return `url("data:image/svg+xml,${encodeURIComponent(svg)}")`;
102
+ }
103
+ function liquidVars(options = {}) {
104
+ const out = {};
105
+ const set = (name, value) => {
106
+ if (value !== void 0) out[`--liquid-${name}`] = String(value);
107
+ };
108
+ const num = (value, min, max) => finite(value) ? round(clamp(value, min, max)) : void 0;
109
+ set("refraction", num(options.refraction, 0, 2));
110
+ const bevel = num(options.bevelWidth, 0, 120);
111
+ if (bevel !== void 0) set("bevel", `${bevel}px`);
112
+ if (options.profile) set("profile", options.profile);
113
+ set("dispersion", num(options.dispersion, 0, 0.2));
114
+ const frost = num(options.frost, 0, 40);
115
+ if (frost !== void 0) set("frost", `${frost}px`);
116
+ set("saturation", num(options.saturation, 0, 4));
117
+ const brightness = num(options.brightness, 0, 3);
118
+ set("brightness", brightness);
119
+ if (brightness !== void 0) set("brightness-fn", `brightness(${brightness})`);
120
+ if (options.tint) {
121
+ set("tint-color", options.tint.color);
122
+ set("tint-amount", num(options.tint.amount ?? LIQUID_DEFAULTS.tint.amount, 0, 1));
123
+ }
124
+ const rim = num(options.rim, 0, 2);
125
+ set("rim-strength", rim);
126
+ const intensity = num(options.specular?.intensity, 0, 2);
127
+ set("specular", intensity);
128
+ const angle = finite(options.specular?.angle) ? round(options.specular.angle) : void 0;
129
+ set("specular-angle", angle);
130
+ const fresnel = num(options.fresnel, 0, 1);
131
+ set("fresnel", fresnel);
132
+ if (rim !== void 0 || angle !== void 0 || fresnel !== void 0)
133
+ set("rim-custom", liquidRim(rim ?? 1, angle ?? -120, fresnel ?? 0));
134
+ const grain = num(options.grain, 0, 1);
135
+ set("grain", grain);
136
+ if (grain) out["--glass-noise"] = liquidGrain(grain);
137
+ const radius = num(options.radius, 0, 999);
138
+ if (radius !== void 0) set("radius", `${radius}px`);
139
+ set("opacity", num(options.opacity, 0, 1));
140
+ if (options.shadow) {
141
+ const { opacity, spread, offsetY } = options.shadow;
142
+ set("shadow-opacity", num(opacity, 0, 2));
143
+ set("shadow-spread", num(spread, 0, 80));
144
+ set("shadow-offset", num(offsetY, -40, 80));
145
+ set(
146
+ "shadow-custom",
147
+ liquidShadow({
148
+ opacity: num(opacity, 0, 2),
149
+ spread: num(spread, 0, 80),
150
+ offsetY: num(offsetY, -40, 80)
151
+ })
152
+ );
153
+ }
154
+ if (options.interactive) set("interactive", options.interactive);
155
+ if (options.motion !== void 0)
156
+ set("motion", options.motion === false ? "off" : options.motion);
157
+ return out;
158
+ }
159
+ function liquidStyle(options = {}) {
160
+ const vars = liquidVars(options);
161
+ if (vars["--liquid-radius"])
162
+ return { ...vars, borderRadius: "var(--liquid-radius)" };
163
+ return vars;
164
+ }
165
+ export {
166
+ LIQUID_DEFAULTS,
167
+ LIQUID_MOTIONS,
168
+ LIQUID_PRESETS,
169
+ LIQUID_PRESET_CLEAR,
170
+ LIQUID_PRESET_CRYSTAL,
171
+ LIQUID_PRESET_REGULAR,
172
+ LIQUID_PRESET_THICK,
173
+ liquidGrain,
174
+ liquidRim,
175
+ liquidShadow,
176
+ liquidStyle,
177
+ liquidVars,
178
+ mergeLiquid
179
+ };
@@ -0,0 +1,100 @@
1
+ import { type LensCoverage } from "./displacement-map.js";
2
+ export interface GlassRefractionOptions {
3
+ /**
4
+ * `scale` of the displacement filter (the source offset at the edge is half of it). Default:
5
+ * `scaleFor()`, the strongest bend that cannot fold back on itself. Above that, stripes
6
+ * behind the glass break into a sawtooth.
7
+ */
8
+ scale?: number;
9
+ /**
10
+ * Width of the refracting bevel in px; the middle of the surface shows the backdrop
11
+ * undisplaced. Default: 1.2 times the corner radius, between 14 and 56 px and at most 45% of
12
+ * the short side (so a small pill keeps a clear middle).
13
+ */
14
+ bezel?: number;
15
+ /**
16
+ * `"full"` (default): the lens bends the backdrop over the whole surface, strongest at the rim
17
+ * and gentle but never zero towards the centre, with at most 24 px of offset. `"dome"`: the
18
+ * same with round contours. `"rim"`: only the bevel, the middle shows the backdrop undisplaced.
19
+ * CSS: `--liquid-profile` (older name: `--glass-lens-coverage`). The other `--liquid-*`
20
+ * variables (see `LiquidGlassOptions`) are read live: change them and the lens follows.
21
+ */
22
+ coverage?: LensCoverage;
23
+ /**
24
+ * Chromatic dispersion: how far apart the red and blue channels are pulled, as a fraction of
25
+ * `scale`. It runs three displacement passes instead of one (about +50% to +100% of the lens
26
+ * cost), so it is off by default (it also paints a colour fringe on hard edges). Pass a number,
27
+ * or set `--glass-lens-dispersion` in CSS, to turn it on; it only applies on surfaces up to
28
+ * 100,000 px squared.
29
+ */
30
+ dispersion?: number;
31
+ /**
32
+ * Move the legibility veil of a liquid surface into the filter, where it is adaptive (only as
33
+ * strong as the backdrop needs, so the body stays clear over friendly backdrops) and eases off
34
+ * across the rim. Default true; `false` keeps the uniform CSS veil.
35
+ */
36
+ veil?: boolean;
37
+ /**
38
+ * Directional rim light inside the filter: a glint on the walls facing the upper left (and a
39
+ * weaker one opposite) that is the lensed backdrop pushed to a high saturation, a dark contour
40
+ * and a faint inner shadow. Default true.
41
+ */
42
+ specular?: boolean;
43
+ /**
44
+ * Motion: the lens materialises when it is first applied (the refraction springs up from
45
+ * nothing), a press deepens it and swells the surface, and `--liquid-interactive: drag` lets the
46
+ * surface be pulled and squashed. Default true; `--liquid-motion: off` turns it off per surface.
47
+ * Never runs under reduced motion, where the lens is not applied at all.
48
+ */
49
+ animate?: boolean;
50
+ /**
51
+ * Read the pointer mode (`--liquid-interactive`) only from the element itself (its inline
52
+ * style, or the value of `data-glass-interactive`), not from a scope or theme above it. The
53
+ * overlay components (dialog, popover, sidebar, drawer) set it, so a page-wide
54
+ * `--liquid-interactive` never makes them pressable or draggable. Default false.
55
+ */
56
+ ownInteractive?: boolean;
57
+ /**
58
+ * Only refract while the surface resolves to a liquid material (the `--glass-lens` flag the
59
+ * `liquid` utilities set). This is what the glass components use. Default false.
60
+ */
61
+ auto?: boolean;
62
+ /**
63
+ * `"auto"` (default) only refracts where {@link supportsBackdropRefraction} is true and the user
64
+ * has not asked for less transparency, more contrast or less motion. `"force"` skips the
65
+ * engine check (never the accessibility ones).
66
+ */
67
+ refraction?: "auto" | "force";
68
+ }
69
+ /** Who asked for a lens: code (`applyGlassRefraction`) or the page watcher (`<LiquidGlass />`). */
70
+ export type LensOwner = "manual" | "auto";
71
+ /**
72
+ * Opt-in lensing for a glass surface (`glass`, `glass-clear`, `surface-overlay`): bends the
73
+ * backdrop along the rim with an SVG displacement filter and marks the element
74
+ * `data-glass-refraction="on"`.
75
+ *
76
+ * It does nothing, and leaves the plain blur, where the engine cannot paint it. It also follows
77
+ * the user's preferences live: reduced transparency, more contrast, forced colors or reduced
78
+ * motion remove it, and clearing them brings it back. Calling it again on the same element
79
+ * updates the options instead of stacking a second filter. Returns the cleanup function (every
80
+ * returned cleanup ends the same claim). These options win over `<LiquidGlass />` on the same
81
+ * element, and the watcher never stops this lens; after the cleanup, a surface the watcher also
82
+ * lenses keeps its automatic lens. Never on by default: it re-rasterises the
83
+ * backdrop every frame.
84
+ */
85
+ export declare function applyGlassRefraction(element: HTMLElement, options?: GlassRefractionOptions): () => void;
86
+ /**
87
+ * The `backdrop-filter` the surface's own styles resolve to, as if no lens were on it (the engine
88
+ * replaces the inline value, and a crystal lens moves the filter to its layer). It is how the
89
+ * watcher tells a lensed surface that still paints a backdrop from one that merely inherits the
90
+ * `--glass-lens` flag after its own liquid class stopped applying.
91
+ */
92
+ export declare function ownBackdropFilter(element: HTMLElement): string;
93
+ /**
94
+ * Adds a claim on the element's lens for `owner` and returns its release. One controller per
95
+ * element: the manual options win over the automatic ones, and the lens stops only once every
96
+ * owner released it, so `<LiquidGlass />` never undoes or replaces a lens applied by code. Every
97
+ * release of one owner's claim ends that claim; a release left over from an earlier claim is a
98
+ * no-op.
99
+ */
100
+ export declare function claimLens(element: HTMLElement, owner: LensOwner, options: GlassRefractionOptions): () => void;