@sheetxl/sdk 0.8.0-beta.10 → 0.8.0-beta.11

package/types/src/sheetProtection/{ISheetProtection.d.ts → IWorksheetProtection.d.ts}

@@ -3,14 +3,14 @@ import { IProtection } from '../protection/IProtection';
  * Interface representing the protection settings for a sheet.
  * Extends the base `IProtection` interface with additional sheet-specific protection options.
  */
-export interface ISheetProtection extends IProtection<ISheetProtection, ISheetProtection.Properties, ISheetProtection.JSON> {
+export interface IWorksheetProtection extends IProtection<IWorksheetProtection, IWorksheetProtection.Properties, IWorksheetProtection.JSON> {
     /**
      * Retrieves the protection properties for the sheet.
      *
-     * @returns The {@link ISheetProtection.Properties} the sheet protects with, kept while it is
+     * @returns The {@link IWorksheetProtection.Properties} the sheet protects with, kept while it is
      * unprotected, or `null` when it has none.
      */
-    getProperties(): Partial<ISheetProtection.Properties> | null;
+    getProperties(): Partial<IWorksheetProtection.Properties> | null;
     /**
      * Checks if the AutoTable functionality is protected on the sheet.
      *
@@ -119,57 +119,57 @@ export interface ISheetProtection extends IProtection<ISheetProtection, ISheetPr
      */
     isSelectUnlockedCellsAllowed(): boolean;
     /** For runtime type checking. */
-    readonly isISheetProtection: true;
+    readonly isIWorksheetProtection: true;
 }
 /**
- * {@inheritDoc ISheetProtection}
+ * {@inheritDoc IWorksheetProtection}
  * @see
  * ### **Interface**
  *
- * {@link ISheetProtection}
+ * {@link IWorksheetProtection}
  */
-export declare namespace ISheetProtection {
+export declare namespace IWorksheetProtection {
     /**
      * @remarks
      * There is no whole-sheet flag here: changing it is {@link IProtection.lock} and
-     * {@link IProtection.unlock}, reading it {@link ISheetProtection.isLocked}. It is saved as
-     * {@link ISheetProtection.JSON.sheet}.
+     * {@link IProtection.unlock}, reading it {@link IWorksheetProtection.isLocked}. It is saved as
+     * {@link IWorksheetProtection.JSON.sheet}.
      */
     interface Properties extends IProtection.Properties {
-        /** {@inheritDoc ISheetProtection.isAutoTableAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isAutoTableAllowed} */
         autoTable?: boolean;
-        /** {@inheritDoc ISheetProtection.isDeleteColumnsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isDeleteColumnsAllowed} */
         deleteColumns?: boolean;
-        /** {@inheritDoc ISheetProtection.isDeleteRowsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isDeleteRowsAllowed} */
         deleteRows?: boolean;
-        /** {@inheritDoc ISheetProtection.isFormatCellsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isFormatCellsAllowed} */
         formatCells?: boolean;
-        /** {@inheritDoc ISheetProtection.isFormatColumnsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isFormatColumnsAllowed} */
         formatColumns?: boolean;
-        /** {@inheritDoc ISheetProtection.isFormatRowsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isFormatRowsAllowed} */
         formatRows?: boolean;
-        /** {@inheritDoc ISheetProtection.isInsertColumnsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isInsertColumnsAllowed} */
         insertColumns?: boolean;
-        /** {@inheritDoc ISheetProtection.isInsertHyperlinksAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isInsertHyperlinksAllowed} */
         insertHyperlinks?: boolean;
-        /** {@inheritDoc ISheetProtection.isInsertRowsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isInsertRowsAllowed} */
         insertRows?: boolean;
-        /** {@inheritDoc ISheetProtection.isObjectsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isObjectsAllowed} */
         objects?: boolean;
-        /** {@inheritDoc ISheetProtection.isPivotTablesAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isPivotTablesAllowed} */
         pivotTables?: boolean;
-        /** {@inheritDoc ISheetProtection.isScenariosAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isScenariosAllowed} */
         scenarios?: boolean;
-        /** {@inheritDoc ISheetProtection.isSelectLockedCellsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isSelectLockedCellsAllowed} */
         selectLockedCells?: boolean;
-        /** {@inheritDoc ISheetProtection.isSelectUnlockedCellsAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isSelectUnlockedCellsAllowed} */
         selectUnlockedCells?: boolean;
-        /** {@inheritDoc ISheetProtection.isSortAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isSortAllowed} */
         sort?: boolean;
-        /** {@inheritDoc ISheetProtection.isShowFormulasAllowed} */
+        /** {@inheritDoc IWorksheetProtection.isShowFormulasAllowed} */
         showFormulas?: boolean;
     }
-    interface JSON extends ISheetProtection.Properties, IProtection.JSON {
+    interface JSON extends IWorksheetProtection.Properties, IProtection.JSON {
         /**
          * `true` when the whole sheet stays allowed: it is not protected, and keeps its options for the
          * next lock. Absent, the sheet is protected.
@@ -179,6 +179,6 @@ export declare namespace ISheetProtection {
          */
         sheet?: boolean;
     }
-    type PropertyKeys = (keyof ISheetProtection.Properties);
+    type PropertyKeys = (keyof IWorksheetProtection.Properties);
 }
-//# sourceMappingURL=ISheetProtection.d.ts.map
+//# sourceMappingURL=IWorksheetProtection.d.ts.map

package/types/src/sheetProtection/WorksheetProtection.d.ts

@@ -0,0 +1,51 @@
+import { DefaultProtection } from '../protection/DefaultProtection';
+import { IWorksheetProtection } from './IWorksheetProtection';
+export declare class WorksheetProtection extends DefaultProtection<IWorksheetProtection, IWorksheetProtection.Properties, IWorksheetProtection.JSON> implements IWorksheetProtection {
+    /** {@inheritDoc IWorksheetProtection.isAutoTableAllowed} */
+    isAutoTableAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isDeleteColumnsAllowed} */
+    isDeleteColumnsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isDeleteRowsAllowed} */
+    isDeleteRowsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isFormatCellsAllowed} */
+    isFormatCellsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isFormatColumnsAllowed} */
+    isFormatColumnsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isFormatRowsAllowed} */
+    isFormatRowsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isInsertColumnsAllowed} */
+    isInsertColumnsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isInsertHyperlinksAllowed} */
+    isInsertHyperlinksAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isInsertRowsAllowed} */
+    isInsertRowsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isObjectsAllowed} */
+    isObjectsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isPivotTablesAllowed} */
+    isPivotTablesAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isScenariosAllowed} */
+    isScenariosAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isSortAllowed} */
+    isSortAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isShowFormulasAllowed} */
+    isShowFormulasAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isSelectLockedCellsAllowed} */
+    isSelectLockedCellsAllowed(): boolean;
+    /** {@inheritDoc IWorksheetProtection.isSelectUnlockedCellsAllowed} */
+    isSelectUnlockedCellsAllowed(): boolean;
+    /**
+     * A property that a locked sheet must deny explicitly: unset is allowed, and read-only does not
+     * deny it. The opposite of {@link _isPropertyAllowed}, which a locked sheet must grant explicitly.
+     */
+    protected _isPropertyAllowedByDefault(property: IWorksheetProtection.PropertyKeys): boolean;
+    protected _getAllowedKey(): string;
+    protected _updateProperties(properties: IWorksheetProtection.Properties | null): void;
+    protected _clearProperties(): void;
+    protected _fromJSON(json: IWorksheetProtection.JSON | null): void;
+    protected _toJSON(json: IWorksheetProtection.JSON): IWorksheetProtection.JSON;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
+    /** {@inheritDoc IWorksheetProtection.isIWorksheetProtection} */
+    get isIWorksheetProtection(): true;
+}
+//# sourceMappingURL=WorksheetProtection.d.ts.map

package/types/src/sheetProtection/index.d.ts

@@ -1,2 +1,2 @@
-export * from './ISheetProtection';
+export * from './IWorksheetProtection';
 //# sourceMappingURL=index.d.ts.map

package/types/src/sheetView/{ISheetView.d.ts → IWorksheetView.d.ts}

@@ -2,10 +2,10 @@ import { IRange } from '@sheetxl/primitives';
 import { TopLeft } from '@sheetxl/utils';
 import { IListener } from '../listener';
 import { IColor } from '../color';
-import { IMovableSelection, IRangeSelection } from '../selection';
-import { ISheet } from '../sheet';
+import { IChartElementSelection, IMovableSelection, IRangeSelection } from '../selection';
+import { IWorksheet } from '../sheet';
 /**
- * The `ISheetView` provides properties and methods for controlling how a sheet is displayed and interacted with,
+ * The `IWorksheetView` provides properties and methods for controlling how a sheet is displayed and interacted with,
  * without affecting the underlying data itself.
  *
  * View settings include aspects like frozen panes, zoom level, selection, gridlines visibility, and whether formulas are displayed.
@@ -15,7 +15,7 @@ import { ISheet } from '../sheet';
  * * Since views only affect the presentation of the data, changes to view settings are typically not included in the undo/redo stack.
  * * Multiple views can be associated to the same collection of data, each providing a different way of viewing and interacting.
  */
-export interface ISheetView {
+export interface IWorksheetView {
     /**
      * Identifies this view.
      *
@@ -44,7 +44,7 @@ export interface ISheetView {
      * @remarks
      * The cell-coordinate reading of {@link getTopLeft} (which is base px), resolved against the row /
      * column headers. Freeze-aware per axis: a frozen band is what actually occupies the corner, so on a
-     * frozen axis the FROZEN pane's own scroll ({@link ISheetView.FreezePanes.topLeft}) answers — normally
+     * frozen axis the FROZEN pane's own scroll ({@link IWorksheetView.FreezePanes.topLeft}) answers — normally
      * leaving that axis at the sheet's start — while an unfrozen axis reads the main scroll. This is the
      * same split the xlsx writer emits as `sheetView@topLeftCell` / `pane@topLeftCell`.
      *
@@ -55,11 +55,11 @@ export interface ISheetView {
     /**
      * The freeze panes.
      */
-    setFreezePanes(freezePanes: ISheetView.FreezePanes): this;
+    setFreezePanes(freezePanes: IWorksheetView.FreezePanes): this;
     /**
      * @see {@link setFreezePanes}
      */
-    getFreezePanes(): ISheetView.FreezePanes;
+    getFreezePanes(): IWorksheetView.FreezePanes;
     /**
      * Show/Hide row headers.
      *
@@ -105,35 +105,38 @@ export interface ISheetView {
      *
      * @defaultValue {@link HeaderTextStyle.A1}
      */
-    setRowHeaderStyle(rowHeaderStyle: ISheetView.HeaderTextStyle): this;
+    setRowHeaderStyle(rowHeaderStyle: IWorksheetView.HeaderTextStyle): this;
     /**
      * @see {@link setRowHeaderStyle}
      */
-    getRowHeaderStyle(): ISheetView.HeaderTextStyle;
+    getRowHeaderStyle(): IWorksheetView.HeaderTextStyle;
     /**
      * Style of displaying default column header text.
      *
      * @defaultValue {@link HeaderTextStyle.A1}
      */
-    setColumnHeaderStyle(columnHeaderStyle: ISheetView.HeaderTextStyle): this;
+    setColumnHeaderStyle(columnHeaderStyle: IWorksheetView.HeaderTextStyle): this;
     /**
      * @see {@link setColumnHeaderStyle}
      */
-    getColumnHeaderStyle(): ISheetView.HeaderTextStyle;
+    getColumnHeaderStyle(): IWorksheetView.HeaderTextStyle;
     /**
      * Controls when the sheet's column headers display table column names.
      *
      * @defaultValue {@link ColumnHeaderTableNames.Sticky}
      */
-    setColumnHeaderTableNames(tableNames: ISheetView.ColumnHeaderTableNames): this;
+    setColumnHeaderTableNames(tableNames: IWorksheetView.ColumnHeaderTableNames): this;
     /**
      * @see {@link setColumnHeaderTableNames}
      */
-    getColumnHeaderTableNames(): ISheetView.ColumnHeaderTableNames;
+    getColumnHeaderTableNames(): IWorksheetView.ColumnHeaderTableNames;
     /**
      * Zoom. This is expressed as a percentage. Values can be between 10 (10%) or 400 (400%).
      *
      * @defaultValue `100`
+     *
+     * @remarks
+     * The zoom of the current {@link getViewMode | view mode}. Each mode keeps its own, as in Excel.
      */
     setZoomScale(zoomScale: number): this;
     /**
@@ -155,6 +158,41 @@ export interface ISheetView {
      * Zoom out the view.
      */
     zoomOut(): this;
+    /**
+     * How the sheet is shown: as the grid, with its page breaks over it, or as printed pages.
+     *
+     * @defaultValue {@link IWorksheetView.ViewMode.Normal}
+     *
+     * @remarks
+     * Switching modes restores the zoom last set in that mode; page break preview starts at 60%.
+     * Only the normal mode is rendered; the others are kept for the file.
+     */
+    setViewMode(viewMode: IWorksheetView.ViewMode): this;
+    /**
+     * @see {@link setViewMode}
+     */
+    getViewMode(): IWorksheetView.ViewMode;
+    /**
+     * Indicate whether the ruler is shown in {@link IWorksheetView.ViewMode.PageLayout | page layout}.
+     *
+     * @defaultValue `true`
+     */
+    setShowRuler(showRuler: boolean): this;
+    /**
+     * @see {@link setShowRuler}
+     */
+    isShowRuler(): boolean;
+    /**
+     * Indicate whether the margins between pages are shown in
+     * {@link IWorksheetView.ViewMode.PageLayout | page layout}.
+     *
+     * @defaultValue `true`
+     */
+    setShowWhitespace(showWhitespace: boolean): this;
+    /**
+     * @see {@link setShowWhitespace}
+     */
+    isShowWhitespace(): boolean;
     /**
      * Indicate if view is showing formulas or values
      *
@@ -260,37 +298,48 @@ export interface ISheetView {
      * Held beside the {@link getRangeSelection | range selection}, independently of it.
      */
     getMovableSelection(): IMovableSelection;
+    /**
+     * Returns the chart element selection: the elements selected inside the chart whose movable is
+     * the active selected one.
+     *
+     * @remarks
+     * Held beside the {@link getMovableSelection | movable selection} and following it: selecting
+     * an element selects its chart's movable, and the selection empties when the movable selection
+     * moves on. Empty while no chart element is selected: a selected chart with no element selected
+     * is the chart itself.
+     */
+    getChartElementSelection(): IChartElementSelection;
     /**
      * Allow for a bulk update of the view properties.
      */
-    update(properties: Partial<ISheetView.Properties>): this;
+    update(properties: Partial<IWorksheetView.Properties>): this;
     /**
      * Add Listeners.
      *
      * @see
      * {@link IListener.ISource.addListeners}
      */
-    addListeners(listeners: ISheetView.IListeners, options?: IListener.Options): IListener.Remove;
+    addListeners(listeners: IWorksheetView.IListeners, options?: IListener.Options): IListener.Remove;
     /**
      * Persist to JSON.
      *
      * @remarks
      * Returns null if it has no customized values.
      */
-    toJSON(): ISheetView.JSON | null;
+    toJSON(): IWorksheetView.JSON | null;
     /**
      * For runtime type checking.
      */
-    readonly isISheetView: true;
+    readonly isIWorksheetView: true;
 }
 /**
- * {@inheritDoc ISheetView}
+ * {@inheritDoc IWorksheetView}
  * @see
  * ### **Interface**
  *
- * {@link ISheetView}
+ * {@link IWorksheetView}
  */
-export declare namespace ISheetView {
+export declare namespace IWorksheetView {
     /**
      * The coordinates for a FreezePane.
      *
@@ -306,99 +355,143 @@ export declare namespace ISheetView {
          *
          * @remarks
          * If the current view has a scroll offset and freeze is called it will 'transfer' the scroll
-         * coordinates. Like {@link ISheetView.setTopLeft | topLeft}, this is expressed in zoom-independent
+         * coordinates. Like {@link IWorksheetView.setTopLeft | topLeft}, this is expressed in zoom-independent
          * (base, unzoomed) px and is therefore stable across zoom changes.
          */
         topLeft?: Partial<TopLeft>;
+        /**
+         * The selections Excel remembers in the panes other than the one holding the selection, as the
+         * file wrote them.
+         *
+         * @remarks
+         * SheetXL has one selection, shown across every pane ({@link IWorksheetView.getSelection}); these
+         * are carried for the file only. They are dropped when the freeze moves, and do not follow
+         * inserts or deletes.
+         */
+        paneSelections?: PaneSelections;
     }
     /**
-     * A listener for changes to the ISheetView object.
+     * A frozen pane other than the main one: the frozen corner, the frozen rows (`topRight` when
+     * columns are frozen too), or the frozen columns (`bottomLeft`).
+     */
+    type Pane = 'topLeft' | 'topRight' | 'bottomLeft';
+    /**
+     * See {@link IWorksheetView.FreezePanes.paneSelections}.
+     */
+    type PaneSelections = Partial<Record<Pane, PaneSelection>>;
+    /**
+     * One pane's selection, in A1 form.
+     */
+    interface PaneSelection {
+        /** The active cell. */
+        activeCell: string;
+        /** The selected ranges, space separated; absent when only the active cell is selected. */
+        sqref?: string;
+    }
+    /**
+     * A listener for changes to the IWorksheetView object.
      */
     interface Events {
         /**
          * Called when the sheetView changes.
          */
-        onTopLeftChange?(source: ISheetView, change: Readonly<Partial<TopLeft>>): void;
+        onTopLeftChange?(source: IWorksheetView, change: Readonly<Partial<TopLeft>>): void;
         /**
          * Called when the freeze pane settings have changed
          */
-        onFreezePaneChange?(source: ISheetView): void;
+        onFreezePaneChange?(source: IWorksheetView): void;
         /**
          * Called when the selection changes.
          */
-        onSelectionChange?(source: ISheetView): void;
+        onSelectionChange?(source: IWorksheetView): void;
         /**
          * Called when the zoom scale changes.
          */
-        onZoomScaleChange?(source: ISheetView): void;
+        onZoomScaleChange?(source: IWorksheetView): void;
         /**
          * Called when the movable selection changes.
          */
-        onMovableSelectionChange?(source: ISheetView): void;
+        onMovableSelectionChange?(source: IWorksheetView): void;
+        /**
+         * Called when the chart element selection changes.
+         */
+        onChartElementSelectionChange?(source: IWorksheetView): void;
         /**
          * Fired when header settings change.
          */
-        onHeaderChange?(source: ISheetView): void;
+        onHeaderChange?(source: IWorksheetView): void;
         /**
          * Called when the movable selection changes.
          */
-        onAnyChange?(source: ISheetView): void;
+        onAnyChange?(source: IWorksheetView): void;
     }
-    interface IListeners extends IListener.Callbacks<ISheetView, ISheetView.Events> {
+    interface IListeners extends IListener.Callbacks<IWorksheetView, IWorksheetView.Events> {
     }
     /**
-     * A set of values that can be set on a ISheetView.
+     * A set of values that can be set on a IWorksheetView.
      *
      * @see
-     * {@link ISheetView}
+     * {@link IWorksheetView}
      */
     interface Properties {
         /** The selection coords. `null` when there is no stored selection (it lives on the RangeSelection). */
         selection?: IRangeSelection.Coords | null;
-        /** {@inheritDoc ISheetView.setTopLeft} */
+        /** {@inheritDoc IWorksheetView.setTopLeft} */
         topLeft: TopLeft;
-        /** {@inheritDoc ISheetView.setFreezePanes} */
-        freezePanes: ISheetView.FreezePanes;
-        /** {@inheritDoc ISheetView.setShowRowHeaders} */
+        /** {@inheritDoc IWorksheetView.setFreezePanes} */
+        freezePanes: IWorksheetView.FreezePanes;
+        /** {@inheritDoc IWorksheetView.setShowRowHeaders} */
         showRowHeaders: boolean;
-        /** {@inheritDoc ISheetView.setShowColumnHeaders} */
+        /** {@inheritDoc IWorksheetView.setShowColumnHeaders} */
         showColumnHeaders: boolean;
-        /** {@inheritDoc ISheetView.setShowRowGridlines} */
+        /** {@inheritDoc IWorksheetView.setShowRowGridlines} */
         showRowGridlines: boolean;
-        /** {@inheritDoc ISheetView.setShowColumnGridlines} */
+        /** {@inheritDoc IWorksheetView.setShowColumnGridlines} */
         showColumnGridlines: boolean;
-        /** {@inheritDoc ISheetView.setRowHeaderStyle} */
-        rowHeaderStyle: ISheetView.HeaderTextStyle;
-        /** {@inheritDoc ISheetView.setColumnHeaderStyle} */
-        columnHeaderStyle: ISheetView.HeaderTextStyle;
-        /** {@inheritDoc ISheetView.setColumnHeaderTableNames} */
-        tableNames: ISheetView.ColumnHeaderTableNames;
-        /** {@inheritDoc ISheetView.setZoomScale} */
+        /** {@inheritDoc IWorksheetView.setRowHeaderStyle} */
+        rowHeaderStyle: IWorksheetView.HeaderTextStyle;
+        /** {@inheritDoc IWorksheetView.setColumnHeaderStyle} */
+        columnHeaderStyle: IWorksheetView.HeaderTextStyle;
+        /** {@inheritDoc IWorksheetView.setColumnHeaderTableNames} */
+        tableNames: IWorksheetView.ColumnHeaderTableNames;
+        /** {@inheritDoc IWorksheetView.setZoomScale} */
         zoomScale: number;
-        /** {@inheritDoc ISheetView.setShowFormulas} */
+        /** {@inheritDoc IWorksheetView.setViewMode} */
+        viewMode: IWorksheetView.ViewMode;
+        /** The zoom last set in each view mode, for the modes that have one. */
+        zoomScales: IWorksheetView.ZoomScales | null;
+        /** {@inheritDoc IWorksheetView.setShowRuler} */
+        showRuler: boolean;
+        /** {@inheritDoc IWorksheetView.setShowWhitespace} */
+        showWhitespace: boolean;
+        /**
+         * Whether the window's panes are locked by the workbook's protection. Kept from the file.
+         */
+        windowProtection: boolean;
+        /** {@inheritDoc IWorksheetView.setShowFormulas} */
         showFormulas: boolean;
-        /** {@inheritDoc ISheetView.setShowLockedShading} */
+        /** {@inheritDoc IWorksheetView.setShowLockedShading} */
         showLockedShading: boolean;
-        /** {@inheritDoc ISheetView.setShowInvalid} */
+        /** {@inheritDoc IWorksheetView.setShowInvalid} */
         showInvalid: boolean;
-        /** {@inheritDoc ISheetView.setShowZeros} */
+        /** {@inheritDoc IWorksheetView.setShowZeros} */
         showZeros: boolean;
-        /** {@inheritDoc ISheetView.setShowOutlineSymbols} */
+        /** {@inheritDoc IWorksheetView.setShowOutlineSymbols} */
         showOutlineSymbols: boolean;
-        /** {@inheritDoc ISheetView.setRightToLeft} */
+        /** {@inheritDoc IWorksheetView.setRightToLeft} */
         rightToLeft: boolean;
-        /** {@inheritDoc ISheetView.setGridLineColor} */
+        /** {@inheritDoc IWorksheetView.setGridLineColor} */
         gridLineColor: string | IColor | null;
     }
     interface ConstructorOptions {
         /**
          * Sheets need to be associated with a sheet.
          */
-        sheet: ISheet;
+        sheet: IWorksheet;
         /**
          * The state to load.
          */
-        json?: ISheetView.JSON;
+        json?: IWorksheetView.JSON;
     }
     /**
      * A JSON representation useful for persistence.
@@ -409,6 +502,20 @@ export declare namespace ISheetView {
         freezePanes?: string | FreezePanes;
         zoomScale?: string | number;
     }
+    /**
+     * How a sheet is shown. Shaped after Excel's `Window.View`.
+     */
+    const ViewMode: {
+        /** The grid. */
+        readonly Normal: "normal";
+        /** The grid, with the pages it prints on drawn over it. */
+        readonly PageBreakPreview: "pageBreakPreview";
+        /** The sheet as printed pages, with headers, footers and margins. */
+        readonly PageLayout: "pageLayout";
+    };
+    type ViewMode = typeof ViewMode[keyof typeof ViewMode];
+    /** A zoom percentage for each view mode that has one. */
+    type ZoomScales = Partial<Record<ViewMode, number>>;
     /**
      * Suggested style for rendering **header text** on either axis.
      *
@@ -425,8 +532,8 @@ export declare namespace ISheetView {
      * @remarks
      * - This is a **hint** for the header renderer and may be ignored
      *   (e.g., by a custom `HeaderRenderer`).
-     * - Use {@link ISheetView.setRowHeaderStyle} and
-     *   {@link ISheetView.setColumnHeaderStyle} to apply per-axis preferences.
+     * - Use {@link IWorksheetView.setRowHeaderStyle} and
+     *   {@link IWorksheetView.setColumnHeaderStyle} to apply per-axis preferences.
      *
      * @example
      * // Excel-like: columns as A/B/C…, rows as 1/2/3…
@@ -460,15 +567,15 @@ export declare namespace ISheetView {
      * - View-only: does not affect formulas or underlying data.
      * - Applies when a table intersects the viewport; exact resolution when multiple
      *   tables qualify is implementation-defined.
-     * - Complements {@link ISheetView.setFreezePanes | freeze panes} and does not
+     * - Complements {@link IWorksheetView.setFreezePanes | freeze panes} and does not
      *   “freeze” content—this is a label-substitution rule for the column header UI.
      *
      * @example
      * // Show table column names when the table header row scrolls off-screen
      * sheetView.setColumnHeaderTableNames(ColumnHeaderTableNames.Sticky);
      *
-     * @see {@link ISheetView.setColumnHeaderTableNames}
-     * @see {@link ISheetView.getColumnHeaderTableNames}
+     * @see {@link IWorksheetView.setColumnHeaderTableNames}
+     * @see {@link IWorksheetView.getColumnHeaderTableNames}
      */
     const ColumnHeaderTableNames: {
         /**
@@ -490,4 +597,4 @@ export declare namespace ISheetView {
     /** Type union for {@link ColumnHeaderTableNames}. */
     type ColumnHeaderTableNames = typeof ColumnHeaderTableNames[keyof typeof ColumnHeaderTableNames];
 }
-//# sourceMappingURL=ISheetView.d.ts.map
+//# sourceMappingURL=IWorksheetView.d.ts.map