blacktrigram 0.7.2

package/lib/systems/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/systems/types.ts"],"sourcesContent":["/**\n * Type definitions for systems types\n * Auto-generated by type migration script\n */\n\n// System imports from shared types - avoid circular dependencies\nimport { AudioSystemInterface, SoundEffectId } from \"@/audio\";\nimport type {\n  EffectIntensity,\n  EnvironmentalEffectType,\n  HitEffectType,\n  ParticleType,\n} from \"@/systems/effects\";\nimport { KOREAN_COLORS } from \"@/types\";\nimport {\n  KoreanText,\n  PlayerArchetype,\n  Position,\n  TrigramStance,\n} from \"@/types/common\";\n\nexport interface AnimationConfig {\n  readonly name: string;\n  readonly frames: readonly AnimationFrame[];\n  readonly loop?: boolean;\n  readonly speed?: number;\n}\n\nexport interface CombatSystemConfig {\n  readonly damageMultiplier: number;\n  readonly criticalChance: number;\n}\n\nexport interface TrigramSystemConfig {\n  readonly transitionSpeed: number;\n  readonly energyCost: number;\n}\n\nexport interface AISystemConfig {\n  readonly difficulty: \"easy\" | \"medium\" | \"hard\" | \"expert\";\n  readonly reactionTime: number;\n}\n\nexport interface VitalPointSystemConfig {\n  readonly precisionRequired: number;\n  readonly damageMultipliers: Record<string, number>;\n  readonly effectDurations: Record<string, number>;\n}\n\n// Deprecated placeholder type - use unknown for generic texture representation\n\ntype Texture = unknown;\n\n// Vital point effect\n// Player archetype data\nexport interface PlayerArchetypeData {\n  readonly id: string;\n  readonly name: KoreanText;\n  readonly description: KoreanText;\n  readonly baseHealth: number;\n  readonly baseKi: number;\n  readonly baseStamina: number;\n  readonly coreStance: TrigramStance;\n  readonly theme: {\n    primary: number;\n    secondary: number;\n  };\n  readonly colors: {\n    primary: number;\n    secondary: number;\n  };\n  readonly stats: {\n    attackPower: number;\n    defense: number;\n    speed: number;\n    technique: number;\n  };\n  readonly favoredStances: readonly TrigramStance[];\n  readonly specialAbilities: readonly string[];\n  readonly philosophy: KoreanText;\n}\n\nexport interface AnimationState {\n  readonly currentAnimationName?: string;\n  readonly currentFrameIndex: number;\n  readonly isPlaying: boolean;\n  readonly elapsedTimeInFrame: number;\n}\n\nexport interface CollisionData {\n  readonly entityA: EntityId;\n  readonly entityB: EntityId;\n  readonly normal: Velocity;\n  readonly penetration: number;\n}\n\nexport interface PhysicsEntityConfig {\n  readonly position: Position;\n  readonly velocity?: Velocity;\n  readonly mass?: number;\n  readonly friction?: number;\n  readonly restitution?: number;\n  readonly shape:\n    | { type: \"circle\"; radius: number }\n    | { type: \"rectangle\"; width: number; height: number };\n  readonly isStatic?: boolean;\n}\n\nexport interface PhysicsEntityState {\n  readonly position: Position;\n  readonly velocity: Velocity;\n  readonly acceleration?: Velocity;\n  readonly angularVelocity?: number;\n}\n\n// @deprecated Use Three.js rendering instead\nexport interface RenderableConfig {\n  readonly zOrder?: number;\n  readonly visible?: boolean;\n  readonly alpha?: number;\n  readonly parent?: EntityId | \"stage\";\n}\n\nexport interface StatusEffect {\n  readonly id: string;\n  readonly type: string;\n  readonly intensity: EffectIntensity;\n  readonly duration: number;\n  readonly description: KoreanText;\n  readonly stackable: boolean;\n  readonly source: string;\n  readonly startTime: number;\n  readonly endTime: number;\n}\n\nexport interface HitEffect {\n  readonly id: string;\n  readonly type: HitEffectType;\n  readonly attackerId: string;\n  readonly defenderId: string;\n  readonly timestamp: number;\n  readonly duration: number;\n  readonly position?: Position;\n  readonly velocity?: { x: number; y: number };\n  readonly color?: number;\n  readonly size?: number;\n  readonly alpha?: number;\n  readonly lifespan?: number;\n  readonly text?: string | KoreanText;\n  readonly damageAmount?: number;\n  readonly vitalPointId?: string;\n  readonly statusEffect?: StatusEffect;\n  readonly yOffset?: number;\n  readonly intensity: number;\n  readonly startTime: number;\n}\n\nexport interface ParticleEffect {\n  readonly id: string;\n  readonly type: ParticleType;\n  readonly position: Position;\n  readonly velocity: { x: number; y: number };\n  readonly acceleration?: { x: number; y: number };\n  readonly color: number;\n  readonly size: number;\n  readonly lifetime: number;\n  readonly fadeOut?: boolean;\n  readonly gravity?: number;\n}\n\nexport interface EnvironmentalEffect {\n  readonly id: string;\n  readonly type: EnvironmentalEffectType;\n  readonly affectedArea: {\n    readonly x: number;\n    readonly y: number;\n    readonly width: number;\n    readonly height: number;\n  };\n  readonly effects: {\n    readonly visibilityModifier?: number;\n    readonly accuracyModifier?: number;\n    readonly movementModifier?: number;\n    readonly damageModifier?: number;\n  };\n  readonly duration: number;\n}\n\nexport interface VisualEffect {\n  readonly id: string;\n  readonly type: string;\n  readonly duration: number;\n  readonly intensity: number;\n  readonly position?: Position;\n  readonly color?: number;\n}\n\nexport interface EffectSystem {\n  readonly effects: readonly VisualEffect[];\n  readonly addEffect: (effect: VisualEffect) => void;\n  readonly removeEffect: (id: string) => void;\n  readonly updateEffects: (deltaTime: number) => void;\n}\n\nexport interface DisplayHitEffect extends HitEffect {\n  readonly opacity: number;\n  readonly scale: number;\n  readonly startTime: number;\n  readonly displayAlpha: number;\n  readonly displayY: number;\n  readonly displaySize: number;\n}\n\nexport interface InputSystemInterface {\n  registerAction: (action: string, callback: () => void) => void;\n  unregisterAction: (action: string) => void;\n  clearActions: () => void;\n  isActionActive: (action: string) => boolean;\n}\n\nexport interface AnimationSystemInterface {\n  playAnimation: (entityId: EntityId, animationName: string) => void;\n  stopAnimation: (entityId: EntityId, animationName?: string) => void;\n  getCurrentFrame: (entityId: EntityId) => AnimationFrame | undefined;\n  addAnimation: (config: AnimationConfig) => void;\n  getAnimationState: (entityId: EntityId) => AnimationState | undefined;\n}\n\nexport interface PhysicsSystemInterface {\n  addEntity: (entityId: EntityId, config: PhysicsEntityConfig) => void;\n  removeEntity: (entityId: EntityId) => void;\n  update: (deltaTime: number) => void;\n  getEntityState: (entityId: EntityId) => PhysicsEntityState | undefined;\n  checkCollision: (\n    entityIdA: EntityId,\n    entityIdB: EntityId,\n  ) => CollisionData | null;\n  applyForce: (entityId: EntityId, force: Velocity) => void;\n}\n\n// @deprecated Use Three.js rendering instead\nexport interface RenderingSystemInterface {\n  addRenderable: (entityId: EntityId, config: RenderableConfig) => void;\n  removeRenderable: (entityId: EntityId) => void;\n  updateRenderable: (\n    entityId: EntityId,\n    updates: Partial<RenderableConfig>,\n  ) => void;\n  render: () => void;\n}\n\nexport interface SystemEvent {\n  readonly type: string;\n  readonly timestamp: number;\n  readonly source: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Event data varies by event type\n  readonly data: Record<string, any>;\n}\n\nexport interface EventBusInterface {\n  publish: (event: SystemEvent) => void;\n  subscribe: (\n    eventType: string,\n    callback: (event: SystemEvent) => void,\n  ) => void;\n  unsubscribe: (\n    eventType: string,\n    callback: (event: SystemEvent) => void,\n  ) => void;\n}\n\n// Define system interfaces without importing (to avoid circular deps)\n// These interfaces use `any` to avoid circular dependency issues between\n// systems (combat, vital point, trigram) that reference each other's types.\n// Proper typing would require extracting shared types to a separate module.\n/* eslint-disable @typescript-eslint/no-explicit-any */\nexport interface CombatSystemInterface {\n  calculateDamage: (\n    technique: any,\n    attacker: any,\n    defender: any,\n    hitResult: any,\n  ) => {\n    baseDamage: number;\n    modifierDamage: number;\n    totalDamage: number;\n    effectsApplied: readonly StatusEffect[];\n    finalDefenderState?: any;\n  };\n  resolveAttack: (\n    attacker: any,\n    defender: any,\n    technique: any,\n    targetedVitalPointId?: string,\n  ) => any;\n  applyCombatResult: (\n    result: any,\n    attacker: any,\n    defender: any,\n  ) => { updatedAttacker: any; updatedDefender: any };\n  getAvailableTechniques: (player: any) => readonly any[];\n}\n\nexport interface VitalPointSystemInterface {\n  processHit: (\n    targetPosition: Position,\n    technique: any,\n    baseDamage: number,\n    attackerArchetype: any,\n    targetDimensions: { width: number; height: number },\n    targetedVitalPointId?: string | null,\n  ) => any;\n  calculateHit: (\n    technique: any,\n    targetVitalPointId: string | null,\n    accuracyRoll: number,\n    attackerPosition: Position,\n    defenderPosition: Position,\n    defenderStance: any,\n  ) => any;\n  applyVitalPointEffects: (\n    player: any,\n    vitalPoint: any,\n    intensityMultiplier?: number,\n  ) => any;\n}\n\nexport interface TrigramSystemInterface {\n  getTechniqueForStance: (stance: any, archetype?: any) => any | undefined;\n  calculateStanceEffectiveness: (\n    attackerStance: any,\n    defenderStance: any,\n    technique?: any,\n  ) => number;\n  isValidTransition: (from: any, to: any) => boolean;\n  getTransitionCost: (\n    from: any,\n    to: any,\n    player?: any,\n  ) => { ki: number; stamina: number; timeMs: number };\n  recommendStance: (player: any, opponent?: any) => any;\n}\n\nexport interface GameSystemManager {\n  readonly combatSystem: CombatSystemInterface;\n  readonly vitalPointSystem: VitalPointSystemInterface;\n  readonly trigramSystem: TrigramSystemInterface;\n  readonly inputSystem: InputSystemInterface;\n  readonly audioSystem: AudioSystemInterface;\n  readonly animationSystem?: AnimationSystemInterface;\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n  readonly physicsSystem?: PhysicsSystemInterface;\n  readonly renderingSystem?: RenderingSystemInterface;\n  readonly eventBus: EventBusInterface;\n  initializeAll: () => Promise<void>;\n  updateAll: (deltaTime: number) => void;\n}\n\nexport interface SystemConfig {\n  readonly debugMode?: boolean;\n  readonly performanceMonitoring?: boolean;\n}\n\nexport interface GameSystemState {\n  readonly combat: CombatSystemConfig;\n  readonly trigram: TrigramSystemConfig;\n  readonly vitalPoint: VitalPointSystemConfig;\n  readonly ai: AISystemConfig;\n}\n\nexport interface SystemPerformance {\n  readonly fps: number;\n  readonly memoryUsage: number;\n  readonly renderTime: number;\n  readonly updateTime: number;\n}\n\n// Fix: Add missing type definitions\nexport type Timestamp = number;\nexport type EntityId = string;\nexport interface Velocity {\n  readonly x: number;\n  readonly y: number;\n}\n\n// Configuration for the VitalPointSystem\n// Result from VitalPointSystem's hit calculation - unified with anatomy.ts version\n// Combat system interface\n// Vital point system interface\n// Trigram system interface\n// Input system interface\n// Gamepad state\nexport interface GamepadState {\n  readonly id: string;\n  readonly axes: readonly number[];\n  readonly buttons: readonly { pressed: boolean; value: number }[];\n}\n\n// Three.js uses built-in animation systems\n// @deprecated Use Three.js animation system instead\nexport interface AnimationFrame {\n  readonly texture: Texture;\n  readonly duration: number;\n}\n\n// @deprecated Use Three.js animation system instead\nexport interface AnimationState {\n  readonly currentAnimationName?: string;\n  readonly currentFrameIndex: number;\n  readonly isPlaying: boolean;\n  readonly elapsedTimeInFrame: number;\n}\n\n// Physics system interface\n// Physics entity configuration\nexport interface PhysicsEntityConfig {\n  readonly position: Position;\n  readonly velocity?: Velocity;\n  readonly mass?: number;\n  readonly friction?: number;\n  readonly restitution?: number; // Bounciness\n  readonly shape:\n    | { type: \"circle\"; radius: number }\n    | { type: \"rectangle\"; width: number; height: number };\n  readonly isStatic?: boolean; // Cannot be moved by forces // Added\n}\n\n// Added PhysicsEntityState and CollisionData for PhysicsSystemInterface\nexport interface PhysicsEntityState {\n  readonly position: Position;\n  readonly velocity: Velocity;\n  readonly acceleration?: Velocity;\n  readonly angularVelocity?: number;\n}\n\nexport interface CollisionData {\n  readonly entityA: EntityId;\n  readonly entityB: EntityId;\n  readonly normal: Velocity; // Collision normal vector\n  readonly penetration: number; // How much they are overlapping\n}\n\n// Rendering system interface (deprecated - use Three.js rendering)\n\n// Game system manager\n// System event base type\n// Event bus interface for system communication\n// General system configuration\n// System-specific types for Korean martial arts combat\n\n// Combat system interfaces\nexport interface CombatSystemConfig {\n  readonly damageMultiplier: number;\n  readonly criticalChance: number;\n  readonly blockEffectiveness: number;\n  readonly staminaDrainRate: number;\n}\n\n// Trigram system interfaces\nexport interface TrigramSystemConfig {\n  readonly transitionSpeed: number;\n  readonly energyCost: number;\n  readonly effectivenessMatrix: Record<\n    TrigramStance,\n    Record<TrigramStance, number>\n  >;\n}\n\n// Vital point system interfaces\n// AI system interfaces\nexport interface AISystemConfig {\n  readonly difficulty: \"easy\" | \"medium\" | \"hard\" | \"expert\";\n  readonly reactionTime: number;\n  readonly aggressiveness: number;\n  readonly adaptability: number;\n}\n\n// Player archetype data\nexport const PLAYER_ARCHETYPES_DATA: Record<\n  PlayerArchetype,\n  PlayerArchetypeData\n> = {\n  [PlayerArchetype.MUSA]: {\n    id: \"musa\",\n    name: { korean: \"무사 (Musa)\", english: \"Traditional Warrior\" },\n    description: {\n      korean: \"전통 무사의 길\",\n      english: \"Path of the traditional warrior\",\n    },\n    baseHealth: 120,\n    baseKi: 100,\n    baseStamina: 110,\n    coreStance: TrigramStance.GEON,\n    theme: {\n      primary: KOREAN_COLORS.TRIGRAM_GEON_PRIMARY,\n      secondary: KOREAN_COLORS.KOREAN_RED,\n    },\n    colors: {\n      primary: KOREAN_COLORS.TRIGRAM_GEON_PRIMARY,\n      secondary: KOREAN_COLORS.KOREAN_RED,\n    },\n    stats: {\n      attackPower: 85,\n      defense: 90,\n      speed: 70,\n      technique: 80,\n    },\n    favoredStances: [TrigramStance.GEON, TrigramStance.GAN],\n    specialAbilities: [\"Honor Strike\", \"Defensive Mastery\"],\n    philosophy: {\n      korean: \"명예와 정의의 길\",\n      english: \"The way of honor and justice\",\n    },\n  },\n\n  [PlayerArchetype.AMSALJA]: {\n    id: \"amsalja\",\n    name: { korean: \"암살자 (Amsalja)\", english: \"Shadow Assassin\" },\n    description: {\n      korean: \"그림자 속의 효율성\",\n      english: \"Efficiency from the shadows\",\n    },\n    baseHealth: 80,\n    baseKi: 120,\n    baseStamina: 100,\n    coreStance: TrigramStance.SON,\n    theme: {\n      primary: KOREAN_COLORS.TRIGRAM_SON_PRIMARY,\n      secondary: KOREAN_COLORS.UI_BACKGROUND_DARK,\n    },\n    colors: {\n      primary: KOREAN_COLORS.TRIGRAM_SON_PRIMARY,\n      secondary: KOREAN_COLORS.UI_BACKGROUND_DARK,\n    },\n    stats: {\n      attackPower: 95,\n      defense: 60,\n      speed: 95,\n      technique: 90,\n    },\n    favoredStances: [TrigramStance.SON, TrigramStance.GAM],\n    specialAbilities: [\"Shadow Strike\", \"Vital Point Mastery\"],\n    philosophy: {\n      korean: \"침묵과 정확성의 도\",\n      english: \"The way of silence and precision\",\n    },\n  },\n\n  [PlayerArchetype.HACKER]: {\n    id: \"hacker\",\n    name: { korean: \"해커 (Hacker)\", english: \"Cyber Warrior\" },\n    description: {\n      korean: \"정보를 통한 힘\",\n      english: \"Power through information\",\n    },\n    baseHealth: 90,\n    baseKi: 130,\n    baseStamina: 80,\n    coreStance: TrigramStance.LI,\n    theme: {\n      primary: KOREAN_COLORS.PRIMARY_CYAN,\n      secondary: KOREAN_COLORS.TRIGRAM_LI_PRIMARY,\n    },\n    colors: {\n      primary: KOREAN_COLORS.PRIMARY_CYAN,\n      secondary: KOREAN_COLORS.TRIGRAM_LI_PRIMARY,\n    },\n    stats: {\n      attackPower: 75,\n      defense: 70,\n      speed: 85,\n      technique: 95,\n    },\n    favoredStances: [TrigramStance.LI, TrigramStance.JIN],\n    specialAbilities: [\"System Override\", \"Digital Precision\"],\n    philosophy: {\n      korean: \"지식과 기술의 융합\",\n      english: \"The fusion of knowledge and technology\",\n    },\n  },\n\n  [PlayerArchetype.JEONGBO_YOWON]: {\n    id: \"jeongbo_yowon\",\n    name: {\n      korean: \"정보요원 (Jeongbo Yowon)\",\n      english: \"Intelligence Operative\",\n    },\n    description: {\n      korean: \"관찰을 통한 지식\",\n      english: \"Knowledge through observation\",\n    },\n    baseHealth: 100,\n    baseKi: 110,\n    baseStamina: 100,\n    coreStance: TrigramStance.TAE,\n    theme: {\n      primary: KOREAN_COLORS.TRIGRAM_TAE_PRIMARY,\n      secondary: KOREAN_COLORS.UI_STEEL_GRAY,\n    },\n    colors: {\n      primary: KOREAN_COLORS.TRIGRAM_TAE_PRIMARY,\n      secondary: KOREAN_COLORS.UI_STEEL_GRAY,\n    },\n    stats: {\n      attackPower: 80,\n      defense: 85,\n      speed: 80,\n      technique: 85,\n    },\n    favoredStances: [TrigramStance.TAE, TrigramStance.GAN],\n    specialAbilities: [\"Intel Gathering\", \"Adaptive Combat\"],\n    philosophy: {\n      korean: \"적응과 전략의 예술\",\n      english: \"The art of adaptation and strategy\",\n    },\n  },\n\n  [PlayerArchetype.JOJIK_POKRYEOKBAE]: {\n    id: \"jojik_pokryeokbae\",\n    name: {\n      korean: \"조직폭력배 (Jojik Pokryeokbae)\",\n      english: \"Organized Crime\",\n    },\n    description: {\n      korean: \"무자비함을 통한 생존\",\n      english: \"Survival through ruthlessness\",\n    },\n    baseHealth: 110,\n    baseKi: 90,\n    baseStamina: 120,\n    coreStance: TrigramStance.JIN,\n    theme: {\n      primary: KOREAN_COLORS.TRIGRAM_JIN_PRIMARY,\n      secondary: KOREAN_COLORS.NEGATIVE_RED,\n    },\n    colors: {\n      primary: KOREAN_COLORS.TRIGRAM_JIN_PRIMARY,\n      secondary: KOREAN_COLORS.NEGATIVE_RED,\n    },\n    stats: {\n      attackPower: 90,\n      defense: 75,\n      speed: 75,\n      technique: 70,\n    },\n    favoredStances: [TrigramStance.JIN, TrigramStance.GON],\n    specialAbilities: [\"Brutal Force\", \"Street Fighting\"],\n    philosophy: {\n      korean: \"강함과 의지의 길\",\n      english: \"The way of strength and will\",\n    },\n  },\n} as const;\n\n// Base player stats\nexport const BASE_PLAYER_STATS = {\n  HEALTH: 100,\n  KI: 100,\n  STAMINA: 100,\n  ATTACK_POWER: 75,\n  DEFENSE: 75,\n  SPEED: 75,\n  TECHNIQUE: 75,\n} as const;\n\n// Combat configuration\nexport const COMBAT_CONFIG = {\n  MAX_HEALTH: 100,\n  MAX_KI: 100,\n  MAX_STAMINA: 100,\n  MAX_BALANCE: 100,\n  MAX_CONSCIOUSNESS: 100,\n\n  // Damage multipliers - vital points more impactful for Korean martial arts realism\n  CRITICAL_HIT_MULTIPLIER: 2.0,\n  VITAL_POINT_MULTIPLIER: 2.5, // Increased from 1.5 for more realistic vital point impact\n  COUNTER_ATTACK_MULTIPLIER: 1.3,\n\n  // Status thresholds\n  LOW_HEALTH_THRESHOLD: 25,\n  CRITICAL_HEALTH_THRESHOLD: 10,\n  UNCONSCIOUS_THRESHOLD: 0,\n  STAMINA_EXHAUSTED_THRESHOLD: 0,\n\n  // Recovery rates (per second) - increased for 3-minute round sustainability\n  STAMINA_RECOVERY_RATE: 15, // Increased from 10 for sustained combat\n  KI_RECOVERY_RATE: 8, // Increased from 5 for more technique usage\n  BALANCE_RECOVERY_RATE: 15,\n  CONSCIOUSNESS_RECOVERY_RATE: 2,\n\n  // Combat timing (milliseconds)\n  TECHNIQUE_COOLDOWN: 500,\n  STANCE_CHANGE_COOLDOWN: 200,\n  BLOCK_DURATION: 300,\n  RECOVERY_TIME: 400,\n} as const;\n\n// Enhanced damage calculation constants\nexport const ENHANCED_DAMAGE_CONSTANTS = {\n  BASE_DAMAGE: 10,\n  CRITICAL_MULTIPLIER: 2.0,\n  VITAL_POINT_MULTIPLIER: 2.5, // Increased from 1.5 for Korean martial arts vital point realism\n  ARMOR_REDUCTION: 0.1,\n  STANCE_DEFENSE_BONUS: 0.2,\n  BALANCE_IMPACT_MULTIPLIER: 0.3,\n  CONSCIOUSNESS_THRESHOLD: 30,\n  PAIN_THRESHOLD: 80,\n\n  // New damage factors\n  TECHNIQUE_POWER_MODIFIER: 0.2,\n  ARCHETYPE_BONUS: 0.15,\n  COMBO_MULTIPLIER: 1.2,\n  PERFECT_TIMING_BONUS: 0.3,\n  BASE_CRIT_CHANCE: 0.1, // Added: Base critical hit chance (e.g., 10%)\n} as const;\n\n// Combat system constants for Korean martial arts\n\nexport const COMBAT_CONSTANTS = {\n  // Damage calculation\n  BASE_DAMAGE: 10,\n  CRITICAL_MULTIPLIER: 2.0,\n  VITAL_POINT_MULTIPLIER: 2.5, // Increased from 1.5 for Korean martial arts vital point realism\n\n  // Status thresholds\n  LOW_HEALTH_THRESHOLD: 30,\n  CRITICAL_HEALTH_THRESHOLD: 15,\n  EXHAUSTED_STAMINA_THRESHOLD: 20,\n\n  // Recovery rates (per second) - increased for 3-minute round sustainability\n  STAMINA_RECOVERY_RATE: 15, // Increased from 5 for sustained combat\n  KI_RECOVERY_RATE: 8, // Increased from 3 for more technique usage\n  CONSCIOUSNESS_RECOVERY_RATE: 2,\n\n  // Combat timing\n  ATTACK_COOLDOWN: 500, // milliseconds\n  STANCE_CHANGE_COOLDOWN: 300,\n  BLOCK_WINDOW: 200,\n\n  // Balance and momentum\n  BALANCE_RECOVERY_RATE: 10,\n  MOMENTUM_DECAY_RATE: 5,\n\n  // Pain and status effects\n  PAIN_DECAY_RATE: 3,\n  STATUS_EFFECT_DURATION: 3000,\n} as const;\n\n// Combat controls mapping - Enhanced with realistic combat focus\nexport const COMBAT_CONTROLS = {\n  // Trigram stance system (1-8 keys) with authentic Korean martial arts techniques\n  stanceControls: {\n    \"1\": {\n      stance: \"geon\" as TrigramStance,\n      korean: \"건\",\n      english: \"Heaven\",\n      symbol: \"☰\",\n      technique: {\n        korean: \"천둥벽력\",\n        english: \"Thunder Strike\",\n      },\n      combatFocus: {\n        korean: \"골격타격\",\n        english: \"Bone-striking force\",\n      },\n      combatEffects: {\n        korean: \"골절, 구조적 손상\",\n        english: \"Fractures, structural damage\",\n      },\n      description: {\n        korean: \"하늘의 힘으로 적의 뼈를 부수는 강력한 타격\",\n        english:\n          \"Powerful strikes that shatter enemy bones with heaven's force\",\n      },\n    },\n    \"2\": {\n      stance: \"tae\" as TrigramStance,\n      korean: \"태\",\n      english: \"Lake\",\n      symbol: \"☱\",\n      technique: {\n        korean: \"유수연타\",\n        english: \"Flowing Strike\",\n      },\n      combatFocus: {\n        korean: \"관절조작\",\n        english: \"Joint manipulation\",\n      },\n      combatEffects: {\n        korean: \"탈구, 이동력 상실\",\n        english: \"Dislocations, mobility loss\",\n      },\n      description: {\n        korean: \"호수처럼 부드럽게 흘러 관절을 조작하는 기법\",\n        english: \"Techniques that flow like water to manipulate joints\",\n      },\n    },\n    \"3\": {\n      stance: \"li\" as TrigramStance,\n      korean: \"리\",\n      english: \"Fire\",\n      symbol: \"☲\",\n      technique: {\n        korean: \"화염지창\",\n        english: \"Fire Spear\",\n      },\n      combatFocus: {\n        korean: \"정밀신경타격\",\n        english: \"Precise nerve strikes\",\n      },\n      combatEffects: {\n        korean: \"일시마비, 감각상실\",\n        english: \"Temporary paralysis, numbness\",\n      },\n      description: {\n        korean: \"불꽃같은 정확성으로 신경계를 공격하는 치명적 기법\",\n        english:\n          \"Deadly techniques targeting the nervous system with fire-like precision\",\n      },\n    },\n    \"4\": {\n      stance: \"jin\" as TrigramStance,\n      korean: \"진\",\n      english: \"Thunder\",\n      symbol: \"☳\",\n      technique: {\n        korean: \"벽력일섬\",\n        english: \"Lightning Strike\",\n      },\n      combatFocus: {\n        korean: \"기절기법\",\n        english: \"Stunning techniques\",\n      },\n      combatEffects: {\n        korean: \"방향감각상실, 의식잃음\",\n        english: \"Disorientation, knockouts\",\n      },\n      description: {\n        korean: \"번개처럼 빠른 충격으로 적의 의식을 차단\",\n        english: \"Lightning-fast shocks that disrupt enemy consciousness\",\n      },\n    },\n    \"5\": {\n      stance: \"son\" as TrigramStance,\n      korean: \"손\",\n      english: \"Wind\",\n      symbol: \"☴\",\n      technique: {\n        korean: \"선풍연격\",\n        english: \"Whirlwind Combo\",\n      },\n      combatFocus: {\n        korean: \"지속압박\",\n        english: \"Continuous pressure\",\n      },\n      combatEffects: {\n        korean: \"점진적 무력화\",\n        english: \"Gradual incapacitation\",\n      },\n      description: {\n        korean: \"바람처럼 끊임없는 연타로 적을 서서히 무력화\",\n        english:\n          \"Relentless wind-like strikes that gradually overwhelm the enemy\",\n      },\n    },\n    \"6\": {\n      stance: \"gam\" as TrigramStance,\n      korean: \"감\",\n      english: \"Water\",\n      symbol: \"☵\",\n      technique: {\n        korean: \"수류반격\",\n        english: \"Water Counter\",\n      },\n      combatFocus: {\n        korean: \"혈류차단\",\n        english: \"Blood flow restriction\",\n      },\n      combatEffects: {\n        korean: \"순환장애\",\n        english: \"Circulation disruption\",\n      },\n      description: {\n        korean: \"물의 흐름을 끊듯 혈액순환을 차단하는 위험한 기법\",\n        english:\n          \"Dangerous techniques that disrupt blood circulation like stopping water flow\",\n      },\n    },\n    \"7\": {\n      stance: \"gan\" as TrigramStance,\n      korean: \"간\",\n      english: \"Mountain\",\n      symbol: \"☶\",\n      technique: {\n        korean: \"반석방어\",\n        english: \"Mountain Defense\",\n      },\n      combatFocus: {\n        korean: \"방어반격\",\n        english: \"Defensive counters\",\n      },\n      combatEffects: {\n        korean: \"반격, 차단\",\n        english: \"Counter-attacks, blocks\",\n      },\n      description: {\n        korean: \"산처럼 견고한 방어에서 나오는 강력한 반격\",\n        english: \"Powerful counters emerging from mountain-solid defense\",\n      },\n    },\n    \"8\": {\n      stance: \"gon\" as TrigramStance,\n      korean: \"곤\",\n      english: \"Earth\",\n      symbol: \"☷\",\n      technique: {\n        korean: \"대지포옹\",\n        english: \"Earth's Embrace\",\n      },\n      combatFocus: {\n        korean: \"지면기법\",\n        english: \"Ground techniques\",\n      },\n      combatEffects: {\n        korean: \"투척, 넘어뜨리기\",\n        english: \"Throws, takedowns\",\n      },\n      description: {\n        korean: \"대지의 힘으로 적을 땅에 내동댕이치는 투척술\",\n        english:\n          \"Throwing techniques that slam enemies to the ground with earth's power\",\n      },\n    },\n  },\n\n  // Movement controls with combat context\n  movement: {\n    WASD: {\n      korean: \"전술적 이동과 발놀림\",\n      english: \"Tactical positioning and footwork\",\n    },\n    ArrowKeys: {\n      korean: \"대체 이동 시스템\",\n      english: \"Alternative movement system\",\n    },\n  },\n\n  // Combat actions with realistic descriptions\n  combat: {\n    SPACE: {\n      korean: \"현재 자세의 기법 실행\",\n      english: \"Execute current stance technique\",\n    },\n    SHIFT: {\n      korean: \"방어 자세/차단 위치\",\n      english: \"Defensive guard/block position\",\n    },\n    CTRL: {\n      korean: \"정밀 급소 타격 모드\",\n      english: \"Precision vital point targeting mode\",\n    },\n    TAB: {\n      korean: \"무술 원형 순환\",\n      english: \"Cycle through martial archetypes\",\n    },\n  },\n\n  // System controls\n  system: {\n    ESC: {\n      korean: \"일시정지 메뉴 / 인트로로 돌아가기\",\n      english: \"Pause menu / Return to intro\",\n    },\n    F1: {\n      korean: \"도움말 / 조작법 가이드\",\n      english: \"Help / Controls guide\",\n    },\n    M: {\n      korean: \"음소거 / 오디오 설정\",\n      english: \"Mute / Audio settings\",\n    },\n  },\n} as const;\n\n// Damage types\nexport const DAMAGE_TYPES = {\n  PHYSICAL: \"physical\",\n  ENERGY: \"energy\",\n  VITAL_POINT: \"vital_point\",\n  PSYCHOLOGICAL: \"psychological\",\n} as const;\n\n// Combat phases\nexport const COMBAT_PHASES = {\n  PREPARATION: \"preparation\",\n  ENGAGEMENT: \"engagement\",\n  EXECUTION: \"execution\",\n  RECOVERY: \"recovery\",\n  RESOLUTION: \"resolution\",\n} as const;\n\n// Combat audio mapping\nexport const COMBAT_AUDIO_MAP: Record<string, SoundEffectId> = {\n  light_attack: \"attack_light\",\n  medium_attack: \"attack_medium\",\n  heavy_attack: \"attack_heavy\",\n  critical_attack: \"attack_critical\",\n\n  light_hit: \"hit_light\",\n  medium_hit: \"hit_medium\",\n  heavy_hit: \"hit_heavy\",\n  critical_hit: \"critical_hit\",\n\n  block: \"block_success\",\n  guard_break: \"block_break\",\n  miss: \"miss\",\n\n  stance_change: \"stance_change\",\n  technique: \"technique_execute\",\n\n  match_start: \"match_start\",\n  combat_end: \"combat_end\",\n  victory: \"victory\",\n  defeat: \"defeat\",\n\n  guard: \"guard\",\n} as const;\n\n// Combat state transitions\nexport const COMBAT_STATE_MACHINE = {\n  idle: {\n    canTransitionTo: [\"attacking\", \"defending\", \"moving\", \"stunned\"],\n    duration: Infinity,\n  },\n  attacking: {\n    canTransitionTo: [\"idle\", \"recovering\", \"stunned\"],\n    duration: 500,\n  },\n  defending: {\n    canTransitionTo: [\"idle\", \"attacking\", \"stunned\"],\n    duration: 300,\n  },\n  moving: {\n    canTransitionTo: [\"idle\", \"attacking\", \"defending\"],\n    duration: 200,\n  },\n  stunned: {\n    canTransitionTo: [\"idle\"],\n    duration: 1000,\n  },\n  recovering: {\n    canTransitionTo: [\"idle\"],\n    duration: 400,\n  },\n  unconscious: {\n    canTransitionTo: [\"idle\"],\n    duration: 5000,\n  },\n} as const;\n\n// Training-specific combat constants\nexport const TRAINING_COMBAT_SETTINGS = {\n  techniqueCooldown: 500,\n  perfectStrikeThreshold: 0.7,\n  maxTrainingSession: 300000, // 5 minutes\n  kiRegenerationRate: 2,\n  staminaRegenerationRate: 1.5,\n} as const;\n\n// Combat state transitions for training mode\nexport const TRAINING_STATE_MACHINE = {\n  practicing: {\n    canTransitionTo: [\"idle\", \"executing\", \"recovering\"],\n    duration: Infinity,\n  },\n  executing: {\n    canTransitionTo: [\"practicing\", \"idle\"],\n    duration: 800,\n  },\n  recovering: {\n    canTransitionTo: [\"practicing\", \"idle\"],\n    duration: 300,\n  },\n} as const;\n\n// Technique execution results\nexport const TECHNIQUE_RESULTS = {\n  SUCCESS: \"success\",\n  BLOCKED: \"blocked\",\n  MISSED: \"missed\",\n  COUNTERED: \"countered\",\n  INTERRUPTED: \"interrupted\",\n} as const;\n\n// Combat effectiveness modifiers\nexport const EFFECTIVENESS_MODIFIERS = {\n  stance_advantage: 1.2,\n  stance_disadvantage: 0.8,\n  counter_attack: 1.5,\n  perfect_timing: 1.3,\n  off_balance: 0.7,\n  fatigued: 0.6,\n  focused: 1.1,\n} as const;\n\n// Combat resource costs\nexport const RESOURCE_COSTS = {\n  KI: {\n    BASIC_TECHNIQUE: 5,\n    ADVANCED_TECHNIQUE: 10,\n    SPECIAL_TECHNIQUE: 15,\n    ULTIMATE_TECHNIQUE: 25,\n  },\n  STAMINA: {\n    BASIC_ATTACK: 8,\n    HEAVY_ATTACK: 15,\n    BLOCK: 5,\n    DODGE: 10,\n    STANCE_CHANGE: 12,\n  },\n} as const;\n\n// Hit detection constants\nexport const HIT_DETECTION = {\n  PRECISION_THRESHOLD: 0.8,\n  VITAL_POINT_THRESHOLD: 0.9,\n  BASE_ACCURACY: 0.7,\n  MAX_ACCURACY: 0.95,\n\n  // Hit boxes\n  PLAYER_HITBOX_WIDTH: 60,\n  PLAYER_HITBOX_HEIGHT: 180,\n  VITAL_POINT_RADIUS: 15,\n} as const;\n\n// Status effect durations\nexport const STATUS_DURATIONS = {\n  STUN: 1500,\n  POISON: 5000,\n  BURN: 3000,\n  BLEED: 4000,\n  WEAKNESS: 6000,\n  STRENGTH_BUFF: 8000,\n} as const;\n\nexport interface CombatControlsConfig {\n  readonly stanceControls: Record<\n    string,\n    { stance: string; korean: string; technique: string }\n  >;\n  readonly movement: Record<string, string>;\n  readonly combat: Record<string, string>;\n  readonly system: Record<string, string>;\n}\n\n// Key mapping for easier lookup\nexport const KEYBOARD_MAPPING = {\n  // Stance keys\n  STANCE_1: \"1\",\n  STANCE_2: \"2\",\n  STANCE_3: \"3\",\n  STANCE_4: \"4\",\n  STANCE_5: \"5\",\n  STANCE_6: \"6\",\n  STANCE_7: \"7\",\n  STANCE_8: \"8\",\n\n  // Combat actions\n  EXECUTE_TECHNIQUE: \" \", // Space\n  BLOCK: \"Shift\",\n  TARGET_MODE: \"Control\",\n  ARCHETYPE_CYCLE: \"Tab\",\n\n  // Movement\n  MOVE_UP: \"w\",\n  MOVE_DOWN: \"s\",\n  MOVE_LEFT: \"a\",\n  MOVE_RIGHT: \"d\",\n\n  // System\n  PAUSE: \"Escape\",\n  HELP: \"F1\",\n  MUTE: \"m\",\n} as const;\n\n/**\n * Get the stance associated with a given key.\n *\n * @param key - The key to lookup.\n * @returns The corresponding stance, or null if not found.\n */\nexport function getStanceFromKey(key: string): TrigramStance | null {\n  const stanceMap: Record<string, TrigramStance> = {\n    \"1\": TrigramStance.GEON,\n    \"2\": TrigramStance.TAE,\n    \"3\": TrigramStance.LI,\n    \"4\": TrigramStance.JIN,\n    \"5\": TrigramStance.SON,\n    \"6\": TrigramStance.GAM,\n    \"7\": TrigramStance.GAN,\n    \"8\": TrigramStance.GON,\n  };\n  return stanceMap[key] ?? null;\n}\n\nexport interface CombatControlsConfig {\n  readonly stanceControls: Record<\n    string,\n    { stance: string; korean: string; technique: string }\n  >;\n  readonly movement: Record<string, string>;\n  readonly combat: Record<string, string>;\n  readonly system: Record<string, string>;\n}\n\n// Input handling types\nexport interface InputEvent {\n  readonly type: \"keydown\" | \"keyup\" | \"pointerdown\" | \"pointerup\";\n  readonly key?: string;\n  readonly position?: { x: number; y: number };\n  readonly timestamp: number;\n}\n\nexport interface CombatInput {\n  readonly player: number;\n  readonly action: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Combat input data varies by action type\n  readonly data?: any;\n}\n\n// Gesture types\nexport interface Gesture {\n  readonly type: \"tap\" | \"hold\" | \"swipe\" | \"combo\";\n  readonly duration?: number;\n  readonly direction?: \"up\" | \"down\" | \"left\" | \"right\";\n  readonly sequence?: string[];\n}\n\nexport const DEFAULT_GAME_SPEED = 1.0;\n\n/**\n * Core game configuration constants for Black Trigram\n */\n\n// Game configuration\nexport const GAME_CONFIG = {\n  // Canvas dimensions\n  CANVAS_WIDTH: 1200,\n  CANVAS_HEIGHT: 800,\n  TARGET_FPS: 60,\n  MIN_FPS: 30,\n\n  // Combat settings\n  ROUND_DURATION: 180, // seconds\n  MAX_ROUNDS: 3,\n  KO_THRESHOLD: 0,\n\n  // Player settings\n  BASE_HEALTH: 100,\n  BASE_KI: 100,\n  BASE_STAMINA: 100,\n\n  // Player positions\n  PLAYER_START_POS_X_1: 300,\n  PLAYER_START_POS_X_2: 900,\n  PLAYER_START_POS_Y: 400,\n\n  // Physics\n  GRAVITY: 9.8,\n  FRICTION: 0.85,\n\n  // UI settings\n  UI_PADDING: 20,\n  BUTTON_HEIGHT: 50,\n\n  // Audio settings\n  MASTER_VOLUME: 1.0,\n  MUSIC_VOLUME: 0.7,\n  SFX_VOLUME: 0.8,\n\n  // Debug settings\n  DEBUG_MODE: false,\n  SHOW_HITBOXES: false,\n  SHOW_VITAL_POINTS: false,\n} as const;\n\n// Add missing player colors\nexport const PLAYER_COLORS = {\n  PLAYER_1_COLOR: 0x0099ff, // Blue\n  PLAYER_2_COLOR: 0xff9900, // Orange\n} as const;\n\n// Difficulty settings\nexport const DIFFICULTY_SETTINGS = {\n  BEGINNER: {\n    AI_REACTION_TIME: 800,\n    DAMAGE_MULTIPLIER: 0.7,\n    TECHNIQUE_SUCCESS_RATE: 0.6,\n  },\n  INTERMEDIATE: {\n    AI_REACTION_TIME: 600,\n    DAMAGE_MULTIPLIER: 1.0,\n    TECHNIQUE_SUCCESS_RATE: 0.8,\n  },\n  EXPERT: {\n    AI_REACTION_TIME: 400,\n    DAMAGE_MULTIPLIER: 1.3,\n    TECHNIQUE_SUCCESS_RATE: 0.9,\n  },\n  MASTER: {\n    AI_REACTION_TIME: 200,\n    DAMAGE_MULTIPLIER: 1.5,\n    TECHNIQUE_SUCCESS_RATE: 0.95,\n  },\n} as const;\n\n// Game phases\nexport const GAME_PHASES = {\n  INTRO: \"intro\",\n  TRAINING: \"training\",\n  COMBAT: \"combat\",\n  VICTORY: \"victory\",\n  DEFEAT: \"defeat\",\n} as const;\n\n// Game version and metadata\nexport const GAME_METADATA = {\n  VERSION: \"1.0.0\",\n  BUILD: \"2024.1\",\n  TITLE: \"흑괘 (Black Trigram)\",\n  SUBTITLE: \"Korean Martial Arts Combat Simulator\",\n  DEVELOPER: \"Black Trigram Team\",\n  COPYRIGHT: \"© 2024 Black Trigram\",\n} as const;\n\n// Performance thresholds\nexport const PERFORMANCE_THRESHOLDS = {\n  TARGET_FPS: 60,\n  MIN_FPS: 30,\n  FRAME_TIME_WARNING: 20, // ms\n  MEMORY_WARNING: 100, // MB\n  GARBAGE_COLLECTION_THRESHOLD: 50, // MB\n} as const;\n\n// Combat timing constants\nexport const COMBAT_TIMING = {\n  ATTACK_WINDOW: 500, // ms\n  DEFENSE_WINDOW: 300, // ms\n  RECOVERY_TIME: 200, // ms\n  COUNTER_WINDOW: 150, // ms\n} as const;\n\n// Damage calculation constants\nexport const DAMAGE_CONSTANTS = {\n  BASE_DAMAGE: 10,\n  CRITICAL_MULTIPLIER: 2.0,\n  VITAL_POINT_MULTIPLIER: 1.5,\n  ARMOR_REDUCTION: 0.1,\n  STANCE_DEFENSE_BONUS: 0.2,\n  BALANCE_IMPACT_MULTIPLIER: 0.3,\n  CONSCIOUSNESS_THRESHOLD: 30,\n  PAIN_THRESHOLD: 80,\n  BASE_CRIT_CHANCE: 0.1, // Added: Base critical hit chance (e.g., 10%)\n  TECHNIQUE_ACCURACY_MODIFIER: 1.0, // Added\n  STANCE_EFFECTIVENESS_RANGE: { MIN: 0.5, MAX: 1.5 }, // Added\n  PERFECT_TIMING_BONUS: 0.3, // Added\n} as const;\n\n// Animation timings\nexport const ANIMATION_TIMINGS = {\n  STANCE_TRANSITION: 300,\n  TECHNIQUE_STARTUP: 150,\n  TECHNIQUE_ACTIVE: 100,\n  TECHNIQUE_RECOVERY: 250,\n  HIT_STUN: 200,\n  BLOCK_STUN: 100,\n  KNOCKDOWN_RECOVERY: 1000,\n} as const;\n\n// UI Layout constants\nexport const UI_LAYOUT = {\n  HUD_HEIGHT: 80,\n  CONTROLS_HEIGHT: 120,\n  SIDEBAR_WIDTH: 200,\n  MARGIN: 20,\n  BUTTON_HEIGHT: 50,\n  BUTTON_WIDTH: 150,\n} as const;\n\n// Audio volume defaults\nexport const AUDIO_DEFAULTS = {\n  MASTER_VOLUME: 0.7,\n  SFX_VOLUME: 0.8,\n  MUSIC_VOLUME: 0.5,\n  AMBIENT_VOLUME: 0.3,\n} as const;\n\n// Calculated constants based on GAME_CONFIG\nexport const HALF_CANVAS_WIDTH = GAME_CONFIG.CANVAS_WIDTH / 2;\nexport const HALF_CANVAS_HEIGHT = GAME_CONFIG.CANVAS_HEIGHT / 2;\nexport const CANVAS_ASPECT_RATIO =\n  GAME_CONFIG.CANVAS_WIDTH / GAME_CONFIG.CANVAS_HEIGHT;\nexport const FRAME_TIME = 1000 / GAME_CONFIG.TARGET_FPS;\nexport const TICK_RATE = GAME_CONFIG.TARGET_FPS;\n\n// Player distance calculations\nexport const PLAYER_DISTANCE =\n  GAME_CONFIG.PLAYER_START_POS_X_2 - GAME_CONFIG.PLAYER_START_POS_X_1;\nexport const CENTER_POSITION_X =\n  (GAME_CONFIG.PLAYER_START_POS_X_1 + GAME_CONFIG.PLAYER_START_POS_X_2) / 2;\n\n// Combat ranges\nexport const COMBAT_RANGES = {\n  MELEE_RANGE: 80,\n  CLOSE_RANGE: 120,\n  MEDIUM_RANGE: 200,\n  LONG_RANGE: 300,\n  MAX_RANGE: PLAYER_DISTANCE,\n} as const;\n\n// Game state constants\nexport const GAME_STATES = {\n  LOADING: \"loading\",\n  MENU: \"menu\",\n  CHARACTER_SELECT: \"character_select\",\n  TRAINING: \"training\",\n  COMBAT: \"combat\",\n  PAUSED: \"paused\",\n  GAME_OVER: \"game_over\",\n} as const;\n\n// Input constants\nexport const INPUT_CONSTANTS = {\n  DOUBLE_TAP_TIME: 300, // ms\n  HOLD_THRESHOLD: 500, // ms\n  GESTURE_TIMEOUT: 1000, // ms\n  COMBO_TIMEOUT: 2000, // ms\n} as const;\n\n// Visual effect constants\nexport const VISUAL_EFFECTS = {\n  HIT_FLASH_DURATION: 100,\n  SCREEN_SHAKE_INTENSITY: 5,\n  PARTICLE_LIFETIME: 1000,\n  GLOW_PULSE_SPEED: 2,\n  STANCE_GLOW_OPACITY: 0.3,\n} as const;\n\n// Training mode constants\nexport const TRAINING_CONFIG = {\n  DUMMY_HEALTH: 1000,\n  AUTO_RESET_TIME: 5000, // ms\n  SHOW_FRAME_DATA: true,\n  SHOW_HITBOXES: true,\n  INFINITE_KI: true,\n  INFINITE_STAMINA: true,\n} as const;\n\n// Game mode configurations\nexport const GAME_MODE_CONFIG = {\n  VERSUS: {\n    allowPause: true,\n    timeLimit: 180,\n    rounds: 3,\n    enableAI: false,\n  },\n  TRAINING: {\n    allowPause: true,\n    timeLimit: null,\n    rounds: 1,\n    enableAI: true,\n    infiniteResources: true,\n  },\n  PRACTICE: {\n    allowPause: true,\n    timeLimit: null,\n    rounds: 1,\n    enableAI: false,\n    infiniteResources: true,\n  },\n} as const;\n\n// Performance settings\nexport const PERFORMANCE_CONFIG = {\n  MAX_PARTICLES: 100,\n  MAX_SOUND_SOURCES: 16,\n  TEXTURE_QUALITY: \"high\",\n  ENABLE_SHADOWS: true,\n  ENABLE_POST_PROCESSING: true,\n} as const;\n\n// Korean martial arts specific settings\nexport const MARTIAL_ARTS_CONFIG = {\n  VITAL_POINTS_COUNT: 70,\n  TRIGRAM_STANCES_COUNT: 8,\n  PLAYER_ARCHETYPES_COUNT: 5,\n\n  // Combat timing\n  ATTACK_WINDOW: 500, // milliseconds\n  COUNTER_WINDOW: 300,\n  BLOCK_WINDOW: 200,\n\n  // Stance transition\n  MIN_STANCE_CHANGE_INTERVAL: 500,\n  STANCE_CHANGE_COST_BASE: 10,\n\n  // Damage calculations\n  BASE_DAMAGE_MULTIPLIER: 1.0,\n  CRITICAL_HIT_MULTIPLIER: 1.5,\n  VITAL_POINT_MULTIPLIER: 2.5, // Increased from 2.0 for impactful vital point strikes\n} as const;\n\nexport default GAME_CONFIG;\n"],"mappings":"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"}

package/lib/systems/vitalpoint/DamageCalculator.d.ts

@@ -0,0 +1,255 @@
+import { PlayerArchetype } from "../../types/common";
+import { type HipRotationState } from "../animation";
+import { PlayerState } from "../player";
+import { DamageResult, KoreanTechnique, VitalPoint, VitalPointHitResult } from "./types";
+export declare class DamageCalculator {
+    /**
+     * Vital point severity damage multipliers
+     */
+    private static readonly SEVERITY_MULTIPLIERS;
+    /**
+     * Accuracy bonus scaling constants
+     * Maps 0.0-1.0 accuracy to 0.8x-1.2x multiplier
+     */
+    private static readonly ACCURACY_MIN_MULTIPLIER;
+    private static readonly ACCURACY_RANGE;
+    /**
+     * Calculate vital point damage with proper archetype bonuses
+     */
+    static calculateVitalPointDamage(vitalPoint: VitalPoint, baseDamage: number, attacker: PlayerState, accuracy: number): DamageResult;
+    /**
+     * Fix: Add missing getArchetypeModifier method
+     */
+    static getArchetypeModifier(archetype: PlayerArchetype): number;
+    /**
+     * Calculate technique damage with vital point consideration
+     */
+    static calculateTechniqueDamage(technique: KoreanTechnique, attacker: PlayerState, vitalPoint: VitalPoint | null, accuracy: number): DamageResult;
+    /**
+     * Calculate damage reduction from defense
+     */
+    static calculateDamageReduction(incomingDamage: number, defenderDefense: number, isBlocking?: boolean): number;
+    /**
+     * Calculate critical hit chance
+     */
+    static calculateCriticalChance(baseCritChance: number, attacker: PlayerState, technique: KoreanTechnique): number;
+    /**
+     * Calculate comprehensive vital point damage with all modifiers.
+     *
+     * **Korean**: 종합 급소 피해 계산 (Comprehensive Vital Point Damage Calculation)
+     *
+     * Integrates all damage modifiers including:
+     * - Base damage from attacker strength and technique power
+     * - Stance effectiveness (攻克关系)
+     * - Vital point severity multipliers (1.5x-3.0x)
+     * - Accuracy bonus (0.8x-1.2x)
+     * - Meridian flow bonus (1.0x-1.3x at peak hours)
+     * - Time-of-day bonus (+20% for Dark Ops techniques at night)
+     * - Archetype-specific bonuses
+     * - Hip rotation power modifier (1.0x-1.3x for strikes with full rotation)
+     * - Critical hit multiplier (2x when accuracy > 0.9)
+     * - Damage variance (±10% randomness)
+     * - Defense reduction
+     *
+     * ## Damage Formula
+     *
+     * ```typescript
+     * finalDamage =
+     *   baseDamage ×
+     *   stanceEffectiveness ×
+     *   vitalPointMultiplier ×
+     *   accuracyBonus ×
+     *   meridianBonus ×
+     *   timeBonus ×
+     *   archetypeBonus ×
+     *   hipRotationModifier ×
+     *   criticalMultiplier ×
+     *   variance ×
+     *   defenseReduction
+     * ```
+     *
+     * @param attacker - Attacking player state
+     * @param defender - Defending player state
+     * @param technique - Korean martial arts technique being used
+     * @param vitalPointHit - Result of vital point hit detection
+     * @param currentHour - Current hour of day (0-23) for meridian flow
+     * @param meridianStates - Current meridian disruption states (0=blocked, 1=normal)
+     * @param hipRotationAngle - Hip rotation angle in radians (optional, defaults to 0)
+     * @param kickHipState - Hip rotation state for kicks (optional, for kick-specific power)
+     * @returns Comprehensive damage result with all modifiers applied
+     *
+     * @example
+     * ```typescript
+     * const result = DamageCalculator.calculateEnhancedVitalPointDamage(
+     *   attackerState,
+     *   defenderState,
+     *   technique,
+     *   vitalPointHitResult,
+     *   2, // 2 AM - liver meridian peak
+     *   { liver: 1.0, gallbladder: 0.8 }
+     * );
+     * console.log(`Final damage: ${result.damage}`);
+     * console.log(`Critical hit: ${result.isCritical}`);
+     * ```
+     *
+     * @public
+     * @korean 종합급소피해계산
+     */
+    static calculateEnhancedVitalPointDamage(attacker: PlayerState, defender: PlayerState, technique: KoreanTechnique, vitalPointHit: VitalPointHitResult, currentHour: number, meridianStates: Record<string, number>, hipRotationAngle?: number, kickHipState?: HipRotationState): DamageResult;
+    /**
+     * Determine kick type from technique name for hip rotation power calculation
+     *
+     * @param techniqueName - Name of the technique
+     * @returns Kick type for hip rotation calculation
+     *
+     * @private
+     * @korean 차기유형결정
+     */
+    private static determineKickType;
+    /**
+     * Calculate meridian flow damage bonus based on time of day.
+     *
+     * **Korean**: 경락 유효성 피해 보너스 계산
+     *
+     * Calculates bonus damage when striking vital points during their peak
+     * meridian flow hours. Peak flow provides +30% damage bonus.
+     *
+     * @param vitalPointId - ID of the vital point being struck
+     * @param currentHour - Current hour of day (0-23)
+     * @param meridianStates - Current meridian disruption states
+     * @returns Damage multiplier (1.0-1.3)
+     *
+     * @private
+     * @korean 경락유효성피해보너스계산
+     */
+    private static calculateMeridianDamageBonus;
+    /**
+     * Calculate time-of-day bonus for Dark Ops techniques.
+     *
+     * **Korean**: 시간대 보너스 계산
+     *
+     * Dark Ops techniques gain +20% damage at night (20:00-05:59)
+     * to reflect tactical advantage of darkness.
+     *
+     * @param technique - Technique being used
+     * @param currentHour - Current hour of day (0-23)
+     * @returns Time bonus multiplier (1.0 or 1.2)
+     *
+     * @private
+     * @korean 시간대보너스계산
+     */
+    private static calculateTimeBonus;
+    /**
+     * Get archetype-specific damage bonus for technique and vital point.
+     *
+     * **Korean**: 원형 특화 피해 보너스
+     *
+     * Each archetype has specialized bonuses for different techniques
+     * and vital point categories:
+     *
+     * - **무사 (Musa)**: +20% with 건 (Geon) stance techniques
+     * - **암살자 (Amsalja)**: +30% on neurological vital points
+     * - **해커 (Hacker)**: +15% baseline precision bonus
+     * - **정보요원 (Jeongbo)**: +25% on vascular vital points
+     * - **조직폭력배 (Jojik)**: +20% on dirty/ruthless techniques
+     *
+     * @param archetype - Attacker's archetype
+     * @param technique - Technique being used
+     * @param vitalPoint - Vital point being struck (optional)
+     * @returns Archetype damage multiplier (1.0-1.5)
+     *
+     * @private
+     * @korean 원형특화피해보너스
+     */
+    private static getArchetypeDamageBonus;
+    /**
+     * Calculate throw/takedown impact damage with ground multiplier.
+     *
+     * **Korean**: 던지기 충격 피해 계산 (Throw Impact Damage Calculation)
+     *
+     * Applies groundImpactMultiplier from Gon (Earth) techniques when opponent
+     * hits the ground after a throw or takedown. Integrates with base damage
+     * calculation to provide authentic Ssireum/Hapkido throw mechanics.
+     *
+     * **Formula**:
+     * ```
+     * impactDamage = baseDamage × groundImpactMultiplier × strengthModifier
+     * ```
+     *
+     * **Ground Impact Multiplier Ranges**:
+     * - 1.0-1.2: Low impact (controlled takedowns)
+     * - 1.3-1.5: Medium impact (standard throws)
+     * - 1.6-1.8: High impact (power throws)
+     * - 1.9-2.0: Maximum impact (slams like 대지강타)
+     *
+     * @param technique - Korean martial arts technique (checks for ExtendedGonTechnique)
+     * @param baseDamage - Base damage before ground impact modifier
+     * @param attackerStrength - Attacker's strength stat for scaling
+     * @param options - Optional configuration for damage calculation
+     * @param options.applyVariance - Whether to apply random ±5% variance (default: true)
+     * @returns Enhanced damage result with ground impact applied
+     *
+     * @example
+     * ```typescript
+     * const throwDamage = DamageCalculator.calculateThrowImpactDamage(
+     *   ssireumThrowTechnique, // groundImpactMultiplier: 1.7
+     *   50, // base damage
+     *   80  // attacker strength
+     * );
+     * // Result: ~85 damage (50 × 1.7 × 1.0) with ±5% variance
+     *
+     * // For deterministic testing:
+     * const testDamage = DamageCalculator.calculateThrowImpactDamage(
+     *   technique, 50, 80, { applyVariance: false }
+     * );
+     * ```
+     *
+     * @public
+     * @korean 던지기충격피해계산
+     */
+    static calculateThrowImpactDamage(technique: KoreanTechnique, baseDamage: number, attackerStrength?: number, options?: {
+        applyVariance?: boolean;
+    }): DamageResult;
+    /**
+     * Calculate earth's supportive healing from Gon technique.
+     *
+     * **Korean**: 대지 치유 계산 (Earth Healing Calculation)
+     *
+     * Implements Korean martial arts philosophy:
+     * "대지는 모든 것을 품고 키운다" (The earth embraces and nurtures all things)
+     *
+     * Gon techniques restore HP to the attacker after successful execution
+     * based on their connection with earth energy. Traditional techniques
+     * like Ssireum throws provide stronger healing due to cultural authenticity.
+     *
+     * **Healing Formula**:
+     * ```
+     * healingAmount = supportiveHealing × (1 + earthAffinityBonus)
+     * ```
+     *
+     * **Supportive Healing Ranges**:
+     * - 0-2: Minimal earth connection (aggressive techniques)
+     * - 3-4: Moderate earth connection (standard Ssireum)
+     * - 5-6: Strong earth connection (traditional, sacrifice throws)
+     * - 7-10: RESERVED for meditation/healing techniques
+     *
+     * @param technique - Korean martial arts technique (checks for ExtendedGonTechnique)
+     * @param earthAffinityBonus - Player's earth affinity stat modifier (0.0-1.0)
+     * @returns HP healing amount (0 if not a Gon technique)
+     *
+     * @example
+     * ```typescript
+     * const healing = DamageCalculator.calculateEarthHealing(
+     *   ssireumThrowTechnique, // supportiveHealing: 5
+     *   0.3 // 30% earth affinity bonus
+     * );
+     * // Result: 6.5 HP restored (5 × 1.3)
+     * ```
+     *
+     * @public
+     * @korean 대지치유계산
+     */
+    static calculateEarthHealing(technique: KoreanTechnique, earthAffinityBonus?: number): number;
+}
+export default DamageCalculator;
+//# sourceMappingURL=DamageCalculator.d.ts.map

package/lib/systems/vitalpoint/DamageCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DamageCalculator.d.ts","sourceRoot":"","sources":["../../../src/systems/vitalpoint/DamageCalculator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAMxC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,UAAU,EACV,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAS1C;IAEF;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAO;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;IAE7C;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAC9B,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,MAAM,GACf,YAAY;IAyCf;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM;IAiB/D;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,UAAU,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,GACf,YAAY;IAwCf;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,UAAU,GAAE,OAAe,GAC1B,MAAM;IAUT;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,eAAe,GACzB,MAAM;IAQT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6DG;IACH,MAAM,CAAC,iCAAiC,CACtC,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE,mBAAmB,EAClC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,gBAAgB,GAAE,MAAU,EAC5B,YAAY,CAAC,EAAE,gBAAgB,GAC9B,YAAY;IAkHf;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAmChC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,MAAM,CAAC,4BAA4B;IA6B3C;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAqBjC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAqDtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,MAAM,CAAC,0BAA0B,CAC/B,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,MAAM,EAClB,gBAAgB,GAAE,MAAW,EAC7B,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GACxC,YAAY;IA4Cf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,CAAC,qBAAqB,CAC1B,SAAS,EAAE,eAAe,EAC1B,kBAAkB,GAAE,MAAU,GAC7B,MAAM;CAkBV;AAED,eAAe,gBAAgB,CAAC"}