@cj-tech-master/excelts 5.1.18 → 6.0.0-beta.1

package/dist/browser/modules/excel/errors.js

@@ -0,0 +1,176 @@
+/**
+ * Excel module error types.
+ *
+ * All Excel-related errors extend ExcelError.
+ */
+import { BaseError } from "../../utils/errors.js";
+/**
+ * Base class for all Excel-related errors.
+ */
+export class ExcelError extends BaseError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ExcelError";
+    }
+}
+/**
+ * Check if an error is an Excel error.
+ */
+export function isExcelError(err) {
+    return err instanceof ExcelError;
+}
+/**
+ * Error thrown when worksheet name validation fails.
+ */
+export class WorksheetNameError extends ExcelError {
+    constructor() {
+        super(...arguments);
+        this.name = "WorksheetNameError";
+    }
+}
+/**
+ * Error thrown when a cell address or range is invalid.
+ */
+export class InvalidAddressError extends ExcelError {
+    constructor(address, details, options) {
+        super(details ? `Invalid address "${address}": ${details}` : `Invalid address: ${address}`, options);
+        this.address = address;
+        this.name = "InvalidAddressError";
+    }
+}
+/**
+ * Error thrown when a column number or letter is out of bounds.
+ */
+export class ColumnOutOfBoundsError extends ExcelError {
+    constructor(column, details, options) {
+        super(details
+            ? `Column ${column} is out of bounds: ${details}`
+            : `Column ${column} is out of bounds. Excel supports columns from 1 to 16384`, options);
+        this.column = column;
+        this.name = "ColumnOutOfBoundsError";
+    }
+}
+/**
+ * Error thrown when a row number is out of bounds.
+ */
+export class RowOutOfBoundsError extends ExcelError {
+    constructor(row, details, options) {
+        super(details ? `Row ${row} is out of bounds: ${details}` : `Row ${row} is out of bounds`, options);
+        this.row = row;
+        this.name = "RowOutOfBoundsError";
+    }
+}
+/**
+ * Error thrown when trying to merge already merged cells.
+ */
+export class MergeConflictError extends ExcelError {
+    constructor(details, options) {
+        super(details ?? "Cannot merge already merged cells", options);
+        this.name = "MergeConflictError";
+    }
+}
+/**
+ * Error thrown when a value type cannot be processed.
+ */
+export class InvalidValueTypeError extends ExcelError {
+    constructor(valueType, details, options) {
+        super(details ?? `Cannot process value of type: ${valueType}`, options);
+        this.valueType = valueType;
+        this.name = "InvalidValueTypeError";
+    }
+}
+/**
+ * Error thrown when XML parsing encounters unexpected content.
+ */
+export class XmlParseError extends ExcelError {
+    constructor(context, details, options) {
+        super(details ?? `Unexpected XML content in ${context}`, options);
+        this.context = context;
+        this.name = "XmlParseError";
+    }
+}
+/**
+ * Error thrown when an operation is not supported.
+ */
+export class ExcelNotSupportedError extends ExcelError {
+    constructor(operation, reason, options) {
+        super(reason ? `${operation}: ${reason}` : `${operation} is not supported`, options);
+        this.operation = operation;
+        this.reason = reason;
+        this.name = "ExcelNotSupportedError";
+    }
+}
+/**
+ * Error thrown when a file operation fails.
+ */
+export class ExcelFileError extends ExcelError {
+    constructor(path, operation, details, options) {
+        super(details
+            ? `Failed to ${operation} Excel file "${path}": ${details}`
+            : `Failed to ${operation} Excel file "${path}"`, options);
+        this.path = path;
+        this.operation = operation;
+        this.name = "ExcelFileError";
+    }
+}
+/**
+ * Error thrown when a streaming operation fails due to invalid state.
+ */
+export class ExcelStreamStateError extends ExcelError {
+    constructor(operation, state, options) {
+        super(`Cannot ${operation}: ${state}`, options);
+        this.operation = operation;
+        this.state = state;
+        this.name = "ExcelStreamStateError";
+    }
+}
+/**
+ * Error thrown when an HTTP download fails.
+ */
+export class ExcelDownloadError extends ExcelError {
+    constructor(url, status, statusText, options) {
+        super(`Failed to download from "${url}": HTTP ${status} ${statusText}`, options);
+        this.url = url;
+        this.status = status;
+        this.statusText = statusText;
+        this.name = "ExcelDownloadError";
+    }
+}
+/**
+ * Error thrown when pivot table configuration is invalid.
+ */
+export class PivotTableError extends ExcelError {
+    constructor() {
+        super(...arguments);
+        this.name = "PivotTableError";
+    }
+}
+/**
+ * Error thrown when table configuration or operation is invalid.
+ */
+export class TableError extends ExcelError {
+    constructor() {
+        super(...arguments);
+        this.name = "TableError";
+    }
+}
+/**
+ * Error thrown when image processing fails.
+ */
+export class ImageError extends ExcelError {
+    constructor() {
+        super(...arguments);
+        this.name = "ImageError";
+    }
+}
+/**
+ * Error thrown when max items limit is exceeded.
+ */
+export class MaxItemsExceededError extends ExcelError {
+    constructor(itemType, maxItems, options) {
+        super(`Max ${itemType} count (${maxItems}) exceeded`, options);
+        this.itemType = itemType;
+        this.maxItems = maxItems;
+        this.name = "MaxItemsExceededError";
+    }
+}

package/dist/browser/modules/excel/form-control.d.ts

@@ -1,4 +1,4 @@
-import type { Worksheet } from "@excel/worksheet";
+import type { Worksheet } from "./worksheet.js";
 /**
  * Form Control Checkbox - Legacy checkbox control compatible with Office 2007+ and WPS/LibreOffice
  *

package/dist/browser/modules/excel/image.d.ts

@@ -1,5 +1,5 @@
-import { Anchor, type AnchorModel } from "@excel/anchor";
-import type { Worksheet } from "@excel/worksheet";
+import { Anchor, type AnchorModel } from "./anchor.js";
+import type { Worksheet } from "./worksheet.js";
 interface ImageHyperlinks {
     hyperlink?: string;
     tooltip?: string;

package/dist/browser/modules/excel/image.js

@@ -1,5 +1,6 @@
 import { colCache } from "./utils/col-cache.js";
 import { Anchor } from "./anchor.js";
+import { ImageError } from "./errors.js";
 class Image {
     constructor(worksheet, model) {
         this.worksheet = worksheet;
@@ -27,7 +28,7 @@ class Image {
                     }
                 };
             default:
-                throw new Error("Invalid Image Type");
+                throw new ImageError("Invalid Image Type");
         }
     }
     set model({ type, imageId, range, hyperlinks }) {

package/dist/browser/modules/excel/pivot-table.d.ts

@@ -1,4 +1,4 @@
-import type { Table } from "@excel/table";
+import type { Table } from "./table.js";
 /**
  * Interface representing the source data abstraction for pivot tables.
  * This allows both Worksheet and Table to be used as pivot table data sources.

package/dist/browser/modules/excel/pivot-table.js

@@ -1,5 +1,6 @@
 import { range, toSortedArray } from "../../utils/utils.browser.js";
 import { colCache } from "./utils/col-cache.js";
+import { PivotTableError } from "./errors.js";
 /**
  * Wrapper for OOXML error values in sharedItems (e.g. `<e v="REF!"/>`).
  * Distinguishes error strings from regular strings so they roundtrip as `<e>` not `<s>`.
@@ -42,18 +43,18 @@ function createTableSourceAdapter(table) {
     const tableModel = table.model;
     // Validate that table has headerRow enabled (required for pivot table column names)
     if (tableModel.headerRow === false) {
-        throw new Error("Cannot create pivot table from a table without headers. Set headerRow: true on the table.");
+        throw new PivotTableError("Cannot create pivot table from a table without headers. Set headerRow: true on the table.");
     }
     // Validate table has data rows
     if (!tableModel.rows || tableModel.rows.length === 0) {
-        throw new Error("Cannot create pivot table from an empty table. Add data rows to the table.");
+        throw new PivotTableError("Cannot create pivot table from an empty table. Add data rows to the table.");
     }
     const columnNames = tableModel.columns.map(col => col.name);
     // Check for duplicate column names
     const nameSet = new Set();
     for (const name of columnNames) {
         if (nameSet.has(name)) {
-            throw new Error(`Duplicate column name "${name}" found in table. Pivot tables require unique column names.`);
+            throw new PivotTableError(`Duplicate column name "${name}" found in table. Pivot tables require unique column names.`);
         }
         nameSet.add(name);
     }
@@ -120,7 +121,7 @@ const BASE_CACHE_ID = 10;
  */
 function resolveSource(model) {
     if (model.sourceSheet && model.sourceTable) {
-        throw new Error("Cannot specify both sourceSheet and sourceTable. Choose one.");
+        throw new PivotTableError("Cannot specify both sourceSheet and sourceTable. Choose one.");
     }
     if (model.sourceTable) {
         return createTableSourceAdapter(model.sourceTable);
@@ -228,7 +229,7 @@ function validate(model, source) {
     const headerNameSet = new Set(headerNames.map(String));
     const validateFieldExists = (name) => {
         if (!headerNameSet.has(name)) {
-            throw new Error(`The header name "${name}" was not found in ${source.name}.`);
+            throw new PivotTableError(`The header name "${name}" was not found in ${source.name}.`);
         }
     };
     for (const name of model.rows) {
@@ -264,11 +265,11 @@ function validate(model, source) {
         }
     }
     if (!model.rows.length) {
-        throw new Error("No pivot table rows specified.");
+        throw new PivotTableError("No pivot table rows specified.");
     }
     // Allow empty columns - Excel will use "Values" as column field
     if (model.values.length < 1) {
-        throw new Error("Must have at least one value.");
+        throw new PivotTableError("Must have at least one value.");
     }
     // Validate metric values at runtime (guards against `as any` bypasses)
     if (model.metric !== undefined && !VALID_SUBTOTALS.has(model.metric)) {

package/dist/browser/modules/excel/range.d.ts

@@ -1,4 +1,4 @@
-import type { Address } from "@excel/types";
+import type { Address } from "./types.js";
 interface RangeModel {
     top: number;
     left: number;

package/dist/browser/modules/excel/range.js

@@ -1,4 +1,5 @@
 import { colCache } from "./utils/col-cache.js";
+import { ExcelError } from "./errors.js";
 // used by worksheet to calculate sheet dimensions
 class Range {
     constructor(...args) {
@@ -133,7 +134,7 @@ class Range {
                 };
                 break;
             default:
-                throw new Error(`Invalid number of arguments to _getDimensions() - ${argv.length}`);
+                throw new ExcelError(`Invalid number of arguments to _getDimensions() - ${argv.length}`);
         }
     }
     get top() {

package/dist/browser/modules/excel/row.d.ts

@@ -1,6 +1,6 @@
-import { Cell, type CellModel, type CellAddress } from "@excel/cell";
-import type { Worksheet } from "@excel/worksheet";
-import type { Style, NumFmt, Font, Alignment, Protection, Borders, Fill, CellValue, RowValues } from "@excel/types";
+import { Cell, type CellModel, type CellAddress } from "./cell.js";
+import type { Worksheet } from "./worksheet.js";
+import type { Style, NumFmt, Font, Alignment, Protection, Borders, Fill, CellValue, RowValues } from "./types.js";
 interface RowDimensions {
     min: number;
     max: number;

package/dist/browser/modules/excel/row.js

@@ -1,6 +1,7 @@
 import { Enums } from "./enums.js";
 import { colCache } from "./utils/col-cache.js";
 import { Cell } from "./cell.js";
+import { ExcelError } from "./errors.js";
 import { copyStyle } from "./utils/copy-style.js";
 class Row {
     constructor(worksheet, number) {
@@ -397,7 +398,7 @@ class Row {
     }
     set model(value) {
         if (value.number !== this._number) {
-            throw new Error("Invalid row number in model");
+            throw new ExcelError("Invalid row number in model");
         }
         this._cells = [];
         let previousAddress;

package/dist/browser/modules/excel/stream/hyperlink-reader.d.ts

@@ -3,8 +3,8 @@
  *
  * Cross-platform implementation.
  */
-import { EventEmitter } from "@stream";
-import type { InternalWorksheetOptions } from "@excel/stream/workbook-reader.browser";
+import { EventEmitter } from "../../../utils/event-emitter.js";
+import type { InternalWorksheetOptions } from "./workbook-reader.browser.js";
 export interface HyperlinkReaderOptions<TWorkbook = unknown> {
     workbook: TWorkbook;
     id: number;

package/dist/browser/modules/excel/stream/hyperlink-reader.js

@@ -3,7 +3,7 @@
  *
  * Cross-platform implementation.
  */
-import { EventEmitter } from "../../stream/index.browser.js";
+import { EventEmitter } from "../../../utils/event-emitter.js";
 import { parseSax } from "../utils/parse-sax.js";
 import { Enums } from "../enums.js";
 import { RelType } from "../xlsx/rel-type.js";

package/dist/browser/modules/excel/stream/workbook-reader.browser.d.ts

@@ -8,11 +8,12 @@
  * Node.js uses `workbook-reader.ts`, which extends the same base implementation
  * with filesystem-specific features (filename input + temp-file buffering).
  */
-import { EventEmitter, Readable } from "@stream";
-import { StylesXform } from "@excel/xlsx/xform/style/styles-xform";
-import type { WorksheetState, Font, WorkbookProperties } from "@excel/types";
-import { WorksheetReader } from "@excel/stream/worksheet-reader";
-import { HyperlinkReader, type Hyperlink } from "@excel/stream/hyperlink-reader";
+import { Readable } from "../../stream/index.js";
+import { EventEmitter } from "../../../utils/event-emitter.js";
+import { StylesXform } from "../xlsx/xform/style/styles-xform.js";
+import type { WorksheetState, Font, WorkbookProperties } from "../types.js";
+import { WorksheetReader } from "./worksheet-reader.js";
+import { HyperlinkReader, type Hyperlink } from "./hyperlink-reader.js";
 export interface InternalWorksheetOptions {
     worksheets?: "emit" | "ignore" | "prep";
     sharedStrings?: "cache" | "emit" | "ignore";

package/dist/browser/modules/excel/stream/workbook-reader.browser.js

@@ -8,14 +8,17 @@
  * Node.js uses `workbook-reader.ts`, which extends the same base implementation
  * with filesystem-specific features (filename input + temp-file buffering).
  */
-import { EventEmitter, Readable } from "../../stream/index.browser.js";
+import { Readable } from "../../stream/index.browser.js";
+import { EventEmitter } from "../../../utils/event-emitter.js";
 import { createParse } from "../../archive/unzip/stream.browser.js";
+import { ExcelFileError } from "../errors.js";
 import { iterateStream } from "../utils/iterate-stream.js";
 import { getWorksheetNoFromWorksheetPath, getWorksheetNoFromWorksheetRelsPath, normalizeZipPath, OOXML_PATHS, worksheetRelTarget } from "../utils/ooxml-paths.js";
 import { parseSax } from "../utils/parse-sax.js";
 import { StylesXform } from "../xlsx/xform/style/styles-xform.js";
 import { WorkbookXform } from "../xlsx/xform/book/workbook-xform.js";
 import { RelationshipsXform } from "../xlsx/xform/core/relationships-xform.js";
+import { decodeOoxmlEscape } from "../../../utils/utils.browser.js";
 import { WorksheetReader } from "./worksheet-reader.js";
 import { HyperlinkReader } from "./hyperlink-reader.js";
 // ============================================================================
@@ -68,7 +71,7 @@ export class WorkbookReaderBase extends EventEmitter {
                 });
             }
             catch {
-                throw new Error("Could not recognise input: ReadableStream");
+                throw new ExcelFileError("<ReadableStream>", "read", "Could not recognise input");
             }
         }
         let data = input;
@@ -79,7 +82,7 @@ export class WorkbookReaderBase extends EventEmitter {
             // Cross-platform: both Node's Readable and our browser Readable implement `.from()`.
             return Readable.from([data]);
         }
-        throw new Error(`Could not recognise input: ${input}`);
+        throw new ExcelFileError(String(input), "read", "Could not recognise input");
     }
     _cleanupWaitingWorksheets(_waitingWorksheets) {
         // Default: attempt best-effort cleanup if the stored object provides it.
@@ -280,6 +283,14 @@ export class WorkbookReaderBase extends EventEmitter {
                 else if (eventType === "closetag") {
                     const node = value;
                     switch (node.name) {
+                        case "t":
+                            // Decode OOXML _xHHHH_ escapes when closing <t> elements.
+                            // This covers both plain text (<si><t>...</t></si>) and
+                            // rich text runs (<si><r>...<t>...</t></r></si>).
+                            if (text != null) {
+                                text = decodeOoxmlEscape(text);
+                            }
+                            break;
                         case "r":
                             if (inRichText) {
                                 richText.push({ font, text });

package/dist/browser/modules/excel/stream/workbook-reader.d.ts

@@ -3,11 +3,11 @@
  *
  * Extends base with file path support and temp file storage for large files.
  */
-import type { Readable } from "@stream";
-import { WorksheetReader } from "@excel/stream/worksheet-reader";
-import { HyperlinkReader } from "@excel/stream/hyperlink-reader";
-import { WorkbookReaderBase, type CommonInput, type WorkbookReaderOptions, type WorksheetReadyEvent, WorkbookReaderOptionsSchema } from "@excel/stream/workbook-reader.browser";
-export type { WorkbookReaderOptions, InternalWorksheetOptions, SharedStringRichText, SharedStringValue, WorkbookRelationship, SheetMetadata, WorkbookModel, WorkbookPropertiesXform, ParseEventType, SharedStringEvent, WorksheetReadyEvent, HyperlinksEvent, ParseEvent } from "@excel/stream/workbook-reader.browser";
+import type { Readable } from "../../stream/index.js";
+import { WorksheetReader } from "./worksheet-reader.js";
+import { HyperlinkReader } from "./hyperlink-reader.js";
+import { WorkbookReaderBase, type CommonInput, type WorkbookReaderOptions, type WorksheetReadyEvent, WorkbookReaderOptionsSchema } from "./workbook-reader.browser.js";
+export type { WorkbookReaderOptions, InternalWorksheetOptions, SharedStringRichText, SharedStringValue, WorkbookRelationship, SheetMetadata, WorkbookModel, WorkbookPropertiesXform, ParseEventType, SharedStringEvent, WorksheetReadyEvent, HyperlinksEvent, ParseEvent } from "./workbook-reader.browser.js";
 export type NodeInput = string | CommonInput;
 interface WaitingWorksheet {
     sheetNo: string;

package/dist/browser/modules/excel/stream/workbook-reader.js

@@ -3,9 +3,8 @@
  *
  * Extends base with file path support and temp file storage for large files.
  */
-import fs from "fs";
-import os from "os";
 import { join } from "path";
+import { createReadStream, createWriteStream, createTempDirSync, remove } from "../../../utils/fs.browser.js";
 import { iterateStream } from "../utils/iterate-stream.js";
 import { WorksheetReader } from "./worksheet-reader.js";
 import { HyperlinkReader } from "./hyperlink-reader.js";
@@ -17,26 +16,28 @@ class WorkbookReader extends WorkbookReaderBase {
     }
     _getStream(input) {
         if (typeof input === "string") {
-            return fs.createReadStream(input);
+            return createReadStream(input);
         }
         return super._getStream(input);
     }
     async _storeWaitingWorksheet(sheetNo, entry) {
-        const tmpDir = fs.mkdtempSync(join(os.tmpdir(), "excelts-"));
-        const path = join(tmpDir, `sheet${sheetNo}.xml`);
-        const cleanup = () => fs.rm(tmpDir, { recursive: true, force: true }, () => { });
+        const tmpDir = createTempDirSync("excelts-");
+        const filePath = join(tmpDir, `sheet${sheetNo}.xml`);
+        const cleanup = () => {
+            remove(tmpDir).catch(() => { });
+        };
         const writePromise = new Promise((resolve, reject) => {
-            const tempStream = fs.createWriteStream(path);
+            const tempStream = createWriteStream(filePath);
             tempStream.on("error", reject);
             tempStream.on("finish", resolve);
             entry.pipe(tempStream);
         });
-        return { sheetNo, path, cleanup, writePromise };
+        return { sheetNo, path: filePath, cleanup, writePromise };
     }
     async *_processWaitingWorksheets(waitingWorksheets) {
         for (const ws of waitingWorksheets) {
             await ws.writePromise;
-            const fileStream = fs.createReadStream(ws.path);
+            const fileStream = createReadStream(ws.path);
             try {
                 yield* this._parseWorksheet(iterateStream(fileStream), ws.sheetNo);
             }

package/dist/browser/modules/excel/stream/workbook-writer.browser.d.ts

@@ -7,14 +7,14 @@
  * Node.js uses `workbook-writer.ts`, which extends the same base implementation
  * with filesystem-specific features (filename output + image loading).
  */
-import { Zip } from "@archive/zip/stream";
-import { StylesXform } from "@excel/xlsx/xform/style/styles-xform";
-import { SharedStrings } from "@excel/utils/shared-strings";
-import { DefinedNames } from "@excel/defined-names";
-import type { Writable } from "@stream";
-import type { Image, WorkbookView, AddWorksheetOptions } from "@excel/types";
-import { WorksheetWriter } from "@excel/stream/worksheet-writer";
-interface Medium extends Image {
+import { Zip } from "../../archive/zip/stream.js";
+import { StylesXform } from "../xlsx/xform/style/styles-xform.js";
+import { SharedStrings } from "../utils/shared-strings.js";
+import { DefinedNames } from "../defined-names.js";
+import type { Writable } from "../../stream/index.js";
+import type { ImageData, WorkbookView, AddWorksheetOptions } from "../types.js";
+import { WorksheetWriter } from "./worksheet-writer.js";
+interface Medium extends ImageData {
     type: "image";
     name: string;
 }
@@ -32,7 +32,7 @@ export interface ZlibOptions {
     strategy?: number;
     dictionary?: Uint8Array | ArrayBuffer;
 }
-export interface ZipOptions {
+export interface WorkbookZipOptions {
     comment?: string;
     forceLocalTime?: boolean;
     forceZip64?: boolean;
@@ -42,6 +42,8 @@ export interface ZipOptions {
         level?: number;
     };
 }
+/** @deprecated Use {@link WorkbookZipOptions} instead */
+export type ZipOptions = WorkbookZipOptions;
 export interface WorkbookWriterOptions {
     created?: Date;
     modified?: Date;
@@ -50,7 +52,7 @@ export interface WorkbookWriterOptions {
     lastPrinted?: Date;
     useSharedStrings?: boolean;
     useStyles?: boolean;
-    zip?: Partial<ZipOptions>;
+    zip?: Partial<WorkbookZipOptions>;
     stream?: Writable | WritableStream<Uint8Array>;
     filename?: string;
     trueStreaming?: boolean;
@@ -96,13 +98,13 @@ export declare abstract class WorkbookWriterBase<TWorksheetWriter extends Worksh
     private _definedNames;
     private _worksheets;
     views: WorkbookView[];
-    zipOptions?: Partial<ZipOptions>;
+    zipOptions?: Partial<WorkbookZipOptions>;
     compressionLevel: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
     media: Medium[];
     commentRefs: CommentRef[];
     zip: Zip;
     stream: OutputStreamLike;
-    promise: Promise<void[]>;
+    promise: Promise<void[] | void>;
     protected _trueStreaming: boolean;
     protected WorksheetWriterClass: WorksheetWriterConstructor<TWorksheetWriter>;
     constructor(options: WorkbookWriterOptions, WorksheetWriterClass: WorksheetWriterConstructor<TWorksheetWriter>);
@@ -115,8 +117,8 @@ export declare abstract class WorkbookWriterBase<TWorksheetWriter extends Worksh
     private _commitWorksheets;
     commit(): Promise<void>;
     get nextId(): number;
-    addImage(image: Image): number;
-    getImage(id: number): Image | undefined;
+    addImage(image: ImageData): number;
+    getImage(id: number): ImageData | undefined;
     addWorksheet(name?: string, options?: Partial<AddWorksheetOptions>): TWorksheetWriter;
     getWorksheet(id?: string | number): TWorksheetWriter | undefined;
     addStyles(): Promise<void>;

package/dist/browser/modules/excel/stream/workbook-writer.browser.js

@@ -10,6 +10,7 @@
 import { Zip, ZipDeflate } from "../../archive/zip/stream.js";
 import { StreamBuf } from "../utils/stream-buf.js";
 import { base64ToUint8Array } from "../../../utils/utils.browser.js";
+import { ExcelNotSupportedError, ImageError } from "../errors.js";
 import { RelType } from "../xlsx/rel-type.js";
 import { StylesXform } from "../xlsx/xform/style/styles-xform.js";
 import { SharedStrings } from "../utils/shared-strings.js";
@@ -22,7 +23,8 @@ import { WorkbookXform } from "../xlsx/xform/book/workbook-xform.js";
 import { SharedStringsXform } from "../xlsx/xform/strings/shared-strings-xform.js";
 import { FeaturePropertyBagXform } from "../xlsx/xform/core/feature-property-bag-xform.js";
 import { theme1Xml } from "../xlsx/xml/theme1.js";
-import { Writeable, stringToUint8Array } from "../../stream/index.browser.js";
+import { toWritable } from "../../stream/index.browser.js";
+import { stringToUint8Array } from "../../../utils/binary.js";
 import { mediaPath, OOXML_PATHS, OOXML_REL_TARGETS, worksheetRelTarget } from "../utils/ooxml-paths.js";
 import { WorksheetWriter } from "./worksheet-writer.js";
 const EMPTY_U8 = new Uint8Array(0);
@@ -65,15 +67,18 @@ export class WorkbookWriterBase {
         });
         // Setup output stream
         this.stream = this._createOutputStream(options);
-        // Add initial files
-        this.promise = Promise.all([this.addThemes(), this.addOfficeRels()]);
+        // Theme and office rels are deferred to commit() so that worksheet files
+        // are added to the ZIP first. This ensures StreamingZip sets ondata on
+        // the worksheet immediately, allowing pushSync to flow data through
+        // without accumulating in _dataQueue.
+        this.promise = Promise.resolve();
     }
     /**
      * Create output stream - can be overridden by Node.js to support filename
      */
     _createOutputStream(options) {
         if (options.stream) {
-            return Writeable(options.stream);
+            return toWritable(options.stream);
         }
         return new StreamBuf();
     }
@@ -131,6 +136,8 @@ export class WorkbookWriterBase {
         await this._commitWorksheets();
         await this.addMedia();
         await Promise.all([
+            this.addThemes(),
+            this.addOfficeRels(),
             this.addContentTypes(),
             this.addApp(),
             this.addCore(),
@@ -260,10 +267,10 @@ export class WorkbookWriterBase {
                     return;
                 }
                 if (medium.filename) {
-                    throw new Error("Loading images from filename is not supported in browser. Use buffer or base64.");
+                    throw new ExcelNotSupportedError("Loading images from filename", "not supported in browser. Use buffer or base64.");
                 }
             }
-            throw new Error("Unsupported media");
+            throw new ImageError("Unsupported media");
         }));
     }
     addApp() {

package/dist/browser/modules/excel/stream/workbook-writer.d.ts

@@ -3,9 +3,9 @@
  *
  * Extends base with file path support and file system image loading.
  */
-import { WorksheetWriter } from "@excel/stream/worksheet-writer";
-import { WorkbookWriterBase, type WorkbookWriterOptions as BaseOptions, type ZipOptions, type ZlibOptions } from "@excel/stream/workbook-writer.browser";
-export type { ZipOptions, ZlibOptions };
+import { WorksheetWriter } from "./worksheet-writer.js";
+import { WorkbookWriterBase, type WorkbookWriterOptions as BaseOptions, type WorkbookZipOptions, type ZipOptions, type ZlibOptions } from "./workbook-writer.browser.js";
+export type { WorkbookZipOptions, ZipOptions, ZlibOptions };
 export interface WorkbookWriterOptions extends BaseOptions {
     /** If stream not specified, this field specifies the path to a file to write the XLSX workbook to */
     filename?: string;