@cj-tech-master/excelts 4.0.0 → 4.0.1

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

@@ -0,0 +1,14 @@
+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/browser/modules/excel/utils/iterate-stream.js

@@ -0,0 +1,55 @@
+async function* iterateStream(stream) {
+    const contents = [];
+    let resolveDataPromise = null;
+    const onData = (data) => {
+        contents.push(data);
+        if (resolveDataPromise) {
+            resolveDataPromise();
+            resolveDataPromise = null;
+        }
+    };
+    stream.on("data", onData);
+    let ended = false;
+    const onEnd = () => {
+        ended = true;
+        if (resolveDataPromise) {
+            resolveDataPromise();
+            resolveDataPromise = null;
+        }
+    };
+    stream.on("end", onEnd);
+    let error = false;
+    const onError = (err) => {
+        error = err;
+        if (resolveDataPromise) {
+            resolveDataPromise();
+            resolveDataPromise = null;
+        }
+    };
+    stream.on("error", onError);
+    try {
+        while (!ended || contents.length > 0) {
+            if (contents.length === 0) {
+                stream.resume();
+                await new Promise(resolve => {
+                    resolveDataPromise = resolve;
+                });
+            }
+            else {
+                stream.pause();
+                const data = contents.shift();
+                yield data;
+            }
+            if (error) {
+                throw error;
+            }
+        }
+    }
+    finally {
+        // Clean up listeners
+        stream.removeListener("data", onData);
+        stream.removeListener("end", onEnd);
+        stream.removeListener("error", onError);
+    }
+}
+export { iterateStream };

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

@@ -0,0 +1,64 @@
+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/browser/modules/excel/utils/ooxml-paths.js

@@ -0,0 +1,209 @@
+export const OOXML_PATHS = {
+    contentTypes: "[Content_Types].xml",
+    rootRels: "_rels/.rels",
+    docPropsApp: "docProps/app.xml",
+    docPropsCore: "docProps/core.xml",
+    xlWorkbook: "xl/workbook.xml",
+    xlWorkbookRels: "xl/_rels/workbook.xml.rels",
+    xlSharedStrings: "xl/sharedStrings.xml",
+    xlStyles: "xl/styles.xml",
+    xlTheme1: "xl/theme/theme1.xml"
+};
+const worksheetXmlRegex = /^xl\/worksheets\/sheet(\d+)[.]xml$/;
+const worksheetRelsXmlRegex = /^xl\/worksheets\/_rels\/sheet(\d+)[.]xml[.]rels$/;
+const themeXmlRegex = /^xl\/theme\/[a-zA-Z0-9]+[.]xml$/;
+const mediaFilenameRegex = /^xl\/media\/([a-zA-Z0-9]+[.][a-zA-Z0-9]{3,4})$/;
+const drawingXmlRegex = /^xl\/drawings\/(drawing\d+)[.]xml$/;
+const drawingRelsXmlRegex = /^xl\/drawings\/_rels\/(drawing\d+)[.]xml[.]rels$/;
+const vmlDrawingRegex = /^xl\/drawings\/(vmlDrawing\d+)[.]vml$/;
+const commentsXmlRegex = /^xl\/comments(\d+)[.]xml$/;
+const tableXmlRegex = /^xl\/tables\/(table\d+)[.]xml$/;
+const pivotTableXmlRegex = /^xl\/pivotTables\/(pivotTable\d+)[.]xml$/;
+const pivotTableRelsXmlRegex = /^xl\/pivotTables\/_rels\/(pivotTable\d+)[.]xml[.]rels$/;
+const pivotCacheDefinitionXmlRegex = /^xl\/pivotCache\/(pivotCacheDefinition\d+)[.]xml$/;
+const pivotCacheDefinitionRelsXmlRegex = /^xl\/pivotCache\/_rels\/(pivotCacheDefinition\d+)[.]xml[.]rels$/;
+const pivotCacheRecordsXmlRegex = /^xl\/pivotCache\/(pivotCacheRecords\d+)[.]xml$/;
+export function normalizeZipPath(path) {
+    return path.startsWith("/") ? path.slice(1) : path;
+}
+export function getWorksheetNoFromWorksheetPath(path) {
+    const match = worksheetXmlRegex.exec(path);
+    if (!match) {
+        return undefined;
+    }
+    return parseInt(match[1], 10);
+}
+export function getWorksheetNoFromWorksheetRelsPath(path) {
+    const match = worksheetRelsXmlRegex.exec(path);
+    if (!match) {
+        return undefined;
+    }
+    return parseInt(match[1], 10);
+}
+export function isMediaPath(path) {
+    return path.startsWith("xl/media/");
+}
+export function getMediaFilenameFromPath(path) {
+    const match = mediaFilenameRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function isThemePath(path) {
+    return themeXmlRegex.test(path);
+}
+export function getThemeNameFromPath(path) {
+    const match = /^xl\/theme\/([a-zA-Z0-9]+)[.]xml$/.exec(path);
+    return match ? match[1] : undefined;
+}
+export function isBinaryEntryPath(path) {
+    // Media and themes should be treated as binary in the legacy buffer-based reader.
+    // Everything else is parsed as text XML.
+    return isMediaPath(path) || isThemePath(path);
+}
+export function getDrawingNameFromPath(path) {
+    const match = drawingXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getDrawingNameFromRelsPath(path) {
+    const match = drawingRelsXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getVmlDrawingNameFromPath(path) {
+    const match = vmlDrawingRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getCommentsIndexFromPath(path) {
+    const match = commentsXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getTableNameFromPath(path) {
+    const match = tableXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getPivotTableNameFromPath(path) {
+    const match = pivotTableXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getPivotTableNameFromRelsPath(path) {
+    const match = pivotTableRelsXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getPivotCacheDefinitionNameFromPath(path) {
+    const match = pivotCacheDefinitionXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getPivotCacheDefinitionNameFromRelsPath(path) {
+    const match = pivotCacheDefinitionRelsXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function getPivotCacheRecordsNameFromPath(path) {
+    const match = pivotCacheRecordsXmlRegex.exec(path);
+    return match ? match[1] : undefined;
+}
+export function toContentTypesPartName(zipPath) {
+    // ContentTypes uses leading slash PartName (e.g. "/xl/workbook.xml").
+    return zipPath.startsWith("/") ? zipPath : `/${zipPath}`;
+}
+export function themePath(themeName) {
+    return `xl/theme/${themeName}.xml`;
+}
+export function mediaPath(filename) {
+    return `xl/media/${filename}`;
+}
+export function worksheetPath(sheetId) {
+    return `xl/worksheets/sheet${sheetId}.xml`;
+}
+export function worksheetRelsPath(sheetId) {
+    return `xl/worksheets/_rels/sheet${sheetId}.xml.rels`;
+}
+export function worksheetRelTarget(sheetId) {
+    return `worksheets/sheet${sheetId}.xml`;
+}
+export function commentsPath(sheetId) {
+    return `xl/comments${sheetId}.xml`;
+}
+export function commentsPathFromName(commentName) {
+    // For comments when the caller already has the logical name (e.g. "comments1").
+    return `xl/${commentName}.xml`;
+}
+export function vmlDrawingPath(sheetId) {
+    return `xl/drawings/vmlDrawing${sheetId}.vml`;
+}
+export function tablePath(target) {
+    return `xl/tables/${target}`;
+}
+export function drawingPath(drawingName) {
+    return `xl/drawings/${drawingName}.xml`;
+}
+export function drawingRelsPath(drawingName) {
+    return `xl/drawings/_rels/${drawingName}.xml.rels`;
+}
+export function pivotCacheDefinitionPath(n) {
+    return `xl/pivotCache/pivotCacheDefinition${n}.xml`;
+}
+export function pivotCacheDefinitionRelsPath(n) {
+    return `xl/pivotCache/_rels/pivotCacheDefinition${n}.xml.rels`;
+}
+export function pivotCacheRecordsPath(n) {
+    return `xl/pivotCache/pivotCacheRecords${n}.xml`;
+}
+export function pivotCacheRecordsRelTarget(n) {
+    return `pivotCacheRecords${n}.xml`;
+}
+export function pivotTablePath(n) {
+    return `xl/pivotTables/pivotTable${n}.xml`;
+}
+export function pivotTableRelsPath(n) {
+    return `xl/pivotTables/_rels/pivotTable${n}.xml.rels`;
+}
+export function pivotCacheDefinitionRelTargetFromPivotTable(n) {
+    return `../pivotCache/pivotCacheDefinition${n}.xml`;
+}
+export const OOXML_REL_TARGETS = {
+    // Targets inside xl/_rels/workbook.xml.rels (base: xl/)
+    workbookStyles: "styles.xml",
+    workbookSharedStrings: "sharedStrings.xml",
+    workbookTheme1: "theme/theme1.xml"
+};
+export function pivotCacheDefinitionRelTargetFromWorkbook(n) {
+    // Target inside xl/_rels/workbook.xml.rels (base: xl/)
+    return `pivotCache/pivotCacheDefinition${n}.xml`;
+}
+export function commentsRelTargetFromWorksheet(sheetId) {
+    // Target inside xl/worksheets/_rels/sheetN.xml.rels (base: xl/worksheets/)
+    return `../comments${sheetId}.xml`;
+}
+export function vmlDrawingRelTargetFromWorksheet(sheetId) {
+    // Target inside xl/worksheets/_rels/sheetN.xml.rels (base: xl/worksheets/)
+    return `../drawings/vmlDrawing${sheetId}.vml`;
+}
+export function drawingRelTargetFromWorksheet(drawingName) {
+    // Target inside xl/worksheets/_rels/sheetN.xml.rels (base: xl/worksheets/)
+    return `../drawings/${drawingName}.xml`;
+}
+export function vmlDrawingRelTargetFromWorksheetName(vmlName) {
+    // For VML drawings when the caller already has the logical name (e.g. "vmlDrawing1").
+    return `../drawings/${vmlName}.vml`;
+}
+export function commentsRelTargetFromWorksheetName(commentName) {
+    // For comments when the caller already has the logical name (e.g. "comments1").
+    return `../${commentName}.xml`;
+}
+export function pivotTableRelTargetFromWorksheet(n) {
+    // Target inside xl/worksheets/_rels/sheetN.xml.rels (base: xl/worksheets/)
+    return `../pivotTables/pivotTable${n}.xml`;
+}
+export function pivotTableRelTargetFromWorksheetName(pivotName) {
+    // For pivot tables when the caller already has the logical name (e.g. "pivotTable1").
+    return `../pivotTables/${pivotName}.xml`;
+}
+export function tableRelTargetFromWorksheet(target) {
+    // Target inside xl/worksheets/_rels/sheetN.xml.rels (base: xl/worksheets/)
+    return `../tables/${target}`;
+}
+export function tableRelTargetFromWorksheetName(name) {
+    return `../tables/${name}.xml`;
+}
+export function mediaRelTargetFromRels(filename) {
+    // Target from a rels file located under xl/*/_rels (base is one level deeper than xl/)
+    return `../media/${filename}`;
+}

package/dist/browser/modules/excel/utils/parse-sax.d.ts

@@ -0,0 +1,113 @@
+/**
+ * High-performance SAX XML parser
+ *
+ * Minimal implementation optimized for Excel XML parsing.
+ * Supports: opentag, text, closetag, error events.
+ * Zero external dependencies.
+ *
+ * Based on XML 1.0 specification with optimizations for common Excel XML patterns.
+ */
+export interface SaxEvent {
+    eventType: "opentag" | "text" | "closetag";
+    value: any;
+}
+export interface SaxesTagPlain {
+    name: string;
+    attributes: Record<string, string>;
+    isSelfClosing: boolean;
+}
+export interface SaxesOptions {
+    xmlns?: boolean;
+    position?: boolean;
+    fileName?: string;
+    fragment?: boolean;
+}
+type TextHandler = (text: string) => void;
+type OpenTagHandler = (tag: SaxesTagPlain) => void;
+type CloseTagHandler = (tag: SaxesTagPlain) => void;
+type ErrorHandler = (err: Error) => void;
+export declare class SaxesParser {
+    private trackPosition;
+    private fileName?;
+    private fragment;
+    private state;
+    private chunk;
+    private i;
+    private prevI;
+    private text;
+    private name;
+    private q;
+    private tags;
+    private tag;
+    private attribList;
+    private entity;
+    private entityReturnState;
+    private openWakaBang;
+    private sawRoot;
+    private closedRoot;
+    private carriedFromPrevious?;
+    private _closed;
+    private reportedTextBeforeRoot;
+    private reportedTextAfterRoot;
+    line: number;
+    column: number;
+    private positionAtNewLine;
+    private chunkPosition;
+    ENTITIES: Record<string, string>;
+    private textHandler?;
+    private openTagHandler?;
+    private closeTagHandler?;
+    private errorHandler?;
+    constructor(opt?: SaxesOptions);
+    get closed(): boolean;
+    get position(): number;
+    private _init;
+    on(name: "text", handler: TextHandler): void;
+    on(name: "opentag", handler: OpenTagHandler): void;
+    on(name: "closetag", handler: CloseTagHandler): void;
+    on(name: "error", handler: ErrorHandler): void;
+    off(name: string): void;
+    private makeError;
+    fail(message: string): this;
+    write(chunk: string | null): this;
+    close(): this;
+    private getCode;
+    private unget;
+    private processState;
+    private sText;
+    private handleTextInRoot;
+    private handleTextOutsideRoot;
+    private sOpenWaka;
+    private sOpenWakaBang;
+    private sOpenTag;
+    private sOpenTagSlash;
+    private sAttrib;
+    private sAttribName;
+    private sAttribNameSawWhite;
+    private sAttribValue;
+    private sAttribValueQuoted;
+    private sAttribValueClosed;
+    private sCloseTag;
+    private sCloseTagSawWhite;
+    private sComment;
+    private sCommentEnding;
+    private sCommentEnded;
+    private sCData;
+    private sCDataEnding;
+    private sCDataEnding2;
+    private sPI;
+    private sPIEnding;
+    private sDoctype;
+    private sDoctypeQuote;
+    private sDoctypeDTD;
+    private sDoctypeDTDQuoted;
+    private sEntity;
+    private parseEntity;
+    private skipSpaces;
+    private openTag;
+    private openSelfClosingTag;
+    private closeTag;
+    private end;
+}
+declare function parseSax(iterable: any): AsyncGenerator<SaxEvent[]>;
+export { parseSax };