@btst/plugin-cms 1.0.0-beta.0 → 1.2.0-beta.0

package/dist/client/hooks/index.d.ts

@@ -1,6 +1,7 @@
 'use client';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { SerializedContentItemWithType, CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult, SerializedContentType, CMSContentTypeMap, SerializedContentRevision, InverseRelation } from '../../types.js';
 import { ResourceFormConfig, ResourceFormResult, ResourceSelectResult } from '@btst/stack/plugins/client/hooks';
-import { SerializedContentItemWithType, CMSReadView, CMSContentFields, CMSReadOptions, CMSContentItemResult, SerializedContentType, CMSContentTypeMap, InverseRelation } from '../../types.js';
 import 'zod';
 
 interface UseContentTypesResult {
@@ -207,10 +208,12 @@ declare function useCreateContent<TData = Record<string, unknown>>(typeSlug: str
     mutate: (vars: {
         slug: string;
         data: TData;
+        publishAt?: string | null;
     }) => void;
     mutateAsync: (vars: {
         slug: string;
         data: TData;
+        publishAt?: string | null;
     }) => Promise<SerializedContentItemWithType<TData>>;
     data: undefined;
     variables: undefined;
@@ -230,16 +233,19 @@ declare function useCreateContent<TData = Record<string, unknown>>(typeSlug: str
     mutate: (vars: {
         slug: string;
         data: TData;
+        publishAt?: string | null;
     }) => void;
     mutateAsync: (vars: {
         slug: string;
         data: TData;
+        publishAt?: string | null;
     }) => Promise<SerializedContentItemWithType<TData>>;
     data: undefined;
     variables: {
         typeSlug: string;
         slug: string;
         data: Record<string, unknown>;
+        publishAt?: string | null;
     };
     error: null;
     isError: false;
@@ -257,10 +263,12 @@ declare function useCreateContent<TData = Record<string, unknown>>(typeSlug: str
     mutate: (vars: {
         slug: string;
         data: TData;
+        publishAt?: string | null;
     }) => void;
     mutateAsync: (vars: {
         slug: string;
         data: TData;
+        publishAt?: string | null;
     }) => Promise<SerializedContentItemWithType<TData>>;
     data: undefined;
     error: Error;
@@ -268,6 +276,7 @@ declare function useCreateContent<TData = Record<string, unknown>>(typeSlug: str
         typeSlug: string;
         slug: string;
         data: Record<string, unknown>;
+        publishAt?: string | null;
     };
     isError: true;
     isIdle: false;
@@ -284,10 +293,12 @@ declare function useCreateContent<TData = Record<string, unknown>>(typeSlug: str
     mutate: (vars: {
         slug: string;
         data: TData;
+        publishAt?: string | null;
     }) => void;
     mutateAsync: (vars: {
         slug: string;
         data: TData;
+        publishAt?: string | null;
     }) => Promise<SerializedContentItemWithType<TData>>;
     data: SerializedContentItemWithType<Record<string, unknown>> | null;
     error: null;
@@ -295,6 +306,7 @@ declare function useCreateContent<TData = Record<string, unknown>>(typeSlug: str
         typeSlug: string;
         slug: string;
         data: Record<string, unknown>;
+        publishAt?: string | null;
     };
     isError: false;
     isIdle: false;
@@ -330,6 +342,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: TData;
+            publishAt?: string | null;
         };
     }) => void;
     mutateAsync: (vars: {
@@ -337,6 +350,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: TData;
+            publishAt?: string | null;
         };
     }) => Promise<SerializedContentItemWithType<TData>>;
     data: undefined;
@@ -359,6 +373,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: TData;
+            publishAt?: string | null;
         };
     }) => void;
     mutateAsync: (vars: {
@@ -366,6 +381,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: TData;
+            publishAt?: string | null;
         };
     }) => Promise<SerializedContentItemWithType<TData>>;
     data: undefined;
@@ -375,6 +391,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: Record<string, unknown>;
+            publishAt?: string | null;
         };
     };
     error: null;
@@ -395,6 +412,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: TData;
+            publishAt?: string | null;
         };
     }) => void;
     mutateAsync: (vars: {
@@ -402,6 +420,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: TData;
+            publishAt?: string | null;
         };
     }) => Promise<SerializedContentItemWithType<TData>>;
     data: undefined;
@@ -412,6 +431,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: Record<string, unknown>;
+            publishAt?: string | null;
         };
     };
     isError: true;
@@ -431,6 +451,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: TData;
+            publishAt?: string | null;
         };
     }) => void;
     mutateAsync: (vars: {
@@ -438,6 +459,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: TData;
+            publishAt?: string | null;
         };
     }) => Promise<SerializedContentItemWithType<TData>>;
     data: SerializedContentItemWithType<Record<string, unknown>> | null;
@@ -448,6 +470,7 @@ declare function useUpdateContent<TData = Record<string, unknown>>(typeSlug: str
         data: {
             slug?: string;
             data?: Record<string, unknown>;
+            publishAt?: string | null;
         };
     };
     isError: false;
@@ -688,6 +711,287 @@ declare function useInverseRelationItems<TView extends CMSReadView = undefined,
     error: Error | null;
     refetch: () => void;
 };
+/** Paginated revision snapshots, newest first. Fetches only when enabled. */
+declare function useContentRevisions(typeSlug: string, id: string, enabled?: boolean): {
+    revisions: SerializedContentRevision[];
+    data: _tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchNextPageError: boolean;
+    isFetchingNextPage: boolean;
+    isFetchPreviousPageError: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+} | {
+    revisions: SerializedContentRevision[];
+    data: _tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+} | {
+    revisions: SerializedContentRevision[];
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+} | {
+    revisions: SerializedContentRevision[];
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+} | {
+    revisions: SerializedContentRevision[];
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+} | {
+    revisions: SerializedContentRevision[];
+    data: _tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    status: "success";
+    fetchNextPage: (options?: _tanstack_react_query.FetchNextPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchPreviousPage: (options?: _tanstack_react_query.FetchPreviousPageOptions) => Promise<_tanstack_react_query.InfiniteQueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<_tanstack_react_query.InfiniteData<{
+        items: SerializedContentRevision[];
+        total: number;
+    }, number>, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+};
+/** Restore a saved revision and refresh the editor, history and relation queries. */
+declare function useRestoreContentRevision(): _tanstack_react_query.UseMutationResult<SerializedContentItemWithType<Record<string, unknown>>, Error, {
+    typeSlug: string;
+    id: string;
+    revisionId: string;
+}>;
 
-export { useContent, useContentByRelation, useContentItem, useContentItemBySlug, useContentItemForm, useContentItemPopulated, useContentOptions, useContentType, useContentTypes, useCreateContent, useDeleteContent, useInverseRelationItems, useInverseRelations, useSuspenseContent, useSuspenseContentByRelation, useSuspenseContentItem, useSuspenseContentItemPopulated, useSuspenseContentTypes, useUpdateContent };
+export { useContent, useContentByRelation, useContentItem, useContentItemBySlug, useContentItemForm, useContentItemPopulated, useContentOptions, useContentRevisions, useContentType, useContentTypes, useCreateContent, useDeleteContent, useInverseRelationItems, useInverseRelations, useRestoreContentRevision, useSuspenseContent, useSuspenseContentByRelation, useSuspenseContentItem, useSuspenseContentItemPopulated, useSuspenseContentTypes, useUpdateContent };
 export type { ContentItemWithRelations, UseContentByRelationOptions, UseContentOptions, UseContentResult, UseContentTypesResult };

package/dist/client/hooks/index.mjs

@@ -1 +1 @@
-export { useContent, useContentByRelation, useContentItem, useContentItemBySlug, useContentItemForm, useContentItemPopulated, useContentOptions, useContentType, useContentTypes, useCreateContent, useDeleteContent, useInverseRelationItems, useInverseRelations, useSuspenseContent, useSuspenseContentByRelation, useSuspenseContentItem, useSuspenseContentItemPopulated, useSuspenseContentTypes, useUpdateContent } from './cms-hooks.mjs';
+export { useContent, useContentByRelation, useContentItem, useContentItemBySlug, useContentItemForm, useContentItemPopulated, useContentOptions, useContentRevisions, useContentType, useContentTypes, useCreateContent, useDeleteContent, useInverseRelationItems, useInverseRelations, useRestoreContentRevision, useSuspenseContent, useSuspenseContentByRelation, useSuspenseContentItem, useSuspenseContentItemPopulated, useSuspenseContentTypes, useUpdateContent } from './cms-hooks.mjs';

package/dist/client/index.d.cts

@@ -4,12 +4,30 @@ import * as _btst_yar from '@btst/yar';
 import * as react from 'react';
 import { ComponentType } from 'react';
 import { D as DashboardPageComponent } from '../shared/plugin-cms.BBshPRkb.cjs';
-import { ContentTypeConfig } from '../types.cjs';
+import { SerializedContentType, ContentTypeConfig } from '../types.cjs';
 export { CMSContentFields, CMSContentItemResult, CMSReadOptions, CMSReadView, CMSSelectedData, PaginatedContentItems, SerializedContentItemContent } from '../types.cjs';
 import { ControllerRenderProps, FieldValues } from 'react-hook-form';
 import * as z from 'zod';
 import { z as z$1 } from 'zod';
 
+/** Content supplied to a CMS empty-state presentation. */
+interface EmptyStateProps {
+    title: string;
+    description?: string;
+    action?: React.ReactNode;
+}
+
+/** Display data and navigation supplied by the CMS dashboard. */
+interface ContentTypeCardProps {
+    contentType: SerializedContentType & {
+        itemCount: number;
+    };
+    itemCountLabel: string;
+    onOpen: () => void;
+    className?: string;
+    titleClassName?: string;
+}
+
 declare const CMS_LOCALIZATION: {
     CMS_RELATION_LOADING: string;
     CMS_RELATION_SELECT_PLACEHOLDER: string;
@@ -93,6 +111,15 @@ declare const CMS_LOCALIZATION: {
 };
 type CMSLocalization = typeof CMS_LOCALIZATION;
 
+/** A single visibility condition against a sibling field's value. */
+type ShowIfCondition = {
+    field: string;
+    operator: "equals" | "notEquals" | "in" | "isTruthy";
+    value?: unknown;
+};
+
+declare function AutoFormFile({ field, fieldProps, fieldConfigItem, label, isRequired }: AutoFormInputComponentProps): react.JSX.Element;
+
 declare function AutoFormCheckbox({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react.JSX.Element;
 
 declare function AutoFormDate({ label, isRequired, field, fieldConfigItem, fieldProps, zodItem, }: AutoFormInputComponentProps): react.JSX.Element;
@@ -110,6 +137,7 @@ declare function AutoFormSwitch({ label, isRequired, field, fieldConfigItem, fie
 declare function AutoFormTextarea({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react.JSX.Element;
 
 declare const INPUT_COMPONENTS: {
+    file: typeof AutoFormFile;
     checkbox: typeof AutoFormCheckbox;
     date: typeof AutoFormDate;
     select: typeof AutoFormEnum;
@@ -173,6 +201,10 @@ type FieldInputProps = SerializableInputProps & Omit<React.InputHTMLAttributes<H
  * so that JSON Schema properties can be easily converted to field configs.
  */
 type FieldConfigItem = {
+    /** Show this field only when the condition matches. */
+    showIf?: ShowIfCondition;
+    /** Standalone file upload handler; resolves to a stored URL. */
+    onUpload?: (file: File) => Promise<string>;
     /** Description text or React node */
     description?: React.ReactNode;
     /** Input props passed to the field component */
@@ -238,6 +270,22 @@ interface RouteContext {
  * plugin-specific components and behavior.
  */
 interface CMSPluginOverrides {
+    /** Presentation scoped to built-in route keys. */
+    pageOverrides?: {
+        dashboard?: {
+            ContentTypeCard?: ComponentType<ContentTypeCardProps>;
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        contentList?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        newContent?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        editContent?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+    };
     /**
      * Function used to upload a new image file and return its URL.
      * Used by the default "file" field component when not selecting an existing
@@ -542,6 +590,8 @@ declare const cmsClientPlugin: (config?: CMSClientConfig) => _btst_stack_client.
 interface FormStep {
     id: string;
     title: string;
+    /** Display this step only when its condition matches. */
+    showIf?: ShowIfCondition;
 }
 interface FormSchemaMetadata {
     /** Multi-step form step definitions */
@@ -555,6 +605,9 @@ interface JsonSchemaProperty {
     formatMinimum?: string;
     formatMaximum?: string;
     stepGroup?: number;
+    showIf?: ShowIfCondition;
+    items?: JsonSchemaProperty;
+    required?: string[];
     properties?: Record<string, JsonSchemaProperty>;
     [key: string]: unknown;
 }
@@ -651,4 +704,4 @@ interface CMSFileUploadProps extends AutoFormInputComponentProps {
 declare function CMSFileUpload({ label, isRequired, fieldConfigItem, fieldProps, field, uploadImage, imageInputField: ImageInputField, imagePicker: ImagePickerTrigger, }: CMSFileUploadProps): react.JSX.Element;
 
 export { CMSFileUpload, ContentTypeConfig, cmsClientPlugin, formSchemaToZod, getStepGroupMap, getSteps, hasSteps, zodToFormSchema };
-export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, CMSProviderConfig, FormSchemaMetadata, FormStep, LoaderContext, RouteContext };
+export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, CMSProviderConfig, ContentTypeCardProps, EmptyStateProps, FormSchemaMetadata, FormStep, LoaderContext, RouteContext };

package/dist/client/index.d.mts

@@ -4,12 +4,30 @@ import * as _btst_yar from '@btst/yar';
 import * as react from 'react';
 import { ComponentType } from 'react';
 import { D as DashboardPageComponent } from '../shared/plugin-cms.BBshPRkb.mjs';
-import { ContentTypeConfig } from '../types.mjs';
+import { SerializedContentType, ContentTypeConfig } from '../types.mjs';
 export { CMSContentFields, CMSContentItemResult, CMSReadOptions, CMSReadView, CMSSelectedData, PaginatedContentItems, SerializedContentItemContent } from '../types.mjs';
 import { ControllerRenderProps, FieldValues } from 'react-hook-form';
 import * as z from 'zod';
 import { z as z$1 } from 'zod';
 
+/** Content supplied to a CMS empty-state presentation. */
+interface EmptyStateProps {
+    title: string;
+    description?: string;
+    action?: React.ReactNode;
+}
+
+/** Display data and navigation supplied by the CMS dashboard. */
+interface ContentTypeCardProps {
+    contentType: SerializedContentType & {
+        itemCount: number;
+    };
+    itemCountLabel: string;
+    onOpen: () => void;
+    className?: string;
+    titleClassName?: string;
+}
+
 declare const CMS_LOCALIZATION: {
     CMS_RELATION_LOADING: string;
     CMS_RELATION_SELECT_PLACEHOLDER: string;
@@ -93,6 +111,15 @@ declare const CMS_LOCALIZATION: {
 };
 type CMSLocalization = typeof CMS_LOCALIZATION;
 
+/** A single visibility condition against a sibling field's value. */
+type ShowIfCondition = {
+    field: string;
+    operator: "equals" | "notEquals" | "in" | "isTruthy";
+    value?: unknown;
+};
+
+declare function AutoFormFile({ field, fieldProps, fieldConfigItem, label, isRequired }: AutoFormInputComponentProps): react.JSX.Element;
+
 declare function AutoFormCheckbox({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react.JSX.Element;
 
 declare function AutoFormDate({ label, isRequired, field, fieldConfigItem, fieldProps, zodItem, }: AutoFormInputComponentProps): react.JSX.Element;
@@ -110,6 +137,7 @@ declare function AutoFormSwitch({ label, isRequired, field, fieldConfigItem, fie
 declare function AutoFormTextarea({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react.JSX.Element;
 
 declare const INPUT_COMPONENTS: {
+    file: typeof AutoFormFile;
     checkbox: typeof AutoFormCheckbox;
     date: typeof AutoFormDate;
     select: typeof AutoFormEnum;
@@ -173,6 +201,10 @@ type FieldInputProps = SerializableInputProps & Omit<React.InputHTMLAttributes<H
  * so that JSON Schema properties can be easily converted to field configs.
  */
 type FieldConfigItem = {
+    /** Show this field only when the condition matches. */
+    showIf?: ShowIfCondition;
+    /** Standalone file upload handler; resolves to a stored URL. */
+    onUpload?: (file: File) => Promise<string>;
     /** Description text or React node */
     description?: React.ReactNode;
     /** Input props passed to the field component */
@@ -238,6 +270,22 @@ interface RouteContext {
  * plugin-specific components and behavior.
  */
 interface CMSPluginOverrides {
+    /** Presentation scoped to built-in route keys. */
+    pageOverrides?: {
+        dashboard?: {
+            ContentTypeCard?: ComponentType<ContentTypeCardProps>;
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        contentList?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        newContent?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+        editContent?: {
+            EmptyState?: ComponentType<EmptyStateProps>;
+        };
+    };
     /**
      * Function used to upload a new image file and return its URL.
      * Used by the default "file" field component when not selecting an existing
@@ -542,6 +590,8 @@ declare const cmsClientPlugin: (config?: CMSClientConfig) => _btst_stack_client.
 interface FormStep {
     id: string;
     title: string;
+    /** Display this step only when its condition matches. */
+    showIf?: ShowIfCondition;
 }
 interface FormSchemaMetadata {
     /** Multi-step form step definitions */
@@ -555,6 +605,9 @@ interface JsonSchemaProperty {
     formatMinimum?: string;
     formatMaximum?: string;
     stepGroup?: number;
+    showIf?: ShowIfCondition;
+    items?: JsonSchemaProperty;
+    required?: string[];
     properties?: Record<string, JsonSchemaProperty>;
     [key: string]: unknown;
 }
@@ -651,4 +704,4 @@ interface CMSFileUploadProps extends AutoFormInputComponentProps {
 declare function CMSFileUpload({ label, isRequired, fieldConfigItem, fieldProps, field, uploadImage, imageInputField: ImageInputField, imagePicker: ImagePickerTrigger, }: CMSFileUploadProps): react.JSX.Element;
 
 export { CMSFileUpload, ContentTypeConfig, cmsClientPlugin, formSchemaToZod, getStepGroupMap, getSteps, hasSteps, zodToFormSchema };
-export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, CMSProviderConfig, FormSchemaMetadata, FormStep, LoaderContext, RouteContext };
+export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, CMSProviderConfig, ContentTypeCardProps, EmptyStateProps, FormSchemaMetadata, FormStep, LoaderContext, RouteContext };