@cj-tech-master/excelts 1.6.3 → 2.0.0-canary.20251228013952.4f2c3c6

package/dist/types/xlsx/xlsx.base.d.ts

@@ -0,0 +1,134 @@
+/**
+ * XLSXBase - 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
+ */
+/**
+ * Interface for stream-like objects used in parsing
+ */
+export interface IParseStream {
+    on(event: string, callback: Function): this;
+    removeListener(event: string, callback: Function): this;
+    pipe(dest: any): any;
+    [Symbol.asyncIterator]?: () => AsyncIterator<any>;
+}
+/**
+ * Interface for StreamBuf-like objects
+ */
+export interface IStreamBuf {
+    write(data: any): void;
+    end(): void;
+    read(): any;
+    toBuffer?(): any;
+    once(event: string, callback: Function): void;
+    on(event: string, callback: Function): void;
+    removeListener(event: string, callback: Function): void;
+    pipe?(dest: any): any;
+}
+/**
+ * Interface for ZipWriter-like objects
+ */
+export interface IZipWriter {
+    append(data: any, options: {
+        name: string;
+        base64?: boolean;
+    }): void;
+    pipe(stream: any): void;
+    on(event: string, callback: Function): void;
+    finalize(): void;
+}
+/**
+ * Abstract base class for XLSX operations
+ */
+declare abstract class XLSXBase {
+    workbook: any;
+    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: any);
+    /**
+     * Create a StreamBuf instance for buffering data
+     */
+    protected abstract createStreamBuf(): IStreamBuf;
+    /**
+     * Create a stream from binary data (for media/themes)
+     */
+    protected abstract createBinaryStream(data: Uint8Array): IParseStream;
+    /**
+     * Create a stream from string content (for XML parsing)
+     */
+    protected abstract createTextStream(content: string): IParseStream;
+    /**
+     * Convert buffer/Uint8Array to string
+     */
+    protected abstract bufferToString(data: any): string;
+    parseRels(stream: any): Promise<any>;
+    parseWorkbook(stream: any): Promise<any>;
+    parseSharedStrings(stream: any): Promise<any>;
+    reconcile(model: any, options?: any): 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: any, model: any, sheetNo: number, options: any, path: string): Promise<void>;
+    _processCommentEntry(stream: any, model: any, name: string): Promise<void>;
+    _processTableEntry(stream: any, model: any, name: string): Promise<void>;
+    _processWorksheetRelsEntry(stream: any, model: any, sheetNo: number): Promise<void>;
+    _processMediaEntry(stream: any, 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: any, model: any, name: string): Promise<void>;
+    _processPivotTableEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotTableRelsEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotCacheDefinitionEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotCacheDefinitionRelsEntry(stream: any, model: any, name: string): Promise<void>;
+    _processPivotCacheRecordsEntry(stream: any, 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: any, model: any, entryName: string): Promise<void>;
+    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 { XLSXBase };

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

@@ -0,0 +1,31 @@
+/**
+ * XLSX Browser version - No Node.js dependencies
+ *
+ * Extends XLSXBase with:
+ * - load: Load from buffer/ArrayBuffer/Uint8Array
+ * - writeBuffer: Write to BrowserBuffer (Uint8Array with toString("base64"))
+ *
+ * NOT supported:
+ * - readFile/writeFile (no file system)
+ * - read/write (no streams)
+ */
+import { BrowserBuffer } from "../utils/browser-buffer";
+import { XLSXBase, type IStreamBuf, type IParseStream } from "./xlsx.base";
+declare class XLSX extends XLSXBase {
+    protected createStreamBuf(): IStreamBuf;
+    protected createBinaryStream(data: Uint8Array): IParseStream;
+    protected createTextStream(content: string): IParseStream;
+    protected bufferToString(data: any): string;
+    /**
+     * Load workbook from buffer/ArrayBuffer/Uint8Array
+     * This is the main entry point for browser usage
+     */
+    load(data: any, options?: any): Promise<any>;
+    /**
+     * Write workbook to buffer
+     * Returns a BrowserBuffer which supports toString("base64")
+     */
+    writeBuffer(options?: any): Promise<BrowserBuffer>;
+    addMedia(zip: any, model: any): Promise<void>;
+}
+export { XLSX };

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

@@ -1,86 +1,26 @@
-declare class XLSX {
-    workbook: any;
-    constructor(workbook: any);
+/**
+ * XLSX - Node.js version with full functionality
+ *
+ * Extends XLSXBase with:
+ * - readFile: Read from file path
+ * - writeFile: Write to file path
+ * - read: Read from stream
+ * - write: Write to stream
+ * - load: Load from buffer
+ * - writeBuffer: Write to buffer
+ */
+import { XLSXBase, type IStreamBuf, type IParseStream } from "./xlsx.base";
+declare class XLSX extends XLSXBase {
+    protected createStreamBuf(): IStreamBuf;
+    protected createBinaryStream(data: Uint8Array): IParseStream;
+    protected createTextStream(content: string): IParseStream;
+    protected bufferToString(data: any): string;
     readFile(filename: string, options?: any): Promise<any>;
-    parseRels(stream: any): Promise<any>;
-    parseWorkbook(stream: any): Promise<any>;
-    parseSharedStrings(stream: any): Promise<any>;
-    reconcile(model: any, options?: any): void;
-    /**
-     * Reconcile pivot tables by linking them to worksheets and their cache data.
-     * This builds a complete pivot table model ready for writing.
-     */
-    private _reconcilePivotTables;
-    /**
-     * Extract table number from pivot table name (e.g., "pivotTable1" -> 1)
-     */
-    private _extractTableNumber;
-    /**
-     * Build a mapping from rId to cacheId using pivotCaches from workbook.xml
-     * and workbookRels to determine which definition file corresponds to which cacheId
-     */
-    private _buildCacheIdMap;
-    /**
-     * Build a mapping from definition name to cacheId
-     */
-    private _buildDefinitionToCacheIdMap;
-    /**
-     * Determine the aggregation metric from dataFields
-     */
-    private _determineMetric;
-    _processWorksheetEntry(stream: any, model: any, sheetNo: number, options: any, path: string): Promise<void>;
-    _processCommentEntry(stream: any, model: any, name: string): Promise<void>;
-    _processTableEntry(stream: any, model: any, name: string): Promise<void>;
-    _processWorksheetRelsEntry(stream: any, model: any, sheetNo: number): Promise<void>;
-    _processMediaEntry(stream: any, 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: any, model: any, name: string): Promise<void>;
-    _processPivotTableEntry(stream: any, model: any, name: string): Promise<void>;
-    _processPivotTableRelsEntry(stream: any, model: any, name: string): Promise<void>;
-    _processPivotCacheDefinitionEntry(stream: any, model: any, name: string): Promise<void>;
-    _processPivotCacheDefinitionRelsEntry(stream: any, model: any, name: string): Promise<void>;
-    _processPivotCacheRecordsEntry(stream: any, model: any, name: string): Promise<void>;
+    writeFile(filename: string, options?: any): Promise<void>;
     read(stream: any, options?: any): Promise<any>;
-    load(data: any, options?: any): Promise<any>;
-    loadFromFiles(zipData: Record<string, Uint8Array>, options?: any): Promise<any>;
-    addContentTypes(zip: any, model: any): Promise<void>;
-    addApp(zip: any, model: any): Promise<void>;
-    addCore(zip: any, model: any): Promise<void>;
-    addThemes(zip: any, model: any): Promise<void>;
-    addOfficeRels(zip: any, _model: any): Promise<void>;
-    addWorkbookRels(zip: any, model: any): Promise<void>;
-    addSharedStrings(zip: any, model: any): Promise<void>;
-    addStyles(zip: any, model: any): Promise<void>;
-    addWorkbook(zip: any, model: any): Promise<void>;
-    addWorksheets(zip: any, model: any): Promise<void>;
-    addMedia(zip: any, model: any): Promise<void>;
-    addDrawings(zip: any, model: any): void;
-    addTables(zip: any, model: any): void;
-    addPivotTables(zip: any, model: any): void;
-    _finalize(zip: any): Promise<XLSX>;
-    prepareModel(model: any, options: any): void;
     write(stream: any, options?: any): Promise<XLSX>;
-    writeFile(filename: string, options?: any): Promise<void>;
+    load(data: any, options?: any): Promise<any>;
     writeBuffer(options?: any): Promise<Buffer>;
-    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;
-    };
+    addMedia(zip: any, model: any): Promise<void>;
 }
 export { XLSX };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "1.6.3",
+  "version": "2.0.0-canary.20251228013952.4f2c3c6",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
-  "private": false,
+  "type": "module",
   "publishConfig": {
     "access": "public"
   },
@@ -26,22 +26,21 @@
   "bugs": {
     "url": "https://github.com/cjnoname/excelts/issues"
   },
-  "type": "module",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "browserslist": [
     "chrome >= 85",
     "edge >= 85",
-    "firefox >= 113",
-    "safari >= 16.4",
+    "firefox >= 79",
+    "safari >= 14",
     "opera >= 71"
   ],
   "exports": {
     ".": {
       "browser": {
         "types": "./dist/types/index.browser.d.ts",
-        "default": "./dist/esm/index.browser.js"
+        "default": "./dist/browser/excelts.esm.js"
       },
       "import": {
         "types": "./dist/types/index.d.ts",
@@ -50,13 +49,7 @@
       "require": {
         "types": "./dist/types/index.d.ts",
         "default": "./dist/cjs/index.js"
-      },
-      "default": "./dist/esm/index.js"
-    },
-    "./browser": {
-      "types": "./dist/types/index.browser.d.ts",
-      "import": "./dist/esm/index.browser.js",
-      "default": "./dist/esm/index.browser.js"
+      }
     },
     "./package.json": "./package.json"
   },
@@ -97,20 +90,12 @@
     "esm",
     "xlsx"
   ],
-  "dependencies": {
-    "dayjs": "^1.11.19",
-    "fast-csv": "^5.0.5",
-    "fflate": "^0.8.2",
-    "saxes": "^6.0.0",
-    "uuid": "^13.0.0"
-  },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
-    "@oxc-node/core": "^0.0.35",
     "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.0",
-    "@typescript-eslint/parser": "^8.50.0",
-    "@typescript/native-preview": "^7.0.0-dev.20251219.1",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "@typescript/native-preview": "^7.0.0-dev.20251225.1",
     "@vitest/browser": "^4.0.16",
     "@vitest/browser-playwright": "^4.0.16",
     "@vitest/ui": "^4.0.16",
@@ -120,28 +105,21 @@
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import-x": "^4.16.1",
-    "eslint-plugin-oxlint": "^1.34.0",
+    "eslint-plugin-oxlint": "^1.35.0",
     "eslint-plugin-unused-imports": "^4.3.0",
-    "express": "^5.2.1",
-    "fast-xml-parser": "^5.3.3",
     "husky": "^9.1.7",
-    "node-stdlib-browser": "^1.3.1",
-    "nodemon": "^3.1.11",
-    "oxlint": "^1.34.0",
+    "oxlint": "^1.35.0",
     "playwright": "^1.57.0",
     "prettier": "^3.7.4",
     "rimraf": "^6.1.2",
-    "rolldown": "^1.0.0-beta.55",
-    "rollup-plugin-visualizer": "^6.0.5",
-    "tslib": "^2.8.1",
+    "rolldown": "^1.0.0-beta.57",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.0",
+    "typescript-eslint": "^8.50.1",
     "vite-tsconfig-paths": "^6.0.3",
     "vitest": "^4.0.16"
   },
   "scripts": {
-    "local": "nodemon src/local.ts",
-    "example": "nodemon scripts/run-examples.ts",
+    "example": "node scripts/run-examples.ts",
     "check": "concurrently --raw \"npm run type\" \"npm run lint\"",
     "test": "vitest run && npm run test:browser",
     "test:browser": "rimraf dist && npm run build:browser && vitest run --config vitest.browser.config.ts",
@@ -153,10 +131,9 @@
     "type": "tsgo --noEmit",
     "format": "prettier --write \"**/*.{js,ts,json,md}\"",
     "benchmark": "rimraf dist && npm run build:esm && node --expose-gc scripts/benchmark.js",
-    "build:esm": "tsc --project tsconfig.esm.json",
+    "build:esm": "tsc --project tsconfig.esm.json && node scripts/fix-esm-imports.mjs",
     "build:cjs": "tsc --project tsconfig.cjs.json && node scripts/fix-cjs-imports.mjs",
     "build:browser": "rolldown -c rolldown.config.js",
-    "analyze": "cross-env ANALYZE=1 rolldown -c rolldown.config.js",
     "preversion": "npm run lint && npm run type && npm run build && npm run test"
   }
 }