blacktrigram 0.7.2

package/lib/systems/animation/core/AnimationHitTiming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationHitTiming.js","names":[],"sources":["../../../../src/systems/animation/core/AnimationHitTiming.ts"],"sourcesContent":["/**\n * Animation Hit Timing System\n *\n * **Korean**: 애니메이션 타격 타이밍\n *\n * Defines when visual contact occurs in animations for reality-based hit detection.\n * Hits should only register when the animation visually shows limb contact with target.\n *\n * ## Philosophy\n *\n * Black Trigram emphasizes visual authenticity in combat. Hit detection must align\n * with what the player sees on screen. This system defines the exact frames/timing\n * when each technique's strike phase visually connects.\n *\n * ## Phases\n *\n * Korean martial arts techniques have distinct phases:\n * - **준비 (Chamber)**: Wind-up, no contact possible\n * - **실행 (Extension)**: Strike extending, contact window opens\n * - **정점 (Peak)**: Maximum extension, highest contact probability\n * - **회수 (Retraction)**: Pulling back, contact window closes\n * - **복귀 (Recovery)**: Return to stance, no contact\n *\n * @module systems/animation/AnimationHitTiming\n * @category Animation System\n * @korean 애니메이션타격타이밍\n */\n\nimport { AnimationType } from \"../builders/MartialArtsAnimationBuilder\";\n\n/**\n * Hit window timing for a technique animation.\n *\n * **Korean**: 타격 창 타이밍\n *\n * Defines when during an animation the technique can actually make contact.\n * Based on visual reach during the extension phase.\n *\n * @example\n * ```typescript\n * const jabTiming: AnimationHitWindow = {\n *   startTime: 0.10,      // Hit window opens at 100ms (after chamber)\n *   peakTime: 0.15,       // Peak extension at 150ms\n *   endTime: 0.20,        // Hit window closes at 200ms (before retraction)\n *   maxReachMultiplier: 1.0, // 100% of limb length at peak\n * };\n * ```\n *\n * @public\n * @korean 타격창타이밍\n */\nexport interface AnimationHitWindow {\n  /**\n   * Time when hit window opens (seconds).\n   * Start of extension phase where limb begins moving toward target.\n   * @korean 시작시간\n   */\n  readonly startTime: number;\n\n  /**\n   * Time of maximum extension (seconds).\n   * Peak of strike where reach is maximum and damage is highest.\n   * @korean 정점시간\n   */\n  readonly peakTime: number;\n\n  /**\n   * Time when hit window closes (seconds).\n   * End of extension phase where limb begins retracting.\n   * @korean 종료시간\n   */\n  readonly endTime: number;\n\n  /**\n   * Reach multiplier at peak extension (0.0 - 1.5).\n   * - 1.0 = full limb extension (standard strikes)\n   * - 0.7 = partial extension (close-range techniques)\n   * - 1.2+ = overextended (special techniques, jumping kicks)\n   * @korean 최대도달배수\n   */\n  readonly maxReachMultiplier: number;\n\n  /**\n   * Optional reach curve during hit window.\n   * If not provided, assumes linear interpolation from 0 to maxReachMultiplier.\n   * @korean 도달곡선\n   */\n  readonly reachCurve?: (normalizedTime: number) => number;\n}\n\n/**\n * Complete hit timing configuration for a technique.\n *\n * **Korean**: 기술 타격 타이밍 설정\n *\n * @public\n * @korean 기술타격타이밍\n */\nexport interface TechniqueHitTiming {\n  /**\n   * Animation type this timing applies to.\n   * @korean 애니메이션타입\n   */\n  readonly animationType: AnimationType;\n\n  /**\n   * Hit window configuration.\n   * @korean 타격창\n   */\n  readonly hitWindow: AnimationHitWindow;\n\n  /**\n   * Whether this technique requires precise timing (true) or has a wider window (false).\n   * Affects forgiveness in hit detection.\n   * @korean 정밀타이밍필요\n   */\n  readonly requiresPreciseTiming: boolean;\n}\n\n/**\n * Hit timing database for animation types.\n *\n * **Korean**: 애니메이션 타격 타이밍 데이터베이스\n *\n * Based on TECHNIQUE_TIMING constants from MartialArtsAnimationBuilder.\n * Only includes timing for techniques with actual hit windows.\n * Movement and non-combat animations can query this and will get undefined.\n *\n * @public\n * @korean 애니메이션타격타이밍데이터베이스\n */\nexport const ANIMATION_HIT_TIMING: Partial<\n  Record<AnimationType, TechniqueHitTiming>\n> = {\n  // ═══════════════════════════════════════════════════════════════════════\n  // PUNCH TECHNIQUES (주먹 기술)\n  // ═══════════════════════════════════════════════════════════════════════\n\n  [AnimationType.JAB]: {\n    animationType: AnimationType.JAB,\n    hitWindow: {\n      startTime: 0.1, // Chamber: 100ms, Extension starts\n      peakTime: 0.15, // Peak at 150ms (midpoint of 150ms extension)\n      endTime: 0.25, // Retraction starts at 250ms\n      maxReachMultiplier: 0.95, // Jabs don't fully extend (speed > reach)\n    },\n    requiresPreciseTiming: false, // Fast technique with forgiving window\n  },\n\n  [AnimationType.CROSS]: {\n    animationType: AnimationType.CROSS,\n    hitWindow: {\n      startTime: 0.15, // Longer chamber for power\n      peakTime: 0.25, // Peak at 250ms\n      endTime: 0.35, // Window closes at 350ms\n      maxReachMultiplier: 1.0, // Full extension for power\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.HOOK]: {\n    animationType: AnimationType.HOOK,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.35,\n      maxReachMultiplier: 0.85, // Hooks are shorter range (arc motion)\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.UPPERCUT]: {\n    animationType: AnimationType.UPPERCUT,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.35,\n      maxReachMultiplier: 0.7, // Close-range technique\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.OVERHAND]: {\n    animationType: AnimationType.OVERHAND,\n    hitWindow: {\n      startTime: 0.2,\n      peakTime: 0.3,\n      endTime: 0.42,\n      maxReachMultiplier: 1.1, // Longer reach from arc\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.BACKFIST]: {\n    animationType: AnimationType.BACKFIST,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.18,\n      endTime: 0.27,\n      maxReachMultiplier: 0.9, // Snapping technique\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.HAMMER_FIST]: {\n    animationType: AnimationType.HAMMER_FIST,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.35,\n      maxReachMultiplier: 0.85,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.PALM_STRIKE]: {\n    animationType: AnimationType.PALM_STRIKE,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.35,\n      maxReachMultiplier: 1.0,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  // ═══ Specialized Punch Variants ═══\n\n  [AnimationType.SPEAR_HAND_STRIKE]: {\n    animationType: AnimationType.SPEAR_HAND_STRIKE,\n    hitWindow: {\n      startTime: 0.08,\n      peakTime: 0.13,\n      endTime: 0.2,\n      maxReachMultiplier: 1.05, // Extended fingers add reach\n    },\n    requiresPreciseTiming: true, // Precise targeting required\n  },\n\n  [AnimationType.NERVE_STRIKE]: {\n    animationType: AnimationType.NERVE_STRIKE,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.15,\n      endTime: 0.22,\n      maxReachMultiplier: 0.9,\n    },\n    requiresPreciseTiming: true, // Must hit exact nerve point\n  },\n\n  [AnimationType.PRESSURE_POINT_STRIKE]: {\n    animationType: AnimationType.PRESSURE_POINT_STRIKE,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.32,\n      maxReachMultiplier: 0.85,\n    },\n    requiresPreciseTiming: true, // Precise pressure point targeting\n  },\n\n  [AnimationType.LIGHTNING_STRIKE]: {\n    animationType: AnimationType.LIGHTNING_STRIKE,\n    hitWindow: {\n      startTime: 0.06,\n      peakTime: 0.1,\n      endTime: 0.15,\n      maxReachMultiplier: 0.95,\n    },\n    requiresPreciseTiming: true, // Very fast, small window\n  },\n\n  [AnimationType.RAPID_BARRAGE]: {\n    animationType: AnimationType.RAPID_BARRAGE,\n    hitWindow: {\n      startTime: 0.05,\n      peakTime: 0.12,\n      endTime: 0.2,\n      maxReachMultiplier: 0.85, // Multiple hits, shorter reach each\n    },\n    requiresPreciseTiming: false, // Volume of strikes compensates\n  },\n\n  [AnimationType.RHYTHMIC_STRIKES]: {\n    animationType: AnimationType.RHYTHMIC_STRIKES,\n    hitWindow: {\n      startTime: 0.08,\n      peakTime: 0.15,\n      endTime: 0.25,\n      maxReachMultiplier: 0.9,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.NERVE_PARALYSIS]: {\n    animationType: AnimationType.NERVE_PARALYSIS,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.2,\n      endTime: 0.28,\n      maxReachMultiplier: 0.85,\n    },\n    requiresPreciseTiming: true,\n  },\n\n  [AnimationType.THROAT_STRIKE]: {\n    animationType: AnimationType.THROAT_STRIKE,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.15,\n      endTime: 0.22,\n      maxReachMultiplier: 0.95,\n    },\n    requiresPreciseTiming: true, // Must hit throat precisely\n  },\n\n  [AnimationType.EYE_GOUGE]: {\n    animationType: AnimationType.EYE_GOUGE,\n    hitWindow: {\n      startTime: 0.08,\n      peakTime: 0.12,\n      endTime: 0.18,\n      maxReachMultiplier: 0.8, // Very close range\n    },\n    requiresPreciseTiming: true, // Extremely precise target\n  },\n\n  [AnimationType.HEAVEN_STRIKE]: {\n    animationType: AnimationType.HEAVEN_STRIKE,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.35,\n      maxReachMultiplier: 1.1, // Powerful extension\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.FLOWING_CROSS]: {\n    animationType: AnimationType.FLOWING_CROSS,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.22,\n      endTime: 0.32,\n      maxReachMultiplier: 1.0,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.SOLAR_PLEXUS_STRIKE]: {\n    animationType: AnimationType.SOLAR_PLEXUS_STRIKE,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.2,\n      endTime: 0.28,\n      maxReachMultiplier: 0.95,\n    },\n    requiresPreciseTiming: true, // Must hit solar plexus\n  },\n\n  [AnimationType.FLOWING_PUSH]: {\n    animationType: AnimationType.FLOWING_PUSH,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.2,\n      endTime: 0.3,\n      maxReachMultiplier: 1.0,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.LIVER_DISRUPTION]: {\n    animationType: AnimationType.LIVER_DISRUPTION,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.33,\n      maxReachMultiplier: 0.9,\n    },\n    requiresPreciseTiming: true, // Must hit liver\n  },\n\n  [AnimationType.EAR_STRIKE]: {\n    animationType: AnimationType.EAR_STRIKE,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.16,\n      endTime: 0.24,\n      maxReachMultiplier: 0.85,\n    },\n    requiresPreciseTiming: true, // Must hit ear precisely\n  },\n\n  // ═══════════════════════════════════════════════════════════════════════\n  // KICK TECHNIQUES (발차기 기술)\n  // ═══════════════════════════════════════════════════════════════════════\n\n  [AnimationType.FRONT_KICK]: {\n    animationType: AnimationType.FRONT_KICK,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.27,\n      endTime: 0.4,\n      maxReachMultiplier: 1.0, // Full leg extension\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.ROUNDHOUSE_KICK]: {\n    animationType: AnimationType.ROUNDHOUSE_KICK,\n    hitWindow: {\n      startTime: 0.2,\n      peakTime: 0.32,\n      endTime: 0.48,\n      maxReachMultiplier: 1.05, // Slight overextension at peak\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.SIDE_KICK]: {\n    animationType: AnimationType.SIDE_KICK,\n    hitWindow: {\n      startTime: 0.2,\n      peakTime: 0.35,\n      endTime: 0.5,\n      maxReachMultiplier: 1.1, // Maximum reach technique\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.BACK_KICK]: {\n    animationType: AnimationType.BACK_KICK,\n    hitWindow: {\n      startTime: 0.25,\n      peakTime: 0.4,\n      endTime: 0.55,\n      maxReachMultiplier: 1.15, // Powerful extension backward\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.AXE_KICK]: {\n    animationType: AnimationType.AXE_KICK,\n    hitWindow: {\n      startTime: 0.25,\n      peakTime: 0.45,\n      endTime: 0.65,\n      maxReachMultiplier: 1.2, // High vertical reach\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.CRESCENT_KICK]: {\n    animationType: AnimationType.CRESCENT_KICK,\n    hitWindow: {\n      startTime: 0.18,\n      peakTime: 0.32,\n      endTime: 0.48,\n      maxReachMultiplier: 1.0,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.LOW_KICK]: {\n    animationType: AnimationType.LOW_KICK,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.22,\n      endTime: 0.35,\n      maxReachMultiplier: 0.95, // Lower target, less extension\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.PUSH_KICK]: {\n    animationType: AnimationType.PUSH_KICK,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.22,\n      endTime: 0.35,\n      maxReachMultiplier: 1.0,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.JUMPING_KICK]: {\n    animationType: AnimationType.JUMPING_KICK,\n    hitWindow: {\n      startTime: 0.3,\n      peakTime: 0.45,\n      endTime: 0.6,\n      maxReachMultiplier: 1.3, // Airborne extension\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.SPINNING_HEEL_KICK]: {\n    animationType: AnimationType.SPINNING_HEEL_KICK,\n    hitWindow: {\n      startTime: 0.4,\n      peakTime: 0.6,\n      endTime: 0.8,\n      maxReachMultiplier: 1.15, // Spinning adds reach\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.TORNADO_KICK]: {\n    animationType: AnimationType.TORNADO_KICK,\n    hitWindow: {\n      startTime: 0.45,\n      peakTime: 0.65,\n      endTime: 0.85,\n      maxReachMultiplier: 1.25, // Jumping + spinning\n    },\n    requiresPreciseTiming: false,\n  },\n\n  // ═══════════════════════════════════════════════════════════════════════\n  // ELBOW & KNEE TECHNIQUES (팔꿈치 & 무릎 기술)\n  // ═══════════════════════════════════════════════════════════════════════\n\n  [AnimationType.ELBOW_STRIKE]: {\n    animationType: AnimationType.ELBOW_STRIKE,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.18,\n      endTime: 0.28,\n      maxReachMultiplier: 0.5, // Very close range\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.ELBOW_UPPERCUT]: {\n    animationType: AnimationType.ELBOW_UPPERCUT,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.22,\n      endTime: 0.32,\n      maxReachMultiplier: 0.45, // Close range upward\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.SPINNING_ELBOW]: {\n    animationType: AnimationType.SPINNING_ELBOW,\n    hitWindow: {\n      startTime: 0.3,\n      peakTime: 0.5,\n      endTime: 0.7,\n      maxReachMultiplier: 0.6, // Spinning adds slight reach\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.TEMPLE_ELBOW]: {\n    animationType: AnimationType.TEMPLE_ELBOW,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.18,\n      endTime: 0.26,\n      maxReachMultiplier: 0.5,\n    },\n    requiresPreciseTiming: true, // Must hit temple\n  },\n\n  [AnimationType.SPINNING_BACK_ELBOW]: {\n    animationType: AnimationType.SPINNING_BACK_ELBOW,\n    hitWindow: {\n      startTime: 0.28,\n      peakTime: 0.45,\n      endTime: 0.62,\n      maxReachMultiplier: 0.55,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.SPINAL_ELBOW]: {\n    animationType: AnimationType.SPINAL_ELBOW,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.35,\n      maxReachMultiplier: 0.5,\n    },\n    requiresPreciseTiming: true, // Must hit spine\n  },\n\n  [AnimationType.BRACHIAL_ELBOW]: {\n    animationType: AnimationType.BRACHIAL_ELBOW,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.18,\n      endTime: 0.26,\n      maxReachMultiplier: 0.5,\n    },\n    requiresPreciseTiming: true, // Must hit brachial plexus\n  },\n\n  [AnimationType.KNEE_STRIKE]: {\n    animationType: AnimationType.KNEE_STRIKE,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.22,\n      endTime: 0.35,\n      maxReachMultiplier: 0.4, // Very close range\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.FLYING_KNEE]: {\n    animationType: AnimationType.FLYING_KNEE,\n    hitWindow: {\n      startTime: 0.25,\n      peakTime: 0.4,\n      endTime: 0.55,\n      maxReachMultiplier: 0.65, // Jumping adds reach\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.KIDNEY_KNEE]: {\n    animationType: AnimationType.KIDNEY_KNEE,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.35,\n      maxReachMultiplier: 0.4,\n    },\n    requiresPreciseTiming: true, // Must hit kidney\n  },\n\n  [AnimationType.FEMORAL_KNEE]: {\n    animationType: AnimationType.FEMORAL_KNEE,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.25,\n      endTime: 0.35,\n      maxReachMultiplier: 0.4,\n    },\n    requiresPreciseTiming: true, // Must hit femoral artery\n  },\n\n  // ═══════════════════════════════════════════════════════════════════════\n  // GRAPPLING TECHNIQUES (잡기 기술)\n  // ═══════════════════════════════════════════════════════════════════════\n\n  [AnimationType.THROW]: {\n    animationType: AnimationType.THROW,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.35,\n      endTime: 0.55,\n      maxReachMultiplier: 0.7, // Must be close to grab\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.GRAPPLE]: {\n    animationType: AnimationType.GRAPPLE,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.3,\n      endTime: 0.5,\n      maxReachMultiplier: 0.8, // Reach to grab\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.SWEEP]: {\n    animationType: AnimationType.SWEEP,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.3,\n      endTime: 0.45,\n      maxReachMultiplier: 0.9, // Low sweep\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.SLAM]: {\n    animationType: AnimationType.SLAM,\n    hitWindow: {\n      startTime: 0.2,\n      peakTime: 0.4,\n      endTime: 0.6,\n      maxReachMultiplier: 0.7,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.WRIST_LOCK]: {\n    animationType: AnimationType.WRIST_LOCK,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.25,\n      endTime: 0.4,\n      maxReachMultiplier: 0.75,\n    },\n    requiresPreciseTiming: true, // Must grab wrist\n  },\n\n  [AnimationType.ARM_BAR]: {\n    animationType: AnimationType.ARM_BAR,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.35,\n      endTime: 0.55,\n      maxReachMultiplier: 0.8,\n    },\n    requiresPreciseTiming: true, // Must control arm\n  },\n\n  [AnimationType.SHOULDER_LOCK]: {\n    animationType: AnimationType.SHOULDER_LOCK,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.3,\n      endTime: 0.48,\n      maxReachMultiplier: 0.75,\n    },\n    requiresPreciseTiming: true, // Must control shoulder\n  },\n\n  [AnimationType.HIP_THROW]: {\n    animationType: AnimationType.HIP_THROW,\n    hitWindow: {\n      startTime: 0.18,\n      peakTime: 0.38,\n      endTime: 0.58,\n      maxReachMultiplier: 0.7,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.LEG_REAP]: {\n    animationType: AnimationType.LEG_REAP,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.3,\n      endTime: 0.45,\n      maxReachMultiplier: 0.85,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.SMALL_CIRCLE_LOCK]: {\n    animationType: AnimationType.SMALL_CIRCLE_LOCK,\n    hitWindow: {\n      startTime: 0.12,\n      peakTime: 0.28,\n      endTime: 0.44,\n      maxReachMultiplier: 0.7,\n    },\n    requiresPreciseTiming: true, // Hapkido precision\n  },\n\n  [AnimationType.FINGER_LOCK]: {\n    animationType: AnimationType.FINGER_LOCK,\n    hitWindow: {\n      startTime: 0.1,\n      peakTime: 0.23,\n      endTime: 0.36,\n      maxReachMultiplier: 0.75,\n    },\n    requiresPreciseTiming: true, // Must grab fingers\n  },\n\n  [AnimationType.ELBOW_LOCK]: {\n    animationType: AnimationType.ELBOW_LOCK,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.32,\n      endTime: 0.49,\n      maxReachMultiplier: 0.8,\n    },\n    requiresPreciseTiming: true, // Must control elbow\n  },\n\n  [AnimationType.SHOULDER_MANIPULATION]: {\n    animationType: AnimationType.SHOULDER_MANIPULATION,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.32,\n      endTime: 0.49,\n      maxReachMultiplier: 0.75,\n    },\n    requiresPreciseTiming: true,\n  },\n\n  [AnimationType.MOUNTAIN_LOCK]: {\n    animationType: AnimationType.MOUNTAIN_LOCK,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.32,\n      endTime: 0.49,\n      maxReachMultiplier: 0.75,\n    },\n    requiresPreciseTiming: true,\n  },\n\n  [AnimationType.EARTH_EMBRACE]: {\n    animationType: AnimationType.EARTH_EMBRACE,\n    hitWindow: {\n      startTime: 0.18,\n      peakTime: 0.4,\n      endTime: 0.62,\n      maxReachMultiplier: 0.8,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  [AnimationType.TAKEDOWN]: {\n    animationType: AnimationType.TAKEDOWN,\n    hitWindow: {\n      startTime: 0.15,\n      peakTime: 0.35,\n      endTime: 0.55,\n      maxReachMultiplier: 0.75,\n    },\n    requiresPreciseTiming: false,\n  },\n\n  // ═══════════════════════════════════════════════════════════════════════\n  // DEFENSIVE TECHNIQUES (방어 기술)\n  // ═══════════════════════════════════════════════════════════════════════\n\n  [AnimationType.BLOCK]: {\n    animationType: AnimationType.BLOCK,\n    hitWindow: {\n      startTime: 0.03,\n      peakTime: 0.05,\n      endTime: 0.08,\n      maxReachMultiplier: 0.6, // Arms defending\n    },\n    requiresPreciseTiming: true, // Must time block correctly\n  },\n\n  [AnimationType.PARRY]: {\n    animationType: AnimationType.PARRY,\n    hitWindow: {\n      startTime: 0.03,\n      peakTime: 0.06,\n      endTime: 0.1,\n      maxReachMultiplier: 0.7,\n    },\n    requiresPreciseTiming: true, // Precise deflection\n  },\n\n  [AnimationType.COUNTER_STRIKE]: {\n    animationType: AnimationType.COUNTER_STRIKE,\n    hitWindow: {\n      startTime: 0.08,\n      peakTime: 0.15,\n      endTime: 0.25,\n      maxReachMultiplier: 0.9, // Counter-strike reach\n    },\n    requiresPreciseTiming: true, // Timing critical for counters\n  },\n};\n\n/**\n * Get hit timing configuration for an animation type.\n *\n * **Korean**: 애니메이션 타격 타이밍 가져오기\n *\n * @param animationType - Animation type to get timing for\n * @returns Hit timing configuration, or undefined if not a combat animation\n *\n * @example\n * ```typescript\n * const jabTiming = getAnimationHitTiming(AnimationType.JAB);\n * if (jabTiming) {\n *   console.log(`Jab hit window: ${jabTiming.hitWindow.startTime}s - ${jabTiming.hitWindow.endTime}s`);\n * }\n * ```\n *\n * @public\n * @korean 애니메이션타격타이밍가져오기\n */\nexport function getAnimationHitTiming(\n  animationType: AnimationType\n): TechniqueHitTiming | undefined {\n  return ANIMATION_HIT_TIMING[animationType];\n}\n\n/**\n * Check if a technique can hit at the given animation time.\n *\n * **Korean**: 타격 가능 시간 확인\n *\n * @param animationType - Animation type\n * @param currentTime - Current time in animation (seconds)\n * @returns True if within hit window\n *\n * @example\n * ```typescript\n * const canHit = isWithinHitWindow(AnimationType.JAB, 0.15);\n * // Returns true (0.15s is within jab's 0.10-0.25s window)\n * ```\n *\n * @public\n * @korean 타격가능시간확인\n */\nexport function isWithinHitWindow(\n  animationType: AnimationType,\n  currentTime: number\n): boolean {\n  const timing = ANIMATION_HIT_TIMING[animationType];\n  if (!timing) {\n    // Not a combat animation (movement, stance change, etc.)\n    return false;\n  }\n  const { startTime, endTime } = timing.hitWindow;\n  return currentTime >= startTime && currentTime <= endTime;\n}\n\n/**\n * Calculate current reach multiplier at a specific time in the animation.\n *\n * **Korean**: 현재 도달 배수 계산\n *\n * @param animationType - Animation type\n * @param currentTime - Current time in animation (seconds)\n * @returns Reach multiplier (0.0 - max), or 0 if outside hit window\n *\n * @example\n * ```typescript\n * const reach = getCurrentReachMultiplier(AnimationType.JAB, 0.15);\n * // Returns 0.95 (jab at peak time)\n *\n * const noReach = getCurrentReachMultiplier(AnimationType.JAB, 0.05);\n * // Returns 0 (before hit window starts)\n * ```\n *\n * @public\n * @korean 현재도달배수계산\n */\nexport function getCurrentReachMultiplier(\n  animationType: AnimationType,\n  currentTime: number\n): number {\n  const timing = ANIMATION_HIT_TIMING[animationType];\n  if (!timing) {\n    // Not a combat animation\n    return 0;\n  }\n  const { startTime, peakTime, endTime, maxReachMultiplier, reachCurve } =\n    timing.hitWindow;\n\n  // Outside hit window\n  if (currentTime < startTime || currentTime > endTime) {\n    return 0;\n  }\n\n  // Normalize time within hit window (0 = start, 0.5 = peak, 1 = end)\n  let normalizedTime: number;\n  if (currentTime <= peakTime) {\n    // Start to peak (0 to 0.5)\n    normalizedTime = 0.5 * ((currentTime - startTime) / (peakTime - startTime));\n  } else {\n    // Peak to end (0.5 to 1)\n    normalizedTime =\n      0.5 + 0.5 * ((currentTime - peakTime) / (endTime - peakTime));\n  }\n\n  // Apply reach curve if provided, otherwise use simple interpolation\n  if (reachCurve) {\n    return maxReachMultiplier * reachCurve(normalizedTime);\n  }\n\n  // Default: Peak at center (0.5), taper off at edges\n  // Use smooth curve: 1 - (2 * normalizedTime - 1)^2\n  const peakFactor = 1 - Math.pow(2 * normalizedTime - 1, 2);\n  return maxReachMultiplier * peakFactor;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmIA,IAAa,uBAET;EAKD,cAAc,MAAM;EACnB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,QAAQ;EACrB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,OAAO;EACpB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,WAAW;EACxB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,WAAW;EACxB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,WAAW;EACxB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,cAAc;EAC3B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,cAAc;EAC3B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAIA,cAAc,oBAAoB;EACjC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,eAAe;EAC5B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,wBAAwB;EACrC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,mBAAmB;EAChC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,gBAAgB;EAC7B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,mBAAmB;EAChC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,kBAAkB;EAC/B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,gBAAgB;EAC7B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,YAAY;EACzB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,gBAAgB;EAC7B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,gBAAgB;EAC7B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,sBAAsB;EACnC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,eAAe;EAC5B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,mBAAmB;EAChC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,aAAa;EAC1B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAMA,cAAc,aAAa;EAC1B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,kBAAkB;EAC/B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,YAAY;EACzB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,YAAY;EACzB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,WAAW;EACxB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,gBAAgB;EAC7B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,WAAW;EACxB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,YAAY;EACzB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,eAAe;EAC5B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,qBAAqB;EAClC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,eAAe;EAC5B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAMA,cAAc,eAAe;EAC5B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,iBAAiB;EAC9B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,iBAAiB;EAC9B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,eAAe;EAC5B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,sBAAsB;EACnC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,eAAe;EAC5B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,iBAAiB;EAC9B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,cAAc;EAC3B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,cAAc;EAC3B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,cAAc;EAC3B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,eAAe;EAC5B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAMA,cAAc,QAAQ;EACrB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,UAAU;EACvB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,QAAQ;EACrB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,OAAO;EACpB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,aAAa;EAC1B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,UAAU;EACvB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,gBAAgB;EAC7B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,YAAY;EACzB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,WAAW;EACxB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,oBAAoB;EACjC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,cAAc;EAC3B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,aAAa;EAC1B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,wBAAwB;EACrC,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,gBAAgB;EAC7B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,gBAAgB;EAC7B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,WAAW;EACxB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAMA,cAAc,QAAQ;EACrB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,QAAQ;EACrB,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;EAEA,cAAc,iBAAiB;EAC9B,eAAe,cAAc;EAC7B,WAAW;GACT,WAAW;GACX,UAAU;GACV,SAAS;GACT,oBAAoB;GACrB;EACD,uBAAuB;EACxB;CACF;;;;;;;;;;;;;;;;;;;;AAqBD,SAAgB,sBACd,eACgC;AAChC,QAAO,qBAAqB;;;;;;;;;;;;;;;;;;;;AAqB9B,SAAgB,kBACd,eACA,aACS;CACT,MAAM,SAAS,qBAAqB;AACpC,KAAI,CAAC,OAEH,QAAO;CAET,MAAM,EAAE,WAAW,YAAY,OAAO;AACtC,QAAO,eAAe,aAAa,eAAe;;;;;;;;;;;;;;;;;;;;;;;AAwBpD,SAAgB,0BACd,eACA,aACQ;CACR,MAAM,SAAS,qBAAqB;AACpC,KAAI,CAAC,OAEH,QAAO;CAET,MAAM,EAAE,WAAW,UAAU,SAAS,oBAAoB,eACxD,OAAO;AAGT,KAAI,cAAc,aAAa,cAAc,QAC3C,QAAO;CAIT,IAAI;AACJ,KAAI,eAAe,SAEjB,kBAAiB,OAAQ,cAAc,cAAc,WAAW;KAGhE,kBACE,KAAM,OAAQ,cAAc,aAAa,UAAU;AAIvD,KAAI,WACF,QAAO,qBAAqB,WAAW,eAAe;AAMxD,QAAO,sBADY,IAAI,KAAK,IAAI,IAAI,iBAAiB,GAAG,EAAE"}

package/lib/systems/animation/core/AnimationOptimizations.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Optimized Animation System with Caching and Batch Processing
+ *
+ * High-performance animation pipeline optimizations:
+ * - Keyframe caching to avoid redundant interpolations
+ * - Batch bone transformation updates
+ * - Dirty flag optimization
+ * - Precomputed interpolation curves
+ *
+ * Target: Reduce animation overhead from ~8ms to <5ms per frame
+ *
+ * @module systems/animation/AnimationOptimizations
+ * @category Animation System
+ * @korean 애니메이션최적화
+ */
+import type { AnimationKeyframe, SkeletalAnimation, SkeletalRig } from "../../../types/skeletal";
+import * as THREE from "three";
+/**
+ * Cached keyframe with interpolated values
+ * Reduces redundant interpolation calculations
+ *
+ * @korean 캐시된키프레임
+ */
+interface CachedKeyframe {
+    /** Original keyframe */
+    readonly keyframe: AnimationKeyframe;
+    /** Cache timestamp (for invalidation) */
+    readonly timestamp: number;
+    /** Interpolated bone rotations (Map to avoid allocations) */
+    readonly rotations: Map<string, THREE.Euler>;
+    /** Interpolated bone positions (if animated) */
+    readonly positions: Map<string, THREE.Vector3>;
+}
+/**
+ * Animation Cache Manager
+ *
+ * Caches interpolated keyframes to avoid redundant calculations.
+ * Uses LRU eviction when cache is full.
+ *
+ * @korean 애니메이션캐시관리자
+ */
+declare class AnimationCacheManager {
+    private cache;
+    private readonly maxCacheSize;
+    private readonly maxKeyframesPerAnimation;
+    constructor(maxCacheSize?: number, maxKeyframesPerAnimation?: number);
+    /**
+     * Get cached keyframe or create new entry
+     *
+     * @param animationId - Animation identifier
+     * @param animation - Animation data (reserved for future cache invalidation logic)
+     * @param time - Current time
+     * @returns Cached keyframe or null if not cached
+     */
+    get(animationId: string, animation: SkeletalAnimation, time: number): CachedKeyframe | null;
+    /**
+     * Cache an interpolated keyframe
+     *
+     * @param animationId - Animation identifier
+     * @param animation - Animation data
+     * @param time - Current time
+     * @param keyframe - Interpolated keyframe to cache
+     */
+    set(animationId: string, animation: SkeletalAnimation, time: number, keyframe: AnimationKeyframe): void;
+    /**
+     * Evict oldest keyframes from an animation cache entry
+     * @param entry - Animation cache entry
+     * @param count - Number of keyframes to evict
+     */
+    private evictOldestKeyframes;
+    /**
+     * Evict least recently used cache entry
+     */
+    private evictLRU;
+    /**
+     * Clear all cached keyframes
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        totalAnimations: number;
+        totalKeyframes: number;
+        cacheSize: number;
+    };
+}
+/**
+ * Global animation cache instance
+ *
+ * @korean 전역애니메이션캐시
+ */
+export declare const animationCache: AnimationCacheManager;
+/**
+ * Batch update multiple bones with dirty flag optimization
+ *
+ * Only updates bones that have changed rotations/positions.
+ * Uses object pooling to avoid allocations.
+ *
+ * @param rig - Skeletal rig to update
+ * @param keyframe - Keyframe with bone transforms
+ * @param dirtyBones - Set of bone names that changed (optional, updates all if not provided)
+ *
+ * @korean 배치뼈업데이트
+ */
+export declare function batchUpdateBones(rig: SkeletalRig, keyframe: AnimationKeyframe, dirtyBones?: Set<string>): void;
+/**
+ * Precompute and cache animation interpolation
+ *
+ * Generates cached keyframes at regular intervals for smooth playback.
+ * Call this during asset loading or idle time.
+ *
+ * @param animationId - Animation identifier
+ * @param animation - Animation to precompute
+ * @param sampleRate - Samples per second (default: 60fps = 60 samples/s)
+ *
+ * @korean 애니메이션사전계산
+ */
+export declare function precomputeAnimation(animationId: string, animation: SkeletalAnimation, sampleRate?: number): void;
+/**
+ * Interpolate keyframe with caching
+ *
+ * Checks cache before performing interpolation.
+ * Automatically caches result for future use.
+ *
+ * @param animationId - Animation identifier
+ * @param animation - Animation data
+ * @param time - Current time
+ * @returns Interpolated keyframe
+ *
+ * @korean 캐시된키프레임보간
+ */
+export declare function interpolateKeyframeCached(animationId: string, animation: SkeletalAnimation, time: number): AnimationKeyframe | null;
+/**
+ * Batch transform multiple bones in a single operation
+ *
+ * Applies transformations to all bones efficiently using temporary objects.
+ * Reduces per-bone overhead by batching operations.
+ *
+ * @param rig - Skeletal rig
+ * @param transforms - Map of bone names to transforms
+ *
+ * @korean 배치변환
+ */
+export declare function batchTransformBones(rig: SkeletalRig, transforms: Map<string, {
+    rotation?: THREE.Euler;
+    position?: THREE.Vector3;
+}>): void;
+/**
+ * Calculate dirty bones between two keyframes
+ *
+ * Identifies which bones have changed between keyframes for dirty flag optimization.
+ * Only changed bones need to be updated.
+ *
+ * @param prevKeyframe - Previous keyframe
+ * @param nextKeyframe - Next keyframe
+ * @param threshold - Minimum rotation difference in radians (default: 0.01)
+ * @returns Set of bone names that changed
+ *
+ * @korean 변경된뼈계산
+ */
+export declare function calculateDirtyBones(prevKeyframe: AnimationKeyframe, nextKeyframe: AnimationKeyframe, threshold?: number): Set<string>;
+/**
+ * Animation performance metrics
+ *
+ * @korean 애니메이션성능지표
+ */
+export interface AnimationPerformanceMetrics {
+    /** Average frame time (ms) */
+    avgFrameTime: number;
+    /** Maximum frame time (ms) */
+    maxFrameTime: number;
+    /** Minimum frame time (ms) */
+    minFrameTime: number;
+    /** Number of frames measured */
+    frameCount: number;
+    /** Cache hit rate (0-1) */
+    cacheHitRate: number;
+    /** Total cache entries */
+    cacheEntries: number;
+}
+/**
+ * Performance monitor for animation system
+ *
+ * @korean 성능모니터
+ */
+declare class AnimationPerformanceMonitor {
+    private frameTimes;
+    private cacheHits;
+    private cacheMisses;
+    private readonly maxSamples;
+    /**
+     * Record frame time
+     * @param time - Frame time in milliseconds
+     */
+    recordFrame(time: number): void;
+    /**
+     * Record cache hit
+     */
+    recordCacheHit(): void;
+    /**
+     * Record cache miss
+     */
+    recordCacheMiss(): void;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): AnimationPerformanceMetrics;
+    /**
+     * Reset metrics
+     */
+    reset(): void;
+}
+/**
+ * Global performance monitor instance
+ *
+ * @korean 전역성능모니터
+ */
+export declare const performanceMonitor: AnimationPerformanceMonitor;
+export {};
+//# sourceMappingURL=AnimationOptimizations.d.ts.map

package/lib/systems/animation/core/AnimationOptimizations.d.ts.map

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

package/lib/systems/animation/core/AnimationOptimizations.js

@@ -0,0 +1,322 @@
+import { ThreeObjectPools } from "../../../utils/threeObjectPool.js";
+//#region src/systems/animation/core/AnimationOptimizations.ts
+/**
+* Animation Cache Manager
+*
+* Caches interpolated keyframes to avoid redundant calculations.
+* Uses LRU eviction when cache is full.
+*
+* @korean 애니메이션캐시관리자
+*/
+var AnimationCacheManager = class {
+	cache = /* @__PURE__ */ new Map();
+	maxCacheSize;
+	maxKeyframesPerAnimation;
+	constructor(maxCacheSize = 50, maxKeyframesPerAnimation = 200) {
+		this.maxCacheSize = maxCacheSize;
+		this.maxKeyframesPerAnimation = maxKeyframesPerAnimation;
+	}
+	/**
+	* Get cached keyframe or create new entry
+	*
+	* @param animationId - Animation identifier
+	* @param animation - Animation data (reserved for future cache invalidation logic)
+	* @param time - Current time
+	* @returns Cached keyframe or null if not cached
+	*/
+	get(animationId, animation, time) {
+		const entry = this.cache.get(animationId);
+		if (!entry) return null;
+		entry.lastAccessTime = performance.now();
+		const roundedTime = Math.round(time * 100) / 100;
+		return entry.keyframes.get(roundedTime) ?? null;
+	}
+	/**
+	* Cache an interpolated keyframe
+	*
+	* @param animationId - Animation identifier
+	* @param animation - Animation data
+	* @param time - Current time
+	* @param keyframe - Interpolated keyframe to cache
+	*/
+	set(animationId, animation, time, keyframe) {
+		let entry = this.cache.get(animationId);
+		if (!entry) {
+			if (this.cache.size >= this.maxCacheSize) this.evictLRU();
+			entry = {
+				animation,
+				keyframes: /* @__PURE__ */ new Map(),
+				lastAccessTime: performance.now()
+			};
+			this.cache.set(animationId, entry);
+		}
+		const roundedTime = Math.round(time * 100) / 100;
+		const cachedRotations = /* @__PURE__ */ new Map();
+		keyframe.boneRotations.forEach((rotation, boneName) => {
+			cachedRotations.set(boneName, rotation.clone());
+		});
+		const cachedPositions = /* @__PURE__ */ new Map();
+		if (keyframe.bonePositions && keyframe.bonePositions.size > 0) keyframe.bonePositions.forEach((position, boneName) => {
+			cachedPositions.set(boneName, position.clone());
+		});
+		entry.keyframes.set(roundedTime, {
+			keyframe,
+			timestamp: performance.now(),
+			rotations: cachedRotations,
+			positions: cachedPositions
+		});
+		if (entry.keyframes.size > this.maxKeyframesPerAnimation) this.evictOldestKeyframes(entry, entry.keyframes.size - this.maxKeyframesPerAnimation);
+	}
+	/**
+	* Evict oldest keyframes from an animation cache entry
+	* @param entry - Animation cache entry
+	* @param count - Number of keyframes to evict
+	*/
+	evictOldestKeyframes(entry, count) {
+		Array.from(entry.keyframes.entries()).sort((a, b) => a[1].timestamp - b[1].timestamp).slice(0, count).map(([time]) => time).forEach((time) => entry.keyframes.delete(time));
+	}
+	/**
+	* Evict least recently used cache entry
+	*/
+	evictLRU() {
+		let oldestKey = null;
+		let oldestTime = Infinity;
+		this.cache.forEach((entry, key) => {
+			if (entry.lastAccessTime < oldestTime) {
+				oldestTime = entry.lastAccessTime;
+				oldestKey = key;
+			}
+		});
+		if (oldestKey) this.cache.delete(oldestKey);
+	}
+	/**
+	* Clear all cached keyframes
+	*/
+	clear() {
+		this.cache.clear();
+	}
+	/**
+	* Get cache statistics
+	*/
+	getStats() {
+		let totalKeyframes = 0;
+		this.cache.forEach((entry) => {
+			totalKeyframes += entry.keyframes.size;
+		});
+		return {
+			totalAnimations: this.cache.size,
+			totalKeyframes,
+			cacheSize: this.maxCacheSize
+		};
+	}
+};
+/**
+* Global animation cache instance
+*
+* @korean 전역애니메이션캐시
+*/
+var animationCache = new AnimationCacheManager(50);
+/**
+* Batch update multiple bones with dirty flag optimization
+*
+* Only updates bones that have changed rotations/positions.
+* Uses object pooling to avoid allocations.
+*
+* @param rig - Skeletal rig to update
+* @param keyframe - Keyframe with bone transforms
+* @param dirtyBones - Set of bone names that changed (optional, updates all if not provided)
+*
+* @korean 배치뼈업데이트
+*/
+function batchUpdateBones(rig, keyframe, dirtyBones) {
+	(dirtyBones ?? new Set(keyframe.boneRotations.keys())).forEach((boneName) => {
+		const bone = rig.bones.get(boneName);
+		if (!bone) return;
+		const rotation = keyframe.boneRotations.get(boneName);
+		if (rotation) bone.rotation.copy(rotation);
+		const position = keyframe.bonePositions?.get(boneName);
+		if (position) bone.position.copy(bone.restPosition).add(position);
+	});
+}
+/**
+* Precompute and cache animation interpolation
+*
+* Generates cached keyframes at regular intervals for smooth playback.
+* Call this during asset loading or idle time.
+*
+* @param animationId - Animation identifier
+* @param animation - Animation to precompute
+* @param sampleRate - Samples per second (default: 60fps = 60 samples/s)
+*
+* @korean 애니메이션사전계산
+*/
+function precomputeAnimation(animationId, animation, sampleRate = 60) {
+	const duration = animation.duration;
+	const step = 1 / sampleRate;
+	for (let t = 0; t <= duration; t += step) {
+		const keyframe = interpolateKeyframeCached(animationId, animation, t);
+		if (keyframe) animationCache.set(animationId, animation, t, keyframe);
+	}
+}
+/**
+* Interpolate keyframe with caching
+*
+* Checks cache before performing interpolation.
+* Automatically caches result for future use.
+*
+* @param animationId - Animation identifier
+* @param animation - Animation data
+* @param time - Current time
+* @returns Interpolated keyframe
+*
+* @korean 캐시된키프레임보간
+*/
+function interpolateKeyframeCached(animationId, animation, time) {
+	const cached = animationCache.get(animationId, animation, time);
+	if (cached) return cached.keyframe;
+	const keyframes = animation.keyframes;
+	if (keyframes.length === 0) return null;
+	let prevKeyframe = keyframes[0];
+	let nextKeyframe = keyframes[keyframes.length - 1];
+	for (let i = 0; i < keyframes.length - 1; i++) if (time >= keyframes[i].time && time <= keyframes[i + 1].time) {
+		prevKeyframe = keyframes[i];
+		nextKeyframe = keyframes[i + 1];
+		break;
+	}
+	if (Math.abs(time - prevKeyframe.time) < .001) {
+		animationCache.set(animationId, animation, time, prevKeyframe);
+		return prevKeyframe;
+	}
+	const timeDiff = nextKeyframe.time - prevKeyframe.time;
+	const t = timeDiff > 0 ? (time - prevKeyframe.time) / timeDiff : 0;
+	const interpolatedRotations = /* @__PURE__ */ new Map();
+	prevKeyframe.boneRotations.forEach((prevRot, boneName) => {
+		const nextRot = nextKeyframe.boneRotations.get(boneName);
+		if (nextRot) {
+			const prevQuat = ThreeObjectPools.quaternion.acquire();
+			const nextQuat = ThreeObjectPools.quaternion.acquire();
+			const resultQuat = ThreeObjectPools.quaternion.acquire();
+			prevQuat.setFromEuler(prevRot);
+			nextQuat.setFromEuler(nextRot);
+			resultQuat.slerpQuaternions(prevQuat, nextQuat, t);
+			const tempEuler = ThreeObjectPools.euler.acquire();
+			tempEuler.setFromQuaternion(resultQuat);
+			interpolatedRotations.set(boneName, tempEuler.clone());
+			ThreeObjectPools.quaternion.release(prevQuat);
+			ThreeObjectPools.quaternion.release(nextQuat);
+			ThreeObjectPools.quaternion.release(resultQuat);
+			ThreeObjectPools.euler.release(tempEuler);
+		} else interpolatedRotations.set(boneName, prevRot.clone());
+	});
+	const interpolatedPositions = /* @__PURE__ */ new Map();
+	if (prevKeyframe.bonePositions && prevKeyframe.bonePositions.size > 0 && nextKeyframe.bonePositions && nextKeyframe.bonePositions.size > 0) prevKeyframe.bonePositions.forEach((prevPos, boneName) => {
+		const nextPos = nextKeyframe.bonePositions?.get(boneName);
+		if (nextPos) {
+			const tempVec = ThreeObjectPools.vector3.acquire();
+			tempVec.lerpVectors(prevPos, nextPos, t);
+			interpolatedPositions.set(boneName, tempVec.clone());
+			ThreeObjectPools.vector3.release(tempVec);
+		}
+	});
+	const anatomySource = t >= .5 ? nextKeyframe : prevKeyframe;
+	let interpolatedMuscles;
+	if (prevKeyframe.muscleActivations || nextKeyframe.muscleActivations) {
+		interpolatedMuscles = /* @__PURE__ */ new Map();
+		const prevMuscles = prevKeyframe.muscleActivations ?? /* @__PURE__ */ new Map();
+		const nextMuscles = nextKeyframe.muscleActivations ?? /* @__PURE__ */ new Map();
+		new Set([...prevMuscles.keys(), ...nextMuscles.keys()]).forEach((muscle) => {
+			const prevVal = prevMuscles.get(muscle) ?? 0;
+			const nextVal = nextMuscles.get(muscle) ?? 0;
+			interpolatedMuscles?.set(muscle, prevVal + (nextVal - prevVal) * t);
+		});
+	}
+	const interpolatedKeyframe = {
+		time,
+		boneRotations: interpolatedRotations,
+		bonePositions: interpolatedPositions,
+		easing: prevKeyframe.easing,
+		leftHandPose: anatomySource.leftHandPose,
+		rightHandPose: anatomySource.rightHandPose,
+		leftHandHighlightMode: anatomySource.leftHandHighlightMode,
+		rightHandHighlightMode: anatomySource.rightHandHighlightMode,
+		leftFootHighlight: anatomySource.leftFootHighlight,
+		rightFootHighlight: anatomySource.rightFootHighlight,
+		facialExpression: anatomySource.facialExpression,
+		muscleActivations: interpolatedMuscles
+	};
+	animationCache.set(animationId, animation, time, interpolatedKeyframe);
+	return interpolatedKeyframe;
+}
+/**
+* Performance monitor for animation system
+*
+* @korean 성능모니터
+*/
+var AnimationPerformanceMonitor = class {
+	frameTimes = [];
+	cacheHits = 0;
+	cacheMisses = 0;
+	maxSamples = 120;
+	/**
+	* Record frame time
+	* @param time - Frame time in milliseconds
+	*/
+	recordFrame(time) {
+		this.frameTimes.push(time);
+		if (this.frameTimes.length > this.maxSamples) this.frameTimes.shift();
+	}
+	/**
+	* Record cache hit
+	*/
+	recordCacheHit() {
+		this.cacheHits++;
+	}
+	/**
+	* Record cache miss
+	*/
+	recordCacheMiss() {
+		this.cacheMisses++;
+	}
+	/**
+	* Get current metrics
+	*/
+	getMetrics() {
+		const totalHits = this.cacheHits + this.cacheMisses;
+		const cacheHitRate = totalHits > 0 ? this.cacheHits / totalHits : 0;
+		const stats = animationCache.getStats();
+		if (this.frameTimes.length === 0) return {
+			avgFrameTime: 0,
+			maxFrameTime: 0,
+			minFrameTime: 0,
+			frameCount: 0,
+			cacheHitRate,
+			cacheEntries: stats.totalKeyframes
+		};
+		return {
+			avgFrameTime: this.frameTimes.reduce((a, b) => a + b, 0) / this.frameTimes.length,
+			maxFrameTime: Math.max(...this.frameTimes),
+			minFrameTime: Math.min(...this.frameTimes),
+			frameCount: this.frameTimes.length,
+			cacheHitRate,
+			cacheEntries: stats.totalKeyframes
+		};
+	}
+	/**
+	* Reset metrics
+	*/
+	reset() {
+		this.frameTimes = [];
+		this.cacheHits = 0;
+		this.cacheMisses = 0;
+	}
+};
+/**
+* Global performance monitor instance
+*
+* @korean 전역성능모니터
+*/
+var performanceMonitor = new AnimationPerformanceMonitor();
+//#endregion
+export { animationCache, batchUpdateBones, interpolateKeyframeCached, performanceMonitor, precomputeAnimation };
+
+//# sourceMappingURL=AnimationOptimizations.js.map