1. Created FlatDeltaDict TypedDict in helper.py mirroring FlatDeltaRow's fields, with path and

  action required and the rest optional.
  2. Changed the return type of to_flat_dicts from List[FlatDeltaRow] to List[FlatDeltaDict].
  3. Used cast to tell pyright the _asdict() output conforms to FlatDeltaDict.
  4. Fixed the parameter bug — the original code was hardcoding include_action_in_path=False,
  report_type_changes=True instead of passing through the actual arguments.

Author: seperman

LICENSE

@@ -1,7 +1,8 @@
 The MIT License (MIT)
 
 Copyright (c) 2014 - 2026 Sep Dehpour (Seperman) and contributors
-www.zepworks.com
+qluster.ai
+zepworks.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

deepdiff/delta.py

@@ -1,6 +1,6 @@
 import copy
 import logging
-from typing import List, Dict, IO, Callable, Set, Union, Optional, Any
+from typing import List, Dict, IO, Callable, Set, Union, Optional, Any, cast
 from functools import partial, cmp_to_key
 from collections.abc import Mapping
 from copy import deepcopy
@@ -10,7 +10,7 @@
     strings, numbers,
     np_ndarray, np_array_factory, numpy_dtypes, get_doc,
     not_found, numpy_dtype_string_to_type, dict_,
-    Opcode, FlatDeltaRow, UnkownValueCode, FlatDataAction,
+    Opcode, FlatDeltaRow, FlatDeltaDict, UnkownValueCode, FlatDataAction,
     OPCODE_TAG_TO_FLAT_DATA_ACTION,
     FLAT_DATA_ACTION_TO_OPCODE_TAG,
     SetOrdered,
@@ -1065,7 +1065,7 @@ def _from_flat_dicts(flat_dict_list):
 
         return result
 
-    def to_flat_dicts(self, include_action_in_path=False, report_type_changes=True) -> List[FlatDeltaRow]:
+    def to_flat_dicts(self, include_action_in_path=False, report_type_changes=True) -> List[FlatDeltaDict]:
         """
         Returns a flat list of actions that is easily machine readable.
 
@@ -1119,9 +1119,9 @@ def to_flat_dicts(self, include_action_in_path=False, report_type_changes=True)
             attribute_added
             attribute_removed
         """
-        return [
-            i._asdict() for i in self.to_flat_rows(include_action_in_path=False, report_type_changes=True)
-        ]  # type: ignore
+        return cast(List[FlatDeltaDict], [
+            i._asdict() for i in self.to_flat_rows(include_action_in_path=include_action_in_path, report_type_changes=report_type_changes)
+        ])
 
     def to_flat_rows(self, include_action_in_path=False, report_type_changes=True) -> List[FlatDeltaRow]:
         """

deepdiff/helper.py

@@ -9,7 +9,7 @@
 import time
 import enum
 import ipaddress
-from typing import NamedTuple, Any, List, Optional, Dict, Union, TYPE_CHECKING, Tuple, Iterable, Iterator, Set, FrozenSet, Callable, Pattern, Type, TypeVar, Generic, Literal, overload
+from typing import NamedTuple, Any, List, Optional, Dict, Union, TYPE_CHECKING, Tuple, Iterable, Iterator, Set, FrozenSet, Callable, Pattern, Type, TypeVar, Generic, Literal, overload, TypedDict
 from collections.abc import Mapping, Sequence, Generator
 from ast import literal_eval
 from decimal import Decimal, localcontext, InvalidOperation as InvalidDecimalOperation
@@ -843,6 +843,23 @@ class FlatDeltaRow(NamedTuple):
     __repr__ = __str__ = named_tuple_repr
 
 
+class _FlatDeltaDictRequired(TypedDict):
+    path: List
+    action: FlatDataAction
+
+
+class FlatDeltaDict(_FlatDeltaDictRequired, total=False):
+    value: Optional[Any]
+    old_value: Optional[Any]
+    type: Optional[Any]
+    old_type: Optional[Any]
+    new_path: Optional[List]
+    t1_from_index: Optional[int]
+    t1_to_index: Optional[int]
+    t2_from_index: Optional[int]
+    t2_to_index: Optional[int]
+
+
 JSON = Union[Dict[str, str], List[str], List[int], Dict[str, "JSON"], List["JSON"], str, int, float, bool, None]