blacktrigram 0.7.44 → 0.7.47

package/lib/systems/physics/CollisionDetection.js.map

@@ -1 +1 @@
-{"version":3,"file":"CollisionDetection.js","names":[],"sources":["../../../src/systems/physics/CollisionDetection.ts"],"sourcesContent":["/**\n * Collision Detection System for Black Trigram combat physics.\n *\n * **Korean**: 충돌 감지 시스템\n *\n * Implements precise collision detection for the 70 vital points combat system using:\n * - Broad-phase AABB (Axis-Aligned Bounding Box) checks for performance\n * - Narrow-phase raycasting for precise vital point detection\n * - Attack reach validation based on technique and stance\n * - Bounding boxes for 5 anatomical regions\n *\n * ## Architecture\n *\n * The system uses a two-phase collision detection approach:\n *\n * 1. **Broad-phase**: Fast AABB checks to eliminate impossible collisions\n * 2. **Narrow-phase**: Precise raycasting to identify specific vital points\n *\n * This ensures 60fps performance even with complex collision queries.\n *\n * ## Performance\n *\n * - Broad-phase: O(1) per check (simple distance comparison)\n * - Narrow-phase: O(n) where n = vital points in region (typically 8-20)\n * - Target: <100 collision checks per frame for 60fps\n *\n * @example\n * ```typescript\n * const collision = new CollisionDetection();\n *\n * const result = collision.checkAttackHit(\n *   { x: 0, y: 0, z: 5 },        // Attacker position\n *   { x: 0, y: 0, z: 6.5 },      // Defender position\n *   { id: \"kick\", type: \"kick\" }, // Technique\n *   TrigramStance.LI,             // Attacker stance\n *   \"torso\"                       // Target region\n * );\n *\n * if (result.hit) {\n *   console.log(`Hit ${result.vitalPoint?.names.english}!`);\n *   console.log(`Accuracy: ${(result.accuracy * 100).toFixed(1)}%`);\n * }\n * ```\n *\n * @module systems/physics/CollisionDetection\n * @category Combat Systems\n * @korean 충돌감지시스템\n */\n\nimport * as THREE from \"three\";\nimport { TrigramStance } from \"../../types/common\";\nimport type {\n  AnatomicalRegionPhysics,\n  BoundingBox,\n  CollisionResult,\n  Position3D,\n  RaycastQuery,\n  TechniqueType,\n} from \"../../types/physics\";\nimport {\n  ANATOMICAL_DIMENSIONS,\n  BASE_REACH,\n  STANCE_REACH_MODIFIERS,\n} from \"../../types/physics\";\nimport type { VitalPoint } from \"../vitalpoint/types\";\nimport { VITAL_POINTS_DATA } from \"../vitalpoint/VitalPointsData\";\nimport { CoordinateMapper } from \"./CoordinateMapper\";\nimport { ThreeObjectPools } from \"../../utils/threeObjectPool\";\n\n/**\n * Collision Detection Engine for combat physics.\n *\n * **Korean**: 충돌 감지 엔진\n *\n * Provides efficient collision detection for combat using bounding boxes and raycasting.\n * Optimized for 60fps performance with multiple simultaneous collision checks.\n *\n * @public\n * @category Combat Systems\n * @korean 충돌감지엔진\n */\nexport class CollisionDetection {\n  private readonly boundingBoxes: Map<AnatomicalRegionPhysics, BoundingBox> =\n    new Map();\n  private readonly raycaster: THREE.Raycaster = new THREE.Raycaster();\n  private vitalPointsByRegion: Map<AnatomicalRegionPhysics, VitalPoint[]> =\n    new Map();\n\n  // Geometry cache for object pooling to avoid repeated allocations during combat\n  private readonly geometryCache: Map<string, THREE.BufferGeometry> = new Map();\n\n  // Coordinate mapper for 2D→3D conversion\n  private readonly coordinateMapper: CoordinateMapper;\n\n  /**\n   * Creates a new CollisionDetection instance.\n   *\n   * Initializes bounding boxes for all anatomical regions and organizes\n   * vital points by region for efficient lookup.\n   */\n  constructor() {\n    this.coordinateMapper = new CoordinateMapper();\n    this.initializeBoundingBoxes();\n    this.organizeVitalPointsByRegion();\n    this.initializeGeometryCache();\n  }\n\n  /**\n   * Cleans up Three.js resources.\n   *\n   * **Korean**: 자원 정리\n   *\n   * Disposes of cached geometries and releases memory to prevent leaks.\n   * Should be called when the CollisionDetection instance is no longer needed.\n   *\n   * @public\n   * @korean 자원정리\n   */\n  public dispose(): void {\n    // Dispose all cached geometries\n    for (const geometry of this.geometryCache.values()) {\n      geometry.dispose();\n    }\n    this.geometryCache.clear();\n  }\n\n  /**\n   * Checks if an attack hits the defender.\n   *\n   * **Korean**: 공격 타격 확인\n   *\n   * Performs two-phase collision detection:\n   * 1. Calculate effective attack reach based on technique and stance\n   * 2. Broad-phase: Check if defender is within reach\n   * 3. Broad-phase: Check if target region's AABB is within reach\n   * 4. Narrow-phase: Raycast to find precise vital point hit\n   *\n   * @param attackerPosition - 3D position of the attacker\n   * @param defenderPosition - 3D position of the defender\n   * @param technique - Technique being used with type information\n   * @param attackerStance - Attacker's current trigram stance\n   * @param targetRegion - Anatomical region being targeted\n   * @returns Collision result with hit status, vital point, distance, and accuracy\n   *\n   * @example\n   * ```typescript\n   * const result = collision.checkAttackHit(\n   *   { x: 0, y: 0, z: 5 },\n   *   { x: 0, y: 0, z: 6 },\n   *   { type: \"punch\" },\n   *   TrigramStance.GEON,\n   *   \"head\"\n   * );\n   * ```\n   *\n   * @public\n   * @korean 공격타격확인\n   */\n  checkAttackHit(\n    attackerPosition: Position3D,\n    defenderPosition: Position3D,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Technique object has dynamic properties from combat system\n    technique: { type?: string; [key: string]: any },\n    attackerStance: TrigramStance,\n    targetRegion: AnatomicalRegionPhysics,\n  ): CollisionResult {\n    // Calculate effective attack reach\n    const techniqueType = this.parseTechniqueType(technique.type);\n    const attackReach = this.calculateAttackReach(\n      techniqueType,\n      attackerStance,\n    );\n\n    // Calculate distance between attacker and defender\n    const distance = this.calculateDistance3D(\n      attackerPosition,\n      defenderPosition,\n    );\n\n    // Broad-phase: Check if defender is within reach\n    if (distance > attackReach.effectiveReach) {\n      return {\n        hit: false,\n        distance,\n        accuracy: 0,\n      };\n    }\n\n    // Get target region bounding box\n    const targetBox = this.boundingBoxes.get(targetRegion);\n    if (!targetBox) {\n      return {\n        hit: false,\n        distance,\n        accuracy: 0,\n      };\n    }\n\n    // Narrow-phase: Raycast from attacker to target region\n    const attackDirection = this.normalizeVector3D(\n      this.subtractVectors3D(defenderPosition, attackerPosition),\n    );\n\n    const raycastQuery: RaycastQuery = {\n      origin: attackerPosition,\n      direction: attackDirection,\n      maxDistance: attackReach.effectiveReach,\n      targetRegion,\n    };\n\n    // Check intersection with target bounding box\n    const intersection = this.raycastBoundingBox(\n      raycastQuery,\n      targetBox,\n      defenderPosition,\n    );\n\n    if (!intersection) {\n      return {\n        hit: false,\n        distance,\n        accuracy: 0,\n      };\n    }\n\n    // Determine specific vital point within region\n    const vitalPoint = this.identifyVitalPoint(\n      targetRegion,\n      intersection.point,\n      defenderPosition,\n    );\n\n    if (!vitalPoint) {\n      return {\n        hit: false,\n        distance,\n        accuracy: 0,\n      };\n    }\n\n    // Calculate accuracy (how close to vital point center)\n    const accuracy = this.calculateHitAccuracy(\n      intersection.point,\n      vitalPoint,\n      defenderPosition,\n    );\n\n    return {\n      hit: true,\n      region: targetRegion,\n      vitalPoint,\n      distance,\n      accuracy,\n      hitPoint: intersection.point,\n    };\n  }\n\n  /**\n   * Calculates effective attack reach for a technique.\n   *\n   * **Korean**: 공격 범위 계산\n   *\n   * Applies stance modifiers to base technique reach.\n   *\n   * @param techniqueType - Type of technique\n   * @param stance - Current trigram stance\n   * @returns Attack reach with all modifiers applied\n   *\n   * @private\n   * @korean 공격범위계산\n   */\n  private calculateAttackReach(\n    techniqueType: TechniqueType,\n    stance: TrigramStance,\n  ): {\n    technique: TechniqueType;\n    baseReach: number;\n    stance: TrigramStance;\n    stanceModifier: number;\n    effectiveReach: number;\n  } {\n    // Use BASE_REACH constant from physics types\n    const baseReach = BASE_REACH[techniqueType];\n\n    // Use STANCE_REACH_MODIFIERS constant from physics types\n    const stanceModifier = STANCE_REACH_MODIFIERS[stance];\n    const effectiveReach = baseReach * stanceModifier;\n\n    return {\n      technique: techniqueType,\n      baseReach,\n      stance,\n      stanceModifier,\n      effectiveReach,\n    };\n  }\n\n  /**\n   * Performs raycasting against a bounding box.\n   *\n   * **Korean**: 경계 상자 광선 투사\n   *\n   * Uses cached geometries from object pool to avoid repeated allocations\n   * during combat. Creates a Three.js mesh for the bounding box and performs\n   * raycasting to detect intersection points.\n   *\n   * Uses object pooling for Vector3 allocations to reduce GC pressure.\n   *\n   * @param query - Raycast query parameters\n   * @param box - Bounding box to test\n   * @param defenderPosition - Position of the defender\n   * @returns Intersection point or null if no hit\n   *\n   * @private\n   * @korean 경계상자광선투사\n   */\n  private raycastBoundingBox(\n    query: RaycastQuery,\n    box: BoundingBox,\n    defenderPosition: Position3D,\n  ): { point: Position3D } | null {\n    // Get cached geometry from pool to avoid repeated allocations\n    const cacheKey = `${box.type}-${box.region}`;\n    let geometry = this.geometryCache.get(cacheKey);\n\n    // If not cached (shouldn't happen after initialization), create it\n    if (!geometry) {\n      geometry = this.createGeometryForBox(box);\n      this.geometryCache.set(cacheKey, geometry);\n    }\n\n    // Create temporary mesh for raycasting (mesh is lightweight, geometry is cached)\n    const mesh = new THREE.Mesh(geometry);\n    mesh.position.set(\n      defenderPosition.x + box.center.x,\n      defenderPosition.y + box.center.y,\n      defenderPosition.z + box.center.z,\n    );\n\n    // Setup raycaster using pooled Vector3 objects to reduce GC pressure\n    // Wrap in try-finally to ensure pooled objects are always released\n    const origin = ThreeObjectPools.vector3.acquire();\n    const direction = ThreeObjectPools.vector3.acquire();\n\n    try {\n      origin.set(query.origin.x, query.origin.y, query.origin.z);\n      direction.set(query.direction.x, query.direction.y, query.direction.z);\n\n      this.raycaster.set(origin, direction);\n      this.raycaster.far = query.maxDistance;\n\n      // Perform raycast\n      const intersections = this.raycaster.intersectObject(mesh);\n\n      // Clean up temporary mesh (geometry remains cached)\n      // Note: mesh.material is undefined, no need to dispose\n\n      if (intersections.length > 0) {\n        const point = intersections[0].point;\n        return {\n          point: { x: point.x, y: point.y, z: point.z },\n        };\n      }\n\n      return null;\n    } finally {\n      // Release pooled objects back to pool (guaranteed even if exception occurs)\n      ThreeObjectPools.vector3.release(origin);\n      ThreeObjectPools.vector3.release(direction);\n    }\n  }\n\n  /**\n   * Creates Three.js geometry for a bounding box.\n   *\n   * Helper method for geometry cache initialization.\n   *\n   * @param box - Bounding box specification\n   * @returns Three.js geometry\n   *\n   * @private\n   * @korean 경계상자지오메트리생성\n   */\n  private createGeometryForBox(box: BoundingBox): THREE.BufferGeometry {\n    switch (box.type) {\n      case \"sphere\":\n        return new THREE.SphereGeometry(box.dimensions.x, 8, 8);\n      case \"box\":\n        return new THREE.BoxGeometry(\n          box.dimensions.x,\n          box.dimensions.y,\n          box.dimensions.z,\n        );\n      case \"capsule\":\n        return new THREE.CapsuleGeometry(\n          box.dimensions.x,\n          box.dimensions.y,\n          4,\n          8,\n        );\n    }\n  }\n\n  /**\n   * Identifies the specific vital point hit within a region.\n   *\n   * **Korean**: 급소 식별\n   *\n   * Finds the closest vital point to the hit location within the targeted region.\n   *\n   * @param region - Anatomical region hit\n   * @param hitPoint - 3D point where attack intersected\n   * @param defenderPosition - Position of the defender\n   * @returns Closest vital point or null if none found\n   *\n   * @private\n   * @korean 급소식별\n   */\n  private identifyVitalPoint(\n    region: AnatomicalRegionPhysics,\n    hitPoint: Position3D,\n    _defenderPosition: Position3D, // Prefixed with _ to indicate intentionally unused\n  ): VitalPoint | null {\n    // Get all vital points for this region\n    const vitalPoints = this.vitalPointsByRegion.get(region);\n    if (!vitalPoints || vitalPoints.length === 0) {\n      return null;\n    }\n\n    // Use CoordinateMapper to find the closest vital point in 3D space\n    const result = this.coordinateMapper.findClosestVitalPoint(\n      hitPoint,\n      vitalPoints,\n      region,\n    );\n\n    // For collision detection, we accept any vital point in the region\n    // even if it's not very close, as long as the region was hit\n    // This provides more forgiving collision detection while still\n    // using accurate 3D positioning for scoring/accuracy\n    return result\n      ? result.vitalPoint\n      : vitalPoints.length > 0\n        ? vitalPoints[0]\n        : null;\n  }\n\n  /**\n   * Calculates hit accuracy based on distance to vital point center.\n   *\n   * **Korean**: 타격 정확도 계산\n   *\n   * Accuracy decreases linearly with distance from vital point center.\n   * Perfect accuracy (1.0) at center, decreasing to 0 at 5cm radius.\n   *\n   * @param hitPoint - Point where attack landed\n   * @param vitalPoint - Target vital point\n   * @param defenderPosition - Position of the defender\n   * @returns Accuracy value from 0 to 1\n   *\n   * @private\n   * @korean 타격정확도계산\n   */\n  private calculateHitAccuracy(\n    hitPoint: Position3D,\n    vitalPoint: VitalPoint,\n    _defenderPosition: Position3D, // Prefixed with _ to indicate intentionally unused\n  ): number {\n    // Use CoordinateMapper to convert vital point to 3D and calculate distance\n    const distance = this.coordinateMapper.distanceToVitalPoint(\n      hitPoint,\n      vitalPoint,\n    );\n\n    // Accuracy calculation: Perfect (1.0) at center, decreasing to 0 at 5cm radius\n    const maxDistance = 0.05; // 5cm radius for vital points\n    const accuracy = Math.max(0, 1 - distance / maxDistance);\n\n    return accuracy;\n  }\n\n  /**\n   * Calculates Euclidean distance between two 3D points.\n   *\n   * @param pos1 - First position\n   * @param pos2 - Second position\n   * @returns Distance in meters\n   *\n   * @private\n   * @korean 3D거리계산\n   */\n  private calculateDistance3D(pos1: Position3D, pos2: Position3D): number {\n    const dx = pos1.x - pos2.x;\n    const dy = pos1.y - pos2.y;\n    const dz = pos1.z - pos2.z;\n    return Math.sqrt(dx * dx + dy * dy + dz * dz);\n  }\n\n  /**\n   * Subtracts one 3D vector from another.\n   *\n   * @param v1 - First vector\n   * @param v2 - Second vector\n   * @returns Resulting vector\n   *\n   * @private\n   * @korean 벡터빼기\n   */\n  private subtractVectors3D(v1: Position3D, v2: Position3D): Position3D {\n    return {\n      x: v1.x - v2.x,\n      y: v1.y - v2.y,\n      z: v1.z - v2.z,\n    };\n  }\n\n  /**\n   * Normalizes a 3D vector to unit length.\n   *\n   * @param vec - Vector to normalize\n   * @returns Normalized vector\n   *\n   * @private\n   * @korean 벡터정규화\n   */\n  private normalizeVector3D(vec: Position3D): Position3D {\n    const length = Math.sqrt(vec.x * vec.x + vec.y * vec.y + vec.z * vec.z);\n    if (length === 0) {\n      return { x: 0, y: 0, z: 1 }; // Default forward direction\n    }\n    return {\n      x: vec.x / length,\n      y: vec.y / length,\n      z: vec.z / length,\n    };\n  }\n\n  /**\n   * Parses technique type from string.\n   *\n   * @param techniqueTypeStr - Technique type as string\n   * @returns Parsed technique type\n   *\n   * @private\n   * @korean 기술유형파싱\n   */\n  private parseTechniqueType(techniqueTypeStr?: string): TechniqueType {\n    const typeMap: Record<string, TechniqueType> = {\n      punch: \"punch\",\n      kick: \"kick\",\n      elbow: \"elbow\",\n      knee: \"knee\",\n      pressure_point: \"pressure_point\",\n      strike: \"punch\", // Default strike to punch\n    };\n\n    return typeMap[techniqueTypeStr ?? \"punch\"] ?? \"punch\";\n  }\n\n  /**\n   * Initializes bounding boxes for all anatomical regions.\n   *\n   * Creates collision volumes for the 5 anatomical regions using the\n   * ANATOMICAL_DIMENSIONS constants from the physics types module.\n   *\n   * @private\n   * @korean 경계상자초기화\n   */\n  private initializeBoundingBoxes(): void {\n    // Head: Sphere (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"head\", {\n      type: ANATOMICAL_DIMENSIONS.head.type,\n      center: ANATOMICAL_DIMENSIONS.head.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.head.radius,\n        y: 0,\n        z: 0,\n      }, // radius only\n      region: \"head\",\n    });\n\n    // Neck: Capsule (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"neck\", {\n      type: ANATOMICAL_DIMENSIONS.neck.type,\n      center: ANATOMICAL_DIMENSIONS.neck.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.neck.radius,\n        y: ANATOMICAL_DIMENSIONS.neck.height,\n        z: 0,\n      }, // radius and height\n      region: \"neck\",\n    });\n\n    // Torso: Box (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"torso\", {\n      type: ANATOMICAL_DIMENSIONS.torso.type,\n      center: ANATOMICAL_DIMENSIONS.torso.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.torso.width,\n        y: ANATOMICAL_DIMENSIONS.torso.height,\n        z: ANATOMICAL_DIMENSIONS.torso.depth,\n      }, // width, height, depth\n      region: \"torso\",\n    });\n\n    // Arms: Capsules (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"arms\", {\n      type: ANATOMICAL_DIMENSIONS.arms.type,\n      center: ANATOMICAL_DIMENSIONS.arms.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.arms.radius,\n        y: ANATOMICAL_DIMENSIONS.arms.height,\n        z: 0,\n      }, // radius and length\n      region: \"arms\",\n    });\n\n    // Legs: Capsules (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"legs\", {\n      type: ANATOMICAL_DIMENSIONS.legs.type,\n      center: ANATOMICAL_DIMENSIONS.legs.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.legs.radius,\n        y: ANATOMICAL_DIMENSIONS.legs.height,\n        z: 0,\n      }, // radius and length\n      region: \"legs\",\n    });\n  }\n\n  /**\n   * Initializes geometry cache for object pooling.\n   *\n   * Pre-creates all geometries needed for raycasting to avoid repeated\n   * allocations during combat. Critical for maintaining 60fps with up to\n   * 100 collision checks per frame.\n   *\n   * @private\n   * @korean 지오메트리캐시초기화\n   */\n  private initializeGeometryCache(): void {\n    // Pre-create and cache geometries for all bounding boxes\n    for (const box of this.boundingBoxes.values()) {\n      const cacheKey = `${box.type}-${box.region}`;\n      const geometry = this.createGeometryForBox(box);\n      this.geometryCache.set(cacheKey, geometry);\n    }\n  }\n\n  /**\n   * Organizes vital points by anatomical region for efficient lookup.\n   *\n   * NOTE: This categorization currently uses y-coordinate thresholds that assume\n   * positions are in meters. However, VITAL_POINTS_DATA uses pixel coordinates\n   * (e.g., y: 50), which will cause incorrect categorization. Most vital points\n   * will end up in the \"legs\" region since pixel y-coordinates are typically less\n   * than 0.8.\n   *\n   * TODO: After implementing 2D→3D coordinate mapping, update this method to use\n   * the converted 3D positions, or use the anatomical region data that may already\n   * exist in the vital points data structure.\n   *\n   * Categorizes the 70 vital points into their respective regions:\n   * - Head: 10 vital points\n   * - Neck: 8 vital points\n   * - Torso: 20 vital points\n   * - Arms: 16 vital points\n   * - Legs: 16 vital points\n   *\n   * @private\n   * @korean 급소영역별정리\n   */\n  private organizeVitalPointsByRegion(): void {\n    const regionMap: Map<AnatomicalRegionPhysics, VitalPoint[]> = new Map([\n      [\"head\", []],\n      [\"neck\", []],\n      [\"torso\", []],\n      [\"arms\", []],\n      [\"legs\", []],\n    ]);\n\n    // Use existing VitalPointsData categorization by ID prefix\n    // This is more reliable than coordinate-based heuristics\n    for (const vp of VITAL_POINTS_DATA) {\n      let region: AnatomicalRegionPhysics;\n\n      // Categorize by ID prefix (existing VitalPointsData convention)\n      // Check neck-related patterns first (more specific) before head (broader)\n      if (\n        vp.id.includes(\"_neck\") ||\n        vp.id.includes(\"_throat\") ||\n        vp.id === \"head_side_neck\" ||\n        vp.id === \"head_throat\"\n      ) {\n        region = \"neck\";\n      } else if (vp.id.startsWith(\"head_\")) {\n        region = \"head\";\n      } else if (vp.id.startsWith(\"torso_\")) {\n        region = \"torso\";\n      } else if (\n        vp.id.startsWith(\"arm_left_\") ||\n        vp.id.startsWith(\"arm_right_\")\n      ) {\n        region = \"arms\";\n      } else if (\n        vp.id.startsWith(\"leg_left_\") ||\n        vp.id.startsWith(\"leg_right_\")\n      ) {\n        region = \"legs\";\n      } else {\n        // Default to torso for uncategorized points (core region)\n        region = \"torso\";\n      }\n\n      const list = regionMap.get(region);\n      if (list) {\n        list.push(vp);\n      }\n    }\n\n    this.vitalPointsByRegion = regionMap;\n  }\n\n  /**\n   * Gets the bounding box for an anatomical region.\n   *\n   * @param region - Anatomical region\n   * @returns Bounding box or undefined if not found\n   *\n   * @public\n   * @korean 경계상자조회\n   */\n  getBoundingBox(region: AnatomicalRegionPhysics): BoundingBox | undefined {\n    return this.boundingBoxes.get(region);\n  }\n\n  /**\n   * Gets all bounding boxes.\n   *\n   * @returns Map of all bounding boxes by region\n   *\n   * @public\n   * @korean 모든경계상자조회\n   */\n  getAllBoundingBoxes(): ReadonlyMap<AnatomicalRegionPhysics, BoundingBox> {\n    return this.boundingBoxes;\n  }\n\n  /**\n   * Gets vital points for a specific region.\n   *\n   * @param region - Anatomical region\n   * @returns Array of vital points in that region\n   *\n   * @public\n   * @korean 영역별급소조회\n   */\n  getVitalPointsInRegion(\n    region: AnatomicalRegionPhysics,\n  ): readonly VitalPoint[] {\n    return this.vitalPointsByRegion.get(region) ?? [];\n  }\n}\n\nexport default CollisionDetection;\n"],"mappings":"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"}
+{"version":3,"file":"CollisionDetection.js","names":[],"sources":["../../../src/systems/physics/CollisionDetection.ts"],"sourcesContent":["/**\n * Collision Detection System for Black Trigram combat physics.\n *\n * **Korean**: 충돌 감지 시스템\n *\n * Implements precise collision detection for the 70 vital points combat system using:\n * - Broad-phase AABB (Axis-Aligned Bounding Box) checks for performance\n * - Narrow-phase raycasting for precise vital point detection\n * - Attack reach validation based on technique and stance\n * - Bounding boxes for 5 anatomical regions\n *\n * ## Architecture\n *\n * The system uses a two-phase collision detection approach:\n *\n * 1. **Broad-phase**: Fast AABB checks to eliminate impossible collisions\n * 2. **Narrow-phase**: Precise raycasting to identify specific vital points\n *\n * This ensures 60fps performance even with complex collision queries.\n *\n * ## Performance\n *\n * - Broad-phase: O(1) per check (simple distance comparison)\n * - Narrow-phase: O(n) where n = vital points in region (typically 8-20)\n * - Target: <100 collision checks per frame for 60fps\n *\n * @example\n * ```typescript\n * const collision = new CollisionDetection();\n *\n * const result = collision.checkAttackHit(\n *   { x: 0, y: 0, z: 5 },        // Attacker position\n *   { x: 0, y: 0, z: 6.5 },      // Defender position\n *   { id: \"kick\", type: \"kick\" }, // Technique\n *   TrigramStance.LI,             // Attacker stance\n *   \"torso\"                       // Target region\n * );\n *\n * if (result.hit) {\n *   console.log(`Hit ${result.vitalPoint?.names.english}!`);\n *   console.log(`Accuracy: ${(result.accuracy * 100).toFixed(1)}%`);\n * }\n * ```\n *\n * @module systems/physics/CollisionDetection\n * @category Combat Systems\n * @korean 충돌감지시스템\n */\n\nimport * as THREE from \"three\";\nimport { TrigramStance } from \"../../types/common\";\nimport type {\n  AnatomicalRegionPhysics,\n  BoundingBox,\n  CollisionResult,\n  Position3D,\n  RaycastQuery,\n  TechniqueType,\n} from \"../../types/physics\";\nimport {\n  ANATOMICAL_DIMENSIONS,\n  BASE_REACH,\n  STANCE_REACH_MODIFIERS,\n} from \"../../types/physics\";\nimport type { VitalPoint } from \"../vitalpoint/types\";\nimport { VITAL_POINTS_DATA } from \"../vitalpoint/VitalPointsData\";\nimport { CoordinateMapper } from \"./CoordinateMapper\";\nimport { ThreeObjectPools } from \"../../utils/threeObjectPool\";\n\n/**\n * Collision Detection Engine for combat physics.\n *\n * **Korean**: 충돌 감지 엔진\n *\n * Provides efficient collision detection for combat using bounding boxes and raycasting.\n * Optimized for 60fps performance with multiple simultaneous collision checks.\n *\n * @category Combat Systems\n * @korean 충돌감지엔진\n */\nexport class CollisionDetection {\n  private readonly boundingBoxes: Map<AnatomicalRegionPhysics, BoundingBox> =\n    new Map();\n  private readonly raycaster: THREE.Raycaster = new THREE.Raycaster();\n  private vitalPointsByRegion: Map<AnatomicalRegionPhysics, VitalPoint[]> =\n    new Map();\n\n  // Geometry cache for object pooling to avoid repeated allocations during combat\n  private readonly geometryCache: Map<string, THREE.BufferGeometry> = new Map();\n\n  // Coordinate mapper for 2D→3D conversion\n  private readonly coordinateMapper: CoordinateMapper;\n\n  /**\n   * Creates a new CollisionDetection instance.\n   *\n   * Initializes bounding boxes for all anatomical regions and organizes\n   * vital points by region for efficient lookup.\n   */\n  constructor() {\n    this.coordinateMapper = new CoordinateMapper();\n    this.initializeBoundingBoxes();\n    this.organizeVitalPointsByRegion();\n    this.initializeGeometryCache();\n  }\n\n  /**\n   * Cleans up Three.js resources.\n   *\n   * **Korean**: 자원 정리\n   *\n   * Disposes of cached geometries and releases memory to prevent leaks.\n   * Should be called when the CollisionDetection instance is no longer needed.\n   *\n   * @korean 자원정리\n   */\n  public dispose(): void {\n    // Dispose all cached geometries\n    for (const geometry of this.geometryCache.values()) {\n      geometry.dispose();\n    }\n    this.geometryCache.clear();\n  }\n\n  /**\n   * Checks if an attack hits the defender.\n   *\n   * **Korean**: 공격 타격 확인\n   *\n   * Performs two-phase collision detection:\n   * 1. Calculate effective attack reach based on technique and stance\n   * 2. Broad-phase: Check if defender is within reach\n   * 3. Broad-phase: Check if target region's AABB is within reach\n   * 4. Narrow-phase: Raycast to find precise vital point hit\n   *\n   * @param attackerPosition - 3D position of the attacker\n   * @param defenderPosition - 3D position of the defender\n   * @param technique - Technique being used with type information\n   * @param attackerStance - Attacker's current trigram stance\n   * @param targetRegion - Anatomical region being targeted\n   * @returns Collision result with hit status, vital point, distance, and accuracy\n   *\n   * @example\n   * ```typescript\n   * const result = collision.checkAttackHit(\n   *   { x: 0, y: 0, z: 5 },\n   *   { x: 0, y: 0, z: 6 },\n   *   { type: \"punch\" },\n   *   TrigramStance.GEON,\n   *   \"head\"\n   * );\n   * ```\n   *\n   * @korean 공격타격확인\n   */\n  checkAttackHit(\n    attackerPosition: Position3D,\n    defenderPosition: Position3D,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Technique object has dynamic properties from combat system\n    technique: { type?: string; [key: string]: any },\n    attackerStance: TrigramStance,\n    targetRegion: AnatomicalRegionPhysics,\n  ): CollisionResult {\n    // Calculate effective attack reach\n    const techniqueType = this.parseTechniqueType(technique.type);\n    const attackReach = this.calculateAttackReach(\n      techniqueType,\n      attackerStance,\n    );\n\n    // Calculate distance between attacker and defender\n    const distance = this.calculateDistance3D(\n      attackerPosition,\n      defenderPosition,\n    );\n\n    // Broad-phase: Check if defender is within reach\n    if (distance > attackReach.effectiveReach) {\n      return {\n        hit: false,\n        distance,\n        accuracy: 0,\n      };\n    }\n\n    // Get target region bounding box\n    const targetBox = this.boundingBoxes.get(targetRegion);\n    if (!targetBox) {\n      return {\n        hit: false,\n        distance,\n        accuracy: 0,\n      };\n    }\n\n    // Narrow-phase: Raycast from attacker to target region\n    const attackDirection = this.normalizeVector3D(\n      this.subtractVectors3D(defenderPosition, attackerPosition),\n    );\n\n    const raycastQuery: RaycastQuery = {\n      origin: attackerPosition,\n      direction: attackDirection,\n      maxDistance: attackReach.effectiveReach,\n      targetRegion,\n    };\n\n    // Check intersection with target bounding box\n    const intersection = this.raycastBoundingBox(\n      raycastQuery,\n      targetBox,\n      defenderPosition,\n    );\n\n    if (!intersection) {\n      return {\n        hit: false,\n        distance,\n        accuracy: 0,\n      };\n    }\n\n    // Determine specific vital point within region\n    const vitalPoint = this.identifyVitalPoint(\n      targetRegion,\n      intersection.point,\n      defenderPosition,\n    );\n\n    if (!vitalPoint) {\n      return {\n        hit: false,\n        distance,\n        accuracy: 0,\n      };\n    }\n\n    // Calculate accuracy (how close to vital point center)\n    const accuracy = this.calculateHitAccuracy(\n      intersection.point,\n      vitalPoint,\n      defenderPosition,\n    );\n\n    return {\n      hit: true,\n      region: targetRegion,\n      vitalPoint,\n      distance,\n      accuracy,\n      hitPoint: intersection.point,\n    };\n  }\n\n  /**\n   * Calculates effective attack reach for a technique.\n   *\n   * **Korean**: 공격 범위 계산\n   *\n   * Applies stance modifiers to base technique reach.\n   *\n   * @param techniqueType - Type of technique\n   * @param stance - Current trigram stance\n   * @returns Attack reach with all modifiers applied\n   *\n   * @private\n   * @korean 공격범위계산\n   */\n  private calculateAttackReach(\n    techniqueType: TechniqueType,\n    stance: TrigramStance,\n  ): {\n    technique: TechniqueType;\n    baseReach: number;\n    stance: TrigramStance;\n    stanceModifier: number;\n    effectiveReach: number;\n  } {\n    // Use BASE_REACH constant from physics types\n    const baseReach = BASE_REACH[techniqueType];\n\n    // Use STANCE_REACH_MODIFIERS constant from physics types\n    const stanceModifier = STANCE_REACH_MODIFIERS[stance];\n    const effectiveReach = baseReach * stanceModifier;\n\n    return {\n      technique: techniqueType,\n      baseReach,\n      stance,\n      stanceModifier,\n      effectiveReach,\n    };\n  }\n\n  /**\n   * Performs raycasting against a bounding box.\n   *\n   * **Korean**: 경계 상자 광선 투사\n   *\n   * Uses cached geometries from object pool to avoid repeated allocations\n   * during combat. Creates a Three.js mesh for the bounding box and performs\n   * raycasting to detect intersection points.\n   *\n   * Uses object pooling for Vector3 allocations to reduce GC pressure.\n   *\n   * @param query - Raycast query parameters\n   * @param box - Bounding box to test\n   * @param defenderPosition - Position of the defender\n   * @returns Intersection point or null if no hit\n   *\n   * @private\n   * @korean 경계상자광선투사\n   */\n  private raycastBoundingBox(\n    query: RaycastQuery,\n    box: BoundingBox,\n    defenderPosition: Position3D,\n  ): { point: Position3D } | null {\n    // Get cached geometry from pool to avoid repeated allocations\n    const cacheKey = `${box.type}-${box.region}`;\n    let geometry = this.geometryCache.get(cacheKey);\n\n    // If not cached (shouldn't happen after initialization), create it\n    if (!geometry) {\n      geometry = this.createGeometryForBox(box);\n      this.geometryCache.set(cacheKey, geometry);\n    }\n\n    // Create temporary mesh for raycasting (mesh is lightweight, geometry is cached)\n    const mesh = new THREE.Mesh(geometry);\n    mesh.position.set(\n      defenderPosition.x + box.center.x,\n      defenderPosition.y + box.center.y,\n      defenderPosition.z + box.center.z,\n    );\n\n    // Setup raycaster using pooled Vector3 objects to reduce GC pressure\n    // Wrap in try-finally to ensure pooled objects are always released\n    const origin = ThreeObjectPools.vector3.acquire();\n    const direction = ThreeObjectPools.vector3.acquire();\n\n    try {\n      origin.set(query.origin.x, query.origin.y, query.origin.z);\n      direction.set(query.direction.x, query.direction.y, query.direction.z);\n\n      this.raycaster.set(origin, direction);\n      this.raycaster.far = query.maxDistance;\n\n      // Perform raycast\n      const intersections = this.raycaster.intersectObject(mesh);\n\n      // Clean up temporary mesh (geometry remains cached)\n      // Note: mesh.material is undefined, no need to dispose\n\n      if (intersections.length > 0) {\n        const point = intersections[0].point;\n        return {\n          point: { x: point.x, y: point.y, z: point.z },\n        };\n      }\n\n      return null;\n    } finally {\n      // Release pooled objects back to pool (guaranteed even if exception occurs)\n      ThreeObjectPools.vector3.release(origin);\n      ThreeObjectPools.vector3.release(direction);\n    }\n  }\n\n  /**\n   * Creates Three.js geometry for a bounding box.\n   *\n   * Helper method for geometry cache initialization.\n   *\n   * @param box - Bounding box specification\n   * @returns Three.js geometry\n   *\n   * @private\n   * @korean 경계상자지오메트리생성\n   */\n  private createGeometryForBox(box: BoundingBox): THREE.BufferGeometry {\n    switch (box.type) {\n      case \"sphere\":\n        return new THREE.SphereGeometry(box.dimensions.x, 8, 8);\n      case \"box\":\n        return new THREE.BoxGeometry(\n          box.dimensions.x,\n          box.dimensions.y,\n          box.dimensions.z,\n        );\n      case \"capsule\":\n        return new THREE.CapsuleGeometry(\n          box.dimensions.x,\n          box.dimensions.y,\n          4,\n          8,\n        );\n    }\n  }\n\n  /**\n   * Identifies the specific vital point hit within a region.\n   *\n   * **Korean**: 급소 식별\n   *\n   * Finds the closest vital point to the hit location within the targeted region.\n   *\n   * @param region - Anatomical region hit\n   * @param hitPoint - 3D point where attack intersected\n   * @param defenderPosition - Position of the defender\n   * @returns Closest vital point or null if none found\n   *\n   * @private\n   * @korean 급소식별\n   */\n  private identifyVitalPoint(\n    region: AnatomicalRegionPhysics,\n    hitPoint: Position3D,\n    _defenderPosition: Position3D, // Prefixed with _ to indicate intentionally unused\n  ): VitalPoint | null {\n    // Get all vital points for this region\n    const vitalPoints = this.vitalPointsByRegion.get(region);\n    if (!vitalPoints || vitalPoints.length === 0) {\n      return null;\n    }\n\n    // Use CoordinateMapper to find the closest vital point in 3D space\n    const result = this.coordinateMapper.findClosestVitalPoint(\n      hitPoint,\n      vitalPoints,\n      region,\n    );\n\n    // For collision detection, we accept any vital point in the region\n    // even if it's not very close, as long as the region was hit\n    // This provides more forgiving collision detection while still\n    // using accurate 3D positioning for scoring/accuracy\n    return result\n      ? result.vitalPoint\n      : vitalPoints.length > 0\n        ? vitalPoints[0]\n        : null;\n  }\n\n  /**\n   * Calculates hit accuracy based on distance to vital point center.\n   *\n   * **Korean**: 타격 정확도 계산\n   *\n   * Accuracy decreases linearly with distance from vital point center.\n   * Perfect accuracy (1.0) at center, decreasing to 0 at 5cm radius.\n   *\n   * @param hitPoint - Point where attack landed\n   * @param vitalPoint - Target vital point\n   * @param defenderPosition - Position of the defender\n   * @returns Accuracy value from 0 to 1\n   *\n   * @private\n   * @korean 타격정확도계산\n   */\n  private calculateHitAccuracy(\n    hitPoint: Position3D,\n    vitalPoint: VitalPoint,\n    _defenderPosition: Position3D, // Prefixed with _ to indicate intentionally unused\n  ): number {\n    // Use CoordinateMapper to convert vital point to 3D and calculate distance\n    const distance = this.coordinateMapper.distanceToVitalPoint(\n      hitPoint,\n      vitalPoint,\n    );\n\n    // Accuracy calculation: Perfect (1.0) at center, decreasing to 0 at 5cm radius\n    const maxDistance = 0.05; // 5cm radius for vital points\n    const accuracy = Math.max(0, 1 - distance / maxDistance);\n\n    return accuracy;\n  }\n\n  /**\n   * Calculates Euclidean distance between two 3D points.\n   *\n   * @param pos1 - First position\n   * @param pos2 - Second position\n   * @returns Distance in meters\n   *\n   * @private\n   * @korean 3D거리계산\n   */\n  private calculateDistance3D(pos1: Position3D, pos2: Position3D): number {\n    const dx = pos1.x - pos2.x;\n    const dy = pos1.y - pos2.y;\n    const dz = pos1.z - pos2.z;\n    return Math.sqrt(dx * dx + dy * dy + dz * dz);\n  }\n\n  /**\n   * Subtracts one 3D vector from another.\n   *\n   * @param v1 - First vector\n   * @param v2 - Second vector\n   * @returns Resulting vector\n   *\n   * @private\n   * @korean 벡터빼기\n   */\n  private subtractVectors3D(v1: Position3D, v2: Position3D): Position3D {\n    return {\n      x: v1.x - v2.x,\n      y: v1.y - v2.y,\n      z: v1.z - v2.z,\n    };\n  }\n\n  /**\n   * Normalizes a 3D vector to unit length.\n   *\n   * @param vec - Vector to normalize\n   * @returns Normalized vector\n   *\n   * @private\n   * @korean 벡터정규화\n   */\n  private normalizeVector3D(vec: Position3D): Position3D {\n    const length = Math.sqrt(vec.x * vec.x + vec.y * vec.y + vec.z * vec.z);\n    if (length === 0) {\n      return { x: 0, y: 0, z: 1 }; // Default forward direction\n    }\n    return {\n      x: vec.x / length,\n      y: vec.y / length,\n      z: vec.z / length,\n    };\n  }\n\n  /**\n   * Parses technique type from string.\n   *\n   * @param techniqueTypeStr - Technique type as string\n   * @returns Parsed technique type\n   *\n   * @private\n   * @korean 기술유형파싱\n   */\n  private parseTechniqueType(techniqueTypeStr?: string): TechniqueType {\n    const typeMap: Record<string, TechniqueType> = {\n      punch: \"punch\",\n      kick: \"kick\",\n      elbow: \"elbow\",\n      knee: \"knee\",\n      pressure_point: \"pressure_point\",\n      strike: \"punch\", // Default strike to punch\n    };\n\n    return typeMap[techniqueTypeStr ?? \"punch\"] ?? \"punch\";\n  }\n\n  /**\n   * Initializes bounding boxes for all anatomical regions.\n   *\n   * Creates collision volumes for the 5 anatomical regions using the\n   * ANATOMICAL_DIMENSIONS constants from the physics types module.\n   *\n   * @private\n   * @korean 경계상자초기화\n   */\n  private initializeBoundingBoxes(): void {\n    // Head: Sphere (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"head\", {\n      type: ANATOMICAL_DIMENSIONS.head.type,\n      center: ANATOMICAL_DIMENSIONS.head.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.head.radius,\n        y: 0,\n        z: 0,\n      }, // radius only\n      region: \"head\",\n    });\n\n    // Neck: Capsule (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"neck\", {\n      type: ANATOMICAL_DIMENSIONS.neck.type,\n      center: ANATOMICAL_DIMENSIONS.neck.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.neck.radius,\n        y: ANATOMICAL_DIMENSIONS.neck.height,\n        z: 0,\n      }, // radius and height\n      region: \"neck\",\n    });\n\n    // Torso: Box (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"torso\", {\n      type: ANATOMICAL_DIMENSIONS.torso.type,\n      center: ANATOMICAL_DIMENSIONS.torso.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.torso.width,\n        y: ANATOMICAL_DIMENSIONS.torso.height,\n        z: ANATOMICAL_DIMENSIONS.torso.depth,\n      }, // width, height, depth\n      region: \"torso\",\n    });\n\n    // Arms: Capsules (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"arms\", {\n      type: ANATOMICAL_DIMENSIONS.arms.type,\n      center: ANATOMICAL_DIMENSIONS.arms.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.arms.radius,\n        y: ANATOMICAL_DIMENSIONS.arms.height,\n        z: 0,\n      }, // radius and length\n      region: \"arms\",\n    });\n\n    // Legs: Capsules (from ANATOMICAL_DIMENSIONS)\n    this.boundingBoxes.set(\"legs\", {\n      type: ANATOMICAL_DIMENSIONS.legs.type,\n      center: ANATOMICAL_DIMENSIONS.legs.center,\n      dimensions: {\n        x: ANATOMICAL_DIMENSIONS.legs.radius,\n        y: ANATOMICAL_DIMENSIONS.legs.height,\n        z: 0,\n      }, // radius and length\n      region: \"legs\",\n    });\n  }\n\n  /**\n   * Initializes geometry cache for object pooling.\n   *\n   * Pre-creates all geometries needed for raycasting to avoid repeated\n   * allocations during combat. Critical for maintaining 60fps with up to\n   * 100 collision checks per frame.\n   *\n   * @private\n   * @korean 지오메트리캐시초기화\n   */\n  private initializeGeometryCache(): void {\n    // Pre-create and cache geometries for all bounding boxes\n    for (const box of this.boundingBoxes.values()) {\n      const cacheKey = `${box.type}-${box.region}`;\n      const geometry = this.createGeometryForBox(box);\n      this.geometryCache.set(cacheKey, geometry);\n    }\n  }\n\n  /**\n   * Organizes vital points by anatomical region for efficient lookup.\n   *\n   * NOTE: This categorization currently uses y-coordinate thresholds that assume\n   * positions are in meters. However, VITAL_POINTS_DATA uses pixel coordinates\n   * (e.g., y: 50), which will cause incorrect categorization. Most vital points\n   * will end up in the \"legs\" region since pixel y-coordinates are typically less\n   * than 0.8.\n   *\n   * TODO: After implementing 2D→3D coordinate mapping, update this method to use\n   * the converted 3D positions, or use the anatomical region data that may already\n   * exist in the vital points data structure.\n   *\n   * Categorizes the 70 vital points into their respective regions:\n   * - Head: 10 vital points\n   * - Neck: 8 vital points\n   * - Torso: 20 vital points\n   * - Arms: 16 vital points\n   * - Legs: 16 vital points\n   *\n   * @private\n   * @korean 급소영역별정리\n   */\n  private organizeVitalPointsByRegion(): void {\n    const regionMap: Map<AnatomicalRegionPhysics, VitalPoint[]> = new Map([\n      [\"head\", []],\n      [\"neck\", []],\n      [\"torso\", []],\n      [\"arms\", []],\n      [\"legs\", []],\n    ]);\n\n    // Use existing VitalPointsData categorization by ID prefix\n    // This is more reliable than coordinate-based heuristics\n    for (const vp of VITAL_POINTS_DATA) {\n      let region: AnatomicalRegionPhysics;\n\n      // Categorize by ID prefix (existing VitalPointsData convention)\n      // Check neck-related patterns first (more specific) before head (broader)\n      if (\n        vp.id.includes(\"_neck\") ||\n        vp.id.includes(\"_throat\") ||\n        vp.id === \"head_side_neck\" ||\n        vp.id === \"head_throat\"\n      ) {\n        region = \"neck\";\n      } else if (vp.id.startsWith(\"head_\")) {\n        region = \"head\";\n      } else if (vp.id.startsWith(\"torso_\")) {\n        region = \"torso\";\n      } else if (\n        vp.id.startsWith(\"arm_left_\") ||\n        vp.id.startsWith(\"arm_right_\")\n      ) {\n        region = \"arms\";\n      } else if (\n        vp.id.startsWith(\"leg_left_\") ||\n        vp.id.startsWith(\"leg_right_\")\n      ) {\n        region = \"legs\";\n      } else {\n        // Default to torso for uncategorized points (core region)\n        region = \"torso\";\n      }\n\n      const list = regionMap.get(region);\n      if (list) {\n        list.push(vp);\n      }\n    }\n\n    this.vitalPointsByRegion = regionMap;\n  }\n\n  /**\n   * Gets the bounding box for an anatomical region.\n   *\n   * @param region - Anatomical region\n   * @returns Bounding box or undefined if not found\n   *\n   * @korean 경계상자조회\n   */\n  getBoundingBox(region: AnatomicalRegionPhysics): BoundingBox | undefined {\n    return this.boundingBoxes.get(region);\n  }\n\n  /**\n   * Gets all bounding boxes.\n   *\n   * @returns Map of all bounding boxes by region\n   *\n   * @korean 모든경계상자조회\n   */\n  getAllBoundingBoxes(): ReadonlyMap<AnatomicalRegionPhysics, BoundingBox> {\n    return this.boundingBoxes;\n  }\n\n  /**\n   * Gets vital points for a specific region.\n   *\n   * @param region - Anatomical region\n   * @returns Array of vital points in that region\n   *\n   * @korean 영역별급소조회\n   */\n  getVitalPointsInRegion(\n    region: AnatomicalRegionPhysics,\n  ): readonly VitalPoint[] {\n    return this.vitalPointsByRegion.get(region) ?? [];\n  }\n}\n\nexport default CollisionDetection;\n"],"mappings":"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"}

package/lib/systems/physics/CoordinateMapper.d.ts

@@ -56,7 +56,6 @@ export interface CharacterModelConfig {
  * Provides bidirectional mapping between the 2D UI overlay coordinate system
  * and the 3D physics world coordinate system.
  *
- * @public
  * @category Physics System
  * @korean 좌표변환기
  */

package/lib/systems/physics/CoordinateMapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoordinateMapper.d.ts","sourceRoot":"","sources":["../../../src/systems/physics/CoordinateMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,mDAAmD;IACnD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAqFD;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C;;;;OAIG;gBACS,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAItD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,GAAG,UAAU;IAuBhF;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ;IAc/C;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU;IAMvD;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;;;;;;;;;;;;;OAgBG;IACH,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM;IAUzE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB,CACnB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,MAAM,CAAC,EAAE,uBAAuB,GAC/B;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA6BtD;;;;OAIG;IACH,SAAS,IAAI,oBAAoB;CAGlC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,kBAAyB,CAAC"}
+{"version":3,"file":"CoordinateMapper.d.ts","sourceRoot":"","sources":["../../../src/systems/physics/CoordinateMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,mDAAmD;IACnD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAqFD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C;;;;OAIG;gBACS,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAItD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,GAAG,UAAU;IAuBhF;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ;IAc/C;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU;IAMvD;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;;;;;;;;;;;;;OAgBG;IACH,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM;IAUzE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB,CACnB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,MAAM,CAAC,EAAE,uBAAuB,GAC/B;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA6BtD;;;;OAIG;IACH,SAAS,IAAI,oBAAoB;CAGlC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,kBAAyB,CAAC"}

package/lib/systems/physics/CoordinateMapper.js

@@ -51,7 +51,6 @@ var REGION_DEPTH_OFFSETS = {
 * Provides bidirectional mapping between the 2D UI overlay coordinate system
 * and the 3D physics world coordinate system.
 * 
-* @public
 * @category Physics System
 * @korean 좌표변환기
 */

package/lib/systems/physics/CoordinateMapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"CoordinateMapper.js","names":[],"sources":["../../../src/systems/physics/CoordinateMapper.ts"],"sourcesContent":["/**\n * Coordinate Mapper for 2D→3D conversion in Black Trigram.\n * \n * **Korean**: 좌표 변환기 (2D → 3D)\n * \n * Maps 2D pixel coordinates from the vital points data (UI overlay) to 3D world\n * coordinates for physics-based collision detection. This allows the UI-based\n * vital point system to work seamlessly with Three.js 3D collision detection.\n * \n * ## Coordinate Systems\n * \n * - **2D Pixel Space**: Origin (0,0) at top-left, used by vital points UI overlay\n * - **3D World Space**: Origin (0,0,0) at character center, used by collision detection\n * \n * ## Character Model Assumptions\n * \n * - Character height: 1.75m (average adult)\n * - Character width: 0.5m (shoulder width)\n * - Character depth: 0.3m (chest to back)\n * - Standing position: feet at y=0, head at y=1.75\n * \n * ## Mapping Strategy\n * \n * The mapper uses anatomical regions to determine the Z-depth (front-to-back position)\n * of vital points, ensuring physically accurate 3D positions for collision detection.\n * \n * @module systems/physics/CoordinateMapper\n * @category Physics System\n * @korean 좌표변환\n */\n\nimport type { Position } from \"@/types/common\";\nimport type { Position3D, AnatomicalRegionPhysics } from \"@/types/physics\";\nimport type { VitalPoint } from \"../vitalpoint/types\";\n\n/**\n * Configuration for the character model coordinate mapping.\n * \n * **Korean**: 캐릭터 모델 설정\n */\nexport interface CharacterModelConfig {\n  /** Character height in meters (default: 1.75m) */\n  readonly height: number;\n  \n  /** Character shoulder width in meters (default: 0.5m) */\n  readonly width: number;\n  \n  /** Character depth (chest to back) in meters (default: 0.3m) */\n  readonly depth: number;\n  \n  /** UI overlay width in pixels (default: 200px) */\n  readonly overlayWidth: number;\n  \n  /** UI overlay height in pixels (default: 300px) */\n  readonly overlayHeight: number;\n}\n\n/**\n * Average adult standing height used for physics mapping (meters).\n * \n * This value is based on common anthropometric data and provides a\n * reasonable default for a neutral, unarmed character in Black Trigram.\n */\nconst AVERAGE_ADULT_HEIGHT_M = 1.75; // 175cm average adult height\n\n/**\n * Average shoulder width used for frontal collision and UI mapping (meters).\n * \n * This approximates the biacromial (shoulder-to-shoulder) breadth for an\n * adult, which is sufficient for our hitbox and overlay alignment needs.\n */\nconst AVERAGE_SHOULDER_WIDTH_M = 0.5; // 50cm shoulder width\n\n/**\n * Average torso depth (chest to back) used for front/back hit placement (meters).\n */\nconst AVERAGE_TORSO_DEPTH_M = 0.3; // 30cm chest depth\n\n/**\n * Default UI overlay width in pixels.\n * \n * This matches the designed vital-point sprite asset width, ensuring that\n * pixel coordinates from the overlay map consistently to the 3D character.\n */\nconst DEFAULT_OVERLAY_WIDTH_PX = 200; // Standard UI overlay width\n\n/**\n * Default UI overlay height in pixels.\n * \n * This matches the designed vital-point sprite asset height, keeping the\n * 2D→3D mapping resolution-independent but asset-consistent.\n */\nconst DEFAULT_OVERLAY_HEIGHT_PX = 300; // Standard UI overlay height\n\n/**\n * Default character model configuration based on average adult proportions.\n */\nconst DEFAULT_CHARACTER_CONFIG: CharacterModelConfig = {\n  height: AVERAGE_ADULT_HEIGHT_M,\n  width: AVERAGE_SHOULDER_WIDTH_M,\n  depth: AVERAGE_TORSO_DEPTH_M,\n  overlayWidth: DEFAULT_OVERLAY_WIDTH_PX,\n  overlayHeight: DEFAULT_OVERLAY_HEIGHT_PX,\n};\n\n/**\n * Z-depth (front-to-back) offsets for different anatomical regions.\n * \n * Units are **meters in model space**, measured along the character's local Z axis,\n * and are applied relative to the character's center plane (Z = 0) and the\n * configured {@link CharacterModelConfig.depth}. With the default depth of\n * `0.3m`, an offset of `0.05` corresponds to ≈5 cm of forward displacement.\n *\n * These values were chosen as simple, stable approximations based on average\n * adult proportions and validated visually against the default rig:\n *\n * - `head: 0.05` → head center sits slightly in front of the torso plane\n *   (≈1/6 of torso depth) to match typical forward head posture.\n * - `neck: 0.02` → neck base is close to the torso plane but not perfectly\n *   centered, acknowledging slight anterior offset of the trachea/sternum.\n * - `torso: 0.0` → torso vital points lie on the reference center plane that\n *   approximates the mid‑chest / spine midpoint.\n * - `arms: 0.05` → relaxed arms hang slightly in front of the torso plane,\n *   using the same forward offset as the head for consistency.\n * - `legs: 0.0` → leg targets (front of thighs/shins) are modeled on the\n *   center plane; depth variation is instead captured by vertical placement.\n *\n * If you change {@link CharacterModelConfig.depth}, you may keep these absolute\n * meter values (for physical fidelity) or re‑express them as fractions of the\n * new depth, but they should continue to represent small (≈0–5 cm) anatomical\n * offsets from the torso midline.\n */\nconst REGION_DEPTH_OFFSETS: Record<AnatomicalRegionPhysics, number> = {\n  head: 0.05,    // ≈5 cm forward from torso mid-plane to match cranial alignment\n  neck: 0.02,    // ≈2 cm forward; neck base is near, but not exactly on, center\n  torso: 0.0,    // Torso reference plane (mid‑chest / spine midpoint)\n  arms: 0.05,    // ≈5 cm forward; relaxed arms rest slightly in front of torso\n  legs: 0.0,     // Legs aligned to torso center plane; front/back handled elsewhere\n};\n\n/**\n * Coordinate Mapper for converting 2D pixel coordinates to 3D world coordinates.\n * \n * **Korean**: 좌표 변환기\n * \n * Provides bidirectional mapping between the 2D UI overlay coordinate system\n * and the 3D physics world coordinate system.\n * \n * @public\n * @category Physics System\n * @korean 좌표변환기\n */\nexport class CoordinateMapper {\n  private readonly config: CharacterModelConfig;\n  \n  /**\n   * Creates a new CoordinateMapper with optional custom configuration.\n   * \n   * @param config - Optional character model configuration\n   */\n  constructor(config: Partial<CharacterModelConfig> = {}) {\n    this.config = { ...DEFAULT_CHARACTER_CONFIG, ...config };\n  }\n  \n  /**\n   * Converts a 2D pixel position to a 3D world position.\n   * \n   * **Korean**: 2D → 3D 변환\n   * \n   * Maps UI overlay pixel coordinates to 3D world space coordinates suitable\n   * for physics collision detection.\n   * \n   * @param pixel2D - 2D pixel position (origin top-left)\n   * @param region - Anatomical region for Z-depth calculation\n   * @returns 3D world position in meters (origin at character center)\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const vitalPoint = { position: { x: 100, y: 50 } };\n   * const worldPos = mapper.pixel2DToWorld3D(vitalPoint.position, \"head\");\n   * // worldPos: { x: 0, y: 1.45, z: 0.05 }\n   * ```\n   */\n  pixel2DToWorld3D(pixel2D: Position, region: AnatomicalRegionPhysics): Position3D {\n    // Normalize pixel coordinates to 0-1 range\n    const normalizedX = pixel2D.x / this.config.overlayWidth;\n    const normalizedY = pixel2D.y / this.config.overlayHeight;\n    \n    // Convert to world coordinates\n    // X: Map from pixel space (0 = left, overlayWidth = right) to world space (-width/2 to +width/2)\n    const worldX = (normalizedX - 0.5) * this.config.width;\n    \n    // Y: Map from pixel space (0 = top, overlayHeight = bottom) to world space (height to 0)\n    // Invert Y-axis: pixel 0 = top = character head, pixel overlayHeight = bottom = character feet\n    const worldY = (1 - normalizedY) * this.config.height;\n    \n    // Z: Use anatomical region to determine depth offset\n    const worldZ = REGION_DEPTH_OFFSETS[region];\n    \n    return {\n      x: worldX,\n      y: worldY,\n      z: worldZ,\n    };\n  }\n  \n  /**\n   * Converts a 3D world position to a 2D pixel position.\n   * \n   * **Korean**: 3D → 2D 변환\n   * \n   * Maps 3D world space coordinates back to UI overlay pixel coordinates.\n   * Useful for debugging and visual feedback.\n   * \n   * @param world3D - 3D world position in meters\n   * @returns 2D pixel position (origin top-left)\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const worldPos = { x: 0, y: 1.45, z: 0.05 };\n   * const pixelPos = mapper.world3DToPixel2D(worldPos);\n   * // pixelPos: { x: 100, y: 50 }\n   * ```\n   */\n  world3DToPixel2D(world3D: Position3D): Position {\n    // Convert world X to normalized 0-1 range\n    const normalizedX = (world3D.x / this.config.width) + 0.5;\n    \n    // Convert world Y to normalized 0-1 range (inverted)\n    const normalizedY = 1 - (world3D.y / this.config.height);\n    \n    // Convert to pixel coordinates\n    return {\n      x: Math.round(normalizedX * this.config.overlayWidth),\n      y: Math.round(normalizedY * this.config.overlayHeight),\n    };\n  }\n  \n  /**\n   * Converts a vital point's 2D position to 3D world position.\n   * \n   * **Korean**: 급소 위치 변환\n   * \n   * Convenience method that extracts position and region from a VitalPoint object.\n   * \n   * @param vitalPoint - Vital point with 2D position\n   * @returns 3D world position\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const temple = VITAL_POINTS_DATA.find(vp => vp.id === \"head_temple\");\n   * const worldPos = mapper.vitalPointToWorld3D(temple);\n   * ```\n   */\n  vitalPointToWorld3D(vitalPoint: VitalPoint): Position3D {\n    // Infer region from vital point ID prefix\n    const region = this.inferRegionFromId(vitalPoint.id);\n    return this.pixel2DToWorld3D(vitalPoint.position, region);\n  }\n  \n  /**\n   * Infers the anatomical region from a vital point ID.\n   * \n   * **Korean**: 급소 ID에서 영역 추론\n   * \n   * @param vitalPointId - Vital point ID (e.g., \"head_temple\", \"torso_solar_plexus\")\n   * @returns Anatomical region\n   * \n   * @private\n   */\n  private inferRegionFromId(vitalPointId: string): AnatomicalRegionPhysics {\n    if (vitalPointId.startsWith(\"head_\")) return \"head\";\n    if (vitalPointId.startsWith(\"neck_\")) return \"neck\";\n    if (vitalPointId.startsWith(\"torso_\")) return \"torso\";\n    if (vitalPointId.startsWith(\"arm_\")) return \"arms\";\n    if (vitalPointId.startsWith(\"leg_\")) return \"legs\";\n    \n    // Default to torso if no clear region prefix\n    return \"torso\";\n  }\n  \n  /**\n   * Calculates the distance between a 3D point and a vital point's 3D position.\n   * \n   * **Korean**: 거리 계산\n   * \n   * @param point3D - Point in 3D world space\n   * @param vitalPoint - Vital point to measure distance to\n   * @returns Distance in meters\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const attackPoint = { x: 0, y: 1.5, z: 0.1 };\n   * const temple = VITAL_POINTS_DATA.find(vp => vp.id === \"head_temple\");\n   * const distance = mapper.distanceToVitalPoint(attackPoint, temple);\n   * ```\n   */\n  distanceToVitalPoint(point3D: Position3D, vitalPoint: VitalPoint): number {\n    const vitalPoint3D = this.vitalPointToWorld3D(vitalPoint);\n    \n    const dx = point3D.x - vitalPoint3D.x;\n    const dy = point3D.y - vitalPoint3D.y;\n    const dz = point3D.z - vitalPoint3D.z;\n    \n    return Math.sqrt(dx * dx + dy * dy + dz * dz);\n  }\n  \n  /**\n   * Finds the closest vital point to a 3D position within a given region.\n   * \n   * **Korean**: 가장 가까운 급소 찾기\n   * \n   * @param point3D - Point in 3D world space\n   * @param vitalPoints - Array of vital points to search\n   * @param region - Optional region filter\n   * @returns Closest vital point and distance, or null if none found\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const hitPoint = { x: 0, y: 1.7, z: 0.05 };\n   * const result = mapper.findClosestVitalPoint(hitPoint, VITAL_POINTS_DATA, \"head\");\n   * if (result) {\n   *   console.log(`Hit ${result.vitalPoint.names.english} at ${result.distance}m`);\n   * }\n   * ```\n   */\n  findClosestVitalPoint(\n    point3D: Position3D,\n    vitalPoints: readonly VitalPoint[],\n    region?: AnatomicalRegionPhysics\n  ): { vitalPoint: VitalPoint; distance: number } | null {\n    let closestVitalPoint: VitalPoint | null = null;\n    let closestDistance = Infinity;\n    \n    for (const vitalPoint of vitalPoints) {\n      // Filter by region if specified\n      if (region) {\n        const vpRegion = this.inferRegionFromId(vitalPoint.id);\n        if (vpRegion !== region) continue;\n      }\n      \n      const distance = this.distanceToVitalPoint(point3D, vitalPoint);\n      \n      if (distance < closestDistance) {\n        closestDistance = distance;\n        closestVitalPoint = vitalPoint;\n      }\n    }\n    \n    if (closestVitalPoint === null) {\n      return null;\n    }\n    \n    return {\n      vitalPoint: closestVitalPoint,\n      distance: closestDistance,\n    };\n  }\n  \n  /**\n   * Gets the current character model configuration.\n   * \n   * @returns Current configuration\n   */\n  getConfig(): CharacterModelConfig {\n    return { ...this.config };\n  }\n}\n\n/**\n * Default singleton instance for convenient access.\n * \n * **Korean**: 기본 인스턴스\n * \n * @example\n * ```typescript\n * import { defaultCoordinateMapper } from './CoordinateMapper';\n * \n * const worldPos = defaultCoordinateMapper.pixel2DToWorld3D({ x: 100, y: 50 }, \"head\");\n * ```\n */\nexport const defaultCoordinateMapper = new CoordinateMapper();\n"],"mappings":";;;;AAiGA,IAAM,2BAAiD;CACrD,QAAQ;CACR,OAAO;CACP,OAAO;CACP,cAAc;CACd,eAAe;CAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BD,IAAM,uBAAgE;CACpE,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACP;;;;;;;;;;;;;AAcD,IAAa,mBAAb,MAA8B;CAC5B;;;;;;CAOA,YAAY,SAAwC,EAAE,EAAE;EACtD,KAAK,SAAS;GAAE,GAAG;GAA0B,GAAG;GAAQ;;;;;;;;;;;;;;;;;;;;;;CAuB1D,iBAAiB,SAAmB,QAA6C;EAE/E,MAAM,cAAc,QAAQ,IAAI,KAAK,OAAO;EAC5C,MAAM,cAAc,QAAQ,IAAI,KAAK,OAAO;EAa5C,OAAO;GACL,IAVc,cAAc,MAAO,KAAK,OAAO;GAW/C,IAPc,IAAI,eAAe,KAAK,OAAO;GAQ7C,GALa,qBAAqB;GAMnC;;;;;;;;;;;;;;;;;;;;;CAsBH,iBAAiB,SAA+B;EAE9C,MAAM,cAAe,QAAQ,IAAI,KAAK,OAAO,QAAS;EAGtD,MAAM,cAAc,IAAK,QAAQ,IAAI,KAAK,OAAO;EAGjD,OAAO;GACL,GAAG,KAAK,MAAM,cAAc,KAAK,OAAO,aAAa;GACrD,GAAG,KAAK,MAAM,cAAc,KAAK,OAAO,cAAc;GACvD;;;;;;;;;;;;;;;;;;;CAoBH,oBAAoB,YAAoC;EAEtD,MAAM,SAAS,KAAK,kBAAkB,WAAW,GAAG;EACpD,OAAO,KAAK,iBAAiB,WAAW,UAAU,OAAO;;;;;;;;;;;;CAa3D,kBAA0B,cAA+C;EACvE,IAAI,aAAa,WAAW,QAAQ,EAAE,OAAO;EAC7C,IAAI,aAAa,WAAW,QAAQ,EAAE,OAAO;EAC7C,IAAI,aAAa,WAAW,SAAS,EAAE,OAAO;EAC9C,IAAI,aAAa,WAAW,OAAO,EAAE,OAAO;EAC5C,IAAI,aAAa,WAAW,OAAO,EAAE,OAAO;EAG5C,OAAO;;;;;;;;;;;;;;;;;;;CAoBT,qBAAqB,SAAqB,YAAgC;EACxE,MAAM,eAAe,KAAK,oBAAoB,WAAW;EAEzD,MAAM,KAAK,QAAQ,IAAI,aAAa;EACpC,MAAM,KAAK,QAAQ,IAAI,aAAa;EACpC,MAAM,KAAK,QAAQ,IAAI,aAAa;EAEpC,OAAO,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;CAuB/C,sBACE,SACA,aACA,QACqD;EACrD,IAAI,oBAAuC;EAC3C,IAAI,kBAAkB;EAEtB,KAAK,MAAM,cAAc,aAAa;GAEpC,IAAI;QACe,KAAK,kBAAkB,WAAW,GAC/C,KAAa,QAAQ;;GAG3B,MAAM,WAAW,KAAK,qBAAqB,SAAS,WAAW;GAE/D,IAAI,WAAW,iBAAiB;IAC9B,kBAAkB;IAClB,oBAAoB;;;EAIxB,IAAI,sBAAsB,MACxB,OAAO;EAGT,OAAO;GACL,YAAY;GACZ,UAAU;GACX;;;;;;;CAQH,YAAkC;EAChC,OAAO,EAAE,GAAG,KAAK,QAAQ;;;AAgBU,IAAI,kBAAkB"}
+{"version":3,"file":"CoordinateMapper.js","names":[],"sources":["../../../src/systems/physics/CoordinateMapper.ts"],"sourcesContent":["/**\n * Coordinate Mapper for 2D→3D conversion in Black Trigram.\n * \n * **Korean**: 좌표 변환기 (2D → 3D)\n * \n * Maps 2D pixel coordinates from the vital points data (UI overlay) to 3D world\n * coordinates for physics-based collision detection. This allows the UI-based\n * vital point system to work seamlessly with Three.js 3D collision detection.\n * \n * ## Coordinate Systems\n * \n * - **2D Pixel Space**: Origin (0,0) at top-left, used by vital points UI overlay\n * - **3D World Space**: Origin (0,0,0) at character center, used by collision detection\n * \n * ## Character Model Assumptions\n * \n * - Character height: 1.75m (average adult)\n * - Character width: 0.5m (shoulder width)\n * - Character depth: 0.3m (chest to back)\n * - Standing position: feet at y=0, head at y=1.75\n * \n * ## Mapping Strategy\n * \n * The mapper uses anatomical regions to determine the Z-depth (front-to-back position)\n * of vital points, ensuring physically accurate 3D positions for collision detection.\n * \n * @module systems/physics/CoordinateMapper\n * @category Physics System\n * @korean 좌표변환\n */\n\nimport type { Position } from \"@/types/common\";\nimport type { Position3D, AnatomicalRegionPhysics } from \"@/types/physics\";\nimport type { VitalPoint } from \"../vitalpoint/types\";\n\n/**\n * Configuration for the character model coordinate mapping.\n * \n * **Korean**: 캐릭터 모델 설정\n */\nexport interface CharacterModelConfig {\n  /** Character height in meters (default: 1.75m) */\n  readonly height: number;\n  \n  /** Character shoulder width in meters (default: 0.5m) */\n  readonly width: number;\n  \n  /** Character depth (chest to back) in meters (default: 0.3m) */\n  readonly depth: number;\n  \n  /** UI overlay width in pixels (default: 200px) */\n  readonly overlayWidth: number;\n  \n  /** UI overlay height in pixels (default: 300px) */\n  readonly overlayHeight: number;\n}\n\n/**\n * Average adult standing height used for physics mapping (meters).\n * \n * This value is based on common anthropometric data and provides a\n * reasonable default for a neutral, unarmed character in Black Trigram.\n */\nconst AVERAGE_ADULT_HEIGHT_M = 1.75; // 175cm average adult height\n\n/**\n * Average shoulder width used for frontal collision and UI mapping (meters).\n * \n * This approximates the biacromial (shoulder-to-shoulder) breadth for an\n * adult, which is sufficient for our hitbox and overlay alignment needs.\n */\nconst AVERAGE_SHOULDER_WIDTH_M = 0.5; // 50cm shoulder width\n\n/**\n * Average torso depth (chest to back) used for front/back hit placement (meters).\n */\nconst AVERAGE_TORSO_DEPTH_M = 0.3; // 30cm chest depth\n\n/**\n * Default UI overlay width in pixels.\n * \n * This matches the designed vital-point sprite asset width, ensuring that\n * pixel coordinates from the overlay map consistently to the 3D character.\n */\nconst DEFAULT_OVERLAY_WIDTH_PX = 200; // Standard UI overlay width\n\n/**\n * Default UI overlay height in pixels.\n * \n * This matches the designed vital-point sprite asset height, keeping the\n * 2D→3D mapping resolution-independent but asset-consistent.\n */\nconst DEFAULT_OVERLAY_HEIGHT_PX = 300; // Standard UI overlay height\n\n/**\n * Default character model configuration based on average adult proportions.\n */\nconst DEFAULT_CHARACTER_CONFIG: CharacterModelConfig = {\n  height: AVERAGE_ADULT_HEIGHT_M,\n  width: AVERAGE_SHOULDER_WIDTH_M,\n  depth: AVERAGE_TORSO_DEPTH_M,\n  overlayWidth: DEFAULT_OVERLAY_WIDTH_PX,\n  overlayHeight: DEFAULT_OVERLAY_HEIGHT_PX,\n};\n\n/**\n * Z-depth (front-to-back) offsets for different anatomical regions.\n * \n * Units are **meters in model space**, measured along the character's local Z axis,\n * and are applied relative to the character's center plane (Z = 0) and the\n * configured {@link CharacterModelConfig.depth}. With the default depth of\n * `0.3m`, an offset of `0.05` corresponds to ≈5 cm of forward displacement.\n *\n * These values were chosen as simple, stable approximations based on average\n * adult proportions and validated visually against the default rig:\n *\n * - `head: 0.05` → head center sits slightly in front of the torso plane\n *   (≈1/6 of torso depth) to match typical forward head posture.\n * - `neck: 0.02` → neck base is close to the torso plane but not perfectly\n *   centered, acknowledging slight anterior offset of the trachea/sternum.\n * - `torso: 0.0` → torso vital points lie on the reference center plane that\n *   approximates the mid‑chest / spine midpoint.\n * - `arms: 0.05` → relaxed arms hang slightly in front of the torso plane,\n *   using the same forward offset as the head for consistency.\n * - `legs: 0.0` → leg targets (front of thighs/shins) are modeled on the\n *   center plane; depth variation is instead captured by vertical placement.\n *\n * If you change {@link CharacterModelConfig.depth}, you may keep these absolute\n * meter values (for physical fidelity) or re‑express them as fractions of the\n * new depth, but they should continue to represent small (≈0–5 cm) anatomical\n * offsets from the torso midline.\n */\nconst REGION_DEPTH_OFFSETS: Record<AnatomicalRegionPhysics, number> = {\n  head: 0.05,    // ≈5 cm forward from torso mid-plane to match cranial alignment\n  neck: 0.02,    // ≈2 cm forward; neck base is near, but not exactly on, center\n  torso: 0.0,    // Torso reference plane (mid‑chest / spine midpoint)\n  arms: 0.05,    // ≈5 cm forward; relaxed arms rest slightly in front of torso\n  legs: 0.0,     // Legs aligned to torso center plane; front/back handled elsewhere\n};\n\n/**\n * Coordinate Mapper for converting 2D pixel coordinates to 3D world coordinates.\n * \n * **Korean**: 좌표 변환기\n * \n * Provides bidirectional mapping between the 2D UI overlay coordinate system\n * and the 3D physics world coordinate system.\n * \n * @category Physics System\n * @korean 좌표변환기\n */\nexport class CoordinateMapper {\n  private readonly config: CharacterModelConfig;\n  \n  /**\n   * Creates a new CoordinateMapper with optional custom configuration.\n   * \n   * @param config - Optional character model configuration\n   */\n  constructor(config: Partial<CharacterModelConfig> = {}) {\n    this.config = { ...DEFAULT_CHARACTER_CONFIG, ...config };\n  }\n  \n  /**\n   * Converts a 2D pixel position to a 3D world position.\n   * \n   * **Korean**: 2D → 3D 변환\n   * \n   * Maps UI overlay pixel coordinates to 3D world space coordinates suitable\n   * for physics collision detection.\n   * \n   * @param pixel2D - 2D pixel position (origin top-left)\n   * @param region - Anatomical region for Z-depth calculation\n   * @returns 3D world position in meters (origin at character center)\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const vitalPoint = { position: { x: 100, y: 50 } };\n   * const worldPos = mapper.pixel2DToWorld3D(vitalPoint.position, \"head\");\n   * // worldPos: { x: 0, y: 1.45, z: 0.05 }\n   * ```\n   */\n  pixel2DToWorld3D(pixel2D: Position, region: AnatomicalRegionPhysics): Position3D {\n    // Normalize pixel coordinates to 0-1 range\n    const normalizedX = pixel2D.x / this.config.overlayWidth;\n    const normalizedY = pixel2D.y / this.config.overlayHeight;\n    \n    // Convert to world coordinates\n    // X: Map from pixel space (0 = left, overlayWidth = right) to world space (-width/2 to +width/2)\n    const worldX = (normalizedX - 0.5) * this.config.width;\n    \n    // Y: Map from pixel space (0 = top, overlayHeight = bottom) to world space (height to 0)\n    // Invert Y-axis: pixel 0 = top = character head, pixel overlayHeight = bottom = character feet\n    const worldY = (1 - normalizedY) * this.config.height;\n    \n    // Z: Use anatomical region to determine depth offset\n    const worldZ = REGION_DEPTH_OFFSETS[region];\n    \n    return {\n      x: worldX,\n      y: worldY,\n      z: worldZ,\n    };\n  }\n  \n  /**\n   * Converts a 3D world position to a 2D pixel position.\n   * \n   * **Korean**: 3D → 2D 변환\n   * \n   * Maps 3D world space coordinates back to UI overlay pixel coordinates.\n   * Useful for debugging and visual feedback.\n   * \n   * @param world3D - 3D world position in meters\n   * @returns 2D pixel position (origin top-left)\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const worldPos = { x: 0, y: 1.45, z: 0.05 };\n   * const pixelPos = mapper.world3DToPixel2D(worldPos);\n   * // pixelPos: { x: 100, y: 50 }\n   * ```\n   */\n  world3DToPixel2D(world3D: Position3D): Position {\n    // Convert world X to normalized 0-1 range\n    const normalizedX = (world3D.x / this.config.width) + 0.5;\n    \n    // Convert world Y to normalized 0-1 range (inverted)\n    const normalizedY = 1 - (world3D.y / this.config.height);\n    \n    // Convert to pixel coordinates\n    return {\n      x: Math.round(normalizedX * this.config.overlayWidth),\n      y: Math.round(normalizedY * this.config.overlayHeight),\n    };\n  }\n  \n  /**\n   * Converts a vital point's 2D position to 3D world position.\n   * \n   * **Korean**: 급소 위치 변환\n   * \n   * Convenience method that extracts position and region from a VitalPoint object.\n   * \n   * @param vitalPoint - Vital point with 2D position\n   * @returns 3D world position\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const temple = VITAL_POINTS_DATA.find(vp => vp.id === \"head_temple\");\n   * const worldPos = mapper.vitalPointToWorld3D(temple);\n   * ```\n   */\n  vitalPointToWorld3D(vitalPoint: VitalPoint): Position3D {\n    // Infer region from vital point ID prefix\n    const region = this.inferRegionFromId(vitalPoint.id);\n    return this.pixel2DToWorld3D(vitalPoint.position, region);\n  }\n  \n  /**\n   * Infers the anatomical region from a vital point ID.\n   * \n   * **Korean**: 급소 ID에서 영역 추론\n   * \n   * @param vitalPointId - Vital point ID (e.g., \"head_temple\", \"torso_solar_plexus\")\n   * @returns Anatomical region\n   * \n   * @private\n   */\n  private inferRegionFromId(vitalPointId: string): AnatomicalRegionPhysics {\n    if (vitalPointId.startsWith(\"head_\")) return \"head\";\n    if (vitalPointId.startsWith(\"neck_\")) return \"neck\";\n    if (vitalPointId.startsWith(\"torso_\")) return \"torso\";\n    if (vitalPointId.startsWith(\"arm_\")) return \"arms\";\n    if (vitalPointId.startsWith(\"leg_\")) return \"legs\";\n    \n    // Default to torso if no clear region prefix\n    return \"torso\";\n  }\n  \n  /**\n   * Calculates the distance between a 3D point and a vital point's 3D position.\n   * \n   * **Korean**: 거리 계산\n   * \n   * @param point3D - Point in 3D world space\n   * @param vitalPoint - Vital point to measure distance to\n   * @returns Distance in meters\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const attackPoint = { x: 0, y: 1.5, z: 0.1 };\n   * const temple = VITAL_POINTS_DATA.find(vp => vp.id === \"head_temple\");\n   * const distance = mapper.distanceToVitalPoint(attackPoint, temple);\n   * ```\n   */\n  distanceToVitalPoint(point3D: Position3D, vitalPoint: VitalPoint): number {\n    const vitalPoint3D = this.vitalPointToWorld3D(vitalPoint);\n    \n    const dx = point3D.x - vitalPoint3D.x;\n    const dy = point3D.y - vitalPoint3D.y;\n    const dz = point3D.z - vitalPoint3D.z;\n    \n    return Math.sqrt(dx * dx + dy * dy + dz * dz);\n  }\n  \n  /**\n   * Finds the closest vital point to a 3D position within a given region.\n   * \n   * **Korean**: 가장 가까운 급소 찾기\n   * \n   * @param point3D - Point in 3D world space\n   * @param vitalPoints - Array of vital points to search\n   * @param region - Optional region filter\n   * @returns Closest vital point and distance, or null if none found\n   * \n   * @example\n   * ```typescript\n   * const mapper = new CoordinateMapper();\n   * const hitPoint = { x: 0, y: 1.7, z: 0.05 };\n   * const result = mapper.findClosestVitalPoint(hitPoint, VITAL_POINTS_DATA, \"head\");\n   * if (result) {\n   *   console.log(`Hit ${result.vitalPoint.names.english} at ${result.distance}m`);\n   * }\n   * ```\n   */\n  findClosestVitalPoint(\n    point3D: Position3D,\n    vitalPoints: readonly VitalPoint[],\n    region?: AnatomicalRegionPhysics\n  ): { vitalPoint: VitalPoint; distance: number } | null {\n    let closestVitalPoint: VitalPoint | null = null;\n    let closestDistance = Infinity;\n    \n    for (const vitalPoint of vitalPoints) {\n      // Filter by region if specified\n      if (region) {\n        const vpRegion = this.inferRegionFromId(vitalPoint.id);\n        if (vpRegion !== region) continue;\n      }\n      \n      const distance = this.distanceToVitalPoint(point3D, vitalPoint);\n      \n      if (distance < closestDistance) {\n        closestDistance = distance;\n        closestVitalPoint = vitalPoint;\n      }\n    }\n    \n    if (closestVitalPoint === null) {\n      return null;\n    }\n    \n    return {\n      vitalPoint: closestVitalPoint,\n      distance: closestDistance,\n    };\n  }\n  \n  /**\n   * Gets the current character model configuration.\n   * \n   * @returns Current configuration\n   */\n  getConfig(): CharacterModelConfig {\n    return { ...this.config };\n  }\n}\n\n/**\n * Default singleton instance for convenient access.\n * \n * **Korean**: 기본 인스턴스\n * \n * @example\n * ```typescript\n * import { defaultCoordinateMapper } from './CoordinateMapper';\n * \n * const worldPos = defaultCoordinateMapper.pixel2DToWorld3D({ x: 100, y: 50 }, \"head\");\n * ```\n */\nexport const defaultCoordinateMapper = new CoordinateMapper();\n"],"mappings":";;;;AAiGA,IAAM,2BAAiD;CACrD,QAAQ;CACR,OAAO;CACP,OAAO;CACP,cAAc;CACd,eAAe;CAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BD,IAAM,uBAAgE;CACpE,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACP;;;;;;;;;;;;AAaD,IAAa,mBAAb,MAA8B;CAC5B;;;;;;CAOA,YAAY,SAAwC,EAAE,EAAE;EACtD,KAAK,SAAS;GAAE,GAAG;GAA0B,GAAG;GAAQ;;;;;;;;;;;;;;;;;;;;;;CAuB1D,iBAAiB,SAAmB,QAA6C;EAE/E,MAAM,cAAc,QAAQ,IAAI,KAAK,OAAO;EAC5C,MAAM,cAAc,QAAQ,IAAI,KAAK,OAAO;EAa5C,OAAO;GACL,IAVc,cAAc,MAAO,KAAK,OAAO;GAW/C,IAPc,IAAI,eAAe,KAAK,OAAO;GAQ7C,GALa,qBAAqB;GAMnC;;;;;;;;;;;;;;;;;;;;;CAsBH,iBAAiB,SAA+B;EAE9C,MAAM,cAAe,QAAQ,IAAI,KAAK,OAAO,QAAS;EAGtD,MAAM,cAAc,IAAK,QAAQ,IAAI,KAAK,OAAO;EAGjD,OAAO;GACL,GAAG,KAAK,MAAM,cAAc,KAAK,OAAO,aAAa;GACrD,GAAG,KAAK,MAAM,cAAc,KAAK,OAAO,cAAc;GACvD;;;;;;;;;;;;;;;;;;;CAoBH,oBAAoB,YAAoC;EAEtD,MAAM,SAAS,KAAK,kBAAkB,WAAW,GAAG;EACpD,OAAO,KAAK,iBAAiB,WAAW,UAAU,OAAO;;;;;;;;;;;;CAa3D,kBAA0B,cAA+C;EACvE,IAAI,aAAa,WAAW,QAAQ,EAAE,OAAO;EAC7C,IAAI,aAAa,WAAW,QAAQ,EAAE,OAAO;EAC7C,IAAI,aAAa,WAAW,SAAS,EAAE,OAAO;EAC9C,IAAI,aAAa,WAAW,OAAO,EAAE,OAAO;EAC5C,IAAI,aAAa,WAAW,OAAO,EAAE,OAAO;EAG5C,OAAO;;;;;;;;;;;;;;;;;;;CAoBT,qBAAqB,SAAqB,YAAgC;EACxE,MAAM,eAAe,KAAK,oBAAoB,WAAW;EAEzD,MAAM,KAAK,QAAQ,IAAI,aAAa;EACpC,MAAM,KAAK,QAAQ,IAAI,aAAa;EACpC,MAAM,KAAK,QAAQ,IAAI,aAAa;EAEpC,OAAO,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;CAuB/C,sBACE,SACA,aACA,QACqD;EACrD,IAAI,oBAAuC;EAC3C,IAAI,kBAAkB;EAEtB,KAAK,MAAM,cAAc,aAAa;GAEpC,IAAI;QACe,KAAK,kBAAkB,WAAW,GAC/C,KAAa,QAAQ;;GAG3B,MAAM,WAAW,KAAK,qBAAqB,SAAS,WAAW;GAE/D,IAAI,WAAW,iBAAiB;IAC9B,kBAAkB;IAClB,oBAAoB;;;EAIxB,IAAI,sBAAsB,MACxB,OAAO;EAGT,OAAO;GACL,YAAY;GACZ,UAAU;GACX;;;;;;;CAQH,YAAkC;EAChC,OAAO,EAAE,GAAG,KAAK,QAAQ;;;AAgBU,IAAI,kBAAkB"}

package/lib/systems/physics/KnockbackPhysics.d.ts

@@ -38,7 +38,6 @@ import { TrigramStance } from '../../types/common';
  *
  * **Korean**: 균형 상태 (Balance State)
  *
- * @public
  * @korean 균형상태
  */
 export interface BalanceState {
@@ -52,7 +51,6 @@ export interface BalanceState {
  *
  * **Korean**: 밀침 설정 (Knockback Configuration)
  *
- * @public
  * @korean 밀침설정
  */
 export interface KnockbackConfig {
@@ -74,7 +72,6 @@ export interface KnockbackConfig {
  *
  * Contains displacement vector, animation timing, and fall determination.
  *
- * @public
  * @korean 밀침결과
  */
 export interface KnockbackResult {
@@ -115,7 +112,6 @@ export interface KnockbackResult {
  * // recoveryWindow: 1.05s (0.7s * 1.5 for low balance)
  * ```
  *
- * @public
  * @korean 밀침물리
  */
 export declare class KnockbackPhysics {
@@ -157,7 +153,6 @@ export declare class KnockbackPhysics {
      * // Result: ~9.6m knockback, shouldFall: true, 3.0s recovery
      * ```
      *
-     * @public
      * @korean 밀침계산
      */
     calculateKnockback(config: KnockbackConfig, attackDamage: number): KnockbackResult;
@@ -289,7 +284,6 @@ export declare class KnockbackPhysics {
      * // Progress 1.0: At final position
      * ```
      *
-     * @public
      * @korean 밀침힘적용
      */
     applyKnockbackForce(playerPosition: THREE.Vector3, result: KnockbackResult, _deltaTime: number, progress: number): THREE.Vector3;
@@ -302,7 +296,6 @@ export declare class KnockbackPhysics {
      * @param duration - Total knockback duration
      * @returns True if still in knockback animation
      *
-     * @public
      * @korean 밀침상태확인
      */
     isInKnockback(elapsedTime: number, duration: number): boolean;
@@ -315,7 +308,6 @@ export declare class KnockbackPhysics {
      * @param recoveryWindow - Total recovery window duration
      * @returns True if in vulnerable recovery state
      *
-     * @public
      * @korean 회복대기확인
      */
     isInRecoveryWindow(elapsedTime: number, recoveryWindow: number): boolean;
@@ -327,7 +319,6 @@ export declare class KnockbackPhysics {
      * @param shouldFall - Whether knockback causes fall
      * @returns Korean and English state names
      *
-     * @public
      * @korean 밀침상태이름
      */
     static getKnockbackStateName(shouldFall: boolean): {
@@ -341,7 +332,6 @@ export declare class KnockbackPhysics {
      *
      * @returns Korean and English state names
      *
-     * @public
      * @korean 회복상태이름
      */
     getRecoveryStateName(): {
@@ -355,7 +345,6 @@ export declare class KnockbackPhysics {
      *
      * @returns Korean and English state names
      *
-     * @public
      * @korean 휘청거림상태이름
      */
     getStumblingStateName(): {

package/lib/systems/physics/KnockbackPhysics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KnockbackPhysics.d.ts","sourceRoot":"","sources":["../../../src/systems/physics/KnockbackPhysics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,6BAA6B;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC;IACrC,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe;IAgClF;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,0BAA0B;IAKlC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,mBAAmB,CACjB,cAAc,EAAE,KAAK,CAAC,OAAO,EAC7B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC,OAAO;IAchB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI7D;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAIxE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IActF;;;;;;;;;OASG;IACH,oBAAoB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAO3D;;;;;;;;;OASG;IACH,qBAAqB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAM7D;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"KnockbackPhysics.d.ts","sourceRoot":"","sources":["../../../src/systems/physics/KnockbackPhysics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,6BAA6B;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC;IACrC,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe;IAgClF;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,0BAA0B;IAKlC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,mBAAmB,CACjB,cAAc,EAAE,KAAK,CAAC,OAAO,EAC7B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC,OAAO;IAchB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI7D;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAIxE;;;;;;;;;OASG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IActF;;;;;;;;OAQG;IACH,oBAAoB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAO3D;;;;;;;;OAQG;IACH,qBAAqB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAM7D;AAED,eAAe,gBAAgB,CAAC"}

package/lib/systems/physics/KnockbackPhysics.js

@@ -28,7 +28,6 @@ import { TrigramStance } from "../../types/common.js";
 * // recoveryWindow: 1.05s (0.7s * 1.5 for low balance)
 * ```
 * 
-* @public
 * @korean 밀침물리
 */
 var KnockbackPhysics = class {
@@ -70,7 +69,6 @@ var KnockbackPhysics = class {
 	* // Result: ~9.6m knockback, shouldFall: true, 3.0s recovery
 	* ```
 	* 
-	* @public
 	* @korean 밀침계산
 	*/
 	calculateKnockback(config, attackDamage) {
@@ -240,7 +238,6 @@ var KnockbackPhysics = class {
 	* // Progress 1.0: At final position
 	* ```
 	* 
-	* @public
 	* @korean 밀침힘적용
 	*/
 	applyKnockbackForce(playerPosition, result, _deltaTime, progress) {
@@ -257,7 +254,6 @@ var KnockbackPhysics = class {
 	* @param duration - Total knockback duration
 	* @returns True if still in knockback animation
 	* 
-	* @public
 	* @korean 밀침상태확인
 	*/
 	isInKnockback(elapsedTime, duration) {
@@ -272,7 +268,6 @@ var KnockbackPhysics = class {
 	* @param recoveryWindow - Total recovery window duration
 	* @returns True if in vulnerable recovery state
 	* 
-	* @public
 	* @korean 회복대기확인
 	*/
 	isInRecoveryWindow(elapsedTime, recoveryWindow) {
@@ -286,7 +281,6 @@ var KnockbackPhysics = class {
 	* @param shouldFall - Whether knockback causes fall
 	* @returns Korean and English state names
 	* 
-	* @public
 	* @korean 밀침상태이름
 	*/
 	static getKnockbackStateName(shouldFall) {
@@ -306,7 +300,6 @@ var KnockbackPhysics = class {
 	* 
 	* @returns Korean and English state names
 	* 
-	* @public
 	* @korean 회복상태이름
 	*/
 	getRecoveryStateName() {
@@ -322,7 +315,6 @@ var KnockbackPhysics = class {
 	* 
 	* @returns Korean and English state names
 	* 
-	* @public
 	* @korean 휘청거림상태이름
 	*/
 	getStumblingStateName() {

package/lib/systems/physics/KnockbackPhysics.js.map

@@ -1 +1 @@
-{"version":3,"file":"KnockbackPhysics.js","names":[],"sources":["../../../src/systems/physics/KnockbackPhysics.ts"],"sourcesContent":["/**\n * Knockback Physics System for realistic force-based displacement.\n * \n * **Korean**: 밀침 물리 시스템 (Knockback Physics System)\n * \n * Implements realistic combat knockback mechanics that calculate force-based\n * displacement when players are hit. The system integrates with BalanceSystem\n * for authentic stumbling/falling reactions.\n * \n * ## Knockback Mechanics\n * \n * Knockback force is determined by:\n * - Attack damage and technique type\n * - Impact angle and direction\n * - Current balance state\n * - Stance resistance modifiers (8 trigram stances)\n * \n * ## Balance Integration\n * \n * - High balance (>70%): Reduced knockback by 30%\n * - Medium balance (40-70%): Normal knockback\n * - Low balance (<40%): Increased knockback by 50%, stumbling\n * - Critical balance (<20%): Guaranteed fall, 2s recovery\n * \n * ## Performance\n * \n * Optimized for 60fps with efficient vector calculations and smooth\n * easing curves for realistic knockback feel.\n * \n * @module systems/physics/KnockbackPhysics\n * @category Physics System\n * @korean 밀침물리\n */\n\nimport * as THREE from 'three';\nimport { TrigramStance } from '@/types/common';\n\n/**\n * Balance state information for knockback calculations.\n * \n * **Korean**: 균형 상태 (Balance State)\n * \n * @public\n * @korean 균형상태\n */\nexport interface BalanceState {\n  /** Current balance value (0-100) */\n  readonly current: number;\n  /** Maximum balance value (typically 100) */\n  readonly max: number;\n}\n\n/**\n * Configuration for knockback force calculation.\n * \n * **Korean**: 밀침 설정 (Knockback Configuration)\n * \n * @public\n * @korean 밀침설정\n */\nexport interface KnockbackConfig {\n  /** Force magnitude in Newtons */\n  readonly force: number;\n  /** Normalized attack direction vector (attacker → defender) */\n  readonly direction: THREE.Vector3;\n  /** Duration of knockback effect in seconds */\n  readonly duration: number;\n  /** Current balance state */\n  readonly balanceState: BalanceState;\n  /** Current trigram stance */\n  readonly currentStance: TrigramStance;\n}\n\n/**\n * Result of knockback calculation.\n * \n * **Korean**: 밀침 결과 (Knockback Result)\n * \n * Contains displacement vector, animation timing, and fall determination.\n * \n * @public\n * @korean 밀침결과\n */\nexport interface KnockbackResult {\n  /** Total knockback displacement vector in world space */\n  readonly displacement: THREE.Vector3;\n  /** Duration of knockback animation in seconds */\n  readonly duration: number;\n  /** Vulnerable state duration after knockback ends in seconds */\n  readonly recoveryWindow: number;\n  /** Whether fall animation should trigger */\n  readonly shouldFall: boolean;\n}\n\n/**\n * Knockback Physics Engine.\n * \n * **Korean**: 밀침 물리 엔진\n * \n * Calculates realistic knockback displacement based on attack force,\n * stance resistance, and balance state. Integrates with BalanceSystem\n * for stumbling and falling mechanics.\n * \n * @example\n * ```typescript\n * const physics = new KnockbackPhysics();\n * \n * // Calculate knockback from heavy strike\n * const config: KnockbackConfig = {\n *   force: 800, // 80 damage\n *   direction: new THREE.Vector3(1, 0, 0).normalize(),\n *   duration: 0.8,\n *   balanceState: { current: 35, max: 100 }, // Low balance\n *   currentStance: TrigramStance.LI, // Fire stance (low resistance)\n * };\n * \n * const result = physics.calculateKnockback(config, 80);\n * // Result: 2.5m base * 1.3 (Fire penalty) * 1.5 (low balance) = ~4.9m\n * // shouldFall: false (balance > 20%)\n * // recoveryWindow: 1.05s (0.7s * 1.5 for low balance)\n * ```\n * \n * @public\n * @korean 밀침물리\n */\nexport class KnockbackPhysics {\n  /**\n   * Calculates knockback displacement and effects.\n   * \n   * **Korean**: 밀침 계산 (Calculate Knockback)\n   * \n   * Determines knockback distance, duration, and fall state based on:\n   * 1. Base knockback from damage amount\n   * 2. Stance resistance modifier (8 trigram effects)\n   * 3. Balance state modifier (stumbling/falling)\n   * 4. Recovery window (vulnerable state after)\n   * \n   * @param config - Knockback configuration with force and state\n   * @param attackDamage - Damage dealt by attack (0-100+)\n   * @returns Knockback result with displacement and timing\n   * \n   * @example\n   * ```typescript\n   * // Light strike on stable player\n   * const light = physics.calculateKnockback({\n   *   force: 300,\n   *   direction: attackVector,\n   *   duration: 0.3,\n   *   balanceState: { current: 85, max: 100 },\n   *   currentStance: TrigramStance.GEON,\n   * }, 30);\n   * // Result: ~0.3m knockback (0.5m * 0.9 Geon * 0.7 high balance)\n   * \n   * // Critical strike on low-balance player\n   * const critical = physics.calculateKnockback({\n   *   force: 1200,\n   *   direction: attackVector,\n   *   duration: 1.2,\n   *   balanceState: { current: 15, max: 100 },\n   *   currentStance: TrigramStance.SON,\n   * }, 110);\n   * // Result: ~9.6m knockback, shouldFall: true, 3.0s recovery\n   * ```\n   * \n   * @public\n   * @korean 밀침계산\n   */\n  calculateKnockback(config: KnockbackConfig, attackDamage: number): KnockbackResult {\n    // 1. Base knockback distance from damage\n    let baseDistance = this.getBaseKnockbackDistance(attackDamage);\n    \n    // 2. Apply stance resistance modifier\n    const stanceResistance = this.getStanceResistanceModifier(config.currentStance);\n    baseDistance *= (1 - stanceResistance);\n    \n    // 3. Apply balance modifier (stumbling/falling)\n    const balanceModifier = this.getBalanceModifier(config.balanceState);\n    const finalDistance = baseDistance * balanceModifier;\n    \n    // 4. Calculate displacement vector\n    const displacement = config.direction.clone().multiplyScalar(finalDistance);\n    \n    // 5. Determine duration based on distance\n    const duration = this.calculateKnockbackDuration(finalDistance);\n    \n    // 6. Calculate recovery window (vulnerable state)\n    const recoveryWindow = this.calculateRecoveryWindow(attackDamage, config.balanceState);\n    \n    // 7. Check if balance is critical (should fall)\n    const shouldFall = config.balanceState.current < 20;\n    \n    return {\n      displacement,\n      duration,\n      recoveryWindow,\n      shouldFall,\n    };\n  }\n\n  /**\n   * Gets base knockback distance from damage amount.\n   * \n   * **Korean**: 기본 밀침 거리 (Base Knockback Distance)\n   * \n   * Damage thresholds:\n   * - Light (20-40): 0.5m knockback, 0.3s duration\n   * - Medium (40-70): 1.2m knockback, 0.5s duration\n   * - Heavy (70-100): 2.5m knockback, 0.8s duration\n   * - Critical (100+): 4.0m knockback, 1.2s duration + fall\n   * \n   * @param damage - Attack damage amount\n   * @returns Base knockback distance in meters\n   * \n   * @private\n   * @korean 기본밀침거리\n   */\n  private getBaseKnockbackDistance(damage: number): number {\n    if (damage < 40) return 0.5;  // Light strike\n    if (damage < 70) return 1.2;  // Medium strike\n    if (damage < 100) return 2.5; // Heavy strike\n    return 4.0; // Critical strike\n  }\n\n  /**\n   * Gets stance resistance modifier for knockback.\n   * \n   * **Korean**: 자세 저항 배율 (Stance Resistance Modifier)\n   * \n   * Trigram stance resistance modifiers:\n   * - ☶ 간 (Gan/Mountain): +40% resistance (defensive mastery)\n   * - ☷ 곤 (Gon/Earth): +30% resistance (grounded techniques)\n   * - ☰ 건 (Geon/Heaven): +10% resistance (balanced force)\n   * - ☵ 감 (Gam/Water): 0% (neutral, adaptive)\n   * - ☱ 태 (Tae/Lake): 0% (neutral, fluid)\n   * - ☳ 진 (Jin/Thunder): -10% resistance (explosive power)\n   * - ☴ 손 (Son/Wind): -20% resistance (fluid, mobile)\n   * - ☲ 리 (Li/Fire): -30% resistance (aggressive, exposed)\n   * \n   * @param stance - Current trigram stance\n   * @returns Resistance modifier (-0.3 to +0.4)\n   * \n   * @private\n   * @korean 자세저항배율\n   */\n  private getStanceResistanceModifier(stance: TrigramStance): number {\n    const resistances: Record<TrigramStance, number> = {\n      [TrigramStance.GAN]: 0.40,  // Mountain: +40% resistance\n      [TrigramStance.GON]: 0.30,  // Earth: +30% resistance\n      [TrigramStance.GEON]: 0.10, // Heaven: +10% resistance\n      [TrigramStance.GAM]: 0.00,  // Water: neutral\n      [TrigramStance.TAE]: 0.00,  // Lake: neutral\n      [TrigramStance.JIN]: -0.10, // Thunder: -10% resistance\n      [TrigramStance.SON]: -0.20, // Wind: -20% resistance (fluid)\n      [TrigramStance.LI]: -0.30,  // Fire: -30% resistance (aggressive)\n    };\n    return resistances[stance];\n  }\n\n  /**\n   * Gets balance modifier for knockback distance.\n   * \n   * **Korean**: 균형 배율 (Balance Modifier)\n   * \n   * Balance thresholds:\n   * - High balance (>70%): 0.70x (30% reduction)\n   * - Medium balance (40-70%): 1.00x (normal)\n   * - Low balance (20-40%): 1.50x (50% increase, stumbling)\n   * - Critical balance (<20%): 2.00x (100% increase, falling)\n   * \n   * @param balanceState - Current balance state\n   * @returns Balance multiplier (0.7 to 2.0)\n   * \n   * @private\n   * @korean 균형배율\n   */\n  private getBalanceModifier(balanceState: BalanceState): number {\n    const balancePercent = (balanceState.current / balanceState.max) * 100;\n    \n    if (balancePercent > 70) return 0.70; // High balance: -30% knockback\n    if (balancePercent > 40) return 1.00; // Normal knockback\n    if (balancePercent > 20) return 1.50; // Low balance: +50% knockback\n    return 2.00; // Critical balance: +100% knockback\n  }\n\n  /**\n   * Calculates knockback animation duration.\n   * \n   * **Korean**: 밀침 지속시간 계산 (Calculate Knockback Duration)\n   * \n   * Linear relationship between distance and duration:\n   * - 0.5m = 0.3s (light)\n   * - 1.2m = 0.48s\n   * - 2.5m = 0.86s\n   * - 4.0m = 1.2s (critical)\n   * \n   * @param distance - Knockback distance in meters\n   * @returns Duration in seconds\n   * \n   * @private\n   * @korean 밀침지속시간계산\n   */\n  private calculateKnockbackDuration(distance: number): number {\n    // Linear relationship: 0.5m = 0.3s, 4.0m = 1.2s\n    return 0.3 + (distance / 4.0) * 0.9;\n  }\n\n  /**\n   * Calculates recovery window (vulnerability duration).\n   * \n   * **Korean**: 회복 대기시간 계산 (Calculate Recovery Window)\n   * \n   * Recovery windows by damage:\n   * - Light (<40): 0.2s vulnerability\n   * - Medium (40-70): 0.4s vulnerability\n   * - Heavy (70-100): 0.7s vulnerability\n   * - Critical (100+): 1.5s vulnerability + grounded\n   * \n   * Low balance increases vulnerability by 50%.\n   * \n   * @param damage - Attack damage amount\n   * @param balanceState - Current balance state\n   * @returns Vulnerability duration in seconds\n   * \n   * @private\n   * @korean 회복대기시간계산\n   */\n  private calculateRecoveryWindow(damage: number, balanceState: BalanceState): number {\n    // Base recovery time from damage\n    const baseRecoveryTime = damage < 40 ? 0.2 : damage < 70 ? 0.4 : damage < 100 ? 0.7 : 1.5;\n    \n    // Increase recovery time if balance is low (more vulnerable)\n    const balancePercent = (balanceState.current / balanceState.max) * 100;\n    const balanceModifier = balancePercent < 40 ? 1.5 : 1.0;\n    \n    return baseRecoveryTime * balanceModifier;\n  }\n\n  /**\n   * Applies knockback force to player position over time.\n   * \n   * **Korean**: 밀침 힘 적용 (Apply Knockback Force)\n   * \n   * Uses smooth ease-out cubic curve for realistic knockback feel:\n   * - Fast initial displacement (impact)\n   * - Gradual deceleration (friction/resistance)\n   * - Smooth stop at final position\n   * \n   * @param playerPosition - Current player position\n   * @param result - Knockback result with displacement\n   * @param deltaTime - Time elapsed since knockback started\n   * @param progress - Knockback progress (0 to 1)\n   * @returns New player position\n   * \n   * @example\n   * ```typescript\n   * // In game loop (60fps)\n   * const newPosition = physics.applyKnockbackForce(\n   *   playerPosition,\n   *   knockbackResult,\n   *   deltaTime,\n   *   elapsedTime / knockbackResult.duration\n   * );\n   * \n   * // Progress 0.0: At original position\n   * // Progress 0.5: ~88% of total displacement (ease-out)\n   * // Progress 1.0: At final position\n   * ```\n   * \n   * @public\n   * @korean 밀침힘적용\n   */\n  applyKnockbackForce(\n    playerPosition: THREE.Vector3,\n    result: KnockbackResult,\n    _deltaTime: number,\n    progress: number\n  ): THREE.Vector3 {\n    // Clamp progress to [0, 1]\n    const clampedProgress = Math.max(0, Math.min(1, progress));\n    \n    // Smooth knockback curve (ease-out cubic)\n    // Fast initial impact, gradual deceleration\n    const easedProgress = 1 - Math.pow(1 - clampedProgress, 3);\n    \n    // Calculate position along knockback path\n    const currentDisplacement = result.displacement.clone().multiplyScalar(easedProgress);\n    \n    return playerPosition.clone().add(currentDisplacement);\n  }\n\n  /**\n   * Checks if player is currently in knockback state.\n   * \n   * **Korean**: 밀침 상태 확인 (Check Knockback State)\n   * \n   * @param elapsedTime - Time elapsed since knockback started\n   * @param duration - Total knockback duration\n   * @returns True if still in knockback animation\n   * \n   * @public\n   * @korean 밀침상태확인\n   */\n  isInKnockback(elapsedTime: number, duration: number): boolean {\n    return elapsedTime < duration;\n  }\n\n  /**\n   * Checks if player is in recovery window (vulnerable state).\n   * \n   * **Korean**: 회복 대기 확인 (Check Recovery Window)\n   * \n   * @param elapsedTime - Time elapsed since knockback ended\n   * @param recoveryWindow - Total recovery window duration\n   * @returns True if in vulnerable recovery state\n   * \n   * @public\n   * @korean 회복대기확인\n   */\n  isInRecoveryWindow(elapsedTime: number, recoveryWindow: number): boolean {\n    return elapsedTime < recoveryWindow;\n  }\n\n  /**\n   * Gets bilingual Korean-English name for knockback state.\n   * \n   * **Korean**: 밀침 상태 이름 (Knockback State Name)\n   * \n   * @param shouldFall - Whether knockback causes fall\n   * @returns Korean and English state names\n   * \n   * @public\n   * @korean 밀침상태이름\n   */\n  static getKnockbackStateName(shouldFall: boolean): { korean: string; english: string } {\n    if (shouldFall) {\n      return {\n        korean: \"넘어짐\",\n        english: \"Falling\",\n      };\n    }\n    \n    return {\n      korean: \"밀침\",\n      english: \"Knockback\",\n    };\n  }\n\n  /**\n   * Gets bilingual Korean-English name for recovery state.\n   * \n   * **Korean**: 회복 상태 이름 (Recovery State Name)\n   * \n   * @returns Korean and English state names\n   * \n   * @public\n   * @korean 회복상태이름\n   */\n  getRecoveryStateName(): { korean: string; english: string } {\n    return {\n      korean: \"회복\",\n      english: \"Recovery\",\n    };\n  }\n\n  /**\n   * Gets bilingual Korean-English name for stumbling state.\n   * \n   * **Korean**: 휘청거림 상태 이름 (Stumbling State Name)\n   * \n   * @returns Korean and English state names\n   * \n   * @public\n   * @korean 휘청거림상태이름\n   */\n  getStumblingStateName(): { korean: string; english: string } {\n    return {\n      korean: \"휘청거림\",\n      english: \"Stumbling\",\n    };\n  }\n}\n\nexport default KnockbackPhysics;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6HA,IAAa,mBAAb,MAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C5B,mBAAmB,QAAyB,cAAuC;EAEjF,IAAI,eAAe,KAAK,yBAAyB,aAAa;EAG9D,MAAM,mBAAmB,KAAK,4BAA4B,OAAO,cAAc;EAC/E,gBAAiB,IAAI;EAGrB,MAAM,kBAAkB,KAAK,mBAAmB,OAAO,aAAa;EACpE,MAAM,gBAAgB,eAAe;EAcrC,OAAO;GACL,cAZmB,OAAO,UAAU,OAAO,CAAC,eAAe,cAY3D;GACA,UAVe,KAAK,2BAA2B,cAU/C;GACA,gBARqB,KAAK,wBAAwB,cAAc,OAAO,aAQvE;GACA,YANiB,OAAO,aAAa,UAAU;GAOhD;;;;;;;;;;;;;;;;;;;CAoBH,yBAAiC,QAAwB;EACvD,IAAI,SAAS,IAAI,OAAO;EACxB,IAAI,SAAS,IAAI,OAAO;EACxB,IAAI,SAAS,KAAK,OAAO;EACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAwBT,4BAAoC,QAA+B;EAWjE,OAAO;IATJ,cAAc,MAAM;IACpB,cAAc,MAAM;IACpB,cAAc,OAAO;IACrB,cAAc,MAAM;IACpB,cAAc,MAAM;IACpB,cAAc,MAAM;IACpB,cAAc,MAAM;IACpB,cAAc,KAAK;GAEf,CAAY;;;;;;;;;;;;;;;;;;;CAoBrB,mBAA2B,cAAoC;EAC7D,MAAM,iBAAkB,aAAa,UAAU,aAAa,MAAO;EAEnE,IAAI,iBAAiB,IAAI,OAAO;EAChC,IAAI,iBAAiB,IAAI,OAAO;EAChC,IAAI,iBAAiB,IAAI,OAAO;EAChC,OAAO;;;;;;;;;;;;;;;;;;;CAoBT,2BAAmC,UAA0B;EAE3D,OAAO,KAAO,WAAW,IAAO;;;;;;;;;;;;;;;;;;;;;;CAuBlC,wBAAgC,QAAgB,cAAoC;EAQlF,QANyB,SAAS,KAAK,KAAM,SAAS,KAAK,KAAM,SAAS,MAAM,KAAM,QAG9D,aAAa,UAAU,aAAa,MAAO,MAC1B,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCtD,oBACE,gBACA,QACA,YACA,UACe;EAMf,MAAM,gBAAgB,IAAI,KAAK,IAAI,IAJX,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,SAAS,CAIlB,EAAiB,EAAE;EAG1D,MAAM,sBAAsB,OAAO,aAAa,OAAO,CAAC,eAAe,cAAc;EAErF,OAAO,eAAe,OAAO,CAAC,IAAI,oBAAoB;;;;;;;;;;;;;;CAexD,cAAc,aAAqB,UAA2B;EAC5D,OAAO,cAAc;;;;;;;;;;;;;;CAevB,mBAAmB,aAAqB,gBAAiC;EACvE,OAAO,cAAc;;;;;;;;;;;;;CAcvB,OAAO,sBAAsB,YAA0D;EACrF,IAAI,YACF,OAAO;GACL,QAAQ;GACR,SAAS;GACV;EAGH,OAAO;GACL,QAAQ;GACR,SAAS;GACV;;;;;;;;;;;;CAaH,uBAA4D;EAC1D,OAAO;GACL,QAAQ;GACR,SAAS;GACV;;;;;;;;;;;;CAaH,wBAA6D;EAC3D,OAAO;GACL,QAAQ;GACR,SAAS;GACV"}
+{"version":3,"file":"KnockbackPhysics.js","names":[],"sources":["../../../src/systems/physics/KnockbackPhysics.ts"],"sourcesContent":["/**\n * Knockback Physics System for realistic force-based displacement.\n * \n * **Korean**: 밀침 물리 시스템 (Knockback Physics System)\n * \n * Implements realistic combat knockback mechanics that calculate force-based\n * displacement when players are hit. The system integrates with BalanceSystem\n * for authentic stumbling/falling reactions.\n * \n * ## Knockback Mechanics\n * \n * Knockback force is determined by:\n * - Attack damage and technique type\n * - Impact angle and direction\n * - Current balance state\n * - Stance resistance modifiers (8 trigram stances)\n * \n * ## Balance Integration\n * \n * - High balance (>70%): Reduced knockback by 30%\n * - Medium balance (40-70%): Normal knockback\n * - Low balance (<40%): Increased knockback by 50%, stumbling\n * - Critical balance (<20%): Guaranteed fall, 2s recovery\n * \n * ## Performance\n * \n * Optimized for 60fps with efficient vector calculations and smooth\n * easing curves for realistic knockback feel.\n * \n * @module systems/physics/KnockbackPhysics\n * @category Physics System\n * @korean 밀침물리\n */\n\nimport * as THREE from 'three';\nimport { TrigramStance } from '@/types/common';\n\n/**\n * Balance state information for knockback calculations.\n * \n * **Korean**: 균형 상태 (Balance State)\n * \n * @korean 균형상태\n */\nexport interface BalanceState {\n  /** Current balance value (0-100) */\n  readonly current: number;\n  /** Maximum balance value (typically 100) */\n  readonly max: number;\n}\n\n/**\n * Configuration for knockback force calculation.\n * \n * **Korean**: 밀침 설정 (Knockback Configuration)\n * \n * @korean 밀침설정\n */\nexport interface KnockbackConfig {\n  /** Force magnitude in Newtons */\n  readonly force: number;\n  /** Normalized attack direction vector (attacker → defender) */\n  readonly direction: THREE.Vector3;\n  /** Duration of knockback effect in seconds */\n  readonly duration: number;\n  /** Current balance state */\n  readonly balanceState: BalanceState;\n  /** Current trigram stance */\n  readonly currentStance: TrigramStance;\n}\n\n/**\n * Result of knockback calculation.\n * \n * **Korean**: 밀침 결과 (Knockback Result)\n * \n * Contains displacement vector, animation timing, and fall determination.\n * \n * @korean 밀침결과\n */\nexport interface KnockbackResult {\n  /** Total knockback displacement vector in world space */\n  readonly displacement: THREE.Vector3;\n  /** Duration of knockback animation in seconds */\n  readonly duration: number;\n  /** Vulnerable state duration after knockback ends in seconds */\n  readonly recoveryWindow: number;\n  /** Whether fall animation should trigger */\n  readonly shouldFall: boolean;\n}\n\n/**\n * Knockback Physics Engine.\n * \n * **Korean**: 밀침 물리 엔진\n * \n * Calculates realistic knockback displacement based on attack force,\n * stance resistance, and balance state. Integrates with BalanceSystem\n * for stumbling and falling mechanics.\n * \n * @example\n * ```typescript\n * const physics = new KnockbackPhysics();\n * \n * // Calculate knockback from heavy strike\n * const config: KnockbackConfig = {\n *   force: 800, // 80 damage\n *   direction: new THREE.Vector3(1, 0, 0).normalize(),\n *   duration: 0.8,\n *   balanceState: { current: 35, max: 100 }, // Low balance\n *   currentStance: TrigramStance.LI, // Fire stance (low resistance)\n * };\n * \n * const result = physics.calculateKnockback(config, 80);\n * // Result: 2.5m base * 1.3 (Fire penalty) * 1.5 (low balance) = ~4.9m\n * // shouldFall: false (balance > 20%)\n * // recoveryWindow: 1.05s (0.7s * 1.5 for low balance)\n * ```\n * \n * @korean 밀침물리\n */\nexport class KnockbackPhysics {\n  /**\n   * Calculates knockback displacement and effects.\n   * \n   * **Korean**: 밀침 계산 (Calculate Knockback)\n   * \n   * Determines knockback distance, duration, and fall state based on:\n   * 1. Base knockback from damage amount\n   * 2. Stance resistance modifier (8 trigram effects)\n   * 3. Balance state modifier (stumbling/falling)\n   * 4. Recovery window (vulnerable state after)\n   * \n   * @param config - Knockback configuration with force and state\n   * @param attackDamage - Damage dealt by attack (0-100+)\n   * @returns Knockback result with displacement and timing\n   * \n   * @example\n   * ```typescript\n   * // Light strike on stable player\n   * const light = physics.calculateKnockback({\n   *   force: 300,\n   *   direction: attackVector,\n   *   duration: 0.3,\n   *   balanceState: { current: 85, max: 100 },\n   *   currentStance: TrigramStance.GEON,\n   * }, 30);\n   * // Result: ~0.3m knockback (0.5m * 0.9 Geon * 0.7 high balance)\n   * \n   * // Critical strike on low-balance player\n   * const critical = physics.calculateKnockback({\n   *   force: 1200,\n   *   direction: attackVector,\n   *   duration: 1.2,\n   *   balanceState: { current: 15, max: 100 },\n   *   currentStance: TrigramStance.SON,\n   * }, 110);\n   * // Result: ~9.6m knockback, shouldFall: true, 3.0s recovery\n   * ```\n   * \n   * @korean 밀침계산\n   */\n  calculateKnockback(config: KnockbackConfig, attackDamage: number): KnockbackResult {\n    // 1. Base knockback distance from damage\n    let baseDistance = this.getBaseKnockbackDistance(attackDamage);\n    \n    // 2. Apply stance resistance modifier\n    const stanceResistance = this.getStanceResistanceModifier(config.currentStance);\n    baseDistance *= (1 - stanceResistance);\n    \n    // 3. Apply balance modifier (stumbling/falling)\n    const balanceModifier = this.getBalanceModifier(config.balanceState);\n    const finalDistance = baseDistance * balanceModifier;\n    \n    // 4. Calculate displacement vector\n    const displacement = config.direction.clone().multiplyScalar(finalDistance);\n    \n    // 5. Determine duration based on distance\n    const duration = this.calculateKnockbackDuration(finalDistance);\n    \n    // 6. Calculate recovery window (vulnerable state)\n    const recoveryWindow = this.calculateRecoveryWindow(attackDamage, config.balanceState);\n    \n    // 7. Check if balance is critical (should fall)\n    const shouldFall = config.balanceState.current < 20;\n    \n    return {\n      displacement,\n      duration,\n      recoveryWindow,\n      shouldFall,\n    };\n  }\n\n  /**\n   * Gets base knockback distance from damage amount.\n   * \n   * **Korean**: 기본 밀침 거리 (Base Knockback Distance)\n   * \n   * Damage thresholds:\n   * - Light (20-40): 0.5m knockback, 0.3s duration\n   * - Medium (40-70): 1.2m knockback, 0.5s duration\n   * - Heavy (70-100): 2.5m knockback, 0.8s duration\n   * - Critical (100+): 4.0m knockback, 1.2s duration + fall\n   * \n   * @param damage - Attack damage amount\n   * @returns Base knockback distance in meters\n   * \n   * @private\n   * @korean 기본밀침거리\n   */\n  private getBaseKnockbackDistance(damage: number): number {\n    if (damage < 40) return 0.5;  // Light strike\n    if (damage < 70) return 1.2;  // Medium strike\n    if (damage < 100) return 2.5; // Heavy strike\n    return 4.0; // Critical strike\n  }\n\n  /**\n   * Gets stance resistance modifier for knockback.\n   * \n   * **Korean**: 자세 저항 배율 (Stance Resistance Modifier)\n   * \n   * Trigram stance resistance modifiers:\n   * - ☶ 간 (Gan/Mountain): +40% resistance (defensive mastery)\n   * - ☷ 곤 (Gon/Earth): +30% resistance (grounded techniques)\n   * - ☰ 건 (Geon/Heaven): +10% resistance (balanced force)\n   * - ☵ 감 (Gam/Water): 0% (neutral, adaptive)\n   * - ☱ 태 (Tae/Lake): 0% (neutral, fluid)\n   * - ☳ 진 (Jin/Thunder): -10% resistance (explosive power)\n   * - ☴ 손 (Son/Wind): -20% resistance (fluid, mobile)\n   * - ☲ 리 (Li/Fire): -30% resistance (aggressive, exposed)\n   * \n   * @param stance - Current trigram stance\n   * @returns Resistance modifier (-0.3 to +0.4)\n   * \n   * @private\n   * @korean 자세저항배율\n   */\n  private getStanceResistanceModifier(stance: TrigramStance): number {\n    const resistances: Record<TrigramStance, number> = {\n      [TrigramStance.GAN]: 0.40,  // Mountain: +40% resistance\n      [TrigramStance.GON]: 0.30,  // Earth: +30% resistance\n      [TrigramStance.GEON]: 0.10, // Heaven: +10% resistance\n      [TrigramStance.GAM]: 0.00,  // Water: neutral\n      [TrigramStance.TAE]: 0.00,  // Lake: neutral\n      [TrigramStance.JIN]: -0.10, // Thunder: -10% resistance\n      [TrigramStance.SON]: -0.20, // Wind: -20% resistance (fluid)\n      [TrigramStance.LI]: -0.30,  // Fire: -30% resistance (aggressive)\n    };\n    return resistances[stance];\n  }\n\n  /**\n   * Gets balance modifier for knockback distance.\n   * \n   * **Korean**: 균형 배율 (Balance Modifier)\n   * \n   * Balance thresholds:\n   * - High balance (>70%): 0.70x (30% reduction)\n   * - Medium balance (40-70%): 1.00x (normal)\n   * - Low balance (20-40%): 1.50x (50% increase, stumbling)\n   * - Critical balance (<20%): 2.00x (100% increase, falling)\n   * \n   * @param balanceState - Current balance state\n   * @returns Balance multiplier (0.7 to 2.0)\n   * \n   * @private\n   * @korean 균형배율\n   */\n  private getBalanceModifier(balanceState: BalanceState): number {\n    const balancePercent = (balanceState.current / balanceState.max) * 100;\n    \n    if (balancePercent > 70) return 0.70; // High balance: -30% knockback\n    if (balancePercent > 40) return 1.00; // Normal knockback\n    if (balancePercent > 20) return 1.50; // Low balance: +50% knockback\n    return 2.00; // Critical balance: +100% knockback\n  }\n\n  /**\n   * Calculates knockback animation duration.\n   * \n   * **Korean**: 밀침 지속시간 계산 (Calculate Knockback Duration)\n   * \n   * Linear relationship between distance and duration:\n   * - 0.5m = 0.3s (light)\n   * - 1.2m = 0.48s\n   * - 2.5m = 0.86s\n   * - 4.0m = 1.2s (critical)\n   * \n   * @param distance - Knockback distance in meters\n   * @returns Duration in seconds\n   * \n   * @private\n   * @korean 밀침지속시간계산\n   */\n  private calculateKnockbackDuration(distance: number): number {\n    // Linear relationship: 0.5m = 0.3s, 4.0m = 1.2s\n    return 0.3 + (distance / 4.0) * 0.9;\n  }\n\n  /**\n   * Calculates recovery window (vulnerability duration).\n   * \n   * **Korean**: 회복 대기시간 계산 (Calculate Recovery Window)\n   * \n   * Recovery windows by damage:\n   * - Light (<40): 0.2s vulnerability\n   * - Medium (40-70): 0.4s vulnerability\n   * - Heavy (70-100): 0.7s vulnerability\n   * - Critical (100+): 1.5s vulnerability + grounded\n   * \n   * Low balance increases vulnerability by 50%.\n   * \n   * @param damage - Attack damage amount\n   * @param balanceState - Current balance state\n   * @returns Vulnerability duration in seconds\n   * \n   * @private\n   * @korean 회복대기시간계산\n   */\n  private calculateRecoveryWindow(damage: number, balanceState: BalanceState): number {\n    // Base recovery time from damage\n    const baseRecoveryTime = damage < 40 ? 0.2 : damage < 70 ? 0.4 : damage < 100 ? 0.7 : 1.5;\n    \n    // Increase recovery time if balance is low (more vulnerable)\n    const balancePercent = (balanceState.current / balanceState.max) * 100;\n    const balanceModifier = balancePercent < 40 ? 1.5 : 1.0;\n    \n    return baseRecoveryTime * balanceModifier;\n  }\n\n  /**\n   * Applies knockback force to player position over time.\n   * \n   * **Korean**: 밀침 힘 적용 (Apply Knockback Force)\n   * \n   * Uses smooth ease-out cubic curve for realistic knockback feel:\n   * - Fast initial displacement (impact)\n   * - Gradual deceleration (friction/resistance)\n   * - Smooth stop at final position\n   * \n   * @param playerPosition - Current player position\n   * @param result - Knockback result with displacement\n   * @param deltaTime - Time elapsed since knockback started\n   * @param progress - Knockback progress (0 to 1)\n   * @returns New player position\n   * \n   * @example\n   * ```typescript\n   * // In game loop (60fps)\n   * const newPosition = physics.applyKnockbackForce(\n   *   playerPosition,\n   *   knockbackResult,\n   *   deltaTime,\n   *   elapsedTime / knockbackResult.duration\n   * );\n   * \n   * // Progress 0.0: At original position\n   * // Progress 0.5: ~88% of total displacement (ease-out)\n   * // Progress 1.0: At final position\n   * ```\n   * \n   * @korean 밀침힘적용\n   */\n  applyKnockbackForce(\n    playerPosition: THREE.Vector3,\n    result: KnockbackResult,\n    _deltaTime: number,\n    progress: number\n  ): THREE.Vector3 {\n    // Clamp progress to [0, 1]\n    const clampedProgress = Math.max(0, Math.min(1, progress));\n    \n    // Smooth knockback curve (ease-out cubic)\n    // Fast initial impact, gradual deceleration\n    const easedProgress = 1 - Math.pow(1 - clampedProgress, 3);\n    \n    // Calculate position along knockback path\n    const currentDisplacement = result.displacement.clone().multiplyScalar(easedProgress);\n    \n    return playerPosition.clone().add(currentDisplacement);\n  }\n\n  /**\n   * Checks if player is currently in knockback state.\n   * \n   * **Korean**: 밀침 상태 확인 (Check Knockback State)\n   * \n   * @param elapsedTime - Time elapsed since knockback started\n   * @param duration - Total knockback duration\n   * @returns True if still in knockback animation\n   * \n   * @korean 밀침상태확인\n   */\n  isInKnockback(elapsedTime: number, duration: number): boolean {\n    return elapsedTime < duration;\n  }\n\n  /**\n   * Checks if player is in recovery window (vulnerable state).\n   * \n   * **Korean**: 회복 대기 확인 (Check Recovery Window)\n   * \n   * @param elapsedTime - Time elapsed since knockback ended\n   * @param recoveryWindow - Total recovery window duration\n   * @returns True if in vulnerable recovery state\n   * \n   * @korean 회복대기확인\n   */\n  isInRecoveryWindow(elapsedTime: number, recoveryWindow: number): boolean {\n    return elapsedTime < recoveryWindow;\n  }\n\n  /**\n   * Gets bilingual Korean-English name for knockback state.\n   * \n   * **Korean**: 밀침 상태 이름 (Knockback State Name)\n   * \n   * @param shouldFall - Whether knockback causes fall\n   * @returns Korean and English state names\n   * \n   * @korean 밀침상태이름\n   */\n  static getKnockbackStateName(shouldFall: boolean): { korean: string; english: string } {\n    if (shouldFall) {\n      return {\n        korean: \"넘어짐\",\n        english: \"Falling\",\n      };\n    }\n    \n    return {\n      korean: \"밀침\",\n      english: \"Knockback\",\n    };\n  }\n\n  /**\n   * Gets bilingual Korean-English name for recovery state.\n   * \n   * **Korean**: 회복 상태 이름 (Recovery State Name)\n   * \n   * @returns Korean and English state names\n   * \n   * @korean 회복상태이름\n   */\n  getRecoveryStateName(): { korean: string; english: string } {\n    return {\n      korean: \"회복\",\n      english: \"Recovery\",\n    };\n  }\n\n  /**\n   * Gets bilingual Korean-English name for stumbling state.\n   * \n   * **Korean**: 휘청거림 상태 이름 (Stumbling State Name)\n   * \n   * @returns Korean and English state names\n   * \n   * @korean 휘청거림상태이름\n   */\n  getStumblingStateName(): { korean: string; english: string } {\n    return {\n      korean: \"휘청거림\",\n      english: \"Stumbling\",\n    };\n  }\n}\n\nexport default KnockbackPhysics;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyHA,IAAa,mBAAb,MAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC5B,mBAAmB,QAAyB,cAAuC;EAEjF,IAAI,eAAe,KAAK,yBAAyB,aAAa;EAG9D,MAAM,mBAAmB,KAAK,4BAA4B,OAAO,cAAc;EAC/E,gBAAiB,IAAI;EAGrB,MAAM,kBAAkB,KAAK,mBAAmB,OAAO,aAAa;EACpE,MAAM,gBAAgB,eAAe;EAcrC,OAAO;GACL,cAZmB,OAAO,UAAU,OAAO,CAAC,eAAe,cAY3D;GACA,UAVe,KAAK,2BAA2B,cAU/C;GACA,gBARqB,KAAK,wBAAwB,cAAc,OAAO,aAQvE;GACA,YANiB,OAAO,aAAa,UAAU;GAOhD;;;;;;;;;;;;;;;;;;;CAoBH,yBAAiC,QAAwB;EACvD,IAAI,SAAS,IAAI,OAAO;EACxB,IAAI,SAAS,IAAI,OAAO;EACxB,IAAI,SAAS,KAAK,OAAO;EACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAwBT,4BAAoC,QAA+B;EAWjE,OAAO;IATJ,cAAc,MAAM;IACpB,cAAc,MAAM;IACpB,cAAc,OAAO;IACrB,cAAc,MAAM;IACpB,cAAc,MAAM;IACpB,cAAc,MAAM;IACpB,cAAc,MAAM;IACpB,cAAc,KAAK;GAEf,CAAY;;;;;;;;;;;;;;;;;;;CAoBrB,mBAA2B,cAAoC;EAC7D,MAAM,iBAAkB,aAAa,UAAU,aAAa,MAAO;EAEnE,IAAI,iBAAiB,IAAI,OAAO;EAChC,IAAI,iBAAiB,IAAI,OAAO;EAChC,IAAI,iBAAiB,IAAI,OAAO;EAChC,OAAO;;;;;;;;;;;;;;;;;;;CAoBT,2BAAmC,UAA0B;EAE3D,OAAO,KAAO,WAAW,IAAO;;;;;;;;;;;;;;;;;;;;;;CAuBlC,wBAAgC,QAAgB,cAAoC;EAQlF,QANyB,SAAS,KAAK,KAAM,SAAS,KAAK,KAAM,SAAS,MAAM,KAAM,QAG9D,aAAa,UAAU,aAAa,MAAO,MAC1B,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCtD,oBACE,gBACA,QACA,YACA,UACe;EAMf,MAAM,gBAAgB,IAAI,KAAK,IAAI,IAJX,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,SAAS,CAIlB,EAAiB,EAAE;EAG1D,MAAM,sBAAsB,OAAO,aAAa,OAAO,CAAC,eAAe,cAAc;EAErF,OAAO,eAAe,OAAO,CAAC,IAAI,oBAAoB;;;;;;;;;;;;;CAcxD,cAAc,aAAqB,UAA2B;EAC5D,OAAO,cAAc;;;;;;;;;;;;;CAcvB,mBAAmB,aAAqB,gBAAiC;EACvE,OAAO,cAAc;;;;;;;;;;;;CAavB,OAAO,sBAAsB,YAA0D;EACrF,IAAI,YACF,OAAO;GACL,QAAQ;GACR,SAAS;GACV;EAGH,OAAO;GACL,QAAQ;GACR,SAAS;GACV;;;;;;;;;;;CAYH,uBAA4D;EAC1D,OAAO;GACL,QAAQ;GACR,SAAS;GACV;;;;;;;;;;;CAYH,wBAA6D;EAC3D,OAAO;GACL,QAAQ;GACR,SAAS;GACV"}

package/lib/systems/physics/MovementPhysics.d.ts

@@ -27,7 +27,6 @@ import * as THREE from "three";
  *
  * **Korean**: 이동 입력 (Movement Input)
  *
- * @public
  * @category Physics System
  * @korean 이동입력
  */
@@ -51,7 +50,6 @@ export interface MovementInput {
  * Contains position, velocity, and current movement parameters.
  * All vectors are mutable for performance (updated in-place during physics loop).
  *
- * @public
  * @category Physics System
  * @korean 이동상태
  */
@@ -138,7 +136,6 @@ export declare const STANCE_SPEED_MODIFIERS: Record<TrigramStance, number>;
  * physics.updateMovement(state, input, deltaTime);
  * ```
  *
- * @public
  * @category Physics System
  * @korean 이동물리엔진
  */
@@ -236,7 +233,6 @@ export declare class MovementPhysics {
      * const largePhysics = new MovementPhysics(14.0);
      * ```
      *
-     * @public
      */
     constructor(arenaWidthMeters?: number);
     /**
@@ -359,7 +355,6 @@ export declare class MovementPhysics {
      *
      * @param speed - Maximum speed in m/s
      *
-     * @public
      */
     setMaxSpeed(speed: number): void;
     /**
@@ -373,7 +368,6 @@ export declare class MovementPhysics {
      *
      * @param acceleration - Acceleration in m/s²
      *
-     * @public
      */
     setAcceleration(acceleration: number): void;
     /**
@@ -384,7 +378,6 @@ export declare class MovementPhysics {
      * Resets movement to use default calculations without external
      * override values.
      *
-     * @public
      */
     clearOverrides(): void;
     /**
@@ -399,7 +392,6 @@ export declare class MovementPhysics {
      * @param widthMeters - Arena width in meters (must be positive)
      * @throws {Error} If widthMeters is not a positive number
      *
-     * @public
      */
     setArenaWidth(widthMeters: number): void;
     /**
@@ -409,7 +401,6 @@ export declare class MovementPhysics {
      *
      * @returns Arena width in meters
      *
-     * @public
      */
     getArenaWidth(): number;
     /**
@@ -421,7 +412,6 @@ export declare class MovementPhysics {
      *
      * @returns Arena-based speed multiplier (0.7 to 1.3)
      *
-     * @public
      */
     getArenaSpeedScale(): number;
 }

package/lib/systems/physics/MovementPhysics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MovementPhysics.d.ts","sourceRoot":"","sources":["../../../src/systems/physics/MovementPhysics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MovementPhysics.d.ts","sourceRoot":"","sources":["../../../src/systems/physics/MovementPhysics.ts"],"names":[],"mappings":"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"}