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

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

package/types/src/sheetView/WorksheetView.d.ts

@@ -0,0 +1,139 @@
+import { IRange } from '@sheetxl/primitives';
+import { TopLeft } from '@sheetxl/utils';
+import { IListener } from '../listener';
+import { IColor } from '../color';
+import { IChartElementSelection, IMovableSelection, IRangeSelection } from '../selection';
+import { ChartElementSelection } from '../selection/ChartElementSelection';
+import { IWorksheet } from '../sheet';
+import { ListenerEmitter } from '../listener/ListenerEmitter';
+import { IWorksheetView } from './IWorksheetView';
+/**
+ * Default Sheet View
+ */
+export declare class WorksheetView implements IWorksheetView {
+    protected _state: IWorksheetView.Properties;
+    protected _sheet: IWorksheet;
+    protected _rangeSelection: IRangeSelection;
+    protected _rangeSelectionRemoveListener: IListener.Remove;
+    protected _emitter: ListenerEmitter<IWorksheetView, IWorksheetView.IListeners>;
+    protected _movableSelection: IMovableSelection;
+    protected _movableSelectionRemoveListener: IListener.Remove;
+    protected _chartElementSelection: ChartElementSelection;
+    protected _chartElementSelectionRemoveListener: IListener.Remove;
+    protected _id: string;
+    constructor(options: IWorksheetView.ConstructorOptions);
+    /** {@inheritDoc IWorksheetView.getId} */
+    getId(): string;
+    /** {@inheritDoc IWorksheetView.addListeners} */
+    addListeners(listeners: IWorksheetView.IListeners, options?: IListener.Options): IListener.Remove;
+    /** {@inheritDoc IWorksheetView.setTopLeft} */
+    setTopLeft(topLeft: Partial<TopLeft>): this;
+    /** {@inheritDoc IWorksheetView.getTopLeft} */
+    getTopLeft(): TopLeft;
+    /** {@inheritDoc IWorksheetView.getTopLeftCell} */
+    getTopLeftCell(): IRange.CellCoords;
+    /** {@inheritDoc IWorksheetView.getFreezePanes} */
+    getFreezePanes(): IWorksheetView.FreezePanes;
+    /** {@inheritDoc IWorksheetView.setFreezePanes} */
+    setFreezePanes(freezePanes: Partial<IWorksheetView.FreezePanes> | null): this;
+    protected _mergeFreezePanes(freezePanes: Partial<IWorksheetView.FreezePanes> | null): Partial<IWorksheetView.FreezePanes>;
+    /** {@inheritDoc IWorksheetView.isShowRowHeaders} */
+    isShowRowHeaders(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowRowHeaders} */
+    setShowRowHeaders(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowColumnHeaders} */
+    isShowColumnHeaders(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowColumnHeaders} */
+    setShowColumnHeaders(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowRowGridlines} */
+    isShowRowGridlines(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowRowGridlines} */
+    setShowRowGridlines(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowColumnGridlines} */
+    isShowColumnGridlines(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowColumnGridlines} */
+    setShowColumnGridlines(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.getRowHeaderStyle} */
+    getRowHeaderStyle(): IWorksheetView.HeaderTextStyle;
+    /** {@inheritDoc IWorksheetView.setRowHeaderStyle} */
+    setRowHeaderStyle(newValue: IWorksheetView.HeaderTextStyle): this;
+    /** {@inheritDoc IWorksheetView.setColumnHeaderStyle} */
+    setColumnHeaderStyle(newValue: IWorksheetView.HeaderTextStyle): this;
+    /** {@inheritDoc IWorksheetView.getColumnHeaderStyle} */
+    getColumnHeaderStyle(): IWorksheetView.HeaderTextStyle;
+    /** {@inheritDoc IWorksheetView.setColumnHeaderTableNames} */
+    setColumnHeaderTableNames(tableNames: IWorksheetView.ColumnHeaderTableNames): this;
+    /** {@inheritDoc IWorksheetView.getColumnHeaderTableNames} */
+    getColumnHeaderTableNames(): IWorksheetView.ColumnHeaderTableNames;
+    /** {@inheritDoc IWorksheetView.getZoomScale} */
+    getZoomScale(): number;
+    /** {@inheritDoc IWorksheetView.setZoomScale} */
+    setZoomScale(zoomScale: number): this;
+    /** {@inheritDoc IWorksheetView.zoomIn} */
+    zoomIn(): this;
+    /** {@inheritDoc IWorksheetView.zoomOut} */
+    zoomOut(): this;
+    protected _updateZoom(nextZoom: number): this;
+    /** {@inheritDoc IWorksheetView.getNextZoomScale} */
+    getNextZoomScale(zoomIn: boolean, amount?: number): number;
+    /** {@inheritDoc IWorksheetView.getViewMode} */
+    getViewMode(): IWorksheetView.ViewMode;
+    /** {@inheritDoc IWorksheetView.setViewMode} */
+    setViewMode(viewMode: IWorksheetView.ViewMode): this;
+    /** {@inheritDoc IWorksheetView.isShowRuler} */
+    isShowRuler(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowRuler} */
+    setShowRuler(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowWhitespace} */
+    isShowWhitespace(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowWhitespace} */
+    setShowWhitespace(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowFormulas} */
+    isShowFormulas(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowFormulas} */
+    setShowFormulas(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowLockedShading} */
+    isShowLockedShading(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowLockedShading} */
+    setShowLockedShading(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowInvalid} */
+    isShowInvalid(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowInvalid} */
+    setShowInvalid(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isRightToLeft} */
+    isRightToLeft(): boolean;
+    /** {@inheritDoc IWorksheetView.setRightToLeft} */
+    setRightToLeft(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowZeros} */
+    isShowZeros(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowZeros} */
+    setShowZeros(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.isShowOutlineSymbols} */
+    isShowOutlineSymbols(): boolean;
+    /** {@inheritDoc IWorksheetView.setShowOutlineSymbols} */
+    setShowOutlineSymbols(newValue: boolean): this;
+    /** {@inheritDoc IWorksheetView.getGridLineColor} */
+    getGridLineColor(): any;
+    /** {@inheritDoc IWorksheetView.setGridLineColor} */
+    setGridLineColor(newValue: IColor | null): this;
+    /** {@inheritDoc IWorksheetView.getRangeSelection} */
+    getRangeSelection(): IRangeSelection;
+    /** {@inheritDoc IWorksheetView.getMovableSelection} */
+    getMovableSelection(): IMovableSelection;
+    /** {@inheritDoc IWorksheetView.getChartElementSelection} */
+    getChartElementSelection(): IChartElementSelection;
+    protected _update<T extends IWorksheetView.Properties[K], K extends keyof IWorksheetView.Properties>(newValue: T, property: K, event: keyof IWorksheetView.IListeners): T;
+    protected _notifyAll(): void;
+    /** {@inheritDoc IWorksheetView.toJSON} */
+    toJSON(): IWorksheetView.JSON | null;
+    protected _fromJSON(json: IWorksheetView.JSON): void;
+    /** {@inheritDoc IWorksheetView.clear} */
+    clear(notify?: boolean): this;
+    /** {@inheritDoc IWorksheetView.update} */
+    update(properties: Partial<IWorksheetView.Properties>): this;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
+    /** {@inheritDoc IWorksheetView.isIWorksheetView} */
+    get isIWorksheetView(): true;
+}
+//# sourceMappingURL=WorksheetView.d.ts.map

package/types/src/sheetView/_SheetViewUtils.d.ts

@@ -1,14 +1,16 @@
 import { IRangeSelection } from '../selection';
-import { ISheetView } from './ISheetView';
+import { IWorksheetView } from './IWorksheetView';
 /**
  * Frozen FreezePanes for easy comparisons.
  */
-export declare const EmptyFreezePanes: ISheetView.FreezePanes;
+export declare const EmptyFreezePanes: IWorksheetView.FreezePanes;
 /**
  * Frozen IRangeSelection.Coords for easy comparisons.
  */
 export declare const EmptySelection: IRangeSelection.Coords;
-export declare const DefaultSheetProperties: ISheetView.Properties;
+export declare const DefaultSheetProperties: IWorksheetView.Properties;
+/** The zoom a view mode opens at before one is set in it. Measured against Excel. */
+export declare const DefaultViewModeZoom: Readonly<Record<IWorksheetView.ViewMode, number>>;
 /**
  * A simple stepper.
  *

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

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

package/types/src/slicer/ISlicer.d.ts

@@ -5,7 +5,7 @@ import { IListener } from '../listener';
 import { IModel } from '../model';
 import { IMovable, IMovableCollection } from '../movable';
 import { ITable } from '../table';
-import { ISheet } from '../sheet';
+import { IWorksheet } from '../sheet';
 /**
  * A slicer: buttons that filter one column of a table.
  *
@@ -223,7 +223,7 @@ export declare namespace ISlicer {
          *
          * @defaultValue The table's sheet.
          */
-        sheet?: ISheet;
+        sheet?: IWorksheet;
         /** {@inheritDoc ISlicer.JSON.caption} */
         caption?: string;
         /**

package/types/src/sort/ISort.d.ts

@@ -173,12 +173,10 @@ export declare namespace ISort {
          */
         iconId?: number;
         /**
-         * Used with sortOn === cellColor or fontColor
-         *
-         * @remarks
-         * **PLACEHOLDER** - This is a placeholder for future use.
+         * The format whose color sorts first, with `sortOn` {@link ISort.SortOn.FillColor} (its fill)
+         * or {@link ISort.SortOn.FontColor} (its font color).
          */
-        dxfId?: any;
+        style?: ICellStyle.Properties;
         /**
          * Sort by a custom list.
          * @remarks
@@ -315,6 +313,38 @@ export declare namespace ISort {
          * @defaultValue false
          */
         includeHidden?: boolean;
+        /**
+         * The ranges the last sort in the file covered, kept so a saved workbook says what it was
+         * read with.
+         *
+         * @remarks
+         * Excel records the range it last sorted, which need not be the table's or filter's range: it
+         * may leave out the header or run past the last row. A sort made through the model sorts the
+         * table body and clears this.
+         */
+        extent?: ISort.SortExtent;
     };
+    /**
+     * A range given by how far each of its edges sits from the edges of the table or filter range,
+     * so it moves with that range. Positive is down or right.
+     */
+    interface Extent {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    }
+    /**
+     * The ranges of a sort as a file records them.
+     */
+    interface SortExtent {
+        /** The range the sort covered. */
+        range: ISort.Extent;
+        /**
+         * Each level's range, in the order of {@link JSON.sorts}. `null` for a level that uses its
+         * column of {@link range}.
+         */
+        sorts?: (ISort.Extent | null)[];
+    }
 }
 //# sourceMappingURL=ISort.d.ts.map