oxc-parser 0.76.0 → 0.77.1

package/generated/constants.js

@@ -0,0 +1,16 @@
+// Auto-generated code, DO NOT EDIT DIRECTLY!
+// To edit this generated file you have to edit `tasks/ast_tools/src/generators/raw_transfer.rs`.
+
+const BUFFER_SIZE = 2147483632,
+  BUFFER_ALIGN = 4294967296,
+  DATA_POINTER_POS_32 = 536870906,
+  IS_TS_FLAG_POS = 2147483628,
+  PROGRAM_OFFSET = 0;
+
+module.exports = {
+  BUFFER_SIZE,
+  BUFFER_ALIGN,
+  DATA_POINTER_POS_32,
+  IS_TS_FLAG_POS,
+  PROGRAM_OFFSET,
+};

package/generated/deserialize/js.js

@@ -20,10 +20,7 @@ function deserialize(buffer, sourceTextInput, sourceLenInput) {
   sourceLen = sourceLenInput;
   sourceIsAscii = sourceText.length === sourceLen;
 
-  // (2 * 1024 * 1024 * 1024 - 16) >> 2
-  const metadataPos32 = 536870908;
-
-  const data = deserializeRawTransferData(uint32[metadataPos32]);
+  const data = deserializeRawTransferData(uint32[536870906]);
 
   uint8 =
     uint32 =
@@ -1627,9 +1624,10 @@ function deserializeTSTypeAliasDeclaration(pos) {
 function deserializeTSClassImplements(pos) {
   let expression = deserializeTSTypeName(pos + 8);
   if (expression.type === 'TSQualifiedName') {
+    let object = expression.left;
     let parent = expression = {
       type: 'MemberExpression',
-      object: expression.left,
+      object,
       property: expression.right,
       optional: false,
       computed: false,
@@ -1637,17 +1635,18 @@ function deserializeTSClassImplements(pos) {
       end: expression.end,
     };
 
-    while (parent.object.type === 'TSQualifiedName') {
-      const object = parent.object;
+    while (object.type === 'TSQualifiedName') {
+      const { left } = object;
       parent = parent.object = {
         type: 'MemberExpression',
-        object: object.left,
+        object: left,
         property: object.right,
         optional: false,
         computed: false,
         start: object.start,
         end: object.end,
       };
+      object = left;
     }
   }
   return {
@@ -3637,11 +3636,11 @@ function deserializeTSTupleElement(pos) {
 function deserializeTSTypeName(pos) {
   switch (uint8[pos]) {
     case 0:
-      let id = deserializeBoxIdentifierReference(pos + 8);
-      if (id.name === 'this') id = { type: 'ThisExpression', start: id.start, end: id.end };
-      return id;
+      return deserializeBoxIdentifierReference(pos + 8);
     case 1:
       return deserializeBoxTSQualifiedName(pos + 8);
+    case 2:
+      return deserializeBoxThisExpression(pos + 8);
     default:
       throw new Error(`Unexpected discriminant ${uint8[pos]} for TSTypeName`);
   }
@@ -3739,12 +3738,12 @@ function deserializeTSModuleDeclarationBody(pos) {
 function deserializeTSTypeQueryExprName(pos) {
   switch (uint8[pos]) {
     case 0:
-      let id = deserializeBoxIdentifierReference(pos + 8);
-      if (id.name === 'this') id = { type: 'ThisExpression', start: id.start, end: id.end };
-      return id;
+      return deserializeBoxIdentifierReference(pos + 8);
     case 1:
       return deserializeBoxTSQualifiedName(pos + 8);
     case 2:
+      return deserializeBoxThisExpression(pos + 8);
+    case 3:
       return deserializeBoxTSImportType(pos + 8);
     default:
       throw new Error(`Unexpected discriminant ${uint8[pos]} for TSTypeQueryExprName`);
@@ -3767,12 +3766,12 @@ function deserializeTSMappedTypeModifierOperator(pos) {
 function deserializeTSModuleReference(pos) {
   switch (uint8[pos]) {
     case 0:
-      let id = deserializeBoxIdentifierReference(pos + 8);
-      if (id.name === 'this') id = { type: 'ThisExpression', start: id.start, end: id.end };
-      return id;
+      return deserializeBoxIdentifierReference(pos + 8);
     case 1:
       return deserializeBoxTSQualifiedName(pos + 8);
     case 2:
+      return deserializeBoxThisExpression(pos + 8);
+    case 3:
       return deserializeBoxTSExternalModuleReference(pos + 8);
     default:
       throw new Error(`Unexpected discriminant ${uint8[pos]} for TSModuleReference`);
@@ -5222,7 +5221,7 @@ function deserializeOptionBoxObjectExpression(pos) {
 }
 
 function deserializeOptionTSTypeName(pos) {
-  if (uint8[pos] === 2) return null;
+  if (uint8[pos] === 3) return null;
   return deserializeTSTypeName(pos);
 }
 

package/generated/deserialize/ts.js

@@ -20,10 +20,7 @@ function deserialize(buffer, sourceTextInput, sourceLenInput) {
   sourceLen = sourceLenInput;
   sourceIsAscii = sourceText.length === sourceLen;
 
-  // (2 * 1024 * 1024 * 1024 - 16) >> 2
-  const metadataPos32 = 536870908;
-
-  const data = deserializeRawTransferData(uint32[metadataPos32]);
+  const data = deserializeRawTransferData(uint32[536870906]);
 
   uint8 =
     uint32 =
@@ -1758,9 +1755,10 @@ function deserializeTSTypeAliasDeclaration(pos) {
 function deserializeTSClassImplements(pos) {
   let expression = deserializeTSTypeName(pos + 8);
   if (expression.type === 'TSQualifiedName') {
+    let object = expression.left;
     let parent = expression = {
       type: 'MemberExpression',
-      object: expression.left,
+      object,
       property: expression.right,
       optional: false,
       computed: false,
@@ -1768,17 +1766,18 @@ function deserializeTSClassImplements(pos) {
       end: expression.end,
     };
 
-    while (parent.object.type === 'TSQualifiedName') {
-      const object = parent.object;
+    while (object.type === 'TSQualifiedName') {
+      const { left } = object;
       parent = parent.object = {
         type: 'MemberExpression',
-        object: object.left,
+        object: left,
         property: object.right,
         optional: false,
         computed: false,
         start: object.start,
         end: object.end,
       };
+      object = left;
     }
   }
   return {
@@ -3768,11 +3767,11 @@ function deserializeTSTupleElement(pos) {
 function deserializeTSTypeName(pos) {
   switch (uint8[pos]) {
     case 0:
-      let id = deserializeBoxIdentifierReference(pos + 8);
-      if (id.name === 'this') id = { type: 'ThisExpression', start: id.start, end: id.end };
-      return id;
+      return deserializeBoxIdentifierReference(pos + 8);
     case 1:
       return deserializeBoxTSQualifiedName(pos + 8);
+    case 2:
+      return deserializeBoxThisExpression(pos + 8);
     default:
       throw new Error(`Unexpected discriminant ${uint8[pos]} for TSTypeName`);
   }
@@ -3870,12 +3869,12 @@ function deserializeTSModuleDeclarationBody(pos) {
 function deserializeTSTypeQueryExprName(pos) {
   switch (uint8[pos]) {
     case 0:
-      let id = deserializeBoxIdentifierReference(pos + 8);
-      if (id.name === 'this') id = { type: 'ThisExpression', start: id.start, end: id.end };
-      return id;
+      return deserializeBoxIdentifierReference(pos + 8);
     case 1:
       return deserializeBoxTSQualifiedName(pos + 8);
     case 2:
+      return deserializeBoxThisExpression(pos + 8);
+    case 3:
       return deserializeBoxTSImportType(pos + 8);
     default:
       throw new Error(`Unexpected discriminant ${uint8[pos]} for TSTypeQueryExprName`);
@@ -3898,12 +3897,12 @@ function deserializeTSMappedTypeModifierOperator(pos) {
 function deserializeTSModuleReference(pos) {
   switch (uint8[pos]) {
     case 0:
-      let id = deserializeBoxIdentifierReference(pos + 8);
-      if (id.name === 'this') id = { type: 'ThisExpression', start: id.start, end: id.end };
-      return id;
+      return deserializeBoxIdentifierReference(pos + 8);
     case 1:
       return deserializeBoxTSQualifiedName(pos + 8);
     case 2:
+      return deserializeBoxThisExpression(pos + 8);
+    case 3:
       return deserializeBoxTSExternalModuleReference(pos + 8);
     default:
       throw new Error(`Unexpected discriminant ${uint8[pos]} for TSModuleReference`);
@@ -5353,7 +5352,7 @@ function deserializeOptionBoxObjectExpression(pos) {
 }
 
 function deserializeOptionTSTypeName(pos) {
-  if (uint8[pos] === 2) return null;
+  if (uint8[pos] === 3) return null;
   return deserializeTSTypeName(pos);
 }
 

package/generated/lazy/constructors.js

@@ -9286,6 +9286,8 @@ function constructTSTypeName(pos, ast) {
       return constructBoxIdentifierReference(pos + 8, ast);
     case 1:
       return constructBoxTSQualifiedName(pos + 8, ast);
+    case 2:
+      return constructBoxThisExpression(pos + 8, ast);
     default:
       throw new Error(`Unexpected discriminant ${ast.buffer[pos]} for TSTypeName`);
   }
@@ -10603,6 +10605,8 @@ function constructTSTypeQueryExprName(pos, ast) {
     case 1:
       return constructBoxTSQualifiedName(pos + 8, ast);
     case 2:
+      return constructBoxThisExpression(pos + 8, ast);
+    case 3:
       return constructBoxTSImportType(pos + 8, ast);
     default:
       throw new Error(`Unexpected discriminant ${ast.buffer[pos]} for TSTypeQueryExprName`);
@@ -11149,6 +11153,8 @@ function constructTSModuleReference(pos, ast) {
     case 1:
       return constructBoxTSQualifiedName(pos + 8, ast);
     case 2:
+      return constructBoxThisExpression(pos + 8, ast);
+    case 3:
       return constructBoxTSExternalModuleReference(pos + 8, ast);
     default:
       throw new Error(`Unexpected discriminant ${ast.buffer[pos]} for TSModuleReference`);
@@ -13729,7 +13735,7 @@ function constructOptionBoxObjectExpression(pos, ast) {
 }
 
 function constructOptionTSTypeName(pos, ast) {
-  if (ast.buffer[pos] === 2) return null;
+  if (ast.buffer[pos] === 3) return null;
   return constructTSTypeName(pos, ast);
 }
 

package/generated/lazy/walk.js

@@ -3707,6 +3707,9 @@ function walkTSTypeName(pos, ast, visitors) {
     case 1:
       walkBoxTSQualifiedName(pos + 8, ast, visitors);
       return;
+    case 2:
+      walkBoxThisExpression(pos + 8, ast, visitors);
+      return;
     default:
       throw new Error(`Unexpected discriminant ${ast.buffer[pos]} for TSTypeName`);
   }
@@ -4098,6 +4101,9 @@ function walkTSTypeQueryExprName(pos, ast, visitors) {
       walkBoxTSQualifiedName(pos + 8, ast, visitors);
       return;
     case 2:
+      walkBoxThisExpression(pos + 8, ast, visitors);
+      return;
+    case 3:
       walkBoxTSImportType(pos + 8, ast, visitors);
       return;
     default:
@@ -4253,6 +4259,9 @@ function walkTSModuleReference(pos, ast, visitors) {
       walkBoxTSQualifiedName(pos + 8, ast, visitors);
       return;
     case 2:
+      walkBoxThisExpression(pos + 8, ast, visitors);
+      return;
+    case 3:
       walkBoxTSExternalModuleReference(pos + 8, ast, visitors);
       return;
     default:
@@ -5449,7 +5458,7 @@ function walkOptionBoxObjectExpression(pos, ast, visitors) {
 }
 
 function walkOptionTSTypeName(pos, ast, visitors) {
-  if (!(ast.buffer[pos] === 2)) walkTSTypeName(pos, ast, visitors);
+  if (!(ast.buffer[pos] === 3)) walkTSTypeName(pos, ast, visitors);
 }
 
 function walkBoxTSExternalModuleReference(pos, ast, visitors) {

package/index.d.ts

@@ -137,8 +137,8 @@ export declare const enum ImportNameKind {
 export declare function parseAsync(filename: string, sourceText: string, options?: ParserOptions | undefined | null): Promise<ParseResult>
 
 export interface ParserOptions {
-  /** Treat the source text as `js`, `jsx`, `ts`, or `tsx`. */
-  lang?: 'js' | 'jsx' | 'ts' | 'tsx'
+  /** Treat the source text as `js`, `jsx`, `ts`, `tsx` or `dts`. */
+  lang?: 'js' | 'jsx' | 'ts' | 'tsx' | 'dts'
   /** Treat the source text as `script` or `module` code. */
   sourceType?: 'script' | 'module' | 'unambiguous' | undefined
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxc-parser",
-  "version": "0.76.0",
+  "version": "0.77.1",
   "main": "index.js",
   "browser": "wasm.mjs",
   "engines": {
@@ -31,6 +31,7 @@
     "wasm.mjs",
     "bindings.js",
     "webcontainer-fallback.js",
+    "generated/constants.js",
     "generated/deserialize/js.js",
     "generated/deserialize/ts.js",
     "generated/lazy/constructors.js",
@@ -49,7 +50,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@oxc-project/types": "^0.76.0"
+    "@oxc-project/types": "^0.77.1"
   },
   "devDependencies": {
     "@codspeed/vitest-plugin": "^4.0.0",
@@ -89,24 +90,25 @@
     "dtsHeaderFile": "header.js"
   },
   "optionalDependencies": {
-    "@oxc-parser/binding-win32-x64-msvc": "0.76.0",
-    "@oxc-parser/binding-win32-arm64-msvc": "0.76.0",
-    "@oxc-parser/binding-linux-x64-gnu": "0.76.0",
-    "@oxc-parser/binding-linux-x64-musl": "0.76.0",
-    "@oxc-parser/binding-freebsd-x64": "0.76.0",
-    "@oxc-parser/binding-linux-arm64-gnu": "0.76.0",
-    "@oxc-parser/binding-linux-arm64-musl": "0.76.0",
-    "@oxc-parser/binding-linux-arm-gnueabihf": "0.76.0",
-    "@oxc-parser/binding-linux-arm-musleabihf": "0.76.0",
-    "@oxc-parser/binding-linux-s390x-gnu": "0.76.0",
-    "@oxc-parser/binding-linux-riscv64-gnu": "0.76.0",
-    "@oxc-parser/binding-darwin-x64": "0.76.0",
-    "@oxc-parser/binding-darwin-arm64": "0.76.0",
-    "@oxc-parser/binding-android-arm64": "0.76.0",
-    "@oxc-parser/binding-wasm32-wasi": "0.76.0"
+    "@oxc-parser/binding-win32-x64-msvc": "0.77.1",
+    "@oxc-parser/binding-win32-arm64-msvc": "0.77.1",
+    "@oxc-parser/binding-linux-x64-gnu": "0.77.1",
+    "@oxc-parser/binding-linux-x64-musl": "0.77.1",
+    "@oxc-parser/binding-freebsd-x64": "0.77.1",
+    "@oxc-parser/binding-linux-arm64-gnu": "0.77.1",
+    "@oxc-parser/binding-linux-arm64-musl": "0.77.1",
+    "@oxc-parser/binding-linux-arm-gnueabihf": "0.77.1",
+    "@oxc-parser/binding-linux-arm-musleabihf": "0.77.1",
+    "@oxc-parser/binding-linux-s390x-gnu": "0.77.1",
+    "@oxc-parser/binding-linux-riscv64-gnu": "0.77.1",
+    "@oxc-parser/binding-darwin-x64": "0.77.1",
+    "@oxc-parser/binding-darwin-arm64": "0.77.1",
+    "@oxc-parser/binding-android-arm64": "0.77.1",
+    "@oxc-parser/binding-wasm32-wasi": "0.77.1"
   },
   "scripts": {
     "build-dev": "napi build --platform --js bindings.js",
+    "build-test": "pnpm run build",
     "build": "pnpm run build-dev --features allocator --release",
     "postbuild-dev": "node patch.mjs",
     "build-wasi": "pnpm run build-dev --release --target wasm32-wasip1-threads",

package/raw-transfer/common.js

@@ -7,6 +7,7 @@ const {
   parseAsyncRaw: parseAsyncRawBinding,
   getBufferOffset,
 } = require('../bindings.js');
+const { BUFFER_SIZE, BUFFER_ALIGN, IS_TS_FLAG_POS } = require('../generated/constants.js');
 
 module.exports = {
   parseSyncRawImpl,
@@ -16,6 +17,18 @@ module.exports = {
   returnBufferToCache,
 };
 
+// Throw an error if running on a platform which raw transfer doesn't support.
+//
+// Note: This module is lazy-loaded only when user calls `parseSync` or `parseAsync` with
+// `experimentalRawTransfer` or `experimentalLazy` options, or calls `experimentalGetLazyVisitor`.
+if (!rawTransferSupported()) {
+  throw new Error(
+    '`experimentalRawTransfer` and `experimentalLazy` options are 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, or other runtimes',
+  );
+}
+
 /**
  * Parse JS/TS source synchronously on current thread using raw transfer.
  *
@@ -28,7 +41,6 @@ module.exports = {
  * @param {Object|undefined} options - Parsing options
  * @param {function} convert - Function to convert the buffer returned from Rust into a JS object
  * @returns {Object} - The return value of `convert`
- * @throws {Error} - If raw transfer is not supported on this platform
  */
 function parseSyncRawImpl(filename, sourceText, options, convert) {
   const { buffer, sourceByteLen } = prepareRaw(sourceText);
@@ -88,7 +100,6 @@ const queue = [];
  * @param {Object|undefined} options - Parsing options
  * @param {function} convert - Function to convert the buffer returned from Rust into a JS object
  * @returns {Object} - The return value of `convert`
- * @throws {Error} - If raw transfer is not supported on this platform
  */
 async function parseAsyncRawImpl(filename, sourceText, options, convert) {
   // Wait for a free CPU core if all CPUs are currently busy.
@@ -130,9 +141,8 @@ async function parseAsyncRawImpl(filename, sourceText, options, convert) {
   return data;
 }
 
-const ONE_GIB = 1 << 30,
-  TWO_GIB = ONE_GIB * 2,
-  SIX_GIB = ONE_GIB * 6;
+const ARRAY_BUFFER_SIZE = BUFFER_SIZE + BUFFER_ALIGN;
+const ONE_GIB = 1 << 30;
 
 // We keep a cache of buffers for raw transfer, so we can reuse them as much as possible.
 //
@@ -177,17 +187,8 @@ const textEncoder = new TextEncoder();
  *   - `buffer`: `Uint8Array` containing the AST in raw form.
  *   - `sourceByteLen`: Length of source text in UTF-8 bytes
  *     (which may not be equal to `sourceText.length` if source contains non-ASCII characters).
- * @throws {Error} - If raw transfer is not supported on this platform
  */
 function prepareRaw(sourceText) {
-  if (!rawTransferSupported()) {
-    throw new Error(
-      '`experimentalRawTransfer` and `experimentalLazy` options are 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, or other runtimes',
-    );
-  }
-
   // Cancel timeout for clearing buffers
   if (clearBuffersTimeout !== null) {
     clearTimeout(clearBuffersTimeout);
@@ -226,9 +227,7 @@ function prepareRaw(sourceText) {
  * @returns {boolean} - `true` if AST is JS, `false` if TS
  */
 function isJsAst(buffer) {
-  // 2147483636 = (2 * 1024 * 1024 * 1024) - 12
-  // i.e. 12 bytes from end of 2 GiB buffer
-  return buffer[2147483636] === 0;
+  return buffer[IS_TS_FLAG_POS] === 0;
 }
 
 /**
@@ -277,10 +276,10 @@ function clearBuffersCache() {
  * @returns {Uint8Array} - Buffer
  */
 function createBuffer() {
-  const arrayBuffer = new ArrayBuffer(SIX_GIB);
+  const arrayBuffer = new ArrayBuffer(ARRAY_BUFFER_SIZE);
   const offset = getBufferOffset(new Uint8Array(arrayBuffer));
-  const buffer = new Uint8Array(arrayBuffer, offset, TWO_GIB);
-  buffer.uint32 = new Uint32Array(arrayBuffer, offset, TWO_GIB / 4);
-  buffer.float64 = new Float64Array(arrayBuffer, offset, TWO_GIB / 8);
+  const buffer = new Uint8Array(arrayBuffer, offset, BUFFER_SIZE);
+  buffer.uint32 = new Uint32Array(arrayBuffer, offset, BUFFER_SIZE / 4);
+  buffer.float64 = new Float64Array(arrayBuffer, offset, BUFFER_SIZE / 8);
   return buffer;
 }

package/raw-transfer/eager.js

@@ -11,7 +11,6 @@ module.exports = { parseSyncRaw, parseAsyncRaw };
  * @param {string} sourceText - Source text of file
  * @param {Object} options - Parsing options
  * @returns {Object} - Object with property getters for `program`, `module`, `comments`, and `errors`
- * @throws {Error} - If raw transfer is not supported on this platform
  */
 function parseSyncRaw(filename, sourceText, options) {
   let _;
@@ -36,7 +35,6 @@ function parseSyncRaw(filename, sourceText, options) {
  * @param {string} sourceText - Source text of file
  * @param {Object} options - Parsing options
  * @returns {Object} - Object with property getters for `program`, `module`, `comments`, and `errors`
- * @throws {Error} - If raw transfer is not supported on this platform
  */
 function parseAsyncRaw(filename, sourceText, options) {
   let _;

package/raw-transfer/lazy.js

@@ -2,6 +2,7 @@
 
 const { parseSyncRawImpl, parseAsyncRawImpl, returnBufferToCache } = require('./common.js'),
   { TOKEN } = require('./lazy-common.js'),
+  { DATA_POINTER_POS_32, PROGRAM_OFFSET } = require('../generated/constants.js'),
   { RawTransferData } = require('../generated/lazy/constructors.js'),
   walkProgram = require('../generated/lazy/walk.js'),
   { Visitor, getVisitorsArr } = require('./visitor.js');
@@ -30,7 +31,6 @@ module.exports = { parseSyncLazy, parseAsyncLazy, Visitor };
  * @param {Object} options - Parsing options
  * @returns {Object} - Object with property getters for `program`, `module`, `comments`, and `errors`,
  *   and `dispose` and `visit` methods
- * @throws {Error} - If raw transfer is not supported on this platform
  */
 function parseSyncLazy(filename, sourceText, options) {
   let _;
@@ -64,7 +64,6 @@ function parseSyncLazy(filename, sourceText, options) {
  * @param {Object} options - Parsing options
  * @returns {Object} - Object with property getters for `program`, `module`, `comments`, and `errors`,
  *   and `dispose` and `visit` methods
- * @throws {Error} - If raw transfer is not supported on this platform
  */
 function parseAsyncLazy(filename, sourceText, options) {
   let _;
@@ -104,9 +103,7 @@ function construct(buffer, sourceText, sourceLen) {
   bufferRecycleRegistry.register(ast, buffer, ast);
 
   // Get root data class instance
-  // (2 * 1024 * 1024 * 1024 - 16) >> 2
-  const metadataPos32 = 536870908;
-  const rawDataPos = buffer.uint32[metadataPos32];
+  const rawDataPos = buffer.uint32[DATA_POINTER_POS_32];
   const data = new RawTransferData(rawDataPos, ast);
 
   return {
@@ -124,7 +121,7 @@ function construct(buffer, sourceText, sourceLen) {
     },
     dispose: dispose.bind(null, ast),
     visit(visitor) {
-      walkProgram(rawDataPos, ast, getVisitorsArr(visitor));
+      walkProgram(rawDataPos + PROGRAM_OFFSET, ast, getVisitorsArr(visitor));
     },
   };
 }