jackdaw 0.4.0

use crate::EditorEntity;
use crate::selection::{Selected, Selection};
use std::any::TypeId;
use std::collections::HashSet;

use bevy::ecs::archetype::Archetype;
use bevy::ecs::component::Components;
use bevy::ecs::reflect::{AppTypeRegistry, ReflectComponent};
use bevy::prelude::*;
use jackdaw_api::prelude::*;
use jackdaw_feathers::picker::{
    Category, Matchable, PickerItems, PickerProps, SelectInput, SpawnItemInput, match_text,
    picker_item,
};
use jackdaw_feathers::tokens;

use bevy::reflect::{TypeInfo, attributes::CustomAttributes};
use jackdaw_feathers::tooltip::Tooltip;
use jackdaw_runtime::{EditorCategory, EditorDescription, EditorHidden};

use super::{AddComponentButton, ComponentPicker};

// `custom_attributes()` lives on the variant types
// (`StructInfo`, `EnumInfo`, etc.), not on `TypeInfo` itself.
fn type_info_custom_attributes(info: &TypeInfo) -> Option<&CustomAttributes> {
    match info {
        TypeInfo::Struct(s) => Some(s.custom_attributes()),
        TypeInfo::TupleStruct(s) => Some(s.custom_attributes()),
        TypeInfo::Enum(e) => Some(e.custom_attributes()),
        TypeInfo::Tuple(_)
        | TypeInfo::List(_)
        | TypeInfo::Array(_)
        | TypeInfo::Map(_)
        | TypeInfo::Set(_)
        | TypeInfo::Opaque(_) => None,
    }
}

/// Type-path filter consulted by [`enumerate_pickable_components`] to
/// hide reflected components that should never appear in the picker
/// (e.g. solver internals, derived caches). Populated by the editor
/// plugin and extensions; downstream code can extend it via
/// [`PickerDenylist::deny_path`] / [`PickerDenylist::deny_prefix`].
#[derive(Resource, Default)]
pub struct PickerDenylist {
    paths: HashSet<&'static str>,
    prefixes: Vec<&'static str>,
}

impl PickerDenylist {
    /// Hide a single fully-qualified type path.
    pub fn deny_path(&mut self, path: &'static str) -> &mut Self {
        self.paths.insert(path);
        self
    }

    /// Hide every type whose full path starts with `prefix`.
    pub fn deny_prefix(&mut self, prefix: &'static str) -> &mut Self {
        self.prefixes.push(prefix);
        self
    }

    /// True when `type_path` is filtered.
    pub fn contains(&self, type_path: &str) -> bool {
        self.paths.contains(type_path) || self.prefixes.iter().any(|p| type_path.starts_with(p))
    }
}

/// Picker category fallback for upstream types we don't own (and so
/// can't tag with `@EditorCategory`). Returns `None` for types that
/// already define their own category or fall through to the default
/// Bevy / Game grouping.
pub fn fallback_category_for(type_path: &str) -> Option<&'static str> {
    if type_path.starts_with("avian3d::") || type_path.starts_with("jackdaw_avian_integration::") {
        Some("Avian3d")
    } else {
        None
    }
}

/// Adds the avian internals jackdaw doesn't want users to see in the
/// picker: solver state, derived mass caches, ancestry book-keeping,
/// sleep-state timers. The user-facing avian components (`RigidBody`,
/// `Collider`, `Mass`, joints, etc.) are deliberately left in.
///
/// This is a conservative starter list; refinements are welcome.
pub fn populate_avian_picker_denylist(denylist: &mut PickerDenylist) {
    // Solver-internal state: contact constraints, islands, solver
    // bodies, schedule plumbing. None of it is user-authored.
    denylist.deny_prefix("avian3d::dynamics::solver::");
    // Internal acceleration structure for collider lookups.
    denylist.deny_prefix("avian3d::collider_tree::");
    // Hierarchy book-keeping (`AncestorMarker<...>` instantiations).
    denylist.deny_prefix("avian3d::ancestor_marker::");
    // Derived mass / inertia caches recomputed every frame from the
    // canonical `Mass` / collider density. The `Computed*` shape is
    // for solver consumption.
    denylist.deny_prefix("avian3d::dynamics::rigid_body::mass_properties::components::computed::");
    // Sleep-cycle timers (managed by avian, not the user).
    denylist
        .deny_path("avian3d::dynamics::rigid_body::sleeping::SleepTimer")
        .deny_path("avian3d::dynamics::rigid_body::sleeping::TimeToSleep");
    // Per-frame integrator scratch state.
    denylist
        .deny_path("avian3d::dynamics::integrator::VelocityIntegrationData")
        .deny_path("avian3d::dynamics::integrator::IntegrationFlags");
    // Avian's standalone `ColliderConstructor` is a one-shot bundle
    // consumed by `init_collider_constructors`. Adding it via the
    // picker on an entity without a `Mesh3d` panics that system.
    // Users should pick `AvianCollider` (the editor wrapper) instead,
    // which builds the `Collider` synchronously and handles brushes
    // / mesh assets. `ColliderConstructorHierarchy` is fine to add
    // (it descends into children for mesh discovery) and stays
    // available.
    denylist.deny_path("avian3d::collision::collider::constructor::ColliderConstructor");
}

/// Grouping key for sorting: custom categories first, then Game, then Bevy.
#[derive(PartialEq, Eq, PartialOrd, Ord, Clone)]
enum GroupOrder {
    Custom(String),
    Game,
    Bevy,
}

impl GroupOrder {
    fn name(self) -> String {
        match self {
            GroupOrder::Custom(name) => name,
            GroupOrder::Game => String::from("Game"),
            GroupOrder::Bevy => String::from("Bevy"),
        }
    }

    fn order(&self) -> i32 {
        match *self {
            GroupOrder::Custom(_) => 2,
            GroupOrder::Game => 1,
            GroupOrder::Bevy => 0,
        }
    }
}

struct ComponentInfo {
    short_name: String,
    module_path: String,
    group: GroupOrder,
    description: String,
    type_path_full: String,
}

/// Public view of one row the component picker would render.
/// Matches the UI's filter rules so tests can assert what users
/// will actually see.
pub struct PickableComponent {
    pub short_name: String,
    pub module_path: String,
    pub category: String,
    pub description: String,
    pub type_path_full: String,
}

/// Enumerate every component the picker would display for a
/// target entity. Filters: must be a `Component`, must be
/// default-constructible (via [`build_reflective_default`]), not
/// already on `existing_types`, and not editor-internal. Reads
/// `EditorCategory` / `EditorDescription` from custom reflect
/// attributes; falls back to the reflected doc comment for
/// description.
///
/// [`build_reflective_default`]: crate::reflect_default::build_reflective_default
pub fn enumerate_pickable_components(
    registry: &bevy::reflect::TypeRegistry,
    existing_types: &HashSet<TypeId>,
    denylist: &PickerDenylist,
) -> Vec<PickableComponent> {
    let mut out = Vec::new();
    for registration in registry.iter() {
        let type_id = registration.type_id();

        if registration.data::<ReflectComponent>().is_none() {
            continue;
        }
        if crate::reflect_default::build_reflective_default(type_id, registry).is_none() {
            continue;
        }
        if existing_types.contains(&type_id) {
            continue;
        }

        let info = registration.type_info();
        let custom_attrs = type_info_custom_attributes(info);

        // Single mechanism for picker hiding: types opt out via the
        // `@EditorHidden` reflect attribute (defined alongside
        // `EditorCategory` / `EditorDescription` in `jackdaw_jsn`).
        // Used by jackdaw's own scene types and available to
        // extension/game authors for their own helper Components.
        if custom_attrs.is_some_and(|a| a.get::<EditorHidden>().is_some()) {
            continue;
        }

        let table = registration.type_info().type_path_table();
        let full_path = table.path();

        if denylist.contains(full_path) {
            continue;
        }

        let description = custom_attrs
            .and_then(|a| a.get::<EditorDescription>())
            .map(|d| d.0.to_string())
            .or_else(|| {
                info.docs()
                    .map(|s| s.trim().to_string())
                    .filter(|s| !s.is_empty())
            })
            .unwrap_or_default();
        let category = custom_attrs
            .and_then(|a| a.get::<EditorCategory>())
            .map(|c| c.0.to_string())
            .or_else(|| fallback_category_for(full_path).map(String::from))
            .unwrap_or_default();

        out.push(PickableComponent {
            short_name: table.short_path().to_string(),
            module_path: table.module_path().unwrap_or("").to_string(),
            category,
            description,
            type_path_full: full_path.to_string(),
        });
    }
    out
}

impl Matchable for ComponentInfo {
    fn haystack(&self) -> String {
        self.short_name.clone()
    }

    fn category(&self) -> Category {
        Category {
            name: Some(self.group.clone().name()),
            order: self.group.order(),
        }
    }
}

/// Handle click on the "+" button to open the component picker.
pub(crate) fn on_add_component_button_click(
    event: On<jackdaw_feathers::button::ButtonClickEvent>,
    add_buttons: Query<&ChildOf, With<AddComponentButton>>,
    existing_pickers: Query<Entity, With<ComponentPicker>>,
    mut commands: Commands,
    selection: Res<Selection>,
    type_registry: Res<AppTypeRegistry>,
    components: &Components,
    entity_query: Query<&Archetype, (With<Selected>, Without<EditorEntity>)>,
    denylist: Res<PickerDenylist>,
) {
    if add_buttons.get(event.entity).is_err() {
        return;
    }

    if let Some(picker) = existing_pickers.iter().next() {
        commands.entity(picker).despawn();
        return;
    }

    let Some(primary) = selection.primary() else {
        return;
    };
    let Ok(archetype) = entity_query.get(primary) else {
        return;
    };

    let existing_types: HashSet<TypeId> = archetype
        .iter_components()
        .filter_map(|cid| {
            components
                .get_info(cid)
                .and_then(bevy::ecs::component::ComponentInfo::type_id)
        })
        .collect();

    let registry = type_registry.read();
    let searchable_components: Vec<ComponentInfo> =
        enumerate_pickable_components(&registry, &existing_types, &denylist)
            .into_iter()
            .map(|p| {
                let group = if !p.category.is_empty() {
                    GroupOrder::Custom(p.category)
                } else if p.module_path.starts_with("bevy") {
                    GroupOrder::Bevy
                } else {
                    GroupOrder::Game
                };
                ComponentInfo {
                    short_name: p.short_name,
                    module_path: p.module_path,
                    group,
                    description: p.description,
                    type_path_full: p.type_path_full,
                }
            })
            .collect();

    let picker = PickerProps::new(spawn_item, on_select)
        .items(searchable_components)
        .title("Add Component")
        .placeholder(Some("Search Components.."));

    commands.spawn((
        picker,
        EditorEntity,
        crate::BlocksCameraInput,
        ComponentPicker(primary),
    ));
}

fn on_select(
    input: In<SelectInput>,
    items: Query<(&ComponentPicker, &PickerItems<ComponentInfo>)>,
    mut commands: Commands,
) -> Result {
    let (picker, items) = items.get(input.entities.picker)?;
    let info = items.at(input.index)?;

    commands
        .operator(crate::inspector::ops::ComponentAddOp::ID)
        .param("entity", picker.0)
        .param("type_path", info.type_path_full.clone())
        .call();

    commands.entity(input.entities.picker).try_despawn();

    Ok(())
}

fn spawn_item(
    In(SpawnItemInput { matched, entities }): In<SpawnItemInput>,
    items: Query<&PickerItems<ComponentInfo>>,
    mut commands: Commands,
) -> Result {
    let info = items.get(entities.picker)?.at(matched.index)?;

    let category = info.group.clone().name();
    let description = info.description.clone();
    let module_path = info.module_path.clone();

    let entry_id = commands
        .spawn((
            picker_item(matched.index),
            ChildOf(entities.list),
            Tooltip::title(matched.haystack)
                .with_description(description.clone())
                .with_footer(format!("{} - {}", module_path, category)),
            children![match_text(matched.segments)],
        ))
        .id();

    // Line 2: subtitle (module path)
    if !module_path.is_empty() {
        commands.spawn((
            Text::new(module_path),
            TextFont {
                font_size: tokens::TEXT_SIZE_SM,
                ..Default::default()
            },
            TextColor(tokens::TEXT_SECONDARY),
            ChildOf(entry_id),
        ));
    }

    Ok(())
}