@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,261 @@
1
+ // research-049: the sizes a user dragged kept per workspace in their profile, for MultiPane and SplitView. Only a
2
+ // gesture on the edge is kept (a layout change at mount, from a narrow window or a programmatic one is not); the kept
3
+ // sizes come back when the box grows again; another tab's write (or reset) is applied to the open group; a
4
+ // double-click forgets the workspace's sizes and brings the starting ones back.
5
+ import * as React from "react";
6
+ import { isRecord } from "../../../lib/json.ts";
7
+
8
+ import { currentWorkspace, profile, type WorkspaceRef } from "../../../profile/profile";
9
+ import { useGroupRef } from "./resizable";
10
+
11
+ /** A group's layout: each panel's id to its percentage. */
12
+ export type PaneLayout = Record<string, number>;
13
+
14
+ /** A pane's id and starting size (`"280px"`, `"25%"`; none: a share of what the sized panes leave). */
15
+ export interface PaneStart {
16
+ id: string;
17
+ size?: string | undefined;
18
+ }
19
+
20
+ const isPaneLayout = (value: unknown): value is PaneLayout =>
21
+ isRecord(value) &&
22
+ Object.keys(value).length > 0 &&
23
+ Object.values(value).every((size) => typeof size === "number" && Number.isFinite(size));
24
+
25
+ /** The starting layout in percentages: px over the group's `length`, %, the rest shared by the unsized panes. The
26
+ * library reads a string given to a panel's `resize` as a percentage, so px are converted here. */
27
+ export function startingLayout(panes: PaneStart[], length: number): PaneLayout {
28
+ const sized = panes.map(({ size }) => {
29
+ const text = size?.trim() ?? "";
30
+ const value = parseFloat(text);
31
+ if (!Number.isFinite(value)) return undefined;
32
+ if (text.endsWith("px")) return length > 0 ? (value / length) * 100 : undefined;
33
+ return text.endsWith("%") ? value : undefined;
34
+ });
35
+ const taken = sized.reduce<number>((sum, size) => sum + (size ?? 0), 0);
36
+ const free = sized.filter((size) => size === undefined).length;
37
+ const share = free > 0 ? Math.max(0, 100 - taken) / free : 0;
38
+ const layout = Object.fromEntries(panes.map(({ id }, i) => [id, sized[i] ?? share]));
39
+ const total = Object.values(layout).reduce((sum, size) => sum + size, 0);
40
+ return total > 0 && Math.abs(total - 100) > 0.01
41
+ ? Object.fromEntries(Object.entries(layout).map(([id, size]) => [id, (size / total) * 100]))
42
+ : layout;
43
+ }
44
+
45
+ export interface RememberedLayout {
46
+ /** The sizes kept for this workspace: the group's starting layout; `undefined` without a key or a workspace. */
47
+ defaultLayout: PaneLayout | undefined;
48
+ /** The group's handle, to apply kept sizes after mount. */
49
+ groupRef: ReturnType<typeof useGroupRef>;
50
+ /** The group's element: its size, for the starting layout; its growing brings the kept sizes back. */
51
+ elementRef: React.RefObject<HTMLDivElement | null>;
52
+ /** The library's moves: tells a drag from a box that shrank. */
53
+ onLayoutChange: () => void;
54
+ /** Keeps `layout` after a drag or a key on the edge. */
55
+ onLayoutChanged: (layout: PaneLayout) => void;
56
+ /** The edge's double-click: forgets the workspace's sizes and brings the starting ones back. */
57
+ forget: () => void;
58
+ }
59
+
60
+ /** The page's workspace now, the same object while it does not change (the path may change without a remount). */
61
+ function useWorkspace(): WorkspaceRef | undefined {
62
+ const now = currentWorkspace();
63
+ const id = now && `${now.bridgeId}:${now.slug}`;
64
+ const ref = React.useRef<{ id: string | undefined; workspace: WorkspaceRef | undefined }>({
65
+ id,
66
+ workspace: now,
67
+ });
68
+ if (ref.current.id !== id) ref.current = { id, workspace: now };
69
+ return ref.current.workspace;
70
+ }
71
+
72
+ /** A group's sizes remembered per workspace under `storageKey` (none: nothing is read or kept); `starts` gives its
73
+ * panes' ids and starting sizes, `orientation` which side of its box they share. */
74
+ export function useRememberedLayout(
75
+ storageKey: string | undefined,
76
+ starts: () => PaneStart[],
77
+ orientation: "horizontal" | "vertical" = "horizontal",
78
+ /** Whether the layout may be kept now (SplitView: every pane named, a generated id changes at a remount). */
79
+ canKeep?: () => boolean,
80
+ ): RememberedLayout {
81
+ const workspace = useWorkspace();
82
+ const groupRef = useGroupRef();
83
+ const elementRef = React.useRef<HTMLDivElement | null>(null);
84
+ /** A change came while a gesture went on: followed once it ends. */
85
+ const missed = React.useRef(false);
86
+ const startsRef = React.useRef(starts);
87
+ startsRef.current = starts;
88
+
89
+ const kept = React.useCallback((): PaneLayout | undefined => {
90
+ if (storageKey === undefined || workspace === undefined) return undefined;
91
+ const value = profile.get("pane-sizes", storageKey, { workspace });
92
+ if (!isPaneLayout(value)) return undefined;
93
+ // Sizes kept for other panes (MultiPane's aside left out on a narrower box, a pane renamed) are not this group's.
94
+ const ids = startsRef.current().map(({ id }) => id);
95
+ const fits =
96
+ ids.length === 0 ||
97
+ (ids.length === Object.keys(value).length && ids.every((id) => id in value));
98
+ return fits ? value : undefined;
99
+ }, [storageKey, workspace]);
100
+
101
+ // What the group starts from when it mounts (the library reads it then only; a group mounted again, MultiPane back
102
+ // from `mode="main"`, starts from what is kept now). Later changes go through `setLayout`.
103
+ const keptNow = kept();
104
+ const keptText = JSON.stringify(keptNow);
105
+ const defaultLayout = React.useMemo(() => keptNow, [keptText]);
106
+
107
+ const restore = React.useCallback(() => {
108
+ const box = elementRef.current?.getBoundingClientRect();
109
+ const length = box ? (orientation === "horizontal" ? box.width : box.height) : 0;
110
+ const layout = startingLayout(startsRef.current(), length);
111
+ if (Object.keys(layout).length > 0) groupRef.current?.setLayout(layout);
112
+ }, [groupRef, orientation]);
113
+
114
+ /** What is shown follows what is kept (another workspace, another tab's write or reset). */
115
+ const shown = React.useRef<string | undefined>(JSON.stringify(defaultLayout));
116
+ const follow = React.useCallback(() => {
117
+ if (storageKey === undefined || workspace === undefined) return;
118
+ if (pointer.current.down || key.current) {
119
+ missed.current = true;
120
+ return;
121
+ }
122
+ const layout = kept();
123
+ const next = JSON.stringify(layout);
124
+ if (next === shown.current) return;
125
+ shown.current = next;
126
+ if (layout) groupRef.current?.setLayout(layout);
127
+ else restore();
128
+ }, [storageKey, workspace, kept, groupRef, restore]);
129
+ const followRef = React.useRef(follow);
130
+ followRef.current = follow;
131
+
132
+ /** A pointer is down (anywhere: the library's hit area is wider than the edge), and it moved. */
133
+ const pointer = React.useRef({ down: false, moved: false });
134
+ /** This group's layout moved while a pointer moved: a drag, kept when it ends. */
135
+ const dragged = React.useRef(false);
136
+ /** A key on this group's edge is being handled (the library moves the edge in that event). */
137
+ const key = React.useRef(false);
138
+ /** The pointer's and the key's own ends: neither cancels the other's. */
139
+ const pointerEnd = React.useRef<ReturnType<typeof setTimeout>>(undefined);
140
+ const keyEnd = React.useRef<ReturnType<typeof setTimeout>>(undefined);
141
+
142
+ React.useEffect(() => {
143
+ if (storageKey === undefined || workspace === undefined) return;
144
+ /** Once the event that ends a gesture is handled (the library keeps the layout in it), what came meanwhile. */
145
+ const after = (timer: typeof pointerEnd, done: () => void) => {
146
+ clearTimeout(timer.current);
147
+ timer.current = setTimeout(() => {
148
+ done();
149
+ if (!pointer.current.down && !key.current && missed.current) {
150
+ missed.current = false;
151
+ followRef.current();
152
+ }
153
+ }, 0);
154
+ };
155
+ const down = () => {
156
+ clearTimeout(pointerEnd.current);
157
+ pointer.current = { down: true, moved: false };
158
+ dragged.current = false;
159
+ };
160
+ const move = () => {
161
+ if (pointer.current.down) pointer.current.moved = true;
162
+ };
163
+ const up = () => {
164
+ if (!pointer.current.down) return;
165
+ after(pointerEnd, () => {
166
+ pointer.current = { down: false, moved: false };
167
+ dragged.current = false;
168
+ });
169
+ };
170
+ const press = (event: KeyboardEvent) => {
171
+ if (!(event.target instanceof Node) || !elementRef.current?.contains(event.target)) return;
172
+ if (
173
+ !(event.target instanceof Element) ||
174
+ !event.target.closest('[data-slot="resizable-handle"]')
175
+ )
176
+ return;
177
+ key.current = true;
178
+ after(keyEnd, () => {
179
+ key.current = false;
180
+ });
181
+ };
182
+ window.addEventListener("pointerdown", down, true);
183
+ window.addEventListener("pointermove", move, true);
184
+ window.addEventListener("pointerup", up, true);
185
+ window.addEventListener("pointercancel", up, true);
186
+ window.addEventListener("keydown", press, true);
187
+ return () => {
188
+ clearTimeout(pointerEnd.current);
189
+ clearTimeout(keyEnd.current);
190
+ window.removeEventListener("pointerdown", down, true);
191
+ window.removeEventListener("pointermove", move, true);
192
+ window.removeEventListener("pointerup", up, true);
193
+ window.removeEventListener("pointercancel", up, true);
194
+ window.removeEventListener("keydown", press, true);
195
+ };
196
+ }, [storageKey, workspace]);
197
+
198
+ /** The library's every move: a drag when a pointer moved and the library holds one of this group's own edges (a box
199
+ * shrinking under a still pointer, a pointer the library ignores, a nested group's edge are not). */
200
+ const onLayoutChange = React.useCallback(() => {
201
+ const group = elementRef.current;
202
+ if (!pointer.current.down || !pointer.current.moved || !group) return;
203
+ const held = [...group.querySelectorAll('[data-separator="active"]')].some(
204
+ (edge) => edge.closest("[data-group]") === group,
205
+ );
206
+ if (held) dragged.current = true;
207
+ }, []);
208
+
209
+ const onLayoutChanged = React.useCallback(
210
+ (layout: PaneLayout) => {
211
+ if (storageKey === undefined || workspace === undefined) return;
212
+ if (!dragged.current && !key.current) return;
213
+ if (canKeep && !canKeep()) return;
214
+ // One drag, one layout: what follows its release (a programmatic setLayout) is not this drag.
215
+ dragged.current = false;
216
+ pointer.current.moved = false;
217
+ shown.current = JSON.stringify(layout);
218
+ profile.set("pane-sizes", storageKey, layout, { scope: "workspace", workspace });
219
+ },
220
+ [storageKey, workspace, canKeep],
221
+ );
222
+
223
+ const forget = React.useCallback(() => {
224
+ dragged.current = false;
225
+ key.current = false;
226
+ missed.current = false;
227
+ if (storageKey !== undefined && workspace !== undefined) {
228
+ shown.current = JSON.stringify(undefined);
229
+ profile.reset("pane-sizes", storageKey, { scope: "workspace", workspace });
230
+ }
231
+ restore();
232
+ }, [storageKey, workspace, restore]);
233
+
234
+ React.useEffect(() => {
235
+ if (storageKey === undefined || workspace === undefined) return;
236
+ follow();
237
+ return profile.subscribe(() => followRef.current());
238
+ }, [storageKey, workspace, follow]);
239
+
240
+ // A box that shrank clamped the layout shown, never the kept one: grown again, the kept sizes come back, after the
241
+ // library took the new size (the next frame).
242
+ React.useEffect(() => {
243
+ const element = elementRef.current;
244
+ if (!element || storageKey === undefined || typeof ResizeObserver === "undefined") return;
245
+ let frame = 0;
246
+ const observer = new ResizeObserver(() => {
247
+ cancelAnimationFrame(frame);
248
+ frame = requestAnimationFrame(() => {
249
+ const layout = kept();
250
+ if (layout && !pointer.current.down && !key.current) groupRef.current?.setLayout(layout);
251
+ });
252
+ });
253
+ observer.observe(element);
254
+ return () => {
255
+ cancelAnimationFrame(frame);
256
+ observer.disconnect();
257
+ };
258
+ }, [storageKey, kept, groupRef]);
259
+
260
+ return { defaultLayout, groupRef, elementRef, onLayoutChange, onLayoutChanged, forget };
261
+ }
@@ -0,0 +1,2 @@
1
+ export { ScreenLink, FollowProvider, useFollow, gestureOf } from "./screen-link";
2
+ export type { ScreenLinkProps, Follow, FollowEvent, FollowTarget, Gesture } from "./screen-link";
@@ -0,0 +1,34 @@
1
+ name: ScreenLink
2
+ description: "A link to a screen of the workspace, with a real href, whose clicks follow Bridge's rule (research-048): plain = this window and a history entry, ⌘/Ctrl/middle = a window beside (⌘ again closes it), ⌥ = a window on a new desk; a modified click without a window manager does nothing. `useFollow()` gives the same rule to rows and buttons."
3
+ layer: core
4
+ category: navigation
5
+ when_to_use:
6
+ - "For any text link to a screen, an item of a screen, or a node"
7
+ - "Through `useFollow()`: a row, a button, a toast's action that changes the screen (call `follow(target, event)` from its onClick and onAuxClick)"
8
+ when_not_to_use:
9
+ - "For a link outside Bridge — use a plain <a>"
10
+ - "For opening a modal or a dialog — not a navigation, no history entry"
11
+ composition_partners:
12
+ - Button (render={<ScreenLink to={…} />} for a link drawn as a button)
13
+ - Breadcrumb (its items' `to`)
14
+ - List (records rows follow by default inside RecordsScreen)
15
+ props:
16
+ - name: to
17
+ type: "FollowTarget"
18
+ required: true
19
+ description: "`{ item }`: an item of the screen its window shows (`reuse`: shown in another window of that screen when there is one); `{ node, screen?, item? }`: a view of the workspace."
20
+ props_priority:
21
+ - to
22
+ examples:
23
+ - title: "An item of this screen"
24
+ code: |
25
+ <ScreenLink to={{ item: contact.id }}>{contact.name}</ScreenLink>
26
+ - title: "A row following the rule"
27
+ code: |
28
+ const follow = useFollow();
29
+ <div onClick={(e) => follow?.follow({ item: id }, e)} onAuxClick={(e) => follow?.follow({ item: id }, e)} />
30
+ anti_patterns:
31
+ - "Don't call setScreen or ctx.screen.open from an onClick that ignores the event — use ScreenLink or useFollow"
32
+ - "Don't fall back to the same window on a modified click without a window manager — it does nothing"
33
+ accessibility_notes: "A real <a href>: announced as a link, its context menu (copy, open in a tab) kept. Outside a shell it has no href."
34
+ notes: "The shell provides `FollowProvider` around each window's view; `useFollow()` is null outside one."
@@ -0,0 +1,100 @@
1
+ import * as React from "react";
2
+
3
+ import { cn } from "../../../lib/utils";
4
+
5
+ // One way to follow a link to a screen, everywhere in Bridge (research-048): a plain click shows it in this window (a
6
+ // history entry), ⌘ (Ctrl) or a middle click in a new window beside (⌘ again on what a window shows closes it), ⌥ in a
7
+ // new window on a new desk. Without a window manager, a modified click does nothing. ⇧ is reserved (a floating window).
8
+
9
+ /** What a click asks for: here, beside, on a new desk; `undefined`, nothing to follow (⇧, a right click). */
10
+ type Gesture = "here" | "beside" | "desk";
11
+
12
+ /** The part of a mouse or keyboard event a gesture is read from (a key's Enter: no `button`, a plain click). */
13
+ interface FollowEvent {
14
+ type?: string;
15
+ button?: number;
16
+ metaKey: boolean;
17
+ ctrlKey: boolean;
18
+ altKey: boolean;
19
+ shiftKey: boolean;
20
+ }
21
+
22
+ /** Where a link goes: an item of the screen its window shows (`reuse`: a plain click shows it in another window of
23
+ * that screen when there is one, as `ctx.screen.open`'s hint), or a view of the workspace (a node, a screen there, its
24
+ * item). */
25
+ type FollowTarget =
26
+ | { item?: string; reuse?: boolean }
27
+ | { node: string; screen?: { plugin: string; id: string }; item?: string };
28
+
29
+ /** What the shell provides around each window (`FollowProvider`): follows a target as the event asks, and gives its
30
+ * URL (`undefined`: none yet, the screen tree loading). */
31
+ interface Follow {
32
+ follow: (target: FollowTarget, event: FollowEvent) => void;
33
+ href: (target: FollowTarget) => string | undefined;
34
+ }
35
+
36
+ /** The gesture an event asks for. */
37
+ function gestureOf(event: FollowEvent): Gesture | undefined {
38
+ const button = event.button ?? 0;
39
+ if (event.shiftKey) return undefined;
40
+ if (button === 1) return "beside";
41
+ if (button !== 0) return undefined;
42
+ if (event.altKey) return "desk";
43
+ if (event.metaKey || event.ctrlKey) return "beside";
44
+ return "here";
45
+ }
46
+
47
+ const FollowContext = React.createContext<Follow | null>(null);
48
+
49
+ /** The shell's, around a window's view. */
50
+ function FollowProvider({ value, children }: { value: Follow; children: React.ReactNode }) {
51
+ return <FollowContext.Provider value={value}>{children}</FollowContext.Provider>;
52
+ }
53
+
54
+ /** The shell's `Follow` for the window this renders in; `null` outside a shell (a test, a page of its own). A row or a
55
+ * button calls `follow(target, event)` from its `onClick` (and `onAuxClick`, a middle click), never a screen change of
56
+ * its own that ignores the event. */
57
+ function useFollow(): Follow | null {
58
+ return React.useContext(FollowContext);
59
+ }
60
+
61
+ interface ScreenLinkProps extends Omit<React.ComponentProps<"a">, "href"> {
62
+ /** Where it goes. */
63
+ to: FollowTarget;
64
+ }
65
+
66
+ /** A link to a screen: an anchor with a real `href` (copied, opened in a browser tab from its menu), whose clicks
67
+ * follow Bridge's rule. Outside a shell: an anchor without `href`, its own `onClick` alone. */
68
+ function ScreenLink({ to, className, onClick, onAuxClick, ...props }: ScreenLinkProps) {
69
+ const follow = useFollow();
70
+ const handle = (event: React.MouseEvent<HTMLAnchorElement>) => {
71
+ if (event.defaultPrevented || !follow) return;
72
+ const gesture = gestureOf(event);
73
+ // ⇧: reserved, not the browser's new window either; a right click keeps its menu.
74
+ if (gesture === undefined) {
75
+ if (event.shiftKey) event.preventDefault();
76
+ return;
77
+ }
78
+ event.preventDefault();
79
+ follow.follow(to, event);
80
+ };
81
+ return (
82
+ <a
83
+ data-slot="screen-link"
84
+ href={follow?.href(to)}
85
+ className={cn("text-foreground underline-offset-2 hover:underline cursor-pointer", className)}
86
+ onClick={(event) => {
87
+ onClick?.(event);
88
+ handle(event);
89
+ }}
90
+ onAuxClick={(event) => {
91
+ onAuxClick?.(event);
92
+ if (event.button === 1) handle(event);
93
+ }}
94
+ {...props}
95
+ />
96
+ );
97
+ }
98
+
99
+ export { ScreenLink, FollowProvider, useFollow, gestureOf };
100
+ export type { ScreenLinkProps, Follow, FollowEvent, FollowTarget, Gesture };
@@ -0,0 +1,2 @@
1
+ export { ScrollArea, ScrollAreaScrollbar } from "./scroll-area";
2
+ export type { ScrollAreaProps, ScrollAreaScrollbarProps } from "./scroll-area";
@@ -0,0 +1,72 @@
1
+ name: ScrollArea
2
+ description: "Themed scrollable container with slim, auto-hiding scrollbars built on Base UI ScrollArea. For any region with overflow content."
3
+ layer: core
4
+ category: layout
5
+ when_to_use:
6
+ - "For scrollable Kanban columns, list panels, or dialog bodies"
7
+ - "For any bounded region that needs themed, slim scrollbars instead of browser defaults"
8
+ - "For horizontal scroll containers (Kanban boards, tab overflow)"
9
+ when_not_to_use:
10
+ - "For full-page scroll — let the AppShell main area handle that"
11
+ - "For unbounded content — ScrollArea needs a constrained height or width to scroll"
12
+ composition_partners:
13
+ - Card (scrollable card lists in Kanban columns)
14
+ - List (scrollable list panels)
15
+ - Dialog (scrollable dialog body content)
16
+ - Table (scrollable data tables)
17
+ - Sidebar (could wrap inner content for scroll)
18
+ props:
19
+ - name: orientation
20
+ type: "'vertical' | 'horizontal' | 'both'"
21
+ required: false
22
+ default: "'vertical'"
23
+ description: "Which scrollbar(s) to render"
24
+ - name: className
25
+ type: string
26
+ required: false
27
+ description: "Additional CSS classes on the root element"
28
+ - name: viewportClassName
29
+ type: string
30
+ required: false
31
+ description: "Additional CSS classes on the scroll viewport"
32
+ - name: viewportRef
33
+ type: "React.Ref<HTMLDivElement>"
34
+ required: false
35
+ description: "Ref forwarded to the viewport element for imperative scroll control"
36
+ - name: children
37
+ type: React.ReactNode
38
+ required: false
39
+ description: "Scrollable content"
40
+ props_priority:
41
+ - orientation
42
+ - className
43
+ - viewportClassName
44
+ - viewportRef
45
+ examples:
46
+ - title: "Vertical scroll in a Kanban column"
47
+ code: |
48
+ <div className="flex flex-col h-full">
49
+ <div className="p-3 font-semibold">In Progress</div>
50
+ <ScrollArea className="flex-1">
51
+ <div className="flex flex-col gap-2 p-2">
52
+ <Card>Task 1</Card>
53
+ <Card>Task 2</Card>
54
+ </div>
55
+ </ScrollArea>
56
+ </div>
57
+ - title: "Horizontal scroll for a board"
58
+ code: |
59
+ <ScrollArea orientation="horizontal" className="h-full">
60
+ <div className="flex gap-4 p-4 h-full">
61
+ <Column />
62
+ <Column />
63
+ <Column />
64
+ </div>
65
+ </ScrollArea>
66
+ anti_patterns:
67
+ - "Don't set fixed height on ScrollArea without a parent constraint — it needs a bounded height to scroll"
68
+ - "Don't nest ScrollArea inside another ScrollArea — causes confusing scroll behavior"
69
+ - "Don't use for full-page scroll — let AppShell main area handle that"
70
+ - "Don't override scrollbar thumb styles via className — use the component's token-based styling"
71
+ accessibility_notes: "Built on Base UI ScrollArea. The scrollbar and thumb are plain divs (no role='scrollbar', not keyboard-focusable) — they are a pointer affordance only. Keyboard scrolling works natively through the scrollable viewport (arrow keys / PageUp / PageDown when the viewport or its content has focus)."
72
+ notes: "Sub-components: ScrollArea (root + viewport + content + scrollbars), ScrollAreaScrollbar (individual scrollbar, exported for advanced composition). Thumb uses bg-foreground/15 with hover:bg-foreground/30 for subtle themed appearance. Scrollbar width is 6px (w-1.5). Requires @base-ui/react dependency. Scrollbars fade in while scrolling or hovering (data-scrolling / data-hovering)."
@@ -0,0 +1,95 @@
1
+ import * as React from "react";
2
+ import { ScrollArea as ScrollAreaPrimitive } from "@base-ui/react/scroll-area";
3
+ import { CSPProvider } from "@base-ui/react/csp-provider";
4
+
5
+ import { cn } from "../../../lib/utils";
6
+ import { useCapability } from "../../../kit/kit";
7
+ import { StepButtons } from "./steps";
8
+
9
+ interface ScrollAreaProps extends React.ComponentProps<typeof ScrollAreaPrimitive.Root> {
10
+ orientation?: "vertical" | "horizontal" | "both";
11
+ viewportClassName?: string;
12
+ viewportRef?: React.Ref<HTMLDivElement>;
13
+ }
14
+
15
+ function ScrollArea({
16
+ className,
17
+ orientation = "vertical",
18
+ viewportClassName,
19
+ viewportRef,
20
+ children,
21
+ ...props
22
+ }: ScrollAreaProps) {
23
+ // Bridge: the page's CSP refuses inline <style>; the kit stylesheet carries Base UI's
24
+ // scrollbar-hiding rule (`.base-ui-disable-scrollbar`) instead.
25
+ return (
26
+ <CSPProvider disableStyleElements>
27
+ <ScrollAreaPrimitive.Root
28
+ data-slot="scroll-area"
29
+ className={cn("relative overflow-hidden", className)}
30
+ {...props}
31
+ >
32
+ <ScrollAreaPrimitive.Viewport
33
+ ref={viewportRef}
34
+ data-slot="scroll-area-viewport"
35
+ // Out of the tab order (Base UI's tabIndex -1), focused only by a click on a blank spot: no ring.
36
+ className={cn("h-full w-full rounded-[inherit] outline-none", viewportClassName)}
37
+ >
38
+ <ScrollAreaPrimitive.Content
39
+ data-slot="scroll-area-content"
40
+ // Base UI's content is `min-width: fit-content`: vertical only, a long line would still scroll sideways.
41
+ className={cn(orientation === "vertical" && "min-w-0! w-full")}
42
+ >
43
+ {children}
44
+ </ScrollAreaPrimitive.Content>
45
+ </ScrollAreaPrimitive.Viewport>
46
+ {(orientation === "vertical" || orientation === "both") && (
47
+ <ScrollAreaScrollbar orientation="vertical" />
48
+ )}
49
+ {(orientation === "horizontal" || orientation === "both") && (
50
+ <ScrollAreaScrollbar orientation="horizontal" />
51
+ )}
52
+ <ScrollAreaPrimitive.Corner />
53
+ </ScrollAreaPrimitive.Root>
54
+ </CSPProvider>
55
+ );
56
+ }
57
+
58
+ interface ScrollAreaScrollbarProps extends React.ComponentProps<
59
+ typeof ScrollAreaPrimitive.Scrollbar
60
+ > {}
61
+
62
+ function ScrollAreaScrollbar({
63
+ className,
64
+ orientation = "vertical",
65
+ ...props
66
+ }: ScrollAreaScrollbarProps) {
67
+ const steps = useCapability("scrollArea.stepButtons");
68
+ return (
69
+ <ScrollAreaPrimitive.Scrollbar
70
+ data-slot="scroll-area-scrollbar"
71
+ orientation={orientation}
72
+ className={cn(
73
+ // Above the content's sticky parts (a List's group headers are z-10), which would cover it.
74
+ "z-20 flex touch-none select-none transition-opacity duration-150",
75
+ "opacity-0 data-hovering:opacity-100 data-scrolling:opacity-100 active:opacity-100",
76
+ // A 5px thumb 3px off the edge and the ends (owner, research-070: 4px on the edge too thin, 6px too big). The
77
+ // track itself stands off the edge (a margin, not a padding): the edge stays a resize handle's beside it.
78
+ orientation === "vertical" && "h-full w-[7px] mr-[3px] py-[3px] pl-0.5",
79
+ orientation === "horizontal" && "h-[7px] mb-[3px] flex-col px-[3px] pt-0.5",
80
+ className,
81
+ )}
82
+ {...props}
83
+ >
84
+ <ScrollAreaPrimitive.Thumb
85
+ data-slot="scroll-area-thumb"
86
+ className="relative flex-1 rounded-full bg-foreground/15 hover:bg-foreground/30 transition-colors duration-100"
87
+ />
88
+ {/* After the thumb: turning them on keeps the thumb's element, so a live switch remounts nothing. */}
89
+ {steps && <StepButtons orientation={orientation} />}
90
+ </ScrollAreaPrimitive.Scrollbar>
91
+ );
92
+ }
93
+
94
+ export { ScrollArea, ScrollAreaScrollbar };
95
+ export type { ScrollAreaProps, ScrollAreaScrollbarProps };
@@ -0,0 +1,72 @@
1
+ import * as React from "react";
2
+
3
+ // The kit capability "scrollArea.stepButtons" (kit/kit.tsx): a rendering that turns it on gets a button at each end
4
+ // of the scrollbar, which scrolls by a step, and keeps scrolling while held (`data-pressed` meanwhile: the cancelled
5
+ // pointerdown may keep `:active` off). They are pointer-only, as a native
6
+ // scrollbar's arrows are (the keyboard scrolls the viewport itself); where they sit and how they look is the
7
+ // rendering's (it makes room for them with the scrollbar's padding, which the thumb's maths accounts for).
8
+
9
+ const STEP = 40;
10
+ const DELAY = 300;
11
+ const REPEAT = 50;
12
+
13
+ function StepButton({
14
+ orientation,
15
+ direction,
16
+ }: {
17
+ orientation: "vertical" | "horizontal";
18
+ direction: -1 | 1;
19
+ }) {
20
+ const timer = React.useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
21
+ const [pressed, setPressed] = React.useState(false);
22
+ const stop = () => {
23
+ clearTimeout(timer.current);
24
+ setPressed(false);
25
+ };
26
+ React.useEffect(() => stop, []);
27
+ return (
28
+ <button
29
+ type="button"
30
+ tabIndex={-1}
31
+ aria-hidden="true"
32
+ data-slot="scroll-area-step"
33
+ data-direction={direction < 0 ? "start" : "end"}
34
+ data-pressed={pressed || undefined}
35
+ onPointerDown={(event) => {
36
+ // Not the scrollbar's own pointerdown, which jumps to the pointer; and no focus (a native arrow takes none,
37
+ // and the button is hidden from assistive technology): cancelling it skips the mousedown that would focus.
38
+ event.stopPropagation();
39
+ event.preventDefault();
40
+ if (event.button !== 0) return;
41
+ const viewport = event.currentTarget
42
+ .closest("[data-slot=scroll-area]")
43
+ ?.querySelector<HTMLElement>("[data-slot=scroll-area-viewport]");
44
+ if (!viewport) return;
45
+ setPressed(true);
46
+ const step = () =>
47
+ viewport.scrollBy(
48
+ orientation === "vertical" ? { top: direction * STEP } : { left: direction * STEP },
49
+ );
50
+ step();
51
+ const repeat = () => {
52
+ step();
53
+ timer.current = setTimeout(repeat, REPEAT);
54
+ };
55
+ timer.current = setTimeout(repeat, DELAY);
56
+ }}
57
+ onPointerUp={stop}
58
+ onPointerLeave={stop}
59
+ onPointerCancel={stop}
60
+ />
61
+ );
62
+ }
63
+
64
+ /** The two step buttons of a scrollbar. */
65
+ export function StepButtons({ orientation }: { orientation: "vertical" | "horizontal" }) {
66
+ return (
67
+ <>
68
+ <StepButton orientation={orientation} direction={-1} />
69
+ <StepButton orientation={orientation} direction={1} />
70
+ </>
71
+ );
72
+ }
@@ -0,0 +1,2 @@
1
+ export { Section, sectionVariants } from "./section";
2
+ export type { SectionProps } from "./section";