Optional styling YAML

No styling file is required. A report without styles uses the builtin marked as the default in the style reference; builtin-only styles: [scientific] or [sleek] also needs no local YAML. To customize the existing grammar, place any named .yaml/.yml file beside the source and reference it explicitly, for example styles: [scientific, report.rstyle.yaml]. The .rstyle.yaml suffix is the convention, not auto-discovery. Omit/remove the reference if you remove the file; a declared missing file is an actionable resource error.

YAML

# report.rstyle.yaml — ordered after the scientific builtin
tokens:
  bg: 'oklch(0.9695 0.0336 86.31)'
  accent: 'oklch(0.4806 0.1597 25.56)'
chart:
  palette: ['oklch(0.4806 0.1597 25.56)', 'oklch(0.5429 0.0892 211.21)']
  bar-radius: 8

Use the established tokens, layout, components, motion and chart sections and their safe values; see the style section below. Native --style overrides follow source styles and remain report-local. An unspecified chart palette inherits the report style, including a ratio-only style; an explicit style.palette overrides it. Save a local YAML edit to refresh the VS Code/native live preview. In the browser authoring selector, Source / default uses source styling YAML; choosing a canonical style applies an explicit later override. Switching back to Source / default restores local styling without changing source/data. Canonical switches rerender the same report, including its chart payload.