@schemx/vue 0.1.20

package/dist/utils/dynamic.d.ts

@@ -0,0 +1,99 @@
+import { Dynamic, Values } from '@schemx/core';
+
+/**
+ * 批量解析的单个属性条目
+ *
+ * @typeParam T - 属性值类型
+ */
+export interface DependencieEntry<T> {
+    /** 动态属性值（函数、静态值、null 或 undefined） */
+    value: Dynamic<T> | undefined | null;
+    /** 默认值，当 value 为空或函数返回 nullish 时使用 */
+    defaultValue: T;
+}
+/**
+ * 批量解析的属性条目映射表类型
+ *
+ * 将属性名映射到对应的 {@link DependencieEntry}。
+ *
+ * @typeParam M - 属性名到值类型的映射
+ */
+type DependencieEntries<M extends Record<string, unknown>> = {
+    [K in keyof M]: DependencieEntry<M[K]>;
+};
+/**
+ * 解析泛型动态属性
+ *
+ * 将 `Dynamic<T>`（函数或静态值）统一解析为 `T`。
+ * 当 value 为函数时调用并传入表单值，捕获错误返回默认值；
+ * 当 value 为 null/undefined 时返回默认值。
+ *
+ * @typeParam T - 解析后的属性值类型
+ *
+ * @param value - 动态属性值（函数、静态值、null 或 undefined）
+ * @param formValues - 当前表单值，作为函数形式的入参
+ * @param defaultValue - 默认值，当 value 为空或函数返回 nullish 时使用
+ *
+ * @returns 解析后的属性值，类型始终为 T
+ *
+ * @example
+ * ```typescript
+ * // 函数类型
+ * await resolveDependencie((v) => v.name, { name: 'test' }, '')
+ * // => 'test'
+ *
+ * // 静态值
+ * await resolveDependencie('hello', {}, '')
+ * // => 'hello'
+ *
+ * // null/undefined 回退到默认值
+ * await resolveDependencie(undefined, {}, 'default')
+ * // => 'default'
+ * ```
+ */
+export declare function resolveDependencie<T>(value: Dynamic<T> | undefined | null, formValues: Values, defaultValue: T): Promise<T>;
+/**
+ * 创建 debounced 批量动态属性解析器
+ *
+ * 返回一个函数，每次调用时传入属性配置映射表、表单值和回调。
+ * 高频调用时只保留最后一次的参数，debounce 窗口结束后一次性
+ * 通过 `Promise.all` 并行解析所有属性，将结果通过回调分发。
+ *
+ * @typeParam M - 属性名到值类型的映射
+ *
+ * @param wait - debounce 等待时间（毫秒），默认 16ms（约一帧）
+ *
+ * @returns debounced 批量解析函数
+ *
+ * @example
+ * ```typescript
+ * const resolve = batchResolveDependencie<{
+ *   visible: boolean
+ *   disabled: boolean
+ *   placeholder: string
+ * }>()
+ *
+ * // 在 watch 回调中调用，高频触发时只执行最后一次
+ * resolve(
+ *   {
+ *     visible:     { value: schema.visible, defaultValue: true },
+ *     disabled:    { value: schema.disabled, defaultValue: false },
+ *     placeholder: { value: schema.placeholder, defaultValue: '' },
+ *   },
+ *   latestSnapshot,
+ *   (results) => {
+ *     resolvedVisible.value = results.visible
+ *     resolvedDisabled.value = results.disabled
+ *     resolvedPlaceholder.value = results.placeholder
+ *   }
+ * )
+ * ```
+ *
+ * @remarks
+ * 内部使用 es-toolkit 的 debounce 实现调用合并。
+ * 适用于 signal effect / watch 回调中批量解析动态属性的场景，
+ * 避免多个字段同时变化时重复解析。
+ */
+export declare function batchResolveDependencie<M extends Record<string, unknown>>(wait?: number): (entries: DependencieEntries<M>, formValues: Values, callback: (results: M) => void) => void;
+export {};
+//# sourceMappingURL=dynamic.d.ts.map

package/dist/utils/dynamic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../../src/utils/dynamic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAA;IACpC,sCAAsC;IACtC,YAAY,EAAE,CAAC,CAAA;CAChB;AAED;;;;;;GAMG;AACH,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KAC1D,CAAC,IAAI,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACvC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,CAAC,GACd,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,IAAI,SAAK,GACR,CACD,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC3B,IAAI,CAgCR"}

package/dist/utils/equal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 对象浅比较工具
+ *
+ * @module utils/equal
+ */
+/**
+ * 浅比较两个对象的自有属性值是否相同。
+ *
+ * 用于避免 computed / shallowRef 每次返回新对象引用导致子组件不必要的更新。
+ * 仅比较第一层属性，函数引用通过 === 判断。
+ *
+ * @param a - 旧对象
+ * @param b - 新对象
+ *
+ * @returns 两个对象浅相等时返回 true
+ *
+ * @example
+ * shallowEqual({ a: 1, b: 2 }, { a: 1, b: 2 }) // => true
+ * shallowEqual({ a: 1 }, { a: 1, b: 2 })        // => false
+ */
+export declare const isShallowEqual: (a: Record<string, any>, b: Record<string, any>) => boolean;
+//# sourceMappingURL=equal.d.ts.map

package/dist/utils/equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equal.d.ts","sourceRoot":"","sources":["../../src/utils/equal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GACzB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACrB,OAMF,CAAA"}

package/dist/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 工具函数统一导出
+ *
+ * @module utils
+ */
+/** 动态属性解析 */
+export { type DependencieEntry, resolveDependencie, batchResolveDependencie, } from './dynamic';
+/** 校验触发工具 */
+export { type TriggerConfig, type NormalizedTrigger, shouldValidateOn, mergeTrigger, } from './validation';
+/** 插槽工具 */
+export { resolveSlot, extractChildSlots } from './slot';
+export { diff } from './diff';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,OAAO,EACL,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,WAAW,CAAA;AAElB,aAAa;AACb,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAA;AAErB,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA"}

package/dist/utils/rendererProvider.d.ts

@@ -0,0 +1,17 @@
+import { RendererRegistryType, SchemxRendererKey } from '@schemx/core';
+
+/**
+ * 全局渲染器注册实例
+ *
+ * @example
+ * ```ts
+ * // UI 适配层注册渲染器
+ * import { rendererRegistry } from '@schemx/vue'
+ * rendererRegistry.registerAll({ input: InputRenderer, ... })
+ *
+ * // useForm 内部自动使用
+ * // props 传入的 rendererRegistry 优先级更高
+ * ```
+ */
+export declare const rendererRegistry: RendererRegistryType<SchemxRendererKey>;
+//# sourceMappingURL=rendererProvider.d.ts.map

package/dist/utils/rendererProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendererProvider.d.ts","sourceRoot":"","sources":["../../src/utils/rendererProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAA;AAErB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAAoB,CAAC,iBAAiB,CACjB,CAAA"}

package/dist/utils/rulesProvider.d.ts

@@ -0,0 +1,17 @@
+import { ValidatorsRegistryType } from '@schemx/core';
+
+/**
+ * 全局校验规则注册实例
+ *
+ * @example
+ * ```ts
+ * // 注册自定义规则
+ * import { validatorRegistry } from '@schemx/vue'
+ * validatorRegistry.register('phone', phoneRule)
+ *
+ * // useForm 内部自动使用
+ * // props 传入的 validatorRegistry 优先级更高
+ * ```
+ */
+export declare const validatorRegistry: ValidatorsRegistryType;
+//# sourceMappingURL=rulesProvider.d.ts.map

package/dist/utils/rulesProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesProvider.d.ts","sourceRoot":"","sources":["../../src/utils/rulesProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAEpF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,EAAE,sBAAmD,CAAA"}

package/dist/utils/slot.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 插槽解析与子插槽提取工具。
+ *
+ * 提供 camelCase / kebab-case 双向查找插槽，
+ * 以及按字段名前缀提取子渲染器插槽。
+ *
+ * @module utils/slot
+ */
+/**
+ * 从插槽对象中按名称查找插槽，同时支持 camelCase 和 kebab-case。
+ *
+ * 优先查找原始名称，未找到时尝试另一种命名格式。
+ * 例如传入 `userName` 时，先查 `userName`，再查 `user-name`；
+ * 传入 `user-name` 时，先查 `user-name`，再查 `userName`。
+ *
+ * @param slots - Vue 插槽对象
+ * @param name - 插槽名称（camelCase 或 kebab-case）
+ *
+ * @returns 匹配的插槽函数，未找到返回 undefined
+ *
+ * @example
+ * ```typescript
+ * // slots 中定义了 'user-name' 插槽
+ * resolveSlot(slots, 'userName')   // => 找到 'user-name' 插槽
+ * resolveSlot(slots, 'user-name')  // => 找到 'user-name' 插槽
+ * ```
+ */
+export declare const resolveSlot: (slots: Record<string, any>, name: string) => ((...args: any[]) => any) | undefined;
+/**
+ * 从父级插槽中提取子渲染器插槽。
+ *
+ * 按 `fieldName:slotName` 和 `fieldName:slot-name` 格式匹配，
+ * 提取后去掉前缀作为子渲染器的插槽名。
+ * 同时支持 camelCase 和 kebab-case 的 fieldName。
+ *
+ * @param fieldName - 字段名
+ * @param allSlots - 父级全部插槽
+ *
+ * @returns 子渲染器的插槽对象
+ *
+ * @example
+ * ```typescript
+ * // 父级插槽: { 'userName:prefix': fn, 'userName:suffix': fn, 'userNameLabel': fn }
+ * extractChildSlots('userName', slots)
+ * // => { prefix: fn, suffix: fn }
+ * ```
+ */
+export declare const extractChildSlots: (fieldName: string, allSlots: Record<string, any>) => Record<string, any>;
+//# sourceMappingURL=slot.d.ts.map

package/dist/utils/slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../src/utils/slot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8DH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,MAAM,MAAM,KACX,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,SAY9B,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,UAAU,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC5B,MAAM,CAAC,MAAM,EAAE,GAAG,CAcpB,CAAA"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,43 @@
+import { ValidationTrigger } from '@schemx/core';
+
+/** 触发时机类型（支持单个或数组） */
+export type TriggerConfig = ValidationTrigger | ValidationTrigger[];
+/** 归一化后的触发类型 */
+export type NormalizedTrigger = "blur" | "change" | "submit";
+/**
+ * 合并校验触发时机配置。
+ *
+ * 按优先级从高到低取值：列级配置 > 表单上下文配置 > 默认值。
+ * 跳过 undefined 和空数组，确保空数组不会意外覆盖后续配置。
+ *
+ * @param columnTrigger - 列级配置的触发时机
+ * @param contextTrigger - 表单上下文配置的触发时机
+ * @param defaultTrigger - 兜底默认值
+ *
+ * @returns 最终生效的触发时机
+ *
+ * @example
+ * mergeTrigger("onBlur", "onChange", "onSubmit")       // => "onBlur"
+ * mergeTrigger(undefined, "onChange", "onSubmit")       // => "onChange"
+ * mergeTrigger([], "onChange", "onSubmit")              // => "onChange"
+ * mergeTrigger(undefined, undefined, "onSubmit")        // => "onSubmit"
+ */
+export declare function mergeTrigger(columnTrigger: TriggerConfig | undefined, contextTrigger: TriggerConfig | undefined, defaultTrigger: TriggerConfig): TriggerConfig;
+/**
+ * 判断当前事件是否应该触发校验。
+ *
+ * 将配置的触发时机归一化后，与当前事件类型进行匹配。
+ *
+ * @param event - 当前触发的事件类型
+ * @param trigger - 配置的触发时机（支持单个或数组）
+ *
+ * @returns 是否应该触发校验
+ *
+ * @example
+ * shouldValidateOn("change", "onChange")              // => true
+ * shouldValidateOn("blur", ["onBlur", "onChange"])    // => true
+ * shouldValidateOn("change", "onSubmit")              // => false
+ * shouldValidateOn("change", undefined)               // => false
+ */
+export declare function shouldValidateOn(event: NormalizedTrigger, trigger?: TriggerConfig): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,sBAAsB;AACtB,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,CAAA;AAEnE,gBAAgB;AAChB,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAkB5D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,cAAc,EAAE,aAAa,GAAG,SAAS,EACzC,cAAc,EAAE,aAAa,GAC5B,aAAa,CAMf;AAyBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAKT"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "type": "module",
+  "name": "@schemx/vue",
+  "version": "0.1.20",
+  "description": "基于 JSON Schema 配置的 Vue 3 动态表单引擎（UI 无关核心）",
+  "keywords": [
+    "schemx",
+    "vue",
+    "vue3",
+    "form",
+    "dynamic-form",
+    "json-schema",
+    "form-renderer"
+  ],
+  "homepage": "https://github.com/Jiohon/schemx/tree/main/packages/vue#readme",
+  "bugs": {
+    "url": "https://github.com/Jiohon/schemx/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Jiohon/schemx.git",
+    "directory": "packages/vue"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": [
+    "**/*.css",
+    "**/*.scss"
+  ],
+  "peerDependencies": {
+    "vue": "^3.0.0"
+  },
+  "dependencies": {
+    "classnames": "^2.5.1",
+    "csstype": "^3.2.3",
+    "dayjs": "^1.11.19",
+    "es-toolkit": "^1.45.1",
+    "@schemx/core": "0.1.23"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "lint": "eslint \"src/**/*.{ts,tsx,vue,js,jsx}\""
+  }
+}