@bridgebrew/ui 0.0.0-stage → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (411) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +39 -2
  3. package/SOURCE.md +182 -0
  4. package/dist/build.js +871 -0
  5. package/dist/theme-css.js +896 -0
  6. package/dist/themes.js +69 -0
  7. package/dist/types/build/stylesheet.d.ts +31 -0
  8. package/dist/types/components/composite/command/command.d.ts +94 -0
  9. package/dist/types/components/composite/command/index.d.ts +2 -0
  10. package/dist/types/components/composite/draft-bar/draft-bar.d.ts +12 -0
  11. package/dist/types/components/composite/draft-bar/index.d.ts +2 -0
  12. package/dist/types/components/composite/image-field/image-field.d.ts +33 -0
  13. package/dist/types/components/composite/image-field/index.d.ts +2 -0
  14. package/dist/types/components/composite/list/index.d.ts +3 -0
  15. package/dist/types/components/composite/list/list-swipe.d.ts +28 -0
  16. package/dist/types/components/composite/list/list.d.ts +95 -0
  17. package/dist/types/components/composite/picker/index.d.ts +2 -0
  18. package/dist/types/components/composite/picker/picker.d.ts +44 -0
  19. package/dist/types/components/composite/prompt-field/index.d.ts +2 -0
  20. package/dist/types/components/composite/prompt-field/prompt-field.d.ts +18 -0
  21. package/dist/types/components/composite/properties/index.d.ts +2 -0
  22. package/dist/types/components/composite/properties/properties.d.ts +24 -0
  23. package/dist/types/components/composite/snooze-menu/index.d.ts +4 -0
  24. package/dist/types/components/composite/snooze-menu/presets.d.ts +36 -0
  25. package/dist/types/components/composite/snooze-menu/snooze-menu.d.ts +27 -0
  26. package/dist/types/components/composite/tag-input/index.d.ts +2 -0
  27. package/dist/types/components/composite/tag-input/tag-input.d.ts +22 -0
  28. package/dist/types/components/composite/wizard/index.d.ts +2 -0
  29. package/dist/types/components/composite/wizard/wizard.d.ts +53 -0
  30. package/dist/types/components/core/avatar/avatar.d.ts +16 -0
  31. package/dist/types/components/core/avatar/index.d.ts +2 -0
  32. package/dist/types/components/core/badge/badge.d.ts +8 -0
  33. package/dist/types/components/core/badge/index.d.ts +2 -0
  34. package/dist/types/components/core/breadcrumb/breadcrumb.d.ts +21 -0
  35. package/dist/types/components/core/breadcrumb/index.d.ts +2 -0
  36. package/dist/types/components/core/bullets/bullets.d.ts +15 -0
  37. package/dist/types/components/core/bullets/index.d.ts +2 -0
  38. package/dist/types/components/core/button/button.d.ts +14 -0
  39. package/dist/types/components/core/button/index.d.ts +2 -0
  40. package/dist/types/components/core/card/card.d.ts +16 -0
  41. package/dist/types/components/core/card/index.d.ts +2 -0
  42. package/dist/types/components/core/checkbox/checkbox.d.ts +15 -0
  43. package/dist/types/components/core/checkbox/index.d.ts +2 -0
  44. package/dist/types/components/core/cluster/cluster.d.ts +5 -0
  45. package/dist/types/components/core/cluster/index.d.ts +1 -0
  46. package/dist/types/components/core/code-block/code-block.d.ts +18 -0
  47. package/dist/types/components/core/code-block/index.d.ts +2 -0
  48. package/dist/types/components/core/collapsible/collapsible.d.ts +8 -0
  49. package/dist/types/components/core/collapsible/index.d.ts +1 -0
  50. package/dist/types/components/core/colour-picker/colour-picker.d.ts +25 -0
  51. package/dist/types/components/core/colour-picker/index.d.ts +4 -0
  52. package/dist/types/components/core/combobox/combobox.d.ts +63 -0
  53. package/dist/types/components/core/combobox/index.d.ts +2 -0
  54. package/dist/types/components/core/detail/detail.d.ts +12 -0
  55. package/dist/types/components/core/detail/index.d.ts +1 -0
  56. package/dist/types/components/core/dialog/dialog.d.ts +43 -0
  57. package/dist/types/components/core/dialog/drag.d.ts +4 -0
  58. package/dist/types/components/core/dialog/index.d.ts +2 -0
  59. package/dist/types/components/core/drop-zone/drop-zone.d.ts +23 -0
  60. package/dist/types/components/core/drop-zone/index.d.ts +2 -0
  61. package/dist/types/components/core/dropdown-menu/dropdown-menu.d.ts +78 -0
  62. package/dist/types/components/core/dropdown-menu/index.d.ts +2 -0
  63. package/dist/types/components/core/editable-field/editable-field.d.ts +42 -0
  64. package/dist/types/components/core/editable-field/index.d.ts +2 -0
  65. package/dist/types/components/core/empty-state/empty-state.d.ts +11 -0
  66. package/dist/types/components/core/empty-state/index.d.ts +2 -0
  67. package/dist/types/components/core/field/field.d.ts +31 -0
  68. package/dist/types/components/core/field/index.d.ts +2 -0
  69. package/dist/types/components/core/icon/icon-sets.d.ts +38 -0
  70. package/dist/types/components/core/icon/icon.d.ts +14 -0
  71. package/dist/types/components/core/icon/index.d.ts +2 -0
  72. package/dist/types/components/core/input/index.d.ts +4 -0
  73. package/dist/types/components/core/input/input.d.ts +22 -0
  74. package/dist/types/components/core/input/textarea.d.ts +8 -0
  75. package/dist/types/components/core/kbd/index.d.ts +2 -0
  76. package/dist/types/components/core/kbd/kbd.d.ts +7 -0
  77. package/dist/types/components/core/label/index.d.ts +2 -0
  78. package/dist/types/components/core/label/label.d.ts +13 -0
  79. package/dist/types/components/core/main-content/index.d.ts +2 -0
  80. package/dist/types/components/core/main-content/main-content.d.ts +18 -0
  81. package/dist/types/components/core/pane/index.d.ts +1 -0
  82. package/dist/types/components/core/pane/pane.d.ts +12 -0
  83. package/dist/types/components/core/pick-menu/index.d.ts +4 -0
  84. package/dist/types/components/core/pick-menu/pick-menu.d.ts +57 -0
  85. package/dist/types/components/core/pick-menu/tag-menu.d.ts +19 -0
  86. package/dist/types/components/core/popover/index.d.ts +2 -0
  87. package/dist/types/components/core/popover/popover.d.ts +22 -0
  88. package/dist/types/components/core/progress/index.d.ts +2 -0
  89. package/dist/types/components/core/progress/progress.d.ts +13 -0
  90. package/dist/types/components/core/resizable/index.d.ts +2 -0
  91. package/dist/types/components/core/resizable/resizable.d.ts +15 -0
  92. package/dist/types/components/core/resizable/use-remembered-layout.d.ts +31 -0
  93. package/dist/types/components/core/screen-link/index.d.ts +2 -0
  94. package/dist/types/components/core/screen-link/screen-link.d.ts +52 -0
  95. package/dist/types/components/core/scroll-area/index.d.ts +2 -0
  96. package/dist/types/components/core/scroll-area/scroll-area.d.ts +13 -0
  97. package/dist/types/components/core/scroll-area/steps.d.ts +5 -0
  98. package/dist/types/components/core/section/index.d.ts +2 -0
  99. package/dist/types/components/core/section/section.d.ts +16 -0
  100. package/dist/types/components/core/segment-group/index.d.ts +2 -0
  101. package/dist/types/components/core/segment-group/segment-group.d.ts +24 -0
  102. package/dist/types/components/core/select/index.d.ts +2 -0
  103. package/dist/types/components/core/select/select.d.ts +39 -0
  104. package/dist/types/components/core/skeleton/index.d.ts +2 -0
  105. package/dist/types/components/core/skeleton/skeleton.d.ts +13 -0
  106. package/dist/types/components/core/slider/index.d.ts +2 -0
  107. package/dist/types/components/core/slider/slider.d.ts +9 -0
  108. package/dist/types/components/core/sortable/index.d.ts +2 -0
  109. package/dist/types/components/core/sortable/sortable.d.ts +53 -0
  110. package/dist/types/components/core/split-view/index.d.ts +2 -0
  111. package/dist/types/components/core/split-view/split-view.d.ts +28 -0
  112. package/dist/types/components/core/status-icon/index.d.ts +2 -0
  113. package/dist/types/components/core/status-icon/status-icon.d.ts +13 -0
  114. package/dist/types/components/core/table/collapsible-rows.d.ts +7 -0
  115. package/dist/types/components/core/table/expand-toggle.d.ts +10 -0
  116. package/dist/types/components/core/table/group-header.d.ts +14 -0
  117. package/dist/types/components/core/table/index.d.ts +8 -0
  118. package/dist/types/components/core/table/table.d.ts +31 -0
  119. package/dist/types/components/core/tabs/index.d.ts +2 -0
  120. package/dist/types/components/core/tabs/tabs.d.ts +20 -0
  121. package/dist/types/components/core/tag-pill/index.d.ts +2 -0
  122. package/dist/types/components/core/tag-pill/tag-pill.d.ts +25 -0
  123. package/dist/types/components/core/thumbnail/index.d.ts +2 -0
  124. package/dist/types/components/core/thumbnail/thumbnail.d.ts +23 -0
  125. package/dist/types/components/core/toast/index.d.ts +2 -0
  126. package/dist/types/components/core/toast/toast.d.ts +88 -0
  127. package/dist/types/components/core/toggle/index.d.ts +2 -0
  128. package/dist/types/components/core/toggle/toggle.d.ts +9 -0
  129. package/dist/types/components/core/toggle-group/index.d.ts +2 -0
  130. package/dist/types/components/core/toggle-group/toggle-group.d.ts +21 -0
  131. package/dist/types/components/core/tooltip/index.d.ts +2 -0
  132. package/dist/types/components/core/tooltip/tooltip.d.ts +33 -0
  133. package/dist/types/components/layout/multi-pane/index.d.ts +4 -0
  134. package/dist/types/components/layout/multi-pane/list-detail.d.ts +17 -0
  135. package/dist/types/components/layout/multi-pane/multi-pane.d.ts +34 -0
  136. package/dist/types/components/layout/single-pane/index.d.ts +2 -0
  137. package/dist/types/components/layout/single-pane/single-pane.d.ts +11 -0
  138. package/dist/types/components/shell/app-shell/app-shell.d.ts +12 -0
  139. package/dist/types/components/shell/app-shell/index.d.ts +2 -0
  140. package/dist/types/components/shell/sidebar/index.d.ts +2 -0
  141. package/dist/types/components/shell/sidebar/sidebar-group.d.ts +45 -0
  142. package/dist/types/components/shell/sidebar/sidebar-item.d.ts +19 -0
  143. package/dist/types/components/shell/sidebar/sidebar-resize-handle.d.ts +17 -0
  144. package/dist/types/components/shell/sidebar/sidebar-tree.d.ts +42 -0
  145. package/dist/types/components/shell/sidebar/sidebar.d.ts +27 -0
  146. package/dist/types/components/template/address-book-template/address-book-template.d.ts +15 -0
  147. package/dist/types/components/template/address-book-template/index.d.ts +2 -0
  148. package/dist/types/components/template/mail-template/index.d.ts +2 -0
  149. package/dist/types/components/template/mail-template/mail-template.d.ts +11 -0
  150. package/dist/types/components/template/use-narrow.d.ts +3 -0
  151. package/dist/types/index.d.ts +149 -0
  152. package/dist/types/kit/check-rendering.d.ts +3 -0
  153. package/dist/types/kit/kit.d.ts +76 -0
  154. package/dist/types/lib/clipboard.d.ts +5 -0
  155. package/dist/types/lib/dates.d.ts +9 -0
  156. package/dist/types/lib/json.d.ts +26 -0
  157. package/dist/types/lib/keys.d.ts +15 -0
  158. package/dist/types/lib/utils.d.ts +2 -0
  159. package/dist/types/lib/view-scope.d.ts +22 -0
  160. package/dist/types/profile/profile.d.ts +34 -0
  161. package/dist/types/theme/appearance.d.ts +31 -0
  162. package/dist/types/theme/boot.d.ts +3 -0
  163. package/dist/types/theme/client-appearance-react.d.ts +3 -0
  164. package/dist/types/theme/client-appearance.d.ts +69 -0
  165. package/dist/types/theme/generate-tokens.d.ts +45 -0
  166. package/dist/types/theme/pack-themes-react.d.ts +24 -0
  167. package/dist/types/theme/palette.d.ts +111 -0
  168. package/dist/types/theme/semantic-mapping.d.ts +28 -0
  169. package/dist/types/theme/set-theme.d.ts +30 -0
  170. package/dist/types/theme/theme-colours.d.ts +14 -0
  171. package/dist/types/theme/theme-css.d.ts +3 -0
  172. package/dist/types/theme/themes.d.ts +63 -0
  173. package/dist/types/theme/wallpaper-sheet.d.ts +16 -0
  174. package/dist/types/theme/wallpaper-theme-react.d.ts +7 -0
  175. package/dist/types/theme/wallpaper-theme.d.ts +37 -0
  176. package/package.json +87 -3
  177. package/src/build/stylesheet.ts +128 -0
  178. package/src/components/composite/command/command.meta.yaml +74 -0
  179. package/src/components/composite/command/command.tsx +939 -0
  180. package/src/components/composite/command/index.ts +17 -0
  181. package/src/components/composite/draft-bar/draft-bar.meta.yaml +19 -0
  182. package/src/components/composite/draft-bar/draft-bar.tsx +57 -0
  183. package/src/components/composite/draft-bar/index.ts +2 -0
  184. package/src/components/composite/image-field/image-field.meta.yaml +69 -0
  185. package/src/components/composite/image-field/image-field.tsx +267 -0
  186. package/src/components/composite/image-field/index.ts +2 -0
  187. package/src/components/composite/list/index.ts +18 -0
  188. package/src/components/composite/list/list-swipe.tsx +163 -0
  189. package/src/components/composite/list/list.meta.yaml +238 -0
  190. package/src/components/composite/list/list.tsx +868 -0
  191. package/src/components/composite/picker/index.ts +2 -0
  192. package/src/components/composite/picker/picker.meta.yaml +103 -0
  193. package/src/components/composite/picker/picker.tsx +276 -0
  194. package/src/components/composite/prompt-field/index.ts +2 -0
  195. package/src/components/composite/prompt-field/prompt-field.meta.yaml +60 -0
  196. package/src/components/composite/prompt-field/prompt-field.tsx +81 -0
  197. package/src/components/composite/properties/index.ts +9 -0
  198. package/src/components/composite/properties/properties.meta.yaml +56 -0
  199. package/src/components/composite/properties/properties.tsx +132 -0
  200. package/src/components/composite/snooze-menu/index.ts +11 -0
  201. package/src/components/composite/snooze-menu/presets.ts +169 -0
  202. package/src/components/composite/snooze-menu/snooze-menu.meta.yaml +58 -0
  203. package/src/components/composite/snooze-menu/snooze-menu.tsx +146 -0
  204. package/src/components/composite/tag-input/index.ts +2 -0
  205. package/src/components/composite/tag-input/tag-input.meta.yaml +51 -0
  206. package/src/components/composite/tag-input/tag-input.tsx +404 -0
  207. package/src/components/composite/wizard/index.ts +2 -0
  208. package/src/components/composite/wizard/wizard.meta.yaml +73 -0
  209. package/src/components/composite/wizard/wizard.tsx +256 -0
  210. package/src/components/core/avatar/avatar.meta.yaml +71 -0
  211. package/src/components/core/avatar/avatar.tsx +92 -0
  212. package/src/components/core/avatar/index.ts +2 -0
  213. package/src/components/core/badge/badge.meta.yaml +34 -0
  214. package/src/components/core/badge/badge.tsx +23 -0
  215. package/src/components/core/badge/index.ts +2 -0
  216. package/src/components/core/breadcrumb/breadcrumb.meta.yaml +45 -0
  217. package/src/components/core/breadcrumb/breadcrumb.tsx +110 -0
  218. package/src/components/core/breadcrumb/index.ts +2 -0
  219. package/src/components/core/bullets/bullets.meta.yaml +37 -0
  220. package/src/components/core/bullets/bullets.tsx +60 -0
  221. package/src/components/core/bullets/index.ts +2 -0
  222. package/src/components/core/button/button.meta.yaml +91 -0
  223. package/src/components/core/button/button.tsx +93 -0
  224. package/src/components/core/button/index.ts +2 -0
  225. package/src/components/core/card/card.meta.yaml +94 -0
  226. package/src/components/core/card/card.tsx +54 -0
  227. package/src/components/core/card/index.ts +2 -0
  228. package/src/components/core/checkbox/checkbox.meta.yaml +59 -0
  229. package/src/components/core/checkbox/checkbox.tsx +106 -0
  230. package/src/components/core/checkbox/index.ts +2 -0
  231. package/src/components/core/cluster/cluster.meta.yaml +4 -0
  232. package/src/components/core/cluster/cluster.tsx +17 -0
  233. package/src/components/core/cluster/index.ts +1 -0
  234. package/src/components/core/code-block/code-block.meta.yaml +30 -0
  235. package/src/components/core/code-block/code-block.tsx +93 -0
  236. package/src/components/core/code-block/index.ts +2 -0
  237. package/src/components/core/collapsible/collapsible.meta.yaml +34 -0
  238. package/src/components/core/collapsible/collapsible.tsx +54 -0
  239. package/src/components/core/collapsible/index.ts +1 -0
  240. package/src/components/core/colour-picker/colour-picker.meta.yaml +52 -0
  241. package/src/components/core/colour-picker/colour-picker.tsx +314 -0
  242. package/src/components/core/colour-picker/index.ts +4 -0
  243. package/src/components/core/combobox/combobox.meta.yaml +75 -0
  244. package/src/components/core/combobox/combobox.tsx +288 -0
  245. package/src/components/core/combobox/index.ts +2 -0
  246. package/src/components/core/detail/detail.meta.yaml +13 -0
  247. package/src/components/core/detail/detail.tsx +73 -0
  248. package/src/components/core/detail/index.ts +1 -0
  249. package/src/components/core/dialog/dialog.meta.yaml +95 -0
  250. package/src/components/core/dialog/dialog.tsx +254 -0
  251. package/src/components/core/dialog/drag.ts +40 -0
  252. package/src/components/core/dialog/index.ts +25 -0
  253. package/src/components/core/drop-zone/drop-zone.meta.yaml +55 -0
  254. package/src/components/core/drop-zone/drop-zone.tsx +146 -0
  255. package/src/components/core/drop-zone/index.ts +2 -0
  256. package/src/components/core/dropdown-menu/dropdown-menu.meta.yaml +118 -0
  257. package/src/components/core/dropdown-menu/dropdown-menu.tsx +407 -0
  258. package/src/components/core/dropdown-menu/index.ts +32 -0
  259. package/src/components/core/editable-field/editable-field.meta.yaml +120 -0
  260. package/src/components/core/editable-field/editable-field.tsx +346 -0
  261. package/src/components/core/editable-field/index.ts +2 -0
  262. package/src/components/core/empty-state/empty-state.meta.yaml +21 -0
  263. package/src/components/core/empty-state/empty-state.tsx +42 -0
  264. package/src/components/core/empty-state/index.ts +2 -0
  265. package/src/components/core/field/field.meta.yaml +37 -0
  266. package/src/components/core/field/field.tsx +100 -0
  267. package/src/components/core/field/index.ts +9 -0
  268. package/src/components/core/icon/curated-names.json +107 -0
  269. package/src/components/core/icon/icon-sets.ts +109 -0
  270. package/src/components/core/icon/icon.meta.yaml +30 -0
  271. package/src/components/core/icon/icon.tsx +93 -0
  272. package/src/components/core/icon/index.ts +2 -0
  273. package/src/components/core/input/index.ts +4 -0
  274. package/src/components/core/input/input.meta.yaml +98 -0
  275. package/src/components/core/input/input.tsx +133 -0
  276. package/src/components/core/input/textarea.meta.yaml +79 -0
  277. package/src/components/core/input/textarea.tsx +63 -0
  278. package/src/components/core/kbd/index.ts +2 -0
  279. package/src/components/core/kbd/kbd.meta.yaml +12 -0
  280. package/src/components/core/kbd/kbd.tsx +29 -0
  281. package/src/components/core/label/index.ts +2 -0
  282. package/src/components/core/label/label.meta.yaml +55 -0
  283. package/src/components/core/label/label.tsx +72 -0
  284. package/src/components/core/main-content/index.ts +2 -0
  285. package/src/components/core/main-content/main-content.meta.yaml +23 -0
  286. package/src/components/core/main-content/main-content.tsx +49 -0
  287. package/src/components/core/pane/index.ts +1 -0
  288. package/src/components/core/pane/pane.meta.yaml +13 -0
  289. package/src/components/core/pane/pane.tsx +64 -0
  290. package/src/components/core/pick-menu/index.ts +4 -0
  291. package/src/components/core/pick-menu/pick-menu.meta.yaml +36 -0
  292. package/src/components/core/pick-menu/pick-menu.tsx +348 -0
  293. package/src/components/core/pick-menu/tag-menu.meta.yaml +7 -0
  294. package/src/components/core/pick-menu/tag-menu.tsx +79 -0
  295. package/src/components/core/popover/index.ts +2 -0
  296. package/src/components/core/popover/popover.meta.yaml +16 -0
  297. package/src/components/core/popover/popover.tsx +66 -0
  298. package/src/components/core/progress/index.ts +2 -0
  299. package/src/components/core/progress/progress.meta.yaml +47 -0
  300. package/src/components/core/progress/progress.tsx +56 -0
  301. package/src/components/core/resizable/index.ts +13 -0
  302. package/src/components/core/resizable/resizable.meta.yaml +110 -0
  303. package/src/components/core/resizable/resizable.tsx +125 -0
  304. package/src/components/core/resizable/use-remembered-layout.ts +261 -0
  305. package/src/components/core/screen-link/index.ts +2 -0
  306. package/src/components/core/screen-link/screen-link.meta.yaml +34 -0
  307. package/src/components/core/screen-link/screen-link.tsx +100 -0
  308. package/src/components/core/scroll-area/index.ts +2 -0
  309. package/src/components/core/scroll-area/scroll-area.meta.yaml +72 -0
  310. package/src/components/core/scroll-area/scroll-area.tsx +95 -0
  311. package/src/components/core/scroll-area/steps.tsx +72 -0
  312. package/src/components/core/section/index.ts +2 -0
  313. package/src/components/core/section/section.meta.yaml +72 -0
  314. package/src/components/core/section/section.tsx +93 -0
  315. package/src/components/core/segment-group/index.ts +2 -0
  316. package/src/components/core/segment-group/segment-group.meta.yaml +71 -0
  317. package/src/components/core/segment-group/segment-group.tsx +166 -0
  318. package/src/components/core/select/index.ts +20 -0
  319. package/src/components/core/select/select.meta.yaml +48 -0
  320. package/src/components/core/select/select.tsx +226 -0
  321. package/src/components/core/skeleton/index.ts +2 -0
  322. package/src/components/core/skeleton/skeleton.meta.yaml +50 -0
  323. package/src/components/core/skeleton/skeleton.tsx +71 -0
  324. package/src/components/core/slider/index.ts +2 -0
  325. package/src/components/core/slider/slider.meta.yaml +55 -0
  326. package/src/components/core/slider/slider.tsx +46 -0
  327. package/src/components/core/sortable/index.ts +16 -0
  328. package/src/components/core/sortable/sortable.meta.yaml +125 -0
  329. package/src/components/core/sortable/sortable.tsx +471 -0
  330. package/src/components/core/split-view/index.ts +2 -0
  331. package/src/components/core/split-view/split-view.meta.yaml +85 -0
  332. package/src/components/core/split-view/split-view.tsx +193 -0
  333. package/src/components/core/status-icon/index.ts +2 -0
  334. package/src/components/core/status-icon/status-icon.meta.yaml +64 -0
  335. package/src/components/core/status-icon/status-icon.tsx +94 -0
  336. package/src/components/core/table/collapsible-rows.tsx +30 -0
  337. package/src/components/core/table/expand-toggle.tsx +58 -0
  338. package/src/components/core/table/group-header.tsx +35 -0
  339. package/src/components/core/table/index.ts +26 -0
  340. package/src/components/core/table/table.meta.yaml +67 -0
  341. package/src/components/core/table/table.tsx +166 -0
  342. package/src/components/core/tabs/index.ts +2 -0
  343. package/src/components/core/tabs/tabs.meta.yaml +57 -0
  344. package/src/components/core/tabs/tabs.tsx +74 -0
  345. package/src/components/core/tag-pill/index.ts +2 -0
  346. package/src/components/core/tag-pill/tag-pill.meta.yaml +19 -0
  347. package/src/components/core/tag-pill/tag-pill.tsx +102 -0
  348. package/src/components/core/thumbnail/index.ts +2 -0
  349. package/src/components/core/thumbnail/thumbnail.meta.yaml +59 -0
  350. package/src/components/core/thumbnail/thumbnail.tsx +162 -0
  351. package/src/components/core/toast/index.ts +12 -0
  352. package/src/components/core/toast/toast.meta.yaml +93 -0
  353. package/src/components/core/toast/toast.tsx +763 -0
  354. package/src/components/core/toggle/index.ts +2 -0
  355. package/src/components/core/toggle/toggle.meta.yaml +53 -0
  356. package/src/components/core/toggle/toggle.tsx +44 -0
  357. package/src/components/core/toggle-group/index.ts +2 -0
  358. package/src/components/core/toggle-group/toggle-group.meta.yaml +59 -0
  359. package/src/components/core/toggle-group/toggle-group.tsx +68 -0
  360. package/src/components/core/tooltip/index.ts +7 -0
  361. package/src/components/core/tooltip/tooltip.meta.yaml +93 -0
  362. package/src/components/core/tooltip/tooltip.tsx +198 -0
  363. package/src/components/layout/multi-pane/index.ts +4 -0
  364. package/src/components/layout/multi-pane/list-detail.tsx +45 -0
  365. package/src/components/layout/multi-pane/multi-pane.meta.yaml +67 -0
  366. package/src/components/layout/multi-pane/multi-pane.tsx +158 -0
  367. package/src/components/layout/single-pane/index.ts +2 -0
  368. package/src/components/layout/single-pane/single-pane.meta.yaml +35 -0
  369. package/src/components/layout/single-pane/single-pane.tsx +48 -0
  370. package/src/components/shell/app-shell/app-shell.meta.yaml +65 -0
  371. package/src/components/shell/app-shell/app-shell.tsx +61 -0
  372. package/src/components/shell/app-shell/index.ts +2 -0
  373. package/src/components/shell/sidebar/index.ts +35 -0
  374. package/src/components/shell/sidebar/sidebar-group.tsx +254 -0
  375. package/src/components/shell/sidebar/sidebar-item.tsx +88 -0
  376. package/src/components/shell/sidebar/sidebar-resize-handle.tsx +101 -0
  377. package/src/components/shell/sidebar/sidebar-tree.tsx +325 -0
  378. package/src/components/shell/sidebar/sidebar.meta.yaml +126 -0
  379. package/src/components/shell/sidebar/sidebar.tsx +142 -0
  380. package/src/components/template/address-book-template/address-book-template.meta.yaml +22 -0
  381. package/src/components/template/address-book-template/address-book-template.tsx +201 -0
  382. package/src/components/template/address-book-template/index.ts +2 -0
  383. package/src/components/template/mail-template/index.ts +2 -0
  384. package/src/components/template/mail-template/mail-template.meta.yaml +22 -0
  385. package/src/components/template/mail-template/mail-template.tsx +731 -0
  386. package/src/components/template/use-narrow.ts +18 -0
  387. package/src/index.ts +505 -0
  388. package/src/kit/check-rendering.tsx +130 -0
  389. package/src/kit/kit.tsx +177 -0
  390. package/src/lib/clipboard.ts +27 -0
  391. package/src/lib/dates.ts +13 -0
  392. package/src/lib/json.ts +59 -0
  393. package/src/lib/keys.ts +54 -0
  394. package/src/lib/utils.ts +12 -0
  395. package/src/lib/view-scope.tsx +60 -0
  396. package/src/profile/profile.ts +238 -0
  397. package/src/theme/appearance.ts +198 -0
  398. package/src/theme/boot.ts +6 -0
  399. package/src/theme/client-appearance-react.ts +14 -0
  400. package/src/theme/client-appearance.ts +284 -0
  401. package/src/theme/generate-tokens.ts +658 -0
  402. package/src/theme/pack-themes-react.ts +107 -0
  403. package/src/theme/palette.ts +301 -0
  404. package/src/theme/semantic-mapping.ts +165 -0
  405. package/src/theme/set-theme.ts +162 -0
  406. package/src/theme/theme-colours.ts +60 -0
  407. package/src/theme/theme-css.ts +15 -0
  408. package/src/theme/themes.ts +133 -0
  409. package/src/theme/wallpaper-sheet.ts +58 -0
  410. package/src/theme/wallpaper-theme-react.ts +60 -0
  411. package/src/theme/wallpaper-theme.ts +231 -0
@@ -0,0 +1,658 @@
1
+ /**
2
+ * Bridge UI Token Generator
3
+ *
4
+ * Reads the default themes' palette YAML from a folder its host gives (`palettes`: one `<id>.yaml` per
5
+ * theme of THEMES; Bridge's are its `themes-default` pack's), derives all semantic tokens via the
6
+ * palette engine, and returns the kit's theme CSS: one [data-theme="<id>"] block per theme, the
7
+ * Tailwind bridge, and the static tokens (appended verbatim).
8
+ *
9
+ * Usage: generateThemeCss(palettes) — the host calls it once at start and compiles Tailwind over
10
+ * it; the result is never committed.
11
+ *
12
+ * CSS contract: the generated CSS contains only token variables, the Tailwind bridge,
13
+ * static tokens, and component-scoped rules ([data-slot], keyframes). It carries NO bare
14
+ * HTML tag selectors and NO geometry on native elements; the host compiles it with
15
+ * Tailwind's theme and utilities layers only (no preflight).
16
+ */
17
+
18
+ import { readFileSync } from "node:fs";
19
+ import { join } from "node:path";
20
+ import { parse as parseYaml } from "yaml";
21
+ import {
22
+ type PaletteInput,
23
+ type PaletteOverrides,
24
+ type HueName,
25
+ HUE_NAMES,
26
+ parseOklch,
27
+ oklchToString,
28
+ derivePalette,
29
+ } from "./palette.ts";
30
+ import { mapPaletteToTokens, type SemanticTokens } from "./semantic-mapping.ts";
31
+ import { DEFAULT_THEME, THEMES } from "./themes.ts";
32
+ import { rgbToOklch, wallpaperPalette } from "./wallpaper-theme.ts";
33
+
34
+ // The default themes' palettes are an input (research-078): Bridge's live in its `themes-default` pack (research-038);
35
+ // the kit compiles them into its own stylesheet for the first paint and as every pack theme's fallback.
36
+
37
+ // ─── YAML Parsing ───────────────────────────────────────────────────────────
38
+
39
+ interface RawPalette {
40
+ name: string;
41
+ type: "dark" | "light";
42
+ accent: HueName;
43
+ bg: string;
44
+ fg: string;
45
+ hues: Record<string, string>;
46
+ "accent-fg"?: string;
47
+ sidebar?: string;
48
+ "fg-muted"?: string;
49
+ /** The two colours a painted canvas takes when a workspace's look leaves them unset (research-028 A6). */
50
+ paint: { c1: string; c2: string };
51
+ }
52
+
53
+ /** Each theme's paint seeds (`--paint-c1`, `--paint-c2`), by theme name, as `loadPalette` read them. */
54
+ const paints = new Map<string, { c1: string; c2: string }>();
55
+
56
+ export function loadPalette(filePath: string): PaletteInput {
57
+ const raw = parseYaml(readFileSync(filePath, "utf-8")) as RawPalette;
58
+ return readPalette(raw, filePath);
59
+ }
60
+
61
+ /** A palette read and checked (`where` names it in an error); its paint seeds are kept by name. */
62
+ function readPalette(raw: RawPalette, filePath: string): PaletteInput {
63
+ if (raw.type !== "dark" && raw.type !== "light") {
64
+ throw new Error(`Invalid type "${raw.type}" in ${filePath} — must be "dark" or "light"`);
65
+ }
66
+ if (!HUE_NAMES.includes(raw.accent as HueName)) {
67
+ throw new Error(
68
+ `Invalid accent "${raw.accent}" in ${filePath} — must be one of: ${HUE_NAMES.join(", ")}`,
69
+ );
70
+ }
71
+
72
+ const bg = parseOklch(raw.bg);
73
+ const fg = parseOklch(raw.fg);
74
+ if (!bg || !fg) {
75
+ throw new Error(`Invalid bg/fg in ${filePath}`);
76
+ }
77
+
78
+ const hues = {} as PaletteInput["hues"];
79
+ for (const hue of HUE_NAMES) {
80
+ const normalStr = raw.hues[hue];
81
+ const brightStr = raw.hues[`${hue}-bright`];
82
+ if (!normalStr || !brightStr) {
83
+ throw new Error(`Missing hue ${hue} in ${filePath}`);
84
+ }
85
+ const normal = parseOklch(normalStr);
86
+ const bright = parseOklch(brightStr);
87
+ if (!normal || !bright) {
88
+ throw new Error(`Invalid OKLCH for ${hue} in ${filePath}`);
89
+ }
90
+ hues[hue] = { normal, bright };
91
+ }
92
+
93
+ // Optional overrides (Bridge addition): each, when present, must be a valid OKLCH string.
94
+ const overrides: PaletteOverrides = {};
95
+ for (const [key, field] of [
96
+ ["accent-fg", "accentFg"],
97
+ ["sidebar", "sidebar"],
98
+ ["fg-muted", "fgMuted"],
99
+ ] as const) {
100
+ const value = raw[key];
101
+ if (value === undefined) continue;
102
+ const color = parseOklch(value);
103
+ if (!color) throw new Error(`Invalid OKLCH for ${key} in ${filePath}`);
104
+ overrides[field] = color;
105
+ }
106
+
107
+ // Written back from the parsed colour, never as given: `parseOklch` finds a colour inside the text, so text around it
108
+ // (`…); } body { …`) would otherwise reach the stylesheet.
109
+ const paint = { c1: "", c2: "" };
110
+ for (const seed of ["c1", "c2"] as const) {
111
+ const colour = parseOklch(raw.paint?.[seed] ?? "");
112
+ if (!colour) throw new Error(`Invalid or missing paint.${seed} (OKLCH) in ${filePath}`);
113
+ paint[seed] = oklchToString(colour);
114
+ }
115
+ paints.set(raw.name, paint);
116
+
117
+ return {
118
+ name: raw.name,
119
+ type: raw.type,
120
+ accent: raw.accent,
121
+ bg,
122
+ fg,
123
+ hues,
124
+ ...(Object.keys(overrides).length > 0 && { overrides }),
125
+ };
126
+ }
127
+
128
+ // ─── CSS Generation ─────────────────────────────────────────────────────────
129
+
130
+ function formatColorBlock(
131
+ tokens: SemanticTokens,
132
+ indent: string = " ",
133
+ paint?: { c1: string; c2: string },
134
+ ): string {
135
+ const lines: string[] = [];
136
+
137
+ // Group by category for readability
138
+ const bgTokens = Object.entries(tokens.colors).filter(([k]) => k.startsWith("--bg"));
139
+ const fgTokens = Object.entries(tokens.colors).filter(([k]) => k.startsWith("--fg"));
140
+ const borderTokens = Object.entries(tokens.colors).filter(([k]) => k.startsWith("--border"));
141
+ const accentTokens = Object.entries(tokens.colors).filter(([k]) => k.startsWith("--accent"));
142
+ const semanticTokens = Object.entries(tokens.colors).filter(
143
+ ([k]) =>
144
+ k.startsWith("--destructive") ||
145
+ k.startsWith("--warning") ||
146
+ k.startsWith("--success") ||
147
+ k.startsWith("--merged"),
148
+ );
149
+ const labelTokens = Object.entries(tokens.colors).filter(([k]) => k.startsWith("--label"));
150
+
151
+ const writeGroup = (comment: string, entries: [string, string][]) => {
152
+ if (entries.length === 0) return;
153
+ lines.push(`${indent}/* ${comment} */`);
154
+ for (const [key, value] of entries) {
155
+ lines.push(`${indent}${key}: ${value};`);
156
+ }
157
+ lines.push("");
158
+ };
159
+
160
+ writeGroup("Backgrounds", bgTokens);
161
+ writeGroup("Foregrounds", fgTokens);
162
+ writeGroup("Borders", borderTokens);
163
+ writeGroup("Accent", accentTokens);
164
+ writeGroup("Semantic", semanticTokens);
165
+ writeGroup("Labels", labelTokens);
166
+
167
+ // Paint seeds (Bridge): what a workspace's painted canvas takes where its look sets no colour
168
+ if (paint)
169
+ writeGroup("Paint seeds", [
170
+ ["--paint-c1", paint.c1],
171
+ ["--paint-c2", paint.c2],
172
+ ]);
173
+
174
+ // Shadows
175
+ lines.push(`${indent}/* Overlay shadows */`);
176
+ for (const [key, value] of Object.entries(tokens.shadows)) {
177
+ lines.push(`${indent}${key}: ${value};`);
178
+ }
179
+
180
+ // color-scheme, light too (Bridge): a light [data-theme] must undo the dark :root default
181
+ lines.push("");
182
+ lines.push(`${indent}color-scheme: ${tokens.colorScheme};`);
183
+
184
+ return lines.join("\n");
185
+ }
186
+
187
+ function generateTokensCss(
188
+ palettes: Map<string, { input: PaletteInput; tokens: SemanticTokens }>,
189
+ ): string {
190
+ const sections: string[] = [];
191
+
192
+ // ── File header ──
193
+ sections.push(`/* =============================================================================
194
+ Bridge UI Design Tokens — Generated by palette system at host start
195
+ Source: plugins/themes-default/themes/*.yaml (Bridge's own themes in themes.ts)
196
+
197
+ Three-layer pattern:
198
+ 1. :root / [data-theme] — Semantic CSS custom properties (theme-switchable)
199
+ 2. @theme inline — Bridge to Tailwind utility classes (runtime-switchable)
200
+ 3. @theme — Static tokens (spacing, typography, shadows)
201
+ + component-scoped rules — [data-slot] reset, animations / keyframes
202
+
203
+ CSS contract: variables + component-scoped rules only. No bare HTML tag
204
+ selectors; no geometry on native elements.
205
+
206
+ Color format: OKLCH — perceptually uniform, enables programmatic hue shifts.
207
+ ============================================================================= */
208
+
209
+ :root {
210
+ /* Base radius for inline style usage */
211
+ --radius: 5px;
212
+ }`);
213
+
214
+ // ── Layer 1: the default theme on :root, following the system (before the boot kernel runs, or
215
+ // with no valid data-theme), then one [data-theme] block per v0 theme. Same specificity: the
216
+ // [data-theme] blocks come later, so they win.
217
+ sections.push(`
218
+ /* Default: ${DEFAULT_THEME.light} / ${DEFAULT_THEME.dark} following the system */
219
+
220
+ :root {
221
+ ${formatColorBlock(palettes.get(DEFAULT_THEME.light)!.tokens, " ", paints.get(DEFAULT_THEME.light))}
222
+ }
223
+
224
+ @media (prefers-color-scheme: dark) {
225
+ :root {
226
+ ${formatColorBlock(palettes.get(DEFAULT_THEME.dark)!.tokens, " ", paints.get(DEFAULT_THEME.dark))}
227
+ }
228
+ }`);
229
+
230
+ for (const { id, label } of THEMES) {
231
+ const palette = palettes.get(id)!;
232
+ const typeLabel = palette.input.type === "dark" ? "Dark" : "Light";
233
+
234
+ sections.push(`
235
+ /* =============================================================================
236
+ ${label} — ${typeLabel} Theme
237
+ ============================================================================= */
238
+
239
+ [data-theme="${id}"] {
240
+ ${formatColorBlock(palette.tokens, " ", paints.get(id))}
241
+ }`);
242
+ }
243
+
244
+ // ── Layer 2: Tailwind bridge ──
245
+ sections.push(`
246
+ /* =============================================================================
247
+ Layer 2: Tailwind Utility Bridge
248
+ @theme inline prevents build-time resolution of var() — required for
249
+ runtime theme switching via data-theme attribute.
250
+ ============================================================================= */
251
+
252
+ @theme inline {
253
+ /* Clear default Tailwind palette, preserve essentials */
254
+ --color-*: initial;
255
+ --color-white: #ffffff;
256
+ --color-black: #000000;
257
+ --color-transparent: transparent;
258
+
259
+ /* Background surfaces */
260
+ --color-background: var(--bg);
261
+ --color-surface: var(--bg-surface);
262
+ --color-hover: var(--bg-hover);
263
+ --color-active: var(--bg-active);
264
+ --color-sidebar: var(--bg-sidebar);
265
+ --color-badge: var(--bg-badge);
266
+
267
+ /* Foreground text */
268
+ --color-foreground: var(--fg);
269
+ --color-secondary: var(--fg-secondary);
270
+ --color-muted: var(--fg-muted);
271
+ --color-placeholder: var(--fg-placeholder);
272
+
273
+ /* Borders */
274
+ --color-border: var(--border);
275
+ --color-border-subtle: var(--border-subtle);
276
+ --color-input: var(--border-input);
277
+
278
+ /* Accent */
279
+ --color-accent: var(--accent);
280
+ --color-accent-hover: var(--accent-hover);
281
+ --color-accent-foreground: var(--accent-fg);
282
+ --color-accent-subtle: var(--accent-subtle);
283
+
284
+ /* Semantic */
285
+ --color-destructive: var(--destructive);
286
+ --color-destructive-subtle: var(--destructive-subtle);
287
+ --color-destructive-foreground: var(--destructive-fg);
288
+ --color-success: var(--success);
289
+ --color-success-subtle: var(--success-subtle);
290
+ --color-success-foreground: var(--success-fg);
291
+ --color-warning: var(--warning);
292
+ --color-warning-subtle: var(--warning-subtle);
293
+ --color-warning-foreground: var(--warning-fg);
294
+ --color-warning-text: var(--warning-text);
295
+ --color-merged: var(--merged);
296
+
297
+ /* Labels */
298
+ --color-label-bug-bg: var(--label-bug-bg);
299
+ --color-label-bug-fg: var(--label-bug-fg);
300
+ --color-label-bug-dot: var(--label-bug-dot);
301
+ --color-label-feature-bg: var(--label-feature-bg);
302
+ --color-label-feature-fg: var(--label-feature-fg);
303
+ --color-label-feature-dot: var(--label-feature-dot);
304
+ --color-label-improvement-bg: var(--label-improvement-bg);
305
+ --color-label-improvement-fg: var(--label-improvement-fg);
306
+ --color-label-improvement-dot: var(--label-improvement-dot);
307
+ --color-label-tag-dot: var(--label-tag-dot);
308
+ }`);
309
+
310
+ // ── Layer 3: Static tokens (verbatim) ──
311
+ sections.push(`
312
+ /* =============================================================================
313
+ Layer 3: Static Tokens
314
+ These never change between themes — safe to resolve at build time.
315
+ ============================================================================= */
316
+
317
+ /* The two bases the controls are drawn from: the look's "Control height" and "Control radius" (the appearance
318
+ plugin's settings) set them on <html>; a page without them (tests, a plugin in development) keeps these. */
319
+ :root {
320
+ --control-height: 30px;
321
+ --control-radius: 8px;
322
+ }
323
+
324
+ @theme {
325
+ /* ---------------------------------------------------------------------------
326
+ Component Heights — exposed as h-xs, h-sm, h-md, h-lg utilities; a zoom of the control height
327
+ (md), whole pixels: 28px gives 20 / 24 / 28 / 32, 30px gives 21 / 26 / 30 / 34
328
+ --------------------------------------------------------------------------- */
329
+ --height-xs: round(var(--control-height) * 5 / 7, 1px);
330
+ --height-sm: round(var(--control-height) * 6 / 7, 1px);
331
+ --height-md: var(--control-height);
332
+ --height-lg: round(var(--control-height) * 8 / 7, 1px);
333
+
334
+ /* ---------------------------------------------------------------------------
335
+ Border Radius — every control a row holds on the control radius (rounded-control); what sits
336
+ inside its 2px frame (a segment's thumb) on rounded-control-inner
337
+ --------------------------------------------------------------------------- */
338
+ --radius-control: var(--control-radius);
339
+ --radius-control-inner: max(0px, var(--control-radius) - 2px);
340
+ /* The small corners never rounder than the controls: below 5px they follow it (checkboxes and panels included), at 0 square. */
341
+ --radius-sm: min(4px, var(--control-radius));
342
+ --radius-default: min(5px, var(--control-radius));
343
+ /* A menu's surface wraps its items (rounded-control) 4px away (p-1); a dialog never under 8px. */
344
+ --radius-dropdown: calc(var(--control-radius) + 4px);
345
+ --radius-dialog: max(8px, var(--control-radius));
346
+
347
+ /* ---------------------------------------------------------------------------
348
+ Border Width — 0.5px hairline (Linear-inspired)
349
+ --------------------------------------------------------------------------- */
350
+ --border-width: 0.5px;
351
+
352
+ /* ---------------------------------------------------------------------------
353
+ Spacing
354
+ Base unit for Tailwind v4 multiplier system: p-4 = calc(0.25rem * 4) = 1rem
355
+ --------------------------------------------------------------------------- */
356
+ --spacing: 0.25rem;
357
+
358
+ /* ---------------------------------------------------------------------------
359
+ Typography — Font Families
360
+ --------------------------------------------------------------------------- */
361
+ --font-*: initial;
362
+ --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
363
+ --font-mono: "SF Mono", "SFMono-Regular", Menlo, Consolas, "Liberation Mono", monospace;
364
+
365
+ /* ---------------------------------------------------------------------------
366
+ Typography — Font Sizes + Paired Line Heights
367
+ 6-level scale with ≥2px gaps
368
+ --------------------------------------------------------------------------- */
369
+ --text-xs: 0.75rem;
370
+ --text-xs--line-height: 1rem;
371
+ --text-sm: 0.875rem;
372
+ --text-sm--line-height: 1.25rem;
373
+ --text-base: 1rem;
374
+ --text-base--line-height: 1.5rem;
375
+ --text-lg: 1.25rem;
376
+ --text-lg--line-height: 1.75rem;
377
+ --text-xl: 1.5rem;
378
+ --text-xl--line-height: 2rem;
379
+ --text-2xl: 1.875rem;
380
+ --text-2xl--line-height: 2.375rem;
381
+
382
+ /* Purpose-specific typography tokens (not part of the ordinal scale) */
383
+ --text-field: 0.9375rem;
384
+ --text-field--line-height: 1.375rem;
385
+
386
+ /* ---------------------------------------------------------------------------
387
+ Typography — Font Weights
388
+ --------------------------------------------------------------------------- */
389
+ --font-weight-normal: 400;
390
+ --font-weight-medium: 500;
391
+ --font-weight-semibold: 600;
392
+ --font-weight-bold: 700;
393
+
394
+ /* ---------------------------------------------------------------------------
395
+ Typography — Letter Spacing
396
+ --------------------------------------------------------------------------- */
397
+ --tracking-tight: -0.025em;
398
+ --tracking-normal: 0em;
399
+ --tracking-wide: 0.025em;
400
+
401
+ /* ---------------------------------------------------------------------------
402
+ Typography — Line Heights (standalone)
403
+ --------------------------------------------------------------------------- */
404
+ --leading-tight: 1.25;
405
+ --leading-normal: 1.5;
406
+ --leading-relaxed: 1.625;
407
+
408
+ /* ---------------------------------------------------------------------------
409
+ Shadows — 4 tiers (sm, md, lg, xl) + extended range (xs, 2xl)
410
+ --------------------------------------------------------------------------- */
411
+ --shadow-xs: 0 1px 2px 0 rgb(0 0 0 / 0.05);
412
+ --shadow-sm: 0 1px 3px 0 rgb(0 0 0 / 0.1),
413
+ 0 1px 2px -1px rgb(0 0 0 / 0.1);
414
+ --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1),
415
+ 0 2px 4px -2px rgb(0 0 0 / 0.1);
416
+ --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1),
417
+ 0 4px 6px -4px rgb(0 0 0 / 0.1);
418
+ --shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1),
419
+ 0 8px 10px -6px rgb(0 0 0 / 0.1);
420
+ --shadow-2xl: 0 25px 50px -12px rgb(0 0 0 / 0.25);
421
+ }`);
422
+
423
+ // ── Component reset (Bridge): without Tailwind's preflight, the kit resets only what it renders
424
+ // ([data-slot]), in the base layer so every utility still wins; bare HTML elements are untouched.
425
+ sections.push(`
426
+ /* =============================================================================
427
+ Component Reset — the kit's own elements only
428
+ ============================================================================= */
429
+
430
+ @layer base {
431
+ :where([data-slot]),
432
+ :where([data-slot])::before,
433
+ :where([data-slot])::after {
434
+ box-sizing: border-box;
435
+ margin: 0;
436
+ padding: 0;
437
+ border: 0 solid;
438
+ }
439
+
440
+ :where([data-slot]) {
441
+ font-family: var(--font-sans);
442
+ font-size: inherit;
443
+ font-weight: inherit;
444
+ line-height: inherit;
445
+ color: inherit;
446
+ background: transparent;
447
+ }
448
+
449
+ /* Base UI's scrollbar hiding (ScrollArea viewport, Select popup): the kit turns off its inline
450
+ <style> elements, which the page's CSP refuses, and ships the same rule here. */
451
+ .base-ui-disable-scrollbar {
452
+ scrollbar-width: none;
453
+ }
454
+
455
+ .base-ui-disable-scrollbar::-webkit-scrollbar {
456
+ display: none;
457
+ }
458
+ }`);
459
+
460
+ // ── Animations: Overlay components (component-scoped [data-slot], not bare-tag) ──
461
+ sections.push(`
462
+ /* =============================================================================
463
+ Animations — Overlay Components
464
+ ============================================================================= */
465
+
466
+ @keyframes tooltip-fade-in {
467
+ from { opacity: 0; }
468
+ to { opacity: 1; }
469
+ }
470
+
471
+ [data-slot="tooltip-content"] {
472
+ animation: tooltip-fade-in 200ms ease-out both;
473
+ }
474
+
475
+ @keyframes toast-slide-in {
476
+ from { transform: translateX(100%); }
477
+ to { transform: translateX(0); }
478
+ }
479
+
480
+ [data-slot="toast"] {
481
+ animation: toast-slide-in 200ms ease-out both;
482
+ }
483
+
484
+ /* A toast's countdown bar (data-slot="toast-countdown"): drains left to right over the toast's duration. */
485
+ @keyframes toast-countdown {
486
+ from { transform: scaleX(1); }
487
+ to { transform: scaleX(0); }
488
+ }
489
+
490
+ /* SortableBoard's drag overlay settling after a swing: a damped pendulum from --swing-from. */
491
+ @keyframes bridge-ui-swing-settle {
492
+ 0% { transform: rotate(var(--swing-from)); }
493
+ 20% { transform: rotate(calc(var(--swing-from) * -0.35)); }
494
+ 40% { transform: rotate(calc(var(--swing-from) * 0.18)); }
495
+ 60% { transform: rotate(calc(var(--swing-from) * -0.08)); }
496
+ 80% { transform: rotate(calc(var(--swing-from) * 0.03)); }
497
+ 100% { transform: rotate(0deg); }
498
+ }`);
499
+
500
+ return sections.join("\n") + "\n";
501
+ }
502
+
503
+ // ─── Entry point ────────────────────────────────────────────────────────────
504
+
505
+ /** The derived tokens of every v0 theme, by id, in THEMES order, from the folder `palettes`. Throws on a missing or
506
+ * invalid palette. */
507
+ export function themeTokens(
508
+ palettes: string,
509
+ ): Map<string, { input: PaletteInput; tokens: SemanticTokens }> {
510
+ const tokens = new Map<string, { input: PaletteInput; tokens: SemanticTokens }>();
511
+ for (const { id, type, wallpaper } of THEMES) {
512
+ if (wallpaper) {
513
+ // Drawn in the page from the wallpaper; here, without one (./wallpaper-theme.ts).
514
+ const { input, paint } = wallpaperPalette(undefined, type);
515
+ paints.set(id, { c1: oklchToString(paint.c1), c2: oklchToString(paint.c2) });
516
+ tokens.set(id, { input, tokens: mapPaletteToTokens(derivePalette(input)) });
517
+ continue;
518
+ }
519
+ const input = loadPalette(join(palettes, `${id}.yaml`));
520
+ if (input.name !== id)
521
+ throw new Error(
522
+ `themes-default/themes/${id}.yaml: name "${input.name}" does not match its file`,
523
+ );
524
+ if (input.type !== type)
525
+ throw new Error(
526
+ `themes-default/themes/${id}.yaml: type "${input.type}" but THEMES says "${type}"`,
527
+ );
528
+ tokens.set(id, { input, tokens: mapPaletteToTokens(derivePalette(input)) });
529
+ }
530
+ return tokens;
531
+ }
532
+
533
+ /** The kit's theme CSS (Tailwind input): the v0 theme blocks from the folder `palettes`, the Tailwind bridge, and the
534
+ * static tokens. */
535
+ export function generateThemeCss(palettes: string): string {
536
+ return generateTokensCss(themeTokens(palettes));
537
+ }
538
+
539
+ // ─── Pack themes (research-038) ─────────────────────────────────────────────
540
+
541
+ /** A theme a pack brings, as its page lists it. */
542
+ export interface PackThemeInfo {
543
+ id: string;
544
+ label: string;
545
+ type: "light" | "dark";
546
+ }
547
+
548
+ const themeName = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
549
+ const isObject = (value: unknown): value is Record<string, unknown> =>
550
+ typeof value === "object" && value !== null && !Array.isArray(value);
551
+
552
+ /** `#rgb` or `#rrggbb` as an OKLCH string; anything else as given. */
553
+ export function colourOf(value: unknown): unknown {
554
+ if (typeof value !== "string") return value;
555
+ const hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(value.trim())?.[1];
556
+ if (hex === undefined) return value;
557
+ const full = hex.length === 3 ? [...hex].map((digit) => digit + digit).join("") : hex;
558
+ const [r, g, b] = [0, 2, 4].map((at) => parseInt(full.slice(at, at + 2), 16)) as [
559
+ number,
560
+ number,
561
+ number,
562
+ ];
563
+ return oklchToString(rgbToOklch(r, g, b));
564
+ }
565
+
566
+ /** A pack's theme file, read (`raw`, parsed YAML or JSON) into its page entry and its `[data-theme]` block. Only
567
+ * `name`, `type`, `bg` and `fg` are required; whatever else it leaves out is the default theme's of the same type
568
+ * (accent, hues, paint), and every token is then derived from its own palette (research-038 T3). Colours are OKLCH
569
+ * or `#rrggbb`. `tokens` sets single tokens over the derived ones. `palettes`: the default themes' folder, as
570
+ * `generateThemeCss`'s. Throws an Error naming what is wrong. */
571
+ export function packTheme(raw: unknown, palettes: string): { info: PackThemeInfo; css: string } {
572
+ if (!isObject(raw)) throw new Error("a theme file is an object: name, type, bg, fg…");
573
+ const { name, type, label, tokens } = raw;
574
+ if (typeof name !== "string" || !themeName.test(name) || name.length > 40)
575
+ throw new Error(
576
+ "name is kebab-case (lowercase letters, digits, single hyphens), at most 40 characters",
577
+ );
578
+ if (THEMES.some((theme) => theme.id === name))
579
+ throw new Error(`name ${name} is one of Bridge's own themes: choose another`);
580
+ if (type !== "light" && type !== "dark") throw new Error('type is "light" or "dark"');
581
+ if (label !== undefined && (typeof label !== "string" || label.length === 0 || label.length > 60))
582
+ throw new Error("label is a text of 1 to 60 characters");
583
+ const fallback = defaultRaw(type, palettes);
584
+ const hues = isObject(raw.hues) ? raw.hues : {};
585
+ const paint = isObject(raw.paint) ? raw.paint : {};
586
+ const merged = {
587
+ ...fallback,
588
+ name,
589
+ type,
590
+ accent: raw.accent ?? fallback.accent,
591
+ bg: colourOf(raw.bg),
592
+ fg: colourOf(raw.fg),
593
+ hues: Object.fromEntries(
594
+ Object.entries(fallback.hues).map(([hue, value]) => [
595
+ hue,
596
+ colourOf(hues[hue] ?? brightOf(hues, hue, type) ?? value),
597
+ ]),
598
+ ),
599
+ paint: {
600
+ c1: colourOf(paint.c1 ?? fallback.paint.c1),
601
+ c2: colourOf(paint.c2 ?? fallback.paint.c2),
602
+ },
603
+ ...Object.fromEntries(
604
+ (["accent-fg", "sidebar", "fg-muted"] as const).map((key) => [key, colourOf(raw[key])]),
605
+ ),
606
+ };
607
+ for (const key of ["bg", "fg"] as const)
608
+ if (typeof merged[key] !== "string" || !parseOklch(merged[key]))
609
+ throw new Error(`${key} is a colour: oklch(…) or #rrggbb`);
610
+ const input = readPalette(merged as RawPalette, name);
611
+ const derived = mapPaletteToTokens(derivePalette(input));
612
+ // Set again at the end: a token the block's groups leave out (one Bridge adds later) is set too.
613
+ const overrides: string[] = [];
614
+ if (tokens !== undefined) {
615
+ if (!isObject(tokens)) throw new Error('tokens is an object: { "--border": "oklch(…)" }');
616
+ for (const [token, value] of Object.entries(tokens)) {
617
+ if (!/^--[a-z0-9-]+$/.test(token))
618
+ throw new Error(`tokens.${token}: a token is --kebab-case`);
619
+ const colour = colourOf(value);
620
+ if (typeof colour !== "string" || colour.length > 200 || /[;{}<>\\]/.test(colour))
621
+ throw new Error(`tokens.${token}: a CSS value without ; { } < > or \\`);
622
+ derived.colors[token] = colour;
623
+ overrides.push(` ${token}: ${colour};`);
624
+ }
625
+ }
626
+ const info: PackThemeInfo = { id: name, label: label ?? humanizeName(name), type };
627
+ return {
628
+ info,
629
+ css: `[data-theme="${name}"] {\n${formatColorBlock(derived, " ", paints.get(name))}\n${overrides.map((line) => `${line}\n`).join("")}}\n`,
630
+ };
631
+ }
632
+
633
+ /** `<hue>-bright` a theme leaves out but whose `<hue>` it gives: that hue lighter in a dark theme, darker in a light one
634
+ * (as the kit's palettes have it), so it never takes the default theme's other hue. */
635
+ function brightOf(hues: Record<string, unknown>, hue: string, type: "light" | "dark") {
636
+ const normal = hue.endsWith("-bright") ? colourOf(hues[hue.slice(0, -7)]) : undefined;
637
+ const parsed = typeof normal === "string" ? parseOklch(normal) : null;
638
+ if (!parsed) return undefined;
639
+ return oklchToString({ ...parsed, l: parsed.l + (type === "dark" ? 0.08 : -0.09) });
640
+ }
641
+
642
+ const humanizeName = (name: string) =>
643
+ name
644
+ .split("-")
645
+ .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
646
+ .join(" ");
647
+
648
+ /** The default theme of `type`'s palette file in `palettes`, as written (the fallback of a pack theme). */
649
+ const defaultRaws = new Map<string, RawPalette>();
650
+ function defaultRaw(type: "light" | "dark", palettes: string): RawPalette {
651
+ const file = join(palettes, `${DEFAULT_THEME[type]}.yaml`);
652
+ let raw = defaultRaws.get(file);
653
+ if (raw === undefined) {
654
+ raw = parseYaml(readFileSync(file, "utf-8")) as RawPalette;
655
+ defaultRaws.set(file, raw);
656
+ }
657
+ return raw;
658
+ }