feat(napi/parser): add MagicString

napi/parser/Cargo.toml

@@ -26,7 +26,9 @@ oxc_module_lexer = { workspace = true }
 
 napi = { workspace = true, features = ["async"] }
 napi-derive = { workspace = true }
+self_cell = "1.0.4"
 serde_json = { workspace = true }
+string_wizard = { version = "0.0.22", features = ["source_map"] }
 
 [package.metadata.cargo-shear]
 ignored = ["napi"]

napi/parser/bindings.js

@@ -361,6 +361,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
+module.exports.ParserBuilder = nativeBinding.ParserBuilder
 module.exports.moduleLexerAsync = nativeBinding.moduleLexerAsync
 module.exports.moduleLexerSync = nativeBinding.moduleLexerSync
 module.exports.parseAsync = nativeBinding.parseAsync

napi/parser/index.d.ts

@@ -2,6 +2,30 @@
 /* eslint-disable */
 
 export * from '@oxc-project/types';
+/** A Parser instance that holds a MagicString. */
+export declare class ParserBuilder {
+  constructor(sourceText: string)
+  /**
+   * # Panics
+   *
+   * * File extension is invalid
+   * * Serde JSON serialization
+   */
+  parseSync(options?: ParserOptions | undefined | null): ParseResult
+  sourceText(start: number, end: number): string
+  toString(): string
+  len(): number
+  append(source: string): void
+  appendLeft(textIndex: number, content: string): void
+  appendRight(textIndex: number, content: string): void
+  indent(): void
+  prepend(source: string): void
+  prependLeft(textIndex: number, content: string): void
+  relocate(start: number, end: number, to: number): void
+  remove(start: number, end: number): void
+  update(start: number, end: number, content: string): void
+}
+
 export interface Comment {
   type: 'Line' | 'Block'
   value: string
@@ -89,7 +113,7 @@ export declare function moduleLexerSync(sourceText: string, options?: ParserOpti
 /**
  * # Panics
  *
- * * Tokio crashes
+ * * Internal runtime (tokio) crashes
  */
 export declare function parseAsync(sourceText: string, options?: ParserOptions | undefined | null): Promise<ParseResult>