@cj-tech-master/excelts 3.1.0 → 4.0.0-canary.20260103013222.0e5d37f

package/dist/types/modules/excel/xlsx/xform/pivot-table/pivot-cache-records-xform.d.ts

@@ -0,0 +1,73 @@
+import { BaseXform } from "../base-xform";
+import type { PivotTableSource } from "../../../pivot-table";
+/**
+ * Model for generating pivot cache records (with live source)
+ */
+interface CacheRecordsModel {
+    source: PivotTableSource;
+    cacheFields: any[];
+}
+/**
+ * Parsed record value - can be:
+ * - { type: 'x', value: number } - Shared item index
+ * - { type: 'n', value: number } - Numeric value
+ * - { type: 's', value: string } - String value
+ * - { type: 'b', value: boolean } - Boolean value
+ * - { type: 'm' } - Missing/null value
+ * - { type: 'd', value: Date } - Date value
+ * - { type: 'e', value: string } - Error value
+ */
+interface RecordValue {
+    type: "x" | "n" | "s" | "b" | "m" | "d" | "e";
+    value?: any;
+}
+/**
+ * Parsed cache records model
+ */
+interface ParsedCacheRecordsModel {
+    records: RecordValue[][];
+    count: number;
+    isLoaded?: boolean;
+}
+declare class PivotCacheRecordsXform extends BaseXform {
+    map: {
+        [key: string]: any;
+    };
+    model: ParsedCacheRecordsModel | null;
+    private currentRecord;
+    constructor();
+    prepare(_model: any): void;
+    get tag(): string;
+    reset(): void;
+    /**
+     * Render pivot cache records XML.
+     * Supports both newly created models (with PivotTableSource) and loaded models.
+     */
+    render(xmlStream: any, model: CacheRecordsModel | ParsedCacheRecordsModel): void;
+    /**
+     * Render newly created pivot cache records
+     */
+    private renderNew;
+    /**
+     * Render loaded pivot cache records
+     */
+    private renderLoaded;
+    /**
+     * Render a single record value to XML
+     */
+    private renderRecordValue;
+    private renderTableNew;
+    private renderCellNew;
+    parseOpen(node: any): boolean;
+    parseText(_text: string): void;
+    parseClose(name: string): boolean;
+    reconcile(_model: any, _options: any): void;
+    static PIVOT_CACHE_RECORDS_ATTRIBUTES: {
+        xmlns: string;
+        "xmlns:r": string;
+        "xmlns:mc": string;
+        "mc:Ignorable": string;
+        "xmlns:xr": string;
+    };
+}
+export { PivotCacheRecordsXform, type ParsedCacheRecordsModel };

package/dist/types/modules/excel/xlsx/xform/sheet/merges.d.ts

@@ -0,0 +1,14 @@
+interface MergeData {
+    address: string;
+    master: string;
+}
+declare class Merges {
+    private merges;
+    private hash?;
+    constructor();
+    add(merge: MergeData): void;
+    get mergeCells(): string[];
+    reconcile(mergeCells: string[], rows: any[]): void;
+    getMasterAddress(address: string): string | undefined;
+}
+export { Merges };

package/dist/types/modules/excel/xlsx/xlsx.browser.d.ts

@@ -0,0 +1,208 @@
+/**
+ * XLSX - Abstract base class for XLSX operations
+ *
+ * Contains all platform-agnostic logic shared between Node.js and Browser versions:
+ * - reconcile: Reconcile model after parsing
+ * - _process*Entry: Process individual ZIP entries
+ * - add*: Add content to ZIP during writing
+ * - prepareModel: Prepare model for writing
+ * - loadFromFiles: Load from pre-extracted ZIP data
+ */
+import { type IEventEmitter } from "../../stream/index";
+import type { Workbook } from "../workbook";
+import type { ZipTimestampMode } from "../../archive/utils/timestamps";
+type StreamListener = Parameters<IEventEmitter["on"]>[1];
+interface EmitterLike {
+    on(event: string, listener: StreamListener): this;
+    once(event: string, listener: StreamListener): this;
+    off(event: string, listener: StreamListener): this;
+}
+export interface IParseStream extends EmitterLike {
+    pipe(dest: any): any;
+    [Symbol.asyncIterator]?: () => AsyncIterator<Uint8Array | string>;
+}
+export interface IStreamBuf extends EmitterLike {
+    write(data: any): void;
+    end(): void;
+    read(): any;
+    toBuffer?(): any;
+    pipe?(dest: any): any;
+}
+export interface IZipWriter extends EmitterLike {
+    append(data: any, options: {
+        name: string;
+        base64?: boolean;
+    }): void;
+    pipe(stream: any): void;
+    finalize(): void;
+}
+export interface XlsxReadOptions {
+    base64?: boolean;
+    [key: string]: unknown;
+}
+export interface ZipWriterOptions {
+    level?: number;
+    /** ZIP entry modification time (optional). If omitted, defaults to current time. */
+    modTime?: Date;
+    /** Timestamp writing strategy for ZIP entry metadata (optional). */
+    timestamps?: ZipTimestampMode;
+}
+export interface XlsxWriteOptions {
+    zip?: ZipWriterOptions;
+    [key: string]: unknown;
+}
+export type XlsxOptions = XlsxReadOptions & XlsxWriteOptions;
+export interface WorkbookMediaLike {
+    type: string;
+    extension: string;
+    name?: string;
+    filename?: string;
+    buffer?: Uint8Array;
+    base64?: string;
+}
+export interface MediaModel {
+    media: WorkbookMediaLike[];
+}
+interface ZipEntryLike {
+    name: string;
+    type: "Directory" | "File";
+    stream: IParseStream;
+    drain: () => Promise<void>;
+}
+/**
+ * XLSX class - handles Excel file operations
+ * Works in both Node.js and Browser environments
+ */
+declare class XLSX {
+    workbook: Workbook;
+    static RelType: {
+        OfficeDocument: string;
+        Worksheet: string;
+        CalcChain: string;
+        SharedStrings: string;
+        Styles: string;
+        Theme: string;
+        Hyperlink: string;
+        Image: string;
+        CoreProperties: string;
+        ExtenderProperties: string;
+        Comments: string;
+        VmlDrawing: string;
+        Table: string;
+        PivotCacheDefinition: string;
+        PivotCacheRecords: string;
+        PivotTable: string;
+    };
+    constructor(workbook: Workbook);
+    /**
+     * Create a stream from binary data (for media/themes)
+     */
+    protected createBinaryStream(data: Uint8Array): IParseStream;
+    /**
+     * Create a stream from string content (for XML parsing)
+     */
+    protected createTextStream(content: string): IParseStream;
+    /**
+     * Create a StreamBuf instance for buffering data
+     */
+    protected createStreamBuf(): IStreamBuf;
+    /**
+     * Convert buffer/Uint8Array to string
+     */
+    protected bufferToString(data: string | ArrayBuffer | Uint8Array): string;
+    /**
+     * Create a ZIP writer adapter.
+     * Can be overridden by subclasses for platform-specific implementations.
+     */
+    protected createZipWriter(options?: XlsxWriteOptions["zip"]): IZipWriter;
+    /**
+     * Write all workbook content to a ZIP writer
+     * Shared by both Node.js write() and browser writeBuffer()
+     */
+    protected writeToZip(zip: IZipWriter, options?: XlsxWriteOptions): Promise<void>;
+    /**
+     * Read workbook from a stream
+     */
+    read(stream: IParseStream, options?: XlsxReadOptions): Promise<any>;
+    /**
+     * Write workbook to a stream
+     */
+    write(stream: any, options?: XlsxWriteOptions): Promise<XLSX>;
+    /**
+     * Load workbook from buffer/ArrayBuffer/Uint8Array
+     */
+    load(data: any, options?: XlsxReadOptions): Promise<any>;
+    /**
+     * Internal: Load from Uint8Array buffer
+     */
+    protected loadBuffer(buffer: Uint8Array, options?: XlsxReadOptions): Promise<any>;
+    /**
+     * Internal: Load workbook from an async stream of ZIP entries.
+     *
+     * This is the foundation for TRUE streaming reads on platforms that have a
+     * streaming ZIP parser (e.g. Node.js `modules/archive` Parse).
+     */
+    protected loadFromZipEntries(entries: AsyncIterable<ZipEntryLike>, options?: XlsxOptions): Promise<any>;
+    /**
+     * Write workbook to buffer
+     */
+    writeBuffer(options?: XlsxWriteOptions): Promise<Uint8Array>;
+    /**
+     * Add media files to ZIP
+     * Supports buffer, base64, and filename (if readFileAsync is provided)
+     */
+    addMedia(zip: IZipWriter, model: MediaModel): Promise<void>;
+    /**
+     * Optional file reader - can be overridden by subclasses (e.g., Node.js version)
+     */
+    protected readFileAsync?: (filename: string) => Promise<Uint8Array>;
+    parseRels(stream: IParseStream): Promise<any>;
+    parseWorkbook(stream: IParseStream): Promise<any>;
+    parseSharedStrings(stream: IParseStream): Promise<any>;
+    reconcile(model: any, options?: XlsxOptions): void;
+    /**
+     * Reconcile pivot tables by linking them to worksheets and their cache data.
+     */
+    protected _reconcilePivotTables(model: any): void;
+    protected _extractTableNumber(name: string): number;
+    protected _buildCacheIdMap(model: any): Map<string, number>;
+    protected _buildDefinitionToCacheIdMap(model: any): Map<string, number>;
+    protected _determineMetric(dataFields: Array<{
+        subtotal?: string;
+    }>): "sum" | "count";
+    _processWorksheetEntry(stream: IParseStream, model: any, sheetNo: number, options: XlsxOptions | undefined, path: string): Promise<void>;
+    _processCommentEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    _processTableEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    _processWorksheetRelsEntry(stream: IParseStream, model: any, sheetNo: number): Promise<void>;
+    _processMediaEntry(stream: IParseStream, model: any, filename: string): Promise<void>;
+    _processDrawingEntry(entry: any, model: any, name: string): Promise<void>;
+    _processDrawingRelsEntry(entry: any, model: any, name: string): Promise<void>;
+    _processVmlDrawingEntry(entry: any, model: any, name: string): Promise<void>;
+    _processThemeEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    _processPivotTableEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    _processPivotTableRelsEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    _processPivotCacheDefinitionEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    _processPivotCacheDefinitionRelsEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    _processPivotCacheRecordsEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    loadFromFiles(zipData: Record<string, Uint8Array>, options?: any): Promise<any>;
+    /**
+     * Process default entries (drawings, comments, tables, etc.)
+     */
+    protected _processDefaultEntry(stream: IParseStream, model: any, entryName: string): Promise<boolean>;
+    addContentTypes(zip: IZipWriter, model: any): Promise<void>;
+    addApp(zip: IZipWriter, model: any): Promise<void>;
+    addCore(zip: IZipWriter, model: any): Promise<void>;
+    addThemes(zip: IZipWriter, model: any): Promise<void>;
+    addOfficeRels(zip: IZipWriter, _model: any): Promise<void>;
+    addWorkbookRels(zip: IZipWriter, model: any): Promise<void>;
+    addSharedStrings(zip: IZipWriter, model: any): Promise<void>;
+    addStyles(zip: IZipWriter, model: any): Promise<void>;
+    addWorkbook(zip: IZipWriter, model: any): Promise<void>;
+    addWorksheets(zip: IZipWriter, model: any): Promise<void>;
+    addDrawings(zip: IZipWriter, model: any): void;
+    addTables(zip: IZipWriter, model: any): void;
+    addPivotTables(zip: IZipWriter, model: any): void;
+    _finalize(zip: IZipWriter): Promise<this>;
+    prepareModel(model: any, options: any): void;
+}
+export { XLSX };

package/dist/types/modules/excel/xlsx/xlsx.d.ts

@@ -0,0 +1,24 @@
+/**
+ * XLSX - Node.js version with full functionality
+ *
+ * Extends XLSX with:
+ * - readFile: Read from file path
+ * - writeFile: Write to file path
+ * - Constructor injects readFileAsync for filename-based media loading
+ *
+ * Inherited from XLSX:
+ * - read: Read from stream
+ * - write: Write to stream
+ * - load: Load from buffer
+ * - writeBuffer: Write to buffer (Uint8Array)
+ * - addMedia: Supports buffer, base64, and filename (via readFileAsync)
+ */
+import { XLSX as XLSXBase } from "./xlsx.browser";
+declare class XLSX extends XLSXBase {
+    constructor(workbook: any);
+    private static iterateZipEntries;
+    read(stream: any, options?: any): Promise<any>;
+    readFile(filename: string, options?: any): Promise<any>;
+    writeFile(filename: string, options?: any): Promise<void>;
+}
+export { XLSX };

package/dist/types/modules/excel/xlsx/xml/theme1.d.ts

@@ -0,0 +1 @@
+export declare const theme1Xml = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<a:theme xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" name=\"Office Theme\"> <a:themeElements> <a:clrScheme name=\"Office\"> <a:dk1> <a:sysClr val=\"windowText\" lastClr=\"000000\"/> </a:dk1> <a:lt1> <a:sysClr val=\"window\" lastClr=\"FFFFFF\"/> </a:lt1> <a:dk2> <a:srgbClr val=\"1F497D\"/> </a:dk2> <a:lt2> <a:srgbClr val=\"EEECE1\"/> </a:lt2> <a:accent1> <a:srgbClr val=\"4F81BD\"/> </a:accent1> <a:accent2> <a:srgbClr val=\"C0504D\"/> </a:accent2> <a:accent3> <a:srgbClr val=\"9BBB59\"/> </a:accent3> <a:accent4> <a:srgbClr val=\"8064A2\"/> </a:accent4> <a:accent5> <a:srgbClr val=\"4BACC6\"/> </a:accent5> <a:accent6> <a:srgbClr val=\"F79646\"/> </a:accent6> <a:hlink> <a:srgbClr val=\"0000FF\"/> </a:hlink> <a:folHlink> <a:srgbClr val=\"800080\"/> </a:folHlink> </a:clrScheme> <a:fontScheme name=\"Office\"> <a:majorFont> <a:latin typeface=\"Cambria\"/> <a:ea typeface=\"\"/> <a:cs typeface=\"\"/> <a:font script=\"Jpan\" typeface=\"\uFF2D\uFF33 \uFF30\u30B4\u30B7\u30C3\u30AF\"/> <a:font script=\"Hang\" typeface=\"\uB9D1\uC740 \uACE0\uB515\"/> <a:font script=\"Hans\" typeface=\"\u5B8B\u4F53\"/> <a:font script=\"Hant\" typeface=\"\u65B0\u7D30\u660E\u9AD4\"/> <a:font script=\"Arab\" typeface=\"Times New Roman\"/> <a:font script=\"Hebr\" typeface=\"Times New Roman\"/> <a:font script=\"Thai\" typeface=\"Tahoma\"/> <a:font script=\"Ethi\" typeface=\"Nyala\"/> <a:font script=\"Beng\" typeface=\"Vrinda\"/> <a:font script=\"Gujr\" typeface=\"Shruti\"/> <a:font script=\"Khmr\" typeface=\"MoolBoran\"/> <a:font script=\"Knda\" typeface=\"Tunga\"/> <a:font script=\"Guru\" typeface=\"Raavi\"/> <a:font script=\"Cans\" typeface=\"Euphemia\"/> <a:font script=\"Cher\" typeface=\"Plantagenet Cherokee\"/> <a:font script=\"Yiii\" typeface=\"Microsoft Yi Baiti\"/> <a:font script=\"Tibt\" typeface=\"Microsoft Himalaya\"/> <a:font script=\"Thaa\" typeface=\"MV Boli\"/> <a:font script=\"Deva\" typeface=\"Mangal\"/> <a:font script=\"Telu\" typeface=\"Gautami\"/> <a:font script=\"Taml\" typeface=\"Latha\"/> <a:font script=\"Syrc\" typeface=\"Estrangelo Edessa\"/> <a:font script=\"Orya\" typeface=\"Kalinga\"/> <a:font script=\"Mlym\" typeface=\"Kartika\"/> <a:font script=\"Laoo\" typeface=\"DokChampa\"/> <a:font script=\"Sinh\" typeface=\"Iskoola Pota\"/> <a:font script=\"Mong\" typeface=\"Mongolian Baiti\"/> <a:font script=\"Viet\" typeface=\"Times New Roman\"/> <a:font script=\"Uigh\" typeface=\"Microsoft Uighur\"/> <a:font script=\"Geor\" typeface=\"Sylfaen\"/> </a:majorFont> <a:minorFont> <a:latin typeface=\"Calibri\"/> <a:ea typeface=\"\"/> <a:cs typeface=\"\"/> <a:font script=\"Jpan\" typeface=\"\uFF2D\uFF33 \uFF30\u30B4\u30B7\u30C3\u30AF\"/> <a:font script=\"Hang\" typeface=\"\uB9D1\uC740 \uACE0\uB515\"/> <a:font script=\"Hans\" typeface=\"\u5B8B\u4F53\"/> <a:font script=\"Hant\" typeface=\"\u65B0\u7D30\u660E\u9AD4\"/> <a:font script=\"Arab\" typeface=\"Arial\"/> <a:font script=\"Hebr\" typeface=\"Arial\"/> <a:font script=\"Thai\" typeface=\"Tahoma\"/> <a:font script=\"Ethi\" typeface=\"Nyala\"/> <a:font script=\"Beng\" typeface=\"Vrinda\"/> <a:font script=\"Gujr\" typeface=\"Shruti\"/> <a:font script=\"Khmr\" typeface=\"DaunPenh\"/> <a:font script=\"Knda\" typeface=\"Tunga\"/> <a:font script=\"Guru\" typeface=\"Raavi\"/> <a:font script=\"Cans\" typeface=\"Euphemia\"/> <a:font script=\"Cher\" typeface=\"Plantagenet Cherokee\"/> <a:font script=\"Yiii\" typeface=\"Microsoft Yi Baiti\"/> <a:font script=\"Tibt\" typeface=\"Microsoft Himalaya\"/> <a:font script=\"Thaa\" typeface=\"MV Boli\"/> <a:font script=\"Deva\" typeface=\"Mangal\"/> <a:font script=\"Telu\" typeface=\"Gautami\"/> <a:font script=\"Taml\" typeface=\"Latha\"/> <a:font script=\"Syrc\" typeface=\"Estrangelo Edessa\"/> <a:font script=\"Orya\" typeface=\"Kalinga\"/> <a:font script=\"Mlym\" typeface=\"Kartika\"/> <a:font script=\"Laoo\" typeface=\"DokChampa\"/> <a:font script=\"Sinh\" typeface=\"Iskoola Pota\"/> <a:font script=\"Mong\" typeface=\"Mongolian Baiti\"/> <a:font script=\"Viet\" typeface=\"Arial\"/> <a:font script=\"Uigh\" typeface=\"Microsoft Uighur\"/> <a:font script=\"Geor\" typeface=\"Sylfaen\"/> </a:minorFont> </a:fontScheme> <a:fmtScheme name=\"Office\"> <a:fillStyleLst> <a:solidFill> <a:schemeClr val=\"phClr\"/> </a:solidFill> <a:gradFill rotWithShape=\"1\"> <a:gsLst> <a:gs pos=\"0\"> <a:schemeClr val=\"phClr\"> <a:tint val=\"50000\"/> <a:satMod val=\"300000\"/> </a:schemeClr> </a:gs> <a:gs pos=\"35000\"> <a:schemeClr val=\"phClr\"> <a:tint val=\"37000\"/> <a:satMod val=\"300000\"/> </a:schemeClr> </a:gs> <a:gs pos=\"100000\"> <a:schemeClr val=\"phClr\"> <a:tint val=\"15000\"/> <a:satMod val=\"350000\"/> </a:schemeClr> </a:gs> </a:gsLst> <a:lin ang=\"16200000\" scaled=\"1\"/> </a:gradFill> <a:gradFill rotWithShape=\"1\"> <a:gsLst> <a:gs pos=\"0\"> <a:schemeClr val=\"phClr\"> <a:tint val=\"100000\"/> <a:shade val=\"100000\"/> <a:satMod val=\"130000\"/> </a:schemeClr> </a:gs> <a:gs pos=\"100000\"> <a:schemeClr val=\"phClr\"> <a:tint val=\"50000\"/> <a:shade val=\"100000\"/> <a:satMod val=\"350000\"/> </a:schemeClr> </a:gs> </a:gsLst> <a:lin ang=\"16200000\" scaled=\"0\"/> </a:gradFill> </a:fillStyleLst> <a:lnStyleLst> <a:ln w=\"9525\" cap=\"flat\" cmpd=\"sng\" algn=\"ctr\"> <a:solidFill> <a:schemeClr val=\"phClr\"> <a:shade val=\"95000\"/> <a:satMod val=\"105000\"/> </a:schemeClr> </a:solidFill> <a:prstDash val=\"solid\"/> </a:ln> <a:ln w=\"25400\" cap=\"flat\" cmpd=\"sng\" algn=\"ctr\"> <a:solidFill> <a:schemeClr val=\"phClr\"/> </a:solidFill> <a:prstDash val=\"solid\"/> </a:ln> <a:ln w=\"38100\" cap=\"flat\" cmpd=\"sng\" algn=\"ctr\"> <a:solidFill> <a:schemeClr val=\"phClr\"/> </a:solidFill> <a:prstDash val=\"solid\"/> </a:ln> </a:lnStyleLst> <a:effectStyleLst> <a:effectStyle> <a:effectLst> <a:outerShdw blurRad=\"40000\" dist=\"20000\" dir=\"5400000\" rotWithShape=\"0\"> <a:srgbClr val=\"000000\"> <a:alpha val=\"38000\"/> </a:srgbClr> </a:outerShdw> </a:effectLst> </a:effectStyle> <a:effectStyle> <a:effectLst> <a:outerShdw blurRad=\"40000\" dist=\"23000\" dir=\"5400000\" rotWithShape=\"0\"> <a:srgbClr val=\"000000\"> <a:alpha val=\"35000\"/> </a:srgbClr> </a:outerShdw> </a:effectLst> </a:effectStyle> <a:effectStyle> <a:effectLst> <a:outerShdw blurRad=\"40000\" dist=\"23000\" dir=\"5400000\" rotWithShape=\"0\"> <a:srgbClr val=\"000000\"> <a:alpha val=\"35000\"/> </a:srgbClr> </a:outerShdw> </a:effectLst> <a:scene3d> <a:camera prst=\"orthographicFront\"> <a:rot lat=\"0\" lon=\"0\" rev=\"0\"/> </a:camera> <a:lightRig rig=\"threePt\" dir=\"t\"> <a:rot lat=\"0\" lon=\"0\" rev=\"1200000\"/> </a:lightRig> </a:scene3d> <a:sp3d> <a:bevelT w=\"63500\" h=\"25400\"/> </a:sp3d> </a:effectStyle> </a:effectStyleLst> <a:bgFillStyleLst> <a:solidFill> <a:schemeClr val=\"phClr\"/> </a:solidFill> <a:gradFill rotWithShape=\"1\"> <a:gsLst> <a:gs pos=\"0\"> <a:schemeClr val=\"phClr\"> <a:tint val=\"40000\"/> <a:satMod val=\"350000\"/> </a:schemeClr> </a:gs> <a:gs pos=\"40000\"> <a:schemeClr val=\"phClr\"> <a:tint val=\"45000\"/> <a:shade val=\"99000\"/> <a:satMod val=\"350000\"/> </a:schemeClr> </a:gs> <a:gs pos=\"100000\"> <a:schemeClr val=\"phClr\"> <a:shade val=\"20000\"/> <a:satMod val=\"255000\"/> </a:schemeClr> </a:gs> </a:gsLst> <a:path path=\"circle\"> <a:fillToRect l=\"50000\" t=\"-80000\" r=\"50000\" b=\"180000\"/> </a:path> </a:gradFill> <a:gradFill rotWithShape=\"1\"> <a:gsLst> <a:gs pos=\"0\"> <a:schemeClr val=\"phClr\"> <a:tint val=\"80000\"/> <a:satMod val=\"300000\"/> </a:schemeClr> </a:gs> <a:gs pos=\"100000\"> <a:schemeClr val=\"phClr\"> <a:shade val=\"30000\"/> <a:satMod val=\"200000\"/> </a:schemeClr> </a:gs> </a:gsLst> <a:path path=\"circle\"> <a:fillToRect l=\"50000\" t=\"50000\" r=\"50000\" b=\"50000\"/> </a:path> </a:gradFill> </a:bgFillStyleLst> </a:fmtScheme> </a:themeElements> <a:objectDefaults> <a:spDef> <a:spPr/> <a:bodyPr/> <a:lstStyle/> <a:style> <a:lnRef idx=\"1\"> <a:schemeClr val=\"accent1\"/> </a:lnRef> <a:fillRef idx=\"3\"> <a:schemeClr val=\"accent1\"/> </a:fillRef> <a:effectRef idx=\"2\"> <a:schemeClr val=\"accent1\"/> </a:effectRef> <a:fontRef idx=\"minor\"> <a:schemeClr val=\"lt1\"/> </a:fontRef> </a:style> </a:spDef> <a:lnDef> <a:spPr/> <a:bodyPr/> <a:lstStyle/> <a:style> <a:lnRef idx=\"2\"> <a:schemeClr val=\"accent1\"/> </a:lnRef> <a:fillRef idx=\"0\"> <a:schemeClr val=\"accent1\"/> </a:fillRef> <a:effectRef idx=\"1\"> <a:schemeClr val=\"accent1\"/> </a:effectRef> <a:fontRef idx=\"minor\"> <a:schemeClr val=\"tx1\"/> </a:fontRef> </a:style> </a:lnDef> </a:objectDefaults> <a:extraClrSchemeLst/> </a:theme>";

package/dist/types/modules/stream/base-transform.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Base Transform Stream
+ *
+ * Provides a base class for Transform streams.
+ * Works identically in both browser and Node.js environments.
+ */
+import { EventEmitter } from "./event-emitter";
+export interface BaseTransformOptions {
+    /** High water mark for backpressure */
+    highWaterMark?: number;
+    /** Enable object mode (non-binary data) */
+    objectMode?: boolean;
+}
+export type TransformCallback<T = Uint8Array> = (error?: Error | null, data?: T) => void;
+/**
+ * Browser-compatible Base Transform stream
+ */
+export declare abstract class BaseTransform<TInput = Uint8Array, TOutput = Uint8Array> extends EventEmitter {
+    protected _buffer: TInput[];
+    protected _bufferIndex: number;
+    protected _isProcessing: boolean;
+    protected _isDestroyed: boolean;
+    protected _isFinished: boolean;
+    protected _errorEmitted: boolean;
+    protected _objectMode: boolean;
+    protected _highWaterMark: number;
+    constructor(options?: BaseTransformOptions);
+    /**
+     * Main transform implementation - must be overridden by subclasses
+     */
+    abstract processChunk(chunk: TInput, callback: TransformCallback<TOutput>): void;
+    /**
+     * Optional flush implementation for remaining data
+     */
+    processFlush(callback: TransformCallback<TOutput>): void;
+    /**
+     * Write data to the transform stream
+     */
+    write(chunk: TInput): boolean;
+    /**
+     * Signal end of input
+     */
+    end(chunk?: TInput): void;
+    /**
+     * Destroy the stream
+     */
+    destroy(error?: Error): void;
+    /**
+     * Process next chunk in buffer
+     */
+    private _processNext;
+    /**
+     * Emit error only once
+     */
+    private _emitError;
+    /**
+     * Check if stream is in a valid state
+     */
+    get isValid(): boolean;
+    /**
+     * Check if stream has finished
+     */
+    get isFinished(): boolean;
+    /**
+     * Pipe to another transform or collector
+     */
+    pipe<T extends BaseTransform<TOutput, any>>(destination: T): T;
+}

package/dist/types/modules/stream/buffered-stream.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Buffered Stream
+ *
+ * A Duplex-like stream that manages internal buffering with chunk-based read/write operations.
+ * Works identically in both browser and Node.js environments.
+ */
+import { EventEmitter } from "./event-emitter";
+/**
+ * Represents a chunk of data with copy capabilities
+ */
+export interface DataChunk {
+    readonly length: number;
+    copy(target: Uint8Array, targetOffset: number, offset: number, length: number): number;
+    toUint8Array(): Uint8Array;
+}
+/**
+ * String chunk implementation
+ */
+export declare class StringChunk implements DataChunk {
+    private readonly _data;
+    private _buffer?;
+    constructor(data: string);
+    get length(): number;
+    copy(target: Uint8Array, targetOffset: number, offset: number, length: number): number;
+    toUint8Array(): Uint8Array;
+}
+/**
+ * Uint8Array chunk implementation
+ */
+export declare class BufferChunk implements DataChunk {
+    private readonly _data;
+    constructor(data: Uint8Array);
+    get length(): number;
+    copy(target: Uint8Array, targetOffset: number, offset: number, length: number): number;
+    toUint8Array(): Uint8Array;
+}
+export interface BufferedStreamOptions {
+    /** Batch size for internal read-write buffers */
+    batchSize?: number;
+}
+/**
+ * Browser-compatible Buffered Stream with efficient chunk management
+ */
+export declare class BufferedStream extends EventEmitter {
+    private _chunks;
+    private _chunkReadIndex;
+    private _buffers;
+    private _bufferReadIndex;
+    private readonly _batchSize;
+    private _finished;
+    private _destroyed;
+    private _totalLength;
+    constructor(options?: BufferedStreamOptions);
+    /**
+     * Write data to the stream
+     */
+    write(chunk: Uint8Array | string): boolean;
+    /**
+     * Read data from the stream
+     */
+    read(size?: number): Uint8Array | null;
+    /**
+     * Signal end of writes
+     */
+    end(chunk?: Uint8Array | string): void;
+    /**
+     * Destroy the stream
+     */
+    destroy(error?: Error): void;
+    /**
+     * Get total buffered length
+     */
+    get bufferedLength(): number;
+    /**
+     * Get buffer of specified size from internal buffers
+     */
+    private _getBuffer;
+    /**
+     * Add chunk to internal buffers
+     */
+    private _addChunkToBuffers;
+    /**
+     * Get all buffered data as a single Uint8Array
+     */
+    toUint8Array(): Uint8Array;
+    /**
+     * Check if stream is finished
+     */
+    get isFinished(): boolean;
+    /**
+     * Check if stream is destroyed
+     */
+    get destroyed(): boolean;
+}

package/dist/types/modules/stream/chunked-builder.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Chunked Builder (Browser Compatible)
+ *
+ * Browser-compatible version that uses Uint8Array instead of Buffer.
+ * This file provides the same API but works in browser environments.
+ */
+/**
+ * Options for ChunkedBuilder
+ */
+export interface ChunkedBuilderOptions {
+    /** Number of pieces to accumulate before consolidation */
+    chunkSize?: number;
+    /** Initial capacity hint */
+    initialCapacity?: number;
+}
+/**
+ * Efficient builder for accumulating and consolidating string chunks
+ * Browser-compatible version
+ */
+export declare class ChunkedBuilder {
+    protected _pieces: string[];
+    protected _chunks: string[];
+    protected readonly _chunkSize: number;
+    protected _totalLength: number;
+    constructor(options?: ChunkedBuilderOptions);
+    /**
+     * Add a piece to the builder
+     */
+    push(piece: string): void;
+    /**
+     * Add multiple pieces
+     */
+    pushAll(pieces: string[]): void;
+    /**
+     * Consolidate pieces into chunks
+     */
+    private _consolidate;
+    /**
+     * Get current cursor position (useful for tracking changes)
+     */
+    get cursor(): number;
+    /**
+     * Get total piece/chunk count
+     */
+    get length(): number;
+    /**
+     * Get total string length (character count)
+     */
+    get stringLength(): number;
+    /**
+     * Check if empty
+     */
+    get isEmpty(): boolean;
+    /**
+     * Clear all content
+     */
+    clear(): void;
+    /**
+     * Build final string
+     */
+    toString(): string;
+    /**
+     * Convert to Uint8Array (browser-compatible)
+     */
+    toUint8Array(): Uint8Array;
+}
+/**
+ * Snapshot for rollback support
+ */
+export interface BuilderSnapshot {
+    piecesLength: number;
+    chunksLength: number;
+    totalLength: number;
+}
+/**
+ * Chunked builder with rollback/commit support
+ * Browser-compatible version
+ */
+export declare class TransactionalChunkedBuilder extends ChunkedBuilder {
+    private _snapshots;
+    /**
+     * Create a rollback point
+     */
+    snapshot(): BuilderSnapshot;
+    /**
+     * Commit the current snapshot (remove rollback point)
+     */
+    commit(): void;
+    /**
+     * Rollback to the last snapshot
+     */
+    rollback(): void;
+    /**
+     * Check if there are active snapshots
+     */
+    get hasSnapshots(): boolean;
+}

package/dist/types/modules/stream/event-emitter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Event Emitter
+ *
+ * Browser-compatible EventEmitter with a Node.js-like API surface.
+ * Kept lightweight and allocation-lean for hot paths.
+ */
+export type EventListener = (...args: any[]) => void;
+export declare class EventEmitter {
+    readonly __excelts_stream: true;
+    private _listeners;
+    private _maxListeners;
+    static defaultMaxListeners: number;
+    addListener(event: string | symbol, listener: EventListener): this;
+    private _listenerCount;
+    private _hasListeners;
+    on(event: string | symbol, listener: EventListener): this;
+    prependListener(event: string | symbol, listener: EventListener): this;
+    once(event: string | symbol, listener: EventListener): this;
+    prependOnceListener(event: string | symbol, listener: EventListener): this;
+    removeListener(event: string | symbol, listener: EventListener): this;
+    off(event: string | symbol, listener: EventListener): this;
+    emit(event: string | symbol, ...args: any[]): boolean;
+    removeAllListeners(event?: string | symbol): this;
+    listenerCount(event: string | symbol): number;
+    listeners(event: string | symbol): EventListener[];
+    rawListeners(event: string | symbol): EventListener[];
+    eventNames(): (string | symbol)[];
+    setMaxListeners(n: number): this;
+    getMaxListeners(): number;
+}

package/dist/types/modules/stream/index.browser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stream Module (browser type surface)
+ *
+ * Mirrors [src/modules/stream/index.ts] but explicitly re-exports from
+ * ./streams.browser so we can enforce index export-surface parity.
+ */
+import type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions } from "./types";
+export type { ReadableStreamOptions, WritableStreamOptions, TransformStreamOptions, DuplexStreamOptions, PullStreamOptions, BufferedStreamOptions, TransformCallback, FlushCallback, WriteCallback, DestroyCallback, IEventEmitter, IReadable, IWritable, ITransform, IDuplex, IPullStream, IBufferedStream, IPassThrough, ICollector, DataChunk, EventListener, PipelineSource, PipelineTransform, PipelineDestination, ReadWriteBufferOptions };
+import { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, normalizeWritable as Writeable, consumers, promises } from "./streams.browser";
+import type { PipelineOptions, FinishedOptions } from "./streams.browser";
+export { Readable, Writable, Transform, Duplex, PassThrough, Collector, PullStream, BufferedStream, StringChunk, BufferChunk, createReadable, createWritable, createTransform, createCollector, createPassThrough, createPullStream, createBufferedStream, createReadableFromArray, createReadableFromAsyncIterable, createReadableFromGenerator, createReadableFromPromise, createDuplex, createEmptyReadable, createNullWritable, pipeline, finished, streamToPromise, streamToUint8Array, streamToBuffer, streamToString, drainStream, copyStream, addAbortSignal, compose, finishedAll, once, promisify, isReadable, isWritable, isTransform, isDuplex, isStream, isDestroyed, isDisturbed, isErrored, getDefaultHighWaterMark, setDefaultHighWaterMark, duplexPair, Writeable, consumers, promises };
+export type { PipelineOptions, FinishedOptions };
+import { EventEmitter } from "./event-emitter";
+export { EventEmitter };
+import { ChunkedBuilder, TransactionalChunkedBuilder } from "./chunked-builder";
+import type { ChunkedBuilderOptions, BuilderSnapshot } from "./chunked-builder";
+export { ChunkedBuilder, TransactionalChunkedBuilder };
+export type { ChunkedBuilderOptions, BuilderSnapshot };
+import { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays } from "./shared";
+export { textEncoder, textDecoder, stringToUint8Array, uint8ArrayToString, uint8ArrayEquals, uint8ArrayIndexOf, uint8ArraySlice, toUint8Array, bufferToString, concatUint8Arrays };
+import { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter } from "./utils";
+export { collect, text, json, bytes, fromString, fromJSON, fromBytes, transform, filter };