fake-bpy-module 20240802__py3-none-any.whl → 20240804__py3-none-any.whl

bpy/ops/sculpt/__init__.pyi

@@ -14,7 +14,7 @@ def brush_stroke(
     *,
     stroke: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement]
     | None = None,
-    mode: str | None = "NORMAL",
+    mode: typing.Literal["NORMAL", "INVERT", "SMOOTH", "ERASE"] | None = "NORMAL",
     ignore_background_click: bool | None = False,
 ):
     """Sculpt a stroke into the geometry
@@ -37,7 +37,7 @@ def brush_stroke(
 
     ERASE
     Erase -- Switch brush to erase mode for duration of stroke.
-        :type mode: str | None
+        :type mode: typing.Literal['NORMAL','INVERT','SMOOTH','ERASE'] | None
         :param ignore_background_click: Ignore Background Click, Clicks on the background do not start the stroke
         :type ignore_background_click: bool | None
     """
@@ -55,9 +55,10 @@ def cloth_filter(
     iteration_count: int | None = 1,
     event_history: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement]
     | None = None,
-    type: str | None = "GRAVITY",
-    force_axis: set[str] | None = {"X", "Y", "Z"},
-    orientation: str | None = "LOCAL",
+    type: typing.Literal["GRAVITY", "INFLATE", "EXPAND", "PINCH", "SCALE"]
+    | None = "GRAVITY",
+    force_axis: set[typing.Literal["X", "Y", "Z"]] | None = {"X", "Y", "Z"},
+    orientation: typing.Literal["LOCAL", "WORLD", "VIEW"] | None = "LOCAL",
     cloth_mass: float | None = 1.0,
     cloth_damping: float | None = 0.0,
     use_face_sets: bool | None = False,
@@ -93,7 +94,7 @@ def cloth_filter(
 
     SCALE
     Scale -- Scales the mesh as a soft body using the origin of the object as scale.
-        :type type: str | None
+        :type type: typing.Literal['GRAVITY','INFLATE','EXPAND','PINCH','SCALE'] | None
         :param force_axis: Force Axis, Apply the force in the selected axis
 
     X
@@ -104,7 +105,7 @@ def cloth_filter(
 
     Z
     Z -- Apply force in the Z axis.
-        :type force_axis: set[str] | None
+        :type force_axis: set[typing.Literal['X','Y','Z']] | None
         :param orientation: Orientation, Orientation of the axis to limit the filter force
 
     LOCAL
@@ -115,7 +116,7 @@ def cloth_filter(
 
     VIEW
     View -- Use the view axis to limit the force and set the gravity direction.
-        :type orientation: str | None
+        :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
@@ -139,7 +140,19 @@ def color_filter(
     iteration_count: int | None = 1,
     event_history: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement]
     | None = None,
-    type: str | None = "FILL",
+    type: typing.Literal[
+        "FILL",
+        "HUE",
+        "SATURATION",
+        "VALUE",
+        "BRIGHTNESS",
+        "CONTRAST",
+        "SMOOTH",
+        "RED",
+        "GREEN",
+        "BLUE",
+    ]
+    | None = "FILL",
     fill_color: collections.abc.Sequence[float] | mathutils.Color | None = (
         1.0,
         1.0,
@@ -191,7 +204,7 @@ def color_filter(
 
     BLUE
     Blue -- Change blue channel.
-        :type type: str | None
+        :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
     """
@@ -245,8 +258,18 @@ def expand(
     execution_context: int | str | None = None,
     undo: bool | None = None,
     *,
-    target: str | None = "MASK",
-    falloff_type: str | None = "GEODESIC",
+    target: typing.Literal["MASK", "FACE_SETS", "COLOR"] | None = "MASK",
+    falloff_type: typing.Literal[
+        "GEODESIC",
+        "TOPOLOGY",
+        "TOPOLOGY_DIAGONALS",
+        "NORMALS",
+        "SPHERICAL",
+        "BOUNDARY_TOPOLOGY",
+        "BOUNDARY_FACE_SET",
+        "ACTIVE_FACE_SET",
+    ]
+    | None = "GEODESIC",
     invert: bool | None = False,
     use_mask_preserve: bool | None = False,
     use_falloff_gradient: bool | None = False,
@@ -262,9 +285,9 @@ def expand(
     :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: str | None
+    :type target: typing.Literal['MASK','FACE_SETS','COLOR'] | None
     :param falloff_type: Falloff Type, Initial falloff of the expand operation
-    :type falloff_type: str | None
+    :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
@@ -323,7 +346,7 @@ def face_set_change_visibility(
     execution_context: int | str | None = None,
     undo: bool | None = None,
     *,
-    mode: str | None = "TOGGLE",
+    mode: typing.Literal["TOGGLE", "SHOW_ACTIVE", "HIDE_ACTIVE"] | None = "TOGGLE",
 ):
     """Change the visibility of the Face Sets of the sculpt
 
@@ -340,7 +363,7 @@ def face_set_change_visibility(
 
     HIDE_ACTIVE
     Hide Active Face Sets -- Hide Active Face Sets.
-        :type mode: str | None
+        :type mode: typing.Literal['TOGGLE','SHOW_ACTIVE','HIDE_ACTIVE'] | None
     """
 
     ...
@@ -351,7 +374,10 @@ def face_set_edit(
     undo: bool | None = None,
     *,
     active_face_set: int | None = 1,
-    mode: str | None = "GROW",
+    mode: typing.Literal[
+        "GROW", "SHRINK", "DELETE_GEOMETRY", "FAIR_POSITIONS", "FAIR_TANGENCY"
+    ]
+    | None = "GROW",
     strength: float | None = 1.0,
     modify_hidden: bool | None = False,
 ):
@@ -378,7 +404,7 @@ def face_set_edit(
 
     FAIR_TANGENCY
     Fair Tangency -- Creates a smooth as possible geometry patch from the Face Set minimizing changes in vertex tangents.
-        :type mode: str | None
+        :type mode: typing.Literal['GROW','SHRINK','DELETE_GEOMETRY','FAIR_POSITIONS','FAIR_TANGENCY'] | None
         :param strength: Strength
         :type strength: float | None
         :param modify_hidden: Modify Hidden, Apply the edit operation to hidden geometry
@@ -482,7 +508,7 @@ def face_sets_create(
     execution_context: int | str | None = None,
     undo: bool | None = None,
     *,
-    mode: str | None = "MASKED",
+    mode: typing.Literal["MASKED", "VISIBLE", "ALL", "SELECTION"] | None = "MASKED",
 ):
     """Create a new Face Set
 
@@ -502,7 +528,7 @@ def face_sets_create(
 
     SELECTION
     Face Set from Edit Mode Selection -- Create an Face Set corresponding to the Edit Mode face selection.
-        :type mode: str | None
+        :type mode: typing.Literal['MASKED','VISIBLE','ALL','SELECTION'] | None
     """
 
     ...
@@ -512,7 +538,17 @@ def face_sets_init(
     execution_context: int | str | None = None,
     undo: bool | None = None,
     *,
-    mode: str | None = "LOOSE_PARTS",
+    mode: typing.Literal[
+        "LOOSE_PARTS",
+        "MATERIALS",
+        "NORMALS",
+        "UV_SEAMS",
+        "CREASES",
+        "BEVEL_WEIGHT",
+        "SHARP_EDGES",
+        "FACE_SET_BOUNDARIES",
+    ]
+    | None = "LOOSE_PARTS",
     threshold: float | None = 0.5,
 ):
     """Initializes all Face Sets in the mesh
@@ -545,7 +581,7 @@ def face_sets_init(
 
     FACE_SET_BOUNDARIES
     Face Sets from Face Set Boundaries -- Create a Face Set per isolated Face Set.
-        :type mode: str | None
+        :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
     """
@@ -598,7 +634,10 @@ def mask_filter(
     execution_context: int | str | None = None,
     undo: bool | None = None,
     *,
-    filter_type: str | None = "SMOOTH",
+    filter_type: typing.Literal[
+        "SMOOTH", "SHARPEN", "GROW", "SHRINK", "CONTRAST_INCREASE", "CONTRAST_DECREASE"
+    ]
+    | None = "SMOOTH",
     iterations: int | None = 1,
     auto_iteration_count: bool | None = True,
 ):
@@ -608,7 +647,7 @@ def mask_filter(
     :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: str | None
+    :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
@@ -622,9 +661,10 @@ def mask_from_cavity(
     execution_context: int | str | None = None,
     undo: bool | None = None,
     *,
-    mix_mode: str | None = "MIX",
+    mix_mode: typing.Literal["MIX", "MULTIPLY", "DIVIDE", "ADD", "SUBTRACT"]
+    | None = "MIX",
     mix_factor: float | None = 1.0,
-    settings_source: str | None = "OPERATOR",
+    settings_source: typing.Literal["OPERATOR", "BRUSH", "SCENE"] | None = "OPERATOR",
     factor: float | None = 0.5,
     blur_steps: int | None = 2,
     use_curve: bool | None = False,
@@ -636,7 +676,7 @@ def mask_from_cavity(
         :type execution_context: int | str | None
         :type undo: bool | None
         :param mix_mode: Mode, Mix mode
-        :type mix_mode: str | None
+        :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
@@ -649,7 +689,7 @@ def mask_from_cavity(
 
     SCENE
     Scene -- Use settings from scene.
-        :type settings_source: str | None
+        :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
@@ -667,7 +707,10 @@ def mask_init(
     execution_context: int | str | None = None,
     undo: bool | None = None,
     *,
-    mode: str | None = "RANDOM_PER_VERTEX",
+    mode: typing.Literal[
+        "RANDOM_PER_VERTEX", "RANDOM_PER_FACE_SET", "RANDOM_PER_LOOSE_PART"
+    ]
+    | None = "RANDOM_PER_VERTEX",
 ):
     """Creates a new mask for the entire mesh
 
@@ -675,7 +718,7 @@ def mask_init(
     :type execution_context: int | str | None
     :type undo: bool | None
     :param mode: Mode
-    :type mode: str | None
+    :type mode: typing.Literal['RANDOM_PER_VERTEX','RANDOM_PER_FACE_SET','RANDOM_PER_LOOSE_PART'] | None
     """
 
     ...
@@ -691,9 +734,22 @@ def mesh_filter(
     iteration_count: int | None = 1,
     event_history: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement]
     | None = None,
-    type: str | None = "INFLATE",
-    deform_axis: set[str] | None = {"X", "Y", "Z"},
-    orientation: str | None = "LOCAL",
+    type: typing.Literal[
+        "SMOOTH",
+        "SCALE",
+        "INFLATE",
+        "SPHERE",
+        "RANDOM",
+        "RELAX",
+        "RELAX_FACE_SETS",
+        "SURFACE_SMOOTH",
+        "SHARPEN",
+        "ENHANCE_DETAILS",
+        "ERASE_DISCPLACEMENT",
+    ]
+    | None = "INFLATE",
+    deform_axis: set[typing.Literal["X", "Y", "Z"]] | None = {"X", "Y", "Z"},
+    orientation: typing.Literal["LOCAL", "WORLD", "VIEW"] | None = "LOCAL",
     surface_smooth_shape_preservation: float | None = 0.5,
     surface_smooth_current_vertex: float | None = 0.5,
     sharpen_smooth_ratio: float | None = 0.35,
@@ -748,7 +804,7 @@ def mesh_filter(
 
     ERASE_DISCPLACEMENT
     Erase Displacement -- Deletes the displacement of the Multires Modifier.
-        :type type: str | None
+        :type type: typing.Literal['SMOOTH','SCALE','INFLATE','SPHERE','RANDOM','RELAX','RELAX_FACE_SETS','SURFACE_SMOOTH','SHARPEN','ENHANCE_DETAILS','ERASE_DISCPLACEMENT'] | None
         :param deform_axis: Deform Axis, Apply the deformation in the selected axis
 
     X
@@ -759,7 +815,7 @@ def mesh_filter(
 
     Z
     Z -- Deform in the Z axis.
-        :type deform_axis: set[str] | None
+        :type deform_axis: set[typing.Literal['X','Y','Z']] | None
         :param orientation: Orientation, Orientation of the axis to limit the filter displacement
 
     LOCAL
@@ -770,7 +826,7 @@ def mesh_filter(
 
     VIEW
     View -- Use the view axis to limit the displacement.
-        :type orientation: str | None
+        :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
@@ -858,7 +914,7 @@ def sample_detail_size(
     undo: bool | None = None,
     *,
     location: collections.abc.Iterable[int] | None = (0, 0),
-    mode: str | None = "DYNTOPO",
+    mode: typing.Literal["DYNTOPO", "VOXEL"] | None = "DYNTOPO",
 ):
     """Sample the mesh detail on clicked point
 
@@ -874,7 +930,7 @@ def sample_detail_size(
 
     VOXEL
     Voxel -- Sample mesh voxel size.
-        :type mode: str | None
+        :type mode: typing.Literal['DYNTOPO','VOXEL'] | None
     """
 
     ...
@@ -912,7 +968,8 @@ def set_pivot_position(
     execution_context: int | str | None = None,
     undo: bool | None = None,
     *,
-    mode: str | None = "UNMASKED",
+    mode: typing.Literal["ORIGIN", "UNMASKED", "BORDER", "ACTIVE", "SURFACE"]
+    | None = "UNMASKED",
     mouse_x: float | None = 0.0,
     mouse_y: float | None = 0.0,
 ):
@@ -937,7 +994,7 @@ def set_pivot_position(
 
     SURFACE
     Surface -- Sets the pivot position to the surface under the cursor.
-        :type mode: str | None
+        :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
@@ -976,11 +1033,11 @@ def trim_box_gesture(
     wait_for_input: bool | None = True,
     use_front_faces_only: bool | None = False,
     location: collections.abc.Iterable[int] | None = (0, 0),
-    trim_mode: str | None = "DIFFERENCE",
+    trim_mode: typing.Literal["DIFFERENCE", "UNION", "JOIN"] | None = "DIFFERENCE",
     use_cursor_depth: bool | None = False,
-    trim_orientation: str | None = "VIEW",
-    trim_extrude_mode: str | None = "FIXED",
-    trim_solver: str | None = "FAST",
+    trim_orientation: typing.Literal["VIEW", "SURFACE"] | None = "VIEW",
+    trim_extrude_mode: typing.Literal["PROJECT", "FIXED"] | None = "FIXED",
+    trim_solver: typing.Literal["EXACT", "FAST"] | None = "FAST",
 ):
     """Execute a boolean operation on the mesh and a rectangle defined by the cursor
 
@@ -1011,7 +1068,7 @@ def trim_box_gesture(
 
     JOIN
     Join -- Join the new mesh as separate geometry, without performing any boolean operation.
-        :type trim_mode: str | None
+        :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
@@ -1021,7 +1078,7 @@ def trim_box_gesture(
 
     SURFACE
     Surface -- Use the surface normal to orientate the trimming shape.
-        :type trim_orientation: str | None
+        :type trim_orientation: typing.Literal['VIEW','SURFACE'] | None
         :param trim_extrude_mode: Extrude Mode
 
     PROJECT
@@ -1029,7 +1086,7 @@ def trim_box_gesture(
 
     FIXED
     Fixed -- Align trim geometry orthogonally for a shape with 90 degree angles.
-        :type trim_extrude_mode: str | None
+        :type trim_extrude_mode: typing.Literal['PROJECT','FIXED'] | None
         :param trim_solver: Solver
 
     EXACT
@@ -1037,7 +1094,7 @@ def trim_box_gesture(
 
     FAST
     Fast -- Use the fast float boolean solver.
-        :type trim_solver: str | None
+        :type trim_solver: typing.Literal['EXACT','FAST'] | None
     """
 
     ...
@@ -1053,11 +1110,11 @@ def trim_lasso_gesture(
     smooth_stroke_radius: int | None = 35,
     use_front_faces_only: bool | None = False,
     location: collections.abc.Iterable[int] | None = (0, 0),
-    trim_mode: str | None = "DIFFERENCE",
+    trim_mode: typing.Literal["DIFFERENCE", "UNION", "JOIN"] | None = "DIFFERENCE",
     use_cursor_depth: bool | None = False,
-    trim_orientation: str | None = "VIEW",
-    trim_extrude_mode: str | None = "FIXED",
-    trim_solver: str | None = "FAST",
+    trim_orientation: typing.Literal["VIEW", "SURFACE"] | None = "VIEW",
+    trim_extrude_mode: typing.Literal["PROJECT", "FIXED"] | None = "FIXED",
+    trim_solver: typing.Literal["EXACT", "FAST"] | None = "FAST",
 ):
     """Execute a boolean operation on the mesh and a shape defined by the cursor
 
@@ -1086,7 +1143,7 @@ def trim_lasso_gesture(
 
     JOIN
     Join -- Join the new mesh as separate geometry, without performing any boolean operation.
-        :type trim_mode: str | None
+        :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
@@ -1096,7 +1153,7 @@ def trim_lasso_gesture(
 
     SURFACE
     Surface -- Use the surface normal to orientate the trimming shape.
-        :type trim_orientation: str | None
+        :type trim_orientation: typing.Literal['VIEW','SURFACE'] | None
         :param trim_extrude_mode: Extrude Mode
 
     PROJECT
@@ -1104,7 +1161,7 @@ def trim_lasso_gesture(
 
     FIXED
     Fixed -- Align trim geometry orthogonally for a shape with 90 degree angles.
-        :type trim_extrude_mode: str | None
+        :type trim_extrude_mode: typing.Literal['PROJECT','FIXED'] | None
         :param trim_solver: Solver
 
     EXACT
@@ -1112,7 +1169,7 @@ def trim_lasso_gesture(
 
     FAST
     Fast -- Use the fast float boolean solver.
-        :type trim_solver: str | None
+        :type trim_solver: typing.Literal['EXACT','FAST'] | None
     """
 
     ...
@@ -1131,11 +1188,11 @@ def trim_line_gesture(
     use_front_faces_only: bool | None = False,
     use_limit_to_segment: bool | None = False,
     location: collections.abc.Iterable[int] | None = (0, 0),
-    trim_mode: str | None = "DIFFERENCE",
+    trim_mode: typing.Literal["DIFFERENCE", "UNION", "JOIN"] | None = "DIFFERENCE",
     use_cursor_depth: bool | None = False,
-    trim_orientation: str | None = "VIEW",
-    trim_extrude_mode: str | None = "FIXED",
-    trim_solver: str | None = "FAST",
+    trim_orientation: typing.Literal["VIEW", "SURFACE"] | None = "VIEW",
+    trim_extrude_mode: typing.Literal["PROJECT", "FIXED"] | None = "FIXED",
+    trim_solver: typing.Literal["EXACT", "FAST"] | None = "FAST",
 ):
     """Remove a portion of the mesh on one side of a line
 
@@ -1170,7 +1227,7 @@ def trim_line_gesture(
 
     JOIN
     Join -- Join the new mesh as separate geometry, without performing any boolean operation.
-        :type trim_mode: str | None
+        :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
@@ -1180,7 +1237,7 @@ def trim_line_gesture(
 
     SURFACE
     Surface -- Use the surface normal to orientate the trimming shape.
-        :type trim_orientation: str | None
+        :type trim_orientation: typing.Literal['VIEW','SURFACE'] | None
         :param trim_extrude_mode: Extrude Mode
 
     PROJECT
@@ -1188,7 +1245,7 @@ def trim_line_gesture(
 
     FIXED
     Fixed -- Align trim geometry orthogonally for a shape with 90 degree angles.
-        :type trim_extrude_mode: str | None
+        :type trim_extrude_mode: typing.Literal['PROJECT','FIXED'] | None
         :param trim_solver: Solver
 
     EXACT
@@ -1196,7 +1253,7 @@ def trim_line_gesture(
 
     FAST
     Fast -- Use the fast float boolean solver.
-        :type trim_solver: str | None
+        :type trim_solver: typing.Literal['EXACT','FAST'] | None
     """
 
     ...
@@ -1209,11 +1266,11 @@ def trim_polyline_gesture(
     path: bpy.types.bpy_prop_collection[bpy.types.OperatorMousePath] | None = None,
     use_front_faces_only: bool | None = False,
     location: collections.abc.Iterable[int] | None = (0, 0),
-    trim_mode: str | None = "DIFFERENCE",
+    trim_mode: typing.Literal["DIFFERENCE", "UNION", "JOIN"] | None = "DIFFERENCE",
     use_cursor_depth: bool | None = False,
-    trim_orientation: str | None = "VIEW",
-    trim_extrude_mode: str | None = "FIXED",
-    trim_solver: str | None = "FAST",
+    trim_orientation: typing.Literal["VIEW", "SURFACE"] | None = "VIEW",
+    trim_extrude_mode: typing.Literal["PROJECT", "FIXED"] | None = "FIXED",
+    trim_solver: typing.Literal["EXACT", "FAST"] | None = "FAST",
 ):
     """Execute a boolean operation on the mesh and a polygonal shape defined by the cursor
 
@@ -1236,7 +1293,7 @@ def trim_polyline_gesture(
 
     JOIN
     Join -- Join the new mesh as separate geometry, without performing any boolean operation.
-        :type trim_mode: str | None
+        :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
@@ -1246,7 +1303,7 @@ def trim_polyline_gesture(
 
     SURFACE
     Surface -- Use the surface normal to orientate the trimming shape.
-        :type trim_orientation: str | None
+        :type trim_orientation: typing.Literal['VIEW','SURFACE'] | None
         :param trim_extrude_mode: Extrude Mode
 
     PROJECT
@@ -1254,7 +1311,7 @@ def trim_polyline_gesture(
 
     FIXED
     Fixed -- Align trim geometry orthogonally for a shape with 90 degree angles.
-        :type trim_extrude_mode: str | None
+        :type trim_extrude_mode: typing.Literal['PROJECT','FIXED'] | None
         :param trim_solver: Solver
 
     EXACT
@@ -1262,7 +1319,7 @@ def trim_polyline_gesture(
 
     FAST
     Fast -- Use the fast float boolean solver.
-        :type trim_solver: str | None
+        :type trim_solver: typing.Literal['EXACT','FAST'] | None
     """
 
     ...
@@ -1309,7 +1366,7 @@ def uv_sculpt_relax(
     undo: bool | None = None,
     *,
     use_invert: bool | None = False,
-    relax_method: str | None = "COTAN",
+    relax_method: typing.Literal["LAPLACIAN", "HC", "COTAN"] | None = "COTAN",
 ):
     """Relax UVs
 
@@ -1328,7 +1385,7 @@ def uv_sculpt_relax(
 
     COTAN
     Geometry -- Use Geometry (cotangent) relaxation, making UVs follow the underlying 3D geometry.
-        :type relax_method: str | None
+        :type relax_method: typing.Literal['LAPLACIAN','HC','COTAN'] | None
     """
 
     ...

bpy/ops/sculpt_curves/__init__.pyi

@@ -13,7 +13,7 @@ def brush_stroke(
     *,
     stroke: bpy.types.bpy_prop_collection[bpy.types.OperatorStrokeElement]
     | None = None,
-    mode: str | None = "NORMAL",
+    mode: typing.Literal["NORMAL", "INVERT", "SMOOTH", "ERASE"] | None = "NORMAL",
 ):
     """Sculpt curves using a brush
 
@@ -35,7 +35,7 @@ def brush_stroke(
 
     ERASE
     Erase -- Switch brush to erase mode for duration of stroke.
-        :type mode: str | None
+        :type mode: typing.Literal['NORMAL','INVERT','SMOOTH','ERASE'] | None
     """
 
     ...