@neeloong/form 0.27.0 → 0.29.0

package/index.d.mts

@@ -1,5 +1,5 @@
 /*!
-* @neeloong/form v0.27.0
+* @neeloong/form v0.29.0
 * (c) 2024-2026 Fierflame
 * @license Apache-2.0
 */
@@ -450,101 +450,17 @@ declare class Store<T = any, M = any, S extends {
         new (...p: ConstructorParameters<typeof Store>): Store;
     }): void;
     /**
-     * @param {Schema.Field<M, S>} schema 字段的 Schema 定义
-     * @param {object} [options] 可选配置
-     * @param {Store?} [options.parent]
-     * @param {Partial<S>?} [options.states]
-     * @param {((store: Store, value?: any) => any) | object | number | string | boolean | null | undefined} [options.default]
-     * @param {number | string | null} [options.index]
-     * @param {number | Signal.State<number> | Signal.Computed<number>} [options.size]
-     * @param {boolean} [options.null]
-     * @param {boolean} [options.new]
-     * @param {boolean} [options.hidden]
-     * @param {boolean} [options.clearable]
-     * @param {boolean} [options.required]
-     * @param {boolean} [options.disabled]
-     * @param {boolean} [options.readonly]
-     * @param {boolean} [options.removable]
-     *
-     * @param {string} [options.label] 字段标签
-     * @param {string} [options.description] 字段描述
-     * @param {string} [options.placeholder] 占位符
-     * @param {number} [options.min] 日期、时间、数字的最小值
-     * @param {number} [options.max] 日期、时间、数字的最大值
-     * @param {number} [options.step] 日期、时间、数字的步长
-     * @param {number} [options.minLength]
-     * @param {number} [options.maxLength]
-     * @param {RegExp} [options.pattern]
-     * @param {(Schema.Value.Group | Schema.Value | string | number)[]} [options.values] 可选值
-     * @param {Schema.Validator | Schema.Validator[] | null} [options.validator]
-     * @param {{[k in keyof Schema.Events]?: Schema.AsyncValidator | Schema.AsyncValidator[] | null}} [options.validators]
-     *
-     * @param {Ref?} [options.ref]
-     *
-     * @param {((value: any) => any)?} [options.setValue]
-     * @param {((value: any) => any)?} [options.convert]
-     *
-     * @param {((value: T?, index: any, store: Store) => void)?} [options.onUpdate]
+     * @param {Schema.Field<M, S> | Store<T,M,S>} schema 字段的 Schema 定义
+     * @param {StoreOptions | AbortSignal | null} [options] 可选配置
      */
-    constructor(schema: Schema.Field<M, S>, { null: isNull, ref, default: defaultValue, setValue, convert, onUpdate, states, validator, validators, index, size, new: isNew, parent: parentNode, hidden, clearable, required, disabled, readonly, removable, label, description, placeholder, min, max, step, minLength, maxLength, pattern, values }?: {
-        parent?: Store<any, any, {
-            [x: string]: Schema.State;
-        }> | null | undefined;
-        states?: Partial<S> | null | undefined;
-        default?: ((store: Store, value?: any) => any) | object | number | string | boolean | null | undefined;
-        index?: string | number | null | undefined;
-        size?: number | Signal.State<number> | Signal.Computed<number> | undefined;
-        null?: boolean | undefined;
-        new?: boolean | undefined;
-        hidden?: boolean | undefined;
-        clearable?: boolean | undefined;
-        required?: boolean | undefined;
-        disabled?: boolean | undefined;
-        readonly?: boolean | undefined;
-        removable?: boolean | undefined;
-        label?: string | undefined;
-        description?: string | undefined;
-        placeholder?: string | undefined;
-        min?: number | undefined;
-        max?: number | undefined;
-        step?: number | undefined;
-        minLength?: number | undefined;
-        maxLength?: number | undefined;
-        pattern?: RegExp | undefined;
-        values?: (string | number | Schema.Value | Schema.Value.Group)[] | undefined;
-        validator?: Schema.Validator | Schema.Validator[] | null | undefined;
-        validators?: {
-            /**
-             * 输入
-             */
-            input?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
-            /**
-             * 变化
-             */
-            change?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
-            /**
-             * 点击
-             */
-            click?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
-            /**
-             * 聚焦
-             */
-            focus?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
-            /**
-             * 失焦
-             */
-            blur?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
-        } | undefined;
-        ref?: Ref | null | undefined;
-        setValue?: ((value: any) => any) | null | undefined;
-        convert?: ((value: any) => any) | null | undefined;
-        onUpdate?: ((value: T | null, index: any, store: Store) => void) | null | undefined;
-    });
+    constructor(schema: Schema.Field<M, S> | Store<T, M, S>, options?: StoreOptions | AbortSignal | null);
+    get schema(): Schema.Field<M, S>;
     /**
      * 触发事件并通知监听器
      * @template {keyof Schema.Events} K
      * @param {K} event
      * @param  {Schema.Events[K]} value
+     * @returns {boolean}
      */
     emit<K extends keyof Schema.Events>(event: K, value: Schema.Events[K]): boolean;
     /**
@@ -560,7 +476,6 @@ declare class Store<T = any, M = any, S extends {
     /** 存储类类别，继承的自定义类需要设置自定义的此只读属性 */
     get kind(): string;
     get ref(): Ref;
-    schema: Schema.Field<M, S>;
     get states(): S | null;
     get layout(): StoreLayout.Field<any>;
     /** @param {any} [value] @returns {any} */
@@ -696,21 +611,11 @@ declare class Store<T = any, M = any, S extends {
      * @returns {Store?}
      */
     child(key: string | number): Store | null;
-    /**
-     * @template [M=any]
-     * @template {Object.<string, Schema.State>} [S=Object.<string, Schema.State>]
-     * @param {Schema<M, S>} schema 数据结构模式
-     */
-    bindObject<M_1 = any, S_1 extends {
-        [x: string]: Schema.State;
-    } = {
-        [x: string]: Schema.State;
-    }>(schema: Schema<M_1, S_1>): () => void;
+    /** 内容是否已改变 */
+    get changed(): boolean;
     set value(v: T | null);
     /** 字段当前值 */
     get value(): T | null;
-    /** 内容是否已改变 */
-    get changed(): boolean;
     /** 重置数据 */
     reset(value?: unknown, isNew?: boolean): void;
     /**
@@ -735,6 +640,85 @@ declare class Store<T = any, M = any, S extends {
     [Symbol.iterator](): IterableIterator<[key: string | number, value: Store]>;
     #private;
 }
+type StoreOptions<T = any, M = any, S extends {
+    [x: string]: Schema.State;
+} = {
+    [x: string]: Schema.State;
+}> = {
+    parent?: Store<any, any, {
+        [x: string]: Schema.State;
+    }> | null | undefined;
+    states?: Partial<S> | null | undefined;
+    default?: ((store: Store, value?: any) => any) | object | number | string | boolean | null | undefined;
+    index?: string | number | null | undefined;
+    size?: number | Signal.State<number> | Signal.Computed<number> | undefined;
+    null?: boolean | undefined;
+    new?: boolean | undefined;
+    hidden?: boolean | undefined;
+    clearable?: boolean | undefined;
+    required?: boolean | undefined;
+    disabled?: boolean | undefined;
+    readonly?: boolean | undefined;
+    removable?: boolean | undefined;
+    /**
+     * 字段标签
+     */
+    label?: string | undefined;
+    /**
+     * 字段描述
+     */
+    description?: string | undefined;
+    /**
+     * 占位符
+     */
+    placeholder?: string | undefined;
+    /**
+     * 日期、时间、数字的最小值
+     */
+    min?: number | undefined;
+    /**
+     * 日期、时间、数字的最大值
+     */
+    max?: number | undefined;
+    /**
+     * 日期、时间、数字的步长
+     */
+    step?: number | undefined;
+    minLength?: number | undefined;
+    maxLength?: number | undefined;
+    pattern?: RegExp | undefined;
+    /**
+     * 可选值
+     */
+    values?: (string | number | Schema.Value | Schema.Value.Group)[] | undefined;
+    validator?: Schema.Validator | Schema.Validator[] | null | undefined;
+    validators?: {
+        /**
+         * 输入
+         */
+        input?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
+        /**
+         * 变化
+         */
+        change?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
+        /**
+         * 点击
+         */
+        click?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
+        /**
+         * 聚焦
+         */
+        focus?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
+        /**
+         * 失焦
+         */
+        blur?: Schema.AsyncValidator | Schema.AsyncValidator[] | null | undefined;
+    } | undefined;
+    ref?: Ref | null | undefined;
+    setValue?: ((value: any) => any) | null | undefined;
+    convert?: ((value: any) => any) | null | undefined;
+    onUpdate?: ((value: T | null, index: any, store: Store) => void) | null | undefined;
+};
 
 /** @import { Schema } from '../Schema.types.mjs' */
 /**
@@ -851,6 +835,32 @@ declare class ArrayStore<T = any, M = any, S extends {
     #private;
 }
 
+/** @import { Schema } from '../Schema.types.mjs' */
+/**
+ * @template [T=any]
+ * @template [M=any]
+ * @template {Object.<string, Schema.State>} [S=Object.<string, Schema.State>]
+ * @extends {Store<T, M, S>}
+ */
+declare class BindObjectStore<T = any, M = any, S extends {
+    [x: string]: Schema.State;
+} = {
+    [x: string]: Schema.State;
+}> extends Store<T, M, S> {
+    /**
+     * @param {Schema<any, Object.<string, Schema.State>>} schema 数据结构模式
+     * @param {Store<T, M, S>} store
+     * @param {AbortSignal} [signal]
+     */
+    constructor(schema: Schema<any, {
+        [x: string]: Schema.State;
+    }>, store: Store<T, M, S>, signal?: AbortSignal);
+    [Symbol.iterator](): Generator<[string, Store<any, any, {
+        [x: string]: Schema.State;
+    }>], void, unknown>;
+    #private;
+}
+
 /**
  * 解析模板内容
  * @param {string} source 输入源字符串
@@ -1458,4 +1468,4 @@ declare function renderStore<T>(store: Store, fieldRenderer: StoreLayout.Rendere
     clone?: boolean;
 }) | null): void;
 
-export { ArrayStore, Component, Enhancement, index_d as Layout, ObjectStore, type Ref, Schema, Store, StoreLayout, effect, render, renderStore, watch };
+export { ArrayStore, BindObjectStore, Component, Enhancement, index_d as Layout, ObjectStore, type Ref, Schema, Store, StoreLayout, type StoreOptions, effect, render, renderStore, watch };