refactor: split hooks types and utils by domain

src/components/three/gameplay/RepairCaseModel.tsx

@@ -14,8 +14,8 @@ import {
   REPAIR_CASE_OPEN_ROTATION_OFFSET_DEGREES,
   REPAIR_CASE_ROTATION_AMPLITUDE_DEGREES,
   REPAIR_CASE_ROTATION_RESET_SPEED,
-} from "@/data/repairGame/repairCaseConfig";
-import type { Vector3Tuple } from "@/types/three";
+} from "@/data/gameplay/repairCaseConfig";
+import type { Vector3Tuple } from "@/types/three/three";
 
 interface RepairCaseModelProps {
   modelPath: string;

src/components/three/gameplay/RepairCaseObject.tsx

@@ -1,12 +1,12 @@
 import { TriggerObject } from "@/components/three/interaction/TriggerObject";
-import { RepairCaseModel } from "@/components/three/gameplay/repairGame/RepairCaseModel";
+import { RepairCaseModel } from "@/components/three/gameplay/RepairCaseModel";
 import {
   REPAIR_CASE_CLOSE_SOUND_PATH,
   REPAIR_CASE_MODEL_PATH,
   REPAIR_CASE_OPEN_SOUND_PATH,
-} from "@/data/repairGame/repairCaseConfig";
+} from "@/data/gameplay/repairCaseConfig";
 import { AudioManager } from "@/managers/AudioManager";
-import type { Vector3Tuple } from "@/types/three";
+import type { Vector3Tuple } from "@/types/three/three";
 
 interface RepairCaseObjectProps {
   position: Vector3Tuple;

src/components/three/gameplay/RepairGameZone.tsx

@@ -1,13 +1,13 @@
 import { useState } from "react";
 import { Text } from "@react-three/drei";
-import { RepairCaseObject } from "@/components/three/gameplay/repairGame/RepairCaseObject";
-import { RepairModuleSlot } from "@/components/three/gameplay/repairGame/RepairModuleSlot";
+import { RepairCaseObject } from "@/components/three/gameplay/RepairCaseObject";
+import { RepairModuleSlot } from "@/components/three/gameplay/RepairModuleSlot";
 import {
   REPAIR_GAME_MODULE_SLOTS,
   REPAIR_GAME_ZONE_LABEL,
   REPAIR_GAME_ZONE_ORIGIN,
   REPAIR_GAME_ZONE_RADIUS,
-} from "@/data/repairGame/repairGameConfig";
+} from "@/data/gameplay/repairGameConfig";
 
 export function RepairGameZone(): React.JSX.Element {
   const [caseOpen, setCaseOpen] = useState(false);

src/components/three/gameplay/RepairModuleSlot.tsx

@@ -2,10 +2,10 @@ import { Html } from "@react-three/drei";
 import { useCallback, useState } from "react";
 import { TriggerObject } from "@/components/three/interaction/TriggerObject";
 import { ExplodableModel } from "@/components/three/models/ExplodableModel";
-import { REPAIR_GAME_MODEL_CATALOG } from "@/data/repairGame/repairGameModelCatalog";
-import type { ModelCatalogItem } from "@/data/repairGame/repairGameModelCatalog";
-import { useModelSelection } from "@/hooks/useModelSelection";
-import type { Vector3Tuple } from "@/types/three";
+import { REPAIR_GAME_MODEL_CATALOG } from "@/data/gameplay/repairGameModelCatalog";
+import type { ModelCatalogItem } from "@/data/gameplay/repairGameModelCatalog";
+import { useModelSelection } from "@/hooks/gameplay/useModelSelection";
+import type { Vector3Tuple } from "@/types/three/three";
 
 interface RepairModuleSlotProps {
   position: Vector3Tuple;

src/components/three/interaction/GrabbableObject.tsx

@@ -22,13 +22,13 @@ import {
 } from "@/data/interaction/grabConfig";
 import { INTERACTION_RADIUS } from "@/data/interaction/interactionConfig";
 import { useDebugFolder } from "@/hooks/debug/useDebugFolder";
-import { useHandTrackingSnapshot } from "@/hooks/useHandTrackingSnapshot";
+import { useHandTrackingSnapshot } from "@/hooks/handTracking/useHandTrackingSnapshot";
 import { InteractionManager } from "@/managers/InteractionManager";
 import type {
   HandTrackingHand,
   HandTrackingLandmark,
-} from "@/types/handTracking";
-import type { ColliderShape, Vector3Tuple } from "@/types/three";
+} from "@/types/handTracking/handTracking";
+import type { ColliderShape, Vector3Tuple } from "@/types/three/three";
 
 interface GrabbableObjectProps {
   position: Vector3Tuple;
@@ -38,7 +38,6 @@ interface GrabbableObjectProps {
   handControlled?: boolean;
 }
 
-// Shared params let one debug folder drive every instance.
 const grabDebugParams = {
   stiffness: GRAB_STIFFNESS_DEFAULT,
   throwBoost: GRAB_THROW_BOOST_DEFAULT,
@@ -74,10 +73,10 @@ function getHandCenterPoint(hand: HandTrackingHand): HandTrackingLandmark {
     return { x: hand.x, y: hand.y, z: hand.z };
   }
 
-  let minX = landmarks[0].x;
-  let maxX = landmarks[0].x;
-  let minY = landmarks[0].y;
-  let maxY = landmarks[0].y;
+  let minX = landmarks[0]!.x;
+  let maxX = landmarks[0]!.x;
+  let minY = landmarks[0]!.y;
+  let maxY = landmarks[0]!.y;
 
   landmarks.forEach((landmark) => {
     minX = Math.min(minX, landmark.x);
@@ -112,7 +111,7 @@ function getHandHit(
     _handRaycaster.far = INTERACTION_RADIUS;
 
     const hits = _handRaycaster.intersectObject(group, true);
-    if (hits.length > 0) return hits[0];
+    if (hits?.length > 0) return hits[0] ?? null;
   }
 
   return null;

src/components/three/interaction/InteractableObject.tsx

@@ -13,8 +13,8 @@ import { Debug } from "@/utils/debug/Debug";
 import { useDebugFolder } from "@/hooks/debug/useDebugFolder";
 import { InteractionManager } from "@/managers/InteractionManager";
 import { INTERACTION_RADIUS } from "@/data/interaction/interactionConfig";
-import type { Vector3Tuple } from "@/types/three";
-import type { InteractableHandle } from "@/types/interaction";
+import type { InteractableHandle } from "@/types/interaction/interaction";
+import type { Vector3Tuple } from "@/types/three/three";
 
 interface InteractableObjectBaseProps {
   label: string;

src/components/three/interaction/TriggerObject.tsx

@@ -9,7 +9,7 @@ import {
   TRIGGER_DEFAULT_SPAWN_OFFSET,
 } from "@/data/interaction/triggerConfig";
 import { AudioManager } from "@/managers/AudioManager";
-import type { ColliderShape, Vector3Tuple } from "@/types/three";
+import type { ColliderShape, Vector3Tuple } from "@/types/three/three";
 
 interface SpawnedModel {
   id: number;

src/components/three/models/AnimatedModel.tsx

@@ -6,7 +6,7 @@ import {
   AnimatedModelContext,
   type AnimatedModelContextValue,
 } from "@/components/three/models/useAnimatedModel";
-import type { Vector3Tuple } from "@/types/three";
+import type { Vector3Tuple } from "@/types/three/three";
 
 export interface AnimatedModelConfig {
   modelPath: string;

src/components/three/models/ExplodableModel.tsx

@@ -2,8 +2,8 @@ import type { ReactNode } from "react";
 import { Component, useEffect, useMemo } from "react";
 import { useFrame } from "@react-three/fiber";
 import { useGLTF } from "@react-three/drei";
-import { ExplodedModel } from "@/utils/ExplodedModel";
-import type { Vector3Tuple } from "@/types/three";
+import { ExplodedModel } from "@/utils/three/ExplodedModel";
+import type { Vector3Tuple } from "@/types/three/three";
 
 interface ModelErrorBoundaryProps {
   children: ReactNode;
@@ -52,7 +52,7 @@ export function ExplodableModel(
   return (
     <ModelErrorBoundary
       key={props.modelPath}
-      fallback={<MissingModelFallback position={props.position} />}
+      fallback={<MissingModelFallback position={props.position ?? [0, 0, 0]} />}
     >
       <ExplodableModelInner {...props} />
     </ModelErrorBoundary>

src/components/three/models/SimpleModel.tsx

@@ -1,6 +1,6 @@
 import { useMemo } from "react";
 import { useGLTF } from "@react-three/drei";
-import type { Vector3Tuple } from "@/types/three";
+import type { Vector3Tuple } from "@/types/three/three";
 
 export interface SimpleModelConfig {
   modelPath: string;