route() returns Moar

src/wf_authoring/builder/refs.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from dataclasses import dataclass
 from typing import Any, TypeAlias, TypeGuard
 
 from wf_core import ConditionNode, ForeachNode, InterruptNode, NodeUse
@@ -10,6 +11,19 @@ StepRef: TypeAlias = str | NodeUse | ConditionNode | ForeachNode | InterruptNode
 BranchRef: TypeAlias = StepRef | NodeSpec[Any, Any]
 
 
+@dataclass(frozen=True, slots=True)
+class RouteRef:
+    """Reference bundle returned by route() for generated condition nodes."""
+
+    entry: ConditionNode
+    conditions: tuple[ConditionNode, ...]
+    targets: dict[object, StepRef]
+
+    def __getitem__(self, key: object) -> StepRef:
+        """Keep route["case"] ergonomic while exposing generated conditions."""
+        return self.targets[key]
+
+
 def step_id(ref: StepRef) -> str:
     """Return the core step id for either a step object or an id string."""
     if isinstance(ref, str):