@taocompany/magic-grid 0.1.0

package/dist/core/selection/cellClipboardCell.d.ts

@@ -0,0 +1,33 @@
+import { ParsedCellEditValue } from '../editing/cellEditPipeline';
+import { Column, RowNode } from '../types';
+import { CellEditorParams } from '../types/cellEditor';
+import { ResolvedIndexColumnOptions } from '../types/indexColumn';
+import { ProcessCellForClipboardFn, ProcessCellFromClipboardFn, ProcessCellForClipboardParams, ProcessCellFromClipboardParams } from '../types/cellClipboard';
+export type PasteCellOutcome = {
+    status: 'applied';
+    parsed: unknown;
+} | {
+    status: 'blocked';
+    showBlockedVisual: boolean;
+};
+/** 将 raw 值序列化为 TSV 单元格文本 */
+export declare function formatCellRawValueForClipboard(value: unknown): string;
+/** 复制导出单格文本；useFormatterForClipboard=false 时复制 raw */
+export declare function resolveCellClipboardExportValue(rowNode: RowNode, column: Pick<Column, 'useFormatterForClipboard' | 'prop' | 'colId' | 'getter' | 'formatter'>, indexColumnOptions?: ResolvedIndexColumnOptions): string;
+export declare function buildProcessCellForClipboardParams(rowIndex: number, rowNode: RowNode, column: Column, value: unknown, editorParams: CellEditorParams, indexColumnOptions?: ResolvedIndexColumnOptions): ProcessCellForClipboardParams;
+export declare function buildProcessCellFromClipboardParams(rowIndex: number, rowNode: RowNode, column: Column, value: unknown, oldValue: unknown, editorParams: CellEditorParams, indexColumnOptions?: ResolvedIndexColumnOptions): ProcessCellFromClipboardParams;
+/** 复制导出（含 processCellForClipboard） */
+export declare function resolveCellClipboardExportValueWithCallback(rowIndex: number, rowNode: RowNode, column: Column, indexColumnOptions: ResolvedIndexColumnOptions | undefined, editorParams: CellEditorParams, processCellForClipboard?: ProcessCellForClipboardFn): string;
+/** 粘贴输入 → 解析值（含 processCellFromClipboard） */
+export declare function resolvePasteParsedValueWithCallback(rawText: string, column: Column, rowIndex: number, rowNode: RowNode, editorParams: CellEditorParams, indexColumnOptions: ResolvedIndexColumnOptions | undefined, processCellFromClipboard?: ProcessCellFromClipboardFn): ParsedCellEditValue;
+/** 解析粘贴字符串；useParserForClipboard=false 时原样返回 */
+export declare function resolvePasteParsedValue(rawText: string, column: Pick<Column, 'cellEditor' | 'valueParser' | 'useParserForClipboard'>, editorParams: CellEditorParams): ParsedCellEditValue;
+/** 粘贴单格：parse → validate → write；与编辑提交管线对齐 */
+export declare function commitPasteCell(column: Column, editorParams: CellEditorParams, rawText: string, oldValue: unknown, options: {
+    rowIndex: number;
+    rowNode: RowNode;
+    indexColumnOptions?: ResolvedIndexColumnOptions;
+    processCellFromClipboard?: ProcessCellFromClipboardFn;
+    signal?: AbortSignal;
+}): Promise<PasteCellOutcome>;
+//# sourceMappingURL=cellClipboardCell.d.ts.map

package/dist/core/selection/cellClipboardCell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellClipboardCell.d.ts","sourceRoot":"","sources":["../../../src/core/selection/cellClipboardCell.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAA;AAIvC,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,2BAA2B,CAAA;AAElC,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,CAAA;AAErD,4BAA4B;AAC5B,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUrE;AAED,sDAAsD;AACtD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC,EAC5F,kBAAkB,CAAC,EAAE,0BAA0B,GAC9C,MAAM,CAMR;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,gBAAgB,EAC9B,kBAAkB,CAAC,EAAE,0BAA0B,GAC9C,6BAA6B,CAU/B;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,gBAAgB,EAC9B,kBAAkB,CAAC,EAAE,0BAA0B,GAC9C,8BAA8B,CAYhC;AAsBD,sCAAsC;AACtC,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,0BAA0B,GAAG,SAAS,EAC1D,YAAY,EAAE,gBAAgB,EAC9B,uBAAuB,CAAC,EAAE,yBAAyB,GAClD,MAAM,CAkBR;AAED,6CAA6C;AAC7C,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,gBAAgB,EAC9B,kBAAkB,EAAE,0BAA0B,GAAG,SAAS,EAC1D,wBAAwB,CAAC,EAAE,0BAA0B,GACpD,mBAAmB,CA0BrB;AAED,gDAAgD;AAChD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,GAAG,uBAAuB,CAAC,EAC5E,YAAY,EAAE,gBAAgB,GAC7B,mBAAmB,CAMrB;AAED,8CAA8C;AAC9C,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,kBAAkB,CAAC,EAAE,0BAA0B,CAAA;IAC/C,wBAAwB,CAAC,EAAE,0BAA0B,CAAA;IACrD,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,GACA,OAAO,CAAC,gBAAgB,CAAC,CA8B3B"}

package/dist/core/selection/cellClipboardService.d.ts

@@ -0,0 +1,55 @@
+import { ColumnModel } from '../column/columnModel';
+import { GridApi } from '../api/gridApi';
+import { CellDisableContext } from '../editing/cellEditPipeline';
+import { EventBus } from '../event/eventBus';
+import { CellFocusService } from '../navigation/cellFocusService';
+import { ClientSideRowModel } from '../rowModel/clientSideRowModel';
+import { RowTransaction } from '../types';
+import { CellClipboardGridOptions } from '../types/cellClipboard';
+import { ResolvedIndexColumnGridOptions } from '../types/indexColumn';
+import { CellRange, CellRangePasteFlashCell, ResolvedCellSelectionGridOptions } from '../types/cellRangeSelection';
+import { CellRangeOperationContext, CellRangeService } from './cellRangeService';
+export interface CellClipboardServiceDeps {
+    rowModel: ClientSideRowModel;
+    columnModel: ColumnModel;
+    eventBus: EventBus;
+    cellFocusService: CellFocusService;
+    getCellRangeService: () => CellRangeService | null;
+    getCellRangeOperationContext: () => CellRangeOperationContext;
+    getCellSelectionOptions: () => ResolvedCellSelectionGridOptions;
+    getIndexColumnOptions: () => ResolvedIndexColumnGridOptions;
+    getCellDisableContext: () => CellDisableContext;
+    getApi: () => GridApi;
+    applyTransaction: (transaction: RowTransaction) => void;
+    refreshCells: (params?: {
+        rowIds?: string[];
+        colIds?: string[];
+    }) => number;
+    isEditing: () => boolean;
+    stopEditing: (cancel: boolean) => Promise<void>;
+    writeToClipboard?: (text: string) => Promise<void>;
+    readFromClipboard?: () => Promise<string>;
+    onCopyVisualFeedback?: () => void;
+    onPasteVisualFeedback?: (cells: readonly CellRangePasteFlashCell[]) => void;
+    getCellClipboardOptions: () => CellClipboardGridOptions;
+}
+export declare class CellClipboardService {
+    private readonly deps;
+    constructor(deps: CellClipboardServiceDeps);
+    isEnabled(): boolean;
+    /** 复制当前选区到剪贴板；无 range 时 no-op。 */
+    copySelectedRanges(): boolean;
+    /** 从剪贴板粘贴；返回写入格数。 */
+    pasteFromClipboard(): Promise<number>;
+    serializeRanges(ranges: readonly CellRange[], context: CellRangeOperationContext): string;
+    private resolvePasteAnchor;
+    /** 单格粘贴时：选区合计超过 1 格则填充整个选区 */
+    private shouldPasteSingleCellToRanges;
+    private applySingleCellPasteToRanges;
+    private applyPasteMatrix;
+    private pasteCell;
+    private resolveIndexColumnDisplayOptions;
+    private writeClipboard;
+    private readClipboard;
+}
+//# sourceMappingURL=cellClipboardService.d.ts.map

package/dist/core/selection/cellClipboardService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellClipboardService.d.ts","sourceRoot":"","sources":["../../../src/core/selection/cellClipboardService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AAEzE,OAAO,KAAK,EACV,8BAA8B,EAE/B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACtC,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAIrF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,WAAW,EAAE,WAAW,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;IAClB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,mBAAmB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAA;IAClD,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;IAC7D,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;IAC/D,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;IAC3D,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;IAC/C,MAAM,EAAE,MAAM,OAAO,CAAA;IACrB,gBAAgB,EAAE,CAAC,WAAW,EAAE,cAAc,KAAK,IAAI,CAAA;IACvD,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,MAAM,CAAA;IAC3E,SAAS,EAAE,MAAM,OAAO,CAAA;IACxB,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACzC,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAA;IACjC,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,KAAK,IAAI,CAAA;IAC3E,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;CACxD;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAE3D,SAAS,IAAI,OAAO;IAKpB,kCAAkC;IAClC,kBAAkB,IAAI,OAAO;IAsB7B,qBAAqB;IACf,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAgD3C,eAAe,CACb,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,OAAO,EAAE,yBAAyB,GACjC,MAAM;IA6ET,OAAO,CAAC,kBAAkB;IAgD1B,8BAA8B;IAC9B,OAAO,CAAC,6BAA6B;YAkCvB,4BAA4B;YA4E5B,gBAAgB;YAyEhB,SAAS;IAgEvB,OAAO,CAAC,gCAAgC;YAK1B,cAAc;YAWd,aAAa;CAW5B"}

package/dist/core/selection/cellClipboardTsv.d.ts

@@ -0,0 +1,14 @@
+/** TSV 单元格转义（Excel 兼容：含 tab/换行/引号时用双引号包裹） */
+export declare function escapeTsvCell(value: string): string;
+/** 单行 TSV */
+export declare function serializeTsvRow(cells: readonly string[]): string;
+/** 多 range 导出：range 间空行分隔 */
+export declare function serializeRangesToTsv(rangeBlocks: readonly string[][]): string;
+/**
+ * 解析 TSV/CSV 文本为二维数组。
+ * 支持引号字段、`\r\n`、字段内 `\t`。
+ */
+export declare function parseTsv(text: string): string[][];
+/** 剪贴板是否为单格内容（1×1，非多格矩阵） */
+export declare function isSingleCellClipboardMatrix(matrix: readonly (readonly string[])[]): boolean;
+//# sourceMappingURL=cellClipboardTsv.d.ts.map

package/dist/core/selection/cellClipboardTsv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellClipboardTsv.d.ts","sourceRoot":"","sources":["../../../src/core/selection/cellClipboardTsv.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,aAAa;AACb,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEhE;AAED,6BAA6B;AAC7B,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,MAAM,CAK7E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CA+EjD;AAED,4BAA4B;AAC5B,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,CAE3F"}

package/dist/core/selection/cellRangeService.d.ts

@@ -0,0 +1,37 @@
+import { RowKind } from '../types/rowExpansion';
+import { CellPosition, CellRange } from '../types/cellRangeSelection';
+export interface CellRangeOperationContext {
+    displayedColIds: readonly string[];
+    rowKindAt?: (rowIndex: number) => RowKind | undefined;
+}
+export interface CellRangeServiceOptions {
+    suppressMultiRanges?: boolean;
+}
+export declare function findRangeIndexContaining(cell: CellPosition, ranges: readonly CellRange[], displayedColIds: readonly string[]): number;
+/** Excel 式单元格矩形选区状态机（多 range · anchor · 扩展） */
+export declare class CellRangeService {
+    private suppressMultiRanges;
+    private ranges;
+    private anchor;
+    constructor(suppressMultiRanges?: boolean);
+    getRanges(): readonly CellRange[];
+    getAnchor(): CellPosition | null;
+    hasRanges(): boolean;
+    isSuppressMultiRanges(): boolean;
+    setSuppressMultiRanges(value: boolean): void;
+    setAnchor(anchor: CellPosition | null): void;
+    clear(): boolean;
+    /** replace 全部（drag 默认） */
+    setRanges(ranges: readonly CellRange[], context: CellRangeOperationContext, anchor?: CellPosition | null): boolean;
+    /** append（Ctrl+click · addCellRange） */
+    addRange(range: CellRange, context: CellRangeOperationContext, anchor?: CellPosition): boolean;
+    /** Shift+点击 / Shift+方向键：自 anchor 扩展至 target */
+    extendFromAnchor(to: CellPosition, context: CellRangeOperationContext): boolean;
+    /**
+     * 扩展含 focus 的 range；无 anchor 时以 focus 为起点。
+     * 无匹配 range 且已有 ranges → append（多 range）或 replace（单 range）。
+     */
+    extendFocusedRange(focus: CellPosition, to: CellPosition, context: CellRangeOperationContext): boolean;
+    isCellInAnyRange(rowIndex: number, colId: string, displayedColIds: readonly string[]): boolean;
+}
+//# sourceMappingURL=cellRangeService.d.ts.map

package/dist/core/selection/cellRangeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellRangeService.d.ts","sourceRoot":"","sources":["../../../src/core/selection/cellRangeService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,gCAAgC,CAAA;AAEvC,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;CACtD;AAED,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AA6DD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,MAAM,CAiBR;AAED,+CAA+C;AAC/C,qBAAa,gBAAgB;IAIf,OAAO,CAAC,mBAAmB;IAHvC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAA4B;gBAEtB,mBAAmB,UAAO;IAE9C,SAAS,IAAI,SAAS,SAAS,EAAE;IAIjC,SAAS,IAAI,YAAY,GAAG,IAAI;IAIhC,SAAS,IAAI,OAAO;IAIpB,qBAAqB,IAAI,OAAO;IAIhC,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAO5C,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI;IAI5C,KAAK,IAAI,OAAO;IAUhB,0BAA0B;IAC1B,SAAS,CACP,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,OAAO,EAAE,yBAAyB,EAClC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,GAC3B,OAAO;IAwBV,wCAAwC;IACxC,QAAQ,CACN,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,yBAAyB,EAClC,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO;IAqBV,+CAA+C;IAC/C,gBAAgB,CACd,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,yBAAyB,GACjC,OAAO;IA0BV;;;OAGG;IACH,kBAAkB,CAChB,KAAK,EAAE,YAAY,EACnB,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,yBAAyB,GACjC,OAAO;IAkCV,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,OAAO;CAOX"}

package/dist/core/selection/filterSelectionPolicy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Phase 12 · filter 变更时的选区策略（拍板 #9 / docs §9.1）
+ *
+ * filter 仅影响 `rowsToDisplay` 与 DOM 可见性：
+ * - **不**调用 `toggleRowSelection(..., false)` 清理被隐藏行
+ * - **不** emit `selectionChanged`
+ * - 表头全选仅作用于当前可见行；隐藏但已选 id 仍保留在 `SelectionService`
+ *
+ * Grid 在 filter 管线变更后应调用 `applySelectionVisuals()` 刷新可见 checkbox /
+ * 表头三态，而不 mutate 选区 Set。
+ */
+export declare const FILTER_PRESERVES_HIDDEN_ROW_SELECTION: true;
+//# sourceMappingURL=filterSelectionPolicy.d.ts.map

package/dist/core/selection/filterSelectionPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterSelectionPolicy.d.ts","sourceRoot":"","sources":["../../../src/core/selection/filterSelectionPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qCAAqC,EAAG,IAAa,CAAA"}

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

@@ -0,0 +1,10 @@
+export { SelectionService } from './selectionService';
+export type { RowSelectionMode, SelectRowOptions } from './selectionService';
+export { CellRangeService, findRangeIndexContaining } from './cellRangeService';
+export { CellClipboardService } from './cellClipboardService';
+export type { CellClipboardServiceDeps } from './cellClipboardService';
+export { escapeTsvCell, parseTsv, serializeRangesToTsv, serializeTsvRow } from './cellClipboardTsv';
+export type { CellRangeOperationContext, CellRangeServiceOptions, } from './cellRangeService';
+export { evaluateSelectable, resolveSelectable } from './selectable';
+export type { SelectableFn, SelectableParams } from './selectable';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/selection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACnG,YAAY,EACV,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACpE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA"}

package/dist/core/selection/selectable.d.ts

@@ -0,0 +1,15 @@
+import { RowNode } from '../types';
+import { RowData } from '../../types';
+import { BusinessRowId } from '../types/businessRowId';
+/** 判定行 checkbox 是否可勾选时传入的上下文 */
+export interface SelectableParams {
+    /** 当前行数据（RowData 快照） */
+    data: RowData;
+    rowId: BusinessRowId;
+    rowIndex: number;
+}
+/** 行选择列行级可选判定；省略时全部可选 */
+export type SelectableFn = (params: SelectableParams) => boolean;
+export declare function resolveSelectable(value: SelectableFn | undefined): SelectableFn;
+export declare function evaluateSelectable(selectable: SelectableFn, rowNode: RowNode, rowKey: string): boolean;
+//# sourceMappingURL=selectable.d.ts.map

package/dist/core/selection/selectable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectable.d.ts","sourceRoot":"","sources":["../../../src/core/selection/selectable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAG9D,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAA;AAIhE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAE/E;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,YAAY,EACxB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAMT"}

package/dist/core/selection/selectionService.d.ts

@@ -0,0 +1,41 @@
+export type RowSelectionMode = 'single' | 'multiple';
+export interface SelectRowOptions {
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    /** 已选中行再次触发时取消选中（行选择列点击） */
+    toggleOnReselect?: boolean;
+    /** 范围选时保留已选但不可选（disabled）的行；须同时提供 rowCount 与 getAllRowIdAt */
+    rangeSelection?: SelectRangeOptions;
+}
+/** 范围选扩展：在跳过不可选行的同时保留已选 disabled 行 */
+export interface SelectRangeOptions {
+    rowCount: number;
+    getAllRowIdAt: (index: number) => string | undefined;
+}
+/** 行选择：单选 / 多选 + Ctrl 切换 + Shift 范围选 */
+export declare class SelectionService {
+    private readonly mode;
+    private selectedIds;
+    private anchorIndex;
+    constructor(mode?: RowSelectionMode);
+    getSelectedRowIds(): string[];
+    isSelected(rowId: string): boolean;
+    clear(): void;
+    removeRowIds(rowIds: Iterable<string>): boolean;
+    migrateRowId(oldRowId: string, newRowId: string): boolean;
+    getAnchorIndex(): number;
+    isMultiple(): boolean;
+    setAnchorIndex(rowIndex: number): void;
+    /** 返回是否有变更 */
+    selectRow(rowId: string, rowIndex: number, getRowIdAt: (index: number) => string | undefined, options?: SelectRowOptions): boolean;
+    selectRangeBetween(fromIndex: number, toIndex: number, getRowIdAt: (index: number) => string | undefined, options?: SelectRangeOptions): boolean;
+    isAllVisibleRowsSelected(rowCount: number, getRowIdAt: (index: number) => string | undefined): boolean;
+    selectAllVisibleRows(rowCount: number, getRowIdAt: (index: number) => string | undefined): boolean;
+    deselectAllVisibleRows(rowCount: number, getRowIdAt: (index: number) => string | undefined): boolean;
+    replaceSelectionWithVisibleRows(rowCount: number, getRowIdAt: (index: number) => string | undefined): boolean;
+    toggleSelectAllVisibleRows(rowCount: number, getRowIdAt: (index: number) => string | undefined): boolean;
+    replaceWithRowIds(rowIds: Iterable<string>, anchorIndex?: number): boolean;
+    addRowId(rowId: string, rowIndex?: number): boolean;
+    toggleRowId(rowId: string, rowIndex: number): boolean;
+}
+//# sourceMappingURL=selectionService.d.ts.map

package/dist/core/selection/selectionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionService.d.ts","sourceRoot":"","sources":["../../../src/core/selection/selectionService.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,CAAA;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4BAA4B;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,kBAAkB,CAAA;CACpC;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CACrD;AAED,wCAAwC;AACxC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,WAAW,CAAK;gBAEZ,IAAI,GAAE,gBAA2B;IAI7C,iBAAiB,IAAI,MAAM,EAAE;IAI7B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlC,KAAK,IAAI,IAAI;IAKb,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO;IAY/C,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAUzD,cAAc,IAAI,MAAM;IAIxB,UAAU,IAAI,OAAO;IAIrB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAItC,cAAc;IACd,SAAS,CACP,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EACjD,OAAO,GAAE,gBAAqB,GAC7B,OAAO;IAmDV,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EACjD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO;IA6CV,wBAAwB,CACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAChD,OAAO;IAeV,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAChD,OAAO;IAkBV,sBAAsB,CACpB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAChD,OAAO;IAaV,+BAA+B,CAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAChD,OAAO;IAIV,0BAA0B,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAChD,OAAO;IAQV,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,SAAK,GAAG,OAAO;IAWtE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,OAAO;IAoB/C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;CAOtD"}

package/dist/core/selection/treeSelectionCascade.d.ts

@@ -0,0 +1,13 @@
+import { RowNode } from '../types';
+export declare function collectVisibleTreeDescendantIds(displayRows: readonly RowNode[], parentIndex: number): string[];
+export declare function collectVisibleTreeChildIds(displayRows: readonly RowNode[], parentRowId: string): string[];
+export declare function resolveTreeSelectionIndeterminateIds(displayRows: readonly RowNode[], selectedIds: ReadonlySet<string>): Set<string>;
+export declare function applyTreeSelectionCascade(params: {
+    displayRows: readonly RowNode[];
+    rowId: string;
+    selected: boolean;
+    groupSelectsChildren: boolean;
+    selectedIds: Set<string>;
+}): boolean;
+export declare function syncTreeParentSelectionState(displayRows: readonly RowNode[], selectedIds: Set<string>): boolean;
+//# sourceMappingURL=treeSelectionCascade.d.ts.map

package/dist/core/selection/treeSelectionCascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeSelectionCascade.d.ts","sourceRoot":"","sources":["../../../src/core/selection/treeSelectionCascade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAQ1C,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAsBV;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAsBV;AAED,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,GAAG,CAAC,MAAM,CAAC,CAyBb;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,WAAW,EAAE,SAAS,OAAO,EAAE,CAAA;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACzB,GAAG,OAAO,CA4BV;AAED,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,OAAO,CAmCT"}

package/dist/core/sort/headerSortService.d.ts

@@ -0,0 +1,19 @@
+import { Column } from '../types/column';
+import { SortDirection, SortModelItem } from '../types';
+export type HeaderSortDirection = SortDirection | null;
+export interface HeaderSortServiceDeps {
+    getSortModel: () => SortModelItem[];
+    setSortModel: (model: SortModelItem[]) => void;
+    getColumnById: (colId: string) => Column | undefined;
+}
+/** 表头 sort 态投影：无匹配项时为 null */
+export declare function resolveHeaderSortState(colId: string, sortModel: readonly SortModelItem[]): HeaderSortDirection;
+export declare function resolveHeaderSortAriaSort(direction: HeaderSortDirection): 'ascending' | 'descending' | 'none';
+/** 表头 click / 键盘 toggle → setSortModel */
+export declare class HeaderSortService {
+    private readonly deps;
+    constructor(deps: HeaderSortServiceDeps);
+    toggleSort(colId: string): void;
+    getSortState(colId: string): HeaderSortDirection;
+}
+//# sourceMappingURL=headerSortService.d.ts.map

package/dist/core/sort/headerSortService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerSortService.d.ts","sourceRoot":"","sources":["../../../src/core/sort/headerSortService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAI/D,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,IAAI,CAAA;AAEtD,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,aAAa,EAAE,CAAA;IACnC,YAAY,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAA;IAC9C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CACrD;AAED,8BAA8B;AAC9B,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,aAAa,EAAE,GAClC,mBAAmB,CAGrB;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,mBAAmB,GAC7B,WAAW,GAAG,YAAY,GAAG,MAAM,CAUrC;AAED,0CAA0C;AAC1C,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,qBAAqB;IAExD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAe/B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB;CAGjD"}

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

@@ -0,0 +1,3 @@
+export { toggleHeaderSort, type ToggleHeaderSortParams } from './toggleHeaderSort';
+export { HeaderSortService, resolveHeaderSortAriaSort, resolveHeaderSortState, type HeaderSortDirection, type HeaderSortServiceDeps, } from './headerSortService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/sort/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAClF,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAA"}

package/dist/core/sort/toggleHeaderSort.d.ts

@@ -0,0 +1,9 @@
+import { SortModelItem } from '../types';
+export interface ToggleHeaderSortParams {
+    current: readonly SortModelItem[];
+    colId: string;
+    sortable: boolean;
+}
+/** 表头 click 三态：none → asc → desc → none（v1 单列） */
+export declare function toggleHeaderSort(params: ToggleHeaderSortParams): SortModelItem[];
+//# sourceMappingURL=toggleHeaderSort.d.ts.map

package/dist/core/sort/toggleHeaderSort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleHeaderSort.d.ts","sourceRoot":"","sources":["../../../src/core/sort/toggleHeaderSort.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,aAAa,EAAE,CAmBhF"}

package/dist/core/span/buildRowColumnRenderIndices.d.ts

@@ -0,0 +1,17 @@
+import { ColumnRenderIndicesByLane } from '../column/buildColumnRenderIndices';
+import { Column, ColumnWindow, IColumnModel } from '../types';
+import { CellSpanParams } from '../types/cellSpan';
+export interface BuildRowColumnRenderIndicesOptions {
+    columnModel: IColumnModel;
+    centerWindow: ColumnWindow;
+    enableCellSpan: boolean;
+    paramsForColumn: (column: Column) => CellSpanParams;
+}
+/**
+ * 按行构建三 lane 渲染列 index。
+ * - `enableCellSpan === false`：等同 `buildColumnRenderIndicesByLane`（中心走窗口）
+ * - `enableCellSpan === true`：`getColsForRow` 跳过被盖列；中心区对**全部** center 列求 head，
+ *   再用窗口 filter（span 中段落在窗口时仍保留 head）
+ */
+export declare function buildRowColumnRenderIndicesByLane(options: BuildRowColumnRenderIndicesOptions): ColumnRenderIndicesByLane;
+//# sourceMappingURL=buildRowColumnRenderIndices.d.ts.map

package/dist/core/span/buildRowColumnRenderIndices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildRowColumnRenderIndices.d.ts","sourceRoot":"","sources":["../../../src/core/span/buildRowColumnRenderIndices.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAA;AACtF,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG1D,MAAM,WAAW,kCAAkC;IACjD,WAAW,EAAE,YAAY,CAAA;IACzB,YAAY,EAAE,YAAY,CAAA;IAC1B,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,CAAA;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,yBAAyB,CA+B3B"}

package/dist/core/span/cellSpanService.d.ts

@@ -0,0 +1,39 @@
+import { Column, IColumnModel, RowNode } from '../types';
+import { CellSpanInfo, CellSpanPosition, CellSpanRowKey, ICellSpanService } from '../types/cellSpan';
+import { RowSpanHeadInfo } from './rowSpan';
+export interface CellSpanServiceDeps {
+    getEnableCellSpan: () => boolean;
+    getColumnModel: () => IColumnModel;
+    getDisplayRows: () => readonly RowNode[];
+    getRowById: (rowId: string) => RowNode | undefined;
+    getRowByIndex: (index: number) => RowNode | undefined;
+    getRowCount: () => number;
+    /** 表尾汇总原始值（可选） */
+    getSummaryValue?: (colId: string) => unknown;
+}
+/** Phase 16 块 5 · spanRows cache + 纵向/横向查询门面 */
+export declare class CellSpanService implements ICellSpanService {
+    private readonly deps;
+    /** colId → (rowId → region) */
+    private spanRowsCaches;
+    private readonly warnedBothModes;
+    constructor(deps: CellSpanServiceDeps);
+    get active(): boolean;
+    refresh(): void;
+    getColSpan(rowId: CellSpanRowKey, colId: string): number;
+    getCellSpan(rowId: string, colId: string): CellSpanInfo | null;
+    isCovered(rowId: string, colId: string): boolean;
+    normalizePosition(rowId: string, colId: string): CellSpanPosition;
+    /** 渲染用：解析纵向 span（rowSpan 优先于 spanRows） */
+    resolveVerticalSpan(rowNode: RowNode, column: Column): RowSpanHeadInfo;
+    getVerticalSpanHeight(rowNode: RowNode, column: Column): number;
+    /**
+     * Phase 16 块 10 · 与视口相交的纵向 span **head** 行 id。
+     * SpannedRow 层按 head 渲染，不再 pin 整段 covered 行。
+     */
+    collectSpannedHeadRowIds(firstRow: number, lastRow: number): Set<string>;
+    private resolveFromSpanRowsCache;
+    private collectVerticalRowIds;
+    private warnBothModes;
+}
+//# sourceMappingURL=cellSpanService.d.ts.map

package/dist/core/span/cellSpanService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellSpanService.d.ts","sourceRoot":"","sources":["../../../src/core/span/cellSpanService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAa7B,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,WAAW,CAAA;AAElB,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,OAAO,CAAA;IAChC,cAAc,EAAE,MAAM,YAAY,CAAA;IAClC,cAAc,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;IACxC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;IAClD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;IACrD,WAAW,EAAE,MAAM,MAAM,CAAA;IACzB,kBAAkB;IAClB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;CAC7C;AAED,gDAAgD;AAChD,qBAAa,eAAgB,YAAW,gBAAgB;IAK1C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,+BAA+B;IAC/B,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;gBAEvB,IAAI,EAAE,mBAAmB;IAEtD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,OAAO,IAAI,IAAI;IAsBf,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IA6BxD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IA+B9D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAUhD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAcjE,0CAA0C;IAC1C,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe;IAwBtE,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAS/D;;;OAGG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAqCxE,OAAO,CAAC,wBAAwB;IAkBhC,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,aAAa;CAUtB"}

package/dist/core/span/colSpan.d.ts

@@ -0,0 +1,67 @@
+import { ColumnCellLayout } from '../column/resolveColumnLayout';
+import { Column, IColumnModel, RowNode } from '../types';
+import { CellSpanParams } from '../types/cellSpan';
+export type ColSpanDomClassPrefix = 'mg-cell' | 'mg-footer-cell';
+/** 表体行 → colSpan 回调入参 */
+export declare function buildBodyCellSpanParams(rowNode: RowNode, column: Column): CellSpanParams;
+/** 表尾汇总行 → colSpan 回调入参 */
+export declare function buildFooterCellSpanParams(column: Column, summaryValue?: unknown): CellSpanParams;
+/**
+ * head 列布局 + 合并宽度；尾部边框 class 取自 span 末列。
+ */
+export declare function resolveSpannedColumnCellLayout(spanningColumns: readonly Column[], columnModel: IColumnModel): ColumnCellLayout;
+/** 将 colSpan DOM class / data 属性应用到 cell（表体 / 表尾共用） */
+export declare function applyColSpanCellDomState(element: HTMLElement, colSpan: number, classPrefix?: ColSpanDomClassPrefix): void;
+export interface ResolveColSpanOptions {
+    enableCellSpan: boolean;
+    column: Column;
+    params: CellSpanParams;
+}
+/**
+ * 解析列在当前行的请求 colSpan（≥1）。
+ * - `enableCellSpan === false` / 无回调 / 系统列 → 1
+ * - 回调返回值经 `clampSpanCount` 规范化
+ */
+export declare function resolveColSpan(options: ResolveColSpanOptions): number;
+/**
+ * 同 lane 内的下一列；跨 fixed 边界或撞上系统列时返回 undefined。
+ * 对标 AG Grid `_getColSpanningList` 的 pinned / 边界截断。
+ */
+export declare function getColAfterInSameLane(column: Column, columnModel: IColumnModel): Column | undefined;
+export interface GetColSpanningListOptions {
+    enableCellSpan: boolean;
+    params: CellSpanParams;
+}
+/**
+ * 从 head 列起，按请求 colSpan 向右收集实际覆盖列（同 lane · 截断于系统列）。
+ */
+export declare function getColSpanningList(startColumn: Column, columnModel: IColumnModel, options: GetColSpanningListOptions): Column[];
+/** head 合并后宽度 = 覆盖列宽之和 */
+export declare function getColSpanningWidth(spanningColumns: readonly Column[]): number;
+export interface GetColsForRowOptions {
+    enableCellSpan: boolean;
+    columnModel: IColumnModel;
+    /** 候选列全局 index（通常为单 lane 的列集，或中心窗口列） */
+    columnIndices: readonly number[];
+    /** 为 head 列构建 colSpan 回调入参 */
+    paramsForColumn: (column: Column) => CellSpanParams;
+    /**
+     * 列虚拟化 filter：span 覆盖的任一列通过则保留 head。
+     * 省略时全部 head 均保留。
+     */
+    filterCallback?: (column: Column, globalIndex: number) => boolean;
+}
+/**
+ * 按行过滤应渲染的列 index：被 colSpan 盖住的列跳过。
+ * 对标 AG Grid `VisibleColsService.getColsForRow`。
+ */
+export declare function getColsForRow(options: GetColsForRowOptions): number[];
+/** 某列是否被同行更靠左的 colSpan head 覆盖（不渲染） */
+export declare function isColCoveredByColSpan(options: {
+    enableCellSpan: boolean;
+    columnModel: IColumnModel;
+    columnIndices: readonly number[];
+    targetColId: string;
+    paramsForColumn: (column: Column) => CellSpanParams;
+}): boolean;
+//# sourceMappingURL=colSpan.d.ts.map

package/dist/core/span/colSpan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colSpan.d.ts","sourceRoot":"","sources":["../../../src/core/span/colSpan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAGxE,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAM1D,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,gBAAgB,CAAA;AAEhE,yBAAyB;AACzB,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,cAAc,CAShB;AAED,2BAA2B;AAC3B,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,OAAc,GAC3B,cAAc,CAShB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,SAAS,MAAM,EAAE,EAClC,WAAW,EAAE,YAAY,GACxB,gBAAgB,CAkBlB;AAED,uDAAuD;AACvD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,qBAAiC,GAC7C,IAAI,CASN;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,cAAc,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgBrE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,YAAY,GACxB,MAAM,GAAG,SAAS,CAepB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,cAAc,CAAA;CACvB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,YAAY,EACzB,OAAO,EAAE,yBAAyB,GACjC,MAAM,EAAE,CAqBV;AAED,0BAA0B;AAC1B,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAM9E;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,OAAO,CAAA;IACvB,WAAW,EAAE,YAAY,CAAA;IACzB,wCAAwC;IACxC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,8BAA8B;IAC9B,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,CAAA;IACnD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAA;CAClE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,EAAE,CA6DrE;AAED,uCAAuC;AACvC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,cAAc,EAAE,OAAO,CAAA;IACvB,WAAW,EAAE,YAAY,CAAA;IACzB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,CAAA;CACpD,GAAG,OAAO,CAeV"}

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

@@ -0,0 +1,11 @@
+export { applyColSpanCellDomState, buildBodyCellSpanParams, buildFooterCellSpanParams, getColAfterInSameLane, getColsForRow, getColSpanningList, getColSpanningWidth, isColCoveredByColSpan, resolveColSpan, resolveSpannedColumnCellLayout, } from './colSpan';
+export type { ColSpanDomClassPrefix, GetColsForRowOptions, GetColSpanningListOptions, ResolveColSpanOptions, } from './colSpan';
+export { buildRowColumnRenderIndicesByLane } from './buildRowColumnRenderIndices';
+export type { BuildRowColumnRenderIndicesOptions } from './buildRowColumnRenderIndices';
+export { MAX_ROW_SPAN, MAX_ROW_SPAN_LOOKBACK, applyRowSpanCellDomState, collectRowSpanHeadRowIds, findRowSpanHead, getRowSpanningHeight, isAnyRowSpanCoverHighlighted, isCellCoveredByRowSpan, normalizeRowSpanPosition, resolveRowSpan, } from './rowSpan';
+export type { FindRowSpanHeadOptions, ResolveRowSpanOptions, RowSpanHeadInfo, } from './rowSpan';
+export { buildSpanRowsCache } from './rowSpanCache';
+export type { SpanRowsRegion } from './rowSpanCache';
+export { CellSpanService } from './cellSpanService';
+export type { CellSpanServiceDeps } from './cellSpanService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/span/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,8BAA8B,GAC/B,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAA;AACjF,YAAY,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAA;AACvF,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,GACf,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,GAChB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/core/span/rowSpan.d.ts

@@ -0,0 +1,64 @@
+import { Column, IRowModel, RowNode } from '../types';
+import { CellSpanParams, CellSpanPosition } from '../types/cellSpan';
+/** 向上查找覆盖本格的 head 时的最大回看行数（v1 保护） */
+export declare const MAX_ROW_SPAN_LOOKBACK = 100;
+/** 单格建议最大 rowSpan；超限仍截断到剩余行数，并用于 SpannedRow head 扫描窗口 */
+export declare const MAX_ROW_SPAN = 50;
+export interface ResolveRowSpanOptions {
+    enableCellSpan: boolean;
+    column: Column;
+    params: CellSpanParams;
+}
+/**
+ * 解析列在当前行的请求 rowSpan（≥1）。
+ * 表尾 / 系统列 / 未开启 / 无回调 → 1。
+ */
+export declare function resolveRowSpan(options: ResolveRowSpanOptions): number;
+export interface RowSpanHeadInfo {
+    head: RowNode;
+    rowSpan: number;
+    /** true = 当前格被上方 head 覆盖，不应渲染 */
+    covered: boolean;
+}
+export interface FindRowSpanHeadOptions {
+    enableCellSpan: boolean;
+    column: Column;
+    rowNode: RowNode;
+    getRowByIndex: (index: number) => RowNode | undefined;
+    /** 显示行总数，用于截断 rowSpan */
+    rowCount: number;
+}
+/** 查找本格所属 span 的 head；若被覆盖则 covered=true */
+export declare function findRowSpanHead(options: FindRowSpanHeadOptions): RowSpanHeadInfo;
+export declare function isCellCoveredByRowSpan(options: FindRowSpanHeadOptions): boolean;
+/** head 合并高度：优先用 rowTop 差（可变行高安全） */
+export declare function getRowSpanningHeight(head: RowNode, rowSpan: number, getRowByIndex: (index: number) => RowNode | undefined): number;
+export declare function applyRowSpanCellDomState(element: HTMLElement, rowSpan: number, heightPx: number | null): void;
+/**
+ * 覆盖范围内任一行选中/索引高亮 → 整格高亮。
+ * （合并格是单一 DOM，不按行分段上色。）
+ */
+export declare function isAnyRowSpanCoverHighlighted(options: {
+    head: RowNode;
+    rowSpan: number;
+    getRowByIndex: (index: number) => RowNode | undefined;
+    isRowHighlighted: (rowId: string) => boolean;
+}): boolean;
+export declare function normalizeRowSpanPosition(options: {
+    enableCellSpan: boolean;
+    column: Column | undefined;
+    rowNode: RowNode | undefined;
+    getRowByIndex: (index: number) => RowNode | undefined;
+    rowCount: number;
+}): CellSpanPosition | null;
+/**
+ * 收集与当前行窗口相交的 rowSpan **head** 行 id（无 CellSpanService 时的回退）。
+ */
+export declare function collectRowSpanHeadRowIds(options: {
+    enableCellSpan: boolean;
+    rowModel: IRowModel;
+    columns: readonly Column[];
+    firstRow: number;
+    lastRow: number;
+}): Set<string>;
+//# sourceMappingURL=rowSpan.d.ts.map

package/dist/core/span/rowSpan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowSpan.d.ts","sourceRoot":"","sources":["../../../src/core/span/rowSpan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAK5E,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC,yDAAyD;AACzD,eAAO,MAAM,YAAY,KAAK,CAAA;AAE9B,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,cAAc,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgBrE;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;IACrD,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAwChF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAE/E;AAED,qCAAqC;AACrC,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,GACpD,MAAM,CAQR;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;IACrD,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;CAC7C,GAAG,OAAO,CAcV;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,cAAc,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;IACrD,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,gBAAgB,GAAG,IAAI,CAkB1B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,cAAc,EAAE,OAAO,CAAA;IACvB,QAAQ,EAAE,SAAS,CAAA;IACnB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,GAAG,CAAC,MAAM,CAAC,CA2Cd"}

package/dist/core/span/rowSpanCache.d.ts

@@ -0,0 +1,15 @@
+import { Column, RowNode } from '../types';
+/** 一列上的一段等值/自定义纵向 span */
+export interface SpanRowsRegion {
+    colId: string;
+    firstRowId: string;
+    lastRowId: string;
+    rowIds: readonly string[];
+    rowSpan: number;
+}
+/**
+ * 扫 `rowsToDisplay` 为配置了 `spanRows` 的列建 cache。
+ * key = rowId → 所属 region（含 head 与 covered）。
+ */
+export declare function buildSpanRowsCache(column: Column, rows: readonly RowNode[]): Map<string, SpanRowsRegion>;
+//# sourceMappingURL=rowSpanCache.d.ts.map

package/dist/core/span/rowSpanCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowSpanCache.d.ts","sourceRoot":"","sources":["../../../src/core/span/rowSpanCache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAKlD,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,OAAO,EAAE,GACvB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAiD7B"}