oxc-parser 0.75.0 → 0.76.0

package/generated/{deserialize/lazy-visit.js → lazy/walk.js}

@@ -182,7 +182,7 @@ const {
   JSDocNullableType,
   JSDocNonNullableType,
   JSDocUnknownType,
-} = require('./lazy.js').constructors;
+} = require('./constructors.js');
 
 module.exports = walkProgram;
 

package/index.d.ts

@@ -113,14 +113,6 @@ export declare const enum ExportLocalNameKind {
   None = 'None'
 }
 
-/**
- * Get offset within a `Uint8Array` which is aligned on 4 GiB.
- *
- * Does not check that the offset is within bounds of `buffer`.
- * To ensure it always is, provide a `Uint8Array` of at least 4 GiB size.
- */
-export declare function getBufferOffset(buffer: Uint8Array): number
-
 export interface ImportName {
   kind: ImportNameKind
   name?: string
@@ -144,38 +136,6 @@ export declare const enum ImportNameKind {
  */
 export declare function parseAsync(filename: string, sourceText: string, options?: ParserOptions | undefined | null): Promise<ParseResult>
 
-/**
- * Parse AST into provided `Uint8Array` buffer, asynchronously.
- *
- * Note: This function can be slower than `parseSyncRaw` due to the overhead of spawning a thread.
- *
- * Source text must be written into the start of the buffer, and its length (in UTF-8 bytes)
- * provided as `source_len`.
- *
- * This function will parse the source, and write the AST into the buffer, starting at the end.
- *
- * It also writes to the very end of the buffer the offset of `Program` within the buffer.
- *
- * Caller can deserialize data from the buffer on JS side.
- *
- * # SAFETY
- *
- * Caller must ensure:
- * * Source text is written into start of the buffer.
- * * Source text's UTF-8 byte length is `source_len`.
- * * The 1st `source_len` bytes of the buffer comprises a valid UTF-8 string.
- * * Contents of buffer must not be mutated by caller until the `AsyncTask` returned by this
- *   function resolves.
- *
- * If source text is originally a JS string on JS side, and converted to a buffer with
- * `Buffer.from(str)` or `new TextEncoder().encode(str)`, this guarantees it's valid UTF-8.
- *
- * # Panics
- *
- * Panics if source text is too long, or AST takes more memory than is available in the buffer.
- */
-export declare function parseAsyncRaw(filename: string, buffer: Uint8Array, sourceLen: number, options?: ParserOptions | undefined | null): Promise<unknown>
-
 export interface ParserOptions {
   /** Treat the source text as `js`, `jsx`, `ts`, or `tsx`. */
   lang?: 'js' | 'jsx' | 'ts' | 'tsx'
@@ -220,34 +180,6 @@ export interface ParserOptions {
 /** Parse synchronously. */
 export declare function parseSync(filename: string, sourceText: string, options?: ParserOptions | undefined | null): ParseResult
 
-/**
- * Parse AST into provided `Uint8Array` buffer, synchronously.
- *
- * Source text must be written into the start of the buffer, and its length (in UTF-8 bytes)
- * provided as `source_len`.
- *
- * This function will parse the source, and write the AST into the buffer, starting at the end.
- *
- * It also writes to the very end of the buffer the offset of `Program` within the buffer.
- *
- * Caller can deserialize data from the buffer on JS side.
- *
- * # SAFETY
- *
- * Caller must ensure:
- * * Source text is written into start of the buffer.
- * * Source text's UTF-8 byte length is `source_len`.
- * * The 1st `source_len` bytes of the buffer comprises a valid UTF-8 string.
- *
- * If source text is originally a JS string on JS side, and converted to a buffer with
- * `Buffer.from(str)` or `new TextEncoder().encode(str)`, this guarantees it's valid UTF-8.
- *
- * # Panics
- *
- * Panics if source text is too long, or AST takes more memory than is available in the buffer.
- */
-export declare function parseSyncRaw(filename: string, buffer: Uint8Array, sourceLen: number, options?: ParserOptions | undefined | null): void
-
 /** Returns `true` if raw transfer is supported on this platform. */
 export declare function rawTransferSupported(): boolean
 

package/index.js

@@ -11,7 +11,6 @@ module.exports.ExportExportNameKind = bindings.ExportExportNameKind;
 module.exports.ExportImportNameKind = bindings.ExportImportNameKind;
 module.exports.ExportLocalNameKind = bindings.ExportLocalNameKind;
 module.exports.ImportNameKind = bindings.ImportNameKind;
-module.exports.parseWithoutReturn = bindings.parseWithoutReturn;
 module.exports.Severity = bindings.Severity;
 
 module.exports.parseSync = parseSync;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxc-parser",
-  "version": "0.75.0",
+  "version": "0.76.0",
   "main": "index.js",
   "browser": "wasm.mjs",
   "engines": {
@@ -33,9 +33,9 @@
     "webcontainer-fallback.js",
     "generated/deserialize/js.js",
     "generated/deserialize/ts.js",
-    "generated/deserialize/lazy.js",
-    "generated/deserialize/lazy-types.js",
-    "generated/deserialize/lazy-visit.js",
+    "generated/lazy/constructors.js",
+    "generated/lazy/types.js",
+    "generated/lazy/walk.js",
     "raw-transfer/common.js",
     "raw-transfer/eager.js",
     "raw-transfer/lazy.js",
@@ -49,7 +49,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@oxc-project/types": "^0.75.0"
+    "@oxc-project/types": "^0.76.0"
   },
   "devDependencies": {
     "@codspeed/vitest-plugin": "^4.0.0",
@@ -89,21 +89,21 @@
     "dtsHeaderFile": "header.js"
   },
   "optionalDependencies": {
-    "@oxc-parser/binding-win32-x64-msvc": "0.75.0",
-    "@oxc-parser/binding-win32-arm64-msvc": "0.75.0",
-    "@oxc-parser/binding-linux-x64-gnu": "0.75.0",
-    "@oxc-parser/binding-linux-x64-musl": "0.75.0",
-    "@oxc-parser/binding-freebsd-x64": "0.75.0",
-    "@oxc-parser/binding-linux-arm64-gnu": "0.75.0",
-    "@oxc-parser/binding-linux-arm64-musl": "0.75.0",
-    "@oxc-parser/binding-linux-arm-gnueabihf": "0.75.0",
-    "@oxc-parser/binding-linux-arm-musleabihf": "0.75.0",
-    "@oxc-parser/binding-linux-s390x-gnu": "0.75.0",
-    "@oxc-parser/binding-linux-riscv64-gnu": "0.75.0",
-    "@oxc-parser/binding-darwin-x64": "0.75.0",
-    "@oxc-parser/binding-darwin-arm64": "0.75.0",
-    "@oxc-parser/binding-android-arm64": "0.75.0",
-    "@oxc-parser/binding-wasm32-wasi": "0.75.0"
+    "@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"
   },
   "scripts": {
     "build-dev": "napi build --platform --js bindings.js",

package/raw-transfer/lazy.js

@@ -2,8 +2,8 @@
 
 const { parseSyncRawImpl, parseAsyncRawImpl, returnBufferToCache } = require('./common.js'),
   { TOKEN } = require('./lazy-common.js'),
-  constructLazyData = require('../generated/deserialize/lazy.js').construct,
-  walkProgram = require('../generated/deserialize/lazy-visit.js'),
+  { RawTransferData } = require('../generated/lazy/constructors.js'),
+  walkProgram = require('../generated/lazy/walk.js'),
   { Visitor, getVisitorsArr } = require('./visitor.js');
 
 module.exports = { parseSyncLazy, parseAsyncLazy, Visitor };
@@ -104,7 +104,10 @@ function construct(buffer, sourceText, sourceLen) {
   bufferRecycleRegistry.register(ast, buffer, ast);
 
   // Get root data class instance
-  const data = constructLazyData(ast);
+  // (2 * 1024 * 1024 * 1024 - 16) >> 2
+  const metadataPos32 = 536870908;
+  const rawDataPos = buffer.uint32[metadataPos32];
+  const data = new RawTransferData(rawDataPos, ast);
 
   return {
     get program() {
@@ -121,10 +124,7 @@ function construct(buffer, sourceText, sourceLen) {
     },
     dispose: dispose.bind(null, ast),
     visit(visitor) {
-      // (2 * 1024 * 1024 * 1024 - 16) >> 2
-      const metadataPos32 = 536870908;
-      const pos = buffer.uint32[metadataPos32];
-      walkProgram(pos, ast, getVisitorsArr(visitor));
+      walkProgram(rawDataPos, ast, getVisitorsArr(visitor));
     },
   };
 }

package/raw-transfer/visitor.js

@@ -4,7 +4,7 @@ const {
   NODE_TYPE_IDS_MAP,
   NODE_TYPES_COUNT,
   LEAF_NODE_TYPES_COUNT,
-} = require('../generated/deserialize/lazy-types.js');
+} = require('../generated/lazy/types.js');
 
 // Getter for private `#visitorsArr` property of `Visitor` class. Initialized in class body below.
 let getVisitorsArr;
@@ -64,7 +64,7 @@ module.exports = { Visitor, getVisitorsArr };
  */
 function createVisitorsArr(visitor) {
   if (visitor === null || typeof visitor !== 'object') {
-    throw new Error('`visitors` must be an object');
+    throw new Error('`visitor` must be an object');
   }
 
   // Create empty visitors array
@@ -77,14 +77,14 @@ function createVisitorsArr(visitor) {
   for (let name of Object.keys(visitor)) {
     const visitFn = visitor[name];
     if (typeof visitFn !== 'function') {
-      throw new Error(`'${name}' property of \`visitors\` object is not a function`);
+      throw new Error(`'${name}' property of \`visitor\` object is not a function`);
     }
 
     const isExit = name.endsWith(':exit');
     if (isExit) name = name.slice(0, -5);
 
     const typeId = NODE_TYPE_IDS_MAP.get(name);
-    if (typeId === void 0) throw new Error(`Unknown node type '${name}' in \`visitors\` object`);
+    if (typeId === void 0) throw new Error(`Unknown node type '${name}' in \`visitor\` object`);
 
     if (typeId < LEAF_NODE_TYPES_COUNT) {
       // Leaf node. Store just 1 function.