Start next dev iteration

2026-01-11 06:10:40 +01:00 · 2025-11-03 11:46:45 -08:00
parent 7f231cd916
commit 4d70baba86
29 changed files with 85 additions and 27 deletions
--- 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
--- 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

--- a/docs/modules/release-notes/pages/0.31.adoc
+++ 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
--- 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)

--- 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]
--- 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]
--- 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= \
--- 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<VmContext> {
--- 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
--- 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
--- 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"
--- 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

--- 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
--- 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
--- 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"
--- 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.
--- 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].
--- 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`.
--- a/stdlib/pklbinary.pkl
+++ b/stdlib/pklbinary.pkl
@@ -28,7 +28,7 @@
 /// The `pkl-binary` format uses MessagePack encoding.
 /// Its specification is available at
 /// <https://pkl-lang.org/main/current/bindings-specification/binary-encoding.html>.
-@ModuleInfo { minPklVersion = "0.30.0" }
+@ModuleInfo { minPklVersion = "0.31.0" }
 module pkl.pklbinary

 /// Render values as `pkl-binary`.
--- 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.
--- 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"
--- 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"
--- 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"
--- 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.
--- 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"
--- 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.
--- 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].
--- 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.
--- 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.