@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,161 @@
1
+ import { createCrystalMap, crystalAmplitude, crystalMargin } from "./crystal-map.js";
2
+ const CRYSTAL_MAP_PIXELS = 48e3;
3
+ function clippingAncestors(element) {
4
+ const found = [];
5
+ for (let node = element.parentElement; node; node = node.parentElement) {
6
+ const style = getComputedStyle(node);
7
+ const clips = style.clipPath !== "none" || [style.overflowX, style.overflowY].some((value) => value !== "visible") || /paint|strict|content/.test(style.contain);
8
+ if (clips) found.push(node);
9
+ }
10
+ return found;
11
+ }
12
+ function backdropRoom(element, clips, margin, step = 12) {
13
+ const box = element.getBoundingClientRect();
14
+ const room = { left: margin, right: margin, top: margin, bottom: margin };
15
+ for (const clip of clips) {
16
+ const edge = clip.getBoundingClientRect();
17
+ room.left = Math.min(room.left, box.left - edge.left);
18
+ room.right = Math.min(room.right, edge.right - box.right);
19
+ room.top = Math.min(room.top, box.top - edge.top);
20
+ room.bottom = Math.min(room.bottom, edge.bottom - box.bottom);
21
+ }
22
+ for (const side of ["left", "right", "top", "bottom"])
23
+ room[side] = Math.min(margin, Math.max(0, Math.floor(room[side] / step) * step));
24
+ return room;
25
+ }
26
+ function installCrystal({
27
+ element,
28
+ id,
29
+ blur,
30
+ original,
31
+ filter,
32
+ image,
33
+ reinstall,
34
+ resize
35
+ }) {
36
+ const saved = {
37
+ position: element.style.position,
38
+ isolation: element.style.isolation,
39
+ overflow: element.style.overflow,
40
+ boxShadow: element.style.boxShadow,
41
+ backgroundImage: element.style.backgroundImage,
42
+ backgroundColor: element.style.backgroundColor,
43
+ backdropFilter: original
44
+ };
45
+ if (getComputedStyle(element).position === "static") element.style.position = "relative";
46
+ element.style.isolation = "isolate";
47
+ element.style.overflow = "visible";
48
+ element.style.backgroundImage = "none";
49
+ element.style.backgroundColor = "transparent";
50
+ element.style.setProperty("--glass-lens-tint", "transparent");
51
+ const border = element.matches(".liquid-clear") ? "--glass-clear-border" : "--glass-regular-border";
52
+ element.style.boxShadow = "none";
53
+ const make = (css) => {
54
+ const span = document.createElement("span");
55
+ span.setAttribute("aria-hidden", "true");
56
+ span.style.cssText = `position:absolute;z-index:-1;pointer-events:none;${css}`;
57
+ return span;
58
+ };
59
+ const layer = make("border-radius:0;");
60
+ layer.dataset.glassLensLayer = "";
61
+ layer.style.backdropFilter = `${blur}url(#${id})`;
62
+ layer.style.setProperty("-webkit-backdrop-filter", `${blur}url(#${id})`);
63
+ const skin = make(
64
+ `inset:0;border-radius:inherit;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));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)));`
65
+ );
66
+ skin.dataset.glassLensSkin = "";
67
+ element.prepend(skin);
68
+ element.prepend(layer);
69
+ const watch = typeof MutationObserver === "function" ? new MutationObserver(() => {
70
+ if (!layer.isConnected || !skin.isConnected) reinstall();
71
+ }) : void 0;
72
+ watch?.observe(element, { childList: true });
73
+ let roomWatch;
74
+ let roomRoot;
75
+ const trackRoom = (clips) => {
76
+ const root = clips[0];
77
+ if (root === roomRoot || typeof IntersectionObserver !== "function") return;
78
+ roomWatch?.disconnect();
79
+ roomRoot = root;
80
+ if (!root) return;
81
+ roomWatch = new IntersectionObserver(resize, {
82
+ root,
83
+ threshold: Array.from({ length: 51 }, (_, i) => i / 50)
84
+ });
85
+ roomWatch.observe(layer);
86
+ };
87
+ let key = "";
88
+ return {
89
+ update(width, height, radius, refraction, dispersion, dpr) {
90
+ const amplitude = crystalAmplitude(width, height, refraction);
91
+ const margin = crystalMargin(amplitude, dispersion * 0.6);
92
+ const round = Math.min(radius, width / 2, height / 2);
93
+ const clips = clippingAncestors(element);
94
+ const room = backdropRoom(element, clips, margin);
95
+ const reach = 1 + dispersion * 0.6;
96
+ const wide = width + room.left + room.right;
97
+ const tall = height + room.top + room.bottom;
98
+ trackRoom(clips);
99
+ const next = [
100
+ width,
101
+ height,
102
+ round,
103
+ amplitude,
104
+ margin,
105
+ dpr,
106
+ room.left,
107
+ room.right,
108
+ room.top,
109
+ room.bottom
110
+ ].join("x");
111
+ if (next === key) return void 0;
112
+ key = next;
113
+ const box = getComputedStyle(element);
114
+ const left = -(room.left + (Number.parseFloat(box.borderLeftWidth) || 0));
115
+ const top = -(room.top + (Number.parseFloat(box.borderTopWidth) || 0));
116
+ layer.style.left = `${left}px`;
117
+ layer.style.top = `${top}px`;
118
+ layer.style.width = `${wide}px`;
119
+ layer.style.height = `${tall}px`;
120
+ layer.style.clipPath = `inset(${room.top}px ${room.right}px ${room.bottom}px ${room.left}px round ${round}px)`;
121
+ for (const [target, name, value] of [
122
+ [filter, "x", "0"],
123
+ [filter, "y", "0"],
124
+ [filter, "width", String(wide)],
125
+ [filter, "height", String(tall)],
126
+ [image, "width", String(wide)],
127
+ [image, "height", String(tall)]
128
+ ])
129
+ target.setAttribute(name, value);
130
+ image.setAttribute(
131
+ "href",
132
+ createCrystalMap({
133
+ width,
134
+ height,
135
+ amplitude,
136
+ dpr: Math.max(0.5, Math.min(dpr, Math.sqrt(CRYSTAL_MAP_PIXELS / (wide * tall)))),
137
+ margin,
138
+ room,
139
+ reach
140
+ })
141
+ );
142
+ return 2 * Math.max(amplitude, 1) * 255 / 254;
143
+ },
144
+ undo() {
145
+ watch?.disconnect();
146
+ roomWatch?.disconnect();
147
+ layer.remove();
148
+ skin.remove();
149
+ for (const [name, value] of Object.entries(saved)) {
150
+ if (name === "backdropFilter") continue;
151
+ element.style.setProperty(
152
+ name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`),
153
+ value
154
+ );
155
+ }
156
+ }
157
+ };
158
+ }
159
+ export {
160
+ installCrystal
161
+ };
@@ -0,0 +1,11 @@
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
+ * Chromatic dispersion: the three colour channels are displaced by slightly different amounts
8
+ * (blue the least, red the most, so the rim fringes like real glass) and added back into `lens`.
9
+ * Its own lazy chunk: the engine imports it only for a surface that asks for dispersion.
10
+ */
11
+ export declare function addDispersion({ node, displace }: DispersionPasses, dispersion: number, crystal: boolean): void;
@@ -0,0 +1,19 @@
1
+ const KEEP = {
2
+ r: "1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0",
3
+ g: "0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 1 0",
4
+ b: "0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0"
5
+ };
6
+ const ADD = { operator: "arithmetic", k1: "0", k2: "1", k3: "1", k4: "0" };
7
+ function addDispersion({ node, displace }, dispersion, crystal) {
8
+ const spread = crystal ? dispersion * 0.6 : dispersion;
9
+ const factors = { r: 1 + spread, g: 1, b: 1 - spread };
10
+ for (const c of ["r", "g", "b"]) {
11
+ displace(c, factors[c]);
12
+ node("feColorMatrix", { in: `d${c}`, type: "matrix", values: KEEP[c], result: c });
13
+ }
14
+ node("feComposite", { in: "r", in2: "g", ...ADD, result: "rg" });
15
+ node("feComposite", { in: "rg", in2: "b", ...ADD, result: "lens" });
16
+ }
17
+ export {
18
+ addDispersion
19
+ };
@@ -0,0 +1,41 @@
1
+ type Engine = typeof import("./refraction.js");
2
+ /**
3
+ * Test seam: replaces how the engine chunk is fetched and the first retry delay (`undefined`
4
+ * restores both). Not part of the public entries.
5
+ */
6
+ export declare function setLiquidEngineLoader(loader?: () => Promise<Engine>, firstRetryMs?: number): void;
7
+ /**
8
+ * Turns the Liquid Glass lens on for the page. Every surface whose computed style resolves to a
9
+ * lensed liquid material (`--glass-lens: 1` with a backdrop filter: `liquid`, `liquid-clear` and
10
+ * their variants such as `md:liquid`, and the glass and chrome surfaces under
11
+ * `data-glass="liquid"`) gets the refraction engine, which is a lazy chunk fetched the first time
12
+ * one does (retried a few times with a backoff if it fails); the crystal and dispersion parts are
13
+ * further chunks, fetched only for surfaces that use them.
14
+ *
15
+ * Followed: added and removed elements; changes of `class`, `style` (the inline `--glass-lens`),
16
+ * `open`, and any `data-*` or `aria-*` attribute on an element or an ancestor (state variants such
17
+ * as `data-[state=open]:liquid` and `group-*` ones); the window size, once a resize settles
18
+ * (breakpoints); the size of the candidate and of its nearest size container (container queries);
19
+ * and the color scheme, transparency, contrast and motion preferences. Not followed: pseudo-classes
20
+ * (`hover:liquid`, `focus:liquid`) and sibling variants (`peer-*`); for those keep the surface
21
+ * liquid, or lens it with `applyGlassRefraction` from `@jcsoftdev/ui/glass`.
22
+ *
23
+ * An element is considered when its class names contain `liquid`, `glass` or a chrome surface
24
+ * (`surface-overlay`, `surface-nav`, `surface-side`), when its inline style sets `--glass-lens`,
25
+ * or when it carries `data-glass-lens="on"` (use that for a custom class built with `@apply`).
26
+ * `data-glass-lens="off"` on a surface or an ancestor, or `--glass-lens: 0`, keeps the plain
27
+ * liquid look. Where the engine cannot paint (see {@link supportsBackdropRefraction}) it does
28
+ * nothing and loads nothing.
29
+ *
30
+ * A lens applied by code (`applyGlassRefraction`, `useGlassRefraction`) keeps its own options and
31
+ * is never stopped by the watcher. Calls are counted: the page is watched until every returned
32
+ * stop has run. Without it, liquid surfaces keep the CSS look (rim, depth, blur) and no lens code
33
+ * is loaded at all.
34
+ */
35
+ export declare function startLiquidGlass(): () => void;
36
+ /**
37
+ * {@link startLiquidGlass} as a component: render it once, near the root, in an app that uses Liquid
38
+ * Glass. It renders nothing; it is the only thing that pulls the lens code into a bundle.
39
+ */
40
+ export declare function LiquidGlass(): null;
41
+ export {};
@@ -0,0 +1,256 @@
1
+ "use client";
2
+ import { useEffect } from "react";
3
+ import { supportsBackdropRefraction } from "./support.js";
4
+ const CANDIDATES = [
5
+ '[class*="liquid"]',
6
+ '[class*="glass"]',
7
+ '[class*="surface-overlay"]',
8
+ '[class*="surface-nav"]',
9
+ '[class*="surface-side"]',
10
+ '[style*="--glass-lens:"]',
11
+ '[data-glass-lens="on"]'
12
+ ].join(", ");
13
+ const PREFERENCES = [
14
+ "(prefers-reduced-transparency: reduce)",
15
+ "(prefers-contrast: more)",
16
+ "(forced-colors: active)",
17
+ "(prefers-reduced-motion: reduce)",
18
+ "(prefers-color-scheme: dark)"
19
+ ];
20
+ const ENGINE_ATTRIBUTES = /* @__PURE__ */ new Set(["data-glass-refraction", "data-glass-lens-layer"]);
21
+ const followed = (name) => name === "class" || name === "style" || name === "open" || name.startsWith("aria-") || name.startsWith("data-") && !ENGINE_ATTRIBUTES.has(name);
22
+ const SCANS_PER_FRAME = 64;
23
+ const MAX_PENDING = 512;
24
+ const RESIZE_MS = 150;
25
+ const MAX_ATTEMPTS = 6;
26
+ const RETRY_MAX_MS = 3e4;
27
+ const defaultLoader = () => import("./refraction.js");
28
+ let loadEngine = defaultLoader;
29
+ let retryMs = 500;
30
+ function setLiquidEngineLoader(loader, firstRetryMs = 500) {
31
+ loadEngine = loader ?? defaultLoader;
32
+ retryMs = firstRetryMs;
33
+ }
34
+ let users = 0;
35
+ let stopAll;
36
+ function watch() {
37
+ const root = document.documentElement;
38
+ const lensed = /* @__PURE__ */ new Map();
39
+ let engine;
40
+ let loading = false;
41
+ let failures = 0;
42
+ let retryAt = 0;
43
+ let retry;
44
+ const dirty = /* @__PURE__ */ new Set();
45
+ const self = /* @__PURE__ */ new Set();
46
+ const known = /* @__PURE__ */ new Set();
47
+ const containerOf = /* @__PURE__ */ new WeakMap();
48
+ const underContainer = /* @__PURE__ */ new Map();
49
+ const unprimed = /* @__PURE__ */ new WeakSet();
50
+ const inlineFlag = /* @__PURE__ */ new WeakMap();
51
+ let frame = 0;
52
+ let resizeTimer;
53
+ let closed = false;
54
+ const release = (element) => {
55
+ lensed.get(element)?.();
56
+ lensed.delete(element);
57
+ };
58
+ const wants = (element) => {
59
+ if (!element.isConnected || element.closest('[data-glass-lens="off"]')) return false;
60
+ const style = getComputedStyle(element);
61
+ const lensedHere = lensed.has(element) && element.dataset.glassRefraction === "on";
62
+ const backdrop = lensedHere && engine ? engine.ownBackdropFilter(element) : style.backdropFilter;
63
+ return style.getPropertyValue("--glass-lens").trim() === "1" && backdrop !== "none" && style.visibility !== "hidden";
64
+ };
65
+ const load = () => {
66
+ if (loading || failures >= MAX_ATTEMPTS || Date.now() < retryAt) return;
67
+ loading = true;
68
+ let fetched;
69
+ try {
70
+ fetched = loadEngine();
71
+ } catch (error) {
72
+ fetched = Promise.reject(error);
73
+ }
74
+ fetched.then(
75
+ (module) => {
76
+ engine = module;
77
+ failures = 0;
78
+ if (!closed) recheckKnown();
79
+ },
80
+ () => {
81
+ loading = false;
82
+ failures++;
83
+ if (closed || failures >= MAX_ATTEMPTS) return;
84
+ const delay = Math.min(RETRY_MAX_MS, retryMs * 2 ** (failures - 1));
85
+ retryAt = Date.now() + delay;
86
+ retry = setTimeout(recheckKnown, delay);
87
+ }
88
+ );
89
+ };
90
+ const observeSize = (target) => {
91
+ if (!sizes) return;
92
+ unprimed.add(target);
93
+ sizes.observe(target);
94
+ };
95
+ const findContainer = (element) => {
96
+ for (let node = element.parentElement; node && node !== root; node = node.parentElement)
97
+ if (getComputedStyle(node).containerType !== "normal") return node;
98
+ return null;
99
+ };
100
+ const remember = (element) => {
101
+ if (known.has(element)) return;
102
+ known.add(element);
103
+ observeSize(element);
104
+ const container = findContainer(element);
105
+ containerOf.set(element, container);
106
+ if (!container) return;
107
+ let members = underContainer.get(container);
108
+ if (!members) {
109
+ members = /* @__PURE__ */ new Set();
110
+ underContainer.set(container, members);
111
+ observeSize(container);
112
+ }
113
+ members.add(element);
114
+ };
115
+ const forget = (element) => {
116
+ if (!known.delete(element)) return;
117
+ sizes?.unobserve(element);
118
+ release(element);
119
+ self.delete(element);
120
+ const container = containerOf.get(element);
121
+ const members = container && underContainer.get(container);
122
+ if (!members) return;
123
+ members.delete(element);
124
+ if (members.size === 0 && container) {
125
+ underContainer.delete(container);
126
+ sizes?.unobserve(container);
127
+ }
128
+ };
129
+ const check = (element) => {
130
+ inlineFlag.set(element, element.style.getPropertyValue("--glass-lens"));
131
+ remember(element);
132
+ if (!wants(element)) release(element);
133
+ else if (lensed.has(element)) return;
134
+ else if (engine)
135
+ lensed.set(element, engine.claimLens(element, "auto", { auto: true, ownInteractive: true }));
136
+ else load();
137
+ };
138
+ const scan = (node) => {
139
+ if (node.matches(CANDIDATES) || known.has(node)) check(node);
140
+ for (const element of node.querySelectorAll(CANDIDATES)) check(element);
141
+ };
142
+ const prune = (node) => {
143
+ if (node.isConnected) return;
144
+ dirty.delete(node);
145
+ if (node instanceof HTMLElement && known.has(node)) forget(node);
146
+ for (const element of node.querySelectorAll(CANDIDATES)) forget(element);
147
+ };
148
+ const flush = () => {
149
+ frame = 0;
150
+ let budget = SCANS_PER_FRAME;
151
+ for (const node of dirty) {
152
+ if (budget-- <= 0) break;
153
+ dirty.delete(node);
154
+ if (node.isConnected) scan(node);
155
+ }
156
+ const singles = [...self];
157
+ self.clear();
158
+ for (const element of singles) if (element.isConnected) check(element);
159
+ if (dirty.size) later();
160
+ };
161
+ function later() {
162
+ if (!frame && !closed) frame = requestAnimationFrame(flush);
163
+ }
164
+ function queue(node) {
165
+ if (!dirty.has(root)) {
166
+ if (dirty.size >= MAX_PENDING) {
167
+ dirty.clear();
168
+ dirty.add(root);
169
+ } else dirty.add(node);
170
+ }
171
+ later();
172
+ }
173
+ function recheckKnown() {
174
+ for (const element of known) self.add(element);
175
+ later();
176
+ }
177
+ const sizes = typeof ResizeObserver === "function" ? new ResizeObserver((entries) => {
178
+ for (const { target } of entries) {
179
+ if (unprimed.has(target)) {
180
+ unprimed.delete(target);
181
+ continue;
182
+ }
183
+ const members = underContainer.get(target);
184
+ if (members) for (const element of members) self.add(element);
185
+ if (known.has(target)) self.add(target);
186
+ }
187
+ later();
188
+ }) : void 0;
189
+ const observer = new MutationObserver((records) => {
190
+ for (const record of records) {
191
+ if (record.type === "attributes") {
192
+ const name = record.attributeName ?? "";
193
+ if (!followed(name)) continue;
194
+ const target = record.target;
195
+ if (name === "style") {
196
+ const flag = target.style?.getPropertyValue("--glass-lens") ?? "";
197
+ if (inlineFlag.has(target) && inlineFlag.get(target) === flag) continue;
198
+ inlineFlag.set(target, flag);
199
+ }
200
+ queue(target);
201
+ } else {
202
+ for (const node of record.removedNodes) if (node instanceof Element) prune(node);
203
+ for (const node of record.addedNodes) if (node instanceof Element) queue(node);
204
+ }
205
+ }
206
+ });
207
+ observer.observe(root, { subtree: true, childList: true, attributes: true });
208
+ const lists = PREFERENCES.map((query) => matchMedia(query));
209
+ for (const list of lists) list.addEventListener("change", recheckKnown);
210
+ const onResize = () => {
211
+ clearTimeout(resizeTimer);
212
+ resizeTimer = setTimeout(recheckKnown, RESIZE_MS);
213
+ };
214
+ addEventListener("resize", onResize);
215
+ queue(root);
216
+ return () => {
217
+ closed = true;
218
+ observer.disconnect();
219
+ sizes?.disconnect();
220
+ for (const list of lists) list.removeEventListener("change", recheckKnown);
221
+ removeEventListener("resize", onResize);
222
+ if (frame) cancelAnimationFrame(frame);
223
+ clearTimeout(retry);
224
+ clearTimeout(resizeTimer);
225
+ for (const element of [...lensed.keys()]) release(element);
226
+ dirty.clear();
227
+ self.clear();
228
+ known.clear();
229
+ underContainer.clear();
230
+ };
231
+ }
232
+ function startLiquidGlass() {
233
+ if (typeof document === "undefined" || typeof MutationObserver !== "function" || typeof matchMedia !== "function" || !supportsBackdropRefraction())
234
+ return () => {
235
+ };
236
+ users++;
237
+ stopAll ??= watch();
238
+ let stopped = false;
239
+ return () => {
240
+ if (stopped) return;
241
+ stopped = true;
242
+ if (--users === 0) {
243
+ stopAll?.();
244
+ stopAll = void 0;
245
+ }
246
+ };
247
+ }
248
+ function LiquidGlass() {
249
+ useEffect(() => startLiquidGlass(), []);
250
+ return null;
251
+ }
252
+ export {
253
+ LiquidGlass,
254
+ setLiquidEngineLoader,
255
+ startLiquidGlass
256
+ };
@@ -0,0 +1,53 @@
1
+ import { type SpringConfig } from "./spring.js";
2
+ /** How much deeper the lens bends at full press. */
3
+ export declare const PRESS_LIFT = 0.35;
4
+ /** The surface grows by about this many px (over its width) at full press. */
5
+ export declare const SWELL_PX = 16;
6
+ /** How far a pressed (not dragged) control follows the pointer, and how far a drag stretches. */
7
+ export declare const FOLLOW_LIMIT = 4;
8
+ export declare const DRAG_LIMIT = 48;
9
+ export interface LiquidMotionHooks {
10
+ /** The multiplier of the lens strength this frame: the materialise ramp times the press lift. */
11
+ onLevel(level: number): void;
12
+ }
13
+ export interface LiquidMotionOptions {
14
+ /** Ramp the lens strength from 0 to its target (the first install of a surface). */
15
+ materialize: boolean;
16
+ /** `false`: no listeners, no springs; the lens is at full strength at once. */
17
+ interactive?: boolean;
18
+ /**
19
+ * Read the pointer mode only from the element itself (its inline `--liquid-interactive` or its
20
+ * `data-glass-interactive` value), never from a scope or theme above it. For overlays (dialog,
21
+ * popover, sidebar, drawer): a page-level `--liquid-interactive: drag` must not make them
22
+ * draggable.
23
+ */
24
+ ownInteractive?: boolean;
25
+ }
26
+ export interface LiquidMotion {
27
+ dispose(): void;
28
+ }
29
+ /**
30
+ * `--liquid-motion` / `--liquid-interactive` of an element, with the defaults of an unconfigured
31
+ * one. `own`: the pointer mode comes only from the element's inline style or
32
+ * `data-glass-interactive`, not from what it inherits.
33
+ */
34
+ export declare function readMotion(element: HTMLElement, own?: boolean): {
35
+ spring: SpringConfig | undefined;
36
+ mode: "none" | "press" | "drag";
37
+ };
38
+ /**
39
+ * Motion of a lensed surface, driven by one rAF loop of springs that sleeps once everything is at
40
+ * rest. Always: the lens materialises (its strength springs from 0 to its target). With a pointer
41
+ * mode (`--liquid-interactive`, by default `press` on buttons and links): a press deepens the lens
42
+ * and swells the surface, lights a touch glow that follows the pointer and turns the rim light
43
+ * towards it; `drag` also pulls the surface along (rubber band) with the speed squashing it, and
44
+ * releases it into a jelly settle. `--liquid-motion: off` turns all of it off. Does nothing under
45
+ * `prefers-reduced-motion`.
46
+ *
47
+ * The motion is written to the individual `translate` and `scale` properties, composed with the
48
+ * author's own values (read when a burst of motion starts), so an author `transform` is never
49
+ * touched; at rest the author's inline `translate` and `scale` are put back. A drag starts only
50
+ * on the surface itself (not on a button, link or field inside it), captures the pointer only
51
+ * once it has travelled past the slop, and swallows only the click that ends that gesture.
52
+ */
53
+ export declare function startLiquidMotion(element: HTMLElement, hooks: LiquidMotionHooks, { materialize, interactive, ownInteractive }: LiquidMotionOptions): LiquidMotion | undefined;