com.wallstop-studios.dxmessaging 2.2.0 → 3.0.1

package/Runtime/Core/Extensions/MessageBusExtensions.cs.meta

@@ -1,12 +1,12 @@
-fileFormatVersion: 2
-guid: 2d2a3b7979da4f248a398e05be9f83d4
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
-
+fileFormatVersion: 2
+guid: 2d2a3b7979da4f248a398e05be9f83d4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+

package/Runtime/Core/Extensions/MessageExtensions.cs.meta

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: 760f3c3fe4dffe647b41eef37728c4f4
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 760f3c3fe4dffe647b41eef37728c4f4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/Extensions.meta

@@ -1,8 +1,8 @@
-fileFormatVersion: 2
-guid: 963c131823f1c5948a69209dbac6533f
-folderAsset: yes
-DefaultImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 963c131823f1c5948a69209dbac6533f
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/Helper/MessageCache.cs

@@ -155,6 +155,25 @@ namespace DxMessaging.Core.Helper
             return false;
         }
 
+        /// <summary>
+        /// Attempts to get the value at an already-resolved message type index.
+        /// </summary>
+        /// <param name="index">Index previously assigned by <see cref="MessageHelperIndexer{TMessage}"/>.</param>
+        /// <param name="value">Out parameter receiving the value if present.</param>
+        /// <returns>True if a non-null value was present.</returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        internal bool TryGetValueAtIndex(int index, out TValue value)
+        {
+            if (0 <= index && index < _values.Count)
+            {
+                value = _values[index];
+                return value != null;
+            }
+
+            value = default;
+            return false;
+        }
+
         /// <summary>
         /// Removes the value for the given <typeparamref name="TMessage"/> key.
         /// </summary>
@@ -170,6 +189,19 @@ namespace DxMessaging.Core.Helper
             }
         }
 
+        /// <summary>
+        /// Removes the value at an already-resolved message type index.
+        /// </summary>
+        /// <param name="index">Index previously assigned by <see cref="MessageHelperIndexer{TMessage}"/>.</param>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        internal void RemoveAtIndex(int index)
+        {
+            if (0 <= index && index < _values.Count)
+            {
+                _values[index] = null;
+            }
+        }
+
         /// <summary>
         /// Returns an enumerator iterating over non-null entries in insertion order.
         /// </summary>

package/Runtime/Core/Helper/MessageCache.cs.meta

@@ -1,3 +1,3 @@
-fileFormatVersion: 2
-guid: 23cb3bf7f25d479c862736482ee96fa7
+fileFormatVersion: 2
+guid: 23cb3bf7f25d479c862736482ee96fa7
 timeCreated: 1745102344

package/Runtime/Core/Helper/MessageHelperIndexer.cs.meta

@@ -1,3 +1,3 @@
-fileFormatVersion: 2
-guid: 612c352c3d984a3486ac4b19bb69fa37
+fileFormatVersion: 2
+guid: 612c352c3d984a3486ac4b19bb69fa37
 timeCreated: 1745101032

package/Runtime/Core/Helper.meta

@@ -1,3 +1,3 @@
-fileFormatVersion: 2
-guid: 351ee8f890884099b6c7c32e66f196a9
+fileFormatVersion: 2
+guid: 351ee8f890884099b6c7c32e66f196a9
 timeCreated: 1745100990

package/Runtime/Core/IMessage.cs

@@ -8,9 +8,9 @@ namespace DxMessaging.Core
     /// <remarks>
     /// DxMessaging models three primary categories of messages:
     /// <list type="bullet">
-    /// <item><description><see cref="Messages.IUntargetedMessage"/> — global notifications (for example: settings changed).</description></item>
-    /// <item><description><see cref="Messages.ITargetedMessage"/> — commands or events directed at a specific target.</description></item>
-    /// <item><description><see cref="Messages.IBroadcastMessage"/> — events emitted by a specific source and consumable by any listener.</description></item>
+    /// <item><description><see cref="Messages.IUntargetedMessage"/> -- global notifications (for example: settings changed).</description></item>
+    /// <item><description><see cref="Messages.ITargetedMessage"/> -- commands or events directed at a specific target.</description></item>
+    /// <item><description><see cref="Messages.IBroadcastMessage"/> -- events emitted by a specific source and consumable by any listener.</description></item>
     /// </list>
     /// <para>
     /// Implementors typically use the generic variants (for example, <c>IUntargetedMessage&lt;T&gt;</c>) on <c>struct</c> messages

package/Runtime/Core/IMessage.cs.meta

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: 7d57ad19529ae9d4eb2521c7f44af929
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 7d57ad19529ae9d4eb2521c7f44af929
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/InstanceId.cs.meta

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: 41b061d3cfb2f244b9806bfda65e3fa3
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 41b061d3cfb2f244b9806bfda65e3fa3
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/Internal/TypedDispatchLinkIndex.cs

@@ -0,0 +1,51 @@
+namespace DxMessaging.Core.Internal
+{
+    /// <summary>
+    /// Const-int positions into <c>TypedHandler&lt;T&gt;._dispatchLinks[]</c>.
+    /// Indices are hand-written so call sites inline as immediate operands.
+    /// Array length and per-index <c>null</c>-ness are validated in DEBUG
+    /// builds via <c>TypedHandler&lt;T&gt;.ValidateSlotArrays()</c>.
+    /// </summary>
+    /// <remarks>
+    /// Positions are laid out in lex-(<c>Kind</c>, <c>Phase</c>, <c>Variant</c>) order:
+    /// Untargeted -&gt; Targeted -&gt; Broadcast within Kind, Handle before
+    /// PostProcess within Phase, and with-context before WithoutContext
+    /// within Variant. The xmldoc on each constant names the legacy
+    /// <c>TypedHandler&lt;T&gt;</c> dispatch-link field whose storage role
+    /// the slot assumes in typed dispatch storage.
+    /// </remarks>
+    internal static class TypedDispatchLinkIndex
+    {
+        /// <summary>Legacy field: <c>_untargetedLink</c>.</summary>
+        public const int UntargetedHandle = 0;
+
+        /// <summary>Legacy field: <c>_untargetedPostLink</c>.</summary>
+        public const int UntargetedPostProcess = 1;
+
+        /// <summary>Legacy field: <c>_targetedLink</c>.</summary>
+        public const int TargetedHandle = 2;
+
+        /// <summary>Legacy field: <c>_targetedWithoutTargetingLink</c>.</summary>
+        public const int TargetedHandleWithoutContext = 3;
+
+        /// <summary>Legacy field: <c>_targetedPostLink</c>.</summary>
+        public const int TargetedPostProcess = 4;
+
+        /// <summary>Legacy field: <c>_targetedWithoutTargetingPostLink</c>.</summary>
+        public const int TargetedPostProcessWithoutContext = 5;
+
+        /// <summary>Legacy field: <c>_broadcastLink</c>.</summary>
+        public const int BroadcastHandle = 6;
+
+        /// <summary>Legacy field: <c>_broadcastWithoutSourceLink</c>.</summary>
+        public const int BroadcastHandleWithoutContext = 7;
+
+        /// <summary>Legacy field: <c>_broadcastPostLink</c>.</summary>
+        public const int BroadcastPostProcess = 8;
+
+        /// <summary>Legacy field: <c>_broadcastWithoutSourcePostLink</c>.</summary>
+        public const int BroadcastPostProcessWithoutContext = 9;
+
+        public const int Length = 10;
+    }
+}

package/Runtime/Core/Internal/TypedDispatchLinkIndex.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 031ffa9bfbf249728da382bb9e03b017
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData:
+  assetBundleName:
+  assetBundleVariant:

package/Runtime/Core/Internal/TypedGlobalSlotIndex.cs

@@ -0,0 +1,38 @@
+namespace DxMessaging.Core.Internal
+{
+    /// <summary>
+    /// Const-int positions into <c>TypedHandler&lt;T&gt;._globalSlots[]</c>.
+    /// Indices are hand-written so call sites inline as immediate operands.
+    /// Array length and per-index <c>null</c>-ness are validated in DEBUG
+    /// builds via <c>TypedHandler&lt;T&gt;.ValidateSlotArrays()</c>.
+    /// </summary>
+    /// <remarks>
+    /// Positions are laid out in lex-(<c>Kind</c>, <c>Variant</c>) order:
+    /// Untargeted -&gt; Targeted -&gt; Broadcast within Kind, Default before
+    /// Fast within Variant. The xmldoc on each constant names the legacy
+    /// <c>TypedHandler&lt;T&gt;</c> field whose storage role the slot will
+    /// assume in typed global storage.
+    /// </remarks>
+    internal static class TypedGlobalSlotIndex
+    {
+        /// <summary>Legacy field: <c>_globalUntargetedHandlers</c>.</summary>
+        public const int UntargetedDefault = 0;
+
+        /// <summary>Legacy field: <c>_globalUntargetedFastHandlers</c>.</summary>
+        public const int UntargetedFast = 1;
+
+        /// <summary>Legacy field: <c>_globalTargetedHandlers</c>.</summary>
+        public const int TargetedDefault = 2;
+
+        /// <summary>Legacy field: <c>_globalTargetedFastHandlers</c>.</summary>
+        public const int TargetedFast = 3;
+
+        /// <summary>Legacy field: <c>_globalBroadcastHandlers</c>.</summary>
+        public const int BroadcastDefault = 4;
+
+        /// <summary>Legacy field: <c>_globalBroadcastFastHandlers</c>.</summary>
+        public const int BroadcastFast = 5;
+
+        public const int Length = 6;
+    }
+}

package/Runtime/Core/Internal/TypedGlobalSlotIndex.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: c1d15b0be71e49828b55dc1654748f4e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData:
+  assetBundleName:
+  assetBundleVariant:

package/Runtime/Core/Internal/TypedSlotIndex.cs

@@ -0,0 +1,81 @@
+namespace DxMessaging.Core.Internal
+{
+    /// <summary>
+    /// Const-int positions into <c>TypedHandler&lt;T&gt;._slots[]</c>. Indices
+    /// are hand-written so call sites inline as immediate operands. Array
+    /// length and per-index <c>null</c>-ness are validated in DEBUG builds via
+    /// <c>TypedHandler&lt;T&gt;.ValidateSlotArrays()</c>.
+    /// </summary>
+    /// <remarks>
+    /// Positions are laid out in lex-(<c>Kind</c>, <c>Phase</c>, <c>Variant</c>) order:
+    /// Untargeted -&gt; Targeted -&gt; Broadcast within Kind; Handle before
+    /// PostProcess within Phase; and Default -&gt; Fast -&gt; WithoutContext -&gt;
+    /// WithoutContextFast within Variant. The xmldoc on each constant names
+    /// the legacy <c>TypedHandler&lt;T&gt;</c> field whose storage role the
+    /// slot assumes in typed storage.
+    /// </remarks>
+    internal static class TypedSlotIndex
+    {
+        /// <summary>Legacy field: <c>_untargetedHandlers</c>.</summary>
+        public const int UntargetedHandleDefault = 0;
+
+        /// <summary>Legacy field: <c>_untargetedFastHandlers</c>.</summary>
+        public const int UntargetedHandleFast = 1;
+
+        /// <summary>Legacy field: <c>_untargetedPostProcessingHandlers</c>.</summary>
+        public const int UntargetedPostProcessDefault = 2;
+
+        /// <summary>Legacy field: <c>_untargetedPostProcessingFastHandlers</c>.</summary>
+        public const int UntargetedPostProcessFast = 3;
+
+        /// <summary>Legacy field: <c>_targetedHandlers</c>.</summary>
+        public const int TargetedHandleDefault = 4;
+
+        /// <summary>Legacy field: <c>_targetedFastHandlers</c>.</summary>
+        public const int TargetedHandleFast = 5;
+
+        /// <summary>Legacy field: <c>_targetedWithoutTargetingHandlers</c>.</summary>
+        public const int TargetedHandleWithoutContext = 6;
+
+        /// <summary>Legacy field: <c>_fastTargetedWithoutTargetingHandlers</c>.</summary>
+        public const int TargetedHandleWithoutContextFast = 7;
+
+        /// <summary>Legacy field: <c>_targetedPostProcessingHandlers</c>.</summary>
+        public const int TargetedPostProcessDefault = 8;
+
+        /// <summary>Legacy field: <c>_targetedPostProcessingFastHandlers</c>.</summary>
+        public const int TargetedPostProcessFast = 9;
+
+        /// <summary>Legacy field: <c>_targetedWithoutTargetingPostProcessingHandlers</c>.</summary>
+        public const int TargetedPostProcessWithoutContext = 10;
+
+        /// <summary>Legacy field: <c>_fastTargetedWithoutTargetingPostProcessingHandlers</c>.</summary>
+        public const int TargetedPostProcessWithoutContextFast = 11;
+
+        /// <summary>Legacy field: <c>_broadcastHandlers</c>.</summary>
+        public const int BroadcastHandleDefault = 12;
+
+        /// <summary>Legacy field: <c>_broadcastFastHandlers</c>.</summary>
+        public const int BroadcastHandleFast = 13;
+
+        /// <summary>Legacy field: <c>_broadcastWithoutSourceHandlers</c>.</summary>
+        public const int BroadcastHandleWithoutContext = 14;
+
+        /// <summary>Legacy field: <c>_fastBroadcastWithoutSourceHandlers</c>.</summary>
+        public const int BroadcastHandleWithoutContextFast = 15;
+
+        /// <summary>Legacy field: <c>_broadcastPostProcessingHandlers</c>.</summary>
+        public const int BroadcastPostProcessDefault = 16;
+
+        /// <summary>Legacy field: <c>_broadcastPostProcessingFastHandlers</c>.</summary>
+        public const int BroadcastPostProcessFast = 17;
+
+        /// <summary>Legacy field: <c>_broadcastWithoutSourcePostProcessingHandlers</c>.</summary>
+        public const int BroadcastPostProcessWithoutContext = 18;
+
+        /// <summary>Legacy field: <c>_fastBroadcastWithoutSourcePostProcessingHandlers</c>.</summary>
+        public const int BroadcastPostProcessWithoutContextFast = 19;
+
+        public const int Length = 20;
+    }
+}

package/Runtime/Core/Internal/TypedSlotIndex.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: ef97ae16e3954ebba9ff6f003592d2da
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData:
+  assetBundleName:
+  assetBundleVariant: