@vef-framework-react/components 2.1.11 → 2.1.12

package/dist/es/pro-table/hooks/use-row-selection.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { useMemo as e } from "react";
 //#region src/pro-table/hooks/use-row-selection.ts
 function t(t, n, r) {

package/dist/es/pro-table/hooks/use-table-columns.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { globalCssVars as e } from "../../_base/constants/css-vars.js";
 import { Group as t } from "../../group/index.js";
 import { getColumnId as n, useProTableStore as r } from "../store.js";

package/dist/es/pro-table/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Stack as e } from "../stack/index.js";
 import { ProTableStoreProvider as t } from "./store.js";
 import { ColumnSettingsStorageKeyProvider as n } from "./context.js";

package/dist/es/pro-table/store.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { pageSizeOptions as e } from "../table/use-pagination-props.js";
 import { createEventEmitter as t } from "./event.js";
 import { isFunction as n, isNumber as r } from "@vef-framework-react/shared";

package/dist/es/progress/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Progress as e } from "antd";
 export { e as Progress };

package/dist/es/qrcode/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { QRCode as e } from "antd";
 export { e as QRCode };

package/dist/es/radio/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Radio as e } from "antd";
 export { e as Radio };

package/dist/es/rate/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Rate as e } from "antd";
 export { e as Rate };

package/dist/es/result/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Result as e } from "antd";
 export { e as Result };

package/dist/es/row/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Row as e } from "antd";
 export { e as Row };

package/dist/es/scroll-area/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { getSpacingValue as e } from "../_base/helpers/common.js";
 import { root as t, scrollbar as n, thumb as r, viewport as i } from "./styles.js";
 import { jsx as a, jsxs as o } from "@emotion/react/jsx-runtime";

package/dist/es/scroll-area/styles.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import "@emotion/react";
 //#region src/scroll-area/styles.ts
 function e() {

package/dist/es/segmented/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Segmented as e } from "antd";
 export { e as Segmented };

package/dist/es/select/hooks/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import "./use-data-options-select.js";
 import "./use-dictionary-options-select.js";

package/dist/es/select/hooks/use-data-options-select.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Loader as e } from "../../loader/index.js";
 import { jsx as t } from "@emotion/react/jsx-runtime";
 import { useDataOptionsQuery as n } from "@vef-framework-react/hooks";

package/dist/es/select/hooks/use-dictionary-options-select.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Loader as e } from "../../loader/index.js";
 import { jsx as t } from "@emotion/react/jsx-runtime";
 import { isArray as n, withPinyin as r } from "@vef-framework-react/shared";

package/dist/es/select/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import "./hooks/use-data-options-select.js";
 import "./hooks/use-dictionary-options-select.js";
 import { Select as e } from "antd";

package/dist/es/skeleton/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Skeleton as e } from "antd";
 export { e as Skeleton };

package/dist/es/slider/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Slider as e } from "antd";
 export { e as Slider };

package/dist/es/space/index.js

@@ -1,2 +1,2 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import "./space.js";

package/dist/es/space/space.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { jsx as e } from "@emotion/react/jsx-runtime";
 import { Space as t } from "antd";
 //#region src/space/space.tsx

package/dist/es/sparkles-text/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Sparkle as e } from "./sparkle.js";
 import { jsx as t, jsxs as n } from "@emotion/react/jsx-runtime";
 import { useEffect as r, useState as i } from "react";

package/dist/es/sparkles-text/sparkle.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { jsx as e } from "@emotion/react/jsx-runtime";
 import "@emotion/react";
 import { motion as t } from "@vef-framework-react/core";

package/dist/es/spin/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Spin as e } from "antd";
 export { e as Spin };

package/dist/es/split-text/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { createElement as e, useEffect as t, useRef as n, useState as r } from "react";
 import { clsx as i } from "@vef-framework-react/core";
 import { useGSAP as a } from "@gsap/react";

package/dist/es/splitter/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Splitter as e } from "antd";
 export { e as Splitter };

package/dist/es/stack/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Flex as e } from "../flex/index.js";
 import { jsx as t } from "@emotion/react/jsx-runtime";
 //#region src/stack/index.tsx

package/dist/es/statistic/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Statistic as e } from "antd";
 export { e as Statistic };

package/dist/es/steps/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Steps as e } from "antd";
 export { e as Steps };

package/dist/es/switch/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Switch as e } from "antd";
 export { e as Switch };

package/dist/es/table/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { fullHeight as e } from "../_base/styles/common.js";
 import "./use-pagination-props.js";
 import { jsx as t } from "@emotion/react/jsx-runtime";

package/dist/es/table/use-pagination-props.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Fragment as e, jsx as t, jsxs as n } from "@emotion/react/jsx-runtime";
 import { useMemo as r } from "react";
 //#region src/table/use-pagination-props.tsx

package/dist/es/tabs/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Tabs as e } from "antd";
 export { e as Tabs };

package/dist/es/tag/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Tag as e } from "antd";
 export { e as Tag };

package/dist/es/time-picker/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { TimePicker as e } from "antd";
 export { e as TimePicker };

package/dist/es/timeline/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Timeline as e } from "antd";
 export { e as Timeline };

package/dist/es/tooltip/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Tooltip as e } from "antd";
 export { e as Tooltip };

package/dist/es/tour/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Tour as e } from "antd";
 export { e as Tour };

package/dist/es/transfer/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Transfer as e } from "antd";
 export { e as Transfer };

package/dist/es/tree/hooks/index.js

@@ -1,2 +1,2 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import "./use-data-options-tree.js";

package/dist/es/tree/hooks/use-data-options-tree.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { filterTreeWithAncestors as e, isString as t } from "@vef-framework-react/shared";
 import { useDataOptionsQuery as n } from "@vef-framework-react/hooks";
 import { useEffect as r, useEffectEvent as i, useMemo as a, useState as o } from "react";

package/dist/es/tree/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import "./hooks/use-data-options-tree.js";
 import { Tree as e } from "antd";
 export { e as Tree };

package/dist/es/tree-select/hooks/index.js

@@ -1,2 +1,2 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import "./use-data-options-tree-select.js";

package/dist/es/tree-select/hooks/use-data-options-tree-select.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Loader as e } from "../../loader/index.js";
 import { jsx as t } from "@emotion/react/jsx-runtime";
 import { isString as n } from "@vef-framework-react/shared";

package/dist/es/tree-select/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import "./hooks/use-data-options-tree-select.js";
 import { TreeSelect as e } from "antd";
 export { e as TreeSelect };

package/dist/es/typing-animation/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { jsx as e } from "@emotion/react/jsx-runtime";
 import { Children as t, useEffect as n, useRef as r, useState as i } from "react";
 import { motion as a, useInView as o } from "@vef-framework-react/core";

package/dist/es/typography/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Typography as e } from "antd";
 //#region src/typography/index.ts
 var { Text: t, Link: n, Title: r, Paragraph: i } = e;

package/dist/es/upload/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { mergeProps as e } from "../_base/helpers/props.js";
 import { Button as t } from "../button/index.js";
 import { Icon as n } from "../icon/index.js";

package/dist/es/watermark/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/components v2.1.11 made by Venus | 2026-04-29T08:23:50.709Z */
+/*! @vef-framework-react/components v2.1.12 made by Venus | 2026-05-07T08:00:46.762Z */
 import { Watermark as e } from "antd";
 export { e as Watermark };

package/dist/types/crud/components/scene-form.d.ts

@@ -1,7 +1,7 @@
 import { AnyObject } from '@vef-framework-react/shared';
 import { ReactNode } from 'react';
 import { BaseCrudProps } from '../props';
-interface SceneFormProps<TSceneFormValues extends AnyObject> extends Pick<BaseCrudProps<AnyObject, AnyObject, TSceneFormValues, AnyObject>, "renderForm" | "formMutationFns" | "formActionsRenderers" | "beforeFormSubmit" | "afterFormSubmit" | "mutationMeta"> {
+interface SceneFormProps<TSceneFormValues extends AnyObject> extends Pick<BaseCrudProps<AnyObject, AnyObject, TSceneFormValues, AnyObject>, "renderForm" | "formComponent" | "formMutationFns" | "formActionsRenderers" | "beforeFormSubmit" | "afterFormSubmit" | "mutationMeta"> {
 }
 export declare const SceneForm: <TSceneFormValues extends AnyObject>(props: SceneFormProps<TSceneFormValues>) => ReactNode;
 export {};

package/dist/types/crud/index.d.ts

@@ -1,6 +1,6 @@
 import { AnyObject } from '@vef-framework-react/shared';
 import { CrudProps } from './props';
-export declare function Crud<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject = never>({ storageKey, defaultSearchValues, advancedSearch, sceneDefaultFormValues, renderForm, formMutationFns, formActionsRenderers, beforeFormSubmit, afterFormSubmit, deleteMutationFn, deleteManyMutationFn, mutationMeta, rowSelection, rowKey, ...bodyProps }: CrudProps<TRow, TSearchValues, TSceneFormValues, TParams>): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function Crud<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject = never>({ storageKey, defaultSearchValues, advancedSearch, sceneDefaultFormValues, renderForm, formComponent, formMutationFns, formActionsRenderers, beforeFormSubmit, afterFormSubmit, deleteMutationFn, deleteManyMutationFn, mutationMeta, rowSelection, rowKey, ...bodyProps }: CrudProps<TRow, TSearchValues, TSceneFormValues, TParams>): import("@emotion/react/jsx-runtime").JSX.Element;
 export type { ActionButtonGroupProps as CrudActionButtonGroupProps, OperationButtonGroupProps as CrudOperationButtonGroupProps } from './components';
 export { createCrudKit } from './helpers';
 export type { CrudKit } from './helpers';

package/dist/types/crud/props.d.ts

@@ -1,6 +1,6 @@
 import { ApiResult, MutationFunction, MutationMeta, PaginationResult, QueryFunction } from '@vef-framework-react/core';
 import { AnyObject, Awaitable, DeepKeys, EmptyObject, If, IsNever, Key, MaybeUndefined, PartialDeep } from '@vef-framework-react/shared';
-import { ReactNode } from 'react';
+import { ElementType, ReactNode } from 'react';
 import { ColumnSettingsProp, OperationColumnConfig, ProTableProps, RowSelectionConfig } from '../pro-table';
 import { TableColumn } from '../table';
 import { CrudFormActionsRenderers, CrudFormMutationFns, CrudFormScene, PaginatedQueryParams, QueryParams } from './types';
@@ -84,6 +84,12 @@ export interface BaseCrudProps<TRow extends AnyObject, TSearchValues extends Any
      * Default form values map for scenes
      */
     sceneDefaultFormValues?: PartialDeep<NoInfer<TSceneFormValues>>;
+    /**
+     * The element type for the inner form wrapper of the scene form drawer/modal.
+     *
+     * @default "div"
+     */
+    formComponent?: ElementType;
     /**
      * Render function to provide a form for the specified scene
      */

package/dist/types/form/helpers/create-field.d.ts

@@ -1,61 +1,75 @@
-import { DeepKeys, DeepValue, FieldAsyncValidateOrFn, FieldValidateOrFn, FieldValidators } from '@tanstack/react-form';
+import { DeepKeys, DeepValue, FieldAsyncValidateOrFn, FieldValidateOrFn, UseFieldOptionsBound } from '@tanstack/react-form';
 import { AnyObject, MaybeUndefined } from '@vef-framework-react/shared';
 import { ReactNode } from 'react';
 import { fieldComponents } from '../fields';
 type MaybeFieldSync<T, N extends DeepKeys<T>> = MaybeUndefined<FieldValidateOrFn<T, N, DeepValue<T, N>>>;
 type MaybeFieldAsync<T, N extends DeepKeys<T>> = MaybeUndefined<FieldAsyncValidateOrFn<T, N, DeepValue<T, N>>>;
 /**
- * Simplified `FieldValidators` with all `TOn*` slots widened to their upper bounds.
- * Accepts zod schemas, validator functions, or `undefined` for each lifecycle event.
+ * Bound `<form.AppField>` props for a known field name, with all `TOn*`
+ * validator slots widened to their upper bounds. The `name` field is omitted
+ * because `createField` takes it as the first argument.
  */
-type FieldValidatorsFor<T, N extends DeepKeys<T>> = FieldValidators<T, N, DeepValue<T, N>, MaybeFieldSync<T, N>, MaybeFieldSync<T, N>, MaybeFieldAsync<T, N>, MaybeFieldSync<T, N>, MaybeFieldAsync<T, N>, MaybeFieldSync<T, N>, MaybeFieldAsync<T, N>, MaybeFieldSync<T, N>, MaybeFieldAsync<T, N>>;
-declare const ErasedValidatorBrand: unique symbol;
+type AppFieldOptionsFor<T, N extends DeepKeys<T>> = Omit<UseFieldOptionsBound<T, N, DeepValue<T, N>, MaybeFieldSync<T, N>, MaybeFieldSync<T, N>, MaybeFieldAsync<T, N>, MaybeFieldSync<T, N>, MaybeFieldAsync<T, N>, MaybeFieldSync<T, N>, MaybeFieldAsync<T, N>, MaybeFieldSync<T, N>, MaybeFieldAsync<T, N>>, "name">;
+declare const ErasedFieldOptionsBrand: unique symbol;
 /**
- * Opaque wrapper for type-erased field validators. Retains `TFormData`
- * association but hides the specific field name. Cannot be constructed
- * directly — use `createField` to produce values of this type.
+ * Opaque wrapper for type-erased `<form.AppField>` options. Retains the
+ * `TFormData` association while hiding the specific field name. Cannot be
+ * constructed directly — use `createField` to produce values of this type.
  */
-export interface ErasedValidators<TFormData> {
-    readonly [ErasedValidatorBrand]: TFormData;
+export interface ErasedFieldOptions<TFormData> {
+    readonly [ErasedFieldOptionsBrand]: TFormData;
 }
 /**
- * Restore erased validators to their specific field type at the render site.
+ * Restore erased field options to their specific field type at the render
+ * site. Always returns an object (never undefined), so the result can be
+ * spread onto `<form.AppField>` without an extra null check.
  *
  * @example
  * ```tsx
  * items.map(item => (
  *   <form.AppField
+ *     key={item.name}
  *     name={item.name}
- *     validators={restoreValidators(item.validators)}
+ *     {...restoreFieldOptions(item.fieldOptions)}
  *   >
  *     {item.render}
  *   </form.AppField>
  * ));
  * ```
  */
-export declare function restoreValidators<T, N extends DeepKeys<T>>(validators: MaybeUndefined<ErasedValidators<T>>): MaybeUndefined<FieldValidatorsFor<T, N>>;
-interface FormFieldOptions<T, N extends DeepKeys<T>, TMeta extends AnyObject = AnyObject> {
-    validators?: FieldValidatorsFor<T, N>;
+export declare function restoreFieldOptions<T, N extends DeepKeys<T>>(options: MaybeUndefined<ErasedFieldOptions<T>>): AppFieldOptionsFor<T, N>;
+/**
+ * Field definition input accepted by `createField`. Extends every bound
+ * `<form.AppField>` prop (validators, listeners, defaultValue, asyncDebounceMs,
+ * mode, defaultMeta, …) and adds two project-specific slots:
+ *
+ * - `render`: the render-prop body, scoped to the injected field components.
+ * - `renderMeta`: arbitrary metadata consumed by the surrounding map (e.g.
+ * layout span, visibility). Named `renderMeta` to avoid confusion with
+ * TanStack's `defaultMeta`, which seeds `FieldMeta` state.
+ */
+type FormFieldOptions<T, N extends DeepKeys<T>, TMeta extends AnyObject = AnyObject> = AppFieldOptionsFor<T, N> & {
     render: (field: typeof fieldComponents) => ReactNode;
-    meta?: TMeta;
-}
+    renderMeta?: TMeta;
+};
 /**
- * Type-erased form field item for homogeneous array storage.
- * Type checking is performed at the `createField` call site; the erased
- * representation is safe to iterate, filter, and reorder without losing safety.
+ * Type-erased form field item for homogeneous array storage. Type checking
+ * happens at the `createField` call site; the erased representation is safe
+ * to iterate, filter, and reorder without losing safety.
  *
- * Validators use an opaque branded type (`ErasedValidators`) instead of `any`.
- * Use `restoreValidators(item.validators)` at the render site to pass them
- * to `<AppField>`.
+ * Field-name-dependent options live inside `fieldOptions` as an opaque
+ * branded value (`ErasedFieldOptions`). Use `restoreFieldOptions(item.fieldOptions)`
+ * at the render site to spread them onto `<form.AppField>`.
  *
  * `TMeta` allows attaching arbitrary typed metadata (e.g. layout, visibility)
- * to each field item. Defaults to `AnyObject` for zero-overhead when unused.
+ * to each field item via `renderMeta`. Defaults to `AnyObject` for zero
+ * overhead when unused.
  */
 export interface FormFieldItem<TFormData, TMeta extends AnyObject = AnyObject> {
     name: DeepKeys<TFormData>;
-    validators?: ErasedValidators<TFormData>;
+    fieldOptions?: ErasedFieldOptions<TFormData>;
     render: (field: typeof fieldComponents) => ReactNode;
-    meta?: TMeta;
+    renderMeta?: TMeta;
 }
 /**
  * Type-safe field definition factory scoped to a specific form data type.
@@ -68,15 +82,23 @@ export interface FormFieldItem<TFormData, TMeta extends AnyObject = AnyObject> {
  *
  * const items: FormFieldItem<StaffParams, FieldMeta>[] = [
  *   createField("name", {
- *     meta: { span: 12 },
  *     validators: { onBlur: z.string("required").max(32) },
+ *     listeners: {
+ *       onChange: ({ value }) => track("staff_name_changed", { value }),
+ *     },
+ *     defaultValue: "",
+ *     renderMeta: { span: 12 },
  *     render: field => <field.Input required label="Name" />,
  *   }),
  * ];
  *
  * // Render:
  * items.map(item => (
- *   <AppField name={item.name} validators={restoreValidators(item.validators)}>
+ *   <AppField
+ *     key={item.name}
+ *     name={item.name}
+ *     {...restoreFieldOptions(item.fieldOptions)}
+ *   >
  *     {item.render}
  *   </AppField>
  * ));

package/dist/types/form/helpers/index.d.ts

@@ -1,3 +1,3 @@
-export { createField, restoreValidators } from './create-field';
-export type { CreateFieldFn, ErasedValidators, FormFieldItem } from './create-field';
+export { createField, restoreFieldOptions } from './create-field';
+export type { CreateFieldFn, ErasedFieldOptions, FormFieldItem } from './create-field';
 export { withFormItem } from './with-form-item';

package/dist/types/form/index.d.ts

@@ -2,7 +2,7 @@ export type * from './components';
 export type * from './fields';
 export { createFormOptions, useFormContext, useFormStore, withFieldGroup, withForm } from './form';
 export { DefaultResetButton, DefaultSubmitButton, FormActions, type FormActionsProps } from './form-actions';
-export { restoreValidators } from './helpers';
+export { restoreFieldOptions } from './helpers';
 export type { FormFieldItem } from './helpers';
 export type * from './types';
 export { useForm } from './use-form';

package/dist/types/index.d.ts

@@ -37,7 +37,7 @@ export { Flex, type FlexProps } from './flex';
 export { FlexCard, type FlexCardProps } from './flex-card';
 export { FlipText, type FlipTextProps } from './flip-text';
 export { FloatButton, type FloatButtonProps } from './float-button';
-export { createFormOptions, restoreValidators, useForm, useFormContext, useFormStore, withFieldGroup, withForm } from './form';
+export { createFormOptions, restoreFieldOptions, useForm, useFormContext, useFormStore, withFieldGroup, withForm } from './form';
 export type * from './form';
 export { FormDrawer, type FormDrawerProps } from './form-drawer';
 export { FormModal, type FormModalProps } from './form-modal';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vef-framework-react/components",
   "type": "module",
-  "version": "2.1.11",
+  "version": "2.1.12",
   "private": false,
   "description": "Components for VEF Framework",
   "author": {
@@ -68,9 +68,9 @@
     "react-error-boundary": "^6.1.1",
     "react-syntax-highlighter": "^16.1.1",
     "tslib": "^2.8.1",
-    "@vef-framework-react/core": "2.1.11",
-    "@vef-framework-react/shared": "2.1.11",
-    "@vef-framework-react/hooks": "2.1.11"
+    "@vef-framework-react/shared": "2.1.12",
+    "@vef-framework-react/core": "2.1.12",
+    "@vef-framework-react/hooks": "2.1.12"
   },
   "devDependencies": {
     "@types/react-syntax-highlighter": "^15.5.13",