@firecms/core 3.0.0-canary.28 → 3.0.0-canary.281

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 (424) hide show
  1. package/README.md +3 -3
  2. package/dist/app/AppBar.d.ts +12 -0
  3. package/dist/app/Drawer.d.ts +16 -0
  4. package/dist/app/Scaffold.d.ts +34 -0
  5. package/dist/app/index.d.ts +4 -0
  6. package/dist/app/useApp.d.ts +16 -0
  7. package/dist/components/ArrayContainer.d.ts +31 -12
  8. package/dist/components/CircularProgressCenter.d.ts +1 -1
  9. package/dist/components/ClearFilterSortButton.d.ts +5 -0
  10. package/dist/components/{DeleteConfirmationDialog.d.ts → ConfirmationDialog.d.ts} +1 -1
  11. package/dist/components/EntityCollectionTable/EntityCollectionRowActions.d.ts +14 -13
  12. package/dist/components/EntityCollectionTable/EntityCollectionTable.d.ts +2 -2
  13. package/dist/components/EntityCollectionTable/EntityCollectionTableProps.d.ts +22 -6
  14. package/dist/components/EntityCollectionTable/PropertyTableCell.d.ts +1 -0
  15. package/dist/components/EntityCollectionTable/column_utils.d.ts +1 -2
  16. package/dist/components/EntityCollectionTable/fields/TableReferenceField.d.ts +3 -1
  17. package/dist/components/EntityCollectionTable/index.d.ts +1 -1
  18. package/dist/components/EntityCollectionTable/internal/CollectionTableToolbar.d.ts +1 -4
  19. package/dist/components/EntityCollectionTable/internal/EntityTableCell.d.ts +2 -2
  20. package/dist/components/EntityCollectionTable/internal/popup_field/PopupFormField.d.ts +7 -4
  21. package/dist/components/EntityCollectionView/EntityCollectionView.d.ts +20 -2
  22. package/dist/components/EntityCollectionView/EntityCollectionViewStartActions.d.ts +11 -0
  23. package/dist/components/EntityCollectionView/utils.d.ts +3 -0
  24. package/dist/components/EntityJsonPreview.d.ts +3 -0
  25. package/dist/components/EntityPreview.d.ts +10 -7
  26. package/dist/components/ErrorView.d.ts +1 -1
  27. package/dist/components/HomePage/DefaultHomePage.d.ts +2 -15
  28. package/dist/components/HomePage/HomePageDnD.d.ts +76 -0
  29. package/dist/components/HomePage/NavigationCard.d.ts +3 -1
  30. package/dist/components/HomePage/NavigationCardBinding.d.ts +4 -3
  31. package/dist/components/HomePage/NavigationGroup.d.ts +8 -1
  32. package/dist/components/HomePage/RenameGroupDialog.d.ts +9 -0
  33. package/dist/components/PropertyConfigBadge.d.ts +2 -1
  34. package/dist/components/PropertyIdCopyTooltip.d.ts +8 -0
  35. package/dist/components/ReferenceWidget.d.ts +3 -1
  36. package/dist/components/SelectableTable/SelectableTable.d.ts +14 -4
  37. package/dist/components/SelectableTable/filters/ReferenceFilterField.d.ts +2 -1
  38. package/dist/components/UnsavedChangesDialog.d.ts +8 -0
  39. package/dist/components/UserDisplay.d.ts +7 -0
  40. package/dist/components/VirtualTable/VirtualTableProps.d.ts +24 -12
  41. package/dist/components/VirtualTable/fields/VirtualTableUserSelect.d.ts +12 -0
  42. package/dist/components/VirtualTable/types.d.ts +3 -3
  43. package/dist/components/{EntityCollectionTable/internal → common}/default_entity_actions.d.ts +1 -3
  44. package/dist/components/common/index.d.ts +2 -1
  45. package/dist/components/common/table_height.d.ts +5 -0
  46. package/dist/components/common/types.d.ts +4 -6
  47. package/dist/components/common/useColumnsIds.d.ts +3 -1
  48. package/dist/components/common/{useDataSourceEntityCollectionTableController.d.ts → useDataSourceTableController.d.ts} +13 -2
  49. package/dist/components/common/useDebouncedCallback.d.ts +1 -0
  50. package/dist/components/common/useScrollRestoration.d.ts +14 -0
  51. package/dist/components/index.d.ts +5 -2
  52. package/dist/contexts/BreacrumbsContext.d.ts +8 -0
  53. package/dist/contexts/InternalUserManagementContext.d.ts +3 -0
  54. package/dist/core/DefaultAppBar.d.ts +29 -0
  55. package/dist/core/DefaultDrawer.d.ts +19 -0
  56. package/dist/core/DrawerNavigationItem.d.ts +10 -0
  57. package/dist/core/EntityEditView.d.ts +43 -11
  58. package/dist/core/EntityEditViewFormActions.d.ts +2 -0
  59. package/dist/core/FireCMS.d.ts +2 -3
  60. package/dist/core/FireCMSRouter.d.ts +4 -0
  61. package/dist/core/NavigationRoutes.d.ts +2 -3
  62. package/dist/core/SideDialogs.d.ts +4 -2
  63. package/dist/core/field_configs.d.ts +1 -1
  64. package/dist/core/index.d.ts +4 -4
  65. package/dist/form/EntityForm.d.ts +37 -64
  66. package/dist/form/EntityFormActions.d.ts +21 -0
  67. package/dist/form/PropertyFieldBinding.d.ts +1 -1
  68. package/dist/form/components/ErrorFocus.d.ts +1 -1
  69. package/dist/form/components/FieldHelperText.d.ts +3 -3
  70. package/dist/form/components/FormEntry.d.ts +6 -0
  71. package/dist/form/components/FormLayout.d.ts +5 -0
  72. package/dist/form/components/LabelWithIcon.d.ts +1 -1
  73. package/dist/form/components/LabelWithIconAndTooltip.d.ts +15 -0
  74. package/dist/form/components/StorageItemPreview.d.ts +4 -4
  75. package/dist/form/components/index.d.ts +3 -1
  76. package/dist/form/field_bindings/ArrayCustomShapedFieldBinding.d.ts +1 -1
  77. package/dist/form/field_bindings/ArrayOfReferencesFieldBinding.d.ts +1 -1
  78. package/dist/form/field_bindings/BlockFieldBinding.d.ts +1 -1
  79. package/dist/form/field_bindings/KeyValueFieldBinding.d.ts +1 -1
  80. package/dist/form/field_bindings/MapFieldBinding.d.ts +1 -1
  81. package/dist/form/field_bindings/MarkdownEditorFieldBinding.d.ts +11 -0
  82. package/dist/form/field_bindings/{MultiSelectBinding.d.ts → MultiSelectFieldBinding.d.ts} +1 -1
  83. package/dist/form/field_bindings/ReadOnlyFieldBinding.d.ts +1 -1
  84. package/dist/form/field_bindings/ReferenceAsStringFieldBinding.d.ts +9 -0
  85. package/dist/form/field_bindings/ReferenceFieldBinding.d.ts +2 -2
  86. package/dist/form/field_bindings/RepeatFieldBinding.d.ts +1 -1
  87. package/dist/form/field_bindings/SelectFieldBinding.d.ts +1 -1
  88. package/dist/form/field_bindings/StorageUploadFieldBinding.d.ts +5 -13
  89. package/dist/form/field_bindings/SwitchFieldBinding.d.ts +1 -2
  90. package/dist/form/field_bindings/TextFieldBinding.d.ts +1 -1
  91. package/dist/form/field_bindings/UserSelectFieldBinding.d.ts +12 -0
  92. package/dist/form/index.d.ts +17 -18
  93. package/dist/form/useClearRestoreValue.d.ts +2 -2
  94. package/dist/hooks/data/delete.d.ts +4 -4
  95. package/dist/hooks/data/save.d.ts +4 -5
  96. package/dist/hooks/data/useCollectionFetch.d.ts +1 -1
  97. package/dist/hooks/data/useEntityFetch.d.ts +4 -3
  98. package/dist/hooks/index.d.ts +3 -0
  99. package/dist/hooks/useAuthController.d.ts +1 -1
  100. package/dist/hooks/useBreadcrumbsController.d.ts +26 -0
  101. package/dist/hooks/useBuildNavigationController.d.ts +57 -13
  102. package/dist/hooks/useCollapsedGroups.d.ts +9 -0
  103. package/dist/hooks/useFireCMSContext.d.ts +1 -1
  104. package/dist/hooks/useInternalUserManagementController.d.ts +12 -0
  105. package/dist/hooks/useModeController.d.ts +1 -2
  106. package/dist/hooks/useProjectLog.d.ts +8 -2
  107. package/dist/hooks/useResolvedNavigationFrom.d.ts +3 -3
  108. package/dist/hooks/useValidateAuthenticator.d.ts +4 -8
  109. package/dist/index.d.ts +1 -0
  110. package/dist/index.es.js +23563 -13933
  111. package/dist/index.es.js.map +1 -1
  112. package/dist/index.umd.js +26305 -588
  113. package/dist/index.umd.js.map +1 -1
  114. package/dist/internal/useBuildDataSource.d.ts +3 -17
  115. package/dist/internal/useBuildSideEntityController.d.ts +3 -3
  116. package/dist/internal/useUnsavedChangesDialog.d.ts +7 -9
  117. package/dist/preview/PropertyPreviewProps.d.ts +6 -1
  118. package/dist/preview/components/EnumValuesChip.d.ts +1 -1
  119. package/dist/preview/components/ReferencePreview.d.ts +4 -3
  120. package/dist/preview/components/StorageThumbnail.d.ts +2 -1
  121. package/dist/preview/components/UrlComponentPreview.d.ts +2 -1
  122. package/dist/preview/components/UserPreview.d.ts +8 -0
  123. package/dist/preview/index.d.ts +1 -0
  124. package/dist/preview/util.d.ts +3 -3
  125. package/dist/routes/CustomCMSRoute.d.ts +4 -0
  126. package/dist/routes/FireCMSRoute.d.ts +1 -0
  127. package/dist/routes/HomePageRoute.d.ts +3 -0
  128. package/dist/types/analytics.d.ts +1 -1
  129. package/dist/types/auth.d.ts +8 -10
  130. package/dist/types/collections.d.ts +112 -25
  131. package/dist/types/customization_controller.d.ts +8 -0
  132. package/dist/types/datasource.d.ts +52 -36
  133. package/dist/types/dialogs_controller.d.ts +7 -3
  134. package/dist/types/entities.d.ts +12 -3
  135. package/dist/types/entity_actions.d.ts +72 -8
  136. package/dist/types/entity_callbacks.d.ts +16 -16
  137. package/dist/types/entity_overrides.d.ts +2 -2
  138. package/dist/types/export_import.d.ts +4 -4
  139. package/dist/types/fields.d.ts +74 -42
  140. package/dist/types/firecms.d.ts +31 -3
  141. package/dist/types/firecms_context.d.ts +17 -1
  142. package/dist/types/index.d.ts +1 -1
  143. package/dist/types/internal_user_management.d.ts +20 -0
  144. package/dist/types/navigation.d.ts +62 -19
  145. package/dist/types/permissions.d.ts +4 -4
  146. package/dist/types/plugins.d.ts +58 -13
  147. package/dist/types/properties.d.ts +90 -25
  148. package/dist/types/property_config.d.ts +1 -3
  149. package/dist/types/roles.d.ts +3 -0
  150. package/dist/types/side_dialogs_controller.d.ts +10 -0
  151. package/dist/types/side_entity_controller.d.ts +14 -1
  152. package/dist/types/storage.d.ts +75 -0
  153. package/dist/types/user.d.ts +2 -1
  154. package/dist/util/builders.d.ts +3 -3
  155. package/dist/util/callbacks.d.ts +2 -0
  156. package/dist/util/createFormexStub.d.ts +2 -0
  157. package/dist/util/entities.d.ts +3 -3
  158. package/dist/util/entity_actions.d.ts +2 -0
  159. package/dist/util/entity_cache.d.ts +23 -0
  160. package/dist/util/icon_list.d.ts +5 -1
  161. package/dist/util/icon_synonyms.d.ts +1 -98
  162. package/dist/util/icons.d.ts +7 -4
  163. package/dist/util/index.d.ts +3 -0
  164. package/dist/util/navigation_from_path.d.ts +10 -1
  165. package/dist/util/navigation_utils.d.ts +15 -3
  166. package/dist/util/objects.d.ts +2 -1
  167. package/dist/util/permissions.d.ts +4 -4
  168. package/dist/util/plurals.d.ts +0 -2
  169. package/dist/util/property_utils.d.ts +4 -4
  170. package/dist/util/references.d.ts +2 -2
  171. package/dist/util/resolutions.d.ts +42 -17
  172. package/dist/util/storage.d.ts +23 -2
  173. package/dist/util/useStorageUploadController.d.ts +3 -3
  174. package/package.json +69 -52
  175. package/src/app/AppBar.tsx +18 -0
  176. package/src/app/Drawer.tsx +24 -0
  177. package/src/app/Scaffold.tsx +253 -0
  178. package/src/app/index.ts +4 -0
  179. package/src/app/useApp.tsx +32 -0
  180. package/src/components/ArrayContainer.tsx +447 -229
  181. package/src/components/CircularProgressCenter.tsx +2 -2
  182. package/src/components/ClearFilterSortButton.tsx +41 -0
  183. package/src/components/{DeleteConfirmationDialog.tsx → ConfirmationDialog.tsx} +12 -11
  184. package/src/components/DeleteEntityDialog.tsx +13 -20
  185. package/src/components/EntityCollectionTable/EntityCollectionRowActions.tsx +65 -40
  186. package/src/components/EntityCollectionTable/EntityCollectionTable.tsx +38 -31
  187. package/src/components/EntityCollectionTable/EntityCollectionTableProps.tsx +30 -9
  188. package/src/components/EntityCollectionTable/PropertyTableCell.tsx +84 -42
  189. package/src/components/EntityCollectionTable/column_utils.tsx +3 -3
  190. package/src/components/EntityCollectionTable/fields/TableReferenceField.tsx +30 -16
  191. package/src/components/EntityCollectionTable/fields/TableStorageUpload.tsx +19 -17
  192. package/src/components/EntityCollectionTable/index.tsx +1 -1
  193. package/src/components/EntityCollectionTable/internal/CollectionTableToolbar.tsx +34 -39
  194. package/src/components/EntityCollectionTable/internal/EntityTableCell.tsx +49 -36
  195. package/src/components/EntityCollectionTable/internal/EntityTableCellActions.tsx +20 -8
  196. package/src/components/EntityCollectionTable/internal/popup_field/PopupFormField.tsx +135 -105
  197. package/src/components/EntityCollectionTable/internal/popup_field/useDraggable.tsx +9 -9
  198. package/src/components/EntityCollectionView/EntityCollectionView.tsx +235 -118
  199. package/src/components/EntityCollectionView/EntityCollectionViewActions.tsx +7 -4
  200. package/src/components/EntityCollectionView/EntityCollectionViewStartActions.tsx +68 -0
  201. package/src/components/EntityCollectionView/useSelectionController.tsx +20 -7
  202. package/src/components/EntityCollectionView/utils.ts +19 -0
  203. package/src/components/EntityJsonPreview.tsx +66 -0
  204. package/src/components/EntityPreview.tsx +83 -62
  205. package/src/components/EntityView.tsx +13 -10
  206. package/src/components/ErrorView.tsx +4 -4
  207. package/src/components/FireCMSLogo.tsx +7 -51
  208. package/src/components/HomePage/DefaultHomePage.tsx +511 -157
  209. package/src/components/HomePage/FavouritesView.tsx +9 -14
  210. package/src/components/HomePage/HomePageDnD.tsx +600 -0
  211. package/src/components/HomePage/NavigationCard.tsx +48 -39
  212. package/src/components/HomePage/NavigationCardBinding.tsx +17 -16
  213. package/src/components/HomePage/NavigationGroup.tsx +144 -30
  214. package/src/components/HomePage/RenameGroupDialog.tsx +123 -0
  215. package/src/components/HomePage/SmallNavigationCard.tsx +5 -6
  216. package/src/components/NotFoundPage.tsx +2 -2
  217. package/src/components/PropertyConfigBadge.tsx +9 -3
  218. package/src/components/PropertyIdCopyTooltip.tsx +47 -0
  219. package/src/components/ReferenceTable/ReferenceSelectionTable.tsx +23 -13
  220. package/src/components/ReferenceWidget.tsx +21 -11
  221. package/src/components/SearchIconsView.tsx +10 -7
  222. package/src/components/SelectableTable/SelectableTable.tsx +157 -145
  223. package/src/components/SelectableTable/filters/BooleanFilterField.tsx +2 -3
  224. package/src/components/SelectableTable/filters/DateTimeFilterField.tsx +25 -8
  225. package/src/components/SelectableTable/filters/ReferenceFilterField.tsx +36 -12
  226. package/src/components/SelectableTable/filters/StringNumberFilterField.tsx +93 -24
  227. package/src/components/UnsavedChangesDialog.tsx +46 -0
  228. package/src/components/UserDisplay.tsx +54 -0
  229. package/src/components/VirtualTable/VirtualTable.tsx +105 -51
  230. package/src/components/VirtualTable/VirtualTableCell.tsx +1 -9
  231. package/src/components/VirtualTable/VirtualTableHeader.tsx +10 -10
  232. package/src/components/VirtualTable/VirtualTableHeaderRow.tsx +2 -2
  233. package/src/components/VirtualTable/VirtualTableProps.tsx +28 -14
  234. package/src/components/VirtualTable/VirtualTableRow.tsx +5 -6
  235. package/src/components/VirtualTable/fields/VirtualTableDateField.tsx +5 -5
  236. package/src/components/VirtualTable/fields/VirtualTableInput.tsx +2 -2
  237. package/src/components/VirtualTable/fields/VirtualTableNumberInput.tsx +2 -1
  238. package/src/components/VirtualTable/fields/VirtualTableSelect.tsx +16 -28
  239. package/src/components/VirtualTable/fields/VirtualTableUserSelect.tsx +99 -0
  240. package/src/components/VirtualTable/types.tsx +2 -3
  241. package/src/components/{EntityCollectionTable/internal → common}/default_entity_actions.tsx +64 -44
  242. package/src/components/common/index.ts +2 -1
  243. package/src/components/{VirtualTable/common.tsx → common/table_height.tsx} +5 -2
  244. package/src/components/common/types.tsx +4 -6
  245. package/src/components/common/useColumnsIds.tsx +16 -2
  246. package/src/components/common/useDataSourceTableController.tsx +420 -0
  247. package/src/components/common/useDebouncedCallback.tsx +20 -0
  248. package/src/components/common/useScrollRestoration.tsx +68 -0
  249. package/src/components/common/useTableSearchHelper.ts +53 -12
  250. package/src/components/index.tsx +6 -2
  251. package/src/contexts/BreacrumbsContext.tsx +38 -0
  252. package/src/contexts/DialogsProvider.tsx +5 -4
  253. package/src/contexts/InternalUserManagementContext.tsx +4 -0
  254. package/src/contexts/ModeController.tsx +1 -3
  255. package/src/contexts/SnackbarProvider.tsx +2 -0
  256. package/src/core/DefaultAppBar.tsx +219 -0
  257. package/src/core/DefaultDrawer.tsx +185 -0
  258. package/src/core/DrawerNavigationItem.tsx +66 -0
  259. package/src/core/EntityEditView.tsx +435 -470
  260. package/src/core/EntityEditViewFormActions.tsx +329 -0
  261. package/src/core/EntitySidePanel.tsx +88 -21
  262. package/src/core/FireCMS.tsx +85 -60
  263. package/src/core/FireCMSRouter.tsx +17 -0
  264. package/src/core/NavigationRoutes.tsx +28 -38
  265. package/src/core/SideDialogs.tsx +22 -12
  266. package/src/core/field_configs.tsx +41 -14
  267. package/src/core/index.tsx +6 -5
  268. package/src/form/EntityForm.tsx +620 -534
  269. package/src/form/EntityFormActions.tsx +211 -0
  270. package/src/form/PropertyFieldBinding.tsx +88 -45
  271. package/src/form/components/CustomIdField.tsx +9 -3
  272. package/src/form/components/FieldHelperText.tsx +4 -4
  273. package/src/form/components/FormEntry.tsx +22 -0
  274. package/src/form/components/FormLayout.tsx +16 -0
  275. package/src/form/components/LabelWithIcon.tsx +30 -19
  276. package/src/form/components/LabelWithIconAndTooltip.tsx +28 -0
  277. package/src/form/components/StorageItemPreview.tsx +23 -13
  278. package/src/form/components/StorageUploadProgress.tsx +5 -6
  279. package/src/form/components/index.tsx +3 -1
  280. package/src/form/field_bindings/ArrayCustomShapedFieldBinding.tsx +34 -19
  281. package/src/form/field_bindings/ArrayOfReferencesFieldBinding.tsx +50 -36
  282. package/src/form/field_bindings/BlockFieldBinding.tsx +56 -34
  283. package/src/form/field_bindings/DateTimeFieldBinding.tsx +18 -14
  284. package/src/form/field_bindings/KeyValueFieldBinding.tsx +61 -52
  285. package/src/form/field_bindings/MapFieldBinding.tsx +73 -55
  286. package/src/form/field_bindings/MarkdownEditorFieldBinding.tsx +159 -0
  287. package/src/form/field_bindings/{MultiSelectBinding.tsx → MultiSelectFieldBinding.tsx} +26 -21
  288. package/src/form/field_bindings/ReadOnlyFieldBinding.tsx +11 -16
  289. package/src/form/field_bindings/ReferenceAsStringFieldBinding.tsx +135 -0
  290. package/src/form/field_bindings/ReferenceFieldBinding.tsx +42 -31
  291. package/src/form/field_bindings/RepeatFieldBinding.tsx +62 -35
  292. package/src/form/field_bindings/SelectFieldBinding.tsx +24 -15
  293. package/src/form/field_bindings/StorageUploadFieldBinding.tsx +257 -199
  294. package/src/form/field_bindings/SwitchFieldBinding.tsx +29 -24
  295. package/src/form/field_bindings/TextFieldBinding.tsx +28 -24
  296. package/src/form/field_bindings/UserSelectFieldBinding.tsx +94 -0
  297. package/src/form/index.tsx +17 -37
  298. package/src/form/useClearRestoreValue.tsx +2 -2
  299. package/src/form/validation.ts +13 -23
  300. package/src/hooks/data/delete.ts +6 -5
  301. package/src/hooks/data/save.ts +26 -33
  302. package/src/hooks/data/useCollectionFetch.tsx +3 -3
  303. package/src/hooks/data/useDataSource.tsx +11 -3
  304. package/src/hooks/data/useEntityFetch.tsx +10 -6
  305. package/src/hooks/index.tsx +4 -0
  306. package/src/hooks/useAuthController.tsx +1 -1
  307. package/src/hooks/useBreadcrumbsController.tsx +31 -0
  308. package/src/hooks/useBrowserTitleAndIcon.tsx +1 -1
  309. package/src/hooks/useBuildLocalConfigurationPersistence.tsx +8 -10
  310. package/src/hooks/useBuildModeController.tsx +22 -29
  311. package/src/hooks/useBuildNavigationController.tsx +440 -119
  312. package/src/hooks/useCollapsedGroups.ts +64 -0
  313. package/src/hooks/useFireCMSContext.tsx +9 -35
  314. package/src/hooks/useInternalUserManagementController.tsx +16 -0
  315. package/src/hooks/useLargeLayout.tsx +0 -35
  316. package/src/hooks/useModeController.tsx +1 -2
  317. package/src/hooks/useProjectLog.tsx +32 -10
  318. package/src/hooks/useResolvedNavigationFrom.tsx +10 -12
  319. package/src/hooks/useValidateAuthenticator.tsx +17 -37
  320. package/src/index.ts +1 -0
  321. package/src/internal/useBuildDataSource.ts +79 -85
  322. package/src/internal/useBuildSideDialogsController.tsx +4 -2
  323. package/src/internal/useBuildSideEntityController.tsx +204 -77
  324. package/src/internal/useUnsavedChangesDialog.tsx +127 -91
  325. package/src/preview/PropertyPreview.tsx +42 -25
  326. package/src/preview/PropertyPreviewProps.tsx +7 -1
  327. package/src/preview/components/BooleanPreview.tsx +2 -2
  328. package/src/preview/components/EmptyValue.tsx +1 -1
  329. package/src/preview/components/EnumValuesChip.tsx +2 -2
  330. package/src/preview/components/ImagePreview.tsx +26 -37
  331. package/src/preview/components/ReferencePreview.tsx +26 -36
  332. package/src/preview/components/StorageThumbnail.tsx +5 -1
  333. package/src/preview/components/UrlComponentPreview.tsx +60 -28
  334. package/src/preview/components/UserPreview.tsx +22 -0
  335. package/src/preview/index.ts +1 -0
  336. package/src/preview/property_previews/ArrayOfMapsPreview.tsx +6 -6
  337. package/src/preview/property_previews/ArrayOfReferencesPreview.tsx +7 -5
  338. package/src/preview/property_previews/ArrayOfStorageComponentsPreview.tsx +5 -4
  339. package/src/preview/property_previews/ArrayOfStringsPreview.tsx +4 -4
  340. package/src/preview/property_previews/ArrayOneOfPreview.tsx +7 -6
  341. package/src/preview/property_previews/ArrayPropertyPreview.tsx +7 -6
  342. package/src/preview/property_previews/MapPropertyPreview.tsx +12 -11
  343. package/src/preview/property_previews/SkeletonPropertyComponent.tsx +13 -13
  344. package/src/preview/property_previews/StringPropertyPreview.tsx +3 -3
  345. package/src/preview/util.ts +10 -10
  346. package/src/routes/CustomCMSRoute.tsx +21 -0
  347. package/src/routes/FireCMSRoute.tsx +246 -0
  348. package/src/routes/HomePageRoute.tsx +17 -0
  349. package/src/types/analytics.ts +3 -0
  350. package/src/types/auth.tsx +9 -13
  351. package/src/types/collections.ts +134 -30
  352. package/src/types/customization_controller.tsx +9 -1
  353. package/src/types/datasource.ts +61 -43
  354. package/src/types/dialogs_controller.tsx +7 -3
  355. package/src/types/entities.ts +19 -3
  356. package/src/types/entity_actions.tsx +86 -10
  357. package/src/types/entity_callbacks.ts +18 -18
  358. package/src/types/entity_overrides.tsx +2 -2
  359. package/src/types/export_import.ts +4 -4
  360. package/src/types/fields.tsx +85 -46
  361. package/src/types/firecms.tsx +34 -4
  362. package/src/types/firecms_context.tsx +18 -1
  363. package/src/types/index.ts +1 -1
  364. package/src/types/internal_user_management.ts +24 -0
  365. package/src/types/navigation.ts +77 -24
  366. package/src/types/permissions.ts +5 -5
  367. package/src/types/plugins.tsx +69 -15
  368. package/src/types/properties.ts +106 -27
  369. package/src/types/property_config.tsx +2 -2
  370. package/src/types/roles.ts +3 -0
  371. package/src/types/side_dialogs_controller.tsx +15 -0
  372. package/src/types/side_entity_controller.tsx +16 -1
  373. package/src/types/storage.ts +83 -1
  374. package/src/types/user.ts +3 -1
  375. package/src/util/builders.ts +10 -8
  376. package/src/util/callbacks.ts +119 -0
  377. package/src/util/createFormexStub.tsx +62 -0
  378. package/src/util/entities.ts +11 -8
  379. package/src/util/entity_actions.ts +28 -0
  380. package/src/util/entity_cache.ts +204 -0
  381. package/src/util/enums.ts +1 -1
  382. package/src/util/icon_list.ts +16 -10
  383. package/src/util/icon_synonyms.ts +3 -100
  384. package/src/util/icons.tsx +36 -11
  385. package/src/util/index.ts +3 -0
  386. package/src/util/join_collections.ts +9 -2
  387. package/src/util/make_properties_editable.ts +13 -5
  388. package/src/util/navigation_from_path.ts +33 -12
  389. package/src/util/navigation_utils.ts +141 -25
  390. package/src/util/objects.ts +90 -33
  391. package/src/util/parent_references_from_path.ts +3 -3
  392. package/src/util/permissions.ts +9 -8
  393. package/src/util/plurals.ts +0 -2
  394. package/src/util/property_utils.tsx +17 -6
  395. package/src/util/references.ts +19 -8
  396. package/src/util/resolutions.ts +122 -48
  397. package/src/util/storage.ts +79 -21
  398. package/src/util/strings.ts +2 -2
  399. package/src/util/useStorageUploadController.tsx +91 -28
  400. package/dist/components/EntityCollectionTable/internal/popup_field/ElementResizeListener.d.ts +0 -5
  401. package/dist/components/FireCMSAppBar.d.ts +0 -26
  402. package/dist/components/PropertyIdCopyTooltipContent.d.ts +0 -3
  403. package/dist/components/VirtualTable/common.d.ts +0 -2
  404. package/dist/core/Drawer.d.ts +0 -23
  405. package/dist/core/Scaffold.d.ts +0 -55
  406. package/dist/core/SideEntityView.d.ts +0 -7
  407. package/dist/form/components/FormikArrayContainer.d.ts +0 -18
  408. package/dist/form/field_bindings/MarkdownFieldBinding.d.ts +0 -9
  409. package/dist/internal/useBuildCustomizationController.d.ts +0 -2
  410. package/dist/internal/useLocaleConfig.d.ts +0 -1
  411. package/dist/types/appcheck.d.ts +0 -26
  412. package/src/components/EntityCollectionTable/internal/popup_field/ElementResizeListener.tsx +0 -59
  413. package/src/components/FireCMSAppBar.tsx +0 -165
  414. package/src/components/PropertyIdCopyTooltipContent.tsx +0 -28
  415. package/src/components/common/useDataSourceEntityCollectionTableController.tsx +0 -225
  416. package/src/core/Drawer.tsx +0 -191
  417. package/src/core/Scaffold.tsx +0 -281
  418. package/src/core/SideEntityView.tsx +0 -38
  419. package/src/form/components/FormikArrayContainer.tsx +0 -44
  420. package/src/form/field_bindings/MarkdownFieldBinding.tsx +0 -695
  421. package/src/internal/useBuildCustomizationController.tsx +0 -5
  422. package/src/internal/useLocaleConfig.tsx +0 -18
  423. package/src/types/appcheck.ts +0 -29
  424. /package/src/util/{common.tsx → common.ts} +0 -0
@@ -1,17 +1,19 @@
1
1
  import React, { PropsWithChildren } from "react";
2
2
  import { FireCMSContext } from "./firecms_context";
3
- import { CollectionActionsProps, EntityCollection } from "./collections";
3
+ import { CollectionActionsProps, EntityCollection, EntityTableController } from "./collections";
4
4
  import { User } from "./user";
5
5
  import { FieldProps, FormContext } from "./fields";
6
6
  import { CMSType, Property } from "./properties";
7
7
  import { EntityStatus } from "./entities";
8
8
  import { ResolvedProperty } from "./resolved_entities";
9
+ import { NavigationGroupMapping } from "./navigation";
10
+ import { InternalUserManagement } from "./internal_user_management";
9
11
  /**
10
12
  * Interface used to define plugins for FireCMS.
11
13
  * NOTE: This is a work in progress and the API is not stable yet.
12
14
  * @group Core
13
15
  */
14
- export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollection = EntityCollection, COL_ACTIONS_PROPS = any> = {
16
+ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollection = EntityCollection, COL_ACTIONS_PROPS = any, COL_ACTIONS_START__PROPS = any> = {
15
17
  /**
16
18
  * Key of the plugin. This is used to identify the plugin in the CMS.
17
19
  */
@@ -36,6 +38,7 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
36
38
  }>>;
37
39
  props?: PROPS;
38
40
  };
41
+ userManagement?: InternalUserManagement;
39
42
  homePage?: {
40
43
  /**
41
44
  * Additional actions to be rendered in the home page, close to the search bar.
@@ -70,6 +73,17 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
70
73
  title: string;
71
74
  children: React.ReactNode;
72
75
  };
76
+ /**
77
+ * Allow reordering with drag and drop of the collections in the home page.
78
+ */
79
+ allowDragAndDrop?: boolean;
80
+ navigationEntries?: NavigationGroupMapping[];
81
+ /**
82
+ * This method will be called when the entries are updated in the home page.
83
+ * group => navigationEntriesOrder (path)
84
+ * @param entries
85
+ */
86
+ onNavigationEntriesUpdate?: (entries: NavigationGroupMapping[]) => void;
73
87
  };
74
88
  collectionView?: {
75
89
  /**
@@ -78,6 +92,14 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
78
92
  */
79
93
  CollectionActions?: React.ComponentType<CollectionActionsProps<any, any, EC> & COL_ACTIONS_PROPS> | React.ComponentType<CollectionActionsProps<any, any, EC> & COL_ACTIONS_PROPS>[];
80
94
  collectionActionsProps?: COL_ACTIONS_PROPS;
95
+ CollectionActionsStart?: React.ComponentType<CollectionActionsProps<any, any, EC> & COL_ACTIONS_START__PROPS> | React.ComponentType<CollectionActionsProps<any, any, EC> & COL_ACTIONS_START__PROPS>[];
96
+ collectionActionsStartProps?: COL_ACTIONS_START__PROPS;
97
+ blockSearch?: (props: {
98
+ context: FireCMSContext;
99
+ path: string;
100
+ collection: EC;
101
+ parentCollectionIds?: string[];
102
+ }) => boolean;
81
103
  showTextSearchBar?: (props: {
82
104
  context: FireCMSContext;
83
105
  path: string;
@@ -101,6 +123,7 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
101
123
  parentCollectionIds: string[];
102
124
  onHover: boolean;
103
125
  collection: EC;
126
+ tableController: EntityTableController;
104
127
  }>;
105
128
  /**
106
129
  * If you add this callback to your plugin, an add button will be added to the collection table.
@@ -110,6 +133,7 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
110
133
  fullPath: string;
111
134
  parentCollectionIds: string[];
112
135
  collection: EC;
136
+ tableController: EntityTableController;
113
137
  }>;
114
138
  };
115
139
  form?: {
@@ -117,10 +141,29 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
117
141
  Component: React.ComponentType<PropsWithChildren<FORM_PROPS & PluginFormActionProps<any, EC>>>;
118
142
  props?: FORM_PROPS;
119
143
  };
144
+ /**
145
+ * Add custom actions to the default ones ("Save", "Discard"...)
146
+ */
120
147
  Actions?: React.ComponentType<PluginFormActionProps<any, EC>>;
148
+ /**
149
+ * Add custom actions to the top of the form
150
+ */
151
+ ActionsTop?: React.ComponentType<PluginFormActionProps<any, EC>>;
121
152
  fieldBuilder?: <T extends CMSType = CMSType>(props: PluginFieldBuilderParams<T, any, EC>) => React.ComponentType<FieldProps<T>> | null;
122
153
  fieldBuilderEnabled?: <T extends CMSType = CMSType>(props: PluginFieldBuilderParams<T>) => boolean;
123
154
  };
155
+ collection?: {
156
+ /**
157
+ * Use this method to modify a single collection before it is rendered.
158
+ * @param collection
159
+ */
160
+ modifyCollection?: (collection: EntityCollection) => EntityCollection;
161
+ /**
162
+ * Use this method to modify, add or remove collections.
163
+ * @param collections
164
+ */
165
+ injectCollections?: (collections: EntityCollection[]) => EntityCollection[];
166
+ };
124
167
  };
125
168
  /**
126
169
  * Props passed to the {@link FireCMSPlugin.homePage.CollectionActions} method.
@@ -128,7 +171,7 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
128
171
  *
129
172
  * @group Models
130
173
  */
131
- export interface PluginHomePageActionsProps<EP extends object = object, M extends Record<string, any> = any, UserType extends User = User, EC extends EntityCollection<M> = EntityCollection<M>> {
174
+ export interface PluginHomePageActionsProps<EP extends object = object, M extends Record<string, any> = any, USER extends User = User, EC extends EntityCollection<M> = EntityCollection<M>> {
132
175
  /**
133
176
  * Collection path of this entity. This is the full path, like
134
177
  * `users/1234/addresses`
@@ -141,17 +184,19 @@ export interface PluginHomePageActionsProps<EP extends object = object, M extend
141
184
  /**
142
185
  * Context of the app status
143
186
  */
144
- context: FireCMSContext<UserType>;
187
+ context: FireCMSContext<USER>;
145
188
  extraProps?: EP;
146
189
  }
147
- export interface PluginFormActionProps<UserType extends User = User, EC extends EntityCollection = EntityCollection> {
190
+ export interface PluginFormActionProps<USER extends User = User, EC extends EntityCollection = EntityCollection> {
148
191
  entityId?: string;
149
192
  path: string;
193
+ parentCollectionIds: string[];
150
194
  status: EntityStatus;
151
195
  collection: EC;
196
+ disabled: boolean;
152
197
  formContext?: FormContext<any>;
153
- context: FireCMSContext<UserType>;
154
- currentEntityId?: string;
198
+ context: FireCMSContext<USER>;
199
+ openEntityMode: "side_panel" | "full_screen";
155
200
  }
156
201
  export type PluginFieldBuilderParams<T extends CMSType = CMSType, M extends Record<string, any> = any, EC extends EntityCollection<M> = EntityCollection<M>> = {
157
202
  fieldConfigId: string;
@@ -159,13 +204,13 @@ export type PluginFieldBuilderParams<T extends CMSType = CMSType, M extends Reco
159
204
  property: Property<T> | ResolvedProperty<T>;
160
205
  Field: React.ComponentType<FieldProps<T, any, M>>;
161
206
  plugin: FireCMSPlugin;
162
- path: string;
163
- collection: EC;
207
+ path?: string;
208
+ collection?: EC;
164
209
  };
165
- export interface PluginGenericProps<UserType extends User = User> {
166
- context: FireCMSContext<UserType>;
210
+ export interface PluginGenericProps<USER extends User = User> {
211
+ context: FireCMSContext<USER>;
167
212
  }
168
- export interface PluginHomePageAdditionalCardsProps<UserType extends User = User> {
213
+ export interface PluginHomePageAdditionalCardsProps<USER extends User = User> {
169
214
  group?: string;
170
- context: FireCMSContext<UserType>;
215
+ context: FireCMSContext<USER>;
171
216
  }
@@ -1,14 +1,15 @@
1
1
  import React from "react";
2
2
  import { FieldProps } from "./fields";
3
3
  import { PropertyPreviewProps } from "../preview";
4
- import { EntityReference, EntityValues, GeoPoint } from "./entities";
4
+ import { EntityReference, EntityValues, GeoPoint, Vector } from "./entities";
5
5
  import { ResolvedArrayProperty, ResolvedStringProperty } from "./resolved_entities";
6
6
  import { FilterValues } from "./collections";
7
7
  import { ChipColorKey, ChipColorScheme } from "@firecms/ui";
8
+ import { AuthController } from "./auth";
8
9
  /**
9
10
  * @group Entity properties
10
11
  */
11
- export type DataType<T extends CMSType = CMSType> = T extends string ? "string" : T extends number ? "number" : T extends boolean ? "boolean" : T extends Date ? "date" : T extends GeoPoint ? "geopoint" : T extends EntityReference ? "reference" : T extends Array<CMSType> ? "array" : T extends Record<string, any> ? "map" : never;
12
+ export type DataType<T extends CMSType = CMSType> = T extends string ? "string" : T extends number ? "number" : T extends boolean ? "boolean" : T extends Date ? "date" : T extends GeoPoint ? "geopoint" : T extends Vector ? "vector" : T extends EntityReference ? "reference" : T extends Array<any> ? "array" : T extends Record<string, any> ? "map" : never;
12
13
  /**
13
14
  * @group Entity properties
14
15
  */
@@ -20,7 +21,7 @@ export type AnyProperty = StringProperty | NumberProperty | BooleanProperty | Da
20
21
  /**
21
22
  * @group Entity properties
22
23
  */
23
- export type Property<T extends CMSType = CMSType> = T extends string ? StringProperty : T extends number ? NumberProperty : T extends boolean ? BooleanProperty : T extends Date ? DateProperty : T extends GeoPoint ? GeopointProperty : T extends EntityReference ? ReferenceProperty : T extends Array<CMSType> ? ArrayProperty<T> : T extends Record<string, any> ? MapProperty<T> : AnyProperty;
24
+ export type Property<T extends CMSType = any> = T extends string ? StringProperty : T extends number ? NumberProperty : T extends boolean ? BooleanProperty : T extends Date ? DateProperty : T extends GeoPoint ? GeopointProperty : T extends EntityReference ? ReferenceProperty : T extends Array<CMSType> ? ArrayProperty<T> : T extends Record<string, any> ? MapProperty<T> : AnyProperty;
24
25
  /**
25
26
  * Interface including all common properties of a CMS property
26
27
  * @group Entity properties
@@ -97,12 +98,17 @@ export interface BaseProperty<T extends CMSType, CustomProps = any> {
97
98
  /**
98
99
  * This value will be set by default for new entities.
99
100
  */
100
- defaultValue?: T;
101
+ defaultValue?: T | null;
101
102
  /**
102
103
  * Should this property be editable. If set to true, the user will be able to modify the property and
103
104
  * save the new config. The saved config will then become the source of truth.
104
105
  */
105
106
  editable?: boolean;
107
+ /**
108
+ * A number between 0 and 100 that indicates the width of the field in the form view.
109
+ * It defaults to 100, but you can set it to 50 to have two fields in the same row.
110
+ */
111
+ widthPercentage?: number;
106
112
  }
107
113
  /**
108
114
  * @group Entity properties
@@ -200,6 +206,10 @@ export type PropertyBuilderProps<M extends Record<string, any> = any> = {
200
206
  * Entity ID
201
207
  */
202
208
  entityId?: string;
209
+ /**
210
+ * Controller to manage authentication
211
+ */
212
+ authController: AuthController;
203
213
  };
204
214
  /**
205
215
  * You can use this type to define a property dynamically, based
@@ -207,15 +217,15 @@ export type PropertyBuilderProps<M extends Record<string, any> = any> = {
207
217
  * current value of the property, as well as the path and entity ID.
208
218
  * @group Entity properties
209
219
  */
210
- export type PropertyBuilder<T extends CMSType = any, M extends Record<string, any> = any> = ({ values, previousValues, propertyValue, path, entityId }: PropertyBuilderProps<M>) => Property<T> | null;
220
+ export type PropertyBuilder<T extends CMSType = any, M extends Record<string, any> = any> = ({ values, previousValues, propertyValue, index, path, entityId, authController }: PropertyBuilderProps<M>) => Property<T> | null;
211
221
  /**
212
222
  * @group Entity properties
213
223
  */
214
- export type PropertyOrBuilder<T extends CMSType = CMSType, M extends Record<string, any> = Record<string, any>> = Property<T> | PropertyBuilder<T, M>;
224
+ export type PropertyOrBuilder<T extends CMSType = CMSType, M extends Record<string, any> = any> = Property<T> | PropertyBuilder<T, M>;
215
225
  /**
216
226
  * @group Entity properties
217
227
  */
218
- export type PropertiesOrBuilders<M extends Record<string, any> = Record<string, any>> = {
228
+ export type PropertiesOrBuilders<M extends Record<string, any> = any> = {
219
229
  [k in keyof M]: PropertyOrBuilder<M[k], M>;
220
230
  };
221
231
  /**
@@ -278,9 +288,18 @@ export interface StringProperty extends BaseProperty<string> {
278
288
  enumValues?: EnumValues;
279
289
  /**
280
290
  * You can specify a `Storage` configuration. It is used to
281
- * indicate that this string refers to a path in Google Cloud Storage.
291
+ * indicate that this string refers to a path in your storage provider.
282
292
  */
283
293
  storage?: StorageConfig;
294
+ /**
295
+ * This property is used to indicate that the string is a user ID, and
296
+ * it will be rendered as a user picker.
297
+ * Note that the user ID needs to be the one used in your authentication
298
+ * provider, e.g. Firebase Auth.
299
+ * You can also use a property builder to specify the user path dynamically
300
+ * based on other values of the entity.
301
+ */
302
+ userSelect?: boolean;
284
303
  /**
285
304
  * If the value of this property is a URL, you can set this flag to true
286
305
  * to add a link, or one of the supported media types to render a preview
@@ -302,11 +321,18 @@ export interface StringProperty extends BaseProperty<string> {
302
321
  * Add an icon to clear the value and set it to `null`. Defaults to `false`
303
322
  */
304
323
  clearable?: boolean;
324
+ /**
325
+ * You can use this property (a string) to behave as a reference to another
326
+ * collection. The stored value is the ID of the entity in the
327
+ * collection, and the `path` prop is used to
328
+ * define the collection this reference points to.
329
+ */
330
+ reference?: ReferenceProperty;
305
331
  }
306
332
  /**
307
333
  * @group Entity properties
308
334
  */
309
- export interface ArrayProperty<T extends ArrayT[] = any[], ArrayT extends CMSType = CMSType> extends BaseProperty<T> {
335
+ export interface ArrayProperty<T extends ArrayT[] = any[], ArrayT extends CMSType = any> extends BaseProperty<T> {
310
336
  dataType: "array";
311
337
  /**
312
338
  * The property of this array.
@@ -361,6 +387,21 @@ export interface ArrayProperty<T extends ArrayT[] = any[], ArrayT extends CMSTyp
361
387
  * Should the field be initially expanded. Defaults to `true`
362
388
  */
363
389
  expanded?: boolean;
390
+ /**
391
+ * Display the child properties directly, without being wrapped in an
392
+ * extendable panel.
393
+ */
394
+ minimalistView?: boolean;
395
+ /**
396
+ * Can the elements in this array be reordered. Defaults to `true`.
397
+ * This prop has no effect if `disabled` is set to true.
398
+ */
399
+ sortable?: boolean;
400
+ /**
401
+ * Can the elements in this array be added. Defaults to `true`
402
+ * This prop has no effect if `disabled` is set to true.
403
+ */
404
+ canAddElements?: boolean;
364
405
  }
365
406
  /**
366
407
  * @group Entity properties
@@ -400,6 +441,11 @@ export interface MapProperty<T extends Record<string, CMSType> = Record<string,
400
441
  * view
401
442
  */
402
443
  spreadChildren?: boolean;
444
+ /**
445
+ * Display the child properties directly, without being wrapped in an
446
+ * extendable panel. Note that this will also hide the title of this property.
447
+ */
448
+ minimalistView?: boolean;
403
449
  /**
404
450
  * Should the field be initially expanded. Defaults to `true`
405
451
  */
@@ -460,7 +506,7 @@ export interface ReferenceProperty extends BaseProperty<EntityReference> {
460
506
  * You can leave this prop undefined if the path is not yet know, e.g.
461
507
  * you are using a property builder and the path depends on a different
462
508
  * property.
463
- * Note that you can also use a collection alias.
509
+ * Note that you can also use a collection id.
464
510
  */
465
511
  path?: string;
466
512
  /**
@@ -474,6 +520,14 @@ export interface ReferenceProperty extends BaseProperty<EntityReference> {
474
520
  * specified values are considered.
475
521
  */
476
522
  previewProperties?: string[];
523
+ /**
524
+ * Should the reference include the ID of the entity. Defaults to `true`
525
+ */
526
+ includeId?: boolean;
527
+ /**
528
+ * Should the reference include a link to the entity (open the entity details). Defaults to `true`
529
+ */
530
+ includeEntityLink?: boolean;
477
531
  }
478
532
  /**
479
533
  * Rules to validate any property. Some properties have specific rules
@@ -575,13 +629,13 @@ export type StorageConfig = {
575
629
  * You can use this prop to customize the uploaded filename.
576
630
  * You can use a function as a callback or a string where you
577
631
  * specify some placeholders that get replaced with the corresponding values.
578
- * - {file} - Full file name
579
- * - {file.name} - Name of the file without extension
580
- * - {file.ext} - Extension of the file
581
- * - {rand} - Random value used to avoid name collisions
582
- * - {entityId} - ID of the entity
583
- * - {propertyKey} - ID of this property
584
- * - {path} - Path of this entity
632
+ * - `{file}` - Full file name
633
+ * - `{file.name}` - Name of the file without extension
634
+ * - `{file.ext}` - Extension of the file
635
+ * - `{rand}` - Random value used to avoid name collisions
636
+ * - `{entityId}` - ID of the entity
637
+ * - `{propertyKey}` - ID of this property
638
+ * - `{path}` - Path of this entity
585
639
  *
586
640
  * @param context
587
641
  */
@@ -591,13 +645,13 @@ export type StorageConfig = {
591
645
  *
592
646
  * You can use a function as a callback or a string where you
593
647
  * specify some placeholders that get replaced with the corresponding values.
594
- * - {file} - Full file name
595
- * - {file.name} - Name of the file without extension
596
- * - {file.ext} - Extension of the file
597
- * - {rand} - Random value used to avoid name collisions
598
- * - {entityId} - ID of the entity
599
- * - {propertyKey} - ID of this property
600
- * - {path} - Path of this entity
648
+ * - `{file}` - Full file name
649
+ * - `{file.name}` - Name of the file without extension
650
+ * - `{file.ext}` - Extension of the file
651
+ * - `{rand}` - Random value used to avoid name collisions
652
+ * - `{entityId}` - ID of the entity
653
+ * - `{propertyKey}` - ID of this property
654
+ * - `{path}` - Path of this entity
601
655
  */
602
656
  storagePath: string | ((context: UploadedFileContext) => string);
603
657
  /**
@@ -615,11 +669,22 @@ export type StorageConfig = {
615
669
  * Define maximal file size in bytes
616
670
  */
617
671
  maxSize?: number;
672
+ /**
673
+ * Use this callback to process the file before uploading it to the storage.
674
+ * If nothing is returned, the file is uploaded as it is.
675
+ * @param file
676
+ */
677
+ processFile?: (file: File) => Promise<File> | undefined;
618
678
  /**
619
679
  * Postprocess the saved value (storage path or URL)
620
680
  * after it has been resolved.
621
681
  */
622
682
  postProcess?: (pathOrUrl: string) => Promise<string>;
683
+ /**
684
+ * You can use this prop in order to provide a custom preview URL.
685
+ * Useful when the file's path is different from the original field value
686
+ */
687
+ previewUrl?: (fileName: string) => string;
623
688
  };
624
689
  /**
625
690
  * @group Entity properties
@@ -644,7 +709,7 @@ export interface UploadedFileContext {
644
709
  /**
645
710
  * Entity path. E.g. `products/PID/locales`
646
711
  */
647
- path: string;
712
+ path?: string;
648
713
  /**
649
714
  * Values of the current entity
650
715
  */
@@ -19,8 +19,6 @@ export type PropertyConfig<T extends CMSType = any> = {
19
19
  * Default config for the property.
20
20
  * This property or builder will be used as the base values for the resulting property.
21
21
  * You can also use a builder function to generate the base property.
22
- * You can use a builder function to generate the property based on the values or the path.
23
- * You can also define a custom Field as a React component to be used for this property.
24
22
  */
25
23
  property: PropertyOrBuilder<T>;
26
24
  /**
@@ -39,4 +37,4 @@ export type PropertyConfig<T extends CMSType = any> = {
39
37
  */
40
38
  description?: string;
41
39
  };
42
- export type PropertyConfigId = "text_field" | "multiline" | "markdown" | "url" | "email" | "select" | "multi_select" | "number_input" | "number_select" | "multi_number_select" | "file_upload" | "multi_file_upload" | "group" | "key_value" | "reference" | "multi_references" | "switch" | "date_time" | "repeat" | "custom_array" | "block";
40
+ export type PropertyConfigId = "text_field" | "multiline" | "markdown" | "url" | "email" | "user_select" | "select" | "multi_select" | "number_input" | "number_select" | "multi_number_select" | "file_upload" | "multi_file_upload" | "group" | "key_value" | "reference" | "reference_as_string" | "multi_references" | "switch" | "date_time" | "repeat" | "custom_array" | "block";
@@ -23,6 +23,9 @@ export type Role = {
23
23
  * @see stripCollectionPath
24
24
  */
25
25
  collectionPermissions?: Record<string, Permissions>;
26
+ /**
27
+ * Permissions related to editing the collections
28
+ */
26
29
  config?: {
27
30
  createCollections?: boolean;
28
31
  editCollections?: boolean | "own";
@@ -1,3 +1,4 @@
1
+ import React from "react";
1
2
  /**
2
3
  * Controller to open the side dialog
3
4
  * @group Hooks and utilities
@@ -11,6 +12,11 @@ export interface SideDialogsController {
11
12
  * List of side panels currently open
12
13
  */
13
14
  sidePanels: SideDialogPanelProps[];
15
+ /**
16
+ * Override the current side panels
17
+ * @param panels
18
+ */
19
+ setSidePanels: (panels: SideDialogPanelProps[]) => void;
14
20
  /**
15
21
  * Open one or multiple side panels
16
22
  * @param props
@@ -54,4 +60,8 @@ export interface SideDialogPanelProps {
54
60
  * Callback when the panel is closed
55
61
  */
56
62
  onClose?: () => void;
63
+ /**
64
+ * Use this prop to store additional data in the panel
65
+ */
66
+ additional?: any;
57
67
  }
@@ -1,6 +1,7 @@
1
1
  import { EntityCollection } from "./collections";
2
2
  import { ResolvedEntityCollection } from "./resolved_entities";
3
3
  import { Entity } from "./entities";
4
+ import { EntityFormProps } from "../form";
4
5
  /**
5
6
  * Props used to open a side dialog
6
7
  * @group Hooks and utilities
@@ -10,6 +11,10 @@ export interface EntitySidePanelProps<M extends Record<string, any> = any> {
10
11
  * Absolute path of the entity
11
12
  */
12
13
  path: string;
14
+ /**
15
+ * Full CMS path of the entity, including the collection and sub-collections.
16
+ */
17
+ fullIdPath?: string;
13
18
  /**
14
19
  * ID of the entity, if not set, it means we are creating a new entity
15
20
  */
@@ -22,7 +27,7 @@ export interface EntitySidePanelProps<M extends Record<string, any> = any> {
22
27
  * Open the entity with a selected sub-collection view. If the panel for this
23
28
  * entity was already open, it is replaced.
24
29
  */
25
- selectedSubPath?: string;
30
+ selectedTab?: string;
26
31
  /**
27
32
  * Use this prop to override the width of the form view.
28
33
  * e.g. "600px"
@@ -55,6 +60,14 @@ export interface EntitySidePanelProps<M extends Record<string, any> = any> {
55
60
  * Should this panel close when saving
56
61
  */
57
62
  closeOnSave?: boolean;
63
+ /**
64
+ * Override some form properties
65
+ */
66
+ formProps?: Partial<EntityFormProps<M>>;
67
+ /**
68
+ * Allow the user to open the entity fullscreen
69
+ */
70
+ allowFullScreen?: boolean;
58
71
  }
59
72
  /**
60
73
  * Controller to open the side dialog displaying entity forms
@@ -87,4 +87,79 @@ export interface StorageSource {
87
87
  * @param bucket
88
88
  */
89
89
  getFile: (path: string, bucket?: string) => Promise<File | null>;
90
+ /**
91
+ * Delete a file.
92
+ * @param path
93
+ * @param bucket
94
+ */
95
+ deleteFile: (path: string, bucket?: string) => Promise<void>;
96
+ /**
97
+ * List the contents of a path.
98
+ * @param path
99
+ * @param options
100
+ */
101
+ list: (path: string, options?: {
102
+ bucket?: string;
103
+ maxResults?: number;
104
+ pageToken?: string;
105
+ }) => Promise<StorageListResult>;
106
+ }
107
+ /**
108
+ * Result returned by list().
109
+ * @public
110
+ */
111
+ export declare interface StorageListResult {
112
+ /**
113
+ * References to prefixes (sub-folders). You can call list() on them to
114
+ * get its contents.
115
+ *
116
+ * Folders are implicit based on '/' in the object paths.
117
+ * For example, if a bucket has two objects '/a/b/1' and '/a/b/2', list('/a')
118
+ * will return '/a/b' as a prefix.
119
+ */
120
+ prefixes: StorageReference[];
121
+ /**
122
+ * Objects in this directory.
123
+ * You can call getMetadata() and getDownloadUrl() on them.
124
+ */
125
+ items: StorageReference[];
126
+ /**
127
+ * If set, there might be more results for this list. Use this token to resume the list.
128
+ */
129
+ nextPageToken?: string;
130
+ }
131
+ /**
132
+ * Represents a reference to a Google Cloud Storage object. Developers can
133
+ * upload, download, and delete objects, as well as get/set object metadata.
134
+ * @public
135
+ */
136
+ export declare interface StorageReference {
137
+ /**
138
+ * Returns a gs:// URL for this object in the form
139
+ * `gs://<bucket>/<path>/<to>/<object>`
140
+ * @returns The gs:// URL.
141
+ */
142
+ toString(): string;
143
+ /**
144
+ * A reference to the root of this object's bucket.
145
+ */
146
+ root: StorageReference;
147
+ /**
148
+ * The name of the bucket containing this reference's object.
149
+ */
150
+ bucket: string;
151
+ /**
152
+ * The full path of this object.
153
+ */
154
+ fullPath: string;
155
+ /**
156
+ * The short name of this object, which is the last component of the full path.
157
+ * For example, if fullPath is 'full/path/image.png', name is 'image.png'.
158
+ */
159
+ name: string;
160
+ /**
161
+ * A reference pointing to the parent location of this reference, or null if
162
+ * this reference is the root.
163
+ */
164
+ parent: StorageReference | null;
90
165
  }
@@ -35,7 +35,8 @@ export type User = {
35
35
  */
36
36
  readonly isAnonymous: boolean;
37
37
  /**
38
- *
38
+ * Custom roles assigned to the user.
39
39
  */
40
40
  roles?: Role[];
41
+ getIdToken?: (forceRefresh?: boolean) => Promise<string>;
41
42
  };
@@ -5,14 +5,14 @@ import { AdditionalFieldDelegate, ArrayProperty, BooleanProperty, CMSType, DateP
5
5
  * @param collection
6
6
  * @group Builder
7
7
  */
8
- export declare function buildCollection<M extends Record<string, any> = any, UserType extends User = User>(collection: EntityCollection<M, UserType>): EntityCollection<M, UserType>;
8
+ export declare function buildCollection<M extends Record<string, any> = any, USER extends User = User>(collection: EntityCollection<M, USER>): EntityCollection<M, USER>;
9
9
  /**
10
10
  * Identity function we use to defeat the type system of Typescript and preserve
11
11
  * the property keys.
12
12
  * @param property
13
13
  * @group Builder
14
14
  */
15
- export declare function buildProperty<T extends CMSType = CMSType, P extends PropertyOrBuilder<T> = PropertyOrBuilder<T>, M extends Record<string, any> = Record<string, any>>(property: P): P extends StringProperty ? StringProperty : P extends NumberProperty ? NumberProperty : P extends BooleanProperty ? BooleanProperty : P extends DateProperty ? DateProperty : P extends GeopointProperty ? GeopointProperty : P extends ReferenceProperty ? ReferenceProperty : P extends ArrayProperty ? ArrayProperty : P extends MapProperty ? MapProperty : P extends PropertyBuilder<T, M> ? PropertyBuilder<T, M> : never;
15
+ export declare function buildProperty<T extends CMSType = CMSType, P extends PropertyOrBuilder<T> = PropertyOrBuilder<T>, M extends Record<string, any> = any>(property: P): P extends StringProperty ? StringProperty : P extends NumberProperty ? NumberProperty : P extends BooleanProperty ? BooleanProperty : P extends DateProperty ? DateProperty : P extends GeopointProperty ? GeopointProperty : P extends ReferenceProperty ? ReferenceProperty : P extends ArrayProperty ? ArrayProperty : P extends MapProperty ? MapProperty : P extends PropertyBuilder<T, M> ? PropertyBuilder<T, M> : never;
16
16
  /**
17
17
  * Identity function we use to defeat the type system of Typescript and preserve
18
18
  * the properties keys.
@@ -54,7 +54,7 @@ export declare function buildEntityCallbacks<M extends Record<string, any> = any
54
54
  * @param additionalFieldDelegate
55
55
  * @group Builder
56
56
  */
57
- export declare function buildAdditionalFieldDelegate<M extends Record<string, any>, UserType extends User = User>(additionalFieldDelegate: AdditionalFieldDelegate<M, UserType>): AdditionalFieldDelegate<M, UserType>;
57
+ export declare function buildAdditionalFieldDelegate<M extends Record<string, any>, USER extends User = User>(additionalFieldDelegate: AdditionalFieldDelegate<M, USER>): AdditionalFieldDelegate<M, USER>;
58
58
  /**
59
59
  * Identity function we use to defeat the type system of Typescript and build
60
60
  * additional field delegates views with all its properties
@@ -0,0 +1,2 @@
1
+ import { EntityCallbacks } from "../types";
2
+ export declare const mergeCallbacks: (baseCallbacks?: EntityCallbacks, pluginCallbacks?: EntityCallbacks) => EntityCallbacks | undefined;
@@ -0,0 +1,2 @@
1
+ import { FormexController } from "@firecms/formex";
2
+ export declare function createFormexStub<T extends object>(values: T): FormexController<T>;
@@ -1,9 +1,9 @@
1
1
  import { CMSType, DataType, Entity, EntityReference, EntityStatus, EntityValues, PropertiesOrBuilders, Property, PropertyBuilder, PropertyOrBuilder, ResolvedProperties, ResolvedProperty } from "../types";
2
- export declare function isReadOnly(property: Property | ResolvedProperty): boolean;
2
+ export declare function isReadOnly(property: Property<any> | ResolvedProperty<any>): boolean;
3
3
  export declare function isHidden(property: Property | ResolvedProperty): boolean;
4
4
  export declare function isPropertyBuilder<T extends CMSType, M extends Record<string, any>>(propertyOrBuilder?: PropertyOrBuilder<T, M> | Property<T> | ResolvedProperty<T>): propertyOrBuilder is PropertyBuilder<T, M>;
5
5
  export declare function getDefaultValuesFor<M extends Record<string, any>>(properties: PropertiesOrBuilders<M> | ResolvedProperties<M>): Partial<EntityValues<M>>;
6
- export declare function getDefaultValueFor(property: PropertyOrBuilder): {} | null | undefined;
6
+ export declare function getDefaultValueFor(property?: PropertyOrBuilder): {} | null | undefined;
7
7
  export declare function getDefaultValueForDataType(dataType: DataType): {} | null;
8
8
  /**
9
9
  * Update the automatic values in an entity before save
@@ -23,6 +23,6 @@ export declare function updateDateAutoValues<M extends Record<string, any>>({ in
23
23
  * @group Datasource
24
24
  */
25
25
  export declare function sanitizeData<M extends Record<string, any>>(values: EntityValues<M>, properties: ResolvedProperties<M>): any;
26
- export declare function getReferenceFrom<M extends Record<string, any>>(entity: Entity<M>): EntityReference<M>;
26
+ export declare function getReferenceFrom<M extends Record<string, any>>(entity: Entity<M>): EntityReference;
27
27
  export declare function traverseValuesProperties<M extends Record<string, any>>(inputValues: Partial<EntityValues<M>>, properties: ResolvedProperties<M>, operation: (value: any, property: Property) => any): EntityValues<M> | undefined;
28
28
  export declare function traverseValueProperty(inputValue: any, property: Property, operation: (value: any, property: Property) => any): any;
@@ -0,0 +1,2 @@
1
+ import { EntityAction } from "../types";
2
+ export declare function mergeEntityActions(currentActions: EntityAction[], newActions: EntityAction[]): EntityAction[];