Skip to content

Replace Jargon diagrams with native schema viewer; add print + drop PDF gen

Steve CAPELL requested to merge schema-diagrams into main

Data model diagrams:

  • Add an interactive JSON Schema viewer (, built on @stoplight/json-schema-viewer) rendered client-side in an isolated Shadow DOM, registered as a global MDX component. CSS is extracted from @stoplight/mosaic at build time (scripts/extract-stoplight-css-full.js).
  • Replace the six Jargon *-model.svg exports on the credential spec pages (DPP, DCC, DFR, DIA, DTE, CVC) with the viewer pointing at the published v0.7.0 JSON schemas; delete the orphaned current-version SVGs (0.7.0 versioned copies retained).
  • Per-page default expansion via an expandNodes prop: base depth 0 plus best-effort caret clicks on named nodes (e.g. credentialSubject then performanceClaim). Fail-soft: missing node or Stoplight change simply skips expansion, never errors.

Print:

  • Add a per-page print stylesheet (@media print) that strips site chrome and reflows to full width, plus a Print button on each doc. The schema viewer gets its own print rules inside the Shadow DOM and prints at whatever expand state the user has set.

PDF:

  • Remove the whole-site PDF generator (GitLab ci/docs-to-pdf.yml and GitHub workflow) and update ci/README; it was oversized and incompatible with the new client-rendered pages.

Merge request reports