@apple/tree-sitter-pkl 0.20.0 → 0.21.0

package/.editorconfig

@@ -44,3 +44,6 @@ indent_size = 2
 
 [{alloc,array,parser}.h]
 indent_size = 2
+
+[*.txt]
+trim_trailing_whitespace = false

package/.github/PklProject

@@ -0,0 +1,26 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//   https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//===----------------------------------------------------------------------===//
+
+amends "pkl:Project"
+
+dependencies {
+  ["pkl.impl.ghactions"] {
+    uri = "package://pkg.pkl-lang.org/pkl-project-commons/pkl.impl.ghactions@1.8.1"
+  }
+  ["com.github.actions"] {
+    uri = "package://pkg.pkl-lang.org/pkl-pantry/com.github.actions@1.6.0"
+  }
+}

package/.github/PklProject.deps.json

@@ -0,0 +1,40 @@
+{
+  "schemaVersion": 1,
+  "resolvedDependencies": {
+    "package://pkg.pkl-lang.org/pkl-pantry/com.github.actions@1": {
+      "type": "remote",
+      "uri": "projectpackage://pkg.pkl-lang.org/pkl-pantry/com.github.actions@1.7.0",
+      "checksums": {
+        "sha256": "e3461c3f8d00a6a657f9fa4f391afdab4a53a2e528862a4d8624e545cd3cb2b1"
+      }
+    },
+    "package://pkg.pkl-lang.org/pkl-project-commons/pkl.impl.ghactions@1": {
+      "type": "remote",
+      "uri": "projectpackage://pkg.pkl-lang.org/pkl-project-commons/pkl.impl.ghactions@1.8.1",
+      "checksums": {
+        "sha256": "476cd931de6868b3f5e088ac741261d7beb9f4de3305564675510fd74ffb83f3"
+      }
+    },
+    "package://pkg.pkl-lang.org/pkl-pantry/pkl.experimental.deepToTyped@1": {
+      "type": "remote",
+      "uri": "projectpackage://pkg.pkl-lang.org/pkl-pantry/pkl.experimental.deepToTyped@1.2.0",
+      "checksums": {
+        "sha256": "84c7feb391f4ac273a99dc89b8fd51dbcd21dbda4ce640f6908527f83acdd4d6"
+      }
+    },
+    "package://pkg.pkl-lang.org/pkl-pantry/pkl.github.dependabotManagedActions@1": {
+      "type": "remote",
+      "uri": "projectpackage://pkg.pkl-lang.org/pkl-pantry/pkl.github.dependabotManagedActions@1.1.6",
+      "checksums": {
+        "sha256": "85ad51d257bad4729f0b9edecade48fcad6f55bacd0fa36106782475e912919a"
+      }
+    },
+    "package://pkg.pkl-lang.org/pkl-pantry/com.github.dependabot@1": {
+      "type": "remote",
+      "uri": "projectpackage://pkg.pkl-lang.org/pkl-pantry/com.github.dependabot@1.0.4",
+      "checksums": {
+        "sha256": "c7391119f946d7761d0ca0cc358ed8fe2bdfc691411087ccac89637bd96fec4a"
+      }
+    }
+  }
+}

package/.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+- package-ecosystem: npm
+  cooldown:
+    default-days: 7
+  directory: /
+  schedule:
+    interval: weekly
+- package-ecosystem: github-actions
+  cooldown:
+    default-days: 7
+  directory: /
+  ignore:
+  - dependency-name: '*'
+    update-types:
+    - version-update:semver-major
+  schedule:
+    interval: weekly

package/.github/index.pkl

@@ -0,0 +1,159 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2025-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//   https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//===----------------------------------------------------------------------===//
+
+amends "@pkl.impl.ghactions/PklCI.pkl"
+
+import "@com.github.actions/catalog.pkl"
+import "@com.github.actions/context.pkl"
+import "@com.github.actions/Workflow.pkl"
+import "@pkl.impl.ghactions/jobs/HawkeyeCheck.pkl"
+
+build = buildAndTest
+
+prb = buildAndTest
+
+main = buildAndTest
+
+release = new {
+  jobs {
+    ["npm-publish"] = npmPublishJob
+    ["github-release"] = releaseToGithubJob
+  }
+}
+
+local baseJob: Workflow.Job = new {
+  `runs-on` = "ubuntu-latest"
+  steps {
+    (catalog.`actions/checkout@v6`) {}
+    (catalog.`actions/setup-node@v6`) {
+      name = "Setup nodejs"
+      with {
+        `node-version` = "24.x"
+      }
+    }
+    new {
+      name = "Build"
+      run = "npm ci"
+    }
+    new {
+      name = "Check Code Generation"
+      run =
+        """
+        npm run generate
+        git diff --name-only --exit-code
+        """
+    }
+    new {
+      name = "Test"
+      run = "npm test"
+    }
+  }
+}
+
+local buildAndTest: Workflow = new {
+  jobs {
+    ["test-licenses"] = new HawkeyeCheck {}.job
+    ["build-and-test"] = (baseJob) {
+      name = "Build and test"
+    }
+  }
+}
+
+local releaseToGithubJob: Workflow.Job = new {
+  name = "Create GitHub Release"
+  `runs-on` = "ubuntu-latest"
+  permissions {
+    contents = "write"
+  }
+  steps {
+    (catalog.`actions/checkout@v6`) {}
+    new {
+      name = "Publish release to GitHub"
+      env {
+        ["GH_TOKEN"] = context.github.token
+        ["GH_REPO"] = context.github.repository
+        ["GIT_TAG"] = context.github.refName
+      }
+      run =
+        #"""
+        # strip preceding "v"
+        VERSION="${GIT_TAG:1}"
+        EXPECTED_VERSION=$(jq -r .version package.json)
+
+        if [ "${EXPECTED_VERSION}" != "${VERSION}" ]; then
+          echo "Mismatching versions!"
+          echo "package.json has ${EXPECTED_VERSION}"
+          echo "Inferred version from Git tag is ${VERSION}"
+          echo "Use 'tree-sitter version ${VERSION}' to match the tag, and re-tag."
+          exit 1
+        fi
+
+        gh release create "${GIT_TAG}" \
+          --title "${GIT_TAG}" \
+          --verify-tag \
+          --notes ""
+        """#
+    }
+  }
+}
+
+local npmPublishJob: Workflow.Job = new {
+  name = "Publish to npm"
+  `runs-on` = "ubuntu-latest"
+  environment = "npmjs"
+  permissions {
+    contents = "read"
+    `id-token` = "write"
+  }
+  steps {
+    (catalog.`actions/checkout@v6`) {}
+    (catalog.`actions/setup-node@v6`) {
+      name = "Setup Node.js"
+      with {
+        `node-version` = "24.x"
+        `registry-url` = "https://registry.npmjs.org"
+        `package-manager-cache` = false
+      }
+    }
+    new {
+      name = "Build"
+      run = "npm ci"
+    }
+    new {
+      name = "Test"
+      run = "npm test"
+    }
+    new {
+      name = "Publish to npm"
+      run = "npm publish --provenance"
+    }
+  }
+}
+
+dependabot {
+  updates {
+    new {
+      `package-ecosystem` = "npm"
+      directory = "/"
+      cooldown {
+        `default-days` = 7
+      }
+      schedule {
+        interval = "weekly"
+      }
+    }
+  }
+}

package/.github/workflows/__lockfile__.yml

@@ -0,0 +1,28 @@
+#file: noinspection MandatoryParamsAbsent,UndefinedAction
+# This is a fake workflow that never runs.
+# It's used to pin actions to specific git SHAs when generating actual workflows.
+# It also gets updated by dependabot (see .github/dependabot.yml).
+# Generated from Workflow.pkl. DO NOT EDIT.
+name: __lockfile__
+'on':
+  push:
+    branches-ignore:
+    - '**'
+    tags-ignore:
+    - '**'
+permissions: {}
+jobs:
+  locks:
+    if: 'false'
+    runs-on: nothing
+    steps:
+    - name: actions/checkout@v6
+      uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+    - name: actions/setup-node@v6
+      uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+    - name: actions/upload-artifact@v5
+      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+    - name: github/codeql-action/analyze@v4
+      uses: github/codeql-action/analyze@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4
+    - name: github/codeql-action/init@v4
+      uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4

package/.github/workflows/build.yml

@@ -0,0 +1,48 @@
+# Generated from Workflow.pkl. DO NOT EDIT.
+name: Build
+'on':
+  push:
+    branches-ignore:
+    - main
+    - release/*
+    - dependabot/**
+    tags-ignore:
+    - '**'
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+permissions:
+  contents: read
+jobs:
+  test-licenses:
+    name: hawkeye-check
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || '' }}
+        persist-credentials: false
+        fetch-depth: 0
+    - run: git config --global --add safe.directory $(pwd)
+    - run: hawkeye check --config licenserc.toml --fail-if-unknown
+    container:
+      image: ghcr.io/korandoru/hawkeye@sha256:e0abf8dbfaeeeba1249679d662d9fb404b1dcdb041c6093ea1f7a6edb7d89319
+  build-and-test:
+    name: Build and test
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        persist-credentials: false
+    - name: Setup nodejs
+      uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+      with:
+        node-version: 24.x
+    - name: Build
+      run: npm ci
+    - name: Check Code Generation
+      run: |-
+        npm run generate
+        git diff --name-only --exit-code
+    - name: Test
+      run: npm test

package/.github/workflows/codeql.yml

@@ -0,0 +1,28 @@
+# Generated from Workflow.pkl. DO NOT EDIT.
+'on':
+  pull_request:
+    branches:
+    - main
+  push:
+    branches:
+    - main
+  schedule:
+  - cron: 29 17 * * 4
+jobs:
+  analyze-actions:
+    name: Analyze (actions)
+    permissions:
+      security-events: write
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        persist-credentials: false
+    - uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4
+      with:
+        languages: actions
+        build-mode: none
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4
+      with:
+        category: /language:actions

package/.github/workflows/main.yml

@@ -0,0 +1,46 @@
+# Generated from Workflow.pkl. DO NOT EDIT.
+name: Build (main)
+'on':
+  push:
+    branches:
+    - main
+    tags-ignore:
+    - '**'
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+permissions:
+  contents: read
+jobs:
+  test-licenses:
+    name: hawkeye-check
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || '' }}
+        persist-credentials: false
+        fetch-depth: 0
+    - run: git config --global --add safe.directory $(pwd)
+    - run: hawkeye check --config licenserc.toml --fail-if-unknown
+    container:
+      image: ghcr.io/korandoru/hawkeye@sha256:e0abf8dbfaeeeba1249679d662d9fb404b1dcdb041c6093ea1f7a6edb7d89319
+  build-and-test:
+    name: Build and test
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        persist-credentials: false
+    - name: Setup nodejs
+      uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+      with:
+        node-version: 24.x
+    - name: Build
+      run: npm ci
+    - name: Check Code Generation
+      run: |-
+        npm run generate
+        git diff --name-only --exit-code
+    - name: Test
+      run: npm test

package/.github/workflows/prb.yml

@@ -0,0 +1,96 @@
+# Generated from Workflow.pkl. DO NOT EDIT.
+name: Pull Request
+'on':
+  pull_request: {}
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+permissions:
+  contents: read
+jobs:
+  test-licenses:
+    name: hawkeye-check
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || '' }}
+        persist-credentials: false
+        fetch-depth: 0
+    - run: git config --global --add safe.directory $(pwd)
+    - run: hawkeye check --config licenserc.toml --fail-if-unknown
+    container:
+      image: ghcr.io/korandoru/hawkeye@sha256:e0abf8dbfaeeeba1249679d662d9fb404b1dcdb041c6093ea1f7a6edb7d89319
+  build-and-test:
+    name: Build and test
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        persist-credentials: false
+    - name: Setup nodejs
+      uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+      with:
+        node-version: 24.x
+    - name: Build
+      run: npm ci
+    - name: Check Code Generation
+      run: |-
+        npm run generate
+        git diff --name-only --exit-code
+    - name: Test
+      run: npm test
+  verdict:
+    if: always()
+    needs:
+    - check-pkl-github-actions
+    - test-licenses
+    - build-and-test
+    runs-on: ubuntu-latest
+    steps:
+    - name: Failure verdict
+      if: contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled')
+      run: |-
+        echo "Some of the required jobs are either failing or were cancelled"
+        exit 1
+  upload-event-file:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Upload event file
+      if: '!cancelled()'
+      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+      with:
+        name: test-results-event-file
+        path: ${{ github.event_path }}
+  check-pkl-github-actions:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        persist-credentials: false
+    - name: Setup Pkl
+      id: setup-pkl
+      env:
+        PKL_VERSION: 0.30.0
+        PKL_FILENAME: pkl
+        PKL_DOWNLOAD_URL: https://github.com/apple/pkl/releases/download/0.30.0/pkl-linux-amd64
+      shell: bash
+      run: |-
+        DIR="$(mktemp -d /tmp/pkl-$PKL_VERSION-XXXXXX)"
+        PKL_EXEC="$DIR/$PKL_FILENAME"
+        curl -sfL -o $PKL_EXEC "$PKL_DOWNLOAD_URL"
+        chmod +x $PKL_EXEC
+        echo "$DIR" >> "$GITHUB_PATH"
+        echo "pkl_exec=$PKL_EXEC" >> "$GITHUB_OUTPUT"
+    - shell: bash
+      run: rm -rf .github/**/[a-z]*.yml
+    - shell: bash
+      run: pkl eval -m .github/ --project-dir .github/ .github/index.pkl
+    - name: check git status
+      shell: bash
+      run: |-
+        if [ -n "$(git status --porcelain)" ]; then
+          echo "Running pkl resulted in a diff! You likely need to run 'pkl eval' and commit the changes."
+          git diff --name-only
+          exit 1
+        fi

package/.github/workflows/release.yml

@@ -0,0 +1,68 @@
+# Generated from Workflow.pkl. DO NOT EDIT.
+name: Release
+'on':
+  push:
+    branches-ignore:
+    - '**'
+    tags:
+    - '**'
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+permissions:
+  contents: read
+jobs:
+  npm-publish:
+    name: Publish to npm
+    permissions:
+      contents: read
+      id-token: write
+    runs-on: ubuntu-latest
+    environment: npmjs
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        persist-credentials: false
+    - name: Setup Node.js
+      uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+      with:
+        node-version: 24.x
+        registry-url: https://registry.npmjs.org
+        package-manager-cache: false
+    - name: Build
+      run: npm ci
+    - name: Test
+      run: npm test
+    - name: Publish to npm
+      run: npm publish --provenance
+  github-release:
+    name: Create GitHub Release
+    permissions:
+      contents: write
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+      with:
+        persist-credentials: false
+    - name: Publish release to GitHub
+      env:
+        GH_TOKEN: ${{ github.token }}
+        GH_REPO: ${{ github.repository }}
+        GIT_TAG: ${{ github.ref_name }}
+      run: |-
+        # strip preceding "v"
+        VERSION="${GIT_TAG:1}"
+        EXPECTED_VERSION=$(jq -r .version package.json)
+
+        if [ "${EXPECTED_VERSION}" != "${VERSION}" ]; then
+          echo "Mismatching versions!"
+          echo "package.json has ${EXPECTED_VERSION}"
+          echo "Inferred version from Git tag is ${VERSION}"
+          echo "Use 'tree-sitter version ${VERSION}' to match the tag, and re-tag."
+          exit 1
+        fi
+
+        gh release create "${GIT_TAG}" \
+          --title "${GIT_TAG}" \
+          --verify-tag \
+          --notes ""

package/CHANGELOG.adoc

@@ -1,5 +1,25 @@
 = Changelog
 
+[[release-0.21.0]]
+== 0.21.0 (2026-07-07)
+
+=== Additions
+
+* Add support for multi-line string line continuations (https://github.com/apple/tree-sitter-pkl/pull/69[#69]).
+
+=== Fixes
+
+* Fix Rust binding library (https://github.com/apple/tree-sitter-pkl/pull/52[#52]).
+* Enable compatibility with Node 25+ and NPM 12+ (https://github.com/apple/tree-sitter-pkl/pull/87[#87]).
+
+=== Contributors ❤️
+
+Thanks to all the contributors for this release!
+
+* https://github.com/bioball[@bioball]
+* https://github.com/HT154[@HT154]
+* https://github.com/vmeurisse[@vmeurisse]
+
 [[release-0.20.0]]
 == 0.20.0 (2025-11-03)
 

package/CMakeLists.txt

@@ -1,7 +1,7 @@
 cmake_minimum_required(VERSION 3.13)
 
 project(tree-sitter-pkl
-        VERSION "0.20.0"
+        VERSION "0.21.0"
         DESCRIPTION "Parser for Pkl programming language"
         HOMEPAGE_URL "https://github.com/apple/tree-sitter-pkl"
         LANGUAGES C)