nx_wiki_toc.nx

nx_wiki_toc.nx -- wiki R4: auto table-of-contents + heading anchor ids. COMPOSES: nx_syscalls (sys_mmap scratch). No markdown library needed -- it reads ATX heading LINES directly from the markdown source (the same #/##/### the renderer turns into <hN>), so the TOC and the rendered anchors share one definition of "what a heading is". TWO halves: 1. nx_wiki_toc_build(src,n) -> <nav class="nx-toc"><ol>...<li><a href="#<anchor>">heading text</a></li>...</ol></nav> (one <li> per ATX heading, in document order). Empty <nav> elided -> "" when a doc has no headings. 2. nx_wiki_toc_inject_ids(html,n) -> a COPY of rendered HTML with id="<anchor>" added to every <hN ...> open tag that lacks one. The anchor for an <hN> is derived from that tag's INNER TEXT, computed by the SAME nx_wiki_toc_slugify the TOC links use -> the "#section-a" links in (1) jump to the id="section-a" stamped here. ANCHOR RULE: lowercase the heading text; every run of non-[a-z0-9] bytes -> a single '-'; trim leading/trailing '-'. Deterministic + collision-tolerant (duplicate headings get duplicate ids -- browsers jump to the first, which is the documented, acceptable behavior; a -2/-3 disambiguator is a follow-on). Hygiene: M1 out-params; M3 capped loops; M5 bounded indexing; M6 real semantics; M7 named constants; M8 propagated verdicts. Status: V1 (wiki R4). 2026-06-15. license_tier: ORIGINAL