exclosured

# Changelog

All notable changes to this project will be documented in this file.

This project publishes to three registries. Version bumps are kept in sync.

| Registry | Package |
|---|---|
| [hex.pm](https://hex.pm/packages/exclosured) | `exclosured` (Elixir library) |
| [npmjs.com](https://www.npmjs.com/package/exclosured) | `exclosured` (JS LiveView hook) |
| [crates.io](https://crates.io/crates/exclosured_guest) | `exclosured_guest` (Rust guest crate) |

## 0.1.0

### hex.pm

Initial release of the Exclosured library.

- Mix compiler: `mix compile` builds Rust to `.wasm` via cargo + wasm-bindgen
- Incremental compilation with manifest-based staleness detection
- `Exclosured.LiveView`: `call/5`, `push_state/3`, `stream_call/5` with `on_chunk`/`on_done`
- `Exclosured.LiveView.sandbox/1`: HEEx component with `sync` attribute for declarative state binding
- `Exclosured.LiveView.sync/2`: shorthand helper for building sync maps from assigns
- Server fallback: `call/5` accepts `fallback:` option, runs Elixir function when WASM not loaded
- `Exclosured.Inline`: `defwasm` macro for inline Rust functions with `deps:` for external crates
- `Exclosured.Events`: generate Elixir structs from `/// exclosured:event` annotated Rust structs
- `Exclosured.Telemetry`: `:telemetry` events for compilation and runtime operations
- `Exclosured.Watcher`: dev file watcher for auto-recompilation
- `Exclosured.Protocol`: binary encoding for high-frequency state sync
- `mix exclosured.init`: scaffolding task for new WASM modules
- `~S` sigil support in `defwasm` for Rust code with escaped quotes

## 0.1.1

### npm (exclosured@0.1.1)

- Fixed: `const fn` renamed to `const wasmFn` (reserved word in JS strict mode)
- Fixed: `destroyed()` now calls `this.wasmBindgen.destroyed?.()` for WASM cleanup
- Added: `WasmBuffer` class in `exclosured/loader` with automatic memory cleanup via `FinalizationRegistry`
- Added: `loadAsset()` returns `WasmBuffer` instead of raw `{ ptr, len }` (no more manual `dealloc` needed)
- Added: documentation comment about shared `window.__exclosured` limitation on multi-module pages
- Changed: `loader.mjs` exports `WasmBuffer` alongside `ExclosuredLoader`

## 0.1.0

### npm (exclosured@0.1.0)

Initial release of the JavaScript package.

- `ExclosuredHook`: Phoenix LiveView hook for loading and communicating with WASM modules
- Declarative state sync via `data-wasm-sync` attribute and `updated()` callback
- `wasm:call`, `wasm:state`, `wasm:emit`, `wasm:result`, `wasm:error`, `wasm:ready` event protocol
- Inter-module broadcast via `window.__exclosured_bus` EventTarget
- Canvas auto-creation for interactive WASM modules
- `ExclosuredLoader`: standalone WASM loader (no LiveView required)
- `loadAsset()`: load binary assets into WASM memory

### crates.io (exclosured_guest@0.1.0)

Initial release of the Rust guest crate.

- `emit(event, payload)`: send events to Phoenix LiveView via wasm-bindgen JS imports
- `broadcast(channel, data)`: send messages to other WASM modules on the same page
- `alloc(size)` / `dealloc(ptr, size)`: memory management for JS interop
- wasm-bindgen `js_namespace = __exclosured` for emit/broadcast binding

### crates.io (exclosured_guest@0.1.1)

- Fixed: zero-size `alloc` now returns an aligned dangling pointer instead of undefined behavior
- Fixed: `dealloc` skips freeing for size 0
- Added: `repository`, `homepage`, `keywords`, `categories`, `readme` metadata to Cargo.toml
- Added: README.md with usage examples