juxscript 1.1.184 → 1.1.185

package/lib/components/dataframe.d.ts

@@ -98,9 +98,17 @@ export declare class DataFrameComponent extends BaseComponent<DataFrameState> {
     private _updateTable;
     private _showFilterInput;
     /**
-     * ✅ NEW: Show settings modal to reshape CSV data
+     * ✅ UPDATED: Show settings modal for CSV OR Excel reshaping
      */
     private _showReshapeModal;
+    /**
+     * ✅ NEW: Excel-specific reshape modal (header row picker)
+     */
+    private _showExcelReshapeModal;
+    /**
+     * ✅ CSV-specific reshape modal (existing implementation)
+     */
+    private _showCSVReshapeModal;
     update(prop: string, value: any): void;
     render(targetId?: string | HTMLElement | BaseComponent<any>): this;
 }

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

@@ -34,7 +34,7 @@ export class DataFrameComponent extends BaseComponent {
         this._sheetChunkSize = 10000; // ✅ Default 10k chunk
         this._maxFileSize = 50; // ✅ Default 50MB
         this._showReshapeWarning = true;
-        this._rawFileData = null; // ✅ Store for re-parsing
+        this._rawFileData = null; // ✅ Add isExcel flag
         this._driver = new TabularDriver(options.dbName ?? 'jux-dataframes', options.storeName ?? 'frames');
         this._showStatus = options.showStatus ?? true;
         this._icon = options.icon ?? '';
@@ -104,6 +104,8 @@ export class DataFrameComponent extends BaseComponent {
                     const isExcel = file.name.toLowerCase().endsWith('.xlsx') ||
                         file.name.toLowerCase().endsWith('.xls');
                     if (isExcel) {
+                        // ✅ Store raw file for reshape
+                        this._rawFileData = { file, isExcel: true };
                         // ✅ Pass chunking options for large files
                         const sheets = await this._driver.streamFileMultiSheet(file, {
                             maxSheetSize: this._maxSheetSize,
@@ -125,7 +127,7 @@ export class DataFrameComponent extends BaseComponent {
                     else {
                         // ✅ CSV/TSV: Store raw text for reshaping
                         const text = await file.text();
-                        this._rawFileData = { file, text };
+                        this._rawFileData = { file, text, isExcel: false };
                         const df = this._driver.parseCSV(text, {
                             autoDetectDelimiter: true,
                             hasHeader: true
@@ -393,8 +395,8 @@ export class DataFrameComponent extends BaseComponent {
         }
         this._updateTable();
         this._updateStatus(`${sourceName} — ${this._df.height} rows × ${this._df.width} cols`, 'success');
-        // ✅ Add reshape warning button if CSV and enabled
-        if (this._showReshapeWarning && this._rawFileData?.text) {
+        // ✅ FIXED: Add reshape warning button if CSV OR Excel and enabled
+        if (this._showReshapeWarning && this._rawFileData) {
             const statusEl = document.getElementById(`${this._id}-status`);
             if (statusEl) {
                 const settingsBtn = document.createElement('button');
@@ -482,9 +484,118 @@ export class DataFrameComponent extends BaseComponent {
         });
     }
     /**
-     * ✅ NEW: Show settings modal to reshape CSV data
+     * ✅ UPDATED: Show settings modal for CSV OR Excel reshaping
      */
     _showReshapeModal() {
+        if (!this._rawFileData)
+            return;
+        const isExcel = this._rawFileData.isExcel;
+        if (isExcel) {
+            // ✅ Excel-specific modal: Let user pick header row from sheet
+            this._showExcelReshapeModal();
+        }
+        else {
+            // ✅ CSV-specific modal: delimiter + header row
+            this._showCSVReshapeModal();
+        }
+    }
+    /**
+     * ✅ NEW: Excel-specific reshape modal (header row picker)
+     */
+    async _showExcelReshapeModal() {
+        if (!this._rawFileData?.file)
+            return;
+        const modal = document.createElement('div');
+        modal.className = 'jux-modal-overlay';
+        modal.innerHTML = `
+            <div class="jux-modal" style="max-width: 800px;">
+                <div class="jux-modal-header">
+                    <div class="jux-modal-header-title">Excel Import Settings</div>
+                    <button class="jux-modal-close" id="${this._id}-modal-close">×</button>
+                </div>
+                <div class="jux-modal-content" style="padding: 1.5rem;">
+                    <div style="margin-bottom: 1rem;">
+                        <label style="display: block; font-weight: 600; margin-bottom: 0.5rem;">Header Row (0-based)</label>
+                        <input type="number" id="${this._id}-header-row" class="jux-input-element" value="0" min="0" max="50" style="width: 100%;" />
+                        <div style="font-size: 0.875rem; color: hsl(var(--muted-foreground)); margin-top: 0.5rem;">
+                            ⚠️ Detected: Row 0 has "Exported On:", row 2 has "340B ID". Try setting this to 2.
+                        </div>
+                    </div>
+                    
+                    <div style="border: 1px solid hsl(var(--border)); border-radius: var(--radius); padding: 1rem; background: hsl(var(--muted) / 0.3); max-height: 300px; overflow-y: auto;">
+                        <div style="font-weight: 600; margin-bottom: 0.5rem; color: hsl(var(--foreground));">Preview (first 10 rows)</div>
+                        <div id="${this._id}-preview" style="font-family: monospace; font-size: 0.75rem; white-space: pre; color: hsl(var(--muted-foreground));"></div>
+                    </div>
+                </div>
+                <div class="jux-modal-footer">
+                    <button id="${this._id}-cancel-reshape" class="jux-button jux-button-ghost">Cancel</button>
+                    <button id="${this._id}-apply-reshape" class="jux-button">Apply & Re-import</button>
+                </div>
+            </div>
+        `;
+        document.body.appendChild(modal);
+        const headerRowInput = document.getElementById(`${this._id}-header-row`);
+        const previewDiv = document.getElementById(`${this._id}-preview`);
+        // ✅ Update preview on header row change
+        const updatePreview = async () => {
+            const headerRow = parseInt(headerRowInput.value) || 0;
+            try {
+                // Re-parse Excel with specified header row
+                const sheets = await this._driver.streamFileMultiSheet(this._rawFileData.file, {
+                    headerRow, // ✅ Pass header row to parser
+                    maxSheetSize: 10 // Preview only
+                });
+                const firstSheet = Object.values(sheets)[0];
+                if (!firstSheet) {
+                    previewDiv.textContent = '⚠️ No data found';
+                    return;
+                }
+                const preview = firstSheet.toRows().slice(0, 10).map((row, i) => {
+                    const cols = Object.values(row).map(v => String(v).padEnd(20)).join(' | ');
+                    return `${i === 0 ? '📌 ' : '   '}${cols}`;
+                }).join('\n');
+                previewDiv.textContent = `Columns: ${firstSheet.columns.join(' | ')}\n\n${preview}`;
+            }
+            catch (err) {
+                previewDiv.textContent = `⚠️ Error: ${err.message}`;
+            }
+        };
+        headerRowInput.addEventListener('input', updatePreview);
+        updatePreview();
+        // ✅ Apply button
+        document.getElementById(`${this._id}-apply-reshape`).addEventListener('click', async () => {
+            const headerRow = parseInt(headerRowInput.value) || 0;
+            this.state.loading = true;
+            this._updateStatus('⏳ Re-parsing with new settings...', 'loading');
+            try {
+                const sheets = await this._driver.streamFileMultiSheet(this._rawFileData.file, {
+                    headerRow,
+                    maxSheetSize: this._maxSheetSize,
+                    sheetChunkSize: this._sheetChunkSize
+                });
+                const sheetNames = Object.keys(sheets);
+                await this._driver.store(this._rawFileData.file.name, sheets[sheetNames[0]], { source: this._rawFileData.file.name });
+                if (sheetNames.length > 1) {
+                    this._renderMultiSheet(sheets, this._rawFileData.file.name);
+                }
+                else {
+                    this._setDataFrame(sheets[sheetNames[0]], this._rawFileData.file.name);
+                }
+                modal.remove();
+            }
+            catch (err) {
+                this._updateStatus(`❌ ${err.message}`, 'error');
+            }
+        });
+        // ✅ Cancel/Close buttons
+        const closeModal = () => modal.remove();
+        document.getElementById(`${this._id}-cancel-reshape`).addEventListener('click', closeModal);
+        document.getElementById(`${this._id}-modal-close`).addEventListener('click', closeModal);
+    }
+    /**
+     * ✅ CSV-specific reshape modal (existing implementation)
+     */
+    _showCSVReshapeModal() {
         if (!this._rawFileData)
             return;
         const modal = document.createElement('div');
@@ -633,6 +744,8 @@ export class DataFrameComponent extends BaseComponent {
                         const isExcel = file.name.toLowerCase().endsWith('.xlsx') ||
                             file.name.toLowerCase().endsWith('.xls');
                         if (isExcel) {
+                            // ✅ Store raw file for reshape
+                            this._rawFileData = { file, isExcel: true };
                             const sheets = await this._driver.streamFileMultiSheet(file, {
                                 maxSheetSize: this._maxSheetSize,
                                 sheetChunkSize: this._sheetChunkSize,

package/lib/components/dataframe.ts

@@ -59,7 +59,7 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
     private _sheetChunkSize: number = 10000; // ✅ Default 10k chunk
     private _maxFileSize: number = 50; // ✅ Default 50MB
     private _showReshapeWarning: boolean = true;
-    private _rawFileData: { file: File; text?: string } | null = null; // ✅ Store for re-parsing
+    private _rawFileData: { file: File; text?: string; isExcel?: boolean } | null = null; // ✅ Add isExcel flag
 
     constructor(id: string, options: DataFrameOptions = {}) {
         super(id, {
@@ -149,6 +149,9 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
                         file.name.toLowerCase().endsWith('.xls');
 
                     if (isExcel) {
+                        // ✅ Store raw file for reshape
+                        this._rawFileData = { file, isExcel: true };
+
                         // ✅ Pass chunking options for large files
                         const sheets = await this._driver.streamFileMultiSheet(file, {
                             maxSheetSize: this._maxSheetSize,
@@ -171,7 +174,7 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
                     } else {
                         // ✅ CSV/TSV: Store raw text for reshaping
                         const text = await file.text();
-                        this._rawFileData = { file, text };
+                        this._rawFileData = { file, text, isExcel: false };
 
                         const df = this._driver.parseCSV(text, {
                             autoDetectDelimiter: true,
@@ -493,8 +496,8 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
             'success'
         );
 
-        // ✅ Add reshape warning button if CSV and enabled
-        if (this._showReshapeWarning && this._rawFileData?.text) {
+        // ✅ FIXED: Add reshape warning button if CSV OR Excel and enabled
+        if (this._showReshapeWarning && this._rawFileData) {
             const statusEl = document.getElementById(`${this._id}-status`);
             if (statusEl) {
                 const settingsBtn = document.createElement('button');
@@ -597,11 +600,134 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
     }
 
     /**
-     * ✅ NEW: Show settings modal to reshape CSV data
+     * ✅ UPDATED: Show settings modal for CSV OR Excel reshaping
      */
     private _showReshapeModal(): void {
         if (!this._rawFileData) return;
 
+        const isExcel = this._rawFileData.isExcel;
+
+        if (isExcel) {
+            // ✅ Excel-specific modal: Let user pick header row from sheet
+            this._showExcelReshapeModal();
+        } else {
+            // ✅ CSV-specific modal: delimiter + header row
+            this._showCSVReshapeModal();
+        }
+    }
+
+    /**
+     * ✅ NEW: Excel-specific reshape modal (header row picker)
+     */
+    private async _showExcelReshapeModal(): Promise<void> {
+        if (!this._rawFileData?.file) return;
+
+        const modal = document.createElement('div');
+        modal.className = 'jux-modal-overlay';
+        modal.innerHTML = `
+            <div class="jux-modal" style="max-width: 800px;">
+                <div class="jux-modal-header">
+                    <div class="jux-modal-header-title">Excel Import Settings</div>
+                    <button class="jux-modal-close" id="${this._id}-modal-close">×</button>
+                </div>
+                <div class="jux-modal-content" style="padding: 1.5rem;">
+                    <div style="margin-bottom: 1rem;">
+                        <label style="display: block; font-weight: 600; margin-bottom: 0.5rem;">Header Row (0-based)</label>
+                        <input type="number" id="${this._id}-header-row" class="jux-input-element" value="0" min="0" max="50" style="width: 100%;" />
+                        <div style="font-size: 0.875rem; color: hsl(var(--muted-foreground)); margin-top: 0.5rem;">
+                            ⚠️ Detected: Row 0 has "Exported On:", row 2 has "340B ID". Try setting this to 2.
+                        </div>
+                    </div>
+                    
+                    <div style="border: 1px solid hsl(var(--border)); border-radius: var(--radius); padding: 1rem; background: hsl(var(--muted) / 0.3); max-height: 300px; overflow-y: auto;">
+                        <div style="font-weight: 600; margin-bottom: 0.5rem; color: hsl(var(--foreground));">Preview (first 10 rows)</div>
+                        <div id="${this._id}-preview" style="font-family: monospace; font-size: 0.75rem; white-space: pre; color: hsl(var(--muted-foreground));"></div>
+                    </div>
+                </div>
+                <div class="jux-modal-footer">
+                    <button id="${this._id}-cancel-reshape" class="jux-button jux-button-ghost">Cancel</button>
+                    <button id="${this._id}-apply-reshape" class="jux-button">Apply & Re-import</button>
+                </div>
+            </div>
+        `;
+
+        document.body.appendChild(modal);
+
+        const headerRowInput = document.getElementById(`${this._id}-header-row`) as HTMLInputElement;
+        const previewDiv = document.getElementById(`${this._id}-preview`)!;
+
+        // ✅ Update preview on header row change
+        const updatePreview = async () => {
+            const headerRow = parseInt(headerRowInput.value) || 0;
+
+            try {
+                // Re-parse Excel with specified header row
+                const sheets = await this._driver.streamFileMultiSheet(this._rawFileData!.file, {
+                    headerRow, // ✅ Pass header row to parser
+                    maxSheetSize: 10 // Preview only
+                });
+
+                const firstSheet = Object.values(sheets)[0];
+                if (!firstSheet) {
+                    previewDiv.textContent = '⚠️ No data found';
+                    return;
+                }
+
+                const preview = firstSheet.toRows().slice(0, 10).map((row, i) => {
+                    const cols = Object.values(row).map(v => String(v).padEnd(20)).join(' | ');
+                    return `${i === 0 ? '📌 ' : '   '}${cols}`;
+                }).join('\n');
+
+                previewDiv.textContent = `Columns: ${firstSheet.columns.join(' | ')}\n\n${preview}`;
+            } catch (err: any) {
+                previewDiv.textContent = `⚠️ Error: ${err.message}`;
+            }
+        };
+
+        headerRowInput.addEventListener('input', updatePreview);
+        updatePreview();
+
+        // ✅ Apply button
+        document.getElementById(`${this._id}-apply-reshape`)!.addEventListener('click', async () => {
+            const headerRow = parseInt(headerRowInput.value) || 0;
+
+            this.state.loading = true;
+            this._updateStatus('⏳ Re-parsing with new settings...', 'loading');
+
+            try {
+                const sheets = await this._driver.streamFileMultiSheet(this._rawFileData!.file, {
+                    headerRow,
+                    maxSheetSize: this._maxSheetSize,
+                    sheetChunkSize: this._sheetChunkSize
+                });
+
+                const sheetNames = Object.keys(sheets);
+                await this._driver.store(this._rawFileData!.file.name, sheets[sheetNames[0]], { source: this._rawFileData!.file.name });
+
+                if (sheetNames.length > 1) {
+                    this._renderMultiSheet(sheets, this._rawFileData!.file.name);
+                } else {
+                    this._setDataFrame(sheets[sheetNames[0]], this._rawFileData!.file.name);
+                }
+
+                modal.remove();
+            } catch (err: any) {
+                this._updateStatus(`❌ ${err.message}`, 'error');
+            }
+        });
+
+        // ✅ Cancel/Close buttons
+        const closeModal = () => modal.remove();
+        document.getElementById(`${this._id}-cancel-reshape`)!.addEventListener('click', closeModal);
+        document.getElementById(`${this._id}-modal-close`)!.addEventListener('click', closeModal);
+    }
+
+    /**
+     * ✅ CSV-specific reshape modal (existing implementation)
+     */
+    private _showCSVReshapeModal(): void {
+        if (!this._rawFileData) return;
+
         const modal = document.createElement('div');
         modal.className = 'jux-modal-overlay';
         modal.innerHTML = `
@@ -768,6 +894,9 @@ export class DataFrameComponent extends BaseComponent<DataFrameState> {
                             file.name.toLowerCase().endsWith('.xls');
 
                         if (isExcel) {
+                            // ✅ Store raw file for reshape
+                            this._rawFileData = { file, isExcel: true };
+
                             const sheets = await this._driver.streamFileMultiSheet(file, {
                                 maxSheetSize: this._maxSheetSize,
                                 sheetChunkSize: this._sheetChunkSize,

package/lib/storage/TabularDriver.d.ts

@@ -88,8 +88,7 @@ export declare class TabularDriver {
      */
     fetch(url: string, options?: ParseOptions): Promise<DataFrame>;
     /**
-     * ✅ OPTIMIZED: Stream Excel file with chunked row processing
-     * Handles large files by processing rows in batches
+     * ✅ UPDATED: Stream Excel file with optional headerRow override
      */
     streamFileMultiSheet(file: File, options?: ParseOptions): Promise<Record<string, DataFrame>>;
     private _splitLines;

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;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC;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;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS;IA6D7D;;;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;IA0ExE;;;OAGG;IACG,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAyGtG,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":"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"}

package/lib/storage/TabularDriver.js

@@ -487,11 +487,10 @@ export class TabularDriver {
         return df;
     }
     /**
-     * ✅ OPTIMIZED: Stream Excel file with chunked row processing
-     * Handles large files by processing rows in batches
+     * ✅ UPDATED: Stream Excel file with optional headerRow override
      */
     async streamFileMultiSheet(file, options = {}) {
-        const { maxSheetSize = 100000, sheetChunkSize = 10000, onProgress } = options;
+        const { maxSheetSize = 100000, sheetChunkSize = 10000, onProgress, headerRow } = options;
         let XLSX;
         try {
             XLSX = await import('xlsx');
@@ -506,63 +505,29 @@ export class TabularDriver {
             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
+            sheetRows: maxSheetSize,
+            dense: false
         });
         const sheets = {};
         const totalSheets = workbook.SheetNames.length;
         let processedSheets = 0;
         for (const sheetName of workbook.SheetNames) {
             const worksheet = workbook.Sheets[sheetName];
-            // ✅ 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);
-                }
+            // ✅ NEW: Support headerRow option
+            const jsonData = XLSX.utils.sheet_to_json(worksheet, {
+                range: headerRow !== undefined ? headerRow : undefined, // ✅ Start from specified row
+                defval: null,
+                raw: false,
+                blankrows: false
+            });
+            if (jsonData.length > 0) {
+                sheets[sheetName] = new DataFrame(jsonData);
             }
             processedSheets++;
             if (onProgress) {

package/lib/storage/TabularDriver.ts

@@ -607,11 +607,10 @@ export class TabularDriver {
     }
 
     /**
-     * ✅ OPTIMIZED: Stream Excel file with chunked row processing
-     * Handles large files by processing rows in batches
+     * ✅ UPDATED: Stream Excel file with optional headerRow override
      */
     async streamFileMultiSheet(file: File, options: ParseOptions = {}): Promise<Record<string, DataFrame>> {
-        const { maxSheetSize = 100000, sheetChunkSize = 10000, onProgress } = options;
+        const { maxSheetSize = 100000, sheetChunkSize = 10000, onProgress, headerRow } = options;
 
         let XLSX: any;
         try {
@@ -628,8 +627,8 @@ export class TabularDriver {
 
         const workbook = XLSX.read(buffer, {
             type: 'array',
-            sheetRows: maxSheetSize, // ✅ Limit rows read per sheet
-            dense: false // ✅ Use sparse format for memory efficiency
+            sheetRows: maxSheetSize,
+            dense: false
         });
 
         const sheets: Record<string, DataFrame> = {};
@@ -639,7 +638,6 @@ export class TabularDriver {
         for (const sheetName of workbook.SheetNames) {
             const worksheet = workbook.Sheets[sheetName];
 
-            // ✅ Get sheet range to determine size
             const range = XLSX.utils.decode_range(worksheet['!ref'] || 'A1');
             const totalRows = range.e.r - range.s.r + 1;
 
@@ -648,55 +646,16 @@ export class TabularDriver {
                 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
-                });
+            // ✅ NEW: Support headerRow option
+            const jsonData: Record<string, any>[] = XLSX.utils.sheet_to_json(worksheet, {
+                range: headerRow !== undefined ? headerRow : undefined, // ✅ Start from specified row
+                defval: null,
+                raw: false,
+                blankrows: false
+            });
 
-                if (jsonData.length > 0) {
-                    sheets[sheetName] = new DataFrame(jsonData);
-                }
+            if (jsonData.length > 0) {
+                sheets[sheetName] = new DataFrame(jsonData);
             }
 
             processedSheets++;

package/package.json

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