@jcsoftdev/ui 0.2.3 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/CHANGELOG.md +288 -7
  2. package/README.md +2 -1
  3. package/bin/ui-theme.mjs +1151 -25
  4. package/dist/ai/attachment/attachment.js +1 -1
  5. package/dist/ai/chat-list/group.js +3 -1
  6. package/dist/ai/conversation/conversation.js +1 -1
  7. package/dist/ai/internal/use-copy.d.ts +1 -5
  8. package/dist/ai/internal/use-copy.js +1 -32
  9. package/dist/ai/markdown/parse.js +59 -17
  10. package/dist/ai/source/source.js +1 -1
  11. package/dist/atoms/avatar/avatar.d.ts +13 -3
  12. package/dist/atoms/avatar/avatar.js +40 -2
  13. package/dist/atoms/avatar/index.d.ts +1 -1
  14. package/dist/atoms/avatar/index.js +3 -1
  15. package/dist/atoms/button/button.d.ts +4 -1
  16. package/dist/atoms/button/button.js +4 -2
  17. package/dist/atoms/checkbox/checkbox.d.ts +8 -3
  18. package/dist/atoms/checkbox/checkbox.js +23 -2
  19. package/dist/atoms/chip/chip.d.ts +9 -3
  20. package/dist/atoms/chip/chip.js +26 -4
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +4 -1
  23. package/dist/atoms/status-dot/index.d.ts +1 -1
  24. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  25. package/dist/atoms/status-dot/status-dot.js +5 -1
  26. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  27. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  28. package/dist/charts/chord-chart/chord-chart.js +13 -5
  29. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  30. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  31. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  32. package/dist/charts/core/cartesian/layout.js +14 -5
  33. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  34. package/dist/charts/core/cartesian/marks.js +1 -1
  35. package/dist/charts/core/cartesian/types.d.ts +28 -2
  36. package/dist/charts/core/category-explorer.d.ts +2 -2
  37. package/dist/charts/core/category-explorer.js +8 -4
  38. package/dist/charts/core/chart-dock.d.ts +26 -0
  39. package/dist/charts/core/chart-dock.js +45 -0
  40. package/dist/charts/core/chart-frame.d.ts +9 -2
  41. package/dist/charts/core/chart-frame.js +105 -25
  42. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  43. package/dist/charts/core/distribution/explorer.js +12 -5
  44. package/dist/charts/core/distribution/xy-points.js +1 -1
  45. package/dist/charts/core/index.d.ts +3 -0
  46. package/dist/charts/core/index.js +3 -0
  47. package/dist/charts/core/leave-grace.d.ts +11 -0
  48. package/dist/charts/core/leave-grace.js +26 -0
  49. package/dist/charts/core/nearest.d.ts +14 -0
  50. package/dist/charts/core/nearest.js +22 -0
  51. package/dist/charts/core/plot-overlay.js +9 -3
  52. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  53. package/dist/charts/core/pointer.test-utils.js +123 -0
  54. package/dist/charts/core/tooltip.d.ts +25 -2
  55. package/dist/charts/core/tooltip.js +115 -40
  56. package/dist/charts/core/touch-select.d.ts +20 -0
  57. package/dist/charts/core/touch-select.js +184 -0
  58. package/dist/charts/core/types.d.ts +8 -4
  59. package/dist/charts/core/types.js +5 -0
  60. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  61. package/dist/charts/core/use-index-navigation.js +47 -10
  62. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  63. package/dist/charts/donut-chart/donut-chart.js +40 -1
  64. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  65. package/dist/charts/donut-chart/slice-labels.js +20 -0
  66. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  67. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  68. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  69. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  70. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  71. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  72. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  73. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  74. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  75. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  76. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  77. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  78. package/dist/charts/maps/geo/map-viewport.js +1 -1
  79. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  80. package/dist/charts/progress-units/progress-units.js +1 -0
  81. package/dist/charts/radar-chart/radar-chart.js +1 -1
  82. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  83. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  84. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  85. package/dist/charts/tree-chart/tree-chart.js +1 -0
  86. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  87. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  88. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  89. package/dist/containers/action-bar/action-bar.js +4 -1
  90. package/dist/containers/card/card.d.ts +21 -3
  91. package/dist/containers/card/card.js +20 -5
  92. package/dist/containers/grid/grid.d.ts +15 -0
  93. package/dist/containers/grid/grid.js +24 -0
  94. package/dist/containers/grid/index.d.ts +1 -0
  95. package/dist/containers/grid/index.js +4 -0
  96. package/dist/containers/index.d.ts +3 -0
  97. package/dist/containers/index.js +3 -0
  98. package/dist/containers/kpi/kpi.d.ts +13 -2
  99. package/dist/containers/kpi/kpi.js +86 -24
  100. package/dist/containers/kpi-group/index.d.ts +1 -1
  101. package/dist/containers/kpi-group/index.js +3 -1
  102. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  103. package/dist/containers/kpi-group/kpi-group.js +11 -1
  104. package/dist/containers/page/index.d.ts +1 -0
  105. package/dist/containers/page/index.js +4 -0
  106. package/dist/containers/page/page.d.ts +7 -0
  107. package/dist/containers/page/page.js +14 -0
  108. package/dist/containers/page-header/page-header.d.ts +8 -3
  109. package/dist/containers/page-header/page-header.js +35 -8
  110. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  111. package/dist/containers/responsive-list/responsive-list.js +6 -3
  112. package/dist/containers/stack/index.d.ts +1 -0
  113. package/dist/containers/stack/index.js +6 -0
  114. package/dist/containers/stack/stack.d.ts +15 -0
  115. package/dist/containers/stack/stack.js +43 -0
  116. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  117. package/dist/forms/copy-field/copy-field.js +72 -0
  118. package/dist/forms/copy-field/index.d.ts +1 -0
  119. package/dist/forms/copy-field/index.js +4 -0
  120. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  121. package/dist/forms/form/form.d.ts +15 -0
  122. package/dist/forms/form/form.js +29 -0
  123. package/dist/forms/form/index.d.ts +1 -0
  124. package/dist/forms/form/index.js +10 -0
  125. package/dist/forms/index.d.ts +2 -0
  126. package/dist/forms/index.js +2 -0
  127. package/dist/forms/input/index.d.ts +1 -1
  128. package/dist/forms/input/index.js +3 -2
  129. package/dist/forms/input/input.d.ts +6 -2
  130. package/dist/forms/input/input.js +9 -3
  131. package/dist/glass/crystal-map.d.ts +70 -0
  132. package/dist/glass/crystal-map.js +88 -0
  133. package/dist/glass/displacement-map.d.ts +117 -0
  134. package/dist/glass/displacement-map.js +201 -0
  135. package/dist/glass/index.d.ts +8 -0
  136. package/dist/glass/index.js +63 -0
  137. package/dist/glass/lens-crystal.d.ts +29 -0
  138. package/dist/glass/lens-crystal.js +161 -0
  139. package/dist/glass/lens-dispersion.d.ts +11 -0
  140. package/dist/glass/lens-dispersion.js +19 -0
  141. package/dist/glass/liquid-glass.d.ts +41 -0
  142. package/dist/glass/liquid-glass.js +256 -0
  143. package/dist/glass/liquid-motion.d.ts +53 -0
  144. package/dist/glass/liquid-motion.js +302 -0
  145. package/dist/glass/liquid-options.d.ts +162 -0
  146. package/dist/glass/liquid-options.js +179 -0
  147. package/dist/glass/refraction.d.ts +100 -0
  148. package/dist/glass/refraction.js +714 -0
  149. package/dist/glass/specular-map.d.ts +26 -0
  150. package/dist/glass/specular-map.js +75 -0
  151. package/dist/glass/spring.d.ts +79 -0
  152. package/dist/glass/spring.js +58 -0
  153. package/dist/glass/support.d.ts +13 -0
  154. package/dist/glass/support.js +14 -0
  155. package/dist/glass/use-glass-refraction.d.ts +8 -0
  156. package/dist/glass/use-glass-refraction.js +16 -0
  157. package/dist/i18n/strings.d.ts +24 -0
  158. package/dist/i18n/strings.js +18 -2
  159. package/dist/icons/index.d.ts +2 -0
  160. package/dist/icons/index.js +4 -0
  161. package/dist/icons/key.d.ts +2 -0
  162. package/dist/icons/key.js +12 -0
  163. package/dist/icons/webhook.d.ts +2 -0
  164. package/dist/icons/webhook.js +12 -0
  165. package/dist/liquid/index.d.ts +3 -0
  166. package/dist/liquid/index.js +29 -0
  167. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  168. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  169. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  170. package/dist/navigation/breadcrumbs/index.js +6 -0
  171. package/dist/navigation/index.d.ts +1 -0
  172. package/dist/navigation/index.js +1 -0
  173. package/dist/navigation/segmented/index.d.ts +1 -1
  174. package/dist/navigation/segmented/model.d.ts +5 -0
  175. package/dist/navigation/segmented/model.js +6 -0
  176. package/dist/navigation/segmented/segmented.d.ts +17 -3
  177. package/dist/navigation/segmented/segmented.js +20 -4
  178. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  179. package/dist/overlays/context-menu/context-menu.js +4 -1
  180. package/dist/overlays/dialog/dialog.d.ts +9 -1
  181. package/dist/overlays/dialog/dialog.js +3 -0
  182. package/dist/overlays/drawer/drawer.d.ts +9 -1
  183. package/dist/overlays/drawer/drawer.js +3 -0
  184. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +9 -1
  185. package/dist/overlays/dropdown-menu/dropdown-menu.js +3 -1
  186. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  187. package/dist/overlays/hover-card/hover-card.js +4 -1
  188. package/dist/overlays/popover/popover.d.ts +9 -1
  189. package/dist/overlays/popover/popover.js +3 -0
  190. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  191. package/dist/palette/command-palette/command-palette.js +5 -0
  192. package/dist/primitives/command/command.d.ts +3 -2
  193. package/dist/primitives/command/command.js +2 -0
  194. package/dist/primitives/menu/menu.js +1 -1
  195. package/dist/primitives/popper/popper.js +5 -0
  196. package/dist/rich-text/rich-text-editor.js +94 -8
  197. package/dist/rich-text/sanitize.js +70 -20
  198. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  199. package/dist/shell/app-shell/app-shell.js +44 -4
  200. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  201. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  202. package/dist/shell/bottom-nav/index.d.ts +2 -0
  203. package/dist/shell/bottom-nav/index.js +9 -0
  204. package/dist/shell/bottom-nav/split.d.ts +11 -0
  205. package/dist/shell/bottom-nav/split.js +10 -0
  206. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  207. package/dist/shell/sidebar/sidebar.js +46 -4
  208. package/dist/shell/topbar/topbar.d.ts +20 -9
  209. package/dist/shell/topbar/topbar.js +16 -9
  210. package/dist/states/empty-state/empty-state.d.ts +3 -1
  211. package/dist/states/empty-state/empty-state.js +9 -1
  212. package/dist/states/error-state/error-state.d.ts +3 -1
  213. package/dist/states/error-state/error-state.js +2 -0
  214. package/dist/states/index.d.ts +1 -0
  215. package/dist/states/index.js +1 -0
  216. package/dist/states/live-status-bar/index.d.ts +1 -0
  217. package/dist/states/live-status-bar/index.js +6 -0
  218. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  219. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  220. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  221. package/dist/states/offline-banner/offline-banner.js +8 -4
  222. package/dist/utils/class-groups.js +17 -0
  223. package/dist/utils/index.d.ts +1 -0
  224. package/dist/utils/index.js +2 -0
  225. package/dist/utils/material.d.ts +13 -0
  226. package/dist/utils/material.js +6 -0
  227. package/dist/utils/tone.d.ts +8 -0
  228. package/dist/utils/tone.js +17 -0
  229. package/dist/utils/use-copy.d.ts +5 -0
  230. package/dist/utils/use-copy.js +35 -0
  231. package/icons/svg/key.svg +5 -0
  232. package/icons/svg/webhook.svg +5 -0
  233. package/package.json +31 -21
  234. package/scripts/build-theme.d.mts +22 -0
  235. package/scripts/build-theme.mjs +236 -4
  236. package/src/ai/attachment/attachment.tsx +1 -1
  237. package/src/ai/chat-list/group.ts +3 -1
  238. package/src/ai/conversation/conversation.tsx +1 -1
  239. package/src/ai/internal/use-copy.ts +1 -38
  240. package/src/ai/markdown/parse.ts +74 -17
  241. package/src/ai/source/source.tsx +1 -1
  242. package/src/atoms/avatar/avatar.tsx +57 -4
  243. package/src/atoms/avatar/index.ts +8 -1
  244. package/src/atoms/button/button.tsx +8 -3
  245. package/src/atoms/checkbox/checkbox.tsx +30 -3
  246. package/src/atoms/chip/chip.tsx +37 -5
  247. package/src/atoms/chip/index.ts +7 -1
  248. package/src/atoms/status-dot/index.ts +1 -0
  249. package/src/atoms/status-dot/status-dot.tsx +15 -3
  250. package/src/charts/README.md +21 -0
  251. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  252. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  253. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  254. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  255. package/src/charts/core/cartesian/layout.ts +29 -10
  256. package/src/charts/core/cartesian/marks.tsx +3 -3
  257. package/src/charts/core/cartesian/types.ts +30 -2
  258. package/src/charts/core/category-explorer.tsx +12 -6
  259. package/src/charts/core/chart-dock.tsx +68 -0
  260. package/src/charts/core/chart-frame.tsx +116 -27
  261. package/src/charts/core/distribution/explorer.tsx +17 -7
  262. package/src/charts/core/distribution/xy-points.tsx +1 -1
  263. package/src/charts/core/index.ts +3 -0
  264. package/src/charts/core/leave-grace.ts +35 -0
  265. package/src/charts/core/nearest.ts +38 -0
  266. package/src/charts/core/plot-overlay.tsx +9 -3
  267. package/src/charts/core/pointer.test-utils.ts +146 -0
  268. package/src/charts/core/tooltip.tsx +129 -15
  269. package/src/charts/core/touch-select.ts +250 -0
  270. package/src/charts/core/types.ts +13 -4
  271. package/src/charts/core/use-index-navigation.ts +70 -11
  272. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  273. package/src/charts/donut-chart/slice-labels.ts +39 -0
  274. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  275. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  276. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  277. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  278. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  279. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  280. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  281. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  282. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  283. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  284. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  285. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  286. package/src/charts/progress-units/progress-units.tsx +1 -0
  287. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  288. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  289. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  290. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  291. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  292. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  293. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  294. package/src/containers/action-bar/action-bar.tsx +13 -2
  295. package/src/containers/card/card.tsx +43 -4
  296. package/src/containers/grid/grid.tsx +37 -0
  297. package/src/containers/grid/index.ts +1 -0
  298. package/src/containers/index.ts +3 -0
  299. package/src/containers/kpi/kpi.tsx +116 -22
  300. package/src/containers/kpi-group/index.ts +7 -1
  301. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  302. package/src/containers/page/index.ts +1 -0
  303. package/src/containers/page/page.tsx +17 -0
  304. package/src/containers/page-header/page-header.tsx +38 -8
  305. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  306. package/src/containers/stack/index.ts +7 -0
  307. package/src/containers/stack/stack.tsx +55 -0
  308. package/src/forms/copy-field/copy-field.tsx +88 -0
  309. package/src/forms/copy-field/index.ts +1 -0
  310. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  311. package/src/forms/form/form.tsx +46 -0
  312. package/src/forms/form/index.ts +8 -0
  313. package/src/forms/index.ts +2 -0
  314. package/src/forms/input/index.ts +1 -1
  315. package/src/forms/input/input.tsx +14 -3
  316. package/src/glass/crystal-map.ts +150 -0
  317. package/src/glass/displacement-map.ts +317 -0
  318. package/src/glass/index.ts +43 -0
  319. package/src/glass/lens-crystal.ts +226 -0
  320. package/src/glass/lens-dispersion.ts +34 -0
  321. package/src/glass/liquid-glass.tsx +371 -0
  322. package/src/glass/liquid-motion.ts +395 -0
  323. package/src/glass/liquid-options.ts +306 -0
  324. package/src/glass/refraction.ts +1010 -0
  325. package/src/glass/specular-map.ts +95 -0
  326. package/src/glass/spring.ts +98 -0
  327. package/src/glass/support.ts +27 -0
  328. package/src/glass/use-glass-refraction.ts +21 -0
  329. package/src/i18n/strings.ts +24 -0
  330. package/src/icons/index.ts +2 -0
  331. package/src/icons/key.tsx +13 -0
  332. package/src/icons/webhook.tsx +13 -0
  333. package/src/liquid/index.ts +24 -0
  334. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  335. package/src/navigation/breadcrumbs/index.ts +8 -0
  336. package/src/navigation/index.ts +1 -0
  337. package/src/navigation/segmented/index.ts +1 -0
  338. package/src/navigation/segmented/model.ts +11 -0
  339. package/src/navigation/segmented/segmented.tsx +45 -6
  340. package/src/overlays/context-menu/context-menu.tsx +11 -1
  341. package/src/overlays/dialog/dialog.tsx +10 -0
  342. package/src/overlays/drawer/drawer.tsx +10 -0
  343. package/src/overlays/dropdown-menu/dropdown-menu.tsx +10 -1
  344. package/src/overlays/hover-card/hover-card.tsx +12 -1
  345. package/src/overlays/popover/popover.tsx +10 -0
  346. package/src/palette/command-palette/command-palette.tsx +15 -1
  347. package/src/primitives/command/command.tsx +4 -0
  348. package/src/primitives/menu/menu.tsx +1 -1
  349. package/src/primitives/popper/popper.tsx +10 -0
  350. package/src/rich-text/rich-text-editor.tsx +116 -13
  351. package/src/rich-text/sanitize.ts +94 -23
  352. package/src/shell/app-shell/app-shell.tsx +60 -4
  353. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  354. package/src/shell/bottom-nav/index.ts +8 -0
  355. package/src/shell/bottom-nav/split.ts +20 -0
  356. package/src/shell/sidebar/sidebar.tsx +51 -5
  357. package/src/shell/topbar/topbar.tsx +81 -58
  358. package/src/states/empty-state/empty-state.tsx +11 -1
  359. package/src/states/error-state/error-state.tsx +4 -0
  360. package/src/states/index.ts +1 -0
  361. package/src/states/live-status-bar/index.ts +6 -0
  362. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  363. package/src/states/offline-banner/offline-banner.tsx +13 -5
  364. package/src/utils/class-groups.ts +17 -0
  365. package/src/utils/index.ts +1 -0
  366. package/src/utils/material.ts +16 -0
  367. package/src/utils/tone.ts +29 -0
  368. package/src/utils/use-copy.ts +38 -0
  369. package/styles/Theme.kt +64 -3
  370. package/styles/base.css +51 -0
  371. package/styles/tailwind.css +833 -0
  372. package/styles/theme.css +546 -4
  373. package/styles/tokens.css +788 -15
  374. package/tokens/default.json +918 -29
  375. package/scripts/build-theme.d.ts +0 -18
@@ -8,8 +8,10 @@ import {
8
8
  useContext,
9
9
  useEffect,
10
10
  useLayoutEffect,
11
+ useMemo,
11
12
  useRef,
12
13
  useState,
14
+ useSyncExternalStore,
13
15
  } from "react";
14
16
  import { cn } from "../../utils/cn.js";
15
17
  import { useComposedRefs } from "../../utils/compose.js";
@@ -48,11 +50,57 @@ interface AppShellState {
48
50
  compact: boolean;
49
51
  }
50
52
 
51
- const AppShellContext = createContext<AppShellState | null>(null);
53
+ /** Measured compact flag of one `AppShell`, readable through `useSyncExternalStore`. */
54
+ export interface AppShellStore {
55
+ subscribe: (listener: () => void) => () => void;
56
+ getSnapshot: () => boolean;
57
+ /** Same value the first client render reads, so hydration never sees a different snapshot. */
58
+ getServerSnapshot: () => boolean;
59
+ /** Starts measuring `element`; returns the stop function. */
60
+ observe: (element: HTMLElement) => () => void;
61
+ }
62
+
63
+ export function createAppShellStore(): AppShellStore {
64
+ let compact = false;
65
+ const listeners = new Set<() => void>();
66
+ const set = (next: boolean) => {
67
+ if (next === compact) return;
68
+ compact = next;
69
+ for (const listener of listeners) listener();
70
+ };
71
+ return {
72
+ subscribe(listener) {
73
+ listeners.add(listener);
74
+ return () => void listeners.delete(listener);
75
+ },
76
+ getSnapshot: () => compact,
77
+ getServerSnapshot: () => false,
78
+ observe(element) {
79
+ const measure = () => set(element.getBoundingClientRect().width < APP_SHELL_BREAKPOINT);
80
+ measure();
81
+ if (typeof ResizeObserver === "undefined") return () => {};
82
+ const observer = new ResizeObserver(measure);
83
+ observer.observe(element);
84
+ return () => observer.disconnect();
85
+ },
86
+ };
87
+ }
88
+
89
+ const noopSubscribe = () => () => {};
90
+ const alwaysFalse = () => false;
91
+
92
+ /** Not part of the public API; exported for the hydration test. */
93
+ export const AppShellContext = createContext<AppShellStore | null>(null);
52
94
 
53
95
  /** `null` outside an `AppShell`; otherwise whether the shell is narrower than 900 px. */
54
96
  export function useAppShell(): AppShellState | null {
55
- return useContext(AppShellContext);
97
+ const store = useContext(AppShellContext);
98
+ const compact = useSyncExternalStore(
99
+ store?.subscribe ?? noopSubscribe,
100
+ store?.getSnapshot ?? alwaysFalse,
101
+ alwaysFalse,
102
+ );
103
+ return useMemo(() => (store ? { compact } : null), [store, compact]);
56
104
  }
57
105
 
58
106
  export interface AppShellProps extends ComponentPropsWithRef<"div"> {
@@ -63,13 +111,21 @@ export interface AppShellProps extends ComponentPropsWithRef<"div"> {
63
111
  * Root of the app frame (sidebar + topbar + page). It is the `app` container: the sidebar turns
64
112
  * into a drawer and the topbar shows its menu button when the SHELL is under 900 px wide,
65
113
  * whatever the viewport is, so the same shell works in a full page, a preview or a story.
114
+ *
115
+ * The context value is a store that never changes identity, and it reads `false` on the server
116
+ * and on the first client render. Only components that call `useAppShell` update, and only once
117
+ * the measure arrives, so nothing above a still-dehydrated Suspense boundary re-renders during
118
+ * hydration (a provider value that changed there made Next.js client-render those boundaries).
66
119
  */
67
120
  export function AppShell({ children, className, ref: forwardedRef, ...props }: AppShellProps) {
68
121
  const ref = useRef<HTMLDivElement>(null);
69
- const compact = useCompactContainer(ref);
122
+ const [store] = useState(createAppShellStore);
70
123
  const composedRef = useComposedRefs(ref, forwardedRef);
124
+
125
+ useEffect(() => (ref.current ? store.observe(ref.current) : undefined), [store]);
126
+
71
127
  return (
72
- <AppShellContext.Provider value={{ compact }}>
128
+ <AppShellContext.Provider value={store}>
73
129
  <div ref={composedRef} {...props} className={cn("@container/app flex min-w-0", className)}>
74
130
  {children}
75
131
  </div>
@@ -0,0 +1,187 @@
1
+ "use client";
2
+
3
+ import { type ReactNode, useState } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import { Menu } from "../../icons/index.js";
6
+ import { Drawer, DrawerContent, DrawerTitle } from "../../overlays/drawer/index.js";
7
+ import type { ClassNames } from "../../utils/class-names.js";
8
+ import { cn } from "../../utils/cn.js";
9
+ import type { SidebarItem, SidebarLinkProps } from "../sidebar/index.js";
10
+ import { BOTTOM_NAV_MAX_SLOTS, splitBottomNavItems } from "./split.js";
11
+
12
+ export interface BottomNavLinkProps extends SidebarLinkProps {
13
+ /** Closes the "More" drawer after a navigation; pass it through to the rendered element. */
14
+ onClick?: () => void;
15
+ }
16
+
17
+ /** Renders a bottom-nav link; inject your router's link component here. */
18
+ export type BottomNavRenderLink = (props: BottomNavLinkProps) => ReactNode;
19
+
20
+ export type BottomNavPart =
21
+ | "root"
22
+ | "list"
23
+ | "item"
24
+ | "badge"
25
+ | "moreButton"
26
+ | "moreContent"
27
+ | "moreLink"
28
+ | "moreFooter";
29
+
30
+ export interface BottomNavProps {
31
+ /** Same items as `Sidebar` (`groups.flatMap((group) => group.items)`). Order decides what overflows. */
32
+ items: readonly SidebarItem[];
33
+ /** Accessible name of the bar landmark. */
34
+ ariaLabel: string;
35
+ /** Slots in the bar including "More". Defaults to 5; with fewer items than slots there is no "More". */
36
+ maxSlots?: number;
37
+ /** Text of the "More" button and the drawer title. Defaults to the localized "More". */
38
+ moreLabel?: string;
39
+ /** Pinned at the bottom of the "More" drawer, e.g. the account or a sign-out button. */
40
+ moreFooter?: ReactNode;
41
+ /** Link renderer; defaults to a plain anchor. */
42
+ renderLink?: BottomNavRenderLink;
43
+ className?: string;
44
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
45
+ classNames?: ClassNames<BottomNavPart>;
46
+ }
47
+
48
+ const defaultRenderLink: BottomNavRenderLink = ({ children, ...props }) => (
49
+ <a {...props}>{children}</a>
50
+ );
51
+
52
+ const slotClasses =
53
+ "relative flex min-h-14 w-full flex-col items-center justify-center gap-0.5 px-1 text-ink-2 text-meta focus-visible:focus-ring aria-[current=page]:font-bold aria-[current=page]:text-accent-ink data-[active=true]:font-bold data-[active=true]:text-accent-ink [&_svg]:size-5 [&_svg]:shrink-0";
54
+
55
+ /**
56
+ * Phone navigation bar for `Sidebar`'s items. The first items fill the bar and the rest move
57
+ * behind a "More" button that opens a drawer. Place it as the last child of the page column
58
+ * inside `AppShell`: it sticks to the bottom of the viewport and hides itself once the shell is
59
+ * 900 px or wider, where the sidebar takes over. Without an `AppShell` it is always visible.
60
+ */
61
+ export function BottomNav({
62
+ items,
63
+ ariaLabel,
64
+ maxSlots = BOTTOM_NAV_MAX_SLOTS,
65
+ moreLabel,
66
+ moreFooter,
67
+ renderLink = defaultRenderLink,
68
+ className,
69
+ classNames,
70
+ }: BottomNavProps) {
71
+ const strings = useUiStrings();
72
+ const [moreOpen, setMoreOpen] = useState(false);
73
+ const { visible, overflow } = splitBottomNavItems(items, maxSlots);
74
+ const more = moreLabel ?? strings.more;
75
+ const moreActive = overflow.some((item) => item.active);
76
+
77
+ return (
78
+ <>
79
+ <nav
80
+ aria-label={ariaLabel}
81
+ className={cn(
82
+ "sticky bottom-0 z-40 border-t-divider bg-surface pb-[env(safe-area-inset-bottom)] @min-[900px]/app:hidden",
83
+ classNames?.root,
84
+ className,
85
+ )}
86
+ >
87
+ <ul
88
+ className={cn(
89
+ "m-0 grid list-none auto-cols-[minmax(min-content,1fr)] grid-flow-col p-0",
90
+ classNames?.list,
91
+ )}
92
+ >
93
+ {visible.map((item) => (
94
+ <li key={item.id} className={classNames?.item}>
95
+ {renderLink({
96
+ href: item.href,
97
+ "aria-current": item.active ? "page" : undefined,
98
+ className: slotClasses,
99
+ children: (
100
+ <>
101
+ <span className="relative">
102
+ {item.icon}
103
+ {item.badge !== undefined ? (
104
+ <>
105
+ <span
106
+ aria-hidden="true"
107
+ className={cn(
108
+ "absolute -top-0.5 -right-1 size-2 rounded-pill",
109
+ item.badgeTone === "danger" ? "bg-danger" : "bg-warning",
110
+ classNames?.badge,
111
+ )}
112
+ />
113
+ <span className="sr-only">{item.badgeLabel ?? item.badge}</span>
114
+ </>
115
+ ) : null}
116
+ </span>
117
+ <span className="max-w-full truncate">{item.label}</span>
118
+ </>
119
+ ),
120
+ })}
121
+ </li>
122
+ ))}
123
+ {overflow.length > 0 ? (
124
+ <li className={classNames?.item}>
125
+ <button
126
+ type="button"
127
+ data-active={moreActive}
128
+ aria-haspopup="dialog"
129
+ aria-expanded={moreOpen}
130
+ onClick={() => setMoreOpen(true)}
131
+ className={cn(slotClasses, classNames?.moreButton)}
132
+ >
133
+ <Menu aria-hidden="true" />
134
+ <span>{more}</span>
135
+ </button>
136
+ </li>
137
+ ) : null}
138
+ </ul>
139
+ </nav>
140
+
141
+ {overflow.length > 0 ? (
142
+ <Drawer open={moreOpen} onOpenChange={setMoreOpen}>
143
+ <DrawerContent
144
+ aria-describedby={undefined}
145
+ className={cn("gap-4 p-4", classNames?.moreContent)}
146
+ >
147
+ <DrawerTitle className="font-semibold text-lede">{more}</DrawerTitle>
148
+ <nav aria-label={more} className="flex flex-col gap-px">
149
+ {overflow.map((item) => (
150
+ <div key={item.id}>
151
+ {renderLink({
152
+ href: item.href,
153
+ "aria-current": item.active ? "page" : undefined,
154
+ onClick: () => setMoreOpen(false),
155
+ className: cn(
156
+ "flex min-h-11 items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring aria-[current=page]:bg-accent-soft aria-[current=page]:font-bold aria-[current=page]:text-accent-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
157
+ classNames?.moreLink,
158
+ ),
159
+ children: (
160
+ <>
161
+ {item.icon}
162
+ <span className="min-w-0 truncate">{item.label}</span>
163
+ {item.badge !== undefined ? (
164
+ <span className="ml-auto shrink-0 rounded-chip bg-surface-2 px-1.5 py-0.75 text-count text-ink-2">
165
+ {item.badge}
166
+ {item.badgeLabel ? (
167
+ <span className="sr-only"> {item.badgeLabel}</span>
168
+ ) : null}
169
+ </span>
170
+ ) : null}
171
+ </>
172
+ ),
173
+ })}
174
+ </div>
175
+ ))}
176
+ </nav>
177
+ {moreFooter ? (
178
+ <div className={cn("mt-auto border-t-divider pt-3", classNames?.moreFooter)}>
179
+ {moreFooter}
180
+ </div>
181
+ ) : null}
182
+ </DrawerContent>
183
+ </Drawer>
184
+ ) : null}
185
+ </>
186
+ );
187
+ }
@@ -0,0 +1,8 @@
1
+ export {
2
+ BottomNav,
3
+ type BottomNavLinkProps,
4
+ type BottomNavPart,
5
+ type BottomNavProps,
6
+ type BottomNavRenderLink,
7
+ } from "./bottom-nav.js";
8
+ export { BOTTOM_NAV_MAX_SLOTS, type BottomNavSplit, splitBottomNavItems } from "./split.js";
@@ -0,0 +1,20 @@
1
+ /** Slots of a bottom bar on a phone, the "More" button included. */
2
+ export const BOTTOM_NAV_MAX_SLOTS = 5;
3
+
4
+ export interface BottomNavSplit<T> {
5
+ visible: T[];
6
+ overflow: T[];
7
+ }
8
+
9
+ /**
10
+ * Items shown in the bar and items moved behind "More". Everything fits when there are at most
11
+ * `maxSlots` items; otherwise one slot is given to "More" and the rest overflow in order.
12
+ */
13
+ export function splitBottomNavItems<T>(
14
+ items: readonly T[],
15
+ maxSlots: number = BOTTOM_NAV_MAX_SLOTS,
16
+ ): BottomNavSplit<T> {
17
+ const slots = Math.max(2, Math.floor(maxSlots));
18
+ if (items.length <= slots) return { visible: [...items], overflow: [] };
19
+ return { visible: items.slice(0, slots - 1), overflow: items.slice(slots - 1) };
20
+ }
@@ -1,8 +1,9 @@
1
1
  "use client";
2
2
 
3
- import { type ReactNode, useEffect, useRef } from "react";
3
+ import { type CSSProperties, type ReactNode, useEffect, useRef } from "react";
4
4
  import type { ClassNames } from "../../utils/class-names.js";
5
5
  import { cn } from "../../utils/cn.js";
6
+ import { type Material, materialClass } from "../../utils/material.js";
6
7
  import { useAppShell, useCompactContainer } from "../app-shell/app-shell.js";
7
8
 
8
9
  export interface SidebarLinkProps {
@@ -10,6 +11,8 @@ export interface SidebarLinkProps {
10
11
  className: string;
11
12
  children: ReactNode;
12
13
  "aria-current"?: "page";
14
+ /** Set in rail mode, where the label is visually hidden. */
15
+ title?: string;
13
16
  }
14
17
 
15
18
  /** Renders a navigation link; inject your router's link component here. */
@@ -58,7 +61,18 @@ export interface SidebarProps {
58
61
  /** Drawer state when the app container is under 900 px. Ignored above it, where the sidebar is always visible. */
59
62
  open?: boolean;
60
63
  onClose?: () => void;
64
+ /** Icons-only rail with the labels as tooltips. Ignored while the sidebar is a drawer. */
65
+ collapsed?: boolean;
61
66
  className?: string;
67
+ /** Inline style of the root (for example `liquidStyle()` options). */
68
+ style?: CSSProperties;
69
+ /**
70
+ * Surface material. Omitted keeps the default for this layer (opaque, glass in the glass
71
+ * preset); `"glass"` and `"glass-clear"` are frosted glass, `"liquid"` and `"liquid-clear"`
72
+ * Liquid Glass, `"solid"` forces opaque. Liquid options go in `style` (`liquidStyle()` from
73
+ * `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
74
+ */
75
+ material?: Material;
62
76
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
63
77
  classNames?: ClassNames<SidebarPart>;
64
78
  }
@@ -81,7 +95,10 @@ export function Sidebar({
81
95
  renderLink = defaultRenderLink,
82
96
  open = false,
83
97
  onClose,
98
+ collapsed = false,
99
+ material,
84
100
  className,
101
+ style,
85
102
  classNames,
86
103
  }: SidebarProps) {
87
104
  const shell = useAppShell();
@@ -90,6 +107,7 @@ export function Sidebar({
90
107
  const isMobile = shell ? shell.compact : parentCompact;
91
108
  const closedOnMobile = isMobile && !open;
92
109
  const openOnMobile = isMobile && open;
110
+ const rail = collapsed && !isMobile;
93
111
 
94
112
  useEffect(() => {
95
113
  if (!openOnMobile) return;
@@ -113,7 +131,8 @@ export function Sidebar({
113
131
  aria-label={ariaLabel}
114
132
  inert={closedOnMobile || undefined}
115
133
  className={cn(
116
- "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",
134
+ "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",
135
+ rail ? "w-[4.5rem] px-2" : "w-side-width px-3",
117
136
  // Inside AppShell the container query decides before any script runs (no flash on a
118
137
  // narrow first paint); the measured state only drives inert, the scrim and focus.
119
138
  shell
@@ -126,9 +145,11 @@ export function Sidebar({
126
145
  closedOnMobile ? "-translate-x-full" : "translate-x-0",
127
146
  ),
128
147
  openOnMobile && "shadow-overlay",
148
+ materialClass(material, "surface-solid [--surface-solid:var(--surface)]"),
129
149
  classNames?.root,
130
150
  className,
131
151
  )}
152
+ style={style}
132
153
  >
133
154
  {header}
134
155
  {groups.map((group) => (
@@ -137,7 +158,13 @@ export function Sidebar({
137
158
  aria-label={group.label}
138
159
  className={cn("flex flex-col gap-px", classNames?.group)}
139
160
  >
140
- <div className={cn("px-2.5 pb-1.5 text-overline text-ink-3", classNames?.groupLabel)}>
161
+ <div
162
+ className={cn(
163
+ "px-2.5 pb-1.5 text-overline text-ink-3",
164
+ rail && "sr-only",
165
+ classNames?.groupLabel,
166
+ )}
167
+ >
141
168
  {group.label}
142
169
  </div>
143
170
  {group.items.map((item) => {
@@ -150,18 +177,37 @@ export function Sidebar({
150
177
  {renderLink({
151
178
  href: item.href,
152
179
  "aria-current": item.active ? "page" : undefined,
180
+ title: rail ? item.label : undefined,
153
181
  className: cn(
154
182
  "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",
183
+ rail && "relative justify-center in-data-[density=touch]:min-h-11",
155
184
  item.active && "bg-accent-soft font-bold text-accent-ink",
156
185
  classNames?.link,
157
186
  ),
158
187
  children: (
159
188
  <>
160
189
  {item.icon}
161
- <span className={cn("min-w-0 truncate", classNames?.label)}>
190
+ <span
191
+ className={cn("min-w-0 truncate", rail && "sr-only", classNames?.label)}
192
+ >
162
193
  {item.label}
163
194
  </span>
164
- {item.badge !== undefined ? (
195
+ {item.badge !== undefined && rail ? (
196
+ <>
197
+ <span
198
+ aria-hidden="true"
199
+ className={cn(
200
+ "absolute top-1 right-1 size-2 rounded-full ring-2 ring-surface",
201
+ item.badgeTone === "danger" ? "bg-danger" : "bg-accent",
202
+ classNames?.badge,
203
+ )}
204
+ />
205
+ <span className="sr-only">
206
+ {item.badge}
207
+ {item.badgeLabel ? ` ${item.badgeLabel}` : null}
208
+ </span>
209
+ </>
210
+ ) : item.badge !== undefined ? (
165
211
  <span
166
212
  className={cn(
167
213
  "ml-auto shrink-0 rounded-chip px-1.5 py-0.75 text-count",
@@ -1,9 +1,10 @@
1
1
  "use client";
2
2
 
3
- import { type ReactNode, type Ref, useEffect, useState } from "react";
3
+ import { type CSSProperties, type ReactNode, type Ref, useEffect, useState } from "react";
4
4
  import { Menu, Search } from "../../icons/index.js";
5
5
  import type { ClassNames } from "../../utils/class-names.js";
6
6
  import { cn } from "../../utils/cn.js";
7
+ import { type Material, materialClass } from "../../utils/material.js";
7
8
 
8
9
  function isApplePlatform(): boolean {
9
10
  if (typeof navigator === "undefined") return false;
@@ -23,24 +24,34 @@ export type TopbarPart =
23
24
  | "shortcut";
24
25
 
25
26
  export interface TopbarProps {
26
- /** Breadcrumb trail in order; the last entry is the current view. */
27
- breadcrumbs: string[];
27
+ /** Breadcrumb trail in order; the last entry is the current view. Nothing renders when absent or empty. */
28
+ breadcrumbs?: string[];
28
29
  /** Accessible name of the breadcrumb landmark. */
29
- breadcrumbsLabel: string;
30
+ breadcrumbsLabel?: string;
30
31
  /** 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. */
31
32
  onOpenMenu?: () => void;
32
33
  menuLabel?: string;
33
34
  /** Ref to the menu button so the opener can restore focus when the drawer closes. */
34
35
  menuButtonRef?: Ref<HTMLButtonElement>;
35
- /** Called by the search trigger and by Cmd/Ctrl+K. */
36
- onSearch: () => void;
37
- searchLabel: string;
38
- searchPlaceholder: string;
36
+ /** Called by the search trigger and by Cmd/Ctrl+K. The trigger and the shortcut are absent without it. */
37
+ onSearch?: () => void;
38
+ /** Accessible name of the search trigger; defaults to the placeholder. */
39
+ searchLabel?: string;
40
+ searchPlaceholder?: string;
39
41
  /** Slot between the search trigger and the end block (status, notifications, primary action). */
40
42
  actions?: ReactNode;
41
43
  /** Slot at the far end (e.g. the account menu). */
42
44
  end?: ReactNode;
43
45
  className?: string;
46
+ /** Inline style of the root (for example `liquidStyle()` options). */
47
+ style?: CSSProperties;
48
+ /**
49
+ * Surface material. Omitted keeps the default for this layer (opaque, glass in the glass
50
+ * preset); `"glass"` and `"glass-clear"` are frosted glass, `"liquid"` and `"liquid-clear"`
51
+ * Liquid Glass, `"solid"` forces opaque. Liquid options go in `style` (`liquidStyle()` from
52
+ * `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
53
+ */
54
+ material?: Material;
44
55
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
45
56
  classNames?: ClassNames<TopbarPart>;
46
57
  }
@@ -56,6 +67,8 @@ export function Topbar({
56
67
  searchPlaceholder,
57
68
  actions,
58
69
  end,
70
+ material,
71
+ style,
59
72
  className,
60
73
  classNames,
61
74
  }: TopbarProps) {
@@ -66,25 +79,29 @@ export function Topbar({
66
79
  }, []);
67
80
 
68
81
  useEffect(() => {
82
+ if (!onSearch) return;
69
83
  function onKeyDown(event: KeyboardEvent) {
70
84
  if (!(event.metaKey || event.ctrlKey) || event.key.toLowerCase() !== "k") return;
71
85
  event.preventDefault();
72
- onSearch();
86
+ onSearch?.();
73
87
  }
74
88
  window.addEventListener("keydown", onKeyDown);
75
89
  return () => window.removeEventListener("keydown", onKeyDown);
76
90
  }, [onSearch]);
77
91
 
78
- const current = breadcrumbs.at(-1);
79
- const previous = breadcrumbs.slice(0, -1);
92
+ const trail = breadcrumbs ?? [];
93
+ const current = trail.at(-1);
94
+ const previous = trail.slice(0, -1);
80
95
 
81
96
  return (
82
97
  <header
83
98
  className={cn(
84
- "@container/topbar sticky top-0 z-30 h-top-height border-b-divider bg-bg",
99
+ "@container/topbar sticky top-0 z-30 h-top-height border-b-divider surface-nav",
100
+ materialClass(material, "surface-solid [--surface-solid:var(--bg)]"),
85
101
  classNames?.root,
86
102
  className,
87
103
  )}
104
+ style={style}
88
105
  >
89
106
  <div
90
107
  className={cn(
@@ -107,57 +124,63 @@ export function Topbar({
107
124
  </button>
108
125
  ) : null}
109
126
 
110
- <nav
111
- aria-label={breadcrumbsLabel}
112
- className={cn(
113
- "flex min-w-0 shrink items-center gap-2 whitespace-nowrap text-ink-3 text-meta",
114
- classNames?.breadcrumbs,
115
- )}
116
- >
117
- {previous.map((crumb) => (
118
- <span
119
- key={crumb}
120
- className={cn(
121
- "flex items-center gap-2 @max-[560px]/topbar:hidden",
122
- classNames?.crumb,
123
- )}
124
- >
125
- <span>{crumb}</span>
126
- <span aria-hidden="true" className={cn("text-line-control", classNames?.separator)}>
127
- /
128
- </span>
129
- </span>
130
- ))}
131
- <strong
132
- aria-current="page"
133
- className={cn("min-w-0 truncate font-semibold text-ink", classNames?.current)}
127
+ {trail.length > 0 ? (
128
+ <nav
129
+ aria-label={breadcrumbsLabel}
130
+ className={cn(
131
+ "flex min-w-0 shrink items-center gap-2 whitespace-nowrap text-ink-3 text-meta",
132
+ classNames?.breadcrumbs,
133
+ )}
134
134
  >
135
- {current}
136
- </strong>
137
- </nav>
135
+ {previous.map((crumb) => (
136
+ <span
137
+ key={crumb}
138
+ className={cn(
139
+ "flex items-center gap-2 @max-[560px]/topbar:hidden",
140
+ classNames?.crumb,
141
+ )}
142
+ >
143
+ <span>{crumb}</span>
144
+ <span aria-hidden="true" className={cn("text-line-control", classNames?.separator)}>
145
+ /
146
+ </span>
147
+ </span>
148
+ ))}
149
+ <strong
150
+ aria-current="page"
151
+ className={cn("min-w-0 truncate font-semibold text-ink", classNames?.current)}
152
+ >
153
+ {current}
154
+ </strong>
155
+ </nav>
156
+ ) : null}
138
157
 
139
- <button
140
- type="button"
141
- aria-label={searchLabel}
142
- onClick={onSearch}
143
- className={cn(
144
- "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",
145
- classNames?.search,
146
- )}
147
- >
148
- <Search className="size-4 shrink-0" aria-hidden="true" />
149
- <span className={cn("truncate @max-[700px]/topbar:hidden", classNames?.searchText)}>
150
- {searchPlaceholder}
151
- </span>
152
- <span
158
+ {onSearch ? (
159
+ <button
160
+ type="button"
161
+ aria-label={searchLabel ?? searchPlaceholder}
162
+ onClick={onSearch}
153
163
  className={cn(
154
- "ml-auto rounded-xs border-divider bg-surface-2 px-1.25 py-0.5 font-mono text-count text-ink-2 @max-[700px]/topbar:hidden",
155
- classNames?.shortcut,
164
+ "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",
165
+ classNames?.search,
156
166
  )}
157
167
  >
158
- {shortcut}
159
- </span>
160
- </button>
168
+ <Search className="size-4 shrink-0" aria-hidden="true" />
169
+ <span className={cn("truncate @max-[700px]/topbar:hidden", classNames?.searchText)}>
170
+ {searchPlaceholder}
171
+ </span>
172
+ <span
173
+ className={cn(
174
+ "ml-auto rounded-xs border-divider bg-surface-2 px-1.25 py-0.5 font-mono text-count text-ink-2 @max-[700px]/topbar:hidden",
175
+ classNames?.shortcut,
176
+ )}
177
+ >
178
+ {shortcut}
179
+ </span>
180
+ </button>
181
+ ) : (
182
+ <span aria-hidden="true" className="ml-auto" />
183
+ )}
161
184
 
162
185
  {actions}
163
186
  {end}
@@ -8,14 +8,24 @@ export interface EmptyStateProps {
8
8
  description?: ReactNode;
9
9
  /** Primary call to action. */
10
10
  action?: ReactNode;
11
+ /** `outlined` draws a dashed border around the state. */
12
+ variant?: "plain" | "outlined";
11
13
  className?: string;
12
14
  }
13
15
 
14
- export function EmptyState({ icon, title, description, action, className }: EmptyStateProps) {
16
+ export function EmptyState({
17
+ icon,
18
+ title,
19
+ description,
20
+ action,
21
+ variant = "plain",
22
+ className,
23
+ }: EmptyStateProps) {
15
24
  return (
16
25
  <div
17
26
  className={cn(
18
27
  "@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",
28
+ variant === "outlined" && "rounded-card border border-line-control border-dashed",
19
29
  className,
20
30
  )}
21
31
  >