refactor: split hooks types and utils by domain

src/components/debug/scene/DebugCameraControls.tsx

@@ -8,7 +8,7 @@ import {
   PLAYER_EYE_HEIGHT,
   PLAYER_SPAWN_POSITION_GAME,
 } from "@/data/player/playerConfig";
-import type { Vector3Tuple } from "@/types/three";
+import type { Vector3Tuple } from "@/types/three/three";
 
 const DEBUG_CAMERA_TARGET: Vector3Tuple = [
   PLAYER_SPAWN_POSITION_GAME[0],

src/components/editor/EditorControls.tsx

@@ -12,7 +12,7 @@ import {
   Save,
   Undo2,
 } from "lucide-react";
-import type { MapNode, TransformMode } from "@/types/editor";
+import type { MapNode, TransformMode } from "@/types/editor/editor";
 
 interface EditorControlsProps {
   transformMode: TransformMode;

src/components/editor/scene/EditorMap.tsx

@@ -3,7 +3,7 @@ import { Grid, TransformControls, useGLTF } from "@react-three/drei";
 import type { ThreeEvent } from "@react-three/fiber";
 import * as THREE from "three";
 
-import type { SceneData, MapNode, TransformMode } from "@/types/editor";
+import type { SceneData, MapNode, TransformMode } from "@/types/editor/editor";
 
 interface EditorMapProps {
   sceneData: SceneData;

src/components/editor/scene/EditorScene.tsx

@@ -2,7 +2,7 @@ import { useEffect } from "react";
 import { OrbitControls } from "@react-three/drei";
 import { EditorMap } from "@/components/editor/scene/EditorMap";
 import { FlyController } from "@/controls/editor/FlyController";
-import type { MapNode, TransformMode, SceneData } from "@/types/editor";
+import type { MapNode, TransformMode, SceneData } from "@/types/editor/editor";
 
 interface EditorSceneProps {
   sceneData: SceneData;

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;

src/components/ui/Crosshair.tsx

@@ -1,5 +1,5 @@
 import { useCameraMode } from "@/hooks/debug/useCameraMode";
-import { useInteraction } from "@/hooks/useInteraction";
+import { useInteraction } from "@/hooks/interaction/useInteraction";
 
 export function Crosshair(): React.JSX.Element | null {
   const cameraMode = useCameraMode();

src/components/ui/HandTrackingOverlay.tsx

@@ -1,5 +1,5 @@
-import { useHandTrackingSnapshot } from "@/hooks/useHandTrackingSnapshot";
-import type { HandTrackingStatus } from "@/types/handTracking";
+import { useHandTrackingSnapshot } from "@/hooks/handTracking/useHandTrackingSnapshot";
+import type { HandTrackingStatus } from "@/types/handTracking/handTracking";
 
 const STATUS_LABELS: Record<HandTrackingStatus, string> = {
   idle: "Idle",

src/components/ui/HandTrackingProvider.tsx

@@ -1,27 +0,0 @@
-import type { ReactNode } from "react";
-import { useSceneMode } from "@/hooks/debug/useSceneMode";
-import { useInteraction } from "@/hooks/useInteraction";
-import {
-  HAND_TRACKING_IDLE_SNAPSHOT,
-  HandTrackingContext,
-} from "@/hooks/useHandTrackingSnapshot";
-import { useRemoteHandTracking } from "@/hooks/useRemoteHandTracking";
-
-export function HandTrackingProvider({
-  children,
-}: {
-  children: ReactNode;
-}): React.JSX.Element {
-  const sceneMode = useSceneMode();
-  const { nearby, holding, handHolding } = useInteraction();
-  const enabled = sceneMode === "physics" && (nearby || holding || handHolding);
-  const snapshot = useRemoteHandTracking({ enabled });
-
-  return (
-    <HandTrackingContext
-      value={enabled ? snapshot : HAND_TRACKING_IDLE_SNAPSHOT}
-    >
-      {children}
-    </HandTrackingContext>
-  );
-}

src/components/ui/HandTrackingVisualizer.tsx

@@ -1,4 +1,4 @@
-import { useHandTrackingSnapshot } from "@/hooks/useHandTrackingSnapshot";
+import { useHandTrackingSnapshot } from "@/hooks/handTracking/useHandTrackingSnapshot";
 
 const HAND_CONNECTIONS: Array<[number, number]> = [
   [0, 1],

src/components/ui/InteractPrompt.tsx

@@ -1,6 +1,6 @@
 import { INTERACT_KEY } from "@/data/input/keybindings";
 import { useCameraMode } from "@/hooks/debug/useCameraMode";
-import { useInteraction } from "@/hooks/useInteraction";
+import { useInteraction } from "@/hooks/interaction/useInteraction";
 
 export function InteractPrompt(): React.JSX.Element | null {
   const cameraMode = useCameraMode();