oxc-parser 0.21.0 → 0.22.0

package/index.d.ts

@@ -1,7 +1,26 @@
-/* tslint:disable */
+/* auto-generated by NAPI-RS */
 /* eslint-disable */
+export interface Comment {
+  type: 'Line' | 'Block'
+  value: string
+  start: number
+  end: number
+}
 
-/* auto-generated by NAPI-RS */
+export interface ExportSpecifier {
+  /** Exported name */
+  n: string
+  /** Local name, or undefined. */
+  ln?: string
+  /** Start of exported name */
+  s: number
+  /** End of exported name */
+  e: number
+  /** Start of local name */
+  ls?: number
+  /** End of local name */
+  le?: number
+}
 
 export interface ImportSpecifier {
   /**
@@ -33,20 +52,7 @@ export interface ImportSpecifier {
    */
   a: number
 }
-export interface ExportSpecifier {
-  /** Exported name */
-  n: string
-  /** Local name, or undefined. */
-  ln?: string
-  /** Start of exported name */
-  s: number
-  /** End of exported name */
-  e: number
-  /** Start of local name */
-  ls?: number
-  /** End of local name */
-  le?: number
-}
+
 export interface ModuleLexer {
   imports: Array<ImportSpecifier>
   exports: Array<ExportSpecifier>
@@ -59,6 +65,14 @@ export interface ModuleLexer {
   /** Facade modules that only use import / export syntax */
   facade: boolean
 }
+
+/**
+ * # Panics
+ *
+ * * Tokio crashes
+ */
+export declare function moduleLexerAsync(sourceText: string, options?: ParserOptions | undefined | null): Promise<ModuleLexer>
+
 /**
  * Outputs the list of exports and locations of import specifiers,
  * including dynamic import and import meta handling.
@@ -67,13 +81,21 @@ export interface ModuleLexer {
  *
  * * File extension is invalid
  */
-export function moduleLexerSync(sourceText: string, options?: ParserOptions | undefined | null): ModuleLexer
+export declare function moduleLexerSync(sourceText: string, options?: ParserOptions | undefined | null): ModuleLexer
+
 /**
  * # Panics
  *
  * * Tokio crashes
  */
-export function moduleLexerAsync(sourceText: string, options?: ParserOptions | undefined | null): Promise<ModuleLexer>
+export declare function parseAsync(sourceText: string, options?: ParserOptions | undefined | null): Promise<ParseResult>
+
+export interface ParseResult {
+  program: string
+  comments: Array<Comment>
+  errors: Array<string>
+}
+
 /**
  * Babel Parser Options
  *
@@ -93,37 +115,23 @@ export interface ParserOptions {
    */
   preserveParens?: boolean
 }
-export interface ParseResult {
-  program: string
-  comments: Array<Comment>
-  errors: Array<string>
-}
-export interface Comment {
-  type: 'Line' | 'Block'
-  value: string
-  start: number
-  end: number
-}
+
 /**
- * Parse without returning anything.
- * This is for benchmark purposes such as measuring napi communication overhead.
- *
  * # Panics
  *
  * * File extension is invalid
  * * Serde JSON serialization
  */
-export function parseWithoutReturn(sourceText: string, options?: ParserOptions | undefined | null): void
+export declare function parseSync(sourceText: string, options?: ParserOptions | undefined | null): ParseResult
+
 /**
+ * Parse without returning anything.
+ * This is for benchmark purposes such as measuring napi communication overhead.
+ *
  * # Panics
  *
  * * File extension is invalid
  * * Serde JSON serialization
  */
-export function parseSync(sourceText: string, options?: ParserOptions | undefined | null): ParseResult
-/**
- * # Panics
- *
- * * Tokio crashes
- */
-export function parseAsync(sourceText: string, options?: ParserOptions | undefined | null): Promise<ParseResult>
+export declare function parseWithoutReturn(sourceText: string, options?: ParserOptions | undefined | null): void
+

package/index.js

@@ -1,304 +1,368 @@
-/* tslint:disable */
+// prettier-ignore
 /* eslint-disable */
-/* prettier-ignore */
-
 /* auto-generated by NAPI-RS */
 
-const { existsSync, readFileSync } = require('fs')
-const { join } = require('path')
-
-const { platform, arch } = process
+const { readFileSync } = require('fs')
 
 let nativeBinding = null
-let localFileExisted = false
-let loadError = null
+const loadErrors = []
 
-function isMusl() {
-  // For Node 10
-  if (!process.report || typeof process.report.getReport !== 'function') {
-    try {
-      const lddPath = require('child_process').execSync('which ldd').toString().trim()
-      return readFileSync(lddPath, 'utf8').includes('musl')
-    } catch (e) {
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  const report = typeof process.report.getReport === 'function' ? process.report.getReport() : null
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
       return true
     }
-  } else {
-    const { glibcVersionRuntime } = process.report.getReport().header
-    return !glibcVersionRuntime
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
   }
 }
 
-switch (platform) {
-  case 'android':
-    switch (arch) {
-      case 'arm64':
-        localFileExisted = existsSync(join(__dirname, 'parser.android-arm64.node'))
+function requireNative() {
+  if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./parser.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-android-arm64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./parser.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-android-arm-eabi')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./parser.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-win32-x64-msvc')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./parser.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-win32-ia32-msvc')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./parser.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-win32-arm64-msvc')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+        return require('./parser.darwin-universal.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-darwin-universal')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    if (process.arch === 'x64') {
+      try {
+        return require('./parser.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-darwin-x64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./parser.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-darwin-arm64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./parser.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-freebsd-x64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./parser.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-freebsd-arm64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.android-arm64.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-android-arm64')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'arm':
-        localFileExisted = existsSync(join(__dirname, 'parser.android-arm-eabi.node'))
+        return require('./parser.linux-x64-musl.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-x64-musl')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      } else {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.android-arm-eabi.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-android-arm-eabi')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Android ${arch}`)
-    }
-    break
-  case 'win32':
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(
-          join(__dirname, 'parser.win32-x64-msvc.node')
-        )
+        return require('./parser.linux-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-x64-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.win32-x64-msvc.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-win32-x64-msvc')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'ia32':
-        localFileExisted = existsSync(
-          join(__dirname, 'parser.win32-ia32-msvc.node')
-        )
+        return require('./parser.linux-arm64-musl.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-arm64-musl')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      } else {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.win32-ia32-msvc.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-win32-ia32-msvc')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'parser.win32-arm64-msvc.node')
-        )
+        return require('./parser.linux-arm64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-arm64-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.win32-arm64-msvc.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-win32-arm64-msvc')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Windows: ${arch}`)
-    }
-    break
-  case 'darwin':
-    localFileExisted = existsSync(join(__dirname, 'parser.darwin-universal.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./parser.darwin-universal.node')
+        return require('./parser.linux-arm-musleabihf.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-arm-musleabihf')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
       } else {
-        nativeBinding = require('@oxc-parser/binding-darwin-universal')
+        try {
+        return require('./parser.linux-arm-gnueabihf.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-arm-gnueabihf')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
       }
-      break
-    } catch {}
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'parser.darwin-x64.node'))
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.darwin-x64.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-darwin-x64')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'parser.darwin-arm64.node')
-        )
+        return require('./parser.linux-riscv64-musl.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-riscv64-musl')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      } else {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.darwin-arm64.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-darwin-arm64')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      default:
-        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+        return require('./parser.linux-riscv64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-riscv64-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./parser.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-ppc64-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./parser.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@oxc-parser/binding-linux-s390x-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
     }
-    break
-  case 'freebsd':
-    if (arch !== 'x64') {
-      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  try {
+    nativeBinding = require('./parser.wasi.cjs')
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      console.error(err)
     }
-    localFileExisted = existsSync(join(__dirname, 'parser.freebsd-x64.node'))
+  }
+  if (!nativeBinding) {
     try {
-      if (localFileExisted) {
-        nativeBinding = require('./parser.freebsd-x64.node')
-      } else {
-        nativeBinding = require('@oxc-parser/binding-freebsd-x64')
+      nativeBinding = require('@oxc-parser/binding-wasm32-wasi')
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        console.error(err)
       }
-    } catch (e) {
-      loadError = e
-    }
-    break
-  case 'linux':
-    switch (arch) {
-      case 'x64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'parser.linux-x64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./parser.linux-x64-musl.node')
-            } else {
-              nativeBinding = require('@oxc-parser/binding-linux-x64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'parser.linux-x64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./parser.linux-x64-gnu.node')
-            } else {
-              nativeBinding = require('@oxc-parser/binding-linux-x64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        }
-        break
-      case 'arm64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'parser.linux-arm64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./parser.linux-arm64-musl.node')
-            } else {
-              nativeBinding = require('@oxc-parser/binding-linux-arm64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'parser.linux-arm64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./parser.linux-arm64-gnu.node')
-            } else {
-              nativeBinding = require('@oxc-parser/binding-linux-arm64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        }
-        break
-      case 'arm':
-        localFileExisted = existsSync(
-          join(__dirname, 'parser.linux-arm-gnueabihf.node')
-        )
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.linux-arm-gnueabihf.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-linux-arm-gnueabihf')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      case 'riscv64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'parser.linux-riscv64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./parser.linux-riscv64-musl.node')
-            } else {
-              nativeBinding = require('@oxc-parser/binding-linux-riscv64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'parser.linux-riscv64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./parser.linux-riscv64-gnu.node')
-            } else {
-              nativeBinding = require('@oxc-parser/binding-linux-riscv64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        }
-        break
-      case 's390x':
-        localFileExisted = existsSync(
-          join(__dirname, 'parser.linux-s390x-gnu.node')
-        )
-        try {
-          if (localFileExisted) {
-            nativeBinding = require('./parser.linux-s390x-gnu.node')
-          } else {
-            nativeBinding = require('@oxc-parser/binding-linux-s390x-gnu')
-          }
-        } catch (e) {
-          loadError = e
-        }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Linux: ${arch}`)
     }
-    break
-  default:
-    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+  }
 }
 
 if (!nativeBinding) {
-  if (loadError) {
-    throw loadError
+  if (loadErrors.length > 0) {
+    // TODO Link to documentation with potential fixes
+    //  - The package owner could build/publish bindings for this arch
+    //  - The user may need to bundle the correct files
+    //  - The user may need to re-install node_modules to get new packages
+    throw new Error('Failed to load native binding', { cause: loadErrors })
   }
   throw new Error(`Failed to load native binding`)
 }
 
-const { moduleLexerSync, moduleLexerAsync, parseWithoutReturn, parseSync, parseAsync } = nativeBinding
-
-module.exports.moduleLexerSync = moduleLexerSync
-module.exports.moduleLexerAsync = moduleLexerAsync
-module.exports.parseWithoutReturn = parseWithoutReturn
-module.exports.parseSync = parseSync
-module.exports.parseAsync = parseAsync
+module.exports.moduleLexerAsync = nativeBinding.moduleLexerAsync
+module.exports.moduleLexerSync = nativeBinding.moduleLexerSync
+module.exports.parseAsync = nativeBinding.parseAsync
+module.exports.parseSync = nativeBinding.parseSync
+module.exports.parseWithoutReturn = nativeBinding.parseWithoutReturn

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxc-parser",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Oxc Parser Node API",
   "keywords": [
     "Parser"
@@ -23,13 +23,13 @@
     "index.js"
   ],
   "optionalDependencies": {
-    "@oxc-parser/binding-win32-x64-msvc": "0.21.0",
-    "@oxc-parser/binding-win32-arm64-msvc": "0.21.0",
-    "@oxc-parser/binding-linux-x64-gnu": "0.21.0",
-    "@oxc-parser/binding-linux-arm64-gnu": "0.21.0",
-    "@oxc-parser/binding-linux-x64-musl": "0.21.0",
-    "@oxc-parser/binding-linux-arm64-musl": "0.21.0",
-    "@oxc-parser/binding-darwin-x64": "0.21.0",
-    "@oxc-parser/binding-darwin-arm64": "0.21.0"
+    "@oxc-parser/binding-win32-x64-msvc": "0.22.0",
+    "@oxc-parser/binding-win32-arm64-msvc": "0.22.0",
+    "@oxc-parser/binding-linux-x64-gnu": "0.22.0",
+    "@oxc-parser/binding-linux-arm64-gnu": "0.22.0",
+    "@oxc-parser/binding-linux-x64-musl": "0.22.0",
+    "@oxc-parser/binding-linux-arm64-musl": "0.22.0",
+    "@oxc-parser/binding-darwin-x64": "0.22.0",
+    "@oxc-parser/binding-darwin-arm64": "0.22.0"
   }
 }