@zengrid/core 1.0.1

package/dist/src/rendering/width-provider/variable-width-provider.d.ts

@@ -0,0 +1,33 @@
+import type { WidthProvider } from './width-provider.interface';
+/**
+ * VariableWidthProvider - Variable widths using PrefixSumArray
+ *
+ * Supports different width for each column using prefix sums for efficient lookup.
+ * - O(1) for getWidth, getOffset, getTotalWidth
+ * - O(log n) for findIndexAtOffset (binary search)
+ * - O(n) for setWidth (updates all prefix sums after the changed index)
+ *
+ * @example
+ * ```typescript
+ * const widths = [100, 150, 200, 100, 120];
+ * const provider = new VariableWidthProvider(widths);
+ * provider.getWidth(2); // 200
+ * provider.getOffset(2); // 250 (100 + 150)
+ * provider.findIndexAtOffset(300); // 2
+ * ```
+ */
+export declare class VariableWidthProvider implements WidthProvider {
+    private widths;
+    /**
+     * Create a variable width provider
+     * @param widths - Array of widths for each column
+     */
+    constructor(widths: number[]);
+    getWidth(index: number): number;
+    getOffset(index: number): number;
+    getTotalWidth(): number;
+    findIndexAtOffset(offset: number): number;
+    setWidth(index: number, width: number): void;
+    get length(): number;
+}
+//# sourceMappingURL=variable-width-provider.d.ts.map

package/dist/src/rendering/width-provider/variable-width-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-width-provider.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/width-provider/variable-width-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,MAAM,CAAiB;IAE/B;;;OAGG;gBACS,MAAM,EAAE,MAAM,EAAE;IAQ5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC,aAAa,IAAI,MAAM;IAIvB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIzC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO5C,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/src/rendering/width-provider/width-provider.interface.d.ts

@@ -0,0 +1,62 @@
+/**
+ * WidthProvider interface for configurable column width calculation
+ *
+ * Provides a strategy pattern for calculating column widths and positions.
+ * Implementations can provide uniform widths, variable widths, or custom logic.
+ */
+export interface WidthProvider {
+    /**
+     * Get the width of a specific column
+     * @param index - Column index
+     * @returns Width in pixels
+     * @complexity O(1)
+     */
+    getWidth(index: number): number;
+    /**
+     * Get the X offset where a column starts
+     * @param index - Column index
+     * @returns Offset in pixels from left
+     * @complexity O(1) for uniform, O(1) for variable (cached)
+     */
+    getOffset(index: number): number;
+    /**
+     * Get the total width of all columns
+     * @returns Total width in pixels
+     * @complexity O(1)
+     */
+    getTotalWidth(): number;
+    /**
+     * Find which column contains a given X offset
+     * @param offset - X position in pixels
+     * @returns Column index at that offset
+     * @complexity O(1) for uniform, O(log n) for variable
+     */
+    findIndexAtOffset(offset: number): number;
+    /**
+     * Update the width of a specific column (optional)
+     * @param index - Column index
+     * @param width - New width in pixels
+     * @complexity Varies by implementation
+     */
+    setWidth?(index: number, width: number): void;
+    /**
+     * Total number of columns
+     */
+    readonly length: number;
+}
+/**
+ * Options for creating a width provider
+ */
+export interface WidthProviderOptions {
+    /**
+     * Total number of columns
+     */
+    colCount: number;
+    /**
+     * Width value(s):
+     * - number: uniform width for all columns
+     * - number[]: individual widths per column
+     */
+    width: number | number[];
+}
+//# sourceMappingURL=width-provider.interface.d.ts.map

package/dist/src/rendering/width-provider/width-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"width-provider.interface.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/width-provider/width-provider.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;;OAIG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC1B"}

package/dist/src/selection/hit-tester.d.ts

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview Hit testing for mouse interaction with grid cells
+ * @module @zengrid/core/selection/hit-tester
+ */
+import type { CellRef } from '../types';
+import type { HitTestResult, HitTestOptions, IHeightProvider, IWidthProvider } from './hit-tester.interface';
+/**
+ * HitTester - Determines which cell is at given coordinates
+ *
+ * Supports both uniform and variable cell sizes with optimal performance:
+ * - O(1) for uniform sizes
+ * - O(log n) for variable sizes (using binary search)
+ *
+ * @example
+ * ```typescript
+ * const hitTester = new HitTester(heightProvider, widthProvider, {
+ *   rowCount: 1000,
+ *   colCount: 26
+ * });
+ *
+ * // Find cell at mouse position
+ * const result = hitTester.getCellAtPoint(150, 300);
+ * if (result.hit) {
+ *   console.log(`Clicked cell: ${result.cell.row}, ${result.cell.col}`);
+ * }
+ * ```
+ */
+export declare class HitTester {
+    private heightProvider;
+    private widthProvider;
+    private rowCount;
+    private colCount;
+    constructor(heightProvider: IHeightProvider, widthProvider: IWidthProvider, options: {
+        rowCount: number;
+        colCount: number;
+    });
+    /**
+     * Finds the cell at given point coordinates
+     *
+     * @param x - X coordinate (in grid space, not viewport)
+     * @param y - Y coordinate (in grid space, not viewport)
+     * @param options - Hit test options
+     * @returns Hit test result
+     *
+     * @example
+     * ```typescript
+     * const result = hitTester.getCellAtPoint(150, 300);
+     * if (result.hit) {
+     *   console.log(`Cell: ${result.cell.row}, ${result.cell.col}`);
+     * }
+     * ```
+     */
+    getCellAtPoint(x: number, y: number, options?: HitTestOptions): HitTestResult;
+    /**
+     * Finds the cell at point, returns null if outside grid
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @returns Cell reference or null
+     *
+     * @example
+     * ```typescript
+     * const cell = hitTester.getCellAtPointOrNull(150, 300);
+     * if (cell) {
+     *   console.log(`Clicked: ${cell.row}, ${cell.col}`);
+     * }
+     * ```
+     */
+    getCellAtPointOrNull(x: number, y: number): CellRef | null;
+    /**
+     * Checks if a point is within the grid boundaries
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @returns True if point is within grid
+     */
+    isPointInGrid(x: number, y: number): boolean;
+    /**
+     * Gets the bounding box of a cell
+     *
+     * @param row - Row index
+     * @param col - Column index
+     * @returns Bounding box { left, top, width, height }
+     */
+    getCellBounds(row: number, col: number): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * Checks if a point is within a specific cell
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @param row - Row index
+     * @param col - Column index
+     * @returns True if point is within the cell
+     */
+    isPointInCell(x: number, y: number, row: number, col: number): boolean;
+    /**
+     * Gets the row at a given Y coordinate
+     *
+     * @param y - Y coordinate
+     * @returns Row index or -1 if outside
+     */
+    getRowAtY(y: number): number;
+    /**
+     * Gets the column at a given X coordinate
+     *
+     * @param x - X coordinate
+     * @returns Column index or -1 if outside
+     */
+    getColAtX(x: number): number;
+    /**
+     * Converts viewport coordinates to grid coordinates
+     *
+     * @param viewportX - X in viewport space
+     * @param viewportY - Y in viewport space
+     * @param scrollLeft - Horizontal scroll position
+     * @param scrollTop - Vertical scroll position
+     * @returns Grid coordinates { x, y }
+     */
+    viewportToGrid(viewportX: number, viewportY: number, scrollLeft: number, scrollTop: number): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Converts grid coordinates to viewport coordinates
+     *
+     * @param gridX - X in grid space
+     * @param gridY - Y in grid space
+     * @param scrollLeft - Horizontal scroll position
+     * @param scrollTop - Vertical scroll position
+     * @returns Viewport coordinates { x, y }
+     */
+    gridToViewport(gridX: number, gridY: number, scrollLeft: number, scrollTop: number): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Updates the grid dimensions
+     *
+     * @param rowCount - New row count
+     * @param colCount - New column count
+     */
+    updateDimensions(rowCount: number, colCount: number): void;
+    /**
+     * Gets current grid dimensions
+     *
+     * @returns { rowCount, colCount }
+     */
+    getDimensions(): {
+        rowCount: number;
+        colCount: number;
+    };
+}
+/**
+ * Creates a HitTester instance
+ *
+ * @param heightProvider - Provider for row heights
+ * @param widthProvider - Provider for column widths
+ * @param rowCount - Total number of rows
+ * @param colCount - Total number of columns
+ * @returns HitTester instance
+ */
+export declare function createHitTester(heightProvider: IHeightProvider, widthProvider: IWidthProvider, rowCount: number, colCount: number): HitTester;
+//# sourceMappingURL=hit-tester.d.ts.map

package/dist/src/selection/hit-tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-tester.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/selection/hit-tester.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAGvB,cAAc,EAAE,eAAe,EAC/B,aAAa,EAAE,cAAc,EAC7B,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAQjD;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa;IAuDjF;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAK1D;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAO5C;;;;;;OAMG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAarG;;;;;;;;OAQG;IACH,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAWtE;;;;;OAKG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAK5B;;;;;OAKG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAK5B;;;;;;;;OAQG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAO3B;;;;;;;;OAQG;IACH,cAAc,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAO3B;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1D;;;;OAIG;IACH,aAAa,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAMxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,eAAe,EAC/B,aAAa,EAAE,cAAc,EAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,SAAS,CAEX"}

package/dist/src/selection/hit-tester.interface.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview Hit testing interfaces for mouse interaction
+ * @module @zengrid/core/selection/hit-tester
+ */
+import type { CellRef } from '../types';
+/**
+ * Result of a hit test operation
+ */
+export interface HitTestResult {
+    /**
+     * Whether the point is within the grid
+     */
+    hit: boolean;
+    /**
+     * Cell reference if hit, undefined otherwise
+     */
+    cell?: CellRef;
+    /**
+     * Precise x offset within the cell (0-1, where 0 is left edge, 1 is right edge)
+     */
+    cellOffsetX?: number;
+    /**
+     * Precise y offset within the cell (0-1, where 0 is top edge, 1 is bottom edge)
+     */
+    cellOffsetY?: number;
+    /**
+     * Absolute x position of cell's left edge
+     */
+    cellLeft?: number;
+    /**
+     * Absolute y position of cell's top edge
+     */
+    cellTop?: number;
+    /**
+     * Cell width in pixels
+     */
+    cellWidth?: number;
+    /**
+     * Cell height in pixels
+     */
+    cellHeight?: number;
+}
+/**
+ * Options for hit testing
+ */
+export interface HitTestOptions {
+    /**
+     * Whether to allow hits outside grid boundaries
+     * If true, returns nearest cell; if false, returns null
+     * @default false
+     */
+    allowOutside?: boolean;
+    /**
+     * Whether to include precise offset information
+     * @default false
+     */
+    includePreciseOffset?: boolean;
+    /**
+     * Scroll offset (if point is in viewport coordinates)
+     */
+    scrollOffset?: {
+        top: number;
+        left: number;
+    };
+}
+/**
+ * Interface for height providers (uniform or variable)
+ */
+export interface IHeightProvider {
+    /**
+     * Get height of a specific row
+     */
+    getHeight(index: number): number;
+    /**
+     * Get offset to a specific row
+     */
+    getOffset(index: number): number;
+    /**
+     * Find row at given offset
+     */
+    findIndexAtOffset(offset: number): number;
+    /**
+     * Get total height of all rows
+     */
+    getTotalSize(): number;
+}
+/**
+ * Interface for width providers (uniform or variable)
+ */
+export interface IWidthProvider {
+    /**
+     * Get width of a specific column
+     */
+    getWidth(index: number): number;
+    /**
+     * Get offset to a specific column
+     */
+    getOffset(index: number): number;
+    /**
+     * Find column at given offset
+     */
+    findIndexAtOffset(offset: number): number;
+    /**
+     * Get total width of all columns
+     */
+    getTotalSize(): number;
+}
+//# sourceMappingURL=hit-tester.interface.d.ts.map

package/dist/src/selection/hit-tester.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-tester.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/selection/hit-tester.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,GAAG,EAAE,OAAO,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC;CACxB"}

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

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Selection utilities
+ * @module @zengrid/core/selection
+ */
+export * from './range-utils';
+export * from './range-utils.interface';
+export * from './hit-tester';
+export * from './hit-tester.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/selection/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC"}

package/dist/src/selection/range-utils.d.ts

@@ -0,0 +1,219 @@
+/**
+ * @fileoverview Range utilities for selection system
+ * @module @zengrid/core/selection/range-utils
+ */
+import type { CellRange, CellRef } from '../types';
+import type { RangeIntersection, RangeSize, MergeRangesOptions } from './range-utils.interface';
+/**
+ * Normalizes a cell range to ensure startRow <= endRow and startCol <= endCol
+ *
+ * @param range - Range to normalize
+ * @returns Normalized range
+ *
+ * @example
+ * ```typescript
+ * const range = { startRow: 5, startCol: 3, endRow: 2, endCol: 1 };
+ * const normalized = normalizeRange(range);
+ * // { startRow: 2, startCol: 1, endRow: 5, endCol: 3 }
+ * ```
+ */
+export declare function normalizeRange(range: CellRange): CellRange;
+/**
+ * Checks if a cell is contained within a range
+ *
+ * @param range - Range to check
+ * @param row - Row index
+ * @param col - Column index
+ * @returns True if cell is within range
+ *
+ * @example
+ * ```typescript
+ * const range = { startRow: 0, startCol: 0, endRow: 5, endCol: 5 };
+ * containsCell(range, 2, 3); // true
+ * containsCell(range, 6, 3); // false
+ * ```
+ */
+export declare function containsCell(range: CellRange, row: number, col: number): boolean;
+/**
+ * Checks if a cell reference is contained within a range
+ *
+ * @param range - Range to check
+ * @param cell - Cell reference
+ * @returns True if cell is within range
+ */
+export declare function containsCellRef(range: CellRange, cell: CellRef): boolean;
+/**
+ * Checks if two ranges intersect
+ *
+ * @param a - First range
+ * @param b - Second range
+ * @returns True if ranges intersect
+ *
+ * @example
+ * ```typescript
+ * const a = { startRow: 0, startCol: 0, endRow: 5, endCol: 5 };
+ * const b = { startRow: 3, startCol: 3, endRow: 8, endCol: 8 };
+ * rangesIntersect(a, b); // true
+ * ```
+ */
+export declare function rangesIntersect(a: CellRange, b: CellRange): boolean;
+/**
+ * Gets the intersection of two ranges
+ *
+ * @param a - First range
+ * @param b - Second range
+ * @returns Intersection result
+ *
+ * @example
+ * ```typescript
+ * const a = { startRow: 0, startCol: 0, endRow: 5, endCol: 5 };
+ * const b = { startRow: 3, startCol: 3, endRow: 8, endCol: 8 };
+ * const result = getRangeIntersection(a, b);
+ * // { intersects: true, intersection: { startRow: 3, startCol: 3, endRow: 5, endCol: 5 } }
+ * ```
+ */
+export declare function getRangeIntersection(a: CellRange, b: CellRange): RangeIntersection;
+/**
+ * Checks if range A completely contains range B
+ *
+ * @param a - Outer range
+ * @param b - Inner range
+ * @returns True if A contains B
+ */
+export declare function rangeContains(a: CellRange, b: CellRange): boolean;
+/**
+ * Gets the size of a range (number of rows and columns)
+ *
+ * @param range - Range to measure
+ * @returns Range size information
+ *
+ * @example
+ * ```typescript
+ * const range = { startRow: 0, startCol: 0, endRow: 5, endCol: 3 };
+ * getRangeSize(range);
+ * // { rows: 6, cols: 4, totalCells: 24 }
+ * ```
+ */
+export declare function getRangeSize(range: CellRange): RangeSize;
+/**
+ * Checks if a range is empty (zero size)
+ *
+ * @param range - Range to check
+ * @returns True if range has no cells
+ */
+export declare function isRangeEmpty(range: CellRange): boolean;
+/**
+ * Checks if a range is a single cell
+ *
+ * @param range - Range to check
+ * @returns True if range contains exactly one cell
+ */
+export declare function isSingleCell(range: CellRange): boolean;
+/**
+ * Creates a range from a single cell
+ *
+ * @param row - Row index
+ * @param col - Column index
+ * @returns Range containing single cell
+ */
+export declare function cellToRange(row: number, col: number): CellRange;
+/**
+ * Creates a range from a cell reference
+ *
+ * @param cell - Cell reference
+ * @returns Range containing single cell
+ */
+export declare function cellRefToRange(cell: CellRef): CellRange;
+/**
+ * Merges overlapping and optionally adjacent ranges
+ *
+ * @param ranges - Array of ranges to merge
+ * @param options - Merge options
+ * @returns Array of non-overlapping ranges
+ *
+ * @example
+ * ```typescript
+ * const ranges = [
+ *   { startRow: 0, startCol: 0, endRow: 2, endCol: 2 },
+ *   { startRow: 1, startCol: 1, endRow: 3, endCol: 3 },
+ *   { startRow: 5, startCol: 5, endRow: 7, endCol: 7 }
+ * ];
+ * const merged = mergeRanges(ranges);
+ * // [
+ * //   { startRow: 0, startCol: 0, endRow: 3, endCol: 3 },
+ * //   { startRow: 5, startCol: 5, endRow: 7, endCol: 7 }
+ * // ]
+ * ```
+ */
+export declare function mergeRanges(ranges: CellRange[], options?: MergeRangesOptions): CellRange[];
+/**
+ * Checks if two ranges are adjacent (touching but not overlapping)
+ *
+ * @param a - First range
+ * @param b - Second range
+ * @returns True if ranges are adjacent
+ */
+export declare function rangesAreAdjacent(a: CellRange, b: CellRange): boolean;
+/**
+ * Expands a range by a specified number of rows and columns
+ *
+ * @param range - Range to expand
+ * @param rows - Number of rows to expand (can be negative to shrink)
+ * @param cols - Number of columns to expand (can be negative to shrink)
+ * @returns Expanded range
+ */
+export declare function expandRange(range: CellRange, rows: number, cols: number): CellRange;
+/**
+ * Clamps a range to fit within specified boundaries
+ *
+ * @param range - Range to clamp
+ * @param maxRow - Maximum row index
+ * @param maxCol - Maximum column index
+ * @returns Clamped range
+ */
+export declare function clampRange(range: CellRange, maxRow: number, maxCol: number): CellRange;
+/**
+ * Checks if two ranges are equal
+ *
+ * @param a - First range
+ * @param b - Second range
+ * @returns True if ranges are equal
+ */
+export declare function rangesEqual(a: CellRange, b: CellRange): boolean;
+/**
+ * Converts a range to a string representation
+ *
+ * @param range - Range to convert
+ * @returns String representation (e.g., "A1:B5")
+ */
+export declare function rangeToString(range: CellRange): string;
+/**
+ * Converts a cell reference to A1 notation
+ *
+ * @param cell - Cell reference
+ * @returns A1 notation (e.g., "B3")
+ */
+export declare function cellRefToString(cell: CellRef): string;
+/**
+ * Iterates over all cells in a range
+ *
+ * @param range - Range to iterate
+ * @param callback - Callback function called for each cell
+ *
+ * @example
+ * ```typescript
+ * const range = { startRow: 0, startCol: 0, endRow: 2, endCol: 2 };
+ * forEachCellInRange(range, (row, col) => {
+ *   console.log(`Cell: ${row}, ${col}`);
+ * });
+ * ```
+ */
+export declare function forEachCellInRange(range: CellRange, callback: (row: number, col: number) => void): void;
+/**
+ * Gets all cell references in a range
+ *
+ * @param range - Range to get cells from
+ * @returns Array of cell references
+ */
+export declare function getCellsInRange(range: CellRange): CellRef[];
+//# sourceMappingURL=range-utils.d.ts.map

package/dist/src/selection/range-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/selection/range-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhG;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAO1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQhF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAExE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAUnE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,iBAAiB,CAiBlF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAUjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAUxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAEvD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,EAAE,CAoD9F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAiBrE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CASnF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAStF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAU/D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAOtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAUrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAQvG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,EAAE,CAM3D"}

package/dist/src/selection/range-utils.interface.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Range utilities interfaces for selection system
+ * @module @zengrid/core/selection/range-utils
+ */
+import type { CellRange } from '../types';
+/**
+ * Result of range intersection check
+ */
+export interface RangeIntersection {
+    /**
+     * Whether ranges intersect
+     */
+    intersects: boolean;
+    /**
+     * Intersection range if ranges intersect
+     */
+    intersection?: CellRange;
+}
+/**
+ * Range size information
+ */
+export interface RangeSize {
+    /**
+     * Number of rows in range
+     */
+    rows: number;
+    /**
+     * Number of columns in range
+     */
+    cols: number;
+    /**
+     * Total cells in range
+     */
+    totalCells: number;
+}
+/**
+ * Options for merging ranges
+ */
+export interface MergeRangesOptions {
+    /**
+     * Whether to merge adjacent (touching) ranges
+     * @default false
+     */
+    mergeAdjacent?: boolean;
+    /**
+     * Whether to sort ranges before merging
+     * @default true
+     */
+    sort?: boolean;
+}
+//# sourceMappingURL=range-utils.interface.d.ts.map

package/dist/src/selection/range-utils.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-utils.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/selection/range-utils.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}