@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,17 @@
1
+ export {
2
+ CommandScope,
3
+ useCommands,
4
+ useScopeCommands,
5
+ KeyHint,
6
+ CommandMenu,
7
+ CommandHostProvider,
8
+ formatKeys,
9
+ } from "./command";
10
+ export type {
11
+ Command,
12
+ CommandScopeProps,
13
+ CommandHost,
14
+ CommandSource,
15
+ CommandRegistry,
16
+ Placement,
17
+ } from "./command";
@@ -0,0 +1,19 @@
1
+ name: DraftBar
2
+ description: "Under a record not created yet: a dashed box with a Draft pill, where the draft is kept (or, in red, what stops Create), then Cancel and Create ⌘↵ (research-033's mockup)."
3
+ layer: composite
4
+ category: feedback
5
+ when_to_use:
6
+ - "The foot of a draft card (useDraftRecord), in place of DetailHint"
7
+ props:
8
+ - name: message
9
+ type: ReactNode
10
+ required: true
11
+ - name: error
12
+ type: ReactNode
13
+ required: false
14
+ - name: onCancel
15
+ type: "() => void"
16
+ required: true
17
+ - name: onCreate
18
+ type: "() => void"
19
+ required: true
@@ -0,0 +1,57 @@
1
+ import * as React from "react";
2
+
3
+ import { cn } from "../../../lib/utils";
4
+ import { Button } from "../../core/button/button";
5
+ import { Kbd } from "../../core/kbd";
6
+ import { Tip } from "../../core/tooltip";
7
+
8
+ // research-033's mockup `.draftbar`: under a record not created yet, a dashed box: a Draft pill, what is kept (or
9
+ // what stops Create, in red), then Cancel and Create ⌘↵.
10
+
11
+ interface DraftBarProps extends Omit<React.ComponentProps<"div">, "children"> {
12
+ /** Where the draft is kept ("Not created yet · kept on this device"). */
13
+ message: React.ReactNode;
14
+ /** What stops Create ("A first or last name is needed."): shown instead of the message, as an alert. */
15
+ error?: React.ReactNode;
16
+ onCancel: () => void;
17
+ onCreate: () => void;
18
+ }
19
+
20
+ function DraftBar({ message, error, onCancel, onCreate, className, ...props }: DraftBarProps) {
21
+ return (
22
+ <div
23
+ data-slot="draft-bar"
24
+ className={cn(
25
+ "mt-2 flex flex-wrap items-center gap-2 rounded-[var(--radius)] border-[0.5px] border-dashed border-input bg-hover px-2.5 py-2 text-[12.5px] leading-[normal] text-secondary",
26
+ className,
27
+ )}
28
+ {...props}
29
+ >
30
+ <span className="inline-flex h-[18px] items-center rounded-full border-[0.5px] border-dashed border-border bg-surface pr-[9px] pl-[7px] text-[11px] text-muted">
31
+ Draft
32
+ </span>
33
+ <span className="min-w-[140px] flex-1">
34
+ {error != null ? (
35
+ <span role="alert" className="font-medium text-destructive">
36
+ {error}
37
+ </span>
38
+ ) : (
39
+ message
40
+ )}
41
+ </span>
42
+ <span className="ml-auto flex gap-1.5">
43
+ <Tip label="Cancel · ⌘⌫">
44
+ <Button variant="ghost" size="sm" onClick={onCancel}>
45
+ Cancel
46
+ </Button>
47
+ </Tip>
48
+ <Button variant="primary" size="sm" onClick={onCreate}>
49
+ Create <Kbd tone="inverse">⌘↵</Kbd>
50
+ </Button>
51
+ </span>
52
+ </div>
53
+ );
54
+ }
55
+
56
+ export { DraftBar };
57
+ export type { DraftBarProps };
@@ -0,0 +1,2 @@
1
+ export { DraftBar } from "./draft-bar";
2
+ export type { DraftBarProps } from "./draft-bar";
@@ -0,0 +1,69 @@
1
+ name: ImageField
2
+ description: "One image a form or a record holds: its thumbnail contained in a fixed frame, its name and size, Upload (a file picker or a drop), Replace and Remove, a progress bar while it uploads, and a refusal shown in place."
3
+ layer: composite
4
+ category: input
5
+ when_to_use:
6
+ - "A record's image field (an article's illustration, a contact's photo): RecordImageField in @bridge/records wires it to the record's routes"
7
+ - "A form that takes one image and keeps a reference to it"
8
+ when_not_to_use:
9
+ - "A grid of images or files — use Thumbnail"
10
+ - "Several files dropped on a pane or a prompt — use DropZone"
11
+ props:
12
+ - name: label
13
+ type: string
14
+ required: true
15
+ description: "What the image is (Illustration): the group's accessible name, and the image's alt when the value has no name"
16
+ - name: value
17
+ type: "V | null | undefined (V has name?, size?)"
18
+ required: true
19
+ description: "The image held; null or absent: none"
20
+ - name: upload
21
+ type: "(file: File, progress: (fraction: number | undefined) => void) => Promise<V>"
22
+ required: true
23
+ description: "Sends the file and answers the value to hold; a rejection is shown in place with its message and its hint"
24
+ - name: viewUrl
25
+ type: "(value: V) => Promise<string>"
26
+ required: true
27
+ description: "The URL the image is shown from (a signed URL, asked again for each new value)"
28
+ - name: onChange
29
+ type: "(value: V | null) => void"
30
+ required: true
31
+ description: "The new value once uploaded, or null on Remove"
32
+ - name: accept
33
+ type: string
34
+ required: false
35
+ default: '"image/*"'
36
+ description: "What it takes, as <input accept>"
37
+ - name: ratio
38
+ type: number
39
+ required: false
40
+ default: "16 / 9"
41
+ description: "The frame's width over its height; the image is contained in it, never cropped"
42
+ - name: disabled
43
+ type: boolean
44
+ required: false
45
+ default: "false"
46
+ description: "Shows the image only: no buttons, no drop"
47
+ - name: error
48
+ type: string
49
+ required: false
50
+ description: "A problem from outside (the save of the value failed), shown in place"
51
+ - name: className
52
+ type: string
53
+ required: false
54
+ description: "Additional CSS classes merged via cn()"
55
+ props_priority:
56
+ - label
57
+ - value
58
+ - upload
59
+ - viewUrl
60
+ - onChange
61
+ examples:
62
+ - title: "A record's illustration, through its own routes"
63
+ code: '<ImageField label="Illustration" value={image} upload={(file, progress) => send(file, progress)} viewUrl={(ref) => urlOf(ref)} onChange={(next) => save(''image'', next)} />'
64
+ - title: "Read-only, square"
65
+ code: '<ImageField label="Photo" value={photo} ratio={1} disabled upload={send} viewUrl={urlOf} onChange={() => {}} />'
66
+ anti_patterns:
67
+ - "Don't fetch inside upload's caller to show progress yourself — report it through progress, the field draws the bar"
68
+ - "Don't delete the old file on Replace or Remove from the field — the record's revisions may still point at it"
69
+ accessibility_notes: 'A group named by `label`. Upload, Replace and Remove are buttons (Enter or Space), right-aligned; Upload and Replace open the system file picker, a drop on the frame does the same. While a file uploads the group is aria-busy and a progress bar is named "Uploading <name>". A refusal is a role=alert under the buttons, with its fix.'
@@ -0,0 +1,267 @@
1
+ import * as React from "react";
2
+
3
+ import { cn } from "../../../lib/utils";
4
+ import { Button } from "../../core/button";
5
+ import { DropZone, type DropZoneHandle } from "../../core/drop-zone";
6
+ import { Icon } from "../../core/icon";
7
+ import { Progress } from "../../core/progress";
8
+ import { Skeleton } from "../../core/skeleton";
9
+
10
+ /** What an `ImageField` reads of its value: the file's name and size, shown under the image. */
11
+ interface ImageFieldValue {
12
+ name?: string;
13
+ size?: number;
14
+ }
15
+
16
+ interface ImageFieldProps<V extends ImageFieldValue> extends Omit<
17
+ React.ComponentProps<"div">,
18
+ "onChange" | "defaultValue"
19
+ > {
20
+ /** What the image is ("Illustration"): the group's accessible name, and the image's alt without a file name. */
21
+ label: string;
22
+ /** The image held; `null` or absent: none. */
23
+ value: V | null | undefined;
24
+ /** Sends `file` and answers the value to hold (`progress`: 0 to 1, `undefined` while unknown). A rejection is shown
25
+ * in place: its message, and its `hint` when it has one. */
26
+ upload: (file: File, progress: (fraction: number | undefined) => void) => Promise<V>;
27
+ /** The URL the image is shown from. */
28
+ viewUrl: (value: V) => Promise<string>;
29
+ /** A new value once uploaded, or `null` (Remove). */
30
+ onChange: (value: V | null) => void;
31
+ /** What it takes, as `<input accept>` (default `image/*`). */
32
+ accept?: string;
33
+ /** The frame's width over its height (default 16 / 9); the image is contained in it, never cropped. */
34
+ ratio?: number;
35
+ /** Shows the image only: no Upload, Replace, Remove, no drop. */
36
+ disabled?: boolean;
37
+ /** A problem from outside (the record's save of the value failed), shown in place. */
38
+ error?: string;
39
+ }
40
+
41
+ /** A size as a person reads it: `512 B`, `1.5 KB`, `12 MB`. */
42
+ function humanSize(bytes: number): string {
43
+ if (!Number.isFinite(bytes) || bytes < 0) return "";
44
+ if (bytes < 1024) return `${Math.round(bytes)} B`;
45
+ const units = ["KB", "MB", "GB", "TB"];
46
+ let value = bytes / 1024;
47
+ let unit = 0;
48
+ while (value >= 1024 && unit < units.length - 1) {
49
+ value /= 1024;
50
+ unit += 1;
51
+ }
52
+ return `${value >= 10 ? Math.round(value) : Math.round(value * 10) / 10} ${units[unit]}`;
53
+ }
54
+
55
+ /** A sentence from a server's message (`the store refused` → `The store refused`). */
56
+ const sentence = (text: string) => text.charAt(0).toUpperCase() + text.slice(1);
57
+
58
+ /** A rejection's message and `hint`, as the field shows them. */
59
+ function problemOf(error: unknown): { message: string; hint?: string } {
60
+ const message = error instanceof Error ? error.message : String(error);
61
+ const hint =
62
+ typeof error === "object" && error !== null && "hint" in error && typeof error.hint === "string"
63
+ ? error.hint
64
+ : undefined;
65
+ return { message: sentence(message || "The upload failed"), ...(hint && { hint }) };
66
+ }
67
+
68
+ type Phase =
69
+ | { kind: "idle" }
70
+ | { kind: "uploading"; name: string; fraction: number | undefined }
71
+ | { kind: "error"; message: string; hint?: string };
72
+
73
+ /** An image held by a form or a record: its thumbnail in a fixed frame (contained), its name and size, Upload (a file
74
+ * picker or a drop), Replace and Remove, the progress while it uploads, and a refusal in place. It sends nothing
75
+ * itself: `upload` and `viewUrl` do. */
76
+ function ImageField<V extends ImageFieldValue>({
77
+ label,
78
+ value,
79
+ upload,
80
+ viewUrl,
81
+ onChange,
82
+ accept = "image/*",
83
+ ratio = 16 / 9,
84
+ disabled = false,
85
+ error,
86
+ className,
87
+ ...props
88
+ }: ImageFieldProps<V>) {
89
+ const zone = React.useRef<DropZoneHandle>(null);
90
+ const [phase, setPhase] = React.useState<Phase>({ kind: "idle" });
91
+ const uploading = phase.kind === "uploading";
92
+ const held = value ?? undefined;
93
+
94
+ // The view URL is kept with the value it is about: a new value is loading at once.
95
+ const key = held === undefined ? undefined : JSON.stringify(held);
96
+ const [view, setView] = React.useState<{ key: string; url?: string; failed?: boolean }>();
97
+ const [loaded, setLoaded] = React.useState<string>();
98
+ const latest = React.useRef(viewUrl);
99
+ latest.current = viewUrl;
100
+ React.useEffect(() => {
101
+ if (held === undefined || key === undefined) return;
102
+ let current = true;
103
+ latest.current(held).then(
104
+ (url) => {
105
+ if (current) setView({ key, url });
106
+ },
107
+ () => {
108
+ if (current) setView({ key, failed: true });
109
+ },
110
+ );
111
+ return () => {
112
+ current = false;
113
+ };
114
+ // `held` is read through its key: the same value again (a new object) is not fetched again.
115
+ }, [key]);
116
+ const shown = view !== undefined && view.key === key ? view : undefined;
117
+ const url = shown?.url;
118
+ const broken = shown?.failed === true;
119
+
120
+ const take = async (files: File[]) => {
121
+ const file = files[0];
122
+ if (file === undefined || disabled || uploading) return;
123
+ setPhase({ kind: "uploading", name: file.name, fraction: 0 });
124
+ try {
125
+ const next = await upload(file, (fraction) =>
126
+ setPhase((was) => (was.kind === "uploading" ? { ...was, fraction } : was)),
127
+ );
128
+ setPhase({ kind: "idle" });
129
+ onChange(next);
130
+ } catch (cause) {
131
+ setPhase({ kind: "error", ...problemOf(cause) });
132
+ }
133
+ };
134
+
135
+ const remove = () => {
136
+ setPhase({ kind: "idle" });
137
+ onChange(null);
138
+ };
139
+
140
+ const details =
141
+ held === undefined
142
+ ? undefined
143
+ : [held.name, held.size === undefined ? undefined : humanSize(held.size)]
144
+ .filter((part) => part !== undefined && part !== "")
145
+ .join(" · ");
146
+ const problem: { message: string; hint?: string } | undefined =
147
+ phase.kind === "error"
148
+ ? phase
149
+ : error !== undefined && error !== ""
150
+ ? { message: sentence(error) }
151
+ : undefined;
152
+
153
+ return (
154
+ <div
155
+ data-slot="image-field"
156
+ role="group"
157
+ aria-label={label}
158
+ aria-busy={uploading || undefined}
159
+ data-disabled={disabled ? "true" : undefined}
160
+ className={cn("flex min-w-0 flex-col gap-1.5", className)}
161
+ {...props}
162
+ >
163
+ <DropZone
164
+ ref={zone}
165
+ accept={accept}
166
+ multiple={false}
167
+ disabled={disabled || uploading}
168
+ label={held === undefined ? "Drop to upload" : "Drop to replace"}
169
+ onFiles={(files) => void take(files)}
170
+ >
171
+ <div
172
+ data-slot="image-field-frame"
173
+ className="relative flex w-full items-center justify-center overflow-hidden rounded-lg border border-solid border-border bg-hover"
174
+ style={{ aspectRatio: String(ratio) }}
175
+ >
176
+ {held === undefined ? (
177
+ <span
178
+ data-slot="image-field-empty"
179
+ className="flex flex-col items-center gap-1 text-xs text-muted"
180
+ >
181
+ <Icon name="image" size={20} />
182
+ {disabled ? "No image" : "No image yet: upload or drop one"}
183
+ </span>
184
+ ) : broken ? (
185
+ <span
186
+ data-slot="image-field-fallback"
187
+ className="flex flex-col items-center gap-1 text-xs text-muted"
188
+ >
189
+ <Icon name="image" size={20} />
190
+ The image could not be shown
191
+ </span>
192
+ ) : (
193
+ <>
194
+ {(url === undefined || loaded !== url) && (
195
+ <Skeleton className="absolute inset-0 size-full rounded-none" />
196
+ )}
197
+ {url !== undefined && (
198
+ <img
199
+ data-slot="image-field-image"
200
+ className="block size-full object-contain"
201
+ src={url}
202
+ alt={held.name ?? label}
203
+ onLoad={() => setLoaded(url)}
204
+ onError={() => setView({ key: key!, failed: true })}
205
+ />
206
+ )}
207
+ </>
208
+ )}
209
+ </div>
210
+ </DropZone>
211
+ {uploading && (
212
+ <Progress
213
+ size="sm"
214
+ {...(phase.fraction !== undefined && { value: phase.fraction })}
215
+ label={`Uploading ${phase.name}`}
216
+ />
217
+ )}
218
+ <div className="flex min-w-0 items-center gap-2">
219
+ <span
220
+ data-slot="image-field-details"
221
+ className="min-w-0 flex-1 truncate text-xs text-secondary"
222
+ title={details}
223
+ >
224
+ {uploading ? `Uploading ${phase.name}…` : details}
225
+ </span>
226
+ {!disabled && (
227
+ <span className="ml-auto flex shrink-0 items-center gap-1">
228
+ {held === undefined ? (
229
+ <Button
230
+ variant="outline"
231
+ size="sm"
232
+ disabled={uploading}
233
+ onClick={() => zone.current?.open()}
234
+ >
235
+ Upload
236
+ </Button>
237
+ ) : (
238
+ <>
239
+ <Button variant="ghost" size="sm" disabled={uploading} onClick={remove}>
240
+ <Icon name="trash" size={14} />
241
+ Remove
242
+ </Button>
243
+ <Button
244
+ variant="outline"
245
+ size="sm"
246
+ disabled={uploading}
247
+ onClick={() => zone.current?.open()}
248
+ >
249
+ Replace
250
+ </Button>
251
+ </>
252
+ )}
253
+ </span>
254
+ )}
255
+ </div>
256
+ {problem !== undefined && (
257
+ <div data-slot="image-field-error" role="alert" className="text-xs">
258
+ <span className="block text-destructive">{problem.message}</span>
259
+ {problem.hint !== undefined && <span className="block text-muted">{problem.hint}</span>}
260
+ </div>
261
+ )}
262
+ </div>
263
+ );
264
+ }
265
+
266
+ export { ImageField };
267
+ export type { ImageFieldProps, ImageFieldValue };
@@ -0,0 +1,2 @@
1
+ export { ImageField } from "./image-field";
2
+ export type { ImageFieldProps, ImageFieldValue } from "./image-field";
@@ -0,0 +1,18 @@
1
+ export {
2
+ List,
3
+ listVariants,
4
+ ListItem,
5
+ listItemVariants,
6
+ ListGroup,
7
+ BulkBar,
8
+ BulkAction,
9
+ BulkSeparator,
10
+ } from "./list";
11
+ export type {
12
+ ListProps,
13
+ ListItemProps,
14
+ ListGroupProps,
15
+ BulkBarProps,
16
+ BulkActionProps,
17
+ } from "./list";
18
+ export type { SwipeAction } from "./list-swipe";
@@ -0,0 +1,163 @@
1
+ import * as React from "react";
2
+
3
+ import { cn } from "../../../lib/utils";
4
+ import { Icon } from "../../core/icon";
5
+
6
+ // A row's swipe actions, as mail apps have them (Apple Mail, Proton Mail): on touch, a row slides sideways to show the
7
+ // actions of the side it uncovers; let go past half of them, they stay open (a tap elsewhere closes them); a full
8
+ // swipe runs the side's first action at once. A mouse swipes only in Bridge's phone shell ([data-mobile], its preview
9
+ // on a desktop); elsewhere its rows keep their click and their selection.
10
+
11
+ interface SwipeAction {
12
+ /** Its name, under its icon. */
13
+ label: string;
14
+ /** A lucide icon by its kebab-case name (the kit's Icon). */
15
+ icon: string;
16
+ /** Its colour: accent (default), destructive, warning or neutral. */
17
+ tone?: "accent" | "destructive" | "warning" | "neutral";
18
+ onAction: () => void;
19
+ }
20
+
21
+ const ACTION_WIDTH = 72;
22
+ /** A move shorter than this is a tap, not a swipe. */
23
+ const SLOP = 8;
24
+
25
+ const tones: Record<NonNullable<SwipeAction["tone"]>, string> = {
26
+ accent: "bg-accent text-accent-foreground",
27
+ destructive: "bg-destructive text-destructive-foreground",
28
+ warning: "bg-warning text-warning-foreground",
29
+ neutral: "bg-active text-foreground",
30
+ };
31
+
32
+ /** The swipe of one row: its offset, the handlers for the row, and the actions to draw behind it. */
33
+ function useSwipe(start: SwipeAction[] | undefined, end: SwipeAction[] | undefined) {
34
+ const enabled = (start?.length ?? 0) + (end?.length ?? 0) > 0;
35
+ const [offset, setOffset] = React.useState(0);
36
+ const [dragging, setDragging] = React.useState(false);
37
+ const drag = React.useRef<{ x: number; y: number; from: number; axis?: "x" | "y" } | null>(null);
38
+ /** A swipe just ended: the click that follows it does not open the row. */
39
+ const swiped = React.useRef(false);
40
+ const row = React.useRef<HTMLElement | null>(null);
41
+ const startWidth = (start?.length ?? 0) * ACTION_WIDTH;
42
+ const endWidth = (end?.length ?? 0) * ACTION_WIDTH;
43
+
44
+ // Open, a tap anywhere else closes it.
45
+ React.useEffect(() => {
46
+ if (offset === 0 || dragging) return;
47
+ const close = (event: PointerEvent) => {
48
+ if (!row.current?.parentElement?.contains(event.target as Node)) setOffset(0);
49
+ };
50
+ document.addEventListener("pointerdown", close);
51
+ return () => document.removeEventListener("pointerdown", close);
52
+ }, [offset, dragging]);
53
+
54
+ /** A side with no actions does not move. */
55
+ const clamp = (value: number) =>
56
+ value > 0 ? (start?.length ? value : 0) : end?.length ? value : 0;
57
+
58
+ const handlers = {
59
+ onPointerDown(event: React.PointerEvent<HTMLElement>) {
60
+ // A mouse swipes only in Bridge's phone shell ([data-mobile]: its preview on a desktop, a mouse for a finger).
61
+ if (
62
+ event.pointerType === "mouse" &&
63
+ (event.button !== 0 || !event.currentTarget.closest("[data-mobile]"))
64
+ )
65
+ return;
66
+ // A touch that moved may end with no click: the last swipe's click is not waited for.
67
+ swiped.current = false;
68
+ row.current = event.currentTarget;
69
+ drag.current = { x: event.clientX, y: event.clientY, from: offset };
70
+ },
71
+ onPointerMove(event: React.PointerEvent<HTMLElement>) {
72
+ const at = drag.current;
73
+ if (!at) return;
74
+ const dx = event.clientX - at.x;
75
+ const dy = event.clientY - at.y;
76
+ if (!at.axis) {
77
+ if (Math.abs(dx) < SLOP && Math.abs(dy) < SLOP) return;
78
+ at.axis = Math.abs(dx) > Math.abs(dy) ? "x" : "y";
79
+ if (at.axis === "x") {
80
+ event.currentTarget.setPointerCapture?.(event.pointerId);
81
+ setDragging(true);
82
+ }
83
+ }
84
+ if (at.axis === "x") setOffset(clamp(at.from + dx));
85
+ },
86
+ onPointerUp(event: React.PointerEvent<HTMLElement>) {
87
+ const at = drag.current;
88
+ drag.current = null;
89
+ if (at?.axis !== "x") return;
90
+ swiped.current = true;
91
+ setDragging(false);
92
+ const width = event.currentTarget.getBoundingClientRect().width;
93
+ const now = clamp(at.from + (event.clientX - at.x));
94
+ const side = now > 0 ? start : end;
95
+ const shown = now > 0 ? startWidth : endWidth;
96
+ // Full: past 60% of the row (or, a narrow one, well past its actions) runs the side's first action.
97
+ if (side?.length && Math.abs(now) > Math.max(width * 0.6, shown + 64)) {
98
+ setOffset(0);
99
+ side[0]!.onAction();
100
+ } else setOffset(Math.abs(now) > shown / 2 ? Math.sign(now) * shown : 0);
101
+ },
102
+ onPointerCancel() {
103
+ drag.current = null;
104
+ setDragging(false);
105
+ setOffset(0);
106
+ },
107
+ };
108
+
109
+ /** A click right after a swipe is the swipe's end, not a tap: it is dropped (true). */
110
+ const swallowClick = () => {
111
+ if (!swiped.current) return false;
112
+ swiped.current = false;
113
+ return true;
114
+ };
115
+
116
+ const actions = (side: "start" | "end") => {
117
+ const list = side === "start" ? start : end;
118
+ if (!list?.length || (side === "start" ? offset <= 0 : offset >= 0)) return null;
119
+ return (
120
+ <div
121
+ data-slot={`list-item-swipe-${side}`}
122
+ className={cn(
123
+ "absolute inset-y-0 flex",
124
+ side === "start" ? "left-0" : "right-0 flex-row-reverse",
125
+ )}
126
+ >
127
+ {list.map((action) => (
128
+ <button
129
+ key={action.label}
130
+ type="button"
131
+ tabIndex={-1}
132
+ onClick={() => {
133
+ setOffset(0);
134
+ action.onAction();
135
+ }}
136
+ style={{ width: ACTION_WIDTH }}
137
+ className={cn(
138
+ "flex cursor-pointer flex-col items-center justify-center gap-1 border-0 p-0 text-[11px] font-medium",
139
+ tones[action.tone ?? "accent"],
140
+ )}
141
+ >
142
+ <Icon name={action.icon} size={18} />
143
+ {action.label}
144
+ </button>
145
+ ))}
146
+ </div>
147
+ );
148
+ };
149
+
150
+ return {
151
+ enabled,
152
+ offset,
153
+ dragging,
154
+ handlers,
155
+ swallowClick,
156
+ /** Close it (a click on the row while open closes, rather than opens). */
157
+ close: () => setOffset(0),
158
+ actions,
159
+ };
160
+ }
161
+
162
+ export { useSwipe };
163
+ export type { SwipeAction };