@aiao/rxdb-model 0.0.26 → 0.0.28

package/dist/cn.d.ts

@@ -1,4 +1,4 @@
-import { type ClassValue } from 'clsx';
+import { ClassValue } from 'clsx';
 /**
  * 拼接 CSS 类名（clsx 的薄封装）。
  *

package/dist/entity-capabilities.d.ts

@@ -1,10 +1,4 @@
-/**
- * @fileoverview 实体界面能力派生（US-027）
- *
- * 实体管理界面的「新增 / 编辑 / 删除」入口只读这一份结论，结论只来自实体的 `permissions` 声明：
- * 是不是系统表、在哪个命名空间都不参与——系统表已经显式声明三项都为 `'system'`。
- */
-import { type EntityMetadata } from '@aiao/rxdb';
+import { EntityMetadata } from '@aiao/rxdb';
 /**
  * 实体在公开写入口上允许的界面操作
  */

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

@@ -1,10 +1,5 @@
-/**
- * Entity Detail 标签构建工具
- * 根据实体元数据生成详情页标签配置
- * @module entity-detail/detail-tabs
- */
-import { type EntityMetadata } from '@aiao/rxdb';
-import type { DetailTab } from './interfaces.js';
+import { EntityMetadata } from '@aiao/rxdb';
+import { DetailTab } from './interfaces.js';
 /**
  * 根据实体元数据构建详情页标签列表
  * @remarks 基本信息表单标签固定排在首位，其后为每个一对多 / 多对多关系生成一个表格标签

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

@@ -1,8 +1,4 @@
-/**
- * Entity Detail 类型定义
- * @module entity-detail/interfaces
- */
-import type { RelationKind } from '@aiao/rxdb';
+import { RelationKind } from '@aiao/rxdb';
 /**
  * 详情页标签类型
  */

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

@@ -1,10 +1,4 @@
-/**
- * RxDB Model 实体字段工具模块
- * 提供实体字段值的解析、格式化、验证等功能
- * @module entity-field.utils
- */
-import type { EntityMetadata } from '@aiao/rxdb';
-import { PropertyType, type FieldFormat, type FieldOptions } from '@aiao/rxdb';
+import { EntityMetadata, PropertyType, FieldFormat, FieldOptions } from '@aiao/rxdb';
 /**
  * 实体字段类型
  * @remarks 兼容 PropertyType 枚举值及其字符串字面量形式，并包含关系字段（oneToOne / manyToOne）与计算字段（computed）的标识

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

@@ -1,4 +1,4 @@
-import type { EntityFormData, FormFieldConfig } from './interfaces.js';
+import { EntityFormData, FormFieldConfig } from './interfaces.js';
 /**
  * 将实体对象转换为表单数据
  * @remarks 实体上不存在的字段以 null 填充

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

@@ -1,10 +1,5 @@
-/**
- * 表单字段构建工具
- * 根据实体元数据与表单模式生成、排序与过滤表单字段
- * @module entity-form/form-fields
- */
-import type { EntityMetadata } from '@aiao/rxdb';
-import type { FormFieldConfig, FormMode } from './interfaces.js';
+import { EntityMetadata } from '@aiao/rxdb';
+import { FormFieldConfig, FormMode } from './interfaces.js';
 /**
  * 根据实体元数据和表单模式构建表单字段列表
  * @remarks 创建模式排除计算字段且不含系统字段；编辑模式追加只读的系统字段；查看模式全部字段设为只读

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

@@ -1,10 +1,5 @@
-/**
- * 表单校验工具
- * 基于字段配置校验单个字段值与整份表单数据
- * @module entity-form/form-validation
- */
-import { type FieldValidationError } from '../entity-value.utils.js';
-import type { EntityFormData, FormFieldConfig, FormValidationResult } from './interfaces.js';
+import { FieldValidationError } from '../entity-value.utils.js';
+import { EntityFormData, FormFieldConfig, FormValidationResult } from './interfaces.js';
 /**
  * 校验单个表单字段值
  * @param field - 表单字段配置

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

@@ -1,9 +1,5 @@
-/**
- * Entity Form 类型定义
- * @module entity-form/interfaces
- */
-import type { FieldFormat, FieldOptions } from '@aiao/rxdb';
-import type { EntityFieldType, KeyValueSchemaEntry } from '../entity-field.utils.js';
+import { FieldFormat, FieldOptions } from '@aiao/rxdb';
+import { EntityFieldType, KeyValueSchemaEntry } from '../entity-field.utils.js';
 /**
  * 表单模式
  */

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

@@ -1,12 +1,5 @@
-/**
- * @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';
+import { EntityMetadata, OrderBy } from '@aiao/rxdb';
+import { RowMoveEvent } from '../entity-table/vtable/table-row-move.js';
 /** 列表排序判定需要的实体元数据 */
 export type ManualOrderListMetadata = Pick<EntityMetadata, 'manualOrder' | 'propertyMap'>;
 /** 列表的固定查询（详情页关系标签传入），结构同查询构建器的规则组 */

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,7 +1,7 @@
-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';
+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>;
 /** 跳过（不显示为独立列）的系统字段 */

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

@@ -1,7 +1,7 @@
-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';
+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';
 /** 删除图标默认颜色 */
 export declare const DELETE_COLOR = "var(--entity-table-delete, #ef4444)";
 /**

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

@@ -1,4 +1,4 @@
-import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
 /**
  * 颜色编辑器
  *

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
 import { GlobalOverlayEditor } from './global-overlay-editor.js';
-import { type IconData } from './lucide-svg.js';
+import { IconData } from './lucide-svg.js';
 /**
  * 带图标的列表条目
  * @deprecated 请改用 `EnumItem`，`EnumEditor` 已原生支持 icon 和 color 字段。

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

@@ -1,4 +1,4 @@
-import type { EditContext, IEditor } from '@visactor/vtable-editors';
+import { EditContext, IEditor } from '@visactor/vtable-editors';
 /**
  * JSON / KeyValue 编辑器
  *

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

@@ -1,7 +1,7 @@
-import type { EditContext, IEditor } from '@visactor/vtable-editors';
-import type { KVSchemaEntry } from '../columns/column-utils.js';
+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

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

@@ -1,4 +1,4 @@
-import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
 /** 数字编辑器的可选行为配置 */
 export interface NumberEditorOptions {
     /** true 为 64 位大整数模式（值类型 bigint） */

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

@@ -1,5 +1,5 @@
-import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
-import type { RelatedEntityItem } from '../../entity-form/interfaces.js';
+import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import { RelatedEntityItem } from '../../entity-form/interfaces.js';
 /** 关联实体选项项 */
 export { type RelatedEntityItem };
 /**

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

@@ -1,4 +1,4 @@
-import type { EditContext, IEditor } from '@visactor/vtable-editors';
+import { EditContext, IEditor } from '@visactor/vtable-editors';
 /** 标签编辑器模式：'string' 字符串标签 / 'number' 数字标签 */
 export type TagsMode = 'string' | 'number';
 /**

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

@@ -1,4 +1,4 @@
-import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
 /** TextFormatEditor 支持的 format 判别 */
 export type TextFormatMode = 'email' | 'phone' | 'url';
 /**

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

@@ -1,4 +1,4 @@
-import type { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
+import { EditContext, IEditor, RectProps } from '@visactor/vtable-editors';
 import { UUID_RE } from '../../entity-value.utils.js';
 /** UUID 格式正则（re-export，定义见 entity-value.utils） */
 export { UUID_RE };

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

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

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

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

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

@@ -1,5 +1,5 @@
+import { PendingWrite } from '../interfaces.js';
 import type * as VTable from '@visactor/vtable';
-import type { PendingWrite } from '../interfaces.js';
 /** 单个单元格的剪贴板快照 */
 export interface ClipboardCell {
     /** 列索引 */

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

@@ -1,6 +1,6 @@
-import type { ListTableConstructorOptions } from '@visactor/vtable';
+import { ListTableConstructorOptions } from '@visactor/vtable';
+import { EntityTableRecord } from '../interfaces.js';
 import * as VTable from '@visactor/vtable';
-import type { EntityTableRecord } from '../interfaces.js';
 /** 注册 VTable 基础编辑器（全局单例，重复调用仅注册一次） */
 export declare function ensureBaseEditorRegistered(): void;
 /**

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

@@ -1,6 +1,6 @@
+import { ListTableConstructorOptions } from '@visactor/vtable';
+import { EntityTableRecord } from '../interfaces.js';
 import type * as VTable from '@visactor/vtable';
-import type { ListTableConstructorOptions } from '@visactor/vtable';
-import type { EntityTableRecord } from '../interfaces.js';
 /**
  * HACK: VTable 不提供禁用特定行拖拽的 API，通过 monkey-patch 内部属性实现
  *

package/dist/entity-table/vtable/table-row-move.d.ts

@@ -1,3 +1,4 @@
+import { EntityTableRecord } from '../interfaces.js';
 /**
  * @fileoverview 表格单行拖动的读取与动态开关（US-028 阶段 B）
  *
@@ -6,7 +7,6 @@
  * {@link setRowDragEnabled} 记下的开关在 `patchDragIconForReadonlyRows` 打的补丁里收掉手柄。
  */
 import type * as VTable from '@visactor/vtable';
-import type { EntityTableRecord } from '../interfaces.js';
 /**
  * 单行拖放的结果：被拖行与它落点前后的邻居
  *

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

@@ -1,5 +1,5 @@
-import type { FieldFormat } from '@aiao/rxdb';
-import type { EntityFieldConfig, EntityFieldType } from './entity-field.utils.js';
+import { FieldFormat } from '@aiao/rxdb';
+import { EntityFieldConfig, EntityFieldType } from './entity-field.utils.js';
 /**
  * RxDB Model 实体值处理工具模块
  * 提供实体字段值的解析、格式化、验证等功能

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export * from './cn.js';
 export * from './entity-detail/detail-tabs.js';
 export * from './entity-detail/interfaces.js';
 export * from './entity-list/manual-order-list.js';
+export * from './entity-list/types.js';
 export * from './entity-form/form-data.js';
 export * from './entity-form/form-fields.js';
 export * from './entity-form/form-validation.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,SAAS,CAAC;AAGxB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAG5C,cAAc,kDAAkD,CAAC;AACjE,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iDAAiD,CAAC;AAChE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,sCAAsC,CAAC;AACrD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AAGvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,SAAS,CAAC;AAGxB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wBAAwB,CAAC;AAGvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAG5C,cAAc,kDAAkD,CAAC;AACjE,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iDAAiD,CAAC;AAChE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,sCAAsC,CAAC;AACrD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AAGvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC"}

package/dist/index.js

@@ -3486,20 +3486,20 @@ function En() {
 	return Tn ||= new Cn(), Tn;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/uuid@14.0.2/node_modules/uuid/dist/stringify.js
+//#region ../../node_modules/.pnpm/uuid@14.0.3/node_modules/uuid/dist/stringify.js
 var Z = [];
 for (let e = 0; e < 256; ++e) Z.push((e + 256).toString(16).slice(1));
 function Dn(e, t = 0) {
 	return (Z[e[t + 0]] + Z[e[t + 1]] + Z[e[t + 2]] + Z[e[t + 3]] + "-" + Z[e[t + 4]] + Z[e[t + 5]] + "-" + Z[e[t + 6]] + Z[e[t + 7]] + "-" + Z[e[t + 8]] + Z[e[t + 9]] + "-" + Z[e[t + 10]] + Z[e[t + 11]] + Z[e[t + 12]] + Z[e[t + 13]] + Z[e[t + 14]] + Z[e[t + 15]]).toLowerCase();
 }
 //#endregion
-//#region ../../node_modules/.pnpm/uuid@14.0.2/node_modules/uuid/dist/rng.js
+//#region ../../node_modules/.pnpm/uuid@14.0.3/node_modules/uuid/dist/rng.js
 var On = /* @__PURE__ */ new Uint8Array(16);
 function kn() {
 	return crypto.getRandomValues(On);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/uuid@14.0.2/node_modules/uuid/dist/v7.js
+//#region ../../node_modules/.pnpm/uuid@14.0.3/node_modules/uuid/dist/v7.js
 var An = {};
 function jn(e, t, n) {
 	let r;
@@ -4123,7 +4123,7 @@ var rr = {
 	json: "object"
 };
 function ir(e, t) {
-	return t?.displayName ? t.displayName : e.replace(/([A-Z])/g, " $1").replace(/^./, (e) => e.toUpperCase()).trim();
+	return t?.displayName ? t.displayName : e.replace(/(?<=[A-Z])(?=[A-Z][a-z])/g, " ").replace(/([a-z\d])([A-Z])/g, "$1 $2").replace(/^./, (e) => e.toUpperCase()).trim();
 }
 var ar = class e {
 	options;
@@ -4375,7 +4375,9 @@ function br(e, t = 2, n = 120) {
 }
 function xr(e, t, n = 2, r = 120) {
 	let i = br(t, n, r);
-	e.style.position = "fixed", e.style.margin = "0", e.style.inset = "unset", e.style.minWidth = `${i.minWidth}px`, e.style.left = `${i.left}px`, i.top == null ? (e.style.top = "unset", e.style.bottom = `${i.bottom}px`) : (e.style.top = `${i.top}px`, e.style.bottom = "unset");
+	e.style.position = "fixed", e.style.margin = "0", e.style.inset = "unset", e.style.minWidth = `${i.minWidth}px`;
+	let a = e.offsetWidth > 0 ? e.offsetWidth : i.minWidth, o = Math.max(8, Math.min(i.left, window.innerWidth - a - 8));
+	e.style.left = `${o}px`, i.top == null ? (e.style.top = "unset", e.style.bottom = `${i.bottom}px`) : (e.style.top = `${i.top}px`, e.style.bottom = "unset");
 }
 function Sr(e, t, n) {
 	return e.find((e) => e.value === t)?.label ?? n;

package/dist/query-builder/models/config.interface.d.ts

@@ -1,5 +1,5 @@
-import type { OperatorDefinition } from './operator.interface.js';
-import type { QueryBuilderRuleGroup, SchemaInfo } from './query-builder-state.js';
+import { OperatorDefinition } from './operator.interface.js';
+import { QueryBuilderRuleGroup, SchemaInfo } from './query-builder-state.js';
 /**
  * 查询构建器配置
  */

package/dist/query-builder/models/operator.interface.d.ts

@@ -1,5 +1,5 @@
-import type { OperatorName } from '@aiao/rxdb';
-import type { PropertyType } from './query-builder-state.js';
+import { OperatorName } from '@aiao/rxdb';
+import { PropertyType } from './query-builder-state.js';
 /**
  * 操作符定义
  * 包含操作符的元数据和约束

package/dist/query-builder/models/validation.interface.d.ts

@@ -1,5 +1,5 @@
-import type { OperatorName } from '@aiao/rxdb';
-import type { PropertyType } from './query-builder-state.js';
+import { OperatorName } from '@aiao/rxdb';
+import { PropertyType } from './query-builder-state.js';
 /**
  * 验证规则
  */

package/dist/query-builder/services/operator-registry.service.d.ts

@@ -1,10 +1,6 @@
-/**
- * @fileoverview 操作符注册表服务
- * 管理操作符的注册、查询和类型过滤
- */
-import type { OperatorName } from '@aiao/rxdb';
-import { type OperatorDefinition } from '../models/operator.interface.js';
-import type { FieldMetadata, PropertyType } from '../models/query-builder-state.js';
+import { OperatorName } from '@aiao/rxdb';
+import { OperatorDefinition } from '../models/operator.interface.js';
+import { FieldMetadata, PropertyType } from '../models/query-builder-state.js';
 /**
  * 操作符注册表选项
  */

package/dist/query-builder/services/query-builder.service.d.ts

@@ -1,12 +1,8 @@
-/**
- * @fileoverview QueryBuilder 核心服务
- * 提供 RxJS 响应式状态管理，支持规则增删改和双向转换
- */
-import type { RuleGroup } from '@aiao/rxdb';
+import { RuleGroup } from '@aiao/rxdb';
 import { Observable } from 'rxjs';
-import type { QueryBuilderConfig } from '../models/config.interface.js';
-import type { FieldMetadata, QueryBuilderRuleGroup, QueryBuilderState, UIRule } from '../models/query-builder-state.js';
-import type { ValidationResult } from '../models/validation.interface.js';
+import { QueryBuilderConfig } from '../models/config.interface.js';
+import { FieldMetadata, QueryBuilderRuleGroup, QueryBuilderState, UIRule } from '../models/query-builder-state.js';
+import { ValidationResult } from '../models/validation.interface.js';
 import { OperatorRegistry } from './operator-registry.service.js';
 import { QueryConverter } from './query-converter.service.js';
 import { ValidationService } from './validation.service.js';

package/dist/query-builder/services/query-converter.service.d.ts

@@ -1,9 +1,5 @@
-/**
- * @fileoverview Query 转换服务
- * 在 QueryBuilder 状态和 RxDB Query 之间进行双向转换
- */
-import type { RuleGroup } from '@aiao/rxdb';
-import type { QueryBuilderState } from '../models/query-builder-state.js';
+import { RuleGroup } from '@aiao/rxdb';
+import { QueryBuilderState } from '../models/query-builder-state.js';
 /**
  * 转换选项
  */

package/dist/query-builder/services/schema-parser.service.d.ts

@@ -1,9 +1,5 @@
-/**
- * @fileoverview Schema 解析服务
- * 从 EntityMetadata 解析字段元数据，用于 QueryBuilder 组件
- */
-import type { EntityMetadata } from '@aiao/rxdb';
-import type { FieldMetadata } from '../models/query-builder-state.js';
+import { EntityMetadata } from '@aiao/rxdb';
+import { FieldMetadata } from '../models/query-builder-state.js';
 /**
  * 解析器配置选项
  */

package/dist/query-builder/services/schema-parser.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-parser.service.d.ts","sourceRoot":"","sources":["../../../src/query-builder/services/schema-parser.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA0C,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAqBtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEhD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAEhD;;OAEG;IACH,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CAC3F;AA4BD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsC;IAE1E,4CAA4C;gBAChC,OAAO,GAAE,mBAAwB;IAW7C;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,EAAE;IAwDhD;;;;;OAKG;IACH,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAUjF;;OAEG;IACH,OAAO,CAAC,aAAa;IA8CrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAsCtB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAE9E"}
+{"version":3,"file":"schema-parser.service.d.ts","sourceRoot":"","sources":["../../../src/query-builder/services/schema-parser.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA0C,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAqBtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEhD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAEhD;;OAEG;IACH,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CAC3F;AA+BD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsC;IAE1E,4CAA4C;gBAChC,OAAO,GAAE,mBAAwB;IAW7C;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,EAAE;IAwDhD;;;;;OAKG;IACH,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAUjF;;OAEG;IACH,OAAO,CAAC,aAAa;IA8CrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAsCtB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAE9E"}

package/dist/query-builder/services/validation.service.d.ts

@@ -1,9 +1,5 @@
-/**
- * @fileoverview 校验服务
- * 提供规则值的即时校验功能
- */
-import type { FieldMetadata, QueryBuilderRule, UIRule } from '../models/query-builder-state.js';
-import type { ValidationResult, ValidationRule } from '../models/validation.interface.js';
+import { FieldMetadata, QueryBuilderRule, UIRule } from '../models/query-builder-state.js';
+import { ValidationResult, ValidationRule } from '../models/validation.interface.js';
 import { OperatorRegistry } from './operator-registry.service.js';
 /**
  * 单条校验规则输入（兼容 QueryBuilderRule 与 UIRule）

package/dist/query-builder/utils/field-tree.d.ts

@@ -1,10 +1,4 @@
-/**
- * @fileoverview 字段树工具函数
- *
- * 提供 Angular/React/Vue 共享的字段树构建和查找功能。
- * 用于将扁平的 FieldMetadata[] 转换为 CascadeSelect 组件所需的树形结构。
- */
-import type { FieldMetadata, PropertyType } from '../models/query-builder-state.js';
+import { FieldMetadata, PropertyType } from '../models/query-builder-state.js';
 /**
  * 字段树节点（用于 CascadeSelect）
  *

package/dist/query-builder/utils/metadata-field-extractor.d.ts

@@ -1,6 +1,5 @@
-import type { EntityMetadata, EntityRelationMetadata, KeyValuePropertyMetadata } from '@aiao/rxdb';
-import { PropertyType } from '@aiao/rxdb';
-import type { FieldMetadata, PropertyType as QBPropertyType } from '../models/query-builder-state.js';
+import { EntityMetadata, EntityRelationMetadata, KeyValuePropertyMetadata, PropertyType } from '@aiao/rxdb';
+import { FieldMetadata, PropertyType as QBPropertyType } from '../models/query-builder-state.js';
 /**
  * 模型信息接口
  */

package/dist/query-builder/utils/popover-position.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popover-position.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/popover-position.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,OAAO,EACpB,GAAG,SAAI,EACP,aAAa,SAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMnE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,SAAI,EAAE,aAAa,SAAM,GAAG,IAAI,CAc9G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER"}
+{"version":3,"file":"popover-position.d.ts","sourceRoot":"","sources":["../../../src/query-builder/utils/popover-position.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,OAAO,EACpB,GAAG,SAAI,EACP,aAAa,SAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMnE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,SAAI,EAAE,aAAa,SAAM,GAAG,IAAI,CAkB9G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER"}

package/dist/query-builder/utils/schema-factory.d.ts

@@ -1,10 +1,6 @@
-/**
- * @fileoverview Schema 工厂函数
- * 提供便捷的工厂方法从 RxDB 实体创建 SchemaParser 实例并解析字段
- */
-import type { EntityMetadata } from '@aiao/rxdb';
-import type { FieldMetadata } from '../models/query-builder-state.js';
-import { type SchemaParserOptions } from '../services/schema-parser.service.js';
+import { EntityMetadata } from '@aiao/rxdb';
+import { FieldMetadata } from '../models/query-builder-state.js';
+import { SchemaParserOptions } from '../services/schema-parser.service.js';
 /**
  * 从 EntityMetadata 创建字段元数据
  *

package/dist/query-builder/utils/value-input.d.ts

@@ -1,5 +1,5 @@
 import { UUID_RE } from '../../entity-value.utils.js';
-import type { OperatorRegistry } from '../services/operator-registry.service.js';
+import { OperatorRegistry } from '../services/operator-registry.service.js';
 /** 标准 UUID 格式正则（8-4-4-4-12 十六进制，忽略大小写），重新导出供校验使用 */
 export { UUID_RE };
 /**

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@aiao/rxdb-model",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "Framework-agnostic entity model core for Aiao RxDB: metadata-driven forms, details, editable tables and query builder.",
-  "homepage": "https://rxdb.netlify.app/docs",
+  "homepage": "https://rxdb.aiao.io/docs",
   "bugs": {
     "url": "https://github.com/aiao-io/rxdb/issues"
   },
@@ -47,11 +47,11 @@
   "dependencies": {
     "clsx": "^2.1.1",
     "rxjs": "^7.8.2",
-    "uuid": "^14.0.2",
-    "@aiao/rxdb": "0.0.26"
+    "uuid": "^14.0.3"
   },
   "peerDependencies": {
     "@visactor/vtable": "~1.26.5",
-    "@visactor/vtable-editors": "~1.26.5"
+    "@visactor/vtable-editors": "~1.26.5",
+    "@aiao/rxdb": "^0.0.28"
   }
 }

package/src/entity-list/types.ts

@@ -0,0 +1,22 @@
+/**
+ * 实体列表共享类型。
+ *
+ * @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[] };

package/src/entity-table/editors/key-value-editor.ts

@@ -13,7 +13,7 @@ interface SchemaRow {
 }
 
 /**
- * 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

package/src/entity-table/interfaces.ts

@@ -1,3 +1,5 @@
+import type { ListTable } from '@visactor/vtable';
+
 /**
  * 通用实体表记录基础接口
  *
@@ -70,3 +72,29 @@ export interface EntityTableConfig {
   /** 单元格错误 tooltip 延迟（毫秒），默认 800 */
   tooltipDelay?: number;
 }
+
+/**
+ * 实体表格的命令面：三端 `EntityTable` 组件对外暴露的同一组命令。
+ *
+ * @remarks
+ * React 经 `ref`（`forwardRef` + `useImperativeHandle`）、Vue 经 `defineExpose`、Angular 即组件实例
+ * 本身（`EntityTableComponent implements EntityTableHandle`）。三端各自另有的公开成员（Angular 的
+ * input / output、Vue 暴露给内部父组件的状态）不在契约内，按本类型写的调用方与 mock 三端通用。
+ */
+export interface EntityTableHandle {
+  /** 当前 VTable 表格实例；未初始化时为 `null`。 */
+  readonly tableInstance: ListTable | null;
+  /** 从业务层回滚单元格值（校验失败时恢复原值）。 */
+  changeCellValue(col: number, row: number, value: unknown): void;
+  /** 用当前暗色模式与 CSS 变量重绘主题。 */
+  redrawTheme(): void;
+  /** 把行恢复成最近一次交给表格的顺序（拖放被拒或落库失败时调用）。 */
+  restoreRecords(): void;
+}
+
+/**
+ * 查询表格的命令面：成员与 {@link EntityTableHandle} 相同，全部委托给内部实体表格。
+ *
+ * @remarks 三端 `QueryTable` 组件的暴露方式同 {@link EntityTableHandle}。
+ */
+export type QueryTableHandle = EntityTableHandle;

package/src/index.ts

@@ -19,6 +19,7 @@ export * from './entity-detail/interfaces.js';
 
 // Entity List（US-028 手动排序）
 export * from './entity-list/manual-order-list.js';
+export * from './entity-list/types.js';
 
 // Entity Form
 export * from './entity-form/form-data.js';

package/src/query-builder/services/schema-parser.service.ts

@@ -83,9 +83,12 @@ function defaultDisplayNameGenerator(fieldName: string, metadata?: { displayName
   if (metadata?.displayName) {
     return metadata.displayName;
   }
-  // camelCase -> Camel Case
+  // 先切开缩写与普通单词，再切开普通 camelCase。
+  // 只用零宽断言定位「缩写末字母 + 大写单词首字母」的边界：没有任何带量词的
+  // 消费式片段，对任意输入都是线性时间（CodeQL 多项式正则告警）。
   return fieldName
-    .replace(/([A-Z])/g, ' $1')
+    .replace(/(?<=[A-Z])(?=[A-Z][a-z])/g, ' ')
+    .replace(/([a-z\d])([A-Z])/g, '$1 $2')
     .replace(/^./, str => str.toUpperCase())
     .trim();
 }

package/src/query-builder/utils/popover-position.ts

@@ -32,7 +32,11 @@ export function applyPopoverPosition(el: HTMLElement, triggerRect: DOMRect, gap
   el.style.margin = '0';
   el.style.inset = 'unset';
   el.style.minWidth = `${pos.minWidth}px`;
-  el.style.left = `${pos.left}px`;
+  // 水平夹回：右缘不超出视口（留 8px），左缘最多贴到视口左 8px。
+  // 窄屏（如移动端详情页靠右的字段选择）下浮层向右溢出会被截断。
+  const width = el.offsetWidth > 0 ? el.offsetWidth : pos.minWidth;
+  const clampedLeft = Math.max(8, Math.min(pos.left, window.innerWidth - width - 8));
+  el.style.left = `${clampedLeft}px`;
   if (pos.top != null) {
     el.style.top = `${pos.top}px`;
     el.style.bottom = 'unset';