com.wallstop-studios.dxmessaging 2.1.6 → 2.1.8

package/docs/images/DxMessaging-banner.svg

@@ -1,119 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 200" width="800" height="200" style="background:transparent" role="img" aria-label="DxMessaging - Synchronous Event Bus for Unity by Wallstop Studios">
-  <title>DxMessaging - Synchronous Event Bus for Unity</title>
-  <defs>
-    <!-- Messaging-themed gradients (blue/teal for communication) -->
-    <linearGradient id="lineGradient" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" style="stop-color:#3498db;stop-opacity:0"/>
-      <stop offset="20%" style="stop-color:#3498db"/>
-      <stop offset="50%" style="stop-color:#00d9ff"/>
-      <stop offset="80%" style="stop-color:#2980b9"/>
-      <stop offset="100%" style="stop-color:#2980b9;stop-opacity:0"/>
-    </linearGradient>
-    
-    <linearGradient id="hexGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#3498db"/>
-      <stop offset="100%" style="stop-color:#00d9ff"/>
-    </linearGradient>
-    
-    <linearGradient id="titleGradient" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" style="stop-color:#ffffff"/>
-      <stop offset="50%" style="stop-color:#e0f7ff"/>
-      <stop offset="100%" style="stop-color:#00d9ff"/>
-    </linearGradient>
-    
-    <!-- Glow effects -->
-    <filter id="titleGlow" x="-20%" y="-20%" width="140%" height="140%">
-      <feGaussianBlur stdDeviation="3" result="coloredBlur"/>
-      <feMerge>
-        <feMergeNode in="coloredBlur"/>
-        <feMergeNode in="SourceGraphic"/>
-      </feMerge>
-    </filter>
-    
-    <filter id="softShadow" x="-20%" y="-20%" width="140%" height="140%">
-      <feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="#000000" flood-opacity="0.3"/>
-    </filter>
-  </defs>
-  
-  <!-- Wallstop Studios Hexagonal Logo (left side) -->
-  <g transform="translate(50, 100)">
-    <!-- Outer hexagon -->
-    <polygon points="0,-45 39,-22.5 39,22.5 0,45 -39,22.5 -39,-22.5" 
-             fill="none" stroke="url(#hexGradient)" stroke-width="2.5" opacity="0.9"/>
-    <!-- Inner hexagon -->
-    <polygon points="0,-32 27.7,-16 27.7,16 0,32 -27.7,16 -27.7,-16" 
-             fill="url(#hexGradient)" opacity="0.15"/>
-    <!-- W letter stylized -->
-    <text x="0" y="0" text-anchor="middle" dominant-baseline="central" font-family="'Segoe UI', 'SF Pro Display', -apple-system, BlinkMacSystemFont, sans-serif" font-size="32" font-weight="700" fill="url(#hexGradient)" letter-spacing="1">W</text>
-  </g>
-  
-  <!-- Main Title: DxMessaging -->
-  <text x="120" y="75" font-family="'Segoe UI', 'SF Pro Display', -apple-system, BlinkMacSystemFont, sans-serif" font-size="52" font-weight="700" fill="url(#titleGradient)" filter="url(#titleGlow)" letter-spacing="1">DxMessaging</text>
-  
-  <!-- Tagline -->
-  <text x="125" y="105" font-family="'Segoe UI', 'SF Pro Display', -apple-system, BlinkMacSystemFont, sans-serif" font-size="14" fill="#b8e0f0" letter-spacing="0.5">Synchronous messaging. Zero allocations. Lifecycle-managed.</text>
-  
-  <!-- Horizontal accent line -->
-  <line x1="120" y1="118" x2="600" y2="118" stroke="url(#lineGradient)" stroke-width="2" opacity="0.8"/>
-  
-  <!-- Feature icons row -->
-  <g transform="translate(120, 145)" font-family="'Segoe UI', 'SF Pro Display', -apple-system, BlinkMacSystemFont, sans-serif" font-size="11">
-    <!-- Messages -->
-    <g transform="translate(0, 0)">
-      <text x="0" y="0" font-size="16" font-family="'Apple Color Emoji', 'Segoe UI Emoji', 'Noto Color Emoji', sans-serif">📨</text>
-      <text x="22" y="0" fill="#00d9ff" letter-spacing="0.3">Messages</text>
-    </g>
-    <!-- Targeted -->
-    <g transform="translate(95, 0)">
-      <text x="0" y="0" font-size="16" font-family="'Apple Color Emoji', 'Segoe UI Emoji', 'Noto Color Emoji', sans-serif">🎯</text>
-      <text x="22" y="0" fill="#00d9ff" letter-spacing="0.3">Targeted</text>
-    </g>
-    <!-- Broadcast -->
-    <g transform="translate(185, 0)">
-      <text x="0" y="0" font-size="16" font-family="'Apple Color Emoji', 'Segoe UI Emoji', 'Noto Color Emoji', sans-serif">📡</text>
-      <text x="22" y="0" fill="#00d9ff" letter-spacing="0.3">Broadcast</text>
-    </g>
-    <!-- Zero-Alloc -->
-    <g transform="translate(280, 0)">
-      <text x="0" y="0" font-size="16" font-family="'Apple Color Emoji', 'Segoe UI Emoji', 'Noto Color Emoji', sans-serif">⚡</text>
-      <text x="22" y="0" fill="#00d9ff" letter-spacing="0.3">Zero-Alloc</text>
-    </g>
-    <!-- Lifecycle -->
-    <g transform="translate(380, 0)">
-      <text x="0" y="0" font-size="16" font-family="'Apple Color Emoji', 'Segoe UI Emoji', 'Noto Color Emoji', sans-serif">🔄</text>
-      <text x="22" y="0" fill="#00d9ff" letter-spacing="0.3">Lifecycle</text>
-    </g>
-  </g>
-  
-  <!-- Stats badges (right side) -->
-  <g transform="translate(610, 85)" font-family="'SF Mono', 'Fira Code', monospace" font-size="11">
-    <!-- Unity badge -->
-    <g transform="translate(0, 0)">
-      <rect x="0" y="-12" width="110" height="20" rx="10" fill="#1a1a2e" stroke="#3498db" stroke-width="1" opacity="0.9"/>
-      <text x="55" y="3" text-anchor="middle" fill="#00d9ff" font-weight="600" letter-spacing="0.3">🎮 Unity 2021.3+</text>
-    </g>
-    <!-- Zero Alloc badge -->
-    <g transform="translate(0, 28)">
-      <rect x="0" y="-12" width="110" height="20" rx="10" fill="#1a1a2e" stroke="#3498db" stroke-width="1" opacity="0.9"/>
-      <text x="55" y="3" text-anchor="middle" fill="#00d9ff" font-weight="600" letter-spacing="0.3">✅ Zero Alloc</text>
-    </g>
-    <!-- High Perf badge -->
-    <g transform="translate(0, 56)">
-      <rect x="0" y="-12" width="110" height="20" rx="10" fill="#1a1a2e" stroke="#3498db" stroke-width="1" opacity="0.9"/>
-      <text x="55" y="3" text-anchor="middle" fill="#00d9ff" font-weight="600" letter-spacing="0.3">⚡ High Perf</text>
-    </g>
-  </g>
-  
-  <!-- Version badge (top right) - text must contain vX.Y.Z for version sync -->
-  <g transform="translate(720, 25)">
-    <rect x="0" y="-12" width="60" height="22" rx="11" fill="#e94560" filter="url(#softShadow)"/>
-    <text x="30" y="4" text-anchor="middle" font-family="'SF Mono', 'Fira Code', monospace" font-size="12" font-weight="600" fill="#ffffff" letter-spacing="0.5">v2.1.6</text>
-  </g>
-  
-  <!-- Wallstop Studios branding (bottom right) -->
-  <g transform="translate(750, 185)">
-    <text x="0" y="0" text-anchor="middle" font-family="'Segoe UI', sans-serif" font-size="9" fill="#6b7b8a" opacity="0.8" letter-spacing="0.3">Wallstop Studios</text>
-  </g>
-  
-
-</svg>

package/docs/images/DxMessaging-banner.svg.meta

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: 4c1ba6b3e8994dc41b8264e9001eb49f
-DefaultImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

package/docs/images.meta

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

package/docs/index.md

@@ -1,61 +0,0 @@
----
-title: Home
-description: High-performance type-safe messaging library for Unity
----
-
-# DxMessaging Documentation
-
-**DxMessaging** is a high-performance, type-safe messaging library for Unity that provides a clean, decoupled communication pattern between game components.
-
-**[Get Started](getting-started/index.md)** | [View on GitHub](https://github.com/wallstop/DxMessaging)
-
-## Why DxMessaging?
-
-- ⚡ **High Performance** — Zero-allocation message dispatch with pooled handlers
-- 🛡️ **Type-Safe** — Compile-time message type checking prevents runtime errors
-- 📦 **Decoupled Architecture** — Components communicate without direct references
-- 🎯 **Flexible Targeting** — Untargeted, Targeted, and Broadcast message patterns
-- 🔧 **Unity-Native** — Built specifically for Unity with MonoBehaviour integration
-
-## Quick Links
-
-- **[Mental Model](concepts/mental-model.md)** — How to think about DxMessaging
-- **[Visual Guide](getting-started/visual-guide.md)** — Beginner-friendly introduction with diagrams
-- **[Quick Start](getting-started/quick-start.md)** — Your first message in 5 minutes
-- **[Message Types](concepts/message-types.md)** — Untargeted, Targeted, Broadcast patterns
-- **[API Reference](reference/reference.md)** — Complete API documentation
-
-## Installation
-
-### Via OpenUPM (Recommended)
-
-```bash
-openupm add com.wallstop-studios.dxmessaging
-```
-
-#### Or via Git URL
-
-```text
-https://github.com/wallstop/DxMessaging.git
-```
-
-See the [Install Guide](getting-started/install.md) for all options including NPM scoped registries and local tarballs.
-
-## Quick Example
-
-```csharp
-// Define a message
-public readonly struct DamageMessage : IUntargetedMessage
-{
-    public readonly int amount;
-    public DamageMessage(int amount) => this.amount = amount;
-}
-
-// Subscribe and handle (using a MessageRegistrationToken)
-_ = Token.RegisterUntargeted<DamageMessage>(msg =>
-    Debug.Log($"Received {msg.amount} damage!"));
-
-// Emit the message
-DamageMessage damage = new DamageMessage(25);
-damage.EmitUntargeted();
-```

package/docs/index.md.meta

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

package/docs/integrations/index.md

@@ -1,66 +0,0 @@
-# DI Framework Integrations
-
-DxMessaging integrates seamlessly with popular Unity dependency injection (DI) frameworks. This section covers how to combine DxMessaging's reactive event system with constructor-based dependency injection for a powerful, scalable architecture.
-
-## Why Combine DI + Messaging?
-
-Use the best of both worlds:
-
-- **Constructor Injection** — for service dependencies (repositories, managers, configuration)
-- **Messaging** — for reactive events (damage taken, item collected, game state changes)
-
-This combination provides:
-
-- Explicit dependencies with testable constructors
-- Loose coupling between systems via events
-- Scoped message buses for scene isolation
-- Clean separation of concerns
-
-## Supported Frameworks
-
-### [VContainer](vcontainer.md)
-
-Fast, lightweight DI with minimal overhead. Features scoped lifetimes for per-scene message buses.
-
-```csharp
-builder.Register<IMessageBus>(Lifetime.Scoped)
-    .AsImplementedInterfaces()
-    .AsSelf();
-```
-
-### [Zenject](zenject.md)
-
-Feature-rich DI with extensive Unity integration. Supports complex binding scenarios and sub-containers.
-
-```csharp
-Container.Bind<IMessageBus>()
-    .FromInstance(MessageHandler.MessageBus)
-    .AsSingle();
-```
-
-### [Reflex](reflex.md)
-
-Modern, reflection-free DI designed for performance. Zero-allocation resolution with AOT support.
-
-```csharp
-Container.Singleton<IMessageBus>(MessageHandler.MessageBus);
-```
-
-## Choosing a Framework
-
-| Framework      | Best For                                     | Performance    |
-| -------------- | -------------------------------------------- | -------------- |
-| **VContainer** | Most projects, additive scenes               | ⭐⭐⭐ Fast    |
-| **Zenject**    | Complex projects, existing Zenject codebases | ⭐⭐ Good      |
-| **Reflex**     | Performance-critical, AOT platforms          | ⭐⭐⭐ Fastest |
-
-## Common Patterns
-
-All frameworks support the same core patterns:
-
-1. **Global Bus** — Share `MessageHandler.MessageBus` across all systems
-1. **Scoped Bus** — Create per-scene buses for isolation
-1. **Builder Injection** — Inject `IMessageRegistrationBuilder` for flexible handler registration
-1. **Testable Design** — Mock `IMessageBus` in unit tests
-
-See each framework's guide for detailed examples and best practices.

package/docs/integrations/index.md.meta

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

package/docs/integrations/reflex.md

@@ -1,317 +0,0 @@
-# DxMessaging + Reflex
-
-[← Back to Integrations Overview](index.md)
-
----
-
-## Overview
-
-**Reflex** is a minimal, lightweight dependency injection framework for Unity. DxMessaging integrates with Reflex, allowing you to:
-
-- **Inject `IMessageBus`** in any class with minimal overhead
-- **Use DI for construction** + DxMessaging for events (best of both worlds)
-- **Minimal API surface** — small number of concepts to understand
-- **Compatible** — Reflex and DxMessaging can be used together
-
-**Why combine DI + Messaging?** Use constructor injection for service dependencies (repositories, managers) and messaging for reactive events (damage taken, item collected), combining both approaches.
-
----
-
-## Quick Start
-
-### Prerequisites
-
-- DxMessaging installed via UPM
-- Reflex installed (`gustavopsantos/Reflex`) via source or UPM
-
-### 1. Create a Reflex Installer
-
-```csharp
-using DxMessaging.Core.MessageBus;
-using DxMessaging.Unity.Integrations.Reflex;
-using Reflex.Core;
-
-// Option A: Use IInstaller interface (recommended for explicit registration)
-public sealed class DxMessagingInstaller : IInstaller
-{
-    public void InstallBindings(ContainerBuilder containerBuilder)
-    {
-        // Bind MessageBus as singleton implementing IMessageBus
-        containerBuilder.AddSingleton(
-            typeof(MessageBus),
-            typeof(MessageBus),
-            typeof(IMessageBus)
-        );
-
-        // Optional: Enable automatic IMessageRegistrationBuilder binding
-        // Install the DxMessagingRegistrationInstaller to get IMessageRegistrationBuilder
-        #if REFLEX_PRESENT
-        new DxMessagingRegistrationInstaller().InstallBindings(containerBuilder);
-        #endif
-    }
-}
-
-// Option B: Extend Installer base class (common pattern)
-public sealed class DxMessagingInstallerAlt : Installer
-{
-    protected override void InstallBindings()
-    {
-        Container.Bind<MessageBus>().AsSingleton();
-        Container.Bind<IMessageBus>().FromContainer<MessageBus>();
-    }
-}
-```
-
-**Note:** You must import the `DxMessaging.Unity.Integrations.Reflex` namespace to access `DxMessagingRegistrationInstaller`.
-
-#### Add to your scene
-
-1. Create a `SceneContext` or `ProjectContext` in your scene
-1. Add `DxMessagingInstaller` to the installers list
-1. Reflex will now inject `IMessageBus` automatically
-
----
-
-## Usage Patterns
-
-### Pattern 1: Inject into Plain Classes (Recommended for Services)
-
-Use `IMessageRegistrationBuilder` to create message handlers in non-MonoBehaviour classes:
-
-```csharp
-using DxMessaging.Core.MessageBus;
-using DxMessaging.Core.Attributes;
-
-// Define a message
-[DxUntargetedMessage]
-[DxAutoConstructor]
-public readonly partial struct PlayerDamaged
-{
-    public readonly int damage;
-}
-
-// Service that listens to messages
-public sealed class DamageService
-{
-    private readonly MessageRegistrationLease _lease;
-
-    // Builder is injected automatically when using the installer
-    public DamageService(IMessageRegistrationBuilder registrationBuilder)
-    {
-        var options = new MessageRegistrationBuildOptions
-        {
-            Configure = token =>
-            {
-                _ = token.RegisterUntargeted<PlayerDamaged>(OnPlayerDamaged);
-            }
-        };
-
-        _lease = registrationBuilder.Build(options);
-    }
-
-    public void Initialize()
-    {
-        _lease.Activate();  // Start listening
-    }
-
-    public void Dispose()
-    {
-        _lease.Dispose();   // Clean up
-    }
-
-    private static void OnPlayerDamaged(ref PlayerDamaged message)
-    {
-        UnityEngine.Debug.Log($"Player took {message.damage} damage!");
-    }
-}
-```
-
-#### Register the service in your installer
-
-```csharp
-// Using IInstaller interface
-public void InstallBindings(ContainerBuilder containerBuilder)
-{
-    containerBuilder.AddSingleton(typeof(DamageService), typeof(DamageService));
-    // Call Initialize() from a bootstrap MonoBehaviour
-}
-
-// Or using Installer base class
-protected override void InstallBindings()
-{
-    Container.Bind<DamageService>().AsSingleton();
-    // Call Initialize() from a bootstrap MonoBehaviour
-}
-```
-
-**Note:** Reflex doesn't have lifecycle interfaces like `IInitializable`. Call `Initialize()` and `Dispose()` manually from a controlling MonoBehaviour or bootstrap script.
-
----
-
-### Pattern 2: Configure MessagingComponents (For Existing MonoBehaviours)
-
-```csharp
-using DxMessaging.Core.MessageBus;
-using DxMessaging.Unity;
-using Reflex.Attributes;
-using UnityEngine;
-
-[DisallowMultipleComponent]
-[RequireComponent(typeof(MessagingComponent))]
-public sealed class MessagingComponentConfigurator : MonoBehaviour
-{
-    [Inject]
-    private IMessageBus _messageBus;
-
-    private void Awake()
-    {
-        GetComponent<MessagingComponent>().Configure(
-            _messageBus,
-            MessageBusRebindMode.RebindActive
-        );
-    }
-}
-```
-
-#### Usage
-
-1. Add `MessagingComponentConfigurator` alongside any `MessagingComponent` in your prefabs
-1. Reflex will inject the bus in `Awake()` before handlers are registered
-1. Your message handlers now use the container-managed bus
-
----
-
-### Pattern 3: Inject IMessageBus Directly
-
-For simple emission without listening, inject `IMessageBus` directly:
-
-```csharp
-public sealed class GameBootstrap : MonoBehaviour
-{
-    [Inject]
-    private IMessageBus _messageBus;
-
-    private void Start()
-    {
-        var message = new GameStarted();
-        _messageBus.EmitUntargeted(ref message);
-    }
-}
-```
-
----
-
-## Advanced: Object Pooling
-
-When using object pooling with Reflex:
-
-```csharp
-public sealed class EnemyPool
-{
-    private readonly Container _container;
-    private readonly Queue<Enemy> _pool = new();
-
-    public EnemyPool(Container container)
-    {
-        _container = container;
-    }
-
-    public Enemy Spawn()
-    {
-        Enemy enemy;
-        if (_pool.Count > 0)
-        {
-            enemy = _pool.Dequeue();
-        }
-        else
-        {
-            enemy = Object.Instantiate(enemyPrefab);
-            _container.Inject(enemy);  // Inject dependencies
-        }
-        return enemy;
-    }
-
-    public void Return(Enemy enemy)
-    {
-        _pool.Enqueue(enemy);
-    }
-}
-```
-
----
-
-## Testing with Reflex
-
-### Unit Tests
-
-```csharp
-using DxMessaging.Core.MessageBus;
-using Reflex.Core;
-using NUnit.Framework;
-
-[TestFixture]
-public class DamageServiceTests
-{
-    [Test]
-    public void Initialize_ListensToMessages()
-    {
-        // Arrange
-        var builder = new ContainerBuilder();
-        var bus = new MessageBus();
-        builder.AddSingleton<IMessageBus>(bus);
-        builder.AddSingleton<DamageService>();
-        var container = builder.Build();
-
-        bool messageReceived = false;
-        var handler = new MessageHandler(new InstanceId(1), bus) { active = true };
-        var token = MessageRegistrationToken.Create(handler, bus);
-        _ = token.RegisterUntargeted<PlayerDamaged>(ref msg => messageReceived = true);
-        token.Enable();
-
-        // Act
-        var service = container.Resolve<DamageService>();
-        service.Initialize();
-        var message = new PlayerDamaged(25);
-        bus.EmitUntargeted(ref message);
-
-        // Assert
-        Assert.IsTrue(messageReceived);
-    }
-}
-```
-
----
-
-## Checklist
-
-### Initial Setup
-
-- [ ] Install DxMessaging and Reflex
-- [ ] Create `DxMessagingInstaller` with bus bindings
-- [ ] Add installer to your `SceneContext` or `ProjectContext`
-- [ ] Import `DxMessaging.Unity.Integrations.Reflex` and install `DxMessagingRegistrationInstaller` for `IMessageRegistrationBuilder` support
-
-### Integration
-
-- [ ] Use `IMessageRegistrationBuilder` in plain classes
-- [ ] Call `Initialize()` and `Dispose()` manually from a bootstrap script
-- [ ] Add `MessagingComponentConfigurator` to prefabs with `MessagingComponent`
-- [ ] Replace `MessageHandler.MessageBus` references with injected `IMessageBus`
-
-### Pooling
-
-- [ ] Use `container.Inject(instance)` for pooled objects
-- [ ] Ensure injection happens before message handlers are registered
-
-### Testing
-
-- [ ] Create isolated `ContainerBuilder` instances in tests
-- [ ] Use `builder.AddSingleton<IMessageBus>(new MessageBus())` for test buses
-
----
-
-## Next Steps
-
-- **[Zenject Integration](zenject.md)** — Full-featured DI with extensive Unity support
-- **[VContainer Integration](vcontainer.md)** — Lightweight alternative with scoped lifetimes
-- **[Back to Documentation Hub](../getting-started/index.md)** — Browse all docs

package/docs/integrations/reflex.md.meta

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