@taocompany/magic-grid 0.1.0

package/dist/core/api/gridApi.d.ts

@@ -0,0 +1,455 @@
+import { GridMetrics } from '../grid/gridMetrics';
+import { FilterCondition, FilterModel, GridEventHandler, GridEventType, RefreshCellsParams, RowNode, RowNodeTransaction, RowTransaction, SortModelItem, EditingCellPosition } from '../types';
+import { CellEditorFn } from '../types/cellEditor';
+import { EditSessionPhase } from '../editing/editCommitContext';
+import { ClearValidationOptions, ValidateGridOptions, GridValidationResult, ValidateCellsOptions, ClearCellValidationOptions, ValidateRowsOptions, ClearRowValidationOptions } from '../types/validation';
+import { RowId, RowIdInput } from '../types/rowId';
+import { RowIndexMode } from '../types/rowMutation';
+import { RowMoveResult } from '../row/rowMoveService';
+import { CellSpanInfo } from '../types/cellSpan';
+import { RowData } from '../../types';
+import { Grid } from '../grid/grid';
+/**
+ * `ensureIndexVisible` 滚动对齐方式。
+ *
+ * - `'top'` — 目标行贴近视口顶部
+ * - `'bottom'` — 目标行贴近视口底部
+ * - `'middle'` — 目标行尽量居中（默认）
+ */
+export type EnsureIndexVisiblePosition = 'top' | 'bottom' | 'middle';
+/**
+ * Phase 6 行 CRUD API 面。
+ *
+ * 负责增删行、导出用户数据、临时行 ID 提升；与 `applyTransaction` 共享同一事务管线。
+ *
+ * @see docs/10-phase6-row-crud.md
+ */
+export interface RowMutationGridApi {
+    /**
+     * 在指定位置插入一行或多行。
+     *
+     * - 省略 `data[rowKey]` 或值为 `null` 时生成**临时行**（`RowNode.id = __mg_tmp_*`）；
+     *   `getData()` 导出时对应字段为 `null`。
+     * - 带有效 `rowKey` 的新增行视为持久化行，须保证主键唯一。
+     * - 配置 `asyncRowMutation.add` 时 await 服务端成功后再写入本地。
+     *
+     * @returns 本次变更涉及的 RowNode 快照（add / remove / update）
+     */
+    addRows(options: import('../types/rowMutation').AddRowsOptions): Promise<RowNodeTransaction>;
+    /**
+     * 按 rowId 和/或行下标删除行。
+     *
+     * - `rowIds`：内核 id 或业务主键值（number / string 均可）。
+     * - `indexes`：配合 `indexMode` 使用 `'source'`（存储顺序）或 `'display'`（排序/filter 后可见顺序）。
+     * - 删除正在编辑的行会先取消编辑；选区 / 索引定位 / 校验反馈会同步清理。
+     * - 配置 `asyncRowMutation.remove` 时 await 服务端成功后再删除本地。
+     *
+     * @returns 本次删除的 RowNode 快照
+     */
+    removeRows(options: import('../types/rowMutation').RemoveRowsOptions): Promise<RowNodeTransaction>;
+    /**
+     * 导出当前表格数据为业务层 `RowData[]`。
+     *
+     * - 默认 `sourceOrder: true`，按 source 存储顺序返回。
+     * - 临时行的 `data[rowKey]` 固定为 `null`（不暴露 `__mg_tmp_*`）。
+     *
+     * @param options.sourceOrder `false` 时按当前 display 顺序（含 sort/filter 结果）
+     */
+    getData(options?: import('../types/rowMutation').GetDataOptions): RowData[];
+    /**
+     * 将临时行的内部 id 提升为正式业务主键。
+     *
+     * - `rowId`：当前 `RowNode.id`（通常为 `__mg_tmp_*`）。
+     * - `businessId`：写入 `data[rowKey]` 并更新 `RowNode.id` 的值（number / string）。
+     * - 目标 id 已存在或行正在编辑时返回 `{ ok: false, reason }`。
+     *
+     * 成功时 emit `rowIdPromoted` 事件。
+     */
+    promoteRowId(options: import('../types/rowMutation').PromoteRowIdOptions): import('../types/rowMutation').PromoteRowIdResult;
+    /**
+     * 编程式移动行（Phase 15）。
+     *
+     * - `indexMode: 'source'`（默认）按 source 存储顺序移动。
+     * - `indexMode: 'display'` 按当前 display 顺序移动；sort 激活时拒绝。
+     * - managed UI drag 成功时 emit `rowMoved`（`source: 'uiRowDrag'`）；API 调用为 `'api'`。
+     */
+    moveRow(rowId: RowId, toIndex: number, indexMode?: RowIndexMode): RowMoveResult;
+}
+/**
+ * Magic Grid 完整命令式 API（对照 AG Grid GridApi 子集）。
+ *
+ * 按职责分组：数据 / 排序筛选 / 视口 / 编辑 / 校验 / 行选 / 索引定位 / 生命周期。
+ */
+export interface GridApi extends RowMutationGridApi {
+    /**
+     * 全量替换表格数据（等价于清空后重新加载）。
+     *
+     * - 触发完整重绘与视口高度重算。
+     * - `reserveSelection: false`（默认）时清空选区；为 `true` 时保留仍存在的 rowId。
+     * - 始终清除索引定位与校验视觉反馈。
+     */
+    setData(rows: RowData[]): void;
+    /**
+     * 增量事务：add / update / remove。
+     *
+     * - `update` / `remove` 项可通过 `data[rowKey]` 或字符串 rowId 定位行。
+     * - 与 `addRows` / `removeRows` 共用同一刷新管线；大量连续操作建议包在 `beginUpdate` / `endUpdate` 中。
+     * - 配置 `asyncRowMutation` 时 await 对应钩子成功后再写入本地。
+     *
+     * @returns 本次事务影响的 RowNode 快照
+     */
+    applyTransaction(tx: RowTransaction): Promise<RowNodeTransaction>;
+    /** 设置排序模型并重算 `rowsToDisplay`。触发 `sortChanged`。 */
+    setSortModel(model: SortModelItem[]): void;
+    /** 读取当前排序模型（v1 至多 1 项） */
+    getSortModel(): SortModelItem[];
+    /** 设置筛选模型并重算 `rowsToDisplay`。触发 `filterChanged`。 */
+    setFilterModel(model: FilterModel): void;
+    /** 读取当前筛选模型。 */
+    getFilterModel(): FilterModel;
+    /** 读取单列筛选条件；未设置时 `null`。 */
+    getColumnFilter(colId: string): FilterCondition | null;
+    /** 单列是否有有效筛选条件（含 blank/notBlank · custom predicate）。 */
+    isColumnFilterActive(colId: string): boolean;
+    /** 任一列 filter 或 quick filter 是否 active。 */
+    isAnyFilterActive(): boolean;
+    /** 设置 Grid 级 quick filter 文本；触发 `filterChanged`（块 5 接入过滤语义）。 */
+    setQuickFilterText(text: string): void;
+    /** 读取当前 quick filter 文本。 */
+    getQuickFilterText(): string;
+    /**
+     * 清除全部筛选：列 filterModel + quickFilterText。
+     * 单次 filter 管线；无 active filter 时为 no-op。
+     */
+    clearAllFilters(): void;
+    /**
+     * 设置或清除单列筛选条件；`condition === null` 移除该 colId。
+     * 触发 `filterChanged`。
+     */
+    setColumnFilter(colId: string, condition: FilterCondition | null): void;
+    /**
+     * 编程式移动列；`toIndex` 为全局 columns 下标（含系统列占位）。
+     * 非法 move（跨 lane / 系统列）为 no-op；完整逻辑见 Phase 11 块 2。
+     */
+    moveColumn(colId: string, toIndex: number): void;
+    /** Phase 27 · 各 lane 内用户列恢复 defOrder；无变化时为 no-op */
+    resetColumnOrder(): boolean;
+    /** Phase 27 · 用户列恢复 defWidth / defFlex；无变化时为 no-op */
+    resetColumnWidths(): boolean;
+    /**
+     * 运行时改列 fixed（left / right / null）。
+     * 非法 colId 或系统列 no-op；与 `allowCrossLaneColumnMove` 无关。
+     */
+    setColumnFixed(colId: string, fixed: 'left' | 'right' | null): boolean;
+    /** Phase 22 · 批量设置列 hidden；触发 `columnHiddenChanged` */
+    setColumnsHidden(colIds: readonly string[], hidden: boolean): boolean;
+    /** Phase 22 · 列是否 hidden；未知 colId 返回 `undefined` */
+    isColumnHidden(colId: string): boolean | undefined;
+    /** Phase 22 · 当前 UI 展示的列 id（左→右） */
+    getDisplayedColumnIds(): readonly string[];
+    /** Phase 27 · 全量列（含 hidden · 含系统列） */
+    getColumns(): readonly import('../types/column').Column[];
+    /** Phase 12 · 列 distinct 值（set filter 勾选列表） */
+    getColumnDistinctFilterValues(colId: string): readonly import('../filter/filterSetValue').ColumnFilterValueOption[];
+    /** Phase 27 · 当前 UI 展示的列（不含 hidden） */
+    getDisplayedColumns(): readonly import('../types/column').Column[];
+    /**
+     * 批量设置列宽（Phase 14）。
+     * 触发 `columnResized`；`finished: false` 用于拖拽过程，`true` 为最终提交。
+     */
+    setColumnWidths(payloads: readonly {
+        colId: string;
+        width: number;
+    }[], finished?: boolean, source?: import('../types/columnResize').ColumnResizeSource): void;
+    /** 设置单列宽度（Phase 14） */
+    setColumnWidth(colId: string, width: number, finished?: boolean, source?: import('../types/columnResize').ColumnResizeSource): void;
+    /** 读取列当前像素宽度（Phase 14） */
+    getColumnWidth(colId: string): number;
+    /** 按当前可见单元格内容自动调整列宽（Phase 14+ · 对标 autoSizeColumn） */
+    autoSizeColumn(colId: string, skipHeader?: boolean): void;
+    /** 批量 auto-size（Phase 14+ · 对标 autoSizeColumns） */
+    autoSizeColumns(colIds: readonly string[], skipHeader?: boolean): void;
+    /** 将列宽按比例分配至视口（或指定宽度）；对标 sizeColumnsToFit */
+    sizeColumnsToFit(params?: import('../types/columnAutosize').SizeColumnsToFitParams): void;
+    /**
+     * 设置单行高度并 pinned（Phase 15）。
+     *
+     * - 高度会 clamp 至 `rowHeightMin` / `rowHeightMax`。
+     * - `finished: false` 用于 resize 拖拽过程；`true`（默认）为最终提交。
+     * - 触发 `rowHeightChanged`（`source: 'api'`）。
+     */
+    setRowHeight(rowId: RowId, height: number, finished?: boolean): void;
+    /** 批量设置行高（Phase 15）；语义同 {@link setRowHeight} */
+    setRowHeights(changes: readonly {
+        rowId: RowId;
+        height: number;
+    }[], finished?: boolean): void;
+    /** 读取行当前有效高度（px）；行不存在时 `null` */
+    getRowHeight(rowId: RowId): number | null;
+    /**
+     * 清除 pinned 并重算行高（getRowHeight / autoHeight / 默认行高）。
+     *
+     * - 省略 `rowIds` 时重置全部 display 行。
+     * - 触发 `rowHeightChanged`（`source: 'api'` · `finished: true`）。
+     */
+    resetRowHeights(rowIds?: readonly RowId[]): void;
+    /**
+     * 热更新默认行高与 clamp 边界（Phase 15 · MagicGrid `rowHeight` prop）。
+     *
+     * 不销毁 Grid；pinned / getRowHeight / autoHeight 行保持既有规则。
+     */
+    updateDimensions(params: import('../types/rowHeight').UpdateRowDimensionsParams): void;
+    /**
+     * 刷新指定行或列的单元格 DOM（不重跑全表 setData）。
+     *
+     * @param params.rowIds 限定行；省略则刷新当前虚拟窗口内可见行
+     * @param params.colIds 限定列 colId
+     * @param params.force 强制重绘，即使值未变
+     * @returns 实际刷新的行数
+     */
+    refreshCells(params?: RefreshCellsParams): number;
+    /**
+     * Phase 16 · 强制重建单元格合并 cache 并刷新可见行 / 表尾。
+     *
+     * 用于外部改写行数据后未走 `setData` / `applyTransaction`，
+     * 或 `spanRows` 自定义比较所依赖的外部状态变化。
+     * 需 Grid `enableCellSpan: true` 才有可见效果。
+     */
+    refreshCellSpans(): void;
+    /**
+     * Phase 16 · 只读查询 `(rowId, colId)` 所属 span。
+     *
+     * - 无合并 / 未开启 `enableCellSpan` / 位置无效 → `null`
+     * - `rowId` 接受业务主键或内核 id（number / string）
+     */
+    getCellSpan(rowId: RowId, colId: string): CellSpanInfo | null;
+    /**
+     * 滚动使指定**行下标**（`rowsToDisplay` 中的 index）进入视口。
+     *
+     * @param index 0-based 行下标，非 rowId
+     * @param position 对齐方式，默认 `'middle'`
+     */
+    ensureIndexVisible(index: number, position?: EnsureIndexVisiblePosition): void;
+    /**
+     * 按 rowId 获取行节点快照。
+     *
+     * @param id 业务主键或内核 id（number / string）；不存在时返回 `undefined`
+     */
+    getRowNode(id: RowId): RowNode | undefined;
+    /**
+     * 读取当前渲染与滚动指标（验收 / 调试用途）。
+     *
+     * 含视口行数、scrollTop、首末可见行下标、最近一次 setData 耗时等。
+     */
+    getMetrics(): GridMetrics;
+    /**
+     * 开启批量更新：多次 `applyTransaction` / `addRows` 合并为一次重绘。
+     *
+     * 须与 {@link endUpdate} 配对调用。
+     */
+    beginUpdate(): void;
+    /** 结束批量更新并 flush 累积的事务。 */
+    endUpdate(): void;
+    /**
+     * 编程式滚动视口。
+     *
+     * @param scrollTop 垂直滚动位置（px）
+     * @param scrollLeft 水平滚动位置（px）；省略则保持当前值
+     */
+    scrollTo(scrollTop: number, scrollLeft?: number): void;
+    /**
+     * 编程式进入单元格编辑。
+     *
+     * @param params.rowIndex `rowsToDisplay` 中的 0-based 行下标
+     * @param params.colKey 列 `colId` 或 `prop`
+     *
+     * 列不可编辑或该行正在行编辑模式时无效果。
+     */
+    startEditingCell(params: {
+        rowIndex: number;
+        colKey: string;
+    }): void;
+    /**
+     * 结束当前编辑会话。
+     *
+     * @param cancel `true` 丢弃修改并退出；`false`（默认）尝试提交。
+     * @returns 异步提交完成时 resolve；无编辑态时立即 resolve
+     */
+    stopEditing(cancel?: boolean): Promise<void>;
+    /** 是否存在任意单元格 / 行处于编辑态。 */
+    isEditing(): boolean;
+    /** 是否正在异步提交（commit 管线进行中）。提交期间 Tab 导航等行为受限。 */
+    isCommitting(): boolean;
+    /**
+     * 中断进行中的异步提交，保持编辑态与编辑器焦点。
+     *
+     * 触发 `editCommitAborted` 事件。
+     */
+    cancelCommit(): void;
+    /**
+     * 当前编辑会话阶段。
+     *
+     * - `'idle'` — 无编辑
+     * - `'editing'` — 编辑中
+     * - `'committing'` — 异步提交中
+     * - `'cancelling'` — 取消中
+     */
+    getEditSessionPhase(): EditSessionPhase;
+    /** 当前主编辑单元格；无编辑时 `null`。rowId 为业务类型（与 data[rowKey] 一致，临时行为 null）。 */
+    getEditingCell(): {
+        rowId: import('../types/businessRowId').BusinessRowId;
+        colId: string;
+    } | null;
+    /** 行编辑模式下所有正在编辑的单元格位置列表。 */
+    getEditingCells(): EditingCellPosition[];
+    /**
+     * 向当前 Grid 实例注册命名单元格编辑器。
+     *
+     * 列定义 `cellEditor: 'myEditor'` 时优先解析实例级注册，再回退全局注册表。
+     */
+    registerCellEditor(name: string, editor: CellEditorFn): void;
+    /** 注销实例级编辑器；成功返回 `true`。 */
+    unregisterCellEditor(name: string): boolean;
+    /**
+     * 校验全表或指定行的持久化数据。
+     *
+     * 扫描可编辑列的 `cellValidator` 与 Grid 级 `rowValidator`；
+     * 默认更新 invalid 视觉反馈（`showFeedback: false` 可仅返回结果）。
+     */
+    validate(options?: ValidateGridOptions): Promise<GridValidationResult>;
+    /** 校验指定行列表（语义同 {@link validate} 的 `rowIds` 分支）。 */
+    validateRows(options: ValidateRowsOptions): Promise<GridValidationResult>;
+    /**
+     * 校验指定单元格列表（不跑 rowValidator）。
+     *
+     * `cells[].rowId` 接受 number / string。
+     */
+    validateCells(options: ValidateCellsOptions): Promise<GridValidationResult>;
+    /** 清除全表或指定行的校验视觉反馈。 */
+    clearValidation(options?: ClearValidationOptions): void;
+    /** 清除指定行的校验视觉反馈。 */
+    clearRowValidation(options: ClearRowValidationOptions): void;
+    /** 清除指定单元格的校验视觉反馈。 */
+    clearCellValidation(options: ClearCellValidationOptions): void;
+    /**
+     * 切换或设置行的 checkbox 选中状态（行选择列 / `SelectionService`）。
+     *
+     * @param rowIds 单个或批量 rowId（number / string）
+     * @param selected 省略时 **toggle**；`true` 选中；`false` 取消选中
+     * @param force `true` 时忽略 `isRowSelectable`：
+     *   - 选中：可操作 disabled 行；
+     *   - 取消：可强制取消 disabled 已选行；
+     *   - 已选中 + `selected: true` 时不重复 toggle
+     *
+     * 变更时 emit `selectionChanged`。disabled 行默认不可通过本 API 取消选中（须 force）。
+     */
+    toggleRowSelection(rowIds: RowIdInput, selected?: boolean, force?: boolean): void;
+    /**
+     * 表头全选 checkbox 操作（`rowSelection: 'multiple'` 时有效）。
+     *
+     * @param selected 省略时 **toggle**；
+     *   `true` 选中当前可见且可选的行；
+     *   `false` 取消可见可选行（**保留** disabled 已选行）
+     */
+    toggleAllSelection(selected?: boolean): void;
+    /**
+     * 设置索引列辅助定位（`IndexFocusService`），不触发鼠标拖拉。
+     *
+     * @param rowIds 单个或批量 rowId；传空数组 `[]` 清除定位
+     *
+     * - `focusMode: 'single'` 时仅保留首个有效 id。
+     * - 变更时 emit `indexFocusChanged`。
+     * - 若开启 `syncToSelectionColumn` 且模式兼容，会单向同步到行选择列（跳过不可选行）。
+     *
+     * 须启用 `showIndexColumn`；未启用时为 no-op。
+     */
+    setIndexFocus(rowIds: RowIdInput): void;
+    /** 展开主行；非 master 或未启用 `masterDetail` 时返回 `false`。 */
+    expandRow(rowId: RowId): boolean;
+    /** 折叠主行；未展开或未启用时返回 `false`。 */
+    collapseRow(rowId: RowId): boolean;
+    /** 主行是否已展开。 */
+    isRowExpanded(rowId: RowId): boolean;
+    /** 展开当前 display 中全部可展开 master 行。 */
+    expandAll(): void;
+    /** 折叠全部已展开主行 / 分组（取决于启用的能力）。 */
+    collapseAll(): void;
+    /** 设置分组列顺序；需 `rowGrouping: true`。触发 `rowGroupChanged`。 */
+    setRowGroupColumns(colIds: readonly string[]): void;
+    /** 当前分组列 colId 列表。 */
+    getRowGroupColumns(): readonly string[];
+    /** 展开分组节点；未启用 rowGrouping 或 groupId 无效时返回 `false`。 */
+    expandGroup(groupId: string): boolean;
+    /** 折叠分组节点。 */
+    collapseGroup(groupId: string): boolean;
+    /** 分组是否已展开。 */
+    isGroupExpanded(groupId: string): boolean;
+    /** 展开 tree 节点；未启用 tree 时返回 `false`。 */
+    expandNode(rowId: RowId): boolean;
+    /** 折叠 tree 节点。 */
+    collapseNode(rowId: RowId): boolean;
+    /** tree 节点是否已展开。 */
+    isNodeExpanded(rowId: RowId): boolean;
+    /** 查询行的 dataPath；未启用 tree 时返回 `undefined`。 */
+    getDataPath(rowId: RowId): string[] | undefined;
+    /** 读取批注；无则 `undefined`。 */
+    getCellComment(rowId: RowId, colId: string): import('../types/cellComment').CellComment | undefined;
+    /** 设置或删除批注（`comment=null/undefined`）；`source` 记为 `api`。 */
+    setCellComment(rowId: RowId, colId: string, comment: import('../types/cellComment').CellComment | null | undefined): Promise<void>;
+    /** 刷新可见 cell 批注角标；popup 不强制重建。 */
+    refreshCellComments(params?: import('../types/cellComment').RefreshCellCommentsParams): void;
+    /** 读取当前 cell range 列表（0..n）。 */
+    getCellRanges(): import('../types/cellRangeSelection').CellRange[];
+    /** Phase 24.1 · 当前框选聚合统计；无选区或未开框选时返回 null。 */
+    getCellSelectionAggregation(): import('../types/cellSelectionAggregation').CellSelectionAggregation | null;
+    /** 清除全部 cell range。 */
+    clearCellSelection(): void;
+    /** 追加一个 cell range（非法参数忽略）。 */
+    addCellRange(params: import('../types/cellRangeSelection').CellRange): void;
+    /** 复制当前选区到系统剪贴板（TSV）。 */
+    copySelectedRangeToClipboard(): void;
+    /** 从系统剪贴板粘贴到选区起点。 */
+    pasteFromClipboard(): Promise<void>;
+    /** 等价 `setGridOption('loading', true)`。 */
+    showLoadingOverlay(): void;
+    /** 强制显示 noRows overlay，直至 `hideOverlay()`。 */
+    showNoRowsOverlay(): void;
+    /**
+     * 隐藏当前 overlay。
+     * noMatchingRows 仅随 filter/数据恢复自动隐藏；loading=true 时无效。
+     */
+    hideOverlay(): void;
+    /** 是否有 overlay 正在显示。 */
+    isOverlayShowing(): boolean;
+    /** 当前 overlay 类型；无 overlay 时返回 `null`。 */
+    getOverlayType(): import('../types/emptyState').OverlayType | null;
+    /** Phase 21 · 重算可见单元格 disabled 投影（class · inline 控件 · aria） */
+    refreshDisabledState(params?: import('../types/cellDisable').RefreshDisabledStateParams): void;
+    /** Phase 26 · 重算可见单元格 backgroundColor / color 投影 */
+    refreshCellStyles(params?: import('../types/cellColor').RefreshCellStylesParams): void;
+    /**
+     * 销毁 Grid 实例：解绑监听、取消编辑、清理 DOM。
+     *
+     * 组件 `onUnmounted` 时自动调用；手动调用后不可再使用 API。
+     */
+    destroy(): void;
+    /**
+     * 订阅 Grid 事件。
+     *
+     * @returns 取消订阅函数
+     *
+     * @example
+     * ```ts
+     * const off = api.on('selectionChanged', ({ selectedRowIds }) => { ... })
+     * off()
+     * ```
+     */
+    on<T extends GridEventType>(type: T, handler: GridEventHandler<T>): () => void;
+}
+/**
+ * 从 `Grid` 实例创建 API 对象（内核构造时调用，一般无需直接使用）。
+ *
+ * 纯委托层：不含业务逻辑，便于测试时对 `GridApi` 接口 mock。
+ */
+export declare function createGridApi(grid: Grid): GridApi;
+//# sourceMappingURL=gridApi.d.ts.map

package/dist/core/api/gridApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridApi.d.ts","sourceRoot":"","sources":["../../../src/core/api/gridApi.ts"],"names":[],"mappings":"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"}

package/dist/core/api/index.d.ts

@@ -0,0 +1,3 @@
+export { createGridApi } from './gridApi';
+export type { EnsureIndexVisiblePosition, GridApi } from './gridApi';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EAAE,0BAA0B,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/dist/core/cell/cellCtrl.d.ts

@@ -0,0 +1,52 @@
+import { InlineCellEditorRefreshContext } from '../editing/inlineCellEditorService';
+import { CellDisableContext } from '../editing/cellDisablePipeline';
+import { CellStyleContext } from '../styling/cellStylePipeline';
+import { RowExpansionHost } from '../types/rowExpansion';
+import { RowGroupingHost } from '../types/rowGrouping';
+import { TreeTableHost } from '../types/treeTable';
+import { ResolvedIndexColumnOptions } from '../types/indexColumn';
+import { ResolvedSelectionColumnGridOptions } from '../types/selectionColumn';
+import { Column, ICellComp, RowNode } from '../types';
+import { BusinessRowId } from '../types/businessRowId';
+export declare function valuesAreEqual(left: string, right: string): boolean;
+export interface CellCtrlRefreshOptions {
+    force?: boolean;
+    scheduleRenderer?: (task: () => void) => void;
+    scheduleInlineEditor?: (task: () => void) => void;
+    inlineEditor?: InlineCellEditorRefreshContext;
+    indexColumnOptions?: ResolvedIndexColumnOptions;
+    selectionColumnOptions?: ResolvedSelectionColumnGridOptions;
+    selectionChecked?: boolean;
+    selectionDisabled?: boolean;
+    rowExpansionHost?: RowExpansionHost;
+    rowGroupingHost?: RowGroupingHost;
+    treeTableHost?: TreeTableHost;
+    selectionIndeterminate?: boolean;
+    resolveBusinessRowId?: (rowNode: RowNode) => BusinessRowId;
+    cellDisableContext?: CellDisableContext;
+    getCellDisableContext?: () => CellDisableContext;
+    cellStyleContext?: CellStyleContext;
+    getCellStyleContext?: () => CellStyleContext;
+}
+/** 单元格逻辑层：值缓存 + 定向 DOM 写 + 自定义渲染器 */
+export declare class CellCtrl {
+    private cachedValue;
+    private cachedRenderKey;
+    private cacheVersion;
+    private inlineSession;
+    private activeResolveBusinessRowId?;
+    refreshCell(rowNode: RowNode, column: Column, cellComp: ICellComp, valueCacheVersion: number, options?: boolean | CellCtrlRefreshOptions): boolean;
+    private syncCellDisabledVisual;
+    private syncCellStyleVisual;
+    invalidate(): void;
+    private clearInlineSession;
+    private refreshInlineEditorCell;
+    private mountInlineEditor;
+    private refreshSelectionCell;
+    private refreshExpandCell;
+    private refreshGroupCell;
+    private refreshTreeCell;
+    private refreshRendererCell;
+    private applyRenderer;
+}
+//# sourceMappingURL=cellCtrl.d.ts.map

package/dist/core/cell/cellCtrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellCtrl.d.ts","sourceRoot":"","sources":["../../../src/core/cell/cellCtrl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAA;AAS3F,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAA;AAMxC,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AACpG,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAA;AAQhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAA;AACrF,OAAO,KAAK,EAGV,MAAM,EACN,SAAS,EACT,OAAO,EACR,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IAC7C,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IACjD,YAAY,CAAC,EAAE,8BAA8B,CAAA;IAC7C,kBAAkB,CAAC,EAAE,0BAA0B,CAAA;IAC/C,sBAAsB,CAAC,EAAE,kCAAkC,CAAA;IAC3D,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,CAAA;IAC1D,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,qBAAqB,CAAC,EAAE,MAAM,kBAAkB,CAAA;IAChD,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,mBAAmB,CAAC,EAAE,MAAM,gBAAgB,CAAA;CAC7C;AAOD,qCAAqC;AACrC,qBAAa,QAAQ;IACnB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,0BAA0B,CAAC,CAAqC;IAExE,WAAW,CACT,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,EACnB,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,OAAO,GAAG,sBAA8B,GAChD,OAAO;IA2HV,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,mBAAmB;IAU3B,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,uBAAuB;IAsD/B,OAAO,CAAC,iBAAiB;IAgEzB,OAAO,CAAC,oBAAoB;IAiD5B,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,gBAAgB;IAsDxB,OAAO,CAAC,eAAe;IAsCvB,OAAO,CAAC,mBAAmB;IA0C3B,OAAO,CAAC,aAAa;CA+BtB"}

package/dist/core/cell/footerCellCtrl.d.ts

@@ -0,0 +1,17 @@
+import { SummaryCellResult } from '../summary/summaryService';
+import { Column, ICellComp } from '../types';
+export interface FooterCellCtrlRefreshOptions {
+    force?: boolean;
+    scheduleRenderer?: (task: () => void) => void;
+}
+/** 表尾汇总格逻辑层：值缓存 + 定向 DOM 写 + cellRenderer */
+export declare class FooterCellCtrl {
+    private cachedValue;
+    private cachedRenderKey;
+    private cacheVersion;
+    refreshSummaryCell(column: Column, cellResult: SummaryCellResult, cellComp: ICellComp, valueCacheVersion: number, options?: boolean | FooterCellCtrlRefreshOptions): boolean;
+    invalidate(): void;
+    private refreshRendererCell;
+    private applyRenderer;
+}
+//# sourceMappingURL=footerCellCtrl.d.ts.map

package/dist/core/cell/footerCellCtrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footerCellCtrl.d.ts","sourceRoot":"","sources":["../../../src/core/cell/footerCellCtrl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAKrE,OAAO,KAAK,EAGV,MAAM,EACN,SAAS,EACV,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;CAC9C;AAED,6CAA6C;AAC7C,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAK;IAEzB,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,SAAS,EACnB,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,OAAO,GAAG,4BAAoC,GACtD,OAAO;IAkCV,UAAU,IAAI,IAAI;IAKlB,OAAO,CAAC,mBAAmB;IA0C3B,OAAO,CAAC,aAAa;CA+BtB"}

package/dist/core/cell/index.d.ts

@@ -0,0 +1,2 @@
+export { CellCtrl, valuesAreEqual } from './cellCtrl';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/cell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/cell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/core/cellComment/cellCommentContextMenu.d.ts

@@ -0,0 +1,32 @@
+export declare const CELL_COMMENT_CONTEXT_MENU_ITEMS_CLASS = "mg-cell-comment-context-menu__items";
+export declare const CELL_COMMENT_CONTEXT_MENU_ITEM_CLASS = "mg-cell-comment-context-menu__item";
+export declare const CELL_COMMENT_CONTEXT_MENU_ITEM_LABEL_CLASS = "mg-cell-comment-context-menu__item-label";
+export declare const CELL_COMMENT_CONTEXT_MENU_ITEM_COMMITTING_CLASS = "mg-cell-comment-context-menu__item--committing";
+export declare const CELL_COMMENT_CONTEXT_MENU_LOADING_CLASS = "mg-cell-comment-context-menu__loading-icon";
+export type CellCommentContextMenuAction = 'add' | 'edit' | 'view' | 'remove';
+/** false 或 reject → 保持菜单；void / true → 成功后关闭 */
+export type CellCommentContextMenuSelectResult = void | boolean | Promise<void | boolean>;
+export interface CellCommentContextMenuItem {
+    id: CellCommentContextMenuAction;
+    label: string;
+    disabled?: boolean;
+}
+export interface MountCellCommentContextMenuOptions {
+    clientX: number;
+    clientY: number;
+    items: readonly CellCommentContextMenuItem[];
+    mountEl?: HTMLElement;
+    /** 提供时菜单锚定在批注角标右侧（与 popup 一致） */
+    anchorEl?: HTMLElement;
+    onSelect: (id: CellCommentContextMenuAction) => CellCommentContextMenuSelectResult;
+    onClose?: () => void;
+}
+export interface CellCommentContextMenuHandle {
+    close: (force?: boolean) => void;
+}
+export declare function resolveCellCommentContextMenuPosition(options: Pick<MountCellCommentContextMenuOptions, 'clientX' | 'clientY' | 'anchorEl' | 'mountEl'>, menuWidth: number, menuHeight: number): {
+    left: number;
+    top: number;
+};
+export declare function mountCellCommentContextMenu(options: MountCellCommentContextMenuOptions): CellCommentContextMenuHandle;
+//# sourceMappingURL=cellCommentContextMenu.d.ts.map

package/dist/core/cellComment/cellCommentContextMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellCommentContextMenu.d.ts","sourceRoot":"","sources":["../../../src/core/cellComment/cellCommentContextMenu.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,qCAAqC,wCAAwC,CAAA;AAC1F,eAAO,MAAM,oCAAoC,uCAAuC,CAAA;AACxF,eAAO,MAAM,0CAA0C,6CAA6C,CAAA;AACpG,eAAO,MAAM,+CAA+C,mDACV,CAAA;AAClD,eAAO,MAAM,uCAAuC,+CAA+C,CAAA;AAEnG,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE7E,gDAAgD;AAChD,MAAM,MAAM,kCAAkC,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAA;AAEzF,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,4BAA4B,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAA;IAC5C,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,EAAE,CAAC,EAAE,EAAE,4BAA4B,KAAK,kCAAkC,CAAA;IAClF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACjC;AAMD,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,IAAI,CAAC,kCAAkC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC,EACjG,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA2B/B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,4BAA4B,CAmL9B"}

package/dist/core/cellComment/cellCommentIndicator.d.ts

@@ -0,0 +1,4 @@
+import { CellCommentIndicatorState } from '../types/cellComment';
+/** 同步单元格批注角标 DOM（零额外节点 · CSS ::after） */
+export declare function syncCellCommentIndicator(cellEl: HTMLElement, state: CellCommentIndicatorState): void;
+//# sourceMappingURL=cellCommentIndicator.d.ts.map

package/dist/core/cellComment/cellCommentIndicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellCommentIndicator.d.ts","sourceRoot":"","sources":["../../../src/core/cellComment/cellCommentIndicator.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAA;AAEhC,yCAAyC;AACzC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,yBAAyB,GAC/B,IAAI,CAYN"}

package/dist/core/cellComment/cellCommentIndicatorGeometry.d.ts

@@ -0,0 +1,7 @@
+/** 与 CSS `.mg-cell--has-comment::after` 的 top/right 一致 */
+export declare const CELL_COMMENT_INDICATOR_INSET_PX = 2;
+export declare const DEFAULT_CELL_COMMENT_INDICATOR_SIZE_PX = 6;
+export declare function resolveCellCommentIndicatorSizePx(el: HTMLElement | null | undefined, fallback?: number): number;
+export declare function resolveCellCommentIndicatorRect(cellRect: DOMRectReadOnly, indicatorSizePx: number, indicatorInsetPx?: number): DOMRectReadOnly;
+export declare function isPointerOverCellCommentIndicator(cellEl: HTMLElement, clientX: number, clientY: number): boolean;
+//# sourceMappingURL=cellCommentIndicatorGeometry.d.ts.map

package/dist/core/cellComment/cellCommentIndicatorGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellCommentIndicatorGeometry.d.ts","sourceRoot":"","sources":["../../../src/core/cellComment/cellCommentIndicatorGeometry.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAChD,eAAO,MAAM,sCAAsC,IAAI,CAAA;AAEvD,wBAAgB,iCAAiC,CAC/C,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAClC,QAAQ,SAAyC,GAChD,MAAM,CAcR;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,eAAe,EACzB,eAAe,EAAE,MAAM,EACvB,gBAAgB,SAAkC,GACjD,eAAe,CAkBjB;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAmBT"}