@ast-grep/napi 0.22.3 → 0.22.5

package/index.d.ts

@@ -13,33 +13,12 @@ export interface NapiConfig {
   /** See https://ast-grep.github.io/guide/rule-config.html#constraints */
   constraints?: any
   /** Available languages: html, css, js, jsx, ts, tsx */
-  language?: FrontEndLanguage
+  language?: Lang
   /** https://ast-grep.github.io/reference/yaml.html#transform */
   transform?: any
   /** https://ast-grep.github.io/guide/rule-config/utility-rule.html */
   utils?: any
 }
-export const enum FrontEndLanguage {
-  Html = 0,
-  JavaScript = 1,
-  Tsx = 2,
-  Css = 3,
-  TypeScript = 4
-}
-export interface Pos {
-  /** line number starting from 0 */
-  line: number
-  /** column number starting from 0 */
-  column: number
-  /** byte offset of the position */
-  index: number
-}
-export interface Range {
-  /** starting position of the range */
-  start: Pos
-  /** ending position of the range */
-  end: Pos
-}
 export interface FileOption {
   paths: Array<string>
   languageGlobs: Record<string, Array<string>>
@@ -57,6 +36,74 @@ export interface FindConfig {
    */
   languageGlobs?: Array<string>
 }
+export const enum Lang {
+  Html = 'Html',
+  JavaScript = 'JavaScript',
+  Tsx = 'Tsx',
+  Css = 'Css',
+  TypeScript = 'TypeScript',
+  Bash = 'Bash',
+  C = 'C',
+  Cpp = 'Cpp',
+  CSharp = 'CSharp',
+  Dart = 'Dart',
+  Go = 'Go',
+  Elixir = 'Elixir',
+  Haskell = 'Haskell',
+  Java = 'Java',
+  Json = 'Json',
+  Kotlin = 'Kotlin',
+  Lua = 'Lua',
+  Php = 'Php',
+  Python = 'Python',
+  Ruby = 'Ruby',
+  Rust = 'Rust',
+  Scala = 'Scala',
+  Swift = 'Swift'
+}
+export interface Edit {
+  /** The position of the edit */
+  position: number
+  /** The length of the text to be deleted */
+  deletedLength: number
+  /** The text to be inserted */
+  insertedText: string
+}
+export interface Pos {
+  /** line number starting from 0 */
+  line: number
+  /** column number starting from 0 */
+  column: number
+  /** byte offset of the position */
+  index: number
+}
+export interface Range {
+  /** starting position of the range */
+  start: Pos
+  /** ending position of the range */
+  end: Pos
+}
+/** Parse a string to an ast-grep instance */
+export function parse(lang: Lang, src: string): SgRoot
+/**
+ * Parse a string to an ast-grep instance asynchronously in threads.
+ * It utilize multiple CPU cores when **concurrent processing sources**.
+ * However, spawning excessive many threads may backfire.
+ * Please refer to libuv doc, nodejs' underlying runtime
+ * for its default behavior and performance tuning tricks.
+ */
+export function parseAsync(lang: Lang, src: string): Promise<SgRoot>
+/** Get the `kind` number from its string name. */
+export function kind(lang: Lang, kindName: string): number
+/** Compile a string to ast-grep Pattern. */
+export function pattern(lang: Lang, pattern: string): NapiConfig
+/**
+ * Discover and parse multiple files in Rust.
+ * `lang` specifies the language.
+ * `config` specifies the file path and matcher.
+ * `callback` will receive matching nodes found in a file.
+ */
+export function findInFiles(lang: Lang, config: FindConfig, callback: (err: null | Error, result: SgNode[]) => void): Promise<number>
 export class SgNode {
   range(): Range
   isLeaf(): boolean
@@ -87,6 +134,8 @@ export class SgNode {
   nextAll(): Array<SgNode>
   prev(): SgNode | null
   prevAll(): Array<SgNode>
+  replace(text: string): Edit
+  commitEdits(edits: Array<Edit>): string
 }
 /** Represents the parsed tree of code. */
 export class SgRoot {

package/index.js

@@ -281,12 +281,17 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { FrontEndLanguage, SgNode, SgRoot, parseFiles, html, js, jsx, ts, tsx, css } = nativeBinding
+const { parseFiles, Lang, SgNode, SgRoot, parse, parseAsync, kind, pattern, findInFiles, html, js, jsx, ts, tsx, css } = nativeBinding
 
-module.exports.FrontEndLanguage = FrontEndLanguage
+module.exports.parseFiles = parseFiles
+module.exports.Lang = Lang
 module.exports.SgNode = SgNode
 module.exports.SgRoot = SgRoot
-module.exports.parseFiles = parseFiles
+module.exports.parse = parse
+module.exports.parseAsync = parseAsync
+module.exports.kind = kind
+module.exports.pattern = pattern
+module.exports.findInFiles = findInFiles
 module.exports.html = html
 module.exports.js = js
 module.exports.jsx = jsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ast-grep/napi",
-  "version": "0.22.3",
+  "version": "0.22.5",
   "description": "Search and Rewrite code at large scale using precise AST pattern",
   "homepage": "https://ast-grep.github.io",
   "main": "index.js",
@@ -66,13 +66,13 @@
     }
   },
   "optionalDependencies": {
-    "@ast-grep/napi-win32-x64-msvc": "0.22.3",
-    "@ast-grep/napi-darwin-x64": "0.22.3",
-    "@ast-grep/napi-linux-x64-gnu": "0.22.3",
-    "@ast-grep/napi-win32-ia32-msvc": "0.22.3",
-    "@ast-grep/napi-darwin-arm64": "0.22.3",
-    "@ast-grep/napi-win32-arm64-msvc": "0.22.3",
-    "@ast-grep/napi-linux-arm64-gnu": "0.22.3",
-    "@ast-grep/napi-linux-x64-musl": "0.22.3"
+    "@ast-grep/napi-win32-x64-msvc": "0.22.5",
+    "@ast-grep/napi-darwin-x64": "0.22.5",
+    "@ast-grep/napi-linux-x64-gnu": "0.22.5",
+    "@ast-grep/napi-win32-ia32-msvc": "0.22.5",
+    "@ast-grep/napi-darwin-arm64": "0.22.5",
+    "@ast-grep/napi-win32-arm64-msvc": "0.22.5",
+    "@ast-grep/napi-linux-arm64-gnu": "0.22.5",
+    "@ast-grep/napi-linux-x64-musl": "0.22.5"
   }
 }