@schemx/vue 1.0.0-next.6 → 1.0.1

package/dist/utils/equal.d.ts

@@ -15,8 +15,8 @@
  * @returns 两个对象浅相等时返回 true
  *
  * @example
- * shallowEqual({ a: 1, b: 2 }, { a: 1, b: 2 }) // => true
- * shallowEqual({ a: 1 }, { a: 1, b: 2 })        // => false
+ * isShallowEqual({ a: 1, b: 2 }, { a: 1, b: 2 }) // => true
+ * isShallowEqual({ 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/helpers.d.ts

@@ -16,14 +16,38 @@ import { SchemxViewSchema } from '@schemx/core';
  *
  * getSectionPosition(list, 'a')
  * // => { found: true, isFirst: true, isLast: false }
+ *
+ * @param list - 当前层级的 ViewSchema 列表。
+ * @param currentKey - 要定位的 ViewSchema key。
+ * @returns 当前项是否存在以及它在所在区段中的首尾位置。
  */
 export declare function getSectionPosition<TItem extends SchemxViewSchema>(list: TItem[], currentKey: string): {
     found: boolean;
     isFirst: boolean;
     isLast: boolean;
 };
-/** 将 NamePath 转换为整体字段与 Renderer 子插槽使用的键。 */
+/**
+ * 将 NamePath 转换为整体字段与 Renderer 子插槽使用的键。
+ *
+ * @param name - 字符串字段名或由路径片段组成的字段名。
+ * @returns 使用点号连接的稳定字段键。
+ *
+ * @example
+ * ```ts
+ * normalizeNameKey(["user", "name"]) // "user.name"
+ * ```
+ */
 export declare function normalizeNameKey(name: unknown): string;
-/** 将分组 key 转换为可用于 DOM ID 的安全字符串。 */
+/**
+ * 将分组 key 转换为可用于 DOM ID 的安全字符串。
+ *
+ * @param key - Schema 或 Group 的原始 key。
+ * @returns 仅包含字母、数字、下划线和连字符的字符串。
+ *
+ * @example
+ * ```ts
+ * normalizeId("address.city") // "address-city"
+ * ```
+ */
 export declare function normalizeId(key: string): string;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,gBAAgB,EAC/D,IAAI,EAAE,KAAK,EAAE,EACb,UAAU,EAAE,MAAM;;;;EA2BnB;AAED,4CAA4C;AAC5C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAMtD;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAqB,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,gBAAgB,EAC/D,IAAI,EAAE,KAAK,EAAE,EACb,UAAU,EAAE,MAAM;;;;EA2BnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAMtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/utils/index.d.ts

@@ -3,13 +3,24 @@
  *
  * @module utils
  */
-/** 动态属性解析 */
+/**
+ * 动态属性解析
+ */
 export { type DependencieEntry, resolveDependencie, batchResolveDependencie, } from './dynamic';
-/** 校验触发工具 */
+/**
+ * 校验触发工具
+ */
 export { type TriggerConfig, type NormalizedTrigger, shouldValidateOn, mergeTrigger, } from './validation';
-/** 插槽工具 */
+/**
+ * 插槽工具
+ */
 export { resolveSlot, extractChildSlots } from './slot';
-/** 通用渲染辅助 */
+/**
+ * 通用渲染辅助
+ */
 export { getSectionPosition, normalizeId, normalizeNameKey } from './helpers';
+/**
+ * 对象差异工具。
+ */
 export { diff } from './diff';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/validation.d.ts

@@ -1,7 +1,11 @@
 import { ValidationTrigger } from '@schemx/core';
-/** 触发时机类型（支持单个或数组） */
+/**
+ * 触发时机类型（支持单个或数组）
+ */
 export type TriggerConfig = ValidationTrigger | ValidationTrigger[];
-/** 归一化后的触发类型 */
+/**
+ * 归一化后的触发类型
+ */
 export type NormalizedTrigger = "blur" | "change" | "submit";
 /**
  * 合并校验触发时机配置。

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

@@ -1 +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"}
+{"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;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,CAAA;AAEnE;;GAEG;AACH,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

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@schemx/vue",
-  "version": "1.0.0-next.6",
+  "version": "1.0.1",
   "description": "基于 JSON Schema 配置的 Vue 3 动态表单引擎（UI 无关核心）",
   "keywords": [
     "schemx",
@@ -53,7 +53,7 @@
     "classnames": "^2.5.1",
     "csstype": "^3.2.3",
     "es-toolkit": "^1.47.0",
-    "@schemx/core": "1.0.0-next.6"
+    "@schemx/core": "1.0.1"
   },
   "license": "MIT",
   "devDependencies": {

package/dist/config/providerConfig.d.ts

@@ -1,22 +0,0 @@
-import { ComputedRef } from 'vue';
-import { SchemxVueConfig } from '../types';
-/**
- * 向当前组件的后代提供合并后的组件树级配置。
- *
- * @param config - 当前 Provider 的配置快照。
- */
-export declare function provideSchemxConfigProvider(config: ComputedRef<SchemxVueConfig>): void;
-/**
- * 读取最近祖先 ConfigProvider 的配置。
- *
- * @returns 最近 Provider 的配置；不在组件 setup 上下文中时返回 undefined。
- */
-export declare function getSchemxConfigProvider(): SchemxVueConfig | undefined;
-/**
- * 读取最近 Provider 的响应式配置引用。
- *
- * Form 需要保留该引用，才能在 Provider 的展示配置变化后同步更新已有实例。
- * 该入口仅供 Vue 适配层内部使用；实例级 Registry 和 adapter 仍在创建时解析。
- */
-export declare function getSchemxConfigProviderRef(): ComputedRef<SchemxVueConfig> | undefined;
-//# sourceMappingURL=providerConfig.d.ts.map

package/dist/config/providerConfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"providerConfig.d.ts","sourceRoot":"","sources":["../../src/config/providerConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,KAAK,CAAA;AAIpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAO/C;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,GAAG,IAAI,CAatF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,WAAW,CAAC,eAAe,CAAC,GAAG,SAAS,CAMrF"}

package/dist/hooks/provideFieldContext.d.ts

@@ -1,40 +0,0 @@
-import { FieldInstance } from '../types/field';
-import { Values } from '@schemx/core';
-/**
- * 向后代组件提供当前字段实例。
- *
- * 应在创建字段实例的组件 setup() 同步阶段调用，通常由 Field
- * 在调用 useField() 后使用，使字段插槽或自定义子组件能够读取同一实例。
- *
- * @param field - useField() 返回的字段实例
- *
- * @remarks
- * 该函数只注册字段上下文，不创建字段实例，也不负责字段实例的生命周期。
- *
- * @example
- * ```typescript
- * // Field 中
- * const field = useField('date')
- * createFieldContext(field)
- *
- * ```
- */
-export declare function createFieldContext<TValues extends Values = Values>(field: FieldInstance<TValues>): void;
-/**
- * 获取最近祖先组件提供的当前字段实例。
- *
- * 必须在已调用 createFieldContext() 的组件子树内调用，否则抛出错误。
- *
- * @returns useField() 返回的字段实例
- *
- * @throws Error 当前组件不在字段上下文的后代组件树中时抛出
- *
- * @example
- * ```ts
- * const field = useFieldContext()
- * field.errors.value // readonly string[]
- * field.getValue() // 当前字段值
- * ```
- */
-export declare function useFieldContext(): FieldInstance<Values>;
-//# sourceMappingURL=provideFieldContext.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"provideFieldContext.d.ts","sourceRoot":"","sources":["../../src/hooks/provideFieldContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAO1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAChE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAC5B,IAAI,CAEN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAAC,MAAM,CAAC,CAWvD"}

package/dist/hooks/provideFormConfigContext.d.ts

@@ -1,71 +0,0 @@
-import { InjectionKey } from 'vue';
-import { SchemxSchemaConfig } from '@schemx/core';
-/** 表单级展示配置在 Vue provide/inject 中使用的注入 key。 */
-export declare const SCHEMX_FORM_CONFIG_KEY: InjectionKey<FormContextProps>;
-/**
- * 表单级默认配置。
- *
- * 该类型只描述 Schema 通用配置，不包含表单实例、表单数据、回调、样式或 Registry。
- *
- * @typeParam TValues - 表单值类型
- */
-export interface FormContextProps {
-    schemaConfig: Partial<SchemxSchemaConfig>;
-}
-/**
- * 创建并注入表单级配置上下文。
- *
- * 应在 `SchemxForm` 或自定义 Provider 的 setup() 同步阶段调用，
- * 使后代字段组件能够读取 readonly、disabled、labelAlign 等默认配置。
- *
- * @param props - 要提供给后代组件的 Schema 配置
- *
- * @remarks
- * 该函数只注册上下文，不创建或销毁表单实例，也不改变传入配置的所有权。
- *
- * @example
- * ```ts
- * createFormConfigContext({ schemaConfig: { readonly: true, labelAlign: "right" } })
- * ```
- */
-export declare const createFormConfigContext: (props: FormContextProps) => void;
-/**
- * `createFormConfigContext` 的兼容别名。
- *
- * @deprecated 请使用 createFormConfigContext。
- *
- * @example
- * ```ts
- * createContext({ schemaConfig: { disabled: true } })
- * ```
- */
-export declare const createContext: (props: FormContextProps) => void;
-/**
- * 获取最近祖先组件提供的表单级配置。
- *
- * 只能读取祖先组件通过 createFormConfigContext() 注册的配置，
- * 不能读取当前组件或后代组件提供的值。
- *
- * @returns 当前表单树中的表单级默认配置
- *
- * @throws Error 当前组件不在已注册表单配置上下文的后代组件树中时抛出
- *
- * @example
- * ```ts
- * const context = useFormConfigContext()
- * console.log(context.schemaConfig.readonly, context.schemaConfig.disabled)
- * ```
- */
-export declare function useFormConfigContext(): FormContextProps;
-/**
- * `useFormConfigContext` 的兼容别名。
- *
- * @deprecated 请使用 useFormConfigContext。
- *
- * @example
- * ```ts
- * const context = useContext()
- * ```
- */
-export declare const useContext: typeof useFormConfigContext;
-//# sourceMappingURL=provideFormConfigContext.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"provideFormConfigContext.d.ts","sourceRoot":"","sources":["../../src/hooks/provideFormConfigContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAU,KAAK,YAAY,EAAW,MAAM,KAAK,CAAA;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEtD,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,EAE9B,YAAY,CAAC,gBAAgB,CAAC,CAAA;AAEnC;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,gBAAgB,KAAG,IAEjE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,UAdqB,gBAAgB,KAAG,IAcd,CAAA;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAWvD;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,6BAAuB,CAAA"}

package/dist/hooks/provideFormContext.d.ts

@@ -1,26 +0,0 @@
-import { InjectionKey } from 'vue';
-import { VueFormRuntime, VueSchemxInstance } from '../bridge';
-import { SchemxInstance, Values } from '@schemx/core';
-type FormContextInstance = VueSchemxInstance<any>;
-/** SchemxInstance 在 Vue provide/inject 中使用的注入 key。 */
-export declare const SCHEMX_FORM_INSTANCE_KEY: InjectionKey<FormContextInstance>;
-/** 旧版表单实例注入 key，仅保留为内部适配别名。 */
-export declare const FORM_INSTANCE_KEY: InjectionKey<FormContextInstance>;
-/**
- * 向当前组件的后代组件提供表单实例和共享 Runtime。
- *
- * @param instance - 要提供给后代组件的 Core Form 或 Vue Instance。
- * @returns 当前 Runtime 对应的 Vue Instance。
- */
-export declare function createFormContext<TValues extends Values = Values>(instance: SchemxInstance<TValues> | VueSchemxInstance<TValues>): VueSchemxInstance<TValues>;
-/** 获取最近祖先提供的 Vue Instance。 */
-export declare function useFormContext<TValues extends Values = Values>(): VueSchemxInstance<TValues>;
-/**
- * 获取当前表单的内部 Runtime。
- *
- * 正常路径直接读取 Provider 已持有的 Runtime；测试或旧适配代码只提供
- * `SCHEMX_FORM_INSTANCE_KEY` 时，才为当前 scope 建立一个临时 owner。
- */
-export declare function useFormRuntimeContext<TValues extends Values = Values>(): VueFormRuntime<TValues>;
-export {};
-//# sourceMappingURL=provideFormContext.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"provideFormContext.d.ts","sourceRoot":"","sources":["../../src/hooks/provideFormContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAU,KAAK,YAAY,EAA2B,MAAM,KAAK,CAAA;AAExE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAI1D,KAAK,mBAAmB,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAA;AAIjD,sDAAsD;AACtD,eAAO,MAAM,wBAAwB,EAEhC,YAAY,CAAC,mBAAmB,CAAC,CAAA;AAOtC,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,mCAA2B,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/D,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAC7D,iBAAiB,CAAC,OAAO,CAAC,CAW5B;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,CAC5B,OAAO,SAAS,MAAM,GAAG,MAAM,KAC5B,iBAAiB,CAAC,OAAO,CAAC,CAW9B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,SAAS,MAAM,GAAG,MAAM,KAC5B,cAAc,CAAC,OAAO,CAAC,CAc3B"}