@bridgebrew/ui 0.0.0-stage → 0.1.10-next.79

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,2 @@
1
+ export { Toggle, toggleVariants } from "./toggle";
2
+ export type { ToggleProps } from "./toggle";
@@ -0,0 +1,53 @@
1
+ name: Toggle
2
+ description: "Binary on/off switch built on Base UI Switch primitive. Renders as a 28x16px track with a 12px thumb."
3
+ layer: core
4
+ category: input
5
+ when_to_use:
6
+ - "For on/off settings and preferences"
7
+ - "For enabling/disabling features in settings panels"
8
+ - "For binary state toggles where immediate effect is expected"
9
+ when_not_to_use:
10
+ - "For form checkboxes — use Checkbox component"
11
+ - "For multi-option selection — use SegmentGroup"
12
+ - "For action buttons — use Button component"
13
+ composition_partners:
14
+ - Properties (as value in PropertyRow)
15
+ - Dialog (in settings forms)
16
+ props:
17
+ - name: checked
18
+ type: boolean
19
+ required: false
20
+ description: "Controlled checked state"
21
+ - name: onCheckedChange
22
+ type: "(checked: boolean, eventDetails) => void"
23
+ required: false
24
+ description: "Callback when checked state changes. Base UI passes eventDetails as the second argument; eventDetails.cancel() prevents the change."
25
+ - name: defaultChecked
26
+ type: boolean
27
+ required: false
28
+ description: "Initial checked state (uncontrolled)"
29
+ - name: disabled
30
+ type: boolean
31
+ required: false
32
+ description: "Whether the toggle is disabled"
33
+ props_priority:
34
+ - checked
35
+ - onCheckedChange
36
+ - disabled
37
+ - defaultChecked
38
+ examples:
39
+ - title: "Uncontrolled toggle"
40
+ code: "<Toggle defaultChecked />"
41
+ - title: "Controlled toggle"
42
+ code: |
43
+ <Toggle
44
+ checked={enabled}
45
+ onCheckedChange={setEnabled}
46
+ />
47
+ - title: "Disabled toggle"
48
+ code: "<Toggle disabled />"
49
+ anti_patterns:
50
+ - "Don't use for multi-state selection — Toggle is strictly binary (on/off)"
51
+ - "Don't add custom track/thumb styles via className — the dimensions are fixed by design"
52
+ - "Don't use as a checkbox replacement in forms where submit behavior is expected"
53
+ accessibility_notes: "Built on Base UI Switch — renders role='switch' with proper aria-checked. Keyboard: Space to toggle. Focus ring shown on keyboard navigation."
@@ -0,0 +1,44 @@
1
+ import * as React from "react";
2
+ import { Switch as SwitchPrimitive } from "@base-ui/react/switch";
3
+ import { cva, type VariantProps } from "class-variance-authority";
4
+
5
+ import { cn } from "../../../lib/utils";
6
+
7
+ const toggleVariants = cva(
8
+ "inline-flex items-center p-0 w-[28px] h-[16px] rounded-full relative cursor-pointer transition-colors duration-150 data-unchecked:bg-border data-checked:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-accent focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:opacity-50 disabled:cursor-not-allowed",
9
+ );
10
+
11
+ interface ToggleProps
12
+ extends
13
+ Omit<
14
+ React.ComponentProps<typeof SwitchPrimitive.Root>,
15
+ // `render`/`nativeButton` are fixed internally (the control always
16
+ // renders a native <button>). They are also discarded at runtime below,
17
+ // since JS consumers bypass the TS Omit.
18
+ "render" | "nativeButton"
19
+ >,
20
+ VariantProps<typeof toggleVariants> {}
21
+
22
+ function Toggle({ className, ...props }: ToggleProps) {
23
+ // The TS Omit hides these, but JS consumers could still pass them and the
24
+ // {...props} spread comes last — discard so the internal values always win.
25
+ delete (props as Record<string, unknown>).render;
26
+ delete (props as Record<string, unknown>).nativeButton;
27
+ return (
28
+ <SwitchPrimitive.Root
29
+ data-slot="toggle"
30
+ // Render a native <button> (Base UI defaults to <span>) to keep the
31
+ // Radix-era DOM contract: native disabled attr + :disabled styling.
32
+ render={<button type="button" />}
33
+ nativeButton
34
+ className={cn(toggleVariants({ className }))}
35
+ {...props}
36
+ >
37
+ {/* translate-x-[14px] (not 12px) because flex positions thumb at x=0, so: 28px track - 12px thumb - 2px margin = 14px */}
38
+ <SwitchPrimitive.Thumb className="block size-3 rounded-full bg-white shadow-sm transition-transform duration-150 data-unchecked:translate-x-0.5 data-checked:translate-x-[14px]" />
39
+ </SwitchPrimitive.Root>
40
+ );
41
+ }
42
+
43
+ export { Toggle, toggleVariants };
44
+ export type { ToggleProps };
@@ -0,0 +1,2 @@
1
+ export { ToggleGroup } from "./toggle-group";
2
+ export type { ToggleGroupProps, ToggleGroupItem } from "./toggle-group";
@@ -0,0 +1,59 @@
1
+ name: ToggleGroup
2
+ description: "A row of toggle buttons in one track; any number of them may be pressed at once."
3
+ layer: core
4
+ category: input
5
+ when_to_use:
6
+ - "For multiple-choice selection among a few options (weekdays, filters)"
7
+ - "For a setting with several independent toggles sharing one control"
8
+ when_not_to_use:
9
+ - "For one choice among options — use SegmentGroup"
10
+ - "For a single on/off setting — use Toggle"
11
+ - "For more than 7 options — use a DropdownMenu or Select"
12
+ composition_partners:
13
+ - Properties (as a value control in PropertyRow)
14
+ - Field (with a FieldLabel)
15
+ props:
16
+ - name: items
17
+ type: "ToggleGroupItem[]"
18
+ required: true
19
+ description: "Each item's value, label and optional full-name title"
20
+ - name: value
21
+ type: "string[]"
22
+ required: true
23
+ description: "The pressed items' values (controlled)"
24
+ - name: onValueChange
25
+ type: "(value: string[]) => void"
26
+ required: true
27
+ description: "Called with the new pressed values"
28
+ - name: aria-label
29
+ type: "string"
30
+ required: true
31
+ description: "The group's accessible name"
32
+ - name: size
33
+ type: "'sm' | 'default' | 'lg'"
34
+ required: false
35
+ default: "'default'"
36
+ description: "Height on the height tokens, as SegmentGroup, Button and Input: sm (h-sm, 26px), default (h-md, 30px), lg (h-lg, 34px) at the look's default Control height, which they follow"
37
+ props_priority:
38
+ - items
39
+ - value
40
+ - onValueChange
41
+ - aria-label
42
+ examples:
43
+ - title: "Weekdays"
44
+ code: |
45
+ <ToggleGroup
46
+ aria-label="Days"
47
+ items={[
48
+ { value: "1", label: "M", title: "Monday" },
49
+ { value: "2", label: "T", title: "Tuesday" },
50
+ { value: "3", label: "W", title: "Wednesday" },
51
+ ]}
52
+ value={days}
53
+ onValueChange={setDays}
54
+ />
55
+ anti_patterns:
56
+ - "Don't use for a single choice — SegmentGroup does that with radio semantics"
57
+ - "Don't mix controlled and uncontrolled — value and onValueChange are both required"
58
+ accessibility_notes: "Base UI ToggleGroup with multiple enabled. Each button exposes aria-pressed; arrow keys move between items and Space or Enter toggles the focused one."
59
+ notes: "ToggleGroupItem type: { value: string, label: React.ReactNode, title?: string }. Styled as SegmentGroup: a track of the height tokens (its size, default h-md) with quiet text and a raised surface for pressed items."
@@ -0,0 +1,68 @@
1
+ import * as React from "react";
2
+ import { Toggle as TogglePrimitive } from "@base-ui/react/toggle";
3
+ import { ToggleGroup as ToggleGroupPrimitive } from "@base-ui/react/toggle-group";
4
+
5
+ import { cn } from "../../../lib/utils";
6
+ import { segmentGroupVariants, segmentItemSizes } from "../segment-group/segment-group";
7
+
8
+ interface ToggleGroupItem {
9
+ value: string;
10
+ label: React.ReactNode;
11
+ /** The item's full name, shown in the browser's tooltip (a weekday's "Monday" for "M"). */
12
+ title?: string;
13
+ }
14
+
15
+ interface ToggleGroupProps {
16
+ items: ToggleGroupItem[];
17
+ value: string[];
18
+ onValueChange: (value: string[]) => void;
19
+ "aria-label": string;
20
+ /** Height, as SegmentGroup's and Button's (h-sm, h-md, h-lg). Defaults to `default` (h-md). */
21
+ size?: "sm" | "default" | "lg";
22
+ className?: string;
23
+ }
24
+
25
+ /** A multiple-choice toggle group, drawn as SegmentGroup is: several quiet buttons in one track, each independently
26
+ * pressed (weekdays, filters). Base UI's ToggleGroup keeps the pressed set and its keyboard behaviour. */
27
+ function ToggleGroup({
28
+ className,
29
+ size = "default",
30
+ items,
31
+ value,
32
+ onValueChange,
33
+ ...props
34
+ }: ToggleGroupProps) {
35
+ return (
36
+ <ToggleGroupPrimitive
37
+ data-slot="toggle-group"
38
+ multiple
39
+ value={value}
40
+ onValueChange={(next) => onValueChange([...next])}
41
+ data-size={size}
42
+ className={cn(segmentGroupVariants({ size }), className)}
43
+ {...props}
44
+ >
45
+ {items.map((item) => {
46
+ const pressed = value.includes(item.value);
47
+ return (
48
+ <TogglePrimitive
49
+ key={item.value}
50
+ data-slot="toggle-group-item"
51
+ value={item.value}
52
+ title={item.title}
53
+ className={cn(
54
+ "relative z-[1] flex h-full cursor-pointer items-center justify-center rounded-control-inner bg-transparent font-medium transition-colors duration-150 outline-none",
55
+ segmentItemSizes[size],
56
+ pressed ? "bg-surface text-foreground shadow-xs" : "text-muted hover:text-secondary",
57
+ )}
58
+ >
59
+ {item.label}
60
+ </TogglePrimitive>
61
+ );
62
+ })}
63
+ </ToggleGroupPrimitive>
64
+ );
65
+ }
66
+
67
+ export { ToggleGroup };
68
+ export type { ToggleGroupProps, ToggleGroupItem };
@@ -0,0 +1,7 @@
1
+ export { TooltipProvider, Tooltip, TooltipTrigger, TooltipContent, Tip } from "./tooltip";
2
+ export type {
3
+ TooltipProps,
4
+ TooltipProviderProps,
5
+ TooltipTriggerProps,
6
+ TooltipContentProps,
7
+ } from "./tooltip";
@@ -0,0 +1,93 @@
1
+ name: Tooltip
2
+ description: "Contextual hover information built on Base UI Tooltip. TooltipProvider is recommended for shared delays across adjacent tooltips."
3
+ layer: core
4
+ category: overlay
5
+ when_to_use:
6
+ - "For providing additional context on hover for icon buttons"
7
+ - "For explaining UI elements without cluttering the interface"
8
+ - "For showing keyboard shortcuts or brief descriptions"
9
+ when_not_to_use:
10
+ - "For interactive content — use DropdownMenu or Dialog"
11
+ - "For lengthy descriptions — use inline text or a dedicated section"
12
+ - "For mobile-first interfaces — tooltips rely on hover which doesn't work on touch"
13
+ composition_partners:
14
+ - Button (as TooltipTrigger child, especially icon buttons)
15
+ - TooltipProvider (recommended app-level wrapper for shared timing)
16
+ props:
17
+ - name: delay
18
+ type: number
19
+ required: false
20
+ description: "Milliseconds before the tooltip appears. TooltipProvider defaults to 120ms in Bridge UI; TooltipTrigger also accepts a per-trigger override (Base UI defaults to 600ms without a provider)."
21
+ - name: timeout
22
+ type: number
23
+ required: false
24
+ default: "80"
25
+ description: "Milliseconds within which moving between triggers shows the next tooltip instantly (TooltipProvider only)"
26
+ - name: closeDelay
27
+ type: number
28
+ required: false
29
+ description: "Milliseconds before an open tooltip closes. Forwarded by TooltipProvider and TooltipTrigger; TooltipTrigger defaults to 0ms."
30
+ - name: sideOffset
31
+ type: "number | ((data) => number)"
32
+ required: false
33
+ default: "6"
34
+ description: "Distance from trigger in pixels (TooltipContent only)"
35
+ - name: side
36
+ type: "'top' | 'right' | 'bottom' | 'left'"
37
+ required: false
38
+ default: "'top'"
39
+ description: "Preferred side to display tooltip (TooltipContent only)"
40
+ - name: align
41
+ type: "'start' | 'center' | 'end'"
42
+ required: false
43
+ default: "'center'"
44
+ description: "Alignment relative to trigger (TooltipContent only)"
45
+ - name: alignOffset
46
+ type: "number | ((data) => number)"
47
+ required: false
48
+ default: "0"
49
+ description: "Offset along the alignment axis in pixels (TooltipContent only)"
50
+ - name: collisionPadding
51
+ type: "number | { top?, right?, bottom?, left? }"
52
+ required: false
53
+ default: "5"
54
+ description: "Minimum distance from viewport edges when auto-positioning (TooltipContent only)"
55
+ - name: render
56
+ type: "ReactElement | (props, state) => ReactElement"
57
+ required: false
58
+ description: "Replace the rendered element on TooltipTrigger or TooltipContent, e.g. render={<Button />} on the trigger."
59
+ - name: hint
60
+ type: React.ReactNode
61
+ required: false
62
+ description: "A second, lighter line under the message, for an action hint such as 'Click to retry' (TooltipContent only). The popup wraps at max-w-[220px]."
63
+ props_priority:
64
+ - side
65
+ - sideOffset
66
+ - hint
67
+ - delay
68
+ examples:
69
+ - title: "Tooltip on icon button"
70
+ code: |
71
+ import { Plus } from 'lucide-react';
72
+
73
+ <TooltipProvider>
74
+ <Tooltip>
75
+ <TooltipTrigger render={<Button size="icon-sm" aria-label="Create new issue" />}>
76
+ <Plus size={14} />
77
+ </TooltipTrigger>
78
+ <TooltipContent>Create new issue</TooltipContent>
79
+ </Tooltip>
80
+ </TooltipProvider>
81
+ - title: "Tooltip with side placement"
82
+ code: |
83
+ <Tooltip>
84
+ <TooltipTrigger render={<Button size="icon" aria-label="Settings" />}>⚙️</TooltipTrigger>
85
+ <TooltipContent side="right">Settings</TooltipContent>
86
+ </Tooltip>
87
+ anti_patterns:
88
+ - "Don't skip the TooltipProvider ancestor — tooltips still work without it, but you lose the shared 120ms/80ms delay defaults and instant-move behavior between adjacent tooltips"
89
+ - "Don't put interactive elements inside TooltipContent — tooltips are for display only"
90
+ - "Don't use Tooltip for critical information — it's hidden by default and requires hover"
91
+ - "Don't forget render={<Button />} on TooltipTrigger when wrapping a Button"
92
+ accessibility_notes: "Built on Base UI Tooltip — the wrapper restores aria-describedby to associate tooltip content with trigger. Tooltip appears on focus as well as hover. Escape key dismisses tooltip."
93
+ notes: "Sub-components: TooltipProvider (app-level wrapper), Tooltip (root), TooltipTrigger, TooltipContent. Provider should wrap the app once, not each individual tooltip."
@@ -0,0 +1,198 @@
1
+ import * as React from "react";
2
+ import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
3
+
4
+ import { cn } from "../../../lib/utils";
5
+
6
+ // --- TooltipProvider ---
7
+
8
+ interface TooltipProviderProps extends React.ComponentProps<typeof TooltipPrimitive.Provider> {}
9
+
10
+ function TooltipProvider({ delay = 120, timeout = 80, ...props }: TooltipProviderProps) {
11
+ return <TooltipPrimitive.Provider delay={delay} timeout={timeout} {...props} />;
12
+ }
13
+
14
+ // --- Tooltip (root) ---
15
+
16
+ // Base UI (unlike Radix) does not link trigger and popup with
17
+ // aria-describedby. This context restores that wiring in the wrappers so the
18
+ // tooltip text stays announced by screen readers. The popup registers its
19
+ // effective DOM id while it is actually mounted, so the trigger never points
20
+ // at a dangling id and consumer-supplied ids are respected.
21
+ interface TooltipA11yContextValue {
22
+ /** Effective ids for every currently mounted popup. */
23
+ registeredPopupIds: string[];
24
+ /** Register one mounted popup and return its ownership-safe cleanup. */
25
+ registerPopup: (id: string) => () => void;
26
+ }
27
+
28
+ const TooltipA11yContext = React.createContext<TooltipA11yContextValue | null>(null);
29
+
30
+ /** Registers the popup id while (and only while) the popup is mounted.
31
+ * Rendered inside the Popup so its lifecycle tracks the actual DOM node. */
32
+ function TooltipPopupRegistrar({ id }: { id: string }) {
33
+ const a11y = React.useContext(TooltipA11yContext);
34
+ const registerPopup = a11y?.registerPopup;
35
+ React.useLayoutEffect(() => registerPopup?.(id), [registerPopup, id]);
36
+ return null;
37
+ }
38
+
39
+ interface TooltipProps extends React.ComponentProps<typeof TooltipPrimitive.Root> {}
40
+
41
+ function Tooltip(props: TooltipProps) {
42
+ const nextRegistrationKey = React.useRef(0);
43
+ const [popupRegistrations, setPopupRegistrations] = React.useState<
44
+ Array<{ key: number; id: string }>
45
+ >([]);
46
+ const registerPopup = React.useCallback((id: string) => {
47
+ const key = nextRegistrationKey.current++;
48
+ setPopupRegistrations((current) => [...current, { key, id }]);
49
+ return () => {
50
+ setPopupRegistrations((current) =>
51
+ current.filter((registration) => registration.key !== key),
52
+ );
53
+ };
54
+ }, []);
55
+ const registeredPopupIds = React.useMemo(
56
+ () => [...new Set(popupRegistrations.map(({ id }) => id))],
57
+ [popupRegistrations],
58
+ );
59
+ const a11y = React.useMemo(
60
+ () => ({ registeredPopupIds, registerPopup }),
61
+ [registeredPopupIds, registerPopup],
62
+ );
63
+
64
+ return (
65
+ <TooltipA11yContext.Provider value={a11y}>
66
+ <TooltipPrimitive.Root {...props} />
67
+ </TooltipA11yContext.Provider>
68
+ );
69
+ }
70
+
71
+ // --- TooltipTrigger ---
72
+
73
+ interface TooltipTriggerProps extends React.ComponentProps<typeof TooltipPrimitive.Trigger> {}
74
+
75
+ function TooltipTrigger({
76
+ className,
77
+ "aria-describedby": ariaDescribedByProp,
78
+ ...props
79
+ }: TooltipTriggerProps) {
80
+ const a11y = React.useContext(TooltipA11yContext);
81
+ // Merge a consumer-supplied aria-describedby with the tooltip linkage
82
+ // (space-separated id list), like Radix did — never replace one with the
83
+ // other.
84
+ const ariaDescribedByTokens = [
85
+ ...(ariaDescribedByProp?.split(/\s+/).filter(Boolean) ?? []),
86
+ ...(a11y?.registeredPopupIds ?? []),
87
+ ];
88
+ const ariaDescribedBy =
89
+ ariaDescribedByTokens.length > 0 ? [...new Set(ariaDescribedByTokens)].join(" ") : undefined;
90
+ return (
91
+ <TooltipPrimitive.Trigger
92
+ data-slot="tooltip-trigger"
93
+ className={className}
94
+ aria-describedby={ariaDescribedBy}
95
+ {...props}
96
+ />
97
+ );
98
+ }
99
+
100
+ // --- TooltipContent ---
101
+
102
+ interface TooltipContentProps extends React.ComponentProps<typeof TooltipPrimitive.Popup> {
103
+ /** Which side of the trigger to position against (lives on Base UI's Positioner) */
104
+ side?: "top" | "right" | "bottom" | "left";
105
+ /** Distance from the trigger in px (lives on Base UI's Positioner) */
106
+ sideOffset?: React.ComponentProps<typeof TooltipPrimitive.Positioner>["sideOffset"];
107
+ /** Alignment against the trigger (lives on Base UI's Positioner) */
108
+ align?: React.ComponentProps<typeof TooltipPrimitive.Positioner>["align"];
109
+ /** Offset along the alignment axis (lives on Base UI's Positioner) */
110
+ alignOffset?: React.ComponentProps<typeof TooltipPrimitive.Positioner>["alignOffset"];
111
+ /** Minimum distance from the viewport edges (lives on Base UI's Positioner) */
112
+ collisionPadding?: React.ComponentProps<typeof TooltipPrimitive.Positioner>["collisionPadding"];
113
+ /** A second, lighter line under the message (e.g. an action hint such as "Click to retry"). */
114
+ hint?: React.ReactNode;
115
+ }
116
+
117
+ function TooltipContent({
118
+ className,
119
+ sideOffset = 6,
120
+ side = "top",
121
+ align,
122
+ alignOffset,
123
+ collisionPadding,
124
+ hint,
125
+ id,
126
+ style,
127
+ children,
128
+ ...props
129
+ }: TooltipContentProps) {
130
+ const fallbackId = React.useId();
131
+ // Respect a consumer-supplied id — the trigger's aria-describedby follows it.
132
+ const effectiveId = id ?? fallbackId;
133
+ return (
134
+ <TooltipPrimitive.Portal>
135
+ <TooltipPrimitive.Positioner
136
+ sideOffset={sideOffset}
137
+ side={side}
138
+ align={align}
139
+ alignOffset={alignOffset}
140
+ collisionPadding={collisionPadding}
141
+ className="z-50"
142
+ >
143
+ <TooltipPrimitive.Popup
144
+ {...props}
145
+ data-slot="tooltip-content"
146
+ role="tooltip"
147
+ id={effectiveId}
148
+ className={cn(
149
+ "z-50 bg-foreground text-background rounded-sm text-xs px-2 py-1 max-w-[220px] whitespace-normal",
150
+ className,
151
+ )}
152
+ style={{ boxShadow: "var(--shadow-tooltip)", ...style }}
153
+ >
154
+ <TooltipPopupRegistrar id={effectiveId} />
155
+ {children}
156
+ {hint != null ? (
157
+ <span data-slot="tooltip-hint" className="block text-[11.5px] opacity-60 mt-px">
158
+ {hint}
159
+ </span>
160
+ ) : null}
161
+ <TooltipPrimitive.Arrow
162
+ className={cn(
163
+ "flex",
164
+ "data-[side=top]:bottom-[-4px] data-[side=top]:rotate-0",
165
+ "data-[side=bottom]:top-[-4px] data-[side=bottom]:rotate-180",
166
+ "data-[side=left]:right-[-6px] data-[side=left]:-rotate-90",
167
+ "data-[side=right]:left-[-6px] data-[side=right]:rotate-90",
168
+ )}
169
+ >
170
+ {/* 8x4 triangle pointing away from the popup (down for side="top") */}
171
+ <svg
172
+ width="8"
173
+ height="4"
174
+ viewBox="0 0 8 4"
175
+ className="fill-foreground"
176
+ aria-hidden="true"
177
+ >
178
+ <path d="M0 0h8L4 4Z" />
179
+ </svg>
180
+ </TooltipPrimitive.Arrow>
181
+ </TooltipPrimitive.Popup>
182
+ </TooltipPrimitive.Positioner>
183
+ </TooltipPrimitive.Portal>
184
+ );
185
+ }
186
+
187
+ /** An icon-only control with its tooltip (the kit's rule for lossy glyphs): `<Tip label="Filter"><Button …/></Tip>`. */
188
+ function Tip({ label, children }: { label: React.ReactNode; children: React.ReactElement }) {
189
+ return (
190
+ <Tooltip>
191
+ <TooltipTrigger render={children} />
192
+ <TooltipContent>{label}</TooltipContent>
193
+ </Tooltip>
194
+ );
195
+ }
196
+
197
+ export { TooltipProvider, Tooltip, TooltipTrigger, TooltipContent, Tip };
198
+ export type { TooltipProps, TooltipProviderProps, TooltipTriggerProps, TooltipContentProps };
@@ -0,0 +1,4 @@
1
+ export { MultiPane, multiPaneNarrowWidth, multiPaneAsideWidth } from "./multi-pane";
2
+ export type { MultiPaneProps } from "./multi-pane";
3
+ export { ListDetail, listDetailNarrowWidth } from "./list-detail";
4
+ export type { ListDetailProps } from "./list-detail";
@@ -0,0 +1,45 @@
1
+ import type * as React from "react";
2
+
3
+ import { MultiPane, multiPaneNarrowWidth, type MultiPaneProps } from "./multi-pane";
4
+
5
+ // MultiPane's name until November 2026 (research-070), kept for plugins built against it: `list` is MultiPane's `nav`,
6
+ // `detail` its `main`. New screens take MultiPane.
7
+
8
+ interface ListDetailProps extends Omit<
9
+ MultiPaneProps,
10
+ "nav" | "main" | "aside" | "mode" | "defaultNavSize"
11
+ > {
12
+ list: React.ReactNode;
13
+ detail: React.ReactNode;
14
+ mode?: "split" | "list" | "detail";
15
+ /** The list's starting width (`"320px"` by default). */
16
+ defaultListSize?: string;
17
+ /** Ignored: the record keeps 380px at least. */
18
+ detailMinSize?: string;
19
+ }
20
+
21
+ /** @deprecated MultiPane's `multiPaneNarrowWidth`. */
22
+ const listDetailNarrowWidth = multiPaneNarrowWidth;
23
+
24
+ /** @deprecated MultiPane, `nav` and `main`. */
25
+ function ListDetail({
26
+ list,
27
+ detail,
28
+ mode = "split",
29
+ defaultListSize = "320px",
30
+ detailMinSize: _ignored,
31
+ ...props
32
+ }: ListDetailProps) {
33
+ return (
34
+ <MultiPane
35
+ nav={list}
36
+ main={detail}
37
+ mode={mode === "list" ? "nav" : mode === "detail" ? "main" : "split"}
38
+ defaultNavSize={defaultListSize}
39
+ {...props}
40
+ />
41
+ );
42
+ }
43
+
44
+ export { ListDetail, listDetailNarrowWidth };
45
+ export type { ListDetailProps };
@@ -0,0 +1,67 @@
1
+ name: MultiPane
2
+ description: "A screen's skeleton in two or three panes, nav | main | aside: main takes what the others leave, nav and aside start at 25 %, each edge dragged (200px at least for nav and aside, 380px for main), a double-click on an edge back to the starting widths. When room runs out the panes leave from the right: three panes in a box under 800px leave the aside out, under 640px the first pane stays alone; the screen opens what left elsewhere (a window; on a phone, pushed with the shell's Back). mode shows one pane alone (a window showing only it)."
3
+ layer: layout
4
+ category: layout
5
+ when_to_use:
6
+ - "A list beside its record (Contacts, Health): nav and main"
7
+ - "A table beside the row it opened (Orders): main and aside"
8
+ - "Three columns: folders | list | message, pages | document | properties"
9
+ when_not_to_use:
10
+ - "A single column (a page of sections, settings): Pane alone"
11
+ - "Any other split of a view into rows or columns (an editor above its console, a grid of panes) — use SplitView"
12
+ props:
13
+ - name: nav
14
+ type: React.ReactNode
15
+ required: false
16
+ description: "The left pane (a list, folders); none: main on the left"
17
+ - name: main
18
+ type: React.ReactNode
19
+ required: true
20
+ description: "The pane that takes the room"
21
+ - name: aside
22
+ type: React.ReactNode
23
+ required: false
24
+ description: "The right pane (a record, properties); none: main on the right"
25
+ - name: mode
26
+ type: "'split' | 'nav' | 'main' | 'aside'"
27
+ required: false
28
+ default: "'split'"
29
+ description: "split: the panes side by side; a pane's name: that pane alone at any width, a window showing only it"
30
+ - name: defaultNavSize
31
+ type: string
32
+ required: false
33
+ default: "'25%'"
34
+ description: "nav's starting width, in px or % ('320px', '65%' for a list that matters more than its record): dragged from there, a double-click on the edge comes back to it"
35
+ - name: defaultAsideSize
36
+ type: string
37
+ required: false
38
+ default: "'25%'"
39
+ description: "aside's starting width, in px or %"
40
+ - name: storageKey
41
+ type: string
42
+ required: false
43
+ description: "`<plugin>/<screen>/<split>@v<n>` (e.g. 'bridge-settings/health/list@v1'): the sizes a user dragged, kept per workspace in their profile and brought back there; a double-click on an edge forgets them. Omit for no memory"
44
+ - name: scroll
45
+ type: "('nav' | 'main' | 'aside')[]"
46
+ required: false
47
+ default: "[]"
48
+ description: "The panes that scroll their content, through the kit's ScrollArea (as a frame's scrolling); the others leave it to their content (a Pane's body, a Detail keep their header fixed)"
49
+ - name: collapse
50
+ type: boolean
51
+ required: false
52
+ default: "true"
53
+ description: "When room runs out, the panes leave from the right; off for a screen that cannot open them elsewhere yet"
54
+ composition_partners:
55
+ - Pane (each pane's content)
56
+ - Detail, EmptyState, DetailSkeleton (a record pane)
57
+ examples:
58
+ - title: "A list beside its record"
59
+ code: |
60
+ <MultiPane nav={<Pane aria-label="Contacts">…</Pane>} main={<Detail>…</Detail>} />
61
+ - title: "A table beside the row it opened"
62
+ code: |
63
+ <MultiPane main={<Pane aria-label="Orders"><Table>…</Table></Pane>} aside={open && <Detail>…</Detail>} />
64
+ anti_patterns:
65
+ - "Don't define a component in a pane's prop (main={() => <Detail />}, or a component declared inside the screen's render): each render makes a new component, React mounts it again and its state goes (a draft, the scroll, the focus). Pass an element: main={<Detail />}"
66
+ - "Don't write a large block of JSX inside a pane's prop: put it in a variable or a small component of its own (nav={list} main={record})"
67
+ notes: "Sub-parts by data-slot: panes, multi-pane-alone (a pane alone, mode other than split and the first pane). Panel ids nav, main, aside (the keys of the kept sizes). Narrow under multiPaneNarrowWidth (640px) of its own box, a container query; three panes leave their aside out under multiPaneAsideWidth (800px), measured. ListDetail is its former name (list is nav, detail is main), kept for plugins built against it."