universal_wasm_loader 0.3.0
universal_wasm_loader: ^0.3.0 copied to clipboard
Web-first Dart loader for WebAssembly "DLL" modules. Auto-detects the companion .wit, applies the Canonical ABI (wasmtime profile), and returns a typed handle.
Changelog #
0.3.0 #
Breaking (SPEC 4.0.0): failures are loud. See the README's "What fails, and how" table and the Breaking Changes row.
- Only an absent
.wit(HTTP 404 / 410, or a path not ending in.wasm) loads raw exports. Any other.witfailure fails the load before the.wasmis fetched. The.witURL now drops the.wasmURL's query and fragment. parseWitis strict: a malformed statement or parameter, an unsupported type (u32was read ass32), a duplicate name or text outside the oneworldthrows aFormatException.- Every WIT import needs a host callback, checked at load. A callback's return value must match the
import's WIT result, and a
Futureis refused. An import returningstringis refused at load. - A WIT export the module does not export fails the load.
- Typed calls check the argument count and each argument's kind; nothing is coerced.
s64now passes a real 64-bit integer (intorBigInt) and returns aBigInt; it used to fail inside the engine. - New
options: LoadOptions(timeout:, cancel:)onwasmImport,createSingletonandInstancePool: a 30 s default limit on each fetch (TimeoutException), and aLoadCancelToken.
0.2.1 #
- Test fixtures are now byte-identical copies of the shared reference set (stamped in
test/fixtures/fixtures.json);strings_50.wasmandwasi_io_50.wasmupdated,init_check.watadded. - README: corrected the Runtime section, which said SPEC §10 was not implemented; added a
### ⚠️ Breaking Changestable (recording the 0.2.0_initializebehaviour change). - Releases are now checked by a compatibility gate (repository tooling, not part of the package): the public API is compared with the previous release, and its tests must still pass.
- No library code changes.
0.2.0 #
- SPEC §10 (producer model) loader capabilities:
- A minimal WASI Preview 1 shim (
wasi_snapshot_preview1) is always attached to the imports, so library modules that do I/O load in the browser.fd_writegoes toconsole.log/console.error;proc_exit,random_get,clock_time_get, environ/args and basicfd_*are provided. - A reactor module's exported
_initializeis now called once, automatically, right after instantiation (with or without a.wit). Do not call it again yourself.
- A minimal WASI Preview 1 shim (
- No public API changes.
0.1.0 #
- Initial release. Web-first Dart port of the Universal WASM Loader, implementing
cross-language
SPEC.mdv3.0.0 over the browserWebAssemblyAPI viadart:js_interop. wasmImport,createSingleton,InstancePool; WIT auto-detection; the@Nversion pin; full Canonical ABI (numerics pass-through,bool1/0 ↔ true/false, string params viacabi_realloc, callee-allocated string returns +cabi_post_<name>release).