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.4.0 - 2026-10-19

Ichor.Error has a data field: whatever a stage hands through with its error -- most often an action failing with its own domain error, which its caller unwraps. Nil unless something sets it; format/1 ignores it.
The lossless tree, Ichor.Syntax: every byte of an input, as tokens -- trivia and punctuation included, with byte offsets, lines and columns -- under every grammar rule that matched them (Ichor.Syntax.Node, Ichor.Syntax.Token). tree/3 weaves a token stream into a parse's rule records; text/1 is a node's input, and the root's is the whole input, byte for byte; tokens/1 its leaves. Trivia never sits at a node's edge: it belongs to the deepest node with something significant on both sides. The runtime half of ichor's lossless mode.
Ichor.Syntax.Record: how a lossless parser records its rules, inside its ordinary captures, so backtracking and merging handle them as they handle every capture.
Grammar.LR.Lossless: the LR loop for a lossless parse, table-driven so the generated fast parser's state functions are left as they are.
Grammar.GLR.Runtime.run/7: takes the function that builds each reduction's captures; run/6 builds them as before.

An LR or GLR rule repeated three times or more is a flat list. Splicing a repetition's helper into a capture the production already held nested the helper's list as one value: doc := entry+ with three entries gave [a, [b, c]], which Ichor.Actions could not evaluate. The splice now appends the list's elements, as the PEG backends do.
Grammar.Source.placed/2 keeps every field of an error it shows. It rebuilt the error field by field, so a field it did not name was lost; it now fills in only the snippet.

Grammar.Source.trimmed/2: a token stream without the @skip tokens before its first other token and after its last, which every engine and backend now applies before matching the root, so trivia around an input means the same to all of them.
Grammar.Source.position/3 and placed/2: where a position in a token stream is -- its token, or past the last one the end of the input -- and an error that says nowhere placed at the end of the input. No input at all is line 1, column 1.
Every error shows where: Grammar.Source.placed/2 also gives an error with a position and no snippet the line it is on and a caret, so an LR or GLR error renders like a PEG one -- it used to say where and show nothing.
Grammar.LRTable.unexpected_error/3: "unexpected end of input" with the end of the input's line and column. unexpected_error/2 stays for parsers generated before it.
Docs for the main branch are now published to GitHub Pages (.github/workflows/docs.yml) on every push, at joetjen.github.io/ichor_runtime. Released versions continue to be documented on hexdocs.pm; mix.exs's docs() sets a canonical URL pointing there so the two copies don't compete as duplicate content.

Ichor.Actions.eval_all/2 could evaluate sibling captures in the wrong order (and, for an Actions module implementing custom special-form logic that assumes a particular evaluation order, thread context incorrectly) because it relied on a plain Elixir map's own iteration order, which Elixir/Erlang make no guarantee about -- observed to actually differ between Erlang/OTP versions for the exact same code and input.

Breaking: raw capture data (Ichor.Capture.node_t/0's :rule variant, Ichor.Actions.evaluate/5's raw_captures argument, Grammar.LRTable.Captures.build/3's return value, and Grammar.Native.Runtime.Parser.merge_captures/2's accumulator) is now an ordered list of {name, value} pairs (Ichor.Capture.raw_captures/0) instead of a plain map, preserving true first-occurrence RHS/source order end to end -- the fix for the ordering bug above. A grammar's generated Actions module, or any hand-written code that pattern-matches or constructs raw_captures/node_t() values directly (e.g. for macro-expansion via Ichor.Actions.evaluate_node/3), needs updating from %{name: value} to [{name, value}]/[name: value]. The already- evaluated Ichor.Actions.captures/0 map handed to handle_rule/3 callbacks is unchanged (still a plain map, keyed for ergonomic access).
Ichor.Capture gained a position field (defaults to 0) recording a capture's index among its siblings; eval_all/2 now sorts by it before folding, instead of trusting captures' own map order.