Remote entity reservation v9

crates/bevy_app/src/sub_app.rs

@@ -142,6 +142,7 @@ impl SubApp {
     /// Runs the default schedule and updates internal component trackers.
     pub fn update(&mut self) {
         self.run_default_schedule();
+        self.world.entities().queue_remote_pending_to_be_flushed();
         self.world.clear_trackers();
     }
 

crates/bevy_ecs/src/archetype.rs

@@ -89,6 +89,11 @@ pub struct ArchetypeId(u32);
 impl ArchetypeId {
     /// The ID for the [`Archetype`] without any components.
     pub const EMPTY: ArchetypeId = ArchetypeId(0);
+    /// This represents an archetype that does not actually exist.
+    /// This can be used as a placeholder.
+    ///
+    /// On an entity, this archetype signals that the entity is not yet part of any archetype.
+    ///
     /// # Safety:
     ///
     /// This must always have an all-1s bit pattern to ensure soundness in fast entity id space allocation.

crates/bevy_ecs/src/bundle.rs

@@ -1701,6 +1701,8 @@ impl<'w> BundleSpawner<'w> {
         table.reserve(additional);
     }
 
+    /// **Note:** This will not cause eny entities to be freed.
+    ///
     /// # Safety
     /// `entity` must be allocated (but non-existent), `T` must match this [`BundleInfo`]'s type
     #[inline]