com.artromskiy.deltaecs.unity 0.0.60 → 0.0.62

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.0.62
+
+- Published with the matching DeltaECS NuGet packages.
+
+## 0.0.61
+
+- Published with the matching DeltaECS NuGet packages.
+
 ## 0.0.60
 
 - Published with the matching DeltaECS NuGet packages.

package/Editor/HierarchyNodeHandler.cs

@@ -20,6 +20,7 @@ namespace Delta.ECS.Unity.Editor
     {
         private const double RuntimeHierarchyRefreshInterval = 0.5d;
         private static readonly ComponentId[] NoRequiredComponents = Array.Empty<ComponentId>();
+        private static readonly SchemaId HiddenEntitySchema = new(ViewComponentSchemaIds.HideFromEntityHierarchy);
         private static double _nextRuntimeHierarchyRefresh;
         private static bool _wasPlaying;
         private static readonly HashSet<HierarchyNodeHandler> Instances = new();
@@ -269,6 +270,30 @@ namespace Delta.ECS.Unity.Editor
             return true;
         }
 
+        private static bool IsHiddenFromHierarchy(
+            EntityAuthoring authoring,
+            SceneWorld runtimeWorld,
+            Entity runtimeEntity)
+        {
+            if (runtimeWorld != null && runtimeWorld.World.IsAlive(runtimeEntity))
+            {
+                return runtimeWorld.World.Has(runtimeEntity, runtimeWorld.HiddenEntityHierarchyComponentId);
+            }
+
+            IList<ComponentData> components = authoring.Components;
+            for (int index = 0; index < components.Count; index++)
+            {
+                if (components[index] != null
+                    && components[index].TryGetSchemaId(out SchemaId schema)
+                    && schema == HiddenEntitySchema)
+                {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
         private void BindToView(HierarchyView view) => OnBindView(view);
 
         private void OnEntityNameChanged(ChangeEvent<string> evt)
@@ -458,7 +483,7 @@ namespace Delta.ECS.Unity.Editor
                         || (runtimeWorld != null
                             && runtimeWorld.World.IsAlive(runtimeEntity)
                             && runtimeWorld.TryGetView(runtimeEntity, out _));
-                    if (hasView)
+                    if (hasView || IsHiddenFromHierarchy(authoring, runtimeWorld, runtimeEntity))
                     {
                         continue;
                     }
@@ -569,7 +594,8 @@ namespace Delta.ECS.Unity.Editor
             HierarchyNode sceneNode,
             SceneWorld runtimeWorld)
         {
-            Query query = runtimeWorld.World.WhereAll(NoRequiredComponents);
+            Query query = runtimeWorld.World.WhereNone(runtimeWorld.HiddenEntityHierarchyComponentId)
+                .WhereAll(NoRequiredComponents);
             bool changed = false;
             runtimeWorld.World.ForEachEntity(in query, entity =>
             {

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.60"
+    "com.artromskiy.deltaecs.unity": "0.0.62"
   }
 }
 ```

package/Runtime/SceneWorld.cs

@@ -29,9 +29,11 @@ namespace Delta.ECS.Unity
         private readonly SceneData _sceneData;
         private readonly SceneAuthoring _authoring;
         private readonly bool _ownsWorld;
+        private readonly ComponentId _hiddenEntityHierarchyComponentId;
         private bool _disposed;
 
         public World World => _world;
+        internal ComponentId HiddenEntityHierarchyComponentId => _hiddenEntityHierarchyComponentId;
 
         public Entity[] AuthoredEntities
         {
@@ -60,6 +62,7 @@ namespace Delta.ECS.Unity
             _authoring = authoring;
             _integration = world;
             _ownsWorld = ownsWorld;
+            _hiddenEntityHierarchyComponentId = world.Components.GetPrimary<HideFromEntityHierarchy>();
 
             _sceneData.EnsureStableIds();
             _integration.Initialize();
@@ -570,6 +573,7 @@ namespace Delta.ECS.Unity
         private static World CreateWorld(int initialEntityCapacity)
         {
             var layouts = new ComponentRegistry();
+            layouts.Register<HideFromEntityHierarchy>(new SchemaId(ViewComponentSchemaIds.HideFromEntityHierarchy));
             foreach (IGeneratedComponentRegistration registration in GeneratedComponentCatalog.GetRegistrations())
             {
                 layouts.Register(registration);

package/Runtime/ViewComponents.cs

@@ -2,6 +2,13 @@ using Delta.ECS;
 
 namespace Delta.ECS.Unity
 {
+    internal static class ViewComponentSchemaIds
+    {
+        internal const ulong ViewToken = 0x405B11F5A17E14A1UL;
+        internal const ulong ViewBound = 0xB31CB42A81D3B164UL;
+        internal const ulong HideFromEntityHierarchy = 0x8C13A2E9764DB501UL;
+    }
+
     /// <summary>Receives the entity context after a Unity view is bound to an entity.</summary>
     public interface IEntityView
     {
@@ -10,7 +17,7 @@ namespace Delta.ECS.Unity
     }
 
     /// <summary>Selects the Unity prefab used to represent an entity.</summary>
-    [ComponentSchema(0x405B11F5A17E14A1UL)]
+    [ComponentSchema(ViewComponentSchemaIds.ViewToken)]
     public readonly struct ViewToken
     {
         /// <summary>Gets the identifier of the view prefab in a <see cref="ViewPrefabCatalog"/>.</summary>
@@ -21,8 +28,15 @@ namespace Delta.ECS.Unity
     }
 
     /// <summary>Marks an entity whose Unity view has already been bound.</summary>
-    [ComponentSchema(0xB31CB42A81D3B164UL)]
+    [ComponentSchema(ViewComponentSchemaIds.ViewBound)]
     public struct ViewBound
     {
     }
+
+    /// <summary>Hides an unbound ECS entity from the Unity Hierarchy window while this tag is present.</summary>
+    /// <remarks>Entities bound to a GameObject keep their normal Unity hierarchy visibility.</remarks>
+    [ComponentSchema(ViewComponentSchemaIds.HideFromEntityHierarchy)]
+    public readonly struct HideFromEntityHierarchy
+    {
+    }
 }

package/package.json

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