Struct Element 

pub struct Element {
    pub type_name: String,
    pub props: Value,
    pub children: Vec<String>,
    pub action: Option<Action>,
    pub visible: Option<Visibility>,
    pub each: Option<EachDirective>,
    pub if_: Option<Visibility>,
}

A single type-erased UI element.

The type_name is an unrestricted string; catalog / renderer layers decide whether the name resolves to a built-in or plugin component. props is a free-form JSON value carrying component-specific fields; validation of per-component props is deferred to the Phase 117 catalog.

Fields

type_name: String

Component type name (renamed from type to avoid Rust keyword collision).

props: Value

Component-specific props payload.

children: Vec<String>

IDs of child elements (must resolve in the parent Spec.elements map).

action: Option<Action>

Optional action attached to this element.

visible: Option<Visibility>

Optional visibility rule governing whether this element renders.

each: Option<EachDirective>

Optional iteration directive. When present, the element is treated as a template — resolve-time expansion (Plan 03) produces N clones with auto-suffixed IDs, one per row in the resolved data array.

if_: Option<Visibility>

Optional conditional-emission directive. When the predicate evaluates false against Spec::data at resolve time (Plan 03), the element is REMOVED from the element map (no hidden DOM, no JS). Distinct from visible which renders the element with hidden semantics.

Reuses the Visibility enum (D-04) — accepts flat conditions AND And/Or/Not composition because Visibility is #[serde(untagged)].

Interaction with $each

When both $if and $each are present on the same element, $if is evaluated FIRST. If false, the element is removed before $each expansion runs (no clones produced).

Implementations

impl Element

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

Start building an Element with the given type name.

Returns an ElementBuilder rather than Self because element construction is fluent; the terminal call is consumed by SpecBuilder::element which invokes the crate-private build.

Trait Implementations

impl Clone for Element

fn clone(&self) -> Element

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Element

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Element

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Element

fn eq(&self, other: &Element) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Element

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Element