oxc-parser 0.97.0 → 0.99.0

package/README.md

@@ -98,6 +98,20 @@ export interface EcmaScriptModule {
 
 ## API
 
+### Functions
+
+```typescript
+// Synchronous parsing
+parseSync(filename: string, sourceText: string, options?: ParserOptions): ParseResult
+
+// Asynchronous parsing
+parse(filename: string, sourceText: string, options?: ParserOptions): Promise<ParseResult>
+```
+
+Use `parseSync` for synchronous parsing. Use `parse` for asynchronous parsing, which can be beneficial in I/O-bound or concurrent scenarios, though it adds async overhead.
+
+### Example
+
 ```javascript
 import { parseSync, Visitor } from 'oxc-parser';
 
@@ -107,7 +121,7 @@ const code = 'const url: String = /* 🤨 */ import.meta.url;';
 const filename = 'test.tsx';
 
 const result = parseSync(filename, code);
-// or `await parseAsync(filename, code)`
+// Or use async version: const result = await parse(filename, code);
 
 // An array of errors, if any.
 console.log(result.errors);

package/generated/deserialize/js.js

@@ -1139,6 +1139,8 @@ function deserializeStatement(pos) {
     case 38:
       return deserializeBoxTSModuleDeclaration(pos + 8);
     case 39:
+      return deserializeBoxTSGlobalDeclaration(pos + 8);
+    case 40:
       return deserializeBoxTSImportEqualsDeclaration(pos + 8);
     case 64:
       return deserializeBoxImportDeclaration(pos + 8);
@@ -1210,6 +1212,8 @@ function deserializeDeclaration(pos) {
     case 38:
       return deserializeBoxTSModuleDeclaration(pos + 8);
     case 39:
+      return deserializeBoxTSGlobalDeclaration(pos + 8);
+    case 40:
       return deserializeBoxTSImportEqualsDeclaration(pos + 8);
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for Declaration`);
@@ -3695,7 +3699,6 @@ function deserializeTSTypePredicateName(pos) {
 
 function deserializeTSModuleDeclaration(pos) {
   let kind = deserializeTSModuleDeclarationKind(pos + 84),
-    global = kind === 'global',
     start = deserializeU32(pos),
     end = deserializeU32(pos + 4),
     declare = deserializeBool(pos + 85),
@@ -3707,7 +3710,7 @@ function deserializeTSModuleDeclaration(pos) {
       id: null,
       kind,
       declare,
-      global,
+      global: false,
       start,
       end,
     };
@@ -3719,7 +3722,7 @@ function deserializeTSModuleDeclaration(pos) {
       body,
       kind,
       declare,
-      global,
+      global: false,
       start,
       end,
     };
@@ -3766,10 +3769,8 @@ function deserializeTSModuleDeclaration(pos) {
 function deserializeTSModuleDeclarationKind(pos) {
   switch (uint8[pos]) {
     case 0:
-      return 'global';
-    case 1:
       return 'module';
-    case 2:
+    case 1:
       return 'namespace';
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for TSModuleDeclarationKind`);
@@ -3798,6 +3799,31 @@ function deserializeTSModuleDeclarationBody(pos) {
   }
 }
 
+function deserializeTSGlobalDeclaration(pos) {
+  let start = deserializeU32(pos),
+    end = deserializeU32(pos + 4),
+    node = {
+      type: 'TSModuleDeclaration',
+      id: null,
+      body: null,
+      kind: null,
+      declare: deserializeBool(pos + 76),
+      global: null,
+      start,
+      end,
+    };
+  node.id = {
+    type: 'Identifier',
+    name: 'global',
+    start: deserializeU32(pos + 8),
+    end: deserializeU32(pos + 12),
+  };
+  node.body = deserializeTSModuleBlock(pos + 16);
+  node.kind = 'global';
+  node.global = true;
+  return node;
+}
+
 function deserializeTSModuleBlock(pos) {
   let node = {
       type: 'TSModuleBlock',
@@ -5087,6 +5113,10 @@ function deserializeBoxTSModuleDeclaration(pos) {
   return deserializeTSModuleDeclaration(uint32[pos >> 2]);
 }
 
+function deserializeBoxTSGlobalDeclaration(pos) {
+  return deserializeTSGlobalDeclaration(uint32[pos >> 2]);
+}
+
 function deserializeBoxTSImportEqualsDeclaration(pos) {
   return deserializeTSImportEqualsDeclaration(uint32[pos >> 2]);
 }

package/generated/deserialize/js_range.js

@@ -1219,6 +1219,8 @@ function deserializeStatement(pos) {
     case 38:
       return deserializeBoxTSModuleDeclaration(pos + 8);
     case 39:
+      return deserializeBoxTSGlobalDeclaration(pos + 8);
+    case 40:
       return deserializeBoxTSImportEqualsDeclaration(pos + 8);
     case 64:
       return deserializeBoxImportDeclaration(pos + 8);
@@ -1295,6 +1297,8 @@ function deserializeDeclaration(pos) {
     case 38:
       return deserializeBoxTSModuleDeclaration(pos + 8);
     case 39:
+      return deserializeBoxTSGlobalDeclaration(pos + 8);
+    case 40:
       return deserializeBoxTSImportEqualsDeclaration(pos + 8);
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for Declaration`);
@@ -4072,7 +4076,6 @@ function deserializeTSTypePredicateName(pos) {
 
 function deserializeTSModuleDeclaration(pos) {
   let kind = deserializeTSModuleDeclarationKind(pos + 84),
-    global = kind === 'global',
     start = deserializeU32(pos),
     end = deserializeU32(pos + 4),
     declare = deserializeBool(pos + 85),
@@ -4084,7 +4087,7 @@ function deserializeTSModuleDeclaration(pos) {
       id: null,
       kind,
       declare,
-      global,
+      global: false,
       start,
       end,
       range: [start, end],
@@ -4097,7 +4100,7 @@ function deserializeTSModuleDeclaration(pos) {
       body,
       kind,
       declare,
-      global,
+      global: false,
       start,
       end,
       range: [start, end],
@@ -4149,10 +4152,8 @@ function deserializeTSModuleDeclaration(pos) {
 function deserializeTSModuleDeclarationKind(pos) {
   switch (uint8[pos]) {
     case 0:
-      return 'global';
-    case 1:
       return 'module';
-    case 2:
+    case 1:
       return 'namespace';
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for TSModuleDeclarationKind`);
@@ -4181,6 +4182,35 @@ function deserializeTSModuleDeclarationBody(pos) {
   }
 }
 
+function deserializeTSGlobalDeclaration(pos) {
+  let start = deserializeU32(pos),
+    end = deserializeU32(pos + 4),
+    node = {
+      type: 'TSModuleDeclaration',
+      id: null,
+      body: null,
+      kind: null,
+      declare: deserializeBool(pos + 76),
+      global: null,
+      start,
+      end,
+      range: [start, end],
+    },
+    keywordStart,
+    keywordEnd;
+  node.id = {
+    type: 'Identifier',
+    name: 'global',
+    start: (keywordStart = deserializeU32(pos + 8)),
+    end: (keywordEnd = deserializeU32(pos + 12)),
+    range: [keywordStart, keywordEnd],
+  };
+  node.body = deserializeTSModuleBlock(pos + 16);
+  node.kind = 'global';
+  node.global = true;
+  return node;
+}
+
 function deserializeTSModuleBlock(pos) {
   let start = deserializeU32(pos),
     end = deserializeU32(pos + 4),
@@ -5549,6 +5579,10 @@ function deserializeBoxTSModuleDeclaration(pos) {
   return deserializeTSModuleDeclaration(uint32[pos >> 2]);
 }
 
+function deserializeBoxTSGlobalDeclaration(pos) {
+  return deserializeTSGlobalDeclaration(uint32[pos >> 2]);
+}
+
 function deserializeBoxTSImportEqualsDeclaration(pos) {
   return deserializeTSImportEqualsDeclaration(uint32[pos >> 2]);
 }

package/generated/deserialize/ts.js

@@ -1217,6 +1217,8 @@ function deserializeStatement(pos) {
     case 38:
       return deserializeBoxTSModuleDeclaration(pos + 8);
     case 39:
+      return deserializeBoxTSGlobalDeclaration(pos + 8);
+    case 40:
       return deserializeBoxTSImportEqualsDeclaration(pos + 8);
     case 64:
       return deserializeBoxImportDeclaration(pos + 8);
@@ -1288,6 +1290,8 @@ function deserializeDeclaration(pos) {
     case 38:
       return deserializeBoxTSModuleDeclaration(pos + 8);
     case 39:
+      return deserializeBoxTSGlobalDeclaration(pos + 8);
+    case 40:
       return deserializeBoxTSImportEqualsDeclaration(pos + 8);
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for Declaration`);
@@ -3941,7 +3945,6 @@ function deserializeTSTypePredicateName(pos) {
 
 function deserializeTSModuleDeclaration(pos) {
   let kind = deserializeTSModuleDeclarationKind(pos + 84),
-    global = kind === 'global',
     start = deserializeU32(pos),
     end = deserializeU32(pos + 4),
     declare = deserializeBool(pos + 85),
@@ -3953,7 +3956,7 @@ function deserializeTSModuleDeclaration(pos) {
       id: null,
       kind,
       declare,
-      global,
+      global: false,
       start,
       end,
     };
@@ -3965,7 +3968,7 @@ function deserializeTSModuleDeclaration(pos) {
       body,
       kind,
       declare,
-      global,
+      global: false,
       start,
       end,
     };
@@ -4012,10 +4015,8 @@ function deserializeTSModuleDeclaration(pos) {
 function deserializeTSModuleDeclarationKind(pos) {
   switch (uint8[pos]) {
     case 0:
-      return 'global';
-    case 1:
       return 'module';
-    case 2:
+    case 1:
       return 'namespace';
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for TSModuleDeclarationKind`);
@@ -4044,6 +4045,34 @@ function deserializeTSModuleDeclarationBody(pos) {
   }
 }
 
+function deserializeTSGlobalDeclaration(pos) {
+  let start = deserializeU32(pos),
+    end = deserializeU32(pos + 4),
+    node = {
+      type: 'TSModuleDeclaration',
+      id: null,
+      body: null,
+      kind: null,
+      declare: deserializeBool(pos + 76),
+      global: null,
+      start,
+      end,
+    };
+  node.id = {
+    type: 'Identifier',
+    decorators: [],
+    name: 'global',
+    optional: false,
+    typeAnnotation: null,
+    start: deserializeU32(pos + 8),
+    end: deserializeU32(pos + 12),
+  };
+  node.body = deserializeTSModuleBlock(pos + 16);
+  node.kind = 'global';
+  node.global = true;
+  return node;
+}
+
 function deserializeTSModuleBlock(pos) {
   let node = {
       type: 'TSModuleBlock',
@@ -5333,6 +5362,10 @@ function deserializeBoxTSModuleDeclaration(pos) {
   return deserializeTSModuleDeclaration(uint32[pos >> 2]);
 }
 
+function deserializeBoxTSGlobalDeclaration(pos) {
+  return deserializeTSGlobalDeclaration(uint32[pos >> 2]);
+}
+
 function deserializeBoxTSImportEqualsDeclaration(pos) {
   return deserializeTSImportEqualsDeclaration(uint32[pos >> 2]);
 }

package/generated/deserialize/ts_range.js

@@ -1297,6 +1297,8 @@ function deserializeStatement(pos) {
     case 38:
       return deserializeBoxTSModuleDeclaration(pos + 8);
     case 39:
+      return deserializeBoxTSGlobalDeclaration(pos + 8);
+    case 40:
       return deserializeBoxTSImportEqualsDeclaration(pos + 8);
     case 64:
       return deserializeBoxImportDeclaration(pos + 8);
@@ -1373,6 +1375,8 @@ function deserializeDeclaration(pos) {
     case 38:
       return deserializeBoxTSModuleDeclaration(pos + 8);
     case 39:
+      return deserializeBoxTSGlobalDeclaration(pos + 8);
+    case 40:
       return deserializeBoxTSImportEqualsDeclaration(pos + 8);
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for Declaration`);
@@ -4317,7 +4321,6 @@ function deserializeTSTypePredicateName(pos) {
 
 function deserializeTSModuleDeclaration(pos) {
   let kind = deserializeTSModuleDeclarationKind(pos + 84),
-    global = kind === 'global',
     start = deserializeU32(pos),
     end = deserializeU32(pos + 4),
     declare = deserializeBool(pos + 85),
@@ -4329,7 +4332,7 @@ function deserializeTSModuleDeclaration(pos) {
       id: null,
       kind,
       declare,
-      global,
+      global: false,
       start,
       end,
       range: [start, end],
@@ -4342,7 +4345,7 @@ function deserializeTSModuleDeclaration(pos) {
       body,
       kind,
       declare,
-      global,
+      global: false,
       start,
       end,
       range: [start, end],
@@ -4394,10 +4397,8 @@ function deserializeTSModuleDeclaration(pos) {
 function deserializeTSModuleDeclarationKind(pos) {
   switch (uint8[pos]) {
     case 0:
-      return 'global';
-    case 1:
       return 'module';
-    case 2:
+    case 1:
       return 'namespace';
     default:
       throw Error(`Unexpected discriminant ${uint8[pos]} for TSModuleDeclarationKind`);
@@ -4426,6 +4427,38 @@ function deserializeTSModuleDeclarationBody(pos) {
   }
 }
 
+function deserializeTSGlobalDeclaration(pos) {
+  let start = deserializeU32(pos),
+    end = deserializeU32(pos + 4),
+    node = {
+      type: 'TSModuleDeclaration',
+      id: null,
+      body: null,
+      kind: null,
+      declare: deserializeBool(pos + 76),
+      global: null,
+      start,
+      end,
+      range: [start, end],
+    },
+    keywordStart,
+    keywordEnd;
+  node.id = {
+    type: 'Identifier',
+    decorators: [],
+    name: 'global',
+    optional: false,
+    typeAnnotation: null,
+    start: (keywordStart = deserializeU32(pos + 8)),
+    end: (keywordEnd = deserializeU32(pos + 12)),
+    range: [keywordStart, keywordEnd],
+  };
+  node.body = deserializeTSModuleBlock(pos + 16);
+  node.kind = 'global';
+  node.global = true;
+  return node;
+}
+
 function deserializeTSModuleBlock(pos) {
   let start = deserializeU32(pos),
     end = deserializeU32(pos + 4),
@@ -5794,6 +5827,10 @@ function deserializeBoxTSModuleDeclaration(pos) {
   return deserializeTSModuleDeclaration(uint32[pos >> 2]);
 }
 
+function deserializeBoxTSGlobalDeclaration(pos) {
+  return deserializeTSGlobalDeclaration(uint32[pos >> 2]);
+}
+
 function deserializeBoxTSImportEqualsDeclaration(pos) {
   return deserializeTSImportEqualsDeclaration(uint32[pos >> 2]);
 }

package/generated/lazy/constructors.js

@@ -2633,6 +2633,8 @@ function constructStatement(pos, ast) {
     case 38:
       return constructBoxTSModuleDeclaration(pos + 8, ast);
     case 39:
+      return constructBoxTSGlobalDeclaration(pos + 8, ast);
+    case 40:
       return constructBoxTSImportEqualsDeclaration(pos + 8, ast);
     case 64:
       return constructBoxImportDeclaration(pos + 8, ast);
@@ -2818,6 +2820,8 @@ function constructDeclaration(pos, ast) {
     case 38:
       return constructBoxTSModuleDeclaration(pos + 8, ast);
     case 39:
+      return constructBoxTSGlobalDeclaration(pos + 8, ast);
+    case 40:
       return constructBoxTSImportEqualsDeclaration(pos + 8, ast);
     default:
       throw new Error(`Unexpected discriminant ${ast.buffer[pos]} for Declaration`);
@@ -10370,10 +10374,8 @@ const DebugTSModuleDeclaration = class TSModuleDeclaration {};
 function constructTSModuleDeclarationKind(pos, ast) {
   switch (ast.buffer[pos]) {
     case 0:
-      return 'global';
-    case 1:
       return 'module';
-    case 2:
+    case 1:
       return 'namespace';
     default:
       throw new Error(`Unexpected discriminant ${ast.buffer[pos]} for TSModuleDeclarationKind`);
@@ -10402,6 +10404,58 @@ function constructTSModuleDeclarationBody(pos, ast) {
   }
 }
 
+export class TSGlobalDeclaration {
+  type = 'TSGlobalDeclaration';
+  #internal;
+
+  constructor(pos, ast) {
+    if (ast?.token !== TOKEN) constructorError();
+
+    const { nodes } = ast;
+    const cached = nodes.get(pos);
+    if (cached !== void 0) return cached;
+
+    this.#internal = { pos, ast };
+    nodes.set(pos, this);
+  }
+
+  get start() {
+    const internal = this.#internal;
+    return constructU32(internal.pos, internal.ast);
+  }
+
+  get end() {
+    const internal = this.#internal;
+    return constructU32(internal.pos + 4, internal.ast);
+  }
+
+  get body() {
+    const internal = this.#internal;
+    return new TSModuleBlock(internal.pos + 16, internal.ast);
+  }
+
+  get declare() {
+    const internal = this.#internal;
+    return constructBool(internal.pos + 76, internal.ast);
+  }
+
+  toJSON() {
+    return {
+      type: 'TSGlobalDeclaration',
+      start: this.start,
+      end: this.end,
+      body: this.body,
+      declare: this.declare,
+    };
+  }
+
+  [inspectSymbol]() {
+    return Object.setPrototypeOf(this.toJSON(), DebugTSGlobalDeclaration.prototype);
+  }
+}
+
+const DebugTSGlobalDeclaration = class TSGlobalDeclaration {};
+
 export class TSModuleBlock {
   type = 'TSModuleBlock';
   #internal;
@@ -12986,6 +13040,10 @@ function constructBoxTSModuleDeclaration(pos, ast) {
   return new TSModuleDeclaration(ast.buffer.uint32[pos >> 2], ast);
 }
 
+function constructBoxTSGlobalDeclaration(pos, ast) {
+  return new TSGlobalDeclaration(ast.buffer.uint32[pos >> 2], ast);
+}
+
 function constructBoxTSImportEqualsDeclaration(pos, ast) {
   return new TSImportEqualsDeclaration(ast.buffer.uint32[pos >> 2], ast);
 }

package/generated/lazy/type_ids.js

@@ -162,29 +162,30 @@ export const NODE_TYPE_IDS_MAP = new Map([
   ['TSInterfaceHeritage', 154],
   ['TSTypePredicate', 155],
   ['TSModuleDeclaration', 156],
-  ['TSModuleBlock', 157],
-  ['TSTypeLiteral', 158],
-  ['TSInferType', 159],
-  ['TSTypeQuery', 160],
-  ['TSImportType', 161],
-  ['TSImportTypeQualifiedName', 162],
-  ['TSFunctionType', 163],
-  ['TSConstructorType', 164],
-  ['TSMappedType', 165],
-  ['TSTemplateLiteralType', 166],
-  ['TSAsExpression', 167],
-  ['TSSatisfiesExpression', 168],
-  ['TSTypeAssertion', 169],
-  ['TSImportEqualsDeclaration', 170],
-  ['TSExternalModuleReference', 171],
-  ['TSNonNullExpression', 172],
-  ['Decorator', 173],
-  ['TSExportAssignment', 174],
-  ['TSNamespaceExportDeclaration', 175],
-  ['TSInstantiationExpression', 176],
-  ['JSDocNullableType', 177],
-  ['JSDocNonNullableType', 178],
+  ['TSGlobalDeclaration', 157],
+  ['TSModuleBlock', 158],
+  ['TSTypeLiteral', 159],
+  ['TSInferType', 160],
+  ['TSTypeQuery', 161],
+  ['TSImportType', 162],
+  ['TSImportTypeQualifiedName', 163],
+  ['TSFunctionType', 164],
+  ['TSConstructorType', 165],
+  ['TSMappedType', 166],
+  ['TSTemplateLiteralType', 167],
+  ['TSAsExpression', 168],
+  ['TSSatisfiesExpression', 169],
+  ['TSTypeAssertion', 170],
+  ['TSImportEqualsDeclaration', 171],
+  ['TSExternalModuleReference', 172],
+  ['TSNonNullExpression', 173],
+  ['Decorator', 174],
+  ['TSExportAssignment', 175],
+  ['TSNamespaceExportDeclaration', 176],
+  ['TSInstantiationExpression', 177],
+  ['JSDocNullableType', 178],
+  ['JSDocNonNullableType', 179],
 ]);
 
-export const NODE_TYPES_COUNT = 179;
+export const NODE_TYPES_COUNT = 180;
 export const LEAF_NODE_TYPES_COUNT = 38;