@rowsncolumns/toolkit 24.4.1

package/dist/esm/excel-parser/plugins/ods/types.d.ts

@@ -0,0 +1,7 @@
+export type SheetContext = {
+    node: any;
+    sheetId: number;
+    name: string;
+};
+export type ToArrayFn = <T>(value: T | T[] | undefined) => T[];
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/excel-parser/plugins/ods/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/ods/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,KAAK,CAAC,EAAE,CAAC"}

package/dist/esm/excel-parser/plugins/ods/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/excel-parser/plugins/xls/index.d.ts

@@ -0,0 +1,5 @@
+import { BaseWorkbookPlugin } from "../base/index";
+export declare class XlsPlugin extends BaseWorkbookPlugin {
+    load(_buffer: ArrayBuffer | File, _password?: string): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/excel-parser/plugins/xls/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xls/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,qBAAa,SAAU,SAAQ,kBAAkB;IACzC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI3E"}

package/dist/esm/excel-parser/plugins/xls/index.js

@@ -0,0 +1,7 @@
+import { BaseWorkbookPlugin } from "../base/index";
+export class XlsPlugin extends BaseWorkbookPlugin {
+    async load(_buffer, _password) {
+        // TODO: Implement XLS loading (CFB format)
+        console.warn("XLS support not implemented yet");
+    }
+}

package/dist/esm/excel-parser/plugins/xlsb/biff-record-reader.d.ts

@@ -0,0 +1,13 @@
+export type XlsbRecord = {
+    type: number;
+    size: number;
+    dataOffset: number;
+    nextOffset: number;
+};
+export declare const readVarUInt: (bytes: Uint8Array, startOffset: number, maxBytes?: number) => {
+    value: number;
+    nextOffset: number;
+};
+export declare const readRecordHeader: (bytes: Uint8Array, offset: number) => XlsbRecord;
+export declare const readAllRecordHeaders: (bytes: Uint8Array) => XlsbRecord[];
+//# sourceMappingURL=biff-record-reader.d.ts.map

package/dist/esm/excel-parser/plugins/xlsb/biff-record-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biff-record-reader.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsb/biff-record-reader.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,eAAO,MAAM,WAAW,GACtB,OAAO,UAAU,EACjB,aAAa,MAAM,EACnB,iBAA2B,KAC1B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAoBrC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,UAAU,EACjB,QAAQ,MAAM,KACb,UAgBF,CAAC;AAMF,eAAO,MAAM,oBAAoB,GAAI,OAAO,UAAU,KAAG,UAAU,EAWlE,CAAC"}

package/dist/esm/excel-parser/plugins/xlsb/biff-record-reader.js

@@ -0,0 +1,48 @@
+const MAX_VARINT_BYTES = 4;
+export const readVarUInt = (bytes, startOffset, maxBytes = MAX_VARINT_BYTES) => {
+    let value = 0;
+    let shift = 0;
+    let offset = startOffset;
+    for (let i = 0; i < maxBytes; i++) {
+        const byte = bytes[offset];
+        if (byte === undefined) {
+            throw new Error("Unexpected end of buffer while reading varint");
+        }
+        offset += 1;
+        value |= (byte & 0x7f) << shift;
+        if ((byte & 0x80) === 0) {
+            return { value, nextOffset: offset };
+        }
+        shift += 7;
+    }
+    throw new Error("Invalid XLSB varint: exceeded maximum length");
+};
+export const readRecordHeader = (bytes, offset) => {
+    const typeVar = readVarUInt(bytes, offset, 2);
+    const sizeVar = readVarUInt(bytes, typeVar.nextOffset, MAX_VARINT_BYTES);
+    const dataOffset = sizeVar.nextOffset;
+    const nextOffset = dataOffset + sizeVar.value;
+    if (nextOffset > bytes.length) {
+        throw new Error("Invalid XLSB record: payload exceeds buffer");
+    }
+    return {
+        type: typeVar.value,
+        size: sizeVar.value,
+        dataOffset,
+        nextOffset,
+    };
+};
+// No record-count cap: every record consumes at least two bytes (type +
+// size varints both advance the offset), so the scan is bounded by the
+// part's byte length. Real worksheet parts hold one record per cell plus
+// one per row, so any fixed cap rejects legitimate large sheets.
+export const readAllRecordHeaders = (bytes) => {
+    const records = [];
+    let offset = 0;
+    while (offset < bytes.length) {
+        const header = readRecordHeader(bytes, offset);
+        records.push(header);
+        offset = header.nextOffset;
+    }
+    return records;
+};

package/dist/esm/excel-parser/plugins/xlsb/index.d.ts

@@ -0,0 +1,117 @@
+import type { Color, IterativeCalculationOptions } from "@rowsncolumns/common-types";
+import type { BorderStyle, ConditionalFormatRule, DataValidationRuleRecord, EmbeddedChart, NamedRange, Sheet, SpreadsheetTheme, TableView } from "@rowsncolumns/spreadsheet";
+import type { EmbeddedObjectWithPosition, ProcessSheetDataResult } from "../../types";
+import { BaseWorkbookPlugin } from "../base/index";
+export declare const parseBrtNamePayload: (payload: Uint8Array, resolveSheetNameByXti?: (ixti: number) => string | undefined) => {
+    name: string;
+    formula: string;
+    hidden: boolean;
+    sheetIndex: number | undefined;
+} | null;
+/**
+ * Parse the `BrtWbProp` workbook-properties record (MS-XLSB 2.4.312).
+ * The payload starts with a 32-bit flags field; `fDate1904` is bit 0 of the
+ * first flag byte and switches the workbook's date serials to the 1904 epoch
+ * (Mac-origin workbooks), shifting every date by 1462 days.
+ */
+export declare const parseBrtWbPropPayload: (payload: Uint8Array) => {
+    use1904: boolean;
+} | null;
+type ParsedXf = {
+    parentId: number;
+    numFmtId: number;
+    fontId: number;
+    fillId: number;
+    borderId: number;
+    horizontalAlignment?: string;
+    verticalAlignment?: string;
+    wrapText?: boolean;
+    textRotation?: number | "vertical";
+    indent?: number;
+};
+type ParsedFill = {
+    patternType?: string;
+    fgColor?: Color;
+};
+type ParsedStyles = {
+    numberFormats: Map<number, string>;
+    styleXfs: ParsedXf[];
+    cellXfs: ParsedXf[];
+    fills: ParsedFill[];
+    fonts: ParsedFont[];
+    borders: ParsedBorder[];
+};
+type ParsedFont = {
+    name?: string;
+    size?: number;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+    color?: Color;
+};
+type ParsedBorderSide = {
+    style: BorderStyle;
+    width: number;
+    color?: Color;
+};
+type ParsedBorder = {
+    top?: ParsedBorderSide;
+    right?: ParsedBorderSide;
+    bottom?: ParsedBorderSide;
+    left?: ParsedBorderSide;
+};
+export declare class XlsbPlugin extends BaseWorkbookPlugin {
+    private readonly zipParser;
+    private readonly xmlParser;
+    private sheets;
+    sharedStrings: string[];
+    sharedFormulaMap: Map<string, [string, string]>;
+    private cellXfs;
+    private styles;
+    private theme;
+    private namedRanges;
+    private calcProp;
+    private supportingLinks;
+    private externSheetRefs;
+    private use1904;
+    load(buffer: ArrayBuffer | File, password?: string): Promise<void>;
+    dispose(): void;
+    private loadWorkbookRelationships;
+    private loadSharedStrings;
+    private loadStyles;
+    private loadTheme;
+    getTheme(): SpreadsheetTheme;
+    private parseRelIdFromPayload;
+    private loadRelationshipsForPart;
+    private getDrawingPathsForSheet;
+    private getTablesFromSheet;
+    private scanSheetStats;
+    getSheetCount(): number;
+    private getSheetNames;
+    private resolveSheetNameByXti;
+    getSheets(minRowCount?: number, minColumnCount?: number): Promise<[Sheet[], TableView[]]>;
+    getSharedStrings(): string[];
+    getStyles(): ParsedStyles;
+    getFonts(): string[];
+    getCellXfs(): Map<string | number, any>;
+    registerFormat(format: any): string;
+    processSheetData(chunkSize?: number, enableCellXfsRegistry?: boolean, enableSharedStrings?: boolean): AsyncGenerator<ProcessSheetDataResult, void, unknown>;
+    getDrawings(): Promise<EmbeddedObjectWithPosition[]>;
+    getCharts(): Promise<EmbeddedChart[]>;
+    getConditionalFormatting(): Promise<ConditionalFormatRule[]>;
+    getDataValidations(): Promise<DataValidationRuleRecord[]>;
+    private parseBrtName;
+    private parseBrtCalcProp;
+    getNamedRanges(): NamedRange[];
+    requiresRecalc(): boolean;
+    /**
+     * `BrtWbProp.fDate1904` shifts every date serial by 1462 days
+     * (Mac-origin workbooks). Defaults to the 1900 epoch when the record is
+     * absent, matching Excel's default behavior for newly-created workbooks.
+     */
+    getUse1904Epoch(): boolean;
+    getIterativeCalculationOptions(): IterativeCalculationOptions | undefined;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/excel-parser/plugins/xlsb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsb/index.ts"],"names":[],"mappings":"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"}