@volter/blender-engine 0.1.148 → 0.1.149

package/browser/addons/vrm/editor/spring_bone1/property_group.py

@@ -0,0 +1,1457 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later
+import math
+import statistics
+import uuid
+from collections.abc import Callable, Sequence
+from sys import float_info
+from typing import TYPE_CHECKING, Optional
+
+import bpy
+from bpy.props import (
+    BoolProperty,
+    CollectionProperty,
+    EnumProperty,
+    FloatProperty,
+    FloatVectorProperty,
+    IntProperty,
+    PointerProperty,
+    StringProperty,
+)
+from bpy.types import Armature, Context, Object, PropertyGroup
+from mathutils import Matrix, Quaternion, Vector
+
+from ...common import convert, safe_removal
+from ...common.logger import get_logger
+from ...common.rotation import (
+    get_rotation_as_quaternion,
+    set_rotation_without_mode_change,
+)
+from ..extension_accessor import get_armature_extension
+from ..property_group import BonePropertyGroup, property_group_enum
+
+if TYPE_CHECKING:
+    from ..property_group import CollectionPropertyProtocol
+
+_logger = get_logger(__name__)
+
+
+def _find_armature_and_collider(
+    context: Context,
+    match_collider: Callable[["SpringBone1ColliderPropertyGroup"], bool],
+) -> tuple[Object, "SpringBone1ColliderPropertyGroup"]:
+    for obj in context.blend_data.objects:
+        if obj.type != "ARMATURE":
+            continue
+        armature_data = obj.data
+        if not isinstance(armature_data, Armature):
+            continue
+        for collider in get_armature_extension(armature_data).spring_bone1.colliders:
+            if match_collider(collider):
+                return (obj, collider)
+    message = "No armature"
+    raise ValueError(message)
+
+
+# https://github.com/vrm-c/vrm-specification/blob/6fb6baaf9b9095a84fb82c8384db36e1afeb3558/specification/VRMC_springBone-1.0-beta/schema/VRMC_springBone.shape.schema.json#L7-L27
+class SpringBone1ColliderShapeSpherePropertyGroup(PropertyGroup):
+    def find_armature_and_collider(
+        self,
+        context: Context,
+    ) -> tuple[Object, "SpringBone1ColliderPropertyGroup"]:
+        return _find_armature_and_collider(
+            context, lambda collider: collider.shape.sphere == self
+        )
+
+    def _get_offset(self) -> tuple[float, float, float]:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        if not collider.bpy_object:
+            _logger.error(
+                'Failed to get bpy object of "%s" in sphere._get_offset()',
+                collider.uuid or "unknown",
+            )
+            return (0, 0, 0)
+        bone = armature.pose.bones.get(collider.node.bone_name)
+        if bone:
+            matrix = (
+                bone.matrix.inverted()
+                @ armature.matrix_world.inverted()
+                @ collider.bpy_object.matrix_world
+            )
+        else:
+            matrix = armature.matrix_world.inverted() @ collider.bpy_object.matrix_world
+        return convert.float3_or(matrix.to_translation(), (0.0, 0.0, 0.0))
+
+    def _set_offset(self, offset: Sequence[float]) -> None:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        collider.reset_bpy_object(context, armature)
+        bone = armature.pose.bones.get(collider.node.bone_name)
+        if not bone:
+            if collider.bpy_object:
+                collider.bpy_object.matrix_world = (
+                    armature.matrix_world @ Matrix.Translation(offset)
+                )
+            return
+        if collider.bpy_object:
+            collider.bpy_object.matrix_world = (
+                armature.matrix_world @ bone.matrix @ Matrix.Translation(offset)
+            )
+
+    def _update_offset(self, _context: Context) -> None:
+        self.fallback_offset = self.offset
+
+    def _get_radius(self) -> float:
+        context = bpy.context
+
+        _, collider = self.find_armature_and_collider(context)
+        if not collider.bpy_object:
+            _logger.error(
+                'Failed to get bpy object of "%s" in sphere._get_radius()',
+                collider.uuid or "unknown",
+            )
+            return 0.0
+        mean_scale = statistics.mean(
+            abs(s) for s in collider.bpy_object.matrix_basis.to_scale()
+        )
+        empty_display_size: float = collider.bpy_object.empty_display_size
+        return float(mean_scale) * empty_display_size
+
+    def _set_radius(self, v: float) -> None:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        collider.reset_bpy_object(context, armature)
+        if not collider.bpy_object:
+            _logger.error(
+                'Failed to reset bpy object of "%s" in sphere._set_radius()',
+                collider.uuid or "unknown",
+            )
+            return
+        location, rotation, _ = collider.bpy_object.matrix_basis.decompose()
+        collider.bpy_object.matrix_basis = (
+            Matrix.Translation(location) @ rotation.to_matrix().to_4x4()
+        )
+        collider.bpy_object.empty_display_size = v
+
+    def _update_radius(self, _context: Context) -> None:
+        self.fallback_radius = self.radius
+
+    offset: FloatVectorProperty(  # type: ignore[valid-type]
+        size=3,
+        subtype="TRANSLATION",
+        unit="LENGTH",
+        default=(0, 0, 0),
+        get=_get_offset,
+        set=_set_offset,
+        update=_update_offset,
+    )
+
+    radius: FloatProperty(  # type: ignore[valid-type]
+        name="Radius",
+        min=0.0,
+        default=0.0,
+        soft_max=1.0,
+        unit="LENGTH",
+        get=_get_radius,
+        set=_set_radius,
+        update=_update_radius,
+    )
+
+    fallback_offset: FloatVectorProperty(  # type: ignore[valid-type]
+        name="Fallback Sphere Offset",
+        size=3,
+        subtype="TRANSLATION",
+        unit="LENGTH",
+        default=(0, 0, 0),
+    )
+
+    fallback_radius: FloatProperty(  # type: ignore[valid-type]
+        name="Fallback Sphere Radius",
+        min=0.0,
+        default=0.0,
+        soft_max=1.0,
+        unit="LENGTH",
+    )
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        offset: Sequence[float]  # type: ignore[no-redef]
+        radius: float  # type: ignore[no-redef]
+        fallback_offset: Sequence[float]  # type: ignore[no-redef]
+        fallback_radius: float  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/6fb6baaf9b9095a84fb82c8384db36e1afeb3558/specification/VRMC_springBone-1.0-beta/schema/VRMC_springBone.shape.schema.json#L28-L58
+class SpringBone1ColliderShapeCapsulePropertyGroup(PropertyGroup):
+    def find_armature_and_collider(
+        self,
+        context: Context,
+    ) -> tuple[Object, "SpringBone1ColliderPropertyGroup"]:
+        return _find_armature_and_collider(
+            context, lambda collider: collider.shape.capsule == self
+        )
+
+    def _get_offset(self) -> tuple[float, float, float]:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        if not collider.bpy_object:
+            _logger.error(
+                'Failed to get bpy object of "%s" in capsule._get_offset()',
+                collider.uuid or "unknown",
+            )
+            return (0, 0, 0)
+        bone = armature.pose.bones.get(collider.node.bone_name)
+        if bone:
+            matrix = (
+                bone.matrix.inverted()
+                @ armature.matrix_world.inverted()
+                @ collider.bpy_object.matrix_world
+            )
+        else:
+            matrix = armature.matrix_world.inverted() @ collider.bpy_object.matrix_world
+        return convert.float3_or(matrix.to_translation(), (0.0, 0.0, 0.0))
+
+    def _set_offset(self, offset: Sequence[float]) -> None:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        collider.reset_bpy_object(context, armature)
+        bone = armature.pose.bones.get(collider.node.bone_name)
+        if not bone:
+            if collider.bpy_object:
+                collider.bpy_object.matrix_world = (
+                    armature.matrix_world @ Matrix.Translation(offset)
+                )
+            return
+        if collider.bpy_object:
+            collider.bpy_object.matrix_world = (
+                armature.matrix_world @ bone.matrix @ Matrix.Translation(offset)
+            )
+
+    def _update_offset(self, _context: Context) -> None:
+        self.fallback_offset = self.offset
+
+    def _get_tail(self) -> tuple[float, float, float]:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        if not collider.bpy_object:
+            _logger.error(
+                'Failed to get bpy object of "%s" in capsule._get_tail()',
+                collider.uuid or "unknown",
+            )
+            return (0, 0, 0)
+        if not collider.bpy_object.children:
+            _logger.error(
+                'Failed to get bpy object children of "%s" in capsule._get_tail()',
+                collider.display_name,
+            )
+            return (0, 0, 0)
+        bone = armature.pose.bones.get(collider.node.bone_name)
+        if bone:
+            matrix = (
+                bone.matrix.inverted()
+                @ armature.matrix_world.inverted()
+                @ collider.bpy_object.children[0].matrix_world
+            )
+        else:
+            matrix = (
+                armature.matrix_world.inverted()
+                @ collider.bpy_object.children[0].matrix_world
+            )
+        return convert.float3_or(matrix.to_translation(), (0.0, 0.0, 0.0))
+
+    def _set_tail(self, offset: Sequence[float]) -> None:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        collider.reset_bpy_object(context, armature)
+        bone = armature.pose.bones.get(collider.node.bone_name)
+        if not bone:
+            if collider.bpy_object:
+                collider.bpy_object.children[0].matrix_world = (
+                    armature.matrix_world @ Matrix.Translation(offset)
+                )
+            return
+        if collider.bpy_object:
+            if not collider.bpy_object.children:
+                _logger.error(
+                    'Failed to set tail bpy object matrix of "%s"'
+                    " in capsule._set_tail()",
+                    collider.display_name,
+                )
+                return
+            collider.bpy_object.children[0].matrix_world = (
+                armature.matrix_world @ bone.matrix @ Matrix.Translation(offset)
+            )
+
+    def _update_tail(self, _context: Context) -> None:
+        self.fallback_tail = self.tail
+
+    def _get_radius(self) -> float:
+        context = bpy.context
+
+        _, collider = self.find_armature_and_collider(context)
+        if not collider.bpy_object:
+            _logger.error(
+                'Failed to get bpy object of "%s" in capsule._get_radius()',
+                collider.uuid or "unknown",
+            )
+            return 0.0
+        mean_scale: float = statistics.mean(
+            abs(s) for s in collider.bpy_object.matrix_basis.to_scale()
+        )
+        empty_display_size: float = collider.bpy_object.empty_display_size
+        return mean_scale * empty_display_size
+
+    def _set_radius(self, v: float) -> None:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        collider.reset_bpy_object(context, armature)
+        if not collider.bpy_object:
+            _logger.error(
+                'Failed to reset bpy object of "%s" in capsule._set_radius()',
+                collider.uuid or "unknown",
+            )
+            return
+        location, rotation, _ = collider.bpy_object.matrix_basis.decompose()
+        collider.bpy_object.matrix_basis = (
+            Matrix.Translation(location) @ rotation.to_matrix().to_4x4()
+        )
+        collider.bpy_object.empty_display_size = v
+        if not collider.bpy_object.children:
+            _logger.error(
+                'Failed to set tail bpy object size of "%s" in capsule._set_radius()',
+                collider.display_name,
+            )
+            return
+        collider.bpy_object.children[0].empty_display_size = v
+
+    def _update_radius(self, _context: Context) -> None:
+        self.fallback_radius = self.radius
+
+    offset: FloatVectorProperty(  # type: ignore[valid-type]
+        size=3,
+        subtype="TRANSLATION",
+        unit="LENGTH",
+        default=(0, 0, 0),
+        get=_get_offset,
+        set=_set_offset,
+        update=_update_offset,
+    )
+
+    radius: FloatProperty(  # type: ignore[valid-type]
+        name="Radius",
+        min=0.0,
+        default=0.0,
+        soft_max=1.0,
+        unit="LENGTH",
+        get=_get_radius,
+        set=_set_radius,
+        update=_update_radius,
+    )
+
+    tail: FloatVectorProperty(  # type: ignore[valid-type]
+        size=3,
+        subtype="TRANSLATION",
+        unit="LENGTH",
+        default=(0, 0, 0),
+        get=_get_tail,
+        set=_set_tail,
+        update=_update_tail,
+    )
+
+    fallback_offset: FloatVectorProperty(  # type: ignore[valid-type]
+        name="Fallback Capsule Head",
+        size=3,
+        subtype="TRANSLATION",
+        unit="LENGTH",
+        default=(0, 0, 0),
+    )
+
+    fallback_radius: FloatProperty(  # type: ignore[valid-type]
+        name="Fallback Capsule Radius",
+        min=0.0,
+        default=0.0,
+        soft_max=1.0,
+        unit="LENGTH",
+    )
+
+    fallback_tail: FloatVectorProperty(  # type: ignore[valid-type]
+        name="Fallback Capsule Tail",
+        size=3,
+        subtype="TRANSLATION",
+        unit="LENGTH",
+        default=(0, 0, 0),
+    )
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        offset: Sequence[float]  # type: ignore[no-redef]
+        radius: float  # type: ignore[no-redef]
+        tail: Sequence[float]  # type: ignore[no-redef]
+        fallback_offset: Sequence[float]  # type: ignore[no-redef]
+        fallback_radius: float  # type: ignore[no-redef]
+        fallback_tail: Sequence[float]  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/9e8c886a2043639a3c166eb7cc93526be6313147/specification/VRMC_springBone_extended_collider-1.0/schema/VRMC_springBone_extended_collider.shape.schema.json#L9
+class SpringBone1ExtendedColliderShapeSpherePropertyGroup(
+    SpringBone1ColliderShapeSpherePropertyGroup
+):
+    def find_armature_and_collider(
+        self,
+        context: Context,
+    ) -> tuple[Object, "SpringBone1ColliderPropertyGroup"]:
+        return _find_armature_and_collider(
+            context,
+            lambda collider: (
+                collider.extensions.vrmc_spring_bone_extended_collider.shape.sphere
+                == self
+            ),
+        )
+
+    inside: BoolProperty()  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        inside: bool  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/9e8c886a2043639a3c166eb7cc93526be6313147/specification/VRMC_springBone_extended_collider-1.0/schema/VRMC_springBone_extended_collider.shape.schema.json#L36
+class SpringBone1ExtendedColliderShapeCapsulePropertyGroup(
+    SpringBone1ColliderShapeCapsulePropertyGroup
+):
+    def find_armature_and_collider(
+        self,
+        context: Context,
+    ) -> tuple[Object, "SpringBone1ColliderPropertyGroup"]:
+        return _find_armature_and_collider(
+            context,
+            lambda collider: (
+                collider.extensions.vrmc_spring_bone_extended_collider.shape.capsule
+                == self
+            ),
+        )
+
+    inside: BoolProperty()  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        inside: bool  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/9e8c886a2043639a3c166eb7cc93526be6313147/specification/VRMC_springBone_extended_collider-1.0/schema/VRMC_springBone_extended_collider.shape.schema.json#L73
+class SpringBone1ExtendedColliderShapePlanePropertyGroup(PropertyGroup):
+    def find_armature_and_collider(
+        self,
+        context: Context,
+    ) -> tuple[Object, "SpringBone1ColliderPropertyGroup"]:
+        return _find_armature_and_collider(
+            context,
+            lambda collider: (
+                collider.extensions.vrmc_spring_bone_extended_collider.shape.plane
+                == self
+            ),
+        )
+
+    def _get_offset(self) -> tuple[float, float, float]:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        if not collider.bpy_object:
+            _logger.error(
+                'Failed to get bpy object of "%s" in extended_collider._get_offset()',
+                collider.uuid or "unknown",
+            )
+            return (0, 0, 0)
+        bone = armature.pose.bones.get(collider.node.bone_name)
+        if bone:
+            matrix = (
+                bone.matrix.inverted()
+                @ armature.matrix_world.inverted()
+                @ collider.bpy_object.matrix_world
+            )
+        else:
+            matrix = armature.matrix_world.inverted() @ collider.bpy_object.matrix_world
+        return convert.float3_or(matrix.to_translation(), (0.0, 0.0, 0.0))
+
+    def _set_offset(self, offset: Sequence[float]) -> None:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        collider.reset_bpy_object(context, armature)
+        bone = armature.pose.bones.get(collider.node.bone_name)
+        if not bone:
+            if collider.bpy_object:
+                collider.bpy_object.matrix_world = (
+                    armature.matrix_world @ Matrix.Translation(offset)
+                )
+            return
+        if collider.bpy_object:
+            collider.bpy_object.matrix_world = (
+                armature.matrix_world @ bone.matrix @ Matrix.Translation(offset)
+            )
+
+    def _get_normal(self) -> tuple[float, float, float]:
+        context = bpy.context
+
+        _, collider = self.find_armature_and_collider(context)
+        bpy_object = collider.bpy_object
+        if not bpy_object:
+            return (0.0, 1.0, 0.0)
+
+        result = Vector((0.0, 1.0, 0.0))
+        result.rotate(get_rotation_as_quaternion(bpy_object))
+
+        return (
+            # use tuple initializer to make type checkers happy
+            result.x,
+            result.y,
+            result.z,
+        )
+
+    def _set_normal(self, normal: Sequence[float]) -> None:
+        context = bpy.context
+
+        armature, collider = self.find_armature_and_collider(context)
+        collider.reset_bpy_object(context, armature)
+
+        y_up_vec = Vector((0.0, 1.0, 0.0))
+        normal_vec = Vector(normal)
+        if normal_vec.length_squared > 0:
+            rotation = y_up_vec.rotation_difference(normal_vec)
+        else:
+            rotation = Quaternion()
+
+        bpy_object = collider.bpy_object
+        if bpy_object:
+            set_rotation_without_mode_change(bpy_object, rotation)
+
+    offset: FloatVectorProperty(  # type: ignore[valid-type]
+        size=3,
+        subtype="TRANSLATION",
+        unit="LENGTH",
+        default=(0, 0, 0),
+        get=_get_offset,
+        set=_set_offset,
+    )
+
+    normal: FloatVectorProperty(  # type: ignore[valid-type]
+        size=3,
+        default=(0, 0, 1),
+        get=_get_normal,
+        set=_set_normal,
+    )
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        offset: Sequence[float]  # type: ignore[no-redef]
+        normal: Sequence[float]  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/6fb6baaf9b9095a84fb82c8384db36e1afeb3558/specification/VRMC_springBone-1.0-beta/schema/VRMC_springBone.shape.schema.json
+class SpringBone1ColliderShapePropertyGroup(PropertyGroup):
+    sphere: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1ColliderShapeSpherePropertyGroup
+    )
+    capsule: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1ColliderShapeCapsulePropertyGroup
+    )
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        sphere: SpringBone1ColliderShapeSpherePropertyGroup  # type: ignore[no-redef]
+        capsule: SpringBone1ColliderShapeCapsulePropertyGroup  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/9e8c886a2043639a3c166eb7cc93526be6313147/specification/VRMC_springBone_extended_collider-1.0/schema/VRMC_springBone_extended_collider.shape.schema.json
+class SpringBone1ExtendedColliderShapePropertyGroup(PropertyGroup):
+    sphere: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1ExtendedColliderShapeSpherePropertyGroup
+    )
+    capsule: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1ExtendedColliderShapeCapsulePropertyGroup
+    )
+    plane: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1ExtendedColliderShapePlanePropertyGroup
+    )
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        sphere: (  # type: ignore[no-redef]
+            SpringBone1ExtendedColliderShapeSpherePropertyGroup
+        )
+        capsule: (  # type: ignore[no-redef]
+            SpringBone1ExtendedColliderShapeCapsulePropertyGroup
+        )
+        plane: (  # type: ignore[no-redef]
+            SpringBone1ExtendedColliderShapePlanePropertyGroup
+        )
+
+
+# https://github.com/vrm-c/vrm-specification/blob/9e8c886a2043639a3c166eb7cc93526be6313147/specification/VRMC_springBone_extended_collider-1.0/schema/VRMC_springBone_extended_collider.schema.json
+class SpringBone1VrmcSpringBoneExtendedColliderPropertyGroup(PropertyGroup):
+    def _update_shape_type(self, context: Context) -> None:
+        armature, collider = _find_armature_and_collider(
+            context,
+            lambda collider: (
+                collider.extensions.vrmc_spring_bone_extended_collider == self
+            ),
+        )
+        collider.reset_bpy_object(context, armature)
+
+    enabled: BoolProperty(  # type: ignore[valid-type]
+        name="Extended Collider",
+        update=_update_shape_type,
+    )
+
+    automatic_fallback_generation: BoolProperty(  # type: ignore[valid-type]
+        name="Automatic Fallback Generation",
+        default=True,
+    )
+
+    shape: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1ExtendedColliderShapePropertyGroup
+    )
+
+    (
+        shape_type_enum,
+        (
+            SHAPE_TYPE_EXTENDED_SPHERE,
+            SHAPE_TYPE_EXTENDED_CAPSULE,
+            SHAPE_TYPE_EXTENDED_PLANE,
+        ),
+    ) = property_group_enum(
+        ("extendedSphere", "Sphere", "", "NONE", 0),
+        ("extendedCapsule", "Capsule", "", "NONE", 1),
+        ("extendedPlane", "Plane", "", "NONE", 2),
+    )
+
+    shape_type: EnumProperty(  # type: ignore[valid-type]
+        items=shape_type_enum.items(),
+        name="Shape",
+        update=_update_shape_type,
+    )
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        enabled: bool  # type: ignore[no-redef]
+        automatic_fallback_generation: bool  # type: ignore[no-redef]
+        shape: SpringBone1ExtendedColliderShapePropertyGroup  # type: ignore[no-redef]
+        shape_type: str  # type: ignore[no-redef]
+
+
+class SpringBone1ColliderExtensionsPropertyGroup(PropertyGroup):
+    vrmc_spring_bone_extended_collider: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1VrmcSpringBoneExtendedColliderPropertyGroup
+    )
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        vrmc_spring_bone_extended_collider: (  # type: ignore[no-redef]
+            SpringBone1VrmcSpringBoneExtendedColliderPropertyGroup
+        )
+
+
+# https://github.com/vrm-c/vrm-specification/blob/6fb6baaf9b9095a84fb82c8384db36e1afeb3558/specification/VRMC_springBone-1.0-beta/schema/VRMC_springBone.collider.schema.json
+class SpringBone1ColliderPropertyGroup(PropertyGroup):
+    @property
+    def display_name(self) -> str:
+        bpy_object = self.bpy_object
+        if not bpy_object:
+            return ""
+        return bpy_object.name
+
+    node: PointerProperty(  # type: ignore[valid-type]
+        type=BonePropertyGroup,
+        name="Bone",
+    )
+    shape: PointerProperty(type=SpringBone1ColliderShapePropertyGroup)  # type: ignore[valid-type]
+    extensions: PointerProperty(type=SpringBone1ColliderExtensionsPropertyGroup)  # type: ignore[valid-type]
+
+    # for UI
+    show_expanded: BoolProperty()  # type: ignore[valid-type]
+
+    (
+        shape_type_enum,
+        (
+            SHAPE_TYPE_SPHERE,
+            SHAPE_TYPE_CAPSULE,
+        ),
+    ) = property_group_enum(
+        ("Sphere", "Sphere", "", "NONE", 0),
+        ("Capsule", "Capsule", "", "NONE", 1),
+    )
+
+    (
+        ui_collider_type_enum,
+        (
+            UI_COLLIDER_TYPE_SPHERE,
+            UI_COLLIDER_TYPE_CAPSULE,
+            UI_COLLIDER_TYPE_PLANE,
+            UI_COLLIDER_TYPE_SPHERE_INSIDE,
+            UI_COLLIDER_TYPE_CAPSULE_INSIDE,
+        ),
+    ) = property_group_enum(
+        ("uiColliderTypeSphere", "Sphere", "", "NONE", 0),
+        ("uiColliderTypeCapsule", "Capsule", "", "NONE", 1),
+        ("uiColliderTypePlane", "Plane", "", "NONE", 2),
+        ("uiColliderTypeSphereInside", "Sphere Inside", "", "NONE", 3),
+        ("uiColliderTypeCapsuleInside", "Capsule Inside", "", "NONE", 4),
+    )
+
+    def _get_ui_collider_type(self) -> int:
+        extended = self.extensions.vrmc_spring_bone_extended_collider
+        if not extended.enabled:
+            if self.shape_type == self.SHAPE_TYPE_SPHERE.identifier:
+                return self.UI_COLLIDER_TYPE_SPHERE.value
+            if self.shape_type == self.SHAPE_TYPE_CAPSULE.identifier:
+                return self.UI_COLLIDER_TYPE_CAPSULE.value
+            return self.UI_COLLIDER_TYPE_SPHERE.value
+
+        if extended.shape_type == extended.SHAPE_TYPE_EXTENDED_PLANE.identifier:
+            return self.UI_COLLIDER_TYPE_PLANE.value
+        if extended.shape_type == extended.SHAPE_TYPE_EXTENDED_SPHERE.identifier:
+            if extended.shape.sphere.inside:
+                return self.UI_COLLIDER_TYPE_SPHERE_INSIDE.value
+            return self.UI_COLLIDER_TYPE_SPHERE.value
+        if extended.shape_type == extended.SHAPE_TYPE_EXTENDED_CAPSULE.identifier:
+            if extended.shape.capsule.inside:
+                return self.UI_COLLIDER_TYPE_CAPSULE_INSIDE.value
+            return self.UI_COLLIDER_TYPE_CAPSULE.value
+        return self.UI_COLLIDER_TYPE_SPHERE.value
+
+    def _set_ui_collider_type(self, value: int) -> None:
+        extended = self.extensions.vrmc_spring_bone_extended_collider
+
+        if value in (
+            self.UI_COLLIDER_TYPE_SPHERE.value,
+            self.UI_COLLIDER_TYPE_SPHERE_INSIDE.value,
+        ):
+            if self.shape_type != self.SHAPE_TYPE_SPHERE.identifier:
+                self.shape_type = self.SHAPE_TYPE_SPHERE.identifier
+            if extended.shape_type != extended.SHAPE_TYPE_EXTENDED_SPHERE.identifier:
+                extended.shape_type = extended.SHAPE_TYPE_EXTENDED_SPHERE.identifier
+            inside = self.UI_COLLIDER_TYPE_SPHERE_INSIDE.value == value
+            if extended.shape.sphere.inside != inside:
+                extended.shape.sphere.inside = inside
+            if extended.enabled != inside:
+                extended.enabled = inside
+            return
+
+        if value in (
+            self.UI_COLLIDER_TYPE_CAPSULE.value,
+            self.UI_COLLIDER_TYPE_CAPSULE_INSIDE.value,
+        ):
+            if self.shape_type != self.SHAPE_TYPE_CAPSULE.identifier:
+                self.shape_type = self.SHAPE_TYPE_CAPSULE.identifier
+            if extended.shape_type != extended.SHAPE_TYPE_EXTENDED_CAPSULE.identifier:
+                extended.shape_type = extended.SHAPE_TYPE_EXTENDED_CAPSULE.identifier
+            inside = self.UI_COLLIDER_TYPE_CAPSULE_INSIDE.value == value
+            if extended.shape.capsule.inside != inside:
+                extended.shape.capsule.inside = inside
+            if extended.enabled != inside:
+                extended.enabled = inside
+            return
+
+        if self.UI_COLLIDER_TYPE_PLANE.value == value:
+            if not extended.enabled:
+                extended.enabled = True
+            if extended.shape_type != extended.SHAPE_TYPE_EXTENDED_PLANE.identifier:
+                extended.shape_type = extended.SHAPE_TYPE_EXTENDED_PLANE.identifier
+
+    def _update_shape_type(self, context: Context) -> None:
+        if (
+            self.bpy_object
+            and self.bpy_object.parent
+            and self.bpy_object.parent.type == "ARMATURE"
+        ):
+            self.reset_bpy_object(context, self.bpy_object.parent)
+
+    shape_type: EnumProperty(  # type: ignore[valid-type]
+        items=shape_type_enum.items(),
+        name="Shape",
+        update=_update_shape_type,
+    )
+
+    ui_collider_type: EnumProperty(  # type: ignore[valid-type]
+        items=ui_collider_type_enum.items(),
+        name="Collider Type",
+        get=_get_ui_collider_type,
+        set=_set_ui_collider_type,
+    )
+
+    # for View3D
+    bpy_object: PointerProperty(  # type: ignore[valid-type]
+        type=Object
+    )
+
+    # for references
+    uuid: StringProperty()  # type: ignore[valid-type]
+
+    def reset_bpy_object(self, context: Context, armature: Object) -> None:
+        armature_data = armature.data
+        if not isinstance(armature_data, Armature):
+            return
+        collider_prefix = armature_data.name
+        if self.node and self.node.bone_name:
+            collider_prefix = self.node.bone_name
+
+        if not self.bpy_object or not self.bpy_object.name:
+            obj = context.blend_data.objects.new(
+                name=f"{collider_prefix} Collider", object_data=None
+            )
+            obj.empty_display_size = 0.125
+            context.scene.collection.objects.link(obj)
+            self.bpy_object = obj
+        self.bpy_object.select_set(True)
+
+        if self.bpy_object.parent != armature:
+            self.bpy_object.parent = armature
+
+        extended = self.extensions.vrmc_spring_bone_extended_collider
+        if (
+            not extended.enabled
+            and self.shape_type == self.SHAPE_TYPE_SPHERE.identifier
+        ) or (
+            extended.enabled
+            and extended.shape_type
+            in (
+                extended.SHAPE_TYPE_EXTENDED_SPHERE.identifier,
+                extended.SHAPE_TYPE_EXTENDED_PLANE.identifier,
+            )
+        ):
+            for child in list(self.bpy_object.children):
+                if not safe_removal.remove_object(context, child):
+                    _logger.warning(
+                        'Failed to remove "%s" with %d users'
+                        " while changing spring bone collider type",
+                        child.name,
+                        child.users,
+                    )
+            empty_display_type = "SPHERE"
+            if extended.shape_type == extended.SHAPE_TYPE_EXTENDED_PLANE.identifier:
+                empty_display_type = "CIRCLE"
+            if self.bpy_object.empty_display_type != empty_display_type:
+                self.bpy_object.empty_display_type = empty_display_type
+        elif (
+            not extended.enabled
+            and self.shape_type == self.SHAPE_TYPE_CAPSULE.identifier
+        ) or (
+            extended.enabled
+            and extended.shape_type == extended.SHAPE_TYPE_EXTENDED_CAPSULE.identifier
+        ):
+            if self.bpy_object.children:
+                end_object = self.bpy_object.children[0]
+            else:
+                end_object = context.blend_data.objects.new(
+                    name=f"{self.bpy_object.name} End", object_data=None
+                )
+                end_object.empty_display_size = self.bpy_object.empty_display_size
+                context.scene.collection.objects.link(end_object)
+                end_object.parent = self.bpy_object
+                end_object.matrix_local = Matrix.Translation(Vector((0.0, 0.2, 0.0)))
+            end_object.select_set(True)
+            if self.bpy_object.empty_display_type != "SPHERE":
+                self.bpy_object.empty_display_type = "SPHERE"
+            if end_object.empty_display_type != "SPHERE":
+                end_object.empty_display_type = "SPHERE"
+            if end_object.empty_display_size != self.bpy_object.empty_display_size:
+                end_object.empty_display_size = self.bpy_object.empty_display_size
+            if end_object.scale != Vector((1, 1, 1)):
+                end_object.scale = Vector((1, 1, 1))
+
+        if self.node.bone_name:
+            if self.bpy_object.parent_type != "BONE":
+                self.bpy_object.parent_type = "BONE"
+            if self.bpy_object.parent_bone != self.node.bone_name:
+                self.bpy_object.parent_bone = self.node.bone_name
+        else:
+            if self.bpy_object.parent_type != "OBJECT":
+                self.bpy_object.parent_type = "OBJECT"
+            if self.bpy_object.parent_bone:
+                self.bpy_object.parent_bone = ""
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        node: BonePropertyGroup  # type: ignore[no-redef]
+        shape: SpringBone1ColliderShapePropertyGroup  # type: ignore[no-redef]
+        extensions: SpringBone1ColliderExtensionsPropertyGroup  # type: ignore[no-redef]
+        show_expanded: bool  # type: ignore[no-redef]
+        shape_type: str  # type: ignore[no-redef]
+        ui_collider_type: str  # type: ignore[no-redef]
+        bpy_object: Optional[Object]  # type: ignore[no-redef]
+        uuid: str  # type: ignore[no-redef]
+
+
+class SpringBone1ColliderReferencePropertyGroup(PropertyGroup):
+    @property
+    def collider_display_name(self) -> str:
+        armature = self.id_data
+        if not isinstance(armature, Armature):
+            return ""
+        if not self.collider_uuid:
+            return ""
+
+        spring_bone = get_armature_extension(armature).spring_bone1
+        for collider in spring_bone.colliders:
+            if collider.uuid == self.collider_uuid:
+                return collider.display_name
+        return ""
+
+    def _update_collider_uuid(self, _context: Context) -> None:
+        if not self.collider_uuid:
+            return
+        armature_data = self.id_data
+        if not isinstance(armature_data, Armature):
+            return
+        spring_bone1 = get_armature_extension(armature_data).spring_bone1
+        for collider in spring_bone1.colliders:
+            if self.collider_uuid == collider.uuid:
+                return
+        self.collider_uuid = ""
+
+    collider_uuid: StringProperty(update=_update_collider_uuid)  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        collider_uuid: str  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/f2d8f158297fc883aef9c3071ca68fbe46b03f45/specification/0.0/schema/vrm.secondaryanimation.collidergroup.schema.json
+class SpringBone1ColliderGroupPropertyGroup(PropertyGroup):
+    def add_collider(self) -> SpringBone1ColliderReferencePropertyGroup:
+        collider = self.colliders.add()
+        self.active_collider_index = len(self.colliders) - 1
+        return collider
+
+    def _get_vrm_name(self) -> str:
+        value = self.get("vrm_name", "")
+        return value if isinstance(value, str) else str(value)
+
+    def _set_vrm_name(self, vrm_name: object) -> None:
+        if not isinstance(vrm_name, str):
+            vrm_name = str(vrm_name)
+        self["vrm_name"] = vrm_name
+
+    vrm_name: StringProperty(  # type: ignore[valid-type]
+        name="Name",
+        get=_get_vrm_name,
+        set=_set_vrm_name,
+    )
+
+    colliders: CollectionProperty(  # type: ignore[valid-type]
+        name="Colliders",
+        type=SpringBone1ColliderReferencePropertyGroup,
+    )
+
+    def fixup(self) -> None:
+        if not isinstance(armature_data := self.id_data, Armature):
+            return
+        spring_bone1 = get_armature_extension(armature_data).spring_bone1
+        collider_uuids = {
+            collider.uuid for collider in spring_bone1.colliders if collider.uuid
+        }
+        for collider_reference in self.colliders:
+            collider_uuid = collider_reference.collider_uuid
+            if not collider_uuid:
+                continue
+            if collider_uuid in collider_uuids:
+                collider_uuids.remove(collider_uuid)
+                continue
+            _logger.error(
+                'Collider with uuid "%s" not found or duplicated for'
+                ' "%s". Clearing UUID.',
+                collider_uuid,
+                collider_reference.path_from_id(),
+            )
+            collider_reference.collider_uuid = ""
+
+    # for UI
+    show_expanded: BoolProperty()  # type: ignore[valid-type]
+    active_collider_index: IntProperty(min=0)  # type: ignore[valid-type]
+
+    # for reference
+    # When copying objects, there may be multiple objects with the same uuid
+    uuid: StringProperty()  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        vrm_name: str  # type: ignore[no-redef]
+        colliders: CollectionPropertyProtocol[  # type: ignore[no-redef]
+            SpringBone1ColliderReferencePropertyGroup
+        ]
+        show_expanded: bool  # type: ignore[no-redef]
+        active_collider_index: int  # type: ignore[no-redef]
+        uuid: str  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/tree/993a90a5bda9025f3d9e2923ad6dea7506f88553/specification/VRMC_springBone-1.0#initialization
+class SpringBone1JointAnimationStatePropertyGroup(PropertyGroup):
+    initialized_as_tail: BoolProperty()  # type: ignore[valid-type]
+
+    previous_world_translation: FloatVectorProperty(size=3)  # type: ignore[valid-type]
+    current_world_translation: FloatVectorProperty(size=3)  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        initialized_as_tail: bool  # type: ignore[no-redef]
+        previous_world_translation: Sequence[float]  # type: ignore[no-redef]
+        current_world_translation: Sequence[float]  # type: ignore[no-redef]
+
+
+class SpringBone1VrmcSpringBoneLimitPropertyGroup(PropertyGroup):
+    (
+        limit_type_enum,
+        (
+            LIMIT_TYPE_NONE,
+            LIMIT_TYPE_CONE,
+            LIMIT_TYPE_HINGE,
+            LIMIT_TYPE_SPHERICAL,
+        ),
+    ) = property_group_enum(
+        ("NONE", "None", "Don't apply an angle limit", "NONE", 0),
+        ("CONE", "Cone", "Restrict the joint direction to a cone", "CONE", 1),
+        (
+            "HINGE",
+            "Hinge",
+            "Restrict the joint direction to a hinge plane",
+            "CON_ROTLIKE",
+            2,
+        ),
+        (
+            "SPHERICAL",
+            "Spherical",
+            "Restrict the joint direction by pitch and yaw",
+            "SPHERE",
+            3,
+        ),
+    )
+
+    limit_type: EnumProperty(  # type: ignore[valid-type]
+        items=limit_type_enum.items(),
+        name="Limit Type",
+    )
+    cone_angle: FloatProperty(  # type: ignore[valid-type]
+        name="Angle",
+        subtype="ANGLE",
+        min=0.0,
+        max=math.pi,
+        default=math.pi,
+    )
+    hinge_angle: FloatProperty(  # type: ignore[valid-type]
+        name="Angle",
+        subtype="ANGLE",
+        min=0.0,
+        max=math.pi,
+        default=math.pi,
+    )
+    spherical_pitch: FloatProperty(  # type: ignore[valid-type]
+        name="Pitch",
+        subtype="ANGLE",
+        min=0.0,
+        max=math.pi,
+        default=math.pi,
+    )
+    spherical_yaw: FloatProperty(  # type: ignore[valid-type]
+        name="Yaw",
+        subtype="ANGLE",
+        min=0.0,
+        max=math.pi / 2.0,
+        default=math.pi / 2.0,
+    )
+    rotation: FloatVectorProperty(  # type: ignore[valid-type]
+        name="Rotation",
+        description="Relative rotation as a W, X, Y, Z quaternion",
+        size=4,
+        subtype="QUATERNION",
+        min=-1.0,
+        max=1.0,
+        default=(1.0, 0.0, 0.0, 0.0),
+    )
+
+    @staticmethod
+    def default_rotation(bone_axis: Vector) -> Quaternion:
+        bone_axis = bone_axis.normalized()
+        dot = max(-1.0, min(1.0, bone_axis.y))
+        if dot < -1.0 + float_info.epsilon:
+            return Quaternion((0.0, 1.0, 0.0, 0.0))
+        return Quaternion((dot + 1.0, bone_axis.z, 0.0, -bone_axis.x)).normalized()
+
+    def rotation_quaternion(self) -> Quaternion:
+        rotation = Quaternion(self.rotation)
+        if sum(component * component for component in rotation) < float_info.epsilon:
+            return Quaternion()
+        rotation.normalize()
+        return rotation
+
+    if TYPE_CHECKING:
+        limit_type: str  # type: ignore[no-redef]
+        cone_angle: float  # type: ignore[no-redef]
+        hinge_angle: float  # type: ignore[no-redef]
+        spherical_pitch: float  # type: ignore[no-redef]
+        spherical_yaw: float  # type: ignore[no-redef]
+        rotation: Sequence[float]  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/6fb6baaf9b9095a84fb82c8384db36e1afeb3558/specification/VRMC_springBone-1.0-beta/schema/VRMC_springBone.joint.schema.json
+class SpringBone1JointPropertyGroup(PropertyGroup):
+    node: PointerProperty(  # type: ignore[valid-type]
+        type=BonePropertyGroup,
+        name="Bone",
+    )
+
+    hit_radius: FloatProperty(  # type: ignore[valid-type]
+        name="Joint Radius",
+        min=0.0,
+        default=0.0,
+        soft_max=0.5,
+    )
+
+    stiffness: FloatProperty(  # type: ignore[valid-type]
+        name="Stiffness Force",
+        min=0.0,
+        default=1.0,
+        soft_max=4.0,
+    )
+
+    gravity_power: FloatProperty(  # type: ignore[valid-type]
+        name="Gravity Power",
+        min=0.0,
+        default=0.0,
+        soft_max=2.0,
+    )
+
+    def _update_gravity_dir(self, _context: Context) -> None:
+        gravity_dir = Vector(self.gravity_dir)
+        normalized_gravity_dir = gravity_dir.normalized()
+        if abs(normalized_gravity_dir.length) < float_info.epsilon:
+            self.gravity_dir = (0, 0, -1)
+        elif (gravity_dir - normalized_gravity_dir).length > 0.0001:
+            self.gravity_dir = normalized_gravity_dir
+
+    gravity_dir: FloatVectorProperty(  # type: ignore[valid-type]
+        name="Gravity Dir",
+        size=3,
+        min=-1,
+        max=1,
+        default=(0, 0, -1),
+        subtype="XYZ",
+        update=_update_gravity_dir,
+    )
+
+    drag_force: FloatProperty(  # type: ignore[valid-type]
+        name="Drag Force",
+        default=0.5,
+        min=0,
+        max=1.0,
+    )
+
+    animation_state: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1JointAnimationStatePropertyGroup,
+    )
+
+    vrmc_spring_bone_limit: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1VrmcSpringBoneLimitPropertyGroup,
+    )
+
+    # for UI
+    show_expanded: BoolProperty()  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        node: BonePropertyGroup  # type: ignore[no-redef]
+        hit_radius: float  # type: ignore[no-redef]
+        stiffness: float  # type: ignore[no-redef]
+        gravity_power: float  # type: ignore[no-redef]
+        gravity_dir: Sequence[float]  # type: ignore[no-redef]
+        drag_force: float  # type: ignore[no-redef]
+        animation_state: (  # type: ignore[no-redef]
+            SpringBone1JointAnimationStatePropertyGroup
+        )
+        vrmc_spring_bone_limit: (  # type: ignore[no-redef]
+            SpringBone1VrmcSpringBoneLimitPropertyGroup
+        )
+        show_expanded: bool  # type: ignore[no-redef]
+
+
+class SpringBone1ColliderGroupReferencePropertyGroup(PropertyGroup):
+    @property
+    def collider_group_display_name(self) -> str:
+        armature = self.id_data
+        if not isinstance(armature, Armature):
+            return ""
+        if not self.collider_group_uuid:
+            return ""
+
+        spring_bone = get_armature_extension(armature).spring_bone1
+        for collider_group in spring_bone.collider_groups:
+            if collider_group.uuid == self.collider_group_uuid:
+                return collider_group.vrm_name
+        return ""
+
+    def _update_collider_group_uuid(self, _context: Context) -> None:
+        if not self.collider_group_uuid:
+            return
+        armature = self.id_data
+        if not isinstance(armature, Armature):
+            return
+
+        spring_bone = get_armature_extension(armature).spring_bone1
+        for collider_group in spring_bone.collider_groups:
+            if self.collider_group_uuid == collider_group.uuid:
+                return
+
+        self.collider_group_uuid = ""
+
+    collider_group_uuid: StringProperty(update=_update_collider_group_uuid)  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        collider_group_uuid: str  # type: ignore[no-redef]
+
+
+class SpringBone1SpringAnimationStatePropertyGroup(PropertyGroup):
+    use_center_space: BoolProperty()  # type: ignore[valid-type]
+
+    previous_center_world_translation: FloatVectorProperty(size=3)  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        use_center_space: bool  # type: ignore[no-redef]
+        previous_center_world_translation: Sequence[float]  # type: ignore[no-redef]
+
+
+# https://github.com/vrm-c/vrm-specification/blob/6fb6baaf9b9095a84fb82c8384db36e1afeb3558/specification/VRMC_springBone-1.0-beta/schema/VRMC_springBone.spring.schema.json
+class SpringBone1SpringPropertyGroup(PropertyGroup):
+    def add_joint(self) -> "SpringBone1JointPropertyGroup":
+        joint = self.joints.add()
+        self.active_joint_index = len(self.joints) - 1
+        return joint
+
+    def add_collider_group(self) -> "SpringBone1ColliderGroupReferencePropertyGroup":
+        collider_group = self.collider_groups.add()
+        self.active_collider_group_index = len(self.collider_groups) - 1
+        return collider_group
+
+    vrm_name: StringProperty(  # type: ignore[valid-type]
+        name="Name"
+    )
+    joints: CollectionProperty(  # type: ignore[valid-type]
+        type=SpringBone1JointPropertyGroup
+    )
+    collider_groups: CollectionProperty(  # type: ignore[valid-type]
+        type=SpringBone1ColliderGroupReferencePropertyGroup,
+    )
+    center: PointerProperty(  # type: ignore[valid-type]
+        type=BonePropertyGroup,
+    )
+
+    def fixup(self) -> None:
+        if not isinstance(armature_data := self.id_data, Armature):
+            return
+        spring_bone1 = get_armature_extension(armature_data).spring_bone1
+        collider_group_uuids = {
+            collider_group.uuid
+            for collider_group in spring_bone1.collider_groups
+            if collider_group.uuid
+        }
+        for collider_group_reference in self.collider_groups:
+            collider_group_uuid = collider_group_reference.collider_group_uuid
+            if not collider_group_uuid:
+                continue
+            if collider_group_uuid in collider_group_uuids:
+                collider_group_uuids.remove(collider_group_uuid)
+                continue
+            _logger.error(
+                'Collider group with uuid "%s" not found or duplicated for'
+                ' "%s". Clearing UUID.',
+                collider_group_uuid,
+                collider_group_reference.path_from_id(),
+            )
+            collider_group_reference.collider_group_uuid = ""
+
+    # for UI
+    show_expanded: BoolProperty()  # type: ignore[valid-type]
+    show_expanded_bones: BoolProperty(  # type: ignore[valid-type]
+        name="Bones"
+    )
+    show_expanded_collider_groups: BoolProperty(  # type: ignore[valid-type]
+        name="Collider Groups"
+    )
+
+    active_joint_index: IntProperty(min=0)  # type: ignore[valid-type]
+    active_collider_group_index: IntProperty(min=0)  # type: ignore[valid-type]
+
+    animation_state: PointerProperty(  # type: ignore[valid-type]
+        type=SpringBone1SpringAnimationStatePropertyGroup
+    )
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        vrm_name: str  # type: ignore[no-redef]
+        joints: CollectionPropertyProtocol[  # type: ignore[no-redef]
+            SpringBone1JointPropertyGroup
+        ]
+        collider_groups: CollectionPropertyProtocol[  # type: ignore[no-redef]
+            SpringBone1ColliderGroupReferencePropertyGroup
+        ]
+        center: BonePropertyGroup  # type: ignore[no-redef]
+        show_expanded: bool  # type: ignore[no-redef]
+        show_expanded_bones: bool  # type: ignore[no-redef]
+        show_expanded_collider_groups: bool  # type: ignore[no-redef]
+        active_joint_index: int  # type: ignore[no-redef]
+        active_collider_group_index: int  # type: ignore[no-redef]
+        animation_state: (  # type: ignore[no-redef]
+            SpringBone1SpringAnimationStatePropertyGroup
+        )
+
+
+# https://github.com/vrm-c/vrm-specification/blob/6fb6baaf9b9095a84fb82c8384db36e1afeb3558/specification/VRMC_springBone-1.0-beta/schema/VRMC_springBone.schema.json
+class SpringBone1SpringBonePropertyGroup(PropertyGroup):
+    def add_collider(
+        self, context: Context, armature: Object
+    ) -> SpringBone1ColliderPropertyGroup:
+        collider = self.colliders.add()
+        collider.uuid = uuid.uuid4().hex
+        collider.shape.sphere.radius = 0.125
+        collider.reset_bpy_object(context, armature)
+        self.active_collider_index = len(self.colliders) - 1
+        return collider
+
+    def add_collider_group(self) -> SpringBone1ColliderGroupPropertyGroup:
+        collider_group = self.collider_groups.add()
+        collider_group.uuid = uuid.uuid4().hex
+        collider_group.vrm_name = "Collider Group"
+        self.active_collider_group_index = len(self.collider_groups) - 1
+        return collider_group
+
+    def add_spring(self) -> SpringBone1SpringPropertyGroup:
+        spring = self.springs.add()
+        spring.vrm_name = "Spring"
+        self.active_spring_index = len(self.springs) - 1
+        return spring
+
+    colliders: CollectionProperty(  # type: ignore[valid-type]
+        type=SpringBone1ColliderPropertyGroup,
+    )
+    collider_groups: CollectionProperty(  # type: ignore[valid-type]
+        type=SpringBone1ColliderGroupPropertyGroup,
+    )
+    springs: CollectionProperty(  # type: ignore[valid-type]
+        type=SpringBone1SpringPropertyGroup,
+    )
+
+    def _update_enable_animation(self, _context: Context) -> None:
+        for spring in self.springs:
+            for joint in spring.joints:
+                joint.animation_state.initialized_as_tail = False
+
+    enable_animation: BoolProperty(  # type: ignore[valid-type]
+        name="Enable Animation",
+        update=_update_enable_animation,
+    )
+
+    def fixup(self) -> None:
+        found_collider_uuids = set[str]()
+        for collider in self.colliders:
+            if not collider.uuid:
+                new_uuid = uuid.uuid4().hex
+                _logger.error(
+                    "Collider without uuid found. Generating a new uuid %s.", new_uuid
+                )
+                collider.uuid = new_uuid
+            if collider.uuid in found_collider_uuids:
+                new_uuid = uuid.uuid4().hex
+                _logger.error(
+                    "Collider with duplicated uuid found. Generating a new uuid %s.",
+                    new_uuid,
+                )
+                collider.uuid = new_uuid
+            found_collider_uuids.add(collider.uuid)
+
+        found_collider_group_uuids = set[str]()
+        for collider_group in self.collider_groups:
+            if not collider_group.uuid:
+                new_uuid = uuid.uuid4().hex
+                _logger.error(
+                    "Collider group without uuid found. Generating a new uuid %s.",
+                    new_uuid,
+                )
+                collider_group.uuid = new_uuid
+            if collider_group.uuid in found_collider_group_uuids:
+                new_uuid = uuid.uuid4().hex
+                _logger.error(
+                    "Collider group with duplicated uuid found."
+                    " Generating a new uuid %s.",
+                    new_uuid,
+                )
+                collider_group.uuid = new_uuid
+            found_collider_group_uuids.add(collider_group.uuid)
+            collider_group.fixup()
+
+        for spring in self.springs:
+            spring.fixup()
+
+    initial_automatic_spring_bone_assignment: BoolProperty(  # type: ignore[valid-type]
+        default=True,
+    )
+
+    # for UI
+    show_expanded_colliders: BoolProperty(  # type: ignore[valid-type]
+        name="Spring Bone Colliders"
+    )
+    show_expanded_collider_groups: BoolProperty(  # type: ignore[valid-type]
+        name="Spring Bone Collider Groups"
+    )
+    show_expanded_springs: BoolProperty(  # type: ignore[valid-type]
+        name="Spring Bone Springs"
+    )
+
+    active_collider_index: IntProperty(min=0)  # type: ignore[valid-type]
+    active_collider_group_index: IntProperty(min=0)  # type: ignore[valid-type]
+    active_spring_index: IntProperty(min=0)  # type: ignore[valid-type]
+
+    if TYPE_CHECKING:
+        # This code is auto generated.
+        # To regenerate, run the `uv run tools/property_typing.py` command.
+        colliders: CollectionPropertyProtocol[  # type: ignore[no-redef]
+            SpringBone1ColliderPropertyGroup
+        ]
+        collider_groups: CollectionPropertyProtocol[  # type: ignore[no-redef]
+            SpringBone1ColliderGroupPropertyGroup
+        ]
+        springs: CollectionPropertyProtocol[  # type: ignore[no-redef]
+            SpringBone1SpringPropertyGroup
+        ]
+        enable_animation: bool  # type: ignore[no-redef]
+        initial_automatic_spring_bone_assignment: bool  # type: ignore[no-redef]
+        show_expanded_colliders: bool  # type: ignore[no-redef]
+        show_expanded_collider_groups: bool  # type: ignore[no-redef]
+        show_expanded_springs: bool  # type: ignore[no-redef]
+        active_collider_index: int  # type: ignore[no-redef]
+        active_collider_group_index: int  # type: ignore[no-redef]
+        active_spring_index: int  # type: ignore[no-redef]