@ricsam/react-spreadsheets 0.0.8 → 0.0.9

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/react-spreadsheets",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "type": "module"
 }

package/dist/types/lib.d.ts

@@ -8,9 +8,10 @@
  * Remember to import the stylesheet once in your app:
  *   import "@ricsam/react-spreadsheets/styles.css";
  */
-export { Spreadsheet, type SpreadsheetProps, type SpreadsheetRef, type SpreadsheetScrollAlignment, type SpreadsheetScrollToCellOptions, type SpreadsheetChild, type SpreadsheetChildInitial, type SpreadsheetChildState, type SpreadsheetComponent, } from "./spreadsheet/spreadsheet";
+export { Spreadsheet, type SpreadsheetProps, type SpreadsheetRef, type SpreadsheetScrollAlignment, type SpreadsheetScrollToCellOptions, type SpreadsheetScrollToRangeOptions, type SpreadsheetChild, type SpreadsheetChildInitial, type SpreadsheetChildState, type SpreadsheetComponent, } from "./spreadsheet/spreadsheet";
 export type { SelectionNavigationModel } from "@ricsam/selection-manager";
 export { FormulaSheet, FormulaWorkbook, WorkbookClipboardManager, WorkbookSelectionManager, } from "./workbook/workbook";
+export type { WorkbookRangeFocusOptions } from "./workbook/workbook-selection-manager";
 export { coerceCellInput, getCellDisplayText, getCellDisplayValue, } from "./workbook/cell-data-type";
 export { normalizeBorderSides, hasAnyBorderSide, type BorderSides, type NormalizedBorderSides, } from "./workbook/border-sides";
 export { onCellEditError, queueCellEditError, type CellEditErrorListener, } from "./workbook/cell-edit-error";

package/dist/types/spreadsheet/spreadsheet.d.ts

@@ -1,4 +1,4 @@
-import { type Format, SelectionManager, type SelectionNavigationModel, type SelectionManagerState, type SMCell } from '@ricsam/selection-manager';
+import { type Format, SelectionManager, type SelectionNavigationModel, type SelectionManagerState, type SMArea, type SMCell } from '@ricsam/selection-manager';
 import React, { type ReactNode } from 'react';
 import type { CellRenderContext, SerializedCellValue, SpreadsheetColumnWidths, SpreadsheetRowHeights } from '../types';
 import { type CellSnapAnchor } from './snapping';
@@ -89,11 +89,16 @@ export type SpreadsheetScrollAlignment = 'nearest' | 'start' | 'end';
 export interface SpreadsheetScrollToCellOptions {
     align?: SpreadsheetScrollAlignment;
 }
+export interface SpreadsheetScrollToRangeOptions {
+    align?: SpreadsheetScrollAlignment;
+}
 export interface SpreadsheetRef {
     focus: () => void;
     blur: () => void;
     /** Reveal a zero-based cell without changing the selection. */
     scrollToCell: (cell: SMCell, options?: SpreadsheetScrollToCellOptions) => void;
+    /** Reveal a zero-based range without changing the selection. */
+    scrollToRange: (range: SMArea, options?: SpreadsheetScrollToRangeOptions) => void;
 }
 export declare const Spreadsheet: React.ForwardRefExoticComponent<SpreadsheetProps & {
     disableClipboard?: boolean;

package/dist/types/workbook/workbook-selection-manager.d.ts

@@ -1,15 +1,25 @@
 import type { RangeAddress } from '@ricsam/formula-engine';
-import type { SelectionManager } from '@ricsam/selection-manager';
+import type { SelectionManager, ViewportAlignment } from '@ricsam/selection-manager';
 interface ManagerContext {
     workbookName: string;
     sheetName: string;
 }
+export interface WorkbookRangeFocusOptions {
+    /** How the target range should be positioned in the spreadsheet viewport. */
+    align?: ViewportAlignment;
+}
 export declare class WorkbookSelectionManager {
     private managers;
     private lastFocusedManager;
     private listeners;
     private cleanupFunctions;
+    private pendingRangeFocus;
     private smAreaToSpreadsheetRange;
+    private spreadsheetRangeToSmArea;
+    private cloneRangeAddress;
+    private matchesContext;
+    private applyRangeFocus;
+    private applyPendingRangeFocusOnMount;
     /**
      * Register a SelectionManager with its workbook/sheet context
      * Returns a cleanup function to unregister
@@ -59,10 +69,20 @@ export declare class WorkbookSelectionManager {
      * Finds the matching SelectionManager, sets its selection to the given cell,
      * and focuses it.
      *
-     * @returns true if the cell was successfully focused, false if no matching
-     *          manager was found (e.g. the sheet is not currently rendered).
+     * @returns true when focused immediately, false when queued until the target
+     *          sheet mounts.
      */
     focusCell(workbookName: string, sheetName: string, row: number, col: number): boolean;
+    /**
+     * Focus, select and reveal a range in its workbook/sheet.
+     *
+     * If the sheet is not mounted yet, the latest request is queued and applied
+     * when that sheet registers. This lets controlled workbooks switch their
+     * active sheet before the target grid exists.
+     *
+     * @returns true when applied immediately, false when queued for a future mount.
+     */
+    focusRange(address: RangeAddress, options?: WorkbookRangeFocusOptions): boolean;
     /**
      * Notify all listeners of selection change
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/react-spreadsheets",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Headless-friendly React spreadsheet and workbook components: infinite virtualized grid, zoom, resizing, clipboard, fill handles and formula-engine bindings.",
   "type": "module",
   "module": "./dist/mjs/lib.mjs",
@@ -43,7 +43,7 @@
   },
   "peerDependencies": {
     "@ricsam/formula-engine": ">=0.2.0",
-    "@ricsam/selection-manager": ">=0.0.29",
+    "@ricsam/selection-manager": ">=0.0.31",
     "react": "^18 || ^19",
     "react-dom": "^18 || ^19"
   },
@@ -55,7 +55,7 @@
   "devDependencies": {
     "@happy-dom/global-registrator": "^18.0.1",
     "@ricsam/formula-engine": "^0.2.15",
-    "@ricsam/selection-manager": "^0.0.29",
+    "@ricsam/selection-manager": "^0.0.31",
     "@testing-library/react": "^16.3.0",
     "@types/bun": "latest",
     "@types/react": "^19",