euv-macros 0.8.13

use crate::*;

/// Represents a single HTML node, which may be an element or text.
///
/// Parsed from the `html!` macro input before code generation.
#[derive(Clone, Debug)]
pub(crate) enum HtmlNode {
    /// An HTML element.
    Element(HtmlElement),
    /// A text string literal.
    Text(String),
    /// A bare Rust expression (identifiers without braces), converted to a
    /// `VirtualNode` via `IntoNode::into_node`. This is a static one-shot
    /// conversion — no re-rendering on signal changes.
    Expr(Expr),
    /// A braced Rust expression `{expr}` in a child position, automatically
    /// wrapped into a `DynamicNode` that re-renders when signals change.
    /// The expression is evaluated inside a `move || { ... }` closure each
    /// time the dynamic node's render function is called.
    Dynamic(Expr),
    /// A reactive conditional: `if {signal} { html... } else if {signal} { html... } else { html... }`.
    ///
    /// Each condition is a signal expression in braces. When any signal changes,
    /// the entire conditional is re-evaluated and wrapped in a `DynamicNode`.
    If(HtmlIf),
    /// A reactive match: `match {signal} { pattern => { html... } ... }`.
    ///
    /// The signal expression in braces is re-evaluated on change, and the
    /// matching arm's HTML is rendered inside a `DynamicNode`.
    Match(HtmlMatch),
    /// A reactive for loop: `for pattern in {iterable} { html... }`.
    ///
    /// The pattern is a Rust binding pattern (e.g., `item` or `(index, item)`).
    /// The iterable expression in braces is re-evaluated on signal change,
    /// and each iteration's HTML is collected into a `DynamicNode` fragment.
    For(HtmlFor),
    /// A dynamic tag: `{tag_expr} { attr: value, ... children ... }`.
    ///
    /// The expression in braces evaluates to a tag name string at runtime.
    /// If the tag name matches a registered user component, the component
    /// function is called with the provided attributes and children.
    /// Otherwise, a native HTML element is created.
    DynamicTag(HtmlDynamicTag),
}

/// Represents the value side of an attribute.
///
/// Supports plain expressions, style objects, reactive/inline conditionals,
/// reactive/inline match expressions, and merged multi-class/multi-style attribute values.
#[derive(Clone, Debug)]
pub(crate) enum HtmlAttrValue {
    /// A normal Rust expression.
    Expr(Expr),
    /// A conditional: `if {expr} { value }` (reactive) or `if condition { value }` (inline).
    If(HtmlAttrIf),
    /// A match expression: `match {expr} { ... }` (reactive) or `match expr { ... }` (inline).
    Match(HtmlAttrMatch),
    /// A style object: `{key: value; key2: value2;}`.
    ///
    /// The value can be either a string literal or an expression.
    Style(Vec<(String, HtmlStylePropValue)>),
    /// Multiple class attribute values merged from repeated `class:` declarations.
    ///
    /// Each entry is an independent expression (e.g., `c_foo()`, `c_bar()`).
    Classes(Vec<HtmlAttrValue>),
    /// Multiple style attribute values merged from repeated `style:` declarations.
    ///
    /// Each entry is an independent `Style` value.
    Styles(Vec<HtmlAttrValue>),
}

/// Represents a single value in a style property.
///
/// May be a static string literal, a dynamic expression, a reactive/inline conditional,
/// or a reactive/inline match expression.
#[derive(Clone, Debug)]
pub(crate) enum HtmlStylePropValue {
    /// A static string literal.
    Literal(String),
    /// A dynamic expression.
    Expr(Expr),
    /// A conditional in attribute value position.
    ///
    /// Syntax: `if {expr} { value }` (reactive) or `if condition { value }` (inline).
    If(HtmlAttrIf),
    /// A match expression in attribute value position.
    ///
    /// Syntax: `match {expr} { ... }` (reactive) or `match expr { ... }` (inline).
    Match(HtmlAttrMatch),
}

/// Determines how `attr_if_to_tokens` wraps each branch body during code generation.
///
/// - `Reactive`: Each branch body is wrapped with `IntoReactiveString::into_reactive_string()`,
///   ensuring all branches produce a `String`. Used for `class` and `style` attributes
///   where the `if` and implicit `else` branches may return different types
///   (e.g., `Css` vs `&str`).
/// - `Raw`: Branch bodies are emitted as-is without wrapping. Used for component props
///   where the branch types are already consistent or handled externally.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum AttrIfMode {
    /// Wrap each branch body with `IntoReactiveString::into_reactive_string()`.
    Reactive,
    /// Emit branch bodies as-is without any wrapping.
    Raw,
}