Add FromTemplate derives to Components using Handle (#23696)

# Objective

A lot of Bevy's built in types don't derive FromTemplate, which is what
makes things like asset handles "templatable" in BSN:

```rust
bsn! {
  ImageNode { image: "path_to_image.png" }
}
```

## Solution

Derive `FromTemplate` for components that have handles.

In cases of fields with `Option<SOME_TEMPLATED_TYPE>`, I've added the
`#[template(OptionTemplate<XTemplate>)]` attribute, as these cases can't
use the blanket `Default + Clone` template implementation (which doesn't
do templating on the internal type). Later I'm likely to propose
something like `#[template(built_in)]` for standard "collection types"
to make this a little less boilerplatey.

Author: cart

crates/bevy_animation/src/graph.rs

@@ -17,6 +17,7 @@ use bevy_ecs::{
     reflect::ReflectComponent,
     resource::Resource,
     system::{Res, ResMut},
+    template::FromTemplate,
 };
 use bevy_platform::collections::HashMap;
 use bevy_reflect::{prelude::ReflectDefault, Reflect, TypePath};
@@ -130,7 +131,9 @@ pub struct AnimationGraph {
 }
 
 /// A [`Handle`] to the [`AnimationGraph`] to be used by the [`AnimationPlayer`](crate::AnimationPlayer) on the same entity.
-#[derive(Component, Clone, Debug, Default, Deref, DerefMut, Reflect, PartialEq, Eq, From)]
+#[derive(
+    Component, Clone, Debug, Default, Deref, DerefMut, Reflect, PartialEq, Eq, From, FromTemplate,
+)]
 #[reflect(Component, Default, Clone)]
 pub struct AnimationGraphHandle(pub Handle<AnimationGraph>);
 

crates/bevy_audio/src/audio.rs

@@ -245,7 +245,7 @@ pub struct DefaultSpatialScale(pub SpatialScale);
 ///
 /// Playback can be configured using the [`PlaybackSettings`] component. Note that changes to the
 /// [`PlaybackSettings`] component will *not* affect already-playing audio.
-#[derive(Component, Reflect)]
+#[derive(Component, Reflect, FromTemplate)]
 #[reflect(Component, Clone)]
 #[require(PlaybackSettings)]
 pub struct AudioPlayer<Source = AudioSource>(pub Handle<Source>)

crates/bevy_camera/src/camera.rs

@@ -6,7 +6,9 @@ use super::{
 };
 use bevy_asset::Handle;
 use bevy_derive::Deref;
-use bevy_ecs::{component::Component, entity::Entity, reflect::ReflectComponent};
+use bevy_ecs::{
+    component::Component, entity::Entity, reflect::ReflectComponent, template::FromTemplate,
+};
 use bevy_image::Image;
 use bevy_math::{ops, Dir3, FloatOrd, Mat4, Ray3d, Rect, URect, UVec2, Vec2, Vec3, Vec3A};
 use bevy_reflect::prelude::*;
@@ -884,7 +886,20 @@ pub enum NormalizedRenderTarget {
 /// A unique id that corresponds to a specific `ManualTextureView` in the `ManualTextureViews` collection.
 ///
 /// See `ManualTextureViews` in `bevy_camera` for more details.
-#[derive(Default, Debug, Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord, Component, Reflect)]
+#[derive(
+    Default,
+    Debug,
+    Clone,
+    Copy,
+    PartialEq,
+    Eq,
+    Hash,
+    PartialOrd,
+    Ord,
+    Component,
+    Reflect,
+    FromTemplate,
+)]
 #[reflect(Component, Default, Debug, PartialEq, Hash, Clone)]
 pub struct ManualTextureViewHandle(pub u32);
 

crates/bevy_gizmos/src/config.rs

@@ -5,7 +5,7 @@ pub use bevy_gizmos_macros::GizmoConfigGroup;
 
 use {crate::GizmoAsset, bevy_asset::Handle, bevy_ecs::component::Component};
 
-use bevy_ecs::{reflect::ReflectResource, resource::Resource};
+use bevy_ecs::{reflect::ReflectResource, resource::Resource, template::FromTemplate};
 use bevy_reflect::{std_traits::ReflectDefault, Reflect, TypePath};
 use bevy_utils::TypeIdMap;
 use core::{
@@ -276,7 +276,7 @@ impl Default for GizmoLineConfig {
 }
 
 /// Configuration for gizmo meshes.
-#[derive(Component)]
+#[derive(Component, FromTemplate)]
 pub struct GizmoMeshConfig {
     /// Apply perspective to gizmo lines.
     ///

crates/bevy_gizmos/src/retained.rs

@@ -3,7 +3,7 @@
 use core::ops::{Deref, DerefMut};
 
 use bevy_asset::Handle;
-use bevy_ecs::{component::Component, reflect::ReflectComponent};
+use bevy_ecs::{component::Component, reflect::ReflectComponent, template::FromTemplate};
 use bevy_reflect::{std_traits::ReflectDefault, Reflect};
 use bevy_transform::components::Transform;
 
@@ -61,7 +61,7 @@ impl DerefMut for GizmoAsset {
 /// ```
 ///
 /// [`Gizmos`]: crate::gizmos::Gizmos
-#[derive(Component, Clone, Debug, Default, Reflect)]
+#[derive(Component, Clone, Debug, Default, Reflect, FromTemplate)]
 #[reflect(Component, Clone, Default)]
 #[require(Transform)]
 pub struct Gizmo {

crates/bevy_light/src/atmosphere.rs

@@ -8,6 +8,7 @@ use bevy_ecs::{
     lifecycle::HookContext,
     message::MessageReader,
     system::{Res, ResMut},
+    template::FromTemplate,
     world::DeferredWorld,
 };
 use bevy_image::Image;
@@ -28,8 +29,8 @@ use wgpu_types::TextureFormat;
 ///
 /// The scale on [`GlobalTransform`] rescales the planet in world space. Tune it with the radius offset
 /// when your scene uses other units, like kilometer-sized scenes.
-#[derive(Clone, Component)]
-#[require(GlobalTransform::default())]
+#[derive(Clone, Component, FromTemplate)]
+#[require(GlobalTransform)]
 #[component(on_add = set_default_transform)]
 pub struct Atmosphere {
     /// Radius of the planet

crates/bevy_light/src/directional_light.rs

@@ -170,7 +170,7 @@ impl DirectionalLight {
 /// Add to a [`DirectionalLight`] to add a light texture effect.
 /// A texture mask is applied to the light source to modulate its intensity,  
 /// simulating patterns like window shadows, gobo/cookie effects, or soft falloffs.
-#[derive(Clone, Component, Debug, Reflect)]
+#[derive(Clone, Component, Debug, Reflect, FromTemplate)]
 #[reflect(Component, Debug)]
 #[require(DirectionalLight)]
 pub struct DirectionalLightTexture {

crates/bevy_light/src/point_light.rs

@@ -156,7 +156,7 @@ impl PointLight {
 /// Add to a [`PointLight`] to add a light texture effect.
 /// A texture mask is applied to the light source to modulate its intensity,  
 /// simulating patterns like window shadows, gobo/cookie effects, or soft falloffs.
-#[derive(Clone, Component, Debug, Reflect)]
+#[derive(Clone, Component, Debug, Reflect, FromTemplate)]
 #[reflect(Component, Debug)]
 #[require(PointLight)]
 pub struct PointLightTexture {

crates/bevy_light/src/probe.rs

@@ -101,7 +101,7 @@ impl LightProbe {
 /// area in space.
 ///
 /// See `bevy_pbr::environment_map` for detailed information.
-#[derive(Clone, Component, Reflect)]
+#[derive(Clone, Component, Reflect, FromTemplate)]
 #[reflect(Component, Default, Clone)]
 pub struct EnvironmentMapLight {
     /// The blurry image that represents diffuse radiance surrounding a region.
@@ -220,7 +220,7 @@ impl Default for EnvironmentMapLight {
 /// To do so, use [`EnvironmentMapLight`] alongside this component.
 ///
 /// See also <https://en.wikipedia.org/wiki/Skybox_(video_games)>.
-#[derive(Component, Clone, Reflect)]
+#[derive(Component, Clone, Reflect, FromTemplate)]
 #[reflect(Component, Default, Clone)]
 pub struct Skybox {
     /// The cubemap to use.
@@ -249,7 +249,7 @@ impl Default for Skybox {
 /// A generated environment map that is filtered at runtime.
 ///
 /// See `bevy_pbr::light_probe::generate` for detailed information.
-#[derive(Clone, Component, Reflect)]
+#[derive(Clone, Component, Reflect, FromTemplate)]
 #[reflect(Component, Default, Clone)]
 pub struct GeneratedEnvironmentMapLight {
     /// Source cubemap to be filtered on the GPU, size must be a power of two.
@@ -317,7 +317,7 @@ impl Default for AtmosphereEnvironmentMapLight {
 ///
 /// This component requires the [`LightProbe`] component, and is typically used with
 /// [`bevy_transform::components::Transform`] to place the volume appropriately.
-#[derive(Clone, Reflect, Component, Debug)]
+#[derive(Clone, Reflect, Component, Debug, FromTemplate)]
 #[reflect(Component, Default, Debug, Clone)]
 #[require(LightProbe)]
 pub struct IrradianceVolume {

crates/bevy_light/src/spot_light.rs

@@ -201,7 +201,7 @@ pub fn spot_light_clip_from_view(angle: f32, near_z: f32) -> Mat4 {
 /// Add to a [`SpotLight`] to add a light texture effect.
 /// A texture mask is applied to the light source to modulate its intensity,  
 /// simulating patterns like window shadows, gobo/cookie effects, or soft falloffs.
-#[derive(Clone, Component, Debug, Reflect)]
+#[derive(Clone, Component, Debug, Reflect, FromTemplate)]
 #[reflect(Component, Debug)]
 #[require(SpotLight)]
 pub struct SpotLightTexture {