blacktrigram 0.7.2

package/lib/systems/animation/utils/AnimationMirror.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Animation Mirroring Utility - Left/Right Stance Reflection
+ *
+ * Provides utilities to mirror skeletal animations for left/right foot forward stances.
+ * This enables single animation definitions to work for both orthodox and southpaw fighters.
+ *
+ * Mirror Operations:
+ * - Swaps left/right bone rotations (HIP_L ↔ HIP_R, SHOULDER_L ↔ SHOULDER_R, etc.)
+ * - Negates Y rotation for pelvis (facing direction)
+ * - Negates Z rotation for lateral movements
+ * - Inverts X-axis positions for root motion
+ *
+ * @module systems/animation/utils/AnimationMirror
+ * @korean 애니메이션반전유틸리티
+ */
+import * as THREE from "three";
+import { BoneName, type AnimationKeyframe, type SkeletalAnimation } from "../../../types/skeletal";
+/**
+ * Lead foot indicator for stance side
+ *
+ * Orthodox: Left foot forward (traditional right-handed stance)
+ * Southpaw: Right foot forward (traditional left-handed stance)
+ *
+ * @korean 선발발
+ */
+export type LeadFoot = "left" | "right";
+/**
+ * Stance side for combat positioning
+ *
+ * @korean 자세방향
+ */
+export type StanceSide = "orthodox" | "southpaw";
+/**
+ * Get the mirrored bone name (left ↔ right)
+ *
+ * @param bone - Original bone name
+ * @returns Mirrored bone name (or same if center bone)
+ *
+ * @korean 반전된뼈대이름가져오기
+ */
+export declare function getMirroredBone(bone: BoneName): BoneName;
+/**
+ * Mirror an Euler rotation for the opposite side
+ *
+ * For lateral bones (limbs):
+ * - X rotation is preserved (flexion/extension)
+ * - Y rotation is negated (internal/external rotation)
+ * - Z rotation is negated (abduction/adduction)
+ *
+ * For center bones (spine, pelvis):
+ * - X rotation is preserved (forward/back tilt)
+ * - Y rotation is negated (left/right rotation)
+ * - Z rotation is negated (side bend)
+ *
+ * @param rotation - Original rotation as Euler
+ * @param bone - The bone this rotation belongs to
+ * @returns Mirrored rotation
+ *
+ * @korean 회전반전
+ */
+export declare function mirrorRotation(rotation: THREE.Euler, bone: BoneName): THREE.Euler;
+/**
+ * Mirror a position vector for the opposite side
+ *
+ * @param position - Original position
+ * @returns Mirrored position (X negated for lateral mirror)
+ *
+ * @korean 위치반전
+ */
+export declare function mirrorPosition(position: THREE.Vector3): THREE.Vector3;
+/**
+ * Mirror a single animation keyframe
+ *
+ * Swaps left/right bone rotations and mirrors center bone rotations.
+ *
+ * @param keyframe - Original keyframe
+ * @returns Mirrored keyframe
+ *
+ * @korean 키프레임반전
+ */
+export declare function mirrorKeyframe(keyframe: AnimationKeyframe): AnimationKeyframe;
+/**
+ * Mirror an entire skeletal animation for the opposite stance side
+ *
+ * Creates a new animation with all keyframes mirrored left-to-right.
+ * Useful for creating southpaw variants from orthodox animations.
+ *
+ * @param animation - Original animation (assumed orthodox/left-foot-forward)
+ * @param options - Mirroring options
+ * @returns New animation with mirrored keyframes
+ *
+ * @example
+ * ```typescript
+ * // Create southpaw jab from orthodox jab
+ * const southpawJab = mirrorAnimation(JAB_ANIMATION, {
+ *   nameSuffix: '_southpaw',
+ *   koreanNameSuffix: '(사우스포)'
+ * });
+ * ```
+ *
+ * @korean 애니메이션반전
+ */
+export declare function mirrorAnimation(animation: SkeletalAnimation, options?: {
+    readonly nameSuffix?: string;
+    readonly koreanNameSuffix?: string;
+}): SkeletalAnimation;
+/**
+ * Get animation for specified stance side
+ *
+ * If the animation is already in the correct stance, returns as-is.
+ * If not, mirrors the animation.
+ *
+ * @param animation - Base animation (orthodox)
+ * @param leadFoot - Which foot should be forward
+ * @param cache - Optional cache for mirrored animations
+ * @returns Animation for the specified stance
+ *
+ * @korean 자세별애니메이션가져오기
+ */
+export declare function getAnimationForStance(animation: SkeletalAnimation, leadFoot: LeadFoot, cache?: Map<string, SkeletalAnimation>): SkeletalAnimation;
+/**
+ * Convert lead foot to stance side
+ *
+ * @param leadFoot - Which foot is forward
+ * @returns Stance side name
+ *
+ * @korean 선발발에서자세방향변환
+ */
+export declare function leadFootToStanceSide(leadFoot: LeadFoot): StanceSide;
+/**
+ * Convert stance side to lead foot
+ *
+ * @param stanceSide - Stance side name
+ * @returns Which foot is forward
+ *
+ * @korean 자세방향에서선발발변환
+ */
+export declare function stanceSideToLeadFoot(stanceSide: StanceSide): LeadFoot;
+/**
+ * Get the opposite lead foot
+ *
+ * @param leadFoot - Current lead foot
+ * @returns Opposite lead foot
+ *
+ * @korean 반대선발발가져오기
+ */
+export declare function getOppositeLeadFoot(leadFoot: LeadFoot): LeadFoot;
+/**
+ * Get the rear foot based on lead foot
+ *
+ * @param leadFoot - Which foot is forward
+ * @returns Which foot is in the rear
+ *
+ * @korean 후발발가져오기
+ */
+export declare function getRearFoot(leadFoot: LeadFoot): LeadFoot;
+//# sourceMappingURL=AnimationMirror.d.ts.map

package/lib/systems/animation/utils/AnimationMirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationMirror.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/utils/AnimationMirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EACL,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAoDjC;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAMjD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAQxD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,KAAK,CAAC,KAAK,EACrB,IAAI,EAAE,QAAQ,GACb,KAAK,CAAC,KAAK,CAoBb;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAMrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB,CAuC7E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE;IACP,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC/B,GACL,iBAAiB,CAWnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACrC,iBAAiB,CAsBnB;AAMD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAExD"}

package/lib/systems/animation/utils/AnimationMirror.js

@@ -0,0 +1,30 @@
+import { BoneName } from "../../../types/skeletal.js";
+import "three";
+//#region src/systems/animation/utils/AnimationMirror.ts
+/**
+* Mapping of left-side bones to their right-side counterparts
+*
+* @korean 좌측뼈대우측뼈대매핑
+*/
+var LEFT_TO_RIGHT_BONE_MAP = new Map([
+	[BoneName.SHOULDER_L, BoneName.SHOULDER_R],
+	[BoneName.ELBOW_L, BoneName.ELBOW_R],
+	[BoneName.WRIST_L, BoneName.WRIST_R],
+	[BoneName.HAND_L, BoneName.HAND_R],
+	[BoneName.HIP_L, BoneName.HIP_R],
+	[BoneName.KNEE_L, BoneName.KNEE_R],
+	[BoneName.SHIN_L, BoneName.SHIN_R],
+	[BoneName.FOOT_L, BoneName.FOOT_R]
+]);
+new Map(Array.from(LEFT_TO_RIGHT_BONE_MAP.entries()).map(([left, right]) => [right, left]));
+new Set([
+	BoneName.PELVIS,
+	BoneName.SPINE_LOWER,
+	BoneName.SPINE_MIDDLE,
+	BoneName.SPINE_UPPER,
+	BoneName.NECK,
+	BoneName.HEAD
+]);
+//#endregion
+
+//# sourceMappingURL=AnimationMirror.js.map

package/lib/systems/animation/utils/AnimationMirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationMirror.js","names":[],"sources":["../../../../src/systems/animation/utils/AnimationMirror.ts"],"sourcesContent":["/**\n * Animation Mirroring Utility - Left/Right Stance Reflection\n *\n * Provides utilities to mirror skeletal animations for left/right foot forward stances.\n * This enables single animation definitions to work for both orthodox and southpaw fighters.\n *\n * Mirror Operations:\n * - Swaps left/right bone rotations (HIP_L ↔ HIP_R, SHOULDER_L ↔ SHOULDER_R, etc.)\n * - Negates Y rotation for pelvis (facing direction)\n * - Negates Z rotation for lateral movements\n * - Inverts X-axis positions for root motion\n *\n * @module systems/animation/utils/AnimationMirror\n * @korean 애니메이션반전유틸리티\n */\n\nimport * as THREE from \"three\";\nimport {\n  BoneName,\n  type AnimationKeyframe,\n  type SkeletalAnimation,\n} from \"../../../types/skeletal\";\n\n// ═══════════════════════════════════════════════════════════════════════════\n// BONE PAIR MAPPINGS\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Mapping of left-side bones to their right-side counterparts\n *\n * @korean 좌측뼈대우측뼈대매핑\n */\nconst LEFT_TO_RIGHT_BONE_MAP: ReadonlyMap<BoneName, BoneName> = new Map([\n  [BoneName.SHOULDER_L, BoneName.SHOULDER_R],\n  [BoneName.ELBOW_L, BoneName.ELBOW_R],\n  [BoneName.WRIST_L, BoneName.WRIST_R],\n  [BoneName.HAND_L, BoneName.HAND_R],\n  [BoneName.HIP_L, BoneName.HIP_R],\n  [BoneName.KNEE_L, BoneName.KNEE_R],\n  [BoneName.SHIN_L, BoneName.SHIN_R],\n  [BoneName.FOOT_L, BoneName.FOOT_R],\n]);\n\n/**\n * Mapping of right-side bones to their left-side counterparts\n *\n * @korean 우측뼈대좌측뼈대매핑\n */\nconst RIGHT_TO_LEFT_BONE_MAP: ReadonlyMap<BoneName, BoneName> = new Map(\n  Array.from(LEFT_TO_RIGHT_BONE_MAP.entries()).map(([left, right]) => [\n    right,\n    left,\n  ]),\n);\n\n/**\n * Center bones that need Y/Z rotation negation when mirroring\n *\n * @korean 중앙뼈대\n */\nconst CENTER_BONES: ReadonlySet<BoneName> = new Set([\n  BoneName.PELVIS,\n  BoneName.SPINE_LOWER,\n  BoneName.SPINE_MIDDLE,\n  BoneName.SPINE_UPPER,\n  BoneName.NECK,\n  BoneName.HEAD,\n]);\n\n// ═══════════════════════════════════════════════════════════════════════════\n// STANCE TYPES\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Lead foot indicator for stance side\n *\n * Orthodox: Left foot forward (traditional right-handed stance)\n * Southpaw: Right foot forward (traditional left-handed stance)\n *\n * @korean 선발발\n */\nexport type LeadFoot = \"left\" | \"right\";\n\n/**\n * Stance side for combat positioning\n *\n * @korean 자세방향\n */\nexport type StanceSide = \"orthodox\" | \"southpaw\";\n\n// ═══════════════════════════════════════════════════════════════════════════\n// MIRRORING FUNCTIONS\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Get the mirrored bone name (left ↔ right)\n *\n * @param bone - Original bone name\n * @returns Mirrored bone name (or same if center bone)\n *\n * @korean 반전된뼈대이름가져오기\n */\nexport function getMirroredBone(bone: BoneName): BoneName {\n  const leftToRight = LEFT_TO_RIGHT_BONE_MAP.get(bone);\n  if (leftToRight) return leftToRight;\n\n  const rightToLeft = RIGHT_TO_LEFT_BONE_MAP.get(bone);\n  if (rightToLeft) return rightToLeft;\n\n  return bone; // Center bones remain unchanged\n}\n\n/**\n * Mirror an Euler rotation for the opposite side\n *\n * For lateral bones (limbs):\n * - X rotation is preserved (flexion/extension)\n * - Y rotation is negated (internal/external rotation)\n * - Z rotation is negated (abduction/adduction)\n *\n * For center bones (spine, pelvis):\n * - X rotation is preserved (forward/back tilt)\n * - Y rotation is negated (left/right rotation)\n * - Z rotation is negated (side bend)\n *\n * @param rotation - Original rotation as Euler\n * @param bone - The bone this rotation belongs to\n * @returns Mirrored rotation\n *\n * @korean 회전반전\n */\nexport function mirrorRotation(\n  rotation: THREE.Euler,\n  bone: BoneName,\n): THREE.Euler {\n  const isCenterBone = CENTER_BONES.has(bone);\n\n  if (isCenterBone) {\n    // Center bones: negate Y and Z for bilateral symmetry\n    return new THREE.Euler(\n      rotation.x, // Preserve forward/back tilt\n      -rotation.y, // Negate left/right rotation\n      -rotation.z, // Negate side bend\n      rotation.order,\n    );\n  } else {\n    // Limb bones: preserve X (flexion), negate Y and Z\n    return new THREE.Euler(\n      rotation.x, // Preserve flexion/extension\n      -rotation.y, // Negate internal/external rotation\n      -rotation.z, // Negate abduction/adduction\n      rotation.order,\n    );\n  }\n}\n\n/**\n * Mirror a position vector for the opposite side\n *\n * @param position - Original position\n * @returns Mirrored position (X negated for lateral mirror)\n *\n * @korean 위치반전\n */\nexport function mirrorPosition(position: THREE.Vector3): THREE.Vector3 {\n  return new THREE.Vector3(\n    -position.x, // Negate lateral position\n    position.y, // Preserve vertical\n    position.z, // Preserve depth\n  );\n}\n\n/**\n * Mirror a single animation keyframe\n *\n * Swaps left/right bone rotations and mirrors center bone rotations.\n *\n * @param keyframe - Original keyframe\n * @returns Mirrored keyframe\n *\n * @korean 키프레임반전\n */\nexport function mirrorKeyframe(keyframe: AnimationKeyframe): AnimationKeyframe {\n  // Process bone rotations - return empty Map if source is undefined\n  const mirroredRotations = new Map<string, THREE.Euler>();\n  if (keyframe.boneRotations) {\n    keyframe.boneRotations.forEach((rotation, bone) => {\n      const mirroredBone = getMirroredBone(bone as BoneName);\n      const mirroredRotation = mirrorRotation(rotation, bone as BoneName);\n      mirroredRotations.set(mirroredBone, mirroredRotation);\n    });\n  }\n\n  // Process bone positions - return empty Map if source is undefined\n  const mirroredPositions = new Map<string, THREE.Vector3>();\n  if (keyframe.bonePositions) {\n    keyframe.bonePositions.forEach((position, bone) => {\n      const mirroredBone = getMirroredBone(bone as BoneName);\n      const mirroredPos = mirrorPosition(position);\n      mirroredPositions.set(mirroredBone, mirroredPos);\n    });\n  }\n\n  // Copy other keyframe properties\n  const result: AnimationKeyframe = {\n    time: keyframe.time,\n    easing: keyframe.easing,\n    boneRotations: mirroredRotations,\n    bonePositions: mirroredPositions,\n  };\n\n  // Copy hand pose properties if they exist (swap left/right)\n  if (keyframe.leftHandPose || keyframe.rightHandPose) {\n    return {\n      ...result,\n      leftHandPose: keyframe.rightHandPose,\n      rightHandPose: keyframe.leftHandPose,\n    };\n  }\n\n  return result;\n}\n\n/**\n * Mirror an entire skeletal animation for the opposite stance side\n *\n * Creates a new animation with all keyframes mirrored left-to-right.\n * Useful for creating southpaw variants from orthodox animations.\n *\n * @param animation - Original animation (assumed orthodox/left-foot-forward)\n * @param options - Mirroring options\n * @returns New animation with mirrored keyframes\n *\n * @example\n * ```typescript\n * // Create southpaw jab from orthodox jab\n * const southpawJab = mirrorAnimation(JAB_ANIMATION, {\n *   nameSuffix: '_southpaw',\n *   koreanNameSuffix: '(사우스포)'\n * });\n * ```\n *\n * @korean 애니메이션반전\n */\nexport function mirrorAnimation(\n  animation: SkeletalAnimation,\n  options: {\n    readonly nameSuffix?: string;\n    readonly koreanNameSuffix?: string;\n  } = {},\n): SkeletalAnimation {\n  const { nameSuffix = \"_mirrored\", koreanNameSuffix = \"(반전)\" } = options;\n\n  const mirroredKeyframes = animation.keyframes.map((kf) => mirrorKeyframe(kf));\n\n  return {\n    ...animation,\n    name: `${animation.name}${nameSuffix}`,\n    koreanName: `${animation.koreanName || animation.name}${koreanNameSuffix}`,\n    keyframes: mirroredKeyframes,\n  };\n}\n\n/**\n * Get animation for specified stance side\n *\n * If the animation is already in the correct stance, returns as-is.\n * If not, mirrors the animation.\n *\n * @param animation - Base animation (orthodox)\n * @param leadFoot - Which foot should be forward\n * @param cache - Optional cache for mirrored animations\n * @returns Animation for the specified stance\n *\n * @korean 자세별애니메이션가져오기\n */\nexport function getAnimationForStance(\n  animation: SkeletalAnimation,\n  leadFoot: LeadFoot,\n  cache?: Map<string, SkeletalAnimation>,\n): SkeletalAnimation {\n  // Orthodox stance (left foot forward) - use original\n  if (leadFoot === \"left\") {\n    return animation;\n  }\n\n  // Southpaw stance (right foot forward) - need mirrored version\n  const cacheKey = `${animation.name}_southpaw`;\n\n  if (cache?.has(cacheKey)) {\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- checked with has() above\n    return cache.get(cacheKey)!;\n  }\n\n  const mirrored = mirrorAnimation(animation, {\n    nameSuffix: \"_southpaw\",\n    koreanNameSuffix: \"(사우스포)\",\n  });\n\n  cache?.set(cacheKey, mirrored);\n\n  return mirrored;\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// STANCE UTILITIES\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Convert lead foot to stance side\n *\n * @param leadFoot - Which foot is forward\n * @returns Stance side name\n *\n * @korean 선발발에서자세방향변환\n */\nexport function leadFootToStanceSide(leadFoot: LeadFoot): StanceSide {\n  return leadFoot === \"left\" ? \"orthodox\" : \"southpaw\";\n}\n\n/**\n * Convert stance side to lead foot\n *\n * @param stanceSide - Stance side name\n * @returns Which foot is forward\n *\n * @korean 자세방향에서선발발변환\n */\nexport function stanceSideToLeadFoot(stanceSide: StanceSide): LeadFoot {\n  return stanceSide === \"orthodox\" ? \"left\" : \"right\";\n}\n\n/**\n * Get the opposite lead foot\n *\n * @param leadFoot - Current lead foot\n * @returns Opposite lead foot\n *\n * @korean 반대선발발가져오기\n */\nexport function getOppositeLeadFoot(leadFoot: LeadFoot): LeadFoot {\n  return leadFoot === \"left\" ? \"right\" : \"left\";\n}\n\n/**\n * Get the rear foot based on lead foot\n *\n * @param leadFoot - Which foot is forward\n * @returns Which foot is in the rear\n *\n * @korean 후발발가져오기\n */\nexport function getRearFoot(leadFoot: LeadFoot): LeadFoot {\n  return getOppositeLeadFoot(leadFoot);\n}\n"],"mappings":";;;;;;;;AAgCA,IAAM,yBAA0D,IAAI,IAAI;CACtE,CAAC,SAAS,YAAY,SAAS,WAAW;CAC1C,CAAC,SAAS,SAAS,SAAS,QAAQ;CACpC,CAAC,SAAS,SAAS,SAAS,QAAQ;CACpC,CAAC,SAAS,QAAQ,SAAS,OAAO;CAClC,CAAC,SAAS,OAAO,SAAS,MAAM;CAChC,CAAC,SAAS,QAAQ,SAAS,OAAO;CAClC,CAAC,SAAS,QAAQ,SAAS,OAAO;CAClC,CAAC,SAAS,QAAQ,SAAS,OAAO;CACnC,CAAC;AAO8D,IAAI,IAClE,MAAM,KAAK,uBAAuB,SAAS,CAAC,CAAC,KAAK,CAAC,MAAM,WAAW,CAClE,OACA,KACD,CAAC,CACH;AAO2C,IAAI,IAAI;CAClD,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACV,CAAC"}

package/lib/systems/audio/BoneImpactAudioSystem.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Bone Impact Audio System for Black Trigram (흑괘)
+ *
+ * Provides realistic bone contact sounds, fracture audio, and anatomically-accurate
+ * impact feedback for Korean martial arts combat.
+ *
+ * **Korean**: 골절음 시스템 (骨折音 - Bone Fracture Sound System)
+ *
+ * @module BoneImpactAudioSystem
+ *
+ * Features:
+ * - 5 body region categories (head, torso, arms, legs, soft tissue)
+ * - Impact intensity scaling (light 70% → fracture 130% volume)
+ * - Fracture detection when health < 30%
+ * - Spatial audio positioning (planned feature, not yet implemented in AudioManager)
+ * - Korean-English bilingual audio cues
+ */
+import { AudioBodyRegion, BoneImpactEvent, ImpactIntensity } from "../../audio/types";
+import { VitalPoint } from "../vitalpoint/types";
+/**
+ * 3D Position for spatial audio
+ */
+export interface Vector3 {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+}
+/**
+ * Audio manager interface (minimal subset needed)
+ *
+ * Note: Spatial audio parameters (position) are not currently supported by the
+ * actual IAudioManager interface. This interface documents the intended API
+ * for future spatial audio integration with Howler.js.
+ */
+export interface AudioManagerInterface {
+    playSFX(soundId: string, volume?: number): Promise<void>;
+}
+/**
+ * Configuration for BoneImpactAudioSystem
+ */
+export interface BoneImpactAudioConfig {
+    /**
+     * Enable spatial audio positioning (default: true).
+     *
+     * NOTE: Spatial/positional audio is a planned future feature. The current
+     * AudioManager implementation does not support 3D positions, so this flag
+     * is effectively a no-op until the core audio layer is extended.
+     */
+    readonly enableSpatialAudio?: boolean;
+    /** Master volume multiplier for bone impacts (default: 1.0) */
+    readonly masterVolume?: number;
+    /** Minimum interval between bone impact sounds in ms (default: 50) */
+    readonly minPlayInterval?: number;
+    /** Character height for body region detection (default: 2.0) */
+    readonly characterHeight?: number;
+    /** Enable Korean-English audio cues (default: false - not implemented yet) */
+    readonly enableBilingualCues?: boolean;
+}
+/**
+ * Statistics for BoneImpactAudioSystem monitoring
+ */
+export interface BoneImpactAudioStats {
+    readonly totalImpactsPlayed: number;
+    readonly impactsByRegion: Record<AudioBodyRegion, number>;
+    readonly impactsByIntensity: Record<ImpactIntensity, number>;
+    readonly fracturesTriggered: number;
+    readonly vitalPointStrikes: number;
+    readonly lastImpactTime: number;
+}
+/**
+ * Bone Impact Audio System
+ *
+ * Centralized system for playing anatomically-accurate bone and flesh impact sounds
+ * based on strike location, intensity, and target health.
+ */
+export declare class BoneImpactAudioSystem {
+    private readonly audioManager;
+    private readonly config;
+    private lastPlayTime;
+    private stats;
+    /**
+     * Create a new BoneImpactAudioSystem
+     *
+     * @param audioManager - Audio manager for playing sounds
+     * @param config - Optional configuration
+     */
+    constructor(audioManager: AudioManagerInterface, config?: BoneImpactAudioConfig);
+    /**
+     * Play bone impact sound based on event parameters
+     *
+     * **Korean**: 골절음 재생
+     *
+     * @param event - Bone impact event with region, intensity, and health info
+     * @param _position - Optional 3D position for spatial audio (future feature, not yet implemented)
+     * @returns Promise that resolves when sound starts playing
+     *
+     * @example
+     * ```typescript
+     * await system.playBoneImpact(
+     *   { region: 'head', intensity: 'heavy', vitalPoint: false },
+     *   { x: 0, y: 1.8, z: 0 }
+     * );
+     * ```
+     */
+    playBoneImpact(event: BoneImpactEvent, _position?: Vector3): Promise<void>;
+    /**
+     * Play bone impact from vital point strike
+     *
+     * @param vitalPoint - Vital point that was struck
+     * @param impactForce - Force of impact (damage amount)
+     * @param remainingHealth - Target's remaining health
+     * @param position - 3D position of strike
+     *
+     * @example
+     * ```typescript
+     * await system.playBoneImpactFromVitalPoint(
+     *   ribVitalPoint,
+     *   35,
+     *   25,
+     *   { x: 0.2, y: 1.2, z: 0 }
+     * );
+     * ```
+     */
+    playBoneImpactFromVitalPoint(vitalPoint: VitalPoint, impactForce: number, remainingHealth: number, position: Vector3): Promise<void>;
+    /**
+     * Play bone impact from damage and position
+     * Auto-detects body region and calculates intensity
+     *
+     * @param damage - Damage amount
+     * @param remainingHealth - Target's remaining health
+     * @param hitPosition - 3D position where strike landed
+     * @param isVitalPoint - Whether strike hit a vital point
+     *
+     * @example
+     * ```typescript
+     * await system.playBoneImpactFromDamage(
+     *   40,
+     *   60,
+     *   { x: 0, y: 1.8, z: 0 },
+     *   false
+     * );
+     * ```
+     */
+    playBoneImpactFromDamage(damage: number, remainingHealth: number, hitPosition: Vector3, isVitalPoint?: boolean): Promise<void>;
+    /**
+     * Determine bone type from vital point category
+     * Maps vital point data to audio body regions
+     *
+     * @param vitalPoint - Vital point that was struck
+     * @returns Audio body region
+     */
+    private getBoneTypeFromVitalPoint;
+    /**
+     * Update statistics for monitoring
+     */
+    private updateStats;
+    /**
+     * Play Korean-English bilingual audio cue
+     * (Future feature - placeholder for now)
+     *
+     * @param cueId - Audio cue ID (e.g., "bone_fracture")
+     */
+    private playBilingualCue;
+    /**
+     * Get current statistics
+     *
+     * @returns Current statistics object
+     */
+    getStats(): Readonly<BoneImpactAudioStats>;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Get configuration
+     *
+     * @returns Current configuration object
+     */
+    getConfig(): Readonly<Required<BoneImpactAudioConfig>>;
+}
+export default BoneImpactAudioSystem;
+//# sourceMappingURL=BoneImpactAudioSystem.d.ts.map

package/lib/systems/audio/BoneImpactAudioSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoneImpactAudioSystem.d.ts","sourceRoot":"","sources":["../../../src/systems/audio/BoneImpactAudioSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAEtC,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,sEAAsE;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,gEAAgE;IAChE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,8EAA8E;IAC9E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC7D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,YAAY,CAAa;IAGjC,OAAO,CAAC,KAAK,CAmBX;IAEF;;;;;OAKG;gBAED,YAAY,EAAE,qBAAqB,EACnC,MAAM,CAAC,EAAE,qBAAqB;IAYhC;;;;;;;;;;;;;;;;OAgBG;IACG,cAAc,CAClB,KAAK,EAAE,eAAe,EACtB,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC;IA2ChB;;;;;;;;;;;;;;;;;OAiBG;IACG,4BAA4B,CAChC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC;IAsBhB;;;;;;;;;;;;;;;;;;OAkBG;IACG,wBAAwB,CAC5B,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,OAAO,EACpB,YAAY,GAAE,OAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;IAyBhB;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IAyDjC;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;;;;OAKG;YACW,gBAAgB;IAM9B;;;;OAIG;IACH,QAAQ,IAAI,QAAQ,CAAC,oBAAoB,CAAC;IAI1C;;OAEG;IACH,UAAU,IAAI,IAAI;IAuBlB;;;;OAIG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;CAGvD;AAED,eAAe,qBAAqB,CAAC"}

package/lib/systems/audio/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Audio Systems Export Module
+ *
+ * Exports audio-related systems for Black Trigram combat
+ */
+export { BoneImpactAudioSystem, type AudioManagerInterface, type BoneImpactAudioConfig, type BoneImpactAudioStats, type Vector3, } from "./BoneImpactAudioSystem";
+//# sourceMappingURL=index.d.ts.map

package/lib/systems/audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/systems/audio/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,OAAO,GACb,MAAM,yBAAyB,CAAC"}

package/lib/systems/bodypart/BodyPartDamageIntegration.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Body Part Damage Integration for Combat System
+ *
+ * **Korean**: 신체부위 피해 통합
+ *
+ * Extends the damage calculation system to apply damage to specific body parts
+ * based on vital point hits and attack locations. Integrates with the existing
+ * VitalPointSystem and DamageCalculator.
+ *
+ * @module systems/bodypart/BodyPartDamageIntegration
+ * @category Body Part System
+ * @korean 신체부위피해통합
+ */
+import { BodyRegion } from "../../types";
+import type { VitalPoint } from "../vitalpoint/types";
+import { BodyPartHealth, BodyPartMaxHealth } from "./types";
+/**
+ * Minimal player view needed for body part damage operations.
+ */
+export interface BodyPartDamageTarget {
+    readonly health: number;
+    readonly bodyPartHealth?: BodyPartHealth;
+    readonly bodyPartMaxHealth?: BodyPartMaxHealth;
+}
+/**
+ * Map vital point to its corresponding body region.
+ *
+ * **Korean**: 급소에서 신체 영역 매핑
+ *
+ * Analyzes a vital point's location and category to determine which
+ * BodyRegion it belongs to, enabling proper damage distribution.
+ *
+ * @param vitalPoint - Vital point that was struck
+ * @returns Corresponding body region
+ *
+ * @public
+ */
+export declare function getBodyRegionFromVitalPoint(vitalPoint: VitalPoint): BodyRegion;
+/**
+ * Apply damage to player's body parts based on hit location.
+ *
+ * **Korean**: 타격 위치 기반 신체부위 피해 적용
+ *
+ * Takes total damage and distributes it across body parts according to
+ * the hit location. Updates both aggregate health and body part health.
+ *
+ * For combat compatibility, the aggregate health is directly reduced by
+ * the damage amount (traditional behavior), while body part health is
+ * updated proportionally for visualization purposes.
+ *
+ * @param player - Player receiving damage
+ * @param totalDamage - Total damage amount
+ * @param bodyRegion - Body region that was hit
+ * @returns Updated player state with body part damage applied
+ *
+ * @public
+ */
+export declare function applyDamageToBodyParts<T extends BodyPartDamageTarget>(player: T, totalDamage: number, bodyRegion: BodyRegion): T;
+/**
+ * Apply damage from a vital point hit to appropriate body parts.
+ *
+ * **Korean**: 급소 타격 신체부위 피해 적용
+ *
+ * Specialized damage application for vital point strikes. Maps the vital
+ * point to its body region and applies damage with appropriate distribution.
+ *
+ * @param player - Player receiving damage
+ * @param totalDamage - Total damage amount
+ * @param vitalPoint - Vital point that was struck
+ * @returns Updated player state with vital point damage applied
+ *
+ * @public
+ */
+export declare function applyVitalPointDamageToBodyParts<T extends BodyPartDamageTarget>(player: T, totalDamage: number, vitalPoint: VitalPoint): T;
+/**
+ * Get combat capability modifiers from body part health.
+ *
+ * **Korean**: 신체부위 전투 능력 수정치 조회
+ *
+ * Calculates how body part damage affects combat capabilities.
+ * Returns modifiers that should be applied to:
+ * - Consciousness (awareness, reaction time)
+ * - Stamina regeneration
+ * - Attack damage output
+ * - Movement speed
+ * - Balance and stability
+ * - Technique accuracy
+ *
+ * @param player - Player state to analyze
+ * @returns Combat capability effect multipliers (0.0-1.0)
+ *
+ * @example
+ * ```typescript
+ * const effects = getBodyPartCombatEffects(player);
+ * const actualDamage = baseDamage * effects.attackDamageModifier;
+ * const actualSpeed = baseSpeed * effects.movementSpeedModifier;
+ * ```
+ *
+ * @public
+ */
+export declare function getBodyPartCombatEffects(player: BodyPartDamageTarget): import("./types").BodyPartEffects;
+/**
+ * Check if player is incapacitated by body part damage.
+ *
+ * **Korean**: 신체부위 무력화 확인
+ *
+ * Determines if the player can continue fighting based on body part health.
+ * Player is incapacitated if:
+ * - Head is at 0 HP (unconscious)
+ * - Both legs are at 0 HP (cannot stand)
+ * - Aggregate health is below 10%
+ *
+ * @param player - Player state to check
+ * @returns Whether player is incapacitated
+ *
+ * @public
+ */
+export declare function isPlayerIncapacitatedByBodyDamage(player: BodyPartDamageTarget): boolean;
+/**
+ * Initialize body part health for a player.
+ *
+ * **Korean**: 플레이어 신체부위 체력 초기화
+ *
+ * Sets up body part health and max health for a player if not already present.
+ * Uses the provided max health or defaults to 100 per part.
+ *
+ * @param player - Player state to initialize
+ * @param maxHealthPerPart - Optional custom max health per part
+ * @returns Player state with body part health initialized
+ *
+ * @public
+ */
+export declare function initializeBodyPartHealthForPlayer<T extends BodyPartDamageTarget>(player: T, maxHealthPerPart?: number): T;
+/**
+ * Heal body parts proportionally based on total healing amount.
+ *
+ * **Korean**: 신체부위 비례 치유
+ *
+ * Distributes healing across all damaged body parts proportionally to
+ * their damage level. Most damaged parts receive more healing.
+ *
+ * @param player - Player state to heal
+ * @param totalHealAmount - Total healing to distribute
+ * @returns Updated player state with healing applied
+ *
+ * @public
+ */
+export declare function healBodyPartsProportionally<T extends BodyPartDamageTarget>(player: T, totalHealAmount: number): T;
+//# sourceMappingURL=BodyPartDamageIntegration.d.ts.map

package/lib/systems/bodypart/BodyPartDamageIntegration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BodyPartDamageIntegration.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/BodyPartDamageIntegration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAY,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,GACrB,UAAU,CAoGZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,oBAAoB,EACnE,MAAM,EAAE,CAAC,EACT,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,GACrB,CAAC,CA0BH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS,oBAAoB,EAC9B,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,CAAC,CAG3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,qCAiBpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAMT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iCAAiC,CAC/C,CAAC,SAAS,oBAAoB,EAC9B,MAAM,EAAE,CAAC,EAAE,gBAAgB,GAAE,MAAY,GAAG,CAAC,CAiB9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,oBAAoB,EACxE,MAAM,EAAE,CAAC,EACT,eAAe,EAAE,MAAM,GACtB,CAAC,CA+CH"}

package/lib/systems/bodypart/BodyPartDamageIntegration.js

@@ -0,0 +1,38 @@
+import "../../types/index.js";
+import { bodyPartHealthSystem } from "./BodyPartHealthSystem.js";
+//#region src/systems/bodypart/BodyPartDamageIntegration.ts
+/**
+* Apply damage to player's body parts based on hit location.
+*
+* **Korean**: 타격 위치 기반 신체부위 피해 적용
+*
+* Takes total damage and distributes it across body parts according to
+* the hit location. Updates both aggregate health and body part health.
+*
+* For combat compatibility, the aggregate health is directly reduced by
+* the damage amount (traditional behavior), while body part health is
+* updated proportionally for visualization purposes.
+*
+* @param player - Player receiving damage
+* @param totalDamage - Total damage amount
+* @param bodyRegion - Body region that was hit
+* @returns Updated player state with body part damage applied
+*
+* @public
+*/
+function applyDamageToBodyParts(player, totalDamage, bodyRegion) {
+	const bodyPartHealth = player.bodyPartHealth ?? bodyPartHealthSystem.createDefaultBodyPartHealth();
+	const bodyPartMaxHealth = player.bodyPartMaxHealth ?? bodyPartHealthSystem.createDefaultMaxHealth();
+	const updatedBodyPartHealth = bodyPartHealthSystem.applyDistributedDamage(bodyPartHealth, bodyRegion, totalDamage, bodyPartMaxHealth);
+	const newAggregateHealth = Math.max(0, player.health - totalDamage);
+	return {
+		...player,
+		bodyPartHealth: updatedBodyPartHealth,
+		bodyPartMaxHealth,
+		health: newAggregateHealth
+	};
+}
+//#endregion
+export { applyDamageToBodyParts };
+
+//# sourceMappingURL=BodyPartDamageIntegration.js.map

package/lib/systems/bodypart/BodyPartDamageIntegration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BodyPartDamageIntegration.js","names":[],"sources":["../../../src/systems/bodypart/BodyPartDamageIntegration.ts"],"sourcesContent":["/**\n * Body Part Damage Integration for Combat System\n *\n * **Korean**: 신체부위 피해 통합\n *\n * Extends the damage calculation system to apply damage to specific body parts\n * based on vital point hits and attack locations. Integrates with the existing\n * VitalPointSystem and DamageCalculator.\n *\n * @module systems/bodypart/BodyPartDamageIntegration\n * @category Body Part System\n * @korean 신체부위피해통합\n */\n\nimport { BodyRegion } from \"@/types\";\nimport type { VitalPoint } from \"../vitalpoint/types\";\nimport { bodyPartHealthSystem } from \"./BodyPartHealthSystem\";\nimport { BodyPart, BodyPartHealth, BodyPartMaxHealth } from \"./types\";\n\n/**\n * Minimal player view needed for body part damage operations.\n */\nexport interface BodyPartDamageTarget {\n  readonly health: number;\n  readonly bodyPartHealth?: BodyPartHealth;\n  readonly bodyPartMaxHealth?: BodyPartMaxHealth;\n}\n\n/**\n * Map vital point to its corresponding body region.\n *\n * **Korean**: 급소에서 신체 영역 매핑\n *\n * Analyzes a vital point's location and category to determine which\n * BodyRegion it belongs to, enabling proper damage distribution.\n *\n * @param vitalPoint - Vital point that was struck\n * @returns Corresponding body region\n *\n * @public\n */\nexport function getBodyRegionFromVitalPoint(\n  vitalPoint: VitalPoint\n): BodyRegion {\n  const pointId = vitalPoint.id.toLowerCase();\n\n  // Head region vital points\n  if (\n    pointId.includes(\"head_\") ||\n    pointId.includes(\"temple\") ||\n    pointId.includes(\"jaw\") ||\n    pointId.includes(\"crown\") ||\n    pointId.includes(\"forehead\") ||\n    pointId.includes(\"eye\") ||\n    pointId.includes(\"nose\") ||\n    pointId.includes(\"ear\") ||\n    pointId.includes(\"skull\")\n  ) {\n    return BodyRegion.HEAD;\n  }\n\n  // Neck region vital points\n  if (\n    pointId.includes(\"neck\") ||\n    pointId.includes(\"throat\") ||\n    pointId.includes(\"carotid\") ||\n    pointId.includes(\"cervical\")\n  ) {\n    return BodyRegion.NECK;\n  }\n\n  // Torso region vital points\n  if (\n    pointId.includes(\"torso_\") ||\n    pointId.includes(\"chest\") ||\n    pointId.includes(\"solar_plexus\") ||\n    pointId.includes(\"ribs\") ||\n    pointId.includes(\"sternum\") ||\n    pointId.includes(\"heart\") ||\n    pointId.includes(\"lung\") ||\n    pointId.includes(\"abdomen\")\n  ) {\n    return BodyRegion.TORSO;\n  }\n\n  // Core region vital points\n  if (\n    pointId.includes(\"core\") ||\n    pointId.includes(\"dantian\") ||\n    pointId.includes(\"kidney\") ||\n    pointId.includes(\"liver\") ||\n    pointId.includes(\"spleen\") ||\n    pointId.includes(\"bladder\")\n  ) {\n    return BodyRegion.CORE;\n  }\n\n  // Left arm vital points\n  if (\n    pointId.includes(\"arm_left\") ||\n    pointId.includes(\"left_shoulder\") ||\n    pointId.includes(\"left_elbow\") ||\n    pointId.includes(\"left_wrist\") ||\n    pointId.includes(\"left_hand\")\n  ) {\n    return BodyRegion.LEFT_ARM;\n  }\n\n  // Right arm vital points\n  if (\n    pointId.includes(\"arm_right\") ||\n    pointId.includes(\"right_shoulder\") ||\n    pointId.includes(\"right_elbow\") ||\n    pointId.includes(\"right_wrist\") ||\n    pointId.includes(\"right_hand\")\n  ) {\n    return BodyRegion.RIGHT_ARM;\n  }\n\n  // Left leg vital points\n  if (\n    pointId.includes(\"leg_left\") ||\n    pointId.includes(\"left_knee\") ||\n    pointId.includes(\"left_ankle\") ||\n    pointId.includes(\"left_foot\") ||\n    pointId.includes(\"left_thigh\")\n  ) {\n    return BodyRegion.LEFT_LEG;\n  }\n\n  // Right leg vital points\n  if (\n    pointId.includes(\"leg_right\") ||\n    pointId.includes(\"right_knee\") ||\n    pointId.includes(\"right_ankle\") ||\n    pointId.includes(\"right_foot\") ||\n    pointId.includes(\"right_thigh\")\n  ) {\n    return BodyRegion.RIGHT_LEG;\n  }\n\n  // Default to torso for unmatched points\n  return BodyRegion.TORSO;\n}\n\n/**\n * Apply damage to player's body parts based on hit location.\n *\n * **Korean**: 타격 위치 기반 신체부위 피해 적용\n *\n * Takes total damage and distributes it across body parts according to\n * the hit location. Updates both aggregate health and body part health.\n *\n * For combat compatibility, the aggregate health is directly reduced by\n * the damage amount (traditional behavior), while body part health is\n * updated proportionally for visualization purposes.\n *\n * @param player - Player receiving damage\n * @param totalDamage - Total damage amount\n * @param bodyRegion - Body region that was hit\n * @returns Updated player state with body part damage applied\n *\n * @public\n */\nexport function applyDamageToBodyParts<T extends BodyPartDamageTarget>(\n  player: T,\n  totalDamage: number,\n  bodyRegion: BodyRegion\n): T {\n  // If body part health not initialized, initialize it\n  const bodyPartHealth =\n    player.bodyPartHealth ?? bodyPartHealthSystem.createDefaultBodyPartHealth();\n  const bodyPartMaxHealth =\n    player.bodyPartMaxHealth ?? bodyPartHealthSystem.createDefaultMaxHealth();\n\n  // Apply distributed damage to body parts for visualization\n  const updatedBodyPartHealth = bodyPartHealthSystem.applyDistributedDamage(\n    bodyPartHealth,\n    bodyRegion,\n    totalDamage,\n    bodyPartMaxHealth\n  );\n\n  // Calculate new aggregate health directly: traditional damage reduction\n  // This ensures combat damage calculations remain consistent\n  const newAggregateHealth = Math.max(0, player.health - totalDamage);\n\n  // Update player state with new body part health and aggregate health\n  return {\n    ...player,\n    bodyPartHealth: updatedBodyPartHealth,\n    bodyPartMaxHealth,\n    health: newAggregateHealth,\n  };\n}\n\n/**\n * Apply damage from a vital point hit to appropriate body parts.\n *\n * **Korean**: 급소 타격 신체부위 피해 적용\n *\n * Specialized damage application for vital point strikes. Maps the vital\n * point to its body region and applies damage with appropriate distribution.\n *\n * @param player - Player receiving damage\n * @param totalDamage - Total damage amount\n * @param vitalPoint - Vital point that was struck\n * @returns Updated player state with vital point damage applied\n *\n * @public\n */\nexport function applyVitalPointDamageToBodyParts<\n  T extends BodyPartDamageTarget\n>(player: T, totalDamage: number, vitalPoint: VitalPoint): T {\n  const bodyRegion = getBodyRegionFromVitalPoint(vitalPoint);\n  return applyDamageToBodyParts(player, totalDamage, bodyRegion);\n}\n\n/**\n * Get combat capability modifiers from body part health.\n *\n * **Korean**: 신체부위 전투 능력 수정치 조회\n *\n * Calculates how body part damage affects combat capabilities.\n * Returns modifiers that should be applied to:\n * - Consciousness (awareness, reaction time)\n * - Stamina regeneration\n * - Attack damage output\n * - Movement speed\n * - Balance and stability\n * - Technique accuracy\n *\n * @param player - Player state to analyze\n * @returns Combat capability effect multipliers (0.0-1.0)\n *\n * @example\n * ```typescript\n * const effects = getBodyPartCombatEffects(player);\n * const actualDamage = baseDamage * effects.attackDamageModifier;\n * const actualSpeed = baseSpeed * effects.movementSpeedModifier;\n * ```\n *\n * @public\n */\nexport function getBodyPartCombatEffects(player: BodyPartDamageTarget) {\n  // If no body part health, return no effects\n  if (!player.bodyPartHealth) {\n    return {\n      consciousnessModifier: 1.0,\n      staminaRegenModifier: 1.0,\n      attackDamageModifier: 1.0,\n      movementSpeedModifier: 1.0,\n      balanceModifier: 1.0,\n      techniqueAccuracyModifier: 1.0,\n    };\n  }\n\n  return bodyPartHealthSystem.calculateBodyPartEffects(\n    player.bodyPartHealth,\n    player.bodyPartMaxHealth\n  );\n}\n\n/**\n * Check if player is incapacitated by body part damage.\n *\n * **Korean**: 신체부위 무력화 확인\n *\n * Determines if the player can continue fighting based on body part health.\n * Player is incapacitated if:\n * - Head is at 0 HP (unconscious)\n * - Both legs are at 0 HP (cannot stand)\n * - Aggregate health is below 10%\n *\n * @param player - Player state to check\n * @returns Whether player is incapacitated\n *\n * @public\n */\nexport function isPlayerIncapacitatedByBodyDamage(\n  player: BodyPartDamageTarget\n): boolean {\n  if (!player.bodyPartHealth) {\n    return false; // No body part system = use aggregate health only\n  }\n\n  return bodyPartHealthSystem.isIncapacitated(player.bodyPartHealth);\n}\n\n/**\n * Initialize body part health for a player.\n *\n * **Korean**: 플레이어 신체부위 체력 초기화\n *\n * Sets up body part health and max health for a player if not already present.\n * Uses the provided max health or defaults to 100 per part.\n *\n * @param player - Player state to initialize\n * @param maxHealthPerPart - Optional custom max health per part\n * @returns Player state with body part health initialized\n *\n * @public\n */\nexport function initializeBodyPartHealthForPlayer<\n  T extends BodyPartDamageTarget\n>(player: T, maxHealthPerPart: number = 100): T {\n  // Skip if already initialized\n  if (player.bodyPartHealth && player.bodyPartMaxHealth) {\n    return player;\n  }\n\n  const bodyPartHealth =\n    bodyPartHealthSystem.createDefaultBodyPartHealth(maxHealthPerPart);\n  const bodyPartMaxHealth =\n    bodyPartHealthSystem.createDefaultMaxHealth(maxHealthPerPart);\n\n  return {\n    ...player,\n    bodyPartHealth,\n    bodyPartMaxHealth,\n    health: bodyPartHealthSystem.calculateAggregateHealth(bodyPartHealth),\n  };\n}\n\n/**\n * Heal body parts proportionally based on total healing amount.\n *\n * **Korean**: 신체부위 비례 치유\n *\n * Distributes healing across all damaged body parts proportionally to\n * their damage level. Most damaged parts receive more healing.\n *\n * @param player - Player state to heal\n * @param totalHealAmount - Total healing to distribute\n * @returns Updated player state with healing applied\n *\n * @public\n */\nexport function healBodyPartsProportionally<T extends BodyPartDamageTarget>(\n  player: T,\n  totalHealAmount: number\n): T {\n  if (!player.bodyPartHealth || !player.bodyPartMaxHealth) {\n    return player; // No body part system active\n  }\n\n  const bodyPartHealth = player.bodyPartHealth;\n  const bodyPartMaxHealth = player.bodyPartMaxHealth;\n\n  // Calculate total missing health across all parts\n  const missingHealth = (Object.keys(bodyPartHealth) as BodyPart[]).reduce(\n    (sum, part) => {\n      return sum + (bodyPartMaxHealth[part] - bodyPartHealth[part]);\n    },\n    0\n  );\n\n  // If no damage, return unchanged\n  if (missingHealth <= 0) {\n    return player;\n  }\n\n  // Heal each part proportionally to its damage\n  let updatedHealth = { ...bodyPartHealth };\n\n  (Object.keys(bodyPartHealth) as BodyPart[]).forEach((part) => {\n    const partMissingHealth = bodyPartMaxHealth[part] - bodyPartHealth[part];\n    if (partMissingHealth > 0) {\n      const proportion = partMissingHealth / missingHealth;\n      const healForThisPart = totalHealAmount * proportion;\n      updatedHealth = bodyPartHealthSystem.healBodyPart(\n        updatedHealth,\n        part,\n        healForThisPart,\n        bodyPartMaxHealth\n      );\n    }\n  });\n\n  // Calculate new aggregate health\n  const newAggregateHealth =\n    bodyPartHealthSystem.calculateAggregateHealth(updatedHealth);\n\n  return {\n    ...player,\n    bodyPartHealth: updatedHealth,\n    health: newAggregateHealth,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoKA,SAAgB,uBACd,QACA,aACA,YACG;CAEH,MAAM,iBACJ,OAAO,kBAAkB,qBAAqB,6BAA6B;CAC7E,MAAM,oBACJ,OAAO,qBAAqB,qBAAqB,wBAAwB;CAG3E,MAAM,wBAAwB,qBAAqB,uBACjD,gBACA,YACA,aACA,kBACD;CAID,MAAM,qBAAqB,KAAK,IAAI,GAAG,OAAO,SAAS,YAAY;AAGnE,QAAO;EACL,GAAG;EACH,gBAAgB;EAChB;EACA,QAAQ;EACT"}