@bridgebrew/ui 0.0.0-stage → 0.1.9

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 (411) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +39 -2
  3. package/SOURCE.md +182 -0
  4. package/dist/build.js +871 -0
  5. package/dist/theme-css.js +896 -0
  6. package/dist/themes.js +69 -0
  7. package/dist/types/build/stylesheet.d.ts +31 -0
  8. package/dist/types/components/composite/command/command.d.ts +94 -0
  9. package/dist/types/components/composite/command/index.d.ts +2 -0
  10. package/dist/types/components/composite/draft-bar/draft-bar.d.ts +12 -0
  11. package/dist/types/components/composite/draft-bar/index.d.ts +2 -0
  12. package/dist/types/components/composite/image-field/image-field.d.ts +33 -0
  13. package/dist/types/components/composite/image-field/index.d.ts +2 -0
  14. package/dist/types/components/composite/list/index.d.ts +3 -0
  15. package/dist/types/components/composite/list/list-swipe.d.ts +28 -0
  16. package/dist/types/components/composite/list/list.d.ts +95 -0
  17. package/dist/types/components/composite/picker/index.d.ts +2 -0
  18. package/dist/types/components/composite/picker/picker.d.ts +44 -0
  19. package/dist/types/components/composite/prompt-field/index.d.ts +2 -0
  20. package/dist/types/components/composite/prompt-field/prompt-field.d.ts +18 -0
  21. package/dist/types/components/composite/properties/index.d.ts +2 -0
  22. package/dist/types/components/composite/properties/properties.d.ts +24 -0
  23. package/dist/types/components/composite/snooze-menu/index.d.ts +4 -0
  24. package/dist/types/components/composite/snooze-menu/presets.d.ts +36 -0
  25. package/dist/types/components/composite/snooze-menu/snooze-menu.d.ts +27 -0
  26. package/dist/types/components/composite/tag-input/index.d.ts +2 -0
  27. package/dist/types/components/composite/tag-input/tag-input.d.ts +22 -0
  28. package/dist/types/components/composite/wizard/index.d.ts +2 -0
  29. package/dist/types/components/composite/wizard/wizard.d.ts +53 -0
  30. package/dist/types/components/core/avatar/avatar.d.ts +16 -0
  31. package/dist/types/components/core/avatar/index.d.ts +2 -0
  32. package/dist/types/components/core/badge/badge.d.ts +8 -0
  33. package/dist/types/components/core/badge/index.d.ts +2 -0
  34. package/dist/types/components/core/breadcrumb/breadcrumb.d.ts +21 -0
  35. package/dist/types/components/core/breadcrumb/index.d.ts +2 -0
  36. package/dist/types/components/core/bullets/bullets.d.ts +15 -0
  37. package/dist/types/components/core/bullets/index.d.ts +2 -0
  38. package/dist/types/components/core/button/button.d.ts +14 -0
  39. package/dist/types/components/core/button/index.d.ts +2 -0
  40. package/dist/types/components/core/card/card.d.ts +16 -0
  41. package/dist/types/components/core/card/index.d.ts +2 -0
  42. package/dist/types/components/core/checkbox/checkbox.d.ts +15 -0
  43. package/dist/types/components/core/checkbox/index.d.ts +2 -0
  44. package/dist/types/components/core/cluster/cluster.d.ts +5 -0
  45. package/dist/types/components/core/cluster/index.d.ts +1 -0
  46. package/dist/types/components/core/code-block/code-block.d.ts +18 -0
  47. package/dist/types/components/core/code-block/index.d.ts +2 -0
  48. package/dist/types/components/core/collapsible/collapsible.d.ts +8 -0
  49. package/dist/types/components/core/collapsible/index.d.ts +1 -0
  50. package/dist/types/components/core/colour-picker/colour-picker.d.ts +25 -0
  51. package/dist/types/components/core/colour-picker/index.d.ts +4 -0
  52. package/dist/types/components/core/combobox/combobox.d.ts +63 -0
  53. package/dist/types/components/core/combobox/index.d.ts +2 -0
  54. package/dist/types/components/core/detail/detail.d.ts +12 -0
  55. package/dist/types/components/core/detail/index.d.ts +1 -0
  56. package/dist/types/components/core/dialog/dialog.d.ts +43 -0
  57. package/dist/types/components/core/dialog/drag.d.ts +4 -0
  58. package/dist/types/components/core/dialog/index.d.ts +2 -0
  59. package/dist/types/components/core/drop-zone/drop-zone.d.ts +23 -0
  60. package/dist/types/components/core/drop-zone/index.d.ts +2 -0
  61. package/dist/types/components/core/dropdown-menu/dropdown-menu.d.ts +78 -0
  62. package/dist/types/components/core/dropdown-menu/index.d.ts +2 -0
  63. package/dist/types/components/core/editable-field/editable-field.d.ts +42 -0
  64. package/dist/types/components/core/editable-field/index.d.ts +2 -0
  65. package/dist/types/components/core/empty-state/empty-state.d.ts +11 -0
  66. package/dist/types/components/core/empty-state/index.d.ts +2 -0
  67. package/dist/types/components/core/field/field.d.ts +31 -0
  68. package/dist/types/components/core/field/index.d.ts +2 -0
  69. package/dist/types/components/core/icon/icon-sets.d.ts +38 -0
  70. package/dist/types/components/core/icon/icon.d.ts +14 -0
  71. package/dist/types/components/core/icon/index.d.ts +2 -0
  72. package/dist/types/components/core/input/index.d.ts +4 -0
  73. package/dist/types/components/core/input/input.d.ts +22 -0
  74. package/dist/types/components/core/input/textarea.d.ts +8 -0
  75. package/dist/types/components/core/kbd/index.d.ts +2 -0
  76. package/dist/types/components/core/kbd/kbd.d.ts +7 -0
  77. package/dist/types/components/core/label/index.d.ts +2 -0
  78. package/dist/types/components/core/label/label.d.ts +13 -0
  79. package/dist/types/components/core/main-content/index.d.ts +2 -0
  80. package/dist/types/components/core/main-content/main-content.d.ts +18 -0
  81. package/dist/types/components/core/pane/index.d.ts +1 -0
  82. package/dist/types/components/core/pane/pane.d.ts +12 -0
  83. package/dist/types/components/core/pick-menu/index.d.ts +4 -0
  84. package/dist/types/components/core/pick-menu/pick-menu.d.ts +57 -0
  85. package/dist/types/components/core/pick-menu/tag-menu.d.ts +19 -0
  86. package/dist/types/components/core/popover/index.d.ts +2 -0
  87. package/dist/types/components/core/popover/popover.d.ts +22 -0
  88. package/dist/types/components/core/progress/index.d.ts +2 -0
  89. package/dist/types/components/core/progress/progress.d.ts +13 -0
  90. package/dist/types/components/core/resizable/index.d.ts +2 -0
  91. package/dist/types/components/core/resizable/resizable.d.ts +15 -0
  92. package/dist/types/components/core/resizable/use-remembered-layout.d.ts +31 -0
  93. package/dist/types/components/core/screen-link/index.d.ts +2 -0
  94. package/dist/types/components/core/screen-link/screen-link.d.ts +52 -0
  95. package/dist/types/components/core/scroll-area/index.d.ts +2 -0
  96. package/dist/types/components/core/scroll-area/scroll-area.d.ts +13 -0
  97. package/dist/types/components/core/scroll-area/steps.d.ts +5 -0
  98. package/dist/types/components/core/section/index.d.ts +2 -0
  99. package/dist/types/components/core/section/section.d.ts +16 -0
  100. package/dist/types/components/core/segment-group/index.d.ts +2 -0
  101. package/dist/types/components/core/segment-group/segment-group.d.ts +24 -0
  102. package/dist/types/components/core/select/index.d.ts +2 -0
  103. package/dist/types/components/core/select/select.d.ts +39 -0
  104. package/dist/types/components/core/skeleton/index.d.ts +2 -0
  105. package/dist/types/components/core/skeleton/skeleton.d.ts +13 -0
  106. package/dist/types/components/core/slider/index.d.ts +2 -0
  107. package/dist/types/components/core/slider/slider.d.ts +9 -0
  108. package/dist/types/components/core/sortable/index.d.ts +2 -0
  109. package/dist/types/components/core/sortable/sortable.d.ts +53 -0
  110. package/dist/types/components/core/split-view/index.d.ts +2 -0
  111. package/dist/types/components/core/split-view/split-view.d.ts +28 -0
  112. package/dist/types/components/core/status-icon/index.d.ts +2 -0
  113. package/dist/types/components/core/status-icon/status-icon.d.ts +13 -0
  114. package/dist/types/components/core/table/collapsible-rows.d.ts +7 -0
  115. package/dist/types/components/core/table/expand-toggle.d.ts +10 -0
  116. package/dist/types/components/core/table/group-header.d.ts +14 -0
  117. package/dist/types/components/core/table/index.d.ts +8 -0
  118. package/dist/types/components/core/table/table.d.ts +31 -0
  119. package/dist/types/components/core/tabs/index.d.ts +2 -0
  120. package/dist/types/components/core/tabs/tabs.d.ts +20 -0
  121. package/dist/types/components/core/tag-pill/index.d.ts +2 -0
  122. package/dist/types/components/core/tag-pill/tag-pill.d.ts +25 -0
  123. package/dist/types/components/core/thumbnail/index.d.ts +2 -0
  124. package/dist/types/components/core/thumbnail/thumbnail.d.ts +23 -0
  125. package/dist/types/components/core/toast/index.d.ts +2 -0
  126. package/dist/types/components/core/toast/toast.d.ts +88 -0
  127. package/dist/types/components/core/toggle/index.d.ts +2 -0
  128. package/dist/types/components/core/toggle/toggle.d.ts +9 -0
  129. package/dist/types/components/core/toggle-group/index.d.ts +2 -0
  130. package/dist/types/components/core/toggle-group/toggle-group.d.ts +21 -0
  131. package/dist/types/components/core/tooltip/index.d.ts +2 -0
  132. package/dist/types/components/core/tooltip/tooltip.d.ts +33 -0
  133. package/dist/types/components/layout/multi-pane/index.d.ts +4 -0
  134. package/dist/types/components/layout/multi-pane/list-detail.d.ts +17 -0
  135. package/dist/types/components/layout/multi-pane/multi-pane.d.ts +34 -0
  136. package/dist/types/components/layout/single-pane/index.d.ts +2 -0
  137. package/dist/types/components/layout/single-pane/single-pane.d.ts +11 -0
  138. package/dist/types/components/shell/app-shell/app-shell.d.ts +12 -0
  139. package/dist/types/components/shell/app-shell/index.d.ts +2 -0
  140. package/dist/types/components/shell/sidebar/index.d.ts +2 -0
  141. package/dist/types/components/shell/sidebar/sidebar-group.d.ts +45 -0
  142. package/dist/types/components/shell/sidebar/sidebar-item.d.ts +19 -0
  143. package/dist/types/components/shell/sidebar/sidebar-resize-handle.d.ts +17 -0
  144. package/dist/types/components/shell/sidebar/sidebar-tree.d.ts +42 -0
  145. package/dist/types/components/shell/sidebar/sidebar.d.ts +27 -0
  146. package/dist/types/components/template/address-book-template/address-book-template.d.ts +15 -0
  147. package/dist/types/components/template/address-book-template/index.d.ts +2 -0
  148. package/dist/types/components/template/mail-template/index.d.ts +2 -0
  149. package/dist/types/components/template/mail-template/mail-template.d.ts +11 -0
  150. package/dist/types/components/template/use-narrow.d.ts +3 -0
  151. package/dist/types/index.d.ts +149 -0
  152. package/dist/types/kit/check-rendering.d.ts +3 -0
  153. package/dist/types/kit/kit.d.ts +76 -0
  154. package/dist/types/lib/clipboard.d.ts +5 -0
  155. package/dist/types/lib/dates.d.ts +9 -0
  156. package/dist/types/lib/json.d.ts +26 -0
  157. package/dist/types/lib/keys.d.ts +15 -0
  158. package/dist/types/lib/utils.d.ts +2 -0
  159. package/dist/types/lib/view-scope.d.ts +22 -0
  160. package/dist/types/profile/profile.d.ts +34 -0
  161. package/dist/types/theme/appearance.d.ts +31 -0
  162. package/dist/types/theme/boot.d.ts +3 -0
  163. package/dist/types/theme/client-appearance-react.d.ts +3 -0
  164. package/dist/types/theme/client-appearance.d.ts +69 -0
  165. package/dist/types/theme/generate-tokens.d.ts +45 -0
  166. package/dist/types/theme/pack-themes-react.d.ts +24 -0
  167. package/dist/types/theme/palette.d.ts +111 -0
  168. package/dist/types/theme/semantic-mapping.d.ts +28 -0
  169. package/dist/types/theme/set-theme.d.ts +30 -0
  170. package/dist/types/theme/theme-colours.d.ts +14 -0
  171. package/dist/types/theme/theme-css.d.ts +3 -0
  172. package/dist/types/theme/themes.d.ts +63 -0
  173. package/dist/types/theme/wallpaper-sheet.d.ts +16 -0
  174. package/dist/types/theme/wallpaper-theme-react.d.ts +7 -0
  175. package/dist/types/theme/wallpaper-theme.d.ts +37 -0
  176. package/package.json +87 -3
  177. package/src/build/stylesheet.ts +128 -0
  178. package/src/components/composite/command/command.meta.yaml +74 -0
  179. package/src/components/composite/command/command.tsx +939 -0
  180. package/src/components/composite/command/index.ts +17 -0
  181. package/src/components/composite/draft-bar/draft-bar.meta.yaml +19 -0
  182. package/src/components/composite/draft-bar/draft-bar.tsx +57 -0
  183. package/src/components/composite/draft-bar/index.ts +2 -0
  184. package/src/components/composite/image-field/image-field.meta.yaml +69 -0
  185. package/src/components/composite/image-field/image-field.tsx +267 -0
  186. package/src/components/composite/image-field/index.ts +2 -0
  187. package/src/components/composite/list/index.ts +18 -0
  188. package/src/components/composite/list/list-swipe.tsx +163 -0
  189. package/src/components/composite/list/list.meta.yaml +238 -0
  190. package/src/components/composite/list/list.tsx +868 -0
  191. package/src/components/composite/picker/index.ts +2 -0
  192. package/src/components/composite/picker/picker.meta.yaml +103 -0
  193. package/src/components/composite/picker/picker.tsx +276 -0
  194. package/src/components/composite/prompt-field/index.ts +2 -0
  195. package/src/components/composite/prompt-field/prompt-field.meta.yaml +60 -0
  196. package/src/components/composite/prompt-field/prompt-field.tsx +81 -0
  197. package/src/components/composite/properties/index.ts +9 -0
  198. package/src/components/composite/properties/properties.meta.yaml +56 -0
  199. package/src/components/composite/properties/properties.tsx +132 -0
  200. package/src/components/composite/snooze-menu/index.ts +11 -0
  201. package/src/components/composite/snooze-menu/presets.ts +169 -0
  202. package/src/components/composite/snooze-menu/snooze-menu.meta.yaml +58 -0
  203. package/src/components/composite/snooze-menu/snooze-menu.tsx +146 -0
  204. package/src/components/composite/tag-input/index.ts +2 -0
  205. package/src/components/composite/tag-input/tag-input.meta.yaml +51 -0
  206. package/src/components/composite/tag-input/tag-input.tsx +404 -0
  207. package/src/components/composite/wizard/index.ts +2 -0
  208. package/src/components/composite/wizard/wizard.meta.yaml +73 -0
  209. package/src/components/composite/wizard/wizard.tsx +256 -0
  210. package/src/components/core/avatar/avatar.meta.yaml +71 -0
  211. package/src/components/core/avatar/avatar.tsx +92 -0
  212. package/src/components/core/avatar/index.ts +2 -0
  213. package/src/components/core/badge/badge.meta.yaml +34 -0
  214. package/src/components/core/badge/badge.tsx +23 -0
  215. package/src/components/core/badge/index.ts +2 -0
  216. package/src/components/core/breadcrumb/breadcrumb.meta.yaml +45 -0
  217. package/src/components/core/breadcrumb/breadcrumb.tsx +110 -0
  218. package/src/components/core/breadcrumb/index.ts +2 -0
  219. package/src/components/core/bullets/bullets.meta.yaml +37 -0
  220. package/src/components/core/bullets/bullets.tsx +60 -0
  221. package/src/components/core/bullets/index.ts +2 -0
  222. package/src/components/core/button/button.meta.yaml +91 -0
  223. package/src/components/core/button/button.tsx +93 -0
  224. package/src/components/core/button/index.ts +2 -0
  225. package/src/components/core/card/card.meta.yaml +94 -0
  226. package/src/components/core/card/card.tsx +54 -0
  227. package/src/components/core/card/index.ts +2 -0
  228. package/src/components/core/checkbox/checkbox.meta.yaml +59 -0
  229. package/src/components/core/checkbox/checkbox.tsx +106 -0
  230. package/src/components/core/checkbox/index.ts +2 -0
  231. package/src/components/core/cluster/cluster.meta.yaml +4 -0
  232. package/src/components/core/cluster/cluster.tsx +17 -0
  233. package/src/components/core/cluster/index.ts +1 -0
  234. package/src/components/core/code-block/code-block.meta.yaml +30 -0
  235. package/src/components/core/code-block/code-block.tsx +93 -0
  236. package/src/components/core/code-block/index.ts +2 -0
  237. package/src/components/core/collapsible/collapsible.meta.yaml +34 -0
  238. package/src/components/core/collapsible/collapsible.tsx +54 -0
  239. package/src/components/core/collapsible/index.ts +1 -0
  240. package/src/components/core/colour-picker/colour-picker.meta.yaml +52 -0
  241. package/src/components/core/colour-picker/colour-picker.tsx +314 -0
  242. package/src/components/core/colour-picker/index.ts +4 -0
  243. package/src/components/core/combobox/combobox.meta.yaml +75 -0
  244. package/src/components/core/combobox/combobox.tsx +288 -0
  245. package/src/components/core/combobox/index.ts +2 -0
  246. package/src/components/core/detail/detail.meta.yaml +13 -0
  247. package/src/components/core/detail/detail.tsx +73 -0
  248. package/src/components/core/detail/index.ts +1 -0
  249. package/src/components/core/dialog/dialog.meta.yaml +95 -0
  250. package/src/components/core/dialog/dialog.tsx +254 -0
  251. package/src/components/core/dialog/drag.ts +40 -0
  252. package/src/components/core/dialog/index.ts +25 -0
  253. package/src/components/core/drop-zone/drop-zone.meta.yaml +55 -0
  254. package/src/components/core/drop-zone/drop-zone.tsx +146 -0
  255. package/src/components/core/drop-zone/index.ts +2 -0
  256. package/src/components/core/dropdown-menu/dropdown-menu.meta.yaml +118 -0
  257. package/src/components/core/dropdown-menu/dropdown-menu.tsx +407 -0
  258. package/src/components/core/dropdown-menu/index.ts +32 -0
  259. package/src/components/core/editable-field/editable-field.meta.yaml +120 -0
  260. package/src/components/core/editable-field/editable-field.tsx +346 -0
  261. package/src/components/core/editable-field/index.ts +2 -0
  262. package/src/components/core/empty-state/empty-state.meta.yaml +21 -0
  263. package/src/components/core/empty-state/empty-state.tsx +42 -0
  264. package/src/components/core/empty-state/index.ts +2 -0
  265. package/src/components/core/field/field.meta.yaml +37 -0
  266. package/src/components/core/field/field.tsx +100 -0
  267. package/src/components/core/field/index.ts +9 -0
  268. package/src/components/core/icon/curated-names.json +107 -0
  269. package/src/components/core/icon/icon-sets.ts +109 -0
  270. package/src/components/core/icon/icon.meta.yaml +30 -0
  271. package/src/components/core/icon/icon.tsx +93 -0
  272. package/src/components/core/icon/index.ts +2 -0
  273. package/src/components/core/input/index.ts +4 -0
  274. package/src/components/core/input/input.meta.yaml +98 -0
  275. package/src/components/core/input/input.tsx +133 -0
  276. package/src/components/core/input/textarea.meta.yaml +79 -0
  277. package/src/components/core/input/textarea.tsx +63 -0
  278. package/src/components/core/kbd/index.ts +2 -0
  279. package/src/components/core/kbd/kbd.meta.yaml +12 -0
  280. package/src/components/core/kbd/kbd.tsx +29 -0
  281. package/src/components/core/label/index.ts +2 -0
  282. package/src/components/core/label/label.meta.yaml +55 -0
  283. package/src/components/core/label/label.tsx +72 -0
  284. package/src/components/core/main-content/index.ts +2 -0
  285. package/src/components/core/main-content/main-content.meta.yaml +23 -0
  286. package/src/components/core/main-content/main-content.tsx +49 -0
  287. package/src/components/core/pane/index.ts +1 -0
  288. package/src/components/core/pane/pane.meta.yaml +13 -0
  289. package/src/components/core/pane/pane.tsx +64 -0
  290. package/src/components/core/pick-menu/index.ts +4 -0
  291. package/src/components/core/pick-menu/pick-menu.meta.yaml +36 -0
  292. package/src/components/core/pick-menu/pick-menu.tsx +348 -0
  293. package/src/components/core/pick-menu/tag-menu.meta.yaml +7 -0
  294. package/src/components/core/pick-menu/tag-menu.tsx +79 -0
  295. package/src/components/core/popover/index.ts +2 -0
  296. package/src/components/core/popover/popover.meta.yaml +16 -0
  297. package/src/components/core/popover/popover.tsx +66 -0
  298. package/src/components/core/progress/index.ts +2 -0
  299. package/src/components/core/progress/progress.meta.yaml +47 -0
  300. package/src/components/core/progress/progress.tsx +56 -0
  301. package/src/components/core/resizable/index.ts +13 -0
  302. package/src/components/core/resizable/resizable.meta.yaml +110 -0
  303. package/src/components/core/resizable/resizable.tsx +125 -0
  304. package/src/components/core/resizable/use-remembered-layout.ts +261 -0
  305. package/src/components/core/screen-link/index.ts +2 -0
  306. package/src/components/core/screen-link/screen-link.meta.yaml +34 -0
  307. package/src/components/core/screen-link/screen-link.tsx +100 -0
  308. package/src/components/core/scroll-area/index.ts +2 -0
  309. package/src/components/core/scroll-area/scroll-area.meta.yaml +72 -0
  310. package/src/components/core/scroll-area/scroll-area.tsx +95 -0
  311. package/src/components/core/scroll-area/steps.tsx +72 -0
  312. package/src/components/core/section/index.ts +2 -0
  313. package/src/components/core/section/section.meta.yaml +72 -0
  314. package/src/components/core/section/section.tsx +93 -0
  315. package/src/components/core/segment-group/index.ts +2 -0
  316. package/src/components/core/segment-group/segment-group.meta.yaml +71 -0
  317. package/src/components/core/segment-group/segment-group.tsx +166 -0
  318. package/src/components/core/select/index.ts +20 -0
  319. package/src/components/core/select/select.meta.yaml +48 -0
  320. package/src/components/core/select/select.tsx +226 -0
  321. package/src/components/core/skeleton/index.ts +2 -0
  322. package/src/components/core/skeleton/skeleton.meta.yaml +50 -0
  323. package/src/components/core/skeleton/skeleton.tsx +71 -0
  324. package/src/components/core/slider/index.ts +2 -0
  325. package/src/components/core/slider/slider.meta.yaml +55 -0
  326. package/src/components/core/slider/slider.tsx +46 -0
  327. package/src/components/core/sortable/index.ts +16 -0
  328. package/src/components/core/sortable/sortable.meta.yaml +125 -0
  329. package/src/components/core/sortable/sortable.tsx +471 -0
  330. package/src/components/core/split-view/index.ts +2 -0
  331. package/src/components/core/split-view/split-view.meta.yaml +85 -0
  332. package/src/components/core/split-view/split-view.tsx +193 -0
  333. package/src/components/core/status-icon/index.ts +2 -0
  334. package/src/components/core/status-icon/status-icon.meta.yaml +64 -0
  335. package/src/components/core/status-icon/status-icon.tsx +94 -0
  336. package/src/components/core/table/collapsible-rows.tsx +30 -0
  337. package/src/components/core/table/expand-toggle.tsx +58 -0
  338. package/src/components/core/table/group-header.tsx +35 -0
  339. package/src/components/core/table/index.ts +26 -0
  340. package/src/components/core/table/table.meta.yaml +67 -0
  341. package/src/components/core/table/table.tsx +166 -0
  342. package/src/components/core/tabs/index.ts +2 -0
  343. package/src/components/core/tabs/tabs.meta.yaml +57 -0
  344. package/src/components/core/tabs/tabs.tsx +74 -0
  345. package/src/components/core/tag-pill/index.ts +2 -0
  346. package/src/components/core/tag-pill/tag-pill.meta.yaml +19 -0
  347. package/src/components/core/tag-pill/tag-pill.tsx +102 -0
  348. package/src/components/core/thumbnail/index.ts +2 -0
  349. package/src/components/core/thumbnail/thumbnail.meta.yaml +59 -0
  350. package/src/components/core/thumbnail/thumbnail.tsx +162 -0
  351. package/src/components/core/toast/index.ts +12 -0
  352. package/src/components/core/toast/toast.meta.yaml +93 -0
  353. package/src/components/core/toast/toast.tsx +763 -0
  354. package/src/components/core/toggle/index.ts +2 -0
  355. package/src/components/core/toggle/toggle.meta.yaml +53 -0
  356. package/src/components/core/toggle/toggle.tsx +44 -0
  357. package/src/components/core/toggle-group/index.ts +2 -0
  358. package/src/components/core/toggle-group/toggle-group.meta.yaml +59 -0
  359. package/src/components/core/toggle-group/toggle-group.tsx +68 -0
  360. package/src/components/core/tooltip/index.ts +7 -0
  361. package/src/components/core/tooltip/tooltip.meta.yaml +93 -0
  362. package/src/components/core/tooltip/tooltip.tsx +198 -0
  363. package/src/components/layout/multi-pane/index.ts +4 -0
  364. package/src/components/layout/multi-pane/list-detail.tsx +45 -0
  365. package/src/components/layout/multi-pane/multi-pane.meta.yaml +67 -0
  366. package/src/components/layout/multi-pane/multi-pane.tsx +158 -0
  367. package/src/components/layout/single-pane/index.ts +2 -0
  368. package/src/components/layout/single-pane/single-pane.meta.yaml +35 -0
  369. package/src/components/layout/single-pane/single-pane.tsx +48 -0
  370. package/src/components/shell/app-shell/app-shell.meta.yaml +65 -0
  371. package/src/components/shell/app-shell/app-shell.tsx +61 -0
  372. package/src/components/shell/app-shell/index.ts +2 -0
  373. package/src/components/shell/sidebar/index.ts +35 -0
  374. package/src/components/shell/sidebar/sidebar-group.tsx +254 -0
  375. package/src/components/shell/sidebar/sidebar-item.tsx +88 -0
  376. package/src/components/shell/sidebar/sidebar-resize-handle.tsx +101 -0
  377. package/src/components/shell/sidebar/sidebar-tree.tsx +325 -0
  378. package/src/components/shell/sidebar/sidebar.meta.yaml +126 -0
  379. package/src/components/shell/sidebar/sidebar.tsx +142 -0
  380. package/src/components/template/address-book-template/address-book-template.meta.yaml +22 -0
  381. package/src/components/template/address-book-template/address-book-template.tsx +201 -0
  382. package/src/components/template/address-book-template/index.ts +2 -0
  383. package/src/components/template/mail-template/index.ts +2 -0
  384. package/src/components/template/mail-template/mail-template.meta.yaml +22 -0
  385. package/src/components/template/mail-template/mail-template.tsx +731 -0
  386. package/src/components/template/use-narrow.ts +18 -0
  387. package/src/index.ts +505 -0
  388. package/src/kit/check-rendering.tsx +130 -0
  389. package/src/kit/kit.tsx +177 -0
  390. package/src/lib/clipboard.ts +27 -0
  391. package/src/lib/dates.ts +13 -0
  392. package/src/lib/json.ts +59 -0
  393. package/src/lib/keys.ts +54 -0
  394. package/src/lib/utils.ts +12 -0
  395. package/src/lib/view-scope.tsx +60 -0
  396. package/src/profile/profile.ts +238 -0
  397. package/src/theme/appearance.ts +198 -0
  398. package/src/theme/boot.ts +6 -0
  399. package/src/theme/client-appearance-react.ts +14 -0
  400. package/src/theme/client-appearance.ts +284 -0
  401. package/src/theme/generate-tokens.ts +658 -0
  402. package/src/theme/pack-themes-react.ts +107 -0
  403. package/src/theme/palette.ts +301 -0
  404. package/src/theme/semantic-mapping.ts +165 -0
  405. package/src/theme/set-theme.ts +162 -0
  406. package/src/theme/theme-colours.ts +60 -0
  407. package/src/theme/theme-css.ts +15 -0
  408. package/src/theme/themes.ts +133 -0
  409. package/src/theme/wallpaper-sheet.ts +58 -0
  410. package/src/theme/wallpaper-theme-react.ts +60 -0
  411. package/src/theme/wallpaper-theme.ts +231 -0
@@ -0,0 +1,88 @@
1
+ import * as React from "react";
2
+ import { cva, type VariantProps } from "class-variance-authority";
3
+
4
+ import { useRender } from "@base-ui/react/use-render";
5
+
6
+ import { cn } from "../../../lib/utils";
7
+ import { Badge } from "../../core/badge/badge";
8
+
9
+ // --- SidebarItem ---
10
+
11
+ const sidebarItemVariants = cva(
12
+ "flex items-center gap-2 px-1.5 h-(--height-md) rounded-control text-sm text-secondary cursor-pointer border-0 bg-transparent w-full text-left no-underline transition-[background,color] duration-100",
13
+ {
14
+ variants: {
15
+ active: {
16
+ true: "bg-active text-foreground font-medium",
17
+ false: "hover:bg-hover hover:text-foreground",
18
+ },
19
+ },
20
+ defaultVariants: { active: false },
21
+ },
22
+ );
23
+
24
+ interface SidebarItemProps
25
+ extends Omit<React.ComponentProps<"button">, "color">, VariantProps<typeof sidebarItemVariants> {
26
+ /** Replace the rendered element (for router links, etc.), e.g. render={<a href="…" />} */
27
+ render?: useRender.RenderProp;
28
+ /** Optional icon displayed before label */
29
+ icon?: React.ReactNode;
30
+ /** Optional count displayed as Badge on the right */
31
+ count?: number;
32
+ /** Optional team dot color (hex string) */
33
+ teamDot?: string;
34
+ }
35
+
36
+ function SidebarItem({
37
+ className,
38
+ children,
39
+ icon,
40
+ count,
41
+ teamDot,
42
+ active,
43
+ render,
44
+ ref,
45
+ ...props
46
+ }: SidebarItemProps) {
47
+ return useRender({
48
+ // Default to a plain <button /> render element instead of Base UI's
49
+ // defaultTagName path, which injects type="button" — the pre-migration
50
+ // <button> was implicitly type="submit" inside forms.
51
+ render: render ?? <button />,
52
+ ref: ref as React.Ref<HTMLButtonElement>,
53
+ props: {
54
+ "data-slot": "sidebar-item",
55
+ className: cn(sidebarItemVariants({ active, className })),
56
+ ...props,
57
+ // When a custom element is rendered, pass children through untouched
58
+ // (the render path intentionally skips icon/count/teamDot decorations).
59
+ children: render ? (
60
+ children
61
+ ) : (
62
+ <>
63
+ {teamDot && (
64
+ <span
65
+ data-slot="sidebar-team-dot"
66
+ className="size-2 rounded-full shrink-0"
67
+ style={{ background: teamDot }}
68
+ />
69
+ )}
70
+ {icon && (
71
+ <span data-slot="sidebar-item-icon" className="text-muted shrink-0">
72
+ {icon}
73
+ </span>
74
+ )}
75
+ {children}
76
+ {count !== undefined && (
77
+ <span className="ml-auto">
78
+ <Badge>{count}</Badge>
79
+ </span>
80
+ )}
81
+ </>
82
+ ),
83
+ },
84
+ });
85
+ }
86
+
87
+ export { SidebarItem, sidebarItemVariants };
88
+ export type { SidebarItemProps };
@@ -0,0 +1,101 @@
1
+ import * as React from "react";
2
+
3
+ import { cn } from "../../../lib/utils";
4
+
5
+ // --- SidebarResizeHandle ---
6
+
7
+ const SIDEBAR_MIN_WIDTH = 190;
8
+ const SIDEBAR_DEFAULT_WIDTH = 220;
9
+ /** Half the viewport, never under the minimum. */
10
+ const sidebarMaxWidth = () => Math.max(SIDEBAR_MIN_WIDTH, Math.floor(window.innerWidth / 2));
11
+ const clampSidebarWidth = (width: number) =>
12
+ Math.min(sidebarMaxWidth(), Math.max(SIDEBAR_MIN_WIDTH, Math.round(width)));
13
+
14
+ interface SidebarResizeHandleProps extends Omit<React.ComponentProps<"div">, "children"> {
15
+ /** The sidebar's width in px (a Sidebar reads it from `--sidebar-width`). */
16
+ width: number;
17
+ /** Called with the next width, already clamped: while dragging, per key, on double-click. */
18
+ onWidthChange: (width: number) => void;
19
+ }
20
+
21
+ /** An 8px vertical separator on the sidebar's right edge: drag it (pointer capture), ArrowLeft/Right
22
+ * by 8px, double-click for the default width; clamped between 190px and half the viewport. Place it
23
+ * absolutely in a positioned container whose left edge is the sidebar's: the width is the pointer's
24
+ * x minus that edge. */
25
+ function SidebarResizeHandle({
26
+ width,
27
+ onWidthChange,
28
+ className,
29
+ style,
30
+ ...props
31
+ }: SidebarResizeHandleProps) {
32
+ const [dragging, setDragging] = React.useState(false);
33
+ // While dragging, the whole page keeps the resize cursor and selects no text.
34
+ React.useEffect(() => {
35
+ if (!dragging) return;
36
+ const root = document.documentElement.style;
37
+ root.setProperty("cursor", "col-resize");
38
+ root.setProperty("user-select", "none");
39
+ return () => {
40
+ root.removeProperty("cursor");
41
+ root.removeProperty("user-select");
42
+ };
43
+ }, [dragging]);
44
+ const fromPointer = (event: React.PointerEvent<HTMLDivElement>) => {
45
+ const container = event.currentTarget.offsetParent;
46
+ onWidthChange(
47
+ clampSidebarWidth(event.clientX - (container?.getBoundingClientRect().left ?? 0)),
48
+ );
49
+ };
50
+ const stop = (event: React.PointerEvent<HTMLDivElement>) => {
51
+ if (event.currentTarget.hasPointerCapture(event.pointerId))
52
+ event.currentTarget.releasePointerCapture(event.pointerId);
53
+ setDragging(false);
54
+ };
55
+ return (
56
+ <div
57
+ data-slot="sidebar-resize-handle"
58
+ data-dragging={dragging || undefined}
59
+ role="separator"
60
+ aria-label="Resize sidebar"
61
+ aria-orientation="vertical"
62
+ aria-valuemin={SIDEBAR_MIN_WIDTH}
63
+ aria-valuemax={sidebarMaxWidth()}
64
+ aria-valuenow={width}
65
+ tabIndex={0}
66
+ className={cn(
67
+ "absolute inset-y-0 z-20 w-2 cursor-col-resize touch-none outline-none",
68
+ // The 2px line: on hover and keyboard focus, stronger while dragging.
69
+ "after:absolute after:inset-y-0 after:left-[2px] after:w-[4px] after:bg-transparent after:transition-colors after:duration-100",
70
+ "hover:after:bg-border focus-visible:after:bg-border data-[dragging]:after:bg-muted/40",
71
+ className,
72
+ )}
73
+ // Centred on the sidebar's right border (the aside's, 1px past `width`).
74
+ style={{ left: width - 3, ...style }}
75
+ onDoubleClick={() => onWidthChange(clampSidebarWidth(SIDEBAR_DEFAULT_WIDTH))}
76
+ onKeyDown={(event) => {
77
+ if (event.key !== "ArrowLeft" && event.key !== "ArrowRight") return;
78
+ event.preventDefault();
79
+ onWidthChange(clampSidebarWidth(width + (event.key === "ArrowLeft" ? -8 : 8)));
80
+ }}
81
+ onPointerDown={(event) => {
82
+ event.preventDefault();
83
+ event.currentTarget.setPointerCapture(event.pointerId);
84
+ setDragging(true);
85
+ }}
86
+ onPointerMove={(event) => {
87
+ if (event.currentTarget.hasPointerCapture(event.pointerId)) fromPointer(event);
88
+ }}
89
+ onPointerUp={(event) => {
90
+ if (event.currentTarget.hasPointerCapture(event.pointerId)) fromPointer(event);
91
+ stop(event);
92
+ }}
93
+ onPointerCancel={stop}
94
+ onLostPointerCapture={() => setDragging(false)}
95
+ {...props}
96
+ />
97
+ );
98
+ }
99
+
100
+ export { SidebarResizeHandle, SIDEBAR_MIN_WIDTH, SIDEBAR_DEFAULT_WIDTH, clampSidebarWidth };
101
+ export type { SidebarResizeHandleProps };
@@ -0,0 +1,325 @@
1
+ import * as React from "react";
2
+
3
+ import { cn } from "../../../lib/utils";
4
+ import { SidebarChevron, SidebarCollapse, SidebarTrailing, renders } from "./sidebar-group";
5
+ import { sidebarItemVariants } from "./sidebar-item";
6
+
7
+ // --- SidebarTree ---
8
+
9
+ /** The rows of `tree` a user can reach: none inside a closed SidebarCollapse (it is inert). */
10
+ const visibleItems = (tree: Element) =>
11
+ [...tree.querySelectorAll<HTMLElement>('[role="treeitem"]')].filter(
12
+ (item) => !item.closest("[inert]"),
13
+ );
14
+
15
+ const TreeVariant = React.createContext<"default" | "navigation">("default");
16
+ const TreeIndent = React.createContext(12);
17
+ /** The depth of the row whose `guide` ties these children to it; none when it draws no guide. */
18
+ const GuidedBy = React.createContext<number | undefined>(undefined);
19
+
20
+ interface SidebarTreeProps extends React.ComponentProps<"div"> {
21
+ /** Navigation: rows of text (after their icon, when given), permanent chevrons on the right, and hierarchy guides. */
22
+ variant?: "default" | "navigation";
23
+ /** The indent of a level, 12px by default (wider for a phone's larger icons). */
24
+ indent?: number;
25
+ }
26
+
27
+ /** A navigation tree of SidebarTreeItem rows (`role="tree"`; name it with `aria-label`) with one tab
28
+ * stop: the row last focused, else the active one (a new active row takes the stop), else the first
29
+ * row shown. The rows handle the arrow keys. */
30
+ function SidebarTree({ className, variant = "default", indent = 12, ...props }: SidebarTreeProps) {
31
+ const ref = React.useRef<HTMLDivElement>(null);
32
+ const focused = React.useRef<Element | null>(null);
33
+ const active = React.useRef<Element | null>(null);
34
+ // Tab stops set on the DOM, never by React: a render leaves them alone.
35
+ const rove = () => {
36
+ const tree = ref.current;
37
+ if (!tree) return;
38
+ const current = tree.querySelector('[role="treeitem"][aria-current]');
39
+ if (current !== active.current) {
40
+ active.current = current;
41
+ if (current) focused.current = current;
42
+ }
43
+ const shown = visibleItems(tree);
44
+ const stop =
45
+ shown.find((item) => item === focused.current) ??
46
+ shown.find((item) => item === current) ??
47
+ shown[0];
48
+ for (const item of tree.querySelectorAll<HTMLElement>('[role="treeitem"]'))
49
+ item.tabIndex = item === stop ? 0 : -1;
50
+ };
51
+ React.useLayoutEffect(rove);
52
+ return (
53
+ <TreeVariant.Provider value={variant}>
54
+ <TreeIndent.Provider value={indent}>
55
+ <div
56
+ data-slot="sidebar-tree"
57
+ data-variant={variant}
58
+ role="tree"
59
+ className={cn("flex flex-col gap-px", className)}
60
+ {...props}
61
+ ref={ref}
62
+ onFocus={(event) => {
63
+ props.onFocus?.(event);
64
+ if (event.target.getAttribute("role") !== "treeitem") return;
65
+ focused.current = event.target;
66
+ rove();
67
+ }}
68
+ />
69
+ </TreeIndent.Provider>
70
+ </TreeVariant.Provider>
71
+ );
72
+ }
73
+
74
+ // --- SidebarTreeItem ---
75
+
76
+ interface SidebarTreeItemProps extends Omit<React.ComponentProps<"div">, "onSelect"> {
77
+ /** The item's title; also names its toggle ("Toggle <label>"). */
78
+ label: string;
79
+ /** Shown before the label. With children, the chevron takes its place on hover and keyboard focus,
80
+ * and always where nothing can hover (touch screens). */
81
+ icon?: React.ReactNode;
82
+ /** Nesting level, 0 at the top; 12px of indent a level (the tree's `indent`). */
83
+ depth?: number;
84
+ active?: boolean | undefined;
85
+ /** Set when the item has children: whether they show. Leave undefined for a leaf. */
86
+ expanded?: boolean | undefined;
87
+ onExpandedChange?: (expanded: boolean) => void;
88
+ /** Clicking the row anywhere but the toggle, or Enter/Space on the focused item: the item itself
89
+ * is selectable, children or not. */
90
+ onSelect?: () => void;
91
+ /** Shown at the right end, outside the label (a count, a status icon): the item's description.
92
+ * Non-interactive: it sits in the clickable row. */
93
+ trailing?: React.ReactNode;
94
+ /** The children rows (SidebarTreeItems at `depth + 1`), in a `group` that opens and closes with `expanded`. */
95
+ children?: React.ReactNode;
96
+ /** Lines from this row's icon to each of its children (a branch into each, rounded on the last), saying they belong
97
+ * to it (without it, the `navigation` variant draws a straight line of its own). */
98
+ guide?: boolean;
99
+ }
100
+
101
+ /** One `treeitem` of a SidebarTree: its row (the icon or, with children, a toggle; the label) and its
102
+ * children rows. The item is the focus target (the row's two buttons are for the mouse only):
103
+ * Up/Down move across the rows shown, Home/End to the first/last, Right opens or moves to the first
104
+ * child, Left closes or moves to the parent, Enter/Space select as a row click does. */
105
+ function SidebarTreeItem({
106
+ className,
107
+ style,
108
+ label,
109
+ icon,
110
+ depth = 0,
111
+ active = false,
112
+ expanded,
113
+ onExpandedChange,
114
+ onSelect,
115
+ onClick,
116
+ trailing,
117
+ children,
118
+ guide = false,
119
+ ...props
120
+ }: SidebarTreeItemProps) {
121
+ const navigation = React.useContext(TreeVariant) === "navigation";
122
+ const guidedBy = React.useContext(GuidedBy);
123
+ const step = React.useContext(TreeIndent);
124
+ /** Where the parent's guide runs: under its icon, a little left of its middle, so each branch shows. */
125
+ // In `navigation` (its chevrons on the right), centred under the icon: nothing there for the branches to show past.
126
+ const guideX = guidedBy === undefined ? 0 : 6 + step * guidedBy + (navigation ? 7.5 : 5.5);
127
+ const iconBox = "size-4 flex items-center justify-center shrink-0 text-muted";
128
+ const labelId = React.useId();
129
+ const trailingId = React.useId();
130
+ const end = renders(trailing);
131
+ const item = React.useRef<HTMLDivElement>(null);
132
+ const onKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
133
+ if (event.target !== event.currentTarget) return; // a descendant item's key
134
+ const tree = event.currentTarget.closest('[role="tree"]');
135
+ const shown = tree ? visibleItems(tree) : [event.currentTarget];
136
+ const at = shown.indexOf(event.currentTarget);
137
+ const focus = (to: HTMLElement | null | undefined) => to?.focus();
138
+ switch (event.key) {
139
+ case "ArrowDown":
140
+ focus(shown[at + 1]);
141
+ break;
142
+ case "ArrowUp":
143
+ focus(shown[at - 1]);
144
+ break;
145
+ case "Home":
146
+ focus(shown[0]);
147
+ break;
148
+ case "End":
149
+ focus(shown.at(-1));
150
+ break;
151
+ // Open, the next row shown is its first child.
152
+ case "ArrowRight":
153
+ if (expanded === false) onExpandedChange?.(true);
154
+ else if (expanded) focus(shown[at + 1]);
155
+ break;
156
+ case "ArrowLeft":
157
+ if (expanded) onExpandedChange?.(false);
158
+ else focus(event.currentTarget.parentElement?.closest<HTMLElement>('[role="treeitem"]'));
159
+ break;
160
+ case "Enter":
161
+ case " ":
162
+ onSelect?.();
163
+ break;
164
+ default:
165
+ return;
166
+ }
167
+ event.preventDefault();
168
+ };
169
+ return (
170
+ <div
171
+ ref={item}
172
+ data-slot="sidebar-tree-node"
173
+ role="treeitem"
174
+ // Named by its label (not the toggle's "Toggle …", nor the children's), described by its trailing content.
175
+ aria-labelledby={labelId}
176
+ aria-describedby={end ? trailingId : undefined}
177
+ aria-level={depth + 1}
178
+ aria-expanded={expanded}
179
+ aria-current={active ? "page" : undefined}
180
+ className={cn(
181
+ "outline-none [&:focus-visible>[data-slot=sidebar-tree-item]]:ring-2 [&:focus-visible>[data-slot=sidebar-tree-item]]:ring-accent [&:focus-visible>[data-slot=sidebar-tree-item]]:ring-inset",
182
+ guidedBy !== undefined && "group/guided relative",
183
+ )}
184
+ onKeyDown={onKeyDown}
185
+ >
186
+ {guidedBy !== undefined && (
187
+ <>
188
+ {/* The parent's guide past this row, down to the next sibling; none after the last. */}
189
+ <span
190
+ data-slot="sidebar-tree-guide"
191
+ aria-hidden="true"
192
+ className="pointer-events-none absolute top-0 bottom-0 border-l border-border group-first/guided:-top-1.5 group-last/guided:hidden"
193
+ style={{ left: guideX }}
194
+ />
195
+ {/* Its branch: down to this row's middle, then into it; rounded on the last. */}
196
+ <span
197
+ data-slot="sidebar-tree-branch"
198
+ aria-hidden="true"
199
+ // The first starts under the parent's icon.
200
+ className="pointer-events-none absolute top-0 h-[calc(var(--height-md)/2)] border-b border-l border-border group-first/guided:-top-1.5 group-first/guided:h-[calc(var(--height-md)/2+6px)] group-last/guided:rounded-bl-[4px]"
201
+ style={{ left: guideX, width: 6 + step * depth - guideX - 0.5 }}
202
+ />
203
+ </>
204
+ )}
205
+ <div
206
+ data-slot="sidebar-tree-item"
207
+ data-variant={navigation ? "navigation" : "default"}
208
+ className={cn(
209
+ sidebarItemVariants({ active }),
210
+ "group/tree-item cursor-default",
211
+ navigation && "h-9 rounded-control",
212
+ className,
213
+ )}
214
+ // 6px (the item rail) plus 12px a level: every level shows, four fit the 220px sidebar.
215
+ style={{ paddingLeft: 6 + step * depth, ...style }}
216
+ {...props}
217
+ // A press anywhere on the row focuses the item, not a button: the arrow keys work from there.
218
+ // Without scrolling: the row moving under the pointer would lose the click. In a draggable row (a navigator
219
+ // that moves nodes by dragging them) the press is left to the browser, which starts the drag from it.
220
+ // Without the focus ring: a scripted focus would take `:focus-visible` from the previous focus (a text
221
+ // field, another row), so a click would draw the keyboard ring (#187).
222
+ onMouseDown={(event) => {
223
+ props.onMouseDown?.(event);
224
+ if (!event.currentTarget.closest('[draggable="true"]')) event.preventDefault();
225
+ item.current?.focus({ preventScroll: true, focusVisible: false });
226
+ }}
227
+ // The label button bubbles here too, so a click on it counts once. A consumer's `onClick` runs
228
+ // first and can keep the selection from happening with `preventDefault()`.
229
+ onClick={(event) => {
230
+ // In a draggable row the browser's own press moved the focus elsewhere: back on the item, ring-less.
231
+ if (event.currentTarget.closest('[draggable="true"]'))
232
+ item.current?.focus({ preventScroll: true, focusVisible: false });
233
+ onClick?.(event);
234
+ if (!event.defaultPrevented) onSelect?.();
235
+ }}
236
+ >
237
+ {!navigation &&
238
+ (expanded === undefined ? (
239
+ <span data-slot="sidebar-item-icon" className={iconBox}>
240
+ {icon}
241
+ </span>
242
+ ) : (
243
+ <button
244
+ type="button"
245
+ tabIndex={-1}
246
+ data-slot="sidebar-tree-toggle"
247
+ className={cn(iconBox, "rounded-sm cursor-pointer hover:text-foreground")}
248
+ aria-label={`Toggle ${label}`}
249
+ onClick={(event) => {
250
+ event.stopPropagation(); // toggling only, not selecting
251
+ onExpandedChange?.(!expanded);
252
+ }}
253
+ >
254
+ <span
255
+ data-slot="sidebar-item-icon"
256
+ // On hover, on the item's own keyboard focus (not a descendant item's), and on touch screens.
257
+ className="flex group-hover/tree-item:hidden [:focus-visible>[data-slot=sidebar-tree-item]_&]:hidden [@media(hover:none)]:hidden"
258
+ >
259
+ {icon}
260
+ </span>
261
+ <span
262
+ data-slot="expand-toggle"
263
+ className="hidden group-hover/tree-item:flex [:focus-visible>[data-slot=sidebar-tree-item]_&]:flex [@media(hover:none)]:flex"
264
+ >
265
+ <SidebarChevron expanded={expanded} />
266
+ </span>
267
+ </button>
268
+ ))}
269
+ {navigation && icon !== undefined && (
270
+ <span data-slot="sidebar-item-icon" className={iconBox}>
271
+ {icon}
272
+ </span>
273
+ )}
274
+ <button
275
+ id={labelId}
276
+ type="button"
277
+ tabIndex={-1}
278
+ data-slot="sidebar-tree-label"
279
+ className="min-w-0 flex-1 truncate text-left cursor-pointer"
280
+ >
281
+ {label}
282
+ </button>
283
+ {end && <SidebarTrailing id={trailingId}>{trailing}</SidebarTrailing>}
284
+ {/* A leaf keeps the chevron's place: every row's trailing content in one column. */}
285
+ {navigation && expanded === undefined && <span aria-hidden="true" className={iconBox} />}
286
+ {navigation && expanded !== undefined && (
287
+ <button
288
+ type="button"
289
+ tabIndex={-1}
290
+ data-slot="sidebar-tree-toggle"
291
+ className={cn(iconBox, "rounded-sm cursor-pointer hover:text-foreground")}
292
+ aria-label={`Toggle ${label}`}
293
+ onClick={(event) => {
294
+ event.stopPropagation();
295
+ onExpandedChange?.(!expanded);
296
+ }}
297
+ >
298
+ <SidebarChevron expanded={expanded} />
299
+ </button>
300
+ )}
301
+ </div>
302
+ {children !== undefined && expanded !== undefined && (
303
+ <SidebarCollapse
304
+ role="group"
305
+ open={expanded}
306
+ className={navigation ? "relative" : undefined}
307
+ >
308
+ {navigation && !guide && (
309
+ <span
310
+ data-slot="sidebar-tree-guide"
311
+ aria-hidden="true"
312
+ className="absolute inset-y-0 border-l border-border pointer-events-none"
313
+ // Under the row's text, or the middle of its icon when it has one (its 16px box, less half the line).
314
+ style={{ left: 6 + step * depth + (icon === undefined ? 0 : 7.5) }}
315
+ />
316
+ )}
317
+ <GuidedBy.Provider value={guide ? depth : undefined}>{children}</GuidedBy.Provider>
318
+ </SidebarCollapse>
319
+ )}
320
+ </div>
321
+ );
322
+ }
323
+
324
+ export { SidebarTree, SidebarTreeItem };
325
+ export type { SidebarTreeProps, SidebarTreeItemProps };
@@ -0,0 +1,126 @@
1
+ name: Sidebar
2
+ description: "Full-height primary navigation with treeview support, collapsible sections, team indicators, and badge counts. 220px wide unless `--sidebar-width` says otherwise (SidebarResizeHandle). In a constrained-height parent such as AppShell, SidebarContent scrolls independently while SidebarFooter stays pinned."
3
+ layer: shell
4
+ category: navigation
5
+ when_to_use:
6
+ - "For primary app navigation with hierarchical sections"
7
+ - "For sidebar menus with collapsible groups and team indicators"
8
+ - "For navigation items with icons, counts, and active state"
9
+ when_not_to_use:
10
+ - "For secondary navigation — use Tabs or Breadcrumb"
11
+ - "For contextual menus — use DropdownMenu"
12
+ - "For mobile-only navigation — Sidebar is desktop-first, 220px by default"
13
+ composition_partners:
14
+ - AppShell (as sidebar prop)
15
+ - Badge (rendered via count prop on SidebarItem)
16
+ - Avatar (as icon in SidebarItem)
17
+ props:
18
+ - name: active
19
+ type: boolean
20
+ required: false
21
+ default: "false"
22
+ description: "Whether the sidebar item is currently active (SidebarItem only)"
23
+ - name: render
24
+ type: "ReactElement | (props, state) => ReactElement"
25
+ required: false
26
+ description: "Replace the rendered element for router link integration, e.g. render={<Link to=… />} (SidebarItem only). NOTE: render replaces the item's internal layout — icon, count and teamDot are ignored; provide your own children."
27
+ - name: icon
28
+ type: React.ReactNode
29
+ required: false
30
+ description: "Icon displayed before the label (SidebarItem only)"
31
+ - name: count
32
+ type: number
33
+ required: false
34
+ description: "Count displayed as Badge on the right (SidebarItem only)"
35
+ - name: teamDot
36
+ type: string
37
+ required: false
38
+ description: "Hex color for team dot indicator (SidebarItem and SidebarGroupTrigger)"
39
+ - name: defaultExpanded
40
+ type: boolean
41
+ required: false
42
+ default: "true"
43
+ description: "Initial expanded state for uncontrolled groups (SidebarGroup only)"
44
+ - name: expanded
45
+ type: boolean
46
+ required: false
47
+ description: "Controlled expanded state (SidebarGroup only)"
48
+ - name: onExpandedChange
49
+ type: "(expanded: boolean) => void"
50
+ required: false
51
+ description: "Callback when group expanded state changes (SidebarGroup only)"
52
+ - name: variant
53
+ type: "'group' | 'section'"
54
+ required: false
55
+ default: "'group'"
56
+ description: "`section`: a collapsible SidebarSection, the small caps label with the chevron on the right (SidebarGroupTrigger only)"
57
+ - name: label
58
+ type: string
59
+ required: true
60
+ description: 'The row''s title; also names its toggle, "Toggle <label>" (SidebarTreeItem only)'
61
+ - name: depth
62
+ type: number
63
+ required: false
64
+ default: "0"
65
+ description: "Nesting level; indents 12px a level, or the tree's `indent` (SidebarTreeItem only)"
66
+ - name: indent
67
+ type: number
68
+ required: false
69
+ default: "12"
70
+ description: "The indent of a level, in px: wider for a phone's larger icons (SidebarTree only)"
71
+ - name: variant (SidebarTree)
72
+ type: "'default' | 'navigation'"
73
+ required: false
74
+ default: "'default'"
75
+ description: "`navigation`: rows of text after their icon (when given), the chevron always on the right, a leaf keeping its place so every row's trailing content stays in one column, and hierarchy guides (SidebarTree only)"
76
+ - name: guide
77
+ type: boolean
78
+ required: false
79
+ default: "false"
80
+ description: "Lines from the row's icon to each of its children, a branch into each, rounded on the last: they belong to it and go with it (SidebarTreeItem only; without it, a `navigation` tree draws a straight line of its own; with it, its branches start under the middle of the row's icon)"
81
+ - name: onSelect
82
+ type: "() => void"
83
+ required: false
84
+ description: "Clicking the row anywhere but the toggle, or Enter/Space on the focused item (SidebarTreeItem only)"
85
+ - name: trailing
86
+ type: React.ReactNode
87
+ required: false
88
+ description: "Shown at the right end: outside the label (SidebarTreeItem), before a section's chevron (SidebarGroupTrigger); the description (`aria-describedby`) of the tree item or the trigger, never part of its name. Non-interactive only: it sits in a clickable row or inside a button (no links, no buttons). Generic: a Badge count, a spinning `loader-circle` Icon with a label"
89
+ props_priority:
90
+ - active
91
+ - icon
92
+ - count
93
+ - render
94
+ - teamDot
95
+ examples:
96
+ - title: "Complete sidebar"
97
+ code: |
98
+ import { Inbox, Eye } from 'lucide-react';
99
+
100
+ <Sidebar>
101
+ <SidebarItem icon={<Inbox size={16} />} count={12} active>
102
+ Inbox
103
+ </SidebarItem>
104
+ <SidebarItem icon={<Eye size={16} />}>My Issues</SidebarItem>
105
+ <SidebarSection>Your Teams</SidebarSection>
106
+ <SidebarGroup>
107
+ <SidebarGroupTrigger teamDot="#e08a20">
108
+ Engineering
109
+ </SidebarGroupTrigger>
110
+ <SidebarGroupContent>
111
+ <SidebarItem>Active</SidebarItem>
112
+ <SidebarItem>Backlog</SidebarItem>
113
+ </SidebarGroupContent>
114
+ </SidebarGroup>
115
+ </Sidebar>
116
+ anti_patterns:
117
+ - "Don't override the width with classes — set `--sidebar-width` (as SidebarResizeHandle's owner does); 220px is the default"
118
+ - "Don't nest SidebarGroups — only one level of grouping is supported; for a tree use SidebarTreeItem rows"
119
+ - "Don't use SidebarGroupTrigger/SidebarGroupContent outside SidebarGroup — they depend on context"
120
+ - "Don't use a static SidebarSection for a collection users expect to collapse — wrap its trigger and items in SidebarGroup"
121
+ - "Don't add padding or margin to Sidebar children — spacing is handled by the component"
122
+ accessibility_notes: 'Sidebar renders as <nav>. SidebarGroupTrigger uses aria-expanded. SidebarTree is a `tree` (name it with aria-label) with one tab stop (roving tabindex: the item last focused, else the active one, else the first shown). SidebarTreeItem is a `treeitem` named by its label, with aria-level, aria-expanded (with children), aria-current="page" when active, its trailing content as description, and its children rows in a `group` inside it; keys on the focused item: Up/Down, Home/End, Right opens or enters, Left closes or goes up, Enter/Space select. Its toggle and label buttons are for the mouse (tabindex -1); a press on the row focuses the item. SidebarItem renders as <button> (or a custom element via the render prop). Keyboard: Tab navigation between items, Enter/Space to activate.'
123
+ notes: "Sub-components: Sidebar (full-height nav container; its parent must establish a height), SidebarContent (flexible scroll area), SidebarHeader (brand/app header — use as first child of SidebarContent when the app has no global AppShell header; px-1.5 aligns the brand icon to the item rail), SidebarSection (static uppercase label), SidebarItem (interactive item with icon/count/teamDot), SidebarFooter (pinned bottom area), SidebarGroup (collapsible collection), SidebarGroupTrigger (expand/collapse toggle), SidebarGroupContent (collapsible content area), SidebarResizeHandle (8px separator on the sidebar's right edge: drag, ArrowLeft/Right 8px, double-click resets to 220px; 190px to half the viewport; its owner stores the width and sets `--sidebar-width`), SidebarCollapse (animated open/close; closed content stays mounted but inert, aria-hidden, invisible; SidebarGroupContent and SidebarTreeItem use it), SidebarTree (the `tree` holding SidebarTreeItems, one tab stop), SidebarTreeItem (a tree item: its row, icon or, with children, a toggle whose chevron replaces the icon on hover and keyboard focus, and the label; its children rows, at depth + 1, as its children)."
124
+ related_patterns:
125
+ - list-view
126
+ - crud-page