@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,226 @@
1
+ import * as React from "react";
2
+ import { Select as SelectPrimitive } from "@base-ui/react/select";
3
+ import { CSPProvider } from "@base-ui/react/csp-provider";
4
+
5
+ import { cn } from "../../../lib/utils";
6
+ import { inputVariants } from "../input/input";
7
+ import { dropdownMenuItemVariants } from "../dropdown-menu/dropdown-menu";
8
+ import { ScrollArea } from "../scroll-area";
9
+
10
+ // Bridge: structure from an earlier Bridge `select.tsx` (Base UI Select), restyled to the kit:
11
+ // the trigger is an `Input variant="outline"`, the popup a `DropdownMenuContent`.
12
+
13
+ // --- Select (root) ---
14
+
15
+ const Select = SelectPrimitive.Root;
16
+
17
+ type SelectProps<
18
+ Value = unknown,
19
+ Multiple extends boolean | undefined = false,
20
+ > = SelectPrimitive.Root.Props<Value, Multiple>;
21
+
22
+ // --- SelectTrigger ---
23
+
24
+ interface SelectTriggerProps extends React.ComponentProps<typeof SelectPrimitive.Trigger> {
25
+ /** Height, as `Input variant="outline"` (h-sm, h-md, h-lg). Defaults to `default` (h-md), as Button and Input: a form that wants h-lg sets `lg` on each of its controls. */
26
+ size?: "sm" | "default" | "lg";
27
+ }
28
+
29
+ // Optical centring (Bridge): a text control, so 1px bottom padding; the chevron keeps the box's centre.
30
+ function SelectTrigger({ className, size = "default", children, ...props }: SelectTriggerProps) {
31
+ return (
32
+ <SelectPrimitive.Trigger
33
+ data-slot="select-trigger"
34
+ className={cn(
35
+ inputVariants({ variant: "outline", size }),
36
+ "pb-px items-center justify-between gap-1.5 text-left whitespace-nowrap cursor-pointer data-popup-open:border-accent data-placeholder:text-placeholder",
37
+ className,
38
+ )}
39
+ {...props}
40
+ >
41
+ {children}
42
+ <SelectPrimitive.Icon className="flex shrink-0 -mb-px text-muted">
43
+ <svg
44
+ aria-hidden="true"
45
+ className="size-4"
46
+ viewBox="0 0 24 24"
47
+ fill="none"
48
+ stroke="currentColor"
49
+ strokeWidth="2"
50
+ strokeLinecap="round"
51
+ strokeLinejoin="round"
52
+ >
53
+ <path d="m6 9 6 6 6-6" />
54
+ </svg>
55
+ </SelectPrimitive.Icon>
56
+ </SelectPrimitive.Trigger>
57
+ );
58
+ }
59
+
60
+ // --- SelectValue ---
61
+
62
+ interface SelectValueProps extends React.ComponentProps<typeof SelectPrimitive.Value> {}
63
+
64
+ function SelectValue({ className, ...props }: SelectValueProps) {
65
+ return (
66
+ <SelectPrimitive.Value
67
+ data-slot="select-value"
68
+ className={cn("flex-1 truncate", className)}
69
+ {...props}
70
+ />
71
+ );
72
+ }
73
+
74
+ // --- SelectContent ---
75
+
76
+ interface SelectContentProps extends React.ComponentProps<typeof SelectPrimitive.Popup> {
77
+ /** Distance from the trigger in px (lives on Base UI's Positioner) */
78
+ sideOffset?: SelectPrimitive.Positioner.Props["sideOffset"];
79
+ /** Alignment against the trigger (lives on Base UI's Positioner) */
80
+ align?: SelectPrimitive.Positioner.Props["align"];
81
+ /** Which side of the trigger to position against (lives on Base UI's Positioner) */
82
+ side?: SelectPrimitive.Positioner.Props["side"];
83
+ /** Offset along the alignment axis (lives on Base UI's Positioner) */
84
+ alignOffset?: SelectPrimitive.Positioner.Props["alignOffset"];
85
+ /** Overlay the selected item on the trigger (macOS style) instead of dropping below it, as DropdownMenu does. */
86
+ alignItemWithTrigger?: SelectPrimitive.Positioner.Props["alignItemWithTrigger"];
87
+ }
88
+
89
+ function SelectContent({
90
+ className,
91
+ children,
92
+ sideOffset = 4,
93
+ align = "start",
94
+ side,
95
+ alignOffset,
96
+ alignItemWithTrigger = false,
97
+ ...props
98
+ }: SelectContentProps) {
99
+ // Bridge: the page's CSP refuses inline <style>; Base UI's scrollbar-hiding style element is only
100
+ // needed with scroll arrows or without a List, neither of which this popup has.
101
+ return (
102
+ <CSPProvider disableStyleElements>
103
+ <SelectPrimitive.Portal>
104
+ <SelectPrimitive.Positioner
105
+ sideOffset={sideOffset}
106
+ align={align}
107
+ side={side}
108
+ alignOffset={alignOffset}
109
+ alignItemWithTrigger={alignItemWithTrigger}
110
+ className="z-50"
111
+ >
112
+ <SelectPrimitive.Popup
113
+ data-slot="select-content"
114
+ className={cn(
115
+ "z-50 flex min-w-(--anchor-width) max-h-(--available-height) flex-col bg-surface rounded-dropdown outline-none",
116
+ className,
117
+ )}
118
+ style={{ boxShadow: "var(--shadow-dropdown)" }}
119
+ {...props}
120
+ >
121
+ <ScrollArea className="flex min-h-0 flex-col" viewportClassName="min-h-0 flex-1">
122
+ <SelectPrimitive.List className="flex flex-col p-1">{children}</SelectPrimitive.List>
123
+ </ScrollArea>
124
+ </SelectPrimitive.Popup>
125
+ </SelectPrimitive.Positioner>
126
+ </SelectPrimitive.Portal>
127
+ </CSPProvider>
128
+ );
129
+ }
130
+
131
+ // --- SelectItem ---
132
+
133
+ interface SelectItemProps extends React.ComponentProps<typeof SelectPrimitive.Item> {}
134
+
135
+ function SelectItem({ className, children, ...props }: SelectItemProps) {
136
+ return (
137
+ <SelectPrimitive.Item
138
+ data-slot="select-item"
139
+ className={cn(
140
+ dropdownMenuItemVariants(),
141
+ "data-disabled:pointer-events-none data-disabled:opacity-50",
142
+ className,
143
+ )}
144
+ {...props}
145
+ >
146
+ <SelectPrimitive.ItemText className="flex-1 truncate">{children}</SelectPrimitive.ItemText>
147
+ <SelectPrimitive.ItemIndicator className="flex shrink-0 text-muted">
148
+ <svg
149
+ aria-hidden="true"
150
+ className="size-4"
151
+ viewBox="0 0 24 24"
152
+ fill="none"
153
+ stroke="currentColor"
154
+ strokeWidth="2"
155
+ strokeLinecap="round"
156
+ strokeLinejoin="round"
157
+ >
158
+ <path d="M20 6 9 17l-5-5" />
159
+ </svg>
160
+ </SelectPrimitive.ItemIndicator>
161
+ </SelectPrimitive.Item>
162
+ );
163
+ }
164
+
165
+ // --- SelectGroup ---
166
+
167
+ interface SelectGroupProps extends React.ComponentProps<typeof SelectPrimitive.Group> {}
168
+
169
+ function SelectGroup({ className, ...props }: SelectGroupProps) {
170
+ return (
171
+ <SelectPrimitive.Group
172
+ data-slot="select-group"
173
+ className={cn("flex flex-col", className)}
174
+ {...props}
175
+ />
176
+ );
177
+ }
178
+
179
+ // --- SelectLabel (a group's label, inside SelectGroup) ---
180
+
181
+ interface SelectLabelProps extends React.ComponentProps<typeof SelectPrimitive.GroupLabel> {}
182
+
183
+ function SelectLabel({ className, ...props }: SelectLabelProps) {
184
+ return (
185
+ <SelectPrimitive.GroupLabel
186
+ data-slot="select-label"
187
+ className={cn("text-xs font-medium text-muted px-2 pt-1.5 pb-0.5", className)}
188
+ {...props}
189
+ />
190
+ );
191
+ }
192
+
193
+ // --- SelectSeparator ---
194
+
195
+ interface SelectSeparatorProps extends React.ComponentProps<typeof SelectPrimitive.Separator> {}
196
+
197
+ function SelectSeparator({ className, ...props }: SelectSeparatorProps) {
198
+ return (
199
+ <SelectPrimitive.Separator
200
+ data-slot="select-separator"
201
+ className={cn("h-px bg-border my-1", className)}
202
+ {...props}
203
+ />
204
+ );
205
+ }
206
+
207
+ export {
208
+ Select,
209
+ SelectTrigger,
210
+ SelectValue,
211
+ SelectContent,
212
+ SelectItem,
213
+ SelectGroup,
214
+ SelectLabel,
215
+ SelectSeparator,
216
+ };
217
+ export type {
218
+ SelectProps,
219
+ SelectTriggerProps,
220
+ SelectValueProps,
221
+ SelectContentProps,
222
+ SelectItemProps,
223
+ SelectGroupProps,
224
+ SelectLabelProps,
225
+ SelectSeparatorProps,
226
+ };
@@ -0,0 +1,2 @@
1
+ export { Skeleton, ListSkeleton, DetailSkeleton } from "./skeleton";
2
+ export type { SkeletonProps } from "./skeleton";
@@ -0,0 +1,50 @@
1
+ name: Skeleton
2
+ description: "A pulsing placeholder block shown while content loads. Purely visual: its size comes from className, not from a width or height prop."
3
+ layer: core
4
+ category: feedback
5
+ when_to_use:
6
+ - "While data or an image loads, in the shape and size of what will replace it"
7
+ - "For a list or card's loading state (a block per line, a circle for an avatar)"
8
+ when_not_to_use:
9
+ - "For a short wait where a spinner reads better — use a spinner"
10
+ - "As the final empty state — show real copy when there is nothing to load"
11
+ - "For a progress that is known — show a progress value instead of an indefinite pulse"
12
+ composition_partners:
13
+ - Card (as a loading body)
14
+ - Avatar (a `round` circle placeholder, matching the avatar's size)
15
+ - List (one line per row)
16
+ props:
17
+ - name: round
18
+ type: boolean
19
+ required: false
20
+ default: "false"
21
+ description: "Draw a circle (rounded-full) instead of the default rounded-sm rectangle, e.g. for an avatar"
22
+ - name: className
23
+ type: string
24
+ required: false
25
+ description: "Sizing and layout (e.g. h-4 w-24, size-6); merged with the base classes"
26
+ - name: ...divProps
27
+ type: React.ComponentProps<"div">
28
+ required: false
29
+ description: "Any other div attribute, spread onto the block"
30
+ props_priority:
31
+ - round
32
+ - className
33
+ examples:
34
+ - title: "A line of text"
35
+ code: '<Skeleton className="h-4 w-24" />'
36
+ - title: "An avatar's place"
37
+ code: '<Skeleton round className="size-6" />'
38
+ - title: "A card's loading body"
39
+ code: |
40
+ <Card>
41
+ <div className="flex flex-col gap-2">
42
+ <Skeleton className="h-4 w-3/4" />
43
+ <Skeleton className="h-4 w-1/2" />
44
+ </div>
45
+ </Card>
46
+ anti_patterns:
47
+ - "Don't animate it yourself — the pulse and its reduced-motion fallback are built in"
48
+ - "Don't use it as a permanent empty state — it promises content that will not arrive"
49
+ - "Don't give it children or text — it is aria-hidden decoration"
50
+ accessibility_notes: "Renders an aria-hidden div, so assistive technology skips it; announce the loading state on the surrounding region (e.g. aria-busy) instead."
@@ -0,0 +1,71 @@
1
+ import * as React from "react";
2
+
3
+ import { cn } from "../../../lib/utils";
4
+
5
+ interface SkeletonProps extends React.ComponentProps<"div"> {
6
+ /** Draw a circle instead of the default rounded rectangle (e.g. an avatar's place). */
7
+ round?: boolean;
8
+ }
9
+
10
+ /** A pulsing placeholder block. Purely presentational; its size comes from `className`. */
11
+ function Skeleton({ className, round, ...props }: SkeletonProps) {
12
+ return (
13
+ <div
14
+ data-slot="skeleton"
15
+ aria-hidden="true"
16
+ className={cn(
17
+ "bg-active rounded-sm animate-pulse motion-reduce:animate-none",
18
+ round && "rounded-full",
19
+ className,
20
+ )}
21
+ {...props}
22
+ />
23
+ );
24
+ }
25
+
26
+ // research-033's mockup: a list's and a record page's shapes while they load; a screen reader hears "Loading…".
27
+
28
+ /** A list loading: eight rows (an avatar, a name, a line). */
29
+ function ListSkeleton() {
30
+ return (
31
+ <div role="status" data-slot="list-skeleton" className="flex flex-col gap-1.5 px-3 py-2">
32
+ <span className="sr-only">Loading…</span>
33
+ {Array.from({ length: 8 }, (_, at) => (
34
+ <div key={at} className="flex min-h-9 items-center gap-3">
35
+ <Skeleton round style={{ width: 28, height: 28, flex: "none" }} />
36
+ <Skeleton style={{ width: 90 + ((at * 23) % 60), height: 10 }} />
37
+ <Skeleton style={{ width: 60 + ((at * 37) % 80), height: 8 }} />
38
+ </div>
39
+ ))}
40
+ </div>
41
+ );
42
+ }
43
+
44
+ /** A record page loading: its header (an avatar, a title, a line), then five rows (a label, a value). */
45
+ function DetailSkeleton() {
46
+ return (
47
+ <div
48
+ role="status"
49
+ data-slot="detail-skeleton"
50
+ className="flex h-full flex-col gap-1 px-10 py-6"
51
+ >
52
+ <span className="sr-only">Loading…</span>
53
+ <div className="mb-[18px] flex items-center gap-[18px]">
54
+ <Skeleton round style={{ width: 64, height: 64, flex: "none" }} />
55
+ <div className="flex flex-col gap-2.5">
56
+ <Skeleton style={{ width: 180, height: 18 }} />
57
+ <Skeleton style={{ width: 120, height: 10 }} />
58
+ </div>
59
+ </div>
60
+ {[110, 60, 139, 168, 90].map((width, at) => (
61
+ <div key={at} className="flex min-h-9 items-center gap-[60px]">
62
+ <Skeleton style={{ width: 64, height: 9 }} />
63
+ <Skeleton style={{ width, height: 10 }} />
64
+ </div>
65
+ ))}
66
+ </div>
67
+ );
68
+ }
69
+
70
+ export { Skeleton, ListSkeleton, DetailSkeleton };
71
+ export type { SkeletonProps };
@@ -0,0 +1,2 @@
1
+ export { Slider } from "./slider";
2
+ export type { SliderProps } from "./slider";
@@ -0,0 +1,55 @@
1
+ name: Slider
2
+ description: "One numeric value on a range, built on Base UI Slider: a 6px track filled in the accent up to a 16px thumb, as wide as its container (160px at least)."
3
+ layer: core
4
+ category: input
5
+ when_to_use:
6
+ - "For a bounded number whose exact value matters less than its feel (an opacity, a blur, a size)"
7
+ - "For settings that apply live while dragged"
8
+ when_not_to_use:
9
+ - "For an exact number typed in — use Input type=number"
10
+ - "For a few named choices — use SegmentGroup"
11
+ composition_partners:
12
+ - Properties (as value in PropertyRow, beside the value read out)
13
+ props:
14
+ - name: value
15
+ type: number
16
+ required: false
17
+ description: "Controlled value"
18
+ - name: onValueChange
19
+ type: "(value: number, eventDetails) => void"
20
+ required: false
21
+ description: "Each move, while dragged or keyed"
22
+ - name: onValueCommitted
23
+ type: "(value: number, eventDetails) => void"
24
+ required: false
25
+ description: "Once the pointer is released or a key pressed"
26
+ - name: min
27
+ type: number
28
+ required: false
29
+ description: "Lowest value (0)"
30
+ - name: max
31
+ type: number
32
+ required: false
33
+ description: "Highest value (100)"
34
+ - name: step
35
+ type: number
36
+ required: false
37
+ description: "Increment (1)"
38
+ - name: disabled
39
+ type: boolean
40
+ required: false
41
+ description: "Whether the slider is disabled"
42
+ props_priority:
43
+ - value
44
+ - onValueChange
45
+ - min
46
+ - max
47
+ - step
48
+ examples:
49
+ - title: "Controlled slider"
50
+ code: '<Slider value={opacity} onValueChange={setOpacity} min={30} max={100} aria-label="Opacity" />'
51
+ anti_patterns:
52
+ - "Don't use without showing the value next to it when the number means something"
53
+ - "Don't leave it in a shrink-to-fit container: give the container a width (a settings row: 280px)"
54
+ - "Don't pass an array value — this Slider holds one value"
55
+ accessibility_notes: "Built on Base UI Slider — a native range input inside the thumb, role='slider' with aria-valuenow/min/max. Keyboard: arrows step, Page Up/Down step by ten, Home/End to the ends. Label it with aria-label or aria-labelledby."
@@ -0,0 +1,46 @@
1
+ import * as React from "react";
2
+ import { Slider as SliderPrimitive } from "@base-ui/react/slider";
3
+
4
+ import { cn } from "../../../lib/utils";
5
+
6
+ interface SliderProps extends Omit<
7
+ React.ComponentProps<typeof SliderPrimitive.Root<number>>,
8
+ "render"
9
+ > {}
10
+
11
+ /** One value on a range: a 6px track filled in the accent up to a 16px thumb, as wide as its
12
+ * container (min 160px); its label goes to the thumb's input. */
13
+ function Slider({
14
+ className,
15
+ "aria-label": label,
16
+ "aria-labelledby": labelledBy,
17
+ ...props
18
+ }: SliderProps) {
19
+ return (
20
+ <SliderPrimitive.Root
21
+ data-slot="slider"
22
+ className={cn(
23
+ "relative flex w-full min-w-40 touch-none items-center select-none data-disabled:opacity-50",
24
+ className,
25
+ )}
26
+ {...props}
27
+ >
28
+ <SliderPrimitive.Control className="flex h-6 w-full grow cursor-pointer items-center data-disabled:cursor-not-allowed">
29
+ <SliderPrimitive.Track
30
+ data-slot="slider-track"
31
+ className="relative h-1.5 w-full rounded-full bg-border"
32
+ >
33
+ <SliderPrimitive.Indicator className="rounded-full bg-accent" />
34
+ <SliderPrimitive.Thumb
35
+ aria-label={label}
36
+ aria-labelledby={labelledBy}
37
+ className="size-4 rounded-full border border-border bg-white shadow-sm transition-[box-shadow] outline-none has-[:focus-visible]:ring-2 has-[:focus-visible]:ring-accent has-[:focus-visible]:ring-offset-2 has-[:focus-visible]:ring-offset-background"
38
+ />
39
+ </SliderPrimitive.Track>
40
+ </SliderPrimitive.Control>
41
+ </SliderPrimitive.Root>
42
+ );
43
+ }
44
+
45
+ export { Slider };
46
+ export type { SliderProps };
@@ -0,0 +1,16 @@
1
+ export {
2
+ SortableBoard,
3
+ SortableList,
4
+ SortableItem,
5
+ DragHandle,
6
+ useSortableDragState,
7
+ arrayMove,
8
+ } from "./sortable";
9
+ export type {
10
+ SortableBoardProps,
11
+ SortableListProps,
12
+ SortableItemProps,
13
+ DragHandleProps,
14
+ SortableDragState,
15
+ MoveEvent,
16
+ } from "./sortable";
@@ -0,0 +1,125 @@
1
+ name: Sortable
2
+ description: "Drag-and-drop sortable primitives for reorderable lists and cross-container Kanban boards. Built on @dnd-kit."
3
+ layer: core
4
+ category: interaction
5
+ when_to_use:
6
+ - "For Kanban boards with cross-column card dragging"
7
+ - "For reorderable lists (priority ordering, playlist management)"
8
+ - "For any UI where users rearrange items by dragging"
9
+ when_not_to_use:
10
+ - "For static lists that don't need reordering — use List component"
11
+ - "For simple selection — use List with selectionMode"
12
+ - "For file upload drag-and-drop — this is for sortable reordering only"
13
+ composition_partners:
14
+ - Card (primary draggable surface in Kanban and list views)
15
+ - ScrollArea (scrollable containers that hold SortableLists)
16
+ - StatusIcon (status display inside draggable cards)
17
+ - Avatar (assignee on draggable cards)
18
+ - Label (category tags on draggable cards)
19
+ - Badge (column counts)
20
+ - DropdownMenu (card actions — must not trigger drag)
21
+ - List (alternative to Card for simpler reorderable lists)
22
+ props:
23
+ - name: "SortableBoard.onMove"
24
+ type: "(event: MoveEvent) => void"
25
+ required: false
26
+ description: "Called when item moves between containers. MoveEvent: { itemId, fromContainerId, toContainerId, fromIndex, toIndex }"
27
+ - name: "SortableBoard.renderOverlay"
28
+ type: "(activeId: string) => React.ReactNode"
29
+ required: false
30
+ description: "Render function for drag overlay content. Receives the active item id."
31
+ - name: "SortableList.id"
32
+ type: string
33
+ required: true
34
+ description: "Unique container ID, required for cross-container sorting"
35
+ - name: "SortableList.items"
36
+ type: "string[]"
37
+ required: true
38
+ description: "Ordered array of item IDs"
39
+ - name: "SortableList.onReorder"
40
+ type: "(items: string[]) => void"
41
+ required: false
42
+ description: "Called when items are reordered within this list"
43
+ - name: "SortableList.itemLabel"
44
+ type: "(id: string) => string"
45
+ required: false
46
+ description: 'An item''s name in the screen reader announcements of a standalone list, with its position ("Picked up Draft notes, at position 2 of 3."); without it, dnd-kit announces the id'
47
+ - name: "SortableList.orientation"
48
+ type: "'vertical' | 'horizontal'"
49
+ required: false
50
+ default: "'vertical'"
51
+ description: "Sorting axis"
52
+ - name: "SortableItem.id"
53
+ type: string
54
+ required: true
55
+ description: "Unique item ID matching an entry in parent's items array"
56
+ - name: "SortableItem.disabled"
57
+ type: boolean
58
+ required: false
59
+ default: "false"
60
+ description: "Disable drag on this item"
61
+ - name: "SortableItem.dragFullItem"
62
+ type: "boolean | 'pointer'"
63
+ required: false
64
+ default: "false"
65
+ description: "When true, entire item is draggable (a button role and tab stop, Space/Enter pick it up). When false (default), only a DragHandle child activates drag via context. 'pointer': the entire item drags with the pointer only, with no role, tab stop or key handling, for an item that is itself a control (a List option); give the keyboard another way to reorder (Move up / Move down menu items)."
66
+ props_priority:
67
+ - "SortableList.items"
68
+ - "SortableList.onReorder"
69
+ - "SortableItem.id"
70
+ - "SortableBoard.onMove"
71
+ - "SortableBoard.renderOverlay"
72
+ examples:
73
+ - title: "Single list reorder"
74
+ code: |
75
+ <SortableList id="tasks" items={taskIds} onReorder={setTaskIds}>
76
+ {tasks.map(task => (
77
+ <SortableItem key={task.id} id={task.id}>
78
+ <Card variant="outline" interactive>
79
+ <div className="flex items-center gap-2">
80
+ <DragHandle />
81
+ <StatusIcon status={task.status} />
82
+ <span className="text-sm">{task.title}</span>
83
+ </div>
84
+ </Card>
85
+ </SortableItem>
86
+ ))}
87
+ </SortableList>
88
+ - title: "Kanban board with cross-column drag"
89
+ code: |
90
+ <SortableBoard onMove={handleMove} renderOverlay={(id) => <CardOverlay id={id} />}>
91
+ <div className="flex gap-4 h-full">
92
+ {columns.map(col => (
93
+ <div key={col.id} className="w-[280px] flex flex-col">
94
+ <div className="flex items-center gap-2 p-3">
95
+ <StatusIcon status={col.status} />
96
+ <span className="text-sm font-medium">{col.label}</span>
97
+ <Badge>{col.items.length}</Badge>
98
+ </div>
99
+ <ScrollArea className="flex-1">
100
+ <SortableList id={col.id} items={col.itemIds} onReorder={(ids) => reorderColumn(col.id, ids)}>
101
+ <div className="flex flex-col gap-2 p-2">
102
+ {col.items.map(item => (
103
+ <SortableItem key={item.id} id={item.id}>
104
+ <Card variant="outline" interactive>
105
+ <p className="text-sm">{item.title}</p>
106
+ </Card>
107
+ </SortableItem>
108
+ ))}
109
+ </div>
110
+ </SortableList>
111
+ </ScrollArea>
112
+ </div>
113
+ ))}
114
+ </div>
115
+ </SortableBoard>
116
+ anti_patterns:
117
+ - "Don't use dragFullItem={true} when items contain interactive elements (buttons, links, inputs) — use DragHandle instead so clicks and text selection work"
118
+ - 'Don''t use dragFullItem={true} around a List option: its button role sits between the listbox and the option, and Space on the option picks the row up instead of selecting it — use dragFullItem="pointer" and Move up / Move down menu items'
119
+ - "Don't use SortableBoard for single-list reorder — SortableList works standalone"
120
+ - "Don't forget renderOverlay on SortableBoard — without it, no visual feedback during cross-container drag"
121
+ - "Don't nest SortableBoard inside another SortableBoard — use one board with multiple lists"
122
+ accessibility_notes: "Keyboard: Space/Enter to pick up item, Arrow keys to move within list, Space/Enter to drop, Escape to cancel. Screen reader announcements via @dnd-kit's built-in accessibility API. DragHandle has aria-label for identification."
123
+ notes: "Sub-components: SortableBoard (cross-container DnD context with swing physics overlay), SortableList (single sortable group with useDroppable for empty container drops), SortableItem (draggable wrapper), DragHandle (visual grip receiving listeners via context). Hook: useSortableDragState() returns { activeId, overContainerId } — use inside SortableBoard children to highlight drop zones. SortableList auto-detects if inside SortableBoard — when standalone, creates its own DnD context. arrayMove utility is re-exported for convenience. Touch sensor uses 250ms delay to distinguish from scroll. Pointer sensor uses 5px distance threshold. See kanban-board pattern for a complete multi-column implementation."
124
+ related_patterns:
125
+ - kanban-board