com.wallstop-studios.dxmessaging 2.1.2 → 2.1.3

package/.github/workflows/dotnet-tests.yml

@@ -19,7 +19,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v3
+        uses: actions/setup-dotnet@v5
         with:
           dotnet-version: "9.0.x"
 

package/AGENTS.md

@@ -2,12 +2,12 @@
 
 ## Project Structure & Module Organization
 
-- `Runtime/` — core library (`DxMessaging.Core`) and Unity components (`DxMessaging.Unity`).
-- `Editor/` — editor utilities, analyzers, and setup (`DxMessaging.Editor`).
-- `SourceGenerators/` — Roslyn source generators (`netstandard2.0`).
-- `Tests/Runtime/` — NUnit/Unity Test Framework tests (e.g., `Core/NominalTests.cs`).
-- `Docs/` — usage patterns and examples.
-- Package manifest: `package.json` (published to NPM/UPM).
+- [Runtime](Runtime/) — core library (`DxMessaging.Core`) and Unity components (`DxMessaging.Unity`).
+- [Editor](Editor/) — editor utilities, analyzers, and setup (`DxMessaging.Editor`).
+- [SourceGenerators](SourceGenerators/) — Roslyn source generators (`netstandard2.0`).
+- [Tests/Runtime](Tests/Runtime/) — NUnit/Unity Test Framework tests (e.g., [Core Nominal tests](Tests/Runtime/Core/NominalTests.cs)).
+- [Docs](Docs/) — usage patterns and examples.
+- Package manifest: [package.json](package.json) (published to NPM/UPM).
 
 ## Build, Test, and Development Commands
 
@@ -17,9 +17,9 @@
 
 ## Coding Style & Naming Conventions
 
-- Indent with 4 spaces for `.cs` (JSON/YAML: 2). CRLF, UTF‑8 BOM (see `.editorconfig`).
+- Indent with 4 spaces for `.cs` (JSON/YAML: 2). CRLF, UTF‑8 BOM (see [.editorconfig](.editorconfig)).
 - Prefer explicit types over `var`. Braces required. `using` directives inside the namespace.
-- Naming: `PascalCase` for types/methods/properties; interfaces `I*`; type parameters `T*`; events prefixed `On*`; public fields lowerCamelCase (matches examples in `README.md`).
+- Naming: `PascalCase` for types/methods/properties; interfaces `I*`; type parameters `T*`; events prefixed `On*`; public fields lowerCamelCase (matches examples in the [README](README.md)).
 - Place code under `DxMessaging.Core`, `DxMessaging.Unity`, or `DxMessaging.Editor` as appropriate.
 - Do not use underscores in function names, especially test function names.
 - Do not use regions, anywhere, ever.
@@ -29,7 +29,7 @@
 ## Testing Guidelines
 
 - Frameworks: NUnit + Unity Test Framework. Use `[Test]`/`[UnityTest]` as needed.
-- Location: add files under `Tests/Runtime/<Area>/` named `*Tests.cs` with classes `*Tests`.
+- Location: add files under [Tests/Runtime](Tests/Runtime/) `<Area>/` named `*Tests.cs` with classes `*Tests`.
 - Keep tests independent: prefer a local `MessageBus` and explicit `MessageRegistrationToken` lifecycles.
 - Do not use underscores in test function names.
 - Prefer expressive assertions and failure messages so it is clear what exactly is failing when a test fails.
@@ -43,10 +43,10 @@
 ## Commit & Pull Request Guidelines
 
 - Commits: short, imperative subject; group related changes; reference issues/PRs (e.g., “Fix registration dedupe (#123)”).
-- PRs: include a clear description, linked issues, before/after notes for performance changes (see `Tests/Runtime/Benchmarks`), and tests for bug fixes/features.
-- Releasing: changes to `package.json` on `master` may trigger the NPM publish workflow.
+- PRs: include a clear description, linked issues, before/after notes for performance changes (see [Tests/Runtime/Benchmarks](Tests/Runtime/Benchmarks/)), and tests for bug fixes/features.
+- Releasing: changes to [package.json](package.json) on `master` may trigger the NPM publish workflow.
 
 ## Security & Configuration Tips
 
-- Editor analyzer DLLs are copied into the Unity project by `Editor/SetupCscRsp.cs`; do not commit generated DLLs into this repo.
+- Editor analyzer DLLs are copied into the Unity project by [SetupCscRsp.cs](Editor/SetupCscRsp.cs); do not commit generated DLLs into this repo.
 - Keep public APIs minimal and consistent; avoid breaking changes without a major version bump.

package/Docs/Comparisons.md

@@ -28,16 +28,16 @@
 
 ## Performance Benchmarks
 
-These sections are auto-updated by the PlayMode comparison benchmarks in `Tests/Runtime/Benchmarks/ComparisonPerformanceTests.cs`. Run the suite locally to refresh the tables.
+These sections are auto-updated by the PlayMode comparison benchmarks in the [Comparison Performance PlayMode tests](../Tests/Runtime/Benchmarks/ComparisonPerformanceTests.cs). Run the suite locally to refresh the tables.
 
 ### Comparisons (Windows)
 
 | Message Tech                       | Operations / Second | Allocations? |
 | ---------------------------------- | ------------------- | ------------ |
-| DxMessaging (Untargeted) - No-Copy | 14,734,000          | No           |
-| UniRx MessageBroker                | 18,044,000          | No           |
-| MessagePipe (Global)               | 97,774,000          | No           |
-| Zenject SignalBus                  | 2,600,000           | Yes          |
+| DxMessaging (Untargeted) - No-Copy | 14,640,000          | No           |
+| UniRx MessageBroker                | 18,074,000          | No           |
+| MessagePipe (Global)               | 97,824,000          | No           |
+| Zenject SignalBus                  | 2,354,000           | Yes          |
 
 ### Comparisons (macOS)
 

package/Docs/InterceptorsAndOrdering.md

@@ -36,7 +36,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 `MutationDuringEmissionTests.cs`.
+This snapshot behavior is extensively tested in the [Mutation During Emission tests](../Tests/Runtime/Core/MutationDuringEmissionTests.cs).
 
 ---
 

package/Docs/Performance.md

@@ -1,6 +1,6 @@
 # Performance Benchmarks
 
-This page is auto-updated by the Unity PlayMode benchmark tests in `Tests/Runtime/Benchmarks/PerformanceTests.cs`.
+This page is auto-updated by the Unity PlayMode benchmark tests in the [Performance PlayMode benchmark suite](../Tests/Runtime/Benchmarks/PerformanceTests.cs).
 
 How it works:
 
@@ -8,23 +8,23 @@ How it works:
 - The benchmark test writes an OS-specific section below with a markdown table.
 - CI runs skip writing to avoid noisy diffs.
 
-See also: `Docs/DesignAndArchitecture.md#performance-optimizations` for design details.
+See also: [Performance optimizations](./DesignAndArchitecture.md#performance-optimizations) for design details.
 
 ## Windows
 
 | Message Tech                               | Operations / Second | Allocations? |
 | ------------------------------------------ | ------------------- | ------------ |
-| Unity                                      | 2,564,000           | Yes          |
-| DxMessaging (GameObject) - Normal          | 8,476,000           | No           |
-| DxMessaging (Component) - Normal           | 8,474,000           | No           |
-| DxMessaging (GameObject) - No-Copy         | 9,418,000           | No           |
-| DxMessaging (Component) - No-Copy          | 9,536,000           | No           |
-| DxMessaging (Untargeted) - No-Copy         | 14,736,000          | No           |
-| DxMessaging (Untargeted) - Interceptors    | 6,618,000           | No           |
-| DxMessaging (Untargeted) - Post-Processors | 5,244,000           | No           |
-| Reflexive (One Argument)                   | 2,828,000           | No           |
-| Reflexive (Two Arguments)                  | 2,360,000           | No           |
-| Reflexive (Three Arguments)                | 2,358,000           | No           |
+| Unity                                      | 2,504,000           | Yes          |
+| DxMessaging (GameObject) - Normal          | 8,522,000           | No           |
+| DxMessaging (Component) - Normal           | 8,524,000           | No           |
+| DxMessaging (GameObject) - No-Copy         | 9,398,000           | No           |
+| DxMessaging (Component) - No-Copy          | 9,508,000           | No           |
+| DxMessaging (Untargeted) - No-Copy         | 14,742,000          | No           |
+| DxMessaging (Untargeted) - Interceptors    | 6,620,000           | No           |
+| DxMessaging (Untargeted) - Post-Processors | 5,234,000           | No           |
+| Reflexive (One Argument)                   | 2,840,000           | No           |
+| Reflexive (Two Arguments)                  | 2,352,000           | No           |
+| Reflexive (Three Arguments)                | 2,318,000           | No           |
 
 ## macOS
 

package/Docs/QuickReference.md

@@ -106,7 +106,7 @@ public sealed class DamageSystem : IStartable, IDisposable
 }
 ```
 
-Tip: Define `ZENJECT_PRESENT`, `VCONTAINER_PRESENT`, or `REFLEX_PRESENT` to enable the optional shims under `Runtime/Unity/Integrations/` that bind the builder automatically for those containers.
+Tip: Define `ZENJECT_PRESENT`, `VCONTAINER_PRESENT`, or `REFLEX_PRESENT` to enable the optional shims under [Runtime/Unity/Integrations](../Runtime/Unity/Integrations/) that bind the builder automatically for those containers.
 
 Interceptors and post‑processors
 

package/Docs/Reference.md

@@ -64,11 +64,11 @@ Unity bridge types
 
 Source files (for exploration)
 
-- Message bus interface: Runtime/Core/MessageBus/IMessageBus.cs
-- Message bus: Runtime/Core/MessageBus/MessageBus.cs
-- Message handler/token: Runtime/Core/MessageHandler.cs, Runtime/Core/MessageRegistrationToken.cs
-- Emit helpers: Runtime/Core/Extensions/MessageExtensions.cs
-- Attributes: Runtime/Core/Attributes/\*.cs
+- Message bus interface: [IMessageBus](../Runtime/Core/MessageBus/IMessageBus.cs)
+- Message bus: [MessageBus](../Runtime/Core/MessageBus/MessageBus.cs)
+- Message handler/token: [MessageHandler](../Runtime/Core/MessageHandler.cs), [MessageRegistrationToken](../Runtime/Core/MessageRegistrationToken.cs)
+- Emit helpers: [MessageExtensions](../Runtime/Core/Extensions/MessageExtensions.cs)
+- Attributes: [Attributes directory](../Runtime/Core/Attributes/)
 
 API tables (quick view)
 

package/Editor/CustomEditors/MessagingComponentEditor.cs

@@ -37,6 +37,9 @@ namespace DxMessaging.Editor.CustomEditors
             _listenerFoldouts.Clear();
         }
 
+        /// <summary>
+        /// Draws the custom inspector, including diagnostics summaries and listener management controls.
+        /// </summary>
         public override void OnInspectorGUI()
         {
             base.OnInspectorGUI();

package/Editor/DxMessagingEditorInitializer.cs

@@ -1,9 +1,11 @@
 namespace DxMessaging.Editor
 {
 #if UNITY_EDITOR
+    using Core;
     using Core.MessageBus;
     using Settings;
     using UnityEditor;
+    using UnityEngine;
 
     /// <summary>
     /// Applies DxMessaging Editor settings to global runtime defaults on domain load.
@@ -11,12 +13,67 @@ namespace DxMessaging.Editor
     [InitializeOnLoad]
     public static class DxMessagingEditorInitializer
     {
+        private static bool s_playModeWarningIssued;
+
         static DxMessagingEditorInitializer()
         {
+            EditorApplication.playModeStateChanged += OnPlayModeStateChanged;
+            ApplyEditorSettings();
+            WarnIfDomainReloadDisabled();
+        }
+
+        private static void OnPlayModeStateChanged(PlayModeStateChange stateChange)
+        {
+            if (
+                stateChange == PlayModeStateChange.EnteredEditMode
+                || stateChange == PlayModeStateChange.EnteredPlayMode
+            )
+            {
+                ApplyEditorSettings();
+                WarnIfDomainReloadDisabled();
+            }
+        }
+
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
+        private static void ApplySettingsBeforeSceneLoad()
+        {
+            if (!Application.isPlaying)
+            {
+                return;
+            }
+
+            ApplyEditorSettings();
+        }
+
+        private static void ApplyEditorSettings()
+        {
+            DxMessagingStaticState.Reset();
             DxMessagingSettings settings = DxMessagingSettings.GetOrCreateSettings();
-            IMessageBus.GlobalDiagnosticsMode = settings.EnableDiagnosticsInEditor;
+            IMessageBus.GlobalDiagnosticsTargets = settings.DiagnosticsTargets;
             IMessageBus.GlobalMessageBufferSize = settings.MessageBufferSize;
         }
+
+        private static void WarnIfDomainReloadDisabled()
+        {
+            DxMessagingSettings settings = DxMessagingSettings.GetOrCreateSettings();
+            if (
+                s_playModeWarningIssued
+                || settings.SuppressDomainReloadWarning
+                || !EditorSettings.enterPlayModeOptionsEnabled
+                || (EditorSettings.enterPlayModeOptions & EnterPlayModeOptions.DisableDomainReload)
+                    == 0
+            )
+            {
+                return;
+            }
+
+            s_playModeWarningIssued = true;
+            Debug.LogWarning(
+                "[DxMessaging] Enter Play Mode Options are disabling domain reload. "
+                    + "DxMessaging resets its internal statics, but third-party static state will persist. "
+                    + "Audit integration code or re-enable domain reload if inconsistent behaviour occurs."
+            );
+        }
     }
 #endif
 }

package/Editor/DxMessagingMenu.cs

@@ -0,0 +1,38 @@
+namespace DxMessaging.Editor
+{
+#if UNITY_EDITOR
+    using Core;
+    using Core.MessageBus;
+    using UnityEditor;
+    using UnityEngine;
+
+    internal static class DxMessagingMenu
+    {
+        private const string Root = "Tools/Wallstop Studios/DxMessaging/";
+
+        [MenuItem(Root + "Reset Static State")]
+        private static void ResetStatics()
+        {
+            DxMessagingStaticState.Reset();
+            Debug.Log("[DxMessaging] Static state reset.");
+        }
+
+        [MenuItem(Root + "Toggle Global Diagnostics")]
+        private static void ToggleGlobalDiagnostics()
+        {
+            DiagnosticsTarget current = IMessageBus.GlobalDiagnosticsTargets;
+            DiagnosticsTarget next = current switch
+            {
+                DiagnosticsTarget.Off => DiagnosticsTarget.Editor,
+                DiagnosticsTarget.Editor => DiagnosticsTarget.Runtime,
+                DiagnosticsTarget.Runtime => DiagnosticsTarget.All,
+                DiagnosticsTarget.All => DiagnosticsTarget.Off,
+                _ => DiagnosticsTarget.Off,
+            };
+
+            IMessageBus.GlobalDiagnosticsTargets = next;
+            Debug.Log($"[DxMessaging] Global diagnostics targets set to {next}.");
+        }
+    }
+#endif
+}

package/Editor/DxMessagingMenu.cs.meta

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

package/Editor/DxMessagingSceneBuildProcessor.cs

@@ -0,0 +1,81 @@
+namespace DxMessaging.Editor
+{
+#if UNITY_EDITOR && UNITY_2021_3_OR_NEWER
+    using System.Collections.Generic;
+    using DxMessaging.Unity;
+    using UnityEditor.Build;
+    using UnityEditor.Build.Reporting;
+    using UnityEngine;
+    using UnityEngine.SceneManagement;
+
+    /// <summary>
+    /// Ensures MessagingComponent instances do not carry runtime registrations into player builds.
+    /// </summary>
+    internal sealed class DxMessagingSceneBuildProcessor : IProcessSceneWithReport
+    {
+        public int callbackOrder => int.MaxValue;
+
+        /// <summary>
+        /// Strips runtime-only messaging state from the scene before it is serialized into the build.
+        /// </summary>
+        /// <param name="scene">Scene currently being processed.</param>
+        /// <param name="report">Build report associated with the scene export.</param>
+        public void OnProcessScene(Scene scene, BuildReport report)
+        {
+            if (!scene.IsValid() || !scene.isLoaded)
+            {
+                return;
+            }
+
+            MessagingComponent[] components = FindMessagingComponents(scene);
+            if (components == null || components.Length == 0)
+            {
+                return;
+            }
+
+            int cleared = 0;
+            for (int i = 0; i < components.Length; ++i)
+            {
+                MessagingComponent component = components[i];
+                if (component != null && component.EditorResetRuntimeState())
+                {
+                    cleared++;
+                }
+            }
+
+            if (cleared > 0 && report != null)
+            {
+                Debug.Log(
+                    $"[DxMessaging] Cleared {cleared} MessagingComponent instance(s) in scene '{scene.path}' prior to build."
+                );
+            }
+        }
+
+        private static MessagingComponent[] FindMessagingComponents(Scene scene)
+        {
+            List<MessagingComponent> buffer = new List<MessagingComponent>();
+            GameObject[] roots = scene.GetRootGameObjects();
+            for (int i = 0; i < roots.Length; ++i)
+            {
+                GameObject root = roots[i];
+                if (root == null)
+                {
+                    continue;
+                }
+
+                MessagingComponent[] components = root.GetComponentsInChildren<MessagingComponent>(
+                    includeInactive: true
+                );
+                if (components == null || components.Length == 0)
+                {
+                    continue;
+                }
+
+                buffer.AddRange(components);
+            }
+
+            return buffer.ToArray();
+        }
+    }
+#endif
+}

package/Editor/DxMessagingSceneBuildProcessor.cs.meta

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

package/Editor/Settings/DxMessagingSettings.cs

@@ -2,8 +2,10 @@ namespace DxMessaging.Editor.Settings
 {
 #if UNITY_EDITOR
     using System.Linq;
+    using Core.MessageBus;
     using UnityEditor;
     using UnityEngine;
+    using UnityEngine.Serialization;
 
     /// <summary>
     /// Project-wide DxMessaging settings asset (Editor-only).
@@ -18,18 +20,26 @@ namespace DxMessaging.Editor.Settings
         private const string SettingsPath = "Assets/Editor/DxMessagingSettings.asset";
 
         [SerializeField]
-        internal bool _enableDiagnosticsInEditor;
+        internal DiagnosticsTarget _diagnosticsTargets = DiagnosticsTarget.Off;
+
+        [SerializeField]
+        [HideInInspector]
+        [FormerlySerializedAs("_enableDiagnosticsInEditor")]
+        private bool _legacyEnableDiagnosticsInEditor;
 
         [SerializeField]
         internal int _messageBufferSize = DefaultBufferSize;
 
+        [SerializeField]
+        internal bool _suppressDomainReloadWarning = true;
+
         /// <summary>
-        /// Enables <see cref="Core.MessageBus.IMessageBus.GlobalDiagnosticsMode"/> in the Editor.
+        /// Controls <see cref="DiagnosticsTarget"/> values applied to <see cref="IMessageBus.GlobalDiagnosticsTargets"/>.
         /// </summary>
-        public bool EnableDiagnosticsInEditor
+        public DiagnosticsTarget DiagnosticsTargets
         {
-            get => _enableDiagnosticsInEditor;
-            set => _enableDiagnosticsInEditor = value;
+            get => _diagnosticsTargets;
+            set => _diagnosticsTargets = value;
         }
 
         /// <summary>
@@ -41,6 +51,15 @@ namespace DxMessaging.Editor.Settings
             set => _messageBufferSize = value;
         }
 
+        /// <summary>
+        /// When true, suppresses the Enter Play Mode Options domain reload warning in the Editor.
+        /// </summary>
+        public bool SuppressDomainReloadWarning
+        {
+            get => _suppressDomainReloadWarning;
+            set => _suppressDomainReloadWarning = value;
+        }
+
         /// <summary>
         /// Loads the settings asset if present, otherwise creates it with sensible defaults.
         /// </summary>
@@ -62,8 +81,9 @@ namespace DxMessaging.Editor.Settings
             if (settings == null)
             {
                 settings = CreateInstance<DxMessagingSettings>();
-                settings._enableDiagnosticsInEditor = false;
+                settings._diagnosticsTargets = DiagnosticsTarget.Off;
                 settings._messageBufferSize = DefaultBufferSize;
+                settings._suppressDomainReloadWarning = true;
                 if (!AssetDatabase.IsValidFolder("Assets/Editor"))
                 {
                     AssetDatabase.CreateFolder("Assets", "Editor");
@@ -72,6 +92,17 @@ namespace DxMessaging.Editor.Settings
                 AssetDatabase.SaveAssets();
             }
 
+            if (
+                settings._diagnosticsTargets == DiagnosticsTarget.Off
+                && settings._legacyEnableDiagnosticsInEditor
+            )
+            {
+                settings._diagnosticsTargets = DiagnosticsTarget.Editor;
+                settings._legacyEnableDiagnosticsInEditor = false;
+                EditorUtility.SetDirty(settings);
+                AssetDatabase.SaveAssets();
+            }
+
             return settings;
         }
 

package/Editor/Settings/DxMessagingSettingsProvider.cs

@@ -2,6 +2,7 @@ namespace DxMessaging.Editor.Settings
 {
 #if UNITY_EDITOR
     using System.Collections.Generic;
+    using Core.MessageBus;
     using UnityEditor;
     using UnityEngine;
 
@@ -21,6 +22,11 @@ namespace DxMessaging.Editor.Settings
         )
             : base(path, scope) { }
 
+        /// <summary>
+        /// Initializes the serialized settings backing store when the settings page is opened.
+        /// </summary>
+        /// <param name="searchContext">Search text provided by the Project Settings window.</param>
+        /// <param name="rootElement">Root visual element for UI Toolkit-based providers.</param>
         public override void OnActivate(
             string searchContext,
             UnityEngine.UIElements.VisualElement rootElement
@@ -29,28 +35,60 @@ namespace DxMessaging.Editor.Settings
             _messagingSettings = DxMessagingSettings.GetSerializedSettings();
         }
 
+        /// <summary>
+        /// Renders the DxMessaging settings UI and persists any modifications.
+        /// </summary>
+        /// <param name="searchContext">Search text provided by the Project Settings window.</param>
         public override void OnGUI(string searchContext)
         {
-            EditorGUILayout.PropertyField(
-                _messagingSettings.FindProperty(
-                    nameof(DxMessagingSettings._enableDiagnosticsInEditor)
-                ),
-                new GUIContent("Global Diagnostics Mode")
+            SerializedProperty targetsProp = _messagingSettings.FindProperty(
+                nameof(DxMessagingSettings._diagnosticsTargets)
             );
+            DiagnosticsTarget currentTargets = (DiagnosticsTarget)targetsProp.enumValueFlag;
+            DiagnosticsTarget updatedTargets = (DiagnosticsTarget)
+                EditorGUILayout.EnumFlagsField(
+                    new GUIContent(
+                        "Diagnostics Targets",
+                        "Select where global diagnostics should be enabled by default. Combine flags for multiple targets."
+                    ),
+                    currentTargets
+                );
+            if (updatedTargets != currentTargets)
+            {
+                targetsProp.enumValueFlag = (int)updatedTargets;
+            }
             EditorGUILayout.PropertyField(
                 _messagingSettings.FindProperty(nameof(DxMessagingSettings._messageBufferSize)),
-                new GUIContent("Message Buffer Size")
+                new GUIContent(
+                    "Message Buffer Size",
+                    "Number of emissions kept per bus/token when diagnostics mode is active."
+                )
+            );
+            EditorGUILayout.PropertyField(
+                _messagingSettings.FindProperty(
+                    nameof(DxMessagingSettings._suppressDomainReloadWarning)
+                ),
+                new GUIContent(
+                    "Suppress Domain Reload Warning",
+                    "Disable the warning shown when Enter Play Mode Options skips domain reload; DxMessaging still resets its statics."
+                )
             );
 
             _messagingSettings.ApplyModifiedProperties();
         }
 
         [SettingsProvider]
+        /// <summary>
+        /// Factory used by Unity to register the DxMessaging project settings page.
+        /// </summary>
+        /// <returns>Configured settings provider instance.</returns>
         public static SettingsProvider CreateDxMessagingSettingsProvider()
         {
             DxMessagingSettingsProvider provider = new("Project/DxMessaging")
             {
-                keywords = new HashSet<string>(new[] { "DxMessaging", "Diagnostics" }),
+                keywords = new HashSet<string>(
+                    new[] { "DxMessaging", "Diagnostics", "MessageBus", "Targets" }
+                ),
             };
 
             return provider;

package/README.md

@@ -52,7 +52,7 @@ Need install instructions for Git URLs, scoped registries, or tarballs? Jump to
 
 1. **Untargeted** - "Everyone listen!" (pause game, settings changed)
 1. **Targeted** - "Tell Player to heal" (commands to specific entities)
-1. **Broadcast** - "Enemy took damage" (events others can observe)
+1. **Broadcast** - "I took damage" (things that happen to _you_ that others can observe)
 
 **One line:** It's the event system Unity should have shipped with - type-safe, leak-proof, and actually debuggable. 🚀