Add release notes for Scala CLI v1.13.0 (#4231)

Gedochao · web-flow · commit ed37d805bf4a · 2026-04-15T12:05:38.000Z
diff --git a/website/docs/release_notes.md b/website/docs/release_notes.md
@@ -8,6 +8,117 @@ import ReactPlayer from 'react-player'
 
 # Release notes
 
+## [v1.13.0](https://github.com/VirtusLab/scala-cli/releases/tag/v1.13.0)
+
+### Change default Scala version to 3.8.3
+This Scala CLI version switches the default Scala version to 3.8.3.
+
+```bash
+scala-cli version
+# Scala CLI version: 1.13.0
+# Scala version (default): 3.8.3
+```
+
+Added by [@Gedochao](https://github.com/Gedochao) in [#4204](https://github.com/VirtusLab/scala-cli/pull/4204)
+
+### Support for Scala.js 1.21.0
+This Scala CLI version adds support for Scala.js 1.21.0.
+
+```bash
+scala-cli -e 'println("Hello")' --js
+# Compiling project (Scala 3.8.3, Scala.js 1.21.0)
+# Compiled project (Scala 3.8.3, Scala.js 1.21.0)
+# Hello
+```
+
+Added by [@Gedochao](https://github.com/Gedochao) in [#4229](https://github.com/VirtusLab/scala-cli/pull/4229)
+
+### `java-test-runner` for pure Java tests
+Projects with only Java sources (no Scala in the build) now use a dedicated `java-test-runner` module when 
+running `scala-cli test`. The new runner wires up Java-friendly test frameworks (such as JUnit via `junit-interface`) 
+without pulling the Scala test runner or Scala itself onto the test classpath.
+
+```java title=JavaTestRunnerExample.java compile
+//> using test.dep junit:junit:4.13.2
+//> using test.dep com.novocode:junit-interface:0.11
+import org.junit.Test;
+import static org.junit.Assert.assertEquals;
+
+public class JavaTestRunnerExample {
+  @Test
+  public void foo() {
+    assertEquals(4, 2 + 2);
+  }
+}
+```
+
+Added by [@Gedochao](https://github.com/Gedochao) in [#4197](https://github.com/VirtusLab/scala-cli/pull/4197)
+
+### GraalVM native-image packaging: `packaging.graalvmJvmId` and `packaging.graalvmArgs`
+GraalVM native-image packaging JVM id and args are now configurable from using directive level.
+
+```scala compile power
+//> using packaging.packageType graalvm
+//> using packaging.graalvmJvmId graalvm-community:23.0.2
+//> using packaging.graalvmArgs --no-fallback
+```
+Added by [@zrhmn](https://github.com/zrhmn) in [#4223](https://github.com/VirtusLab/scala-cli/pull/4223) & [#4225](https://github.com/VirtusLab/scala-cli/pull/4225)
+
+### Features
+* Add `java-test-runner` module to support running tests with pure Java by [@Gedochao](https://github.com/Gedochao) in [#4197](https://github.com/VirtusLab/scala-cli/pull/4197)
+* Support `-opt-inline:help` by [@Gedochao](https://github.com/Gedochao) in [#4215](https://github.com/VirtusLab/scala-cli/pull/4215)
+* Add directive `packaging.graalvmJvmId` by [@zrhmn](https://github.com/zrhmn) in [#4223](https://github.com/VirtusLab/scala-cli/pull/4223)
+* Add additional `packaging.graalvm*` directives by [@zrhmn](https://github.com/zrhmn) in [#4225](https://github.com/VirtusLab/scala-cli/pull/4225)
+
+### Ammonite REPL deprecated & scheduled for removal
+The Ammonite-backed REPL integration is now **deprecated** and **planned for removal** (in sync with [Ammonite's official communication](https://github.com/com-lihaoyi/Ammonite/commit/388d10819e9cb22c260be2fb1b053088d725ffb1)). 
+Flags such as `--ammonite`, `--ammonite-version`, and `--ammonite-arg` on `scala-cli repl` will go away in a future release. 
+
+It's time to move on to the **default Scala REPL**.
+
+Added by [@Gedochao](https://github.com/Gedochao) in [#4218](https://github.com/VirtusLab/scala-cli/pull/4218)
+
+### Deprecations
+* Add proper deprecation logic for features & deprecate Ammonite for removal by [@Gedochao](https://github.com/Gedochao) in [#4218](https://github.com/VirtusLab/scala-cli/pull/4218)
+
+### Fixes
+* Add `signed-by` support to Debian APT repository by [@Gedochao](https://github.com/Gedochao) in [#4207](https://github.com/VirtusLab/scala-cli/pull/4207)
+* Add missing attributes to ivy2 publishing by [@Gedochao](https://github.com/Gedochao) in [#4203](https://github.com/VirtusLab/scala-cli/pull/4203)
+* Fix misc compiler warnings by [@Gedochao](https://github.com/Gedochao) in [#4220](https://github.com/VirtusLab/scala-cli/pull/4220)
+* Make each packaged native image use its own subdirectory under `nativeImageWorkDir` when cross-packaging by [@Gedochao](https://github.com/Gedochao) in [#4221](https://github.com/VirtusLab/scala-cli/pull/4221)
+* Support formatting `.sbt` inputs by [@Gedochao](https://github.com/Gedochao) in [#4195](https://github.com/VirtusLab/scala-cli/pull/4195)
+
+### Documentation changes
+
+### Build and internal changes
+* Skip CI steps irrelevant to committed changes on PRs by [@Gedochao](https://github.com/Gedochao) in [#4208](https://github.com/VirtusLab/scala-cli/pull/4208)
+* Run tests with JDK 26 by [@Gedochao](https://github.com/Gedochao) in [#4214](https://github.com/VirtusLab/scala-cli/pull/4214)
+* Split `release_notes.md` into a separate test per-release-tag in `docs-tests` by [@Gedochao](https://github.com/Gedochao) in [#4216](https://github.com/VirtusLab/scala-cli/pull/4216)
+
+### Updates
+* Update scala-cli.sh launcher for 1.12.5 by @github-actions[bot] in [#4191](https://github.com/VirtusLab/scala-cli/pull/4191)
+* Bump Scala 3 Next RC to 3.8.3-RC3 by [@Gedochao](https://github.com/Gedochao) in [#4194](https://github.com/VirtusLab/scala-cli/pull/4194)
+* Bump dorny/test-reporter from 2 to 3 in the github-actions group by @dependabot[bot] in [#4198](https://github.com/VirtusLab/scala-cli/pull/4198)
+* Bump picomatch from 2.3.1 to 2.3.2 in /website by @dependabot[bot] in [#4200](https://github.com/VirtusLab/scala-cli/pull/4200)
+* Bump node-forge from 1.3.3 to 1.4.0 in /website by @dependabot[bot] in [#4202](https://github.com/VirtusLab/scala-cli/pull/4202)
+* Bump Scala 3 Next to 3.8.3 by [@Gedochao](https://github.com/Gedochao) in [#4204](https://github.com/VirtusLab/scala-cli/pull/4204)
+* Bump brace-expansion from 1.1.12 to 1.1.13 in /website by @dependabot[bot] in [#4205](https://github.com/VirtusLab/scala-cli/pull/4205)
+* Bump @algolia/client-search from 5.49.2 to 5.50.0 in /website in the npm-dependencies group by @dependabot[bot] in [#4206](https://github.com/VirtusLab/scala-cli/pull/4206)
+* Bump the npm-dependencies group in /website with 2 updates by @dependabot[bot] in [#4211](https://github.com/VirtusLab/scala-cli/pull/4211)
+* Bump lodash from 4.17.23 to 4.18.1 in /website by @dependabot[bot] in [#4212](https://github.com/VirtusLab/scala-cli/pull/4212)
+* Bump Scala 3 Next RC to 3.8.4-RC1 by [@Gedochao](https://github.com/Gedochao) in [#4213](https://github.com/VirtusLab/scala-cli/pull/4213)
+* Bump Mill to 1.1.5 (was 1.1.3) by [@Gedochao](https://github.com/Gedochao) in [#4217](https://github.com/VirtusLab/scala-cli/pull/4217)
+* Bump the npm-dependencies group in /website with 6 updates by @dependabot[bot] in [#4226](https://github.com/VirtusLab/scala-cli/pull/4226)
+* Bump follow-redirects from 1.15.11 to 1.16.0 in /website by @dependabot[bot] in [#4227](https://github.com/VirtusLab/scala-cli/pull/4227)
+* Bump announced Scala 3 Next RC version to 3.8.4-RC1 by [@Gedochao](https://github.com/Gedochao) in [#4219](https://github.com/VirtusLab/scala-cli/pull/4219)
+* Bump `scalafmt` to 3.11.0 (was 3.10.7) by [@Gedochao](https://github.com/Gedochao) in [#4228](https://github.com/VirtusLab/scala-cli/pull/4228)
+* Bump Scala.js to 1.21.0 by [@Gedochao](https://github.com/Gedochao) in [#4229](https://github.com/VirtusLab/scala-cli/pull/4229)
+
+## New Contributors
+* [@zrhmn](https://github.com/zrhmn) made their first contribution in [#4223](https://github.com/VirtusLab/scala-cli/pull/4223)
+
+**Full Changelog**: https://github.com/VirtusLab/scala-cli/compare/v1.12.5...v1.13.0
+
 ## [v1.12.5](https://github.com/VirtusLab/scala-cli/releases/tag/v1.12.5)
 
 ### `--cross` support for `run`, `package` and `doc` sub-commands (experimental ⚡️)
