tree-sitter-ktav 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marat K and the Ktav contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+# tree-sitter-ktav
+
+> A [tree-sitter](https://tree-sitter.github.io/) grammar for
+> [Ktav (כְּתָב)](https://github.com/ktav-lang/spec) — the Written
+> Configuration Format.
+
+**Languages:** **English** · [Русский](README.ru.md) · [简体中文](README.zh.md)
+
+[![CI](https://github.com/ktav-lang/tree-sitter-ktav/actions/workflows/ci.yml/badge.svg)](https://github.com/ktav-lang/tree-sitter-ktav/actions/workflows/ci.yml)
+[![crates.io](https://img.shields.io/crates/v/tree-sitter-ktav.svg)](https://crates.io/crates/tree-sitter-ktav)
+[![npm](https://img.shields.io/npm/v/tree-sitter-ktav.svg)](https://www.npmjs.com/package/tree-sitter-ktav)
+
+---
+
+## What is Ktav?
+
+Ktav (Hebrew **כְּתָב**, "writing") is a plain-text configuration
+format. JSON-shape (scalars, arrays, objects, `null`, booleans), but
+without quotes around strings, without commas, and with dotted keys
+(`server.port: 8080`) for nesting. The full specification — the same
+one all official Ktav implementations target — lives in the
+[`ktav-lang/spec`](https://github.com/ktav-lang/spec) repository.
+
+## What is tree-sitter?
+
+[Tree-sitter](https://tree-sitter.github.io/tree-sitter/) is an
+incremental parser generator. Editors (Neovim, Helix, Emacs, VS Code,
+Zed, …) use it for syntax highlighting, code folding, structural
+selection, and other features that need a real parse tree rather than
+a regex-based tokenizer. Each language ships its own grammar package;
+this crate / npm package is the one for Ktav.
+
+## Installation
+
+### Rust (`tree-sitter` crate)
+
+```toml
+[dependencies]
+tree-sitter         = "0.25"
+tree-sitter-ktav    = "0.1"
+```
+
+```rust
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let mut parser = tree_sitter::Parser::new();
+    parser.set_language(&tree_sitter_ktav::LANGUAGE.into())?;
+
+    let source = "name: Russia\nport:i 8080\n";
+    let tree = parser.parse(source, None).unwrap();
+    println!("{}", tree.root_node().to_sexp());
+    Ok(())
+}
+```
+
+### Node.js (`tree-sitter` package)
+
+```bash
+npm install tree-sitter tree-sitter-ktav
+```
+
+```js
+const Parser = require("tree-sitter");
+const Ktav   = require("tree-sitter-ktav");
+
+const parser = new Parser();
+parser.setLanguage(Ktav);
+
+const tree = parser.parse("name: Russia\nport:i 8080\n");
+console.log(tree.rootNode.toString());
+```
+
+## Editor integration
+
+### Neovim (with [`nvim-treesitter`](https://github.com/nvim-treesitter/nvim-treesitter))
+
+Until the grammar is upstreamed, register it manually in your config:
+
+```lua
+require("nvim-treesitter.parsers").get_parser_configs().ktav = {
+  install_info = {
+    url = "https://github.com/ktav-lang/tree-sitter-ktav",
+    files = { "src/parser.c" },
+    branch = "main",
+  },
+  filetype = "ktav",
+}
+
+vim.filetype.add({ extension = { ktav = "ktav" } })
+```
+
+Then `:TSInstall ktav`. Drop `queries/highlights.scm`,
+`queries/locals.scm`, and `queries/injections.scm` into your
+`~/.config/nvim/queries/ktav/` directory (or let nvim-treesitter pick
+them up from the parser repo).
+
+### Helix
+
+Add to `~/.config/helix/languages.toml`:
+
+```toml
+[[language]]
+name      = "ktav"
+scope     = "source.ktav"
+file-types = ["ktav"]
+roots     = []
+comment-token = "#"
+indent    = { tab-width = 4, unit = "    " }
+
+[[grammar]]
+name   = "ktav"
+source = { git = "https://github.com/ktav-lang/tree-sitter-ktav", rev = "main" }
+```
+
+Then `hx --grammar fetch && hx --grammar build`.
+
+### Other editors
+
+The grammar exports the standard tree-sitter node-type metadata
+(`src/node-types.json`) and queries (`queries/*.scm`), so any editor
+with tree-sitter support can consume it once the parser is built.
+
+## Node types
+
+The grammar produces the following named nodes:
+
+| Node                       | What it captures                                |
+|----------------------------|-------------------------------------------------|
+| `source_file`              | the whole document                              |
+| `comment`                  | a `#`-line comment                              |
+| `blank_line`               | an empty line                                   |
+| `object_pair`              | `key SEP value` line                            |
+| `key` / `dotted_key`       | the key portion (with optional `.` separators)  |
+| `sep_string` / `sep_raw` / `sep_int` / `sep_float` | the four separators       |
+| `keyword` / `kw_null` / `kw_true` / `kw_false`     | keywords                  |
+| `scalar`                   | the catch-all single-line value body            |
+| `compound_object`          | `{` … `}` block                                 |
+| `compound_array`           | `[` … `]` block                                 |
+| `array_item`               | a single item in an array                       |
+| `multiline_stripped`       | `(` … `)` block                                 |
+| `multiline_verbatim`       | `((` … `))` block                               |
+| `multiline_content_line`   | a single line inside a multi-line string        |
+| `empty_object` / `empty_array` / `empty_paren` / `empty_double_paren` | inline empty forms |
+| `empty_value`              | separator immediately followed by EOL           |
+
+`object_pair` exposes `key`, `separator`, and `value` as fields;
+`array_item` exposes `marker` (optional) and `value`.
+
+## Building from source
+
+```bash
+git clone https://github.com/ktav-lang/tree-sitter-ktav.git
+cd tree-sitter-ktav
+npm install
+npx tree-sitter generate     # writes src/parser.c
+npx tree-sitter test         # runs the corpus
+```
+
+The generated `src/parser.c`, `src/grammar.json`, `src/node-types.json`,
+and `src/tree_sitter/*` are checked into git per tree-sitter convention,
+so consumers do not need the CLI to build.
+
+## Status
+
+`0.1.0` — implements [Ktav 0.1.0](https://github.com/ktav-lang/spec/blob/main/versions/0.1/spec.md).
+The grammar accepts every valid Ktav 0.1.0 document (verified against
+all `tests/valid/*.ktav` fixtures from the spec repo). It is a
+syntactic accepter, not a strict spec validator — see
+[`CHANGELOG.md`](CHANGELOG.md) "Known limitations" for the small
+number of pathological cases the grammar accepts that the spec
+rejects (mostly missing-whitespace-after-marker — § 6.10).
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Other Ktav repositories
+
+- [`spec`](https://github.com/ktav-lang/spec) — specification + conformance suite
+- [`rust`](https://github.com/ktav-lang/rust) — Rust (`cargo add ktav`)
+- [`csharp`](https://github.com/ktav-lang/csharp) — C# / .NET (`dotnet add package Ktav`)
+- [`golang`](https://github.com/ktav-lang/golang) — Go
+- [`java`](https://github.com/ktav-lang/java) — Java / JVM (Maven Central)
+- [`js`](https://github.com/ktav-lang/js) — JS / TS (`npm install @ktav-lang/ktav`)
+- [`php`](https://github.com/ktav-lang/php) — PHP (`composer require ktav-lang/ktav`)
+- [`python`](https://github.com/ktav-lang/python) — Python (`pip install ktav`)

package/README.ru.md

@@ -0,0 +1,185 @@
+# tree-sitter-ktav
+
+> Грамматика [tree-sitter](https://tree-sitter.github.io/) для
+> [Ktav (כְּתָב)](https://github.com/ktav-lang/spec) — Written
+> Configuration Format.
+
+**Языки:** [English](README.md) · **Русский** · [简体中文](README.zh.md)
+
+[![CI](https://github.com/ktav-lang/tree-sitter-ktav/actions/workflows/ci.yml/badge.svg)](https://github.com/ktav-lang/tree-sitter-ktav/actions/workflows/ci.yml)
+[![crates.io](https://img.shields.io/crates/v/tree-sitter-ktav.svg)](https://crates.io/crates/tree-sitter-ktav)
+[![npm](https://img.shields.io/npm/v/tree-sitter-ktav.svg)](https://www.npmjs.com/package/tree-sitter-ktav)
+
+---
+
+## Что такое Ktav?
+
+Ktav (иврит **כְּתָב**, «писание») — текстовый формат конфигурации
+JSON-формы (скаляры, массивы, объекты, `null`, булево), но без кавычек
+вокруг строк, без запятых, с точечными ключами (`server.port: 8080`)
+для вложенности. Полная спецификация (та же, на которую ориентируются
+все официальные реализации Ktav) лежит в
+[`ktav-lang/spec`](https://github.com/ktav-lang/spec).
+
+## Что такое tree-sitter?
+
+[Tree-sitter](https://tree-sitter.github.io/tree-sitter/) — это
+инкрементальный генератор парсеров. Редакторы (Neovim, Helix, Emacs,
+VS Code, Zed, …) используют его для подсветки синтаксиса, фолдинга,
+структурного выделения и других возможностей, требующих настоящего
+дерева разбора, а не regex-токенизатора. Под каждый язык — своя
+грамматика; этот пакет — грамматика для Ktav.
+
+## Установка
+
+### Rust
+
+```toml
+[dependencies]
+tree-sitter      = "0.25"
+tree-sitter-ktav = "0.1"
+```
+
+```rust
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let mut parser = tree_sitter::Parser::new();
+    parser.set_language(&tree_sitter_ktav::LANGUAGE.into())?;
+
+    let source = "name: Russia\nport:i 8080\n";
+    let tree = parser.parse(source, None).unwrap();
+    println!("{}", tree.root_node().to_sexp());
+    Ok(())
+}
+```
+
+### Node.js
+
+```bash
+npm install tree-sitter tree-sitter-ktav
+```
+
+```js
+const Parser = require("tree-sitter");
+const Ktav   = require("tree-sitter-ktav");
+
+const parser = new Parser();
+parser.setLanguage(Ktav);
+
+const tree = parser.parse("name: Russia\nport:i 8080\n");
+console.log(tree.rootNode.toString());
+```
+
+## Интеграция с редакторами
+
+### Neovim (через [`nvim-treesitter`](https://github.com/nvim-treesitter/nvim-treesitter))
+
+Пока грамматика не зарегистрирована в апстриме, добавьте вручную:
+
+```lua
+require("nvim-treesitter.parsers").get_parser_configs().ktav = {
+  install_info = {
+    url = "https://github.com/ktav-lang/tree-sitter-ktav",
+    files = { "src/parser.c" },
+    branch = "main",
+  },
+  filetype = "ktav",
+}
+
+vim.filetype.add({ extension = { ktav = "ktav" } })
+```
+
+Затем `:TSInstall ktav`. Положите `queries/highlights.scm`,
+`queries/locals.scm` и `queries/injections.scm` в
+`~/.config/nvim/queries/ktav/` (либо позвольте `nvim-treesitter`
+подобрать их из репозитория грамматики).
+
+### Helix
+
+В `~/.config/helix/languages.toml`:
+
+```toml
+[[language]]
+name      = "ktav"
+scope     = "source.ktav"
+file-types = ["ktav"]
+roots     = []
+comment-token = "#"
+indent    = { tab-width = 4, unit = "    " }
+
+[[grammar]]
+name   = "ktav"
+source = { git = "https://github.com/ktav-lang/tree-sitter-ktav", rev = "main" }
+```
+
+Затем `hx --grammar fetch && hx --grammar build`.
+
+### Другие редакторы
+
+Грамматика экспортирует стандартные tree-sitter-метаданные
+(`src/node-types.json`) и запросы (`queries/*.scm`), так что любой
+редактор с поддержкой tree-sitter сможет с ней работать.
+
+## Узлы AST
+
+Грамматика генерирует следующие именованные узлы:
+
+| Узел                       | Что захватывает                                  |
+|----------------------------|--------------------------------------------------|
+| `source_file`              | весь документ                                    |
+| `comment`                  | строковый комментарий `#`                        |
+| `blank_line`               | пустую строку                                    |
+| `object_pair`              | строку `ключ SEP значение`                       |
+| `key` / `dotted_key`       | ключ (с возможным `.`-разбиением)                |
+| `sep_string` / `sep_raw` / `sep_int` / `sep_float` | четыре разделителя           |
+| `keyword` / `kw_null` / `kw_true` / `kw_false`     | ключевые слова               |
+| `scalar`                   | универсальное однострочное значение              |
+| `compound_object`          | блок `{` … `}`                                   |
+| `compound_array`           | блок `[` … `]`                                   |
+| `array_item`               | элемент массива                                  |
+| `multiline_stripped`       | блок `(` … `)`                                   |
+| `multiline_verbatim`       | блок `((` … `))`                                 |
+| `multiline_content_line`   | строка внутри многострочного значения            |
+| `empty_object` / `empty_array` / `empty_paren` / `empty_double_paren` | пустые inline-формы |
+| `empty_value`              | разделитель сразу за концом строки               |
+
+`object_pair` экспонирует поля `key`, `separator`, `value`;
+`array_item` — `marker` (опционально) и `value`.
+
+## Сборка из исходников
+
+```bash
+git clone https://github.com/ktav-lang/tree-sitter-ktav.git
+cd tree-sitter-ktav
+npm install
+npx tree-sitter generate     # генерирует src/parser.c
+npx tree-sitter test         # запускает корпус
+```
+
+Файлы `src/parser.c`, `src/grammar.json`, `src/node-types.json` и
+`src/tree_sitter/*` коммитятся в git по соглашению tree-sitter, так
+что потребителям грамматики не нужен CLI для сборки.
+
+## Статус
+
+`0.1.0` — реализует [Ktav 0.1.0](https://github.com/ktav-lang/spec/blob/main/versions/0.1/spec.md).
+Грамматика принимает любой валидный документ Ktav 0.1.0 (проверено на
+всех фикстурах `tests/valid/*.ktav` из spec-репозитория). Это
+синтаксический акцептор, а не строгий валидатор — небольшое число
+патологических случаев, которые грамматика принимает, а спецификация
+запрещает (в основном § 6.10, отсутствие пробела после маркера),
+перечислены в [`CHANGELOG.md`](CHANGELOG.md).
+
+## Лицензия
+
+MIT — см. [LICENSE](LICENSE).
+
+## Другие репозитории Ktav
+
+- [`spec`](https://github.com/ktav-lang/spec) — спецификация и conformance-сюита
+- [`rust`](https://github.com/ktav-lang/rust) — Rust (`cargo add ktav`)
+- [`csharp`](https://github.com/ktav-lang/csharp) — C# / .NET (`dotnet add package Ktav`)
+- [`golang`](https://github.com/ktav-lang/golang) — Go
+- [`java`](https://github.com/ktav-lang/java) — Java / JVM (Maven Central)
+- [`js`](https://github.com/ktav-lang/js) — JS / TS (`npm install @ktav-lang/ktav`)
+- [`php`](https://github.com/ktav-lang/php) — PHP (`composer require ktav-lang/ktav`)
+- [`python`](https://github.com/ktav-lang/python) — Python (`pip install ktav`)

package/README.zh.md

@@ -0,0 +1,179 @@
+# tree-sitter-ktav
+
+> 面向 [Ktav (כְּתָב)](https://github.com/ktav-lang/spec)（书面配置
+> 格式）的 [tree-sitter](https://tree-sitter.github.io/) 语法。
+
+**语言：** [English](README.md) · [Русский](README.ru.md) · **简体中文**
+
+[![CI](https://github.com/ktav-lang/tree-sitter-ktav/actions/workflows/ci.yml/badge.svg)](https://github.com/ktav-lang/tree-sitter-ktav/actions/workflows/ci.yml)
+[![crates.io](https://img.shields.io/crates/v/tree-sitter-ktav.svg)](https://crates.io/crates/tree-sitter-ktav)
+[![npm](https://img.shields.io/npm/v/tree-sitter-ktav.svg)](https://www.npmjs.com/package/tree-sitter-ktav)
+
+---
+
+## 什么是 Ktav？
+
+Ktav（希伯来语 **כְּתָב**，"书写"）是一种纯文本配置格式。形态与
+JSON 相同（标量、数组、对象、`null`、布尔值），但字符串无引号、无逗
+号，并使用点式键（`server.port: 8080`）表示嵌套。完整规范——所有官
+方 Ktav 实现共同遵循的——在
+[`ktav-lang/spec`](https://github.com/ktav-lang/spec) 仓库中。
+
+## 什么是 tree-sitter？
+
+[Tree-sitter](https://tree-sitter.github.io/tree-sitter/) 是一种增
+量解析器生成器。编辑器（Neovim、Helix、Emacs、VS Code、Zed 等）使用
+它实现语法高亮、代码折叠、结构化选择以及其他需要真正解析树而非正则
+词法器的功能。每种语言都有自己的语法包；本包就是 Ktav 的语法。
+
+## 安装
+
+### Rust
+
+```toml
+[dependencies]
+tree-sitter      = "0.25"
+tree-sitter-ktav = "0.1"
+```
+
+```rust
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let mut parser = tree_sitter::Parser::new();
+    parser.set_language(&tree_sitter_ktav::LANGUAGE.into())?;
+
+    let source = "name: Russia\nport:i 8080\n";
+    let tree = parser.parse(source, None).unwrap();
+    println!("{}", tree.root_node().to_sexp());
+    Ok(())
+}
+```
+
+### Node.js
+
+```bash
+npm install tree-sitter tree-sitter-ktav
+```
+
+```js
+const Parser = require("tree-sitter");
+const Ktav   = require("tree-sitter-ktav");
+
+const parser = new Parser();
+parser.setLanguage(Ktav);
+
+const tree = parser.parse("name: Russia\nport:i 8080\n");
+console.log(tree.rootNode.toString());
+```
+
+## 编辑器集成
+
+### Neovim（搭配 [`nvim-treesitter`](https://github.com/nvim-treesitter/nvim-treesitter)）
+
+在语法尚未上游之前，请在配置中手动注册：
+
+```lua
+require("nvim-treesitter.parsers").get_parser_configs().ktav = {
+  install_info = {
+    url = "https://github.com/ktav-lang/tree-sitter-ktav",
+    files = { "src/parser.c" },
+    branch = "main",
+  },
+  filetype = "ktav",
+}
+
+vim.filetype.add({ extension = { ktav = "ktav" } })
+```
+
+随后执行 `:TSInstall ktav`。把 `queries/highlights.scm`、
+`queries/locals.scm` 与 `queries/injections.scm` 放入
+`~/.config/nvim/queries/ktav/`（或让 `nvim-treesitter` 自动从仓库
+拉取）。
+
+### Helix
+
+在 `~/.config/helix/languages.toml` 中：
+
+```toml
+[[language]]
+name      = "ktav"
+scope     = "source.ktav"
+file-types = ["ktav"]
+roots     = []
+comment-token = "#"
+indent    = { tab-width = 4, unit = "    " }
+
+[[grammar]]
+name   = "ktav"
+source = { git = "https://github.com/ktav-lang/tree-sitter-ktav", rev = "main" }
+```
+
+随后执行 `hx --grammar fetch && hx --grammar build`。
+
+### 其他编辑器
+
+语法导出标准的 tree-sitter 节点类型元数据
+（`src/node-types.json`）和查询文件（`queries/*.scm`），任何支持
+tree-sitter 的编辑器都可以在解析器构建后直接使用。
+
+## 节点类型
+
+语法生成以下命名节点：
+
+| 节点                      | 捕获内容                                      |
+|---------------------------|-----------------------------------------------|
+| `source_file`             | 整个文档                                      |
+| `comment`                 | `#` 行注释                                    |
+| `blank_line`              | 空行                                          |
+| `object_pair`             | `key SEP value` 行                            |
+| `key` / `dotted_key`      | 键部分（可包含 `.` 分隔符）                   |
+| `sep_string` / `sep_raw` / `sep_int` / `sep_float` | 四种分隔符           |
+| `keyword` / `kw_null` / `kw_true` / `kw_false`     | 关键字               |
+| `scalar`                  | 通用单行值正文                                |
+| `compound_object`         | `{` … `}` 块                                  |
+| `compound_array`          | `[` … `]` 块                                  |
+| `array_item`              | 数组中的单个元素                              |
+| `multiline_stripped`      | `(` … `)` 块                                  |
+| `multiline_verbatim`      | `((` … `))` 块                                |
+| `multiline_content_line`  | 多行字符串内的单行                            |
+| `empty_object` / `empty_array` / `empty_paren` / `empty_double_paren` | 内联空形式 |
+| `empty_value`             | 分隔符紧跟行尾                                |
+
+`object_pair` 暴露字段 `key`、`separator`、`value`；`array_item`
+暴露 `marker`（可选）和 `value`。
+
+## 从源码构建
+
+```bash
+git clone https://github.com/ktav-lang/tree-sitter-ktav.git
+cd tree-sitter-ktav
+npm install
+npx tree-sitter generate     # 生成 src/parser.c
+npx tree-sitter test         # 运行语料库
+```
+
+`src/parser.c`、`src/grammar.json`、`src/node-types.json` 与
+`src/tree_sitter/*` 按 tree-sitter 惯例已纳入 git，下游消费者无需
+CLI 即可构建。
+
+## 状态
+
+`0.1.0` — 实现 [Ktav 0.1.0](https://github.com/ktav-lang/spec/blob/main/versions/0.1/spec.md)。
+语法接受所有合法的 Ktav 0.1.0 文档（对 spec 仓库下
+`tests/valid/*.ktav` 全部用例验证通过）。它是一个语法接受器，而非
+严格的规范校验器——少数语法接受但规范拒绝的边界情况（主要是 § 6.10
+"标记后必须有空格"）见 [`CHANGELOG.md`](CHANGELOG.md)。
+
+## 许可证
+
+MIT — 见 [LICENSE](LICENSE)。
+
+## 其他 Ktav 仓库
+
+- [`spec`](https://github.com/ktav-lang/spec) — 规范与一致性测试套件
+- [`rust`](https://github.com/ktav-lang/rust) — Rust（`cargo add ktav`）
+- [`csharp`](https://github.com/ktav-lang/csharp) — C# / .NET（`dotnet add package Ktav`）
+- [`golang`](https://github.com/ktav-lang/golang) — Go
+- [`java`](https://github.com/ktav-lang/java) — Java / JVM（Maven Central）
+- [`js`](https://github.com/ktav-lang/js) — JS / TS（`npm install @ktav-lang/ktav`）
+- [`php`](https://github.com/ktav-lang/php) — PHP（`composer require ktav-lang/ktav`）
+- [`python`](https://github.com/ktav-lang/python) — Python（`pip install ktav`）

package/binding.gyp

@@ -0,0 +1,28 @@
+{
+  "targets": [
+    {
+      "target_name": "tree_sitter_ktav_binding",
+      "dependencies": [
+        "<!(node -p \"require('node-addon-api').targets\"):node_addon_api_except"
+      ],
+      "include_dirs": [
+        "src"
+      ],
+      "sources": [
+        "bindings/node/binding.cc",
+        "src/parser.c",
+        "src/scanner.c"
+      ],
+      "cflags_c": [
+        "-std=c11"
+      ],
+      "conditions": [
+        ["OS!='win'", {
+          "cflags_c": [
+            "-Wno-unused-but-set-variable"
+          ]
+        }]
+      ]
+    }
+  ]
+}

package/bindings/node/binding.cc

@@ -0,0 +1,20 @@
+#include <napi.h>
+
+typedef struct TSLanguage TSLanguage;
+
+extern "C" TSLanguage *tree_sitter_ktav();
+
+// "tree-sitter", "language" hashed with BLAKE2
+const napi_type_tag LANGUAGE_TYPE_TAG = {
+    0x8AF2E5212AD58ABF, 0xD5006CAD83ABBA16
+};
+
+Napi::Object Init(Napi::Env env, Napi::Object exports) {
+    exports["name"] = Napi::String::New(env, "ktav");
+    auto language = Napi::External<TSLanguage>::New(env, tree_sitter_ktav());
+    language.TypeTag(&LANGUAGE_TYPE_TAG);
+    exports["language"] = language;
+    return exports;
+}
+
+NODE_API_MODULE(tree_sitter_ktav_binding, Init)

package/bindings/node/index.d.ts

@@ -0,0 +1,28 @@
+type BaseNode = {
+  type: string;
+  named: boolean;
+};
+
+type ChildNode = {
+  multiple: boolean;
+  required: boolean;
+  types: BaseNode[];
+};
+
+type NodeInfo =
+  | (BaseNode & {
+      subtypes: BaseNode[];
+    })
+  | (BaseNode & {
+      fields: { [name: string]: ChildNode };
+      children: ChildNode[];
+    });
+
+type Language = {
+  name: string;
+  language: unknown;
+  nodeTypeInfo: NodeInfo[];
+};
+
+declare const language: Language;
+export = language;

package/bindings/node/index.js

@@ -0,0 +1,7 @@
+const root = require("path").join(__dirname, "..", "..");
+
+module.exports = require("node-gyp-build")(root);
+
+try {
+  module.exports.nodeTypeInfo = require("../../src/node-types.json");
+} catch (_) {}