juxscript 1.1.180 → 1.1.181

package/lib/components/dataframe.d.ts

@@ -14,6 +14,8 @@ export interface DataFrameOptions {
     rowsPerPage?: number;
     showStatus?: boolean;
     icon?: string;
+    maxSheetSize?: number;
+    sheetChunkSize?: number;
     style?: string;
     class?: string;
 }
@@ -36,6 +38,8 @@ export declare class DataFrameComponent extends BaseComponent<DataFrameState> {
     private _inlineUpload;
     private _showStatus;
     private _icon;
+    private _maxSheetSize;
+    private _sheetChunkSize;
     constructor(id: string, options?: DataFrameOptions);
     protected getTriggerEvents(): readonly string[];
     protected getCallbackEvents(): readonly string[];
@@ -68,6 +72,14 @@ export declare class DataFrameComponent extends BaseComponent<DataFrameState> {
     filterable(v: boolean): this;
     paginated(v: boolean): this;
     rowsPerPage(v: number): this;
+    /**
+     * ✅ NEW: Set max rows per sheet (prevents memory issues with huge Excel files)
+     */
+    maxSheetSize(v: number): this;
+    /**
+     * ✅ NEW: Set chunk size for processing large sheets
+     */
+    sheetChunkSize(v: number): this;
     /**
      * ✅ FIXED: Render multiple Excel sheets as tabs
      */

package/lib/components/dataframe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataframe.d.ts","sourceRoot":"","sources":["dataframe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dataframe.d.ts","sourceRoot":"","sources":["dataframe.ts"],"names":[],"mappings":"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"}

package/lib/components/dataframe.js

@@ -30,6 +30,8 @@ export class DataFrameComponent extends BaseComponent {
         this._inlineUpload = null;
         this._showStatus = true;
         this._icon = '';
+        this._maxSheetSize = 100000; // ✅ Default 100k rows
+        this._sheetChunkSize = 10000; // ✅ Default 10k chunk
         this._driver = new TabularDriver(options.dbName ?? 'jux-dataframes', options.storeName ?? 'frames');
         this._showStatus = options.showStatus ?? true;
         this._icon = options.icon ?? '';
@@ -41,6 +43,8 @@ export class DataFrameComponent extends BaseComponent {
             paginated: options.paginated ?? true,
             rowsPerPage: options.rowsPerPage ?? 25
         };
+        this._maxSheetSize = options.maxSheetSize ?? 100000;
+        this._sheetChunkSize = options.sheetChunkSize ?? 10000;
     }
     getTriggerEvents() { return TRIGGER_EVENTS; }
     getCallbackEvents() { return CALLBACK_EVENTS; }
@@ -86,25 +90,29 @@ export class DataFrameComponent extends BaseComponent {
                 this.state.loading = true;
                 this._updateStatus('⏳ Parsing ' + file.name + '...', 'loading');
                 try {
-                    // ✅ Check if multi-sheet Excel
                     const isExcel = file.name.toLowerCase().endsWith('.xlsx') ||
                         file.name.toLowerCase().endsWith('.xls');
                     if (isExcel) {
-                        const sheets = await this._driver.streamFileMultiSheet(file);
+                        // ✅ Pass chunking options for large files
+                        const sheets = await this._driver.streamFileMultiSheet(file, {
+                            maxSheetSize: this._maxSheetSize,
+                            sheetChunkSize: this._sheetChunkSize,
+                            onProgress: (loaded, total) => {
+                                const pct = total ? Math.round((loaded / total) * 100) : 0;
+                                this._updateStatus(`⏳ Parsing ${file.name}... ${pct}%`, 'loading');
+                            }
+                        });
                         const sheetNames = Object.keys(sheets);
-                        // Store first sheet to IndexedDB
                         await this._driver.store(file.name, sheets[sheetNames[0]], { source: file.name });
                         if (sheetNames.length > 1) {
-                            // ✅ Multi-sheet: render tabs
                             this._renderMultiSheet(sheets, file.name);
                         }
                         else {
-                            // Single sheet: render normally
                             this._setDataFrame(sheets[sheetNames[0]], file.name);
                         }
                     }
                     else {
-                        // CSV/TSV: single sheet
+                        // CSV/TSV: use existing streaming
                         const df = await this._driver.streamFile(file);
                         await this._driver.store(file.name, df, { source: file.name });
                         this._setDataFrame(df, file.name);
@@ -208,6 +216,20 @@ export class DataFrameComponent extends BaseComponent {
     filterable(v) { this._tableOptions.filterable = v; return this; }
     paginated(v) { this._tableOptions.paginated = v; return this; }
     rowsPerPage(v) { this._tableOptions.rowsPerPage = v; return this; }
+    /**
+     * ✅ NEW: Set max rows per sheet (prevents memory issues with huge Excel files)
+     */
+    maxSheetSize(v) {
+        this._maxSheetSize = v;
+        return this;
+    }
+    /**
+     * ✅ NEW: Set chunk size for processing large sheets
+     */
+    sheetChunkSize(v) {
+        this._sheetChunkSize = v;
+        return this;
+    }
     /* ═══════════════════════════════════════════════════
      * MULTI-SHEET RENDERING
      * ═══════════════════════════════════════════════════ */
@@ -460,25 +482,27 @@ export class DataFrameComponent extends BaseComponent {
                     this.state.loading = true;
                     this._updateStatus('⏳ Parsing ' + file.name + '...', 'loading');
                     try {
-                        // ✅ Check if multi-sheet Excel
                         const isExcel = file.name.toLowerCase().endsWith('.xlsx') ||
                             file.name.toLowerCase().endsWith('.xls');
                         if (isExcel) {
-                            const sheets = await this._driver.streamFileMultiSheet(file);
+                            const sheets = await this._driver.streamFileMultiSheet(file, {
+                                maxSheetSize: this._maxSheetSize,
+                                sheetChunkSize: this._sheetChunkSize,
+                                onProgress: (loaded, total) => {
+                                    const pct = total ? Math.round((loaded / total) * 100) : 0;
+                                    this._updateStatus(`⏳ Parsing ${file.name}... ${pct}%`, 'loading');
+                                }
+                            });
                             const sheetNames = Object.keys(sheets);
-                            // Store first sheet to IndexedDB
                             await this._driver.store(file.name, sheets[sheetNames[0]], { source: file.name });
                             if (sheetNames.length > 1) {
-                                // ✅ Multi-sheet: render tabs
                                 this._renderMultiSheet(sheets, file.name);
                             }
                             else {
-                                // Single sheet: render normally
                                 this._setDataFrame(sheets[sheetNames[0]], file.name);
                             }
                         }
                         else {
-                            // CSV/TSV: single sheet
                             const df = await this._driver.streamFile(file);
                             await this._driver.store(file.name, df, { source: file.name });
                             this._setDataFrame(df, file.name);

package/lib/components/dataframe.ts

@@ -20,6 +20,8 @@ export interface DataFrameOptions {
     rowsPerPage?: number;
     showStatus?: boolean;
     icon?: string;
+    maxSheetSize?: number; // ✅ NEW: Max rows per sheet (default: 100k)
+    sheetChunkSize?: number; // ✅ NEW: Chunk size for large sheets (default: 10k)
     style?: string;
     class?: string;
 }
@@ -51,6 +53,8 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
     private _inlineUpload: { label: string; accept: string; icon: string } | null = null;
     private _showStatus: boolean = true;
     private _icon: string = '';
+    private _maxSheetSize: number = 100000; // ✅ Default 100k rows
+    private _sheetChunkSize: number = 10000; // ✅ Default 10k chunk
 
     constructor(id: string, options: DataFrameOptions = {}) {
         super(id, {
@@ -81,6 +85,8 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
             paginated: options.paginated ?? true,
             rowsPerPage: options.rowsPerPage ?? 25
         };
+        this._maxSheetSize = options.maxSheetSize ?? 100000;
+        this._sheetChunkSize = options.sheetChunkSize ?? 10000;
     }
 
     protected getTriggerEvents(): readonly string[] { return TRIGGER_EVENTS; }
@@ -124,26 +130,31 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
                 this._updateStatus('⏳ Parsing ' + file.name + '...', 'loading');
 
                 try {
-                    // ✅ Check if multi-sheet Excel
                     const isExcel = file.name.toLowerCase().endsWith('.xlsx') ||
                         file.name.toLowerCase().endsWith('.xls');
 
                     if (isExcel) {
-                        const sheets = await this._driver.streamFileMultiSheet(file);
+                        // ✅ Pass chunking options for large files
+                        const sheets = await this._driver.streamFileMultiSheet(file, {
+                            maxSheetSize: this._maxSheetSize,
+                            sheetChunkSize: this._sheetChunkSize,
+                            onProgress: (loaded, total) => {
+                                const pct = total ? Math.round((loaded / total) * 100) : 0;
+                                this._updateStatus(`⏳ Parsing ${file.name}... ${pct}%`, 'loading');
+                            }
+                        });
+
                         const sheetNames = Object.keys(sheets);
 
-                        // Store first sheet to IndexedDB
                         await this._driver.store(file.name, sheets[sheetNames[0]], { source: file.name });
 
                         if (sheetNames.length > 1) {
-                            // ✅ Multi-sheet: render tabs
                             this._renderMultiSheet(sheets, file.name);
                         } else {
-                            // Single sheet: render normally
                             this._setDataFrame(sheets[sheetNames[0]], file.name);
                         }
                     } else {
-                        // CSV/TSV: single sheet
+                        // CSV/TSV: use existing streaming
                         const df = await this._driver.streamFile(file);
                         await this._driver.store(file.name, df, { source: file.name });
                         this._setDataFrame(df, file.name);
@@ -257,6 +268,22 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
     paginated(v: boolean): this { this._tableOptions.paginated = v; return this; }
     rowsPerPage(v: number): this { this._tableOptions.rowsPerPage = v; return this; }
 
+    /**
+     * ✅ NEW: Set max rows per sheet (prevents memory issues with huge Excel files)
+     */
+    maxSheetSize(v: number): this {
+        this._maxSheetSize = v;
+        return this;
+    }
+
+    /**
+     * ✅ NEW: Set chunk size for processing large sheets
+     */
+    sheetChunkSize(v: number): this {
+        this._sheetChunkSize = v;
+        return this;
+    }
+
     /* ═══════════════════════════════════════════════════
      * MULTI-SHEET RENDERING
      * ═══════════════════════════════════════════════════ */
@@ -567,26 +594,29 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
                     this._updateStatus('⏳ Parsing ' + file.name + '...', 'loading');
 
                     try {
-                        // ✅ Check if multi-sheet Excel
                         const isExcel = file.name.toLowerCase().endsWith('.xlsx') ||
                             file.name.toLowerCase().endsWith('.xls');
 
                         if (isExcel) {
-                            const sheets = await this._driver.streamFileMultiSheet(file);
+                            const sheets = await this._driver.streamFileMultiSheet(file, {
+                                maxSheetSize: this._maxSheetSize,
+                                sheetChunkSize: this._sheetChunkSize,
+                                onProgress: (loaded, total) => {
+                                    const pct = total ? Math.round((loaded / total) * 100) : 0;
+                                    this._updateStatus(`⏳ Parsing ${file.name}... ${pct}%`, 'loading');
+                                }
+                            });
+
                             const sheetNames = Object.keys(sheets);
 
-                            // Store first sheet to IndexedDB
                             await this._driver.store(file.name, sheets[sheetNames[0]], { source: file.name });
 
                             if (sheetNames.length > 1) {
-                                // ✅ Multi-sheet: render tabs
                                 this._renderMultiSheet(sheets, file.name);
                             } else {
-                                // Single sheet: render normally
                                 this._setDataFrame(sheets[sheetNames[0]], file.name);
                             }
                         } else {
-                            // CSV/TSV: single sheet
                             const df = await this._driver.streamFile(file);
                             await this._driver.store(file.name, df, { source: file.name });
                             this._setDataFrame(df, file.name);

package/lib/storage/TabularDriver.d.ts

@@ -18,6 +18,8 @@ export interface ParseOptions {
     skipRows?: number;
     columns?: string[];
     sheet?: string | number;
+    maxSheetSize?: number;
+    sheetChunkSize?: number;
 }
 export declare class TabularDriver {
     private _dbName;
@@ -74,11 +76,10 @@ export declare class TabularDriver {
      */
     fetch(url: string, options?: ParseOptions): Promise<DataFrame>;
     /**
-     * ✅ NEW: Stream Excel file and return all sheets
-     * @param file - Excel file (.xlsx or .xls)
-     * @returns Record<sheetName, DataFrame>
+     * ✅ OPTIMIZED: Stream Excel file with chunked row processing
+     * Handles large files by processing rows in batches
      */
-    streamFileMultiSheet(file: File): Promise<Record<string, DataFrame>>;
+    streamFileMultiSheet(file: File, options?: ParseOptions): Promise<Record<string, DataFrame>>;
     private _splitLines;
     private _parseLine;
     private _autoType;

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

@@ -1 +1 @@
-{"version":3,"file":"TabularDriver.d.ts","sourceRoot":"","sources":["TabularDriver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TabularDriver.d.ts","sourceRoot":"","sources":["TabularDriver.ts"],"names":[],"mappings":"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"}

package/lib/storage/TabularDriver.js

@@ -419,12 +419,11 @@ export class TabularDriver {
         return df;
     }
     /**
-     * ✅ NEW: Stream Excel file and return all sheets
-     * @param file - Excel file (.xlsx or .xls)
-     * @returns Record<sheetName, DataFrame>
+     * ✅ OPTIMIZED: Stream Excel file with chunked row processing
+     * Handles large files by processing rows in batches
      */
-    async streamFileMultiSheet(file) {
-        // ✅ FIX: Dynamic import XLSX here
+    async streamFileMultiSheet(file, options = {}) {
+        const { maxSheetSize = 100000, sheetChunkSize = 10000, onProgress } = options;
         let XLSX;
         try {
             XLSX = await import('xlsx');
@@ -432,16 +431,79 @@ export class TabularDriver {
         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();
-        const workbook = XLSX.read(buffer, { type: 'array' });
+        if (onProgress)
+            onProgress(file.size * 0.3, file.size);
+        const workbook = XLSX.read(buffer, {
+            type: 'array',
+            sheetRows: maxSheetSize, // ✅ Limit rows read per sheet
+            dense: false // ✅ Use sparse format for memory efficiency
+        });
         const sheets = {};
-        workbook.SheetNames.forEach((sheetName) => {
+        const totalSheets = workbook.SheetNames.length;
+        let processedSheets = 0;
+        for (const sheetName of workbook.SheetNames) {
             const worksheet = workbook.Sheets[sheetName];
-            const jsonData = XLSX.utils.sheet_to_json(worksheet, { defval: null });
-            if (jsonData.length > 0) {
-                sheets[sheetName] = new DataFrame(jsonData);
+            // ✅ Get sheet range to determine size
+            const range = XLSX.utils.decode_range(worksheet['!ref'] || 'A1');
+            const totalRows = range.e.r - range.s.r + 1;
+            if (totalRows === 0) {
+                processedSheets++;
+                continue;
             }
-        });
+            // ✅ Process in chunks if sheet is large
+            if (totalRows > sheetChunkSize) {
+                const rows = [];
+                let headers = [];
+                for (let startRow = 0; startRow < totalRows; startRow += sheetChunkSize) {
+                    const endRow = Math.min(startRow + sheetChunkSize, totalRows);
+                    // ✅ Read chunk with limited row range
+                    const chunkData = XLSX.utils.sheet_to_json(worksheet, {
+                        range: startRow,
+                        header: startRow === 0 ? undefined : headers,
+                        defval: null,
+                        raw: false, // ✅ Convert dates/numbers to strings to reduce memory
+                        blankrows: false
+                    });
+                    if (startRow === 0 && chunkData.length > 0) {
+                        headers = Object.keys(chunkData[0]);
+                    }
+                    rows.push(...chunkData);
+                    if (onProgress) {
+                        const progress = 0.3 + (0.6 * (processedSheets + (startRow / totalRows)) / totalSheets);
+                        onProgress(file.size * progress, file.size);
+                    }
+                    // ✅ Stop if we hit max rows
+                    if (rows.length >= maxSheetSize) {
+                        console.warn(`⚠️  Sheet "${sheetName}" truncated to ${maxSheetSize} rows`);
+                        break;
+                    }
+                }
+                if (rows.length > 0) {
+                    sheets[sheetName] = new DataFrame(rows);
+                }
+            }
+            else {
+                // ✅ Small sheet: process normally
+                const jsonData = XLSX.utils.sheet_to_json(worksheet, {
+                    defval: null,
+                    raw: false,
+                    blankrows: false
+                });
+                if (jsonData.length > 0) {
+                    sheets[sheetName] = new DataFrame(jsonData);
+                }
+            }
+            processedSheets++;
+            if (onProgress) {
+                const progress = 0.3 + (0.6 * (processedSheets / totalSheets));
+                onProgress(file.size * progress, file.size);
+            }
+        }
+        if (onProgress)
+            onProgress(file.size, file.size);
         return sheets;
     }
     /* ═══════════════════════════════════════════════════

package/lib/storage/TabularDriver.ts

@@ -19,7 +19,9 @@ export interface ParseOptions {
     maxRows?: number;
     skipRows?: number;
     columns?: string[];
-    sheet?: string | number; // ✅ For XLSX: sheet name or index
+    sheet?: string | number;
+    maxSheetSize?: number; // ✅ NEW: Max rows per sheet to prevent memory issues
+    sheetChunkSize?: number; // ✅ NEW: Process Excel in chunks
 }
 
 export class TabularDriver {
@@ -523,12 +525,12 @@ export class TabularDriver {
     }
 
     /**
-     * ✅ NEW: Stream Excel file and return all sheets
-     * @param file - Excel file (.xlsx or .xls)
-     * @returns Record<sheetName, DataFrame>
+     * ✅ OPTIMIZED: Stream Excel file with chunked row processing
+     * Handles large files by processing rows in batches
      */
-    async streamFileMultiSheet(file: File): Promise<Record<string, DataFrame>> {
-        // ✅ FIX: Dynamic import XLSX here
+    async streamFileMultiSheet(file: File, options: ParseOptions = {}): Promise<Record<string, DataFrame>> {
+        const { maxSheetSize = 100000, sheetChunkSize = 10000, onProgress } = options;
+
         let XLSX: any;
         try {
             XLSX = await import('xlsx');
@@ -536,19 +538,93 @@ export class TabularDriver {
             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();
-        const workbook = XLSX.read(buffer, { type: 'array' });
+
+        if (onProgress) onProgress(file.size * 0.3, file.size);
+
+        const workbook = XLSX.read(buffer, {
+            type: 'array',
+            sheetRows: maxSheetSize, // ✅ Limit rows read per sheet
+            dense: false // ✅ Use sparse format for memory efficiency
+        });
 
         const sheets: Record<string, DataFrame> = {};
+        const totalSheets = workbook.SheetNames.length;
+        let processedSheets = 0;
 
-        workbook.SheetNames.forEach((sheetName: string) => {
+        for (const sheetName of workbook.SheetNames) {
             const worksheet = workbook.Sheets[sheetName];
-            const jsonData: Record<string, any>[] = XLSX.utils.sheet_to_json(worksheet, { defval: null });
 
-            if (jsonData.length > 0) {
-                sheets[sheetName] = new DataFrame(jsonData);
+            // ✅ Get sheet range to determine size
+            const range = XLSX.utils.decode_range(worksheet['!ref'] || 'A1');
+            const totalRows = range.e.r - range.s.r + 1;
+
+            if (totalRows === 0) {
+                processedSheets++;
+                continue;
             }
-        });
+
+            // ✅ Process in chunks if sheet is large
+            if (totalRows > sheetChunkSize) {
+                const rows: Record<string, any>[] = [];
+                let headers: string[] = [];
+
+                for (let startRow = 0; startRow < totalRows; startRow += sheetChunkSize) {
+                    const endRow = Math.min(startRow + sheetChunkSize, totalRows);
+
+                    // ✅ Read chunk with limited row range
+                    const chunkData: Record<string, any>[] = XLSX.utils.sheet_to_json(worksheet, {
+                        range: startRow,
+                        header: startRow === 0 ? undefined : headers,
+                        defval: null,
+                        raw: false, // ✅ Convert dates/numbers to strings to reduce memory
+                        blankrows: false
+                    });
+
+                    if (startRow === 0 && chunkData.length > 0) {
+                        headers = Object.keys(chunkData[0]);
+                    }
+
+                    rows.push(...chunkData);
+
+                    if (onProgress) {
+                        const progress = 0.3 + (0.6 * (processedSheets + (startRow / totalRows)) / totalSheets);
+                        onProgress(file.size * progress, file.size);
+                    }
+
+                    // ✅ Stop if we hit max rows
+                    if (rows.length >= maxSheetSize) {
+                        console.warn(`⚠️  Sheet "${sheetName}" truncated to ${maxSheetSize} rows`);
+                        break;
+                    }
+                }
+
+                if (rows.length > 0) {
+                    sheets[sheetName] = new DataFrame(rows);
+                }
+            } else {
+                // ✅ Small sheet: process normally
+                const jsonData: Record<string, any>[] = XLSX.utils.sheet_to_json(worksheet, {
+                    defval: null,
+                    raw: false,
+                    blankrows: false
+                });
+
+                if (jsonData.length > 0) {
+                    sheets[sheetName] = new DataFrame(jsonData);
+                }
+            }
+
+            processedSheets++;
+            if (onProgress) {
+                const progress = 0.3 + (0.6 * (processedSheets / totalSheets));
+                onProgress(file.size * progress, file.size);
+            }
+        }
+
+        if (onProgress) onProgress(file.size, file.size);
 
         return sheets;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juxscript",
-  "version": "1.1.180",
+  "version": "1.1.181",
   "type": "module",
   "description": "A JavaScript UX authorship platform",
   "main": "index.js",