@aiao/rxdb-model 0.0.17

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aiao Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# rxdb-model
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build rxdb-model` to build the library.
+
+## Running unit tests
+
+Run `nx test rxdb-model` to execute the unit tests via [Vitest](https://vitest.dev/).

package/dist/entity-detail/detail-tabs.d.ts

@@ -0,0 +1,4 @@
+import { EntityMetadata } from '../../packages/rxdb/src/index.ts';
+import { DetailTab } from './interfaces.js';
+export declare function buildDetailTabs(metadata: EntityMetadata): DetailTab[];
+//# sourceMappingURL=detail-tabs.d.ts.map

package/dist/entity-detail/detail-tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-tabs.d.ts","sourceRoot":"","sources":["../../src/entity-detail/detail-tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,KAAK,EAAiB,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAEhF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,EAAE,CAgCrE"}

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

@@ -0,0 +1,3 @@
+export * from './detail-tabs.js';
+export * from './interfaces.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity-detail/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,23 @@
+import { RelationKind } from '../../packages/rxdb/src/index.ts';
+export type DetailTabType = 'form' | 'table';
+export interface DetailTabBase {
+    key: string;
+    label: string;
+    type: DetailTabType;
+}
+export interface DetailFormTab extends DetailTabBase {
+    type: 'form';
+}
+export interface DetailTableTab extends DetailTabBase {
+    type: 'table';
+    relationName: string;
+    relatedEntityName: string;
+    relatedNamespace: string;
+    relationKind: RelationKind;
+    /** ONE_TO_MANY: 关联实体中指向当前实体的外键字段，如 'ownerId' */
+    foreignKeyField?: string;
+    /** MANY_TO_MANY: 关联实体中指向当前实体的关系属性名，如 'orderItems' */
+    mappedProperty?: string;
+}
+export type DetailTab = DetailFormTab | DetailTableTab;
+//# sourceMappingURL=interfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/entity-detail/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,cAAc,CAAC"}

package/dist/entity-field.utils.d.ts

@@ -0,0 +1,24 @@
+import { EntityMetadata, PropertyType } from '../packages/rxdb/src/index.ts';
+export type EntityFieldType = PropertyType | `${PropertyType.boolean}` | `${PropertyType.date}` | `${PropertyType.enum}` | `${PropertyType.integer}` | `${PropertyType.number}` | `${PropertyType.string}` | `${PropertyType.uuid}` | `${PropertyType.numberArray}` | `${PropertyType.stringArray}` | `${PropertyType.keyValue}` | `${PropertyType.json}` | 'oneToOne' | 'manyToOne' | 'computed';
+export interface KeyValueSchemaEntry {
+    label?: string;
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'date';
+    required?: boolean;
+    nullable?: boolean;
+}
+export interface EntityFieldConfig {
+    field: string;
+    displayName: string;
+    type: EntityFieldType;
+    readonly?: boolean;
+    nullable?: boolean;
+    required?: boolean;
+    unique?: boolean;
+    enumValues?: readonly string[];
+    keyValueSchema?: Record<string, KeyValueSchemaEntry>;
+    relatedEntityName?: string;
+    relatedNamespace?: string;
+}
+export declare function extractEntityFields(metadata: EntityMetadata): EntityFieldConfig[];
+export declare function extractSystemFields(metadata: EntityMetadata): EntityFieldConfig[];
+//# sourceMappingURL=entity-field.utils.d.ts.map

package/dist/entity-field.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-field.utils.d.ts","sourceRoot":"","sources":["../src/entity-field.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EACL,YAAY,EAKb,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,GAAG,YAAY,CAAC,OAAO,EAAE,GACzB,GAAG,YAAY,CAAC,IAAI,EAAE,GACtB,GAAG,YAAY,CAAC,IAAI,EAAE,GACtB,GAAG,YAAY,CAAC,OAAO,EAAE,GACzB,GAAG,YAAY,CAAC,MAAM,EAAE,GACxB,GAAG,YAAY,CAAC,MAAM,EAAE,GACxB,GAAG,YAAY,CAAC,IAAI,EAAE,GACtB,GAAG,YAAY,CAAC,WAAW,EAAE,GAC7B,GAAG,YAAY,CAAC,WAAW,EAAE,GAC7B,GAAG,YAAY,CAAC,QAAQ,EAAE,GAC1B,GAAG,YAAY,CAAC,IAAI,EAAE,GACtB,UAAU,GACV,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA6CD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,iBAAiB,EAAE,CAsBjF;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,iBAAiB,EAAE,CAiBjF"}

package/dist/entity-form/form-data.d.ts

@@ -0,0 +1,5 @@
+import { EntityFormData, FormFieldConfig } from './interfaces.js';
+export declare function entityToFormData(entity: Record<string, unknown>, fields: FormFieldConfig[]): EntityFormData;
+export declare function formDataToEntityChanges(original: Record<string, unknown>, formData: EntityFormData, fields: FormFieldConfig[]): Record<string, unknown>;
+export declare function createDefaultFormData(fields: FormFieldConfig[]): EntityFormData;
+//# sourceMappingURL=form-data.d.ts.map

package/dist/entity-form/form-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-data.d.ts","sourceRoot":"","sources":["../../src/entity-form/form-data.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,cAAc,CAM3G;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,eAAe,EAAE,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,cAAc,CAqB/E"}

package/dist/entity-form/form-fields.d.ts

@@ -0,0 +1,6 @@
+import { EntityMetadata } from '../../packages/rxdb/src/index.ts';
+import { FormFieldConfig, FormMode } from './interfaces.js';
+export declare function buildFormFields(metadata: EntityMetadata, mode: FormMode): FormFieldConfig[];
+export declare function sortFormFields(fields: FormFieldConfig[]): FormFieldConfig[];
+export declare function filterVisibleFields(fields: FormFieldConfig[]): FormFieldConfig[];
+//# sourceMappingURL=form-fields.d.ts.map

package/dist/entity-form/form-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-fields.d.ts","sourceRoot":"","sources":["../../src/entity-form/form-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,eAAe,EAAE,CAY3F;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAE3E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAEhF"}

package/dist/entity-form/form-validation.d.ts

@@ -0,0 +1,5 @@
+import { FieldValidationError } from '../entity-value.utils.js';
+import { EntityFormData, FormFieldConfig, FormValidationResult } from './interfaces.js';
+export declare function validateField(field: FormFieldConfig, value: unknown): FieldValidationError | null;
+export declare function validateForm(fields: FormFieldConfig[], data: EntityFormData): FormValidationResult;
+//# sourceMappingURL=form-validation.d.ts.map

package/dist/entity-form/form-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-validation.d.ts","sourceRoot":"","sources":["../../src/entity-form/form-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAEjG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,oBAAoB,CAQlG"}

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

@@ -0,0 +1,5 @@
+export * from './form-data.js';
+export * from './form-fields.js';
+export * from './form-validation.js';
+export * from './interfaces.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity-form/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,45 @@
+import { EntityFieldType, KeyValueSchemaEntry } from '../entity-field.utils.js';
+export type FormMode = 'view' | 'edit' | 'create';
+export interface FormFieldConfig {
+    field: string;
+    displayName: string;
+    type: EntityFieldType;
+    readonly?: boolean;
+    nullable?: boolean;
+    required?: boolean;
+    unique?: boolean;
+    enumValues?: readonly string[];
+    keyValueSchema?: Record<string, KeyValueSchemaEntry>;
+    relatedEntityName?: string;
+    relatedNamespace?: string;
+    hidden?: boolean;
+    order?: number;
+    placeholder?: string;
+    helpText?: string;
+    span?: 1 | 2;
+}
+export interface FormFieldChangeEvent {
+    field: string;
+    type: EntityFieldType;
+    value: unknown;
+    previousValue: unknown;
+}
+export interface EntityFormData {
+    [field: string]: unknown;
+}
+export interface FormValidationResult {
+    valid: boolean;
+    errors: FormFieldValidationError[];
+}
+export interface FormFieldValidationError {
+    field: string;
+    message: string;
+}
+export interface RelatedEntityProvider {
+    (entityName: string, namespace?: string): RelatedEntityItem[];
+}
+export interface RelatedEntityItem {
+    id: string;
+    displayName: string;
+}
+//# sourceMappingURL=interfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/entity-form/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAErF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,wBAAwB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;CAC/D;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB"}

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

@@ -0,0 +1,30 @@
+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';
+/** 仅展示（不可编辑）的系统字段 */
+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 {
+    relatedItemsProviderFactory?: RelatedItemsProviderFactory;
+    actionsTitle?: string;
+    deleteLabel?: string;
+    viewLabel?: string;
+    createdAtTitle?: string;
+    updatedAtTitle?: string;
+}
+/**
+ * 根据 EntityMetadata 构建可编辑的 VTable 列定义
+ *
+ * 按照以下顺序排列列：
+ * 1. ID 列
+ * 2. 普通属性列（跳过 SKIP_FIELDS 和 DISPLAY_ONLY_FIELDS）
+ * 3. 计算属性列
+ * 4. 外键关系列
+ * 5. createdAt / updatedAt 系统时间列
+ * 6. 操作列（查看 + 删除）
+ */
+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

@@ -0,0 +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"}

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

@@ -0,0 +1,123 @@
+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';
+/** 删除图标默认颜色 */
+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'
+/** 一对一关系：存外键 ID，显示关联实体 displayName，可搜索下拉编辑 */
+ | 'oneToOne'
+/** 多对一关系：存外键 ID，显示关联实体 displayName，可搜索下拉编辑 */
+ | 'manyToOne'
+/** 计算属性：只读显示，无编辑器 */
+ | 'computed';
+/**
+ * 构建属性列所需的配置
+ */
+export interface PropertyColumnConfig {
+    /** 字段名（record 中的键） */
+    field: string;
+    /** 列标题（默认用 field） */
+    title?: string;
+    /** 属性类型 */
+    type: PropertyTypeString | string;
+    /** 属性级只读（整列不可编辑） */
+    readonly?: boolean;
+    /** 枚举值列表（type=enum 时使用，不含图标/i18n 时的简短形式） */
+    enumValues?: readonly string[];
+    /** 枚举项完整定义（type=enum 时使用，支持 text 国际化、icon 图标；优先级高于 enumValues） */
+    enumItems?: readonly EnumItem[];
+    /** 是否允许 null（type=enum 时使用） */
+    nullable?: boolean;
+    /** 列宽（默认 'auto'，uuid 类型默认 320） */
+    width?: number | 'auto';
+    /** 是否启用排序 */
+    sort?: boolean;
+    /** keyValue 属性 Schema—定义允许的键以及对应的值类型 */
+    keyValueSchema?: Record<string, KVSchemaEntry>;
+    /**
+     * 关联实体候选列表（oneToOne / manyToOne 类型使用）
+     *
+     * 每项包含 `id`（外键值）和 `displayName`（单元格显示文本）。
+     * 列更新时重新传入新列表即可刷新编辑器选项。
+     */
+    relatedItems?: RelatedEntityItem[];
+    /**
+     * 关联实体候选动态 provider（优先级高于 relatedItems）
+     *
+     * 每次单元格渲染或编辑器打开时调用，可返回最新的候选列表。
+     * 适合业务层需要运行时动态查询关联实体的场景。
+     */
+    relatedItemsProvider?: () => RelatedEntityItem[];
+}
+/** keyValue 模式中单个键的属性描述 */
+export interface KVSchemaEntry {
+    /** 显示标签（默认用键名） */
+    label?: string;
+    /** 值类型（用于输入验证） */
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'date';
+    /** 是否必填 */
+    required?: boolean;
+    /** 是否可以为 null */
+    nullable?: boolean;
+}
+/** 格式化日期值为本地字符串 */
+export declare function formatDateValue(v: unknown): string;
+/**
+ * 构建编辑器函数：非只读行使用指定编辑器名称，只读行返回 undefined
+ *
+ * 用于 ColumnDefine.editor，以便在行级别区分只读/可编辑状态。
+ */
+export declare function makeEditorForReadonly(editorName: string): ColumnDefine['editor'];
+/** 各属性类型的默认列宽及最小/最大宽度 */
+export declare const DEFAULT_COLUMN_SIZES: Record<string, {
+    width: number;
+    minWidth?: number;
+    maxWidth?: number;
+}>;
+/**
+ * 根据属性类型配置构建 VTable ColumnDefine
+ *
+ * 处理全部 11 种 PropertyType：
+ * - uuid / string / number / integer → 文本显示 + input-editor（非只读时）
+ * - enum → 文本显示 + list-editor 下拉框（非只读时）
+ * - boolean → switch cellType
+ * - date → 本地时间格式化 + date-editor 日期时间选择器（非只读时）
+ * - stringArray → 逗号分隔显示 + tags-editor 标签输入（非只读时）
+ * - numberArray → 逗号分隔显示 + number-tags-editor 数字标签输入（非只读时）
+ * - keyValue → JSON 字符串显示 + key-value-editor 键值对编辑器（非只读时）
+ * - json → JSON 字符串显示 + json-editor 文本区域（非只读时）
+ */
+export declare function buildPropertyColumn(config: PropertyColumnConfig): ColumnDefine;
+/**
+ * 将 input-editor 输入的字符串值解析回属性原始类型
+ *
+ * 在 cellChanged 事件处理器中调用此函数，将用户输入转成正确的 JS 类型后再保存。
+ */
+export declare function parsePropertyColumnValue(type: PropertyTypeString | string, raw: unknown): unknown;
+type ColumnRecord = Record<string, unknown> & {
+    _readonly?: boolean;
+    _isAddRow?: boolean;
+};
+/** 通过 VTable 回调参数安全获取当前行记录 */
+export declare const getCellRecord: (args: StylePropertyFunctionArg) => ColumnRecord | undefined;
+export type SwitchDisableCallback = (args: StylePropertyFunctionArg) => boolean;
+/** 检查记录是否为只读行 */
+export declare const isReadonly: (record: unknown) => boolean;
+/** 检查记录是否为只读行或新增模板行 */
+export declare const isReadonlyOrAddRow: (record: unknown) => boolean;
+/** 生成查看按钮的图标选项（仅 SVG，避免 text 撑满剩余宽度） */
+export declare function makeViewIcons(): unknown[];
+/** 生成删除按钮的图标选项 */
+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;
+export {};
+//# sourceMappingURL=column-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"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/date-editor.d.ts

@@ -0,0 +1,19 @@
+import { EditContext, IEditor } from '@visactor/vtable-editors';
+/**
+ * 日期时间选择编辑器
+ *
+ * 直接覆盖单元格显示原生 datetime-local 输入框。
+ * - Enter / Tab：确认
+ * - Escape：取消（恢复原始值）
+ * - 点击外部：确认并关闭
+ * - 「清除」按钮：将值设为 null
+ */
+export declare class DateEditor implements IEditor<unknown> {
+    #private;
+    readonly editorType = "date-editor";
+    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

@@ -0,0 +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"}

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

@@ -0,0 +1,38 @@
+import { GlobalOverlayEditor } from './global-overlay-editor.js';
+import { IconData } from './lucide-svg.js';
+/** 枚举选项配置 */
+export interface EnumItem {
+    /** 存储值 */
+    value: string;
+    /** 显示文本（默认等于 value） */
+    text?: string;
+    /** Lucide 图标数据（可选，配合 color 使用） */
+    icon?: IconData;
+    /** 图标描边颜色（可选，配合 icon 使用） */
+    color?: string;
+}
+/**
+ * 枚举下拉选择编辑器
+ *
+ * 从列定义的 `menuList` 动态读取可选项，支持键盘导航。
+ * - ↑ ↓：移动选中项
+ * - Enter / 点击：确认选中并关闭
+ * - Delete / Backspace：清空值并关闭
+ * - Escape：取消，恢复原始值
+ *
+ * 未来可扩展 icon、i18n 等字段通过 menuList 传入。
+ */
+export declare class EnumEditor extends GlobalOverlayEditor {
+    #private;
+    protected get initialFocusIndex(): number;
+    protected get itemCount(): number;
+    readonly editorType = "enum-editor";
+    constructor(presetItems?: EnumItem[]);
+    onStart(ctx: Parameters<GlobalOverlayEditor['onStart']>[0]): void;
+    getValue(): string;
+    protected onDeleteKey(): void;
+    protected buildRows(panel: HTMLDivElement): void;
+    protected onRowClick(idx: number): void;
+    protected onFocusChange(idx: number, prev: number): void;
+}
+//# sourceMappingURL=enum-editor.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,74 @@
+import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+/** daisyUI v5 主题色引用（CSS 变量，主题自适应） */
+export declare const DAISY_COLORS: {
+    readonly bg: "var(--color-base-100)";
+    readonly hover: "var(--color-base-200)";
+    readonly border: "var(--color-base-300)";
+    readonly text: "var(--color-base-content)";
+    readonly primary: "var(--color-primary)";
+    readonly primaryContent: "var(--color-primary-content)";
+    readonly error: "var(--color-error)";
+    readonly errorContent: "var(--color-error-content)";
+    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 事件干扰 */
+export declare function scheduleEditorSetup(fn: () => void): void;
+/** 编辑结束后将焦点还给 VTable root element（tabindex=0 的 .vtable div = ctx.container = table.getElement()），使方向键导航继续工作 */
+export declare function refocusTable(container: HTMLElement | null | undefined): void;
+/** 将浮层面板定位到单元格下方（空间不足时翻转到上方） */
+export declare function positionOverlayPanel(panel: HTMLElement, rect: {
+    left: number;
+    top: number;
+    width?: number;
+    height?: number;
+}, container: HTMLElement | null | undefined, estimatedHeight: number, options?: {
+    maxRight?: number;
+    minWidth?: number;
+}): void;
+/**
+ * 全局浮层列表编辑器抽象基类
+ *
+ * 提供通用基础设施，子类只需关注内容渲染与选择逻辑：
+ * - `document.body` 固定浮层 + 智能上下翻转定位
+ * - 点击外部关闭、Escape 关闭
+ * - 键盘导航（↑ ↓ Enter）
+ * - 鼠标悬停高亮（通过 `data-idx` 自动委托）
+ * - `refocusTable` 焦点还原
+ *
+ * ### 子类实现要求
+ * 1. 声明 `readonly editorType: string`
+ * 2. 实现 `buildRows(panel)` — 将行渲染到面板，行必须设置 `data-idx`
+ * 3. 实现 `get itemCount()` — 总行数
+ * 4. 实现 `onRowClick(idx)` — 点击/Enter 触发
+ * 5. 实现 `onFocusChange(idx, prev)` — 更新行视觉高亮
+ * 6. 实现 `getValue()` — 返回最终值
+ */
+export declare abstract class GlobalOverlayEditor implements IEditor<string> {
+    #private;
+    protected container: HTMLElement | null;
+    protected table: {
+        getCellOriginValue(col: number, row: number): unknown;
+    } | null;
+    protected editCol: number;
+    protected editRow: number;
+    protected abstract get initialFocusIndex(): number;
+    protected abstract get itemCount(): number;
+    protected get focusedIndex(): number;
+    abstract readonly editorType: string;
+    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;
+    protected abstract onFocusChange(idx: number, prev: number): void;
+    protected rowAt(idx: number): HTMLElement | null;
+    protected setFocused(idx: number): void;
+    protected onDeleteKey(): void;
+    protected close(): void;
+    protected refocusTable(): void;
+}
+//# sourceMappingURL=global-overlay-editor.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,37 @@
+import { GlobalOverlayEditor } from './global-overlay-editor.js';
+import { IconData } from './lucide-svg.js';
+/**
+ * 带图标的列表条目
+ * @deprecated 请改用 `EnumItem`，`EnumEditor` 已原生支持 icon 和 color 字段。
+ */
+export interface IconLabeledItem {
+    text: string;
+    value: string;
+    icon?: IconData;
+    color?: string;
+}
+/**
+ * 支持图标 + 文字的单选列表编辑器
+ *
+ * @deprecated 请改用 `EnumEditor`，传入包含 `icon` / `color` 字段的 `EnumItem` 数组。
+ * `IconListEditor` 将在未来版本移除。
+ *
+ * 每项包含 lucide SVG 图标和本地化标签。
+ * ↑ ↓ 移动焦点，Enter / 点击选中并关闭，Esc 取消。
+ */
+export declare class IconListEditor extends GlobalOverlayEditor {
+    #private;
+    protected get initialFocusIndex(): number;
+    protected get itemCount(): number;
+    readonly editorType = "icon-list";
+    constructor(config: {
+        values: IconLabeledItem[];
+    });
+    onStart(ctx: Parameters<GlobalOverlayEditor['onStart']>[0]): void;
+    getValue(): string;
+    protected onDeleteKey(): void;
+    protected buildRows(panel: HTMLDivElement): void;
+    protected onRowClick(idx: number): void;
+    protected onFocusChange(idx: number, prev: number): void;
+}
+//# sourceMappingURL=icon-list-editor.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,19 @@
+import { EditContext, IEditor } from '@visactor/vtable-editors';
+/**
+ * JSON / KeyValue 编辑器
+ *
+ * 浮层显示带语法提示的 textarea，适合编辑 json 和 keyValue 类型。
+ * - Ctrl+Enter：验证并提交
+ * - Escape：取消（恢复原始值）
+ * - 点击外部：best-effort 提交（JSON 合法则提交，否则保持原始值）
+ * - 实时显示 JSON 格式错误
+ */
+export declare class JsonEditor implements IEditor<unknown> {
+    #private;
+    readonly editorType = "json-editor";
+    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

@@ -0,0 +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"}

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

@@ -0,0 +1,21 @@
+import { EditContext, IEditor } from '@visactor/vtable-editors';
+import { KVSchemaEntry } from '../columns/column-utils.js';
+/**
+ * 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
+ * - Per-row inline error hints; global summary shown at bottom
+ * - Ctrl+Enter / confirm button: validate & commit
+ * - Escape / cancel button: revert to original value
+ */
+export declare class KeyValueEditor implements IEditor<unknown> {
+    #private;
+    readonly editorType = "key-value-editor";
+    constructor(schema?: Record<string, KVSchemaEntry> | null);
+    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

@@ -0,0 +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"}

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

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