com.wallstop-studios.dxmessaging 2.1.4 → 2.1.6

package/{Docs/InterceptorsAndOrdering.md → docs/concepts/interceptors-and-ordering.md}

@@ -23,10 +23,12 @@ _ = token.RegisterUntargeted<GameEvent>(msg => {
 });
 
 // First emission: only the original handler runs
-new GameEvent().Emit();  // DoWork() executes, ProcessLater() does NOT
+var firstEvent = new GameEvent();
+firstEvent.Emit();  // DoWork() executes, ProcessLater() does NOT
 
 // Second emission: both handlers run
-new GameEvent().Emit();  // Both DoWork() and ProcessLater() execute
+var secondEvent = new GameEvent();
+secondEvent.Emit();  // Both DoWork() and ProcessLater() execute
 ```
 
 ##### Why this matters
@@ -36,7 +38,7 @@ new GameEvent().Emit();  // Both DoWork() and ProcessLater() execute
 - Ensures all listeners see a consistent view of the registration state
 - Makes debugging and reasoning about message flow easier
 
-This snapshot behavior is extensively tested in the [Mutation During Emission tests](../Tests/Runtime/Core/MutationDuringEmissionTests.cs).
+This snapshot behavior is extensively tested in the [Mutation During Emission tests](https://github.com/wallstop/DxMessaging/blob/master/Tests/Runtime/Core/MutationDuringEmissionTests.cs).
 
 ---
 
@@ -83,51 +85,41 @@ Visual overview
 
 ```mermaid
 flowchart LR
-  subgraph Untargeted["<b>Untargeted Messages</b>"]
+  subgraph Untargeted["Untargeted Messages"]
     direction TB
-    U1["Interceptors&lt;T&gt;"] --> U2[Global Accept‑All Untargeted]
-    U2 --> U3["Handlers&lt;T&gt;"]
-    U3 --> U4["Post‑Processors&lt;T&gt;"]
+    U1["Interceptors(T)"] --> U2[Global Accept‑All Untargeted]
+    U2 --> U3["Handlers(T)"]
+    U3 --> U4["Post‑Processors(T)"]
   end
 
-  subgraph Targeted["<b>Targeted Messages</b>"]
+  subgraph Targeted["Targeted Messages"]
     direction TB
-    T1["Interceptors&lt;T&gt;"] --> T2[Global Accept‑All Targeted]
-    T2 --> T3["Handlers&lt;T&gt; @ target"]
-    T3 --> T4["Handlers&lt;T&gt; (All Targets)"]
-    T4 --> T5["Post‑Processors&lt;T&gt; @ target"]
-    T5 --> T6["Post‑Processors&lt;T&gt; (All Targets)"]
+    T1["Interceptors(T)"] --> T2[Global Accept‑All Targeted]
+    T2 --> T3["Handlers(T) @ target"]
+    T3 --> T4["Handlers(T) (All Targets)"]
+    T4 --> T5["Post‑Processors(T) @ target"]
+    T5 --> T6["Post‑Processors(T) (All Targets)"]
   end
 
-  subgraph Broadcast["<b>Broadcast Messages</b>"]
+  subgraph Broadcast["Broadcast Messages"]
     direction TB
-    B1["Interceptors&lt;T&gt;"] --> B2[Global Accept‑All Broadcast]
-    B2 --> B3["Handlers&lt;T&gt; @ source"]
-    B3 --> B4["Handlers&lt;T&gt; (All Sources)"]
-    B4 --> B5["Post‑Processors&lt;T&gt; @ source"]
-    B5 --> B6["Post‑Processors&lt;T&gt; (All Sources)"]
+    B1["Interceptors(T)"] --> B2[Global Accept‑All Broadcast]
+    B2 --> B3["Handlers(T) @ source"]
+    B3 --> B4["Handlers(T) (All Sources)"]
+    B4 --> B5["Post‑Processors(T) @ source"]
+    B5 --> B6["Post‑Processors(T) (All Sources)"]
   end
 
-  style Untargeted fill:#f0f0f0,stroke:#666,stroke-width:2px,color:#000
-  style Targeted fill:#f0f0f0,stroke:#666,stroke-width:2px,color:#000
-  style Broadcast fill:#f0f0f0,stroke:#666,stroke-width:2px,color:#000
-
-  style U1 fill:#ffe7ba,stroke:#d48806,stroke-width:2px,color:#000
-  style U2 fill:#d3adf7,stroke:#531dab,stroke-width:2px,color:#000
-  style U3 fill:#91d5ff,stroke:#096dd9,stroke-width:2px,color:#000
-  style U4 fill:#95de64,stroke:#237804,stroke-width:2px,color:#000
-  style T1 fill:#ffe7ba,stroke:#d48806,stroke-width:2px,color:#000
-  style T2 fill:#d3adf7,stroke:#531dab,stroke-width:2px,color:#000
-  style T3 fill:#91d5ff,stroke:#096dd9,stroke-width:2px,color:#000
-  style T4 fill:#91d5ff,stroke:#096dd9,stroke-width:2px,color:#000
-  style T5 fill:#95de64,stroke:#237804,stroke-width:2px,color:#000
-  style T6 fill:#95de64,stroke:#237804,stroke-width:2px,color:#000
-  style B1 fill:#ffe7ba,stroke:#d48806,stroke-width:2px,color:#000
-  style B2 fill:#d3adf7,stroke:#531dab,stroke-width:2px,color:#000
-  style B3 fill:#91d5ff,stroke:#096dd9,stroke-width:2px,color:#000
-  style B4 fill:#91d5ff,stroke:#096dd9,stroke-width:2px,color:#000
-  style B5 fill:#95de64,stroke:#237804,stroke-width:2px,color:#000
-  style B6 fill:#95de64,stroke:#237804,stroke-width:2px,color:#000
+  classDef neutral stroke-width:2px
+  class Untargeted,Targeted,Broadcast neutral
+  classDef warning stroke-width:2px
+  class U1,T1,B1 warning
+  classDef accent stroke-width:2px
+  class U2,T2,B2 accent
+  classDef primary stroke-width:2px
+  class U3,T3,T4,B3,B4 primary
+  classDef success stroke-width:2px
+  class U4,T5,T6,B5,B6 success
 ```
 
 Example sequence
@@ -171,7 +163,7 @@ _ = bus.RegisterTargetedInterceptor<TookDamage>(
 
 Real‑World Use Cases
 
-###### State‑Based Message Cancellation
+#### State‑Based Message Cancellation
 
 Prevent UI messages from being processed based on current UI state:
 
@@ -224,11 +216,13 @@ var uiManager = new UIStateManager();
 uiManager.RegisterInterceptors();
 uiManager.EnterCutscene();
 
-new OpenMenu("inventory").Emit();  // Cancelled by interceptor
-new ShowDialog("Hello!").Emit();   // Cancelled by interceptor
+var openMenu = new OpenMenu("inventory");
+openMenu.Emit();  // Cancelled by interceptor
+var showDialog = new ShowDialog("Hello!");
+showDialog.Emit();  // Cancelled by interceptor
 ```
 
-###### Value Clamping and Normalization
+#### Value Clamping and Normalization
 
 Ensure message data stays within valid ranges:
 
@@ -275,11 +269,12 @@ var normalizer = new InputNormalizer();
 normalizer.RegisterInterceptors();
 
 // Even invalid input gets cleaned
-new MovementInput(new Vector2(100, 200), 9999f).Emit();
+var input = new MovementInput(new Vector2(100, 200), 9999f);
+input.Emit();
 // Handlers receive: direction=(0.45, 0.89), speed=10.0
 ```
 
-###### Permission and Authorization Checks
+#### Permission and Authorization Checks
 
 Block messages that violate game rules or permissions:
 
@@ -349,13 +344,15 @@ var permissions = new PermissionSystem(playerDataService);
 permissions.RegisterInterceptors();
 
 // This will be blocked if player doesn't have 100 currency
-new SpendCurrency(100).EmitTargeted(playerId);
+var spendCurrency = new SpendCurrency(100);
+spendCurrency.EmitTargeted(playerId);
 
 // This will be blocked if achievement is already unlocked
-new UnlockAchievement("first_boss").EmitTargeted(playerId);
+var unlockAchievement = new UnlockAchievement("first_boss");
+unlockAchievement.EmitTargeted(playerId);
 ```
 
-###### Message Enrichment and Context Addition
+#### Message Enrichment and Context Addition
 
 Add contextual data to messages as they flow through the system:
 
@@ -410,11 +407,12 @@ var enricher = new TelemetryEnricher(Guid.NewGuid().ToString());
 enricher.RegisterInterceptors();
 
 // Emit without timestamp/session - interceptor adds them
-new PlayerAction("jump").EmitTargeted(playerId);
+var action = new PlayerAction("jump");
+action.EmitTargeted(playerId);
 // Handlers receive fully enriched message with timestamp and sessionId
 ```
 
-###### Cooldown and Rate Limiting
+#### Cooldown and Rate Limiting
 
 Prevent message spam by enforcing cooldowns:
 
@@ -467,10 +465,13 @@ public class CooldownManager
 var cooldowns = new CooldownManager();
 cooldowns.RegisterInterceptors();
 
-new CastSpell("fireball").EmitTargeted(playerId);  // ✓ Allowed
-new CastSpell("fireball").EmitTargeted(playerId);  // ✗ Blocked (too soon)
+var spell1 = new CastSpell("fireball");
+spell1.EmitTargeted(playerId);  // ✓ Allowed
+var spell2 = new CastSpell("fireball");
+spell2.EmitTargeted(playerId);  // ✗ Blocked (too soon)
 // ... wait 1.5s ...
-new CastSpell("fireball").EmitTargeted(playerId);  // ✓ Allowed
+var spell3 = new CastSpell("fireball");
+spell3.EmitTargeted(playerId);  // ✓ Allowed
 ```
 
 When to Use Interceptors
@@ -517,5 +518,5 @@ Global Accept‑All
 
 Related
 
-- [Message Types](MessageTypes.md)
-- [Listening Patterns](ListeningPatterns.md)
+- [Message Types](message-types.md)
+- [Listening Patterns](listening-patterns.md)

package/docs/concepts/interceptors-and-ordering.md.meta

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

package/{Docs/ListeningPatterns.md → docs/concepts/listening-patterns.md}

@@ -1,6 +1,6 @@
 # Listening Patterns
 
-Targeted across all targets
+## Targeted across all targets
 
 - Accept every targeted message of a given type regardless of who it’s for.
 
@@ -10,14 +10,14 @@ using DxMessaging.Core.Messages;
 
 // Observe all Heal messages and their intended targets
 _ = token.RegisterTargetedWithoutTargeting<Heal>(OnAnyHeal);
-void OnAnyHeal(ref InstanceId target, ref Heal m) => Audit(target, m);
+void OnAnyHeal(InstanceId target, Heal m) => Audit(target, m);
 
 // Post‑process all targeted of type
 _ = token.RegisterTargetedWithoutTargetingPostProcessor<Heal>(OnAnyHealPost);
-void OnAnyHealPost(ref InstanceId target, ref Heal m) => Log(target, m);
+void OnAnyHealPost(InstanceId target, Heal m) => Log(target, m);
 ```
 
-Broadcast across all sources
+## Broadcast across all sources
 
 - Accept every broadcast message of a given type regardless of who emitted it.
 
@@ -27,14 +27,14 @@ using DxMessaging.Core.Messages;
 
 // Observe all TookDamage messages and their sources
 _ = token.RegisterBroadcastWithoutSource<TookDamage>(OnAnyTookDamage);
-void OnAnyTookDamage(ref InstanceId source, ref TookDamage m) => Track(source, m);
+void OnAnyTookDamage(InstanceId source, TookDamage m) => Track(source, m);
 
 // Post‑process all broadcast of type
 _ = token.RegisterBroadcastWithoutSourcePostProcessor<TookDamage>(OnAnyTookDamagePost);
 void OnAnyTookDamagePost(InstanceId source, TookDamage m) => Log(source, m);
 ```
 
-Global accept‑all (debug/inspection)
+## Global accept‑all (debug/inspection)
 
 - Receive every message of every type on a handler; useful for tooling.
 
@@ -47,9 +47,9 @@ var dereg = bus.RegisterGlobalAcceptAll(handler);
 // implement handler callbacks for generic categories on your MessageHandler
 ```
 
-Real‑World Use Cases
+## Real‑World Use Cases
 
-## Development Debug Dump
+### Development Debug Dump
 
 Capture all messages during development for debugging and diagnostics:
 
@@ -172,12 +172,14 @@ public class NetworkReplicator : MessageHandler
 var replicator = new NetworkReplicator(networkManager) { active = true };
 _ = MessageHandler.MessageBus.RegisterGlobalAcceptAll(replicator);
 
-// These messages now "just work" across the network
-new PlayerMoved(playerPos).Emit();
-new DealDamage(50f).EmitTargeted(enemyId);
+// These messages are now replicated across the network
+var playerMoved = new PlayerMoved(playerPos);
+playerMoved.Emit();
+var dealDamage = new DealDamage(50f);
+dealDamage.EmitTargeted(enemyId);
 ```
 
-#### Message Analytics and Metrics
+### Message Analytics and Metrics
 
 Track message frequency and performance across your entire game:
 
@@ -245,7 +247,7 @@ When to Use Global Accept‑All
 - Message replay/recording systems
 
 ⚠️ **Performance consideration:**
-Global Accept‑All handlers are invoked for **every** message of **every** type. For high‑performance gameplay logic, prefer type‑specific registrations which use O(1) lookup instead of O(N) iteration.
+Global Accept-All handlers are invoked for **every** message of **every** type. For performance-sensitive gameplay logic, prefer type-specific registrations which use O(1) lookup instead of O(N) iteration.
 
 ❌ **Avoid for:**
 
@@ -260,5 +262,5 @@ Tips
 
 Related
 
-- [Interceptors & Ordering](InterceptorsAndOrdering.md)
-- [Diagnostics](Diagnostics.md)
+- [Interceptors & Ordering](interceptors-and-ordering.md)
+- [Diagnostics](../guides/diagnostics.md)

package/docs/concepts/listening-patterns.md.meta

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