@firecms/core 3.0.0-alpha.62 → 3.0.0-alpha.64

package/dist/preview/PropertyPreview.d.ts

@@ -1,6 +1,7 @@
+import React from "react";
 import { CMSType } from "../types";
 import { PropertyPreviewProps } from "./PropertyPreviewProps";
 /**
  * @group Preview components
  */
-export declare function PropertyPreview<T extends CMSType>(props: PropertyPreviewProps<T>): any;
+export declare const PropertyPreview: React.MemoExoticComponent<(<T extends CMSType>(props: PropertyPreviewProps<T, any, Record<string, any>>) => any)>;

package/dist/preview/PropertyPreviewProps.d.ts

@@ -1,4 +1,4 @@
-import { CMSType, Entity, Property, ResolvedProperty } from "../types";
+import { CMSType, Property, ResolvedProperty } from "../types";
 /**
  * @group Preview components
  */
@@ -22,7 +22,6 @@ export interface PropertyPreviewProps<T extends CMSType = any, CustomProps = any
     /**
      * Click handler
      */
-    onClick?: () => void;
     /**
      * Desired size of the preview, depending on the context.
      */
@@ -41,8 +40,4 @@ export interface PropertyPreviewProps<T extends CMSType = any, CustomProps = any
      * Additional properties set by the developer
      */
     customProps?: CustomProps;
-    /**
-     * Entity this property refers to
-     */
-    entity?: Entity<M>;
 }

package/dist/preview/property_previews/ArrayOfMapsPreview.d.ts

@@ -2,4 +2,4 @@ import { PropertyPreviewProps } from "../PropertyPreviewProps";
 /**
  * @group Preview components
  */
-export declare function ArrayOfMapsPreview({ propertyKey, value, property: inputProperty, size, entity }: PropertyPreviewProps<Record<string, any>[]>): import("react/jsx-runtime").JSX.Element | null;
+export declare function ArrayOfMapsPreview({ propertyKey, value, property: inputProperty, size, }: PropertyPreviewProps<Record<string, any>[]>): import("react/jsx-runtime").JSX.Element | null;

package/dist/preview/property_previews/ArrayOfStorageComponentsPreview.d.ts

@@ -2,4 +2,4 @@ import { PropertyPreviewProps } from "../PropertyPreviewProps";
 /**
  * @group Preview components
  */
-export declare function ArrayOfStorageComponentsPreview({ propertyKey, entity, value, property: inputProperty, size }: PropertyPreviewProps<any[]>): import("react/jsx-runtime").JSX.Element;
+export declare function ArrayOfStorageComponentsPreview({ propertyKey, value, property: inputProperty, size }: PropertyPreviewProps<any[]>): import("react/jsx-runtime").JSX.Element;

package/dist/preview/property_previews/ArrayOfStringsPreview.d.ts

@@ -2,4 +2,4 @@ import { PropertyPreviewProps } from "../../preview";
 /**
  * @group Preview components
  */
-export declare function ArrayOfStringsPreview({ propertyKey, value, property: inputProperty, entity, size }: PropertyPreviewProps<string[]>): import("react/jsx-runtime").JSX.Element;
+export declare function ArrayOfStringsPreview({ propertyKey, value, property: inputProperty, size }: PropertyPreviewProps<string[]>): import("react/jsx-runtime").JSX.Element;

package/dist/preview/property_previews/ArrayOneOfPreview.d.ts

@@ -2,4 +2,4 @@ import { PropertyPreviewProps } from "../PropertyPreviewProps";
 /**
  * @group Preview components
  */
-export declare function ArrayOneOfPreview({ propertyKey, value, property: inputProperty, size, entity }: PropertyPreviewProps<any[]>): import("react/jsx-runtime").JSX.Element | null;
+export declare function ArrayOneOfPreview({ propertyKey, value, property: inputProperty, size, }: PropertyPreviewProps<any[]>): import("react/jsx-runtime").JSX.Element | null;

package/dist/preview/property_previews/ArrayPropertyPreview.d.ts

@@ -2,4 +2,4 @@ import { PropertyPreviewProps } from "../PropertyPreviewProps";
 /**
  * @group Preview components
  */
-export declare function ArrayPropertyPreview({ propertyKey, value, property: inputProperty, entity, size }: PropertyPreviewProps<any[]>): import("react/jsx-runtime").JSX.Element | null;
+export declare function ArrayPropertyPreview({ propertyKey, value, property: inputProperty, size }: PropertyPreviewProps<any[]>): import("react/jsx-runtime").JSX.Element | null;

package/dist/preview/property_previews/MapPropertyPreview.d.ts

@@ -2,7 +2,7 @@ import { PropertyPreviewProps } from "../PropertyPreviewProps";
 /**
  * @group Preview components
  */
-export declare function MapPropertyPreview<T extends Record<string, any> = Record<string, any>>({ propertyKey, value, property, entity, size }: PropertyPreviewProps<T>): import("react/jsx-runtime").JSX.Element | null;
+export declare function MapPropertyPreview<T extends Record<string, any> = Record<string, any>>({ propertyKey, value, property, size }: PropertyPreviewProps<T>): import("react/jsx-runtime").JSX.Element | null;
 export declare function KeyValuePreview({ value }: {
     value: any;
 }): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/navigation.d.ts

@@ -106,7 +106,7 @@ export type NavigationController = {
      */
     refreshNavigation: () => void;
     /**
-     * Retrieve all the related parent collections for a given path
+     * Retrieve all the related parent references for a given path
      * @param path
      */
     getParentReferencesFromPath: (path: string) => EntityReference[];
@@ -115,6 +115,11 @@ export type NavigationController = {
      * @param path
      */
     getParentCollectionIds: (path: string) => string[];
+    /**
+     * Resolve paths from a list of ids
+     * @param ids
+     */
+    convertIdsToPaths: (ids: string[]) => string[];
 };
 /**
  * Custom additional views created by the developer, added to the main

package/dist/types/plugins.d.ts

@@ -62,7 +62,17 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
         props?: PROPS;
     };
     homePage?: {
+        /**
+         * Additional actions to be rendered in the home page, close to the search bar.
+         */
+        additionalActions?: React.ReactNode;
+        /**
+         * Additional children to be rendered in the beginning of the home page.
+         */
         additionalChildrenStart?: React.ReactNode;
+        /**
+         * Additional children to be rendered at the end of the home page.
+         */
         additionalChildrenEnd?: React.ReactNode;
         /**
          * Use this component to add custom actions to the navigation card

package/dist/util/navigation_utils.d.ts

@@ -5,14 +5,14 @@ export declare function removeInitialSlash(s: string): string;
 export declare function removeTrailingSlash(s: string): string;
 export declare function addInitialSlash(s: string): string;
 export declare function getLastSegment(path: string): string;
-export declare function resolveCollectionPathAliases(path: string, allCollections: EntityCollection[]): string;
+export declare function resolveCollectionPathIds(path: string, allCollections: EntityCollection[]): string;
 /**
  * Find the corresponding view at any depth for a given path.
  * Note that path or segments of the paths can be collection aliases.
  * @param pathOrAlias
  * @param collections
  */
-export declare function getCollectionByPathOrAlias(pathOrAlias: string, collections: EntityCollection[]): EntityCollection | undefined;
+export declare function getCollectionByPathOrId(pathOrAlias: string, collections: EntityCollection[]): EntityCollection | undefined;
 /**
  * Get the subcollection combinations from a path:
  * "sites/es/locales" => ["sites/es/locales", "sites"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firecms/core",
-  "version": "3.0.0-alpha.62",
+  "version": "3.0.0-alpha.64",
   "description": "Awesome Firebase/Firestore-based headless open-source CMS",
   "funding": {
     "url": "https://github.com/sponsors/firecmsco"
@@ -45,7 +45,7 @@
     "generateIcons": "ts-node --esm src/icons/generateIcons.ts"
   },
   "dependencies": {
-    "@firecms/ui": "^3.0.0-alpha.62",
+    "@firecms/ui": "^3.0.0-alpha.64",
     "@fontsource/ibm-plex-mono": "^5.0.8",
     "@fontsource/roboto": "^5.0.8",
     "@hello-pangea/dnd": "^16.5.0",
@@ -116,7 +116,7 @@
     "dist",
     "src"
   ],
-  "gitHead": "ee6ce49b774c005d9af503f7a393487b3a9ef3d8",
+  "gitHead": "da6a7aca05fc7b09614f9d67409881e0cefd27f2",
   "publishConfig": {
     "access": "public"
   }

package/src/components/EntityCollectionTable/fields/TableStorageUpload.tsx

@@ -302,7 +302,7 @@ export function TableStorageItemPreview({
                         propertyKey={"ignore"} // TODO: Fix this
                         value={value}
                         property={property}
-                        entity={entity}
+                        // entity={entity}
                         size={size}/>
                 </ErrorBoundary>
             }

package/src/components/EntityCollectionTable/internal/PropertyTableCell.tsx

@@ -235,7 +235,7 @@ export const PropertyTableCell = React.memo<PropertyTableCellProps<any, any>>(
                     height={getRowHeight(size)}
                     propertyKey={propertyKey}
                     property={property}
-                    entity={entity}
+                    // entity={entity}
                     value={internalValue}
                     size={getPreviewSizeFrom(size)}
                 />
@@ -404,7 +404,7 @@ export const PropertyTableCell = React.memo<PropertyTableCellProps<any, any>>(
                 <PropertyPreview
                     width={width}
                     height={height}
-                    entity={entity}
+                    // entity={entity}
                     propertyKey={propertyKey as string}
                     value={internalValue}
                     property={property}

package/src/components/EntityPreview.tsx

@@ -70,7 +70,7 @@ export function EntityPreview<M extends Record<string, any>>(
                                     <PropertyPreview
                                         propertyKey={key}
                                         value={value}
-                                        entity={entity}
+                                        // entity={entity}
                                         property={property}
                                         size={"medium"}/>
                                 </div>

package/src/components/HomePage/DefaultHomePage.tsx

@@ -27,11 +27,22 @@ search.addIndex("path");
  * @group Components
  */
 export function DefaultHomePage({
+                                    additionalActions,
                                     additionalChildrenStart,
                                     additionalChildrenEnd
                                 }: {
-    additionalChildrenStart?: React.ReactNode,
-    additionalChildrenEnd?: React.ReactNode
+    /**
+     * Additional actions to be rendered in the home page, close to the search bar.
+     */
+    additionalActions?: React.ReactNode;
+    /**
+     * Additional children to be rendered in the beginning of the home page.
+     */
+    additionalChildrenStart?: React.ReactNode;
+    /**
+     * Additional children to be rendered at the end of the home page.
+     */
+    additionalChildrenEnd?: React.ReactNode;
 }) {
 
     const context = useFireCMSContext();
@@ -117,12 +128,13 @@ export function DefaultHomePage({
              className="py-2 overflow-auto h-full w-full">
             <Container maxWidth={"6xl"}>
                 <div
-                    className="sticky py-4 transition-all duration-400 ease-in-out top-0 z-10"
+                    className="w-full sticky py-4 transition-all duration-400 ease-in-out top-0 z-10 flex flex-row gap-4"
                     style={{ top: direction === "down" ? -84 : 0 }}>
                     <SearchBar onTextSearch={updateSearchResults}
                                placeholder={"Search collections"}
                                large={false}
-                               className={"w-full"}/>
+                               className={"w-full flex-grow"}/>
+                    {additionalActions}
                 </div>
 
                 <FavouritesView hidden={Boolean(filteredUrls)}/>

package/src/core/Scaffold.tsx

@@ -83,7 +83,6 @@ export const Scaffold = React.memo<PropsWithChildren<ScaffoldProps>>(
 
         const largeLayout = useLargeLayout();
 
-        const navigation = useNavigationController();
         const [drawerOpen, setDrawerOpen] = React.useState(false);
         const [onHover, setOnHover] = React.useState(false);
 
@@ -124,13 +123,11 @@ export const Scaffold = React.memo<PropsWithChildren<ScaffoldProps>>(
                     hovered={onHover}
                     setDrawerOpen={setDrawerOpen}>
                     {includeDrawer && (
-                        navigation.loading
-                            ? <CircularProgressCenter/>
-                            : <Drawer
-                                hovered={onHover}
-                                drawerOpen={computedDrawerOpen}
-                                closeDrawer={handleDrawerClose}
-                                {...drawerProps}/>)}
+                        <Drawer
+                            hovered={onHover}
+                            drawerOpen={computedDrawerOpen}
+                            closeDrawer={handleDrawerClose}
+                            {...drawerProps}/> )}
                 </StyledDrawer>
 
                 <main

package/src/form/components/StorageItemPreview.tsx

@@ -54,7 +54,7 @@ export function StorageItemPreview({
                     <PropertyPreview propertyKey={name}
                                      value={value}
                                      property={property}
-                                     entity={entity}
+                                     // entity={entity}
                                      size={size}/>
                 </ErrorBoundary>
             }

package/src/form/field_bindings/ReadOnlyFieldBinding.tsx

@@ -54,7 +54,7 @@ export function ReadOnlyFieldBinding({
                     <PropertyPreview propertyKey={propertyKey}
                                      value={value}
                                      property={property}
-                                     entity={entity}
+                                     // entity={entity}
                                      size={"medium"}/>
                 </ErrorBoundary>
 

package/src/index.ts

@@ -6,5 +6,3 @@ export * from "./hooks";
 export * from "./components";
 export * from "./util";
 export * from "./contexts";
-
-export * from "@firecms/ui";

package/src/internal/useBuildNavigationController.tsx

@@ -17,10 +17,10 @@ import {
     UserConfigurationPersistence
 } from "../types";
 import {
-    getCollectionByPathOrAlias,
+    getCollectionByPathOrId,
     mergeDeep,
     removeInitialAndTrailingSlashes,
-    resolveCollectionPathAliases,
+    resolveCollectionPathIds,
     resolvePermissions
 } from "../util";
 import { getParentReferencesFromPath } from "../util/parent_references_from_path";
@@ -149,7 +149,7 @@ export function useBuildNavigationController<EC extends EntityCollection, UserTy
         if (!collections)
             return undefined;
 
-        const baseCollection = getCollectionByPathOrAlias(removeInitialAndTrailingSlashes(idOrPath), collections);
+        const baseCollection = getCollectionByPathOrId(removeInitialAndTrailingSlashes(idOrPath), collections);
 
         const userOverride = includeUserOverride ? userConfigPersistence?.getCollectionConfig(idOrPath) : undefined;
 
@@ -239,7 +239,7 @@ export function useBuildNavigationController<EC extends EntityCollection, UserTy
     const resolveAliasesFrom = useCallback((path: string): string => {
         if (!collections)
             throw Error("Collections have not been initialised yet");
-        return resolveCollectionPathAliases(path, collections);
+        return resolveCollectionPathIds(path, collections);
     }, [collections]);
 
     const state = location.state as any;
@@ -261,6 +261,21 @@ export function useBuildNavigationController<EC extends EntityCollection, UserTy
         return getAllParentCollectionsForPath(path).map(r => r.id);
     }, [getAllParentCollectionsForPath])
 
+    const convertIdsToPaths = useCallback((ids: string[]): string[] => {
+            let currentCollections = collections;
+            const paths: string[] = [];
+            for (let i = 0; i < ids.length; i++) {
+                const id = ids[i];
+                const collection: EntityCollection | undefined = currentCollections!.find(c => c.id === id);
+                if (!collection)
+                    throw Error(`Collection with id ${id} not found`);
+                paths.push(collection.path);
+                currentCollections = collection.subcollections;
+            }
+            return paths;
+        }
+        , [getCollectionFromIds]);
+
     return useMemo(() => ({
         collections: collections ?? [],
         views: views ?? [],
@@ -283,7 +298,8 @@ export function useBuildNavigationController<EC extends EntityCollection, UserTy
         baseLocation,
         refreshNavigation,
         getParentReferencesFromPath: getAllParentCollectionsForPath,
-        getParentCollectionIds
+        getParentCollectionIds,
+        convertIdsToPaths
     }), [baseCollectionPath, baseLocation, basePath, buildCMSUrlPath, buildUrlCollectionPath, buildUrlEditCollectionPath, collections, getAllParentCollectionsForPath, getCollection, getCollectionFromPaths, homeUrl, initialised, isUrlCollectionPath, navigationLoading, navigationLoadingError, refreshNavigation, resolveAliasesFrom, topLevelNavigation, urlPathToDataPath, views]);
 }
 

package/src/preview/PropertyPreview.tsx

@@ -1,4 +1,6 @@
 import React, { createElement } from "react";
+import equal from "react-fast-compare"
+
 import {
     CMSType,
     EntityReference,
@@ -33,7 +35,7 @@ import { ErrorView } from "../components";
 /**
  * @group Preview components
  */
-export function PropertyPreview<T extends CMSType>(props: PropertyPreviewProps<T>) {
+export const PropertyPreview = React.memo(function PropertyPreview<T extends CMSType>(props: PropertyPreviewProps<T>) {
 
     const fireCMSContext = useFireCMSContext();
     let content: React.ReactNode | any;
@@ -44,7 +46,7 @@ export function PropertyPreview<T extends CMSType>(props: PropertyPreviewProps<T
         size,
         height,
         width,
-        entity
+        // entity
     } = props;
 
     const property = resolveProperty({
@@ -65,7 +67,7 @@ export function PropertyPreview<T extends CMSType>(props: PropertyPreviewProps<T
                 size,
                 height,
                 width,
-                entity,
+                // entity,
                 customProps: property.customProps
             });
     } else if (value === null) {
@@ -111,14 +113,14 @@ export function PropertyPreview<T extends CMSType>(props: PropertyPreviewProps<T
                                                     value={value}
                                                     property={property as ResolvedArrayProperty}/>;
                 }
-                // else if (arrayProperty.of.dataType === "map") {
-                //     content =
-                //         <ArrayOfMapsPreview propertyKey={propertyKey}
-                //                             property={property as ResolvedArrayProperty}
-                //                             value={value as Record<string, any>[]} // This might be wrong
-                //                             entity={entity}
-                //                             size={size}
-                //         />;
+                    // else if (arrayProperty.of.dataType === "map") {
+                    //     content =
+                    //         <ArrayOfMapsPreview propertyKey={propertyKey}
+                    //                             property={property as ResolvedArrayProperty}
+                    //                             value={value as Record<string, any>[]} // This might be wrong
+                    //                             entity={entity}
+                    //                             size={size}
+                    //         />;
                 // }
                 else if (arrayProperty.of.dataType === "reference") {
                     content = <ArrayOfReferencesPreview {...props}
@@ -180,7 +182,7 @@ export function PropertyPreview<T extends CMSType>(props: PropertyPreviewProps<T
                     disabled={!property.path}
                     previewProperties={property.previewProperties}
                     size={props.size}
-                    onClick={props.onClick}
+                    // onClick={props.onClick}
                     reference={value as EntityReference}
                 />;
             } else {
@@ -209,7 +211,7 @@ export function PropertyPreview<T extends CMSType>(props: PropertyPreviewProps<T
     }
 
     return content === undefined || content === null ? <EmptyValue/> : content;
-}
+}, equal);
 
 function buildWrongValueType(name: string | undefined, dataType: string, value: any) {
     console.warn(`Unexpected value for property ${name}, of type ${dataType}`, value);

package/src/preview/PropertyPreviewProps.tsx

@@ -27,7 +27,7 @@ export interface PropertyPreviewProps<T extends CMSType = any, CustomProps = any
     /**
      * Click handler
      */
-    onClick?: () => void;
+    // onClick?: () => void;
 
     /**
      * Desired size of the preview, depending on the context.
@@ -54,6 +54,6 @@ export interface PropertyPreviewProps<T extends CMSType = any, CustomProps = any
     /**
      * Entity this property refers to
      */
-    entity?: Entity<M>;
+    // entity?: Entity<M>;
 
 }

package/src/preview/components/ReferencePreview.tsx

@@ -160,7 +160,7 @@ function ReferencePreviewExisting<M extends Record<string, any> = any>({ referen
                                             propertyKey={key as string}
                                             value={getValueInPath(usedEntity.values, key)}
                                             property={childProperty as ResolvedProperty}
-                                            entity={usedEntity}
+                                            // entity={usedEntity}
                                             size={"tiny"}/>
                                         : <SkeletonPropertyComponent
                                             property={childProperty as ResolvedProperty}

package/src/preview/property_previews/ArrayOfMapsPreview.tsx

@@ -13,7 +13,7 @@ export function ArrayOfMapsPreview({
                                        value,
                                        property: inputProperty,
                                        size,
-                                       entity
+                                       // entity
                                    }: PropertyPreviewProps<Record<string, any>[]>) {
     const fireCMSContext = useFireCMSContext();
 
@@ -67,7 +67,7 @@ export function ArrayOfMapsPreview({
                                                     propertyKey={key as string}
                                                     value={(v)[key]}
                                                     property={properties[key as string]}
-                                                    entity={entity}
+                                                    // entity={entity}
                                                     size={"small"}/>
                                             </ErrorBoundary>
                                         </div>

package/src/preview/property_previews/ArrayOfStorageComponentsPreview.tsx

@@ -13,7 +13,7 @@ import { ErrorBoundary } from "../../components";
  */
 export function ArrayOfStorageComponentsPreview({
                                                     propertyKey,
-                                                    entity,
+                                                    // entity,
                                                     value,
                                                     property: inputProperty,
                                                     size
@@ -44,7 +44,7 @@ export function ArrayOfStorageComponentsPreview({
                         <PropertyPreview
                             propertyKey={propertyKey}
                             value={v}
-                            entity={entity}
+                            // entity={entity}
                             property={property.of as ResolvedProperty<string>}
                             size={childSize}/>
                     </ErrorBoundary>

package/src/preview/property_previews/ArrayOfStringsPreview.tsx

@@ -13,7 +13,7 @@ export function ArrayOfStringsPreview({
                                           propertyKey,
                                           value,
                                           property: inputProperty,
-                                          entity,
+                                          // entity,
                                           size
                                       }: PropertyPreviewProps<string[]>) {
 
@@ -45,7 +45,7 @@ export function ArrayOfStringsPreview({
                             <StringPropertyPreview propertyKey={propertyKey}
                                                    property={stringProperty}
                                                    value={v}
-                                                   entity={entity}
+                                                   // entity={entity}
                                                    size={size}/>
                         </ErrorBoundary>
                     </div>

package/src/preview/property_previews/ArrayOneOfPreview.tsx

@@ -16,7 +16,7 @@ export function ArrayOneOfPreview({
                                       value,
                                       property: inputProperty,
                                       size,
-                                      entity
+                                      // entity
                                   }: PropertyPreviewProps<any[]>) {
 
     const fireCMSContext = useFireCMSContext();
@@ -55,7 +55,7 @@ export function ArrayOneOfPreview({
                                 {value && <PropertyPreview
                                     propertyKey={propertyKey}
                                     value={value[valueField]}
-                                    entity={entity}
+                                    // entity={entity}
                                     property={(property.resolvedProperties[index] ?? properties[value[typeField]]) as ResolvedProperty<any>}
                                     size={childSize}/>}
                             </ErrorBoundary>

package/src/preview/property_previews/ArrayPropertyPreview.tsx

@@ -15,7 +15,7 @@ export function ArrayPropertyPreview({
                                          propertyKey,
                                          value,
                                          property: inputProperty,
-                                         entity,
+                                         // entity,
                                          size
                                      }: PropertyPreviewProps<any[]>) {
 
@@ -53,7 +53,7 @@ export function ArrayPropertyPreview({
                                     <ErrorBoundary>
                                         <PropertyPreview
                                             propertyKey={propertyKey}
-                                            entity={entity}
+                                            // entity={entity}
                                             value={value}
                                             property={of}
                                             size={childSize}/>

package/src/preview/property_previews/MapPropertyPreview.tsx

@@ -13,7 +13,7 @@ export function MapPropertyPreview<T extends Record<string, any> = Record<string
                                                                                             propertyKey,
                                                                                             value,
                                                                                             property,
-                                                                                            entity,
+                                                                                            // entity,
                                                                                             size
                                                                                         }: PropertyPreviewProps<T>) {
 
@@ -43,7 +43,7 @@ export function MapPropertyPreview<T extends Record<string, any> = Record<string
                             <PropertyPreview propertyKey={key}
                                              value={(value)[key]}
                                              property={mapProperty.properties![key]}
-                                             entity={entity}
+                                             // entity={entity}
                                              size={size}/>
                         </ErrorBoundary>
                     </div>
@@ -79,7 +79,7 @@ export function MapPropertyPreview<T extends Record<string, any> = Record<string
                                                 propertyKey={key}
                                                 value={(value)[key]}
                                                 property={childProperty}
-                                                entity={entity}
+                                                // entity={entity}
                                                 size={size}/>}
                                     </ErrorBoundary>
                                 </div>
@@ -91,7 +91,7 @@ export function MapPropertyPreview<T extends Record<string, any> = Record<string
                                         propertyKey={key}
                                         value={(value)[key]}
                                         property={childProperty}
-                                        entity={entity}
+                                        // entity={entity}
                                         size={size}/>
                                 </div>
                             }

package/src/types/navigation.ts

@@ -129,7 +129,7 @@ export type NavigationController = {
     refreshNavigation: () => void;
 
     /**
-     * Retrieve all the related parent collections for a given path
+     * Retrieve all the related parent references for a given path
      * @param path
      */
     getParentReferencesFromPath: (path: string) => EntityReference[];
@@ -139,6 +139,12 @@ export type NavigationController = {
      * @param path
      */
     getParentCollectionIds: (path: string) => string[];
+
+    /**
+     * Resolve paths from a list of ids
+     * @param ids
+     */
+    convertIdsToPaths: (ids: string[]) => string[];
 }
 
 /**

package/src/types/plugins.tsx

@@ -78,8 +78,21 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
 
     homePage?: {
 
+        /**
+         * Additional actions to be rendered in the home page, close to the search bar.
+         */
+        additionalActions?: React.ReactNode;
+
+        /**
+         * Additional children to be rendered in the beginning of the home page.
+         */
         additionalChildrenStart?: React.ReactNode;
+
+        /**
+         * Additional children to be rendered at the end of the home page.
+         */
         additionalChildrenEnd?: React.ReactNode;
+
         /**
          * Use this component to add custom actions to the navigation card
          * in the home page.