Lib.rs

• Simpler Entity spawning & modifying
• Style Sheet Notation for bevy_ui components (and your own) - ui!(( width: 20px; ))
• Simplified Notation for Color, Val and UiRect - code!{ let red = #ff0000; //..any code }

Setup

Multiple bevy versions are supported and managed by features:

# bevy 0.16.0-rc.4
mevy = {version="0.2",features=["0.16-rc"]}

# bevy 0.15
mevy = {version="0.2",features=["0.15"]}

Then just use all of it:

use bevy::prelude::*;
use mevy::*;

Simpler Hierarchy Spawning

Spawn children just by stating [] - the 'names' are just variables containing their Entity

• those variables can be used anywhere in the macro - even 'before'
• read more or see this example.

entity!{
    <world> // pass a mut World, Commands, ... variable
    SpecificChild(optional_child_name); // insert component
    .observe(..);                       // use method
    > Pointer<Click>{..};               // quick observe (e.g. 'on click')
    // component/bundle;
    // .method(..);
    [optional_child_name][
        // component;
        // .method(..);
    ]
}

Modify entities in a 'quick and dirty' way:

• read more or see this example.

entity!{
    <world|#Component> // select every entity with this Component
    <Children.iter()>  // > select all children of those
    <Children.iter()>  // >> infinitely chain those selectors
    .despawn();        // despawn all of the last selected
}

CSS-like notation for bevy_ui

Using ui!((..)) (inner round braces) will return a tuple of mentioned components only.

• read about available fields, custom fields & notation in this readme
• see this example.

c.spawn(ui!((
    size:          100px 100px;
    border:        5px #ff0000;
    box_shadow:    10% 10% 3px 8px #ffaa44;
    background:    #ffffff;
    border_radius: 6px;
    neat_outline;
)?));
//^ optional ? (or any token): hovering shows the returned tuple (if LSP used)

/// function as custom fields or p refabs
fn neat_outline() -> Outline {ui!((
    outline: 3px 1px #00ff00;
))}

Code Replacement Macro

Using the code!{} macro simplifies constructing:

• Color by writing #rgb/#rgba/#rrggbb/#rrggbbaa
• Val by writing 0px/0%/0vw/0vh/0vmin/0vmax/@(auto)
• UiRect by writing [>0px]/[>0px 0px]/[>0px 0px 0px]/[>0px 0px 0px 0px] (css-like)

So you can do fun things like:

let shadow = code!{BoxShadow{
    // use #... is replaced with Color, meaning you can e.g. use methods 
    color: #FF1265.mix(&#F93ECA,0.4).with_alpha(0.2),
    x_offset: 100px,
    y_offset: 50%,
    spread_radius: 3.1vh,
    blur_radius: 40.23vmax,
}}};
let color = code!{#FF0000};
// or multiple things in the macro
code!{
    let color2 = #00FF00;
    let color3 = #6600AA;
}
println!{"{color2:?}"}

Design

Crates are separated into:

• crate/*/syntax: token handling, meant to be reusable
• crate/*: actual macros, based on that 'syntax'