oxc-parser - npm Package Compare versions

Comparing version 0.39.0 to 0.40.0

bindings.js

@@ -364,2 +364,4 @@ // prettier-ignore
 
+module.exports.MagicString = nativeBinding.MagicString
+module.exports.ParseResult = nativeBinding.ParseResult
 module.exports.ExportExportNameKind = nativeBinding.ExportExportNameKind
@@ -372,1 +374,2 @@ module.exports.ExportImportNameKind = nativeBinding.ExportImportNameKind
 module.exports.parseWithoutReturn = nativeBinding.parseWithoutReturn
+module.exports.Severity = nativeBinding.Severity

index.d.ts

@@ -5,2 +5,30 @@ /* auto-generated by NAPI-RS */
 export * from '@oxc-project/types';
+export declare class MagicString {
+  /** Get source text from utf8 offset. */
+  getSourceText(start: number, end: number): string
+  /** Get 0-based line and column number from utf8 offset. */
+  getLineColumnNumber(offset: number): LineColumn
+  /** Get UTF16 byte offset from UTF8 byte offset. */
+  getUtf16ByteOffset(offset: number): number
+  length(): number
+  toString(): string
+  append(input: string): this
+  appendLeft(index: number, input: string): this
+  appendRight(index: number, input: string): this
+  indent(): this
+  prepend(input: string): this
+  prependLeft(index: number, input: string): this
+  prependRight(index: number, input: string): this
+  relocate(start: number, end: number, to: number): this
+  remove(start: number, end: number): this
+}
+
+export declare class ParseResult {
+  get program(): import("@oxc-project/types").Program
+  get module(): EcmaScriptModule
+  get comments(): Array<Comment>
+  get errors(): Array<Error>
+  get magicString(): MagicString
+}
+
 export interface Comment {
@@ -14,2 +42,10 @@ type: 'Line' | 'Block'
 export interface EcmaScriptModule {
+  /**
+   * Has ESM syntax.
+   *
+   * i.e. `import` and `export` statements, and `import.meta`.
+   *
+   * Dynamic imports `import('foo')` are ignored since they can be used in non-ESM files.
+   */
+  hasModuleSyntax: boolean
   /** Import Statements. */
@@ -19,4 +55,19 @@ staticImports: Array<StaticImport>
   staticExports: Array<StaticExport>
+  /** Span positions` of `import.meta` */
+  importMetas: Array<Span>
 }
 
+export interface Error {
+  severity: Severity
+  message: string
+  labels: Array<ErrorLabel>
+  helpMessage?: string
+}
+
+export interface ErrorLabel {
+  message?: string
+  start: number
+  end: number
+}
+
 export interface ExportExportName {
@@ -91,2 +142,11 @@ kind: ExportExportNameKind
 
+export interface LineColumn {
+  line: number
+  column: number
+}
+
+export interface OverwriteOptions {
+  contentOnly: boolean
+}
+
 /**
@@ -99,9 +159,2 @@ * Parse asynchronously.
 
-export interface ParseResult {
-  program: import("@oxc-project/types").Program
-  module: EcmaScriptModule
-  comments: Array<Comment>
-  errors: Array<string>
-}
-
 export interface ParserOptions {
@@ -133,2 +186,19 @@ sourceType?: 'script' | 'module' | 'unambiguous' | undefined
 
+export declare const enum Severity {
+  Error = 'Error',
+  Warning = 'Warning',
+  Advice = 'Advice'
+}
+
+export interface SourceMapOptions {
+  includeContent?: boolean
+  source?: string
+  hires?: boolean
+}
+
+export interface Span {
+  start: number
+  end: number
+}
+
 export interface StaticExport {
@@ -135,0 +205,0 @@ start: number

index.js

 const bindings = require('./bindings.js');
 
+module.exports.MagicString = bindings.MagicString;
+module.exports.ParseResult = bindings.ParseResult;
+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;
 
+function wrap(result) {
+  let program, module, comments, errors, magicString;
+  return {
+    get program() {
+      if (!program) program = JSON.parse(result.program);
+      return program;
+    },
+    get module() {
+      if (!module) module = result.module;
+      return module;
+    },
+    get comments() {
+      if (!comments) comments = result.comments;
+      return comments;
+    },
+    get errors() {
+      if (!errors) errors = result.errors;
+      return errors;
+    },
+    get magicString() {
+      if (!magicString) magicString = result.magicString;
+      return magicString;
+    },
+  };
+}
+
 module.exports.parseAsync = async function parseAsync(...args) {
-  const result = await bindings.parseAsync(...args);
-  result.program = JSON.parse(result.program);
-  return result;
+  return wrap(await bindings.parseAsync(...args));
 };
+
 module.exports.parseSync = function parseSync(...args) {
-  const result = bindings.parseSync(...args);
-  result.program = JSON.parse(result.program);
-  return result;
+  return wrap(bindings.parseSync(...args));
 };

package.json

 {
   "name": "oxc-parser",
-  "version": "0.39.0",
+  "version": "0.40.0",
   "description": "Oxc Parser Node API",
@@ -27,14 +27,14 @@ "keywords": [
   "dependencies": {
-    "@oxc-project/types": "^0.39.0"
+    "@oxc-project/types": "^0.40.0"
   },
   "optionalDependencies": {
-    "@oxc-parser/binding-win32-x64-msvc": "0.39.0",
-    "@oxc-parser/binding-win32-arm64-msvc": "0.39.0",
-    "@oxc-parser/binding-linux-x64-gnu": "0.39.0",
-    "@oxc-parser/binding-linux-arm64-gnu": "0.39.0",
-    "@oxc-parser/binding-linux-x64-musl": "0.39.0",
-    "@oxc-parser/binding-linux-arm64-musl": "0.39.0",
-    "@oxc-parser/binding-darwin-x64": "0.39.0",
-    "@oxc-parser/binding-darwin-arm64": "0.39.0"
+    "@oxc-parser/binding-win32-x64-msvc": "0.40.0",
+    "@oxc-parser/binding-win32-arm64-msvc": "0.40.0",
+    "@oxc-parser/binding-linux-x64-gnu": "0.40.0",
+    "@oxc-parser/binding-linux-arm64-gnu": "0.40.0",
+    "@oxc-parser/binding-linux-x64-musl": "0.40.0",
+    "@oxc-parser/binding-linux-arm64-musl": "0.40.0",
+    "@oxc-parser/binding-darwin-x64": "0.40.0",
+    "@oxc-parser/binding-darwin-arm64": "0.40.0"
   }
 }

README.md

@@ -1,20 +0,51 @@
-# The JavaScript Oxidation Compiler
+# Oxc Parser
 
-See `index.d.ts` for `parseSync` and `parseAsync` API.
+## Features
 
+- Returns ESM information.
+- Built-in `magic-string` on the Rust side exposed through N-API.
+- "clever" approach to overcome the Rust UTF8 vs JavaScript UTF16 length problem.
+
+## Caveat
+
+The parser alone does not fully check for syntax errors that are associated with semantic data (symbols and scopes).
+The full compiler is needed for such case, as the compiler does an additional semantic pass.
+
+With this caveat, `oxc-parser` is best suited for parser plugins,
+where you need quick access to ESM information, as well as fast `magic-string` operations.
+
+## API
+
 ```javascript
-import assert from 'assert';
-import oxc from 'oxc-parser';
+import oxc from './index.js';
 
-const sourceText = "let foo: Foo = 'foo';";
-// Filename extension is used to determine which dialect to parse source as.
+// The emoji makes the span of `import.meta.url` to be different in UTF8 and UTF16.
+const code = 'const url: String = /* 🤨 */ import.meta.url;';
+
+// File extension is used to determine which dialect to parse source as.
 const filename = 'test.tsx';
 
-test(oxc.parseSync(filename, sourceText, options));
-test(await oxc.parseAsync(filename, sourceText, options));
+const result = oxc.parseSync(filename, code);
+// or `await oxc.parseAsync(filename, code)`
 
-function test(ret) {
-  assert(ret.program.body.length == 1);
-  assert(ret.errors.length == 0);
+// An array of errors, if any.
+console.log(result.errors);
+
+// AST and comments.
+console.log(result.program, result.comments);
+
+// ESM information - imports, exports, `import.meta`s.
+console.log(result.module);
+
+// A `magic-string` instance for accessing and manipulating the source text.
+// All returned spans are in UTF8 offsets, which cannot be used directly on our JavaScript.
+// JavaScript string lengths are in UTF16 offsets.
+const ms = result.magicString;
+
+for (const span of result.module.importMetas) {
+  // Extra methods for access the source text through spans with UTF8 offsets.
+  console.log(ms.getSourceText(span.start, span.end)); // prints `import.meta`
+  console.log(ms.getLineColumnNumber(span.start)); // prints `{ line: 0, column: 20 }`
+  console.log(code.substring(ms.getUtf16ByteOffset(span.start)).startsWith('import.meta.url')); // prints `true`
 }
 ```

New alerts

Shell access

Supply chain risk

This module accesses the system shell. Accessing the system shell increases the risk of executing arbitrary code.

Found 1 instance in 1 package

Environment variable access

Supply chain risk

Package accesses environment variables, which may be a sign of credential stuffing or data theft.

Found 1 instance in 1 package

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 1 instance in 1 package

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

Fixed alerts

Shell access

Supply chain risk

This module accesses the system shell. Accessing the system shell increases the risk of executing arbitrary code.

Found 1 instance in 1 package

Environment variable access

Supply chain risk

Package accesses environment variables, which may be a sign of credential stuffing or data theft.

Found 1 instance in 1 package

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

21662

23.09%

Lines of code

629

17.35%

Number of lines in readme file

52

147.62%

Worsened metrics

Number of low supply chain risk alerts

5

25%

Dependency changes

• + Added

  @oxc-parser/binding-darwin-arm64@0.40.0
  (transitive)

• + Added

  @oxc-parser/binding-darwin-x64@0.40.0
  (transitive)

• + Added

  @oxc-parser/binding-linux-arm64-gnu@0.40.0
  (transitive)

• + Added

  @oxc-parser/binding-linux-arm64-musl@0.40.0
  (transitive)

• + Added

  @oxc-parser/binding-linux-x64-gnu@0.40.0
  (transitive)

• + Added

  @oxc-parser/binding-linux-x64-musl@0.40.0
  (transitive)

• + Added

  @oxc-parser/binding-win32-arm64-msvc@0.40.0
  (transitive)

• + Added

  @oxc-parser/binding-win32-x64-msvc@0.40.0
  (transitive)

• + Added

  @oxc-project/types@0.40.1
  (transitive)

• - Removed

  @oxc-parser/binding-darwin-arm64@0.39.0
  (transitive)

• - Removed

  @oxc-parser/binding-darwin-x64@0.39.0
  (transitive)

• - Removed

  @oxc-parser/binding-linux-arm64-gnu@0.39.0
  (transitive)

• - Removed

  @oxc-parser/binding-linux-arm64-musl@0.39.0
  (transitive)

• - Removed

  @oxc-parser/binding-linux-x64-gnu@0.39.0
  (transitive)

• - Removed

  @oxc-parser/binding-linux-x64-musl@0.39.0
  (transitive)

• - Removed

  @oxc-parser/binding-win32-arm64-msvc@0.39.0
  (transitive)

• - Removed

  @oxc-parser/binding-win32-x64-msvc@0.39.0
  (transitive)

• - Removed

  @oxc-project/types@0.39.0
  (transitive)

• Updated

  @oxc-project/types@^0.40.0