typst_bake_macros/

lib.rs

//! Procedural macros for typst-bake
//!
//! This crate provides the `document!()` macro that embeds templates
//! and packages at compile time.

mod config;
mod derive_intoval;
mod dir_embed;
mod downloader;
mod scanner;

use proc_macro::TokenStream;
use quote::quote;
use syn::{parse_macro_input, LitStr};

/// Creates a Document with embedded templates, fonts, and packages.
///
/// # Usage
///
/// ```rust,ignore
/// let pdf = typst_bake::document!("main.typ")
///     .to_pdf()?;
/// ```
///
/// # Configuration
///
/// Add to your Cargo.toml:
/// ```toml
/// [package.metadata.typst-bake]
/// template-dir = "./templates"
/// fonts-dir = "./fonts"
/// ```
#[proc_macro]
pub fn document(input: TokenStream) -> TokenStream {
    let entry = parse_macro_input!(input as LitStr);
    let entry_value = entry.value();

    // Get template directory
    let template_dir = match config::get_template_dir() {
        Ok(dir) => dir,
        Err(e) => {
            return syn::Error::new_spanned(entry, e)
                .to_compile_error()
                .into();
        }
    };

    // Check if entry file exists
    let entry_path = template_dir.join(&entry_value);
    if !entry_path.exists() {
        return syn::Error::new_spanned(
            entry,
            format!("Entry file not found: {}", entry_path.display()),
        )
        .to_compile_error()
        .into();
    }

    // Get fonts directory
    let fonts_dir = match config::get_fonts_dir() {
        Ok(dir) => dir,
        Err(e) => {
            return syn::Error::new_spanned(entry, e)
                .to_compile_error()
                .into();
        }
    };

    // Scan for packages
    eprintln!("typst-bake: Scanning templates for package imports...");
    let packages = scanner::extract_packages(&template_dir);

    // Download packages if any
    let cache_dir = match downloader::get_cache_dir() {
        Ok(dir) => dir,
        Err(e) => {
            return syn::Error::new_spanned(entry, e)
                .to_compile_error()
                .into();
        }
    };

    if !packages.is_empty() {
        eprintln!(
            "typst-bake: Found {} package(s) to bundle",
            packages.len()
        );

        let refresh = config::should_refresh_cache();
        if let Err(e) = downloader::download_packages(&packages, &cache_dir, refresh) {
            return syn::Error::new_spanned(entry, e)
                .to_compile_error()
                .into();
        }
    } else {
        eprintln!("typst-bake: No packages found in templates");
    }

    // Generate code
    // We directly generate Dir struct code instead of using include_dir! macro
    // This allows users to not need include_dir in their dependencies
    let templates_result = dir_embed::embed_dir(&template_dir);
    let fonts_result = dir_embed::embed_fonts_dir(&fonts_dir);

    // Collect per-package stats and entries in a single pass
    let mut package_infos = Vec::new();
    let mut pkg_total_original = 0usize;
    let mut pkg_total_compressed = 0usize;
    let mut namespace_entries: Vec<proc_macro2::TokenStream> = Vec::new();

    if cache_dir.exists() {
        // Collect and sort namespaces
        let mut ns_dirs: Vec<_> = std::fs::read_dir(&cache_dir)
            .into_iter()
            .flatten()
            .filter_map(|e| e.ok())
            .filter(|e| e.path().is_dir())
            .collect();
        ns_dirs.sort_by_key(|e| e.path());

        for ns_entry in ns_dirs {
            let ns_path = ns_entry.path();
            let namespace = ns_path.file_name().unwrap().to_string_lossy().to_string();
            let mut name_entries: Vec<proc_macro2::TokenStream> = Vec::new();

            // Collect and sort names
            let mut name_dirs: Vec<_> = std::fs::read_dir(&ns_path)
                .into_iter()
                .flatten()
                .filter_map(|e| e.ok())
                .filter(|e| e.path().is_dir())
                .collect();
            name_dirs.sort_by_key(|e| e.path());

            for name_entry in name_dirs {
                let name_path = name_entry.path();
                let name = name_path.file_name().unwrap().to_string_lossy().to_string();
                let mut version_entries: Vec<proc_macro2::TokenStream> = Vec::new();

                // Collect and sort versions
                let mut ver_dirs: Vec<_> = std::fs::read_dir(&name_path)
                    .into_iter()
                    .flatten()
                    .filter_map(|e| e.ok())
                    .filter(|e| e.path().is_dir())
                    .collect();
                ver_dirs.sort_by_key(|e| e.path());

                for ver_entry in ver_dirs {
                    let ver_path = ver_entry.path();
                    let version = ver_path.file_name().unwrap().to_string_lossy().to_string();

                    // Embed this package (only once!)
                    let pkg_result = dir_embed::embed_dir(&ver_path);
                    let pkg_name = format!("@{}/{}:{}", namespace, name, version);

                    // Collect stats
                    package_infos.push((
                        pkg_name,
                        pkg_result.original_size,
                        pkg_result.compressed_size,
                        pkg_result.file_count,
                    ));
                    pkg_total_original += pkg_result.original_size;
                    pkg_total_compressed += pkg_result.compressed_size;

                    // Build version directory entry
                    let pkg_entries = &pkg_result.entries;
                    version_entries.push(quote! {
                        ::typst_bake::__internal::include_dir::DirEntry::Dir(
                            ::typst_bake::__internal::include_dir::Dir::new(#version, &[#(#pkg_entries),*])
                        )
                    });
                }

                // Build name directory entry
                name_entries.push(quote! {
                    ::typst_bake::__internal::include_dir::DirEntry::Dir(
                        ::typst_bake::__internal::include_dir::Dir::new(#name, &[#(#version_entries),*])
                    )
                });
            }

            // Build namespace directory entry
            namespace_entries.push(quote! {
                ::typst_bake::__internal::include_dir::DirEntry::Dir(
                    ::typst_bake::__internal::include_dir::Dir::new(#namespace, &[#(#name_entries),*])
                )
            });
        }
    }

    // Build final code
    let templates_code = templates_result.to_dir_code("");
    let fonts_code = fonts_result.to_dir_code("");
    let packages_code = quote! {
        ::typst_bake::__internal::include_dir::Dir::new("", &[#(#namespace_entries),*])
    };

    // Generate stats
    let template_original = templates_result.original_size;
    let template_compressed = templates_result.compressed_size;
    let template_count = templates_result.file_count;

    let font_original = fonts_result.original_size;
    let font_compressed = fonts_result.compressed_size;
    let font_count = fonts_result.file_count;

    // Generate package info tokens
    let pkg_info_tokens: Vec<_> = package_infos
        .iter()
        .map(|(name, orig, comp, count)| {
            quote! {
                ::typst_bake::PackageInfo {
                    name: #name.to_string(),
                    original_size: #orig,
                    compressed_size: #comp,
                    file_count: #count,
                }
            }
        })
        .collect();

    let expanded = quote! {
        {
            use ::typst_bake::__internal::{Dir, Document};

            static TEMPLATES: Dir<'static> = #templates_code;
            static PACKAGES: Dir<'static> = #packages_code;
            static FONTS: Dir<'static> = #fonts_code;

            let stats = ::typst_bake::EmbedStats {
                templates: ::typst_bake::CategoryStats {
                    original_size: #template_original,
                    compressed_size: #template_compressed,
                    file_count: #template_count,
                },
                packages: ::typst_bake::PackageStats {
                    packages: vec![#(#pkg_info_tokens),*],
                    total_original: #pkg_total_original,
                    total_compressed: #pkg_total_compressed,
                },
                fonts: ::typst_bake::CategoryStats {
                    original_size: #font_original,
                    compressed_size: #font_compressed,
                    file_count: #font_count,
                },
            };

            Document::__new(&TEMPLATES, &PACKAGES, &FONTS, #entry_value, stats)
        }
    };

    expanded.into()
}

/// Derive macro for implementing `IntoValue` trait.
///
/// This allows structs to be converted to Typst values for use with `with_inputs()`.
///
/// # Example
///
/// ```rust,ignore
/// use typst_bake::IntoValue;
///
/// #[derive(IntoValue)]
/// struct Item {
///     name: String,
///     quantity: i32,
/// }
/// ```
#[proc_macro_derive(IntoValue)]
pub fn derive_into_value(item: TokenStream) -> TokenStream {
    let item = parse_macro_input!(item as syn::DeriveInput);
    derive_intoval::derive_into_value(item)
        .unwrap_or_else(|err| err.to_compile_error())
        .into()
}

/// Derive macro for adding `into_dict()` method to structs.
///
/// This allows structs to be converted to Typst Dict for use with `with_inputs()`.
///
/// # Example
///
/// ```rust,ignore
/// use typst_bake::{IntoValue, IntoDict};
///
/// #[derive(IntoValue, IntoDict)]
/// struct Data {
///     title: String,
///     count: i32,
/// }
///
/// let pdf = typst_bake::document!("main.typ")
///     .with_inputs(data.into_dict())
///     .to_pdf()?;
/// ```
#[proc_macro_derive(IntoDict)]
pub fn derive_into_dict(item: TokenStream) -> TokenStream {
    let item = parse_macro_input!(item as syn::DeriveInput);
    derive_intoval::derive_into_dict(item)
        .unwrap_or_else(|err| err.to_compile_error())
        .into()
}