Crate typst_bake 

typst-bake

Bake Typst templates, fonts, and packages into your Rust binary — use Typst as a self-contained, embedded library.

Cargo Features

• pdf (default) - Enable PDF generation via Document::to_pdf
• svg - Enable SVG generation via Document::to_svg
• png - Enable PNG rasterization via Document::to_png
• full - Enable all output formats

Features

• Multiple Output Formats - Generate PDF, SVG, or PNG from the same template
• File Embedding - All files in template-dir are embedded and accessible from .typ files
• Font Embedding - Fonts (TTF, OTF, TTC) in fonts-dir are automatically bundled
• Package Bundling - Scans for package imports and recursively resolves all dependencies
• Optimized Binary Size - Resources are compressed with zstd and decompressed lazily at runtime
• Runtime Inputs - Pass dynamic data from Rust structs to Typst via IntoValue / IntoDict derive macros
• Page Selection - Select specific pages for output via Document::select_pages

Quick Start

Add to your Cargo.toml:

[package.metadata.typst-bake]
template-dir = "./templates"
fonts-dir = "./fonts"

[dependencies]
typst-bake = "0.1"

Then use the document! macro:

// Generate PDF
let pdf = typst_bake::document!("main.typ").to_pdf()?;

// Generate SVG (one per page)
let svgs = typst_bake::document!("main.typ").to_svg()?;

// Generate PNG at 144 DPI (Retina)
let pngs = typst_bake::document!("main.typ").to_png(144.0)?;

Macros

document

Creates a Document with embedded templates, fonts, and packages.

Structs

CategoryStats

Statistics for a category of files (templates, fonts).

DedupStats

Statistics for content deduplication across all categories.

Document

A fully self-contained document ready for rendering.

EmbedStats

Compression statistics for all embedded content.

PackageInfo

Statistics for a single package.

PackageStats

Statistics for all packages.

Pages

A lightweight view into a Document with a page selection filter.

Enums

Error

Errors that can occur during document compilation and rendering.

Traits

HasCompressionRatio

Trait for types that have original/compressed sizes and can compute a compression ratio.

Functions

rebuild_if_changed

Emits cargo:rerun-if-changed directives for template and font directories.

Type Aliases

Result

A specialized Result type for typst-bake operations.

Derive Macros

IntoDict

Derive macro for converting a struct to a Typst dictionary.

IntoValue

Derive macro for converting a struct to a Typst value.