juxscript 1.1.161 → 1.1.162

package/lib/storage/TabularDriver.d.ts

@@ -17,6 +17,7 @@ export interface ParseOptions {
     maxRows?: number;
     skipRows?: number;
     columns?: string[];
+    sheet?: string | number;
 }
 export declare class TabularDriver {
     private _dbName;
@@ -29,9 +30,18 @@ export declare class TabularDriver {
      */
     parseCSV(text: string, options?: ParseOptions): DataFrame;
     /**
-     * Stream-parse a File into a DataFrame, with progress callback
+     * Stream-parse a File into a DataFrame, with progress callback.
+     * Auto-detects XLSX/XLS and routes accordingly.
      */
     streamFile(file: File, options?: ParseOptions): Promise<DataFrame>;
+    /**
+     * Parse an XLSX/XLS file into a DataFrame using SheetJS
+     */
+    private _parseXLSX;
+    /**
+     * Get sheet names from an XLSX file (useful for UI)
+     */
+    getSheetNames(file: File): Promise<string[]>;
     /**
      * Store a DataFrame to IndexedDB
      */

package/lib/storage/TabularDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TabularDriver.d.ts","sourceRoot":"","sources":["TabularDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAA4B;gBAE3B,MAAM,GAAE,MAAsB,EAAE,SAAS,GAAE,MAAiB;IAKlE,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BlC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS;IA6C7D;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IA8F5E;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBzF;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAwBjD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA4BzD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAqBlH;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IA8ExE,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAmClB,OAAO,CAAC,SAAS;IAYjB,KAAK,IAAI,IAAI;CAMhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAEhF"}
+{"version":3,"file":"TabularDriver.d.ts","sourceRoot":"","sources":["TabularDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAA4B;gBAE3B,MAAM,GAAE,MAAsB,EAAE,SAAS,GAAE,MAAiB;IAKlE,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BlC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS;IA6C7D;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IAoG5E;;OAEG;YACW,UAAU;IAuExB;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBlD;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBzF;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAwBjD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA4BzD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAqBlH;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IA8ExE,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAmClB,OAAO,CAAC,SAAS;IAYjB,KAAK,IAAI,IAAI;CAMhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAEhF"}

package/lib/storage/TabularDriver.js

@@ -63,9 +63,14 @@ export class TabularDriver {
         return df;
     }
     /**
-     * Stream-parse a File into a DataFrame, with progress callback
+     * Stream-parse a File into a DataFrame, with progress callback.
+     * Auto-detects XLSX/XLS and routes accordingly.
      */
     async streamFile(file, options = {}) {
+        const ext = file.name.split('.').pop()?.toLowerCase();
+        if (ext === 'xlsx' || ext === 'xls') {
+            return this._parseXLSX(file, options);
+        }
         const { delimiter = file.name.endsWith('.tsv') ? '\t' : ',', hasHeader = true, chunkSize = 64 * 1024, onProgress, maxRows, skipRows = 0, columns: selectCols } = options;
         const totalSize = file.size;
         let bytesRead = 0;
@@ -136,6 +141,89 @@ export class TabularDriver {
             df = df.select(...selectCols);
         return df;
     }
+    /* ═══════════════════════════════════════════════════
+     * XLSX / XLS PARSING
+     * ═══════════════════════════════════════════════════ */
+    /**
+     * Parse an XLSX/XLS file into a DataFrame using SheetJS
+     */
+    async _parseXLSX(file, options = {}) {
+        const { maxRows, skipRows = 0, columns: selectCols, sheet, onProgress, hasHeader = true } = options;
+        // Dynamic import — fails gracefully if xlsx not installed
+        let XLSX;
+        try {
+            XLSX = await import('xlsx');
+        }
+        catch {
+            throw new Error('XLSX support requires the "xlsx" package. Install it with: npm install xlsx');
+        }
+        if (onProgress)
+            onProgress(0, file.size);
+        const buffer = await file.arrayBuffer();
+        if (onProgress)
+            onProgress(file.size * 0.5, file.size);
+        const workbook = XLSX.read(buffer, { type: 'array' });
+        // Select sheet
+        let sheetName;
+        if (typeof sheet === 'number') {
+            sheetName = workbook.SheetNames[sheet] || workbook.SheetNames[0];
+        }
+        else if (typeof sheet === 'string') {
+            sheetName = sheet;
+        }
+        else {
+            sheetName = workbook.SheetNames[0];
+        }
+        const worksheet = workbook.Sheets[sheetName];
+        if (!worksheet) {
+            throw new Error(`Sheet "${sheetName}" not found. Available: ${workbook.SheetNames.join(', ')}`);
+        }
+        // Convert to JSON rows
+        const jsonRows = XLSX.utils.sheet_to_json(worksheet, {
+            header: hasHeader ? undefined : 1,
+            defval: null,
+            raw: true
+        });
+        if (onProgress)
+            onProgress(file.size * 0.8, file.size);
+        // Apply skipRows and maxRows
+        let rows = jsonRows;
+        if (skipRows > 0) {
+            rows = rows.slice(skipRows);
+        }
+        if (maxRows !== undefined) {
+            rows = rows.slice(0, maxRows);
+        }
+        // Auto-type values
+        rows = rows.map(row => {
+            const typed = {};
+            for (const [key, value] of Object.entries(row)) {
+                typed[key] = this._autoType(value === null || value === undefined ? '' : String(value));
+            }
+            return typed;
+        });
+        if (onProgress)
+            onProgress(file.size, file.size);
+        let df = new DataFrame(rows);
+        if (selectCols)
+            df = df.select(...selectCols);
+        return df;
+    }
+    /**
+     * Get sheet names from an XLSX file (useful for UI)
+     */
+    async getSheetNames(file) {
+        let XLSX;
+        try {
+            XLSX = await import('xlsx');
+        }
+        catch {
+            throw new Error('XLSX support requires the "xlsx" package. Install it with: npm install xlsx');
+        }
+        const buffer = await file.arrayBuffer();
+        const workbook = XLSX.read(buffer, { type: 'array' });
+        return workbook.SheetNames;
+    }
     /* ═══════════════════════════════════════════════════
      * INDEXEDDB PERSISTENCE
      * ═══════════════════════════════════════════════════ */

package/lib/storage/TabularDriver.ts

@@ -19,6 +19,7 @@ export interface ParseOptions {
     maxRows?: number;
     skipRows?: number;
     columns?: string[];
+    sheet?: string | number; // ✅ For XLSX: sheet name or index
 }
 
 export class TabularDriver {
@@ -108,9 +109,16 @@ export class TabularDriver {
     }
 
     /**
-     * Stream-parse a File into a DataFrame, with progress callback
+     * Stream-parse a File into a DataFrame, with progress callback.
+     * Auto-detects XLSX/XLS and routes accordingly.
      */
     async streamFile(file: File, options: ParseOptions = {}): Promise<DataFrame> {
+        const ext = file.name.split('.').pop()?.toLowerCase();
+
+        if (ext === 'xlsx' || ext === 'xls') {
+            return this._parseXLSX(file, options);
+        }
+
         const {
             delimiter = file.name.endsWith('.tsv') ? '\t' : ',',
             hasHeader = true,
@@ -200,6 +208,100 @@ export class TabularDriver {
         return df;
     }
 
+    /* ═══════════════════════════════════════════════════
+     * XLSX / XLS PARSING
+     * ═══════════════════════════════════════════════════ */
+
+    /**
+     * Parse an XLSX/XLS file into a DataFrame using SheetJS
+     */
+    private async _parseXLSX(file: File, options: ParseOptions = {}): Promise<DataFrame> {
+        const { maxRows, skipRows = 0, columns: selectCols, sheet, onProgress, hasHeader = true } = options;
+
+        // Dynamic import — fails gracefully if xlsx not installed
+        let XLSX: any;
+        try {
+            XLSX = await import('xlsx');
+        } catch {
+            throw new Error(
+                'XLSX support requires the "xlsx" package. Install it with: npm install xlsx'
+            );
+        }
+
+        if (onProgress) onProgress(0, file.size);
+
+        const buffer = await file.arrayBuffer();
+
+        if (onProgress) onProgress(file.size * 0.5, file.size);
+
+        const workbook = XLSX.read(buffer, { type: 'array' });
+
+        // Select sheet
+        let sheetName: string;
+        if (typeof sheet === 'number') {
+            sheetName = workbook.SheetNames[sheet] || workbook.SheetNames[0];
+        } else if (typeof sheet === 'string') {
+            sheetName = sheet;
+        } else {
+            sheetName = workbook.SheetNames[0];
+        }
+
+        const worksheet = workbook.Sheets[sheetName];
+        if (!worksheet) {
+            throw new Error(`Sheet "${sheetName}" not found. Available: ${workbook.SheetNames.join(', ')}`);
+        }
+
+        // Convert to JSON rows
+        const jsonRows: Record<string, any>[] = XLSX.utils.sheet_to_json(worksheet, {
+            header: hasHeader ? undefined : 1,
+            defval: null,
+            raw: true
+        });
+
+        if (onProgress) onProgress(file.size * 0.8, file.size);
+
+        // Apply skipRows and maxRows
+        let rows = jsonRows;
+        if (skipRows > 0) {
+            rows = rows.slice(skipRows);
+        }
+        if (maxRows !== undefined) {
+            rows = rows.slice(0, maxRows);
+        }
+
+        // Auto-type values
+        rows = rows.map(row => {
+            const typed: Record<string, any> = {};
+            for (const [key, value] of Object.entries(row)) {
+                typed[key] = this._autoType(value === null || value === undefined ? '' : String(value));
+            }
+            return typed;
+        });
+
+        if (onProgress) onProgress(file.size, file.size);
+
+        let df = new DataFrame(rows);
+        if (selectCols) df = df.select(...selectCols);
+
+        return df;
+    }
+
+    /**
+     * Get sheet names from an XLSX file (useful for UI)
+     */
+    async getSheetNames(file: File): Promise<string[]> {
+        let XLSX: any;
+        try {
+            XLSX = await import('xlsx');
+        } catch {
+            throw new Error('XLSX support requires the "xlsx" package. Install it with: npm install xlsx');
+        }
+
+        const buffer = await file.arrayBuffer();
+        const workbook = XLSX.read(buffer, { type: 'array' });
+        return workbook.SheetNames;
+    }
+
     /* ═══════════════════════════════════════════════════
      * INDEXEDDB PERSISTENCE
      * ═══════════════════════════════════════════════════ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juxscript",
-  "version": "1.1.161",
+  "version": "1.1.162",
   "type": "module",
   "description": "A JavaScript UX authorship platform",
   "main": "index.js",
@@ -59,7 +59,8 @@
     "chart.js": "^4.5.1",
     "esbuild": "^0.19.0",
     "express": "^4.18.2",
-    "ws": "^8.13.0"
+    "ws": "^8.13.0",
+    "xlsx": "^0.18.5"
   },
   "devDependencies": {
     "@types/express": "^4.17.17",