From 4d70baba86b05a40a9dfc7388302c2641f0435c1 Mon Sep 17 00:00:00 2001 From: Dan Chao Date: Mon, 3 Nov 2025 11:46:45 -0800 Subject: [PATCH] Start next dev iteration --- docs/antora.yml | 4 +- .../ROOT/partials/component-attributes.adoc | 4 +- docs/modules/release-notes/pages/0.31.adoc | 51 +++++++++++++++++++ .../release-notes/pages/changelog.adoc | 5 ++ docs/modules/release-notes/pages/index.adoc | 1 + docs/nav.adoc | 1 + gradle.properties | 2 +- .../java/org/pkl/core/runtime/VmLanguage.java | 2 +- stdlib/Benchmark.pkl | 2 +- stdlib/DocPackageInfo.pkl | 2 +- stdlib/DocsiteInfo.pkl | 2 +- stdlib/EvaluatorSettings.pkl | 2 +- stdlib/Project.pkl | 2 +- stdlib/analyze.pkl | 2 +- stdlib/base.pkl | 2 +- stdlib/json.pkl | 2 +- stdlib/jsonnet.pkl | 2 +- stdlib/math.pkl | 2 +- stdlib/pklbinary.pkl | 2 +- stdlib/platform.pkl | 2 +- stdlib/protobuf.pkl | 2 +- stdlib/reflect.pkl | 2 +- stdlib/release.pkl | 2 +- stdlib/semver.pkl | 2 +- stdlib/settings.pkl | 2 +- stdlib/shell.pkl | 2 +- stdlib/test.pkl | 2 +- stdlib/xml.pkl | 2 +- stdlib/yaml.pkl | 2 +- 29 files changed, 85 insertions(+), 27 deletions(-) create mode 100644 docs/modules/release-notes/pages/0.31.adoc diff --git a/docs/antora.yml b/docs/antora.yml index 14a45d5b..37ec841d 100644 --- a/docs/antora.yml +++ b/docs/antora.yml @@ -1,6 +1,6 @@ name: main title: Main Project -version: 0.30.0 -prerelease: false +version: 0.31.0-dev +prerelease: true nav: - nav.adoc diff --git a/docs/modules/ROOT/partials/component-attributes.adoc b/docs/modules/ROOT/partials/component-attributes.adoc index 941ff8f3..2ff24650 100644 --- a/docs/modules/ROOT/partials/component-attributes.adoc +++ b/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.30.0 +:pkl-version-no-suffix: 0.31.0 // 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 diff --git a/docs/modules/release-notes/pages/0.31.adoc b/docs/modules/release-notes/pages/0.31.adoc new file mode 100644 index 00000000..9be256b3 --- /dev/null +++ b/docs/modules/release-notes/pages/0.31.adoc @@ -0,0 +1,51 @@ += Pkl 0.31 Release Notes +:version: 0.31 +:version-minor: 0.XX.0 +:release-date: TBD + +link:ROOT:partial$component-attributes.adoc[role=include] + +Pkl {version} was released on {release-date}. + +[.small]#The latest bugfix release is {version-minor}. (xref:changelog.adoc[All Versions])# + +The next release (0.XX) is scheduled for ???.. +To see what's coming in the future, follow the {uri-pkl-roadmap}[Pkl Roadmap]. + +Please send feedback and questions to https://github.com/apple/pkl/discussions[GitHub Discussions], or submit an issue on https://github.com/apple/pkl/issues/new[GitHub]. + + +[small]#Pkl is hosted on https://github.com/apple/pkl[GitHub]. +To get started, follow xref:pkl-cli:index.adoc#installation[Installation].# + +== Highlights [small]#💖# + +News you don't want to miss. + +=== XXX + +== Noteworthy [small]#🎶# + +Ready when you need them. + +=== XXX + +== Breaking Changes [small]#💔# + +Things to watch out for when upgrading. + +=== XXX + +== Miscellaneous [small]#🐸# + +* XXX + +== Bugs fixed [small]#🐜# + +The following bugs have been fixed. + +* XXX (https://github.com/apple/pkl/issues/XXX[XXX]) + +== Contributors [small]#🙏# + +We would like to thank the contributors to this release (in alphabetical order): + +* XXX diff --git a/docs/modules/release-notes/pages/changelog.adoc b/docs/modules/release-notes/pages/changelog.adoc index 7fde1a3c..02d30306 100644 --- a/docs/modules/release-notes/pages/changelog.adoc +++ b/docs/modules/release-notes/pages/changelog.adoc @@ -1,6 +1,11 @@ = Changelog include::ROOT:partial$component-attributes.adoc[] +[[release-0.31.0]] +== 0.31.0 (UNRELEASED) + +xref:0.31.adoc[Release Notes] + [[release-0.30.0]] == 0.30.0 (2025-10-30) diff --git a/docs/modules/release-notes/pages/index.adoc b/docs/modules/release-notes/pages/index.adoc index d24f7c56..66d8415c 100644 --- a/docs/modules/release-notes/pages/index.adoc +++ b/docs/modules/release-notes/pages/index.adoc @@ -2,6 +2,7 @@ The Pkl team aims to release a new version of Pkl in February, June, and October of each year. +* xref:0.31.adoc[0.31 Release Notes] * xref:0.30.adoc[0.30 Release Notes] * xref:0.29.adoc[0.29 Release Notes] * xref:0.28.adoc[0.28 Release Notes] diff --git a/docs/nav.adoc b/docs/nav.adoc index e46e1a95..a993c2fb 100644 --- a/docs/nav.adoc +++ b/docs/nav.adoc @@ -41,6 +41,7 @@ * xref:ROOT:evolution-and-roadmap.adoc[Evolution and Roadmap] * xref:release-notes:index.adoc[Release Notes] +** xref:release-notes:0.31.adoc[0.31 Release Notes] ** xref:release-notes:0.30.adoc[0.30 Release Notes] ** xref:release-notes:0.29.adoc[0.29 Release Notes] ** xref:release-notes:0.28.adoc[0.28 Release Notes] diff --git a/gradle.properties b/gradle.properties index 5613a632..043f5345 100644 --- a/gradle.properties +++ b/gradle.properties @@ -1,7 +1,7 @@ # suppress inspection "UnusedProperty" for whole file group=org.pkl-lang -version=0.30.0 +version=0.31.0 # google-java-format requires jdk.compiler exports org.gradle.jvmargs= \ diff --git a/pkl-core/src/main/java/org/pkl/core/runtime/VmLanguage.java b/pkl-core/src/main/java/org/pkl/core/runtime/VmLanguage.java index aee14104..1b57be15 100644 --- a/pkl-core/src/main/java/org/pkl/core/runtime/VmLanguage.java +++ b/pkl-core/src/main/java/org/pkl/core/runtime/VmLanguage.java @@ -33,7 +33,7 @@ import org.pkl.parser.syntax.Module; @TruffleLanguage.Registration( id = "pkl", name = "Pkl", - version = "0.30.0", + version = "0.31.0-dev", characterMimeTypes = VmLanguage.MIME_TYPE, contextPolicy = ContextPolicy.SHARED) public final class VmLanguage extends TruffleLanguage { diff --git a/stdlib/Benchmark.pkl b/stdlib/Benchmark.pkl index 77426480..61ff1845 100644 --- a/stdlib/Benchmark.pkl +++ b/stdlib/Benchmark.pkl @@ -36,7 +36,7 @@ /// /// Warning: Although this module is ready for initial use, /// benchmark results may be inaccurate or inconsistent. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.Benchmark import "pkl:platform" as _platform diff --git a/stdlib/DocPackageInfo.pkl b/stdlib/DocPackageInfo.pkl index 42b2dd69..41040faf 100644 --- a/stdlib/DocPackageInfo.pkl +++ b/stdlib/DocPackageInfo.pkl @@ -63,7 +63,7 @@ /// @Deprecated { message = "Use `com.example.Birds.Parrot` instead" } /// amends "pkl:PackageInfo" /// ``` -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.DocPackageInfo // used by doc comments diff --git a/stdlib/DocsiteInfo.pkl b/stdlib/DocsiteInfo.pkl index 07e989c8..a2cff7ca 100644 --- a/stdlib/DocsiteInfo.pkl +++ b/stdlib/DocsiteInfo.pkl @@ -31,7 +31,7 @@ /// /// title = "Title displayed in the header of each page" /// ``` -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.DocsiteInfo import "pkl:reflect" diff --git a/stdlib/EvaluatorSettings.pkl b/stdlib/EvaluatorSettings.pkl index a0719336..a27fe359 100644 --- a/stdlib/EvaluatorSettings.pkl +++ b/stdlib/EvaluatorSettings.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// Common settings for Pkl's own evaluator. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } @Since { version = "0.26.0" } module pkl.EvaluatorSettings diff --git a/stdlib/Project.pkl b/stdlib/Project.pkl index 93f1f7e2..d9e9b7fe 100644 --- a/stdlib/Project.pkl +++ b/stdlib/Project.pkl @@ -64,7 +64,7 @@ /// value = project /// } /// ``` -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.Project import "pkl:EvaluatorSettings" as EvaluatorSettingsModule diff --git a/stdlib/analyze.pkl b/stdlib/analyze.pkl index 465b1637..8c00d220 100644 --- a/stdlib/analyze.pkl +++ b/stdlib/analyze.pkl @@ -19,7 +19,7 @@ /// These tools differentiate from [pkl:reflect][reflect] in that they parse Pkl modules, but do not /// execute any code within these modules. @Since { version = "0.27.0" } -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.analyze // used by doc comments diff --git a/stdlib/base.pkl b/stdlib/base.pkl index b15b4c0f..5e52f9f1 100644 --- a/stdlib/base.pkl +++ b/stdlib/base.pkl @@ -17,7 +17,7 @@ /// Fundamental properties, methods, and classes for writing Pkl programs. /// /// Members of this module are automatically available in every Pkl module. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.base import "pkl:jsonnet" diff --git a/stdlib/json.pkl b/stdlib/json.pkl index 054d7d49..afce87d3 100644 --- a/stdlib/json.pkl +++ b/stdlib/json.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// A JSON parser. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.json /// A JSON parser. diff --git a/stdlib/jsonnet.pkl b/stdlib/jsonnet.pkl index bb15a223..3a2fd6e6 100644 --- a/stdlib/jsonnet.pkl +++ b/stdlib/jsonnet.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// A [Jsonnet](https://jsonnet.org) renderer. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.jsonnet /// Constructs an [ImportStr]. diff --git a/stdlib/math.pkl b/stdlib/math.pkl index bbbf000f..5df6e5f7 100644 --- a/stdlib/math.pkl +++ b/stdlib/math.pkl @@ -18,7 +18,7 @@ /// /// Note that some mathematical functions, such as `sign()`, `abs()`, and `round()`, /// are directly defined in classes [Number], [Int], and [Float]. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.math /// The minimum [Int] value: `-9223372036854775808`. diff --git a/stdlib/pklbinary.pkl b/stdlib/pklbinary.pkl index 606a8249..f6c390b5 100644 --- a/stdlib/pklbinary.pkl +++ b/stdlib/pklbinary.pkl @@ -28,7 +28,7 @@ /// The `pkl-binary` format uses MessagePack encoding. /// Its specification is available at /// . -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.pklbinary /// Render values as `pkl-binary`. diff --git a/stdlib/platform.pkl b/stdlib/platform.pkl index 66967c5c..e1dd598f 100644 --- a/stdlib/platform.pkl +++ b/stdlib/platform.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// Information about the platform that the current program runs on. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.platform /// The platform that the current program runs on. diff --git a/stdlib/protobuf.pkl b/stdlib/protobuf.pkl index 0f8d1000..d1518bdb 100644 --- a/stdlib/protobuf.pkl +++ b/stdlib/protobuf.pkl @@ -16,7 +16,7 @@ /// A renderer for [Protocol Buffers](https://developers.google.com/protocol-buffers). /// Note: This module is _experimental_ and not ready for production use. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.protobuf import "pkl:reflect" diff --git a/stdlib/reflect.pkl b/stdlib/reflect.pkl index 1267a6fa..f7073865 100644 --- a/stdlib/reflect.pkl +++ b/stdlib/reflect.pkl @@ -26,7 +26,7 @@ /// - Documentation generators (such as *Pkldoc*) /// - Code generators (such as *pkl-codegen-java* and *pkl-codegen-kotlin*) /// - Domain-specific schema validators -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.reflect import "pkl:base" diff --git a/stdlib/release.pkl b/stdlib/release.pkl index 2ef35f4f..28d5a0a9 100644 --- a/stdlib/release.pkl +++ b/stdlib/release.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// Information about the Pkl release that the current program runs on. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.release import "pkl:semver" diff --git a/stdlib/semver.pkl b/stdlib/semver.pkl index de1dc288..ccf04cd9 100644 --- a/stdlib/semver.pkl +++ b/stdlib/semver.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// Parsing, comparison, and manipulation of [semantic version](https://semver.org/spec/v2.0.0.html) numbers. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.semver /// Tells whether [version] is a valid semantic version number. diff --git a/stdlib/settings.pkl b/stdlib/settings.pkl index 4fa88cb9..95cff3c4 100644 --- a/stdlib/settings.pkl +++ b/stdlib/settings.pkl @@ -19,7 +19,7 @@ /// Every settings file must amend this module. /// Unless CLI commands and build tool plugins are explicitly configured with a settings file, /// they will use `~/.pkl/settings.pkl` or the defaults specified in this module. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.settings import "pkl:EvaluatorSettings" diff --git a/stdlib/shell.pkl b/stdlib/shell.pkl index a5bc1511..0650fcc3 100644 --- a/stdlib/shell.pkl +++ b/stdlib/shell.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// Utilities for generating shell scripts. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.shell /// Escapes [str] by enclosing it in single quotes. diff --git a/stdlib/test.pkl b/stdlib/test.pkl index 5ec91d8b..489b8c60 100644 --- a/stdlib/test.pkl +++ b/stdlib/test.pkl @@ -18,7 +18,7 @@ /// /// To write tests, amend this module and define [facts] or [examples] (or both). /// To run tests, evaluate the amended module. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } open module pkl.test /// Named groups of boolean expressions that are expected to evaluate to [true]. diff --git a/stdlib/xml.pkl b/stdlib/xml.pkl index 3e335e4e..99822ed8 100644 --- a/stdlib/xml.pkl +++ b/stdlib/xml.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// An XML renderer. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.xml /// Renders values as XML. diff --git a/stdlib/yaml.pkl b/stdlib/yaml.pkl index 3f7b7bef..53bf8b51 100644 --- a/stdlib/yaml.pkl +++ b/stdlib/yaml.pkl @@ -15,7 +15,7 @@ //===----------------------------------------------------------------------===// /// A YAML 1.2 compliant YAML parser. -@ModuleInfo { minPklVersion = "0.30.0" } +@ModuleInfo { minPklVersion = "0.31.0" } module pkl.yaml /// A YAML parser.