release: 1.0.0-beta1

[Sam Gammon (sgammon)]

Summary

Final cleanup for 1.0.0-beta1 release; includes many PRs, features from alpha1 through alpha14. Dependencies are updated and frozen to their latest possible versions without breakage. Future betas may still break API compat as we get our CLI entrypoint story together, but the whole thing, generally, speaking, is pretty close to stable.

Upstream dependencies need to stabilize as well before our final stable release. This would include Kotlin, GraalVM, Java, and a few key other dependencies.

This PR is not intended to close the Release R15 milestone; instead, that milestone will become R16, and will continue to advance until this beta series concludes (the milestone will change to Beta instead of Beta 1, to communicate a final beta goal).

PR Tree

• docs: beta1 release docs#12
• chore: beta1 release runtime#381
• chore: updates for beta1 setup-elide#124

API Conformance

• Node API Conformance #1262
  • Node API: process #820
  • Node API: zlib #1200
  • Node API: child_process #1096
  • Node API: events #879
  • Node API: url #854
  • Node API: os #822
  • Node API: stream #853
  • Node API: fs #825 (Partial)
  • Node API: fs/promises #855 (Partial)
• WinterTC: Minimum Common API #1260
  • JS API: Abort Controller/Abort Signal #1217
  • JS API: URL #1219
  • JS API: Fetch #1218
  • JS API: Web Streams #1216
  • JS API: queueMicrotask support #1265
  • JS API: structuredClone support #1267
  • JS API: setInterval / clearInterval #1269
  • JS API: setInterval / clearInterval #1269
  • JS API: WebAssembly #1272
  • JS API: Navigator #1275

Release PR Tree

Note

Every major PR from the alpha-* release series.

• feat: light rewrite / spring cleaning #1252
• feat: add support for queueMicrotask #1266
• fix(cli): native image boot to repl #1271
• test: initial wintertc common minimum api tests #1263
• feat(graalvm): support webassembly api in js #1273
• feat(graalvm): add support for navigator.userAgent #1277
• feat(graalvm): add structuredClone support #1280
• feat: add polyfilled fetch support #1229
• feat: synthetic modules #1227
• feat: precompilers (pt1) #1215
• fix: expose CustomEvent constructor #1213
• feat: intrinsic abort types #1212
• feat(node): implement zlib #1199
• feat(node): add child_process module #1097
• feat: entrypoint work pt 4 #1084
• feat(node): custom Buffer implementation #1072
• feat(fs): support for copyFile methods #1066
• Feature: Entrypoint V2, Part 3 #1055
• feat(js): native support for js encoding api #1044
• fix: package of fixes for main Elide object #1040
• feat: Node.js buffer built-in module implementation #1026
• feat: static jni support for jansi #1022
• fix(sqlite): static initialization #1017
• fix(typescript): fixup ts module loader #1010
• feat: jna over static jni #1007
• fix(sqlite): static jni for sqlite #1006
• fix: cast err with python + embedded vfs #995
• fix: process global in js #993
• fix: jna os info on linux/macos #991
• fix(runtime): jna on non-macOS operating systems #985
• fix: elide server response headers #981
• Entrypoint V2 #977
• fix: use context VFS instance in Node FS intrinsic #969
• fix: typescript support #968
• Feature: SQLite Support #956
• Feature: Native Transport (Static JNI) #950
• feat(base): implement sorted collections #869
• feat(node): node api support for alpha9 #849
• feat: initial work on embedded dispatch #838
• fix: use custom npm module path for js tests. #796

Release Punchlist

• Dependency Updates
  • oro
  • uv, ruff
  • oxc
  • Maven deps
  • Cargo deps
  • NPM deps
  • GHA: Updates
  • GHA: Audit for hardening
  • GHA: Seal configurations
• QA
  • Passes JVM suite
  • Passes native suite
  • All outstanding known issues
• Python Interop
  • Python-side annotations for exporting methods
  • Import from JS/TS
• Docs
  • Update and attach API docs
  • Updates to narrative docs
  • Updates to conformance docs
  • Updates to README
  • Updates to Codespace guide
  • Final docs review
• Ancillary
  • Update setup-elide GitHub Action
  • Adopt setup-elide for Elide's own build
  • GitHub download redirects from shell installer
• Maven Central
  • Release to Elide Maven
  • Release to Central
• Distribution
  • Deploy docs + site updates
  • Issue v2 release of setup-elide
  • Build + test final beta dists for macOS and Linux
  • Publish as non-default and switch in CI
  • Publish as default
  • Sigstore and provenance
  • Cut GitHub release, upload artifacts
  • Author release notes
  • Publish GitHub release
  • Updates to org readme
• Containers
  • Update + publish base images
  • Update + publish codespace image

Known Issues

• Reflection Changes
  • sqlite fixes
  • fetch fixes
• Reflection issues with some Node built-ins
• Native macOS Build
• Update PGO
• Unexpected values provided for JSToObjectNodeGen #1290
• macOS minimum target
• HTTP intrinsic is missing #1297
• Startup latency spike
  • Re-PGO with Python
  • Smoother implementation of Python env
  • Smoother Python elide built-in
• Relative imports not in cwd (or require cwd) broke after Synthetic Modules #1221
• TypeScript fix for relative imports
• TypeScript fix for relative mjs imports
• Avoid eager init of built-ins that require parsing (structuredClone)
• Ugly basic errors (FILE_NOT_FOUND, FILE_TYPE_MISMATCH)
• Missing HTTP intrinsic reflection configs

Changelog

feat: transition to warmed preamble scripts
feat: release-quality python
feat: smarter gha downloads
feat: python interop test + sugar (python-side)
test: ignore kotlin precompiler testing
fix: disable embedded jvm until ready for release
fix: make abi validation optional
fix: warning fixes to build in strict mode
fix: restore python vfs support
fix: package of native macos fixes
fix: static args availability in cli
fix: reflection metadata for pkl
fix: reflection metadata for jna
fix: synethetic module default exports
chore: build kotlin in strict mode
chore: drop checkstyle/pmd until in use
chore: bump rust dependencies
chore: bump `uv` → latest
chore: bump `ruff` → latest
chore: bump `oxc` → latest
chore: bump `java` minimum → jvm21
chore: upgrade kotlin → `2.1.20-RC3`
chore: adopt kdl v2 format for package lock
chore: upgrade micronaut catalog → `4.5.0`
chore: upgrade micronaut lib → `4.8.6`
chore: upgrade disruptor → `4.0.0`
chore: upgrade pnpm → `10.6.2`
chore: update detekt baselines
chore: upgrade oro kdl lockfile
chore: update gradle lockfiles
chore: update verification metadata
chore: update `runtime` facades
chore: fmt

[codecov]

Codecov Report

Attention: Patch coverage is 53.33333% with 273 lines in your changes missing coverage. Please review.

Project coverage is 52.55%. Comparing base (d54a8fe) to head (e7b5a3f).
Report is 32 commits behind head on main.

Files with missing lines	Patch %	Lines
...untime/lang/javascript/ElideInteropModuleLoader.kt	13.93%	104 Missing and 1 partial ⚠️
...ain/kotlin/elide/runtime/node/fs/NodeFilesystem.kt	68.00%	43 Missing and 13 partials ⚠️
...kotlin/elide/tool/cli/cmd/repl/ToolShellCommand.kt	47.88%	32 Missing and 5 partials ⚠️
...e/lang/typescript/TypeScriptPrecompiledLoader.java	57.14%	12 Missing and 6 partials ⚠️
...ime/core/internals/graalvm/GraalVMConfiguration.kt	63.33%	7 Missing and 4 partials ⚠️
...ckages/cli/src/main/kotlin/elide/tool/cli/Elide.kt	30.76%	5 Missing and 4 partials ⚠️
...e/gvm/internals/intrinsics/js/abort/AbortSignal.kt	36.36%	6 Missing and 1 partial ⚠️
...vm/src/main/kotlin/elide/runtime/gvm/js/JsError.kt	37.50%	2 Missing and 3 partials ⚠️
...in/elide/runtime/plugins/AbstractLanguagePlugin.kt	50.00%	1 Missing and 3 partials ⚠️
...in/java/elide/runtime/gvm/JNIHeaderDirectives.java	0.00%	3 Missing ⚠️
... and 13 more

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1294      +/-   ##
==========================================
+ Coverage   48.42%   52.55%   +4.13%     
==========================================
  Files         501      459      -42     
  Lines       18379    17966     -413     
  Branches     3269     3348      +79     
==========================================
+ Hits         8900     9442     +542     
+ Misses       8464     7461    -1003     
- Partials     1015     1063      +48     

Flag	Coverage Δ
jvm	52.55% <53.33%> (+4.13%)	⬆️
lib	52.55% <53.33%> (+4.13%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
.../main/kotlin/elide/tool/cli/AbstractToolCommand.kt	63.88% <ø> (ø)
...ages/cli/src/main/kotlin/elide/tool/cli/Statics.kt	37.93% <100.00%> (ø)
...kotlin/elide/tool/cli/cmd/repl/LanguageSelector.kt	60.00% <ø> (-4.45%)	⬇️
...ain/kotlin/elide/tool/cli/err/AbstractToolError.kt	0.00% <ø> (ø)
...src/main/kotlin/elide/runtime/core/EnginePlugin.kt	100.00% <ø> (+100.00%)	⬆️
.../elide/runtime/core/PolyglotEngineConfiguration.kt	100.00% <ø> (+100.00%)	⬆️
...ide/runtime/lang/javascript/ElideJsModuleRouter.kt	70.58% <100.00%> (+70.58%)	⬆️
.../kotlin/elide/runtime/gvm/kotlin/KotlinLanguage.kt	0.00% <ø> (ø)
...tlin/elide/runtime/gvm/kotlin/KotlinPrecompiler.kt	4.70% <ø> (+4.70%)	⬆️
...src/main/kotlin/elide/runtime/plugins/llvm/LLVM.kt	0.00% <ø> (ø)
... and 37 more

... and 89 files with indirect coverage changes

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d54a8fe...e7b5a3f. Read the comment docs.

🚀 New features to boost your workflow:

• ❄ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[socket-security]

New, updated, and removed dependencies detected. Learn more about Socket for GitHub ↗︎

Package	New capabilities	Transitives	Size	Publisher
npm/@cloudflare/workers-types@4.20250313.0	None	0	0 B
npm/@commitlint/cli@19.7.1 ➜ 19.8.0	Transitive: environment, eval, filesystem, shell, unsafe	+92	4.21 MB	bycedric, escapedcat, marionebl, ...1 more
npm/@commitlint/config-conventional@19.7.1 ➜ 19.8.0	Transitive: filesystem	+8	133 kB	escapedcat
npm/@types/node@22.13.8 ➜ 22.13.10	None	+1	2.4 MB	types
npm/bun-types@1.2.5	None	+1	1.52 MB	colinhacks, jarred, robobun
npm/bun@1.2.5	environment, filesystem, network, shell	+11	941 MB	robobun
npm/commitlint@19.7.1 ➜ 19.8.0	None	+3	81.8 kB	escapedcat
npm/esbuild@0.25.0 ➜ 0.25.1	None	+25	257 MB	evanw
npm/eslint@9.21.0 ➜ 9.22.0	Transitive: eval, filesystem, shell, unsafe	+89	6.81 MB
npm/express@4.21.2 ➜ 5.0.0-beta.3	Transitive: eval, unsafe	+70	2.23 MB	wesleytodd
npm/lint-staged@15.4.3 ➜ 15.5.0	Transitive: environment, filesystem, shell	+54	2.14 MB
npm/wrangler@4.0.0	Transitive: environment, eval, filesystem, network, shell, unsafe	+93	996 MB	wrangler-publisher
pypi/ruff@0.11.0	None	0	0 B

View full report↗︎