@shbernal/ts-xlsx 3.2.2-next.23.g1328014 → 3.2.2-next.24.g38fae0e

package/dist/core/address.d.ts

@@ -15,12 +15,12 @@ export declare const MAX_ROW_INDEX: number;
 /**
  * Refuse a coordinate that names no position on the grid.
  *
- * @throws {RangeError} unless `value` is an integer within the axis's bounds.
+ * @throws RangeError unless `value` is an integer within the axis's bounds.
  */
 export declare function assertAxisInBounds(axis: 'row' | 'column', value: number): void;
-/** @throws {RangeError} unless `n` is an integer in `1..MAX_COLUMN`. */
+/** @throws RangeError unless `n` is an integer in `1..MAX_COLUMN`. */
 export declare function assertColumnInBounds(n: number): void;
-/** @throws {RangeError} unless `n` is an integer in `1..MAX_ROW`. */
+/** @throws RangeError unless `n` is an integer in `1..MAX_ROW`. */
 export declare function assertRowInBounds(n: number): void;
 /**
  * A rectangular block of the grid, as **inclusive** 1-based bounds on both axes.
@@ -70,7 +70,7 @@ export interface RangeAddress {
 }
 /** Convert a 1-based column number to its letters (`1 → "A"`, `27 → "AA"`).
  *
- * @throws {RangeError} unless `n` is an integer in `1..MAX_COLUMN`. */
+ * @throws RangeError unless `n` is an integer in `1..MAX_COLUMN`. */
 export declare function numberToColumn(n: number): string;
 /**
  * Convert column letters to a 1-based number (`"A" → 1`, `"AA" → 27`), or `undefined` when they name
@@ -82,7 +82,7 @@ export declare function tryColumnToNumber(letters: string): number | undefined;
 /**
  * Convert column letters to a 1-based number (`"A" → 1`, `"AA" → 27`).
  *
- * @throws {RangeError} if the letters are malformed or name a column past `XFD`. The two are
+ * @throws RangeError if the letters are malformed or name a column past `XFD`. The two are
  *   separate messages because a caller fixes them differently.
  */
 export declare function columnToNumber(letters: string): number;
@@ -99,11 +99,11 @@ export declare function encodeCornerRef(col: number | undefined, row: number | u
  * A bounded rectangle as its canonical `tl:br` A1 range, `"B2:D5"`. A one-cell rectangle still reads
  * as `"B2:B2"`, which is the form Excel writes and the form every consumer of these refs parses.
  *
- * The rendering half of {@link boundedRect}, and it belongs beside it for the same reason: ten sites
- * spelled `` `${encodeAddress(left, top)}:${encodeAddress(right, bottom)}` `` by hand, and the risk in
- * that expression is not its length but its argument order. `encodeAddress` takes column first and a
- * rectangle names its rows first, so the two orders are transposed with respect to each other at every
- * one of those sites.
+ * The rendering half of {@link boundedRect}, and it belongs beside it for the same reason: ten
+ * sites spelled the template `${encodeAddress(left, top)}:${encodeAddress(right, bottom)}` by hand,
+ * and the risk in that expression is not its length but its argument order. `encodeAddress` takes
+ * column first and a rectangle names its rows first, so the two orders are transposed with respect
+ * to each other at every one of those sites.
  */
 export declare function encodeRect(rect: GridRect): string;
 /**
@@ -116,8 +116,8 @@ export declare function encodeRange(rect: GridRect): string;
  * Decode a single cell/row/column reference into `{address, col, row}`. Anchoring
  * `$` signs are accepted and dropped; an absent axis is `undefined`.
  *
- * @throws {SyntaxError} if the reference mentions neither a column nor a row.
- * @throws {RangeError} if it names a column past `XFD` or a row outside `1..1048576`.
+ * @throws SyntaxError if the reference mentions neither a column nor a row.
+ * @throws RangeError if it names a column past `XFD` or a row outside `1..1048576`.
  */
 export declare function decodeAddress(reference: string): CellAddress;
 /**
@@ -133,8 +133,8 @@ export interface CellPosition {
 /**
  * Decode a reference that must name a single cell. Anchoring `$` signs are accepted and dropped.
  *
- * @throws {SyntaxError} if the reference is unparseable, or parses but omits an axis (`"A"`, `"1"`).
- * @throws {RangeError} if it names a position off the grid (`"A0"`, `"XFE1"`).
+ * @throws SyntaxError if the reference is unparseable, or parses but omits an axis (`"A"`, `"1"`).
+ * @throws RangeError if it names a position off the grid (`"A0"`, `"XFE1"`).
  */
 export declare function decodeCellRef(reference: string): CellPosition;
 /**
@@ -180,8 +180,8 @@ export declare function tryDecodeAnchoredRange(reference: string, col: number, r
  * canonical dimensions. A single reference collapses to a degenerate range whose
  * corners coincide.
  *
- * @throws {SyntaxError} if an endpoint is unparseable.
- * @throws {RangeError} if an endpoint names a column past `XFD` or a row outside `1..1048576`.
+ * @throws SyntaxError if an endpoint is unparseable.
+ * @throws RangeError if an endpoint names a column past `XFD` or a row outside `1..1048576`.
  */
 export declare function decodeRange(reference: string): RangeAddress;
 /**

package/dist/core/cell.d.ts

@@ -14,7 +14,7 @@ export declare class Cell {
     readonly row: number;
     /** 1-based column index. */
     readonly col: number;
-    /** @throws {RangeError} unless both axes are integers within Excel's grid. */
+    /** @throws RangeError unless both axes are integers within Excel's grid. */
     constructor(row: number, col: number);
     /** Canonical A1 address of this cell (`"B3"`). */
     get address(): string;

package/dist/core/column.d.ts

@@ -8,7 +8,7 @@ export declare class Column extends AxisHandle<ColumnProperties> {
     #private;
     /** 1-based column index. Fixed for this handle's lifetime. */
     readonly index: number;
-    /** @throws {RangeError} unless the index is an integer within Excel's column grid (1..16384). */
+    /** @throws RangeError unless the index is an integer within Excel's column grid (1..16384). */
     constructor(sheet: Worksheet, index: number);
     /** The column's letters (`"B"`): the spreadsheet-facing name for {@link index}. */
     get letter(): string;
@@ -70,7 +70,7 @@ export declare class Column extends AxisHandle<ColumnProperties> {
      * The cell at a 1-based row number in this column, creating it on first access. Resolves through
      * merges exactly as {@link Worksheet.getCell} does.
      *
-     * @throws {RangeError} if the row is not a positive integer.
+     * @throws RangeError if the row is not a positive integer.
      */
     getCell(row: number): Cell;
     /**

package/dist/core/comment-thread.d.ts

@@ -87,7 +87,7 @@ export interface Comment {
  * The authoring path alone goes through here. A file's own ids are re-emitted as the file wrote them, since
  * a reader that rewrote them would break every reference pointing at them.
  *
- * @throws {SyntaxError} if the value is not a GUID in any spelling.
+ * @throws SyntaxError if the value is not a GUID in any spelling.
  */
 export declare function commentThreadGuid(value: string, what: string): string;
 /**
@@ -108,7 +108,7 @@ export declare const MENTION_OFFSET_MAX = 4294967295;
  * offset is dropped, keeping the message text and losing only the chip, because a foreign generator's
  * arithmetic is not something a caller can fix, whereas their own is.
  *
- * @throws {SyntaxError} if the value is negative, fractional, or beyond the wire's ceiling.
+ * @throws SyntaxError if the value is negative, fractional, or beyond the wire's ceiling.
  */
 export declare function commentThreadOffset(value: number, what: string): number;
 /** A conversation anchored to one cell: what was asked, every reply, and whether it was resolved. */

package/dist/core/conditional-formatting-overlay.d.ts

@@ -8,7 +8,7 @@ export declare class ConditionalFormattingOverlay {
      * rule set. The block is stored once against the range, defensively copied so the getter never hands
      * back a reference into the caller's object.
      *
-     * @throws {AuthoringError} when `formatting.ref` names no area at all. A rule set attached to
+     * @throws AuthoringError when `formatting.ref` names no area at all. A rule set attached to
      * nothing formats no cell and is written back as the same unreadable text, so it is a mistake worth
      * surfacing at the call. The reader does not reach this: it drops such a block at its own boundary.
      */

package/dist/core/conditional-formatting.d.ts

@@ -41,8 +41,8 @@ export declare const isConditionalFormattingType: (value: string) => value is Co
 /**
  * How a `cellIs` or text rule compares, as `ST_ConditionalFormattingOperator` enumerates it.
  *
- * Overlaps {@link import('./data-validation.ts').DataValidationOperator} in four members and diverges
- * in the rest: this one has the text comparisons a validation has no use for, and spells "does not
+ * Overlaps `DataValidationOperator` (`data-validation.ts`) in four members and diverges in the
+ * rest: this one has the text comparisons a validation has no use for, and spells "does not
  * contain" as `notContains` where nothing else in the format does.
  */
 export type ConditionalFormattingOperator = 'lessThan' | 'lessThanOrEqual' | 'equal' | 'notEqual' | 'greaterThanOrEqual' | 'greaterThan' | 'between' | 'notBetween' | 'containsText' | 'notContains' | 'beginsWith' | 'endsWith';

package/dist/core/data-validation-overlay.d.ts

@@ -13,7 +13,7 @@ export declare class DataValidationOverlay {
      * shapes the standard element cannot express. The reader sets it for a rule found in that form so a
      * round-trip writes it back there instead of silently corrupting the cross-sheet reference.
      *
-     * @throws {AuthoringError} when `sqref` names no area at all. A rule attached to nothing covers no
+     * @throws AuthoringError when `sqref` names no area at all. A rule attached to nothing covers no
      * cell and is written back as the same unreadable text, so it is a mistake worth reporting at the
      * call. The reader does not reach this: it drops such an entry at its own boundary, where a foreign
      * file's malformed attribute is supposed to be dropped.

package/dist/core/date-format.d.ts

@@ -13,7 +13,7 @@
  * (`[$-409]`), which is dropped rather than honoured -- month and weekday names render in English.
  * Both are recorded in ADR 0041.
  *
- * @param utc read the date's fields in UTC rather than in the runner's local time. A serial carries
+ * @param utc - read the date's fields in UTC rather than in the runner's local time. A serial carries
  *   no timezone, so a `Date` that came from one is UTC wall-clock and this should be `true`; a `Date`
  *   a caller assigned may mean either.
  */

package/dist/core/formula.d.ts

@@ -96,7 +96,7 @@ export declare function mangleFormula(formula: string, namesInScope: ReadonlySet
  * BIFF12 codec produces it too, and reaching the XML serialiser for it put the whole write half of
  * that module into the closure of an entry that has no XML in it.
  *
- * @throws {AuthoringError} when the value is not finite.
+ * @throws AuthoringError when the value is not finite.
  */
 export declare function formulaNumberLiteral(value: number): string;
 /**

package/dist/core/hyperlink.d.ts

@@ -17,8 +17,8 @@ export declare class HyperlinkOverlay {
     /**
      * Add a link, replacing one over the same cells. The `ref` is stored in its canonical spelling.
      *
-     * @throws {SyntaxError} if `ref` is not a reference.
-     * @throws {AuthoringError} if `ref` names a whole row or column rather than cells.
+     * @throws SyntaxError if `ref` is not a reference.
+     * @throws AuthoringError if `ref` names a whole row or column rather than cells.
      */
     add(link: Hyperlink): void;
     /** Remove the link whose `ref` names exactly these cells, and report whether there was one. */

package/dist/core/range.d.ts

@@ -28,7 +28,7 @@ export declare class Range implements GridRect {
      * Build a handle from inclusive corners, in any order: `(5, 4, 2, 2)` and `(2, 2, 5, 4)` name the
      * same block, exactly as `D5:B2` and `B2:D5` do. Prefer {@link Worksheet.getRange}.
      *
-     * @throws {RangeError} if a corner is not a positive integer or falls outside the sheet's bounds.
+     * @throws RangeError if a corner is not a positive integer or falls outside the sheet's bounds.
      */
     constructor(sheet: Worksheet, top: number, left: number, bottom: number, right: number);
     /** The worksheet this block belongs to. */
@@ -108,7 +108,7 @@ export declare class Range implements GridRect {
  * as sheet lookup is everywhere else): a range handed out by `sheetA` cannot be a block of `sheetB`,
  * and quietly ignoring the prefix would let a pasted `Sheet2!B2:D5` style the wrong sheet.
  *
- * @throws {SyntaxError} if the reference is unparseable, names another sheet, or leaves an axis
+ * @throws SyntaxError if the reference is unparseable, names another sheet, or leaves an axis
  *   unbounded (`A:A`, `1:1`).
  */
 export declare function rangeFrom(sheet: Worksheet, reference: string): Range;

package/dist/core/row.d.ts

@@ -8,7 +8,7 @@ export declare class Row extends AxisHandle<RowProperties> {
     #private;
     /** 1-based row number. Fixed for this handle's lifetime. */
     readonly number: number;
-    /** @throws {RangeError} unless the number is an integer within Excel's row grid (1..1048576). */
+    /** @throws RangeError unless the number is an integer within Excel's row grid (1..1048576). */
     constructor(sheet: Worksheet, number: number);
     /**
      * The row's format record if it has one, else `undefined`: a read that never fabricates, so a
@@ -50,8 +50,8 @@ export declare class Row extends AxisHandle<RowProperties> {
      * Resolves through merges exactly as {@link Worksheet.getCell} does: addressing a cell covered by
      * a merged region yields that region's master.
      *
-     * @throws {RangeError} if the column is not a positive integer.
-     * @throws {SyntaxError} if the column letters do not name a column.
+     * @throws RangeError if the column is not a positive integer.
+     * @throws SyntaxError if the column letters do not name a column.
      */
     getCell(column: number | string): Cell;
     /**

package/dist/core/table-style.d.ts

@@ -61,7 +61,7 @@ export interface TableStyle {
  * `size` outside a stripe is ignored. Neither shows up as a repair prompt or a schema error, so the
  * only place to catch them is the call that made them.
  *
- * @throws {AuthoringError} if the name is empty, or a non-stripe element carries a `size`.
- * @throws {RangeError} if a `size` is not a positive integer.
+ * @throws AuthoringError if the name is empty, or a non-stripe element carries a `size`.
+ * @throws RangeError if a `size` is not a positive integer.
  */
 export declare function checkTableStyle(style: TableStyle): void;

package/dist/core/text-metrics.d.ts

@@ -14,7 +14,7 @@
  * state *a* height rather than leave one to the application that opens the file, and being within a
  * line of the truth is what that needs.
  *
- * @throws {RangeError} if `width` is not a positive finite number - a column of zero width wraps
+ * @throws RangeError if `width` is not a positive finite number - a column of zero width wraps
  *   nothing, and silently answering `Infinity` or `NaN` would put that straight into a row height.
  */
 export declare function estimateWrappedLines(text: string, width: number): number;

package/dist/core/theme.d.ts

@@ -57,7 +57,7 @@ export declare function isThemeRgb(value: string): boolean;
  * reduced here; anything else is a caller's bug and is refused rather than written as corrupt XML,
  * which Excel does not report; it renders the slot as flat black.
  *
- * @throws {SyntaxError} if the value is not a recognisable RGB or ARGB hex string. Native rather
+ * @throws SyntaxError if the value is not a recognisable RGB or ARGB hex string. Native rather
  * than the library's own `AuthoringError`: a string that does not parse is what `SyntaxError` is
  * for, and it is the same kind of failure a malformed comment GUID raises.
  */

package/dist/core/value.d.ts

@@ -182,6 +182,6 @@ export declare function isErrorCode(text: string): text is ErrorCode;
  * stored form (no leading `=`) so round-trips are idempotent regardless of how the
  * caller supplied it.
  *
- * @throws {TypeError} if the value is not a recognised cell-value shape.
+ * @throws TypeError if the value is not a recognised cell-value shape.
  */
 export declare function coerceCellValue(value: CellValue | undefined): CellValue;

package/dist/core/workbook-media.d.ts

@@ -12,7 +12,7 @@ export declare class WorkbookMedia {
      * is why the message names the sheet rather than the id alone. Emitting a package with a drawing
      * pointing at media nobody registered is the silently-broken-image failure this refuses to start.
      *
-     * @throws {AuthoringError} if no image carries that id.
+     * @throws AuthoringError if no image carries that id.
      */
     require(id: number, forSheetName: string): WorkbookImage;
     /** Store a picture's bytes and return the id that names them. */

package/dist/core/workbook.d.ts

@@ -212,7 +212,7 @@ export declare class Workbook {
      * returned objects changes nothing on write; the original `customUI` XML is re-emitted byte-for-byte
      * regardless. Parsed lazily on first access and memoised.
      *
-     * @throws {CustomUiParseError} if a `customUI` part is present but its XML is malformed.
+     * @throws CustomUiParseError if a `customUI` part is present but its XML is malformed.
      */
     get customUI(): readonly CustomUiDocument[];
     /**
@@ -221,7 +221,7 @@ export declare class Workbook {
      * verbatim. Mutating the returned object changes nothing on write; the original macro blob is
      * re-emitted byte-for-byte regardless. Parsed lazily on first access and memoised.
      *
-     * @throws {VbaParseError} if a macro project is present but its `vbaProject.bin` is malformed.
+     * @throws VbaParseError if a macro project is present but its `vbaProject.bin` is malformed.
      */
     get vbaProject(): VbaProject | undefined;
     /**
@@ -275,9 +275,9 @@ export declare class Workbook {
      * To author or edit module *source* (which needs real compiled p-code), use the offline
      * `tools/vba-compiler`, then attach its output via {@link vbaProjectBytes}.
      *
-     * @throws {VbaAuthorError} if the workbook has no macro project, or `name` is not in the project,
+     * @throws VbaAuthorError if the workbook has no macro project, or `name` is not in the project,
      *   or names a `document`/`designer` module.
-     * @throws {VbaParseError} if the attached `vbaProject.bin` is malformed.
+     * @throws VbaParseError if the attached `vbaProject.bin` is malformed.
      */
     removeVbaModule(name: string): void;
     /**
@@ -286,9 +286,9 @@ export declare class Workbook {
      * {@link addVbaReference}). Replacing the project also drops a stale signature, as
      * {@link vbaProjectBytes} does.
      *
-     * @throws {VbaAuthorError} if the workbook has no macro project, or any field of `ref` is invalid
+     * @throws VbaAuthorError if the workbook has no macro project, or any field of `ref` is invalid
      *   (see {@link VbaLibraryReference}).
-     * @throws {VbaParseError} if the attached `vbaProject.bin` is malformed.
+     * @throws VbaParseError if the attached `vbaProject.bin` is malformed.
      */
     addVbaReference(ref: VbaLibraryReference): void;
     /** The preserved differential-style (`<dxfs>`) fragments, in index order. */
@@ -322,10 +322,10 @@ export declare class Workbook {
      * Registering a name a source file already defined **overrides** that definition rather than adding
      * a second one beside it.
      *
-     * @throws {AuthoringError} if the name is empty, or an element carries a `size` outside the four
+     * @throws AuthoringError if the name is empty, or an element carries a `size` outside the four
      *   stripe types. See {@link checkTableStyle} for why those are refused here rather than silently
      *   dropped.
-     * @throws {RangeError} if a `size` is not a positive integer.
+     * @throws RangeError if a `size` is not a positive integer.
      */
     addTableStyle(style: TableStyle): void;
     /** The table styles authored on this workbook, in registration order. */
@@ -350,7 +350,7 @@ export declare class Workbook {
      * slot left unauthored keeps the source's own encoding, including the `<a:sysClr>` form Excel uses
      * for `dk1`/`lt1` so they follow the viewer's window colours.
      *
-     * @throws {SyntaxError} if a colour is not 6 or 8 hexadecimal digits, with or without a leading `#`.
+     * @throws SyntaxError if a colour is not 6 or 8 hexadecimal digits, with or without a leading `#`.
      *   Every colour is read before any is stored, so a refused call changes nothing.
      */
     setTheme(overrides: ThemeOverrides): void;
@@ -389,7 +389,7 @@ export declare class Workbook {
      * follows {@link themeFonts}'s minor face, so `setTheme({fonts: {minor}})` already reaches every
      * unstyled cell and needs no second call here. See {@link defaultFont} for the full chain.
      *
-     * @throws {RangeError} if `size` is not a positive finite number, or `name` is empty. Both
+     * @throws RangeError if `size` is not a positive finite number, or `name` is empty. Both
      *   produce a styles part Excel renders from some other font without ever reporting why. Native
      *   rather than {@link AuthoringError}: one argument out of range is what `RangeError` is for.
      */
@@ -452,7 +452,7 @@ export declare class Workbook {
      * legitimate and is what Excel itself does. See {@link restorePersons}. The id is normalised to the
      * brace-wrapped upper-case GUID form the format requires, so a `crypto.randomUUID()` is accepted as-is.
      *
-     * @throws {SyntaxError} if the id is not a GUID.
+     * @throws SyntaxError if the id is not a GUID.
      */
     addPerson(person: Person): void;
     /**
@@ -491,7 +491,7 @@ export declare class Workbook {
      * never mutates image bytes, and copying every picture would double the memory of an image-heavy
      * workbook to defend against a mutation nothing performs.
      *
-     * @throws {AuthoringError} if the sheet anchors an image id this workbook has not registered,
+     * @throws AuthoringError if the sheet anchors an image id this workbook has not registered,
      *   which is what a sheet from *another* workbook looks like from here. Emitting a package with a
      *   drawing pointing at media that was never registered is the silently-broken-image failure this
      *   refuses to start.
@@ -519,14 +519,14 @@ export declare class Workbook {
     /**
      * Register a defined name on the workbook.
      *
-     * @throws {AuthoringError} if the name is empty, or if a {@link DefinedName.scope} is given that names no
+     * @throws AuthoringError if the name is empty, or if a {@link DefinedName.scope} is given that names no
      *   existing worksheet. A scoped name must target a sheet that is already part of the workbook.
      */
     defineName(definedName: DefinedName): void;
     /**
      * Create a worksheet and append it to the workbook.
      *
-     * @throws {AuthoringError} if the name is empty, too long, contains a forbidden character,
+     * @throws AuthoringError if the name is empty, too long, contains a forbidden character,
      *   or collides (case-insensitively) with an existing sheet.
      */
     addWorksheet(name: string, options?: AddWorksheetOptions): Worksheet;
@@ -542,7 +542,7 @@ export declare class Workbook {
      * That listing is the whole point: a lookup miss is a typo, a stale template or a renamed tab,
      * and all three are answered by seeing the real names.
      *
-     * @throws {AuthoringError} if no worksheet has that name (case-insensitive) or numeric id.
+     * @throws AuthoringError if no worksheet has that name (case-insensitive) or numeric id.
      */
     requireWorksheet(nameOrId: string | number): Worksheet;
     /**

package/dist/core/worksheet-merges.d.ts

@@ -23,8 +23,8 @@ export declare class WorksheetMerges {
      * whole-row/column range, which is declared and overlap-checks against nothing. The range is stored
      * in canonical form (see {@link canonicalMerge}).
      *
-     * @throws {SyntaxError} if the range is unparseable or names a worksheet.
-     * @throws {AuthoringError} if the range overlaps an already-merged region. Excel forbids
+     * @throws SyntaxError if the range is unparseable or names a worksheet.
+     * @throws AuthoringError if the range overlaps an already-merged region. Excel forbids
      *   overlapping merges and writes such geometry as a file it then offers to repair.
      */
     add(range: string): MergeRect | undefined;
@@ -32,7 +32,7 @@ export declare class WorksheetMerges {
      * Drop a declared range and, with it, the rectangle it covers. The inverse of {@link add}, and it
      * matches however the range is spelled, since both sides are compared in canonical form.
      *
-     * @throws {SyntaxError} if the range is unparseable or names a worksheet.
+     * @throws SyntaxError if the range is unparseable or names a worksheet.
      */
     remove(range: string): MergeRemoval;
     /**

package/dist/core/worksheet.d.ts

@@ -250,7 +250,7 @@ export declare class Worksheet {
      * covered address returns the master's. Only the master ever holds an independent
      * value, so the serialized sheet stays well-formed (no stray value on a covered cell).
      *
-     * @throws {SyntaxError} if the reference does not resolve to a single cell.
+     * @throws SyntaxError if the reference does not resolve to a single cell.
      */
     getCell(reference: string): Cell;
     /** Whether a cell has been materialised at the given 1-based position. */
@@ -261,7 +261,7 @@ export declare class Worksheet {
      * not extend the used range. Writing through it (`getColumn(2).width = 12`) is what materialises
      * the record.
      *
-     * @throws {RangeError} if the index is not a positive integer.
+     * @throws RangeError if the index is not a positive integer.
      */
     getColumn(index: number): Column;
     /**
@@ -270,7 +270,7 @@ export declare class Worksheet {
      * extend the used range. Writing through it (`getRow(3).height = 20`) is what materialises the
      * record.
      *
-     * @throws {RangeError} if the number is not a positive integer.
+     * @throws RangeError if the number is not a positive integer.
      */
     getRow(number: number): Row;
     /**
@@ -286,10 +286,10 @@ export declare class Worksheet {
      * million-cell block: OOXML states a whole-axis default in one attribute, and {@link getRow} /
      * {@link getColumn} are how you write it.
      *
-     * @throws {SyntaxError} if the reference is unparseable, names another worksheet, or leaves an
+     * @throws SyntaxError if the reference is unparseable, names another worksheet, or leaves an
      *   axis unbounded.
-     * @throws {AuthoringError} if the numeric form is called with fewer than four corners.
-     * @throws {RangeError} if a numeric corner is not a positive integer within the sheet's bounds.
+     * @throws AuthoringError if the numeric form is called with fewer than four corners.
+     * @throws RangeError if a numeric corner is not a positive integer within the sheet's bounds.
      */
     getRange(reference: string): Range;
     getRange(top: number, left: number, bottom: number, right: number): Range;
@@ -353,7 +353,7 @@ export declare class Worksheet {
      * name, at least one column, at least one row) are enforced here; conflicts with the
      * rest of the sheet (e.g. an overlapping merge) are the writer's concern.
      *
-     * @throws {AuthoringError} if the name, columns, or geometry are invalid.
+     * @throws AuthoringError if the name, columns, or geometry are invalid.
      */
     addTable(options: TableOptions): Table;
     /** The tables defined on this sheet, in definition order. */
@@ -367,7 +367,7 @@ export declare class Worksheet {
      * while a row or column splice of the source sheet moves its {@link PivotTable.sourceRef}. The
      * supported shape (one summed value field, at least one row and column field) is enforced here.
      *
-     * @throws {AuthoringError} if the metric, fields, or source shape are unsupported.
+     * @throws AuthoringError if the metric, fields, or source shape are unsupported.
      */
     addPivotTable(options: PivotTableOptions): PivotTable;
     /** The pivot tables hosted on this sheet, in definition order. */
@@ -401,7 +401,7 @@ export declare class Worksheet {
      * one id is therefore harmless and is not rejected: Excel's ids happen to be globally unique, but
      * nothing resolves across a part boundary.
      *
-     * @throws {SyntaxError} if the anchor does not resolve to a single cell, if any id is not a GUID, if a
+     * @throws SyntaxError if the anchor does not resolve to a single cell, if any id is not a GUID, if a
      * message id is already used on this sheet, or if a mention's span is not a whole number the wire can
      * express.
      */
@@ -417,7 +417,7 @@ export declare class Worksheet {
      * canonicalized, so an absolute `"$B$2"` finds the same thread as `"B2"`; it names the *anchor* cell,
      * so a cell merely covered by the anchor's merged region is not a match.
      *
-     * @throws {SyntaxError} if the reference does not resolve to a single cell.
+     * @throws SyntaxError if the reference does not resolve to a single cell.
      */
     commentThreadAt(reference: string): CommentThread | undefined;
     /**
@@ -486,9 +486,9 @@ export declare class Worksheet {
      * The range is stored in canonical form, `$` anchors dropped and the top-left corner first, so
      * merging `$B$2:$A$1` reports `A1:B2` through {@link merges}.
      *
-     * @throws {SyntaxError} if the range is unparseable or names a worksheet: a merge belongs to the
+     * @throws SyntaxError if the range is unparseable or names a worksheet: a merge belongs to the
      *   sheet it is made on, and a prefix naming another one used to be ignored.
-     * @throws {AuthoringError} if the range overlaps an already-merged region.
+     * @throws AuthoringError if the range overlaps an already-merged region.
      */
     mergeCells(range: string): void;
     /** The merged ranges on this sheet, in canonical form (`A1:B2`), in the order they were added. */
@@ -513,7 +513,7 @@ export declare class Worksheet {
      * stored and compared in canonical form. The covering rectangle is dropped alongside it, so a cell
      * the merge had masked addresses independently again. The inverse of {@link mergeCells}.
      *
-     * @throws {SyntaxError} if the range is unparseable or names a worksheet.
+     * @throws SyntaxError if the range is unparseable or names a worksheet.
      */
     unmergeCells(range: string): boolean;
     /**
@@ -538,7 +538,7 @@ export declare class Worksheet {
      * rule set. The block is stored once against the range, defensively copied so the getter never hands
      * back a reference into the caller's object.
      *
-     * @throws {AuthoringError} when `formatting.ref` names no cells: empty, or no area of it decodes.
+     * @throws AuthoringError when `formatting.ref` names no cells: empty, or no area of it decodes.
      */
     addConditionalFormatting(formatting: ConditionalFormatting): void;
     /** The conditional formattings on this sheet, each bound to its target range, in insertion order. */
@@ -561,8 +561,8 @@ export declare class Worksheet {
      * A row or column splice moves a link with the cells it covers, growing it when lines are inserted
      * inside it and shrinking it when some of its lines are deleted, as Excel does.
      *
-     * @throws {SyntaxError} if `ref` is not a reference.
-     * @throws {AuthoringError} if `ref` names a whole row or column rather than cells.
+     * @throws SyntaxError if `ref` is not a reference.
+     * @throws AuthoringError if `ref` names a whole row or column rather than cells.
      */
     addHyperlink(link: Hyperlink): void;
     /**
@@ -593,11 +593,11 @@ export declare class Worksheet {
      * edit and is not moved. A dynamic array whose range the edit leaves holding another formula has its
      * spill blocked, as Excel blocks it: the array formula keeps its own cell alone and caches `#SPILL!`.
      *
-     * @throws {RangeError} if `start` is not a positive integer or `count` is negative.
-     * @throws {RangeError} if an inserted row would land past the last row of the grid. The sheet is
+     * @throws RangeError if `start` is not a positive integer or `count` is negative.
+     * @throws RangeError if an inserted row would land past the last row of the grid. The sheet is
      *   left untouched, so this is a refused edit rather than half of one: a region pushed off the edge
      *   clamps and absorbs the loss, but content pushed off it is what Excel refuses outright.
-     * @throws {AuthoringError} if the edit would cut through a Ctrl+Shift+Enter array formula's range: an
+     * @throws AuthoringError if the edit would cut through a Ctrl+Shift+Enter array formula's range: an
      *   insert strictly inside it, or a delete taking part of it. Excel refuses the same edit, as a change
      *   to part of an array, and the sheet is left untouched. An edit moving or deleting the whole range,
      *   and any edit through a dynamic array's range, goes ahead.
@@ -608,7 +608,7 @@ export declare class Worksheet {
      * `values` takes either {@link RowInput} shape (positional array or keyed object), like
      * {@link addRow}. Shorthand for {@link spliceRows}`(pos, 0, values)`.
      *
-     * @throws {RangeError} if `pos` is not a positive integer.
+     * @throws RangeError if `pos` is not a positive integer.
      */
     insertRow(pos: number, values: RowInput): void;
     /**
@@ -636,7 +636,7 @@ export declare class Worksheet {
      * beneath them. `freeze(1)` pins a header row; `freeze(0, 1)` pins the first column. Passing both
      * zero clears the freeze (equivalent to {@link unfreeze}).
      *
-     * @throws {RangeError} if either split is a negative or non-integer count, or leaves no row or
+     * @throws RangeError if either split is a negative or non-integer count, or leaves no row or
      *   column of the grid to scroll. The view is left as it was.
      */
     freeze(ySplit?: number, xSplit?: number): void;
@@ -656,9 +656,9 @@ export declare class Worksheet {
      * over the source's cells; an inserted copy is taken from the source as the insert left it. A copy
      * landing in a dynamic array's range blocks its spill, as {@link spliceRows} says.
      *
-     * @throws {RangeError} if `start` is not a positive integer or `count` is negative, or if a copy
+     * @throws RangeError if `start` is not a positive integer or `count` is negative, or if a copy
      *   would land past the last row. The sheet is left untouched.
-     * @throws {AuthoringError} if a copy would land inside a Ctrl+Shift+Enter array formula's range, or
+     * @throws AuthoringError if a copy would land inside a Ctrl+Shift+Enter array formula's range, or
      *   replace part of one, which Excel refuses as a change to part of an array. The sheet is left
      *   untouched.
      */
@@ -675,12 +675,12 @@ export declare class Worksheet {
      *
      * Formulas move with the columns, by the rules {@link spliceRows} gives for rows.
      *
-     * @throws {RangeError} if `start` is not a positive integer or `count` is negative.
-     * @throws {RangeError} if an inserted column would land past the last column, or one of its values
+     * @throws RangeError if `start` is not a positive integer or `count` is negative.
+     * @throws RangeError if an inserted column would land past the last column, or one of its values
      *   past the last row. The sheet is left untouched, so this is a refused edit rather than half of
      *   one: a region pushed off the edge clamps and absorbs the loss, but content pushed off it is
      *   what Excel refuses outright, and {@link addColumn} refuses the same argument identically.
-     * @throws {AuthoringError} if the edit would cut through a Ctrl+Shift+Enter array formula's range, by
+     * @throws AuthoringError if the edit would cut through a Ctrl+Shift+Enter array formula's range, by
      *   the rule {@link spliceRows} gives for rows. The sheet is left untouched.
      */
     spliceColumns(start: number, count: number, ...inserts: CellValue[][]): void;
@@ -689,7 +689,7 @@ export declare class Worksheet {
      * by one. `values` is an array of values indexed by row (index 0 → row 1), like
      * {@link addColumn}. Shorthand for {@link spliceColumns}`(pos, 0, values)`.
      *
-     * @throws {RangeError} if `pos` is not a positive integer, or if the column would land past the
+     * @throws RangeError if `pos` is not a positive integer, or if the column would land past the
      *   last column or one of its values past the last row; see {@link spliceColumns}.
      */
     insertColumn(pos: number, values: CellValue[]): void;

package/dist/customui/ribbon.d.ts

@@ -80,7 +80,7 @@ export interface CustomUiDocument {
 /**
  * Parse a `customUI` part (raw UTF-8 bytes or its decoded text) into a {@link CustomUiDocument}.
  *
- * @throws {CustomUiParseError} if the XML is malformed, the root is not a `<customUI>` element in
+ * @throws CustomUiParseError if the XML is malformed, the root is not a `<customUI>` element in
  *   a recognised namespace, or the tree nests beyond {@link MAX_DEPTH}.
  */
 export declare function parseCustomUi(input: string | Uint8Array): CustomUiDocument;