nx_diagram.nx

nx_diagram.nx -- substrate-native diagram primitive. First-class diagrams in NishiLang. Data model + 4 output emitters from a single in-memory representation. Why this exists (per user 2026-05-13): "can we add mermaid like capabilities to nishi lang" The substrate should NOT depend on external renderers (Mermaid.live, Graphviz CLI, etc.). Per Wolfram-IP-free + sovereign-substrate doctrine: ship our own. Mermaid stays as a COMPATIBILITY output for tools that already render it; ASCII is the sovereign default (terminal-renderable, zero external dep). API: nx_diagram_new(max_nodes, max_edges) -> *Diagram nx_diagram_add_node(d, label, summary) -> i64 (returns node index) nx_diagram_add_edge(d, from_idx, to_idx, label) nx_diagram_emit_mermaid(d) -> writes graph TD to stdout nx_diagram_emit_ascii(d) -> terminal-friendly layered render nx_diagram_emit_dot(d) -> Graphviz DOT (interop) nx_diagram_emit_json(d) -> machine-readable JSONL Plain-English: a substrate primitive that lets any NishiLang program build a diagram in memory then export it in any of 4 formats. The ASCII format runs in any terminal, so the substrate can VISUALIZE itself without needing a graphical tool. genealogy_id: mermaid_2015_js_lib + graphviz_dot_1991 + ascii_art + plain_text_diagram_lineage lineage_id: in_memory_diagram + multi_format_emit axioms: NX_AX_REL_TRANSITIVITY (edges define a relation; diagram emit preserves source structure)