From 0212717783b81a6ef3134b3227222a1cafbb227b Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Mon, 9 Dec 2024 17:51:00 +0100
Subject: [PATCH 01/18] Rename `Path` to `Shape`

`Path` will be the "driving concept" component
for Required Components.
The name does not fit well, so I changed it to `Shape`.
---
 examples/dynamic_shape.rs |  2 +-
 src/entity.rs             |  6 +++---
 src/geometry.rs           |  8 ++++----
 src/lib.rs                |  2 +-
 src/path.rs               | 12 ++++++------
 src/plugin.rs             |  6 +++---
 6 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/examples/dynamic_shape.rs b/examples/dynamic_shape.rs
index a272f62..2417edd 100644
--- a/examples/dynamic_shape.rs
+++ b/examples/dynamic_shape.rs
@@ -34,7 +34,7 @@ fn change_draw_mode_system(mut query: Query<(&mut Fill, &mut Stroke)>, time: Res
     }
 }
 
-fn change_number_of_sides(mut query: Query<&mut Path>, time: Res<Time>) {
+fn change_number_of_sides(mut query: Query<&mut Shape>, time: Res<Time>) {
     let sides = ((time.elapsed_secs_f64() - PI * 2.5).sin() * 2.5 + 5.5).round() as usize;
 
     for mut path in query.iter_mut() {
diff --git a/src/entity.rs b/src/entity.rs
index 182dcaa..954fce9 100644
--- a/src/entity.rs
+++ b/src/entity.rs
@@ -9,7 +9,7 @@ use crate::{geometry::Geometry, plugin::COLOR_MATERIAL_HANDLE};
 #[allow(missing_docs)]
 #[derive(Bundle, Clone)]
 pub struct ShapeBundle {
-    pub path: Path,
+    pub path: Shape,
     pub mesh: Mesh2d,
     pub material: MeshMaterial2d<ColorMaterial>,
     pub transform: Transform,
@@ -30,9 +30,9 @@ impl Default for ShapeBundle {
 
 #[allow(missing_docs)]
 #[derive(Component, Default, Clone)]
-pub struct Path(pub tess::path::Path);
+pub struct Shape(pub tess::path::Path);
 
-impl Geometry for Path {
+impl Geometry for Shape {
     fn add_geometry(&self, b: &mut tess::path::path::Builder) {
         b.extend_from_paths(&[self.0.as_slice()]);
     }
diff --git a/src/geometry.rs b/src/geometry.rs
index 14a3e9f..832766a 100644
--- a/src/geometry.rs
+++ b/src/geometry.rs
@@ -2,7 +2,7 @@
 
 use lyon_tessellation::path::path::Builder;
 
-use crate::entity::Path;
+use crate::entity::Shape;
 
 /// Structs that implement this trait can be drawn as a shape. See the
 /// [`shapes`](crate::shapes) module for some examples.
@@ -97,8 +97,8 @@ impl GeometryBuilder {
     /// Returns a [`Path`] using the data contained in the geometry
     /// builder.
     #[must_use]
-    pub fn build(self) -> Path {
-        Path(self.0.build())
+    pub fn build(self) -> Shape {
+        Shape(self.0.build())
     }
 
     /// Returns a [`Path`] component with only one geometry.
@@ -122,7 +122,7 @@ impl GeometryBuilder {
     /// }
     /// # bevy::ecs::system::assert_is_system(my_system);
     /// ```
-    pub fn build_as(shape: &impl Geometry) -> Path {
+    pub fn build_as(shape: &impl Geometry) -> Shape {
         Self::new().add(shape).build()
     }
 }
diff --git a/src/lib.rs b/src/lib.rs
index bbce4bb..1d99b22 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -42,7 +42,7 @@ pub mod prelude {
 
     pub use crate::{
         draw::{Fill, Stroke},
-        entity::{Path, ShapeBundle},
+        entity::{Shape, ShapeBundle},
         geometry::{Geometry, GeometryBuilder},
         path::{PathBuilder, ShapePath},
         plugin::ShapePlugin,
diff --git a/src/path.rs b/src/path.rs
index 011bd3b..67216f9 100644
--- a/src/path.rs
+++ b/src/path.rs
@@ -11,7 +11,7 @@ use lyon_tessellation::{
 };
 
 use crate::{
-    entity::Path,
+    entity::Shape,
     geometry::Geometry,
     utils::{ToPoint, ToVector},
 };
@@ -63,8 +63,8 @@ impl ShapePath {
 
     /// Builds the `Path` and returns it.
     #[must_use]
-    pub fn build(self) -> Path {
-        Path(self.0.build())
+    pub fn build(self) -> Shape {
+        Shape(self.0.build())
     }
 
     /// Directly builds a `Path` from a `shape`.
@@ -91,7 +91,7 @@ impl ShapePath {
     /// }
     /// # bevy::ecs::system::assert_is_system(my_system);
     /// ```
-    pub fn build_as(shape: &impl Geometry) -> Path {
+    pub fn build_as(shape: &impl Geometry) -> Shape {
         Self::new().add(shape).build()
     }
 }
@@ -114,8 +114,8 @@ impl PathBuilder {
 
     /// Returns a finalized [`Path`].
     #[must_use]
-    pub fn build(self) -> Path {
-        Path(self.0.build())
+    pub fn build(self) -> Shape {
+        Shape(self.0.build())
     }
 
     /// Moves the current point to the given position.
diff --git a/src/plugin.rs b/src/plugin.rs
index 9c8a715..c239753 100644
--- a/src/plugin.rs
+++ b/src/plugin.rs
@@ -20,7 +20,7 @@ use lyon_tessellation::{self as tess, BuffersBuilder};
 
 use crate::{
     draw::{Fill, Stroke},
-    entity::Path,
+    entity::Shape,
     vertex::{VertexBuffers, VertexConstructor},
 };
 
@@ -68,8 +68,8 @@ fn mesh_shapes_system(
     mut fill_tess: ResMut<FillTessellator>,
     mut stroke_tess: ResMut<StrokeTessellator>,
     mut query: Query<
-        (Option<&Fill>, Option<&Stroke>, &Path, &mut Mesh2d),
-        Or<(Changed<Path>, Changed<Fill>, Changed<Stroke>)>,
+        (Option<&Fill>, Option<&Stroke>, &Shape, &mut Mesh2d),
+        Or<(Changed<Shape>, Changed<Fill>, Changed<Stroke>)>,
     >,
 ) {
     for (maybe_fill_mode, maybe_stroke_mode, path, mut mesh) in &mut query {

From d3b69ca7c26efeb681634478bfad9926f710d23d Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Mon, 9 Dec 2024 18:15:00 +0100
Subject: [PATCH 02/18] Add required components for `Shape`

---
 src/entity.rs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/entity.rs b/src/entity.rs
index 954fce9..207c4b8 100644
--- a/src/entity.rs
+++ b/src/entity.rs
@@ -30,6 +30,7 @@ impl Default for ShapeBundle {
 
 #[allow(missing_docs)]
 #[derive(Component, Default, Clone)]
+#[require(Mesh2d, MeshMaterial2d<ColorMaterial>(color_material_handle), Transform, Visibility)]
 pub struct Shape(pub tess::path::Path);
 
 impl Geometry for Shape {
@@ -37,3 +38,7 @@ impl Geometry for Shape {
         b.extend_from_paths(&[self.0.as_slice()]);
     }
 }
+
+fn color_material_handle() -> MeshMaterial2d<ColorMaterial> {
+    MeshMaterial2d(COLOR_MATERIAL_HANDLE)
+}

From a20459c3679e6b418842d1b4464b894b21b6e1c1 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Mon, 9 Dec 2024 18:34:10 +0100
Subject: [PATCH 03/18] Make examples use Required Components

---
 examples/dynamic_shape.rs   |  5 +----
 examples/path.rs            |  8 ++-----
 examples/readme.rs          |  5 +----
 examples/rectangle.rs       |  5 +----
 examples/rounded_polygon.rs |  8 +------
 examples/svg.rs             | 44 ++++++++++++++-----------------------
 6 files changed, 22 insertions(+), 53 deletions(-)

diff --git a/examples/dynamic_shape.rs b/examples/dynamic_shape.rs
index 2417edd..7b842f2 100644
--- a/examples/dynamic_shape.rs
+++ b/examples/dynamic_shape.rs
@@ -57,10 +57,7 @@ fn setup_system(mut commands: Commands) {
 
     commands.spawn((Camera2d, Msaa::Sample4));
     commands.spawn((
-        ShapeBundle {
-            path: GeometryBuilder::build_as(&shape),
-            ..default()
-        },
+        GeometryBuilder::build_as(&shape),
         Fill::color(DARK_CYAN),
         Stroke::new(BLACK, 10.0),
         ExampleShape,
diff --git a/examples/path.rs b/examples/path.rs
index 29143d1..1833694 100644
--- a/examples/path.rs
+++ b/examples/path.rs
@@ -26,12 +26,8 @@ fn setup_system(mut commands: Commands) {
 
     commands.spawn((Camera2d, Msaa::Sample4));
     commands.spawn((
-        ShapeBundle {
-            path,
-            transform: Transform::from_xyz(0., 75., 0.),
-            visibility: default(),
-            ..default()
-        },
+        path,
+        Transform::from_xyz(0., 75., 0.),
         Stroke::new(BLACK, 10.0),
         Fill::color(RED),
     ));
diff --git a/examples/readme.rs b/examples/readme.rs
index 4c7b139..02d4382 100644
--- a/examples/readme.rs
+++ b/examples/readme.rs
@@ -20,10 +20,7 @@ fn setup_system(mut commands: Commands) {
 
     commands.spawn((Camera2d, Msaa::Sample4));
     commands.spawn((
-        ShapeBundle {
-            path: GeometryBuilder::build_as(&shape),
-            ..default()
-        },
+        GeometryBuilder::build_as(&shape),
         Fill::color(DARK_CYAN),
         Stroke::new(BLACK, 10.0),
     ));
diff --git a/examples/rectangle.rs b/examples/rectangle.rs
index 932e5c2..691cbc4 100644
--- a/examples/rectangle.rs
+++ b/examples/rectangle.rs
@@ -17,10 +17,7 @@ fn setup_system(mut commands: Commands) {
 
     commands.spawn((Camera2d, Msaa::Sample4));
     commands.spawn((
-        ShapeBundle {
-            path: GeometryBuilder::build_as(&rect),
-            ..default()
-        },
+        GeometryBuilder::build_as(&rect),
         Stroke::new(BLACK, 10.0),
         Fill::color(RED),
     ));
diff --git a/examples/rounded_polygon.rs b/examples/rounded_polygon.rs
index c48ebfe..9e7f2b6 100644
--- a/examples/rounded_polygon.rs
+++ b/examples/rounded_polygon.rs
@@ -27,11 +27,5 @@ fn setup_system(mut commands: Commands) {
     };
 
     commands.spawn((Camera2d, Msaa::Sample4));
-    commands.spawn((
-        ShapeBundle {
-            path: GeometryBuilder::build_as(&shape),
-            ..default()
-        },
-        Fill::color(DARK_CYAN),
-    ));
+    commands.spawn((GeometryBuilder::build_as(&shape), Fill::color(DARK_CYAN)));
 }
diff --git a/examples/svg.rs b/examples/svg.rs
index 09d1539..0ba0b6e 100644
--- a/examples/svg.rs
+++ b/examples/svg.rs
@@ -31,23 +31,17 @@ fn setup_system(mut commands: Commands) {
         .with_children(|parent| {
             let svg_doc_size = Vec2::new(512., 512.);
             parent.spawn((
-                ShapeBundle {
-                    path: GeometryBuilder::build_as(&shapes::SvgPathShape {
-                        svg_path_string: BLACKSMITH_OUTLINE.to_owned(),
-                        svg_doc_size_in_px: svg_doc_size.to_owned(),
-                    }),
-                    ..default()
-                },
+                GeometryBuilder::build_as(&shapes::SvgPathShape {
+                    svg_path_string: BLACKSMITH_OUTLINE.to_owned(),
+                    svg_doc_size_in_px: svg_doc_size.to_owned(),
+                }),
                 Stroke::new(Color::BLACK, 4.0),
             ));
             parent.spawn((
-                ShapeBundle {
-                    path: GeometryBuilder::build_as(&shapes::SvgPathShape {
-                        svg_path_string: BLACKSMITH_DETAIL.to_owned(),
-                        svg_doc_size_in_px: svg_doc_size.to_owned(),
-                    }),
-                    ..default()
-                },
+                GeometryBuilder::build_as(&shapes::SvgPathShape {
+                    svg_path_string: BLACKSMITH_DETAIL.to_owned(),
+                    svg_doc_size_in_px: svg_doc_size.to_owned(),
+                }),
                 Stroke::new(Color::BLACK, 2.5),
             ));
         });
@@ -70,25 +64,19 @@ fn setup_system(mut commands: Commands) {
         .with_children(|parent| {
             let svg_doc_size = Vec2::new(1000., 1000.);
             parent.spawn((
-                ShapeBundle {
-                    path: GeometryBuilder::build_as(&shapes::SvgPathShape {
-                        svg_path_string: SHACK.to_owned(),
-                        svg_doc_size_in_px: svg_doc_size.to_owned(),
-                    }),
-                    ..default()
-                },
+                GeometryBuilder::build_as(&shapes::SvgPathShape {
+                    svg_path_string: SHACK.to_owned(),
+                    svg_doc_size_in_px: svg_doc_size.to_owned(),
+                }),
                 Stroke::new(Color::BLACK, 20.0),
             ));
 
             // shack walls
             parent.spawn((
-                ShapeBundle {
-                    path: GeometryBuilder::build_as(&shapes::SvgPathShape {
-                        svg_path_string: SHACK_WALLS.to_owned(),
-                        svg_doc_size_in_px: svg_doc_size.to_owned(),
-                    }),
-                    ..default()
-                },
+                GeometryBuilder::build_as(&shapes::SvgPathShape {
+                    svg_path_string: SHACK_WALLS.to_owned(),
+                    svg_doc_size_in_px: svg_doc_size.to_owned(),
+                }),
                 Stroke::new(Color::BLACK, 17.5),
             ));
         });

From a44f48da12deba8e51e06666a7071b6627233b34 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Mon, 9 Dec 2024 18:50:21 +0100
Subject: [PATCH 04/18] Update example in `README.md`

---
 README.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/README.md b/README.md
index e496804..90da807 100644
--- a/README.md
+++ b/README.md
@@ -45,10 +45,7 @@ fn setup_system(mut commands: Commands) {
 
     commands.spawn((Camera2d, Msaa::Sample4));
     commands.spawn((
-        ShapeBundle {
-            path: GeometryBuilder::build_as(&shape),
-            ..default()
-        },
+        GeometryBuilder::build_as(&shape),
         Fill::color(DARK_CYAN),
         Stroke::new(BLACK, 10.0),
     ));

From 0dd36b3bddcedbfd5c00daf477af3b60269a4667 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Mon, 9 Dec 2024 19:38:03 +0100
Subject: [PATCH 05/18] Make tests use Required Components

---
 src/geometry.rs | 16 +++++-----------
 src/path.rs     |  8 ++++----
 2 files changed, 9 insertions(+), 15 deletions(-)

diff --git a/src/geometry.rs b/src/geometry.rs
index 832766a..fcd7ce2 100644
--- a/src/geometry.rs
+++ b/src/geometry.rs
@@ -66,7 +66,7 @@ impl GeometryBuilder {
     /// ```
     /// # use bevy::prelude::*;
     /// # use bevy_prototype_lyon::prelude::*;
-    /// # use bevy::color::palettes;
+    /// # use bevy::color::palettes::css::*;
     /// #
     /// fn my_system(mut commands: Commands) {
     ///     let line = shapes::Line(Vec2::ZERO, Vec2::new(10.0, 0.0));
@@ -77,12 +77,9 @@ impl GeometryBuilder {
     ///     let mut builder = GeometryBuilder::new().add(&line).add(&square);
     ///
     ///     commands.spawn((
-    ///         ShapeBundle {
-    ///             path: builder.build(),
-    ///             ..default()
-    ///         },
-    ///         Fill::color(Color::Srgba(palettes::css::ORANGE_RED)),
-    ///         Stroke::new(Color::Srgba(palettes::css::ORANGE_RED), 10.0),
+    ///         builder.build(),
+    ///         Fill::color(ORANGE_RED),
+    ///         Stroke::new(ORANGE_RED, 10.0),
     ///     ));
     /// }
     /// # bevy::ecs::system::assert_is_system(my_system);
@@ -113,10 +110,7 @@ impl GeometryBuilder {
     /// fn my_system(mut commands: Commands) {
     ///     let line = shapes::Line(Vec2::ZERO, Vec2::new(10.0, 0.0));
     ///     commands.spawn((
-    ///         ShapeBundle {
-    ///             path: GeometryBuilder::build_as(&line),
-    ///             ..default()
-    ///         },
+    ///         GeometryBuilder::build_as(&line),
     ///         Fill::color(Color::Srgba(palettes::css::ORANGE_RED)),
     ///     ));
     /// }
diff --git a/src/path.rs b/src/path.rs
index 67216f9..f801bd7 100644
--- a/src/path.rs
+++ b/src/path.rs
@@ -37,7 +37,7 @@ impl ShapePath {
     /// # #[derive(Component)]
     /// # struct Player;
     /// #
-    /// fn my_system(mut query: Query<&mut Path, With<Player>>) {
+    /// fn my_system(mut query: Query<&mut Shape, With<Player>>) {
     ///     let mut path = query.single_mut();
     ///
     ///     let square = shapes::Rectangle {
@@ -61,13 +61,13 @@ impl ShapePath {
         self
     }
 
-    /// Builds the `Path` and returns it.
+    /// Builds the `Shape` and returns it.
     #[must_use]
     pub fn build(self) -> Shape {
         Shape(self.0.build())
     }
 
-    /// Directly builds a `Path` from a `shape`.
+    /// Directly builds a `Shape` from a `Geometry`.
     ///
     /// # Example
     ///
@@ -78,7 +78,7 @@ impl ShapePath {
     /// # #[derive(Component)]
     /// # struct Player;
     /// #
-    /// fn my_system(mut query: Query<&mut Path, With<Player>>) {
+    /// fn my_system(mut query: Query<&mut Shape, With<Player>>) {
     ///     let mut path = query.single_mut();
     ///
     ///     let triangle = RegularPolygon {

From d2dc33d63acec2a7c586a1c1a6f8f7f2608a4422 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Mon, 9 Dec 2024 19:38:48 +0100
Subject: [PATCH 06/18] Deprecate ShapeBundle and remove it from prelude

---
 src/entity.rs | 2 ++
 src/lib.rs    | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/entity.rs b/src/entity.rs
index 207c4b8..d3a9579 100644
--- a/src/entity.rs
+++ b/src/entity.rs
@@ -1,4 +1,5 @@
 //! Custom Bevy ECS bundle for shapes.
+#![expect(deprecated)]
 
 use bevy::prelude::*;
 use lyon_tessellation::{self as tess};
@@ -6,6 +7,7 @@ use lyon_tessellation::{self as tess};
 use crate::{geometry::Geometry, plugin::COLOR_MATERIAL_HANDLE};
 
 /// A Bevy `Bundle` to represent a shape.
+#[deprecated(since = "0.14.0", note = "please use the `Shape` component instead.")]
 #[allow(missing_docs)]
 #[derive(Bundle, Clone)]
 pub struct ShapeBundle {
diff --git a/src/lib.rs b/src/lib.rs
index 1d99b22..326adae 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -42,7 +42,7 @@ pub mod prelude {
 
     pub use crate::{
         draw::{Fill, Stroke},
-        entity::{Shape, ShapeBundle},
+        entity::Shape,
         geometry::{Geometry, GeometryBuilder},
         path::{PathBuilder, ShapePath},
         plugin::ShapePlugin,

From 6149200103452cfbdc8d667ab1540a7cfebf51ba Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Mon, 9 Dec 2024 20:42:55 +0100
Subject: [PATCH 07/18] Update doc comments

---
 src/geometry.rs |  4 ++--
 src/path.rs     |  2 +-
 src/plugin.rs   | 11 ++---------
 3 files changed, 5 insertions(+), 12 deletions(-)

diff --git a/src/geometry.rs b/src/geometry.rs
index fcd7ce2..62e77bf 100644
--- a/src/geometry.rs
+++ b/src/geometry.rs
@@ -91,14 +91,14 @@ impl GeometryBuilder {
         self
     }
 
-    /// Returns a [`Path`] using the data contained in the geometry
+    /// Returns a [`Shape`] using the data contained in the geometry
     /// builder.
     #[must_use]
     pub fn build(self) -> Shape {
         Shape(self.0.build())
     }
 
-    /// Returns a [`Path`] component with only one geometry.
+    /// Returns a [`Shape`] component with only one geometry.
     ///
     /// # Example
     ///
diff --git a/src/path.rs b/src/path.rs
index f801bd7..d928d75 100644
--- a/src/path.rs
+++ b/src/path.rs
@@ -112,7 +112,7 @@ impl PathBuilder {
         Self(Builder::new().with_svg())
     }
 
-    /// Returns a finalized [`Path`].
+    /// Returns a finalized [`Shape`].
     #[must_use]
     pub fn build(self) -> Shape {
         Shape(self.0.build())
diff --git a/src/plugin.rs b/src/plugin.rs
index c239753..3975342 100644
--- a/src/plugin.rs
+++ b/src/plugin.rs
@@ -2,14 +2,6 @@
 //!
 //! The [`ShapePlugin`] provides the creation of shapes with minimal
 //! boilerplate.
-//!
-//! ## How it works
-//! The user spawns a [`ShapeBundle`](crate::entity::ShapeBundle) from a
-//! system in the `UPDATE` stage.
-//!
-//! Then, in [`Stage::Shape`] stage, there is a system
-//! that creates a mesh for each entity that has been spawned as a
-//! `ShapeBundle`.
 
 use bevy::{
     color::palettes,
@@ -60,7 +52,8 @@ impl Plugin for ShapePlugin {
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, SystemSet)]
 pub struct BuildShapes;
 
-/// Queries all the [`ShapeBundle`]s to mesh them when they are added
+/// Queries all the [`Shape`]s and their related components
+/// to mesh them when they are added
 /// or re-mesh them when they are changed.
 #[allow(clippy::type_complexity)]
 fn mesh_shapes_system(

From 417389867d78bb72b2e801c89262c0919204a0f0 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Tue, 10 Dec 2024 10:42:38 +0100
Subject: [PATCH 08/18] Include fill and stroke data (stub) into `Shape`
 component

---
 src/draw.rs     | 18 ++++++++++++++++++
 src/entity.rs   | 36 ++++++++++++++++++++++++++++++++----
 src/geometry.rs | 11 +++++++++--
 src/path.rs     | 13 +++++++++++--
 src/plugin.rs   | 33 +++++++++++----------------------
 5 files changed, 81 insertions(+), 30 deletions(-)

diff --git a/src/draw.rs b/src/draw.rs
index 3b241fd..cfe3267 100644
--- a/src/draw.rs
+++ b/src/draw.rs
@@ -23,6 +23,15 @@ impl Fill {
     }
 }
 
+impl Default for Fill {
+    fn default() -> Self {
+        Self {
+            options: FillOptions::default(),
+            color: bevy::color::palettes::css::WHITE.into(),
+        }
+    }
+}
+
 /// Defines the stroke options for the lyon tessellator and color of the
 /// generated vertices.
 #[allow(missing_docs)]
@@ -51,3 +60,12 @@ impl Stroke {
         }
     }
 }
+
+impl Default for Stroke {
+    fn default() -> Self {
+        Self {
+            options: StrokeOptions::default(),
+            color: bevy::color::palettes::css::BLACK.into(),
+        }
+    }
+}
diff --git a/src/entity.rs b/src/entity.rs
index d3a9579..5e422f1 100644
--- a/src/entity.rs
+++ b/src/entity.rs
@@ -4,7 +4,11 @@
 use bevy::prelude::*;
 use lyon_tessellation::{self as tess};
 
-use crate::{geometry::Geometry, plugin::COLOR_MATERIAL_HANDLE};
+use crate::{
+    draw::{Fill, Stroke},
+    geometry::Geometry,
+    plugin::COLOR_MATERIAL_HANDLE,
+};
 
 /// A Bevy `Bundle` to represent a shape.
 #[deprecated(since = "0.14.0", note = "please use the `Shape` component instead.")]
@@ -30,14 +34,38 @@ impl Default for ShapeBundle {
     }
 }
 
-#[allow(missing_docs)]
 #[derive(Component, Default, Clone)]
 #[require(Mesh2d, MeshMaterial2d<ColorMaterial>(color_material_handle), Transform, Visibility)]
-pub struct Shape(pub tess::path::Path);
+pub struct Shape {
+    path: tess::path::Path,
+    fill: Option<Fill>,
+    stroke: Option<Stroke>,
+}
+
+impl Shape {
+    pub(crate) fn new(path: tess::path::Path, fill: Option<Fill>, stroke: Option<Stroke>) -> Self {
+        Self { path, fill, stroke }
+    }
+
+    #[allow(clippy::must_use_candidate)]
+    pub fn path_ref(&self) -> &tess::path::Path {
+        &self.path
+    }
+
+    #[allow(clippy::must_use_candidate)]
+    pub fn fill(&self) -> Option<Fill> {
+        self.fill
+    }
+
+    #[allow(clippy::must_use_candidate)]
+    pub fn stroke(&self) -> Option<Stroke> {
+        self.stroke
+    }
+}
 
 impl Geometry for Shape {
     fn add_geometry(&self, b: &mut tess::path::path::Builder) {
-        b.extend_from_paths(&[self.0.as_slice()]);
+        b.extend_from_paths(&[self.path.as_slice()]);
     }
 }
 
diff --git a/src/geometry.rs b/src/geometry.rs
index 62e77bf..1e44d93 100644
--- a/src/geometry.rs
+++ b/src/geometry.rs
@@ -2,7 +2,10 @@
 
 use lyon_tessellation::path::path::Builder;
 
-use crate::entity::Shape;
+use crate::{
+    draw::{Fill, Stroke},
+    entity::Shape,
+};
 
 /// Structs that implement this trait can be drawn as a shape. See the
 /// [`shapes`](crate::shapes) module for some examples.
@@ -95,7 +98,11 @@ impl GeometryBuilder {
     /// builder.
     #[must_use]
     pub fn build(self) -> Shape {
-        Shape(self.0.build())
+        Shape::new(
+            self.0.build(),
+            Some(Fill::default()),
+            Some(Stroke::default()),
+        )
     }
 
     /// Returns a [`Shape`] component with only one geometry.
diff --git a/src/path.rs b/src/path.rs
index d928d75..733f40f 100644
--- a/src/path.rs
+++ b/src/path.rs
@@ -11,6 +11,7 @@ use lyon_tessellation::{
 };
 
 use crate::{
+    draw::{Fill, Stroke},
     entity::Shape,
     geometry::Geometry,
     utils::{ToPoint, ToVector},
@@ -64,7 +65,11 @@ impl ShapePath {
     /// Builds the `Shape` and returns it.
     #[must_use]
     pub fn build(self) -> Shape {
-        Shape(self.0.build())
+        Shape::new(
+            self.0.build(),
+            Some(Fill::default()),
+            Some(Stroke::default()),
+        )
     }
 
     /// Directly builds a `Shape` from a `Geometry`.
@@ -115,7 +120,11 @@ impl PathBuilder {
     /// Returns a finalized [`Shape`].
     #[must_use]
     pub fn build(self) -> Shape {
-        Shape(self.0.build())
+        Shape::new(
+            self.0.build(),
+            Some(Fill::default()),
+            Some(Stroke::default()),
+        )
     }
 
     /// Moves the current point to the given position.
diff --git a/src/plugin.rs b/src/plugin.rs
index 3975342..0ba9b33 100644
--- a/src/plugin.rs
+++ b/src/plugin.rs
@@ -4,7 +4,6 @@
 //! boilerplate.
 
 use bevy::{
-    color::palettes,
     prelude::*,
     render::{mesh::Indices, render_asset::RenderAssetUsages, render_resource::PrimitiveTopology},
 };
@@ -60,31 +59,21 @@ fn mesh_shapes_system(
     mut meshes: ResMut<Assets<Mesh>>,
     mut fill_tess: ResMut<FillTessellator>,
     mut stroke_tess: ResMut<StrokeTessellator>,
-    mut query: Query<
-        (Option<&Fill>, Option<&Stroke>, &Shape, &mut Mesh2d),
-        Or<(Changed<Shape>, Changed<Fill>, Changed<Stroke>)>,
-    >,
+    mut query: Query<(&Shape, &mut Mesh2d), Changed<Shape>>,
 ) {
-    for (maybe_fill_mode, maybe_stroke_mode, path, mut mesh) in &mut query {
+    for (shape, mut mesh) in &mut query {
         let mut buffers = VertexBuffers::new();
-
-        if let Some(fill_mode) = maybe_fill_mode {
-            fill(&mut fill_tess, &path.0, fill_mode, &mut buffers);
-        }
-
-        if let Some(stroke_mode) = maybe_stroke_mode {
-            stroke(&mut stroke_tess, &path.0, stroke_mode, &mut buffers);
+        if let Some(fill_mode) = shape.fill() {
+            fill(&mut fill_tess, shape.path_ref(), fill_mode, &mut buffers);
         }
-
-        if (maybe_fill_mode, maybe_stroke_mode) == (None, None) {
-            fill(
-                &mut fill_tess,
-                &path.0,
-                &Fill::color(Color::Srgba(palettes::css::FUCHSIA)),
+        if let Some(stroke_mode) = shape.stroke() {
+            stroke(
+                &mut stroke_tess,
+                shape.path_ref(),
+                stroke_mode,
                 &mut buffers,
             );
         }
-
         mesh.0 = meshes.add(build_mesh(&buffers));
     }
 }
@@ -93,7 +82,7 @@ fn mesh_shapes_system(
 fn fill(
     tess: &mut ResMut<FillTessellator>,
     path: &tess::path::Path,
-    mode: &Fill,
+    mode: Fill,
     buffers: &mut VertexBuffers,
 ) {
     if let Err(e) = tess.tessellate_path(
@@ -109,7 +98,7 @@ fn fill(
 fn stroke(
     tess: &mut ResMut<StrokeTessellator>,
     path: &tess::path::Path,
-    mode: &Stroke,
+    mode: Stroke,
     buffers: &mut VertexBuffers,
 ) {
     if let Err(e) = tess.tessellate_path(

From 1b44cbd08dffb5e269cade54cc968ad2b886fa70 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Tue, 10 Dec 2024 20:25:28 +0100
Subject: [PATCH 09/18] Add `ShapeBuilder`

---
 src/draw.rs     | 137 +++++++++++++++++++++++++++++++++++++++++++++++-
 src/geometry.rs |  89 +++++++++++++++++++++++++++++++
 src/lib.rs      |   2 +-
 3 files changed, 226 insertions(+), 2 deletions(-)

diff --git a/src/draw.rs b/src/draw.rs
index cfe3267..358a600 100644
--- a/src/draw.rs
+++ b/src/draw.rs
@@ -1,6 +1,9 @@
 //! Types for defining shape color and options.
 
-use bevy::{color::Color, ecs::component::Component};
+use bevy::{
+    color::{Color, Hsla, Hsva, Hwba, Laba, Lcha, LinearRgba, Oklaba, Oklcha, Srgba, Xyza},
+    ecs::component::Component,
+};
 use lyon_tessellation::{FillOptions, StrokeOptions};
 
 /// Defines the fill options for the lyon tessellator and color of the generated
@@ -32,6 +35,72 @@ impl Default for Fill {
     }
 }
 
+impl From<Color> for Fill {
+    fn from(color: Color) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Srgba> for Fill {
+    fn from(color: Srgba) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<LinearRgba> for Fill {
+    fn from(color: LinearRgba) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Hsla> for Fill {
+    fn from(color: Hsla) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Hsva> for Fill {
+    fn from(color: Hsva) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Hwba> for Fill {
+    fn from(color: Hwba) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Laba> for Fill {
+    fn from(color: Laba) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Lcha> for Fill {
+    fn from(color: Lcha) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Oklaba> for Fill {
+    fn from(color: Oklaba) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Oklcha> for Fill {
+    fn from(color: Oklcha) -> Self {
+        Self::color(color)
+    }
+}
+
+impl From<Xyza> for Fill {
+    fn from(color: Xyza) -> Self {
+        Self::color(color)
+    }
+}
+
 /// Defines the stroke options for the lyon tessellator and color of the
 /// generated vertices.
 #[allow(missing_docs)]
@@ -69,3 +138,69 @@ impl Default for Stroke {
         }
     }
 }
+
+impl From<(Color, f32)> for Stroke {
+    fn from(value: (Color, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Srgba, f32)> for Stroke {
+    fn from(value: (Srgba, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(LinearRgba, f32)> for Stroke {
+    fn from(value: (LinearRgba, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Hsla, f32)> for Stroke {
+    fn from(value: (Hsla, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Hsva, f32)> for Stroke {
+    fn from(value: (Hsva, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Hwba, f32)> for Stroke {
+    fn from(value: (Hwba, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Laba, f32)> for Stroke {
+    fn from(value: (Laba, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Lcha, f32)> for Stroke {
+    fn from(value: (Lcha, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Oklaba, f32)> for Stroke {
+    fn from(value: (Oklaba, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Oklcha, f32)> for Stroke {
+    fn from(value: (Oklcha, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
+
+impl From<(Xyza, f32)> for Stroke {
+    fn from(value: (Xyza, f32)) -> Self {
+        Self::new(value.0, value.1)
+    }
+}
diff --git a/src/geometry.rs b/src/geometry.rs
index 1e44d93..91d30a7 100644
--- a/src/geometry.rs
+++ b/src/geometry.rs
@@ -133,3 +133,92 @@ impl Default for GeometryBuilder {
         Self::new()
     }
 }
+
+pub trait ShapeBuilderBase {
+    /// Adds a `Geometry` to the builder.
+    #[must_use]
+    fn add(self, shape: &impl Geometry) -> Self;
+
+    /// Sets the fill mode of the builder.
+    #[must_use]
+    fn fill(self, fill: impl Into<Fill>) -> ReadyShapeBuilder;
+
+    /// Sets the stroke mode of the builder.
+    #[must_use]
+    fn stroke(self, stroke: impl Into<Stroke>) -> ReadyShapeBuilder;
+}
+
+#[derive(Default, Clone)]
+pub struct ShapeBuilder(Builder);
+
+impl ShapeBuilderBase for ShapeBuilder {
+    fn add(mut self, shape: &impl Geometry) -> Self {
+        shape.add_geometry(&mut self.0);
+        self
+    }
+
+    fn fill(self, fill: impl Into<Fill>) -> ReadyShapeBuilder {
+        ReadyShapeBuilder {
+            builder: self.0,
+            fill: Some(fill.into()),
+            stroke: None,
+        }
+    }
+
+    fn stroke(self, stroke: impl Into<Stroke>) -> ReadyShapeBuilder {
+        ReadyShapeBuilder {
+            builder: self.0,
+            fill: None,
+            stroke: Some(stroke.into()),
+        }
+    }
+}
+
+impl ShapeBuilder {
+    /// Constructs a new `ShapeBuilder`.
+    #[must_use]
+    pub fn new() -> Self {
+        Self(Builder::new())
+    }
+
+    /// Constructs a new `ShapeBuilder` with an initial `Geometry`.
+    #[must_use]
+    pub fn with(geometry: &impl Geometry) -> Self {
+        Self::new().add(geometry)
+    }
+}
+
+#[derive(Clone)]
+pub struct ReadyShapeBuilder {
+    pub(crate) builder: Builder,
+    pub(crate) fill: Option<Fill>,
+    pub(crate) stroke: Option<Stroke>,
+}
+
+impl ShapeBuilderBase for ReadyShapeBuilder {
+    fn add(mut self, shape: &impl Geometry) -> Self {
+        shape.add_geometry(&mut self.builder);
+        self
+    }
+
+    fn fill(self, fill: impl Into<Fill>) -> ReadyShapeBuilder {
+        Self {
+            fill: Some(fill.into()),
+            ..self
+        }
+    }
+
+    fn stroke(self, stroke: impl Into<Stroke>) -> ReadyShapeBuilder {
+        Self {
+            stroke: Some(stroke.into()),
+            ..self
+        }
+    }
+}
+impl ReadyShapeBuilder {
+    /// Builds a `Shape` according to the builder's settings.
+    #[allow(clippy::must_use_candidate)]
+    pub fn build(self) -> Shape {
+        Shape::new(self.builder.build(), self.fill, self.stroke)
+    }
+}
diff --git a/src/lib.rs b/src/lib.rs
index 326adae..6503155 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -43,7 +43,7 @@ pub mod prelude {
     pub use crate::{
         draw::{Fill, Stroke},
         entity::Shape,
-        geometry::{Geometry, GeometryBuilder},
+        geometry::{Geometry, GeometryBuilder, ShapeBuilder, ShapeBuilderBase},
         path::{PathBuilder, ShapePath},
         plugin::ShapePlugin,
         shapes::{self, BorderRadii, RectangleOrigin, RegularPolygon, RegularPolygonFeature},

From 7c496720b5ffa6a9aa28ef3e873fa2552d392120 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Tue, 10 Dec 2024 20:25:52 +0100
Subject: [PATCH 10/18] Make examples use ShapeBuilder

---
 examples/dynamic_shape.rs   |  7 +++--
 examples/readme.rs          | 11 +++----
 examples/rectangle.rs       | 11 +++----
 examples/rounded_polygon.rs |  2 +-
 examples/svg.rs             | 59 +++++++++++++++++++------------------
 5 files changed, 48 insertions(+), 42 deletions(-)

diff --git a/examples/dynamic_shape.rs b/examples/dynamic_shape.rs
index 7b842f2..591a5a7 100644
--- a/examples/dynamic_shape.rs
+++ b/examples/dynamic_shape.rs
@@ -57,9 +57,10 @@ fn setup_system(mut commands: Commands) {
 
     commands.spawn((Camera2d, Msaa::Sample4));
     commands.spawn((
-        GeometryBuilder::build_as(&shape),
-        Fill::color(DARK_CYAN),
-        Stroke::new(BLACK, 10.0),
+        ShapeBuilder::with(&shape)
+            .fill(DARK_CYAN)
+            .stroke((BLACK, 10.0))
+            .build(),
         ExampleShape,
     ));
 }
diff --git a/examples/readme.rs b/examples/readme.rs
index 02d4382..8c60454 100644
--- a/examples/readme.rs
+++ b/examples/readme.rs
@@ -19,9 +19,10 @@ fn setup_system(mut commands: Commands) {
     };
 
     commands.spawn((Camera2d, Msaa::Sample4));
-    commands.spawn((
-        GeometryBuilder::build_as(&shape),
-        Fill::color(DARK_CYAN),
-        Stroke::new(BLACK, 10.0),
-    ));
+    commands.spawn(
+        ShapeBuilder::with(&shape)
+            .fill(DARK_CYAN)
+            .stroke((BLACK, 10.0))
+            .build(),
+    );
 }
diff --git a/examples/rectangle.rs b/examples/rectangle.rs
index 691cbc4..f3dfcd4 100644
--- a/examples/rectangle.rs
+++ b/examples/rectangle.rs
@@ -16,9 +16,10 @@ fn setup_system(mut commands: Commands) {
     };
 
     commands.spawn((Camera2d, Msaa::Sample4));
-    commands.spawn((
-        GeometryBuilder::build_as(&rect),
-        Stroke::new(BLACK, 10.0),
-        Fill::color(RED),
-    ));
+    commands.spawn(
+        ShapeBuilder::with(&rect)
+            .stroke((BLACK, 10.0))
+            .fill(RED)
+            .build(),
+    );
 }
diff --git a/examples/rounded_polygon.rs b/examples/rounded_polygon.rs
index 9e7f2b6..00c9656 100644
--- a/examples/rounded_polygon.rs
+++ b/examples/rounded_polygon.rs
@@ -27,5 +27,5 @@ fn setup_system(mut commands: Commands) {
     };
 
     commands.spawn((Camera2d, Msaa::Sample4));
-    commands.spawn((GeometryBuilder::build_as(&shape), Fill::color(DARK_CYAN)));
+    commands.spawn(ShapeBuilder::with(&shape).fill(DARK_CYAN).build());
 }
diff --git a/examples/svg.rs b/examples/svg.rs
index 0ba0b6e..1ffc335 100644
--- a/examples/svg.rs
+++ b/examples/svg.rs
@@ -30,20 +30,18 @@ fn setup_system(mut commands: Commands) {
         //the art style was approximated from https://www.kenney.nl/assets/cartography-pack
         .with_children(|parent| {
             let svg_doc_size = Vec2::new(512., 512.);
-            parent.spawn((
-                GeometryBuilder::build_as(&shapes::SvgPathShape {
-                    svg_path_string: BLACKSMITH_OUTLINE.to_owned(),
-                    svg_doc_size_in_px: svg_doc_size.to_owned(),
-                }),
-                Stroke::new(Color::BLACK, 4.0),
-            ));
-            parent.spawn((
-                GeometryBuilder::build_as(&shapes::SvgPathShape {
-                    svg_path_string: BLACKSMITH_DETAIL.to_owned(),
-                    svg_doc_size_in_px: svg_doc_size.to_owned(),
-                }),
-                Stroke::new(Color::BLACK, 2.5),
-            ));
+
+            let svg = shapes::SvgPathShape {
+                svg_path_string: BLACKSMITH_OUTLINE.to_owned(),
+                svg_doc_size_in_px: svg_doc_size.to_owned(),
+            };
+            parent.spawn(ShapeBuilder::with(&svg).stroke((Color::BLACK, 4.0)).build());
+
+            let svg = shapes::SvgPathShape {
+                svg_path_string: BLACKSMITH_DETAIL.to_owned(),
+                svg_doc_size_in_px: svg_doc_size.to_owned(),
+            };
+            parent.spawn(ShapeBuilder::with(&svg).stroke((Color::BLACK, 2.5)).build());
         });
 
     commands
@@ -63,22 +61,27 @@ fn setup_system(mut commands: Commands) {
         //the art style was approximated from https://www.kenney.nl/assets/cartography-pack
         .with_children(|parent| {
             let svg_doc_size = Vec2::new(1000., 1000.);
-            parent.spawn((
-                GeometryBuilder::build_as(&shapes::SvgPathShape {
-                    svg_path_string: SHACK.to_owned(),
-                    svg_doc_size_in_px: svg_doc_size.to_owned(),
-                }),
-                Stroke::new(Color::BLACK, 20.0),
-            ));
+
+            let svg = shapes::SvgPathShape {
+                svg_path_string: SHACK.to_owned(),
+                svg_doc_size_in_px: svg_doc_size.to_owned(),
+            };
+            parent.spawn(
+                ShapeBuilder::with(&svg)
+                    .stroke((Color::BLACK, 20.0))
+                    .build(),
+            );
 
             // shack walls
-            parent.spawn((
-                GeometryBuilder::build_as(&shapes::SvgPathShape {
-                    svg_path_string: SHACK_WALLS.to_owned(),
-                    svg_doc_size_in_px: svg_doc_size.to_owned(),
-                }),
-                Stroke::new(Color::BLACK, 17.5),
-            ));
+            let svg = shapes::SvgPathShape {
+                svg_path_string: SHACK_WALLS.to_owned(),
+                svg_doc_size_in_px: svg_doc_size.to_owned(),
+            };
+            parent.spawn(
+                ShapeBuilder::with(&svg)
+                    .stroke((Color::BLACK, 17.5))
+                    .build(),
+            );
         });
 }
 

From 272ac4cd8379d7a9c4841055d0fb9b8ce878ca0c Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Tue, 10 Dec 2024 20:28:24 +0100
Subject: [PATCH 11/18] Remove `GeometryBuilder`

---
 src/geometry.rs | 82 -------------------------------------------------
 src/lib.rs      |  2 +-
 2 files changed, 1 insertion(+), 83 deletions(-)

diff --git a/src/geometry.rs b/src/geometry.rs
index 91d30a7..a9bec1a 100644
--- a/src/geometry.rs
+++ b/src/geometry.rs
@@ -52,88 +52,6 @@ pub trait Geometry {
     fn add_geometry(&self, b: &mut Builder);
 }
 
-/// Allows the creation of shapes using geometries added to a path builder.
-pub struct GeometryBuilder(Builder);
-
-impl GeometryBuilder {
-    /// Creates a new, empty `GeometryBuilder`.
-    #[must_use]
-    pub fn new() -> Self {
-        Self(Builder::new())
-    }
-
-    /// Adds a geometry to the path builder.
-    ///
-    /// # Example
-    ///
-    /// ```
-    /// # use bevy::prelude::*;
-    /// # use bevy_prototype_lyon::prelude::*;
-    /// # use bevy::color::palettes::css::*;
-    /// #
-    /// fn my_system(mut commands: Commands) {
-    ///     let line = shapes::Line(Vec2::ZERO, Vec2::new(10.0, 0.0));
-    ///     let square = shapes::Rectangle {
-    ///         extents: Vec2::splat(100.0),
-    ///         ..shapes::Rectangle::default()
-    ///     };
-    ///     let mut builder = GeometryBuilder::new().add(&line).add(&square);
-    ///
-    ///     commands.spawn((
-    ///         builder.build(),
-    ///         Fill::color(ORANGE_RED),
-    ///         Stroke::new(ORANGE_RED, 10.0),
-    ///     ));
-    /// }
-    /// # bevy::ecs::system::assert_is_system(my_system);
-    /// ```
-    #[allow(clippy::should_implement_trait)]
-    #[must_use]
-    pub fn add(mut self, shape: &impl Geometry) -> Self {
-        shape.add_geometry(&mut self.0);
-        self
-    }
-
-    /// Returns a [`Shape`] using the data contained in the geometry
-    /// builder.
-    #[must_use]
-    pub fn build(self) -> Shape {
-        Shape::new(
-            self.0.build(),
-            Some(Fill::default()),
-            Some(Stroke::default()),
-        )
-    }
-
-    /// Returns a [`Shape`] component with only one geometry.
-    ///
-    /// # Example
-    ///
-    /// ```
-    /// # use bevy::prelude::*;
-    /// # use bevy_prototype_lyon::prelude::*;
-    /// # use bevy::color::palettes;
-    /// #
-    /// fn my_system(mut commands: Commands) {
-    ///     let line = shapes::Line(Vec2::ZERO, Vec2::new(10.0, 0.0));
-    ///     commands.spawn((
-    ///         GeometryBuilder::build_as(&line),
-    ///         Fill::color(Color::Srgba(palettes::css::ORANGE_RED)),
-    ///     ));
-    /// }
-    /// # bevy::ecs::system::assert_is_system(my_system);
-    /// ```
-    pub fn build_as(shape: &impl Geometry) -> Shape {
-        Self::new().add(shape).build()
-    }
-}
-
-impl Default for GeometryBuilder {
-    fn default() -> Self {
-        Self::new()
-    }
-}
-
 pub trait ShapeBuilderBase {
     /// Adds a `Geometry` to the builder.
     #[must_use]
diff --git a/src/lib.rs b/src/lib.rs
index 6503155..d637645 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -43,7 +43,7 @@ pub mod prelude {
     pub use crate::{
         draw::{Fill, Stroke},
         entity::Shape,
-        geometry::{Geometry, GeometryBuilder, ShapeBuilder, ShapeBuilderBase},
+        geometry::{Geometry, ShapeBuilder, ShapeBuilderBase},
         path::{PathBuilder, ShapePath},
         plugin::ShapePlugin,
         shapes::{self, BorderRadii, RectangleOrigin, RegularPolygon, RegularPolygonFeature},

From a23a35d409656afc095b63141e4ce7dc630dbe16 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Wed, 11 Dec 2024 08:25:11 +0100
Subject: [PATCH 12/18] Document missing items

---
 src/entity.rs   | 6 ++++++
 src/geometry.rs | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/src/entity.rs b/src/entity.rs
index 5e422f1..ed17e7b 100644
--- a/src/entity.rs
+++ b/src/entity.rs
@@ -34,6 +34,9 @@ impl Default for ShapeBundle {
     }
 }
 
+/// `Component` describing a geometric shape.
+///
+/// It can be constructed using `ShapeBuilder`.
 #[derive(Component, Default, Clone)]
 #[require(Mesh2d, MeshMaterial2d<ColorMaterial>(color_material_handle), Transform, Visibility)]
 pub struct Shape {
@@ -47,16 +50,19 @@ impl Shape {
         Self { path, fill, stroke }
     }
 
+    /// Returns the reference to the path of the shape.
     #[allow(clippy::must_use_candidate)]
     pub fn path_ref(&self) -> &tess::path::Path {
         &self.path
     }
 
+    /// Returns the fill options of the shape.
     #[allow(clippy::must_use_candidate)]
     pub fn fill(&self) -> Option<Fill> {
         self.fill
     }
 
+    /// Returns the stroke options of the shape.
     #[allow(clippy::must_use_candidate)]
     pub fn stroke(&self) -> Option<Stroke> {
         self.stroke
diff --git a/src/geometry.rs b/src/geometry.rs
index a9bec1a..c1a9c03 100644
--- a/src/geometry.rs
+++ b/src/geometry.rs
@@ -52,6 +52,8 @@ pub trait Geometry {
     fn add_geometry(&self, b: &mut Builder);
 }
 
+/// Provides basic functionality common
+/// to [`ShapeBuilder`] and [`ReadyShapeBuilder`].
 pub trait ShapeBuilderBase {
     /// Adds a `Geometry` to the builder.
     #[must_use]
@@ -66,6 +68,7 @@ pub trait ShapeBuilderBase {
     fn stroke(self, stroke: impl Into<Stroke>) -> ReadyShapeBuilder;
 }
 
+/// Provides methods for building a shape.
 #[derive(Default, Clone)]
 pub struct ShapeBuilder(Builder);
 
@@ -106,6 +109,9 @@ impl ShapeBuilder {
     }
 }
 
+/// Provides methods for building a shape.
+///
+/// This struct can only be obtained by using [`ShapeBuilder`].
 #[derive(Clone)]
 pub struct ReadyShapeBuilder {
     pub(crate) builder: Builder,

From fb1e0cd594c8b85f9d1f1facc0e7e819cf4f2f59 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Wed, 11 Dec 2024 09:41:51 +0100
Subject: [PATCH 13/18] Update `PathBuilder`

- Added `fill` and `stroke` fields
- Added `fill` and `stroke` setters
- Improved builder pattern by returning `Self` in methods
---
 examples/path.rs | 37 ++++++++++------------
 src/path.rs      | 80 ++++++++++++++++++++++++++++++++++--------------
 2 files changed, 74 insertions(+), 43 deletions(-)

diff --git a/examples/path.rs b/examples/path.rs
index 1833694..62d9eaa 100644
--- a/examples/path.rs
+++ b/examples/path.rs
@@ -9,26 +9,23 @@ fn main() {
 }
 
 fn setup_system(mut commands: Commands) {
-    let mut path_builder = PathBuilder::new();
-    path_builder.move_to(Vec2::new(0., 0.));
-    path_builder.cubic_bezier_to(
-        Vec2::new(70., 70.),
-        Vec2::new(175., -35.),
-        Vec2::new(0., -140.),
-    );
-    path_builder.cubic_bezier_to(
-        Vec2::new(-175., -35.),
-        Vec2::new(-70., 70.),
-        Vec2::new(0., 0.),
-    );
-    path_builder.close();
-    let path = path_builder.build();
+    let shape = PathBuilder::new()
+        .fill(RED)
+        .stroke((BLACK, 10.0))
+        .move_to(Vec2::new(0., 0.))
+        .cubic_bezier_to(
+            Vec2::new(70., 70.),
+            Vec2::new(175., -35.),
+            Vec2::new(0., -140.),
+        )
+        .cubic_bezier_to(
+            Vec2::new(-175., -35.),
+            Vec2::new(-70., 70.),
+            Vec2::new(0., 0.),
+        )
+        .close()
+        .build();
 
     commands.spawn((Camera2d, Msaa::Sample4));
-    commands.spawn((
-        path,
-        Transform::from_xyz(0., 75., 0.),
-        Stroke::new(BLACK, 10.0),
-        Fill::color(RED),
-    ));
+    commands.spawn((shape, Transform::from_xyz(0., 75., 0.)));
 }
diff --git a/src/path.rs b/src/path.rs
index 733f40f..6685621 100644
--- a/src/path.rs
+++ b/src/path.rs
@@ -6,7 +6,6 @@ use lyon_tessellation::{
     path::{
         builder::WithSvg,
         path::{Builder, BuilderImpl},
-        EndpointId,
     },
 };
 
@@ -108,66 +107,101 @@ impl Default for ShapePath {
 }
 
 /// A SVG-like path builder.
-pub struct PathBuilder(WithSvg<BuilderImpl>);
+pub struct PathBuilder {
+    builder: WithSvg<BuilderImpl>,
+    fill: Option<Fill>,
+    stroke: Option<Stroke>,
+}
 
 impl PathBuilder {
     /// Returns a new, empty `PathBuilder`.
     #[must_use]
     pub fn new() -> Self {
-        Self(Builder::new().with_svg())
+        Self {
+            builder: Builder::new().with_svg(),
+            fill: None,
+            stroke: None,
+        }
     }
 
     /// Returns a finalized [`Shape`].
     #[must_use]
     pub fn build(self) -> Shape {
-        Shape::new(
-            self.0.build(),
-            Some(Fill::default()),
-            Some(Stroke::default()),
-        )
+        Shape::new(self.builder.build(), self.fill, self.stroke)
+    }
+
+    /// Sets the fill mode of the path.
+    #[must_use]
+    pub fn fill(self, fill: impl Into<Fill>) -> Self {
+        Self {
+            fill: Some(fill.into()),
+            ..self
+        }
+    }
+
+    /// Sets the stroke mode of the path.
+    #[must_use]
+    pub fn stroke(self, stroke: impl Into<Stroke>) -> Self {
+        Self {
+            stroke: Some(stroke.into()),
+            ..self
+        }
     }
 
     /// Moves the current point to the given position.
-    pub fn move_to(&mut self, to: Vec2) -> EndpointId {
-        self.0.move_to(to.to_point())
+    #[must_use]
+    pub fn move_to(mut self, to: Vec2) -> Self {
+        self.builder.move_to(to.to_point());
+        self
     }
 
     /// Adds to the path a line from the current position to the given one.
-    pub fn line_to(&mut self, to: Vec2) -> EndpointId {
-        self.0.line_to(to.to_point())
+    #[must_use]
+    pub fn line_to(mut self, to: Vec2) -> Self {
+        self.builder.line_to(to.to_point());
+        self
     }
 
     /// Closes the shape, adding to the path a line from the current position to
     /// the starting location.
-    pub fn close(&mut self) {
-        self.0.close();
+    #[must_use]
+    pub fn close(mut self) -> Self {
+        self.builder.close();
+        self
     }
 
     /// Adds a quadratic bezier to the path.
-    pub fn quadratic_bezier_to(&mut self, ctrl: Vec2, to: Vec2) -> EndpointId {
-        self.0.quadratic_bezier_to(ctrl.to_point(), to.to_point())
+    #[must_use]
+    pub fn quadratic_bezier_to(mut self, ctrl: Vec2, to: Vec2) -> Self {
+        self.builder
+            .quadratic_bezier_to(ctrl.to_point(), to.to_point());
+        self
     }
 
     /// Adds a cubic bezier to the path.
-    pub fn cubic_bezier_to(&mut self, ctrl1: Vec2, ctrl2: Vec2, to: Vec2) -> EndpointId {
-        self.0
-            .cubic_bezier_to(ctrl1.to_point(), ctrl2.to_point(), to.to_point())
+    #[must_use]
+    pub fn cubic_bezier_to(mut self, ctrl1: Vec2, ctrl2: Vec2, to: Vec2) -> Self {
+        self.builder
+            .cubic_bezier_to(ctrl1.to_point(), ctrl2.to_point(), to.to_point());
+        self
     }
 
     /// Adds an arc to the path.
-    pub fn arc(&mut self, center: Vec2, radii: Vec2, sweep_angle: f32, x_rotation: f32) {
-        self.0.arc(
+    #[must_use]
+    pub fn arc(mut self, center: Vec2, radii: Vec2, sweep_angle: f32, x_rotation: f32) -> Self {
+        self.builder.arc(
             center.to_point(),
             radii.to_vector(),
             Angle::radians(sweep_angle),
             Angle::radians(x_rotation),
         );
+        self
     }
 
     /// Returns the path's current position.
-    #[must_use]
+    #[allow(clippy::must_use_candidate)]
     pub fn current_position(&self) -> Vec2 {
-        let p = self.0.current_position();
+        let p = self.builder.current_position();
         Vec2::new(p.x, p.y)
     }
 }

From 82af28525a32839f42d08c7808d8c7bd1522a626 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Wed, 11 Dec 2024 10:13:21 +0100
Subject: [PATCH 14/18] Remove `ShapePath`

`ShapePath` is no longer functional
after including fill and stroke data into `Shape`.

Use `ShapeBuilder` or `PathBuilder` instead.
---
 examples/dynamic_shape.rs | 39 ++++++++---------
 src/lib.rs                |  2 +-
 src/path.rs               | 91 ---------------------------------------
 3 files changed, 20 insertions(+), 112 deletions(-)

diff --git a/examples/dynamic_shape.rs b/examples/dynamic_shape.rs
index 591a5a7..8c10401 100644
--- a/examples/dynamic_shape.rs
+++ b/examples/dynamic_shape.rs
@@ -7,8 +7,7 @@ fn main() {
     App::new()
         .add_plugins((DefaultPlugins, ShapePlugin))
         .add_systems(Startup, setup_system)
-        .add_systems(Update, change_draw_mode_system)
-        .add_systems(Update, change_number_of_sides)
+        .add_systems(Update, redraw_shape)
         .add_systems(Update, rotate_shape_system)
         .run();
 }
@@ -24,28 +23,28 @@ fn rotate_shape_system(mut query: Query<&mut Transform, With<ExampleShape>>, tim
     }
 }
 
-fn change_draw_mode_system(mut query: Query<(&mut Fill, &mut Stroke)>, time: Res<Time>) {
+// NOTE: `Fill` and `Stroke` are no longer supposed to be components,
+// therefore they should not be queried for.
+// Instead, query the `Shape` component, and edit the `fill` and `stroke`
+// fields. NOTE: Fuse `change_draw_mode_system` and `change_number_of_sides`
+// systems into a single `redraw_shape` system.
+// This new system uses `ShapePath` to redefine
+fn redraw_shape(mut query: Query<&mut Shape, With<ExampleShape>>, time: Res<Time>) {
     let hue = (time.elapsed_secs_f64() * 50.0) % 360.0;
+    let color = Color::hsl(hue as f32, 1.0, 0.5);
     let outline_width = 2.0 + time.elapsed_secs_f64().sin().abs() * 10.0;
-
-    for (mut fill_mode, mut stroke_mode) in query.iter_mut() {
-        fill_mode.color = Color::hsl(hue as f32, 1.0, 0.5);
-        stroke_mode.options.line_width = outline_width as f32;
-    }
-}
-
-fn change_number_of_sides(mut query: Query<&mut Shape>, time: Res<Time>) {
     let sides = ((time.elapsed_secs_f64() - PI * 2.5).sin() * 2.5 + 5.5).round() as usize;
+    let polygon = shapes::RegularPolygon {
+        sides,
+        feature: shapes::RegularPolygonFeature::Radius(200.0),
+        ..shapes::RegularPolygon::default()
+    };
 
-    for mut path in query.iter_mut() {
-        let polygon = shapes::RegularPolygon {
-            sides,
-            feature: shapes::RegularPolygonFeature::Radius(200.0),
-            ..shapes::RegularPolygon::default()
-        };
-
-        *path = ShapePath::build_as(&polygon);
-    }
+    let mut shape = query.single_mut();
+    *shape = ShapeBuilder::with(&polygon)
+        .fill(color)
+        .stroke((BLACK, outline_width as f32))
+        .build();
 }
 
 fn setup_system(mut commands: Commands) {
diff --git a/src/lib.rs b/src/lib.rs
index d637645..989ce07 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -44,7 +44,7 @@ pub mod prelude {
         draw::{Fill, Stroke},
         entity::Shape,
         geometry::{Geometry, ShapeBuilder, ShapeBuilderBase},
-        path::{PathBuilder, ShapePath},
+        path::PathBuilder,
         plugin::ShapePlugin,
         shapes::{self, BorderRadii, RectangleOrigin, RegularPolygon, RegularPolygonFeature},
     };
diff --git a/src/path.rs b/src/path.rs
index 6685621..904b43b 100644
--- a/src/path.rs
+++ b/src/path.rs
@@ -12,100 +12,9 @@ use lyon_tessellation::{
 use crate::{
     draw::{Fill, Stroke},
     entity::Shape,
-    geometry::Geometry,
     utils::{ToPoint, ToVector},
 };
 
-/// A builder for `Path`s based on shapes implementing [`Geometry`].
-pub struct ShapePath(Builder);
-
-impl ShapePath {
-    /// Returns a new builder.
-    #[must_use]
-    pub fn new() -> Self {
-        Self(Builder::new())
-    }
-
-    /// Adds a shape to the builder.
-    ///
-    /// # Example
-    ///
-    /// ```
-    /// # use bevy::prelude::*;
-    /// # use bevy_prototype_lyon::prelude::{RegularPolygon, *};
-    /// #
-    /// # #[derive(Component)]
-    /// # struct Player;
-    /// #
-    /// fn my_system(mut query: Query<&mut Shape, With<Player>>) {
-    ///     let mut path = query.single_mut();
-    ///
-    ///     let square = shapes::Rectangle {
-    ///         extents: Vec2::splat(50.0),
-    ///         ..shapes::Rectangle::default()
-    ///     };
-    ///     let triangle = RegularPolygon {
-    ///         sides: 3,
-    ///         center: Vec2::new(100.0, 0.0),
-    ///         ..RegularPolygon::default()
-    ///     };
-    ///
-    ///     *path = ShapePath::new().add(&square).add(&triangle).build();
-    /// }
-    /// # bevy::ecs::system::assert_is_system(my_system);
-    /// ```
-    #[allow(clippy::should_implement_trait)]
-    #[must_use]
-    pub fn add(mut self, shape: &impl Geometry) -> Self {
-        shape.add_geometry(&mut self.0);
-        self
-    }
-
-    /// Builds the `Shape` and returns it.
-    #[must_use]
-    pub fn build(self) -> Shape {
-        Shape::new(
-            self.0.build(),
-            Some(Fill::default()),
-            Some(Stroke::default()),
-        )
-    }
-
-    /// Directly builds a `Shape` from a `Geometry`.
-    ///
-    /// # Example
-    ///
-    /// ```
-    /// # use bevy::prelude::*;
-    /// # use bevy_prototype_lyon::prelude::{RegularPolygon, *};
-    /// #
-    /// # #[derive(Component)]
-    /// # struct Player;
-    /// #
-    /// fn my_system(mut query: Query<&mut Shape, With<Player>>) {
-    ///     let mut path = query.single_mut();
-    ///
-    ///     let triangle = RegularPolygon {
-    ///         sides: 3,
-    ///         center: Vec2::new(100.0, 0.0),
-    ///         ..RegularPolygon::default()
-    ///     };
-    ///
-    ///     *path = ShapePath::build_as(&triangle);
-    /// }
-    /// # bevy::ecs::system::assert_is_system(my_system);
-    /// ```
-    pub fn build_as(shape: &impl Geometry) -> Shape {
-        Self::new().add(shape).build()
-    }
-}
-
-impl Default for ShapePath {
-    fn default() -> Self {
-        Self::new()
-    }
-}
-
 /// A SVG-like path builder.
 pub struct PathBuilder {
     builder: WithSvg<BuilderImpl>,

From 2dca999f091fa5c4659a67dd057a73502fa50a42 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Wed, 11 Dec 2024 10:15:17 +0100
Subject: [PATCH 15/18] Remove `Component` impl for `Fill` and `Stroke`

---
 src/draw.rs | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/draw.rs b/src/draw.rs
index 358a600..150116b 100644
--- a/src/draw.rs
+++ b/src/draw.rs
@@ -1,15 +1,12 @@
 //! Types for defining shape color and options.
 
-use bevy::{
-    color::{Color, Hsla, Hsva, Hwba, Laba, Lcha, LinearRgba, Oklaba, Oklcha, Srgba, Xyza},
-    ecs::component::Component,
-};
+use bevy::color::{Color, Hsla, Hsva, Hwba, Laba, Lcha, LinearRgba, Oklaba, Oklcha, Srgba, Xyza};
 use lyon_tessellation::{FillOptions, StrokeOptions};
 
 /// Defines the fill options for the lyon tessellator and color of the generated
 /// vertices.
 #[allow(missing_docs)]
-#[derive(Component, Debug, Clone, Copy, PartialEq)]
+#[derive(Debug, Clone, Copy, PartialEq)]
 pub struct Fill {
     pub options: FillOptions,
     pub color: Color,
@@ -104,7 +101,7 @@ impl From<Xyza> for Fill {
 /// Defines the stroke options for the lyon tessellator and color of the
 /// generated vertices.
 #[allow(missing_docs)]
-#[derive(Component, Debug, Clone, Copy, PartialEq)]
+#[derive(Debug, Clone, Copy, PartialEq)]
 pub struct Stroke {
     pub options: StrokeOptions,
     pub color: Color,

From 6da56090c408442f5d393b91d3cddda278af9f04 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Mon, 9 Dec 2024 20:47:05 +0100
Subject: [PATCH 16/18] Update `CHANGELOG.md`

---
 CHANGELOG.md | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2c35fbc..7b8787c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,22 @@
 # Changelog
 
+## 0.14.0
+
+This version uses Bevy's **Required Components**,
+therefore many items have been changed.
+Examples may help migration.
+
+- `Path` component renamed to `Shape`. It is now the central component of a shape entity.
+- `Shape` now includes fill and stroke data.
+- `Fill` and `Stroke` are no longer `Component`s.
+- Deprecated `ShapeBundle` in favor of the `Shape` component.
+- `prelude` no longer exports `ShapeBundle`.
+- Added `ShapeBuilder`: works similarly to `GeometryBuilder`
+- Removed `GeometryBuilder` and `ShapePath`.
+- `PathBuilder` now allows chaining methods.
+
 ## 0.13.0
-- Support for Bevy 0.15.0-rc.3.
+- Support for Bevy 0.15.0.
 - `Rectangle` now supports border radii (see `rectangle.rs` example).
 - Removed deprecated `SpatialBundle` from `ShapeBundle`: `Transform` and `Visibility` are now added separately.
 

From e9ac23c25a4eb05dda92a5eb5c12544575da21ab Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Wed, 11 Dec 2024 10:47:43 +0100
Subject: [PATCH 17/18] Update `README.md`

---
 README.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 90da807..9c8a41e 100644
--- a/README.md
+++ b/README.md
@@ -44,11 +44,12 @@ fn setup_system(mut commands: Commands) {
     };
 
     commands.spawn((Camera2d, Msaa::Sample4));
-    commands.spawn((
-        GeometryBuilder::build_as(&shape),
-        Fill::color(DARK_CYAN),
-        Stroke::new(BLACK, 10.0),
-    ));
+    commands.spawn(
+        ShapeBuilder::with(&shape)
+            .fill(DARK_CYAN)
+            .stroke((BLACK, 10.0))
+            .build(),
+    );
 }
 ```
 

From defbb127d6e98c4c554d502bac598fc1ffb6c5d9 Mon Sep 17 00:00:00 2001
From: Nilirad <gisquerin@gmail.com>
Date: Wed, 11 Dec 2024 10:49:41 +0100
Subject: [PATCH 18/18] Remove note from `dynamic_shape` example

---
 examples/dynamic_shape.rs | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/examples/dynamic_shape.rs b/examples/dynamic_shape.rs
index 8c10401..f81bd04 100644
--- a/examples/dynamic_shape.rs
+++ b/examples/dynamic_shape.rs
@@ -23,12 +23,6 @@ fn rotate_shape_system(mut query: Query<&mut Transform, With<ExampleShape>>, tim
     }
 }
 
-// NOTE: `Fill` and `Stroke` are no longer supposed to be components,
-// therefore they should not be queried for.
-// Instead, query the `Shape` component, and edit the `fill` and `stroke`
-// fields. NOTE: Fuse `change_draw_mode_system` and `change_number_of_sides`
-// systems into a single `redraw_shape` system.
-// This new system uses `ShapePath` to redefine
 fn redraw_shape(mut query: Query<&mut Shape, With<ExampleShape>>, time: Res<Time>) {
     let hue = (time.elapsed_secs_f64() * 50.0) % 360.0;
     let color = Color::hsl(hue as f32, 1.0, 0.5);