Merge remote-tracking branch 'origin/develop' into feat/mission-2

# Conflicts:
#	package-lock.json
#	package.json
#	src/App.tsx
#	src/components/three/interaction/CentralObject.tsx
#	src/components/three/interaction/VillageoisHelperObject.tsx
#	src/managers/GameStepManager.ts
#	src/stateManager/AudioManager.ts
#	src/world/World.tsx
#	src/world/player/PlayerController.tsx

src/world/World.tsx

@@ -1,55 +1,105 @@
-import { useState } from "react";
-import type { Octree } from "three/addons/math/Octree.js";
+import { Suspense } from "react";
+import { Physics } from "@react-three/rapier";
 import {
   PLAYER_SPAWN_POSITION_GAME,
   PLAYER_SPAWN_POSITION_PHYSICS,
-} from "@/data/playerConfig";
+} from "@/data/player/playerConfig";
 import { useCameraMode } from "@/hooks/debug/useCameraMode";
 import { useSceneMode } from "@/hooks/debug/useSceneMode";
+import { useHandTrackingSnapshot } from "@/hooks/handTracking/useHandTrackingSnapshot";
+import { useWorldSceneLoading } from "@/hooks/world/useWorldSceneLoading";
+import { GameFlow } from "@/components/game/GameFlow";
 import {
   ZoneDebugVisuals,
   ZoneDetection,
 } from "@/components/zone/ZoneDetection";
-import { GameFlow } from "@/components/game/GameFlow";
-import { CentralObject } from "@/components/3d/CentralObject";
-import { VillageoisHelperObject } from "@/components/3d/VillageoisHelperObject";
-import { DebugCameraControls } from "@/utils/debug/scene/DebugCameraControls";
-import { DebugHelpers } from "@/utils/debug/scene/DebugHelpers";
+import { DebugCameraControls } from "@/components/debug/scene/DebugCameraControls";
+import { DebugHelpers } from "@/components/debug/scene/DebugHelpers";
+import { HandTrackingGlove } from "@/components/three/handTracking/HandTrackingGlove";
+import { CentralObject } from "@/components/three/interaction/CentralObject";
+import { VillageoisHelperObject } from "@/components/three/interaction/VillageoisHelperObject";
 import { Environment } from "@/world/Environment";
+import { GameCinematics } from "@/world/GameCinematics";
+import { GameDialogues } from "@/world/GameDialogues";
+import { GameMusic } from "@/world/GameMusic";
 import { Lighting } from "@/world/Lighting";
-import { Map } from "@/world/Map";
-import { PlayerComponent } from "@/world/player/PlayerComponent";
-import { TestScene } from "@/world/debug/TestScene";
+import { GameMap } from "@/world/GameMap";
+import { GameStageContent } from "@/world/GameStageContent";
+import { Player } from "@/world/player/Player";
+import { TestMap } from "@/world/debug/TestMap";
+import type { SceneLoadingChangeHandler } from "@/types/world/sceneLoading";
 
-export function World(): React.JSX.Element {
+interface WorldProps {
+  onLoadingStateChange?: SceneLoadingChangeHandler | undefined;
+}
+
+function hasBootFlag(name: string): boolean {
+  if (typeof window === "undefined") return false;
+  return new URLSearchParams(window.location.search).has(name);
+}
+
+export function World({ onLoadingStateChange }: WorldProps): React.JSX.Element {
   const cameraMode = useCameraMode();
   const sceneMode = useSceneMode();
-  const [octree, setOctree] = useState<Octree | null>(null);
+  const { status, usageStatus } = useHandTrackingSnapshot();
+  const { octree, showGameStage, handleGameMapLoaded, handleOctreeReady } =
+    useWorldSceneLoading({ sceneMode, onLoadingStateChange });
+  const noCinematics = hasBootFlag("noCinematics");
+  const noDialogues = hasBootFlag("noDialogues");
+  const noMap = hasBootFlag("noMap");
+  const noMusic = hasBootFlag("noMusic");
+  const noOctree = hasBootFlag("noOctree");
+  const noPlayer = hasBootFlag("noPlayer");
   const playerSpawnPosition =
     sceneMode === "game"
       ? PLAYER_SPAWN_POSITION_GAME
       : PLAYER_SPAWN_POSITION_PHYSICS;
+  const showHandTrackingGloves =
+    sceneMode === "physics" ||
+    (status !== "idle" && usageStatus !== "inactive");
 
   return (
     <>
       <Environment />
       <Lighting />
       <DebugHelpers />
-      <ZoneDetection />
-      <ZoneDebugVisuals />
-      <GameFlow />
-      <VillageoisHelperObject position={[1, 12, -55]} />
-      <CentralObject position={[1, 15, -45]} />
+      {showHandTrackingGloves ? (
+        <Suspense fallback={null}>
+          <HandTrackingGlove handedness="left" />
+          <HandTrackingGlove handedness="right" />
+        </Suspense>
+      ) : null}
       {cameraMode === "debug" ? <DebugCameraControls /> : null}
-
       {sceneMode === "game" ? (
-        <Map onOctreeReady={setOctree} />
+        <>
+          <GameFlow />
+          <ZoneDetection />
+          <ZoneDebugVisuals />
+          <VillageoisHelperObject position={[1, 12, -55]} />
+          <CentralObject position={[1, 15, -45]} />
+          {noMusic ? null : <GameMusic />}
+          {noCinematics ? null : <GameCinematics />}
+          {noDialogues ? null : <GameDialogues />}
+          {noMap ? null : (
+            <GameMap
+              buildOctree={!noOctree}
+              onLoaded={handleGameMapLoaded}
+              onLoadingStateChange={onLoadingStateChange}
+              onOctreeReady={handleOctreeReady}
+            />
+          )}
+          {noMap || showGameStage ? (
+            <Physics>
+              <GameStageContent />
+            </Physics>
+          ) : null}
+        </>
       ) : (
-        <TestScene onOctreeReady={setOctree} />
+        <TestMap onOctreeReady={handleOctreeReady} />
       )}
 
-      {cameraMode !== "debug" ? (
-        <PlayerComponent octree={octree} spawnPosition={playerSpawnPosition} />
+      {cameraMode !== "debug" && !noPlayer ? (
+        <Player octree={octree} spawnPosition={playerSpawnPosition} />
       ) : null}
     </>
   );