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

bpy/ops/sculpt/__init__.pyi

@@ -12,17 +12,15 @@ def brush_stroke(
     *,
     stroke: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement]
     | None = None,
-    mode: typing.Literal["NORMAL", "INVERT", "SMOOTH", "ERASE"] | None = "NORMAL",
+    mode: typing.Literal["NORMAL", "INVERT", "SMOOTH", "ERASE", "MASK"]
+    | None = "NORMAL",
     pen_flip: bool | None = False,
     override_location: bool | None = False,
     ignore_background_click: bool | None = False,
 ) -> None:
     """Sculpt a stroke into the geometry
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param stroke: Stroke
-        :type stroke: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement] | None
         :param mode: Stroke Mode, Action taken when a paint stroke is made
 
     NORMAL
@@ -36,13 +34,12 @@ def brush_stroke(
 
     ERASE
     Erase -- Switch brush to erase mode for duration of stroke.
-        :type mode: typing.Literal['NORMAL','INVERT','SMOOTH','ERASE'] | None
-        :param pen_flip: Pen Flip, Whether a tablet's eraser mode is being used
-        :type pen_flip: bool | None
-        :param override_location: Override Location, Override the given location array by recalculating object space positions from the provided mouse_event positions
-        :type override_location: bool | None
+
+    MASK
+    Mask -- Switch brush to mask mode for duration of stroke.
+        :param pen_flip: Pen Flip, Whether a tablets eraser mode is being used
+        :param override_location: Override Location, Override the given "location" array by recalculating object space positions from the provided "mouse_event" positions
         :param ignore_background_click: Ignore Background Click, Clicks on the background do not start the stroke
-        :type ignore_background_click: bool | None
     """
 
 def cloth_filter(
@@ -67,17 +64,10 @@ def cloth_filter(
 ) -> None:
     """Applies a cloth simulation deformation to the entire mesh
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param start_mouse: Starting Mouse
-        :type start_mouse: collections.abc.Iterable[int] | None
         :param area_normal_radius: Normal Radius, Radius used for calculating area normal on initial click,in percentage of brush radius
-        :type area_normal_radius: float | None
         :param strength: Strength, Filter strength
-        :type strength: float | None
         :param iteration_count: Repeat, How many times to repeat the filter
-        :type iteration_count: int | None
-        :type event_history: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement] | None
         :param type: Filter Type, Operation that is going to be applied to the mesh
 
     GRAVITY
@@ -87,14 +77,13 @@ def cloth_filter(
     Inflate -- Inflates the cloth.
 
     EXPAND
-    Expand -- Expands the cloth's dimensions.
+    Expand -- Expands the cloths dimensions.
 
     PINCH
-    Pinch -- Pulls the cloth to the cursor's start position.
+    Pinch -- Pulls the cloth to the cursors start position.
 
     SCALE
     Scale -- Scales the mesh as a soft body using the origin of the object as scale.
-        :type type: typing.Literal['GRAVITY','INFLATE','EXPAND','PINCH','SCALE'] | None
         :param force_axis: Force Axis, Apply the force in the selected axis
 
     X
@@ -105,7 +94,6 @@ def cloth_filter(
 
     Z
     Z -- Apply force in the Z axis.
-        :type force_axis: set[typing.Literal['X','Y','Z']] | None
         :param orientation: Orientation, Orientation of the axis to limit the filter force
 
     LOCAL
@@ -116,15 +104,10 @@ def cloth_filter(
 
     VIEW
     View -- Use the view axis to limit the force and set the gravity direction.
-        :type orientation: typing.Literal['LOCAL','WORLD','VIEW'] | None
         :param cloth_mass: Cloth Mass, Mass of each simulation particle
-        :type cloth_mass: float | None
         :param cloth_damping: Cloth Damping, How much the applied forces are propagated through the cloth
-        :type cloth_damping: float | None
-        :param use_face_sets: Use Face Sets, Apply the filter only to the Face Set under the cursor
-        :type use_face_sets: bool | None
+        :param use_face_sets: Use Face Sets, Apply the filter only to the face set under the cursor
         :param use_collisions: Use Collisions, Collide with other collider objects in the scene
-        :type use_collisions: bool | None
     """
 
 def color_filter(
@@ -159,17 +142,10 @@ def color_filter(
 ) -> None:
     """Applies a filter to modify the active color attribute
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param start_mouse: Starting Mouse
-        :type start_mouse: collections.abc.Iterable[int] | None
         :param area_normal_radius: Normal Radius, Radius used for calculating area normal on initial click,in percentage of brush radius
-        :type area_normal_radius: float | None
         :param strength: Strength, Filter strength
-        :type strength: float | None
         :param iteration_count: Repeat, How many times to repeat the filter
-        :type iteration_count: int | None
-        :type event_history: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement] | None
         :param type: Filter Type
 
     FILL
@@ -201,37 +177,29 @@ def color_filter(
 
     BLUE
     Blue -- Change blue channel.
-        :type type: typing.Literal['FILL','HUE','SATURATION','VALUE','BRIGHTNESS','CONTRAST','SMOOTH','RED','GREEN','BLUE'] | None
         :param fill_color: Fill Color
-        :type fill_color: collections.abc.Sequence[float] | mathutils.Color | None
     """
 
 def detail_flood_fill(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Flood fill the mesh with the selected detail setting
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Flood fill the mesh with the selected detail setting"""
 
 def dynamic_topology_toggle(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Dynamic topology alters the mesh topology while sculpting
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Dynamic topology alters the mesh topology while sculpting"""
 
 def dyntopo_detail_size_edit(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Modify the detail size of dyntopo interactively
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Modify the detail size of dyntopo interactively"""
 
 def expand(
     execution_context: int | str | None = None,
@@ -261,28 +229,16 @@ def expand(
 ) -> None:
     """Generic sculpt expand operator
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param target: Data Target, Data that is going to be modified in the expand operation
-    :type target: typing.Literal['MASK','FACE_SETS','COLOR'] | None
     :param falloff_type: Falloff Type, Initial falloff of the expand operation
-    :type falloff_type: typing.Literal['GEODESIC','TOPOLOGY','TOPOLOGY_DIAGONALS','NORMALS','SPHERICAL','BOUNDARY_TOPOLOGY','BOUNDARY_FACE_SET','ACTIVE_FACE_SET'] | None
     :param invert: Invert, Invert the expand active elements
-    :type invert: bool | None
     :param use_mask_preserve: Preserve Previous, Preserve the previous state of the target data
-    :type use_mask_preserve: bool | None
     :param use_falloff_gradient: Falloff Gradient, Expand Using a linear falloff
-    :type use_falloff_gradient: bool | None
-    :param use_modify_active: Modify Active, Modify the active Face Set instead of creating a new one
-    :type use_modify_active: bool | None
+    :param use_modify_active: Modify Active, Modify the active face set instead of creating a new one
     :param use_reposition_pivot: Reposition Pivot, Reposition the sculpt transform pivot to the boundary of the expand active area
-    :type use_reposition_pivot: bool | None
     :param max_geodesic_move_preview: Max Vertex Count for Geodesic Move Preview, Maximum number of vertices in the mesh for using geodesic falloff when moving the origin of expand. If the total number of vertices is greater than this value, the falloff will be set to spherical when moving
-    :type max_geodesic_move_preview: int | None
     :param use_auto_mask: Auto Create, Fill in mask if nothing is already masked
-    :type use_auto_mask: bool | None
     :param normal_falloff_smooth: Normal Smooth, Blurring steps for normal falloff
-    :type normal_falloff_smooth: int | None
     """
 
 def face_set_box_gesture(
@@ -299,20 +255,12 @@ def face_set_box_gesture(
 ) -> None:
     """Add a face set in a rectangle defined by the cursor
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param xmin: X Min
-    :type xmin: int | None
     :param xmax: X Max
-    :type xmax: int | None
     :param ymin: Y Min
-    :type ymin: int | None
     :param ymax: Y Max
-    :type ymax: int | None
     :param wait_for_input: Wait for Input
-    :type wait_for_input: bool | None
     :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-    :type use_front_faces_only: bool | None
     """
 
 def face_set_change_visibility(
@@ -322,21 +270,18 @@ def face_set_change_visibility(
     *,
     mode: typing.Literal["TOGGLE", "SHOW_ACTIVE", "HIDE_ACTIVE"] | None = "TOGGLE",
 ) -> None:
-    """Change the visibility of the Face Sets of the sculpt
+    """Change the visibility of the face sets of the sculpt
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param mode: Mode
 
     TOGGLE
-    Toggle Visibility -- Hide all Face Sets except for the active one.
+    Toggle Visibility -- Hide all face sets except for the active one.
 
     SHOW_ACTIVE
-    Show Active Face Set -- Show Active Face Set.
+    Show Active Face Set -- Show the active face set.
 
     HIDE_ACTIVE
-    Hide Active Face Sets -- Hide Active Face Sets.
-        :type mode: typing.Literal['TOGGLE','SHOW_ACTIVE','HIDE_ACTIVE'] | None
+    Hide Active Face Set -- Hide the active face set.
     """
 
 def face_set_edit(
@@ -352,33 +297,27 @@ def face_set_edit(
     strength: float | None = 1.0,
     modify_hidden: bool | None = False,
 ) -> None:
-    """Edits the current active Face Set
+    """Edits the current active face set
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param active_face_set: Active Face Set
-        :type active_face_set: int | None
         :param mode: Mode
 
     GROW
-    Grow Face Set -- Grows the Face Sets boundary by one face based on mesh topology.
+    Grow Face Set -- Grows the face set boundary by one face based on mesh topology.
 
     SHRINK
-    Shrink Face Set -- Shrinks the Face Sets boundary by one face based on mesh topology.
+    Shrink Face Set -- Shrinks the face set boundary by one face based on mesh topology.
 
     DELETE_GEOMETRY
-    Delete Geometry -- Deletes the faces that are assigned to the Face Set.
+    Delete Geometry -- Deletes the faces that are assigned to the face set.
 
     FAIR_POSITIONS
-    Fair Positions -- Creates a smooth as possible geometry patch from the Face Set minimizing changes in vertex positions.
+    Fair Positions -- Creates a smooth as possible geometry patch from the face set minimizing changes in vertex positions.
 
     FAIR_TANGENCY
-    Fair Tangency -- Creates a smooth as possible geometry patch from the Face Set minimizing changes in vertex tangents.
-        :type mode: typing.Literal['GROW','SHRINK','DELETE_GEOMETRY','FAIR_POSITIONS','FAIR_TANGENCY'] | None
+    Fair Tangency -- Creates a smooth as possible geometry patch from the face set minimizing changes in vertex tangents.
         :param strength: Strength
-        :type strength: float | None
         :param modify_hidden: Modify Hidden, Apply the edit operation to hidden geometry
-        :type modify_hidden: bool | None
     """
 
 def face_set_extract(
@@ -391,18 +330,12 @@ def face_set_extract(
     apply_shrinkwrap: bool | None = True,
     add_solidify: bool | None = True,
 ) -> None:
-    """Create a new mesh object from the selected Face Set
+    """Create a new mesh object from the selected face set
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param add_boundary_loop: Add Boundary Loop, Add an extra edge loop to better preserve the shape when applying a subdivision surface modifier
-    :type add_boundary_loop: bool | None
     :param smooth_iterations: Smooth Iterations, Smooth iterations applied to the extracted mesh
-    :type smooth_iterations: int | None
     :param apply_shrinkwrap: Project to Sculpt, Project the extracted mesh into the original sculpt
-    :type apply_shrinkwrap: bool | None
     :param add_solidify: Extract as Solid, Extract the mask as a solid object with a solidify modifier
-    :type add_solidify: bool | None
     """
 
 def face_set_lasso_gesture(
@@ -418,18 +351,11 @@ def face_set_lasso_gesture(
 ) -> None:
     """Add a face set in a shape defined by the cursor
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param path: Path
-    :type path: bpy.types.bpy_prop_collection[bpy.types.OperatorMousePath] | None
     :param use_smooth_stroke: Stabilize Stroke, Selection lags behind mouse and follows a smoother path
-    :type use_smooth_stroke: bool | None
     :param smooth_stroke_factor: Smooth Stroke Factor, Higher values gives a smoother stroke
-    :type smooth_stroke_factor: float | None
     :param smooth_stroke_radius: Smooth Stroke Radius, Minimum distance from last point before selection continues
-    :type smooth_stroke_radius: int | None
     :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-    :type use_front_faces_only: bool | None
     """
 
 def face_set_line_gesture(
@@ -448,24 +374,14 @@ def face_set_line_gesture(
 ) -> None:
     """Add a face set to one side of a line defined by the cursor
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param xstart: X Start
-    :type xstart: int | None
     :param xend: X End
-    :type xend: int | None
     :param ystart: Y Start
-    :type ystart: int | None
     :param yend: Y End
-    :type yend: int | None
     :param flip: Flip
-    :type flip: bool | None
     :param cursor: Cursor, Mouse cursor style to use during the modal operator
-    :type cursor: int | None
     :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-    :type use_front_faces_only: bool | None
     :param use_limit_to_segment: Limit to Segment, Apply the gesture action only to the area that is contained within the segment without extending its effect to the entire line
-    :type use_limit_to_segment: bool | None
     """
 
 def face_set_polyline_gesture(
@@ -478,12 +394,8 @@ def face_set_polyline_gesture(
 ) -> None:
     """Add a face set in a shape defined by the cursor
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param path: Path
-    :type path: bpy.types.bpy_prop_collection[bpy.types.OperatorMousePath] | None
     :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-    :type use_front_faces_only: bool | None
     """
 
 def face_sets_create(
@@ -493,24 +405,21 @@ def face_sets_create(
     *,
     mode: typing.Literal["MASKED", "VISIBLE", "ALL", "SELECTION"] | None = "MASKED",
 ) -> None:
-    """Create a new Face Set
+    """Create a new face set
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param mode: Mode
 
     MASKED
-    Face Set from Masked -- Create a new Face Set from the masked faces.
+    Face Set from Masked -- Create a new face set from the masked faces.
 
     VISIBLE
-    Face Set from Visible -- Create a new Face Set from the visible vertices.
+    Face Set from Visible -- Create a new face set from the visible vertices.
 
     ALL
-    Face Set Full Mesh -- Create an unique Face Set with all faces in the sculpt.
+    Face Set Full Mesh -- Create an unique face set with all faces in the sculpt.
 
     SELECTION
-    Face Set from Edit Mode Selection -- Create an Face Set corresponding to the Edit Mode face selection.
-        :type mode: typing.Literal['MASKED','VISIBLE','ALL','SELECTION'] | None
+    Face Set from Edit Mode Selection -- Create an face set corresponding to the Edit Mode face selection.
     """
 
 def face_sets_init(
@@ -531,48 +440,42 @@ def face_sets_init(
     | None = "LOOSE_PARTS",
     threshold: float | None = 0.5,
 ) -> None:
-    """Initializes all Face Sets in the mesh
+    """Initializes all face sets in the mesh
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param mode: Mode
 
     LOOSE_PARTS
-    Face Sets from Loose Parts -- Create a Face Set per loose part in the mesh.
+    Face Sets from Loose Parts -- Create a face set per loose part in the mesh.
 
     MATERIALS
-    Face Sets from Material Slots -- Create a Face Set per Material Slot.
+    Face Sets from Material Slots -- Create a face set per material slot.
 
     NORMALS
-    Face Sets from Mesh Normals -- Create Face Sets for Faces that have similar normal.
+    Face Sets from Mesh Normals -- Create face sets for faces that have similar normal.
 
     UV_SEAMS
-    Face Sets from UV Seams -- Create Face Sets using UV Seams as boundaries.
+    Face Sets from UV Seams -- Create face sets using UV seams as boundaries.
 
     CREASES
-    Face Sets from Edge Creases -- Create Face Sets using Edge Creases as boundaries.
+    Face Sets from Edge Creases -- Create face sets using edge creases as boundaries.
 
     BEVEL_WEIGHT
-    Face Sets from Bevel Weight -- Create Face Sets using Bevel Weights as boundaries.
+    Face Sets from Bevel Weight -- Create face sets using bevel weights as boundaries.
 
     SHARP_EDGES
-    Face Sets from Sharp Edges -- Create Face Sets using Sharp Edges as boundaries.
+    Face Sets from Sharp Edges -- Create face sets using sharp edges as boundaries.
 
     FACE_SET_BOUNDARIES
-    Face Sets from Face Set Boundaries -- Create a Face Set per isolated Face Set.
-        :type mode: typing.Literal['LOOSE_PARTS','MATERIALS','NORMALS','UV_SEAMS','CREASES','BEVEL_WEIGHT','SHARP_EDGES','FACE_SET_BOUNDARIES'] | None
-        :param threshold: Threshold, Minimum value to consider a certain attribute a boundary when creating the Face Sets
-        :type threshold: float | None
+    Face Sets from Face Set Boundaries -- Create a face set per isolated face set.
+        :param threshold: Threshold, Minimum value to consider a certain attribute a boundary when creating the face sets
     """
 
 def face_sets_randomize_colors(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Generates a new set of random colors to render the Face Sets in the viewport
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Generates a new set of random colors to render the face sets in the viewport"""
 
 def mask_by_color(
     execution_context: int | str | None = None,
@@ -587,18 +490,11 @@ def mask_by_color(
 ) -> None:
     """Creates a mask based on the active color attribute
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param contiguous: Contiguous, Mask only contiguous color areas
-    :type contiguous: bool | None
     :param invert: Invert, Invert the generated mask
-    :type invert: bool | None
     :param preserve_previous_mask: Preserve Previous Mask, Preserve the previous mask and add or subtract the new one generated by the colors
-    :type preserve_previous_mask: bool | None
     :param threshold: Threshold, How much changes in color affect the mask generation
-    :type threshold: float | None
     :param location: Location, Region coordinates of sampling
-    :type location: collections.abc.Iterable[int] | None
     """
 
 def mask_filter(
@@ -615,14 +511,9 @@ def mask_filter(
 ) -> None:
     """Applies a filter to modify the current mask
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param filter_type: Type, Filter that is going to be applied to the mask
-    :type filter_type: typing.Literal['SMOOTH','SHARPEN','GROW','SHRINK','CONTRAST_INCREASE','CONTRAST_DECREASE'] | None
     :param iterations: Iterations, Number of times that the filter is going to be applied
-    :type iterations: int | None
     :param auto_iteration_count: Auto Iteration Count, Use an automatic number of iterations based on the number of vertices of the sculpt
-    :type auto_iteration_count: bool | None
     """
 
 def mask_from_boundary(
@@ -639,12 +530,8 @@ def mask_from_boundary(
 ) -> None:
     """Creates a mask based on the boundaries of the surface
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param mix_mode: Mode, Mix mode
-        :type mix_mode: typing.Literal['MIX','MULTIPLY','DIVIDE','ADD','SUBTRACT'] | None
         :param mix_factor: Mix Factor
-        :type mix_factor: float | None
         :param settings_source: Settings, Use settings from here
 
     OPERATOR
@@ -655,7 +542,6 @@ def mask_from_boundary(
 
     SCENE
     Scene -- Use settings from scene.
-        :type settings_source: typing.Literal['OPERATOR','BRUSH','SCENE'] | None
         :param boundary_mode: Mode, Boundary type to mask
 
     MESH
@@ -663,9 +549,7 @@ def mask_from_boundary(
 
     FACE_SETS
     Face Sets -- Calculate the boundary mask between face sets.
-        :type boundary_mode: typing.Literal['MESH','FACE_SETS'] | None
         :param propagation_steps: Propagation Steps
-        :type propagation_steps: int | None
     """
 
 def mask_from_cavity(
@@ -684,12 +568,8 @@ def mask_from_cavity(
 ) -> None:
     """Creates a mask based on the curvature of the surface
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param mix_mode: Mode, Mix mode
-        :type mix_mode: typing.Literal['MIX','MULTIPLY','DIVIDE','ADD','SUBTRACT'] | None
         :param mix_factor: Mix Factor
-        :type mix_factor: float | None
         :param settings_source: Settings, Use settings from here
 
     OPERATOR
@@ -700,15 +580,10 @@ def mask_from_cavity(
 
     SCENE
     Scene -- Use settings from scene.
-        :type settings_source: typing.Literal['OPERATOR','BRUSH','SCENE'] | None
         :param factor: Factor, The contrast of the cavity mask
-        :type factor: float | None
         :param blur_steps: Blur, The number of times the cavity mask is blurred
-        :type blur_steps: int | None
         :param use_curve: Custom Curve
-        :type use_curve: bool | None
         :param invert: Cavity (Inverted)
-        :type invert: bool | None
     """
 
 def mask_init(
@@ -723,10 +598,7 @@ def mask_init(
 ) -> None:
     """Creates a new mask for the entire mesh
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param mode: Mode
-    :type mode: typing.Literal['RANDOM_PER_VERTEX','RANDOM_PER_FACE_SET','RANDOM_PER_LOOSE_PART'] | None
     """
 
 def mesh_filter(
@@ -764,17 +636,10 @@ def mesh_filter(
 ) -> None:
     """Applies a filter to modify the current mesh
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param start_mouse: Starting Mouse
-        :type start_mouse: collections.abc.Iterable[int] | None
         :param area_normal_radius: Normal Radius, Radius used for calculating area normal on initial click,in percentage of brush radius
-        :type area_normal_radius: float | None
         :param strength: Strength, Filter strength
-        :type strength: float | None
         :param iteration_count: Repeat, How many times to repeat the filter
-        :type iteration_count: int | None
-        :type event_history: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement] | None
         :param type: Filter Type, Operation that is going to be applied to the mesh
 
     SMOOTH
@@ -796,7 +661,7 @@ def mesh_filter(
     Relax -- Relax mesh.
 
     RELAX_FACE_SETS
-    Relax Face Sets -- Smooth the edges of all the Face Sets.
+    Relax Face Sets -- Smooth the edges of all the face sets.
 
     SURFACE_SMOOTH
     Surface Smooth -- Smooth the surface of the mesh, preserving the volume.
@@ -809,7 +674,6 @@ def mesh_filter(
 
     ERASE_DISPLACEMENT
     Erase Displacement -- Deletes the displacement of the Multires Modifier.
-        :type type: typing.Literal['SMOOTH','SCALE','INFLATE','SPHERE','RANDOM','RELAX','RELAX_FACE_SETS','SURFACE_SMOOTH','SHARPEN','ENHANCE_DETAILS','ERASE_DISPLACEMENT'] | None
         :param deform_axis: Deform Axis, Apply the deformation in the selected axis
 
     X
@@ -820,7 +684,6 @@ def mesh_filter(
 
     Z
     Z -- Deform in the Z axis.
-        :type deform_axis: set[typing.Literal['X','Y','Z']] | None
         :param orientation: Orientation, Orientation of the axis to limit the filter displacement
 
     LOCAL
@@ -831,27 +694,19 @@ def mesh_filter(
 
     VIEW
     View -- Use the view axis to limit the displacement.
-        :type orientation: typing.Literal['LOCAL','WORLD','VIEW'] | None
         :param surface_smooth_shape_preservation: Shape Preservation, How much of the original shape is preserved when smoothing
-        :type surface_smooth_shape_preservation: float | None
         :param surface_smooth_current_vertex: Per Vertex Displacement, How much the position of each individual vertex influences the final result
-        :type surface_smooth_current_vertex: float | None
         :param sharpen_smooth_ratio: Smooth Ratio, How much smoothing is applied to polished surfaces
-        :type sharpen_smooth_ratio: float | None
         :param sharpen_intensify_detail_strength: Intensify Details, How much creases and valleys are intensified
-        :type sharpen_intensify_detail_strength: float | None
         :param sharpen_curvature_smooth_iterations: Curvature Smooth Iterations, How much smooth the resulting shape is, ignoring high frequency details
-        :type sharpen_curvature_smooth_iterations: int | None
     """
 
 def optimize(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Recalculate the sculpt BVH to improve performance
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Recalculate the sculpt BVH to improve performance"""
 
 def paint_mask_extract(
     execution_context: int | str | None = None,
@@ -866,18 +721,11 @@ def paint_mask_extract(
 ) -> None:
     """Create a new mesh object from the current paint mask
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param mask_threshold: Threshold, Minimum mask value to consider the vertex valid to extract a face from the original mesh
-    :type mask_threshold: float | None
     :param add_boundary_loop: Add Boundary Loop, Add an extra edge loop to better preserve the shape when applying a subdivision surface modifier
-    :type add_boundary_loop: bool | None
     :param smooth_iterations: Smooth Iterations, Smooth iterations applied to the extracted mesh
-    :type smooth_iterations: int | None
     :param apply_shrinkwrap: Project to Sculpt, Project the extracted mesh into the original sculpt
-    :type apply_shrinkwrap: bool | None
     :param add_solidify: Extract as Solid, Extract the mask as a solid object with a solidify modifier
-    :type add_solidify: bool | None
     """
 
 def paint_mask_slice(
@@ -891,14 +739,9 @@ def paint_mask_slice(
 ) -> None:
     """Slices the paint mask from the mesh
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param mask_threshold: Threshold, Minimum mask value to consider the vertex valid to extract a face from the original mesh
-    :type mask_threshold: float | None
     :param fill_holes: Fill Holes, Fill holes after slicing the mask
-    :type fill_holes: bool | None
     :param new_object: Slice to New Object, Create a new object from the sliced mask
-    :type new_object: bool | None
     """
 
 def project_line_gesture(
@@ -917,33 +760,14 @@ def project_line_gesture(
 ) -> None:
     """Project the geometry onto a plane defined by a line
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param xstart: X Start
-    :type xstart: int | None
     :param xend: X End
-    :type xend: int | None
     :param ystart: Y Start
-    :type ystart: int | None
     :param yend: Y End
-    :type yend: int | None
     :param flip: Flip
-    :type flip: bool | None
     :param cursor: Cursor, Mouse cursor style to use during the modal operator
-    :type cursor: int | None
     :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-    :type use_front_faces_only: bool | None
     :param use_limit_to_segment: Limit to Segment, Apply the gesture action only to the area that is contained within the segment without extending its effect to the entire line
-    :type use_limit_to_segment: bool | None
-    """
-
-def sample_color(
-    execution_context: int | str | None = None, undo: bool | None = None
-) -> None:
-    """Sample the vertex color of the active vertex
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
     """
 
 def sample_detail_size(
@@ -956,10 +780,7 @@ def sample_detail_size(
 ) -> None:
     """Sample the mesh detail on clicked point
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param location: Location, Screen coordinates of sampling
-        :type location: collections.abc.Iterable[int] | None
         :param mode: Detail Mode, Target sculpting workflow that is going to use the sampled size
 
     DYNTOPO
@@ -967,26 +788,21 @@ def sample_detail_size(
 
     VOXEL
     Voxel -- Sample mesh voxel size.
-        :type mode: typing.Literal['DYNTOPO','VOXEL'] | None
     """
 
 def sculptmode_toggle(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Toggle sculpt mode in 3D view
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Toggle sculpt mode in 3D view"""
 
 def set_persistent_base(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Reset the copy of the mesh that is being sculpted on
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Reset the copy of the mesh that is being sculpted on"""
 
 def set_pivot_position(
     execution_context: int | str | None = None,
@@ -1000,8 +816,6 @@ def set_pivot_position(
 ) -> None:
     """Sets the sculpt transform pivot position
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param mode: Mode
 
     ORIGIN
@@ -1018,11 +832,8 @@ def set_pivot_position(
 
     SURFACE
     Surface -- Sets the pivot position to the surface under the cursor.
-        :type mode: typing.Literal['ORIGIN','UNMASKED','BORDER','ACTIVE','SURFACE'] | None
-        :param mouse_x: Mouse Position X, Position of the mouse used for "Surface" mode
-        :type mouse_x: float | None
-        :param mouse_y: Mouse Position Y, Position of the mouse used for "Surface" mode
-        :type mouse_y: float | None
+        :param mouse_x: Mouse Position X, Position of the mouse used for "Surface" and "Active Vertex" mode
+        :param mouse_y: Mouse Position Y, Position of the mouse used for "Surface" and "Active Vertex" mode
     """
 
 def symmetrize(
@@ -1034,10 +845,7 @@ def symmetrize(
 ) -> None:
     """Symmetrize the topology modifications
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param merge_tolerance: Merge Distance, Distance within which symmetrical vertices are merged
-    :type merge_tolerance: float | None
     """
 
 def trim_box_gesture(
@@ -1060,22 +868,13 @@ def trim_box_gesture(
 ) -> None:
     """Execute a boolean operation on the mesh and a rectangle defined by the cursor
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param xmin: X Min
-        :type xmin: int | None
         :param xmax: X Max
-        :type xmax: int | None
         :param ymin: Y Min
-        :type ymin: int | None
         :param ymax: Y Max
-        :type ymax: int | None
         :param wait_for_input: Wait for Input
-        :type wait_for_input: bool | None
         :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-        :type use_front_faces_only: bool | None
         :param location: Location, Mouse location
-        :type location: collections.abc.Iterable[int] | None
         :param trim_mode: Trim Mode
 
     DIFFERENCE
@@ -1086,9 +885,7 @@ def trim_box_gesture(
 
     JOIN
     Join -- Join the new mesh as separate geometry, without performing any boolean operation.
-        :type trim_mode: typing.Literal['DIFFERENCE','UNION','JOIN'] | None
         :param use_cursor_depth: Use Cursor for Depth, Use cursor location and radius for the dimensions and position of the trimming shape
-        :type use_cursor_depth: bool | None
         :param trim_orientation: Shape Orientation
 
     VIEW
@@ -1096,7 +893,6 @@ def trim_box_gesture(
 
     SURFACE
     Surface -- Use the surface normal to orientate the trimming shape.
-        :type trim_orientation: typing.Literal['VIEW','SURFACE'] | None
         :param trim_extrude_mode: Extrude Mode
 
     PROJECT
@@ -1104,7 +900,6 @@ def trim_box_gesture(
 
     FIXED
     Fixed -- Align trim geometry orthogonally for a shape with 90 degree angles.
-        :type trim_extrude_mode: typing.Literal['PROJECT','FIXED'] | None
         :param trim_solver: Solver
 
     EXACT
@@ -1115,7 +910,6 @@ def trim_box_gesture(
 
     MANIFOLD
     Manifold -- Fastest solver that works only on manifold meshes but gives better results.
-        :type trim_solver: typing.Literal['EXACT','FLOAT','MANIFOLD'] | None
     """
 
 def trim_lasso_gesture(
@@ -1137,20 +931,12 @@ def trim_lasso_gesture(
 ) -> None:
     """Execute a boolean operation on the mesh and a shape defined by the cursor
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param path: Path
-        :type path: bpy.types.bpy_prop_collection[bpy.types.OperatorMousePath] | None
         :param use_smooth_stroke: Stabilize Stroke, Selection lags behind mouse and follows a smoother path
-        :type use_smooth_stroke: bool | None
         :param smooth_stroke_factor: Smooth Stroke Factor, Higher values gives a smoother stroke
-        :type smooth_stroke_factor: float | None
         :param smooth_stroke_radius: Smooth Stroke Radius, Minimum distance from last point before selection continues
-        :type smooth_stroke_radius: int | None
         :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-        :type use_front_faces_only: bool | None
         :param location: Location, Mouse location
-        :type location: collections.abc.Iterable[int] | None
         :param trim_mode: Trim Mode
 
     DIFFERENCE
@@ -1161,9 +947,7 @@ def trim_lasso_gesture(
 
     JOIN
     Join -- Join the new mesh as separate geometry, without performing any boolean operation.
-        :type trim_mode: typing.Literal['DIFFERENCE','UNION','JOIN'] | None
         :param use_cursor_depth: Use Cursor for Depth, Use cursor location and radius for the dimensions and position of the trimming shape
-        :type use_cursor_depth: bool | None
         :param trim_orientation: Shape Orientation
 
     VIEW
@@ -1171,7 +955,6 @@ def trim_lasso_gesture(
 
     SURFACE
     Surface -- Use the surface normal to orientate the trimming shape.
-        :type trim_orientation: typing.Literal['VIEW','SURFACE'] | None
         :param trim_extrude_mode: Extrude Mode
 
     PROJECT
@@ -1179,7 +962,6 @@ def trim_lasso_gesture(
 
     FIXED
     Fixed -- Align trim geometry orthogonally for a shape with 90 degree angles.
-        :type trim_extrude_mode: typing.Literal['PROJECT','FIXED'] | None
         :param trim_solver: Solver
 
     EXACT
@@ -1190,7 +972,6 @@ def trim_lasso_gesture(
 
     MANIFOLD
     Manifold -- Fastest solver that works only on manifold meshes but gives better results.
-        :type trim_solver: typing.Literal['EXACT','FLOAT','MANIFOLD'] | None
     """
 
 def trim_line_gesture(
@@ -1215,26 +996,15 @@ def trim_line_gesture(
 ) -> None:
     """Remove a portion of the mesh on one side of a line
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param xstart: X Start
-        :type xstart: int | None
         :param xend: X End
-        :type xend: int | None
         :param ystart: Y Start
-        :type ystart: int | None
         :param yend: Y End
-        :type yend: int | None
         :param flip: Flip
-        :type flip: bool | None
         :param cursor: Cursor, Mouse cursor style to use during the modal operator
-        :type cursor: int | None
         :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-        :type use_front_faces_only: bool | None
         :param use_limit_to_segment: Limit to Segment, Apply the gesture action only to the area that is contained within the segment without extending its effect to the entire line
-        :type use_limit_to_segment: bool | None
         :param location: Location, Mouse location
-        :type location: collections.abc.Iterable[int] | None
         :param trim_mode: Trim Mode
 
     DIFFERENCE
@@ -1245,9 +1015,7 @@ def trim_line_gesture(
 
     JOIN
     Join -- Join the new mesh as separate geometry, without performing any boolean operation.
-        :type trim_mode: typing.Literal['DIFFERENCE','UNION','JOIN'] | None
         :param use_cursor_depth: Use Cursor for Depth, Use cursor location and radius for the dimensions and position of the trimming shape
-        :type use_cursor_depth: bool | None
         :param trim_orientation: Shape Orientation
 
     VIEW
@@ -1255,7 +1023,6 @@ def trim_line_gesture(
 
     SURFACE
     Surface -- Use the surface normal to orientate the trimming shape.
-        :type trim_orientation: typing.Literal['VIEW','SURFACE'] | None
         :param trim_extrude_mode: Extrude Mode
 
     PROJECT
@@ -1263,7 +1030,6 @@ def trim_line_gesture(
 
     FIXED
     Fixed -- Align trim geometry orthogonally for a shape with 90 degree angles.
-        :type trim_extrude_mode: typing.Literal['PROJECT','FIXED'] | None
         :param trim_solver: Solver
 
     EXACT
@@ -1274,7 +1040,6 @@ def trim_line_gesture(
 
     MANIFOLD
     Manifold -- Fastest solver that works only on manifold meshes but gives better results.
-        :type trim_solver: typing.Literal['EXACT','FLOAT','MANIFOLD'] | None
     """
 
 def trim_polyline_gesture(
@@ -1293,14 +1058,9 @@ def trim_polyline_gesture(
 ) -> None:
     """Execute a boolean operation on the mesh and a polygonal shape defined by the cursor
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param path: Path
-        :type path: bpy.types.bpy_prop_collection[bpy.types.OperatorMousePath] | None
         :param use_front_faces_only: Front Faces Only, Affect only faces facing towards the view
-        :type use_front_faces_only: bool | None
         :param location: Location, Mouse location
-        :type location: collections.abc.Iterable[int] | None
         :param trim_mode: Trim Mode
 
     DIFFERENCE
@@ -1311,9 +1071,7 @@ def trim_polyline_gesture(
 
     JOIN
     Join -- Join the new mesh as separate geometry, without performing any boolean operation.
-        :type trim_mode: typing.Literal['DIFFERENCE','UNION','JOIN'] | None
         :param use_cursor_depth: Use Cursor for Depth, Use cursor location and radius for the dimensions and position of the trimming shape
-        :type use_cursor_depth: bool | None
         :param trim_orientation: Shape Orientation
 
     VIEW
@@ -1321,7 +1079,6 @@ def trim_polyline_gesture(
 
     SURFACE
     Surface -- Use the surface normal to orientate the trimming shape.
-        :type trim_orientation: typing.Literal['VIEW','SURFACE'] | None
         :param trim_extrude_mode: Extrude Mode
 
     PROJECT
@@ -1329,7 +1086,6 @@ def trim_polyline_gesture(
 
     FIXED
     Fixed -- Align trim geometry orthogonally for a shape with 90 degree angles.
-        :type trim_extrude_mode: typing.Literal['PROJECT','FIXED'] | None
         :param trim_solver: Solver
 
     EXACT
@@ -1340,7 +1096,6 @@ def trim_polyline_gesture(
 
     MANIFOLD
     Manifold -- Fastest solver that works only on manifold meshes but gives better results.
-        :type trim_solver: typing.Literal['EXACT','FLOAT','MANIFOLD'] | None
     """
 
 def uv_sculpt_grab(
@@ -1352,10 +1107,7 @@ def uv_sculpt_grab(
 ) -> None:
     """Grab UVs
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param use_invert: Invert, Invert action for the duration of the stroke
-    :type use_invert: bool | None
     """
 
 def uv_sculpt_pinch(
@@ -1367,10 +1119,7 @@ def uv_sculpt_pinch(
 ) -> None:
     """Pinch UVs
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param use_invert: Invert, Invert action for the duration of the stroke
-    :type use_invert: bool | None
     """
 
 def uv_sculpt_relax(
@@ -1379,14 +1128,11 @@ def uv_sculpt_relax(
     /,
     *,
     use_invert: bool | None = False,
-    relax_method: typing.Literal["LAPLACIAN", "HC", "COTAN"] | None = "COTAN",
+    relax_method: typing.Literal["LAPLACIAN", "HC", "COTAN"] | None = "LAPLACIAN",
 ) -> None:
     """Relax UVs
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param use_invert: Invert, Invert action for the duration of the stroke
-        :type use_invert: bool | None
         :param relax_method: Relax Method, Algorithm used for UV relaxation
 
     LAPLACIAN
@@ -1397,5 +1143,4 @@ def uv_sculpt_relax(
 
     COTAN
     Geometry -- Use Geometry (cotangent) relaxation, making UVs follow the underlying 3D geometry.
-        :type relax_method: typing.Literal['LAPLACIAN','HC','COTAN'] | None
     """