@neeloong/form 0.19.0 → 0.21.0

package/index.d.mts

@@ -1,6 +1,6 @@
 /*!
-* @neeloong/form v0.19.0
-* (c) 2024-2025 Fierflame
+* @neeloong/form v0.21.0
+* (c) 2024-2026 Fierflame
 * @license Apache-2.0
 */
 
@@ -783,7 +783,46 @@ type StoreLayout = {
     fields?: StoreLayout.Item[] | null | undefined;
 };
 declare namespace StoreLayout {
-    type Action = "add" | "move" | "trigger" | "remove" | "serial";
+    type Action = "add" | "move" | "trigger" | "remove" | "serial" | "open" | "collapse";
+    type Grid = {
+        colStart?: number | undefined;
+        colSpan?: number | undefined;
+        colEnd?: number | undefined;
+        rowStart?: number | undefined;
+        rowSpan?: number | undefined;
+        rowEnd?: number | undefined;
+        cell?: "" | "collapse" | "block" | "inline" | "fieldset" | "base" | undefined;
+    };
+    type Column = {
+        /**
+         * 操作
+         */
+        actions?: StoreLayout.Action[] | undefined;
+        /**
+         * 操作
+         */
+        action?: StoreLayout.Action | undefined;
+        /**
+         * 字段
+         */
+        field?: string | undefined;
+        /**
+         * 占位符
+         */
+        placeholder?: number | undefined;
+        /**
+         * 模式
+         */
+        pattern?: string | undefined;
+        /**
+         * 宽度
+         */
+        width?: number | undefined;
+        /**
+         * 标签
+         */
+        label?: string | undefined;
+    };
     type Field = {
         type?: "field" | undefined;
         colStart?: number | undefined;
@@ -792,13 +831,16 @@ declare namespace StoreLayout {
         rowStart?: number | undefined;
         rowSpan?: number | undefined;
         rowEnd?: number | undefined;
-        cell?: "" | "block" | "inline" | "collapse" | "base" | undefined;
+        cell?: StoreLayout.Grid["cell"];
         field: string;
         html?: string | ParentNode | null | undefined;
         inlineHtml?: string | ParentNode | null | undefined;
         fields?: StoreLayout.Item[] | null | undefined;
         tableFoot?: "add" | "header" | "none" | undefined;
-        columns?: (string | StoreLayout.Action[])[] | undefined;
+        columns?: (string | number | StoreLayout.Column | StoreLayout.Action[])[] | undefined;
+        arrayStyle?: "tree" | "table" | undefined;
+        mainMethod?: "move" | "trigger" | "open" | "collapse" | undefined;
+        levelKey?: string | undefined;
     };
     type Button = {
         type: "button";
@@ -808,7 +850,7 @@ declare namespace StoreLayout {
         rowStart?: number | undefined;
         rowSpan?: number | undefined;
         rowEnd?: number | undefined;
-        cell?: "" | "block" | "inline" | "collapse" | "base" | undefined;
+        cell?: StoreLayout.Grid["cell"];
         required?: boolean | undefined;
         label?: string | undefined;
         description?: string | undefined;
@@ -824,7 +866,7 @@ declare namespace StoreLayout {
         rowStart?: number | undefined;
         rowSpan?: number | undefined;
         rowEnd?: number | undefined;
-        cell?: "" | "content" | "block" | "inline" | "collapse" | undefined;
+        cell?: StoreLayout.Grid["cell"];
         required?: boolean | undefined;
         label?: string | undefined;
         description?: string | undefined;
@@ -875,8 +917,7 @@ declare class Store<T = any, M = any> {
      * @param {Schema.Field<M>} schema 字段的 Schema 定义
      * @param {object} [options] 可选配置
      * @param {Store?} [options.parent]
-     * @param {((store: Store) => any) | any} [options.default]
-     * @param {*} [options.state]
+     * @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]
@@ -904,16 +945,13 @@ declare class Store<T = any, M = any> {
      * @param {Ref?} [options.ref]
      *
      * @param {((value: any) => any)?} [options.setValue]
-     * @param {((value: any) => any)?} [options.setState]
-     * @param {((value: any, state: any) => [value: any, state: any])?} [options.convert]
+     * @param {((value: any) => any)?} [options.convert]
      *
      * @param {((value: T?, index: any, store: Store) => void)?} [options.onUpdate]
-     * @param {((value: T?, index: any, store: Store) => void)?} [options.onUpdateState]
      */
-    constructor(schema: Schema.Field<M>, { null: isNull, state, ref, default: defaultValue, setValue, setState, convert, onUpdate, onUpdateState, validator, validators, index, size, new: isNew, parent: parentNode, hidden, clearable, required, disabled, readonly, removable, label, description, placeholder, min, max, step, minLength, maxLength, pattern, values }?: {
+    constructor(schema: Schema.Field<M>, { null: isNull, ref, default: defaultValue, setValue, convert, onUpdate, 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> | null | undefined;
-        default?: ((store: Store) => any) | any;
-        state?: any;
+        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;
@@ -959,10 +997,8 @@ declare class Store<T = any, M = any> {
         } | undefined;
         ref?: Ref | null | undefined;
         setValue?: ((value: any) => any) | null | undefined;
-        setState?: ((value: any) => any) | null | undefined;
-        convert?: ((value: any, state: any) => [value: any, state: any]) | null | undefined;
+        convert?: ((value: any) => any) | null | undefined;
         onUpdate?: ((value: T | null, index: any, store: Store) => void) | null | undefined;
-        onUpdateState?: ((value: T | null, index: any, store: Store) => void) | null | undefined;
     });
     /**
      * 触发事件并通知监听器
@@ -985,7 +1021,8 @@ declare class Store<T = any, M = any> {
     get kind(): string;
     get ref(): Ref;
     schema: Schema.Field<M>;
-    createDefault(): any;
+    /** @param {any} [value] @returns {any} */
+    createDefault(value?: any): any;
     set loading(loading: boolean);
     get loading(): boolean;
     /** 存储对象自身 */
@@ -1111,11 +1148,8 @@ declare class Store<T = any, M = any> {
     set value(v: T | null);
     /** 字段当前值 */
     get value(): T | null;
-    set state(v: any);
-    /** 字段状态 */
-    get state(): any;
     /** 重置数据 */
-    reset(value?: T | null): void;
+    reset(value?: unknown, isNew?: boolean): void;
     /**
      * 异步校验
      * @overload
@@ -1153,14 +1187,12 @@ declare class ObjectStore<T extends Record<string, any> = Record<string, any>, M
      * @param {number | string | null} [options.index]
      * @param {boolean} [options.new]
      * @param {((value: T?, index: any, store: Store) => void)?} [options.onUpdate]
-     * @param {((value: T?, index: any, store: Store) => void)?} [options.onUpdateState]
      */
-    constructor(schema: Schema.Object<M> & Schema.Attr<M>, { parent, index, new: isNew, onUpdate, onUpdateState }?: {
+    constructor(schema: Schema.Object<M> & Schema.Attr<M>, { parent, index, new: isNew, onUpdate }?: {
         parent?: Store<any, any> | null | undefined;
         index?: string | number | null | undefined;
         new?: boolean | undefined;
         onUpdate?: ((value: T | null, index: any, store: Store) => void) | null | undefined;
-        onUpdateState?: ((value: T | null, index: any, store: Store) => void) | null | undefined;
     });
     [Symbol.iterator](): Generator<[string, Store<any, any>], void, unknown>;
     #private;
@@ -1181,15 +1213,13 @@ declare class ArrayStore<T = any, M = any> extends Store<(T | null)[], M> {
      * @param {boolean} [options.new]
      * @param {boolean} [options.addable]
      * @param {(value: any, index: any, store: Store) => void} [options.onUpdate]
-     * @param {(value: any, index: any, store: Store) => void} [options.onUpdateState]
      */
-    constructor(schema: Schema.Field<M>, { parent, onUpdate, onUpdateState, index, new: isNew, addable }?: {
+    constructor(schema: Schema.Field<M>, { parent, onUpdate, index, new: isNew, addable }?: {
         parent?: Store<any, any> | null | undefined;
         index?: string | number | null | undefined;
         new?: boolean | undefined;
         addable?: boolean | undefined;
         onUpdate?: ((value: any, index: any, store: Store) => void) | undefined;
-        onUpdateState?: ((value: any, index: any, store: Store) => void) | undefined;
     });
     get children(): Store<any, any>[];
     set selfAddable(v: boolean | null);
@@ -1221,9 +1251,10 @@ declare class ArrayStore<T = any, M = any> extends Store<(T | null)[], M> {
      *
      * @param {number} from
      * @param {number} to
+     * @param {number} quantity
      * @returns
      */
-    move(from: number, to: number): boolean;
+    move(from: number, to: number, quantity?: number): number;
     /**
      *
      * @param {number} a