@jcsoftdev/ui 0.2.2 → 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 +292 -5
  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 +33 -6
  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 +44 -10
  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
@@ -2,6 +2,7 @@
2
2
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
3
3
  import { useEffect, useRef } from "react";
4
4
  import { cn } from "../../utils/cn.js";
5
+ import { materialClass } from "../../utils/material.js";
5
6
  import { useAppShell, useCompactContainer } from "../app-shell/app-shell.js";
6
7
  const defaultRenderLink = ({ children, ...props }) => /* @__PURE__ */ jsx("a", { ...props, children });
7
8
  function Sidebar({
@@ -12,7 +13,10 @@ function Sidebar({
12
13
  renderLink = defaultRenderLink,
13
14
  open = false,
14
15
  onClose,
16
+ collapsed = false,
17
+ material,
15
18
  className,
19
+ style,
16
20
  classNames
17
21
  }) {
18
22
  const shell = useAppShell();
@@ -21,6 +25,7 @@ function Sidebar({
21
25
  const isMobile = shell ? shell.compact : parentCompact;
22
26
  const closedOnMobile = isMobile && !open;
23
27
  const openOnMobile = isMobile && open;
28
+ const rail = collapsed && !isMobile;
24
29
  useEffect(() => {
25
30
  if (!openOnMobile) return;
26
31
  asideRef.current?.querySelector("a[href]")?.focus();
@@ -42,7 +47,8 @@ function Sidebar({
42
47
  "aria-label": ariaLabel,
43
48
  inert: closedOnMobile || void 0,
44
49
  className: cn(
45
- "fixed inset-y-0 left-0 z-45 flex h-screen w-side-width flex-col gap-4.5 overflow-y-auto border-r-divider bg-surface px-3 pt-3.5 pb-3 transition-transform duration-200",
50
+ "fixed inset-y-0 left-0 z-45 flex h-screen flex-col gap-4.5 overflow-y-auto border-r-divider surface-side pt-3.5 pb-3 transition-transform duration-200",
51
+ rail ? "w-[4.5rem] px-2" : "w-side-width px-3",
46
52
  // Inside AppShell the container query decides before any script runs (no flash on a
47
53
  // narrow first paint); the measured state only drives inert, the scrim and focus.
48
54
  shell ? cn(
@@ -53,9 +59,11 @@ function Sidebar({
53
59
  closedOnMobile ? "-translate-x-full" : "translate-x-0"
54
60
  ),
55
61
  openOnMobile && "shadow-overlay",
62
+ materialClass(material, "surface-solid [--surface-solid:var(--surface)]"),
56
63
  classNames?.root,
57
64
  className
58
65
  ),
66
+ style,
59
67
  children: [
60
68
  header,
61
69
  groups.map((group) => /* @__PURE__ */ jsxs(
@@ -64,21 +72,55 @@ function Sidebar({
64
72
  "aria-label": group.label,
65
73
  className: cn("flex flex-col gap-px", classNames?.group),
66
74
  children: [
67
- /* @__PURE__ */ jsx("div", { className: cn("px-2.5 pb-1.5 text-overline text-ink-3", classNames?.groupLabel), children: group.label }),
75
+ /* @__PURE__ */ jsx(
76
+ "div",
77
+ {
78
+ className: cn(
79
+ "px-2.5 pb-1.5 text-overline text-ink-3",
80
+ rail && "sr-only",
81
+ classNames?.groupLabel
82
+ ),
83
+ children: group.label
84
+ }
85
+ ),
68
86
  group.items.map((item) => {
69
87
  const badgeTone = item.badgeTone === "danger" ? "bg-danger-soft text-danger" : "bg-surface-2 text-ink-2";
70
88
  return /* @__PURE__ */ jsx("div", { className: classNames?.item, children: renderLink({
71
89
  href: item.href,
72
90
  "aria-current": item.active ? "page" : void 0,
91
+ title: rail ? item.label : void 0,
73
92
  className: cn(
74
93
  "flex items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
94
+ rail && "relative justify-center in-data-[density=touch]:min-h-11",
75
95
  item.active && "bg-accent-soft font-bold text-accent-ink",
76
96
  classNames?.link
77
97
  ),
78
98
  children: /* @__PURE__ */ jsxs(Fragment, { children: [
79
99
  item.icon,
80
- /* @__PURE__ */ jsx("span", { className: cn("min-w-0 truncate", classNames?.label), children: item.label }),
81
- item.badge !== void 0 ? /* @__PURE__ */ jsxs(
100
+ /* @__PURE__ */ jsx(
101
+ "span",
102
+ {
103
+ className: cn("min-w-0 truncate", rail && "sr-only", classNames?.label),
104
+ children: item.label
105
+ }
106
+ ),
107
+ item.badge !== void 0 && rail ? /* @__PURE__ */ jsxs(Fragment, { children: [
108
+ /* @__PURE__ */ jsx(
109
+ "span",
110
+ {
111
+ "aria-hidden": "true",
112
+ className: cn(
113
+ "absolute top-1 right-1 size-2 rounded-full ring-2 ring-surface",
114
+ item.badgeTone === "danger" ? "bg-danger" : "bg-accent",
115
+ classNames?.badge
116
+ )
117
+ }
118
+ ),
119
+ /* @__PURE__ */ jsxs("span", { className: "sr-only", children: [
120
+ item.badge,
121
+ item.badgeLabel ? ` ${item.badgeLabel}` : null
122
+ ] })
123
+ ] }) : item.badge !== void 0 ? /* @__PURE__ */ jsxs(
82
124
  "span",
83
125
  {
84
126
  className: cn(
@@ -1,26 +1,37 @@
1
- import { type ReactNode, type Ref } from "react";
1
+ import { type CSSProperties, type ReactNode, type Ref } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
+ import { type Material } from "../../utils/material.js";
3
4
  export type TopbarPart = "root" | "inner" | "menuButton" | "breadcrumbs" | "crumb" | "separator" | "current" | "search" | "searchText" | "shortcut";
4
5
  export interface TopbarProps {
5
- /** Breadcrumb trail in order; the last entry is the current view. */
6
- breadcrumbs: string[];
6
+ /** Breadcrumb trail in order; the last entry is the current view. Nothing renders when absent or empty. */
7
+ breadcrumbs?: string[];
7
8
  /** Accessible name of the breadcrumb landmark. */
8
- breadcrumbsLabel: string;
9
+ breadcrumbsLabel?: string;
9
10
  /** Menu button (shown when the `AppShell` container is under 900 px, matching the Sidebar drawer) that opens the sidebar drawer. Needs an `@container/app` ancestor, which `AppShell` provides. Omitted when not set. */
10
11
  onOpenMenu?: () => void;
11
12
  menuLabel?: string;
12
13
  /** Ref to the menu button so the opener can restore focus when the drawer closes. */
13
14
  menuButtonRef?: Ref<HTMLButtonElement>;
14
- /** Called by the search trigger and by Cmd/Ctrl+K. */
15
- onSearch: () => void;
16
- searchLabel: string;
17
- searchPlaceholder: string;
15
+ /** Called by the search trigger and by Cmd/Ctrl+K. The trigger and the shortcut are absent without it. */
16
+ onSearch?: () => void;
17
+ /** Accessible name of the search trigger; defaults to the placeholder. */
18
+ searchLabel?: string;
19
+ searchPlaceholder?: string;
18
20
  /** Slot between the search trigger and the end block (status, notifications, primary action). */
19
21
  actions?: ReactNode;
20
22
  /** Slot at the far end (e.g. the account menu). */
21
23
  end?: ReactNode;
22
24
  className?: string;
25
+ /** Inline style of the root (for example `liquidStyle()` options). */
26
+ style?: CSSProperties;
27
+ /**
28
+ * Surface material. Omitted keeps the default for this layer (opaque, glass in the glass
29
+ * preset); `"glass"` and `"glass-clear"` are frosted glass, `"liquid"` and `"liquid-clear"`
30
+ * Liquid Glass, `"solid"` forces opaque. Liquid options go in `style` (`liquidStyle()` from
31
+ * `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
32
+ */
33
+ material?: Material;
23
34
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
24
35
  classNames?: ClassNames<TopbarPart>;
25
36
  }
26
- export declare function Topbar({ breadcrumbs, breadcrumbsLabel, onOpenMenu, menuLabel, menuButtonRef, onSearch, searchLabel, searchPlaceholder, actions, end, className, classNames, }: TopbarProps): import("react").JSX.Element;
37
+ export declare function Topbar({ breadcrumbs, breadcrumbsLabel, onOpenMenu, menuLabel, menuButtonRef, onSearch, searchLabel, searchPlaceholder, actions, end, material, style, className, classNames, }: TopbarProps): import("react").JSX.Element;
@@ -3,6 +3,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
3
3
  import { useEffect, useState } from "react";
4
4
  import { Menu, Search } from "../../icons/index.js";
5
5
  import { cn } from "../../utils/cn.js";
6
+ import { materialClass } from "../../utils/material.js";
6
7
  function isApplePlatform() {
7
8
  if (typeof navigator === "undefined") return false;
8
9
  return /Mac|iPhone|iPod|iPad/.test(navigator.platform || navigator.userAgent || "");
@@ -18,6 +19,8 @@ function Topbar({
18
19
  searchPlaceholder,
19
20
  actions,
20
21
  end,
22
+ material,
23
+ style,
21
24
  className,
22
25
  classNames
23
26
  }) {
@@ -26,24 +29,28 @@ function Topbar({
26
29
  setShortcut(isApplePlatform() ? "\u2318K" : "Ctrl+K");
27
30
  }, []);
28
31
  useEffect(() => {
32
+ if (!onSearch) return;
29
33
  function onKeyDown(event) {
30
34
  if (!(event.metaKey || event.ctrlKey) || event.key.toLowerCase() !== "k") return;
31
35
  event.preventDefault();
32
- onSearch();
36
+ onSearch?.();
33
37
  }
34
38
  window.addEventListener("keydown", onKeyDown);
35
39
  return () => window.removeEventListener("keydown", onKeyDown);
36
40
  }, [onSearch]);
37
- const current = breadcrumbs.at(-1);
38
- const previous = breadcrumbs.slice(0, -1);
41
+ const trail = breadcrumbs ?? [];
42
+ const current = trail.at(-1);
43
+ const previous = trail.slice(0, -1);
39
44
  return /* @__PURE__ */ jsx(
40
45
  "header",
41
46
  {
42
47
  className: cn(
43
- "@container/topbar sticky top-0 z-30 h-top-height border-b-divider bg-bg",
48
+ "@container/topbar sticky top-0 z-30 h-top-height border-b-divider surface-nav",
49
+ materialClass(material, "surface-solid [--surface-solid:var(--bg)]"),
44
50
  classNames?.root,
45
51
  className
46
52
  ),
53
+ style,
47
54
  children: /* @__PURE__ */ jsxs(
48
55
  "div",
49
56
  {
@@ -66,7 +73,7 @@ function Topbar({
66
73
  children: /* @__PURE__ */ jsx(Menu, { className: "size-5", "aria-hidden": "true" })
67
74
  }
68
75
  ) : null,
69
- /* @__PURE__ */ jsxs(
76
+ trail.length > 0 ? /* @__PURE__ */ jsxs(
70
77
  "nav",
71
78
  {
72
79
  "aria-label": breadcrumbsLabel,
@@ -99,12 +106,12 @@ function Topbar({
99
106
  )
100
107
  ]
101
108
  }
102
- ),
103
- /* @__PURE__ */ jsxs(
109
+ ) : null,
110
+ onSearch ? /* @__PURE__ */ jsxs(
104
111
  "button",
105
112
  {
106
113
  type: "button",
107
- "aria-label": searchLabel,
114
+ "aria-label": searchLabel ?? searchPlaceholder,
108
115
  onClick: onSearch,
109
116
  className: cn(
110
117
  "ml-auto flex h-8.5 w-[min(320px,38cqw)] shrink-0 items-center gap-2 rounded-input border-control bg-surface-control pr-2 pl-2.5 text-ink-3 text-meta @max-[700px]/topbar:w-8.5 @max-[700px]/topbar:justify-center @max-[700px]/topbar:px-0",
@@ -125,7 +132,7 @@ function Topbar({
125
132
  )
126
133
  ]
127
134
  }
128
- ),
135
+ ) : /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: "ml-auto" }),
129
136
  actions,
130
137
  end
131
138
  ]
@@ -6,6 +6,8 @@ export interface EmptyStateProps {
6
6
  description?: ReactNode;
7
7
  /** Primary call to action. */
8
8
  action?: ReactNode;
9
+ /** `outlined` draws a dashed border around the state. */
10
+ variant?: "plain" | "outlined";
9
11
  className?: string;
10
12
  }
11
- export declare function EmptyState({ icon, title, description, action, className }: EmptyStateProps): import("react").JSX.Element;
13
+ export declare function EmptyState({ icon, title, description, action, variant, className, }: EmptyStateProps): import("react").JSX.Element;
@@ -1,11 +1,19 @@
1
1
  import { jsx, jsxs } from "react/jsx-runtime";
2
2
  import { cn } from "../../utils/cn.js";
3
- function EmptyState({ icon, title, description, action, className }) {
3
+ function EmptyState({
4
+ icon,
5
+ title,
6
+ description,
7
+ action,
8
+ variant = "plain",
9
+ className
10
+ }) {
4
11
  return /* @__PURE__ */ jsxs(
5
12
  "div",
6
13
  {
7
14
  className: cn(
8
15
  "@container/empty flex min-w-0 flex-col items-center gap-2 px-4 py-8 text-center @min-[360px]/empty:px-6 @min-[360px]/empty:py-12",
16
+ variant === "outlined" && "rounded-card border border-line-control border-dashed",
9
17
  className
10
18
  ),
11
19
  children: [
@@ -12,6 +12,8 @@ export interface ErrorStateProps {
12
12
  correlationLabel?: string;
13
13
  onRetry?: () => void;
14
14
  retryLabel?: string;
15
+ /** `outlined` draws a danger border around the state. */
16
+ variant?: "plain" | "outlined";
15
17
  className?: string;
16
18
  }
17
- export declare function ErrorState({ title, description, message, correlationId, correlationLabel, onRetry, retryLabel, className, }: ErrorStateProps): import("react").JSX.Element;
19
+ export declare function ErrorState({ title, description, message, correlationId, correlationLabel, onRetry, retryLabel, variant, className, }: ErrorStateProps): import("react").JSX.Element;
@@ -11,6 +11,7 @@ function ErrorState({
11
11
  correlationLabel,
12
12
  onRetry,
13
13
  retryLabel,
14
+ variant = "plain",
14
15
  className
15
16
  }) {
16
17
  const strings = useUiStrings();
@@ -22,6 +23,7 @@ function ErrorState({
22
23
  role: "alert",
23
24
  className: cn(
24
25
  "@container/state flex min-w-0 flex-col items-center gap-2 px-4 py-8 text-center @min-[360px]/state:px-6 @min-[360px]/state:py-10",
26
+ variant === "outlined" && "rounded-card border border-danger",
25
27
  className
26
28
  ),
27
29
  children: [
@@ -1,5 +1,6 @@
1
1
  export * from "./empty-state/index.js";
2
2
  export * from "./error-state/index.js";
3
3
  export * from "./forbidden-state/index.js";
4
+ export * from "./live-status-bar/index.js";
4
5
  export * from "./offline-banner/index.js";
5
6
  export * from "./skeleton/index.js";
@@ -1,5 +1,6 @@
1
1
  export * from "./empty-state/index.js";
2
2
  export * from "./error-state/index.js";
3
3
  export * from "./forbidden-state/index.js";
4
+ export * from "./live-status-bar/index.js";
4
5
  export * from "./offline-banner/index.js";
5
6
  export * from "./skeleton/index.js";
@@ -0,0 +1 @@
1
+ export { type LiveStatus, LiveStatusBar, type LiveStatusBarPart, type LiveStatusBarProps, } from "./live-status-bar.js";
@@ -0,0 +1,6 @@
1
+ import {
2
+ LiveStatusBar
3
+ } from "./live-status-bar.js";
4
+ export {
5
+ LiveStatusBar
6
+ };
@@ -0,0 +1,17 @@
1
+ import type { ComponentPropsWithoutRef } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ export type LiveStatus = "live" | "reconnecting" | "offline";
4
+ export type LiveStatusBarPart = "root" | "indicator" | "label";
5
+ export interface LiveStatusBarProps extends Omit<ComponentPropsWithoutRef<"div">, "role"> {
6
+ status: LiveStatus;
7
+ /** Replaces the localized text of a status, e.g. `{ live: "Connected" }`. */
8
+ labels?: Partial<Record<LiveStatus, string>>;
9
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
10
+ classNames?: ClassNames<LiveStatusBarPart>;
11
+ }
12
+ /**
13
+ * Connection status for a realtime view: a colored dot plus its text, and `children` for what
14
+ * the view shows next to it (counts, a last-update time). A polite `role="status"`, so a change
15
+ * of `status` is announced without interrupting. Meaning never relies on color alone.
16
+ */
17
+ export declare function LiveStatusBar({ status, labels, className, classNames, children, ...props }: LiveStatusBarProps): import("react").JSX.Element;
@@ -0,0 +1,49 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { useUiStrings } from "../../i18n/index.js";
4
+ import { cn } from "../../utils/cn.js";
5
+ const dotClasses = {
6
+ live: "bg-success",
7
+ reconnecting: "animate-pulse bg-warning motion-reduce:animate-none",
8
+ offline: "bg-danger"
9
+ };
10
+ function LiveStatusBar({
11
+ status,
12
+ labels,
13
+ className,
14
+ classNames,
15
+ children,
16
+ ...props
17
+ }) {
18
+ const strings = useUiStrings();
19
+ const text = labels?.[status] ?? strings[status];
20
+ return /* @__PURE__ */ jsxs(
21
+ "div",
22
+ {
23
+ role: "status",
24
+ "data-status": status,
25
+ className: cn(
26
+ "flex flex-wrap items-center gap-x-4 gap-y-1 rounded-card bg-surface-2 px-3.5 py-2.5 text-control",
27
+ classNames?.root,
28
+ className
29
+ ),
30
+ ...props,
31
+ children: [
32
+ /* @__PURE__ */ jsxs("span", { className: cn("inline-flex items-center gap-2 font-semibold", classNames?.label), children: [
33
+ /* @__PURE__ */ jsx(
34
+ "span",
35
+ {
36
+ "aria-hidden": "true",
37
+ className: cn("size-2.5 rounded-pill", dotClasses[status], classNames?.indicator)
38
+ }
39
+ ),
40
+ text
41
+ ] }),
42
+ children
43
+ ]
44
+ }
45
+ );
46
+ }
47
+ export {
48
+ LiveStatusBar
49
+ };
@@ -5,6 +5,8 @@ export interface OfflineBannerProps {
5
5
  /** Screen reader text for the queue counter. */
6
6
  queuedLabel?: string;
7
7
  message: ReactNode;
8
+ /** Optional action next to the message, e.g. a retry `Button`. Shown after the queue counter. */
9
+ action?: ReactNode;
8
10
  className?: string;
9
11
  }
10
- export declare function OfflineBanner({ queuedChanges, queuedLabel, message, className, }: OfflineBannerProps): import("react").JSX.Element;
12
+ export declare function OfflineBanner({ queuedChanges, queuedLabel, message, action, className, }: OfflineBannerProps): import("react").JSX.Element;
@@ -1,9 +1,10 @@
1
- import { jsx, jsxs } from "react/jsx-runtime";
1
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
2
2
  import { Banner } from "../../containers/banner/index.js";
3
3
  function OfflineBanner({
4
4
  queuedChanges = 0,
5
5
  queuedLabel,
6
6
  message,
7
+ action,
7
8
  className
8
9
  }) {
9
10
  return /* @__PURE__ */ jsx(
@@ -11,9 +12,12 @@ function OfflineBanner({
11
12
  {
12
13
  tone: "warning",
13
14
  className,
14
- action: queuedChanges > 0 ? /* @__PURE__ */ jsxs("span", { className: "font-semibold text-fs-120 tabular-nums", children: [
15
- /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: queuedChanges }),
16
- /* @__PURE__ */ jsx("span", { className: "sr-only", children: queuedLabel ?? String(queuedChanges) })
15
+ action: queuedChanges > 0 || action ? /* @__PURE__ */ jsxs(Fragment, { children: [
16
+ queuedChanges > 0 ? /* @__PURE__ */ jsxs("span", { className: "font-semibold text-fs-120 tabular-nums", children: [
17
+ /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: queuedChanges }),
18
+ /* @__PURE__ */ jsx("span", { className: "sr-only", children: queuedLabel ?? String(queuedChanges) })
19
+ ] }) : null,
20
+ action
17
21
  ] }) : void 0,
18
22
  children: message
19
23
  }
@@ -481,6 +481,23 @@ const GROUPS = [
481
481
  ...perSide("border-w", "border", AXES, borderWidth, "-"),
482
482
  ["divide-x", "divide-x", borderWidth],
483
483
  ["divide-x-reverse", "", ["divide-x-reverse"]],
484
+ // The kit's surface materials: a later one replaces an earlier one, so `glass` in a className
485
+ // wins over a component's default `surface-card`.
486
+ [
487
+ "surface-material",
488
+ "",
489
+ [
490
+ "surface-card",
491
+ "surface-overlay",
492
+ "surface-nav",
493
+ "surface-side",
494
+ "glass",
495
+ "glass-clear",
496
+ "liquid",
497
+ "liquid-clear",
498
+ "surface-solid"
499
+ ]
500
+ ],
484
501
  ["divide-y", "divide-y", borderWidth],
485
502
  ["divide-y-reverse", "", ["divide-y-reverse"]],
486
503
  ["border-style", "border", [...lineStyle, "hidden", "none"]],
@@ -1,3 +1,4 @@
1
1
  export type { ClassNames } from "./class-names.js";
2
2
  export { type ClassMergeConfig, type ClassMergeTheme, type Cn, cn, createCn, extendCn, } from "./cn.js";
3
+ export { type Material, materialClass } from "./material.js";
3
4
  export { usePrefersReducedMotion } from "./reduced-motion.js";
@@ -3,10 +3,12 @@ import {
3
3
  createCn,
4
4
  extendCn
5
5
  } from "./cn.js";
6
+ import { materialClass } from "./material.js";
6
7
  import { usePrefersReducedMotion } from "./reduced-motion.js";
7
8
  export {
8
9
  cn,
9
10
  createCn,
10
11
  extendCn,
12
+ materialClass,
11
13
  usePrefersReducedMotion
12
14
  };
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Surface material of a component: opaque (`solid`), frosted glass (`glass`, `glass-clear`: blur
3
+ * and tint) or Liquid Glass (`liquid`, `liquid-clear`: rim, depth, and the lens once
4
+ * `<LiquidGlass />` is mounted). Liquid options are CSS variables: pass `liquidStyle(options)`
5
+ * from `@jcsoftdev/ui/liquid` as the component's `style`, or set them on a scope or the theme.
6
+ */
7
+ export type Material = "solid" | "glass" | "glass-clear" | "liquid" | "liquid-clear";
8
+ /**
9
+ * Class for a component's `material` prop. `undefined` keeps the component's own default,
10
+ * `"solid"` forces the opaque variant (`solid`), every other value is the utility of the same
11
+ * name. Pass the result after the default class: `cn` lets a later surface material replace it.
12
+ */
13
+ export declare function materialClass(material: Material | undefined, solid: string): string | undefined;
@@ -0,0 +1,6 @@
1
+ function materialClass(material, solid) {
2
+ return material === "solid" ? solid : material;
3
+ }
4
+ export {
5
+ materialClass
6
+ };
@@ -0,0 +1,8 @@
1
+ import type { CSSProperties } from "react";
2
+ /**
3
+ * Names of tones a component styles with its own classes; anything else is looked up as
4
+ * `--tone-<name>`, `--tone-<name>-soft` and `--tone-<name>-ink`, which `tonePalettes` in a theme emits.
5
+ */
6
+ export declare function isCustomTone(tone: string | undefined, builtin: ReadonlySet<string>): tone is string;
7
+ /** Maps a custom tone to the local `--tone-c*` variables the component classes read. */
8
+ export declare function customToneStyle(tone: string | undefined, builtin: ReadonlySet<string>, style?: CSSProperties): CSSProperties | undefined;
@@ -0,0 +1,17 @@
1
+ const TONE_NAME = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
2
+ function isCustomTone(tone, builtin) {
3
+ return tone !== void 0 && !builtin.has(tone) && TONE_NAME.test(tone);
4
+ }
5
+ function customToneStyle(tone, builtin, style) {
6
+ if (!isCustomTone(tone, builtin)) return style;
7
+ return {
8
+ "--tone-c": `var(--tone-${tone})`,
9
+ "--tone-c-soft": `var(--tone-${tone}-soft)`,
10
+ "--tone-c-ink": `var(--tone-${tone}-ink)`,
11
+ ...style
12
+ };
13
+ }
14
+ export {
15
+ customToneStyle,
16
+ isCustomTone
17
+ };
@@ -0,0 +1,5 @@
1
+ /** Copies text to the clipboard (with a textarea fallback) and flags success for `resetMs`. */
2
+ export declare function useCopy(resetMs?: number): {
3
+ copied: boolean;
4
+ copy: (text: string) => Promise<void>;
5
+ };
@@ -0,0 +1,35 @@
1
+ "use client";
2
+ import { useCallback, useEffect, useRef, useState } from "react";
3
+ function useCopy(resetMs = 1600) {
4
+ const [copied, setCopied] = useState(false);
5
+ const timer = useRef(void 0);
6
+ useEffect(() => () => window.clearTimeout(timer.current), []);
7
+ const copy = useCallback(
8
+ async (text) => {
9
+ try {
10
+ await navigator.clipboard.writeText(text);
11
+ } catch {
12
+ const area = document.createElement("textarea");
13
+ area.value = text;
14
+ area.setAttribute("readonly", "");
15
+ area.style.position = "fixed";
16
+ area.style.opacity = "0";
17
+ document.body.append(area);
18
+ area.select();
19
+ try {
20
+ document.execCommand("copy");
21
+ } finally {
22
+ area.remove();
23
+ }
24
+ }
25
+ setCopied(true);
26
+ window.clearTimeout(timer.current);
27
+ timer.current = window.setTimeout(() => setCopied(false), resetMs);
28
+ },
29
+ [resetMs]
30
+ );
31
+ return { copied, copy };
32
+ }
33
+ export {
34
+ useCopy
35
+ };
@@ -0,0 +1,5 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
2
+ <path d="m2 21 9.6-9.6" />
3
+ <path d="m7.5 15.5 2.3 2.3a1 1 0 0 1 0 1.4l-2.1 2.1a1 1 0 0 1-1.4 0L4 19" />
4
+ <circle cx="15.5" cy="7.5" r="5.5" />
5
+ </svg>
@@ -0,0 +1,5 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
2
+ <path d="M18 16.98h-5.99c-1.1 0-1.95.94-2.48 1.9A4 4 0 0 1 2 17c.01-.7.2-1.4.57-2" />
3
+ <path d="m6 17 3.13-5.78c.53-.97.1-2.18-.5-3.1a4 4 0 1 1 6.89-4.06" />
4
+ <path d="m12 6 3.13 5.73C15.66 12.7 16.9 13 18 13a4 4 0 0 1 0 8" />
5
+ </svg>