Renderer 0.2.0: adopt legaldown-validator 0.3.0, templates with answers, PyPI publishing

[dvejsada]

Summary

This PR moves the renderer onto legaldown-validator 0.3.0 and its new public API. It also adds rendering of templates with answers, and prepares the renderer's first PyPI release, 0.2.0.

It builds on these validator changes, all released in 0.3.0:

• #49, #58, #60, #77: a model that follows CommonMark and GFM.
• #71, #72, #81: list items and quotes that hold blocks, including headings.
• #80: the validator's raw-html Warning.
• #50: unique section numbers.
• #55: assembly.
• #85: diagnostics carry their line.
• #87: a paragraph keeps its lines.
• #90: the public API — placed markers, the template decision, and helpers.

Changes

Validator 0.3.0

• The dependency is pinned to legaldown-validator>=0.3.0,<0.4.
• Placed markers and the template decision come from the ValidationResult (placed_markers, is_template). The validator gives each marker's field, offset and list item. The builder no longer searches for markers or numbers list items itself.
• Imports now come from the public API: the lexer, list helpers, is_drafting_note, conditions and value checks. validator_bridge.py keeps only quote_content, the fence helpers and the answers-file reader (validator#93).
• Line breaks: a hard break renders as <br>, and as a new line in text. A soft break is a newline in HTML and a space in text.
• Line numbers: the CLI prints each validator diagnostic's line, as file:line:.

Block model

• HTML blocks render nothing. Inline tags are dropped and their text is kept. raw-html is reported by the validator.
• Tables keep their alignment.
• Code blocks follow the validator's CommonMark reading of indented and fenced code.
• Lists are built from the model's items, and each item holds blocks.
  • An item nested under 2.1(b) reads "2.1(b)(i)".
  • Empty items keep their place.
  • Sibling lists in one item continue their numbering.
• Quotes hold the blocks the validator reads in them. A drafting note is is_drafting_note's decision.
• Headings in items and quotes are not sections (§4.1). They render as a bold line.
• Nesting limit: the renderer refuses (DocumentError) a document whose lists, quotes and inline formatting together nest past 100 levels.
• Ambiguous references: a {{ref:}} whose designation another numbered unit also reads as gets a render-ref-ambiguous hint.

Section numbers

• Numbers come from ValidationResult.sections.

Templates with answers (§15.8)

• render(..., answers={...}) and --answers answers.yaml assemble the template with legaldown.assemble (§15.7), then render the assembled document.
• It is refused (RenderRefused) when the template or the answers have Errors, or when the template needs other files (§17.6).

Release 0.2.0 and PyPI

• The version is 0.2.0.

• .github/workflows/publish.yml works as legaldown-validator publishes. A published GitHub Release triggers it:

  • build the sdist and wheel;
  • twine check --strict;
  • verify the tag matches __version__;
  • smoke-test the wheel with a real render;
  • upload to PyPI with Trusted Publishing.

  A manual run uploads to TestPyPI instead.

• .github/PUBLISHING.md covers the one-time PyPI and GitHub setup.

• The README now says pip install legaldown-render.

Docs

• CONFORMANCE.md, the architecture doc, the roadmap and ADR 0007 follow these changes.

Testing

• Against validator 0.3.0 from PyPI: 387 passed, and ruff check . is clean. The count dropped from 561 because the tests that spied on is_template are gone: the renderer now reads ValidationResult.is_template itself.
• The spec's assembly fixtures render exactly as their expected documents.
• The built wheel passes twine check --strict, and it renders a document from a clean venv.
• Golden files: soft line breaks now show as newlines in the HTML source, and the generator tag reads 0.2.0.

Known validator gaps

• Link reference definitions render as paragraphs (legaldown-validator#92).
• The renderer's own diagnostics have no line yet (legaldown-validator#93).
• A drafting note's marker is still stripped by the renderer (legaldown-validator#88).

🤖 Generated with Claude Code

https://claude.ai/code/session_011ZFB1eaR4Fv8vUr2y8RXQt