blacktrigram 0.7.2

package/lib/components/screens/combat/hooks/useCombatAudio.js

@@ -0,0 +1,287 @@
+import { useAudio } from "../../../../audio/AudioProvider.js";
+import { calculateImpactIntensity, detectAudioBodyRegion, getBoneImpactSoundId, getImpactVolumeMultiplier } from "../../../../audio/BoneImpactAudioMap.js";
+import { useCallback, useEffect, useRef } from "react";
+//#region src/components/screens/combat/hooks/useCombatAudio.ts
+/**
+* Combat Audio Hook for Black Trigram
+* Provides comprehensive audio feedback for combat actions including
+* bone impact sounds, fracture audio, and body-region-specific hit sounds
+*/
+/**
+* Maximum number of simultaneous sounds to prevent audio chaos
+*/
+var MAX_SIMULTANEOUS_SOUNDS = 5;
+/**
+* Combat audio hook for playing attack, hit, block, dodge, and stance sounds
+* @returns Object with methods for playing various combat sounds
+*/
+var useCombatAudio = () => {
+	const audio = useAudio();
+	const lastPlayTime = useRef({});
+	const activeSounds = useRef(/* @__PURE__ */ new Set());
+	const timeoutIds = useRef(/* @__PURE__ */ new Set());
+	useEffect(() => {
+		const timeoutIdsSet = timeoutIds.current;
+		return () => {
+			timeoutIdsSet.forEach(clearTimeout);
+			timeoutIdsSet.clear();
+		};
+	}, []);
+	/**
+	* Check if we can play a sound (rate limiting and simultaneous sound check)
+	* @param soundType - Type of sound to check
+	* @param minInterval - Minimum interval between plays in milliseconds
+	* @returns True if sound can be played
+	*/
+	const canPlaySound = useCallback((soundType, minInterval = 50) => {
+		if (Date.now() - (lastPlayTime.current[soundType] ?? 0) < minInterval) return false;
+		if (activeSounds.current.size >= MAX_SIMULTANEOUS_SOUNDS) return false;
+		return true;
+	}, []);
+	/**
+	* Register a sound as active and auto-remove after duration
+	* @param soundId - ID of the sound to register
+	* @param duration - Duration in milliseconds (default 500ms)
+	*/
+	const registerActiveSound = useCallback((soundId, duration = 500) => {
+		activeSounds.current.add(soundId);
+		const timeoutId = setTimeout(() => {
+			activeSounds.current.delete(soundId);
+			timeoutIds.current.delete(timeoutId);
+		}, duration);
+		timeoutIds.current.add(timeoutId);
+	}, []);
+	/**
+	* Get a random variant from a pool
+	* @param base - Base sound ID
+	* @param count - Number of variants
+	* @returns Random variant ID
+	*/
+	const getRandomVariant = useCallback((base, count) => {
+		return `${base}_${Math.floor(Math.random() * count) + 1}`;
+	}, []);
+	/**
+	* Play attack sound based on intensity
+	* @param intensity - Attack intensity (light, medium, heavy, critical)
+	*/
+	const playAttackSound = useCallback(async (intensity = "light") => {
+		const soundType = `attack_${intensity}`;
+		if (!canPlaySound(soundType)) return;
+		let soundId;
+		switch (intensity) {
+			case "light":
+				soundId = getRandomVariant("attack_punch_light", 8);
+				break;
+			case "medium":
+				soundId = getRandomVariant("attack_punch_medium", 4);
+				break;
+			case "heavy":
+				soundId = "attack_heavy";
+				break;
+			case "critical":
+				soundId = getRandomVariant("attack_critical", 4);
+				break;
+			default:
+				console.warn(`Unknown attack intensity: ${intensity}, defaulting to light`);
+				soundId = getRandomVariant("attack_punch_light", 8);
+		}
+		try {
+			await audio.playSFX(soundId);
+			lastPlayTime.current[soundType] = Date.now();
+			registerActiveSound(soundId, 400);
+		} catch (error) {
+			console.warn(`Failed to play attack sound: ${soundId}`, error);
+		}
+	}, [
+		audio,
+		canPlaySound,
+		getRandomVariant,
+		registerActiveSound
+	]);
+	/**
+	* Play hit reaction sound based on damage amount
+	* @param damage - Damage amount to determine hit intensity
+	*/
+	const playHitSound = useCallback(async (damage) => {
+		const soundType = "hit";
+		if (!canPlaySound(soundType, 100)) return;
+		let soundId;
+		if (damage >= 40) soundId = getRandomVariant("hit_critical", 4);
+		else if (damage >= 25) soundId = getRandomVariant("hit_heavy", 4);
+		else if (damage >= 10) soundId = getRandomVariant("hit_medium", 4);
+		else soundId = getRandomVariant("hit_light", 4);
+		try {
+			await audio.playSFX(soundId);
+			lastPlayTime.current[soundType] = Date.now();
+			registerActiveSound(soundId, 500);
+		} catch (error) {
+			console.warn(`Failed to play hit sound: ${soundId}`, error);
+		}
+	}, [
+		audio,
+		canPlaySound,
+		getRandomVariant,
+		registerActiveSound
+	]);
+	/**
+	* Play block/parry sound
+	* @param guardBroken - Whether the guard was broken or successfully blocked
+	*/
+	const playBlockSound = useCallback(async (guardBroken = false) => {
+		const soundType = "block";
+		if (!canPlaySound(soundType, 150)) return;
+		let soundId;
+		if (guardBroken) soundId = getRandomVariant("block_break", 4);
+		else soundId = getRandomVariant("block_success", 4);
+		try {
+			await audio.playSFX(soundId);
+			lastPlayTime.current[soundType] = Date.now();
+			registerActiveSound(soundId, 400);
+		} catch (error) {
+			console.warn(`Failed to play block sound: ${soundId}`, error);
+		}
+	}, [
+		audio,
+		canPlaySound,
+		getRandomVariant,
+		registerActiveSound
+	]);
+	/**
+	* Play dodge sound
+	*/
+	const playDodgeSound = useCallback(async () => {
+		const soundType = "dodge";
+		if (!canPlaySound(soundType, 200)) return;
+		const soundId = getRandomVariant("dodge", 8);
+		try {
+			await audio.playSFX(soundId);
+			lastPlayTime.current[soundType] = Date.now();
+			registerActiveSound(soundId, 300);
+		} catch (error) {
+			console.warn(`Failed to play dodge sound: ${soundId}`, error);
+		}
+	}, [
+		audio,
+		canPlaySound,
+		getRandomVariant,
+		registerActiveSound
+	]);
+	/**
+	* Play stance change sound
+	*/
+	const playStanceChangeSound = useCallback(async () => {
+		const soundType = "stance";
+		if (!canPlaySound(soundType, 250)) return;
+		const soundId = getRandomVariant("stance_change", 4);
+		try {
+			await audio.playSFX(soundId);
+			lastPlayTime.current[soundType] = Date.now();
+			registerActiveSound(soundId, 400);
+		} catch (error) {
+			console.warn(`Failed to play stance change sound: ${soundId}`, error);
+		}
+	}, [
+		audio,
+		canPlaySound,
+		getRandomVariant,
+		registerActiveSound
+	]);
+	/**
+	* Play special technique sound (e.g., Geon special)
+	*/
+	const playSpecialTechniqueSound = useCallback(async () => {
+		const soundType = "special";
+		if (!canPlaySound(soundType, 300)) return;
+		const soundId = getRandomVariant("attack_special_geon", 4);
+		try {
+			await audio.playSFX(soundId, .8);
+			lastPlayTime.current[soundType] = Date.now();
+			registerActiveSound(soundId, 600);
+		} catch (error) {
+			console.warn(`Failed to play special technique sound: ${soundId}`, error);
+		}
+	}, [
+		audio,
+		canPlaySound,
+		getRandomVariant,
+		registerActiveSound
+	]);
+	/**
+	* Play combat theme music with fade-in
+	* @param fadeInDuration - Fade-in duration in milliseconds
+	*/
+	const playCombatMusic = useCallback(async (fadeInDuration = 2e3) => {
+		try {
+			await audio.fadeIn("combat_theme", fadeInDuration);
+		} catch (error) {
+			console.warn("Failed to play combat music", error);
+		}
+	}, [audio]);
+	return {
+		playAttackSound,
+		playHitSound,
+		playBlockSound,
+		playDodgeSound,
+		playStanceChangeSound,
+		playSpecialTechniqueSound,
+		playCombatMusic,
+		playArchetypeMusic: useCallback(async (archetype, fadeInDuration = 2e3) => {
+			const musicId = {
+				musa: "musa_warrior_theme",
+				amsalja: "amsalja_shadow_theme",
+				hacker: "hacker_cyber_theme",
+				jeongbo_yowon: "jeongbo_intel_theme",
+				jojik_pokryeokbae: "jojik_street_theme"
+			}[archetype.toLowerCase()];
+			if (!musicId) {
+				console.warn(`Unknown archetype: ${archetype}, using combat theme`);
+				await playCombatMusic(fadeInDuration);
+				return;
+			}
+			try {
+				await audio.fadeIn(musicId, fadeInDuration);
+			} catch (error) {
+				console.warn(`Failed to play archetype music: ${musicId}`, error);
+				await playCombatMusic(fadeInDuration);
+			}
+		}, [audio, playCombatMusic]),
+		stopCombatMusic: useCallback(async (fadeOutDuration = 2e3) => {
+			try {
+				await audio.fadeOut(fadeOutDuration);
+			} catch (error) {
+				console.warn("Failed to stop combat music", error);
+			}
+		}, [audio]),
+		getActiveSoundCount: useCallback(() => {
+			return activeSounds.current.size;
+		}, []),
+		playBoneImpactSound: useCallback(async (options) => {
+			const soundType = "bone_impact";
+			if (!canPlaySound(soundType, 100)) return;
+			let region = options.region;
+			if (!region && options.hitPosition) region = detectAudioBodyRegion(options.hitPosition);
+			region ??= "torso";
+			let intensity = options.intensity;
+			if (!intensity && options.damage !== void 0) intensity = calculateImpactIntensity(options.damage, options.remainingHealth, options.vitalPoint);
+			intensity ??= "medium";
+			const soundId = getBoneImpactSoundId(region, intensity, true);
+			const volumeMultiplier = getImpactVolumeMultiplier(intensity);
+			const finalVolume = Math.min(1, .8 * volumeMultiplier);
+			try {
+				await audio.playSFX(soundId, finalVolume);
+				lastPlayTime.current[soundType] = Date.now();
+				registerActiveSound(soundId, intensity === "fracture" ? 800 : 500);
+			} catch (error) {
+				console.warn(`Failed to play bone impact sound: ${soundId} (region: ${region}, intensity: ${intensity})`, error);
+			}
+		}, [
+			audio,
+			canPlaySound,
+			registerActiveSound
+		])
+	};
+};
+//#endregion
+export { useCombatAudio as default };
+
+//# sourceMappingURL=useCombatAudio.js.map

package/lib/components/screens/combat/hooks/useCombatAudio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCombatAudio.js","names":[],"sources":["../../../../../src/components/screens/combat/hooks/useCombatAudio.ts"],"sourcesContent":["/**\n * Combat Audio Hook for Black Trigram\n * Provides comprehensive audio feedback for combat actions including\n * bone impact sounds, fracture audio, and body-region-specific hit sounds\n */\n\nimport { useCallback, useEffect, useRef } from \"react\";\nimport { useAudio } from \"../../../../audio/AudioProvider\";\nimport {\n  calculateImpactIntensity,\n  detectAudioBodyRegion,\n  getBoneImpactSoundId,\n  getImpactVolumeMultiplier,\n} from \"../../../../audio/BoneImpactAudioMap\";\nimport { AudioBodyRegion, ImpactIntensity } from \"../../../../audio/types\";\n\n/**\n * Attack intensity levels for sound selection\n */\nexport type AttackIntensity = \"light\" | \"medium\" | \"heavy\" | \"critical\";\n\n/**\n * Maximum number of simultaneous sounds to prevent audio chaos\n */\nconst MAX_SIMULTANEOUS_SOUNDS = 5;\n\n/**\n * Combat audio hook for playing attack, hit, block, dodge, and stance sounds\n * @returns Object with methods for playing various combat sounds\n */\nexport const useCombatAudio = () => {\n  const audio = useAudio();\n  const lastPlayTime = useRef<Record<string, number>>({});\n  const activeSounds = useRef(new Set<string>());\n  const timeoutIds = useRef<Set<NodeJS.Timeout>>(new Set());\n\n  // Cleanup all timeouts on unmount\n  useEffect(() => {\n    // Copy ref value to local variable for cleanup\n    const timeoutIdsSet = timeoutIds.current;\n    return () => {\n      timeoutIdsSet.forEach(clearTimeout);\n      timeoutIdsSet.clear();\n    };\n  }, []);\n\n  /**\n   * Check if we can play a sound (rate limiting and simultaneous sound check)\n   * @param soundType - Type of sound to check\n   * @param minInterval - Minimum interval between plays in milliseconds\n   * @returns True if sound can be played\n   */\n  const canPlaySound = useCallback(\n    (soundType: string, minInterval = 50): boolean => {\n      const now = Date.now();\n      const lastTime = lastPlayTime.current[soundType] ?? 0;\n\n      // Rate limiting check\n      if (now - lastTime < minInterval) {\n        return false;\n      }\n\n      // Check simultaneous sounds limit\n      if (activeSounds.current.size >= MAX_SIMULTANEOUS_SOUNDS) {\n        return false;\n      }\n\n      return true;\n    },\n    [],\n  );\n\n  /**\n   * Register a sound as active and auto-remove after duration\n   * @param soundId - ID of the sound to register\n   * @param duration - Duration in milliseconds (default 500ms)\n   */\n  const registerActiveSound = useCallback((soundId: string, duration = 500) => {\n    activeSounds.current.add(soundId);\n    const timeoutId = setTimeout(() => {\n      activeSounds.current.delete(soundId);\n      timeoutIds.current.delete(timeoutId);\n    }, duration);\n    timeoutIds.current.add(timeoutId);\n  }, []);\n\n  /**\n   * Get a random variant from a pool\n   * @param base - Base sound ID\n   * @param count - Number of variants\n   * @returns Random variant ID\n   */\n  const getRandomVariant = useCallback(\n    (base: string, count: number): string => {\n      const variant = Math.floor(Math.random() * count) + 1;\n      return `${base}_${variant}`;\n    },\n    [],\n  );\n\n  /**\n   * Play attack sound based on intensity\n   * @param intensity - Attack intensity (light, medium, heavy, critical)\n   */\n  const playAttackSound = useCallback(\n    async (intensity: AttackIntensity = \"light\") => {\n      const soundType = `attack_${intensity}`;\n\n      if (!canPlaySound(soundType)) {\n        return;\n      }\n\n      let soundId: string;\n\n      switch (intensity) {\n        case \"light\":\n          // 8 variations of light punch sounds\n          soundId = getRandomVariant(\"attack_punch_light\", 8);\n          break;\n        case \"medium\":\n          // 4 variations of medium punch sounds\n          soundId = getRandomVariant(\"attack_punch_medium\", 4);\n          break;\n        case \"heavy\":\n          soundId = \"attack_heavy\";\n          break;\n        case \"critical\":\n          // 4 variations of critical attack sounds\n          soundId = getRandomVariant(\"attack_critical\", 4);\n          break;\n        default:\n          console.warn(\n            `Unknown attack intensity: ${intensity}, defaulting to light`,\n          );\n          soundId = getRandomVariant(\"attack_punch_light\", 8);\n      }\n\n      try {\n        await audio.playSFX(soundId);\n        lastPlayTime.current[soundType] = Date.now();\n        registerActiveSound(soundId, 400);\n      } catch (error) {\n        console.warn(`Failed to play attack sound: ${soundId}`, error);\n      }\n    },\n    [audio, canPlaySound, getRandomVariant, registerActiveSound],\n  );\n\n  /**\n   * Play hit reaction sound based on damage amount\n   * @param damage - Damage amount to determine hit intensity\n   */\n  const playHitSound = useCallback(\n    async (damage: number) => {\n      const soundType = \"hit\";\n\n      if (!canPlaySound(soundType, 100)) {\n        return;\n      }\n\n      let soundId: string;\n\n      // Determine hit intensity based on damage\n      if (damage >= 40) {\n        // Critical hit (4 variations)\n        soundId = getRandomVariant(\"hit_critical\", 4);\n      } else if (damage >= 25) {\n        // Heavy hit (4 variations)\n        soundId = getRandomVariant(\"hit_heavy\", 4);\n      } else if (damage >= 10) {\n        // Medium hit (4 variations)\n        soundId = getRandomVariant(\"hit_medium\", 4);\n      } else {\n        // Light hit (4 variations)\n        soundId = getRandomVariant(\"hit_light\", 4);\n      }\n\n      try {\n        await audio.playSFX(soundId);\n        lastPlayTime.current[soundType] = Date.now();\n        registerActiveSound(soundId, 500);\n      } catch (error) {\n        console.warn(`Failed to play hit sound: ${soundId}`, error);\n      }\n    },\n    [audio, canPlaySound, getRandomVariant, registerActiveSound],\n  );\n\n  /**\n   * Play block/parry sound\n   * @param guardBroken - Whether the guard was broken or successfully blocked\n   */\n  const playBlockSound = useCallback(\n    async (guardBroken: boolean = false) => {\n      const soundType = \"block\";\n\n      if (!canPlaySound(soundType, 150)) {\n        return;\n      }\n\n      let soundId: string;\n\n      if (guardBroken) {\n        // 4 variations of guard break sounds\n        soundId = getRandomVariant(\"block_break\", 4);\n      } else {\n        // 4 variations of successful block sounds\n        soundId = getRandomVariant(\"block_success\", 4);\n      }\n\n      try {\n        await audio.playSFX(soundId);\n        lastPlayTime.current[soundType] = Date.now();\n        registerActiveSound(soundId, 400);\n      } catch (error) {\n        console.warn(`Failed to play block sound: ${soundId}`, error);\n      }\n    },\n    [audio, canPlaySound, getRandomVariant, registerActiveSound],\n  );\n\n  /**\n   * Play dodge sound\n   */\n  const playDodgeSound = useCallback(async () => {\n    const soundType = \"dodge\";\n\n    if (!canPlaySound(soundType, 200)) {\n      return;\n    }\n\n    // 8 variations of dodge sounds\n    const soundId = getRandomVariant(\"dodge\", 8);\n\n    try {\n      await audio.playSFX(soundId);\n      lastPlayTime.current[soundType] = Date.now();\n      registerActiveSound(soundId, 300);\n    } catch (error) {\n      console.warn(`Failed to play dodge sound: ${soundId}`, error);\n    }\n  }, [audio, canPlaySound, getRandomVariant, registerActiveSound]);\n\n  /**\n   * Play stance change sound\n   */\n  const playStanceChangeSound = useCallback(async () => {\n    const soundType = \"stance\";\n\n    if (!canPlaySound(soundType, 250)) {\n      return;\n    }\n\n    // 4 variations of stance change sounds\n    const soundId = getRandomVariant(\"stance_change\", 4);\n\n    try {\n      await audio.playSFX(soundId);\n      lastPlayTime.current[soundType] = Date.now();\n      registerActiveSound(soundId, 400);\n    } catch (error) {\n      console.warn(`Failed to play stance change sound: ${soundId}`, error);\n    }\n  }, [audio, canPlaySound, getRandomVariant, registerActiveSound]);\n\n  /**\n   * Play special technique sound (e.g., Geon special)\n   */\n  const playSpecialTechniqueSound = useCallback(async () => {\n    const soundType = \"special\";\n\n    if (!canPlaySound(soundType, 300)) {\n      return;\n    }\n\n    // 4 variations of special Geon technique sounds\n    const soundId = getRandomVariant(\"attack_special_geon\", 4);\n\n    try {\n      await audio.playSFX(soundId, 0.8);\n      lastPlayTime.current[soundType] = Date.now();\n      registerActiveSound(soundId, 600);\n    } catch (error) {\n      console.warn(`Failed to play special technique sound: ${soundId}`, error);\n    }\n  }, [audio, canPlaySound, getRandomVariant, registerActiveSound]);\n\n  /**\n   * Play combat theme music with fade-in\n   * @param fadeInDuration - Fade-in duration in milliseconds\n   */\n  const playCombatMusic = useCallback(\n    async (fadeInDuration: number = 2000) => {\n      try {\n        await audio.fadeIn(\"combat_theme\", fadeInDuration);\n      } catch (error) {\n        console.warn(\"Failed to play combat music\", error);\n      }\n    },\n    [audio],\n  );\n\n  /**\n   * Play archetype-specific music theme\n   * @param archetype - Player archetype (musa, amsalja, hacker, jeongbo_yowon, jojik_pokryeokbae)\n   * @param fadeInDuration - Fade-in duration in milliseconds\n   */\n  const playArchetypeMusic = useCallback(\n    async (archetype: string, fadeInDuration: number = 2000) => {\n      const archetypeMap: Record<string, string> = {\n        musa: \"musa_warrior_theme\",\n        amsalja: \"amsalja_shadow_theme\",\n        hacker: \"hacker_cyber_theme\",\n        jeongbo_yowon: \"jeongbo_intel_theme\",\n        jojik_pokryeokbae: \"jojik_street_theme\",\n      };\n\n      const musicId = archetypeMap[archetype.toLowerCase()];\n\n      if (!musicId) {\n        console.warn(`Unknown archetype: ${archetype}, using combat theme`);\n        await playCombatMusic(fadeInDuration);\n        return;\n      }\n\n      try {\n        await audio.fadeIn(musicId, fadeInDuration);\n      } catch (error) {\n        console.warn(`Failed to play archetype music: ${musicId}`, error);\n        // Fallback to combat theme\n        await playCombatMusic(fadeInDuration);\n      }\n    },\n    [audio, playCombatMusic],\n  );\n\n  /**\n   * Stop combat music with fade-out\n   * @param fadeOutDuration - Fade-out duration in milliseconds\n   */\n  const stopCombatMusic = useCallback(\n    async (fadeOutDuration: number = 2000) => {\n      try {\n        await audio.fadeOut(fadeOutDuration);\n      } catch (error) {\n        console.warn(\"Failed to stop combat music\", error);\n      }\n    },\n    [audio],\n  );\n\n  /**\n   * Get number of currently active sounds\n   * @returns Number of active sounds\n   */\n  const getActiveSoundCount = useCallback((): number => {\n    return activeSounds.current.size;\n  }, []);\n\n  /**\n   * Play bone impact sound with body region and intensity awareness\n   * Implements realistic bone/flesh audio with fracture detection\n   *\n   * @param options - Bone impact event parameters\n   * @param options.region - Body region struck (head, torso, arms, legs, soft_tissue)\n   * @param options.intensity - Impact intensity (auto-calculated if omitted)\n   * @param options.damage - Damage amount (for intensity calculation)\n   * @param options.remainingHealth - Target's remaining health (for fracture detection)\n   * @param options.vitalPoint - Whether strike hit a vital point\n   * @param options.hitPosition - 3D position of strike (for auto region detection)\n   *\n   * @example\n   * // Explicit region and intensity\n   * playBoneImpactSound({ region: 'head', intensity: 'heavy' });\n   *\n   * @example\n   * // Auto-calculate intensity from damage and health\n   * playBoneImpactSound({\n   *   region: 'torso',\n   *   damage: 35,\n   *   remainingHealth: 25,\n   *   vitalPoint: false\n   * });\n   *\n   * @example\n   * // Auto-detect region from 3D hit position\n   * playBoneImpactSound({\n   *   damage: 40,\n   *   remainingHealth: 60,\n   *   hitPosition: { x: 0.1, y: 1.8, z: 0 }\n   * });\n   */\n  const playBoneImpactSound = useCallback(\n    async (options: {\n      region?: AudioBodyRegion;\n      intensity?: ImpactIntensity;\n      damage?: number;\n      remainingHealth?: number;\n      vitalPoint?: boolean;\n      hitPosition?: { x: number; y: number; z?: number };\n    }) => {\n      const soundType = \"bone_impact\";\n\n      if (!canPlaySound(soundType, 100)) {\n        return;\n      }\n\n      // Auto-detect region from hit position if not provided\n      let region = options.region;\n      if (!region && options.hitPosition) {\n        region = detectAudioBodyRegion(options.hitPosition);\n      }\n\n      // Default to torso if region still undefined\n      region ??= \"torso\";\n\n      // Auto-calculate intensity if not provided\n      let intensity = options.intensity;\n      if (!intensity && options.damage !== undefined) {\n        intensity = calculateImpactIntensity(\n          options.damage,\n          options.remainingHealth,\n          options.vitalPoint,\n        );\n      }\n\n      // Default to medium intensity if still undefined\n      intensity ??= \"medium\";\n\n      // Get appropriate sound ID with random variant\n      const soundId = getBoneImpactSoundId(region, intensity, true);\n\n      // Get volume multiplier based on intensity\n      const volumeMultiplier = getImpactVolumeMultiplier(intensity);\n      const finalVolume = Math.min(1.0, 0.8 * volumeMultiplier);\n\n      try {\n        await audio.playSFX(soundId, finalVolume);\n        lastPlayTime.current[soundType] = Date.now();\n\n        // Longer active duration for fracture sounds (more impactful)\n        const duration = intensity === \"fracture\" ? 800 : 500;\n        registerActiveSound(soundId, duration);\n      } catch (error) {\n        console.warn(\n          `Failed to play bone impact sound: ${soundId} (region: ${region}, intensity: ${intensity})`,\n          error,\n        );\n      }\n    },\n    [audio, canPlaySound, registerActiveSound],\n  );\n\n  return {\n    playAttackSound,\n    playHitSound,\n    playBlockSound,\n    playDodgeSound,\n    playStanceChangeSound,\n    playSpecialTechniqueSound,\n    playCombatMusic,\n    playArchetypeMusic,\n    stopCombatMusic,\n    getActiveSoundCount,\n    playBoneImpactSound, // NEW: Body-region-specific bone/flesh impact sounds\n  };\n};\n\nexport default useCombatAudio;\n"],"mappings":"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"}

package/lib/components/screens/combat/hooks/useCombatLayout.d.ts

@@ -0,0 +1,61 @@
+/**
+ * useCombatLayout Hook - Enhanced Responsive Combat Layout
+ *
+ * Custom hook for managing responsive combat screen layout calculations with
+ * comprehensive support for all screen sizes from mobile to ultra-wide displays.
+ *
+ * Enhanced Features:
+ * - Five screen size categories (mobile, tablet, desktop, large, xlarge)
+ * - Proportional scaling for consistent sizing across devices
+ * - Optimized arena sizing for each device category
+ * - Smooth transitions for resize operations
+ * - 60fps performance maintained
+ *
+ * Uses robust device detection combining user-agent and screen size to ensure
+ * mobile controls are shown on all mobile devices, including high-resolution phones.
+ *
+ * Performance:
+ * - Reduces recalculations by checking only breakpoint changes, not exact dimensions
+ * - Memoizes arena bounds to prevent cascading re-renders
+ * - Targets <1ms execution time for layout calculations
+ *
+ * @param width - Screen width
+ * @param height - Screen height
+ *
+ * @returns Layout constants and arena bounds
+ *
+ * @example
+ * ```typescript
+ * const { layoutConstants, arenaBounds, isMobile, screenSize } = useCombatLayout(1200, 800);
+ * ```
+ */
+import type { ScreenSize } from "../../../../systems/ResponsiveScaling";
+export interface LayoutConstants {
+    readonly padding: number;
+    readonly hudHeight: number;
+    readonly controlsHeight: number;
+    readonly footerHeight: number;
+    readonly healthBarHeight: number;
+}
+export interface ArenaBounds {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly scale: number;
+    readonly worldWidthMeters: number;
+    readonly worldDepthMeters: number;
+}
+export interface CombatLayout {
+    readonly layoutConstants: LayoutConstants;
+    readonly arenaBounds: ArenaBounds;
+    readonly isMobile: boolean;
+    readonly screenSize: ScreenSize;
+}
+/**
+ * Custom hook for combat screen layout calculations
+ * Enhanced with centralized responsive scaling system
+ * Optimized to reduce recalculations and improve 60fps performance
+ */
+export declare function useCombatLayout(width: number, height: number): CombatLayout;
+//# sourceMappingURL=useCombatLayout.d.ts.map

package/lib/components/screens/combat/hooks/useCombatLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCombatLayout.d.ts","sourceRoot":"","sources":["../../../../../src/components/screens/combat/hooks/useCombatLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CA0F3E"}

package/lib/components/screens/combat/hooks/useCombatLayout.js

@@ -0,0 +1,89 @@
+import { getScreenSize } from "../../../../systems/ResponsiveScaling.js";
+import { calculateArenaWorldDimensions } from "../../../../utils/arenaWorldDimensions.js";
+import { shouldUseMobileControls } from "../../../../utils/deviceDetection.js";
+import { calculateMobileAreaBounds } from "../../../../utils/mobileLayoutHelpers.js";
+import { getCombatLayoutConstants } from "../../../../utils/responsiveLayoutHelpers.js";
+import { useMemo } from "react";
+//#region src/components/screens/combat/hooks/useCombatLayout.ts
+/**
+* useCombatLayout Hook - Enhanced Responsive Combat Layout
+*
+* Custom hook for managing responsive combat screen layout calculations with
+* comprehensive support for all screen sizes from mobile to ultra-wide displays.
+*
+* Enhanced Features:
+* - Five screen size categories (mobile, tablet, desktop, large, xlarge)
+* - Proportional scaling for consistent sizing across devices
+* - Optimized arena sizing for each device category
+* - Smooth transitions for resize operations
+* - 60fps performance maintained
+*
+* Uses robust device detection combining user-agent and screen size to ensure
+* mobile controls are shown on all mobile devices, including high-resolution phones.
+*
+* Performance:
+* - Reduces recalculations by checking only breakpoint changes, not exact dimensions
+* - Memoizes arena bounds to prevent cascading re-renders
+* - Targets <1ms execution time for layout calculations
+*
+* @param width - Screen width
+* @param height - Screen height
+*
+* @returns Layout constants and arena bounds
+*
+* @example
+* ```typescript
+* const { layoutConstants, arenaBounds, isMobile, screenSize } = useCombatLayout(1200, 800);
+* ```
+*/
+/**
+* Custom hook for combat screen layout calculations
+* Enhanced with centralized responsive scaling system
+* Optimized to reduce recalculations and improve 60fps performance
+*/
+function useCombatLayout(width, height) {
+	const screenSize = useMemo(() => getScreenSize(width), [width]);
+	const isMobile = shouldUseMobileControls();
+	const layoutConstants = useMemo(() => getCombatLayoutConstants(width, isMobile), [width, isMobile]);
+	return {
+		layoutConstants,
+		arenaBounds: useMemo(() => {
+			const arenaY = layoutConstants.hudHeight + layoutConstants.padding;
+			const worldDimensions = calculateArenaWorldDimensions(width);
+			if (isMobile) {
+				const isExtraSmall = width < 380;
+				return calculateMobileAreaBounds(width, height, isExtraSmall ? 75 : 80, isExtraSmall ? 110 : 120, arenaY);
+			}
+			const totalReservedHeight = layoutConstants.hudHeight + layoutConstants.controlsHeight + layoutConstants.footerHeight;
+			const totalPadding = layoutConstants.padding * 3;
+			const availableHeight = height - totalReservedHeight - totalPadding;
+			let arenaWidth = width * .8;
+			let arenaHeight = arenaWidth * (3 / 4);
+			if (arenaHeight > availableHeight) {
+				arenaHeight = availableHeight;
+				arenaWidth = arenaHeight * (4 / 3);
+			}
+			const scale = arenaWidth / worldDimensions.widthMeters / 100;
+			return {
+				x: (width - arenaWidth) / 2,
+				y: arenaY,
+				width: arenaWidth,
+				height: arenaHeight,
+				scale,
+				worldWidthMeters: worldDimensions.widthMeters,
+				worldDepthMeters: worldDimensions.depthMeters
+			};
+		}, [
+			width,
+			height,
+			layoutConstants,
+			isMobile
+		]),
+		isMobile,
+		screenSize
+	};
+}
+//#endregion
+export { useCombatLayout };
+
+//# sourceMappingURL=useCombatLayout.js.map

package/lib/components/screens/combat/hooks/useCombatLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCombatLayout.js","names":[],"sources":["../../../../../src/components/screens/combat/hooks/useCombatLayout.ts"],"sourcesContent":["/**\n * useCombatLayout Hook - Enhanced Responsive Combat Layout\n *\n * Custom hook for managing responsive combat screen layout calculations with\n * comprehensive support for all screen sizes from mobile to ultra-wide displays.\n *\n * Enhanced Features:\n * - Five screen size categories (mobile, tablet, desktop, large, xlarge)\n * - Proportional scaling for consistent sizing across devices\n * - Optimized arena sizing for each device category\n * - Smooth transitions for resize operations\n * - 60fps performance maintained\n *\n * Uses robust device detection combining user-agent and screen size to ensure\n * mobile controls are shown on all mobile devices, including high-resolution phones.\n *\n * Performance:\n * - Reduces recalculations by checking only breakpoint changes, not exact dimensions\n * - Memoizes arena bounds to prevent cascading re-renders\n * - Targets <1ms execution time for layout calculations\n *\n * @param width - Screen width\n * @param height - Screen height\n *\n * @returns Layout constants and arena bounds\n *\n * @example\n * ```typescript\n * const { layoutConstants, arenaBounds, isMobile, screenSize } = useCombatLayout(1200, 800);\n * ```\n */\n\nimport { useMemo } from \"react\";\nimport { getScreenSize } from \"../../../../systems/ResponsiveScaling\";\nimport { calculateArenaWorldDimensions } from \"../../../../utils/arenaWorldDimensions\";\nimport { shouldUseMobileControls } from \"../../../../utils/deviceDetection\";\nimport { calculateMobileAreaBounds } from \"../../../../utils/mobileLayoutHelpers\";\nimport { getCombatLayoutConstants } from \"../../../../utils/responsiveLayoutHelpers\";\n\nimport type { ScreenSize } from \"../../../../systems/ResponsiveScaling\";\n\nexport interface LayoutConstants {\n  readonly padding: number;\n  readonly hudHeight: number;\n  readonly controlsHeight: number;\n  readonly footerHeight: number;\n  readonly healthBarHeight: number;\n}\n\nexport interface ArenaBounds {\n  readonly x: number;\n  readonly y: number;\n  readonly width: number;\n  readonly height: number;\n  readonly scale: number; // 3D scale factor for arena (1.0 = desktop, <1.0 = mobile)\n  readonly worldWidthMeters: number; // Physical arena width in meters\n  readonly worldDepthMeters: number; // Physical arena depth in meters\n}\n\nexport interface CombatLayout {\n  readonly layoutConstants: LayoutConstants;\n  readonly arenaBounds: ArenaBounds;\n  readonly isMobile: boolean;\n  readonly screenSize: ScreenSize;\n}\n\n/**\n * Custom hook for combat screen layout calculations\n * Enhanced with centralized responsive scaling system\n * Optimized to reduce recalculations and improve 60fps performance\n */\nexport function useCombatLayout(width: number, height: number): CombatLayout {\n  // Determine screen size category using centralized scaling system\n  const screenSize = useMemo(() => getScreenSize(width), [width]);\n\n  // Device detection has its own internal caching based on screen dimensions\n  // No need for additional React memoization here\n  const isMobile = shouldUseMobileControls();\n\n  // Centralized layout constants for easier tweaking\n  // Enhanced with tablet-specific values for better responsive support\n  // Updated mobile controls height for new sizing: D-Pad (140px), buttons (80px+70px)\n  // Uses centralized responsive helper for consistent scaling\n  // Now passes isMobile flag to ensure high-res mobile devices get mobile layouts\n  const layoutConstants = useMemo<LayoutConstants>(\n    () => getCombatLayoutConstants(width, isMobile),\n    [width, isMobile],\n  );\n\n  // Arena bounds calculation using physics-first 4:3 aspect ratio sizing\n  // Arena size is based on resolution (6×4.5, 8×6, 10×7.5, 12×9, 14×10.5 meters)\n  // Mobile controls are determined separately by device detection\n  const arenaBounds = useMemo<ArenaBounds>(() => {\n    const arenaY = layoutConstants.hudHeight + layoutConstants.padding;\n\n    // Calculate world dimensions based on screen resolution (not device type)\n    // All arenas are SQUARE for consistent combat mechanics\n    const worldDimensions = calculateArenaWorldDimensions(width);\n\n    // Mobile-specific arena sizing for better screen fit\n    if (isMobile) {\n      // Extra-small device detection for optimized clearances\n      const isExtraSmall = width < 380;\n      const minTopClearance = isExtraSmall ? 75 : 80;\n      const minBottomClearance = isExtraSmall ? 110 : 120;\n\n      // Use shared mobile area calculation for consistency with training screen\n      const mobileBounds = calculateMobileAreaBounds(\n        width,\n        height,\n        minTopClearance,\n        minBottomClearance,\n        arenaY,\n      );\n\n      // Mobile bounds already include world dimensions from resolution\n      return mobileBounds;\n    }\n\n    // Desktop arena sizing - create 4:3 aspect ratio arena\n    const totalReservedHeight =\n      layoutConstants.hudHeight +\n      layoutConstants.controlsHeight +\n      layoutConstants.footerHeight;\n    const totalPadding = layoutConstants.padding * 3;\n    const availableHeight = height - totalReservedHeight - totalPadding;\n    const availableWidth = width * 0.8;\n\n    // Calculate arena dimensions with 4:3 aspect ratio (width > height)\n    // Start with available width, constrain by height if needed\n    let arenaWidth = availableWidth;\n    let arenaHeight = arenaWidth * (3 / 4); // 4:3 aspect ratio\n\n    // If height is constrained, recalculate from height\n    if (arenaHeight > availableHeight) {\n      arenaHeight = availableHeight;\n      arenaWidth = arenaHeight * (4 / 3);\n    }\n\n    // Calculate pixels-per-meter and scale\n    const pixelsPerMeter = arenaWidth / worldDimensions.widthMeters;\n    const referencePixelsPerMeter = 100;\n    const scale = pixelsPerMeter / referencePixelsPerMeter;\n\n    return {\n      x: (width - arenaWidth) / 2, // Center horizontally\n      y: arenaY,\n      width: arenaWidth,\n      height: arenaHeight, // 4:3 aspect ratio\n      scale,\n      worldWidthMeters: worldDimensions.widthMeters,\n      worldDepthMeters: worldDimensions.depthMeters,\n    };\n  }, [width, height, layoutConstants, isMobile]);\n\n  return {\n    layoutConstants,\n    arenaBounds,\n    isMobile,\n    screenSize,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEA,SAAgB,gBAAgB,OAAe,QAA8B;CAE3E,MAAM,aAAa,cAAc,cAAc,MAAM,EAAE,CAAC,MAAM,CAAC;CAI/D,MAAM,WAAW,yBAAyB;CAO1C,MAAM,kBAAkB,cAChB,yBAAyB,OAAO,SAAS,EAC/C,CAAC,OAAO,SAAS,CAClB;AAoED,QAAO;EACL;EACA,aAjEkB,cAA2B;GAC7C,MAAM,SAAS,gBAAgB,YAAY,gBAAgB;GAI3D,MAAM,kBAAkB,8BAA8B,MAAM;AAG5D,OAAI,UAAU;IAEZ,MAAM,eAAe,QAAQ;AAc7B,WATqB,0BACnB,OACA,QANsB,eAAe,KAAK,IACjB,eAAe,MAAM,KAQ9C,OACD;;GAOH,MAAM,sBACJ,gBAAgB,YAChB,gBAAgB,iBAChB,gBAAgB;GAClB,MAAM,eAAe,gBAAgB,UAAU;GAC/C,MAAM,kBAAkB,SAAS,sBAAsB;GAKvD,IAAI,aAJmB,QAAQ;GAK/B,IAAI,cAAc,cAAc,IAAI;AAGpC,OAAI,cAAc,iBAAiB;AACjC,kBAAc;AACd,iBAAa,eAAe,IAAI;;GAMlC,MAAM,QAFiB,aAAa,gBAAgB,cACpB;AAGhC,UAAO;IACL,IAAI,QAAQ,cAAc;IAC1B,GAAG;IACH,OAAO;IACP,QAAQ;IACR;IACA,kBAAkB,gBAAgB;IAClC,kBAAkB,gBAAgB;IACnC;KACA;GAAC;GAAO;GAAQ;GAAiB;GAAS,CAAC;EAK5C;EACA;EACD"}

package/lib/components/screens/combat/hooks/useCombatState.d.ts

@@ -0,0 +1,75 @@
+/**
+ * useCombatState Hook - Consolidated Combat State Management
+ *
+ * Custom hook for managing complex combat state using useReducer.
+ * Consolidates multiple useState calls into a single reducer for better
+ * performance and maintainability.
+ *
+ * Performance:
+ * - Uses useReducer to batch state updates
+ * - Reduces number of re-renders
+ * - Provides clear action-based state updates
+ *
+ * @returns Combat state and dispatch actions
+ *
+ * @example
+ * ```typescript
+ * const { state, actions } = useCombatState();
+ * actions.setHitEffects([effect1, effect2]);
+ * actions.incrementCombo();
+ * ```
+ */
+import { HitEffect } from "../../../../systems";
+import type { StanceLaterality } from "../../../../systems/trigram/types";
+/**
+ * Combat screen state managed by the reducer
+ * Note: Renamed from CombatState to avoid conflict with CombatState enum in types/common.ts
+ */
+export interface CombatScreenState {
+    readonly hitEffects: HitEffect[];
+    readonly isExecutingTechnique: boolean;
+    readonly combatMessages: string[];
+    readonly roundStarted: boolean;
+    readonly roundEnded: boolean;
+    readonly roundDisplayStatus: "start" | "fight" | "ko" | "end" | null;
+    readonly comboCount: number;
+    readonly lastHitTime: number;
+    readonly screenShake: {
+        x: number;
+        y: number;
+    };
+    readonly playerLaterality: readonly [StanceLaterality, StanceLaterality];
+}
+/**
+ * Combat state action creators
+ */
+export interface CombatActions {
+    readonly setHitEffects: (effects: HitEffect[]) => void;
+    readonly addHitEffect: (effect: HitEffect) => void;
+    readonly removeHitEffect: (effectId: string) => void;
+    readonly setExecutingTechnique: (executing: boolean) => void;
+    readonly addCombatMessage: (message: string) => void;
+    readonly setRoundStarted: (started: boolean) => void;
+    readonly setRoundEnded: (ended: boolean) => void;
+    readonly setRoundDisplayStatus: (status: "start" | "fight" | "ko" | "end" | null) => void;
+    readonly setComboCount: (count: number) => void;
+    readonly incrementCombo: () => void;
+    readonly resetCombo: () => void;
+    readonly setLastHitTime: (time: number) => void;
+    readonly setScreenShake: (shake: {
+        x: number;
+        y: number;
+    }) => void;
+    readonly resetScreenShake: () => void;
+    readonly resetRoundState: () => void;
+    readonly setPlayerLaterality: (laterality: readonly [StanceLaterality, StanceLaterality]) => void;
+    readonly setPlayerLateralityIndex: (index: 0 | 1, laterality: StanceLaterality) => void;
+}
+/**
+ * Custom hook for combat state management
+ */
+export declare function useCombatState(): {
+    state: CombatScreenState;
+    actions: CombatActions;
+};
+//# sourceMappingURL=useCombatState.d.ts.map

package/lib/components/screens/combat/hooks/useCombatState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCombatState.d.ts","sourceRoot":"","sources":["../../../../../src/components/screens/combat/hooks/useCombatState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;CAC1E;AAsHD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IACvD,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,qBAAqB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,qBAAqB,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1F,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAClG,QAAQ,CAAC,wBAAwB,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACzF;AAED;;GAEG;AACH,wBAAgB,cAAc;;;EAqE7B"}