@kreuzberg/tree-sitter-language-pack-wasm 1.8.0 → 1.8.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kreuzberg/tree-sitter-language-pack-wasm",
   "description": "Pre-compiled tree-sitter grammars for 305 programming languages",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "license": "MIT",
   "repository": {
     "type": "git",

package/ts_pack_core_wasm.d.ts

@@ -1,12 +1,25 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * A byte range — start (inclusive) to end (exclusive).
+ */
+export class WasmByteRange {
+    free(): void;
+    [Symbol.dispose](): void;
+    static default(): WasmByteRange;
+    constructor(start: number, end: number);
+    end: number;
+    start: number;
+}
+
 /**
  * Metadata for a single chunk of source code.
  */
 export class WasmChunkContext {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmChunkContext;
     constructor(language?: string | null, chunk_index?: number | null, total_chunks?: number | null, node_types?: string[] | null, context_path?: string[] | null, symbols_defined?: string[] | null, comments?: WasmCommentInfo[] | null, docstrings?: WasmDocstringInfo[] | null, has_error_nodes?: boolean | null);
     chunkIndex: number;
     comments: WasmCommentInfo[];
@@ -25,6 +38,7 @@ export class WasmChunkContext {
 export class WasmCodeChunk {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmCodeChunk;
     constructor(content?: string | null, start_byte?: number | null, end_byte?: number | null, start_line?: number | null, end_line?: number | null, metadata?: WasmChunkContext | null);
     content: string;
     endByte: number;
@@ -40,10 +54,12 @@ export class WasmCodeChunk {
 export class WasmCommentInfo {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmCommentInfo;
     constructor(text?: string | null, kind?: WasmCommentKind | null, span?: WasmSpan | null, associated_node?: string | null);
     get associatedNode(): string | undefined;
     set associatedNode(value: string | null | undefined);
-    kind: WasmCommentKind;
+    get kind(): string;
+    set kind(value: WasmCommentKind);
     span: WasmSpan;
     text: string;
 }
@@ -66,9 +82,11 @@ export enum WasmCommentKind {
 export class WasmDiagnostic {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmDiagnostic;
     constructor(message?: string | null, severity?: WasmDiagnosticSeverity | null, span?: WasmSpan | null);
     message: string;
-    severity: WasmDiagnosticSeverity;
+    get severity(): string;
+    set severity(value: WasmDiagnosticSeverity);
     span: WasmSpan;
 }
 
@@ -90,6 +108,7 @@ export enum WasmDiagnosticSeverity {
 export class WasmDocSection {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmDocSection;
     constructor(kind?: string | null, description?: string | null, name?: string | null);
     description: string;
     kind: string;
@@ -118,10 +137,12 @@ export enum WasmDocstringFormat {
 export class WasmDocstringInfo {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmDocstringInfo;
     constructor(text?: string | null, format?: WasmDocstringFormat | null, span?: WasmSpan | null, parsed_sections?: WasmDocSection[] | null, associated_item?: string | null);
     get associatedItem(): string | undefined;
     set associatedItem(value: string | null | undefined);
-    format: WasmDocstringFormat;
+    get format(): string;
+    set format(value: WasmDocstringFormat);
     parsedSections: WasmDocSection[];
     span: WasmSpan;
     text: string;
@@ -133,8 +154,10 @@ export class WasmDocstringInfo {
 export class WasmExportInfo {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmExportInfo;
     constructor(name?: string | null, kind?: WasmExportKind | null, span?: WasmSpan | null);
-    kind: WasmExportKind;
+    get kind(): string;
+    set kind(value: WasmExportKind);
     name: string;
     span: WasmSpan;
 }
@@ -156,6 +179,7 @@ export enum WasmExportKind {
 export class WasmFileMetrics {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmFileMetrics;
     constructor(total_lines?: number | null, code_lines?: number | null, comment_lines?: number | null, blank_lines?: number | null, total_bytes?: number | null, node_count?: number | null, error_count?: number | null, max_depth?: number | null);
     blankLines: number;
     codeLines: number;
@@ -173,6 +197,7 @@ export class WasmFileMetrics {
 export class WasmImportInfo {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmImportInfo;
     constructor(source?: string | null, items?: string[] | null, is_wildcard?: boolean | null, span?: WasmSpan | null, alias?: string | null);
     get alias(): string | undefined;
     set alias(value: string | null | undefined);
@@ -271,6 +296,102 @@ export class WasmLanguageRegistry {
     static withLibsDir(libs_dir: string): WasmLanguageRegistry;
 }
 
+/**
+ * A single syntax node within a [`Tree`].
+ *
+ * Nodes hold a strong reference to their parent tree so they remain valid
+ * regardless of how the tree is moved or stored at the FFI boundary.
+ */
+export class WasmNode {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Return the node's byte range as a [`ByteRange`].
+     *
+     * Callers should slice their own source bytes — this is a zero-copy
+     * text accessor.
+     */
+    byteRange(): WasmByteRange;
+    /**
+     * Return the i-th child of this node, if any.
+     */
+    child(index: number): WasmNode | undefined;
+    /**
+     * Look up a child by its grammar-defined field name.
+     */
+    childByFieldName(name: string): WasmNode | undefined;
+    /**
+     * Total number of children (including unnamed).
+     */
+    childCount(): number;
+    clone(): WasmNode;
+    /**
+     * Return the exclusive end byte offset of this node.
+     */
+    endByte(): number;
+    /**
+     * Return the end [`Point`] (row, column).
+     */
+    endPosition(): WasmPoint;
+    /**
+     * True when this node or any descendant is an error.
+     */
+    hasError(): boolean;
+    /**
+     * True when this is an error node.
+     */
+    isError(): boolean;
+    /**
+     * True when this is an "extra" node (e.g. a comment).
+     */
+    isExtra(): boolean;
+    /**
+     * True when this is a missing-token node.
+     */
+    isMissing(): boolean;
+    /**
+     * True when this node is named (not punctuation/whitespace).
+     */
+    isNamed(): boolean;
+    /**
+     * Return the node's kind name (e.g. `"function_definition"`).
+     */
+    kind(): string;
+    /**
+     * Return the node's numeric kind ID.
+     */
+    kindId(): number;
+    /**
+     * Return the i-th named child of this node, if any.
+     */
+    namedChild(index: number): WasmNode | undefined;
+    /**
+     * Number of named children of this node.
+     */
+    namedChildCount(): number;
+    /**
+     * Return this node's parent, if any.
+     */
+    parent(): WasmNode | undefined;
+    /**
+     * Return the inclusive start byte offset of this node.
+     */
+    startByte(): number;
+    /**
+     * Return the start [`Point`] (row, column).
+     */
+    startPosition(): WasmPoint;
+    /**
+     * Return the S-expression form of this node's subtree.
+     */
+    toSexp(): string;
+    /**
+     * Return a [`TreeCursor`] positioned at this node.
+     */
+    walk(): WasmTreeCursor;
+}
+
 /**
  * Configuration for the tree-sitter language pack.
  *
@@ -293,6 +414,7 @@ export class WasmLanguageRegistry {
 export class WasmPackConfig {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmPackConfig;
     /**
      * Discover configuration by searching for `language-pack.toml` in:
      *
@@ -339,10 +461,66 @@ export class WasmPackConfig {
     set languages(value: string[] | null | undefined);
 }
 
+/**
+ * A tree-sitter parser configured for one language at a time.
+ *
+ * # Example
+ *
+ * ```no_run
+ * use tree_sitter_language_pack::Parser;
+ *
+ * let mut parser = Parser::new();
+ * parser.set_language("python")?;
+ * let tree = parser.parse("def hello(): pass").expect("parse failed");
+ * assert_eq!(tree.root_node().kind(), "module");
+ * # Ok::<(), tree_sitter_language_pack::Error>(())
+ * ```
+ */
 export class WasmParser {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmParser;
+    /**
+     * Parse a UTF-8 source string. Returns `None` if parsing was cancelled
+     * or no language is set.
+     */
+    parse(source: string): WasmTree | undefined;
+    /**
+     * Parse a raw byte slice. Returns `None` if parsing was cancelled or
+     * no language is set.
+     */
+    parseBytes(source: Uint8Array): WasmTree | undefined;
+    /**
+     * Reset internal state. The next call to [`parse`](Self::parse) will
+     * not be incremental.
+     */
+    reset(): void;
+    /**
+     * Configure the parser to use the language identified by name (e.g. `"python"`).
+     *
+     * Resolves the language through the global registry — auto-downloading
+     * if necessary, when the `download` feature is enabled.
+     *
+     * # Errors
+     *
+     * Returns [`Error::LanguageNotFound`] if the language is not recognized,
+     * or [`Error::ParserSetup`] if the language ABI is incompatible.
+     */
+    setLanguage(name: string): void;
+}
+
+/**
+ * A source position — row + column, zero-indexed.
+ */
+export class WasmPoint {
+    free(): void;
+    [Symbol.dispose](): void;
+    static default(): WasmPoint;
+    static from(p: WasmPoint): WasmPoint;
+    constructor(row: number, column: number);
+    column: number;
+    row: number;
 }
 
 /**
@@ -417,6 +595,7 @@ export class WasmProcessConfig {
 export class WasmProcessResult {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmProcessResult;
     constructor(language?: string | null, metrics?: WasmFileMetrics | null, structure?: WasmStructureItem[] | null, imports?: WasmImportInfo[] | null, exports?: WasmExportInfo[] | null, comments?: WasmCommentInfo[] | null, docstrings?: WasmDocstringInfo[] | null, symbols?: WasmSymbolInfo[] | null, diagnostics?: WasmDiagnostic[] | null, chunks?: WasmCodeChunk[] | null);
     chunks: WasmCodeChunk[];
     comments: WasmCommentInfo[];
@@ -439,6 +618,7 @@ export class WasmProcessResult {
 export class WasmSpan {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmSpan;
     constructor(start_byte?: number | null, end_byte?: number | null, start_line?: number | null, start_column?: number | null, end_line?: number | null, end_column?: number | null);
     endByte: number;
     endColumn: number;
@@ -454,6 +634,7 @@ export class WasmSpan {
 export class WasmStructureItem {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmStructureItem;
     constructor(kind?: WasmStructureKind | null, span?: WasmSpan | null, children?: WasmStructureItem[] | null, decorators?: string[] | null, name?: string | null, visibility?: string | null, doc_comment?: string | null, signature?: string | null, body_span?: WasmSpan | null);
     get bodySpan(): WasmSpan | undefined;
     set bodySpan(value: WasmSpan | null | undefined);
@@ -461,7 +642,8 @@ export class WasmStructureItem {
     decorators: string[];
     get docComment(): string | undefined;
     set docComment(value: string | null | undefined);
-    kind: WasmStructureKind;
+    get kind(): string;
+    set kind(value: WasmStructureKind);
     get name(): string | undefined;
     set name(value: string | null | undefined);
     get signature(): string | undefined;
@@ -498,10 +680,12 @@ export enum WasmStructureKind {
 export class WasmSymbolInfo {
     free(): void;
     [Symbol.dispose](): void;
+    static default(): WasmSymbolInfo;
     constructor(name?: string | null, kind?: WasmSymbolKind | null, span?: WasmSpan | null, type_annotation?: string | null, doc?: string | null);
     get doc(): string | undefined;
     set doc(value: string | null | undefined);
-    kind: WasmSymbolKind;
+    get kind(): string;
+    set kind(value: WasmSymbolKind);
     name: string;
     span: WasmSpan;
     get typeAnnotation(): string | undefined;
@@ -526,10 +710,53 @@ export enum WasmSymbolKind {
     Other = 8,
 }
 
+/**
+ * A parsed syntax tree. Cheap to clone (refcount bump).
+ */
 export class WasmTree {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Return the root [`Node`] of this tree.
+     */
+    rootNode(): WasmNode;
+    /**
+     * Return a [`TreeCursor`] positioned at the root.
+     */
+    walk(): WasmTreeCursor;
+}
+
+/**
+ * A cursor for traversing a [`Tree`].
+ */
+export class WasmTreeCursor {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Return the field name for the current node, if any.
+     */
+    fieldName(): string | undefined;
+    /**
+     * Move the cursor to the first child of the current node.
+     * Returns `true` if a child existed.
+     */
+    gotoFirstChild(): boolean;
+    /**
+     * Move the cursor to the next sibling of the current node.
+     * Returns `true` if a sibling existed.
+     */
+    gotoNextSibling(): boolean;
+    /**
+     * Move the cursor to the parent of the current node.
+     * Returns `true` if a parent existed.
+     */
+    gotoParent(): boolean;
+    /**
+     * Return the [`Node`] at the cursor's current position.
+     */
+    node(): WasmNode;
 }
 
 /**
@@ -667,14 +894,14 @@ export function getInjectionsQuery(language: string): string | undefined;
  * # Example
  *
  * ```no_run
- * use tree_sitter_language_pack::get_language;
+ * use tree_sitter_language_pack::{get_language, Parser};
  *
- * let lang = get_language("python").unwrap();
- * // Use the Language with a tree-sitter Parser
- * let mut parser = tree_sitter::Parser::new();
- * parser.set_language(&lang).unwrap();
- * let tree = parser.parse("x = 1", None).unwrap();
+ * let _lang = get_language("python")?;
+ * let mut parser = Parser::new();
+ * parser.set_language("python")?;
+ * let tree = parser.parse("x = 1").expect("parse failed");
  * assert_eq!(tree.root_node().kind(), "module");
+ * # Ok::<(), tree_sitter_language_pack::Error>(())
  * ```
  */
 export function getLanguage(name: string): WasmLanguage;
@@ -699,7 +926,7 @@ export function getLanguage(name: string): WasmLanguage;
 export function getLocalsQuery(language: string): string | undefined;
 
 /**
- * Get a tree-sitter [`Parser`] pre-configured for the given language.
+ * Get a [`Parser`] pre-configured for the given language.
  *
  * This is a convenience function that calls [`get_language`] and configures
  * a new parser in one step.
@@ -714,9 +941,10 @@ export function getLocalsQuery(language: string): string | undefined;
  * ```no_run
  * use tree_sitter_language_pack::get_parser;
  *
- * let mut parser = get_parser("rust").unwrap();
- * let tree = parser.parse("fn main() {}", None).unwrap();
+ * let mut parser = get_parser("rust")?;
+ * let tree = parser.parse("fn main() {}").expect("parse failed");
  * assert!(!tree.root_node().has_error());
+ * # Ok::<(), tree_sitter_language_pack::Error>(())
  * ```
  */
 export function getParser(name: string): WasmParser;