Skip to content

Releases

Clorraine v1.1.2

Choose a tag to compare

@blendsdk blendsdk released this 10 Nov 23:34

Clorraine v1.1.2

Clorraine is a compiler for the frozen v1.0 language with the approved v1.1
language surfaces, plus a build/run driver for the host, hosted-amiga,
hosted-amiga-13, and freestanding profiles. v1.1.2 is a patch release; the
language and command-line surface are unchanged.

Highlights

  • Eligible constant arrays become data. A module-level fixed array with a
    2- or 4-byte non-float scalar leaf, a complete guard-free constant list, at
    least 16 elements and 64 bytes, and no volatile now emits one read-only
    data template and one copy instead of one store per element. Byte,
    short/empty lists, const, fill, multi-extent, struct/view/float, and
    freestanding arrays keep the stores; the conditions are recorded in docs/known-limitations.md §13.
    On the lookup benchmark, isolated under the previous flags, net
    instructions fell 13,653 → 9,470 (−30.6%), .text
    117,440 → 92,976 (−20.8%), and emitted C 474,430 → 340,503 bytes (−28.2%).
  • Much smaller release programs. Release programs on Linux host,
    hosted-amiga, and hosted-amiga-13 now use section garbage collection and
    release stripping:
    -O2 -ffunction-sections -fdata-sections -Wl,--gc-sections -s. Measured
    with one compiler and the same sources, the five hosted-amiga scored
    benchmarks are .text 57.1–69.3% smaller and their stripped binaries
    64.2–74.7% smaller; host stripped release binaries fall 20.6–36.5%; the
    hosted-amiga-13 audit set falls 49.1–88.9% in .text; calibration falls
    3,372 → 2,928 instructions on 2.0 and 3,348 → 2,947 on 1.3. The two GCC
    release rows in the frozen compile matrix match the new commands.
  • Release programs are stripped; tools and debug builds are not. The
    clc and clorraine binaries keep their symbols. Debug builds keep
    symbols. Freestanding and non-Linux host program builds keep the -O2 line
    and symbols. Use a debug build when you need to diagnose a release program.
  • No collision with user ffi symbols. The new data template uses a
    collision-free symbol; it cannot shadow a user ffi name. The collision
    existed only in unreleased builds.

Verification

The v1.1.2 release gate runs make check, make asan, make ubsan,
make corpus-amiga, make differential, make bench-shape,
make bench-base COMMIT=v1.1.1, make bench,
make bench-compare REQUIRE="lookup:instructions:20 lookup:text:20",
make bench-flags, make verify, and make vscode-check on the gated
release commit. make verify prints verify: all legs passed.

Against v1.1.1, with the shipped flags applied to both trees, lookup net
instructions are 13,653 → 9,470 (−30.6%), .text 64,328 → 39,904 (−38.0%),
the binary 82,544 → 41,740 (−49.4%), and emitted C 474,430 → 340,503 bytes
(−28.2%). The other four scored benchmarks have identical net instructions,
.text, and emitted C. The flag audit's constructor proof shows the four
remaining libnix constructors still run on both m68k profiles.

Known limitations

  • Programs built by clorraine build --release on Linux host, hosted-amiga,
    or hosted-amiga-13 are stripped; a debug build is the symbol-bearing
    artifact for diagnosis.
  • freestanding and non-Linux host program builds keep the plain -O2 line
    and symbols.
  • The Linux x86_64 tarball contains clc and clorraine, not
    clorraine-lsp; build the server from source with
    cargo build --workspace.
  • --gc-sections removes the unused libnix __amigapath/environ
    constructor objects and their init entries. No current standard-library API
    observes that state; a future API that does will need a targeted keep.
  • The accepted limitations are recorded in docs/known-limitations.md,
    including the remaining volatile-copy shapes, the A500 media requirement,
    the RTG scope, and the v1.1 Box<T> and hook boundaries.

Licence

MIT. Third-party notices, including the Hamurabi port, are in
THIRD_PARTY_NOTICES.md. The binary tarball includes that file and
docs/known-limitations.md, so the licence and limitations links in the
shipped README resolve; the other README links point to the source tree.

No NDK, ROM, Workbench media, or other restrictively licensed third-party file
is redistributed in the source or binary release artifacts.

Clorraine v1.1.1

Choose a tag to compare

@blendsdk blendsdk released this 09 Nov 14:29

Clorraine v1.1.1

Clorraine is a compiler for the frozen v1.0 language with the approved v1.1
language surfaces, plus a build/run driver for the host, hosted-amiga,
hosted-amiga-13, and freestanding profiles. v1.1.1 is a patch release.

Highlights

  • Volatile nested fills emit valid C. A function-body nested fixed-array
    fill into a volatile module array or a volatile struct field now stores
    each element through the volatile lvalue instead of calling memcpy with a
    volatile destination. The fix covers fill rows, explicit prefix rows
    (including impure values evaluated once), and run-time indexed elements.
    Accepted source such as volatile let g: i32[8][9] with g = [; [; 0]];
    now builds under strict C on host, m68k GCC, vbcc, and the freestanding
    profile.
  • Generated-C matrix win. The matrix benchmark's nested zero fill is now
    one memset, reducing streamed guest instructions by 9.6% and .text by
    5.0% on that benchmark. No scored benchmark regresses.

Verification

The v1.1.1 release gate runs make check, make asan, make ubsan,
make corpus-amiga, make differential, make bench-shape,
make bench-compare, make verify, and make vscode-check on the exact
release tree. make verify prints verify: all legs passed.

Known limitations

The accepted limitations are recorded in docs/known-limitations.md, including
the remaining volatile-copy shapes (whole-array copies, volatile sources
through a row temporary, and by-value rvalue members), the A500 media
requirement, the RTG scope, and the v1.1 Box<T> and hook boundaries.

Licence

MIT. Third-party notices, including the Hamurabi port, are in
THIRD_PARTY_NOTICES.md.

No NDK, ROM, Workbench media, or other restrictively licensed third-party file
is redistributed in the source or binary release artifacts.

Clorraine v1.1.0

Choose a tag to compare

@blendsdk blendsdk released this 08 Nov 18:32

Clorraine v1.1.0

Clorraine is a compiler for the frozen v1.0 language with the approved v1.1
language surfaces, plus a build/run driver for the host, hosted-amiga,
hosted-amiga-13, and freestanding profiles.

Highlights

  • A500/Kickstart 1.3 support. The hosted-amiga-13 profile targets a stock
    A500: 68000 code, OCS video, 512 KB chip memory, and the libnix -mcrt=nix13
    runtime. The Amiga SDK registry covers Bundles 0-9, including native video,
    sprites, audio and input, text and layers, DOS and ILBM assets, Intuition,
    Exec and devices, Workbench services, optional services, and Picasso96 RTG.
  • Box<T>. The built-in owning pointer has generated recursive drop glue and
    the boxNew, boxSet, and boxWith standard-library surface. Allocation
    failure uses the existing E1 trap; Box is move-only and non-nullable.
  • Ordinary freedBy deleters. A handle deleter can be an ordinary Clorraine
    function with the existing take T -> void signature, so application types can
    own a recursive resource without writing an ffi block.
  • C-hook trampolines. A capturing lambda can cross a synchronous C hook. The
    compiler emits a per-argument trampoline and a caller-stack environment, so the
    C side still sees a plain function pointer. A stored callback invoked after the
    hook returns faults E11215.
  • Generated-C optimization and benchmarks. The benchmark harness measures
    emitted size, m68k section sizes, host time, and the streamed vamos
    instruction count. On the sieve benchmark the optimized compiler reduces
    streamed guest instructions by 31.6%, .text size by 24.4%, and emitted C size
    by 36.6%.
  • Robustness closeout. Six latent compiler defects and the enum conversion
    path are fixed. The verification suite now includes a host UBSan leg
    (make ubsan) and a deterministic differential fuzzer with committed seeds,
    seed goldens, and a host/m68k/sanitizer matrix.

Verification

The v1.1.0 release gate runs make check, make asan, make ubsan,
make corpus-amiga, make differential, make bench-shape, and make verify
on the exact release tree. make verify prints verify: all legs passed.

The gate covers the specification check, the Rust workspace suites, the
sanitizer legs, the portable corpus on host and hosted-amiga, the FS-UAE
acceptance programs, the runtime-fault programs, and the cross-toolchain shape
fixture.

Known limitations

The accepted v1.0 and v1.1 limitations are recorded in
docs/known-limitations.md, including the A500 media requirement, the RTG
scope, the v1.1 Box<T> and hook boundaries, and the compiler edge cases left
outside the robustness closeout.

Licence

MIT. Third-party notices, including the Hamurabi port, are in
THIRD_PARTY_NOTICES.md.

No NDK, ROM, Workbench media, or other restrictively licensed third-party file
is redistributed in the source or binary release artifacts.

Clorraine v1.0.0

Choose a tag to compare

@blendsdk blendsdk released this 04 Nov 07:19

Clorraine v1.0.0

Clorraine is a compiler for the frozen v1.0 language and a build/run driver for the
host, hosted-amiga, and freestanding profiles.

Highlights

  • clc compiles .clo sources to one valid C99 translation unit.
  • clorraine builds and runs programs through the profile toolchain, including the
    FS-UAE handoff for hosted-amiga.
  • The embedded standard library covers memory, text, formatting, console/file I/O, and the
    Amiga modules std.amiga.{custom,dos,exec,graphics,interrupt,intuition}.
  • Developer tooling: --explain CODE on both binaries, --diagnostics=json NDJSON on stderr,
    and the canonical editors/clorraine.tmLanguage.json grammar.
  • The specification chapters 00-17 and appendices A/B are stable (v1.0).

Verification

make check, make verify (differential, FS-UAE corpus, six runtime faults), make asan
(24 suites), and make differential (3/3) pass for this release.

Known limitations

See docs/known-limitations.md for the three accepted v1.0 limitations. The
std.amiga.exec message lifetime contract and the pre-existing compiler residuals are recorded
in the production-readiness findings ledger.

Licence

MIT. Third-party notices, including the Hamurabi port, are in THIRD_PARTY_NOTICES.md.
No NDK, ROM, or other restrictively licensed third-party file is redistributed.