@aiao/rxdb-model 0.0.18 → 0.0.26

package/dist/entity-table/editors/multiselect-editor.d.ts

@@ -1,23 +1,41 @@
 import { GlobalOverlayEditor } from './global-overlay-editor.js';
-/** 多选选项：id + 显示名 */
+/** 多选选项：id + 显示名 + 可选色点 / 禁用 */
 export interface MultiSelectOption {
+    /** 选项唯一标识（也是存储值） */
     id: string;
+    /** 选项显示名 */
     name: string;
+    /** 色点颜色（可选，显示在复选框左侧） */
+    color?: string;
+    /** 是否禁用（只影响展示与选择，不改变合法性） */
+    disabled?: boolean;
 }
 /**
  * VTable 自定义多选编辑器
  *
- * 弹出浮层显示 checkbox 列表，支持 toggle 多选。
- * 确认后将选中 ID 以逗号分隔写回单元格。
- * 点击外部或 Esc 提交并关闭。
+ * 弹出浮层显示 checkbox 列表，支持 toggle 多选；禁用的选项不可勾选。
+ * 结束编辑时以选中 id 列表（逗号分隔）写回单元格，并通过 onCommit 回调给出 id 数组。
+ * 未显式传入初始选中时，从单元格 origin 值读取。
  */
 export declare class MultiSelectEditor extends GlobalOverlayEditor {
     #private;
     protected get initialFocusIndex(): number;
     protected get itemCount(): number;
-    readonly editorType = "multiselect";
-    constructor(options: MultiSelectOption[], selectedIds: string[], onCommit?: (ids: string[]) => void);
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
+    readonly editorType = "multiselect-editor";
+    /**
+     * 创建多选编辑器
+     *
+     * @param options - 全部可选项
+     * @param selectedIds - 初始选中的选项 ID；不传（null / undefined）时从单元格 origin 值读取
+     * @param onCommit - 结束编辑时的提交回调，收到当前选中的 ID 列表
+     */
+    constructor(options: MultiSelectOption[], selectedIds?: string[] | null, onCommit?: (ids: string[]) => void);
+    /** 打开浮层：无显式初始选中时从单元格 origin 值解析已选 id */
+    onStart(ctx: Parameters<GlobalOverlayEditor['onStart']>[0]): void;
+    /** 结束编辑时以当前选中的 ID 列表触发提交回调 */
     onEnd(): void;
+    /** 返回当前选中选项的 id，以逗号加空格拼接（存储值口径，非显示名） */
     getValue(): string;
     protected buildRows(panel: HTMLDivElement): void;
     protected onRowClick(idx: number): void;

package/dist/entity-table/editors/multiselect-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multiselect-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/multiselect-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,oBAAoB;AACpB,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,mBAAmB;;IAKxD,SAAS,KAAK,iBAAiB,IAAI,MAAM,CAExC;IAED,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAED,QAAQ,CAAC,UAAU,iBAAiB;gBAExB,OAAO,EAAE,iBAAiB,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI;IAO1F,KAAK,IAAI,IAAI;IAKtB,QAAQ,IAAI,MAAM;IAOlB,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IA6ChD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAavC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAMzD"}
+{"version":3,"file":"multiselect-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/multiselect-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAgBD;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,mBAAmB;;IAMxD,SAAS,KAAK,iBAAiB,IAAI,MAAM,CAExC;IAED,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAED,uCAAuC;IACvC,QAAQ,CAAC,UAAU,wBAAwB;IAE3C;;;;;;OAMG;gBACS,OAAO,EAAE,iBAAiB,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI;IAQ3G,wCAAwC;IAC/B,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAU1E,8BAA8B;IACrB,KAAK,IAAI,IAAI;IAKtB,wCAAwC;IACxC,QAAQ,IAAI,MAAM;IAIlB,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IA8DhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAavC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAMzD"}

package/dist/entity-table/editors/number-editor.d.ts

@@ -1,12 +1,42 @@
-import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+/** 数字编辑器的可选行为配置 */
+export interface NumberEditorOptions {
+    /** true 为 64 位大整数模式（值类型 bigint） */
+    bigint?: boolean;
+    /** 最小值（含） */
+    min?: number;
+    /** 最大值（含） */
+    max?: number;
+    /** 取值步长（相对 min 对齐，容差 1e-8） */
+    step?: number;
+}
+/**
+ * 数字输入编辑器
+ *
+ * 在单元格上方弹出固定定位输入框，输入时实时校验并显示红色错误提示。
+ * Enter / Tab 提交；Escape 恢复原值；点击外部提交，提交失败时恢复原值。
+ * 支持整数 / 小数 / bigint 三种模式，并可按 min / max / step 约束值域。
+ */
 export declare class NumberEditor implements IEditor<unknown> {
     #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType: string;
-    constructor(isInteger?: boolean);
+    /**
+     * 创建数字编辑器
+     *
+     * @param isInteger - true 为整数模式，false（默认）为小数模式
+     * @param options - 可选行为配置（bigint 模式与值域约束）
+     */
+    constructor(isInteger?: boolean, options?: NumberEditorOptions);
+    /** 创建并显示输入框与错误提示浮层，绑定输入校验与提交逻辑 */
     onStart(ctx: EditContext<unknown>): void;
-    getValue(): number | null;
+    /** 返回当前数值（bigint 模式下为 bigint），空值为 null */
+    getValue(): number | bigint | null;
+    /** 移除输入框与提示浮层，解绑全局点击事件 */
     onEnd(): void;
+    /** 判断目标元素是否属于本编辑器（输入框或错误提示浮层） */
     isEditorElement(el: HTMLElement | EventTarget): boolean;
+    /** 按新的单元格矩形重新定位输入框与错误提示浮层 */
     adjustPosition(rect: RectProps): void;
 }
 //# sourceMappingURL=number-editor.d.ts.map

package/dist/entity-table/editors/number-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/number-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAKhF,qBAAa,YAAa,YAAW,OAAO,CAAC,OAAO,CAAC;;IAUnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,SAAS,UAAQ;IAK7B,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IA2HxC,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;IAKvD,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAiDtC"}
+{"version":3,"file":"number-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/number-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAKhF,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAQD;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,OAAO,CAAC,OAAO,CAAC;;IAcnD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;gBACS,SAAS,UAAQ,EAAE,OAAO,GAAE,mBAAwB;IAYhE,kCAAkC;IAClC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAmIxC,0CAA0C;IAC1C,QAAQ,IAAI,MAAM,GAAG,MAAM,GAAG,IAAI;IAIlC,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAIb,iCAAiC;IACjC,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;IAKvD,6BAA6B;IAC7B,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CA2GtC"}

package/dist/entity-table/editors/relation-editor.d.ts

@@ -1,5 +1,5 @@
-import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
-import { RelatedEntityItem } from '../../entity-form/interfaces.js';
+import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import type { RelatedEntityItem } from '../../entity-form/interfaces.js';
 /** 关联实体选项项 */
 export { type RelatedEntityItem };
 /**
@@ -12,12 +12,24 @@ export { type RelatedEntityItem };
  */
 export declare class RelationEditor implements IEditor<string> {
     #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType = "relation-editor";
+    /**
+     * 创建关系下拉编辑器
+     *
+     * @param items - 候选实体列表，或每次打开时重新求值的工厂函数
+     * @param nullable - 是否允许空值，为 true 时列表首项为“(空)”
+     */
     constructor(items?: RelatedEntityItem[] | (() => RelatedEntityItem[]), nullable?: boolean);
+    /** 弹出搜索浮层，解析候选列表并绑定键盘与点击事件 */
     onStart(ctx: EditContext<string>): void;
+    /** 移除浮层并解绑全局事件 */
     onEnd(): void;
+    /** 返回当前选中的关联实体 ID（未选中为空字符串） */
     getValue(): string;
+    /** 判断目标元素是否位于本编辑器浮层内 */
     isEditorElement(target: HTMLElement): boolean;
+    /** 按新的单元格矩形重新定位浮层 */
     adjustPosition(rect: RectProps): void;
 }
 //# sourceMappingURL=relation-editor.d.ts.map

package/dist/entity-table/editors/relation-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relation-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/relation-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,cAAc;AAEd,OAAO,EAAE,KAAK,iBAAiB,EAAE,CAAC;AAElC;;;;;;;GAOG;AACH,qBAAa,cAAe,YAAW,OAAO,CAAC,MAAM,CAAC;;IAkBpD,QAAQ,CAAC,UAAU,qBAAqB;gBAE5B,KAAK,GAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,iBAAiB,EAAE,CAAM,EAAE,QAAQ,UAAQ;IAgD3F,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAkFvC,KAAK,IAAI,IAAI;IAWb,QAAQ,IAAI,MAAM;IAIlB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI7C,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAsHtC"}
+{"version":3,"file":"relation-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/relation-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,cAAc;AAEd,OAAO,EAAE,KAAK,iBAAiB,EAAE,CAAC;AAElC;;;;;;;GAOG;AACH,qBAAa,cAAe,YAAW,OAAO,CAAC,MAAM,CAAC;;IAkBpD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,qBAAqB;IAExC;;;;;OAKG;gBACS,KAAK,GAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,iBAAiB,EAAE,CAAM,EAAE,QAAQ,UAAQ;IAgD3F,8BAA8B;IAC9B,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAkFvC,kBAAkB;IAClB,KAAK,IAAI,IAAI;IAWb,+BAA+B;IAC/B,QAAQ,IAAI,MAAM;IAIlB,wBAAwB;IACxB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI7C,qBAAqB;IACrB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAsHtC"}

package/dist/entity-table/editors/safe-list-editor.d.ts

@@ -5,6 +5,7 @@ import { ListEditor } from '@visactor/vtable-editors';
  * during keyboard-triggered cell navigation.
  */
 export declare class SafeListEditor extends ListEditor {
+    /** 调用父类 onEnd，吞掉键盘导航场景下 parentNode 为 null 引发的 TypeError */
     onEnd(): void;
 }
 //# sourceMappingURL=safe-list-editor.d.ts.map

package/dist/entity-table/editors/safe-list-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safe-list-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/safe-list-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,UAAU;IACnC,KAAK,IAAI,IAAI;CAOvB"}
+{"version":3,"file":"safe-list-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/safe-list-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,2DAA2D;IAClD,KAAK,IAAI,IAAI;CAOvB"}

package/dist/entity-table/editors/tags-editor.d.ts

@@ -1,4 +1,5 @@
-import { EditContext, IEditor } from '@visactor/vtable-editors';
+import type { EditContext, IEditor } from '@visactor/vtable-editors';
+/** 标签编辑器模式：'string' 字符串标签 / 'number' 数字标签 */
 export type TagsMode = 'string' | 'number';
 /**
  * 标签（数组）输入编辑器
@@ -14,11 +15,21 @@ export type TagsMode = 'string' | 'number';
  */
 export declare class TagsEditor implements IEditor<unknown> {
     #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType: string;
+    /**
+     * 创建标签编辑器
+     *
+     * @param mode - 标签模式，'string'（默认）或 'number'
+     */
     constructor(mode?: TagsMode);
+    /** 弹出标签编辑浮层，从单元格值解析初始标签并绑定交互事件 */
     onStart(ctx: EditContext<unknown>): void;
+    /** 返回标签数组；number 模式下返回数字数组 */
     getValue(): string[] | number[];
+    /** 移除浮层并解绑全局点击事件 */
     onEnd(): void;
+    /** 判断目标元素是否位于本编辑器浮层内 */
     isEditorElement(el: HTMLElement | EventTarget): boolean;
 }
 //# sourceMappingURL=tags-editor.d.ts.map

package/dist/entity-table/editors/tags-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tags-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/tags-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKrE,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,YAAW,OAAO,CAAC,OAAO,CAAC;;IAUjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,IAAI,GAAE,QAAmB;IAKrC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IA4GxC,QAAQ,IAAI,MAAM,EAAE,GAAG,MAAM,EAAE;IAO/B,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;CAwExD"}
+{"version":3,"file":"tags-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/tags-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKrE,6CAA6C;AAC7C,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,YAAW,OAAO,CAAC,OAAO,CAAC;;IAUjD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;gBACS,IAAI,GAAE,QAAmB;IAKrC,kCAAkC;IAClC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IA4GxC,8BAA8B;IAC9B,QAAQ,IAAI,MAAM,EAAE,GAAG,MAAM,EAAE;IAO/B,oBAAoB;IACpB,KAAK,IAAI,IAAI;IAIb,wBAAwB;IACxB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;CAwExD"}

package/dist/entity-table/editors/text-format-editor.d.ts

@@ -0,0 +1,32 @@
+import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+/** TextFormatEditor 支持的 format 判别 */
+export type TextFormatMode = 'email' | 'phone' | 'url';
+/**
+ * 文本语义编辑器（url / email / phone）
+ *
+ * 与普通文本输入一致，但提交时按 format 语义校验（协议白名单 / 邮箱形状 / 电话形状），
+ * 校验失败显示红色错误提示并拒绝提交。
+ */
+export declare class TextFormatEditor implements IEditor<unknown> {
+    #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
+    readonly editorType = "text-format-editor";
+    /**
+     * 创建文本语义编辑器
+     *
+     * @param mode - 校验模式
+     * @param schemes - url 模式的协议白名单（不传则不限制协议）
+     */
+    constructor(mode: TextFormatMode, schemes?: readonly string[]);
+    /** 创建并显示输入框与错误提示浮层，绑定校验与提交逻辑 */
+    onStart(ctx: EditContext<unknown>): void;
+    /** 返回当前文本值，空值为 null */
+    getValue(): string | null;
+    /** 移除输入框与提示浮层，解绑全局点击事件 */
+    onEnd(): void;
+    /** 判断目标元素是否属于本编辑器（输入框或错误提示浮层） */
+    isEditorElement(el: HTMLElement | EventTarget): boolean;
+    /** 按新的单元格矩形重新定位输入框与错误提示浮层 */
+    adjustPosition(rect: RectProps): void;
+}
+//# sourceMappingURL=text-format-editor.d.ts.map

package/dist/entity-table/editors/text-format-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-format-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/text-format-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAMhF,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,OAAO,CAAC,OAAO,CAAC;;IAWvD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,wBAAwB;IAE3C;;;;;OAKG;gBACS,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE;IAK7D,gCAAgC;IAChC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAsIxC,uBAAuB;IACvB,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAIb,iCAAiC;IACjC,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;IAKvD,6BAA6B;IAC7B,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CA2BtC"}

package/dist/entity-table/editors/uuid-editor.d.ts

@@ -1,13 +1,26 @@
-import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
 import { UUID_RE } from '../../entity-value.utils.js';
+/** UUID 格式正则（re-export，定义见 entity-value.utils） */
 export { UUID_RE };
+/**
+ * UUID 文本编辑器
+ *
+ * 在单元格上方弹出固定定位输入框，提交时校验 UUID 格式（非法则红色提示）。
+ * Enter / Tab 提交；Escape 恢复原值；点击外部提交，非法输入恢复原值。
+ */
 export declare class UuidEditor implements IEditor<unknown> {
     #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType = "uuid-editor";
+    /** 创建并显示输入框与错误提示浮层，绑定格式校验与提交逻辑 */
     onStart(ctx: EditContext<unknown>): void;
+    /** 返回当前 UUID 值，空值为 null */
     getValue(): string | null;
+    /** 移除输入框与提示浮层，解绑全局点击事件 */
     onEnd(): void;
+    /** 判断目标元素是否属于本编辑器（输入框或错误提示浮层） */
     isEditorElement(el: HTMLElement | EventTarget): boolean;
+    /** 按新的单元格矩形重新定位输入框与错误提示浮层 */
     adjustPosition(rect: RectProps): void;
 }
 //# sourceMappingURL=uuid-editor.d.ts.map

package/dist/entity-table/editors/uuid-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuid-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/uuid-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAKtD,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB,qBAAa,UAAW,YAAW,OAAO,CAAC,OAAO,CAAC;;IASjD,QAAQ,CAAC,UAAU,iBAAiB;IAEpC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IA6HxC,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;IAKvD,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CA2BtC"}
+{"version":3,"file":"uuid-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/uuid-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAKtD,kDAAkD;AAClD,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,OAAO,CAAC,OAAO,CAAC;;IASjD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,iBAAiB;IAEpC,kCAAkC;IAClC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IA6HxC,2BAA2B;IAC3B,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAIb,iCAAiC;IACjC,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;IAKvD,6BAA6B;IAC7B,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CA2BtC"}

package/dist/entity-table/index.d.ts

@@ -1,22 +1,32 @@
+/**
+ * 实体表格模块
+ *
+ * 提供 VTable 驱动的实体表格基础设施：接口与配置、表格工厂/主题/操作、
+ * 自定义编辑器与列构建工具的统一出口。
+ *
+ * @module entity-table
+ */
 export type { BatchChangeItem, CellChangeEvent, EntityTableConfig, EntityTableRecord, PendingWrite, RowDeleteEvent, RowReorderEvent } from './interfaces.js';
 export { TableClipboardManager, applyClipboard, applySystemText, collectDeleteWrites, formatAsTsv, snapshotSelection, type ClipboardCell, type ClipboardContent } from './vtable/table-clipboard.js';
 export { _resetEditorRegistry, buildTableOptions, createListTable, ensureBaseEditorRegistered, registerEditor } from './vtable/table-factory.js';
 export { handleTableKeydown, type KeyboardHandlerContext } from './vtable/table-keyboard.js';
-export { collectReorderedIds, patchDragIconForReadonlyRows, updateTableRecords } from './vtable/table-operations.js';
+export { collectReorderedIds, patchDragIconForReadonlyRows, syncHeaderSortIcon, updateTableRecords, type HeaderSortClick } from './vtable/table-operations.js';
 export { createTheme, getCSSVariables, getDefaultColors, type CSSVariables } from './vtable/table-theme.js';
 export { CellTooltipManager, computeTooltipPosition } from './vtable/table-tooltip.js';
 export { ROW_SERIES_COL_OFFSET, changeCellValue, completeTableEdit, getTableContainer, isTableEditing, setCellSwitchState } from './vtable/vtable-compat.js';
+export { ColorEditor } from './editors/color-editor.js';
 export { DateEditor } from './editors/date-editor.js';
 export { EnumEditor, type EnumItem } from './editors/enum-editor.js';
 export { DAISY_COLORS, GlobalOverlayEditor, positionOverlayPanel, scheduleEditorSetup } from './editors/global-overlay-editor.js';
 export { IconListEditor, type IconLabeledItem } from './editors/icon-list-editor.js';
 export { JsonEditor } from './editors/json-editor.js';
 export { KeyValueEditor } from './editors/key-value-editor.js';
-export { lucideToSvgHtml, type IconData } from './editors/lucide-svg.js';
+export { lucideToSvgElement, type IconData } from './editors/lucide-svg.js';
 export { MultiSelectEditor, type MultiSelectOption } from './editors/multiselect-editor.js';
-export { NumberEditor } from './editors/number-editor.js';
+export { NumberEditor, type NumberEditorOptions } from './editors/number-editor.js';
 export { RelationEditor } from './editors/relation-editor.js';
 export { SafeListEditor } from './editors/safe-list-editor.js';
 export { TagsEditor, type TagsMode } from './editors/tags-editor.js';
+export { TextFormatEditor, type TextFormatMode } from './editors/text-format-editor.js';
 export { DELETE_COLOR, actionsColumn, buildPropertyColumn, disabledEditorForReadonly, formatDateValue, getCellRecord, isReadonly, isReadonlyOrAddRow, makeDeleteIcons, makeEditorForReadonly, parsePropertyColumnValue, switchDisabledForReadonly, type KVSchemaEntry, type PropertyColumnConfig, type PropertyTypeString, type SwitchDisableCallback } from './columns/column-utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/entity-table/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity-table/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACrH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EACL,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity-table/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGxF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,2BAA2B,CAAC"}

package/dist/entity-table/interfaces.d.ts

@@ -5,6 +5,7 @@
  * `_` 前缀字段为内部元数据，不会被剪贴板/编辑操作处理。
  */
 export interface EntityTableRecord {
+    /** 记录字段值（字段名 → 值） */
     [key: string]: unknown;
     /** 只读行（不可编辑、不可拖拽、不可删除） */
     _readonly?: boolean;
@@ -17,29 +18,41 @@ export interface EntityTableRecord {
 }
 /** 单元格变更事件 */
 export interface CellChangeEvent {
+    /** 变更所在列索引 */
     col: number;
+    /** 变更所在行索引 */
     row: number;
+    /** 变更的字段名 */
     field: string;
+    /** 变更后的值 */
     value: unknown;
+    /** 变更所在行记录 */
     record: EntityTableRecord;
 }
 /** 批量变更项 */
 export interface BatchChangeItem {
+    /** 目标记录 ID */
     recordId: string;
+    /** 字段名到新值的映射 */
     changes: Record<string, unknown>;
 }
 /** 行删除事件 */
 export interface RowDeleteEvent {
+    /** 被删除的行记录 */
     record: EntityTableRecord;
 }
 /** 行重排事件 */
 export interface RowReorderEvent {
+    /** 重排后的行 ID 顺序列表 */
     orderedIds: string[];
 }
 /** 剪贴板/批量写入的待提交操作 */
 export interface PendingWrite {
+    /** 目标列索引 */
     col: number;
+    /** 目标行索引 */
     row: number;
+    /** 待写入的值 */
     value: unknown;
     /** 目标列字段名 */
     field: string;

package/dist/entity-table/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/entity-table/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa;IACb,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,qBAAqB;IACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACxC;AAED,cAAc;AACd,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,YAAY;AACZ,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,YAAY;AACZ,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,WAAW;AACX,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/entity-table/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa;IACb,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,qBAAqB;IACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACxC;AAED,cAAc;AACd,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,cAAc;IACd,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,YAAY;AACZ,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,cAAc;IACd,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,YAAY;AACZ,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,WAAW;AACX,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/entity-table/vtable/table-clipboard.d.ts

@@ -1,11 +1,16 @@
-import { PendingWrite } from '../interfaces.js';
 import type * as VTable from '@visactor/vtable';
+import type { PendingWrite } from '../interfaces.js';
 /** 单个单元格的剪贴板快照 */
 export interface ClipboardCell {
+    /** 列索引 */
     col: number;
+    /** 字段名 */
     field: string;
+    /** 单元格值 */
     value: unknown;
+    /** 单元格类型 */
     cellType: string;
+    /** 属性类型 */
     propertyType?: string;
 }
 /** 剪贴板内容：行优先二维数组 `[rowOffset][colOffset]` */
@@ -14,25 +19,47 @@ export type ClipboardContent = ClipboardCell[][];
  * 将当前 VTable 选区快照为剪贴板内容。
  *
  * 跳过：表头行、只读行、新增行、元字段列（`_` 前缀）。
+ *
+ * @param table 目标表格实例
+ * @param columns 列定义列表（可选），用于读取列属性类型
+ * @returns 剪贴板快照；无可复制单元格时返回 null
  */
 export declare function snapshotSelection(table: VTable.ListTable, columns?: readonly Record<string, unknown>[]): ClipboardContent | null;
-/** 将 ClipboardContent 序列化为 TSV 字符串 */
+/**
+ * 将 ClipboardContent 序列化为 TSV 字符串
+ *
+ * @param clipboard 内部剪贴板内容
+ * @returns TSV 格式文本，null/undefined 值序列化为空字符串
+ */
 export declare function formatAsTsv(clipboard: ClipboardContent): string;
 /**
  * 从内部剪贴板收集待写入操作（按列位置匹配，类 Excel 行为）。
  * cellType 必须一致；行/列数不足时循环复用。
  * 若目标列定义了 menuList，则跳过不在枚举范围内的值。
+ *
+ * @param table 目标表格实例
+ * @param clipboard 内部剪贴板内容
+ * @param columns 列定义列表（可选），用于读取列属性类型与枚举选项
+ * @returns 待写入操作列表
  */
 export declare function applyClipboard(table: VTable.ListTable, clipboard: ClipboardContent, columns?: readonly Record<string, unknown>[]): PendingWrite[];
 /**
  * 从系统剪贴板文本（TSV）收集待写入操作。
  * 布尔列自动将文本转为布尔值（true/1/yes/是 → true，false/0/no/否/空 → false），
  * 无法识别的值跳过；枚举列跳过不在 menuList 中的值；行/列数不足时循环复用。
+ *
+ * @param table 目标表格实例
+ * @param text 系统剪贴板文本（TSV 格式，按 \n 分行、\t 分列）
+ * @param columns 列定义列表（可选），用于读取列属性类型与枚举选项
+ * @returns 待写入操作列表
  */
 export declare function applySystemText(table: VTable.ListTable, text: string, columns?: readonly Record<string, unknown>[]): PendingWrite[];
 /**
  * 从选区收集 Delete/Backspace 需要清空的单元格写入列表。
  *
+ * @param table 目标表格实例
+ * @param columns 列定义列表
+ * @param nonClearableFields 禁止清空的字段名集合
  * @param cellClearable 业务层回调判断单元格是否可清空，返回 false 跳过该单元格
  * @returns writes — 需要写入的清空操作；boolCells — 需要刷新视觉状态的布尔列坐标
  */
@@ -49,7 +76,9 @@ export declare function collectDeleteWrites(table: VTable.ListTable, columns: re
 /** 内部剪贴板管理器 — 封装系统剪贴板 API 交互 + 内部备份 */
 export declare class TableClipboardManager {
     #private;
+    /** 复制当前选区到系统剪贴板，并写入内部备份 */
     copy(table: VTable.ListTable, columns?: readonly Record<string, unknown>[]): Promise<void>;
+    /** 粘贴：系统剪贴板文本与上次写入不同时按文本解析，否则退回内部备份按列匹配写入 */
     paste(table: VTable.ListTable, columns?: readonly Record<string, unknown>[]): Promise<PendingWrite[]>;
 }
 //# sourceMappingURL=table-clipboard.d.ts.map

package/dist/entity-table/vtable/table-clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-clipboard.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqGxE,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,aAAa,EAAE,EAAE,CAAC;AAoCjD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC3C,gBAAgB,GAAG,IAAI,CA8BzB;AAED,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC3C,YAAY,EAAE,CAoChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC3C,YAAY,EAAE,CA0ChB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,OAAO,EAAE,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,CAAA;CAAE,EAAE,EAC5F,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,EACvC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAC1E;IAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAgCvE;AAED,uCAAuC;AACvC,qBAAa,qBAAqB;;IAI1B,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1F,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAe5G"}
+{"version":3,"file":"table-clipboard.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmHxE,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,UAAU;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,KAAK,EAAE,OAAO,CAAC;IACf,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,aAAa,EAAE,EAAE,CAAC;AAuCjD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC3C,gBAAgB,GAAG,IAAI,CA8BzB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAE/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC3C,YAAY,EAAE,CAoChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC3C,YAAY,EAAE,CA0ChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,OAAO,EAAE,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,CAAA;CAAE,EAAE,EAC5F,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,EACvC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAC1E;IAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAgCvE;AAED,uCAAuC;AACvC,qBAAa,qBAAqB;;IAIhC,2BAA2B;IACrB,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAahG,6CAA6C;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAe5G"}

package/dist/entity-table/vtable/table-factory.d.ts

@@ -1,17 +1,37 @@
-import { ListTableConstructorOptions } from '@visactor/vtable';
-import { EntityTableRecord } from '../interfaces.js';
+import type { ListTableConstructorOptions } from '@visactor/vtable';
 import * as VTable from '@visactor/vtable';
-/** 注册 VTable 基础编辑器（全局单例，仅 input + list） */
+import type { EntityTableRecord } from '../interfaces.js';
+/** 注册 VTable 基础编辑器（全局单例，重复调用仅注册一次） */
 export declare function ensureBaseEditorRegistered(): void;
 /**
  * 注册自定义编辑器
  *
  * 业务层调用此函数注册领域相关编辑器（如属性类型选择器）。
+ *
+ * @param name 编辑器名称
+ * @param editor 编辑器实例
  */
 export declare function registerEditor(name: string, editor: unknown): void;
-/** 构建 ListTable 初始化选项 */
+/**
+ * 构建 ListTable 初始化选项
+ *
+ * @param records 表格行数据
+ * @param columns 列定义
+ * @param isDarkMode 是否暗色主题
+ * @param options 额外选项（可选），覆盖默认配置
+ * @returns ListTable 构造选项
+ */
 export declare function buildTableOptions(records: EntityTableRecord[], columns: ListTableConstructorOptions['columns'], isDarkMode: boolean, options?: Partial<ListTableConstructorOptions>): ListTableConstructorOptions;
-/** 创建 VTable ListTable 实例 */
+/**
+ * 创建 VTable ListTable 实例
+ *
+ * @param container 挂载容器元素
+ * @param records 表格行数据
+ * @param columns 列定义
+ * @param isDarkMode 是否暗色主题
+ * @param options 额外选项（可选），覆盖默认配置
+ * @returns 已注册基础编辑器的 ListTable 实例
+ */
 export declare function createListTable(container: HTMLElement, records: EntityTableRecord[], columns: ListTableConstructorOptions['columns'], isDarkMode: boolean, options?: Partial<ListTableConstructorOptions>): VTable.ListTable;
 /** 重置编辑器注册状态（仅供测试使用） */
 export declare function _resetEditorRegistry(): void;

package/dist/entity-table/vtable/table-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-factory.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAW3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK1D,2CAA2C;AAC3C,wBAAgB,0BAA0B,IAAI,IAAI,CAejD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAElE;AAED,yBAAyB;AACzB,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,EAC/C,UAAU,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC7C,2BAA2B,CAmB7B;AAED,6BAA6B;AAC7B,wBAAgB,eAAe,CAC7B,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,EAC/C,UAAU,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC7C,MAAM,CAAC,SAAS,CAIlB;AAED,wBAAwB;AACxB,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}
+{"version":3,"file":"table-factory.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAc3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM1D,sCAAsC;AACtC,wBAAgB,0BAA0B,IAAI,IAAI,CAoBjD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAElE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,EAC/C,UAAU,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC7C,2BAA2B,CAmB7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,iBAAiB,EAAE,EAC5B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,EAC/C,UAAU,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC7C,MAAM,CAAC,SAAS,CAIlB;AAED,wBAAwB;AACxB,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/entity-table/vtable/table-keyboard.d.ts

@@ -1,20 +1,37 @@
 import type * as VTable from '@visactor/vtable';
 /** 键盘处理上下文 — 由组件提供回调 */
 export interface KeyboardHandlerContext {
+    /** 获取当前表格实例 */
     getTable(): VTable.ListTable | null;
+    /** 获取当前选中单元格坐标 */
     getSelectedCell(): {
+        /** 列索引 */
         col: number;
+        /** 行索引 */
         row: number;
     } | null;
+    /** 按列索引获取列定义 */
     getColDef(col: number): {
+        /** 单元格类型 */
         cellType?: string;
+        /** 字段名 */
         field?: string;
     } | undefined;
+    /** 复制回调 */
     onCopy(): void;
+    /** 粘贴回调 */
     onPaste(): void;
+    /** 删除回调 */
     onDelete(): void;
+    /** 单元格值变更回调 */
     onCellChange(col: number, row: number, value: unknown): void;
 }
-/** 表格容器 keydown 事件处理 — 剪贴板快捷键 + 布尔切换 + 删除 */
+/**
+ * 表格容器 keydown 事件处理 — 剪贴板快捷键 + 布尔切换 + 删除。
+ * 编辑状态下不拦截剪贴板快捷键与删除键。
+ *
+ * @param ctx 键盘处理上下文
+ * @param e 键盘事件
+ */
 export declare function handleTableKeydown(ctx: KeyboardHandlerContext, e: KeyboardEvent): void;
 //# sourceMappingURL=table-keyboard.d.ts.map

package/dist/entity-table/vtable/table-keyboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-keyboard.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAIhD,wBAAwB;AACxB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;IACpC,eAAe,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC1E,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,IAAI,IAAI,CAAC;IACjB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9D;AAID,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,sBAAsB,EAAE,CAAC,EAAE,aAAa,GAAG,IAAI,CA2BtF"}
+{"version":3,"file":"table-keyboard.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAIhD,wBAAwB;AACxB,MAAM,WAAW,sBAAsB;IACrC,eAAe;IACf,QAAQ,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;IACpC,kBAAkB;IAClB,eAAe,IAAI;QACjB,UAAU;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU;QACV,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,IAAI,CAAC;IACT,gBAAgB;IAChB,SAAS,CAAC,GAAG,EAAE,MAAM,GACjB;QACE,YAAY;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU;QACV,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACD,SAAS,CAAC;IACd,WAAW;IACX,MAAM,IAAI,IAAI,CAAC;IACf,WAAW;IACX,OAAO,IAAI,IAAI,CAAC;IAChB,WAAW;IACX,QAAQ,IAAI,IAAI,CAAC;IACjB,eAAe;IACf,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9D;AAKD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,sBAAsB,EAAE,CAAC,EAAE,aAAa,GAAG,IAAI,CA2BtF"}