@erxes/ui 4.0.0-v2.0 → 4.0.0-v2.10

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 (476) hide show
  1. package/AGENTS.md +58 -0
  2. package/CATALOG.md +251 -0
  3. package/README.md +31 -8
  4. package/dist/base.css +17 -4
  5. package/dist/components/accordion.d.ts +7 -7
  6. package/dist/components/accordion.js +9 -13
  7. package/dist/components/alert-dialog.d.ts +16 -11
  8. package/dist/components/alert-dialog.js +30 -29
  9. package/dist/components/alert.d.ts +1 -0
  10. package/dist/components/alert.js +3 -2
  11. package/dist/components/avatar.d.ts +9 -5
  12. package/dist/components/avatar.js +31 -19
  13. package/dist/components/background-gradient-animation.d.ts +5 -11
  14. package/dist/components/background-gradient-animation.js +24 -50
  15. package/dist/components/badge.d.ts +6 -2
  16. package/dist/components/badge.js +38 -21
  17. package/dist/components/breadcrumb.d.ts +7 -4
  18. package/dist/components/breadcrumb.js +19 -14
  19. package/dist/components/button.d.ts +20 -7
  20. package/dist/components/button.js +50 -23
  21. package/dist/components/calendar.d.ts +5 -0
  22. package/dist/components/calendar.js +5 -1
  23. package/dist/components/card.d.ts +1 -0
  24. package/dist/components/card.js +2 -1
  25. package/dist/components/chart-config.d.ts +7 -18
  26. package/dist/components/chart-config.js +1 -6
  27. package/dist/components/charts.d.ts +7 -1
  28. package/dist/components/charts.js +31 -30
  29. package/dist/components/checkbox.d.ts +3 -3
  30. package/dist/components/checkbox.js +5 -6
  31. package/dist/components/choicebox-group.d.ts +2 -1
  32. package/dist/components/choicebox-group.js +6 -9
  33. package/dist/components/collapsible.d.ts +6 -9
  34. package/dist/components/collapsible.js +9 -25
  35. package/dist/components/color-picker.d.ts +1 -0
  36. package/dist/components/color-picker.js +21 -13
  37. package/dist/components/combobox.d.ts +11 -6
  38. package/dist/components/combobox.js +27 -18
  39. package/dist/components/command-bar.d.ts +4 -0
  40. package/dist/components/command-bar.js +26 -19
  41. package/dist/components/command.d.ts +22 -8
  42. package/dist/components/command.js +66 -26
  43. package/dist/components/context-menu.d.ts +18 -29
  44. package/dist/components/context-menu.js +21 -66
  45. package/dist/components/copy-text.d.ts +1 -0
  46. package/dist/components/copy-text.js +8 -11
  47. package/dist/components/date-picker-value.d.ts +5 -9
  48. package/dist/components/date-picker-value.js +15 -34
  49. package/dist/components/date-picker.d.ts +4 -4
  50. package/dist/components/date-picker.js +30 -25
  51. package/dist/components/date-text-input.d.ts +2 -4
  52. package/dist/components/date-text-input.js +14 -12
  53. package/dist/components/date-time-input.d.ts +12 -0
  54. package/dist/components/date-time-input.js +21 -0
  55. package/dist/components/dialog.d.ts +21 -12
  56. package/dist/components/dialog.js +40 -32
  57. package/dist/components/drag-handle.d.ts +3 -2
  58. package/dist/components/drag-handle.js +1 -1
  59. package/dist/components/dropdown-menu.d.ts +36 -16
  60. package/dist/components/dropdown-menu.js +79 -37
  61. package/dist/components/empty.d.ts +6 -1
  62. package/dist/components/empty.js +26 -3
  63. package/dist/components/form.d.ts +21 -8
  64. package/dist/components/form.js +42 -19
  65. package/dist/components/hover-card.d.ts +7 -5
  66. package/dist/components/hover-card.js +19 -9
  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 +9 -6
  71. package/dist/components/input-group.d.ts +23 -0
  72. package/dist/components/input-group.js +43 -0
  73. package/dist/components/input.d.ts +12 -2
  74. package/dist/components/input.js +22 -8
  75. package/dist/components/kbd.d.ts +2 -1
  76. package/dist/components/kbd.js +4 -3
  77. package/dist/components/label.d.ts +3 -3
  78. package/dist/components/label.js +9 -6
  79. package/dist/components/multiselect.d.ts +22 -6
  80. package/dist/components/multiselect.js +82 -127
  81. package/dist/components/on-demand.d.ts +23 -0
  82. package/dist/components/on-demand.js +48 -0
  83. package/dist/components/popover.d.ts +22 -9
  84. package/dist/components/popover.js +42 -13
  85. package/dist/components/radio-group.d.ts +6 -5
  86. package/dist/components/radio-group.js +24 -29
  87. package/dist/components/resizable.d.ts +8 -21
  88. package/dist/components/resizable.js +5 -10
  89. package/dist/components/scroll-area.d.ts +13 -7
  90. package/dist/components/scroll-area.js +19 -18
  91. package/dist/components/select.d.ts +26 -14
  92. package/dist/components/select.js +96 -51
  93. package/dist/components/separator.d.ts +7 -3
  94. package/dist/components/separator.js +12 -12
  95. package/dist/components/sheet.d.ts +19 -11
  96. package/dist/components/sheet.js +70 -50
  97. package/dist/components/sidebar/context.js +4 -4
  98. package/dist/components/sidebar/group.d.ts +9 -8
  99. package/dist/components/sidebar/group.js +18 -13
  100. package/dist/components/sidebar/layout.d.ts +7 -2
  101. package/dist/components/sidebar/layout.js +11 -3
  102. package/dist/components/sidebar/menu-sub.d.ts +4 -3
  103. package/dist/components/sidebar/menu-sub.js +13 -13
  104. package/dist/components/sidebar/menu.d.ts +6 -6
  105. package/dist/components/sidebar/menu.js +28 -40
  106. package/dist/components/sidebar/panel.js +38 -21
  107. package/dist/components/sidebar/root.d.ts +1 -2
  108. package/dist/components/sidebar/root.js +7 -8
  109. package/dist/components/sidebar/trigger.js +1 -1
  110. package/dist/components/sidebar-tree-indicator.js +4 -4
  111. package/dist/components/sidebar.d.ts +1 -0
  112. package/dist/components/sidebar.js +1 -0
  113. package/dist/components/skeleton.d.ts +8 -1
  114. package/dist/components/skeleton.js +19 -2
  115. package/dist/components/slider.d.ts +5 -5
  116. package/dist/components/slider.js +20 -11
  117. package/dist/components/spinner.d.ts +3 -2
  118. package/dist/components/spinner.js +25 -188
  119. package/dist/components/string-array.js +3 -2
  120. package/dist/components/switch.d.ts +3 -3
  121. package/dist/components/switch.js +7 -8
  122. package/dist/components/table.d.ts +18 -3
  123. package/dist/components/table.js +37 -9
  124. package/dist/components/tabs.d.ts +41 -8
  125. package/dist/components/tabs.js +103 -23
  126. package/dist/components/text-overflow.d.ts +11 -10
  127. package/dist/components/text-overflow.js +36 -39
  128. package/dist/components/textarea.d.ts +9 -1
  129. package/dist/components/textarea.js +25 -3
  130. package/dist/components/toaster.d.ts +4 -0
  131. package/dist/components/toaster.js +44 -20
  132. package/dist/components/toggle-group.d.ts +10 -3
  133. package/dist/components/toggle-group.js +28 -21
  134. package/dist/components/toggle.d.ts +4 -4
  135. package/dist/components/toggle.js +7 -6
  136. package/dist/components/tooltip.d.ts +11 -6
  137. package/dist/components/tooltip.js +22 -8
  138. package/dist/components/upload.d.ts +11 -2
  139. package/dist/components/upload.js +47 -17
  140. package/dist/components.css +325 -0
  141. package/dist/constants/CountryPhoneCodes.d.ts +1 -1
  142. package/dist/constants/CountryPhoneCodes.js +2 -2
  143. package/dist/federation.d.ts +17 -0
  144. package/dist/federation.js +34 -0
  145. package/dist/fonts.css +1 -1
  146. package/dist/hooks/use-confirm.js +17 -19
  147. package/dist/hooks/use-item-keys.d.ts +11 -0
  148. package/dist/hooks/use-item-keys.js +24 -0
  149. package/dist/hooks/use-page-hotkey.d.ts +12 -0
  150. package/dist/hooks/use-page-hotkey.js +22 -0
  151. package/dist/hooks/use-toast.d.ts +19 -16
  152. package/dist/hooks/use-toast.js +18 -108
  153. package/dist/index.d.ts +41 -13
  154. package/dist/index.js +37 -10
  155. package/dist/lib/cn-tables.d.ts +27 -0
  156. package/dist/lib/cn-tables.js +128 -0
  157. package/dist/lib/format.d.ts +60 -0
  158. package/dist/lib/format.js +86 -0
  159. package/dist/lib/money.d.ts +13 -0
  160. package/dist/lib/money.js +21 -0
  161. package/dist/lib/stored.d.ts +13 -0
  162. package/dist/lib/stored.js +41 -0
  163. package/dist/lib/text.d.ts +11 -0
  164. package/dist/lib/text.js +18 -0
  165. package/dist/lib/utils.d.ts +14 -2
  166. package/dist/lib/utils.js +14 -6
  167. package/dist/modules/attachments/attachment-media.js +56 -56
  168. package/dist/modules/attachments/use-carousel.js +5 -10
  169. package/dist/modules/blocks/components/BarcodeAttribute.js +11 -8
  170. package/dist/modules/blocks/components/BarcodeSizeSettings.js +5 -6
  171. package/dist/modules/blocks/components/BlockEditor.js +14 -4
  172. package/dist/modules/blocks/components/BlockEditorInlineContent.d.ts +26 -36
  173. package/dist/modules/blocks/components/BlockEditorInlineContent.js +2 -2
  174. package/dist/modules/blocks/components/BlockToolbar.d.ts +6 -0
  175. package/dist/modules/blocks/components/BlockToolbar.js +19 -4
  176. package/dist/modules/blocks/components/CustomFileBlock.d.ts +13 -39
  177. package/dist/modules/blocks/components/CustomFileBlock.js +8 -9
  178. package/dist/modules/blocks/components/CustomImageBlock.d.ts +28 -78
  179. package/dist/modules/blocks/components/CustomImageBlock.js +20 -99
  180. package/dist/modules/blocks/components/CustomVideoBlock.d.ts +26 -63
  181. package/dist/modules/blocks/components/CustomVideoBlock.js +10 -8
  182. package/dist/modules/blocks/components/DocumentPlaceholderBlock.d.ts +13 -39
  183. package/dist/modules/blocks/components/DocumentPlaceholderBlock.js +1 -2
  184. package/dist/modules/blocks/components/Editor.d.ts +1 -1
  185. package/dist/modules/blocks/components/Editor.js +5 -4
  186. package/dist/modules/blocks/components/FontFamilyButton.js +25 -21
  187. package/dist/modules/blocks/components/FontSizeButton.js +26 -22
  188. package/dist/modules/blocks/components/GalleryBlock.d.ts +7 -25
  189. package/dist/modules/blocks/components/GalleryBlock.js +2 -35
  190. package/dist/modules/blocks/components/GalleryBlockContent.js +8 -3
  191. package/dist/modules/blocks/components/GalleryBlockParts.js +23 -21
  192. package/dist/modules/blocks/components/GalleryExternalHtml.d.ts +2 -0
  193. package/dist/modules/blocks/components/GalleryExternalHtml.js +36 -0
  194. package/dist/modules/blocks/components/ImageExternalHtml.d.ts +2 -0
  195. package/dist/modules/blocks/components/ImageExternalHtml.js +51 -0
  196. package/dist/modules/blocks/components/ImageStyleButton.js +22 -18
  197. package/dist/modules/blocks/components/LazyEditor.d.ts +9 -0
  198. package/dist/modules/blocks/components/LazyEditor.js +14 -0
  199. package/dist/modules/blocks/components/MediaBlockWrapper.d.ts +24 -0
  200. package/dist/modules/blocks/components/MediaBlockWrapper.js +98 -0
  201. package/dist/modules/blocks/components/SlashMenu.js +2 -2
  202. package/dist/modules/blocks/components/SuggestionMenu.js +5 -6
  203. package/dist/modules/blocks/components/TableColorPicker.d.ts +1 -1
  204. package/dist/modules/blocks/components/TableColorPicker.js +20 -27
  205. package/dist/modules/blocks/components/TableHandleWithRemove.js +34 -50
  206. package/dist/modules/blocks/components/toolbar/buttons/ToolbarButton.d.ts +2 -2
  207. package/dist/modules/blocks/components/toolbar/buttons/ToolbarButton.js +3 -4
  208. package/dist/modules/blocks/components/toolbar/buttons/ToolbarToggle.d.ts +2 -2
  209. package/dist/modules/blocks/components/toolbar/buttons/ToolbarToggle.js +3 -4
  210. package/dist/modules/blocks/components/toolbar/menus/MenuCheckboxItem.d.ts +3 -0
  211. package/dist/modules/blocks/components/toolbar/menus/MenuCheckboxItem.js +8 -0
  212. package/dist/modules/blocks/components/toolbar/menus/ToolbarMenuDropdown.js +1 -1
  213. package/dist/modules/blocks/components/toolbar/menus/ToolbarMenuItem.d.ts +2 -2
  214. package/dist/modules/blocks/components/toolbar/menus/ToolbarMenuItem.js +5 -16
  215. package/dist/modules/blocks/components/toolbar/menus/ToolbarSelect.d.ts +1 -1
  216. package/dist/modules/blocks/components/toolbar/menus/ToolbarSelect.js +24 -20
  217. package/dist/modules/blocks/constant/blockEditorSchema.d.ts +268 -653
  218. package/dist/modules/blocks/constant/blockEditorSchema.js +33 -41
  219. package/dist/modules/blocks/constant/galleryBlockConfig.d.ts +1 -2
  220. package/dist/modules/blocks/constant/imageBlockConfig.d.ts +46 -0
  221. package/dist/modules/blocks/constant/imageBlockConfig.js +39 -0
  222. package/dist/modules/blocks/constant/toolbar/editorUIComponents.d.ts +2 -3
  223. package/dist/modules/blocks/constant/toolbar/editorUIComponents.js +7 -9
  224. package/dist/modules/blocks/hooks/toolbar/useCodeActive.js +5 -7
  225. package/dist/modules/blocks/hooks/toolbar/useStringStyle.d.ts +9 -0
  226. package/dist/modules/blocks/hooks/toolbar/useStringStyle.js +27 -0
  227. package/dist/modules/blocks/hooks/useBarcodeSizeForm.d.ts +1 -1
  228. package/dist/modules/blocks/hooks/useBlockEditor.d.ts +2 -0
  229. package/dist/modules/blocks/hooks/useBlockEditor.js +9 -3
  230. package/dist/modules/blocks/hooks/useEditorValue.d.ts +2 -1
  231. package/dist/modules/blocks/hooks/useEditorValue.js +8 -19
  232. package/dist/modules/blocks/types/TextEditor.d.ts +3 -1
  233. package/dist/modules/blocks/types/toolbar/ImageStyleOption.d.ts +1 -1
  234. package/dist/modules/blocks/utils/getSlashMenuItems.js +0 -15
  235. package/dist/modules/blocks/utils/parseBlocks.d.ts +3 -1
  236. package/dist/modules/blocks/utils/parseBlocks.js +14 -1
  237. package/dist/modules/conditions/ConditionValueInput.d.ts +10 -0
  238. package/dist/modules/conditions/ConditionValueInput.js +166 -0
  239. package/dist/modules/conditions/ConditionsEditor.d.ts +11 -0
  240. package/dist/modules/conditions/ConditionsEditor.js +209 -0
  241. package/dist/modules/conditions/LazyConditionsEditor.d.ts +10 -0
  242. package/dist/modules/conditions/LazyConditionsEditor.js +11 -0
  243. package/dist/modules/conditions/PathPicker.d.ts +8 -0
  244. package/dist/modules/conditions/PathPicker.js +51 -0
  245. package/dist/modules/conditions/conditions.d.ts +66 -0
  246. package/dist/modules/conditions/conditions.js +136 -0
  247. package/dist/modules/display/components/EmailDisplay.d.ts +4 -0
  248. package/dist/modules/display/components/EmailDisplay.js +29 -27
  249. package/dist/modules/display/components/PhoneDisplay.d.ts +4 -0
  250. package/dist/modules/display/components/PhoneDisplay.js +6 -2
  251. package/dist/modules/display/components/RelativeDateDisplay.d.ts +8 -6
  252. package/dist/modules/display/components/RelativeDateDisplay.js +16 -17
  253. package/dist/modules/display/components/SexDisplay.d.ts +1 -0
  254. package/dist/modules/display/components/SexDisplay.js +1 -0
  255. package/dist/modules/filter/components/Filter.d.ts +4 -0
  256. package/dist/modules/filter/components/Filter.js +4 -0
  257. package/dist/modules/filter/components/FilterBar.js +11 -13
  258. package/dist/modules/filter/components/FilterDialog.js +17 -25
  259. package/dist/modules/filter/components/FilterPopover.js +21 -29
  260. package/dist/modules/filter/components/FilterProvider.d.ts +1 -2
  261. package/dist/modules/filter/components/FilterProvider.js +22 -16
  262. package/dist/modules/filter/hooks/useFilterContext.d.ts +1 -0
  263. package/dist/modules/filter/hooks/useFilterContext.js +1 -0
  264. package/dist/modules/filter/types/filter.d.ts +0 -1
  265. package/dist/modules/hotkey/components/PopoverScoped.d.ts +10 -4
  266. package/dist/modules/hotkey/components/PopoverScoped.js +10 -5
  267. package/dist/modules/hotkey/hooks/usePreviousHotkeyScope.d.ts +1 -0
  268. package/dist/modules/hotkey/hooks/usePreviousHotkeyScope.js +1 -0
  269. package/dist/modules/hotkey/hooks/useScopedHotkeys.d.ts +7 -3
  270. package/dist/modules/hotkey/hooks/useScopedHotkeys.js +19 -24
  271. package/dist/modules/icons/components/IconComponent.d.ts +5 -1
  272. package/dist/modules/icons/components/IconComponent.js +4 -0
  273. package/dist/modules/icons/components/IconPicker.d.ts +4 -0
  274. package/dist/modules/icons/components/IconPicker.js +20 -17
  275. package/dist/modules/icons/providers/IconsProvider.d.ts +1 -0
  276. package/dist/modules/icons/providers/IconsProvider.js +1 -0
  277. package/dist/modules/inputs/components/ContactFieldParts.js +13 -14
  278. package/dist/modules/inputs/components/EmailField.d.ts +4 -1
  279. package/dist/modules/inputs/components/EmailField.js +4 -1
  280. package/dist/modules/inputs/components/EmailFieldForm.js +2 -3
  281. package/dist/modules/inputs/components/FullNameField.d.ts +6 -0
  282. package/dist/modules/inputs/components/FullNameField.js +25 -11
  283. package/dist/modules/inputs/components/PhoneField.d.ts +4 -1
  284. package/dist/modules/inputs/components/PhoneField.js +4 -1
  285. package/dist/modules/inputs/components/PhoneFieldForm.js +2 -1
  286. package/dist/modules/inputs/components/SexField.d.ts +1 -0
  287. package/dist/modules/inputs/components/SexField.js +1 -0
  288. package/dist/modules/layout/components/AppLayout.d.ts +6 -6
  289. package/dist/modules/layout/components/AppLayout.js +29 -32
  290. package/dist/modules/layout/components/AppLayoutPageSlot.js +1 -1
  291. package/dist/modules/layout/components/AppLayoutResizeHandle.d.ts +5 -12
  292. package/dist/modules/layout/components/AppLayoutResizeHandle.js +16 -19
  293. package/dist/modules/layout/components/Page.d.ts +11 -1
  294. package/dist/modules/layout/components/Page.js +16 -3
  295. package/dist/modules/layout/components/PageHeader.d.ts +14 -4
  296. package/dist/modules/layout/components/PageHeader.js +27 -6
  297. package/dist/modules/list/DisplayMenu.d.ts +24 -0
  298. package/dist/modules/list/DisplayMenu.js +87 -0
  299. package/dist/modules/list/ListFilter.d.ts +63 -0
  300. package/dist/modules/list/ListFilter.js +44 -0
  301. package/dist/modules/list/ViewBar.d.ts +13 -0
  302. package/dist/modules/list/ViewBar.js +30 -0
  303. package/dist/modules/list/filter/AdvancedFilterDialog.d.ts +5 -0
  304. package/dist/modules/list/filter/AdvancedFilterDialog.js +52 -0
  305. package/dist/modules/list/filter/FieldMenus.d.ts +5 -0
  306. package/dist/modules/list/filter/FieldMenus.js +184 -0
  307. package/dist/modules/list/filter/ListFilterBar.d.ts +6 -0
  308. package/dist/modules/list/filter/ListFilterBar.js +246 -0
  309. package/dist/modules/list/filter/RecordCount.d.ts +7 -0
  310. package/dist/modules/list/filter/RecordCount.js +22 -0
  311. package/dist/modules/list/filter/RuleChips.d.ts +2 -0
  312. package/dist/modules/list/filter/RuleChips.js +157 -0
  313. package/dist/modules/list/filter/fieldIcons.d.ts +7 -0
  314. package/dist/modules/list/filter/fieldIcons.js +16 -0
  315. package/dist/modules/list/filter/filterRules.d.ts +46 -0
  316. package/dist/modules/list/filter/filterRules.js +166 -0
  317. package/dist/modules/list/filter/listFilterContext.d.ts +29 -0
  318. package/dist/modules/list/filter/listFilterContext.js +34 -0
  319. package/dist/modules/list/filter/listFilterQuery.d.ts +16 -0
  320. package/dist/modules/list/filter/listFilterQuery.js +22 -0
  321. package/dist/modules/navigation-menu/components/NavigationMenu.d.ts +4 -3
  322. package/dist/modules/navigation-menu/components/NavigationMenu.js +18 -21
  323. package/dist/modules/pickers/EntityPicker.d.ts +37 -0
  324. package/dist/modules/pickers/EntityPicker.js +67 -0
  325. package/dist/modules/pickers/LookupPicker.d.ts +51 -0
  326. package/dist/modules/pickers/LookupPicker.js +84 -0
  327. package/dist/modules/pickers/SelectMember.d.ts +41 -0
  328. package/dist/modules/pickers/SelectMember.js +122 -0
  329. package/dist/modules/pickers/members.d.ts +30 -0
  330. package/dist/modules/pickers/members.js +18 -0
  331. package/dist/modules/record-field/components/NumberField.d.ts +7 -2
  332. package/dist/modules/record-field/components/NumberField.js +33 -29
  333. package/dist/modules/record-field/components/TextField.d.ts +7 -3
  334. package/dist/modules/record-field/components/TextField.js +38 -30
  335. package/dist/modules/record-field/meta-inputs/components/PhoneInput.d.ts +8 -1
  336. package/dist/modules/record-field/meta-inputs/components/PhoneInput.js +23 -12
  337. package/dist/modules/record-list/RecordList.d.ts +18 -0
  338. package/dist/modules/record-list/RecordList.js +23 -0
  339. package/dist/modules/record-list/RecordListProvider.d.ts +30 -0
  340. package/dist/modules/record-list/RecordListProvider.js +57 -0
  341. package/dist/modules/record-list/RecordListRoot.d.ts +28 -0
  342. package/dist/modules/record-list/RecordListRoot.js +124 -0
  343. package/dist/modules/record-list/selection.d.ts +22 -0
  344. package/dist/modules/record-list/selection.js +54 -0
  345. package/dist/modules/record-panel/PanelDescriptionEditor.d.ts +9 -0
  346. package/dist/modules/record-panel/PanelDescriptionEditor.js +39 -0
  347. package/dist/modules/record-panel/PanelDescriptionField.d.ts +13 -0
  348. package/dist/modules/record-panel/PanelDescriptionField.js +39 -0
  349. package/dist/modules/record-panel/PanelField.d.ts +17 -0
  350. package/dist/modules/record-panel/PanelField.js +47 -0
  351. package/dist/modules/record-panel/PanelForm.d.ts +22 -0
  352. package/dist/modules/record-panel/PanelForm.js +81 -0
  353. package/dist/modules/record-panel/PanelLabel.d.ts +10 -0
  354. package/dist/modules/record-panel/PanelLabel.js +55 -0
  355. package/dist/modules/record-panel/PanelSection.d.ts +12 -0
  356. package/dist/modules/record-panel/PanelSection.js +24 -0
  357. package/dist/modules/record-panel/panelExpansion.d.ts +10 -0
  358. package/dist/modules/record-panel/panelExpansion.js +7 -0
  359. package/dist/modules/record-panel/useSaveOnLeave.d.ts +14 -0
  360. package/dist/modules/record-panel/useSaveOnLeave.js +42 -0
  361. package/dist/modules/record-table/components/CheckboxColumn.d.ts +4 -3
  362. package/dist/modules/record-table/components/CheckboxColumn.js +52 -35
  363. package/dist/modules/record-table/components/MoreColumn.js +4 -3
  364. package/dist/modules/record-table/components/RecordTable.d.ts +9 -2
  365. package/dist/modules/record-table/components/RecordTable.js +8 -1
  366. package/dist/modules/record-table/components/RecordTableCell.d.ts +15 -3
  367. package/dist/modules/record-table/components/RecordTableCell.js +31 -11
  368. package/dist/modules/record-table/components/RecordTableCellInline.d.ts +20 -4
  369. package/dist/modules/record-table/components/RecordTableCellInline.js +49 -24
  370. package/dist/modules/record-table/components/RecordTableColumnSelector.d.ts +1 -2
  371. package/dist/modules/record-table/components/RecordTableColumnSelector.js +48 -45
  372. package/dist/modules/record-table/components/RecordTableContainer.d.ts +8 -3
  373. package/dist/modules/record-table/components/RecordTableContainer.js +28 -16
  374. package/dist/modules/record-table/components/RecordTableCursor.js +33 -31
  375. package/dist/modules/record-table/components/RecordTableHead.d.ts +9 -4
  376. package/dist/modules/record-table/components/RecordTableHead.js +40 -34
  377. package/dist/modules/record-table/components/RecordTableHeader.js +24 -15
  378. package/dist/modules/record-table/components/RecordTableProvider.d.ts +30 -7
  379. package/dist/modules/record-table/components/RecordTableProvider.js +41 -26
  380. package/dist/modules/record-table/components/RecordTableRoot.d.ts +2 -1
  381. package/dist/modules/record-table/components/RecordTableRoot.js +7 -12
  382. package/dist/modules/record-table/components/RecordTableRow.d.ts +8 -1
  383. package/dist/modules/record-table/components/RecordTableRow.js +13 -12
  384. package/dist/modules/record-table/components/RecordTableRowList.d.ts +6 -1
  385. package/dist/modules/record-table/components/RecordTableRowList.js +28 -20
  386. package/dist/modules/record-table/components/RecordTableRowSkeleton.js +8 -12
  387. package/dist/modules/record-table/hooks/useColumnLayout.d.ts +2 -2
  388. package/dist/modules/record-table/hooks/useColumnLayout.js +8 -5
  389. package/dist/modules/record-table/hooks/useTablePreferences.d.ts +6 -6
  390. package/dist/modules/record-table/hooks/useTablePreferences.js +21 -34
  391. package/dist/modules/record-table/states/RecordTableCursorState.d.ts +21 -1
  392. package/dist/modules/record-table/states/RecordTableCursorState.js +21 -3
  393. package/dist/modules/record-table/types/RecordTableCursorTypes.d.ts +1 -0
  394. package/dist/modules/record-table/types/RecordTableCursorTypes.js +1 -0
  395. package/dist/modules/record-table/utils/columnLayout.d.ts +4 -4
  396. package/dist/modules/record-table/utils/columnLayout.js +7 -7
  397. package/dist/modules/record-table/utils/columnUtils.d.ts +3 -2
  398. package/dist/modules/record-table/utils/rowFields.d.ts +1 -0
  399. package/dist/modules/record-table/utils/rowFields.js +10 -9
  400. package/dist/modules/records/ContactLink.d.ts +13 -0
  401. package/dist/modules/records/ContactLink.js +77 -0
  402. package/dist/modules/records/contacts.d.ts +35 -0
  403. package/dist/modules/records/contacts.js +10 -0
  404. package/dist/modules/records/openRecord.d.ts +44 -0
  405. package/dist/modules/records/openRecord.js +48 -0
  406. package/dist/state/sidebarPanelState.d.ts +5 -1
  407. package/dist/state/sidebarPanelState.js +11 -3
  408. package/dist/state/themeState.d.ts +13 -2
  409. package/dist/state/themeState.js +18 -4
  410. package/dist/styles.css +3 -0
  411. package/dist/theme.css +106 -70
  412. package/dist/types/SexCode.d.ts +1 -0
  413. package/dist/types/SexCode.js +1 -0
  414. package/dist/types/UIConfig.d.ts +131 -3
  415. package/dist/utils/IsUndefinedOrNull.d.ts +1 -0
  416. package/dist/utils/IsUndefinedOrNull.js +1 -0
  417. package/dist/utils/file-storage.d.ts +2 -1
  418. package/dist/utils/file-storage.js +1 -0
  419. package/dist/utils/format/formatPhoneNumber.d.ts +4 -0
  420. package/dist/utils/format/formatPhoneNumber.js +4 -0
  421. package/dist/utils/getPluginAssetsUrl.d.ts +5 -0
  422. package/dist/utils/getPluginAssetsUrl.js +5 -0
  423. package/dist/utils/host-component.d.ts +10 -0
  424. package/dist/utils/host-component.js +34 -0
  425. package/dist/utils/json.d.ts +3 -2
  426. package/dist/utils/json.js +3 -2
  427. package/dist/utils/plugin-runtime.d.ts +21 -17
  428. package/dist/utils/plugin-runtime.js +59 -12
  429. package/dist/utils/plugin-styles.d.ts +7 -0
  430. package/dist/utils/plugin-styles.js +54 -0
  431. package/dist/utils/record-timeline.d.ts +10 -9
  432. package/dist/utils/record-timeline.js +12 -17
  433. package/exports.txt +226 -0
  434. package/package.json +37 -24
  435. package/dist/components/multiselect-options.d.ts +0 -16
  436. package/dist/components/multiselect-options.js +0 -13
  437. package/dist/components/multiselect-parts.d.ts +0 -23
  438. package/dist/components/multiselect-parts.js +0 -62
  439. package/dist/components/multiselect-state.d.ts +0 -66
  440. package/dist/components/multiselect-state.js +0 -131
  441. package/dist/components/time-picker.d.ts +0 -10
  442. package/dist/components/time-picker.js +0 -33
  443. package/dist/components/toasts.d.ts +0 -21
  444. package/dist/components/toasts.js +0 -69
  445. package/dist/constants/IntlLanguages.d.ts +0 -74
  446. package/dist/constants/IntlLanguages.js +0 -76
  447. package/dist/hooks/use-query-state.d.ts +0 -16
  448. package/dist/hooks/use-query-state.js +0 -122
  449. package/dist/modules/blocks/hooks/toolbar/useFontFamily.d.ts +0 -2
  450. package/dist/modules/blocks/hooks/toolbar/useFontFamily.js +0 -24
  451. package/dist/modules/blocks/hooks/toolbar/useFontSize.d.ts +0 -2
  452. package/dist/modules/blocks/hooks/toolbar/useFontSize.js +0 -24
  453. package/dist/modules/blocks/types/toolbar/EditorVisibleBounds.d.ts +0 -6
  454. package/dist/modules/blocks/types/toolbar/EditorVisibleBounds.js +0 -0
  455. package/dist/modules/blocks/types/toolbar/FontFamily.d.ts +0 -5
  456. package/dist/modules/blocks/types/toolbar/FontFamily.js +0 -0
  457. package/dist/modules/blocks/types/toolbar/FontSize.d.ts +0 -5
  458. package/dist/modules/blocks/types/toolbar/FontSize.js +0 -0
  459. package/dist/modules/blocks/types/toolbar/ToolbarMenuItemProps.d.ts +0 -4
  460. package/dist/modules/blocks/types/toolbar/ToolbarMenuItemProps.js +0 -0
  461. package/dist/modules/blocks/types/toolbar/ToolbarPositioningOptions.d.ts +0 -3
  462. package/dist/modules/blocks/types/toolbar/ToolbarPositioningOptions.js +0 -0
  463. package/dist/modules/blocks/utils/toolbar/getEditorVisibleBounds.d.ts +0 -2
  464. package/dist/modules/blocks/utils/toolbar/getEditorVisibleBounds.js +0 -30
  465. package/dist/modules/blocks/utils/toolbar/getToolbarPositioning.d.ts +0 -2
  466. package/dist/modules/blocks/utils/toolbar/getToolbarPositioning.js +0 -41
  467. package/dist/modules/filter/hooks/useFilterQueryState.d.ts +0 -4
  468. package/dist/modules/filter/hooks/useFilterQueryState.js +0 -14
  469. package/dist/modules/hotkey/hooks/useScopedHotKeysCallback.d.ts +0 -9
  470. package/dist/modules/hotkey/hooks/useScopedHotKeysCallback.js +0 -15
  471. package/dist/modules/hotkey/states/internal/pendingHotkeyState.d.ts +0 -4
  472. package/dist/modules/hotkey/states/internal/pendingHotkeyState.js +0 -4
  473. package/dist/types/Theme.d.ts +0 -1
  474. package/dist/types/Theme.js +0 -0
  475. package/dist/utils/localization/formatDateISOStringToRelativeDate.d.ts +0 -2
  476. package/dist/utils/localization/formatDateISOStringToRelativeDate.js +0 -16
package/dist/theme.css CHANGED
@@ -1,12 +1,16 @@
1
1
  /*
2
- Tailwind theme contract shared by the core-ui host and plugin remotes.
2
+ Tailwind theme contract shared by the web host and plugin remotes.
3
3
 
4
4
  Maps utilities to design tokens. Token values live on the host's :root and
5
5
  .dark (base.css, imported once by the host page), so this file must not
6
- declare them. A plugin imports it next to its own prefixed Tailwind
7
- utilities; see core-ui/src/styles.css for the host.
6
+ declare them. A plugin UI imports it with theme(inline) to build its own
7
+ utilities (create-erxes's ui/src/styles.css), and addPluginStyles adds the
8
+ ones web lacks; see apps/web/src/styles.css for the host.
8
9
  */
9
10
  @custom-variant dark (&:is(.dark *));
11
+ /* Inside an app layout whose navigation panel is closed, where its toggle button floats at the
12
+ top left; AppLayout sets the attribute. */
13
+ @custom-variant navigation-collapsed (&:is([data-navigation-collapsed] *));
10
14
 
11
15
  @utility container {
12
16
  margin-inline: auto;
@@ -26,6 +30,10 @@
26
30
  'Courier New', monospace;
27
31
 
28
32
  --text-*: initial;
33
+ /* Counters, keyboard hints and initials in small avatars. They keep the surrounding line height. */
34
+ --text-4xs: 0.5rem;
35
+ --text-3xs: 0.625rem;
36
+ --text-2xs: 0.6875rem;
29
37
  --text-xs: 0.75rem;
30
38
  --text-xs--line-height: 0.875rem;
31
39
  --text-sm: 0.8125rem;
@@ -45,8 +53,16 @@
45
53
  --color-background: var(--background);
46
54
  --color-foreground: var(--foreground);
47
55
 
56
+ /* Cards and floating surfaces (BlockNote's toolbar, menus and panels) sit on the page background. */
57
+ --color-popover: var(--background);
58
+ --color-popover-foreground: var(--foreground);
59
+ --color-card: var(--background);
60
+ --color-card-foreground: var(--foreground);
61
+ --color-input: var(--input);
62
+
48
63
  --color-primary: var(--primary);
49
64
  --color-primary-foreground: var(--primary-foreground);
65
+ --color-primary-text: var(--primary-text);
50
66
 
51
67
  --color-secondary: var(--secondary);
52
68
  --color-secondary-foreground: var(--secondary-foreground);
@@ -54,6 +70,11 @@
54
70
  --color-success: var(--success);
55
71
  --color-warning: var(--warning);
56
72
  --color-info: var(--info);
73
+ /* Status colours as text, readable on their own 10% tint. */
74
+ --color-success-text: var(--success-text);
75
+ --color-warning-text: var(--warning-text);
76
+ --color-destructive-text: var(--destructive-text);
77
+ --color-info-text: var(--info-text);
57
78
 
58
79
  --color-destructive: var(--destructive);
59
80
  --color-destructive-foreground: var(--destructive-foreground);
@@ -90,16 +111,34 @@
90
111
 
91
112
  --spacing-cell: 33px;
92
113
 
114
+ /* An image or video opened full size over the page. */
115
+ --max-width-lightbox: 90vw;
116
+ --max-height-lightbox: 90vh;
117
+ /* A record table's rows fill the page below its header bars. */
118
+ --min-height-table: calc(100vh - 8rem);
119
+
120
+ /* A content-sized first track and the rest: label and value, icon and text. */
121
+ --grid-template-columns-leading: auto minmax(0, 1fr);
122
+ --grid-template-rows-leading: auto minmax(0, 1fr);
123
+ /* Two scrolling halves around a bar. */
124
+ --grid-template-rows-split: minmax(0, 1fr) auto minmax(0, 1fr);
125
+ /* A side panel's field labels. */
126
+ --grid-template-columns-field: 6.5rem minmax(0, 1fr);
127
+ /* A side column of 18 to 24rem beside the content. */
128
+ --grid-template-columns-aside: minmax(18rem, 24rem) minmax(0, 1fr);
129
+ /* A condition row: field and operator, then the remove button. */
130
+ --grid-template-columns-condition: minmax(0, 1fr) minmax(0, 1fr) auto;
131
+
132
+ /* Panels and sidebars sliding open or shut. */
133
+ --ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1);
134
+ --ease-out-quad: cubic-bezier(0.25, 0.46, 0.45, 0.94);
135
+ /* Overshoots a little, then settles. */
136
+ --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
137
+ /* What changes when a panel or control grows, shrinks or slides in, fading as it goes. */
138
+ --transition-property-layout: width, height, margin, padding, left, right, opacity;
139
+
93
140
  --animate-accordion-down: accordion-down 0.2s ease-out;
94
141
  --animate-accordion-up: accordion-up 0.2s ease-out;
95
- --animate-spinner: spinner 0.96s linear infinite;
96
- --animate-bot-appear: bot-appear 0.3s ease-out 0.25s backwards;
97
- --animate-bot-rock: bot-rock 2.6s ease-in-out infinite;
98
- --animate-bot-glance: bot-glance 4.5s ease-in-out infinite;
99
- --animate-bot-blink: bot-blink 4.5s infinite;
100
- --animate-bot-dots: bot-dots 1.2s infinite;
101
- --animate-text-shimmer: text-shimmer 1.8s linear infinite;
102
-
103
142
  --animate-first: move-vertical 30s ease infinite;
104
143
  --animate-second: move-in-circle 20s reverse infinite;
105
144
  --animate-third: move-in-circle 40s linear infinite;
@@ -129,12 +168,12 @@
129
168
  height: 0;
130
169
  }
131
170
  to {
132
- height: var(--radix-accordion-content-height);
171
+ height: var(--accordion-panel-height);
133
172
  }
134
173
  }
135
174
  @keyframes accordion-up {
136
175
  from {
137
- height: var(--radix-accordion-content-height);
176
+ height: var(--accordion-panel-height);
138
177
  }
139
178
  to {
140
179
  height: 0;
@@ -148,65 +187,11 @@
148
187
  opacity: 0.15;
149
188
  }
150
189
  }
151
- /* Waiting bot: hugs its knees and rocks, glancing around; dots pulse. */
152
- @keyframes bot-appear {
190
+ @keyframes appear {
153
191
  from {
154
192
  opacity: 0;
155
- }
156
- }
157
- @keyframes bot-rock {
158
- 0%,
159
- 100% {
160
- transform: rotate(-5deg);
161
- }
162
- 50% {
163
- transform: rotate(5deg);
164
- }
165
- }
166
- @keyframes bot-glance {
167
- 0%,
168
- 20%,
169
- 80%,
170
- 100% {
171
- transform: translateX(0);
172
- }
173
- 30%,
174
- 45% {
175
- transform: translateX(-5px);
176
- }
177
- 55%,
178
- 70% {
179
- transform: translateX(5px);
180
- }
181
- }
182
- @keyframes bot-blink {
183
- 0%,
184
- 46%,
185
- 50%,
186
- 96%,
187
- 100% {
188
- transform: scaleY(1);
189
- }
190
- 48%,
191
- 98% {
192
- transform: scaleY(0.1);
193
- }
194
- }
195
- @keyframes bot-dots {
196
- 0%,
197
- 100% {
198
- opacity: 0.25;
199
- }
200
- 40% {
201
- opacity: 1;
202
- }
203
- }
204
- @keyframes text-shimmer {
205
- from {
206
- background-position: 100% 0;
207
- }
208
- to {
209
- background-position: 0% 0;
193
+ transform: translate3d(var(--appear-x, 0), var(--appear-y, 0), 0)
194
+ scale(var(--appear-scale, 1));
210
195
  }
211
196
  }
212
197
 
@@ -245,6 +230,49 @@
245
230
  }
246
231
  }
247
232
 
233
+ /* Inline, because the variable resolves on the popup, not on :root. A popup is at most 24rem
234
+ tall, or the room Base UI measures beside its anchor; BlockNote's menus, which don't measure,
235
+ get half the viewport. */
236
+ @theme inline {
237
+ --max-height-popup: min(24rem, var(--available-height, 50dvh));
238
+ /* An entrance from an offset and scale the element sets as --appear-x, --appear-y and
239
+ --appear-scale, timed by --appear-duration, --appear-easing and --appear-delay. Inline,
240
+ so those resolve on the element rather than on :root. */
241
+ --animate-appear: appear var(--appear-duration, 500ms) var(--appear-easing, ease-out)
242
+ var(--appear-delay, 0ms) both;
243
+ }
244
+
245
+ /* Spoke --spoke (0 to 9) of Spinner's ten: a bar left of the centre, turned about a point one
246
+ bar length further left, its fade a tenth of a turn behind the one before. */
247
+ @utility spinner-spoke {
248
+ position: absolute;
249
+ top: -3.9%;
250
+ left: -10%;
251
+ width: 24%;
252
+ height: 8%;
253
+ transform-origin: -100%;
254
+ transform: translate(146%) rotate(calc(var(--spoke) * 36deg + 0.001deg));
255
+ animation: spinner 0.96s linear calc((var(--spoke) - 10) * 0.096s) infinite;
256
+ }
257
+
258
+ /* A scroll viewport or list takes its popup's corners and height limit; a button inside
259
+ BlockNote's markup takes the editor's font. */
260
+ /* Base UI keeps a closing popup mounted until its exit animation ends; this holds the last
261
+ frame so it doesn't flash back first. */
262
+ @utility animation-forwards {
263
+ animation-fill-mode: forwards;
264
+ }
265
+
266
+ @utility rounded-inherit {
267
+ border-radius: inherit;
268
+ }
269
+ @utility max-h-inherit {
270
+ max-height: inherit;
271
+ }
272
+ @utility font-inherit {
273
+ font: inherit;
274
+ }
275
+
248
276
  @utility hide-scroll {
249
277
  /* Hide scrollbar for Chrome, Safari and Opera */
250
278
  &::-webkit-scrollbar {
@@ -278,3 +306,11 @@
278
306
  @apply block!;
279
307
  }
280
308
  }
309
+
310
+ /* A dnd-kit sortable item. useSortable's transform and transition reach it as
311
+ --sortable-transform and --sortable-transition. The element's own transition-* classes
312
+ come after this rule, so an element that has them sets them only while no drag runs. */
313
+ @utility sortable {
314
+ transform: var(--sortable-transform);
315
+ transition: var(--sortable-transition);
316
+ }
@@ -1,3 +1,4 @@
1
+ /** A person's sex as an ISO/IEC 5218 code. `SexField` picks one and `SexDisplay` shows it. */
1
2
  export declare enum SexCode {
2
3
  NOT_KNOWN = 0,
3
4
  MALE = 1,
@@ -1,4 +1,5 @@
1
1
  // src/types/SexCode.ts
2
+ /** A person's sex as an ISO/IEC 5218 code. `SexField` picks one and `SexDisplay` shows it. */
2
3
  let SexCode = /* @__PURE__ */ function(SexCode) {
3
4
  SexCode[SexCode["NOT_KNOWN"] = 0] = "NOT_KNOWN";
4
5
  SexCode[SexCode["MALE"] = 1] = "MALE";
@@ -1,6 +1,16 @@
1
+ import { TContactContentType } from "../modules/records/contacts.js";
2
+ import { RecordRef } from "../modules/records/openRecord.js";
1
3
  import { Icon } from "@tabler/icons-react";
2
- /** A property input's own settings, stored with the custom field; each input defines its keys. */
4
+ import { UseQueryOptions } from "@tanstack/react-query";
5
+ /**
6
+ * A property input's own settings, stored with the custom field.
7
+ * Each input defines its keys.
8
+ */
3
9
  export type TPropertyInputMeta = Record<string, unknown>;
10
+ /**
11
+ * Props of a plugin's activity row component in `widgets.activityRows`.
12
+ * The shape comes from erxes 3.x; web doesn't read `widgets` from a plugin's config.
13
+ */
4
14
  export type TActivityRowProps = {
5
15
  activity: {
6
16
  _id: string;
@@ -11,6 +21,11 @@ export type TActivityRowProps = {
11
21
  metadata?: Record<string, unknown>;
12
22
  };
13
23
  };
24
+ /**
25
+ * Props of a custom property input in `widgets.propertyInputs`.
26
+ * It edits the field's value as text and its own settings as `meta`. The shape comes from
27
+ * erxes 3.x; web doesn't read `widgets` from a plugin's config.
28
+ */
14
29
  export type TPropertyInputProps = {
15
30
  value: string;
16
31
  onValueChange: (value: string) => void;
@@ -18,18 +33,131 @@ export type TPropertyInputProps = {
18
33
  onMetaChange: (meta: TPropertyInputMeta) => void;
19
34
  disabled?: boolean;
20
35
  };
36
+ /** The schematic a dashboard widget shows in the widget catalog. */
21
37
  export type TDashboardWidgetPreview = 'bar' | 'line' | 'area' | 'pie' | 'table' | 'list' | 'kpi' | 'heatmap' | 'progress';
38
+ /** What a record section is given: the customer or company it shows on. */
39
+ export type TRecordSectionProps = {
40
+ contentType: TContactContentType;
41
+ contentId: string;
42
+ };
43
+ /**
44
+ * A plugin's section on a customer's or company's detail in core's panel.
45
+ * It sits under core's own sections, e.g. the customer's deals. One that crashes shows its
46
+ * error, not the panel's.
47
+ */
48
+ export type TRecordSection = {
49
+ contentType: TContactContentType;
50
+ /** The section's heading. */
51
+ title: string;
52
+ icon: React.ElementType;
53
+ component: React.ComponentType<TRecordSectionProps>;
54
+ };
55
+ /** What each slot of a plugin record is given: the record. */
56
+ export type TRecordSlotProps = RecordRef;
57
+ /**
58
+ * The customers and companies a record is about.
59
+ * Its relation tabs list records of these.
60
+ */
61
+ export type TRecordContacts = {
62
+ customerIds: string[];
63
+ companyIds: string[];
64
+ };
65
+ /** A plugin record type's own tab, after core's Detail or Activity tab. */
66
+ export type TRecordTab = {
67
+ value: string;
68
+ label: string;
69
+ icon: Icon;
70
+ after?: 'detail' | 'activity';
71
+ component: React.ComponentType<TRecordSlotProps>;
72
+ };
73
+ /**
74
+ * Props of a plugin record type's `New` slot, the draft form.
75
+ * The draft is saved as the record on Save.
76
+ */
77
+ export type TRecordDraftProps = {
78
+ /** What its opener passed (`useOpenRecord().openNew(type, defaults)`), e.g. a stage. */
79
+ defaults: Record<string, unknown>;
80
+ /** Call with the saved record's id: the record takes the draft's place in the panel. */
81
+ onCreated: (id: string) => void;
82
+ /** Leaves the draft: back to the record it came from, else closes the panel. */
83
+ onCancel: () => void;
84
+ };
85
+ /**
86
+ * A record type a plugin shows in core's side panel. Core draws the panel as it draws a
87
+ * customer's: header with Back, expand and close, the tabs (Detail, the type's own `tabs`,
88
+ * every allowed plugin's relation tabs for it, Activity), resizing, the address
89
+ * `?panel=/detail/<contentType>/<id>`, drafts. The plugin fills the slots. Open one with
90
+ * `useOpenRecord().open({ contentType, contentId })`, a draft with `openNew(contentType)`.
91
+ */
92
+ export type TPanelRecordType = {
93
+ /** `<plugin name>:<thing>`, e.g. `sales:deal`; it must start with the plugin's `name`. */
94
+ contentType: string;
95
+ /** What one is called, e.g. "Deal": a draft's header reads "New deal". */
96
+ title: string;
97
+ icon: React.ElementType;
98
+ /**
99
+ * The record's own page, where the panel's expand button leads: a route of the plugin's,
100
+ * under its `path`, that renders `<RecordPage contentType contentId />`.
101
+ */
102
+ detailPath: (contentId: string) => string;
103
+ /** The header's title: the record's name, editable in place if the plugin wants. */
104
+ Title: React.ComponentType<TRecordSlotProps>;
105
+ /** The header's own actions (a "more" menu), before expand and close. */
106
+ Actions?: React.ComponentType<TRecordSlotProps>;
107
+ /** The Detail tab: `PanelSection`s of `PanelField` rows. */
108
+ Detail: React.ComponentType<TRecordSlotProps>;
109
+ tabs?: TRecordTab[];
110
+ /** A record not created yet; without it, the type has no drafts. */
111
+ New?: React.ComponentType<TRecordDraftProps>;
112
+ /**
113
+ * The record's customers and companies, as query options (often the record's own query with
114
+ * `select`). Without it, plugins' relation tabs don't show on this type.
115
+ */
116
+ contacts?: (contentId: string) => UseQueryOptions<TRecordContacts, Error, TRecordContacts>;
117
+ /** A timeline type of the plugin's manifest (`timelines`): core's Activity tab shows it. */
118
+ activity?: string;
119
+ };
120
+ /** Props of a relation tab: the record it shows on, and its contacts. */
121
+ export type TRelationTabProps = TRecordSlotProps & TRecordContacts;
122
+ /**
123
+ * A plugin's tab on other records' panels, listing its own records.
124
+ * It lists the plugin's own records of the same customers and companies: a customer's deals, a
125
+ * task's deals. Shown on core's customers and companies
126
+ * (their contacts are themselves) and on plugin record types that give `contacts`. A record
127
+ * clicked in it opens on top in the same panel (`useOpenRecord().open`), and Back returns.
128
+ */
129
+ export type TRelationTab = {
130
+ /** Unique within the plugin, e.g. `deals`. */
131
+ name: string;
132
+ title: string;
133
+ icon: Icon;
134
+ /** The content types it shows on (`core:customer`, `tasks:task`); every one when omitted. */
135
+ hosts?: string[];
136
+ component: React.ComponentType<TRelationTabProps>;
137
+ };
138
+ /**
139
+ * A plugin UI's `CONFIG`, exported from its `./config` remote.
140
+ * web reads `name`, `path`, `icon`, `modules`, `checkAccess`, `recordSections`, `recordTypes`
141
+ * and `relationTabs`; its first module renders under `/<path>/*`. The other fields come from
142
+ * erxes 3.x and web ignores them.
143
+ */
22
144
  export type IUIConfig = {
23
145
  name: string;
24
146
  path: string;
25
147
  icon?: React.ElementType;
148
+ /** Sections on core's customer and company detail, shown to members who may use the plugin. */
149
+ recordSections?: TRecordSection[];
150
+ /** The plugin's records core's side panel opens, for members who may use the plugin. */
151
+ recordTypes?: TPanelRecordType[];
152
+ /** Tabs on other records' panels listing the plugin's records of their contacts. */
153
+ relationTabs?: TRelationTab[];
26
154
  i18n?: boolean;
27
155
  i18nNamespace?: string;
28
156
  hasFloatingWidget?: boolean;
29
157
  /**
30
158
  * erxes platform versions this plugin is built for, as a semver range
31
- * (e.g. `'~3.2'`, `'>=3.2.25 <3.4'`). Core warns — and still loads the
32
- * plugin — when the running platform is outside the range.
159
+ * (e.g. `'~3.2'`, `'>=3.2.25 <3.4'`). Core warns, and still loads the
160
+ * plugin, when the running platform is outside the range.
33
161
  */
34
162
  platform?: string;
35
163
  navigationGroup?: {
@@ -1 +1,2 @@
1
+ /** True for `null` and `undefined`, and narrows the value's type. */
1
2
  export declare const isUndefinedOrNull: (value: unknown) => value is null | undefined;
@@ -1,3 +1,4 @@
1
1
  // src/utils/IsUndefinedOrNull.ts
2
+ /** True for `null` and `undefined`, and narrows the value's type. */
2
3
  const isUndefinedOrNull = (value) => value === void 0 || value === null;
3
4
  export { isUndefinedOrNull };
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Where erxes-ui's upload hooks and components send files. The host app
3
- * (core-ui) sets an adapter for its file service at start-up. erxes-ui is a
3
+ * (web) sets an adapter for its file service at start-up. erxes-ui is a
4
4
  * Module Federation singleton, so plugin UIs get the host's adapter too.
5
5
  */
6
6
  export interface FileStorageAdapter {
@@ -12,6 +12,7 @@ export interface FileStorageAdapter {
12
12
  /** Deletes a file by the address `upload` returned. */
13
13
  remove?(address: string): Promise<void>;
14
14
  }
15
+ /** Sets where uploads go; web calls it at startup and plugins don't. */
15
16
  export declare const setFileStorage: (next: FileStorageAdapter | null) => void;
16
17
  export declare const storeFile: (file: File, options?: Parameters<FileStorageAdapter['upload']>[1]) => Promise<string>;
17
18
  export declare const removeStoredFile: (address: string) => Promise<void>;
@@ -1,5 +1,6 @@
1
1
  // src/utils/file-storage.ts
2
2
  let adapter = null;
3
+ /** Sets where uploads go; web calls it at startup and plugins don't. */
3
4
  const setFileStorage = (next) => {
4
5
  adapter = next;
5
6
  };
@@ -1,4 +1,8 @@
1
1
  import { CountryCode } from "libphonenumber-js";
2
+ /**
3
+ * A phone number formatted as people write it, even half typed.
4
+ * `defaultCountry` decides how a number without a `+` code reads.
5
+ */
2
6
  export declare const formatPhoneNumber: ({ defaultCountry, value }: {
3
7
  defaultCountry?: CountryCode;
4
8
  value: string;
@@ -1,5 +1,9 @@
1
1
  import { AsYouType } from "libphonenumber-js";
2
2
  // src/utils/format/formatPhoneNumber.ts
3
+ /**
4
+ * A phone number formatted as people write it, even half typed.
5
+ * `defaultCountry` decides how a number without a `+` code reads.
6
+ */
3
7
  const formatPhoneNumber = ({ defaultCountry, value }) => {
4
8
  return new AsYouType({ defaultCountry }).input(value);
5
9
  };
@@ -1 +1,6 @@
1
+ /**
2
+ * A file's URL in a plugin UI's deployed `assets` folder.
3
+ * `getPluginAssetsUrl('hr', 'logo.svg')` resolves next to the `hr_ui` remote entry. For a plugin
4
+ * web hasn't registered, it returns `url` unchanged.
5
+ */
1
6
  export declare const getPluginAssetsUrl: (pluginName: string, url: string) => string;
@@ -1,5 +1,10 @@
1
1
  import { getInstance } from "@module-federation/enhanced/runtime";
2
2
  // src/utils/getPluginAssetsUrl.ts
3
+ /**
4
+ * A file's URL in a plugin UI's deployed `assets` folder.
5
+ * `getPluginAssetsUrl('hr', 'logo.svg')` resolves next to the `hr_ui` remote entry. For a plugin
6
+ * web hasn't registered, it returns `url` unchanged.
7
+ */
3
8
  const getPluginAssetsUrl = (pluginName, url) => {
4
9
  const remote = (getInstance()?.options.remotes)?.find((r) => r.name === `${pluginName}_ui`);
5
10
  if (remote && "entry" in remote && typeof remote.entry === "string") return `${remote.entry.replace("remoteEntry.js", "assets")}/${url}`;
@@ -0,0 +1,10 @@
1
+ import { ComponentType } from "react";
2
+ /**
3
+ * A component the host app (web) provides at startup and plugin UIs render: core's timeline,
4
+ * a record's own page, a list's filter. erxes-ui is a Module Federation singleton, so every
5
+ * plugin gets the host's. Outside erxes nothing is registered and it renders nothing.
6
+ */
7
+ export declare const hostComponent: <P extends object>() => {
8
+ set: (component: ComponentType<P> | null) => void;
9
+ Host: (props: P) => import("react").JSX.Element | null;
10
+ };
@@ -0,0 +1,34 @@
1
+ import { jsx } from "react/jsx-runtime";
2
+ import { Suspense, useSyncExternalStore } from "react";
3
+ // src/utils/host-component.tsx
4
+ /**
5
+ * A component the host app (web) provides at startup and plugin UIs render: core's timeline,
6
+ * a record's own page, a list's filter. erxes-ui is a Module Federation singleton, so every
7
+ * plugin gets the host's. Outside erxes nothing is registered and it renders nothing.
8
+ */
9
+ const hostComponent = () => {
10
+ let registered = null;
11
+ const listeners = /* @__PURE__ */ new Set();
12
+ const subscribe = (listener) => {
13
+ listeners.add(listener);
14
+ return () => listeners.delete(listener);
15
+ };
16
+ const read = () => registered;
17
+ const set = (component) => {
18
+ registered = component;
19
+ listeners.forEach((listener) => listener());
20
+ };
21
+ const Host = (props) => {
22
+ const Component = useSyncExternalStore(subscribe, read, read);
23
+ if (!Component) return null;
24
+ return /* @__PURE__ */ jsx(Suspense, {
25
+ fallback: null,
26
+ children: /* @__PURE__ */ jsx(Component, { ...props })
27
+ });
28
+ };
29
+ return {
30
+ set,
31
+ Host
32
+ };
33
+ };
34
+ export { hostComponent };
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
2
  /**
3
- * A JSON string that decodes to `schema`: `jsonOf(schema).safeParse(text)` fails
4
- * on text that isn't JSON the same way it fails on JSON of the wrong shape.
3
+ * A zod schema for a JSON string that decodes to `schema`.
4
+ * `jsonOf(schema).safeParse(text)` fails on text that isn't JSON the same way it fails on JSON
5
+ * of the wrong shape.
5
6
  */
6
7
  export declare const jsonOf: <S extends z.ZodType>(schema: S) => z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<unknown, string>>, S>;
@@ -1,8 +1,9 @@
1
1
  import { z } from "zod";
2
2
  // src/utils/json.ts
3
3
  /**
4
- * A JSON string that decodes to `schema`: `jsonOf(schema).safeParse(text)` fails
5
- * on text that isn't JSON the same way it fails on JSON of the wrong shape.
4
+ * A zod schema for a JSON string that decodes to `schema`.
5
+ * `jsonOf(schema).safeParse(text)` fails on text that isn't JSON the same way it fails on JSON
6
+ * of the wrong shape.
6
7
  */
7
8
  const jsonOf = (schema) => z.string().transform((text, ctx) => {
8
9
  try {
@@ -1,17 +1,5 @@
1
1
  import { z } from "zod";
2
- /**
3
- * How plugin UIs reach their own API and hear about changes. The host app
4
- * (core-ui) provides the runtime; erxes-ui is a Module Federation singleton,
5
- * so every plugin UI gets the host's.
6
- *
7
- * - `pluginFetch('hr', '/leaves')` calls the plugin's API (its address comes
8
- * from the plugin's manifest) with a 5-minute token core issues for this
9
- * member and this plugin only. The plugin verifies it with core's public
10
- * keys; core's session cookie never leaves core.
11
- * - `useLiveSignal('hr', ['leaves'], refetch)` runs when the plugin says a
12
- * topic changed (`core_live_signal` / `POST /core/v1/plugins/live`), and
13
- * after reconnecting, over the one stream the browser keeps with core.
14
- */
2
+ /** A member's short-lived token for one plugin's API, and its address. */
15
3
  export interface PluginSession {
16
4
  token: string;
17
5
  /** ISO time the token stops working. */
@@ -19,21 +7,37 @@ export interface PluginSession {
19
7
  /** The plugin API's address, from its manifest. */
20
8
  apiUrl: string | null;
21
9
  }
10
+ /**
11
+ * A message on core's live stream: a plugin's changed topics, or resync.
12
+ * `resync` comes after a reconnect, when signals sent meanwhile were missed.
13
+ */
22
14
  export type PluginLiveMessage = {
23
15
  plugin: string;
24
16
  topics: string[];
25
17
  } | {
26
18
  resync: true;
27
19
  };
20
+ /**
21
+ * What the host gives plugin UIs: plugin API sessions and the live stream.
22
+ * web provides it with `setPluginRuntime`; plugins call `pluginFetch`, `pluginJson` and
23
+ * `useLiveSignal`, which use it.
24
+ */
28
25
  export interface PluginRuntime {
29
26
  session(plugin: string): Promise<PluginSession>;
30
27
  subscribe(listener: (message: PluginLiveMessage) => void): () => void;
31
28
  }
29
+ /**
30
+ * Sets the plugin runtime; web calls it at startup and plugins don't.
31
+ * It drops every cached plugin session.
32
+ */
32
33
  export declare const setPluginRuntime: (next: PluginRuntime | null) => void;
34
+ /** The host's plugin runtime, or null outside erxes. */
33
35
  export declare const getPluginRuntime: () => PluginRuntime | null;
34
36
  /**
35
37
  * `fetch` against a plugin's API as the signed-in member. Relative paths are
36
- * resolved against the plugin's API address; a 401 renews the token once.
38
+ * resolved against the plugin's API address; a 401 renews the token once and
39
+ * sends the call again, so `init.body` must be one that can be sent twice
40
+ * (text, an ArrayBuffer, a Blob or FormData, not a stream).
37
41
  */
38
42
  export declare const pluginFetch: (plugin: string, path: string, init?: RequestInit) => Promise<Response>;
39
43
  /**
@@ -44,8 +48,8 @@ export declare const pluginJson: <S extends z.ZodType>(plugin: string, path: str
44
48
  json?: unknown;
45
49
  }) => Promise<z.infer<S>>;
46
50
  /**
47
- * Runs `onSignal(topics)` when the plugin announces a change to any of
48
- * `topics` — and after a reconnect (with every topic), since signals sent
49
- * meanwhile were missed.
51
+ * Runs `onSignal` when a plugin says one of `topics` changed, to refetch.
52
+ * It also runs after a reconnect, with every topic, since signals sent meanwhile were missed.
53
+ * Outside erxes it never runs.
50
54
  */
51
55
  export declare const useLiveSignal: (plugin: string, topics: string | string[], onSignal: (topics: string[]) => void) => void;