@vavt/react-ui 1.0.0

package/dist/types/DateTimePicker/type.d.ts

@@ -0,0 +1,64 @@
+import type { DatePickerBaseProps, DatePickerDateValue, DatePickerPlacement, DatePickerRangeValue, DatePickerShortcut, DatePickerSize, DatePickerValue, DatePickerValueType } from '../DatePicker/type.js';
+/** 日期时间选择器尺寸大小 */
+export type DateTimePickerSize = DatePickerSize;
+/** 浮层弹窗对齐方向 */
+export type DateTimePickerPlacement = DatePickerPlacement;
+/** 绑定值类型 */
+export type DateTimePickerValueType = DatePickerValueType;
+/** 单个日期时间值 */
+export type DateTimePickerDateValue = DatePickerDateValue;
+/** 日期时间范围数值元组 */
+export type DateTimePickerRangeValue = DatePickerRangeValue;
+/** 日期时间选择器支持的值类型联合 */
+export type DateTimePickerValue = DatePickerValue;
+/** 日期时间选择器快捷项定义 */
+export type DateTimePickerShortcut<TValue = DateTimePickerDateValue | DateTimePickerRangeValue> = DatePickerShortcut<TValue>;
+/** DateTimePicker 基础属性接口 */
+export interface DateTimePickerBaseProps extends DatePickerBaseProps {
+    /** 允许选择的最小时间（格式 'HH:mm:ss'） */
+    minTime?: string;
+    /** 允许选择的最大时间（格式 'HH:mm:ss'） */
+    maxTime?: string;
+    /** 自定义判断特定时间是否禁用的函数 */
+    disabledTime?: (time: string) => boolean;
+}
+/** 单日期时间选择模式（返回 Date 对象）属性接口 */
+export interface DateTimePickerDateProps extends DateTimePickerBaseProps {
+    range?: false;
+    valueType?: 'date';
+    value?: Date | null;
+    defaultValue?: Date | null;
+    shortcuts?: DateTimePickerShortcut<Date>[];
+    onChange?: (value: Date | null) => void;
+}
+/** 单日期时间选择模式（返回格式化字符串）属性接口 */
+export interface DateTimePickerStringProps extends DateTimePickerBaseProps {
+    range?: false;
+    valueType: 'string';
+    value?: string | null;
+    defaultValue?: string | null;
+    shortcuts?: DateTimePickerShortcut<string>[];
+    onChange?: (value: string | null) => void;
+}
+/** 日期时间范围选择模式（返回 Date 元组）属性接口 */
+export interface DateTimePickerDateRangeProps extends DateTimePickerBaseProps {
+    range: true;
+    valueType?: 'date';
+    value?: [Date, Date] | null;
+    defaultValue?: [Date, Date] | null;
+    shortcuts?: DateTimePickerShortcut<[Date, Date]>[];
+    onChange?: (value: [Date, Date] | null) => void;
+}
+/** 日期时间范围选择模式（返回格式化字符串元组）属性接口 */
+export interface DateTimePickerStringRangeProps extends DateTimePickerBaseProps {
+    range: true;
+    valueType: 'string';
+    value?: [string, string] | null;
+    defaultValue?: [string, string] | null;
+    shortcuts?: DateTimePickerShortcut<[string, string]>[];
+    onChange?: (value: [string, string] | null) => void;
+}
+/** DateTimePicker 组件属性联合类型 */
+export type DateTimePickerProps = DateTimePickerDateProps | DateTimePickerStringProps | DateTimePickerDateRangeProps | DateTimePickerStringRangeProps;
+/** DateTimePicker 根 DOM 元素类型 */
+export type DateTimePickerRef = HTMLDivElement;

package/dist/types/Divider/Divider.d.cts

@@ -0,0 +1,3 @@
+import type { DividerProps } from './type.cjs';
+declare const Divider: import("react").ForwardRefExoticComponent<DividerProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Divider;

package/dist/types/Divider/Divider.d.ts

@@ -0,0 +1,3 @@
+import type { DividerProps } from './type.js';
+declare const Divider: import("react").ForwardRefExoticComponent<DividerProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Divider;

package/dist/types/Divider/index.d.cts

@@ -0,0 +1,5 @@
+import Divider from './Divider.cjs';
+/** Divider 分割线组件 */
+export declare const VlDivider: import("react").ForwardRefExoticComponent<import("./type.cjs").DividerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DividerProps, DividerDirection, DividerContentPosition, DividerRef } from './type.cjs';
+export default Divider;

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

@@ -0,0 +1,5 @@
+import Divider from './Divider.js';
+/** Divider 分割线组件 */
+export declare const VlDivider: import("react").ForwardRefExoticComponent<import("./type.js").DividerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DividerProps, DividerDirection, DividerContentPosition, DividerRef } from './type.js';
+export default Divider;

package/dist/types/Divider/type.d.cts

@@ -0,0 +1,20 @@
+import type { HTMLAttributes } from 'react';
+/** 分割线方向：水平 (horizontal) 或 垂直 (vertical) */
+export type DividerDirection = 'horizontal' | 'vertical';
+/** 分割线内嵌文本的对齐位置：左侧/前置 (start) | 居中 (center) | 右侧/后置 (end) */
+export type DividerContentPosition = 'start' | 'center' | 'end';
+/** Divider 根 DOM 元素类型 */
+export type DividerRef = HTMLDivElement;
+/**
+ * Divider 组件属性接口
+ */
+export interface DividerProps extends HTMLAttributes<HTMLDivElement> {
+    /** 分割线方向，默认为 `horizontal` */
+    direction?: DividerDirection;
+    /** 内嵌内容的对齐位置，仅在 `direction="horizontal"` 时生效，默认为 `center` */
+    contentPosition?: DividerContentPosition;
+    /** 是否使用虚线样式，默认为 false */
+    dashed?: boolean;
+    /** 是否向内缩进两端边距，默认为 false */
+    inset?: boolean;
+}

package/dist/types/Divider/type.d.ts

@@ -0,0 +1,20 @@
+import type { HTMLAttributes } from 'react';
+/** 分割线方向：水平 (horizontal) 或 垂直 (vertical) */
+export type DividerDirection = 'horizontal' | 'vertical';
+/** 分割线内嵌文本的对齐位置：左侧/前置 (start) | 居中 (center) | 右侧/后置 (end) */
+export type DividerContentPosition = 'start' | 'center' | 'end';
+/** Divider 根 DOM 元素类型 */
+export type DividerRef = HTMLDivElement;
+/**
+ * Divider 组件属性接口
+ */
+export interface DividerProps extends HTMLAttributes<HTMLDivElement> {
+    /** 分割线方向，默认为 `horizontal` */
+    direction?: DividerDirection;
+    /** 内嵌内容的对齐位置，仅在 `direction="horizontal"` 时生效，默认为 `center` */
+    contentPosition?: DividerContentPosition;
+    /** 是否使用虚线样式，默认为 false */
+    dashed?: boolean;
+    /** 是否向内缩进两端边距，默认为 false */
+    inset?: boolean;
+}

package/dist/types/Drawer/Drawer.d.cts

@@ -0,0 +1,3 @@
+import type { DrawerProps } from './type.cjs';
+declare const Drawer: import("react").ForwardRefExoticComponent<DrawerProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Drawer;

package/dist/types/Drawer/Drawer.d.ts

@@ -0,0 +1,3 @@
+import type { DrawerProps } from './type.js';
+declare const Drawer: import("react").ForwardRefExoticComponent<DrawerProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Drawer;

package/dist/types/Drawer/index.d.cts

@@ -0,0 +1,5 @@
+import Drawer from './Drawer.cjs';
+/** Drawer 抽屉组件 */
+export declare const VlDrawer: import("react").ForwardRefExoticComponent<import("./type.cjs").DrawerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DrawerProps, DrawerPlacement, DrawerRef } from './type.cjs';
+export default Drawer;

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

@@ -0,0 +1,5 @@
+import Drawer from './Drawer.js';
+/** Drawer 抽屉组件 */
+export declare const VlDrawer: import("react").ForwardRefExoticComponent<import("./type.js").DrawerProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DrawerProps, DrawerPlacement, DrawerRef } from './type.js';
+export default Drawer;

package/dist/types/Drawer/type.d.cts

@@ -0,0 +1,46 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 抽屉滑出方向：左侧 (left) | 右侧 (right) | 顶部 (top) | 底部 (bottom) */
+export type DrawerPlacement = 'left' | 'right' | 'top' | 'bottom';
+/** Drawer 根 DOM 元素类型 */
+export type DrawerRef = HTMLDivElement;
+/**
+ * Drawer 抽屉组件属性接口
+ */
+export interface DrawerProps extends Omit<HTMLAttributes<HTMLElement>, 'onChange' | 'title'> {
+    /** 受控模式：抽屉是否处于打开显示状态 */
+    open?: boolean;
+    /** 非受控模式：初始是否打开显示，默认为 false */
+    defaultOpen?: boolean;
+    /** 抽屉标题文本或自定义节点 */
+    title?: ReactNode;
+    /** 自定义整个头部区域节点 */
+    header?: ReactNode;
+    /** 自定义底部操作按钮区域节点 */
+    footer?: ReactNode;
+    /** 抽屉滑出方向，默认为 `'right'` */
+    placement?: DrawerPlacement;
+    /** left/right 模式下的抽屉宽度（如 360 或 `'360px'`），默认为 360 */
+    width?: number | string;
+    /** top/bottom 模式下的抽屉高度（如 320 或 `'320px'`），默认为 320 */
+    height?: number | string;
+    /** 是否展示背景遮罩层，默认为 true */
+    mask?: boolean;
+    /** 点击遮罩层是否触发关闭，默认为 true */
+    closeOnClickOverlay?: boolean;
+    /** 按下 Escape 键是否触发关闭，默认为 true */
+    closeOnPressEscape?: boolean;
+    /** 是否显示右上角关闭图标按钮，默认为 true */
+    showClose?: boolean;
+    /** 抽屉打开期间是否锁定网页 body 滚动，默认为 true */
+    lockScroll?: boolean;
+    /** 关闭后是否销毁子节点 DOM，默认为 false */
+    destroyOnClose?: boolean;
+    /** 抽屉 z-index 层级 */
+    zIndex?: number;
+    /** 抽屉打开/关闭状态发生变化时的回调函数 */
+    onChange?: (value: boolean) => void;
+    /** 抽屉打开动画开始时的回调函数 */
+    onOpen?: () => void;
+    /** 触发关闭动作时的回调函数 */
+    onClose?: () => void;
+}

package/dist/types/Drawer/type.d.ts

@@ -0,0 +1,46 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/** 抽屉滑出方向：左侧 (left) | 右侧 (right) | 顶部 (top) | 底部 (bottom) */
+export type DrawerPlacement = 'left' | 'right' | 'top' | 'bottom';
+/** Drawer 根 DOM 元素类型 */
+export type DrawerRef = HTMLDivElement;
+/**
+ * Drawer 抽屉组件属性接口
+ */
+export interface DrawerProps extends Omit<HTMLAttributes<HTMLElement>, 'onChange' | 'title'> {
+    /** 受控模式：抽屉是否处于打开显示状态 */
+    open?: boolean;
+    /** 非受控模式：初始是否打开显示，默认为 false */
+    defaultOpen?: boolean;
+    /** 抽屉标题文本或自定义节点 */
+    title?: ReactNode;
+    /** 自定义整个头部区域节点 */
+    header?: ReactNode;
+    /** 自定义底部操作按钮区域节点 */
+    footer?: ReactNode;
+    /** 抽屉滑出方向，默认为 `'right'` */
+    placement?: DrawerPlacement;
+    /** left/right 模式下的抽屉宽度（如 360 或 `'360px'`），默认为 360 */
+    width?: number | string;
+    /** top/bottom 模式下的抽屉高度（如 320 或 `'320px'`），默认为 320 */
+    height?: number | string;
+    /** 是否展示背景遮罩层，默认为 true */
+    mask?: boolean;
+    /** 点击遮罩层是否触发关闭，默认为 true */
+    closeOnClickOverlay?: boolean;
+    /** 按下 Escape 键是否触发关闭，默认为 true */
+    closeOnPressEscape?: boolean;
+    /** 是否显示右上角关闭图标按钮，默认为 true */
+    showClose?: boolean;
+    /** 抽屉打开期间是否锁定网页 body 滚动，默认为 true */
+    lockScroll?: boolean;
+    /** 关闭后是否销毁子节点 DOM，默认为 false */
+    destroyOnClose?: boolean;
+    /** 抽屉 z-index 层级 */
+    zIndex?: number;
+    /** 抽屉打开/关闭状态发生变化时的回调函数 */
+    onChange?: (value: boolean) => void;
+    /** 抽屉打开动画开始时的回调函数 */
+    onOpen?: () => void;
+    /** 触发关闭动作时的回调函数 */
+    onClose?: () => void;
+}

package/dist/types/Dropdown/Dropdown.d.cts

@@ -0,0 +1,3 @@
+import type { DropdownProps } from './type.cjs';
+declare const Dropdown: import("react").ForwardRefExoticComponent<DropdownProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Dropdown;

package/dist/types/Dropdown/Dropdown.d.ts

@@ -0,0 +1,3 @@
+import type { DropdownProps } from './type.js';
+declare const Dropdown: import("react").ForwardRefExoticComponent<DropdownProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Dropdown;

package/dist/types/Dropdown/index.d.cts

@@ -0,0 +1,5 @@
+import Dropdown from './Dropdown.cjs';
+/** Dropdown 下拉菜单组件 */
+export declare const VlDropdown: import("react").ForwardRefExoticComponent<import("./type.cjs").DropdownProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DropdownProps, DropdownOption, DropdownPlacement, DropdownTriggerType, DropdownOptionStatus, DropdownRef } from './type.cjs';
+export default Dropdown;

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

@@ -0,0 +1,5 @@
+import Dropdown from './Dropdown.js';
+/** Dropdown 下拉菜单组件 */
+export declare const VlDropdown: import("react").ForwardRefExoticComponent<import("./type.js").DropdownProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { DropdownProps, DropdownOption, DropdownPlacement, DropdownTriggerType, DropdownOptionStatus, DropdownRef } from './type.js';
+export default Dropdown;

package/dist/types/Dropdown/type.d.cts

@@ -0,0 +1,67 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+import type { DecorativeIcon } from '../_shared/icon.cjs';
+/** 下拉菜单弹出方向 */
+export type DropdownPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** 触发菜单展开的交互方式：鼠标悬停 (hover) | 点击 (click) | 鼠标右键菜单 (context-menu) */
+export type DropdownTriggerType = 'hover' | 'click' | 'context-menu';
+/** 菜单选项状态色调 */
+export type DropdownOptionStatus = 'default' | 'primary' | 'success' | 'warning' | 'danger';
+/** 选项前置图标类型 */
+type DropdownOptionIcon = DecorativeIcon;
+/** 单个下拉菜单项配置 */
+export interface DropdownOption {
+    /** 选项唯一标识值 */
+    value?: string | number;
+    /** 选项显示文本 */
+    label?: string;
+    /** 选项前置图标 */
+    icon?: DropdownOptionIcon;
+    /** 选项语义状态颜色，默认为 `'default'` */
+    status?: DropdownOptionStatus;
+    /** 是否禁用该选项，默认为 false */
+    disabled?: boolean;
+    /** 是否作为菜单分割线展示，默认为 false */
+    divider?: boolean;
+    /** 单个选项的点击独立回调（优先于组件统一事件） */
+    onClick?: (option: DropdownOption) => void;
+}
+/**
+ * Dropdown 组件属性接口
+ */
+export interface DropdownProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'onChange'> {
+    /** 受控模式：菜单是否展开 */
+    open?: boolean;
+    /** 非受控模式：初始展开状态，默认为 false */
+    defaultOpen?: boolean;
+    /** 是否禁用下拉菜单，默认为 false */
+    disabled?: boolean;
+    /** 菜单弹出对齐位置，默认为 `'bottom-start'` */
+    placement?: DropdownPlacement;
+    /** 菜单与触发器之间的像素间距，默认为 8 */
+    offset?: number;
+    /** 点击菜单内部任意项后是否自动收起菜单，默认为 true */
+    closeOnContentClick?: boolean;
+    /** 触发菜单展开的交互方式，默认为 `'hover'` */
+    trigger?: DropdownTriggerType;
+    /** 预设菜单选项列表 */
+    options?: DropdownOption[];
+    /** 点击外部区域时是否自动收起菜单，默认为 true */
+    closeOnOutsideClick?: boolean;
+    /** 自定义触发器内容节点（替代默认按钮） */
+    triggerContent?: ReactNode;
+    /** 菜单面板的无障碍标签说明，默认为 `'菜单'` */
+    menuLabel?: string;
+    /** 展开/收起状态发生变化时的回调函数 */
+    onChange?: (value: boolean) => void;
+    /** 菜单打开时的回调函数 */
+    onOpen?: () => void;
+    /** 菜单关闭时的回调函数 */
+    onClose?: () => void;
+    /** 选中某一选项时的回调函数（返回选项对象） */
+    onSelect?: (option: DropdownOption) => void;
+    /** 选中某一选项时的指令回调函数（返回 value 和选项对象） */
+    onCommand?: (value: DropdownOption['value'], option: DropdownOption) => void;
+}
+/** Dropdown 根 DOM 容器元素类型 */
+export type DropdownRef = HTMLDivElement;
+export {};

package/dist/types/Dropdown/type.d.ts

@@ -0,0 +1,67 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+import type { DecorativeIcon } from '../_shared/icon.js';
+/** 下拉菜单弹出方向 */
+export type DropdownPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/** 触发菜单展开的交互方式：鼠标悬停 (hover) | 点击 (click) | 鼠标右键菜单 (context-menu) */
+export type DropdownTriggerType = 'hover' | 'click' | 'context-menu';
+/** 菜单选项状态色调 */
+export type DropdownOptionStatus = 'default' | 'primary' | 'success' | 'warning' | 'danger';
+/** 选项前置图标类型 */
+type DropdownOptionIcon = DecorativeIcon;
+/** 单个下拉菜单项配置 */
+export interface DropdownOption {
+    /** 选项唯一标识值 */
+    value?: string | number;
+    /** 选项显示文本 */
+    label?: string;
+    /** 选项前置图标 */
+    icon?: DropdownOptionIcon;
+    /** 选项语义状态颜色，默认为 `'default'` */
+    status?: DropdownOptionStatus;
+    /** 是否禁用该选项，默认为 false */
+    disabled?: boolean;
+    /** 是否作为菜单分割线展示，默认为 false */
+    divider?: boolean;
+    /** 单个选项的点击独立回调（优先于组件统一事件） */
+    onClick?: (option: DropdownOption) => void;
+}
+/**
+ * Dropdown 组件属性接口
+ */
+export interface DropdownProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'onChange'> {
+    /** 受控模式：菜单是否展开 */
+    open?: boolean;
+    /** 非受控模式：初始展开状态，默认为 false */
+    defaultOpen?: boolean;
+    /** 是否禁用下拉菜单，默认为 false */
+    disabled?: boolean;
+    /** 菜单弹出对齐位置，默认为 `'bottom-start'` */
+    placement?: DropdownPlacement;
+    /** 菜单与触发器之间的像素间距，默认为 8 */
+    offset?: number;
+    /** 点击菜单内部任意项后是否自动收起菜单，默认为 true */
+    closeOnContentClick?: boolean;
+    /** 触发菜单展开的交互方式，默认为 `'hover'` */
+    trigger?: DropdownTriggerType;
+    /** 预设菜单选项列表 */
+    options?: DropdownOption[];
+    /** 点击外部区域时是否自动收起菜单，默认为 true */
+    closeOnOutsideClick?: boolean;
+    /** 自定义触发器内容节点（替代默认按钮） */
+    triggerContent?: ReactNode;
+    /** 菜单面板的无障碍标签说明，默认为 `'菜单'` */
+    menuLabel?: string;
+    /** 展开/收起状态发生变化时的回调函数 */
+    onChange?: (value: boolean) => void;
+    /** 菜单打开时的回调函数 */
+    onOpen?: () => void;
+    /** 菜单关闭时的回调函数 */
+    onClose?: () => void;
+    /** 选中某一选项时的回调函数（返回选项对象） */
+    onSelect?: (option: DropdownOption) => void;
+    /** 选中某一选项时的指令回调函数（返回 value 和选项对象） */
+    onCommand?: (value: DropdownOption['value'], option: DropdownOption) => void;
+}
+/** Dropdown 根 DOM 容器元素类型 */
+export type DropdownRef = HTMLDivElement;
+export {};

package/dist/types/Form/Form.d.cts

@@ -0,0 +1,3 @@
+import type { FormComponent } from './type.cjs';
+declare const Form: FormComponent;
+export default Form;

package/dist/types/Form/Form.d.ts

@@ -0,0 +1,3 @@
+import type { FormComponent } from './type.js';
+declare const Form: FormComponent;
+export default Form;

package/dist/types/Form/FormItem.d.cts

@@ -0,0 +1,3 @@
+import type { FormItemProps } from './type.cjs';
+declare const FormItem: import("react").ForwardRefExoticComponent<FormItemProps & import("react").RefAttributes<HTMLDivElement>>;
+export default FormItem;

package/dist/types/Form/FormItem.d.ts

@@ -0,0 +1,3 @@
+import type { FormItemProps } from './type.js';
+declare const FormItem: import("react").ForwardRefExoticComponent<FormItemProps & import("react").RefAttributes<HTMLDivElement>>;
+export default FormItem;

package/dist/types/Form/context.d.cts

@@ -0,0 +1,39 @@
+import type { FormErrors, FormRule, FormValidateTrigger, FormValues } from './type.cjs';
+/**
+ * 字段元数据。
+ *
+ * 它由 FormItem 持有并就地更新，Form 只在需要时读取当前值。把元数据与“注册身份”分开，
+ * 是为了让 label/rules 变化不必重新注册字段——重新注册会清理该字段的校验 token，
+ * 使进行中的异步校验失去写入权限，界面上表现为“校验中”消失且不显示任何错误。
+ */
+export interface FormFieldMeta {
+    /** 优先用于用户可读的默认错误文案；没有文本标签时回退到字段名。 */
+    label?: string;
+    rules: FormRule[];
+    /** 提交失败时用于定位真实可聚焦控件；ref 回调会在挂载和卸载阶段同步更新。 */
+    element: HTMLElement | null;
+}
+export interface FormFieldRegistration {
+    /** 字段名同时是 values/errors 的键；同一 Form 中当前只允许一个活跃注册对象拥有该名字。 */
+    name: string;
+    /** FormItem 实例身份。同名字段被新实例接管时，旧实例据此只清理自己的注册。 */
+    token: symbol;
+    /**
+     * 指向 FormItem 内部元数据容器的稳定引用。
+     * 引用在整个挂载期间不变，因此 Form 每次读取到的都是最新元数据，而无需重新注册。
+     */
+    metaRef: {
+        readonly current: FormFieldMeta;
+    };
+}
+export interface FormContextValue {
+    values: FormValues;
+    errors: FormErrors;
+    validating: Record<string, boolean>;
+    defaultValidateTrigger: FormValidateTrigger[];
+    registerField: (field: FormFieldRegistration) => () => void;
+    updateField: (name: string, value: unknown) => FormValues;
+    validateField: (name: string, values?: FormValues) => Promise<string[]>;
+}
+export declare const FormProvider: import("react").Provider<FormContextValue | null>;
+export declare const useFormContext: () => FormContextValue | null;

package/dist/types/Form/context.d.ts

@@ -0,0 +1,39 @@
+import type { FormErrors, FormRule, FormValidateTrigger, FormValues } from './type.js';
+/**
+ * 字段元数据。
+ *
+ * 它由 FormItem 持有并就地更新，Form 只在需要时读取当前值。把元数据与“注册身份”分开，
+ * 是为了让 label/rules 变化不必重新注册字段——重新注册会清理该字段的校验 token，
+ * 使进行中的异步校验失去写入权限，界面上表现为“校验中”消失且不显示任何错误。
+ */
+export interface FormFieldMeta {
+    /** 优先用于用户可读的默认错误文案；没有文本标签时回退到字段名。 */
+    label?: string;
+    rules: FormRule[];
+    /** 提交失败时用于定位真实可聚焦控件；ref 回调会在挂载和卸载阶段同步更新。 */
+    element: HTMLElement | null;
+}
+export interface FormFieldRegistration {
+    /** 字段名同时是 values/errors 的键；同一 Form 中当前只允许一个活跃注册对象拥有该名字。 */
+    name: string;
+    /** FormItem 实例身份。同名字段被新实例接管时，旧实例据此只清理自己的注册。 */
+    token: symbol;
+    /**
+     * 指向 FormItem 内部元数据容器的稳定引用。
+     * 引用在整个挂载期间不变，因此 Form 每次读取到的都是最新元数据，而无需重新注册。
+     */
+    metaRef: {
+        readonly current: FormFieldMeta;
+    };
+}
+export interface FormContextValue {
+    values: FormValues;
+    errors: FormErrors;
+    validating: Record<string, boolean>;
+    defaultValidateTrigger: FormValidateTrigger[];
+    registerField: (field: FormFieldRegistration) => () => void;
+    updateField: (name: string, value: unknown) => FormValues;
+    validateField: (name: string, values?: FormValues) => Promise<string[]>;
+}
+export declare const FormProvider: import("react").Provider<FormContextValue | null>;
+export declare const useFormContext: () => FormContextValue | null;

package/dist/types/Form/index.d.cts

@@ -0,0 +1,8 @@
+/** Form 表单组件（含 Form.Item 静态挂载） */
+export declare const VlForm: import("./type.cjs").FormComponent & {
+    Item: import("react").ForwardRefExoticComponent<import("./type.cjs").FormItemProps & import("react").RefAttributes<HTMLDivElement>>;
+};
+/** FormItem 表单项组件 */
+export declare const VlFormItem: import("react").ForwardRefExoticComponent<import("./type.cjs").FormItemProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { FormComponent, FormErrors, FormItemProps, FormLayout, FormProps, FormRef, FormRule, FormRuleType, FormValidateTrigger, FormValidationResult, FormValues } from './type.cjs';
+export default VlForm;

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

@@ -0,0 +1,8 @@
+/** Form 表单组件（含 Form.Item 静态挂载） */
+export declare const VlForm: import("./type.js").FormComponent & {
+    Item: import("react").ForwardRefExoticComponent<import("./type.js").FormItemProps & import("react").RefAttributes<HTMLDivElement>>;
+};
+/** FormItem 表单项组件 */
+export declare const VlFormItem: import("react").ForwardRefExoticComponent<import("./type.js").FormItemProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { FormComponent, FormErrors, FormItemProps, FormLayout, FormProps, FormRef, FormRule, FormRuleType, FormValidateTrigger, FormValidationResult, FormValues } from './type.js';
+export default VlForm;