mittens-engine 0.7.0

use crate::engine::ecs::ComponentId;
use crate::engine::ecs::component::Component;
use crate::engine::graphics::TextureHandle;
use std::path::Path;

/// Runtime texture source/encoding understood by the engine.
///
/// This is intentionally *not* serialized; it is derived from `uri` when the component is
/// created/decoded.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum CatEngineTextureFormat {
    /// Any image format decodable by the `image` crate; uploaded as RGBA8.
    Rgba8,
    /// DDS container containing BC7 blocks (UNorm or UNorm_sRGB).
    DdsBc7,
}

/// Where a texture comes from.
///
/// For v1 GLTF support, imported textures can be represented as a namespaced URI string
/// like "{gltf_name}:{image_name_or_index}".
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum TextureSource {
    /// A URI-like string. Today this is typically a filesystem path (optionally `file://`),
    /// but it can also be a virtual key (e.g. for imported textures).
    Uri(String),
    /// A renderer-provided handle, already uploaded.
    Handle(TextureHandle),
}

impl CatEngineTextureFormat {
    pub fn from_uri(uri: &str) -> Self {
        // We currently treat `uri` as a filesystem path (optionally prefixed with `file://`).
        let raw_path_str = uri.strip_prefix("file://").unwrap_or(uri);
        let ext = Path::new(raw_path_str)
            .extension()
            .and_then(|e| e.to_str())
            .unwrap_or("");

        if ext.eq_ignore_ascii_case("dds") {
            CatEngineTextureFormat::DdsBc7
        } else {
            CatEngineTextureFormat::Rgba8
        }
    }
}

/// Reference to a texture image by URI.
///
/// This component is intended to be attached as a descendant of a `RenderableComponent`.
/// The URI is stored in `TextureSystem`; loading, decoding, and GPU upload happen when the
/// system sees the texture is attached to a renderable.
#[derive(Debug, Clone)]
pub struct TextureComponent {
    pub source: TextureSource,
    pub format: CatEngineTextureFormat,
    pub render_image: Option<String>,
}

impl TextureComponent {
    pub fn new(uri: impl Into<String>) -> Self {
        let uri = uri.into();
        let format = CatEngineTextureFormat::from_uri(&uri);
        Self {
            source: TextureSource::Uri(uri),
            format,
            render_image: None,
        }
    }

    pub fn unresolved() -> Self {
        Self {
            source: TextureSource::Uri(String::new()),
            format: CatEngineTextureFormat::Rgba8,
            render_image: None,
        }
    }

    pub fn with_uri(uri: impl Into<String>) -> Self {
        Self::new(uri)
    }

    pub fn render_image(selector: impl Into<String>) -> Self {
        Self {
            source: TextureSource::Uri(String::new()),
            format: CatEngineTextureFormat::Rgba8,
            render_image: Some(selector.into()),
        }
    }

    pub fn from_handle(handle: TextureHandle) -> Self {
        Self {
            source: TextureSource::Handle(handle),
            // Format is irrelevant for handle-based textures (already uploaded), but keep a
            // sensible default.
            format: CatEngineTextureFormat::Rgba8,
            render_image: None,
        }
    }

    /// Construct a texture component referencing a PNG file.
    ///
    /// Currently, the engine treats `uri` as a local filesystem path (optionally prefixed
    /// with `file://`).
    pub fn from_png(uri: impl Into<String>) -> Self {
        let mut c = Self::new(uri);
        c.format = CatEngineTextureFormat::Rgba8;
        c
    }

    /// Construct a texture component referencing a DDS file containing BC7 blocks.
    pub fn from_dds(uri: impl Into<String>) -> Self {
        let mut c = Self::new(uri);
        c.format = CatEngineTextureFormat::DdsBc7;
        c
    }

    pub fn refresh_format_from_uri(&mut self) {
        if let TextureSource::Uri(uri) = &self.source {
            self.format = CatEngineTextureFormat::from_uri(uri);
        }
    }

    pub fn uri(&self) -> Option<&str> {
        match &self.source {
            TextureSource::Uri(s) if !s.is_empty() => Some(s.as_str()),
            TextureSource::Handle(_) => None,
            TextureSource::Uri(_) => None,
        }
    }
}

impl Component for TextureComponent {
    fn name(&self) -> &'static str {
        "texture"
    }

    fn as_any(&self) -> &dyn std::any::Any {
        self
    }

    fn as_any_mut(&mut self) -> &mut dyn std::any::Any {
        self
    }

    fn init(&mut self, emit: &mut dyn crate::engine::ecs::SignalEmitter, component: ComponentId) {
        emit.push_intent_now(
            component,
            crate::engine::ecs::IntentValue::RegisterTexture {
                component_id: component,
            },
        );
    }

    fn to_mms_ast(
        &self,
        _world: &crate::engine::ecs::World,
    ) -> crate::scripting::ast::ComponentExpression {
        use crate::engine::ecs::component::ce_helpers::*;
        if let Some(selector) = &self.render_image {
            return ce_call("Texture", "render_image", vec![s(selector)]);
        }
        match (&self.source, self.format) {
            (TextureSource::Uri(uri), _) if uri.is_empty() => ce("Texture"),
            (TextureSource::Uri(uri), CatEngineTextureFormat::DdsBc7) => {
                ce_call("Texture", "from_dds", vec![s(uri)])
            }
            (TextureSource::Uri(uri), CatEngineTextureFormat::Rgba8) => {
                ce_call("Texture", "with_uri", vec![s(uri)])
            }
            // Handle-backed textures are runtime-only; emit unresolved.
            (TextureSource::Handle(_), _) => ce("Texture"),
        }
    }
}