From d40b707b614c3a3cb4601a043647d082d9e306cc Mon Sep 17 00:00:00 2001
From: Trevin Chow <trevin@trevinchow.com>
Date: Wed, 15 Apr 2026 00:14:32 -0700
Subject: [PATCH] docs: improve WorkermanCompilerPass::referenceMap() PHPDoc

Describe what the method does, tighten the @param type to the shape
returned by findTaggedServiceIds(), and annotate the returned map as
service id => Reference rather than a plain list.

Closes #146
---
 src/DependencyInjection/WorkermanCompilerPass.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/DependencyInjection/WorkermanCompilerPass.php b/src/DependencyInjection/WorkermanCompilerPass.php
index e9aeb60..a6573ba 100644
--- a/src/DependencyInjection/WorkermanCompilerPass.php
+++ b/src/DependencyInjection/WorkermanCompilerPass.php
@@ -78,9 +78,11 @@ public function process(ContainerBuilder $container): void
     }
 
     /**
-     * @param string[] $taggedServices
+     * Creates a Reference map from tagged services for ServiceLocator registration.
      *
-     * @return Reference[]
+     * @param array<string, array<string, mixed>> $taggedServices Output from findTaggedServiceIds()
+     *
+     * @return array<string, Reference> Service id => Reference mapping
      */
     private function referenceMap(array $taggedServices): array
     {