@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,254 @@
1
+ import * as React from "react";
2
+ import { Dialog as DialogPrimitive } from "@base-ui/react/dialog";
3
+ import { cva, type VariantProps } from "class-variance-authority";
4
+
5
+ import { cn } from "../../../lib/utils";
6
+ import { useCapability, useKitRoot } from "../../../kit/kit";
7
+ import { dragByTitleBar } from "./drag";
8
+
9
+ // --- DialogContent maximize context (opt-in via `maximizable`) ---
10
+
11
+ interface DialogContentContextValue {
12
+ maximizable: boolean;
13
+ maximized: boolean;
14
+ setMaximized: (value: boolean) => void;
15
+ }
16
+
17
+ const DialogContentContext = React.createContext<DialogContentContextValue | null>(null);
18
+
19
+ // --- Dialog (root) ---
20
+
21
+ interface DialogProps extends React.ComponentProps<typeof DialogPrimitive.Root> {}
22
+
23
+ function Dialog(props: DialogProps) {
24
+ return <DialogPrimitive.Root {...props} />;
25
+ }
26
+
27
+ // --- DialogTrigger ---
28
+
29
+ interface DialogTriggerProps extends React.ComponentProps<typeof DialogPrimitive.Trigger> {}
30
+
31
+ function DialogTrigger({ className, ...props }: DialogTriggerProps) {
32
+ return <DialogPrimitive.Trigger data-slot="dialog-trigger" className={className} {...props} />;
33
+ }
34
+
35
+ // --- DialogContent (wraps Overlay + Content inside Portal) ---
36
+
37
+ const dialogContentVariants = cva(
38
+ "fixed left-1/2 top-1/2 z-50 -translate-x-1/2 -translate-y-1/2 bg-surface rounded-dialog flex flex-col overflow-hidden transition-[width,height,max-height] duration-200 ease-out [interpolate-size:allow-keywords]",
39
+ {
40
+ variants: {
41
+ fullscreen: {
42
+ false: "w-[560px] max-w-[calc(100vw-2rem)] h-auto max-h-[80vh]",
43
+ true: "w-[90vw] h-[90vh] max-h-[90vh]",
44
+ },
45
+ },
46
+ defaultVariants: {
47
+ fullscreen: false,
48
+ },
49
+ },
50
+ );
51
+
52
+ interface DialogContentProps
53
+ extends
54
+ React.ComponentProps<typeof DialogPrimitive.Popup>,
55
+ VariantProps<typeof dialogContentVariants> {
56
+ /** Allow the user to toggle the dialog between its size and fullscreen via
57
+ * a <DialogMaximize /> button placed in the header. Opt-in (default false). */
58
+ maximizable?: boolean;
59
+ /** Classes of the backdrop behind it (a darker one for an image viewer). */
60
+ backdropClassName?: string;
61
+ }
62
+
63
+ function DialogContent({
64
+ className,
65
+ children,
66
+ fullscreen,
67
+ maximizable = false,
68
+ backdropClassName,
69
+ ...props
70
+ }: DialogContentProps) {
71
+ const [maximized, setMaximized] = React.useState(Boolean(fullscreen));
72
+ // When maximizable, the toggle drives the size; otherwise `fullscreen` is static.
73
+ const isFullscreen = maximizable ? maximized : fullscreen;
74
+ const draggable = useCapability("dialog.dragByTitleBar");
75
+ const root = useKitRoot("dialog.content");
76
+ return (
77
+ <DialogPrimitive.Portal>
78
+ <DialogPrimitive.Backdrop
79
+ data-slot="dialog-overlay"
80
+ className={cn("fixed inset-0 z-50 bg-black/30", backdropClassName)}
81
+ />
82
+ <DialogPrimitive.Popup
83
+ data-slot="dialog-content"
84
+ className={cn(
85
+ dialogContentVariants({ fullscreen: isFullscreen, className }),
86
+ draggable && "[transform:translate(var(--dialog-drag-x,0px),var(--dialog-drag-y,0px))]",
87
+ )}
88
+ style={{ boxShadow: "var(--shadow-dialog)" }}
89
+ render={root && ((wiring) => root(wiring as React.ComponentPropsWithRef<"div">))}
90
+ {...props}
91
+ >
92
+ <DialogContentContext.Provider value={{ maximizable, maximized, setMaximized }}>
93
+ {children}
94
+ </DialogContentContext.Provider>
95
+ </DialogPrimitive.Popup>
96
+ </DialogPrimitive.Portal>
97
+ );
98
+ }
99
+
100
+ // --- DialogHeader ---
101
+
102
+ interface DialogHeaderProps extends React.ComponentProps<"div"> {}
103
+
104
+ function DialogHeader({ className, onPointerDown, ...props }: DialogHeaderProps) {
105
+ const draggable = useCapability("dialog.dragByTitleBar");
106
+ return (
107
+ <div
108
+ data-slot="dialog-header"
109
+ data-draggable={draggable || undefined}
110
+ className={cn("flex items-center pl-3 pr-2 pt-2 gap-1", className)}
111
+ onPointerDown={(event) => {
112
+ onPointerDown?.(event);
113
+ if (draggable && !event.defaultPrevented) dragByTitleBar(event);
114
+ }}
115
+ {...props}
116
+ />
117
+ );
118
+ }
119
+
120
+ // --- DialogBody ---
121
+
122
+ interface DialogBodyProps extends React.ComponentProps<"div"> {}
123
+
124
+ function DialogBody({ className, ...props }: DialogBodyProps) {
125
+ return <div data-slot="dialog-body" className={cn("flex-1 px-5 pt-3", className)} {...props} />;
126
+ }
127
+
128
+ // --- DialogFooter ---
129
+
130
+ interface DialogFooterProps extends React.ComponentProps<"div"> {}
131
+
132
+ function DialogFooter({ className, ...props }: DialogFooterProps) {
133
+ return (
134
+ <div
135
+ data-slot="dialog-footer"
136
+ className={cn("flex items-center px-3 py-2.5 border-t border-border", className)}
137
+ {...props}
138
+ />
139
+ );
140
+ }
141
+
142
+ // --- DialogTitle ---
143
+
144
+ interface DialogTitleProps extends React.ComponentProps<typeof DialogPrimitive.Title> {}
145
+
146
+ function DialogTitle({ className, ...props }: DialogTitleProps) {
147
+ return (
148
+ <DialogPrimitive.Title
149
+ data-slot="dialog-title"
150
+ className={cn("text-base font-medium flex-1", className)}
151
+ {...props}
152
+ />
153
+ );
154
+ }
155
+
156
+ // --- DialogDescription ---
157
+
158
+ interface DialogDescriptionProps extends React.ComponentProps<typeof DialogPrimitive.Description> {}
159
+
160
+ function DialogDescription({ className, ...props }: DialogDescriptionProps) {
161
+ return (
162
+ <DialogPrimitive.Description
163
+ data-slot="dialog-description"
164
+ className={cn("text-sm text-muted", className)}
165
+ {...props}
166
+ />
167
+ );
168
+ }
169
+
170
+ // --- DialogClose ---
171
+
172
+ interface DialogCloseProps extends React.ComponentProps<typeof DialogPrimitive.Close> {}
173
+
174
+ function DialogClose({ className, ...props }: DialogCloseProps) {
175
+ return <DialogPrimitive.Close data-slot="dialog-close" className={className} {...props} />;
176
+ }
177
+
178
+ // --- DialogMaximize (opt-in toggle; renders only inside a maximizable content) ---
179
+
180
+ interface DialogMaximizeProps extends React.ComponentProps<"button"> {}
181
+
182
+ function DialogMaximize({ className, onClick, ...props }: DialogMaximizeProps) {
183
+ const ctx = React.useContext(DialogContentContext);
184
+ if (!ctx?.maximizable) return null;
185
+ const { maximized, setMaximized } = ctx;
186
+ return (
187
+ <button
188
+ type="button"
189
+ data-slot="dialog-maximize"
190
+ aria-label={maximized ? "Restore" : "Maximize"}
191
+ aria-pressed={maximized}
192
+ className={className}
193
+ {...props}
194
+ onClick={(event) => {
195
+ onClick?.(event);
196
+ if (!event.defaultPrevented) setMaximized(!maximized);
197
+ }}
198
+ >
199
+ <svg
200
+ width="15"
201
+ height="15"
202
+ viewBox="0 0 24 24"
203
+ fill="none"
204
+ stroke="currentColor"
205
+ strokeWidth="2"
206
+ strokeLinecap="round"
207
+ strokeLinejoin="round"
208
+ aria-hidden="true"
209
+ >
210
+ {maximized ? (
211
+ <>
212
+ <polyline points="4 14 10 14 10 20" />
213
+ <polyline points="20 10 14 10 14 4" />
214
+ <line x1="14" y1="10" x2="21" y2="3" />
215
+ <line x1="3" y1="21" x2="10" y2="14" />
216
+ </>
217
+ ) : (
218
+ <>
219
+ <polyline points="15 3 21 3 21 9" />
220
+ <polyline points="9 21 3 21 3 15" />
221
+ <line x1="21" y1="3" x2="14" y2="10" />
222
+ <line x1="3" y1="21" x2="10" y2="14" />
223
+ </>
224
+ )}
225
+ </svg>
226
+ </button>
227
+ );
228
+ }
229
+
230
+ export {
231
+ Dialog,
232
+ DialogTrigger,
233
+ DialogContent,
234
+ dialogContentVariants,
235
+ DialogHeader,
236
+ DialogBody,
237
+ DialogFooter,
238
+ DialogTitle,
239
+ DialogDescription,
240
+ DialogClose,
241
+ DialogMaximize,
242
+ };
243
+ export type {
244
+ DialogProps,
245
+ DialogTriggerProps,
246
+ DialogContentProps,
247
+ DialogHeaderProps,
248
+ DialogBodyProps,
249
+ DialogFooterProps,
250
+ DialogTitleProps,
251
+ DialogDescriptionProps,
252
+ DialogCloseProps,
253
+ DialogMaximizeProps,
254
+ };
@@ -0,0 +1,40 @@
1
+ import type * as React from "react";
2
+
3
+ // The kit capability "dialog.dragByTitleBar" (kit/kit.tsx): a rendering that turns it on lets the header move
4
+ // the window. The offset lives on the window element (--dialog-drag-x/y), read only while the capability is on:
5
+ // a switch to a rendering without it centres the window again, and back finds it where it was left; a reopened
6
+ // dialog starts centred (a new element).
7
+
8
+ const clamp = (value: number, min: number, max: number) => Math.max(min, Math.min(value, max));
9
+
10
+ /** Drags the dialog by its header (its pointerdown, primary button, not on a control in it); the header
11
+ * stays inside the viewport. */
12
+ export function dragByTitleBar(event: React.PointerEvent<HTMLElement>) {
13
+ if (event.button !== 0 || (event.target as Element).closest("button, a, input, select, textarea"))
14
+ return;
15
+ const bar = event.currentTarget;
16
+ const frame = bar.closest<HTMLElement>("[data-slot=dialog-content]");
17
+ if (!frame) return;
18
+ event.preventDefault(); // no text selection while dragging
19
+ const offset = (axis: "x" | "y") =>
20
+ parseFloat(frame.style.getPropertyValue(`--dialog-drag-${axis}`)) || 0;
21
+ const from = { x: offset("x"), y: offset("y") };
22
+ const start = { x: event.clientX, y: event.clientY };
23
+ const box = frame.getBoundingClientRect();
24
+ const barHeight = bar.getBoundingClientRect().height;
25
+ const move = (e: PointerEvent) => {
26
+ const dx = clamp(e.clientX - start.x, -box.left, innerWidth - box.right);
27
+ const dy = clamp(e.clientY - start.y, -box.top, innerHeight - box.top - barHeight);
28
+ frame.style.setProperty("--dialog-drag-x", `${from.x + dx}px`);
29
+ frame.style.setProperty("--dialog-drag-y", `${from.y + dy}px`);
30
+ };
31
+ const end = () => {
32
+ bar.removeEventListener("pointermove", move);
33
+ bar.removeEventListener("pointerup", end);
34
+ bar.removeEventListener("pointercancel", end);
35
+ };
36
+ bar.setPointerCapture?.(event.pointerId);
37
+ bar.addEventListener("pointermove", move);
38
+ bar.addEventListener("pointerup", end);
39
+ bar.addEventListener("pointercancel", end);
40
+ }
@@ -0,0 +1,25 @@
1
+ export {
2
+ Dialog,
3
+ DialogTrigger,
4
+ DialogContent,
5
+ dialogContentVariants,
6
+ DialogHeader,
7
+ DialogBody,
8
+ DialogFooter,
9
+ DialogTitle,
10
+ DialogDescription,
11
+ DialogClose,
12
+ DialogMaximize,
13
+ } from "./dialog";
14
+ export type {
15
+ DialogProps,
16
+ DialogTriggerProps,
17
+ DialogContentProps,
18
+ DialogHeaderProps,
19
+ DialogBodyProps,
20
+ DialogFooterProps,
21
+ DialogTitleProps,
22
+ DialogDescriptionProps,
23
+ DialogCloseProps,
24
+ DialogMaximizeProps,
25
+ } from "./dialog";
@@ -0,0 +1,55 @@
1
+ name: DropZone
2
+ description: "Wraps content as a place to drop files; while files are dragged over it an overlay says what a drop does, and a ref opens the system file picker."
3
+ layer: core
4
+ category: input
5
+ when_to_use:
6
+ - "A pane, a form or a prompt where the user drops files to upload or attach them"
7
+ - 'When the same place also needs a "choose files" trigger without the caller writing an <input type=file>'
8
+ when_not_to_use:
9
+ - "A one-line field for a value — use Input"
10
+ - "One image that is replaced by a drop — use ImageField"
11
+ props:
12
+ - name: onFiles
13
+ type: "(files: File[]) => void"
14
+ required: true
15
+ description: "The files dropped or picked, filtered by `accept` and `multiple`"
16
+ - name: accept
17
+ type: string
18
+ required: false
19
+ description: "What it takes, as <input accept>: mime types, image/*, extensions (.pdf)"
20
+ - name: multiple
21
+ type: boolean
22
+ required: false
23
+ default: "true"
24
+ description: "Keep every file; false keeps the first"
25
+ - name: disabled
26
+ type: boolean
27
+ required: false
28
+ default: "false"
29
+ description: "Ignores drags and the picker"
30
+ - name: label
31
+ type: string
32
+ required: false
33
+ default: '"Drop to upload"'
34
+ description: "What the overlay says while files are dragged over it"
35
+ - name: ref
36
+ type: "Ref<DropZoneHandle>"
37
+ required: false
38
+ description: "Exposes open(), which shows the system file picker (a hidden <input type=file>)"
39
+ - name: className
40
+ type: string
41
+ required: false
42
+ description: "Additional CSS classes merged via cn() on the wrapping div"
43
+ props_priority:
44
+ - onFiles
45
+ - accept
46
+ - multiple
47
+ - disabled
48
+ - ref
49
+ examples:
50
+ - title: "Attach images, with a button that opens the picker"
51
+ code: "const zone = useRef<DropZoneHandle>(null);\n<DropZone ref={zone} accept=\"image/*\" onFiles={addImages} className=\"rounded-default border border-dashed border-border p-3\">\n <Button onClick={() => zone.current?.open()}>Choose images…</Button>\n <p className=\"text-xs text-muted\">Or drop them here.</p>\n</DropZone>"
52
+ anti_patterns:
53
+ - "Don't read the overlay's label as a control — the whole zone is the target; the overlay ignores the pointer"
54
+ - "Don't keep the files' names to filter them yourself — pass the same accept the <input> takes"
55
+ accessibility_notes: "The overlay appears only while files are dragged; it is not announced, so the zone's own text must say it takes files. The hidden input is out of the tab order and aria-hidden: give the visible trigger an accessible name (the ref's open()). Dragging text or a link shows nothing."
@@ -0,0 +1,146 @@
1
+ import * as React from "react";
2
+
3
+ import { cn } from "../../../lib/utils";
4
+
5
+ /** What a `DropZone`'s ref exposes: opening the system file picker without the caller writing an `<input>`. */
6
+ interface DropZoneHandle {
7
+ open: () => void;
8
+ }
9
+
10
+ interface DropZoneProps extends Omit<React.ComponentProps<"div">, "ref"> {
11
+ /** The files dropped or picked, filtered by `accept` and `multiple`. */
12
+ onFiles: (files: File[]) => void;
13
+ /** What it takes, as `<input accept>`: mime types, `image/*`, extensions (`.pdf`). */
14
+ accept?: string;
15
+ /** Keep every file dropped; false keeps the first (default true). */
16
+ multiple?: boolean;
17
+ /** Ignores drags and the picker. */
18
+ disabled?: boolean;
19
+ /** What the overlay says while files are dragged over it (default "Drop to upload"). */
20
+ label?: string;
21
+ ref?: React.Ref<DropZoneHandle>;
22
+ }
23
+
24
+ /** Whether `file` fits one of `accept`'s comma-separated entries (`image/*`, `image/png`, `.pdf`). */
25
+ function accepted(file: File, accept?: string): boolean {
26
+ if (!accept) return true;
27
+ const type = file.type.toLowerCase();
28
+ const name = file.name.toLowerCase();
29
+ return accept.split(",").some((entry) => {
30
+ const token = entry.trim().toLowerCase();
31
+ if (!token) return false;
32
+ if (token === "*/*") return true;
33
+ if (token.endsWith("/*")) return type.startsWith(token.slice(0, -1));
34
+ if (token.startsWith(".")) return name.endsWith(token);
35
+ return type === token;
36
+ });
37
+ }
38
+
39
+ /** Whether a drag carries files (not text, a link or a selection). */
40
+ function carriesFiles(event: React.DragEvent): boolean {
41
+ const data = event.dataTransfer;
42
+ return Boolean(data && (data.types.includes("Files") || data.files?.length));
43
+ }
44
+
45
+ /** Wraps content as a place to drop files: while files are dragged over it an overlay says what a drop does; the
46
+ * ref's `open()` shows the system file picker (a hidden `<input type=file>`). */
47
+ function DropZone({
48
+ onFiles,
49
+ accept,
50
+ multiple = true,
51
+ disabled = false,
52
+ label = "Drop to upload",
53
+ ref,
54
+ className,
55
+ children,
56
+ ...props
57
+ }: DropZoneProps) {
58
+ const input = React.useRef<HTMLInputElement>(null);
59
+ const depth = React.useRef(0);
60
+ const [over, setOver] = React.useState(false);
61
+
62
+ React.useImperativeHandle(
63
+ ref,
64
+ () => ({
65
+ open: () => {
66
+ if (!disabled) input.current?.click();
67
+ },
68
+ }),
69
+ [disabled],
70
+ );
71
+
72
+ React.useEffect(() => {
73
+ if (!disabled) return;
74
+ depth.current = 0;
75
+ setOver(false);
76
+ }, [disabled]);
77
+
78
+ /** The files to hand over: those `accept` takes, only the first without `multiple`. */
79
+ const picked = (files: File[]): File[] => {
80
+ const kept = files.filter((file) => accepted(file, accept));
81
+ return multiple ? kept : kept.slice(0, 1);
82
+ };
83
+
84
+ return (
85
+ <div
86
+ data-slot="drop-zone"
87
+ data-over={over ? "true" : undefined}
88
+ className={cn("relative", className)}
89
+ {...props}
90
+ onDragEnter={(event) => {
91
+ if (disabled || !carriesFiles(event)) return;
92
+ event.preventDefault();
93
+ depth.current += 1;
94
+ setOver(true);
95
+ }}
96
+ onDragOver={(event) => {
97
+ if (disabled || !carriesFiles(event)) return;
98
+ event.preventDefault();
99
+ if (event.dataTransfer) event.dataTransfer.dropEffect = "copy";
100
+ }}
101
+ onDragLeave={() => {
102
+ if (disabled || depth.current === 0) return;
103
+ depth.current = Math.max(0, depth.current - 1);
104
+ if (depth.current === 0) setOver(false);
105
+ }}
106
+ onDrop={(event) => {
107
+ if (disabled || !carriesFiles(event)) return;
108
+ event.preventDefault();
109
+ depth.current = 0;
110
+ setOver(false);
111
+ const files = picked(Array.from(event.dataTransfer?.files ?? []));
112
+ if (files.length) onFiles(files);
113
+ }}
114
+ >
115
+ {children}
116
+ {over && (
117
+ <div
118
+ data-slot="drop-zone-overlay"
119
+ className="pointer-events-none absolute inset-0 z-10 flex items-center justify-center rounded-lg border-2 border-dashed border-accent bg-surface/80 px-4 text-center text-sm font-medium text-accent"
120
+ >
121
+ {label}
122
+ </div>
123
+ )}
124
+ <input
125
+ ref={input}
126
+ data-slot="drop-zone-input"
127
+ type="file"
128
+ hidden
129
+ tabIndex={-1}
130
+ aria-hidden="true"
131
+ accept={accept}
132
+ multiple={multiple}
133
+ disabled={disabled}
134
+ onChange={(event) => {
135
+ const files = picked(Array.from(event.currentTarget.files ?? []));
136
+ if (files.length) onFiles(files);
137
+ // The same file chosen again fires a change too.
138
+ event.currentTarget.value = "";
139
+ }}
140
+ />
141
+ </div>
142
+ );
143
+ }
144
+
145
+ export { DropZone };
146
+ export type { DropZoneHandle, DropZoneProps };
@@ -0,0 +1,2 @@
1
+ export { DropZone } from "./drop-zone";
2
+ export type { DropZoneHandle, DropZoneProps } from "./drop-zone";
@@ -0,0 +1,118 @@
1
+ name: DropdownMenu
2
+ description: "Contextual action menu with keyboard shortcuts, separators, section labels, and destructive variants."
3
+ layer: core
4
+ category: overlay
5
+ when_to_use:
6
+ - "For contextual action menus triggered by buttons"
7
+ - "For overflow menus with multiple actions"
8
+ - "For menus with destructive actions, shortcuts, and grouping"
9
+ when_not_to_use:
10
+ - "For navigation menus — use Sidebar or Tabs"
11
+ - "For form select inputs — use a Select component"
12
+ - "For simple tooltips — use Tooltip component"
13
+ composition_partners:
14
+ - Button (as DropdownMenuTrigger child)
15
+ - Table (for row action menus)
16
+ - Dialog (triggered from menu items)
17
+ props:
18
+ - name: variant
19
+ type: "'default' | 'destructive'"
20
+ required: false
21
+ default: "'default'"
22
+ description: "Visual style for menu items — destructive renders in red (DropdownMenuItem only)"
23
+ - name: size
24
+ type: "'default' | 'large'"
25
+ required: false
26
+ default: "'default'"
27
+ description: "Item height (DropdownMenuItem and DropdownMenuSubTrigger) — large for a launcher's items (a Start menu's first column), taller with a bigger icon; renderings read data-size"
28
+ - name: sideOffset
29
+ type: "number | ((data) => number)"
30
+ required: false
31
+ default: "4"
32
+ description: "Distance from trigger in pixels (DropdownMenuContent only)"
33
+ - name: align
34
+ type: "'start' | 'center' | 'end'"
35
+ required: false
36
+ default: "'start'"
37
+ description: "Alignment relative to trigger (DropdownMenuContent only)"
38
+ - name: side
39
+ type: "'top' | 'right' | 'bottom' | 'left' | 'inline-start' | 'inline-end'"
40
+ required: false
41
+ default: "'bottom'"
42
+ description: "Preferred side to open the menu against the trigger (DropdownMenuContent only)"
43
+ - name: alignOffset
44
+ type: "number | ((data) => number)"
45
+ required: false
46
+ default: "0"
47
+ description: "Offset along the alignment axis in pixels (DropdownMenuContent only)"
48
+ - name: collisionPadding
49
+ type: "number | { top?, right?, bottom?, left? }"
50
+ required: false
51
+ default: "5"
52
+ description: "Minimum distance from viewport edges when auto-positioning (DropdownMenuContent only)"
53
+ - name: anchor
54
+ type: "Element | VirtualElement | RefObject<Element> | (() => Element | VirtualElement | null)"
55
+ required: false
56
+ description: "What to position against instead of the trigger (DropdownMenuContent only) — e.g. a point where a right-click happened, as { getBoundingClientRect: () => new DOMRect(x, y, 0, 0) }, for a menu opened without a trigger"
57
+ - name: onSelect
58
+ type: "(event: Event) => void"
59
+ required: false
60
+ description: "Activation callback on DropdownMenuItem. Base UI activates pointer and keyboard selections through the item's click path, so the native event is a click event (a PointerEvent in modern browsers) even for Enter/Space. Fires even if onClick calls preventDefault. Unlike Radix, event.preventDefault() no longer keeps the menu open — use closeOnClick={false} instead."
61
+ - name: closeOnClick
62
+ type: boolean
63
+ required: false
64
+ default: "true"
65
+ description: "Whether activating a DropdownMenuItem closes the menu (Base UI). Set false to keep the menu open — replaces the Radix pattern of calling event.preventDefault() inside onSelect."
66
+ - name: render
67
+ type: "ReactElement | (props, state) => ReactElement"
68
+ required: false
69
+ description: "Replace the rendered element on DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, or DropdownMenuGroup, e.g. render={<Button />} on the trigger."
70
+ props_priority:
71
+ - variant
72
+ - sideOffset
73
+ - align
74
+ - side
75
+ variants:
76
+ - default: "Standard menu item with text-secondary, hover shows bg-hover"
77
+ - destructive: "Red text for dangerous actions (delete, remove)"
78
+ examples:
79
+ - title: "Basic dropdown menu"
80
+ code: |
81
+ import { MoreHorizontal } from 'lucide-react';
82
+
83
+ <DropdownMenu>
84
+ <DropdownMenuTrigger render={<Button size="icon-sm" aria-label="Open actions" />}>
85
+ <MoreHorizontal size={14} />
86
+ </DropdownMenuTrigger>
87
+ <DropdownMenuContent>
88
+ <DropdownMenuItem>Edit</DropdownMenuItem>
89
+ <DropdownMenuItem>
90
+ Copy link
91
+ <DropdownMenuShortcut>⌘L</DropdownMenuShortcut>
92
+ </DropdownMenuItem>
93
+ <DropdownMenuSeparator />
94
+ <DropdownMenuItem variant="destructive">Delete</DropdownMenuItem>
95
+ </DropdownMenuContent>
96
+ </DropdownMenu>
97
+ - title: "Menu with labels and groups"
98
+ code: |
99
+ <DropdownMenu>
100
+ <DropdownMenuTrigger render={<Button />}>Open actions</DropdownMenuTrigger>
101
+ <DropdownMenuContent>
102
+ <DropdownMenuLabel>Actions</DropdownMenuLabel>
103
+ <DropdownMenuGroup>
104
+ <DropdownMenuItem>Edit</DropdownMenuItem>
105
+ <DropdownMenuItem>Duplicate</DropdownMenuItem>
106
+ </DropdownMenuGroup>
107
+ <DropdownMenuSeparator />
108
+ <DropdownMenuItem variant="destructive">Delete</DropdownMenuItem>
109
+ </DropdownMenuContent>
110
+ </DropdownMenu>
111
+ anti_patterns:
112
+ - "Don't call event.preventDefault() inside onSelect to keep the menu open — that was the Radix idiom and no longer works. Pass closeOnClick={false} on the DropdownMenuItem instead."
113
+ - "Don't put complex interactive elements inside DropdownMenuItem — it's designed for simple actions"
114
+ - "Don't use DropdownMenu for navigation links — it's for actions, not navigation"
115
+ - "Don't nest DropdownMenus — sub-menus are not supported in this implementation"
116
+ - "Don't forget to use render={<Button />} on the trigger when wrapping a Button"
117
+ accessibility_notes: "Built on Base UI Menu — renders role='menu' and role='menuitem'. Keyboard: Arrow keys navigate items, Enter/Space to activate, Escape to close. Per the ARIA menu pattern, focus is NOT trapped: Tab closes the menu and moves focus to the next tabbable element; Escape closes and returns focus to the trigger."
118
+ notes: "Sub-components: DropdownMenu (root), DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem (with variant), DropdownMenuSeparator, DropdownMenuLabel, DropdownMenuGroup, DropdownMenuShortcut (visual shortcut hint)."