@gdscript-analyzer/core 0.3.0 → 0.4.0

package/README.md

@@ -35,13 +35,14 @@ func _ready() -> void:
 	print(half)
 `, null);
 
-// Diagnostics come back as a JSON string.
-console.log(JSON.parse(az.diagnostics(uri)));
+// Diagnostics come back as a native JS array — no JSON.parse.
+console.log(az.diagnostics(uri));
 // → [{ code: "INTEGER_DIVISION", severity: "warning", range: { start, end }, message: ... }]
 ```
 
-Every query that returns data returns a **JSON string** (parse it). Positions are
-**UTF-8 byte offsets** (see [Positions](#positions-byte-offsets) below).
+Every query returns a **native JS value** (object / array / `null`) — no
+`JSON.parse`. Positions are **UTF-8 byte offsets** (see
+[Positions](#positions-byte-offsets) below).
 
 ---
 
@@ -84,31 +85,33 @@ URI (re-sending would needlessly invalidate the resource-path registry). Use
 ## API
 
 All queries take a `uri`; offset-based queries take a UTF-8 **byte** `offset`.
-Array/object queries return a **JSON string**; the `… | null` ones return JS
-`null` when there's nothing at the offset.
+Array/object queries return a **native JS value**; the `… | null` ones return JS
+`null` when there's nothing at the offset. Navigation/edit results
+(`gotoDefinition`, `findReferences`, `rename`) carry a `uri` per target, so you
+need no `FileId`→URI mapping of your own.
 
 | Method | Returns | What |
 | --- | --- | --- |
-| `diagnostics(uri)` | JSON array | parse + type diagnostics |
-| `documentSymbols(uri)` | JSON array | the document outline |
-| `foldingRanges(uri)` | JSON array | foldable ranges |
-| `inlayHints(uri)` | JSON array | inferred-type / param inlay hints |
-| `completions(uri, offset)` | JSON array | completions at `offset` |
-| `hover(uri, offset)` | JSON string \| `null` | type + docs at `offset` |
-| `signatureHelp(uri, offset)` | JSON string \| `null` | active call signature |
-| `codeActions(uri, offset)` | JSON array | quick fixes at `offset` |
-| `gotoDefinition(uri, offset)` | JSON array | definition target(s) |
-| `findReferences(uri, offset)` | JSON array | all references |
-| `rename(uri, offset, newName)` | JSON string | `{"ok": SourceChange}` or `{"error": RenameError}` |
-| `workspaceSymbols(query)` | JSON array | project-wide symbol search |
-| `syntaxTree(uri)` | JSON string \| `null` | pretty-printed CST (debugging) |
+| `diagnostics(uri)` | array | parse + type diagnostics |
+| `documentSymbols(uri)` | array | the document outline |
+| `foldingRanges(uri)` | array | foldable ranges |
+| `inlayHints(uri)` | array | inferred-type / param inlay hints |
+| `completions(uri, offset)` | array | completions at `offset` |
+| `hover(uri, offset)` | object \| `null` | type + docs at `offset` |
+| `signatureHelp(uri, offset)` | object \| `null` | active call signature |
+| `codeActions(uri, offset)` | array | quick fixes at `offset` |
+| `gotoDefinition(uri, offset)` | array | definition target(s) (each with a `uri`) |
+| `findReferences(uri, offset)` | array | all references (each with a `uri`) |
+| `rename(uri, offset, newName)` | object | `{ ok: SourceChange }` or `{ error: RenameError }` |
+| `workspaceSymbols(query)` | array | project-wide symbol search |
+| `syntaxTree(uri)` | string \| `null` | pretty-printed CST (debugging) |
 
 ```js
 const offset = 38; // a UTF-8 byte offset into the document
-JSON.parse(az.completions(uri, offset));
-const hover = az.hover(uri, offset);          // string | null
-if (hover) console.log(JSON.parse(hover));
-JSON.parse(az.gotoDefinition(uri, offset));
+az.completions(uri, offset);                  // array
+const hover = az.hover(uri, offset);          // object | null
+if (hover) console.log(hover);
+az.gotoDefinition(uri, offset);               // array, each target has a `uri`
 ```
 
 ### Positions (byte offsets)

package/index.d.ts

@@ -29,33 +29,36 @@ export declare class AnalysisHandle {
    * empty result (the array queries return `[]` and the `null`-returning queries `null` for both).
    */
   isOpen(uri: string): boolean
-  /** Parse + type diagnostics for `uri`, as a JSON array string. */
-  diagnostics(uri: string): string
-  /** The document outline for `uri`, as a JSON array string. */
-  documentSymbols(uri: string): string
-  /** Foldable ranges for `uri`, as a JSON array string. */
-  foldingRanges(uri: string): string
-  /** Inlay hints for `uri`, as a JSON array string. */
-  inlayHints(uri: string): string
-  /** Completions at a byte `offset` in `uri`, as a JSON array string. */
-  completions(uri: string, offset: number): string
+  /** Parse + type diagnostics for `uri`, as a JS array. */
+  diagnostics(uri: string): any
+  /** The document outline for `uri`, as a JS array. */
+  documentSymbols(uri: string): any
+  /** Foldable ranges for `uri`, as a JS array. */
+  foldingRanges(uri: string): any
+  /** Inlay hints for `uri`, as a JS array. */
+  inlayHints(uri: string): any
+  /** Completions at a byte `offset` in `uri`, as a JS array. */
+  completions(uri: string, offset: number): any
   /** Hover at a byte `offset` in `uri`; JS `null` when there is nothing typed there. */
-  hover(uri: string, offset: number): string | null
+  hover(uri: string, offset: number): any | null
   /** Signature help at a byte `offset` in `uri`; JS `null` when not at a call site. */
-  signatureHelp(uri: string, offset: number): string | null
-  /** Code actions at a byte `offset` in `uri`, as a JSON array string. */
-  codeActions(uri: string, offset: number): string
-  /** Go-to-definition target(s) for the symbol at a byte `offset` in `uri`, as a JSON array string. */
-  gotoDefinition(uri: string, offset: number): string
-  /** Every reference to the symbol at a byte `offset` in `uri`, as a JSON array string. */
-  findReferences(uri: string, offset: number): string
+  signatureHelp(uri: string, offset: number): any | null
+  /** Code actions at a byte `offset` in `uri`, as a JS array. */
+  codeActions(uri: string, offset: number): any
   /**
-   * Rename the symbol at a byte `offset` in `uri` to `newName`. JSON object string:
-   * `{"ok": <SourceChange>}` or `{"error": <RenameError>}`.
+   * Go-to-definition target(s) for the symbol at a byte `offset` in `uri`, as a JS array (each
+   * target carries a `uri`).
    */
-  rename(uri: string, offset: number, newName: string): string
-  /** Project-wide symbols matching `query`, as a JSON array string. */
-  workspaceSymbols(query: string): string
+  gotoDefinition(uri: string, offset: number): any
+  /** Every reference to the symbol at a byte `offset` in `uri`, as a JS array (each carries a `uri`). */
+  findReferences(uri: string, offset: number): any
+  /**
+   * Rename the symbol at a byte `offset` in `uri` to `newName`. A JS object:
+   * `{ ok: <SourceChange> }` or `{ error: <RenameError> }` (edits carry a `uri`).
+   */
+  rename(uri: string, offset: number, newName: string): any
+  /** Project-wide symbols matching `query`, as a JS array. */
+  workspaceSymbols(query: string): any
   /** The pretty-printed syntax tree for `uri` (debugging); JS `null` for an unknown `uri`. */
   syntaxTree(uri: string): string | null
 }

package/package.json

@@ -2,7 +2,7 @@
   "//": "npm packaging for the napi-rs addon built from crates/gdscript-ffi. Per-platform `@gdscript-analyzer/core-<triple>` packages are wired as optionalDependencies (generated by `napi create-npm-dirs`); the loader index.js picks the right one at runtime.",
   "name": "@gdscript-analyzer/core",
   "//version": "Authoritative version is synced from Cargo.toml by release-napi.yml at publish time; this value is a fallback for local/manual publishes.",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Headless GDScript (Godot 4.x) static analysis for Node — diagnostics, type-aware hover, completion, symbols, and navigation. The native binding of gdscript-analyzer (Roslyn for Godot).",
   "license": "(MIT OR Apache-2.0)",
   "author": "Yaniv Kalfa <yanivkalfa@gmail.com>",
@@ -63,11 +63,11 @@
     ]
   },
   "optionalDependencies": {
-    "@gdscript-analyzer/core-darwin-x64": "0.3.0",
-    "@gdscript-analyzer/core-darwin-arm64": "0.3.0",
-    "@gdscript-analyzer/core-win32-x64-msvc": "0.3.0",
-    "@gdscript-analyzer/core-win32-arm64-msvc": "0.3.0",
-    "@gdscript-analyzer/core-linux-x64-gnu": "0.3.0",
-    "@gdscript-analyzer/core-linux-arm64-gnu": "0.3.0"
+    "@gdscript-analyzer/core-darwin-x64": "0.4.0",
+    "@gdscript-analyzer/core-darwin-arm64": "0.4.0",
+    "@gdscript-analyzer/core-win32-x64-msvc": "0.4.0",
+    "@gdscript-analyzer/core-win32-arm64-msvc": "0.4.0",
+    "@gdscript-analyzer/core-linux-x64-gnu": "0.4.0",
+    "@gdscript-analyzer/core-linux-arm64-gnu": "0.4.0"
   }
 }