@aiao/rxdb-model 0.0.19 → 0.0.28

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

@@ -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';
+/** 标签编辑器模式：'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 { 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 { 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

@@ -1,3 +1,4 @@
+import { ListTable } from '@visactor/vtable';
 /**
  * 通用实体表记录基础接口
  *
@@ -5,6 +6,7 @@
  * `_` 前缀字段为内部元数据，不会被剪贴板/编辑操作处理。
  */
 export interface EntityTableRecord {
+    /** 记录字段值（字段名 → 值） */
     [key: string]: unknown;
     /** 只读行（不可编辑、不可拖拽、不可删除） */
     _readonly?: boolean;
@@ -17,29 +19,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;
@@ -51,4 +65,28 @@ export interface EntityTableConfig {
     /** 单元格错误 tooltip 延迟（毫秒），默认 800 */
     tooltipDelay?: number;
 }
+/**
+ * 实体表格的命令面：三端 `EntityTable` 组件对外暴露的同一组命令。
+ *
+ * @remarks
+ * React 经 `ref`（`forwardRef` + `useImperativeHandle`）、Vue 经 `defineExpose`、Angular 即组件实例
+ * 本身（`EntityTableComponent implements EntityTableHandle`）。三端各自另有的公开成员（Angular 的
+ * input / output、Vue 暴露给内部父组件的状态）不在契约内，按本类型写的调用方与 mock 三端通用。
+ */
+export interface EntityTableHandle {
+    /** 当前 VTable 表格实例；未初始化时为 `null`。 */
+    readonly tableInstance: ListTable | null;
+    /** 从业务层回滚单元格值（校验失败时恢复原值）。 */
+    changeCellValue(col: number, row: number, value: unknown): void;
+    /** 用当前暗色模式与 CSS 变量重绘主题。 */
+    redrawTheme(): void;
+    /** 把行恢复成最近一次交给表格的顺序（拖放被拒或落库失败时调用）。 */
+    restoreRecords(): void;
+}
+/**
+ * 查询表格的命令面：成员与 {@link EntityTableHandle} 相同，全部委托给内部实体表格。
+ *
+ * @remarks 三端 `QueryTable` 组件的暴露方式同 {@link EntityTableHandle}。
+ */
+export type QueryTableHandle = EntityTableHandle;
 //# sourceMappingURL=interfaces.d.ts.map

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,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;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;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IACzC,6BAA6B;IAC7B,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE,2BAA2B;IAC3B,WAAW,IAAI,IAAI,CAAC;IACpB,sCAAsC;IACtC,cAAc,IAAI,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC"}

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

@@ -2,10 +2,15 @@ import { PendingWrite } from '../interfaces.js';
 import type * as VTable from '@visactor/vtable';
 /** 单个单元格的剪贴板快照 */
 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 * as VTable from '@visactor/vtable';
-/** 注册 VTable 基础编辑器（全局单例，仅 input + list） */
+/** 注册 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"}

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

@@ -4,15 +4,56 @@ import type * as VTable from '@visactor/vtable';
 /**
  * HACK: VTable 不提供禁用特定行拖拽的 API，通过 monkey-patch 内部属性实现
  *
+ * 只读行、新增行不给手柄；`setRowDragEnabled(table, false)` 之后所有行都不给。
+ *
  * TODO(vtable-upstream): 跟踪 VTable 上游 API，一旦提供 per-row dragOrder 配置即可移除此 hack
  * @see https://github.com/AgoraIO/vtable/issues — 搜索 "drag order per row"
+ * @param table 目标表格实例
  */
 export declare function patchDragIconForReadonlyRows(table: VTable.ListTable): void;
-/** 收集拖拽排序后的非只读行 ID 列表 */
+/**
+ * 列头排序点击时 VTable 交出的状态
+ */
+export interface HeaderSortClick {
+    /** 被点击列的字段 */
+    readonly field: unknown;
+    /** 点击后的排序方向：`asc` → `desc` → `normal` 轮转 */
+    readonly order: unknown;
+}
+/**
+ * 同步列头排序图标，不执行客户端排序
+ *
+ * @param table - 目标表格实例
+ * @param click - `sort_click` 事件参数
+ *
+ * @remarks
+ * 业务层在 `sort_click` 里返回 `false` 阻止 VTable 客户端排序、改由查询重排；
+ * 但返回 `false` 也让 VTable 跳过记录排序状态，图标停在 normal，下一次点击又从 asc 起，
+ * 永远到不了 desc / normal。这里补记状态（`executeSort = false`），图标与轮转才正常。
+ *
+ * @example
+ * ```typescript
+ * table.on('sort_click', args => {
+ *   emitSort(args);
+ *   syncHeaderSortIcon(table, args);
+ *   return false;
+ * });
+ * ```
+ */
+export declare function syncHeaderSortIcon(table: VTable.ListTable, click: HeaderSortClick): void;
+/**
+ * 收集拖拽排序后的非只读行 ID 列表
+ *
+ * @param table 目标表格实例
+ * @param idField 记录 ID 字段名
+ * @returns 按当前行顺序排列的非只读行 ID
+ */
 export declare function collectReorderedIds(table: VTable.ListTable, idField: string): string[];
 /**
  * 更新表格数据并恢复列宽（按 field 名匹配，容忍列增删）
  *
+ * @param table 目标表格实例
+ * @param records 更新后的行数据
  * @param prevColumns 更新前的列定义，用于读取旧列宽
  * @param newColumns 更新后的列定义
  */

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

@@ -1 +1 @@
-{"version":3,"file":"table-operations.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAgB1E;AAED,yBAAyB;AACzB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWtF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,OAAO,EAAE,iBAAiB,EAAE,EAC5B,WAAW,EAAE,2BAA2B,CAAC,SAAS,CAAC,EACnD,UAAU,EAAE,2BAA2B,CAAC,SAAS,CAAC,GACjD,IAAI,CAmBN"}
+{"version":3,"file":"table-operations.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK1D;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAgB1E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAIxF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWtF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,OAAO,EAAE,iBAAiB,EAAE,EAC5B,WAAW,EAAE,2BAA2B,CAAC,SAAS,CAAC,EACnD,UAAU,EAAE,2BAA2B,CAAC,SAAS,CAAC,GACjD,IAAI,CAmBN"}