forma_ir/
lib.rs

1//! Forma Module IR: binary format definitions and parsers.
2//!
3//! This crate provides the core IR types and parsing logic that can be compiled
4//! to both native Rust and WebAssembly targets.
5
6#![allow(clippy::type_complexity)]
7
8pub mod format;
9pub mod parser;
10pub mod slot;
11pub mod walker;
12
13#[cfg(feature = "dump")]
14pub mod dump;
15
16// Re-exports for convenience
17pub use format::{
18    IrError, IrHeader, IslandEntry, IslandTrigger, Opcode, PropsMode, SectionDescriptor,
19    SectionTable, SlotEntry, SlotSource, SlotType, HEADER_SIZE, IR_VERSION, MAGIC,
20    SECTION_TABLE_SIZE,
21};
22pub use parser::{IrModule, IslandTableParsed, SlotTable, StringTable};
23pub use slot::{json_to_slot_value, SlotData, SlotValue};
24pub use walker::{walk_island, walk_to_html};
25
26#[cfg(feature = "wasm")]
27use wasm_bindgen::prelude::*;
28
29/// Full page render: parse IR bytes + JSON slots → HTML string.
30/// Panics on error (throws JS exception in WASM — client loader catches and falls back).
31#[cfg(feature = "wasm")]
32#[wasm_bindgen]
33pub fn render(ir_bytes: &[u8], slots_json: &str) -> String {
34    let module = parser::IrModule::parse(ir_bytes).unwrap_or_else(|e| panic!("IR parse: {e}"));
35    let slots =
36        slot::SlotData::from_json(slots_json, &module).unwrap_or_else(|e| panic!("slots: {e}"));
37    walker::walk_to_html(&module, &slots).unwrap_or_else(|e| panic!("walk: {e}"))
38}
39
40/// Fragment render: parse IR bytes + JSON slots → island inner HTML.
41/// Panics on error (throws JS exception in WASM — client loader catches and falls back).
42#[cfg(feature = "wasm")]
43#[wasm_bindgen]
44pub fn render_island(ir_bytes: &[u8], slots_json: &str, island_id: u16) -> String {
45    let module = parser::IrModule::parse(ir_bytes).unwrap_or_else(|e| panic!("IR parse: {e}"));
46    let slots =
47        slot::SlotData::from_json(slots_json, &module).unwrap_or_else(|e| panic!("slots: {e}"));
48    walker::walk_island(&module, &slots, island_id).unwrap_or_else(|e| panic!("walk island: {e}"))
49}
forma_ir/lib.rs

forma_ir/
lib.rs
