Golden examples

This page is generated from examples/golden-manifest.json. Do not edit by hand.

Golden examples are the “trust builder” for a standard: input + deterministic compiler + expected output that implementations can compare against.

Phase 2 (live): golden PDFs + hashes

These examples now include compiler-produced golden PDFs with a recorded pdf_sha256 in the manifest.

• Do not edit PDFs by hand. Regenerate via the toolchain.
• Each example also includes a deterministic text-only golden (*.normalized.docdraw) + SHA256.

Source of truth:

• examples/golden-manifest.json
• examples/source/ (inputs)
• assets/examples/ (compiler-produced PDFs + normalized outputs)

Examples

Quickstart

• id: quickstart
• expected: PASS
• DocDraw input: examples/source/quickstart.docdraw
• DMP-1 input: examples/source/quickstart.md
• Golden PDF: /assets/examples/quickstart.pdf
• renderer_profile: DD-PDF-1
• Normalized golden: /assets/examples/quickstart.normalized.docdraw
• normalized_sha256: c3e3cace236789fe8b917df7ed262e4478467f68169dfa7b4e4f6dcc18bf7808
• compiler_version: docdraw-php-ddpdf1-proto
• pdf_sha256: d15ed72d56c73c7d2f60b5029e60c43321c8af7d7cc7488c4c8f80b773511967
• last_generated: TBD
• Expected Output Contract:
  • MUST: Bullets render with explicit nesting from -L levels.
  • MUST: Continuation lines (..:) align to the list text start and MUST NOT introduce extra vertical spacing.
  • MUST: Wrapped list lines use hanging indent alignment (text start X).
  • SHOULD: Headings keep-with-next (avoid orphan headings).
  • MUST: Divider (---) renders as a horizontal rule with consistent spacing above and below.
  • MUST: Rendering is deterministic: same input yields same PDF.

List wrapping & continuations

• id: list-wrapping-and-continuations
• expected: PASS
• DocDraw input: examples/source/list-wrapping-and-continuations.docdraw
• DMP-1 input: examples/source/list-wrapping-and-continuations.md
• Golden PDF: /assets/examples/list-wrapping-and-continuations.pdf
• renderer_profile: DD-PDF-1
• Normalized golden: /assets/examples/list-wrapping-and-continuations.normalized.docdraw
• normalized_sha256: 1d13ac9c6aa55d5e7b2b9811720917f6a1480d24cc1094935d569074b8e991c5
• compiler_version: docdraw-php-ddpdf1-proto
• pdf_sha256: 75e3595bf978fd4615a36a34159ad657b8c27a07ab6be79812be24a90590a533
• last_generated: TBD
• Expected Output Contract:
  • MUST: Long list items wrap cleanly without changing indentation.
  • MUST: Continuation lines remain part of the same list item and align with the text start.
  • MUST: Nested bullets indent exactly one level relative to their parent.
  • MUST NOT: Introduce unexpected vertical gaps inside a list block.

Mixed lists & numbering restart

• id: mixed-lists-and-numbering
• expected: PASS
• DocDraw input: examples/source/mixed-lists-and-numbering.docdraw
• DMP-1 input: examples/source/mixed-lists-and-numbering.md
• Golden PDF: /assets/examples/mixed-lists-and-numbering.pdf
• renderer_profile: DD-PDF-1
• Normalized golden: /assets/examples/mixed-lists-and-numbering.normalized.docdraw
• normalized_sha256: 26536ae2d191305e0d820fb5d6e43050512333ac5d73ff0077fdb6c115675e4b
• compiler_version: docdraw-php-ddpdf1-proto
• pdf_sha256: a7ad8db98d19956343dd06f477bc5f379e7f2e8e3bbf67ff36e097385105b7ff
• last_generated: TBD
• Expected Output Contract:
  • MUST: Ordered list numbering restarts after a heading (new ordered list block).
  • MUST: Nested bullets render at the correct explicit levels and wrap with hanging indent alignment.
  • MUST: Continuation text remains attached to the prior list item and aligns to text start.
  • SHOULD: Pagination does not orphan headings; list indentation and numbering remain consistent across page breaks.

DMP-1 ambiguous indent (FAIL)

• id: dmp1-ambiguous-indent
• expected: FAIL (markdown_import) codes: AMBIGUOUS_LIST_INDENT
• DMP-1 input: examples/source/dmp1-ambiguous-indent.md
• compiler_version: TBD
• pdf_sha256: TBD
• last_generated: TBD
• Expected Output Contract:
  • MUST: Converter fails (no guessing) because list indentation does not increase by exactly 4 spaces per level.

DocDraw invalid list level jump (FAIL)

• id: docdraw-invalid-list-level-jump
• expected: FAIL (docdraw_validation) codes: DDV1_LIST_LEVEL_JUMP
• DocDraw input: examples/source/docdraw-invalid-list-level-jump.docdraw
• compiler_version: TBD
• pdf_sha256: TBD
• last_generated: TBD
• Expected Output Contract:
  • MUST: Validator fails because list level jumps from -1 to -3 without an intervening -2.
  • MUST: Validator reports a stable error code (e.g. DDV1_LIST_LEVEL_JUMP) and a fix suggestion.

Reproduce

In the docdraw repo:

make examples-update
make examples-check