@erxes/ui 4.0.0-v2.1 → 4.0.0-v2.11

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 (318) hide show
  1. package/AGENTS.md +58 -0
  2. package/CATALOG.md +251 -0
  3. package/README.md +25 -2
  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 +6 -0
  26. package/dist/components/charts.js +12 -3
  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 +13 -6
  35. package/dist/components/combobox.d.ts +6 -1
  36. package/dist/components/combobox.js +9 -1
  37. package/dist/components/command-bar.d.ts +4 -0
  38. package/dist/components/command-bar.js +4 -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 +4 -0
  52. package/dist/components/dialog.js +5 -1
  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/form.d.ts +6 -2
  60. package/dist/components/form.js +8 -2
  61. package/dist/components/hover-card.d.ts +1 -0
  62. package/dist/components/hover-card.js +1 -0
  63. package/dist/components/icon-tip.d.ts +7 -0
  64. package/dist/components/icon-tip.js +16 -0
  65. package/dist/components/info-card.d.ts +4 -0
  66. package/dist/components/info-card.js +4 -0
  67. package/dist/components/input-group.d.ts +5 -4
  68. package/dist/components/input-group.js +5 -4
  69. package/dist/components/input.d.ts +1 -0
  70. package/dist/components/input.js +1 -0
  71. package/dist/components/kbd.d.ts +2 -1
  72. package/dist/components/kbd.js +2 -1
  73. package/dist/components/label.d.ts +1 -1
  74. package/dist/components/label.js +1 -1
  75. package/dist/components/multiselect.d.ts +1 -0
  76. package/dist/components/multiselect.js +3 -2
  77. package/dist/components/on-demand.d.ts +6 -0
  78. package/dist/components/on-demand.js +6 -0
  79. package/dist/components/popover.d.ts +4 -0
  80. package/dist/components/popover.js +4 -0
  81. package/dist/components/radio-group.d.ts +1 -0
  82. package/dist/components/radio-group.js +1 -0
  83. package/dist/components/scroll-area.d.ts +1 -0
  84. package/dist/components/scroll-area.js +1 -0
  85. package/dist/components/select.d.ts +5 -1
  86. package/dist/components/select.js +7 -1
  87. package/dist/components/separator.d.ts +4 -0
  88. package/dist/components/separator.js +4 -0
  89. package/dist/components/sheet.d.ts +4 -0
  90. package/dist/components/sheet.js +8 -4
  91. package/dist/components/sidebar/panel.js +29 -7
  92. package/dist/components/sidebar.d.ts +1 -0
  93. package/dist/components/sidebar.js +1 -0
  94. package/dist/components/skeleton.d.ts +1 -0
  95. package/dist/components/skeleton.js +1 -0
  96. package/dist/components/spinner.d.ts +1 -0
  97. package/dist/components/spinner.js +1 -0
  98. package/dist/components/string-array.js +1 -0
  99. package/dist/components/switch.d.ts +1 -0
  100. package/dist/components/switch.js +1 -0
  101. package/dist/components/table.d.ts +4 -0
  102. package/dist/components/table.js +4 -0
  103. package/dist/components/tabs.d.ts +8 -1
  104. package/dist/components/tabs.js +8 -1
  105. package/dist/components/text-overflow.d.ts +4 -1
  106. package/dist/components/text-overflow.js +4 -1
  107. package/dist/components/textarea.d.ts +1 -0
  108. package/dist/components/textarea.js +1 -0
  109. package/dist/components/toaster.d.ts +4 -1
  110. package/dist/components/toaster.js +5 -2
  111. package/dist/components/toggle-group.d.ts +5 -0
  112. package/dist/components/toggle-group.js +19 -11
  113. package/dist/components/toggle.d.ts +1 -0
  114. package/dist/components/toggle.js +1 -0
  115. package/dist/components/tooltip.d.ts +4 -0
  116. package/dist/components/tooltip.js +4 -0
  117. package/dist/components/upload.d.ts +4 -0
  118. package/dist/components/upload.js +20 -11
  119. package/dist/federation.d.ts +8 -1
  120. package/dist/federation.js +12 -2
  121. package/dist/hooks/use-item-keys.d.ts +11 -0
  122. package/dist/hooks/use-item-keys.js +24 -0
  123. package/dist/hooks/use-page-hotkey.d.ts +12 -0
  124. package/dist/hooks/use-page-hotkey.js +22 -0
  125. package/dist/hooks/use-toast.d.ts +5 -0
  126. package/dist/hooks/use-toast.js +5 -0
  127. package/dist/index.d.ts +33 -6
  128. package/dist/index.js +31 -4
  129. package/dist/lib/format.d.ts +60 -0
  130. package/dist/lib/format.js +86 -0
  131. package/dist/lib/money.d.ts +13 -0
  132. package/dist/lib/money.js +21 -0
  133. package/dist/lib/stored.d.ts +13 -0
  134. package/dist/lib/stored.js +41 -0
  135. package/dist/lib/text.d.ts +11 -0
  136. package/dist/lib/text.js +18 -0
  137. package/dist/modules/attachments/use-carousel.js +5 -10
  138. package/dist/modules/blocks/hooks/useBarcodeSizeForm.d.ts +1 -1
  139. package/dist/modules/blocks/utils/parseBlocks.d.ts +1 -1
  140. package/dist/modules/blocks/utils/parseBlocks.js +1 -1
  141. package/dist/modules/conditions/ConditionValueInput.d.ts +10 -0
  142. package/dist/modules/conditions/ConditionValueInput.js +166 -0
  143. package/dist/modules/conditions/ConditionsEditor.d.ts +11 -0
  144. package/dist/modules/conditions/ConditionsEditor.js +209 -0
  145. package/dist/modules/conditions/LazyConditionsEditor.d.ts +10 -0
  146. package/dist/modules/conditions/LazyConditionsEditor.js +11 -0
  147. package/dist/modules/conditions/PathPicker.d.ts +8 -0
  148. package/dist/modules/conditions/PathPicker.js +51 -0
  149. package/dist/modules/conditions/conditions.d.ts +66 -0
  150. package/dist/modules/conditions/conditions.js +136 -0
  151. package/dist/modules/display/components/EmailDisplay.d.ts +4 -0
  152. package/dist/modules/display/components/EmailDisplay.js +6 -3
  153. package/dist/modules/display/components/PhoneDisplay.d.ts +4 -0
  154. package/dist/modules/display/components/PhoneDisplay.js +4 -0
  155. package/dist/modules/display/components/RelativeDateDisplay.d.ts +7 -5
  156. package/dist/modules/display/components/RelativeDateDisplay.js +10 -8
  157. package/dist/modules/display/components/SexDisplay.d.ts +1 -0
  158. package/dist/modules/display/components/SexDisplay.js +1 -0
  159. package/dist/modules/filter/components/Filter.d.ts +4 -0
  160. package/dist/modules/filter/components/Filter.js +4 -0
  161. package/dist/modules/filter/components/FilterBar.js +5 -7
  162. package/dist/modules/filter/components/FilterDialog.js +4 -5
  163. package/dist/modules/filter/components/FilterPopover.js +1 -1
  164. package/dist/modules/filter/components/FilterProvider.d.ts +1 -2
  165. package/dist/modules/filter/components/FilterProvider.js +22 -16
  166. package/dist/modules/filter/hooks/useFilterContext.d.ts +1 -0
  167. package/dist/modules/filter/hooks/useFilterContext.js +1 -0
  168. package/dist/modules/filter/types/filter.d.ts +0 -1
  169. package/dist/modules/hotkey/components/PopoverScoped.d.ts +5 -0
  170. package/dist/modules/hotkey/components/PopoverScoped.js +5 -0
  171. package/dist/modules/hotkey/hooks/usePreviousHotkeyScope.d.ts +1 -0
  172. package/dist/modules/hotkey/hooks/usePreviousHotkeyScope.js +1 -0
  173. package/dist/modules/hotkey/hooks/useScopedHotkeys.d.ts +5 -1
  174. package/dist/modules/hotkey/hooks/useScopedHotkeys.js +5 -1
  175. package/dist/modules/icons/components/IconComponent.d.ts +4 -0
  176. package/dist/modules/icons/components/IconComponent.js +4 -0
  177. package/dist/modules/icons/components/IconPicker.d.ts +4 -0
  178. package/dist/modules/icons/components/IconPicker.js +7 -5
  179. package/dist/modules/icons/providers/IconsProvider.d.ts +1 -0
  180. package/dist/modules/icons/providers/IconsProvider.js +1 -0
  181. package/dist/modules/inputs/components/EmailField.d.ts +4 -1
  182. package/dist/modules/inputs/components/EmailField.js +4 -1
  183. package/dist/modules/inputs/components/FullNameField.d.ts +6 -0
  184. package/dist/modules/inputs/components/FullNameField.js +20 -8
  185. package/dist/modules/inputs/components/PhoneField.d.ts +4 -1
  186. package/dist/modules/inputs/components/PhoneField.js +4 -1
  187. package/dist/modules/inputs/components/SexField.d.ts +1 -0
  188. package/dist/modules/inputs/components/SexField.js +1 -0
  189. package/dist/modules/layout/components/AppLayout.d.ts +6 -6
  190. package/dist/modules/layout/components/AppLayout.js +12 -13
  191. package/dist/modules/layout/components/AppLayoutResizeHandle.d.ts +5 -12
  192. package/dist/modules/layout/components/AppLayoutResizeHandle.js +15 -18
  193. package/dist/modules/layout/components/Page.d.ts +5 -0
  194. package/dist/modules/layout/components/Page.js +5 -0
  195. package/dist/modules/layout/components/PageHeader.d.ts +4 -1
  196. package/dist/modules/layout/components/PageHeader.js +9 -3
  197. package/dist/modules/list/DisplayMenu.d.ts +24 -0
  198. package/dist/modules/list/DisplayMenu.js +87 -0
  199. package/dist/modules/list/ListFilter.d.ts +63 -0
  200. package/dist/modules/list/ListFilter.js +44 -0
  201. package/dist/modules/list/ViewBar.d.ts +13 -0
  202. package/dist/modules/list/ViewBar.js +30 -0
  203. package/dist/modules/list/filter/AdvancedFilterDialog.d.ts +5 -0
  204. package/dist/modules/list/filter/AdvancedFilterDialog.js +52 -0
  205. package/dist/modules/list/filter/FieldMenus.d.ts +5 -0
  206. package/dist/modules/list/filter/FieldMenus.js +184 -0
  207. package/dist/modules/list/filter/ListFilterBar.d.ts +6 -0
  208. package/dist/modules/list/filter/ListFilterBar.js +246 -0
  209. package/dist/modules/list/filter/RecordCount.d.ts +7 -0
  210. package/dist/modules/list/filter/RecordCount.js +22 -0
  211. package/dist/modules/list/filter/RuleChips.d.ts +2 -0
  212. package/dist/modules/list/filter/RuleChips.js +157 -0
  213. package/dist/modules/list/filter/fieldIcons.d.ts +7 -0
  214. package/dist/modules/list/filter/fieldIcons.js +16 -0
  215. package/dist/modules/list/filter/filterRules.d.ts +46 -0
  216. package/dist/modules/list/filter/filterRules.js +166 -0
  217. package/dist/modules/list/filter/listFilterContext.d.ts +29 -0
  218. package/dist/modules/list/filter/listFilterContext.js +34 -0
  219. package/dist/modules/list/filter/listFilterQuery.d.ts +16 -0
  220. package/dist/modules/list/filter/listFilterQuery.js +22 -0
  221. package/dist/modules/navigation-menu/components/NavigationMenu.d.ts +4 -3
  222. package/dist/modules/navigation-menu/components/NavigationMenu.js +7 -7
  223. package/dist/modules/pickers/EntityPicker.d.ts +37 -0
  224. package/dist/modules/pickers/EntityPicker.js +67 -0
  225. package/dist/modules/pickers/LookupPicker.d.ts +51 -0
  226. package/dist/modules/pickers/LookupPicker.js +84 -0
  227. package/dist/modules/pickers/SelectMember.d.ts +41 -0
  228. package/dist/modules/pickers/SelectMember.js +122 -0
  229. package/dist/modules/pickers/members.d.ts +30 -0
  230. package/dist/modules/pickers/members.js +18 -0
  231. package/dist/modules/record-field/components/NumberField.d.ts +5 -0
  232. package/dist/modules/record-field/components/NumberField.js +14 -7
  233. package/dist/modules/record-field/components/TextField.d.ts +4 -0
  234. package/dist/modules/record-field/components/TextField.js +14 -3
  235. package/dist/modules/record-field/meta-inputs/components/PhoneInput.d.ts +5 -0
  236. package/dist/modules/record-field/meta-inputs/components/PhoneInput.js +5 -0
  237. package/dist/modules/record-list/RecordList.d.ts +18 -0
  238. package/dist/modules/record-list/RecordList.js +23 -0
  239. package/dist/modules/record-list/RecordListProvider.d.ts +30 -0
  240. package/dist/modules/record-list/RecordListProvider.js +57 -0
  241. package/dist/modules/record-list/RecordListRoot.d.ts +28 -0
  242. package/dist/modules/record-list/RecordListRoot.js +124 -0
  243. package/dist/modules/record-list/selection.d.ts +22 -0
  244. package/dist/modules/record-list/selection.js +54 -0
  245. package/dist/modules/record-panel/PanelDescriptionEditor.d.ts +9 -0
  246. package/dist/modules/record-panel/PanelDescriptionEditor.js +39 -0
  247. package/dist/modules/record-panel/PanelDescriptionField.d.ts +13 -0
  248. package/dist/modules/record-panel/PanelDescriptionField.js +39 -0
  249. package/dist/modules/record-panel/PanelField.d.ts +17 -0
  250. package/dist/modules/record-panel/PanelField.js +47 -0
  251. package/dist/modules/record-panel/PanelForm.d.ts +28 -0
  252. package/dist/modules/record-panel/PanelForm.js +88 -0
  253. package/dist/modules/record-panel/PanelLabel.d.ts +10 -0
  254. package/dist/modules/record-panel/PanelLabel.js +55 -0
  255. package/dist/modules/record-panel/PanelSection.d.ts +12 -0
  256. package/dist/modules/record-panel/PanelSection.js +24 -0
  257. package/dist/modules/record-panel/panelExpansion.d.ts +10 -0
  258. package/dist/modules/record-panel/panelExpansion.js +7 -0
  259. package/dist/modules/record-panel/useSaveOnLeave.d.ts +14 -0
  260. package/dist/modules/record-panel/useSaveOnLeave.js +42 -0
  261. package/dist/modules/record-table/components/RecordTable.d.ts +6 -0
  262. package/dist/modules/record-table/components/RecordTable.js +6 -0
  263. package/dist/modules/record-table/components/RecordTableCell.d.ts +9 -0
  264. package/dist/modules/record-table/components/RecordTableCell.js +16 -2
  265. package/dist/modules/record-table/components/RecordTableCellInline.d.ts +5 -0
  266. package/dist/modules/record-table/components/RecordTableCellInline.js +8 -7
  267. package/dist/modules/record-table/components/RecordTableCursor.js +30 -28
  268. package/dist/modules/record-table/components/RecordTableProvider.js +12 -7
  269. package/dist/modules/record-table/hooks/useTablePreferences.d.ts +1 -1
  270. package/dist/modules/record-table/hooks/useTablePreferences.js +18 -31
  271. package/dist/modules/record-table/states/RecordTableCursorState.d.ts +21 -1
  272. package/dist/modules/record-table/states/RecordTableCursorState.js +21 -3
  273. package/dist/modules/record-table/types/RecordTableCursorTypes.d.ts +1 -0
  274. package/dist/modules/record-table/types/RecordTableCursorTypes.js +1 -0
  275. package/dist/modules/records/ContactLink.d.ts +13 -0
  276. package/dist/modules/records/ContactLink.js +77 -0
  277. package/dist/modules/records/contacts.d.ts +35 -0
  278. package/dist/modules/records/contacts.js +10 -0
  279. package/dist/modules/records/openRecord.d.ts +44 -0
  280. package/dist/modules/records/openRecord.js +48 -0
  281. package/dist/state/sidebarPanelState.d.ts +5 -1
  282. package/dist/state/sidebarPanelState.js +11 -3
  283. package/dist/state/themeState.d.ts +13 -2
  284. package/dist/state/themeState.js +18 -4
  285. package/dist/theme.css +5 -2
  286. package/dist/types/SexCode.d.ts +1 -0
  287. package/dist/types/SexCode.js +1 -0
  288. package/dist/types/UIConfig.d.ts +131 -3
  289. package/dist/utils/IsUndefinedOrNull.d.ts +1 -0
  290. package/dist/utils/IsUndefinedOrNull.js +1 -0
  291. package/dist/utils/file-storage.d.ts +1 -0
  292. package/dist/utils/file-storage.js +1 -0
  293. package/dist/utils/format/formatPhoneNumber.d.ts +4 -0
  294. package/dist/utils/format/formatPhoneNumber.js +4 -0
  295. package/dist/utils/getPluginAssetsUrl.d.ts +5 -0
  296. package/dist/utils/getPluginAssetsUrl.js +5 -0
  297. package/dist/utils/host-component.d.ts +10 -0
  298. package/dist/utils/host-component.js +34 -0
  299. package/dist/utils/json.d.ts +3 -2
  300. package/dist/utils/json.js +3 -2
  301. package/dist/utils/plugin-runtime.d.ts +21 -17
  302. package/dist/utils/plugin-runtime.js +59 -12
  303. package/dist/utils/plugin-styles.d.ts +7 -0
  304. package/dist/utils/plugin-styles.js +54 -0
  305. package/dist/utils/record-timeline.d.ts +10 -9
  306. package/dist/utils/record-timeline.js +12 -17
  307. package/exports.txt +226 -0
  308. package/package.json +13 -3
  309. package/dist/constants/IntlLanguages.d.ts +0 -74
  310. package/dist/constants/IntlLanguages.js +0 -76
  311. package/dist/hooks/use-query-state.d.ts +0 -16
  312. package/dist/hooks/use-query-state.js +0 -122
  313. package/dist/modules/filter/hooks/useFilterQueryState.d.ts +0 -4
  314. package/dist/modules/filter/hooks/useFilterQueryState.js +0 -14
  315. package/dist/types/Theme.d.ts +0 -1
  316. package/dist/types/Theme.js +0 -0
  317. package/dist/utils/localization/formatDateISOStringToRelativeDate.d.ts +0 -2
  318. package/dist/utils/localization/formatDateISOStringToRelativeDate.js +0 -16
@@ -16,13 +16,12 @@ const EmailChip = ({ item, email, onEmailClick, onEmailDoubleClick, onEmailKeyAc
16
16
  className: "min-w-0",
17
17
  children: /* @__PURE__ */ jsx(EmailText, { ...item })
18
18
  });
19
- return /* @__PURE__ */ jsx("span", {
19
+ return /* @__PURE__ */ jsx("button", {
20
+ type: "button",
20
21
  className: cn(buttonVariants({
21
22
  size: "sm",
22
23
  variant: "secondary"
23
24
  }), "min-w-0 max-w-full h-6 w-fit rounded-sm border gap-1 cursor-pointer hover:bg-primary/10 hover:text-primary-text focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring"),
24
- role: "button",
25
- tabIndex: 0,
26
25
  onClick: (event) => {
27
26
  event.stopPropagation();
28
27
  onEmailClick(email);
@@ -40,6 +39,10 @@ const EmailChip = ({ item, email, onEmailClick, onEmailDoubleClick, onEmailKeyAc
40
39
  children: /* @__PURE__ */ jsx(EmailText, { ...item })
41
40
  });
42
41
  };
42
+ /**
43
+ * A record's emails as chips, the primary one with its validation mark.
44
+ * `maxVisible` shows that many and a +N badge for the rest; `onEmailClick` makes each a button.
45
+ */
43
46
  const EmailDisplay = ({ maxVisible, primaryEmail, emails, emailValidationStatus, ...handlers }) => {
44
47
  const values = formatEmails(primaryEmail, emails, emailValidationStatus).filter((item) => item.email);
45
48
  const visible = maxVisible === void 0 ? values : values.slice(0, maxVisible);
@@ -1,4 +1,8 @@
1
1
  import { IPhoneFieldProps } from "../../inputs/types/phoneField.js";
2
+ /**
3
+ * A record's phones as chips, the primary one with its validation mark.
4
+ * `maxVisible` shows that many and a +N badge for the rest.
5
+ */
2
6
  export declare const PhoneDisplay: ({ maxVisible, primaryPhone, phones, phoneValidationStatus }: IPhoneFieldProps & {
3
7
  maxVisible?: number;
4
8
  }) => import("react").JSX.Element;
@@ -5,6 +5,10 @@ import { formatPhoneNumber } from "../../../utils/format/formatPhoneNumber.js";
5
5
  import { IconCircleDashed, IconCircleDashedCheck } from "@tabler/icons-react";
6
6
  import { jsx, jsxs } from "react/jsx-runtime";
7
7
  // src/modules/display/components/PhoneDisplay.tsx
8
+ /**
9
+ * A record's phones as chips, the primary one with its validation mark.
10
+ * `maxVisible` shows that many and a +N badge for the rest.
11
+ */
8
12
  const PhoneDisplay = ({ maxVisible, primaryPhone, phones, phoneValidationStatus }) => {
9
13
  const values = formatPhones(primaryPhone, phones, phoneValidationStatus).filter((item) => item.phone);
10
14
  const visible = maxVisible === void 0 ? values : values.slice(0, maxVisible);
@@ -1,14 +1,16 @@
1
1
  import { Tooltip } from "../../../components/tooltip.js";
2
2
  import React from "react";
3
3
  import { Except } from "type-fest";
4
- type RelativeDateDisplayProps = {
5
- value: string;
6
- isShort?: boolean;
7
- };
8
4
  declare const RelativeDateDisplayTooltip: ({ value, ...props }: Except<React.ComponentProps<typeof Tooltip.Trigger>, 'value'> & {
9
5
  value: string;
10
6
  }) => React.JSX.Element | null;
11
- declare const RelativeDateDisplayValue: ({ value, isShort }: RelativeDateDisplayProps) => string | null;
7
+ declare const RelativeDateDisplayValue: ({ value }: {
8
+ value: string;
9
+ }) => string | null;
10
+ /**
11
+ * A date as how long ago it was, with the date and time on hover.
12
+ * `RelativeDateDisplay.Value` is the text alone.
13
+ */
12
14
  export declare const RelativeDateDisplay: typeof RelativeDateDisplayTooltip & {
13
15
  Value: typeof RelativeDateDisplayValue;
14
16
  };
@@ -1,23 +1,25 @@
1
1
  import { Tooltip } from "../../../components/tooltip.js";
2
+ import { useFormat } from "../../../lib/format.js";
2
3
  import { isUndefinedOrNull } from "../../../utils/IsUndefinedOrNull.js";
3
- import { formatDateISOStringToRelativeDate, formatDateISOStringToRelativeDateShort } from "../../../utils/localization/formatDateISOStringToRelativeDate.js";
4
4
  import { jsx, jsxs } from "react/jsx-runtime";
5
5
  import "react";
6
- import { format } from "date-fns";
7
6
  // src/modules/display/components/RelativeDateDisplay.tsx
8
7
  const RelativeDateDisplayTooltip = ({ value, ...props }) => {
8
+ const fmt = useFormat();
9
9
  if (isUndefinedOrNull(value)) return null;
10
10
  return /* @__PURE__ */ jsxs(Tooltip, { children: [/* @__PURE__ */ jsx(Tooltip.Trigger, {
11
11
  delay: 100,
12
12
  className: "truncate",
13
13
  ...props
14
- }), /* @__PURE__ */ jsx(Tooltip.Content, { children: format(value, "MMM dd, yyyy HH:mm") })] });
14
+ }), /* @__PURE__ */ jsx(Tooltip.Content, { children: fmt.dateTime(value) })] });
15
15
  };
16
- const RelativeDateDisplayValue = ({ value, isShort }) => {
17
- if (isUndefinedOrNull(value)) return null;
18
- const relativeDate = formatDateISOStringToRelativeDate(value);
19
- const relativeDateShort = formatDateISOStringToRelativeDateShort(value);
20
- return isShort ? relativeDateShort : relativeDate;
16
+ const RelativeDateDisplayValue = ({ value }) => {
17
+ const fmt = useFormat();
18
+ return isUndefinedOrNull(value) ? null : fmt.relative(value);
21
19
  };
20
+ /**
21
+ * A date as how long ago it was, with the date and time on hover.
22
+ * `RelativeDateDisplay.Value` is the text alone.
23
+ */
22
24
  const RelativeDateDisplay = Object.assign(RelativeDateDisplayTooltip, { Value: RelativeDateDisplayValue });
23
25
  export { RelativeDateDisplay };
@@ -1,4 +1,5 @@
1
1
  import { SexCode } from "../../../types/SexCode.js";
2
+ /** A sex code as its label, or nothing when it is not known. */
2
3
  export declare const SexDisplay: ({ value }: {
3
4
  value?: SexCode;
4
5
  }) => string;
@@ -1,5 +1,6 @@
1
1
  import { SexCodes } from "../../../constants/SexCodes.js";
2
2
  import "../../../types/SexCode.js";
3
3
  // src/modules/display/components/SexDisplay.tsx
4
+ /** A sex code as its label, or nothing when it is not known. */
4
5
  const SexDisplay = ({ value = 0 }) => value === 0 ? "" : SexCodes[value].label;
5
6
  export { SexDisplay };
@@ -2,6 +2,10 @@ import { FilterBar, FilterBarButton, FilterBarCloseButton, FilterBarItem, Filter
2
2
  import { FilterDialog, FilterDialogStringView } from "./FilterDialog.js";
3
3
  import { FilterCommandInput, FilterCommandItem, FilterItem, FilterPopover, FilterSearchValueTrigger, FilterTrigger, FilterView } from "./FilterPopover.js";
4
4
  import { FilterProvider } from "./FilterProvider.js";
5
+ /**
6
+ * Parts of a filter popover and bar, which `ListFilter` is built from.
7
+ * A list page uses `ListFilter`; reach for these parts only for a filter it can't draw.
8
+ */
5
9
  export declare const Filter: typeof FilterProvider & {
6
10
  Trigger: typeof FilterTrigger;
7
11
  Popover: typeof FilterPopover;
@@ -3,6 +3,10 @@ import { FilterDialog, FilterDialogStringView } from "./FilterDialog.js";
3
3
  import { FilterCommandInput, FilterCommandItem, FilterItem, FilterPopover, FilterSearchValueTrigger, FilterTrigger, FilterView } from "./FilterPopover.js";
4
4
  import { FilterProvider } from "./FilterProvider.js";
5
5
  // src/modules/filter/components/Filter.tsx
6
+ /**
7
+ * Parts of a filter popover and bar, which `ListFilter` is built from.
8
+ * A list page uses `ListFilter`; reach for these parts only for a filter it can't draw.
9
+ */
6
10
  const Filter = Object.assign(FilterProvider, {
7
11
  Trigger: FilterTrigger,
8
12
  Popover: FilterPopover,
@@ -1,12 +1,10 @@
1
1
  import { Button } from "../../../components/button.js";
2
- import { useRemoveQueryStateByKey } from "../../../hooks/use-query-state.js";
3
2
  import { cn } from "../../../lib/utils.js";
4
3
  import { useFilterContext } from "../hooks/useFilterContext.js";
5
- import { useFilterQueryState } from "../hooks/useFilterQueryState.js";
6
4
  import { IconSearch, IconX } from "@tabler/icons-react";
7
5
  import { jsx, jsxs } from "react/jsx-runtime";
8
6
  import "react";
9
- import { z } from "zod";
7
+ import { useQueryState } from "nuqs";
10
8
  // src/modules/filter/components/FilterBar.tsx
11
9
  const FilterBar = ({ ref, className, ...props }) => {
12
10
  return /* @__PURE__ */ jsx("div", {
@@ -16,19 +14,19 @@ const FilterBar = ({ ref, className, ...props }) => {
16
14
  });
17
15
  };
18
16
  const FilterBarCloseButton = ({ ref, className, filterKey, ...props }) => {
19
- const removeQuery = useRemoveQueryStateByKey();
17
+ const [, setQuery] = useQueryState(filterKey ?? "");
20
18
  return /* @__PURE__ */ jsx(Button, {
21
19
  ref,
22
20
  variant: "segment",
23
21
  size: "icon",
24
22
  className,
25
- onClick: () => removeQuery(filterKey ?? ""),
23
+ onClick: () => void setQuery(null),
26
24
  ...props,
27
25
  children: /* @__PURE__ */ jsx(IconX, {})
28
26
  });
29
27
  };
30
28
  const FilterBarItem = ({ ref, className, queryKey, children, ...props }) => {
31
- const [query] = useFilterQueryState(queryKey || "root", z.string());
29
+ const [query] = useQueryState(queryKey || "root");
32
30
  if (queryKey && !query) return null;
33
31
  return /* @__PURE__ */ jsxs("div", {
34
32
  ref,
@@ -60,7 +58,7 @@ const FilterBarButton = ({ ref, className, inDialog, filterKey, ...props }) => {
60
58
  });
61
59
  };
62
60
  const FilterSearchValueBarItem = () => {
63
- const [searchValue] = useFilterQueryState("searchValue", z.string());
61
+ const [searchValue] = useQueryState("searchValue");
64
62
  return /* @__PURE__ */ jsxs(FilterBarItem, {
65
63
  queryKey: "searchValue",
66
64
  children: [/* @__PURE__ */ jsxs(FilterBarName, { children: [/* @__PURE__ */ jsx(IconSearch, {}), "Search"] }), /* @__PURE__ */ jsx(FilterBarButton, {
@@ -2,13 +2,12 @@ import { Button } from "../../../components/button.js";
2
2
  import { Dialog } from "../../../components/dialog.js";
3
3
  import { Input } from "../../../components/input.js";
4
4
  import { useFilterContext } from "../hooks/useFilterContext.js";
5
- import { useFilterQueryState } from "../hooks/useFilterQueryState.js";
6
5
  import { openDialogState } from "../states/filterStates.js";
7
6
  import { jsx, jsxs } from "react/jsx-runtime";
8
7
  import { useState } from "react";
9
- import { z } from "zod";
10
- import { useTranslation } from "react-i18next";
11
8
  import { useAtomValue } from "jotai";
9
+ import { useTranslation } from "react-i18next";
10
+ import { useQueryState } from "nuqs";
12
11
  // src/modules/filter/components/FilterDialog.tsx
13
12
  const FilterDialog = (props) => {
14
13
  const { id, setOpenDialog, resetFilterState } = useFilterContext();
@@ -24,8 +23,8 @@ const FilterDialog = (props) => {
24
23
  };
25
24
  const FilterDialogStringView = ({ filterKey, label }) => {
26
25
  const { t } = useTranslation();
27
- const { setDialogView, setOpenDialog, sessionKey } = useFilterContext();
28
- const [query, setQuery] = useFilterQueryState(filterKey, z.string(), sessionKey ?? "");
26
+ const { setDialogView, setOpenDialog } = useFilterContext();
27
+ const [query, setQuery] = useQueryState(filterKey);
29
28
  const [dialogSearch, setDialogSearch] = useState(query ?? "");
30
29
  const onSubmit = (e) => {
31
30
  e.preventDefault();
@@ -10,8 +10,8 @@ import { filterDialogViewState, filterPopoverViewState, openDialogState, openPop
10
10
  import { IconChevronLeft, IconChevronRight, IconFilter2, IconSearch } from "@tabler/icons-react";
11
11
  import { jsx, jsxs } from "react/jsx-runtime";
12
12
  import React, { useEffect } from "react";
13
- import { useTranslation } from "react-i18next";
14
13
  import { useAtom, useAtomValue, useSetAtom } from "jotai";
14
+ import { useTranslation } from "react-i18next";
15
15
  // src/modules/filter/components/FilterPopover.tsx
16
16
  const FilterTrigger = ({ ref, isFiltered, className, ...props }) => {
17
17
  const { t } = useTranslation();
@@ -1,5 +1,4 @@
1
- export declare const FilterProvider: ({ children, id, sessionKey }: {
1
+ export declare const FilterProvider: ({ children, id }: {
2
2
  children: React.ReactNode;
3
3
  id: string;
4
- sessionKey?: string;
5
4
  }) => import("react").JSX.Element;
@@ -1,29 +1,35 @@
1
1
  import { FilterContext } from "../context/FilterContext.js";
2
2
  import { filterDialogViewState, filterPopoverViewState, openDialogState, openPopoverState } from "../states/filterStates.js";
3
3
  import { jsx } from "react/jsx-runtime";
4
+ import { useMemo } from "react";
4
5
  import { useSetAtom } from "jotai";
5
6
  // src/modules/filter/components/FilterProvider.tsx
6
- const FilterProvider = ({ children, id, sessionKey }) => {
7
+ const FilterProvider = ({ children, id }) => {
7
8
  const setOpen = useSetAtom(openPopoverState(id));
8
9
  const setView = useSetAtom(filterPopoverViewState(id));
9
10
  const setDialogView = useSetAtom(filterDialogViewState(id));
10
11
  const setOpenDialog = useSetAtom(openDialogState(id));
11
- const resetFilterState = () => {
12
- setOpen(false);
13
- setView("root");
14
- setDialogView("root");
15
- setOpenDialog(false);
16
- };
17
- return /* @__PURE__ */ jsx(FilterContext.Provider, {
18
- value: {
19
- id,
20
- sessionKey,
21
- resetFilterState,
22
- setOpen,
23
- setView,
24
- setDialogView,
25
- setOpenDialog
12
+ const filter = useMemo(() => ({
13
+ id,
14
+ resetFilterState: () => {
15
+ setOpen(false);
16
+ setView("root");
17
+ setDialogView("root");
18
+ setOpenDialog(false);
26
19
  },
20
+ setOpen,
21
+ setView,
22
+ setDialogView,
23
+ setOpenDialog
24
+ }), [
25
+ id,
26
+ setOpen,
27
+ setView,
28
+ setDialogView,
29
+ setOpenDialog
30
+ ]);
31
+ return /* @__PURE__ */ jsx(FilterContext.Provider, {
32
+ value: filter,
27
33
  children
28
34
  });
29
35
  };
@@ -1,2 +1,3 @@
1
1
  import { IFilterContext } from "../types/filter.js";
2
+ /** Controls of the enclosing `Filter`: open or close it and switch views. Throws outside one. */
2
3
  export declare const useFilterContext: () => IFilterContext;
@@ -1,6 +1,7 @@
1
1
  import { FilterContext } from "../context/FilterContext.js";
2
2
  import { useContext } from "react";
3
3
  // src/modules/filter/hooks/useFilterContext.tsx
4
+ /** Controls of the enclosing `Filter`: open or close it and switch views. Throws outside one. */
4
5
  const useFilterContext = () => {
5
6
  const context = useContext(FilterContext);
6
7
  if (!context) throw new Error("useFilterContext must be used inside <Filter>");
@@ -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 }: {