com.wallstop-studios.dxmessaging 2.1.0 → 2.1.1

package/Docs/Comparisons.md

@@ -34,10 +34,10 @@ These sections are auto-updated by the PlayMode comparison benchmarks in `Tests/
 
 | Message Tech                       | Operations / Second | Allocations? |
 | ---------------------------------- | ------------------- | ------------ |
-| DxMessaging (Untargeted) - No-Copy | 14,902,000          | No           |
-| UniRx MessageBroker                | 18,026,000          | No           |
-| MessagePipe (Global)               | 96,978,000          | No           |
-| Zenject SignalBus                  | 2,520,000           | Yes          |
+| DxMessaging (Untargeted) - No-Copy | 14,740,000          | No           |
+| UniRx MessageBroker                | 17,858,000          | No           |
+| MessagePipe (Global)               | 96,052,000          | No           |
+| Zenject SignalBus                  | 2,632,000           | Yes          |
 
 ### Comparisons (macOS)
 

package/Docs/EmitShorthands.md

@@ -70,10 +70,10 @@ public sealed class ScoreReporter
 }
 
 [DxUntargetedMessage]
-public readonly struct ScoreChanged
+[DxAutoConstructor]
+public readonly partial struct ScoreChanged
 {
     public readonly int Value;
-    public ScoreChanged(int value) => Value = value;
 }
 ```
 

package/Docs/Helpers.md

@@ -186,34 +186,32 @@ public readonly partial struct ComplexMessage
 
 ## Why Use Attributes Instead of Manual Implementation
 
-### ❌ Manual Way (Verbose, Error-Prone)
+### ✅ Attribute Definition (Clean, Automatic)
 
 ```csharp
-public readonly struct Heal : ITargetedMessage<Heal>
+[DxTargetedMessage]
+[DxAutoConstructor]
+public readonly partial struct Heal
 {
     public readonly int amount;
-
-    // You write this yourself (boring!)
-    public Heal(int amount)
-    {
-        this.amount = amount;
-    }
-
-    // Required plumbing (easy to mess up!)
-    public Type MessageType => typeof(Heal);
 }
 ```
 
-### ✅ Attribute Way (Clean, Automatic)
+### What the generator emits (for reference)
 
 ```csharp
-[DxTargetedMessage]
-[DxAutoConstructor]
-public readonly partial struct Heal
+// Auto-generated by DxMessaging (no need to hand-write this)
+public readonly partial struct Heal : ITargetedMessage<Heal>
 {
     public readonly int amount;
+
+    public Heal(int amount)
+    {
+        this.amount = amount;
+    }
+
+    public Type MessageType => typeof(Heal);
 }
-// Constructor and plumbing generated automatically!
 ```
 
 #### Benefits
@@ -223,14 +221,28 @@ public readonly partial struct Heal
 - ✅ **Cleaner** - Focus on data, not boilerplate
 - ✅ **Refactor-safe** - Add field? Constructor updates automatically!
 
-## Complete Example: Before & After
+## Complete Example: Attribute Definition vs Generated Output
 
-### Before (Manual - 20 lines)
+### Attribute Definition (8 lines)
 
 ```csharp
-using DxMessaging.Core.Messages;
+using DxMessaging.Core.Attributes;
 
-public readonly struct PlayerDamaged : IBroadcastMessage<PlayerDamaged>
+[DxBroadcastMessage]
+[DxAutoConstructor]
+public readonly partial struct PlayerDamaged
+{
+    public readonly int amount;
+    public readonly string damageType;
+    public readonly GameObject source;
+}
+```
+
+### Generated Output (20 lines you never write)
+
+```csharp
+// Auto-generated by DxMessaging (for reference only)
+public readonly partial struct PlayerDamaged : IBroadcastMessage<PlayerDamaged>
 {
     public readonly int amount;
     public readonly string damageType;
@@ -247,65 +259,76 @@ public readonly struct PlayerDamaged : IBroadcastMessage<PlayerDamaged>
 }
 ```
 
-### After (Attributes - 9 lines!)
+### Result
 
-```csharp
-using DxMessaging.Core.Attributes;
+- ✅ Same functionality
+- ✅ Less code to maintain
+- ✅ Automatically updates when you add/remove fields
+- ✅ Works for class messages too
+- ✅ Zero effort once you mark the struct partial
 
-[DxBroadcastMessage]
+## Advanced: Manual Implementation (When Attributes Aren't Enough)
+
+Attributes cover almost every scenario. If you intentionally drop `[DxTargetedMessage]`, `[DxUntargetedMessage]`, or `[DxBroadcastMessage]`, you'll need to hand-write the interface implementations and constructors shown in the “generated output” examples. Keep the attributes unless you have a very specific data-backed reason not to.
+
+### Generic Message Interfaces (Zero-Boxing for Structs)
+
+`readonly struct` messages marked with the attributes already implement the generic interfaces, so emissions stay allocation-free. You get the same performance characteristics as the manual approach without writing any plumbing.
+
+```csharp
+[DxTargetedMessage]
 [DxAutoConstructor]
-public readonly partial struct PlayerDamaged
+public readonly partial struct Heal
 {
     public readonly int amount;
-    public readonly string damageType;
-    public readonly GameObject source;
 }
 ```
 
-**Result:** Same functionality, 55% less code, zero boilerplate!
+### "Do I HAVE to use attributes?"
 
-## Advanced: Manual Implementation (When Attributes Aren't Enough)
+Technically no—but without them you must write the constructor, interface implementation, and `MessageType` property yourself (for speed, you can optionally leave this off, but it might box on certain call paths). Leaving the attributes on keeps everything consistent for the whole team.
 
-Sometimes you might want full control and skip source generators. You can implement interfaces manually:
+```csharp
+[DxUntargetedMessage]
+[DxAutoConstructor]
+public readonly partial struct MyMsg { }
+```
 
-### Generic Message Interfaces (Zero-Boxing for Structs)
+### "What if I want custom constructor logic?"
 
-**For performance-critical code**, implement the generic interfaces directly:
+Keep the attributes and add a factory/helper so you still benefit from the generated constructor:
 
 ```csharp
-using DxMessaging.Core.Messages;
-
-public readonly struct Heal : ITargetedMessage<Heal>
+[DxUntargetedMessage]
+[DxAutoConstructor]
+public readonly partial struct ComplexMessage
 {
-    public readonly int amount;
+    public readonly int value;
 
-    public Heal(int amount)
+    public static ComplexMessage FromRaw(int rawValue)
     {
-        this.amount = amount;
+        int clamped = Math.Clamp(rawValue, 0, 100);
+        return new ComplexMessage(clamped);
     }
-
-    // Required for IMessage
-    public Type MessageType => typeof(Heal);
 }
 ```
 
-#### Why use generics?
+If you truly must write a custom constructor, drop `[DxAutoConstructor]` for that type but keep the `[DxUntargetedMessage]`/`[DxTargetedMessage]` attribute so the interface plumbing stays consistent.
 
-- Avoids boxing structs (important for performance)
-- Provides stable `MessageType` without `GetType()` calls
-- Same performance as attribute-based approach
+### "Can I mix attribute-based and manual messages?"
 
-##### When to use
+Yes. Attribute-driven messages happily coexist with string messages and any manual implementations you already have. You can migrate gradually by converting one message at a time:
 
-- Hot path messages (sent/received every frame)
-- Very large structs where boxing matters
-- When you want explicit control
-
-###### When to use attributes
+```csharp
+[DxUntargetedMessage]
+[DxAutoConstructor]
+public readonly partial struct MessageA
+{
+    public readonly int value;
+}
 
-- 99% of cases (they generate the same code!)
-- Cleaner, less boilerplate
-- Easier to maintain
+// Existing manual message types keep working alongside attribute-driven ones.
+```
 
 ## Extension Methods (Emit Helpers)
 
@@ -549,50 +572,42 @@ public readonly partial struct MyMessage : IUntargetedMessage<MyMessage>
 
 ### "What if I want custom constructor logic?"
 
-Use manual implementation:
+Keep the attributes and wrap the generated constructor with a helper so you can inject custom logic without losing the source-generated plumbing:
 
 ```csharp
-public readonly struct ComplexMessage : IUntargetedMessage<ComplexMessage>
+[DxUntargetedMessage]
+[DxAutoConstructor]
+public readonly partial struct ComplexMessage
 {
     public readonly int value;
 
-    public ComplexMessage(int rawValue)
+    public static ComplexMessage FromRaw(int rawValue)
     {
-        // Custom logic
-        value = Math.Clamp(rawValue, 0, 100);
+        int clamped = Math.Clamp(rawValue, 0, 100);
+        return new ComplexMessage(clamped);
     }
-
-    public Type MessageType => typeof(ComplexMessage);
 }
 ```
 
+If you truly need to hand-craft the constructor, drop `[DxAutoConstructor]` for that specific type but keep the `[DxUntargetedMessage]`/`[DxTargetedMessage]` attribute so the interface implementation is still generated.
+
 ### "Do attributes affect runtime performance?"
 
 **No!** Source generation happens at **compile time**. Generated code is identical to hand-written code. Zero runtime overhead.
 
 ### "Can I mix attributes and manual implementation?"
 
-**Not on the same type**, but you can have:
-
-- Some messages using attributes
-- Other messages using manual implementation
-- Mix and match across your codebase
+Yes. Attribute-driven messages happily coexist with any legacy manual messages or string messages you already emit. Convert types gradually—one message at a time:
 
 ```csharp
-// Message A: Attributes
 [DxUntargetedMessage]
 [DxAutoConstructor]
-public readonly partial struct MessageA { public readonly int value; }
-
-// Message B: Manual
-public readonly struct MessageB : IUntargetedMessage<MessageB>
+public readonly partial struct MessageA
 {
     public readonly int value;
-    public MessageB(int value) { this.value = value; }
-    public Type MessageType => typeof(MessageB);
 }
 
-// Both work perfectly together!
+// Existing manual messages keep working alongside attribute-driven ones.
 ```
 
 ## Troubleshooting Source Generators
@@ -609,7 +624,7 @@ public readonly struct MessageB : IUntargetedMessage<MessageB>
 ##### Fix
 
 ```csharp
-// ❌ Missing partial
+// ❌ Missing partial, will not compile
 [DxAutoConstructor]
 public readonly struct MyMsg { }
 

package/Docs/Patterns.md

@@ -874,7 +874,7 @@ public class GameEvent : ScriptableObject
 
 // DxMessaging message (modern, type-safe)
 [DxUntargetedMessage]
-public readonly struct SceneTransitionRequested { }
+public readonly partial struct SceneTransitionRequested { }
 
 // Bridge: SOA Event → DxMessaging
 public class SOAEventBridge : MonoBehaviour

package/Docs/Performance.md

@@ -14,15 +14,15 @@ See also: `Docs/DesignAndArchitecture.md#performance-optimizations` for design d
 
 | Message Tech                       | Operations / Second | Allocations? |
 | ---------------------------------- | ------------------- | ------------ |
-| Unity                              | 2,490,000           | Yes          |
-| DxMessaging (GameObject) - Normal  | 8,520,000           | No           |
-| DxMessaging (Component) - Normal   | 8,542,000           | No           |
-| DxMessaging (GameObject) - No-Copy | 9,426,000           | No           |
-| DxMessaging (Component) - No-Copy  | 9,552,000           | No           |
-| DxMessaging (Untargeted) - No-Copy | 14,900,000          | No           |
-| Reflexive (One Argument)           | 2,832,000           | No           |
-| Reflexive (Two Arguments)          | 2,348,000           | No           |
-| Reflexive (Three Arguments)        | 2,364,000           | No           |
+| Unity                              | 2,628,000           | Yes          |
+| DxMessaging (GameObject) - Normal  | 8,208,000           | No           |
+| DxMessaging (Component) - Normal   | 8,210,000           | No           |
+| DxMessaging (GameObject) - No-Copy | 9,412,000           | No           |
+| DxMessaging (Component) - No-Copy  | 9,354,000           | No           |
+| DxMessaging (Untargeted) - No-Copy | 14,812,000          | No           |
+| Reflexive (One Argument)           | 2,856,000           | No           |
+| Reflexive (Two Arguments)          | 2,372,000           | No           |
+| Reflexive (Three Arguments)        | 2,382,000           | No           |
 
 ## macOS
 

package/Docs/QuickStart.md

@@ -60,8 +60,7 @@ public readonly partial struct TookDamage
     public readonly int amount;
 }
 
-// Performance option: generic interfaces on structs (zero boxing)
-// public readonly struct Heal : ITargetedMessage<Heal> { public readonly int amount; public Heal(int amount) { this.amount = amount; } }
+// Performance option: keep [DxTargetedMessage] on a readonly struct to stay zero-boxing friendly, and drop [DxAutoConstructor] only if you need custom constructor logic.
 
 // Optional parameters with custom defaults
 [DxTargetedMessage]

package/Runtime/Core/Attributes/DxAutoConstructorAttribute.cs

@@ -14,7 +14,7 @@ namespace DxMessaging.Core.Attributes
     /// <code>
     /// [DxMessaging.Core.Attributes.DxUntargetedMessage]
     /// [DxMessaging.Core.Attributes.DxAutoConstructor]
-    /// public readonly struct VideoSettingsChanged
+    /// public readonly partial struct VideoSettingsChanged
     /// {
     ///     public readonly int width;
     ///     public readonly int height;

package/Runtime/Core/Attributes/DxBroadcastMessageAttribute.cs

@@ -13,7 +13,7 @@ namespace DxMessaging.Core.Attributes
     /// <example>
     /// <code>
     /// [DxMessaging.Core.Attributes.DxBroadcastMessage]
-    /// public readonly struct TookDamage
+    /// public readonly partial struct TookDamage
     /// {
     ///     public readonly int amount;
     ///     public TookDamage(int amount) { this.amount = amount; }

package/Runtime/Core/Attributes/DxOptionalParameterAttribute.cs

@@ -12,7 +12,7 @@ namespace DxMessaging.Core.Attributes
     /// <example>
     /// <code>
     /// [DxAutoConstructor]
-    /// public readonly struct Example
+    /// public readonly partial struct Example
     /// {
     ///     public readonly int required;
     ///     [DxOptionalParameter] public readonly int optional; // defaults to 0

package/Runtime/Core/Attributes/DxTargetedMessageAttribute.cs

@@ -14,7 +14,7 @@ namespace DxMessaging.Core.Attributes
     /// <example>
     /// <code>
     /// [DxMessaging.Core.Attributes.DxTargetedMessage]
-    /// public readonly struct HealRequest
+    /// public readonly partial struct HealRequest
     /// {
     ///     public readonly int amount;
     ///     public HealRequest(int amount) { this.amount = amount; }

package/Runtime/Core/Attributes/DxUntargetedMessageAttribute.cs

@@ -14,7 +14,7 @@ namespace DxMessaging.Core.Attributes
     /// <example>
     /// <code>
     /// [DxMessaging.Core.Attributes.DxUntargetedMessage]
-    /// public readonly struct WorldRegenerated
+    /// public readonly partial struct WorldRegenerated
     /// {
     ///     public readonly int seed;
     ///     public WorldRegenerated(int seed) { this.seed = seed; }

package/Runtime/Core/Messages/IBroadcastMessage.cs

@@ -25,7 +25,7 @@ namespace DxMessaging.Core.Messages
     /// // Attribute + auto constructor
     /// [DxMessaging.Core.Attributes.DxBroadcastMessage]
     /// [DxMessaging.Core.Attributes.DxAutoConstructor]
-    /// public readonly struct PickedUpItem { public readonly int itemId; }
+    /// public readonly partial struct PickedUpItem { public readonly int itemId; }
     /// </code>
     /// </example>
     public interface IBroadcastMessage : IMessage { }

package/Runtime/Core/Messages/ITargetedMessage.cs

@@ -26,7 +26,7 @@ namespace DxMessaging.Core.Messages
     /// // Attribute form with auto constructor
     /// [DxMessaging.Core.Attributes.DxTargetedMessage]
     /// [DxMessaging.Core.Attributes.DxAutoConstructor]
-    /// public readonly struct EquipWeapon { public readonly int weaponId; }
+    /// public readonly partial struct EquipWeapon { public readonly int weaponId; }
     /// </code>
     /// </example>
     public interface ITargetedMessage : IMessage { }

package/Runtime/Core/Messages/IUntargetedMessage.cs

@@ -26,7 +26,7 @@ namespace DxMessaging.Core.Messages
     /// // Or with attribute + DxAutoConstructor
     /// [DxMessaging.Core.Attributes.DxUntargetedMessage]
     /// [DxMessaging.Core.Attributes.DxAutoConstructor]
-    /// public readonly struct WorldRegenerated { public readonly int seed; }
+    /// public readonly partial struct WorldRegenerated { public readonly int seed; }
     /// </code>
     /// </example>
     public interface IUntargetedMessage : IMessage { }

package/Runtime/Unity/MessagingComponent.cs

@@ -72,10 +72,10 @@ namespace DxMessaging.Unity
                 throw new ArgumentNullException(nameof(listener));
             }
 
-            if (gameObject.GetInstanceID() != listener.gameObject.GetInstanceID())
+            if (gameObject != listener.gameObject)
             {
                 throw new ArgumentException(
-                    $"Cannot create a RegistrationToken without an valid owner. {listener.gameObject.GetInstanceID()}."
+                    $"Cannot create a RegistrationToken without a mismatched owner. {listener.gameObject} != existing {gameObject}."
                 );
             }
 
@@ -86,11 +86,15 @@ namespace DxMessaging.Unity
                 )
             )
             {
-                MessagingDebug.Log(
-                    LogLevel.Warn,
-                    "Ignoring double RegistrationToken request for {0}.",
-                    listener
-                );
+                if (MessagingDebug.enabled)
+                {
+                    MessagingDebug.Log(
+                        LogLevel.Warn,
+                        "Ignoring double RegistrationToken request for {0}.",
+                        listener
+                    );
+                }
+
                 return createdToken;
             }
 

package/Samples~/DI/Reflex/SampleInstaller.cs

@@ -2,6 +2,7 @@
 namespace DxMessaging.Samples.DI.Reflex
 {
     using DxMessaging.Core;
+    using DxMessaging.Core.Attributes;
     using DxMessaging.Core.MessageBus;
     using DxMessaging.Core.Messages;
     using DxMessaging.Unity.Integrations.Reflex;
@@ -61,14 +62,13 @@ namespace DxMessaging.Samples.DI.Reflex
             }
         }
 
-        private readonly struct PlayerAlert : IBroadcastMessage
+        [DxBroadcastMessage]
+        [DxAutoConstructor]
+        private readonly partial struct PlayerAlert
         {
-            public PlayerAlert(InstanceId source)
-            {
-                Source = source;
-            }
+            public readonly InstanceId source;
 
-            public InstanceId Source { get; }
+            public InstanceId Source => source;
         }
     }
 }

package/Samples~/DI/VContainer/SampleLifetimeScope.cs

@@ -2,9 +2,9 @@
 namespace DxMessaging.Samples.DI.VContainer
 {
     using System;
-    using Core.Attributes;
-    using Core.Extensions;
-    using Core.MessageBus;
+    using DxMessaging.Core.Attributes;
+    using DxMessaging.Core.Extensions;
+    using DxMessaging.Core.MessageBus;
     using DxMessaging.Unity.Integrations.VContainer;
     using UnityEngine;
     using VContainer;
@@ -25,14 +25,12 @@ namespace DxMessaging.Samples.DI.VContainer
         }
 
         [DxUntargetedMessage]
-        private readonly struct ScoreUpdated
+        [DxAutoConstructor]
+        private readonly partial struct ScoreUpdated
         {
-            public readonly int Value;
+            public readonly int value;
 
-            public ScoreUpdated(int value)
-            {
-                Value = value;
-            }
+            public int Value => value;
         }
 
         private sealed class ScoreboardService : IStartable, ITickable, IDisposable

package/Samples~/DI/Zenject/SampleInstaller.cs

@@ -2,8 +2,8 @@
 namespace DxMessaging.Samples.DI.Zenject
 {
     using System;
-    using Core.Attributes;
-    using Core.MessageBus;
+    using DxMessaging.Core.Attributes;
+    using DxMessaging.Core.MessageBus;
     using UnityEngine;
     using Zenject;
 
@@ -20,14 +20,12 @@ namespace DxMessaging.Samples.DI.Zenject
         }
 
         [DxUntargetedMessage]
-        private readonly struct PlayerSpawned
+        [DxAutoConstructor]
+        private readonly partial struct PlayerSpawned
         {
-            public readonly string PlayerName;
+            public readonly string playerName;
 
-            public PlayerSpawned(string playerName)
-            {
-                PlayerName = playerName;
-            }
+            public string PlayerName => playerName;
         }
 
         private sealed class PlayerSpawnTracker : IInitializable, IDisposable

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.wallstop-studios.dxmessaging",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "displayName": "DxMessaging",
   "description": "Synchronous Event Bus for Unity",
   "unity": "2021.3",

package/package-lock.json.meta

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: 6c3d7e44fbd165847a830ad23b17aeb7
-TextScriptImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: