@faasjs/ant-design 8.0.0-beta.29 → 8.0.0-beta.30

package/README.md

@@ -39,12 +39,13 @@
 - [BaseItemProps](interfaces/BaseItemProps.md)
 - [BlankProps](interfaces/BlankProps.md)
 - [ConfigProviderProps](interfaces/ConfigProviderProps.md)
+- [DescriptionCommonProps](interfaces/DescriptionCommonProps.md)
 - [DescriptionItemContentProps](interfaces/DescriptionItemContentProps.md)
 - [DescriptionItemProps](interfaces/DescriptionItemProps.md)
-- [DescriptionProps](interfaces/DescriptionProps.md)
+- [DescriptionWithFaasProps](interfaces/DescriptionWithFaasProps.md)
+- [DescriptionWithoutFaasProps](interfaces/DescriptionWithoutFaasProps.md)
 - [DrawerProps](interfaces/DrawerProps.md)
 - [ErrorBoundaryProps](interfaces/ErrorBoundaryProps.md)
-- [ExtendDescriptionTypeProps](interfaces/ExtendDescriptionTypeProps.md)
 - [ExtendFormItemProps](interfaces/ExtendFormItemProps.md)
 - [FaasDataWrapperProps](interfaces/FaasDataWrapperProps.md)
 - [FaasItemProps](interfaces/FaasItemProps.md)
@@ -61,8 +62,11 @@
 
 ## Type Aliases
 
+- [BaseExtendTypeProps](type-aliases/BaseExtendTypeProps.md)
 - [BaseOption](type-aliases/BaseOption.md)
+- [DescriptionProps](type-aliases/DescriptionProps.md)
 - [ExtendDescriptionItemProps](type-aliases/ExtendDescriptionItemProps.md)
+- [ExtendDescriptionTypeProps](type-aliases/ExtendDescriptionTypeProps.md)
 - [ExtendFormTypeProps](type-aliases/ExtendFormTypeProps.md)
 - [ExtendTableItemProps](type-aliases/ExtendTableItemProps.md)
 - [ExtendTableTypeProps](type-aliases/ExtendTableTypeProps.md)
@@ -75,6 +79,8 @@
 - [FormFaasProps](type-aliases/FormFaasProps.md)
 - [FormProps](type-aliases/FormProps.md)
 - [FormSubmitProps](type-aliases/FormSubmitProps.md)
+- [FormWithFaasProps](type-aliases/FormWithFaasProps.md)
+- [FormWithoutFaasProps](type-aliases/FormWithoutFaasProps.md)
 - [LoadingProps](type-aliases/LoadingProps.md)
 - [ResolvedTheme](type-aliases/ResolvedTheme.md)
 - [setDrawerProps](type-aliases/setDrawerProps.md)

package/dist/index.d.ts

@@ -1,11 +1,10 @@
-import { ErrorBoundaryProps, FaasDataInjection as FaasDataInjection$1, FaasDataWrapperProps as FaasDataWrapperProps$1, FaasDataWrapperRef, FaasReactClient, FaasReactClientOptions, faas, useFaas } from "@faasjs/react";
+import { ErrorBoundaryProps, FaasDataInjection, FaasDataInjection as FaasDataInjection$1, FaasDataWrapperProps as FaasDataWrapperProps$1, FaasDataWrapperRef, FaasReactClient, FaasReactClientOptions, faas, useFaas } from "@faasjs/react";
 import { ButtonProps, ConfigProviderProps as ConfigProviderProps$1, DatePickerProps, DescriptionsProps, Drawer, DrawerProps as DrawerProps$1, FormInstance, FormItemProps as FormItemProps$1, FormProps as FormProps$1, GlobalToken, InputNumberProps, InputProps, Modal, ModalProps as ModalProps$1, RadioProps, SelectProps, SwitchProps, TableColumnProps, TablePaginationConfig, TableProps as TableProps$1, TabsProps as TabsProps$1 } from "antd";
 import { BrowserRouterProps, RouteProps } from "react-router-dom";
 import * as _$react from "react";
 import { CSSProperties, ComponentType, Dispatch, FC, JSX, LazyExoticComponent, ReactElement, ReactNode, SetStateAction, lazy } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { Dayjs } from "dayjs";
-import * as _$antd_es_form_FormItem0 from "antd/es/form/FormItem/index.js";
 import * as _$antd_es_form0 from "antd/es/form/index.js";
 import { RuleObject } from "antd/es/form/index.js";
 import { FilterValue, SorterResult, TableCurrentDataSource } from "antd/es/table/interface.js";
@@ -13,6 +12,7 @@ import * as _$antd_es_form_Form0 from "antd/es/form/Form.js";
 import * as _$antd_es_form_hooks_useFormInstance0 from "antd/es/form/hooks/useFormInstance.js";
 import * as _$_rc_component_form0 from "@rc-component/form";
 import * as _$antd_es_form_context0 from "antd/es/form/context.js";
+import * as _$antd_es_form_FormItem0 from "antd/es/form/FormItem/index.js";
 import { Tab } from "@rc-component/tabs/lib/interface.js";
 import { MessageInstance } from "antd/es/message/interface.js";
 import { NotificationInstance } from "antd/es/notification/interface.js";
@@ -57,18 +57,11 @@ interface FaasActions {}
  */
 type FaasActionPaths = Extract<keyof FaasActions, string>;
 /**
- * Union type accepted by action helpers when callers pass either an action path or inferred data shape.
- */
-type FaasActionUnionType = Record<string, unknown> | string;
-/**
- * Infer the action path type.
- *
- * Returns the original type when `T` is a known action path,
- * otherwise falls back to `string`.
+ * Infer params type by action path.
  *
  * @template T - Candidate action path type.
  */
-type FaasAction<T = unknown> = T extends FaasActionPaths ? T : string;
+type FaasParams<T = unknown> = T extends FaasActionPaths ? FaasActions[T]['Params'] : T extends string ? Record<string, unknown> : never;
 //#endregion
 //#region src/Loading/index.d.ts
 /**
@@ -114,18 +107,12 @@ type LoadingProps = {
 declare function Loading(props: LoadingProps): _$react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/FaasDataWrapper/index.d.ts
-/**
- * Partial data injection exposed to wrapped Ant Design components.
- *
- * @template T - Action path or response data type used for inference.
- */
-type FaasDataInjection<T extends FaasActionUnionType = any> = Partial<FaasDataInjection$1<T>>;
 /**
  * Ant Design wrapper props for the underlying `@faasjs/react` data wrapper.
  *
  * @template T - Action path or response data type used for inference.
  */
-interface FaasDataWrapperProps<T extends FaasActionUnionType = any> extends FaasDataWrapperProps$1<T> {
+interface FaasDataWrapperProps<T extends FaasActionPaths = any> extends FaasDataWrapperProps$1<T> {
   /** Props forwarded to the built-in {@link Loading} fallback. */
   loadingProps?: LoadingProps;
   /** Explicit loading element that overrides the built-in {@link Loading} fallback. */
@@ -213,14 +200,14 @@ interface FaasDataWrapperProps<T extends FaasActionUnionType = any> extends Faas
  * }
  * ```
  */
-declare function FaasDataWrapper<T extends FaasActionUnionType = any>(props: FaasDataWrapperProps<T>): JSX.Element;
+declare function FaasDataWrapper<T extends FaasActionPaths = any>(props: FaasDataWrapperProps<T>): JSX.Element;
 /**
  * Wrap a component with {@link FaasDataWrapper} and its Ant Design loading fallback.
  *
- * @template PathOrData - Action path or response data type used for inference.
+ * @template Path - Action path or response data type used for inference.
  * @template TComponentProps - Component props including injected Faas data fields.
  * @param {React.FC<TComponentProps & Record<string, any>>} Component - Component that consumes injected Faas data props.
- * @param {FaasDataWrapperProps<PathOrData>} faasProps - Request configuration forwarded to {@link FaasDataWrapper}.
+ * @param {FaasDataWrapperProps<Path>} faasProps - Request configuration forwarded to {@link FaasDataWrapper}.
  * @returns Higher-order component that injects Faas data props.
  *
  * @example
@@ -238,7 +225,7 @@ declare function FaasDataWrapper<T extends FaasActionUnionType = any>(props: Faa
  * )
  * ```
  */
-declare function withFaasData<PathOrData extends FaasActionUnionType, TComponentProps extends Required<FaasDataInjection<PathOrData>> = Required<FaasDataInjection<PathOrData>>>(Component: React.FC<TComponentProps & Record<string, any>>, faasProps: FaasDataWrapperProps<PathOrData>): React.FC<Omit<TComponentProps, keyof FaasDataInjection<PathOrData>>>;
+declare function withFaasData<Path extends FaasActionPaths, TComponentProps extends Required<FaasDataInjection$1<Path>> = Required<FaasDataInjection$1<Path>>>(Component: React.FC<TComponentProps & Record<string, any>>, faasProps: FaasDataWrapperProps<Path>): React.FC<Omit<TComponentProps, keyof FaasDataInjection$1<Path>>>;
 //#endregion
 //#region src/Config/index.d.ts
 /**
@@ -547,18 +534,8 @@ interface BlankProps {
  */
 declare function Blank(options?: BlankProps): JSX.Element;
 //#endregion
-//#region src/FormItem/index.d.ts
-/**
- * Custom renderer registration for a form item type.
- *
- * @template T - Value type rendered by the custom form item type.
- */
-type ExtendFormTypeProps<T = any> = {
-  /** Custom element used to render the registered form item type. */children?: UnionFaasItemElement<T>;
-};
-/**
- * Map of custom form item type registrations.
- */
+//#region src/FormItem/types.d.ts
+type ExtendFormTypeProps<T = any> = BaseExtendTypeProps<T>;
 type ExtendTypes = {
   [type: string]: ExtendFormTypeProps;
 };
@@ -573,90 +550,27 @@ type InputTypeMap<T> = {
   object: never;
   'object[]': never;
 };
-/**
- * Item definition used by the `FormItem` and `Form` components.
- *
- * @template T - Value type rendered or edited by the form item.
- */
 interface FormItemProps<T = any> extends BaseItemProps, Omit<FormItemProps$1<T>, 'id' | 'children' | 'render'> {
-  /**
-   * Built-in FaasJS field type used to choose the default Ant Design input.
-   *
-   * @default 'string'
-   */
   type?: FaasItemType;
-  /** Input props forwarded to the generated Ant Design control. */
   input?: InputTypeMap<T>[FaasItemType];
-  /** Maximum item count allowed for list-style field types. */
   maxCount?: number;
-  /** Nested field definitions used by `object` and `object[]` item types. */
   object?: FormItemProps[];
-  /** Whether the generated field is disabled. */
   disabled?: boolean;
-  /** Whether the generated field adds a required validation rule. */
   required?: boolean;
-  /** Grid span used by surrounding object-list layouts. */
   col?: number;
-  /** Generic custom field renderer or element. */
   children?: UnionFaasItemElement<T> | null;
-  /** Form-specific custom field renderer or element. */
   formChildren?: UnionFaasItemElement<T> | null;
-  /** Generic custom render callback. */
   render?: UnionFaasItemRender<T> | null;
-  /** Form-specific custom render callback. */
   formRender?: UnionFaasItemRender<T> | null;
-  /** Validation rules forwarded to Ant Design `Form.Item`. */
   rules?: RuleObject[];
-  /** Label override, or `false` to hide the label completely. */
   label?: string | false;
-  /** Custom form item type renderers keyed by type name. */
   extendTypes?: ExtendTypes;
-  /** Callback invoked when this field's value changes. */
   onValueChange?: (value: T, values: any, form: FormInstance) => void;
-  /** Predicate used to show or hide the item from the current form values. */
   if?: (values: Record<string, any>) => boolean;
 }
-/**
- * Item shape used to extend `Form` with custom type names.
- */
 interface ExtendFormItemProps extends Omit<FormItemProps, 'type'> {
   type?: string;
 }
-/**
- * Render a FaasJS-aware Ant Design form field or nested field group.
- *
- * The component derives default labels from `id`, applies required validation messages from the
- * active theme, supports surface-specific union renderers, and can render nested `object` or
- * `object[]` field structures.
- *
- * @template T - Value type rendered or edited by the form item.
- * @param {FormItemProps<T>} props - Form item props including field metadata, rules, and custom renderers.
- *
- * @example
- * ```tsx
- * import { FormItem } from '@faasjs/ant-design'
- * import { Input } from 'antd'
- *
- * export function AccountFields() {
- *   return (
- *     <>
- *       <FormItem id="name" type="string" />
- *       <FormItem id="password">
- *         <Input.Password />
- *       </FormItem>
- *     </>
- *   )
- * }
- * ```
- */
-declare function FormItem<T = any>(props: FormItemProps<T>): _$react_jsx_runtime0.JSX.Element | null;
-declare namespace FormItem {
-  var useStatus: () => {
-    status?: _$antd_es_form_FormItem0.ValidateStatus;
-    errors: React.ReactNode[];
-    warnings: React.ReactNode[];
-  };
-}
 //#endregion
 //#region src/Table/types.d.ts
 /**
@@ -678,15 +592,7 @@ interface TableItemProps<T = any> extends FaasItemProps, Omit<TableColumnProps<T
   /** Nested item definitions used by `object` and `object[]` item types. */
   object?: TableItemProps<T>[];
 }
-/**
- * Custom renderer registration for a table item type.
- *
- * @template T - Row record type rendered by the custom table item type.
- */
-type ExtendTableTypeProps<T = any> = {
-  /** Custom element used to render the registered table item type. */children?: UnionFaasItemElement<T>; /** Custom render callback used when `children` is not provided. */
-  render?: UnionFaasItemRender<T>;
-};
+type ExtendTableTypeProps<T = any> = BaseExtendTypeProps<T>;
 /**
  * Shared fields for extending table item unions.
  *
@@ -743,58 +649,8 @@ type TableFaasDataResponse<T = any> = {
   };
 };
 //#endregion
-//#region src/Table/table.d.ts
-/**
- * Render an Ant Design table from FaasJS item metadata.
- *
- * The component can render local `dataSource` rows or resolve remote rows through `faasData`. It
- * also generates default filters and sorters for built-in item types unless you disable them with
- * the corresponding Ant Design column props.
- *
- * @template T - Row record type rendered by the table.
- * @template ExtendTypes - Additional item prop shape accepted by `items`.
- * @param {TableProps<T, ExtendTypes>} props - Table props including columns, data source, and optional Faas data config.
- * @throws {Error} When an entry in `extendTypes` omits both `children` and `render`.
- *
- * @example
- * ```tsx
- * import { Table } from '@faasjs/ant-design'
- *
- * const rows = [
- *   { id: 1, name: 'Alice', active: true },
- *   { id: 2, name: 'Bob', active: false },
- * ]
- *
- * export function UserTable() {
- *   return (
- *     <Table
- *       rowKey="id"
- *       dataSource={rows}
- *       items={[
- *         { id: 'name', title: 'Name' },
- *         { id: 'active', type: 'boolean', title: 'Active' },
- *       ]}
- *     />
- *   )
- * }
- * ```
- */
-declare function Table<T extends Record<string, any>, ExtendTypes = any>(props: TableProps<T, ExtendTypes>): _$react_jsx_runtime0.JSX.Element;
-//#endregion
-//#region src/data/render.d.ts
-declare function renderDisplayValue(type: FaasItemType, value: any, options?: {
-  label: string;
-  value?: string | number;
-}[]): JSX.Element | string | number | boolean | null;
-//#endregion
-//#region src/data/index.d.ts
-/**
- * Supported built-in field types shared by form, table, and description components.
- */
+//#region src/data/types.d.ts
 type FaasItemType = 'string' | 'string[]' | 'number' | 'number[]' | 'boolean' | 'date' | 'time' | 'object' | 'object[]';
-/**
- * Runtime value mapping for each built-in {@link FaasItemType}.
- */
 type FaasItemTypeValue = {
   string: string;
   'string[]': string[];
@@ -806,254 +662,82 @@ type FaasItemTypeValue = {
   object: any;
   'object[]': any[];
 };
-/**
- * Option item accepted by built-in choice inputs.
- */
 type BaseOption = string | number | {
-  /** Display label rendered by Ant Design controls. */label: string; /** Raw option value submitted or matched by components. */
+  label: string;
   value?: any;
 };
-/**
- * Common metadata shared by form, table, and description items.
- */
 interface BaseItemProps {
-  /** Stable field identifier used as the default name and title source. */
   id: string | number;
-  /** Human-readable title used for labels and table headers. */
   title?: string;
-  /** Shared choice options used by select-like renderers. */
   options?: BaseOption[];
 }
-/**
- * Base item props plus the shared built-in value type selector.
- */
 interface FaasItemProps extends BaseItemProps {
-  /**
-   * Built-in FaasJS field type used to normalize and render values.
-   *
-   * @default 'string'
-   */
   type?: FaasItemType;
 }
-/**
- * Convert a snake_case, kebab-case, or spaced identifier into a title-style label.
- *
- * @param {string | number} id - Identifier to convert.
- * @returns Generated label string.
- *
- * @example
- * ```ts
- * idToTitle('example_id') // 'Example Id'
- * ```
- */
-declare function idToTitle(id: string | number): string;
-/**
- * Normalize primitive options into explicit `{ label, value }` objects.
- *
- * String and number options are converted with {@link idToTitle}, while pre-shaped option objects
- * are returned as-is.
- *
- * @param {BaseOption[]} options - Raw option list to normalize.
- * @returns Normalized option list.
- *
- * @example
- * ```ts
- * import { transferOptions } from '@faasjs/ant-design'
- *
- * transferOptions(['draft', { label: 'Published', value: 'published' }])
- * // [
- * //   { label: 'Draft', value: 'draft' },
- * //   { label: 'Published', value: 'published' },
- * // ]
- * ```
- */
-declare function transferOptions(options: BaseOption[]): {
-  label: string;
-  value?: string | number;
-}[];
-/**
- * Normalize raw values into the runtime shape expected by FaasJS Ant Design components.
- *
- * Primitive strings such as `'null'` and `'undefined'` become `null`, comma-delimited array
- * strings are split into arrays, and date or time values are converted to `dayjs` objects.
- *
- * @param {FaasItemType | null | undefined} type - Target field type.
- * @param {any} value - Raw value to normalize.
- * @returns Normalized value for rendering or form initialization.
- *
- * @example
- * ```ts
- * import { transferValue } from '@faasjs/ant-design'
- *
- * transferValue('number', '42') // 42
- * transferValue('boolean', 'true') // true
- * transferValue('string[]', 'a,b') // ['a', 'b']
- * ```
- */
-declare function transferValue(type: FaasItemType | null | undefined, value: any): any;
-/**
- * Rendering surfaces supported by union item helpers.
- */
 type UnionScene = 'form' | 'description' | 'table';
-/**
- * Props injected into custom union item components.
- *
- * @template Value - Current item value type.
- * @template Values - Whole record or row type that contains the value.
- */
 type UnionFaasItemInjection<Value = any, Values = any> = {
-  /** Rendering surface requesting the injected element. */scene?: UnionScene; /** Current field, cell, or item value. */
-  value?: Value; /** Full record or row containing the current value. */
-  values?: Values; /** Current row or list index when available. */
+  scene?: UnionScene;
+  value?: Value;
+  values?: Values;
   index?: number;
 };
-/**
- * Render callback signature shared by form, description, and table item definitions.
- *
- * @template Value - Current item value type.
- * @template Values - Whole record or row type that contains the value.
- *
- * @param {Value} value - Current item value.
- * @param {Values} values - Whole record or row containing the value.
- * @param {number} index - Current row or list index.
- * @param {UnionScene} scene - Rendering surface requesting the output.
- */
 type UnionFaasItemRender<Value = any, Values = any> = (value: Value, values: Values, index: number, scene: UnionScene) => React.ReactNode;
-/**
- * Custom React component or element accepted by union item definitions.
- *
- * @template Value - Current item value type.
- * @template Values - Whole record or row type that contains the value.
- */
 type UnionFaasItemElement<Value = any, Values = any> = ReactElement<UnionFaasItemInjection<Value, Values>> | FC<UnionFaasItemInjection<Value, Values>>;
-/**
- * Shared union item contract that can be reused across `Form`, `Description`, and `Table`.
- *
- * ### Render Priority Order
- *
- * 1. Component-specific null renderers hide the item for that surface.
- * 2. Component-specific children override generic `children`.
- * 3. Component-specific render callbacks override generic `render`.
- * 4. Registered extended types handle unmatched items.
- * 5. Built-in type renderers handle primitive and object values.
- *
- * @template Value - Current item value type.
- * @template Values - Whole record or row type that contains the value.
- */
 interface UnionFaasItemProps<Value = any, Values = any> extends FormItemProps, DescriptionItemProps, TableItemProps {
-  /** Shared custom element rendered when no surface-specific child overrides it. */
   children?: UnionFaasItemElement<Value, Values> | null;
-  /** Shared render callback used when no surface-specific render overrides it. */
   render?: UnionFaasItemRender<Value, Values> | null;
-  /** Nested item definitions used by `object` and `object[]` item types. */
   object?: UnionFaasItemProps<Value, Values>[];
 }
-/**
- * Clone a {@link UnionFaasItemElement} with FaasJS injection props.
- *
- * React elements are cloned directly, while component references are first wrapped with
- * `createElement`.
- *
- * @param {UnionFaasItemElement} element - Element or component to clone.
- * @param {any} props - Injection props such as `scene`, `value`, `values`, and `index`.
- * @returns Cloned React element ready for rendering.
- *
- * @example
- * ```tsx
- * import { cloneUnionFaasItemElement, type UnionFaasItemElement } from '@faasjs/ant-design'
- *
- * const Cell: UnionFaasItemElement<string> = ({ value }) => <span>{value}</span>
- *
- * const element = cloneUnionFaasItemElement(Cell, {
- *   scene: 'table',
- *   value: 'Hello',
- *   index: 0,
- * })
- * ```
- */
-declare function cloneUnionFaasItemElement(element: UnionFaasItemElement, props: any): ReactElement<UnionFaasItemInjection<any, any>, string | _$react.JSXElementConstructor<any>>;
-//#endregion
-//#region src/Description/index.d.ts
-/**
- * Custom renderer registration for a description item type.
- *
- * @template T - Value type rendered by the custom description item type.
- */
-interface ExtendDescriptionTypeProps<T = any> {
-  /** Custom element used to render the registered description item type. */
+type BaseExtendTypeProps<T = any> = {
   children?: UnionFaasItemElement<T>;
-  /** Custom render callback used when `children` is not provided. */
   render?: UnionFaasItemRender<T>;
-}
-/**
- * Shared fields for extending description item unions.
- */
+};
+//#endregion
+//#region src/Description/types.d.ts
+type ExtendDescriptionTypeProps<T = any> = BaseExtendTypeProps<T>;
 type ExtendDescriptionItemProps = BaseItemProps;
-/**
- * Item definition used by {@link Description}.
- *
- * @template T - Value type rendered by the item.
- */
 interface DescriptionItemProps<T = any> extends FaasItemProps {
-  /** Generic custom element rendered when no description-specific child overrides it. */
   children?: UnionFaasItemElement<T> | null;
-  /** Description-specific custom element. */
   descriptionChildren?: UnionFaasItemElement<T> | null;
-  /** Generic custom render callback. */
   render?: UnionFaasItemRender<T> | null;
-  /** Description-specific custom render callback. */
   descriptionRender?: UnionFaasItemRender<T> | null;
-  /** Predicate used to hide the item for the current record. */
   if?: (values: Record<string, any>) => boolean;
-  /** Nested item definitions used by `object` and `object[]` item types. */
   object?: DescriptionItemProps<T>[];
 }
-/**
- * Props for the {@link Description} component.
- *
- * @template T - Data record shape rendered by the component.
- * @template ExtendItemProps - Additional item prop shape accepted by `items`.
- */
-interface DescriptionProps<T = any, ExtendItemProps = any> extends Omit<DescriptionsProps, 'items'> {
-  /** Callback used to derive the rendered title from the current record. */
+interface DescriptionCommonProps<T = any, ExtendItemProps = any> extends Omit<DescriptionsProps, 'items'> {
   renderTitle?(this: void, values: T): ReactNode;
-  /** Description item definitions rendered by the component. */
   items: (DescriptionItemProps | ExtendItemProps)[];
-  /** Custom type renderers keyed by item type. */
   extendTypes?: {
     [key: string]: ExtendDescriptionTypeProps;
   };
-  /** Local data record rendered directly by the component. */
+}
+interface DescriptionWithoutFaasProps<T = any, ExtendItemProps = any> extends DescriptionCommonProps<T, ExtendItemProps> {
   dataSource?: T;
-  /** Request config used to fetch the record before rendering. */
-  faasData?: FaasDataWrapperProps<any>;
+  faasData?: never;
 }
-/**
- * Props passed to the exported `DescriptionItemContent` helper shape.
- *
- * @template T - Value type rendered by the item content.
- */
+interface DescriptionWithFaasProps<Path extends FaasActionPaths = any, T = any, ExtendItemProps = any> extends DescriptionCommonProps<T, ExtendItemProps> {
+  dataSource?: never;
+  faasData?: FaasDataWrapperProps<Path>;
+}
+type DescriptionProps<T = any, ExtendItemProps = any> = DescriptionWithoutFaasProps<T, ExtendItemProps> | DescriptionWithFaasProps<any, T, ExtendItemProps>;
 interface DescriptionItemContentProps<T = any> {
-  /** Item definition describing how the value should render. */
   item: DescriptionItemProps;
-  /** Current item value. */
   value: T;
-  /** Full record containing the current value. */
   values?: any;
-  /** Custom type renderers keyed by item type. */
   extendTypes?: {
     [key: string]: ExtendDescriptionTypeProps;
   };
 }
+//#endregion
+//#region src/Description/index.d.ts
 /**
- * Render an Ant Design description list from FaasJS item metadata.
+ * Render an Ant Design description list from a local data source.
  *
- * The component can render a local `dataSource` directly or resolve one through `faasData`, and
- * it applies the same item type normalization helpers used by the form and table components.
+ * The component applies FaasJS item type normalization helpers to render item metadata with
+ * appropriate display formatting.
  *
  * @template T - Data record shape rendered by the component.
- * @param {DescriptionProps<T>} props - Description props including items, data source, and optional Faas data config.
- * @throws {Error} When an entry in `extendTypes` omits both `children` and `render`.
+ * @param {DescriptionWithoutFaasProps<T>} props - Description props including items and a local data source.
  *
  * @example
  * ```tsx
@@ -1064,11 +748,7 @@ interface DescriptionItemContentProps<T = any> {
  *     <Description
  *       title="Title"
  *       items={[
- *         {
- *           id: 'id',
- *           title: 'Title',
- *           type: 'string',
- *         },
+ *         { id: 'id', title: 'Title', type: 'string' },
  *       ]}
  *       dataSource={{ id: 'value' }}
  *     />
@@ -1076,7 +756,45 @@ interface DescriptionItemContentProps<T = any> {
  * }
  * ```
  */
-declare function Description<T extends Record<string, any> = any>(props: DescriptionProps<T>): _$react_jsx_runtime0.JSX.Element;
+declare function Description<T extends Record<string, any> = any>(props: DescriptionWithoutFaasProps<T>): JSX.Element;
+/**
+ * Render an Ant Design description list with fetched FaasJS data.
+ *
+ * The component fetches data via `faasData` and applies FaasJS item type normalization helpers
+ * to render item metadata with appropriate display formatting.
+ *
+ * When `Path` is provided, the `action` and `params` in `faasData` are strongly typed from the
+ * {@link FaasActions} type augmentation.
+ *
+ * @template Path - Action path type inferred from `faasData.action` for strong typing.
+ * @template T - Data record shape rendered by the component.
+ * @param {DescriptionWithFaasProps<Path, T>} props - Description props including items and FaasJS data config.
+ *
+ * @example
+ * ```tsx
+ * import { Description } from '@faasjs/ant-design'
+ *
+ * export function Detail() {
+ *   return (
+ *     <Description
+ *       title="Title"
+ *       items={[
+ *         { id: 'id', title: 'Title', type: 'string' },
+ *       ]}
+ *       faasData={{
+ *         action: 'user/get',
+ *         params: { id: 1 },
+ *       }}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+declare function Description<Path extends FaasActionPaths, T extends Record<string, any> = any>(props: DescriptionWithFaasProps<Path, T>): JSX.Element;
+/**
+ * Render an Ant Design description list (catch-all overload for backward compatibility).
+ */
+declare function Description<T extends Record<string, any> = any>(props: DescriptionProps<T>): JSX.Element;
 declare namespace Description {
   var displayName: string;
 }
@@ -1127,57 +845,99 @@ declare function useDrawer(init?: DrawerProps): {
   setDrawerProps: setDrawerProps;
 };
 //#endregion
-//#region src/Form/index.d.ts
+//#region src/data/render.d.ts
+declare function renderDisplayValue(type: FaasItemType, value: any, options?: {
+  label: string;
+  value?: string | number;
+}[]): JSX.Element | string | number | boolean | null;
+//#endregion
+//#region src/data/utils.d.ts
+declare function idToTitle(id: string | number): string;
+declare function transferOptions(options: BaseOption[]): {
+  label: string;
+  value?: string | number;
+}[];
+declare function transferValue(type: FaasItemType | null | undefined, value: any): any;
+declare function cloneUnionFaasItemElement(element: UnionFaasItemElement, props: any): _$react.ReactElement<UnionFaasItemInjection<any, any>, string | _$react.JSXElementConstructor<any>>;
+//#endregion
+//#region src/FormItem/index.d.ts
 /**
- * Props for the built-in submit button rendered by {@link Form}.
+ * Render a FaasJS-aware Ant Design form field or nested field group.
+ *
+ * The component derives default labels from `id`, applies required validation messages from the
+ * active theme, supports surface-specific union renderers, and can render nested `object` or
+ * `object[]` field structures.
+ *
+ * @template T - Value type rendered or edited by the form item.
+ * @param {FormItemProps<T>} props - Form item props including field metadata, rules, and custom renderers.
+ *
+ * @example
+ * ```tsx
+ * import { FormItem } from '@faasjs/ant-design'
+ * import { Input } from 'antd'
+ *
+ * export function AccountFields() {
+ *   return (
+ *     <>
+ *       <FormItem id="name" type="string" />
+ *       <FormItem id="password">
+ *         <Input.Password />
+ *       </FormItem>
+ *     </>
+ *   )
+ * }
+ * ```
  */
+declare function FormItem<T = any>(props: FormItemProps<T>): _$react_jsx_runtime0.JSX.Element | null;
+declare namespace FormItem {
+  var useStatus: () => {
+    status?: _$antd_es_form_FormItem0.ValidateStatus;
+    errors: React.ReactNode[];
+    warnings: React.ReactNode[];
+  };
+}
+//#endregion
+//#region src/Form/types.d.ts
 type FormSubmitProps = {
-  /** Text rendered by the built-in submit button. */text?: string; /** Additional props forwarded to the built-in submit button. */
+  text?: string;
   buttonProps?: ButtonProps;
 };
-/**
- * Built-in FaasJS submit handler configuration for {@link Form}.
- *
- * @template Values - Form values shape used by submit handlers.
- */
-type FormFaasProps<Values extends Record<string, any> = any> = {
-  /** Action name submitted through `faas()`. */action: FaasAction; /** Extra params merged into the submitted payload after `transformValues` runs. */
-  params?: Record<string, any> | ((values: Record<string, any>) => Record<string, any>); /** Transform form values before sending the request. */
-  transformValues?: (values: Values) => Record<string, any> | Promise<Record<string, any>>; /** Callback invoked when the request succeeds. */
-  onSuccess?: (result: any, values: Record<string, any>) => void; /** Callback invoked when the request fails. */
-  onError?: (error: any, values: Record<string, any>) => void; /** Callback invoked after the request settles. */
+type FormFaasProps<Values extends Record<string, any> = any, Path extends FaasActionPaths = any> = {
+  action: Path;
+  params?: FaasParams<Path> | ((values: Record<string, any>) => FaasParams<Path>);
+  transformValues?: (values: Values) => Record<string, any> | Promise<Record<string, any>>;
+  onSuccess?: (result: any, values: Record<string, any>) => void;
+  onError?: (error: any, values: Record<string, any>) => void;
   onFinally?: () => void;
 };
-/**
- * Props for the FaasJS Ant Design {@link Form} component.
- *
- * @template Values - Form values shape.
- * @template ExtendItemProps - Additional item prop shape accepted by `items`.
- */
-type FormProps<Values extends Record<string, any> = any, ExtendItemProps extends ExtendFormItemProps = ExtendFormItemProps> = Omit<FormProps$1<Values>, 'onFinish' | 'children' | 'initialValues'> & {
-  /** Form item definitions or custom JSX blocks rendered inside the form. */items?: ((ExtendItemProps extends ExtendFormItemProps ? ExtendItemProps | FormItemProps : FormItemProps) | JSX.Element)[]; /** Built-in submit button config, or `false` to disable the generated submit button. */
-  submit?: false | FormSubmitProps; /** Extra content rendered before generated items. */
-  beforeItems?: JSX.Element | JSX.Element[]; /** Extra content rendered after generated items. */
-  footer?: JSX.Element | JSX.Element[]; /** Custom form item type renderers keyed by type name. */
-  extendTypes?: ExtendTypes; /** Additional custom content rendered inside the form. */
-  children?: ReactNode; /** Initial values applied to the underlying Ant Design form. */
+type FormCommonProps<Values extends Record<string, any>, ExtendItemProps extends ExtendFormItemProps = ExtendFormItemProps> = Omit<FormProps$1<Values>, 'onFinish' | 'children' | 'initialValues'> & {
+  items?: ((ExtendItemProps extends ExtendFormItemProps ? ExtendItemProps | FormItemProps : FormItemProps) | JSX.Element)[];
+  submit?: false | FormSubmitProps;
+  beforeItems?: JSX.Element | JSX.Element[];
+  footer?: JSX.Element | JSX.Element[];
+  extendTypes?: ExtendTypes;
+  children?: ReactNode;
   initialValues?: Partial<Values>;
-} & ({
-  /** Built-in FaasJS submit handler, ignored when `onFinish` is provided. */faas?: FormFaasProps<Values>;
-  onFinish?: never;
-} | {
-  faas?: never; /** Custom submit handler used instead of the built-in FaasJS submit flow. */
+};
+type FormWithoutFaasProps<Values extends Record<string, any> = any, ExtendItemProps extends ExtendFormItemProps = ExtendFormItemProps> = FormCommonProps<Values, ExtendItemProps> & {
+  faas?: never;
   onFinish?: (values: Values) => void | Promise<void>;
-});
+};
+type FormWithFaasProps<Path extends FaasActionPaths = any, Values extends Record<string, any> = any, ExtendItemProps extends ExtendFormItemProps = ExtendFormItemProps> = FormCommonProps<Values, ExtendItemProps> & {
+  faas?: FormFaasProps<Values, Path>;
+  onFinish?: never;
+};
+type FormProps<Values extends Record<string, any> = any, Path extends FaasActionPaths = any, ExtendItemProps extends ExtendFormItemProps = ExtendFormItemProps> = FormWithoutFaasProps<Values, ExtendItemProps> | FormWithFaasProps<Path, Values, ExtendItemProps>;
+//#endregion
+//#region src/Form/index.d.ts
 /**
- * Render a data-aware Ant Design form with optional FaasJS submission helpers.
+ * Render a data-aware Ant Design form without the built-in FaasJS submit handler.
  *
  * The component normalizes `initialValues` with {@link transferValue}, renders item definitions
- * through {@link FormItem}, and can either delegate submission to a custom `onFinish` handler or
- * the built-in FaasJS request flow configured by `faas`.
+ * through {@link FormItem}, and delegates submission to the custom `onFinish` handler.
  *
  * @template Values - Form values shape.
- * @param {FormProps<Values>} props - Form props including items, submit behavior, and FaasJS integration.
+ * @param {FormWithoutFaasProps<Values>} props - Form props including items, submit behavior, and a custom `onFinish` handler.
  *
  * @example
  * ```tsx
@@ -1197,6 +957,20 @@ type FormProps<Values extends Record<string, any> = any, ExtendItemProps extends
  *   )
  * }
  * ```
+ */
+declare function Form<Values extends Record<string, any> = any>(props: FormWithoutFaasProps<Values>): JSX.Element;
+/**
+ * Render a data-aware Ant Design form with the built-in FaasJS submit handler.
+ *
+ * The component normalizes `initialValues` with {@link transferValue}, renders item definitions
+ * through {@link FormItem}, and submits via the built-in FaasJS request flow configured by `faas`.
+ *
+ * When `Path` is provided, the `action` and `params` in `faas` are strongly typed from the
+ * {@link FaasActions} type augmentation.
+ *
+ * @template Path - Action path type inferred from `faas.action` for strong typing.
+ * @template Values - Form values shape.
+ * @param {FormWithFaasProps<Path, Values>} props - Form props including items, submit behavior, and FaasJS integration.
  *
  * @example
  * ```tsx
@@ -1221,7 +995,11 @@ type FormProps<Values extends Record<string, any> = any, ExtendItemProps extends
  * }
  * ```
  */
-declare function Form<Values extends Record<string, any> = any>(props: FormProps<Values>): _$react_jsx_runtime0.JSX.Element | null;
+declare function Form<Path extends FaasActionPaths, Values extends Record<string, any> = any>(props: FormWithFaasProps<Path, Values>): JSX.Element;
+/**
+ * Render a data-aware Ant Design form (catch-all overload for backward compatibility).
+ */
+declare function Form<Values extends Record<string, any> = any, Path extends FaasActionPaths = any>(props: FormProps<Values, Path>): JSX.Element;
 declare namespace Form {
   var useForm: typeof _$antd_es_form_Form0.useForm;
   var useFormInstance: typeof _$antd_es_form_hooks_useFormInstance0.default;
@@ -1391,6 +1169,44 @@ interface RoutesProps {
  */
 declare function Routes(props: RoutesProps): _$react_jsx_runtime0.JSX.Element;
 //#endregion
+//#region src/Table/table.d.ts
+/**
+ * Render an Ant Design table from FaasJS item metadata.
+ *
+ * The component can render local `dataSource` rows or resolve remote rows through `faasData`. It
+ * also generates default filters and sorters for built-in item types unless you disable them with
+ * the corresponding Ant Design column props.
+ *
+ * @template T - Row record type rendered by the table.
+ * @template ExtendTypes - Additional item prop shape accepted by `items`.
+ * @param {TableProps<T, ExtendTypes>} props - Table props including columns, data source, and optional Faas data config.
+ * @throws {Error} When an entry in `extendTypes` omits both `children` and `render`.
+ *
+ * @example
+ * ```tsx
+ * import { Table } from '@faasjs/ant-design'
+ *
+ * const rows = [
+ *   { id: 1, name: 'Alice', active: true },
+ *   { id: 2, name: 'Bob', active: false },
+ * ]
+ *
+ * export function UserTable() {
+ *   return (
+ *     <Table
+ *       rowKey="id"
+ *       dataSource={rows}
+ *       items={[
+ *         { id: 'name', title: 'Name' },
+ *         { id: 'active', type: 'boolean', title: 'Active' },
+ *       ]}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+declare function Table<T extends Record<string, any>, ExtendTypes = any>(props: TableProps<T, ExtendTypes>): _$react_jsx_runtime0.JSX.Element;
+//#endregion
 //#region src/Tabs/index.d.ts
 /**
  * Tab item accepted by the FaasJS Ant Design {@link Tabs} wrapper.
@@ -1573,4 +1389,4 @@ declare function useApp<NewT extends useAppProps = useAppProps>(this: void): Rea
  */
 declare function useThemeToken(): GlobalToken;
 //#endregion
-export { App, AppContext, AppProps, BaseItemProps, BaseOption, Blank, BlankProps, ConfigContext, ConfigProvider, ConfigProviderProps, Description, DescriptionItemContentProps, DescriptionItemProps, DescriptionProps, Drawer, DrawerProps, ErrorBoundary, type ErrorBoundaryProps, ExtendDescriptionItemProps, ExtendDescriptionTypeProps, type ExtendFormItemProps, type ExtendFormTypeProps, type ExtendTableItemProps, type ExtendTableTypeProps, ExtendTypes, FaasDataInjection, FaasDataWrapper, FaasDataWrapperProps, type FaasDataWrapperRef, FaasItemProps, FaasItemType, FaasItemTypeValue, FaasReactClient, type FaasReactClientOptions, Form, FormFaasProps, FormItem, FormItemProps, FormProps, FormSubmitProps, Link, LinkProps, Loading, LoadingProps, Modal, ModalProps, PageNotFound, ResolvedTheme, Routes, RoutesProps, TabProps, Table, type TableFaasDataParams, type TableFaasDataResponse, type TableItemProps, type TableProps, Tabs, TabsProps, Title, TitleProps, UnionFaasItemElement, UnionFaasItemInjection, UnionFaasItemProps, UnionFaasItemRender, UnionScene, cloneUnionFaasItemElement, createOnErrorHandler, faas, idToTitle, lazy, renderDisplayValue, setDrawerProps, setModalProps, transferOptions, transferValue, useApp, useAppProps, useConfigContext, useDrawer, useFaas, useModal, useThemeToken, withFaasData };
+export { App, AppContext, AppProps, BaseExtendTypeProps, BaseItemProps, BaseOption, Blank, BlankProps, ConfigContext, ConfigProvider, ConfigProviderProps, Description, type DescriptionCommonProps, type DescriptionItemContentProps, type DescriptionItemProps, type DescriptionProps, type DescriptionWithFaasProps, type DescriptionWithoutFaasProps, Drawer, DrawerProps, ErrorBoundary, type ErrorBoundaryProps, type ExtendDescriptionItemProps, type ExtendDescriptionTypeProps, type ExtendFormItemProps, type ExtendFormTypeProps, type ExtendTableItemProps, type ExtendTableTypeProps, type ExtendTypes, type FaasDataInjection, FaasDataWrapper, FaasDataWrapperProps, type FaasDataWrapperRef, FaasItemProps, FaasItemType, FaasItemTypeValue, FaasReactClient, type FaasReactClientOptions, Form, type FormFaasProps, FormItem, type FormItemProps, type FormProps, type FormSubmitProps, type FormWithFaasProps, type FormWithoutFaasProps, Link, LinkProps, Loading, LoadingProps, Modal, ModalProps, PageNotFound, ResolvedTheme, Routes, RoutesProps, TabProps, Table, type TableFaasDataParams, type TableFaasDataResponse, type TableItemProps, type TableProps, Tabs, TabsProps, Title, TitleProps, UnionFaasItemElement, UnionFaasItemInjection, UnionFaasItemProps, UnionFaasItemRender, UnionScene, cloneUnionFaasItemElement, createOnErrorHandler, faas, idToTitle, lazy, renderDisplayValue, setDrawerProps, setModalProps, transferOptions, transferValue, useApp, useAppProps, useConfigContext, useDrawer, useFaas, useModal, useThemeToken, withFaasData };

package/dist/index.mjs

@@ -4,8 +4,8 @@ import { BrowserRouter, Route, Routes as Routes$1, useLocation, useNavigate } fr
 import { cloneDeep, defaultsDeep, isNil, uniqBy } from "lodash-es";
 import { Suspense, cloneElement, createContext, createElement, isValidElement, lazy, useContext, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import dayjs from "dayjs";
 import { CheckOutlined, CloseOutlined, MinusCircleOutlined, PlusOutlined } from "@ant-design/icons";
+import dayjs from "dayjs";
 //#region src/Loading/index.tsx
 /**
 * Render an Ant Design loading spinner with an optional content fallback.
@@ -134,10 +134,10 @@ function FaasDataWrapper(props) {
 /**
 * Wrap a component with {@link FaasDataWrapper} and its Ant Design loading fallback.
 *
-* @template PathOrData - Action path or response data type used for inference.
+* @template Path - Action path or response data type used for inference.
 * @template TComponentProps - Component props including injected Faas data fields.
 * @param {React.FC<TComponentProps & Record<string, any>>} Component - Component that consumes injected Faas data props.
-* @param {FaasDataWrapperProps<PathOrData>} faasProps - Request configuration forwarded to {@link FaasDataWrapper}.
+* @param {FaasDataWrapperProps<Path>} faasProps - Request configuration forwarded to {@link FaasDataWrapper}.
 * @returns Higher-order component that injects Faas data props.
 *
 * @example
@@ -674,43 +674,12 @@ function renderDisplayValue(type, value, options) {
 	}
 }
 //#endregion
-//#region src/data/index.ts
-/**
-* Convert a snake_case, kebab-case, or spaced identifier into a title-style label.
-*
-* @param {string | number} id - Identifier to convert.
-* @returns Generated label string.
-*
-* @example
-* ```ts
-* idToTitle('example_id') // 'Example Id'
-* ```
-*/
+//#region src/data/utils.ts
 function idToTitle(id) {
 	if (typeof id === "number") return id.toString();
 	const splitted = id.split(/(\s|_|-)/).filter((word) => !/(\s|_|-)/.test(word)).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 	return splitted.charAt(0).toUpperCase() + splitted.slice(1);
 }
-/**
-* Normalize primitive options into explicit `{ label, value }` objects.
-*
-* String and number options are converted with {@link idToTitle}, while pre-shaped option objects
-* are returned as-is.
-*
-* @param {BaseOption[]} options - Raw option list to normalize.
-* @returns Normalized option list.
-*
-* @example
-* ```ts
-* import { transferOptions } from '@faasjs/ant-design'
-*
-* transferOptions(['draft', { label: 'Published', value: 'published' }])
-* // [
-* //   { label: 'Draft', value: 'draft' },
-* //   { label: 'Published', value: 'published' },
-* // ]
-* ```
-*/
 function transferOptions(options) {
 	if (!options) return [];
 	return options.map((item) => typeof item === "object" ? item : {
@@ -718,25 +687,6 @@ function transferOptions(options) {
 		value: item
 	});
 }
-/**
-* Normalize raw values into the runtime shape expected by FaasJS Ant Design components.
-*
-* Primitive strings such as `'null'` and `'undefined'` become `null`, comma-delimited array
-* strings are split into arrays, and date or time values are converted to `dayjs` objects.
-*
-* @param {FaasItemType | null | undefined} type - Target field type.
-* @param {any} value - Raw value to normalize.
-* @returns Normalized value for rendering or form initialization.
-*
-* @example
-* ```ts
-* import { transferValue } from '@faasjs/ant-design'
-*
-* transferValue('number', '42') // 42
-* transferValue('boolean', 'true') // true
-* transferValue('string[]', 'a,b') // ['a', 'b']
-* ```
-*/
 function transferValue(type, value) {
 	if (!type) type = "string";
 	if (!type.endsWith("[]") && (typeof value === "undefined" || value === null || value === "" || value === "null" || value === "undefined")) return null;
@@ -761,29 +711,6 @@ function transferValue(type, value) {
 	}
 	return value;
 }
-/**
-* Clone a {@link UnionFaasItemElement} with FaasJS injection props.
-*
-* React elements are cloned directly, while component references are first wrapped with
-* `createElement`.
-*
-* @param {UnionFaasItemElement} element - Element or component to clone.
-* @param {any} props - Injection props such as `scene`, `value`, `values`, and `index`.
-* @returns Cloned React element ready for rendering.
-*
-* @example
-* ```tsx
-* import { cloneUnionFaasItemElement, type UnionFaasItemElement } from '@faasjs/ant-design'
-*
-* const Cell: UnionFaasItemElement<string> = ({ value }) => <span>{value}</span>
-*
-* const element = cloneUnionFaasItemElement(Cell, {
-*   scene: 'table',
-*   value: 'Hello',
-*   index: 0,
-* })
-* ```
-*/
 function cloneUnionFaasItemElement(element, props) {
 	return cloneElement(isValidElement(element) ? element : createElement(element), props);
 }
@@ -836,37 +763,6 @@ function DescriptionItemContent(props) {
 	return /* @__PURE__ */ jsx(Fragment, { children: renderDisplayValue(type, value, options) });
 }
 DescriptionItemContent.displayName = "DescriptionItemContent";
-/**
-* Render an Ant Design description list from FaasJS item metadata.
-*
-* The component can render a local `dataSource` directly or resolve one through `faasData`, and
-* it applies the same item type normalization helpers used by the form and table components.
-*
-* @template T - Data record shape rendered by the component.
-* @param {DescriptionProps<T>} props - Description props including items, data source, and optional Faas data config.
-* @throws {Error} When an entry in `extendTypes` omits both `children` and `render`.
-*
-* @example
-* ```tsx
-* import { Description } from '@faasjs/ant-design'
-*
-* export function Detail() {
-*   return (
-*     <Description
-*       title="Title"
-*       items={[
-*         {
-*           id: 'id',
-*           title: 'Title',
-*           type: 'string',
-*         },
-*       ]}
-*       dataSource={{ id: 'value' }}
-*     />
-*   )
-* }
-* ```
-*/
 function Description(props) {
 	const { faasData, dataSource, renderTitle, extendTypes, ...descriptionProps } = props;
 	if (faasData && !dataSource) {
@@ -1213,58 +1109,6 @@ FormItem.useStatus = Form$1.Item.useStatus;
 function isFormItemProps(item) {
 	return item.id !== void 0;
 }
-/**
-* Render a data-aware Ant Design form with optional FaasJS submission helpers.
-*
-* The component normalizes `initialValues` with {@link transferValue}, renders item definitions
-* through {@link FormItem}, and can either delegate submission to a custom `onFinish` handler or
-* the built-in FaasJS request flow configured by `faas`.
-*
-* @template Values - Form values shape.
-* @param {FormProps<Values>} props - Form props including items, submit behavior, and FaasJS integration.
-*
-* @example
-* ```tsx
-* import { Form } from '@faasjs/ant-design'
-*
-* export function ProfileForm() {
-*   return (
-*     <Form
-*       items={[
-*         { id: 'name', required: true },
-*         { id: 'email', required: true },
-*       ]}
-*       onFinish={async (values) => {
-*         console.log(values)
-*       }}
-*     />
-*   )
-* }
-* ```
-*
-* @example
-* ```tsx
-* import { Form } from '@faasjs/ant-design'
-*
-* export function CreateUserForm() {
-*   return (
-*     <Form
-*       initialValues={{ role: 'user' }}
-*       items={[
-*         { id: 'name', required: true },
-*         { id: 'role', options: ['user', 'admin'] },
-*       ]}
-*       faas={{
-*         action: 'user/create',
-*         params: (values) => ({
-*           role: values.role || 'user',
-*         }),
-*       }}
-*     />
-*   )
-* }
-* ```
-*/
 function Form(props) {
 	const [loading, setLoading] = useState(false);
 	const [antdProps, setAntdProps] = useState();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faasjs/ant-design",
-  "version": "8.0.0-beta.29",
+  "version": "8.0.0-beta.30",
   "homepage": "https://faasjs.com/doc/ant-design",
   "bugs": {
     "url": "https://github.com/faasjs/faasjs/issues"
@@ -27,7 +27,7 @@
   },
   "devDependencies": {
     "@ant-design/icons": "*",
-    "@faasjs/react": ">=8.0.0-beta.29",
+    "@faasjs/react": ">=8.0.0-beta.30",
     "@types/lodash-es": "*",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
@@ -39,7 +39,7 @@
   },
   "peerDependencies": {
     "@ant-design/icons": "*",
-    "@faasjs/react": ">=8.0.0-beta.29",
+    "@faasjs/react": ">=8.0.0-beta.30",
     "antd": "^6.0.0",
     "lodash-es": "*",
     "react": "^19.0.0",