Struct Inputs 

pub struct Inputs { /* private fields */ }

Opaque inputs type for sys.inputs injection.

Created via Inputs::from_json(). Pass to [Batcher::with_inputs()].

Implementations

impl Inputs

pub fn empty() -> Self

Create empty inputs.

pub fn from_json(json: &JsonValue) -> Result<Self, ConvertError>

Create inputs from JSON value.

Automatically maps JSON types to Typst types:

• string → Str
• number (integer) → Int
• number (float) → Float
• boolean → Bool
• array → Array
• object → Dict
• null → None

Example

let base_json = serde_json::json!({
    "title": "My Blog",
    "description": "A personal blog",
    "extra": {
        "author": "Alice",
        "twitter": "@alice"
    }
});
let inputs = Inputs::from_json(&base_json)?;

pub fn from_json_with_content( json: &JsonValue, root: &Path, ) -> Result<Self, ConvertError>

Create inputs from JSON with Content reconstruction.

Like from_json(), but automatically rebuilds Typst Content from JSON objects containing {"func": ...}.

Use this when your JSON contains serialized Typst Content (e.g., metadata extracted from compiled pages).

Example

// JSON with Content field (has "func")
let pages_json = serde_json::json!({
    "pages": [
        {
            "url": "/post/1",
            "summary": {
                "func": "sequence",
                "children": [
                    {"func": "text", "text": "Hello "},
                    {"func": "link", "dest": "https://example.com", "body": {...}}
                ]
            }
        }
    ]
});

// Content fields are automatically rebuilt
let inputs = Inputs::from_json_with_content(&pages_json, root)?;

pub fn merge(&mut self, other: Inputs)

Merge another Inputs into this one.

Values from other overwrite values in self for duplicate keys.

pub fn merge_json(&mut self, json: &JsonValue) -> Result<(), ConvertError>

Merge a JSON object into this Inputs.

pub fn into_dict(self) -> Dict

Get the underlying Dict.