@aiao/rxdb-model 0.0.18 → 0.0.26

package/dist/entity-list/manual-order-list.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview 实体列表的手动排序：拖拽启用谓词、默认排序与落库协调（US-028 阶段 B）
+ *
+ * 列表只在「看到的行就是一条完整排序域」时允许拖拽：邻居才是真邻居，
+ * `Repository.reorder()` 才能按 `{ prevId, nextId }` 落到用户看到的位置。
+ * 三端 `EntityList` 共用这一份判定与协调，框架层只负责收集状态和接线。
+ */
+import { type EntityMetadata, type OrderBy } from '@aiao/rxdb';
+import type { RowMoveEvent } from '../entity-table/vtable/table-row-move.js';
+/** 列表排序判定需要的实体元数据 */
+export type ManualOrderListMetadata = Pick<EntityMetadata, 'manualOrder' | 'propertyMap'>;
+/** 列表的固定查询（详情页关系标签传入），结构同查询构建器的规则组 */
+export interface ListFixedQuery {
+    /** 规则组合方式 */
+    readonly combinator: 'and' | 'or';
+    /** 规则；嵌套规则组视为不能钉住排序域 */
+    readonly rules: readonly unknown[];
+}
+/**
+ * 判定列表能否拖拽排序时用到的列表状态
+ */
+export interface ListReorderState {
+    /** 当前实体元数据；未注册实体为 `undefined` */
+    readonly metadata: ManualOrderListMetadata | undefined;
+    /** 列头排序状态；只有 `normal`（未按列排序）时显示的才是手动顺序 */
+    readonly sortOrder: 'asc' | 'desc' | 'normal';
+    /** 用户在筛选框里加了条件 */
+    readonly hasUserFilter: boolean;
+    /** 列表处于关联选择模式 */
+    readonly selectMode: boolean;
+    /** 外部传入的固定查询 */
+    readonly fixedQuery: ListFixedQuery | undefined;
+    /** 排序域已全部加载：没有下一页且不在加载中 */
+    readonly fullyLoaded: boolean;
+    /** 存在只读行（无编辑权限） */
+    readonly hasReadonlyRows: boolean;
+    /** 存在未落库的草稿行 */
+    readonly hasDrafts: boolean;
+    /** 存在未完成的单元格编辑写入 */
+    readonly hasPendingEdits: boolean;
+    /** 上一次拖拽的重排还没落定 */
+    readonly reorderPending: boolean;
+}
+/**
+ * 固定查询是否恰好钉住一条完整的排序域
+ *
+ * @param groupFields - 实体声明的分组字段
+ * @param fixedQuery - 列表的固定查询
+ * @returns 整表排序要求没有固定条件；分组排序要求只有对全部分组字段各一条等值（或 `null`）条件
+ */
+export declare function pinsSingleOrderDomain(groupFields: readonly string[], fixedQuery: ListFixedQuery | undefined): boolean;
+/**
+ * 实体列表当前是否允许拖拽排序
+ *
+ * @param state - 列表状态
+ * @returns 全部条件满足时为 `true`：手动排序实体、字符串主键、未按列排序、无用户筛选、非选择模式、
+ *   固定查询钉住一条完整排序域、已全部加载、没有只读行 / 草稿 / 未完成编辑 / 未落定的重排
+ *
+ * @example
+ * ```typescript
+ * const enabled = canReorderEntityList({ metadata, sortOrder: 'normal', fixedQuery, ...flags });
+ * ```
+ */
+export declare function canReorderEntityList(state: ListReorderState): boolean;
+/**
+ * 列表未按列排序时的游标排序
+ *
+ * @param metadata - 实体元数据；未注册实体为 `undefined`
+ * @returns 手动排序实体为 `[分组字段… asc, sortOrder asc, id asc]`，其余为 `[id desc]`
+ */
+export declare function defaultListOrderBy(metadata: Pick<EntityMetadata, 'manualOrder'> | undefined): OrderBy[];
+/**
+ * 行拖放落库时与界面交互的钩子
+ */
+export interface RowMoveCommitHooks {
+    /** 放下这一刻列表是否允许拖拽排序（{@link canReorderEntityList} 的结论） */
+    readonly enabled: boolean;
+    /** 落库重排，通常是 `repository.reorder(move.id, { prevId, nextId })` */
+    reorder(move: RowMoveEvent): Promise<unknown>;
+    /** 把表格行恢复成最近一次已提交的顺序 */
+    restore(): void;
+    /** 重排进行中状态变化 */
+    setPending(pending: boolean): void;
+    /** 显示（或用 `null` 清除）落库错误 */
+    setError(error: unknown): void;
+}
+/**
+ * 协调一次行拖放的落库
+ *
+ * @param move - 表格读出的拖放结果
+ * @param hooks - 界面钩子
+ * @returns 落库成功为 `true`；不允许拖拽或落库失败为 `false`，此时表格已恢复原顺序
+ *
+ * @remarks
+ * 不允许时零写入，直接恢复表格（程序触发的拖放事件同样被拒）。成功后不改表格，
+ * 由活查询按数据库重查的结果刷新；失败时显式恢复，下一次拖拽照常可用。
+ */
+export declare function commitRowMove(move: RowMoveEvent, hooks: RowMoveCommitHooks): Promise<boolean>;
+//# sourceMappingURL=manual-order-list.d.ts.map

package/dist/entity-list/manual-order-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-order-list.d.ts","sourceRoot":"","sources":["../../src/entity-list/manual-order-list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,OAAO,EAKb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAE7E,qBAAqB;AACrB,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,aAAa,CAAC,CAAC;AAE1F,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IAClC,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACvD,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC9C,kBAAkB;IAClB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,iBAAiB;IACjB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,gBAAgB;IAChB,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC;IAChD,2BAA2B;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,gBAAgB;IAChB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,oBAAoB;IACpB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,mBAAmB;IACnB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAUD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAQrH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CASrE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,GAAG,SAAS,GAAG,OAAO,EAAE,CAIvG;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,iEAAiE;IACjE,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,wBAAwB;IACxB,OAAO,IAAI,IAAI,CAAC;IAChB,gBAAgB;IAChB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBnG"}

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

@@ -1,20 +1,38 @@
-import { EntityMetadata } from '../../../packages/rxdb/src/index.ts';
-import { ColumnDefine } from '@visactor/vtable/es/ts-types/index.js';
-import { RelatedEntityItem } from '../../entity-form/interfaces.js';
+import type { EntityMetadata, EntityPropertyMetadata } from '@aiao/rxdb';
+import type { ColumnDefine } from '@visactor/vtable/es/ts-types/index.js';
+import type { RelatedEntityItem } from '../../entity-form/interfaces.js';
+import { type 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,13 +1,14 @@
-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';
+import type { FieldFormat, FieldOptions } from '@aiao/rxdb';
+import type { ColumnDefine, StylePropertyFunctionArg } from '@visactor/vtable/es/ts-types/index.js';
+import type { RelatedEntityItem } from '../../entity-form/interfaces.js';
+import { type EnumItem } from '../editors/enum-editor.js';
 /** 删除图标默认颜色 */
 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 type { 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

@@ -1,4 +1,4 @@
-import { EditContext, IEditor } from '@visactor/vtable-editors';
+import type { EditContext, IEditor } from '@visactor/vtable-editors';
 /**
  * 日期时间选择编辑器
  *
@@ -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

@@ -1,5 +1,5 @@
 import { GlobalOverlayEditor } from './global-overlay-editor.js';
-import { IconData } from './lucide-svg.js';
+import { type IconData } from './lucide-svg.js';
 /** 枚举选项配置 */
 export interface EnumItem {
     /** 存储值 */
@@ -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

@@ -1,4 +1,4 @@
-import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
 /** daisyUI v5 主题色引用（CSS 变量，主题自适应） */
 export declare const DAISY_COLORS: {
     readonly bg: "var(--color-base-100)";
@@ -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

@@ -1,13 +1,17 @@
 import { GlobalOverlayEditor } from './global-overlay-editor.js';
-import { IconData } from './lucide-svg.js';
+import { type 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

@@ -1,4 +1,4 @@
-import { EditContext, IEditor } from '@visactor/vtable-editors';
+import type { EditContext, IEditor } from '@visactor/vtable-editors';
 /**
  * JSON / KeyValue 编辑器
  *
@@ -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,5 +1,5 @@
-import { EditContext, IEditor } from '@visactor/vtable-editors';
-import { KVSchemaEntry } from '../columns/column-utils.js';
+import type { EditContext, IEditor } from '@visactor/vtable-editors';
+import type { KVSchemaEntry } from '../columns/column-utils.js';
 /**
  * KeyValue (Record<string, unknown>) editor — Schema mode only
  *
@@ -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"}