@schemx/vue 0.1.22 → 0.2.1

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

@@ -1,4 +1,4 @@
-import { SchemxViewGroupSchema, Values } from '../../../../core/src/index.ts';
+import { SchemxViewGroupSchema, Values } from '@schemx/core';
 
 /**
  * FormGroup Props

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

@@ -1,4 +1,5 @@
-import { SchemxViewSchema, Values } from '../../../../core/src/index.ts';
+import { PropType, VNodeChild } from 'vue';
+import { SchemxViewSchema, Values } from '@schemx/core';
 
 /**
  * FormItem 属性。
@@ -8,10 +9,16 @@ import { SchemxViewSchema, Values } from '../../../../core/src/index.ts';
 export interface SchemxItemProps<T extends Values = Values> {
     schema: SchemxViewSchema<T>;
 }
-declare const FormItem: import('vue').DefineSetupFnComponent<{
-    schema: SchemxViewSchema;
-}, {}, {}, {
-    schema: SchemxViewSchema;
-} & {}, import('vue').PublicProps>;
+declare const FormItem: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    schema: {
+        type: PropType<SchemxViewSchema>;
+        required: true;
+    };
+}>, () => VNodeChild, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    schema: {
+        type: PropType<SchemxViewSchema>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default FormItem;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/FormItem/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,OAAO,KAAK,EAMV,gBAAgB,EAChB,MAAM,EACP,MAAM,cAAc,CAAA;AAErB;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACxD,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CAC5B;AAED,QAAA,MAAM,QAAQ;;;;kCAkOb,CAAA;AAED,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/FormItem/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgC,QAAQ,EAAS,MAAM,KAAK,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAqBrC,OAAO,KAAK,EAMV,gBAAgB,EAChB,MAAM,EACP,MAAM,cAAc,CAAA;AAErB;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACxD,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CAC5B;AAED,QAAA,MAAM,QAAQ;;cAKQ,QAAQ,CAAC,gBAAgB,CAAC;;;UAMjC,UAAU;;cANH,QAAQ,CAAC,gBAAgB,CAAC;;;iGAgB9C,CAAA;AAoOF,eAAe,QAAQ,CAAA"}

package/dist/hocs/withRemoteOptions.d.ts

@@ -1,6 +1,6 @@
 import { Component, PropType } from 'vue';
 import { SchemxDictionary } from '../types/dictionary';
-import { NamePath } from '../../../core/src/index.ts';
+import { NamePath } from '@schemx/core';
 
 /**
  * WithRemoteOptions 注入给被包装组件的额外 Props
@@ -67,7 +67,7 @@ export declare function WithRemoteOptions(WrappedComponent: Component): import('
         default: undefined;
     };
 }>> & Readonly<{}>, {
-    dict: SchemxDictionary<import('../../../core/src/index.ts').Values, any>;
+    dict: SchemxDictionary<import('@schemx/core').Values, any>;
     fieldName: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default WithRemoteOptions;

package/dist/hooks/index.d.ts

@@ -4,17 +4,21 @@
  * @module hooks
  */
 /** useForm - 表单状态管理 */
-export { useForm, useFormContext } from './useForm';
+export { useForm } from './useForm';
+/** createFormContext - 表单上下文注入与消费 */
+export { createFormContext, useFormContext } from './provideFormContext';
 /** useField - 单字段控制 */
-export { useField, createFieldContext, useFieldContext } from './useField';
+export { useField } from './useField';
+/** createFieldContext - 表单上下文注入与消费 */
+export { createFieldContext, useFieldContext } from './provideFieldContext';
 /** useWatch - 字段变化监听 */
 export { useWatch, useWatchField, useWatchFields, useWatchAll } from './useWatch';
 /** useEffect - 通用 Signal effect */
 export { useEffect } from './useEffect';
 /** useDictionary - 字典选项加载 */
 export { useDictionary, type SchemxDictionary, type SchemxWithDictionary, type UseDictionaryReturn, } from './useDictionary';
-/** useConfigContext - 表单上下文注入与消费 */
-export { createConfigContext, useConfigContext, type FormContextProps, } from './useContext';
+/** useFormConfigContext - 表单上下文注入与消费 */
+export { createFormConfigContext, useFormConfigContext, type FormContextProps, } from './provideFormConfigContext';
 /** useStableRef - 引用稳定化的 shallowRef */
 export { useStableRef } from './useStableRef';
 /** useViewSchemas - ViewSchemas Vue 桥接 */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uBAAuB;AACvB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEnD,uBAAuB;AACvB,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE1E,wBAAwB;AACxB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEjF,mCAAmC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,6BAA6B;AAC7B,OAAO,EACL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAA;AAExB,oCAAoC;AACpC,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAA;AAErB,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uBAAuB;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAExE,uBAAuB;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,sCAAsC;AACtC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE3E,wBAAwB;AACxB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEjF,mCAAmC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,6BAA6B;AAC7B,OAAO,EACL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAA;AAExB,wCAAwC;AACxC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,gBAAgB,GACtB,MAAM,4BAA4B,CAAA;AAEnC,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/hooks/provideFieldContext.d.ts

@@ -0,0 +1,41 @@
+import { FieldInstance } from '../types/field';
+import { Values } from '@schemx/core';
+
+/**
+ * 向后代组件提供当前字段实例。
+ *
+ * 应在创建字段实例的组件 setup() 同步阶段调用，通常由 FormItem
+ * 在调用 useField() 后使用，使字段插槽或自定义子组件能够读取同一实例。
+ *
+ * @param field - useField() 返回的字段实例
+ *
+ * @remarks
+ * 该函数只注册字段上下文，不创建字段实例，也不负责字段实例的生命周期。
+ *
+ * @example
+ * ```typescript
+ * // FormItem 中
+ * 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.error.value // string[] | undefined
+ * field.getValue() // 当前字段值
+ * ```
+ */
+export declare function useFieldContext(): FieldInstance<Values>;
+//# sourceMappingURL=provideFieldContext.d.ts.map

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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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,eAAe,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,EAAmC,YAAY,CAChF,gBAAgB,CAAC,MAAM,CAAC,CACzB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,IAAI,CAC7E,eAAe,CAAC,OAAO,CAAC,EACtB,MAAM,GACN,YAAY,GACZ,kBAAkB,GAClB,2BAA2B,GAC3B,gBAAgB,GAChB,UAAU,GACV,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,CACnB;CAAG;AAEJ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,SAAS,MAAM,GAAG,MAAM,EACrE,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAC/B,IAEF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAXc,OAAO,SAAS,MAAM,kBACrD,gBAAgB,CAAC,OAAO,CAAC,KAC/B,IASiD,CAAA;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAWvD;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,6BAAuB,CAAA"}

package/dist/hooks/provideFormContext.d.ts

@@ -0,0 +1,57 @@
+import { InjectionKey } from 'vue';
+import { SchemxInstance, Values } from '@schemx/core';
+
+/**
+ * SchemxInstance 在 Vue provide/inject 中使用的注入 key。
+ *
+ * 该 key 只应与同一份包代码导出的 createFormContext() 和 useFormContext()
+ * 配套使用；重复安装不兼容版本的包不会共享此上下文。
+ */
+export declare const SCHEMX_FORM_INSTANCE_KEY: InjectionKey<SchemxInstance<Values>>;
+/**
+ * 旧版表单实例注入 key。
+ *
+ * @deprecated 请使用 SCHEMX_FORM_INSTANCE_KEY。该别名仅用于兼容旧测试和旧适配代码。
+ */
+export declare const FORM_INSTANCE_KEY: InjectionKey<SchemxInstance<Values>>;
+/**
+ * 向当前组件的后代组件提供表单实例。
+ *
+ * 必须在组件 setup() 的同步执行阶段调用；不要放入 onMounted、nextTick、
+ * Promise 或其他异步回调中，否则 Vue 无法把上下文关联到当前组件实例。
+ *
+ * @typeParam TValues - 表单值类型
+ * @param instance - 要提供给后代组件的表单实例
+ *
+ * @remarks
+ * 该函数不接管实例所有权，也不会在组件卸载时销毁实例。
+ *
+ * @example
+ * ```ts
+ * const form = props.form ?? useForm(options)
+ *
+ * // 无论 form 来自外部还是内部，都统一注册上下文。
+ * createFormContext(form)
+ * ```
+ */
+export declare function createFormContext<TValues extends Values = Values>(instance: SchemxInstance<TValues>): void;
+/**
+ * 获取最近祖先组件提供的表单实例。
+ *
+ * 该函数只能读取祖先组件注册的上下文，不能读取当前组件自身或后代组件
+ * 调用 createFormContext() 提供的值。通常由 useField()、useWatch() 等其他
+ * 表单 hook 间接调用。
+ *
+ * @typeParam TValues - 表单值类型
+ * @returns 当前组件所属表单树中的 SchemxInstance
+ *
+ * @throws Error 当前组件不在已注册表单实例上下文的后代组件树中时抛出
+ *
+ * @example
+ * ```ts
+ * const form = useFormContext<FormValues>()
+ * form.setFieldValue("name", "Schemx")
+ * ```
+ */
+export declare function useFormContext<TValues extends Values = Values>(): SchemxInstance<TValues>;
+//# sourceMappingURL=provideFormContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provideFormContext.d.ts","sourceRoot":"","sources":["../../src/hooks/provideFormContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAU,KAAK,YAAY,EAAW,MAAM,KAAK,CAAA;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAgC,YAAY,CAC/E,cAAc,CAAC,MAAM,CAAC,CACvB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,sCAA2B,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/D,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,GAChC,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,SAAS,MAAM,GAAG,MAAM,KAC5B,cAAc,CAAC,OAAO,CAAC,CAW3B"}

package/dist/hooks/useDictionary.d.ts

@@ -1,6 +1,6 @@
 import { Ref } from 'vue';
 import { SchemxDictionary } from '../types/dictionary';
-import { NamePath, Values } from '../../../core/src/index.ts';
+import { NamePath, Values } from '@schemx/core';
 
 export type { SchemxDictionary, SchemxWithDictionary } from '../types/dictionary';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"useDictionary.d.ts","sourceRoot":"","sources":["../../src/hooks/useDictionary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAa,GAAG,EAAO,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAK1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGpD,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAEhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA;IAChB,kBAAkB;IAClB,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACrB,kBAAkB;IAClB,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAA;IAC7B,eAAe;IACf,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,qBAAqB;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAA;AAEtD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAIlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,KAAK,SAAS,QAAQ,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAEnD,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAClC,YAAY,KAAK,KAChB,mBAmIF,CAAA;AAED,eAAe,aAAa,CAAA"}
+{"version":3,"file":"useDictionary.d.ts","sourceRoot":"","sources":["../../src/hooks/useDictionary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAa,GAAG,EAAO,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAK1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAEpD,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAEhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA;IAChB,kBAAkB;IAClB,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACrB,kBAAkB;IAClB,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAA;IAC7B,eAAe;IACf,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,qBAAqB;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAA;AAEtD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAIlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,KAAK,SAAS,QAAQ,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAEnD,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAClC,YAAY,KAAK,KAChB,mBAmIF,CAAA;AAED,eAAe,aAAa,CAAA"}

package/dist/hooks/useEffect.d.ts

@@ -1,4 +1,4 @@
-import { CreateEffectReturn, EffectCallback } from '../../../core/src/index.ts';
+import { CreateEffectReturn, EffectCallback } from '@schemx/core';
 
 /**
  * 创建 Signal effect 并在组件卸载时自动取消。

package/dist/hooks/useField.d.ts

@@ -1,5 +1,5 @@
 import { FieldInstance } from '../types/field';
-import { NamePath, Values } from '../../../core/src/index.ts';
+import { NamePath, Values } from '@schemx/core';
 
 /**
  * 获取单个字段的控制能力
@@ -34,36 +34,5 @@ import { NamePath, Values } from '../../../core/src/index.ts';
  * ```
  */
 export declare const useField: <TValues extends Values = Values>(name: NamePath<TValues>) => FieldInstance<TValues>;
-/**
- * 向子组件树注入当前字段上下文。
- *
- * 应在 FormItem（或任何创建了 useField 的组件）的 setup 中调用。
- *
- * @param field - useField 返回的字段实例
- *
- * @example
- * ```typescript
- * // FormItem 中
- * const field = useField('date')
- * createFieldContext(field)
- *
- * ```
- */
-export declare function createFieldContext<TValues extends Values = Values>(field: FieldInstance<TValues>): void;
-/**
- * 从最近的 FormItem 获取当前字段上下文。
- *
- * 必须在 FormItem 的组件子树内调用，否则抛出错误。
- *
- * @returns useField 返回的字段实例
- *
- * @throws 当不在 FormItem 子树内时抛出
- *
- * @example
- * const field = useFieldContext()
- * field.error.value  // string[] | undefined
- * field.getValue()   // 当前字段值（Vue 响应式）
- */
-export declare function useFieldContext(): ReturnType<typeof useField>;
 export default useField;
 //# sourceMappingURL=useField.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useField.d.ts","sourceRoot":"","sources":["../../src/hooks/useField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAI9C,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,EAAE,MAAM,cAAc,CAAA;AAuEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,MAAM,GAAG,MAAM,EACtD,MAAM,QAAQ,CAAC,OAAO,CAAC,KACtB,aAAa,CAAC,OAAO,CAuCvB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAChE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAC5B,IAAI,CAEN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAQ7D;AAED,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"useField.d.ts","sourceRoot":"","sources":["../../src/hooks/useField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAI9C,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,EAAE,MAAM,cAAc,CAAA;AAoEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,MAAM,GAAG,MAAM,EACtD,MAAM,QAAQ,CAAC,OAAO,CAAC,KACtB,aAAa,CAAC,OAAO,CAuCvB,CAAA;AAED,eAAe,QAAQ,CAAA"}

package/dist/hooks/useForm.d.ts

@@ -1,59 +1,57 @@
-import { CreateFormOptions, NamePath, SchemxInstance, Values } from '../../../core/src/index.ts';
+import { CreateFormOptions, NamePath, SchemxInstance, Values } from '@schemx/core';
 
-/** SchemxInstance 在 Vue provide/inject 中的注入 key */
-export declare const SCHEMX_INSTANCE_KEY: unique symbol;
-/** @deprecated 请使用 SCHEMX_INSTANCE_KEY。保留给旧测试和旧适配代码兼容。 */
-export declare const FORM_INSTANCE_KEY: symbol;
 /**
- * useForm 配置选项
+ * useForm 配置选项。
  *
- * 扩展 core 层的 CreateFormOptions，增加 Vue 层特有的 request 配置。
+ * 当前与 core 层 CreateFormOptions 保持一致，并在 Vue 层自动补充默认的
+ * rendererRegistry 和 validatorRegistry。保留独立类型用于后续扩展
+ * Vue 专属配置，而不污染 core 层接口。
  *
  * @typeParam TValues - 表单值类型
  */
 export interface UseFormOptions<TValues extends Values> extends CreateFormOptions<TValues, NamePath<TValues>> {
 }
 /**
- * 表单组合式函数
+ * 创建由当前 Vue effect scope 持有的表单实例。
  *
- * 创建 SchemxInstance 并通过 Vue provide 注入到子组件树中，
- * 组件卸载时自动销毁实例。
+ * useForm 只负责以下职责：
+ * 1. 合并 Vue 层默认注册表；
+ * 2. 同步创建 SchemxInstance；
+ * 3. 在当前 effect scope 销毁时调用 instance.destroy()。
  *
- * @typeParam TValues - 表单值类型
+ * useForm 不再自动调用 provide()。需要向后代组件暴露实例时，应由
+ * <SchemxForm> 或其他 Provider 组件显式调用 createFormContext(form)。
+ * 这样无论实例是内部创建还是通过 props.form 外部传入，都能走同一条
+ * 上下文注册路径，并保持清晰的实例所有权：谁创建，谁销毁。
+ *
+ * 该函数应在组件 setup() 或其他有效的 Vue effect scope 中同步调用。
+ * 非 Vue 生命周期场景请直接使用 @schemx/core 的 createForm()，并自行销毁实例。
  *
- * @param options - 表单配置选项
- * @returns 表单实例（SchemxInstance 接口）
+ * @typeParam TValues - 表单值类型
+ * @param options - 表单创建配置
+ * @returns 当前 scope 持有的 SchemxInstance
  *
  * @example
- * ```typescript
- * // 在 setup 中使用
+ * ```ts
  * const form = useForm({
- *   initialValues: { name: '', email: '' },
+ *   initialValues: {
+ *     name: "",
+ *     email: "",
+ *   },
  *   onFinish: async (values) => {
  *     await api.submit(values)
  *   },
  * })
  *
- * form.setFieldValue('name', 'John')
+ * form.setFieldValue("name", "Schemx")
  * ```
- */
-export declare function useForm<TValues extends Values = Values>(options?: UseFormOptions<TValues>): SchemxInstance<TValues>;
-/**
- * 获取表单实例
- *
- * 在子组件中获取 useForm 创建的 SchemxInstance，
- * 可用于读写字段值、校验、订阅等操作。
- *
- * @typeParam TValues - 表单值类型
- * @returns 表单实例
- *
- * @throws Error 如果不在 schemx 提供的上下文中调用
  *
  * @example
  * ```ts
- * const form = useFormContext()
- * form.setFieldValue('name', 'hello')
+ * // Provider 组件中统一注册上下文。
+ * const form = props.form ?? useForm(options)
+ * createFormContext(form)
  * ```
  */
-export declare function useFormContext<TValues extends Values = Values>(): SchemxInstance<TValues>;
+export declare function useForm<TValues extends Values = Values>(options?: UseFormOptions<TValues>): SchemxInstance<TValues>;
 //# sourceMappingURL=useForm.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useForm.d.ts","sourceRoot":"","sources":["../../src/hooks/useForm.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAEvF,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,eAA4B,CAAA;AAE5D,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,QAAsB,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM,CAAE,SAAQ,iBAAiB,CAC/E,OAAO,EACP,QAAQ,CAAC,OAAO,CAAC,CAClB;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EACrD,OAAO,GAAE,cAAc,CAAC,OAAO,CAAM,GACpC,cAAc,CAAC,OAAO,CAAC,CAkBzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,SAAS,MAAM,GAAG,MAAM,KAC5B,cAAc,CAAC,OAAO,CAAC,CAQ3B"}
+{"version":3,"file":"useForm.d.ts","sourceRoot":"","sources":["../../src/hooks/useForm.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAEvF;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM,CAAE,SAAQ,iBAAiB,CAC/E,OAAO,EACP,QAAQ,CAAC,OAAO,CAAC,CAClB;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,OAAO,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EACrD,OAAO,GAAE,cAAc,CAAC,OAAO,CAAM,GACpC,cAAc,CAAC,OAAO,CAAC,CAgBzB"}

package/dist/hooks/useViewSchemas.d.ts

@@ -1,5 +1,5 @@
 import { ShallowRef } from 'vue';
-import { SchemxInstance, SchemxViewSchema, Values } from '../../../core/src/index.ts';
+import { SchemxInstance, SchemxViewSchema, Values } from '@schemx/core';
 
 export declare function useViewSchemas<T extends Values = Values>(form: SchemxInstance<T>): ShallowRef<readonly SchemxViewSchema<T>[]>;
 export default useViewSchemas;

package/dist/hooks/useWatch.d.ts

@@ -1,4 +1,4 @@
-import { NamePath, Values, CreateWatchOptions, WatchAllCallback, WatchFieldCallback, WatchFieldsCallback } from '../../../core/src/index.ts';
+import { NamePath, Values, CreateWatchOptions, WatchAllCallback, WatchFieldCallback, WatchFieldsCallback } from '@schemx/core';
 
 /**
  * 监听所有字段变化