fix: resolve relationship refs to explicit override DTOs

src/strawchemy/utils/registry.py

@@ -122,6 +122,18 @@ class RegistryTypeInfo:
     def scoped_id(self) -> Hashable:
         return self.model, self.graphql_type, self.tags
 
+    @property
+    def resolves_scoped_references(self) -> bool:
+        """Whether this registration should satisfy refs to generated DTOs for the same model."""
+        return bool(
+            self.model
+            and not self.exclude_from_scope
+            and (
+                self.scope == "global"
+                or (self.scope is None and self.override and self.user_defined and self.default_name is not None)
+            )
+        )
+
 
 class StrawberryRegistry:
     def __init__(self, strawberry_config: StrawberryConfig) -> None:
@@ -242,9 +254,12 @@ def _register(self, type_info: RegistryTypeInfo, strawberry_type: type[Any]) ->
                 reference.update_type(strawberry_type)
         if type_info.graphql_type != "enum":
             self._track_references(strawberry_type, type_info.graphql_type, force=type_info.override)
-        if type_info.scope == "global" and type_info.model:
+        if type_info.resolves_scoped_references:
             if type_info.default_name:
                 self._namespaces[type_info.graphql_type][type_info.default_name] = strawberry_type
+                if type_info.default_name != type_info.name:
+                    for reference in self._forward_type_refs[type_info.graphql_type][type_info.default_name]:
+                        reference.update_type(strawberry_type)
             for reference in self._type_refs[type_info.scoped_id]:
                 reference.update_type(strawberry_type)
             self._scoped_types[type_info.scoped_id] = strawberry_type

tests/unit/mapping/__snapshots__/test_schemas/test_query_schemas[override_with_custom_name].gql

@@ -4,8 +4,8 @@ type ColorType {
   name: Int!
   fruitsAggregate: FruitAggregate!
 
-  """Fetch objects from the FruitType collection"""
-  fruits: [FruitType!]!
+  """Fetch objects from the FruitTypeCustomName collection"""
+  fruits: [FruitTypeCustomName!]!
   id: UUID!
 }
 
@@ -39,15 +39,6 @@ type FruitSumFields {
   sweetness: Int
 }
 
-"""GraphQL type"""
-type FruitType {
-  color: ColorType!
-  name: Int!
-  colorId: UUID
-  sweetness: Int!
-  id: UUID!
-}
-
 """GraphQL type"""
 type FruitTypeCustomName {
   name: Int!

tests/unit/mapping/test_schemas.py

@@ -69,6 +69,38 @@ class ColorSlim:
     assert slim_fields == {"id"}
 
 
+def test_relationship_uses_late_explicit_related_type_registration(strawchemy: Strawchemy) -> None:
+    """Relationship type selection must not depend on decoration/import order."""
+    from tests.unit.models import Color, Fruit
+
+    @strawchemy.type(Fruit, name="FruitNode", include=["id", "color"], override=True)
+    class FruitNode:
+        pass
+
+    @strawchemy.type(Color, name="ColorNode", include=["id", "name"], override=True)
+    class ColorNode:
+        @strawberry.field
+        def label(self) -> str:
+            return "label"
+
+    @strawberry.type
+    class Query:
+        @strawberry.field(graphql_type=FruitNode | None)
+        def fruit(self) -> object | None:
+            return None
+
+        @strawberry.field(graphql_type=ColorNode | None)
+        def color(self) -> object | None:
+            return None
+
+    schema = strawberry.Schema(query=Query)
+    schema_sdl = str(schema)
+
+    assert "color: ColorNode!" in schema_sdl
+    assert "label: String!" in schema_sdl
+    assert "color: ColorType!" not in schema_sdl
+
+
 def test_type_instance_auto_as_str(strawchemy: Strawchemy) -> None:
     @strawchemy.type(User)
     class UserType: