npm package: @kreuzberg/tree-sitter-language-pack
Description: Tree-sitter language pack - pre-compiled parsers for 305 languages (Node.js NAPI bindings)
Latest version: 1.5.0

<!-- Generated by scripts/generate_readme.py. DO NOT EDIT. -->

# tree-sitter-language-pack — Node.js

<div align="center" style="display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin: 20px 0;">
  <!-- Language Bindings -->  <a href="https://crates.io/crates/tree-sitter-language-pack">
    <img src="https://img.shields.io/crates/v/tree-sitter-language-pack?label=Rust&color=007ec6" alt="Rust">
  </a>  <a href="https://pypi.org/project/tree-sitter-language-pack/">
    <img src="https://img.shields.io/pypi/v/tree-sitter-language-pack?label=Python&color=007ec6" alt="Python">
  </a>  <a href="https://www.npmjs.com/package/@kreuzberg/tree-sitter-language-pack">
    <img src="https://img.shields.io/npm/v/@kreuzberg/tree-sitter-language-pack?label=Node.js&color=007ec6" alt="Node">
  </a>  <a href="https://www.npmjs.com/package/@kreuzberg/tree-sitter-language-pack-wasm">
    <img src="https://img.shields.io/npm/v/@kreuzberg/tree-sitter-language-pack-wasm?label=WASM&color=007ec6" alt="Wasm">
  </a>  <a href="https://central.sonatype.com/artifact/dev.kreuzberg/tree-sitter-language-pack">
    <img src="https://img.shields.io/maven-central/v/dev.kreuzberg/tree-sitter-language-pack?label=Java&color=007ec6" alt="Java">
  </a>  <a href="https://github.com/kreuzberg-dev/tree-sitter-language-pack/tree/main/packages/go/v1">
    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/tree-sitter-language-pack?label=Go&color=007ec6" alt="Go">
  </a>  <a href="https://www.nuget.org/packages/TreeSitterLanguagePack">
    <img src="https://img.shields.io/nuget/v/TreeSitterLanguagePack?label=C%23&color=007ec6" alt="Csharp">
  </a>  <a href="https://packagist.org/packages/kreuzberg/tree-sitter-language-pack">
    <img src="https://img.shields.io/packagist/v/kreuzberg/tree-sitter-language-pack?label=PHP&color=007ec6" alt="Php">
  </a>  <a href="https://rubygems.org/gems/tree_sitter_language_pack">
    <img src="https://img.shields.io/gem/v/tree_sitter_language_pack?label=Ruby&color=007ec6" alt="Ruby">
  </a>  <a href="https://hex.pm/packages/tree_sitter_language_pack">
    <img src="https://img.shields.io/hexpm/v/tree_sitter_language_pack?label=Elixir&color=007ec6" alt="Elixir">
  </a>  <a href="https://github.com/kreuzberg-dev/tree-sitter-language-pack/pkgs/container/tree-sitter-language-pack">
    <img src="https://img.shields.io/badge/Docker-007ec6?logo=docker&logoColor=white" alt="Docker">
  </a>  <a href="https://github.com/kreuzberg-dev/tree-sitter-language-pack/tree/main/crates/ts-pack-ffi">
    <img src="https://img.shields.io/badge/C-FFI-007ec6" alt="Ffi">
  </a>
  <!-- Project Info -->
  <a href="https://github.com/kreuzberg-dev/tree-sitter-language-pack/actions">
    <img src="https://img.shields.io/github/actions/workflow/status/kreuzberg-dev/tree-sitter-language-pack/ci-rust.yaml?branch=main&label=CI&color=007ec6" alt="CI">
  </a>
  <a href="https://github.com/kreuzberg-dev/tree-sitter-language-pack/blob/main/LICENSE">
    <img src="https://img.shields.io/badge/License-MIT-007ec6.svg" alt="License">
  </a>
  <a href="https://github.com/kreuzberg-dev/homebrew-tap">
    <img src="https://img.shields.io/badge/homebrew-ts--pack-007ec6?logo=homebrew" alt="Homebrew">
  </a>
  <a href="https://docs.tree-sitter-language-pack.kreuzberg.dev">
    <img src="https://img.shields.io/badge/docs-kreuzberg.dev-007ec6" alt="Docs">
  </a>
</div>

<div align="center">
  <img width="3384" height="573" alt="Banner" src="https://github.com/user-attachments/assets/478a83da-237b-446b-b3a8-e564c13e00a8" />
</div>

<div align="center">
  <a href="https://discord.gg/xt9WY3GnKR">
    <img height="22" src="https://img.shields.io/badge/Discord-Join%20our%20community-7289da?logo=discord&logoColor=white" alt="Discord">
  </a>
</div>

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

## Installation

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

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

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

## Quick Start

```javascript
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](https://docs.tree-sitter-language-pack.kreuzberg.dev).

## License

MIT -- see [LICENSE](https://github.com/kreuzberg-dev/tree-sitter-language-pack/blob/main/LICENSE) for details.

---

Part of [tree-sitter-language-pack](https://github.com/kreuzberg-dev/tree-sitter-language-pack) -- A comprehensive collection of tree-sitter language parsers with polyglot bindings.