@jcsoftdev/ui 0.2.3 → 0.3.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 (375) hide show
  1. package/CHANGELOG.md +288 -7
  2. package/README.md +2 -1
  3. package/bin/ui-theme.mjs +1151 -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 +23 -2
  19. package/dist/atoms/chip/chip.d.ts +9 -3
  20. package/dist/atoms/chip/chip.js +26 -4
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +4 -1
  23. package/dist/atoms/status-dot/index.d.ts +1 -1
  24. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  25. package/dist/atoms/status-dot/status-dot.js +5 -1
  26. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  27. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  28. package/dist/charts/chord-chart/chord-chart.js +13 -5
  29. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  30. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  31. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  32. package/dist/charts/core/cartesian/layout.js +14 -5
  33. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  34. package/dist/charts/core/cartesian/marks.js +1 -1
  35. package/dist/charts/core/cartesian/types.d.ts +28 -2
  36. package/dist/charts/core/category-explorer.d.ts +2 -2
  37. package/dist/charts/core/category-explorer.js +8 -4
  38. package/dist/charts/core/chart-dock.d.ts +26 -0
  39. package/dist/charts/core/chart-dock.js +45 -0
  40. package/dist/charts/core/chart-frame.d.ts +9 -2
  41. package/dist/charts/core/chart-frame.js +105 -25
  42. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  43. package/dist/charts/core/distribution/explorer.js +12 -5
  44. package/dist/charts/core/distribution/xy-points.js +1 -1
  45. package/dist/charts/core/index.d.ts +3 -0
  46. package/dist/charts/core/index.js +3 -0
  47. package/dist/charts/core/leave-grace.d.ts +11 -0
  48. package/dist/charts/core/leave-grace.js +26 -0
  49. package/dist/charts/core/nearest.d.ts +14 -0
  50. package/dist/charts/core/nearest.js +22 -0
  51. package/dist/charts/core/plot-overlay.js +9 -3
  52. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  53. package/dist/charts/core/pointer.test-utils.js +123 -0
  54. package/dist/charts/core/tooltip.d.ts +25 -2
  55. package/dist/charts/core/tooltip.js +115 -40
  56. package/dist/charts/core/touch-select.d.ts +20 -0
  57. package/dist/charts/core/touch-select.js +184 -0
  58. package/dist/charts/core/types.d.ts +8 -4
  59. package/dist/charts/core/types.js +5 -0
  60. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  61. package/dist/charts/core/use-index-navigation.js +47 -10
  62. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  63. package/dist/charts/donut-chart/donut-chart.js +40 -1
  64. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  65. package/dist/charts/donut-chart/slice-labels.js +20 -0
  66. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  67. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  68. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  69. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  70. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  71. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  72. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  73. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  74. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  75. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  76. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  77. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  78. package/dist/charts/maps/geo/map-viewport.js +1 -1
  79. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  80. package/dist/charts/progress-units/progress-units.js +1 -0
  81. package/dist/charts/radar-chart/radar-chart.js +1 -1
  82. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  83. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  84. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  85. package/dist/charts/tree-chart/tree-chart.js +1 -0
  86. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  87. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  88. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  89. package/dist/containers/action-bar/action-bar.js +4 -1
  90. package/dist/containers/card/card.d.ts +21 -3
  91. package/dist/containers/card/card.js +20 -5
  92. package/dist/containers/grid/grid.d.ts +15 -0
  93. package/dist/containers/grid/grid.js +24 -0
  94. package/dist/containers/grid/index.d.ts +1 -0
  95. package/dist/containers/grid/index.js +4 -0
  96. package/dist/containers/index.d.ts +3 -0
  97. package/dist/containers/index.js +3 -0
  98. package/dist/containers/kpi/kpi.d.ts +13 -2
  99. package/dist/containers/kpi/kpi.js +86 -24
  100. package/dist/containers/kpi-group/index.d.ts +1 -1
  101. package/dist/containers/kpi-group/index.js +3 -1
  102. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  103. package/dist/containers/kpi-group/kpi-group.js +11 -1
  104. package/dist/containers/page/index.d.ts +1 -0
  105. package/dist/containers/page/index.js +4 -0
  106. package/dist/containers/page/page.d.ts +7 -0
  107. package/dist/containers/page/page.js +14 -0
  108. package/dist/containers/page-header/page-header.d.ts +8 -3
  109. package/dist/containers/page-header/page-header.js +35 -8
  110. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  111. package/dist/containers/responsive-list/responsive-list.js +6 -3
  112. package/dist/containers/stack/index.d.ts +1 -0
  113. package/dist/containers/stack/index.js +6 -0
  114. package/dist/containers/stack/stack.d.ts +15 -0
  115. package/dist/containers/stack/stack.js +43 -0
  116. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  117. package/dist/forms/copy-field/copy-field.js +72 -0
  118. package/dist/forms/copy-field/index.d.ts +1 -0
  119. package/dist/forms/copy-field/index.js +4 -0
  120. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  121. package/dist/forms/form/form.d.ts +15 -0
  122. package/dist/forms/form/form.js +29 -0
  123. package/dist/forms/form/index.d.ts +1 -0
  124. package/dist/forms/form/index.js +10 -0
  125. package/dist/forms/index.d.ts +2 -0
  126. package/dist/forms/index.js +2 -0
  127. package/dist/forms/input/index.d.ts +1 -1
  128. package/dist/forms/input/index.js +3 -2
  129. package/dist/forms/input/input.d.ts +6 -2
  130. package/dist/forms/input/input.js +9 -3
  131. package/dist/glass/crystal-map.d.ts +70 -0
  132. package/dist/glass/crystal-map.js +88 -0
  133. package/dist/glass/displacement-map.d.ts +117 -0
  134. package/dist/glass/displacement-map.js +201 -0
  135. package/dist/glass/index.d.ts +8 -0
  136. package/dist/glass/index.js +63 -0
  137. package/dist/glass/lens-crystal.d.ts +29 -0
  138. package/dist/glass/lens-crystal.js +161 -0
  139. package/dist/glass/lens-dispersion.d.ts +11 -0
  140. package/dist/glass/lens-dispersion.js +19 -0
  141. package/dist/glass/liquid-glass.d.ts +41 -0
  142. package/dist/glass/liquid-glass.js +256 -0
  143. package/dist/glass/liquid-motion.d.ts +53 -0
  144. package/dist/glass/liquid-motion.js +302 -0
  145. package/dist/glass/liquid-options.d.ts +162 -0
  146. package/dist/glass/liquid-options.js +179 -0
  147. package/dist/glass/refraction.d.ts +100 -0
  148. package/dist/glass/refraction.js +714 -0
  149. package/dist/glass/specular-map.d.ts +26 -0
  150. package/dist/glass/specular-map.js +75 -0
  151. package/dist/glass/spring.d.ts +79 -0
  152. package/dist/glass/spring.js +58 -0
  153. package/dist/glass/support.d.ts +13 -0
  154. package/dist/glass/support.js +14 -0
  155. package/dist/glass/use-glass-refraction.d.ts +8 -0
  156. package/dist/glass/use-glass-refraction.js +16 -0
  157. package/dist/i18n/strings.d.ts +24 -0
  158. package/dist/i18n/strings.js +18 -2
  159. package/dist/icons/index.d.ts +2 -0
  160. package/dist/icons/index.js +4 -0
  161. package/dist/icons/key.d.ts +2 -0
  162. package/dist/icons/key.js +12 -0
  163. package/dist/icons/webhook.d.ts +2 -0
  164. package/dist/icons/webhook.js +12 -0
  165. package/dist/liquid/index.d.ts +3 -0
  166. package/dist/liquid/index.js +29 -0
  167. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  168. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  169. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  170. package/dist/navigation/breadcrumbs/index.js +6 -0
  171. package/dist/navigation/index.d.ts +1 -0
  172. package/dist/navigation/index.js +1 -0
  173. package/dist/navigation/segmented/index.d.ts +1 -1
  174. package/dist/navigation/segmented/model.d.ts +5 -0
  175. package/dist/navigation/segmented/model.js +6 -0
  176. package/dist/navigation/segmented/segmented.d.ts +17 -3
  177. package/dist/navigation/segmented/segmented.js +20 -4
  178. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  179. package/dist/overlays/context-menu/context-menu.js +4 -1
  180. package/dist/overlays/dialog/dialog.d.ts +9 -1
  181. package/dist/overlays/dialog/dialog.js +3 -0
  182. package/dist/overlays/drawer/drawer.d.ts +9 -1
  183. package/dist/overlays/drawer/drawer.js +3 -0
  184. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +9 -1
  185. package/dist/overlays/dropdown-menu/dropdown-menu.js +3 -1
  186. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  187. package/dist/overlays/hover-card/hover-card.js +4 -1
  188. package/dist/overlays/popover/popover.d.ts +9 -1
  189. package/dist/overlays/popover/popover.js +3 -0
  190. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  191. package/dist/palette/command-palette/command-palette.js +5 -0
  192. package/dist/primitives/command/command.d.ts +3 -2
  193. package/dist/primitives/command/command.js +2 -0
  194. package/dist/primitives/menu/menu.js +1 -1
  195. package/dist/primitives/popper/popper.js +5 -0
  196. package/dist/rich-text/rich-text-editor.js +94 -8
  197. package/dist/rich-text/sanitize.js +70 -20
  198. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  199. package/dist/shell/app-shell/app-shell.js +44 -4
  200. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  201. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  202. package/dist/shell/bottom-nav/index.d.ts +2 -0
  203. package/dist/shell/bottom-nav/index.js +9 -0
  204. package/dist/shell/bottom-nav/split.d.ts +11 -0
  205. package/dist/shell/bottom-nav/split.js +10 -0
  206. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  207. package/dist/shell/sidebar/sidebar.js +46 -4
  208. package/dist/shell/topbar/topbar.d.ts +20 -9
  209. package/dist/shell/topbar/topbar.js +16 -9
  210. package/dist/states/empty-state/empty-state.d.ts +3 -1
  211. package/dist/states/empty-state/empty-state.js +9 -1
  212. package/dist/states/error-state/error-state.d.ts +3 -1
  213. package/dist/states/error-state/error-state.js +2 -0
  214. package/dist/states/index.d.ts +1 -0
  215. package/dist/states/index.js +1 -0
  216. package/dist/states/live-status-bar/index.d.ts +1 -0
  217. package/dist/states/live-status-bar/index.js +6 -0
  218. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  219. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  220. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  221. package/dist/states/offline-banner/offline-banner.js +8 -4
  222. package/dist/utils/class-groups.js +17 -0
  223. package/dist/utils/index.d.ts +1 -0
  224. package/dist/utils/index.js +2 -0
  225. package/dist/utils/material.d.ts +13 -0
  226. package/dist/utils/material.js +6 -0
  227. package/dist/utils/tone.d.ts +8 -0
  228. package/dist/utils/tone.js +17 -0
  229. package/dist/utils/use-copy.d.ts +5 -0
  230. package/dist/utils/use-copy.js +35 -0
  231. package/icons/svg/key.svg +5 -0
  232. package/icons/svg/webhook.svg +5 -0
  233. package/package.json +31 -21
  234. package/scripts/build-theme.d.mts +22 -0
  235. package/scripts/build-theme.mjs +236 -4
  236. package/src/ai/attachment/attachment.tsx +1 -1
  237. package/src/ai/chat-list/group.ts +3 -1
  238. package/src/ai/conversation/conversation.tsx +1 -1
  239. package/src/ai/internal/use-copy.ts +1 -38
  240. package/src/ai/markdown/parse.ts +74 -17
  241. package/src/ai/source/source.tsx +1 -1
  242. package/src/atoms/avatar/avatar.tsx +57 -4
  243. package/src/atoms/avatar/index.ts +8 -1
  244. package/src/atoms/button/button.tsx +8 -3
  245. package/src/atoms/checkbox/checkbox.tsx +30 -3
  246. package/src/atoms/chip/chip.tsx +37 -5
  247. package/src/atoms/chip/index.ts +7 -1
  248. package/src/atoms/status-dot/index.ts +1 -0
  249. package/src/atoms/status-dot/status-dot.tsx +15 -3
  250. package/src/charts/README.md +21 -0
  251. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  252. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  253. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  254. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  255. package/src/charts/core/cartesian/layout.ts +29 -10
  256. package/src/charts/core/cartesian/marks.tsx +3 -3
  257. package/src/charts/core/cartesian/types.ts +30 -2
  258. package/src/charts/core/category-explorer.tsx +12 -6
  259. package/src/charts/core/chart-dock.tsx +68 -0
  260. package/src/charts/core/chart-frame.tsx +116 -27
  261. package/src/charts/core/distribution/explorer.tsx +17 -7
  262. package/src/charts/core/distribution/xy-points.tsx +1 -1
  263. package/src/charts/core/index.ts +3 -0
  264. package/src/charts/core/leave-grace.ts +35 -0
  265. package/src/charts/core/nearest.ts +38 -0
  266. package/src/charts/core/plot-overlay.tsx +9 -3
  267. package/src/charts/core/pointer.test-utils.ts +146 -0
  268. package/src/charts/core/tooltip.tsx +129 -15
  269. package/src/charts/core/touch-select.ts +250 -0
  270. package/src/charts/core/types.ts +13 -4
  271. package/src/charts/core/use-index-navigation.ts +70 -11
  272. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  273. package/src/charts/donut-chart/slice-labels.ts +39 -0
  274. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  275. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  276. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  277. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  278. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  279. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  280. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  281. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  282. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  283. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  284. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  285. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  286. package/src/charts/progress-units/progress-units.tsx +1 -0
  287. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  288. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  289. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  290. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  291. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  292. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  293. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  294. package/src/containers/action-bar/action-bar.tsx +13 -2
  295. package/src/containers/card/card.tsx +43 -4
  296. package/src/containers/grid/grid.tsx +37 -0
  297. package/src/containers/grid/index.ts +1 -0
  298. package/src/containers/index.ts +3 -0
  299. package/src/containers/kpi/kpi.tsx +116 -22
  300. package/src/containers/kpi-group/index.ts +7 -1
  301. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  302. package/src/containers/page/index.ts +1 -0
  303. package/src/containers/page/page.tsx +17 -0
  304. package/src/containers/page-header/page-header.tsx +38 -8
  305. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  306. package/src/containers/stack/index.ts +7 -0
  307. package/src/containers/stack/stack.tsx +55 -0
  308. package/src/forms/copy-field/copy-field.tsx +88 -0
  309. package/src/forms/copy-field/index.ts +1 -0
  310. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  311. package/src/forms/form/form.tsx +46 -0
  312. package/src/forms/form/index.ts +8 -0
  313. package/src/forms/index.ts +2 -0
  314. package/src/forms/input/index.ts +1 -1
  315. package/src/forms/input/input.tsx +14 -3
  316. package/src/glass/crystal-map.ts +150 -0
  317. package/src/glass/displacement-map.ts +317 -0
  318. package/src/glass/index.ts +43 -0
  319. package/src/glass/lens-crystal.ts +226 -0
  320. package/src/glass/lens-dispersion.ts +34 -0
  321. package/src/glass/liquid-glass.tsx +371 -0
  322. package/src/glass/liquid-motion.ts +395 -0
  323. package/src/glass/liquid-options.ts +306 -0
  324. package/src/glass/refraction.ts +1010 -0
  325. package/src/glass/specular-map.ts +95 -0
  326. package/src/glass/spring.ts +98 -0
  327. package/src/glass/support.ts +27 -0
  328. package/src/glass/use-glass-refraction.ts +21 -0
  329. package/src/i18n/strings.ts +24 -0
  330. package/src/icons/index.ts +2 -0
  331. package/src/icons/key.tsx +13 -0
  332. package/src/icons/webhook.tsx +13 -0
  333. package/src/liquid/index.ts +24 -0
  334. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  335. package/src/navigation/breadcrumbs/index.ts +8 -0
  336. package/src/navigation/index.ts +1 -0
  337. package/src/navigation/segmented/index.ts +1 -0
  338. package/src/navigation/segmented/model.ts +11 -0
  339. package/src/navigation/segmented/segmented.tsx +45 -6
  340. package/src/overlays/context-menu/context-menu.tsx +11 -1
  341. package/src/overlays/dialog/dialog.tsx +10 -0
  342. package/src/overlays/drawer/drawer.tsx +10 -0
  343. package/src/overlays/dropdown-menu/dropdown-menu.tsx +10 -1
  344. package/src/overlays/hover-card/hover-card.tsx +12 -1
  345. package/src/overlays/popover/popover.tsx +10 -0
  346. package/src/palette/command-palette/command-palette.tsx +15 -1
  347. package/src/primitives/command/command.tsx +4 -0
  348. package/src/primitives/menu/menu.tsx +1 -1
  349. package/src/primitives/popper/popper.tsx +10 -0
  350. package/src/rich-text/rich-text-editor.tsx +116 -13
  351. package/src/rich-text/sanitize.ts +94 -23
  352. package/src/shell/app-shell/app-shell.tsx +60 -4
  353. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  354. package/src/shell/bottom-nav/index.ts +8 -0
  355. package/src/shell/bottom-nav/split.ts +20 -0
  356. package/src/shell/sidebar/sidebar.tsx +51 -5
  357. package/src/shell/topbar/topbar.tsx +81 -58
  358. package/src/states/empty-state/empty-state.tsx +11 -1
  359. package/src/states/error-state/error-state.tsx +4 -0
  360. package/src/states/index.ts +1 -0
  361. package/src/states/live-status-bar/index.ts +6 -0
  362. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  363. package/src/states/offline-banner/offline-banner.tsx +13 -5
  364. package/src/utils/class-groups.ts +17 -0
  365. package/src/utils/index.ts +1 -0
  366. package/src/utils/material.ts +16 -0
  367. package/src/utils/tone.ts +29 -0
  368. package/src/utils/use-copy.ts +38 -0
  369. package/styles/Theme.kt +64 -3
  370. package/styles/base.css +51 -0
  371. package/styles/tailwind.css +833 -0
  372. package/styles/theme.css +546 -4
  373. package/styles/tokens.css +788 -15
  374. package/tokens/default.json +918 -29
  375. package/scripts/build-theme.d.ts +0 -18
@@ -0,0 +1,226 @@
1
+ import { createCrystalMap, crystalAmplitude, crystalMargin } from "./crystal-map.js";
2
+
3
+ /**
4
+ * The crystal map covers the surface and its margin (often several times the surface), and every
5
+ * pixel of it is computed on the main thread. The ratio is lowered to hold the map near this many
6
+ * pixels, but never below half a pixel per CSS pixel (which the smooth field and the bilinear
7
+ * `feImage` scaling do not show), so a layer larger than twice this at 0.5 still exceeds it.
8
+ */
9
+ const CRYSTAL_MAP_PIXELS = 48_000;
10
+
11
+ /** Ancestors that cut the backdrop: whatever lies past their edge is not there for a backdrop filter. */
12
+ function clippingAncestors(element: Element): Element[] {
13
+ const found: Element[] = [];
14
+ for (let node = element.parentElement; node; node = node.parentElement) {
15
+ const style = getComputedStyle(node);
16
+ const clips =
17
+ style.clipPath !== "none" ||
18
+ [style.overflowX, style.overflowY].some((value) => value !== "visible") ||
19
+ /paint|strict|content/.test(style.contain);
20
+ if (clips) found.push(node);
21
+ }
22
+ return found;
23
+ }
24
+
25
+ /**
26
+ * How much backdrop lies past each side of `element`, in px, up to `margin` and rounded down to
27
+ * `step` (so a surface dragged along an edge does not rebuild its map on every pixel).
28
+ */
29
+ function backdropRoom(element: Element, clips: Element[], margin: number, step = 12) {
30
+ const box = element.getBoundingClientRect();
31
+ const room = { left: margin, right: margin, top: margin, bottom: margin };
32
+ for (const clip of clips) {
33
+ const edge = clip.getBoundingClientRect();
34
+ room.left = Math.min(room.left, box.left - edge.left);
35
+ room.right = Math.min(room.right, edge.right - box.right);
36
+ room.top = Math.min(room.top, box.top - edge.top);
37
+ room.bottom = Math.min(room.bottom, edge.bottom - box.bottom);
38
+ }
39
+ for (const side of ["left", "right", "top", "bottom"] as const)
40
+ room[side] = Math.min(margin, Math.max(0, Math.floor(room[side] / step) * step));
41
+ return room;
42
+ }
43
+
44
+ /** What the engine hands the crystal lens of one installed filter. */
45
+ export interface CrystalContext {
46
+ element: HTMLElement;
47
+ /** Id of the SVG filter, and the CSS that comes before it in `backdrop-filter`. */
48
+ id: string;
49
+ blur: string;
50
+ /** The surface's own inline `backdrop-filter` before the engine touched it. */
51
+ original: string;
52
+ filter: SVGFilterElement;
53
+ image: Element;
54
+ /** The layer or the skin was removed from the surface: install again. */
55
+ reinstall: () => void;
56
+ /** The backdrop room around the surface changed: rebuild the map. */
57
+ resize: () => void;
58
+ }
59
+
60
+ export interface CrystalLens {
61
+ /** Lays the map out for a size; returns the filter scale, or `undefined` when nothing changed. */
62
+ update(
63
+ width: number,
64
+ height: number,
65
+ radius: number,
66
+ refraction: number,
67
+ dispersion: number,
68
+ dpr: number,
69
+ ): number | undefined;
70
+ /** Removes the layer and the skin and gives the surface its own styles back. */
71
+ undo(): void;
72
+ }
73
+
74
+ /**
75
+ * The crystal lens samples the backdrop outside the surface (it minifies), which a filter on the
76
+ * surface itself cannot see. So the filter goes on a layer that extends past the surface by the
77
+ * largest offset, clipped back to the silhouette; the surface's own backdrop filter, background and
78
+ * inset shadows move to (or under) that layer's siblings, because the layer must be the lowest
79
+ * thing in the surface. Its own lazy chunk: the engine imports it only for a crystal surface.
80
+ */
81
+ export function installCrystal({
82
+ element,
83
+ id,
84
+ blur,
85
+ original,
86
+ filter,
87
+ image,
88
+ reinstall,
89
+ resize,
90
+ }: CrystalContext): CrystalLens {
91
+ const saved = {
92
+ position: element.style.position,
93
+ isolation: element.style.isolation,
94
+ overflow: element.style.overflow,
95
+ boxShadow: element.style.boxShadow,
96
+ backgroundImage: element.style.backgroundImage,
97
+ backgroundColor: element.style.backgroundColor,
98
+ backdropFilter: original,
99
+ };
100
+ if (getComputedStyle(element).position === "static") element.style.position = "relative";
101
+ element.style.isolation = "isolate";
102
+ element.style.overflow = "visible";
103
+ element.style.backgroundImage = "none";
104
+ element.style.backgroundColor = "transparent";
105
+ element.style.setProperty("--glass-lens-tint", "transparent");
106
+ const border = element.matches(".liquid-clear")
107
+ ? "--glass-clear-border"
108
+ : "--glass-regular-border";
109
+ // Nothing the surface paints may sit under the layer: the lens would minify its own ring and
110
+ // drop shadow into view. They all move to the skin, which paints above the layer.
111
+ element.style.boxShadow = "none";
112
+ const make = (css: string) => {
113
+ const span = document.createElement("span");
114
+ span.setAttribute("aria-hidden", "true");
115
+ span.style.cssText = `position:absolute;z-index:-1;pointer-events:none;${css}`;
116
+ return span;
117
+ };
118
+ const layer = make("border-radius:0;");
119
+ layer.dataset.glassLensLayer = "";
120
+ layer.style.backdropFilter = `${blur}url(#${id})`;
121
+ layer.style.setProperty("-webkit-backdrop-filter", `${blur}url(#${id})`);
122
+ const skin = make(
123
+ "inset:0;border-radius:inherit;" +
124
+ "background-image:var(--glass-noise),radial-gradient(circle at var(--liquid-glow-x,50%) var(--liquid-glow-y,50%),color-mix(in srgb,white calc(var(--liquid-glow,0)*15%),transparent),transparent 70%),linear-gradient(var(--liquid-tint-fill),var(--liquid-tint-fill)),linear-gradient(var(--liquid-veil-fill),var(--liquid-veil-fill));" +
125
+ `box-shadow:var(--liquid-rim-auto,var(--liquid-rim-custom,var(--liquid-rim))),var(--liquid-depth),0 0 0 1px var(${border}),var(--liquid-shadow-custom,var(--liquid-shadow-auto,var(--liquid-shadow)));`,
126
+ );
127
+ skin.dataset.glassLensSkin = "";
128
+ element.prepend(skin);
129
+ element.prepend(layer);
130
+ const watch =
131
+ typeof MutationObserver === "function"
132
+ ? new MutationObserver(() => {
133
+ if (!layer.isConnected || !skin.isConnected) reinstall();
134
+ })
135
+ : undefined;
136
+ watch?.observe(element, { childList: true });
137
+
138
+ // A surface that is moved towards the edge of a clipping ancestor (dragged, scrolled) loses
139
+ // backdrop on that side: the layer's overlap with the nearest clip tells when to look again.
140
+ let roomWatch: IntersectionObserver | undefined;
141
+ let roomRoot: Element | undefined;
142
+ const trackRoom = (clips: Element[]) => {
143
+ const root = clips[0];
144
+ if (root === roomRoot || typeof IntersectionObserver !== "function") return;
145
+ roomWatch?.disconnect();
146
+ roomRoot = root;
147
+ if (!root) return;
148
+ roomWatch = new IntersectionObserver(resize, {
149
+ root,
150
+ threshold: Array.from({ length: 51 }, (_, i) => i / 50),
151
+ });
152
+ roomWatch.observe(layer);
153
+ };
154
+
155
+ let key = "";
156
+ return {
157
+ update(width, height, radius, refraction, dispersion, dpr) {
158
+ const amplitude = crystalAmplitude(width, height, refraction);
159
+ const margin = crystalMargin(amplitude, dispersion * 0.6);
160
+ const round = Math.min(radius, width / 2, height / 2);
161
+ const clips = clippingAncestors(element);
162
+ const room = backdropRoom(element, clips, margin);
163
+ const reach = 1 + dispersion * 0.6;
164
+ const wide = width + room.left + room.right;
165
+ const tall = height + room.top + room.bottom;
166
+ trackRoom(clips);
167
+ const next = [
168
+ width,
169
+ height,
170
+ round,
171
+ amplitude,
172
+ margin,
173
+ dpr,
174
+ room.left,
175
+ room.right,
176
+ room.top,
177
+ room.bottom,
178
+ ].join("x");
179
+ if (next === key) return undefined;
180
+ key = next;
181
+ const box = getComputedStyle(element);
182
+ const left = -(room.left + (Number.parseFloat(box.borderLeftWidth) || 0));
183
+ const top = -(room.top + (Number.parseFloat(box.borderTopWidth) || 0));
184
+ layer.style.left = `${left}px`;
185
+ layer.style.top = `${top}px`;
186
+ layer.style.width = `${wide}px`;
187
+ layer.style.height = `${tall}px`;
188
+ layer.style.clipPath = `inset(${room.top}px ${room.right}px ${room.bottom}px ${room.left}px round ${round}px)`;
189
+ for (const [target, name, value] of [
190
+ [filter, "x", "0"],
191
+ [filter, "y", "0"],
192
+ [filter, "width", String(wide)],
193
+ [filter, "height", String(tall)],
194
+ [image, "width", String(wide)],
195
+ [image, "height", String(tall)],
196
+ ] as const)
197
+ target.setAttribute(name, value);
198
+ image.setAttribute(
199
+ "href",
200
+ createCrystalMap({
201
+ width,
202
+ height,
203
+ amplitude,
204
+ dpr: Math.max(0.5, Math.min(dpr, Math.sqrt(CRYSTAL_MAP_PIXELS / (wide * tall)))),
205
+ margin,
206
+ room,
207
+ reach,
208
+ }),
209
+ );
210
+ return (2 * Math.max(amplitude, 1) * 255) / 254;
211
+ },
212
+ undo() {
213
+ watch?.disconnect();
214
+ roomWatch?.disconnect();
215
+ layer.remove();
216
+ skin.remove();
217
+ for (const [name, value] of Object.entries(saved)) {
218
+ if (name === "backdropFilter") continue;
219
+ element.style.setProperty(
220
+ name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`),
221
+ value,
222
+ );
223
+ }
224
+ },
225
+ };
226
+ }
@@ -0,0 +1,34 @@
1
+ /** The node factory and the displacement pass of the lens filter being built. */
2
+ export interface DispersionPasses {
3
+ node: (name: string, attrs: Record<string, string>) => Element;
4
+ displace: (channel: "r" | "g" | "b", factor: number) => void;
5
+ }
6
+
7
+ const KEEP = {
8
+ r: "1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0",
9
+ g: "0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 1 0",
10
+ b: "0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0",
11
+ } as const;
12
+
13
+ const ADD = { operator: "arithmetic", k1: "0", k2: "1", k3: "1", k4: "0" };
14
+
15
+ /**
16
+ * Chromatic dispersion: the three colour channels are displaced by slightly different amounts
17
+ * (blue the least, red the most, so the rim fringes like real glass) and added back into `lens`.
18
+ * Its own lazy chunk: the engine imports it only for a surface that asks for dispersion.
19
+ */
20
+ export function addDispersion(
21
+ { node, displace }: DispersionPasses,
22
+ dispersion: number,
23
+ crystal: boolean,
24
+ ): void {
25
+ // The crystal's offsets are large, so the same fraction would paint a noisy rainbow.
26
+ const spread = crystal ? dispersion * 0.6 : dispersion;
27
+ const factors = { r: 1 + spread, g: 1, b: 1 - spread } as const;
28
+ for (const c of ["r", "g", "b"] as const) {
29
+ displace(c, factors[c]);
30
+ node("feColorMatrix", { in: `d${c}`, type: "matrix", values: KEEP[c], result: c });
31
+ }
32
+ node("feComposite", { in: "r", in2: "g", ...ADD, result: "rg" });
33
+ node("feComposite", { in: "rg", in2: "b", ...ADD, result: "lens" });
34
+ }
@@ -0,0 +1,371 @@
1
+ "use client";
2
+
3
+ import { useEffect } from "react";
4
+ import { supportsBackdropRefraction } from "./support.js";
5
+
6
+ type Engine = typeof import("./refraction.js");
7
+
8
+ /**
9
+ * Elements that may resolve to a lensed liquid material. The decision itself is the computed
10
+ * `--glass-lens` flag, so variants (`md:liquid`, `dark:liquid`, `data-[state=open]:liquid`) and
11
+ * CSS-only toggles count; a custom class built with `@apply liquid` needs `data-glass-lens="on"`.
12
+ */
13
+ const CANDIDATES = [
14
+ '[class*="liquid"]',
15
+ '[class*="glass"]',
16
+ '[class*="surface-overlay"]',
17
+ '[class*="surface-nav"]',
18
+ '[class*="surface-side"]',
19
+ '[style*="--glass-lens:"]',
20
+ '[data-glass-lens="on"]',
21
+ ].join(", ");
22
+ /** Preferences that flip the `--glass-lens` flag in CSS, or a `dark:` variant. */
23
+ const PREFERENCES = [
24
+ "(prefers-reduced-transparency: reduce)",
25
+ "(prefers-contrast: more)",
26
+ "(forced-colors: active)",
27
+ "(prefers-reduced-motion: reduce)",
28
+ "(prefers-color-scheme: dark)",
29
+ ];
30
+ /** Attributes the engine itself writes: never a reason to look again. */
31
+ const ENGINE_ATTRIBUTES = new Set(["data-glass-refraction", "data-glass-lens-layer"]);
32
+ /**
33
+ * Attribute changes that can flip the flag on the element or its subtree: classes, inline styles,
34
+ * and the state attributes variants select on (`data-*`, `aria-*`, `open`).
35
+ */
36
+ const followed = (name: string) =>
37
+ name === "class" ||
38
+ name === "style" ||
39
+ name === "open" ||
40
+ name.startsWith("aria-") ||
41
+ (name.startsWith("data-") && !ENGINE_ATTRIBUTES.has(name));
42
+ /** Subtrees rescanned per frame; more wait for the next frames. */
43
+ const SCANS_PER_FRAME = 64;
44
+ /** Pending subtrees above which one scan of the document replaces them (once, not per frame). */
45
+ const MAX_PENDING = 512;
46
+ /** Quiet time after the last window resize before the candidates are checked again. */
47
+ const RESIZE_MS = 150;
48
+ /** Attempts to fetch the engine chunk before giving up for this watcher. */
49
+ const MAX_ATTEMPTS = 6;
50
+ const RETRY_MAX_MS = 30_000;
51
+
52
+ const defaultLoader = (): Promise<Engine> => import("./refraction.js");
53
+ let loadEngine = defaultLoader;
54
+ /** Delay before retrying a failed engine chunk, doubled per failure. */
55
+ let retryMs = 500;
56
+
57
+ /**
58
+ * Test seam: replaces how the engine chunk is fetched and the first retry delay (`undefined`
59
+ * restores both). Not part of the public entries.
60
+ */
61
+ export function setLiquidEngineLoader(loader?: () => Promise<Engine>, firstRetryMs = 500): void {
62
+ loadEngine = loader ?? defaultLoader;
63
+ retryMs = firstRetryMs;
64
+ }
65
+
66
+ let users = 0;
67
+ let stopAll: (() => void) | undefined;
68
+
69
+ function watch(): () => void {
70
+ const root = document.documentElement;
71
+ /** Surfaces this watcher holds an automatic lens claim on, with the release of that claim. */
72
+ const lensed = new Map<HTMLElement, () => void>();
73
+ let engine: Engine | undefined;
74
+ let loading = false;
75
+ let failures = 0;
76
+ let retryAt = 0;
77
+ let retry: ReturnType<typeof setTimeout> | undefined;
78
+ /** Subtrees to rescan, and single elements to recheck (a resize does not need their subtree). */
79
+ const dirty = new Set<Element>();
80
+ const self = new Set<HTMLElement>();
81
+ /** Every candidate seen, under the size observer; a resize or a preference rechecks these only. */
82
+ const known = new Set<HTMLElement>();
83
+ /** The nearest size container of each candidate, and the candidates under each container. */
84
+ const containerOf = new WeakMap<HTMLElement, Element | null>();
85
+ const underContainer = new Map<Element, Set<HTMLElement>>();
86
+ /** Targets whose first size notification (the one `observe` always sends) is still due. */
87
+ const unprimed = new WeakSet<Element>();
88
+ /** The inline `--glass-lens` last seen per element, so other inline style writes are ignored. */
89
+ const inlineFlag = new WeakMap<Element, string>();
90
+ let frame = 0;
91
+ let resizeTimer: ReturnType<typeof setTimeout> | undefined;
92
+ let closed = false;
93
+
94
+ const release = (element: HTMLElement) => {
95
+ lensed.get(element)?.();
96
+ lensed.delete(element);
97
+ };
98
+
99
+ const wants = (element: HTMLElement) => {
100
+ if (!element.isConnected || element.closest('[data-glass-lens="off"]')) return false;
101
+ const style = getComputedStyle(element);
102
+ // A descendant that only inherits the flag paints no backdrop: it is not a surface. The lens
103
+ // replaces the surface's inline backdrop filter (a crystal lens moves it to its own layer), so
104
+ // for a surface this watcher lensed the computed value says nothing; the engine reads what the
105
+ // surface's own styles resolve to. The inherited flag alone never keeps a lens alive, or a
106
+ // surface whose own `liquid` stopped applying (`data-[state=open]:liquid` closing) under a
107
+ // lensed ancestor would keep it, while an attribute change above a live one still leaves it.
108
+ const lensedHere = lensed.has(element) && element.dataset.glassRefraction === "on";
109
+ const backdrop =
110
+ lensedHere && engine ? engine.ownBackdropFilter(element) : style.backdropFilter;
111
+ return (
112
+ style.getPropertyValue("--glass-lens").trim() === "1" &&
113
+ backdrop !== "none" &&
114
+ style.visibility !== "hidden"
115
+ );
116
+ };
117
+
118
+ const load = () => {
119
+ if (loading || failures >= MAX_ATTEMPTS || Date.now() < retryAt) return;
120
+ loading = true;
121
+ let fetched: Promise<Engine>;
122
+ try {
123
+ fetched = loadEngine();
124
+ } catch (error) {
125
+ fetched = Promise.reject(error);
126
+ }
127
+ // The engine is its own chunk, fetched the first time a surface resolves to a lensed liquid.
128
+ fetched.then(
129
+ (module) => {
130
+ engine = module;
131
+ failures = 0;
132
+ if (!closed) recheckKnown();
133
+ },
134
+ () => {
135
+ loading = false;
136
+ failures++;
137
+ // After the last attempt the page keeps the plain liquid look, quietly.
138
+ if (closed || failures >= MAX_ATTEMPTS) return;
139
+ const delay = Math.min(RETRY_MAX_MS, retryMs * 2 ** (failures - 1));
140
+ retryAt = Date.now() + delay;
141
+ retry = setTimeout(recheckKnown, delay);
142
+ },
143
+ );
144
+ };
145
+
146
+ const observeSize = (target: Element) => {
147
+ if (!sizes) return;
148
+ unprimed.add(target);
149
+ sizes.observe(target);
150
+ };
151
+
152
+ /** The nearest ancestor that is a size container, so a container query is followed. */
153
+ const findContainer = (element: HTMLElement) => {
154
+ for (let node = element.parentElement; node && node !== root; node = node.parentElement)
155
+ if (getComputedStyle(node).containerType !== "normal") return node;
156
+ return null;
157
+ };
158
+
159
+ const remember = (element: HTMLElement) => {
160
+ if (known.has(element)) return;
161
+ known.add(element);
162
+ observeSize(element);
163
+ const container = findContainer(element);
164
+ containerOf.set(element, container);
165
+ if (!container) return;
166
+ let members = underContainer.get(container);
167
+ if (!members) {
168
+ members = new Set();
169
+ underContainer.set(container, members);
170
+ observeSize(container);
171
+ }
172
+ members.add(element);
173
+ };
174
+
175
+ const forget = (element: HTMLElement) => {
176
+ if (!known.delete(element)) return;
177
+ sizes?.unobserve(element);
178
+ release(element);
179
+ self.delete(element);
180
+ const container = containerOf.get(element);
181
+ const members = container && underContainer.get(container);
182
+ if (!members) return;
183
+ members.delete(element);
184
+ if (members.size === 0 && container) {
185
+ underContainer.delete(container);
186
+ sizes?.unobserve(container);
187
+ }
188
+ };
189
+
190
+ const check = (element: HTMLElement) => {
191
+ inlineFlag.set(element, element.style.getPropertyValue("--glass-lens"));
192
+ remember(element);
193
+ if (!wants(element)) release(element);
194
+ else if (lensed.has(element)) return;
195
+ else if (engine)
196
+ // The pointer mode of an automatic lens is the surface's own (its `style` or
197
+ // `data-glass-interactive`): a scope above it never makes it pressable or draggable.
198
+ lensed.set(element, engine.claimLens(element, "auto", { auto: true, ownInteractive: true }));
199
+ else load();
200
+ };
201
+
202
+ const scan = (node: Element) => {
203
+ // A lensed surface whose class changed to something that no longer matches is still checked.
204
+ if (node.matches(CANDIDATES) || known.has(node as HTMLElement)) check(node as HTMLElement);
205
+ for (const element of node.querySelectorAll<HTMLElement>(CANDIDATES)) check(element);
206
+ };
207
+
208
+ /** Lets go of the candidates in a removed subtree, without waiting for a frame. */
209
+ const prune = (node: Element) => {
210
+ if (node.isConnected) return; // moved, not removed
211
+ dirty.delete(node);
212
+ if (node instanceof HTMLElement && known.has(node)) forget(node);
213
+ for (const element of node.querySelectorAll<HTMLElement>(CANDIDATES)) forget(element);
214
+ };
215
+
216
+ const flush = () => {
217
+ frame = 0;
218
+ let budget = SCANS_PER_FRAME;
219
+ for (const node of dirty) {
220
+ if (budget-- <= 0) break;
221
+ dirty.delete(node);
222
+ if (node.isConnected) scan(node);
223
+ }
224
+ const singles = [...self];
225
+ self.clear();
226
+ for (const element of singles) if (element.isConnected) check(element);
227
+ if (dirty.size) later();
228
+ };
229
+
230
+ function later() {
231
+ if (!frame && !closed) frame = requestAnimationFrame(flush);
232
+ }
233
+
234
+ function queue(node: Element) {
235
+ if (!dirty.has(root)) {
236
+ if (dirty.size >= MAX_PENDING) {
237
+ // A hidden tab runs no frames: keep one pending scan instead of an unbounded list.
238
+ dirty.clear();
239
+ dirty.add(root);
240
+ } else dirty.add(node);
241
+ }
242
+ later();
243
+ }
244
+
245
+ function recheckKnown() {
246
+ for (const element of known) self.add(element);
247
+ later();
248
+ }
249
+
250
+ const sizes =
251
+ typeof ResizeObserver === "function"
252
+ ? new ResizeObserver((entries) => {
253
+ for (const { target } of entries) {
254
+ if (unprimed.has(target)) {
255
+ unprimed.delete(target);
256
+ continue;
257
+ }
258
+ // A container query or a size-dependent rule can flip the flag of these candidates.
259
+ const members = underContainer.get(target);
260
+ if (members) for (const element of members) self.add(element);
261
+ if (known.has(target as HTMLElement)) self.add(target as HTMLElement);
262
+ }
263
+ later();
264
+ })
265
+ : undefined;
266
+
267
+ const observer = new MutationObserver((records) => {
268
+ for (const record of records) {
269
+ if (record.type === "attributes") {
270
+ const name = record.attributeName ?? "";
271
+ if (!followed(name)) continue;
272
+ const target = record.target as HTMLElement;
273
+ if (name === "style") {
274
+ // Inline styles change every frame under the motion; only the flag itself matters.
275
+ const flag = target.style?.getPropertyValue("--glass-lens") ?? "";
276
+ if (inlineFlag.has(target) && inlineFlag.get(target) === flag) continue;
277
+ inlineFlag.set(target, flag);
278
+ }
279
+ queue(target);
280
+ } else {
281
+ for (const node of record.removedNodes) if (node instanceof Element) prune(node);
282
+ for (const node of record.addedNodes) if (node instanceof Element) queue(node);
283
+ }
284
+ }
285
+ });
286
+ observer.observe(root, { subtree: true, childList: true, attributes: true });
287
+ const lists = PREFERENCES.map((query) => matchMedia(query));
288
+ for (const list of lists) list.addEventListener("change", recheckKnown);
289
+ // Breakpoints (`md:liquid`) flip the flag without touching the DOM: once the resize settles,
290
+ // look at the known candidates again (not the whole document).
291
+ const onResize = () => {
292
+ clearTimeout(resizeTimer);
293
+ resizeTimer = setTimeout(recheckKnown, RESIZE_MS);
294
+ };
295
+ addEventListener("resize", onResize);
296
+ queue(root);
297
+
298
+ return () => {
299
+ closed = true;
300
+ observer.disconnect();
301
+ sizes?.disconnect();
302
+ for (const list of lists) list.removeEventListener("change", recheckKnown);
303
+ removeEventListener("resize", onResize);
304
+ if (frame) cancelAnimationFrame(frame);
305
+ clearTimeout(retry);
306
+ clearTimeout(resizeTimer);
307
+ for (const element of [...lensed.keys()]) release(element);
308
+ dirty.clear();
309
+ self.clear();
310
+ known.clear();
311
+ underContainer.clear();
312
+ };
313
+ }
314
+
315
+ /**
316
+ * Turns the Liquid Glass lens on for the page. Every surface whose computed style resolves to a
317
+ * lensed liquid material (`--glass-lens: 1` with a backdrop filter: `liquid`, `liquid-clear` and
318
+ * their variants such as `md:liquid`, and the glass and chrome surfaces under
319
+ * `data-glass="liquid"`) gets the refraction engine, which is a lazy chunk fetched the first time
320
+ * one does (retried a few times with a backoff if it fails); the crystal and dispersion parts are
321
+ * further chunks, fetched only for surfaces that use them.
322
+ *
323
+ * Followed: added and removed elements; changes of `class`, `style` (the inline `--glass-lens`),
324
+ * `open`, and any `data-*` or `aria-*` attribute on an element or an ancestor (state variants such
325
+ * as `data-[state=open]:liquid` and `group-*` ones); the window size, once a resize settles
326
+ * (breakpoints); the size of the candidate and of its nearest size container (container queries);
327
+ * and the color scheme, transparency, contrast and motion preferences. Not followed: pseudo-classes
328
+ * (`hover:liquid`, `focus:liquid`) and sibling variants (`peer-*`); for those keep the surface
329
+ * liquid, or lens it with `applyGlassRefraction` from `@jcsoftdev/ui/glass`.
330
+ *
331
+ * An element is considered when its class names contain `liquid`, `glass` or a chrome surface
332
+ * (`surface-overlay`, `surface-nav`, `surface-side`), when its inline style sets `--glass-lens`,
333
+ * or when it carries `data-glass-lens="on"` (use that for a custom class built with `@apply`).
334
+ * `data-glass-lens="off"` on a surface or an ancestor, or `--glass-lens: 0`, keeps the plain
335
+ * liquid look. Where the engine cannot paint (see {@link supportsBackdropRefraction}) it does
336
+ * nothing and loads nothing.
337
+ *
338
+ * A lens applied by code (`applyGlassRefraction`, `useGlassRefraction`) keeps its own options and
339
+ * is never stopped by the watcher. Calls are counted: the page is watched until every returned
340
+ * stop has run. Without it, liquid surfaces keep the CSS look (rim, depth, blur) and no lens code
341
+ * is loaded at all.
342
+ */
343
+ export function startLiquidGlass(): () => void {
344
+ if (
345
+ typeof document === "undefined" ||
346
+ typeof MutationObserver !== "function" ||
347
+ typeof matchMedia !== "function" ||
348
+ !supportsBackdropRefraction()
349
+ )
350
+ return () => {};
351
+ users++;
352
+ stopAll ??= watch();
353
+ let stopped = false;
354
+ return () => {
355
+ if (stopped) return;
356
+ stopped = true;
357
+ if (--users === 0) {
358
+ stopAll?.();
359
+ stopAll = undefined;
360
+ }
361
+ };
362
+ }
363
+
364
+ /**
365
+ * {@link startLiquidGlass} as a component: render it once, near the root, in an app that uses Liquid
366
+ * Glass. It renders nothing; it is the only thing that pulls the lens code into a bundle.
367
+ */
368
+ export function LiquidGlass(): null {
369
+ useEffect(() => startLiquidGlass(), []);
370
+ return null;
371
+ }