@worksheet-js/core 1.0.0 → 1.0.2

package/README.md

@@ -16,9 +16,15 @@
 ## 📦 Installation
 
 ```bash
-pnpm add @worksheet-js/core
+npm install @worksheet-js/core
 ```
 
+> [!TIP]
+> Using React or Vue? We recommend installing the official wrapper for the best developer experience:
+>
+> - **React**: `npm install @worksheet-js/core @worksheet-js/react`
+> - **Vue**: `npm install @worksheet-js/core @worksheet-js/vue`
+
 ## 🚀 Quick Start
 
 ```typescript

package/dist/index.d.mts

@@ -539,6 +539,7 @@ declare class Viewport {
     private endCol;
     private startRow;
     private endRow;
+    private _renderRequested;
     private _measurer;
     constructor(ws: WorksheetModel, container: HTMLElement);
     /** Returns the view layer element for external consumers (e.g., SelectionPainter). */
@@ -570,6 +571,11 @@ declare class Viewport {
      * Render loop: recycles DOM nodes to match current visible range.
      */
     render(): void;
+    /**
+     * Schedules a render on the next animation frame.
+     * Collapses multiple calls into a single render to prevent loops and O(N^2) lag.
+     */
+    requestRender(): void;
     private _activeFilterPanel;
     private _openFilterPanel;
     /** Apply stored cell style properties to a DOM element */
@@ -835,27 +841,29 @@ declare class ColModel {
 type LicensePlan = 'starter' | 'pro' | 'enterprise';
 
 declare class SheetData {
-    /** Sparse cell storage keyed by "x,y" */
+    /** Sparse cell storage: Map<row, Map<col, CellData>> */
     private cells;
     /** Set by Worksheet after construction to enable formula evaluation */
     formulaEngine?: FormulaEngine;
     /** Set by Worksheet to enable license-based validation */
     getEdition?: () => LicensePlan;
-    /** Read-only access to the internal cell map (used for cloning). */
-    protected getCells(): ReadonlyMap<string, CellData>;
     /** Get the raw input string value (e.g. "1200" or "=A1") */
     getValue(x: number, y: number): string;
     /** Iterate over all populated cells (sparse scan) */
     forEachCell(callback: (x: number, y: number, cell: CellData) => void): void;
-    /** Get all populated cells in a specific row (sparse scan) */
+    /** Get all populated cells in a specific row (efficient O(cells in row)) */
     getCellsInRow(rowIdx: number): Array<[number, CellData]>;
     /**
      * Efficiently bulk-load parsed data from @worksheet/parser directly into the underlying maps.
      * Bypasses the FormatEngine's slow parsing for string/number extraction, mapping cell types directly.
      */
     loadFromParser(parsedData: SheetData$1): Promise<void>;
+    /** Get the total populated cell count across all rows */
+    private getCellCount;
     /** Get the parsed typed data */
     getCell(x: number, y: number): CellData | undefined;
+    /** Internal low-level cell setter */
+    private internalSetCell;
     /** Set a new raw input value, parsing it automatically */
     setValue(x: number, y: number, rawInput: string): void;
     /** Delete a cell entirely (including values, styles, formats, notes, comments) */

package/dist/index.d.ts

@@ -539,6 +539,7 @@ declare class Viewport {
     private endCol;
     private startRow;
     private endRow;
+    private _renderRequested;
     private _measurer;
     constructor(ws: WorksheetModel, container: HTMLElement);
     /** Returns the view layer element for external consumers (e.g., SelectionPainter). */
@@ -570,6 +571,11 @@ declare class Viewport {
      * Render loop: recycles DOM nodes to match current visible range.
      */
     render(): void;
+    /**
+     * Schedules a render on the next animation frame.
+     * Collapses multiple calls into a single render to prevent loops and O(N^2) lag.
+     */
+    requestRender(): void;
     private _activeFilterPanel;
     private _openFilterPanel;
     /** Apply stored cell style properties to a DOM element */
@@ -835,27 +841,29 @@ declare class ColModel {
 type LicensePlan = 'starter' | 'pro' | 'enterprise';
 
 declare class SheetData {
-    /** Sparse cell storage keyed by "x,y" */
+    /** Sparse cell storage: Map<row, Map<col, CellData>> */
     private cells;
     /** Set by Worksheet after construction to enable formula evaluation */
     formulaEngine?: FormulaEngine;
     /** Set by Worksheet to enable license-based validation */
     getEdition?: () => LicensePlan;
-    /** Read-only access to the internal cell map (used for cloning). */
-    protected getCells(): ReadonlyMap<string, CellData>;
     /** Get the raw input string value (e.g. "1200" or "=A1") */
     getValue(x: number, y: number): string;
     /** Iterate over all populated cells (sparse scan) */
     forEachCell(callback: (x: number, y: number, cell: CellData) => void): void;
-    /** Get all populated cells in a specific row (sparse scan) */
+    /** Get all populated cells in a specific row (efficient O(cells in row)) */
     getCellsInRow(rowIdx: number): Array<[number, CellData]>;
     /**
      * Efficiently bulk-load parsed data from @worksheet/parser directly into the underlying maps.
      * Bypasses the FormatEngine's slow parsing for string/number extraction, mapping cell types directly.
      */
     loadFromParser(parsedData: SheetData$1): Promise<void>;
+    /** Get the total populated cell count across all rows */
+    private getCellCount;
     /** Get the parsed typed data */
     getCell(x: number, y: number): CellData | undefined;
+    /** Internal low-level cell setter */
+    private internalSetCell;
     /** Set a new raw input value, parsing it automatically */
     setValue(x: number, y: number, rawInput: string): void;
     /** Delete a cell entirely (including values, styles, formats, notes, comments) */