feat: config.variants — multiple outputs from one composition

[andresilva-cc]

Summary

• config.variants — define named output variations (og, twitter, square, etc.)
• Each variant inherits base config and can override any field + inject props
• renderAll() API returns Map<string, RenderResult>
• render() accepts variant option for single-variant render
• --variant CLI flag; omit to render all variants to a directory
• Props merge: CLI > variant > default; array fields replace, not merge
• Transpile-once optimization (no N+1 esbuild calls)

Closes #33

Test plan

• 279 tests pass (27 new: 14 unit + 4 CLI + 9 integration)
• CLI: all variants output correct files and dimensions
• CLI: single variant via --variant
• API: render() with variant option
• API: renderAll() returns correct Map
• Backwards compatible (no variants = works as before)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
grafex	Ready	Preview, Comment	Mar 20, 2026 9:08pm