fake-bpy-module 20241207__py3-none-any.whl → 20241208__py3-none-any.whl

bpy/types/__init__.pyi

@@ -102853,11 +102853,12 @@ class bpy_prop_collection[_GenericType1]:
                 :rtype: list[tuple[str, _GenericType1]]
         """
 
-    def keys(self):
+    def keys(self) -> list[str]:
         """Return the identifiers of collection members
         (matching Python's dict.keys() functionality).
 
                 :return: the identifiers for each member of this collection.
+                :rtype: list[str]
         """
 
     def values(self) -> list[_GenericType1 | None]:
@@ -102966,7 +102967,9 @@ class bpy_struct[_GenericType1]:
         :rtype: int
         """
 
-    def driver_add(self, path: str | None, index: int | None = -1) -> FCurve:
+    def driver_add(
+        self, path: str | None, index: int | None = -1
+    ) -> FCurve | list[FCurve]:
         """Adds driver(s) to the given property
 
         :param path: path to the property to drive, analogous to the fcurve's data path.
@@ -102974,7 +102977,7 @@ class bpy_struct[_GenericType1]:
         :param index: array index of the property drive. Defaults to -1 for all indices or a single channel if the property is not an array.
         :type index: int | None
         :return: The driver added or a list of drivers when index is -1.
-        :rtype: FCurve
+        :rtype: FCurve | list[FCurve]
         """
 
     def driver_remove(self, path: str | None, index: int | None = -1) -> bool:
@@ -102988,7 +102991,7 @@ class bpy_struct[_GenericType1]:
         :rtype: bool
         """
 
-    def get(self, key: str | None, default=None):
+    def get(self, key: str | None, default: typing.Any | None = None):
         """Returns the value of the custom property assigned to key or default
         when not found (matches Python's dictionary function of the same name).
 
@@ -102996,6 +102999,7 @@ class bpy_struct[_GenericType1]:
                 :type key: str | None
                 :param default: Optional argument for the value to return if
         key is not found.
+                :type default: typing.Any | None
         """
 
     def id_properties_clear(self):
@@ -103155,7 +103159,7 @@ class bpy_struct[_GenericType1]:
                 :type coerce: bool | None
         """
 
-    def pop(self, key: str | None, default=None):
+    def pop(self, key: str | None, default: typing.Any | None = None):
         """Remove and return the value of the custom property assigned to key or default
         when not found (matches Python's dictionary function of the same name).
 
@@ -103163,6 +103167,7 @@ class bpy_struct[_GenericType1]:
                 :type key: str | None
                 :param default: Optional argument for the value to return if
         key is not found.
+                :type default: typing.Any | None
         """
 
     def property_overridable_library_set(self, property, overridable) -> bool:
@@ -116432,13 +116437,14 @@ class BlendData(bpy_struct):
         :rtype: typing_extensions.Self
         """
 
-    def user_map(self, subset, key_types, value_types):
+    def user_map(self, subset, key_types, value_types) -> dict[ID]:
         """Returns a mapping of all ID data-blocks in current bpy.data to a set of all data-blocks using them.For list of valid set members for key_types & value_types, see: `bpy.types.KeyingSetPath.id_type`.
 
         :param subset: When passed, only these data-blocks and their users will be included as keys/values in the map.
         :param key_types: Filter the keys mapped by ID types.
         :param value_types: Filter the values in the set by ID types.
         :return: dictionary that maps data-blocks ID's to their users.
+        :rtype: dict[ID]
         """
 
 class BlendImportContext(bpy_struct):
@@ -157182,7 +157188,7 @@ class Gizmo(bpy_struct):
 
     def draw_custom_shape(
         self,
-        shape,
+        shape: typing.Any | None,
         *,
         matrix: collections.abc.Sequence[collections.abc.Sequence[float]]
         | mathutils.Matrix
@@ -157192,6 +157198,7 @@ class Gizmo(bpy_struct):
         """Draw a shape created form `Gizmo.draw_custom_shape`.
 
                 :param shape: The cached shape to draw.
+                :type shape: typing.Any | None
                 :param matrix: 4x4 matrix, when not given `Gizmo.matrix_world` is used.
                 :type matrix: collections.abc.Sequence[collections.abc.Sequence[float]] | mathutils.Matrix | None
                 :param select_id: The selection id.
@@ -157200,13 +157207,14 @@ class Gizmo(bpy_struct):
         """
 
     @staticmethod
-    def new_custom_shape(type: str | None, verts):
+    def new_custom_shape(type: str | None, verts) -> typing.Any:
         """Create a new shape that can be passed to `Gizmo.draw_custom_shape`.
 
         :param type: The type of shape to create in (POINTS, LINES, TRIS, LINE_STRIP).
         :type type: str | None
         :param verts: Sequence of 2D or 3D coordinates.
         :return: The newly created shape (the return type make change).
+        :rtype: typing.Any
         """
 
     @classmethod
@@ -157231,20 +157239,21 @@ class Gizmo(bpy_struct):
         :rtype: typing.Any
         """
 
-    def target_get_range(self, target):
+    def target_get_range(self, target) -> tuple[float, float]:
         """Get the range for this target property.
 
         :param target: Target property name.
         :return: The range of this property (min, max).
+        :rtype: tuple[float, float]
         """
 
-    def target_get_value(self, target: str | None) -> float:
+    def target_get_value(self, target: str | None) -> float | tuple[float, int]:
         """Get the value of this target property.
 
         :param target: Target property name.
         :type target: str | None
         :return: The value of the target property as a value or array based on the target type.
-        :rtype: float
+        :rtype: float | tuple[float, int]
         """
 
     def target_set_handler(
@@ -173086,7 +173095,7 @@ class Menu(bpy_struct):
         searchpaths,
         operator: str | None,
         *,
-        props_default=None,
+        props_default: dict[str, typing.Any] | None = None,
         prop_filepath: str | None = "filepath",
         filter_ext: collections.abc.Callable | None = None,
         filter_path=None,
@@ -173100,6 +173109,7 @@ class Menu(bpy_struct):
                 :param operator: The operator id to use with each file.
                 :type operator: str | None
                 :param props_default: Properties to assign to each operator.
+                :type props_default: dict[str, typing.Any] | None
                 :param prop_filepath: Optional operator filepath property (defaults to "filepath").
                 :type prop_filepath: str | None
                 :param filter_ext: Optional callback that takes the file extensions.
@@ -207971,7 +207981,7 @@ class Space(bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -207983,6 +207993,7 @@ class Space(bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -208314,7 +208325,7 @@ class SpaceClipEditor(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -208326,6 +208337,7 @@ class SpaceClipEditor(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -208415,7 +208427,7 @@ class SpaceConsole(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -208427,6 +208439,7 @@ class SpaceConsole(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -208622,7 +208635,7 @@ class SpaceDopeSheetEditor(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -208634,6 +208647,7 @@ class SpaceDopeSheetEditor(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -208792,7 +208806,7 @@ class SpaceFileBrowser(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -208804,6 +208818,7 @@ class SpaceFileBrowser(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -208977,7 +208992,7 @@ class SpaceGraphEditor(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -208989,6 +209004,7 @@ class SpaceGraphEditor(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -209260,7 +209276,7 @@ class SpaceImageEditor(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -209272,6 +209288,7 @@ class SpaceImageEditor(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -209386,7 +209403,7 @@ class SpaceInfo(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -209398,6 +209415,7 @@ class SpaceInfo(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -209499,7 +209517,7 @@ class SpaceNLA(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -209511,6 +209529,7 @@ class SpaceNLA(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -209701,7 +209720,7 @@ class SpaceNodeEditor(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -209713,6 +209732,7 @@ class SpaceNodeEditor(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -210033,7 +210053,7 @@ class SpaceOutliner(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -210045,6 +210065,7 @@ class SpaceOutliner(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -210104,7 +210125,7 @@ class SpacePreferences(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -210116,6 +210137,7 @@ class SpacePreferences(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -210218,7 +210240,7 @@ class SpaceProperties(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -210230,6 +210252,7 @@ class SpaceProperties(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -210473,7 +210496,7 @@ class SpaceSequenceEditor(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -210485,6 +210508,7 @@ class SpaceSequenceEditor(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -210616,7 +210640,7 @@ class SpaceSpreadsheet(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -210628,6 +210652,7 @@ class SpaceSpreadsheet(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -210815,7 +210840,7 @@ class SpaceTextEditor(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -210827,6 +210852,7 @@ class SpaceTextEditor(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -211519,7 +211545,7 @@ class SpaceView3D(Space, bpy_struct):
     def draw_handler_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         region_type: str | None,
         draw_type: str | None,
     ) -> typing.Any:
@@ -211531,6 +211557,7 @@ class SpaceView3D(Space, bpy_struct):
         It gets the specified arguments as input, it's return value is ignored.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)
                 :type region_type: str | None
                 :param draw_type: Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.
@@ -213649,17 +213676,24 @@ class Text(ID, bpy_struct):
         :rtype: typing.Any
         """
 
-    def region_as_string(self, range=None) -> str:
+    def region_as_string(
+        self, range: tuple[tuple[int, int], tuple[int, int]] | None = None
+    ) -> str:
         """
 
                 :param range: The region of text to be returned, defaulting to the selection when no range is passed.
         Each int pair represents a line and column: ((start_line, start_column), (end_line, end_column))
         The values match Python's slicing logic (negative values count backwards from the end, the end value is not inclusive).
+                :type range: tuple[tuple[int, int], tuple[int, int]] | None
                 :return: The specified region as a string.
                 :rtype: str
         """
 
-    def region_from_string(self, body: str | None, range=None):
+    def region_from_string(
+        self,
+        body: str | None,
+        range: tuple[tuple[int, int], tuple[int, int]] | None = None,
+    ):
         """
 
                 :param body: The text to be inserted.
@@ -213667,6 +213701,7 @@ class Text(ID, bpy_struct):
                 :param range: The region of text to be returned, defaulting to the selection when no range is passed.
         Each int pair represents a line and column: ((start_line, start_column), (end_line, end_column))
         The values match Python's slicing logic (negative values count backwards from the end, the end value is not inclusive).
+                :type range: tuple[tuple[int, int], tuple[int, int]] | None
         """
 
 class TextBox(bpy_struct):
@@ -229638,7 +229673,7 @@ class WindowManager(ID, bpy_struct):
     def draw_cursor_add(
         cls,
         callback: collections.abc.Callable | None,
-        args,
+        args: tuple[typing.Any, int] | None,
         space_type: str | None,
         region_type: str | None,
     ) -> typing.Any:
@@ -229650,6 +229685,7 @@ class WindowManager(ID, bpy_struct):
         It gets the specified arguments as input with the mouse position (tuple) as last argument.
                 :type callback: collections.abc.Callable | None
                 :param args: Arguments that will be passed to the callback.
+                :type args: tuple[typing.Any, int] | None
                 :param space_type: The space type the callback draws in; for example VIEW_3D. (`bpy.types.Space.type`)
                 :type space_type: str | None
                 :param region_type: The region type the callback draws in; usually WINDOW. (`bpy.types.Region.type`)

bpy/utils/__init__.pyi

@@ -26,7 +26,9 @@ def app_template_paths(*, path: str | None = None):
     :return: App template paths.
     """
 
-def blend_paths(absolute: bool = False, packed: bool = False, local: bool = False):
+def blend_paths(
+    absolute: bool = False, packed: bool = False, local: bool = False
+) -> list[str]:
     """Returns a list of paths to external files referenced by the loaded .blend file.
 
     :param absolute: When true the paths returned are made absolute.
@@ -36,6 +38,7 @@ def blend_paths(absolute: bool = False, packed: bool = False, local: bool = Fals
     :param local: When true skip linked library paths.
     :type local: bool
     :return: path list.
+    :rtype: list[str]
     """
 
 def escape_identifier(string: str) -> str:
@@ -125,7 +128,9 @@ def load_scripts_extensions(*, reload_scripts: bool = False):
         :type reload_scripts: bool
     """
 
-def make_rna_paths(struct_name: str, prop_name: str, enum_name: str) -> str:
+def make_rna_paths(
+    struct_name: str, prop_name: str, enum_name: str
+) -> tuple[str, str, str]:
     """Create RNA "paths" from given names.
 
         :param struct_name: Name of a RNA struct (like e.g. "Scene").
@@ -137,7 +142,7 @@ def make_rna_paths(struct_name: str, prop_name: str, enum_name: str) -> str:
         :return: A triple of three "RNA paths"
     (most_complete_path, "struct.prop", "struct.prop:'enum'").
     If no enum_name is given, the third element will always be void.
-        :rtype: str
+        :rtype: tuple[str, str, str]
     """
 
 def manual_language_code(default="en") -> str:
@@ -149,7 +154,7 @@ def manual_language_code(default="en") -> str:
     """
 
 def manual_map(): ...
-def modules_from_path(path: str, loaded_modules):
+def modules_from_path(path: str, loaded_modules) -> list:
     """Load all modules in a path and return them as a list.
 
         :param path: this path is scanned for scripts and packages.
@@ -157,15 +162,17 @@ def modules_from_path(path: str, loaded_modules):
         :param loaded_modules: already loaded module names, files matching these
     names will be ignored.
         :return: all loaded modules.
+        :rtype: list
     """
 
 def preset_find(name, preset_path, *, display_name=False, ext=".py"): ...
-def preset_paths(subdir: str):
+def preset_paths(subdir: str) -> list[str]:
     """Returns a list of paths for a specific preset.
 
     :param subdir: preset subdirectory (must not be an absolute path).
     :type subdir: str
     :return: Script paths.
+    :rtype: list[str]
     """
 
 def refresh_script_paths():
@@ -223,8 +230,8 @@ def register_preset_path(path: str) -> bool:
     """
 
 def register_submodule_factory(
-    module_name: str, submodule_names
-) -> collections.abc.Callable:
+    module_name: str, submodule_names: list[str]
+) -> tuple[collections.abc.Callable, collections.abc.Callable]:
     """Utility function to create register and unregister functions
     which simply load submodules,
     calling their register & unregister functions.
@@ -232,8 +239,9 @@ def register_submodule_factory(
         :param module_name: The module name, typically __name__.
         :type module_name: str
         :param submodule_names: List of submodule names to load and unload.
+        :type submodule_names: list[str]
         :return: register and unregister functions.
-        :rtype: collections.abc.Callable
+        :rtype: tuple[collections.abc.Callable, collections.abc.Callable]
     """
 
 def register_tool(
@@ -279,7 +287,7 @@ def script_paths(
     check_all: bool = False,
     use_user: bool = True,
     use_system_environment: bool = True,
-):
+) -> list[str]:
     """Returns a list of valid script paths.
 
     :param subdir: Optional subdir.
@@ -293,6 +301,7 @@ def script_paths(
     :param use_system_environment: Include BLENDER_SYSTEM_SCRIPTS variable path
     :type use_system_environment: bool
     :return: script paths.
+    :rtype: list[str]
     """
 
 def script_paths_pref():

bpy_extras/bmesh_utils/__init__.pyi

@@ -2,12 +2,13 @@ import typing
 import collections.abc
 import typing_extensions
 
-def bmesh_linked_uv_islands(bm, uv_layer):
+def bmesh_linked_uv_islands(bm, uv_layer) -> list[list[int]]:
     """Returns lists of faces connected by UV islands.For meshes use `bpy.types.Mesh.mesh_linked_uv_islands` instead.
 
     :param bm: the bmesh used to group with.
     :param uv_layer: the UV layer to source UVs from.
     :return: list of lists containing polygon indices
+    :rtype: list[list[int]]
     """
 
 def match_uv(face, vert, uv, uv_layer): ...

bpy_extras/io_utils/__init__.pyi

@@ -2,6 +2,7 @@ import typing
 import collections.abc
 import typing_extensions
 import bpy.types
+import mathutils
 
 class ExportHelper:
     def check(self, _context):
@@ -60,7 +61,9 @@ def axis_conversion_ensure(
         :rtype: bool
     """
 
-def create_derived_objects(depsgraph: bpy.types.Depsgraph, objects):
+def create_derived_objects(
+    depsgraph: bpy.types.Depsgraph, objects
+) -> dict[bpy.types.Object, list[tuple[bpy.types.Object, mathutils.Matrix]]]:
     """This function takes a sequence of objects, returning their instances.
 
         :param depsgraph: The evaluated depsgraph.
@@ -68,6 +71,7 @@ def create_derived_objects(depsgraph: bpy.types.Depsgraph, objects):
         :param objects: A sequencer of objects.
         :return: A dictionary where each key is an object from objects,
     values are lists of (object, matrix) tuples representing instances.
+        :rtype: dict[bpy.types.Object, list[tuple[bpy.types.Object, mathutils.Matrix]]]
     """
 
 def orientation_helper(axis_forward="Y", axis_up="Z"):
@@ -125,7 +129,7 @@ def poll_file_object_drop(context):
     """
 
 def unique_name(
-    key,
+    key: typing.Any,
     name: str,
     name_dict: dict,
     name_max=-1,
@@ -139,6 +143,7 @@ def unique_name(
     when available.
     This can be the object, mesh, material, etc instance itself.
     Any hashable object associated with the name.
+        :type key: typing.Any
         :param name: The name used to create a unique value in name_dict.
         :type name: str
         :param name_dict: This is used to cache namespace to ensure no collisions