@cj-tech-master/excelts 3.1.0-canary.20260102041828.82ed571 → 3.1.0

package/dist/types/modules/excel/stream/worksheet-writer.d.ts

@@ -1,140 +0,0 @@
-import { Dimensions } from "@excel/range";
-import { StringBuf } from "@excel/utils/string-buf";
-import { Row } from "@excel/row";
-import { Column } from "@excel/column";
-import { SheetRelsWriter } from "@excel/stream/sheet-rels-writer";
-import { SheetCommentsWriter } from "@excel/stream/sheet-comments-writer";
-import { DataValidations } from "@excel/data-validations";
-import type { StreamBuf } from "@excel/utils/stream-buf";
-import type { RowBreak, ColBreak, PageSetup, HeaderFooter, WorksheetProperties, WorksheetView, WorksheetState, AutoFilter, WorksheetProtection, ConditionalFormattingOptions } from "@excel/types";
-interface WorksheetWriterOptions {
-    id: number;
-    name?: string;
-    workbook: any;
-    useSharedStrings?: boolean;
-    properties?: Partial<WorksheetProperties>;
-    state?: WorksheetState;
-    pageSetup?: Partial<PageSetup>;
-    views?: Partial<WorksheetView>[];
-    autoFilter?: AutoFilter;
-    headerFooter?: Partial<HeaderFooter>;
-}
-declare class WorksheetWriter {
-    id: number;
-    name: string;
-    state: WorksheetState;
-    /** Rows stored while being worked on. Set to null after commit. */
-    _rows: Row[] | null;
-    /** Column definitions */
-    _columns: Column[] | null;
-    /** Column keys mapping: key => Column */
-    _keys: {
-        [key: string]: Column;
-    };
-    /** Merged cell ranges */
-    _merges: Dimensions[];
-    _sheetRelsWriter: SheetRelsWriter;
-    _sheetCommentsWriter: SheetCommentsWriter;
-    _dimensions: Dimensions;
-    _rowZero: number;
-    _rowOffset: number;
-    committed: boolean;
-    dataValidations: DataValidations;
-    /** Shared formulae by address */
-    _formulae: {
-        [key: string]: unknown;
-    };
-    _siFormulae: number;
-    conditionalFormatting: ConditionalFormattingOptions[];
-    rowBreaks: RowBreak[];
-    colBreaks: ColBreak[];
-    properties: Partial<WorksheetProperties> & {
-        defaultRowHeight: number;
-        dyDescent?: number;
-        outlineLevelCol: number;
-        outlineLevelRow: number;
-    };
-    headerFooter: Partial<HeaderFooter>;
-    pageSetup: Partial<PageSetup> & {
-        margins: PageSetup["margins"];
-    };
-    useSharedStrings: boolean;
-    _workbook: any;
-    hasComments: boolean;
-    _views: Partial<WorksheetView>[];
-    autoFilter: AutoFilter | null;
-    _media: unknown[];
-    sheetProtection: {
-        sheet?: boolean;
-        algorithmName?: string;
-        saltValue?: string;
-        spinCount?: number;
-        hashValue?: string;
-        [key: string]: unknown;
-    } | null;
-    _stream?: InstanceType<typeof StreamBuf>;
-    startedData: boolean;
-    _background?: {
-        imageId?: number;
-        rId?: string;
-    };
-    _headerRowCount?: number;
-    /** Relationship Id - assigned by WorkbookWriter */
-    rId?: string;
-    constructor(options: WorksheetWriterOptions);
-    get workbook(): any;
-    get stream(): any;
-    destroy(): void;
-    commit(): void;
-    get dimensions(): Dimensions;
-    get views(): Partial<WorksheetView>[];
-    get columns(): Column[] | null;
-    set columns(value: Partial<Column>[]);
-    getColumnKey(key: string): Column | undefined;
-    setColumnKey(key: string, value: Column): void;
-    deleteColumnKey(key: string): void;
-    eachColumnKey(f: (column: Column, key: string) => void): void;
-    getColumn(c: string | number): Column;
-    get _nextRow(): number;
-    eachRow(options: {
-        includeEmpty?: boolean;
-    } | ((row: Row, rowNumber: number) => void), iteratee?: (row: Row, rowNumber: number) => void): void;
-    _commitRow(cRow: Row): void;
-    get lastRow(): Row | undefined;
-    findRow(rowNumber: number): Row | undefined;
-    getRow(rowNumber: number): Row;
-    addRow(value: any[] | Record<string, any>): Row;
-    findCell(r: string | number, c?: number): any;
-    getCell(r: string | number, c?: number): any;
-    mergeCells(...cells: (string | number)[]): void;
-    addConditionalFormatting(cf: ConditionalFormattingOptions): void;
-    removeConditionalFormatting(filter?: number | ((cf: ConditionalFormattingOptions) => boolean)): void;
-    addBackgroundImage(imageId: number): void;
-    getBackgroundImageId(): number | undefined;
-    protect(password?: string, options?: Partial<WorksheetProtection>): Promise<void>;
-    unprotect(): void;
-    _write(text: string): void;
-    _writeSheetProperties(xmlBuf: StringBuf, properties: Partial<WorksheetProperties> | undefined, pageSetup: Partial<PageSetup> | undefined): void;
-    _writeSheetFormatProperties(xmlBuf: StringBuf, properties: Partial<WorksheetProperties> | undefined): void;
-    _writeOpenWorksheet(): void;
-    _writeColumns(): void;
-    _writeOpenSheetData(): void;
-    _writeRow(row: any): void;
-    _writeCloseSheetData(): void;
-    _writeMergeCells(): void;
-    _writeHyperlinks(): void;
-    _writeConditionalFormatting(): void;
-    _writeRowBreaks(): void;
-    _writeColBreaks(): void;
-    _writeDataValidations(): void;
-    _writeSheetProtection(): void;
-    _writePageMargins(): void;
-    _writePageSetup(): void;
-    _writeHeaderFooter(): void;
-    _writeAutoFilter(): void;
-    _writeBackground(): void;
-    _writeLegacyData(): void;
-    _writeDimensions(): void;
-    _writeCloseWorksheet(): void;
-}
-export { WorksheetWriter };

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

@@ -1,81 +0,0 @@
-import type { Address, CellFormulaValue, CellValue, Style, TableColumnProperties, TableStyleProperties } from "@excel/types";
-import type { Worksheet } from "@excel/worksheet";
-interface TableModel {
-    ref: string;
-    name: string;
-    displayName?: string;
-    columns: TableColumnProperties[];
-    rows: CellValue[][];
-    headerRow?: boolean;
-    totalsRow?: boolean;
-    style?: TableStyleProperties;
-    tl?: Address;
-    autoFilterRef?: string;
-    tableRef?: string;
-}
-declare class Column {
-    table: Table;
-    column: TableColumnProperties;
-    index: number;
-    constructor(table: Table, column: TableColumnProperties, index: number);
-    private _set;
-    get name(): string;
-    set name(value: string);
-    get filterButton(): boolean | undefined;
-    set filterButton(value: boolean | undefined);
-    get style(): Partial<Style> | undefined;
-    set style(value: Partial<Style> | undefined);
-    get totalsRowLabel(): string | undefined;
-    set totalsRowLabel(value: string | undefined);
-    get totalsRowFunction(): TableColumnProperties["totalsRowFunction"];
-    set totalsRowFunction(value: TableColumnProperties["totalsRowFunction"]);
-    get totalsRowResult(): CellValue;
-    set totalsRowResult(value: CellFormulaValue["result"]);
-    get totalsRowFormula(): string | undefined;
-    set totalsRowFormula(value: string | undefined);
-}
-declare class Table {
-    worksheet: Worksheet;
-    table: TableModel;
-    private _cache?;
-    constructor(worksheet: Worksheet, table?: TableModel);
-    getFormula(column: TableColumnProperties): string | null;
-    get width(): number;
-    get height(): number;
-    get filterHeight(): number;
-    get tableHeight(): number;
-    validate(): void;
-    store(): void;
-    load(worksheet: Worksheet): void;
-    get model(): TableModel;
-    set model(value: TableModel);
-    cacheState(): void;
-    commit(): void;
-    addRow(values: CellValue[], rowNumber?: number): void;
-    removeRows(rowIndex: number, count?: number): void;
-    getColumn(colIndex: number): Column;
-    addColumn(column: TableColumnProperties, values: CellValue[], colIndex?: number): void;
-    removeColumns(colIndex: number, count?: number): void;
-    private _assign;
-    get ref(): string;
-    set ref(value: string);
-    get name(): string;
-    set name(value: string);
-    get displayName(): string;
-    set displayName(value: string);
-    get headerRow(): boolean | undefined;
-    set headerRow(value: boolean | undefined);
-    get totalsRow(): boolean | undefined;
-    set totalsRow(value: boolean | undefined);
-    get theme(): TableStyleProperties["theme"];
-    set theme(value: TableStyleProperties["theme"]);
-    get showFirstColumn(): boolean | undefined;
-    set showFirstColumn(value: boolean | undefined);
-    get showLastColumn(): boolean | undefined;
-    set showLastColumn(value: boolean | undefined);
-    get showRowStripes(): boolean | undefined;
-    set showRowStripes(value: boolean | undefined);
-    get showColumnStripes(): boolean | undefined;
-    set showColumnStripes(value: boolean | undefined);
-}
-export { Table, type TableModel };

package/dist/types/modules/excel/utils/col-cache.d.ts

@@ -1,36 +0,0 @@
-import type { Address, Location } from "@excel/types";
-type CachedAddress = Address & {
-    $col$row: string;
-};
-export type DecodedRange = Location & {
-    tl: string | CachedAddress;
-    br: string | CachedAddress;
-    dimensions: string;
-    sheetName?: string;
-};
-interface ErrorReference {
-    error: string;
-    sheetName?: string;
-}
-type DecodeExResult = CachedAddress | DecodedRange | ErrorReference;
-interface ColCache {
-    _dictionary: string[];
-    _l2nFill: number;
-    _l2n: Record<string, number>;
-    _n2l: string[];
-    _hash: Record<string, CachedAddress>;
-    _level(n: number): number;
-    _fill(level: number): void;
-    l2n(l: string): number;
-    n2l(n: number): string;
-    validateAddress(value: string): boolean;
-    decodeAddress(value: string): CachedAddress;
-    getAddress(r: number | string, c?: number): CachedAddress;
-    decode(value: string): CachedAddress | DecodedRange;
-    decodeEx(value: string): DecodeExResult;
-    encodeAddress(row: number, col: number): string;
-    encode(...args: number[]): string;
-    inRange(range: number[], address: number[]): boolean;
-}
-declare const colCache: ColCache;
-export { colCache };

package/dist/types/modules/excel/utils/encryptor.browser.d.ts

@@ -1,19 +0,0 @@
-/**
- * Browser-only Encryptor
- * Uses Web Crypto API (hardware accelerated)
- */
-declare const Encryptor: {
-    /**
-     * Calculate hash using Web Crypto API
-     */
-    hash(algorithm: string, ...buffers: Uint8Array[]): Promise<Uint8Array>;
-    /**
-     * Convert password to hash
-     */
-    convertPasswordToHash(password: string, hashAlgorithm: string, saltValue: string, spinCount: number): Promise<string>;
-    /**
-     * Generate cryptographically strong random bytes
-     */
-    randomBytes(size: number): Uint8Array;
-};
-export { Encryptor };

package/dist/types/modules/excel/utils/encryptor.d.ts

@@ -1,9 +0,0 @@
-/**
- * Node.js Encryptor - uses native crypto module
- */
-declare const Encryptor: {
-    hash(algorithm: string, ...buffers: Uint8Array[]): Uint8Array;
-    convertPasswordToHash(password: string, hashAlgorithm: string, saltValue: string, spinCount: number): Promise<string>;
-    randomBytes(size: number): Uint8Array;
-};
-export { Encryptor };

package/dist/types/modules/excel/utils/iterate-stream.d.ts

@@ -1,14 +0,0 @@
-type Listener = (...args: any[]) => void;
-interface EventEmitterLike {
-    on(event: string, listener: Listener): this;
-    removeListener(event: string, listener: Listener): this;
-}
-interface Readable extends EventEmitterLike {
-    resume(): void;
-    pause(): void;
-    on(event: "data", listener: (chunk: any) => void): this;
-    on(event: "end", listener: () => void): this;
-    on(event: "error", listener: (err: Error) => void): this;
-}
-declare function iterateStream(stream: Readable): AsyncGenerator<any>;
-export { iterateStream };

package/dist/types/modules/excel/utils/ooxml-paths.d.ts

@@ -1,64 +0,0 @@
-export declare const OOXML_PATHS: {
-    readonly contentTypes: "[Content_Types].xml";
-    readonly rootRels: "_rels/.rels";
-    readonly docPropsApp: "docProps/app.xml";
-    readonly docPropsCore: "docProps/core.xml";
-    readonly xlWorkbook: "xl/workbook.xml";
-    readonly xlWorkbookRels: "xl/_rels/workbook.xml.rels";
-    readonly xlSharedStrings: "xl/sharedStrings.xml";
-    readonly xlStyles: "xl/styles.xml";
-    readonly xlTheme1: "xl/theme/theme1.xml";
-};
-export declare function normalizeZipPath(path: string): string;
-export declare function getWorksheetNoFromWorksheetPath(path: string): number | undefined;
-export declare function getWorksheetNoFromWorksheetRelsPath(path: string): number | undefined;
-export declare function isMediaPath(path: string): boolean;
-export declare function getMediaFilenameFromPath(path: string): string | undefined;
-export declare function isThemePath(path: string): boolean;
-export declare function getThemeNameFromPath(path: string): string | undefined;
-export declare function isBinaryEntryPath(path: string): boolean;
-export declare function getDrawingNameFromPath(path: string): string | undefined;
-export declare function getDrawingNameFromRelsPath(path: string): string | undefined;
-export declare function getVmlDrawingNameFromPath(path: string): string | undefined;
-export declare function getCommentsIndexFromPath(path: string): string | undefined;
-export declare function getTableNameFromPath(path: string): string | undefined;
-export declare function getPivotTableNameFromPath(path: string): string | undefined;
-export declare function getPivotTableNameFromRelsPath(path: string): string | undefined;
-export declare function getPivotCacheDefinitionNameFromPath(path: string): string | undefined;
-export declare function getPivotCacheDefinitionNameFromRelsPath(path: string): string | undefined;
-export declare function getPivotCacheRecordsNameFromPath(path: string): string | undefined;
-export declare function toContentTypesPartName(zipPath: string): string;
-export declare function themePath(themeName: string): string;
-export declare function mediaPath(filename: string): string;
-export declare function worksheetPath(sheetId: number | string): string;
-export declare function worksheetRelsPath(sheetId: number | string): string;
-export declare function worksheetRelTarget(sheetId: number | string): string;
-export declare function commentsPath(sheetId: number | string): string;
-export declare function commentsPathFromName(commentName: string): string;
-export declare function vmlDrawingPath(sheetId: number | string): string;
-export declare function tablePath(target: string): string;
-export declare function drawingPath(drawingName: string): string;
-export declare function drawingRelsPath(drawingName: string): string;
-export declare function pivotCacheDefinitionPath(n: number | string): string;
-export declare function pivotCacheDefinitionRelsPath(n: number | string): string;
-export declare function pivotCacheRecordsPath(n: number | string): string;
-export declare function pivotCacheRecordsRelTarget(n: number | string): string;
-export declare function pivotTablePath(n: number | string): string;
-export declare function pivotTableRelsPath(n: number | string): string;
-export declare function pivotCacheDefinitionRelTargetFromPivotTable(n: number | string): string;
-export declare const OOXML_REL_TARGETS: {
-    readonly workbookStyles: "styles.xml";
-    readonly workbookSharedStrings: "sharedStrings.xml";
-    readonly workbookTheme1: "theme/theme1.xml";
-};
-export declare function pivotCacheDefinitionRelTargetFromWorkbook(n: number | string): string;
-export declare function commentsRelTargetFromWorksheet(sheetId: number | string): string;
-export declare function vmlDrawingRelTargetFromWorksheet(sheetId: number | string): string;
-export declare function drawingRelTargetFromWorksheet(drawingName: string): string;
-export declare function vmlDrawingRelTargetFromWorksheetName(vmlName: string): string;
-export declare function commentsRelTargetFromWorksheetName(commentName: string): string;
-export declare function pivotTableRelTargetFromWorksheet(n: number | string): string;
-export declare function pivotTableRelTargetFromWorksheetName(pivotName: string): string;
-export declare function tableRelTargetFromWorksheet(target: string): string;
-export declare function tableRelTargetFromWorksheetName(name: string): string;
-export declare function mediaRelTargetFromRels(filename: string): string;

package/dist/types/modules/excel/utils/sheet-utils.d.ts

@@ -1,190 +0,0 @@
-/**
- * Utility functions for ExcelTS
- * Provides convenient helper functions for common spreadsheet operations
- */
-import { Workbook } from "@excel/workbook";
-import type { Worksheet } from "@excel/worksheet";
-import type { CellValue } from "@excel/types";
-/**
- * Cell address object (0-indexed)
- */
-export interface CellAddress {
-    /** 0-indexed column number */
-    c: number;
-    /** 0-indexed row number */
-    r: number;
-}
-/**
- * Range object with start and end addresses
- */
-export interface Range {
-    /** Start cell (top-left) */
-    s: CellAddress;
-    /** End cell (bottom-right) */
-    e: CellAddress;
-}
-/**
- * Row data for JSON conversion
- */
-export type JSONRow = Record<string, CellValue>;
-/**
- * Decode column string to 0-indexed number
- * @example decodeCol("A") => 0, decodeCol("Z") => 25, decodeCol("AA") => 26
- */
-export declare function decodeCol(colstr: string): number;
-/**
- * Encode 0-indexed column number to string
- * @example encodeCol(0) => "A", encodeCol(25) => "Z", encodeCol(26) => "AA"
- */
-export declare function encodeCol(col: number): string;
-/**
- * Decode row string to 0-indexed number
- * @example decodeRow("1") => 0, decodeRow("10") => 9
- */
-export declare function decodeRow(rowstr: string): number;
-/**
- * Encode 0-indexed row number to string
- * @example encodeRow(0) => "1", encodeRow(9) => "10"
- */
-export declare function encodeRow(row: number): string;
-/**
- * Decode cell address string to CellAddress object
- * @example decodeCell("A1") => {c: 0, r: 0}, decodeCell("B2") => {c: 1, r: 1}
- */
-export declare function decodeCell(cstr: string): CellAddress;
-/**
- * Encode CellAddress object to cell address string
- * @example encodeCell({c: 0, r: 0}) => "A1", encodeCell({c: 1, r: 1}) => "B2"
- */
-export declare function encodeCell(cell: CellAddress): string;
-/**
- * Decode range string to Range object
- * @example decodeRange("A1:B2") => {s: {c: 0, r: 0}, e: {c: 1, r: 1}}
- */
-export declare function decodeRange(range: string): Range;
-/**
- * Encode Range object to range string
- */
-export declare function encodeRange(range: Range): string;
-export declare function encodeRange(start: CellAddress, end: CellAddress): string;
-/** Origin can be cell address string, cell object, row number, or -1 to append */
-export type Origin = string | CellAddress | number;
-export interface JSON2SheetOpts {
-    /** Use specified field order (default Object.keys) */
-    header?: string[];
-    /** Use specified date format in string output */
-    dateFormat?: string;
-    /** Store dates as type d (default is n) */
-    cellDates?: boolean;
-    /** If true, do not include header row in output */
-    skipHeader?: boolean;
-    /** If true, emit #NULL! error cells for null values */
-    nullError?: boolean;
-}
-export interface SheetAddJSONOpts extends JSON2SheetOpts {
-    /** Use specified cell as starting point */
-    origin?: Origin;
-}
-/**
- * Create a worksheet from an array of objects (xlsx compatible)
- * @example
- * const ws = jsonToSheet([{name: "Alice", age: 30}, {name: "Bob", age: 25}])
- */
-export declare function jsonToSheet(data: JSONRow[], opts?: JSON2SheetOpts): Worksheet;
-/**
- * Add data from an array of objects to an existing worksheet (xlsx compatible)
- */
-export declare function sheetAddJson(worksheet: Worksheet, data: JSONRow[], opts?: SheetAddJSONOpts): Worksheet;
-export interface Sheet2JSONOpts {
-    /**
-     * Control output format:
-     * - 1: Generate an array of arrays
-     * - "A": Row object keys are literal column labels (A, B, C, ...)
-     * - string[]: Use specified strings as keys in row objects
-     * - undefined: Read and disambiguate first row as keys
-     */
-    header?: 1 | "A" | string[];
-    /**
-     * Override Range:
-     * - number: Use worksheet range but set starting row to the value
-     * - string: Use specified range (A1-Style bounded range string)
-     * - undefined: Use worksheet range
-     */
-    range?: number | string;
-    /** Use raw values (true, default) or formatted text strings with trim (false) */
-    raw?: boolean;
-    /** Default value for empty cells */
-    defval?: CellValue;
-    /** Include blank lines in the output */
-    blankrows?: boolean;
-    /**
-     * Override format for date values (not applied to time-only formats).
-     * When provided, Date values will be formatted using this format string.
-     * @example "dd/mm/yyyy" or "yyyy-mm-dd"
-     */
-    dateFormat?: string;
-}
-/**
- * Convert worksheet to JSON array (xlsx compatible)
- * @example
- * // Default: array of objects with first row as headers
- * const data = sheetToJson(worksheet)
- * // => [{name: "Alice", age: 30}, {name: "Bob", age: 25}]
- *
- * // Array of arrays
- * const aoa = sheetToJson(worksheet, { header: 1 })
- * // => [["name", "age"], ["Alice", 30], ["Bob", 25]]
- *
- * // Column letters as keys
- * const cols = sheetToJson(worksheet, { header: "A" })
- * // => [{A: "name", B: "age"}, {A: "Alice", B: 30}]
- */
-export declare function sheetToJson<T = JSONRow>(worksheet: Worksheet, opts?: Sheet2JSONOpts): T[];
-export interface Sheet2CSVOpts {
-    /** Field separator (default: ",") */
-    FS?: string;
-    /** Record separator (default: "\n") */
-    RS?: string;
-    /** Skip blank rows */
-    blankrows?: boolean;
-    /** Force quote all fields */
-    forceQuotes?: boolean;
-}
-/**
- * Convert worksheet to CSV string
- */
-export declare function sheetToCsv(worksheet: Worksheet, opts?: Sheet2CSVOpts): string;
-/**
- * Create a new workbook
- */
-export declare function bookNew(): Workbook;
-/**
- * Append worksheet to workbook (xlsx compatible)
- * @example
- * const wb = bookNew();
- * const ws = jsonToSheet([{a: 1, b: 2}]);
- * bookAppendSheet(wb, ws, "Sheet1");
- */
-export declare function bookAppendSheet(workbook: Workbook, worksheet: Worksheet, name?: string): void;
-export interface AOA2SheetOpts {
-    /** Use specified cell as starting point */
-    origin?: Origin;
-    /** Use specified date format in string output */
-    dateFormat?: string;
-    /** Store dates as type d (default is n) */
-    cellDates?: boolean;
-}
-/**
- * Create a worksheet from an array of arrays (xlsx compatible)
- * @example
- * const ws = aoaToSheet([["Name", "Age"], ["Alice", 30], ["Bob", 25]])
- */
-export declare function aoaToSheet(data: CellValue[][], opts?: AOA2SheetOpts): Worksheet;
-/**
- * Add data from an array of arrays to an existing worksheet (xlsx compatible)
- */
-export declare function sheetAddAoa(worksheet: Worksheet, data: CellValue[][], opts?: AOA2SheetOpts): Worksheet;
-/**
- * Convert worksheet to array of arrays
- */
-export declare function sheetToAoa(worksheet: Worksheet): CellValue[][];

package/dist/types/modules/excel/utils/stream-buf.d.ts

@@ -1,126 +0,0 @@
-/**
- * StreamBuf - Cross-Platform Multi-purpose Read-Write Stream
- *
- * A unified implementation that works in both Node.js and Browser environments
- * using the cross-platform EventEmitter from modules/stream.
- *
- * Features:
- * - As MemBuf: write data, then call toBuffer() to consolidate
- * - As StreamHub: pipe to multiple writable streams
- * - As readable stream: feed data into writable part and read from it
- */
-import { EventEmitter } from "@stream";
-import { StringBuf } from "@excel/utils/string-buf";
-type TextEncoding = "utf-8" | "utf8" | BufferEncoding;
-interface StreamBufOptions {
-    bufSize?: number;
-    batch?: boolean;
-}
-/**
- * StreamBuf is a multi-purpose read-write stream that works in both
- * Node.js and Browser environments.
- *
- * It extends EventEmitter to provide stream-like events:
- * - 'data': emitted when data is written (flowing mode)
- * - 'readable': emitted when data is available to read
- * - 'finish': emitted when end() is called
- * - 'error': emitted on errors
- * - 'drain': emitted when buffer drains (after pipe)
- */
-declare class StreamBuf extends EventEmitter {
-    private bufSize;
-    private buffers;
-    private batch;
-    private corked;
-    private paused;
-    private encoding;
-    private pipes;
-    private _ended;
-    private _writableStream;
-    private _writableStreamWriter;
-    private _asyncWriteQueue;
-    constructor(options?: StreamBufOptions);
-    /**
-     * Returns true if the stream is writable (not ended)
-     * Required for compatibility with Node.js pipe()
-     */
-    get writable(): boolean;
-    /**
-     * Consolidate all buffers into a single Uint8Array
-     */
-    toBuffer(): Uint8Array | null;
-    private _getWritableBuffer;
-    private _pipeChunk;
-    private _writeToBuffers;
-    /**
-     * Write data to the stream
-     */
-    write(data: Uint8Array | string | StringBuf | ArrayBuffer | ArrayBufferView, encoding?: TextEncoding | Function, callback?: Function): Promise<boolean>;
-    /**
-     * Cork the stream - buffer writes until uncork
-     */
-    cork(): void;
-    private _flush;
-    /**
-     * Uncork the stream - flush buffered writes
-     */
-    uncork(): void;
-    /**
-     * End the stream
-     */
-    end(chunk?: any, encoding?: TextEncoding, callback?: Function): void;
-    /**
-     * Read from the stream
-     */
-    read(size?: number): Uint8Array;
-    /**
-     * Read from the stream and return as string.
-     * Cross-platform compatible - works identically in Node.js and Browser.
-     */
-    readString(encoding?: TextEncoding): string;
-    /**
-     * Set encoding for string reads
-     */
-    setEncoding(encoding: string): void;
-    /**
-     * Pause the stream
-     */
-    pause(): void;
-    /**
-     * Resume the stream
-     */
-    resume(): void;
-    /**
-     * Check if stream is paused
-     */
-    isPaused(): boolean;
-    /**
-     * Pipe to a writable stream
-     */
-    pipe<T extends {
-        write: Function;
-        end?: Function;
-    }>(destination: T): T;
-    /**
-     * Pipe to a native WritableStream (browser Streams API).
-     * This properly handles async writes and waits for completion before finish.
-     */
-    pipeTo(writableStream: WritableStream<Uint8Array>): void;
-    /**
-     * Remove a piped destination
-     */
-    unpipe(destination: any): void;
-    /**
-     * Put data back at the front (not implemented)
-     */
-    unshift(): void;
-    /**
-     * Wrap a stream (not implemented)
-     */
-    wrap(): void;
-    /**
-     * Push data to the stream (alias for write)
-     */
-    push(chunk: any): boolean;
-}
-export { StreamBuf };