@xiaohaih/json-form-vant 0.0.1

package/dist/src/assist.d.ts

@@ -0,0 +1,32 @@
+import { CoreOption, getProvideValue } from '@xiaohaih/json-form-core';
+import { Form as VanForm } from 'vant';
+import { ComponentExposed } from 'vue-component-type-helpers';
+import type * as JSONFormTs from './interface';
+/** 对对象类型的泛型进行解析 - 推断出 query 和 optionsQuery */
+type AssistOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>>> = {
+    [K in keyof T]?: JSONFormTs.JSONFormOption<T[K], T & TypeAll, O[K], O & TypeAll> | FalsyType;
+};
+/** 对数组类型的泛型进行解析 - 推断出 query 和 optionsQuery */
+type AssistOptionArr<T extends Record<string, any>, O extends Record<keyof T, any>> = JSONFormTs.JSONFormOption<keyof T, CoreOption.Merge<T> & TypeAll, O[keyof O], CoreOption.Merge<Required<O>> & TypeAll>;
+/** 假值类型 */
+type FalsyType = number | boolean | string | null | undefined;
+/** 允许调用任意字段 */
+type TypeAll = Record<string | symbol | number, any>;
+/**
+ * 定义配置项
+ * 未补充泛型声明时, 不建议通过函数返回对象形式的配置项(声明会报错)
+ */
+export declare function defineOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>> = Partial<Record<keyof T, any>>>(config: (AssistOptionArr<T, O> | FalsyType)[]): AssistOptionArr<T, O>[];
+export declare function defineOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>> = Partial<Record<keyof T, any>>>(config: (opt: DefineOptionParams<T, O>) => (AssistOptionArr<T, O> | FalsyType)[]): AssistOptionArr<T, O>[];
+export declare function defineOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>> = Partial<Record<keyof T, any>>>(config: AssistOption<T, O>): AssistOption<T, O>;
+export declare function defineOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>> = Partial<Record<keyof T, any>>>(config: (opt: DefineOptionParams<T, O>) => AssistOption<T, O>): AssistOption<T, O>;
+/** defineOption 为函数时所携带的参数 */
+export interface DefineOptionParams<Query extends Record<string, any>, Options extends Record<string, any>> {
+    /** 表单 model 对象 */
+    query: Query;
+    /** 表单封装的一些参数 */
+    wrapper: Pick<NonNullable<ReturnType<typeof getProvideValue<Query, Options>>>, 'disabled' | 'readonly' | 'options' | 'reset'> | undefined;
+    /** 表单实例 */
+    formRef: ComponentExposed<typeof VanForm> | undefined;
+}
+export {};

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from '../components/index';
+export * from './assist';
+export * as JSONFormTs from './interface';
+export * from './version';
+export { version as coreVersion, provideKey, type ProvideValue } from '@xiaohaih/json-form-core';

package/dist/src/interface.d.ts

@@ -0,0 +1,129 @@
+import { CoreOption, GetOptions, getProvideValue, usePlain } from '@xiaohaih/json-form-core';
+import { CellGroupProps as VanCellGroupProps, Form as VanForm } from 'vant';
+import { Ref } from 'vue';
+import { ComponentExposed } from 'vue-component-type-helpers';
+import { AreaProps as PureAreaProps, CascaderProps as PureCascaderProps, CheckboxGroupProps as PureCheckboxGroupProps, CheckboxProps as PureCheckboxProps, CustomRenderProps as PureCustomRenderProps, DatePickerProps as PureDatePickerProps, DateTimePickerGroupProps as PureDateTimePickerGroupProps, DatetimePickerProps as PureDatetimePickerProps, DynamicGroupProps as PureDynamicGroupProps, GroupProps as PureGroupProps, InputProps as PureInputProps, NumberKeyboardProps as PureNumberKeyboardProps, PasswordInputProps as PurePasswordInputProps, PickerProps as PurePickerProps, RadioGroupProps as PureRadioGroupProps, RadioProps as PureRadioProps, RateProps as PureRateProps, SignatureProps as PureSignatureProps, SliderProps as PureSliderProps, StepperProps as PureStepperProps, SwitchProps as PureSwitchProps, TimePickerProps as PureTimePickerProps, TreeSelectProps as PureTreeSelectProps, UploadProps as PureUploadProps } from '../components/index';
+import { ComponentType } from '../components/share';
+type BuiltInField<T = ''> = CoreOption.BuiltInField | keyof RewriteOption<any, any, any, any> | T;
+/** 重写下列选项(函数内导出的属性无法被推断出来) */
+interface RewriteOption<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any>> {
+    /** 提交的字段 */
+    field?: Field;
+    /** 提交的字段集(多选时, 每个下标对应的字段可能不一样)) */
+    fields?: Field[];
+    /** 数据源 */
+    options?: Option;
+    /** 获取数据源的方法 */
+    getOptions?: GetOptions<Query, OptionQuery>;
+}
+/** 条件声明集合 */
+export type JSONFormOption<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any>> = AreaProps<Field, Query, Option, OptionQuery> | CascaderProps<Field, Query, Option, OptionQuery> | CheckboxGroupProps<Field, Query, Option, OptionQuery> | CheckboxProps<Field, Query, Option, OptionQuery> | CustomRenderProps<Field, Query, Option, OptionQuery> | DatePickerProps<Field, Query, Option, OptionQuery> | DateTimePickerGroupProps<Field, Query, Option, OptionQuery> | DatetimePickerProps<Field, Query, Option, OptionQuery> | DynamicGroupProps<Field, Query, Option, OptionQuery> | GroupProps<Field, Query, Option, OptionQuery> | CellGroupProps<Field, Query, Option, OptionQuery> | InputProps<Field, Query, Option, OptionQuery> | NumberKeyboardProps<Field, Query, Option, OptionQuery> | PasswordInputProps<Field, Query, Option, OptionQuery> | PickerProps<Field, Query, Option, OptionQuery> | RadioGroupProps<Field, Query, Option, OptionQuery> | RadioProps<Field, Query, Option, OptionQuery> | RateProps<Field, Query, Option, OptionQuery> | SignatureProps<Field, Query, Option, OptionQuery> | SliderProps<Field, Query, Option, OptionQuery> | StepperProps<Field, Query, Option, OptionQuery> | SwitchProps<Field, Query, Option, OptionQuery> | TimePickerProps<Field, Query, Option, OptionQuery> | TreeSelectProps<Field, Query, Option, OptionQuery> | UploadProps<Field, Query, Option, OptionQuery>;
+export interface AreaProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureAreaProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'area';
+}
+export interface CascaderProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureCascaderProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'cascader';
+}
+export interface CheckboxGroupProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureCheckboxGroupProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'checkbox-group';
+}
+export interface CheckboxProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureCheckboxProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'checkbox';
+}
+export interface CustomRenderProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureCustomRenderProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'custom-render';
+}
+export interface DatePickerProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureDatePickerProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'date-picker';
+}
+export interface DateTimePickerGroupProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureDateTimePickerGroupProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'date-time-picker-group';
+}
+export interface DatetimePickerProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureDatetimePickerProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    /**
+     * @deprecated vant@3.x版本使用, vant@4.x版本使用 date-time-picker-group
+     */
+    t: 'datetime-picker';
+}
+export interface DynamicGroupProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureDynamicGroupProps<Query, OptionQuery>, BuiltInField | 'config'>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'dynamic-group';
+    /**
+     * 渲染的子条件(重写该属性以补充声明)
+     * 动态表单不是根级属性, 不应该暴露出来, 遂用 string 替代
+     */
+    config?: MaybeFunction<[{
+        item: Record<string, any>;
+        index: number;
+        checked: Record<string, any>[];
+        query: Query;
+        plain: ReturnType<typeof usePlain>;
+    }], JSONFormOption<string, Query, Option, OptionQuery>[] | Record<keyof Query, JSONFormOption<string, Query, Option, OptionQuery>>>;
+}
+export interface GroupProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureGroupProps<Query, OptionQuery>, BuiltInField | 'config' | 'getFormRef'>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'group';
+    /** 渲染的子条件(重写该属性以补充声明) */
+    config?: MaybeFunction<[{
+        query: Query;
+        wrapper?: ReturnType<typeof getProvideValue<Query, OptionQuery, Ref<ComponentExposed<typeof VanForm>>>>;
+    }], JSONFormOption<Field, Query, Option, OptionQuery>[] | Record<keyof Query, JSONFormOption<Field, Query, Option, OptionQuery>>>;
+}
+export interface CellGroupProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureGroupProps<Query, OptionQuery>, BuiltInField | 'config' | 'getFormRef' | 'slots' | 'tagSlots'>, RewriteOption<Field, Query, Option, OptionQuery>, Partial<VanCellGroupProps> {
+    t: 'cell-group';
+    /** 重写插槽声明 */
+    slots?: PureGroupProps<Query, OptionQuery>['slots'] & {
+        /** 自定义分组标题 */
+        title?: ComponentType<{
+            query: Query;
+            wrapper?: ReturnType<typeof getProvideValue<Query, OptionQuery, Ref<ComponentExposed<typeof VanForm>>>>;
+        }>;
+    };
+    /** 渲染的子条件(重写该属性以补充声明) */
+    config?: MaybeFunction<[{
+        query: Query;
+        wrapper?: ReturnType<typeof getProvideValue<Query, OptionQuery, Ref<ComponentExposed<typeof VanForm>>>>;
+    }], JSONFormOption<Field, Query, Option, OptionQuery>[] | Record<keyof Query, JSONFormOption<Field, Query, Option, OptionQuery>>>;
+}
+export interface InputProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureInputProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'input';
+}
+export interface NumberKeyboardProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureNumberKeyboardProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'number-keyboard';
+}
+export interface PasswordInputProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PurePasswordInputProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'password-input';
+}
+export interface PickerProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PurePickerProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'picker' | 'select';
+}
+export interface RadioGroupProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureRadioGroupProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'radio-group';
+}
+export interface RadioProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureRadioProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'radio';
+}
+export interface RateProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureRateProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'rate';
+}
+export interface SignatureProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureSignatureProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'signature';
+}
+export interface SliderProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureSliderProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'slider';
+}
+export interface StepperProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureStepperProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'stepper';
+}
+export interface SwitchProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureSwitchProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'switch';
+}
+export interface TimePickerProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureTimePickerProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'time-picker';
+}
+export interface TreeSelectProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureTreeSelectProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'tree-select';
+}
+export interface UploadProps<Field, Query extends Record<string, any>, Option, OptionQuery extends Record<string, any> = Record<string, any>> extends Omit<PureUploadProps<Query, OptionQuery>, BuiltInField>, RewriteOption<Field, Query, Option, OptionQuery> {
+    t: 'upload';
+}
+export type MaybeFunction<TParams extends any[], TResult> = TResult | ((...args: TParams) => TResult);
+export {};

package/dist/src/utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 选取对象中指定属性
+ */
+export declare function pick<T extends object, TKeys extends keyof T>(obj: T, keys: TKeys[]): Pick<T, TKeys>;
+export declare function pick<T extends object, TKeys extends string>(obj: T, keys: TKeys[]): T;
+/**
+ * 数组扁平化
+ */
+export declare function flat<T>(lists: readonly T[][]): T[];

package/dist/src/version.d.ts

@@ -0,0 +1,2 @@
+/** 版本号 */
+export declare const version = "0.0.1";

package/docs/.vitepress/config.ts

@@ -0,0 +1,99 @@
+import { readdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath, URL } from 'node:url';
+import {
+    presetAttributify,
+    presetIcons,
+    presetUno,
+    transformerDirectives,
+} from 'unocss';
+import UnoCSS from 'unocss/vite';
+import { createContentLoader, defineConfig } from 'vitepress';
+import type { DefaultTheme } from 'vitepress/theme';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export default async () => {
+    const components = readdirSync(resolve(__dirname, '../options/components'))
+        .map((v) => {
+            if (v.slice(-3) !== '.md') return null;
+            return { text: v.slice(0, -3), link: `/options/components/${v.slice(0, -3)}` };
+        })
+        .filter(Boolean) as DefaultTheme.SidebarItem[];
+
+    // https://vitepress.dev/reference/site-config
+    return defineConfig({
+        title: 'json-form-plus',
+        description: '基于 json 驱动的表单',
+        lang: 'zh-CN',
+        base: '/json-form/docs-plus/',
+        head: [['meta', { name: 'algolia-site-verification', content: '61B7703469FD262F' }]],
+        themeConfig: {
+            search: {
+                provider: 'local',
+                // provider: 'algolia',
+                // options: {
+                //     appId: '7I5QJDRVQQ',
+                //     apiKey: '22b659ca38c3f820e963499fc03547b4',
+                //     indexName: 'json-form-plus',
+                // },
+            },
+            // https://vitepress.dev/reference/default-theme-config
+            nav: [
+                { text: '首页', link: '/' },
+                { text: '配置项', link: '/options/shares/share-props' },
+                { text: '友情链接', link: '/friendly-links' },
+                { text: '示例', link: '/examples/index' },
+                { text: '更新日志', link: 'https://github.com/xiaohaiH/json-form/blob/master/packages/element-plus/CHANGELOG.md' },
+            ],
+            sidebar: {
+                '/options': [
+                    {
+                        text: '开始',
+                        items: [
+                            { text: '简介', link: '/options/guide/introduction' },
+                            { text: '快速上手', link: '/options/guide/quick-start' },
+                            { text: 'HForm', link: '/options/guide/form' },
+                        ],
+                    },
+                    {
+                        text: '共享属性',
+                        items: [
+                            { text: '共享 props', link: '/options/shares/share-props' },
+                            { text: '共享 slots', link: '/options/shares/share-slots' },
+                        ],
+                    },
+                    {
+                        text: '配置项',
+                        items: components,
+                    },
+                ],
+                // '/friendly-links': [],
+            },
+            socialLinks: [
+                { icon: 'github', link: 'https://github.com/xiaohaiH/json-form/tree/master/packages/element-plus' },
+            ],
+        },
+        // outDir: './dist',
+        vite: {
+            server: { port: 2012 },
+            plugins: [
+                // eslint-disable-next-line ts/ban-ts-comment
+                // @ts-ignore 忽视 ts 报错
+                UnoCSS({
+                    presets: [
+                        presetUno(),
+                        presetIcons({
+                            extraProperties: {
+                                'display': 'inline-block',
+                                'vertical-align': 'middle',
+                            },
+                        }),
+                        presetAttributify(),
+                    ],
+                    transformers: [transformerDirectives()],
+                }),
+            ],
+        },
+    });
+};

package/docs/.vitepress/theme/index.ts

@@ -0,0 +1,5 @@
+import DefaultTheme from 'vitepress/theme';
+// @ts-expect-error 忽视 unocss 模块找不到的错误
+import 'virtual:uno.css';
+
+export default DefaultTheme;

package/docs/README.md

@@ -0,0 +1,20 @@
+# Vant 组件文档
+
+这是 Vant 组件的 JSON Form 封装库的完整文档.
+
+## 文档结构
+
+```
+docs/
+├── README.md           # 本文档
+├── index.md            # 文档首页和快速开始
+├── options/*.md        # 配置项相关的文档
+├── vue-components      # 文档中使用的 vue 组件
+└── friendly-links.md   # 友情链接
+```
+
+## 相关链接
+
+- [GitHub 仓库](https://github.com/xiaohaih/json-form)
+- [Element Plus 官方文档](https://element-plus.org/)
+- [核心库文档](https://github.com/xiaohaiH/json-form/tree/master/packages/core)

package/docs/index.md

@@ -0,0 +1,25 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+
+hero:
+  name: "json-form-vant"
+  text: "基于 json 驱动的表单"
+  tagline:
+  actions:
+    - theme: brand
+      text: 快速上手
+      link: /options/guide/introduction
+
+    - theme: alt
+      text: 查看配置项
+      link: /options/shares/share-props
+
+# features:
+#   - title: Feature A
+#     details: Lorem ipsum dolor sit amet, consectetur adipiscing elit
+#   - title: Feature B
+#     details: Lorem ipsum dolor sit amet, consectetur adipiscing elit
+#   - title: Feature C
+#     details: Lorem ipsum dolor sit amet, consectetur adipiscing elit
+---

package/env.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+}
+
+interface ImportMeta {
+    readonly env: ImportMetaEnv;
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@xiaohaih/json-form-vant",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "基于vant实现, 通过JSON配置表单组件(表单项间可相互依赖)",
+  "author": "xiaohai",
+  "license": "MIT",
+  "homepage": "https://xiaohaih.github.io/json-form/example-vant-vue3/index.html",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xiaohaiH/json-form/tree/master/packages/vant"
+  },
+  "keywords": [
+    "vue3",
+    "vant",
+    "JSON Form"
+  ],
+  "exports": {
+    ".": {
+      "browser": "./src/index.ts",
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "require": "./dist/index.cjs.js"
+    },
+    "./*": "./*"
+  },
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "unpkg": "dist/index.umd.js",
+  "jsdelivr": "dist/index.umd.js",
+  "types": "src/index.ts",
+  "peerDependencies": {
+    "vant": "^3.0.0",
+    "vue": "^3.0.0"
+  },
+  "dependencies": {
+    "@xiaohaih/json-form-core": "0.2.8"
+  },
+  "devDependencies": {
+    "@docsearch/js": "^4.6.3",
+    "@popperjs/core": "^2.11.8",
+    "@rollup/plugin-terser": "^1.0.0",
+    "@vitejs/plugin-vue": "^6.0.7",
+    "@vitejs/plugin-vue-jsx": "^5.1.5",
+    "@vue/language-core": "^3.3.1",
+    "tsdown": "^0.22.0",
+    "typescript": "~6.0.3",
+    "unocss": "^66.5.0",
+    "unplugin-dts": "^1.0.1",
+    "unplugin-vue": "^7.2.0",
+    "vant": "^4.9.24",
+    "vite": "^8.0.13",
+    "vitepress": "2.0.0-alpha.12",
+    "vue": "^3.5.13",
+    "vue-component-type-helpers": "^3.3.1",
+    "vue-tsc": "^3.3.1"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "jsdelivr": "dist/index.umd.js"
+  },
+  "scripts": {
+    "build": "node ./scripts/generate-version.mjs && vite build",
+    "build:dts": "tsdown",
+    "postinstall": "node -e \"try{require('./scripts/postinstall.cjs')}catch(e){}\"",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  }
+}

package/scripts/generate-version.mjs

@@ -0,0 +1,26 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** 获取当前文件的目录名 */
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/** 获取 package.json 的路径 */
+const packageJsonPath = resolve(__dirname, '../package.json');
+
+/** 读取 package.json 文件内容 */
+const packageJson = readFileSync(packageJsonPath, 'utf8');
+
+/** 解析 JSON 数据 */
+const packageData = JSON.parse(packageJson);
+
+/** 获取版本号 */
+const version = packageData.version;
+
+/** 生成版本号文件 */
+const versionFilePath = resolve(__dirname, '../src/version.ts');
+const versionFileContent = `/** 版本号 */\nexport const version = '${version}';\n`;
+
+/** 写入版本号文件 */
+writeFileSync(versionFilePath, versionFileContent);

package/scripts/postinstall.cjs

@@ -0,0 +1,13 @@
+const fs = require('node:fs');
+const path = require('node:path');
+
+const dir = path.resolve(__dirname, '..');
+
+const { loadModule, reexport, writeContent } = require('./utils.cjs');
+
+const Vant = loadModule('vant');
+const isDebug = false;
+if (Vant && (isDebug || dir.includes('node_modules'))) {
+    const newContent = reexport(fs.readFileSync(path.join(dir, './components/component-definition/definition.ts'), 'utf-8'), Vant);
+    writeContent(path.join(dir, './components/component-definition/components.ts'), newContent);
+}

package/scripts/utils.cjs

@@ -0,0 +1,67 @@
+const fs = require('node:fs');
+const path = require('node:path');
+
+const dir = path.resolve(__dirname, '..', 'lib');
+
+function loadModule(name) {
+    try {
+        return require(name);
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+
+function writeContent(dest, content) {
+    // unlink for pnpm, #92
+    try {
+        fs.unlinkSync(dest);
+    }
+    catch (error) { }
+    fs.writeFileSync(dest, content, 'utf-8');
+}
+
+const reg = /(export\s+\*\s+from\s+'\.\.\/)([\w|\-]+)(\/index';)/;
+const wordReg = /-\w/g;
+/** 不经过 vant 的组件 */
+const whiteList = ['custom-render'];
+/** 引用了多个 vant 的组件 */
+const multipleList = {
+    'date-time-picker-group': ['date-picker', 'time-picker', 'picker-group'],
+    'input': ['field'],
+    'upload': ['Uploader'],
+};
+function reexport(content, Ui) {
+    const arr = content.split('\n');
+    const newContent = {
+        imp: [],
+        exp: [],
+    };
+    arr.forEach((item) => {
+        const result = item.match(reg);
+        if (!result) return;
+        const [all, $1, $2, $3] = result;
+        if (whiteList.includes($2) || hasComponent(Ui, $2)) return newContent.imp.push(all);
+        newContent.exp.push([
+            `export const ${camelize2(`h-${$2}`)} = { render: () => null };`,
+            `export interface ${camelize2(`${$2}-props`)}<A, B> {}`,
+        ].join('\n'));
+    });
+
+    return `${[newContent.imp.join('\n'), newContent.exp.join('\n')].filter(Boolean).join('\n\n')}\n`;
+}
+
+function hasComponent(Ui, name) {
+    if (multipleList[name]) return multipleList[name].every((o) => camelize2(o) in Ui);
+    return camelize2(name) in Ui;
+}
+function camelize(name) {
+    return name.replace(wordReg, ($1) => $1.slice(1).toUpperCase());
+}
+function camelize2(name) {
+    return camelize(`-${name}`);
+}
+
+module.exports.loadModule = loadModule;
+module.exports.reexport = reexport;
+module.exports.writeContent = writeContent;

package/src/assist.ts

@@ -0,0 +1,40 @@
+import type { CoreOption, getProvideValue } from '@xiaohaih/json-form-core';
+import type { Form as VanForm } from 'vant';
+import type { ExtractPublicPropTypes, PropType, Ref } from 'vue';
+import { ref } from 'vue';
+import type { ComponentExposed } from 'vue-component-type-helpers';
+import type * as JSONFormTs from './interface';
+
+/** 对对象类型的泛型进行解析 - 推断出 query 和 optionsQuery */
+type AssistOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>>> = {
+    /** 添加问号是允许泛型声明的字段可以多过配置项内的字段 */
+    [K in keyof T]?: JSONFormTs.JSONFormOption<T[K], T & TypeAll, O[K], O & TypeAll> | FalsyType;
+};
+/** 对数组类型的泛型进行解析 - 推断出 query 和 optionsQuery */
+type AssistOptionArr<T extends Record<string, any>, O extends Record<keyof T, any>> = JSONFormTs.JSONFormOption<keyof T, CoreOption.Merge<T> & TypeAll, O[keyof O], CoreOption.Merge<Required<O>> & TypeAll>;
+/** 假值类型 */
+type FalsyType = number | boolean | string | null | undefined;
+/** 允许调用任意字段 */
+type TypeAll = Record<string | symbol | number, any>;
+
+/**
+ * 定义配置项
+ * 未补充泛型声明时, 不建议通过函数返回对象形式的配置项(声明会报错)
+ */
+export function defineOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>> = Partial<Record<keyof T, any>>>(config: (AssistOptionArr<T, O> | FalsyType)[]): AssistOptionArr<T, O>[];
+export function defineOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>> = Partial<Record<keyof T, any>>>(config: (opt: DefineOptionParams<T, O>) => (AssistOptionArr<T, O> | FalsyType)[]): AssistOptionArr<T, O>[];
+export function defineOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>> = Partial<Record<keyof T, any>>>(config: AssistOption<T, O>): AssistOption<T, O>;
+export function defineOption<T extends Record<string, any>, O extends Partial<Record<keyof T, any>> = Partial<Record<keyof T, any>>>(config: (opt: DefineOptionParams<T, O>) => AssistOption<T, O>): AssistOption<T, O>;
+export function defineOption(config: any) {
+    return config;
+}
+
+/** defineOption 为函数时所携带的参数 */
+export interface DefineOptionParams<Query extends Record<string, any>, Options extends Record<string, any>> {
+    /** 表单 model 对象 */
+    query: Query;
+    /** 表单封装的一些参数 */
+    wrapper: Pick<NonNullable<ReturnType<typeof getProvideValue<Query, Options>>>, 'disabled' | 'readonly' | 'options' | 'reset'> | undefined;
+    /** 表单实例 */
+    formRef: ComponentExposed<typeof VanForm> | undefined;
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from '../components/index';
+export * from './assist';
+export * as JSONFormTs from './interface';
+export * from './version';
+export { version as coreVersion, provideKey, type ProvideValue } from '@xiaohaih/json-form-core';