[docs] Add documetation about release/evolution/roadmap (#937)

* Update license header file spec to use placeholder year
* Update spotless to use ratchet formatting (only format files that have changed)

.circleci/config.pkl

@@ -0,0 +1,167 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2024 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.
+//===----------------------------------------------------------------------===// 
+// File gets rendered to .circleci/config.yml via git hook.
+amends "package://pkg.pkl-lang.org/pkl-project-commons/pkl.impl.circleci@1.1.1#/PklCI.pkl"
+
+import "jobs/BuildNativeJob.pkl"
+import "jobs/GradleCheckJob.pkl"
+import "jobs/DeployJob.pkl"
+import "jobs/SimpleGradleJob.pkl"
+
+local prbJobs: Listing<String> = gradleCheckJobs.keys.toListing()
+
+local buildAndTestJobs = (prbJobs) {
+  "bench"
+  "gradle-compatibility"
+  ...buildNativeJobs.keys.filter((it) -> it.endsWith("snapshot"))
+}
+
+local releaseJobs = (prbJobs) {
+  "bench"
+  "gradle-compatibility"
+  ...buildNativeJobs.keys.filter((it) -> it.endsWith("release"))
+}
+
+prb {
+  jobs = prbJobs
+}
+
+main {
+  jobs {
+    ...buildAndTestJobs
+    new {
+      ["deploy-snapshot"] {
+        requires = buildAndTestJobs
+        context = "pkl-maven-release"
+      }
+    }
+  }
+}
+
+release {
+  jobs {
+    ...releaseJobs
+    // do GitHub release first because we can overwrite the tag.
+    // publishing to Maven Central is final.
+    new {
+      ["github-release"] {
+        requires = releaseJobs
+        context = "pkl-github-release"
+      }
+    }
+    new {
+      ["deploy-release"] {
+        requires { "github-release" }
+        context = "pkl-maven-release"
+      }
+    }
+  }
+}
+
+releaseBranch {
+  jobs = releaseJobs
+}
+
+triggerDocsBuild = "both"
+
+triggerPackageDocsBuild = "release"
+
+local buildNativeJobs: Mapping<String, BuildNativeJob> = new {
+  for (_dist in List("release", "snapshot")) {
+    for (_arch in List("amd64", "aarch64")) {
+      for (_os in List("macOS", "linux")) {
+        ["pkl-cli-\(_os)-\(_arch)-\(_dist)"] {
+          arch = _arch 
+          os = _os
+          isRelease = _dist == "release"
+        }
+      }
+    }
+    ["pkl-cli-linux-alpine-amd64-\(_dist)"] {
+      arch = "amd64"
+      os = "linux"
+      musl = true
+      isRelease = _dist == "release"
+    }
+    ["pkl-cli-windows-amd64-\(_dist)"] {
+      arch = "amd64"
+      os = "windows"
+      isRelease = _dist == "release"
+    }
+  }
+}
+
+local gradleCheckJobs: Mapping<String, GradleCheckJob> = new {
+  ["gradle-check-jdk17"] {
+    javaVersion = "17.0"
+    isRelease = false
+    os = "linux"
+  }
+  ["gradle-check-jdk21"] {
+    javaVersion = "21.0"
+    isRelease = false
+    os = "linux"
+  }
+  ["gradle-check-jdk17-windows"] {
+    javaVersion = "17.0"
+    isRelease = false
+    os = "windows"
+  }
+}
+
+jobs {
+  for (jobName, job in buildNativeJobs) {
+    [jobName] = job.job
+  }
+  for (jobName, job in gradleCheckJobs) {
+    [jobName] = job.job
+  }
+  ["bench"] = new SimpleGradleJob { command = "bench:jmh" }.job
+  ["gradle-compatibility"] = new SimpleGradleJob {
+    name = "gradle compatibility"
+    command = #"""
+      :pkl-gradle:build \
+        :pkl-gradle:compatibilityTestReleases
+      """#
+  }.job
+  ["deploy-snapshot"] = new DeployJob { command = "publishToSonatype" }.job
+  ["deploy-release"] = new DeployJob {
+    isRelease = true
+    command = "publishToSonatype closeAndReleaseSonatypeStagingRepository"
+  }.job
+  ["github-release"] {
+    docker {
+      new { image = "maniator/gh:v2.40.1" }
+    }
+    steps {
+      new AttachWorkspaceStep { at = "." }
+      new RunStep {
+        name = "Publish release on GitHub"
+        command = #"""
+          # exclude build_artifacts.txt from publish
+          rm -f pkl-cli/build/executable/*.build_artifacts.txt
+          gh release create "${CIRCLE_TAG}" \
+            --title "${CIRCLE_TAG}" \
+            --target "${CIRCLE_SHA1}" \
+            --verify-tag \
+            --notes "Release notes: https://pkl-lang.org/main/current/release-notes/changelog.html#release-${CIRCLE_TAG}" \
+            --repo "${CIRCLE_PROJECT_USERNAME}/${CIRCLE_PROJECT_REPONAME}" \
+            pkl-cli/build/executable/*
+          """#
+      }
+    }
+  }
+}

.circleci/config.yml

@@ -0,0 +1,916 @@
+# Generated from CircleCI.pkl. DO NOT EDIT.
+version: '2.1'
+orbs:
+  pr-approval: apple/pr-approval@0.1.0
+jobs:
+  pkl-cli-macOS-amd64-release:
+    steps:
+    - checkout
+    - run:
+        command: /usr/sbin/softwareupdate --install-rosetta --agree-to-license
+        name: Installing Rosetta 2
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results -DreleaseBuild=true pkl-cli:macExecutableAmd64 pkl-core:testMacExecutableAmd64 pkl-server:testMacExecutableAmd64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    resource_class: macos.m1.large.gen1
+    macos:
+      xcode: 15.3.0
+  pkl-cli-linux-amd64-release:
+    steps:
+    - checkout
+    - restore_cache:
+        key: staticdeps-amd64
+        name: Restore static deps from cache
+    - run:
+        command: |-
+          sed -ie '/\[ol8_codeready_builder\]/,/^$/s/enabled=0/enabled=1/g' /etc/yum.repos.d/oracle-linux-ol8.repo \
+            && microdnf -y install util-linux tree coreutils-single findutils curl tar gzip git zlib-devel gcc-c++ make openssl glibc-langpack-en libstdc++-static \
+            && microdnf clean all \
+            && rm -rf /var/cache/dnf
+
+          # install jdk
+          curl -Lf \
+           https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9/OpenJDK17U-jdk_x64_linux_hotspot_17.0.9_9.tar.gz -o /tmp/jdk.tar.gz
+
+          mkdir /jdk \
+            && cd /jdk \
+            && cat /tmp/jdk.tar.gz | tar --strip-components=1 -xzC .
+
+          mkdir -p ~/staticdeps/bin
+
+          cp /usr/lib/gcc/x86_64-redhat-linux/8/libstdc++.a ~/staticdeps
+
+          # install zlib
+          if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
+            curl -Lf https://github.com/madler/zlib/releases/download/v1.2.13/zlib-1.2.13.tar.gz -o /tmp/zlib.tar.gz
+
+            mkdir -p /tmp/dep_zlib-1.2.13 \
+            && cd /tmp/dep_zlib-1.2.13 \
+            && cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "zlib-1.2.13: configure..." && ./configure --static --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "zlib-1.2.13: make..." && make -s -j4 \
+            && echo "zlib-1.2.13: make install..." && make -s install \
+            && rm -rf /tmp/dep_zlib-1.2.13
+          fi
+
+          # install musl
+          if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
+            curl -Lf https://musl.libc.org/releases/musl-1.2.2.tar.gz -o /tmp/musl.tar.gz
+
+            mkdir -p /tmp/dep_musl-1.2.2 \
+            && cd /tmp/dep_musl-1.2.2 \
+            && cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "musl-1.2.2: configure..." && ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "musl-1.2.2: make..." && make -s -j4 \
+            && echo "musl-1.2.2: make install..." && make -s install \
+            && rm -rf /tmp/dep_musl-1.2.2
+
+            # native-image expects to find an executable at this path.
+            ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
+          fi
+        name: Set up environment
+        shell: '#!/bin/bash -exo pipefail'
+    - save_cache:
+        paths:
+        - ~/staticdeps
+        key: staticdeps-amd64
+        name: Save statics deps to cache
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results -DreleaseBuild=true pkl-cli:linuxExecutableAmd64 pkl-core:testLinuxExecutableAmd64 pkl-server:testLinuxExecutableAmd64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: xlarge
+    docker:
+    - image: oraclelinux:8-slim
+  pkl-cli-macOS-aarch64-release:
+    steps:
+    - checkout
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results -DreleaseBuild=true pkl-cli:macExecutableAarch64 pkl-core:testMacExecutableAarch64 pkl-server:testMacExecutableAarch64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    resource_class: macos.m1.large.gen1
+    macos:
+      xcode: 15.3.0
+  pkl-cli-linux-aarch64-release:
+    steps:
+    - checkout
+    - restore_cache:
+        key: staticdeps-aarch64
+        name: Restore static deps from cache
+    - run:
+        command: |-
+          sed -ie '/\[ol8_codeready_builder\]/,/^$/s/enabled=0/enabled=1/g' /etc/yum.repos.d/oracle-linux-ol8.repo \
+            && microdnf -y install util-linux tree coreutils-single findutils curl tar gzip git zlib-devel gcc-c++ make openssl glibc-langpack-en libstdc++-static \
+            && microdnf clean all \
+            && rm -rf /var/cache/dnf
+
+          # install jdk
+          curl -Lf \
+           https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9/OpenJDK17U-jdk_aarch64_linux_hotspot_17.0.9_9.tar.gz -o /tmp/jdk.tar.gz
+
+          mkdir /jdk \
+            && cd /jdk \
+            && cat /tmp/jdk.tar.gz | tar --strip-components=1 -xzC .
+
+          mkdir -p ~/staticdeps/bin
+
+          cp /usr/lib/gcc/aarch64-redhat-linux/8/libstdc++.a ~/staticdeps
+
+          # install zlib
+          if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
+            curl -Lf https://github.com/madler/zlib/releases/download/v1.2.13/zlib-1.2.13.tar.gz -o /tmp/zlib.tar.gz
+
+            mkdir -p /tmp/dep_zlib-1.2.13 \
+            && cd /tmp/dep_zlib-1.2.13 \
+            && cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "zlib-1.2.13: configure..." && ./configure --static --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "zlib-1.2.13: make..." && make -s -j4 \
+            && echo "zlib-1.2.13: make install..." && make -s install \
+            && rm -rf /tmp/dep_zlib-1.2.13
+          fi
+        name: Set up environment
+        shell: '#!/bin/bash -exo pipefail'
+    - save_cache:
+        paths:
+        - ~/staticdeps
+        key: staticdeps-aarch64
+        name: Save statics deps to cache
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results -DreleaseBuild=true pkl-cli:linuxExecutableAarch64 pkl-core:testLinuxExecutableAarch64 pkl-server:testLinuxExecutableAarch64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: arm.xlarge
+    docker:
+    - image: arm64v8/oraclelinux:8-slim
+  pkl-cli-linux-alpine-amd64-release:
+    steps:
+    - checkout
+    - restore_cache:
+        key: staticdeps-amd64
+        name: Restore static deps from cache
+    - run:
+        command: |-
+          sed -ie '/\[ol8_codeready_builder\]/,/^$/s/enabled=0/enabled=1/g' /etc/yum.repos.d/oracle-linux-ol8.repo \
+            && microdnf -y install util-linux tree coreutils-single findutils curl tar gzip git zlib-devel gcc-c++ make openssl glibc-langpack-en libstdc++-static \
+            && microdnf clean all \
+            && rm -rf /var/cache/dnf
+
+          # install jdk
+          curl -Lf \
+           https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9/OpenJDK17U-jdk_x64_linux_hotspot_17.0.9_9.tar.gz -o /tmp/jdk.tar.gz
+
+          mkdir /jdk \
+            && cd /jdk \
+            && cat /tmp/jdk.tar.gz | tar --strip-components=1 -xzC .
+
+          mkdir -p ~/staticdeps/bin
+
+          cp /usr/lib/gcc/x86_64-redhat-linux/8/libstdc++.a ~/staticdeps
+
+          # install zlib
+          if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
+            curl -Lf https://github.com/madler/zlib/releases/download/v1.2.13/zlib-1.2.13.tar.gz -o /tmp/zlib.tar.gz
+
+            mkdir -p /tmp/dep_zlib-1.2.13 \
+            && cd /tmp/dep_zlib-1.2.13 \
+            && cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "zlib-1.2.13: configure..." && ./configure --static --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "zlib-1.2.13: make..." && make -s -j4 \
+            && echo "zlib-1.2.13: make install..." && make -s install \
+            && rm -rf /tmp/dep_zlib-1.2.13
+          fi
+
+          # install musl
+          if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
+            curl -Lf https://musl.libc.org/releases/musl-1.2.2.tar.gz -o /tmp/musl.tar.gz
+
+            mkdir -p /tmp/dep_musl-1.2.2 \
+            && cd /tmp/dep_musl-1.2.2 \
+            && cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "musl-1.2.2: configure..." && ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "musl-1.2.2: make..." && make -s -j4 \
+            && echo "musl-1.2.2: make install..." && make -s install \
+            && rm -rf /tmp/dep_musl-1.2.2
+
+            # native-image expects to find an executable at this path.
+            ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
+          fi
+        name: Set up environment
+        shell: '#!/bin/bash -exo pipefail'
+    - save_cache:
+        paths:
+        - ~/staticdeps
+        key: staticdeps-amd64
+        name: Save statics deps to cache
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results -DreleaseBuild=true pkl-cli:alpineExecutableAmd64 pkl-core:testAlpineExecutableAmd64 pkl-server:testAlpineExecutableAmd64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: xlarge
+    docker:
+    - image: oraclelinux:8-slim
+  pkl-cli-windows-amd64-release:
+    steps:
+    - checkout
+    - run:
+        command: |-
+          # install jdk
+          curl -Lf \
+          https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9.1/OpenJDK17U-jdk_x64_windows_hotspot_17.0.9_9.zip -o /tmp/jdk.zip
+
+          unzip /tmp/jdk.zip -d /tmp/jdk \
+            && cd /tmp/jdk/jdk-* \
+            && mkdir /jdk \
+            && cp -r . /jdk
+        name: Set up environment
+        shell: bash.exe
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results -DreleaseBuild=true pkl-cli:windowsExecutableAmd64 pkl-core:testWindowsExecutableAmd64 pkl-server:testWindowsExecutableAmd64
+        name: gradle buildNative
+        shell: bash.exe
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: windows.large
+    machine:
+      image: windows-server-2022-gui:current
+  pkl-cli-macOS-amd64-snapshot:
+    steps:
+    - checkout
+    - run:
+        command: /usr/sbin/softwareupdate --install-rosetta --agree-to-license
+        name: Installing Rosetta 2
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results pkl-cli:macExecutableAmd64 pkl-core:testMacExecutableAmd64 pkl-server:testMacExecutableAmd64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    resource_class: macos.m1.large.gen1
+    macos:
+      xcode: 15.3.0
+  pkl-cli-linux-amd64-snapshot:
+    steps:
+    - checkout
+    - restore_cache:
+        key: staticdeps-amd64
+        name: Restore static deps from cache
+    - run:
+        command: |-
+          sed -ie '/\[ol8_codeready_builder\]/,/^$/s/enabled=0/enabled=1/g' /etc/yum.repos.d/oracle-linux-ol8.repo \
+            && microdnf -y install util-linux tree coreutils-single findutils curl tar gzip git zlib-devel gcc-c++ make openssl glibc-langpack-en libstdc++-static \
+            && microdnf clean all \
+            && rm -rf /var/cache/dnf
+
+          # install jdk
+          curl -Lf \
+           https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9/OpenJDK17U-jdk_x64_linux_hotspot_17.0.9_9.tar.gz -o /tmp/jdk.tar.gz
+
+          mkdir /jdk \
+            && cd /jdk \
+            && cat /tmp/jdk.tar.gz | tar --strip-components=1 -xzC .
+
+          mkdir -p ~/staticdeps/bin
+
+          cp /usr/lib/gcc/x86_64-redhat-linux/8/libstdc++.a ~/staticdeps
+
+          # install zlib
+          if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
+            curl -Lf https://github.com/madler/zlib/releases/download/v1.2.13/zlib-1.2.13.tar.gz -o /tmp/zlib.tar.gz
+
+            mkdir -p /tmp/dep_zlib-1.2.13 \
+            && cd /tmp/dep_zlib-1.2.13 \
+            && cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "zlib-1.2.13: configure..." && ./configure --static --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "zlib-1.2.13: make..." && make -s -j4 \
+            && echo "zlib-1.2.13: make install..." && make -s install \
+            && rm -rf /tmp/dep_zlib-1.2.13
+          fi
+
+          # install musl
+          if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
+            curl -Lf https://musl.libc.org/releases/musl-1.2.2.tar.gz -o /tmp/musl.tar.gz
+
+            mkdir -p /tmp/dep_musl-1.2.2 \
+            && cd /tmp/dep_musl-1.2.2 \
+            && cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "musl-1.2.2: configure..." && ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "musl-1.2.2: make..." && make -s -j4 \
+            && echo "musl-1.2.2: make install..." && make -s install \
+            && rm -rf /tmp/dep_musl-1.2.2
+
+            # native-image expects to find an executable at this path.
+            ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
+          fi
+        name: Set up environment
+        shell: '#!/bin/bash -exo pipefail'
+    - save_cache:
+        paths:
+        - ~/staticdeps
+        key: staticdeps-amd64
+        name: Save statics deps to cache
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results pkl-cli:linuxExecutableAmd64 pkl-core:testLinuxExecutableAmd64 pkl-server:testLinuxExecutableAmd64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: xlarge
+    docker:
+    - image: oraclelinux:8-slim
+  pkl-cli-macOS-aarch64-snapshot:
+    steps:
+    - checkout
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results pkl-cli:macExecutableAarch64 pkl-core:testMacExecutableAarch64 pkl-server:testMacExecutableAarch64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    resource_class: macos.m1.large.gen1
+    macos:
+      xcode: 15.3.0
+  pkl-cli-linux-aarch64-snapshot:
+    steps:
+    - checkout
+    - restore_cache:
+        key: staticdeps-aarch64
+        name: Restore static deps from cache
+    - run:
+        command: |-
+          sed -ie '/\[ol8_codeready_builder\]/,/^$/s/enabled=0/enabled=1/g' /etc/yum.repos.d/oracle-linux-ol8.repo \
+            && microdnf -y install util-linux tree coreutils-single findutils curl tar gzip git zlib-devel gcc-c++ make openssl glibc-langpack-en libstdc++-static \
+            && microdnf clean all \
+            && rm -rf /var/cache/dnf
+
+          # install jdk
+          curl -Lf \
+           https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9/OpenJDK17U-jdk_aarch64_linux_hotspot_17.0.9_9.tar.gz -o /tmp/jdk.tar.gz
+
+          mkdir /jdk \
+            && cd /jdk \
+            && cat /tmp/jdk.tar.gz | tar --strip-components=1 -xzC .
+
+          mkdir -p ~/staticdeps/bin
+
+          cp /usr/lib/gcc/aarch64-redhat-linux/8/libstdc++.a ~/staticdeps
+
+          # install zlib
+          if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
+            curl -Lf https://github.com/madler/zlib/releases/download/v1.2.13/zlib-1.2.13.tar.gz -o /tmp/zlib.tar.gz
+
+            mkdir -p /tmp/dep_zlib-1.2.13 \
+            && cd /tmp/dep_zlib-1.2.13 \
+            && cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "zlib-1.2.13: configure..." && ./configure --static --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "zlib-1.2.13: make..." && make -s -j4 \
+            && echo "zlib-1.2.13: make install..." && make -s install \
+            && rm -rf /tmp/dep_zlib-1.2.13
+          fi
+        name: Set up environment
+        shell: '#!/bin/bash -exo pipefail'
+    - save_cache:
+        paths:
+        - ~/staticdeps
+        key: staticdeps-aarch64
+        name: Save statics deps to cache
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results pkl-cli:linuxExecutableAarch64 pkl-core:testLinuxExecutableAarch64 pkl-server:testLinuxExecutableAarch64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: arm.xlarge
+    docker:
+    - image: arm64v8/oraclelinux:8-slim
+  pkl-cli-linux-alpine-amd64-snapshot:
+    steps:
+    - checkout
+    - restore_cache:
+        key: staticdeps-amd64
+        name: Restore static deps from cache
+    - run:
+        command: |-
+          sed -ie '/\[ol8_codeready_builder\]/,/^$/s/enabled=0/enabled=1/g' /etc/yum.repos.d/oracle-linux-ol8.repo \
+            && microdnf -y install util-linux tree coreutils-single findutils curl tar gzip git zlib-devel gcc-c++ make openssl glibc-langpack-en libstdc++-static \
+            && microdnf clean all \
+            && rm -rf /var/cache/dnf
+
+          # install jdk
+          curl -Lf \
+           https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9/OpenJDK17U-jdk_x64_linux_hotspot_17.0.9_9.tar.gz -o /tmp/jdk.tar.gz
+
+          mkdir /jdk \
+            && cd /jdk \
+            && cat /tmp/jdk.tar.gz | tar --strip-components=1 -xzC .
+
+          mkdir -p ~/staticdeps/bin
+
+          cp /usr/lib/gcc/x86_64-redhat-linux/8/libstdc++.a ~/staticdeps
+
+          # install zlib
+          if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
+            curl -Lf https://github.com/madler/zlib/releases/download/v1.2.13/zlib-1.2.13.tar.gz -o /tmp/zlib.tar.gz
+
+            mkdir -p /tmp/dep_zlib-1.2.13 \
+            && cd /tmp/dep_zlib-1.2.13 \
+            && cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "zlib-1.2.13: configure..." && ./configure --static --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "zlib-1.2.13: make..." && make -s -j4 \
+            && echo "zlib-1.2.13: make install..." && make -s install \
+            && rm -rf /tmp/dep_zlib-1.2.13
+          fi
+
+          # install musl
+          if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
+            curl -Lf https://musl.libc.org/releases/musl-1.2.2.tar.gz -o /tmp/musl.tar.gz
+
+            mkdir -p /tmp/dep_musl-1.2.2 \
+            && cd /tmp/dep_musl-1.2.2 \
+            && cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC . \
+            && echo "musl-1.2.2: configure..." && ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null \
+            && echo "musl-1.2.2: make..." && make -s -j4 \
+            && echo "musl-1.2.2: make install..." && make -s install \
+            && rm -rf /tmp/dep_musl-1.2.2
+
+            # native-image expects to find an executable at this path.
+            ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
+          fi
+        name: Set up environment
+        shell: '#!/bin/bash -exo pipefail'
+    - save_cache:
+        paths:
+        - ~/staticdeps
+        key: staticdeps-amd64
+        name: Save statics deps to cache
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results pkl-cli:alpineExecutableAmd64 pkl-core:testAlpineExecutableAmd64 pkl-server:testAlpineExecutableAmd64
+        name: gradle buildNative
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: xlarge
+    docker:
+    - image: oraclelinux:8-slim
+  pkl-cli-windows-amd64-snapshot:
+    steps:
+    - checkout
+    - run:
+        command: |-
+          # install jdk
+          curl -Lf \
+          https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9.1/OpenJDK17U-jdk_x64_windows_hotspot_17.0.9_9.zip -o /tmp/jdk.zip
+
+          unzip /tmp/jdk.zip -d /tmp/jdk \
+            && cd /tmp/jdk/jdk-* \
+            && mkdir /jdk \
+            && cp -r . /jdk
+        name: Set up environment
+        shell: bash.exe
+    - run:
+        command: |-
+          export PATH=~/staticdeps/bin:$PATH
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results pkl-cli:windowsExecutableAmd64 pkl-core:testWindowsExecutableAmd64 pkl-server:testWindowsExecutableAmd64
+        name: gradle buildNative
+        shell: bash.exe
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: windows.large
+    machine:
+      image: windows-server-2022-gui:current
+  gradle-check-jdk17:
+    steps:
+    - checkout
+    - run:
+        command: ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results check
+        name: gradle check
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    docker:
+    - image: cimg/openjdk:17.0
+  gradle-check-jdk21:
+    steps:
+    - checkout
+    - run:
+        command: ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results check
+        name: gradle check
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    docker:
+    - image: cimg/openjdk:21.0
+  gradle-check-jdk17-windows:
+    steps:
+    - checkout
+    - run:
+        command: |-
+          # install jdk
+          curl -Lf \
+          https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9.1/OpenJDK17U-jdk_x64_windows_hotspot_17.0.9_9.zip -o /tmp/jdk.zip
+
+          unzip /tmp/jdk.zip -d /tmp/jdk \
+            && cd /tmp/jdk/jdk-* \
+            && mkdir /jdk \
+            && cp -r . /jdk
+        name: Set up environment
+        shell: bash.exe
+    - run:
+        command: ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results check
+        name: gradle check
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+      JAVA_HOME: /jdk
+    resource_class: windows.large
+    machine:
+      image: windows-server-2022-gui:current
+  bench:
+    steps:
+    - checkout
+    - run:
+        command: ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results bench:jmh
+        name: bench:jmh
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    docker:
+    - image: cimg/openjdk:17.0
+  gradle-compatibility:
+    steps:
+    - checkout
+    - run:
+        command: |-
+          ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results :pkl-gradle:build \
+            :pkl-gradle:compatibilityTestReleases
+        name: gradle compatibility
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    docker:
+    - image: cimg/openjdk:17.0
+  deploy-snapshot:
+    steps:
+    - checkout
+    - attach_workspace:
+        at: '.'
+    - run:
+        command: ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results publishToSonatype
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    docker:
+    - image: cimg/openjdk:17.0
+  deploy-release:
+    steps:
+    - checkout
+    - attach_workspace:
+        at: '.'
+    - run:
+        command: ./gradlew --info --stacktrace -DtestReportsDir=${HOME}/test-results -DreleaseBuild=true publishToSonatype closeAndReleaseSonatypeStagingRepository
+    - persist_to_workspace:
+        root: '.'
+        paths:
+        - pkl-cli/build/executable/
+    - store_test_results:
+        path: ~/test-results
+    environment:
+      LANG: en_US.UTF-8
+    docker:
+    - image: cimg/openjdk:17.0
+  github-release:
+    steps:
+    - attach_workspace:
+        at: '.'
+    - run:
+        command: |-
+          # exclude build_artifacts.txt from publish
+          rm -f pkl-cli/build/executable/*.build_artifacts.txt
+          gh release create "${CIRCLE_TAG}" \
+            --title "${CIRCLE_TAG}" \
+            --target "${CIRCLE_SHA1}" \
+            --verify-tag \
+            --notes "Release notes: https://pkl-lang.org/main/current/release-notes/changelog.html#release-${CIRCLE_TAG}" \
+            --repo "${CIRCLE_PROJECT_USERNAME}/${CIRCLE_PROJECT_REPONAME}" \
+            pkl-cli/build/executable/*
+        name: Publish release on GitHub
+    docker:
+    - image: maniator/gh:v2.40.1
+  trigger-docsite-build:
+    steps:
+    - run:
+        command: |-
+          curl --location \
+            --request POST \
+            --header "Content-Type: application/json" \
+            -u "${CIRCLE_TOKEN}:" \
+            --data '{ "branch": "main" }' \
+            "https://circleci.com/api/v2/project/github/apple/pkl-lang.org/pipeline"
+        name: Triggering docsite build
+    docker:
+    - image: cimg/base:current
+  trigger-package-docs-build:
+    steps:
+    - run:
+        command: |-
+          curl --location \
+            --request POST \
+            --header "Content-Type: application/json" \
+            -u "${CIRCLE_TOKEN}:" \
+            --data '{ "branch": "main" }' \
+            "https://circleci.com/api/v2/project/github/apple/pkl-package-docs/pipeline"
+        name: Triggering docsite build
+    docker:
+    - image: cimg/base:current
+workflows:
+  prb:
+    jobs:
+    - hold:
+        type: approval
+    - pr-approval/authenticate:
+        context: pkl-pr-approval
+    - gradle-check-jdk17:
+        requires:
+        - hold
+    - gradle-check-jdk21:
+        requires:
+        - hold
+    - gradle-check-jdk17-windows:
+        requires:
+        - hold
+    when:
+      matches:
+        value: << pipeline.git.branch >>
+        pattern: ^pull/\d+(/head)?$
+  main:
+    jobs:
+    - gradle-check-jdk17
+    - gradle-check-jdk21
+    - gradle-check-jdk17-windows
+    - bench
+    - gradle-compatibility
+    - pkl-cli-macOS-amd64-snapshot
+    - pkl-cli-linux-amd64-snapshot
+    - pkl-cli-macOS-aarch64-snapshot
+    - pkl-cli-linux-aarch64-snapshot
+    - pkl-cli-linux-alpine-amd64-snapshot
+    - pkl-cli-windows-amd64-snapshot
+    - deploy-snapshot:
+        requires:
+        - gradle-check-jdk17
+        - gradle-check-jdk21
+        - gradle-check-jdk17-windows
+        - bench
+        - gradle-compatibility
+        - pkl-cli-macOS-amd64-snapshot
+        - pkl-cli-linux-amd64-snapshot
+        - pkl-cli-macOS-aarch64-snapshot
+        - pkl-cli-linux-aarch64-snapshot
+        - pkl-cli-linux-alpine-amd64-snapshot
+        - pkl-cli-windows-amd64-snapshot
+        context: pkl-maven-release
+    - trigger-docsite-build:
+        requires:
+        - deploy-snapshot
+        context:
+        - pkl-pr-approval
+    when:
+      equal:
+      - main
+      - << pipeline.git.branch >>
+  release:
+    jobs:
+    - gradle-check-jdk17:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - gradle-check-jdk21:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - gradle-check-jdk17-windows:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - bench:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - gradle-compatibility:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - pkl-cli-macOS-amd64-release:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - pkl-cli-linux-amd64-release:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - pkl-cli-macOS-aarch64-release:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - pkl-cli-linux-aarch64-release:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - pkl-cli-linux-alpine-amd64-release:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - pkl-cli-windows-amd64-release:
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - github-release:
+        requires:
+        - gradle-check-jdk17
+        - gradle-check-jdk21
+        - gradle-check-jdk17-windows
+        - bench
+        - gradle-compatibility
+        - pkl-cli-macOS-amd64-release
+        - pkl-cli-linux-amd64-release
+        - pkl-cli-macOS-aarch64-release
+        - pkl-cli-linux-aarch64-release
+        - pkl-cli-linux-alpine-amd64-release
+        - pkl-cli-windows-amd64-release
+        context: pkl-github-release
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - deploy-release:
+        requires:
+        - github-release
+        context: pkl-maven-release
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+    - trigger-package-docs-build:
+        requires:
+        - deploy-release
+        context:
+        - pkl-pr-approval
+        filters:
+          branches:
+            ignore: /.*/
+          tags:
+            only: /^v?\d+\.\d+\.\d+$/
+  release-branch:
+    jobs:
+    - gradle-check-jdk17
+    - gradle-check-jdk21
+    - gradle-check-jdk17-windows
+    - bench
+    - gradle-compatibility
+    - pkl-cli-macOS-amd64-release
+    - pkl-cli-linux-amd64-release
+    - pkl-cli-macOS-aarch64-release
+    - pkl-cli-linux-aarch64-release
+    - pkl-cli-linux-alpine-amd64-release
+    - pkl-cli-windows-amd64-release
+    when:
+      matches:
+        value: << pipeline.git.branch >>
+        pattern: ^release/\d+\.\d+$

.circleci/jobs/BuildNativeJob.pkl

@@ -0,0 +1,164 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2024 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.
+//===----------------------------------------------------------------------===//
+/// Builds the native `pkl` CLI
+extends "GradleJob.pkl"
+
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.2#/Config.pkl"
+
+/// The architecture to use
+arch: "amd64"|"aarch64"
+
+/// Whether to link to musl. Otherwise, links to glibc.
+musl: Boolean = false
+
+javaVersion = "17.0"
+
+local setupLinuxEnvironment: Config.RunStep =
+  let (muslVersion = "1.2.2")
+  let (zlibVersion = "1.2.13")
+    new {
+      name = "Set up environment"
+      shell = "#!/bin/bash -exo pipefail"
+      command = new Listing {
+        #"""
+        sed -ie '/\[ol8_codeready_builder\]/,/^$/s/enabled=0/enabled=1/g' /etc/yum.repos.d/oracle-linux-ol8.repo \
+          && microdnf -y install util-linux tree coreutils-single findutils curl tar gzip git zlib-devel gcc-c++ make openssl glibc-langpack-en libstdc++-static \
+          && microdnf clean all \
+          && rm -rf /var/cache/dnf
+
+        # install jdk
+        curl -Lf \
+         https://github.com/adoptium/temurin\#(module.majorJdkVersion)-binaries/releases/download/\#(module.jdkGitHubReleaseName)/OpenJDK\#(module.majorJdkVersion)U-jdk_\#(if (arch == "amd64") "x64" else "aarch64")_linux_hotspot_\#(module.jdkVersionAlt).tar.gz -o /tmp/jdk.tar.gz
+
+        mkdir /jdk \
+          && cd /jdk \
+          && cat /tmp/jdk.tar.gz | tar --strip-components=1 -xzC .
+
+        mkdir -p ~/staticdeps/bin
+
+        cp /usr/lib/gcc/\#(if (arch == "amd64") "x86_64" else "aarch64")-redhat-linux/8/libstdc++.a ~/staticdeps
+
+        # install zlib
+        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
+          curl -Lf https://github.com/madler/zlib/releases/download/v\#(zlibVersion)/zlib-\#(zlibVersion).tar.gz -o /tmp/zlib.tar.gz
+
+          mkdir -p /tmp/dep_zlib-\#(zlibVersion) \
+          && cd /tmp/dep_zlib-\#(zlibVersion) \
+          && cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC . \
+          && echo "zlib-\#(zlibVersion): configure..." && ./configure --static --prefix="$HOME"/staticdeps > /dev/null \
+          && echo "zlib-\#(zlibVersion): make..." && make -s -j4 \
+          && echo "zlib-\#(zlibVersion): make install..." && make -s install \
+          && rm -rf /tmp/dep_zlib-\#(zlibVersion)
+        fi
+        """#
+        // don't need musl on aarch because GraalVM only supports musl builds on x86
+        when (arch == "amd64") {
+            #"""
+            # install musl
+            if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
+              curl -Lf https://musl.libc.org/releases/musl-\#(muslVersion).tar.gz -o /tmp/musl.tar.gz
+
+              mkdir -p /tmp/dep_musl-\#(muslVersion) \
+              && cd /tmp/dep_musl-\#(muslVersion) \
+              && cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC . \
+              && echo "musl-\#(muslVersion): configure..." && ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null \
+              && echo "musl-\#(muslVersion): make..." && make -s -j4 \
+              && echo "musl-\#(muslVersion): make install..." && make -s install \
+              && rm -rf /tmp/dep_musl-\#(muslVersion)
+
+              # native-image expects to find an executable at this path.
+              ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
+            fi
+            """#
+        }
+      }.join("\n\n")
+    }
+
+steps {
+  when (os == "linux") {
+    new Config.RestoreCacheStep {
+      name = "Restore static deps from cache"
+      key = "staticdeps-\(arch)"
+    }
+    setupLinuxEnvironment
+    new Config.SaveCacheStep {
+      name = "Save statics deps to cache"
+      key = "staticdeps-\(arch)"
+      paths {
+        "~/staticdeps"
+      }
+    }
+  }
+  when (os == "macOS" && arch == "amd64") {
+    new Config.RunStep {
+      name = "Installing Rosetta 2"
+      command = """
+        /usr/sbin/softwareupdate --install-rosetta --agree-to-license
+        """
+    }
+  }
+  new Config.RunStep {
+    name = "gradle buildNative"
+    local _os =
+      if (module.os == "macOS") "mac"
+      else if (musl) "alpine"
+      else if (module.os == "windows") "windows"
+      else "linux"
+    local jobName = "\(_os)Executable\(arch.capitalize())"
+    when (module.os == "windows") {
+      shell = "bash.exe"
+    }
+    command = #"""
+      export PATH=~/staticdeps/bin:$PATH
+      ./gradlew \#(module.gradleArgs) pkl-cli:\#(jobName) pkl-core:test\#(jobName.capitalize()) pkl-server:test\#(jobName.capitalize())
+      """#
+  }
+  new Config.PersistToWorkspaceStep {
+    root = "."
+    paths {
+      "pkl-cli/build/executable/"
+    }
+  }
+}
+
+job {
+  when (os == "macOS") {
+    macos {
+      xcode = "15.3.0"
+    }
+    resource_class = "macos.m1.large.gen1"
+  }
+  when (os == "linux") {
+    docker = new Listing<Config.DockerImage> {
+      new {
+        image = if (arch == "aarch64") "arm64v8/oraclelinux:8-slim" else "oraclelinux:8-slim"
+      }
+    }
+    environment {
+      ["JAVA_HOME"] = "/jdk"
+    }
+    resource_class = if (arch == "aarch64") "arm.xlarge" else "xlarge"
+  }
+  when (os == "windows") {
+    machine {
+      image = "windows-server-2022-gui:current"
+    }
+    resource_class = "windows.large"
+    environment {
+      ["JAVA_HOME"] = "/jdk"
+    }
+  }
+}

.circleci/jobs/DeployJob.pkl

@@ -0,0 +1,40 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2024 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.
+//===----------------------------------------------------------------------===//
+extends "GradleJob.pkl"
+
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.2#/Config.pkl"
+
+local self = this
+
+javaVersion = "17.0"
+
+command: String
+
+os = "linux"
+
+steps {
+  new Config.AttachWorkspaceStep { at = "." }
+  new Config.RunStep {
+    command = "./gradlew \(self.gradleArgs) \(module.command)"
+  }
+  // add jpkl to workspace so it gets published as a GitHub release
+  new Config.PersistToWorkspaceStep {
+    root = "."
+    paths {
+      "pkl-cli/build/executable/"
+    }
+  }
+}

.circleci/jobs/GradleCheckJob.pkl

@@ -0,0 +1,25 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2024 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.
+//===----------------------------------------------------------------------===//
+extends "GradleJob.pkl"
+
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.2#/Config.pkl"
+
+steps {
+  new Config.RunStep {
+    name = "gradle check"
+    command = "./gradlew \(module.gradleArgs) check"
+  }
+}

.circleci/jobs/GradleJob.pkl

@@ -0,0 +1,100 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2024 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.
+//===----------------------------------------------------------------------===//
+abstract module GradleJob
+
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.2#/Config.pkl"
+import "package://pkg.pkl-lang.org/pkl-pantry/pkl.experimental.uri@1.0.3#/URI.pkl"
+
+/// Whether this is a release build or not.
+isRelease: Boolean = false
+
+/// The OS to run on
+os: "macOS"|"linux"|"windows"
+
+/// The version of Java to use.
+javaVersion: "17.0"|"21.0"
+
+fixed javaVersionFull =
+  if (javaVersion == "17.0") "17.0.9+9"
+  else "21.0.5+11"
+
+fixed jdkVersionAlt = javaVersionFull.replaceLast("+", "_")
+
+fixed majorJdkVersion = javaVersionFull.split(".").first
+
+fixed jdkGitHubReleaseName =
+  let (ver =
+    // 17.0.9+9 is missing some binaries (see https://github.com/adoptium/adoptium-support/issues/994)
+    if (javaVersionFull == "17.0.9+9" && os == "windows") "jdk-17.0.9+9.1"
+    else "jdk-\(javaVersionFull)"
+  )
+    URI.encodeComponent(ver)
+
+fixed gradleArgs = new Listing {
+  "--info"
+  "--stacktrace"
+  "-DtestReportsDir=${HOME}/test-results"
+  when (isRelease) {
+    "-DreleaseBuild=true"
+  }
+}.join(" ")
+
+steps: Listing<Config.Step>
+
+job: Config.Job = new {
+  environment {
+    ["LANG"] = "en_US.UTF-8"
+    when (os == "windows") {
+      ["JAVA_HOME"] = "/jdk"
+    }
+  }
+  when (os == "linux") {
+    docker {
+      new {
+        image = "cimg/openjdk:\(javaVersion)"
+      }
+    }
+  }
+  when (os == "windows") {
+    machine {
+      image = "windows-server-2022-gui:current"
+    }
+    resource_class = "windows.large"
+  }
+  steps {
+    "checkout"
+    when (os == "windows") {
+      new Config.RunStep {
+        name = "Set up environment"
+        shell = "bash.exe"
+        command = #"""
+          # install jdk
+          curl -Lf \
+          https://github.com/adoptium/temurin\#(majorJdkVersion)-binaries/releases/download/\#(jdkGitHubReleaseName)/OpenJDK\#(majorJdkVersion)U-jdk_x64_windows_hotspot_\#(jdkVersionAlt).zip -o /tmp/jdk.zip
+
+          unzip /tmp/jdk.zip -d /tmp/jdk \
+            && cd /tmp/jdk/jdk-* \
+            && mkdir /jdk \
+            && cp -r . /jdk
+          """#
+      }
+    }
+    ...module.steps
+    new Config.StoreTestResults {
+      path = "~/test-results"
+    }
+  }
+}

.circleci/jobs/SimpleGradleJob.pkl

@@ -0,0 +1,35 @@
+//===----------------------------------------------------------------------===//
+// Copyright © 2024 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.
+//===----------------------------------------------------------------------===//
+extends "GradleJob.pkl"
+
+import "package://pkg.pkl-lang.org/pkl-pantry/com.circleci.v2@1.1.2#/Config.pkl"
+
+name: String = command
+
+command: String
+
+os = "linux"
+
+javaVersion = "17.0"
+
+steps {
+  new Config.RunStep {
+    name = module.name
+    command = """
+      ./gradlew \(module.gradleArgs) \(module.command)
+      """
+  }
+}

.gitattributes

@@ -1,6 +1,5 @@
 # linguist-generated would suppress files in diffs
 **/src/test/files/** linguist-vendored
-.github/workflows/* linguist-generated
 
 /docs/** linguist-documentation
 

.githooks/pre-commit

@@ -2,7 +2,7 @@
 
 files=`git diff --cached --name-status`
 
-if [[ $files =~ .github/* ]]; then
+if [[ $files =~ .circleci/config.pkl ]]; then
-  pkl eval --project-dir .github/ -m .github .github/index.pkl
+  pkl eval .circleci/config.pkl -o .circleci/config.yml
-  git add .github/workflows/
+  git add .circleci/config.yml
 fi

.github/PklProject

@@ -1,10 +0,0 @@
-amends "pkl:Project"
-
-dependencies {
-  ["pkl.impl.ghactions"] {
-    uri = "package://pkg.pkl-lang.org/pkl-project-commons/pkl.impl.ghactions@1.6.0"
-  }
-  ["gha"] {
-    uri = "package://pkg.pkl-lang.org/pkl-pantry/com.github.actions@1.4.0"
-  }
-}

.github/PklProject.deps.json

@@ -1,40 +0,0 @@
-{
-  "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.4.0",
-      "checksums": {
-        "sha256": "e0b9a9f71071d6101e9d764c069b2ec4a597d5315cb6e4c265b3f0d90c2b482c"
-      }
-    },
-    "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.6.0",
-      "checksums": {
-        "sha256": "fbc3c456ea468a0fe6baa9b3d30167259ac04e721a41a10fe82d2970026f0b1d"
-      }
-    },
-    "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.0",
-      "checksums": {
-        "sha256": "025fac778f2c5f75c8229fa4ec0f49ebdb99a61affe9aae489fefd8fccd92faa"
-      }
-    },
-    "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.1",
-      "checksums": {
-        "sha256": "0a4fe9b0983716ec49fb060b9e5e83f8c365eb899d517123b43134416a9574b6"
-      }
-    }
-  }
-}

.github/codeql.pkl

@@ -1,67 +0,0 @@
-amends "@gha/Workflow.pkl"
-
-import "@gha/catalog.pkl"
-
-on {
-  push {
-    branches {
-      "main"
-    }
-  }
-  pull_request {}
-  schedule {
-    // Run at 01:38 on Saturday
-    new { cron = "38 1 * * 6" }
-  }
-}
-
-local class CodeQLScan {
-  language: String
-
-  `build-mode`: String
-}
-
-local scans: Listing<CodeQLScan> = new {
-  new {
-    language = "actions"
-    `build-mode` = "none"
-  }
-  new {
-    language = "java-kotlin"
-    `build-mode` = "autobuild"
-  }
-  new {
-    language = "javascript-typescript"
-    `build-mode` = "none"
-  }
-}
-
-jobs {
-  for (scan in scans) {
-    ["analyze-\(scan.language)"] {
-      name = "Analyze (\(scan.language))"
-      `runs-on` = "ubuntu-latest"
-      permissions {
-        `security-events` = "write"
-      }
-      steps {
-        catalog.`actions/checkout@v6`
-        new {
-          name = "Initialize CodeQL"
-          uses = "github/codeql-action/init@v4"
-          with {
-            ["languages"] = scan.language
-            ["build-mode"] = scan.`build-mode`
-          }
-        }
-        new {
-          name = "Perform CodeQL Analysis"
-          uses = "github/codeql-action/analyze@v4"
-          with {
-            ["category"] = "/language:\(scan.language)"
-          }
-        }
-      }
-    }
-  }
-}

.github/dependabot.yml

@@ -1,18 +0,0 @@
-version: 2
-updates:
-- package-ecosystem: gradle
-  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

.github/index.pkl

@@ -1,247 +0,0 @@
-amends "@pkl.impl.ghactions/PklCI.pkl"
-
-import "@gha/Workflow.pkl"
-
-import "jobs/BuildJavaExecutableJob.pkl"
-import "jobs/BuildNativeJob.pkl"
-import "jobs/DeployJob.pkl"
-import "jobs/GithubRelease.pkl"
-import "jobs/GradleJob.pkl"
-import "jobs/PklJob.pkl"
-import "jobs/SimpleGradleJob.pkl"
-import "codeql.pkl"
-
-triggerDocsBuild = "both"
-
-testReports {
-  junit {
-    "**/build/test-results/**/*.xml"
-  }
-  html {
-    "**/build/reports/tests/**/*"
-  }
-  excludeJobs {
-    "bench"
-    "github-release"
-    "dependency-submission"
-    "dependency-review"
-    Regex("deploy-.*")
-  }
-}
-
-local baseGradleCheck: SimpleGradleJob = new {
-  isRelease = false
-  command = "check"
-  fetchDepth = 0
-}
-
-local gradleCheck = (baseGradleCheck) {
-  os = "linux"
-}
-
-local gradleCheckWindows = (baseGradleCheck) {
-  os = "windows"
-}
-
-local typealias PklJobs = Mapping<String, PklJob | *Workflow.Job>
-
-local toWorkflowJobs: (PklJobs) -> Workflow.Jobs = (it) -> new Workflow.Jobs {
-  for (k, v in it) {
-    when (v is PklJob) {
-      [k] = v.job
-    } else {
-      [k] = v
-    }
-  }
-}
-
-local gradleCheckJobs: PklJobs = new {
-  ["gradle-check"] = gradleCheck
-  ["gradle-check-windows"] = gradleCheckWindows
-}
-
-local buildNativeJobs: Mapping<String, BuildNativeJob> = new {
-  for (_dist in List("release", "snapshot")) {
-    for (_project in List("pkl-cli", "pkl-doc")) {
-      for (_arch in List("amd64", "aarch64")) {
-        for (_os in List("macOS", "linux")) {
-          ["\(_project)-\(_os)-\(_arch)-\(_dist)"] {
-            arch = _arch
-            os = _os
-            isRelease = _dist == "release"
-            project = _project
-          }
-        }
-      }
-      ["\(_project)-alpine-linux-amd64-\(_dist)"] {
-        arch = "amd64"
-        os = "linux"
-        musl = true
-        isRelease = _dist == "release"
-        project = _project
-      }
-      ["\(_project)-windows-amd64-\(_dist)"] {
-        arch = "amd64"
-        os = "windows"
-        isRelease = _dist == "release"
-        project = _project
-      }
-    }
-  }
-}
-
-local buildNativeSnapshots = buildNativeJobs.toMap().filter((key, _) -> key.endsWith("snapshot"))
-
-local buildNativeReleases = buildNativeJobs.toMap().filter((key, _) -> key.endsWith("release"))
-
-local benchmarkJob: SimpleGradleJob = new { command = "bench:jmh" }
-
-local gradleCompatibilityJob: SimpleGradleJob = new {
-  command = ":pkl-gradle:build :pkl-gradle:compatibilityTestReleases"
-  fetchDepth = 0
-}
-
-local buildJavaExecutableJob: BuildJavaExecutableJob = new {
-  fetchDepth = 0
-}
-
-local buildAndTestJobs: PklJobs = new {
-  ...gradleCheckJobs
-  ["bench"] = benchmarkJob
-  ["gradle-compatibility"] = gradleCompatibilityJob
-  ["java-executables-snapshot"] = (buildJavaExecutableJob) { isRelease = false }
-  ...buildNativeSnapshots
-}
-
-local releaseJobs: PklJobs = new {
-  ...gradleCheckJobs
-  ["bench"] = benchmarkJob
-  ["gradle-compatibility"] = gradleCompatibilityJob
-  ["java-executables-release"] = (buildJavaExecutableJob) { isRelease = true }
-  ...buildNativeReleases
-}
-
-// By default, just run ./gradlew check on linux.
-// Trigger other checks based on GitHub PR description. Examples:
-//
-//    * [windows]                     -- Test on Windows
-//    * [native]                      -- Test all native builds
-//    * [native-pkl-cli]              -- Test all pkl-cli os/arch pairs
-//    * [native-pkl-cli-macos]        -- Test pkl-cli on macOS
-prb {
-  local prbJobs: Mapping<String, GradleJob> = new {
-    ["gradle-check"] = gradleCheck
-    ["gradle-check-windows"] = (gradleCheckWindows) {
-      `if` = "contains(github.event.pull_request.body, '[windows]')"
-    }
-    for (jobName, job in buildNativeSnapshots) {
-      [jobName] = (job) {
-        local tags = new Listing {
-          "[native]"
-          "[native-\(job.project)]"
-          "[native-\(job.project)-\(job.os)]"
-          "[native-\(job.project)-\(job.os)-\(job.arch)]"
-          "[native-\(job.project)-\(job.os)-\(job.arch)]"
-          when (job.musl) {
-            "[native-\(job.project)-alpine-\(job.os)-\(job.arch)]"
-          }
-        }
-        `if` =
-          tags
-            .toList()
-            .map((it) -> "contains(github.event.pull_request.body, '\(it)')")
-            .join(" || ")
-      }
-    }
-  }
-  local prbJobs2 = (prbJobs) {
-    [[true]] {
-      // better SLA when not running on nightly
-      nightlyMacOS = false
-    }
-  }
-  jobs = prbJobs2 |> toWorkflowJobs
-}
-
-build {
-  jobs = buildAndTestJobs |> toWorkflowJobs
-}
-
-main {
-  jobs =
-    (buildAndTestJobs) {
-      ["deploy-snapshot"] = (
-        new DeployJob {
-          extraGradleArgs {
-            "--no-parallel"
-          }
-          command = "publishToSonatype"
-        }
-      ) {
-        needs = buildAndTestJobs.keys.toListing()
-      }
-      ["dependency-submission"] {
-        `runs-on` = "ubuntu-latest"
-        permissions {
-          contents = "write"
-        }
-        steps {
-          module.catalog.`actions/checkout@v6`
-          (module.catalog.`actions/setup-java@v5`) {
-            with {
-              `java-version` = "25"
-              distribution = "temurin"
-            }
-          }
-          (module.catalog.`gradle/actions/dependency-submission@v6`) {
-            with {
-              // language=regexp
-              `dependency-graph-include-configurations` =
-                ".*[rR]untimeClasspath|.*[cC]ompileClasspath"
-            }
-          }
-        }
-      }
-    } |> toWorkflowJobs
-}
-
-releaseBranch {
-  jobs = releaseJobs |> toWorkflowJobs
-}
-
-release {
-  jobs =
-    (releaseJobs) {
-      ["deploy-release"] = (
-        new DeployJob {
-          isRelease = true
-          command = "publishToSonatype closeAndReleaseSonatypeStagingRepository"
-        }
-      ) {
-        needs = releaseJobs.keys.toListing()
-      }
-      ["github-release"] = new GithubRelease {
-        needs = "deploy-release"
-      }
-    } |> toWorkflowJobs
-}
-
-dependabot {
-  updates {
-    new {
-      `package-ecosystem` = "gradle"
-      schedule {
-        interval = "weekly"
-      }
-      cooldown {
-        `default-days` = 7
-      }
-      directory = "/"
-    }
-  }
-}
-
-workflows {
-  // add codeql workflow to set of workflows
-  ["workflows/codeql.yml"] = codeql
-}

.github/jobs/BuildJavaExecutableJob.pkl

@@ -1,32 +0,0 @@
-extends "GradleJob.pkl"
-
-import "@gha/catalog.pkl"
-
-// Keep this in sync with projects that build java executables
-local projects: List<String> = List("pkl-doc", "pkl-cli", "pkl-codegen-java", "pkl-codegen-kotlin")
-
-local command =
-  new Listing<String> {
-    "./gradlew"
-    module.gradleArgs
-    for (project in projects) {
-      // NOTE: `build` doesn't build native executables
-      "\(project):build"
-    }
-  }.join(" ")
-
-steps {
-  catalog.`actions/checkout@v6`
-  new {
-    name = "gradle build java executables"
-    shell = "bash"
-    run = command
-  }
-  (catalog.`actions/upload-artifact@v5`) {
-    name = "Upload executable artifacts"
-    with {
-      name = "executable-java"
-      path = "*/build/executable/**/*"
-    }
-  }
-}

.github/jobs/BuildNativeJob.pkl

@@ -1,73 +0,0 @@
-extends "GradleJob.pkl"
-
-import "@gha/catalog.pkl"
-import "@gha/context.pkl"
-
-/// Whether to link to musl. Otherwise, links to glibc.
-musl: Boolean(implies(module.os == "linux")) = false
-
-/// The Gradle project under which to generate the executable
-project: String
-
-extraGradleArgs {
-  when (os == "macOS" && arch == "amd64") {
-    "-Dpkl.targetArch=\(module.arch)"
-    #""-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh""#
-  }
-  when (musl) {
-    "-Dpkl.musl=true"
-  }
-}
-
-preSteps {
-  when (os == "linux" && !musl) {
-    new {
-      name = "Install deps"
-      run =
-        "dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en"
-    }
-  }
-}
-
-steps {
-  when (musl) {
-    new {
-      name = "Install musl and zlib"
-      run = read("../scripts/install_musl.sh").text
-    }
-  }
-  // workaround for https://github.com/actions/checkout/issues/1048
-  when (os == "linux" && !musl) {
-    new {
-      name = "Fix git ownership"
-      // language=bash
-      run = #"git status || git config --system --add safe.directory "$GITHUB_WORKSPACE""#
-    }
-  }
-  new {
-    name = "gradle buildNative"
-    shell = "bash"
-    run = "./gradlew \(module.gradleArgs) \(project):buildNative"
-  }
-  (catalog.`actions/upload-artifact@v5`) {
-    name = "Upload executable artifacts"
-    with {
-      name =
-        if (musl)
-          "executable-\(project)-alpine-\(module.os)-\(module.arch)"
-        else
-          "executable-\(project)-\(module.os)-\(module.arch)"
-      // Need to insert a wildcard to make actions/upload-artifact preserve the folder hierarchy.
-      // See https://github.com/actions/upload-artifact/issues/206
-      path = "\(project)*/build/executable/**/*"
-    }
-  }
-}
-
-fixed job {
-  when (os == "linux" && !musl) {
-    container {
-      image = "redhat/ubi8:8.10"
-    }
-  }
-}

.github/jobs/DeployJob.pkl

@@ -1,31 +0,0 @@
-extends "GradleJob.pkl"
-
-import "@gha/catalog.pkl"
-import "@gha/Workflow.pkl"
-import "@pkl.impl.ghactions/helpers.pkl"
-
-local self = this
-
-command: String
-
-arch = "amd64"
-
-os = "linux"
-
-steps {
-  catalog.`actions/checkout@v6`
-  (catalog.`actions/download-artifact@v6`) {
-    with {
-      pattern = "executable-**"
-      `merge-multiple` = true
-    }
-  }
-  new Workflow.Step {
-    run = "./gradlew \(self.gradleArgs) \(module.command)"
-  }
-    |> helpers.withMavenPublishSecrets
-}
-
-fixed job {
-  environment = "maven-release"
-}

.github/jobs/GithubRelease.pkl

@@ -1,44 +0,0 @@
-module GithubRelease
-
-extends "PklJob.pkl"
-
-import "@gha/catalog.pkl"
-import "@gha/context.pkl"
-
-fixed job {
-  `runs-on` = "ubuntu-latest"
-  permissions {
-    contents = "write"
-  }
-  needs = "deploy-release"
-  steps {
-    (catalog.`actions/download-artifact@v6`) {
-      with {
-        pattern = "executable-**"
-        `merge-multiple` = true
-      }
-    }
-    new {
-      name = "Publish release on GitHub"
-      env {
-        ["GH_TOKEN"] = context.github.token
-        ["TAG_NAME"] = context.github.refName
-        ["GIT_SHA"] = context.github.sha
-        ["GH_REPO"] = context.github.repository
-      }
-      // language=bash
-      run =
-        #"""
-        # exclude build_artifacts.txt from publish
-        rm -f */build/executable/*.build_artifacts.txt
-        find */build/executable/* -type d | xargs rm -rf
-        gh release create ${TAG_NAME} \
-          --title "${TAG_NAME}" \
-          --target "${GIT_SHA}" \
-          --verify-tag \
-          --notes "Release notes: https://pkl-lang.org/main/current/release-notes/changelog.html#release-${TAG_NAME}" \
-          */build/executable/*
-        """#
-    }
-  }
-}

.github/jobs/GradleJob.pkl

@@ -1,102 +0,0 @@
-abstract module GradleJob
-
-extends "PklJob.pkl"
-
-import "@gha/Workflow.pkl"
-import "@pkl.impl.ghactions/catalog.pkl"
-
-/// Whether this is a release build or not.
-isRelease: Boolean = false
-
-/// The architecture to use
-arch: "amd64" | "aarch64" = "amd64"
-
-/// The OS to run on.
-os: "macOS" | "linux" | "windows" = "linux"
-
-// TODO flip this to `true` when nightly macOS is available
-/// Whether to run on nightly macOS.
-nightlyMacOS: Boolean(implies(os == "macOS")) = false
-
-extraGradleArgs: Listing<String>
-
-steps: Listing<Workflow.Step>
-
-preSteps: Listing<Workflow.Step>
-
-/// The fetch depth to use when doing a git checkout.
-fetchDepth: Int?
-
-fixed gradleArgs =
-  new Listing {
-    "--info"
-    "--stacktrace"
-    "--no-daemon"
-    "-DpklMultiJdkTesting=true"
-    when (isRelease) {
-      "-DreleaseBuild=true"
-    }
-    ...extraGradleArgs
-  }.join(" ")
-
-fixed job {
-  env {
-    ["LANG"] = "en_US.UTF-8"
-    when (os == "windows") {
-      ["JAVA_HOME"] = "/jdk"
-    }
-  }
-  when (os == "macOS") {
-    `if` =
-      let (cond = "github.repository_owner == 'apple'")
-        if (super.`if` != null)
-          "(\(super.`if`)) && \(cond)"
-        else
-          cond
-  }
-  `runs-on` =
-    if (os == "linux" && arch == "amd64")
-      "ubuntu-latest"
-    else if (os == "linux" && arch == "aarch64")
-      "ubuntu-24.04-arm"
-    else if (os == "windows")
-      "windows-latest"
-    else
-      new Listing {
-        "self-hosted"
-        "macos"
-        when (nightlyMacOS) {
-          "nightly"
-        }
-      }
-  steps {
-    ...preSteps
-    // full checkout (needed for spotless)
-    (catalog.`actions/checkout@v6`) {
-      when (fetchDepth != null) {
-        with {
-          `fetch-depth` = fetchDepth
-        }
-      }
-    }
-    (catalog.`actions/setup-java@v5`) {
-      with {
-        `java-version` = "25"
-        distribution = "temurin"
-        architecture =
-          if (arch == "amd64")
-            "x64"
-          else
-            "aarch64"
-      }
-    }
-    (catalog.`gradle/actions/setup-gradle@v5`) {
-      when (isRelease) {
-        with {
-          `cache-disabled` = true
-        }
-      }
-    }
-    ...module.steps
-  }
-}

.github/jobs/PklJob.pkl

@@ -1,29 +0,0 @@
-abstract module PklJob
-
-extends "@pkl.impl.ghactions/jobs/PklJob.pkl"
-
-/// Identify any jobs that must complete successfully before this job will run.
-///
-/// It can be a string or array of strings.
-/// If a job fails or is skipped, all jobs that need it are skipped unless the jobs use a conditional expression that
-/// causes the job to continue.
-/// If a run contains a series of jobs that need each other, a failure or skip applies to all jobs in the dependency
-/// chain from the point of failure or skip onwards. If you would like a job to run even if a job it is dependent on
-/// did not succeed, use the `always()` conditional expression in `jobs.<job_id>.if`.
-///
-/// See: <https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idneeds>
-needs: (String | *Listing<String>)?
-
-/// A conditional to prevent a job from running unless a condition is met.
-///
-/// You can use any supported context and expression to create a conditional.
-/// For more information on which contexts are supported in this key, see
-/// [Contexts reference](https://docs.github.com/en/actions/reference/workflows-and-actions/contexts#context-availability).
-@SourceCode { language = "GithubExpressionLanguage" }
-`if`: String?
-
-/// The underlying workflow job
-fixed job {
-  `if` = module.`if`
-  needs = module.needs
-}

.github/jobs/SimpleGradleJob.pkl

@@ -1,18 +0,0 @@
-extends "GradleJob.pkl"
-
-name: String = command
-
-command: String
-
-os = "linux"
-
-steps {
-  new {
-    name = module.name
-    shell = "bash"
-    run =
-      """
-      ./gradlew \(module.gradleArgs) \(module.command)
-      """
-  }
-}

.github/scripts/cc_macos_amd64.sh

@@ -1,2 +0,0 @@
-#!/usr/bin/env bash
-clang -arch x86_64 "$@"

.github/scripts/install_musl.sh

@@ -1,71 +0,0 @@
-set -e
-mkdir -p ~/staticdeps/
-
-ZLIB_VERSION="1.2.13"
-MUSL_VERSION="1.2.5"
-
-# install zlib
-if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-  # Download zlib tarball and signature
-  curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-  curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-  # Import zlib GPG key
-  gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-  # Verify GPG signature
-  echo "Verifying zlib GPG signature..."
-  gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-  mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-  cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-  # shellcheck disable=SC2002
-  cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-  echo "zlib-${ZLIB_VERSION}: configure..." 
-  ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-  echo "zlib-${ZLIB_VERSION}: make..." 
-  make -s -j4
-
-  echo "zlib-${ZLIB_VERSION}: make install..." 
-  make -s install
-
-  rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-fi
-
-# install musl
-if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-  # Download musl tarball and signature
-  curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-  curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-  # Import musl GPG key
-  gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-  # Verify GPG signature
-  echo "Verifying musl GPG signature..."
-  gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-  mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-  cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-  # shellcheck disable=SC2002
-  cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-  echo "musl-${MUSL_VERSION}: configure..." 
-  ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-  echo "musl-${MUSL_VERSION}: make..." 
-  make -s -j4
-
-  echo "musl-${MUSL_VERSION}: make install..." 
-  make -s install
-
-  rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-  # native-image expects to find an executable at this path.
-  ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-fi
-
-echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"

.github/workflows/__lockfile__.yml

@@ -1,40 +0,0 @@
-#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: EnricoMi/publish-unit-test-result-action@v2
-      uses: EnricoMi/publish-unit-test-result-action@c950f6fb443cb5af20a377fd0dfaa78838901040 # v2
-    - name: actions/checkout@v6
-      uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-    - name: actions/create-github-app-token@v2
-      uses: actions/create-github-app-token@fee1f7d63c2ff003460e3d139729b119787bc349 # v2
-    - name: actions/download-artifact@v6
-      uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
-    - name: actions/setup-java@v5
-      uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-    - name: actions/upload-artifact@v5
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-    - name: dawidd6/action-download-artifact@v11
-      uses: dawidd6/action-download-artifact@ac66b43f0e6a346234dd65d4d0c8fbb31cb316e5 # v11
-    - name: github/codeql-action/analyze@v4
-      uses: github/codeql-action/analyze@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4
-    - name: github/codeql-action/init@v4
-      uses: github/codeql-action/init@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4
-    - name: gradle/actions/dependency-submission@v6
-      uses: gradle/actions/dependency-submission@50e97c2cd7a37755bbfafc9c5b7cafaece252f6e # v6
-    - name: gradle/actions/setup-gradle@v5
-      uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5

.github/workflows/build.yml

@@ -1,826 +0,0 @@
-# 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:
-  gradle-check:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  gradle-check-windows:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check-windows
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check-windows
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  bench:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: bench:jmh
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true bench:jmh
-  gradle-compatibility:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: :pkl-gradle:build :pkl-gradle:compatibilityTestReleases
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true :pkl-gradle:build :pkl-gradle:compatibilityTestReleases
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-compatibility
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-compatibility
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  java-executables-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - name: gradle build java executables
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:build pkl-cli:build pkl-codegen-java:build pkl-codegen-kotlin:build
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-java
-        path: '*/build/executable/**/*'
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-java-executables-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-java-executables-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-macOS-amd64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-macOS-aarch64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-aarch64-snapshot:
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-alpine-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.musl=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-alpine-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-alpine-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-alpine-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-windows-amd64-snapshot:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-windows-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-windows-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-windows-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-macOS-amd64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-macOS-aarch64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-aarch64-snapshot:
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-alpine-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.musl=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-alpine-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-alpine-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-alpine-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-windows-amd64-snapshot:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-windows-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-windows-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-windows-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  publish-test-results:
-    if: '!cancelled()'
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - gradle-compatibility
-    - java-executables-snapshot
-    - pkl-cli-macOS-amd64-snapshot
-    - pkl-cli-linux-amd64-snapshot
-    - pkl-cli-macOS-aarch64-snapshot
-    - pkl-cli-linux-aarch64-snapshot
-    - pkl-cli-alpine-linux-amd64-snapshot
-    - pkl-cli-windows-amd64-snapshot
-    - pkl-doc-macOS-amd64-snapshot
-    - pkl-doc-linux-amd64-snapshot
-    - pkl-doc-macOS-aarch64-snapshot
-    - pkl-doc-linux-aarch64-snapshot
-    - pkl-doc-alpine-linux-amd64-snapshot
-    - pkl-doc-windows-amd64-snapshot
-    permissions:
-      checks: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
-      with:
-        pattern: test-results-xml-*
-    - name: Publish test results
-      if: '!cancelled()'
-      uses: EnricoMi/publish-unit-test-result-action@c950f6fb443cb5af20a377fd0dfaa78838901040 # v2
-      with:
-        comment_mode: 'off'
-        files: test-results-xml-*/**/*.xml
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-publish-test-results
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore

.github/workflows/codeql.yml

@@ -1,63 +0,0 @@
-# Generated from Workflow.pkl. DO NOT EDIT.
-'on':
-  pull_request: {}
-  push:
-    branches:
-    - main
-  schedule:
-  - cron: 38 1 * * 6
-jobs:
-  analyze-actions:
-    name: Analyze (actions)
-    permissions:
-      security-events: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4
-      with:
-        languages: actions
-        build-mode: none
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4
-      with:
-        category: /language:actions
-  analyze-java-kotlin:
-    name: Analyze (java-kotlin)
-    permissions:
-      security-events: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4
-      with:
-        languages: java-kotlin
-        build-mode: autobuild
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4
-      with:
-        category: /language:java-kotlin
-  analyze-javascript-typescript:
-    name: Analyze (javascript-typescript)
-    permissions:
-      security-events: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4
-      with:
-        languages: javascript-typescript
-        build-mode: none
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4
-      with:
-        category: /language:javascript-typescript

.github/workflows/main.yml

@@ -1,929 +0,0 @@
-# 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:
-  gradle-check:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  gradle-check-windows:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check-windows
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check-windows
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  bench:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: bench:jmh
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true bench:jmh
-  gradle-compatibility:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: :pkl-gradle:build :pkl-gradle:compatibilityTestReleases
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true :pkl-gradle:build :pkl-gradle:compatibilityTestReleases
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-compatibility
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-compatibility
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  java-executables-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - name: gradle build java executables
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:build pkl-cli:build pkl-codegen-java:build pkl-codegen-kotlin:build
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-java
-        path: '*/build/executable/**/*'
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-java-executables-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-java-executables-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-macOS-amd64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-macOS-aarch64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-aarch64-snapshot:
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-alpine-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.musl=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-alpine-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-alpine-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-alpine-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-windows-amd64-snapshot:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-windows-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-windows-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-windows-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-macOS-amd64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-macOS-aarch64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-aarch64-snapshot:
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-alpine-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.musl=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-alpine-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-alpine-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-alpine-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-windows-amd64-snapshot:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-windows-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-windows-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-windows-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  deploy-snapshot:
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - bench
-    - gradle-compatibility
-    - java-executables-snapshot
-    - pkl-cli-macOS-amd64-snapshot
-    - pkl-cli-linux-amd64-snapshot
-    - pkl-cli-macOS-aarch64-snapshot
-    - pkl-cli-linux-aarch64-snapshot
-    - pkl-cli-alpine-linux-amd64-snapshot
-    - pkl-cli-windows-amd64-snapshot
-    - pkl-doc-macOS-amd64-snapshot
-    - pkl-doc-linux-amd64-snapshot
-    - pkl-doc-macOS-aarch64-snapshot
-    - pkl-doc-linux-aarch64-snapshot
-    - pkl-doc-alpine-linux-amd64-snapshot
-    - pkl-doc-windows-amd64-snapshot
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    environment: maven-release
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
-      with:
-        pattern: executable-**
-        merge-multiple: true
-    - env:
-        ORG_GRADLE_PROJECT_signingKeyId: ${{ secrets.ORG_GRADLE_PROJECT_SIGNINGKEYID }}
-        ORG_GRADLE_PROJECT_signingKey: ${{ secrets.ORG_GRADLE_PROJECT_SIGNINGKEY }}
-        ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.ORG_GRADLE_PROJECT_SIGNINGPASSWORD }}
-        ORG_GRADLE_PROJECT_sonatypePassword: ${{ secrets.ORG_GRADLE_PROJECT_SONATYPEPASSWORD }}
-        ORG_GRADLE_PROJECT_sonatypeUsername: ${{ secrets.ORG_GRADLE_PROJECT_SONATYPEUSERNAME }}
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true --no-parallel publishToSonatype
-  dependency-submission:
-    permissions:
-      contents: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-    - uses: gradle/actions/dependency-submission@50e97c2cd7a37755bbfafc9c5b7cafaece252f6e # v6
-      with:
-        dependency-graph-include-configurations: .*[rR]untimeClasspath|.*[cC]ompileClasspath
-  publish-test-results:
-    if: '!cancelled()'
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - gradle-compatibility
-    - java-executables-snapshot
-    - pkl-cli-macOS-amd64-snapshot
-    - pkl-cli-linux-amd64-snapshot
-    - pkl-cli-macOS-aarch64-snapshot
-    - pkl-cli-linux-aarch64-snapshot
-    - pkl-cli-alpine-linux-amd64-snapshot
-    - pkl-cli-windows-amd64-snapshot
-    - pkl-doc-macOS-amd64-snapshot
-    - pkl-doc-linux-amd64-snapshot
-    - pkl-doc-macOS-aarch64-snapshot
-    - pkl-doc-linux-aarch64-snapshot
-    - pkl-doc-alpine-linux-amd64-snapshot
-    - pkl-doc-windows-amd64-snapshot
-    permissions:
-      checks: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
-      with:
-        pattern: test-results-xml-*
-    - name: Publish test results
-      if: '!cancelled()'
-      uses: EnricoMi/publish-unit-test-result-action@c950f6fb443cb5af20a377fd0dfaa78838901040 # v2
-      with:
-        comment_mode: 'off'
-        files: test-results-xml-*/**/*.xml
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-publish-test-results
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  trigger-downstream-builds:
-    if: github.repository_owner == 'apple'
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - bench
-    - gradle-compatibility
-    - java-executables-snapshot
-    - pkl-cli-macOS-amd64-snapshot
-    - pkl-cli-linux-amd64-snapshot
-    - pkl-cli-macOS-aarch64-snapshot
-    - pkl-cli-linux-aarch64-snapshot
-    - pkl-cli-alpine-linux-amd64-snapshot
-    - pkl-cli-windows-amd64-snapshot
-    - pkl-doc-macOS-amd64-snapshot
-    - pkl-doc-linux-amd64-snapshot
-    - pkl-doc-macOS-aarch64-snapshot
-    - pkl-doc-linux-aarch64-snapshot
-    - pkl-doc-alpine-linux-amd64-snapshot
-    - pkl-doc-windows-amd64-snapshot
-    - deploy-snapshot
-    - dependency-submission
-    - publish-test-results
-    runs-on: ubuntu-latest
-    steps:
-    - name: Create app token
-      id: app-token
-      uses: actions/create-github-app-token@fee1f7d63c2ff003460e3d139729b119787bc349 # v2
-      with:
-        app-id: ${{ secrets.PKL_CI_CLIENT_ID }}
-        private-key: ${{ secrets.PKL_CI }}
-        owner: ${{ github.repository_owner }}
-    - name: Trigger pkl-lang.org build
-      env:
-        GH_TOKEN: ${{ steps.app-token.outputs.token }}
-        SOURCE_RUN: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
-      run: |-
-        gh workflow run \
-          --repo apple/pkl-lang.org \
-          --ref main \
-          --field source_run="${SOURCE_RUN}" \
-          main.yml

.github/workflows/prb.yml

@@ -1,755 +0,0 @@
-# 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:
-  gradle-check:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  gradle-check-windows:
-    if: contains(github.event.pull_request.body, '[windows]')
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check-windows
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check-windows
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-macOS-amd64-snapshot:
-    if: (contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-cli]') || contains(github.event.pull_request.body, '[native-pkl-cli-macOS]') || contains(github.event.pull_request.body, '[native-pkl-cli-macOS-amd64]') || contains(github.event.pull_request.body, '[native-pkl-cli-macOS-amd64]')) && github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-amd64-snapshot:
-    if: contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-cli]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux-amd64]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux-amd64]')
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-macOS-aarch64-snapshot:
-    if: (contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-cli]') || contains(github.event.pull_request.body, '[native-pkl-cli-macOS]') || contains(github.event.pull_request.body, '[native-pkl-cli-macOS-aarch64]') || contains(github.event.pull_request.body, '[native-pkl-cli-macOS-aarch64]')) && github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-aarch64-snapshot:
-    if: contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-cli]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux-aarch64]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux-aarch64]')
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-alpine-linux-amd64-snapshot:
-    if: contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-cli]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux-amd64]') || contains(github.event.pull_request.body, '[native-pkl-cli-linux-amd64]') || contains(github.event.pull_request.body, '[native-pkl-cli-alpine-linux-amd64]')
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.musl=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-alpine-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-alpine-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-alpine-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-windows-amd64-snapshot:
-    if: contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-cli]') || contains(github.event.pull_request.body, '[native-pkl-cli-windows]') || contains(github.event.pull_request.body, '[native-pkl-cli-windows-amd64]') || contains(github.event.pull_request.body, '[native-pkl-cli-windows-amd64]')
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-windows-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-windows-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-windows-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-macOS-amd64-snapshot:
-    if: (contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-doc]') || contains(github.event.pull_request.body, '[native-pkl-doc-macOS]') || contains(github.event.pull_request.body, '[native-pkl-doc-macOS-amd64]') || contains(github.event.pull_request.body, '[native-pkl-doc-macOS-amd64]')) && github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-amd64-snapshot:
-    if: contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-doc]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux-amd64]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux-amd64]')
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-macOS-aarch64-snapshot:
-    if: (contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-doc]') || contains(github.event.pull_request.body, '[native-pkl-doc-macOS]') || contains(github.event.pull_request.body, '[native-pkl-doc-macOS-aarch64]') || contains(github.event.pull_request.body, '[native-pkl-doc-macOS-aarch64]')) && github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-aarch64-snapshot:
-    if: contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-doc]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux-aarch64]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux-aarch64]')
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-alpine-linux-amd64-snapshot:
-    if: contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-doc]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux-amd64]') || contains(github.event.pull_request.body, '[native-pkl-doc-linux-amd64]') || contains(github.event.pull_request.body, '[native-pkl-doc-alpine-linux-amd64]')
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.musl=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-alpine-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-alpine-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-alpine-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-windows-amd64-snapshot:
-    if: contains(github.event.pull_request.body, '[native]') || contains(github.event.pull_request.body, '[native-pkl-doc]') || contains(github.event.pull_request.body, '[native-pkl-doc-windows]') || contains(github.event.pull_request.body, '[native-pkl-doc-windows-amd64]') || contains(github.event.pull_request.body, '[native-pkl-doc-windows-amd64]')
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-windows-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-windows-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-        if-no-files-found: ignore
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-windows-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  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@de0fac2e4500dabe0009e67214ff5f5447ce83dd # 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

.github/workflows/release-branch.yml

@@ -1,864 +0,0 @@
-# Generated from Workflow.pkl. DO NOT EDIT.
-name: Build (release branch)
-'on':
-  push:
-    branches:
-    - release/*
-    tags-ignore:
-    - '**'
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-permissions:
-  contents: read
-jobs:
-  gradle-check:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  gradle-check-windows:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check-windows
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check-windows
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  bench:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: bench:jmh
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true bench:jmh
-  gradle-compatibility:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: :pkl-gradle:build :pkl-gradle:compatibilityTestReleases
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true :pkl-gradle:build :pkl-gradle:compatibilityTestReleases
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-compatibility
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-compatibility
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  java-executables-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - name: gradle build java executables
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:build pkl-cli:build pkl-codegen-java:build pkl-codegen-kotlin:build
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-java
-        path: '*/build/executable/**/*'
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-java-executables-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-java-executables-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-macOS-amd64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-macOS-aarch64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-aarch64-snapshot:
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-alpine-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.musl=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-alpine-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-alpine-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-alpine-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-windows-amd64-snapshot:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-windows-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-windows-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-windows-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-macOS-amd64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-macOS-aarch64-snapshot:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-aarch64-snapshot:
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-aarch64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-aarch64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-alpine-linux-amd64-snapshot:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -Dpkl.musl=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-alpine-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-alpine-linux-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-alpine-linux-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-windows-amd64-snapshot:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-windows-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-windows-amd64-snapshot
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-windows-amd64-snapshot
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  publish-test-results:
-    if: '!cancelled()'
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - gradle-compatibility
-    - java-executables-snapshot
-    - pkl-cli-macOS-amd64-snapshot
-    - pkl-cli-linux-amd64-snapshot
-    - pkl-cli-macOS-aarch64-snapshot
-    - pkl-cli-linux-aarch64-snapshot
-    - pkl-cli-alpine-linux-amd64-snapshot
-    - pkl-cli-windows-amd64-snapshot
-    - pkl-doc-macOS-amd64-snapshot
-    - pkl-doc-linux-amd64-snapshot
-    - pkl-doc-macOS-aarch64-snapshot
-    - pkl-doc-linux-aarch64-snapshot
-    - pkl-doc-alpine-linux-amd64-snapshot
-    - pkl-doc-windows-amd64-snapshot
-    permissions:
-      checks: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
-      with:
-        pattern: test-results-xml-*
-    - name: Publish test results
-      if: '!cancelled()'
-      uses: EnricoMi/publish-unit-test-result-action@c950f6fb443cb5af20a377fd0dfaa78838901040 # v2
-      with:
-        comment_mode: 'off'
-        files: test-results-xml-*/**/*.xml
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-publish-test-results
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  trigger-downstream-builds:
-    if: github.repository_owner == 'apple'
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - bench
-    - gradle-compatibility
-    - java-executables-snapshot
-    - pkl-cli-macOS-amd64-snapshot
-    - pkl-cli-linux-amd64-snapshot
-    - pkl-cli-macOS-aarch64-snapshot
-    - pkl-cli-linux-aarch64-snapshot
-    - pkl-cli-alpine-linux-amd64-snapshot
-    - pkl-cli-windows-amd64-snapshot
-    - pkl-doc-macOS-amd64-snapshot
-    - pkl-doc-linux-amd64-snapshot
-    - pkl-doc-macOS-aarch64-snapshot
-    - pkl-doc-linux-aarch64-snapshot
-    - pkl-doc-alpine-linux-amd64-snapshot
-    - pkl-doc-windows-amd64-snapshot
-    - publish-test-results
-    runs-on: ubuntu-latest
-    steps:
-    - name: Create app token
-      id: app-token
-      uses: actions/create-github-app-token@fee1f7d63c2ff003460e3d139729b119787bc349 # v2
-      with:
-        app-id: ${{ secrets.PKL_CI_CLIENT_ID }}
-        private-key: ${{ secrets.PKL_CI }}
-        owner: ${{ github.repository_owner }}
-    - name: Trigger pkl-lang.org build
-      env:
-        GH_TOKEN: ${{ steps.app-token.outputs.token }}
-        SOURCE_RUN: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
-      run: |-
-        gh workflow run \
-          --repo apple/pkl-lang.org \
-          --ref main \
-          --field source_run="${SOURCE_RUN}" \
-          main.yml

.github/workflows/release.yml

@@ -1,954 +0,0 @@
-# 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:
-  gradle-check:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  gradle-check-windows:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: check
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true check
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-check-windows
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-check-windows
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  bench:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: bench:jmh
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true bench:jmh
-  gradle-compatibility:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with: {}
-    - name: :pkl-gradle:build :pkl-gradle:compatibilityTestReleases
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true :pkl-gradle:build :pkl-gradle:compatibilityTestReleases
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-gradle-compatibility
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-gradle-compatibility
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  java-executables-release:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-        fetch-depth: 0
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - name: gradle build java executables
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-doc:build pkl-cli:build pkl-codegen-java:build pkl-codegen-kotlin:build
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-java
-        path: '*/build/executable/**/*'
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-java-executables-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-java-executables-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-macOS-amd64-release:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-amd64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-amd64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-amd64-release:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-amd64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-amd64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-macOS-aarch64-release:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-macOS-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-macOS-aarch64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-macOS-aarch64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-linux-aarch64-release:
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-linux-aarch64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-linux-aarch64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-linux-aarch64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-cli-alpine-linux-amd64-release:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true -Dpkl.musl=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-alpine-linux-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-alpine-linux-amd64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-alpine-linux-amd64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-cli-windows-amd64-release:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-cli:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-cli-windows-amd64
-        path: pkl-cli*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-cli-windows-amd64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-cli-windows-amd64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-macOS-amd64-release:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true -Dpkl.targetArch=amd64 "-Dpkl.native--native-compiler-path=${GITHUB_WORKSPACE}/.github/scripts/cc_macos_amd64.sh" pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-amd64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-amd64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-amd64-release:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-amd64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-amd64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-macOS-aarch64-release:
-    if: github.repository_owner == 'apple'
-    runs-on:
-    - self-hosted
-    - macos
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-macOS-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-macOS-aarch64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-macOS-aarch64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-linux-aarch64-release:
-    runs-on: ubuntu-24.04-arm
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - name: Install deps
-      run: dnf install -y git binutils gcc glibc-devel zlib-devel libstdc++-static glibc-langpack-en
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: aarch64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: Fix git ownership
-      run: git status || git config --system --add safe.directory "$GITHUB_WORKSPACE"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-linux-aarch64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-linux-aarch64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-linux-aarch64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-    container:
-      image: redhat/ubi8:8.10
-  pkl-doc-alpine-linux-amd64-release:
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: Install musl and zlib
-      run: |
-        set -e
-        mkdir -p ~/staticdeps/
-
-        ZLIB_VERSION="1.2.13"
-        MUSL_VERSION="1.2.5"
-
-        # install zlib
-        if [[ ! -f ~/staticdeps/include/zlib.h ]]; then
-          # Download zlib tarball and signature
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz" -o /tmp/zlib.tar.gz
-          curl -Lf "https://github.com/madler/zlib/releases/download/v${ZLIB_VERSION}/zlib-${ZLIB_VERSION}.tar.gz.asc" -o /tmp/zlib.tar.gz.asc
-
-          # Import zlib GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 5ED46A6721D365587791E2AA783FCD8E58BCAFBA
-
-          # Verify GPG signature
-          echo "Verifying zlib GPG signature..."
-          gpg --verify /tmp/zlib.tar.gz.asc /tmp/zlib.tar.gz
-
-          mkdir -p "/tmp/dep_zlib-${ZLIB_VERSION}"
-          cd "/tmp/dep_zlib-${ZLIB_VERSION}"
-          # shellcheck disable=SC2002
-          cat /tmp/zlib.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "zlib-${ZLIB_VERSION}: configure..." 
-          ./configure --static --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "zlib-${ZLIB_VERSION}: make..." 
-          make -s -j4
-
-          echo "zlib-${ZLIB_VERSION}: make install..." 
-          make -s install
-
-          rm -rf /tmp/dep_zlib-${ZLIB_VERSION}
-        fi
-
-        # install musl
-        if [[ ! -f ~/staticdeps/bin/x86_64-linux-musl-gcc ]]; then
-          # Download musl tarball and signature
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz" -o /tmp/musl.tar.gz
-          curl -Lf "https://musl.libc.org/releases/musl-${MUSL_VERSION}.tar.gz.asc" -o /tmp/musl.tar.gz.asc
-
-          # Import musl GPG key
-          gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 836489290BB6B70F99FFDA0556BCDB593020450F
-
-          # Verify GPG signature
-          echo "Verifying musl GPG signature..."
-          gpg --verify /tmp/musl.tar.gz.asc /tmp/musl.tar.gz
-
-          mkdir -p "/tmp/dep_musl-${MUSL_VERSION}"
-          cd "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # shellcheck disable=SC2002
-          cat /tmp/musl.tar.gz | tar --strip-components=1 -xzC .
-
-          echo "musl-${MUSL_VERSION}: configure..." 
-          ./configure --disable-shared --prefix="$HOME"/staticdeps > /dev/null
-
-          echo "musl-${MUSL_VERSION}: make..." 
-          make -s -j4
-
-          echo "musl-${MUSL_VERSION}: make install..." 
-          make -s install
-
-          rm -rf "/tmp/dep_musl-${MUSL_VERSION}"
-
-          # native-image expects to find an executable at this path.
-          ln -s ~/staticdeps/bin/musl-gcc ~/staticdeps/bin/x86_64-linux-musl-gcc
-        fi
-
-        echo "${HOME}/staticdeps/bin" >> "$GITHUB_PATH"
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true -Dpkl.musl=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-alpine-linux-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-alpine-linux-amd64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-alpine-linux-amd64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  pkl-doc-windows-amd64-release:
-    runs-on: windows-latest
-    env:
-      LANG: en_US.UTF-8
-      JAVA_HOME: /jdk
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - name: gradle buildNative
-      shell: bash
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true pkl-doc:buildNative
-    - name: Upload executable artifacts
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: executable-pkl-doc-windows-amd64
-        path: pkl-doc*/build/executable/**/*
-    - name: Upload Test Result XML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-xml-pkl-doc-windows-amd64-release
-        path: '**/build/test-results/**/*.xml'
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-pkl-doc-windows-amd64-release
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  deploy-release:
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - bench
-    - gradle-compatibility
-    - java-executables-release
-    - pkl-cli-macOS-amd64-release
-    - pkl-cli-linux-amd64-release
-    - pkl-cli-macOS-aarch64-release
-    - pkl-cli-linux-aarch64-release
-    - pkl-cli-alpine-linux-amd64-release
-    - pkl-cli-windows-amd64-release
-    - pkl-doc-macOS-amd64-release
-    - pkl-doc-linux-amd64-release
-    - pkl-doc-macOS-aarch64-release
-    - pkl-doc-linux-aarch64-release
-    - pkl-doc-alpine-linux-amd64-release
-    - pkl-doc-windows-amd64-release
-    runs-on: ubuntu-latest
-    env:
-      LANG: en_US.UTF-8
-    environment: maven-release
-    steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
-      with:
-        java-version: '25'
-        distribution: temurin
-        architecture: x64
-    - uses: gradle/actions/setup-gradle@0723195856401067f7a2779048b490ace7a47d7c # v5
-      with:
-        cache-disabled: true
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      with:
-        persist-credentials: false
-    - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
-      with:
-        pattern: executable-**
-        merge-multiple: true
-    - env:
-        ORG_GRADLE_PROJECT_signingKeyId: ${{ secrets.ORG_GRADLE_PROJECT_SIGNINGKEYID }}
-        ORG_GRADLE_PROJECT_signingKey: ${{ secrets.ORG_GRADLE_PROJECT_SIGNINGKEY }}
-        ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.ORG_GRADLE_PROJECT_SIGNINGPASSWORD }}
-        ORG_GRADLE_PROJECT_sonatypePassword: ${{ secrets.ORG_GRADLE_PROJECT_SONATYPEPASSWORD }}
-        ORG_GRADLE_PROJECT_sonatypeUsername: ${{ secrets.ORG_GRADLE_PROJECT_SONATYPEUSERNAME }}
-      run: ./gradlew --info --stacktrace --no-daemon -DpklMultiJdkTesting=true -DreleaseBuild=true publishToSonatype closeAndReleaseSonatypeStagingRepository
-  github-release:
-    needs: deploy-release
-    permissions:
-      contents: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
-      with:
-        pattern: executable-**
-        merge-multiple: true
-    - name: Publish release on GitHub
-      env:
-        GH_TOKEN: ${{ github.token }}
-        TAG_NAME: ${{ github.ref_name }}
-        GIT_SHA: ${{ github.sha }}
-        GH_REPO: ${{ github.repository }}
-      run: |-
-        # exclude build_artifacts.txt from publish
-        rm -f */build/executable/*.build_artifacts.txt
-        find */build/executable/* -type d | xargs rm -rf
-        gh release create ${TAG_NAME} \
-          --title "${TAG_NAME}" \
-          --target "${GIT_SHA}" \
-          --verify-tag \
-          --notes "Release notes: https://pkl-lang.org/main/current/release-notes/changelog.html#release-${TAG_NAME}" \
-          */build/executable/*
-  publish-test-results:
-    if: '!cancelled()'
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - gradle-compatibility
-    - java-executables-release
-    - pkl-cli-macOS-amd64-release
-    - pkl-cli-linux-amd64-release
-    - pkl-cli-macOS-aarch64-release
-    - pkl-cli-linux-aarch64-release
-    - pkl-cli-alpine-linux-amd64-release
-    - pkl-cli-windows-amd64-release
-    - pkl-doc-macOS-amd64-release
-    - pkl-doc-linux-amd64-release
-    - pkl-doc-macOS-aarch64-release
-    - pkl-doc-linux-aarch64-release
-    - pkl-doc-alpine-linux-amd64-release
-    - pkl-doc-windows-amd64-release
-    permissions:
-      checks: write
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
-      with:
-        pattern: test-results-xml-*
-    - name: Publish test results
-      if: '!cancelled()'
-      uses: EnricoMi/publish-unit-test-result-action@c950f6fb443cb5af20a377fd0dfaa78838901040 # v2
-      with:
-        comment_mode: 'off'
-        files: test-results-xml-*/**/*.xml
-    - name: Upload Test Result HTML
-      if: '!cancelled()'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
-      with:
-        name: test-results-html-publish-test-results
-        path: '**/build/reports/tests/**/*'
-        if-no-files-found: ignore
-  trigger-downstream-builds:
-    if: github.repository_owner == 'apple'
-    needs:
-    - gradle-check
-    - gradle-check-windows
-    - bench
-    - gradle-compatibility
-    - java-executables-release
-    - pkl-cli-macOS-amd64-release
-    - pkl-cli-linux-amd64-release
-    - pkl-cli-macOS-aarch64-release
-    - pkl-cli-linux-aarch64-release
-    - pkl-cli-alpine-linux-amd64-release
-    - pkl-cli-windows-amd64-release
-    - pkl-doc-macOS-amd64-release
-    - pkl-doc-linux-amd64-release
-    - pkl-doc-macOS-aarch64-release
-    - pkl-doc-linux-aarch64-release
-    - pkl-doc-alpine-linux-amd64-release
-    - pkl-doc-windows-amd64-release
-    - deploy-release
-    - github-release
-    - publish-test-results
-    runs-on: ubuntu-latest
-    steps:
-    - name: Create app token
-      id: app-token
-      uses: actions/create-github-app-token@fee1f7d63c2ff003460e3d139729b119787bc349 # v2
-      with:
-        app-id: ${{ secrets.PKL_CI_CLIENT_ID }}
-        private-key: ${{ secrets.PKL_CI }}
-        owner: ${{ github.repository_owner }}
-    - name: Trigger pkl-lang.org build
-      env:
-        GH_TOKEN: ${{ steps.app-token.outputs.token }}
-        SOURCE_RUN: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
-      run: |-
-        gh workflow run \
-          --repo apple/pkl-lang.org \
-          --ref main \
-          --field source_run="${SOURCE_RUN}" \
-          main.yml

.github/workflows/test_report.yml

@@ -1,34 +0,0 @@
-# Generated from Workflow.pkl. DO NOT EDIT.
-name: PR Test Reports
-'on':
-  workflow_run:
-    types:
-    - completed
-    workflows:
-    - Pull Request
-permissions:
-  contents: read
-jobs:
-  test-results:
-    name: Test Results
-    if: github.event.workflow_run.conclusion == 'success' || github.event.workflow_run.conclusion == 'failure'
-    permissions:
-      actions: read
-      checks: write
-    runs-on: ubuntu-latest
-    steps:
-    - name: Download artifacts
-      uses: dawidd6/action-download-artifact@ac66b43f0e6a346234dd65d4d0c8fbb31cb316e5 # v11
-      with:
-        path: artifacts
-        name: test-results-.*
-        name_is_regexp: true
-        run_id: ${{ github.event.workflow_run.id }}
-    - name: Publish test results
-      uses: EnricoMi/publish-unit-test-result-action@c950f6fb443cb5af20a377fd0dfaa78838901040 # v2
-      with:
-        commit: ${{ github.event.workflow_run.head_sha }}
-        comment_mode: 'off'
-        files: artifacts/**/*.xml
-        event_file: artifacts/test-results-event-file/event.json
-        event_name: ${{ github.event.workflow_run.event }}

.gitignore

@@ -5,7 +5,6 @@
 .gradle/
 build/
 generated/
-testgenerated/
 
 # IntelliJ
 .idea/
@@ -15,10 +14,11 @@ testgenerated/
 !.idea/runConfigurations/
 !.idea/scopes/
 !.idea/vcs.xml
-.intellijPlatform/
 
 .vscode/
 
 .pkl-lsp/
 
-.kotlin/
+# :pkl-core:makeIntelliJAntlrPluginHappy
+gen/
+PklLexer.tokens

.idea/codeStyles/Project.xml

@@ -63,7 +63,6 @@
       </option>
       <option name="IMPORT_LAYOUT_TABLE">
         <value>
-          <package name="" withSubpackages="true" static="false" module="true" />
           <package name="" withSubpackages="true" static="true" />
           <emptyLine />
           <package name="" withSubpackages="true" static="false" />

.idea/inspectionProfiles/Project_Default.xml

@@ -12,27 +12,6 @@
       <option name="REPORT_FIELDS" value="true" />
     </inspection_tool>
     <inspection_tool class="ClassCanBeRecord" enabled="false" level="WEAK WARNING" enabled_by_default="false" />
-    <inspection_tool class="CustomRegExpInspection" enabled="true" level="WARNING" enabled_by_default="true">
-      <option name="myConfigurations">
-        <list>
-          <RegExpInspectionConfiguration>
-            <option name="name" value="PklCliDirectProjectEvaluatorSettingsAccess" />
-            <option name="suppressId" value="PklCliDirectProjectEvaluatorSettingsAccess" />
-            <option name="uuid" value="dd497f47-d38f-3fab-9ed7-eabe699620c8" />
-            <option name="patterns">
-              <list>
-                <InspectionPattern>
-                  <option name="regExp" value="project\?\.evaluatorSettings" />
-                  <option name="_fileType" value="Kotlin" />
-                  <option name="searchContext" value="ANY" />
-                  <option name="replacement" value="evaluatorSettings" />
-                </InspectionPattern>
-              </list>
-            </option>
-          </RegExpInspectionConfiguration>
-        </list>
-      </option>
-    </inspection_tool>
     <inspection_tool class="FieldMayBeFinal" enabled="true" level="INFORMATION" enabled_by_default="true">
       <scope name="AllExceptTruffleAst" level="WARNING" enabled="true" />
     </inspection_tool>
@@ -94,6 +73,5 @@
       <option name="processLiterals" value="true" />
       <option name="processComments" value="true" />
     </inspection_tool>
-    <inspection_tool class="dd497f47-d38f-3fab-9ed7-eabe699620c8" enabled="true" level="ERROR" enabled_by_default="true" editorAttributes="ERRORS_ATTRIBUTES" />
   </profile>
 </component>

.java-version

@@ -1 +1 @@
-21
+17.0

.mailmap

@@ -1,2 +0,0 @@
-Jen Basch <421772+HT154@users.noreply.github.com>
-Jen Basch <jbasch@apple.com>

DEVELOPMENT.adoc

@@ -2,22 +2,23 @@
 :uri-gng: https://gng.dsun.org
 :uri-jenv: https://www.jenv.be
 :uri-intellij: https://www.jetbrains.com/idea/download/
+:uri-jdk: https://adoptopenjdk.net/releases.html?variant=openjdk17
 :uri-native-prerequisites-linux: https://www.graalvm.org/latest/getting-started/linux/#prerequisites-for-native-image-on-linux
 :uri-native-prerequisites-windows: https://www.graalvm.org/latest/getting-started/windows/#prerequisites-for-native-image-on-windows
 
 == Setup
 
-. (mandatory) Install a JDK (JDK 21+ required).
+. (mandatory) Install {uri-jdk}[OpenJDK 17] or higher
 . (recommended) Install {uri-intellij}[IntelliJ IDEA] +
 To import the project into IntelliJ, go to File->Open and select the project's root directory.
 If the project is opened but not imported, look for a popup in the lower right corner
 and click its "Import Gradle Project" link.
 . (recommended) Install {uri-gng}[gng] +
-_gng_ enables you to run Gradle commands with `gw` (instead of `./gradlew`) from any subdirectory.
+_gng_ enables to run Gradle commands with `gw` (instead of `./gradlew`) from any subdirectory.
 . (recommended) Set up Git ignore-revs +
 `git config blame.ignoreRevsFile .git-blame-ignore-revs`
 . (recommended) Install {uri-jenv}[jenv] and plugins +
-_jenv_ uses specific JDK versions in certain subdirectories. _Pkl_ comes with a `.java-version` file specifying JDK 21. +
+_jenv_ use specific JDK versions in certain subdirectories. _Pkl_ comes with a `.java-version` file specifying JDK 17. +
 Enable _jenv_ plugins for better handling by `gradle`:
 +
 [source,shell]
@@ -46,10 +47,11 @@ install {uri-native-prerequisites-windows}[Prerequisites For Native Image on Win
 ----
 gw clean
 gw test          # run all tests except native executable tests
+gw testNative    # run native executable tests
 gw spotlessApply # fix code formatting
 gw build         # build everything except native executables
-gw pkl-cli:testNative   # run native executable tests
+gw buildNative   # build native executable(s) for current platform
-gw pkl-cli:buildNative  # build native executable for current platform
+                 # (Alpine executable is only built if ~/staticdeps/bin/musl-gcc exists)
 
 pkl-cli/build/executable/jpkl                   # run Java executable
 pkl-cli/build/executable/pkl-macos-aarch64      # run Mac executable
@@ -74,12 +76,16 @@ gw wrapper --gradle-version [version] --gradle-distribution-sha256-sum [sha]
 
 . (optional) Update _gradle/libs.version.toml_
 based on version information from https://search.maven.org, https://plugins.gradle.org, and GitHub repos
+. Run `gw updateDependencyLocks`
 . Validate changes with `gw build buildNative`
+. Review and commit the updated dependency lock files
 
 == Code Generation
 
 * Truffle code generation is performed by Truffle's annotation processor, which runs as part of task `:pkl-core:compileJava`
 ** Output dir is `generated/truffle/`
+* ANTLR code generation is performed by task `:pkl-core:generateGrammarSource`
+** Output dir is `generated/antlr/`
 
 == Remote JVM Debugging
 
@@ -88,27 +94,26 @@ This will listen on port 5005.
 
 Example: `./gradlew test -Djvmdebug=true`
 
-== Snippet Test Plugin
-
-There is an IntelliJ plugin meant for development on the Pkl project itself located in https://github.com/apple/pkl-project-commons[pkl-project-commons].
-
-See https://github.com/apple/pkl-project-commons?tab=readme-ov-file#internal-intellij-plugin[its readme] for instructions on how to set it up.
-
 == Resources
+For automated build setup examples see our https://github.com/apple/pkl/blob/main/.circleci/[CircleCI] jobs like our https://github.com/apple/pkl/blob/main/.circleci/jobs/BuildNativeJob.pkl[BuildNativeJob.pkl], where we build Pkl automatically.
 
-For automated build setup examples see our https://github.com/apple/pkl/blob/main/.github/[GitHub Actions] jobs like our https://github.com/apple/pkl/blob/main/.github/jobs/BuildNativeJob.pkl[BuildNativeJob.pkl], where we build Pkl automatically.
+=== ANTLR
+
+* https://github.com/antlr/antlr4/blob/master/doc/index.md[Documentation]
+* https://groups.google.com/forum/#!forum/antlr-discussion[Forums]
+* https://github.com/mobileink/lab.clj.antlr/tree/main/doc[Some third-party docs]
 
 === Truffle
 
 * http://ssw.jku.at/Research/Projects/JVM/Truffle.html[Homepage]
 * https://github.com/graalvm/truffle[GitHub]
 * http://lafo.ssw.uni-linz.ac.at/javadoc/truffle/latest/[Javadoc]
-* https://mail.openjdk.org/pipermail/graal-dev/[Mailing List]
+* http://mail.openjdk.java.net/pipermail/graal-dev/[Mailing List]
 * https://medium.com/@octskyward/graal-truffle-134d8f28fb69#.2db370y2g[Graal & Truffle (Article)]
 * https://comserv.cs.ut.ee/home/files/Pool_ComputerScience_2016.pdf?study=ATILoputoo&reference=6319668E7151D556131810BC3F4A627D7FEF5F3B[Truffle Overview (see chapter 1)]
 * https://gist.github.com/smarr/d1f8f2101b5cc8e14e12[Truffle: Languages and Material]
 * https://github.com/smarr/truffle-notes[Truffle Notes]
-* https://www.graalvm.org/latest/graalvm-as-a-platform/language-implementation-framework/[Truffle Language Implementation Framework]
+* https://wiki.openjdk.java.net/display/Graal/Truffle+FAQ+and+Guidelines[Truffle FAQ]
 
 === Other Config Languages
 

MAINTAINERS.adoc

@@ -8,5 +8,4 @@ See link:CONTRIBUTING.adoc[] for general contribution guidelines.
 
 * https://github.com/bioball[Daniel Chao]
 * https://github.com/stackoverflow[Islon Scherer]
-* https://github.com/HT154[Jen Basch]
 * https://github.com/holzensp[Philip Hölzenspies]

NOTICE.txt

@@ -1,4 +1,4 @@
-Copyright © 2024-2026 Apple Inc. and the Pkl project authors
+Copyright © 2024-2025 Apple Inc. and the Pkl project authors
 
 
 Portions of this software were originally based on 'SnakeYAML' developed by Andrey Somov.

README.adoc

@@ -12,7 +12,7 @@
 :uri-installation: https://pkl-lang.org/main/current/pkl-cli/index.html#installation
 :uri-lang-reference: https://pkl-lang.org/main/current/language-reference/index.html
 :uri-ci-artifacts: https://s01.oss.sonatype.org/content/groups/public/org/pkl-lang/
-:uri-ci-pipeline: https://github.com/apple/pkl/actions
+:uri-ci-pipeline: https://app.circleci.com/pipelines/github/apple/pkl
 
 A configuration as code language with rich validation and tooling.
 
@@ -37,10 +37,7 @@ We'd love to hear from you!
 * Create an {uri-github-issue}[issue]
 * Ask a question on {uri-github-discussions}[GitHub Discussions]
 
-== Development
+== Development image:https://circleci.com/gh/apple/pkl.svg?style=svg["Apple", link="https://app.circleci.com/pipelines/github/apple/pkl"]
-
-image:https://github.com/apple/pkl/actions/workflows/main.yml/badge.svg?style=svg["Build (main)", link="https://github.com/apple/pkl/actions/workflows/main.yml"]
-
 * link:CONTRIBUTING.adoc[] for tips on pull requests and filing issues
 * link:DEVELOPMENT.adoc[] for build instructions
 * {uri-ci-artifacts}[Sonatype Repository] for the artifacts/binaries built by our {uri-ci-pipeline}[CI pipelines] (and those of our other tools and packages repositories).
@@ -63,9 +60,6 @@ image:https://github.com/apple/pkl/actions/workflows/main.yml/badge.svg?style=sv
 |https://github.com/apple/pkl-go-examples[`apple/pkl-go-examples`]
 |Examples for using Pkl within Go applications
 
-|https://github.com/apple/highlightjs-pkl[`apple/highlightjs-pkl`]
-|Highlight.js syntax highlighting for Pkl
-
 |https://github.com/apple/pkl-intellij[`apple/pkl-intellij`]
 |JetBrains editor plugins providing Pkl language support
 
@@ -82,7 +76,7 @@ image:https://github.com/apple/pkl/actions/workflows/main.yml/badge.svg?style=sv
 |The pkl-lang.org website
 
 |https://github.com/apple/pkl-lsp[`apple/pkl-lsp`]
-|Language server for Pkl, implementing the server-side of the Language Server Protocol
+| Language server for Pkl, implementing the server-side of the Language Server Protocol
 
 |https://github.com/apple/pkl-neovim[`apple/pkl-neovim`]
 |Pkl language support for Neovim
@@ -96,9 +90,6 @@ image:https://github.com/apple/pkl/actions/workflows/main.yml/badge.svg?style=sv
 |https://github.com/apple/pkl-project-commons[`apple/pkl-project-commons`]
 |Utility libraries for Pkl
 
-|https://github.com/apple/pkl-readers[`apple/pkl-readers`]
-|Shared Pkl https://pkl-lang.org/main/current/language-reference/index.html#external-readers[external reader] tools
-
 |https://github.com/apple/pkl-spring[`apple/pkl-spring`]
 |Spring Boot extension for configuring Boot apps with Pkl
 
@@ -114,9 +105,9 @@ image:https://github.com/apple/pkl/actions/workflows/main.yml/badge.svg?style=sv
 |https://github.com/apple/pkl.tmbundle[`apple/pkl.tmbundle`]
 |TextMate bundle for Pkl
 
+|https://github.com/apple/rules_pkl[`apple/rules_pkl`]
+| Bazel build rules for Pkl
+
 |https://github.com/apple/tree-sitter-pkl[`apple/tree-sitter-pkl`]
 |Tree-sitter parser for Pkl
-
-|https://github.com/apple/rules_pkl[`apple/rules_pkl`]
-|Bazel build rules for Pkl
 |===

THIRD-PARTY-NOTICES.txt

@@ -26,7 +26,18 @@ Copyright © 2017 Square, Inc.
 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 http://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.
 
-4) GeantyRef (https://github.com/leangen/geantyref)
+4) ANTLR 4 Runtime (Optimized) (http://tunnelvisionlabs.com)
+POM License: The BSD License - http://www.antlr.org/license.html
+
+Copyright (c) 2012 Terence Parr and Sam Harwell
+All rights reserved.
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+Neither the name of the author nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+5) GeantyRef (https://github.com/leangen/geantyref)
 Manifest license URL: https://www.apache.org/licenses/LICENSE-2.0
 
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
@@ -36,7 +47,7 @@ Copyright © 2017 Kaqqao
 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 http://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.
 
-5) commonmark-java core
+6) commonmark-java core
 POM License: The 2-Clause BSD License - https://opensource.org/licenses/BSD-2-Clause
 
 Embedded license: 
@@ -67,7 +78,7 @@ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-6) commonmark-java extension for tables
+7) commonmark-java extension for tables
 POM License: The 2-Clause BSD License - https://opensource.org/licenses/BSD-2-Clause
 
 Embedded license: 
@@ -98,7 +109,7 @@ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-7) jansi (http://fusesource.com/)
+8) jansi (http://fusesource.com/)
 Manifest license URL: https://www.apache.org/licenses/LICENSE-2.0
 
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
@@ -108,13 +119,13 @@ Copyright © Fusesource 2023
 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 http://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.
 
-8) Graal Sdk (https://github.com/oracle/graal)
+9) Graal Sdk (https://github.com/oracle/graal)
 POM License: Universal Permissive License, Version 1.0 - http://opensource.org/licenses/UPL
 
-9) Truffle API (http://openjdk.java.net/projects/graal)
+10) Truffle API (http://openjdk.java.net/projects/graal)
 POM License: Universal Permissive License, Version 1.0 - http://opensource.org/licenses/UPL
 
-10) IntelliJ IDEA Annotations (http://www.jetbrains.org)
+11) IntelliJ IDEA Annotations (http://www.jetbrains.org)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -122,7 +133,7 @@ Copyright © Jetbrains 2023
 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 http://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.
 
-11) kotlin-reflect (https://kotlinlang.org/)
+12) kotlin-reflect (https://kotlinlang.org/)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -130,7 +141,7 @@ Copyright © Wuseal 2018
 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 http://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.
 
-12) kotlin-stdlib (https://kotlinlang.org/)
+13) kotlin-stdlib (https://kotlinlang.org/)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -138,7 +149,7 @@ Copyright © 2010-2023 JetBrains s.r.o. and Kotlin Programming Language contribu
 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 http://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.
 
-13) kotlin-stdlib-common (https://kotlinlang.org/)
+14) kotlin-stdlib-common (https://kotlinlang.org/)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -146,7 +157,7 @@ Copyright © 2023 Kotlin Team
 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 http://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.
 
-14) kotlin-stdlib-jdk7 (https://kotlinlang.org/)
+15) kotlin-stdlib-jdk7 (https://kotlinlang.org/)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -154,7 +165,7 @@ Copyright © 2023 Kotlin Team
 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 http://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.
 
-15) kotlin-stdlib-jdk8 (https://kotlinlang.org/)
+16) kotlin-stdlib-jdk8 (https://kotlinlang.org/)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -162,7 +173,7 @@ Copyright © 2023 Kotlin Team
 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 http://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.
 
-16) kotlinx.html (https://github.com/Kotlin/kotlinx.html)
+17) kotlinx.html (https://github.com/Kotlin/kotlinx.html)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -170,7 +181,7 @@ Copyright © 2017 Yole
 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 http://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.
 
-17) kotlinx-serialization-core (https://github.com/Kotlin/kotlinx.serialization)
+18) kotlinx-serialization-core (https://github.com/Kotlin/kotlinx.serialization)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -178,7 +189,7 @@ The Apache License
 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 http://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.
 
-18) kotlinx-serialization-json (https://github.com/Kotlin/kotlinx.serialization)
+19) kotlinx-serialization-json (https://github.com/Kotlin/kotlinx.serialization)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -186,7 +197,7 @@ The Apache License
 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 http://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.
 
-19) JLine Reader
+20) JLine Reader
 Manifest license URL: https://opensource.org/licenses/BSD-3-Clause
 
 POM License: The 3-Clause BSD License - https://opensource.org/licenses/BSD-3-Clause
@@ -205,7 +216,7 @@ software without specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-20) JLine Terminal
+21) JLine Terminal
 Manifest license URL: https://opensource.org/licenses/BSD-3-Clause
 
 POM License: The 3-Clause BSD License - https://opensource.org/licenses/BSD-3-Clause
@@ -224,7 +235,7 @@ software without specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-21) JLine JANSI Terminal
+22) JLine JANSI Terminal
 Manifest license URL: https://opensource.org/licenses/BSD-3-Clause
 
 POM License: The 3-Clause BSD License - https://opensource.org/licenses/BSD-3-Clause
@@ -243,7 +254,7 @@ software without specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-22) msgpack-core (https://msgpack.org/)
+23) msgpack-core (https://msgpack.org/)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -251,7 +262,7 @@ Copyright © 2016 Sadayuki Furuhashi, Muga Nishizawa, Taro L. Saito, Mitsunori K
 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 http://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. 
 
-23) Paguro (https://github.com/GlenKPeterson/Paguro)
+24) Paguro (https://github.com/GlenKPeterson/Paguro)
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0
 
 The Apache License
@@ -353,7 +364,7 @@ Everyone is permitted to copy and distribute copies of this Agreement, but in or
 
 This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.
 
-24) SnakeYAML Engine (http://www.snakeyaml.org)
+25) SnakeYAML Engine (http://www.snakeyaml.org)
 Manifest license URL: https://www.apache.org/licenses/LICENSE-2.0
 
 POM License: Apache License, Version 2.0 - https://www.apache.org/licenses/LICENSE-2.0

bench/bench.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -14,18 +14,20 @@
  * limitations under the License.
  */
 plugins {
-  id("pklAllProjects")
+  pklAllProjects
-  id("pklJavaLibrary")
+  pklJavaLibrary
+  pklGraalVm
   id("me.champeau.jmh")
 }
 
 val truffle: Configuration by configurations.creating
 val graal: Configuration by configurations.creating
 
+@Suppress("UnstableApiUsage")
 dependencies {
   jmh(projects.pklCore)
-  jmh(projects.pklCommonsTest)
+  // necessary because antlr4-runtime is declared as implementation dependency in pkl-core.gradle
-  jmh(projects.pklParser)
+  jmh(libs.antlrRuntime)
   truffle(libs.truffleApi)
   graal(libs.graalCompiler)
 }

bench/gradle.lockfile

@@ -0,0 +1,44 @@
+# This is a Gradle generated file for dependency locking.
+# Manual edits can break the build and are not advised.
+# This file is expected to be part of source control.
+com.tunnelvisionlabs:antlr4-runtime:4.9.0=jmh,jmhCompileClasspath,jmhImplementationDependenciesMetadata,jmhRuntimeClasspath
+net.bytebuddy:byte-buddy:1.14.18=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+net.java.dev.jna:jna:5.6.0=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+net.sf.jopt-simple:jopt-simple:5.0.4=jmh,jmhCompileClasspath,jmhImplementationDependenciesMetadata,jmhRuntimeClasspath
+org.apache.commons:commons-math3:3.6.1=jmh,jmhCompileClasspath,jmhImplementationDependenciesMetadata,jmhRuntimeClasspath
+org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeOnlyDependenciesMetadata
+org.assertj:assertj-core:3.26.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.graalvm.compiler:compiler:23.0.6=graal
+org.graalvm.sdk:graal-sdk:23.0.6=graal,jmh,jmhRuntimeClasspath,truffle
+org.graalvm.truffle:truffle-api:23.0.6=graal,jmh,jmhRuntimeClasspath,truffle
+org.jetbrains.intellij.deps:trove4j:1.0.20200330=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-compiler-embeddable:1.7.10=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-daemon-embeddable:1.7.10=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-klib-commonizer-embeddable:1.7.10=kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-reflect:1.7.10=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-script-runtime:1.7.10=kotlinCompilerClasspath,kotlinCompilerPluginClasspathJmh,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-scripting-common:1.7.10=kotlinCompilerPluginClasspathJmh,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest
+org.jetbrains.kotlin:kotlin-scripting-compiler-embeddable:1.7.10=kotlinCompilerPluginClasspathJmh,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest
+org.jetbrains.kotlin:kotlin-scripting-compiler-impl-embeddable:1.7.10=kotlinCompilerPluginClasspathJmh,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest
+org.jetbrains.kotlin:kotlin-scripting-jvm:1.7.10=kotlinCompilerPluginClasspathJmh,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest
+org.jetbrains.kotlin:kotlin-stdlib-common:1.7.10=kotlinCompilerClasspath,kotlinCompilerPluginClasspathJmh,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest,kotlinKlibCommonizerClasspath,testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.7.10=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.7.10=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.jetbrains.kotlin:kotlin-stdlib:1.7.10=kotlinCompilerClasspath,kotlinCompilerPluginClasspathJmh,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest,kotlinKlibCommonizerClasspath,testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.jetbrains:annotations:13.0=kotlinCompilerClasspath,kotlinCompilerPluginClasspathJmh,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest,kotlinKlibCommonizerClasspath,testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.junit.jupiter:junit-jupiter-api:5.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.junit.jupiter:junit-jupiter-engine:5.11.3=testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.junit.jupiter:junit-jupiter-params:5.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.junit.platform:junit-platform-commons:1.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.junit.platform:junit-platform-engine:1.11.3=testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.junit:junit-bom:5.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.msgpack:msgpack-core:0.9.8=jmh,jmhRuntimeClasspath
+org.openjdk.jmh:jmh-core:1.37=jmh,jmhCompileClasspath,jmhImplementationDependenciesMetadata,jmhRuntimeClasspath
+org.openjdk.jmh:jmh-generator-asm:1.37=jmh,jmhCompileClasspath,jmhImplementationDependenciesMetadata,jmhRuntimeClasspath
+org.openjdk.jmh:jmh-generator-bytecode:1.37=jmh,jmhCompileClasspath,jmhImplementationDependenciesMetadata,jmhRuntimeClasspath
+org.openjdk.jmh:jmh-generator-reflection:1.37=jmh,jmhCompileClasspath,jmhImplementationDependenciesMetadata,jmhRuntimeClasspath
+org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.organicdesign:Paguro:3.10.3=jmh,jmhRuntimeClasspath
+org.ow2.asm:asm:9.0=jmh,jmhCompileClasspath,jmhImplementationDependenciesMetadata,jmhRuntimeClasspath
+org.snakeyaml:snakeyaml-engine:2.5=jmh,jmhRuntimeClasspath
+empty=annotationProcessor,apiDependenciesMetadata,compileClasspath,compileOnlyDependenciesMetadata,implementationDependenciesMetadata,intransitiveDependenciesMetadata,jmhAnnotationProcessor,jmhApiDependenciesMetadata,jmhCompileOnlyDependenciesMetadata,jmhIntransitiveDependenciesMetadata,jmhKotlinScriptDef,jmhKotlinScriptDefExtensions,jmhRuntimeOnlyDependenciesMetadata,kotlinCompilerPluginClasspath,kotlinNativeCompilerPluginClasspath,kotlinScriptDef,kotlinScriptDefExtensions,runtimeClasspath,runtimeOnlyDependenciesMetadata,sourcesJar,testAnnotationProcessor,testApiDependenciesMetadata,testCompileOnlyDependenciesMetadata,testIntransitiveDependenciesMetadata,testKotlinScriptDef,testKotlinScriptDefExtensions

bench/src/jmh/java/org/pkl/core/ListSort.java

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2025 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -23,7 +23,6 @@ import java.util.concurrent.TimeUnit;
 import org.openjdk.jmh.annotations.*;
 import org.openjdk.jmh.util.TempFile;
 import org.openjdk.jmh.util.TempFileManager;
-import org.pkl.core.evaluatorSettings.TraceMode;
 import org.pkl.core.http.HttpClient;
 import org.pkl.core.module.ModuleKeyFactories;
 import org.pkl.core.repl.ReplRequest;
@@ -52,8 +51,7 @@ public class ListSort {
           null,
           IoUtils.getCurrentWorkingDir(),
           StackFrameTransformers.defaultTransformer,
-          false,
+          false);
-          TraceMode.COMPACT);
   private static final List<Object> list = new ArrayList<>(100000);
 
   static {

bench/src/jmh/java/org/pkl/core/parser/ParserBenchmark.java

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2025 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -15,17 +15,8 @@
  */
 package org.pkl.core.parser;
 
-import java.io.IOException;
-import java.io.UncheckedIOException;
-import java.nio.file.Files;
 import java.util.concurrent.TimeUnit;
 import org.openjdk.jmh.annotations.*;
-import org.pkl.commons.test.FileTestUtils;
-import org.pkl.commons.test.FileTestUtilsKt;
-import org.pkl.core.Release;
-import org.pkl.core.util.IoUtils;
-import org.pkl.parser.Parser;
-import org.pkl.parser.ParserError;
 
 @SuppressWarnings("unused")
 @Warmup(iterations = 5, time = 2)
@@ -33,33 +24,37 @@ import org.pkl.parser.ParserError;
 @OutputTimeUnit(TimeUnit.SECONDS)
 @Fork(1)
 public class ParserBenchmark {
+  // One-time execution of this code took ~10s until moving rule alternative
+  // for parenthesized expression after alternative for anonymous function.
   @Benchmark
-  public void parseStdlib() {
+  public void run() {
-    for (var stdlibModule : Release.current().standardLibrary().modules()) {
+    new Parser()
-      try {
+        .parseModule(
-        var moduleSource =
+            """
-            IoUtils.readClassPathResourceAsString(
+            a1 {
-                getClass(), "/org/pkl/core/stdlib/%s.pkl".formatted(stdlibModule.substring(4)));
+              a2 {
-        new Parser().parseModule(moduleSource);
+                a3 {
-      } catch (IOException e) {
+                  a4 {
-        throw new UncheckedIOException(e);
+                    a5 {
+                      a6 {
+                        a7 {
+                          a8 {
+                            a9 {
+                              a10 {
+                                a11 {
+                                  a12 {
+                                    a13 = map(map(map((x) -> 1)))
                                   }
                                 }
                               }
-
-  @Benchmark
-  public void parseSnippetTests() {
-    var snippetTestDir =
-        FileTestUtils.getRootProjectDir()
-            .resolve("pkl-core/src/test/files/LanguageSnippetTests/input");
-    for (var snippet : FileTestUtilsKt.listFilesRecursively(snippetTestDir)) {
-      try {
-        var moduleSource = Files.readString(snippet);
-        new Parser().parseModule(moduleSource);
-      } catch (IOException e) {
-        throw new UncheckedIOException(e);
-      } catch (ParserError ignore) {
                             }
                           }
                         }
+                      }
+                    }
+                  }
+                }
+              }
+            }""");
+  }
 }

build-logic/src/main/kotlin/BuildInfo.kt

@@ -1,427 +0,0 @@
-/*
- * Copyright © 2024-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.
- */
-@file:Suppress("MemberVisibilityCanBePrivate")
-
-import java.io.File
-import org.gradle.api.Project
-import org.gradle.api.artifacts.VersionCatalog
-import org.gradle.api.artifacts.VersionCatalogsExtension
-import org.gradle.api.attributes.Category
-import org.gradle.api.provider.Provider
-import org.gradle.api.tasks.TaskProvider
-import org.gradle.api.tasks.testing.Test
-import org.gradle.internal.extensions.stdlib.capitalized
-import org.gradle.jvm.toolchain.*
-import org.gradle.kotlin.dsl.*
-import org.gradle.kotlin.dsl.support.serviceOf
-import org.gradle.process.CommandLineArgumentProvider
-
-/**
- * JVM bytecode target; this is pinned at a reasonable version, because downstream JVM projects
- * which consume Pkl will need a minimum bytecode level at or above this one.
- *
- * Kotlin and Java need matching bytecode targets, so this is expressed as a build setting and
- * constant default. To override, pass `-DpklJdkToolchain=X` to the Gradle command line, where X is
- * a major Java version.
- */
-const val PKL_JVM_TARGET_DEFAULT_MAXIMUM = 17
-
-/**
- * The Pkl build requires JDK 25+; otherwise, NullAway will not work correctly.
- *
- * This is a build-time requirement, not a runtime requirement. To avoid the provisioning of
- * multiple JDKs and other build issues, keep this value in sync with the JVM toolchain versions in
- * `build-logic/build.gradle.kts` and `gradle-daemon-jvm.properties`.
- */
-const val PKL_JDK_VERSION_MIN = 25
-
-/**
- * The JDK minimum is set to match the bytecode minimum, to guarantee that fat JARs work against the
- * earliest supported bytecode target.
- */
-const val PKL_TEST_JDK_MINIMUM = PKL_JVM_TARGET_DEFAULT_MAXIMUM
-
-/**
- * Maximum JDK version which Pkl is tested with; this should be bumped when new JDK releases are
- * issued.
- */
-const val PKL_TEST_JDK_MAXIMUM = 26
-
-/**
- * If `true`, all JDK releases between [PKL_TEST_JDK_MINIMUM] and [PKL_TEST_JDK_MAXIMUM] are tested.
- * If `false`, only LTS releases within that range are tested. To override, pass
- * `-DpklTestAllJdks=true` on the Gradle command line.
- */
-const val PKL_TEST_ALL_JDKS = false
-
-// `buildInfo` in main build scripts
-// `project.extensions.getByType<BuildInfo>()` in precompiled script plugins
-open class BuildInfo(private val project: Project) {
-  inner class GraalVm(val arch: String) {
-    val homeDir: String by lazy {
-      System.getenv("GRAALVM_HOME") ?: "${System.getProperty("user.home")}/.graalvm"
-    }
-
-    val version: String by lazy { libs.findVersion("graalVm").get().toString() }
-
-    val graalVmJdkVersion: String by lazy { libs.findVersion("graalVmJdkVersion").get().toString() }
-
-    val osName: String by lazy {
-      when {
-        os.isMacOsX -> "macos"
-        os.isLinux -> "linux"
-        os.isWindows -> "windows"
-        else -> throw RuntimeException("${os.familyName} is not supported.")
-      }
-    }
-
-    val baseName: String by lazy {
-      "graalvm-community-jdk-${graalVmJdkVersion}_${osName}-${arch}_bin"
-    }
-
-    val downloadUrl: String by lazy {
-      val extension = if (os.isWindows) "zip" else "tar.gz"
-      "https://github.com/graalvm/graalvm-ce-builds/releases/download/jdk-${graalVmJdkVersion}/$baseName.$extension"
-    }
-
-    val downloadFile: File by lazy {
-      val extension = if (os.isWindows) "zip" else "tar.gz"
-      File(homeDir, "${baseName}.$extension")
-    }
-
-    val installDir: File by lazy { File(homeDir, baseName) }
-
-    val baseDir: String by lazy {
-      if (os.isMacOsX) "$installDir/Contents/Home" else installDir.toString()
-    }
-  }
-
-  /** The target architecture to build, defaulting to the system architecture. */
-  val targetArch by lazy { System.getProperty("pkl.targetArch") ?: arch }
-
-  /** Tells if this is a cross-arch build (e.g. targeting amd64 when on an aarch64 machine). */
-  val isCrossArch by lazy { arch != targetArch }
-
-  /** Tells if cross-arch builds are supported on this machine. */
-  val isCrossArchSupported by lazy { os.isMacOsX }
-
-  /** Whether to build native executables using the musl toolchain or not. */
-  val musl: Boolean by lazy { java.lang.Boolean.getBoolean("pkl.musl") }
-
-  /** Same logic as [org.gradle.internal.os.OperatingSystem#arch], which is protected. */
-  val arch: String by lazy {
-    when (val arch = System.getProperty("os.arch")) {
-      "x86" -> "i386"
-      "x86_64" -> "amd64"
-      "powerpc" -> "ppc"
-      else -> arch
-    }
-  }
-
-  val graalVmAarch64: GraalVm = GraalVm("aarch64")
-
-  val graalVmAmd64: GraalVm = GraalVm("x64")
-
-  val isCiBuild: Boolean by lazy { System.getenv("CI") != null }
-
-  val isReleaseBuild: Boolean by lazy { java.lang.Boolean.getBoolean("releaseBuild") }
-
-  val isNativeArch: Boolean by lazy { java.lang.Boolean.getBoolean("nativeArch") }
-
-  val jvmTarget: Int by lazy {
-    System.getProperty("pklJvmTarget")?.toInt() ?: PKL_JVM_TARGET_DEFAULT_MAXIMUM
-  }
-
-  // JPMS exports for Truffle; needed on some versions of Java, and transitively within some JARs.
-  private val jpmsExports =
-    arrayOf(
-      "org.graalvm.truffle/com.oracle.truffle.api.exception=ALL-UNNAMED",
-      "org.graalvm.truffle/com.oracle.truffle.api=ALL-UNNAMED",
-      "org.graalvm.truffle/com.oracle.truffle.api.nodes=ALL-UNNAMED",
-      "org.graalvm.truffle/com.oracle.truffle.api.source=ALL-UNNAMED",
-    )
-
-  // Extra JPMS modules forced onto the module path via `--add-modules` in some cases.
-  private val jpmsAddModules = arrayOf("jdk.unsupported")
-
-  // Formats `jpmsExports` for use in JAR manifest attributes.
-  val jpmsExportsForJarManifest: String by lazy {
-    jpmsExports.joinToString(" ") { it.substringBefore("=") }
-  }
-
-  // Formats `jpmsExports` for use on the command line with `--add-exports`.
-  val jpmsExportsForAddExportsFlags: Collection<String> by lazy {
-    jpmsExports.map { "--add-exports=$it" }
-  }
-
-  // Formats `jpmsAddModules` for use on the command line with `--add-modules`.
-  val jpmsAddModulesFlags: Collection<String> by lazy { jpmsAddModules.map { "--add-modules=$it" } }
-
-  // JVM properties to set during testing.
-  val testProperties =
-    mapOf<String, Any>(
-      // @TODO: this should be removed once pkl supports JPMS as a true Java Module.
-      "polyglotimpl.DisableClassPathIsolation" to true
-    )
-
-  val jdkVendor: JvmVendorSpec = JvmVendorSpec.ADOPTIUM
-
-  val jdkToolchainVersion: JavaLanguageVersion by lazy {
-    JavaLanguageVersion.of(System.getProperty("pklJdkToolchain")?.toInt() ?: PKL_JDK_VERSION_MIN)
-  }
-
-  val jdkTestFloor: JavaLanguageVersion by lazy { JavaLanguageVersion.of(PKL_TEST_JDK_MINIMUM) }
-
-  val jdkTestCeiling: JavaLanguageVersion by lazy { JavaLanguageVersion.of(PKL_TEST_JDK_MAXIMUM) }
-
-  val testAllJdks: Boolean by lazy {
-    // By default, Pkl is tested against LTS JDK releases within the bounds of `PKL_TEST_JDK_TARGET`
-    // and `PKL_TEST_JDK_MAXIMUM`. To test against the full suite of JDK versions, past and present,
-    // set `-DpklTestAllJdks=true` on the Gradle command line. This results in non-LTS releases, old
-    // releases, and "experimental releases" (newer than the toolchain version) being included in
-    // the default `check` suite.
-    System.getProperty("pklTestAllJdks")?.toBoolean() ?: PKL_TEST_ALL_JDKS
-  }
-
-  val testExperimentalJdks: Boolean by lazy {
-    System.getProperty("pklTestFutureJdks")?.toBoolean() ?: false
-  }
-
-  val testJdkVendors: Sequence<JvmVendorSpec> by lazy {
-    // By default, only Adoptium is tested during multi-JDK testing. Flip `-DpklTestAllVendors=true`
-    // to additionally test against GraalVM and Oracle.
-    when (System.getProperty("pklTestAllVendors")?.toBoolean()) {
-      true -> sequenceOf(JvmVendorSpec.ADOPTIUM, JvmVendorSpec.GRAAL_VM, JvmVendorSpec.ORACLE)
-      else -> sequenceOf(JvmVendorSpec.ADOPTIUM)
-    }
-  }
-
-  private val isArmWindows: Boolean
-    get() {
-      if (!os.isWindows) {
-        return false
-      }
-      // System.getProperty("os.arch") returns the architecture of the JVM, not the host OS.
-      val procArch = System.getenv("PROCESSOR_ARCHITECTURE")
-      return "ARM64".equals(procArch, ignoreCase = true)
-    }
-
-  // Assembles a collection of JDK versions which tests can be run against, considering ancillary
-  // parameters like `testAllJdks` and `testExperimentalJdks`.
-  val jdkTestRange: Collection<JavaLanguageVersion> by lazy {
-    if (isArmWindows) {
-      // Java toolchains does not work on ARM windows: https://github.com/gradle/gradle/issues/29807
-      // prevent creating tasks to test different JDKs if developing on a Windows ARM machine.
-      return@lazy listOf()
-    }
-    JavaVersionRange.inclusive(jdkTestFloor, jdkTestCeiling).toList()
-  }
-
-  val JavaLanguageVersion.isEnabled: Boolean
-    get() = isVersionEnabled(this)
-
-  fun isVersionEnabled(version: JavaLanguageVersion): Boolean {
-    return when {
-      testAllJdks -> true
-      multiJdkTesting -> JavaVersionRange.isLTS(version)
-      testExperimentalJdks -> version > jdkToolchainVersion
-      else -> false
-    }
-  }
-
-  private fun JavaToolchainSpec.pklJdkToolchain() {
-    languageVersion.set(jdkToolchainVersion)
-    vendor.set(jdkVendor)
-  }
-
-  private fun labelForVendor(vendor: JvmVendorSpec): String =
-    when (vendor) {
-      JvmVendorSpec.AZUL -> "Zulu"
-      JvmVendorSpec.GRAAL_VM -> "GraalVm"
-      JvmVendorSpec.ORACLE -> "Oracle"
-      JvmVendorSpec.ADOPTIUM -> "Adoptium"
-      else -> error("Unrecognized JDK vendor: $vendor")
-    }
-
-  private fun testNamer(baseName: () -> String): (JavaLanguageVersion, JvmVendorSpec?) -> String =
-    { jdkTarget, vendor ->
-      val targetToken =
-        when (vendor) {
-          null -> "Jdk${jdkTarget.asInt()}"
-          else -> "Jdk${jdkTarget.asInt()}${labelForVendor(vendor).capitalized()}"
-        }
-      if (jdkTarget > jdkToolchainVersion) {
-        // test targets above the toolchain target are considered "experimental".
-        "${baseName()}${targetToken}Experimental"
-      } else {
-        "${baseName()}${targetToken}"
-      }
-    }
-
-  @Suppress("UnstableApiUsage")
-  fun multiJdkTestingWith(
-    templateTask: TaskProvider<out Test>,
-    configurator: MultiJdkTestConfigurator = {},
-  ): Iterable<Provider<out Any>> =
-    with(project) {
-      val isMultiVendor = testJdkVendors.count() > 1
-      val baseNameProvider = { templateTask.get().name }
-      val namer = testNamer(baseNameProvider)
-      val applyConfig: MultiJdkTestConfigurator = { (version, jdk) ->
-        // 1) copy configurations from the template task
-        templateTask.get().let { template ->
-          // copy explicit dependencies not inferred from task inputs
-          dependsOn(template.dependsOn)
-          classpath = template.classpath
-          testClassesDirs = template.testClassesDirs
-          jvmArgs.addAll(template.jvmArgs)
-          jvmArgumentProviders.addAll(template.jvmArgumentProviders)
-          forkEvery = template.forkEvery
-          maxParallelForks = template.maxParallelForks
-          minHeapSize = template.minHeapSize
-          maxHeapSize = template.maxHeapSize
-          exclude(template.excludes)
-          template.systemProperties.forEach { prop -> systemProperty(prop.key, prop.value) }
-        }
-
-        // 2) assign launcher
-        javaLauncher = jdk
-
-        // 3) dispatch the user's configurator
-        configurator(version to jdk)
-      }
-
-      serviceOf<JavaToolchainService>().let { toolchains ->
-        jdkTestRange
-          .flatMap { targetVersion ->
-            // multiply out by jdk vendor
-            testJdkVendors.map { vendor -> (targetVersion to vendor) }
-          }
-          .mapNotNull { (jdkTarget, vendor) ->
-            if (jdkToolchainVersion == jdkTarget) {
-              tasks.register(namer(jdkTarget, vendor)) {
-                // alias to `test`
-                dependsOn(templateTask)
-                group = Category.VERIFICATION
-                description =
-                  "Alias for regular '${baseNameProvider()}' task, on JDK ${jdkTarget.asInt()}"
-              }
-            } else {
-              // Always register and enable the task so it can be run explicitly,
-              // but only return it if it should be included in "check".
-              val task =
-                tasks.register(namer(jdkTarget, vendor.takeIf { isMultiVendor }), Test::class) {
-                  group = Category.VERIFICATION
-                  description = "Run tests against JDK ${jdkTarget.asInt()}"
-                  applyConfig(jdkTarget to toolchains.launcherFor { languageVersion = jdkTarget })
-                  // fix: on jdk17, we must force the polyglot module on to the modulepath
-                  if (jdkTarget.asInt() == 17)
-                    jvmArgumentProviders.add(
-                      CommandLineArgumentProvider {
-                        buildList { listOf("--add-modules=org.graalvm.polyglot") }
-                      }
-                    )
-                }
-              task.takeIf { jdkTarget.isEnabled }
-            }
-          }
-          .toList()
-      }
-    }
-
-  val javaCompiler: Provider<JavaCompiler> by lazy {
-    project.serviceOf<JavaToolchainService>().let { toolchainService ->
-      toolchainService.compilerFor { pklJdkToolchain() }
-    }
-  }
-
-  val javaTestLauncher: Provider<JavaLauncher> by lazy {
-    project.serviceOf<JavaToolchainService>().let { toolchainService ->
-      toolchainService.launcherFor { pklJdkToolchain() }
-    }
-  }
-
-  val multiJdkTesting: Boolean by lazy {
-    // Test Pkl against a full range of JDK versions, past and present, within the
-    // supported bounds of `PKL_TEST_JDK_TARGET` and `PKL_TEST_JDK_MAXIMUM`.
-    //
-    // In CI, this defaults to `true` to catch potential cross-JDK compat regressions or other bugs.
-    // In local dev, this defaults to `false` to speed up the build and reduce contributor load.
-    System.getProperty("pklMultiJdkTesting")?.toBoolean() ?: isCiBuild
-  }
-
-  val hasMuslToolchain: Boolean by lazy {
-    // see .github/scripts/install_musl.sh
-    File(System.getProperty("user.home"), "staticdeps/bin/x86_64-linux-musl-gcc").exists()
-  }
-
-  val os: org.gradle.internal.os.OperatingSystem by lazy {
-    org.gradle.internal.os.OperatingSystem.current()
-  }
-
-  // could be `commitId: Provider<String> = project.provider { ... }`
-  val commitId: String by lazy {
-    // allow -DcommitId=abc123 for build environments that don't have git.
-    System.getProperty("commitId").let { if (it != null) return@lazy it }
-    // only run command once per build invocation
-    if (project.path == project.rootProject.path) {
-      val process =
-        ProcessBuilder()
-          .command("git", "rev-parse", "--short", "HEAD")
-          .directory(project.rootDir)
-          .start()
-      process.waitFor().also { exitCode ->
-        if (exitCode == -1) throw RuntimeException(process.errorStream.reader().readText())
-      }
-      process.inputStream.reader().readText().trim()
-    } else {
-      project.rootProject.extensions.getByType(BuildInfo::class.java).commitId
-    }
-  }
-
-  val commitish: String by lazy { if (isReleaseBuild) project.version.toString() else commitId }
-
-  val pklVersion: String by lazy {
-    if (isReleaseBuild) {
-      project.version.toString()
-    } else {
-      project.version.toString().replace("-SNAPSHOT", "-dev+$commitId")
-    }
-  }
-
-  val pklVersionNonUnique: String by lazy {
-    if (isReleaseBuild) {
-      project.version.toString()
-    } else {
-      project.version.toString().replace("-SNAPSHOT", "-dev")
-    }
-  }
-
-  // https://melix.github.io/blog/2021/03/version-catalogs-faq.html#_but_how_can_i_use_the_catalog_in_em_plugins_em_defined_in_code_buildsrc_code
-  val libs: VersionCatalog by lazy {
-    project.extensions.getByType<VersionCatalogsExtension>().named("libs")
-  }
-
-  init {
-    if (!isReleaseBuild) {
-      project.version = "${project.version}-SNAPSHOT"
-    }
-  }
-}
-
-// Shape of a function which is applied to configure multi-JDK testing.
-private typealias MultiJdkTestConfigurator =
-  Test.(Pair<JavaLanguageVersion, Provider<JavaLauncher>>) -> Unit

build-logic/src/main/kotlin/ExecutableSpec.kt

@@ -1,49 +0,0 @@
-/*
- * 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.
- */
-import org.gradle.api.provider.Property
-
-abstract class ExecutableSpec {
-  /** The main entrypoint Java class of the executable. */
-  abstract val mainClass: Property<String>
-
-  /**
-   * The name of the native executable.
-   *
-   * Not required if not building a native executable.
-   */
-  abstract val name: Property<String>
-
-  /** The name of the Java executable. */
-  abstract val javaName: Property<String>
-
-  /** The name of the executable that shows in the description when published to Maven. */
-  abstract val documentationName: Property<String>
-
-  /**
-   * The base name of the Maven publication.
-   *
-   * This becomes the base name of the Artifact ID, with the os and arch suffixed.
-   *
-   * For example, `pkl` becomes `pkl-macos-aarch` for the macOS/aarch64 variant.
-   */
-  abstract val publicationName: Property<String>
-
-  /** The name of the artifact ID for the Java executable. */
-  abstract val javaPublicationName: Property<String>
-
-  /** The website for this executable. */
-  abstract val website: Property<String>
-}

build-logic/src/main/kotlin/InstallGraalVm.kt

@@ -1,91 +0,0 @@
-/*
- * Copyright © 2024-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.
- */
-import java.nio.file.Files
-import java.nio.file.Paths
-import java.nio.file.StandardCopyOption
-import java.util.*
-import javax.inject.Inject
-import kotlin.io.path.createDirectories
-import org.gradle.api.DefaultTask
-import org.gradle.api.internal.file.FileOperations
-import org.gradle.api.provider.Property
-import org.gradle.api.tasks.Input
-import org.gradle.api.tasks.TaskAction
-import org.gradle.process.ExecOperations
-
-abstract class InstallGraalVm
-@Inject
-constructor(
-  private val fileOperations: FileOperations,
-  private val execOperations: ExecOperations,
-) : DefaultTask() {
-  @get:Input abstract val graalVm: Property<BuildInfo.GraalVm>
-
-  init {
-    @Suppress("LeakingThis") onlyIf("GraalVM not installed") { !graalVm.get().installDir.exists() }
-  }
-
-  @TaskAction
-  @Suppress("unused")
-  fun run() {
-    // minimize chance of corruption by extract-to-random-dir-and-flip-symlink
-    val distroDir = Paths.get(graalVm.get().homeDir, UUID.randomUUID().toString())
-    try {
-      distroDir.createDirectories()
-      println("Extracting ${graalVm.get().downloadFile} into $distroDir")
-      // faster and more reliable than Gradle's `copy { from tarTree() }`
-      execOperations.exec {
-        workingDir = distroDir.toFile()
-        executable = "tar"
-        args("--strip-components=1", "-xzf", graalVm.get().downloadFile)
-      }
-
-      val os = org.gradle.internal.os.OperatingSystem.current()
-      val distroBinDir =
-        if (os.isMacOsX) distroDir.resolve("Contents/Home/bin") else distroDir.resolve("bin")
-
-      println("Installing native-image into $distroDir")
-      val gvmVersionMajor =
-        requireNotNull(graalVm.get().version.split(".").first().toIntOrNull()) {
-          "Invalid GraalVM JDK version: ${graalVm.get().graalVmJdkVersion}"
-        }
-      if (gvmVersionMajor < 24) {
-        execOperations.exec {
-          val executableName = if (os.isWindows) "gu.cmd" else "gu"
-          executable = distroBinDir.resolve(executableName).toString()
-          args("install", "--no-progress", "native-image")
-        }
-      }
-
-      println("Creating symlink ${graalVm.get().installDir} for $distroDir")
-      val tempLink = Paths.get(graalVm.get().homeDir, UUID.randomUUID().toString())
-      Files.createSymbolicLink(tempLink, distroDir)
-      try {
-        Files.move(tempLink, graalVm.get().installDir.toPath(), StandardCopyOption.ATOMIC_MOVE)
-      } catch (e: Exception) {
-        try {
-          fileOperations.delete(tempLink.toFile())
-        } catch (ignored: Exception) {}
-        throw e
-      }
-    } catch (e: Exception) {
-      try {
-        fileOperations.delete(distroDir)
-      } catch (ignored: Exception) {}
-      throw e
-    }
-  }
-}

build-logic/src/main/kotlin/JavaVersionRange.kt

@@ -1,65 +0,0 @@
-/*
- * Copyright © 2024-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.
- */
-@file:Suppress("MemberVisibilityCanBePrivate")
-
-import java.util.*
-import org.gradle.jvm.toolchain.JavaLanguageVersion
-
-typealias JavaVersionPair = Pair<JavaLanguageVersion, JavaLanguageVersion>
-
-// All LTS releases.
-private val ltsReleases =
-  sortedSetOf(
-    JavaLanguageVersion.of(8),
-    JavaLanguageVersion.of(11),
-    JavaLanguageVersion.of(17),
-    JavaLanguageVersion.of(21),
-    JavaLanguageVersion.of(25),
-  )
-
-/** Describes an inclusive range of JVM versions, based on the [JavaLanguageVersion] type. */
-@JvmInline
-value class JavaVersionRange private constructor(private val bounds: JavaVersionPair) :
-  Iterable<JavaLanguageVersion> {
-  @Suppress("unused")
-  companion object {
-    fun isLTS(version: JavaLanguageVersion): Boolean = version in ltsReleases
-
-    fun inclusive(floor: JavaLanguageVersion, ceiling: JavaLanguageVersion): JavaVersionRange =
-      JavaVersionRange(floor to ceiling)
-
-    fun startingAt(floor: JavaLanguageVersion): JavaVersionRange =
-      inclusive(floor, JavaLanguageVersion.of(PKL_TEST_JDK_MAXIMUM))
-
-    fun upTo(ceiling: JavaLanguageVersion): JavaVersionRange =
-      inclusive(JavaLanguageVersion.of(PKL_TEST_JDK_MINIMUM), ceiling)
-  }
-
-  operator fun contains(version: JavaLanguageVersion): Boolean =
-    version >= bounds.first && version <= bounds.second
-
-  fun asSequence(): Sequence<JavaLanguageVersion> = sequence {
-    var current = bounds.first
-    while (current <= bounds.second) {
-      yield(current)
-      current = JavaLanguageVersion.of(current.asInt() + 1)
-    }
-  }
-
-  fun asSortedSet(): SortedSet<JavaLanguageVersion> = asSequence().toSortedSet()
-
-  override fun iterator(): Iterator<JavaLanguageVersion> = asSortedSet().iterator()
-}

build-logic/src/main/kotlin/NativeImageBuild.kt

@@ -1,170 +0,0 @@
-/*
- * 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.
- */
-import javax.inject.Inject
-import org.gradle.api.DefaultTask
-import org.gradle.api.file.ConfigurableFileCollection
-import org.gradle.api.provider.ListProperty
-import org.gradle.api.provider.Property
-import org.gradle.api.provider.Provider
-import org.gradle.api.services.BuildService
-import org.gradle.api.services.BuildServiceParameters
-import org.gradle.api.tasks.ClasspathNormalizer
-import org.gradle.api.tasks.Input
-import org.gradle.api.tasks.InputFiles
-import org.gradle.api.tasks.OutputFile
-import org.gradle.api.tasks.PathSensitivity
-import org.gradle.api.tasks.TaskAction
-import org.gradle.kotlin.dsl.registerIfAbsent
-import org.gradle.kotlin.dsl.withNormalizer
-import org.gradle.process.ExecOperations
-
-enum class Architecture {
-  AMD64,
-  AARCH64,
-}
-
-abstract class NativeImageBuildService : BuildService<BuildServiceParameters.None>
-
-abstract class NativeImageBuild : DefaultTask() {
-  @get:Input abstract val imageName: Property<String>
-
-  @get:Input abstract val extraNativeImageArgs: ListProperty<String>
-
-  @get:Input abstract val arch: Property<Architecture>
-
-  @get:Input abstract val mainClass: Property<String>
-
-  @get:InputFiles abstract val classpath: ConfigurableFileCollection
-
-  private val outputDir = project.layout.buildDirectory.dir("executable")
-
-  @get:OutputFile val outputFile = outputDir.flatMap { it.file(imageName) }
-
-  @get:Inject protected abstract val execOperations: ExecOperations
-
-  private val graalVm: Provider<BuildInfo.GraalVm> = arch.map { a ->
-    when (a) {
-      Architecture.AMD64 -> buildInfo.graalVmAmd64
-      Architecture.AARCH64 -> buildInfo.graalVmAarch64
-    }
-  }
-
-  private val buildInfo: BuildInfo = project.extensions.getByType(BuildInfo::class.java)
-
-  private val nativeImageCommandName =
-    if (buildInfo.os.isWindows) "native-image.cmd" else "native-image"
-
-  private val nativeImageExecutable = graalVm.map { "${it.baseDir}/bin/$nativeImageCommandName" }
-
-  private val extraArgsFromProperties by lazy {
-    System.getProperties()
-      .filter { it.key.toString().startsWith("pkl.native") }
-      .map { "${it.key}=${it.value}".substring("pkl.native".length) }
-  }
-
-  private val buildService =
-    project.gradle.sharedServices.registerIfAbsent(
-      "nativeImageBuildService",
-      NativeImageBuildService::class,
-    ) {
-      maxParallelUsages.set(1)
-    }
-
-  init {
-    // ensure native-image builds run in serial (prevent `gw buildNative` from consuming all host
-    // CPU resources).
-    usesService(buildService)
-
-    group = "build"
-
-    inputs
-      .files(classpath)
-      .withPropertyName("runtimeClasspath")
-      .withNormalizer(ClasspathNormalizer::class)
-    inputs
-      .files(nativeImageExecutable)
-      .withPropertyName("graalVmNativeImage")
-      .withPathSensitivity(PathSensitivity.ABSOLUTE)
-  }
-
-  @TaskAction
-  @Suppress("unused")
-  protected fun run() {
-    execOperations.exec {
-      val exclusions =
-        listOf(buildInfo.libs.findLibrary("graalSdk").get()).map { it.get().module.name }
-
-      executable = nativeImageExecutable.get()
-      workingDir(outputDir)
-
-      args = buildList {
-        // must be emitted before any experimental options are used
-        add("-H:+UnlockExperimentalVMOptions")
-        // currently gives a deprecation warning, but we've been told
-        // that the "initialize everything at build time" *CLI* option is likely here to stay
-        add("--initialize-at-build-time=")
-        // needed for messagepack-java (see https://github.com/msgpack/msgpack-java/issues/600)
-        add("--initialize-at-run-time=org.msgpack.core.buffer.DirectBufferAccess")
-        // needed for jline-terminal-jni
-        add("--initialize-at-run-time=org.jline.nativ,org.jline.terminal.impl.jni")
-        add("--no-fallback")
-        add("-H:IncludeResources=org/pkl/core/stdlib/.*\\.pkl")
-        add("-H:IncludeResources=org/jline/utils/.*")
-        add("-H:IncludeResourceBundles=org.pkl.core.errorMessages")
-        add("-H:IncludeResourceBundles=org.pkl.parser.errorMessages")
-        add("-H:IncludeResources=org/pkl/commons/cli/PklCARoots.pem")
-        add("-H:Class=${mainClass.get()}")
-        add("-o")
-        add(imageName.get())
-        // the actual limit (currently) used by native-image is this number + 1400 (idea is to
-        // compensate for Truffle's own nodes)
-        add("-H:MaxRuntimeCompileMethods=1800")
-        add("-H:+EnforceMaxRuntimeCompileMethods")
-        add("--enable-url-protocols=http,https")
-        add("-H:+ReportExceptionStackTraces")
-        // disable automatic support for JVM CLI options (puts our main class in full control of
-        // argument parsing)
-        add("-H:-ParseRuntimeOptions")
-        // quick build mode: 40% faster compilation, 20% smaller (but presumably also slower)
-        // executable
-        if (!buildInfo.isReleaseBuild) {
-          add("-Ob")
-        }
-        if (buildInfo.isNativeArch) {
-          add("-march=native")
-        } else {
-          add("-march=compatibility")
-        }
-        // native-image rejects non-existing class path entries -> filter
-        add("--class-path")
-        val pathInput = classpath.filter {
-          it.exists() && !exclusions.any { exclude -> it.name.contains(exclude) }
-        }
-        add(pathInput.asPath)
-        // make sure dev machine stays responsive (15% slowdown on my laptop)
-        val processors =
-          Runtime.getRuntime().availableProcessors() /
-            if (buildInfo.os.isMacOsX && !buildInfo.isCiBuild) 4 else 1
-        add("-J-XX:ActiveProcessorCount=${processors}")
-        // Pass through all `HOMEBREW_` prefixed environment variables to allow build with shimmed
-        // tools.
-        addAll(environment.keys.filter { it.startsWith("HOMEBREW_") }.map { "-E$it" })
-        addAll(extraNativeImageArgs.get())
-        addAll(extraArgsFromProperties)
-      }
-    }
-  }
-}

build-logic/src/main/kotlin/PklFormatterSpotless.kt

@@ -1,58 +0,0 @@
-/*
- * 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.
- */
-import com.diffplug.spotless.FormatterFunc
-import com.diffplug.spotless.FormatterStep
-import java.io.Serial
-import java.io.Serializable
-import java.net.URLClassLoader
-import org.gradle.api.artifacts.Configuration
-
-class PklFormatterStep(@Transient private val configuration: Configuration) : Serializable {
-  companion object {
-    @Serial private const val serialVersionUID: Long = 1L
-  }
-
-  fun create(): FormatterStep {
-    return FormatterStep.createLazy(
-      "pkl",
-      { PklFormatterStep(configuration) },
-      { PklFormatterFunc(configuration) },
-    )
-  }
-}
-
-class PklFormatterFunc(@Transient private val configuration: Configuration) :
-  FormatterFunc, Serializable {
-  companion object {
-    @Serial private const val serialVersionUID: Long = 1L
-  }
-
-  private val classLoader by lazy {
-    val urls = configuration.files.map { it.toURI().toURL() }
-    // Use the platform classloader as parent to isolate from Gradle's classloader
-    URLClassLoader(urls.toTypedArray(), ClassLoader.getPlatformClassLoader())
-  }
-
-  private val formatterClass by lazy { classLoader.loadClass("org.pkl.formatter.Formatter") }
-
-  private val formatMethod by lazy { formatterClass.getMethod("format", String::class.java) }
-
-  private val formatterInstance by lazy { formatterClass.getConstructor().newInstance() }
-
-  override fun apply(input: String): String {
-    return formatMethod(formatterInstance, input) as String
-  }
-}

build-logic/src/main/kotlin/RevertYearOnlyChanges.kt

@@ -1,77 +0,0 @@
-/*
- * Copyright © 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.
- */
-import com.diffplug.spotless.FormatterFunc
-import com.diffplug.spotless.FormatterStep
-import java.io.File
-import java.io.Serial
-import java.io.Serializable
-
-/**
- * A Spotless [FormatterStep] that suppresses formatting changes where the only difference between
- * the formatted output and the file's content in the upstream base ref is the license header year.
- *
- * Avoids an issue where, in the process of working on the codebase:
- * 1. A file is modified.
- * 2. Spotless formats the file, and also updates the copyright year.
- * 3. The original modification is reverted.
- * 4. Spotless formats the file again, but now the copyright year is the updated year.
- */
-class RevertYearOnlyChangesStep(private val repoRoot: File, private val ratchetFrom: String) :
-  Serializable {
-  companion object {
-    @Serial private const val serialVersionUID: Long = 1L
-  }
-
-  fun create(): FormatterStep =
-    FormatterStep.createLazy(
-      "revertYearOnlyChanges",
-      { this },
-      { RevertYearOnlyChangesFunc(repoRoot, ratchetFrom) },
-    )
-}
-
-class RevertYearOnlyChangesFunc(private val repoRoot: File, private val ratchetFrom: String) :
-  FormatterFunc.NeedsFile, Serializable {
-  companion object {
-    @Serial private const val serialVersionUID: Long = 1L
-
-    // Matches "Copyright © 2024" or "Copyright © 2024-2025"
-    private val YEAR_REGEX = Regex("""(Copyright © )\d{4}(-\d{4})?""")
-  }
-
-  override fun applyWithFile(unix: String, file: File): String {
-    val relativePath = repoRoot.toPath().relativize(file.toPath()).toString()
-    val upstreamContent = gitShow(ratchetFrom, relativePath) ?: return unix
-    val normalizedRaw = YEAR_REGEX.replace(unix, "\$1YEAR")
-    val normalizedUpstream = YEAR_REGEX.replace(upstreamContent, "\$1YEAR")
-    return if (normalizedRaw == normalizedUpstream) {
-      // Only the year changed — return the upstream content
-      upstreamContent
-    } else {
-      unix
-    }
-  }
-
-  private fun gitShow(ref: String, path: String): String? {
-    val process =
-      ProcessBuilder("git", "show", "$ref:$path")
-        .directory(repoRoot)
-        .redirectErrorStream(true)
-        .start()
-    val output = process.inputStream.readBytes().toString(Charsets.UTF_8)
-    return if (process.waitFor() == 0) output.replace("\r\n", "\n") else null
-  }
-}

build-logic/src/main/kotlin/pklGraalVm.gradle.kts

@@ -1,74 +0,0 @@
-/*
- * Copyright © 2024-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.
- */
-import de.undercouch.gradle.tasks.download.Download
-import de.undercouch.gradle.tasks.download.Verify
-
-plugins { id("de.undercouch.download") }
-
-val buildInfo = project.extensions.getByType<BuildInfo>()
-
-// tries to minimize chance of corruption by download-to-temp-file-and-move
-val downloadGraalVmAarch64 by
-  tasks.registering(Download::class) { configureDownloadGraalVm(buildInfo.graalVmAarch64) }
-
-val downloadGraalVmAmd64 by
-  tasks.registering(Download::class) { configureDownloadGraalVm(buildInfo.graalVmAmd64) }
-
-fun Download.configureDownloadGraalVm(graalvm: BuildInfo.GraalVm) {
-  onlyIf { !graalvm.installDir.exists() }
-  doLast { println("Downloaded GraalVm to ${graalvm.downloadFile}") }
-
-  src(graalvm.downloadUrl)
-  dest(graalvm.downloadFile)
-  overwrite(false)
-  tempAndMove(true)
-}
-
-val verifyGraalVmAarch64 by
-  tasks.registering(Verify::class) {
-    configureVerifyGraalVm(buildInfo.graalVmAarch64)
-    dependsOn(downloadGraalVmAarch64)
-  }
-
-val verifyGraalVmAmd64 by
-  tasks.registering(Verify::class) {
-    configureVerifyGraalVm(buildInfo.graalVmAmd64)
-    dependsOn(downloadGraalVmAmd64)
-  }
-
-fun Verify.configureVerifyGraalVm(graalvm: BuildInfo.GraalVm) {
-  onlyIf { !graalvm.installDir.exists() }
-
-  src(graalvm.downloadFile)
-  checksum(
-    buildInfo.libs.findVersion("graalVmSha256-${graalvm.osName}-${graalvm.arch}").get().toString()
-  )
-  algorithm("SHA-256")
-}
-
-@Suppress("unused")
-val installGraalVmAarch64 by
-  tasks.registering(InstallGraalVm::class) {
-    dependsOn(verifyGraalVmAarch64)
-    graalVm = buildInfo.graalVmAarch64
-  }
-
-@Suppress("unused")
-val installGraalVmAmd64 by
-  tasks.registering(InstallGraalVm::class) {
-    dependsOn(verifyGraalVmAmd64)
-    graalVm = buildInfo.graalVmAmd64
-  }

build-logic/src/main/kotlin/pklJSpecify.gradle.kts

@@ -1,46 +0,0 @@
-/*
- * 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.
- */
-import net.ltgt.gradle.errorprone.errorprone
-import net.ltgt.gradle.nullaway.nullaway
-import org.gradle.accessors.dm.LibrariesForLibs
-import org.gradle.api.tasks.compile.JavaCompile
-
-plugins {
-  `java-library`
-  id("net.ltgt.errorprone")
-  id("net.ltgt.nullaway")
-}
-
-val libs = the<LibrariesForLibs>()
-
-dependencies {
-  api(libs.jspecify)
-  errorprone(libs.errorProne)
-  errorprone(libs.nullaway)
-}
-
-nullaway { onlyNullMarked = true }
-
-tasks.withType<JavaCompile>().configureEach {
-  options.errorprone.disableAllChecks = true
-  options.errorprone.nullaway {
-    error()
-    onlyNullMarked = true
-    jspecifyMode = true
-    // honor assert x != null in addition to Objects.requireNonNull(x)
-    assertsEnabled = true
-  }
-}

build-logic/src/main/kotlin/pklJavaExecutable.gradle.kts

@@ -1,130 +0,0 @@
-/*
- * 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.
- */
-import kotlin.io.path.createDirectories
-import kotlin.io.path.writeText
-import org.gradle.kotlin.dsl.support.serviceOf
-
-plugins {
-  id("pklJavaLibrary")
-  //  id("pklPublishLibrary")
-  id("com.gradleup.shadow")
-}
-
-val executableSpec = project.extensions.create("executable", ExecutableSpec::class.java)
-val buildInfo = project.extensions.getByType<BuildInfo>()
-
-val javaExecutable by
-  tasks.registering(ExecutableJar::class) {
-    group = "build"
-    dependsOn(tasks.jar)
-    inJar = tasks.shadowJar.flatMap { it.archiveFile }
-    val effectiveJavaName =
-      executableSpec.javaName.map { name -> if (buildInfo.os.isWindows) "$name.bat" else name }
-    outJar = layout.buildDirectory.dir("executable").flatMap { it.file(effectiveJavaName) }
-
-    // uncomment for debugging
-    // jvmArgs.addAll("-ea", "-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005")
-  }
-
-fun Task.setupTestStartJavaExecutable(launcher: Provider<JavaLauncher>? = null) {
-  group = "verification"
-  dependsOn(javaExecutable)
-
-  // dummy output to satisfy up-to-date check
-  val outputFile = layout.buildDirectory.file("testStartJavaExecutable/$name")
-  outputs.file(outputFile)
-
-  val execOutput = providers.exec {
-    val executablePath = javaExecutable.get().outputs.files.singleFile
-    if (launcher?.isPresent == true) {
-      commandLine(
-        launcher.get().executablePath.asFile.absolutePath,
-        "-jar",
-        executablePath.absolutePath,
-        "--version",
-      )
-    } else {
-      commandLine(executablePath.absolutePath, "--version")
-    }
-  }
-
-  doLast {
-    val outputText = execOutput.standardOutput.asText.get()
-    if (!outputText.contains(buildInfo.pklVersionNonUnique)) {
-      throw GradleException(
-        "Expected version output to contain current version (${buildInfo.pklVersionNonUnique}), but got '$outputText'"
-      )
-    }
-    outputFile.get().asFile.toPath().apply {
-      try {
-        parent.createDirectories()
-      } catch (_: java.nio.file.FileAlreadyExistsException) {}
-      writeText("OK")
-    }
-  }
-}
-
-val testStartJavaExecutable by tasks.registering { setupTestStartJavaExecutable() }
-
-// Setup `testStartJavaExecutable` tasks for multi-JDK testing.
-val testStartJavaExecutableOnOtherJdks =
-  buildInfo.jdkTestRange.map { jdkTarget ->
-    tasks.register("testStartJavaExecutableJdk${jdkTarget.asInt()}") {
-      enabled = buildInfo.isVersionEnabled(jdkTarget)
-      val toolChainService: JavaToolchainService = serviceOf()
-      val launcher = toolChainService.launcherFor { languageVersion = jdkTarget }
-      setupTestStartJavaExecutable(launcher)
-    }
-  }
-
-tasks.assemble { dependsOn(javaExecutable) }
-
-tasks.check {
-  dependsOn(testStartJavaExecutable)
-  dependsOn(testStartJavaExecutableOnOtherJdks)
-}
-
-// publishing {
-//  publications {
-//    // need to put in `afterEvaluate` because `artifactId` cannot be set lazily.
-//    project.afterEvaluate {
-//      register<MavenPublication>("javaExecutable") {
-//        artifactId = executableSpec.javaPublicationName.get()
-//
-//        artifact(javaExecutable.map { it.outputs.files.singleFile }) {
-//          classifier = null
-//          extension = "bin"
-//          builtBy(javaExecutable)
-//        }
-//
-//        pom {
-//          url = executableSpec.website
-//          description =
-//            executableSpec.documentationName.map { name ->
-//              """
-//            $name executable for Java.
-//            Can be executed directly, or with `java -jar <path/to/jpkl>`.
-//            Requires Java 17 or higher.
-//            """
-//                .trimIndent()
-//            }
-//        }
-//      }
-//    }
-//  }
-// }
-
-// signing { project.afterEvaluate { sign(publishing.publications["javaExecutable"]) } }

build-logic/src/main/kotlin/pklJavaLibrary.gradle.kts

@@ -1,123 +0,0 @@
-/*
- * Copyright © 2024-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.
- */
-@file:Suppress("HttpUrlsUsage", "unused")
-
-import org.gradle.accessors.dm.LibrariesForLibs
-
-plugins {
-  `java-library`
-  `jvm-toolchains`
-  `jvm-test-suite`
-  id("pklKotlinTest")
-  id("com.diffplug.spotless")
-}
-
-// make sources Jar available to other subprojects
-val sourcesJarConfiguration: Provider<Configuration> = configurations.register("sourcesJar")
-
-// Version Catalog library symbols.
-val libs = the<LibrariesForLibs>()
-
-// Build configuration.
-val info = project.extensions.getByType<BuildInfo>()
-
-java {
-  withSourcesJar() // creates `sourcesJar` task
-  withJavadocJar()
-
-  toolchain {
-    languageVersion = info.jdkToolchainVersion
-    vendor = info.jdkVendor
-  }
-}
-
-artifacts {
-  // make sources Jar available to other subprojects
-  add("sourcesJar", tasks["sourcesJar"])
-}
-
-spotless {
-  val revertYearOnlyChanges = RevertYearOnlyChangesStep(rootProject.rootDir, ratchetFrom!!).create()
-
-  java {
-    addStep(revertYearOnlyChanges)
-    googleJavaFormat(libs.versions.googleJavaFormat.get())
-    target("src/*/java/**/*.java")
-    licenseHeaderFile(
-      rootProject.file("build-logic/src/main/resources/license-header.star-block.txt")
-    )
-  }
-}
-
-tasks.jar {
-  manifest {
-    attributes +=
-      mapOf(
-        "Automatic-Module-Name" to "org.${project.name.replace("-", ".")}",
-        "Add-Exports" to info.jpmsExportsForJarManifest,
-      )
-  }
-}
-
-tasks.javadoc {
-  classpath = sourceSets.main.get().output + sourceSets.main.get().compileClasspath
-  source = sourceSets.main.get().allJava
-  title = "${project.name} ${project.version} API"
-  (options as StandardJavadocDocletOptions).addStringOption("Xdoclint:none", "-quiet")
-}
-
-val truffleJavacArgs =
-  listOf(
-    // TODO: determine correct limits for Truffle specializations
-    // (see https://graalvm.slack.com/archives/CNQSB2DHD/p1712380902746829)
-    "-Atruffle.dsl.SuppressWarnings=truffle-limit"
-  )
-
-tasks.compileJava {
-  javaCompiler = info.javaCompiler
-  options.compilerArgs.addAll(truffleJavacArgs + info.jpmsAddModulesFlags)
-}
-
-tasks.withType<JavaCompile>().configureEach {
-  javaCompiler = info.javaCompiler
-  options.release = info.jvmTarget
-}
-
-tasks.withType<JavaExec>().configureEach { jvmArgs(info.jpmsAddModulesFlags) }
-
-fun Test.configureJdkTestTask(launcher: Provider<JavaLauncher>) {
-  useJUnitPlatform()
-  javaLauncher = launcher
-  systemProperties.putAll(info.testProperties)
-  jvmArgs.addAll(info.jpmsAddModulesFlags)
-}
-
-tasks.test { configureJdkTestTask(info.javaTestLauncher) }
-
-// Prepare test tasks for each JDK version which is within the test target suite for Pkl. Each task
-// uses a pinned JDK toolchain version, and is named for the major version which is tested.
-//
-// Test tasks configured in this manner are executed manually by name, e.g. `./gradlew testJdk11`,
-// and automatically as dependencies of `check`.
-//
-// We omit the current JDK from this list because it is already tested, in effect, by the default
-// `test` task.
-//
-// Pkl subprojects may elect to further configure these tasks as needed; by default, each task
-// inherits the configuration of the default `test` task (aside from an overridden launcher).
-val jdkTestTasks = info.multiJdkTestingWith(tasks.test) { (_, jdk) -> configureJdkTestTask(jdk) }
-
-tasks.check { dependsOn(jdkTestTasks) }

build-logic/src/main/kotlin/pklKotlinBase.gradle.kts

@@ -1,115 +0,0 @@
-/*
- * Copyright © 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.
- */
-import org.gradle.accessors.dm.LibrariesForLibs
-import org.gradle.api.GradleException
-import org.gradle.kotlin.dsl.getByType
-import org.gradle.kotlin.dsl.kotlin
-import org.gradle.kotlin.dsl.the
-import org.jetbrains.kotlin.gradle.dsl.JvmTarget
-import org.jetbrains.kotlin.gradle.dsl.KotlinVersion
-
-plugins {
-  java
-  kotlin("jvm")
-  id("com.diffplug.spotless")
-}
-
-val buildInfo = project.extensions.getByType<BuildInfo>()
-
-val libs = the<LibrariesForLibs>()
-
-kotlin {
-  jvmToolchain {
-    languageVersion.set(buildInfo.jdkToolchainVersion)
-    vendor.set(buildInfo.jdkVendor)
-  }
-  compilerOptions {
-    val kotlinTarget = KotlinVersion.fromVersion(libs.versions.kotlinTarget.get())
-    languageVersion.set(kotlinTarget)
-    apiVersion.set(kotlinTarget)
-    jvmTarget = JvmTarget.fromTarget(buildInfo.jvmTarget.toString())
-    freeCompilerArgs.addAll(
-      "-jvm-default=no-compatibility", // was: -Xjvm-default=all
-      "-Xjdk-release=${buildInfo.jvmTarget}",
-      "-Xjsr305=strict",
-    )
-  }
-}
-
-spotless {
-  val revertYearOnlyChanges = RevertYearOnlyChangesStep(rootProject.rootDir, ratchetFrom!!).create()
-
-  kotlin {
-    addStep(revertYearOnlyChanges)
-    ktfmt(libs.versions.ktfmt.get()).googleStyle()
-    target("src/*/kotlin/**/*.kt")
-    licenseHeaderFile(
-      rootProject.file("build-logic/src/main/resources/license-header.star-block.txt")
-    )
-  }
-}
-
-/**
- * Kotlin modules to guard: fail the build if any dependency resolves to a version higher than
- * `libs.versions.kotlinTarget`. This includes versions introduced via direct declarations, BOMs,
- * version catalogs, or constraints.
- */
-val guardedKotlinModules = setOf(libs.kotlinStdLib.get().module, libs.kotlinReflect.get().module)
-
-/**
- * Classpath configurations where the above rule applies. Kept narrow to avoid interfering with
- * Gradle/Kotlin plugin internal configurations.
- */
-val guardedConfigurations =
-  setOf(
-    configurations.compileClasspath,
-    configurations.runtimeClasspath,
-    configurations.testCompileClasspath,
-    configurations.testRuntimeClasspath,
-  )
-
-guardedConfigurations.forEach { configuration ->
-  configuration.configure {
-    incoming.afterResolve {
-      resolutionResult.allComponents.forEach { component ->
-        val moduleVersion = component.moduleVersion ?: return@forEach
-        if (
-          moduleVersion.module in guardedKotlinModules &&
-            moduleVersion.version.exceedsKotlinTarget()
-        ) {
-          throw GradleException(
-            "Resolved ${moduleVersion.module}:${moduleVersion.version} on configuration $name, " +
-              "which exceeds the allowed Kotlin version ($kotlinTargetVersion)"
-          )
-        }
-      }
-    }
-  }
-}
-
-// also works for version ranges like: [2.3.0,)
-val kotlinVersionRegex = Regex("""(\d+)\.(\d+)(?:\.\d+)?""")
-val kotlinTargetVersion = libs.versions.kotlinTarget.get()
-val targetMajor = kotlinTargetVersion.substringBefore('.').toInt()
-val targetMinor = kotlinTargetVersion.substringAfter('.').toInt()
-
-fun String.exceedsKotlinTarget(): Boolean {
-  val version =
-    kotlinVersionRegex.find(this) ?: throw GradleException("Could not parse Kotlin version: $this")
-  val major = version.groupValues[1].toInt()
-  val minor = version.groupValues[2].toInt()
-  return major > targetMajor || (major == targetMajor && minor > targetMinor)
-}

build-logic/src/main/kotlin/pklNativeExecutable.gradle.kts

@@ -1,338 +0,0 @@
-/*
- * 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.
- */
-import java.lang.Runtime.Version
-import kotlin.io.path.createDirectories
-import kotlin.io.path.writeText
-import org.gradle.accessors.dm.LibrariesForLibs
-
-plugins {
-  id("pklGraalVm")
-  id("pklJavaLibrary")
-  id("pklNativeLifecycle")
-  id("pklPublishLibrary")
-  id("com.gradleup.shadow")
-}
-
-// assumes that `pklJavaExecutable` is also applied
-val executableSpec = project.extensions.getByType<ExecutableSpec>()
-val buildInfo = project.extensions.getByType<BuildInfo>()
-
-val stagedMacAmd64Executable: Configuration by configurations.creating
-val stagedMacAarch64Executable: Configuration by configurations.creating
-val stagedLinuxAmd64Executable: Configuration by configurations.creating
-val stagedLinuxAarch64Executable: Configuration by configurations.creating
-val stagedAlpineLinuxAmd64Executable: Configuration by configurations.creating
-val stagedWindowsAmd64Executable: Configuration by configurations.creating
-
-val nativeImageClasspath by configurations.creating {
-  extendsFrom(configurations.runtimeClasspath.get())
-  // Ensure native-image version uses GraalVM C SDKs instead of Java FFI or JNA
-  // (comes from artifact `mordant-jvm-graal-ffi`).
-  exclude("com.github.ajalt.mordant", "mordant-jvm-ffm")
-  exclude("com.github.ajalt.mordant", "mordant-jvm-ffm-jvm")
-  exclude("com.github.ajalt.mordant", "mordant-jvm-jna")
-  exclude("com.github.ajalt.mordant", "mordant-jvm-jna-jvm")
-}
-
-val libs = the<LibrariesForLibs>()
-
-dependencies {
-  fun executableFile(suffix: String) =
-    files(
-      layout.buildDirectory.dir("executable").map { dir ->
-        dir.file(executableSpec.name.map { "$it-$suffix" })
-      }
-    )
-  nativeImageClasspath(libs.truffleRuntime)
-  nativeImageClasspath(libs.graalSdk)
-
-  stagedMacAarch64Executable(executableFile("macos-aarch64"))
-  stagedMacAmd64Executable(executableFile("macos-amd64"))
-  stagedLinuxAmd64Executable(executableFile("linux-amd64"))
-  stagedLinuxAarch64Executable(executableFile("linux-aarch64"))
-  stagedAlpineLinuxAmd64Executable(executableFile("alpine-linux-amd64"))
-  stagedWindowsAmd64Executable(executableFile("windows-amd64.exe"))
-}
-
-private fun NativeImageBuild.amd64() {
-  arch = Architecture.AMD64
-  dependsOn(":installGraalVmAmd64")
-}
-
-private fun NativeImageBuild.aarch64() {
-  arch = Architecture.AARCH64
-  dependsOn(":installGraalVmAarch64")
-}
-
-private fun NativeImageBuild.setClasspath() {
-  classpath.from(sourceSets.main.map { it.output })
-  classpath.from(
-    project(":pkl-commons-cli").extensions.getByType(SourceSetContainer::class)["svm"].output
-  )
-  classpath.from(nativeImageClasspath)
-}
-
-val macExecutableAmd64 by
-  tasks.registering(NativeImageBuild::class) {
-    imageName = executableSpec.name.map { "$it-macos-amd64" }
-    mainClass = executableSpec.mainClass
-    amd64()
-    setClasspath()
-  }
-
-val macExecutableAarch64 by
-  tasks.registering(NativeImageBuild::class) {
-    imageName = executableSpec.name.map { "$it-macos-aarch64" }
-    mainClass = executableSpec.mainClass
-    aarch64()
-    setClasspath()
-  }
-
-val linuxExecutableAmd64 by
-  tasks.registering(NativeImageBuild::class) {
-    imageName = executableSpec.name.map { "$it-linux-amd64" }
-    mainClass = executableSpec.mainClass
-    amd64()
-    setClasspath()
-  }
-
-val linuxExecutableAarch64 by
-  tasks.registering(NativeImageBuild::class) {
-    imageName = executableSpec.name.map { "$it-linux-aarch64" }
-    mainClass = executableSpec.mainClass
-    aarch64()
-    setClasspath()
-    // Ensure compatibility for kernels with page size set to 4k, 16k and 64k
-    // (e.g. Raspberry Pi 5, Asahi Linux)
-    extraNativeImageArgs.add("-H:PageSize=65536")
-  }
-
-val alpineExecutableAmd64 by
-  tasks.registering(NativeImageBuild::class) {
-    imageName = executableSpec.name.map { "$it-alpine-linux-amd64" }
-    mainClass = executableSpec.mainClass
-    amd64()
-    setClasspath()
-    extraNativeImageArgs.addAll(listOf("--static", "--libc=musl"))
-  }
-
-val windowsExecutableAmd64 by
-  tasks.registering(NativeImageBuild::class) {
-    imageName = executableSpec.name.map { "$it-windows-amd64" }
-    mainClass = executableSpec.mainClass
-    amd64()
-    setClasspath()
-  }
-
-val assembleNative by tasks.existing
-
-val testStartNativeExecutable by tasks.registering {
-  dependsOn(assembleNative)
-
-  // dummy file for up-to-date checking
-  val outputFile = project.layout.buildDirectory.file("testStartNativeExecutable/output.txt")
-  outputs.file(outputFile)
-
-  val execOutput = providers.exec {
-    commandLine(assembleNative.get().outputs.files.singleFile, "--version")
-  }
-
-  doLast {
-    val outputText = execOutput.standardOutput.asText.get()
-    if (!outputText.contains(buildInfo.pklVersionNonUnique)) {
-      throw GradleException(
-        "Expected version output to contain current version (${buildInfo.pklVersionNonUnique}), but got '$outputText'"
-      )
-    }
-    outputFile.get().asFile.toPath().apply {
-      try {
-        parent.createDirectories()
-      } catch (_: java.nio.file.FileAlreadyExistsException) {}
-      writeText("OK")
-    }
-  }
-}
-
-val requiredGlibcVersion: Version = Version.parse("2.17")
-
-val checkGlibc by tasks.registering {
-  enabled = buildInfo.os.isLinux && !buildInfo.musl
-  dependsOn(assembleNative)
-  doLast {
-    val exec = providers.exec {
-      commandLine("objdump", "-T", assembleNative.get().outputs.files.singleFile)
-    }
-    val output = exec.standardOutput.asText.get()
-    val minimumGlibcVersion =
-      output
-        .split("\n")
-        .mapNotNull { line ->
-          val match = Regex("GLIBC_([.0-9]*)").find(line)
-          match?.groups[1]?.let { Version.parse(it.value) }
-        }
-        .maxOrNull()
-    if (minimumGlibcVersion == null) {
-      throw GradleException(
-        "Could not determine glibc version from executable. objdump output: $output"
-      )
-    }
-    if (minimumGlibcVersion > requiredGlibcVersion) {
-      throw GradleException(
-        "Incorrect glibc version. Found: $minimumGlibcVersion, required: $requiredGlibcVersion"
-      )
-    }
-  }
-}
-
-// Expose underlying task's outputs
-private fun <T : Task> Task.wraps(other: TaskProvider<T>) {
-  dependsOn(other)
-  outputs.files(other)
-}
-
-val testNative by tasks.existing { dependsOn(testStartNativeExecutable, checkGlibc) }
-
-val assembleNativeMacOsAarch64 by tasks.existing { wraps(macExecutableAarch64) }
-
-val assembleNativeMacOsAmd64 by tasks.existing { wraps(macExecutableAmd64) }
-
-val assembleNativeLinuxAarch64 by tasks.existing { wraps(linuxExecutableAarch64) }
-
-val assembleNativeLinuxAmd64 by tasks.existing { wraps(linuxExecutableAmd64) }
-
-val assembleNativeAlpineLinuxAmd64 by tasks.existing { wraps(alpineExecutableAmd64) }
-
-val assembleNativeWindowsAmd64 by tasks.existing { wraps(windowsExecutableAmd64) }
-
-publishing {
-  publications {
-    // need to put in `afterEvaluate` because `artifactId` cannot be set lazily.
-    project.afterEvaluate {
-      create<MavenPublication>("macExecutableAmd64") {
-        artifactId = "${executableSpec.publicationName.get()}-macos-amd64"
-        artifact(stagedMacAmd64Executable.singleFile) {
-          classifier = null
-          extension = "bin"
-          builtBy(stagedMacAmd64Executable)
-        }
-        pom {
-          name = "${executableSpec.publicationName.get()}-macos-amd64"
-          url = executableSpec.website
-          description =
-            executableSpec.documentationName.map { name ->
-              "Native $name executable for macOS/amd64."
-            }
-        }
-      }
-
-      create<MavenPublication>("macExecutableAarch64") {
-        artifactId = "${executableSpec.publicationName.get()}-macos-aarch64"
-        artifact(stagedMacAarch64Executable.singleFile) {
-          classifier = null
-          extension = "bin"
-          builtBy(stagedMacAarch64Executable)
-        }
-        pom {
-          name = "${executableSpec.publicationName.get()}-macos-aarch64"
-          url = executableSpec.website
-          description =
-            executableSpec.documentationName.map { name ->
-              "Native $name executable for macOS/aarch64."
-            }
-        }
-      }
-
-      create<MavenPublication>("linuxExecutableAmd64") {
-        artifactId = "${executableSpec.publicationName.get()}-linux-amd64"
-        artifact(stagedLinuxAmd64Executable.singleFile) {
-          classifier = null
-          extension = "bin"
-          builtBy(stagedLinuxAmd64Executable)
-        }
-        pom {
-          name = "${executableSpec.publicationName.get()}-linux-amd64"
-          url = executableSpec.website
-          description =
-            executableSpec.documentationName.map { name ->
-              "Native $name executable for linux/amd64."
-            }
-        }
-      }
-
-      create<MavenPublication>("linuxExecutableAarch64") {
-        artifactId = "${executableSpec.publicationName.get()}-linux-aarch64"
-        artifact(stagedLinuxAarch64Executable.singleFile) {
-          classifier = null
-          extension = "bin"
-          builtBy(stagedLinuxAarch64Executable)
-        }
-        pom {
-          name = "${executableSpec.publicationName.get()}-linux-aarch64"
-          url = executableSpec.website
-          description =
-            executableSpec.documentationName.map { name ->
-              "Native $name executable for linux/aarch64."
-            }
-        }
-      }
-
-      create<MavenPublication>("alpineLinuxExecutableAmd64") {
-        artifactId = "${executableSpec.publicationName.get()}-alpine-linux-amd64"
-        artifact(stagedAlpineLinuxAmd64Executable.singleFile) {
-          classifier = null
-          extension = "bin"
-          builtBy(stagedAlpineLinuxAmd64Executable)
-        }
-        pom {
-          name = "${executableSpec.publicationName.get()}-alpine-linux-amd64"
-          url = executableSpec.website
-          description =
-            executableSpec.documentationName.map { name ->
-              "Native $name executable for linux/amd64 and statically linked to musl."
-            }
-        }
-      }
-
-      create<MavenPublication>("windowsExecutableAmd64") {
-        artifactId = "${executableSpec.publicationName.get()}-windows-amd64"
-        artifact(stagedWindowsAmd64Executable.singleFile) {
-          classifier = null
-          extension = "exe"
-          builtBy(stagedWindowsAmd64Executable)
-        }
-        pom {
-          name = "${executableSpec.publicationName.get()}-windows-amd64"
-          url = executableSpec.website
-          description =
-            executableSpec.documentationName.map { name ->
-              "Native $name executable for windows/amd64."
-            }
-        }
-      }
-    }
-  }
-}
-
-signing {
-  project.afterEvaluate {
-    sign(publishing.publications["linuxExecutableAarch64"])
-    sign(publishing.publications["linuxExecutableAmd64"])
-    sign(publishing.publications["macExecutableAarch64"])
-    sign(publishing.publications["macExecutableAmd64"])
-    sign(publishing.publications["alpineLinuxExecutableAmd64"])
-    sign(publishing.publications["windowsExecutableAmd64"])
-  }
-}

build-logic/src/main/kotlin/pklNativeLifecycle.gradle.kts

@@ -1,122 +0,0 @@
-/*
- * Copyright © 2024-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.
- */
-val assembleNativeMacOsAarch64 by tasks.registering { group = "build" }
-
-val assembleNativeMacOsAmd64 by tasks.registering { group = "build" }
-
-val assembleNativeLinuxAarch64 by tasks.registering { group = "build" }
-
-val assembleNativeLinuxAmd64 by tasks.registering { group = "build" }
-
-val assembleNativeAlpineLinuxAmd64 by tasks.registering { group = "build" }
-
-val assembleNativeWindowsAmd64 by tasks.registering { group = "build" }
-
-val testNativeMacOsAarch64 by tasks.registering { group = "verification" }
-
-val testNativeMacOsAmd64 by tasks.registering { group = "verification" }
-
-val testNativeLinuxAarch64 by tasks.registering { group = "verification" }
-
-val testNativeLinuxAmd64 by tasks.registering { group = "verification" }
-
-val testNativeAlpineLinuxAmd64 by tasks.registering { group = "verification" }
-
-val testNativeWindowsAmd64 by tasks.registering { group = "verification" }
-
-val buildInfo = project.extensions.getByType<BuildInfo>()
-
-private fun <T : Task> Task.wraps(other: TaskProvider<T>) {
-  dependsOn(other)
-  outputs.files(other)
-}
-
-val assembleNative by tasks.registering {
-  group = "build"
-
-  if (!buildInfo.isCrossArchSupported && buildInfo.isCrossArch) {
-    throw GradleException("Cross-arch builds are not supported on ${buildInfo.os.name}")
-  }
-
-  when {
-    buildInfo.os.isMacOsX && buildInfo.targetArch == "aarch64" -> {
-      wraps(assembleNativeMacOsAarch64)
-    }
-    buildInfo.os.isMacOsX && buildInfo.targetArch == "amd64" -> {
-      wraps(assembleNativeMacOsAmd64)
-    }
-    buildInfo.os.isLinux && buildInfo.targetArch == "aarch64" -> {
-      wraps(assembleNativeLinuxAarch64)
-    }
-    buildInfo.os.isLinux && buildInfo.targetArch == "amd64" -> {
-      if (buildInfo.musl) wraps(assembleNativeAlpineLinuxAmd64) else wraps(assembleNativeLinuxAmd64)
-    }
-    buildInfo.os.isWindows && buildInfo.targetArch == "amd64" -> {
-      wraps(assembleNativeWindowsAmd64)
-    }
-    else -> {
-      doLast {
-        throw GradleException(
-          "Cannot build targeting ${buildInfo.os.name}/${buildInfo.targetArch} with musl=${buildInfo.musl}"
-        )
-      }
-    }
-  }
-}
-
-val testNative by tasks.registering {
-  group = "verification"
-  dependsOn(assembleNative)
-
-  if (!buildInfo.isCrossArchSupported && buildInfo.isCrossArch) {
-    throw GradleException("Cross-arch builds are not supported on ${buildInfo.os.name}")
-  }
-
-  when {
-    buildInfo.os.isMacOsX && buildInfo.targetArch == "aarch64" -> {
-      dependsOn(testNativeMacOsAarch64)
-    }
-    buildInfo.os.isMacOsX && buildInfo.targetArch == "amd64" -> {
-      dependsOn(testNativeMacOsAmd64)
-    }
-    buildInfo.os.isLinux && buildInfo.targetArch == "aarch64" -> {
-      dependsOn(testNativeLinuxAarch64)
-    }
-    buildInfo.os.isLinux && buildInfo.targetArch == "amd64" -> {
-      if (buildInfo.musl) dependsOn(testNativeAlpineLinuxAmd64) else dependsOn(testNativeLinuxAmd64)
-    }
-    buildInfo.os.isWindows && buildInfo.targetArch == "amd64" -> {
-      dependsOn(testNativeWindowsAmd64)
-    }
-    else -> {
-      doLast {
-        throw GradleException(
-          "Cannot build targeting ${buildInfo.os.name}/${buildInfo.targetArch} with musl=${buildInfo.musl}"
-        )
-      }
-    }
-  }
-}
-
-val checkNative by tasks.registering {
-  group = "verification"
-  dependsOn(testNative)
-}
-
-val buildNative by tasks.registering {
-  group = "build"
-  dependsOn(checkNative)
-}

build-logic/src/main/kotlin/pklPublishLibrary.gradle.kts

@@ -1,38 +0,0 @@
-/*
- * Copyright © 2024-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.
- */
-plugins {
-  `maven-publish`
-  signing
-}
-
-publishing {
-  publications {
-    components.findByName("java")?.let { javaComponent ->
-      create<MavenPublication>("library") { from(javaComponent) }
-    }
-  }
-}
-
-configurePklPomMetadata()
-
-configurePomValidation()
-
-configurePklSigning()
-
-artifacts {
-  project.tasks.findByName("javadocJar")?.let { archives(it) }
-  project.tasks.findByName("sourcesJar")?.let { archives(it) }
-}

build-logic/src/main/kotlin/pklSpotlessFormat.gradle.kts

@@ -1,39 +0,0 @@
-/*
- * 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.
- */
-plugins { id("com.diffplug.spotless") }
-
-val pklFormatter by configurations.creating
-
-dependencies { pklFormatter(rootProject.project("pkl-formatter")) }
-
-spotless {
-  format("pkl") {
-    target("**/*.pkl")
-    addStep(PklFormatterStep(pklFormatter).create())
-    licenseHeaderFile(
-      rootProject.file("build-logic/src/main/resources/license-header.line-comment.txt"),
-      "/// ",
-    )
-    // disable ratcheting for Pkl sources
-    // make any change to pkl-formatter reformat the stdlib
-    ratchetFrom = null
-  }
-}
-
-for (taskName in
-  listOf("spotlessPkl", "spotlessPklApply", "spotlessPklCheck", "spotlessPklDiagnose")) {
-  tasks.named(taskName) { dependsOn(":pkl-formatter:assemble") }
-}

build.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -14,13 +14,16 @@
  * limitations under the License.
  */
 // https://youtrack.jetbrains.com/issue/KTIJ-19369
+@file:Suppress("DSL_SCOPE_VIOLATION")
+
 import org.jetbrains.gradle.ext.ActionDelegationConfig
 import org.jetbrains.gradle.ext.ActionDelegationConfig.TestRunner.PLATFORM
 import org.jetbrains.gradle.ext.ProjectSettings
+import org.jetbrains.gradle.ext.TaskTriggersConfig
 
 plugins {
-  id("pklAllProjects")
+  pklAllProjects
-  id("pklGraalVm")
+  pklGraalVm
 
   alias(libs.plugins.ideaExt)
   alias(libs.plugins.jmh) apply false
@@ -30,8 +33,8 @@ plugins {
 nexusPublishing {
   repositories {
     sonatype {
-      nexusUrl.set(uri("https://ossrh-staging-api.central.sonatype.com/service/local/"))
+      nexusUrl.set(uri("https://s01.oss.sonatype.org/service/local/"))
-      snapshotRepositoryUrl.set(uri("https://central.sonatype.com/repository/maven-snapshots/"))
+      snapshotRepositoryUrl.set(uri("https://s01.oss.sonatype.org/content/repositories/snapshots/"))
     }
   }
 }
@@ -45,6 +48,9 @@ idea {
         delegateBuildRunToGradle = true
         testRunner = PLATFORM
       }
+      configure<TaskTriggersConfig> {
+        afterSync(provider { project(":pkl-core").tasks.named("makeIntelliJAntlrPluginHappy") })
+      }
     }
   }
 }

buildSrc/build.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -13,23 +13,10 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+plugins { `kotlin-dsl` }
-
-plugins {
-  `kotlin-dsl`
-  `jvm-toolchains`
-}
-
-/**
- * To avoid the provisioning of multiple JDKs and other build issues, keep this value in sync with
- * the JVM toolchain versions in `BuildInfo.kt` and `gradle-daemon-jvm.properties`.
- */
-val toolchainVersion = 25
 
 dependencies {
   implementation(libs.downloadTaskPlugin)
-  implementation(libs.errorPronePlugin)
-  implementation(libs.nullawayPlugin)
   implementation(libs.spotlessPlugin)
   implementation(libs.kotlinPlugin) { exclude(module = "kotlin-android-extensions") }
   implementation(libs.shadowPlugin)
@@ -40,18 +27,8 @@ dependencies {
 }
 
 java {
-  toolchain {
+  sourceCompatibility = JavaVersion.VERSION_17
-    languageVersion = JavaLanguageVersion.of(toolchainVersion)
+  targetCompatibility = JavaVersion.VERSION_17
-    vendor = JvmVendorSpec.ADOPTIUM
-  }
 }
 
-tasks.withType<JavaCompile>().configureEach { options.release = toolchainVersion }
+kotlin { target { compilations.configureEach { kotlinOptions { jvmTarget = "17" } } } }
-
-kotlin {
-  jvmToolchain(toolchainVersion)
-  compilerOptions {
-    jvmTarget = JvmTarget.fromTarget(toolchainVersion.toString())
-    freeCompilerArgs.add("-Xjdk-release=$toolchainVersion")
-  }
-}

buildSrc/settings.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -15,7 +15,7 @@
  */
 @file:Suppress("UnstableApiUsage")
 
-rootProject.name = "build-logic"
+rootProject.name = "buildSrc"
 
 pluginManagement {
   repositories {
@@ -24,8 +24,6 @@ pluginManagement {
   }
 }
 
-plugins { id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0" }
-
 // makes ~/.gradle/init.gradle unnecessary and ~/.gradle/gradle.properties optional
 dependencyResolutionManagement {
   // use same version catalog as main build

buildSrc/src/main/kotlin/BuildInfo.kt

@@ -0,0 +1,133 @@
+/*
+ * Copyright © 2024 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.
+ */
+@file:Suppress("MemberVisibilityCanBePrivate")
+
+import java.io.File
+import org.gradle.api.Project
+import org.gradle.api.artifacts.VersionCatalog
+import org.gradle.api.artifacts.VersionCatalogsExtension
+import org.gradle.kotlin.dsl.getByType
+
+// `buildInfo` in main build scripts
+// `project.extensions.getByType<BuildInfo>()` in precompiled script plugins
+open class BuildInfo(project: Project) {
+  inner class GraalVm(val arch: String) {
+    val homeDir: String by lazy {
+      System.getenv("GRAALVM_HOME") ?: "${System.getProperty("user.home")}/.graalvm"
+    }
+
+    val version: String by lazy { libs.findVersion("graalVm").get().toString() }
+
+    val graalVmJdkVersion: String by lazy { libs.findVersion("graalVmJdkVersion").get().toString() }
+
+    val osName: String by lazy {
+      when {
+        os.isMacOsX -> "macos"
+        os.isLinux -> "linux"
+        os.isWindows -> "windows"
+        else -> throw RuntimeException("${os.familyName} is not supported.")
+      }
+    }
+
+    val baseName: String by lazy { "graalvm-jdk-${graalVmJdkVersion}_${osName}-${arch}_bin" }
+
+    val downloadUrl: String by lazy {
+      val jdkMajor = graalVmJdkVersion.takeWhile { it != '.' }
+      val extension = if (os.isWindows) "zip" else "tar.gz"
+      "https://download.oracle.com/graalvm/$jdkMajor/archive/$baseName.$extension"
+    }
+
+    val installDir: File by lazy { File(homeDir, baseName) }
+
+    val baseDir: String by lazy {
+      if (os.isMacOsX) "$installDir/Contents/Home" else installDir.toString()
+    }
+  }
+
+  /** Same logic as [org.gradle.internal.os.OperatingSystem#arch], which is protected. */
+  val arch: String by lazy {
+    when (val arch = System.getProperty("os.arch")) {
+      "x86" -> "i386"
+      "x86_64" -> "amd64"
+      "powerpc" -> "ppc"
+      else -> arch
+    }
+  }
+
+  val graalVmAarch64: GraalVm = GraalVm("aarch64")
+
+  val graalVmAmd64: GraalVm = GraalVm("x64")
+
+  val isCiBuild: Boolean by lazy { System.getenv("CI") != null }
+
+  val isReleaseBuild: Boolean by lazy { java.lang.Boolean.getBoolean("releaseBuild") }
+
+  val hasMuslToolchain: Boolean by lazy {
+    // see "install musl" in .circleci/jobs/BuildNativeJob.pkl
+    File(System.getProperty("user.home"), "staticdeps/bin/x86_64-linux-musl-gcc").exists()
+  }
+
+  val os: org.gradle.internal.os.OperatingSystem by lazy {
+    org.gradle.internal.os.OperatingSystem.current()
+  }
+
+  // could be `commitId: Provider<String> = project.provider { ... }`
+  val commitId: String by lazy {
+    // only run command once per build invocation
+    if (project === project.rootProject) {
+      val process =
+        ProcessBuilder()
+          .command("git", "rev-parse", "--short", "HEAD")
+          .directory(project.rootDir)
+          .start()
+      process.waitFor().also { exitCode ->
+        if (exitCode == -1) throw RuntimeException(process.errorStream.reader().readText())
+      }
+      process.inputStream.reader().readText().trim()
+    } else {
+      project.rootProject.extensions.getByType(BuildInfo::class.java).commitId
+    }
+  }
+
+  val commitish: String by lazy { if (isReleaseBuild) project.version.toString() else commitId }
+
+  val pklVersion: String by lazy {
+    if (isReleaseBuild) {
+      project.version.toString()
+    } else {
+      project.version.toString().replace("-SNAPSHOT", "-dev+$commitId")
+    }
+  }
+
+  val pklVersionNonUnique: String by lazy {
+    if (isReleaseBuild) {
+      project.version.toString()
+    } else {
+      project.version.toString().replace("-SNAPSHOT", "-dev")
+    }
+  }
+
+  // https://melix.github.io/blog/2021/03/version-catalogs-faq.html#_but_how_can_i_use_the_catalog_in_em_plugins_em_defined_in_code_buildsrc_code
+  val libs: VersionCatalog by lazy {
+    project.extensions.getByType<VersionCatalogsExtension>().named("libs")
+  }
+
+  init {
+    if (!isReleaseBuild) {
+      project.version = "${project.version}-SNAPSHOT"
+    }
+  }
+}

buildSrc/src/main/kotlin/ExecutableJar.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -22,11 +22,12 @@ import org.gradle.api.tasks.OutputFile
 import org.gradle.api.tasks.TaskAction
 
 /**
- * Builds a self-contained Pkl CLI Jar that is directly executable on Windows, macOS, and Linux.
+ * Builds a self-contained Pkl CLI Jar that is directly executable on *nix and executable with `java
+ * -jar` on Windows.
  *
  * For direct execution, the `java` command must be on the PATH.
  *
- * Technique borrowed from [Mill](https://mill-build.org/blog/5-executable-jars.html).
+ * https://skife.org/java/unix/2011/06/20/really_executable_jars.html
  */
 abstract class ExecutableJar : DefaultTask() {
   @get:InputFile abstract val inJar: RegularFileProperty
@@ -36,32 +37,16 @@ abstract class ExecutableJar : DefaultTask() {
   @get:Input abstract val jvmArgs: ListProperty<String>
 
   @TaskAction
-  @Suppress("unused")
   fun buildJar() {
     val inFile = inJar.get().asFile
     val outFile = outJar.get().asFile
     val escapedJvmArgs = jvmArgs.get().joinToString(separator = " ") { "\"$it\"" }
-    val unixStartScript =
+    val startScript =
       """
-      @ 2>/dev/null # 2>nul & echo off & goto BOF
+      #!/bin/sh
-      :
+      exec java $escapedJvmArgs -jar $0 "$@"
-      exec java $escapedJvmArgs -jar "$0" "$@"
-      exit
     """
-        .trimIndent()
+        .trimIndent() + "\n\n\n"
-    val windowsStartScript =
-      """
-      :BOF
-      setlocal
-      @echo off
-      java $escapedJvmArgs -jar "%~dpnx0" %*
-      endlocal
-      exit /B %errorlevel%
-      """
-        .trimIndent()
-        // need crlf endings for Windows portion of script
-        .replace("\n", "\r\n")
-    val startScript = unixStartScript + "\r\n" + windowsStartScript + "\r\n".repeat(3)
     outFile.outputStream().use { outStream ->
       startScript.byteInputStream().use { it.copyTo(outStream) }
       inFile.inputStream().use { it.copyTo(outStream) }

buildSrc/src/main/kotlin/GradlePluginTests.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.

buildSrc/src/main/kotlin/GradleVersionInfo.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.

buildSrc/src/main/kotlin/HtmlValidator.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.

buildSrc/src/main/kotlin/MergeSourcesJars.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -57,7 +57,7 @@ open class MergeSourcesJars : DefaultTask() {
     // a word or a period character. should catch most cases.
     val importPattern =
       Pattern.compile(
-        "(?<!([\\w.]))(" + relocatedPkgs.keys.joinToString("|") { it.replace(".", "\\.") } + ")"
+        "(?<!(\\w|\\.))(" + relocatedPkgs.keys.joinToString("|") { it.replace(".", "\\.") } + ")"
       )
 
     val sourceFileExts = sourceFileExtensions.get()
@@ -70,7 +70,7 @@ open class MergeSourcesJars : DefaultTask() {
         val details = this
         if (details.isDirectory) return@visit
 
-        var path = details.relativePath.parent!!.pathString
+        var path = details.relativePath.parent.pathString
         val relocatedPath = relocatedPaths.keys.find { path.startsWith(it) }
         if (relocatedPath != null) {
           path = path.replace(relocatedPath, relocatedPaths.getValue(relocatedPath))
@@ -101,7 +101,7 @@ open class MergeSourcesJars : DefaultTask() {
       project.zipTree(jar).visit {
         val details = this
         if (details.isDirectory) return@visit // avoid adding empty dirs
-        result.add(details.relativePath.parent!!.pathString)
+        result.add(details.relativePath.parent.pathString)
       }
     }
     return result
@@ -111,7 +111,7 @@ open class MergeSourcesJars : DefaultTask() {
     relocatedPkgs: Map<String, String>,
     details: FileVisitDetails,
     sourceText: String,
-    importPattern: Pattern,
+    importPattern: Pattern
   ): String {
     val matcher = importPattern.matcher(sourceText)
     val buffer = StringBuffer()

buildSrc/src/main/kotlin/ResolveSourcesJars.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.

buildSrc/src/main/kotlin/pklAllProjects.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024-2025 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.
@@ -15,19 +15,18 @@
  */
 import com.diffplug.gradle.spotless.KotlinGradleExtension
 import org.gradle.accessors.dm.LibrariesForLibs
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
 
 plugins { id("com.diffplug.spotless") }
 
 val buildInfo = extensions.create<BuildInfo>("buildInfo", project)
 
+dependencyLocking { lockAllConfigurations() }
+
 configurations {
   val rejectedVersionSuffix = Regex("-alpha|-beta|-eap|-m|-rc|-snapshot", RegexOption.IGNORE_CASE)
   configureEach {
     resolutionStrategy {
-      // forbid dependencies whose pom.xml's include version ranges, because this will lead to
-      // unreproducible builds.
-
-      failOnDynamicVersions()
       componentSelection {
         all {
           if (rejectedVersionSuffix.containsMatchIn(candidate.version)) {
@@ -42,9 +41,17 @@ configurations {
   }
 }
 
-tasks.withType<JavaCompile>().configureEach {
+plugins.withType(JavaPlugin::class).configureEach {
-  javaCompiler = buildInfo.javaCompiler
+  val java = project.extensions.getByType<JavaPluginExtension>()
-  options.release = buildInfo.jvmTarget
+  java.sourceCompatibility = JavaVersion.VERSION_17
+  java.targetCompatibility = JavaVersion.VERSION_17
+}
+
+tasks.withType<KotlinCompile>().configureEach {
+  kotlinOptions {
+    jvmTarget = "17"
+    freeCompilerArgs = freeCompilerArgs + listOf("-Xjsr305=strict", "-Xjvm-default=all")
+  }
 }
 
 plugins.withType(IdeaPlugin::class).configureEach {
@@ -65,7 +72,7 @@ plugins.withType(MavenPublishPlugin::class).configureEach {
     repositories {
       maven {
         name = "projectLocal" // affects task names
-        url = rootDir.resolve("build/m2").toURI()
+        url = uri("file:///$rootDir/build/m2")
       }
     }
     // use resolved/locked (e.g., `1.15`)
@@ -79,6 +86,13 @@ plugins.withType(MavenPublishPlugin::class).configureEach {
   }
 }
 
+// settings.gradle.kts sets `--write-locks`
+// if Gradle command line contains this task name
+val updateDependencyLocks by
+  tasks.registering {
+    doLast { configurations.filter { it.isCanBeResolved }.forEach { it.resolve() } }
+  }
+
 val allDependencies by tasks.registering(DependencyReportTask::class)
 
 tasks.withType(Test::class).configureEach {
@@ -87,6 +101,7 @@ tasks.withType(Test::class).configureEach {
   }
   debugOptions {
     enabled = System.getProperty("jvmdebug")?.toBoolean() ?: false
+    @Suppress("UnstableApiUsage")
     host = "*"
     port = 5005
     suspend = true
@@ -97,6 +112,7 @@ tasks.withType(Test::class).configureEach {
 tasks.withType(JavaExec::class).configureEach {
   debugOptions {
     enabled = System.getProperty("jvmdebug")?.toBoolean() ?: false
+    @Suppress("UnstableApiUsage")
     host = "*"
     port = 5005
     suspend = true
@@ -108,7 +124,7 @@ tasks.withType(JavaExec::class).configureEach {
 private val libs = the<LibrariesForLibs>()
 
 private val licenseHeaderFile by lazy {
-  rootProject.file("build-logic/src/main/resources/license-header.star-block.txt")
+  rootProject.file("buildSrc/src/main/resources/license-header.star-block.txt")
 }
 
 private fun KotlinGradleExtension.configureFormatter() {
@@ -117,40 +133,26 @@ private fun KotlinGradleExtension.configureFormatter() {
 }
 
 val originalRemoteName = System.getenv("PKL_ORIGINAL_REMOTE_NAME") ?: "origin"
-// if we're running against a release branch (or a PR targeted at one), use that branch for
-// ratcheting
-// these env vars are set by GitHub actions:
-// https://docs.github.com/en/actions/reference/workflows-and-actions/variables#default-environment-variables
-val ratchetBranchName =
-  (System.getenv("GITHUB_BASE_REF") ?: System.getenv("GITHUB_REF_NAME"))?.let {
-    if (it.startsWith("release/")) it else null
-  } ?: "main"
 
 spotless {
-  ratchetFrom = "$originalRemoteName/$ratchetBranchName"
+  ratchetFrom = "$originalRemoteName/main"
 
-  val revertYearOnlyChangesStep =
+  // When building root project, format buildSrc files too.
-    RevertYearOnlyChangesStep(rootProject.rootDir, ratchetFrom!!).create()
+  // We need this because buildSrc is not a subproject of the root project, so a top-level
-
+  // `spotlessApply` will not trigger `buildSrc:spotlessApply`.
-  // When building root project, format build-logic files too.
+  if (project === rootProject) {
-  // We need this because build-logic is not a subproject of the root project, so a top-level
-  // `spotlessApply` will not trigger `build-logic:spotlessApply`.
-  if (project.path == rootProject.path) {
     kotlinGradle {
       configureFormatter()
-      addStep(revertYearOnlyChangesStep)
+      target("*.kts", "buildSrc/*.kts", "buildSrc/src/*/kotlin/**/*.kts")
-      target("*.kts", "build-logic/*.kts", "build-logic/src/*/kotlin/**/*.kts")
     }
     kotlin {
       ktfmt(libs.versions.ktfmt.get()).googleStyle()
-      target("build-logic/src/*/kotlin/**/*.kt")
+      target("buildSrc/src/*/kotlin/**/*.kt")
       licenseHeaderFile(licenseHeaderFile)
-      addStep(revertYearOnlyChangesStep)
     }
   } else {
     kotlinGradle {
       configureFormatter()
-      addStep(revertYearOnlyChangesStep)
       target("*.kts")
     }
   }

buildSrc/src/main/kotlin/pklFatJar.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -15,6 +15,7 @@
  */
 import org.gradle.api.GradleException
 import org.gradle.api.artifacts.Configuration
+import org.gradle.api.component.AdhocComponentWithVariants
 import org.gradle.api.publish.maven.MavenPublication
 import org.gradle.api.tasks.bundling.Jar
 import org.gradle.api.tasks.testing.Test
@@ -23,7 +24,7 @@ import org.gradle.kotlin.dsl.*
 plugins {
   `java-library`
   `maven-publish`
-  id("com.gradleup.shadow")
+  id("com.github.johnrengelman.shadow")
 }
 
 // make fat Jar available to other subprojects
@@ -38,53 +39,39 @@ val firstPartySourcesJarsConfiguration: Configuration =
 val relocations =
   mapOf(
     // pkl-core dependencies
+    "org.antlr.v4." to "org.pkl.thirdparty.antlr.v4.",
+    "com.oracle.truffle" to "org.pkl.thirdparty.truffle",
+    "org.graalvm." to "org.pkl.thirdparty.graalvm.",
     "org.organicdesign.fp." to "org.pkl.thirdparty.paguro.",
     "org.snakeyaml.engine." to "org.pkl.thirdparty.snakeyaml.engine.",
     "org.msgpack." to "org.pkl.thirdparty.msgpack.",
-    "org.w3c.dom." to "org.pkl.thirdparty.w3c.dom.",
+    "org.w3c.dom." to "org.pkl.thirdparty.w3c.dom",
     "com.oracle.svm.core." to "org.pkl.thirdparty.svm.",
 
     // pkl-cli dependencies
     "org.jline." to "org.pkl.thirdparty.jline.",
     "com.github.ajalt.clikt." to "org.pkl.thirdparty.clikt.",
-    "com.github.ajalt.colormath." to "org.pkl.thirdparty.colormath.",
-    "com.github.ajalt.mordant." to "org.pkl.thirdparty.mordant.",
-    "com.sun.jna." to "org.pkl.thirdparty.jna.",
     "kotlin." to "org.pkl.thirdparty.kotlin.",
     "kotlinx." to "org.pkl.thirdparty.kotlinx.",
     "org.intellij." to "org.pkl.thirdparty.intellij.",
-    "org.fusesource.jansi." to "org.pkl.thirdparty.jansi.",
+    "org.fusesource.jansi." to "org.pkl.thirdparty.jansi",
-    "org.fusesource.hawtjni." to "org.pkl.thirdparty.hawtjni.",
+    "org.fusesource.hawtjni." to "org.pkl.thirdparty.hawtjni",
 
     // pkl-doc dependencies
     "org.commonmark." to "org.pkl.thirdparty.commonmark.",
     "org.jetbrains." to "org.pkl.thirdparty.jetbrains.",
-    "_COROUTINE." to "org.pkl.thirdparty.kotlinx._COROUTINE.",
 
     // pkl-config-java dependencies
     "io.leangen.geantyref." to "org.pkl.thirdparty.geantyref.",
 
     // pkl-codegen-java dependencies
-    "com.palantir.javapoet." to "org.pkl.thirdparty.javapoet.",
+    "com.squareup.javapoet." to "org.pkl.thirdparty.javapoet.",
 
     // pkl-codegen-kotlin dependencies
     "com.squareup.kotlinpoet." to "org.pkl.thirdparty.kotlinpoet.",
   )
 
-for ((key, value) in relocations) {
+val nonRelocations = listOf("com/oracle/truffle/")
-  if (!key.endsWith(".")) {
-    throw GradleException(
-      "Invalid relocation `\"$key\" to \"$value\"`: `$key` should end with a dot"
-    )
-  }
-  if (!value.endsWith(".")) {
-    throw GradleException(
-      "Invalid relocation `\"$key\" to \"$value\"`: `$value` should end with a dot"
-    )
-  }
-}
-
-val nonRelocations = listOf("com/oracle/truffle/", "org/graalvm/", "org/jspecify")
 
 tasks.shadowJar {
   inputs.property("relocations", relocations)
@@ -93,32 +80,12 @@ tasks.shadowJar {
 
   configurations = listOf(project.configurations.runtimeClasspath.get())
 
-  addMultiReleaseAttribute = true
-
-  // not required at runtime / fat JARs can't be used in native-image builds anyway
-  exclude("org/pkl/cli/svm/**")
-
   exclude("META-INF/maven/**")
   exclude("META-INF/upgrade/**")
+  exclude("META-INF/versions/19/**")
 
-  exclude("DebugProbesKt.bin")
+  // org.antlr.v4.runtime.misc.RuleDependencyProcessor
-
+  exclude("META-INF/services/javax.annotation.processing.Processor")
-  val info = project.extensions.getByType<BuildInfo>()
-  val minimumJvmTarget = JavaVersion.toVersion(info.jvmTarget)
-
-  manifest.attributes(
-    // Certain exports need to be added to the Java modulepath for Java 17 to work properly with
-    // shaded JARs. See the following link for an explanation of this syntax:
-    // https://bugs.openjdk.org/browse/JDK-8335225
-    "Add-Exports" to info.jpmsExportsForJarManifest
-  )
-
-  // effectively, this results in calls excluding:
-  // `META-INF/versions/{18-25}/**`
-  // at the time of this writing; multi-release JARs beyond JDK 21 break the current
-  // version of the Shadow plugin, and aren't needed for Truffle's use by Pkl.
-  JavaVersionRange.startingAt(JavaLanguageVersion.of(minimumJvmTarget.majorVersion.toInt() + 1))
-    .forEach { exclude("META-INF/versions/${it.asInt()}/**") }
 
   exclude("module-info.*")
 
@@ -130,7 +97,10 @@ tasks.shadowJar {
   mergeServiceFiles()
 }
 
-shadow { addShadowVariantIntoJavaComponent = false }
+// workaround for https://github.com/johnrengelman/shadow/issues/651
+components.withType(AdhocComponentWithVariants::class.java).forEach { c ->
+  c.withVariantsFromConfiguration(project.configurations.shadowRuntimeElements.get()) { skip() }
+}
 
 val testFatJar by
   tasks.registering(Test::class) {
@@ -148,7 +118,8 @@ val testFatJar by
 
 tasks.check { dependsOn(testFatJar) }
 
-val validateFatJar by tasks.registering {
+val validateFatJar by
+  tasks.registering {
     val outputFile = layout.buildDirectory.file("validateFatJar/result.txt")
     inputs.files(tasks.shadowJar)
     inputs.property("nonRelocations", nonRelocations)
@@ -177,7 +148,7 @@ val validateFatJar by tasks.registering {
         throw GradleException("Found unshadowed files:\n" + unshadowedFiles.joinToString("\n"))
       }
     }
-}
+  }
 
 tasks.check { dependsOn(validateFatJar) }
 
@@ -207,7 +178,7 @@ artifacts { add("fatJar", tasks.shadowJar) }
 publishing {
   publications {
     named<MavenPublication>("fatJar") {
-      from(components["shadow"])
+      project.shadow.component(this)
 
       // sources Jar is fat
       artifact(fatSourcesJar.flatMap { it.outputJar.asFile }) { classifier = "sources" }

buildSrc/src/main/kotlin/pklGraalVm.gradle.kts

@@ -0,0 +1,130 @@
+/*
+ * Copyright © 2024 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.
+ */
+import de.undercouch.gradle.tasks.download.Download
+import de.undercouch.gradle.tasks.download.Verify
+import java.nio.file.*
+import java.util.UUID
+import kotlin.io.path.createDirectories
+
+plugins { id("de.undercouch.download") }
+
+val buildInfo = project.extensions.getByType<BuildInfo>()
+
+val BuildInfo.GraalVm.downloadFile
+  get(): File {
+    val extension = if (buildInfo.os.isWindows) "zip" else "tar.gz"
+    return file(homeDir).resolve("${baseName}.$extension")
+  }
+
+// tries to minimize chance of corruption by download-to-temp-file-and-move
+val downloadGraalVmAarch64 by
+  tasks.registering(Download::class) { configureDownloadGraalVm(buildInfo.graalVmAarch64) }
+
+val downloadGraalVmAmd64 by
+  tasks.registering(Download::class) { configureDownloadGraalVm(buildInfo.graalVmAmd64) }
+
+fun Download.configureDownloadGraalVm(graalvm: BuildInfo.GraalVm) {
+  onlyIf { !graalvm.installDir.exists() }
+  doLast { println("Downloaded GraalVm to ${graalvm.downloadFile}") }
+
+  src(graalvm.downloadUrl)
+  dest(graalvm.downloadFile)
+  overwrite(false)
+  tempAndMove(true)
+}
+
+val verifyGraalVmAarch64 by
+  tasks.registering(Verify::class) {
+    configureVerifyGraalVm(buildInfo.graalVmAarch64)
+    dependsOn(downloadGraalVmAarch64)
+  }
+
+val verifyGraalVmAmd64 by
+  tasks.registering(Verify::class) {
+    configureVerifyGraalVm(buildInfo.graalVmAmd64)
+    dependsOn(downloadGraalVmAmd64)
+  }
+
+fun Verify.configureVerifyGraalVm(graalvm: BuildInfo.GraalVm) {
+  onlyIf { !graalvm.installDir.exists() }
+
+  src(graalvm.downloadFile)
+  checksum(
+    buildInfo.libs.findVersion("graalVmSha256-${graalvm.osName}-${graalvm.arch}").get().toString()
+  )
+  algorithm("SHA-256")
+}
+
+// minimize chance of corruption by extract-to-random-dir-and-flip-symlink
+val installGraalVmAarch64 by
+  tasks.registering {
+    dependsOn(verifyGraalVmAarch64)
+    configureInstallGraalVm(buildInfo.graalVmAarch64)
+  }
+
+// minimize chance of corruption by extract-to-random-dir-and-flip-symlink
+val installGraalVmAmd64 by
+  tasks.registering {
+    dependsOn(verifyGraalVmAmd64)
+    configureInstallGraalVm(buildInfo.graalVmAmd64)
+  }
+
+fun Task.configureInstallGraalVm(graalVm: BuildInfo.GraalVm) {
+  onlyIf { !graalVm.installDir.exists() }
+
+  doLast {
+    val distroDir = Paths.get(graalVm.homeDir, UUID.randomUUID().toString())
+
+    try {
+      distroDir.createDirectories()
+      println("Extracting ${graalVm.downloadFile} into $distroDir")
+      // faster and more reliable than Gradle's `copy { from tarTree() }`
+      exec {
+        workingDir = file(distroDir)
+        executable = "tar"
+        args("--strip-components=1", "-xzf", graalVm.downloadFile)
+      }
+
+      val distroBinDir =
+        if (buildInfo.os.isMacOsX) distroDir.resolve("Contents/Home/bin")
+        else distroDir.resolve("bin")
+
+      println("Installing native-image into $distroDir")
+      exec {
+        val executableName = if (buildInfo.os.isWindows) "gu.cmd" else "gu"
+        executable = distroBinDir.resolve(executableName).toString()
+        args("install", "--no-progress", "native-image")
+      }
+
+      println("Creating symlink ${graalVm.installDir} for $distroDir")
+      val tempLink = Paths.get(graalVm.homeDir, UUID.randomUUID().toString())
+      Files.createSymbolicLink(tempLink, distroDir)
+      try {
+        Files.move(tempLink, graalVm.installDir.toPath(), StandardCopyOption.ATOMIC_MOVE)
+      } catch (e: Exception) {
+        try {
+          delete(tempLink.toFile())
+        } catch (ignored: Exception) {}
+        throw e
+      }
+    } catch (e: Exception) {
+      try {
+        delete(distroDir)
+      } catch (ignored: Exception) {}
+      throw e
+    }
+  }
+}

buildSrc/src/main/kotlin/pklGradlePluginTest.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -21,31 +21,26 @@ tasks.addRule("Pattern: compatibilityTest[All|Releases|Latest|Candidate|Nightly|
   val taskName = this
   val matchResult = Regex("compatibilityTest(.+)").matchEntire(taskName) ?: return@addRule
 
-  // https://github.com/gradle/gradle/issues/32599
-  @Suppress("DEPRECATION")
   when (val taskNameSuffix = matchResult.groupValues[1]) {
     "All" ->
       task("compatibilityTestAll") {
         dependsOn(
           "compatibilityTestReleases",
           "compatibilityTestCandidate",
-          "compatibilityTestNightly",
+          "compatibilityTestNightly"
         )
       }
     // releases in configured range
     "Releases" ->
       task("compatibilityTestReleases") {
         val versionInfos = GradleVersionInfo.fetchReleases()
-        val allVersions =
+        val versionsToTestAgainst =
-          versionInfos
+          versionInfos.filter { versionInfo ->
-            .filter { versionInfo ->
             val v = versionInfo.gradleVersion
             !versionInfo.broken &&
               v in gradlePluginTests.minGradleVersion..gradlePluginTests.maxGradleVersion &&
               v !in gradlePluginTests.skippedGradleVersions
           }
-            .sortedBy { it.gradleVersion }
-        val versionsToTestAgainst = listOf(allVersions.first(), allVersions.last())
 
         dependsOn(versionsToTestAgainst.map { createCompatibilityTestTask(it) })
       }
@@ -84,16 +79,16 @@ tasks.addRule("Pattern: compatibilityTest[All|Releases|Latest|Candidate|Nightly|
     else ->
       createCompatibilityTestTask(
         taskNameSuffix,
-        "https://services.gradle.org/distributions-snapshots/gradle-$taskNameSuffix-bin.zip",
+        "https://services.gradle.org/distributions-snapshots/gradle-$taskNameSuffix-bin.zip"
       )
   }
 }
 
-fun createCompatibilityTestTask(versionInfo: GradleVersionInfo): TaskProvider<Test> =
+fun createCompatibilityTestTask(versionInfo: GradleVersionInfo): Task =
   createCompatibilityTestTask(versionInfo.version, versionInfo.downloadUrl)
 
-fun createCompatibilityTestTask(version: String, downloadUrl: String): TaskProvider<Test> {
+fun createCompatibilityTestTask(version: String, downloadUrl: String): Task {
-  return tasks.register("compatibilityTest$version", Test::class.java) {
+  return tasks.create("compatibilityTest$version", Test::class.java) {
     mustRunAfter(tasks.test)
 
     maxHeapSize = tasks.test.get().maxHeapSize

buildSrc/src/main/kotlin/pklHtmlValidator.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -23,27 +23,25 @@ val validatorConfiguration: Configuration =
   configurations.create("validator") {
     resolutionStrategy.eachDependency {
       if (requested.group == "log4j" && requested.name == "log4j") {
-        useTarget(buildInfo.libs.findLibrary("log4j12Api").get())
+        @Suppress("UnstableApiUsage") useTarget(buildInfo.libs.findLibrary("log4j12Api").get())
         because("mitigate critical security vulnerabilities")
       }
     }
   }
 
 dependencies {
+  @Suppress("UnstableApiUsage")
   validatorConfiguration(buildInfo.libs.findLibrary("nuValidator").get()) {
-    // remove unnecessary dependencies
+    // we only want jetty-util and jetty-util-ajax (with the right version)
-    // (some of the requested versions don't even exist on Maven Central)
+    // couldn't find a more robust way to express this
-    exclude(group = "org.eclipse.jetty", module = "jetty-alpn-client")
     exclude(group = "org.eclipse.jetty", module = "jetty-continuation")
     exclude(group = "org.eclipse.jetty", module = "jetty-http")
+    exclude(group = "org.eclipse.jetty", module = "jetty-io")
     exclude(group = "org.eclipse.jetty", module = "jetty-security")
     exclude(group = "org.eclipse.jetty", module = "jetty-server")
     exclude(group = "org.eclipse.jetty", module = "jetty-servlets")
-    exclude(group = "org.eclipse.jetty", module = "jetty-jakarta-servlet-api")
-    exclude(group = "org.eclipse.jetty.toolchain")
     exclude(group = "javax.servlet")
-    exclude(group = "org.apache.commons", module = "commons-fileupload2-core")
+    exclude(group = "commons-fileupload")
-    exclude(group = "org.apache.commons", module = "commons-fileupload2-jakarta-servlet5")
   }
 }
 

buildSrc/src/main/kotlin/pklJavaLibrary.gradle.kts

@@ -0,0 +1,88 @@
+/*
+ * Copyright © 2024 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.
+ */
+@file:Suppress("HttpUrlsUsage")
+
+import org.gradle.accessors.dm.LibrariesForLibs
+
+plugins {
+  `java-library`
+  id("pklKotlinTest")
+  id("com.diffplug.spotless")
+}
+
+// make sources Jar available to other subprojects
+val sourcesJarConfiguration = configurations.register("sourcesJar")
+
+// Version Catalog library symbols.
+val libs = the<LibrariesForLibs>()
+
+java {
+  withSourcesJar() // creates `sourcesJar` task
+  withJavadocJar()
+}
+
+artifacts {
+  // make sources Jar available to other subprojects
+  add("sourcesJar", tasks["sourcesJar"])
+}
+
+spotless {
+  java {
+    googleJavaFormat(libs.versions.googleJavaFormat.get())
+    target("src/*/java/**/*.java")
+    licenseHeaderFile(rootProject.file("buildSrc/src/main/resources/license-header.star-block.txt"))
+  }
+  kotlin {
+    ktfmt(libs.versions.ktfmt.get()).googleStyle()
+    target("src/*/kotlin/**/*.kt")
+    licenseHeaderFile(rootProject.file("buildSrc/src/main/resources/license-header.star-block.txt"))
+  }
+}
+
+tasks.compileKotlin { enabled = false }
+
+tasks.jar {
+  manifest {
+    attributes += mapOf("Automatic-Module-Name" to "org.${project.name.replace("-", ".")}")
+  }
+}
+
+tasks.javadoc {
+  classpath = sourceSets.main.get().output + sourceSets.main.get().compileClasspath
+  source = sourceSets.main.get().allJava
+  title = "${project.name} ${project.version} API"
+  (options as StandardJavadocDocletOptions).addStringOption("Xdoclint:none", "-quiet")
+}
+
+val workAroundKotlinGradlePluginBug by
+  tasks.registering {
+    doLast {
+      // Works around this problem, which sporadically appears and disappears in different
+      // subprojects:
+      // A problem was found with the configuration of task ':pkl-executor:compileJava' (type
+      // 'JavaCompile').
+      // > Directory '[...]/pkl/pkl-executor/build/classes/kotlin/main'
+      // specified for property 'compileKotlinOutputClasses' does not exist.
+      layout.buildDirectory.dir("classes/kotlin/main").get().asFile.mkdirs()
+    }
+  }
+
+tasks.compileJava {
+  dependsOn(workAroundKotlinGradlePluginBug)
+  // TODO: determine correct limits for Truffle specializations
+  // (see https://graalvm.slack.com/archives/CNQSB2DHD/p1712380902746829)
+  options.compilerArgs.add("-Atruffle.dsl.SuppressWarnings=truffle-limit")
+}

buildSrc/src/main/kotlin/pklKotlinLibrary.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -15,15 +15,26 @@
  */
 import org.gradle.accessors.dm.LibrariesForLibs
 
-plugins { id("pklJavaLibrary") }
+plugins {
+  id("pklJavaLibrary")
+
+  kotlin("jvm")
+}
 
 val buildInfo = project.extensions.getByType<BuildInfo>()
 
+// Version Catalog library symbols.
 val libs = the<LibrariesForLibs>()
 
 dependencies {
-  // Kotlin libraries typically expose stdlib types in their public APIs.
+  // At least some of our kotlin APIs contain Kotlin stdlib types
-  // Therefore, the stdlib must be available on the consumer's compile classpath,
+  // that aren't compiled away by kotlinc (e.g., `kotlin.Function`).
-  // and "implementation" is not sufficient.
+  // So let's be conservative and default to `api` for now.
-  api(libs.kotlinStdLib)
+  // For Kotlin APIs that only target Kotlin users (e.g., pkl-config-kotlin),
+  // it won't make a difference.
+  api(buildInfo.libs.findLibrary("kotlinStdLib").get())
+}
+
+tasks.compileKotlin {
+  enabled = true // disabled by pklJavaLibrary
 }

buildSrc/src/main/kotlin/pklKotlinTest.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -14,27 +14,19 @@
  * limitations under the License.
  */
 import java.net.URI
-import org.gradle.accessors.dm.LibrariesForLibs
 import org.gradle.api.tasks.testing.logging.TestExceptionFormat
 
-plugins {
+plugins { kotlin("jvm") }
-  `jvm-test-suite`
-  id("pklKotlinBase")
-}
 
 val buildInfo = project.extensions.getByType<BuildInfo>()
 
-val libs = the<LibrariesForLibs>()
-
 dependencies {
-  testImplementation(libs.kotlinStdLib)
+  testImplementation(buildInfo.libs.findLibrary("assertj").get())
+  testImplementation(buildInfo.libs.findLibrary("junitApi").get())
+  testImplementation(buildInfo.libs.findLibrary("junitParams").get())
+  testImplementation(buildInfo.libs.findLibrary("kotlinStdLib").get())
 
-  testImplementation(libs.assertj)
+  testRuntimeOnly(buildInfo.libs.findLibrary("junitEngine").get())
-  testImplementation(libs.junitApi)
-  testImplementation(libs.junitParams)
-
-  testRuntimeOnly(libs.junitEngine)
-  testRuntimeOnly(libs.junitLauncher)
 }
 
 tasks.withType<Test>().configureEach {
@@ -45,7 +37,7 @@ tasks.withType<Test>().configureEach {
   // enable checking of stdlib return types
   systemProperty("org.pkl.testMode", "true")
 
-  reports.named("html") { required = true }
+  reports.named("html") { enabled = true }
 
   testLogging { exceptionFormat = TestExceptionFormat.FULL }
 

buildSrc/src/main/kotlin/pklNativeBuild.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -13,12 +13,10 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-package org.pkl.parser;
+val assembleNative by tasks.registering {}
 
-import org.pkl.parser.syntax.generic.Node;
+val testNative by tasks.registering {}
 
-public final class GenericParser {
+val checkNative by tasks.registering { dependsOn(testNative) }
-  public Node parseModule(String source) {
+
-    return new GenericParserImpl(source).parseModule();
+val buildNative by tasks.registering { dependsOn(assembleNative, checkNative) }
-  }
-}

buildSrc/src/main/kotlin/pklPublishLibrary.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -15,18 +15,19 @@
  */
 import java.nio.charset.StandardCharsets
 import java.util.Base64
-import org.gradle.api.Project
-import org.gradle.api.publish.PublishingExtension
-import org.gradle.api.publish.maven.MavenPublication
-import org.gradle.api.publish.maven.tasks.AbstractPublishToMaven
 import org.gradle.api.publish.maven.tasks.GenerateMavenPom
-import org.gradle.kotlin.dsl.*
-import org.gradle.plugins.signing.SigningExtension
 
-/** Configures common POM metadata (licenses, developers, SCM, etc.) for all Pkl publications. */
+plugins {
-fun Project.configurePklPomMetadata() {
+  `maven-publish`
-  extensions.configure<PublishingExtension> {
+  signing
-    publications.withType<MavenPublication>().configureEach {
+}
+
+publishing {
+  publications {
+    components.findByName("java")?.let { javaComponent ->
+      create<MavenPublication>("library") { from(javaComponent) }
+    }
+    withType<MavenPublication>().configureEach {
       pom {
         name.set(artifactId)
         licenses {
@@ -45,7 +46,7 @@ fun Project.configurePklPomMetadata() {
         scm {
           connection.set("scm:git:git://github.com/apple/pkl.git")
           developerConnection.set("scm:git:ssh://github.com/apple/pkl.git")
-          val buildInfo = extensions.getByType<BuildInfo>()
+          val buildInfo = project.extensions.getByType<BuildInfo>()
           url.set("https://github.com/apple/pkl/tree/${buildInfo.commitish}")
         }
         issueManagement {
@@ -53,17 +54,16 @@ fun Project.configurePklPomMetadata() {
           url.set("https://github.com/apple/pkl/issues")
         }
         ciManagement {
-          system.set("GitHub Actions")
+          system.set("Circle CI")
-          url.set("https://github.com/apple/pkl/actions")
+          url.set("https://app.circleci.com/pipelines/github/apple/pkl")
         }
       }
     }
   }
 }
 
-/** Configures POM validation task to check for unresolved versions and snapshots in releases. */
+val validatePom by
-fun Project.configurePomValidation() {
+  tasks.registering {
-  val validatePom by tasks.registering {
     if (tasks.findByName("generatePomFileForLibraryPublication") == null) {
       return@registering
     }
@@ -87,7 +87,7 @@ fun Project.configurePomValidation() {
         val unresolvedVersion = Regex("<version>.*[+,()\\[\\]].*</version>")
         val matches = unresolvedVersion.findAll(text).toList()
         if (matches.isNotEmpty()) {
-          throw org.gradle.api.GradleException(
+          throw GradleException(
             """
         Found unresolved version selector(s) in generated POM:
         ${matches.joinToString("\n") { it.groupValues[0] }}
@@ -102,7 +102,7 @@ fun Project.configurePomValidation() {
         val snapshotVersion = Regex("<version>.*-SNAPSHOT</version>")
         val matches = snapshotVersion.findAll(text).toList()
         if (matches.isNotEmpty()) {
-          throw org.gradle.api.GradleException(
+          throw GradleException(
             """
         Found snapshot version(s) in generated POM of Pkl release version:
         ${matches.joinToString("\n") { it.groupValues[0] }}
@@ -116,23 +116,20 @@ fun Project.configurePomValidation() {
     }
   }
 
-  tasks.named("publish") { dependsOn(validatePom) }
+tasks.publish { dependsOn(validatePom) }
-}
 
-/** Configures signing for Pkl publications. */
+// Workaround for maven publish plugin not setting up dependencies correctly.
-fun Project.configurePklSigning() {
+// Taken from https://github.com/gradle/gradle/issues/26091#issuecomment-1798137734
-  // Workaround for maven publish plugin not setting up dependencies correctly.
+val dependsOnTasks = mutableListOf<String>()
-  // Taken from https://github.com/gradle/gradle/issues/26091#issuecomment-1798137734
-  val dependsOnTasks = mutableListOf<String>()
 
-  tasks.withType<AbstractPublishToMaven>().configureEach {
+tasks.withType<AbstractPublishToMaven>().configureEach {
   dependsOnTasks.add(name.replace("publish", "sign").replaceAfter("Publication", ""))
   dependsOn(dependsOnTasks)
-  }
+}
 
-  extensions.configure<SigningExtension> {
+signing {
-    // provided as env vars `ORG_GRADLE_PROJECT_signingKey` and
+  // provided as env vars `ORG_GRADLE_PROJECT_signingKey` and `ORG_GRADLE_PROJECT_signingPassword`
-    // `ORG_GRADLE_PROJECT_signingPassword` in CI.
+  // in CI.
   val signingKey =
     (findProperty("signingKey") as String?)?.let {
       Base64.getDecoder().decode(it).toString(StandardCharsets.US_ASCII)
@@ -141,6 +138,10 @@ fun Project.configurePklSigning() {
   if (signingKey != null && signingPassword != null) {
     useInMemoryPgpKeys(signingKey, signingPassword)
   }
-    extensions.getByType<PublishingExtension>().publications.findByName("library")?.let { sign(it) }
+  publishing.publications.findByName("library")?.let { sign(it) }
-  }
+}
+
+artifacts {
+  project.tasks.findByName("javadocJar")?.let { archives(it) }
+  project.tasks.findByName("sourcesJar")?.let { archives(it) }
 }

docs/antora.yml

@@ -1,6 +1,6 @@
 name: main
 title: Main Project
-version: 0.32.0-dev
+version: 0.27.2
-prerelease: true
+prerelease: false
 nav:
 - nav.adoc

docs/docs.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
+ * Copyright © 2024 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.
@@ -16,8 +16,8 @@
 import org.jetbrains.kotlin.gradle.dsl.KotlinJvmProjectExtension
 
 plugins {
-  id("pklAllProjects")
+  pklAllProjects
-  id("pklKotlinTest")
+  pklKotlinTest
 }
 
 sourceSets {
@@ -37,8 +37,8 @@ dependencies {
   testImplementation(projects.pklConfigJava)
   testImplementation(projects.pklConfigKotlin)
   testImplementation(projects.pklCommonsTest)
-  testImplementation(projects.pklParser)
   testImplementation(libs.junitEngine)
+  testImplementation(libs.antlrRuntime)
 }
 
 tasks.test {

docs/gradle.lockfile

@@ -0,0 +1,37 @@
+# This is a Gradle generated file for dependency locking.
+# Manual edits can break the build and are not advised.
+# This file is expected to be part of source control.
+com.tunnelvisionlabs:antlr4-runtime:4.9.0=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+io.leangen.geantyref:geantyref:1.3.16=testRuntimeClasspath
+net.bytebuddy:byte-buddy:1.14.18=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+net.java.dev.jna:jna:5.6.0=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeOnlyDependenciesMetadata
+org.assertj:assertj-core:3.26.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.graalvm.sdk:graal-sdk:23.0.6=testRuntimeClasspath
+org.graalvm.truffle:truffle-api:23.0.6=testRuntimeClasspath
+org.jetbrains.intellij.deps:trove4j:1.0.20200330=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-compiler-embeddable:1.7.10=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-daemon-embeddable:1.7.10=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-klib-commonizer-embeddable:1.7.10=kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-reflect:1.7.10=kotlinCompilerClasspath,kotlinKlibCommonizerClasspath,testRuntimeClasspath
+org.jetbrains.kotlin:kotlin-script-runtime:1.7.10=kotlinCompilerClasspath,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest,kotlinKlibCommonizerClasspath
+org.jetbrains.kotlin:kotlin-scripting-common:1.7.10=kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest
+org.jetbrains.kotlin:kotlin-scripting-compiler-embeddable:1.7.10=kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest
+org.jetbrains.kotlin:kotlin-scripting-compiler-impl-embeddable:1.7.10=kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest
+org.jetbrains.kotlin:kotlin-scripting-jvm:1.7.10=kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest
+org.jetbrains.kotlin:kotlin-stdlib-common:1.7.10=kotlinCompilerClasspath,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest,kotlinKlibCommonizerClasspath,testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.7.10=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.7.10=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.jetbrains.kotlin:kotlin-stdlib:1.7.10=kotlinCompilerClasspath,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest,kotlinKlibCommonizerClasspath,testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.jetbrains:annotations:13.0=kotlinCompilerClasspath,kotlinCompilerPluginClasspathMain,kotlinCompilerPluginClasspathTest,kotlinKlibCommonizerClasspath,testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.junit.jupiter:junit-jupiter-api:5.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.junit.jupiter:junit-jupiter-engine:5.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.junit.jupiter:junit-jupiter-params:5.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath
+org.junit.platform:junit-platform-commons:1.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.junit.platform:junit-platform-engine:1.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.junit:junit-bom:5.11.3=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.msgpack:msgpack-core:0.9.8=testRuntimeClasspath
+org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testImplementationDependenciesMetadata,testRuntimeClasspath,testRuntimeOnlyDependenciesMetadata
+org.organicdesign:Paguro:3.10.3=testRuntimeClasspath
+org.snakeyaml:snakeyaml-engine:2.5=testRuntimeClasspath
+empty=annotationProcessor,apiDependenciesMetadata,compileClasspath,compileOnlyDependenciesMetadata,implementationDependenciesMetadata,intransitiveDependenciesMetadata,kotlinCompilerPluginClasspath,kotlinNativeCompilerPluginClasspath,kotlinScriptDef,kotlinScriptDefExtensions,runtimeClasspath,runtimeOnlyDependenciesMetadata,testAnnotationProcessor,testApiDependenciesMetadata,testCompileOnlyDependenciesMetadata,testIntransitiveDependenciesMetadata,testKotlinScriptDef,testKotlinScriptDefExtensions

docs/modules/ROOT/pages/evolution-and-roadmap.adoc

@@ -7,7 +7,7 @@
 
 Sometimes, a change to Pkl is large enough that it makes sense to create a proposal for the change so that it can be discussed in detail and vetted.
 
-Pkl has a process for managing such designs in a repository called {uri-pkl-evolution}[Pkl Evolution].
+Pkl has a process for managing such designs in a repository called {uri-pkl-evolution}[Pkl Evolutiuon].
 
 == Roadmap
 
@@ -17,4 +17,4 @@ The roadmap describes estimates.
 The Pkl team aims to cut a release in February, June, and October of each year.
 If an item is not complete by the release cutoff date, the roadmap item may be bumped to the next release.
 
-Additionally, as priorities change, it is possible that items can be moved around or backlogged.
+Additionally, as priorities change, it is possible that items can be moved around, or backlogged.

docs/modules/ROOT/partials/component-attributes.adoc

@@ -3,10 +3,10 @@
 // the following attributes must be updated immediately before a release
 
 // pkl version corresponding to current git commit without -dev suffix or git hash
-:pkl-version-no-suffix: 0.32.0
+:pkl-version-no-suffix: 0.27.2
 // tells whether pkl version corresponding to current git commit
 // is a release version (:is-release-version: '') or dev version (:!is-release-version:)
-:!is-release-version:
+:is-release-version: ''
 
 // the remaining attributes do not need to be updated regularly
 
@@ -23,9 +23,9 @@ endif::[]
 
 :uri-maven-docsite: https://central.sonatype.com
 
-:uri-snapshot-repo: https://central.sonatype.com/repository/maven-snapshots
+:uri-sonatype: https://s01.oss.sonatype.org/content/groups/public
 
-:uri-maven-repo: https://central.sonatype.com/repository/maven-snapshots
+:uri-maven-repo: https://s01.oss.sonatype.org/content/groups/public
 ifdef::is-release-version[]
 :uri-maven-repo: https://repo1.maven.org/maven2
 endif::[]
@@ -68,24 +68,17 @@ endif::[]
 :uri-pkldoc-example: {uri-pkl-examples-tree}/pkldoc
 
 :uri-stdlib-baseModule: {uri-pkl-stdlib-docs}/base
-:uri-stdlib-CommandModule: {uri-pkl-stdlib-docs}/Command
 :uri-stdlib-analyzeModule: {uri-pkl-stdlib-docs}/analyze
 :uri-stdlib-jsonnetModule: {uri-pkl-stdlib-docs}/jsonnet
 :uri-stdlib-reflectModule: {uri-pkl-stdlib-docs}/reflect
-:uri-stdlib-mathModule: {uri-pkl-stdlib-docs}/math
 :uri-stdlib-xmlModule: {uri-pkl-stdlib-docs}/xml
 :uri-stdlib-protobufModule: {uri-pkl-stdlib-docs}/protobuf
-:uri-stdlib-pklbinaryModule: {uri-pkl-stdlib-docs}/pklbinary
-:uri-stdlib-yamlModule: {uri-pkl-stdlib-docs}/yaml
-:uri-stdlib-YamlParser: {uri-stdlib-yamlModule}/Parser
 :uri-stdlib-evaluatorSettingsModule: {uri-pkl-stdlib-docs}/EvaluatorSettings
-:uri-stdlib-evaluatorSettingsHttpClass: {uri-stdlib-evaluatorSettingsModule}/Http
 :uri-stdlib-Boolean: {uri-stdlib-baseModule}/Boolean
 :uri-stdlib-xor: {uri-stdlib-baseModule}/Boolean#xor()
 :uri-stdlib-implies: {uri-stdlib-baseModule}/Boolean#implies()
 :uri-stdlib-Any: {uri-stdlib-baseModule}/Any
 :uri-stdlib-String: {uri-stdlib-baseModule}/String
-:uri-stdlib-Collection: {uri-stdlib-baseModule}/Collection
 :uri-stdlib-StringToInt: {uri-stdlib-baseModule}/String#toInt()
 :uri-stdlib-Int: {uri-stdlib-baseModule}/Int
 :uri-stdlib-Float: {uri-stdlib-baseModule}/Float
@@ -134,10 +127,7 @@ endif::[]
 :uri-stdlib-Class: {uri-stdlib-baseModule}/Class
 :uri-stdlib-TypeAlias: {uri-stdlib-baseModule}/TypeAlias
 :uri-stdlib-Deprecated: {uri-stdlib-baseModule}/Deprecated
-:uri-stdlib-BaseValueRenderer: {uri-stdlib-baseModule}/BaseValueRenderer
 :uri-stdlib-ValueRenderer: {uri-stdlib-baseModule}/ValueRenderer
-:uri-stdlib-BytesRenderer: {uri-stdlib-baseModule}/BytesRenderer
-:uri-stdlib-YamlRenderer: {uri-stdlib-baseModule}/YamlRenderer
 :uri-stdlib-PcfRenderer-converters: {uri-stdlib-baseModule}/PcfRenderer#converters
 :uri-stdlib-Function: {uri-stdlib-baseModule}/Function
 :uri-stdlib-Function0: {uri-stdlib-baseModule}/Function0
@@ -147,22 +137,8 @@ endif::[]
 :uri-stdlib-Function3: {uri-stdlib-baseModule}/Function3
 :uri-stdlib-Function4: {uri-stdlib-baseModule}/Function4
 :uri-stdlib-Function5: {uri-stdlib-baseModule}/Function5
-:uri-stdlib-Bytes: {uri-stdlib-baseModule}/Bytes
 :uri-stdlib-Resource: {uri-stdlib-baseModule}/Resource
 :uri-stdlib-outputFiles: {uri-stdlib-baseModule}/ModuleOutput#files
-:uri-stdlib-FileOutput: {uri-stdlib-baseModule}/FileOutput
-:uri-stdlib-Annotation: {uri-stdlib-baseModule}/Annotation
-:uri-stdlib-ConvertProperty: {uri-stdlib-baseModule}/ConvertProperty
-:uri-stdlib-Command-Flag: {uri-stdlib-CommandModule}/Flag
-:uri-stdlib-Command-BooleanFlag: {uri-stdlib-CommandModule}/BooleanFlag
-:uri-stdlib-Command-CountedFlag: {uri-stdlib-CommandModule}/CountedFlag
-:uri-stdlib-Command-Argument: {uri-stdlib-CommandModule}/Argument
-:uri-stdlib-Command-Import: {uri-stdlib-CommandModule}/Import
 
 :uri-messagepack: https://msgpack.org/index.html
 :uri-messagepack-spec: https://github.com/msgpack/msgpack/blob/master/spec.md
-
-:uri-pkl-roadmap: https://github.com/orgs/apple/projects/12/views/1
-
-// TODO: figure out what the correct URL should be
-:uri-sonatype-snapshot-download: https://s01.oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=org.pkl-lang&v={pkl-artifact-version}

docs/modules/bindings-specification/pages/binary-encoding.adoc

@@ -1,15 +1,9 @@
-= `pkl-binary` Encoding
+= Pkl Binary Encoding
 include::ROOT:partial$component-attributes.adoc[]
 include::partial$component-attributes.adoc[]
 
-:uri-pkl-core-Evaluator: {uri-pkl-core-main-sources}/Evaluator.java
+Pkl values can be encoded into a binary format.
-
+This format is used for Pkl's non-JVM language bindings, for example, for its Go and Swift bindings.
-Pkl values can be encoded into a binary format called "pkl-binary".
-This format is a lossless serialization of the underlying Pkl values.
-
-Pkl code can be rendered into this format using the {uri-stdlib-pklbinaryModule}[pkl:pklbinary] standard library module.
-
-Alternatively, many language bindings also provide methods to evaluate into `pkl-binary`, such as the `evaluateExpressionPklBinary` method in link:{uri-pkl-core-Evaluator}[org.pkl.core.Evaluator].
 
 The binary format is uses link:{uri-messagepack}[MessagePack] encoding.
 
@@ -42,9 +36,7 @@ For example, value `8` gets encoded as MessagePack `int8` format.
 == Non-primitives
 
 All non-primitive values are encoded as MessagePack arrays.
-The first slot of the array designates the value's type.
+The first slot of the array designates the value's type. The remaining slots have fixed meanings depending on the type.
-The remaining slots have fixed meanings depending on the type.
-Additional slots may be added to types in future Pkl releases. Decoders *must* be designed to defensively discard values beyond the number of known slots for a type or provide meaningful error messages.
 
 The array's length is the number of slots that are filled. For example, xref:{uri-stdlib-List}[List] is encoded as an MessagePack array with two elements.
 
@@ -54,16 +46,16 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 ||code |type |description |type |description |type |description
 
 |link:{uri-stdlib-Typed}[Typed], link:{uri-stdlib-Dynamic}[Dynamic]
-|`0x01`
+|`0x1`
 |link:{uri-messagepack-str}[str]
-|<<type-name-encoding,Class name>>
+|Fully qualified class name
 |link:{uri-messagepack-str}[str]
 |Enclosing module URI
 |link:{uri-messagepack-array}[array]
 |Array of <<object-members,object members>>
 
 |link:{uri-stdlib-Map}[Map]
-|`0x02`
+|`0x2`
 |link:{uri-messagepack-map}[map]
 |Map of `<value>` to `<value>`
 |
@@ -72,7 +64,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-Mapping}[Mapping]
-|`0x03`
+|`0x3`
 |link:{uri-messagepack-map}[map]
 |Map of `<value>` to `<value>`
 |
@@ -81,7 +73,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-List}[List]
-|`0x04`
+|`0x4`
 |link:{uri-messagepack-array}[array]
 |Array of `<value>`
 |
@@ -90,7 +82,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-Listing}[Listing]
-|`0x05`
+|`0x5`
 |link:{uri-messagepack-array}[array]
 |Array of `<value>`
 |
@@ -99,7 +91,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-Set}[Set]
-|`0x06`
+|`0x6`
 |link:{uri-messagepack-array}[array]
 |Array of `<value>`
 |
@@ -108,7 +100,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-Duration}[Duration]
-|`0x07`
+|`0x7`
 |{uri-messagepack-float}[float64]
 |Duration value
 |link:{uri-messagepack-str}[str]
@@ -117,7 +109,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-DataSize}[DataSize]
-|`0x08`
+|`0x8`
 |link:{uri-messagepack-float}[float64]
 |Value (float64)
 |link:{uri-messagepack-str}[str]
@@ -126,7 +118,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-Pair}[Pair]
-|`0x09`
+|`0x9`
 |`<value>`
 |First value
 |`<value>`
@@ -135,7 +127,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-IntSeq}[IntSeq]
-|`0x0A`
+|`0xA`
 |link:{uri-messagepack-int}[int]
 |Start
 |link:{uri-messagepack-int}[int]
@@ -144,7 +136,7 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |Step
 
 |link:{uri-stdlib-Regex}[Regex]
-|`0x0B`
+|`0xB`
 |link:{uri-messagepack-str}[str]
 |Regex string representation
 |
@@ -153,55 +145,24 @@ The array's length is the number of slots that are filled. For example, xref:{ur
 |
 
 |link:{uri-stdlib-Class}[Class]
-|`0x0C`
+|`0xC`
-|link:{uri-messagepack-str}[str]
+|
-|<<type-name-encoding,Class name>>
+|
-|link:{uri-messagepack-str}[str]
+|
-|Module URI
+|
 |
 |
 
 |link:{uri-stdlib-TypeAlias}[TypeAlias]
-|`0x0D`
+|`0xD`
-|link:{uri-messagepack-str}[str]
-|<<type-name-encoding,TypeAlias name>>
-|link:{uri-messagepack-str}[str]
-|Module URI
 |
 |
-
-|link:{uri-stdlib-Function}[Function]
-|`0x0E`
-|
-|
-|
-|
-|
-|
-
-|link:{uri-stdlib-Bytes}[Bytes]
-|`0x0F`
-|link:{uri-messagepack-bin}[bin]
-|Binary contents
 |
 |
 |
 |
 |===
 
-[[type-name-encoding]]
-[NOTE]
-====
-Type names have specific encoding rules:
-
-* When the module URI is `pkl:base`:
-** If the type name is `ModuleClass`, this type represents the module class of `pkl:base`.
-** Otherwise, the type name corresponds to a type in `pkl:base`.
-* For all other module URIs:
-** When the type name contains `\#`, the string after the `#` character corresponds to a type in that module. The string before the `#` is the name of the module.
-** Otherwise, the type name is the name of the module and represents the class of the module.
-====
-
 [[object-members]]
 == Object Members
 
@@ -233,3 +194,4 @@ Like non-primitive values, object members are encoded as MessagePack arrays, whe
 |`<value>`
 |element value
 |===
+

docs/modules/bindings-specification/pages/message-passing-api.adoc

@@ -75,7 +75,7 @@ requestId: Int
 /// API version of the CLI's `--allowed-modules` flag
 allowedModules: Listing<String>?
 
-/// Regex patterns to determine which resources are allowed to be read.
+/// Regex patterns to dettermine which resources are allowed to be read.
 ///
 /// API version of the CLI's `--allowed-resources` flag
 allowedResources: Listing<String>?
@@ -130,7 +130,7 @@ class ClientResourceReader {
   /// The URI scheme this reader is responsible for reading.
   scheme: String
 
-  /// Tells whether the path part of this URI has a
+  /// Tells whether the path part of ths URI has a
   /// [hier-part](https://datatracker.ietf.org/doc/html/rfc3986#section-3).
   ///
   /// An example of a hierarchical URI is `file:///path/to/my/file`, where
@@ -148,7 +148,7 @@ class ClientModuleReader {
   /// The URI scheme this reader is responsible for reading.
   scheme: String
 
-  /// Tells whether the path part of this URI has a
+  /// Tells whether the path part of ths URI has a
   /// [hier-part](https://datatracker.ietf.org/doc/html/rfc3986#section-3).
   ///
   /// An example of a hierarchical URI is `file:///path/to/my/file`, where
@@ -199,17 +199,12 @@ class Http {
   /// PEM format certificates to trust when making HTTP requests.
   ///
   /// If [null], Pkl will trust its own built-in certificates.
-  caCertificates: Bytes? // <1>
+  caCertificates: Binary?
 
   /// Configuration of the HTTP proxy to use.
   ///
   /// If [null], uses the operating system's proxy configuration.
   proxy: Proxy?
-
-  /// HTTP rewrites, from source prefix to target prefix.
-  ///
-  /// Each rewrite must start with `http://` or `https://`, and must end with `/`.
-  rewrites: Mapping<String, String>?
 }
 
 /// Settings that control how Pkl talks to HTTP proxies.
@@ -251,8 +246,10 @@ class Proxy {
   /// ```
   noProxy: Listing<String>(isDistinct)
 }
+
+typealias Binary = Any // <1>
 ----
-<1> link:{uri-messagepack-bin}[bin format]
+<1> link:{uri-messagepack-bin}[bin format] (not expressable in Pkl)
 
 Example:
 [source,json5]
@@ -350,12 +347,14 @@ requestId: Int
 evaluatorId: Int
 
 /// The evaluation contents, if successful.
-result: Bytes? // <1>
+result: Binary? // <1>
 
 /// A message detailing why evaluation failed.
 error: String?
+
+typealias Binary = Any // <1>
 ----
-<1> xref:binary-encoding.adoc[Pkl Binary Encoding] in link:{uri-messagepack-bin}[bin format]
+<1> xref:binary-encoding.adoc[Pkl Binary Encoding] in link:{uri-messagepack-bin}[bin format] (not expressable in Pkl)
 
 [[log]]
 === Log
@@ -426,12 +425,14 @@ requestId: Int
 evaluatorId: Int
 
 /// The contents of the resource.
-contents: Bytes? // <1>
+contents: Binary? // <1>
 
-/// The description of the error that occurred when reading this resource.
+/// The description of the error that occured when reading this resource.
 error: String?
+
+typealias Binary = Any // <1>
 ----
-<1> MessagePack's link:https://github.com/msgpack/msgpack/blob/master/spec.md#bin-format-family[bin format family]
+<1> MessagePack's link:https://github.com/msgpack/msgpack/blob/master/spec.md#bin-format-family[bin format family] (not expressable in Pkl)
 
 [[read-module-request]]
 === Read Module Request
@@ -477,7 +478,7 @@ evaluatorId: Int
 /// The string contents of the module.
 contents: String?
 
-/// The description of the error that occurred when reading this resource.
+/// The description of the error that occured when reading this resource.
 error: String?
 ----
 
@@ -527,7 +528,7 @@ evaluatorId: Int
 /// The elements at the provided base path.
 pathElements: Listing<PathElement>?
 
-/// The description of the error that occurred when listing elements.
+/// The description of the error that occured when listing elements.
 error: String?
 
 class PathElement {
@@ -585,7 +586,7 @@ evaluatorId: Int
 /// The elements at the provided base path.
 pathElements: Listing<PathElement>?
 
-/// The description of the error that occurred when listing elements.
+/// The description of the error that occured when listing elements.
 error: String?
 
 class PathElement {

docs/modules/java-binding/examples/JavaConfigExample.java

@@ -4,8 +4,8 @@ import org.pkl.config.java.JavaType;
 import org.pkl.core.ModuleSource;
 import org.junit.jupiter.api.Test;
 
-@SuppressWarnings({"unused", "NewClassNamingConvention"})
+@SuppressWarnings("unused")
-// the pkl-jvm-examples repo has a similar example
+// the pkl/pkl-examples repo has a similar example
 public class JavaConfigExample {
   @Test
   public void usage() {

docs/modules/java-binding/pages/codegen.adoc

@@ -1,12 +1,6 @@
 = Java Code Generator
 include::ROOT:partial$component-attributes.adoc[]
-:uri-pkl-codegen-java-maven-module: {uri-maven-docsite}/artifact/org.pkl-lang/pkl-codegen-java
+:uri-pkl-codgen-java-maven-module: {uri-maven-docsite}/artifact/org.pkl-lang/pkl-codegen-java
-
-:uri-pkl-codegen-java-download: {uri-sonatype-snapshot-download}&a=pkl-cli-codegen-java&e=jar
-
-ifdef::is-release-version[]
-:uri-pkl-codegen-java-download: {github-releases}/pkl-codegen-java
-endif::[]
 
 The Java source code generator takes Pkl class definitions as an input, and generates corresponding Java classes with equally named properties.
 
@@ -29,11 +23,11 @@ See xref:pkl-gradle:index.adoc#installation[Installation] in the Gradle plugin c
 [[install-library]]
 === Java Library
 
-The `pkl-codegen-java` library is available {uri-pkl-codegen-java-maven-module}[from Maven Central].
+The `pkl-codegen-java` library is available {uri-pkl-codgen-java-maven-module}[from Maven Central].
 It requires Java 17 or higher.
 
 ifndef::is-release-version[]
-NOTE: Snapshots are published to repository `{uri-snapshot-repo}`.
+NOTE: Snapshots are published to repository `{uri-sonatype}`.
 endif::[]
 
 ==== Gradle
@@ -109,41 +103,8 @@ endif::[]
 [[install-cli]]
 === CLI
 
-The CLI is available as a Java executable.
+The CLI is bundled with the Java library.
-
+As we do not currently ship the CLI as a self-contained Jar, we recommend to provision it with a Maven compatible build tool as shown in <<install-library>>.
-It works on multiple platforms, and requires a Java 17 (or higher) runtime on the system path.
-
-To download:
-
-[tabs]
-====
-macOS/Linux::
-+
-[source,shell]
-[subs="+attributes"]
-----
-curl -L -o pkl-codegen-java '{uri-pkl-codegen-java-download}'
-chmod +x pkl-codegen-java
-./pkl-codegen-java --version
-----
-
-Windows::
-+
-[source,PowerShell]
-[subs="+attributes"]
-----
-Invoke-WebRequest '{uri-pkl-codegen-java-download}' -OutFile pkl-codegen-java.bat
-.\pkl-codegen-java --version
-----
-====
-
-This should print something similar to:
-
-[source,shell]
-[subs="+attributes"]
-----
-pkl-codegen-java {pkl-version} (macOS 14.2, Java 17.0.10)
-----
 
 [[codegen-java-usage]]
 == Usage
@@ -162,7 +123,10 @@ For more information, refer to the Javadoc documentation.
 
 === CLI
 
-*Synopsis:* `pkl-codegen-java [<options>] <modules>`
+As explained in <<install-cli,Installation>>, the CLI is bundled with the Java library.
+To run the CLI, execute the library Jar or its `org.pkl.codegen.java.Main` main class.
+
+*Synopsis:* `java -cp <classpath> -jar pkl-codegen-java.jar [<options>] <modules>`
 
 `<modules>`::
 The absolute or relative URIs of the modules to generate classes for.
@@ -181,27 +145,23 @@ Flag that indicates to generate private final fields and public getter methods i
 [%collapsible]
 ====
 Default: (flag not set) +
-Flag that indicates to preserve Pkl doc comments by generating corresponding Javadoc comments.
+Flag that indicates to generate Javadoc based on doc comments for Pkl modules, classes, and properties.
 ====
 
 .--params-annotation
 [%collapsible]
 ====
-Default: `none` if `--generate-spring-boot` is set, `org.pkl.config.java.mapper.Named` otherwise +
+Default: `org.pkl.config.java.mapper.Named` +
-Fully qualified name of the annotation type to use for annotating constructor parameters with their name. +
+Fully qualified name of the annotation to use on constructor parameters.
-The specified annotation type must have a `value` parameter of type `String` or the generated code may not compile.
-If set to `none`, constructor parameters are not annotated.
-Whether and how constructor parameters should be annotated depends on the library that instantiates the generated classes.
-For Spring Boot applications, and for users of `pkl-config-java` compiling the generated classes with `-parameters`, no annotation is required.
 ====
 
 .--non-null-annotation
 [%collapsible]
 ====
 Default: `org.pkl.config.java.mapper.NonNull` +
-Fully qualified name of the annotation type to use for annotating non-null types. +
+Fully qualified named of the annotation class to use for non-null types. +
-The specified annotation type must be annotated with `@java.lang.annotation.Target(ElementType.TYPE_USE)`
+This annotation is required to have `java.lang.annotation.ElementType.TYPE_USE` as a `@Target`
-or the generated code may not compile.
+or it may generate code that does not compile.
 ====
 
 Common code generator options:
@@ -216,4 +176,4 @@ include::../../pkl-cli/partials/cli-common-options.adoc[]
 == Full Example
 
 For a ready-to-go example with full source code,
-see link:{uri-codegen-java-example}[codegen-java] in the _pkl-jvm-examples_ repository.
+see link:{uri-codegen-java-example}[codegen-java] in the _pkl/pkl-examples_ repository.

docs/modules/java-binding/partials/cli-codegen-options.adoc

@@ -26,14 +26,7 @@ Flag that indicates to generate config classes for use with Spring Boot.
 [%collapsible]
 ====
 Default: (not set) +
-Flag that indicates to generate classes that implement `java.io.Serializable`.
+Whether to make generated classes implement `java.io.Serializable`.
-====
-
-.--add-generated-annotation
-[%collapsible]
-====
-Default: (not set) +
-Flag that indicates to add the `org.pkl.config.java.Generated` annotation to generated types.
 ====
 
 .--rename

docs/modules/kotlin-binding/examples/KotlinConfigExample.kt

@@ -6,7 +6,7 @@ import org.pkl.config.kotlin.to
 import org.pkl.core.ModuleSource
 import org.junit.jupiter.api.Test
 
-// the pkl-jvm-examples repo has a similar example
+// the pkl/pkl-examples repo has a similar example
 class KotlinConfigExample {
   @Test
   fun usage() {

docs/modules/kotlin-binding/pages/codegen.adoc

@@ -1,11 +1,6 @@
 = Kotlin Code Generator
 include::ROOT:partial$component-attributes.adoc[]
 :uri-pkl-codegen-kotlin-maven-module: {uri-maven-docsite}/artifact/org.pkl-lang/pkl-codegen-kotlin
-:uri-pkl-codegen-kotlin-download: {uri-sonatype-snapshot-download}&a=pkl-cli-codegen-kotlin&e=jar
-
-ifdef::is-release-version[]
-:uri-pkl-codegen-kotlin-download: {github-releases}/pkl-codegen-kotlin
-endif::[]
 
 The Kotlin source code generator reads Pkl classes and generates corresponding Kotlin classes with equally named properties.
 
@@ -88,41 +83,8 @@ To use the library in a Maven project, declare the following dependency:
 [[install-cli]]
 === CLI
 
-The CLI is available as a Java executable.
+The CLI is bundled with the library.
-
+As we do not currently ship the CLI as a self-contained Jar, we recommend to provision it with a Maven compatible build tool as shown in <<install-library>>.
-It works on multiple platforms, and requires a Java 17 (or higher) runtime on the system path.
-
-To download:
-
-[tabs]
-====
-macOS/Linux::
-+
-[source,shell]
-[subs="+attributes"]
-----
-curl -L -o pkl-codegen-kotlin '{uri-pkl-codegen-kotlin-download}'
-chmod +x pkl-codegen-kotlin
-./pkl-codegen-kotlin --version
-----
-
-Windows::
-+
-[source,PowerShell]
-[subs="+attributes"]
-----
-Invoke-WebRequest '{uri-pkl-codegen-kotlin-download}' -OutFile pkl-codegen-kotlin.bat
-.\pkl-codegen-kotlin --version
-----
-====
-
-This should print something similar to:
-
-[source,shell]
-[subs="+attributes"]
-----
-pkl-codegen-kotlin {pkl-version} (macOS 14.2, Java 17.0.10)
-----
 
 [[usage]]
 == Usage
@@ -141,7 +103,10 @@ For more information, refer to the KDoc documentation.
 
 === CLI
 
-*Synopsis:* `pkl-codegen-kotlin [<options>] <modules>`
+As mentioned in <<install-cli,Installation>>, the CLI is bundled with the library.
+To run the CLI, execute the library Jar or its `org.pkl.codegen.kotlin.Main` main class.
+
+*Synopsis:* `java -cp <classpath> -jar pkl-codegen-kotlin.jar [<options>] <modules>`
 
 `<modules>`::
 The absolute or relative URIs of the modules to generate classes for.
@@ -153,7 +118,7 @@ Relative URIs are resolved against the working directory.
 [%collapsible]
 ====
 Default: (flag not set) +
-Flag that indicates to preserve Pkl doc comments by generating corresponding KDoc comments.
+Flag that indicates to generate Kdoc based on doc comments for Pkl modules, classes, and properties.
 ====
 
 Common code generator options:
@@ -168,4 +133,4 @@ include::../../pkl-cli/partials/cli-common-options.adoc[]
 == Full Example
 
 For a ready-to-go example with full source code,
-see link:{uri-codegen-kotlin-example}[codegen-kotlin] in the _pkl-jvm-examples_ repository.
+see link:{uri-codegen-kotlin-example}[codegen-kotlin] in the _pkl/pkl-examples_ repository.

docs/modules/kotlin-binding/pages/pkl-config-kotlin.adoc

@@ -116,7 +116,7 @@ include::{examplesdir}/KotlinConfigExample.kt[tags=nullable]
 Converting to `String` would result in a `ConversionException`.
 
 For a ready-to-go example with full source code,
-see link:{uri-config-kotlin-example}[config-kotlin] in the _pkl-jvm-examples_ repository.
+see link:{uri-config-kotlin-example}[config-kotlin] in the _pkl/pkl-examples_ repository.
 
 == Further Information
 

docs/modules/language-reference/pages/index.adoc

@@ -2,11 +2,13 @@
 include::ROOT:partial$component-attributes.adoc[]
 :uri-common-mark: https://commonmark.org/
 :uri-newspeak: https://newspeaklanguage.org
+:uri-antlr4: https://www.antlr.org
 :uri-prototypical-inheritance: https://en.wikipedia.org/wiki/Prototype-based_programming
 :uri-double-precision: https://en.wikipedia.org/wiki/Double-precision_floating-point_format
 :uri-progressive-disclosure: https://en.wikipedia.org/wiki/Progressive_disclosure
 :uri-javadoc-Pattern: https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html
-:uri-github-PklLexer: {uri-github-tree}/pkl-core/src/main/java/org/pkl/core/parser/Lexer.java
+:uri-github-PklLexer: {uri-github-tree}/pkl-core/src/main/antlr/PklLexer.g4
+:uri-github-PklParser: {uri-github-tree}/pkl-core/src/main/antlr/PklParser.g4
 :uri-pkl-core-ModuleSchema: {uri-pkl-core-main-sources}/ModuleSchema.java
 :uri-pkl-core-SecurityManager: {uri-pkl-core-main-sources}/SecurityManager.java
 :uri-pkl-core-ResourceReader: {uri-pkl-core-main-sources}/resource/ResourceReader.java
@@ -255,7 +257,8 @@ String literals are enclosed in double quotes:
 "Hello, World!"
 ----
 
-TIP: Except for a few minor differences footnote:[Pkl's string literals have fewer character escape sequences and stricter rules for line indentation in multiline strings.],
+TIP: Except for a few minor differences footnote:[Pkl's string literals have fewer character escape sequences,
+have stricter rules for line indentation in multiline strings, and do not have a line continuation character.],
 String literals have the same syntax and semantics as in Swift 5. Learn one of them, know both of them!
 
 Inside a string literal, the following character escape sequences have special meaning:
@@ -361,23 +364,6 @@ str = """
   """
 ----
 
-To prevent line breaks from becoming part of the string's value, use a backslash (`\`) to end those lines.
-
-[source%tested,{pkl}]
-----
-str = """
-  Although the Dodo is extinct, \
-  the species will be remembered.
-  """
-----
-
-This multiline string is equivalent to the following single-line string:
-
-[source%parsed,{pkl-expr}]
-----
-"Although the Dodo is extinct, the species will be remembered."
-----
-
 [[custom-string-delimiters]]
 === Custom String Delimiters
 
@@ -1075,7 +1061,7 @@ class Penguin extends Bird {
 <2> Error: modifier `fixed` cannot be applied to property `name`.
 
 The `fixed` modifier is useful for defining properties that are meant to be derived from other properties.
-In the following snippet, the property `wingspanWeightRatio` is not meant to be assigned to, because it is derived
+In the following snippet, the property `result` is not meant to be assigned to, because it is derived
 from other properties.
 
 [source%parsed,{pkl}]
@@ -1439,7 +1425,7 @@ The recipe for transforming a listing is:
 . Transform the list using ``List``'s link:{uri-stdlib-List}[rich API].
 . If necessary, convert the list back to a listing.
 
-TIP: Often, transformations happen in a link:{uri-stdlib-PcfRenderer-converters}[converter] of a link:{uri-stdlib-BaseValueRenderer}[value renderer].
+TIP: Often, transformations happen in a link:{uri-stdlib-PcfRenderer-converters}[converter] of a link:{uri-stdlib-ValueRenderer}[value renderer].
 Because most value renderers treat lists the same as listings, it is often not necessary to convert back to a listing.
 
 Equipped with this knowledge, let's try to accomplish our objective:
@@ -1819,7 +1805,7 @@ The recipe for transforming a mapping is:
 . Transform the map using ``Map``'s link:{uri-stdlib-Map}[rich API].
 . If necessary, convert the map back to a mapping.
 
-TIP: Often, transformations happen in a link:{uri-stdlib-PcfRenderer-converters}[converter] of a link:{uri-stdlib-BaseValueRenderer}[value renderer].
+TIP: Often, transformations happen in a link:{uri-stdlib-PcfRenderer-converters}[converter] of a link:{uri-stdlib-ValueRenderer}[value renderer].
 As most value renderers treat maps the same as mappings, it is often not necessary to convert back to a mapping.
 
 Equipped with this knowledge, let's try to accomplish our objective:
@@ -2050,9 +2036,6 @@ greeting2 = greetPigeon(parrot)  // <4>
 <3> Call instance method on `pigeon`.
 <4> Call module method (on `this`).
 
-Like other object-oriented languages, methods defined on extended classes and modules may be overridden.
-The parent type's method may be called via the <<super-keyword,`super` keyword>>.
-
 NOTE: Methods do not support named parameters or default parameter values.
 The xref:blog:ROOT:class-as-a-function.adoc[Class-as-a-function] pattern may be a suitable replacement.
 
@@ -2170,9 +2153,6 @@ Optionally, the SHA-256 checksum of the package can also be specified:
 Packages can be managed as dependencies within a _project_.
 For more details, consult the <<projects,project>> section of the language reference.
 
-Packages can also be downloaded from a mirror.
-For more details, consult the <<mirroring_packages>> section of the language reference.
-
 ==== Standard Library URI
 
 Example: `+pkl:math+`
@@ -2593,7 +2573,7 @@ the following security checks are performed:
 * The target module URI is checked against the module allowlist (`--allowed-modules`).
 * The source and target modules' _trust levels_ are determined and compared.
 
-For access to be granted, the source module's trust level must be greater than or equal to the target module's trust level.
+For access to be granted, the source module's trust level must be higher than or equal to the target module's trust level.
 By default, there are five trust levels, listed from highest to lowest:
 
 . `repl:` modules (code evaluated in the REPL)
@@ -2736,7 +2716,7 @@ quota:
   disk: 20 GB
 ----
 
-In addition to _class_-based converters, renderers also support _path_-based converters:
+In addition to _type_ based converters, renderers also support _path_ based converters:
 
 [source%parsed,{pkl}]
 ----
@@ -2752,10 +2732,6 @@ output {
 
 For more on path-based converters, see {uri-stdlib-PcfRenderer-converters}[PcfRenderer.converters].
 
-Special <<annotations,Annotations>> may also be used to influence how class properties are rendered.
-The `ConvertProperty` annotation (and subclasses of it) are automatically applied during.
-For more on annotation-based converters, see link:{uri-stdlib-ConvertProperty}[ConvertProperty].
-
 Sometimes it is useful to directly compute the final module output, bypassing `output.value` and `output.converters`.
 To do so, set the link:{uri-stdlib-baseModule}/ModuleOutput#text[output.text] property to a String value:
 
@@ -3217,19 +3193,14 @@ This section discusses language features that are generally more relevant to tem
 <<for-generators,For Generators>> +
 <<spread-syntax,Spread Syntax>> +
 <<member-predicates,Member Predicates (`[[...]]`)>> +
-<<this-keyword,`this` Keyword>> +
-<<outer-keyword,`outer` Keyword>> +
-<<super-keyword,`super` Keyword>> +
-<<module-keyword,`module` Keyword>> +
 <<glob-patterns,Glob Patterns>> +
 <<doc-comments,Doc Comments>> +
-<<annotations,Annotations>> +
 <<name-resolution,Name Resolution>> +
+<<grammar-definition,Grammar Definition>> +
 <<reserved-keywords,Reserved Keywords>> +
 <<blank-identifiers,Blank Identifiers>> +
 <<projects,Projects>> +
-<<external-readers,External Readers>> +
+<<external-readers,External Readers>>
-<<mirroring_packages,Mirroring packages>>
 
 [[meaning-of-new]]
 === Meaning of `new`
@@ -3382,9 +3353,9 @@ swiftHatchlings = typedProperty.listHatchlings(new { "Poppy"; "Chirpy" }) // <8>
 <2> Assignment to an undeclared property in module context, amending `new Dynamic {}`.
 <3> `Listing` element creation, amending implicit `default`, `new Bird {}`.
 <4> `Listing` element creation, amending implicit `default`, `new Dynamic {}`.
-<5> `Mapping` value assignment, amending the result of applying `default` to `"Saltmarsh Sparrow"`, `new Bird { name = "Saltmarsh Sparrow" }`.
+<5> `Mapping` value assignment, amdending the result of applying `default` to `"Saltmarsh Sparrow"`, `new Bird { name = "Saltmarsh Sparrow" }`.
 <6> `Mapping` value assignment _replacing_ the parent's entry, amending the result of applying `default` to `"Saltmarsh Sparrow"`, `new Bird { name = "Saltmarsh Sparrow" }`.
-<7> Amending the property default value `new Listing { new Bird { name = "Osprey" } }`; the result contains both birds.
+<7> Admending the property default value `new Listing { new Bird { name = "Osprey" } }`; the result contains both birds.
 <8> Error: Cannot tell which parent to amend.
 
 [[let-expressions]]
@@ -3568,7 +3539,9 @@ res6 = list.map((n) -> n * 3) // <6>
 [[sets]]
 === Sets
 
-A value of type link:{uri-stdlib-Set}[Set] is a collection of unique _elements_.
+A value of type link:{uri-stdlib-Set}[Set] is an ordered collection of unique _elements_.
+
+A set's elements are eagerly evaluated.
 
 Sets are constructed with the `Set()` methodfootnote:soft-keyword[]:
 
@@ -3584,20 +3557,6 @@ res4 = Set(1, "x", 5.min, List(1, 2, 3)) // <4>
 <3> result: same set of length 3
 <4> result: heterogeneous set that contains a list as its last element
 
-Sets retain the order of elements when constructed, which impacts how they are iterated over.
-However, this order is not considered when determining equality of two sets.
-
-[source%tested,{pkl}]
-----
-res1 = Set(4, 3, 2)
-res2 = res1.first // <1>
-res3 = res1.toListing() // <2>
-res4 = Set(2, 3, 4) == res1 // <3>
-----
-<1> result: `4`
-<2> result: `new Listing { 4; 3; 2 }`
-<3> result: `true`
-
 To compute the union of sets, use the `+` operator:
 
 [source%tested,{pkl-expr}]
@@ -3625,7 +3584,7 @@ res4 = set.intersect(Set(3, 9, 2)) // <4>
 [[maps]]
 === Maps
 
-A value of type link:{uri-stdlib-Map}[Map] is a collection of _values_ indexed by _key_.
+A value of type link:{uri-stdlib-Map}[Map] is an ordered collection of _values_ indexed by _key_.
 
 A map's key-value pairs are called its _entries_.
 Keys and values are eagerly evaluated.
@@ -3660,20 +3619,6 @@ Any Pkl value can be used as a map key:
 Map(new Dynamic { name = "Pigeon" }, 10.gb)
 ----
 
-Maps retain the order of entries when constructed, which impacts how they are iterated over.
-However, this order is not considered when determining equality of two maps.
-
-[source%tested,{pkl}]
-----
-res1 = Map(2, "hello", 1, "world")
-res2 = res1.entries.first // <1>
-res3 = res1.toMapping() // <2>
-res4 = res1 == Map(1, "world", 2, "hello") // <3>
-----
-<1> result: `Pair(2, "hello")`
-<2> result: `new Mapping { [2] = "hello"; [1] = "world" }`
-<3> result: `true`
-
 To merge maps, use the `+` operator:
 
 [source%tested,{pkl}]
@@ -3709,41 +3654,6 @@ res5 = map.getOrNull("Falcon") // <5>
 <4> result: `2`
 <5> result: `null`
 
-[[bytes]]
-=== Bytes
-
-A value of type `Bytes` is a sequence of `UInt8` elements.
-
-`Bytes` can be constructed by passing byte values into the constructor.
-
-[source,pkl]
-----
-bytes1 = Bytes(0xff, 0x00, 0x3f) // <1>
-bytes2 = Bytes() // <2>
-----
-<1> Result: a `Bytes` with 3 elements
-<2> Result: an empty `Bytes`
-
-`Bytes` can also be constructed from a base64-encoded string, via `base64DecodedBytes`:
-
-[source,pkl]
-----
-bytes3 = "cGFycm90".base64DecodedBytes // <1>
-----
-<1> Result: `Bytes(112, 97, 114, 114, 111, 116)`
-
-==== `Bytes` vs `List<UInt8>`
-
-`Bytes` is similar to `List<UInt8>` in that they are both sequences of `UInt8` elements.
-However, they are semantically distinct.
-`Bytes` represent binary data, and is typically rendered differently.
-For example, they are rendered as `<data>` tags when using `PListRenderer`.
-
-`Bytes` also have different performance characteristics; a value of type `Bytes` tends to be managed as a contiguous memory block.
-Thus, they are more compact and consume less memory.
-However, they are not optimized for transformations.
-For example, given two values of size `M` and `N`, concatenating two `Bytes` values allocates O(M + N) space, whereas concatenating two `List` values allocates O(1) space.
-
 [[regular-expressions]]
 === Regular Expressions
 
@@ -3977,7 +3887,6 @@ emailList: List<EmailAddress> // <2>
 <1> equivalent to `email: String(contains("@"))` for type checking purposes
 <2> equivalent to `emailList: List<String(contains("@"))>` for type checking purposes
 
-[[nullable-types]]
 ==== Nullable Types
 
 Class types such as `Bird` (see above) do not admit `null` values.
@@ -4732,10 +4641,6 @@ The following types are iterable:
 |entry key (`Key`)
 |entry value (`Value`)
 
-|`Bytes`
-|element index (`Int`)
-|element value (`UInt8`)
-
 |`Listing<Element>`
 |element index (`Int`)
 |element value (`Element`)
@@ -4816,9 +4721,6 @@ The following table describes how different iterables turn into object members:
 
 | `IntSeq`
 | Element
-
-| `Bytes`
-| Element
 |===
 
 These types can only be spread into enclosing objects that support that member type.
@@ -4901,161 +4803,6 @@ The predicate, enclosed in double brackets (`\[[...]]`), is matched against each
 Within the predicate, `this` refers to the member that the predicate is matched against.
 Matching members are amended (`{ ... }`) or overridden (`= <new-value>`).
 
-[[this-keyword]]
-=== `this` keyword
-
-Normally, the `this` keyword references the enclosing object's receiver.
-
-Example:
-[source,pkl]
-----
-bird {
-  eatsInsects = this is InsectavorousBird
-}
-----
-
-When used inside a <<type-constraints,type constraint>>, `this` refers to the value being tested.
-
-Example:
-[source,pkl]
-----
-port: UInt16(this > 1000)
-----
-
-When used inside a <<member-predicates,member predicate>>, `this` refers to the value being matched against.
-
-Example:
-[source,pkl]
-----
-animals {
-  [[this is Bird]] {
-    canFly = true
-  }
-}
-----
-
-[[receiver]]
-==== Receiver
-
-The receiver is the bottom-most object in the <<prototype-chain>>.
-That means that, within the context of an amending object, the receiver is the amending object.
-
-Example:
-[source,pkl]
-----
-hidden lawyerBird {
-  title = "\(this.name), Esq."
-}
-
-polly = (lawyerBird) {
-  name = "Polly" // <1>
-}
-----
-<1> Polly has title `"Polly, Esq."`.
-
-[[outer-keyword]]
-=== `outer` keyword
-
-The `outer` keyword references the <<receiver,receiver>> of the immediately outer lexical object.
-
-It can be useful to disambiguate a lookup that might otherwise resolve elsewhere.
-
-Example:
-[source%tested,pkl]
-----
-foo {
-  bar = "bar"
-  qux {
-    bar = outer.bar // <1>
-  }
-}
-----
-<1> References `bar` one level higher.
-
-Note that `outer` cannot be chained.
-In order to reference a value more than one level higher, a typical pattern is to declare a local property at that level.
-
-For example:
-
-[source%parsed,pkl]
-----
-foo {
-  local self = this
-  bar {
-    baz {
-      qux = self.qux
-    }
-  }
-}
-----
-
-[[super-keyword]]
-=== `super` keyword
-
-The `super` keyword references the parent object in the <<prototype-chain,prototype chain>>.
-
-When used within a class, it refers to the superclass's prototype.
-When used within an object, it refers to the parent object in the amends chain.
-
-Example:
-[source%tested,pkl]
-----
-bird = new { name = "Quail" }
-
-bird2 = (bird) { name = "Ms. \(super.name)" } // <1>
-
-abstract class Bird {
-  foods: Listing<String>
-
-  function canEat(food: String): Boolean = foods.contains(food)
-}
-
-class InsectavorousBird extends Bird {
-  function canEat(food: String) =
-    super.canEat(food) || food == "insect" // <2>
-}
-----
-<1> Result: `"Ms. Quail"`
-<2> Calls parent class method `canEat()`
-
-The `super` keyword must be followed by property/method access, or subscript.
-`super` by itself a syntax error; whereas `super.foo` and `super["foo"]` are valid expressions.
-
-[[module-keyword]]
-=== `module` keyword
-
-The `module` keyword can be used as either a value, or as a type.
-
-When used as a value, it refers to the <<receiver,receiver>> of the module itself.
-
-[source%tested,pkl]
-----
-name = "Quail"
-
-some {
-  deep {
-    object {
-      name = module.name // <1>
-    }
-  }
-}
-----
-<1> Resolves to `"Quail"`
-
-When used as a type, it is the module's class.
-
-[source%parsed,pkl]
-----
-module Bird
-
-friend: module // <1>
-----
-<1> Is class `Bird`
-
-The `module` type is a _self type_.
-If the module is extended by another module, the `module` type refers to the extending module when
-in the context of that module.
-
 [[glob-patterns]]
 === Glob Patterns
 
@@ -5142,8 +4889,8 @@ TIP: If incorporating escape characters into a glob pattern, use <<custom-string
 |===
 |Pattern |Description
 
-|`*.pk[lg]`
+|`*.pc[lf]`
-|Anything suffixed by `.pkl`, or `.pkg`.
+|Anything suffixed by `.pkl`, or `.pcf`.
 
 |`**.y{a,}ml`
 |Anything suffixed by either `yml` or `yaml`, crossing directory boundaries. 
@@ -5354,7 +5101,7 @@ Module-level members can be prefixed with `module.` to resolve name conflicts:
 /// See [module.pigeon].
 ----
 
-To exclude a member from documentation and code completion, <<annotations,annotate>> it with `@Unlisted`:
+To exclude a member from documentation and code completion, annotate it with `@Unlisted`:
 
 [source%parsed,{pkl}]
 ----
@@ -5371,47 +5118,6 @@ The following member links are marked up as code but not rendered as links:footn
 
 Nevertheless, it is a good practice to use member links in the above cases.
 
-[[annotations]]
-=== Annotations
-
-Annotations are a mechanism to provides extra metadata about Pkl <<modules,modules>>, <<classes,classes>>, <<methods,methods>>, and <<properties,properties>>.
-They provide metadata about the type or member they annotate that can be via link:{uri-stdlib-reflectModule}[reflection] or Pkl's Java APIs.
-The most common use cases for annotations are to add metadata to influence behavior of xref:pkl-doc:index.adoc[Pkldoc], code generation tools, or <<module-output,module output>>.
-
-Annotations are regular Pkl objects whose class extends link:{uri-stdlib-Annotation}[`Annotation`].
-Annotation instances are defined similarly to regular <<classes, class instances>>, but instead of using the `new` keyword the class name is prefixed with `@`.
-The object body may be omitted if an annotation's class has no properties or the declared annotation does not override any of the class's default values
-Multiple annotations may be defined on a member.
-If the annotated member has a <<doc-comments,doc comment>>, the annotation is defined between the comment and the member.
-
-[source%tested,{pkl}]
-----
-/// Module doc comment
-@SomeAnnotation // <1>
-module myModule
-
-class SomeAnnotation extends Annotation { // <2>
-  description: String = "some annotation"
-}
-
-/// Module doc comment
-@SomeAnnotation // <3>
-class Bird {
-  @SomeAnnotation { description = "some property" } // <4>
-  name: String
-
-  @SomeAnnotation { description = "some method" } // <5>
-  @Unlisted // <6>
-  function greet(greeting: String): String = "\(greeting), \(name)!"
-}
-----
-<1> An annotation applied to a module. The annotation(s) must precede the `module` clause and follow the doc comment. The object body is omitted.
-<2> The definition of an annotation class.
-<3> An annotation appied to a class. The object body is omitted.
-<4> An annotation applied to a property. The object body is included because the `description` property is overridden.
-<5> An annotation applied to a method. The object body is included because the `description` property is overridden.
-<6> A second annotation applied to the same method.
-
 [[name-resolution]]
 === Name Resolution
 
@@ -5542,6 +5248,11 @@ For example, the prototype chain of value `42` contains, now listed from top to
 
 A prototype chain never contains a non-object value, such as `42`.
 
+[[grammar-definition]]
+=== Grammar Definition
+
+Pkl's link:{uri-antlr4}[ANTLR 4] grammar is defined in link:{uri-github-PklLexer}[PklLexer.g4] and link:{uri-github-PklParser}[PklParser.g4].
+
 [[reserved-keywords]]
 === Reserved keywords
 
@@ -5558,8 +5269,6 @@ They cannot be used as a regular identifier, and currently do not have any meani
 
 To use these names in an identifier, <<quoted-identifiers, surround them with backticks>>.
 
-For a complete list of keywords, consult field `Lexer.KEYWORDS` in {uri-github-PklLexer}[Lexer.java].
-
 [[blank-identifiers]]
 === Blank Identifiers
 
@@ -5766,7 +5475,7 @@ Readers are implemented as ordinary executables and use Pkl's xref:bindings-spec
 The xref:swift:ROOT:index.adoc[Swift] and xref:go:ROOT:index.adoc[Go] language binding libraries provide an `ExternalReaderRuntime` type to facilitate implementing external readers.
 
 External readers are configured separately for modules and resources.
-They are registered by mapping their URI scheme to the executable to run and additional arguments to pass.
+They are registered by mapping their URI scheme to the executable to run and additonal arguments to pass.
 This is done on the command line by passing `--external-resource-reader` and `--external-module-reader` flags, which may both be passed multiple times.
 
 [source,text]
@@ -5822,25 +5531,3 @@ To support both schemes during evaluation, both would need to be registered expl
 ----
 $ pkl eval <module> --external-resource-reader ldap=pkl-ldap --external-resource-reader ldaps=pkl-ldap
 ----
-
-[[mirroring_packages]]
-=== Mirroring packages
-
-A package is a shareable archive of modules and resources that are published to the internet.
-
-A package's URI tells two things:
-
-1. The name of the package.
-2. Where the package is downloaded from.
-
-For example, given the package name `package://example.com/mypackage@1.0.0`, Pkl will make an HTTPS request to `\https://example.com/mypackage@1.0.0` to fetch package metadata.
-
-In situations where internet access is restricted, a mirror can be set up to allow use of packages that are published to the internet.
-
-To direct Pkl to a mirror, the `--http-rewrite` CLI option (and its equivalent options when using Pkl's other evaluator APIs) must be used.
-For example, `--http-rewrite \https://pkg.pkl-lang.org/=\https://my.internal.mirror/` will tell Pkl to download packages from host `my.internal.mirror`.
-
-NOTE: To effectively mirror packages from pkg.pkl-lang.org, there must be two rewrites; one for `\https://pkg.pkl-lang.org/` (where package metadata is downloaded), and one for `\https://github.com/` (where package zip files are downloaded).
-
-NOTE: Pkl does not provide any tooling to run a mirror server.
-To fully set up mirroring, an HTTP(s) server will need be running, and which mirrors the same assets byte-for-byte.

docs/modules/language-tutorial/pages/01_basic_config.adoc

@@ -134,7 +134,6 @@ exampleObjectWithMixedElements {
 <2> Elements don't have to be literal values; they can be arbitrary _expressions_.
 <3> Elements can really be _any_ value, not just primitive values.
 
-[[entries]]
 === Entries
 
 Objects can have one more kind of member; _entries_.

docs/modules/language-tutorial/pages/02_filling_out_a_template.adoc

@@ -213,7 +213,7 @@ adultBirdFoods {
 
 A `.pkl` file describes a _module_.
 Modules are objects that can be referred to from other modules.
-Going back to the example above, you can write `pigeon` as a separate module.
+Going back to the example above, you can write `parrot` as a separate module.
 
 [source,{pkl}]
 .pigeon.pkl

docs/modules/pkl-cli/pages/index.adoc

@@ -1,9 +1,8 @@
 = CLI
 include::ROOT:partial$component-attributes.adoc[]
 :uri-homebrew: https://brew.sh
-:uri-mise: https://mise.jdx.dev
-:uri-winget: https://learn.microsoft.com/en-us/windows/package-manager/
 
+:uri-sonatype-snapshot-download: https://s01.oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=org.pkl-lang&v={pkl-artifact-version}
 :uri-pkl-macos-amd64-download: {uri-sonatype-snapshot-download}&a=pkl-cli-macos-amd64&e=bin
 :uri-pkl-macos-aarch64-download: {uri-sonatype-snapshot-download}&a=pkl-cli-macos-aarch64&e=bin
 :uri-pkl-linux-amd64-download: {uri-sonatype-snapshot-download}&a=pkl-cli-linux-amd64&e=bin
@@ -54,7 +53,8 @@ whereas, the Alpine Linux executable is statically linked against _musl libc_ an
 ====
 
 The Java executable works on multiple platforms and has a smaller binary size than the native executables.
-However, it requires a Java 17 (or higher) runtime on the system path, and has a noticeable startup delay.
+However, it requires a Java 17 (or higher) runtime on the system path, has a noticeable startup delay,
+and runs complex Pkl code slower than the native executables.
 
 All flavors are built from the same codebase and undergo the same automated testing.
 Except where noted otherwise, the rest of this page discusses the native executables.
@@ -85,54 +85,6 @@ ifndef::is-release-version[]
 For instructions, switch to a release version of this page.
 endif::[]
 
-[[mise]]
-=== Mise
-
-On macOS, Linux, and Windows, release versions can be installed with {uri-mise}[Mise].
-
-ifdef::is-release-version[]
-To install Pkl, run:
-
-[source,shell]
-[subs="+attributes"]
-----
-# Install and activate Pkl globally
-mise use -g pkl@{pkl-version}
-
-# Install and activate Pkl locally
-mise use pkl@{pkl-version}
-----
-endif::[]
-
-ifndef::is-release-version[]
-For instructions, switch to a release version of this page.
-endif::[]
-
-[[winget]]
-=== Windows Package Manager
-
-On Windows, release versions can be installed with {uri-winget}[Windows Package Manager].
-
-ifdef::is-release-version[]
-To install Pkl, run:
-
-[source,shell]
-----
-winget install Apple.Pkl
-----
-
-To update Pkl, run:
-
-[source,shell]
-----
-winget upgrade Apple.Pkl
-----
-endif::[]
-
-ifndef::is-release-version[]
-For instructions, switch to a release version of this page.
-endif::[]
-
 [[download]]
 === Download
 
@@ -249,14 +201,6 @@ NOTE: We currently do not support the aarch64 architecture for Windows.
 [[java-executable]]
 === Java Executable
 
-The Java executable is a jar that can be executed directly on macOS, Linux, and Windows.
-
-It requires `java` to be installed, and available on `$PATH`.
-
-[tabs]
-====
-macOS/Linux::
-+
 [source,shell]
 [subs="+attributes"]
 ----
@@ -265,16 +209,6 @@ chmod +x jpkl
 ./jpkl --version
 ----
 
-Windows::
-+
-[source,PowerShell]
-[subs="+attributes"]
-----
-Invoke-WebRequest '{uri-pkl-java-download}' -OutFile jpkl.bat
-.\jpkl --version
-----
-====
-
 This should print something similar to:
 
 [source,shell]
@@ -283,7 +217,8 @@ This should print something similar to:
 Pkl {pkl-version} (macOS 14.2, Java 17.0.10)
 ----
 
-NOTE: The Java executable is named `jpkl`.
+NOTE: The Java executable does not work as an executable file on Windows.
+However, it will work as a jar, for example, with `java -jar jpkl`.
 
 [[usage]]
 == Usage
@@ -454,16 +389,6 @@ output {
 ----
 ====
 
-[[power-assertions-eval]]
-.--power-assertions, --no-power-assertions
-[%collapsible]
-====
-Default: enabled +
-Enable or disable power assertions for detailed assertion failure messages.
-When enabled, type constraint failures will show intermediate values in the assertion expression.
-Use `--no-power-assertions` to disable this feature if you prefer simpler output or better performance.
-====
-
 This command also takes <<common-options, common options>>.
 
 [[command-server]]
@@ -489,9 +414,7 @@ If these are the only failures, the command exits with exit code 10.
 Otherwise, failures result in exit code 1.
 
 <modules>::
-The absolute or relative URIs of the modules to test.
+The absolute or relative URIs of the modules to test. Relative URIs are resolved against the working directory.
-The module must extend `pkl:test`.
-Relative URIs are resolved against the working directory.
 
 ==== Options
 
@@ -503,31 +426,9 @@ Default: (none) +
 Example: `./build/test-results` +
 Directory where to store JUnit reports.
 
-By default, one file will be created for each test module. This behavior can be changed with `--junit-aggregate-reports`, which will instead create a single JUnit report file with all test results.
-
 No JUnit reports will be generated if this option is not present.
 ====
 
-[[junit-aggregate-reports]]
-.--junit-aggregate-reports
-[%collapsible]
-====
-Aggregate JUnit reports into a single file.
-
-By default it will be `pkl-tests.xml` but you can override it using `--junit-aggregate-suite-name` flag.
-====
-
-[[junit-aggregate-suite-name]]
-.--junit-aggregate-suite-name
-[%collapsible]
-====
-Default: (none) +
-Example: `my-tests` +
-The name of the root JUnit test suite.
-
-Used in combination with `--junit-aggregate-reports` flag.
-====
-
 [[overwrite]]
 .--overwrite
 [%collapsible]
@@ -536,33 +437,6 @@ Force generation of expected examples. +
 The old expected files will be deleted if present.
 ====
 
-[[power-assertions-test]]
-.--power-assertions, --no-power-assertions
-[%collapsible]
-====
-Default: enabled +
-Enable or disable power assertions for detailed assertion failure messages.
-When enabled, test failures will show intermediate values in the assertion expression, making it easier to understand why a test failed.
-Use `--no-power-assertions` to disable this feature if you prefer simpler output.
-====
-
-This command also takes <<common-options, common options>>.
-
-[[command-run]]
-=== `pkl run`
-
-*Synopsis:* `pkl run [<options>] [<module>] [<command options>]`
-
-Evaluate a <<cli-tools,CLI command>> defined by `<module>`.
-
-<module>::
-The absolute or relative URIs of the command module to run.
-The module must extend `pkl:Command`.
-Relative URIs are resolved against the working directory.
-
-<command options>::
-Additional CLI options and arguments defined by `<module>`.
-
 This command also takes <<common-options, common options>>.
 
 [[command-repl]]
@@ -642,24 +516,6 @@ Directory where to store JUnit reports.
 No JUnit reports will be generated if this option is not present.
 ====
 
-.--junit-aggregate-reports
-[%collapsible]
-====
-Aggregate JUnit reports into a single file.
-
-By default it will be `pkl-tests.xml` but you can override it using `--junit-aggregate-suite-name` flag.
-====
-
-.--junit-aggregate-suite-name
-[%collapsible]
-====
-Default: (none) +
-Example: `my-tests` +
-The name of the root JUnit test suite.
-
-Used in combination with `--junit-aggregate-reports` flag.
-====
-
 .--overwrite
 [%collapsible]
 ====
@@ -756,70 +612,10 @@ Same meaning as <<output-path>> in <<command-eval>>.
 
 This command also takes <<common-options,common options>>.
 
-[[command-shell-completion]]
-=== `pkl shell-completion`
-
-*Synopsis*: `pkl shell-completion <shell>`
-
-Generate shell completion script. Supported shells are: `bash`, `zsh`, `fish`.
-
-[source,shell]
-----
-# Generate shell completion script for bash
-pkl shell-completion bash
-
-# Generate shell completion script for zsh
-pkl shell-completion zsh
-----
-
-[[command-format]]
-=== `pkl format`
-
-*Synopsis*: `pkl format <options> [<paths>]`
-
-This command formats or checks formatting of Pkl files. +
-Exit codes:
-
-* 0: No violations found or files were updated.
-* 1: An unexpected error happened (ex.: IO error)
-* 11: Violations were found (when running without `--write`).
-
-If the path is a directory, recursively looks for files with a `.pkl` extension, or files named `PklProject`.
-
-By default, the input files are formatted, and written to standard out.
-
-==== Options
-
-.--grammar-version
-[%collapsible]
-====
-Default: `2` (latest version) +
-Select the grammar compatibility version for the formatter.
-New versions are created for each backward incompatible grammar change.
-====
-
-.-s, --silent
-[%collapsible]
-====
-Skip writing to standard out. Mutually exclusive with `--diff-name-only`.
-====
-
-.-w, --write
-[%collapsible]
-====
-Format files in place, overwriting them. Implies `--diff-name-only`.
-====
-
-.--diff-name-only
-[%collapsible]
-====
-Write the path of files with formatting violations to stdout.
-====
-
 [[common-options]]
 === Common options
 
-The <<command-eval>>, <<command-test>>, <<command-run>>, <<command-repl>>, <<command-project-resolve>>, <<command-project-package>>, <<command-download-package>>, and <<command-analyze-imports>> commands support the following common options:
+The <<command-eval>>, <<command-test>>, <<command-repl>>, <<command-project-resolve>>, <<command-project-package>>, <<command-download-package>>, and <<command-analyze-imports>> commands support the following common options:
 
 include::../../pkl-cli/partials/cli-common-options.adoc[]
 
@@ -827,17 +623,6 @@ The <<command-eval>>, <<command-test>>, <<command-repl>>, <<command-download-pac
 
 include::../../pkl-cli/partials/cli-project-options.adoc[]
 
-[[root-options]]
-=== Root options
-
-The root `pkl` command supports the following options:
-
-.-v, --version
-[%collapsible]
-====
-Display version information.
-====
-
 == Evaluating Modules
 
 Say we have the following module:
@@ -920,310 +705,6 @@ If multiple module outputs are written to the same file, or to standard output,
 By default, module outputs are separated with `---`, as in a YAML stream.
 The separator can be customized using the `--module-output-separator` option.
 
-[[cli-tools]]
-== Implementing CLI Tools
-
-CLI tools can be implemented in Pkl by modules extending the `pkl:Command` module.
-With `pkl:Command`, you can define a script in Pkl that is executed by your shell, providing a better CLI experience.
-
-Regular evaluation requires use of xref:language-reference:index.adoc#resources[resources] like properties and evironment variables to provide parameters:
-[source,bash]
-----
-$ pkl eval script.pkl -p username=me -p password=password
-----
-
-Commands provide a native, familiar CLI experience:
-[source,bash]
-----
-$ pkl run script.pkl --username=admin --password=hunter2
-$ ./script.pkl --username=admin --password=hunter2
-----
-
-Pkl commands have a few properties that distinguish them from standard module evaluation:
-
-* Users provide input to commands using familiar command line idioms, providing a better experience than deriving inputs from xref:language-reference:index.adoc#resources[resources] like external properties or environment variables.
-* Commands can dynamically import modules when they are specified as command line options.
-* Commands may write to standard output (via `output.text` or `output.bytes`) and the filesystem (via `output.files`) in the same evaluation.
-* Command file output may write to any absolute path (not only relative to the `--multiple-file-output-path` option).
-** Relative output paths are written relative to the current working directory (or `--working-dir`, if specified).
-** Paths of output file are printed to the command's standard error.
-
-IMPORTANT: Users of `pkl run` must be aware of the security implications of this behavior.
-Using `pkl eval` prevents accidental overwrites by not allowing absolute paths, but `pkl run` does not offer this protection.
-Commands may write to any path the invoking user has permissions to modify.
-
-Commands are implemented as regular modules and declare their supported command line flags and positional arguments using a class with annotated properties.
-
-=== Defining Commands
-
-Commands are defined by creating a module that extends `pkl:Command`:
-
-[source,pkl%tested]
-.my-tool.pkl
-----
-/// This doc comment becomes part of the command's CLI help!
-/// Markdown formatting is **allowed!**
-extends "pkl:Command"
-
-options: Options // <1>
-
-class Options {
-  // Define CLI flags/arguments...
-}
-
-// Regular module code...
-----
-<1> Re-declaration of the `options` property's type.
-
-Like `pkl eval`, when a command completes without an evaluation error the process exits successfully (exit code 0).
-Commands can return a failure using `throw` (exit code 1), but otherwise may not control the exit code.
-
-Other than the differences listed above, commands behave like any other Pkl module.
-For example, there is no way to execute other programs or make arbitrary HTTP requests.
-If additional functionality is desired, xref:language-reference:index.adoc#external-readers[external readers] may be used to extends Pkl's capabilities.
-
-=== Command Options
-
-Each property of a command's options class becomes a command line option.
-Properties with the `local`, `hidden`, `fixed`, and/or `const` modifiers are not parsed as options
-A property's doc comment, if present, becomes the corresponding option's CLI help description.
-Doc comments are interpreted as Markdown text and formatted nicely when displayed to users.
-Properties must have xref:language-reference:index.adoc#type-annotations[type annotations] to determine how they are parsed.
-
-Properties may be xref:language-reference:index.adoc#annotations[annotated] to influence how they behave:
-
-* Properties annotated with link:{uri-stdlib-Command-Flag}[`@Flag`] become CLI flags named `--<property name>` that accept a value.
-* `Boolean` properties annotated with link:{uri-stdlib-Command-BooleanFlag}[`@BooleanFlag`] become CLI flags named `--<property name>` and `--no-<property name>` that result in `true` and `false` values, respectively.
-* `Int` (and type aliases of `Int`) properties annotated with link:{uri-stdlib-Command-CountedFlag}[`@CountedFlag`] become CLI flags named `--<property name>` that produce a value equal to the number of times they are present on the command line.
-* Properties annotated with link:{uri-stdlib-Command-Argument}[`@Argument`] become positional CLI arguments and are parsed in the order they appear in the class.
-* Properties with no annotation are treated the same as `@Flag` with no further customization.
-
-Flag options may set a `shortName` property to define a single-character abbreviation (`-<short name>`).
-Flag abbreviations may be combined (e.g. `-a -b -v -v -q some-value` is equivalent to `-abvvq some-value`).
-
-[CAUTION]
-====
-Flag names and short names may not conflict with <<common-options,common options>>.
-Future versions of Pkl may introduce additional common options and the names of these options will become forbidden for use in `pkl:Command`.
-Thus, any Pkl release that adds common options may introduce breaking changes for commands.
-
-While unfortunate, this behavior eliminates potentially dangerous or misleading ambiguities between Pkl-defined and user-defined options.
-====
-
-A `@Flag` or `@Argument` property's type annotation determines how it is converted from the raw string value:
-
-|===
-|Type |Behavior
-
-|`String`
-|Value is used verbatim.
-
-|`Char`
-|Value is used verbatim but must be exactly one character.
-
-|`Boolean`
-|True values: `true`, `t`, `1`, `yes`, `y`, `on`
-
-False values: `false`, `f`, `0`, `no`, `n`, `off`
-
-|`Number`
-|Value is parsed as an `Int` if possible, otherwise parsed as `Float`.
-
-|`Float`
-|Value is parsed as a `Float`.
-
-|`Int`
-|Value is parsed as a `Int`.
-
-|`Int8`, `Int16`, `Int32`, `UInt`, `UInt8`, `UInt16`, `UInt32`
-|Value is parsed as a `Int` and must be within the type's range.
-
-|xref:language-reference:index.adoc#union-types[Union] of xref:language-reference:index.adoc#string-literal-types[string literals]
-|Value is used verbatim but must match a member of the union.
-
-|`List<Element>`, `Listing<Element>`, `Set<Element>`
-|Each occurrence of the option becomes an element of the final value.
-
-`Element` values are parsed based on the above primitive types.
-
-|`Map<Key, Value>`, `Mapping<Key, Value>`
-|Each occurrence of the option becomes an entry of the final value.
-
-Values are split on the first `"="` character; the first part is parsed as `Key` and the second as `Value`, both based on the above primitive types.
-
-|`Pair<First, Second>`
-|Value is split on the first `"="` character; the first part is parsed as `First` and the second as `Second`, both based on the above primitive types.
-
-|===
-
-If a flag that accepts only a single value is provided multiple times, the last occurrence becomes the final value.
-
-Only a single positional argument accepting multiple values is permitted per command.
-
-A property with a xref:language-reference:index.adoc#nullable-types[nullable type] is optional and, if not specified on the command line, will have value `null`.
-Properties with default values are also optional.
-Type constraints are evaluated when the command is executed, so additional restrictions on option values are enforced at runtime.
-
-==== Custom Option Conversion and Aggregation
-
-A property may be annotated with any type if its `@Flag` or `@Argument` annotation sets the `convert` or `transformAll` properties.
-The `convert` property is a xref:language-reference:index.adoc#anonymous-functions[function] that overrides how _each_ raw option value is interpreted.
-The `transformAll` property is a function that overrides how _all_ parsed option values become the final property value.
-
-The `convert` and `transformAll` functions may return an pkldoc:Import[pkl:Command] value that is replaced during option parsing with the actual value of the module specified by its `uri` property.
-If `glob` is `true`, the replacement value is a `Mapping`; its keys are the _absolute_ URIs of the matched modules and its values are the actual module values.
-When specifying glob import options on the command line, it is often necessary to quote the value to avoid it being interpreted by the shell.
-If the return value of `convert` or `transformAll` is a `List`, `Set`, `Map`, or `Pair`, each contained value (elements and entry keys/values) that are `Import` values are also replaced.
-
-[IMPORTANT]
-====
-If an option has type `Mapping<String, «some module type»>` and should accept a single glob pattern value, the option's annotation must also set `multiple = false` to override the default behavior of `Mapping` options accepting multiple values.
-Example:
-[source%parsed,{pkl}]
-----
-@Flag {
-  convert = (it) -> new Import { uri = it; glob = true }
-  multiple = false
-}
-birds: Mapping<String, Bird>
-----
-
-If multiple glob patterns values should be accepted and merged, `transformAll` may be used to merge every glob-imported `Mapping`:
-[source%parsed,{pkl}]
-----
-@Flag {
-  convert = (it) -> new Import { uri = it; glob = true }
-  transformAll =
-    (values) -> values.fold(new Mapping {}, (result, element) ->
-      (result) { ...element }
-    )
-}
-birds: Mapping<String, Bird>
-----
-====
-
-=== Subcommands
-
-Like many other command line libraries, `pkl:Command` allows building commands into a hierarchy with a root command and subcommands:
-
-[source,pkl%tested]
-.my-tool.pkl
-----
-extends "pkl:Command"
-
-command {
-  subcommands {
-    import("subcommand1.pkl")
-    import("subcommand2.pkl")
-    for (_, subcommand in import*("./subcommands/*.pkl")) {
-      subcommand
-    }
-  }
-}
-----
-
-[source,pkl%tested]
-.subcommand1.pkl
-----
-extends "pkl:Command"
-
-import "my-tool.pkl"
-
-parent: `my-tool` // <1>
-
-// Regular module code...
-----
-<1> Optional; asserts that this is a subcommand of `my-tool` and simplifies accessing properties and options of the parent command
-
-Each element of `subcommands` must have a unique value for `command.name`.
-
-=== Testing Commands
-
-Command modules are normal Pkl modules, so they may be imported and used like any other module.
-This is particularly helpful when testing commands, as the command's `options` and `parent` properties can be populated by test code.
-
-Testing the above command and subcommand might look like this:
-
-[source,pkl%tested]
-----
-amends "pkl:test"
-
-import "my-tool.pkl"
-import "subcommand1.pkl"
-
-examples {
-  ["Test my-tool"] {
-    (`my-tool`) {
-      options {
-        // Set my-tool options here...
-      }
-    }.output.text
-  }
-  ["Test subcommand1"] {
-    (subcommand1) {
-      parent { // this amends `my-tool`
-        options {
-          // Set my-tool options here...
-        }
-      }
-      options {
-        // Set subcommand options here...
-      }
-    }.output.text
-  }
-}
-----
-
-[[commands-as-standalone-scripts]]
-=== Commands as standalone scripts
-
-On *nix platforms, Pkl commands can be configured to run as standalone tools that can be invoked without the `pkl run` command.
-To achieve this, the command file must be marked executable (i.e. `chmod +x my-tool.pkl`) and a link:https://en.wikipedia.org/wiki/Shebang_(Unix)[shebang comment] must be added on the first line of the file:
-
-[source,pkl%parsed]
-----
-#!/usr/bin/env -S pkl run
-----
-
-NOTE: The `-S` flag for `env` is required on Linux systems due to a limitation of shebang handling in the Linux kernel.
-While not required on other *nix platforms like macOS, but it should be included for compatibility.
-
-==== Shell Completion
-
-Like with Pkl's own CLI, <<command-shell-completion, shell completions>> can be generated for standalone scripts.
-
-[source,shell]
-----
-# Generate shell completion script for bash
-./my-tool.pkl shell-completion bash
-
-# Generate shell completion script for zsh
-./my-tool.pkl shell-completion zsh
-----
-
-==== Customizing Completion Candidates
-
-`@Flag` and `@Argument` annotations may specify the `completionCandidates` to improve generated shell completions.
-
-Valid values include:
-
-* A `Listing<String>` of literal string values to offer for completion.
-* The literal string `"path"`, which offers local file paths for completion.
-
-Options with a string literal union type implicitly offer the members of the union as completion candidates.
-
-=== Flag name ambiguities
-
-It is possible for commands to define flags with names or short names that collide with Pkl's own command line options.
-To avoid ambiguity in parsing these options, all flags for Pkl itself (e.g. `--root-dir`) must be placed before the root command module's URI.
-Command authors are encouraged to avoid overlapping with Pkl's built-in flags, but this may not always be feasible, especially for single-character abbreviated names.
-
-This imposes a limitation around <<commands-as-standalone-scripts,standalone commands>> that prevents users from customizing Pkl evaluator options when they are invoked.
-There are two recommended workarounds for this limitation:
-
-* Use a `PklProject` to define evaluator settings instead of doing so on the command line.
-* If the command line must be used, switch to invoking via `pkl run [<flags>] [<root command module>]`.
-
 [[repl]]
 == Working with the REPL
 
@@ -1240,6 +721,8 @@ Type :help or :examples for more information.
 pkl>
 ----
 
+NOTE: The Java executable is named `jpkl`.
+
 === Loading Modules
 
 To load <<config.pkl,`config.pkl`>> into the REPL, run: