knt-shared 1.0.0

package/README.md

@@ -0,0 +1,259 @@
+# knt-shared
+
+KNT共享组件库和工具函数（基于 Vue3 + @arco-design/web-vue）
+
+参考 [Vben Admin](https://doc.vvbin.cn/components/introduction.html) 的设计思路实现
+
+## 安装
+
+```bash
+npm install knt-shared
+```
+
+## 使用
+
+### Description 详情组件
+
+```vue
+<template>
+  <Description
+    title="用户信息"
+    :items="descriptionItems"
+    :column="3"
+    bordered
+  />
+</template>
+
+<script setup lang="ts">
+import { Description } from 'knt-shared';
+import type { DescriptionItem } from 'knt-shared';
+
+const descriptionItems: DescriptionItem[] = [
+  { label: '姓名', value: '张三' },
+  { label: '年龄', value: 28 },
+  { label: '邮箱', value: 'zhangsan@example.com' },
+  { label: '地址', value: '北京市朝阳区', span: 2 },
+];
+</script>
+```
+
+### Form 表单组件
+
+```vue
+<template>
+  <Form
+    ref="formRef"
+    :model="formData"
+    :rules="rules"
+    @submit="handleSubmit"
+  >
+    <a-form-item field="name" label="姓名">
+      <a-input v-model="formData.name" placeholder="请输入姓名" />
+    </a-form-item>
+    <a-form-item field="email" label="邮箱">
+      <a-input v-model="formData.email" placeholder="请输入邮箱" />
+    </a-form-item>
+    <a-form-item>
+      <a-button type="primary" html-type="submit">提交</a-button>
+      <a-button @click="handleReset">重置</a-button>
+    </a-form-item>
+  </Form>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Form } from 'knt-shared';
+
+const formRef = ref();
+const formData = ref({
+  name: '',
+  email: '',
+});
+
+const rules = {
+  name: [{ required: true, message: '请输入姓名' }],
+  email: [
+    { required: true, message: '请输入邮箱' },
+    { type: 'email', message: '邮箱格式不正确' },
+  ],
+};
+
+const handleSubmit = (values: Record<string, any>) => {
+  console.log('提交数据:', values);
+};
+
+const handleReset = () => {
+  formRef.value?.resetFields();
+};
+</script>
+```
+
+### Table 表格组件
+
+```vue
+<template>
+  <Table
+    ref="tableRef"
+    :columns="columns"
+    :data="tableData"
+    :loading="loading"
+    :pagination="{ pageSize: 10 }"
+    @page-change="handlePageChange"
+  />
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Table } from 'knt-shared';
+import type { TableColumnData } from '@arco-design/web-vue';
+
+const tableRef = ref();
+const loading = ref(false);
+const tableData = ref([
+  { id: 1, name: '张三', age: 25, email: 'zhangsan@example.com' },
+  { id: 2, name: '李四', age: 30, email: 'lisi@example.com' },
+]);
+
+const columns: TableColumnData[] = [
+  { title: '姓名', dataIndex: 'name' },
+  { title: '年龄', dataIndex: 'age' },
+  { title: '邮箱', dataIndex: 'email' },
+];
+
+const handlePageChange = (page: number) => {
+  console.log('页码变化:', page);
+  // 加载数据
+};
+
+// 使用 request 属性自动加载数据
+const tableWithRequest = {
+  columns,
+  request: async (params: Record<string, any>) => {
+    // 调用 API
+    const response = await fetchData(params);
+    return {
+      data: response.list,
+      total: response.total,
+    };
+  },
+};
+</script>
+```
+
+### Modal 模态框组件
+
+```vue
+<template>
+  <div>
+    <a-button @click="openModal">打开模态框</a-button>
+    <Modal
+      v-model:visible="visible"
+      title="编辑信息"
+      @ok="handleOk"
+      @cancel="handleCancel"
+    >
+      <a-form :model="formData">
+        <a-form-item label="姓名">
+          <a-input v-model="formData.name" />
+        </a-form-item>
+      </a-form>
+    </Modal>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Modal } from 'knt-shared';
+
+const visible = ref(false);
+const formData = ref({ name: '' });
+
+const openModal = () => {
+  visible.value = true;
+};
+
+const handleOk = () => {
+  console.log('确定', formData.value);
+  visible.value = false;
+};
+
+const handleCancel = () => {
+  console.log('取消');
+};
+
+// 使用 ref 控制模态框
+const modalRef = ref();
+modalRef.value?.open(); // 打开
+modalRef.value?.close(); // 关闭
+</script>
+```
+
+### 工具函数
+
+```ts
+import { formatDate, formatNumber, isValidEmail } from 'knt-shared';
+
+// 格式化日期
+const dateStr = formatDate(new Date(), 'YYYY-MM-DD');
+
+// 格式化数字
+const numStr = formatNumber(1234567); // "1,234,567"
+
+// 验证邮箱
+const isValid = isValidEmail('test@example.com');
+```
+
+### Hooks (Composition API)
+
+```vue
+<template>
+  <div>
+    <input v-model="inputValue" />
+    <p>防抖值: {{ debouncedValue }}</p>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue';
+import { useDebounce, useLocalStorage, useToggle } from 'knt-shared';
+
+const inputValue = ref('');
+const debouncedValue = useDebounce(inputValue, 500);
+
+const [stored, setStored] = useLocalStorage('key', 'default');
+
+const [isOpen, toggle, open, close] = useToggle(false);
+</script>
+```
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 开发模式（监听文件变化）
+npm run dev
+```
+
+## Playground 测试环境
+
+项目包含一个 playground 目录，用于测试和演示组件：
+
+```bash
+cd playground
+npm install
+npm run dev
+```
+
+访问 http://localhost:3000 查看所有组件的测试和演示。
+
+## 发布
+
+```bash
+npm publish
+```
+

package/dist/components/Form/BasicForm.vue.d.ts

@@ -0,0 +1,117 @@
+import { FormSchema, BasicFormProps } from './types';
+
+declare function __VLS_template(): {
+    actions?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BasicFormProps>, {
+    schemas: () => never[];
+    layout: string;
+    labelAlign: string;
+    autoSetPlaceHolder: boolean;
+    showSubmitButton: boolean;
+    showResetButton: boolean;
+    submitButtonText: string;
+    resetButtonText: string;
+    showActionButtons: boolean;
+    disabled: boolean;
+    baseColProps: () => {
+        span: number;
+    };
+    actionColOptions: () => {
+        span: number;
+    };
+}>>, {
+    formRef: import('vue').Ref<any, any>;
+    formModel: Record<string, any>;
+    handleSubmit: (values: Record<string, any>) => Promise<void>;
+    getVisibleSchemas: () => FormSchema[];
+    getColProps: (schema: FormSchema) => Record<string, any>;
+    getFormItemBindValue: (schema: FormSchema) => {
+        field: string;
+        label: string;
+        labelColProps: Record<string, any> | undefined;
+        wrapperColProps: Record<string, any> | undefined;
+        rules: any[] | undefined;
+        disabled: boolean | undefined;
+        help: string | undefined;
+        extra: string | undefined;
+        required: boolean | undefined;
+    };
+    getPlaceholderText: (schema: FormSchema) => any;
+    getFieldsValue: () => Record<string, any>;
+    setFieldsValue: (values: Record<string, any>) => void;
+    resetFields: () => void;
+    validate: () => Promise<any>;
+    clearValidate: (field?: string | string[]) => void;
+    updateSchema: (schema: Partial<FormSchema> | Partial<FormSchema>[]) => void;
+    removeSchema: (field: string | string[]) => void;
+    getSchema: (field?: string) => FormSchema | FormSchema[] | undefined;
+    resetSchema: (schemas: FormSchema[]) => void;
+    setProps: (formProps: Partial<BasicFormProps>) => void;
+    scrollToField: (name: string, options?: ScrollIntoViewOptions) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    register: (formInstance: any) => void;
+    submit: (values: Record<string, any>) => void;
+    reset: () => void;
+    validate: (field: string, valid: boolean, message: string) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BasicFormProps>, {
+    schemas: () => never[];
+    layout: string;
+    labelAlign: string;
+    autoSetPlaceHolder: boolean;
+    showSubmitButton: boolean;
+    showResetButton: boolean;
+    submitButtonText: string;
+    resetButtonText: string;
+    showActionButtons: boolean;
+    disabled: boolean;
+    baseColProps: () => {
+        span: number;
+    };
+    actionColOptions: () => {
+        span: number;
+    };
+}>>> & Readonly<{
+    onRegister?: ((formInstance: any) => any) | undefined;
+    onSubmit?: ((values: Record<string, any>) => any) | undefined;
+    onReset?: (() => any) | undefined;
+    onValidate?: ((field: string, valid: boolean, message: string) => any) | undefined;
+}>, {
+    disabled: boolean;
+    schemas: FormSchema[];
+    layout: "horizontal" | "vertical" | "inline";
+    labelAlign: "left" | "right";
+    baseColProps: Record<string, any>;
+    actionColOptions: Record<string, any>;
+    autoSetPlaceHolder: boolean;
+    showSubmitButton: boolean;
+    showResetButton: boolean;
+    submitButtonText: string;
+    resetButtonText: string;
+    showActionButtons: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=BasicForm.vue.d.ts.map

package/dist/components/Form/BasicForm.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicForm.vue.d.ts","sourceRoot":"","sources":["../../../src/components/Form/BasicForm.vue"],"names":[],"mappings":"AAyDA;AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAkB,MAAM,SAAS,CAAC;AAuW1E,iBAAS,cAAc;qBA+MO,GAAG;EAGhC;AAsBD,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;2BA7be,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;0BApD1B,UAAU;mCAMD,UAAU;;;;;;;;;;;iCA2BZ,UAAU;0BAsCnB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;6BAKd,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;4BAmBpB,MAAM,GAAG,MAAM,EAAE;2BAKlB,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,EAAE;0BAW5C,MAAM,GAAG,MAAM,EAAE;wBAYnB,MAAM,KAAG,UAAU,GAAG,UAAU,EAAE,GAAG,SAAS;2BAO3C,UAAU,EAAE;0BAMb,OAAO,CAAC,cAAc,CAAC;0BAYvB,MAAM,YAAY,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAqWlE,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAAvG,wBAAwG;AACxG,KAAK,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;AACjE,KAAK,6BAA6B,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE;CAAE,CAAC;AAC9M,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI;KAE1B,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QACxE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;KACb,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AACN,KAAK,cAAc,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC;AACxD,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAAE,QAAO;QAClD,MAAM,EAAE,CAAC,CAAC;KACT,CAAA;CAAE,CAAC"}

package/dist/components/Form/componentMap.d.ts

@@ -0,0 +1,39 @@
+import { Component } from 'vue';
+
+/**
+ * 组件类型映射
+ */
+export type ComponentType = 'Input' | 'InputNumber' | 'InputPassword' | 'Textarea' | 'Select' | 'Radio' | 'RadioGroup' | 'Checkbox' | 'CheckboxGroup' | 'Switch' | 'Slider' | 'Rate' | 'DatePicker' | 'TimePicker' | 'RangePicker' | 'Upload' | 'Cascader' | 'TreeSelect' | 'AutoComplete' | 'Mention' | 'Transfer';
+/**
+ * 组件映射表
+ * 将字符串类型映射到实际的 Arco Design Vue 组件
+ */
+export declare const componentMap: Map<string, Component>;
+/**
+ * 注册自定义组件
+ * @param name 组件名称
+ * @param component 组件实例
+ */
+export declare function registerComponent(name: string, component: Component): void;
+/**
+ * 获取组件
+ * @param name 组件名称或组件实例
+ * @returns 组件实例
+ */
+export declare function getComponent(name: string | Component): Component | undefined;
+/**
+ * 需要自动设置 placeholder 的组件类型
+ */
+export declare const componentsNeedPlaceholder: Set<string>;
+/**
+ * 需要使用 "请选择" placeholder 的组件类型
+ */
+export declare const componentsNeedSelectPlaceholder: Set<string>;
+/**
+ * 根据组件类型生成默认 placeholder
+ * @param component 组件类型
+ * @param label 标签文本
+ * @returns placeholder 文本
+ */
+export declare function getPlaceholder(component: string, label: string): string;
+//# sourceMappingURL=componentMap.d.ts.map

package/dist/components/Form/componentMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentMap.d.ts","sourceRoot":"","sources":["../../../src/components/Form/componentMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAyBhC;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,aAAa,GACb,eAAe,GACf,UAAU,GACV,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,UAAU,GACV,eAAe,GACf,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,cAAc,GACd,SAAS,GACT,UAAU,CAAC;AAEf;;;GAGG;AACH,eAAO,MAAM,YAAY,wBAA+B,CAAC;AA+BzD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,QAEnE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAK5E;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,aAKpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,+BAA+B,aAO1C,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQvE"}

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

@@ -0,0 +1,8 @@
+import { default as BasicForm } from './BasicForm.vue';
+import { useForm, createFormSchema, mergeFormSchemas } from './useForm';
+import { componentMap, registerComponent, getComponent, ComponentType } from './componentMap';
+import { FormSchema, UseFormOptions, UseFormReturn, BasicFormProps, BasicFormEmits } from './types';
+
+export { BasicForm, useForm, componentMap, registerComponent, getComponent, createFormSchema, mergeFormSchemas };
+export type { FormSchema, UseFormOptions, UseFormReturn, ComponentType, BasicFormProps, BasicFormEmits };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Form/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzG,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;AAEjH,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}

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

@@ -0,0 +1,146 @@
+import { Component } from 'vue';
+
+/**
+ * 表单字段 Schema 定义
+ */
+export interface FormSchema {
+    /** 字段名 */
+    field: string;
+    /** 组件类型（字符串或组件） */
+    component: string | Component;
+    /** 标签文本 */
+    label: string;
+    /** 标签宽度 */
+    labelWidth?: number | string;
+    /** 标签列属性 */
+    labelColProps?: Record<string, any>;
+    /** 输入框列属性 */
+    wrapperColProps?: Record<string, any>;
+    /** 栅格列属性 */
+    colProps?: Record<string, any>;
+    /** 验证规则 */
+    rules?: any[];
+    /** 组件属性 */
+    componentProps?: Record<string, any>;
+    /** 默认值 */
+    defaultValue?: any;
+    /** 自定义渲染函数 */
+    render?: (schema: FormSchema, formModel: Record<string, any>) => any;
+    /** 自定义组件内容渲染函数 */
+    renderComponentContent?: (schema: FormSchema, formModel: Record<string, any>) => any;
+    /** 栅格跨度 */
+    span?: number;
+    /** 唯一标识 */
+    key?: string | number;
+    /** 是否显示（支持函数动态判断） */
+    show?: boolean | ((formModel: Record<string, any>) => boolean);
+    /** 是否禁用 */
+    disabled?: boolean | ((formModel: Record<string, any>) => boolean);
+    /** 是否必填（用于自动添加星号） */
+    required?: boolean;
+    /** 帮助文本 */
+    help?: string;
+    /** 额外提示信息 */
+    extra?: string;
+    /** FormItem 的其他属性 */
+    formItemProps?: Record<string, any>;
+}
+/**
+ * BasicForm 组件属性
+ */
+export interface BasicFormProps {
+    /** 表单字段 schemas */
+    schemas?: FormSchema[];
+    /** 表单布局 */
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    /** 表单尺寸 */
+    size?: 'mini' | 'small' | 'medium' | 'large';
+    /** 是否禁用整个表单 */
+    disabled?: boolean;
+    /** 标签对齐方式 */
+    labelAlign?: 'left' | 'right';
+    /** 是否自动计算标签宽度 */
+    autoLabelWidth?: boolean;
+    /** 标签宽度 */
+    labelWidth?: number | string;
+    /** 标签列属性 */
+    labelColProps?: Record<string, any>;
+    /** 输入框列属性 */
+    wrapperColProps?: Record<string, any>;
+    /** 基础栅格列属性 */
+    baseColProps?: Record<string, any>;
+    /** 基础 FormItem 属性 */
+    baseFormItemProps?: Record<string, any>;
+    /** 操作按钮列配置 */
+    actionColOptions?: Record<string, any>;
+    /** 是否自动设置占位符 */
+    autoSetPlaceHolder?: boolean;
+    /** 是否显示提交按钮 */
+    showSubmitButton?: boolean;
+    /** 是否显示重置按钮 */
+    showResetButton?: boolean;
+    /** 提交按钮文本 */
+    submitButtonText?: string;
+    /** 重置按钮文本 */
+    resetButtonText?: string;
+    /** 是否显示操作按钮区域 */
+    showActionButtons?: boolean;
+}
+/**
+ * useForm 配置选项（与 BasicFormProps 一致）
+ */
+export interface UseFormOptions extends BasicFormProps {
+    /** 其他扩展属性 */
+    [key: string]: any;
+}
+/**
+ * useForm 返回值
+ */
+export interface UseFormReturn {
+    /** 注册表单实例 */
+    register: (formInstance: any) => void;
+    /** 获取所有字段值 */
+    getFieldsValue: () => Record<string, any>;
+    /** 设置字段值 */
+    setFieldsValue: (values: Record<string, any>) => Promise<void>;
+    /** 重置表单 */
+    resetFields: () => Promise<void>;
+    /** 验证表单 */
+    validate: (nameList?: string[]) => Promise<any>;
+    /** 验证指定字段 */
+    validateFields: (nameList?: string[]) => Promise<any>;
+    /** 清除验证 */
+    clearValidate: (field?: string | string[]) => Promise<void>;
+    /** 提交表单 */
+    submit: () => Promise<any>;
+    /** 更新 schema */
+    updateSchema: (schema: Partial<FormSchema> | Partial<FormSchema>[]) => Promise<void>;
+    /** 重置 schema */
+    resetSchema: (schemas: FormSchema[]) => Promise<void>;
+    /** 根据字段名移除 schema */
+    removeSchemaByField: (field: string | string[]) => Promise<void>;
+    /** 添加 schema */
+    appendSchemaByField: (schema: FormSchema | FormSchema[], prefixField?: string, first?: boolean) => Promise<void>;
+    /** 获取 schema */
+    getSchema: (field?: string) => FormSchema | FormSchema[] | undefined;
+    /** 设置表单 Props */
+    setProps: (formProps: Partial<BasicFormProps>) => Promise<void>;
+    /** 滚动到指定字段 */
+    scrollToField: (name: string, options?: ScrollIntoViewOptions) => Promise<void>;
+    /** 表单数据模型 */
+    formModel: Record<string, any>;
+    /** 表单实例引用 */
+    formRef: any;
+    /** 获取表单实例 */
+    getForm: () => any;
+}
+/**
+ * BasicForm 组件事件
+ */
+export interface BasicFormEmits {
+    (e: 'register', formInstance: any): void;
+    (e: 'submit', values: Record<string, any>): void;
+    (e: 'reset'): void;
+    (e: 'validate', field: string, valid: boolean, message: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/Form/types.ts"],"names":[],"mappings":"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"}

package/dist/components/Form/useForm.d.ts

@@ -0,0 +1,23 @@
+import { FormSchema, UseFormOptions, UseFormReturn } from './types';
+
+/**
+ * useForm Hook
+ * 用于创建和管理表单实例（参考 Vben Admin 设计）
+ * @param options 表单配置选项
+ * @returns [register, formMethods]
+ */
+export declare function useForm(options?: UseFormOptions): [
+    (formInstance: any) => void,
+    Omit<UseFormReturn, 'register'>
+];
+/**
+ * 创建表单配置
+ * 用于快速创建表单 schema
+ */
+export declare function createFormSchema(schemas: FormSchema[]): FormSchema[];
+/**
+ * 合并表单配置
+ * 用于合并多个表单配置
+ */
+export declare function mergeFormSchemas(...schemas: FormSchema[][]): FormSchema[];
+//# sourceMappingURL=useForm.d.ts.map

package/dist/components/Form/useForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForm.d.ts","sourceRoot":"","sources":["../../../src/components/Form/useForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAkB,MAAM,SAAS,CAAC;AAEzF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG;IACrD,CAAC,YAAY,EAAE,GAAG,KAAK,IAAI;IAC3B,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;CAChC,CAmSA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAKpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,UAAU,EAAE,CAEzE"}

package/dist/components/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Form';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { default as useDebounce } from './useDebounce';
+export { default as useLocalStorage } from './useLocalStorage';
+export { default as useToggle } from './useToggle';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/hooks/useDebounce.d.ts

@@ -0,0 +1,11 @@
+import { Ref } from 'vue';
+
+/**
+ * 防抖Hook
+ * @param value 需要防抖的值
+ * @param delay 延迟时间（毫秒）
+ * @returns 防抖后的值
+ */
+declare function useDebounce<T>(value: Ref<T>, delay?: number): Ref<T>;
+export default useDebounce;
+//# sourceMappingURL=useDebounce.d.ts.map

package/dist/hooks/useDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebounce.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAE5D;;;;;GAKG;AACH,iBAAS,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,MAAY,GAAG,GAAG,CAAC,CAAC,CAAC,CA4BlE;AAED,eAAe,WAAW,CAAC"}

package/dist/hooks/useLocalStorage.d.ts

@@ -0,0 +1,11 @@
+import { Ref } from 'vue';
+
+/**
+ * 本地存储Hook
+ * @param key 存储的key
+ * @param initialValue 初始值
+ * @returns [存储的值, 设置值的函数]
+ */
+declare function useLocalStorage<T>(key: string, initialValue: T): readonly [Ref<T, T>, (value: T | ((val: T) => T)) => void];
+export default useLocalStorage;
+//# sourceMappingURL=useLocalStorage.d.ts.map

package/dist/hooks/useLocalStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAE3C;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,gCAa7B,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,WAwB7C;AAED,eAAe,eAAe,CAAC"}