@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
@@ -1,6 +1,5 @@
1
1
  export interface IFilterContext {
2
2
  id: string;
3
- sessionKey?: string;
4
3
  resetFilterState: () => void;
5
4
  setOpen: (open: boolean) => void;
6
5
  setView: (view: string) => void;
@@ -1,5 +1,10 @@
1
1
  import { PopoverChangeDetails, PopoverProps } from "../../../components/popover.js";
2
2
  import { Options } from "react-hotkeys-hook";
3
+ /**
4
+ * A `Popover` that takes over the hotkey scope while it is open.
5
+ * Hotkeys of `<scope>.Popover` work only while it is open, and the scope before it comes back
6
+ * on close. Enter calls `onEnter`, and closes it with `closeOnEnter`.
7
+ */
3
8
  export declare const PopoverScoped: ({ scope, onOpenChange, onEnter, closeOnEnter, dependencies, options, open, ...props }: Omit<PopoverProps, 'onOpenChange'> & {
4
9
  /** Closing on Enter passes no details. */
5
10
  onOpenChange?: (open: boolean, details?: PopoverChangeDetails) => void;
@@ -7,6 +7,11 @@ import { jsx } from "react/jsx-runtime";
7
7
  import { useLayoutEffect, useState } from "react";
8
8
  import { useAtomValue, useStore } from "jotai";
9
9
  // src/modules/hotkey/components/PopoverScoped.tsx
10
+ /**
11
+ * A `Popover` that takes over the hotkey scope while it is open.
12
+ * Hotkeys of `<scope>.Popover` work only while it is open, and the scope before it comes back
13
+ * on close. Enter calls `onEnter`, and closes it with `closeOnEnter`.
14
+ */
10
15
  const PopoverScoped = ({ scope, onOpenChange, onEnter, closeOnEnter, dependencies, options, open, ...props }) => {
11
16
  const [_open, _setOpen] = useState(false);
12
17
  const { setHotkeyScopeAndMemorizePreviousScope } = usePreviousHotkeyScope();
@@ -1,4 +1,5 @@
1
1
  import { CustomHotkeyScopes } from "../types/CustomHotkeyScope.js";
2
+ /** Sets a hotkey scope and remembers the old one to go back to. */
2
3
  export declare const usePreviousHotkeyScope: () => {
3
4
  goBackToPreviousHotkeyScope: () => void;
4
5
  setHotkeyScopeAndMemorizePreviousScope: (scope: string, customScopes?: CustomHotkeyScopes | undefined) => void;
@@ -4,6 +4,7 @@ import { useSetHotkeyScope } from "./useSetHotkeyScope.js";
4
4
  import { useCallback } from "react";
5
5
  import { useAtomCallback } from "jotai/utils";
6
6
  // src/modules/hotkey/hooks/usePreviousHotkeyScope.tsx
7
+ /** Sets a hotkey scope and remembers the old one to go back to. */
7
8
  const usePreviousHotkeyScope = () => {
8
9
  const setHotKeyScope = useSetHotkeyScope();
9
10
  return {
@@ -1,3 +1,7 @@
1
1
  import { HotkeyCallback, Keys, Options } from "react-hotkeys-hook";
2
- /** Runs `callback` on `keys` only while `scope` is one of the enabled hotkey scopes. */
2
+ /**
3
+ * Runs `callback` on `keys` while the hotkey `scope` is enabled.
4
+ * It stops the key's default and propagation unless `options.preventDefault` is false, and
5
+ * works in content-editable elements.
6
+ */
3
7
  export declare const useScopedHotkeys: (keys: Keys, callback: HotkeyCallback, scope: string, dependencies?: unknown[], options?: Options) => import("react").RefCallback<HTMLElement | null>;
@@ -3,7 +3,11 @@ import { useCallback } from "react";
3
3
  import { useAtomCallback } from "jotai/utils";
4
4
  import { useHotkeys } from "react-hotkeys-hook";
5
5
  // src/modules/hotkey/hooks/useScopedHotkeys.tsx
6
- /** Runs `callback` on `keys` only while `scope` is one of the enabled hotkey scopes. */
6
+ /**
7
+ * Runs `callback` on `keys` while the hotkey `scope` is enabled.
8
+ * It stops the key's default and propagation unless `options.preventDefault` is false, and
9
+ * works in content-editable elements.
10
+ */
7
11
  const useScopedHotkeys = (keys, callback, scope, dependencies, options) => {
8
12
  const isScopeEnabled = useAtomCallback(useCallback((get) => get(internalHotkeysEnabledScopesState).includes(scope), [scope]));
9
13
  const preventDefault = (options?.preventDefault ?? true) === true;
@@ -1,5 +1,9 @@
1
1
  import { TablerIcon } from "@tabler/icons-react";
2
2
  import { ComponentProps } from "react";
3
+ /**
4
+ * A Tabler icon by its name, such as one stored on a record.
5
+ * It shows `Icon123` for an unknown name, or until `IconsProvider` has loaded the icons.
6
+ */
3
7
  export declare const IconComponent: ({ name, ...props }: ComponentProps<TablerIcon> & {
4
8
  name?: string;
5
9
  }) => import("react").JSX.Element;
@@ -3,6 +3,10 @@ import { Icon123 } from "@tabler/icons-react";
3
3
  import { jsx } from "react/jsx-runtime";
4
4
  import { useAtomValue } from "jotai";
5
5
  // src/modules/icons/components/IconComponent.tsx
6
+ /**
7
+ * A Tabler icon by its name, such as one stored on a record.
8
+ * It shows `Icon123` for an unknown name, or until `IconsProvider` has loaded the icons.
9
+ */
6
10
  const IconComponent = ({ name, ...props }) => {
7
11
  const icons = useAtomValue(iconsState);
8
12
  const Icon = name && icons[name] || Icon123;
@@ -1,4 +1,8 @@
1
1
  import { Combobox } from "../../../components/combobox.js";
2
+ /**
3
+ * A button that picks a Tabler icon from a searchable list in a popover.
4
+ * Controlled: shows `value`, and reports a pick through `onValueChange`.
5
+ */
2
6
  export declare const IconPicker: ({ ref, value, onValueChange, ...props }: React.ComponentProps<typeof Combobox.TriggerBase> & {
3
7
  value?: string;
4
8
  onValueChange?: (value: string | null) => void;
@@ -6,12 +6,15 @@ import { IconComponent } from "./IconComponent.js";
6
6
  import { jsx, jsxs } from "react/jsx-runtime";
7
7
  import { useState } from "react";
8
8
  // src/modules/icons/components/IconPicker.tsx
9
+ /**
10
+ * A button that picks a Tabler icon from a searchable list in a popover.
11
+ * Controlled: shows `value`, and reports a pick through `onValueChange`.
12
+ */
9
13
  const IconPicker = ({ ref, value, onValueChange, ...props }) => {
10
14
  const { getIcons } = useIcons();
11
- const [_value, setValue] = useState(value);
12
15
  const [open, setOpen] = useState(false);
13
16
  const icons = Object.entries(getIcons());
14
- const selectedFirst = [...icons.filter(([key]) => key === _value), ...icons.filter(([key]) => key !== _value)];
17
+ const selectedFirst = [...icons.filter(([key]) => key === value), ...icons.filter(([key]) => key !== value)];
15
18
  return /* @__PURE__ */ jsxs(Popover, {
16
19
  open,
17
20
  onOpenChange: setOpen,
@@ -20,7 +23,7 @@ const IconPicker = ({ ref, value, onValueChange, ...props }) => {
20
23
  size: "icon",
21
24
  ref,
22
25
  ...props,
23
- children: /* @__PURE__ */ jsx(IconComponent, { name: _value })
26
+ children: /* @__PURE__ */ jsx(IconComponent, { name: value })
24
27
  }), /* @__PURE__ */ jsx(Combobox.Content, {
25
28
  className: "w-60 min-w-60",
26
29
  children: /* @__PURE__ */ jsxs(Command, { children: [/* @__PURE__ */ jsx(Command.Input, { placeholder: "Search icon..." }), /* @__PURE__ */ jsx(Command.List, {
@@ -29,12 +32,11 @@ const IconPicker = ({ ref, value, onValueChange, ...props }) => {
29
32
  className: "flex flex-wrap gap-2",
30
33
  children: selectedFirst.map(([key, Icon]) => /* @__PURE__ */ jsx(Command.Item, {
31
34
  onSelect: () => {
32
- setValue(key);
33
35
  onValueChange?.(key);
34
36
  setOpen(false);
35
37
  },
36
38
  value: key,
37
- checked: _value === key,
39
+ checked: value === key,
38
40
  children: /* @__PURE__ */ jsx(Icon, {})
39
41
  }, key))
40
42
  })
@@ -1,4 +1,5 @@
1
1
  import { ReactNode } from "react";
2
+ /** Loads the Tabler icon set in the background for `IconComponent`. */
2
3
  export declare const IconsProvider: ({ children }: {
3
4
  children: ReactNode;
4
5
  }) => ReactNode;
@@ -2,6 +2,7 @@ import { iconsState } from "../states/iconsState.js";
2
2
  import { useEffect } from "react";
3
3
  import { useSetAtom } from "jotai";
4
4
  // src/modules/icons/providers/IconsProvider.tsx
5
+ /** Loads the Tabler icon set in the background for `IconComponent`. */
5
6
  const IconsProvider = ({ children }) => {
6
7
  const setIcons = useSetAtom(iconsState);
7
8
  useEffect(() => {
@@ -1,6 +1,9 @@
1
1
  import { ValidationStatus } from "../../../types/ValidationStatus.js";
2
2
  import { IEmailFieldProps, TEmailsOnValueChange } from "../types/emailField.js";
3
- /** A record's emails: the list with a menu per email, and an input to add or edit one. */
3
+ /**
4
+ * An editable list of a record's emails, each with its own menu.
5
+ * An input adds an email or edits one.
6
+ */
4
7
  export declare const EmailListField: ({ recordId, onValueChange, onValidationStatusChange, noValidation, primaryEmail, emails, emailValidationStatus }: IEmailFieldProps & {
5
8
  /** The record the emails belong to; another record starts with the input closed. */
6
9
  recordId: string;
@@ -65,7 +65,10 @@ const EmailFieldBody = ({ emails, ...props }) => {
65
65
  input
66
66
  }, input.editing ?? "")] });
67
67
  };
68
- /** A record's emails: the list with a menu per email, and an input to add or edit one. */
68
+ /**
69
+ * An editable list of a record's emails, each with its own menu.
70
+ * An input adds an email or edits one.
71
+ */
69
72
  const EmailListField = ({ recordId, onValueChange, onValidationStatusChange, noValidation, primaryEmail, emails, emailValidationStatus }) => /* @__PURE__ */ jsx(EmailFieldBody, {
70
73
  emails: formatEmails(primaryEmail, emails, emailValidationStatus),
71
74
  onValueChange: (values) => onValueChange(toEmailFieldProps(values)),
@@ -1,5 +1,11 @@
1
1
  import React from "react";
2
+ /** The name `FullNameField` is editing, or "Unknown" when it is empty. */
2
3
  export declare const FullNameValue: () => string | React.JSX.Element;
4
+ /**
5
+ * First and last name inputs in a popover, saved when it closes.
6
+ * `children` is the trigger, such as a `RecordTableInlineCell.Trigger` showing `FullNameValue`;
7
+ * `onValueChange` gets the trimmed names.
8
+ */
3
9
  export declare const FullNameField: ({ children, firstName, lastName, onValueChange, scope }: {
4
10
  children: React.ReactNode;
5
11
  scope: string;
@@ -4,20 +4,27 @@ import { useFullNameField } from "../hooks/useFullNameField.js";
4
4
  import { PopoverScoped } from "../../hotkey/components/PopoverScoped.js";
5
5
  import { RecordTableInlineCell } from "../../record-table/components/RecordTableCellInline.js";
6
6
  import { jsx, jsxs } from "react/jsx-runtime";
7
- import { useState } from "react";
7
+ import { useMemo, useState } from "react";
8
8
  // src/modules/inputs/components/FullNameField.tsx
9
9
  const FullNameFieldProvider = ({ children, firstName, lastName, setFirstName, setLastName }) => {
10
+ const name = useMemo(() => ({
11
+ firstName,
12
+ lastName,
13
+ setFirstName,
14
+ setLastName,
15
+ fullName: `${firstName || ""}${firstName ? " " : ""}${lastName || ""}`
16
+ }), [
17
+ firstName,
18
+ lastName,
19
+ setFirstName,
20
+ setLastName
21
+ ]);
10
22
  return /* @__PURE__ */ jsx(FullNameFieldContext.Provider, {
11
- value: {
12
- firstName,
13
- lastName,
14
- setFirstName,
15
- setLastName,
16
- fullName: `${firstName || ""}${firstName ? " " : ""}${lastName || ""}`
17
- },
23
+ value: name,
18
24
  children
19
25
  });
20
26
  };
27
+ /** The name `FullNameField` is editing, or "Unknown" when it is empty. */
21
28
  const FullNameValue = () => {
22
29
  const { fullName } = useFullNameField();
23
30
  if (fullName.replace(/\s/g, "").length === 0) return /* @__PURE__ */ jsx("span", {
@@ -49,6 +56,11 @@ const FullNameFieldContent = () => {
49
56
  })]
50
57
  });
51
58
  };
59
+ /**
60
+ * First and last name inputs in a popover, saved when it closes.
61
+ * `children` is the trigger, such as a `RecordTableInlineCell.Trigger` showing `FullNameValue`;
62
+ * `onValueChange` gets the trimmed names.
63
+ */
52
64
  const FullNameField = ({ children, firstName, lastName, onValueChange, scope }) => {
53
65
  const [firstNameState, setFirstName] = useState(firstName || "");
54
66
  const [lastNameState, setLastName] = useState(lastName || "");
@@ -6,6 +6,9 @@ type PhoneFieldProps = IPhoneFieldProps & Omit<React.HTMLAttributes<HTMLDivEleme
6
6
  onValueChange: (values: IPhoneFieldProps) => void;
7
7
  onValidationStatusChange?: (status: ValidationStatus) => void;
8
8
  };
9
- /** A record's phones: the list with a menu per phone, and an input to add or edit one. */
9
+ /**
10
+ * An editable list of a record's phones, each with its own menu.
11
+ * An input adds a phone or edits one.
12
+ */
10
13
  export declare const PhoneField: ({ ref, recordId, onValueChange, onValidationStatusChange, primaryPhone, phones, phoneValidationStatus, ...props }: PhoneFieldProps & React.RefAttributes<HTMLDivElement>) => import("react").JSX.Element;
11
14
  export {};
@@ -68,7 +68,10 @@ const PhoneFieldBody = ({ phones, ...props }) => {
68
68
  input
69
69
  }, input.editing ?? "")] });
70
70
  };
71
- /** A record's phones: the list with a menu per phone, and an input to add or edit one. */
71
+ /**
72
+ * An editable list of a record's phones, each with its own menu.
73
+ * An input adds a phone or edits one.
74
+ */
72
75
  const PhoneField = ({ ref, recordId, onValueChange, onValidationStatusChange, primaryPhone, phones, phoneValidationStatus, ...props }) => /* @__PURE__ */ jsx("div", {
73
76
  ref,
74
77
  ...props,
@@ -1,4 +1,5 @@
1
1
  import { SexCode } from "../../../types/SexCode.js";
2
+ /** A searchable list to pick a sex code, for a popover or cell editor. */
2
3
  export declare const SexField: ({ value, onValueChange }: {
3
4
  value: SexCode;
4
5
  onValueChange: (value: SexCode) => void;
@@ -10,6 +10,7 @@ const SEX_CODES = [
10
10
  2,
11
11
  9
12
12
  ];
13
+ /** A searchable list to pick a sex code, for a popover or cell editor. */
13
14
  const SexField = ({ value, onValueChange }) => /* @__PURE__ */ jsxs(Command, { children: [/* @__PURE__ */ jsx(Command.Input, {}), /* @__PURE__ */ jsx(Command.List, { children: SEX_CODES.map((code) => /* @__PURE__ */ jsxs(Command.Item, {
14
15
  value: SexCodes[code].label,
15
16
  onSelect: () => onValueChange(code),
@@ -1,16 +1,16 @@
1
1
  import { ElementType, ReactNode } from "react";
2
2
  /**
3
- * A link pinned to the bottom of an app sidebar (`AppLayout` `footer`), e.g.
4
- * the plugin's own settings or the way back from them.
3
+ * A link pinned to the foot of an app sidebar, in `AppLayout`'s `footer`.
4
+ * Use it for the plugin's own settings or the way back from them.
5
5
  */
6
- export declare const AppLayoutFooterLink: ({ path, name, icon: Icon }: {
7
- path: string;
6
+ export declare const AppLayoutFooterLink: ({ to, name, icon: Icon }: {
7
+ to: string;
8
8
  name: string;
9
9
  icon?: ElementType;
10
10
  }) => import("react").JSX.Element;
11
11
  /**
12
- * Full-height layout for an app (plugin or core module) below the core top
13
- * bar: the app owns its sidebar and pages. `id` keys the persisted
12
+ * An app's full-height layout under core's top bar, with its own sidebar.
13
+ * The app, a plugin or core module, owns its sidebar and pages. `id` keys the persisted
14
14
  * open/width state, so use the plugin or module name.
15
15
  */
16
16
  export declare const AppLayout: ({ id, sidebar, footer, title, children }: {
@@ -1,5 +1,5 @@
1
1
  import { AppLayoutPageSlot } from "./AppLayoutPageSlot.js";
2
- import { AppLayoutResizeHandle, getAppLayoutAtoms } from "./AppLayoutResizeHandle.js";
2
+ import { AppLayoutResizeHandle, appLayoutOpenState, appLayoutWidthState } from "./AppLayoutResizeHandle.js";
3
3
  import { Button } from "../../../components/button.js";
4
4
  import { Separator } from "../../../components/separator.js";
5
5
  import { Sidebar } from "../../../components/sidebar.js";
@@ -30,16 +30,15 @@ const AppLayoutFooter = ({ children }) => children ? /* @__PURE__ */ jsx("div",
30
30
  children: /* @__PURE__ */ jsx(Sidebar.Menu, { children })
31
31
  }) : null;
32
32
  /**
33
- * A link pinned to the bottom of an app sidebar (`AppLayout` `footer`), e.g.
34
- * the plugin's own settings or the way back from them.
33
+ * A link pinned to the foot of an app sidebar, in `AppLayout`'s `footer`.
34
+ * Use it for the plugin's own settings or the way back from them.
35
35
  */
36
- const AppLayoutFooterLink = ({ path, name, icon: Icon }) => {
36
+ const AppLayoutFooterLink = ({ to, name, icon: Icon }) => {
37
37
  const { pathname } = useLocation();
38
- const fullPath = `/${path.replace(/^\/+/, "")}`;
39
- const isActive = pathname === fullPath || pathname.startsWith(`${fullPath}/`);
38
+ const isActive = pathname === to || pathname.startsWith(`${to}/`);
40
39
  return /* @__PURE__ */ jsx(Sidebar.MenuItem, { children: /* @__PURE__ */ jsxs(Sidebar.MenuButton, {
41
40
  isActive,
42
- render: /* @__PURE__ */ jsx(Link, { to: fullPath }),
41
+ render: /* @__PURE__ */ jsx(Link, { to }),
43
42
  children: [Icon && /* @__PURE__ */ jsx(Icon, {}), /* @__PURE__ */ jsx("span", {
44
43
  className: "min-w-0 flex-1 truncate",
45
44
  children: name
@@ -91,9 +90,9 @@ const AppLayoutSidebarHeader = ({ title, onCollapse }) => /* @__PURE__ */ jsxs("
91
90
  })]
92
91
  });
93
92
  /** Renders the persisted desktop sidebar beside the application page slot. */
94
- const AppLayoutDesktop = ({ atoms, children, footer, sidebar, title }) => {
95
- const [open, setOpen] = useAtom(atoms.open);
96
- const [width, setWidth] = useAtom(atoms.width);
93
+ const AppLayoutDesktop = ({ id, children, footer, sidebar, title }) => {
94
+ const [open, setOpen] = useAtom(appLayoutOpenState(id));
95
+ const [width, setWidth] = useAtom(appLayoutWidthState(id));
97
96
  const [resizing, setResizing] = useState(false);
98
97
  const asideRef = useRef(null);
99
98
  const currentWidth = width ?? 240;
@@ -172,15 +171,15 @@ const AppLayoutBody = (props) => {
172
171
  return isMobile ? /* @__PURE__ */ jsx(AppLayoutMobile, { ...props }) : /* @__PURE__ */ jsx(AppLayoutDesktop, { ...props });
173
172
  };
174
173
  /**
175
- * Full-height layout for an app (plugin or core module) below the core top
176
- * bar: the app owns its sidebar and pages. `id` keys the persisted
174
+ * An app's full-height layout under core's top bar, with its own sidebar.
175
+ * The app, a plugin or core module, owns its sidebar and pages. `id` keys the persisted
177
176
  * open/width state, so use the plugin or module name.
178
177
  */
179
178
  const AppLayout = ({ id, sidebar, footer, title, children }) => /* @__PURE__ */ jsx(Sidebar.Provider, {
180
179
  className: "min-h-0 flex-1",
181
180
  sidebarKeyboardShortcut: false,
182
181
  children: /* @__PURE__ */ jsx(AppLayoutBody, {
183
- atoms: getAppLayoutAtoms(id),
182
+ id,
184
183
  sidebar,
185
184
  footer,
186
185
  title,
@@ -1,20 +1,13 @@
1
1
  import { RefObject } from "react";
2
2
  export declare const APP_LAYOUT_DEFAULT_WIDTH = 240;
3
- /** Persists the sidebar visibility separately for each application layout. */
4
- declare const createOpenAtom: (id: string) => import("jotai").WritableAtom<boolean, [boolean | typeof import("jotai/utils").RESET | ((prev: boolean) => boolean | typeof import("jotai/utils").RESET)], void>;
5
- /** Persists a custom sidebar width, with null selecting the default width. */
6
- declare const createWidthAtom: (id: string) => import("jotai").WritableAtom<number | null, [number | typeof import("jotai/utils").RESET | ((prev: number | null) => number | typeof import("jotai/utils").RESET | null) | null], void>;
7
- export type TAppLayoutAtoms = {
8
- open: ReturnType<typeof createOpenAtom>;
9
- width: ReturnType<typeof createWidthAtom>;
10
- };
11
- /** Reuses the same persisted atoms for every instance of an application layout. */
12
- export declare const getAppLayoutAtoms: (id: string) => TAppLayoutAtoms;
3
+ /** Whether each app layout's sidebar is open, per layout id. */
4
+ export declare const appLayoutOpenState: import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<boolean, [boolean | typeof import("jotai/utils").RESET | ((prev: boolean) => boolean | typeof import("jotai/utils").RESET)], void>>;
5
+ /** Each app layout's dragged sidebar width; null is the default width. */
6
+ export declare const appLayoutWidthState: import("jotai-family").AtomFamily<string, import("jotai").WritableAtom<number | null, [number | typeof import("jotai/utils").RESET | ((prev: number | null) => number | typeof import("jotai/utils").RESET | null) | null], void>>;
13
7
  /** Resizes the application sidebar with pointer capture or keyboard steps. */
14
8
  export declare const AppLayoutResizeHandle: ({ panelRef, onResize, onReset, onResizingChange }: {
15
9
  panelRef: RefObject<HTMLElement | null>;
16
10
  onResize: (width: number) => void;
17
11
  onReset: () => void;
18
12
  onResizingChange: (resizing: boolean) => void;
19
- }) => import("react").JSX.Element;
20
- export {};
13
+ }) => import("react").JSX.Element;
@@ -1,27 +1,24 @@
1
+ import { storedFamily } from "../../../lib/stored.js";
1
2
  import { jsx } from "react/jsx-runtime";
2
3
  import { useRef } from "react";
3
- import { atomWithStorage } from "jotai/utils";
4
+ import { z } from "zod";
4
5
  // src/modules/layout/components/AppLayoutResizeHandle.tsx
5
6
  const APP_LAYOUT_DEFAULT_WIDTH = 240;
6
7
  const APP_LAYOUT_MIN_WIDTH = 180;
7
8
  const APP_LAYOUT_MAX_WIDTH = 480;
8
9
  const APP_LAYOUT_KEYBOARD_STEP = 16;
9
- /** Persists the sidebar visibility separately for each application layout. */
10
- const createOpenAtom = (id) => atomWithStorage(`app-layout:${id}:open`, true, void 0, { getOnInit: true });
11
- /** Persists a custom sidebar width, with null selecting the default width. */
12
- const createWidthAtom = (id) => atomWithStorage(`app-layout:${id}:width`, null, void 0, { getOnInit: true });
13
- const appLayoutAtoms = /* @__PURE__ */ new Map();
14
- /** Reuses the same persisted atoms for every instance of an application layout. */
15
- const getAppLayoutAtoms = (id) => {
16
- const existing = appLayoutAtoms.get(id);
17
- if (existing) return existing;
18
- const atoms = {
19
- open: createOpenAtom(id),
20
- width: createWidthAtom(id)
21
- };
22
- appLayoutAtoms.set(id, atoms);
23
- return atoms;
24
- };
10
+ /** Whether each app layout's sidebar is open, per layout id. */
11
+ const appLayoutOpenState = storedFamily({
12
+ key: "erxes:layout:open",
13
+ schema: z.boolean(),
14
+ initial: true
15
+ });
16
+ /** Each app layout's dragged sidebar width; null is the default width. */
17
+ const appLayoutWidthState = storedFamily({
18
+ key: "erxes:layout:width",
19
+ schema: z.number().min(APP_LAYOUT_MIN_WIDTH).max(APP_LAYOUT_MAX_WIDTH).nullable(),
20
+ initial: null
21
+ });
25
22
  /** Keeps a resized pane within its configured width limits. */
26
23
  const clampWidth = (value) => Math.round(Math.min(APP_LAYOUT_MAX_WIDTH, Math.max(APP_LAYOUT_MIN_WIDTH, value)));
27
24
  /** Resizes the application sidebar with pointer capture or keyboard steps. */
@@ -67,4 +64,4 @@ const AppLayoutResizeHandle = ({ panelRef, onResize, onReset, onResizingChange }
67
64
  children: /* @__PURE__ */ jsx("span", { className: "absolute inset-y-0 right-0 w-0.5 bg-transparent transition-colors duration-150 group-hover/resize:bg-primary/40 group-focus-visible/resize:bg-primary group-active/resize:bg-primary" })
68
65
  });
69
66
  };
70
- export { APP_LAYOUT_DEFAULT_WIDTH, AppLayoutResizeHandle, getAppLayoutAtoms };
67
+ export { APP_LAYOUT_DEFAULT_WIDTH, AppLayoutResizeHandle, appLayoutOpenState, appLayoutWidthState };
@@ -1,10 +1,15 @@
1
1
  import React from "react";
2
2
  import { VariantProps } from "class-variance-authority";
3
+ /** A page's outer box, full height, with `PageHeader` first inside it. */
3
4
  export declare const PageContainer: ({ ref, children, className, ...props }: React.HTMLAttributes<HTMLDivElement> & {
4
5
  children?: React.ReactNode;
5
6
  } & React.RefAttributes<HTMLDivElement>) => React.JSX.Element;
6
7
  declare const pageSubHeaderVariants: (props?: ({
7
8
  variant?: "default" | "flush" | null | undefined;
8
9
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
10
+ /**
11
+ * A bar under the page header with a rule below it, for tabs or controls.
12
+ * `variant="flush"` drops its padding so tabs reach the rule. A list's bar is `ViewBar`.
13
+ */
9
14
  export declare const PageSubHeader: ({ ref, className, variant, ...props }: React.ComponentProps<'div'> & VariantProps<typeof pageSubHeaderVariants>) => React.JSX.Element;
10
15
  export {};
@@ -3,6 +3,7 @@ import { jsx } from "react/jsx-runtime";
3
3
  import "react";
4
4
  import { cva } from "class-variance-authority";
5
5
  // src/modules/layout/components/Page.tsx
6
+ /** A page's outer box, full height, with `PageHeader` first inside it. */
6
7
  const PageContainer = ({ ref, children, className, ...props }) => {
7
8
  return /* @__PURE__ */ jsx("div", {
8
9
  ref,
@@ -18,6 +19,10 @@ const pageSubHeaderVariants = cva("flex h-auto flex-none gap-3 border-b bg-backg
18
19
  } },
19
20
  defaultVariants: { variant: "default" }
20
21
  });
22
+ /**
23
+ * A bar under the page header with a rule below it, for tabs or controls.
24
+ * `variant="flush"` drops its padding so tabs reach the rule. A list's bar is `ViewBar`.
25
+ */
21
26
  const PageSubHeader = ({ ref, className, variant, ...props }) => {
22
27
  return /* @__PURE__ */ jsx("div", {
23
28
  ref,
@@ -12,7 +12,10 @@ declare const pageHeaderStartVariants: (props?: ({
12
12
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
13
13
  declare const PageHeaderStart: ({ ref, children, className, variant, ...props }: React.ComponentProps<'div'> & VariantProps<typeof pageHeaderStartVariants>) => import("react").JSX.Element;
14
14
  declare const PageHeaderEnd: ({ ref, children, className, ...props }: React.ComponentProps<'div'>) => import("react").JSX.Element;
15
- /** A page's title bar: `PageHeader.Start` holds the title, `PageHeader.End` the actions. */
15
+ /**
16
+ * A page's title bar, with the breadcrumb and its one primary action.
17
+ * `PageHeader.Start` holds the title, `PageHeader.End` the actions.
18
+ */
16
19
  export declare const PageHeader: typeof PageHeaderRoot & {
17
20
  Start: typeof PageHeaderStart;
18
21
  End: typeof PageHeaderEnd;
@@ -40,7 +40,10 @@ const PageHeaderEnd = ({ ref, children, className, ...props }) => /* @__PURE__ *
40
40
  ...props,
41
41
  children
42
42
  });
43
- /** A page's title bar: `PageHeader.Start` holds the title, `PageHeader.End` the actions. */
43
+ /**
44
+ * A page's title bar, with the breadcrumb and its one primary action.
45
+ * `PageHeader.Start` holds the title, `PageHeader.End` the actions.
46
+ */
44
47
  const PageHeader = Object.assign(PageHeaderRoot, {
45
48
  Start: PageHeaderStart,
46
49
  End: PageHeaderEnd
@@ -0,0 +1,37 @@
1
+ import { Icon } from "@tabler/icons-react";
2
+ /**
3
+ * How a list shows its records: grouped rows, a table or a board.
4
+ * Grouped rows are `RecordList`; a board shows cards.
5
+ */
6
+ export type TListDisplay = 'list' | 'table' | 'board';
7
+ /**
8
+ * A list's own display, such as a cards grid or a chart.
9
+ * It shows in `DisplayMenu` beside the built-in ones:
10
+ * `{ key: 'cards', label: t('cards', 'Cards'), icon: IconLayoutGrid }`. The list renders it
11
+ * when `useListDisplay` returns its `key`.
12
+ */
13
+ export interface TListDisplayOption<K extends string = string> {
14
+ key: K;
15
+ label: string;
16
+ icon: Icon;
17
+ }
18
+ /** The displays a list offers, in the menu's order; the first shows until one is chosen. */
19
+ type ListDisplays<K extends string> = readonly [TListDisplay | TListDisplayOption<K>, ...(TListDisplay | TListDisplayOption<K>)[]];
20
+ /**
21
+ * The display a list shows, as picked in its Display menu.
22
+ * `const [display] = useListDisplay('sales-deals')`. The choice is remembered in this browser,
23
+ * one per list. Give it the same `displays` as the list's `DisplayMenu`; a list's own display
24
+ * comes back as its `key`.
25
+ */
26
+ export declare const useListDisplay: <const K extends string = never>(list: string, displays?: ListDisplays<K>) => readonly [K | TListDisplay, (args_0: string | typeof import("jotai/utils").RESET | ((prev: string | null) => string | typeof import("jotai/utils").RESET | null) | null) => void];
27
+ /**
28
+ * The Display menu in a list's filter bar: table, board, list or its own.
29
+ * It offers table or board, or the `displays` the list offers, such as
30
+ * `['list', 'board', 'table']`, or the list's own (`TListDisplayOption`) among them:
31
+ * `[{ key: 'cards', label, icon }, 'table']`. `useListDisplay(list, displays)` reads the choice.
32
+ */
33
+ export declare const DisplayMenu: <const K extends string = never>({ list, displays }: {
34
+ list: string;
35
+ displays?: ListDisplays<K>;
36
+ }) => import("react").JSX.Element;
37
+ export {};