tree-sitter-language-pack — Node.js

Node.js NAPI bindings for tree-sitter-language-pack with on-demand parser downloads.

Installation

npm install @kreuzberg/tree-sitter-language-pack

pnpm add @kreuzberg/tree-sitter-language-pack

yarn add @kreuzberg/tree-sitter-language-pack

Quick Start

const { init, download, availableLanguages, hasLanguage, process } = require("@kreuzberg/tree-sitter-language-pack");

// Optional: Pre-download specific languages for offline use
init(["python", "javascript", "rust"]);

console.log(availableLanguages());
console.log(hasLanguage("python")); // true

// Auto-downloads language if not cached
const result = process('function hello() {}', { language: 'javascript' });
console.log('Functions:', result.structure.length);

// Pre-download languages for offline use
download(["python", "javascript"]);

// With chunking (auto-downloads if needed)
const result2 = process(source, { language: 'javascript', chunkMaxSize: 1000 });
console.log('Chunks:', result2.chunks.length);

API Reference

Language Discovery

• availableLanguages() -- list all supported language names
• hasLanguage(name) -- check if a language is available
• languageCount() -- total number of supported languages

Language Detection

• detectLanguage(path) -- detect language from file path
• detectLanguageFromExtension(ext) -- detect language from a bare file extension
• detectLanguageFromPath(path) -- detect language from a file path
• detectLanguageFromContent(content) -- detect language from shebang line
• extensionAmbiguity(ext) -- check if an extension is ambiguous (returns assigned language + alternatives)

Parsing

• getParser(name) / parseString(source, language) -- parse source code into a syntax tree

Download API

• init(languages) -- pre-download specific languages for offline use
• download(languages) -- download parsers on demand

Intelligence

• process(source, config) -- extract structured analysis (functions, classes, imports, comments, chunks) from source code

Syntax Highlighting Queries

• getHighlightsQuery(language) -- get bundled highlights.scm query for a language
• getInjectionsQuery(language) -- get bundled injections.scm query
• getLocalsQuery(language) -- get bundled locals.scm query

For full documentation, see kreuzberg.dev.

License

MIT -- see LICENSE for details.

Part of tree-sitter-language-pack -- A comprehensive collection of tree-sitter language parsers with polyglot bindings.