Struct LayoutIR 

pub struct LayoutIR {
    pub root: Element,
    pub script_source: String,
    pub script_map: SourceMap,
    pub external_scripts: Vec<String>,
    pub skin: Option<String>,
    pub frameless: bool,
    pub menubar: Option<MenuBarSpec>,
    pub combined_stylesheet: Option<Stylesheet>,
    pub lint_findings: Vec<LintFinding>,
    pub included_files: Vec<PathBuf>,
}

Top of the IR. Single root element; multi-rooted markup is illegal.

Fields

root: Element

The single root element.

script_source: String

Concatenated body text of every inline <script> tag found in the markup, in source order, separated by \n. Empty if none.

Use <script src="foo.cdl"/> instead when the script contains characters that confuse the XML parser (<, <=, &) - those references land in [external_scripts].

script_map: SourceMap

Where each inline block in Self::script_source was written: its markup file and the line its text starts on, so an error in it names that line.

external_scripts: Vec<String>

Paths from every <script src="..."/> reference, in source order. The runtime (lumenc::run::load_ir) resolves them relative to the app directory and concatenates with script_source before handing the combined source to the scripting host.

skin: Option<String>

Opt-in skin requested by the root element via <root skin="...">. None means the bare framework - no default styling, fully honouring the SDD “no opinionated default theme” principle. When Some("default") (the only recognised value today), the runtime prepends an embedded lumen-skin-default stylesheet before parsing the user’s main.css.

frameless: bool

<root frameless="true"> - suppress OS window chrome (title bar, borders, close/min/max buttons). The window backend reads this once at startup to set WindowAttributes::decorations(false). Custom title bars are the app’s responsibility.

menubar: Option<MenuBarSpec>

Native menu bar, collected from the top-level <menubar> element (if any) and stripped from the layout tree. None = no menu bar. Each entry maps to a muda::Submenu / MenuItem / PredefinedMenuItem::separator.

combined_stylesheet: Option<Stylesheet>

Concatenated skin + user CSS, kept around so the for-block reconciler can re-apply matching rules to virtualized template instances after {kind}/{level} etc. placeholders have been substituted into class names at runtime. Without this, <label class="md-h{level}"> never picks up .md-h1 because the parse-time apply pass only saw the literal placeholder.

lint_findings: Vec<LintFinding>

Parse-time lint findings. Populated by the markup walker for problems that don’t invalidate the IR: {name} bare interpolation, a boolean attribute with an off-list value, an attribute nothing reads. The runtime / IR consumers ignore this; every compile path (lumenc check, run, build) prints it to stderr at the finding’s own severity, and lumenc lint --signals folds it into the finding stream.

included_files: Vec<PathBuf>

Normalized paths of every .lmn file pulled in via <include src="..."/> (transitively, in resolution order). Empty when the markup used no includes or was parsed without a file loader. The runtime (lumenc::run) adds these to the hot-reload watch set so editing an included file re-triggers a reload, exactly like [external_scripts].

Trait Implementations

impl Clone for LayoutIR

fn clone(&self) -> LayoutIR

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LayoutIR

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LayoutIR

fn default() -> LayoutIR

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LayoutIR

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LayoutIR

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.