com.wallstop-studios.dxmessaging 2.1.4 → 2.1.5

package/docs/getting-started/index.md

@@ -0,0 +1,316 @@
+# DxMessaging Documentation Hub
+
+This is the documentation for DxMessaging, a type-safe messaging system for Unity.
+
+## Visual Documentation Map
+
+```mermaid
+%%{init: {'theme': 'neutral'}}%%
+graph TD
+    Start[START HERE<br/>Visual Guide<br/>5 minutes]
+    Start --> Quick[Quick Start<br/>5 min]
+    Start --> Getting[Getting Started<br/>10 min]
+    Start --> Overview[Overview<br/>5 min]
+    Quick --> Patterns[Patterns & Samples<br/>Hands-on!]
+    Getting --> Patterns
+    Overview --> Patterns
+
+    classDef primary stroke-width:3px
+    class Start primary
+    classDef success stroke-width:2px
+    class Patterns success
+    classDef secondary stroke-width:2px
+    class Quick,Getting,Overview secondary
+```
+
+## Table of Contents
+
+- [New to DxMessaging](#new-to-dxmessaging)
+- [Learning Path](#learning-path)
+- [Core Documentation](#core-documentation)
+- [Reference](#reference)
+- [Examples and Samples](#examples-and-samples)
+- [By Use Case](#by-use-case)
+- [Quick Start Path](#quick-start-path)
+
+---
+
+## New to DxMessaging
+
+**Never used a messaging system before?** Start here:
+
+1. **[Visual Guide](visual-guide.md)** - Beginner-friendly visual introduction (5 min)
+1. **[Getting Started Guide](getting-started.md)** - Comprehensive guide with examples (10 min)
+1. **[Quick Start](quick-start.md)** - Your first working message (5 min)
+1. **[Overview](overview.md)** - What DxMessaging is and why it exists (5 min)
+
+## Learning Path
+
+### For Absolute Beginners (Never Used Messaging Before)
+
+1. Read [Visual Guide](visual-guide.md) (5 min) - Pictures and analogies!
+1. Read [Getting Started](getting-started.md) (10 min) - Complete introduction
+1. Try [Quick Start](quick-start.md) (5 min) - Hands-on tutorial
+1. Understand [Message Types](../concepts/message-types.md) (10 min) - When to use what
+1. Study [Common Patterns](../guides/patterns.md) (15 min) - Real examples
+
+### For Advanced Users
+
+1. Master [Interceptors & Ordering](../concepts/interceptors-and-ordering.md)
+1. Explore [Listening Patterns](../concepts/listening-patterns.md)
+1. Deep dive into [Design & Architecture](../architecture/design-and-architecture.md)
+1. Review [Advanced Topics](../guides/advanced.md)
+
+## Core Documentation
+
+### Essentials
+
+- **[Visual Guide](visual-guide.md)** - Beginner-friendly visual introduction with pictures and analogies
+- **[Getting Started](getting-started.md)** - Complete beginner's guide with mental models
+- **[Overview](overview.md)** - What and why
+- **[Quick Start](quick-start.md)** - First message in 5 minutes
+- **[Message Types](../concepts/message-types.md)** - When to use Untargeted/Targeted/Broadcast
+- **[Comparisons](../architecture/comparisons.md)** - DxMessaging vs C# Events, UnityEvents, SendMessage
+
+### Core Concepts
+
+- **[Interceptors & Ordering](../concepts/interceptors-and-ordering.md)** - Validate, transform, control execution
+- **[Listening Patterns](../concepts/listening-patterns.md)** - All the ways to receive messages
+- **[Targeting & Context](../concepts/targeting-and-context.md)** - GameObject vs Component
+- **[Patterns](../guides/patterns.md)** - Real-world usage patterns
+
+### Unity Integration
+
+- **[Unity Integration](../guides/unity-integration.md)** - MessagingComponent, MessageAwareComponent
+- **[Diagnostics](../guides/diagnostics.md)** - Inspector tools, debugging, observability
+
+### Architecture & Performance
+
+- **[Design & Architecture](../architecture/design-and-architecture.md)** - Deep dive into internals and optimizations
+- **[Performance Benchmarks](../architecture/performance.md)** - OS-specific tables auto-generated by tests
+- **[Advanced](../guides/advanced.md)** - Lifecycles, safety, manual control
+
+## Reference
+
+### Quick Lookups
+
+- **[Glossary](../reference/glossary.md)** - All terms explained in plain English
+- **[Quick Reference](../reference/quick-reference.md)** - API cheat sheet
+- **[API Reference](../reference/reference.md)** - Complete API documentation
+- **[FAQ](../reference/faq.md)** - Common questions
+- **[Troubleshooting](../reference/troubleshooting.md)** - Solving common issues
+
+### Tools & Utilities
+
+- **[Helpers](../reference/helpers.md)** - Source generators, attributes, extensions
+- **[Message Bus Providers](../advanced/message-bus-providers.md)** - Provider system and MessageBusProviderHandle for flexible bus configuration
+- **[Runtime Configuration](../advanced/runtime-configuration.md)** - Setting message buses at runtime, re-binding registrations
+- **[Registration Builders](../advanced/registration-builders.md)** - Fluent API for building message registrations
+- **[Emit Shorthands](../advanced/emit-shorthands.md)** - `Emit`/`EmitAt`/`EmitFrom` usage and pitfalls
+- **[String Messages](../advanced/string-messages.md)** - Prototyping and debugging
+- **[Compatibility](../reference/compatibility.md)** - Unity versions and render pipelines
+- **[Install](install.md)** - Installation guide
+
+## Examples and Samples
+
+### Unity Samples (Importable!)
+
+**Located in `Samples~/` directory** - Import via Unity Package Manager!
+
+- **[Mini Combat](https://github.com/wallstop/DxMessaging/blob/master/Samples~/Mini%20Combat/README.md)** - Interactive combat demo with Heal/Damage messages
+  - Perfect first example to understand message flow
+  - Shows Targeted and Broadcast messages in action
+  - Complete working scene you can play with
+
+- **[UI Buttons + Inspector](https://github.com/wallstop/DxMessaging/blob/master/Samples~/UI%20Buttons%20%2B%20Inspector/README.md)** - Interactive diagnostics demo
+  - See the Inspector diagnostics in action
+  - Explore message history and handler registrations
+  - Great for debugging and understanding the system
+
+### Code Examples (In Docs)
+
+- **[End-to-End Example](../examples/end-to-end.md)** - Complete feature walkthrough
+- **[Scene Transitions Example](../examples/end-to-end-scene-transitions.md)** - Scene management pattern
+
+### Real-World Patterns
+
+From [Common Patterns](../guides/patterns.md):
+
+- Scene-wide events (Untargeted)
+- Directed commands (Targeted)
+- Observability (Broadcast)
+- Validation with Interceptors
+- Analytics with Post-Processors
+- Local bus islands for testing
+
+## By Use Case
+
+### "I want to..."
+
+- **Decouple my systems** - Start with [Getting Started](getting-started.md)
+- **Replace C# events** - See [Comparisons](../architecture/comparisons.md)
+- **Send a command to one object** - Use [Targeted Messages](../concepts/message-types.md#targeted-messages)
+- **Broadcast an event** - Use [Broadcast Messages](../concepts/message-types.md#broadcast-messages)
+- **Notify globally** - Use [Untargeted Messages](../concepts/message-types.md#untargeted-messages)
+- **Validate messages before execution** - Learn [Interceptors](../concepts/interceptors-and-ordering.md)
+- **Track all damage/events** - See [Listening Without Context](../concepts/listening-patterns.md)
+- **Debug message flow** - Use [Diagnostics](../guides/diagnostics.md)
+- **Optimize performance** - Read [Performance Tips](../architecture/design-and-architecture.md#performance-optimizations)
+- **Isolate tests** - Create [Local Bus Islands](../guides/patterns.md#6-local-bus-islands)
+- **Use dependency injection** - [DxMessaging + Zenject](../integrations/zenject.md), [DxMessaging + VContainer](../integrations/vcontainer.md), [DxMessaging + Reflex](../integrations/reflex.md)
+- **Configure buses at runtime** - See [Runtime Configuration](../advanced/runtime-configuration.md)
+- **Use message bus providers** - Learn [Message Bus Providers](../advanced/message-bus-providers.md)
+
+## Visual: Message Pipeline
+
+Every message flows through 3 stages:
+
+```mermaid
+%%{init: {'theme': 'neutral'}}%%
+flowchart LR
+    P[Producer] --> I[Interceptors<br/>validate/mutate/cancel]
+    I --> H[Handlers<br/>main logic by priority]
+    H --> PP[Post-Processors<br/>analytics/logging]
+
+    classDef neutral stroke-width:2px
+    class P neutral
+    classDef warning stroke-width:2px
+    class I warning
+    classDef primary stroke-width:2px
+    class H primary
+    classDef success stroke-width:2px
+    class PP success
+```
+
+## Learning Resources
+
+### Must-Read Docs (In Order)
+
+1. **[Getting Started](getting-started.md)** - Start here! (10 min)
+1. **[Message Types](../concepts/message-types.md)** - Choose the right type (10 min)
+1. **[Patterns](../guides/patterns.md)** - See real examples (15 min)
+1. **[Diagnostics](../guides/diagnostics.md)** - Debug like a pro (10 min)
+1. **[Design & Architecture](../architecture/design-and-architecture.md)** - Understand the internals (30 min)
+
+### Feature-Specific
+
+- **Priority & Ordering** - [Interceptors & Ordering](../concepts/interceptors-and-ordering.md)
+- **Global Observers** - [Listening Patterns](../concepts/listening-patterns.md)
+- **Unity Lifecycle** - [Unity Integration](../guides/unity-integration.md)
+- **Performance** - [Design & Architecture](../architecture/design-and-architecture.md)
+
+## Comparison Charts
+
+### DxMessaging vs Alternatives
+
+From [Comparisons](../architecture/comparisons.md):
+
+| Feature          | DxMessaging | C# Events | UnityEvents | Static Bus |
+| ---------------- | ----------- | --------- | ----------- | ---------- |
+| Decoupling       | Full        | Tight     | Hidden      | Yes        |
+| Lifecycle Safety | Auto        | Manual    | Unity       | Manual     |
+| Execution Order  | Priority    | Random    | Random      | Random     |
+| Observability    | Built-in    | No        | No          | No         |
+| Performance      | Zero-alloc  | Good      | Boxing      | Good       |
+
+## Search by Topic
+
+### Concepts
+
+- **Messages** - [Message Types](../concepts/message-types.md), [Getting Started](getting-started.md)
+- **Handlers** - [Listening Patterns](../concepts/listening-patterns.md), [Unity Integration](../guides/unity-integration.md)
+- **Lifecycle** - [Advanced](../guides/advanced.md), [Unity Integration](../guides/unity-integration.md)
+- **Performance** - [Design & Architecture](../architecture/design-and-architecture.md)
+- **Testing** - [Patterns](../guides/patterns.md#6-local-bus-islands), [Testing Guide](../guides/testing.md)
+
+### Features
+
+- **Interceptors** - [Interceptors & Ordering](../concepts/interceptors-and-ordering.md)
+- **Post-Processors** - [Interceptors & Ordering](../concepts/interceptors-and-ordering.md)
+- **Priorities** - [Interceptors & Ordering](../concepts/interceptors-and-ordering.md)
+- **Global Accept-All** - [Listening Patterns](../concepts/listening-patterns.md)
+- **Diagnostics** - [Diagnostics](../guides/diagnostics.md)
+- **Local Buses** - [Design & Architecture](../architecture/design-and-architecture.md)
+
+### Components
+
+- **MessageBus** - [Design & Architecture](../architecture/design-and-architecture.md#the-message-bus)
+- **MessageHandler** - [API Reference](../reference/reference.md)
+- **MessageRegistrationToken** - [Unity Integration](../guides/unity-integration.md), [Advanced](../guides/advanced.md)
+- **MessageAwareComponent** - [Unity Integration](../guides/unity-integration.md), [Getting Started](getting-started.md)
+- **MessagingComponent** - [Unity Integration](../guides/unity-integration.md)
+
+## Complete Document List
+
+### Getting Started
+
+- [Visual Guide](visual-guide.md) - Perfect for beginners
+- [Getting Started Guide](getting-started.md)
+- [Overview](overview.md)
+- [Quick Start](quick-start.md)
+- [Install](install.md)
+
+### Core Concepts
+
+- [Message Types](../concepts/message-types.md)
+- [Interceptors & Ordering](../concepts/interceptors-and-ordering.md)
+- [Listening Patterns](../concepts/listening-patterns.md)
+- [Targeting & Context](../concepts/targeting-and-context.md)
+
+### Unity
+
+- [Unity Integration](../guides/unity-integration.md)
+- [Diagnostics](../guides/diagnostics.md)
+- [Patterns](../guides/patterns.md)
+
+### Deep Dives
+
+- [Design & Architecture](../architecture/design-and-architecture.md)
+- [Advanced](../guides/advanced.md)
+- [Comparisons](../architecture/comparisons.md)
+
+### Reference
+
+- [Quick Reference](../reference/quick-reference.md)
+- [API Reference](../reference/reference.md)
+- [Helpers](../reference/helpers.md)
+- [FAQ](../reference/faq.md)
+- [Troubleshooting](../reference/troubleshooting.md)
+
+### Dependency Injection
+
+- [Runtime Configuration](../advanced/runtime-configuration.md) - Setting and overriding message buses, re-binding registrations
+- [Message Bus Providers](../advanced/message-bus-providers.md) - Provider system and MessageBusProviderHandle
+- [DxMessaging + Zenject](../integrations/zenject.md) - Zenject integration guide
+- [DxMessaging + VContainer](../integrations/vcontainer.md) - VContainer integration guide
+- [DxMessaging + Reflex](../integrations/reflex.md) - Reflex integration guide
+
+### Miscellaneous
+
+- [String Messages](../advanced/string-messages.md)
+- [Compatibility](../reference/compatibility.md)
+- [End-to-End Example](../examples/end-to-end.md)
+- [Scene Transitions Example](../examples/end-to-end-scene-transitions.md)
+- [Mini Combat Sample](https://github.com/wallstop/DxMessaging/blob/master/Samples~/Mini%20Combat/README.md)
+- [UI Buttons + Inspector Sample](https://github.com/wallstop/DxMessaging/blob/master/Samples~/UI%20Buttons%20%2B%20Inspector/README.md)
+
+---
+
+## Quick Start Path
+
+**Absolute Beginner?** Follow this 30-minute path:
+
+1. 5 min: [Visual Guide](visual-guide.md) - Start here for pictures & analogies!
+1. 10 min: [Getting Started](getting-started.md) - Deep dive
+1. 5 min: [Quick Start](quick-start.md) - Hands-on code
+1. 10 min: Try a [Sample](https://github.com/wallstop/DxMessaging/blob/master/Samples~/Mini%20Combat/README.md) - See it in action
+
+**Want to go deep?** Continue with:
+
+1. 15 min: [Patterns](../guides/patterns.md)
+1. 20 min: [Interceptors & Ordering](../concepts/interceptors-and-ordering.md)
+1. 30 min: [Design & Architecture](../architecture/design-and-architecture.md)
+
+---
+
+Need help? Check [FAQ](../reference/faq.md) or [Troubleshooting](../reference/troubleshooting.md).

package/docs/getting-started/index.md.meta

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

package/docs/getting-started/install.md

@@ -0,0 +1,89 @@
+# Install (Unity UPM)
+
+This page helps you install DxMessaging into a Unity 2021.3+ project using the Unity Package Manager (UPM).
+
+## Quick Reference
+
+| Method                       | Command/URL                                    | Auto-Updates |
+| ---------------------------- | ---------------------------------------------- | ------------ |
+| **OpenUPM** (Recommended)    | `openupm add com.wallstop-studios.dxmessaging` | Yes          |
+| **Git URL**                  | `https://github.com/wallstop/DxMessaging.git`  | No           |
+| **NPM Scoped Registry**      | Add registry + resolve                         | Yes          |
+| **From Releases**            | Download .unitypackage                         | No           |
+| **From Source**              | Clone/download zip                             | No           |
+| **Manual** (not recommended) | Edit manifest.json                             | No           |
+
+## Methods
+
+### OpenUPM (Recommended)
+
+The easiest way to install DxMessaging is via [OpenUPM](https://openupm.com/packages/com.wallstop-studios.dxmessaging/).
+
+If you have the [openupm-cli](https://openupm.com/docs/getting-started.html) installed, run:
+
+```bash
+openupm add com.wallstop-studios.dxmessaging
+```
+
+#### Benefits of OpenUPM
+
+- Automatic update notifications in Unity Package Manager
+- Easy dependency management
+- Simple one-command installation
+- Version history and changelogs available on the [OpenUPM page](https://openupm.com/packages/com.wallstop-studios.dxmessaging/)
+
+**Don't want to install the CLI?** You can also [add OpenUPM as a scoped registry manually](https://openupm.com/docs/getting-started.html).
+
+### Git URL
+
+- Unity Package Manager > Add package from git URL...
+- Paste:
+
+```text
+https://github.com/wallstop/DxMessaging.git
+```
+
+- Click Add. Unity imports the package and its analyzers/generators.
+
+### NPM Scoped Registry
+
+1. Open Unity Package Manager
+1. (Optional) Enable Pre-release packages to get the latest, cutting-edge builds
+1. Open the Advanced Package Settings
+1. Add an entry for a new "Scoped Registry"
+   - Name: `NPM`
+   - URL: `https://registry.npmjs.org`
+   - Scope(s): `com.wallstop-studios.dxmessaging`
+1. Resolve the latest `DxMessaging`
+
+Unity will notify you of version updates when using scoped registries.
+
+### From Releases
+
+Check out the latest [Releases](https://github.com/wallstop/DxMessaging/releases) to grab the Unity Package and import to your project.
+
+### From Source
+
+Grab a copy of this repo (either `git clone` [this repo](https://github.com/wallstop/DxMessaging) or [download a zip of the source](https://github.com/wallstop/DxMessaging/archive/refs/heads/master.zip)) and copy the contents to your project's `Assets` directory.
+
+### Manual - Manifest.json (not recommended)
+
+- Open your project's `Packages/manifest.json` and add:
+
+```json
+{
+  "dependencies": {
+    "com.wallstop-studios.dxmessaging": "https://github.com/wallstop/DxMessaging.git"
+  }
+}
+```
+
+## Minimum Requirements
+
+- Unity 2021.3+ (LTS recommended). See [Compatibility](../reference/compatibility.md) for Unity × Render Pipeline support (Built‑In, URP, HDRP).
+
+## After Installation
+
+- In your project, create a GameObject and add `MessagingComponent` to start sending/receiving.
+- Optional: enable diagnostics in Editor from the MessagingComponent inspector to see live emissions.
+- Jump to [Quick Start](quick-start.md)

package/docs/getting-started/install.md.meta

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

package/{Docs/Overview.md → docs/getting-started/overview.md}

@@ -1,20 +1,20 @@
 # Overview
 
-[← Back to Index](Index.md) | [Getting Started](GettingStarted.md) | [Quick Start](QuickStart.md) | [Visual Guide](VisualGuide.md)
+[Back to Index](index.md) | [Getting Started](getting-started.md) | [Quick Start](quick-start.md) | [Visual Guide](visual-guide.md)
 
 ---
 
-DxMessaging is a high-performance, type-safe messaging system for Unity that **eliminates the three biggest pain points** of traditional event systems:
+DxMessaging is a type-safe messaging system for Unity that **addresses three common pain points** of traditional event systems:
 
-1. **Memory leaks** from forgotten unsubscribes → Automatic lifecycle management
-1. **Tight coupling** creating refactoring nightmares → Full decoupling with no direct references
-1. **Debugging black holes** ("what fired when?") → Built-in Inspector diagnostics
+1. **Memory leaks** from forgotten unsubscribes -> Automatic lifecycle management
+1. **Tight coupling** creating refactoring nightmares -> Full decoupling with no direct references
+1. **Debugging black holes** ("what fired when?") -> Built-in Inspector diagnostics
 
 ## What Problems Does It Solve?
 
 ### For Beginners: "I'm calling methods manually everywhere"
 
-#### Your code probably looks like this
+#### Traditional approaches often look like this
 
 ```csharp
 public class Player : MonoBehaviour {
@@ -32,15 +32,16 @@ public class Player : MonoBehaviour {
 }
 ```
 
-**Every new system = another SerializeField + another manual call.** It's exhausting and brittle.
+**Every new system = another SerializeField + another manual call.** This approach requires frequent updates as systems are added.
 
 ##### DxMessaging fixes this
 
 ```csharp
 void TakeDamage(int amount) {
     health -= amount;
-    new TookDamage(amount).EmitComponentBroadcast(this);
-    // Done! Everything else reacts automatically.
+    var damage = new TookDamage(amount);
+    damage.EmitComponentBroadcast(this);
+    // Subscribed systems react to this message.
 }
 ```
 
@@ -50,26 +51,26 @@ void TakeDamage(int amount) {
 
 ```csharp
 void OnEnable() { GameManager.OnScoreChanged += UpdateUI; }
-void OnDisable() { /* Forgot this? 💀 LEAK! */ }
+void OnDisable() { /* Missing this results in a memory leak: */ }
 ```
 
-**DxMessaging makes leaks impossible** - automatic cleanup when components die.
+DxMessaging manages subscription lifecycle automatically, eliminating the need for manual unsubscribe - cleanup occurs when components are destroyed.
 
 ### For Advanced Devs: "I need observability and control"
 
-- ✅ See message history in Inspector (timestamps, payloads, call counts)
-- ✅ Priority-based execution (no more race conditions)
-- ✅ Interceptors (validate/normalize before handlers)
-- ✅ Global observers (track ALL instances of a message type)
-- ✅ Local bus islands (isolated testing, zero global state)
+- See message history in Inspector (timestamps, payloads, call counts)
+- Priority-based execution (deterministic ordering)
+- Interceptors (validate/normalize before handlers)
+- Global observers (track ALL instances of a message type)
+- Local bus islands (isolated testing, zero global state)
 
 ## What It Solves (Technical)
 
 - **Decoupling without references** - producers/consumers never know about each other
 - **Predictable lifecycle** - explicit tokens tied to Unity component lifecycles
-- **Performance** - struct messages passed by-ref, zero allocations, zero boxing
+- **Performance** - struct messages passed by-ref, designed to minimize allocations and boxing
 - **Observability** - interceptors, post-processors, diagnostics, registration logs
-- **Scalable taxonomy** - three message types (Untargeted/Targeted/Broadcast) cover 99% of use cases
+- **Scalable taxonomy** - three message types (Untargeted/Targeted/Broadcast) cover most common messaging patterns
 
 ## When to Consider DxMessaging
 
@@ -85,7 +86,7 @@ void OnDisable() { /* Forgot this? 💀 LEAK! */ }
 
 - Game jam prototype (<1 week)
 - Tiny project (<1000 lines)
-- Single-system communication (just call the method directly)
+- Single-system communication (call the method directly)
 - You need synchronous return values (DxMessaging is fire-and-forget)
 
 Core ideas
@@ -95,12 +96,12 @@ Core ideas
   - Targeted: Sent to one specific target (e.g., Heal(10) to Player).
   - Broadcast: Emitted from a source; anyone can observe (e.g., TookDamage from Enemy).
 - Ordering: Lower priority runs earlier; same priority uses registration order.
-- Pipeline: Interceptors → Handlers → Post‑Processors, with diagnostics optionally enabled.
-- Unity integration: `MessagingComponent` and `MessageAwareComponent` manage lifecycles cleanly.
+- Pipeline: Interceptors -> Handlers -> Post-Processors, with diagnostics optionally enabled.
+- Unity integration: `MessagingComponent` and `MessageAwareComponent` manage subscription lifecycles automatically.
 
-## Killer Features (What Makes It Special)
+## Key Features
 
-### 🚀 Global Observers: The Unique Advantage
+### Global Observers: Observing All Instances
 
 #### Traditional event systems force you to do this
 
@@ -123,14 +124,14 @@ _ = Token.RegisterBroadcastWithoutSource<TookDamage>(
 );
 ```
 
-**Real-world impact:** Build achievement systems, combat logs, and analytics that work with ANY entity - even ones that don't exist yet.
+**Example use cases:** Achievement systems, combat logs, and analytics that work with any entity - including ones added later.
 
-### Other Killer Features
+### Other Features
 
-- **Priority-based ordering** - eliminate race conditions, control execution flow explicitly
+- **Priority-based ordering** - control execution flow explicitly
 - **Interceptor pipeline** - validate/normalize messages BEFORE handlers run (one validation, all handlers protected)
 - **Local bus islands** - isolated testing with zero global state contamination
-- **Zero-allocation design** - struct messages passed by-ref, no boxing, no GC spikes
+- **Low-allocation design** - struct messages passed by-ref, minimizes boxing and GC pressure
 - **Auto-constructor generation** - `[DxAutoConstructor]` eliminates boilerplate while keeping type safety
 - **Unity-first helpers** - `EmitGameObjectTargeted()`, `EmitComponentBroadcast()` feel natural
 - **Inspector diagnostics** - see message history, registrations, call counts in real-time
@@ -141,17 +142,17 @@ _ = Token.RegisterBroadcastWithoutSource<TookDamage>(
 
 ### Start Here
 
-- → [Visual Guide](VisualGuide.md) (5 min) — Beginner-friendly introduction
-- → [Getting Started](GettingStarted.md) (10 min) — Complete guide
-- → [Quick Start](QuickStart.md) (5 min) — Working example
+- -> [Visual Guide](visual-guide.md) (5 min) - Beginner-friendly introduction
+- -> [Getting Started](getting-started.md) (10 min) - Complete guide
+- -> [Quick Start](quick-start.md) (5 min) - Working example
 
 #### Go Deeper
 
-- → [Message Types](MessageTypes.md) — When to use Untargeted/Targeted/Broadcast
-- → [Comparisons](Comparisons.md) — DxMessaging vs alternatives
-- → [Design & Architecture](DesignAndArchitecture.md) — How it works
+- -> [Message Types](../concepts/message-types.md) - When to use Untargeted/Targeted/Broadcast
+- -> [Comparisons](../architecture/comparisons.md) - DxMessaging vs alternatives
+- -> [Design & Architecture](../architecture/design-and-architecture.md) - How it works
 
 ##### Install & Setup
 
-- → [Install](Install.md) — Installation guide
-- → [Compatibility](Compatibility.md) — Unity versions
+- -> [Install](install.md) - Installation guide
+- -> [Compatibility](../reference/compatibility.md) - Unity versions

package/docs/getting-started/overview.md.meta

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