basalt-ui 1.24.0 → 1.26.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 (467) hide show
  1. package/AGENTS.md +8 -6
  2. package/CHANGELOG.md +25 -0
  3. package/MIGRATING.md +547 -21
  4. package/README.md +46 -33
  5. package/agent/rules/basalt-batteries.md +205 -0
  6. package/agent/rules/basalt-charts.md +125 -555
  7. package/agent/rules/basalt-controls.md +155 -0
  8. package/agent/rules/basalt-mantine.md +146 -439
  9. package/agent/rules/basalt-state.md +113 -96
  10. package/agent/rules/basalt-tokens.md +126 -288
  11. package/agent/skills/basalt-app/SKILL.md +70 -195
  12. package/agent/skills/basalt-charts/SKILL.md +54 -234
  13. package/agent/skills/basalt-design/SKILL.md +56 -248
  14. package/agent/templates/CLAUDE-block.md.tpl +31 -40
  15. package/agent/templates/DESIGN.md.tpl +22 -51
  16. package/configs/oxlint-plugin.js +1275 -31
  17. package/configs/oxlint-plugin.test.ts +947 -11
  18. package/configs/oxlint.json +11 -3
  19. package/dist/charts/cursor/resolve.d.ts +18 -0
  20. package/dist/charts/cursor/resolve.d.ts.map +1 -1
  21. package/dist/charts/cursor/resolve.js +15 -6
  22. package/dist/charts/cursor/scope.d.ts +6 -3
  23. package/dist/charts/cursor/scope.d.ts.map +1 -1
  24. package/dist/charts/cursor/store.d.ts +5 -1
  25. package/dist/charts/cursor/store.d.ts.map +1 -1
  26. package/dist/charts/cursor/store.js +4 -4
  27. package/dist/charts/hooks/useChartCursor.d.ts.map +1 -1
  28. package/dist/charts/hooks/useChartCursor.js +9 -8
  29. package/dist/charts/index.d.ts +2 -2
  30. package/dist/charts/index.d.ts.map +1 -1
  31. package/dist/charts/primitives/ChartCard.d.ts +34 -9
  32. package/dist/charts/primitives/ChartCard.d.ts.map +1 -1
  33. package/dist/charts/primitives/ChartCard.js +29 -114
  34. package/dist/charts/primitives/ChartCard.test.d.ts +2 -0
  35. package/dist/charts/primitives/ChartCard.test.d.ts.map +1 -0
  36. package/dist/charts/sparklines/BarSparkline.d.ts +26 -2
  37. package/dist/charts/sparklines/BarSparkline.d.ts.map +1 -1
  38. package/dist/charts/sparklines/BarSparkline.js +18 -4
  39. package/dist/cli/check-coverage.test.d.ts +2 -0
  40. package/dist/cli/check-coverage.test.d.ts.map +1 -0
  41. package/dist/cli/index.d.ts +67 -4
  42. package/dist/cli/index.d.ts.map +1 -1
  43. package/dist/cli/index.js +225 -7
  44. package/dist/connectivity/connectivity-indicator.d.ts +4 -1
  45. package/dist/connectivity/connectivity-indicator.d.ts.map +1 -1
  46. package/dist/connectivity/connectivity-indicator.js +1 -1
  47. package/dist/content/index.d.ts +5 -3
  48. package/dist/content/index.d.ts.map +1 -1
  49. package/dist/content/index.js +4 -2
  50. package/dist/content/prose.module.css +7 -28
  51. package/dist/controls/actions.d.ts +169 -0
  52. package/dist/controls/actions.d.ts.map +1 -0
  53. package/dist/controls/actions.js +287 -0
  54. package/dist/controls/actions.module.css +62 -0
  55. package/dist/controls/actions.module.css.d.ts +13 -0
  56. package/dist/controls/actions.test.d.ts +2 -0
  57. package/dist/controls/actions.test.d.ts.map +1 -0
  58. package/dist/controls/actions.type-guard.test.d.ts +2 -0
  59. package/dist/controls/actions.type-guard.test.d.ts.map +1 -0
  60. package/dist/controls/compare-filter.d.ts +41 -0
  61. package/dist/controls/compare-filter.d.ts.map +1 -0
  62. package/dist/controls/compare-filter.js +23 -0
  63. package/dist/controls/control-group.d.ts +19 -0
  64. package/dist/controls/control-group.d.ts.map +1 -0
  65. package/dist/controls/control-group.js +20 -0
  66. package/dist/controls/control-group.test.d.ts +2 -0
  67. package/dist/controls/control-group.test.d.ts.map +1 -0
  68. package/dist/controls/controls.module.css +542 -0
  69. package/dist/controls/controls.module.css.d.ts +35 -0
  70. package/dist/controls/controls.router.test.d.ts +2 -0
  71. package/dist/controls/controls.router.test.d.ts.map +1 -0
  72. package/dist/controls/enum-filter.d.ts +30 -0
  73. package/dist/controls/enum-filter.d.ts.map +1 -0
  74. package/dist/controls/enum-filter.js +91 -0
  75. package/dist/controls/filter-context.d.ts +55 -0
  76. package/dist/controls/filter-context.d.ts.map +1 -0
  77. package/dist/controls/filter-context.js +69 -0
  78. package/dist/controls/filter-pill.d.ts +28 -0
  79. package/dist/controls/filter-pill.d.ts.map +1 -0
  80. package/dist/controls/filter-pill.js +70 -0
  81. package/dist/controls/filter-set.d.ts +13 -0
  82. package/dist/controls/filter-set.d.ts.map +1 -0
  83. package/dist/controls/filter-set.js +125 -0
  84. package/dist/controls/filter-set.test.d.ts +2 -0
  85. package/dist/controls/filter-set.test.d.ts.map +1 -0
  86. package/dist/controls/filter-sheet.d.ts +117 -0
  87. package/dist/controls/filter-sheet.d.ts.map +1 -0
  88. package/dist/controls/filter-sheet.js +146 -0
  89. package/dist/controls/glyphs.d.ts +27 -0
  90. package/dist/controls/glyphs.d.ts.map +1 -0
  91. package/dist/controls/glyphs.js +49 -0
  92. package/dist/controls/index.d.ts +19 -0
  93. package/dist/controls/index.d.ts.map +1 -0
  94. package/dist/controls/index.js +44 -0
  95. package/dist/controls/multi-select-filter.d.ts +23 -0
  96. package/dist/controls/multi-select-filter.d.ts.map +1 -0
  97. package/dist/controls/multi-select-filter.js +89 -0
  98. package/dist/controls/peer-boundary.test.d.ts +2 -0
  99. package/dist/controls/peer-boundary.test.d.ts.map +1 -0
  100. package/dist/controls/props-contract.test.d.ts +2 -0
  101. package/dist/controls/props-contract.test.d.ts.map +1 -0
  102. package/dist/controls/range-filter.d.ts +29 -0
  103. package/dist/controls/range-filter.d.ts.map +1 -0
  104. package/dist/controls/range-filter.js +120 -0
  105. package/dist/controls/search-filter.d.ts +10 -0
  106. package/dist/controls/search-filter.d.ts.map +1 -0
  107. package/dist/controls/search-filter.js +81 -0
  108. package/dist/controls/select-filter.d.ts +74 -0
  109. package/dist/controls/select-filter.d.ts.map +1 -0
  110. package/dist/controls/select-filter.js +10 -0
  111. package/dist/controls/sync-button.d.ts +38 -0
  112. package/dist/controls/sync-button.d.ts.map +1 -0
  113. package/dist/controls/sync-button.js +119 -0
  114. package/dist/controls/sync-button.module.css +63 -0
  115. package/dist/controls/sync-button.module.css.d.ts +11 -0
  116. package/dist/controls/sync-button.test.d.ts +2 -0
  117. package/dist/controls/sync-button.test.d.ts.map +1 -0
  118. package/dist/controls/toggle-filter.d.ts +9 -0
  119. package/dist/controls/toggle-filter.d.ts.map +1 -0
  120. package/dist/controls/toggle-filter.js +42 -0
  121. package/dist/controls/view-tabs.d.ts +23 -0
  122. package/dist/controls/view-tabs.d.ts.map +1 -0
  123. package/dist/controls/view-tabs.js +59 -0
  124. package/dist/controls-dates/date-range-picker.d.ts +4 -0
  125. package/dist/controls-dates/date-range-picker.d.ts.map +1 -0
  126. package/dist/controls-dates/date-range-picker.js +18 -0
  127. package/dist/controls-dates/index.d.ts +9 -0
  128. package/dist/controls-dates/index.d.ts.map +1 -0
  129. package/dist/controls-dates/index.js +4 -0
  130. package/dist/dashboard/delta-badge.d.ts +6 -12
  131. package/dist/dashboard/delta-badge.d.ts.map +1 -1
  132. package/dist/dashboard/delta-badge.js +1 -50
  133. package/dist/dashboard/query-state.d.ts +1 -1
  134. package/dist/dashboard/settings-section.d.ts +6 -4
  135. package/dist/dashboard/settings-section.d.ts.map +1 -1
  136. package/dist/dashboard/settings-section.js +23 -16
  137. package/dist/dashboard/settings-section.module.css +10 -0
  138. package/dist/dashboard/settings-section.module.css.d.ts +1 -0
  139. package/dist/dashboard/settings-section.test.d.ts +2 -0
  140. package/dist/dashboard/settings-section.test.d.ts.map +1 -0
  141. package/dist/dashboard/stat-card.d.ts +44 -9
  142. package/dist/dashboard/stat-card.d.ts.map +1 -1
  143. package/dist/dashboard/stat-card.js +80 -48
  144. package/dist/dashboard/stat-card.module.css +82 -0
  145. package/dist/dashboard/stat-card.module.css.d.ts +11 -0
  146. package/dist/data/data-table.d.ts +102 -20
  147. package/dist/data/data-table.d.ts.map +1 -1
  148. package/dist/data/data-table.js +166 -65
  149. package/dist/data/table.d.ts +1 -1
  150. package/dist/data/table.d.ts.map +1 -1
  151. package/dist/guard/grace.test.d.ts +20 -0
  152. package/dist/guard/grace.test.d.ts.map +1 -0
  153. package/dist/guard/index.d.ts +66 -3
  154. package/dist/guard/index.d.ts.map +1 -1
  155. package/dist/guard/index.js +82 -7
  156. package/dist/guard/types.d.ts +3 -3
  157. package/dist/guard/types.d.ts.map +1 -1
  158. package/dist/index.d.ts +12 -2
  159. package/dist/index.d.ts.map +1 -1
  160. package/dist/index.js +13 -10
  161. package/dist/nav/types.d.ts +78 -2
  162. package/dist/nav/types.d.ts.map +1 -1
  163. package/dist/notifications/bell.d.ts +4 -1
  164. package/dist/notifications/bell.d.ts.map +1 -1
  165. package/dist/notifications/index.d.ts +1 -1
  166. package/dist/router-tanstack/field.d.ts +14 -0
  167. package/dist/router-tanstack/field.d.ts.map +1 -0
  168. package/dist/router-tanstack/field.js +4 -0
  169. package/dist/router-tanstack/index.d.ts +6 -2
  170. package/dist/router-tanstack/index.d.ts.map +1 -1
  171. package/dist/router-tanstack/index.js +4 -0
  172. package/dist/router-tanstack/multi-search-param-store.d.ts +4 -52
  173. package/dist/router-tanstack/multi-search-param-store.d.ts.map +1 -1
  174. package/dist/router-tanstack/multi-search-param-store.js +19 -27
  175. package/dist/router-tanstack/search-param-store.d.ts +3 -87
  176. package/dist/router-tanstack/search-param-store.d.ts.map +1 -1
  177. package/dist/router-tanstack/search-param-store.js +16 -45
  178. package/dist/router-tanstack/search-store.d.ts +81 -0
  179. package/dist/router-tanstack/search-store.d.ts.map +1 -0
  180. package/dist/router-tanstack/search-store.js +187 -0
  181. package/dist/router-tanstack/search-store.router.test.d.ts +2 -0
  182. package/dist/router-tanstack/search-store.router.test.d.ts.map +1 -0
  183. package/dist/router-tanstack/search-store.test.d.ts +2 -0
  184. package/dist/router-tanstack/search-store.test.d.ts.map +1 -0
  185. package/dist/router-tanstack/use-nav.d.ts +0 -2
  186. package/dist/router-tanstack/use-nav.d.ts.map +1 -1
  187. package/dist/router-tanstack/use-nav.js +34 -12
  188. package/dist/router-tanstack/use-nav.test.d.ts +2 -0
  189. package/dist/router-tanstack/use-nav.test.d.ts.map +1 -0
  190. package/dist/section/index.d.ts +2 -0
  191. package/dist/section/index.d.ts.map +1 -0
  192. package/dist/section/index.js +4 -0
  193. package/dist/section/section.d.ts +24 -0
  194. package/dist/section/section.d.ts.map +1 -0
  195. package/dist/section/section.js +126 -0
  196. package/dist/section/section.module.css +104 -0
  197. package/dist/section/section.module.css.d.ts +11 -0
  198. package/dist/section/section.test.d.ts +2 -0
  199. package/dist/section/section.test.d.ts.map +1 -0
  200. package/dist/shell/app-breadcrumbs.d.ts.map +1 -1
  201. package/dist/shell/app-breadcrumbs.js +18 -15
  202. package/dist/shell/app-header.module.css +77 -37
  203. package/dist/shell/app-header.module.css.d.ts +2 -1
  204. package/dist/shell/app-mobile-nav.d.ts +9 -2
  205. package/dist/shell/app-mobile-nav.d.ts.map +1 -1
  206. package/dist/shell/app-mobile-nav.js +98 -11
  207. package/dist/shell/app-mobile-nav.module.css +8 -0
  208. package/dist/shell/app-mobile-nav.module.css.d.ts +1 -0
  209. package/dist/shell/app-sidebar.d.ts +55 -28
  210. package/dist/shell/app-sidebar.d.ts.map +1 -1
  211. package/dist/shell/app-sidebar.js +116 -67
  212. package/dist/shell/app-sidebar.module.css +303 -20
  213. package/dist/shell/app-sidebar.module.css.d.ts +19 -1
  214. package/dist/shell/index.d.ts +55 -21
  215. package/dist/shell/index.d.ts.map +1 -1
  216. package/dist/shell/index.js +40 -18
  217. package/dist/shell/mobile-nav-model.d.ts +13 -2
  218. package/dist/shell/mobile-nav-model.d.ts.map +1 -1
  219. package/dist/shell/mobile-nav-model.js +15 -1
  220. package/dist/shell/nav-count-badge.d.ts +1 -1
  221. package/dist/shell/page-bar.d.ts +51 -0
  222. package/dist/shell/page-bar.d.ts.map +1 -0
  223. package/dist/shell/page-bar.js +154 -0
  224. package/dist/shell/page-bar.module.css +178 -0
  225. package/dist/shell/page-bar.module.css.d.ts +17 -0
  226. package/dist/shell/page-bar.test.d.ts +2 -0
  227. package/dist/shell/page-bar.test.d.ts.map +1 -0
  228. package/dist/shell/sidebar-block-model.d.ts +48 -0
  229. package/dist/shell/sidebar-block-model.d.ts.map +1 -0
  230. package/dist/shell/sidebar-block-model.js +39 -0
  231. package/dist/shell/sidebar-blocks.d.ts +32 -0
  232. package/dist/shell/sidebar-blocks.d.ts.map +1 -0
  233. package/dist/shell/sidebar-blocks.js +169 -0
  234. package/dist/shell/sidebar-search.d.ts +13 -1
  235. package/dist/shell/sidebar-search.d.ts.map +1 -1
  236. package/dist/shell/sidebar-search.js +34 -1
  237. package/dist/shell/sidebar-search.module.css +26 -0
  238. package/dist/shell/sidebar-search.module.css.d.ts +2 -0
  239. package/dist/state/fields.d.ts +392 -0
  240. package/dist/state/fields.d.ts.map +1 -0
  241. package/dist/state/fields.js +369 -0
  242. package/dist/state/fields.test.d.ts +2 -0
  243. package/dist/state/fields.test.d.ts.map +1 -0
  244. package/dist/state/persisted.d.ts +48 -0
  245. package/dist/state/persisted.d.ts.map +1 -0
  246. package/dist/state/persisted.js +105 -0
  247. package/dist/state.d.ts +11 -56
  248. package/dist/state.d.ts.map +1 -1
  249. package/dist/state.js +14 -120
  250. package/dist/styles.css +13 -0
  251. package/dist/surfaces.d.ts +106 -24
  252. package/dist/surfaces.d.ts.map +1 -1
  253. package/dist/surfaces.js +155 -19
  254. package/dist/theme/controls.module.css +16 -1
  255. package/dist/theme/ctl-theme.d.ts +32 -0
  256. package/dist/theme/ctl-theme.d.ts.map +1 -0
  257. package/dist/theme/ctl-theme.js +54 -0
  258. package/dist/theme/ctl-theme.test.d.ts +2 -0
  259. package/dist/theme/ctl-theme.test.d.ts.map +1 -0
  260. package/dist/theme/ctl-tier-coverage.test.d.ts +2 -0
  261. package/dist/theme/ctl-tier-coverage.test.d.ts.map +1 -0
  262. package/dist/theme/divider-law.test.d.ts +2 -0
  263. package/dist/theme/divider-law.test.d.ts.map +1 -0
  264. package/dist/theme/icon-slot.d.ts +44 -0
  265. package/dist/theme/icon-slot.d.ts.map +1 -0
  266. package/dist/theme/icon-slot.js +21 -0
  267. package/dist/theme/icon-slot.module.css +47 -0
  268. package/dist/theme/icon-slot.module.css.d.ts +8 -0
  269. package/dist/theme/icon-slot.test.d.ts +2 -0
  270. package/dist/theme/icon-slot.test.d.ts.map +1 -0
  271. package/dist/theme/index.d.ts +1 -0
  272. package/dist/theme/index.d.ts.map +1 -1
  273. package/dist/theme/index.js +82 -5
  274. package/dist/theme/layout-rhythm-css.test.d.ts +2 -0
  275. package/dist/theme/layout-rhythm-css.test.d.ts.map +1 -0
  276. package/dist/theme/segmented-control.module.css +20 -0
  277. package/dist/theme/shadow-surfaces.test.d.ts.map +1 -1
  278. package/dist/tokens/index.d.ts +12 -0
  279. package/dist/tokens/index.d.ts.map +1 -1
  280. package/dist/tokens/index.js +38 -8
  281. package/dist/tokens/palette.d.ts +97 -61
  282. package/dist/tokens/palette.d.ts.map +1 -1
  283. package/dist/tokens/palette.js +76 -38
  284. package/dist/tokens.css +10 -2
  285. package/dist/widget-header/delta-badge.d.ts +13 -0
  286. package/dist/widget-header/delta-badge.d.ts.map +1 -0
  287. package/dist/widget-header/delta-badge.js +29 -0
  288. package/dist/widget-header/delta-badge.test.d.ts +2 -0
  289. package/dist/widget-header/delta-badge.test.d.ts.map +1 -0
  290. package/dist/widget-header/index.d.ts +3 -0
  291. package/dist/widget-header/index.d.ts.map +1 -0
  292. package/dist/widget-header/index.js +6 -0
  293. package/dist/widget-header/no-mantine.test.d.ts +2 -0
  294. package/dist/widget-header/no-mantine.test.d.ts.map +1 -0
  295. package/dist/widget-header/widget-header.d.ts +37 -0
  296. package/dist/widget-header/widget-header.d.ts.map +1 -0
  297. package/dist/widget-header/widget-header.js +77 -0
  298. package/dist/widget-header/widget-header.module.css +335 -0
  299. package/dist/widget-header/widget-header.module.css.d.ts +24 -0
  300. package/dist/widget-header/widget-header.test.d.ts +2 -0
  301. package/dist/widget-header/widget-header.test.d.ts.map +1 -0
  302. package/llms.txt +30 -17
  303. package/package.json +14 -1
  304. package/src/charts/cursor/resolve.test.ts +29 -1
  305. package/src/charts/cursor/resolve.ts +38 -6
  306. package/src/charts/cursor/scope.tsx +6 -3
  307. package/src/charts/cursor/store.test.ts +19 -1
  308. package/src/charts/cursor/store.ts +10 -5
  309. package/src/charts/hooks/useChartCursor.ts +16 -8
  310. package/src/charts/index.ts +2 -2
  311. package/src/charts/primitives/CartesianChart.test.tsx +124 -0
  312. package/src/charts/primitives/ChartCard.test.tsx +66 -0
  313. package/src/charts/primitives/ChartCard.tsx +86 -146
  314. package/src/charts/sparklines/BarSparkline.tsx +43 -5
  315. package/src/cli/check-coverage.test.ts +297 -0
  316. package/src/cli/check-theme.test.ts +38 -14
  317. package/src/cli/index.ts +392 -16
  318. package/src/cli/init-sync.test.ts +97 -0
  319. package/src/connectivity/connectivity-indicator.tsx +16 -9
  320. package/src/content/index.ts +16 -3
  321. package/src/content/prose.module.css +7 -28
  322. package/src/content/prose.module.css.test.ts +8 -24
  323. package/src/controls/actions.module.css +62 -0
  324. package/src/controls/actions.module.css.d.ts +13 -0
  325. package/src/controls/actions.test.tsx +252 -0
  326. package/src/controls/actions.tsx +655 -0
  327. package/src/controls/actions.type-guard.test.ts +63 -0
  328. package/src/controls/compare-filter.tsx +64 -0
  329. package/src/controls/control-group.test.tsx +229 -0
  330. package/src/controls/control-group.tsx +63 -0
  331. package/src/controls/controls.module.css +542 -0
  332. package/src/controls/controls.module.css.d.ts +35 -0
  333. package/src/controls/controls.router.test.tsx +637 -0
  334. package/src/controls/enum-filter.tsx +159 -0
  335. package/src/controls/filter-context.tsx +153 -0
  336. package/src/controls/filter-pill.tsx +120 -0
  337. package/src/controls/filter-set.test.tsx +472 -0
  338. package/src/controls/filter-set.tsx +225 -0
  339. package/src/controls/filter-sheet.tsx +285 -0
  340. package/src/controls/glyphs.tsx +81 -0
  341. package/src/controls/index.ts +48 -0
  342. package/src/controls/multi-select-filter.tsx +140 -0
  343. package/src/controls/peer-boundary.test.ts +85 -0
  344. package/src/controls/props-contract.test.tsx +106 -0
  345. package/src/controls/range-filter.tsx +184 -0
  346. package/src/controls/search-filter.tsx +123 -0
  347. package/src/controls/select-filter.tsx +89 -0
  348. package/src/controls/sync-button.module.css +63 -0
  349. package/src/controls/sync-button.module.css.d.ts +11 -0
  350. package/src/controls/sync-button.test.tsx +183 -0
  351. package/src/controls/sync-button.tsx +197 -0
  352. package/src/controls/toggle-filter.tsx +60 -0
  353. package/src/controls/view-tabs.tsx +110 -0
  354. package/src/controls-dates/date-range-picker.tsx +42 -0
  355. package/src/controls-dates/index.ts +8 -0
  356. package/src/dashboard/delta-badge.tsx +4 -74
  357. package/src/dashboard/query-state.tsx +1 -1
  358. package/src/dashboard/settings-section.module.css +10 -0
  359. package/src/dashboard/settings-section.module.css.d.ts +1 -0
  360. package/src/dashboard/settings-section.test.tsx +56 -0
  361. package/src/dashboard/settings-section.tsx +33 -30
  362. package/src/dashboard/stat-card.module.css +82 -0
  363. package/src/dashboard/stat-card.module.css.d.ts +11 -0
  364. package/src/dashboard/stat-card.test.tsx +67 -1
  365. package/src/dashboard/stat-card.tsx +209 -68
  366. package/src/data/data-table.test.tsx +282 -6
  367. package/src/data/data-table.tsx +429 -94
  368. package/src/data/table.ts +2 -0
  369. package/src/guard/check-source.test.ts +126 -13
  370. package/src/guard/grace.test.ts +149 -0
  371. package/src/guard/index.ts +172 -29
  372. package/src/guard/types.ts +4 -2
  373. package/src/index.ts +46 -5
  374. package/src/nav/types.ts +84 -2
  375. package/src/notifications/bell.tsx +6 -3
  376. package/src/notifications/index.ts +1 -1
  377. package/src/router-tanstack/field.ts +31 -0
  378. package/src/router-tanstack/index.ts +24 -2
  379. package/src/router-tanstack/multi-search-param-store.test.ts +71 -3
  380. package/src/router-tanstack/multi-search-param-store.ts +46 -77
  381. package/src/router-tanstack/search-param-store.ts +42 -159
  382. package/src/router-tanstack/search-store.router.test.tsx +661 -0
  383. package/src/router-tanstack/search-store.test.ts +418 -0
  384. package/src/router-tanstack/search-store.ts +380 -0
  385. package/src/router-tanstack/use-nav.test.tsx +187 -0
  386. package/src/router-tanstack/use-nav.ts +72 -14
  387. package/src/section/index.ts +1 -0
  388. package/src/section/section.module.css +104 -0
  389. package/src/section/section.module.css.d.ts +11 -0
  390. package/src/section/section.test.tsx +204 -0
  391. package/src/section/section.tsx +220 -0
  392. package/src/shell/app-breadcrumbs.tsx +44 -31
  393. package/src/shell/app-header.module.css +77 -37
  394. package/src/shell/app-header.module.css.d.ts +2 -1
  395. package/src/shell/app-mobile-nav.module.css +8 -0
  396. package/src/shell/app-mobile-nav.module.css.d.ts +1 -0
  397. package/src/shell/app-mobile-nav.tsx +147 -8
  398. package/src/shell/app-sidebar-account.tsx +2 -2
  399. package/src/shell/app-sidebar.module.css +303 -20
  400. package/src/shell/app-sidebar.module.css.d.ts +19 -1
  401. package/src/shell/app-sidebar.test.tsx +456 -41
  402. package/src/shell/app-sidebar.tsx +276 -140
  403. package/src/shell/index.test.tsx +291 -5
  404. package/src/shell/index.tsx +137 -38
  405. package/src/shell/mobile-nav-model.test.ts +228 -7
  406. package/src/shell/mobile-nav-model.ts +53 -3
  407. package/src/shell/nav-count-badge.tsx +1 -1
  408. package/src/shell/page-bar.module.css +178 -0
  409. package/src/shell/page-bar.module.css.d.ts +17 -0
  410. package/src/shell/page-bar.test.tsx +316 -0
  411. package/src/shell/page-bar.tsx +315 -0
  412. package/src/shell/sidebar-block-model.ts +83 -0
  413. package/src/shell/sidebar-blocks.tsx +301 -0
  414. package/src/shell/sidebar-search.module.css +26 -0
  415. package/src/shell/sidebar-search.module.css.d.ts +2 -0
  416. package/src/shell/sidebar-search.tsx +71 -2
  417. package/src/state/fields.test.tsx +258 -0
  418. package/src/state/fields.ts +892 -0
  419. package/src/state/persisted.ts +211 -0
  420. package/src/state.ts +46 -240
  421. package/src/styles.css +13 -0
  422. package/src/surfaces.ts +203 -36
  423. package/src/theme/controls.module.css +16 -1
  424. package/src/theme/ctl-theme.test.tsx +275 -0
  425. package/src/theme/ctl-theme.tsx +138 -0
  426. package/src/theme/ctl-tier-coverage.test.ts +170 -0
  427. package/src/theme/density-relations.test.ts +106 -51
  428. package/src/theme/divider-law.test.ts +259 -0
  429. package/src/theme/icon-slot.module.css +47 -0
  430. package/src/theme/icon-slot.module.css.d.ts +8 -0
  431. package/src/theme/icon-slot.test.tsx +275 -0
  432. package/src/theme/icon-slot.tsx +59 -0
  433. package/src/theme/index.ts +165 -3
  434. package/src/theme/layout-rhythm-css.test.ts +72 -0
  435. package/src/theme/radius.test.ts +11 -1
  436. package/src/theme/segmented-control.module.css +20 -0
  437. package/src/theme/shadow-surfaces.test.ts +20 -7
  438. package/src/theme/spacing.test.ts +75 -27
  439. package/src/theme/use-basalt-spacing.ts +2 -2
  440. package/src/tokens/density.test.ts +7 -25
  441. package/src/tokens/index.ts +48 -8
  442. package/src/tokens/palette.ts +107 -73
  443. package/src/widget-header/delta-badge.test.tsx +60 -0
  444. package/src/widget-header/delta-badge.tsx +57 -0
  445. package/src/widget-header/index.ts +2 -0
  446. package/src/widget-header/no-mantine.test.ts +33 -0
  447. package/src/widget-header/widget-header.module.css +335 -0
  448. package/src/widget-header/widget-header.module.css.d.ts +24 -0
  449. package/src/widget-header/widget-header.test.tsx +187 -0
  450. package/src/widget-header/widget-header.tsx +168 -0
  451. package/agent/rules/basalt-agent.md +0 -452
  452. package/agent/rules/basalt-app.md +0 -246
  453. package/agent/rules/basalt-commands.md +0 -320
  454. package/agent/rules/basalt-content.md +0 -409
  455. package/agent/rules/basalt-data.md +0 -269
  456. package/agent/rules/basalt-forms.md +0 -186
  457. package/agent/rules/basalt-notifications.md +0 -264
  458. package/agent/rules/basalt-query.md +0 -187
  459. package/agent/rules/basalt-router.md +0 -336
  460. package/dist/content/article-filter-bar.d.ts +0 -40
  461. package/dist/content/article-filter-bar.d.ts.map +0 -1
  462. package/dist/content/article-filter-bar.js +0 -56
  463. package/dist/shell/page-header.d.ts +0 -13
  464. package/dist/shell/page-header.d.ts.map +0 -1
  465. package/dist/shell/page-header.js +0 -23
  466. package/src/content/article-filter-bar.tsx +0 -88
  467. package/src/shell/page-header.tsx +0 -35
@@ -25,11 +25,17 @@ import type {
25
25
  MobileNavGroup,
26
26
  MobileNavModel,
27
27
  MobileNavSlot,
28
+ SidebarBlock,
29
+ SidebarBlockItem,
28
30
  SidebarItem,
31
+ SidebarListBlock,
32
+ SidebarProgressBlock,
29
33
  } from '../nav/types'
30
34
  import type { BasaltAccountProps } from './account-types'
31
35
  import type { SettingsMenuItem } from './index'
32
36
  import { NavCountBadge } from './nav-count-badge'
37
+ import { SidebarBlockToneDot } from './sidebar-blocks'
38
+ import { sidebarBlockMobile } from './sidebar-block-model'
33
39
  import { useBasaltSpacing } from '../theme'
34
40
  import classes from './app-mobile-nav.module.css'
35
41
 
@@ -54,6 +60,13 @@ export type MobileNavProps = {
54
60
  * deletable: everything it used to hold is reachable from More. */
55
61
  account?: BasaltAccountProps | undefined
56
62
  settingsMenuItems?: SettingsMenuItem[] | undefined
63
+ /**
64
+ * The sidebar's blocks, projected. A block with `mobile: 'more'` becomes ONE row in the More
65
+ * surface (`Awaiting action · 3`) that opens a nested 44px-row sheet of its items — the sidebar
66
+ * itself does not exist below `sm`, so this is the only way its blocks are reachable at all.
67
+ * Counted for the menu-vs-sheet threshold by `blockRowCount`, never re-counted here.
68
+ */
69
+ blocks?: SidebarBlock[] | undefined
57
70
  }
58
71
 
59
72
  /** Inline "More" glyph — keeps the shell icon-dependency-free. */
@@ -237,10 +250,13 @@ export function MobileNav({
237
250
  config,
238
251
  account,
239
252
  settingsMenuItems,
253
+ blocks,
240
254
  }: MobileNavProps): ReactElement {
241
- // `openKey` is the ONLY state here, and it is keyed by slot rather than holding a slot object:
242
- // `sections` identity churning on every consumer render must not close an open menu.
255
+ // `openKey` is the ONLY slot state here, and it is keyed by slot rather than holding a slot
256
+ // object: `sections` identity churning on every consumer render must not close an open menu.
243
257
  const [openKey, setOpenKey] = useState<string | null>(null)
258
+ // The nested block sheet, keyed the same way and for the same reason.
259
+ const [openBlockKey, setOpenBlockKey] = useState<string | null>(null)
244
260
  // `DEFAULT_THEME.respectReducedMotion` is false in Mantine 9.3 and `createBasaltTheme` does not
245
261
  // set it, so the preference has to be read explicitly at the call site.
246
262
  const reduceMotion = useReducedMotion()
@@ -257,6 +273,86 @@ export function MobileNav({
257
273
 
258
274
  const extraRows = [...accountRows(account), ...settingsRows(settingsMenuItems)]
259
275
 
276
+ /**
277
+ * The blocks that reach More, in sidebar order and with the same emptiness rule `blockRowCount`
278
+ * applies — the count that picked `menu` vs `sheet` and the rows that render must agree.
279
+ */
280
+ const moreBlocks = (blocks ?? []).filter(
281
+ (block): block is SidebarListBlock | SidebarProgressBlock =>
282
+ block.kind !== 'custom' &&
283
+ sidebarBlockMobile(block) === 'more' &&
284
+ (block.kind !== 'list' || block.items.length > 0),
285
+ )
286
+ const listBlocks = moreBlocks.filter((block): block is SidebarListBlock => block.kind === 'list')
287
+
288
+ /** A list block raises its nested sheet; a progress block just fires its own handler. */
289
+ const activateBlock = (block: (typeof moreBlocks)[number]) => {
290
+ close()
291
+ if (block.kind === 'list') {
292
+ setOpenBlockKey(block.key)
293
+ return
294
+ }
295
+ block.onClick?.()
296
+ }
297
+
298
+ const menuBlockRow = (block: (typeof moreBlocks)[number]) => (
299
+ <Menu.Item key={block.key} className={classes.menuItem} onClick={() => activateBlock(block)}>
300
+ {blockRowLabel(block)}
301
+ </Menu.Item>
302
+ )
303
+
304
+ const sheetBlockRow = (block: (typeof moreBlocks)[number]) => (
305
+ <NavLink
306
+ key={block.key}
307
+ classNames={{ root: classes.row }}
308
+ label={blockRowLabel(block)}
309
+ onClick={() => activateBlock(block)}
310
+ />
311
+ )
312
+
313
+ /** One block ITEM, inside the nested sheet. A row with nowhere to go stays plain text. */
314
+ const blockItemRow = (item: SidebarBlockItem): ReactElement => {
315
+ const lead =
316
+ item.icon ?? (item.tone !== undefined ? <SidebarBlockToneDot tone={item.tone} /> : undefined)
317
+ const meta =
318
+ item.meta !== undefined ? (
319
+ <Text component="span" className={classes.rowMeta}>
320
+ {item.meta}
321
+ </Text>
322
+ ) : undefined
323
+ const interactive =
324
+ item.Anchor !== undefined || item.href !== undefined || item.onClick !== undefined
325
+ if (!interactive) {
326
+ return (
327
+ <div key={item.key} className={classes.row}>
328
+ {lead}
329
+ <Text component="span">{item.label}</Text>
330
+ {meta}
331
+ </div>
332
+ )
333
+ }
334
+ const shared = {
335
+ classNames: { root: classes.row },
336
+ label: item.label,
337
+ ...(lead !== undefined && { leftSection: lead }),
338
+ ...(meta !== undefined && { rightSection: meta }),
339
+ onClick: () => {
340
+ item.onClick?.()
341
+ setOpenBlockKey(null)
342
+ },
343
+ }
344
+ const Anchor = item.Anchor
345
+ if (Anchor) return <NavLink key={item.key} component={Anchor} {...shared} />
346
+ return (
347
+ <NavLink
348
+ key={item.key}
349
+ component="a"
350
+ {...(item.href !== undefined && { href: item.href })}
351
+ {...shared}
352
+ />
353
+ )
354
+ }
355
+
260
356
  /** True when any destination in the slot carries an unread count — the icon dot (§2.4). */
261
357
  const hasCount = (slot: MobileNavSlot): boolean =>
262
358
  slot.kind === 'link'
@@ -411,12 +507,14 @@ export function MobileNav({
411
507
  : []),
412
508
  ...rows(group.items, 0, menuRow),
413
509
  ])}
414
- {/* A separator separates. With nothing above it — a More slot raised purely by the account
415
- and settings rows — it would render as the dropdown's first child, a rule under the
416
- top edge. Both sides have to exist. */}
417
- {slot.isMore && extraRows.length > 0 && slotHasRows(slot) ? <Menu.Divider /> : null}
510
+ {/* A separator separates. With nothing above it — a More slot raised purely by the block,
511
+ account and settings rows — it would render as the dropdown's first child, a rule under
512
+ the top edge. Both sides have to exist. */}
513
+ {slot.isMore && moreBlocks.length + extraRows.length > 0 && slotHasRows(slot) ? (
514
+ <Menu.Divider />
515
+ ) : null}
516
+ {slot.isMore ? moreBlocks.map(menuBlockRow) : null}
418
517
  {slot.isMore ? extraRows.map(menuActionRow) : null}
419
- {slot.isMore ? config?.moreExtra : null}
420
518
  </Menu.Dropdown>
421
519
  </Menu>
422
520
  )
@@ -459,16 +557,49 @@ export function MobileNav({
459
557
  {rows(group.items, 0, sheetRow)}
460
558
  </Stack>
461
559
  ))}
560
+ {slot.isMore && moreBlocks.length > 0 ? (
561
+ <Stack gap={2}>{moreBlocks.map(sheetBlockRow)}</Stack>
562
+ ) : null}
462
563
  {slot.isMore && extraRows.length > 0 ? (
463
564
  <Stack gap={2}>{extraRows.map(sheetActionRow)}</Stack>
464
565
  ) : null}
465
- {slot.isMore ? config?.moreExtra : null}
466
566
  </Stack>
467
567
  </ScrollArea.Autosize>
468
568
  </Drawer>
469
569
  </Fragment>
470
570
  )
471
571
 
572
+ /**
573
+ * The nested block sheet — one Drawer instance PER block rather than one shared instance fed the
574
+ * open block. A shared one would empty its own body the moment `onClose` cleared the key, so the
575
+ * exit transition would play against a blank sheet; a closed Mantine Drawer renders nothing, so N
576
+ * instances cost N nothings.
577
+ */
578
+ const blockSheet = (block: SidebarListBlock) => (
579
+ <Drawer
580
+ key={`block-${block.key}`}
581
+ opened={openBlockKey === block.key}
582
+ onClose={() => setOpenBlockKey(null)}
583
+ position="bottom"
584
+ padding="md"
585
+ title={block.label}
586
+ classNames={{
587
+ content: classes.sheet,
588
+ title: classes.sheetTitle,
589
+ header: classes.sheetHeader,
590
+ }}
591
+ transitionProps={{
592
+ transition: 'slide-up',
593
+ duration: reduceMotion ? 0 : 220,
594
+ timingFunction: 'cubic-bezier(0.32, 0.72, 0, 1)',
595
+ }}
596
+ >
597
+ <ScrollArea.Autosize mah="62dvh" type="scroll">
598
+ <Stack gap={2}>{block.items.map(blockItemRow)}</Stack>
599
+ </ScrollArea.Autosize>
600
+ </Drawer>
601
+ )
602
+
472
603
  return (
473
604
  <nav className={classes.bar} aria-label="Primary">
474
605
  {model.slots.map((slot) => {
@@ -476,10 +607,18 @@ export function MobileNav({
476
607
  if (slot.kind === 'menu') return menuSlot(slot)
477
608
  return sheetSlot(slot)
478
609
  })}
610
+ {listBlocks.map(blockSheet)}
479
611
  </nav>
480
612
  )
481
613
  }
482
614
 
615
+ /** `Awaiting action · 3` — the row's whole job is to say how much is behind it. */
616
+ function blockRowLabel(block: SidebarListBlock | SidebarProgressBlock): string {
617
+ return block.kind === 'list'
618
+ ? `${block.label} · ${block.count ?? block.items.length}`
619
+ : `${block.label} · ${block.value} of ${block.total}`
620
+ }
621
+
483
622
  /** Whether a surface slot paints any destination row at all (as opposed to only derived rows). */
484
623
  function slotHasRows(slot: SurfaceSlot): boolean {
485
624
  return slot.groups.some((group) => group.items.length > 0)
@@ -29,7 +29,7 @@ function getInitials(name: string): string {
29
29
  return `${first}${last}`.toUpperCase()
30
30
  }
31
31
 
32
- /** Identity initials block — 28px, radius 7, ink-10% bg, mono 10.5px (docs/DESIGN-SPEC.md §5). */
32
+ /** Identity initials block — 28px, radius 7, ink-10% bg, mono micro (11px) (docs/DESIGN-SPEC.md §5). */
33
33
  function InitialsBlock({ name }: { name: string }) {
34
34
  return (
35
35
  <div className={classes.avatar} aria-hidden>
@@ -39,7 +39,7 @@ function InitialsBlock({ name }: { name: string }) {
39
39
  }
40
40
 
41
41
  /** Generic "person" glyph for the unauthenticated row — matches the inline-SVG icon convention
42
- * used elsewhere in the shell (`IconGear`/`IconClose` in `app-sidebar.tsx`). */
42
+ * used elsewhere in the shell (`IconGear` in `app-sidebar.tsx`). */
43
43
  function IconUser() {
44
44
  return (
45
45
  <svg
@@ -40,30 +40,63 @@
40
40
 
41
41
  /* Inactive rows: muted text + faint icon. Active rows keep the theme's ink text (via `--nl-color`)
42
42
  * untouched — this selector only ever matches when neither `data-active` nor `aria-current="page"`
43
- * is present. */
44
- .link:not([data-active]):not([aria-current='page']) {
43
+ * is present. `[data-ancestor]` is excluded too: it gets its own ink/accent treatment below and
44
+ * must not fall through to muted/faint here. */
45
+ .link:not([data-active]):not([aria-current='page']):not([data-ancestor]) {
45
46
  color: var(--vx-muted) !important;
46
47
  }
47
48
 
48
- .link:not([data-active]):not([aria-current='page'])
49
+ .link:not([data-active]):not([aria-current='page']):not([data-ancestor])
49
50
  :global(.mantine-NavLink-section[data-position='left']) {
50
51
  color: var(--vx-faint);
51
52
  }
52
53
 
53
54
  /* Hover — ink-6% tint + ink text, for inactive rows only (an active row already carries the
54
- * theme's stronger ink-9% tint and keeps its own hover via `--nl-hover`). */
55
+ * theme's stronger ink-9% tint and keeps its own hover via `--nl-hover`; an ancestor row gets its
56
+ * own hover rule below so its accent icon survives the pointer). */
55
57
  @media (hover: hover) {
56
- .link:not([data-active]):not([aria-current='page']):hover {
58
+ .link:not([data-active]):not([aria-current='page']):not([data-ancestor]):hover {
57
59
  background-color: color-mix(in srgb, var(--vx-ink) 6%, transparent) !important;
58
60
  color: var(--vx-ink) !important;
59
61
  }
60
62
 
61
- .link:not([data-active]):not([aria-current='page']):hover
63
+ .link:not([data-active]):not([aria-current='page']):not([data-ancestor]):hover
62
64
  :global(.mantine-NavLink-section[data-position='left']) {
63
65
  color: var(--vx-ink);
64
66
  }
65
67
  }
66
68
 
69
+ /*
70
+ * Ancestor row (`SidebarItem.ancestor` — a parent on the path to the active row, never active
71
+ * itself, never `aria-current`): must read visibly WEAKER than active and visibly STRONGER than a
72
+ * hovered inactive row, since all three now share the same 6%/9% ink-tint family. Active carries a
73
+ * persistent `--nl-bg` ink-9% fill + weight 600 (theme `nav-link.module.css`); a hovered inactive
74
+ * row carries a transient ink-6% fill. An ancestor therefore gets NO fill at rest (unlike active)
75
+ * and NO weight change (still 400, unlike active's 600) — only the ink label + accent icon that an
76
+ * active row also carries, so it reads as "on the path" without claiming to BE the destination.
77
+ */
78
+ .link[data-ancestor] {
79
+ color: var(--vx-ink) !important;
80
+ }
81
+
82
+ .link[data-ancestor] :global(.mantine-NavLink-section[data-position='left']) {
83
+ color: var(--vx-accent);
84
+ }
85
+
86
+ /* Hover still adds the shared ink-6% tint (same as any inactive row), but must not let the plain
87
+ * inactive hover rule above flatten the icon back to ink — that rule is excluded via
88
+ * `:not([data-ancestor])`, and this one re-asserts the accent icon on top of the shared tint. */
89
+ @media (hover: hover) {
90
+ .link[data-ancestor]:hover {
91
+ background-color: color-mix(in srgb, var(--vx-ink) 6%, transparent) !important;
92
+ color: var(--vx-ink) !important;
93
+ }
94
+
95
+ .link[data-ancestor]:hover :global(.mantine-NavLink-section[data-position='left']) {
96
+ color: var(--vx-accent);
97
+ }
98
+ }
99
+
67
100
  /*
68
101
  * Icon-only ghost buttons in shell chrome (collapse toggle, mobile close) — docs/DESIGN-SPEC.md
69
102
  * §5: transparent, faint icon, hover ink-6% + ink, radius 6. `!important` for the same reason as
@@ -113,6 +146,22 @@
113
146
  font-stretch: 88%;
114
147
  }
115
148
 
149
+ /* Workspace switcher (`brand.menu`) — the brand name plus a chevron, as a row-shaped trigger. The
150
+ * chevron is faint until hover so the brand still reads as the brand, not as a control. */
151
+ .brandButton {
152
+ display: flex;
153
+ align-items: center;
154
+ gap: var(--vx-space-sidebar-section-label-gap);
155
+ min-width: 0;
156
+ padding: 0;
157
+ color: var(--vx-faint);
158
+ cursor: pointer;
159
+ }
160
+
161
+ .brandButton:hover {
162
+ color: var(--vx-ink);
163
+ }
164
+
116
165
  /*
117
166
  * Nav scroll region — a Mantine ScrollArea, whose overlay scrollbar is absolutely positioned inside
118
167
  * the (position: relative; overflow: hidden) root, so it floats over the rows instead of reserving
@@ -151,7 +200,7 @@
151
200
 
152
201
  /*
153
202
  * Footer settings row — IDENTICAL geometry to a nav row (padding 6px 10px, radius 6, gap 10,
154
- * 13px): muted text + faint icon at rest, ink-6% tint + ink on hover, exactly like an inactive
203
+ * 15px): muted text + faint icon at rest, ink-6% tint + ink on hover, exactly like an inactive
155
204
  * nav item, so the footer never reads as a separate control family.
156
205
  */
157
206
  .footerBtn {
@@ -211,7 +260,7 @@
211
260
  }
212
261
 
213
262
  /*
214
- * Identity initials block (docs/DESIGN-SPEC.md §5): 28px, radius 7, ink-10% bg, mono 10.5px
263
+ * Identity initials block (docs/DESIGN-SPEC.md §5): 28px, radius 7, ink-10% bg, mono micro (11px)
215
264
  * weight 500, muted — replaces the generic person glyph for the authenticated state.
216
265
  */
217
266
  .avatar {
@@ -236,7 +285,7 @@
236
285
  color: var(--vx-ink);
237
286
  }
238
287
 
239
- /* Meta line under the name (email / "FREE · MEMBER") — mono 9.5px, uppercase, faint, tracked
288
+ /* Meta line under the name (email / "FREE · MEMBER") — mono micro (11px), uppercase, faint, tracked
240
289
  * 0.03em. */
241
290
  .accountMeta {
242
291
  font-family: var(--basalt-font-mono);
@@ -293,6 +342,214 @@
293
342
  color: var(--vx-ink);
294
343
  }
295
344
 
345
+ /*
346
+ * ── Sidebar blocks (docs/CONTROLS-SPEC.md §2.3) ────────────────────────────────────────────────
347
+ *
348
+ * Same spacing-only separation law as the nav sections above: no rules, no bands, no fills. A
349
+ * block's rows are 32px (`--vx-space-sidebar-block-row-height`) — one step under a nav row, since
350
+ * a block row is reference material rather than a destination.
351
+ */
352
+ .block {
353
+ min-width: 0;
354
+ }
355
+
356
+ .blockHeader {
357
+ display: flex;
358
+ align-items: center;
359
+ gap: var(--vx-space-nav-icon-gap);
360
+ width: 100%;
361
+ padding: 0 var(--vx-space-row-inset-x);
362
+ margin-bottom: var(--vx-space-sidebar-section-label-gap);
363
+ }
364
+
365
+ /* The header's label takes the free width so a count badge / chevron sits hard right. */
366
+ .blockHeader > div:first-of-type {
367
+ flex: 1;
368
+ min-width: 0;
369
+ text-align: left;
370
+ }
371
+
372
+ /* Collapsible variant — text-only hover, exactly like `.sectionHeader`; never a band. */
373
+ .blockHeaderButton {
374
+ color: var(--vx-faint);
375
+ cursor: pointer;
376
+ }
377
+
378
+ .blockHeaderButton:hover .sectionLabel {
379
+ color: var(--vx-ink);
380
+ }
381
+
382
+ .blockIcon {
383
+ position: relative;
384
+ display: flex;
385
+ flex: none;
386
+ align-items: center;
387
+ color: var(--vx-faint);
388
+ }
389
+
390
+ /*
391
+ * Rail dot — the collapsed rail's whole representation of a `count`. Hidden in the expanded
392
+ * sidebar, where the count renders as a real `NavCountBadge` instead: a dot and a number saying
393
+ * the same thing twice is noise, and the rail has no room for the number.
394
+ */
395
+ .blockDot {
396
+ position: absolute;
397
+ top: -2px;
398
+ inset-inline-end: -3px;
399
+ display: none;
400
+ width: 7px;
401
+ height: 7px;
402
+ border-radius: 999px;
403
+ background-color: var(--vx-accent);
404
+ box-shadow: 0 0 0 2px var(--mantine-color-body);
405
+ }
406
+
407
+ .blockItems {
408
+ display: flex;
409
+ flex-direction: column;
410
+ }
411
+
412
+ /* Block row — 32px, small text, muted; the same ink-6% hover every other sidebar row uses. */
413
+ .blockRow {
414
+ display: flex;
415
+ align-items: center;
416
+ gap: var(--vx-space-nav-icon-gap);
417
+ min-height: var(--vx-space-sidebar-block-row-height);
418
+ padding: 0 var(--vx-space-row-inset-x) !important;
419
+ border-radius: var(--vx-radius-ctrl) !important;
420
+ font-size: var(--vx-text-sm);
421
+ color: var(--vx-muted);
422
+ }
423
+
424
+ .blockRow :global(.mantine-NavLink-label) {
425
+ font-size: var(--vx-text-sm);
426
+ }
427
+
428
+ .blockRow :global(.mantine-NavLink-section[data-position='left']) {
429
+ margin-inline-end: 0;
430
+ color: var(--vx-faint);
431
+ }
432
+
433
+ @media (hover: hover) {
434
+ .blockRow:not(.blockRowStatic):hover {
435
+ background-color: color-mix(in srgb, var(--vx-ink) 6%, transparent) !important;
436
+ color: var(--vx-ink) !important;
437
+ }
438
+ }
439
+
440
+ /* A non-interactive row (the "Recents" shape) keeps the geometry and drops every affordance. */
441
+ .blockRowStatic {
442
+ cursor: default;
443
+ }
444
+
445
+ .blockRowLabel {
446
+ flex: 1;
447
+ min-width: 0;
448
+ overflow: hidden;
449
+ text-overflow: ellipsis;
450
+ white-space: nowrap;
451
+ }
452
+
453
+ .blockRowMeta {
454
+ flex: none;
455
+ font-size: var(--vx-text-micro);
456
+ color: var(--vx-faint);
457
+ }
458
+
459
+ /* Status dot standing in for a missing row icon — reads the per-scheme `--vx-status-*` solid. */
460
+ .blockToneDot {
461
+ flex: none;
462
+ width: 6px;
463
+ height: 6px;
464
+ border-radius: 999px;
465
+ background-color: var(--vx-status-neutral);
466
+ }
467
+
468
+ .blockToneDot[data-tone='good'] {
469
+ background-color: var(--vx-status-good);
470
+ }
471
+
472
+ .blockToneDot[data-tone='warn'] {
473
+ background-color: var(--vx-status-warn);
474
+ }
475
+
476
+ .blockToneDot[data-tone='bad'] {
477
+ background-color: var(--vx-status-bad);
478
+ }
479
+
480
+ /* "Show more" — a text affordance, not a button surface. */
481
+ .blockMore {
482
+ min-height: var(--vx-space-sidebar-block-row-height);
483
+ padding: 0 var(--vx-space-row-inset-x);
484
+ text-align: left;
485
+ font-size: var(--vx-text-sm);
486
+ color: var(--vx-faint);
487
+ }
488
+
489
+ .blockMore:hover {
490
+ color: var(--vx-ink);
491
+ }
492
+
493
+ /* Progress block — label + `n of m` over a thin track. */
494
+ .blockProgress {
495
+ display: block;
496
+ width: 100%;
497
+ padding: var(--vx-space-row-inset-y) var(--vx-space-row-inset-x);
498
+ border-radius: var(--vx-radius-ctrl);
499
+ text-align: left;
500
+ }
501
+
502
+ .blockProgress:hover {
503
+ background-color: color-mix(in srgb, var(--vx-ink) 6%, transparent);
504
+ }
505
+
506
+ .blockProgressHead {
507
+ display: flex;
508
+ align-items: center;
509
+ justify-content: space-between;
510
+ gap: var(--vx-space-nav-icon-gap);
511
+ margin-bottom: var(--vx-space-sidebar-section-label-gap);
512
+ }
513
+
514
+ /* The rail's progress mark, rendered on the settings row (never inside the block). */
515
+ .blockRing {
516
+ display: flex;
517
+ flex: none;
518
+ align-items: center;
519
+ }
520
+
521
+ /*
522
+ * Flat footer links — `settingsMenuItems` at three or fewer, rendered as rows instead of a gear
523
+ * menu (see `AppSidebar`'s JSDoc for the threshold). Each row IS a `.footerBtn`, so the two
524
+ * renderings are the same geometry.
525
+ */
526
+ .footerLinks {
527
+ display: flex;
528
+ flex-direction: column;
529
+ }
530
+
531
+ /* Fixed 18px icon column for a flat footer row — an icon-less row keeps the label aligned with
532
+ * its neighbours instead of sliding left. */
533
+ .footerIconSlot {
534
+ display: flex;
535
+ flex: none;
536
+ align-items: center;
537
+ justify-content: center;
538
+ width: 18px;
539
+ color: var(--vx-faint);
540
+ }
541
+
542
+ .footerBtn:hover .footerIconSlot {
543
+ color: var(--vx-ink);
544
+ }
545
+
546
+ .footerVersion {
547
+ padding: var(--vx-space-row-inset-y) var(--vx-space-row-inset-x);
548
+ font-family: var(--basalt-font-mono);
549
+ font-size: var(--vx-text-micro);
550
+ color: var(--vx-faint);
551
+ }
552
+
296
553
  /*
297
554
  * Inline child items — indent under the parent with the ONE allowed sidebar line: a 1px
298
555
  * `--vx-divider` left guide on the WRAPPER (not per row, so hover tints don't break the line).
@@ -350,9 +607,9 @@
350
607
  }
351
608
 
352
609
  /*
353
- * Icon-rail (collapsed) — desktop only. Gated behind min-width: sm (48em) so the mobile drawer keeps
354
- * full labels even when the persisted collapse flag is on. Hide the brand text, section labels and
355
- * nav labels; center the remaining icons.
610
+ * Icon-rail (collapsed) — desktop only. Gated behind min-width: sm (48em) so the sidebar doesn't
611
+ * exist at all below that breakpoint (see `MobileNav`) regardless of the persisted collapse flag.
612
+ * Hide the brand text, section labels and nav labels; center the remaining icons.
356
613
  */
357
614
  @media (min-width: 48em) {
358
615
  .root[data-collapsed] .brand {
@@ -421,14 +678,40 @@
421
678
  display: none;
422
679
  }
423
680
 
424
- /* `navExtra` has no sensible icon-rail representation (arbitrary consumer content, not a nav
425
- * row) — hide it in the rail, same treatment as `.childList`. It stays mounted (never a JS
426
- * conditional on `collapsed`): `collapsed` is one value shared by the desktop rail AND the
427
- * mobile drawer (`AppShell.Navbar`'s `collapsed: { mobile: !mobileOpened }` only ever un-collapses
428
- * the mobile side), and the rail-vs-drawer split lives ENTIRELY in this media query, never in JS —
429
- * a JS gate on `collapsed` would also drop `navExtra` from the mobile drawer, which opens at full
430
- * width regardless of the persisted rail state. */
431
- .root[data-collapsed] .navExtra {
681
+ /*
682
+ * Block rail projection (`sidebarBlockRail`). `hidden` and `ring` blocks leave the rail entirely
683
+ * — a `custom` block is arbitrary consumer content with no icon-column representation (the
684
+ * treatment `navExtra` had), and a progress block's rail form is the ring on the settings row
685
+ * below, not a squashed track. A `dot` block keeps its icon and nothing else.
686
+ *
687
+ * All of it is CSS, never a JS conditional on `collapsed`: the navbar is permanently
688
+ * `collapsed: { mobile: true }` (there is no mobile drawer — see `MobileNav`), so `collapsed`
689
+ * means only the desktop expanded-vs-rail state, and this media query is what applies it.
690
+ */
691
+ .root[data-collapsed] .block[data-rail='hidden'],
692
+ .root[data-collapsed] .block[data-rail='ring'] {
693
+ display: none;
694
+ }
695
+
696
+ .root[data-collapsed] .block[data-rail='dot'] .blockHeader {
697
+ justify-content: center;
698
+ padding: 0;
699
+ margin-bottom: 0;
700
+ }
701
+
702
+ .root[data-collapsed] .block[data-rail='dot'] .blockHeader > *:not(.blockIcon) {
703
+ display: none;
704
+ }
705
+
706
+ .root[data-collapsed] .block[data-rail='dot'] .blockItems {
707
+ display: none;
708
+ }
709
+
710
+ .root[data-collapsed] .blockDot {
711
+ display: block;
712
+ }
713
+
714
+ .root[data-collapsed] .footerVersion {
432
715
  display: none;
433
716
  }
434
717
  }
@@ -10,6 +10,7 @@ declare const classes: {
10
10
  readonly brand: string
11
11
  readonly brandLead: string
12
12
  readonly brandName: string
13
+ readonly brandButton: string
13
14
  readonly searchSlot: string
14
15
  readonly navScroll: string
15
16
  readonly navViewport: string
@@ -27,7 +28,24 @@ declare const classes: {
27
28
  readonly sectionHeader: string
28
29
  readonly subnavDropdown: string
29
30
  readonly childList: string
30
- readonly navExtra: string
31
31
  readonly ghostIcon: string
32
+ readonly block: string
33
+ readonly blockHeader: string
34
+ readonly blockHeaderButton: string
35
+ readonly blockIcon: string
36
+ readonly blockDot: string
37
+ readonly blockItems: string
38
+ readonly blockRow: string
39
+ readonly blockRowStatic: string
40
+ readonly blockRowLabel: string
41
+ readonly blockRowMeta: string
42
+ readonly blockToneDot: string
43
+ readonly blockMore: string
44
+ readonly blockProgress: string
45
+ readonly blockProgressHead: string
46
+ readonly blockRing: string
47
+ readonly footerLinks: string
48
+ readonly footerIconSlot: string
49
+ readonly footerVersion: string
32
50
  }
33
51
  export default classes