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

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

@@ -0,0 +1,36 @@
+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/browser/modules/excel/utils/encryptor.browser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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/browser/modules/excel/utils/encryptor.browser.js

@@ -0,0 +1,46 @@
+/**
+ * Browser-only Encryptor
+ * Uses Web Crypto API (hardware accelerated)
+ */
+import { base64ToUint8Array, uint8ArrayToBase64, stringToUtf16Le } from "../../../utils/utils.base.js";
+import { concatUint8Arrays } from "../../stream/index.browser.js";
+// Helper to convert number to little-endian Uint8Array
+function uint32ToLe(num) {
+    const arr = new Uint8Array(4);
+    arr[0] = num & 0xff;
+    arr[1] = (num >> 8) & 0xff;
+    arr[2] = (num >> 16) & 0xff;
+    arr[3] = (num >> 24) & 0xff;
+    return arr;
+}
+const Encryptor = {
+    /**
+     * Calculate hash using Web Crypto API
+     */
+    async hash(algorithm, ...buffers) {
+        const data = concatUint8Arrays(buffers);
+        const hashBuffer = await crypto.subtle.digest(algorithm, new Uint8Array(data));
+        return new Uint8Array(hashBuffer);
+    },
+    /**
+     * Convert password to hash
+     */
+    async convertPasswordToHash(password, hashAlgorithm, saltValue, spinCount) {
+        const passwordBuffer = stringToUtf16Le(password);
+        const saltBuffer = base64ToUint8Array(saltValue);
+        let key = await this.hash(hashAlgorithm, saltBuffer, passwordBuffer);
+        for (let i = 0; i < spinCount; i++) {
+            key = await this.hash(hashAlgorithm, key, uint32ToLe(i));
+        }
+        return uint8ArrayToBase64(key);
+    },
+    /**
+     * Generate cryptographically strong random bytes
+     */
+    randomBytes(size) {
+        const bytes = new Uint8Array(size);
+        crypto.getRandomValues(bytes);
+        return bytes;
+    }
+};
+export { Encryptor };

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

@@ -0,0 +1,9 @@
+/**
+ * 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/browser/modules/excel/utils/encryptor.js

@@ -0,0 +1,35 @@
+/**
+ * Node.js Encryptor - uses native crypto module
+ */
+import crypto from "crypto";
+import { base64ToUint8Array, uint8ArrayToBase64, stringToUtf16Le } from "../../../utils/utils.base.js";
+import { concatUint8Arrays } from "../../stream/index.browser.js";
+function uint32ToLe(num) {
+    const arr = new Uint8Array(4);
+    arr[0] = num & 0xff;
+    arr[1] = (num >> 8) & 0xff;
+    arr[2] = (num >> 16) & 0xff;
+    arr[3] = (num >> 24) & 0xff;
+    return arr;
+}
+const Encryptor = {
+    hash(algorithm, ...buffers) {
+        const algo = algorithm.toLowerCase().replace(/-/g, "");
+        const hash = crypto.createHash(algo);
+        hash.update(concatUint8Arrays(buffers));
+        return new Uint8Array(hash.digest());
+    },
+    async convertPasswordToHash(password, hashAlgorithm, saltValue, spinCount) {
+        const passwordBuffer = stringToUtf16Le(password);
+        const saltBuffer = base64ToUint8Array(saltValue);
+        let key = this.hash(hashAlgorithm, saltBuffer, passwordBuffer);
+        for (let i = 0; i < spinCount; i++) {
+            key = this.hash(hashAlgorithm, key, uint32ToLe(i));
+        }
+        return uint8ArrayToBase64(key);
+    },
+    randomBytes(size) {
+        return new Uint8Array(crypto.randomBytes(size));
+    }
+};
+export { Encryptor };

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/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}`;
+}