@ricsam/react-spreadsheets 0.0.9 → 0.0.11

package/dist/mjs/package.json

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

package/dist/types/lib.d.ts

@@ -10,8 +10,8 @@
  */
 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 { FormulaSheet, FormulaWorkbook, WorkbookClipboardManager, WorkbookSelectionManager, type FormulaSheetProps, type FormulaWorkbookProps, } from "./workbook/workbook";
+export type { WorkbookRangeFocusOptions, WorkbookSelectionContext, } 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/workbook/workbook-selection-manager.d.ts

@@ -1,22 +1,36 @@
 import type { RangeAddress } from '@ricsam/formula-engine';
 import type { SelectionManager, ViewportAlignment } from '@ricsam/selection-manager';
-interface ManagerContext {
+export interface WorkbookSelectionContext {
     workbookName: string;
     sheetName: string;
+    /**
+     * Stable identity for this rendered workbook view. Supply this when the same
+     * workbook/sheet can be mounted more than once, such as in split-screen panes.
+     */
+    viewId?: string;
 }
 export interface WorkbookRangeFocusOptions {
     /** How the target range should be positioned in the spreadsheet viewport. */
     align?: ViewportAlignment;
+    /** Target one mounted copy when the workbook/sheet is rendered more than once. */
+    viewId?: string;
 }
 export declare class WorkbookSelectionManager {
     private managers;
     private lastFocusedManager;
+    private lastSelections;
+    private selectionsByView;
     private listeners;
     private cleanupFunctions;
     private pendingRangeFocus;
+    private applyingRangeFocus;
+    private getViewKey;
+    private cloneSmArea;
     private smAreaToSpreadsheetRange;
     private spreadsheetRangeToSmArea;
     private cloneRangeAddress;
+    private areasToRangeAddresses;
+    private rememberSelections;
     private matchesContext;
     private applyRangeFocus;
     private applyPendingRangeFocusOnMount;
@@ -24,13 +38,13 @@ export declare class WorkbookSelectionManager {
      * Register a SelectionManager with its workbook/sheet context
      * Returns a cleanup function to unregister
      */
-    add(manager: SelectionManager, context: ManagerContext): () => void;
+    add(manager: SelectionManager, context: WorkbookSelectionContext): () => void;
     /**
      * Get the SelectionManager that was last focused or had selection activity
      */
     getLastFocusedSelectionManager(): {
         sm: SelectionManager;
-        context: ManagerContext;
+        context: WorkbookSelectionContext;
     } | null;
     /**
      * Get all current selections from the last focused manager.
@@ -59,11 +73,11 @@ export declare class WorkbookSelectionManager {
      * Focus the selection manager for a specific workbook (first sheet found).
      * This is useful when programmatically switching focus, e.g., after maximizing a window.
      */
-    focusWorkbook(workbookName: string): void;
+    focusWorkbook(workbookName: string, viewId?: string): void;
     /**
      * Focus the selection manager for a specific sheet without changing the cell selection.
      */
-    focusSheet(workbookName: string, sheetName: string): boolean;
+    focusSheet(workbookName: string, sheetName: string, viewId?: string): boolean;
     /**
      * Focus a specific cell in a specific workbook and sheet.
      * Finds the matching SelectionManager, sets its selection to the given cell,
@@ -72,7 +86,7 @@ export declare class WorkbookSelectionManager {
      * @returns true when focused immediately, false when queued until the target
      *          sheet mounts.
      */
-    focusCell(workbookName: string, sheetName: string, row: number, col: number): boolean;
+    focusCell(workbookName: string, sheetName: string, row: number, col: number, options?: WorkbookRangeFocusOptions): boolean;
     /**
      * Focus, select and reveal a range in its workbook/sheet.
      *
@@ -83,9 +97,10 @@ export declare class WorkbookSelectionManager {
      * @returns true when applied immediately, false when queued for a future mount.
      */
     focusRange(address: RangeAddress, options?: WorkbookRangeFocusOptions): boolean;
+    /** Cancel the latest queued range focus before its target view mounts. */
+    cancelPendingFocusRange(): void;
     /**
      * Notify all listeners of selection change
      */
     private emitChange;
 }
-export {};

package/dist/types/workbook/workbook.d.ts

@@ -9,7 +9,7 @@ type SpreadsheetLayout = {
     columnWidths?: SpreadsheetColumnWidths;
     rowHeights?: SpreadsheetRowHeights;
 };
-interface FormulaSheetProps extends Omit<SpreadsheetProps, 'selection' | 'customCellStyle' | 'customCellRenderer' | 'components' | 'overlayChildren' | 'selectedOverlayId' | 'onOverlaySelect' | 'onOverlayChildrenChange' | 'overlayPlaceholder' | 'parentSelected'> {
+export interface FormulaSheetProps extends Omit<SpreadsheetProps, 'selection' | 'customCellStyle' | 'customCellRenderer' | 'components' | 'overlayChildren' | 'selectedOverlayId' | 'onOverlaySelect' | 'onOverlayChildrenChange' | 'overlayPlaceholder' | 'parentSelected'> {
     clipboardManager?: WorkbookClipboardManager;
     sheetName: string;
     workbookName: string;
@@ -17,6 +17,8 @@ interface FormulaSheetProps extends Omit<SpreadsheetProps, 'selection' | 'custom
     verboseErrors?: boolean;
     selection?: SpreadsheetProps['selection'];
     selectionManager?: WorkbookSelectionManager;
+    /** Stable identity used to distinguish duplicate mounted views of this sheet. */
+    viewId?: string;
     customCellStyle?: (cell: CellRenderContext, internalStyle: React.CSSProperties) => React.CSSProperties;
     customCellRenderer?: (cell: CellRenderContext, internalElement: React.ReactNode) => React.ReactNode;
     components?: SpreadsheetProps['components'];
@@ -54,8 +56,8 @@ export declare class WorkbookClipboardManager extends ClipboardUtils {
         pasteType: 'value' | 'formula';
     }): void;
 }
-export declare function FormulaSheet({ sheetName, workbookName, engine, verboseErrors, selection, selectionManager, customCellStyle, customCellRenderer, onCellDataChangeError, components, overlayChildren, selectedOverlayId, onOverlaySelect, onOverlayChildrenChange, overlayPlaceholder, clipboardManager: controlledClipboardManager, isSelected, toolbar, showFormulas, ...rest }: FormulaSheetProps): React.JSX.Element;
-interface FormulaWorkbookProps extends Omit<SpreadsheetProps, 'cellData' | 'onCellDataChange' | 'selection' | 'customCellStyle' | 'customCellRenderer' | 'components' | 'overlayChildren' | 'selectedOverlayId' | 'onOverlaySelect' | 'onOverlayChildrenChange' | 'overlayPlaceholder' | 'parentSelected' | 'columnWidths' | 'onColumnWidthsChange' | 'rowHeights' | 'onRowHeightsChange'> {
+export declare function FormulaSheet({ sheetName, workbookName, engine, verboseErrors, selection, selectionManager, viewId, customCellStyle, customCellRenderer, onCellDataChangeError, components, overlayChildren, selectedOverlayId, onOverlaySelect, onOverlayChildrenChange, overlayPlaceholder, clipboardManager: controlledClipboardManager, isSelected, toolbar, showFormulas, ...rest }: FormulaSheetProps): React.JSX.Element;
+export interface FormulaWorkbookProps extends Omit<SpreadsheetProps, 'cellData' | 'onCellDataChange' | 'selection' | 'customCellStyle' | 'customCellRenderer' | 'components' | 'overlayChildren' | 'selectedOverlayId' | 'onOverlaySelect' | 'onOverlayChildrenChange' | 'overlayPlaceholder' | 'parentSelected' | 'columnWidths' | 'onColumnWidthsChange' | 'rowHeights' | 'onRowHeightsChange'> {
     workbookName: string;
     clipboardManager?: WorkbookClipboardManager;
     engine: FormulaEngine;
@@ -64,6 +66,8 @@ interface FormulaWorkbookProps extends Omit<SpreadsheetProps, 'cellData' | 'onCe
     verboseErrors?: boolean;
     selection?: SpreadsheetProps['selection'];
     selectionManager?: WorkbookSelectionManager;
+    /** Stable identity used to distinguish duplicate mounted views of this workbook. */
+    viewId?: string;
     customCellStyle?: (cell: CellRenderContext, internalStyle: React.CSSProperties) => React.CSSProperties;
     customCellRenderer?: (cell: CellRenderContext, internalElement: React.ReactNode) => React.ReactNode;
     components?: SpreadsheetProps['components'];
@@ -82,5 +86,5 @@ interface FormulaWorkbookProps extends Omit<SpreadsheetProps, 'cellData' | 'onCe
     /** When true, cells display raw formulas instead of computed values */
     showFormulas?: boolean;
 }
-export declare function FormulaWorkbook({ clipboardManager: controlledClipboardManager, workbookName, engine, activeSheet: controlledActiveSheet, onActiveSheetChange, verboseErrors, selectionManager, components, sheetOverlayChildren, sheetSelectedOverlayIds, sheetLayouts, onSheetColumnWidthsChange, onSheetRowHeightsChange, onOverlaySelect, onOverlayChildrenChange, overlayPlaceholder, isSelected, toolbar, showFormulas, ...rest }: FormulaWorkbookProps): React.JSX.Element;
+export declare function FormulaWorkbook({ clipboardManager: controlledClipboardManager, workbookName, engine, activeSheet: controlledActiveSheet, onActiveSheetChange, verboseErrors, selectionManager, viewId, components, sheetOverlayChildren, sheetSelectedOverlayIds, sheetLayouts, onSheetColumnWidthsChange, onSheetRowHeightsChange, onOverlaySelect, onOverlayChildrenChange, overlayPlaceholder, isSelected, toolbar, showFormulas, ...rest }: FormulaWorkbookProps): React.JSX.Element;
 export { WorkbookSelectionManager } from './workbook-selection-manager';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/react-spreadsheets",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "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.31",
+    "@ricsam/selection-manager": ">=0.0.32",
     "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.31",
+    "@ricsam/selection-manager": "^0.0.32",
     "@testing-library/react": "^16.3.0",
     "@types/bun": "latest",
     "@types/react": "^19",