@sheetxl/sdk 0.8.0-beta.7 → 0.8.0-beta.9

package/types/src/sheet/SheetRange.d.ts

@@ -1,5 +1,5 @@
 import { IRange, Scalar, IRangeStats, InteropScalar } from '@sheetxl/primitives';
-import { Size } from '@sheetxl/utils';
+import { Size, RunCoords } from '@sheetxl/utils';
 import { ITransaction } from '../transaction';
 import { IListener } from '../listener';
 import { ICell } from '../cell';
@@ -20,6 +20,7 @@ import { IConditionalFormatCollection } from '../conditionalFormat/IConditionalF
 import { IProtectedRange, IProtectedRangeCollection } from '../protectedRange';
 import { ISheet } from './ISheet';
 import { ISheetInternal } from './Sheet';
+import { Outline } from '../outline/Outline';
 import { AutoFillProjection } from './_SheetAutoFillUtils';
 /**
  * The empty feature selection — the raw-value fast path.
@@ -332,6 +333,20 @@ export declare class SheetRange implements ICellRange {
     autoFill(destination: ICellRange.Address, options?: ICellRange.AutoFillOptions): this;
     /** {@inheritDoc ICellRange.autoFit} */
     autoFit(options?: ICellRange.AutoFitOptions): this;
+    /** {@inheritDoc ICellRange.group} */
+    group(axis?: IRange.Axis, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc ICellRange.ungroup} */
+    ungroup(axis?: IRange.Axis, options?: ITransaction.OperationOptions): this;
+    protected _changeOutlineLevels(axis: IRange.Axis | undefined, delta: 1 | -1, options?: ITransaction.OperationOptions): void;
+    /** {@inheritDoc ICellRange.showGroupDetails} */
+    showGroupDetails(axis?: IRange.Axis, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc ICellRange.hideGroupDetails} */
+    hideGroupDetails(axis?: IRange.Axis, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc ICellRange.clearGroups} */
+    clearGroups(axes?: IRange.AxisSelection, options?: ITransaction.OperationOptions): this;
+    protected _getOutline(): Outline;
+    protected _getRun(axis: IRange.Axis): RunCoords;
+    protected _resolveOutlineAxis(axis: IRange.Axis | undefined): IRange.Axis;
     /** {@inheritDoc ICellRange.clear} */
     clear(applyTo?: ICell.Content, options?: ITransaction.OperationOptions): this;
     /** {@inheritDoc ICellRange.setHyperlink} */

package/types/src/sheet/_SheetUtils.d.ts

@@ -18,8 +18,16 @@ import { SheetCellOptions } from './SheetCell';
  * Selects max coords in an axis.
  */
 export declare function expandRanges<CT extends IRange.Coords = IRange.Coords>(ranges: readonly CT[], maxRange: IRange.Coords, axis: IRange.Axis, after?: boolean): CT[];
-export declare function isEntireRows(coords: readonly IRange.Coords[], maxCoords: IRange.Coords, all: boolean): boolean;
-export declare function isEntireCols(coords: readonly IRange.Coords[], maxCoords: IRange.Coords, all: boolean): boolean;
+/**
+ * Whether the ranges span every row (whole columns, such as `B:D`): all of them, or any when `all`
+ * is `false`.
+ */
+export declare function spansAllRows(coords: readonly IRange.Coords[], maxCoords: IRange.Coords, all: boolean): boolean;
+/**
+ * Whether the ranges span every column (whole rows, such as `2:4`): all of them, or any when `all`
+ * is `false`.
+ */
+export declare function spansAllColumns(coords: readonly IRange.Coords[], maxCoords: IRange.Coords, all: boolean): boolean;
 export declare function countSpans(coords: readonly IRange.Coords[], axis?: IRange.Axis): number;
 /**
  * Defaults to IRange.Axis.Row if the bounds are the same size.

package/types/src/sheetHeader/ISheetHeader.d.ts

@@ -229,6 +229,10 @@ export declare namespace ISheetHeader {
          * Called when headers visibility (hidden) has changed.
          */
         onHiddenChange?(source: ISheetHeader): void;
+        /**
+         * Called when header outline levels, or which groups are collapsed, have changed.
+         */
+        onOutlineChange?(source: ISheetHeader): void;
     }
     interface IListeners extends IListener.Callbacks<ISheetHeader, ISheetHeader.Events> {
     }

package/types/src/sheetHeader/SheetCellHeader.d.ts

@@ -4,6 +4,8 @@ import { ITable } from '../table';
 import { ICell, ICellHeader } from '../cell';
 import { ISheetHeader } from './ISheetHeader';
 import type * as _Utils from './_HeaderUtils';
+/** The deepest outline level a header can hold. */
+export declare const MaxOutlineLevel = 7;
 export declare class SheetCellHeader implements ICellHeader {
     protected _sheetHeader: ISheetHeader;
     protected _index: number;
@@ -30,6 +32,8 @@ export declare class SheetCellHeader implements ICellHeader {
     asCell(): ICell;
     /** {@inheritDoc ICellHeader.getSizeRelative} */
     getSizeRelative(): number;
+    /** {@inheritDoc ICellHeader.getOutlineLevel} */
+    getOutlineLevel(): number;
     /** {@inheritDoc ICellHeader.createCellHeader} */
     createCellHeader(update: ICellHeader.Modifiers): ICellHeader;
     /** {@inheritDoc ICellHeader.isEqual} */

package/types/src/sheetHeader/SheetHeader.d.ts

@@ -35,6 +35,7 @@ export declare class SheetHeader implements ISheetHeader {
     protected _headerRunCoords: RunCoords | null;
     protected _hasHidden: boolean;
     protected _hiddenSignature: number;
+    protected _outlineSignature: number;
     protected _lastHeaderRead: {
         offset: number;
         header: ICellHeader;
@@ -116,6 +117,15 @@ export declare class SheetHeader implements ISheetHeader {
     getScaleFactor(): number;
     protected get _headers(): ITypes.RunCoordValue<_Utils.CellHeaderState>[];
     protected _updatePairsInternal(setters: ICellHeaderRange.AddressUpdatePair[], options?: ICellHeaderRange.UpdateHeadersOptions): RunCoords[] | null;
+    /**
+     * The header runs as stored: ordered, non-overlapping, gaps are default headers.
+     *
+     * @remarks
+     * The array is replaced, never mutated, when the headers change, so its identity can key a cache.
+     *
+     * @internal
+     */
+    _getHeaderRuns(): readonly ITypes.RunCoordValue<_Utils.CellHeaderState>[];
     /** {@inheritDoc ISheetHeader.hasHidden} */
     hasHidden(): boolean;
     /** {@inheritDoc ISheetHeader.getDefaultSize} */

package/types/src/sheetHeader/_HeaderUtils.d.ts

@@ -16,8 +16,10 @@ export interface CellHeaderState {
     h?: boolean;
     s?: IStyle;
     cs?: boolean;
-    /** outline level */
+    /** outline level, 1-7; absent when not grouped */
     l?: number;
+    /** collapsed; set on a group's summary header */
+    cl?: boolean;
 }
 /**
  * Use for tracking the accumulated sizes from the beginning of the headers.

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

@@ -221,6 +221,21 @@ export interface ISheetView extends IMovableSelection, IListener.ISource<IMovabl
      * @see {@link setShowZeros}
      */
     isShowZeros(): boolean;
+    /**
+     * Indicate whether the outline symbols (the brackets, the collapse and expand buttons and the
+     * level buttons of the row and column groups) are shown.
+     *
+     * @defaultValue `true`
+     *
+     * @remarks
+     * A view setting, as in Excel (`Window.DisplayOutline`, Ctrl+8): the groups stay on the sheet,
+     * only their symbols are hidden. Round-trips through xlsx `sheetView@showOutlineSymbols`.
+     */
+    setShowOutlineSymbols(showOutlineSymbols: boolean): this;
+    /**
+     * @see {@link setShowOutlineSymbols}
+     */
+    isShowOutlineSymbols(): boolean;
     /**
      * The color of the gridline on the sheet.
      *
@@ -375,6 +390,8 @@ export declare namespace ISheetView {
         showInvalid: boolean;
         /** {@inheritDoc ISheetView.setShowZeros} */
         showZeros: boolean;
+        /** {@inheritDoc ISheetView.setShowOutlineSymbols} */
+        showOutlineSymbols: boolean;
         /** {@inheritDoc ISheetView.setRightToLeft} */
         rightToLeft: boolean;
         /** {@inheritDoc ISheetView.setGridLineColor} */

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

@@ -93,6 +93,10 @@ export declare class SheetView implements ISheetView, IMovableSelection {
     isShowZeros(): boolean;
     /** {@inheritDoc ISheetView.setShowZeros} */
     setShowZeros(newValue: boolean): this;
+    /** {@inheritDoc ISheetView.isShowOutlineSymbols} */
+    isShowOutlineSymbols(): boolean;
+    /** {@inheritDoc ISheetView.setShowOutlineSymbols} */
+    setShowOutlineSymbols(newValue: boolean): this;
     /** {@inheritDoc ISheetView.getGridLineColor} */
     getGridLineColor(): any;
     /** {@inheritDoc ISheetView.setGridLineColor} */

package/types/src/table/AnchoredTable.d.ts

@@ -601,8 +601,13 @@ export declare class AnchoredTable extends AbstractAnchored<State, ITable.Events
      * props an undo restores, and writing through one would rewrite history in place.
      */
     protected _updateSorts(sorts: ISort.Options[] | undefined, orderedColumnsProps: ColumnPropertiesState[]): void;
-    /** {@link _updateSorts} for the filters. */
-    protected _updateFilters(conditions: ICondition.Input[] | undefined, orderedColumnsProps: ColumnPropertiesState[]): void;
+    /**
+     * {@link _updateSorts} for the filters.
+     *
+     * @param persisted The conditions are a load's. One that names an operator this build does not
+     * know is kept as it is and filters nothing, where an authored one throws.
+     */
+    protected _updateFilters(conditions: ICondition.Input[] | undefined, orderedColumnsProps: ColumnPropertiesState[], persisted?: boolean): void;
     /** {@inheritDoc ITable.filter} */
     filter(conditions?: ICondition.Input | ICondition.RangeOptions, options?: ITransaction.OperationOptions): Promise<this>;
     /** {@inheritDoc ITable.sort} */

package/types/src/text/IText.d.ts

@@ -1,3 +1,7 @@
+import { IFont } from '../font';
+import { IFill, IStroke, IEffect } from '../fill';
+import { IHyperlink } from '../hyperlink';
+import { ITextFrame } from './ITextFrame';
 import { ITextLine as _ITextLine } from './TextLine';
 import { ITextParagraph as _ITextParagraph } from './TextParagraph';
 import { ITextRun as _ITextRun } from './TextRun';
@@ -49,5 +53,183 @@ export declare namespace IText {
         readonly Double: "double";
     };
     type StrikeStyle = typeof StrikeStyle[keyof typeof StrikeStyle];
+    /**
+     * How a paragraph's text is aligned between its margins.
+     */
+    const ParagraphAlignment: {
+        readonly Left: "left";
+        readonly Center: "center";
+        readonly Right: "right";
+        /** Spread to both margins, the last line excepted. */
+        readonly Justify: "justify";
+        /** Justified with a low kashida, for Arabic text. */
+        readonly JustifyLow: "justifyLow";
+        /** Every line, the last included, is spread to both margins. */
+        readonly Distributed: "distributed";
+        /** Distributed the way Thai text is. */
+        readonly ThaiDistributed: "thaiDistributed";
+    };
+    type ParagraphAlignment = typeof ParagraphAlignment[keyof typeof ParagraphAlignment];
+    /**
+     * Where runs of different sizes sit on a line.
+     */
+    const FontAlignment: {
+        readonly Auto: "auto";
+        readonly Top: "top";
+        readonly Center: "center";
+        readonly Baseline: "baseline";
+        readonly Bottom: "bottom";
+    };
+    type FontAlignment = typeof FontAlignment[keyof typeof FontAlignment];
+    /**
+     * How a run of drawing text is underlined.
+     *
+     * @remarks
+     * Drawing text has more underlines than a cell's font ({@link IFont.UnderlineStyle}); the two
+     * agree on `none`, `single` and `double`.
+     */
+    const UnderlineStyle: {
+        readonly None: "none";
+        /** Each word underlined, the spaces between them not. */
+        readonly Words: "words";
+        readonly Single: "single";
+        readonly Double: "double";
+        readonly Heavy: "heavy";
+        readonly Dotted: "dotted";
+        readonly DottedHeavy: "dottedHeavy";
+        readonly Dash: "dash";
+        readonly DashHeavy: "dashHeavy";
+        readonly DashLong: "dashLong";
+        readonly DashLongHeavy: "dashLongHeavy";
+        readonly DotDash: "dotDash";
+        readonly DotDashHeavy: "dotDashHeavy";
+        readonly DotDotDash: "dotDotDash";
+        readonly DotDotDashHeavy: "dotDotDashHeavy";
+        readonly Wavy: "wavy";
+        readonly WavyHeavy: "wavyHeavy";
+        readonly WavyDouble: "wavyDouble";
+    };
+    type UnderlineStyle = typeof UnderlineStyle[keyof typeof UnderlineStyle];
+    /**
+     * A font named by a run: a family, or one of the theme's two fonts.
+     */
+    interface FontJSON {
+        family?: string;
+        /** The theme's heading (`major`) or body (`minor`) font, in place of a family. */
+        scheme?: IFont.Scheme;
+        /** PANOSE classification as the file states it (ten hex bytes). */
+        panose?: string;
+        /** A family to fall back to, derived from `panose` when read. */
+        fallbacks?: string[];
+        pitch?: string;
+        charset?: IFont.Charset;
+    }
+    /**
+     * How a run is formatted. Sizes are in points, `baseline` is a percentage of the size (`30`
+     * raises the run as a superscript), colors are fills or serialized colors.
+     *
+     * @remarks
+     * Where a cell's font has the same property ({@link IStyledFont.Properties}) the name and
+     * values are the same: `weight`, `style`, `letterSpacing`, `family`.
+     */
+    interface RunPropertiesJSON {
+        /** Font size in points. */
+        size?: number;
+        /** `700` for bold, `400` for regular. */
+        weight?: number;
+        style?: IFont.Style;
+        underline?: UnderlineStyle;
+        strike?: StrikeStyle;
+        /** The text color: a fill (solid, gradient, pattern) or a serialized color. */
+        color?: IFill.JSON | string;
+        /** The Latin font. */
+        font?: FontJSON;
+        eastAsianFont?: FontJSON;
+        complexScriptFont?: FontJSON;
+        symbolFont?: FontJSON;
+        /** Language tag (`en-US`). */
+        language?: string;
+        alternateLanguage?: string;
+        /** Kerning threshold in points. */
+        kerning?: number;
+        /** Character spacing in points. */
+        letterSpacing?: number;
+        /** Baseline shift as a percentage of the font size; positive raises. */
+        baseline?: number;
+        capitals?: SmallCaps;
+        normalizeHeight?: boolean;
+        /** Highlight color, serialized. */
+        highlight?: string;
+        hyperlink?: IHyperlink.JSON;
+        /** The text outline. */
+        outline?: IStroke.JSON;
+        effects?: IEffect.JSON[];
+    }
+    /** A run of text. */
+    interface RunJSON extends RunPropertiesJSON {
+        /** The run's text; `'\n'` alone is a line break inside the paragraph. */
+        text: string;
+        /** Set when the run is a field (`fld`): its id and kind (`TxLink`, `slidenum`…). */
+        field?: {
+            id: string;
+            type?: string;
+        };
+    }
+    /** A spacing: in points, or as a percentage of a line (`100` is single spacing). */
+    type SpacingJSON = {
+        points: number;
+    } | {
+        percent: number;
+    };
+    /** A paragraph's bullet. Without a `type` the entry only restyles the inherited bullet. */
+    interface BulletJSON {
+        type?: 'none' | 'char' | 'auto' | 'image';
+        /** The character of a `char` bullet. */
+        char?: string;
+        /** The numbering scheme of an `auto` bullet (`arabicPeriod`, `romanLcParenR`…). */
+        autoType?: string;
+        startAt?: number;
+        font?: FontJSON;
+        fontFollowsText?: boolean;
+        /** Serialized color. */
+        color?: string;
+        colorFollowsText?: boolean;
+        size?: SpacingJSON;
+        sizeFollowsText?: boolean;
+    }
+    interface TabJSON {
+        /** Position in pixels. */
+        position: number;
+        align?: ITextFrame.TabStopAlignment;
+    }
+    /** How a paragraph is laid out. Lengths are in pixels. */
+    interface ParagraphPropertiesJSON {
+        align?: ParagraphAlignment;
+        /** Outline level, `0` to `8`. */
+        level?: number;
+        marginLeft?: number;
+        marginRight?: number;
+        /** First-line indent; negative for a hanging indent. */
+        indent?: number;
+        defaultTabSize?: number;
+        rightToLeft?: boolean;
+        eastAsianLineBreak?: boolean;
+        latinLineBreak?: boolean;
+        hangingPunctuation?: boolean;
+        fontAlign?: FontAlignment;
+        lineSpacing?: SpacingJSON;
+        spaceBefore?: SpacingJSON;
+        spaceAfter?: SpacingJSON;
+        bullet?: BulletJSON;
+        tabs?: TabJSON[];
+        /** The run formatting the paragraph's runs inherit. */
+        defaultRun?: RunPropertiesJSON;
+    }
+    /** A paragraph: runs in order, and how it is laid out. */
+    interface ParagraphJSON extends ParagraphPropertiesJSON {
+        runs: RunJSON[];
+        /** The formatting of the paragraph mark (what a new run at its end takes). */
+        endRun?: RunPropertiesJSON;
+    }
 }
 //# sourceMappingURL=IText.d.ts.map

package/types/src/text/ITextFrame.d.ts

@@ -4,6 +4,7 @@ import { TextVisitor } from './TextVisitor';
 import { ITextLine } from './TextLine';
 import { ITextParagraph } from './TextParagraph';
 import { ITextBoxAlignment as _IAlignment } from './TextBoxAlignment';
+import { IText } from './IText';
 /**
  * Represents a rectangular container for text and its formatting within a document.
  *
@@ -323,8 +324,92 @@ export declare namespace ITextFrame {
          * Centers text at the tab stop.
          */
         readonly Center: "center";
+        /**
+         * Aligns numbers at the tab stop on their decimal point.
+         */
+        readonly Decimal: "decimal";
     };
     type TabStopAlignment = typeof TabStopAlignment[keyof typeof TabStopAlignment];
+    /**
+     * The direction drawing text runs in its body.
+     */
+    const WritingMode: {
+        readonly Horizontal: "horizontal";
+        /** Each line turned 90° clockwise, read top to bottom; lines advance leftwards. */
+        readonly Vertical: "vertical";
+        /** Each line turned 270° clockwise, read bottom to top; lines advance rightwards. */
+        readonly Vertical270: "vertical270";
+        /** WordArt vertical: upright letters stacked top to bottom. */
+        readonly WordArtVertical: "wordArtVertical";
+        /** East Asian vertical: upright ideographs, Latin text turned. */
+        readonly EastAsianVertical: "eastAsianVertical";
+        /** Mongolian vertical: top to bottom, lines advancing rightwards. */
+        readonly MongolianVertical: "mongolianVertical";
+        /** WordArt vertical read right to left. */
+        readonly WordArtVerticalRtl: "wordArtVerticalRtl";
+    };
+    type WritingMode = typeof WritingMode[keyof typeof WritingMode];
+    /** Text insets from the text rectangle, in pixels. */
+    interface InsetsJSON {
+        left?: number;
+        top?: number;
+        right?: number;
+        bottom?: number;
+    }
+    /** How a text body sits in the frame that holds it. */
+    interface BodyJSON {
+        /** Vertical anchor of the text in the frame. */
+        anchor?: VerticalAlignment;
+        /** Center the text box horizontally within the frame. */
+        anchorCenter?: boolean;
+        wrap?: 'none' | 'square';
+        insets?: InsetsJSON;
+        /** `shape` grows the frame to fit the text; `normal` shrinks the text to fit the frame. */
+        autoFit?: Autofit;
+        /** With `normal` autofit: the font scale applied, as a percentage. */
+        fontScale?: number;
+        /** With `normal` autofit: the line spacing reduction applied, as a percentage. */
+        lineSpacingReduction?: number;
+        vertical?: WritingMode;
+        /** What happens to text past the bottom: `visible`, `ellipsis` or `clip`. */
+        verticalOverflow?: Overflow;
+        /** What happens to text past the sides: `visible` or `clip`. */
+        horizontalOverflow?: Overflow;
+        upright?: boolean;
+        rightToLeftColumns?: boolean;
+        columns?: number;
+        /** Space between columns, in pixels. */
+        columnSpacing?: number;
+        fromWordArt?: boolean;
+        forceAntiAlias?: boolean;
+        compatibleLineSpacing?: boolean;
+        spaceFirstLastParagraph?: boolean;
+        /** A preset text warp (`prstTxWarp`) and its adjust values, in the preset grammar's units. */
+        warp?: {
+            preset: string;
+            adjustments?: Record<string, number>;
+        };
+        /** `bodyPr/extLst` as the file states it: an opaque DrawingML fragment, written back as it was. */
+        extLst?: string;
+    }
+    /** The paragraph formatting a text body's levels inherit (`lstStyle`). */
+    interface ListStyleJSON {
+        default?: IText.ParagraphPropertiesJSON;
+        /** Levels 1 to 9, by index; a level the file does not state is absent. */
+        levels?: (IText.ParagraphPropertiesJSON | undefined)[];
+    }
+    /**
+     * The text written in a frame — a shape's text body — as JSON: its paragraphs, how the body
+     * sits in the frame, and the list style the paragraphs inherit from.
+     */
+    interface JSON {
+        paragraphs: IText.ParagraphJSON[];
+        /** Text rotation in degrees, when the body states one. */
+        rotation?: number;
+        /** How the body sits in the frame; absent for the defaults. */
+        body?: BodyJSON;
+        listStyle?: ListStyleJSON;
+    }
     interface CloneableTextFrame extends ITextFrame {
         clone(visitor?: TextVisitor): ITextFrame;
         equals(other: ITextFrame): boolean;

package/types/src/text/TextRotation.d.ts

@@ -26,7 +26,7 @@ import { ITextFrame } from './ITextFrame';
 export interface Line {
     /**
      * Where the strip's un-rotated top-left sits (content-box coordinate space). The strip is the
-     * line's box (`size`) rotated by the layout {@link Layout.angle angle} **about this point**.
+     * line's box (`size`) rotated by the layout {@link RotatedLayout.angle angle} **about this point**.
      */
     origin: Point;
     /** The un-rotated strip box: the line's text width × line height. */
@@ -37,7 +37,7 @@ export interface Line {
 /**
  * The placed geometry for all lines — see {@link layoutLines}.
  */
-export interface Layout {
+export interface RotatedLayout {
     /** The rotation, CSS degrees clockwise, normalized to [0, 360). Never 0 or 180 (callers skip). */
     angle: number;
     /**
@@ -102,5 +102,5 @@ export declare function getAdvance(lineHeight: number, deg: number): number;
  * The footprint may exceed the content box in either axis — rotated text overflows; clipping is a
  * consumer decision.
  */
-export declare function layoutLines(lineSizes: readonly Size[], deg: number, content: Bounds, horizontal: ITextFrame.HorizontalAlignment, vertical: ITextFrame.VerticalAlignment): Layout;
+export declare function layoutLines(lineSizes: readonly Size[], deg: number, content: Bounds, horizontal: ITextFrame.HorizontalAlignment, vertical: ITextFrame.VerticalAlignment): RotatedLayout;
 //# sourceMappingURL=TextRotation.d.ts.map

package/types/src/text/TextStacked.d.ts

@@ -36,7 +36,7 @@ export interface Column {
 /**
  * The placed geometry for all columns — see {@link layoutColumns}.
  */
-export interface Layout {
+export interface StackedLayout {
     /** The slot pitch: the font's line height. Also the column width. */
     pitch: number;
     /** One entry per column, in reading order (left → right). */
@@ -79,5 +79,5 @@ export declare function slotCount(columns: readonly (readonly string[])[]): numb
  * @param vertical The vertical alignment, applied to EACH column: Top/Justify hug the top edge,
  *  Center/Distributed center, Bottom (the default) hugs the bottom.
  */
-export declare function layoutColumns(columns: readonly (readonly string[])[], pitch: number, content: Bounds, horizontal: ITextFrame.HorizontalAlignment, vertical: ITextFrame.VerticalAlignment): Layout;
+export declare function layoutColumns(columns: readonly (readonly string[])[], pitch: number, content: Bounds, horizontal: ITextFrame.HorizontalAlignment, vertical: ITextFrame.VerticalAlignment): StackedLayout;
 //# sourceMappingURL=TextStacked.d.ts.map

package/types/src/theme/ITheme.d.ts

@@ -1,4 +1,5 @@
 import { IColor } from '../color';
+import { IFont } from '../font';
 import { IFill, IStroke, IEffect } from '../fill';
 import { buildPalette as _buildPalette } from './_ThemeUtils';
 /**
@@ -210,6 +211,29 @@ export declare namespace ITheme {
     }
     interface FontSchemeJSON extends Partial<FontSchemeProperties> {
     }
+    /**
+     * One reference into a theme style list (`fillRef`, `lnRef`, `effectRef`): the one-based position
+     * in the list, `0` for none, and the color the list entry's placeholder (`phClr`) takes.
+     */
+    interface StyleRefJSON {
+        index: number;
+        color?: string;
+    }
+    /** The font a theme style refers to: the theme's `major` or `minor` font, or `none`, and the text color. */
+    interface FontRefJSON {
+        index: IFont.Scheme;
+        color?: string;
+    }
+    /**
+     * References into the theme's format scheme — what a shape or chart draws with wherever it
+     * states nothing of its own: DrawingML's `style` element.
+     */
+    interface StyleRefsJSON {
+        fill?: StyleRefJSON;
+        stroke?: StyleRefJSON;
+        effect?: StyleRefJSON;
+        font?: FontRefJSON;
+    }
     interface JSON {
         name: string;
         fonts?: ITheme.FontSchemeJSON;

package/types/src/workbook/Workbook.d.ts

@@ -99,8 +99,6 @@ export declare class Workbook implements IWorkbook {
     protected _activeSheetOffset: number;
     protected _sheets: ISheetCollection;
     protected _sheetOnNameChange: Map<number, () => void>;
-    /** `true` while a revert or a restore announces the sheet list it landed on. */
-    protected _restoringSheets: boolean;
     protected _sheetOnVisibilityChange: Map<number, () => void>;
     protected _sheetOnIndexChange: Map<number, () => void>;
     protected _protection: WorkbookProtection;
@@ -214,9 +212,18 @@ export declare class Workbook implements IWorkbook {
     /** @internal */
     protected _nextSheetName(sheetName?: string | null | undefined): string;
     /** @internal */
-    protected _addSheet(notify: boolean, sheetName?: string | null, index?: number | null): ISheet;
+    protected _addSheet(notify: boolean, sheetName?: string | null, index?: number | null, uid?: string): ISheet;
     /** @internal */
     protected _updateSheetRefStates(sheetRefs: SheetRef[]): void;
+    /**
+     * Tells the calculation the sheet list as it is: every sheet, hidden ones included, in tab
+     * order. Called where an operation on the list completes - beside its `onSheetsChange`, or in
+     * `_updateSheetRef` for a ref replaced - and, for a sheet being added, once its ref is in, before
+     * its grid seeds. Never on a restore: the calculation's copy is restored with this one. A load
+     * tells the whole list before its first sheet, so a part of it is not told while the load builds
+     * them.
+     */
+    protected _tellSheets(): void;
     /** @internal */
     protected _addSheetRef(sheetRefAdd: SheetRef, index?: number | null): SheetRef;
     /**
@@ -334,7 +341,7 @@ export declare class Workbook implements IWorkbook {
     /** @internal */
     protected _sheetToWBEvent(listenerWB: ICellRange.Listener): ICellRange.Listener;
     /** @internal */
-    protected _fromJSON(json: IWorkbook.JSON): void;
+    protected _fromJSON(json: IWorkbook.JSON, uids?: readonly string[]): void;
     /** @internal */
     protected _createScripts(json?: Record<string, IModule.JSON>): IScript;
     /** {@inheritDoc IWorkbook.toJSON} */
@@ -432,7 +439,11 @@ interface InternalCreateSheet {
     /**
      * The JSON representation of the sheet.
      */
-    json: ISheet.JSON | null | undefined): ISheet;
+    json: ISheet.JSON | null | undefined, 
+    /**
+     * The sheet's id ({@link ISheet.getId}), when the workbook named it before building it.
+     */
+    uid?: string): ISheet;
 }
 export {};
 //# sourceMappingURL=Workbook.d.ts.map

package/browser/cjs/CrcmEew-dr51xpf9.cjs

@@ -1 +0,0 @@
-const e=require("./D3Vlh9UOBKtvlXBL.cjs");let t=require("@sheetxl/primitives"),n=require("@sheetxl/utils");function r(t,n,r,i){if(!t||!n)return;let a=t.bind(e.ct.Table,``,{at:{scope:n,rowIndex:r,colIndex:i}});return a?t.resolve(e.ct.Table,a)?.toString():void 0}var i=/[A-Za-z_\\\u007F-\uFFFF][A-Za-z0-9_.\u007F-\uFFFF]*$/,a=/[A-Za-z0-9_.)\]}"'!#\u007F-\uFFFF]/;function o(e,t){for(let n=t+1;n<e.length;n++){let t=e[n];if(t!==`'`){if(t===`]`)return n+1;if(t===`[`)return null}else n++}return-1}function s(t,n,r,s){let c=0,l=-1;for(let e=0;e<n.length;e++){let t=n[e];c>0&&t===`'`?e++:t===`[`?(c===0&&(l=e),c++):t===`]`&&c>0&&c--}if(c===0)return!1;let u=n.slice(0,l);if((u.split(`"`).length-1)%2==1)return!1;let d=t.length>0?t[t.length-1]:void 0,f=``,p=!1,m=i.exec(u);if(m){let e=m.index>0?u[m.index-1]:d?.text?.at(-1)??``;if(/[A-Za-z0-9_.]/.test(e))return!1;f=m[0],u=u.slice(0,m.index)}else u.length===0&&d?.text&&i.exec(d.text)?.index===0&&(d.type===e._t.Named&&!d.value?.scope||d.type===e._t.TableReference)&&(f=d.text,p=!0);if(!p){let e=u.length>0?u[u.length-1]:d?.text?.at(-1)??``;if(e&&a.test(e))return!1}let h=f||(s?.()??``),g=[],_=(e,t,n)=>{g.push({type:e,value:t,text:t,context:{name:h,argIndex:n,type:`table`}})},v=(t,n,r,i)=>{let a=t.startsWith(`#`),o=r?i?`column`:a?`specifier`:t?`column`:`any`:void 0,s=o?{table:h,name:t,partial:o}:{table:h,name:t};g.push({type:a?e._t.TableSpecifier:e._t.TableColumn,value:s,text:t,context:{name:h,argIndex:n,type:`table`}})},y=(t,n,r,i)=>{_(e._t.Paren,`[`,r),v(t.slice(1,n?-1:void 0),r,!n,i),n&&_(e._t.Paren,`]`,r)};_(e._t.Paren,`[`,-1);let b=n.slice(l+1);if(b.startsWith(`[`)){let t=0,n=!1,r=0;for(;r<b.length;){let i=b[r];if(i===`[`){let e=o(b,r);if(e===null)return!1;let i=e!==-1;if(y(b.slice(r,i?e:b.length),i,t,n),n=!1,!i)break;r=e}else if(i===`,`)_(e._t.Separator,`,`,t++),r++;else if(i===`:`)_(e._t.Infix,`:`,t),r++;else if(i===`@`)_(e._t.Prefix,`@`,t),n=!0,r++;else{if(i!==` `)return!1;{let n=r;for(;b[n]===` `;)n++;_(e._t.Whitespace,b.slice(r,n),t),r=n}}}}else{let t=b,n=t.startsWith(`@`);if(n&&(_(e._t.Prefix,`@`,0),t=t.slice(1)),t.startsWith(`[`)){if(o(t,0)!==-1)return!1;y(t,!1,0,n)}else{if(/(^|[^'])[[\]]/.test(t)||t.startsWith(`#`)&&t.includes(`,`))return!1;v(t,0,!0,n)}}if(u){let n={type:e._t.Unparsed,value:u,text:u};r&&(n.context=r),t.push(n)}if(p){let n={...d,type:e._t.TableReference,value:f,text:f};delete n.referenceIndex,t[t.length-1]=n}else if(f){let n={type:e._t.TableReference,value:f,text:f};r&&(n.context=r),t.push(n)}for(let e of g)t.push(e);return!0}exports.FormulaCompiler=class{constructor(t){t={...t},this._editing=t.profile===`editing`,this._parser=new e.dt(t)}compile(n,i,a,o,s,c,l,u,d){if(o.length===0){let r=new t.FormulaError.Parse(e.lt);return this._compileUnparsed(n,s,o,{input:o,cause:r,causes:[r]})}if(o.length>e.vt.MAX_EXPRESSION_LENGTH){let r=new t.FormulaError.Parse(e.ut(o.length,e.vt.MAX_EXPRESSION_LENGTH));return this._compileUnparsed(n,s,o,{input:o,cause:r,causes:[r]})}let f,p,m=[];try{let e=this._parser.parse(i,a,o);f=e.root,m=e.errors,u&&f&&m.length===0&&(f.legacyIntersect=!0)}catch(e){p=t.FormulaError.isError(e,t.FormulaError.Code.Parse)?e:new t.FormulaError.Parse(e.message,e)}let h=[];for(let t of m)h.push(e.X(t));if(f){let n=e.Q(f,c??null);typeof n==`string`?h.push(new t.FormulaError.Parse(n)):f=n,e.q(f,c??null)&&h.push(new t.FormulaError.Parse(`The implicit intersection operator ' ' requires a cell or range on both sides`)),e.K(f,c??null)&&h.push(new t.FormulaError.Parse(`The spill anchor operator '#' requires a cell or range`)),e.Y(f,c??null)&&h.push(new t.FormulaError.Parse(`Expected a reference; a value cannot be converted to one.`));let r=e.H(f,c??null);r&&h.push(new t.FormulaError.Parse(r));let i=e.U(f,c??null);i&&h.push(new t.FormulaError.Parse(i));let a=e.W(f,c??null);a&&h.push(new t.FormulaError.Parse(a));let o=e.G(f);o&&h.push(new t.FormulaError.Parse(o))}h.length>0&&!p&&(p=h[0]);let g=null;if(p&&(g={input:o,cause:p,causes:h.length>0?h:[p]}),!f){if(this._editing){let e=this._recoverCompiled(n,i,a,o,s,g,l);if(e)return e}return this._compileUnparsed(n,s,o,g,this._editing,()=>r(s,l,i,a))}if(f=e.$(f,c??null),f=e.B(f,c??null),s){let n=this._editing?d:{mint:!d?.book,...d};f=e.Z(f,s,l,n,{rowIndex:i,colIndex:a});let r=e.J(f,s);if(r){let e=new t.FormulaError.Parse(r);h.push(e),g={input:o,cause:g?.cause??e,causes:g?[...g.causes,e]:[e]}}}let _=e.V(n,s,f,this._editing,g,c??null);return this._editing&&g&&e.et(_.getTokens(),s)!==o?this._recoverCompiled(n,i,a,o,s,g,l)||this._compileUnparsed(n,s,o,g,!0):_}autoCorrect(e){let t=function(e){let t=0,n=null;for(let r=0;r<e.length;r++){let i=e[r];n?i===n&&(n=null):t>0?i===`'`?r++:i===`[`?t++:i===`]`&&t--:i===`"`||i===`'`?n=i:i===`[`&&t++}return n?0:t}(e),n=e+`]`.repeat(t),r;try{let e=this._parser.getLexer().tokenize(n,!1);if(e.errors.length>0)return null;r=e.tokens}catch{return null}let i=[];for(let e of r){let t=e.tokenType?.name;if(t===`OpenParen`)i.push(`)`);else if(t===`OpenCurlyParen`)i.push(`}`);else if((t===`CloseParen`||t===`CloseCurlyParen`)&&i.pop()!==(t===`CloseParen`?`)`:`}`))return null}return i.length===0&&t===0?null:n+i.reverse().join(``)}_compileUnparsed(t,r,i,a,o=!1,c){let l={runtime:t,symbols:r,getFunction:null,ast:null,evaluations:n.CommonUtils.EmptyArray,executions:n.CommonUtils.EmptyArray,bindings:n.CommonUtils.EmptyArray,referencesAbsolute:n.CommonUtils.EmptyArray,referencesExecute:n.CommonUtils.EmptyArray,referencesRelative:n.CommonUtils.EmptyArray,referencesRoot:n.CommonUtils.EmptyArray,referenceIndices:n.CommonUtils.EmptyArray,formatReferenceIndices:n.CommonUtils.EmptyArray,getTokens:()=>{let t=[];return o&&s(t,i,void 0,c)?t:[{type:e._t.Unparsed,value:i,text:i}]},namedIds:n.CommonUtils.EmptyArray,symbolIds:n.CommonUtils.EmptyArray,hasTotals:!1,hasVolatile:!1,isBlankCacheable:!1,isBlankCacheableArray:!1,isReferenceOnly:!1,error:a,transform:()=>l};return l}_recoverCompiled(t,n,i,a,o,s,c){let l,u=a.length;try{let e=this._parser.getLexer().tokenize(a,!1);l=e.tokens,e.errors.length>0&&(u=Math.min(u,e.errors[0].offset))}catch{return null}let d=[];for(let e=l.length-1;e>=0&&d.length<24;e--){let t=(l[e].endOffset??-1)+1;t>0&&t<a.length&&t<=u&&d.push(t)}for(let l of d){let u=a.slice(0,l),d,f;try{d=this._parser.parse(n,i,u).root}catch{continue}if(!d||d.type===e._t.Unparsed)continue;try{let r=e.B(d,null),a=o?e.Z(r,o,c,void 0,{rowIndex:n,colIndex:i}):r;f=e.V(t,o,a,!0,s)}catch{continue}if(e.et(f.getTokens(),o)!==u)continue;let p=a.slice(l);if(p.length===0)return f;let m,h={...f,getTokens:()=>(m||(m=[...f.getTokens()],this._appendUnparsedTail(m,p,()=>r(o,c,n,i))),m),transform:()=>h};return h}return null}_appendUnparsedTail(t,n,r){let i=[];for(let n of t){if(n.type===e._t.Whitespace)continue;let t=n.type===e._t.Paren||n.type===e._t.Type?n.text:void 0,r=i.length>0?i[i.length-1]:void 0;if(n.type===e._t.Separator&&r){let e=r.declared[r.declared.length-1];r.ctx?.type===`let`&&r.ctx.argIndex===-1&&r.lambda?.argTokens===r.argTokens&&e?.argIndex===r.argIndex-1&&(e.params=r.lambda.params),r.argIndex++,r.argTokens=0,r.lambda=void 0;continue}if(r&&r.argTokens++,t===`(`||t===`[`||t===`{`)i.push({ctx:n.context,argIndex:0,declared:[],argTokens:0,leadsArg:r?.argTokens===2});else if(t===`)`||t===`]`||t===`}`){let e=i.pop(),t=i.length>0?i[i.length-1]:void 0;t&&e?.leadsArg&&e.ctx?.type===`lambda`&&e.ctx.argIndex===-1&&(t.lambda={params:e.declared.map(({name:e,optional:t})=>t?{name:e,optional:t}:{name:e}),argTokens:t.argTokens})}else if(n.type===e._t.Parameter&&r&&n.value?.declaration){let e=n.value;r.declared.push(e.optional?{name:e.name,argIndex:r.argIndex,optional:!0}:{name:e.name,argIndex:r.argIndex})}}let a=i.length>0?i[i.length-1]:void 0,o=a?.ctx?{...a.ctx,argIndex:a.ctx.argIndex===-1?a.argIndex:a.ctx.argIndex}:void 0;if(o&&a.ctx.argIndex===-1&&(o.type===`let`||o.type===`lambda`)){let t=o.type===`let`?2:1,n=o.bound;for(let r of a.declared){if(o.argIndex<r.argIndex+t)continue;let{name:i,params:a}=r;n=e.z(n,a?{name:i,params:a}:{name:i})}n&&(o.bound=n)}let c=(n,r)=>{let i=r?{type:e._t.Named,value:{name:n},text:n}:{type:e._t.Unparsed,value:n,text:n};o&&(i.context=o),t.push(i)};if(s(t,n,o,r))return;let l=/[A-Za-z_][A-Za-z0-9_]*$/.exec(n),u=l?l.index:-1,d=u>0?n[u-1]:``;for(let e=t.length-1;u===0&&e>=0&&!d;e--)d=t[e].text?.at(-1)??``;u>=0&&!/[A-Za-z0-9_.]/.test(d)?(u>0&&c(n.slice(0,u)),c(n.slice(u),!0)):c(n)}},exports.appendPartialStructuredReference=s;

package/browser/cjs/CwzIjMpnMKeypivl.cjs

@@ -1 +0,0 @@
-const e=require("./D3Vlh9UOBKtvlXBL.cjs");exports.initializeFunctions=e.R;