@apple/tree-sitter-pkl 0.16.0 → 0.18.0

package/.editorconfig

@@ -0,0 +1,46 @@
+root = true
+
+[*]
+charset = utf-8
+
+[*.{json,toml,yml,gyp}]
+indent_style = space
+indent_size = 2
+
+[*.js]
+indent_style = space
+indent_size = 2
+
+[*.scm]
+indent_style = space
+indent_size = 2
+
+[*.{c,cc,h}]
+indent_style = space
+indent_size = 4
+
+[*.rs]
+indent_style = space
+indent_size = 4
+
+[*.{py,pyi}]
+indent_style = space
+indent_size = 4
+
+[*.swift]
+indent_style = space
+indent_size = 4
+
+[*.go]
+indent_style = tab
+indent_size = 8
+
+[Makefile]
+indent_style = tab
+indent_size = 8
+
+[parser.c]
+indent_size = 2
+
+[{alloc,array,parser}.h]
+indent_size = 2

package/.gitattributes

@@ -0,0 +1,50 @@
+* text=auto eol=lf
+
+# Generated source files
+src/*.json linguist-generated
+src/parser.c linguist-generated
+src/tree_sitter/* linguist-generated
+
+# C bindings
+bindings/c/** linguist-generated
+CMakeLists.txt linguist-generated
+Makefile linguist-generated
+
+# Rust bindings
+bindings/rust/* linguist-generated
+Cargo.toml linguist-generated
+Cargo.lock linguist-generated
+
+# Node.js bindings
+bindings/node/* linguist-generated
+binding.gyp linguist-generated
+package.json linguist-generated
+package-lock.json linguist-generated
+
+# Python bindings
+bindings/python/** linguist-generated
+setup.py linguist-generated
+pyproject.toml linguist-generated
+
+# Go bindings
+bindings/go/* linguist-generated
+go.mod linguist-generated
+go.sum linguist-generated
+
+# Swift bindings
+bindings/swift/** linguist-generated
+Package.swift linguist-generated
+Package.resolved linguist-generated
+
+# Zig bindings
+build.zig linguist-generated
+build.zig.zon linguist-generated
+
+# Linux start script should use lf
+internal/gradlew        text eol=lf
+
+# These are Windows script files and should use crlf
+*.bat           text eol=crlf
+
+# Binary files should be left untouched
+*.jar           binary

package/CHANGELOG.adoc

@@ -0,0 +1,88 @@
+= Changelog
+
+[[release-0.18.0]]
+== 0.18.0 (2024-03-27)
+
+This is a large change.
+It changes the parse tree to match other Pkl parsers, and also fixes all known parser issues.
+
+=== Additions
+
+* Add support for Go bindings (https://github.com/apple/tree-sitter-pkl/pull/33[#33])
+* Add support for Python bindings (https://github.com/apple/tree-sitter-pkl/pull/33[#33])
+
+=== Breaking Changes
+
+* Minimum tree-sitter version bumped to 0.25 (https://github.com/apple/tree-sitter-pkl/pull/33[#33])
+* Restructure parse tree to match other grammars (https://github.com/apple/tree-sitter-pkl/pull/32[#32], https://github.com/apple/tree-sitter-pkl/pull/34[#34], https://github.com/apple/tree-sitter-pkl/pull/36[#36])
+  ** Remove `variableExpr`, `propertyCallExpr`, `methodCallExpr`, `objectLiteral`, `variableObjectLiteral`
+  ** Introduce `unqualifiedAccessExpr`, `qualifiedAccessExpr`
+  ** Introduce `amendExpr`
+  ** Remove `_expr2` workaround
+  ** Split `binaryExpr` into separate parts
+  ** Merge `readExpr`/`readOrNullExpr`/`readGlobExpr` into `readExpr`
+  ** Merge `importExpr`/`importOrNullExpr` into `importExpr`
+  ** Rename `isExpr` to `typeTestExpr`
+  ** Rename `asExpr` to `typeCastExpr`
+  ** Rename `objectPredicate` to `memberPredicate`
+  ** Add blank identifiers (all parameters can optionally use `_` as an identifier, can't use anywhere else)
+  ** Rename `unionDefaultType` to `defaultUnionType`
+  ** Suffix all expressions with `Expr`
+    *** `nullLiteral` -> `nullLiteralExpr`
+    *** `trueLiteral` -> `trueLiteralExpr`
+    *** `falseLiteral` -> `falseLiteralExpr`
+    *** `intLiteral` -> `intLiteralExpr`
+    *** `floatLiteral` -> `floatLiteralExpr`
+    *** `slStringLiteral` -> `slStringLiteralExpr`
+    *** `mlStringLiteral` -> `mlStringLiteralExpr`
+    *** `functionLiteral` -> `functionLiteralExpr`
+  ** Rename `interpolationExpr` to `stringInterpolation`
+  ** In `readExpr` and `importExpr`, rename field "keyword" to "variant"
+
+=== Fixes
+
+* Fix parser issues (https://github.com/apple/tree-sitter-pkl/pull/32[#32], https://github.com/apple/tree-sitter-pkl/pull/34[#34])
+** Fix parsing of unary minus as an object element
+** Fix precedence issues (e.g. make `.` stronger than `+`)
+** Fix scanner producing incorrect tokens in some cases
+** Fix: disallow newline in type constraints between type and first parenthesis
+** Require parentheses around `trace`, `throw`
+
+[[release-0.17.0]]
+== 0.17.0 (2024-10-10)
+
+=== Breaking changes
+
+* Give type nodes explicit names (e.g. `"unknown"` -> `unknownTypeNode`)
+* Remove support for legacy syntax in for and when generators
+
+=== Additions
+
+* Add support for Swift Package Manager
+* Add support for C bindings
+* Add doc comments to the parse tree
+* Add `slStringLiteralPart` and `mlStringLiteralPart` to the parse tree
+* Add field names to various nodes
+* Add support for shebang comments
+
+=== Fixes
+
+* Fix parsing of parenthesized expressions in object 
+elements
+* Fix parsing of union types with default markers
+* Add missing `else` in when generators
+* Add missing module type
+* Fix parsing of strings that start with two slashes
+
+=== Contributors ❤️
+
+Thanks to all the contributors for this release!
+
+* https://github.com/ObserverOfTime[@ObserverOfTime]
+* https://github.com/jayadamsmorgan[jayadamsmorgan]
+* https://github.com/thomaspurchas[@thomaspurchas]
+
+[[release-0.16.0]]
+== 0.16.0 (2024-02-02)
+
+Initial release

package/CMakeLists.txt

@@ -0,0 +1,66 @@
+cmake_minimum_required(VERSION 3.13)
+
+project(tree-sitter-pkl
+        VERSION "0.18.0"
+        DESCRIPTION "Parser for Pkl programming language"
+        HOMEPAGE_URL "https://github.com/apple/tree-sitter-pkl"
+        LANGUAGES C)
+
+option(BUILD_SHARED_LIBS "Build using shared libraries" ON)
+option(TREE_SITTER_REUSE_ALLOCATOR "Reuse the library allocator" OFF)
+
+set(TREE_SITTER_ABI_VERSION 15 CACHE STRING "Tree-sitter ABI version")
+if(NOT ${TREE_SITTER_ABI_VERSION} MATCHES "^[0-9]+$")
+    unset(TREE_SITTER_ABI_VERSION CACHE)
+    message(FATAL_ERROR "TREE_SITTER_ABI_VERSION must be an integer")
+endif()
+
+find_program(TREE_SITTER_CLI tree-sitter DOC "Tree-sitter CLI")
+
+add_custom_command(OUTPUT "${CMAKE_CURRENT_SOURCE_DIR}/src/parser.c"
+                   DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/src/grammar.json"
+                   COMMAND "${TREE_SITTER_CLI}" generate src/grammar.json
+                            --abi=${TREE_SITTER_ABI_VERSION}
+                   WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
+                   COMMENT "Generating parser.c")
+
+add_library(tree-sitter-pkl src/parser.c)
+if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/src/scanner.c)
+  target_sources(tree-sitter-pkl PRIVATE src/scanner.c)
+endif()
+target_include_directories(tree-sitter-pkl
+                           PRIVATE src
+                           INTERFACE $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/bindings/c>
+                                     $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>)
+
+target_compile_definitions(tree-sitter-pkl PRIVATE
+                           $<$<BOOL:${TREE_SITTER_REUSE_ALLOCATOR}>:TREE_SITTER_REUSE_ALLOCATOR>
+                           $<$<CONFIG:Debug>:TREE_SITTER_DEBUG>)
+
+set_target_properties(tree-sitter-pkl
+                      PROPERTIES
+                      C_STANDARD 11
+                      POSITION_INDEPENDENT_CODE ON
+                      SOVERSION "${TREE_SITTER_ABI_VERSION}.${PROJECT_VERSION_MAJOR}"
+                      DEFINE_SYMBOL "")
+
+configure_file(bindings/c/tree-sitter-pkl.pc.in
+               "${CMAKE_CURRENT_BINARY_DIR}/tree-sitter-pkl.pc" @ONLY)
+
+include(GNUInstallDirs)
+
+install(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/bindings/c/tree_sitter"
+        DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
+        FILES_MATCHING PATTERN "*.h")
+install(FILES "${CMAKE_CURRENT_BINARY_DIR}/tree-sitter-pkl.pc"
+        DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/pkgconfig")
+install(TARGETS tree-sitter-pkl
+        LIBRARY DESTINATION "${CMAKE_INSTALL_LIBDIR}")
+
+file(GLOB QUERIES queries/*.scm)
+install(FILES ${QUERIES}
+        DESTINATION "${CMAKE_INSTALL_DATADIR}/tree-sitter/queries/pkl")
+
+add_custom_target(ts-test "${TREE_SITTER_CLI}" test
+                  WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
+                  COMMENT "tree-sitter test")

package/Cargo.lock

@@ -1,42 +1,36 @@
 # This file is automatically @generated by Cargo.
 # It is not intended for manual editing.
-version = 3
+version = 4
 
 [[package]]
 name = "aho-corasick"
-version = "1.1.1"
+version = "1.1.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ea5d730647d4fadd988536d06fecce94b7b4f2a7efdae548f1cf4b63205518ab"
+checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916"
 dependencies = [
  "memchr",
 ]
 
 [[package]]
 name = "cc"
-version = "1.0.83"
+version = "1.2.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f1174fb0b6ec23863f8b971027804a42614e347eafb0a95bf0b12cdae21fc4d0"
+checksum = "0c3d1b2e905a3a7b00a6141adb0e4c0bb941d11caf55349d863942a1cc44e3c9"
 dependencies = [
- "libc",
+ "shlex",
 ]
 
-[[package]]
-name = "libc"
-version = "0.2.148"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9cdc71e17332e86d2e1d38c1f99edcb6288ee11b815fb1a4b049eaa2114d369b"
-
 [[package]]
 name = "memchr"
-version = "2.6.3"
+version = "2.7.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f232d6ef707e1956a43342693d2a31e72989554d58299d7a88738cc95b0d35c"
+checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
 
 [[package]]
 name = "regex"
-version = "1.9.5"
+version = "1.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "697061221ea1b4a94a624f67d0ae2bfe4e22b8a17b6a192afb11046542cc8c47"
+checksum = "b544ef1b4eac5dc2db33ea63606ae9ffcfac26c1416a2806ae0bf5f56b201191"
 dependencies = [
  "aho-corasick",
  "memchr",
@@ -46,9 +40,9 @@ dependencies = [
 
 [[package]]
 name = "regex-automata"
-version = "0.3.8"
+version = "0.4.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c2f401f4955220693b56f8ec66ee9c78abffd8d1c4f23dc41a23839eb88f0795"
+checksum = "809e8dc61f6de73b46c85f4c96486310fe304c434cfa43669d7b40f711150908"
 dependencies = [
  "aho-corasick",
  "memchr",
@@ -57,9 +51,15 @@ dependencies = [
 
 [[package]]
 name = "regex-syntax"
-version = "0.7.5"
+version = "0.8.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2b15c43186be67a4fd63bee50d0303afffcef381492ebe2c5d87f324e1b8815c"
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dbb5fb1acd8a1a18b3dd5be62d25485eb770e05afb408a9627d14d451bae12da"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
 
 [[package]]
 name = "tree-sitter"
@@ -73,7 +73,7 @@ dependencies = [
 
 [[package]]
 name = "tree-sitter-pkl"
-version = "0.16.0"
+version = "0.18.0"
 dependencies = [
  "cc",
  "tree-sitter",

package/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "tree-sitter-pkl"
 description = "Pkl grammar for the tree-sitter parsing library"
-version = "0.16.0"
+version = "0.18.0"
 keywords = ["incremental", "parsing", "pkl"]
 categories = ["parsing", "text-editors"]
 repository = "https://github.com/apple/tree-sitter-pkl"

package/Makefile

@@ -0,0 +1,97 @@
+ifeq ($(OS),Windows_NT)
+$(error Windows is not supported)
+endif
+
+LANGUAGE_NAME := tree-sitter-pkl
+HOMEPAGE_URL := https://github.com/apple/tree-sitter-pkl
+VERSION := 0.18.0
+
+# repository
+SRC_DIR := src
+
+TS ?= tree-sitter
+
+# install directory layout
+PREFIX ?= /usr/local
+DATADIR ?= $(PREFIX)/share
+INCLUDEDIR ?= $(PREFIX)/include
+LIBDIR ?= $(PREFIX)/lib
+PCLIBDIR ?= $(LIBDIR)/pkgconfig
+
+# source/object files
+PARSER := $(SRC_DIR)/parser.c
+EXTRAS := $(filter-out $(PARSER),$(wildcard $(SRC_DIR)/*.c))
+OBJS := $(patsubst %.c,%.o,$(PARSER) $(EXTRAS))
+
+# flags
+ARFLAGS ?= rcs
+override CFLAGS += -I$(SRC_DIR) -std=c11 -fPIC
+
+# ABI versioning
+SONAME_MAJOR = $(shell sed -n 's/\#define LANGUAGE_VERSION //p' $(PARSER))
+SONAME_MINOR = $(word 1,$(subst ., ,$(VERSION)))
+
+# OS-specific bits
+ifeq ($(shell uname),Darwin)
+	SOEXT = dylib
+	SOEXTVER_MAJOR = $(SONAME_MAJOR).$(SOEXT)
+	SOEXTVER = $(SONAME_MAJOR).$(SONAME_MINOR).$(SOEXT)
+	LINKSHARED = -dynamiclib -Wl,-install_name,$(LIBDIR)/lib$(LANGUAGE_NAME).$(SOEXTVER),-rpath,@executable_path/../Frameworks
+else
+	SOEXT = so
+	SOEXTVER_MAJOR = $(SOEXT).$(SONAME_MAJOR)
+	SOEXTVER = $(SOEXT).$(SONAME_MAJOR).$(SONAME_MINOR)
+	LINKSHARED = -shared -Wl,-soname,lib$(LANGUAGE_NAME).$(SOEXTVER)
+endif
+ifneq ($(filter $(shell uname),FreeBSD NetBSD DragonFly),)
+	PCLIBDIR := $(PREFIX)/libdata/pkgconfig
+endif
+
+all: lib$(LANGUAGE_NAME).a lib$(LANGUAGE_NAME).$(SOEXT) $(LANGUAGE_NAME).pc
+
+lib$(LANGUAGE_NAME).a: $(OBJS)
+	$(AR) $(ARFLAGS) $@ $^
+
+lib$(LANGUAGE_NAME).$(SOEXT): $(OBJS)
+	$(CC) $(LDFLAGS) $(LINKSHARED) $^ $(LDLIBS) -o $@
+ifneq ($(STRIP),)
+	$(STRIP) $@
+endif
+
+$(LANGUAGE_NAME).pc: bindings/c/$(LANGUAGE_NAME).pc.in
+	sed -e 's|@PROJECT_VERSION@|$(VERSION)|' \
+		-e 's|@CMAKE_INSTALL_LIBDIR@|$(LIBDIR:$(PREFIX)/%=%)|' \
+		-e 's|@CMAKE_INSTALL_INCLUDEDIR@|$(INCLUDEDIR:$(PREFIX)/%=%)|' \
+		-e 's|@PROJECT_DESCRIPTION@|$(DESCRIPTION)|' \
+		-e 's|@PROJECT_HOMEPAGE_URL@|$(HOMEPAGE_URL)|' \
+		-e 's|@CMAKE_INSTALL_PREFIX@|$(PREFIX)|' $< > $@
+
+$(PARSER): $(SRC_DIR)/grammar.json
+	$(TS) generate $^
+
+install: all
+	install -d '$(DESTDIR)$(DATADIR)'/tree-sitter/queries/pkl '$(DESTDIR)$(INCLUDEDIR)'/tree_sitter '$(DESTDIR)$(PCLIBDIR)' '$(DESTDIR)$(LIBDIR)'
+	install -m644 bindings/c/tree_sitter/$(LANGUAGE_NAME).h '$(DESTDIR)$(INCLUDEDIR)'/tree_sitter/$(LANGUAGE_NAME).h
+	install -m644 $(LANGUAGE_NAME).pc '$(DESTDIR)$(PCLIBDIR)'/$(LANGUAGE_NAME).pc
+	install -m644 lib$(LANGUAGE_NAME).a '$(DESTDIR)$(LIBDIR)'/lib$(LANGUAGE_NAME).a
+	install -m755 lib$(LANGUAGE_NAME).$(SOEXT) '$(DESTDIR)$(LIBDIR)'/lib$(LANGUAGE_NAME).$(SOEXTVER)
+	ln -sf lib$(LANGUAGE_NAME).$(SOEXTVER) '$(DESTDIR)$(LIBDIR)'/lib$(LANGUAGE_NAME).$(SOEXTVER_MAJOR)
+	ln -sf lib$(LANGUAGE_NAME).$(SOEXTVER_MAJOR) '$(DESTDIR)$(LIBDIR)'/lib$(LANGUAGE_NAME).$(SOEXT)
+	install -m644 queries/*.scm '$(DESTDIR)$(DATADIR)'/tree-sitter/queries/pkl
+
+uninstall:
+	$(RM) '$(DESTDIR)$(LIBDIR)'/lib$(LANGUAGE_NAME).a \
+		'$(DESTDIR)$(LIBDIR)'/lib$(LANGUAGE_NAME).$(SOEXTVER) \
+		'$(DESTDIR)$(LIBDIR)'/lib$(LANGUAGE_NAME).$(SOEXTVER_MAJOR) \
+		'$(DESTDIR)$(LIBDIR)'/lib$(LANGUAGE_NAME).$(SOEXT) \
+		'$(DESTDIR)$(INCLUDEDIR)'/tree_sitter/$(LANGUAGE_NAME).h \
+		'$(DESTDIR)$(PCLIBDIR)'/$(LANGUAGE_NAME).pc
+	$(RM) -r '$(DESTDIR)$(DATADIR)'/tree-sitter/queries/pkl
+
+clean:
+	$(RM) $(OBJS) $(LANGUAGE_NAME).pc lib$(LANGUAGE_NAME).a lib$(LANGUAGE_NAME).$(SOEXT)
+
+test:
+	$(TS) test
+
+.PHONY: all install uninstall clean test

package/Package.swift

@@ -0,0 +1,24 @@
+// swift-tools-version:5.9
+import PackageDescription
+
+let package = Package(
+    name: "TreeSitterPkl",
+    products: [
+        .library(name: "TreeSitterPkl", targets: ["TreeSitterPkl"]),
+    ],
+    dependencies: [],
+    targets: [
+        .target(name: "TreeSitterPkl",
+                path: ".",
+                sources: [
+                    "src/parser.c",
+                    "src/scanner.c",
+                ],
+                resources: [
+                    .copy("queries"),
+                ],
+                publicHeadersPath: "bindings/swift",
+                cSettings: [.headerSearchPath("src")]
+        )
+    ]
+)

package/README.md

@@ -0,0 +1,40 @@
+A tree-sitter grammar for Pkl.
+
+    # install dependencies
+    $ npm install
+
+    # build parser
+    $ npm run build
+
+    # parse some code
+    $ ./node_modules/.bin/tree-sitter parse test.pkl
+
+# Tests
+
+Tree sitter comes with its own test framework. Files in `test/corpus/`
+describe one test each. All tests in `test/corpus/` are performed by the
+command
+
+    $ tree-sitter test
+
+If the grammar has changed, run `tree-sitter test --update` to update the corpus.
+
+## Snippet Tests
+
+The tests within [test/corpus/snippetTests](test/corpus/snippetTests) are generated from the core Pkl parser, and are not updated by `tree-sitter test --update`.
+
+These tests are generated by running `./gradlew createLanguageSnippetsCorpus`.
+This task grabs all language snippet tests, and renders them into a format that can be processed by tree-sitter.
+
+To fix any rendering issues, change [SExprRenderer](buildSrc/src/main/kotlin/SExprRenderer.kt).
+
+# Upgrading tree-sitter
+
+Upgrading tree-sitter involves upgrading the NPM package.
+
+1.  Run `npm update tree-sitter` to install the newer version of tree-sitter.
+2.  Commit to main, and push.
+
+# Resources
+-   [Tree-sitter docs](https://tree-sitter.github.io/tree-sitter/)
+-   [Guide to your first Tree-sitter grammar](https://gist.github.com/Aerijo/df27228d70c633e088b0591b8857eeef)

package/bindings/c/tree-sitter-pkl.h

@@ -0,0 +1,16 @@
+#ifndef TREE_SITTER_PKL_H
+#define TREE_SITTER_PKL_H
+
+typedef struct TSLanguage TSLanguage;
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+const TSLanguage *tree_sitter_pkl();
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // TREE_SITTER_PKL_H

package/bindings/c/tree-sitter-pkl.pc.in

@@ -0,0 +1,10 @@
+prefix=@CMAKE_INSTALL_PREFIX@
+libdir=${prefix}/@CMAKE_INSTALL_LIBDIR@
+includedir=${prefix}/@CMAKE_INSTALL_INCLUDEDIR@
+
+Name: tree-sitter-pkl
+Description: @PROJECT_DESCRIPTION@
+URL: @PROJECT_HOMEPAGE_URL@
+Version: @PROJECT_VERSION@
+Libs: -L${libdir} -ltree-sitter-pkl
+Cflags: -I${includedir}

package/bindings/c/tree_sitter/tree-sitter-pkl.h

@@ -0,0 +1,16 @@
+#ifndef TREE_SITTER_PKL_H_
+#define TREE_SITTER_PKL_H_
+
+typedef struct TSLanguage TSLanguage;
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+const TSLanguage *tree_sitter_pkl(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // TREE_SITTER_PKL_H_

package/bindings/go/binding.go

@@ -0,0 +1,15 @@
+package tree_sitter_pkl
+
+// #cgo CFLAGS: -std=c11 -fPIC
+// #include "../../src/parser.c"
+// #if __has_include("../../src/scanner.c")
+// #include "../../src/scanner.c"
+// #endif
+import "C"
+
+import "unsafe"
+
+// Get the tree-sitter Language for this grammar.
+func Language() unsafe.Pointer {
+	return unsafe.Pointer(C.tree_sitter_pkl())
+}

package/bindings/go/binding_test.go

@@ -0,0 +1,15 @@
+package tree_sitter_pkl_test
+
+import (
+	"testing"
+
+	tree_sitter "github.com/tree-sitter/go-tree-sitter"
+	tree_sitter_pkl "github.com/apple/tree-sitter-pkl/bindings/go"
+)
+
+func TestCanLoadGrammar(t *testing.T) {
+	language := tree_sitter.NewLanguage(tree_sitter_pkl.Language())
+	if language == nil {
+		t.Errorf("Error loading Pkl grammar")
+	}
+}

package/bindings/node/binding_test.js

@@ -0,0 +1,9 @@
+const assert = require("node:assert");
+const { test } = require("node:test");
+
+const Parser = require("tree-sitter");
+
+test("can load grammar", () => {
+  const parser = new Parser();
+  assert.doesNotThrow(() => parser.setLanguage(require(".")));
+});

package/bindings/node/index.d.ts

@@ -0,0 +1,27 @@
+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 = {
+  language: unknown;
+  nodeTypeInfo: NodeInfo[];
+};
+
+declare const language: Language;
+export = language;

package/bindings/python/tests/test_binding.py

@@ -0,0 +1,12 @@
+from unittest import TestCase
+
+import tree_sitter
+import tree_sitter_pkl
+
+
+class TestLanguage(TestCase):
+    def test_can_load_grammar(self):
+        try:
+            tree_sitter.Language(tree_sitter_pkl.language())
+        except Exception:
+            self.fail("Error loading Pkl grammar")