md-spreadsheet-parser 1.1.5 → 1.1.7

package/README.md

@@ -7,7 +7,7 @@
   </a>
 </p>
 
-**md-spreadsheet-parser** is a robust, zero-dependency Markdown table parser and manipulator for Node.js.
+**md-spreadsheet-parser** is a robust Markdown table parser and manipulator for Node.js.
 It is powered by the [Python Core](https://github.com/f-y/md-spreadsheet-parser) compiled to WebAssembly, ensuring 100% logic parity with the Python version while running natively in Node.js.
 
 ## Features

package/dist/index.d.ts

@@ -10,9 +10,9 @@ export declare function scanTables(markdown: any, schema?: any): any;
 export declare function generateTableMarkdown(table: any, schema?: any): any;
 export declare function generateSheetMarkdown(sheet: any, schema?: any): any;
 export declare function generateWorkbookMarkdown(workbook: any, schema: any): any;
-export declare function parseTableFromFile(source: any, schema?: any): any;
-export declare function parseWorkbookFromFile(source: any, schema?: any): any;
-export declare function scanTablesFromFile(source: any, schema?: any): any;
+export declare function parseTableFromFile(source: any, schema?: any): Promise<any>;
+export declare function parseWorkbookFromFile(source: any, schema?: any): Promise<any>;
+export declare function scanTablesFromFile(source: any, schema?: any): Promise<any>;
 export declare function scanTablesIter(source: any, schema?: any): any;
 export declare class Table {
     headers: any | undefined;
@@ -49,7 +49,7 @@ export declare class Workbook {
     constructor(data?: Partial<Workbook>);
     toDTO(): any;
     getSheet(name: any): any;
-    toMarkdown(schema: any): any;
+    toMarkdown(schema?: any): any;
     addSheet(name: any): any;
     deleteSheet(index: any): any;
 }

package/dist/index.js

@@ -1,15 +1,43 @@
 import { cleanCell as _cleanCell, splitRowGfm as _splitRowGfm, parseRow as _parseRow, parseSeparatorRow as _parseSeparatorRow, isSeparatorRow as _isSeparatorRow, parseTable as _parseTable, parseSheet as _parseSheet, parseWorkbook as _parseWorkbook, scanTables as _scanTables, generateTableMarkdown as _generateTableMarkdown, generateSheetMarkdown as _generateSheetMarkdown, generateWorkbookMarkdown as _generateWorkbookMarkdown, parseTableFromFile as _parseTableFromFile, parseWorkbookFromFile as _parseWorkbookFromFile, scanTablesFromFile as _scanTablesFromFile, scanTablesIter as _scanTablesIter, tableToModels as _tableToModels, tableToMarkdown as _tableToMarkdown, tableUpdateCell as _tableUpdateCell, tableDeleteRow as _tableDeleteRow, tableDeleteColumn as _tableDeleteColumn, tableClearColumnData as _tableClearColumnData, tableInsertRow as _tableInsertRow, tableInsertColumn as _tableInsertColumn, sheetGetTable as _sheetGetTable, sheetToMarkdown as _sheetToMarkdown, workbookGetSheet as _workbookGetSheet, workbookToMarkdown as _workbookToMarkdown, workbookAddSheet as _workbookAddSheet, workbookDeleteSheet as _workbookDeleteSheet } from '../dist/parser.js';
-// @ts-ignore
-import path from 'node:path';
-// @ts-ignore
-import process from 'node:process';
-// @ts-ignore
-import { _addPreopen } from '@bytecodealliance/preview2-shim/filesystem';
 import { clientSideToModels } from './client-adapters.js';
-// @ts-ignore
-_addPreopen('/', path.parse(process.cwd()).root);
+// Environment detection
+// @ts-ignore - process may not be defined in browser
+const isNode = typeof process !== 'undefined'
+    && typeof process.versions !== 'undefined'
+    && typeof process.versions.node !== 'undefined';
+// Lazily loaded Node.js modules (only in Node.js environment)
+let _pathModule = null;
+let _nodeInitialized = false;
+/**
+ * Ensures Node.js environment is initialized for file system operations.
+ * Throws an error in browser environments.
+ */
+async function ensureNodeEnvironment() {
+    if (!isNode) {
+        throw new Error('File system operations (parseTableFromFile, parseWorkbookFromFile, scanTablesFromFile) ' +
+            'are not supported in browser environments. ' +
+            'Use parseTable(), parseWorkbook(), or scanTables() with string content instead.');
+    }
+    if (_nodeInitialized)
+        return;
+    // Dynamic imports for Node.js only
+    const [pathModule, processModule, fsShim] = await Promise.all([
+        import('node:path'),
+        import('node:process'),
+        import('@bytecodealliance/preview2-shim/filesystem')
+    ]);
+    _pathModule = pathModule.default || pathModule;
+    const proc = processModule.default || processModule;
+    const root = _pathModule.parse(proc.cwd()).root;
+    // @ts-ignore - _addPreopen is an internal function
+    fsShim._addPreopen('/', root);
+    _nodeInitialized = true;
+}
 function resolveToVirtualPath(p) {
-    return path.resolve(p);
+    if (!_pathModule) {
+        throw new Error('Node.js modules not initialized. Call ensureNodeEnvironment() first.');
+    }
+    return _pathModule.resolve(p);
 }
 export function cleanCell(cell, schema) {
     const res = _cleanCell(cell, schema);
@@ -59,17 +87,20 @@ export function generateWorkbookMarkdown(workbook, schema) {
     const res = _generateWorkbookMarkdown(workbook, schema);
     return res;
 }
-export function parseTableFromFile(source, schema) {
+export async function parseTableFromFile(source, schema) {
+    await ensureNodeEnvironment();
     const source_resolved = resolveToVirtualPath(source);
     const res = _parseTableFromFile(source_resolved, schema);
     return new Table(res);
 }
-export function parseWorkbookFromFile(source, schema) {
+export async function parseWorkbookFromFile(source, schema) {
+    await ensureNodeEnvironment();
     const source_resolved = resolveToVirtualPath(source);
     const res = _parseWorkbookFromFile(source_resolved, schema);
     return new Workbook(res);
 }
-export function scanTablesFromFile(source, schema) {
+export async function scanTablesFromFile(source, schema) {
+    await ensureNodeEnvironment();
     const source_resolved = resolveToVirtualPath(source);
     const res = _scanTablesFromFile(source_resolved, schema);
     return res.map((x) => new Table(x));

package/dist/parser.d.ts

@@ -63,6 +63,6 @@ export function tableInsertColumn(selfObj: Table, colIdx: number): Table;
 export function sheetGetTable(selfObj: Sheet, name: string): Table | undefined;
 export function sheetToMarkdown(selfObj: Sheet, schema: ParsingSchema | undefined): string;
 export function workbookGetSheet(selfObj: Workbook, name: string): Sheet | undefined;
-export function workbookToMarkdown(selfObj: Workbook, schema: MultiTableParsingSchema): string;
+export function workbookToMarkdown(selfObj: Workbook, schema: MultiTableParsingSchema | undefined): string;
 export function workbookAddSheet(selfObj: Workbook, name: string): Workbook;
 export function workbookDeleteSheet(selfObj: Workbook, index: number): Workbook;

package/dist/parser.js

@@ -24381,7 +24381,7 @@ function workbookGetSheet(arg0, arg1) {
 let exports11WorkbookToMarkdown;
 
 function workbookToMarkdown(arg0, arg1) {
-  var ptr0 = realloc3(0, 0, 4, 84);
+  var ptr0 = realloc3(0, 0, 4, 88);
   var {sheets: v1_0, metadata: v1_1 } = arg0;
   var vec25 = v1_0;
   var len25 = vec25.length;
@@ -24534,87 +24534,94 @@ function workbookToMarkdown(arg0, arg1) {
     dataView(memory0).setUint32(ptr0 + 16, len26, true);
     dataView(memory0).setUint32(ptr0 + 12, ptr26, true);
   }
-  var {columnSeparator: v28_0, headerSeparatorChar: v28_1, requireOuterPipes: v28_2, stripWhitespace: v28_3, convertBrToNewline: v28_4, rootMarker: v28_5, sheetHeaderLevel: v28_6, tableHeaderLevel: v28_7, captureDescription: v28_8 } = arg1;
-  var variant30 = v28_0;
-  if (variant30 === null || variant30=== undefined) {
+  var variant41 = arg1;
+  if (variant41 === null || variant41=== undefined) {
     dataView(memory0).setInt8(ptr0 + 20, 0, true);
   } else {
-    const e = variant30;
+    const e = variant41;
     dataView(memory0).setInt8(ptr0 + 20, 1, true);
-    var ptr29 = utf8Encode(e, realloc3, memory0);
-    var len29 = utf8EncodedLen;
-    dataView(memory0).setUint32(ptr0 + 28, len29, true);
-    dataView(memory0).setUint32(ptr0 + 24, ptr29, true);
-  }
-  var variant32 = v28_1;
-  if (variant32 === null || variant32=== undefined) {
-    dataView(memory0).setInt8(ptr0 + 32, 0, true);
-  } else {
-    const e = variant32;
-    dataView(memory0).setInt8(ptr0 + 32, 1, true);
-    var ptr31 = utf8Encode(e, realloc3, memory0);
-    var len31 = utf8EncodedLen;
-    dataView(memory0).setUint32(ptr0 + 40, len31, true);
-    dataView(memory0).setUint32(ptr0 + 36, ptr31, true);
-  }
-  var variant33 = v28_2;
-  if (variant33 === null || variant33=== undefined) {
-    dataView(memory0).setInt8(ptr0 + 44, 0, true);
-  } else {
-    const e = variant33;
-    dataView(memory0).setInt8(ptr0 + 44, 1, true);
-    dataView(memory0).setInt8(ptr0 + 45, e ? 1 : 0, true);
-  }
-  var variant34 = v28_3;
-  if (variant34 === null || variant34=== undefined) {
-    dataView(memory0).setInt8(ptr0 + 46, 0, true);
-  } else {
-    const e = variant34;
-    dataView(memory0).setInt8(ptr0 + 46, 1, true);
-    dataView(memory0).setInt8(ptr0 + 47, e ? 1 : 0, true);
-  }
-  var variant35 = v28_4;
-  if (variant35 === null || variant35=== undefined) {
-    dataView(memory0).setInt8(ptr0 + 48, 0, true);
-  } else {
-    const e = variant35;
-    dataView(memory0).setInt8(ptr0 + 48, 1, true);
-    dataView(memory0).setInt8(ptr0 + 49, e ? 1 : 0, true);
-  }
-  var variant37 = v28_5;
-  if (variant37 === null || variant37=== undefined) {
-    dataView(memory0).setInt8(ptr0 + 52, 0, true);
-  } else {
-    const e = variant37;
-    dataView(memory0).setInt8(ptr0 + 52, 1, true);
-    var ptr36 = utf8Encode(e, realloc3, memory0);
-    var len36 = utf8EncodedLen;
-    dataView(memory0).setUint32(ptr0 + 60, len36, true);
-    dataView(memory0).setUint32(ptr0 + 56, ptr36, true);
-  }
-  var variant38 = v28_6;
-  if (variant38 === null || variant38=== undefined) {
-    dataView(memory0).setInt8(ptr0 + 64, 0, true);
-  } else {
-    const e = variant38;
-    dataView(memory0).setInt8(ptr0 + 64, 1, true);
-    dataView(memory0).setInt32(ptr0 + 68, toInt32(e), true);
-  }
-  var variant39 = v28_7;
-  if (variant39 === null || variant39=== undefined) {
-    dataView(memory0).setInt8(ptr0 + 72, 0, true);
-  } else {
-    const e = variant39;
-    dataView(memory0).setInt8(ptr0 + 72, 1, true);
-    dataView(memory0).setInt32(ptr0 + 76, toInt32(e), true);
-  }
-  var variant40 = v28_8;
-  if (variant40 === null || variant40=== undefined) {
-    dataView(memory0).setInt8(ptr0 + 80, 0, true);
-  } else {
-    const e = variant40;
-    dataView(memory0).setInt8(ptr0 + 80, 1, true);
-    dataView(memory0).setInt8(ptr0 + 81, e ? 1 : 0, true);
+    var {columnSeparator: v28_0, headerSeparatorChar: v28_1, requireOuterPipes: v28_2, stripWhitespace: v28_3, convertBrToNewline: v28_4, rootMarker: v28_5, sheetHeaderLevel: v28_6, tableHeaderLevel: v28_7, captureDescription: v28_8 } = e;
+    var variant30 = v28_0;
+    if (variant30 === null || variant30=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 24, 0, true);
+    } else {
+      const e = variant30;
+      dataView(memory0).setInt8(ptr0 + 24, 1, true);
+      var ptr29 = utf8Encode(e, realloc3, memory0);
+      var len29 = utf8EncodedLen;
+      dataView(memory0).setUint32(ptr0 + 32, len29, true);
+      dataView(memory0).setUint32(ptr0 + 28, ptr29, true);
+    }
+    var variant32 = v28_1;
+    if (variant32 === null || variant32=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 36, 0, true);
+    } else {
+      const e = variant32;
+      dataView(memory0).setInt8(ptr0 + 36, 1, true);
+      var ptr31 = utf8Encode(e, realloc3, memory0);
+      var len31 = utf8EncodedLen;
+      dataView(memory0).setUint32(ptr0 + 44, len31, true);
+      dataView(memory0).setUint32(ptr0 + 40, ptr31, true);
+    }
+    var variant33 = v28_2;
+    if (variant33 === null || variant33=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 48, 0, true);
+    } else {
+      const e = variant33;
+      dataView(memory0).setInt8(ptr0 + 48, 1, true);
+      dataView(memory0).setInt8(ptr0 + 49, e ? 1 : 0, true);
+    }
+    var variant34 = v28_3;
+    if (variant34 === null || variant34=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 50, 0, true);
+    } else {
+      const e = variant34;
+      dataView(memory0).setInt8(ptr0 + 50, 1, true);
+      dataView(memory0).setInt8(ptr0 + 51, e ? 1 : 0, true);
+    }
+    var variant35 = v28_4;
+    if (variant35 === null || variant35=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 52, 0, true);
+    } else {
+      const e = variant35;
+      dataView(memory0).setInt8(ptr0 + 52, 1, true);
+      dataView(memory0).setInt8(ptr0 + 53, e ? 1 : 0, true);
+    }
+    var variant37 = v28_5;
+    if (variant37 === null || variant37=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 56, 0, true);
+    } else {
+      const e = variant37;
+      dataView(memory0).setInt8(ptr0 + 56, 1, true);
+      var ptr36 = utf8Encode(e, realloc3, memory0);
+      var len36 = utf8EncodedLen;
+      dataView(memory0).setUint32(ptr0 + 64, len36, true);
+      dataView(memory0).setUint32(ptr0 + 60, ptr36, true);
+    }
+    var variant38 = v28_6;
+    if (variant38 === null || variant38=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 68, 0, true);
+    } else {
+      const e = variant38;
+      dataView(memory0).setInt8(ptr0 + 68, 1, true);
+      dataView(memory0).setInt32(ptr0 + 72, toInt32(e), true);
+    }
+    var variant39 = v28_7;
+    if (variant39 === null || variant39=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 76, 0, true);
+    } else {
+      const e = variant39;
+      dataView(memory0).setInt8(ptr0 + 76, 1, true);
+      dataView(memory0).setInt32(ptr0 + 80, toInt32(e), true);
+    }
+    var variant40 = v28_8;
+    if (variant40 === null || variant40=== undefined) {
+      dataView(memory0).setInt8(ptr0 + 84, 0, true);
+    } else {
+      const e = variant40;
+      dataView(memory0).setInt8(ptr0 + 84, 1, true);
+      dataView(memory0).setInt8(ptr0 + 85, e ? 1 : 0, true);
+    }
   }
   _debugLog('[iface="workbook-to-markdown", function="workbook-to-markdown"][Instruction::CallWasm] enter', {
     funcName: 'workbook-to-markdown',
@@ -24625,16 +24632,16 @@ function workbookToMarkdown(arg0, arg1) {
   const _wasm_call_currentTaskID = startCurrentTask(0, false, 'exports11WorkbookToMarkdown');
   const ret = exports11WorkbookToMarkdown(ptr0);
   endCurrentTask(0);
-  var ptr41 = dataView(memory0).getUint32(ret + 0, true);
-  var len41 = dataView(memory0).getUint32(ret + 4, true);
-  var result41 = utf8Decoder.decode(new Uint8Array(memory0.buffer, ptr41, len41));
+  var ptr42 = dataView(memory0).getUint32(ret + 0, true);
+  var len42 = dataView(memory0).getUint32(ret + 4, true);
+  var result42 = utf8Decoder.decode(new Uint8Array(memory0.buffer, ptr42, len42));
   _debugLog('[iface="workbook-to-markdown", function="workbook-to-markdown"][Instruction::Return]', {
     funcName: 'workbook-to-markdown',
     paramCount: 1,
     async: false,
     postReturn: true
   });
-  const retCopy = result41;
+  const retCopy = result42;
   
   let cstate = getOrCreateAsyncState(0);
   cstate.mayLeave = false;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "md-spreadsheet-parser",
-    "version": "1.1.5",
+    "version": "1.1.7",
     "description": "A robust Markdown table parser and manipulator, powered by Python and WebAssembly.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -29,6 +29,7 @@
     "license": "MIT",
     "devDependencies": {
         "@bytecodealliance/jco": "^1.0.0",
+        "@types/node": "^25.0.3",
         "typescript": "^5.9.3",
         "zod": "^4.3.4"
     },

package/src/index.ts

@@ -1,17 +1,50 @@
 import { cleanCell as _cleanCell, splitRowGfm as _splitRowGfm, parseRow as _parseRow, parseSeparatorRow as _parseSeparatorRow, isSeparatorRow as _isSeparatorRow, parseTable as _parseTable, parseSheet as _parseSheet, parseWorkbook as _parseWorkbook, scanTables as _scanTables, generateTableMarkdown as _generateTableMarkdown, generateSheetMarkdown as _generateSheetMarkdown, generateWorkbookMarkdown as _generateWorkbookMarkdown, parseTableFromFile as _parseTableFromFile, parseWorkbookFromFile as _parseWorkbookFromFile, scanTablesFromFile as _scanTablesFromFile, scanTablesIter as _scanTablesIter, tableToModels as _tableToModels, tableToMarkdown as _tableToMarkdown, tableUpdateCell as _tableUpdateCell, tableDeleteRow as _tableDeleteRow, tableDeleteColumn as _tableDeleteColumn, tableClearColumnData as _tableClearColumnData, tableInsertRow as _tableInsertRow, tableInsertColumn as _tableInsertColumn, sheetGetTable as _sheetGetTable, sheetToMarkdown as _sheetToMarkdown, workbookGetSheet as _workbookGetSheet, workbookToMarkdown as _workbookToMarkdown, workbookAddSheet as _workbookAddSheet, workbookDeleteSheet as _workbookDeleteSheet } from '../dist/parser.js';
-// @ts-ignore
-import path from 'node:path';
-// @ts-ignore
-import process from 'node:process';
-// @ts-ignore
-import { _addPreopen } from '@bytecodealliance/preview2-shim/filesystem';
 import { clientSideToModels } from './client-adapters.js';
 
-// @ts-ignore
-_addPreopen('/', path.parse(process.cwd()).root);
+// Environment detection
+// @ts-ignore - process may not be defined in browser
+const isNode = typeof process !== 'undefined'
+    && typeof process.versions !== 'undefined'
+    && typeof process.versions.node !== 'undefined';
+
+// Lazily loaded Node.js modules (only in Node.js environment)
+let _pathModule: any = null;
+let _nodeInitialized = false;
+
+/**
+ * Ensures Node.js environment is initialized for file system operations.
+ * Throws an error in browser environments.
+ */
+async function ensureNodeEnvironment(): Promise<void> {
+    if (!isNode) {
+        throw new Error(
+            'File system operations (parseTableFromFile, parseWorkbookFromFile, scanTablesFromFile) ' +
+            'are not supported in browser environments. ' +
+            'Use parseTable(), parseWorkbook(), or scanTables() with string content instead.'
+        );
+    }
+    if (_nodeInitialized) return;
+
+    // Dynamic imports for Node.js only
+    const [pathModule, processModule, fsShim] = await Promise.all([
+        import('node:path'),
+        import('node:process'),
+        import('@bytecodealliance/preview2-shim/filesystem')
+    ]);
+
+    _pathModule = pathModule.default || pathModule;
+    const proc = processModule.default || processModule;
+    const root = _pathModule.parse(proc.cwd()).root;
+    // @ts-ignore - _addPreopen is an internal function
+    (fsShim as any)._addPreopen('/', root);
+    _nodeInitialized = true;
+}
 
-function resolveToVirtualPath(p: string) {
-    return path.resolve(p);
+function resolveToVirtualPath(p: string): string {
+    if (!_pathModule) {
+        throw new Error('Node.js modules not initialized. Call ensureNodeEnvironment() first.');
+    }
+    return _pathModule.resolve(p);
 }
 
 export function cleanCell(cell: any, schema: any): any {
@@ -74,19 +107,22 @@ export function generateWorkbookMarkdown(workbook: any, schema: any): any {
     return res;
 }
 
-export function parseTableFromFile(source: any, schema?: any): any {
+export async function parseTableFromFile(source: any, schema?: any): Promise<any> {
+    await ensureNodeEnvironment();
     const source_resolved = resolveToVirtualPath(source);
     const res = _parseTableFromFile(source_resolved, schema);
     return new Table(res);
 }
 
-export function parseWorkbookFromFile(source: any, schema?: any): any {
+export async function parseWorkbookFromFile(source: any, schema?: any): Promise<any> {
+    await ensureNodeEnvironment();
     const source_resolved = resolveToVirtualPath(source);
     const res = _parseWorkbookFromFile(source_resolved, schema);
     return new Workbook(res);
 }
 
-export function scanTablesFromFile(source: any, schema?: any): any {
+export async function scanTablesFromFile(source: any, schema?: any): Promise<any> {
+    await ensureNodeEnvironment();
     const source_resolved = resolveToVirtualPath(source);
     const res = _scanTablesFromFile(source_resolved, schema);
     return res.map((x: any) => new Table(x));
@@ -243,7 +279,7 @@ export class Workbook {
         return res ? new Sheet(res) : undefined;
     }
 
-    toMarkdown(schema: any): any {
+    toMarkdown(schema?: any): any {
         const dto = this.toDTO();
         const res = _workbookToMarkdown(dto, schema);
         return res;