@zengrid/core 1.0.1

package/dist/src/features/formulas/formula-calculator.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Formula Calculator using DependencyGraph
+ *
+ * Tracks formula dependencies and calculates cells in correct order.
+ */
+/**
+ * Cell formula information
+ */
+export interface CellFormula {
+    cell: string;
+    formula: string;
+    dependencies: string[];
+}
+/**
+ * FormulaCalculator - Formula dependency tracking and calculation ordering
+ *
+ * Uses a dependency graph to track formula relationships and determine
+ * the correct calculation order, with circular reference detection.
+ *
+ * @example
+ * ```typescript
+ * const calculator = new FormulaCalculator();
+ *
+ * // Cell C1 = A1 + B1
+ * calculator.setFormula('C1', '=A1+B1', ['A1', 'B1']);
+ *
+ * // Cell D1 = C1 * 2
+ * calculator.setFormula('D1', '=C1*2', ['C1']);
+ *
+ * // Get calculation order (dependencies first)
+ * const order = calculator.getCalculationOrder();
+ * // ['C1', 'D1'] - C1 first (no formula deps), then D1 (depends on C1)
+ *
+ * // User changes A1 - get cells to recalculate
+ * const toRecalc = calculator.getCellsToRecalculate(['A1']);
+ * // ['C1', 'D1'] - all cells that transitively depend on A1
+ * ```
+ */
+export declare class FormulaCalculator {
+    private graph;
+    private formulas;
+    /**
+     * Register a formula cell
+     *
+     * @param cell - Cell reference (e.g., 'A1')
+     * @param formula - Formula string (e.g., '=SUM(B1:B10)')
+     * @param dependencies - Array of cell references this formula depends on
+     * @throws Error if circular reference detected
+     */
+    setFormula(cell: string, formula: string, dependencies: string[]): void;
+    /**
+     * Remove a formula
+     *
+     * @param cell - Cell reference
+     */
+    removeFormula(cell: string): void;
+    /**
+     * Get formula for a cell
+     *
+     * @param cell - Cell reference
+     * @returns Formula info or undefined
+     */
+    getFormula(cell: string): CellFormula | undefined;
+    /**
+     * Check if cell has a formula
+     *
+     * @param cell - Cell reference
+     * @returns true if cell has formula
+     */
+    hasFormula(cell: string): boolean;
+    /**
+     * Get all cells with formulas
+     *
+     * @returns Array of cell references
+     */
+    getAllFormulaCells(): string[];
+    /**
+     * Get calculation order for all formulas
+     *
+     * Returns cells in dependency order (dependencies before dependents).
+     *
+     * @returns Array of cell references in calculation order
+     * @throws Error if circular references detected
+     */
+    getCalculationOrder(): string[];
+    /**
+     * Get cells to recalculate when specific cells change
+     *
+     * Returns all formula cells that transitively depend on the changed cells,
+     * in correct calculation order.
+     *
+     * @param changedCells - Array of cell references that changed
+     * @returns Array of formula cells to recalculate, in order
+     */
+    getCellsToRecalculate(changedCells: string[]): string[];
+    /**
+     * Get direct dependencies of a cell
+     *
+     * @param cell - Cell reference
+     * @returns Array of cell references this cell depends on
+     */
+    getDependencies(cell: string): string[];
+    /**
+     * Get direct dependents of a cell
+     *
+     * @param cell - Cell reference
+     * @returns Array of cell references that depend on this cell
+     */
+    getDependents(cell: string): string[];
+    /**
+     * Get all transitive dependencies (recursive)
+     *
+     * @param cell - Cell reference
+     * @returns Array of all cells this cell transitively depends on
+     */
+    getTransitiveDependencies(cell: string): string[];
+    /**
+     * Get all transitive dependents (recursive)
+     *
+     * @param cell - Cell reference
+     * @returns Array of all cells that transitively depend on this cell
+     */
+    getTransitiveDependents(cell: string): string[];
+    /**
+     * Check if adding a dependency would create a cycle
+     *
+     * @param cell - Dependent cell
+     * @param dependency - Dependency cell
+     * @returns true if would create cycle
+     */
+    wouldCreateCycle(cell: string, dependency: string): boolean;
+    /**
+     * Detect all circular references in current formulas
+     *
+     * @returns Array of cycles, where each cycle is an array of cell references
+     */
+    detectCircularReferences(): string[][];
+    /**
+     * Get statistics about the formula graph
+     */
+    getStats(): {
+        formulaCount: number;
+        dependencyCount: number;
+        maxDepth: number;
+    };
+    /**
+     * Clear all formulas
+     */
+    clear(): void;
+}
+//# sourceMappingURL=formula-calculator.d.ts.map

package/dist/src/features/formulas/formula-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula-calculator.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/formulas/formula-calculator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;IAqCvE;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;;;;OAOG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAW/B;;;;;;;;OAQG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAOvD;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIrC;;;;;OAKG;IACH,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjD;;;;;OAKG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/C;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAI3D;;;;OAIG;IACH,wBAAwB,IAAI,MAAM,EAAE,EAAE;IAItC;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAUD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/src/features/formulas/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Formula engine components
+ */
+export { FormulaCalculator } from './formula-calculator';
+export type { CellFormula } from './formula-calculator';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/features/formulas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/formulas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/features/hit-testing/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Hit testing feature
+ * @packageDocumentation
+ */
+export { SpatialHitTester } from './spatial-hit-tester';
+export type { CellPosition, CellBounds, HitTestResult, SpatialHitTesterOptions, } from './spatial-hit-tester';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/features/hit-testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/hit-testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/src/features/hit-testing/spatial-hit-tester.d.ts

@@ -0,0 +1,137 @@
+/**
+ * SpatialHitTester - Efficient cell lookup using RTree
+ *
+ * Uses RTree from shared package for O(log n) spatial queries.
+ * Particularly useful for:
+ * - Merged cells
+ * - Variable cell sizes
+ * - Finding cells at mouse coordinates
+ * - Viewport intersection queries
+ */
+import type { Rectangle } from '@zengrid/shared/data-structures/rtree';
+/**
+ * Cell position in the grid
+ */
+export interface CellPosition {
+    row: number;
+    col: number;
+}
+/**
+ * Cell bounds (in pixels)
+ */
+export interface CellBounds extends Rectangle {
+    row: number;
+    col: number;
+}
+/**
+ * Hit test result
+ */
+export interface HitTestResult {
+    row: number;
+    col: number;
+    bounds: Rectangle;
+    distance?: number;
+}
+/**
+ * Hit tester options
+ */
+export interface SpatialHitTesterOptions {
+    /**
+     * Enable merged cell support
+     * @default false
+     */
+    supportMergedCells?: boolean;
+}
+/**
+ * SpatialHitTester - Uses RTree for efficient spatial queries
+ *
+ * @example
+ * ```typescript
+ * const hitTester = new SpatialHitTester();
+ *
+ * // Index all visible cells
+ * for (let row = 0; row < 100; row++) {
+ *   for (let col = 0; col < 50; col++) {
+ *     const bounds = getCellBounds(row, col);
+ *     hitTester.indexCell(row, col, bounds);
+ *   }
+ * }
+ *
+ * // Find cell at mouse coordinates
+ * const cell = hitTester.hitTest(mouseX, mouseY);
+ * if (cell) {
+ *   console.log(`Clicked cell: row=${cell.row}, col=${cell.col}`);
+ * }
+ *
+ * // Find all cells in viewport
+ * const visibleCells = hitTester.findCellsInRect({
+ *   minX: viewportLeft,
+ *   minY: viewportTop,
+ *   maxX: viewportRight,
+ *   maxY: viewportBottom,
+ * });
+ * ```
+ */
+export declare class SpatialHitTester {
+    private rtree;
+    private supportMergedCells;
+    private mergedCells;
+    constructor(options?: SpatialHitTesterOptions);
+    /**
+     * Index a cell for spatial queries
+     */
+    indexCell(row: number, col: number, bounds: Rectangle): void;
+    /**
+     * Index a merged cell (spanning multiple rows/columns)
+     */
+    indexMergedCell(startRow: number, startCol: number, endRow: number, endCol: number, bounds: Rectangle): void;
+    /**
+     * Hit test at a specific point
+     * Returns the cell at the given coordinates
+     */
+    hitTest(x: number, y: number): HitTestResult | null;
+    /**
+     * Find the nearest cell to a point
+     */
+    hitTestNearest(x: number, y: number, maxDistance?: number): HitTestResult | null;
+    /**
+     * Find all cells intersecting a rectangle
+     */
+    findCellsInRect(rect: Rectangle): HitTestResult[];
+    /**
+     * Find all cells in viewport
+     */
+    findCellsInViewport(viewportLeft: number, viewportTop: number, viewportRight: number, viewportBottom: number): HitTestResult[];
+    /**
+     * Check if a cell is merged
+     */
+    isMergedCell(row: number, col: number): boolean;
+    /**
+     * Get merged cell info
+     */
+    getMergedCellInfo(row: number, col: number): CellBounds | null;
+    /**
+     * Clear all indexed cells
+     */
+    clear(): void;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        indexedCells: number;
+        mergedCells: number;
+    };
+    /**
+     * Generate key for merged cell
+     */
+    private getMergedCellKey;
+    /**
+     * Parse merged cell key
+     */
+    private parseMergedCellKey;
+    /**
+     * Cleanup
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=spatial-hit-tester.d.ts.map

package/dist/src/features/hit-testing/spatial-hit-tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-hit-tester.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/hit-testing/spatial-hit-tester.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,kBAAkB,CAAU;IAGpC,OAAO,CAAC,WAAW,CAAsC;gBAE7C,OAAO,GAAE,uBAA4B;IAOjD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI;IAI5D;;OAEG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAChB,IAAI;IAiBP;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAkBnD;;OAEG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAiBhF;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,EAAE;IAUjD;;OAEG;IACH,mBAAmB,CACjB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,aAAa,EAAE;IASlB;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAqB/C;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAoB9D;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB;IAOD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/src/features/loading/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Loading indicator feature
+ */
+export { LoadingIndicator } from './loading-indicator';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/features/loading/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/loading/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/features/loading/loading-indicator.d.ts

@@ -0,0 +1,79 @@
+import type { LoadingState, LoadingConfig } from '../../types';
+/**
+ * LoadingIndicator - Renders loading UI with multiple template styles
+ *
+ * Provides 4 built-in template styles:
+ * 1. **Simple**: Basic text "Loading..."
+ * 2. **Animated**: Animated spinner with rotating dots
+ * 3. **Modern**: Modern circular loader with smooth animation
+ * 4. **Skeleton**: Skeleton screen with shimmer effect
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const loadingIndicator = new LoadingIndicator({
+ *   enabled: true,
+ *   template: 'modern',
+ *   message: 'Loading data...',
+ * });
+ *
+ * const container = loadingIndicator.render({ isLoading: true });
+ * document.body.appendChild(container);
+ * ```
+ */
+export declare class LoadingIndicator {
+    private config;
+    private container;
+    private startTime;
+    private minDisplayTimeout;
+    constructor(config?: LoadingConfig);
+    /**
+     * Render loading indicator
+     */
+    render(state: LoadingState): HTMLElement;
+    /**
+     * Show loading indicator
+     */
+    show(parentElement: HTMLElement, state?: LoadingState): void;
+    /**
+     * Hide loading indicator with minimum display time
+     */
+    hide(): Promise<void>;
+    /**
+     * Update loading state
+     */
+    update(state: LoadingState): void;
+    /**
+     * Template 1: Simple - Basic text
+     * Layout: Loading...
+     */
+    private renderSimpleTemplate;
+    /**
+     * Template 2: Animated - Rotating dots spinner
+     * Layout: ● ● ● Loading...
+     */
+    private renderAnimatedTemplate;
+    /**
+     * Template 3: Modern - Circular loader
+     * Layout: ○ Loading...
+     */
+    private renderModernTemplate;
+    /**
+     * Template 4: Skeleton - Skeleton screen shimmer
+     * Layout: [====    ] shimmer effect
+     */
+    private renderSkeletonTemplate;
+    /**
+     * Check if loading is currently visible
+     */
+    isVisible(): boolean;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<LoadingConfig>): void;
+    /**
+     * Destroy loading indicator
+     * Safely removes all references and cleans up DOM
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=loading-indicator.d.ts.map

package/dist/src/features/loading/loading-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-indicator.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/features/loading/loading-indicator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA0F;IACxG,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,iBAAiB,CAAuB;gBAEpC,MAAM,GAAE,aAAkB;IAatC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW;IA2BxC;;OAEG;IACH,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,KAAK,GAAE,YAAkC,GAAG,IAAI;IAiCjF;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDrB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAqBjC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAqC9B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIlD;;;OAGG;IACH,OAAO,IAAI,IAAI;CAuBhB"}