@shbernal/ts-xlsx 1.0.0 → 1.0.3

package/dist/customui/errors.js

@@ -1,4 +1,4 @@
-import { XlsxError } from "../errors.js";
+import { XlsxError } from '../errors.js';
 /**
  * Thrown when a `customUI` ribbon-customisation part (`customUI/customUI.xml` or
  * `customUI/customUI14.xml`) is present but cannot be parsed into a {@link CustomUiDocument} — malformed

package/dist/customui/index.js

@@ -3,5 +3,5 @@
 // Those parts are preserved byte-for-byte on round-trip (see `src/core/preserved.ts`); this is a
 // projection over them, the same posture as the VBA read view (`src/vba`). Authoring/editing the ribbon
 // is out of scope — round-trip fidelity already comes from verbatim preservation.
-export { CustomUiParseError } from "./errors.js";
-export { CUSTOMUI_2006_NAMESPACE, CUSTOMUI_2007_REL_TYPE, CUSTOMUI_2009_NAMESPACE, CUSTOMUI_2010_REL_TYPE, isCustomUiRelType, parseCustomUi, } from "./ribbon.js";
+export { CustomUiParseError } from './errors.js';
+export { CUSTOMUI_2006_NAMESPACE, CUSTOMUI_2007_REL_TYPE, CUSTOMUI_2009_NAMESPACE, CUSTOMUI_2010_REL_TYPE, isCustomUiRelType, parseCustomUi, } from './ribbon.js';

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 {@link 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;

package/dist/customui/ribbon.js

@@ -16,8 +16,8 @@
 // with {@link CustomUiParseError} on any malformed or unrecognised structure rather than returning a
 // half-built tree.
 import { strFromU8 } from 'fflate';
-import { boolStrict, localName, xmlEvents } from "../xml/xml-read.js";
-import { CustomUiParseError } from "./errors.js";
+import { boolStrict, localName, xmlEvents } from '../xml/xml-read.js';
+import { CustomUiParseError } from './errors.js';
 /** The `customUI` root namespaces, one per {@link RibbonDialect}. */
 export const CUSTOMUI_2006_NAMESPACE = 'http://schemas.microsoft.com/office/2006/01/customui';
 export const CUSTOMUI_2009_NAMESPACE = 'http://schemas.microsoft.com/office/2009/07/customui';
@@ -59,7 +59,7 @@ const KNOWN_KINDS = new Set([
 /**
  * Parse a `customUI` part (raw UTF-8 bytes or its decoded text) into a {@link CustomUiDocument}.
  *
- * @throws {@link 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 function parseCustomUi(input) {

package/dist/entries/core.js

@@ -4,17 +4,17 @@
 // property shapes, and the value vocabulary. It pulls in no ZIP, no XML writer and no BIFF12
 // decoder. Errors are not here — the whole failure taxonomy lives behind `/errors`, so that a
 // caller who only needs to branch on a failure never loads a codec to get the class.
-export { columnToNumber, decodeAddress, decodeRange, encodeAddress, MAX_COLUMN, MAX_ROW, numberToColumn, } from "../core/address.js";
-export { Cell } from "../core/cell.js";
-export { applyTint, DEFAULT_INDEXED_COLORS, resolveColor, SYSTEM_INDEXED_COLORS, } from "../core/color-resolution.js";
-export { Column } from "../core/column.js";
-export { isOneCellAnchor, PX_TO_EMU, } from "../core/image.js";
-export { PivotTable, } from "../core/pivot-table.js";
-export { Range } from "../core/range.js";
-export { Row } from "../core/row.js";
-export { Table, } from "../core/table.js";
-export { isTableStyleElementType, STRIPE_ELEMENT_TYPES, TABLE_STYLE_ELEMENT_TYPES, } from "../core/table-style.js";
-export { DEFAULT_THEME_COLOR_SCHEME, DEFAULT_THEME_FONTS, parseThemeColorScheme, THEME_COLOR_SLOTS, } from "../core/theme.js";
-export { coerceCellValue, detectValueType, ERROR_CODES, isErrorCode, richTextToPlain, ValueType, } from "../core/value.js";
-export { DEFAULT_WORKBOOK_VIEW, Workbook, } from "../core/workbook.js";
-export { Worksheet, } from "../core/worksheet.js";
+export { columnToNumber, decodeAddress, decodeRange, encodeAddress, MAX_COLUMN, MAX_ROW, numberToColumn, } from '../core/address.js';
+export { Cell } from '../core/cell.js';
+export { applyTint, DEFAULT_INDEXED_COLORS, resolveColor, SYSTEM_INDEXED_COLORS, } from '../core/color-resolution.js';
+export { Column } from '../core/column.js';
+export { isOneCellAnchor, PX_TO_EMU, } from '../core/image.js';
+export { PivotTable, } from '../core/pivot-table.js';
+export { Range } from '../core/range.js';
+export { Row } from '../core/row.js';
+export { Table, } from '../core/table.js';
+export { isTableStyleElementType, STRIPE_ELEMENT_TYPES, TABLE_STYLE_ELEMENT_TYPES, } from '../core/table-style.js';
+export { DEFAULT_THEME_COLOR_SCHEME, DEFAULT_THEME_FONTS, parseThemeColorScheme, THEME_COLOR_SLOTS, } from '../core/theme.js';
+export { coerceCellValue, detectValueType, ERROR_CODES, isErrorCode, richTextToPlain, ValueType, } from '../core/value.js';
+export { DEFAULT_WORKBOOK_VIEW, Workbook, } from '../core/workbook.js';
+export { Worksheet, } from '../core/worksheet.js';

package/dist/entries/csv.js

@@ -2,5 +2,5 @@
 //
 // The two directions are asymmetric in what they cost: writing needs only a worksheet and the
 // value vocabulary, while reading builds a `Workbook` and therefore pulls the model in whole.
-export { readCsv } from "../io/csv/read.js";
-export { writeCsv, writeCsvText } from "../io/csv/write.js";
+export { readCsv } from '../io/csv/read.js';
+export { writeCsv, writeCsvText } from '../io/csv/write.js';

package/dist/entries/customui.js

@@ -1,3 +1,3 @@
 // Entry barrel for `@shbernal/ts-xlsx/customui` — the read-only ribbon view over a macro
 // workbook's preserved `customUI` parts.
-export { CUSTOMUI_2006_NAMESPACE, CUSTOMUI_2007_REL_TYPE, CUSTOMUI_2009_NAMESPACE, CUSTOMUI_2010_REL_TYPE, isCustomUiRelType, parseCustomUi, } from "../customui/ribbon.js";
+export { CUSTOMUI_2006_NAMESPACE, CUSTOMUI_2007_REL_TYPE, CUSTOMUI_2009_NAMESPACE, CUSTOMUI_2010_REL_TYPE, isCustomUiRelType, parseCustomUi, } from '../customui/ribbon.js';

package/dist/entries/errors.js

@@ -11,10 +11,10 @@
 //
 // `XlsxError` is the one-line answer to "was that us?"; `XlsxErrorCode` is the kind of failure,
 // shared across classes on purpose (see `src/errors.ts`).
-export { CustomUiParseError } from "../customui/errors.js";
-export { AuthoringError, InternalError, XlsxError } from "../errors.js";
-export { PackageReadError, UnsupportedFormatError, } from "../io/opc/errors.js";
-export { XlsbParseError } from "../io/xlsb/errors.js";
-export { XlsxParseError } from "../io/xlsx/errors.js";
-export { VbaAuthorError, VbaParseError } from "../vba/errors.js";
-export { XmlParseError } from "../xml/errors.js";
+export { CustomUiParseError } from '../customui/errors.js';
+export { AuthoringError, InternalError, XlsxError } from '../errors.js';
+export { PackageReadError, UnsupportedFormatError, } from '../io/opc/errors.js';
+export { XlsbParseError } from '../io/xlsb/errors.js';
+export { XlsxParseError } from '../io/xlsx/errors.js';
+export { VbaAuthorError, VbaParseError } from '../vba/errors.js';
+export { XmlParseError } from '../xml/errors.js';

package/dist/entries/vba.js

@@ -3,5 +3,5 @@
 // A deliberately narrower face than `src/vba/index.ts`, which is the *internal* barrel and also
 // carries the CFB writer, the MS-OVBA container primitives and the part-path constants that
 // `Workbook` and the codecs need. Those are implementation, not API.
-export { parseVbaProject, } from "../vba/project.js";
-export { addVbaReference, removeVbaModule, } from "../vba/project-editor.js";
+export { parseVbaProject, } from '../vba/project.js';
+export { addVbaReference, removeVbaModule, } from '../vba/project-editor.js';

package/dist/entries/xlsb.js

@@ -4,4 +4,4 @@
 // public for the caller that holds bytes it already knows to be `.xlsb` and wants to say so. That
 // dispatch also means this entry is not the way to *avoid* the BIFF12 codec — importing
 // `/xlsx` loads it either way (see the per-entry budgets in `scripts/size-budget.ts`).
-export { readXlsb } from "../io/xlsb/read.js";
+export { readXlsb } from '../io/xlsb/read.js';

package/dist/entries/xlsx.js

@@ -11,8 +11,8 @@
 // Streaming is not its own entry point. Measured, `read-rows` + `write-stream` reach every module
 // `read` + `write` do plus three — an entry that costs what the codec costs is an alias, not a
 // packaging boundary.
-export { editXlsxVbaAddReference, editXlsxVbaRemoveModule } from "../io/xlsx/edit-vba.js";
-export { readXlsx } from "../io/xlsx/read.js";
-export { readSheetRows, readWorkbookStream, } from "../io/xlsx/read-rows.js";
-export { writeXlsx, writeXlsxAsync } from "../io/xlsx/write.js";
-export { StreamedRow, WorkbookStreamWriter, WorksheetStreamWriter, } from "../io/xlsx/write-stream.js";
+export { editXlsxVbaAddReference, editXlsxVbaRemoveModule } from '../io/xlsx/edit-vba.js';
+export { readXlsx } from '../io/xlsx/read.js';
+export { readSheetRows, readWorkbookStream, } from '../io/xlsx/read-rows.js';
+export { writeXlsx, writeXlsxAsync } from '../io/xlsx/write.js';
+export { StreamedRow, WorkbookStreamWriter, WorksheetStreamWriter, } from '../io/xlsx/write-stream.js';

package/dist/index.js

@@ -10,10 +10,10 @@
 // `sideEffects: false` lets an unused module be dropped whole. Reach for a subpath when the
 // consumer has no bundler to do that for it, or when you want the module graph itself to say
 // which half of the library a service depends on.
-export * from "./entries/core.js";
-export * from "./entries/csv.js";
-export * from "./entries/customui.js";
-export * from "./entries/errors.js";
-export * from "./entries/vba.js";
-export * from "./entries/xlsb.js";
-export * from "./entries/xlsx.js";
+export * from './entries/core.js';
+export * from './entries/csv.js';
+export * from './entries/customui.js';
+export * from './entries/errors.js';
+export * from './entries/vba.js';
+export * from './entries/xlsb.js';
+export * from './entries/xlsx.js';

package/dist/io/csv/read.js

@@ -11,8 +11,8 @@
 //     and dash-codes such as `2020-00001` or `1-3` stay strings.
 // A caller can override coercion wholesale with `map` (e.g. the identity function to keep every
 // field a raw string, preserving leading zeros).
-import { Workbook } from "../../core/workbook.js";
-import { AuthoringError } from "../../errors.js";
+import { Workbook } from '../../core/workbook.js';
+import { AuthoringError } from '../../errors.js';
 /** Parse CSV text (or UTF-8 bytes) into a workbook holding a single worksheet. */
 export function readCsv(input, options = {}) {
     const text = stripBom(typeof input === 'string' ? input : Buffer.from(input).toString('utf8'));

package/dist/io/csv/write.js

@@ -9,8 +9,8 @@
 // `writeCsvText` yields the logical text; `writeCsv` encodes it to bytes and — for UTF-8, the
 // default — prepends a byte-order mark so a consumer such as Excel detects the encoding and does
 // not mangle non-ASCII on open. The BOM is a byte-level marker, not part of the logical text.
-import { isErrorValue, isFormulaValue, isHyperlinkValue, isRichTextValue, isSharedFormulaValue, richTextToPlain, } from "../../core/value.js";
-import { AuthoringError } from "../../errors.js";
+import { isErrorValue, isFormulaValue, isHyperlinkValue, isRichTextValue, isSharedFormulaValue, richTextToPlain, } from '../../core/value.js';
+import { AuthoringError } from '../../errors.js';
 const UTF8_BOM = Uint8Array.of(0xef, 0xbb, 0xbf);
 /** The logical CSV text of one worksheet — no BOM, no byte encoding. */
 export function writeCsvText(workbook, options = {}) {

package/dist/io/opc/errors.js

@@ -3,7 +3,7 @@
 // programmatically-branchable signal — not a raw zip-internals string (which is opaque, and can leak an
 // absolute filesystem path from the layer below). See the spec
 // `docs/knowledge/specs/unsupported-input-format-typed-error.md`.
-import { XlsxError } from "../../errors.js";
+import { XlsxError } from '../../errors.js';
 const DEFAULT_MESSAGE = {
     xls: 'the legacy .xls binary format (BIFF/OLE2 compound file) is not supported; only OOXML .xlsx is read',
     xlsb: 'this entry point does not read the binary .xlsb format (BIFF12)',

package/dist/io/opc/inflate.d.ts

@@ -6,7 +6,7 @@
  * @param cap  Maximum total uncompressed output, in bytes, across all parts. Enforced
  *   against bytes actually produced, never against the archive's declared sizes.
  * @returns A map of part path to inflated bytes.
- * @throws {@link PackageReadError} if inflation would exceed `cap` — a probable zip bomb.
+ * @throws {PackageReadError} if inflation would exceed `cap` — a probable zip bomb.
  * @throws {Error} raised by the zip layer if the archive is malformed or a part uses an unsupported
  *   compression method. Callers reach this through {@link inflateSpreadsheetPackage}, which is where
  *   those are classified; the raw error is deliberately not re-typed here, because its text is the

package/dist/io/opc/inflate.js

@@ -13,7 +13,7 @@
 // compressed bytes before each counter check bounds the worst-case overshoot past the cap
 // to one slice's expansion — not the whole (possibly enormous) stream.
 import { Unzip, UnzipInflate } from 'fflate';
-import { PackageReadError } from "./errors.js";
+import { PackageReadError } from './errors.js';
 // Compressed input is pushed in slices this size so decompressed output arrives in
 // increments the running counter can check. Small enough that the worst-case overshoot
 // (slice × DEFLATE's ~1032:1 ceiling ≈ 16 MiB) is negligible against a sane cap; large
@@ -27,7 +27,7 @@ const INPUT_SLICE = 1 << 14;
  * @param cap  Maximum total uncompressed output, in bytes, across all parts. Enforced
  *   against bytes actually produced, never against the archive's declared sizes.
  * @returns A map of part path to inflated bytes.
- * @throws {@link PackageReadError} if inflation would exceed `cap` — a probable zip bomb.
+ * @throws {PackageReadError} if inflation would exceed `cap` — a probable zip bomb.
  * @throws {Error} raised by the zip layer if the archive is malformed or a part uses an unsupported
  *   compression method. Callers reach this through {@link inflateSpreadsheetPackage}, which is where
  *   those are classified; the raw error is deliberately not re-typed here, because its text is the

package/dist/io/opc/read-opc.js

@@ -3,8 +3,8 @@
 // closure of parts a preserved reference reaches. Every helper here is pure over the inflated package —
 // it takes part text/bytes accessors and returns paths or records, touching no Workbook model.
 import { strFromU8 } from 'fflate';
-import { openElements } from "../../xml/xml-read.js";
-import { extensionOf, relsPathFor } from "./part-paths.js";
+import { openElements } from '../../xml/xml-read.js';
+import { extensionOf, relsPathFor } from './part-paths.js';
 // Bind the part-lookup accessors over an inflated package (a part-path → bytes map).
 export function packageAccessors(files) {
     return {

package/dist/io/opc/rels.js

@@ -3,8 +3,8 @@
 // it wires together are spelled in, so this is stated once here rather than inside a codec.
 //
 // The reader's half of the same graph (resolving targets, walking a part closure) is in `read-opc.ts`.
-import { escapeAttr, XML_DECLARATION } from "../../xml/xml.js";
-import { PKG_RELS_NS } from "./namespaces.js";
+import { escapeAttr, XML_DECLARATION } from '../../xml/xml.js';
+import { PKG_RELS_NS } from './namespaces.js';
 // A single `<Relationship>`. An `external` target lives outside the package (a hyperlink URL), so the
 // element carries `TargetMode="External"`; a package-internal target (the default) omits it. The caller
 // escapes the target when it is not a writer-controlled package path.

package/dist/io/opc/sniff-format.js

@@ -15,8 +15,8 @@
 //
 // The `.xlsx` and `.xlsb` serialisations share this whole layer — same container, same bound, same
 // rejections — so it is stated once here and neither reader owns it.
-import { PackageReadError, UnsupportedFormatError } from "./errors.js";
-import { inflatePackage } from "./inflate.js";
+import { PackageReadError, UnsupportedFormatError } from './errors.js';
+import { inflatePackage } from './inflate.js';
 // The OLE2 / Compound File Binary signature ([MS-CFB] 2.2) that opens every legacy `.xls` (and the
 // `.doc`/`.ppt` siblings). `src/vba/cfb.ts` reads this same magic for `vbaProject.bin`; here we need
 // only recognise it, not parse the container.

package/dist/io/style/xf-style.js

@@ -6,8 +6,8 @@
 // state the same model in XML and BIFF12 records — so it is stated once here, above both codecs. The
 // XML parsing lives in `../xlsx/read-styles.ts`, the record parsing in `../xlsb/read-styles.ts`, and
 // each hands back the same {@link StyleTable}.
-import { applyCellStyle } from "../../core/cell.js";
-import { NAMED_STYLE_ID } from "../../core/internal.js";
+import { applyCellStyle } from '../../core/cell.js';
+import { NAMED_STYLE_ID } from '../../core/internal.js';
 // ECMA-376 reserves numFmt ids below 164 for formats every consumer knows implicitly, so a
 // foreign file may name one with no <numFmt> entry. This maps the standard ids to their
 // codes; id 0 (General) and any unknown id resolve to no format. The writer never emits

package/dist/io/xlsb/errors.js

@@ -1,4 +1,4 @@
-import { XlsxError } from "../../errors.js";
+import { XlsxError } from '../../errors.js';
 /**
  * Thrown when an `.xlsb` package's binary BIFF12 content cannot be parsed — a record whose declared
  * size runs past the end of its part, a truncated record header, or a structure that does not conform

package/dist/io/xlsb/formula.js

@@ -21,10 +21,10 @@
 // desynchronise the parse and produce confident nonsense. Instead the decoder returns `undefined` and
 // its caller keeps what it can still trust — the cached result Excel stored beside the formula. The
 // gaps that reach that path are listed in `docs/knowledge/specs/xlsb-binary-format-output.md`.
-import { MAX_COLUMN, numberToColumn } from "../../core/address.js";
-import { quoteSheetName } from "../../core/formula.js";
-import { errorCodeFor, RecordReader } from "./primitives.js";
-import { FTAB_USER_DEFINED, fixedArityFor, functionNameFor } from "./ptg-functions.js";
+import { MAX_COLUMN, numberToColumn } from '../../core/address.js';
+import { quoteSheetName } from '../../core/formula.js';
+import { errorCodeFor, RecordReader } from './primitives.js';
+import { FTAB_USER_DEFINED, fixedArityFor, functionNameFor } from './ptg-functions.js';
 /**
  * Decode a `CellParsedFormula`'s token stream into formula text, in the same on-disk spelling the XML
  * form writes into `<f>` — `_xlfn.`-prefixed function names included, so the caller applies the same

package/dist/io/xlsb/primitives.js

@@ -9,8 +9,8 @@
 //
 // Structures decoded here — RkNumber, XLWideString, BrtColor, Cell, UncheckedRfX, BErr — are shared
 // across the workbook, worksheet, styles, and shared-string parsers; nothing part-specific lives here.
-import { isErrorCode } from "../../core/value.js";
-import { XlsbParseError } from "./errors.js";
+import { isErrorCode } from '../../core/value.js';
+import { XlsbParseError } from './errors.js';
 // A length-prefixed string is decoded in code-unit batches rather than one `String.fromCharCode` call
 // per character (quadratic concatenation) or one spread of every unit (which blows the argument limit
 // on a long string). 4096 is comfortably under every engine's limit and makes the batching invisible.

package/dist/io/xlsb/read-shared-strings.js

@@ -4,9 +4,9 @@
 // `RichStr`. Only the text is taken: a pooled string's per-run formatting is not modelled in this cut,
 // so the runs are left unread rather than half-decoded (see `primitives.ts`). Reading stops at the
 // closing record, so trailing future-record blocks are never framed.
-import { RecordReader } from "./primitives.js";
-import { readRecords } from "./record-stream.js";
-import { BRT } from "./record-types.js";
+import { RecordReader } from './primitives.js';
+import { readRecords } from './record-stream.js';
+import { BRT } from './record-types.js';
 /** Parse `xl/sharedStrings.bin` into the pool, in index order. An absent part is an empty pool. */
 export function parseSharedStrings(part) {
     if (part === undefined)

package/dist/io/xlsb/read-styles.js

@@ -9,11 +9,11 @@
 // workbook the same model rather than two similar ones — a bottom vertical alignment, a locked cell,
 // or a General number format is written explicitly in BIFF12 and omitted in XML, so the binary side
 // has to drop exactly what the XML side never had.
-import { assignStyleFacets } from "../../core/style.js";
-import { numFmtCodeFor } from "../style/xf-style.js";
-import { RecordReader } from "./primitives.js";
-import { readRecords } from "./record-stream.js";
-import { BRT } from "./record-types.js";
+import { assignStyleFacets } from '../../core/style.js';
+import { numFmtCodeFor } from '../style/xf-style.js';
+import { RecordReader } from './primitives.js';
+import { readRecords } from './record-stream.js';
+import { BRT } from './record-types.js';
 const COLLECTION_STARTS = new Map([
     [BRT.BeginFmts, 'fmts'],
     [BRT.BeginFonts, 'fonts'],

package/dist/io/xlsb/read-worksheet.js

@@ -16,15 +16,15 @@
 // pointing at the group's top-left, and the `BrtArrFmla` record carrying the group's actual formula
 // comes *after* those cells in the stream. Those cells are therefore parked and resolved once the
 // whole part has been read.
-import { encodeAddress, MAX_COLUMN } from "../../core/address.js";
-import { isDateFormat, serialToDate } from "../../core/date.js";
-import { unmangleFunctions } from "../../core/formula.js";
-import { assignStyleFacets } from "../../core/style.js";
-import { applyXfToCell } from "../style/xf-style.js";
-import { decodeFormula, formulaAnchor } from "./formula.js";
-import { errorCodeFor, RecordReader } from "./primitives.js";
-import { readRecords } from "./record-stream.js";
-import { BRT } from "./record-types.js";
+import { encodeAddress, MAX_COLUMN } from '../../core/address.js';
+import { isDateFormat, serialToDate } from '../../core/date.js';
+import { unmangleFunctions } from '../../core/formula.js';
+import { assignStyleFacets } from '../../core/style.js';
+import { applyXfToCell } from '../style/xf-style.js';
+import { decodeFormula, formulaAnchor } from './formula.js';
+import { errorCodeFor, RecordReader } from './primitives.js';
+import { readRecords } from './record-stream.js';
+import { BRT } from './record-types.js';
 // Every record that carries a plain cell — one whose payload is a value and nothing else. Membership
 // drives the dispatch below, so a record type absent from both this set and {@link FORMULA_RECORDS}
 // is skipped whole rather than being mistaken for a cell and consuming the reader.

package/dist/io/xlsb/read.d.ts

@@ -8,7 +8,7 @@ export declare const XLSB_WORKBOOK_PART = "xl/workbook.bin";
  * @throws {UnsupportedFormatError} if the input is not an `.xlsb` package — a legacy `.xls`
  *   (`.format === 'xls'`), an XML `.xlsx` or unrecognised blob (`'unknown'`).
  * @throws {XlsbParseError} if a binary part is malformed.
- * @throws {@link PackageReadError} if the input is a ZIP that cannot be unpacked — a corrupt or
+ * @throws {PackageReadError} if the input is a ZIP that cannot be unpacked — a corrupt or
  *   truncated archive, or one exceeding the inflate bound (a probable zip bomb).
  */
 export declare function readXlsb(data: Uint8Array, options?: ReadXlsxOptions): Workbook;

package/dist/io/xlsb/read.js

@@ -13,20 +13,20 @@
 //
 // Not yet decoded (each its own slice of work, none silently wrong): rich-text runs, tables, pivots,
 // and conditional formatting.
-import { unmangleFunctions } from "../../core/formula.js";
-import { INTERNAL } from "../../core/internal.js";
-import { Workbook } from "../../core/workbook.js";
-import { UnsupportedFormatError } from "../opc/errors.js";
-import { packageAccessors, parseRelationships, resolveWorkbookPart } from "../opc/read-opc.js";
-import { DEFAULT_MAX_UNCOMPRESSED } from "../opc/read-options.js";
-import { inflateSpreadsheetPackage } from "../opc/sniff-format.js";
-import { decodeFormula } from "./formula.js";
-import { RecordReader } from "./primitives.js";
-import { parseSharedStrings } from "./read-shared-strings.js";
-import { parseStyleTable } from "./read-styles.js";
-import { parseWorksheet } from "./read-worksheet.js";
-import { readRecords } from "./record-stream.js";
-import { BRT } from "./record-types.js";
+import { unmangleFunctions } from '../../core/formula.js';
+import { INTERNAL } from '../../core/internal.js';
+import { Workbook } from '../../core/workbook.js';
+import { UnsupportedFormatError } from '../opc/errors.js';
+import { packageAccessors, parseRelationships, resolveWorkbookPart } from '../opc/read-opc.js';
+import { DEFAULT_MAX_UNCOMPRESSED } from '../opc/read-options.js';
+import { inflateSpreadsheetPackage } from '../opc/sniff-format.js';
+import { decodeFormula } from './formula.js';
+import { RecordReader } from './primitives.js';
+import { parseSharedStrings } from './read-shared-strings.js';
+import { parseStyleTable } from './read-styles.js';
+import { parseWorksheet } from './read-worksheet.js';
+import { readRecords } from './record-stream.js';
+import { BRT } from './record-types.js';
 /** The office-document part every `.xlsb` package is entered through. */
 export const XLSB_WORKBOOK_PART = 'xl/workbook.bin';
 /**
@@ -35,7 +35,7 @@ export const XLSB_WORKBOOK_PART = 'xl/workbook.bin';
  * @throws {UnsupportedFormatError} if the input is not an `.xlsb` package — a legacy `.xls`
  *   (`.format === 'xls'`), an XML `.xlsx` or unrecognised blob (`'unknown'`).
  * @throws {XlsbParseError} if a binary part is malformed.
- * @throws {@link PackageReadError} if the input is a ZIP that cannot be unpacked — a corrupt or
+ * @throws {PackageReadError} if the input is a ZIP that cannot be unpacked — a corrupt or
  *   truncated archive, or one exceeding the inflate bound (a probable zip bomb).
  */
 export function readXlsb(data, options = {}) {

package/dist/io/xlsb/record-stream.js

@@ -10,7 +10,7 @@
 // the part the inflate bound already materialised and capped, and a size that would run past the end
 // of the part is rejected outright rather than clamped. A lying length therefore costs nothing and
 // fails closed, and the whole stream's memory is exactly the part's own bytes.
-import { XlsbParseError } from "./errors.js";
+import { XlsbParseError } from './errors.js';
 /**
  * Decode a `.bin` part into its record sequence, in order.
  *

package/dist/io/xlsx/cell-accumulator.js

@@ -4,12 +4,12 @@
 // the per-cell state on {@link beginCell} and commits it on {@link finalize}, so this class is the
 // single owner of "what has this cell gathered so far" — to a cell what {@link RunAccumulator} is to a
 // rich string. Value *decoding* stays in `cell-value.ts`; this class only gathers the raw pieces.
-import { decodeAddress, encodeAddress } from "../../core/address.js";
-import { translateFormula, unmangleFunctions } from "../../core/formula.js";
-import { boolPresent } from "../../xml/xml-read.js";
-import { applyXfToCell } from "../style/xf-style.js";
-import { decodeCellContent, decodeFormulaResult, } from "./cell-value.js";
-import { RunAccumulator } from "./rich-runs.js";
+import { decodeAddress, encodeAddress } from '../../core/address.js';
+import { translateFormula, unmangleFunctions } from '../../core/formula.js';
+import { boolPresent } from '../../xml/xml-read.js';
+import { applyXfToCell } from '../style/xf-style.js';
+import { decodeCellContent, decodeFormulaResult, } from './cell-value.js';
+import { RunAccumulator } from './rich-runs.js';
 export class CellAccumulator {
     #ref = '';
     #type = '';

package/dist/io/xlsx/cell-value.js

@@ -4,10 +4,10 @@
 // (`./read.ts`) and the streaming row reader (`./read-rows.ts`). Keeping it in one place is
 // what guarantees a cell read one row at a time decodes identically to the same cell read as
 // part of a whole workbook — a divergence here would be a silent data bug in exactly one path.
-import { isDateFormat, serialToDate } from "../../core/date.js";
-import { unmangleFunctions } from "../../core/formula.js";
-import { isErrorCode, } from "../../core/value.js";
-import { boolStrict } from "../../xml/xml-read.js";
+import { isDateFormat, serialToDate } from '../../core/date.js';
+import { unmangleFunctions } from '../../core/formula.js';
+import { isErrorCode, } from '../../core/value.js';
+import { boolStrict } from '../../xml/xml-read.js';
 /**
  * Decode a gathered cell into its model value. A formula cell becomes a `{formula, result?}`
  * object (the on-disk `_xlfn.`/`_xlpm.` mangling stripped back to the readable name); a plain

package/dist/io/xlsx/comments.js

@@ -18,10 +18,10 @@
 // relationships and content types all survive intact still reads back as ordinary notes with zero
 // threads once those two are lost. So the fallback is *derived from the thread model* on write and
 // *suppressed on read*, rather than round-tripped as a plain note.
-import { decodeAddress } from "../../core/address.js";
-import { escapeAttr, escapeText, textElement, XML_DECLARATION } from "../../xml/xml.js";
-import { localName, parseXml } from "../../xml/xml-read.js";
-import { MARKUP_COMPATIBILITY_NS, REVISION_NS, SPREADSHEETML_NS } from "./namespaces.js";
+import { decodeAddress } from '../../core/address.js';
+import { escapeAttr, escapeText, textElement, XML_DECLARATION } from '../../xml/xml.js';
+import { localName, parseXml } from '../../xml/xml-read.js';
+import { MARKUP_COMPATIBILITY_NS, REVISION_NS, SPREADSHEETML_NS } from './namespaces.js';
 /**
  * Gather every comment a sheet must write: its cells' notes, plus one legacy fallback per conversation
  * in `threads`. A comment anchors to its cell regardless of the cell's value, so a note (or a thread) on

package/dist/io/xlsx/conditional-formatting.js

@@ -12,15 +12,15 @@
 // colour, understood by every consumer) plus an `<x14:dataBar>` in the worksheet `<extLst>` carrying
 // the extras, the two linked by a shared id. The reader folds the extension back onto the classic
 // rule, so the gradient flag and the two extra colours survive a round-trip rather than being dropped.
-import { boolAttr, escapeAttr, escapeText, stripFormulaEquals } from "../../xml/xml.js";
-import { boolStrict, coerceNumericLiteral, localName, parseXml } from "../../xml/xml-read.js";
+import { boolAttr, escapeAttr, escapeText, stripFormulaEquals } from '../../xml/xml.js';
+import { boolStrict, coerceNumericLiteral, localName, parseXml } from '../../xml/xml-read.js';
 // The x14/xm extension namespaces and ext-URI GUIDs are declared inline on the `<ext>` elements
 // exactly as Excel writes them, so no worksheet-root xmlns is needed. `CF_EXT_URI` scopes the
 // worksheet's x14 conditional formattings; `DATABAR_LINK_EXT_URI` scopes the `<x14:id>` link a
 // classic cfRule carries to name its extension.
-import { CF_EXT_URI, DATABAR_LINK_EXT_URI, XM_NS } from "./namespaces.js";
-import { colorAttrs, parseColor } from "./styles.js";
-import { x14Ext } from "./x14-ext.js";
+import { CF_EXT_URI, DATABAR_LINK_EXT_URI, XM_NS } from './namespaces.js';
+import { colorAttrs, parseColor } from './styles.js';
+import { x14Ext } from './x14-ext.js';
 // Excel's default data bar when the author supplies none: a min/max anchor pair and its standard blue.
 const DEFAULT_DATABAR_CFVO = [{ type: 'min' }, { type: 'max' }];
 const DEFAULT_DATABAR_COLOR = { argb: 'FF638EC6' };

package/dist/io/xlsx/data-validation.js

@@ -13,13 +13,13 @@
 // wraps each operand in an `<xm:f>` under `<x14:formula1>`/`<x14:formula2>`. A rule read from that
 // form is tagged `extended` so it is written back there; the two forms are parsed and serialised by
 // prefix so neither reader mistakes one for the other.
-import { escapeAttr, escapeText, stripFormulaEquals } from "../../xml/xml.js";
-import { boolStrict, coerceNumericLiteral, localName, parseXml } from "../../xml/xml-read.js";
+import { escapeAttr, escapeText, stripFormulaEquals } from '../../xml/xml.js';
+import { boolStrict, coerceNumericLiteral, localName, parseXml } from '../../xml/xml-read.js';
 // The x14/xm extension namespaces and `DATA_VALIDATION_EXT_URI` are declared inline on the elements
 // that need them, exactly as Excel writes them, so the block is self-contained and the worksheet root
 // needs no extra namespace declaration.
-import { DATA_VALIDATION_EXT_URI, XM_NS } from "./namespaces.js";
-import { x14Ext } from "./x14-ext.js";
+import { DATA_VALIDATION_EXT_URI, XM_NS } from './namespaces.js';
+import { x14Ext } from './x14-ext.js';
 // The typed validations whose literal operands are numbers; `list`/`custom` operands stay strings.
 const TYPED = new Set(['whole', 'decimal', 'date', 'time', 'textLength']);
 /** The standard `<dataValidations>` element for the rules stored in the legacy form, or '' when the

package/dist/io/xlsx/edit-vba.js

@@ -14,10 +14,10 @@
 // so that needs the offline `tools/vba-compiler` (VBIDE), which can produce a whole edited `.xlsm`
 // directly (ADR 0019).
 import { strFromU8, strToU8, unzipSync, zipSync } from 'fflate';
-import { VbaAuthorError } from "../../vba/errors.js";
-import { addVbaReference, removeVbaModule, } from "../../vba/project-editor.js";
-import { relsPathFor } from "../opc/part-paths.js";
-import { parseRelationshipRecords, relationshipTargetByType, resolveRelativePart, resolveWorkbookPart, } from "../opc/read-opc.js";
+import { VbaAuthorError } from '../../vba/errors.js';
+import { addVbaReference, removeVbaModule, } from '../../vba/project-editor.js';
+import { relsPathFor } from '../opc/part-paths.js';
+import { parseRelationshipRecords, relationshipTargetByType, resolveRelativePart, resolveWorkbookPart, } from '../opc/read-opc.js';
 const OFFICE_DOCUMENT_REL = 'officeDocument';
 const VBA_PROJECT_REL = 'vbaProject';
 // Every signature flavour Excel writes over a VBA project (legacy, agile, V3) shares this local-name

package/dist/io/xlsx/errors.js

@@ -1,4 +1,4 @@
-import { XlsxError } from "../../errors.js";
+import { XlsxError } from '../../errors.js';
 /**
  * Thrown when an `.xlsx` package's XML content is well-formed but does not describe a workbook this
  * library can act on — a `xl/workbook.xml` that declares no worksheets, say.

package/dist/io/xlsx/hyperlinks.js

@@ -9,10 +9,10 @@
 // is held directly in a `location` attribute with NO relationship — emitting an internal target as an
 // external relationship makes a strict consumer resolve both the rel and the location and render the
 // destination doubled.
-import { decodeRange } from "../../core/address.js";
-import { isHyperlinkValue, isRichTextValue } from "../../core/value.js";
-import { escapeAttr } from "../../xml/xml.js";
-import { localName, parseXml } from "../../xml/xml-read.js";
+import { decodeRange } from '../../core/address.js';
+import { isHyperlinkValue, isRichTextValue } from '../../core/value.js';
+import { escapeAttr } from '../../xml/xml.js';
+import { localName, parseXml } from '../../xml/xml-read.js';
 /** Gather every hyperlink cell on a sheet, in row-major order. */
 export function collectHyperlinks(sheet) {
     const links = [];