@xberg-io/tree-sitter-language-pack 1.15.7 → 1.16.2

package/README.md

@@ -1,5 +1,5 @@
 <!-- This file is auto-generated by alef — DO NOT EDIT. -->
-<!-- alef:hash:bf28c5e6b12322464ec328f30dd1b6fb67bc0739d83fdfc2d451339934443028 -->
+<!-- alef:hash:f02cf7eadee2e2005e0a0a46e7b2ae062a6cce92548b232119aa872449076c1a -->
 <!-- To regenerate: alef readme -->
 <!-- To verify freshness: alef verify -->
 
@@ -119,10 +119,16 @@ npm install @xberg-io/tree-sitter-language-pack
 ## Quick Start
 
 ```typescript title="TypeScript"
-import { process } from "@xberg-io/tree-sitter-language-pack";
+import { ProcessConfig, process } from "@xberg-io/tree-sitter-language-pack";
 function main() {
-  const result = process("# A comment\ndef greet(name):\n    \"\"\"Say hello.\"\"\"\n    return f'Hi {name}'\n\nimport os\n", { language: "python" });
-  console.log(result);
+  const config: ProcessConfig = { language: "python" };
+  const result = process("# A comment\ndef greet(name):\n    \"\"\"Say hello.\"\"\"\n    return f'Hi {name}'\n\nimport os\n", config);
+  console.log(result.language);
+  console.log(result.structure);
+  console.log(result.structure?.[0]?.kind);
+  console.log(result.imports);
+  console.log(result.metrics?.totalLines);
+  console.log(result.metrics?.errorCount);
 }
 
 void main();

package/index.d.ts

@@ -1,5 +1,5 @@
 // This file is auto-generated by alef — DO NOT EDIT.
-// alef:hash:af19e53619993c70375251f0e7b888e7eb1c7d2eda4f85efb6399f6dca682a08
+// alef:hash:78d8af075d33d367ecac6d93cf1ff2224cc8ca072b49392de478f0d3a15dc3fd
 // To regenerate: alef generate
 // To verify freshness: alef verify
 /* eslint-disable */
@@ -248,27 +248,27 @@ export declare function init(config?: PackConfig | undefined | null): void;
 /** A byte range — start (inclusive) to end (exclusive). */
 export interface ByteRange {
   /** Inclusive start byte offset. */
-  readonly start: number
+  readonly start: number;
   /** Exclusive end byte offset. */
-  readonly end: number
+  readonly end: number;
 }
 
 /** Metadata for a single chunk of source code. */
 export interface ChunkContext {
   /** Language name used to parse this chunk. */
-  readonly language?: string
+  readonly language?: string;
   /** Zero-indexed position of this chunk within the file's chunk list. */
-  readonly chunkIndex?: number
+  readonly chunkIndex?: number;
   /** Total number of chunks the file was split into. */
-  readonly totalChunks?: number
+  readonly totalChunks?: number;
   /** Tree-sitter node kinds that appear at the top level of this chunk. */
-  readonly nodeTypes?: Array<string>
+  readonly nodeTypes?: Array<string>;
   /** Hierarchical path of enclosing structural items (e.g., `["MyClass", "my_method"]`). */
-  readonly contextPath?: Array<string>
+  readonly contextPath?: Array<string>;
   /** Names of symbols defined within this chunk. */
-  readonly symbolsDefined?: Array<string>
+  readonly symbolsDefined?: Array<string>;
   /** Comments contained within this chunk. */
-  readonly comments?: Array<CommentInfo>
+  readonly comments?: Array<CommentInfo>;
   /**
    * Docstrings contained within this chunk.
    *
@@ -276,21 +276,21 @@ export interface ChunkContext {
    * `ProcessResult.docstrings` is populated, and by the same
    * classifier. Always empty for every other language.
    */
-  readonly docstrings?: Array<DocstringInfo>
+  readonly docstrings?: Array<DocstringInfo>;
   /** Whether this chunk contains any tree-sitter error nodes. */
-  readonly hasErrorNodes?: boolean
+  readonly hasErrorNodes?: boolean;
 }
 
 /** A chunk of source code with rich metadata. */
 export interface CodeChunk {
   /** The raw source text of this chunk. */
-  readonly content?: string
+  readonly content?: string;
   /** Inclusive start byte offset of this chunk in the original source. */
-  readonly startByte?: number
+  readonly startByte?: number;
   /** Exclusive end byte offset of this chunk in the original source. */
-  readonly endByte?: number
+  readonly endByte?: number;
   /** Zero-indexed start line of this chunk. */
-  readonly startLine?: number
+  readonly startLine?: number;
   /**
    * Zero-indexed row of the last byte actually included in this chunk
    * (inclusive — the same row a `Span.end_line` would report for a node
@@ -298,21 +298,21 @@ export interface CodeChunk {
    * source has a trailing newline: it is always the row of `end_byte - 1`,
    * never a phantom row past the file's real content.
    */
-  readonly endLine?: number
+  readonly endLine?: number;
   /** Contextual metadata about this chunk. */
-  readonly metadata?: ChunkContext
+  readonly metadata?: ChunkContext;
 }
 
 /** A comment extracted from source code. */
 export interface CommentInfo {
   /** The raw text content of the comment. */
-  readonly text?: string
+  readonly text?: string;
   /** The kind of comment (line, block, or doc). */
-  readonly kind?: CommentKind
+  readonly kind?: CommentKind;
   /** Source span covering the comment. */
-  readonly span?: Span
+  readonly span?: Span;
   /** Name of the syntax node this comment is directly associated with. */
-  readonly associatedNode?: string
+  readonly associatedNode?: string;
 }
 
 /**
@@ -338,11 +338,11 @@ export declare enum CommentKind {
  */
 export interface DataAttribute {
   /** Attribute name (e.g. `"class"`, `"href"`). */
-  readonly name?: string
+  readonly name?: string;
   /** Attribute value as a raw string (quotes stripped). */
-  readonly value?: string
+  readonly value?: string;
   /** Source span covering the entire `name="value"` attribute token. */
-  readonly span?: Span
+  readonly span?: Span;
 }
 
 /**
@@ -362,23 +362,23 @@ export interface DataAttribute {
  */
 export interface DataNode {
   /** Whether this node is a key/value pair, XML element, or sequence item. */
-  readonly kind?: DataNodeKind
+  readonly kind?: DataNodeKind;
   /**
    * Key, attribute name, tag name, or positional index (`"0"`, `"1"`, …).
    * `None` at the document root.
    */
-  readonly key?: string
+  readonly key?: string;
   /**
    * Leaf scalar value, if any. `None` for containers (objects, arrays, XML elements
    * with child elements).
    */
-  readonly value?: string
+  readonly value?: string;
   /** Attributes on element-shape nodes (XML `STag` attributes). Empty for all other kinds. */
-  readonly attributes?: Array<DataAttribute>
+  readonly attributes?: Array<DataAttribute>;
   /** Children for nested containers and XML element bodies. */
-  readonly children?: Array<DataNode>
+  readonly children?: Array<DataNode>;
   /** Source span covering this node in the original source file. */
-  readonly span?: Span
+  readonly span?: Span;
 }
 
 /**
@@ -413,11 +413,11 @@ export declare enum DataNodeKind {
 /** A diagnostic (syntax error, missing node, etc.) from parsing. */
 export interface Diagnostic {
   /** Human-readable description of the diagnostic. */
-  readonly message?: string
+  readonly message?: string;
   /** Severity of the diagnostic. */
-  readonly severity?: DiagnosticSeverity
+  readonly severity?: DiagnosticSeverity;
   /** Source span where the diagnostic was detected. */
-  readonly span?: Span
+  readonly span?: Span;
 }
 
 /**
@@ -438,11 +438,11 @@ export declare enum DiagnosticSeverity {
 /** A section within a docstring (e.g., Args, Returns, Raises). */
 export interface DocSection {
   /** Section kind (e.g., `"args"`, `"returns"`, `"raises"`). */
-  readonly kind?: string
+  readonly kind?: string;
   /** Parameter or return value name, if applicable. */
-  readonly name?: string
+  readonly name?: string;
   /** Description text for this section. */
-  readonly description?: string
+  readonly description?: string;
 }
 
 /**
@@ -457,37 +457,24 @@ export interface DocSection {
  * variant serializes as a single-keyed object (`{"Other": "rst"}`). DO
  * NOT add `#[serde(tag = "...")]`. Covered by `tests/wire_format.rs`.
  */
-export declare enum DocstringFormat {
-  /** Python triple-quoted string docstring (`"""..."""`). */
-  PythonTripleQuote = "PythonTripleQuote",
-  /**
-   * JavaScript/TypeScript JSDoc block comment (opens with two stars, closes
-   * with star-slash).
-   */
-  JSDoc = "JSDoc",
-  /** Rust `///` or `//!` doc comment. */
-  Rustdoc = "Rustdoc",
-  /** Go doc comment (a comment block immediately preceding a declaration). */
-  GoDoc = "GoDoc",
-  /**
-   * Java Javadoc block comment (opens with two stars, closes with
-   * star-slash).
-   */
-  JavaDoc = "JavaDoc",
-  /** A language-specific docstring format not covered by the standard variants. */
-  Other = "Other",
-}
+export type DocstringFormat =
+  | { type: "PythonTripleQuote" }
+  | { type: "JSDoc" }
+  | { type: "Rustdoc" }
+  | { type: "GoDoc" }
+  | { type: "JavaDoc" }
+  | { type: "Other"; other: string };
 
 /** A docstring extracted from source code. */
 export interface DocstringInfo {
   /** The raw text of the docstring. */
-  readonly text?: string
+  readonly text?: string;
   /** The docstring format (Python, JSDoc, Rustdoc, etc.). */
-  readonly format?: DocstringFormat
+  readonly format?: DocstringFormat;
   /** Source span covering the docstring. */
-  readonly span?: Span
+  readonly span?: Span;
   /** Name of the item this docstring documents. */
-  readonly associatedItem?: string
+  readonly associatedItem?: string;
   /**
    * Parsed sections of the docstring (Args, Returns, Raises, etc.).
    *
@@ -498,7 +485,7 @@ export interface DocstringInfo {
    * no extractor here does yet. The field is kept rather than removed so
    * a consumer's deserializer does not need updating once it is.
    */
-  readonly parsedSections?: Array<DocSection>
+  readonly parsedSections?: Array<DocSection>;
 }
 
 /** Manages downloading and caching of pre-built parser shared libraries. */
@@ -510,7 +497,7 @@ export declare class DownloadManager {
    * `validate_version` — or if no cache directory can be resolved (see
    * `Self.default_cache_dir`).
    */
-  static new(version: string): DownloadManager
+  static new(version: string): DownloadManager;
   /**
    * List languages that are already downloaded and cached.
    *
@@ -528,7 +515,7 @@ export declare class DownloadManager {
    * language binding — but logs a `tracing.warn!` so the failure is not
    * silently indistinguishable from "nothing installed".
    */
-  installedLanguages(): Array<string>
+  installedLanguages(): Array<string>;
   /**
    * Download the platform bundle and extract every library file it contains.
    *
@@ -539,7 +526,7 @@ export declare class DownloadManager {
    *
    * Returns the number of library files extracted (including those already cached).
    */
-  downloadAllBestEffort(): number
+  downloadAllBestEffort(): number;
   /**
    * Remove all cached parser libraries.
    *
@@ -550,17 +537,17 @@ export declare class DownloadManager {
    * already opened the file to continue holding a stale lock handle while a new
    * process opens a fresh inode, breaking the mutual-exclusion guarantee.
    */
-  cleanCache(): void
+  cleanCache(): void;
 }
 
 /** An export statement extracted from source code. */
 export interface ExportInfo {
   /** The exported name. */
-  readonly name?: string
+  readonly name?: string;
   /** The kind of export (named, default, or re-export). */
-  readonly kind?: ExportKind
+  readonly kind?: ExportKind;
   /** Source span covering the export statement. */
-  readonly span?: Span
+  readonly span?: Span;
 }
 
 /**
@@ -580,27 +567,27 @@ export declare enum ExportKind {
 /** Aggregate metrics for a source file. */
 export interface FileMetrics {
   /** Total number of lines (including blank and comment lines). */
-  readonly totalLines?: number
+  readonly totalLines?: number;
   /** Number of lines containing non-blank, non-comment source code. */
-  readonly codeLines?: number
+  readonly codeLines?: number;
   /** Number of lines that are entirely comments. */
-  readonly commentLines?: number
+  readonly commentLines?: number;
   /** Number of blank (whitespace-only) lines. */
-  readonly blankLines?: number
+  readonly blankLines?: number;
   /** Total byte length of the source file. */
-  readonly totalBytes?: number
+  readonly totalBytes?: number;
   /** Total number of nodes in the syntax tree. */
-  readonly nodeCount?: number
+  readonly nodeCount?: number;
   /** Number of error nodes in the syntax tree (parse errors). */
-  readonly errorCount?: number
+  readonly errorCount?: number;
   /** Maximum nesting depth reached in the syntax tree. */
-  readonly maxDepth?: number
+  readonly maxDepth?: number;
 }
 
 /** An import statement extracted from source code. */
 export interface ImportInfo {
   /** The module or path being imported from. */
-  readonly source?: string
+  readonly source?: string;
   /**
    * Specific names imported from the source module.
    *
@@ -614,7 +601,7 @@ export interface ImportInfo {
    * — and for a JS/TS namespace import (`import * as ns`) or default
    * import (`import x from 'm'`), neither of which names individual items.
    */
-  readonly items?: Array<string>
+  readonly items?: Array<string>;
   /**
    * Alias assigned to the import (e.g., `import numpy as np`).
    *
@@ -628,7 +615,7 @@ export interface ImportInfo {
    * where there is no single alias to report for the statement as a
    * whole, so only `items` is populated for it.
    */
-  readonly alias?: string
+  readonly alias?: string;
   /**
    * Whether this is a wildcard import (e.g., `import *` or `use foo.*`).
    *
@@ -638,9 +625,9 @@ export interface ImportInfo {
    * import's source text for a `*` character, so a glob in an import path
    * string (`import a from './glob*.js'`) is not mistaken for one.
    */
-  readonly isWildcard?: boolean
+  readonly isWildcard?: boolean;
   /** Source span covering the import statement. */
-  readonly span?: Span
+  readonly span?: Span;
 }
 
 /**
@@ -658,14 +645,14 @@ export declare class LanguageRegistry {
    * When the `dynamic-loading` feature is enabled, the registry also knows
    * about dynamically loadable grammars and will load them on demand.
    */
-  static new(): LanguageRegistry
+  static new(): LanguageRegistry;
   /**
    * List all available language names, sorted and deduplicated.
    *
    * Includes statically compiled languages, dynamically loadable languages
    * (if the `dynamic-loading` feature is enabled), and all configured aliases.
    */
-  availableLanguages(): Array<string>
+  availableLanguages(): Array<string>;
   /**
    * Check whether this language can be parsed right now, without downloading.
    *
@@ -690,7 +677,7 @@ export declare class LanguageRegistry {
    * or wrong-architecture library exists on disk but cannot parse. Loads are
    * cached process-wide, so repeat calls are cheap.
    */
-  hasParser(name: string): boolean
+  hasParser(name: string): boolean;
   /**
    * Check whether a language is available by name or alias.
    *
@@ -703,14 +690,14 @@ export declare class LanguageRegistry {
    * of the `stat` calls is what keeps this off the syscall path for the
    * languages a process actually uses.
    */
-  hasLanguage(name: string): boolean
+  hasLanguage(name: string): boolean;
   /**
    * Return the total number of available languages (including aliases).
    *
    * Counts the same set `available_languages`
    * lists, without materialising or sorting it.
    */
-  languageCount(): number
+  languageCount(): number;
   /**
    * Parse source code and extract file intelligence based on config in a single pass.
    * @throws Returns `Error.InvalidRange` if the config is invalid (see
@@ -720,8 +707,8 @@ export declare class LanguageRegistry {
    * `Error.LanguageNotFound` if the language is unknown; or
    * `Error.ParseFailed` if parsing produces no tree.
    */
-  process(source: string, config?: ProcessConfig | undefined | null): ProcessResult
-  static default(): LanguageRegistry
+  process(source: string, config?: ProcessConfig | undefined | null): ProcessResult;
+  static default(): LanguageRegistry;
 }
 
 /**
@@ -732,7 +719,7 @@ export declare class LanguageRegistry {
  */
 export declare class Node {
   /** Return the node's kind name (e.g. `"function_definition"`). */
-  kind(): string
+  kind(): string;
   /**
    * Return the node's numeric kind ID.
    *
@@ -740,48 +727,48 @@ export declare class Node {
    * (e.g. `"function_definition" → 42`). Comparing `kind_id()` is cheaper
    * than comparing the string `kind()` in tight AST loops.
    */
-  kindId(): number
+  kindId(): number;
   /** Return the inclusive start byte offset of this node. */
-  startByte(): number
+  startByte(): number;
   /** Return the exclusive end byte offset of this node. */
-  endByte(): number
+  endByte(): number;
   /**
    * Return the node's byte range as a `ByteRange`.
    *
    * Callers should slice their own source bytes — this is a zero-copy
    * text accessor.
    */
-  byteRange(): ByteRange
+  byteRange(): ByteRange;
   /** Return the start `Point` (row, column). */
-  startPosition(): Point
+  startPosition(): Point;
   /** Return the end `Point` (row, column). */
-  endPosition(): Point
+  endPosition(): Point;
   /** True when this node is named (not punctuation/whitespace). */
-  isNamed(): boolean
+  isNamed(): boolean;
   /** True when this is an error node. */
-  isError(): boolean
+  isError(): boolean;
   /** True when this is a missing-token node. */
-  isMissing(): boolean
+  isMissing(): boolean;
   /** True when this is an "extra" node (e.g. a comment). */
-  isExtra(): boolean
+  isExtra(): boolean;
   /** True when this node or any descendant is an error. */
-  hasError(): boolean
+  hasError(): boolean;
   /** Return this node's parent, if any. */
-  parent(): Node | null
+  parent(): Node | null;
   /** Return the i-th child of this node, if any. */
-  child(index: number): Node | null
+  child(index: number): Node | null;
   /** Total number of children (including unnamed). */
-  childCount(): number
+  childCount(): number;
   /** Return the i-th named child of this node, if any. */
-  namedChild(index: number): Node | null
+  namedChild(index: number): Node | null;
   /** Number of named children of this node. */
-  namedChildCount(): number
+  namedChildCount(): number;
   /** Look up a child by its grammar-defined field name. */
-  childByFieldName(name: string): Node | null
+  childByFieldName(name: string): Node | null;
   /** Return the S-expression form of this node's subtree. */
-  toSexp(): string
+  toSexp(): string;
   /** Return a `TreeCursor` positioned at this node. */
-  walk(): TreeCursor
+  walk(): TreeCursor;
 }
 
 /**
@@ -808,13 +795,13 @@ export interface PackConfig {
    *
    * Default base: the platform cache dir, e.g. `~/.cache` on Linux.
    */
-  readonly cacheDir?: string
+  readonly cacheDir?: string;
   /**
    * Languages to pre-download on init.
    *
    * Each entry is a language name (e.g. `"python"`, `"rust"`).
    */
-  readonly languages?: Array<string>
+  readonly languages?: Array<string>;
   /**
    * Language groups to pre-download.
    *
@@ -823,7 +810,7 @@ export interface PackConfig {
    * Call `manifest_groups` to enumerate them.
    * An unknown name makes `init` fail.
    */
-  readonly groups?: Array<string>
+  readonly groups?: Array<string>;
 }
 
 /** A tree-sitter parser configured for one language at a time. */
@@ -836,7 +823,7 @@ export declare class Parser {
    * `set_parse_timeout_ms`; both default to
    * unbounded so that existing callers are unaffected.
    */
-  static new(): Parser
+  static new(): Parser;
   /**
    * Refuse to parse sources longer than `max_bytes`.
    *
@@ -846,7 +833,7 @@ export declare class Parser {
    *
    * See `RECOMMENDED_MAX_SOURCE_BYTES`.
    */
-  setMaxSourceBytes(maxBytes?: number | undefined | null): void
+  setMaxSourceBytes(maxBytes?: number | undefined | null): void;
   /**
    * Cancel a parse that exceeds `timeout_ms` milliseconds of wall clock.
    *
@@ -856,7 +843,7 @@ export declare class Parser {
    *
    * See `RECOMMENDED_PARSE_TIMEOUT_MS`.
    */
-  setParseTimeoutMs(timeoutMs?: number | undefined | null): void
+  setParseTimeoutMs(timeoutMs?: number | undefined | null): void;
   /**
    * Configure the parser to use the language identified by name (e.g. `"python"`).
    *
@@ -865,7 +852,7 @@ export declare class Parser {
    * @throws Returns `Error.LanguageNotFound` if the language is not recognized,
    * or `Error.ParserSetup` if the language ABI is incompatible.
    */
-  setLanguage(name: string): void
+  setLanguage(name: string): void;
   /**
    * Parse a UTF-8 source string.
    *
@@ -883,26 +870,26 @@ export declare class Parser {
    * threads can't corrupt shared scanner state. Every other language is unaffected by that
    * lock and never waits on it.
    */
-  parse(source: string): Tree | null
+  parse(source: string): Tree | null;
   /**
    * Parse a raw byte slice.
    *
    * Same outcomes as `parse`, including the concurrency behaviour documented
    * there.
    */
-  parseBytes(source: Uint8Array): Tree | null
+  parseBytes(source: Uint8Array): Tree | null;
   /**
    * Reset internal state. The next call to `parse` will
    * not be incremental.
    */
-  reset(): void
-  static default(): Parser
+  reset(): void;
+  static default(): Parser;
 }
 
 /** A source position — row + column, zero-indexed. */
 export interface Point {
   /** Zero-indexed row number. */
-  readonly row: number
+  readonly row: number;
   /**
    * Zero-indexed column, counted in **bytes** from the start of the row.
    *
@@ -919,7 +906,7 @@ export interface Point {
    * instead. Earlier releases documented this field as UTF-16 code units;
    * that was never what the value contained.
    */
-  readonly column: number
+  readonly column: number;
 }
 
 /**
@@ -929,21 +916,21 @@ export interface Point {
  */
 export interface ProcessConfig {
   /** Language name (required). */
-  readonly language?: string
+  readonly language?: string;
   /** Extract structural items (functions, classes, etc.). Default: true. */
-  readonly structure?: boolean
+  readonly structure?: boolean;
   /** Extract import statements. Default: true. */
-  readonly imports?: boolean
+  readonly imports?: boolean;
   /** Extract export statements. Default: true. */
-  readonly exports?: boolean
+  readonly exports?: boolean;
   /** Extract comments. Default: false. */
-  readonly comments?: boolean
+  readonly comments?: boolean;
   /** Extract docstrings. Default: false. */
-  readonly docstrings?: boolean
+  readonly docstrings?: boolean;
   /** Extract symbol definitions. Default: false. */
-  readonly symbols?: boolean
+  readonly symbols?: boolean;
   /** Include parse diagnostics. Default: false. */
-  readonly diagnostics?: boolean
+  readonly diagnostics?: boolean;
   /**
    * Maximum chunk size in bytes. `None` disables chunking.
    *
@@ -952,7 +939,7 @@ export interface ProcessConfig {
    * limit previously produced an empty chunk list and silently discarded the
    * whole source; use `None` to mean "do not chunk".
    */
-  readonly chunkMaxSize?: number
+  readonly chunkMaxSize?: number;
   /**
    * Extract hierarchical key/value data tree from data-format files. Default: false.
    *
@@ -963,7 +950,7 @@ export interface ProcessConfig {
    *
    * For languages outside this set the field is left as `None`.
    */
-  readonly dataExtraction?: boolean
+  readonly dataExtraction?: boolean;
   /**
    * Reject source longer than this many bytes instead of parsing it.
    * Default: `None` (unbounded).
@@ -978,7 +965,7 @@ export interface ProcessConfig {
    * `Error.InvalidRange` — the source is never
    * silently truncated.
    */
-  readonly maxSourceBytes?: number
+  readonly maxSourceBytes?: number;
   /**
    * Wall-clock budget for the parse step, in milliseconds.
    * Default: `None` (no timeout).
@@ -988,7 +975,7 @@ export interface ProcessConfig {
    * interval rather than exact. A parse that exceeds the budget fails with
    * `Error.ParseTimeout`.
    */
-  readonly parseTimeoutMs?: number
+  readonly parseTimeoutMs?: number;
 }
 
 /**
@@ -1013,25 +1000,25 @@ export interface ProcessConfig {
  */
 export interface ProcessResult {
   /** The language name used to parse the source file. */
-  readonly language?: string
+  readonly language?: string;
   /** File-level metrics (line counts, byte size, error count). */
-  readonly metrics?: FileMetrics
+  readonly metrics?: FileMetrics;
   /** Top-level structural items (functions, classes, etc.). */
-  readonly structure?: Array<StructureItem>
+  readonly structure?: Array<StructureItem>;
   /** Import statements extracted from the source. */
-  readonly imports?: Array<ImportInfo>
+  readonly imports?: Array<ImportInfo>;
   /** Export statements extracted from the source. */
-  readonly exports?: Array<ExportInfo>
+  readonly exports?: Array<ExportInfo>;
   /** Comments extracted from the source. */
-  readonly comments?: Array<CommentInfo>
+  readonly comments?: Array<CommentInfo>;
   /** Docstrings extracted from the source. */
-  readonly docstrings?: Array<DocstringInfo>
+  readonly docstrings?: Array<DocstringInfo>;
   /** Symbol definitions (variables, types, functions) extracted from the source. */
-  readonly symbols?: Array<SymbolInfo>
+  readonly symbols?: Array<SymbolInfo>;
   /** Parse diagnostics (syntax errors, missing nodes) from tree-sitter. */
-  readonly diagnostics?: Array<Diagnostic>
+  readonly diagnostics?: Array<Diagnostic>;
   /** Syntax-aware code chunks produced when chunking is enabled. */
-  readonly chunks?: Array<CodeChunk>
+  readonly chunks?: Array<CodeChunk>;
   /**
    * Hierarchical data tree extracted when `config.data_extraction` is `true`.
    *
@@ -1041,7 +1028,7 @@ export interface ProcessResult {
    *
    * See `DataNode` for the shape of the returned tree.
    */
-  readonly data?: DataNode
+  readonly data?: DataNode;
 }
 
 /**
@@ -1052,37 +1039,37 @@ export interface ProcessResult {
  */
 export interface Span {
   /** Inclusive start byte offset in the source. */
-  readonly startByte?: number
+  readonly startByte?: number;
   /** Exclusive end byte offset in the source. */
-  readonly endByte?: number
+  readonly endByte?: number;
   /** Zero-indexed line number of the span's start. */
-  readonly startLine?: number
+  readonly startLine?: number;
   /**
    * Zero-indexed column of the span's start, counted in **bytes** from the
    * start of the line — not characters, not UTF-16 code units.
    */
-  readonly startColumn?: number
+  readonly startColumn?: number;
   /** Zero-indexed line number of the span's end. */
-  readonly endLine?: number
+  readonly endLine?: number;
   /**
    * Zero-indexed column of the span's end, counted in **bytes** from the
    * start of the line — not characters, not UTF-16 code units.
    */
-  readonly endColumn?: number
+  readonly endColumn?: number;
 }
 
 /** A structural item (function, class, struct, etc.) in source code. */
 export interface StructureItem {
   /** The kind of structural item. */
-  readonly kind?: StructureKind
+  readonly kind?: StructureKind;
   /** The declared name of the item, if present. */
-  readonly name?: string
+  readonly name?: string;
   /** Visibility modifier (e.g., `"pub"`, `"public"`, `"private"`). */
-  readonly visibility?: string
+  readonly visibility?: string;
   /** Source span covering the entire item declaration. */
-  readonly span?: Span
+  readonly span?: Span;
   /** Nested structural items (e.g., methods within a class). */
-  readonly children?: Array<StructureItem>
+  readonly children?: Array<StructureItem>;
   /**
    * Decorator or attribute names applied to the item.
    *
@@ -1093,7 +1080,7 @@ export interface StructureItem {
    * implements yet. The field is kept rather than removed so a consumer's
    * deserializer does not need updating once it is.
    */
-  readonly decorators?: Array<string>
+  readonly decorators?: Array<string>;
   /**
    * Documentation comment attached to the item, if any.
    *
@@ -1108,7 +1095,7 @@ export interface StructureItem {
    * comment in Python, Ruby, or Elixir) — Python's docstring convention is
    * captured separately, as `DocstringInfo`, not through this field.
    */
-  readonly docComment?: string
+  readonly docComment?: string;
   /**
    * Full signature text of the item (e.g., function parameters and return type).
    *
@@ -1121,9 +1108,9 @@ export interface StructureItem {
    * it is derived from `body_span`'s boundary rather than per-language
    * syntax.
    */
-  readonly signature?: string
+  readonly signature?: string;
   /** Source span covering only the body of the item, if distinct from the declaration. */
-  readonly bodySpan?: Span
+  readonly bodySpan?: Span;
 }
 
 /**
@@ -1142,41 +1129,29 @@ export interface StructureItem {
  * any change breaks all bindings' `process()` tests simultaneously.
  * Covered by `tests/wire_format.rs`.
  */
-export declare enum StructureKind {
-  /** A free-standing or associated function. */
-  Function = "Function",
-  /** A method defined inside a class, struct, trait, or impl block. */
-  Method = "Method",
-  /** A class definition. */
-  Class = "Class",
-  /** A struct definition. */
-  Struct = "Struct",
-  /** An interface or protocol definition. */
-  Interface = "Interface",
-  /** An enum definition. */
-  Enum = "Enum",
-  /** A module or package declaration. */
-  Module = "Module",
-  /** A trait definition. */
-  Trait = "Trait",
-  /** An impl block (Rust) or similar implementation block. */
-  Impl = "Impl",
-  /** A namespace declaration. */
-  Namespace = "Namespace",
-  /** A language-specific construct that does not fit any standard category. */
-  Other = "Other",
-}
+export type StructureKind =
+  | { type: "Function" }
+  | { type: "Method" }
+  | { type: "Class" }
+  | { type: "Struct" }
+  | { type: "Interface" }
+  | { type: "Enum" }
+  | { type: "Module" }
+  | { type: "Trait" }
+  | { type: "Impl" }
+  | { type: "Namespace" }
+  | { type: "Other"; other: string };
 
 /** A symbol (variable, function, type, etc.) extracted from source code. */
 export interface SymbolInfo {
   /** The name of the symbol. */
-  readonly name?: string
+  readonly name?: string;
   /** The kind of symbol (variable, function, class, etc.). */
-  readonly kind?: SymbolKind
+  readonly kind?: SymbolKind;
   /** Source span covering the symbol definition. */
-  readonly span?: Span
+  readonly span?: Span;
   /** Explicit type annotation, if present in the source. */
-  readonly typeAnnotation?: string
+  readonly typeAnnotation?: string;
   /**
    * Documentation comment immediately preceding this symbol, resolved by
    * the same walk `StructureItem.doc_comment` uses (see
@@ -1189,7 +1164,7 @@ export interface SymbolInfo {
    * also `None` when a symbol in a supported language simply has no doc
    * comment immediately above it.
    */
-  readonly doc?: string
+  readonly doc?: string;
 }
 
 /**
@@ -1204,56 +1179,46 @@ export interface SymbolInfo {
  * variant serializes as a single-keyed object (`{"Other": "macro"}`). DO
  * NOT add `#[serde(tag = "...")]`. Covered by `tests/wire_format.rs`.
  */
-export declare enum SymbolKind {
-  /** A variable binding. */
-  Variable = "Variable",
-  /** A constant (immutable binding). */
-  Constant = "Constant",
-  /** A function definition. */
-  Function = "Function",
-  /** A class definition. */
-  Class = "Class",
-  /** A type alias or typedef. */
-  Type = "Type",
-  /** An interface definition. */
-  Interface = "Interface",
-  /** An enum definition. */
-  Enum = "Enum",
-  /** A module declaration. */
-  Module = "Module",
-  /** A symbol kind not covered by the standard variants. */
-  Other = "Other",
-}
+export type SymbolKind =
+  | { type: "Variable" }
+  | { type: "Constant" }
+  | { type: "Function" }
+  | { type: "Class" }
+  | { type: "Type" }
+  | { type: "Interface" }
+  | { type: "Enum" }
+  | { type: "Module" }
+  | { type: "Other"; other: string };
 
 /** A parsed syntax tree. Cheap to clone (refcount bump). */
 export declare class Tree {
   /** Return the root `Node` of this tree. */
-  rootNode(): Node
+  rootNode(): Node;
   /** Return a `TreeCursor` positioned at the root. */
-  walk(): TreeCursor
+  walk(): TreeCursor;
 }
 
 /** A cursor for traversing a `Tree`. */
 export declare class TreeCursor {
   /** Return the `Node` at the cursor's current position. */
-  node(): Node
+  node(): Node;
   /**
    * Move the cursor to the first child of the current node.
    * Returns `true` if a child existed.
    */
-  gotoFirstChild(): boolean
+  gotoFirstChild(): boolean;
   /**
    * Move the cursor to the parent of the current node.
    * Returns `true` if a parent existed.
    */
-  gotoParent(): boolean
+  gotoParent(): boolean;
   /**
    * Move the cursor to the next sibling of the current node.
    * Returns `true` if a sibling existed.
    */
-  gotoNextSibling(): boolean
+  gotoNextSibling(): boolean;
   /** Return the field name for the current node, if any. */
-  fieldName(): string | null
+  fieldName(): string | null;
 }
 
 /**

package/index.js

@@ -9,16 +9,9 @@ const isMusl = () => {
   // "is musl" positive. Fall through to the filesystem heuristic instead: on
   // glibc systems `/lib64/ld-musl-x86_64.so.1` does not exist; on musl systems
   // it always does. statSync errors → not musl.
-  if (
-    typeof process.report === "object" &&
-    typeof process.report.getReport === "function"
-  ) {
+  if (typeof process.report === "object" && typeof process.report.getReport === "function") {
     const report = process.report.getReport();
-    if (
-      report &&
-      report.header &&
-      typeof report.header.glibcVersion === "string"
-    ) {
+    if (report && report.header && typeof report.header.glibcVersion === "string") {
       return false;
     }
   }
@@ -47,14 +40,56 @@ const tryLoadBinding = () => {
   // Optional-dep packages are named after `napi.packageName` (npm subpackage names),
   // which inherits any scope prefix from the parent package.
   const targets = [
-    ["linux", "x64", "gnu", "./ts-pack-core-node.linux-x64-gnu.node", "@xberg-io/tree-sitter-language-pack-linux-x64-gnu"],
-    ["linux", "arm64", "gnu", "./ts-pack-core-node.linux-arm64-gnu.node", "@xberg-io/tree-sitter-language-pack-linux-arm64-gnu"],
-    ["linux", "x64", "musl", "./ts-pack-core-node.linux-x64-musl.node", "@xberg-io/tree-sitter-language-pack-linux-x64-musl"],
-    ["linux", "arm64", "musl", "./ts-pack-core-node.linux-arm64-musl.node", "@xberg-io/tree-sitter-language-pack-linux-arm64-musl"],
+    [
+      "linux",
+      "x64",
+      "gnu",
+      "./ts-pack-core-node.linux-x64-gnu.node",
+      "@xberg-io/tree-sitter-language-pack-linux-x64-gnu",
+    ],
+    [
+      "linux",
+      "arm64",
+      "gnu",
+      "./ts-pack-core-node.linux-arm64-gnu.node",
+      "@xberg-io/tree-sitter-language-pack-linux-arm64-gnu",
+    ],
+    [
+      "linux",
+      "x64",
+      "musl",
+      "./ts-pack-core-node.linux-x64-musl.node",
+      "@xberg-io/tree-sitter-language-pack-linux-x64-musl",
+    ],
+    [
+      "linux",
+      "arm64",
+      "musl",
+      "./ts-pack-core-node.linux-arm64-musl.node",
+      "@xberg-io/tree-sitter-language-pack-linux-arm64-musl",
+    ],
     ["darwin", "x64", null, "./ts-pack-core-node.darwin-x64.node", "@xberg-io/tree-sitter-language-pack-darwin-x64"],
-    ["darwin", "arm64", null, "./ts-pack-core-node.darwin-arm64.node", "@xberg-io/tree-sitter-language-pack-darwin-arm64"],
-    ["win32", "x64", null, "./ts-pack-core-node.win32-x64-msvc.node", "@xberg-io/tree-sitter-language-pack-win32-x64-msvc"],
-    ["win32", "arm64", null, "./ts-pack-core-node.win32-arm64-msvc.node", "@xberg-io/tree-sitter-language-pack-win32-arm64-msvc"],
+    [
+      "darwin",
+      "arm64",
+      null,
+      "./ts-pack-core-node.darwin-arm64.node",
+      "@xberg-io/tree-sitter-language-pack-darwin-arm64",
+    ],
+    [
+      "win32",
+      "x64",
+      null,
+      "./ts-pack-core-node.win32-x64-msvc.node",
+      "@xberg-io/tree-sitter-language-pack-win32-x64-msvc",
+    ],
+    [
+      "win32",
+      "arm64",
+      null,
+      "./ts-pack-core-node.win32-arm64-msvc.node",
+      "@xberg-io/tree-sitter-language-pack-win32-arm64-msvc",
+    ],
   ];
 
   for (const [plat, a, abi, localPath, optionalDep] of targets) {
@@ -93,9 +128,7 @@ const tryLoadBinding = () => {
 tryLoadBinding();
 
 if (!nativeBinding) {
-  throw new Error(
-    `Failed to load native binding for ${platform}-${arch}. Errors: ${loadErrors.join(", ")}`
-  );
+  throw new Error(`Failed to load native binding for ${platform}-${arch}. Errors: ${loadErrors.join(", ")}`);
 }
 
 module.exports = nativeBinding;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xberg-io/tree-sitter-language-pack",
-  "version": "1.15.7",
+  "version": "1.16.2",
   "description": "Pre-compiled tree-sitter grammars for 371 programming languages",
   "license": "MIT",
   "repository": {
@@ -18,14 +18,14 @@
   },
   "files": ["index.js", "index.d.ts", "*.node"],
   "optionalDependencies": {
-    "@xberg-io/tree-sitter-language-pack-linux-x64-gnu": "1.15.7",
-    "@xberg-io/tree-sitter-language-pack-linux-arm64-gnu": "1.15.7",
-    "@xberg-io/tree-sitter-language-pack-linux-x64-musl": "1.15.7",
-    "@xberg-io/tree-sitter-language-pack-linux-arm64-musl": "1.15.7",
-    "@xberg-io/tree-sitter-language-pack-darwin-x64": "1.15.7",
-    "@xberg-io/tree-sitter-language-pack-darwin-arm64": "1.15.7",
-    "@xberg-io/tree-sitter-language-pack-win32-x64-msvc": "1.15.7",
-    "@xberg-io/tree-sitter-language-pack-win32-arm64-msvc": "1.15.7"
+    "@xberg-io/tree-sitter-language-pack-darwin-arm64": "1.16.2",
+    "@xberg-io/tree-sitter-language-pack-darwin-x64": "1.16.2",
+    "@xberg-io/tree-sitter-language-pack-linux-arm64-gnu": "1.16.2",
+    "@xberg-io/tree-sitter-language-pack-linux-arm64-musl": "1.16.2",
+    "@xberg-io/tree-sitter-language-pack-linux-x64-gnu": "1.16.2",
+    "@xberg-io/tree-sitter-language-pack-linux-x64-musl": "1.16.2",
+    "@xberg-io/tree-sitter-language-pack-win32-arm64-msvc": "1.16.2",
+    "@xberg-io/tree-sitter-language-pack-win32-x64-msvc": "1.16.2"
   },
   "napi": {
     "packageName": "@xberg-io/tree-sitter-language-pack",
@@ -46,7 +46,13 @@
     "artifacts": "npx --yes -p @napi-rs/cli@^3.7.3 napi artifacts",
     "prepublishOnly": "npx --yes -p @napi-rs/cli@^3.7.3 napi prepublish -t npm --skip-optional-publish"
   },
-  "engines": { "node": ">= 22" },
-  "publishConfig": { "access": "public" },
-  "devDependencies": { "@napi-rs/cli": "^3.7.3" }
+  "engines": {
+    "node": ">= 22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.8.6"
+  }
 }