[jackhogan]

Stacked on #78. A definition list inside a ::: {.references} container is a bibliography, and references to its terms are citations with their own rendering rules. The parser is unchanged: the references class on the container is the marker, and it joins math and footnotes as a reserved class word.

What changes

• cite joins block, caption and text as a target kind. An id-bearing dt inside div.references registers as cite (doc_anchors and the HTML exporter both see the container).
• [@dai2015] renders parenthetically, "(Dai and Le, 2015)"; prefix text goes inside, "(see Dai and Le, 2015)". [@dai2015]{ref=text} renders textually, "Dai and Le (2015)", splitting the label at its last ", " (a label with no comma renders as written). [-@dai2015] renders the label alone, for an author who writes the parentheses. A group [@a; @b] shares one pair of parentheses with "; " between entries. page, leaf and rel are errors on a citation.
• cite='numeric' on mdhtml2html, md2gfm and mdhtml2typst numbers the entries in list order and renders "[1]", "[1, 3]", "Dai and Le [1]", relabelling each term with its number. Only terms with ids take a number, in every exporter.
• The HTML exporter wraps every citation in <span class="cite"> with its links inside, so a viewer can attach a hover card from the entry each link targets. Typst escapes the numeric brackets; GFM bakes plain text.
• Resolver gains set_cite_style, set_citenum, is_cite, cite_wrap and cite_sep, exposed to Python.
• docs/DIALECT.md gains a "Citations" subsection under captions and cross-references; the README's reference sections mention the construct and the cite option.

Tests: test_citations in tests/test_export.py covers the three forms, groups, prefix text, a label with no comma, the numeric style in all three exporters, and the error cases.

🤖 Generated with Claude Code