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.11.0] - 2026-06-25

Changed

• Raised the toolchain requirement to Sigil 0.17. The package now declares sigil: "^0.17" (was ^0.15). 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-graphics must move to the 0.17 line.
• Bumped the sigil-app dependency to ^0.9.0 (the 0.17-line release of sigil-app), since the whole native stack must derive the same 0.17 sigil-lib.

Requires

• Sigil 0.17+ and sigil-app 0.9.0+.

[0.9.3] - 2026-04-24

Fixed

• 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 -lGL leaked into Windows cross-compile builds and caused the final link to fail against zig's MinGW sysroot (which has no matching GL import library). The procedural form re-evaluates at link time with the target triple. Branches themselves are unchanged (linux: -lGL; darwin: -framework OpenGL -framework Metal -framework MetalKit; windows: '(), since sokol_gfx's GL backend dynamically loads opengl32.dll).

Requires

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

[0.9.0] - 2026-04-18

Note: skips 0.8.0. The v0.8.0 git tag was used on 2026-03-29 for the initial standalone-repo extraction, but package.sgl was never bumped past 0.7.0 then. To avoid rewriting a published tag, this minor release jumps to 0.9.0.

Added

• draw-filled-circle x y radius [segments] — filled circle primitive rendered as a triangle fan via sokol_gp. segments defaults to 16 and is clamped to [3, 128]. For tiny shapes (radius 4–6 px), 12–16 segments is plenty; larger circles benefit from more. Draw cost scales linearly with segments, so use the smallest count that still looks round at the target radius — bullet/particle code on hot paths should pick a fixed low count rather than letting it default. Colour comes from the currently bound set-color.
• set-blend-mode mode and reset-blend-mode — Sigil-level blend mode control. mode is one of 'normal (alpha blend), 'additive, or 'none (no blending). The Sigil wrapper shadows the mode in module state so with-blend-mode can restore the previous value.
• with-blend-mode mode body ... — scoped form that sets mode, runs body, then restores the previous mode. with-additive-blend body ... is the recommended convenience wrapper for particle / bullet halo rendering — it avoids forgotten restores that would leak the blend state into other draws.
• current-blend-mode — accessor for the Sigil-tracked blend mode.

Notes

• Only 'normal, 'additive, and 'none are exposed. sokolgp also supports premultiplied-alpha, modulate, and multiply modes; those can be added when something needs them. Adding a new mode is a one-line change in `blendmodefromvalue (src/c/graphics.c`).
• See examples/circles-blend/ for a side-by-side normal-vs-additive demo. Note: the demo binary build currently fails in the transitive sigil-lib rebuild on a missing minicoro.h include path — this is a pre-existing build-infra bug, not in this package.

[0.5.0] - 2026-02-17

Added

• 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.

Fixed

• 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.

Other

• 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.