euv_macros/

lib.rs

//! euv-macros
//!
//! Procedural macros for the euv UI framework, including the `html!` macro
//! for declarative UI syntax, the `class!` macro for CSS class definitions,
//! the `vars!` macro for CSS custom properties, the `watch!` macro for
//! reactive side effects, the `computed!` macro for reactive computed signals,
//! and the `component` attribute macro.

#[macro_use]
extern crate syn;

mod class;
mod computed;
mod html;
mod ident;
mod raw_html;
mod var;
mod watch;

#[cfg(test)]
#[path = "../tests/mod.rs"]
mod tests;

pub(crate) use {class::*, computed::*, html::*, ident::*, raw_html::*, var::*, watch::*};

pub(crate) use proc_macro2::TokenTree;
pub(crate) use std::fmt::{Debug, Formatter};

use std::{
    collections::{HashMap, hash_map::DefaultHasher},
    env::{self, VarError},
    ffi::OsStr,
    fmt::{self, Write},
    fs::{create_dir_all, metadata, read_dir, read_to_string, write},
    hash::{Hash, Hasher},
    io,
    iter::Peekable,
    mem::MaybeUninit,
    path::PathBuf,
    time::UNIX_EPOCH,
};

use {
    lombok_macros::*,
    proc_macro::TokenStream,
    proc_macro2::Span,
    quote::{ToTokens, quote, quote_spanned},
    syn::{
        Attribute, Block, Expr, Field, File, Generics, Ident, Item, LitStr, Path, Stmt, Token,
        Type, Visibility, WhereClause, braced, parenthesized, parse,
        parse::{Parse, ParseBuffer, ParseStream},
        parse_file, parse2,
        token::{Brace, Colon, Paren, Semi},
    },
};

/// The `html!` macro for writing declarative UI in euv.
///
/// This macro accepts a syntax similar to Dioxus HTML:
///
/// # Arguments
///
/// - `TokenStream` - The `html! { ... }` invocation tokens.
///
/// # Returns
///
/// - `TokenStream` - The expanded virtual-DOM construction tokens.
#[proc_macro]
pub fn html(input: TokenStream) -> TokenStream {
    parse_html(input)
}

/// The `class!` macro for defining CSS classes with style properties.
///
/// Each class definition creates a `Css` function that can be used
/// in `html!` via the `class:` attribute. Styles are automatically injected
/// into the DOM on first use.
///
/// Parameterized classes keep the normal function-call syntax. Wrap a
/// parameter reference in `{}` to make it part of the generated class name
/// by value; parameters referenced without braces keep the default
/// type-based class name.
///
/// # Arguments
///
/// - `TokenStream` - The `class! { ... }` invocation tokens.
///
/// # Returns
///
/// - `TokenStream` - The expanded `Css` function tokens.
#[proc_macro]
pub fn class(input: TokenStream) -> TokenStream {
    parse_class(input)
}

/// The `watch!` macro for creating reactive side effects.
///
/// Watches one or more signals and executes a closure whenever any of them changes.
/// The closure is also executed once immediately with the current signal values
/// during initialisation. This initial execution is wrapped in a suppressed-update
/// scope so that any `.set()` calls inside the body do not trigger unnecessary
/// DynamicNode re-renders.
///
/// The number of signal expressions must match the number of closure parameters.
/// Each closure parameter receives the current value (via `.get()`) of the
/// corresponding signal. Parameter types are optional and can be annotated
/// after a colon.
///
/// # Arguments
///
/// - `TokenStream` - The `watch! { ... }` invocation tokens.
///
/// # Returns
///
/// - `TokenStream` - The expanded reactive-effect tokens.
#[proc_macro]
pub fn watch(input: TokenStream) -> TokenStream {
    parse_watch(input)
}

/// The `computed!` macro for creating reactive computed signals.
///
/// Watches one or more signals and derives a new signal whose value is
/// automatically computed from the closure return value whenever any input
/// signal changes. The closure must return a value of the specified return type.
///
/// The number of signal expressions must match the number of closure parameters.
/// Each closure parameter receives the current value (via `.get()`) of the
/// corresponding signal. Parameter types are optional and can be annotated
/// after a colon. The return type must be specified after `->`.
///
/// The result signal is created via `use_signal` and updated via `set()`
/// to mark its dependents dirty precisely. The initial value is computed immediately
/// during first render.
///
/// # Arguments
///
/// - `TokenStream` - The `computed! { ... }` invocation tokens.
///
/// # Returns
///
/// - `TokenStream` - The expanded computed-signal tokens.
#[proc_macro]
pub fn computed(input: TokenStream) -> TokenStream {
    parse_computed(input)
}

/// The `vars!` macro for defining CSS custom properties.
///
/// Each variable block creates a `Css` function that, when called,
/// injects the CSS custom properties into the DOM. Variable names are
/// automatically prefixed with `--`.
///
/// Variable names can be written as unquoted kebab-case identifiers
/// (e.g., `bg-primary`) or as quoted string literals (e.g., `"bg-primary"`).
///
/// # Arguments
///
/// - `TokenStream` - The `vars! { ... }` invocation tokens.
///
/// # Returns
///
/// - `TokenStream` - The expanded custom-property injection tokens.
#[proc_macro]
pub fn vars(input: TokenStream) -> TokenStream {
    parse_vars(input)
}

/// The `var!` macro for referencing CSS custom properties defined via `vars!`.
///
/// The variable name can be written as an unquoted kebab-case identifier
/// (e.g., `bg-primary`) or as a quoted string literal (e.g., `"bg-primary"`),
/// and expands to the CSS string `"var(--bg-primary)"`.
///
/// # Arguments
///
/// - `TokenStream` - The `var! { ... }` invocation tokens.
///
/// # Returns
///
/// - `TokenStream` - The expanded `var(--name)` tokens.
#[proc_macro]
pub fn var(input: TokenStream) -> TokenStream {
    parse_var(input)
}

/// The `unsafe_no_inline!` macro — escape hatch for raw HTML.
///
/// Accepts a string literal and emits a `euv::vdom::RawHtml` value
/// constructed via `RawHtml::new`. The `unsafe_no_` prefix is a
/// deliberately loud warning that the string is NOT escaped; treat
/// it like `Element.innerHTML` in JavaScript.
///
/// # Arguments
///
/// - `TokenStream` - The `unsafe_no_inline!("...")` invocation tokens.
///
/// # Returns
///
/// - `TokenStream` - The expanded `RawHtml::new` construction tokens.
#[proc_macro]
pub fn unsafe_no_inline(input: TokenStream) -> TokenStream {
    parse_unsafe_no_inline(input)
}

/// The `component` attribute macro for marking component functions.
///
/// Only functions annotated with `#[component]` are treated as components
/// in the `html!` macro. All other identifier tags are treated as native
/// HTML elements (with `Tag::Element`).
///
/// The `html!` macro scans the project source to find `#[component]`-annotated
/// functions at compile time, so this attribute must be present for the
/// `html!` macro to generate a component function call.
///
/// # Arguments
///
/// - `TokenStream` - The attribute arguments (unused).
///
/// # Returns
///
/// - `TokenStream` - The original item unchanged.
#[proc_macro_attribute]
pub fn component(_attr: TokenStream, item: TokenStream) -> TokenStream {
    item
}