@bridgebrew/ui 0.0.0-stage → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (411) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +39 -2
  3. package/SOURCE.md +182 -0
  4. package/dist/build.js +871 -0
  5. package/dist/theme-css.js +896 -0
  6. package/dist/themes.js +69 -0
  7. package/dist/types/build/stylesheet.d.ts +31 -0
  8. package/dist/types/components/composite/command/command.d.ts +94 -0
  9. package/dist/types/components/composite/command/index.d.ts +2 -0
  10. package/dist/types/components/composite/draft-bar/draft-bar.d.ts +12 -0
  11. package/dist/types/components/composite/draft-bar/index.d.ts +2 -0
  12. package/dist/types/components/composite/image-field/image-field.d.ts +33 -0
  13. package/dist/types/components/composite/image-field/index.d.ts +2 -0
  14. package/dist/types/components/composite/list/index.d.ts +3 -0
  15. package/dist/types/components/composite/list/list-swipe.d.ts +28 -0
  16. package/dist/types/components/composite/list/list.d.ts +95 -0
  17. package/dist/types/components/composite/picker/index.d.ts +2 -0
  18. package/dist/types/components/composite/picker/picker.d.ts +44 -0
  19. package/dist/types/components/composite/prompt-field/index.d.ts +2 -0
  20. package/dist/types/components/composite/prompt-field/prompt-field.d.ts +18 -0
  21. package/dist/types/components/composite/properties/index.d.ts +2 -0
  22. package/dist/types/components/composite/properties/properties.d.ts +24 -0
  23. package/dist/types/components/composite/snooze-menu/index.d.ts +4 -0
  24. package/dist/types/components/composite/snooze-menu/presets.d.ts +36 -0
  25. package/dist/types/components/composite/snooze-menu/snooze-menu.d.ts +27 -0
  26. package/dist/types/components/composite/tag-input/index.d.ts +2 -0
  27. package/dist/types/components/composite/tag-input/tag-input.d.ts +22 -0
  28. package/dist/types/components/composite/wizard/index.d.ts +2 -0
  29. package/dist/types/components/composite/wizard/wizard.d.ts +53 -0
  30. package/dist/types/components/core/avatar/avatar.d.ts +16 -0
  31. package/dist/types/components/core/avatar/index.d.ts +2 -0
  32. package/dist/types/components/core/badge/badge.d.ts +8 -0
  33. package/dist/types/components/core/badge/index.d.ts +2 -0
  34. package/dist/types/components/core/breadcrumb/breadcrumb.d.ts +21 -0
  35. package/dist/types/components/core/breadcrumb/index.d.ts +2 -0
  36. package/dist/types/components/core/bullets/bullets.d.ts +15 -0
  37. package/dist/types/components/core/bullets/index.d.ts +2 -0
  38. package/dist/types/components/core/button/button.d.ts +14 -0
  39. package/dist/types/components/core/button/index.d.ts +2 -0
  40. package/dist/types/components/core/card/card.d.ts +16 -0
  41. package/dist/types/components/core/card/index.d.ts +2 -0
  42. package/dist/types/components/core/checkbox/checkbox.d.ts +15 -0
  43. package/dist/types/components/core/checkbox/index.d.ts +2 -0
  44. package/dist/types/components/core/cluster/cluster.d.ts +5 -0
  45. package/dist/types/components/core/cluster/index.d.ts +1 -0
  46. package/dist/types/components/core/code-block/code-block.d.ts +18 -0
  47. package/dist/types/components/core/code-block/index.d.ts +2 -0
  48. package/dist/types/components/core/collapsible/collapsible.d.ts +8 -0
  49. package/dist/types/components/core/collapsible/index.d.ts +1 -0
  50. package/dist/types/components/core/colour-picker/colour-picker.d.ts +25 -0
  51. package/dist/types/components/core/colour-picker/index.d.ts +4 -0
  52. package/dist/types/components/core/combobox/combobox.d.ts +63 -0
  53. package/dist/types/components/core/combobox/index.d.ts +2 -0
  54. package/dist/types/components/core/detail/detail.d.ts +12 -0
  55. package/dist/types/components/core/detail/index.d.ts +1 -0
  56. package/dist/types/components/core/dialog/dialog.d.ts +43 -0
  57. package/dist/types/components/core/dialog/drag.d.ts +4 -0
  58. package/dist/types/components/core/dialog/index.d.ts +2 -0
  59. package/dist/types/components/core/drop-zone/drop-zone.d.ts +23 -0
  60. package/dist/types/components/core/drop-zone/index.d.ts +2 -0
  61. package/dist/types/components/core/dropdown-menu/dropdown-menu.d.ts +78 -0
  62. package/dist/types/components/core/dropdown-menu/index.d.ts +2 -0
  63. package/dist/types/components/core/editable-field/editable-field.d.ts +42 -0
  64. package/dist/types/components/core/editable-field/index.d.ts +2 -0
  65. package/dist/types/components/core/empty-state/empty-state.d.ts +11 -0
  66. package/dist/types/components/core/empty-state/index.d.ts +2 -0
  67. package/dist/types/components/core/field/field.d.ts +31 -0
  68. package/dist/types/components/core/field/index.d.ts +2 -0
  69. package/dist/types/components/core/icon/icon-sets.d.ts +38 -0
  70. package/dist/types/components/core/icon/icon.d.ts +14 -0
  71. package/dist/types/components/core/icon/index.d.ts +2 -0
  72. package/dist/types/components/core/input/index.d.ts +4 -0
  73. package/dist/types/components/core/input/input.d.ts +22 -0
  74. package/dist/types/components/core/input/textarea.d.ts +8 -0
  75. package/dist/types/components/core/kbd/index.d.ts +2 -0
  76. package/dist/types/components/core/kbd/kbd.d.ts +7 -0
  77. package/dist/types/components/core/label/index.d.ts +2 -0
  78. package/dist/types/components/core/label/label.d.ts +13 -0
  79. package/dist/types/components/core/main-content/index.d.ts +2 -0
  80. package/dist/types/components/core/main-content/main-content.d.ts +18 -0
  81. package/dist/types/components/core/pane/index.d.ts +1 -0
  82. package/dist/types/components/core/pane/pane.d.ts +12 -0
  83. package/dist/types/components/core/pick-menu/index.d.ts +4 -0
  84. package/dist/types/components/core/pick-menu/pick-menu.d.ts +57 -0
  85. package/dist/types/components/core/pick-menu/tag-menu.d.ts +19 -0
  86. package/dist/types/components/core/popover/index.d.ts +2 -0
  87. package/dist/types/components/core/popover/popover.d.ts +22 -0
  88. package/dist/types/components/core/progress/index.d.ts +2 -0
  89. package/dist/types/components/core/progress/progress.d.ts +13 -0
  90. package/dist/types/components/core/resizable/index.d.ts +2 -0
  91. package/dist/types/components/core/resizable/resizable.d.ts +15 -0
  92. package/dist/types/components/core/resizable/use-remembered-layout.d.ts +31 -0
  93. package/dist/types/components/core/screen-link/index.d.ts +2 -0
  94. package/dist/types/components/core/screen-link/screen-link.d.ts +52 -0
  95. package/dist/types/components/core/scroll-area/index.d.ts +2 -0
  96. package/dist/types/components/core/scroll-area/scroll-area.d.ts +13 -0
  97. package/dist/types/components/core/scroll-area/steps.d.ts +5 -0
  98. package/dist/types/components/core/section/index.d.ts +2 -0
  99. package/dist/types/components/core/section/section.d.ts +16 -0
  100. package/dist/types/components/core/segment-group/index.d.ts +2 -0
  101. package/dist/types/components/core/segment-group/segment-group.d.ts +24 -0
  102. package/dist/types/components/core/select/index.d.ts +2 -0
  103. package/dist/types/components/core/select/select.d.ts +39 -0
  104. package/dist/types/components/core/skeleton/index.d.ts +2 -0
  105. package/dist/types/components/core/skeleton/skeleton.d.ts +13 -0
  106. package/dist/types/components/core/slider/index.d.ts +2 -0
  107. package/dist/types/components/core/slider/slider.d.ts +9 -0
  108. package/dist/types/components/core/sortable/index.d.ts +2 -0
  109. package/dist/types/components/core/sortable/sortable.d.ts +53 -0
  110. package/dist/types/components/core/split-view/index.d.ts +2 -0
  111. package/dist/types/components/core/split-view/split-view.d.ts +28 -0
  112. package/dist/types/components/core/status-icon/index.d.ts +2 -0
  113. package/dist/types/components/core/status-icon/status-icon.d.ts +13 -0
  114. package/dist/types/components/core/table/collapsible-rows.d.ts +7 -0
  115. package/dist/types/components/core/table/expand-toggle.d.ts +10 -0
  116. package/dist/types/components/core/table/group-header.d.ts +14 -0
  117. package/dist/types/components/core/table/index.d.ts +8 -0
  118. package/dist/types/components/core/table/table.d.ts +31 -0
  119. package/dist/types/components/core/tabs/index.d.ts +2 -0
  120. package/dist/types/components/core/tabs/tabs.d.ts +20 -0
  121. package/dist/types/components/core/tag-pill/index.d.ts +2 -0
  122. package/dist/types/components/core/tag-pill/tag-pill.d.ts +25 -0
  123. package/dist/types/components/core/thumbnail/index.d.ts +2 -0
  124. package/dist/types/components/core/thumbnail/thumbnail.d.ts +23 -0
  125. package/dist/types/components/core/toast/index.d.ts +2 -0
  126. package/dist/types/components/core/toast/toast.d.ts +88 -0
  127. package/dist/types/components/core/toggle/index.d.ts +2 -0
  128. package/dist/types/components/core/toggle/toggle.d.ts +9 -0
  129. package/dist/types/components/core/toggle-group/index.d.ts +2 -0
  130. package/dist/types/components/core/toggle-group/toggle-group.d.ts +21 -0
  131. package/dist/types/components/core/tooltip/index.d.ts +2 -0
  132. package/dist/types/components/core/tooltip/tooltip.d.ts +33 -0
  133. package/dist/types/components/layout/multi-pane/index.d.ts +4 -0
  134. package/dist/types/components/layout/multi-pane/list-detail.d.ts +17 -0
  135. package/dist/types/components/layout/multi-pane/multi-pane.d.ts +34 -0
  136. package/dist/types/components/layout/single-pane/index.d.ts +2 -0
  137. package/dist/types/components/layout/single-pane/single-pane.d.ts +11 -0
  138. package/dist/types/components/shell/app-shell/app-shell.d.ts +12 -0
  139. package/dist/types/components/shell/app-shell/index.d.ts +2 -0
  140. package/dist/types/components/shell/sidebar/index.d.ts +2 -0
  141. package/dist/types/components/shell/sidebar/sidebar-group.d.ts +45 -0
  142. package/dist/types/components/shell/sidebar/sidebar-item.d.ts +19 -0
  143. package/dist/types/components/shell/sidebar/sidebar-resize-handle.d.ts +17 -0
  144. package/dist/types/components/shell/sidebar/sidebar-tree.d.ts +42 -0
  145. package/dist/types/components/shell/sidebar/sidebar.d.ts +27 -0
  146. package/dist/types/components/template/address-book-template/address-book-template.d.ts +15 -0
  147. package/dist/types/components/template/address-book-template/index.d.ts +2 -0
  148. package/dist/types/components/template/mail-template/index.d.ts +2 -0
  149. package/dist/types/components/template/mail-template/mail-template.d.ts +11 -0
  150. package/dist/types/components/template/use-narrow.d.ts +3 -0
  151. package/dist/types/index.d.ts +149 -0
  152. package/dist/types/kit/check-rendering.d.ts +3 -0
  153. package/dist/types/kit/kit.d.ts +76 -0
  154. package/dist/types/lib/clipboard.d.ts +5 -0
  155. package/dist/types/lib/dates.d.ts +9 -0
  156. package/dist/types/lib/json.d.ts +26 -0
  157. package/dist/types/lib/keys.d.ts +15 -0
  158. package/dist/types/lib/utils.d.ts +2 -0
  159. package/dist/types/lib/view-scope.d.ts +22 -0
  160. package/dist/types/profile/profile.d.ts +34 -0
  161. package/dist/types/theme/appearance.d.ts +31 -0
  162. package/dist/types/theme/boot.d.ts +3 -0
  163. package/dist/types/theme/client-appearance-react.d.ts +3 -0
  164. package/dist/types/theme/client-appearance.d.ts +69 -0
  165. package/dist/types/theme/generate-tokens.d.ts +45 -0
  166. package/dist/types/theme/pack-themes-react.d.ts +24 -0
  167. package/dist/types/theme/palette.d.ts +111 -0
  168. package/dist/types/theme/semantic-mapping.d.ts +28 -0
  169. package/dist/types/theme/set-theme.d.ts +30 -0
  170. package/dist/types/theme/theme-colours.d.ts +14 -0
  171. package/dist/types/theme/theme-css.d.ts +3 -0
  172. package/dist/types/theme/themes.d.ts +63 -0
  173. package/dist/types/theme/wallpaper-sheet.d.ts +16 -0
  174. package/dist/types/theme/wallpaper-theme-react.d.ts +7 -0
  175. package/dist/types/theme/wallpaper-theme.d.ts +37 -0
  176. package/package.json +87 -3
  177. package/src/build/stylesheet.ts +128 -0
  178. package/src/components/composite/command/command.meta.yaml +74 -0
  179. package/src/components/composite/command/command.tsx +939 -0
  180. package/src/components/composite/command/index.ts +17 -0
  181. package/src/components/composite/draft-bar/draft-bar.meta.yaml +19 -0
  182. package/src/components/composite/draft-bar/draft-bar.tsx +57 -0
  183. package/src/components/composite/draft-bar/index.ts +2 -0
  184. package/src/components/composite/image-field/image-field.meta.yaml +69 -0
  185. package/src/components/composite/image-field/image-field.tsx +267 -0
  186. package/src/components/composite/image-field/index.ts +2 -0
  187. package/src/components/composite/list/index.ts +18 -0
  188. package/src/components/composite/list/list-swipe.tsx +163 -0
  189. package/src/components/composite/list/list.meta.yaml +238 -0
  190. package/src/components/composite/list/list.tsx +868 -0
  191. package/src/components/composite/picker/index.ts +2 -0
  192. package/src/components/composite/picker/picker.meta.yaml +103 -0
  193. package/src/components/composite/picker/picker.tsx +276 -0
  194. package/src/components/composite/prompt-field/index.ts +2 -0
  195. package/src/components/composite/prompt-field/prompt-field.meta.yaml +60 -0
  196. package/src/components/composite/prompt-field/prompt-field.tsx +81 -0
  197. package/src/components/composite/properties/index.ts +9 -0
  198. package/src/components/composite/properties/properties.meta.yaml +56 -0
  199. package/src/components/composite/properties/properties.tsx +132 -0
  200. package/src/components/composite/snooze-menu/index.ts +11 -0
  201. package/src/components/composite/snooze-menu/presets.ts +169 -0
  202. package/src/components/composite/snooze-menu/snooze-menu.meta.yaml +58 -0
  203. package/src/components/composite/snooze-menu/snooze-menu.tsx +146 -0
  204. package/src/components/composite/tag-input/index.ts +2 -0
  205. package/src/components/composite/tag-input/tag-input.meta.yaml +51 -0
  206. package/src/components/composite/tag-input/tag-input.tsx +404 -0
  207. package/src/components/composite/wizard/index.ts +2 -0
  208. package/src/components/composite/wizard/wizard.meta.yaml +73 -0
  209. package/src/components/composite/wizard/wizard.tsx +256 -0
  210. package/src/components/core/avatar/avatar.meta.yaml +71 -0
  211. package/src/components/core/avatar/avatar.tsx +92 -0
  212. package/src/components/core/avatar/index.ts +2 -0
  213. package/src/components/core/badge/badge.meta.yaml +34 -0
  214. package/src/components/core/badge/badge.tsx +23 -0
  215. package/src/components/core/badge/index.ts +2 -0
  216. package/src/components/core/breadcrumb/breadcrumb.meta.yaml +45 -0
  217. package/src/components/core/breadcrumb/breadcrumb.tsx +110 -0
  218. package/src/components/core/breadcrumb/index.ts +2 -0
  219. package/src/components/core/bullets/bullets.meta.yaml +37 -0
  220. package/src/components/core/bullets/bullets.tsx +60 -0
  221. package/src/components/core/bullets/index.ts +2 -0
  222. package/src/components/core/button/button.meta.yaml +91 -0
  223. package/src/components/core/button/button.tsx +93 -0
  224. package/src/components/core/button/index.ts +2 -0
  225. package/src/components/core/card/card.meta.yaml +94 -0
  226. package/src/components/core/card/card.tsx +54 -0
  227. package/src/components/core/card/index.ts +2 -0
  228. package/src/components/core/checkbox/checkbox.meta.yaml +59 -0
  229. package/src/components/core/checkbox/checkbox.tsx +106 -0
  230. package/src/components/core/checkbox/index.ts +2 -0
  231. package/src/components/core/cluster/cluster.meta.yaml +4 -0
  232. package/src/components/core/cluster/cluster.tsx +17 -0
  233. package/src/components/core/cluster/index.ts +1 -0
  234. package/src/components/core/code-block/code-block.meta.yaml +30 -0
  235. package/src/components/core/code-block/code-block.tsx +93 -0
  236. package/src/components/core/code-block/index.ts +2 -0
  237. package/src/components/core/collapsible/collapsible.meta.yaml +34 -0
  238. package/src/components/core/collapsible/collapsible.tsx +54 -0
  239. package/src/components/core/collapsible/index.ts +1 -0
  240. package/src/components/core/colour-picker/colour-picker.meta.yaml +52 -0
  241. package/src/components/core/colour-picker/colour-picker.tsx +314 -0
  242. package/src/components/core/colour-picker/index.ts +4 -0
  243. package/src/components/core/combobox/combobox.meta.yaml +75 -0
  244. package/src/components/core/combobox/combobox.tsx +288 -0
  245. package/src/components/core/combobox/index.ts +2 -0
  246. package/src/components/core/detail/detail.meta.yaml +13 -0
  247. package/src/components/core/detail/detail.tsx +73 -0
  248. package/src/components/core/detail/index.ts +1 -0
  249. package/src/components/core/dialog/dialog.meta.yaml +95 -0
  250. package/src/components/core/dialog/dialog.tsx +254 -0
  251. package/src/components/core/dialog/drag.ts +40 -0
  252. package/src/components/core/dialog/index.ts +25 -0
  253. package/src/components/core/drop-zone/drop-zone.meta.yaml +55 -0
  254. package/src/components/core/drop-zone/drop-zone.tsx +146 -0
  255. package/src/components/core/drop-zone/index.ts +2 -0
  256. package/src/components/core/dropdown-menu/dropdown-menu.meta.yaml +118 -0
  257. package/src/components/core/dropdown-menu/dropdown-menu.tsx +407 -0
  258. package/src/components/core/dropdown-menu/index.ts +32 -0
  259. package/src/components/core/editable-field/editable-field.meta.yaml +120 -0
  260. package/src/components/core/editable-field/editable-field.tsx +346 -0
  261. package/src/components/core/editable-field/index.ts +2 -0
  262. package/src/components/core/empty-state/empty-state.meta.yaml +21 -0
  263. package/src/components/core/empty-state/empty-state.tsx +42 -0
  264. package/src/components/core/empty-state/index.ts +2 -0
  265. package/src/components/core/field/field.meta.yaml +37 -0
  266. package/src/components/core/field/field.tsx +100 -0
  267. package/src/components/core/field/index.ts +9 -0
  268. package/src/components/core/icon/curated-names.json +107 -0
  269. package/src/components/core/icon/icon-sets.ts +109 -0
  270. package/src/components/core/icon/icon.meta.yaml +30 -0
  271. package/src/components/core/icon/icon.tsx +93 -0
  272. package/src/components/core/icon/index.ts +2 -0
  273. package/src/components/core/input/index.ts +4 -0
  274. package/src/components/core/input/input.meta.yaml +98 -0
  275. package/src/components/core/input/input.tsx +133 -0
  276. package/src/components/core/input/textarea.meta.yaml +79 -0
  277. package/src/components/core/input/textarea.tsx +63 -0
  278. package/src/components/core/kbd/index.ts +2 -0
  279. package/src/components/core/kbd/kbd.meta.yaml +12 -0
  280. package/src/components/core/kbd/kbd.tsx +29 -0
  281. package/src/components/core/label/index.ts +2 -0
  282. package/src/components/core/label/label.meta.yaml +55 -0
  283. package/src/components/core/label/label.tsx +72 -0
  284. package/src/components/core/main-content/index.ts +2 -0
  285. package/src/components/core/main-content/main-content.meta.yaml +23 -0
  286. package/src/components/core/main-content/main-content.tsx +49 -0
  287. package/src/components/core/pane/index.ts +1 -0
  288. package/src/components/core/pane/pane.meta.yaml +13 -0
  289. package/src/components/core/pane/pane.tsx +64 -0
  290. package/src/components/core/pick-menu/index.ts +4 -0
  291. package/src/components/core/pick-menu/pick-menu.meta.yaml +36 -0
  292. package/src/components/core/pick-menu/pick-menu.tsx +348 -0
  293. package/src/components/core/pick-menu/tag-menu.meta.yaml +7 -0
  294. package/src/components/core/pick-menu/tag-menu.tsx +79 -0
  295. package/src/components/core/popover/index.ts +2 -0
  296. package/src/components/core/popover/popover.meta.yaml +16 -0
  297. package/src/components/core/popover/popover.tsx +66 -0
  298. package/src/components/core/progress/index.ts +2 -0
  299. package/src/components/core/progress/progress.meta.yaml +47 -0
  300. package/src/components/core/progress/progress.tsx +56 -0
  301. package/src/components/core/resizable/index.ts +13 -0
  302. package/src/components/core/resizable/resizable.meta.yaml +110 -0
  303. package/src/components/core/resizable/resizable.tsx +125 -0
  304. package/src/components/core/resizable/use-remembered-layout.ts +261 -0
  305. package/src/components/core/screen-link/index.ts +2 -0
  306. package/src/components/core/screen-link/screen-link.meta.yaml +34 -0
  307. package/src/components/core/screen-link/screen-link.tsx +100 -0
  308. package/src/components/core/scroll-area/index.ts +2 -0
  309. package/src/components/core/scroll-area/scroll-area.meta.yaml +72 -0
  310. package/src/components/core/scroll-area/scroll-area.tsx +95 -0
  311. package/src/components/core/scroll-area/steps.tsx +72 -0
  312. package/src/components/core/section/index.ts +2 -0
  313. package/src/components/core/section/section.meta.yaml +72 -0
  314. package/src/components/core/section/section.tsx +93 -0
  315. package/src/components/core/segment-group/index.ts +2 -0
  316. package/src/components/core/segment-group/segment-group.meta.yaml +71 -0
  317. package/src/components/core/segment-group/segment-group.tsx +166 -0
  318. package/src/components/core/select/index.ts +20 -0
  319. package/src/components/core/select/select.meta.yaml +48 -0
  320. package/src/components/core/select/select.tsx +226 -0
  321. package/src/components/core/skeleton/index.ts +2 -0
  322. package/src/components/core/skeleton/skeleton.meta.yaml +50 -0
  323. package/src/components/core/skeleton/skeleton.tsx +71 -0
  324. package/src/components/core/slider/index.ts +2 -0
  325. package/src/components/core/slider/slider.meta.yaml +55 -0
  326. package/src/components/core/slider/slider.tsx +46 -0
  327. package/src/components/core/sortable/index.ts +16 -0
  328. package/src/components/core/sortable/sortable.meta.yaml +125 -0
  329. package/src/components/core/sortable/sortable.tsx +471 -0
  330. package/src/components/core/split-view/index.ts +2 -0
  331. package/src/components/core/split-view/split-view.meta.yaml +85 -0
  332. package/src/components/core/split-view/split-view.tsx +193 -0
  333. package/src/components/core/status-icon/index.ts +2 -0
  334. package/src/components/core/status-icon/status-icon.meta.yaml +64 -0
  335. package/src/components/core/status-icon/status-icon.tsx +94 -0
  336. package/src/components/core/table/collapsible-rows.tsx +30 -0
  337. package/src/components/core/table/expand-toggle.tsx +58 -0
  338. package/src/components/core/table/group-header.tsx +35 -0
  339. package/src/components/core/table/index.ts +26 -0
  340. package/src/components/core/table/table.meta.yaml +67 -0
  341. package/src/components/core/table/table.tsx +166 -0
  342. package/src/components/core/tabs/index.ts +2 -0
  343. package/src/components/core/tabs/tabs.meta.yaml +57 -0
  344. package/src/components/core/tabs/tabs.tsx +74 -0
  345. package/src/components/core/tag-pill/index.ts +2 -0
  346. package/src/components/core/tag-pill/tag-pill.meta.yaml +19 -0
  347. package/src/components/core/tag-pill/tag-pill.tsx +102 -0
  348. package/src/components/core/thumbnail/index.ts +2 -0
  349. package/src/components/core/thumbnail/thumbnail.meta.yaml +59 -0
  350. package/src/components/core/thumbnail/thumbnail.tsx +162 -0
  351. package/src/components/core/toast/index.ts +12 -0
  352. package/src/components/core/toast/toast.meta.yaml +93 -0
  353. package/src/components/core/toast/toast.tsx +763 -0
  354. package/src/components/core/toggle/index.ts +2 -0
  355. package/src/components/core/toggle/toggle.meta.yaml +53 -0
  356. package/src/components/core/toggle/toggle.tsx +44 -0
  357. package/src/components/core/toggle-group/index.ts +2 -0
  358. package/src/components/core/toggle-group/toggle-group.meta.yaml +59 -0
  359. package/src/components/core/toggle-group/toggle-group.tsx +68 -0
  360. package/src/components/core/tooltip/index.ts +7 -0
  361. package/src/components/core/tooltip/tooltip.meta.yaml +93 -0
  362. package/src/components/core/tooltip/tooltip.tsx +198 -0
  363. package/src/components/layout/multi-pane/index.ts +4 -0
  364. package/src/components/layout/multi-pane/list-detail.tsx +45 -0
  365. package/src/components/layout/multi-pane/multi-pane.meta.yaml +67 -0
  366. package/src/components/layout/multi-pane/multi-pane.tsx +158 -0
  367. package/src/components/layout/single-pane/index.ts +2 -0
  368. package/src/components/layout/single-pane/single-pane.meta.yaml +35 -0
  369. package/src/components/layout/single-pane/single-pane.tsx +48 -0
  370. package/src/components/shell/app-shell/app-shell.meta.yaml +65 -0
  371. package/src/components/shell/app-shell/app-shell.tsx +61 -0
  372. package/src/components/shell/app-shell/index.ts +2 -0
  373. package/src/components/shell/sidebar/index.ts +35 -0
  374. package/src/components/shell/sidebar/sidebar-group.tsx +254 -0
  375. package/src/components/shell/sidebar/sidebar-item.tsx +88 -0
  376. package/src/components/shell/sidebar/sidebar-resize-handle.tsx +101 -0
  377. package/src/components/shell/sidebar/sidebar-tree.tsx +325 -0
  378. package/src/components/shell/sidebar/sidebar.meta.yaml +126 -0
  379. package/src/components/shell/sidebar/sidebar.tsx +142 -0
  380. package/src/components/template/address-book-template/address-book-template.meta.yaml +22 -0
  381. package/src/components/template/address-book-template/address-book-template.tsx +201 -0
  382. package/src/components/template/address-book-template/index.ts +2 -0
  383. package/src/components/template/mail-template/index.ts +2 -0
  384. package/src/components/template/mail-template/mail-template.meta.yaml +22 -0
  385. package/src/components/template/mail-template/mail-template.tsx +731 -0
  386. package/src/components/template/use-narrow.ts +18 -0
  387. package/src/index.ts +505 -0
  388. package/src/kit/check-rendering.tsx +130 -0
  389. package/src/kit/kit.tsx +177 -0
  390. package/src/lib/clipboard.ts +27 -0
  391. package/src/lib/dates.ts +13 -0
  392. package/src/lib/json.ts +59 -0
  393. package/src/lib/keys.ts +54 -0
  394. package/src/lib/utils.ts +12 -0
  395. package/src/lib/view-scope.tsx +60 -0
  396. package/src/profile/profile.ts +238 -0
  397. package/src/theme/appearance.ts +198 -0
  398. package/src/theme/boot.ts +6 -0
  399. package/src/theme/client-appearance-react.ts +14 -0
  400. package/src/theme/client-appearance.ts +284 -0
  401. package/src/theme/generate-tokens.ts +658 -0
  402. package/src/theme/pack-themes-react.ts +107 -0
  403. package/src/theme/palette.ts +301 -0
  404. package/src/theme/semantic-mapping.ts +165 -0
  405. package/src/theme/set-theme.ts +162 -0
  406. package/src/theme/theme-colours.ts +60 -0
  407. package/src/theme/theme-css.ts +15 -0
  408. package/src/theme/themes.ts +133 -0
  409. package/src/theme/wallpaper-sheet.ts +58 -0
  410. package/src/theme/wallpaper-theme-react.ts +60 -0
  411. package/src/theme/wallpaper-theme.ts +231 -0
@@ -0,0 +1,407 @@
1
+ import * as React from "react";
2
+ import { Menu as MenuPrimitive } from "@base-ui/react/menu";
3
+ import { ContextMenu as ContextMenuPrimitive } from "@base-ui/react/context-menu";
4
+ import { cva, type VariantProps } from "class-variance-authority";
5
+ import { ChevronRight } from "lucide-react";
6
+
7
+ import { cn } from "../../../lib/utils";
8
+ import { formatKeys } from "../../../lib/keys";
9
+
10
+ // --- DropdownMenu (root) ---
11
+
12
+ interface DropdownMenuProps extends React.ComponentProps<typeof MenuPrimitive.Root> {}
13
+
14
+ function DropdownMenu(props: DropdownMenuProps) {
15
+ return <MenuPrimitive.Root {...props} />;
16
+ }
17
+
18
+ // --- DropdownMenuTrigger ---
19
+
20
+ interface DropdownMenuTriggerProps extends React.ComponentProps<typeof MenuPrimitive.Trigger> {}
21
+
22
+ /** Base UI 1.7's trigger renders first with a placeholder of its menu's state, and only reads the real one once its
23
+ * passive effects ran: a press before them (right after the trigger appears, the page busy) opened nothing. Such a
24
+ * press is held (Base UI's, the caller's and the parents' click handlers skipped), and given again as a click once
25
+ * the trigger has rendered again. */
26
+ function DropdownMenuTrigger({
27
+ className,
28
+ onPointerDown,
29
+ onMouseDown,
30
+ onClick,
31
+ ...props
32
+ }: DropdownMenuTriggerProps) {
33
+ const [ready, setReady] = React.useState(false);
34
+ const held = React.useRef<{ target: HTMLElement; detail: number } | null>(null);
35
+ React.useEffect(() => setReady(true), []);
36
+ React.useEffect(() => {
37
+ if (!ready || !held.current) return;
38
+ const { target, detail } = held.current;
39
+ held.current = null;
40
+ target.dispatchEvent(new MouseEvent("click", { bubbles: true, cancelable: true, detail }));
41
+ }, [ready]);
42
+ return (
43
+ <MenuPrimitive.Trigger
44
+ data-slot="dropdown-menu-trigger"
45
+ className={className}
46
+ onPointerDown={(event) => {
47
+ onPointerDown?.(event);
48
+ if (!ready) event.preventBaseUIHandler();
49
+ }}
50
+ onMouseDown={(event) => {
51
+ onMouseDown?.(event);
52
+ if (!ready) event.preventBaseUIHandler();
53
+ }}
54
+ onClick={(event) => {
55
+ if (ready) return onClick?.(event);
56
+ // Held whole: the given click runs the caller's and the parents' handlers once.
57
+ event.preventBaseUIHandler();
58
+ event.stopPropagation();
59
+ held.current = { target: event.currentTarget, detail: event.detail };
60
+ }}
61
+ {...props}
62
+ />
63
+ );
64
+ }
65
+
66
+ // --- ContextMenu: the same menu, opened by a right-click (or the keyboard's
67
+ // context menu key, Shift+F10) on its trigger area; its content and items are
68
+ // DropdownMenuContent and DropdownMenuItem. ---
69
+
70
+ interface ContextMenuProps extends React.ComponentProps<typeof ContextMenuPrimitive.Root> {}
71
+
72
+ function ContextMenu(props: ContextMenuProps) {
73
+ return <ContextMenuPrimitive.Root {...props} />;
74
+ }
75
+
76
+ interface ContextMenuTriggerProps extends React.ComponentProps<
77
+ typeof ContextMenuPrimitive.Trigger
78
+ > {}
79
+
80
+ /** The keyboard's context menu key or Shift+F10, on a focused element: sends it the `contextmenu` a right-click would,
81
+ * under it (browsers do not all send one for those keys: macOS never does). For any element whose menu opens on
82
+ * `contextmenu`, not only `ContextMenuTrigger`'s; `true` when it did. */
83
+ function openContextMenuFromKey(event: React.KeyboardEvent): boolean {
84
+ if (
85
+ event.defaultPrevented ||
86
+ !(event.key === "ContextMenu" || (event.shiftKey && event.key === "F10"))
87
+ )
88
+ return false;
89
+ event.preventDefault();
90
+ const target = event.target as HTMLElement;
91
+ const box = target.getBoundingClientRect();
92
+ target.dispatchEvent(
93
+ new MouseEvent("contextmenu", {
94
+ bubbles: true,
95
+ cancelable: true,
96
+ clientX: box.left + 8,
97
+ clientY: box.bottom,
98
+ }),
99
+ );
100
+ return true;
101
+ }
102
+
103
+ /** The area a right-click opens the menu in: a `div` around its children. The keyboard's context menu key and
104
+ * Shift+F10 on a focused element inside open it too, under that element (`openContextMenuFromKey`). */
105
+ function ContextMenuTrigger({ onKeyDown, ...props }: ContextMenuTriggerProps) {
106
+ return (
107
+ <ContextMenuPrimitive.Trigger
108
+ data-slot="context-menu-trigger"
109
+ onKeyDown={(event) => {
110
+ onKeyDown?.(event);
111
+ openContextMenuFromKey(event);
112
+ }}
113
+ {...props}
114
+ />
115
+ );
116
+ }
117
+
118
+ // --- DropdownMenuContent ---
119
+
120
+ interface DropdownMenuContentProps extends React.ComponentProps<typeof MenuPrimitive.Popup> {
121
+ /** Distance from the trigger in px (lives on Base UI's Positioner) */
122
+ sideOffset?: React.ComponentProps<typeof MenuPrimitive.Positioner>["sideOffset"];
123
+ /** Alignment against the trigger (lives on Base UI's Positioner) */
124
+ align?: React.ComponentProps<typeof MenuPrimitive.Positioner>["align"];
125
+ /** Which side of the trigger to position against (lives on Base UI's Positioner) */
126
+ side?: React.ComponentProps<typeof MenuPrimitive.Positioner>["side"];
127
+ /** Offset along the alignment axis (lives on Base UI's Positioner) */
128
+ alignOffset?: React.ComponentProps<typeof MenuPrimitive.Positioner>["alignOffset"];
129
+ /** Minimum distance from the viewport edges (lives on Base UI's Positioner) */
130
+ collisionPadding?: React.ComponentProps<typeof MenuPrimitive.Positioner>["collisionPadding"];
131
+ /** What to position against instead of the trigger: an element, or a point (a virtual element, e.g. where a
132
+ * right-click happened) (lives on Base UI's Positioner) */
133
+ anchor?: React.ComponentProps<typeof MenuPrimitive.Positioner>["anchor"];
134
+ }
135
+
136
+ function DropdownMenuContent({
137
+ className,
138
+ sideOffset = 4,
139
+ align = "start",
140
+ side,
141
+ alignOffset,
142
+ collisionPadding,
143
+ anchor,
144
+ ...props
145
+ }: DropdownMenuContentProps) {
146
+ // An item's one-letter keys (`keys="R"`) run it while the menu is open (research-033's mockup).
147
+ const letters = React.useRef(new Map<string, HTMLElement>());
148
+ // Never an empty menu (owner, 17 October 2026): nothing to offer, nothing shown.
149
+ if (React.Children.toArray(props.children).length === 0) return null;
150
+ return (
151
+ <MenuPrimitive.Portal>
152
+ <MenuPrimitive.Positioner
153
+ sideOffset={sideOffset}
154
+ align={align}
155
+ side={side}
156
+ alignOffset={alignOffset}
157
+ collisionPadding={collisionPadding}
158
+ anchor={anchor}
159
+ className="z-50"
160
+ >
161
+ <MenuPrimitive.Popup
162
+ data-slot="dropdown-menu-content"
163
+ className={cn(
164
+ "z-50 min-w-[200px] bg-surface rounded-dropdown p-1 flex flex-col",
165
+ className,
166
+ )}
167
+ style={{ boxShadow: "var(--shadow-dropdown)" }}
168
+ {...props}
169
+ onKeyDownCapture={(event) => {
170
+ props.onKeyDownCapture?.(event);
171
+ if (event.metaKey || event.ctrlKey || event.altKey || event.key.length !== 1) return;
172
+ const item = letters.current.get(event.key.toLowerCase());
173
+ if (!item) return;
174
+ event.preventDefault();
175
+ event.stopPropagation();
176
+ item.click();
177
+ }}
178
+ >
179
+ <MenuLetters.Provider value={letters}>{props.children}</MenuLetters.Provider>
180
+ </MenuPrimitive.Popup>
181
+ </MenuPrimitive.Positioner>
182
+ </MenuPrimitive.Portal>
183
+ );
184
+ }
185
+
186
+ /** The open menu's one-letter items, by letter (lower case). */
187
+ const MenuLetters = React.createContext<React.RefObject<Map<string, HTMLElement>> | null>(null);
188
+
189
+ // --- DropdownMenuItem ---
190
+
191
+ const dropdownMenuItemVariants = cva(
192
+ // Bridge: a disabled item (Base UI's `data-disabled`) is dimmed and inert, as a disabled Button.
193
+ "flex items-center gap-2 px-2 rounded-control text-sm font-normal cursor-pointer bg-transparent border-0 w-full text-left transition-[background] duration-[80ms] outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
194
+ {
195
+ variants: {
196
+ variant: {
197
+ default: "text-foreground focus:bg-hover data-[highlighted]:bg-hover",
198
+ destructive:
199
+ "text-destructive focus:bg-destructive-subtle data-[highlighted]:bg-destructive-subtle",
200
+ },
201
+ // `large`: a launcher's items (a Start menu's first column), taller with a bigger icon; a rendering reads
202
+ // `data-size`.
203
+ size: {
204
+ default: "h-md",
205
+ large: "h-lg gap-2.5 [&_svg:not([class*='size-'])]:size-5",
206
+ },
207
+ },
208
+ defaultVariants: {
209
+ variant: "default",
210
+ size: "default",
211
+ },
212
+ },
213
+ );
214
+
215
+ interface DropdownMenuItemProps
216
+ extends
217
+ Omit<React.ComponentProps<typeof MenuPrimitive.Item>, "onSelect">,
218
+ VariantProps<typeof dropdownMenuItemVariants> {
219
+ /** In-repo activation callback (fires on click and Enter/Space). */
220
+ onSelect?: (event: Event) => void;
221
+ /** Its shortcut ("R", "Meta+Backspace"), shown at its end; a single letter runs it while the menu is open. */
222
+ keys?: string;
223
+ }
224
+
225
+ function DropdownMenuItem({
226
+ className,
227
+ variant,
228
+ size,
229
+ onSelect,
230
+ onClick,
231
+ keys,
232
+ children,
233
+ ref,
234
+ ...props
235
+ }: DropdownMenuItemProps) {
236
+ const letters = React.useContext(MenuLetters);
237
+ const element = React.useRef<HTMLElement | null>(null);
238
+ const letter = keys !== undefined && keys.length === 1 ? keys.toLowerCase() : undefined;
239
+ React.useEffect(() => {
240
+ if (!letters || letter === undefined || !element.current) return;
241
+ const map = letters.current;
242
+ map.set(letter, element.current);
243
+ return () => {
244
+ if (map.get(letter) === element.current) map.delete(letter);
245
+ };
246
+ }, [letters, letter]);
247
+ return (
248
+ <MenuPrimitive.Item
249
+ data-slot="dropdown-menu-item"
250
+ data-variant={variant ?? "default"}
251
+ data-size={size ?? "default"}
252
+ className={cn(dropdownMenuItemVariants({ variant, size, className }))}
253
+ ref={(node: HTMLElement | null) => {
254
+ element.current = node;
255
+ if (typeof ref === "function") ref(node);
256
+ else if (ref) ref.current = node;
257
+ }}
258
+ onClick={(event) => {
259
+ onClick?.(event);
260
+ onSelect?.(event.nativeEvent);
261
+ }}
262
+ {...props}
263
+ >
264
+ {children}
265
+ {keys !== undefined && <DropdownMenuShortcut>{formatKeys(keys)}</DropdownMenuShortcut>}
266
+ </MenuPrimitive.Item>
267
+ );
268
+ }
269
+
270
+ // --- DropdownMenuSub: a submenu, opened by hovering its trigger item or by ArrowRight / Enter on it; its content is
271
+ // positioned beside the parent menu. Works inside a DropdownMenu and a ContextMenu. ---
272
+
273
+ interface DropdownMenuSubProps extends React.ComponentProps<typeof MenuPrimitive.SubmenuRoot> {}
274
+
275
+ function DropdownMenuSub(props: DropdownMenuSubProps) {
276
+ return <MenuPrimitive.SubmenuRoot {...props} />;
277
+ }
278
+
279
+ interface DropdownMenuSubTriggerProps
280
+ extends
281
+ React.ComponentProps<typeof MenuPrimitive.SubmenuTrigger>,
282
+ Pick<VariantProps<typeof dropdownMenuItemVariants>, "size"> {}
283
+
284
+ /** An item that opens its submenu, with a chevron at the right; sized as the items beside it (`size`). */
285
+ function DropdownMenuSubTrigger({
286
+ className,
287
+ children,
288
+ size,
289
+ ...props
290
+ }: DropdownMenuSubTriggerProps) {
291
+ return (
292
+ <MenuPrimitive.SubmenuTrigger
293
+ data-slot="dropdown-menu-sub-trigger"
294
+ data-size={size ?? "default"}
295
+ className={cn(dropdownMenuItemVariants({ size }), "data-[popup-open]:bg-hover", className)}
296
+ {...props}
297
+ >
298
+ {children}
299
+ <ChevronRight aria-hidden="true" size={14} className="ml-auto text-muted" />
300
+ </MenuPrimitive.SubmenuTrigger>
301
+ );
302
+ }
303
+
304
+ interface DropdownMenuSubContentProps extends DropdownMenuContentProps {}
305
+
306
+ /** The submenu's items: a DropdownMenuContent beside its trigger. */
307
+ function DropdownMenuSubContent({
308
+ side = "inline-end",
309
+ align = "start",
310
+ sideOffset = 6,
311
+ alignOffset = -4,
312
+ ...props
313
+ }: DropdownMenuSubContentProps) {
314
+ return (
315
+ <DropdownMenuContent
316
+ data-slot="dropdown-menu-sub-content"
317
+ side={side}
318
+ align={align}
319
+ sideOffset={sideOffset}
320
+ alignOffset={alignOffset}
321
+ {...props}
322
+ />
323
+ );
324
+ }
325
+
326
+ // --- DropdownMenuSeparator ---
327
+
328
+ interface DropdownMenuSeparatorProps extends React.ComponentProps<typeof MenuPrimitive.Separator> {}
329
+
330
+ function DropdownMenuSeparator({ className, ...props }: DropdownMenuSeparatorProps) {
331
+ return (
332
+ <MenuPrimitive.Separator
333
+ data-slot="dropdown-menu-separator"
334
+ className={cn("h-px bg-border my-1", className)}
335
+ {...props}
336
+ />
337
+ );
338
+ }
339
+
340
+ // --- DropdownMenuLabel ---
341
+
342
+ // Plain <div> (like Radix's DropdownMenu.Label): Base UI's Menu.GroupLabel
343
+ // throws when used outside <Menu.Group>, but our label is used standalone.
344
+ interface DropdownMenuLabelProps extends React.ComponentProps<"div"> {}
345
+
346
+ function DropdownMenuLabel({ className, ...props }: DropdownMenuLabelProps) {
347
+ return (
348
+ <div
349
+ data-slot="dropdown-menu-label"
350
+ className={cn("text-xs font-medium text-muted px-2 pt-1.5 pb-0.5", className)}
351
+ {...props}
352
+ />
353
+ );
354
+ }
355
+
356
+ // --- DropdownMenuGroup ---
357
+
358
+ const DropdownMenuGroup = MenuPrimitive.Group;
359
+
360
+ interface DropdownMenuGroupProps extends React.ComponentProps<typeof MenuPrimitive.Group> {}
361
+
362
+ // --- DropdownMenuShortcut ---
363
+
364
+ interface DropdownMenuShortcutProps extends React.ComponentProps<"span"> {}
365
+
366
+ function DropdownMenuShortcut({ className, ...props }: DropdownMenuShortcutProps) {
367
+ return (
368
+ <span
369
+ data-slot="dropdown-menu-shortcut"
370
+ className={cn("ml-auto text-xs text-muted font-normal", className)}
371
+ {...props}
372
+ />
373
+ );
374
+ }
375
+
376
+ export {
377
+ DropdownMenu,
378
+ DropdownMenuTrigger,
379
+ DropdownMenuContent,
380
+ DropdownMenuItem,
381
+ dropdownMenuItemVariants,
382
+ DropdownMenuSeparator,
383
+ DropdownMenuLabel,
384
+ DropdownMenuGroup,
385
+ DropdownMenuShortcut,
386
+ DropdownMenuSub,
387
+ DropdownMenuSubTrigger,
388
+ DropdownMenuSubContent,
389
+ ContextMenu,
390
+ ContextMenuTrigger,
391
+ openContextMenuFromKey,
392
+ };
393
+ export type {
394
+ DropdownMenuProps,
395
+ DropdownMenuTriggerProps,
396
+ DropdownMenuContentProps,
397
+ DropdownMenuItemProps,
398
+ DropdownMenuSeparatorProps,
399
+ DropdownMenuLabelProps,
400
+ DropdownMenuGroupProps,
401
+ DropdownMenuShortcutProps,
402
+ DropdownMenuSubProps,
403
+ DropdownMenuSubTriggerProps,
404
+ DropdownMenuSubContentProps,
405
+ ContextMenuProps,
406
+ ContextMenuTriggerProps,
407
+ };
@@ -0,0 +1,32 @@
1
+ export {
2
+ DropdownMenu,
3
+ DropdownMenuTrigger,
4
+ DropdownMenuContent,
5
+ DropdownMenuItem,
6
+ dropdownMenuItemVariants,
7
+ DropdownMenuSeparator,
8
+ DropdownMenuLabel,
9
+ DropdownMenuGroup,
10
+ DropdownMenuShortcut,
11
+ DropdownMenuSub,
12
+ DropdownMenuSubTrigger,
13
+ DropdownMenuSubContent,
14
+ ContextMenu,
15
+ ContextMenuTrigger,
16
+ openContextMenuFromKey,
17
+ } from "./dropdown-menu";
18
+ export type {
19
+ DropdownMenuProps,
20
+ DropdownMenuTriggerProps,
21
+ DropdownMenuContentProps,
22
+ DropdownMenuItemProps,
23
+ DropdownMenuSeparatorProps,
24
+ DropdownMenuLabelProps,
25
+ DropdownMenuGroupProps,
26
+ DropdownMenuShortcutProps,
27
+ DropdownMenuSubProps,
28
+ DropdownMenuSubTriggerProps,
29
+ DropdownMenuSubContentProps,
30
+ ContextMenuProps,
31
+ ContextMenuTriggerProps,
32
+ } from "./dropdown-menu";
@@ -0,0 +1,120 @@
1
+ name: EditableField
2
+ description: "A presentational inline field that reads as plain text until hovered or focused. It owns no data: the parent holds `value` and answers `onChange`. Visual only — @bridge/records' RecordField binds it to data."
3
+ layer: core
4
+ category: input
5
+ when_to_use:
6
+ - "For a record property or title edited in place on a detail card"
7
+ - "With @bridge/records' RecordField, which binds the draft, the commit and the save state to data"
8
+ - "When the parent already owns the draft (React Hook Form, useState) and wants the field's visuals and commit keys"
9
+ when_not_to_use:
10
+ - "As a standalone data-bound field — use RecordField from @bridge/records, which wires the data"
11
+ - "For a multi-line description with a visible border — use Textarea"
12
+ - "When a save button is expected — this commits on blur, Enter or ⌘/Ctrl+Enter only"
13
+ composition_partners:
14
+ - Tooltip/TooltipProvider (the field's Retry and Discard buttons use the kit Tooltip; wrap in a Provider)
15
+ - Input (the property and title variants draw through it)
16
+ - Textarea (when `multiline`)
17
+ props:
18
+ - name: value / onChange
19
+ type: "string / (text: string) => void"
20
+ required: true
21
+ description: "The controlled draft. The parent holds it; EditableField only draws it and reports keystrokes"
22
+ - name: ref
23
+ type: "React.Ref<HTMLInputElement | HTMLTextAreaElement>"
24
+ required: false
25
+ description: "Forwarded to the input (or the textarea, when multiline), for React Hook Form's register"
26
+ - name: onCommit
27
+ type: "() => void"
28
+ required: false
29
+ description: "Called at most once per edit: on blur, on Enter (single line) or ⌘/Ctrl+Enter (multiline). Enter commits then blurs, and the blur that follows does not commit again"
30
+ - name: onRevert
31
+ type: "() => void"
32
+ required: false
33
+ description: "Called on Escape; the field then blurs without committing"
34
+ - name: state
35
+ type: "'idle' | 'saving' | 'saved' | 'failed' | 'conflict'"
36
+ required: false
37
+ default: "'idle'"
38
+ description: "The save state, set as data-state on the root. saving shows a spinner, saved a check that fades after 400 ms, failed a Retry and a Discard button, conflict Keep mine and Take theirs. idle, saving and saved show no action buttons"
39
+ - name: error
40
+ type: string
41
+ required: false
42
+ description: "The failure message shown in the failed state's Discard tooltip ('Not saved: <error>')"
43
+ - name: theirs
44
+ type: string
45
+ required: false
46
+ description: 'The other window''s version, shown in the conflict state''s Take theirs tooltip (''Changed elsewhere, now "<theirs>"'')'
47
+ - name: onRetry / onReset
48
+ type: "() => void / () => void"
49
+ required: false
50
+ description: "Retry (failed) and Keep mine (conflict); Discard my change (failed) and Take theirs (conflict). Clicking either never commits the edit (their mousedown is prevented)"
51
+ - name: changedElsewhere
52
+ type: boolean
53
+ required: false
54
+ default: "false"
55
+ description: "Another window changed the value: data-changed-elsewhere on the root, a brief bg-accent-subtle tint, and the line 'Changed in another window, just now'"
56
+ - name: variant
57
+ type: "'property' | 'title'"
58
+ required: false
59
+ default: "'property'"
60
+ description: "property draws the inline input, title the inline-title input"
61
+ - name: invalid
62
+ type: boolean
63
+ required: false
64
+ default: "false"
65
+ description: "Sets aria-invalid and turns the placeholder destructive"
66
+ - name: fit
67
+ type: boolean
68
+ required: false
69
+ default: "false"
70
+ description: "As wide as its text (field-sizing: content, at least 4ch): a title or a name beside another, its status right after the text"
71
+ - name: multiline
72
+ type: boolean
73
+ required: false
74
+ default: "false"
75
+ description: "Draw a textarea instead of an input; then ⌘/Ctrl+Enter commits and Enter inserts a line"
76
+ props_priority:
77
+ - value / onChange
78
+ - onCommit
79
+ - state
80
+ - variant
81
+ examples:
82
+ - title: "A record property, held by the parent"
83
+ code: |
84
+ const [name, setName] = useState(record.name);
85
+
86
+ <EditableField
87
+ aria-label="Last name"
88
+ value={name}
89
+ onChange={setName}
90
+ onCommit={() => save(name)}
91
+ onRevert={() => setName(record.name)}
92
+ />
93
+ - title: "A saving property, with its states"
94
+ code: |
95
+ <EditableField
96
+ aria-label="Status"
97
+ value={draft}
98
+ onChange={setDraft}
99
+ onCommit={commit}
100
+ state={saveState}
101
+ error={saveError}
102
+ onRetry={retry}
103
+ onReset={reset}
104
+ />
105
+ - title: "A multiline title"
106
+ code: |
107
+ <EditableField
108
+ aria-label="Notes"
109
+ value={notes}
110
+ onChange={setNotes}
111
+ multiline
112
+ variant="title"
113
+ placeholder="Add notes…"
114
+ />
115
+ anti_patterns:
116
+ - "Don't hold the draft here — EditableField owns no data; bind it through RecordField or the parent"
117
+ - "Don't expect a save button — the edit commits on blur, Enter or ⌘/Ctrl+Enter"
118
+ - "Don't use the buttons as the only focusable controls — the field itself is the control"
119
+ accessibility_notes: "The input (or textarea) is the control, labelled with aria-label or a surrounding FieldLabel. The saving and saved marks are role=status with aria-label Saving/Saved; the action buttons carry aria-label Retry, Discard my change, Keep mine and Take theirs, with the kit Tooltip as their description. Escape reverts; Enter commits."
120
+ notes: "Purely presentational: it draws the input, the commit keys and the status area, and reports every change and commit upward. @bridge/records' RecordField binds it to data (the draft, the save, the conflict) — use that on a record."