Struct NestedElement 

pub struct NestedElement { /* private fields */ }

Nested-tree element form for the ergonomic SpecBuilder::element_nested API.

NestedElement mirrors ElementBuilder but with children: Vec<NestedElement> instead of children: Vec<String>. The runtime Spec shape is UNCHANGED: element_nested flattens this nested tree to the canonical flat element map with auto-generated {parent_id}-{idx} IDs at .build() time. Once Spec is constructed, the nested form is gone (D-07: the nested DSL is sugar over construction only).

When to reach for this

Only when neither a static JSON spec, nor $each, nor $if can express the element graph (e.g., truly heterogeneous runtime construction).

Limitations

NestedElement does NOT expose $each / $if directive setters in Phase 163. Rust callers expressing iteration write the loop directly in Rust. If a use case emerges for Rust-side directive injection, add .each(...) / .if_(...) methods in a follow-up phase.

Implementations

impl NestedElement

pub fn new(type_name: impl Into<String>) -> Self

Start a nested element tree node.

pub fn prop(self, k: impl Into<String>, v: impl Into<Value>) -> Self

Set a prop.

pub fn child(self, c: NestedElement) -> Self

Append a child node. Children are flattened to IDs {parent}-{idx} by structural position when the spec is built.

pub fn action(self, a: Action) -> Self

Attach an action.

pub fn visible(self, v: Visibility) -> Self

Attach a visibility rule.

Trait Implementations

impl Debug for NestedElement

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

Formats the value using the given formatter.