@schemx/vue 1.0.0-next.2 → 1.0.0-next.3

package/dist/types/form.d.ts

@@ -1,6 +1,6 @@
 import { StyleValue } from 'vue';
-import { DefinedFieldValue, FormCallbackOptions, FormLifecycleOptions, NamePath, RequiredRule, SchemxConfig, SchemxInstance, SchemxSchemasInput, ValidationTrigger, Values } from '@schemx/core';
 import { SchemxButtonProps } from '../components/Button';
+import { DefinedFieldValue, FormCallbackOptions, FormLifecycleOptions, NamePath, RequiredRule, SchemxConfig, SchemxInstance, SchemxSchemasInput, ValidationTrigger, Values } from '@schemx/core';
 /**
  * Vue 需要在编译 `defineProps` 时直接读取 Props 的字段列表。
  *

package/dist/types/form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/types/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAErC,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,EACP,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D;;;;;;GAMG;AACH,UAAU,2BAA2B,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IACnE,QAAQ,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IACxC,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAA;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC1C,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAAA;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAC1D;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,sBAAsB,CAAA;AAE/D;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAC9D,SACE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,EAC3C,mBAAmB,CAAC,OAAO,CAAC,EAC5B,oBAAoB,CAAC,OAAO,CAAC,EAC7B,2BAA2B,CAAC,OAAO,CAAC;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;IAErC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/types/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAErC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,EACP,MAAM,cAAc,CAAA;AAErB;;;;;;GAMG;AACH,UAAU,2BAA2B,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IACnE,QAAQ,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IACxC,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAA;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC1C,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAAA;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAC1D;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,sBAAsB,CAAA;AAE/D;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAC9D,SACE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,EAC3C,mBAAmB,CAAC,OAAO,CAAC,EAC5B,oBAAoB,CAAC,OAAO,CAAC,EAC7B,2BAA2B,CAAC,OAAO,CAAC;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;IAErC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@schemx/vue",
-  "version": "1.0.0-next.2",
+  "version": "1.0.0-next.3",
   "description": "基于 JSON Schema 配置的 Vue 3 动态表单引擎（UI 无关核心）",
   "keywords": [
     "schemx",
@@ -48,7 +48,7 @@
   ],
   "peerDependencies": {
     "vue": "^3.0.0",
-    "@schemx/core": "1.0.0-next.2"
+    "@schemx/core": "1.0.0-next.3"
   },
   "dependencies": {
     "classnames": "^2.5.1",
@@ -61,7 +61,7 @@
     "vue": "^3.4.0",
     "vue-tsc": "^3.3.9",
     "zod": "^4.3.6",
-    "@schemx/core": "1.0.0-next.2"
+    "@schemx/core": "1.0.0-next.3"
   },
   "scripts": {
     "build": "pnpm run type-check && vite build",

package/dist/formBridge.d.ts

@@ -1,188 +0,0 @@
-import { ShallowRef } from 'vue';
-import { FieldExternalStore, FormExternalStore } from '@schemx/core/adapter';
-import { FieldValue, NamePath, SchemxInstance, Values } from '@schemx/core';
-/**
- * 可在 Vue effect 中直接读取 Form 方法的结构兼容实例类型。
- *
- * Facade 与 Core Form 不同一引用，但保留完整的 `SchemxInstance` API。
- */
-export type VueSchemxInstance<TValues extends Values = Values> = SchemxInstance<TValues>;
-/**
- * External Store 中 pending 字段的只读聚合快照。
- */
-type PendingFieldsSnapshot<TValues extends Values> = readonly ReturnType<SchemxInstance<TValues>["getPendingFields"]>[number][];
-/**
- * Vue 中单个字段状态的 Ref 投影。
- */
-export interface VueFieldBridge<TValues extends Values = Values, TName extends NamePath<TValues> = NamePath<TValues>> {
-    /**
-     * 对应的 Core 字段 External Store。
-     */
-    readonly store: FieldExternalStore<TValues, TName>;
-    /**
-     * 当前字段值。
-     */
-    readonly value: ShallowRef<FieldValue<TValues, TName> | undefined>;
-    /**
-     * 当前字段错误消息。
-     */
-    readonly errors: ShallowRef<readonly string[]>;
-    /**
-     * 当前字段 touched 状态。
-     */
-    readonly touched: ShallowRef<boolean>;
-    /**
-     * 当前字段 pending 状态。
-     */
-    readonly pending: ShallowRef<boolean>;
-}
-/**
- * 包含唯一 Vue Facade 的共享 Form Bridge。
- */
-export interface VueFormBridge<TValues extends Values = Values> {
-    /**
-     * 原始 Core Form。
-     */
-    readonly form: SchemxInstance<TValues>;
-    /**
-     * 该 Form 的 Core External Store owner。
-     */
-    readonly externalStore: FormExternalStore<TValues>;
-    /**
-     * 全表值 Ref。
-     */
-    readonly values: ShallowRef<TValues>;
-    /**
-     * 已 touched 字段 Ref。
-     */
-    readonly touchedFields: ShallowRef<readonly NamePath<TValues>[]>;
-    /**
-     * pending 字段 Ref。
-     */
-    readonly pendingFields: ShallowRef<PendingFieldsSnapshot<TValues>>;
-    /**
-     * 当前表单提交状态的 Vue Ref 投影。
-     */
-    readonly loading: ShallowRef<boolean>;
-    /**
-     * 按 Field External Store 身份缓存的字段 Ref 投影。
-     */
-    readonly fieldBridges: Map<object, ManagedVueFieldBridge<TValues>>;
-    /**
-     * 正在使用当前 Bridge 的 Vue owner 数量。
-     */
-    refCount: number;
-    /**
-     * Bridge 是否已被手动或自动释放。
-     */
-    destroyed: boolean;
-    /**
-     * 取消 Form 级 External Store 订阅。
-     */
-    readonly unsubscribe: () => void;
-    /**
-     * 与原始 Core Form 对应的唯一 Vue Facade。
-     */
-    readonly facade: VueSchemxInstance<TValues>;
-}
-/**
- * 内部使用的、可停止订阅的字段 Ref 投影。
- */
-interface ManagedVueFieldBridge<TValues extends Values> extends VueFieldBridge<TValues> {
-    dispose(): void;
-}
-/**
- * 返回原始 Core Form；普通 Core Form 输入时保持引用不变。
- *
- * @param form - Core Form 或 Vue Facade。
- * @returns 原始 Core Form。
- *
- * @example
- * ```ts
- * const coreForm = getCoreForm(form)
- * const snapshot = coreForm.getFieldsSnapshot()
- * ```
- */
-export declare function getCoreForm<TValues extends Values = Values>(form: SchemxInstance<TValues> | VueSchemxInstance<TValues>): SchemxInstance<TValues>;
-/**
- * 获取指定 Form 的共享 Vue Bridge。
- *
- * @param form - Core Form 或 Vue Facade。
- * @returns 对应的共享 Bridge。
- *
- * @remarks
- * 首次调用会创建 External Store 订阅；调用方应使用
- * `retainVueFormBridge()` 持有 Bridge，并在 owner 销毁时释放。
- *
- * @example
- * ```ts
- * const bridge = getVueFormBridge(form)
- * const release = retainVueFormBridge(bridge)
- * onScopeDispose(release)
- * ```
- */
-export declare function getVueFormBridge<TValues extends Values = Values>(form: SchemxInstance<TValues> | VueSchemxInstance<TValues>): VueFormBridge<TValues>;
-/**
- * 获取指定 Form 的唯一 Vue Facade。
- *
- * @param form - Core Form 或已有 Vue Facade。
- * @returns 可被 Vue effect 追踪的 Facade。
- *
- * @example
- * ```ts
- * const reactiveForm = getVueFormFacade(form)
- * watchEffect(() => {
- *   console.log(reactiveForm.getFieldsValue())
- * })
- * ```
- */
-export declare function getVueFormFacade<TValues extends Values = Values>(form: SchemxInstance<TValues> | VueSchemxInstance<TValues>): VueSchemxInstance<TValues>;
-/**
- * 为一个 Vue owner 保留 Bridge，并返回对应的幂等释放函数。
- *
- * @param bridge - 要保留的共享 Bridge。
- * @returns 释放当前 owner 的函数。
- *
- * @remarks
- * 返回的释放函数可安全重复调用；最后一个 owner 释放后，Bridge 会自动销毁。
- *
- * @example
- * ```ts
- * const bridge = getVueFormBridge(form)
- * const release = retainVueFormBridge(bridge)
- * onScopeDispose(release)
- * ```
- */
-export declare function retainVueFormBridge<TValues extends Values>(bridge: VueFormBridge<TValues>): () => void;
-/**
- * 获取一个字段的共享 Vue Ref 投影。
- *
- * @param bridge - 所属 Form Bridge。
- * @param name - 字段路径。
- * @returns 对应字段的共享 Vue Bridge。
- *
- * @example
- * ```ts
- * const bridge = getVueFormBridge(form)
- * const field = getVueFieldBridge(bridge, "email")
- * watchEffect(() => console.log(field.value.value))
- * ```
- */
-export declare function getVueFieldBridge<TValues extends Values = Values, TName extends NamePath<TValues> = NamePath<TValues>>(bridge: VueFormBridge<TValues>, name: TName): VueFieldBridge<TValues, TName>;
-/**
- * 销毁共享 Bridge、全部字段订阅与 Core External Store。
- *
- * @param bridge - 要销毁的共享 Form Bridge。
- *
- * @remarks
- * 销毁后 Bridge、字段 Ref 投影和 External Store 均不可继续使用；通常由
- * `retainVueFormBridge()` 返回的最后一个释放函数自动触发。
- *
- * @example
- * ```ts
- * disposeVueFormBridge(bridge)
- * ```
- */
-export declare function disposeVueFormBridge<TValues extends Values>(bridge: VueFormBridge<TValues>): void;
-export {};
-//# sourceMappingURL=formBridge.d.ts.map

package/dist/formBridge.d.ts.map

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