@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,93 @@
1
+ import * as React from "react";
2
+
3
+ import { copyText } from "../../../lib/clipboard";
4
+ import { cn } from "../../../lib/utils";
5
+ import { Button } from "../button";
6
+ import { Icon } from "../icon";
7
+ import { ScrollArea } from "../scroll-area";
8
+
9
+ // Code to read and copy (research-070): the kit's mono font on the hover tint, its long lines scrolling sideways (the
10
+ // kit's ScrollArea), a Copy button in its corner. Coloured when given `tokens`: the caller highlights (Shiki in its own
11
+ // bundle, its `css-variables` theme, as the docs plugin), never the kit, which every page loads; a token's colour is a
12
+ // `--shiki-*` variable this block sets from the theme's colours, so light, dark and skins follow.
13
+
14
+ interface CodeBlockProps extends Omit<React.ComponentProps<"div">, "children"> {
15
+ /** The code, as written (its line breaks and indentation kept). */
16
+ code: string;
17
+ /** Its language (`tsx`, `css`): `data-language`. */
18
+ language?: string;
19
+ /** The code cut into coloured pieces, line by line (Shiki's `codeToTokens(…).tokens`); none: plain. Copy copies
20
+ * `code`. */
21
+ tokens?: readonly (readonly CodeToken[])[] | undefined;
22
+ }
23
+
24
+ /** A piece of a line and its colour (a `var(--shiki-token-…)` from Shiki's css-variables theme, or any colour). */
25
+ interface CodeToken {
26
+ content: string;
27
+ color?: string | undefined;
28
+ }
29
+
30
+ /** The `--shiki-*` variables a css-variables token names, from the theme's own colours (light, dark and skins follow):
31
+ * tags blue, attributes amber, keywords red, strings green, punctuation grey. */
32
+ const palette = [
33
+ "[--shiki-foreground:var(--fg)] [--shiki-color-text:var(--fg)] [--shiki-token-parameter:var(--fg)]",
34
+ "[--shiki-token-constant:var(--accent)] [--shiki-token-link:var(--accent)]",
35
+ "[--shiki-token-function:var(--warning-text)]",
36
+ "[--shiki-token-keyword:var(--label-bug-fg)]",
37
+ "[--shiki-token-string:var(--label-improvement-fg)] [--shiki-token-string-expression:var(--label-improvement-fg)]",
38
+ "[--shiki-token-punctuation:var(--fg-secondary)] [--shiki-token-comment:var(--fg-muted)]",
39
+ ].join(" ");
40
+
41
+ function CodeBlock({ code, language, tokens, className, ...props }: CodeBlockProps) {
42
+ const [copied, setCopied] = React.useState(false);
43
+ const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
44
+ React.useEffect(() => () => clearTimeout(timer.current), []);
45
+ const copy = () => {
46
+ copyText(code)
47
+ .then(() => {
48
+ setCopied(true);
49
+ clearTimeout(timer.current);
50
+ timer.current = setTimeout(() => setCopied(false), 1500);
51
+ })
52
+ .catch(() => setCopied(false));
53
+ };
54
+ return (
55
+ <div
56
+ data-slot="code-block"
57
+ {...(language !== undefined && { "data-language": language })}
58
+ className={cn("group relative rounded-dropdown bg-hover", palette, className)}
59
+ {...props}
60
+ >
61
+ <ScrollArea orientation="horizontal">
62
+ <pre className="m-0 px-3.5 py-3 font-mono text-xs leading-relaxed whitespace-pre">
63
+ <code>
64
+ {tokens
65
+ ? tokens.map((line, i) => (
66
+ <React.Fragment key={i}>
67
+ {i > 0 && "\n"}
68
+ {line.map((token, j) => (
69
+ <span key={j} style={token.color ? { color: token.color } : undefined}>
70
+ {token.content}
71
+ </span>
72
+ ))}
73
+ </React.Fragment>
74
+ ))
75
+ : code}
76
+ </code>
77
+ </pre>
78
+ </ScrollArea>
79
+ <Button
80
+ variant="ghost"
81
+ size="icon-sm"
82
+ aria-label={copied ? "Copied" : "Copy code"}
83
+ onClick={copy}
84
+ className="absolute top-1.5 right-1.5 opacity-0 group-hover:opacity-100 focus-visible:opacity-100 [@media(hover:none)]:opacity-100"
85
+ >
86
+ <Icon name={copied ? "check" : "copy"} size={14} />
87
+ </Button>
88
+ </div>
89
+ );
90
+ }
91
+
92
+ export { CodeBlock };
93
+ export type { CodeBlockProps, CodeToken };
@@ -0,0 +1,2 @@
1
+ export { CodeBlock } from "./code-block";
2
+ export type { CodeBlockProps, CodeToken } from "./code-block";
@@ -0,0 +1,34 @@
1
+ name: Collapsible
2
+ description: "Base UI's Collapsible under the kit's look: CollapsibleTrigger (its label after a chevron, turned down while open) shows or hides CollapsiblePanel. Closed by default."
3
+ layer: core
4
+ category: disclosure
5
+ when_to_use:
6
+ - "Something most people need not see at first: a sample's code, advanced settings, a long detail"
7
+ when_not_to_use:
8
+ - "A list whose groups fold — use List's ListGroup collapsible"
9
+ - "Rows that fold under a heading in a card — use CollapsibleRows"
10
+ props:
11
+ - name: defaultOpen
12
+ type: boolean
13
+ required: false
14
+ default: "false"
15
+ description: "Collapsible: open at first (uncontrolled)"
16
+ - name: open
17
+ type: boolean
18
+ required: false
19
+ description: "Collapsible: open or closed, driven with onOpenChange"
20
+ - name: onOpenChange
21
+ type: "(open: boolean) => void"
22
+ required: false
23
+ description: "Collapsible: called when the trigger opens or closes it"
24
+ composition_partners:
25
+ - CodeBlock (a sample's code, closed under it)
26
+ examples:
27
+ - title: "A sample's code"
28
+ code: |
29
+ <Collapsible>
30
+ <CollapsibleTrigger>Code</CollapsibleTrigger>
31
+ <CollapsiblePanel><CodeBlock code={source} /></CollapsiblePanel>
32
+ </Collapsible>
33
+ accessibility_notes: "Base UI: the trigger is a button with aria-expanded and aria-controls naming the panel."
34
+ notes: "Sub-parts by data-slot: collapsible, collapsible-trigger (data-panel-open while open), collapsible-panel."
@@ -0,0 +1,54 @@
1
+ import * as React from "react";
2
+ import { Collapsible as CollapsiblePrimitive } from "@base-ui/react/collapsible";
3
+
4
+ import { cn } from "../../../lib/utils";
5
+ import { Icon } from "../icon";
6
+
7
+ // Base UI's Collapsible under the kit's look (research-070): a trigger that shows or hides its panel, a chevron
8
+ // turning with it. Closed by default (`defaultOpen`, or `open` and `onOpenChange` to drive it).
9
+
10
+ function Collapsible(props: React.ComponentProps<typeof CollapsiblePrimitive.Root>) {
11
+ return <CollapsiblePrimitive.Root data-slot="collapsible" {...props} />;
12
+ }
13
+
14
+ /** The trigger: its label after a chevron pointing right, down while open. */
15
+ function CollapsibleTrigger({
16
+ className,
17
+ children,
18
+ ...props
19
+ }: React.ComponentProps<typeof CollapsiblePrimitive.Trigger>) {
20
+ return (
21
+ <CollapsiblePrimitive.Trigger
22
+ data-slot="collapsible-trigger"
23
+ className={cn(
24
+ "group inline-flex cursor-pointer items-center gap-1 rounded-control text-sm text-secondary outline-none select-none hover:text-foreground focus-visible:text-foreground focus-visible:ring-2 focus-visible:ring-accent/40",
25
+ className,
26
+ )}
27
+ {...props}
28
+ >
29
+ <Icon
30
+ name="chevron-right"
31
+ size={14}
32
+ aria-hidden
33
+ className="transition-transform duration-150 group-data-[panel-open]:rotate-90"
34
+ />
35
+ {children}
36
+ </CollapsiblePrimitive.Trigger>
37
+ );
38
+ }
39
+
40
+ /** What the trigger shows and hides. */
41
+ function CollapsiblePanel({
42
+ className,
43
+ ...props
44
+ }: React.ComponentProps<typeof CollapsiblePrimitive.Panel>) {
45
+ return (
46
+ <CollapsiblePrimitive.Panel
47
+ data-slot="collapsible-panel"
48
+ className={cn("pt-2", className)}
49
+ {...props}
50
+ />
51
+ );
52
+ }
53
+
54
+ export { Collapsible, CollapsibleTrigger, CollapsiblePanel };
@@ -0,0 +1 @@
1
+ export { Collapsible, CollapsibleTrigger, CollapsiblePanel } from "./collapsible";
@@ -0,0 +1,52 @@
1
+ name: ColourPicker
2
+ description: "A colour chosen first among the theme's accents (a row of swatches after the default), then among more of its colours (a popover, by group), then any (the popover's Custom: the native picker and a CSS colour typed). The row reads out the chosen colour's name."
3
+ layer: core
4
+ category: input
5
+ when_to_use:
6
+ - "For a colour a user sets (a tile, a paint, an accent) that should follow the theme unless chosen otherwise"
7
+ - "When the theme's own colours are the likely choices and any colour is still allowed"
8
+ when_not_to_use:
9
+ - "For a few named options that are not colours — use SegmentGroup"
10
+ composition_partners:
11
+ - Properties (as value in PropertyRow)
12
+ props:
13
+ - name: value
14
+ type: "string | undefined"
15
+ required: true
16
+ description: "The colour stored (often `var(--accent)`); undefined: the default"
17
+ - name: onChange
18
+ type: "(value: string | undefined) => void"
19
+ required: true
20
+ description: "A colour chosen; undefined: back to the default"
21
+ - name: swatches
22
+ type: "ColourSwatch[]"
23
+ required: false
24
+ description: "Offered inline (THEME_COLOURS)"
25
+ - name: groups
26
+ type: "ColourGroup[]"
27
+ required: false
28
+ description: "Offered in the popover, by group (THEME_COLOUR_GROUPS)"
29
+ - name: defaultColour
30
+ type: string
31
+ required: false
32
+ description: "What the default swatch draws (none: crossed out)"
33
+ - name: defaultName
34
+ type: string
35
+ required: false
36
+ description: "The default's name (Default)"
37
+ - name: theme
38
+ type: string
39
+ required: false
40
+ description: "The theme the swatches are drawn in (data-theme)"
41
+ props_priority:
42
+ - value
43
+ - onChange
44
+ - defaultColour
45
+ - theme
46
+ examples:
47
+ - title: "A paint colour following the theme"
48
+ code: '<ColourPicker value={c1} onChange={setC1} defaultColour="var(--paint-c1)" defaultName="Theme''s first paint colour" />'
49
+ anti_patterns:
50
+ - "Don't store a token's resolved value when the colour should follow the theme: store its reference (`var(--accent)`), as the swatches do"
51
+ - "Don't offer the theme's text or background colour for a surface: what is drawn on it would not read"
52
+ accessibility_notes: "Each swatch is a radio (role='radio', aria-checked) named by its colour; the inline row and each popover group are radiogroups. The popover opens from a 'More colours' button; Custom's field is labelled 'A CSS colour', committed on Enter or blur, Escape restoring the stored one."
@@ -0,0 +1,314 @@
1
+ import * as React from "react";
2
+ import { Popover as PopoverPrimitive } from "@base-ui/react/popover";
3
+ import { CSPProvider } from "@base-ui/react/csp-provider";
4
+
5
+ import { cn } from "../../../lib/utils";
6
+ import { Input } from "../input/input";
7
+ import {
8
+ THEME_COLOUR_GROUPS,
9
+ THEME_COLOURS,
10
+ type ColourGroup,
11
+ type ColourSwatch,
12
+ } from "../../../theme/theme-colours";
13
+ import { isComposing } from "../../../lib/keys";
14
+
15
+ // Bridge: a colour chosen first among a few (the theme's accents, inline), then among more (a popover, by group, the
16
+ // row's own first), then any (the popover's Custom: the native picker and a CSS colour typed). A swatch's value is its
17
+ // CSS colour as stored, often a reference to a theme token (`var(--accent)`), so it follows the theme; the swatches are
18
+ // drawn in `theme` (`data-theme`), the name of the one chosen read out under them.
19
+
20
+ interface ColourPickerProps {
21
+ /** The colour stored; `undefined`: the default. */
22
+ value: string | undefined;
23
+ /** A colour chosen (`undefined`: back to the default). */
24
+ onChange: (value: string | undefined) => void;
25
+ /** Offered inline, after the default. */
26
+ swatches?: readonly ColourSwatch[];
27
+ /** Offered in the popover, by group, before Custom. */
28
+ groups?: readonly ColourGroup[];
29
+ /** What the default draws (a CSS colour; none: a crossed-out swatch), and its name. */
30
+ defaultColour?: string | undefined;
31
+ defaultName?: string;
32
+ /** The theme the swatches are drawn in (`data-theme`); none: the page's. */
33
+ theme?: string | undefined;
34
+ disabled?: boolean;
35
+ invalid?: boolean;
36
+ "aria-labelledby"?: string;
37
+ className?: string;
38
+ }
39
+
40
+ /** A crossed-out swatch: no colour of its own. */
41
+ const unset =
42
+ "linear-gradient(to top right, transparent calc(50% - 1px), var(--color-destructive) calc(50% - 0.5px) calc(50% + 0.5px), transparent calc(50% + 1px)), var(--color-surface)";
43
+
44
+ /** A swatch as a radio: its colour, ringed when chosen. */
45
+ function Dot({
46
+ colour,
47
+ name,
48
+ checked,
49
+ dashed,
50
+ disabled,
51
+ theme,
52
+ onPick,
53
+ }: {
54
+ colour: string | undefined;
55
+ theme: string | undefined;
56
+ name: string;
57
+ checked: boolean;
58
+ dashed?: boolean;
59
+ disabled?: boolean | undefined;
60
+ onPick: () => void;
61
+ }) {
62
+ return (
63
+ <button
64
+ type="button"
65
+ role="radio"
66
+ aria-checked={checked}
67
+ aria-label={name}
68
+ title={name}
69
+ disabled={disabled}
70
+ onClick={onPick}
71
+ data-slot="colour-swatch"
72
+ className={cn(
73
+ "size-5 shrink-0 cursor-pointer overflow-hidden rounded-full border border-input p-0 outline-hidden transition-shadow focus-visible:ring-2 focus-visible:ring-accent disabled:cursor-default disabled:opacity-50",
74
+ dashed && "border-dashed border-muted",
75
+ checked && "ring-2 ring-accent ring-offset-2 ring-offset-surface",
76
+ )}
77
+ >
78
+ {/* Its colour in the swatches' theme; the ring in the page's. */}
79
+ <span
80
+ data-theme={theme}
81
+ className="block size-full rounded-full"
82
+ style={{ background: colour ?? unset }}
83
+ />
84
+ </button>
85
+ );
86
+ }
87
+
88
+ /** `colour` as `#rrggbb` for the native picker: a token resolved on `scope`, then drawn on a canvas. */
89
+ function hexOf(colour: string, scope: Element | null): string {
90
+ const name = /^var\((--[a-z0-9-]+)\)$/.exec(colour)?.[1];
91
+ const resolved = name && scope ? getComputedStyle(scope).getPropertyValue(name).trim() : colour;
92
+ const context = document.createElement("canvas").getContext("2d", { willReadFrequently: true });
93
+ if (!context) return "#808080";
94
+ context.fillStyle = "#808080";
95
+ context.fillStyle = resolved;
96
+ context.fillRect(0, 0, 1, 1);
97
+ const [r, g, b] = context.getImageData(0, 0, 1, 1).data;
98
+ return `#${[r, g, b].map((n) => n!.toString(16).padStart(2, "0")).join("")}`;
99
+ }
100
+
101
+ /** A colour among the theme's first (inline), then more (the popover), then any (Custom). */
102
+ function ColourPicker({
103
+ value,
104
+ onChange,
105
+ swatches = THEME_COLOURS,
106
+ groups = THEME_COLOUR_GROUPS,
107
+ defaultColour,
108
+ defaultName = "Default",
109
+ theme,
110
+ disabled,
111
+ invalid,
112
+ "aria-labelledby": labelledBy,
113
+ className,
114
+ }: ColourPickerProps) {
115
+ const [open, setOpen] = React.useState(false);
116
+ const scope = React.useRef<HTMLSpanElement>(null);
117
+ /** The picker's colour waiting for `timer`: chosen once it rests, or when the picker goes. */
118
+ const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
119
+ const waiting = React.useRef<string>(undefined);
120
+ /** The latest props, for a colour chosen after a render (the timer, the picker going). */
121
+ const latest = React.useRef({ value, onChange });
122
+ latest.current = { value, onChange };
123
+ const pick = (next: string | undefined) => {
124
+ clearTimeout(timer.current);
125
+ waiting.current = undefined;
126
+ if (next !== latest.current.value) latest.current.onChange(next);
127
+ };
128
+ React.useEffect(
129
+ () => () => {
130
+ if (waiting.current !== undefined) pick(waiting.current);
131
+ },
132
+ [],
133
+ );
134
+ const offered = [...swatches, ...groups.flatMap((group) => group.swatches)];
135
+ const named = offered.find((swatch) => swatch.value === value);
136
+ /** What Custom's field shows: a colour of its own, none for the default or a theme colour. */
137
+ const own = value !== undefined && named === undefined ? value : "";
138
+ const [text, setText] = React.useState(own);
139
+ React.useEffect(() => setText(own), [own]);
140
+ const commit = (typed: string) => pick(typed.trim() === "" ? undefined : typed.trim());
141
+ return (
142
+ <div
143
+ data-slot="colour-picker"
144
+ data-swatch-theme={theme}
145
+ className={cn("flex min-w-0 flex-col gap-1", className)}
146
+ >
147
+ {/* Where a token resolves in the swatches' theme (the native picker's colour). */}
148
+ <span ref={scope} data-theme={theme} hidden />
149
+ <div className="flex items-center gap-1.5">
150
+ <div role="radiogroup" aria-labelledby={labelledBy} className="flex items-center gap-1.5">
151
+ <Dot
152
+ colour={defaultColour}
153
+ name={defaultName}
154
+ dashed
155
+ theme={theme}
156
+ checked={value === undefined}
157
+ disabled={disabled}
158
+ onPick={() => pick(undefined)}
159
+ />
160
+ {swatches.map((swatch) => (
161
+ <Dot
162
+ key={swatch.value}
163
+ colour={swatch.value}
164
+ name={swatch.name}
165
+ theme={theme}
166
+ checked={swatch.value === value}
167
+ disabled={disabled}
168
+ onPick={() => pick(swatch.value)}
169
+ />
170
+ ))}
171
+ </div>
172
+ <PopoverPrimitive.Root open={open} onOpenChange={setOpen}>
173
+ <PopoverPrimitive.Trigger
174
+ disabled={disabled}
175
+ aria-label="More colours"
176
+ title="More colours"
177
+ data-slot="colour-more"
178
+ className="grid size-5 shrink-0 cursor-pointer place-items-center rounded-full border border-input bg-transparent text-xs leading-none text-secondary outline-hidden hover:bg-hover focus-visible:ring-2 focus-visible:ring-accent disabled:cursor-default disabled:opacity-50 data-popup-open:bg-active"
179
+ >
180
+ ⋯
181
+ </PopoverPrimitive.Trigger>
182
+ <CSPProvider disableStyleElements>
183
+ <PopoverPrimitive.Portal>
184
+ <PopoverPrimitive.Positioner sideOffset={6} align="start" className="z-50">
185
+ <PopoverPrimitive.Popup
186
+ data-slot="colour-popover"
187
+ className="flex w-64 flex-col gap-3 rounded-dropdown bg-surface p-3 outline-none"
188
+ style={{ boxShadow: "var(--shadow-dropdown)" }}
189
+ >
190
+ <div className="flex flex-col gap-2.5">
191
+ {/* The row's own first: the default and the inline swatches, under the first one's group. */}
192
+ <div role="radiogroup" aria-label="Theme" className="flex items-center gap-2">
193
+ <span className="w-16 shrink-0 text-xs text-muted">Theme</span>
194
+ <div className="flex flex-wrap gap-1.5">
195
+ <Dot
196
+ colour={defaultColour}
197
+ name={defaultName}
198
+ dashed
199
+ theme={theme}
200
+ checked={value === undefined}
201
+ onPick={() => {
202
+ pick(undefined);
203
+ setOpen(false);
204
+ }}
205
+ />
206
+ {swatches.map((swatch) => (
207
+ <Dot
208
+ key={swatch.value}
209
+ colour={swatch.value}
210
+ name={swatch.name}
211
+ theme={theme}
212
+ checked={swatch.value === value}
213
+ onPick={() => {
214
+ pick(swatch.value);
215
+ setOpen(false);
216
+ }}
217
+ />
218
+ ))}
219
+ </div>
220
+ </div>
221
+ {groups.map((group) => (
222
+ <div
223
+ key={group.label}
224
+ role="radiogroup"
225
+ aria-label={group.label}
226
+ className="flex items-center gap-2"
227
+ >
228
+ <span className="w-16 shrink-0 text-xs text-muted">{group.label}</span>
229
+ <div className="flex flex-wrap gap-1.5">
230
+ {group.swatches.map((swatch) => (
231
+ <Dot
232
+ key={swatch.value}
233
+ colour={swatch.value}
234
+ name={swatch.name}
235
+ theme={theme}
236
+ checked={swatch.value === value}
237
+ onPick={() => {
238
+ pick(swatch.value);
239
+ setOpen(false);
240
+ }}
241
+ />
242
+ ))}
243
+ </div>
244
+ </div>
245
+ ))}
246
+ </div>
247
+ <div className="h-px bg-border" />
248
+ <div className="flex flex-col gap-1.5">
249
+ <span className="text-xs text-muted">Custom</span>
250
+ <div className="flex items-center gap-2">
251
+ <label className="relative block size-(--height-md) shrink-0 cursor-pointer overflow-hidden rounded-control border border-input">
252
+ <span
253
+ data-theme={theme}
254
+ className="absolute inset-0"
255
+ style={{ background: value ?? defaultColour ?? unset }}
256
+ />
257
+ <input
258
+ type="color"
259
+ aria-label="Pick a colour"
260
+ value={hexOf(value ?? defaultColour ?? "#808080", scope.current)}
261
+ className="absolute inset-0 size-full cursor-[inherit] opacity-0"
262
+ // While the picker drags: shown, then chosen once it rests.
263
+ onChange={(event) => {
264
+ const picked = event.target.value;
265
+ setText(picked);
266
+ clearTimeout(timer.current);
267
+ waiting.current = picked;
268
+ timer.current = setTimeout(() => commit(picked), 200);
269
+ }}
270
+ />
271
+ </label>
272
+ <Input
273
+ variant="outline"
274
+ aria-label="A CSS colour"
275
+ aria-invalid={invalid || undefined}
276
+ spellCheck={false}
277
+ autoComplete="off"
278
+ placeholder="#2f855a, oklch(62% 0.14 165)…"
279
+ className="min-w-0 flex-1 font-mono text-xs"
280
+ value={text}
281
+ onChange={(event) => setText(event.currentTarget.value)}
282
+ onBlur={(event) => commit(event.currentTarget.value)}
283
+ onKeyDown={(event) => {
284
+ if (event.key === "Enter" && !isComposing(event))
285
+ commit(event.currentTarget.value);
286
+ else if (event.key === "Escape") setText(own);
287
+ }}
288
+ />
289
+ </div>
290
+ </div>
291
+ </PopoverPrimitive.Popup>
292
+ </PopoverPrimitive.Positioner>
293
+ </PopoverPrimitive.Portal>
294
+ </CSPProvider>
295
+ </PopoverPrimitive.Root>
296
+ </div>
297
+ {/* Under the row, so a long name never pushes what follows. */}
298
+ <span
299
+ data-slot="colour-name"
300
+ title={value}
301
+ className={cn(
302
+ "min-w-0 truncate text-xs",
303
+ invalid ? "text-destructive" : "text-secondary",
304
+ value !== undefined && named === undefined && "font-mono",
305
+ )}
306
+ >
307
+ {value === undefined ? defaultName : (named?.name ?? value)}
308
+ </span>
309
+ </div>
310
+ );
311
+ }
312
+
313
+ export { ColourPicker };
314
+ export type { ColourPickerProps };
@@ -0,0 +1,4 @@
1
+ export { ColourPicker } from "./colour-picker";
2
+ export type { ColourPickerProps } from "./colour-picker";
3
+ export { THEME_COLOURS, THEME_COLOUR_GROUPS } from "../../../theme/theme-colours";
4
+ export type { ColourGroup, ColourSwatch } from "../../../theme/theme-colours";
@@ -0,0 +1,75 @@
1
+ name: Combobox
2
+ description: "Single-value picker on Base UI: an input framed like Input outline to type in, and a Select-style popup of the caller's items, filtered in place or searched on the server."
3
+ layer: core
4
+ category: input
5
+ when_to_use:
6
+ - "For choosing one record from a long list, or one loaded from the server as the user types"
7
+ when_not_to_use:
8
+ - "For a short fixed list — use Select"
9
+ - "For several values — use TagInput"
10
+ - "For a property on a detail card (a pill that opens a searchable menu) — use Picker"
11
+ composition_partners:
12
+ - Field (label, description, error)
13
+ props:
14
+ - name: value / onValueChange
15
+ type: "Item | null / (item: Item) => void | Promise<unknown>"
16
+ required: true
17
+ description: "Controlled selection, matched by itemToKey. Clearing the text or Escape never picks null (the value stays): offer a 'None' item to unassign. When onValueChange returns a promise (an async save), the picked label shows until value changes or the promise settles (a failure reverts to value)"
18
+ - name: items
19
+ type: "readonly Item[]"
20
+ required: true
21
+ description: "What the popup offers now"
22
+ - name: itemToString / itemToKey
23
+ type: "(item: Item) => string"
24
+ required: true
25
+ description: "The item's label (input text, default filter) and its identity (selected check, keys)"
26
+ - name: onInputChange
27
+ type: "(text: string) => void"
28
+ required: false
29
+ description: "The text the user types, and '' once the popup has closed: the caller fetches here"
30
+ - name: onOpenChange
31
+ type: "(open: boolean) => void"
32
+ required: false
33
+ description: "The popup opened or closed, e.g. to retry a failed load on open"
34
+ - name: filter
35
+ type: "null"
36
+ required: false
37
+ description: "null shows items unfiltered (server-searched); by default 'contains', any case and accent"
38
+ - name: loading / emptyText
39
+ type: "boolean / ReactNode"
40
+ required: false
41
+ default: "false / 'No results'"
42
+ description: "Shown while the list is empty: 'Loading…' while loading, else emptyText (also for a fetch error)"
43
+ - name: renderItem
44
+ type: "(item: Item) => ReactNode"
45
+ required: false
46
+ description: "An item's row content; defaults to its label"
47
+ - name: size
48
+ type: "'sm' | 'default' | 'lg'"
49
+ required: false
50
+ default: "'default'"
51
+ description: "Height, as SelectTrigger, Input and Button: sm (h-sm, 26px) in property rows, default (h-md, 30px), lg (h-lg, 34px) in a form whose controls all take lg; at the look's default Control height, which they follow"
52
+ - name: placeholder / disabled / readOnly / aria-label / className
53
+ type: "string / boolean / boolean / string / string"
54
+ required: false
55
+ description: "className goes on the frame"
56
+ examples:
57
+ - title: "Server-searched organization"
58
+ code: |
59
+ const [query, setQuery] = useState("");
60
+ const { items, loading, error } = useOrganizations(query); // GET /organizations?q=…&take=20
61
+
62
+ <Combobox
63
+ aria-label="Organization"
64
+ size="sm"
65
+ value={current}
66
+ onValueChange={(org) => save(org.id)}
67
+ items={[none, ...items]}
68
+ itemToString={(org) => org.name}
69
+ itemToKey={(org) => org.id}
70
+ onInputChange={setQuery}
71
+ filter={null}
72
+ loading={loading}
73
+ emptyText={error ? "Organizations could not be loaded" : "No organizations"}
74
+ />
75
+ accessibility_notes: "Base UI combobox semantics (input role=combobox, listbox popup, aria-activedescendant); ↑↓ move, Enter picks, Escape closes and reverts the text, Tab leaves; the empty/loading text is a polite live region; labelled by aria-label or a surrounding FieldLabel."