oxc-parser 0.56.5 → 0.58.0

package/README.md

@@ -4,12 +4,15 @@
 
 ### ESTree
 
-The returned JavaScript AST follows the [ESTree](https://github.com/estree/estree) specification.
+When parsing `.js` or `.jsx` files, the AST returned is fully conformant with the
+[ESTree standard](https://github.com/estree/estree).
 
 It is fully aligned with Acorn's AST, and any deviation would be considered a bug.
 
 The returned TypeScript AST will conform to [@typescript-eslint/typescript-estree](https://www.npmjs.com/package/@typescript-eslint/typescript-estree) in the near future.
 
+If you need all ASTs in the same with-TS-properties format, use the `astType: 'ts'` option.
+
 ### AST Types
 
 [@oxc-project/types](https://www.npmjs.com/package/@oxc-project/types) can be used. For example:
@@ -41,17 +44,6 @@ Fast mode is best suited for parser plugins, where other parts of your build pip
 
 Please note that turning off fast mode ​incurs​ a small performance overhead.
 
-### ESTree compatibility
-
-When parsing JS or JSX files, the AST returned is fully conformant with the
-[ESTree standard](https://github.com/estree/estree).
-
-When parsing TS or TSX files, the AST has additional properties related to TypeScript syntax.
-These extra properties are broadly (but not entirely) in line with
-[TypeScript ESLint](https://typescript-eslint.io/packages/parser/)'s AST.
-
-If you need all ASTs in the same with-TS-properties format, use the `astType: 'ts'` option.
-
 ### Returns ESM information.
 
 It is likely that you are writing a parser plugin that requires ESM information.

package/deserialize-js.js

@@ -894,13 +894,13 @@ function deserializeAccessorProperty(pos) {
 }
 
 function deserializeImportExpression(pos) {
-  const args = deserializeVecExpression(pos + 24);
+  const options = deserializeVecExpression(pos + 24);
   return {
     type: 'ImportExpression',
     start: deserializeU32(pos),
     end: deserializeU32(pos + 4),
     source: deserializeExpression(pos + 8),
-    options: args.length === 0 ? null : args[0],
+    options: options.length === 0 ? null : options[0],
   };
 }
 
@@ -1180,7 +1180,7 @@ function deserializeJSXNamespacedName(pos) {
     start: deserializeU32(pos),
     end: deserializeU32(pos + 4),
     namespace: deserializeJSXIdentifier(pos + 8),
-    property: deserializeJSXIdentifier(pos + 32),
+    name: deserializeJSXIdentifier(pos + 32),
   };
 }
 
@@ -1254,6 +1254,7 @@ function deserializeJSXText(pos) {
     start: deserializeU32(pos),
     end: deserializeU32(pos + 4),
     value: deserializeStr(pos + 8),
+    raw: deserializeOptionStr(pos + 24),
   };
 }
 
@@ -1771,11 +1772,11 @@ function deserializeTSImportType(pos) {
     type: 'TSImportType',
     start: deserializeU32(pos),
     end: deserializeU32(pos + 4),
-    isTypeOf: deserializeBool(pos + 8),
-    parameter: deserializeTSType(pos + 16),
+    argument: deserializeTSType(pos + 8),
+    options: deserializeOptionBoxTSImportAttributes(pos + 24),
     qualifier: deserializeOptionTSTypeName(pos + 32),
-    attributes: deserializeOptionBoxTSImportAttributes(pos + 48),
-    typeParameters: deserializeOptionBoxTSTypeParameterInstantiation(pos + 56),
+    typeArguments: deserializeOptionBoxTSTypeParameterInstantiation(pos + 48),
+    isTypeOf: deserializeBool(pos + 56),
   };
 }
 
@@ -5515,11 +5516,6 @@ function deserializeBoxTSTypeParameter(pos) {
   return deserializeTSTypeParameter(uint32[pos >> 2]);
 }
 
-function deserializeOptionTSTypeName(pos) {
-  if (uint8[pos] === 2) return null;
-  return deserializeTSTypeName(pos);
-}
-
 function deserializeBoxTSImportAttributes(pos) {
   return deserializeTSImportAttributes(uint32[pos >> 2]);
 }
@@ -5529,6 +5525,11 @@ function deserializeOptionBoxTSImportAttributes(pos) {
   return deserializeBoxTSImportAttributes(pos);
 }
 
+function deserializeOptionTSTypeName(pos) {
+  if (uint8[pos] === 2) return null;
+  return deserializeTSTypeName(pos);
+}
+
 function deserializeVecTSImportAttribute(pos) {
   const arr = [],
     pos32 = pos >> 2,

package/deserialize-ts.js

@@ -941,13 +941,13 @@ function deserializeAccessorProperty(pos) {
 }
 
 function deserializeImportExpression(pos) {
-  const args = deserializeVecExpression(pos + 24);
+  const options = deserializeVecExpression(pos + 24);
   return {
     type: 'ImportExpression',
     start: deserializeU32(pos),
     end: deserializeU32(pos + 4),
     source: deserializeExpression(pos + 8),
-    options: args.length === 0 ? null : args[0],
+    options: options.length === 0 ? null : options[0],
   };
 }
 
@@ -1233,7 +1233,7 @@ function deserializeJSXNamespacedName(pos) {
     start: deserializeU32(pos),
     end: deserializeU32(pos + 4),
     namespace: deserializeJSXIdentifier(pos + 8),
-    property: deserializeJSXIdentifier(pos + 32),
+    name: deserializeJSXIdentifier(pos + 32),
   };
 }
 
@@ -1307,6 +1307,7 @@ function deserializeJSXText(pos) {
     start: deserializeU32(pos),
     end: deserializeU32(pos + 4),
     value: deserializeStr(pos + 8),
+    raw: deserializeOptionStr(pos + 24),
   };
 }
 
@@ -1824,11 +1825,11 @@ function deserializeTSImportType(pos) {
     type: 'TSImportType',
     start: deserializeU32(pos),
     end: deserializeU32(pos + 4),
-    isTypeOf: deserializeBool(pos + 8),
-    parameter: deserializeTSType(pos + 16),
+    argument: deserializeTSType(pos + 8),
+    options: deserializeOptionBoxTSImportAttributes(pos + 24),
     qualifier: deserializeOptionTSTypeName(pos + 32),
-    attributes: deserializeOptionBoxTSImportAttributes(pos + 48),
-    typeParameters: deserializeOptionBoxTSTypeParameterInstantiation(pos + 56),
+    typeArguments: deserializeOptionBoxTSTypeParameterInstantiation(pos + 48),
+    isTypeOf: deserializeBool(pos + 56),
   };
 }
 
@@ -5568,11 +5569,6 @@ function deserializeBoxTSTypeParameter(pos) {
   return deserializeTSTypeParameter(uint32[pos >> 2]);
 }
 
-function deserializeOptionTSTypeName(pos) {
-  if (uint8[pos] === 2) return null;
-  return deserializeTSTypeName(pos);
-}
-
 function deserializeBoxTSImportAttributes(pos) {
   return deserializeTSImportAttributes(uint32[pos >> 2]);
 }
@@ -5582,6 +5578,11 @@ function deserializeOptionBoxTSImportAttributes(pos) {
   return deserializeBoxTSImportAttributes(pos);
 }
 
+function deserializeOptionTSTypeName(pos) {
+  if (uint8[pos] === 2) return null;
+  return deserializeTSTypeName(pos);
+}
+
 function deserializeVecTSImportAttribute(pos) {
   const arr = [],
     pos32 = pos >> 2,

package/index.d.ts

@@ -151,11 +151,11 @@ export interface ParserOptions {
    */
   astType?: 'js' | 'ts'
   /**
-   * Emit `ParenthesizedExpression` in AST.
+   * Emit `ParenthesizedExpression` and `TSParenthesizedType` in AST.
    *
    * If this option is true, parenthesized expressions are represented by
-   * (non-standard) `ParenthesizedExpression` nodes that have a single `expression` property
-   * containing the expression inside parentheses.
+   * (non-standard) `ParenthesizedExpression` and `TSParenthesizedType` nodes that
+   * have a single `expression` property containing the expression inside parentheses.
    *
    * @default true
    */

package/index.js

@@ -69,7 +69,10 @@ let buffer, encoder;
 
 function parseSyncRaw(filename, sourceText, options) {
   if (!rawTransferSupported()) {
-    throw new Error('`experimentalRawTransfer` option is not supported on 32-bit or big-endian systems');
+    throw new Error(
+      '`experimentalRawTransfer` option is not supported on 32-bit or big-endian systems, ' +
+        'versions of NodeJS prior to v22.0.0, versions of Deno prior to v2.0.0, and other runtimes',
+    );
   }
 
   // Delete `experimentalRawTransfer` option
@@ -146,10 +149,45 @@ function createBuffer() {
 let rawTransferIsSupported = null;
 
 // Returns `true` if `experimentalRawTransfer` is option is supported.
-// Raw transfer is only available on 64-bit little-endian systems.
+//
+// Raw transfer is only supported on 64-bit little-endian systems,
+// and NodeJS >= v22.0.0 or Deno >= v2.0.0.
+//
+// Versions of NodeJS prior to v22.0.0 do not support creating an `ArrayBuffer` larger than 4 GiB.
+// Bun (as at v1.2.4) also does not support creating an `ArrayBuffer` larger than 4 GiB.
+// Support on Deno v1 is unknown and it's EOL, so treating Deno before v2.0.0 as unsupported.
 function rawTransferSupported() {
-  if (rawTransferIsSupported === null) rawTransferIsSupported = bindings.rawTransferSupported();
+  if (rawTransferIsSupported === null) {
+    rawTransferIsSupported = rawTransferRuntimeSupported() && bindings.rawTransferSupported();
+  }
   return rawTransferIsSupported;
 }
 
 module.exports.rawTransferSupported = rawTransferSupported;
+
+// Checks copied from:
+// https://github.com/unjs/std-env/blob/ab15595debec9e9115a9c1d31bc7597a8e71dbfd/src/runtimes.ts
+// MIT license: https://github.com/unjs/std-env/blob/ab15595debec9e9115a9c1d31bc7597a8e71dbfd/LICENCE
+function rawTransferRuntimeSupported() {
+  let global;
+  try {
+    global = globalThis;
+  } catch (e) {
+    return false;
+  }
+
+  const isBun = !!global.Bun || !!global.process?.versions?.bun;
+  if (isBun) return false;
+
+  const isDeno = !!global.Deno;
+  if (isDeno) {
+    const match = Deno.version?.deno?.match(/^(\d+)\./);
+    return !!match && match[1] * 1 >= 2;
+  }
+
+  const isNode = global.process?.release?.name === 'node';
+  if (!isNode) return false;
+
+  const match = process.version?.match(/^v(\d+)\./);
+  return !!match && match[1] * 1 >= 22;
+}

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "oxc-parser",
-  "version": "0.56.5",
+  "version": "0.58.0",
   "main": "index.js",
   "browser": "browser.js",
+  "engines": {
+    "node": ">=14.0.0"
+  },
   "description": "Oxc Parser Node API",
   "keywords": [
     "oxc",
@@ -15,7 +18,7 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/oxc-project/oxc.git",
-    "directory": "npm/oxc-parser"
+    "directory": "napi/parser"
   },
   "funding": {
     "url": "https://github.com/sponsors/Boshen"
@@ -33,10 +36,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@oxc-project/types": "^0.56.5"
+    "@oxc-project/types": "^0.58.0"
   },
-  "engines": {
-    "node": ">=14.0.0"
+  "devDependencies": {
+    "@codspeed/vitest-plugin": "^4.0.0",
+    "vitest": "3.0.7"
   },
   "napi": {
     "binaryName": "parser",
@@ -61,15 +65,21 @@
     "dtsHeaderFile": "header.js"
   },
   "optionalDependencies": {
-    "@oxc-parser/binding-win32-x64-msvc": "0.56.5",
-    "@oxc-parser/binding-win32-arm64-msvc": "0.56.5",
-    "@oxc-parser/binding-linux-x64-gnu": "0.56.5",
-    "@oxc-parser/binding-linux-x64-musl": "0.56.5",
-    "@oxc-parser/binding-linux-arm64-gnu": "0.56.5",
-    "@oxc-parser/binding-linux-arm64-musl": "0.56.5",
-    "@oxc-parser/binding-linux-arm-gnueabihf": "0.56.5",
-    "@oxc-parser/binding-darwin-x64": "0.56.5",
-    "@oxc-parser/binding-darwin-arm64": "0.56.5",
-    "@oxc-parser/binding-wasm32-wasi": "0.56.5"
+    "@oxc-parser/binding-win32-x64-msvc": "0.58.0",
+    "@oxc-parser/binding-win32-arm64-msvc": "0.58.0",
+    "@oxc-parser/binding-linux-x64-gnu": "0.58.0",
+    "@oxc-parser/binding-linux-x64-musl": "0.58.0",
+    "@oxc-parser/binding-linux-arm64-gnu": "0.58.0",
+    "@oxc-parser/binding-linux-arm64-musl": "0.58.0",
+    "@oxc-parser/binding-linux-arm-gnueabihf": "0.58.0",
+    "@oxc-parser/binding-darwin-x64": "0.58.0",
+    "@oxc-parser/binding-darwin-arm64": "0.58.0",
+    "@oxc-parser/binding-wasm32-wasi": "0.58.0"
+  },
+  "scripts": {
+    "build-dev": "napi build --no-dts-cache --platform --js bindings.js",
+    "build": "pnpm run build-dev --release",
+    "test": "vitest --typecheck run ./test && tsc",
+    "bench": "vitest bench --run ./bench.bench.mjs"
   }
 }