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

package/index.d.ts

@@ -1,9 +1,10 @@
 // This file is auto-generated by alef — DO NOT EDIT.
-// alef:hash:7c65820ecd6e48e089b65d0938339ac51a03bd08db1e74ea026cec7d9171c313
+// alef:hash:c0ee6526b4cf3c711d551e15e38d99f287ee84b2e323e9d57925ca62c77389e0
 // To regenerate: alef generate
 // To verify freshness: alef verify --exit-code
 // Issues & docs: https://github.com/kreuzberg-dev/alef
 /* eslint-disable */
+import type { Language } from "tree-sitter";
 
 /**
  * List all available language names (sorted, deduplicated, includes aliases).
@@ -243,17 +244,17 @@ export declare function getInjectionsQuery(language: string): string | undefined
  *
  * @example
  * ```typescript
- * 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>(())
  * ```typescript
  */
-export declare function getLanguage(name: string): JsLanguage;
+export declare function getLanguage(name: string): Language;
 
 /**
  * Get the locals query for a language, if bundled.
@@ -273,7 +274,7 @@ export declare function getLanguage(name: string): JsLanguage;
 export declare function getLocalsQuery(language: string): string | undefined | null;
 
 /**
- * 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.
@@ -284,9 +285,10 @@ export declare function getLocalsQuery(language: string): string | undefined | n
  * ```typescript
  * 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>(())
  * ```typescript
  */
 export declare function getParser(name: string): JsParser;
@@ -329,6 +331,14 @@ export declare function hasLanguage(name: string): boolean;
  */
 export declare function init(config: JsPackConfig): void;
 
+/** A byte range — start (inclusive) to end (exclusive). */
+export interface JsByteRange {
+  /** Inclusive start byte offset. */
+  start: number;
+  /** Exclusive end byte offset. */
+  end: number;
+}
+
 /** Metadata for a single chunk of source code. */
 export interface JsChunkContext {
   language?: string;
@@ -499,8 +509,6 @@ export interface JsImportInfo {
   span?: JsSpan;
 }
 
-export declare class JsLanguage {}
-
 export interface JsLanguageInfo {
   group: string;
   size: number;
@@ -555,7 +563,7 @@ export declare class JsLanguageRegistry {
    * @throws Returns [`Error::LanguageNotFound`] if the name (after alias resolution)
    * does not match any known grammar.
    */
-  getLanguage(name: string): JsLanguage;
+  getLanguage(name: string): Language;
   /**
    * List all available language names, sorted and deduplicated.
    *
@@ -577,6 +585,61 @@ export declare class JsLanguageRegistry {
   static default(): JsLanguageRegistry;
 }
 
+/**
+ * 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 declare class JsNode {
+  clone(): JsNode;
+  /** Return the node's kind name (e.g. `"function_definition"`). */
+  kind(): string;
+  /** Return the node's numeric kind ID. */
+  kindId(): number;
+  /** Return the inclusive start byte offset of this node. */
+  startByte(): number;
+  /** Return the exclusive end byte offset of this node. */
+  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(): JsByteRange;
+  /** Return the start [`Point`] (row, column). */
+  startPosition(): JsPoint;
+  /** Return the end [`Point`] (row, column). */
+  endPosition(): JsPoint;
+  /** True when this node is named (not punctuation/whitespace). */
+  isNamed(): boolean;
+  /** True when this is an error node. */
+  isError(): boolean;
+  /** True when this is a missing-token node. */
+  isMissing(): boolean;
+  /** True when this is an "extra" node (e.g. a comment). */
+  isExtra(): boolean;
+  /** True when this node or any descendant is an error. */
+  hasError(): boolean;
+  /** Return this node's parent, if any. */
+  parent(): JsNode | undefined | null;
+  /** Return the i-th child of this node, if any. */
+  child(index: number): JsNode | undefined | null;
+  /** Total number of children (including unnamed). */
+  childCount(): number;
+  /** Return the i-th named child of this node, if any. */
+  namedChild(index: number): JsNode | undefined | null;
+  /** Number of named children of this node. */
+  namedChildCount(): number;
+  /** Look up a child by its grammar-defined field name. */
+  childByFieldName(name: string): JsNode | undefined | null;
+  /** Return the S-expression form of this node's subtree. */
+  toSexp(): string;
+  /** Return a [`TreeCursor`] positioned at this node. */
+  walk(): JsTreeCursor;
+}
+
 /**
  * Configuration for the tree-sitter language pack.
  *
@@ -611,7 +674,46 @@ export interface JsPackConfig {
   groups?: Array<string>;
 }
 
-export declare class JsParser {}
+/**
+ * A tree-sitter parser configured for one language at a time.
+ * @example
+ * ```typescript
+ * 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>(())
+ * ```typescript
+ */
+export declare class JsParser {
+  /**
+   * 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.
+   * @throws Returns [`Error::LanguageNotFound`] if the language is not recognized,
+   * or [`Error::ParserSetup`] if the language ABI is incompatible.
+   */
+  setLanguage(name: string): void;
+  /**
+   * Parse a UTF-8 source string. Returns `None` if parsing was cancelled
+   * or no language is set.
+   */
+  parse(source: string): JsTree | undefined | null;
+  /**
+   * Parse a raw byte slice. Returns `None` if parsing was cancelled or
+   * no language is set.
+   */
+  parseBytes(source: Uint8Array): JsTree | undefined | null;
+  /**
+   * Reset internal state. The next call to [`parse`](Self::parse) will
+   * not be incremental.
+   */
+  reset(): void;
+  static default(): JsParser;
+}
 
 /** Manifest describing available parser downloads for a specific version. */
 export interface JsParserManifest {
@@ -627,6 +729,14 @@ export interface JsPlatformBundle {
   size: number;
 }
 
+/** A source position — row + column, zero-indexed. */
+export interface JsPoint {
+  /** Zero-indexed row number. */
+  row: number;
+  /** Zero-indexed column number, in UTF-16 code units. */
+  column: number;
+}
+
 /**
  * Configuration for the `process()` function.
  *
@@ -775,7 +885,36 @@ export declare enum JsSymbolKind {
   Other = "Other",
 }
 
-export declare class JsTree {}
+/** A parsed syntax tree. Cheap to clone (refcount bump). */
+export declare class JsTree {
+  /** Return the root [`Node`] of this tree. */
+  rootNode(): JsNode;
+  /** Return a [`TreeCursor`] positioned at the root. */
+  walk(): JsTreeCursor;
+}
+
+/** A cursor for traversing a [`Tree`]. */
+export declare class JsTreeCursor {
+  /** Return the [`Node`] at the cursor's current position. */
+  node(): JsNode;
+  /**
+   * Move the cursor to the first child of the current node.
+   * Returns `true` if a child existed.
+   */
+  gotoFirstChild(): boolean;
+  /**
+   * Move the cursor to the parent of the current node.
+   * Returns `true` if a parent existed.
+   */
+  gotoParent(): boolean;
+  /**
+   * Move the cursor to the next sibling of the current node.
+   * Returns `true` if a sibling existed.
+   */
+  gotoNextSibling(): boolean;
+  /** Return the field name for the current node, if any. */
+  fieldName(): string | undefined | null;
+}
 
 /**
  * Return the number of available languages.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreuzberg/tree-sitter-language-pack",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "Tree-sitter language pack - pre-compiled parsers for 305 languages (Node.js NAPI bindings)",
   "keywords": [
     "kreuzberg",
@@ -32,7 +32,16 @@
     "prepublishOnly": "napi prepublish -t npm --skip-optional-publish"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^3.6.2"
+    "@napi-rs/cli": "^3.6.2",
+    "tree-sitter": "^0.25.0"
+  },
+  "peerDependencies": {
+    "tree-sitter": "^0.25.0"
+  },
+  "peerDependenciesMeta": {
+    "tree-sitter": {
+      "optional": true
+    }
   },
   "napi": {
     "binaryName": "ts-pack-core-node",