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

package/types/src/style/ICellStyle.d.ts

@@ -3,9 +3,9 @@ import { IProperties } from '../type';
 import { ITransaction } from '../transaction';
 import { ICellRange } from '../cellRange';
 import { IColor } from '../color';
-import { IFill } from '../fill';
-import { ITextFrame, IStyledFont } from '../text';
-import { IFont } from '../font';
+import { IFill, IFillable } from '../fill';
+import { ITextFrame } from '../text';
+import { IFont, IFontStyle } from '../font';
 import { IBorders } from '../border';
 import { ICellProtection } from '../cell';
 import { NumberFormat } from '../numFmt';
@@ -13,7 +13,7 @@ import { NumberFormat } from '../numFmt';
  * The `ICellStyle` interface combines user-applied styles with dynamic styles, such as those from tables or conditional
  * formatting, to deliver the current appearance.
  */
-export interface ICellStyle {
+export interface ICellStyle extends IFillable<ICellStyle, IFill.ISolid | IFill.IGradient | IFill.IPattern | IFill.INone, ICellStyle.UpdateOptions> {
     /**
      * Format used for Number formatting:
      * * {@link https://docs.microsoft.com/en-us/dotnet/api/documentformat.openxml.spreadsheet.numberingformats?view=openxml-2.8.1}
@@ -64,63 +64,62 @@ export interface ICellStyle {
      */
     setBorders(borders: IBorders.Update, options?: ICellStyle.UpdateOptions): ICellStyle;
     /**
-     * Fill properties for the background.
+     * Returns the alignment for the style.
      */
-    getFill(): IFill.ISolid | IFill.IGradient | IFill.IPattern | IFill.INone;
+    getAlignment(): ITextFrame.IAlignment;
     /**
-     * Sets the fill style.
+     * Sets the alignment style.
      *
-     * This method allows updating fill using an {@link IFill} or a shorthand property object.
+     * This method allows updating alignments using an {@link ITextFrame.IAlignment.Update} or a shorthand property object.
      *
-     * @param fill The fill object or a shorthand property object to apply. Pass `null` to clear.
+     * @param alignment The alignment object or a shorthand property object to apply. Pass `null` to clear.
      * @param options Optional configuration for the update.
-     * @returns The `IFill` object for further modifications.
-     */
-    setFill(fill: IFill.Update, options?: ICellStyle.UpdateOptions): ICellStyle;
-    /**
-     * Sets the fill style to a solid fill.
-     */
-    setFillSolid(options?: ICellStyle.UpdateOptions): IFill.ISolid;
-    /**
-     * Sets the fill style to a gradient fill.
+     * @returns The `ITextFrame.IAlignment` object for further modifications.
      */
-    setFillGradient(options?: ICellStyle.UpdateOptions): IFill.IGradient;
+    setAlignment(alignment: ITextFrame.IAlignment.Update, options?: ICellStyle.UpdateOptions): ICellStyle;
     /**
-     * Sets the fill style to a pattern fill.
+     * Exists to have api parity with Office Scripts. Returns the SheetXL value (`'center'`), not
+     * Office Scripts' capitalized name, so what is read can be passed straight back to a setter.
+     *
+     * @deprecated Use {@link getAlignment}`().getHorizontal()`.
+     * @hidden
      */
-    setFillPattern(options?: ICellStyle.UpdateOptions): IFill.IPattern;
+    getHorizontalAlignment(): ITextFrame.HorizontalAlignment;
     /**
-     * Sets the fill style to no fill.
+     * Exists to have api parity with Office Scripts. Returns the SheetXL value (`'top'`), not
+     * Office Scripts' capitalized name, so what is read can be passed straight back to a setter.
+     *
+     * @deprecated Use {@link getAlignment}`().getVertical()`.
+     * @hidden
      */
-    setFillNone(options?: ICellStyle.UpdateOptions): IFill.INone;
+    getVerticalAlignment(): ITextFrame.VerticalAlignment;
     /**
-     * Returns the alignment for the style.
+     * Exists to have api parity with Office Scripts, whose capitalized names (`'Center'`) are accepted.
+     *
+     * @deprecated Use {@link setAlignment}`({ horizontal: 'center' })`.
+     * @hidden
      */
-    getAlignment(): ITextFrame.IAlignment;
+    setHorizontalAlignment(horizontal: ITextFrame.HorizontalAlignment | string): ICellStyle;
     /**
-     * Sets the alignment style.
-     *
-     * This method allows updating alignments using an {@link ITextFrame.IAlignment.Update} or a shorthand property object.
+     * Exists to have api parity with Office Scripts, whose capitalized names (`'Top'`) are accepted.
      *
-     * @param alignment The alignment object or a shorthand property object to apply. Pass `null` to clear.
-     * @param options Optional configuration for the update.
-     * @returns The `ITextFrame.IAlignment` object for further modifications.
+     * @deprecated Use {@link setAlignment}`({ vertical: 'top' })`.
+     * @hidden
      */
-    setAlignment(alignment: ITextFrame.IAlignment.Update, options?: ICellStyle.UpdateOptions): ICellStyle;
+    setVerticalAlignment(vertical: ITextFrame.VerticalAlignment | string): ICellStyle;
     /**
      * Returns the font for the style.
      */
-    getFont(): IStyledFont;
+    getFont(): IFontStyle;
     /**
-     * Sets the font style.
-     *
-     * This method allows updating fill using an {@link IStyledFont} or a shorthand property object.
+     * Sets the font.
      *
-     * @param font The font object or a shorthand property object to apply. Pass `null` to clear.
+     * @param font Another text style, its properties, or a CSS font shorthand (`'bold 12pt Arial'`).
+     * Pass `null` to clear.
      * @param options Optional configuration for the update.
-     * @returns The `IStyledFont` object for further modifications.
+     * @returns The updated style.
      */
-    setFont(font: IStyledFont.Update, options?: ICellStyle.UpdateOptions): ICellStyle;
+    setFont(font: IFontStyle | IFontStyle.Update | string | null, options?: ICellStyle.UpdateOptions): ICellStyle;
     /**
      * Returns an instance of the named style that this is derived from.
      */
@@ -166,8 +165,9 @@ export interface ICellStyle {
      */
     getBestFit(): Partial<Size> | null;
     /**
-     * Returns insets used for content. This does not taking into account indent because
-     * this is alignment and type specific.
+     * Returns the insets content is laid out inside: Excel's, a quarter of the font's widest digit
+     * a side (2 px at Calibri 11) and 1 px above and below. Indent is not included because it
+     * depends on the alignment and the value's type.
      */
     getInsets(): Rectangle;
     /**
@@ -212,7 +212,7 @@ export declare namespace ICellStyle {
          * @see
          * {@link ICellStyle.getFont}
          */
-        font?: IStyledFont.Properties<C>;
+        font?: IFontStyle.Properties<C>;
         /**
          * Fill properties.
          *
@@ -271,13 +271,13 @@ export declare namespace ICellStyle {
      * Enable properties to be set using string shorthands.
      *
      * @remarks
-     * The `font` slot is widened to {@link IStyledFont.Modifiers} rather than derived from
+     * The `font` slot is widened to {@link IFontStyle.Update} rather than derived from
      * {@link ICellStyle.Properties}, so that the font aliases (`bold`, `italic`) are accepted here but
      * cannot reach the stored/serialized properties.
      */
     type Modifiers = Omit<IProperties.ResolvableProperties<ICellStyle.Properties>, 'font'> & {
         /** {@inheritDoc ICellStyle.Properties.font} */
-        font?: IProperties.ResolvableProperties<IStyledFont.Modifiers> | string | null;
+        font?: IProperties.ResolvableProperties<IFontStyle.Update> | string | null;
     };
     interface ModifierCallback {
         (original: ICellStyle): ICellStyle.Modifiers;
@@ -347,6 +347,13 @@ export declare namespace ICellStyle {
          * if the style is custom.
          */
         getBuiltInID(): number | null;
+        /**
+         * Whether this built-in style's definition has been changed from the predefined one.
+         *
+         * @remarks
+         * Always `false` for a style that is not built in.
+         */
+        isCustomized(): boolean;
         /**
          * Deletes the style.
          *
@@ -385,6 +392,11 @@ export declare namespace ICellStyle {
          * {@link INamed.getILevel}
          */
         iLevel?: number | null;
+        /**
+         * @see
+         * {@link INamed.isCustomized}
+         */
+        customized?: boolean;
         /**
          * The cell style properties.
          */

package/types/src/style/_BuiltInStyleDefs.d.ts

@@ -1,11 +1,12 @@
-import { ITextFrame, IStyledFont } from '../text';
+import { IFontStyle } from '../font';
+import { ITextFrame } from '../text';
 import { IBorders } from '../border';
-import { ICellStyle } from './ICellStyle';
 import { ICellProtection } from '../cell';
+import { ICellStyle } from './ICellStyle';
 /**
  * To avoid duplicating values.
  */
-export declare const _EmptyFontProperties: IStyledFont.Properties;
+export declare const _EmptyFontProperties: IFontStyle.Properties;
 export declare const _EmptyBorderStrokeProperties: IBorders.StrokeProperties;
 export declare const _EmptyBorderProperties: IBorders.Properties;
 export declare const _EmptyAlignmentProperties: ITextFrame.IAlignment.Properties;

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

@@ -7,7 +7,7 @@ import { ICellRange } from '../cellRange';
 import { ICellStyle, IStyleCollection } from '../style';
 import { IAnchored } from '../anchored';
 import { INamedCollection, INamed } from '../named';
-import { ISheet } from '../sheet';
+import { IWorksheet } from '../sheet';
 import { ISort } from '../sort';
 import { ICondition } from '../condition';
 import { IFilter } from '../filter';
@@ -22,7 +22,7 @@ import * as _Utils from './_TableUtils';
  * Implementation of {@link ITable}.
  */
 export declare class AnchoredTable extends AbstractAnchored<State, ITable.Events> implements ITable {
-    protected _sheet: ISheet | undefined;
+    protected _sheet: IWorksheet | undefined;
     private _styles;
     private _stylesRemoveListener;
     private _columnListener;
@@ -42,6 +42,7 @@ export declare class AnchoredTable extends AbstractAnchored<State, ITable.Events
     private _setContainerName;
     private _releaseReferences;
     private _refitBodyRows;
+    private _fillCalculated;
     private _names;
     private _namedItem;
     private _colHeadersSizeUnlistener;
@@ -368,7 +369,7 @@ export declare class AnchoredTable extends AbstractAnchored<State, ITable.Events
     resizeTo(rowCount: number, colCount: number, options?: ITransaction.OperationOptions): ICellRange;
     /** {@inheritDoc ITable.resize} */
     resize(address: ICellRange.Address, options?: ITransaction.OperationOptions): ICellRange;
-    protected _resize(address: ICellRange.Address, options?: ITransaction.OperationOptions, description?: string): ICellRange;
+    protected _resize(address: ICellRange.Address, options?: ITransaction.OperationOptions, description?: string, skipProtection?: boolean): ICellRange;
     /** {@inheritDoc ITable.getName} */
     getName(): string;
     /** {@inheritDoc ITable.setName} */
@@ -640,6 +641,10 @@ export declare class AnchoredTable extends AbstractAnchored<State, ITable.Events
     setHiddenButtons(hidden: boolean): this;
     /** {@inheritDoc ITable.isHiddenButtons} */
     isHiddenButtons(): boolean;
+    /** {@inheritDoc ITable.setHiddenDecorations} */
+    setHiddenDecorations(hidden: boolean): this;
+    /** {@inheritDoc ITable.isHiddenDecorations} */
+    isHiddenDecorations(): boolean;
     /**
      * The read-only half of a filter: the runs `conditions` settle over the header and body rows.
      * `null` for a table with no sheet (a preview), which has no rows to hide.
@@ -660,6 +665,8 @@ export declare class AnchoredTable extends AbstractAnchored<State, ITable.Events
      * @internal
      */
     _carryFilters(conditions: ICondition.Input[]): void;
+    /** A sort made here covers the table body, so the file's sort ranges no longer describe it. */
+    private _clearSortExtent;
     /** @internal */
     private _applySorts;
     /** {@inheritDoc ITable.getColumnAt} */
@@ -859,8 +866,8 @@ export declare class AnchoredTable extends AbstractAnchored<State, ITable.Events
     toString(): string;
     /** {@inheritDoc ITable.toJSON} */
     toJSON(): ITable.JSON | null;
-    /** {@inheritDoc ITable.getSheet} */
-    getSheet(): ISheet | null;
+    /** {@inheritDoc ITable.getWorksheet} */
+    getWorksheet(): IWorksheet | null;
     /** @internal */
     private _createNamed;
     private _fromJSON;
@@ -903,7 +910,7 @@ export declare namespace AnchoredTable {
         /**
          * The sheet the table is anchored to.
          */
-        sheet?: ISheet;
+        sheet?: IWorksheet;
         /**
          * Required if there is no sheet. For example when showing table Preview.
          */
@@ -933,7 +940,7 @@ export declare namespace AnchoredTable {
         symbolsChanged?: (table: ITable) => void;
         /**
          * Called, inside the operation, when the table starts or stops holding a filter condition
-         * (see {@link ISheet.getFilteredRanges}). A change of condition that leaves one held is not
+         * (see {@link IWorksheet.getFilteredRanges}). A change of condition that leaves one held is not
          * a change here.
          */
         filteredChanged?: (table: ITable) => void;
@@ -965,6 +972,12 @@ export declare namespace AnchoredTable {
             rowStart: number;
             rowEnd: number;
         }, afterShift: boolean, isCurrent: () => boolean) => void;
+        /**
+         * Writes a calculated column's formula into body rows the table has just taken in. Those rows
+         * came from an operation that has ruled on the sheet's protection, so a locked cell among them
+         * does not refuse it.
+         */
+        fillCalculated?: (coords: IRange.Coords, formulaText: string) => void;
     }
 }
 interface State extends AbstractAnchored.State {
@@ -988,7 +1001,10 @@ interface State extends AbstractAnchored.State {
     orderedColumnsProps: readonly ColumnPropertiesState[];
     hiddenButtons: boolean;
     mapHiddenButtons: Map<number, boolean>;
+    hiddenDecorations?: boolean;
     lastColId: number;
+    /** The file's sort ranges; see {@link ISort.JSON.extent}. Cleared by any sort made here. */
+    sortExtent?: ISort.SortExtent | null;
 }
 export {};
 //# sourceMappingURL=AnchoredTable.d.ts.map

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

@@ -11,7 +11,7 @@ import { AnchoredTable } from './AnchoredTable';
  * A special ITable that is created just for filter and sorting.
  *
  * It is used by:
- * - `ISheet.addAutoTable()` "AutoTable" (Excel AutoFilter region).
+ * - `IWorksheet.addAutoTable()` "AutoTable" (Excel AutoFilter region).
  * - ITable (named tables with column metadata, styles, etc).
  *
  * A sheet-level AutoTable is similar to ITable but does not have:

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

@@ -5,7 +5,7 @@ import { IProperties } from '../type';
 import { IListener } from '../listener';
 import { IHistory } from '../history';
 import { ICellRange } from '../cellRange';
-import { ISheet } from '../sheet';
+import { IWorksheet } from '../sheet';
 import { INamed } from '../named';
 import { ICondition } from '../condition';
 import { ISort } from '../sort';
@@ -280,13 +280,7 @@ export declare namespace ITable {
          */
         columns?: (string | ITable.ColumnProperties)[];
         /**
-         * A string representing the name of the table. This is the name that shall be used in formula references,
-         * and displayed in the UI to the spreadsheet user.
-         * This name shall not have any spaces in it, and it must be unique amongst all other displayNames and
-         * definedNames in the names. The character lengths and restrictions are the same as for definedNames.
-         *
-         * @see
-         * See SpreadsheetML Reference - Workbook definedNames section for details.
+         * Free text describing the table, such as what it holds. Not used in formulas.
          */
         description?: string;
         /**
@@ -370,7 +364,7 @@ export declare namespace ITable {
          * place, so its name and the references to it stay as they are; anywhere else it is removed
          * and added again under its name.
          */
-        copyTo(destination: ITable.SnapshotDestination, options?: ReferenceableClipboard.CopyOptions): Promise<IRange.Coords>;
+        copyTo(destination: ITable.SnapshotDestination, options?: ReferenceableClipboard.CopyOptions): IRange.Coords;
     }
     /**
      * A JSON representation useful for persistence.
@@ -388,6 +382,10 @@ export declare namespace ITable {
          * The button may be hidden for other reasons like there is no filter.
          */
         hiddenButtons?: boolean | number[];
+        /**
+         * If the grid's controls around the table are hidden. See {@link ITable.setHiddenDecorations}.
+         */
+        hiddenDecorations?: boolean;
         /**
          * **OOXML** - Not sure what it is used for.
          */
@@ -463,8 +461,8 @@ export interface ITable extends IAnchored {
     /**
      * Add a single row to the table.
      *
-     * @param index The body row the new row goes in before, `0` being the first. Omitted, the row
-     * is added at the end.
+     * @param index The body row the new row goes in before, `0` being the first. Omitted or `-1`,
+     * the row is added at the end.
      *
      * @remarks
      * This is a convenience method for {@link addRows(index, 1)}
@@ -473,8 +471,8 @@ export interface ITable extends IAnchored {
     /**
      * Add a number of rows to a table.
      *
-     * @param index The body row the new rows go in before, `0` being the first. An index at or past
-     * the number of body rows adds them at the end, above the totals row if there is one.
+     * @param index The body row the new rows go in before, `0` being the first. `-1`, or an index at
+     * or past the number of body rows, adds them at the end, above the totals row if there is one.
      * @param count The number of rows to add. Defaults to `1`.
      *
      * @remarks
@@ -489,13 +487,14 @@ export interface ITable extends IAnchored {
      */
     addRows(index: number, count?: number, options?: ITransaction.OperationOptions): ITable;
     /**
-     * Delete the rows from the table.
+     * Delete rows from the table's body.
      *
-     * @remarks
-     * Not implemented
+     * @param index The first body row to delete, `0` being the first.
+     * @param count The number of rows to delete. Defaults to `1`.
      *
-     * @param index The index to clear from
-     * @param count
+     * @remarks
+     * The rows are deleted across the table's columns only: cells below the table move up, and cells
+     * beside it stay where they are.
      */
     deleteRowsAt(index: number, count?: number, options?: ITransaction.OperationOptions): ITable;
     /**
@@ -909,6 +908,20 @@ export interface ITable extends IAnchored {
      * This will only return `true` if all buttons are hidden.
      */
     isHiddenButtons(): boolean;
+    /**
+     * If `hidden` is `true`, the grid shows none of its controls around the table: the handle at its
+     * bottom-right corner that resizes it by dragging, and the toolbar that floats beside it on hover.
+     *
+     * @remarks
+     * For a table an app manages itself. Only the controls are hidden: the table still grows as
+     * content is typed next to it (see {@link setAutoExpand}), and its filter buttons are
+     * {@link setHiddenButtons}. Not saved to xlsx, which has no such setting.
+     */
+    setHiddenDecorations(hidden: boolean): this;
+    /**
+     * Whether the grid's controls around the table are hidden. See {@link setHiddenDecorations}.
+     */
+    isHiddenDecorations(): boolean;
     /**
      * Add Listeners.
      *
@@ -923,7 +936,7 @@ export interface ITable extends IAnchored {
     /**
      * Returns the sheet the table is associated with.
      */
-    getSheet(): ISheet | null;
+    getWorksheet(): IWorksheet | null;
     /**
      * The table's entry in the workbook's names, or `null` if it is not named.
      *

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

@@ -1,14 +1,14 @@
 import { IRange } from '@sheetxl/primitives';
 import { ICellRange, ICellRanges } from '../cellRange';
 import { INamed } from '../named';
-import { ISheet } from '../sheet';
+import { IWorksheet } from '../sheet';
 import { ITransaction } from '../transaction';
 import { ITable } from './ITable';
 import { AbstractNamed } from '../named/AbstractNamed';
 export declare class NamedTable extends AbstractNamed<ITable, any> {
-    protected _sheet: ISheet;
+    protected _sheet: IWorksheet;
     protected _table: ITable;
-    constructor(sheet: ISheet, table: ITable, options: INamed.ConstructorOptions<ITable>);
+    constructor(sheet: IWorksheet, table: ITable, options: INamed.ConstructorOptions<ITable>);
     select(options?: ICellRange.SelectOptions): Promise<this>;
     getRanges(): ICellRanges | null;
     /**

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

@@ -1,7 +1,7 @@
 import { IListener } from '../listener';
 import { INamed } from '../named';
 import { NamedCollection } from '../named/NamedCollection';
-import { ISheet } from '../sheet';
+import { IWorksheet } from '../sheet';
 /**
  * Presents the tables of one or more sheets as named items.
  *
@@ -47,7 +47,7 @@ export declare class NamedTableSource implements NamedCollection.Source {
 export declare namespace NamedTableSource {
     interface ConstructorOptions {
         /** The sheets whose tables are contributed. Re-read on every query. */
-        getSheets: () => readonly ISheet[];
+        getSheets: () => readonly IWorksheet[];
         /**
          * Subscribes to the sheet list changing, so tables on a sheet added later are picked up.
          * Omitted for a single, fixed sheet.

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

@@ -35,24 +35,6 @@ export declare namespace IText {
         readonly All: "all";
     };
     type SmallCaps = typeof SmallCaps[keyof typeof SmallCaps];
-    /**
-     * Indicate how and if a line will be drawing horizontally through the middle of the text.
-     */
-    const StrikeStyle: {
-        /**
-         * No strike-through
-         */
-        readonly None: "none";
-        /**
-         * A single line.
-         */
-        readonly Single: "single";
-        /**
-         * A double line.
-         */
-        readonly Double: "double";
-    };
-    type StrikeStyle = typeof StrikeStyle[keyof typeof StrikeStyle];
     /**
      * How a paragraph's text is aligned between its margins.
      */
@@ -81,35 +63,6 @@ export declare namespace IText {
         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.
      */
@@ -129,8 +82,8 @@ export declare namespace IText {
      * 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`.
+     * Where a text style has the same property ({@link IFontStyle.Properties}) the name and values
+     * are the same: `weight`, `style`, `underline`, `strike`, `letterSpacing`, `baseline`.
      */
     interface RunPropertiesJSON {
         /** Font size in points. */
@@ -138,8 +91,8 @@ export declare namespace IText {
         /** `700` for bold, `400` for regular. */
         weight?: number;
         style?: IFont.Style;
-        underline?: UnderlineStyle;
-        strike?: StrikeStyle;
+        underline?: IFont.UnderlineStyle;
+        strike?: IFont.StrikeStyle;
         /** The text color: a fill (solid, gradient, pattern) or a serialized color. */
         color?: IFill.JSON | string;
         /** The Latin font. */

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

@@ -0,0 +1,34 @@
+import { SdkWasmExports } from '../wasm';
+import { TextWrapperFallback } from './_TextWrapperFallback';
+/** The lazily loaded TypeScript wrapper and its `linebreak` package. */
+export type TextFallbackModule = {
+    TextWrapperFallback: typeof TextWrapperFallback;
+};
+/**
+ * What wraps text: the Rust wrapper in the sdk's wasm, or, only where that cannot load (a
+ * Content Security Policy without `'wasm-unsafe-eval'`, Lockdown Mode), the TypeScript wrapper
+ * with its `linebreak` package as a chunk of its own. One or the other is loaded before any text
+ * is wrapped, never both; a wrap before either is an error naming `whenReady()`. The font
+ * collection starts the load when it starts and counts it among the loads its `whenReady()`
+ * waits for, so a workbook's `whenReady()` covers it.
+ *
+ * @remarks
+ * Internal to the sdk. In Node the wasm is instantiated as the sdk loads, so there is no window
+ * in which nothing is loaded.
+ */
+export declare const TextEngine: {
+    /**
+     * Loads the engine: the wasm, and the TypeScript fallback only if that fails. Rejects only
+     * when neither loads.
+     */
+    load: () => Promise<void>;
+    /** Loads the TypeScript wrapper whether or not the wasm is there: for comparing the two. */
+    loadFallback: () => Promise<TextFallbackModule>;
+    /** Whether a wrap can run now. */
+    isLoaded: () => boolean;
+    /** The wasm, if it has loaded. */
+    peekWasm: () => SdkWasmExports | undefined;
+    /** The TypeScript wrapper, if it has loaded. */
+    peekFallback: () => TextFallbackModule | undefined;
+};
+//# sourceMappingURL=TextEngine.d.ts.map

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

@@ -1,10 +1,10 @@
 import { Size, Bounds, Rectangle } from '@sheetxl/utils';
+import { IFontStyle } from '../font';
 import { TextVisitor } from './TextVisitor';
 import { ITextLine } from './TextLine';
 import { ITextParagraph } from './TextParagraph';
 import { ITextFrame } from './ITextFrame';
 import { ITextBoxAlignment } from './TextBoxAlignment';
-import { IStyledFont } from './richtext';
 export declare class TextFrame {
     private _private;
     private _bounds;
@@ -12,9 +12,11 @@ export declare class TextFrame {
     private _lines;
     private _lastLayoutSize;
     private _lastLayout;
+    /** The fonts the last layout measured with: a font that arrived since makes it stale. */
+    private _lastLayoutFonts;
     private _defaultFont;
     private _alignment;
-    constructor(overrides: Partial<ITextFrame>, defaultFont: IStyledFont, alignment: ITextBoxAlignment, lines?: ITextLine[] | null, bounds?: Bounds | null, textBounds?: Bounds | null);
+    constructor(overrides: Partial<ITextFrame>, defaultFont: IFontStyle, alignment: ITextBoxAlignment, lines?: ITextLine[] | null, bounds?: Bounds | null, textBounds?: Bounds | null);
     visitParas(visitor: TextVisitor): void;
     visitLines(visitor: TextVisitor): void;
     layout(size?: Partial<Size> | null): ITextFrame;

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

@@ -1,4 +1,5 @@
 import { Bounds } from '@sheetxl/utils';
+import { IFont } from '../font';
 import { IText } from './IText';
 import { TextVisitor } from './TextVisitor';
 /**
@@ -51,7 +52,7 @@ export interface ITextRun {
     /**
      * Specifies the strikethrough style applied to the text.
      */
-    readonly strikeStyle: IText.StrikeStyle;
+    readonly strikeStyle: IFont.StrikeStyle;
     /**
        * Specifies the baseline for both the superscript and subscript fonts.
        * The size is specified using a percentage where 1000 is equal to 1 percent
@@ -87,7 +88,7 @@ export declare class DefaultTextRun implements ITextRun, PlacedTextRun, Cloneabl
     get kerningMin(): number;
     get smallCaps(): IText.SmallCaps;
     get offset(): number;
-    get strikeStyle(): IText.StrikeStyle;
+    get strikeStyle(): IFont.StrikeStyle;
     /** {@inheritDoc ITextRun.isITextRun} */
     get isITextRun(): true;
 }