@erxes/ui 4.0.0-v2.2 → 4.0.0-v2.20

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 (364) hide show
  1. package/AGENTS.md +63 -0
  2. package/CATALOG.md +276 -0
  3. package/README.md +20 -0
  4. package/dist/components/accordion.d.ts +1 -0
  5. package/dist/components/accordion.js +1 -0
  6. package/dist/components/alert-dialog.d.ts +4 -0
  7. package/dist/components/alert-dialog.js +4 -0
  8. package/dist/components/alert.d.ts +1 -0
  9. package/dist/components/alert.js +1 -0
  10. package/dist/components/avatar.d.ts +2 -0
  11. package/dist/components/avatar.js +1 -0
  12. package/dist/components/background-gradient-animation.d.ts +4 -1
  13. package/dist/components/background-gradient-animation.js +4 -1
  14. package/dist/components/badge.d.ts +3 -0
  15. package/dist/components/badge.js +2 -0
  16. package/dist/components/breadcrumb.d.ts +1 -0
  17. package/dist/components/breadcrumb.js +1 -0
  18. package/dist/components/button.d.ts +6 -1
  19. package/dist/components/button.js +5 -1
  20. package/dist/components/calendar.d.ts +5 -0
  21. package/dist/components/calendar.js +4 -0
  22. package/dist/components/card.d.ts +1 -0
  23. package/dist/components/card.js +1 -0
  24. package/dist/components/chart-config.d.ts +4 -1
  25. package/dist/components/charts.d.ts +8 -1
  26. package/dist/components/charts.js +16 -6
  27. package/dist/components/checkbox.d.ts +1 -0
  28. package/dist/components/checkbox.js +1 -0
  29. package/dist/components/choicebox-group.d.ts +1 -0
  30. package/dist/components/choicebox-group.js +1 -0
  31. package/dist/components/collapsible.d.ts +1 -0
  32. package/dist/components/collapsible.js +1 -0
  33. package/dist/components/color-picker.d.ts +1 -0
  34. package/dist/components/color-picker.js +15 -8
  35. package/dist/components/combobox.d.ts +6 -1
  36. package/dist/components/combobox.js +13 -2
  37. package/dist/components/command-bar.d.ts +4 -0
  38. package/dist/components/command-bar.js +7 -0
  39. package/dist/components/command.d.ts +4 -0
  40. package/dist/components/command.js +4 -0
  41. package/dist/components/context-menu.d.ts +1 -0
  42. package/dist/components/context-menu.js +1 -0
  43. package/dist/components/copy-text.d.ts +1 -0
  44. package/dist/components/copy-text.js +1 -0
  45. package/dist/components/date-picker-value.d.ts +5 -9
  46. package/dist/components/date-picker-value.js +15 -34
  47. package/dist/components/date-picker.d.ts +4 -4
  48. package/dist/components/date-picker.js +9 -7
  49. package/dist/components/date-text-input.d.ts +2 -4
  50. package/dist/components/date-text-input.js +11 -9
  51. package/dist/components/dialog.d.ts +9 -2
  52. package/dist/components/dialog.js +24 -11
  53. package/dist/components/drag-handle.d.ts +1 -0
  54. package/dist/components/drag-handle.js +1 -0
  55. package/dist/components/dropdown-menu.d.ts +1 -0
  56. package/dist/components/dropdown-menu.js +1 -0
  57. package/dist/components/empty.d.ts +6 -1
  58. package/dist/components/empty.js +25 -2
  59. package/dist/components/field-control.d.ts +16 -0
  60. package/dist/components/field-control.js +19 -0
  61. package/dist/components/form-layout.d.ts +21 -0
  62. package/dist/components/form-layout.js +57 -0
  63. package/dist/components/form.d.ts +14 -3
  64. package/dist/components/form.js +24 -8
  65. package/dist/components/hover-card.d.ts +1 -0
  66. package/dist/components/hover-card.js +1 -0
  67. package/dist/components/icon-tip.d.ts +7 -0
  68. package/dist/components/icon-tip.js +16 -0
  69. package/dist/components/info-card.d.ts +4 -0
  70. package/dist/components/info-card.js +4 -0
  71. package/dist/components/input-group.d.ts +5 -4
  72. package/dist/components/input-group.js +6 -5
  73. package/dist/components/input.d.ts +2 -1
  74. package/dist/components/input.js +10 -4
  75. package/dist/components/kbd.d.ts +2 -1
  76. package/dist/components/kbd.js +2 -1
  77. package/dist/components/label.d.ts +1 -1
  78. package/dist/components/label.js +1 -1
  79. package/dist/components/multiselect.d.ts +1 -0
  80. package/dist/components/multiselect.js +7 -3
  81. package/dist/components/on-demand.d.ts +15 -2
  82. package/dist/components/on-demand.js +21 -1
  83. package/dist/components/popover.d.ts +4 -0
  84. package/dist/components/popover.js +21 -13
  85. package/dist/components/radio-group.d.ts +1 -0
  86. package/dist/components/radio-group.js +1 -0
  87. package/dist/components/scroll-area.d.ts +1 -0
  88. package/dist/components/scroll-area.js +1 -0
  89. package/dist/components/select.d.ts +5 -1
  90. package/dist/components/select.js +21 -10
  91. package/dist/components/separator.d.ts +4 -0
  92. package/dist/components/separator.js +4 -0
  93. package/dist/components/sheet.d.ts +9 -2
  94. package/dist/components/sheet.js +23 -10
  95. package/dist/components/sidebar/panel.js +1 -1
  96. package/dist/components/sidebar.d.ts +1 -0
  97. package/dist/components/sidebar.js +1 -0
  98. package/dist/components/skeleton.d.ts +1 -0
  99. package/dist/components/skeleton.js +1 -0
  100. package/dist/components/spinner.d.ts +1 -0
  101. package/dist/components/spinner.js +1 -0
  102. package/dist/components/string-array.js +1 -0
  103. package/dist/components/switch.d.ts +1 -0
  104. package/dist/components/switch.js +1 -0
  105. package/dist/components/table.d.ts +4 -0
  106. package/dist/components/table.js +4 -0
  107. package/dist/components/tabs.d.ts +8 -1
  108. package/dist/components/tabs.js +8 -1
  109. package/dist/components/text-overflow.d.ts +4 -1
  110. package/dist/components/text-overflow.js +4 -1
  111. package/dist/components/textarea.d.ts +1 -0
  112. package/dist/components/textarea.js +5 -1
  113. package/dist/components/toaster.d.ts +4 -1
  114. package/dist/components/toaster.js +5 -2
  115. package/dist/components/toggle-group.d.ts +5 -0
  116. package/dist/components/toggle-group.js +19 -11
  117. package/dist/components/toggle.d.ts +1 -0
  118. package/dist/components/toggle.js +1 -0
  119. package/dist/components/tooltip.d.ts +4 -0
  120. package/dist/components/tooltip.js +4 -0
  121. package/dist/components/upload.d.ts +4 -0
  122. package/dist/components/upload.js +20 -11
  123. package/dist/federation.d.ts +4 -0
  124. package/dist/federation.js +7 -1
  125. package/dist/hooks/use-focus-first-field.d.ts +8 -0
  126. package/dist/hooks/use-focus-first-field.js +15 -0
  127. package/dist/hooks/use-item-keys.d.ts +11 -0
  128. package/dist/hooks/use-item-keys.js +24 -0
  129. package/dist/hooks/use-page-hotkey.d.ts +14 -0
  130. package/dist/hooks/use-page-hotkey.js +24 -0
  131. package/dist/hooks/use-toast.d.ts +5 -0
  132. package/dist/hooks/use-toast.js +5 -0
  133. package/dist/index.d.ts +34 -7
  134. package/dist/index.js +32 -4
  135. package/dist/lib/format.d.ts +60 -0
  136. package/dist/lib/format.js +86 -0
  137. package/dist/lib/money.d.ts +13 -0
  138. package/dist/lib/money.js +21 -0
  139. package/dist/lib/render-in-dom.d.ts +6 -0
  140. package/dist/lib/render-in-dom.js +26 -0
  141. package/dist/lib/stored.d.ts +13 -0
  142. package/dist/lib/stored.js +41 -0
  143. package/dist/lib/text.d.ts +11 -0
  144. package/dist/lib/text.js +18 -0
  145. package/dist/modules/attachments/use-carousel.js +5 -10
  146. package/dist/modules/blocks/components/BlockEditor.js +2 -2
  147. package/dist/modules/blocks/components/Editor.d.ts +1 -1
  148. package/dist/modules/blocks/components/Editor.js +5 -2
  149. package/dist/modules/blocks/hooks/useBarcodeSizeForm.d.ts +1 -1
  150. package/dist/modules/blocks/hooks/useBlockEditor.d.ts +3 -0
  151. package/dist/modules/blocks/hooks/useBlockEditor.js +21 -2
  152. package/dist/modules/blocks/types/TextEditor.d.ts +3 -1
  153. package/dist/modules/blocks/utils/parseBlocks.d.ts +1 -1
  154. package/dist/modules/blocks/utils/parseBlocks.js +1 -1
  155. package/dist/modules/conditions/ConditionsEditor.d.ts +13 -0
  156. package/dist/modules/conditions/ConditionsEditor.js +171 -0
  157. package/dist/modules/conditions/DateEditors.d.ts +8 -0
  158. package/dist/modules/conditions/DateEditors.js +188 -0
  159. package/dist/modules/conditions/FieldPicker.d.ts +17 -0
  160. package/dist/modules/conditions/FieldPicker.js +99 -0
  161. package/dist/modules/conditions/LazyConditionsEditor.d.ts +10 -0
  162. package/dist/modules/conditions/LazyConditionsEditor.js +11 -0
  163. package/dist/modules/conditions/RuleParts.d.ts +30 -0
  164. package/dist/modules/conditions/RuleParts.js +78 -0
  165. package/dist/modules/conditions/RuleRow.d.ts +27 -0
  166. package/dist/modules/conditions/RuleRow.js +156 -0
  167. package/dist/modules/conditions/TypedInput.d.ts +13 -0
  168. package/dist/modules/conditions/TypedInput.js +36 -0
  169. package/dist/modules/conditions/ValueEditor.d.ts +18 -0
  170. package/dist/modules/conditions/ValueEditor.js +169 -0
  171. package/dist/modules/conditions/conditions.d.ts +77 -0
  172. package/dist/modules/conditions/conditions.js +69 -0
  173. package/dist/modules/conditions/fieldIcons.d.ts +6 -0
  174. package/dist/modules/conditions/fieldIcons.js +21 -0
  175. package/dist/modules/conditions/fieldOptions.d.ts +15 -0
  176. package/dist/modules/conditions/fieldOptions.js +38 -0
  177. package/dist/modules/conditions/filterRule.d.ts +45 -0
  178. package/dist/modules/conditions/filterRule.js +171 -0
  179. package/dist/modules/conditions/filterText.d.ts +16 -0
  180. package/dist/modules/conditions/filterText.js +156 -0
  181. package/dist/modules/display/components/EmailDisplay.d.ts +4 -0
  182. package/dist/modules/display/components/EmailDisplay.js +6 -3
  183. package/dist/modules/display/components/PhoneDisplay.d.ts +4 -0
  184. package/dist/modules/display/components/PhoneDisplay.js +4 -0
  185. package/dist/modules/display/components/RelativeDateDisplay.d.ts +7 -5
  186. package/dist/modules/display/components/RelativeDateDisplay.js +10 -8
  187. package/dist/modules/display/components/SexDisplay.d.ts +1 -0
  188. package/dist/modules/display/components/SexDisplay.js +1 -0
  189. package/dist/modules/filter/components/Filter.d.ts +4 -0
  190. package/dist/modules/filter/components/Filter.js +4 -0
  191. package/dist/modules/filter/components/FilterBar.js +8 -7
  192. package/dist/modules/filter/components/FilterDialog.js +4 -5
  193. package/dist/modules/filter/components/FilterPopover.js +1 -1
  194. package/dist/modules/filter/components/FilterProvider.d.ts +1 -2
  195. package/dist/modules/filter/components/FilterProvider.js +22 -16
  196. package/dist/modules/filter/hooks/useFilterContext.d.ts +1 -0
  197. package/dist/modules/filter/hooks/useFilterContext.js +1 -0
  198. package/dist/modules/filter/types/filter.d.ts +0 -1
  199. package/dist/modules/hotkey/components/PopoverScoped.d.ts +5 -0
  200. package/dist/modules/hotkey/components/PopoverScoped.js +5 -0
  201. package/dist/modules/hotkey/hooks/usePreviousHotkeyScope.d.ts +1 -0
  202. package/dist/modules/hotkey/hooks/usePreviousHotkeyScope.js +1 -0
  203. package/dist/modules/hotkey/hooks/useScopedHotkeys.d.ts +5 -1
  204. package/dist/modules/hotkey/hooks/useScopedHotkeys.js +5 -1
  205. package/dist/modules/icons/components/IconComponent.d.ts +4 -0
  206. package/dist/modules/icons/components/IconComponent.js +4 -0
  207. package/dist/modules/icons/components/IconPicker.d.ts +4 -0
  208. package/dist/modules/icons/components/IconPicker.js +7 -5
  209. package/dist/modules/icons/providers/IconsProvider.d.ts +1 -0
  210. package/dist/modules/icons/providers/IconsProvider.js +1 -0
  211. package/dist/modules/inputs/components/EmailField.d.ts +4 -1
  212. package/dist/modules/inputs/components/EmailField.js +4 -1
  213. package/dist/modules/inputs/components/FullNameField.d.ts +6 -0
  214. package/dist/modules/inputs/components/FullNameField.js +20 -8
  215. package/dist/modules/inputs/components/PhoneField.d.ts +4 -1
  216. package/dist/modules/inputs/components/PhoneField.js +4 -1
  217. package/dist/modules/inputs/components/SexField.d.ts +1 -0
  218. package/dist/modules/inputs/components/SexField.js +1 -0
  219. package/dist/modules/layout/components/AppLayout.d.ts +6 -6
  220. package/dist/modules/layout/components/AppLayout.js +12 -13
  221. package/dist/modules/layout/components/AppLayoutResizeHandle.d.ts +5 -12
  222. package/dist/modules/layout/components/AppLayoutResizeHandle.js +15 -18
  223. package/dist/modules/layout/components/Page.d.ts +5 -0
  224. package/dist/modules/layout/components/Page.js +5 -0
  225. package/dist/modules/layout/components/PageHeader.d.ts +4 -1
  226. package/dist/modules/layout/components/PageHeader.js +4 -1
  227. package/dist/modules/list/DisplayMenu.d.ts +37 -0
  228. package/dist/modules/list/DisplayMenu.js +92 -0
  229. package/dist/modules/list/ListFilter.d.ts +83 -0
  230. package/dist/modules/list/ListFilter.js +83 -0
  231. package/dist/modules/list/ViewBar.d.ts +47 -0
  232. package/dist/modules/list/ViewBar.js +65 -0
  233. package/dist/modules/list/filter/AddFilter.d.ts +10 -0
  234. package/dist/modules/list/filter/AddFilter.js +140 -0
  235. package/dist/modules/list/filter/AdvancedPopover.d.ts +8 -0
  236. package/dist/modules/list/filter/AdvancedPopover.js +103 -0
  237. package/dist/modules/list/filter/ListFilterBar.d.ts +6 -0
  238. package/dist/modules/list/filter/ListFilterBar.js +157 -0
  239. package/dist/modules/list/filter/RecordCount.d.ts +7 -0
  240. package/dist/modules/list/filter/RecordCount.js +22 -0
  241. package/dist/modules/list/filter/RuleChips.d.ts +12 -0
  242. package/dist/modules/list/filter/RuleChips.js +151 -0
  243. package/dist/modules/list/filter/SearchChip.d.ts +6 -0
  244. package/dist/modules/list/filter/SearchChip.js +69 -0
  245. package/dist/modules/list/filter/filterRules.d.ts +21 -0
  246. package/dist/modules/list/filter/filterRules.js +37 -0
  247. package/dist/modules/list/filter/listFilterContext.d.ts +36 -0
  248. package/dist/modules/list/filter/listFilterContext.js +18 -0
  249. package/dist/modules/list/filter/listFilterQuery.d.ts +20 -0
  250. package/dist/modules/list/filter/listFilterQuery.js +30 -0
  251. package/dist/modules/navigation-menu/components/NavigationMenu.d.ts +4 -3
  252. package/dist/modules/navigation-menu/components/NavigationMenu.js +7 -7
  253. package/dist/modules/pickers/EntityPicker.d.ts +7 -0
  254. package/dist/modules/pickers/EntityPicker.js +7 -0
  255. package/dist/modules/pickers/LookupPicker.d.ts +57 -0
  256. package/dist/modules/pickers/LookupPicker.js +115 -0
  257. package/dist/modules/pickers/SelectMember.d.ts +17 -2
  258. package/dist/modules/pickers/SelectMember.js +58 -4
  259. package/dist/modules/pickers/members.d.ts +3 -2
  260. package/dist/modules/pickers/members.js +1 -1
  261. package/dist/modules/record-field/components/NumberField.d.ts +5 -0
  262. package/dist/modules/record-field/components/NumberField.js +14 -7
  263. package/dist/modules/record-field/components/TextField.d.ts +4 -0
  264. package/dist/modules/record-field/components/TextField.js +10 -2
  265. package/dist/modules/record-field/meta-inputs/components/PhoneInput.d.ts +5 -0
  266. package/dist/modules/record-field/meta-inputs/components/PhoneInput.js +5 -0
  267. package/dist/modules/record-list/RecordList.d.ts +19 -0
  268. package/dist/modules/record-list/RecordList.js +24 -0
  269. package/dist/modules/record-list/RecordListProvider.d.ts +30 -0
  270. package/dist/modules/record-list/RecordListProvider.js +57 -0
  271. package/dist/modules/record-list/RecordListRoot.d.ts +30 -0
  272. package/dist/modules/record-list/RecordListRoot.js +140 -0
  273. package/dist/modules/record-list/selection.d.ts +22 -0
  274. package/dist/modules/record-list/selection.js +54 -0
  275. package/dist/modules/record-panel/PanelDescriptionEditor.d.ts +9 -0
  276. package/dist/modules/record-panel/PanelDescriptionEditor.js +39 -0
  277. package/dist/modules/record-panel/PanelDescriptionField.d.ts +13 -0
  278. package/dist/modules/record-panel/PanelDescriptionField.js +39 -0
  279. package/dist/modules/record-panel/PanelField.d.ts +17 -0
  280. package/dist/modules/record-panel/PanelField.js +47 -0
  281. package/dist/modules/record-panel/PanelForm.d.ts +30 -0
  282. package/dist/modules/record-panel/PanelForm.js +154 -0
  283. package/dist/modules/record-panel/PanelLabel.d.ts +10 -0
  284. package/dist/modules/record-panel/PanelLabel.js +55 -0
  285. package/dist/modules/record-panel/PanelSection.d.ts +12 -0
  286. package/dist/modules/record-panel/PanelSection.js +24 -0
  287. package/dist/modules/record-panel/panelExpansion.d.ts +10 -0
  288. package/dist/modules/record-panel/panelExpansion.js +7 -0
  289. package/dist/modules/record-panel/useSaveOnLeave.d.ts +14 -0
  290. package/dist/modules/record-panel/useSaveOnLeave.js +42 -0
  291. package/dist/modules/record-table/components/RecordTable.d.ts +6 -0
  292. package/dist/modules/record-table/components/RecordTable.js +6 -0
  293. package/dist/modules/record-table/components/RecordTableCell.d.ts +9 -0
  294. package/dist/modules/record-table/components/RecordTableCell.js +16 -2
  295. package/dist/modules/record-table/components/RecordTableCellInline.d.ts +5 -0
  296. package/dist/modules/record-table/components/RecordTableCellInline.js +8 -7
  297. package/dist/modules/record-table/components/RecordTableCursor.js +30 -28
  298. package/dist/modules/record-table/components/RecordTableHead.d.ts +7 -2
  299. package/dist/modules/record-table/components/RecordTableHead.js +73 -6
  300. package/dist/modules/record-table/components/RecordTableProvider.d.ts +22 -1
  301. package/dist/modules/record-table/components/RecordTableProvider.js +24 -8
  302. package/dist/modules/record-table/hooks/useTablePreferences.d.ts +1 -1
  303. package/dist/modules/record-table/hooks/useTablePreferences.js +18 -31
  304. package/dist/modules/record-table/states/RecordTableCursorState.d.ts +21 -1
  305. package/dist/modules/record-table/states/RecordTableCursorState.js +21 -3
  306. package/dist/modules/record-table/types/RecordTableCursorTypes.d.ts +1 -0
  307. package/dist/modules/record-table/types/RecordTableCursorTypes.js +1 -0
  308. package/dist/modules/records/ContactLink.d.ts +13 -0
  309. package/dist/modules/records/ContactLink.js +49 -0
  310. package/dist/modules/records/ContactPicker.d.ts +36 -0
  311. package/dist/modules/records/ContactPicker.js +173 -0
  312. package/dist/modules/records/MemberLink.d.ts +12 -0
  313. package/dist/modules/records/MemberLink.js +25 -0
  314. package/dist/modules/records/RecordChip.d.ts +13 -0
  315. package/dist/modules/records/RecordChip.js +46 -0
  316. package/dist/modules/records/contacts.d.ts +53 -0
  317. package/dist/modules/records/contacts.js +10 -0
  318. package/dist/modules/records/openRecord.d.ts +94 -0
  319. package/dist/modules/records/openRecord.js +72 -0
  320. package/dist/node_modules/.pnpm/vitest@5.1.0_@opentelemetry_api@1.10.0_@types_node@26.6.6_@vitest_browser-preview@5.1.0_d78d0f63d2a6b1c4a51a56547b330411/node_modules/vitest/dist/chunks/display.BlTmubjj.js +181 -0
  321. package/dist/node_modules/.pnpm/vitest@5.1.0_@opentelemetry_api@1.10.0_@types_node@26.6.6_@vitest_browser-preview@5.1.0_d78d0f63d2a6b1c4a51a56547b330411/node_modules/vitest/dist/chunks/index.D0heQG4v.js +987 -0
  322. package/dist/node_modules/.pnpm/vitest@5.1.0_@opentelemetry_api@1.10.0_@types_node@26.6.6_@vitest_browser-preview@5.1.0_d78d0f63d2a6b1c4a51a56547b330411/node_modules/vitest/dist/chunks/pathe.M-eThtNZ.zq3TM4NT.js +176 -0
  323. package/dist/node_modules/.pnpm/vitest@5.1.0_@opentelemetry_api@1.10.0_@types_node@26.6.6_@vitest_browser-preview@5.1.0_d78d0f63d2a6b1c4a51a56547b330411/node_modules/vitest/dist/chunks/run.CjdgFZiW.js +1509 -0
  324. package/dist/node_modules/.pnpm/vitest@5.1.0_@opentelemetry_api@1.10.0_@types_node@26.6.6_@vitest_browser-preview@5.1.0_d78d0f63d2a6b1c4a51a56547b330411/node_modules/vitest/dist/chunks/source-map.DakdQc29.js +687 -0
  325. package/dist/node_modules/.pnpm/vitest@5.1.0_@opentelemetry_api@1.10.0_@types_node@26.6.6_@vitest_browser-preview@5.1.0_d78d0f63d2a6b1c4a51a56547b330411/node_modules/vitest/dist/chunks/tinyrainbow.Do8I1XRG.js +85 -0
  326. package/dist/node_modules/.pnpm/vitest@5.1.0_@opentelemetry_api@1.10.0_@types_node@26.6.6_@vitest_browser-preview@5.1.0_d78d0f63d2a6b1c4a51a56547b330411/node_modules/vitest/dist/task-utils.js +6 -0
  327. package/dist/state/sidebarPanelState.js +7 -2
  328. package/dist/state/themeState.d.ts +13 -2
  329. package/dist/state/themeState.js +18 -4
  330. package/dist/theme.css +3 -0
  331. package/dist/types/SexCode.d.ts +1 -0
  332. package/dist/types/SexCode.js +1 -0
  333. package/dist/types/UIConfig.d.ts +182 -86
  334. package/dist/types/UIConfig.js +14 -0
  335. package/dist/utils/IsUndefinedOrNull.d.ts +1 -0
  336. package/dist/utils/IsUndefinedOrNull.js +1 -0
  337. package/dist/utils/file-storage.d.ts +1 -0
  338. package/dist/utils/file-storage.js +1 -0
  339. package/dist/utils/format/formatPhoneNumber.d.ts +4 -0
  340. package/dist/utils/format/formatPhoneNumber.js +4 -0
  341. package/dist/utils/getPluginAssetsUrl.d.ts +5 -0
  342. package/dist/utils/getPluginAssetsUrl.js +5 -0
  343. package/dist/utils/host-component.d.ts +10 -0
  344. package/dist/utils/host-component.js +34 -0
  345. package/dist/utils/json.d.ts +3 -2
  346. package/dist/utils/json.js +3 -2
  347. package/dist/utils/plugin-runtime.d.ts +21 -17
  348. package/dist/utils/plugin-runtime.js +59 -12
  349. package/dist/utils/plugin-styles.d.ts +10 -3
  350. package/dist/utils/plugin-styles.js +44 -12
  351. package/dist/utils/record-timeline.d.ts +10 -9
  352. package/dist/utils/record-timeline.js +12 -17
  353. package/exports.txt +249 -0
  354. package/package.json +14 -3
  355. package/dist/constants/IntlLanguages.d.ts +0 -74
  356. package/dist/constants/IntlLanguages.js +0 -76
  357. package/dist/hooks/use-query-state.d.ts +0 -16
  358. package/dist/hooks/use-query-state.js +0 -122
  359. package/dist/modules/filter/hooks/useFilterQueryState.d.ts +0 -4
  360. package/dist/modules/filter/hooks/useFilterQueryState.js +0 -14
  361. package/dist/types/Theme.d.ts +0 -1
  362. package/dist/types/Theme.js +0 -0
  363. package/dist/utils/localization/formatDateISOStringToRelativeDate.d.ts +0 -2
  364. package/dist/utils/localization/formatDateISOStringToRelativeDate.js +0 -16
@@ -24,7 +24,10 @@ declare const tabButtonVariants: (props?: ({
24
24
  dragging?: boolean | null | undefined;
25
25
  split?: boolean | null | undefined;
26
26
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
27
- /** A tab-like button outside a tab list; `render` swaps the element, as menu triggers do. */
27
+ /**
28
+ * A tab-looking button for a strip that isn't a `Tabs` list.
29
+ * `render` swaps the element, as menu triggers do.
30
+ */
28
31
  export declare const TabButton: ({ render, variant, active, dragging, split, className, ...props }: useRender.ComponentProps<'button'> & VariantProps<typeof tabButtonVariants>) => React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
29
32
  /** Typed over the tab values, so a change handler gets the caller's value type back. */
30
33
  declare const TabsRoot: <Value extends string>(props: Omit<Tabs$1.Root.Props, 'value' | 'defaultValue' | 'onValueChange'> & {
@@ -37,6 +40,10 @@ declare const TabsList: ({ className, variant, activateOnFocus, ...props }: Tabs
37
40
  declare const TabsTrigger: ({ className, variant, size, ...props }: Tabs$1.Tab.Props & VariantProps<typeof tabsTriggerVariants>) => React.JSX.Element;
38
41
  /** An inactive panel carries data-hidden; one kept mounted also gets the hidden attribute. */
39
42
  declare const TabsContent: ({ className, variant, fade, ...props }: Tabs$1.Panel.Props & VariantProps<typeof tabsContentVariants>) => React.JSX.Element;
43
+ /**
44
+ * Tabs that switch between panels of one view.
45
+ * Separate lists under one sidebar item are separate routes, not tabs.
46
+ */
40
47
  export declare const Tabs: typeof TabsRoot & {
41
48
  List: typeof TabsList;
42
49
  Trigger: typeof TabsTrigger;
@@ -70,7 +70,10 @@ const tabButtonVariants = cva("flex h-7 shrink-0 items-center gap-1.5 rounded-md
70
70
  }],
71
71
  defaultVariants: { variant: "pill" }
72
72
  });
73
- /** A tab-like button outside a tab list; `render` swaps the element, as menu triggers do. */
73
+ /**
74
+ * A tab-looking button for a strip that isn't a `Tabs` list.
75
+ * `render` swaps the element, as menu triggers do.
76
+ */
74
77
  const TabButton = ({ render, variant, active, dragging, split, className, ...props }) => useRender({
75
78
  defaultTagName: "button",
76
79
  render,
@@ -114,6 +117,10 @@ const TabsContent = ({ className, variant, fade, ...props }) => /* @__PURE__ */
114
117
  }), className),
115
118
  ...props
116
119
  });
120
+ /**
121
+ * Tabs that switch between panels of one view.
122
+ * Separate lists under one sidebar item are separate routes, not tabs.
123
+ */
117
124
  const Tabs = Object.assign(TabsRoot, {
118
125
  List: TabsList,
119
126
  Trigger: TabsTrigger,
@@ -1,5 +1,4 @@
1
1
  import { Input } from "@base-ui/react/input";
2
- /** Shows the full value in a tooltip, only while the text is cut off. */
3
2
  declare const TextOverflowTooltipRoot: ({ value, className }: {
4
3
  value?: string;
5
4
  className?: string;
@@ -9,6 +8,10 @@ declare const TextOverflowTooltipInput: ({ className, ...props }: Omit<Input.Pro
9
8
  className?: string;
10
9
  value?: string;
11
10
  }) => import("react").JSX.Element;
11
+ /**
12
+ * Text cut with an ellipsis that shows the full value in a tooltip.
13
+ * The tooltip opens only while the text is cut off. `.Input` does the same for a text input.
14
+ */
12
15
  export declare const TextOverflowTooltip: typeof TextOverflowTooltipRoot & {
13
16
  Input: typeof TextOverflowTooltipInput;
14
17
  };
@@ -19,7 +19,6 @@ const useOverflowTooltip = () => {
19
19
  onOpenChange
20
20
  };
21
21
  };
22
- /** Shows the full value in a tooltip, only while the text is cut off. */
23
22
  const TextOverflowTooltipRoot = ({ value, className }) => {
24
23
  const { ref, ...tooltip } = useOverflowTooltip();
25
24
  return /* @__PURE__ */ jsxs(Tooltip, {
@@ -49,5 +48,9 @@ const TextOverflowTooltipInput = ({ className, ...props }) => {
49
48
  }), props.value && /* @__PURE__ */ jsx(Tooltip.Content, { children: /* @__PURE__ */ jsx("span", { children: props.value }) })]
50
49
  });
51
50
  };
51
+ /**
52
+ * Text cut with an ellipsis that shows the full value in a tooltip.
53
+ * The tooltip opens only while the text is cut off. `.Input` does the same for a text input.
54
+ */
52
55
  const TextOverflowTooltip = Object.assign(TextOverflowTooltipRoot, { Input: TextOverflowTooltipInput });
53
56
  export { TextOverflowTooltip };
@@ -5,5 +5,6 @@ declare const textareaVariants: (props?: ({
5
5
  text?: "code" | "default" | "otp" | "sm" | "title" | null | undefined;
6
6
  truncate?: boolean | null | undefined;
7
7
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
8
+ /** A themed multi-line text box; `flat` and `ghost` drop the border. */
8
9
  export declare const Textarea: ({ ref, className, variant, text, truncate, ...props }: React.ComponentProps<'textarea'> & VariantProps<typeof textareaVariants>) => React.JSX.Element;
9
10
  export {};
@@ -1,10 +1,11 @@
1
+ import { useFieldControl } from "./field-control.js";
1
2
  import { fieldTextVariants } from "./input.js";
2
3
  import { cn } from "../lib/utils.js";
3
4
  import { jsx } from "react/jsx-runtime";
4
5
  import "react";
5
6
  import { cva } from "class-variance-authority";
6
7
  // src/components/textarea.tsx
7
- const textareaVariants = cva("flex min-h-15 w-full rounded bg-transparent px-3 py-1.5 text-sm shadow-xs transition placeholder:text-accent-foreground focus-visible:outline-hidden focus-visible:shadow-focus disabled:cursor-not-allowed disabled:opacity-50", {
8
+ const textareaVariants = cva("flex min-h-15 w-full rounded bg-transparent px-3 py-1.5 text-sm shadow-xs transition placeholder:text-accent-foreground focus-visible:outline-hidden focus-visible:shadow-focus disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:shadow-destructive aria-invalid:focus-visible:shadow-focus-destructive", {
8
9
  variants: {
9
10
  variant: {
10
11
  default: "",
@@ -19,8 +20,11 @@ const textareaVariants = cva("flex min-h-15 w-full rounded bg-transparent px-3 p
19
20
  text: "default"
20
21
  }
21
22
  });
23
+ /** A themed multi-line text box; `flat` and `ghost` drop the border. */
22
24
  const Textarea = ({ ref, className, variant, text, truncate, ...props }) => {
25
+ const field = useFieldControl();
23
26
  return /* @__PURE__ */ jsx("textarea", {
27
+ ...field,
24
28
  className: cn(textareaVariants({
25
29
  variant,
26
30
  text,
@@ -1,2 +1,5 @@
1
- /** One toast at a time, bottom right on wide screens and top on narrow ones. */
1
+ /**
2
+ * Draws the toasts `toast()` raises; core's web app already mounts it.
3
+ * One toast at a time, bottom right on wide screens and top on narrow ones.
4
+ */
2
5
  export declare function Toaster(): import("react").JSX.Element;
@@ -13,7 +13,7 @@ const ToastList = () => {
13
13
  return toasts.map((item) => /* @__PURE__ */ jsxs(Toast.Root, {
14
14
  toast: item,
15
15
  swipeDirection: "right",
16
- className: "group pointer-events-auto relative flex w-full items-center space-x-2 overflow-hidden rounded-md p-4 pr-6 shadow-lg transition-all bg-background text-foreground translate-x-(--toast-swipe-movement-x) animate-in slide-in-from-top-full sm:slide-in-from-bottom-full data-limited:hidden data-swiping:transition-none data-ending-style:animate-out data-ending-style:fade-out-80 data-ending-style:slide-out-to-right-full",
16
+ className: "group pointer-events-auto relative flex w-full items-center space-x-2 overflow-hidden rounded-md p-4 pr-6 shadow-lg transition-transform bg-background text-foreground translate-x-(--toast-swipe-movement-x) animate-in slide-in-from-top-full sm:slide-in-from-bottom-full data-limited:hidden data-swiping:transition-none data-ending-style:animate-out data-ending-style:fade-out-80 data-ending-style:slide-out-to-right-full",
17
17
  children: [
18
18
  /* @__PURE__ */ jsx("div", {
19
19
  className: "[&>svg]:size-4.5 mt-0.5 flex-none mb-auto",
@@ -32,7 +32,10 @@ const ToastList = () => {
32
32
  ]
33
33
  }, item.id));
34
34
  };
35
- /** One toast at a time, bottom right on wide screens and top on narrow ones. */
35
+ /**
36
+ * Draws the toasts `toast()` raises; core's web app already mounts it.
37
+ * One toast at a time, bottom right on wide screens and top on narrow ones.
38
+ */
36
39
  function Toaster() {
37
40
  return /* @__PURE__ */ jsx(Toast.Provider, {
38
41
  toastManager,
@@ -6,6 +6,11 @@ import { ToggleGroup as ToggleGroup$1 } from "@base-ui/react/toggle-group";
6
6
  /** The value is an array: one item for a single choice, empty when nothing is pressed. */
7
7
  declare const ToggleGroupRoot: <Value extends string>({ className, variant, size, children, ...props }: ToggleGroup$1.Props<Value> & VariantProps<typeof toggleVariants>) => React.JSX.Element;
8
8
  declare const ToggleGroupItem: <Value extends string>({ className, variant, size, ...props }: Toggle.Props<Value> & VariantProps<typeof toggleVariants>) => React.JSX.Element;
9
+ /**
10
+ * A row of toggle buttons where one or several stay pressed.
11
+ * The value is an array: one item for a single choice, empty when nothing is pressed. A list's
12
+ * table or board switch is `DisplayMenu`, not this.
13
+ */
9
14
  export declare const ToggleGroup: typeof ToggleGroupRoot & {
10
15
  Item: typeof ToggleGroupItem;
11
16
  };
@@ -10,17 +10,20 @@ const ToggleGroupContext = React.createContext({
10
10
  variant: "default"
11
11
  });
12
12
  /** The value is an array: one item for a single choice, empty when nothing is pressed. */
13
- const ToggleGroupRoot = ({ className, variant, size, children, ...props }) => /* @__PURE__ */ jsx(ToggleGroup$1, {
14
- className: cn("flex items-center justify-center gap-1 isolate", variant === "outline" && "gap-0 bg-muted rounded", className),
15
- ...props,
16
- children: /* @__PURE__ */ jsx(ToggleGroupContext, {
17
- value: {
18
- variant,
19
- size
20
- },
21
- children
22
- })
23
- });
13
+ const ToggleGroupRoot = ({ className, variant, size, children, ...props }) => {
14
+ const look = React.useMemo(() => ({
15
+ variant,
16
+ size
17
+ }), [variant, size]);
18
+ return /* @__PURE__ */ jsx(ToggleGroup$1, {
19
+ className: cn("flex items-center justify-center gap-1 isolate", variant === "outline" && "gap-0 bg-muted rounded", className),
20
+ ...props,
21
+ children: /* @__PURE__ */ jsx(ToggleGroupContext, {
22
+ value: look,
23
+ children
24
+ })
25
+ });
26
+ };
24
27
  const ToggleGroupItem = ({ className, variant, size, ...props }) => {
25
28
  const context = React.use(ToggleGroupContext);
26
29
  return /* @__PURE__ */ jsx(Toggle, {
@@ -32,5 +35,10 @@ const ToggleGroupItem = ({ className, variant, size, ...props }) => {
32
35
  ...props
33
36
  });
34
37
  };
38
+ /**
39
+ * A row of toggle buttons where one or several stay pressed.
40
+ * The value is an array: one item for a single choice, empty when nothing is pressed. A list's
41
+ * table or board switch is `DisplayMenu`, not this.
42
+ */
35
43
  const ToggleGroup = Object.assign(ToggleGroupRoot, { Item: ToggleGroupItem });
36
44
  export { ToggleGroup };
@@ -4,4 +4,5 @@ export declare const toggleVariants: (props?: ({
4
4
  variant?: "default" | "outline" | null | undefined;
5
5
  size?: "default" | "icon" | "icon-sm" | "lg" | "sm" | null | undefined;
6
6
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
7
+ /** A button that stays pressed or not, such as bold in a toolbar. */
7
8
  export declare const Toggle: <Value extends string>({ className, variant, size, ...props }: Toggle$1.Props<Value> & VariantProps<typeof toggleVariants>) => import("react").JSX.Element;
@@ -22,6 +22,7 @@ const toggleVariants = cva("inline-flex items-center justify-center rounded text
22
22
  size: "default"
23
23
  }
24
24
  });
25
+ /** A button that stays pressed or not, such as bold in a toolbar. */
25
26
  const Toggle = ({ className, variant, size, ...props }) => /* @__PURE__ */ jsx(Toggle$1, {
26
27
  className: cn(toggleVariants({
27
28
  variant,
@@ -2,6 +2,10 @@ import { Tooltip as Tooltip$1 } from "@base-ui/react/tooltip";
2
2
  /** Opens after 700ms and skips the delay for 300ms after one closes, the timings the app had under Radix. */
3
3
  declare const TooltipProvider: ({ delay, timeout, ...props }: Tooltip$1.Provider.Props) => import("react").JSX.Element;
4
4
  declare const TooltipContent: ({ className, side, sideOffset, align, alignOffset, ...props }: Tooltip$1.Popup.Props & Pick<Tooltip$1.Positioner.Props, 'side' | 'sideOffset' | 'align' | 'alignOffset'>) => import("react").JSX.Element;
5
+ /**
6
+ * A short label that shows on hover or focus of its trigger.
7
+ * Wrap it in `Tooltip.Provider`. For an icon button's label, use `IconTip`.
8
+ */
5
9
  export declare const Tooltip: (<Payload>(props: Tooltip$1.Root.Props<Payload>) => React.JSX.Element) & {
6
10
  Provider: typeof TooltipProvider;
7
11
  Trigger: Tooltip$1.Trigger;
@@ -20,6 +20,10 @@ const TooltipContent = ({ className, side = "top", sideOffset = 8, align = "cent
20
20
  ...props
21
21
  })
22
22
  }) });
23
+ /**
24
+ * A short label that shows on hover or focus of its trigger.
25
+ * Wrap it in `Tooltip.Provider`. For an icon button's label, use `IconTip`.
26
+ */
23
27
  const Tooltip = Object.assign(Tooltip$1.Root, {
24
28
  Provider: TooltipProvider,
25
29
  Trigger: Tooltip$1.Trigger,
@@ -32,6 +32,10 @@ declare const UploadButton: ({ ref, children, className, ...props }: ButtonProps
32
32
  declare const RemoveButton: ({ ref, children, className, ...props }: ButtonProps & {
33
33
  children?: ReactNode;
34
34
  } & React.RefAttributes<HTMLButtonElement>) => import("react").JSX.Element;
35
+ /**
36
+ * An image upload: a preview tile, an upload button and a remove button.
37
+ * `Upload.Root` takes the stored `value` and gets the new address, empty after a removal.
38
+ */
35
39
  export declare const Upload: {
36
40
  Root: typeof UploadRoot;
37
41
  Preview: typeof UploadPreview;
@@ -7,7 +7,7 @@ import { cn } from "../lib/utils.js";
7
7
  import { readImage } from "../utils/core.js";
8
8
  import { IconTrash, IconUpload, IconUserCircle } from "@tabler/icons-react";
9
9
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
10
- import { createContext, useContext, useRef, useState } from "react";
10
+ import { createContext, useContext, useMemo, useRef, useState } from "react";
11
11
  import { cva } from "class-variance-authority";
12
12
  import { useTranslation } from "react-i18next";
13
13
  // src/components/upload.tsx
@@ -23,17 +23,22 @@ const UploadRoot = ({ ref, className, value, onChange, multiple, ...rest }) => {
23
23
  const [previewUrl, setPreviewUrl] = useState();
24
24
  const [isImageFocused, setIsImageFocused] = useState(false);
25
25
  const url = previewUrl ?? value;
26
+ const upload = useMemo(() => ({
27
+ url,
28
+ multiple,
29
+ onChange,
30
+ fileInputRef,
31
+ previewRef,
32
+ setPreviewUrl,
33
+ chooseFile: () => fileInputRef.current?.click(),
34
+ setIsImageFocused
35
+ }), [
36
+ url,
37
+ multiple,
38
+ onChange
39
+ ]);
26
40
  return /* @__PURE__ */ jsxs(UploadContext.Provider, {
27
- value: {
28
- url,
29
- multiple,
30
- onChange,
31
- fileInputRef,
32
- previewRef,
33
- setPreviewUrl,
34
- chooseFile: () => fileInputRef.current?.click(),
35
- setIsImageFocused
36
- },
41
+ value: upload,
37
42
  children: [/* @__PURE__ */ jsx(Dialog, {
38
43
  open: isImageFocused,
39
44
  onOpenChange: setIsImageFocused,
@@ -191,6 +196,10 @@ const RemoveButton = ({ ref, children, className, ...props }) => {
191
196
  children: children ?? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(IconTrash, {}), " Remove"] })
192
197
  });
193
198
  };
199
+ /**
200
+ * An image upload: a preview tile, an upload button and a remove button.
201
+ * `Upload.Root` takes the stored `value` and gets the new address, empty after a removal.
202
+ */
194
203
  const Upload = {
195
204
  Root: UploadRoot,
196
205
  Preview: UploadPreview,
@@ -9,5 +9,9 @@
9
9
  * `@tanstack/react-query` because `@orpc/tanstack-query` imports it directly: a
10
10
  * plugin's own copy would hold a different `skipToken`, so `input: skipToken`
11
11
  * (from the host's `@tanstack/react-query`) would run the query, not disable it.
12
+ * `nuqs` is shared so a plugin's URL state reads web's `NuqsAdapter`: a plugin's
13
+ * own copy would find no adapter and throw. `react-hook-form` is shared because
14
+ * erxes-ui's `Form` is its `FormProvider` and `Controller`: a plugin's `useForm`
15
+ * from its own copy would hand them a form another version built.
12
16
  */
13
17
  export declare const SHARED: string[];
@@ -10,6 +10,10 @@
10
10
  * `@tanstack/react-query` because `@orpc/tanstack-query` imports it directly: a
11
11
  * plugin's own copy would hold a different `skipToken`, so `input: skipToken`
12
12
  * (from the host's `@tanstack/react-query`) would run the query, not disable it.
13
+ * `nuqs` is shared so a plugin's URL state reads web's `NuqsAdapter`: a plugin's
14
+ * own copy would find no adapter and throw. `react-hook-form` is shared because
15
+ * erxes-ui's `Form` is its `FormProvider` and `Controller`: a plugin's `useForm`
16
+ * from its own copy would hand them a form another version built.
13
17
  */
14
18
  const SHARED = [
15
19
  "react",
@@ -23,6 +27,8 @@ const SHARED = [
23
27
  "jotai",
24
28
  "react-i18next",
25
29
  "@tanstack/react-query",
26
- "@tanstack/query-core"
30
+ "@tanstack/query-core",
31
+ "nuqs",
32
+ "react-hook-form"
27
33
  ];
28
34
  export { SHARED };
@@ -0,0 +1,8 @@
1
+ import { RefObject } from "react";
2
+ /** The first field to type into under `root`, if it has one. */
3
+ export declare const findFirstField: (root: Element | null | undefined) => HTMLElement | null;
4
+ /**
5
+ * Puts the cursor in the first field under `ref` when the form opens. For a page or panel whose
6
+ * one job is that form; it doesn't scroll the field into view.
7
+ */
8
+ export declare const useFocusFirstField: (ref: RefObject<HTMLElement | null>) => void;
@@ -0,0 +1,15 @@
1
+ import { useEffect } from "react";
2
+ // src/hooks/use-focus-first-field.ts
3
+ const FIRST_FIELD = "input:not([type=hidden],[type=file],[type=checkbox],[type=radio],:disabled), textarea:not(:disabled)";
4
+ /** The first field to type into under `root`, if it has one. */
5
+ const findFirstField = (root) => root?.querySelector(FIRST_FIELD) ?? null;
6
+ /**
7
+ * Puts the cursor in the first field under `ref` when the form opens. For a page or panel whose
8
+ * one job is that form; it doesn't scroll the field into view.
9
+ */
10
+ const useFocusFirstField = (ref) => {
11
+ useEffect(() => {
12
+ findFirstField(ref.current)?.focus({ preventScroll: true });
13
+ }, [ref]);
14
+ };
15
+ export { findFirstField, useFocusFirstField };
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Stable React keys for an editable list whose items have no id.
3
+ * Use it for lists like condition rules or switch cases. Call `added` and `removed` next to the
4
+ * change, so a row keeps its key when an earlier one goes. A list replaced from outside keeps
5
+ * its first keys and gains or drops the rest.
6
+ */
7
+ export declare const useItemKeys: (length: number) => {
8
+ keyAt: (index: number) => string;
9
+ added: () => void;
10
+ removed: (index: number) => void;
11
+ };
@@ -0,0 +1,24 @@
1
+ import { useState } from "react";
2
+ // src/hooks/use-item-keys.ts
3
+ let counter = 0;
4
+ const newKey = () => {
5
+ counter += 1;
6
+ return `item-${counter}`;
7
+ };
8
+ /**
9
+ * Stable React keys for an editable list whose items have no id.
10
+ * Use it for lists like condition rules or switch cases. Call `added` and `removed` next to the
11
+ * change, so a row keeps its key when an earlier one goes. A list replaced from outside keeps
12
+ * its first keys and gains or drops the rest.
13
+ */
14
+ const useItemKeys = (length) => {
15
+ const [keys, setKeys] = useState(() => Array.from({ length }, newKey));
16
+ const synced = keys.length === length ? keys : Array.from({ length }, (_, at) => keys[at] ?? newKey());
17
+ if (synced !== keys) setKeys(synced);
18
+ return {
19
+ keyAt: (index) => synced[index] ?? String(index),
20
+ added: () => setKeys((current) => [...current, newKey()]),
21
+ removed: (index) => setKeys((current) => current.filter((_, at) => at !== index))
22
+ };
23
+ };
24
+ export { useItemKeys };
@@ -0,0 +1,14 @@
1
+ import { Keys } from "react-hotkeys-hook";
2
+ /** Whether a dialog, menu or list is shown, other than one that holds `inside`. */
3
+ export declare const isOverlayShown: (inside?: Element | null) => boolean;
4
+ /**
5
+ * A page shortcut, skipped while typing or while a dialog or menu is open.
6
+ * Examples: `c` adds, `f` filters, `/` focuses the description, `mod+shift+enter` expands the
7
+ * panel.
8
+ * `when` decides per key press whether this hook takes it at all, so another one may.
9
+ * `useKey` matches the character typed instead of the key's position (`/` on any layout).
10
+ */
11
+ export declare const usePageHotkey: (keys: Keys, action: () => void, { when, useKey }?: {
12
+ when?: () => boolean;
13
+ useKey?: boolean;
14
+ }) => import("react").RefCallback<HTMLElement | null>;
@@ -0,0 +1,24 @@
1
+ import { useHotkeys } from "react-hotkeys-hook";
2
+ // src/hooks/use-page-hotkey.ts
3
+ const OVERLAY = "[role=\"dialog\"], [role=\"alertdialog\"], [role=\"menu\"], [role=\"listbox\"]";
4
+ /** Whether a dialog, menu or list is shown, other than one that holds `inside`. */
5
+ const isOverlayShown = (inside) => Array.from(document.querySelectorAll(OVERLAY)).some((overlay) => !(inside && overlay.contains(inside)) && overlay.getClientRects().length > 0);
6
+ /**
7
+ * Keys meant for something else: a repeat, an IME composition, a key a handler already took,
8
+ * one typed into a text box, or any key while an overlay is shown. react-hotkeys-hook already
9
+ * skips inputs, textareas, selects and contenteditable editors.
10
+ */
11
+ const meantElsewhere = (event) => event.repeat || event.isComposing || event.defaultPrevented || event.target instanceof Element && event.target.closest("[role=\"textbox\"]") !== null || isOverlayShown();
12
+ /**
13
+ * A page shortcut, skipped while typing or while a dialog or menu is open.
14
+ * Examples: `c` adds, `f` filters, `/` focuses the description, `mod+shift+enter` expands the
15
+ * panel.
16
+ * `when` decides per key press whether this hook takes it at all, so another one may.
17
+ * `useKey` matches the character typed instead of the key's position (`/` on any layout).
18
+ */
19
+ const usePageHotkey = (keys, action, { when, useKey } = {}) => useHotkeys(keys, action, {
20
+ useKey,
21
+ preventDefault: true,
22
+ ignoreEventWhen: (event) => meantElsewhere(event) || when?.() === false
23
+ });
24
+ export { isOverlayShown, usePageHotkey };
@@ -5,6 +5,10 @@ export type ToastData = {
5
5
  };
6
6
  /** The one queue every toast goes through; the Toaster renders it. */
7
7
  export declare const toastManager: import("@base-ui/react").ToastManager<ToastData>;
8
+ /**
9
+ * Shows a toast: `toast({ title, description, variant: 'success' })`.
10
+ * Works outside React. It returns the toast's `id` and a `dismiss` that closes it.
11
+ */
8
12
  export declare const toast: ({ title, description, variant, action }: {
9
13
  title?: ReactNode;
10
14
  description?: ReactNode;
@@ -14,6 +18,7 @@ export declare const toast: ({ title, description, variant, action }: {
14
18
  id: string;
15
19
  dismiss: () => void;
16
20
  };
21
+ /** `{ toast }` as a hook; calling `toast` directly does the same. */
17
22
  export declare const useToast: () => {
18
23
  toast: typeof toast;
19
24
  };
@@ -2,6 +2,10 @@ import { Toast } from "@base-ui/react/toast";
2
2
  // src/hooks/use-toast.tsx
3
3
  /** The one queue every toast goes through; the Toaster renders it. */
4
4
  const toastManager = Toast.createToastManager();
5
+ /**
6
+ * Shows a toast: `toast({ title, description, variant: 'success' })`.
7
+ * Works outside React. It returns the toast's `id` and a `dismiss` that closes it.
8
+ */
5
9
  const toast = ({ title, description, variant = "default", action }) => {
6
10
  const id = toastManager.add({
7
11
  title,
@@ -14,5 +18,6 @@ const toast = ({ title, description, variant = "default", action }) => {
14
18
  dismiss: () => toastManager.close(id)
15
19
  };
16
20
  };
21
+ /** `{ toast }` as a hook; calling `toast` directly does the same. */
17
22
  const useToast = () => ({ toast });
18
23
  export { toast, toastManager, useToast };
package/dist/index.d.ts CHANGED
@@ -25,8 +25,10 @@ import { Dialog } from "./components/dialog.js";
25
25
  import { DragHandle } from "./components/drag-handle.js";
26
26
  import { DropdownMenu } from "./components/dropdown-menu.js";
27
27
  import { Empty } from "./components/empty.js";
28
+ import { useFieldControl } from "./components/field-control.js";
28
29
  import { Form } from "./components/form.js";
29
30
  import { HoverCard } from "./components/hover-card.js";
31
+ import { IconTip } from "./components/icon-tip.js";
30
32
  import { InfoCard } from "./components/info-card.js";
31
33
  import { Input } from "./components/input.js";
32
34
  import { InputGroup } from "./components/input-group.js";
@@ -55,10 +57,16 @@ import { Toggle } from "./components/toggle.js";
55
57
  import { Tooltip } from "./components/tooltip.js";
56
58
  import { Upload } from "./components/upload.js";
57
59
  import { useConfirm } from "./hooks/use-confirm.js";
58
- import { useMultiQueryState, useQueryState } from "./hooks/use-query-state.js";
60
+ import { useItemKeys } from "./hooks/use-item-keys.js";
61
+ import { usePageHotkey } from "./hooks/use-page-hotkey.js";
62
+ import { useFocusFirstField } from "./hooks/use-focus-first-field.js";
59
63
  import { toast, useToast } from "./hooks/use-toast.js";
60
64
  import { useUpload } from "./hooks/use-upload.js";
61
65
  import { cn } from "./lib/utils.js";
66
+ import { LANGUAGES, formatter, localTimeZone, toIsoDay, useFormat, zoneOffset } from "./lib/format.js";
67
+ import { amountStep, formatMoney, fromAmountInput, toAmountInput, useMoney } from "./lib/money.js";
68
+ import { stored, storedFamily } from "./lib/stored.js";
69
+ import { oneOf, textOf } from "./lib/text.js";
62
70
  import { Editor } from "./modules/blocks/components/LazyEditor.js";
63
71
  import { editorText } from "./modules/blocks/utils/parseBlocks.js";
64
72
  import { EmailDisplay } from "./modules/display/components/EmailDisplay.js";
@@ -67,7 +75,6 @@ import { RelativeDateDisplay } from "./modules/display/components/RelativeDateDi
67
75
  import { SexDisplay } from "./modules/display/components/SexDisplay.js";
68
76
  import { Filter } from "./modules/filter/components/Filter.js";
69
77
  import { useFilterContext } from "./modules/filter/hooks/useFilterContext.js";
70
- import { useFilterQueryState } from "./modules/filter/hooks/useFilterQueryState.js";
71
78
  import { PopoverScoped } from "./modules/hotkey/components/PopoverScoped.js";
72
79
  import { usePreviousHotkeyScope } from "./modules/hotkey/hooks/usePreviousHotkeyScope.js";
73
80
  import { useScopedHotkeys } from "./modules/hotkey/hooks/useScopedHotkeys.js";
@@ -85,17 +92,37 @@ import { NavigationMenuLinkItem } from "./modules/navigation-menu/components/Nav
85
92
  import { EntityPicker } from "./modules/pickers/EntityPicker.js";
86
93
  import { Member, MemberQueries, memberName, useMembersById } from "./modules/pickers/members.js";
87
94
  import { MemberInline, SelectMember } from "./modules/pickers/SelectMember.js";
95
+ import { LookupPicker, Tag, TagsQuery, useMemberOptions, useTagOptions } from "./modules/pickers/LookupPicker.js";
88
96
  import { NumberField } from "./modules/record-field/components/NumberField.js";
89
97
  import { TextField } from "./modules/record-field/components/TextField.js";
90
98
  import { PhoneInput } from "./modules/record-field/meta-inputs/components/PhoneInput.js";
99
+ import { RecordList } from "./modules/record-list/RecordList.js";
100
+ import { RecordListGroup } from "./modules/record-list/RecordListRoot.js";
91
101
  import { RecordTable } from "./modules/record-table/components/RecordTable.js";
92
- import { RecordTableColumnDef } from "./modules/record-table/components/RecordTableProvider.js";
102
+ import { RecordTableColumnDef, TRecordTableSort } from "./modules/record-table/components/RecordTableProvider.js";
93
103
  import { RecordTableInlineCell } from "./modules/record-table/components/RecordTableCellInline.js";
94
104
  import { EnumCursorDirection } from "./modules/record-table/types/RecordTableCursorTypes.js";
95
- import { themeState } from "./state/themeState.js";
105
+ import { DisplayMenu, TListDisplay, TListDisplayOption, useListDisplay } from "./modules/list/DisplayMenu.js";
106
+ import { ListFilter, ListFilterEmpty, TListFilterField, TListFilterProps, useListFilterParams } from "./modules/list/ListFilter.js";
107
+ import { listFilterQuery } from "./modules/list/filter/listFilterQuery.js";
108
+ import { TConditionField, TConditionGroup, TConditionLookups, TConditionRule, isRule } from "./modules/conditions/conditions.js";
109
+ import { ConditionsEditor } from "./modules/conditions/LazyConditionsEditor.js";
110
+ import { ListViewsProvider, TListViews, TPluginListType, TViewTabsProps, ViewBar, useListViews } from "./modules/list/ViewBar.js";
111
+ import { PanelDescriptionEditor } from "./modules/record-panel/PanelDescriptionEditor.js";
112
+ import { PanelDescriptionField } from "./modules/record-panel/PanelDescriptionField.js";
113
+ import { PanelField, PanelFieldTrigger } from "./modules/record-panel/PanelField.js";
114
+ import { PanelFormLayout, PanelFormRow } from "./modules/record-panel/PanelForm.js";
115
+ import { PanelLabel } from "./modules/record-panel/PanelLabel.js";
116
+ import { PanelSection } from "./modules/record-panel/PanelSection.js";
117
+ import { PanelExpansionContext, usePanelExpanded } from "./modules/record-panel/panelExpansion.js";
118
+ import { ContactLink } from "./modules/records/ContactLink.js";
119
+ import { ContactRelationInput, SelectContactContent, TContactKind } from "./modules/records/ContactPicker.js";
120
+ import { MEMBER_CONTENT_TYPE, MemberLink } from "./modules/records/MemberLink.js";
121
+ import { CompanyContact, ContactQueries, ContactSearch, ContactSearchQueries, CustomerContact, TContactContentType, companyTitle, customerTitle } from "./modules/records/contacts.js";
122
+ import { RecordOpenerProvider, RecordPage, RecordPageProps, RecordPanelControls, RecordPanelProvider, RecordRef, setRecordPage, useOpenRecord, useRecordPanel } from "./modules/records/openRecord.js";
123
+ import { ThemeOption, themeState } from "./state/themeState.js";
96
124
  import { SexCode } from "./types/SexCode.js";
97
- import { ThemeOption } from "./types/Theme.js";
98
- import { IUIConfig, TActivityRowProps, TDashboardWidgetPreview, TPropertyInputMeta, TPropertyInputProps } from "./types/UIConfig.js";
125
+ import { DASHBOARD_WIDGET_PREVIEWS, IUIConfig, TDashboardWidget, TDashboardWidgetPreview, TPanelRecordType, TPluginSettingsPage, TPropertyValue, TRecordContacts, TRecordDraftProps, TRecordProperties, TRecordSection, TRecordSectionProps, TRecordSlotProps, TRecordTab, TRelationTab, TRelationTabProps } from "./types/UIConfig.js";
99
126
  import { isUndefinedOrNull } from "./utils/IsUndefinedOrNull.js";
100
127
  import { readImage } from "./utils/core.js";
101
128
  import { FileStorageAdapter, setFileStorage } from "./utils/file-storage.js";
@@ -105,4 +132,4 @@ import { jsonOf } from "./utils/json.js";
105
132
  import { PluginLiveMessage, PluginRuntime, PluginSession, getPluginRuntime, pluginFetch, pluginJson, setPluginRuntime, useLiveSignal } from "./utils/plugin-runtime.js";
106
133
  import { addPluginStyles } from "./utils/plugin-styles.js";
107
134
  import { RecordTimeline, RecordTimelineProps, setRecordTimeline } from "./utils/record-timeline.js";
108
- export { Accordion, Alert, AlertDialog, AppLayout, AppLayoutFooterLink, Avatar, type AvatarProps, BackgroundGradientAnimation, Badge, type BadgeProps, Breadcrumb, Button, type ButtonProps, Calendar, type CalendarProps, Card, type ChartConfig, ChartContainer, ChartLegendContent, ChartTooltipContent, Checkbox, ChoiceboxGroup, Collapsible, ColorPicker, Combobox, Command, CommandBar, ContextMenu, CopyText, DateInput, DatePicker, Dialog, DragHandle, DropdownMenu, Editor, EmailDisplay, EmailListField, Empty, EntityPicker, EnumCursorDirection, type FileStorageAdapter, Filter, Form, FullNameField, FullNameValue, HoverCard, type IUIConfig, IconComponent, IconPicker, IconsProvider, InfoCard, Input, InputGroup, Kbd, Label, type Member, MemberInline, type MemberQueries, type MultiSelectOption, MultipleSelector, NavigationMenuLinkItem, NumberField, PageContainer, PageHeader, PageSubHeader, PhoneDisplay, PhoneField, PhoneInput, type PluginLiveMessage, type PluginRuntime, type PluginSession, Popover, PopoverScoped, RadioGroup, RecordTable, type RecordTableColumnDef, RecordTableInlineCell, RecordTimeline, type RecordTimelineProps, RelativeDateDisplay, Resizable, ScrollArea, Select, SelectMember, Separator, SexCode, SexDisplay, SexField, Sheet, Sidebar, Skeleton, Slider, Spinner, StringArrayInput, Switch, type TActivityRowProps, type TDashboardWidgetPreview, type TPropertyInputMeta, type TPropertyInputProps, TabButton, Table, Tabs, TextField, TextOverflowTooltip, Textarea, type ThemeOption, TimeField, Toaster, Toggle, ToggleGroup, Tooltip, Upload, addPluginStyles, badgeVariants, buttonVariants, cn, editorText, formatPhoneNumber, getPluginAssetsUrl, getPluginRuntime, isUndefinedOrNull, jsonOf, memberName, pluginFetch, pluginJson, readImage, setFileStorage, setPluginRuntime, setRecordTimeline, themeState, toast, useConfirm, useFilterContext, useFilterQueryState, useLiveSignal, useMembersById, useMultiQueryState, usePreviousHotkeyScope, useQueryState, useScopedHotkeys, useToast, useUpload };
135
+ export { Accordion, Alert, AlertDialog, AppLayout, AppLayoutFooterLink, Avatar, type AvatarProps, BackgroundGradientAnimation, Badge, type BadgeProps, Breadcrumb, Button, type ButtonProps, Calendar, type CalendarProps, Card, type ChartConfig, ChartContainer, ChartLegendContent, ChartTooltipContent, Checkbox, ChoiceboxGroup, Collapsible, ColorPicker, Combobox, Command, CommandBar, type CompanyContact, ConditionsEditor, ContactLink, type ContactQueries, ContactRelationInput, type ContactSearch, type ContactSearchQueries, ContextMenu, CopyText, type CustomerContact, DASHBOARD_WIDGET_PREVIEWS, DateInput, DatePicker, Dialog, DisplayMenu, DragHandle, DropdownMenu, Editor, EmailDisplay, EmailListField, Empty, EntityPicker, EnumCursorDirection, type FileStorageAdapter, Filter, Form, FullNameField, FullNameValue, HoverCard, type IUIConfig, IconComponent, IconPicker, IconTip, IconsProvider, InfoCard, Input, InputGroup, Kbd, LANGUAGES, Label, ListFilter, ListFilterEmpty, ListViewsProvider, LookupPicker, MEMBER_CONTENT_TYPE, type Member, MemberInline, MemberLink, type MemberQueries, type MultiSelectOption, MultipleSelector, NavigationMenuLinkItem, NumberField, PageContainer, PageHeader, PageSubHeader, PanelDescriptionEditor, PanelDescriptionField, PanelExpansionContext, PanelField, PanelFieldTrigger, PanelFormLayout, PanelFormRow, PanelLabel, PanelSection, PhoneDisplay, PhoneField, PhoneInput, type PluginLiveMessage, type PluginRuntime, type PluginSession, Popover, PopoverScoped, RadioGroup, RecordList, type RecordListGroup, RecordOpenerProvider, RecordPage, type RecordPageProps, type RecordPanelControls, RecordPanelProvider, type RecordRef, RecordTable, type RecordTableColumnDef, RecordTableInlineCell, RecordTimeline, type RecordTimelineProps, RelativeDateDisplay, Resizable, ScrollArea, Select, SelectContactContent, SelectMember, Separator, SexCode, SexDisplay, SexField, Sheet, Sidebar, Skeleton, Slider, Spinner, StringArrayInput, Switch, type TConditionField, type TConditionGroup, type TConditionLookups, type TConditionRule, type TContactContentType, type TContactKind, type TDashboardWidget, type TDashboardWidgetPreview, type TListDisplay, type TListDisplayOption, type TListFilterField, type TListFilterProps, type TListViews, type TPanelRecordType, type TPluginListType, type TPluginSettingsPage, type TPropertyValue, type TRecordContacts, type TRecordDraftProps, type TRecordProperties, type TRecordSection, type TRecordSectionProps, type TRecordSlotProps, type TRecordTab, type TRecordTableSort, type TRelationTab, type TRelationTabProps, type TViewTabsProps, TabButton, Table, Tabs, type Tag, type TagsQuery, TextField, TextOverflowTooltip, Textarea, ThemeOption, TimeField, Toaster, Toggle, ToggleGroup, Tooltip, Upload, ViewBar, addPluginStyles, amountStep, badgeVariants, buttonVariants, cn, companyTitle, customerTitle, editorText, formatMoney, formatPhoneNumber, formatter, fromAmountInput, getPluginAssetsUrl, getPluginRuntime, isRule, isUndefinedOrNull, jsonOf, listFilterQuery, localTimeZone, memberName, oneOf, pluginFetch, pluginJson, readImage, setFileStorage, setPluginRuntime, setRecordPage, setRecordTimeline, stored, storedFamily, textOf, themeState, toAmountInput, toIsoDay, toast, useConfirm, useFieldControl, useFilterContext, useFocusFirstField, useFormat, useItemKeys, useListDisplay, useListFilterParams, useListViews, useLiveSignal, useMemberOptions, useMembersById, useMoney, useOpenRecord, usePageHotkey, usePanelExpanded, usePreviousHotkeyScope, useRecordPanel, useScopedHotkeys, useTagOptions, useToast, useUpload, zoneOffset };