@firecms/core 3.0.0-rc.1 → 3.0.0-rc.3

package/dist/components/HomePage/HomePageDnD.d.ts

@@ -16,7 +16,7 @@ export declare function SortableNavigationGroup({ groupName, children, disabled
     children: React.ReactNode;
     disabled?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function useHomePageDnd({ items: dndItems, setItems: setDndItems, disabled, onCardMovedBetweenGroups, onGroupMoved, onNewGroupDrop, onPersist }: {
+export declare function useHomePageDnd({ items, setItems, disabled, onCardMovedBetweenGroups, onGroupMoved, onNewGroupDrop, onPersist }: {
     items: {
         name: string;
         entries: NavigationEntry[];
@@ -67,6 +67,7 @@ export declare function useHomePageDnd({ items: dndItems, setItems: setDndItems,
     dialogOpenForGroup: string | null;
     setDialogOpenForGroup: React.Dispatch<React.SetStateAction<string | null>>;
     handleRenameGroup: (oldName: string, newName: string) => void;
+    handleDialogClose: () => void;
     isHoveringNewGroupDropZone: boolean;
     setIsHoveringNewGroupDropZone: React.Dispatch<React.SetStateAction<boolean>>;
 };

package/dist/components/PropertyCollectionView.d.ts

@@ -0,0 +1,23 @@
+import { PreviewSize } from "../preview";
+import { ResolvedProperties, ResolvedProperty } from "../types";
+/**
+ * Build a readable label for a path and resolve the property
+ * Supports map and array (including arrays of maps)
+ */
+export declare function buildPropertyLabelAndGetProperty(properties: ResolvedProperties, key: string): {
+    label: string;
+    property: ResolvedProperty | undefined;
+};
+/**
+ * Improved simple layout for nested changes:
+ * - Map or Array-of-Map -> section header + indented rows
+ * - Leaf or Array-of-Primitives -> single row with label and value
+ */
+export declare const PropertyCollectionView: ({ data, properties, baseKey, suppressHeader, size }: {
+    data: any;
+    properties: ResolvedProperties;
+    baseKey?: string;
+    suppressHeader?: boolean;
+    size?: PreviewSize;
+}) => import("react/jsx-runtime").JSX.Element | null;
+export declare function buildDataFromPaths(values: object, paths: string[]): object;

package/dist/components/UserDisplay.d.ts

@@ -0,0 +1,7 @@
+import { User } from "../types";
+/**
+ * Component to render a single user with name and email
+ */
+export declare function UserDisplay({ user, }: {
+    user: User | null;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/VirtualTable/fields/VirtualTableUserSelect.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+export declare function VirtualTableUserSelect(props: {
+    name: string;
+    error: Error | undefined;
+    multiple: boolean;
+    disabled: boolean;
+    small: boolean;
+    internalValue: string | string[] | undefined;
+    updateValue: (newValue: (string | string[] | null)) => void;
+    focused: boolean;
+    onBlur?: React.FocusEventHandler<HTMLInputElement | HTMLTextAreaElement>;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/contexts/InternalUserManagementContext.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import { InternalUserManagement } from "../types";
+export declare const InternalUserManagementContext: React.Context<InternalUserManagement<any>>;

package/dist/core/EntityEditView.d.ts

@@ -11,6 +11,12 @@ export type OnUpdateParams = {
     selectedTab?: string;
     collection: EntityCollection<any>;
 };
+export type BarActionsParams = {
+    values: object;
+    status: EntityStatus;
+    path: string;
+    entityId?: string;
+};
 export type OnTabChangeParams<M extends Record<string, any>> = {
     path: string;
     entityId?: string;
@@ -32,11 +38,11 @@ export interface EntityEditViewProps<M extends Record<string, any>> {
     copy?: boolean;
     selectedTab?: string;
     parentCollectionIds: string[];
-    onValuesModified?: (modified: boolean) => void;
+    onValuesModified?: (modified: boolean, values: M) => void;
     onSaved?: (params: OnUpdateParams) => void;
     onTabChange?: (props: OnTabChangeParams<M>) => void;
     layout?: "side_panel" | "full_screen";
-    barActions?: React.ReactNode;
+    barActions?: (params: BarActionsParams) => React.ReactNode;
     formProps?: Partial<EntityFormProps<M>>;
 }
 /**
@@ -44,9 +50,9 @@ export interface EntityEditViewProps<M extends Record<string, any>> {
  * an entity is opened.
  */
 export declare function EntityEditView<M extends Record<string, any>, USER extends User>({ entityId, ...props }: EntityEditViewProps<M>): import("react/jsx-runtime").JSX.Element;
-export declare function EntityEditViewInner<M extends Record<string, any>>({ path, fullIdPath, entityId, selectedTab: selectedTabProp, collection, parentCollectionIds, onValuesModified, onSaved, onTabChange, entity, cachedDirtyValues, dataLoading, layout, barActions, status, setStatus, formProps, canEdit }: EntityEditViewProps<M> & {
+export declare function EntityEditViewInner<M extends Record<string, any>>({ path, fullIdPath, entityId, selectedTab: selectedTabProp, collection, parentCollectionIds, onValuesModified, onSaved, onTabChange, entity, initialDirtyValues, dataLoading, layout, barActions, status, setStatus, formProps, canEdit }: EntityEditViewProps<M> & {
     entity?: Entity<M>;
-    cachedDirtyValues?: Partial<M>;
+    initialDirtyValues?: Partial<M>;
     dataLoading: boolean;
     status: EntityStatus;
     setStatus: (status: EntityStatus) => void;

package/dist/core/FireCMS.d.ts

@@ -8,7 +8,6 @@ import { FireCMSProps, User } from "../types";
  *
  * You only need to use this component if you are building a custom app.
  *
-
  * @group Core
  */
 export declare function FireCMS<USER extends User>(props: FireCMSProps<USER>): import("react/jsx-runtime").JSX.Element;

package/dist/core/field_configs.d.ts

@@ -3,5 +3,5 @@ export declare function isDefaultFieldConfigId(id: string): boolean;
 export declare const DEFAULT_FIELD_CONFIGS: Record<string, PropertyConfig<any>>;
 export declare function getDefaultFieldConfig(property: Property | ResolvedProperty): PropertyConfig | undefined;
 export declare function getFieldConfig(property: Property | ResolvedProperty, propertyConfigs: Record<string, PropertyConfig<any>>): PropertyConfig | undefined;
-export declare function getDefaultFieldId(property: Property | ResolvedProperty): "reference" | "date_time" | "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_as_string" | "multi_references" | "switch" | "repeat" | "custom_array" | "block" | undefined;
+export declare function getDefaultFieldId(property: Property | ResolvedProperty): "reference" | "date_time" | "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_as_string" | "multi_references" | "switch" | "repeat" | "custom_array" | "block" | undefined;
 export declare function getFieldId(property: Property | ResolvedProperty): string | undefined;

package/dist/form/EntityForm.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { Entity, EntityCollection, EntityCustomViewParams, EntityStatus, FormContext } from "../types";
+import { AuthController, Entity, EntityCollection, EntityCustomViewParams, EntityStatus, EntityValues, FormContext, PropertyConfig } from "../types";
 import { FormexController } from "@firecms/formex";
 import { ValidationError } from "yup";
 import { EntityFormActionsProps } from "./EntityFormActions";
@@ -19,7 +19,7 @@ export type EntityFormProps<M extends Record<string, any>> = {
     entity?: Entity<M>;
     databaseId?: string;
     onIdChange?: (id: string) => void;
-    onValuesModified?: (modified: boolean) => void;
+    onValuesModified?: (modified: boolean, values: M) => void;
     onSaved?: (params: OnUpdateParams) => void;
     initialDirtyValues?: Partial<M>;
     onFormContextReady?: (formContext: FormContext) => void;
@@ -46,5 +46,8 @@ export type EntityFormProps<M extends Record<string, any>> = {
     Builder?: React.ComponentType<EntityCustomViewParams<M>>;
     children?: React.ReactNode;
 };
+export declare function extractTouchedValues(values: any, touched: Record<string, boolean>): Record<string, any>;
+export declare function getChanges<T extends object>(source: Partial<T>, comparison: Partial<T>): Partial<T>;
 export declare function EntityForm<M extends Record<string, any>>({ path, fullIdPath, entityId: entityIdProp, collection, onValuesModified, onIdChange, onSaved, entity, initialDirtyValues, onFormContextReady, forceActionsAtTheBottom, initialStatus, className, onStatusChange, onEntityChange, openEntityMode, formex: formexProp, disabled: disabledProp, Builder, EntityFormActionsComponent, showDefaultActions, showEntityPath, children }: EntityFormProps<M>): import("react/jsx-runtime").JSX.Element;
+export declare function getInitialEntityValues<M extends object>(authController: AuthController, collection: EntityCollection, path: string, status: "new" | "existing" | "copy", entity: Entity<M> | undefined, propertyConfigs?: Record<string, PropertyConfig>): Partial<EntityValues<M>>;
 export declare function yupToFormErrors(yupError: ValidationError): Record<string, any>;

package/dist/form/components/LocalChangesMenu.d.ts

@@ -0,0 +1,11 @@
+import { FormexController } from "@firecms/formex";
+import { ResolvedProperties } from "../../types";
+interface LocalChangesMenuProps<M extends object> {
+    cacheKey: string;
+    localChangesData: Partial<M>;
+    formex: FormexController<M>;
+    onClearLocalChanges?: () => void;
+    properties: ResolvedProperties<M>;
+}
+export declare function LocalChangesMenu<M extends object>({ localChangesData, formex, onClearLocalChanges, cacheKey, properties }: LocalChangesMenuProps<M>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/form/field_bindings/UserSelectFieldBinding.d.ts

@@ -0,0 +1,12 @@
+import { FieldProps } from "../../types";
+type UserSelectProps = FieldProps<string>;
+/**
+ * Field binding for selecting a user from the internal user management system.
+ * Renders a select dropdown with user information including name and email.
+ *
+ * This is one of the internal components that get mapped natively inside forms
+ * and tables to the specified properties.
+ * @group Form fields
+ */
+export declare function UserSelectFieldBinding({ propertyKey, value, setValue, error, showError, disabled, autoFocus, touched, property, includeDescription, size }: UserSelectProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/form/index.d.ts

@@ -1,4 +1,5 @@
-export * from "./EntityForm";
+export { EntityForm, yupToFormErrors, } from "./EntityForm";
+export type { EntityFormProps } from "./EntityForm";
 export { SelectFieldBinding } from "./field_bindings/SelectFieldBinding";
 export { MultiSelectFieldBinding } from "./field_bindings/MultiSelectFieldBinding";
 export { ArrayOfReferencesFieldBinding } from "./field_bindings/ArrayOfReferencesFieldBinding";

package/dist/hooks/index.d.ts

@@ -15,6 +15,8 @@ export * from "./useSnackbarController";
 export * from "./useModeController";
 export * from "./useClipboard";
 export * from "./useLargeLayout";
+export * from "./useCollapsedGroups";
+export * from "./useInternalUserManagementController";
 export * from "./useReferenceDialog";
 export * from "./useBrowserTitleAndIcon";
 export * from "./useCustomizationController";

package/dist/hooks/useCollapsedGroups.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Custom hook for managing collapsed/expanded state of navigation groups
+ * with localStorage persistence. Automatically cleans up stale group entries
+ * when groups are removed from the navigation.
+ */
+export declare function useCollapsedGroups(groupNames: string[]): {
+    isGroupCollapsed: (name: string) => boolean;
+    toggleGroupCollapsed: (name: string) => void;
+};

package/dist/hooks/useInternalUserManagementController.d.ts

@@ -0,0 +1,12 @@
+import { InternalUserManagement, User } from "../types";
+/**
+ * Use this hook to get the internal user management of the app.
+ * Note that this is different from the user management plugin controller.
+ * This controller will be eventually replaced by the one provided
+ * by the user management plugin.
+ *
+ * Use at your own risk!
+ *
+ * @group Hooks and utilities
+ */
+export declare const useInternalUserManagementController: <USER extends User = User>() => InternalUserManagement<USER>;