Changelog

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

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.12.0] - 2026-07-10

(sigil audio sink), a portable streaming audio-sink facade that selects its backend with cond-expand. The native arm re-exports the sokol SPSC ring from (sigil audio); the WebAssembly arm imports (sigil browser audio-sink) from the sigil-wasm-audio bridge package, so the same source compiles and runs on both native and WebAssembly. The facade adds WebAudio-shaped context lifecycle ops (audio-context-open, audio-context-resume, audio-context-sample-rate, audio-context-state) and a portable make-float-buffer re-export. On native the context ops are thin shims over sokol's single always-running device.

WebAssembly builds that depend on sigil-audio for the (sigil audio sink) facade no longer fail to compile. The native audio C (sokol_audio, vendored libogg/libvorbis) has no wasm32-wasi backend, so its C-compilation steps are now gated out of wasm/wasi targets with skip-on-wasm; on wasm the facade delegates to the WebAudio bridge, so none of that C is needed. Native builds are byte-identical (the guard is false).

Raised the toolchain requirement to Sigil 0.17. The package now declares sigil: "^0.17" and pins sigil-stdlib to ^0.17. Sigil 0.17 makes the package-level sigil: field mandatory and derives the native codegen runtime (sigil-lib) from it, so building under the 0.17 compiler requires this bump. This is a minor release because consumers caret-pinning sigil-audio must move to the 0.17 line.

link-flags: now uses (lambda (ctx) (case (target-os ctx) ...)) instead of a host-based (case (host-os) ...) expression. The host-based form evaluated at package-load time on the host, so Linux link flags leaked into Windows cross-compile builds; a sigil build --config windows-amd64 pass from a Linux host would inject -lasound into the final link and fail against zig's MinGW sysroot. The procedural form re-evaluates at link time with the target triple, so cross-compile configs now pick the right branch. The OS branches themselves are unchanged (linux: -lasound; darwin: -framework AudioToolbox; windows: -lole32 -lwinmm -lksuser).

sigil-build 0.14.0+ (for the target-os / target-arch helpers and the procedural-link-flags dispatch in collect-native-link-flags).

Vendored libogg 1.3.6 + libvorbis 1.3.7 under vendor/ogg/ and vendor/vorbis/. OGG Vorbis encoding/decoding is now self-contained: no external -lvorbis / -lvorbisenc / -logg link dependency, no system libogg-dev / libvorbis-dev packages needed on Linux or macOS.
Windows cross-compile target (sigil build --config windows-amd64) — uses zig with x86_64-windows-gnu. WASAPI backend links against -lole32 -lwinmm -lksuser. Verified by building libsigil-audio.a + test-linking a PE32+ Windows .exe.
Per-tree vendor/ogg/README.md and vendor/vorbis/README.md recording upstream version + tarball SHA256 + upgrade procedure.

package.sgl library link-flags: dropped -lvorbis -lvorbisenc -logg from every host branch; added a (windows) branch with WASAPI link flags.
manifest.scm: removed libvorbis / libogg system deps — vendored sources cover them.
Binary size grows by ~1 MB (libvorbis codebook tables dominate). Acceptable trade-off for the install-time ergonomics + cross- compile capability.

Streaming audio sink: open-audio-stream, push-audio-samples, audio-stream-room, audio-stream-depth, audio-stream-capacity, audio-stream-channels, audio-stream-underruns, audio-stream-closed?, close-audio-stream!, set-audio-stream-volume!, audio-stream?. Lockless SPSC ring lets Sigil callers feed interleaved float32 PCM from any thread to sokol_audio's audio thread; coexists additively with play-sound / play-music. See folio topics/sigil-audio-streaming-sink-architecture.

Added test harness generation and build support for packages with native dependencies. Improved native package handling, added c-flags field to library struct. Fixed stdlib inclusion in bundles with custom native runtimes, directory structure preservation in compile-c-sources, and absolute sigil-lib include path resolution.
Added test coverage.
Added test coverage.
Added test coverage for TCP/UDP/address operations and crypto primitives.
Added test coverage for TCP/UDP/address operations and crypto primitives.
Added test coverage.
Added test coverage.
Added test coverage.
Added test coverage.
Added test coverage.
Added test coverage.
Added opcode-level profiling with --profile flag. Added test harness support for packages with native dependencies. Build safety: warn when replacing the running binary, error on 0-byte output or missing target package. Fixed module cache clearing before running entry points, handling of missing sigil-lib in user-created packages.
Added test coverage.
Added test coverage.

Fixed random seed initialization crash caused by flonum-to-bignum promotion in modulo. Fixed status command crash when displaying projected versions for packages without changes.
Fixed SSE and remove-after initialization on child elements. Added comprehensive test coverage for routing, middleware, cookies, security, SSE, and response helpers.
Fixed assq-ref to return values instead of aliasing assq, added assv-ref. Added async-aware process pipe I/O. Fixed REPL string-length error after exception recovery. Added comprehensive error path tests and GC stress tests for dicts.
Fixed Scheme module compilation in build task.
Fixed re-import of (sigil core) before calling entry main in bundled applications.

New packages split from sigil-studio. Font and image modules moved to (sigil graphics *) namespace.
GC correctness: added write barriers to all heap mutation sites, enabled GC during compilation with full compiler rooting, and added GC stress testing infrastructure. Completed HAMT dict implementation (printing, equality, collision handling, structural removal). Added arbitrary-precision bignum type with full reader/VM/native/serializer integration. Performance: inline caching for module binding lookups, peephole optimizer with 8 superinstruction patterns. Improved error handling: replaced exit(1) with recoverable errors, fixed error propagation in vmerrorabort and OPABORTTO_PROMPT. Added definition location tracking in stack traces. Implemented VFS/bundle directory listing. Fixed number->string precision for exact IEEE 754 roundtrip. Removed dead opcodes.
Configured custom mbedTLS for TLS 1.2 only. Added test coverage for connection predicates, failure paths, and error handling.
New packages split from sigil-studio. Font and image modules moved to (sigil graphics *) namespace.
New package split from sigil-studio. Added playlist support with wait-music-end and play-playlist. Fixed native exports in Scheme module.