@aiao/rxdb-model 0.0.19 → 0.0.28

package/dist/entity-list/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 实体列表共享类型。
+ *
+ * @module entity-list/types
+ */
+/**
+ * RxDB 实体实例（用于 CRUD 操作）。
+ *
+ * 三端组件库（Angular / React / Vue）此前各自内联了同形副本，现收敛到核心包
+ * 统一透传：Angular / Vue 经包根 `export *` 链、React 经 entity-list 模块显式再导出。
+ */
+export type EntityInstance = {
+    [key: string]: unknown;
+    readonly id: string;
+    save(): Promise<void>;
+    remove(): Promise<void>;
+};
+/**
+ * 筛选查询结构（与用户筛选条件做 AND 合并）。
+ */
+export type FilterQuery = {
+    combinator: 'and' | 'or';
+    rules: unknown[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/entity-list/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/entity-list/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC"}

package/dist/entity-table/columns/build-editable-columns.d.ts

@@ -1,20 +1,38 @@
-import { EntityMetadata } from '../../../packages/rxdb/src/index.ts';
+import { EntityMetadata, EntityPropertyMetadata } from '@aiao/rxdb';
 import { ColumnDefine } from '@visactor/vtable/es/ts-types/index.js';
 import { RelatedEntityItem } from '../../entity-form/interfaces.js';
+import { KVSchemaEntry } from './column-utils.js';
 /** 仅展示（不可编辑）的系统字段 */
 export declare const DISPLAY_ONLY_FIELDS: Set<string>;
 /** 跳过（不显示为独立列）的系统字段 */
 export declare const SKIP_FIELDS: Set<string>;
 /** 关联实体候选 provider 工厂：根据外键字段和关联实体名返回 provider 函数 */
 export type RelatedItemsProviderFactory = (fkField: string, relatedEntityName: string) => (() => RelatedEntityItem[]) | undefined;
+/** 构建可编辑列的选项 */
 export interface BuildEditableColumnsOptions {
+    /** 关联实体候选 provider 工厂（按外键字段与关联实体名返回 provider） */
     relatedItemsProviderFactory?: RelatedItemsProviderFactory;
+    /** 操作列标题（默认「操作」） */
     actionsTitle?: string;
+    /** 删除按钮文案（默认「删除」） */
     deleteLabel?: string;
+    /** 查看按钮文案（默认「查看」） */
     viewLabel?: string;
+    /** 创建时间列标题（默认「创建时间」） */
     createdAtTitle?: string;
+    /** 更新时间列标题（默认「更新时间」） */
     updatedAtTitle?: string;
 }
+/**
+ * 将实体属性类型归一化为 keyValue Schema 值类型
+ *
+ * 仅 string / enum / uuid / number / integer / boolean / date 可直接映射，
+ * 其余类型返回 undefined。
+ *
+ * @param type 实体属性类型（PropertyType 枚举值）
+ * @returns 对应的 KVSchemaEntry 值类型；无法映射时返回 undefined
+ */
+export declare function normalizeKVSchemaEntryType(type: EntityPropertyMetadata['type']): KVSchemaEntry['type'] | undefined;
 /**
  * 根据 EntityMetadata 构建可编辑的 VTable 列定义
  *
@@ -24,7 +42,11 @@ export interface BuildEditableColumnsOptions {
  * 3. 计算属性列
  * 4. 外键关系列
  * 5. createdAt / updatedAt 系统时间列
- * 6. 操作列（查看 + 删除）
+ * 6. 操作列（查看 + 删除；删除按实体 `permissions.delete` 派生，见 {@link deriveEntityCapabilities}）
+ *
+ * @param metadata 实体元数据
+ * @param options 可选构建选项
+ * @returns 可编辑的列定义数组
  */
 export declare function buildEditableColumns(metadata: EntityMetadata, options?: BuildEditableColumnsOptions): ColumnDefine[];
 //# sourceMappingURL=build-editable-columns.d.ts.map

package/dist/entity-table/columns/build-editable-columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-editable-columns.d.ts","sourceRoot":"","sources":["../../../src/entity-table/columns/build-editable-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkD,MAAM,YAAY,CAAC;AAEjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,qBAAqB;AACrB,eAAO,MAAM,mBAAmB,aAAsC,CAAC;AAEvE,uBAAuB;AACvB,eAAO,MAAM,WAAW,aAA4C,CAAC;AAErE,oDAAoD;AACpD,MAAM,MAAM,2BAA2B,GAAG,CACxC,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,KACtB,CAAC,MAAM,iBAAiB,EAAE,CAAC,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,2BAA2B;IAC1C,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,2BAAgC,GACxC,YAAY,EAAE,CA+EhB"}
+{"version":3,"file":"build-editable-columns.d.ts","sourceRoot":"","sources":["../../../src/entity-table/columns/build-editable-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EAIvB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAuD,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5G,qBAAqB;AACrB,eAAO,MAAM,mBAAmB,aAAsC,CAAC;AAEvE,uBAAuB;AACvB,eAAO,MAAM,WAAW,aAA4C,CAAC;AAErE,oDAAoD;AACpD,MAAM,MAAM,2BAA2B,GAAG,CACxC,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,KACtB,CAAC,MAAM,iBAAiB,EAAE,CAAC,GAAG,SAAS,CAAC;AAE7C,gBAAgB;AAChB,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;IAC1D,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAiBlH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,2BAAgC,GACxC,YAAY,EAAE,CAuEhB"}

package/dist/entity-table/columns/column-utils.d.ts

@@ -1,3 +1,4 @@
+import { FieldFormat, FieldOptions } from '@aiao/rxdb';
 import { ColumnDefine, StylePropertyFunctionArg } from '@visactor/vtable/es/ts-types/index.js';
 import { RelatedEntityItem } from '../../entity-form/interfaces.js';
 import { EnumItem } from '../editors/enum-editor.js';
@@ -7,7 +8,7 @@ export declare const DELETE_COLOR = "var(--entity-table-delete, #ef4444)";
  * 实体属性类型字符串字面量
  * 与 `@aiao/rxdb` 的 `PropertyType` 枚举值一一对应，另扩展关系类型与计算属性
  */
-export type PropertyTypeString = 'uuid' | 'string' | 'enum' | 'number' | 'integer' | 'boolean' | 'date' | 'stringArray' | 'numberArray' | 'keyValue' | 'json'
+export type PropertyTypeString = 'uuid' | 'string' | 'enum' | 'number' | 'integer' | 'bigint' | 'boolean' | 'date' | 'binary' | 'stringArray' | 'numberArray' | 'keyValue' | 'json'
 /** 一对一关系：存外键 ID，显示关联实体 displayName，可搜索下拉编辑 */
  | 'oneToOne'
 /** 多对一关系：存外键 ID，显示关联实体 displayName，可搜索下拉编辑 */
@@ -38,6 +39,14 @@ export interface PropertyColumnConfig {
     sort?: boolean;
     /** keyValue 属性 Schema—定义允许的键以及对应的值类型 */
     keyValueSchema?: Record<string, KVSchemaEntry>;
+    /**
+     * 字段语义标注（决定展示形态与编辑器选择，不改变运行时值类型）
+     */
+    format?: FieldFormat;
+    /**
+     * 枚举/多选值的展示元数据（label / color / disabled），键是 `enum` 的子集
+     */
+    options?: FieldOptions;
     /**
      * 关联实体候选列表（oneToOne / manyToOne 类型使用）
      *
@@ -64,12 +73,20 @@ export interface KVSchemaEntry {
     /** 是否可以为 null */
     nullable?: boolean;
 }
-/** 格式化日期值为本地字符串 */
+/**
+ * 格式化日期值为本地字符串
+ *
+ * @param v 待格式化的日期值
+ * @returns 本地化日期字符串
+ */
 export declare function formatDateValue(v: unknown): string;
 /**
  * 构建编辑器函数：非只读行使用指定编辑器名称，只读行返回 undefined
  *
  * 用于 ColumnDefine.editor，以便在行级别区分只读/可编辑状态。
+ *
+ * @param editorName 非只读行使用的编辑器名称
+ * @returns 可挂载到 ColumnDefine.editor 的编辑器回调
  */
 export declare function makeEditorForReadonly(editorName: string): ColumnDefine['editor'];
 /** 各属性类型的默认列宽及最小/最大宽度 */
@@ -90,34 +107,83 @@ export declare const DEFAULT_COLUMN_SIZES: Record<string, {
  * - numberArray → 逗号分隔显示 + number-tags-editor 数字标签输入（非只读时）
  * - keyValue → JSON 字符串显示 + key-value-editor 键值对编辑器（非只读时）
  * - json → JSON 字符串显示 + json-editor 文本区域（非只读时）
+ *
+ * @param config 属性列配置
+ * @returns 构建好的 VTable ColumnDefine
  */
 export declare function buildPropertyColumn(config: PropertyColumnConfig): ColumnDefine;
 /**
  * 将 input-editor 输入的字符串值解析回属性原始类型
  *
  * 在 cellChanged 事件处理器中调用此函数，将用户输入转成正确的 JS 类型后再保存。
+ *
+ * @param type 属性类型
+ * @param raw 编辑器输入的原始值
+ * @returns 解析后的属性值
  */
 export declare function parsePropertyColumnValue(type: PropertyTypeString | string, raw: unknown): unknown;
 type ColumnRecord = Record<string, unknown> & {
     _readonly?: boolean;
     _isAddRow?: boolean;
 };
-/** 通过 VTable 回调参数安全获取当前行记录 */
+/**
+ * 通过 VTable 回调参数安全获取当前行记录
+ *
+ * @param args VTable 回调参数
+ * @returns 当前行记录；无法获取时返回 undefined
+ */
 export declare const getCellRecord: (args: StylePropertyFunctionArg) => ColumnRecord | undefined;
+/**
+ * switch 禁用状态判断回调
+ *
+ * @param args VTable 回调参数（用于获取当前行记录）
+ * @returns true 表示禁用 switch
+ */
 export type SwitchDisableCallback = (args: StylePropertyFunctionArg) => boolean;
-/** 检查记录是否为只读行 */
+/**
+ * 检查记录是否为只读行
+ *
+ * @param record 待检查的行记录
+ * @returns 是否为只读行
+ */
 export declare const isReadonly: (record: unknown) => boolean;
-/** 检查记录是否为只读行或新增模板行 */
+/**
+ * 检查记录是否为只读行或新增模板行
+ *
+ * @param record 待检查的行记录
+ * @returns 是否为只读行或新增模板行
+ */
 export declare const isReadonlyOrAddRow: (record: unknown) => boolean;
-/** 生成查看按钮的图标选项（仅 SVG，避免 text 撑满剩余宽度） */
+/**
+ * 生成查看按钮的图标选项（仅 SVG，避免 text 撑满剩余宽度）
+ *
+ * @returns 图标选项数组
+ */
 export declare function makeViewIcons(): unknown[];
-/** 生成删除按钮的图标选项 */
+/**
+ * 生成删除按钮的图标选项（SVG 图标 + 文字标签）
+ *
+ * @param label 删除按钮文字
+ * @returns 图标选项数组
+ */
 export declare function makeDeleteIcons(label: string): unknown[];
 /** 不可编辑的行：禁用 editor */
 export declare const disabledEditorForReadonly: ColumnDefine["editor"];
 /** 禁用 switch：只读行不可操作 */
 export declare const switchDisabledForReadonly: SwitchDisableCallback;
-/** 操作列：可选包含查看（view）和删除按钮，只读行不显示操作 */
-export declare function actionsColumn(title: string, deleteLabel: string, viewLabel?: string): ColumnDefine;
+/**
+ * 判定某一行能否删除；`actionsColumn` 逐行调用
+ */
+export type RecordDeletePredicate = (record: Readonly<Record<string, unknown>>) => boolean;
+/**
+ * 操作列：可选包含查看（view）和删除按钮
+ *
+ * @param title 列标题
+ * @param deleteLabel 删除按钮文案
+ * @param canDelete 逐行判定是否出删除按钮；与行是否只读无关（`update: 'system'` 的实体行只读仍可删）
+ * @param viewLabel 查看按钮文案（可选，不传则只显示删除按钮，不可删的行因此无图标）
+ * @returns 操作列定义
+ */
+export declare function actionsColumn(title: string, deleteLabel: string, canDelete: RecordDeletePredicate, viewLabel?: string): ColumnDefine;
 export {};
 //# sourceMappingURL=column-utils.d.ts.map

package/dist/entity-table/columns/column-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-utils.d.ts","sourceRoot":"","sources":["../../../src/entity-table/columns/column-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"column-utils.d.ts","sourceRoot":"","sources":["../../../src/entity-table/columns/column-utils.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,23 @@
+import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+/**
+ * 颜色编辑器
+ *
+ * 在单元格上方弹出原生取色器 + 十六进制文本输入，两者双向同步。
+ * Enter / Tab 提交；Escape 恢复原值；点击外部提交，提交失败时恢复原值。
+ */
+export declare class ColorEditor implements IEditor<unknown> {
+    #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
+    readonly editorType = "color-editor";
+    /** 创建并显示取色器、文本输入与错误提示浮层 */
+    onStart(ctx: EditContext<unknown>): void;
+    /** 返回当前颜色值，空值为 null */
+    getValue(): string | null;
+    /** 移除输入框与提示浮层，解绑全局点击事件 */
+    onEnd(): void;
+    /** 判断目标元素是否属于本编辑器 */
+    isEditorElement(el: HTMLElement | EventTarget): boolean;
+    /** 按新的单元格矩形重新定位取色器、输入框与提示浮层 */
+    adjustPosition(rect: RectProps): void;
+}
+//# sourceMappingURL=color-editor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"color-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/color-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAehF;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,OAAO,CAAC,OAAO,CAAC;;IAUlD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,kBAAkB;IAErC,2BAA2B;IAC3B,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAyJxC,uBAAuB;IACvB,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAIb,qBAAqB;IACrB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;IAKvD,+BAA+B;IAC/B,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAiCtC"}

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

@@ -10,10 +10,15 @@ import { EditContext, IEditor } from '@visactor/vtable-editors';
  */
 export declare class DateEditor implements IEditor<unknown> {
     #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType = "date-editor";
+    /** 打开编辑器：构建浮层面板并初始化原生 datetime-local 输入 */
     onStart(ctx: EditContext<unknown>): void;
+    /** 返回当前选择的日期值 */
     getValue(): Date | null;
+    /** 结束编辑：清理浮层面板与事件监听 */
     onEnd(): void;
+    /** 判断目标元素是否属于编辑器浮层 */
     isEditorElement(el: HTMLElement | EventTarget): boolean;
 }
 //# sourceMappingURL=date-editor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"date-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/date-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKrE;;;;;;;;GAQG;AACH,qBAAa,UAAW,YAAW,OAAO,CAAC,OAAO,CAAC;;IAOjD,QAAQ,CAAC,UAAU,iBAAiB;IAEpC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAuGxC,QAAQ,IAAI,IAAI,GAAG,IAAI;IAIvB,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;CA6BxD"}
+{"version":3,"file":"date-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/date-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKrE;;;;;;;;GAQG;AACH,qBAAa,UAAW,YAAW,OAAO,CAAC,OAAO,CAAC;;IAOjD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,iBAAiB;IAEpC,2CAA2C;IAC3C,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAuGxC,iBAAiB;IACjB,QAAQ,IAAI,IAAI,GAAG,IAAI;IAIvB,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAIb,sBAAsB;IACtB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;CA6BxD"}

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

@@ -10,6 +10,8 @@ export interface EnumItem {
     icon?: IconData;
     /** 图标描边颜色（可选，配合 icon 使用） */
     color?: string;
+    /** 是否禁用（只影响展示与选择，不改变枚举合法性） */
+    disabled?: boolean;
 }
 /**
  * 枚举下拉选择编辑器
@@ -26,9 +28,17 @@ export declare class EnumEditor extends GlobalOverlayEditor {
     #private;
     protected get initialFocusIndex(): number;
     protected get itemCount(): number;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType = "enum-editor";
+    /**
+     * 创建枚举编辑器
+     *
+     * @param presetItems 预设选项；不传时在 onStart 中从列定义 menuList 读取
+     */
     constructor(presetItems?: EnumItem[]);
+    /** 初始化编辑：解析原始值并加载可选项（预设选项优先，其次列定义 menuList） */
     onStart(ctx: Parameters<GlobalOverlayEditor['onStart']>[0]): void;
+    /** 返回当前选中的枚举值 */
     getValue(): string;
     protected onDeleteKey(): void;
     protected buildRows(panel: HTMLDivElement): void;

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

@@ -1 +1 @@
-{"version":3,"file":"enum-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/enum-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjE,aAAa;AACb,MAAM,WAAW,QAAQ;IACvB,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,mBAAmB;;IAKjD,SAAS,KAAK,iBAAiB,IAAI,MAAM,CAExC;IAED,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAED,QAAQ,CAAC,UAAU,iBAAiB;gBAExB,WAAW,CAAC,EAAE,QAAQ,EAAE;IAK3B,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IA4BjE,QAAQ,IAAI,MAAM;cAIR,WAAW,IAAI,IAAI;IAQtC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IA8ChD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOvC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CASzD"}
+{"version":3,"file":"enum-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/enum-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEpE,aAAa;AACb,MAAM,WAAW,QAAQ;IACvB,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAOD;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,mBAAmB;;IAKjD,SAAS,KAAK,iBAAiB,IAAI,MAAM,CAExC;IAED,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAED,uCAAuC;IACvC,QAAQ,CAAC,UAAU,iBAAiB;IAEpC;;;;OAIG;gBACS,WAAW,CAAC,EAAE,QAAQ,EAAE;IAKpC,+CAA+C;IACtC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IA4B1E,iBAAiB;IACR,QAAQ,IAAI,MAAM;cAIR,WAAW,IAAI,IAAI;IAQtC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAiDhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOvC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CASzD"}

package/dist/entity-table/editors/global-overlay-editor.d.ts

@@ -12,11 +12,27 @@ export declare const DAISY_COLORS: {
     readonly selectedBg: "color-mix(in srgb, var(--color-primary) 15%, transparent)";
     readonly focusBg: "color-mix(in srgb, var(--color-primary) 30%, var(--color-base-100))";
 };
-/** 延迟执行编辑器初始化（注册外部点击监听 + 聚焦），避免 VTable 事件干扰 */
+/**
+ * 延迟执行编辑器初始化（注册外部点击监听 + 聚焦），避免 VTable 事件干扰
+ *
+ * @param fn 延迟执行的初始化回调
+ */
 export declare function scheduleEditorSetup(fn: () => void): void;
-/** 编辑结束后将焦点还给 VTable root element（tabindex=0 的 .vtable div = ctx.container = table.getElement()），使方向键导航继续工作 */
+/**
+ * 编辑结束后将焦点还给 VTable root element（tabindex=0 的 .vtable div = ctx.container = table.getElement()），使方向键导航继续工作
+ *
+ * @param container VTable 容器元素
+ */
 export declare function refocusTable(container: HTMLElement | null | undefined): void;
-/** 将浮层面板定位到单元格下方（空间不足时翻转到上方） */
+/**
+ * 将浮层面板定位到单元格下方（空间不足时翻转到上方）
+ *
+ * @param panel 浮层面板元素
+ * @param rect 单元格相对 VTable 容器的位置矩形
+ * @param container VTable 容器（用于换算页面绝对坐标）
+ * @param estimatedHeight 面板估算高度（用于判断是否翻转到上方）
+ * @param options 可选布局选项（maxRight 面板最大右边界、minWidth 面板最小宽度）
+ */
 export declare function positionOverlayPanel(panel: HTMLElement, rect: {
     left: number;
     top: number;
@@ -55,12 +71,19 @@ export declare abstract class GlobalOverlayEditor implements IEditor<string> {
     protected abstract get initialFocusIndex(): number;
     protected abstract get itemCount(): number;
     protected get focusedIndex(): number;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名，子类赋值） */
     abstract readonly editorType: string;
+    /** 构造浮层编辑器基类（子类在 onStart 中构建面板） */
     constructor();
+    /** 打开浮层：渲染行、定位面板并注册全局鼠标/键盘监听 */
     onStart(ctx: EditContext<string>): void;
+    /** 关闭浮层：移除面板并注销全局鼠标/键盘监听 */
     onEnd(): void;
+    /** 返回编辑结果值 */
     abstract getValue(): string;
+    /** 判断目标元素是否属于浮层面板 */
     isEditorElement(target: HTMLElement): boolean;
+    /** 根据新的单元格矩形重新定位浮层面板 */
     adjustPosition(rect: RectProps): void;
     protected abstract buildRows(panel: HTMLDivElement): void;
     protected abstract onRowClick(idx: number): void;

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

@@ -1 +1 @@
-{"version":3,"file":"global-overlay-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/global-overlay-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEhF,qCAAqC;AACrC,eAAO,MAAM,YAAY;;;;;;;;;;;CAWf,CAAC;AAKX,+CAA+C;AAC/C,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAExD;AAED,+GAA+G;AAC/G,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE5E;AAED,gCAAgC;AAChC,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACpE,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACzC,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,IAAI,CAkBN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,mBAAoB,YAAW,OAAO,CAAC,MAAM,CAAC;;IAQlE,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAQ;IAC/C,SAAS,CAAC,KAAK,EAAE;QAAE,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAQ;IACzF,SAAS,CAAC,OAAO,SAAK;IACtB,SAAS,CAAC,OAAO,SAAK;IAEtB,SAAS,CAAC,QAAQ,KAAK,iBAAiB,IAAI,MAAM,CAAC;IACnD,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC;IAE3C,SAAS,KAAK,YAAY,IAAI,MAAM,CAEnC;IAED,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;;IAuCrC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAkCvC,KAAK,IAAI,IAAI;IAUb,QAAQ,CAAC,QAAQ,IAAI,MAAM;IAE3B,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI7C,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAIrC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IACzD,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAChD,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAEjE,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOvC,SAAS,CAAC,WAAW,IAAI,IAAI;IAI7B,SAAS,CAAC,KAAK,IAAI,IAAI;IAKvB,SAAS,CAAC,YAAY,IAAI,IAAI;CA0C/B"}
+{"version":3,"file":"global-overlay-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/global-overlay-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEhF,qCAAqC;AACrC,eAAO,MAAM,YAAY;;;;;;;;;;;CAWf,CAAC;AAKX;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAExD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACpE,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACzC,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,IAAI,CAkBN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,mBAAoB,YAAW,OAAO,CAAC,MAAM,CAAC;;IAQlE,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAQ;IAC/C,SAAS,CAAC,KAAK,EAAE;QAAE,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAQ;IACzF,SAAS,CAAC,OAAO,SAAK;IACtB,SAAS,CAAC,OAAO,SAAK;IAEtB,SAAS,CAAC,QAAQ,KAAK,iBAAiB,IAAI,MAAM,CAAC;IACnD,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC;IAE3C,SAAS,KAAK,YAAY,IAAI,MAAM,CAEnC;IAED,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAErC,mCAAmC;;IAsCnC,gCAAgC;IAChC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAkCvC,4BAA4B;IAC5B,KAAK,IAAI,IAAI;IAUb,cAAc;IACd,QAAQ,CAAC,QAAQ,IAAI,MAAM;IAE3B,qBAAqB;IACrB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI7C,wBAAwB;IACxB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAIrC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IACzD,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAChD,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAEjE,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIhD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOvC,SAAS,CAAC,WAAW,IAAI,IAAI;IAI7B,SAAS,CAAC,KAAK,IAAI,IAAI;IAKvB,SAAS,CAAC,YAAY,IAAI,IAAI;CA0C/B"}

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

@@ -5,9 +5,13 @@ import { IconData } from './lucide-svg.js';
  * @deprecated 请改用 `EnumItem`，`EnumEditor` 已原生支持 icon 和 color 字段。
  */
 export interface IconLabeledItem {
+    /** 显示文本 */
     text: string;
+    /** 存储值 */
     value: string;
+    /** Lucide 图标数据（可选，配合 color 使用） */
     icon?: IconData;
+    /** 图标描边颜色（可选，配合 icon 使用） */
     color?: string;
 }
 /**
@@ -23,11 +27,19 @@ export declare class IconListEditor extends GlobalOverlayEditor {
     #private;
     protected get initialFocusIndex(): number;
     protected get itemCount(): number;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType = "icon-list";
+    /**
+     * 创建图标列表编辑器
+     *
+     * @param config 编辑器配置（values 为条目列表）
+     */
     constructor(config: {
         values: IconLabeledItem[];
     });
+    /** 初始化编辑：解析当前值；不在候选列表中时回退到单元格原始值 */
     onStart(ctx: Parameters<GlobalOverlayEditor['onStart']>[0]): void;
+    /** 返回当前选中的条目值 */
     getValue(): string;
     protected onDeleteKey(): void;
     protected buildRows(panel: HTMLDivElement): void;

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

@@ -1 +1 @@
-{"version":3,"file":"icon-list-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/icon-list-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,mBAAmB;;IAIrD,SAAS,KAAK,iBAAiB,IAAI,MAAM,CAExC;IAED,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAED,QAAQ,CAAC,UAAU,eAAe;gBAEtB,MAAM,EAAE;QAAE,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE;IAKxC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAajE,QAAQ,IAAI,MAAM;cAIR,WAAW,IAAI,IAAI;IAKtC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAqChD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOvC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CASzD"}
+{"version":3,"file":"icon-list-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/icon-list-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,mBAAmB;;IAIrD,SAAS,KAAK,iBAAiB,IAAI,MAAM,CAExC;IAED,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAED,uCAAuC;IACvC,QAAQ,CAAC,UAAU,eAAe;IAElC;;;;OAIG;gBACS,MAAM,EAAE;QAAE,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE;IAKjD,oCAAoC;IAC3B,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAa1E,iBAAiB;IACR,QAAQ,IAAI,MAAM;cAIR,WAAW,IAAI,IAAI;IAKtC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAqChD,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOvC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CASzD"}

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

@@ -10,10 +10,15 @@ import { EditContext, IEditor } from '@visactor/vtable-editors';
  */
 export declare class JsonEditor implements IEditor<unknown> {
     #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType = "json-editor";
+    /** 打开编辑器：构建浮层 textarea 面板并初始化原始值 */
     onStart(ctx: EditContext<unknown>): void;
+    /** 返回当前编辑值 */
     getValue(): unknown;
+    /** 结束编辑：清理浮层面板与事件监听 */
     onEnd(): void;
+    /** 判断目标元素是否属于编辑器浮层 */
     isEditorElement(el: HTMLElement | EventTarget): boolean;
 }
 //# sourceMappingURL=json-editor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"json-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/json-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKrE;;;;;;;;GAQG;AACH,qBAAa,UAAW,YAAW,OAAO,CAAC,OAAO,CAAC;;IASjD,QAAQ,CAAC,UAAU,iBAAiB;IAEpC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAiIxC,QAAQ,IAAI,OAAO;IAInB,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;CA4CxD"}
+{"version":3,"file":"json-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/json-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKrE;;;;;;;;GAQG;AACH,qBAAa,UAAW,YAAW,OAAO,CAAC,OAAO,CAAC;;IASjD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,iBAAiB;IAEpC,oCAAoC;IACpC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IAiIxC,cAAc;IACd,QAAQ,IAAI,OAAO;IAInB,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAIb,sBAAsB;IACtB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;CA4CxD"}

package/dist/entity-table/editors/key-value-editor.d.ts

@@ -1,7 +1,7 @@
 import { EditContext, IEditor } from '@visactor/vtable-editors';
 import { KVSchemaEntry } from '../columns/column-utils.js';
 /**
- * KeyValue (Record<string, unknown>) editor — Schema mode only
+ * KeyValue（`Record<string, unknown>`）editor — Schema mode only
  *
  * - Key is always a dropdown derived from schema definition
  * - Value input type adapts to the key's schema type
@@ -11,11 +11,21 @@ import { KVSchemaEntry } from '../columns/column-utils.js';
  */
 export declare class KeyValueEditor implements IEditor<unknown> {
     #private;
+    /** VTable 编辑器类型标识（注册到 VTable 的编辑器名） */
     readonly editorType = "key-value-editor";
+    /**
+     * 创建 KeyValue 编辑器
+     *
+     * @param schema 可选的键 Schema 定义；不传或为空时进入自由模式
+     */
     constructor(schema?: Record<string, KVSchemaEntry> | null);
+    /** 打开编辑器：构建键值对编辑浮层并按初始值 / Schema 填充行 */
     onStart(ctx: EditContext<unknown>): void;
+    /** 返回当前编辑的键值对象 */
     getValue(): Record<string, unknown>;
+    /** 结束编辑：中止未决监听并清理浮层 */
     onEnd(): void;
+    /** 判断目标元素是否属于编辑器浮层 */
     isEditorElement(el: HTMLElement | EventTarget): boolean;
 }
 //# sourceMappingURL=key-value-editor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"key-value-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/key-value-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAahE;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,OAAO,CAAC,OAAO,CAAC;;IAYrD,QAAQ,CAAC,UAAU,sBAAsB;gBAE7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IAIzD,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IA2JxC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInC,KAAK,IAAI,IAAI;IAIb,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;CAoWxD"}
+{"version":3,"file":"key-value-editor.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/key-value-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAahE;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,OAAO,CAAC,OAAO,CAAC;;IAYrD,uCAAuC;IACvC,QAAQ,CAAC,UAAU,sBAAsB;IAEzC;;;;OAIG;gBACS,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IAIzD,wCAAwC;IACxC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI;IA2JxC,kBAAkB;IAClB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInC,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAIb,sBAAsB;IACtB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO;CA4XxD"}

package/dist/entity-table/editors/lucide-svg.d.ts

@@ -1,11 +1,12 @@
 /** Lucide 图标数据 — [tagName, attributes] 元组数组 */
 export type IconData = readonly (readonly [string, Record<string, unknown>])[];
 /**
- * 将 `LucideIconData` 转为内联 SVG HTML 字符串
+ * 将 `LucideIconData` 转为内联 SVG 元素（DOM API 构造，免疫标记注入）
  *
  * @param icon - lucide 图标数据
  * @param color - stroke 颜色（不合法时回退 currentColor）
  * @param size - 宽高像素，默认 13
+ * @returns 内联 SVG 元素
  */
-export declare function lucideToSvgHtml(icon: IconData, color: string, size?: number): string;
+export declare function lucideToSvgElement(icon: IconData, color: string, size?: number): SVGSVGElement;
 //# sourceMappingURL=lucide-svg.d.ts.map

package/dist/entity-table/editors/lucide-svg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lucide-svg.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/lucide-svg.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAwC/E;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAiBhF"}
+{"version":3,"file":"lucide-svg.d.ts","sourceRoot":"","sources":["../../../src/entity-table/editors/lucide-svg.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AA6C/E;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,aAAa,CAuB1F"}

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';
+/** 数字编辑器的可选行为配置 */
+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