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.

[Unreleased]

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.