@firecms/core 3.0.1 → 3.1.0-canary.1df3b2c

package/dist/preview/PropertyPreviewProps.d.ts

@@ -42,4 +42,9 @@ export interface PropertyPreviewProps<T extends CMSType = any, CustomProps = any
      * This applies only to videos.
      */
     interactive?: boolean;
+    /**
+     * If true, image previews will fill their container completely.
+     * Only applies to image type properties.
+     */
+    fill?: boolean;
 }

package/dist/preview/components/DatePreview.d.ts

@@ -1,7 +1,17 @@
 import React from "react";
+export interface DatePreviewProps {
+    date: Date;
+    /**
+     * Display mode: "date" for date-only, "date_time" for date and time
+     */
+    mode?: "date" | "date_time";
+    /**
+     * IANA timezone identifier (e.g., "America/New_York")
+     * When specified, the date will be displayed in this timezone
+     */
+    timezone?: string;
+}
 /**
  * @group Preview components
  */
-export declare function DatePreview({ date }: {
-    date: Date;
-}): React.ReactElement;
+export declare function DatePreview({ date, mode, timezone }: DatePreviewProps): React.ReactElement;

package/dist/preview/components/ImagePreview.d.ts

@@ -5,8 +5,12 @@ import { PreviewSize } from "../PropertyPreviewProps";
 export interface ImagePreviewProps {
     size: PreviewSize;
     url: string;
+    /**
+     * If true, image fills its container completely with object-fit cover
+     */
+    fill?: boolean;
 }
 /**
  * @group Preview components
  */
-export declare function ImagePreview({ size, url }: ImagePreviewProps): import("react/jsx-runtime").JSX.Element;
+export declare function ImagePreview({ size, url, fill }: ImagePreviewProps): import("react/jsx-runtime").JSX.Element;

package/dist/preview/components/StorageThumbnail.d.ts

@@ -5,10 +5,11 @@ type StorageThumbnailProps = {
     storeUrl: boolean;
     size: PreviewSize;
     interactive?: boolean;
+    fill?: boolean;
 };
 /**
  * @group Preview components
  */
 export declare const StorageThumbnail: React.FunctionComponent<StorageThumbnailProps>;
-export declare function StorageThumbnailInternal({ storeUrl, interactive, storagePathOrDownloadUrl, size }: StorageThumbnailProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function StorageThumbnailInternal({ storeUrl, interactive, storagePathOrDownloadUrl, size, fill }: StorageThumbnailProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/preview/components/UrlComponentPreview.d.ts

@@ -4,10 +4,11 @@ import { PreviewSize } from "../PropertyPreviewProps";
 /**
  * @group Preview components
  */
-export declare function UrlComponentPreview({ url, previewType, size, hint, interactive }: {
+export declare function UrlComponentPreview({ url, previewType, size, hint, interactive, fill }: {
     url: string;
     previewType?: PreviewType;
     size: PreviewSize;
     hint?: string;
     interactive?: boolean;
+    fill?: boolean;
 }): React.ReactElement;

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

@@ -2,4 +2,4 @@ import { PropertyPreviewProps } from "../PropertyPreviewProps";
 /**
  * @group Preview components
  */
-export declare function ArrayOfStorageComponentsPreview({ propertyKey, 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 | null;

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, 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 | null;

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

@@ -8,7 +8,7 @@ export interface SkeletonPropertyComponentProps {
  * @group Preview components
  */
 export declare function SkeletonPropertyComponent({ property, size }: SkeletonPropertyComponentProps): any;
-export declare function renderSkeletonImageThumbnail(size: PreviewSize): import("react/jsx-runtime").JSX.Element;
+export declare function renderSkeletonImageThumbnail(size: PreviewSize, fill?: boolean): import("react/jsx-runtime").JSX.Element;
 export declare function renderSkeletonText(index?: number, width?: number): import("react/jsx-runtime").JSX.Element;
 export declare function renderSkeletonCaptionText(index?: number): import("react/jsx-runtime").JSX.Element;
 export declare function renderSkeletonIcon(): import("react/jsx-runtime").JSX.Element;

package/dist/types/collections.d.ts

@@ -318,7 +318,46 @@ export interface EntityCollection<M extends Record<string, any> = any, USER exte
      * Defaults to `manual_apply`.
      */
     localChangesBackup?: "manual_apply" | "auto_apply" | false;
+    /**
+     * Default view mode for displaying this collection.
+     * - "table": Display entities in a spreadsheet-like table (default)
+     * - "cards": Display entities as a grid of cards with thumbnails
+     * - "kanban": Display entities in a Kanban board grouped by a property
+     * Defaults to "table".
+     */
+    defaultViewMode?: ViewMode;
+    /**
+     * Configuration for Kanban board view mode.
+     * When set, the Kanban view mode becomes available.
+     */
+    kanban?: KanbanConfig<M>;
+    /**
+     * Property key to use for ordering items.
+     * Must reference a number property. When items are reordered,
+     * this property will be updated to reflect the new order using
+     * fractional indexing. Used by Kanban view for ordering within columns
+     * and can be used for general ordering purposes.
+     */
+    orderProperty?: Extract<keyof M, string>;
 }
+/**
+ * Configuration for Kanban board view mode.
+ * @group Collections
+ */
+export interface KanbanConfig<M extends Record<string, any> = any> {
+    /**
+     * Property key to use for Kanban board columns.
+     * Must reference a string property with enumValues defined.
+     * Entities will be grouped into columns based on this property's value.
+     * The column order is determined by the order of enumValues in the property.
+     */
+    columnProperty: Extract<keyof M, string>;
+}
+/**
+ * View mode for displaying a collection.
+ * @group Collections
+ */
+export type ViewMode = "table" | "cards" | "kanban";
 /**
  * Parameter passed to the `Actions` prop in the collection configuration.
  * The component will receive this prop when it is rendered in the collection
@@ -359,9 +398,10 @@ export interface CollectionActionsProps<M extends Record<string, any> = any, USE
      */
     context: FireCMSContext<USER>;
     /**
-     * Count of the entities in this collection
+     * Count of the entities in this collection.
+     * undefined means the count is still loading.
      */
-    collectionEntitiesCount: number;
+    collectionEntitiesCount?: number;
 }
 /**
  * Use this controller to retrieve the selected entities or modify them in

package/dist/types/datasource.d.ts

@@ -267,7 +267,6 @@ export interface DataSourceDelegate {
     currentTime?: () => any;
     delegateToCMSModel: (data: any) => any;
     cmsToDelegateModel: (data: any) => any;
-    setDateToMidnight: (input?: any) => any;
     initTextSearch?: (props: {
         context: FireCMSContext;
         path: string;

package/dist/types/plugins.d.ts

@@ -6,7 +6,7 @@ import { FieldProps, FormContext } from "./fields";
 import { CMSType, Property } from "./properties";
 import { EntityStatus } from "./entities";
 import { ResolvedProperty } from "./resolved_entities";
-import { NavigationGroupMapping } from "./navigation";
+import { NavigationGroupMapping, CMSView } from "./navigation";
 import { InternalUserManagement } from "./internal_user_management";
 /**
  * Interface used to define plugins for FireCMS.
@@ -39,6 +39,11 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
         props?: PROPS;
     };
     userManagement?: InternalUserManagement;
+    /**
+     * Views to be automatically added to the navigation.
+     * These views will be merged with the views provided to useBuildNavigationController.
+     */
+    views?: CMSView[];
     homePage?: {
         /**
          * Additional actions to be rendered in the home page, close to the search bar.
@@ -135,6 +140,46 @@ export type FireCMSPlugin<PROPS = any, FORM_PROPS = any, EC extends EntityCollec
             collection: EC;
             tableController: EntityTableController;
         }>;
+        /**
+         * Callback called when columns are reordered via drag and drop.
+         * Used by plugins to persist the new column order.
+         */
+        onColumnsReorder?: (props: {
+            fullPath: string;
+            parentCollectionIds: string[];
+            collection: EC;
+            newPropertiesOrder: string[];
+        }) => void;
+        /**
+         * Callback called when Kanban board columns are reordered via drag and drop.
+         * Used by plugins to persist the new Kanban column order.
+         */
+        onKanbanColumnsReorder?: (props: {
+            fullPath: string;
+            parentCollectionIds: string[];
+            collection: EC;
+            kanbanColumnProperty: string;
+            newColumnsOrder: string[];
+        }) => void;
+        /**
+         * Component to render when Kanban view is missing configuration.
+         * Used to provide a CTA to open the collection editor to configure Kanban.
+         */
+        KanbanSetupComponent?: React.ComponentType<{
+            collection: EC;
+            fullPath: string;
+            parentCollectionIds: string[];
+        }>;
+        /**
+         * Component to render an "Add Column" button at the end of the Kanban board.
+         * Used to allow adding new enum values to the column property.
+         */
+        AddKanbanColumnComponent?: React.ComponentType<{
+            collection: EC;
+            fullPath: string;
+            parentCollectionIds: string[];
+            columnProperty: string;
+        }>;
     };
     form?: {
         provider?: {

package/dist/types/properties.d.ts

@@ -113,6 +113,18 @@ export interface BaseProperty<T extends CMSType, CustomProps = any> {
      * It defaults to 100, but you can set it to 50 to have two fields in the same row.
      */
     widthPercentage?: number;
+    /**
+     * Declarative conditions for dynamic property behavior using JSON Logic.
+     *
+     * An alternative to PropertyBuilder functions that can be:
+     * - Stored in the database as JSON
+     * - Edited via the collection editor UI
+     * - Evaluated at runtime like property builders
+     *
+     * @see PropertyConditions for available condition options
+     * @see https://jsonlogic.com/ for JSON Logic syntax
+     */
+    conditions?: PropertyConditions;
 }
 /**
  * @group Entity properties
@@ -136,6 +148,220 @@ export interface PropertyDisabledConfig {
      */
     hidden?: boolean;
 }
+/**
+ * A JSON Logic rule that gets evaluated at runtime.
+ * @see https://jsonlogic.com/
+ *
+ * Common operators:
+ * - Comparison: ==, !=, ===, !==, >, <, >=, <=
+ * - Logic: and, or, !, !!
+ * - Data access: var, missing, missing_some
+ * - Array: in, map, filter, reduce, all, some, none, merge
+ * - String: substr, cat
+ * - Numeric: +, -, *, /, %, min, max
+ *
+ * Custom operators:
+ * - hasRole(roleId) - check if user has role by ID
+ * - hasAnyRole([roleIds]) - check if user has any of the roles
+ * - isToday(timestamp) - check if timestamp is today
+ * - isPast(timestamp) - check if timestamp is in the past
+ * - isFuture(timestamp) - check if timestamp is in the future
+ *
+ * @group Entity properties
+ */
+export type JsonLogicRule = Record<string, any>;
+/**
+ * Conditions for individual enum values within a property.
+ * @group Entity properties
+ */
+export interface EnumValueConditions {
+    /**
+     * Disable this enum option when condition is true.
+     * The option appears grayed out and cannot be selected.
+     */
+    disabled?: JsonLogicRule;
+    /**
+     * Message explaining why this option is disabled.
+     */
+    disabledMessage?: string;
+    /**
+     * Completely hide this enum option when condition is true.
+     * The option is removed from the dropdown/list.
+     */
+    hidden?: JsonLogicRule;
+}
+/**
+ * Declarative conditions for dynamic property behavior.
+ * All conditions are JSON Logic rules evaluated against ConditionContext.
+ *
+ * An alternative to PropertyBuilder functions that can be:
+ * - Stored in the database as JSON
+ * - Edited via the collection editor UI
+ * - Evaluated at runtime like property builders
+ *
+ * @see https://jsonlogic.com/ for JSON Logic syntax
+ * @group Entity properties
+ */
+export interface PropertyConditions {
+    /**
+     * Disable the field when this condition evaluates to true.
+     * The field becomes non-editable but still visible (unless also hidden).
+     *
+     * @example Disable when another field has a specific value
+     * ```json
+     * { "==": [{ "var": "values.status" }, "archived"] }
+     * ```
+     */
+    disabled?: JsonLogicRule;
+    /**
+     * Message to display when the field is disabled by a condition.
+     */
+    disabledMessage?: string;
+    /**
+     * Clear the field's value when it becomes disabled.
+     * @default false
+     */
+    clearOnDisabled?: boolean;
+    /**
+     * Hide the field completely when this condition evaluates to true.
+     * The field is removed from the form (not just visually hidden).
+     */
+    hidden?: JsonLogicRule;
+    /**
+     * Make the field read-only when this condition evaluates to true.
+     * Renders as a preview instead of an input.
+     */
+    readOnly?: JsonLogicRule;
+    /**
+     * Make the field required when this condition evaluates to true.
+     * Overrides the static `validation.required` setting.
+     */
+    required?: JsonLogicRule;
+    /**
+     * Custom message when conditional required validation fails.
+     */
+    requiredMessage?: string;
+    /**
+     * Dynamic minimum value for number/string length.
+     * Should evaluate to a number.
+     */
+    min?: JsonLogicRule;
+    /**
+     * Dynamic maximum value for number/string length.
+     * Should evaluate to a number.
+     */
+    max?: JsonLogicRule;
+    /**
+     * Dynamic default value for new entities.
+     * Should evaluate to a value of the appropriate type for the field.
+     * Only applied when entityId is empty (new entity).
+     */
+    defaultValue?: JsonLogicRule;
+    /**
+     * Conditions for individual enum values.
+     * Keys are the enum value IDs, values are condition configs.
+     *
+     * @example Disable certain enum options based on user role
+     * ```json
+     * {
+     *   "admin": {
+     *     "disabled": { "!": { "hasRole": "admin" } },
+     *     "disabledMessage": "Admin option requires admin role"
+     *   }
+     * }
+     * ```
+     */
+    enumConditions?: Record<string | number, EnumValueConditions>;
+    /**
+     * Filter which enum values are available.
+     * Should evaluate to an array of allowed enum value IDs.
+     */
+    allowedEnumValues?: JsonLogicRule;
+    /**
+     * Exclude specific enum values.
+     * Should evaluate to an array of enum value IDs to exclude.
+     */
+    excludedEnumValues?: JsonLogicRule;
+    /**
+     * Dynamic path for reference properties.
+     * Should evaluate to a collection path string.
+     */
+    referencePath?: JsonLogicRule;
+    /**
+     * Dynamic filter for reference selection.
+     * Should evaluate to a FilterValues object.
+     */
+    referenceFilter?: JsonLogicRule;
+    /**
+     * Can elements be added to the array?
+     */
+    canAddElements?: JsonLogicRule;
+    /**
+     * Can elements be reordered in the array?
+     */
+    sortable?: JsonLogicRule;
+    /**
+     * Dynamic accepted file types.
+     * Should evaluate to an array of MIME types.
+     */
+    acceptedFiles?: JsonLogicRule;
+    /**
+     * Dynamic maximum file size in bytes.
+     * Should evaluate to a number.
+     */
+    maxFileSize?: JsonLogicRule;
+}
+/**
+ * Context available during JSON Logic condition evaluation.
+ * Mirrors PropertyBuilderProps but adapted for JSON serialization.
+ * @group Entity properties
+ */
+export interface ConditionContext {
+    /**
+     * Current form/entity values.
+     * Date values are converted to Unix timestamps (milliseconds).
+     */
+    values: Record<string, any>;
+    /**
+     * Previous values before the current edit session.
+     */
+    previousValues: Record<string, any>;
+    /**
+     * Current value of this property specifically.
+     */
+    propertyValue: any;
+    /**
+     * Collection path (e.g., "products", "users/uid123/orders")
+     */
+    path: string;
+    /**
+     * Entity ID. Undefined for new entities.
+     */
+    entityId?: string;
+    /**
+     * Whether this is a new entity being created.
+     */
+    isNew: boolean;
+    /**
+     * Index of this property (only for array items).
+     */
+    index?: number;
+    /**
+     * Current authenticated user information.
+     */
+    user: {
+        uid: string;
+        email: string | null;
+        displayName: string | null;
+        photoURL: string | null;
+        /** Role IDs the user has (extracted from Role[].id) */
+        roles: string[];
+    };
+    /**
+     * Current timestamp as Unix milliseconds.
+     */
+    now: number;
+}
 /**
  * @group Entity properties
  */
@@ -262,6 +488,25 @@ export interface BooleanProperty extends BaseProperty<boolean> {
      */
     validation?: PropertyValidationSchema;
 }
+/**
+ * Configuration options for the markdown editor.
+ * @group Entity properties
+ */
+export interface MarkdownConfig {
+    /**
+     * Allow HTML input/output. When set to false, HTML tags in pasted content
+     * will be stripped and only markdown-compatible formatting will be preserved.
+     * Defaults to true for backwards compatibility.
+     */
+    html?: boolean;
+    /**
+     * Convert pasted text to markdown format. When enabled, rich text pasted
+     * from external sources (like Google Docs or Word) will be converted to
+     * clean markdown instead of preserving HTML styles.
+     * Defaults to false.
+     */
+    transformPastedText?: boolean;
+}
 /**
  * @group Entity properties
  */
@@ -275,10 +520,13 @@ export interface StringProperty extends BaseProperty<string> {
     multiline?: boolean;
     /**
      * Should this string property be displayed as a markdown field. If true,
-     * the field is rendered as a text editors that supports markdown highlight
+     * the field is rendered as a text editor that supports markdown highlight
      * syntax. It also includes a preview of the result.
+     *
+     * You can also pass a configuration object to customize the markdown editor
+     * behavior, particularly how HTML content is handled during paste operations.
      */
-    markdown?: boolean;
+    markdown?: boolean | MarkdownConfig;
     /**
      * You can use the enum values providing a map of possible
      * exclusive values the property can take, mapped to the label that it is
@@ -486,6 +734,13 @@ export interface DateProperty extends BaseProperty<Date> {
      * Add an icon to clear the value and set it to `null`. Defaults to `false`
      */
     clearable?: boolean;
+    /**
+     * IANA timezone string (e.g., "America/New_York", "Europe/London").
+     * Used to display and input dates in the specified timezone.
+     * The value stored will always be in UTC.
+     * If not provided, uses the user's local timezone.
+     */
+    timezone?: string;
 }
 /**
  * @group Entity properties
@@ -764,7 +1019,7 @@ export interface ImageResize {
      * - `contain`: Scale down to fit within bounds, preserving aspect ratio (default)
      * - `cover`: Scale to fill bounds, preserving aspect ratio (may crop)
      */
-    mode?: 'contain' | 'cover';
+    mode?: "contain" | "cover";
     /**
      * Output format for the resized image.
      * - `original`: Keep the original format (default)
@@ -772,7 +1027,7 @@ export interface ImageResize {
      * - `png`: Convert to PNG
      * - `webp`: Convert to WebP
      */
-    format?: 'original' | 'jpeg' | 'png' | 'webp';
+    format?: "original" | "jpeg" | "png" | "webp";
     /**
      * Quality for lossy formats (JPEG, WebP). Number between 0 and 100.
      * Higher is better quality but larger file size. Defaults to 80.

package/dist/util/__tests__/conditions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/util/__tests__/objects.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/util/conditions.d.ts

@@ -0,0 +1,26 @@
+import { AuthController, ConditionContext, JsonLogicRule, ResolvedProperty, CMSType } from "../types";
+/**
+ * Register custom JSON Logic operations for FireCMS.
+ * Call this once at app initialization.
+ */
+export declare function registerConditionOperations(): void;
+/**
+ * Evaluate a JSON Logic rule against the given context.
+ */
+export declare function evaluateCondition(rule: JsonLogicRule, context: ConditionContext): any;
+/**
+ * Build a ConditionContext from the current property resolution context.
+ */
+export declare function buildConditionContext(params: {
+    propertyKey?: string;
+    values?: Record<string, any>;
+    previousValues?: Record<string, any>;
+    path: string;
+    entityId?: string;
+    index?: number;
+    authController: AuthController;
+}): ConditionContext;
+/**
+ * Apply PropertyConditions to a resolved property, evaluating all JSON Logic rules.
+ */
+export declare function applyPropertyConditions<T extends CMSType>(property: ResolvedProperty<T>, context: ConditionContext): ResolvedProperty<T>;

package/dist/util/entities.d.ts

@@ -9,12 +9,11 @@ export declare function getDefaultValueForDataType(dataType: DataType): {} | nul
  * Update the automatic values in an entity before save
  * @group Datasource
  */
-export declare function updateDateAutoValues<M extends Record<string, any>>({ inputValues, properties, status, timestampNowValue, setDateToMidnight }: {
+export declare function updateDateAutoValues<M extends Record<string, any>>({ inputValues, properties, status, timestampNowValue }: {
     inputValues: Partial<EntityValues<M>>;
     properties: ResolvedProperties<M>;
     status: EntityStatus;
     timestampNowValue: any;
-    setDateToMidnight: (input?: any) => any | undefined;
 }): EntityValues<M>;
 /**
  * Add missing required fields, expected in the collection, to the values of an entity

package/dist/util/index.d.ts

@@ -16,7 +16,7 @@ export * from "./icon_list";
 export * from "./icon_synonyms";
 export * from "./icons";
 export * from "./plurals";
-export * from "./references";
+export * from "./previews";
 export * from "./flatten_object";
 export * from "./make_properties_editable";
 export * from "./join_collections";
@@ -24,3 +24,4 @@ export * from "./builders";
 export * from "./useTraceUpdate";
 export * from "./storage";
 export * from "./callbacks";
+export * from "./conditions";

package/dist/util/property_utils.d.ts

@@ -15,7 +15,8 @@ export declare function getPropertyInPath<M extends Record<string, any>>(propert
 export declare function getResolvedPropertyInPath(properties: Record<string, ResolvedProperty>, path: string): ResolvedProperty | undefined;
 export declare function getBracketNotation(path: string): string;
 /**
- * Get properties exclusively indexed by their order
+ * Get properties sorted by their order, but include ALL properties.
+ * Nested keys (like "data.mode") in propertiesOrder are ignored - they're for column ordering.
  * @param properties
  * @param propertiesOrder
  */

package/dist/util/resolutions.d.ts

@@ -54,7 +54,7 @@ export declare function resolveArrayProperty<T extends any[], M>({ propertyKey,
     propertyConfigs?: Record<string, PropertyConfig>;
     ignoreMissingFields?: boolean;
     authController: AuthController;
-}): ResolvedArrayProperty;
+}): ResolvedArrayProperty | null;
 /**
  * Resolve enums and arrays for properties
  * @param properties