@shaonq/vue 1.3.3 → 1.4.3

package/lib/index.d.ts

@@ -4,6 +4,7 @@ import { Component } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComponentProvideOptions } from 'vue';
 import { ComputedOptions } from 'vue';
+import { CSSProperties } from 'vue';
 import { DefineComponent } from 'vue';
 import { ExtractPropTypes } from 'vue';
 import { FormItem } from '@arco-design/web-vue';
@@ -19,7 +20,9 @@ import { PublicProps } from 'vue';
 import { Ref } from 'vue';
 import { SelectOptionData } from '@arco-design/web-vue';
 import { Size } from '@arco-design/web-vue';
+import { StoreDefinition } from 'pinia';
 import { TablePublicMethods } from 'vxe-table';
+import { VNode } from 'vue';
 import { VxeColumnPropTypes } from 'vxe-table';
 import { VxeTable } from 'vxe-table';
 import { VxeTableDataRow } from 'vxe-table';
@@ -227,14 +230,24 @@ declare type __VLS_WithTemplateSlots_8<T, S> = T & {
 
 declare type ButtonInstance = InstanceType<typeof Button>;
 
-/** 组件属性处理函数签名 */
+/**
+ * componentAttr 中函数属性的回调参数
+ * @description 当 `componentAttr` 的某个值为函数时，函数在渲染时执行，注入以下参数
+ */
 declare type ComponentAttrHandler = (util: OrcFormUtilBind, index?: any) => unknown;
 
-/** 组件属性允许的值类型 */
+/** componentAttr 支持的静态值类型 */
 declare type ComponentAttrValue = null | boolean | number | string | RecordAny_3 | RecordAny_3[] | ComponentAttrHandler;
 
-export declare interface CssType extends Partial<CSSStyleDeclaration>, RecordAny_2 {
-}
+/**
+ * 单元格样式：对象 | 支持动态函数
+ * @param {Object} params
+ * @param {any} params.row - 行数据
+ * @param {number} params.rowIndex - 行索引
+ * @param {RecordAny} params.column - 列配置
+ * @param {number} params.columnIndex - 列索引
+ */
+export declare type CssType = Partial<CSSProperties> & RecordAny_2;
 
 export declare const deepClone: <T = RecordAny | RecordAny[]>(origin: T) => T;
 
@@ -245,6 +258,8 @@ export default _default;
 
 export declare function delay(ms: number): Promise<unknown>;
 
+declare type DictLoadFn = (code: string) => Promise<unknown[]>;
+
 export declare const download: (url: string, fileName?: string) => boolean;
 
 /**
@@ -290,15 +305,15 @@ declare interface FieldOption {
 
 export declare function findObject<T extends RecordAny>(obj: T, keys?: string | string[]): T;
 
-/** 行数据格式化 千分位|日期   */
+/** 行数据格式化工具：千分位|日期|百分比 */
 export declare const formatTable: {
-    /** 千分位|保留小数 */
+    /** 千分位格式化，支持小数位控制 */
     tf: (val: any, digits?: any) => any;
-    /** 快捷格式化日期 */
+    /** 快捷日期格式化 yyyy-MM-dd */
     t: (val: any) => string;
-    /** 完整格式化日期  yyyy-MM-dd HH:mm:ss */
+    /** 完整日期格式化，默认 yyyy-MM-dd HH:mm:ss */
     time: (val: any, f?: string) => string;
-    /** percent 格式化百分比 */
+    /** 百分比格式化，默认保留2位小数，数据自动×100 */
     p: (val: any, digits?: any, percent?: string) => string;
 };
 
@@ -410,396 +425,11 @@ declare const lang_2: {
     };
 };
 
-export declare const locale: {
-    enUS: {
-        fe: {
-            panel: {
-                title: string;
-                model: string;
-                bcid: string;
-                padding: string;
-                name: string;
-                width: string;
-                height: string;
-                size: string;
-                labelWidth: string;
-                labelAlign: string;
-                custom: string;
-                placeholder: string;
-                layout: string;
-                block: string;
-                inline: string;
-                contentPosition: string;
-                left: string;
-                right: string;
-                center: string;
-                showInput: string;
-                min: string;
-                max: string;
-                step: string;
-                multiple: string;
-                filterable: string;
-                allowHalf: string;
-                showAlpha: string;
-                showLabel: string;
-                option: string;
-                options: string;
-                staticData: string;
-                remoteData: string;
-                remoteFunc: string;
-                value: string;
-                label: string;
-                childrenOption: string;
-                defaultValue: string;
-                showType: string;
-                isRange: string;
-                isTimestamp: string;
-                startPlaceholder: string;
-                endPlaceholder: string;
-                format: string;
-                limit: string;
-                imageAction: string;
-                tip: string;
-                action: string;
-                defaultType: string;
-                string: string;
-                object: string;
-                array: string;
-                number: string;
-                boolean: string;
-                integer: string;
-                float: string;
-                url: string;
-                email: string;
-                hex: string;
-                gutter: string;
-                columnOption: string;
-                span: string;
-                justify: string;
-                justifyStart: string;
-                justifyEnd: string;
-                justifyCenter: string;
-                justifySpaceAround: string;
-                justifySpaceBetween: string;
-                align: string;
-                alignTop: string;
-                alignMiddle: string;
-                alignBottom: string;
-                type: string;
-                default: string;
-                card: string;
-                borderCard: string;
-                tabPosition: string;
-                top: string;
-                bottom: string;
-                tabOption: string;
-                tabName: string;
-                customClass: string;
-                attribute: string;
-                dataBind: string;
-                hidden: string;
-                readonly: string;
-                disabled: string;
-                editable: string;
-                clearable: string;
-                arrowControl: string;
-                isDelete: string;
-                isEdit: string;
-                showPassword: string;
-                validate: string;
-                required: string;
-                patternPlaceholder: string;
-                newOption: string;
-                tab: string;
-                validatorRequired: string;
-                validatorType: string;
-                validatorPattern: string;
-                showWordLimit: string;
-                maxLength: string;
-                textAlign: string;
-                fontSize: string;
-                fontFamily: string;
-                rowspan: string;
-                colspan: string;
-                borderTop: string;
-                borderLeft: string;
-            };
-            side: {
-                fields: {
-                    input: string;
-                    textarea: string;
-                    number: string;
-                    radio: string;
-                    checkbox: string;
-                    time: string;
-                    date: string;
-                    rate: string;
-                    color: string;
-                    select: string;
-                    switch: string;
-                    slider: string;
-                    text: string;
-                    blank: string;
-                    fileupload: string;
-                    imgupload: string;
-                    editor: string;
-                    cascader: string;
-                    table: string;
-                    grid: string;
-                    tabs: string;
-                    divider: string;
-                };
-                basic: {
-                    title: string;
-                };
-                advance: {
-                    title: string;
-                };
-                layout: {
-                    title: string;
-                };
-            };
-            description: {
-                containerEmpty: string;
-                configEmpty: string;
-                tableEmpty: string;
-                uploadJsonInfo: string;
-            };
-            message: {
-                copySuccess: string;
-                validError: string;
-            };
-            actions: {
-                import: string;
-                clear: string;
-                preview: string;
-                json: string;
-                code: string;
-                getData: string;
-                reset: string;
-                copyData: string;
-                cancel: string;
-                confirm: string;
-                addOption: string;
-                addColumn: string;
-                addTab: string;
-                upload: string;
-                add: string;
-                enabledEdit: string;
-                disabledEdit: string;
-            };
-            config: {
-                width: string;
-                height: string;
-                title: string;
-                labelWidth: string;
-                labelAlign: string;
-                labelAlignLeft: string;
-                labelAlignRight: string;
-                labelAlignTop: string;
-                size: string;
-                customClass: string;
-            };
-        };
-    };
-    zhCN: {
-        fe: {
-            panel: {
-                title: string;
-                model: string;
-                bcid: string;
-                padding: string;
-                name: string;
-                width: string;
-                height: string;
-                size: string;
-                labelWidth: string;
-                labelAlign: string;
-                custom: string;
-                placeholder: string;
-                layout: string;
-                block: string;
-                inline: string;
-                contentPosition: string;
-                left: string;
-                right: string;
-                center: string;
-                showInput: string;
-                min: string;
-                max: string;
-                step: string;
-                multiple: string;
-                filterable: string;
-                allowHalf: string;
-                showAlpha: string;
-                showLabel: string;
-                option: string;
-                options: string;
-                staticData: string;
-                remoteData: string;
-                remoteFunc: string;
-                value: string;
-                label: string;
-                childrenOption: string;
-                defaultValue: string;
-                showType: string;
-                isRange: string;
-                isTimestamp: string;
-                startPlaceholder: string;
-                endPlaceholder: string;
-                format: string;
-                limit: string;
-                imageAction: string;
-                tip: string;
-                action: string;
-                defaultType: string;
-                string: string;
-                object: string;
-                array: string;
-                number: string;
-                boolean: string;
-                integer: string;
-                float: string;
-                url: string;
-                email: string;
-                hex: string;
-                gutter: string;
-                columnOption: string;
-                span: string;
-                justify: string;
-                justifyStart: string;
-                justifyEnd: string;
-                justifyCenter: string;
-                justifySpaceAround: string;
-                justifySpaceBetween: string;
-                align: string;
-                alignTop: string;
-                alignMiddle: string;
-                alignBottom: string;
-                type: string;
-                default: string;
-                card: string;
-                borderCard: string;
-                tabPosition: string;
-                top: string;
-                bottom: string;
-                tabOption: string;
-                tabName: string;
-                customClass: string;
-                attribute: string;
-                dataBind: string;
-                hidden: string;
-                readonly: string;
-                disabled: string;
-                editable: string;
-                clearable: string;
-                arrowControl: string;
-                isDelete: string;
-                isEdit: string;
-                showPassword: string;
-                validate: string;
-                required: string;
-                patternPlaceholder: string;
-                newOption: string;
-                tab: string;
-                validatorRequired: string;
-                validatorType: string;
-                validatorPattern: string;
-                showWordLimit: string;
-                maxLength: string;
-                textAlign: string;
-                fontSize: string;
-                fontFamily: string;
-                rowspan: string;
-                colspan: string;
-                borderTop: string;
-                borderLeft: string;
-            };
-            side: {
-                fields: {
-                    input: string;
-                    textarea: string;
-                    number: string;
-                    radio: string;
-                    checkbox: string;
-                    time: string;
-                    date: string;
-                    rate: string;
-                    color: string;
-                    select: string;
-                    switch: string;
-                    slider: string;
-                    text: string;
-                    blank: string;
-                    fileupload: string;
-                    imgupload: string;
-                    editor: string;
-                    cascader: string;
-                    table: string;
-                    grid: string;
-                    tabs: string;
-                    divider: string;
-                };
-                basic: {
-                    title: string;
-                };
-                advance: {
-                    title: string;
-                };
-                layout: {
-                    title: string;
-                };
-            };
-            description: {
-                containerEmpty: string;
-                configEmpty: string;
-                tableEmpty: string;
-                uploadJsonInfo: string;
-            };
-            message: {
-                copySuccess: string;
-                validError: string;
-            };
-            actions: {
-                import: string;
-                clear: string;
-                preview: string;
-                json: string;
-                code: string;
-                getData: string;
-                reset: string;
-                copyData: string;
-                cancel: string;
-                confirm: string;
-                addOption: string;
-                addColumn: string;
-                addTab: string;
-                upload: string;
-                add: string;
-                enabledEdit: string;
-                disabledEdit: string;
-            };
-            config: {
-                width: string;
-                height: string;
-                title: string;
-                labelWidth: string;
-                labelAlign: string;
-                labelAlignLeft: string;
-                labelAlignRight: string;
-                labelAlignTop: string;
-                size: string;
-                customClass: string;
-            };
-        };
-    };
-};
-
 /** 日志 */
 export declare function log(...args: any[]): void;
 
 /** 合并配置文件 */
-export declare function mergeConfig(defaults: RecordAny, overrides: RecordAny, isRoot?: boolean): RecordAny;
+export declare function mergeConfig(defaults: RecordAny, overrides: RecordAny): RecordAny;
 
 declare type ModalInstance = InstanceType<typeof Modal>;
 
@@ -812,61 +442,28 @@ declare function onSubmit(): Promise<[boolean, any]>;
 
 declare function onSubmit_2(): Promise<void>;
 
-export declare const OrcDesign: DefineComponent<ExtractPropTypes<{
-    readonly: BooleanConstructor;
-    data: {
-        type: ObjectConstructor;
-        default(): {};
-    };
-    models: {
-        type: ObjectConstructor;
-        default(): {};
-    };
-    remoteFuncs: {
-        type: ObjectConstructor;
-        default(): {};
-    };
-    moduleConfig: ArrayConstructor;
-}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-    save: (...args: any[]) => void;
-}, string, PublicProps, Readonly< ExtractPropTypes<{
-    readonly: BooleanConstructor;
-    data: {
-        type: ObjectConstructor;
-        default(): {};
-    };
-    models: {
-        type: ObjectConstructor;
-        default(): {};
-    };
-    remoteFuncs: {
-        type: ObjectConstructor;
-        default(): {};
-    };
-    moduleConfig: ArrayConstructor;
-}>> & Readonly<{
-    onSave?: ((...args: any[]) => any) | undefined;
-}>, {
-    data: Record<string, any>;
-    readonly: boolean;
-    models: Record<string, any>;
-    remoteFuncs: Record<string, any>;
-}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
-
 export declare const OrcForm: __VLS_WithTemplateSlots_5< DefineComponent<ExtractPropTypes<__VLS_WithDefaults_5<__VLS_TypePropsToRuntimeProps_5<{
+    /** 表单字段配置数组 */
     config?: OrcFormItem[] | undefined;
+    /** 标签宽度，默认 '110px' */
     labelWidth?: string | undefined;
+    /** 标签对齐方式，默认 'right' */
     labelAlign?: "left" | "right" | undefined;
+    /** 提交按钮加载状态 */
     loading?: boolean | undefined;
+    /** 是否禁用整个表单 */
     disabled?: boolean | undefined;
+    /** 是否隐藏提交按钮 */
     hideSubmit?: boolean | undefined;
+    /** 表单数据（v-model） */
     modelValue?: Record<string, any> | undefined;
     /** 栅格间距 */
     gutter?: number | undefined;
-    /** 栅格 24 */
+    /** 每行栅格数（基于 24 栅格），默认 24 */
     span?: number | undefined;
+    /** 透传到 Arco Form 组件的 props */
     formAttr?: Record<string, any> | undefined;
-    /** 栅格grid 优先级低于行 span */
+    /** 栅格 grid 配置（优先级低于行内 span） */
     grid?: Record<string, any> | undefined;
 }>, {
     config: () => never[];
@@ -883,25 +480,33 @@ export declare const OrcForm: __VLS_WithTemplateSlots_5< DefineComponent<Extract
 }>>, {
     onSubmit: typeof onSubmit;
     onReset: (defValue?: Partial<any> | undefined) => void;
-    resetFields(): void;
+    resetFields: typeof resetFields;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     error: (...args: any[]) => void;
     submit: (...args: any[]) => void;
     "update:modelValue": (...args: any[]) => void;
 }, string, PublicProps, Readonly< ExtractPropTypes<__VLS_WithDefaults_5<__VLS_TypePropsToRuntimeProps_5<{
+    /** 表单字段配置数组 */
     config?: OrcFormItem[] | undefined;
+    /** 标签宽度，默认 '110px' */
     labelWidth?: string | undefined;
+    /** 标签对齐方式，默认 'right' */
     labelAlign?: "left" | "right" | undefined;
+    /** 提交按钮加载状态 */
     loading?: boolean | undefined;
+    /** 是否禁用整个表单 */
     disabled?: boolean | undefined;
+    /** 是否隐藏提交按钮 */
     hideSubmit?: boolean | undefined;
+    /** 表单数据（v-model） */
     modelValue?: Record<string, any> | undefined;
     /** 栅格间距 */
     gutter?: number | undefined;
-    /** 栅格 24 */
+    /** 每行栅格数（基于 24 栅格），默认 24 */
     span?: number | undefined;
+    /** 透传到 Arco Form 组件的 props */
     formAttr?: Record<string, any> | undefined;
-    /** 栅格grid 优先级低于行 span */
+    /** 栅格 grid 配置（优先级低于行内 span） */
     grid?: Record<string, any> | undefined;
 }>, {
     config: () => never[];
@@ -920,11 +525,11 @@ export declare const OrcForm: __VLS_WithTemplateSlots_5< DefineComponent<Extract
     onSubmit?: ((...args: any[]) => any) | undefined;
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-    grid: Record<string, any>;
-    loading: boolean;
     disabled: boolean;
-    modelValue: Record<string, any>;
+    loading: boolean;
+    grid: Record<string, any>;
     span: number;
+    modelValue: Record<string, any>;
     config: OrcFormItem[];
     labelWidth: string;
     labelAlign: "left" | "right";
@@ -936,10 +541,7 @@ export declare const OrcForm: __VLS_WithTemplateSlots_5< DefineComponent<Extract
     value?: any;
     setValue?: ((v: any) => void) | undefined;
     options?: any;
-    utils: OrcFormUtil & {
-        model: string;
-        getFormItem: () => OrcFormItem;
-    } & Pick<OrcFormUtil, "onChange" | "onMounted">;
+    utils: OrcFormUtilBind;
     componentAttr: RecordAny_3;
 }) => any>> & {
     row?(_: {
@@ -974,7 +576,7 @@ export declare const OrcFormButton: __VLS_WithTemplateSlots_6< DefineComponent<E
     "onUpdate:modelValue"?: ((data: RecordAny) => any) | undefined;
 }>, {
     title: string;
-    size: "large" | "medium" | "small" | "mini";
+    size: "medium" | "large" | "small" | "mini";
     modelValue: RecordAny;
     gutter: number;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>, {
@@ -993,80 +595,148 @@ export declare const OrcFormButton: __VLS_WithTemplateSlots_6< DefineComponent<E
 }>;
 
 /**
- * 表单配置项类型定义
- * @description 描述表单字段的元数据和行为规则
+ * 表单配置项
+ * @description 通过 `:config` 传递给 `<orc-form>` 的数组项，描述每个字段
+ * @example
+ * ```ts
+ * { type: 'a-input', model: 'name', name: '姓名', defaultValue: '',
+ *   options: { required: true, placeholder: '请输入' } }
+ * ```
  */
 export declare type OrcFormItem = {
     /**
      * 组件类型标识
-     * @description 支持 Arco 内置组件或自定义 Vue 组件
+     * @description
+     * - 字符串: Arco 内置组件名，如 `'a-input'`、`'a-select'`、`'a-date-picker'`、`'a-switch'` 等
+     * - 组件对象: 自定义 Vue 组件或 `defineAsyncComponent`
+     *   - 自定义组件时自动注入 `modelValue` / `updateModelValue` 实现 v-model
+     *   - 自定义组件额外注入 `utils` prop（类型为 `OrcFormUtilBind`）
      * @example
-     * - 内置组件: 'a-input'
-     * - 自定义组件: defineAsyncComponent(() => import('./custom-component.vue'))
+     * ```ts
+     * type: 'a-input'
+     * type: 'a-select'
+     * type: 'a-date-picker'
+     * type: 'a-textarea'
+     * type: defineAsyncComponent(() => import('./CustomPicker.vue'))
+     * ```
      */
     type?: string | Component;
     /** 表单项标签文本 */
     name?: string;
-    /** 关联数据模型键名 */
-    model?: OrcFormUtil['model'];
-    /** 是否渲染该表单项 */
-    show?: boolean;
     /**
-     * 字段默认值
-     * @description 根据组件类型自动进行类型推断
+     * 关联数据字段名
+     * @description 对应 model 对象中的 key
      */
+    model?: string;
+    /** 是否渲染该字段，默认 true。可通过 `util.setShow(model, bool)` 动态控制 */
+    show?: boolean;
+    /** 字段初始值，不传则默认为 null */
     defaultValue?: Exclude<ComponentAttrValue, ComponentAttrHandler>;
-    /** 验证触发时机 */
+    /** 校验触发时机（仅当 Arco 组件支持时有效） */
     validateTrigger?: 'change' | 'input' | 'focus' | 'blur';
-    /** 组件原生属性配置 */
+    /**
+     * 组件原型属性透传
+     * @description 透传到 Arco 组件或自定义组件的 props
+     * @note
+     * - 值可以是静态值，也可以是一个函数 `(util, index?) => value`，函数会在渲染时执行
+     * - 当 `type` 为 Arco 字符串时，可传 Arco 组件对应的 props：
+     *   - `'a-input'` → `maxLength`, `showWordLimit`, `allowClear` 等
+     *   - `'a-select'` → `options`, `allowSearch`, `multiple`, `maxTagCount` 等
+     *   - `'a-date-picker'` → `format`, `showTime`, `disabledDate` 等
+     *   - `'a-input-number'` → `min`, `max`, `precision`, `step` 等
+     *   - `'a-switch'` → `checkedValue`, `uncheckedValue` 等
+     *   - `'a-radio-group'` → `options`, `direction` 等
+     *   - `'a-textarea'` → `maxLength`, `showWordLimit`, `autoSize` 等
+     *   - `'a-tree-select'` → `treeData`, `allowSearch`, `treeCheckable` 等
+     * @example
+     * ```ts
+     * // 静态值
+     * componentAttr: { min: 0, max: 100 }
+     * // 函数值（渲染时执行）
+     * componentAttr: { disabled: (util) => util.getModel('type') === 'readonly' }
+     * ```
+     */
     componentAttr?: Record<string, ComponentAttrValue>;
     /**
-     * 表单项容器属性
-     * @see FormItemInstance 查看可用属性
+     * Arco FormItem 容器属性透传
+     * @description 对应 FormItem 组件的 props，如 `labelColFlex`, `rules`, `disabled`, `help`, `extra` 等
+     * @see https://arco.design/vue/component/form#API
      */
     itemAttr?: FormItemInstance['$props'];
     /**
-     * 自定义类名配置
-     * @description 支持响应式配置函数
-     * @param itemConfig - 当前表单项配置
-     * @param models - 表单数据模型
+     * 自定义行 class
+     * @description 支持静态字符串或动态函数
+     * @example
+     * ```ts
+     * customClass: 'my-field'
+     * customClass: (item, models) => models.age > 18 ? 'adult' : 'minor'
+     * ```
      */
     customClass?: string | ((itemConfig: OrcFormItem, models: RecordAny_3) => string);
     /**
-     * 多值序列化配置
-     * @description 开启后自动将数组转换为逗号分隔字符串
-     * @note 需要组件原生支持多选模式 (需同时配置 componentAttr.multiple)
+     * 多值逗号序列化
+     * @description 开启后自动将 `string[]` 序列化为逗号分隔字符串存储，读取时反序列化为数组
+     * @note 组件需支持多选（如 `a-select` 需配置 `componentAttr: { multiple: true }`）
      */
     dotNotation?: boolean;
-    /** 数据字典系统编码 */
+    /** 数据字典编码（配合 OrcPinia 字典 store 使用） */
     datadict?: string;
-    /** 字段级配置选项 */
+    /** 字段级配置 */
     options?: {
-        /** 必填标识 */
+        /** 必填标识（显示红色星号） */
         required?: boolean;
-        /** 栅格布局宽度 (基于24栅格系统) */
+        /** 栅格宽度（基于 24 栅格） */
         span?: number;
         /** 栅格偏移量 */
         offset?: number;
-        /** 禁用状态 */
+        /** 禁用 */
         disabled?: boolean;
-        /** 输入占位符 */
+        /** 占位文本 */
         placeholder?: string;
-        /** 帮助说明文案 */
+        /** 帮助说明（显示在表单项下方） */
         help?: string;
-        /** 悬浮提示内容 */
+        /** tooltip 提示 */
         tooltip?: string;
-        /** 选择器选项列表 */
+        /** 选择器数据源（仅对 select / radio-group 等选择类组件有效） */
         options?: SelectOptionData[];
     };
     /**
-     * 验证规则配置
-     * @description 支持静态配置或动态规则生成函数
+     * 校验规则
+     * @description 支持 Arco Form 校验规则数组，或返回规则数组的函数
+     * @example
+     * ```ts
+     * rules: [{ required: true, message: '必填' }]
+     * rules: (item, util) => [{ required: true, message: '请选择' }]
+     * ```
      */
     rules?: RecordAny_3[] | ((val: OrcFormItem, util: OrcFormUtil) => RecordAny_3[]);
-    /** 表单事件处理器 */
-    events?: Pick<OrcFormUtil, 'onMounted' | 'onChange'>;
-    /** 扩展说明字段 */
+    /**
+     * 字段事件
+     * @description
+     * - `onMounted`: 组件挂载时触发，可用于异步加载选项
+     * - `onChange`: 值变化时触发，可用于联动、清空等
+     * @example
+     * ```ts
+     * events: {
+     *   async onMounted(util) {
+     *     // 异步加载下拉选项
+     *     const res = await fetchOptions();
+     *     util.setModelOption(util.model, res);
+     *   },
+     *   onChange(val, util) {
+     *     // radio 切换联动
+     *     const isTypeA = util.getModel(util.model) === 'A';
+     *     util.setShow('fieldX', isTypeA);
+     *     util.setShow('fieldY', !isTypeA);
+     *   },
+     * }
+     * ```
+     */
+    events?: {
+        onMounted?: (util: OrcFormUtilBind) => any | Promise<any>;
+        onChange?: (val: any, util: OrcFormUtilBind) => void | Promise<void>;
+    };
+    /** 内部备注字段 */
     note?: string;
 };
 
@@ -1077,64 +747,93 @@ export declare const OrcFormSpace: __VLS_WithTemplateSlots_7< DefineComponent<{}
 }>;
 
 /**
- * 表单提交数据结构
+ * 表单提交事件数据结构
+ * @description OrcForm 的 `@submit` 事件回调参数
+ * @example
+ * ```ts
+ * @submit="({ data, utils }) => {
+ *   utils.setLoading(true);
+ *   await save(data);
+ *   utils.setLoading(false);
+ *   utils.setVisible(false);
+ * }"
+ * ```
  */
 export declare type OrcFormSubmit = {
-    /** 表单数据集合 */
+    /** 表单数据 */
     data: RecordAny_3;
-    /** 表单工具方法 */
+    /** 表单工具 */
     utils: {
-        /** 控制提交弹窗可见性 */
-        setVisible: (a: boolean) => void;
-        /** 控制加载状态 */
-        setLoading: (a: boolean) => void;
+        /** 关闭弹窗（弹窗表单模式下有效） */
+        setVisible: (visible: boolean) => void;
+        /** 设置加载状态，submit 按钮显示 loading */
+        setLoading: (loading: boolean) => void;
     };
 };
 
 export declare const OrcFormTable: Component<any, any, any, ComputedOptions, MethodOptions, {}, any>;
 
+/**
+ * 表单工具方法集合
+ * @description 通过 OrcForm 的 slot 或 OrcFormItem events 回调中获取
+ */
 declare type OrcFormUtil = {
     /**
-     * 获取/查询选项数据
-     * @overload@overload 获取指定模型的选项列表
-     * @param model - 模型标识符
+     * 获取已注册的选择器选项列表
+     * @param model - 字段 model
      */
     getModelOption(model: string): SelectOptionData[];
     /**
-     * @overload@overload 根据值查找特定选项
-     * @param model - 模型标识符
-     * @param val - 要查找的选项值
-     * @returns 匹配的选项对象
+     * 根据值查找选项
+     * @param model - 字段 model
+     * @param val - 要查找的 value
      */
     getModelOption(model: string, val: string): SelectOptionData;
-    /** 读取所有内容 */
-    getModels: () => any;
-    /** 获取指定模型的值 */
+    /** 获取表单所有字段的当前值 */
+    getModels: () => RecordAny_3;
+    /** 获取指定字段的当前值 */
     getModel: (model: string) => any;
-    /** 检查指定模型是否可见 */
+    /** 检查指定字段是否可见 */
     getShow: (model: string) => boolean;
-    /** 设置指定模型的选项数据 */
-    setModelOption: (model: string, val: any) => void;
+    /** 动态更新指定字段的选择器选项 */
+    setModelOption: (model: string, val: SelectOptionData[]) => void;
+    /**
+     * 设置字段值
+     * @param model - 字段 model，或 `{ key: value }` 批量设置对象
+     * @param value - 当 model 为字符串时的值
+     * @example
+     * ```ts
+     * util.setModel('name', '张三')
+     * util.setModel({ name: '张三', age: 18 })
+     * ```
+     */
+    setModel: (model: string | RecordAny_3, value?: any) => void;
     /**
-     * 设置模型值
-     * @param c - 模型键名或键值对对象
-     * @param v - 当第一个参数为键名时使用的值
+     * 控制字段的显示/隐藏
+     * @param model - 字段 model 或数组
+     * @param val - true 显示，false 隐藏
      */
-    setModel: (c: string | RecordAny_3, v?: any) => void;
-    /** 控制模型可见性 */
     setShow: (model: string | string[], val: boolean) => void;
-    /** 用于双向数据绑定的模型属性 */
+    /** 当前字段的 model 名（仅在 events 回调中可用） */
     model?: string;
-    /** 组件挂载后执行 */
+    /** 组件挂载时触发（仅当定义在 events 中时） */
     onMounted?: (util: OrcFormUtilBind) => any | Promise<any>;
-    /** 值改变时触发 */
+    /**
+     * 值变化时触发（仅当定义在 events 中时）
+     * @param val - 新值
+     * @param util - 表单工具
+     */
     onChange?: (val: any, util: OrcFormUtilBind) => void | Promise<void>;
 };
 
+/**
+ * OrcFormUtil 的绑定版
+ * @description 在 events 回调中获取，比 OrcFormUtil 多了 `model`（当前字段名）和 `getFormItem`（当前配置项）
+ */
 declare type OrcFormUtilBind = OrcFormUtil & {
     model: string;
     getFormItem: () => OrcFormItem;
-} & OrcFormItem['events'];
+};
 
 export declare const OrcHiddenView: __VLS_WithTemplateSlots_2< DefineComponent<ExtractPropTypes<__VLS_WithDefaults_2<__VLS_TypePropsToRuntimeProps_2<{
     isShow?: boolean | undefined;
@@ -1432,7 +1131,7 @@ export declare const OrcQuill: DefineComponent<ExtractPropTypes<{
         default: string;
     };
     toolbar: {
-        type: (ArrayConstructor | StringConstructor)[];
+        type: (StringConstructor | ArrayConstructor)[];
         default: string;
     };
 }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
@@ -1443,14 +1142,14 @@ export declare const OrcQuill: DefineComponent<ExtractPropTypes<{
         default: string;
     };
     toolbar: {
-        type: (ArrayConstructor | StringConstructor)[];
+        type: (StringConstructor | ArrayConstructor)[];
         default: string;
     };
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-    modelValue: string;
     toolbar: string | unknown[];
+    modelValue: string;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 export declare const OrcSearch: __VLS_WithTemplateSlots_4< DefineComponent<ExtractPropTypes<__VLS_WithDefaults_4<__VLS_TypePropsToRuntimeProps_4<{
@@ -1503,36 +1202,54 @@ export declare const OrcSearch: __VLS_WithTemplateSlots_4< DefineComponent<Extra
     default?(_: {}): any;
 }>;
 
+/**
+ * OrcSearch 搜索项配置
+ * @description 定义搜索栏每一维度的字段类型、默认值、选项数据
+ * @example
+ * ```ts
+ * { type: 'input',  name: 'name',   label: '名称' }
+ * { type: 'select', name: 'status', label: '状态', options: [{ label: '启用', value: '1' }] }
+ * { type: 'date',   name: 'range',  label: '日期范围', multiple: true }
+ * { type: 'number', name: 'num',    label: '数字', min: 0, max: 100 }
+ * ```
+ */
 export declare interface OrcSearchItem extends RecordAny {
-    /** input 类型 */
-    type?: string;
-    /** 同form [name] */
+    /**
+     * 搜索组件类型
+     * @description 支持以下类型：
+     * - `'input'` — 文本输入框
+     * - `'select'` — 下拉选择器（配合 `options` 传入选项列表）
+     * - `'date'` — 日期选择器（配合 `multiple: true` 可实现日期范围）
+     * - `'number'` — 数字输入框（配合 `min`/`max` 限制范围）
+     */
+    type?: 'input' | 'select' | 'date' | 'number' | string;
+    /** 字段名（对应提交数据的 key） */
     name: string;
-    /** 标签名称 */
+    /** 显示标签 */
     label: string;
-    /** 初始值 */
+    /** 初始值。`multiple: true` 时支持逗号分隔字符串如 `'2024-01,2024-12'` */
     defaultValue?: string | boolean | number | string[];
-    /** 默认是显示 */
+    /** 是否显示该搜索项，默认 true */
     show?: boolean;
-    /** type =number  最小值 */
+    /** 数字最小值（type=number） */
     min?: number;
-    /** type =number  最大值 */
+    /** 数字最大值（type=number） */
     max?: number;
-    /** type=select | type=date */
+    /** 是否开启多选/范围模式（type=select 或 type=date） */
     multiple?: boolean;
-    /** type=select */
+    /** 选择器选项列表（type=select） */
     options?: {
         label: string;
         value: string;
         disabled?: boolean;
     }[];
-    /** type=date */
+    /** 日期格式化（type=date），如 `'YYYY-MM-DD'` */
     format?: string;
-    /** type=date  */
+    /** 日期是否包含时间选择（type=date） */
     showTime?: boolean;
-    /** 必填 */
+    /** 是否必填 */
     required?: boolean;
-    /** 表单验证 */
+    /** 校验规则 */
     rules?: RecordAny | RecordAny[];
 }
 
@@ -1553,8 +1270,8 @@ export declare const OrcTable: __VLS_WithTemplateSlots_3< DefineComponent<Extrac
     getReserveSelection(): RecordAny_2[];
     clearSelection(): void;
     insertRow(record: RecordAny_2, row?: number | RecordAny_2 | undefined, isNext?: boolean | undefined): Promise<{
-        row: any;
-        rows: any;
+        row: RecordAny_2;
+        rows: RecordAny_2[];
     }>;
     removeRows(): void;
     validate(list?: RecordAny_2[] | undefined): Promise<[string, RecordAny_2[]]>;
@@ -1564,16 +1281,14 @@ export declare const OrcTable: __VLS_WithTemplateSlots_3< DefineComponent<Extrac
     setSelectionRow(row: any, bool?: boolean | undefined): void;
     loading: Ref<boolean, boolean>;
     setLoading: typeof setLoading;
-    /** 执行搜索 ,是否返回第一页 */
     dataInit(isFirst?: boolean | undefined): Promise<void>;
-    /** 加载数据 */
     loadData(list: any[]): void;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     "update:selectedKeys": (...args: any[]) => void;
     confirm: (...args: any[]) => void;
     change: (...args: any[]) => void;
-    cellClick: (...args: any[]) => void;
     onReset: (...args: any[]) => void;
+    cellClick: (...args: any[]) => void;
     cellDblclick: (...args: any[]) => void;
 }, string, PublicProps, Readonly< ExtractPropTypes<__VLS_WithDefaults_3<__VLS_TypePropsToRuntimeProps_3<Props_2>, {
     isHover: boolean;
@@ -1588,13 +1303,13 @@ export declare const OrcTable: __VLS_WithTemplateSlots_3< DefineComponent<Extrac
     "onUpdate:selectedKeys"?: ((...args: any[]) => any) | undefined;
     onConfirm?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
-    onCellClick?: ((...args: any[]) => any) | undefined;
     onOnReset?: ((...args: any[]) => any) | undefined;
+    onCellClick?: ((...args: any[]) => any) | undefined;
     onCellDblclick?: ((...args: any[]) => any) | undefined;
 }>, {
     data: RecordAny_2[];
     option: OrcTableOption;
-    size: "large" | "medium" | "small" | "mini";
+    size: "medium" | "large" | "small" | "mini";
     locale: I18nType;
     isHover: boolean;
     selectedKeys: string[];
@@ -1608,55 +1323,134 @@ export declare const OrcTable: __VLS_WithTemplateSlots_3< DefineComponent<Extrac
         rowIndex: number;
         columnIndex: number;
         value: any;
-        updateValue: (value: string | number | boolean | RecordAny_2 | null) => void;
+        updateValue: (newValue: any) => void;
         formatValue: any;
     }): any;
     footer?(_: {}): any;
 }>;
 
+/**
+ * 表格组件暴露方法
+ * @description `<orc-table ref="tableRef">` 可调用的方法
+ */
 declare interface OrcTableExpose extends TableGridTwoType {
+    /** 是否正在加载数据 */
     loading: boolean;
+    /** 手动设置加载状态 */
     setLoading: (loading?: boolean) => void;
-    /** 请求数据 */
-    dataInit: () => Promise<void>;
-    /** 重置表单数据 */
+    /** 请求服务端数据（如配置 url），可传 true 跳回第一页 */
+    dataInit: (isFirst?: boolean) => Promise<void>;
+    /** 加载静态数据并刷新表格 */
     loadData: (list: RecordAny_2[]) => void;
 }
 
-/**  column type */
+/**
+ * 表格列配置
+ * @description 定义每一列的数据映射、显示格式、编辑方式
+ */
 export declare interface OrcTableItem extends RecordAny_2 {
+    /** 是否显示该列，默认 true */
     show?: boolean;
+    /** 数据字段名（必填） */
     dataIndex: string;
+    /** 列标题 */
     title?: string;
+    /** 列宽度（像素） */
     width?: number;
+    /** 是否可排序 */
     sort?: boolean;
-    /** 开启编辑 */
-    cell?: boolean | Component;
-    /** @example
-     *   <a-badge status="normal" text="Normal" />
-     *  status: normal|processing|success|warning|danger
+    /**
+     * 单元格渲染模式
+     * @description
+     * - `true` — 开启行内编辑模式（配合 edit-render）
+     * - `Component` — 渲染为指定组件（如 Badge、Tag），配合 `cellAttr` 传参
+     * - `VNode` — 渲染为 VNode 内容
+     * @example
+     * ```ts
+     * // 行内编辑
+     * { cell: true }
+     * // 渲染为组件
+     * { cell: Badge, div: true, cellAttr: { text: (v) => v.value, status: (v) => 'success' } }
+     * // 渲染为 VNode
+     * { cell: h('div', '自定义内容') }
+     * ```
+     */
+    cell?: boolean | Component | VNode;
+    /**
+     * 组件属性（当 cell 为 Component 时使用）
+     * @description 每个 key 可以是静态值或函数，函数接收 `{ record, value, rowIndex, columnIndex, updateValue, formatValue }`
+     * @example
+     * ```ts
+     * { cell: Badge, div: true, cellAttr: {
+     *   text: ({ value }) => value ? '启用' : '禁用',
+     *   status: ({ value }) => value ? 'success' : 'normal',
+     * } }
+     * ```
      */
     cellAttr?: {
-        [key: string]: (v1: Record<'record' | 'dataIndex' | 'rowIndex' | 'columnIndex' | 'value' | 'updateValue' | 'formatValue', any>) => unknown;
+        [key: string]: (v1: {
+            record: RecordAny_2;
+            value: any;
+            rowIndex: number;
+            columnIndex: number;
+            updateValue: (val: any) => void;
+            formatValue: string;
+        }) => unknown;
     } | {
         [key: string]: unknown;
     };
+    /**
+     * 渲染模式（仅在 cell 为 Component 时有效）
+     * @description `true` 时在 `#default` 插槽渲染组件，而非仅在编辑模式下显示
+     */
     div?: boolean;
-    /** 没内容时候得提示 */
+    /** 空数据占位文本 */
     placeholder?: string;
+    /** 单元格文字超出是否以 tooltip 展示 */
     tooltip?: boolean;
+    /** 是否显示省略号 */
     ellipsis?: boolean;
+    /** 列对齐方式 */
     align?: VxeColumnPropTypes.Align;
+    /** 表头对齐方式 */
     headerAlign?: VxeColumnPropTypes.HeaderAlign;
+    /** 表尾对齐方式 */
     footerAlign?: VxeColumnPropTypes.FooterAlign;
+    /** 固定列方向 */
+    fixed?: 'left' | 'right';
+    /**
+     * 行数据格式化
+     * @param val 原始值
+     * @param record 整行数据
+     * @returns 格式化后的显示文本
+     */
     format?: (val: any, record?: RecordAny_2) => string;
+    /**
+     * 行内样式
+     * @description 支持静态对象或根据行数据动态返回
+     */
     style?: CssType | ((record: RecordAny_2) => CssType);
-    /** 同 :title-prefix "{ content: '必填', icon: 'vxe-cell--required-icon' }" */
+    /** 标题帮助提示（同 vxe-table title-prefix） */
     help?: VxeColumnPropTypes.TitlePrefix;
+    /** 列过滤条件列表 */
+    filters?: VxeColumnPropTypes.Filters;
+    /** 是否支持多选过滤 */
+    filterMultiple?: boolean;
+    /** 自定义过滤方法 */
+    filterMethod?: VxeColumnPropTypes.FilterMethod;
+    /** 数据类型 */
+    dataType?: 'link' | 'number' | 'date' | 'time' | 'string' | 'status';
+    /** orc-search 联动  */
+    search?: {
+        show?: boolean;
+        hidden?: boolean;
+        options?: RecordAny_2[];
+    } & RecordAny_2;
 }
 
 /**
- * table option type
+ * 表格配置项
+ * @description 传递给 `<orc-table :option>` 的完整配置
  * @example
  * ```ts
  * {
@@ -1664,88 +1458,133 @@ export declare interface OrcTableItem extends RecordAny_2 {
  *   scrollY: { enabled: true },
  *   columns: [
  *     { dataIndex: 'index', title: '序', width: 26 },
- *   ]
+ *   ],
+ *   selectedType: 'checkbox',
+ *   selectedTrigger: 'row',
  * }
  * ```
  */
 export declare interface OrcTableOption extends RecordAny_2 {
-    /** 可使用 `orc-provider` 全局注入 */
+    /**
+     * 异步请求封装函数
+     * @description 需通过 `orc-provider` 全局注入，或直接传入
+     */
     useErrData?: <T = RecordAny_2>(config: RecordAny_2) => Promise<[boolean, T]>;
-    /** 请求地址 */
+    /** 服务端分页请求地址，不传则使用静态数据 */
     url?: string;
-    /** 请求类型 */
+    /** 请求方法 */
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
-    /** 是否保留多选状态 */
+    /** 是否保留跨页多选状态 */
     reserve?: boolean;
-    /** 原 checkbox-config.checkField 在行中存储 bool 值,不存在则无效 */
+    /** 原 vxe-table checkbox-config.checkField，行中存储多选 bool 值的字段名 */
     checkKey?: string;
-    /** 行主键[自动生成] */
+    /**
+     * 行主键字段名
+     * @default '_X_ROW_KEY'
+     */
     rowKey?: string;
-    /** 多选时 同kay选择 */
+    /**
+     * 多选联动 key
+     * @description 有此值时，同一 key 的行会联动选中/取消
+     */
     checkboxKey?: string;
-    /** 自定义列  同 resolveColumns() */
+    /** 列配置 */
     columns: OrcTableItem[];
-    /** 默认分页条数 */
+    /** 默认每页条数 */
     pageSize?: number;
-    /** 默认分页列表 */
+    /** 每页条数选项列表 */
     pageSizeOptions?: number[];
-    /** 开启行选中 */
+    /** 行选中类型 */
     selectedType?: 'checkbox' | 'radio';
-    /** 触发方式 */
+    /** 选中触发方式 */
     selectedTrigger?: 'cell' | 'row' | 'default';
-    /** 行必填数据 指定 [dataIndex] */
+    /** 行必填字段名列表（用于行校验高亮） */
     requiredKeys?: string[];
-    /** 表单组件第一次自动请求接口 */
+    /** 首次自动请求数据（url 模式），默认 true */
     firstLoad?: boolean;
-    /** 原来 show-overflow  ellipsis（只显示省略号）, title（并且显示为原生 title）, tooltip（并且显示为 tooltip 提示） */
+    /**
+     * 单元格溢出行为
+     * @description 'ellipsis' — 省略号，'title' — 原生 title，'tooltip' — tooltip 提示
+     */
     tooltip?: ('ellipsis' | 'title' | 'tooltip') | boolean;
-    /** 原来 show-footer-overflow  ellipsis（只显示省略号）, title（并且显示为原生 title）, tooltip（并且显示为 tooltip 提示） */
+    /** 表尾单元格溢出行为，同 tooltip 参数 */
     footerTooltip?: ('ellipsis' | 'title' | 'tooltip') | boolean;
-    /** 给表头单元添加 style : ({ column, columnIndex })=> {} , dataIndex as column.property  */
-    headerStyle?: (record: RecordAny_2 & {
+    /**
+     * 表头样式
+     * @param record - 包含 `{ column, columnIndex }`，dataIndex 在 column.property 中
+     */
+    headerStyle?: (record: {
         column: {
             property: string;
         } & RecordAny_2;
+        columnIndex: number;
     }) => CssType;
-    /** 给表尾单元添加 style : any | (({ $rowIndex, column, columnIndex, $columnIndex }) => any) */
-    footerStyle?: (record: RecordAny_2 & {
+    /**
+     * 表尾样式
+     * @param record - 包含 `{ $rowIndex, column, columnIndex, $columnIndex }`
+     */
+    footerStyle?: (record: {
+        $rowIndex: number;
         column: {
             property: string;
         } & RecordAny_2;
+        columnIndex: number;
+        $columnIndex: number;
     }) => CssType;
-    /** 表尾的数据获取方法，返回一个二维数组  (columns, data) => string[][] */
+    /**
+     * 表尾合计方法
+     * @returns 二维数组，外层对应表尾行，内层对应每列
+     * @see useOrcTableFooter 快速使用
+     */
     footerMethod?: VxeTablePropTypes.FooterMethod;
-    /** 同 merge-footer-items 临时合并表尾 (不能用于展开行，不建议用于固定列、树形结构) */
+    /** 表尾合并配置（不能与展开行、固定列、树形结构同时使用） */
     mergeFooter?: VxeTablePropTypes.MergeFooterItems;
-    /** 自定义列  同 columns */
+    /** 列预处理函数，在 columns 渲染前执行 */
     resolveColumns?: (columns?: OrcTableItem[]) => OrcTableItem[];
-    /** 计算总条目 */
+    /** 计算总条目数（服务端分页） */
     resolveTotal?: (e: RecordAny_2) => number;
-    /** 请求超时时间 */
+    /** 请求超时时间（毫秒） */
     timeout?: number;
-    /** 静态参数 */
+    /** 固定请求参数，会与分页参数合并发送 */
     data?: RecordAny_2;
-    /** 自定义分页 */
-    resolvePage?: (page?: RecordAny_2) => any;
-    /** 自定义数据 */
+    /**
+     * 自定义分页参数
+     * @param page - `{ page, size }` 分页信息，可扩展额外参数
+     * @returns 发送到接口的分页参数对象
+     */
+    resolvePage?: (page: RecordAny_2) => any;
+    /**
+     * 解析接口返回的数据列表
+     * @param data - 接口原始返回值
+     * @param page - `{ page, size }` 当前分页信息
+     * @returns 表格行数据数组
+     */
     resolveData?: (data: RecordAny_2, page?: RecordAny_2) => RecordAny_2[];
-    /** 数据请求成功 */
+    /** 数据请求成功回调 */
     success?: (data?: any) => void;
-    /** 数据请求失败 */
+    /** 数据请求失败回调 */
     error?: (data?: any) => void;
-    /** 开启重复行省略 group by  */
+    /**
+     * 皮肤行分组字段
+     * @description 相同值的行合并显示，开启后重复行隐藏相同内容
+     */
     skinRow?: string;
-    /** 非重复行且未被跳过的样式 */
+    /** 皮肤行样式（非重复行且未被跳过时应用） */
     skinRowStyle?: CssType;
-    /** 重复行显示内容 */
+    /** 被隐藏的重复行显示文字 */
     skinRowText?: string;
-    /** 同 edit-rules , demo :  {  sex: [ { required: true, message: '性别必须填写' } ] } */
+    /**
+     * 行编辑校验规则
+     * @example { sex: [{ required: true, message: '性别必须填写' }] }
+     */
     rules?: VxeTablePropTypes.EditRules;
-    /** 横向虚拟滚动配置  { enabled, gt }  */
+    /** 横向虚拟滚动 */
     scrollX?: VxeTablePropTypes.ScrollX;
-    /** 纵向虚拟滚动配置  { enabled, gt }  */
+    /** 纵向虚拟滚动 */
     scrollY?: VxeTablePropTypes.ScrollY;
+    /** 选中模式附加属性 */
     selectedProps?: any;
+    /** 透传 vxe-table 原生 props */
     tableProps?: TableInstance['$props'];
 }
 
@@ -1754,33 +1593,17 @@ declare interface Props {
 }
 
 declare type Props_2 = {
-    /** 表格标题 */
     title?: string;
-    /** 高 */
     height?: number | string;
-    /** 多语言 */
     locale?: I18nType;
-    /** 是否隐藏工具栏 */
     hideToolbar?: boolean;
-    /** 是否隐藏设置按钮 */
     hideSetting?: boolean;
-    /** 是否隐藏分页 */
     hidePagination?: boolean;
-    /** 是否启用悬停效果，默认值为 true */
     isHover?: boolean;
-    /** 表格尺寸，可选值为 'medium' | 'small' | 'mini'，默认值为 'mini' */
     size?: 'large' | 'medium' | 'small' | 'mini';
-    /** 用户选择的列表，默认值为空数组 */
     selectedKeys?: string[];
-    /** 数据源，默认值为空数组 */
     data?: RecordAny_2[];
-    /** 配置文件，默认值为 { columns: [] } */
     option?: OrcTableOption;
-    /**
-     * 用户保存数据钩子函数
-     * - getColumn: 异步获取列配置，返回一个包含布尔值和列数据的元组
-     * - setColumn: 设置列配置
-     */
     hook?: {
         getColumn: () => Promise<[boolean, RecordAny_2[]]>;
         setColumn: (list: RecordAny_2[]) => void;
@@ -1839,6 +1662,8 @@ declare type RecordAny_2 = Record<string, any>;
 /** 通用对象类型 (键值对形式) */
 declare type RecordAny_3 = Record<string, any>;
 
+declare function resetFields(): void;
+
 /**
  *  set path object
  * @example
@@ -1852,47 +1677,61 @@ export declare function setData(object: RecordAny, path: string, defaultValue?:
 
 declare function setLoading(val?: boolean): void;
 
-declare interface TableGridTwoType extends RecordAny_2 {
-    /** 读取配置的rowKey 默认 _X_ROW_KEY  */
+/**
+ * 表格工具方法
+ * @description 通过 `useOrcTable()` 返回的 `tableUtils` 或 `tableRef` 暴露的方法
+ */
+declare interface TableGridTwoType {
+    /** 读取配置的 rowKey，默认 `_X_ROW_KEY` */
     getRowKey(): string;
-    /** 读取当前页数据 */
+    /** 读取当前页全部数据 */
     getTableData(): RecordAny_2[];
-    /** 读取选中行 */
+    /** 读取当前选中的行数据 */
     getSelection(): RecordAny_2[];
-    /** 不支持夸行选择，可读取rowKey重复的数据 */
+    /**
+     * 按 checkboxKey 获取选中行
+     * @param keys - 要匹配的 key 列表，默认当前选中行
+     */
     getCheckboxKeySelection(keys?: string[]): RecordAny_2[];
-    /** option.reserve = true  读取所有跨页选中数据 */
+    /** 读取跨页选中数据（需开启 `option.reserve`） */
     getReserveSelection(): RecordAny_2[];
-    /** 清空选中行 */
+    /** 清空所有选中行 */
     clearSelection(): void;
-    /** 原insertAt 往表格插入临时数据，从指定位置插入一行或多行；第二个参数：row 指定( isNext +1 )位置、null从第一行插入、-1 从最后插入  */
+    /**
+     * 插入一行数据
+     * @param record - 行数据
+     * @param row - 插入位置参照行（number 为索引、目标行对象、null 为首行、-1 为末尾）
+     * @param isNext - 是否插入在参照行之后（仅当 row 为对象时有效）
+     * @returns 插入结果 `{ row, rows }`
+     */
     insertRow(record: RecordAny_2, row?: RecordAny_2 | number, isNext?: boolean): Promise<{
-        row: any;
-        rows: any;
+        row: RecordAny_2;
+        rows: RecordAny_2[];
     }>;
-    /** 删除复选框选中的行数据 */
+    /** 删除 Checkbox 选中的行 */
     removeRows(): void;
     /**
      * 选中行数据校验
-     * @param list  默认 所有选择的数据
+     * @param list - 默认校验当前所有选中行
+     * @returns `[errMsg, validatedList]` — 空字符串表示无错误
      */
     validate(list?: RecordAny_2[]): Promise<[string, RecordAny_2[]]>;
     /**
-     * 根据 row 获取行的序号
-     * @param row 行对象
+     * 根据 row 获取行序号（从 1 开始）
+     * @param row - 行对象
      */
     getRowSeq(row: any): string | number;
     /**
-     * 根据 row 获取相对于 data 中的索引
-     * @param row 行对象
+     * 根据 row 获取行索引（从 0 开始）
+     * @param row - 行对象
      */
     getRowIndex(row: any): number;
-    /**
-     * 删除RowIndex这一行
-     */
+    /** 删除指定索引的行 */
     removerRowIndex(rowIndex: number): void;
     /**
-     * 选择当前行
+     * 选中/取消选中指定行
+     * @param row - 行对象
+     * @param bool - true 选中，false 取消
      */
     setSelectionRow(row: any, bool?: boolean): void;
 }
@@ -1905,6 +1744,41 @@ export declare function toArray<T>(target: T | T[]): T[];
 /** 读取数据类型 */
 export declare function typeName(o: unknown): string;
 
+/**
+ * 字典缓存 Store
+ *
+ * @example
+ * // 1. 初始化（在 main.ts 或 App.vue 中执行一次）
+ * const dictStore = useDictStore();
+ * dictStore.registerLoadFn(async (code) => {
+ *   const res = await fetch(`/api/dict/${code}`);
+ *   return res.json();
+ * });
+ *
+ * @example
+ * // 2. 在组件中使用
+ * const dictStore = useDictStore();
+ * const genders = await dictStore.getDict('gender');
+ * const freshData = await dictStore.getDict('gender', true); // 强制刷新
+ * dictStore.clearCache('gender'); // 清除缓存
+ */
+export declare const useDictStore: StoreDefinition<"orc-dict", Pick<{
+    dicts: Ref<Record<string, unknown[]>, Record<string, unknown[]>>;
+    registerLoadFn: (fn: DictLoadFn) => void;
+    getDict: <T = unknown[]>(code: string, force?: boolean) => Promise<T>;
+    clearCache: (code?: string) => void;
+}, "dicts">, Pick<{
+    dicts: Ref<Record<string, unknown[]>, Record<string, unknown[]>>;
+    registerLoadFn: (fn: DictLoadFn) => void;
+    getDict: <T = unknown[]>(code: string, force?: boolean) => Promise<T>;
+    clearCache: (code?: string) => void;
+}, never>, Pick<{
+    dicts: Ref<Record<string, unknown[]>, Record<string, unknown[]>>;
+    registerLoadFn: (fn: DictLoadFn) => void;
+    getDict: <T = unknown[]>(code: string, force?: boolean) => Promise<T>;
+    clearCache: (code?: string) => void;
+}, "registerLoadFn" | "getDict" | "clearCache">>;
+
 /**
  * @example
  * ```
@@ -1966,10 +1840,9 @@ export declare function useOrcSearch(initialList: OrcSearchItem[] | (() => OrcSe
 
 export declare const useOrcTable: (option: OrcTableOption) => {
     tableRef: Ref<{
-        [x: string]: any;
         loading: boolean;
         setLoading: (loading?: boolean | undefined) => void;
-        dataInit: () => Promise<void>;
+        dataInit: (isFirst?: boolean | undefined) => Promise<void>;
         loadData: (list: RecordAny_2[]) => void;
         getRowKey: () => string;
         getTableData: () => RecordAny_2[];
@@ -1978,8 +1851,8 @@ export declare const useOrcTable: (option: OrcTableOption) => {
         getReserveSelection: () => RecordAny_2[];
         clearSelection: () => void;
         insertRow: (record: RecordAny_2, row?: number | RecordAny_2 | undefined, isNext?: boolean | undefined) => Promise<{
-            row: any;
-            rows: any;
+            row: RecordAny_2;
+            rows: RecordAny_2[];
         }>;
         removeRows: () => void;
         validate: (list?: RecordAny_2[] | undefined) => Promise<[string, RecordAny_2[]]>;
@@ -1988,10 +1861,9 @@ export declare const useOrcTable: (option: OrcTableOption) => {
         removerRowIndex: (rowIndex: number) => void;
         setSelectionRow: (row: any, bool?: boolean | undefined) => void;
     }, OrcTableExpose | {
-        [x: string]: any;
         loading: boolean;
         setLoading: (loading?: boolean | undefined) => void;
-        dataInit: () => Promise<void>;
+        dataInit: (isFirst?: boolean | undefined) => Promise<void>;
         loadData: (list: RecordAny_2[]) => void;
         getRowKey: () => string;
         getTableData: () => RecordAny_2[];
@@ -2000,8 +1872,8 @@ export declare const useOrcTable: (option: OrcTableOption) => {
         getReserveSelection: () => RecordAny_2[];
         clearSelection: () => void;
         insertRow: (record: RecordAny_2, row?: number | RecordAny_2 | undefined, isNext?: boolean | undefined) => Promise<{
-            row: any;
-            rows: any;
+            row: RecordAny_2;
+            rows: RecordAny_2[];
         }>;
         removeRows: () => void;
         validate: (list?: RecordAny_2[] | undefined) => Promise<[string, RecordAny_2[]]>;
@@ -2028,15 +1900,19 @@ export declare const useOrcTable: (option: OrcTableOption) => {
         firstLoad?: boolean | undefined;
         tooltip?: boolean | "title" | "tooltip" | "ellipsis" | undefined;
         footerTooltip?: boolean | "title" | "tooltip" | "ellipsis" | undefined;
-        headerStyle?: ((record: RecordAny_2 & {
+        headerStyle?: ((record: {
             column: {
                 property: string;
             } & RecordAny_2;
+            columnIndex: number;
         }) => CssType) | undefined;
-        footerStyle?: ((record: RecordAny_2 & {
+        footerStyle?: ((record: {
+            $rowIndex: number;
             column: {
                 property: string;
             } & RecordAny_2;
+            columnIndex: number;
+            $columnIndex: number;
         }) => CssType) | undefined;
         footerMethod?: VxeTablePropTypes<VxeTableDataRow> | undefined;
         mergeFooter?: VxeTablePropTypes<VxeTableDataRow> | undefined;
@@ -2044,7 +1920,7 @@ export declare const useOrcTable: (option: OrcTableOption) => {
         resolveTotal?: ((e: RecordAny_2) => number) | undefined;
         timeout?: number | undefined;
         data?: RecordAny_2 | undefined;
-        resolvePage?: ((page?: RecordAny_2 | undefined) => any) | undefined;
+        resolvePage?: ((page: RecordAny_2) => any) | undefined;
         resolveData?: ((data: RecordAny_2, page?: RecordAny_2 | undefined) => RecordAny_2[]) | undefined;
         success?: ((data?: any) => void) | undefined;
         error?: ((data?: any) => void) | undefined;
@@ -2065,8 +1941,8 @@ export declare const useOrcTable: (option: OrcTableOption) => {
         getReserveSelection(): RecordAny_2[];
         clearSelection(): void;
         insertRow(record: RecordAny_2, row?: number | RecordAny_2 | undefined, isNext?: boolean | undefined): Promise<{
-            row: any;
-            rows: any;
+            row: RecordAny_2;
+            rows: RecordAny_2[];
         }>;
         removeRows(): void;
         validate(list?: RecordAny_2[] | undefined): Promise<[string, RecordAny_2[]]>;