fake-bpy-module 20250612__py3-none-any.whl → 20260118__py3-none-any.whl

bmesh/types/__init__.pyi

@@ -1,4 +1,16 @@
 """
+SUBSTITUTION REPLACEMENT 'UV_STICKY_SELECT_MODE_REF':
+(bpy.types.ToolSettings.uv_sticky_select_mode which may be passed in directly).
+
+SUBSTITUTION REPLACEMENT 'UV_STICKY_SELECT_MODE_TYPE':
+Literal['SHARED_LOCATION', 'DISABLED', 'SHARED_VERTEX']
+
+SUBSTITUTION REPLACEMENT 'UV_SELECT_FLUSH_MODE_NEEDED':
+This function selection-mode independent, typically bmesh.types.BMesh.uv_select_flush_mode should be called afterwards.
+
+SUBSTITUTION REPLACEMENT 'UV_SELECT_SYNC_TO_MESH_NEEDED':
+This function doesn't flush the selection to the mesh, typically bmesh.types.BMesh.uv_select_sync_to_mesh should be called afterwards.
+
 
 --------------------
 
@@ -32,157 +44,102 @@ class BMDeformVert:
 
     def get(self, key: int, default: typing.Any | None = None) -> None:
         """Returns the deform weight matching the key or default
-        when not found (matches Python's dictionary function of the same name).
+        when not found (matches Pythons dictionary function of the same name).
 
                 :param key: The key associated with deform weight.
-                :type key: int
                 :param default: Optional argument for the value to return if
         key is not found.
-                :type default: typing.Any | None
         """
 
     def items(self) -> list[tuple[int, float]]:
         """Return (group, weight) pairs for this vertex
-        (matching Python's dict.items() functionality).
+        (matching Pythons dict.items() functionality).
 
                 :return: (key, value) pairs for each deform weight of this vertex.
-                :rtype: list[tuple[int, float]]
         """
 
     def keys(self) -> list[int]:
         """Return the group indices used by this vertex
-        (matching Python's dict.keys() functionality).
+        (matching Pythons dict.keys() functionality).
 
                 :return: the deform group this vertex uses
-                :rtype: list[int]
         """
 
     def values(self) -> list[float]:
         """Return the weights of the deform vertex
-        (matching Python's dict.values() functionality).
+        (matching Pythons dict.values() functionality).
 
                 :return: The weights that influence this vertex
-                :rtype: list[float]
         """
 
 class BMEdge:
     """The BMesh edge connecting 2 verts"""
 
     hide: bool
-    """ Hidden state of this element.
-
-    :type: bool
-    """
+    """ Hidden state of this element."""
 
     index: int
-    """ Index of this element.
-
-    :type: int
-    """
+    """ Index of this element."""
 
     is_boundary: bool
-    """ True when this edge is at the boundary of a face (read-only).
-
-    :type: bool
-    """
+    """ True when this edge is at the boundary of a face (read-only)."""
 
     is_contiguous: bool
-    """ True when this edge is manifold, between two faces with the same winding (read-only).
-
-    :type: bool
-    """
+    """ True when this edge is manifold, between two faces with the same winding (read-only)."""
 
     is_convex: bool
-    """ True when this edge joins two convex faces, depends on a valid face normal (read-only).
-
-    :type: bool
-    """
+    """ True when this edge joins two convex faces, depends on a valid face normal (read-only)."""
 
     is_manifold: bool
-    """ True when this edge is manifold (read-only).
-
-    :type: bool
-    """
+    """ True when this edge is manifold (read-only)."""
 
     is_valid: bool
-    """ True when this element is valid (hasn't been removed).
-
-    :type: bool
-    """
+    """ True when this element is valid (hasn't been removed)."""
 
     is_wire: bool
-    """ True when this edge is not connected to any faces (read-only).
-
-    :type: bool
-    """
-
-    link_faces: BMElemSeq[BMFace]
-    """ Faces connected to this edge, (read-only).
+    """ True when this edge is not connected to any faces (read-only)."""
 
-    :type: BMElemSeq[BMFace]
-    """
-
-    link_loops: BMElemSeq[BMLoop]
-    """ Loops connected to this edge, (read-only).
+    link_faces: typing.Any
+    """ Faces connected to this edge, (read-only)."""
 
-    :type: BMElemSeq[BMLoop]
-    """
+    link_loops: typing.Any
+    """ Loops connected to this edge, (read-only)."""
 
     seam: bool
-    """ Seam for UV unwrapping.
-
-    :type: bool
-    """
+    """ Seam for UV unwrapping."""
 
     select: bool
-    """ Selected state of this element.
-
-    :type: bool
-    """
+    """ Selected state of this element."""
 
     smooth: bool
-    """ Smooth state of this element.
-
-    :type: bool
-    """
+    """ Smooth state of this element."""
 
     tag: bool
-    """ Generic attribute scripts can use for own logic
-
-    :type: bool
-    """
-
-    verts: BMElemSeq[BMVert]
-    """ Verts this edge uses (always 2), (read-only).
+    """ Generic attribute scripts can use for own logic"""
 
-    :type: BMElemSeq[BMVert]
-    """
+    verts: typing.Any
+    """ Verts this edge uses (always 2), (read-only)."""
 
     def calc_face_angle(self, fallback: typing.Any | None = None) -> float:
         """
 
-                :param fallback: return this when the edge doesn't have 2 faces
+                :param fallback: return this when the edge doesnt have 2 faces
         (instead of raising a `ValueError`).
-                :type fallback: typing.Any | None
                 :return: The angle between 2 connected faces in radians.
-                :rtype: float
         """
 
     def calc_face_angle_signed(self, fallback: typing.Any | None = None) -> float:
         """
 
-                :param fallback: return this when the edge doesn't have 2 faces
+                :param fallback: return this when the edge doesnt have 2 faces
         (instead of raising a `ValueError`).
-                :type fallback: typing.Any | None
                 :return: The angle between 2 connected faces in radians (negative for concave join).
-                :rtype: float
         """
 
     def calc_length(self) -> float:
         """
 
         :return: The length between both verts.
-        :rtype: float
         """
 
     def calc_tangent(self, loop: BMLoop) -> mathutils.Vector:
@@ -190,16 +147,13 @@ class BMEdge:
         This uses the face normal for calculation.
 
                 :param loop: The loop used for tangent calculation.
-                :type loop: BMLoop
                 :return: a normalized vector.
-                :rtype: mathutils.Vector
         """
 
     def copy_from(self, other: typing_extensions.Self) -> None:
         """Copy values from another element of matching type.
 
         :param other:
-        :type other: typing_extensions.Self
         """
 
     def hide_set(self, hide: bool) -> None:
@@ -207,7 +161,6 @@ class BMEdge:
         This is different from the hide attribute because it updates the selection and hide state of associated geometry.
 
                 :param hide: Hidden or visible.
-                :type hide: bool
         """
 
     def normal_update(self) -> None:
@@ -217,9 +170,7 @@ class BMEdge:
         """Return the other vertex on this edge or None if the vertex is not used by this edge.
 
         :param vert: a vert in this edge.
-        :type vert: BMVert
         :return: The edges other vert.
-        :rtype: BMVert | None
         """
 
     def select_set(self, select: bool) -> None:
@@ -227,7 +178,6 @@ class BMEdge:
         This is different from the select attribute because it updates the selection state of associated geometry.
 
                 :param select: Select or de-select.
-                :type select: bool
         """
 
     def __getitem__[_GenericType1](
@@ -236,9 +186,7 @@ class BMEdge:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         :return:
-        :rtype: _GenericType1
         """
 
     def __setitem__[_GenericType1](
@@ -247,36 +195,32 @@ class BMEdge:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         :param value:
-        :type value: _GenericType1
         """
 
     def __delitem__[_GenericType1](self, key: BMLayerItem[_GenericType1]) -> None:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         """
 
 class BMEdgeSeq:
     layers: BMLayerAccessEdge
-    """ custom-data layers (read-only).
-
-    :type: BMLayerAccessEdge
-    """
+    """ custom-data layers (read-only)."""
 
     def ensure_lookup_table(self) -> None:
         """Ensure internal data needed for int subscription is initialized with verts/edges/faces, eg bm.verts[index].This needs to be called again after adding/removing data in this sequence."""
 
-    def get(self, verts: collections.abc.Sequence[BMVert], fallback=None) -> BMEdge:
+    def get(
+        self,
+        verts: collections.abc.Sequence[BMVert],
+        fallback: typing.Any | None = None,
+    ) -> BMEdge:
         """Return an edge which uses the verts passed.
 
         :param verts: Sequence of verts.
-        :type verts: collections.abc.Sequence[BMVert]
         :param fallback: Return this value if nothing is found.
         :return: The edge found or None
-        :rtype: BMEdge
         """
 
     def index_update(self) -> None:
@@ -288,34 +232,29 @@ class BMEdgeSeq:
         """Create a new edge from a given pair of verts.
 
         :param verts: Vertex pair.
-        :type verts: collections.abc.Sequence[BMVert]
         :param example: Existing edge to initialize settings (optional argument).
-        :type example: BMEdge | None
         :return: The newly created edge.
-        :rtype: BMEdge
         """
 
     def remove(self, edge: BMEdge) -> None:
         """Remove an edge.
 
-        :param edge:
-        :type edge: BMEdge
+        :param edge: The edge to remove.
         """
 
     def sort(
         self,
+        *,
         key: None
         | collections.abc.Callable[[BMVert | BMEdge | BMFace], int]
         | None = None,
         reverse: bool = False,
     ) -> None:
         """Sort the elements of this sequence, using an optional custom sort key.
-        Indices of elements are not changed, `BMElemSeq.index_update` can be used for that.
+        Indices of elements are not changed, `bmesh.types.BMElemSeq.index_update` can be used for that.
 
                 :param key: The key that sets the ordering of the elements.
-                :type key: None | collections.abc.Callable[[BMVert | BMEdge | BMFace], int] | None
                 :param reverse: Reverse the order of the elements
-                :type reverse: bool
         """
 
     @typing.overload
@@ -323,43 +262,34 @@ class BMEdgeSeq:
         """
 
         :param key:
-        :type key: int
         :return:
-        :rtype: BMEdge
         """
 
     @typing.overload
-    def __getitem__(self, key: slice) -> list[BMEdge, ...]:
+    def __getitem__(self, key: slice) -> list[BMEdge]:
         """
 
         :param key:
-        :type key: slice
         :return:
-        :rtype: list[BMEdge, ...]
         """
 
     def __iter__(self) -> BMIter[BMEdge]:
         """
 
         :return:
-        :rtype: BMIter[BMEdge]
         """
 
     def __len__(self) -> int:
         """
 
         :return:
-        :rtype: int
         """
 
 class BMEditSelIter: ...
 
 class BMEditSelSeq:
     active: BMEdge | BMFace | BMVert
-    """ The last selected element or None (read-only).
-
-    :type: BMEdge | BMFace | BMVert
-    """
+    """ The last selected element or None (read-only)."""
 
     def add(self, element) -> None:
         """Add an element to the selection history (no action taken if its already added).
@@ -371,7 +301,7 @@ class BMEditSelSeq:
         """Empties the selection history."""
 
     def discard(self, element) -> None:
-        """Discard an element from the selection history.Like remove but doesn't raise an error when the elements not in the selection list.
+        """Discard an element from the selection history.Like remove but doesnt raise an error when the elements not in the selection list.
 
         :param element:
         """
@@ -387,7 +317,7 @@ class BMEditSelSeq:
 
 class BMElemSeq[_GenericType1]:
     """General sequence type used for accessing any sequence of
-    `BMVert`, `BMEdge`, `BMFace`, `BMLoop`.When accessed via `BMesh.verts`, `BMesh.edges`, `BMesh.faces`
+    `bmesh.types.BMVert`, `bmesh.types.BMEdge`, `bmesh.types.BMFace`, `bmesh.types.BMLoop`.When accessed via `bmesh.types.BMesh.verts`, `bmesh.types.BMesh.edges`, `bmesh.types.BMesh.faces`
     there are also functions to create/remove items.
     """
 
@@ -399,183 +329,134 @@ class BMElemSeq[_GenericType1]:
         """
 
         :param key:
-        :type key: int
         :return:
-        :rtype: _GenericType1
         """
 
     @typing.overload
-    def __getitem__(self, key: slice) -> list[_GenericType1, ...]:
+    def __getitem__(self, key: slice) -> list[_GenericType1]:
         """
 
         :param key:
-        :type key: slice
         :return:
-        :rtype: list[_GenericType1, ...]
         """
 
     def __iter__(self) -> BMIter[_GenericType1]:
         """
 
         :return:
-        :rtype: BMIter[_GenericType1]
         """
 
     def __len__(self) -> int:
         """
 
         :return:
-        :rtype: int
         """
 
 class BMFace:
     """The BMesh face with 3 or more sides"""
 
-    edges: BMElemSeq[BMEdge]
-    """ Edges of this face, (read-only).
-
-    :type: BMElemSeq[BMEdge]
-    """
+    edges: typing.Any
+    """ Edges of this face, (read-only)."""
 
     hide: bool
-    """ Hidden state of this element.
-
-    :type: bool
-    """
+    """ Hidden state of this element."""
 
     index: int
-    """ Index of this element.
-
-    :type: int
-    """
+    """ Index of this element."""
 
     is_valid: bool
-    """ True when this element is valid (hasn't been removed).
+    """ True when this element is valid (hasn't been removed)."""
 
-    :type: bool
-    """
-
-    loops: BMElemSeq[BMLoop]
-    """ Loops of this face, (read-only).
-
-    :type: BMElemSeq[BMLoop]
-    """
+    loops: typing.Any
+    """ Loops of this face, (read-only)."""
 
     material_index: int
-    """ The face's material index.
-
-    :type: int
-    """
+    """ The face's material index."""
 
     normal: mathutils.Vector
-    """ The normal for this face as a 3D, wrapped vector.
-
-    :type: mathutils.Vector
-    """
+    """ The normal for this face as a 3D, wrapped vector."""
 
     select: bool
-    """ Selected state of this element.
-
-    :type: bool
-    """
+    """ Selected state of this element."""
 
     smooth: bool
-    """ Smooth state of this element.
-
-    :type: bool
-    """
+    """ Smooth state of this element."""
 
     tag: bool
-    """ Generic attribute scripts can use for own logic
+    """ Generic attribute scripts can use for own logic"""
 
-    :type: bool
-    """
-
-    verts: BMElemSeq[BMVert]
-    """ Verts of this face, (read-only).
+    uv_select: bool
+    """ UV selected state of this element."""
 
-    :type: BMElemSeq[BMVert]
-    """
+    verts: typing.Any
+    """ Verts of this face, (read-only)."""
 
     def calc_area(self) -> float:
         """Return the area of the face.
 
         :return: Return the area of the face.
-        :rtype: float
         """
 
     def calc_center_bounds(self) -> mathutils.Vector:
         """Return bounds center of the face.
 
         :return: a 3D vector.
-        :rtype: mathutils.Vector
         """
 
     def calc_center_median(self) -> mathutils.Vector:
         """Return median center of the face.
 
         :return: a 3D vector.
-        :rtype: mathutils.Vector
         """
 
     def calc_center_median_weighted(self) -> mathutils.Vector:
         """Return median center of the face weighted by edge lengths.
 
         :return: a 3D vector.
-        :rtype: mathutils.Vector
         """
 
     def calc_perimeter(self) -> float:
         """Return the perimeter of the face.
 
         :return: Return the perimeter of the face.
-        :rtype: float
         """
 
     def calc_tangent_edge(self) -> mathutils.Vector:
         """Return face tangent based on longest edge.
 
         :return: a normalized vector.
-        :rtype: mathutils.Vector
         """
 
     def calc_tangent_edge_diagonal(self) -> mathutils.Vector:
         """Return face tangent based on the edge farthest from any vertex.
 
         :return: a normalized vector.
-        :rtype: mathutils.Vector
         """
 
     def calc_tangent_edge_pair(self) -> mathutils.Vector:
         """Return face tangent based on the two longest disconnected edges.
 
         :return: a normalized vector.
-        :rtype: mathutils.Vector
         """
 
     def calc_tangent_vert_diagonal(self) -> mathutils.Vector:
         """Return face tangent based on the two most distant vertices.
 
         :return: a normalized vector.
-        :rtype: mathutils.Vector
         """
 
-    def copy(self, verts: bool = True, edges: bool = True) -> typing_extensions.Self:
+    def copy(self, *, verts: bool = True, edges: bool = True) -> typing_extensions.Self:
         """Make a copy of this face.
 
         :param verts: When set, the faces verts will be duplicated too.
-        :type verts: bool
         :param edges: When set, the faces edges will be duplicated too.
-        :type edges: bool
         :return: The newly created face.
-        :rtype: typing_extensions.Self
         """
 
     def copy_from(self, other: typing_extensions.Self) -> None:
         """Copy values from another element of matching type.
 
         :param other:
-        :type other: typing_extensions.Self
         """
 
     def copy_from_face_interp(
@@ -584,9 +465,7 @@ class BMFace:
         """Interpolate the customdata from another face onto this one (faces should overlap).
 
         :param face: The face to interpolate data from.
-        :type face: typing_extensions.Self
         :param vert: When True, also copy vertex data.
-        :type vert: bool
         """
 
     def hide_set(self, hide: bool) -> None:
@@ -594,7 +473,6 @@ class BMFace:
         This is different from the hide attribute because it updates the selection and hide state of associated geometry.
 
                 :param hide: Hidden or visible.
-                :type hide: bool
         """
 
     def normal_flip(self) -> None:
@@ -611,7 +489,12 @@ class BMFace:
         This is different from the select attribute because it updates the selection state of associated geometry.
 
                 :param select: Select or de-select.
-                :type select: bool
+        """
+
+    def uv_select_set(self, select: bool) -> None:
+        """Select the face.
+
+        :param select: Select or de-select.
         """
 
     def __getitem__[_GenericType1](
@@ -620,9 +503,7 @@ class BMFace:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         :return:
-        :rtype: _GenericType1
         """
 
     def __setitem__[_GenericType1](
@@ -631,42 +512,35 @@ class BMFace:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         :param value:
-        :type value: _GenericType1
         """
 
     def __delitem__[_GenericType1](self, key: BMLayerItem[_GenericType1]) -> None:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         """
 
 class BMFaceSeq:
     active: BMFace | None
-    """ active face.
-
-    :type: BMFace | None
-    """
+    """ active face."""
 
     layers: BMLayerAccessFace
-    """ custom-data layers (read-only).
-
-    :type: BMLayerAccessFace
-    """
+    """ custom-data layers (read-only)."""
 
     def ensure_lookup_table(self) -> None:
         """Ensure internal data needed for int subscription is initialized with verts/edges/faces, eg bm.verts[index].This needs to be called again after adding/removing data in this sequence."""
 
-    def get(self, verts: collections.abc.Sequence[BMVert], fallback=None) -> BMFace:
+    def get(
+        self,
+        verts: collections.abc.Sequence[BMVert],
+        fallback: typing.Any | None = None,
+    ) -> BMFace:
         """Return a face which uses the verts passed.
 
         :param verts: Sequence of verts.
-        :type verts: collections.abc.Sequence[BMVert]
         :param fallback: Return this value if nothing is found.
         :return: The face found or None
-        :rtype: BMFace
         """
 
     def index_update(self) -> None:
@@ -678,34 +552,29 @@ class BMFaceSeq:
         """Create a new face from a given set of verts.
 
         :param verts: Sequence of 3 or more verts.
-        :type verts: collections.abc.Sequence[BMVert]
         :param example: Existing face to initialize settings (optional argument).
-        :type example: BMFace | None
         :return: The newly created face.
-        :rtype: BMFace
         """
 
     def remove(self, face: BMFace) -> None:
         """Remove a face.
 
-        :param face:
-        :type face: BMFace
+        :param face: The face to remove.
         """
 
     def sort(
         self,
+        *,
         key: None
         | collections.abc.Callable[[BMVert | BMEdge | BMFace], int]
         | None = None,
         reverse: bool = False,
     ) -> None:
         """Sort the elements of this sequence, using an optional custom sort key.
-        Indices of elements are not changed, `BMElemSeq.index_update` can be used for that.
+        Indices of elements are not changed, `bmesh.types.BMElemSeq.index_update` can be used for that.
 
                 :param key: The key that sets the ordering of the elements.
-                :type key: None | collections.abc.Callable[[BMVert | BMEdge | BMFace], int] | None
                 :param reverse: Reverse the order of the elements
-                :type reverse: bool
         """
 
     @typing.overload
@@ -713,441 +582,275 @@ class BMFaceSeq:
         """
 
         :param key:
-        :type key: int
         :return:
-        :rtype: BMFace
         """
 
     @typing.overload
-    def __getitem__(self, key: slice) -> list[BMFace, ...]:
+    def __getitem__(self, key: slice) -> list[BMFace]:
         """
 
         :param key:
-        :type key: slice
         :return:
-        :rtype: list[BMFace, ...]
         """
 
     def __iter__(self) -> BMIter[BMFace]:
         """
 
         :return:
-        :rtype: BMIter[BMFace]
         """
 
     def __len__(self) -> int:
         """
 
         :return:
-        :rtype: int
         """
 
 class BMIter[_GenericType1]:
     """Internal BMesh type for looping over verts/faces/edges,
-    used for iterating over `BMElemSeq` types.
+    used for iterating over `bmesh.types.BMElemSeq` types.
     """
 
     def __iter__(self) -> BMIter[_GenericType1]:
         """
 
         :return:
-        :rtype: BMIter[_GenericType1]
         """
 
     def __next__(self) -> _GenericType1:
         """
 
         :return:
-        :rtype: _GenericType1
         """
 
 class BMLayerAccessEdge:
     """Exposes custom-data layer attributes."""
 
-    bool: BMLayerCollection[boolean]
-    """ Generic boolean custom-data layer.
+    bool: typing.Any
+    """ Generic boolean custom-data layer."""
 
-    :type: BMLayerCollection[boolean]
-    """
+    color: typing.Any
+    """ Generic RGBA color with 8-bit precision custom-data layer."""
 
-    color: BMLayerCollection[mathutils.Vector]
-    """ Generic RGBA color with 8-bit precision custom-data layer.
+    float: typing.Any
+    """ Generic float custom-data layer."""
 
-    :type: BMLayerCollection[mathutils.Vector]
-    """
-
-    float: BMLayerCollection[float]
-    """ Generic float custom-data layer.
+    float_color: typing.Any
+    """ Generic RGBA color with float precision custom-data layer."""
 
-    :type: BMLayerCollection[float]
-    """
+    float_vector: typing.Any
+    """ Generic 3D vector with float precision custom-data layer."""
 
-    float_color: BMLayerCollection[mathutils.Vector]
-    """ Generic RGBA color with float precision custom-data layer.
+    int: typing.Any
+    """ Generic int custom-data layer."""
 
-    :type: BMLayerCollection[mathutils.Vector]
-    """
-
-    float_vector: BMLayerCollection[mathutils.Vector]
-    """ Generic 3D vector with float precision custom-data layer.
-
-    :type: BMLayerCollection[mathutils.Vector]
-    """
-
-    freestyle: BMLayerCollection
-    """ Accessor for Freestyle edge layer.
-
-    :type: BMLayerCollection
-    """
-
-    int: BMLayerCollection[int]
-    """ Generic int custom-data layer.
-
-    :type: BMLayerCollection[int]
-    """
-
-    string: BMLayerCollection[bytes]
-    """ Generic string custom-data layer (exposed as bytes, 255 max length).
-
-    :type: BMLayerCollection[bytes]
-    """
+    string: typing.Any
+    """ Generic string custom-data layer (exposed as bytes, 255 max length)."""
 
 class BMLayerAccessFace:
     """Exposes custom-data layer attributes."""
 
-    bool: BMLayerCollection[boolean]
-    """ Generic boolean custom-data layer.
-
-    :type: BMLayerCollection[boolean]
-    """
-
-    color: BMLayerCollection[mathutils.Vector]
-    """ Generic RGBA color with 8-bit precision custom-data layer.
-
-    :type: BMLayerCollection[mathutils.Vector]
-    """
-
-    float: BMLayerCollection[float]
-    """ Generic float custom-data layer.
-
-    :type: BMLayerCollection[float]
-    """
+    bool: typing.Any
+    """ Generic boolean custom-data layer."""
 
-    float_color: BMLayerCollection[mathutils.Vector]
-    """ Generic RGBA color with float precision custom-data layer.
+    color: typing.Any
+    """ Generic RGBA color with 8-bit precision custom-data layer."""
 
-    :type: BMLayerCollection[mathutils.Vector]
-    """
-
-    float_vector: BMLayerCollection[mathutils.Vector]
-    """ Generic 3D vector with float precision custom-data layer.
+    float: typing.Any
+    """ Generic float custom-data layer."""
 
-    :type: BMLayerCollection[mathutils.Vector]
-    """
+    float_color: typing.Any
+    """ Generic RGBA color with float precision custom-data layer."""
 
-    freestyle: BMLayerCollection
-    """ Accessor for Freestyle face layer.
+    float_vector: typing.Any
+    """ Generic 3D vector with float precision custom-data layer."""
 
-    :type: BMLayerCollection
-    """
+    int: typing.Any
+    """ Generic int custom-data layer."""
 
-    int: BMLayerCollection[int]
-    """ Generic int custom-data layer.
-
-    :type: BMLayerCollection[int]
-    """
-
-    string: BMLayerCollection[bytes]
-    """ Generic string custom-data layer (exposed as bytes, 255 max length).
-
-    :type: BMLayerCollection[bytes]
-    """
+    string: typing.Any
+    """ Generic string custom-data layer (exposed as bytes, 255 max length)."""
 
 class BMLayerAccessLoop:
     """Exposes custom-data layer attributes."""
 
-    bool: BMLayerCollection[boolean]
-    """ Generic boolean custom-data layer.
-
-    :type: BMLayerCollection[boolean]
-    """
-
-    color: BMLayerCollection[mathutils.Vector]
-    """ Generic RGBA color with 8-bit precision custom-data layer.
-
-    :type: BMLayerCollection[mathutils.Vector]
-    """
-
-    float: BMLayerCollection[float]
-    """ Generic float custom-data layer.
-
-    :type: BMLayerCollection[float]
-    """
-
-    float_color: BMLayerCollection[mathutils.Vector]
-    """ Generic RGBA color with float precision custom-data layer.
-
-    :type: BMLayerCollection[mathutils.Vector]
-    """
-
-    float_vector: BMLayerCollection[mathutils.Vector]
-    """ Generic 3D vector with float precision custom-data layer.
+    bool: typing.Any
+    """ Generic boolean custom-data layer."""
 
-    :type: BMLayerCollection[mathutils.Vector]
-    """
+    color: typing.Any
+    """ Generic RGBA color with 8-bit precision custom-data layer."""
 
-    int: BMLayerCollection[int]
-    """ Generic int custom-data layer.
+    float: typing.Any
+    """ Generic float custom-data layer."""
 
-    :type: BMLayerCollection[int]
-    """
+    float_color: typing.Any
+    """ Generic RGBA color with float precision custom-data layer."""
 
-    string: BMLayerCollection[bytes]
-    """ Generic string custom-data layer (exposed as bytes, 255 max length).
+    float_vector: typing.Any
+    """ Generic 3D vector with float precision custom-data layer."""
 
-    :type: BMLayerCollection[bytes]
-    """
+    int: typing.Any
+    """ Generic int custom-data layer."""
 
-    uv: BMLayerCollection[BMLoopUV]
-    """ Accessor for `BMLoopUV` UV (as a 2D Vector).
+    string: typing.Any
+    """ Generic string custom-data layer (exposed as bytes, 255 max length)."""
 
-    :type: BMLayerCollection[BMLoopUV]
-    """
+    uv: typing.Any
+    """ Accessor for `bmesh.types.BMLoopUV` UV (as a 2D Vector)."""
 
 class BMLayerAccessVert:
     """Exposes custom-data layer attributes."""
 
-    bool: BMLayerCollection[boolean]
-    """ Generic boolean custom-data layer.
-
-    :type: BMLayerCollection[boolean]
-    """
-
-    color: BMLayerCollection[mathutils.Vector]
-    """ Generic RGBA color with 8-bit precision custom-data layer.
+    bool: typing.Any
+    """ Generic boolean custom-data layer."""
 
-    :type: BMLayerCollection[mathutils.Vector]
-    """
-
-    deform: BMLayerCollection[BMDeformVert]
-    """ Vertex deform weight `BMDeformVert` (TODO).
-
-    :type: BMLayerCollection[BMDeformVert]
-    """
+    color: typing.Any
+    """ Generic RGBA color with 8-bit precision custom-data layer."""
 
-    float: BMLayerCollection[float]
-    """ Generic float custom-data layer.
+    deform: typing.Any
+    """ Vertex deform weight `bmesh.types.BMDeformVert` (TODO)."""
 
-    :type: BMLayerCollection[float]
-    """
-
-    float_color: BMLayerCollection[mathutils.Vector]
-    """ Generic RGBA color with float precision custom-data layer.
+    float: typing.Any
+    """ Generic float custom-data layer."""
 
-    :type: BMLayerCollection[mathutils.Vector]
-    """
+    float_color: typing.Any
+    """ Generic RGBA color with float precision custom-data layer."""
 
-    float_vector: BMLayerCollection[mathutils.Vector]
-    """ Generic 3D vector with float precision custom-data layer.
+    float_vector: typing.Any
+    """ Generic 3D vector with float precision custom-data layer."""
 
-    :type: BMLayerCollection[mathutils.Vector]
-    """
+    int: typing.Any
+    """ Generic int custom-data layer."""
 
-    int: BMLayerCollection[int]
-    """ Generic int custom-data layer.
-
-    :type: BMLayerCollection[int]
-    """
-
-    shape: BMLayerCollection[mathutils.Vector]
-    """ Vertex shapekey absolute location (as a 3D Vector).
-
-    :type: BMLayerCollection[mathutils.Vector]
-    """
+    shape: typing.Any
+    """ Vertex shape-key absolute location (as a 3D Vector)."""
 
     skin: typing.Any
     """ Accessor for skin layer."""
 
-    string: BMLayerCollection[bytes]
-    """ Generic string custom-data layer (exposed as bytes, 255 max length).
-
-    :type: BMLayerCollection[bytes]
-    """
+    string: typing.Any
+    """ Generic string custom-data layer (exposed as bytes, 255 max length)."""
 
 class BMLayerCollection[_GenericType1]:
     """Gives access to a collection of custom-data layers of the same type and behaves like Python dictionaries, except for the ability to do list like index access."""
 
     active: BMLayerItem[_GenericType1]
-    """ 
-
-    :type: BMLayerItem[_GenericType1]
-    """
-
     is_singleton: bool
-    """ True if there can exists only one layer of this type (read-only).
-
-    :type: bool
-    """
+    """ True if there can exists only one layer of this type (read-only)."""
 
     def get[_GenericType2](
         self, key: str, default: _GenericType2 = None
     ) -> BMLayerItem[_GenericType1] | _GenericType2:
         """Returns the value of the layer matching the key or default
-        when not found (matches Python's dictionary function of the same name).
+        when not found (matches Pythons dictionary function of the same name).
 
                 :param key: The key associated with the layer.
-                :type key: str
                 :param default: Optional argument for the value to return if
         key is not found.
-                :type default: _GenericType2
                 :return:
-                :rtype: BMLayerItem[_GenericType1] | _GenericType2
         """
 
     def items(self) -> list[str, BMLayerItem[_GenericType1]]:
         """Return the identifiers of collection members
-        (matching Python's dict.items() functionality).
+        (matching Pythons dict.items() functionality).
 
                 :return: (key, value) pairs for each member of this collection.
-                :rtype: list[str, BMLayerItem[_GenericType1]]
         """
 
     def keys(self) -> list[str]:
         """Return the identifiers of collection members
-        (matching Python's dict.keys() functionality).
+        (matching Pythons dict.keys() functionality).
 
                 :return: the identifiers for each member of this collection.
-                :rtype: list[str]
         """
 
     def new(self, name: str | None = "") -> BMLayerItem[_GenericType1]:
         """Create a new layer
 
         :param name: Optional name argument (will be made unique).
-        :type name: str | None
         :return: The newly created layer.
-        :rtype: BMLayerItem[_GenericType1]
         """
 
     def remove(self, layer: BMLayerItem[_GenericType1]) -> None:
         """Remove a layer
 
         :param layer: The layer to remove.
-        :type layer: BMLayerItem[_GenericType1]
         """
 
     def values(self) -> list[BMLayerItem[_GenericType1]]:
         """Return the values of collection
-        (matching Python's dict.values() functionality).
+        (matching Pythons dict.values() functionality).
 
                 :return: the members of this collection.
-                :rtype: list[BMLayerItem[_GenericType1]]
         """
 
     def verify(self) -> BMLayerItem[_GenericType1]:
         """Create a new layer or return an existing active layer
 
         :return: The newly verified layer.
-        :rtype: BMLayerItem[_GenericType1]
         """
 
 class BMLayerItem[_GenericType1]:
     """Exposes a single custom data layer, their main purpose is for use as item accessors to custom-data when used with vert/edge/face/loop data."""
 
     name: str
-    """ The layers unique name (read-only).
-
-    :type: str
-    """
+    """ The layers unique name (read-only)."""
 
     def copy_from(self, other: typing_extensions.Self) -> None:
-        """Return a copy of the layer
+        """Copy data from another layer.
 
         :param other: Another layer to copy from.
-        :type other: typing_extensions.Self
         """
 
 class BMLoop:
-    """This is normally accessed from `BMFace.loops` where each face loop represents a corner of the face."""
+    """This is normally accessed from `bmesh.types.BMFace.loops` where each face loop represents a corner of the face."""
 
     edge: BMEdge
-    """ The loop's edge (between this loop and the next), (read-only).
-
-    :type: BMEdge
-    """
+    """ The loop's edge (between this loop and the next), (read-only)."""
 
     face: BMFace
-    """ The face this loop makes (read-only).
-
-    :type: BMFace
-    """
+    """ The face this loop makes (read-only)."""
 
     index: int
-    """ Index of this element.
-
-    :type: int
-    """
+    """ Index of this element."""
 
     is_convex: bool
-    """ True when this loop is at the convex corner of a face, depends on a valid face normal (read-only).
-
-    :type: bool
-    """
+    """ True when this loop is at the convex corner of a face, depends on a valid face normal (read-only)."""
 
     is_valid: bool
-    """ True when this element is valid (hasn't been removed).
-
-    :type: bool
-    """
+    """ True when this element is valid (hasn't been removed)."""
 
     link_loop_next: typing_extensions.Self
-    """ The next face corner (read-only).
-
-    :type: typing_extensions.Self
-    """
+    """ The next face corner (read-only)."""
 
     link_loop_prev: typing_extensions.Self
-    """ The previous face corner (read-only).
-
-    :type: typing_extensions.Self
-    """
+    """ The previous face corner (read-only)."""
 
     link_loop_radial_next: typing_extensions.Self
-    """ The next loop around the edge (read-only).
-
-    :type: typing_extensions.Self
-    """
+    """ The next loop around the edge (read-only)."""
 
     link_loop_radial_prev: typing_extensions.Self
-    """ The previous loop around the edge (read-only).
-
-    :type: typing_extensions.Self
-    """
+    """ The previous loop around the edge (read-only)."""
 
-    link_loops: BMElemSeq[BMLoop]
-    """ Loops connected to this loop, (read-only).
-
-    :type: BMElemSeq[BMLoop]
-    """
+    link_loops: typing.Any
+    """ Loops connected to this loop, (read-only)."""
 
     tag: bool
-    """ Generic attribute scripts can use for own logic
+    """ Generic attribute scripts can use for own logic"""
 
-    :type: bool
-    """
+    uv_select_edge: bool
+    """ UV selected state of this element."""
 
-    vert: BMVert
-    """ The loop's vertex (read-only).
+    uv_select_vert: bool
+    """ UV selected state of this element."""
 
-    :type: BMVert
-    """
+    vert: BMVert
+    """ The loop's vertex (read-only)."""
 
     def calc_angle(self) -> float:
         """Return the angle at this loops corner of the face.
         This is calculated so sharper corners give lower angles.
 
                 :return: The angle in radians.
-                :rtype: float
         """
 
     def calc_normal(self) -> mathutils.Vector:
@@ -1155,7 +858,6 @@ class BMLoop:
         Falls back to the face normal for straight lines.
 
                 :return: a normalized vector.
-                :rtype: mathutils.Vector
         """
 
     def calc_tangent(self) -> mathutils.Vector:
@@ -1163,14 +865,12 @@ class BMLoop:
         Falls back to the face normal for straight lines.
 
                 :return: a normalized vector.
-                :rtype: mathutils.Vector
         """
 
     def copy_from(self, other: typing_extensions.Self) -> None:
         """Copy values from another element of matching type.
 
         :param other:
-        :type other: typing_extensions.Self
         """
 
     def copy_from_face_interp(
@@ -1179,11 +879,20 @@ class BMLoop:
         """Interpolate the customdata from a face onto this loop (the loops vert should overlap the face).
 
         :param face: The face to interpolate data from.
-        :type face: BMFace
         :param vert: When enabled, interpolate the loops vertex data (optional).
-        :type vert: bool
         :param multires: When enabled, interpolate the loops multires data (optional).
-        :type multires: bool
+        """
+
+    def uv_select_edge_set(self, select: bool) -> None:
+        """Set the UV edge selection state.
+
+        :param select: Select or de-select.
+        """
+
+    def uv_select_vert_set(self, select: bool) -> None:
+        """Select the UV vertex.
+
+        :param select: Select or de-select.
         """
 
     def __getitem__[_GenericType1](
@@ -1192,9 +901,7 @@ class BMLoop:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         :return:
-        :rtype: _GenericType1
         """
 
     def __setitem__[_GenericType1](
@@ -1203,173 +910,102 @@ class BMLoop:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         :param value:
-        :type value: _GenericType1
         """
 
     def __delitem__[_GenericType1](self, key: BMLayerItem[_GenericType1]) -> None:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         """
 
 class BMLoopSeq:
     layers: BMLayerAccessLoop
-    """ custom-data layers (read-only).
-
-    :type: BMLayerAccessLoop
-    """
+    """ custom-data layers (read-only)."""
 
     @typing.overload
     def __getitem__(self, key: int) -> BMLoop:
         """
 
         :param key:
-        :type key: int
         :return:
-        :rtype: BMLoop
         """
 
     @typing.overload
-    def __getitem__(self, key: slice) -> list[BMLoop, ...]:
+    def __getitem__(self, key: slice) -> list[BMLoop]:
         """
 
         :param key:
-        :type key: slice
         :return:
-        :rtype: list[BMLoop, ...]
         """
 
     def __iter__(self) -> BMIter[BMLoop]:
         """
 
         :return:
-        :rtype: BMIter[BMLoop]
         """
 
     def __len__(self) -> int:
         """
 
         :return:
-        :rtype: int
         """
 
 class BMLoopUV:
     pin_uv: bool
-    """ UV pin state.
-
-    :type: bool
-    """
-
-    select: bool
-    """ UV select state.
-
-    :type: bool
-    """
-
-    select_edge: bool
-    """ UV edge select state.
-
-    :type: bool
-    """
+    """ UV pin state."""
 
     uv: mathutils.Vector
-    """ Loops UV (as a 2D Vector).
-
-    :type: mathutils.Vector
-    """
+    """ Loops UV (as a 2D Vector)."""
 
 class BMVert:
     """The BMesh vertex type"""
 
     co: mathutils.Vector
-    """ The coordinates for this vertex as a 3D, wrapped vector.
-
-    :type: mathutils.Vector
-    """
+    """ The coordinates for this vertex as a 3D, wrapped vector."""
 
     hide: bool
-    """ Hidden state of this element.
-
-    :type: bool
-    """
+    """ Hidden state of this element."""
 
     index: int
-    """ Index of this element.
-
-    :type: int
-    """
+    """ Index of this element."""
 
     is_boundary: bool
-    """ True when this vertex is connected to boundary edges (read-only).
-
-    :type: bool
-    """
+    """ True when this vertex is connected to boundary edges (read-only)."""
 
     is_manifold: bool
-    """ True when this vertex is manifold (read-only).
-
-    :type: bool
-    """
+    """ True when this vertex is manifold (read-only)."""
 
     is_valid: bool
-    """ True when this element is valid (hasn't been removed).
-
-    :type: bool
-    """
+    """ True when this element is valid (hasn't been removed)."""
 
     is_wire: bool
-    """ True when this vertex is not connected to any faces (read-only).
+    """ True when this vertex is not connected to any faces (read-only)."""
 
-    :type: bool
-    """
+    link_edges: typing.Any
+    """ Edges connected to this vertex (read-only)."""
 
-    link_edges: BMElemSeq[BMEdge]
-    """ Edges connected to this vertex (read-only).
+    link_faces: typing.Any
+    """ Faces connected to this vertex (read-only)."""
 
-    :type: BMElemSeq[BMEdge]
-    """
-
-    link_faces: BMElemSeq[BMFace]
-    """ Faces connected to this vertex (read-only).
-
-    :type: BMElemSeq[BMFace]
-    """
-
-    link_loops: BMElemSeq[BMLoop]
-    """ Loops that use this vertex (read-only).
-
-    :type: BMElemSeq[BMLoop]
-    """
+    link_loops: typing.Any
+    """ Loops that use this vertex (read-only)."""
 
     normal: mathutils.Vector
-    """ The normal for this vertex as a 3D, wrapped vector.
-
-    :type: mathutils.Vector
-    """
+    """ The normal for this vertex as a 3D, wrapped vector."""
 
     select: bool
-    """ Selected state of this element.
-
-    :type: bool
-    """
+    """ Selected state of this element."""
 
     tag: bool
-    """ Generic attribute scripts can use for own logic
-
-    :type: bool
-    """
+    """ Generic attribute scripts can use for own logic"""
 
     def calc_edge_angle(self, fallback: typing.Any | None = None) -> float:
-        """Return the angle between this vert's two connected edges.
+        """Return the angle between this verts two connected edges.
 
-                :param fallback: return this when the vert doesn't have 2 edges
+                :param fallback: return this when the vert doesnt have 2 edges
         (instead of raising a `ValueError`).
-                :type fallback: typing.Any | None
                 :return: Angle between edges in radians.
-                :rtype: float
         """
 
     def calc_shell_factor(self) -> float:
@@ -1378,21 +1014,18 @@ class BMVert:
         This is used to maintain shell thickness when offsetting verts along their normals.
 
                 :return: offset multiplier
-                :rtype: float
         """
 
     def copy_from(self, other: typing_extensions.Self) -> None:
         """Copy values from another element of matching type.
 
         :param other:
-        :type other: typing_extensions.Self
         """
 
     def copy_from_face_interp(self, face: BMFace) -> None:
         """Interpolate the customdata from a face onto this loop (the loops vert should overlap the face).
 
         :param face: The face to interpolate data from.
-        :type face: BMFace
         """
 
     def copy_from_vert_interp(
@@ -1401,9 +1034,7 @@ class BMVert:
         """Interpolate the customdata from a vert between 2 other verts.
 
         :param vert_pair: The verts between which to interpolate data from.
-        :type vert_pair: collections.abc.Sequence[BMVert]
-        :param fac:
-        :type fac: float
+        :param fac: The interpolation factor.
         """
 
     def hide_set(self, hide: bool) -> None:
@@ -1411,7 +1042,6 @@ class BMVert:
         This is different from the hide attribute because it updates the selection and hide state of associated geometry.
 
                 :param hide: Hidden or visible.
-                :type hide: bool
         """
 
     def normal_update(self) -> None:
@@ -1425,7 +1055,6 @@ class BMVert:
         This is different from the select attribute because it updates the selection state of associated geometry.
 
                 :param select: Select or de-select.
-                :type select: bool
         """
 
     def __getitem__[_GenericType1](
@@ -1434,9 +1063,7 @@ class BMVert:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         :return:
-        :rtype: _GenericType1
         """
 
     def __setitem__[_GenericType1](
@@ -1445,24 +1072,18 @@ class BMVert:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         :param value:
-        :type value: _GenericType1
         """
 
     def __delitem__[_GenericType1](self, key: BMLayerItem[_GenericType1]) -> None:
         """
 
         :param key:
-        :type key: BMLayerItem[_GenericType1]
         """
 
 class BMVertSeq:
     layers: BMLayerAccessVert
-    """ custom-data layers (read-only).
-
-    :type: BMLayerAccessVert
-    """
+    """ custom-data layers (read-only)."""
 
     def ensure_lookup_table(self) -> None:
         """Ensure internal data needed for int subscription is initialized with verts/edges/faces, eg bm.verts[index].This needs to be called again after adding/removing data in this sequence."""
@@ -1478,34 +1099,29 @@ class BMVertSeq:
         """Create a new vertex.
 
         :param co: The initial location of the vertex (optional argument).
-        :type co: collections.abc.Sequence[float] | mathutils.Vector
         :param example: Existing vert to initialize settings.
-        :type example: BMVert | None
         :return: The newly created vertex.
-        :rtype: BMVert
         """
 
     def remove(self, vert: BMVert) -> None:
         """Remove a vert.
 
-        :param vert:
-        :type vert: BMVert
+        :param vert: The vert to remove.
         """
 
     def sort(
         self,
+        *,
         key: None
         | collections.abc.Callable[[BMVert | BMEdge | BMFace], int]
         | None = None,
         reverse: bool = False,
     ) -> None:
         """Sort the elements of this sequence, using an optional custom sort key.
-        Indices of elements are not changed, `BMElemSeq.index_update` can be used for that.
+        Indices of elements are not changed, `bmesh.types.BMElemSeq.index_update` can be used for that.
 
                 :param key: The key that sets the ordering of the elements.
-                :type key: None | collections.abc.Callable[[BMVert | BMEdge | BMFace], int] | None
                 :param reverse: Reverse the order of the elements
-                :type reverse: bool
         """
 
     @typing.overload
@@ -1513,100 +1129,70 @@ class BMVertSeq:
         """
 
         :param key:
-        :type key: int
         :return:
-        :rtype: BMVert
         """
 
     @typing.overload
-    def __getitem__(self, key: slice) -> list[BMVert, ...]:
+    def __getitem__(self, key: slice) -> list[BMVert]:
         """
 
         :param key:
-        :type key: slice
         :return:
-        :rtype: list[BMVert, ...]
         """
 
     def __iter__(self) -> BMIter[BMVert]:
         """
 
         :return:
-        :rtype: BMIter[BMVert]
         """
 
     def __len__(self) -> int:
         """
 
         :return:
-        :rtype: int
         """
 
 class BMesh:
     """The BMesh data structure"""
 
     edges: BMEdgeSeq
-    """ This meshes edge sequence (read-only).
-
-    :type: BMEdgeSeq
-    """
+    """ This meshes edge sequence (read-only)."""
 
     faces: BMFaceSeq
-    """ This meshes face sequence (read-only).
-
-    :type: BMFaceSeq
-    """
+    """ This meshes face sequence (read-only)."""
 
     is_valid: bool
-    """ True when this element is valid (hasn't been removed).
-
-    :type: bool
-    """
+    """ True when this element is valid (hasn't been removed)."""
 
     is_wrapped: bool
-    """ True when this mesh is owned by blender (typically the editmode BMesh).
-
-    :type: bool
-    """
+    """ True when this mesh is owned by blender (typically the editmode BMesh)."""
 
     loops: BMLoopSeq
-    """ This meshes loops (read-only).
-
-    :type: BMLoopSeq
-    """
+    """ This meshes loops (read-only)."""
 
     select_history: BMEditSelSeq
-    """ Sequence of selected items (the last is displayed as active).
-
-    :type: BMEditSelSeq
-    """
+    """ Sequence of selected items (the last is displayed as active)."""
 
-    select_mode: set
-    """ The selection mode, values can be {'VERT', 'EDGE', 'FACE'}, can't be assigned an empty set.
+    select_mode: set[typing.Literal["VERT", "EDGE", "FACE"]]
+    """ The selection mode, cannot be assigned an empty set."""
 
-    :type: set
-    """
+    uv_select_sync_valid: bool
+    """ When true, the UV selection has been synchronized. Setting to False means the UV selection will be ignored. While setting to true is supported it is up to the script author to ensure a correct selection state before doing so."""
 
     verts: BMVertSeq
-    """ This meshes vert sequence (read-only).
-
-    :type: BMVertSeq
-    """
+    """ This meshes vert sequence (read-only)."""
 
     def calc_loop_triangles(self) -> list[tuple[BMLoop, BMLoop, BMLoop]]:
         """Calculate triangle tessellation from quads/ngons.
 
         :return: The triangulated faces.
-        :rtype: list[tuple[BMLoop, BMLoop, BMLoop]]
         """
 
-    def calc_volume(self, signed: bool = False) -> float:
+    def calc_volume(self, *, signed: bool = False) -> float:
         """Calculate mesh volume based on face normals.
 
         :param signed: when signed is true, negative values may be returned.
-        :type signed: bool
         :return: The volume of the mesh.
-        :rtype: float
         """
 
     def clear(self) -> None:
@@ -1616,7 +1202,6 @@ class BMesh:
         """
 
         :return: A copy of this BMesh.
-        :rtype: typing_extensions.Self
         """
 
     def free(self) -> None:
@@ -1625,29 +1210,26 @@ class BMesh:
     def from_mesh(
         self,
         mesh: bpy.types.Mesh,
+        *,
         face_normals: bool = True,
         vertex_normals: bool = True,
         use_shape_key: bool = False,
         shape_key_index: int = 0,
     ) -> None:
-        """Initialize this bmesh from existing mesh datablock.
+        """Initialize this bmesh from existing mesh data-block.
 
         :param mesh: The mesh data to load.
-        :type mesh: bpy.types.Mesh
-        :param face_normals:
-        :type face_normals: bool
-        :param vertex_normals:
-        :type vertex_normals: bool
+        :param face_normals: Calculate face normals.
+        :param vertex_normals: Calculate vertex normals.
         :param use_shape_key: Use the locations from a shape key.
-        :type use_shape_key: bool
         :param shape_key_index: The shape key index to use.
-        :type shape_key_index: int
         """
 
     def from_object(
         self,
         object: bpy.types.Object,
         depsgraph: bpy.types.Depsgraph,
+        *,
         cage: bool = False,
         face_normals: bool = True,
         vertex_normals: bool = True,
@@ -1655,46 +1237,118 @@ class BMesh:
         """Initialize this bmesh from existing object data-block (only meshes are currently supported).
 
         :param object: The object data to load.
-        :type object: bpy.types.Object
-        :param depsgraph:
-        :type depsgraph: bpy.types.Depsgraph
+        :param depsgraph: The dependency graph for evaluated data.
         :param cage: Get the mesh as a deformed cage.
-        :type cage: bool
         :param face_normals: Calculate face normals.
-        :type face_normals: bool
         :param vertex_normals: Calculate vertex normals.
-        :type vertex_normals: bool
         """
 
     def normal_update(self) -> None:
         """Update normals of mesh faces and verts."""
 
     def select_flush(self, select: bool) -> None:
-        """Flush selection, independent of the current selection mode.
+        """Flush selection from vertices, independent of the current selection mode.
 
         :param select: flush selection or de-selected elements.
-        :type select: bool
         """
 
-    def select_flush_mode(self) -> None:
-        """flush selection based on the current mode current `BMesh.select_mode`."""
+    def select_flush_mode(self, *, flush_down: bool = False) -> None:
+        """Flush selection based on the current mode current `bmesh.types.BMesh.select_mode`.
+
+        :param flush_down: Flush selection down from faces to edges & verts or from edges to verts. This option is ignored when vertex selection mode is enabled.
+        """
 
     def to_mesh(self, mesh: bpy.types.Mesh) -> None:
-        """Writes this BMesh data into an existing Mesh datablock.
+        """Writes this BMesh data into an existing Mesh data-block.
 
         :param mesh: The mesh data to write into.
-        :type mesh: bpy.types.Mesh
         """
 
     def transform(
         self,
         matrix: collections.abc.Sequence[collections.abc.Sequence[float]]
         | mathutils.Matrix,
-        filter=None,
+        *,
+        filter: set[typing.Literal["SELECT", "HIDE", "SEAM", "SMOOTH", "TAG"]]
+        | None = None,
     ) -> None:
         """Transform the mesh (optionally filtering flagged data only).
 
-        :param matrix: 4x4x transform matrix.
-        :type matrix: collections.abc.Sequence[collections.abc.Sequence[float]] | mathutils.Matrix
-        :param filter: set of values in ('SELECT', 'HIDE', 'SEAM', 'SMOOTH', 'TAG').
+        :param matrix: 4x4 transform matrix.
+        :param filter: Flag to filter vertices.
+        """
+
+    def uv_select_flush(self, select: bool) -> None:
+        """Flush selection from UV vertices to edges & faces independent of the selection mode.
+
+        :param select: Flush selection or de-selected elements.
+        """
+
+    def uv_select_flush_mode(self, *, flush_down: bool = False) -> None:
+        """Flush selection based on the current mode current `BMesh.select_mode`.
+
+        :param flush_down: Flush selection down from faces to edges & verts or from edges to verts. This option is ignored when vertex selection mode is enabled.
+        """
+
+    def uv_select_flush_shared(self, select: bool) -> None:
+        """Flush selection from UV vertices to contiguous UVs independent of the selection mode.
+
+        :param select: Flush selection or de-selected elements.
         """
+
+    def uv_select_foreach_set(
+        self,
+        select: bool,
+        /,
+        *,
+        loop_verts: collections.abc.Iterable[BMLoop] = (),
+        loop_edges: collections.abc.Iterable[BMLoop] = (),
+        faces: collections.abc.Iterable[BMFace] = (),
+        sticky_select_mode: typing.Literal[
+            "SHARED_LOCATION", "DISABLED", "SHARED_VERTEX"
+        ] = "SHARED_LOCATION",
+    ) -> None:
+        """Set the UV selection state for loop-vertices, loop-edges & faces.This is a close equivalent to selecting in the UV editor.
+
+        :param select: The selection state to set.
+        :param loop_verts: Loop verts to operate on.
+        :param loop_edges: Loop edges to operate on.
+        :param faces: Faces to operate on.
+        :param sticky_select_mode: See UV_STICKY_SELECT_MODE_REF.
+        """
+
+    def uv_select_foreach_set_from_mesh(
+        self,
+        select: bool,
+        /,
+        *,
+        verts: collections.abc.Iterable[BMVert] = (),
+        edges: collections.abc.Iterable[BMEdge] = (),
+        faces: collections.abc.Iterable[BMFace] = (),
+        sticky_select_mode: typing.Literal[
+            "SHARED_LOCATION", "DISABLED", "SHARED_VERTEX"
+        ] = "SHARED_LOCATION",
+    ) -> None:
+        """Select or de-select mesh elements, updating the UV selection.An equivalent to selecting from the 3D viewport for selection operations that support maintaining a synchronized UV selection.
+
+        :param select: The selection state to set.
+        :param verts: Verts to operate on.
+        :param edges: Edges to operate on.
+        :param faces: Faces to operate on.
+        :param sticky_select_mode: See UV_STICKY_SELECT_MODE_REF.
+        """
+
+    def uv_select_sync_from_mesh(
+        self,
+        *,
+        sticky_select_mode: typing.Literal[
+            "SHARED_LOCATION", "DISABLED", "SHARED_VERTEX"
+        ] = "SHARED_LOCATION",
+    ) -> None:
+        """Sync selection from mesh to UVs.
+
+        :param sticky_select_mode: Behavior when flushing from the mesh to UV selection UV_STICKY_SELECT_MODE_REF. This should only be used when preparing to create a UV selection.
+        """
+
+    def uv_select_sync_to_mesh(self) -> None:
+        """Sync selection from UVs to the mesh."""