@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,280 @@
1
+ "use client";
2
+
3
+ import {
4
+ type ComponentProps,
5
+ type KeyboardEvent,
6
+ useEffect,
7
+ useId,
8
+ useMemo,
9
+ useRef,
10
+ useState,
11
+ } from "react";
12
+ import { useUiStrings } from "../../i18n/index.js";
13
+ import { ChevronDown } from "../../icons/index.js";
14
+ import * as PopoverPrimitive from "../../primitives/popover/popover.js";
15
+ import type { ClassNames } from "../../utils/class-names.js";
16
+ import { cn } from "../../utils/cn.js";
17
+ import { useComposedRefs } from "../../utils/compose.js";
18
+ import { type Material, materialClass } from "../../utils/material.js";
19
+ import { useControllableState } from "../../utils/use-controllable-state.js";
20
+ import {
21
+ flattenItems,
22
+ isTypeaheadKey,
23
+ type ListboxGroup,
24
+ type ListboxMove,
25
+ type ListboxOption,
26
+ moveActive,
27
+ nextTypeahead,
28
+ typeaheadIndex,
29
+ } from "../internal/listbox.js";
30
+ import { LISTBOX_SURFACE, ListboxItems, optionDomId } from "../internal/listbox-items.js";
31
+
32
+ export type SelectMenuOption = Omit<ListboxOption, "keywords">;
33
+ export type SelectMenuGroup = ListboxGroup<SelectMenuOption>;
34
+
35
+ export type SelectMenuPart = "trigger" | "value" | "icon" | "content" | "option" | "group";
36
+
37
+ export interface SelectMenuProps
38
+ extends Omit<
39
+ ComponentProps<"button">,
40
+ "value" | "defaultValue" | "onChange" | "children" | "type" | "role" | "size"
41
+ > {
42
+ /** Options, optionally nested in labelled groups. A `value` of `""` is a real option, not "nothing". */
43
+ options: readonly (SelectMenuOption | SelectMenuGroup)[];
44
+ /** Selected value (controlled). An unknown value or `undefined` shows the placeholder. */
45
+ value?: string;
46
+ defaultValue?: string;
47
+ onValueChange?: (value: string) => void;
48
+ /** Shown while no option is selected. Defaults to the localized "Select…". */
49
+ placeholder?: string;
50
+ /** Submits the value with a surrounding `<form>` through a hidden input. */
51
+ name?: string;
52
+ required?: boolean;
53
+ invalid?: boolean;
54
+ size?: "sm" | "md";
55
+ /** Portal target for the popup. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
56
+ container?: HTMLElement | null;
57
+ /** Popup surface material; see `PopoverContent`. */
58
+ material?: Material;
59
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the trigger and is merged last. */
60
+ classNames?: ClassNames<SelectMenuPart>;
61
+ }
62
+
63
+ const TYPEAHEAD_MS = 600;
64
+ const OPEN_KEYS = new Set(["ArrowDown", "ArrowUp", "Enter", " "]);
65
+
66
+ /**
67
+ * Select with a custom listbox popup, for option lists that need descriptions, groups or a
68
+ * styled popup. Select-only combobox pattern (WAI-ARIA APG): focus stays on the trigger and the
69
+ * highlighted option is announced through `aria-activedescendant`. Use `NativeSelect` when the
70
+ * system picker is preferable (long lists on phones).
71
+ */
72
+ export function SelectMenu({
73
+ options,
74
+ value: valueProp,
75
+ defaultValue,
76
+ onValueChange,
77
+ placeholder,
78
+ name,
79
+ required,
80
+ invalid,
81
+ size = "md",
82
+ container,
83
+ material,
84
+ disabled,
85
+ className,
86
+ classNames,
87
+ onKeyDown,
88
+ onKeyUp,
89
+ onClick,
90
+ ref,
91
+ id,
92
+ "aria-label": ariaLabel,
93
+ "aria-labelledby": ariaLabelledBy,
94
+ "aria-invalid": ariaInvalid,
95
+ ...props
96
+ }: SelectMenuProps) {
97
+ const strings = useUiStrings();
98
+ const listId = useId();
99
+ const triggerRef = useRef<HTMLButtonElement | null>(null);
100
+ const composedRef = useComposedRefs<HTMLButtonElement>(ref, triggerRef);
101
+ const typeahead = useRef({ buffer: "", at: 0 });
102
+ const [value, setValue] = useControllableState<string | undefined>({
103
+ prop: valueProp,
104
+ defaultProp: defaultValue,
105
+ onChange: (next) => {
106
+ if (next !== undefined) onValueChange?.(next);
107
+ },
108
+ });
109
+ const [open, setOpenState] = useState(false);
110
+ const [active, setActive] = useState(-1);
111
+ const [listLabel, setListLabel] = useState<string | undefined>();
112
+
113
+ const flat = useMemo(() => flattenItems(options), [options]);
114
+ const selectedIndex = flat.findIndex((option) => option.value === value);
115
+ const selected = flat[selectedIndex];
116
+ const isDisabled = Boolean(disabled);
117
+
118
+ const setOpen = (next: boolean, move?: ListboxMove) => {
119
+ if (next && isDisabled) return;
120
+ if (next) {
121
+ const preferred = selected && !selected.disabled ? selectedIndex : -1;
122
+ setActive(
123
+ move
124
+ ? moveActive(flat, move === "last" ? flat.length : -1, move)
125
+ : preferred >= 0
126
+ ? preferred
127
+ : moveActive(flat, -1, "first"),
128
+ );
129
+ setListLabel(triggerRef.current?.labels?.[0]?.textContent?.trim() || undefined);
130
+ }
131
+ setOpenState(next);
132
+ };
133
+
134
+ useEffect(() => {
135
+ if (!open || active < 0) return;
136
+ document.getElementById(optionDomId(listId, active))?.scrollIntoView?.({ block: "nearest" });
137
+ }, [open, active, listId]);
138
+
139
+ const pick = (index: number) => {
140
+ const option = flat[index];
141
+ if (!option || option.disabled) return;
142
+ setValue(option.value);
143
+ setOpenState(false);
144
+ };
145
+
146
+ const handleKeyDown = (event: KeyboardEvent<HTMLButtonElement>) => {
147
+ onKeyDown?.(event);
148
+ if (event.defaultPrevented || event.altKey || event.ctrlKey || event.metaKey) return;
149
+ const { key } = event;
150
+ const buffering =
151
+ typeahead.current.buffer !== "" && Date.now() - typeahead.current.at <= TYPEAHEAD_MS;
152
+ const typing = isTypeaheadKey(event) && !(key === " " && !buffering);
153
+
154
+ if (typing) {
155
+ event.preventDefault();
156
+ typeahead.current = nextTypeahead(typeahead.current, key, Date.now());
157
+ const found = typeaheadIndex(flat, typeahead.current.buffer, open ? active : selectedIndex);
158
+ if (found < 0) return;
159
+ if (open) setActive(found);
160
+ else pick(found);
161
+ return;
162
+ }
163
+
164
+ if (!open) {
165
+ if (OPEN_KEYS.has(key)) {
166
+ event.preventDefault();
167
+ setOpen(true);
168
+ } else if (key === "Home" || key === "End") {
169
+ event.preventDefault();
170
+ setOpen(true, key === "Home" ? "first" : "last");
171
+ }
172
+ return;
173
+ }
174
+
175
+ const moves: Record<string, ListboxMove> = {
176
+ ArrowDown: "next",
177
+ ArrowUp: "prev",
178
+ Home: "first",
179
+ End: "last",
180
+ };
181
+ const move = moves[key];
182
+ if (move) {
183
+ event.preventDefault();
184
+ setActive((current) => moveActive(flat, current, move));
185
+ } else if (key === "Enter" || key === " ") {
186
+ event.preventDefault();
187
+ pick(active);
188
+ } else if (key === "Tab") {
189
+ setOpenState(false);
190
+ }
191
+ };
192
+
193
+ const showPlaceholder = !selected;
194
+
195
+ return (
196
+ <PopoverPrimitive.Root open={open} onOpenChange={(next) => setOpen(next)}>
197
+ <PopoverPrimitive.Trigger
198
+ ref={composedRef}
199
+ id={id}
200
+ role="combobox"
201
+ data-ui-layer=""
202
+ aria-haspopup="listbox"
203
+ aria-expanded={open}
204
+ aria-controls={open ? listId : undefined}
205
+ aria-activedescendant={open && active >= 0 ? optionDomId(listId, active) : undefined}
206
+ aria-required={required || undefined}
207
+ aria-invalid={ariaInvalid ?? (invalid || undefined)}
208
+ aria-label={ariaLabel}
209
+ aria-labelledby={ariaLabelledBy}
210
+ disabled={disabled}
211
+ data-placeholder={showPlaceholder ? "" : undefined}
212
+ {...props}
213
+ onClick={(event) => {
214
+ onClick?.(event);
215
+ // Safari does not focus a button on press; the keyboard needs focus on it.
216
+ event.currentTarget.focus({ preventScroll: true });
217
+ }}
218
+ onKeyDown={handleKeyDown}
219
+ onKeyUp={(event) => {
220
+ onKeyUp?.(event);
221
+ // Space activates a button on keyup; the keydown already handled it.
222
+ if (event.key === " ") event.preventDefault();
223
+ }}
224
+ className={cn(
225
+ "flex w-full min-w-0 items-center justify-between gap-2 rounded-input border-control bg-surface-control py-0 pr-2.5 pl-3 text-left text-control text-ink focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
226
+ size === "sm" ? "h-control-sm" : "h-input min-h-(--touch-target)",
227
+ classNames?.trigger,
228
+ className,
229
+ )}
230
+ >
231
+ <span
232
+ className={cn(
233
+ "min-w-0 flex-1 truncate",
234
+ showPlaceholder && "text-ink-3",
235
+ classNames?.value,
236
+ )}
237
+ >
238
+ {selected?.label ?? placeholder ?? strings.selectPlaceholder}
239
+ </span>
240
+ <ChevronDown
241
+ aria-hidden="true"
242
+ className={cn("size-3.5 shrink-0 text-ink-3", classNames?.icon)}
243
+ />
244
+ </PopoverPrimitive.Trigger>
245
+ {name ? <input type="hidden" name={name} value={value ?? ""} disabled={disabled} /> : null}
246
+ <PopoverPrimitive.Portal container={container}>
247
+ <PopoverPrimitive.Content
248
+ id={listId}
249
+ role="listbox"
250
+ data-ui-layer=""
251
+ aria-label={ariaLabelledBy ? undefined : (ariaLabel ?? listLabel ?? placeholder)}
252
+ aria-labelledby={ariaLabelledBy}
253
+ sideOffset={4}
254
+ collisionPadding={8}
255
+ align="start"
256
+ // Focus stays on the trigger, going in and out.
257
+ onOpenAutoFocus={(event) => event.preventDefault()}
258
+ onCloseAutoFocus={(event) => event.preventDefault()}
259
+ className={cn(
260
+ LISTBOX_SURFACE,
261
+ materialClass(material, "surface-solid"),
262
+ classNames?.content,
263
+ )}
264
+ >
265
+ <ListboxItems
266
+ items={options}
267
+ flat={flat}
268
+ idBase={listId}
269
+ isSelected={(option) => option.value === value}
270
+ activeIndex={active}
271
+ onActivate={setActive}
272
+ onPick={(option) => pick(flat.indexOf(option))}
273
+ optionClassName={classNames?.option}
274
+ groupClassName={classNames?.group}
275
+ />
276
+ </PopoverPrimitive.Content>
277
+ </PopoverPrimitive.Portal>
278
+ </PopoverPrimitive.Root>
279
+ );
280
+ }
@@ -0,0 +1,150 @@
1
+ import { cachedMap, clamp, type DisplacementField } from "./displacement-map.js";
2
+
3
+ /**
4
+ * The crystal lens: a thick, clear, convex lens that minifies the backdrop. Every output pixel at
5
+ * `p` (measured from the centre of the surface) shows the backdrop at `p + (g(t) - 1) p` with `g(t)
6
+ * = 1 + (gMax - 1) s(t)`, `s(t) = 0.3 + 0.3 t^2 + 0.4 t^6` and `t` the superellipse radial coordinate (1 at
7
+ * the silhouette). The pull is mild in the middle and grows steeply towards the rim, like the
8
+ * side of a ball lens. A radial map `p -> p g(|p|)` with `g >= 1` and `g' >= 0` has the Jacobian
9
+ * determinant `g (g + t g')`, which is at least 1, so it cannot fold back on itself however large
10
+ * `gMax` is: this is what lets the crystal minify by a factor of three at the rim where the other
11
+ * profiles must stay under a slope of one.
12
+ *
13
+ * The samples lie outside the surface (a minifying lens sees a wider area than it covers), so the
14
+ * map is rasterised over the surface plus a margin on every side; the engine lays the filter on a
15
+ * layer that large and clips it back to the silhouette.
16
+ */
17
+ export const CRYSTAL_EXPONENT = 2.5;
18
+ /** Weights of the constant (even minification), quadratic (whole-surface) and sixth-power (rim) parts of the crystal lens. */
19
+ export const CRYSTAL_WEIGHTS = { flat: 0.3, whole: 0.3, rim: 0.4 } as const;
20
+ /** `gMax - 1` per unit of `refraction`: how much more the rim minifies than the middle. */
21
+ export const CRYSTAL_GAIN = 1.3;
22
+ /** Largest source offset of the crystal lens, in px (bounds the margin and the filter area). */
23
+ export const CRYSTAL_MAX_OFFSET = 260;
24
+
25
+ /** `s(t)` of the crystal lens. */
26
+ export const crystalShape = (t: number) =>
27
+ CRYSTAL_WEIGHTS.flat + CRYSTAL_WEIGHTS.whole * t ** 2 + CRYSTAL_WEIGHTS.rim * t ** 6;
28
+
29
+ /** Radial coordinate of a point of a surface: 1 on the superellipse touching the middle of each side, held there beyond it. */
30
+ export function crystalRadius(px: number, py: number, hx: number, hy: number): number {
31
+ const u = Math.abs(px) / hx;
32
+ const v = Math.abs(py) / hy;
33
+ return Math.min((u ** CRYSTAL_EXPONENT + v ** CRYSTAL_EXPONENT) ** (1 / CRYSTAL_EXPONENT), 1);
34
+ }
35
+
36
+ /**
37
+ * Largest source offset of the crystal lens, in px, for a surface and a `refraction` of 0 to 2
38
+ * (1.67 is a thick lens, 2 the thickest the margin allows).
39
+ */
40
+ export function crystalAmplitude(width: number, height: number, refraction: number): number {
41
+ const half = Math.max(width, height) / 2;
42
+ return Math.min(clamp(refraction, 0, 2) * CRYSTAL_GAIN * half, CRYSTAL_MAX_OFFSET);
43
+ }
44
+
45
+ /** Distance, in px, the crystal lens keeps from the edge of its backdrop (see {@link computeCrystalField}). */
46
+ const EDGE_SLACK = 3;
47
+
48
+ export interface CrystalMapOptions {
49
+ width: number;
50
+ height: number;
51
+ /** Source offset at the silhouette, in px, from {@link crystalAmplitude}; sets the margin. */
52
+ amplitude: number;
53
+ /**
54
+ * Map pixels per CSS pixel. Default 1, between 0.5 and 2: the field is smooth and most of it lies
55
+ * in the margin the layer clips away, so a large lens can go below one.
56
+ */
57
+ dpr?: number;
58
+ /** Margin past the surface, in px. Default {@link crystalMargin} of `amplitude`. */
59
+ margin?: number;
60
+ /**
61
+ * Margin past each side of the surface, in px (default: `margin` on all four). A surface inside
62
+ * a clipping ancestor (an `overflow` or `clip-path` stage) only has the backdrop within it: a
63
+ * layer that reaches past the clip is cut by the browser and its filter is shifted, so the map
64
+ * covers only the backdrop that exists, and the offsets are clamped so no sample lands beyond it.
65
+ */
66
+ room?: Partial<Record<"left" | "right" | "top" | "bottom", number>>;
67
+ /** Largest factor the offset is multiplied by (chromatic dispersion pulls red this much further). Default 1. */
68
+ reach?: number;
69
+ }
70
+
71
+ /**
72
+ * Margin, in px, the crystal layer extends past the surface on every side: the largest offset,
73
+ * plus what chromatic dispersion adds to it.
74
+ */
75
+ export const crystalMargin = (amplitude: number, dispersion = 0) =>
76
+ Math.ceil(amplitude * (1 + Math.max(dispersion, 0))) + 2;
77
+
78
+ /**
79
+ * Displacement field of the crystal lens over the surface and its margin: red and green carry
80
+ * `s(t) p / half` (so `scale = 2 amplitude 255/254` restores the offset), blue is 255 (no soft
81
+ * band: a crystal is not frosted). The size of `data` is the surface plus twice the margin.
82
+ */
83
+ export function computeCrystalField({
84
+ width,
85
+ height,
86
+ amplitude,
87
+ dpr = 1,
88
+ margin,
89
+ room,
90
+ reach = 1,
91
+ }: CrystalMapOptions): DisplacementField {
92
+ const ratio = clamp(dpr, 0.5, 2);
93
+ const w = Math.max(1, width);
94
+ const h = Math.max(1, height);
95
+ const m = margin ?? crystalMargin(amplitude);
96
+ const free = (side: "left" | "right" | "top" | "bottom") => Math.max(room?.[side] ?? m, 0);
97
+ const [left, right, top, bottom] = [free("left"), free("right"), free("top"), free("bottom")];
98
+ const pw = Math.max(1, Math.round((w + left + right) * ratio));
99
+ const ph = Math.max(1, Math.round((h + top + bottom) * ratio));
100
+ const rx = pw / (w + left + right);
101
+ const ry = ph / (h + top + bottom);
102
+ const data = new Uint8ClampedArray(pw * ph * 4);
103
+ const hx = w / 2;
104
+ const hy = h / 2;
105
+ const half = Math.max(hx, hy);
106
+ // A few px short of the edge: the pre-blur fades the last columns of the backdrop to transparent,
107
+ // and a channel pulled further than the others (dispersion) would read that and drop out.
108
+ // Without `room` the map keeps the plain lens: its margin is the whole reach, nothing to clamp.
109
+ const slack = room ? EDGE_SLACK : 0;
110
+ const bounded = room !== undefined;
111
+ const [minX, maxX] = [-hx - left + slack, hx + right - slack];
112
+ const [minY, maxY] = [-hy - top + slack, hy + bottom - slack];
113
+ const unit = Math.max(amplitude, 1e-6);
114
+ const f = Math.max(reach, 1);
115
+ // Offset (as a fraction of `amplitude`, what the channel encodes) that keeps the source in the room.
116
+ const within = (p: number, offset: number, lo: number, hi: number) =>
117
+ clamp((bounded ? clamp(offset, (lo - p) / f, (hi - p) / f) : offset) / unit, -1, 1);
118
+ for (let j = 0; j < ph; j++) {
119
+ const py = (j + 0.5) / ry - top - hy;
120
+ for (let i = 0; i < pw; i++) {
121
+ const px = (i + 0.5) / rx - left - hx;
122
+ const s = crystalShape(crystalRadius(px, py, hx, hy));
123
+ const o = (j * pw + i) * 4;
124
+ data[o] = 128 + within(px, (s * px * amplitude) / half, minX, maxX) * 127;
125
+ data[o + 1] = 128 + within(py, (s * py * amplitude) / half, minY, maxY) * 127;
126
+ data[o + 2] = 255;
127
+ data[o + 3] = 255;
128
+ }
129
+ }
130
+ return { width: pw, height: ph, data };
131
+ }
132
+
133
+ /** Crystal map as a PNG `data:` URI for `feImage` (browser only, cached). */
134
+ export function createCrystalMap(options: CrystalMapOptions): string {
135
+ const key = [
136
+ options.width,
137
+ options.height,
138
+ Math.round(options.amplitude),
139
+ options.dpr ?? 1,
140
+ options.margin ?? 0,
141
+ options.reach ?? 1,
142
+ options.room?.left ?? -1,
143
+ options.room?.right ?? -1,
144
+ options.room?.top ?? -1,
145
+ options.room?.bottom ?? -1,
146
+ ]
147
+ .map((n) => Math.round(n * 100) / 100)
148
+ .join("x");
149
+ return cachedMap(`c${key}`, () => computeCrystalField(options));
150
+ }