@btst/stack 1.5.0 → 1.5.2

package/dist/plugins/cms/client/index.d.cts

@@ -3,32 +3,96 @@ import * as react from 'react';
 import { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { a as AutoFormInputComponentProps } from '../../../shared/stack.NZJogTUn.cjs';
+import { ControllerRenderProps, FieldValues } from 'react-hook-form';
+import * as zod from 'zod';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'react-hook-form';
-import 'zod';
 
 /**
  * Context passed to loader hooks
  */
 interface LoaderContext {
+    /** Current route path */
     path: string;
+    /** Route parameters (e.g., { typeSlug: "product", id: "123" }) */
     params?: Record<string, string>;
+    /** Whether rendering on server (true) or client (false) */
     isSSR: boolean;
+    /** Base URL for API calls */
     apiBaseURL: string;
+    /** Path where the API is mounted */
     apiBasePath: string;
+    /** Optional headers for the request */
     headers?: Headers;
+    /** Additional context properties */
+    [key: string]: unknown;
+}
+/**
+ * Hooks for CMS client plugin
+ * All hooks are optional and allow consumers to customize behavior
+ */
+interface CMSClientHooks {
+    /**
+     * Called before loading the dashboard page. Return false to cancel loading.
+     * @param context - Loader context with path, params, etc.
+     */
+    beforeLoadDashboard?: (context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after the dashboard is loaded.
+     * @param context - Loader context
+     */
+    afterLoadDashboard?: (context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called before loading a content list page. Return false to cancel loading.
+     * @param typeSlug - The content type slug
+     * @param context - Loader context
+     */
+    beforeLoadContentList?: (typeSlug: string, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after a content list is loaded.
+     * @param typeSlug - The content type slug
+     * @param context - Loader context
+     */
+    afterLoadContentList?: (typeSlug: string, context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called before loading the content editor page. Return false to cancel loading.
+     * @param typeSlug - The content type slug
+     * @param id - The content item ID (undefined for new items)
+     * @param context - Loader context
+     */
+    beforeLoadContentEditor?: (typeSlug: string, id: string | undefined, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after the content editor is loaded.
+     * @param typeSlug - The content type slug
+     * @param id - The content item ID (undefined for new items)
+     * @param context - Loader context
+     */
+    afterLoadContentEditor?: (typeSlug: string, id: string | undefined, context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called when a loading error occurs.
+     * Use this for redirects on authorization failures.
+     * @param error - The error that occurred
+     * @param context - Loader context
+     */
+    onLoadError?: (error: Error, context: LoaderContext) => Promise<void> | void;
 }
 /**
  * Configuration for CMS client plugin
  */
 interface CMSClientConfig {
+    /** Base URL for API calls (e.g., "http://localhost:3000") */
     apiBaseURL: string;
+    /** Path where the API is mounted (e.g., "/api/data") */
     apiBasePath: string;
+    /** Base URL of your site */
     siteBaseURL: string;
+    /** Path where pages are mounted (e.g., "/pages") */
     siteBasePath: string;
+    /** React Query client instance for caching */
     queryClient: QueryClient;
+    /** Optional headers for SSR (e.g., forwarding cookies) */
     headers?: Headers;
+    /** Optional hooks for customizing behavior (authorization, redirects, etc.) */
+    hooks?: CMSClientHooks;
 }
 /**
  * CMS client plugin
@@ -174,6 +238,115 @@ declare const CMS_LOCALIZATION: {
 };
 type CMSLocalization = typeof CMS_LOCALIZATION;
 
+declare function AutoFormCheckbox({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormDate({ label, isRequired, field, fieldConfigItem, fieldProps, zodItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormEnum({ label, isRequired, field, fieldConfigItem, zodItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormInput({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormNumber({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormRadioGroup({ label, isRequired, field, zodItem, fieldProps, fieldConfigItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormSwitch({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormTextarea({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare const INPUT_COMPONENTS: {
+    checkbox: typeof AutoFormCheckbox;
+    date: typeof AutoFormDate;
+    select: typeof AutoFormEnum;
+    radio: typeof AutoFormRadioGroup;
+    switch: typeof AutoFormSwitch;
+    textarea: typeof AutoFormTextarea;
+    number: typeof AutoFormNumber;
+    fallback: typeof AutoFormInput;
+};
+
+/**
+ * Common input props shared by all field types.
+ */
+interface BaseInputProps {
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the field is read-only */
+    readOnly?: boolean;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether to show the label (auto-form specific) */
+    showLabel?: boolean;
+}
+/**
+ * Generic input props that accept any field type.
+ * Use this when the backing type is not known at compile time.
+ *
+ * This is the catch-all type used for runtime flexibility.
+ */
+interface SerializableInputProps extends BaseInputProps {
+    placeholder?: string;
+    type?: string;
+    defaultValue?: unknown;
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    autoComplete?: string;
+    /** Allow additional props for extensibility */
+    [key: string]: unknown;
+}
+
+/**
+ * Input props for form fields.
+ *
+ * This is the runtime type that accepts any input props.
+ * For type-safe props, use the discriminated types:
+ * - StringInputProps for text inputs
+ * - NumberInputProps for number inputs
+ * - BooleanInputProps for checkboxes/switches
+ * - DateInputProps for date pickers
+ * - EnumInputProps for selects/radios
+ */
+type FieldInputProps = SerializableInputProps & Omit<React.InputHTMLAttributes<HTMLInputElement>, keyof SerializableInputProps> & Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, keyof SerializableInputProps>;
+/**
+ * Configuration for a single field in AutoForm.
+ *
+ * Note: This type is designed to align with form-builder's FormBuilderFieldProps
+ * so that JSON Schema properties can be easily converted to field configs.
+ */
+type FieldConfigItem = {
+    /** Description text or React node */
+    description?: React.ReactNode;
+    /** Input props passed to the field component */
+    inputProps?: FieldInputProps;
+    /** Display label */
+    label?: string;
+    /** Field type override - built-in type or custom component */
+    fieldType?: keyof typeof INPUT_COMPONENTS | React.FC<AutoFormInputComponentProps>;
+    /** Wrapper component for custom field layout */
+    renderParent?: (props: {
+        children: React.ReactNode;
+    }) => React.ReactElement | null;
+    /** Display order for field ordering */
+    order?: number;
+};
+/**
+ * A FormInput component can handle a specific Zod type (e.g. "ZodBoolean")
+ */
+type AutoFormInputComponentProps = {
+    zodInputProps: React.InputHTMLAttributes<HTMLInputElement>;
+    field: ControllerRenderProps<FieldValues, any>;
+    fieldConfigItem: FieldConfigItem;
+    label: string;
+    isRequired: boolean;
+    fieldProps: any;
+    zodItem: zod.ZodType;
+    className?: string;
+};
+
 /**
  * Context passed to lifecycle hooks
  */
@@ -340,5 +513,5 @@ interface CMSFileUploadProps extends AutoFormInputComponentProps {
  */
 declare function CMSFileUpload({ label, isRequired, fieldConfigItem, fieldProps, field, uploadImage, }: CMSFileUploadProps): react_jsx_runtime.JSX.Element;
 
-export { AutoFormInputComponentProps, CMSFileUpload, cmsClientPlugin };
-export type { CMSClientConfig, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, LoaderContext, RouteContext };
+export { CMSFileUpload, cmsClientPlugin };
+export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, LoaderContext, RouteContext };

package/dist/plugins/cms/client/index.d.mts

@@ -3,32 +3,96 @@ import * as react from 'react';
 import { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { a as AutoFormInputComponentProps } from '../../../shared/stack.NZJogTUn.mjs';
+import { ControllerRenderProps, FieldValues } from 'react-hook-form';
+import * as zod from 'zod';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'react-hook-form';
-import 'zod';
 
 /**
  * Context passed to loader hooks
  */
 interface LoaderContext {
+    /** Current route path */
     path: string;
+    /** Route parameters (e.g., { typeSlug: "product", id: "123" }) */
     params?: Record<string, string>;
+    /** Whether rendering on server (true) or client (false) */
     isSSR: boolean;
+    /** Base URL for API calls */
     apiBaseURL: string;
+    /** Path where the API is mounted */
     apiBasePath: string;
+    /** Optional headers for the request */
     headers?: Headers;
+    /** Additional context properties */
+    [key: string]: unknown;
+}
+/**
+ * Hooks for CMS client plugin
+ * All hooks are optional and allow consumers to customize behavior
+ */
+interface CMSClientHooks {
+    /**
+     * Called before loading the dashboard page. Return false to cancel loading.
+     * @param context - Loader context with path, params, etc.
+     */
+    beforeLoadDashboard?: (context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after the dashboard is loaded.
+     * @param context - Loader context
+     */
+    afterLoadDashboard?: (context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called before loading a content list page. Return false to cancel loading.
+     * @param typeSlug - The content type slug
+     * @param context - Loader context
+     */
+    beforeLoadContentList?: (typeSlug: string, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after a content list is loaded.
+     * @param typeSlug - The content type slug
+     * @param context - Loader context
+     */
+    afterLoadContentList?: (typeSlug: string, context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called before loading the content editor page. Return false to cancel loading.
+     * @param typeSlug - The content type slug
+     * @param id - The content item ID (undefined for new items)
+     * @param context - Loader context
+     */
+    beforeLoadContentEditor?: (typeSlug: string, id: string | undefined, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after the content editor is loaded.
+     * @param typeSlug - The content type slug
+     * @param id - The content item ID (undefined for new items)
+     * @param context - Loader context
+     */
+    afterLoadContentEditor?: (typeSlug: string, id: string | undefined, context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called when a loading error occurs.
+     * Use this for redirects on authorization failures.
+     * @param error - The error that occurred
+     * @param context - Loader context
+     */
+    onLoadError?: (error: Error, context: LoaderContext) => Promise<void> | void;
 }
 /**
  * Configuration for CMS client plugin
  */
 interface CMSClientConfig {
+    /** Base URL for API calls (e.g., "http://localhost:3000") */
     apiBaseURL: string;
+    /** Path where the API is mounted (e.g., "/api/data") */
     apiBasePath: string;
+    /** Base URL of your site */
     siteBaseURL: string;
+    /** Path where pages are mounted (e.g., "/pages") */
     siteBasePath: string;
+    /** React Query client instance for caching */
     queryClient: QueryClient;
+    /** Optional headers for SSR (e.g., forwarding cookies) */
     headers?: Headers;
+    /** Optional hooks for customizing behavior (authorization, redirects, etc.) */
+    hooks?: CMSClientHooks;
 }
 /**
  * CMS client plugin
@@ -174,6 +238,115 @@ declare const CMS_LOCALIZATION: {
 };
 type CMSLocalization = typeof CMS_LOCALIZATION;
 
+declare function AutoFormCheckbox({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormDate({ label, isRequired, field, fieldConfigItem, fieldProps, zodItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormEnum({ label, isRequired, field, fieldConfigItem, zodItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormInput({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormNumber({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormRadioGroup({ label, isRequired, field, zodItem, fieldProps, fieldConfigItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormSwitch({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormTextarea({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare const INPUT_COMPONENTS: {
+    checkbox: typeof AutoFormCheckbox;
+    date: typeof AutoFormDate;
+    select: typeof AutoFormEnum;
+    radio: typeof AutoFormRadioGroup;
+    switch: typeof AutoFormSwitch;
+    textarea: typeof AutoFormTextarea;
+    number: typeof AutoFormNumber;
+    fallback: typeof AutoFormInput;
+};
+
+/**
+ * Common input props shared by all field types.
+ */
+interface BaseInputProps {
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the field is read-only */
+    readOnly?: boolean;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether to show the label (auto-form specific) */
+    showLabel?: boolean;
+}
+/**
+ * Generic input props that accept any field type.
+ * Use this when the backing type is not known at compile time.
+ *
+ * This is the catch-all type used for runtime flexibility.
+ */
+interface SerializableInputProps extends BaseInputProps {
+    placeholder?: string;
+    type?: string;
+    defaultValue?: unknown;
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    autoComplete?: string;
+    /** Allow additional props for extensibility */
+    [key: string]: unknown;
+}
+
+/**
+ * Input props for form fields.
+ *
+ * This is the runtime type that accepts any input props.
+ * For type-safe props, use the discriminated types:
+ * - StringInputProps for text inputs
+ * - NumberInputProps for number inputs
+ * - BooleanInputProps for checkboxes/switches
+ * - DateInputProps for date pickers
+ * - EnumInputProps for selects/radios
+ */
+type FieldInputProps = SerializableInputProps & Omit<React.InputHTMLAttributes<HTMLInputElement>, keyof SerializableInputProps> & Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, keyof SerializableInputProps>;
+/**
+ * Configuration for a single field in AutoForm.
+ *
+ * Note: This type is designed to align with form-builder's FormBuilderFieldProps
+ * so that JSON Schema properties can be easily converted to field configs.
+ */
+type FieldConfigItem = {
+    /** Description text or React node */
+    description?: React.ReactNode;
+    /** Input props passed to the field component */
+    inputProps?: FieldInputProps;
+    /** Display label */
+    label?: string;
+    /** Field type override - built-in type or custom component */
+    fieldType?: keyof typeof INPUT_COMPONENTS | React.FC<AutoFormInputComponentProps>;
+    /** Wrapper component for custom field layout */
+    renderParent?: (props: {
+        children: React.ReactNode;
+    }) => React.ReactElement | null;
+    /** Display order for field ordering */
+    order?: number;
+};
+/**
+ * A FormInput component can handle a specific Zod type (e.g. "ZodBoolean")
+ */
+type AutoFormInputComponentProps = {
+    zodInputProps: React.InputHTMLAttributes<HTMLInputElement>;
+    field: ControllerRenderProps<FieldValues, any>;
+    fieldConfigItem: FieldConfigItem;
+    label: string;
+    isRequired: boolean;
+    fieldProps: any;
+    zodItem: zod.ZodType;
+    className?: string;
+};
+
 /**
  * Context passed to lifecycle hooks
  */
@@ -340,5 +513,5 @@ interface CMSFileUploadProps extends AutoFormInputComponentProps {
  */
 declare function CMSFileUpload({ label, isRequired, fieldConfigItem, fieldProps, field, uploadImage, }: CMSFileUploadProps): react_jsx_runtime.JSX.Element;
 
-export { AutoFormInputComponentProps, CMSFileUpload, cmsClientPlugin };
-export type { CMSClientConfig, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, LoaderContext, RouteContext };
+export { CMSFileUpload, cmsClientPlugin };
+export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, LoaderContext, RouteContext };

package/dist/plugins/cms/client/index.d.ts

@@ -3,32 +3,96 @@ import * as react from 'react';
 import { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { a as AutoFormInputComponentProps } from '../../../shared/stack.NZJogTUn.js';
+import { ControllerRenderProps, FieldValues } from 'react-hook-form';
+import * as zod from 'zod';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'react-hook-form';
-import 'zod';
 
 /**
  * Context passed to loader hooks
  */
 interface LoaderContext {
+    /** Current route path */
     path: string;
+    /** Route parameters (e.g., { typeSlug: "product", id: "123" }) */
     params?: Record<string, string>;
+    /** Whether rendering on server (true) or client (false) */
     isSSR: boolean;
+    /** Base URL for API calls */
     apiBaseURL: string;
+    /** Path where the API is mounted */
     apiBasePath: string;
+    /** Optional headers for the request */
     headers?: Headers;
+    /** Additional context properties */
+    [key: string]: unknown;
+}
+/**
+ * Hooks for CMS client plugin
+ * All hooks are optional and allow consumers to customize behavior
+ */
+interface CMSClientHooks {
+    /**
+     * Called before loading the dashboard page. Return false to cancel loading.
+     * @param context - Loader context with path, params, etc.
+     */
+    beforeLoadDashboard?: (context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after the dashboard is loaded.
+     * @param context - Loader context
+     */
+    afterLoadDashboard?: (context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called before loading a content list page. Return false to cancel loading.
+     * @param typeSlug - The content type slug
+     * @param context - Loader context
+     */
+    beforeLoadContentList?: (typeSlug: string, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after a content list is loaded.
+     * @param typeSlug - The content type slug
+     * @param context - Loader context
+     */
+    afterLoadContentList?: (typeSlug: string, context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called before loading the content editor page. Return false to cancel loading.
+     * @param typeSlug - The content type slug
+     * @param id - The content item ID (undefined for new items)
+     * @param context - Loader context
+     */
+    beforeLoadContentEditor?: (typeSlug: string, id: string | undefined, context: LoaderContext) => Promise<boolean> | boolean;
+    /**
+     * Called after the content editor is loaded.
+     * @param typeSlug - The content type slug
+     * @param id - The content item ID (undefined for new items)
+     * @param context - Loader context
+     */
+    afterLoadContentEditor?: (typeSlug: string, id: string | undefined, context: LoaderContext) => Promise<void> | void;
+    /**
+     * Called when a loading error occurs.
+     * Use this for redirects on authorization failures.
+     * @param error - The error that occurred
+     * @param context - Loader context
+     */
+    onLoadError?: (error: Error, context: LoaderContext) => Promise<void> | void;
 }
 /**
  * Configuration for CMS client plugin
  */
 interface CMSClientConfig {
+    /** Base URL for API calls (e.g., "http://localhost:3000") */
     apiBaseURL: string;
+    /** Path where the API is mounted (e.g., "/api/data") */
     apiBasePath: string;
+    /** Base URL of your site */
     siteBaseURL: string;
+    /** Path where pages are mounted (e.g., "/pages") */
     siteBasePath: string;
+    /** React Query client instance for caching */
     queryClient: QueryClient;
+    /** Optional headers for SSR (e.g., forwarding cookies) */
     headers?: Headers;
+    /** Optional hooks for customizing behavior (authorization, redirects, etc.) */
+    hooks?: CMSClientHooks;
 }
 /**
  * CMS client plugin
@@ -174,6 +238,115 @@ declare const CMS_LOCALIZATION: {
 };
 type CMSLocalization = typeof CMS_LOCALIZATION;
 
+declare function AutoFormCheckbox({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormDate({ label, isRequired, field, fieldConfigItem, fieldProps, zodItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormEnum({ label, isRequired, field, fieldConfigItem, zodItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormInput({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormNumber({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormRadioGroup({ label, isRequired, field, zodItem, fieldProps, fieldConfigItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormSwitch({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormTextarea({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare const INPUT_COMPONENTS: {
+    checkbox: typeof AutoFormCheckbox;
+    date: typeof AutoFormDate;
+    select: typeof AutoFormEnum;
+    radio: typeof AutoFormRadioGroup;
+    switch: typeof AutoFormSwitch;
+    textarea: typeof AutoFormTextarea;
+    number: typeof AutoFormNumber;
+    fallback: typeof AutoFormInput;
+};
+
+/**
+ * Common input props shared by all field types.
+ */
+interface BaseInputProps {
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the field is read-only */
+    readOnly?: boolean;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether to show the label (auto-form specific) */
+    showLabel?: boolean;
+}
+/**
+ * Generic input props that accept any field type.
+ * Use this when the backing type is not known at compile time.
+ *
+ * This is the catch-all type used for runtime flexibility.
+ */
+interface SerializableInputProps extends BaseInputProps {
+    placeholder?: string;
+    type?: string;
+    defaultValue?: unknown;
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    autoComplete?: string;
+    /** Allow additional props for extensibility */
+    [key: string]: unknown;
+}
+
+/**
+ * Input props for form fields.
+ *
+ * This is the runtime type that accepts any input props.
+ * For type-safe props, use the discriminated types:
+ * - StringInputProps for text inputs
+ * - NumberInputProps for number inputs
+ * - BooleanInputProps for checkboxes/switches
+ * - DateInputProps for date pickers
+ * - EnumInputProps for selects/radios
+ */
+type FieldInputProps = SerializableInputProps & Omit<React.InputHTMLAttributes<HTMLInputElement>, keyof SerializableInputProps> & Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, keyof SerializableInputProps>;
+/**
+ * Configuration for a single field in AutoForm.
+ *
+ * Note: This type is designed to align with form-builder's FormBuilderFieldProps
+ * so that JSON Schema properties can be easily converted to field configs.
+ */
+type FieldConfigItem = {
+    /** Description text or React node */
+    description?: React.ReactNode;
+    /** Input props passed to the field component */
+    inputProps?: FieldInputProps;
+    /** Display label */
+    label?: string;
+    /** Field type override - built-in type or custom component */
+    fieldType?: keyof typeof INPUT_COMPONENTS | React.FC<AutoFormInputComponentProps>;
+    /** Wrapper component for custom field layout */
+    renderParent?: (props: {
+        children: React.ReactNode;
+    }) => React.ReactElement | null;
+    /** Display order for field ordering */
+    order?: number;
+};
+/**
+ * A FormInput component can handle a specific Zod type (e.g. "ZodBoolean")
+ */
+type AutoFormInputComponentProps = {
+    zodInputProps: React.InputHTMLAttributes<HTMLInputElement>;
+    field: ControllerRenderProps<FieldValues, any>;
+    fieldConfigItem: FieldConfigItem;
+    label: string;
+    isRequired: boolean;
+    fieldProps: any;
+    zodItem: zod.ZodType;
+    className?: string;
+};
+
 /**
  * Context passed to lifecycle hooks
  */
@@ -340,5 +513,5 @@ interface CMSFileUploadProps extends AutoFormInputComponentProps {
  */
 declare function CMSFileUpload({ label, isRequired, fieldConfigItem, fieldProps, field, uploadImage, }: CMSFileUploadProps): react_jsx_runtime.JSX.Element;
 
-export { AutoFormInputComponentProps, CMSFileUpload, cmsClientPlugin };
-export type { CMSClientConfig, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, LoaderContext, RouteContext };
+export { CMSFileUpload, cmsClientPlugin };
+export type { AutoFormInputComponentProps, CMSClientConfig, CMSClientHooks, CMSFileUploadProps, CMSLocalization, CMSPluginOverrides, LoaderContext, RouteContext };

package/dist/plugins/cms/query-keys.d.cts

@@ -1,11 +1,8 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { S as SerializedContentType, P as PaginatedContentItems, a as SerializedContentItemWithType } from '../../shared/stack.BwkyFwF8.cjs';
+import { S as SerializedContentType, P as PaginatedContentItems, a as SerializedContentItemWithType } from '../../shared/stack.L-UFwz2G.cjs';
 import { CMSApiRouter } from './api/index.cjs';
 import 'zod';
-import '../../shared/stack.NZJogTUn.cjs';
-import 'react-hook-form';
-import 'react/jsx-runtime';
 import '@btst/stack/plugins/api';
 import 'better-call';