incremental: handle Stream as stream rather than linked list

Replicates graphql/graphql-js@89f9223

Author: Cito

docs/conf.py

@@ -180,7 +180,8 @@
     "IncrementalResult",
     "Middleware",
     "PendingResult",
-    "StreamItemsRecord",
+    "StreamItemRecord",
+    "StreamItemResult",
     "StreamItemsResult",
     "StreamRecord",
     "SubsequentDataRecord",
@@ -215,7 +216,7 @@
     "graphql.execution.types.NonReconcilableStreamItemsResult",
     "graphql.execution.types.PendingResult",
     "graphql.execution.types.ReconcilableStreamItemsResult",
-    "graphql.execution.types.StreamItemsRecord",
+    "graphql.execution.types.StreamItemResult",
     "graphql.execution.types.StreamRecord",
     "graphql.execution.types.SubsequentResultRecord",
     "graphql.execution.types.TerminatingStreamItemsResult",

docs/modules/pyutils.rst

@@ -20,6 +20,7 @@ PyUtils
 .. autofunction:: is_iterable
 .. autofunction:: natural_comparison_key
 .. autoclass:: AwaitableOrValue
+.. autoclass:: BoxedAwaitableOrValue
 .. autofunction:: suggestion_list
 .. autoclass:: FrozenError
    :no-members:

pyproject.toml

@@ -55,7 +55,7 @@ test = [
     "tox>=3.28,<4; python_version<'3.8'",
 ]
 lint = [
-    "ruff>=0.13,<0.14",
+    "ruff>=0.14,<0.15",
     "mypy>=1.18; python_version>='3.9'",
     "mypy>=1.14; python_version>='3.8' and python_version<'3.9'",
     "mypy>=1.4; python_version<'3.8'",

src/graphql/execution/__init__.py

@@ -24,6 +24,9 @@
     PendingResult,
     SubsequentIncrementalExecutionResult,
     StreamRecord,
+    StreamItemRecord,
+    StreamItemResult,
+    StreamItemsResult,
 )
 from .middleware import MiddlewareManager
 from .values import get_argument_values, get_directive_values, get_variable_values
@@ -61,6 +64,9 @@
     "Middleware",
     "MiddlewareManager",
     "PendingResult",
+    "StreamItemRecord",
+    "StreamItemResult",
+    "StreamItemsResult",
     "StreamRecord",
     "SubsequentIncrementalExecutionResult",
     "create_source_event_stream",