chore: prepare v0.9.0

Signed-off-by: Henry <mail@henrygressmann.de>

Author: explodingcamera

CHANGELOG.md

@@ -5,15 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.9.0] - 2026-05-05
+
+**All Commits**: https://github.com/explodingcamera/tinywasm/compare/v0.8.0...v0.9.0
 
 This release is a major runtime and API rework. It adds support for several newer WebAssembly proposals, introduces the new `Engine` configuration API, rewrites large parts of execution and validation, and changes the internal `twasm` archive format. Benchmarks in the repository currently show roughly 30-90% improvement over 0.8.0 depending on workload and execution mode.
 
 ### Added
 
 - Support for the `custom_page_sizes` proposal ([#22](https://github.com/explodingcamera/tinywasm/pull/22) by [@danielstuart14](https://github.com/danielstuart14))
 - Support for the `tail_call`, `memory64`, `simd`, `relaxed_simd`, `wide_arithmetic`, and `extended_const` proposals ([#37](https://github.com/explodingcamera/tinywasm/pull/37), [#38](https://github.com/explodingcamera/tinywasm/pull/38), [#39](https://github.com/explodingcamera/tinywasm/pull/39))
-- Parse-only support for the `annotations` proposal
 - New `Engine` API (`tinywasm::Engine` and `engine::Config`) for runtime configuration
 - Resumable execution APIs: `call_resumable`, `resume_with_fuel`, `resume_with_time_budget`, and `ExecProgress`
 - Host-function fuel APIs: `FuncContext::charge_fuel` and `FuncContext::remaining_fuel`
@@ -24,19 +25,18 @@ This release is a major runtime and API rework. It adds support for several newe
 
 ### Changed
 
-- `Store::new` now takes an `Engine`; use `Store::default()` for default settings.
+- `Store::new` now takes an `Engine`, use `Store::default()` for default settings.
 - `ModuleInstance::func` now validates exact Wasm signatures at lookup time and fails immediately on mismatches.
-- Stack and call-stack limits now come from `engine::Config`, and memory allocation is lazy until first access.
-- Module-internal by-index inspection APIs are now gated behind `guest-debug`, and runtime `Debug` implementations are gated behind `debug`.
-- `Module` is now re-exported directly from `tinywasm_types`; the `module` submodule was removed.
+- Stack and call-stack limits can now be defined with `engine::Config`
+- Module-internal by-index inspection APIs are now gated behind `guest-debug`
+- `Debug` implementations are now gated behind `debug`.
 - MSRV increased to 1.95 and the crate now uses Rust 2024.
 - `Error`, `Trap`, and `LinkingError` are now `#[non_exhaustive]`.
-- `Trap` variant discriminants changed; do not rely on casting variants to integers.
 - `HostFunction::new`, `HostFunction::func`, and `HostFunction::typed` now require `&mut Store`, and `Imports::link_module` now takes a `ModuleInstance` instead of a raw module instance id.
 - Cargo features were renamed from `tinywasm-parser` to `parser` and from `logging` to `log`.
 - `Error::ParseError` was renamed to `Error::Parser`, and `Error::Twasm` was added.
 - `FuncHandle` and `FuncHandleTyped` were renamed to `Function` and `FunctionTyped`, and module export lookups moved from `exported_*` to `func_untyped`, `func`, and `memory`.
-- The `twasm` archive format is now postcard-based and backwards-incompatible with previous versions (thanks [@dragonnn](https://github.com/dragonnn)).
+- The `twasm` archive format is now based on postcard (backwards-incompatible with previous versions) (thanks [@dragonnn](https://github.com/dragonnn)).
 - The interpreter was refactored around more superinstruction fusion, lower-overhead dispatch, typed-stack locals, jump-oriented lowering, and optional parallel parsing.
 
 ### Removed
@@ -51,7 +51,7 @@ This release is a major runtime and API rework. It adds support for several newe
 ### Fixed
 
 - Fixed archive **no_std** support, which was broken in the previous release, and added tests to ensure it stays working.
-- `ModuleInstance::memory` and `FuncContext::memory` are now actually immutable ([#41](https://github.com/explodingcamera/tinywasm/pull/41)).
+- `ModuleInstance::memory` and `FuncContext::memory` now take a non-mut reference to self ([#41](https://github.com/explodingcamera/tinywasm/pull/41)).
 - Untyped host functions now check return values correctly ([#27](https://github.com/explodingcamera/tinywasm/pull/27)) by [@WhaleKit](https://github.com/WhaleKit).
 - `MemoryRefMut::copy_within(src, dst, len)` now follows its documented argument order.
 - Imported tables created with `Extern::table(ty, init)` now honor the provided init value.
@@ -63,7 +63,7 @@ This release is a major runtime and API rework. It adds support for several newe
 - Rename the cargo features `tinywasm-parser` to `parser` and `logging` to `log`.
 - Rename `FuncHandle` to `Function` and `FuncHandleTyped` to `FunctionTyped`.
 - Rename module export lookups from `exported_*` methods to `func`, `func_untyped`, and `memory`.
-- Regenerate any persisted `twasm` archives; the format is now postcard-based and not backwards compatible with earlier releases.
+- Regenerate any pre-existing `twasm` archives, the format is not backwards compatible with earlier releases.
 
 ## [0.8.0] - 2024-08-29
 

Cargo.lock

@@ -4,10 +4,10 @@ default-members=[".", "crates/tinywasm", "crates/types", "crates/parser"]
 resolver="2"
 
 [workspace.dependencies]
-tinywasm-parser={version="0.9.0-alpha.1", path="crates/parser", default-features=false}
-tinywasm-types={version="0.9.0-alpha.1", path="crates/types", default-features=false}
-tinywasm-cli={version="0.9.0-alpha.1", path="crates/cli", default-features=false}
-tinywasm={version="0.9.0-alpha.1", path="crates/tinywasm", default-features=false}
+tinywasm-parser={version="0.9.0", path="crates/parser", default-features=false}
+tinywasm-types={version="0.9.0", path="crates/types", default-features=false}
+tinywasm-cli={version="0.9.0", path="crates/cli", default-features=false}
+tinywasm={version="0.9.0", path="crates/tinywasm", default-features=false}
 
 criterion={version="0.8", default-features=false, features=["cargo_bench_support", "rayon"]}
 eyre="0.6"
@@ -23,7 +23,7 @@ wast="248"
 wat="1.248"
 
 [workspace.package]
-version="0.9.0-alpha.1"
+version="0.9.0"
 rust-version="1.95"
 edition="2024"
 license="MIT OR Apache-2.0"

Cargo.toml

@@ -1,6 +1,3 @@
-> [!Important]
-> The `next` branch contains a major rework of the runtime and API, which is still in development. The latest released version of tinywasm (0.8.0) is not recommended for use anymore, and the API will change significantly before the next release.
-
 # <b>`tinywasm`</b>
 
 [![docs.rs](https://img.shields.io/docsrs/tinywasm?logo=rust&style=flat-square)](https://docs.rs/tinywasm) [![Crates.io](https://img.shields.io/crates/v/tinywasm.svg?logo=rust&style=flat-square)](https://crates.io/crates/tinywasm) [![Crates.io](https://img.shields.io/crates/l/tinywasm.svg?style=flat-square)](./LICENSE-APACHE)
@@ -15,7 +12,7 @@
 
 ```toml
 [dependencies]
-tinywasm = "0.9.0-alpha.0"
+tinywasm = "0.9"
 ```
 
 ## Usage

README.md

@@ -8,7 +8,7 @@ The crate also exposes reusable helpers such as `tinywasm_cli::wast_runner::Wast
 ## Usage
 
 ```bash
-$ cargo install tinywasm-cli --version 0.9.0-alpha.0 --bin tinywasm
+$ cargo install tinywasm-cli --version 0.9.0 --bin tinywasm
 $ tinywasm --help
 $ tinywasm ./module.wasm
 $ tinywasm run --invoke add ./module.wasm 1 2

crates/cli/README.md

@@ -347,7 +347,7 @@ impl<'store> FuncExecution<'store> {
     /// Resume execution with up to `fuel` units of fuel.
     ///
     /// Fuel is accounted in chunks, so execution may overshoot the requested
-    /// fuel before returning [`ExecProgress::Suspended`].
+    /// fuel before returning [`ExecProgress::Suspended`] (currently the chunk size is 128 instructions between fuel checks, but this may change in the future).
     ///
     /// Returns [`ExecProgress::Suspended`] when fuel is exhausted, or
     /// [`ExecProgress::Completed`] with the final values once the invocation
@@ -381,7 +381,7 @@ impl<'store> FuncExecution<'store> {
     /// Resume execution for at most `time_budget` wall-clock time.
     ///
     /// Time is checked periodically, so execution may overshoot the requested
-    /// time budget before returning [`ExecProgress::Suspended`].
+    /// time budget before returning [`ExecProgress::Suspended`] (currently time is checked every 128 instructions, but this may change in the future).
     ///
     /// Returns [`ExecProgress::Suspended`] when the budget is exhausted, or
     /// [`ExecProgress::Completed`] with the final values once the invocation

crates/tinywasm/src/func.rs

@@ -51,18 +51,17 @@
 //! let wasm = include_bytes!("../../../examples/wasm/add.wasm");
 //! let module = tinywasm::parse_bytes(wasm)?;
 //!
-//! // Create a new store
+//! // # Create a new store
 //! // Stores are used to allocate objects like functions and globals
 //! let mut store = Store::default();
 //!
-//! // Instantiate the module
+//! // # Instantiate the module
 //! // This will allocate the module and its globals into the store
 //! // and execute the module's start function.
-//! // Every ModuleInstance has its own ID space for functions, globals, etc.
 //! let instance = ModuleInstance::instantiate(&mut store, &module, None)?;
 //!
-//! // Get a typed handle to the exported "add" function
-//! // Alternatively, you can use `instance.func` to get an untyped handle
+//! // # Get a typed handle to the exported "add" function
+//! // Alternatively, you can use `instance.func_untyped` to get an untyped handle
 //! // that takes and returns [`WasmValue`]s
 //! let func = instance.func::<(i32, i32), i32>(&mut store, "add")?;
 //! let res = func.call(&mut store, (1, 2))?;

crates/tinywasm/src/lib.rs

@@ -19,7 +19,11 @@ mod vec_memory;
 pub(crate) use instance::MemoryInstance;
 pub use {lazy::LazyLinearMemory, paged::PagedMemory, vec_memory::VecMemory};
 
-/// Backend storage for a linear memory.
+/// Backend storage for a linear memory
+///
+/// This is a low-level trait that abstracts over the actual storage mechanism for linear memory.
+/// This will probably change in the future to allow more efficient implementations.
+/// See [`MemoryBackend`] for a higher-level interface to configuring memory storage.
 pub trait LinearMemory {
     /// Returns the current memory length in bytes.
     fn len(&self) -> usize;