@ast-grep/napi 0.13.1 → 0.14.1

package/index.d.ts

@@ -11,9 +11,9 @@ export const enum FrontEndLanguage {
   TypeScript = 4
 }
 export interface Pos {
-  /** line number starting from 1 */
+  /** line number starting from 0 */
   line: number
-  /** column number starting from 1 */
+  /** column number starting from 0 */
   column: number
   /** byte offset of the position */
   index: number
@@ -90,6 +90,14 @@ export class SgRoot {
 export namespace html {
   /** Parse a string to an ast-grep instance */
   export function parse(src: string): SgRoot
+  /**
+   * Parse a string to an ast-grep instance asynchronously in threads.
+   * It utlizes 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(src: string): Promise<SgRoot>
   /** Get the `kind` number from its string name. */
   export function kind(kindName: string): number
   /** Compile a string to ast-grep Pattern. */
@@ -104,6 +112,14 @@ export namespace html {
 export namespace js {
   /** Parse a string to an ast-grep instance */
   export function parse(src: string): SgRoot
+  /**
+   * Parse a string to an ast-grep instance asynchronously in threads.
+   * It utlizes 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(src: string): Promise<SgRoot>
   /** Get the `kind` number from its string name. */
   export function kind(kindName: string): number
   /** Compile a string to ast-grep Pattern. */
@@ -118,6 +134,14 @@ export namespace js {
 export namespace jsx {
   /** Parse a string to an ast-grep instance */
   export function parse(src: string): SgRoot
+  /**
+   * Parse a string to an ast-grep instance asynchronously in threads.
+   * It utlizes 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(src: string): Promise<SgRoot>
   /** Get the `kind` number from its string name. */
   export function kind(kindName: string): number
   /** Compile a string to ast-grep Pattern. */
@@ -132,6 +156,14 @@ export namespace jsx {
 export namespace ts {
   /** Parse a string to an ast-grep instance */
   export function parse(src: string): SgRoot
+  /**
+   * Parse a string to an ast-grep instance asynchronously in threads.
+   * It utlizes 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(src: string): Promise<SgRoot>
   /** Get the `kind` number from its string name. */
   export function kind(kindName: string): number
   /** Compile a string to ast-grep Pattern. */
@@ -146,6 +178,14 @@ export namespace ts {
 export namespace tsx {
   /** Parse a string to an ast-grep instance */
   export function parse(src: string): SgRoot
+  /**
+   * Parse a string to an ast-grep instance asynchronously in threads.
+   * It utlizes 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(src: string): Promise<SgRoot>
   /** Get the `kind` number from its string name. */
   export function kind(kindName: string): number
   /** Compile a string to ast-grep Pattern. */
@@ -160,6 +200,14 @@ export namespace tsx {
 export namespace css {
   /** Parse a string to an ast-grep instance */
   export function parse(src: string): SgRoot
+  /**
+   * Parse a string to an ast-grep instance asynchronously in threads.
+   * It utlizes 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(src: string): Promise<SgRoot>
   /** Get the `kind` number from its string name. */
   export function kind(kindName: string): number
   /** Compile a string to ast-grep Pattern. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ast-grep/napi",
-  "version": "0.13.1",
+  "version": "0.14.1",
   "description": "Search and Rewrite code at large scale using precise AST pattern",
   "homepage": "https://ast-grep.github.io",
   "main": "index.js",
@@ -48,7 +48,7 @@
     "ava": "5.3.1",
     "chalk": "5.3.0",
     "ts-node": "10.9.1",
-    "typescript": "5.2.2"
+    "typescript": "5.3.2"
   },
   "ava": {
     "require": [
@@ -63,13 +63,12 @@
       "TS_NODE_PROJECT": "./tsconfig.json"
     }
   },
-  "packageManager": "yarn@4.0.1",
   "optionalDependencies": {
-    "@ast-grep/napi-win32-x64-msvc": "0.13.1",
-    "@ast-grep/napi-darwin-x64": "0.13.1",
-    "@ast-grep/napi-linux-x64-gnu": "0.13.1",
-    "@ast-grep/napi-win32-ia32-msvc": "0.13.1",
-    "@ast-grep/napi-darwin-arm64": "0.13.1",
-    "@ast-grep/napi-win32-arm64-msvc": "0.13.1"
+    "@ast-grep/napi-win32-x64-msvc": "0.14.1",
+    "@ast-grep/napi-darwin-x64": "0.14.1",
+    "@ast-grep/napi-linux-x64-gnu": "0.14.1",
+    "@ast-grep/napi-win32-ia32-msvc": "0.14.1",
+    "@ast-grep/napi-darwin-arm64": "0.14.1",
+    "@ast-grep/napi-win32-arm64-msvc": "0.14.1"
   }
 }