com.artromskiy.deltaecs.unity 0.0.39 → 0.0.40

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.0.40
+
+- Published with the matching DeltaECS NuGet packages.
+
 ## 0.0.39
 
 - Published with the matching DeltaECS NuGet packages.

package/README.md

@@ -18,7 +18,7 @@ Add the npm-compatible registry and package to the Unity project's
     }
   ],
   "dependencies": {
-    "com.artromskiy.deltaecs.unity": "0.0.39"
+    "com.artromskiy.deltaecs.unity": "0.0.40"
   }
 }
 ```
@@ -42,11 +42,24 @@ public struct Health
 }
 ```
 
-Generated module initializers register typed component factories. Create a
-world with the generated layout catalog:
+Generated module initializers expose one registration per marked component.
+Register the full catalog into a layout registry, then create the world:
 
 ```csharp
-using var world = new World(GeneratedComponentCatalog.CreateLayoutRegistry());
+var layouts = new ComponentLayoutRegistry();
+foreach (IGeneratedComponentRegistration registration in GeneratedComponentCatalog.GetRegistrations())
+{
+    layouts.Register(registration);
+}
+
+using var world = new World(layouts);
+```
+
+To register only one generated component, pass its registration directly:
+
+```csharp
+var layouts = new ComponentLayoutRegistry();
+layouts.Register(GeneratedComponentCatalog.GetRegistration<Health>());
 ```
 
 The generator reports the stable schema ID for each component. Set

package/Runtime/SceneWorld.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using Delta.ECS;
 using Delta.ECS.Integration;
 using UnityEngine;
@@ -69,6 +70,20 @@ namespace Delta.ECS.Unity
             return false;
         }
 
+        /// <summary>Resolves the live ECS world and entity currently associated with a Unity view.</summary>
+        public static bool TryGetBoundEntity(GameObject view, [NotNullWhen(true)] out World world, out Entity entity)
+        {
+            if (view != null && TryFindLiveWorld(view, out SceneWorld sceneWorld, out entity))
+            {
+                world = sceneWorld.World;
+                return true;
+            }
+
+            world = null;
+            entity = default;
+            return false;
+        }
+
         public Entity[] AuthoredEntities
         {
             get
@@ -104,7 +119,7 @@ namespace Delta.ECS.Unity
 
         internal static SceneWorld CreatePreview(SceneData sceneData)
         {
-            var world = new World(GeneratedComponentCatalog.CreateLayoutRegistry(), DefaultEntityCapacity);
+            var world = new World(CreateComponentLayouts(), DefaultEntityCapacity);
             try
             {
                 return new SceneWorld(world, sceneData, null,
@@ -124,7 +139,7 @@ namespace Delta.ECS.Unity
                 UnityThrowHelpers.ThrowArgumentNull(nameof(authoring));
             }
 
-            var world = new World(GeneratedComponentCatalog.CreateLayoutRegistry(), DefaultEntityCapacity);
+            var world = new World(CreateComponentLayouts(), DefaultEntityCapacity);
             try
             {
                 return new SceneWorld(world, authoring.SceneData, authoring,
@@ -144,7 +159,7 @@ namespace Delta.ECS.Unity
                 UnityThrowHelpers.ThrowArgumentNull(nameof(authoring));
             }
 
-            var world = new World(GeneratedComponentCatalog.CreateLayoutRegistry(), RuntimeEntityCapacity);
+            var world = new World(CreateComponentLayouts(), RuntimeEntityCapacity);
             try
             {
                 return new SceneWorld(world, authoring.SceneData, authoring,
@@ -157,6 +172,17 @@ namespace Delta.ECS.Unity
             }
         }
 
+        private static ComponentLayoutRegistry CreateComponentLayouts()
+        {
+            var layouts = new ComponentLayoutRegistry();
+            foreach (IGeneratedComponentRegistration registration in GeneratedComponentCatalog.GetRegistrations())
+            {
+                layouts.Register(registration);
+            }
+
+            return layouts;
+        }
+
         internal void RebuildAuthoringEntities()
         {
             ThrowIfDisposed();

package/Runtime/SceneWorldExtensions.cs

@@ -0,0 +1,59 @@
+#nullable enable
+
+using System;
+using System.Diagnostics.CodeAnalysis;
+using Delta.ECS;
+using UnityEngine;
+
+namespace Delta.ECS.Unity
+{
+    public static class SceneWorldExtensions
+    {
+        /// <summary>Returns the entity bound to this GameObject, or the default entity when no binding exists.</summary>
+        /// <param name="world">The bound live ECS world, or <see langword="null"/> when no binding exists.</param>
+        public static Entity GetEntity(this GameObject? view, out World? world)
+        {
+            return TryGetEntity(view, out Entity entity, out world) ? entity : default;
+        }
+
+        /// <summary>Returns whether this GameObject is bound to a live ECS entity.</summary>
+        public static bool TryGetEntity(
+            this GameObject? view,
+            out Entity entity,
+            [NotNullWhen(true)] out World? world)
+        {
+            if (view != null && SceneWorld.TryGetBoundEntity(view, out World boundWorld, out entity))
+            {
+                world = boundWorld;
+                return true;
+            }
+
+            entity = default;
+            world = null;
+            return false;
+        }
+
+        /// <summary>Returns the entity bound to this MonoBehaviour, or the default entity when no binding exists.</summary>
+        /// <param name="world">The bound live ECS world, or <see langword="null"/> when no binding exists.</param>
+        public static Entity GetEntity(this MonoBehaviour? behaviour, out World? world)
+        {
+            return TryGetEntity(behaviour, out Entity entity, out world) ? entity : default;
+        }
+
+        /// <summary>Returns whether this MonoBehaviour is bound to a live ECS entity.</summary>
+        public static bool TryGetEntity(
+            this MonoBehaviour? behaviour,
+            out Entity entity,
+            [NotNullWhen(true)] out World? world)
+        {
+            if (behaviour != null)
+            {
+                return behaviour.gameObject.TryGetEntity(out entity, out world);
+            }
+
+            entity = default;
+            world = null;
+            return false;
+        }
+    }
+}

package/Runtime/SceneWorldExtensions.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: c7f592731c474af6b720a8169c7f4cc1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.artromskiy.deltaecs.unity",
-  "version": "0.0.39",
+  "version": "0.0.40",
   "displayName": "DeltaECS Unity",
   "description": "Unity scene authoring and editor integration for DeltaECS.",
   "unity": "6000.7",