Pulsar Reflection

Runtime type metadata for the Pulsar engine. Think Unreal UPROPERTY, but Rust.

At compile time, captures type information — field names, types, offsets, constraints — and makes it available at runtime. You can inspect any reflected type, serialize/deserialize it without serde's derive, generate UI editors automatically, or build blueprint-callable methods on top of it.

Registration is automatic. Uses inventory under the hood — types register themselves at link time. No startup code, no manual registry population.

• pulsar_reflection — the library: types, traits, registries, JSON codec
• pulsar_reflection_derive — the proc macros: #[derive(Reflectable)], #[pulsar_type]

use pulsar_reflection::Reflectable;

#[derive(Reflectable, Default)]
pub struct PhysicsConfig {
    #[reflect(name = "Gravity", min = 0.0, max = 100.0, category = "Physics")]
    pub gravity: f32,

    #[reflect(name = "Friction")]
    pub friction: f32,
}

Available #[reflect(...)] attributes on fields:

• name — display name in UI
• category — collapsible section header
• category_color — hex colour for header
• category_default_collapsed — start collapsed
• min, max, step — numeric constraints
• editor — custom render function
• skip — exclude from reflection

use pulsar_reflection::pulsar_type;

#[pulsar_type(
    serialize_json_with = serialize_my_type,
    deserialize_json_with = deserialize_my_type,
)]
type RegisteredMyType = MyType;

Arguments:

• serialize_json_with (required) — fn(&T) -> ReflectResult<Value>
• deserialize_json_with (required) — fn(Value) -> ReflectResult<T>
• editor (optional) — GPUI render function for the inspector
• color (optional) — hex colour for the type debugger

use pulsar_reflection::RUNTIME_TYPE_REGISTRY;

let info = RUNTIME_TYPE_REGISTRY.get::<f32>().unwrap();
println!("f32: {} bytes, {} alignment", info.size, info.align);

use pulsar_reflection::{JsonSerializer, JsonDeserializer, Reflectable};

let mut s = JsonSerializer::new();
42.0f32.serialize(&mut s).unwrap();

let mut d = JsonDeserializer::new(s.as_json());
let v = f32::deserialize(&mut d).unwrap();

# minimal
pulsar_reflection = { git = "https://github.com/Far-Beyond-Pulsar/Pulsar-Reflection" }

# with editors
pulsar_reflection = { git = "https://github.com/Far-Beyond-Pulsar/Pulsar-Reflection", features = ["prims-gpui"] }

• Pulsar Native — component property inspection, the inspector UI, scene-snapshot data flow
• SceneDB — typed property storage in the spatial database
• pulsar_rendering — per-component property editor registrations
• pulsar_scene — scene file serialization