@aiao/rxdb-model 0.0.19 → 0.0.26

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

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

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

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

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

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview 表格单行拖动的读取与动态开关（US-028 阶段 B）
+ *
+ * VTable 只在建表时读 `rowSeriesNumber.dragOrder`，之后改选项不生效；手柄是否出现由
+ * `rowSeriesNumberHelper.getIcons` 决定。所以建表时统一打开 `dragOrder`，再由
+ * {@link setRowDragEnabled} 记下的开关在 `patchDragIconForReadonlyRows` 打的补丁里收掉手柄。
+ */
+import type * as VTable from '@visactor/vtable';
+import type { EntityTableRecord } from '../interfaces.js';
+/**
+ * 单行拖放的结果：被拖行与它落点前后的邻居
+ *
+ * @remarks
+ * 形状对齐 `Repository.reorder(id, { prevId, nextId })`；落到首部时 `prevId` 为 `null`，
+ * 落到尾部时 `nextId` 为 `null`。只描述表格里看到的位置，是否允许落库由调用方决定。
+ */
+export interface RowMoveEvent {
+    /** 被拖动行的主键 */
+    readonly id: string;
+    /** 落点之前那一行的主键；落到首部为 `null` */
+    readonly prevId: string | null;
+    /** 落点之后那一行的主键；落到尾部为 `null` */
+    readonly nextId: string | null;
+}
+/**
+ * VTable `change_header_position` 事件参数中本模块用到的部分
+ */
+export interface HeaderPositionChange {
+    /** 拖动起点 */
+    readonly source: {
+        readonly col: number;
+        readonly row: number;
+    };
+    /** 放下后的位置 */
+    readonly target: {
+        readonly col: number;
+        readonly row: number;
+    };
+    /** 拖动的是行还是列 */
+    readonly movingColumnOrRow?: 'row' | 'column';
+}
+/**
+ * 从一次行拖放读出被拖行与落点邻居
+ *
+ * @param table - 已完成换位的表格实例（VTable 先 `changeRecordOrder` 再派发事件）
+ * @param idField - 记录主键字段名
+ * @param change - `change_header_position` 的事件参数
+ * @returns 拖的是列、原位放下或被拖行主键不是字符串时为 `null`
+ *
+ * @example
+ * ```typescript
+ * table.on('change_header_position', args => {
+ *   const move = readRowMove(table, 'id', args);
+ *   if (move) emitRowMoved(move);
+ * });
+ * ```
+ */
+export declare function readRowMove(table: VTable.ListTable, idField: string, change: HeaderPositionChange): RowMoveEvent | null;
+/**
+ * 运行时开关表格的行拖动手柄
+ *
+ * @param table - 目标表格实例（建表时需开启 `rowSeriesNumber.dragOrder`）
+ * @param enabled - `false` 时所有行都不显示手柄
+ *
+ * @remarks
+ * 只在状态真的变化时重建单元格；手柄的收起依赖 `patchDragIconForReadonlyRows` 已经打过补丁。
+ */
+export declare function setRowDragEnabled(table: VTable.ListTable, enabled: boolean): void;
+/**
+ * 表格当前是否允许行拖动
+ *
+ * @param table - 目标表格实例
+ * @returns 未调用过 {@link setRowDragEnabled} 时为 `true`
+ */
+export declare function isRowDragEnabled(table: VTable.ListTable): boolean;
+/**
+ * 把表格行恢复成最近一次提交的顺序
+ *
+ * @param table - 目标表格实例
+ * @param records - 交给表格的那份记录数组（会被原地改回）
+ * @param committed - 最近一次 `setRecords` 时记下的顺序副本
+ *
+ * @remarks
+ * VTable 拖放换位是对传入数组原地 `splice`，交进去的记录数组此时已是拖后的顺序；
+ * 所以宿主组件每次交数据时要另存一份副本，失败或被拒时用它把数组改回去再重绘。
+ */
+export declare function restoreTableRecords(table: VTable.ListTable, records: EntityTableRecord[], committed: readonly EntityTableRecord[]): void;
+//# sourceMappingURL=table-row-move.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table-row-move.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-row-move.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW;IACX,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,aAAa;IACb,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,eAAe;IACf,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC/C;AAaD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,oBAAoB,GAC3B,YAAY,GAAG,IAAI,CAMrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAKjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAEjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,OAAO,EAAE,iBAAiB,EAAE,EAC5B,SAAS,EAAE,SAAS,iBAAiB,EAAE,GACtC,IAAI,CAGN"}

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

@@ -1,17 +1,62 @@
 import * as VTable from '@visactor/vtable';
+/** daisyUI 主题 CSS 变量集合 */
 export interface CSSVariables {
+    /** 根背景色 */
     rootBg: string;
+    /** base-100 面板背景色 */
     base100: string;
+    /** base-200 次级背景色 */
     base200: string;
+    /** base-300 边框/分隔线颜色 */
     base300: string;
+    /** 基础内容文字色 */
     baseContent: string;
+    /** 主色调 */
     primary: string;
+    /** 主色调上的文字颜色 */
     primaryContent: string;
+    /** 圆角尺寸 */
     radiusBox: string;
 }
+/**
+ * 返回默认颜色集合
+ *
+ * @returns 内置默认主题色，作为无 CSS 变量环境下的兜底
+ */
 export declare function getDefaultColors(): CSSVariables;
-/** 从 CSS 自定义属性读取 daisyUI 主题色 */
+/**
+ * 获取文档根元素的计算样式
+ *
+ * @returns 文档根元素计算样式；非浏览器环境（无 document）时返回 undefined
+ */
+export declare function getDocumentRootStyle(): Pick<CSSStyleDeclaration, 'getPropertyValue'> | undefined;
+/**
+ * 读取单个 CSS 变量值，为空时回退到默认值
+ *
+ * @param name CSS 变量名
+ * @param fallback 变量缺失或为空时的回退值
+ * @param style 样式来源，默认取文档根元素计算样式
+ * @returns 变量值（已去除首尾空白）；无效或为空时返回 fallback
+ */
+export declare function getCSSVariableValue(name: string, fallback: string, style?: Pick<CSSStyleDeclaration, 'getPropertyValue'> | undefined): string;
+/**
+ * 判断当前文档是否处于暗色模式
+ *
+ * @returns data-theme=dark 或系统 prefers-color-scheme: dark 时为 true；非浏览器环境返回 false
+ */
+export declare function isDocumentDarkMode(): boolean;
+/**
+ * 从 CSS 自定义属性读取 daisyUI 主题色
+ *
+ * @returns 主题色集合；无 document 时返回默认色
+ */
 export declare function getCSSVariables(): CSSVariables;
-/** 基于 daisyUI CSS 变量构建 VTable 主题 */
+/**
+ * 基于 daisyUI CSS 变量构建 VTable 主题
+ *
+ * @param isDark 是否暗色模式
+ * @param cssVars 主题 CSS 变量集合
+ * @returns VTable 主题对象
+ */
 export declare function createTheme(isDark: boolean, cssVars: CSSVariables): ReturnType<typeof VTable.themes.DEFAULT.extends>;
 //# sourceMappingURL=table-theme.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"table-theme.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAK3C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CAW/C;AAED,gCAAgC;AAChC,wBAAgB,eAAe,IAAI,YAAY,CAkB9C;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAsDpH"}
+{"version":3,"file":"table-theme.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAM3C,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAW/C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,GAAG,SAAS,CAMhG;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,IAAI,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,GAAG,SAAkC,GACxF,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAc5C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAkB9C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAsDpH"}

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

@@ -1,5 +1,11 @@
 import type * as VTable from '@visactor/vtable';
-/** 计算 tooltip 在页面上的绝对位置 */
+/**
+ * 计算 tooltip 在页面上的绝对位置
+ *
+ * @param container tooltip 所在容器元素
+ * @param rect 单元格矩形信息（x/left、y/top、height/bottom）
+ * @returns 页面坐标（位于单元格下方）；容器、矩形或位置信息缺失时返回 null
+ */
 export declare function computeTooltipPosition(container: HTMLElement | null | undefined, rect: Record<string, number> | null | undefined): {
     x: number;
     y: number;

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

@@ -1 +1 @@
-{"version":3,"file":"table-tooltip.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-tooltip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAGhD,2BAA2B;AAC3B,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9C;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUjC;AAID,2BAA2B;AAC3B,qBAAa,kBAAkB;;IAI7B,qBAAqB;IACrB,SAAS,CACP,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,EAC3E,KAAK,SAAwB,GAC5B,IAAI;IAYP,iBAAiB;IACjB,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;IAS3C,eAAe;IACf,OAAO,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"table-tooltip.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/table-tooltip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAGhD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9C;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUjC;AAKD,2BAA2B;AAC3B,qBAAa,kBAAkB;;IAI7B,qBAAqB;IACrB,SAAS,CACP,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,EAC3E,KAAK,SAAwB,GAC5B,IAAI;IAYP,iBAAiB;IACjB,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;IAS3C,eAAe;IACf,OAAO,IAAI,IAAI;CAKhB"}

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

@@ -11,14 +11,42 @@ import type * as VTable from '@visactor/vtable';
  * 将 VTable 列索引映射到 columns 数组索引时需减此偏移。
  */
 export declare const ROW_SERIES_COL_OFFSET = 1;
-/** 设置 switch/checkbox/radio 单元格视觉状态 */
+/**
+ * 设置 switch/checkbox/radio 单元格视觉状态
+ *
+ * @param table 目标表格实例
+ * @param col 列索引
+ * @param row 行索引
+ * @param value 目标布尔状态
+ */
 export declare function setCellSwitchState(table: VTable.ListTable, col: number, row: number, value: boolean): void;
-/** 获取表格 DOM 容器元素 */
+/**
+ * 获取表格 DOM 容器元素
+ *
+ * @param table 目标表格实例
+ * @returns 容器元素；VTable 未提供该方法时返回 undefined
+ */
 export declare function getTableContainer(table: VTable.ListTable): HTMLElement | undefined;
-/** 检查表格是否正在编辑中 */
+/**
+ * 检查表格是否正在编辑中
+ *
+ * @param table 目标表格实例
+ * @returns 存在活动编辑器时为 true
+ */
 export declare function isTableEditing(table: VTable.ListTable): boolean;
-/** 完成当前单元格编辑 */
+/**
+ * 完成当前单元格编辑
+ *
+ * @param table 目标表格实例
+ */
 export declare function completeTableEdit(table: VTable.ListTable): void;
-/** 回写单元格值（不触发编辑事件） */
+/**
+ * 回写单元格值（不触发编辑事件）
+ *
+ * @param table 目标表格实例
+ * @param col 列索引
+ * @param row 行索引
+ * @param value 写入的值
+ */
 export declare function changeCellValue(table: VTable.ListTable, col: number, row: number, value: unknown): void;
 //# sourceMappingURL=vtable-compat.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"vtable-compat.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/vtable-compat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAEhD;;;;;;GAMG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAIvC,uCAAuC;AACvC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAK1G;AAED,oBAAoB;AACpB,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,WAAW,GAAG,SAAS,CAMlF;AAED,kBAAkB;AAClB,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAG/D;AAED,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAK/D;AAED,sBAAsB;AACtB,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKvG"}
+{"version":3,"file":"vtable-compat.d.ts","sourceRoot":"","sources":["../../../src/entity-table/vtable/vtable-compat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAEhD;;;;;;GAMG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAIvC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAK1G;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,WAAW,GAAG,SAAS,CAMlF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAK/D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKvG"}

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

@@ -1,10 +1,58 @@
-import { EntityFieldConfig, EntityFieldType } from './entity-field.utils.js';
+import type { FieldFormat } from '@aiao/rxdb';
+import type { EntityFieldConfig, EntityFieldType } from './entity-field.utils.js';
+/**
+ * RxDB Model 实体值处理工具模块
+ * 提供实体字段值的解析、格式化、验证等功能
+ * @module entity-value.utils
+ */
+/**
+ * UUID 字符串格式校验正则（不区分大小写）
+ */
 export declare const UUID_RE: RegExp;
+/**
+ * 将原始值解析为指定字段类型的目标值
+ * @remarks 空值（null / undefined / 空字符串）统一返回 null，未识别的类型原样返回
+ * @param type - 字段类型
+ * @param raw - 原始值
+ * @returns 解析后的值
+ */
 export declare function parseEntityFieldValue(type: EntityFieldType | string, raw: unknown): unknown;
-export declare function formatEntityFieldValue(type: EntityFieldType | string, value: unknown): string;
+/**
+ * 严格解析表单输入；失败时返回结构化原因，调用方不得覆盖原始输入。
+ */
+export declare function parseEntityFieldValueStrict(type: EntityFieldType | string, raw: unknown): {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * 将字段值格式化为展示用字符串
+ * @remarks 日期按本地格式展示，数组以逗号加空格连接，JSON 类值序列化为 JSON 字符串。
+ * `format` 只影响展示形态：货币/百分比/评分/时长/日期显示模式
+ * @param type - 字段类型
+ * @param value - 字段值
+ * @param format - 字段语义标注（可选）
+ * @returns 格式化后的字符串
+ */
+export declare function formatEntityFieldValue(type: EntityFieldType | string, value: unknown, format?: FieldFormat): string;
+/**
+ * 字段校验错误
+ */
 export interface FieldValidationError {
+    /** 出错字段名 */
     field: string;
+    /** 错误提示信息 */
     message: string;
 }
+/**
+ * 校验单个字段值是否满足字段配置约束
+ * @remarks 校验必填、UUID 格式、数字 / 整数 / bigint / binary、日期、枚举范围、JSON 格式
+ * 与 format 语义（url / email / phone / color / range）
+ * @param field - 字段配置
+ * @param value - 待校验的字段值
+ * @returns 校验错误；校验通过时返回 null
+ */
 export declare function validateEntityFieldValue(field: EntityFieldConfig, value: unknown): FieldValidationError | null;
 //# sourceMappingURL=entity-value.utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"entity-value.utils.d.ts","sourceRoot":"","sources":["../src/entity-value.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAElF,eAAO,MAAM,OAAO,QAAoE,CAAC;AAEzF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAmD3F;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CA0B7F;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAyC9G"}
+{"version":3,"file":"entity-value.utils.d.ts","sourceRoot":"","sources":["../src/entity-value.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAElF;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO,QAAoE,CAAC;AAgGzF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAqC3F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,eAAe,GAAG,MAAM,EAC9B,GAAG,EAAE,OAAO,GACX;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6C/D;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAqDnH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AA0CD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CA2G9G"}

package/dist/index.d.ts

@@ -1,8 +1,16 @@
+/**
+ * RxDB Model - 核心实体和数据模型定义
+ * 提供实体字段处理、实体值处理、结构相等性判断等基础功能
+ * @module @aiao/rxdb-model
+ */
 export * from './entity-field.utils.js';
 export * from './entity-value.utils.js';
 export * from './structural-equal.js';
+export * from './entity-capabilities.js';
+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-form/form-data.js';
 export * from './entity-form/form-fields.js';
 export * from './entity-form/form-validation.js';
@@ -26,6 +34,7 @@ export * from './entity-table/vtable/table-clipboard.js';
 export * from './entity-table/vtable/table-factory.js';
 export * from './entity-table/vtable/table-keyboard.js';
 export * from './entity-table/vtable/table-operations.js';
+export * from './entity-table/vtable/table-row-move.js';
 export * from './entity-table/vtable/table-theme.js';
 export * from './entity-table/vtable/table-tooltip.js';
 export * from './entity-table/vtable/vtable-compat.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAG9C,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,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;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"}