@shbernal/ts-xlsx 1.0.0 → 1.0.3

package/README.md

@@ -1,5 +1,11 @@
 # ts-xlsx
 
+[![npm](https://img.shields.io/npm/v/%40shbernal%2Fts-xlsx)](https://www.npmjs.com/package/@shbernal/ts-xlsx)
+[![weekly downloads](https://img.shields.io/npm/dw/%40shbernal%2Fts-xlsx.svg?label=npm%20downloads&logo=npm)](https://www.npmjs.com/package/@shbernal/ts-xlsx)
+[![total downloads](https://img.shields.io/npm/dt/%40shbernal%2Fts-xlsx.svg?label=npm%20total%20downloads&logo=npm)](https://www.npmjs.com/package/@shbernal/ts-xlsx)
+[![CI](https://github.com/shbernal/ts-xlsx/actions/workflows/build.yml/badge.svg)](https://github.com/shbernal/ts-xlsx/actions/workflows/build.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 A TypeScript-first library for reading and writing spreadsheet documents
 (`.xlsx` / OOXML, and CSV) — synchronous, `Uint8Array`-native, and dependency-lean.
 

package/dist/core/autofilter.js

@@ -1,5 +1,5 @@
-import { AuthoringError } from "../errors.js";
-import { decodeRange } from "./address.js";
+import { AuthoringError } from '../errors.js';
+import { decodeRange } from './address.js';
 const CUSTOM_FILTER_OPERATORS = new Set([
     'equal',
     'notEqual',

package/dist/core/cell.js

@@ -4,10 +4,10 @@
 // *numbers* (legacy shipped a type declaration calling them strings, which broke
 // strict consumers). The value is the only mutable state here; assigning it routes
 // through the value model so the cell's `type` is always consistent with what it holds.
-import { encodeAddress } from "./address.js";
-import { NAMED_STYLE_ID } from "./internal.js";
-import { assignStyleFacets, } from "./style.js";
-import { coerceCellValue, detectValueType, } from "./value.js";
+import { encodeAddress } from './address.js';
+import { NAMED_STYLE_ID } from './internal.js';
+import { assignStyleFacets, } from './style.js';
+import { coerceCellValue, detectValueType, } from './value.js';
 /**
  * A single cell owns its value and every style facet outright. Each facet below — fill, number format,
  * font, border, alignment, protection, quote-prefix, and note — is held in the cell's own field and

package/dist/core/color-resolution.js

@@ -9,7 +9,7 @@
 // keeps the encoding its file used, so a round-trip re-emits `theme="4" tint="0.4"` rather than
 // rewriting every cell as a literal ARGB — which would bloat the styles table, break the link to the
 // theme (recolouring the workbook would stop working), and change what the file means.
-import { DEFAULT_THEME_COLOR_SCHEME, THEME_COLOR_SLOTS } from "./theme.js";
+import { DEFAULT_THEME_COLOR_SCHEME, THEME_COLOR_SLOTS } from './theme.js';
 /**
  * The built-in indexed colour palette (ECMA-376 §18.8.27), by index. Entries 0–7 duplicate 8–15 —
  * redundancy the spec preserves for backwards compatibility with the legacy formats this palette came

package/dist/core/column.js

@@ -7,8 +7,8 @@
 // A column carries more than a row does: besides the geometry (width, visibility, outline) it holds
 // the six `CellStyle` facets as *defaults* for its cells, which is why the mirror below is twice the
 // length of the row's.
-import { encodeAddress, numberToColumn } from "./address.js";
-import { INTERNAL } from "./internal.js";
+import { encodeAddress, numberToColumn } from './address.js';
+import { INTERNAL } from './internal.js';
 export class Column {
     #sheet;
     /** 1-based column index. Fixed for this handle's lifetime. */

package/dist/core/conditional-formatting-overlay.js

@@ -1,7 +1,7 @@
 // The conditional-formatting overlay a Worksheet owns: an insertion-ordered, defensively-copied list
 // of range-bound rule sets. Kept as its own class, the sibling to {@link DataValidationOverlay}, so
 // Worksheet delegates the collection's storage and cloning rather than managing the array itself.
-import { cloneConditionalFormatting } from "./conditional-formatting.js";
+import { cloneConditionalFormatting } from './conditional-formatting.js';
 export class ConditionalFormattingOverlay {
     #entries = [];
     /**

package/dist/core/data-validation-overlay.js

@@ -3,8 +3,8 @@
 // as its own class — the sibling to {@link GridEdits} that owns splice arithmetic — rather than inline
 // on Worksheet, since a validation's storage (a rule plus its decoded ranges) is a self-contained unit
 // Worksheet only ever adds to, reads, or clears wholesale.
-import { cloneDataValidation, } from "./data-validation.js";
-import { decodeSqrefRects } from "./merge.js";
+import { cloneDataValidation, } from './data-validation.js';
+import { decodeSqrefRects } from './merge.js';
 export class DataValidationOverlay {
     #entries = [];
     #rects = [];

package/dist/core/formula.js

@@ -20,8 +20,8 @@
 // verbatim and hands each code run between them to a transform. `mangleParams` is the deliberate
 // exception: LET/LAMBDA parameter scope opens and closes at paren boundaries, state `scanFormula`'s
 // per-run transform cannot carry, so it runs its own forward walk — still deferring to `skipOpaque`.
-import { columnToNumber, numberToColumn } from "./address.js";
-import { MODERN_FUNCTIONS } from "./modern-functions.js";
+import { columnToNumber, numberToColumn } from './address.js';
+import { MODERN_FUNCTIONS } from './modern-functions.js';
 const XLFN = '_xlfn.';
 const XLPM = '_xlpm.';
 /**

package/dist/core/grid-edits.js

@@ -4,11 +4,11 @@
 // mechanics: it holds the sheet's storage containers by reference and mutates them in place, and
 // touches none of the public cell API. Worksheet builds the cells an insert introduces, then hands
 // the pre-built rows (or the raw column values) here for the shift.
-import { decodeAddress, decodeRange, encodeAddress } from "./address.js";
-import { Cell, copyCellContent } from "./cell.js";
-import { replaceContents } from "./containers.js";
-import { isOneCellAnchor } from "./image.js";
-import { isSharedFormulaValue } from "./value.js";
+import { decodeAddress, decodeRange, encodeAddress } from './address.js';
+import { Cell, copyCellContent } from './cell.js';
+import { replaceContents } from './containers.js';
+import { isOneCellAnchor } from './image.js';
+import { isSharedFormulaValue } from './value.js';
 // The shift rule shared by every re-anchoring pass: a coordinate before the edit stays put, one at or
 // after the edited span shifts by `delta`, and one inside a deleted span clamps to the cut line (`start`).
 function shiftIndex(v, start, count, delta) {

package/dist/core/merge.js

@@ -1,7 +1,7 @@
 // Inclusive grid rectangles and the geometry a worksheet uses to reason about merged regions and the
 // `sqref` ranges that overlays (data validations, conditional formats) apply to: overlap detection and
 // decoding an OOXML `sqref` into containment rectangles.
-import { decodeRange } from "./address.js";
+import { decodeRange } from './address.js';
 /** Whether two inclusive grid rectangles share at least one cell. */
 export function rectsOverlap(a, b) {
     return a.left <= b.right && b.left <= a.right && a.top <= b.bottom && b.top <= a.bottom;

package/dist/core/pivot-table.js

@@ -9,9 +9,9 @@
 //
 // The source data is captured when the pivot is added — the model reads the source sheet's cells
 // once, here, so the pivot is a stable snapshot independent of later edits to the source.
-import { AuthoringError, InternalError } from "../errors.js";
-import { encodeAddress } from "./address.js";
-import { isErrorValue, isFormulaValue, isHyperlinkValue, isRichTextValue, isSharedFormulaValue, richTextToPlain, } from "./value.js";
+import { AuthoringError, InternalError } from '../errors.js';
+import { encodeAddress } from './address.js';
+import { isErrorValue, isFormulaValue, isHyperlinkValue, isRichTextValue, isSharedFormulaValue, richTextToPlain, } from './value.js';
 const PIVOT_METRICS = new Set([
     'sum',
     'count',

package/dist/core/range.js

@@ -9,9 +9,9 @@
 // million cells, whereas OOXML expresses it natively as a single `<col style>` or `<row s>` — which
 // is what `getColumn`/`getRow` already write, in constant space. Refusing them is what lets a range
 // materialise its cells eagerly without a cost cliff hiding behind an innocuous-looking call.
-import { decodeRange, encodeAddress, MAX_COLUMN, MAX_ROW } from "./address.js";
-import { applyCellStyle } from "./cell.js";
-import { CELL_STYLE_FACETS, } from "./style.js";
+import { decodeRange, encodeAddress, MAX_COLUMN, MAX_ROW } from './address.js';
+import { applyCellStyle } from './cell.js';
+import { CELL_STYLE_FACETS, } from './style.js';
 /**
  * A rectangular block of a worksheet's cells: `sheet.getRange('B2:D5')`.
  *
@@ -242,9 +242,13 @@ function setFacet(cell, facet, value) {
 // order their keys were written in. Sound here and nowhere near a general deep-equal: every facet is
 // a plain data record of strings, numbers, booleans and nested records — no functions, no cycles, no
 // class instances — which is exactly the shape JSON round-trips faithfully.
+//
+// `undefined` needs a sentinel because `JSON.stringify` answers it with `undefined` rather than a
+// string. NUL is the one that cannot collide: a defined value stringifies to `"`, `{`, `[`, a digit,
+// or a bare `true`/`false`/`null`, and a NUL *inside* a string comes back as a six-char escape.
 function facetKey(value) {
     if (value === undefined)
-        return '';
+        return '\u0000';
     return JSON.stringify(value, (_key, inner) => inner !== null && typeof inner === 'object' && !Array.isArray(inner)
         ? Object.fromEntries(Object.entries(inner).sort(([a], [b]) => (a < b ? -1 : 1)))
         : inner);

package/dist/core/row.js

@@ -12,8 +12,8 @@
 //
 // Formatting is created on write, never on read. Asking for `sheet.getRow(500)` costs nothing and
 // does not extend the used range; assigning `height` is what materialises the record.
-import { columnToNumber, encodeAddress } from "./address.js";
-import { INTERNAL } from "./internal.js";
+import { columnToNumber, encodeAddress } from './address.js';
+import { INTERNAL } from './internal.js';
 export class Row {
     #sheet;
     /** 1-based row number. Fixed for this handle's lifetime. */

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

@@ -8,7 +8,7 @@ import type { DifferentialStyle } from './style.ts';
  * the style's own `table`/`pivot` flags, not the element names — so the type carries all of them
  * rather than splitting into two enumerations that a caller would have to choose between up front.
  */
-export declare const TABLE_STYLE_ELEMENT_TYPES: readonly ["wholeTable", "headerRow", "totalRow", "firstColumn", "lastColumn", "firstRowStripe", "secondRowStripe", "firstColumnStripe", "secondColumnStripe", "firstHeaderCell", "lastHeaderCell", "firstTotalCell", "lastTotalCell", "firstSubtotalColumn", "secondSubtotalColumn", "thirdSubtotalColumn", "firstSubtotalRow", "secondSubtotalRow", "thirdSubtotalRow", "blankRow", "firstColumnSubheading", "secondColumnSubheading", "thirdColumnSubheading", "firstRowSubheading", "secondRowSubheading", "thirdRowSubheading", "pageFieldLabels", "pageFieldValues"];
+export declare const TABLE_STYLE_ELEMENT_TYPES: readonly ['wholeTable', 'headerRow', 'totalRow', 'firstColumn', 'lastColumn', 'firstRowStripe', 'secondRowStripe', 'firstColumnStripe', 'secondColumnStripe', 'firstHeaderCell', 'lastHeaderCell', 'firstTotalCell', 'lastTotalCell', 'firstSubtotalColumn', 'secondSubtotalColumn', 'thirdSubtotalColumn', 'firstSubtotalRow', 'secondSubtotalRow', 'thirdSubtotalRow', 'blankRow', 'firstColumnSubheading', 'secondColumnSubheading', 'thirdColumnSubheading', 'firstRowSubheading', 'secondRowSubheading', 'thirdRowSubheading', 'pageFieldLabels', 'pageFieldValues'];
 /** One region of a table or pivot that a table style can format. */
 export type TableStyleElementType = (typeof TABLE_STYLE_ELEMENT_TYPES)[number];
 /** The four element types banded across several rows or columns — the only ones {@link TableStyleElement.size} means anything on. */
@@ -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 {@link AuthoringError} if the name is empty, or a non-stripe element carries a `size`, or a `size` is not
+ * @throws {AuthoringError} if the name is empty, or a non-stripe element carries a `size`, or a `size` is not
  *   a positive integer.
  */
 export declare function checkTableStyle(style: TableStyle): void;

package/dist/core/table-style.js

@@ -5,7 +5,7 @@
 // gallery ("TableStyleMedium2" and its sixty siblings) is exactly this shape; a workbook that declares
 // its own joins the gallery for that file, and a table reaches it by name through
 // `TableStyleInfo.name`.
-import { AuthoringError } from "../errors.js";
+import { AuthoringError } from '../errors.js';
 /**
  * The regions a table style can format (`ST_TableStyleType`).
  *
@@ -63,7 +63,7 @@ export function isTableStyleElementType(value) {
  * `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 {@link AuthoringError} if the name is empty, or a non-stripe element carries a `size`, or a `size` is not
+ * @throws {AuthoringError} if the name is empty, or a non-stripe element carries a `size`, or a `size` is not
  *   a positive integer.
  */
 export function checkTableStyle(style) {

package/dist/core/table.js

@@ -6,8 +6,8 @@
 // only), a headerless table (data rows only), or a totals-bearing table. The writer is
 // the OOXML gatekeeper for serialization; this model owns the invariants Excel enforces
 // on the *shape* itself: a legal name, at least one column, and at least one row.
-import { AuthoringError } from "../errors.js";
-import { decodeAddress, encodeAddress } from "./address.js";
+import { AuthoringError } from '../errors.js';
+import { decodeAddress, encodeAddress } from './address.js';
 /** Copy a style, keeping only its defined fields off the literal so `exactOptionalPropertyTypes`
  * never sees a fabricated `key: undefined` — an absent attribute must stay absent across a copy.
  *

package/dist/core/theme.d.ts

@@ -12,7 +12,7 @@
  * `test/corpus/fixtures/excel-oracle/theme-color-index-order.json`. The stylesheet's own default font
  * is the everyday witness: it carries `<color theme="1"/>` and renders black, which is `dk1`.
  */
-export declare const THEME_COLOR_SLOTS: readonly ["lt1", "dk1", "lt2", "dk2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "hlink", "folHlink"];
+export declare const THEME_COLOR_SLOTS: readonly ['lt1', 'dk1', 'lt2', 'dk2', 'accent1', 'accent2', 'accent3', 'accent4', 'accent5', 'accent6', 'hlink', 'folHlink'];
 /** One slot of a theme's colour scheme. */
 export type ThemeColorSlot = (typeof THEME_COLOR_SLOTS)[number];
 /**

package/dist/core/theme.js

@@ -4,7 +4,7 @@
 // module reads just the `<a:clrScheme>` out of it, because that is the only piece a colour reference
 // needs. Everything else in a theme (the format scheme's gradients, line and effect styles) is
 // nobody's business here.
-import { AuthoringError } from "../errors.js";
+import { AuthoringError } from '../errors.js';
 /**
  * The twelve colour-scheme slots **in the order a `theme="n"` attribute indexes them**.
  *

package/dist/core/value.d.ts

@@ -1,19 +1,19 @@
 import type { Font } from './style.ts';
 /** The observable kind of a cell's value. Both formula shapes report as `Formula`. */
 export declare const ValueType: {
-    readonly Null: "null";
-    readonly Number: "number";
-    readonly String: "string";
-    readonly Boolean: "boolean";
-    readonly Date: "date";
-    readonly Error: "error";
-    readonly Formula: "formula";
-    readonly RichText: "richText";
-    readonly Hyperlink: "hyperlink";
+    readonly Null: 'null';
+    readonly Number: 'number';
+    readonly String: 'string';
+    readonly Boolean: 'boolean';
+    readonly Date: 'date';
+    readonly Error: 'error';
+    readonly Formula: 'formula';
+    readonly RichText: 'richText';
+    readonly Hyperlink: 'hyperlink';
 };
 export type ValueType = (typeof ValueType)[keyof typeof ValueType];
 /** The canonical Excel error literals a cell (or formula result) can carry. */
-export declare const ERROR_CODES: readonly ["#N/A", "#REF!", "#NAME?", "#DIV/0!", "#NULL!", "#VALUE!", "#NUM!", "#SPILL!", "#CALC!", "#GETTING_DATA"];
+export declare const ERROR_CODES: readonly ['#N/A', '#REF!', '#NAME?', '#DIV/0!', '#NULL!', '#VALUE!', '#NUM!', '#SPILL!', '#CALC!', '#GETTING_DATA'];
 export type ErrorCode = (typeof ERROR_CODES)[number];
 /** An in-cell error, e.g. `{error: '#REF!'}`. */
 export interface ErrorValue {

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

@@ -6,7 +6,7 @@
  * revisions guard (`revisions*`). The reader accepts only these names, so a hostile or unknown
  * attribute is never echoed back into the output.
  */
-export declare const WORKBOOK_PROTECTION_CREDENTIAL_ATTRS: readonly ["workbookPassword", "workbookAlgorithmName", "workbookHashValue", "workbookSaltValue", "workbookSpinCount", "revisionsPassword", "revisionsAlgorithmName", "revisionsHashValue", "revisionsSaltValue", "revisionsSpinCount"];
+export declare const WORKBOOK_PROTECTION_CREDENTIAL_ATTRS: readonly ['workbookPassword', 'workbookAlgorithmName', 'workbookHashValue', 'workbookSaltValue', 'workbookSpinCount', 'revisionsPassword', 'revisionsAlgorithmName', 'revisionsHashValue', 'revisionsSaltValue', 'revisionsSpinCount'];
 /** One of the attribute names {@link WORKBOOK_PROTECTION_CREDENTIAL_ATTRS} enumerates. */
 export type WorkbookProtectionCredentialAttr = (typeof WORKBOOK_PROTECTION_CREDENTIAL_ATTRS)[number];
 /**

package/dist/core/workbook.d.ts

@@ -173,7 +173,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 {@link 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[];
     /**
@@ -182,7 +182,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 {@link 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;
     /**
@@ -236,9 +236,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 {@link 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 {@link VbaParseError} if the attached `vbaProject.bin` is malformed.
+     * @throws {VbaParseError} if the attached `vbaProject.bin` is malformed.
      */
     removeVbaModule(name: string): void;
     /**
@@ -247,9 +247,9 @@ export declare class Workbook {
      * {@link addVbaReference}). Replacing the project also drops a stale signature, as
      * {@link vbaProjectBytes} does.
      *
-     * @throws {@link 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 {@link 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. */
@@ -283,7 +283,7 @@ export declare class Workbook {
      * Registering a name a source file already defined **overrides** that definition rather than adding
      * a second one beside it.
      *
-     * @throws {@link AuthoringError} if the name is empty, or an element carries a `size` outside the four stripe
+     * @throws {AuthoringError} if the name is empty, or an element carries a `size` outside the four stripe
      *   types, or a `size` is not a positive integer — see {@link checkTableStyle} for why those are
      *   refused here rather than silently dropped.
      */
@@ -310,7 +310,7 @@ export declare class Workbook {
      * 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 {@link AuthoringError} if a colour is not 6 or 8 hexadecimal digits.
+     * @throws {AuthoringError} if a colour is not 6 or 8 hexadecimal digits.
      */
     setTheme(overrides: ThemeOverrides): void;
     /**
@@ -345,7 +345,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 {@link AuthoringError} if `size` is not a positive finite number, or `name` is empty — both
+     * @throws {AuthoringError} 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.
      */
     setDefaultFont(font: Font): void;
@@ -431,14 +431,14 @@ export declare class Workbook {
     /**
      * Register a defined name on the workbook.
      *
-     * @throws {@link 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 {@link 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;

package/dist/core/workbook.js

@@ -4,17 +4,17 @@
 // Excel's rules — names are unique case-insensitively, bounded in length, and free
 // of the characters Excel forbids — so an invalid book cannot be constructed in the
 // first place, rather than failing only at write time.
-import { isCustomUiRelType, parseCustomUi } from "../customui/index.js";
-import { AuthoringError } from "../errors.js";
-import { addVbaReference, parseVbaProject, removeVbaModule, VBA_PROJECT_CONTENT_TYPE, VBA_PROJECT_PART_PATH, VBA_PROJECT_REL_TYPE, VbaAuthorError, vbaProjectSignatureKind, } from "../vba/index.js";
-import { resolveColor } from "./color-resolution.js";
-import { commentThreadGuid } from "./comment-thread.js";
-import { replaceContents } from "./containers.js";
-import { normalizeImageExtension } from "./image.js";
-import { INTERNAL } from "./internal.js";
-import { checkTableStyle } from "./table-style.js";
-import { applyThemeOverrides, DEFAULT_THEME_COLOR_SCHEME, DEFAULT_THEME_FONTS, DEFAULT_THEME_XML, OFFICE_BODY_FACE, parseThemeColorScheme, parseThemeFontScheme, THEME_COLOR_SLOTS, } from "./theme.js";
-import { Worksheet } from "./worksheet.js";
+import { isCustomUiRelType, parseCustomUi } from '../customui/index.js';
+import { AuthoringError } from '../errors.js';
+import { addVbaReference, parseVbaProject, removeVbaModule, VBA_PROJECT_CONTENT_TYPE, VBA_PROJECT_PART_PATH, VBA_PROJECT_REL_TYPE, VbaAuthorError, vbaProjectSignatureKind, } from '../vba/index.js';
+import { resolveColor } from './color-resolution.js';
+import { commentThreadGuid } from './comment-thread.js';
+import { replaceContents } from './containers.js';
+import { normalizeImageExtension } from './image.js';
+import { INTERNAL } from './internal.js';
+import { checkTableStyle } from './table-style.js';
+import { applyThemeOverrides, DEFAULT_THEME_COLOR_SCHEME, DEFAULT_THEME_FONTS, DEFAULT_THEME_XML, OFFICE_BODY_FACE, parseThemeColorScheme, parseThemeFontScheme, THEME_COLOR_SLOTS, } from './theme.js';
+import { Worksheet } from './worksheet.js';
 /**
  * The window geometry a workbook starts from — the values desktop Excel writes for its own default
  * window.
@@ -144,7 +144,7 @@ export 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 {@link 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() {
         if (!this.#customUiParsed) {
@@ -168,7 +168,7 @@ export 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 {@link 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() {
         if (!this.#vbaParsed) {
@@ -280,9 +280,9 @@ export 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 {@link 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 {@link VbaParseError} if the attached `vbaProject.bin` is malformed.
+     * @throws {VbaParseError} if the attached `vbaProject.bin` is malformed.
      */
     removeVbaModule(name) {
         const bytes = this.vbaProjectBytes;
@@ -297,9 +297,9 @@ export class Workbook {
      * {@link addVbaReference}). Replacing the project also drops a stale signature, as
      * {@link vbaProjectBytes} does.
      *
-     * @throws {@link 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 {@link VbaParseError} if the attached `vbaProject.bin` is malformed.
+     * @throws {VbaParseError} if the attached `vbaProject.bin` is malformed.
      */
     addVbaReference(ref) {
         const bytes = this.vbaProjectBytes;
@@ -357,7 +357,7 @@ export class Workbook {
      * Registering a name a source file already defined **overrides** that definition rather than adding
      * a second one beside it.
      *
-     * @throws {@link AuthoringError} if the name is empty, or an element carries a `size` outside the four stripe
+     * @throws {AuthoringError} if the name is empty, or an element carries a `size` outside the four stripe
      *   types, or a `size` is not a positive integer — see {@link checkTableStyle} for why those are
      *   refused here rather than silently dropped.
      */
@@ -400,7 +400,7 @@ export class Workbook {
      * 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 {@link AuthoringError} if a colour is not 6 or 8 hexadecimal digits.
+     * @throws {AuthoringError} if a colour is not 6 or 8 hexadecimal digits.
      */
     setTheme(overrides) {
         // Validated eagerly, by running the generation the writer will later run: a colour rejected at
@@ -468,7 +468,7 @@ export 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 {@link AuthoringError} if `size` is not a positive finite number, or `name` is empty — both
+     * @throws {AuthoringError} 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.
      */
     setDefaultFont(font) {
@@ -641,7 +641,7 @@ export class Workbook {
     /**
      * Register a defined name on the workbook.
      *
-     * @throws {@link 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) {
@@ -656,7 +656,7 @@ export class Workbook {
     /**
      * Create a worksheet and append it to the workbook.
      *
-     * @throws {@link 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, options = {}) {

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

@@ -22,7 +22,7 @@ interface ModelFacet<K extends keyof WorksheetModel = keyof WorksheetModel> {
  * load-bearing: cells are placed at their exact positions before any merge exists, so a covered
  * cell's value lands where the model says instead of being routed to a region master mid-load.
  */
-export declare const WORKSHEET_MODEL_FACETS: (ModelFacet<"state"> | ModelFacet<"tabColor"> | ModelFacet<"properties"> | ModelFacet<"outline"> | ModelFacet<"pageSetup"> | ModelFacet<"printOptions"> | ModelFacet<"pageMargins"> | ModelFacet<"headerFooter"> | ModelFacet<"rowBreaks"> | ModelFacet<"columnBreaks"> | ModelFacet<"columns"> | ModelFacet<"rows"> | ModelFacet<"cells"> | ModelFacet<"merges"> | ModelFacet<"dataValidations"> | ModelFacet<"conditionalFormattings"> | ModelFacet<"tables"> | ModelFacet<"autoFilter"> | ModelFacet<"protection">)[];
+export declare const WORKSHEET_MODEL_FACETS: (ModelFacet<"autoFilter"> | ModelFacet<"cells"> | ModelFacet<"columnBreaks"> | ModelFacet<"columns"> | ModelFacet<"conditionalFormattings"> | ModelFacet<"dataValidations"> | ModelFacet<"headerFooter"> | ModelFacet<"merges"> | ModelFacet<"outline"> | ModelFacet<"pageMargins"> | ModelFacet<"pageSetup"> | ModelFacet<"printOptions"> | ModelFacet<"properties"> | ModelFacet<"protection"> | ModelFacet<"rowBreaks"> | ModelFacet<"rows"> | ModelFacet<"state"> | ModelFacet<"tabColor"> | ModelFacet<"tables">)[];
 type AssertNever<T extends never> = T;
 /**
  * Compile-time proof that {@link WORKSHEET_MODEL_FACETS} covers every {@link WorksheetModel} field.

package/dist/core/worksheet-model.js

@@ -6,11 +6,11 @@
 // model contract exists to prevent. Here each field declares both directions in one place, and the
 // registry is proved exhaustive over `keyof WorksheetModel` at compile time, so adding a field
 // without wiring it is an error naming the field rather than a review catch.
-import { cellToModel, copyCellContent } from "./cell.js";
-import { cloneConditionalFormatting } from "./conditional-formatting.js";
-import { overwrite, replaceContents } from "./containers.js";
-import { cloneDataValidation } from "./data-validation.js";
-import { INTERNAL } from "./internal.js";
+import { cellToModel, copyCellContent } from './cell.js';
+import { cloneConditionalFormatting } from './conditional-formatting.js';
+import { overwrite, replaceContents } from './containers.js';
+import { cloneDataValidation } from './data-validation.js';
+import { INTERNAL } from './internal.js';
 function facet(key, read, write) {
     return { key, read, write: (sheet, model) => write(sheet, model[key]) };
 }

package/dist/core/worksheet.d.ts

@@ -275,7 +275,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 {@link 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. */
@@ -288,7 +288,7 @@ export declare class Worksheet {
      * read once, now, so the pivot is a snapshot: later edits to the source do not change it. The
      * supported shape (one summed value field, at least one row and column field) is enforced here.
      *
-     * @throws {@link 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. */

package/dist/core/worksheet.js

@@ -5,25 +5,25 @@
 // row metadata (widths, heights, visibility, outline grouping) are stored apart from
 // the cell grid, because a column or row can carry formatting while holding no cells.
 // Merges and views layer on in later slices.
-import { AuthoringError } from "../errors.js";
-import { decodeAddress, decodeRange, encodeAddress } from "./address.js";
-import { canonicalizeAutoFilter } from "./autofilter.js";
-import { applyCellStyle, Cell, copyCellContent } from "./cell.js";
-import { Column } from "./column.js";
-import { commentThreadGuid, commentThreadOffset } from "./comment-thread.js";
-import { ConditionalFormattingOverlay } from "./conditional-formatting-overlay.js";
-import { replaceContents } from "./containers.js";
-import { DataValidationOverlay } from "./data-validation-overlay.js";
-import { GridEdits } from "./grid-edits.js";
-import { PX_TO_EMU, resolveAnchorPoint, } from "./image.js";
-import { INTERNAL } from "./internal.js";
-import { rectsOverlap } from "./merge.js";
-import { PivotTable } from "./pivot-table.js";
-import { deriveCredential, } from "./protection.js";
-import { Range, rangeFrom } from "./range.js";
-import { Row } from "./row.js";
-import { Table, TOTALS_ROW_SUBTOTAL_CODE } from "./table.js";
-import { WORKSHEET_MODEL_FACETS } from "./worksheet-model.js";
+import { AuthoringError } from '../errors.js';
+import { decodeAddress, decodeRange, encodeAddress } from './address.js';
+import { canonicalizeAutoFilter } from './autofilter.js';
+import { applyCellStyle, Cell, copyCellContent } from './cell.js';
+import { Column } from './column.js';
+import { commentThreadGuid, commentThreadOffset } from './comment-thread.js';
+import { ConditionalFormattingOverlay } from './conditional-formatting-overlay.js';
+import { replaceContents } from './containers.js';
+import { DataValidationOverlay } from './data-validation-overlay.js';
+import { GridEdits } from './grid-edits.js';
+import { PX_TO_EMU, resolveAnchorPoint, } from './image.js';
+import { INTERNAL } from './internal.js';
+import { rectsOverlap } from './merge.js';
+import { PivotTable } from './pivot-table.js';
+import { deriveCredential, } from './protection.js';
+import { Range, rangeFrom } from './range.js';
+import { Row } from './row.js';
+import { Table, TOTALS_ROW_SUBTOTAL_CODE } from './table.js';
+import { WORKSHEET_MODEL_FACETS } from './worksheet-model.js';
 export class Worksheet {
     name;
     /** 1-based workbook-assigned id, stable for the sheet's lifetime. */
@@ -285,7 +285,7 @@ export 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 {@link AuthoringError} if the name, columns, or geometry are invalid.
+     * @throws {AuthoringError} if the name, columns, or geometry are invalid.
      */
     addTable(options) {
         const table = new Table(options, (row, col, value, style) => {
@@ -372,7 +372,7 @@ export class Worksheet {
      * read once, now, so the pivot is a snapshot: later edits to the source do not change it. The
      * supported shape (one summed value field, at least one row and column field) is enforced here.
      *
-     * @throws {@link AuthoringError} if the metric, fields, or source shape are unsupported.
+     * @throws {AuthoringError} if the metric, fields, or source shape are unsupported.
      */
     addPivotTable(options) {
         const pivot = new PivotTable(options);