blacktrigram 0.7.2

package/lib/systems/types.d.ts

@@ -0,0 +1,1038 @@
+/**
+ * Type definitions for systems types
+ * Auto-generated by type migration script
+ */
+import { AudioSystemInterface, SoundEffectId } from "../audio";
+import type { EffectIntensity, EnvironmentalEffectType, HitEffectType, ParticleType } from "./effects";
+import { KoreanText, PlayerArchetype, Position, TrigramStance } from "../types/common";
+export interface AnimationConfig {
+    readonly name: string;
+    readonly frames: readonly AnimationFrame[];
+    readonly loop?: boolean;
+    readonly speed?: number;
+}
+export interface CombatSystemConfig {
+    readonly damageMultiplier: number;
+    readonly criticalChance: number;
+}
+export interface TrigramSystemConfig {
+    readonly transitionSpeed: number;
+    readonly energyCost: number;
+}
+export interface AISystemConfig {
+    readonly difficulty: "easy" | "medium" | "hard" | "expert";
+    readonly reactionTime: number;
+}
+export interface VitalPointSystemConfig {
+    readonly precisionRequired: number;
+    readonly damageMultipliers: Record<string, number>;
+    readonly effectDurations: Record<string, number>;
+}
+type Texture = unknown;
+export interface PlayerArchetypeData {
+    readonly id: string;
+    readonly name: KoreanText;
+    readonly description: KoreanText;
+    readonly baseHealth: number;
+    readonly baseKi: number;
+    readonly baseStamina: number;
+    readonly coreStance: TrigramStance;
+    readonly theme: {
+        primary: number;
+        secondary: number;
+    };
+    readonly colors: {
+        primary: number;
+        secondary: number;
+    };
+    readonly stats: {
+        attackPower: number;
+        defense: number;
+        speed: number;
+        technique: number;
+    };
+    readonly favoredStances: readonly TrigramStance[];
+    readonly specialAbilities: readonly string[];
+    readonly philosophy: KoreanText;
+}
+export interface AnimationState {
+    readonly currentAnimationName?: string;
+    readonly currentFrameIndex: number;
+    readonly isPlaying: boolean;
+    readonly elapsedTimeInFrame: number;
+}
+export interface CollisionData {
+    readonly entityA: EntityId;
+    readonly entityB: EntityId;
+    readonly normal: Velocity;
+    readonly penetration: number;
+}
+export interface PhysicsEntityConfig {
+    readonly position: Position;
+    readonly velocity?: Velocity;
+    readonly mass?: number;
+    readonly friction?: number;
+    readonly restitution?: number;
+    readonly shape: {
+        type: "circle";
+        radius: number;
+    } | {
+        type: "rectangle";
+        width: number;
+        height: number;
+    };
+    readonly isStatic?: boolean;
+}
+export interface PhysicsEntityState {
+    readonly position: Position;
+    readonly velocity: Velocity;
+    readonly acceleration?: Velocity;
+    readonly angularVelocity?: number;
+}
+export interface RenderableConfig {
+    readonly zOrder?: number;
+    readonly visible?: boolean;
+    readonly alpha?: number;
+    readonly parent?: EntityId | "stage";
+}
+export interface StatusEffect {
+    readonly id: string;
+    readonly type: string;
+    readonly intensity: EffectIntensity;
+    readonly duration: number;
+    readonly description: KoreanText;
+    readonly stackable: boolean;
+    readonly source: string;
+    readonly startTime: number;
+    readonly endTime: number;
+}
+export interface HitEffect {
+    readonly id: string;
+    readonly type: HitEffectType;
+    readonly attackerId: string;
+    readonly defenderId: string;
+    readonly timestamp: number;
+    readonly duration: number;
+    readonly position?: Position;
+    readonly velocity?: {
+        x: number;
+        y: number;
+    };
+    readonly color?: number;
+    readonly size?: number;
+    readonly alpha?: number;
+    readonly lifespan?: number;
+    readonly text?: string | KoreanText;
+    readonly damageAmount?: number;
+    readonly vitalPointId?: string;
+    readonly statusEffect?: StatusEffect;
+    readonly yOffset?: number;
+    readonly intensity: number;
+    readonly startTime: number;
+}
+export interface ParticleEffect {
+    readonly id: string;
+    readonly type: ParticleType;
+    readonly position: Position;
+    readonly velocity: {
+        x: number;
+        y: number;
+    };
+    readonly acceleration?: {
+        x: number;
+        y: number;
+    };
+    readonly color: number;
+    readonly size: number;
+    readonly lifetime: number;
+    readonly fadeOut?: boolean;
+    readonly gravity?: number;
+}
+export interface EnvironmentalEffect {
+    readonly id: string;
+    readonly type: EnvironmentalEffectType;
+    readonly affectedArea: {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly effects: {
+        readonly visibilityModifier?: number;
+        readonly accuracyModifier?: number;
+        readonly movementModifier?: number;
+        readonly damageModifier?: number;
+    };
+    readonly duration: number;
+}
+export interface VisualEffect {
+    readonly id: string;
+    readonly type: string;
+    readonly duration: number;
+    readonly intensity: number;
+    readonly position?: Position;
+    readonly color?: number;
+}
+export interface EffectSystem {
+    readonly effects: readonly VisualEffect[];
+    readonly addEffect: (effect: VisualEffect) => void;
+    readonly removeEffect: (id: string) => void;
+    readonly updateEffects: (deltaTime: number) => void;
+}
+export interface DisplayHitEffect extends HitEffect {
+    readonly opacity: number;
+    readonly scale: number;
+    readonly startTime: number;
+    readonly displayAlpha: number;
+    readonly displayY: number;
+    readonly displaySize: number;
+}
+export interface InputSystemInterface {
+    registerAction: (action: string, callback: () => void) => void;
+    unregisterAction: (action: string) => void;
+    clearActions: () => void;
+    isActionActive: (action: string) => boolean;
+}
+export interface AnimationSystemInterface {
+    playAnimation: (entityId: EntityId, animationName: string) => void;
+    stopAnimation: (entityId: EntityId, animationName?: string) => void;
+    getCurrentFrame: (entityId: EntityId) => AnimationFrame | undefined;
+    addAnimation: (config: AnimationConfig) => void;
+    getAnimationState: (entityId: EntityId) => AnimationState | undefined;
+}
+export interface PhysicsSystemInterface {
+    addEntity: (entityId: EntityId, config: PhysicsEntityConfig) => void;
+    removeEntity: (entityId: EntityId) => void;
+    update: (deltaTime: number) => void;
+    getEntityState: (entityId: EntityId) => PhysicsEntityState | undefined;
+    checkCollision: (entityIdA: EntityId, entityIdB: EntityId) => CollisionData | null;
+    applyForce: (entityId: EntityId, force: Velocity) => void;
+}
+export interface RenderingSystemInterface {
+    addRenderable: (entityId: EntityId, config: RenderableConfig) => void;
+    removeRenderable: (entityId: EntityId) => void;
+    updateRenderable: (entityId: EntityId, updates: Partial<RenderableConfig>) => void;
+    render: () => void;
+}
+export interface SystemEvent {
+    readonly type: string;
+    readonly timestamp: number;
+    readonly source: string;
+    readonly data: Record<string, any>;
+}
+export interface EventBusInterface {
+    publish: (event: SystemEvent) => void;
+    subscribe: (eventType: string, callback: (event: SystemEvent) => void) => void;
+    unsubscribe: (eventType: string, callback: (event: SystemEvent) => void) => void;
+}
+export interface CombatSystemInterface {
+    calculateDamage: (technique: any, attacker: any, defender: any, hitResult: any) => {
+        baseDamage: number;
+        modifierDamage: number;
+        totalDamage: number;
+        effectsApplied: readonly StatusEffect[];
+        finalDefenderState?: any;
+    };
+    resolveAttack: (attacker: any, defender: any, technique: any, targetedVitalPointId?: string) => any;
+    applyCombatResult: (result: any, attacker: any, defender: any) => {
+        updatedAttacker: any;
+        updatedDefender: any;
+    };
+    getAvailableTechniques: (player: any) => readonly any[];
+}
+export interface VitalPointSystemInterface {
+    processHit: (targetPosition: Position, technique: any, baseDamage: number, attackerArchetype: any, targetDimensions: {
+        width: number;
+        height: number;
+    }, targetedVitalPointId?: string | null) => any;
+    calculateHit: (technique: any, targetVitalPointId: string | null, accuracyRoll: number, attackerPosition: Position, defenderPosition: Position, defenderStance: any) => any;
+    applyVitalPointEffects: (player: any, vitalPoint: any, intensityMultiplier?: number) => any;
+}
+export interface TrigramSystemInterface {
+    getTechniqueForStance: (stance: any, archetype?: any) => any | undefined;
+    calculateStanceEffectiveness: (attackerStance: any, defenderStance: any, technique?: any) => number;
+    isValidTransition: (from: any, to: any) => boolean;
+    getTransitionCost: (from: any, to: any, player?: any) => {
+        ki: number;
+        stamina: number;
+        timeMs: number;
+    };
+    recommendStance: (player: any, opponent?: any) => any;
+}
+export interface GameSystemManager {
+    readonly combatSystem: CombatSystemInterface;
+    readonly vitalPointSystem: VitalPointSystemInterface;
+    readonly trigramSystem: TrigramSystemInterface;
+    readonly inputSystem: InputSystemInterface;
+    readonly audioSystem: AudioSystemInterface;
+    readonly animationSystem?: AnimationSystemInterface;
+    readonly physicsSystem?: PhysicsSystemInterface;
+    readonly renderingSystem?: RenderingSystemInterface;
+    readonly eventBus: EventBusInterface;
+    initializeAll: () => Promise<void>;
+    updateAll: (deltaTime: number) => void;
+}
+export interface SystemConfig {
+    readonly debugMode?: boolean;
+    readonly performanceMonitoring?: boolean;
+}
+export interface GameSystemState {
+    readonly combat: CombatSystemConfig;
+    readonly trigram: TrigramSystemConfig;
+    readonly vitalPoint: VitalPointSystemConfig;
+    readonly ai: AISystemConfig;
+}
+export interface SystemPerformance {
+    readonly fps: number;
+    readonly memoryUsage: number;
+    readonly renderTime: number;
+    readonly updateTime: number;
+}
+export type Timestamp = number;
+export type EntityId = string;
+export interface Velocity {
+    readonly x: number;
+    readonly y: number;
+}
+export interface GamepadState {
+    readonly id: string;
+    readonly axes: readonly number[];
+    readonly buttons: readonly {
+        pressed: boolean;
+        value: number;
+    }[];
+}
+export interface AnimationFrame {
+    readonly texture: Texture;
+    readonly duration: number;
+}
+export interface AnimationState {
+    readonly currentAnimationName?: string;
+    readonly currentFrameIndex: number;
+    readonly isPlaying: boolean;
+    readonly elapsedTimeInFrame: number;
+}
+export interface PhysicsEntityConfig {
+    readonly position: Position;
+    readonly velocity?: Velocity;
+    readonly mass?: number;
+    readonly friction?: number;
+    readonly restitution?: number;
+    readonly shape: {
+        type: "circle";
+        radius: number;
+    } | {
+        type: "rectangle";
+        width: number;
+        height: number;
+    };
+    readonly isStatic?: boolean;
+}
+export interface PhysicsEntityState {
+    readonly position: Position;
+    readonly velocity: Velocity;
+    readonly acceleration?: Velocity;
+    readonly angularVelocity?: number;
+}
+export interface CollisionData {
+    readonly entityA: EntityId;
+    readonly entityB: EntityId;
+    readonly normal: Velocity;
+    readonly penetration: number;
+}
+export interface CombatSystemConfig {
+    readonly damageMultiplier: number;
+    readonly criticalChance: number;
+    readonly blockEffectiveness: number;
+    readonly staminaDrainRate: number;
+}
+export interface TrigramSystemConfig {
+    readonly transitionSpeed: number;
+    readonly energyCost: number;
+    readonly effectivenessMatrix: Record<TrigramStance, Record<TrigramStance, number>>;
+}
+export interface AISystemConfig {
+    readonly difficulty: "easy" | "medium" | "hard" | "expert";
+    readonly reactionTime: number;
+    readonly aggressiveness: number;
+    readonly adaptability: number;
+}
+export declare const PLAYER_ARCHETYPES_DATA: Record<PlayerArchetype, PlayerArchetypeData>;
+export declare const BASE_PLAYER_STATS: {
+    readonly HEALTH: 100;
+    readonly KI: 100;
+    readonly STAMINA: 100;
+    readonly ATTACK_POWER: 75;
+    readonly DEFENSE: 75;
+    readonly SPEED: 75;
+    readonly TECHNIQUE: 75;
+};
+export declare const COMBAT_CONFIG: {
+    readonly MAX_HEALTH: 100;
+    readonly MAX_KI: 100;
+    readonly MAX_STAMINA: 100;
+    readonly MAX_BALANCE: 100;
+    readonly MAX_CONSCIOUSNESS: 100;
+    readonly CRITICAL_HIT_MULTIPLIER: 2;
+    readonly VITAL_POINT_MULTIPLIER: 2.5;
+    readonly COUNTER_ATTACK_MULTIPLIER: 1.3;
+    readonly LOW_HEALTH_THRESHOLD: 25;
+    readonly CRITICAL_HEALTH_THRESHOLD: 10;
+    readonly UNCONSCIOUS_THRESHOLD: 0;
+    readonly STAMINA_EXHAUSTED_THRESHOLD: 0;
+    readonly STAMINA_RECOVERY_RATE: 15;
+    readonly KI_RECOVERY_RATE: 8;
+    readonly BALANCE_RECOVERY_RATE: 15;
+    readonly CONSCIOUSNESS_RECOVERY_RATE: 2;
+    readonly TECHNIQUE_COOLDOWN: 500;
+    readonly STANCE_CHANGE_COOLDOWN: 200;
+    readonly BLOCK_DURATION: 300;
+    readonly RECOVERY_TIME: 400;
+};
+export declare const ENHANCED_DAMAGE_CONSTANTS: {
+    readonly BASE_DAMAGE: 10;
+    readonly CRITICAL_MULTIPLIER: 2;
+    readonly VITAL_POINT_MULTIPLIER: 2.5;
+    readonly ARMOR_REDUCTION: 0.1;
+    readonly STANCE_DEFENSE_BONUS: 0.2;
+    readonly BALANCE_IMPACT_MULTIPLIER: 0.3;
+    readonly CONSCIOUSNESS_THRESHOLD: 30;
+    readonly PAIN_THRESHOLD: 80;
+    readonly TECHNIQUE_POWER_MODIFIER: 0.2;
+    readonly ARCHETYPE_BONUS: 0.15;
+    readonly COMBO_MULTIPLIER: 1.2;
+    readonly PERFECT_TIMING_BONUS: 0.3;
+    readonly BASE_CRIT_CHANCE: 0.1;
+};
+export declare const COMBAT_CONSTANTS: {
+    readonly BASE_DAMAGE: 10;
+    readonly CRITICAL_MULTIPLIER: 2;
+    readonly VITAL_POINT_MULTIPLIER: 2.5;
+    readonly LOW_HEALTH_THRESHOLD: 30;
+    readonly CRITICAL_HEALTH_THRESHOLD: 15;
+    readonly EXHAUSTED_STAMINA_THRESHOLD: 20;
+    readonly STAMINA_RECOVERY_RATE: 15;
+    readonly KI_RECOVERY_RATE: 8;
+    readonly CONSCIOUSNESS_RECOVERY_RATE: 2;
+    readonly ATTACK_COOLDOWN: 500;
+    readonly STANCE_CHANGE_COOLDOWN: 300;
+    readonly BLOCK_WINDOW: 200;
+    readonly BALANCE_RECOVERY_RATE: 10;
+    readonly MOMENTUM_DECAY_RATE: 5;
+    readonly PAIN_DECAY_RATE: 3;
+    readonly STATUS_EFFECT_DURATION: 3000;
+};
+export declare const COMBAT_CONTROLS: {
+    readonly stanceControls: {
+        readonly "1": {
+            readonly stance: TrigramStance;
+            readonly korean: "건";
+            readonly english: "Heaven";
+            readonly symbol: "☰";
+            readonly technique: {
+                readonly korean: "천둥벽력";
+                readonly english: "Thunder Strike";
+            };
+            readonly combatFocus: {
+                readonly korean: "골격타격";
+                readonly english: "Bone-striking force";
+            };
+            readonly combatEffects: {
+                readonly korean: "골절, 구조적 손상";
+                readonly english: "Fractures, structural damage";
+            };
+            readonly description: {
+                readonly korean: "하늘의 힘으로 적의 뼈를 부수는 강력한 타격";
+                readonly english: "Powerful strikes that shatter enemy bones with heaven's force";
+            };
+        };
+        readonly "2": {
+            readonly stance: TrigramStance;
+            readonly korean: "태";
+            readonly english: "Lake";
+            readonly symbol: "☱";
+            readonly technique: {
+                readonly korean: "유수연타";
+                readonly english: "Flowing Strike";
+            };
+            readonly combatFocus: {
+                readonly korean: "관절조작";
+                readonly english: "Joint manipulation";
+            };
+            readonly combatEffects: {
+                readonly korean: "탈구, 이동력 상실";
+                readonly english: "Dislocations, mobility loss";
+            };
+            readonly description: {
+                readonly korean: "호수처럼 부드럽게 흘러 관절을 조작하는 기법";
+                readonly english: "Techniques that flow like water to manipulate joints";
+            };
+        };
+        readonly "3": {
+            readonly stance: TrigramStance;
+            readonly korean: "리";
+            readonly english: "Fire";
+            readonly symbol: "☲";
+            readonly technique: {
+                readonly korean: "화염지창";
+                readonly english: "Fire Spear";
+            };
+            readonly combatFocus: {
+                readonly korean: "정밀신경타격";
+                readonly english: "Precise nerve strikes";
+            };
+            readonly combatEffects: {
+                readonly korean: "일시마비, 감각상실";
+                readonly english: "Temporary paralysis, numbness";
+            };
+            readonly description: {
+                readonly korean: "불꽃같은 정확성으로 신경계를 공격하는 치명적 기법";
+                readonly english: "Deadly techniques targeting the nervous system with fire-like precision";
+            };
+        };
+        readonly "4": {
+            readonly stance: TrigramStance;
+            readonly korean: "진";
+            readonly english: "Thunder";
+            readonly symbol: "☳";
+            readonly technique: {
+                readonly korean: "벽력일섬";
+                readonly english: "Lightning Strike";
+            };
+            readonly combatFocus: {
+                readonly korean: "기절기법";
+                readonly english: "Stunning techniques";
+            };
+            readonly combatEffects: {
+                readonly korean: "방향감각상실, 의식잃음";
+                readonly english: "Disorientation, knockouts";
+            };
+            readonly description: {
+                readonly korean: "번개처럼 빠른 충격으로 적의 의식을 차단";
+                readonly english: "Lightning-fast shocks that disrupt enemy consciousness";
+            };
+        };
+        readonly "5": {
+            readonly stance: TrigramStance;
+            readonly korean: "손";
+            readonly english: "Wind";
+            readonly symbol: "☴";
+            readonly technique: {
+                readonly korean: "선풍연격";
+                readonly english: "Whirlwind Combo";
+            };
+            readonly combatFocus: {
+                readonly korean: "지속압박";
+                readonly english: "Continuous pressure";
+            };
+            readonly combatEffects: {
+                readonly korean: "점진적 무력화";
+                readonly english: "Gradual incapacitation";
+            };
+            readonly description: {
+                readonly korean: "바람처럼 끊임없는 연타로 적을 서서히 무력화";
+                readonly english: "Relentless wind-like strikes that gradually overwhelm the enemy";
+            };
+        };
+        readonly "6": {
+            readonly stance: TrigramStance;
+            readonly korean: "감";
+            readonly english: "Water";
+            readonly symbol: "☵";
+            readonly technique: {
+                readonly korean: "수류반격";
+                readonly english: "Water Counter";
+            };
+            readonly combatFocus: {
+                readonly korean: "혈류차단";
+                readonly english: "Blood flow restriction";
+            };
+            readonly combatEffects: {
+                readonly korean: "순환장애";
+                readonly english: "Circulation disruption";
+            };
+            readonly description: {
+                readonly korean: "물의 흐름을 끊듯 혈액순환을 차단하는 위험한 기법";
+                readonly english: "Dangerous techniques that disrupt blood circulation like stopping water flow";
+            };
+        };
+        readonly "7": {
+            readonly stance: TrigramStance;
+            readonly korean: "간";
+            readonly english: "Mountain";
+            readonly symbol: "☶";
+            readonly technique: {
+                readonly korean: "반석방어";
+                readonly english: "Mountain Defense";
+            };
+            readonly combatFocus: {
+                readonly korean: "방어반격";
+                readonly english: "Defensive counters";
+            };
+            readonly combatEffects: {
+                readonly korean: "반격, 차단";
+                readonly english: "Counter-attacks, blocks";
+            };
+            readonly description: {
+                readonly korean: "산처럼 견고한 방어에서 나오는 강력한 반격";
+                readonly english: "Powerful counters emerging from mountain-solid defense";
+            };
+        };
+        readonly "8": {
+            readonly stance: TrigramStance;
+            readonly korean: "곤";
+            readonly english: "Earth";
+            readonly symbol: "☷";
+            readonly technique: {
+                readonly korean: "대지포옹";
+                readonly english: "Earth's Embrace";
+            };
+            readonly combatFocus: {
+                readonly korean: "지면기법";
+                readonly english: "Ground techniques";
+            };
+            readonly combatEffects: {
+                readonly korean: "투척, 넘어뜨리기";
+                readonly english: "Throws, takedowns";
+            };
+            readonly description: {
+                readonly korean: "대지의 힘으로 적을 땅에 내동댕이치는 투척술";
+                readonly english: "Throwing techniques that slam enemies to the ground with earth's power";
+            };
+        };
+    };
+    readonly movement: {
+        readonly WASD: {
+            readonly korean: "전술적 이동과 발놀림";
+            readonly english: "Tactical positioning and footwork";
+        };
+        readonly ArrowKeys: {
+            readonly korean: "대체 이동 시스템";
+            readonly english: "Alternative movement system";
+        };
+    };
+    readonly combat: {
+        readonly SPACE: {
+            readonly korean: "현재 자세의 기법 실행";
+            readonly english: "Execute current stance technique";
+        };
+        readonly SHIFT: {
+            readonly korean: "방어 자세/차단 위치";
+            readonly english: "Defensive guard/block position";
+        };
+        readonly CTRL: {
+            readonly korean: "정밀 급소 타격 모드";
+            readonly english: "Precision vital point targeting mode";
+        };
+        readonly TAB: {
+            readonly korean: "무술 원형 순환";
+            readonly english: "Cycle through martial archetypes";
+        };
+    };
+    readonly system: {
+        readonly ESC: {
+            readonly korean: "일시정지 메뉴 / 인트로로 돌아가기";
+            readonly english: "Pause menu / Return to intro";
+        };
+        readonly F1: {
+            readonly korean: "도움말 / 조작법 가이드";
+            readonly english: "Help / Controls guide";
+        };
+        readonly M: {
+            readonly korean: "음소거 / 오디오 설정";
+            readonly english: "Mute / Audio settings";
+        };
+    };
+};
+export declare const DAMAGE_TYPES: {
+    readonly PHYSICAL: "physical";
+    readonly ENERGY: "energy";
+    readonly VITAL_POINT: "vital_point";
+    readonly PSYCHOLOGICAL: "psychological";
+};
+export declare const COMBAT_PHASES: {
+    readonly PREPARATION: "preparation";
+    readonly ENGAGEMENT: "engagement";
+    readonly EXECUTION: "execution";
+    readonly RECOVERY: "recovery";
+    readonly RESOLUTION: "resolution";
+};
+export declare const COMBAT_AUDIO_MAP: Record<string, SoundEffectId>;
+export declare const COMBAT_STATE_MACHINE: {
+    readonly idle: {
+        readonly canTransitionTo: readonly ["attacking", "defending", "moving", "stunned"];
+        readonly duration: number;
+    };
+    readonly attacking: {
+        readonly canTransitionTo: readonly ["idle", "recovering", "stunned"];
+        readonly duration: 500;
+    };
+    readonly defending: {
+        readonly canTransitionTo: readonly ["idle", "attacking", "stunned"];
+        readonly duration: 300;
+    };
+    readonly moving: {
+        readonly canTransitionTo: readonly ["idle", "attacking", "defending"];
+        readonly duration: 200;
+    };
+    readonly stunned: {
+        readonly canTransitionTo: readonly ["idle"];
+        readonly duration: 1000;
+    };
+    readonly recovering: {
+        readonly canTransitionTo: readonly ["idle"];
+        readonly duration: 400;
+    };
+    readonly unconscious: {
+        readonly canTransitionTo: readonly ["idle"];
+        readonly duration: 5000;
+    };
+};
+export declare const TRAINING_COMBAT_SETTINGS: {
+    readonly techniqueCooldown: 500;
+    readonly perfectStrikeThreshold: 0.7;
+    readonly maxTrainingSession: 300000;
+    readonly kiRegenerationRate: 2;
+    readonly staminaRegenerationRate: 1.5;
+};
+export declare const TRAINING_STATE_MACHINE: {
+    readonly practicing: {
+        readonly canTransitionTo: readonly ["idle", "executing", "recovering"];
+        readonly duration: number;
+    };
+    readonly executing: {
+        readonly canTransitionTo: readonly ["practicing", "idle"];
+        readonly duration: 800;
+    };
+    readonly recovering: {
+        readonly canTransitionTo: readonly ["practicing", "idle"];
+        readonly duration: 300;
+    };
+};
+export declare const TECHNIQUE_RESULTS: {
+    readonly SUCCESS: "success";
+    readonly BLOCKED: "blocked";
+    readonly MISSED: "missed";
+    readonly COUNTERED: "countered";
+    readonly INTERRUPTED: "interrupted";
+};
+export declare const EFFECTIVENESS_MODIFIERS: {
+    readonly stance_advantage: 1.2;
+    readonly stance_disadvantage: 0.8;
+    readonly counter_attack: 1.5;
+    readonly perfect_timing: 1.3;
+    readonly off_balance: 0.7;
+    readonly fatigued: 0.6;
+    readonly focused: 1.1;
+};
+export declare const RESOURCE_COSTS: {
+    readonly KI: {
+        readonly BASIC_TECHNIQUE: 5;
+        readonly ADVANCED_TECHNIQUE: 10;
+        readonly SPECIAL_TECHNIQUE: 15;
+        readonly ULTIMATE_TECHNIQUE: 25;
+    };
+    readonly STAMINA: {
+        readonly BASIC_ATTACK: 8;
+        readonly HEAVY_ATTACK: 15;
+        readonly BLOCK: 5;
+        readonly DODGE: 10;
+        readonly STANCE_CHANGE: 12;
+    };
+};
+export declare const HIT_DETECTION: {
+    readonly PRECISION_THRESHOLD: 0.8;
+    readonly VITAL_POINT_THRESHOLD: 0.9;
+    readonly BASE_ACCURACY: 0.7;
+    readonly MAX_ACCURACY: 0.95;
+    readonly PLAYER_HITBOX_WIDTH: 60;
+    readonly PLAYER_HITBOX_HEIGHT: 180;
+    readonly VITAL_POINT_RADIUS: 15;
+};
+export declare const STATUS_DURATIONS: {
+    readonly STUN: 1500;
+    readonly POISON: 5000;
+    readonly BURN: 3000;
+    readonly BLEED: 4000;
+    readonly WEAKNESS: 6000;
+    readonly STRENGTH_BUFF: 8000;
+};
+export interface CombatControlsConfig {
+    readonly stanceControls: Record<string, {
+        stance: string;
+        korean: string;
+        technique: string;
+    }>;
+    readonly movement: Record<string, string>;
+    readonly combat: Record<string, string>;
+    readonly system: Record<string, string>;
+}
+export declare const KEYBOARD_MAPPING: {
+    readonly STANCE_1: "1";
+    readonly STANCE_2: "2";
+    readonly STANCE_3: "3";
+    readonly STANCE_4: "4";
+    readonly STANCE_5: "5";
+    readonly STANCE_6: "6";
+    readonly STANCE_7: "7";
+    readonly STANCE_8: "8";
+    readonly EXECUTE_TECHNIQUE: " ";
+    readonly BLOCK: "Shift";
+    readonly TARGET_MODE: "Control";
+    readonly ARCHETYPE_CYCLE: "Tab";
+    readonly MOVE_UP: "w";
+    readonly MOVE_DOWN: "s";
+    readonly MOVE_LEFT: "a";
+    readonly MOVE_RIGHT: "d";
+    readonly PAUSE: "Escape";
+    readonly HELP: "F1";
+    readonly MUTE: "m";
+};
+/**
+ * Get the stance associated with a given key.
+ *
+ * @param key - The key to lookup.
+ * @returns The corresponding stance, or null if not found.
+ */
+export declare function getStanceFromKey(key: string): TrigramStance | null;
+export interface CombatControlsConfig {
+    readonly stanceControls: Record<string, {
+        stance: string;
+        korean: string;
+        technique: string;
+    }>;
+    readonly movement: Record<string, string>;
+    readonly combat: Record<string, string>;
+    readonly system: Record<string, string>;
+}
+export interface InputEvent {
+    readonly type: "keydown" | "keyup" | "pointerdown" | "pointerup";
+    readonly key?: string;
+    readonly position?: {
+        x: number;
+        y: number;
+    };
+    readonly timestamp: number;
+}
+export interface CombatInput {
+    readonly player: number;
+    readonly action: string;
+    readonly data?: any;
+}
+export interface Gesture {
+    readonly type: "tap" | "hold" | "swipe" | "combo";
+    readonly duration?: number;
+    readonly direction?: "up" | "down" | "left" | "right";
+    readonly sequence?: string[];
+}
+export declare const DEFAULT_GAME_SPEED = 1;
+/**
+ * Core game configuration constants for Black Trigram
+ */
+export declare const GAME_CONFIG: {
+    readonly CANVAS_WIDTH: 1200;
+    readonly CANVAS_HEIGHT: 800;
+    readonly TARGET_FPS: 60;
+    readonly MIN_FPS: 30;
+    readonly ROUND_DURATION: 180;
+    readonly MAX_ROUNDS: 3;
+    readonly KO_THRESHOLD: 0;
+    readonly BASE_HEALTH: 100;
+    readonly BASE_KI: 100;
+    readonly BASE_STAMINA: 100;
+    readonly PLAYER_START_POS_X_1: 300;
+    readonly PLAYER_START_POS_X_2: 900;
+    readonly PLAYER_START_POS_Y: 400;
+    readonly GRAVITY: 9.8;
+    readonly FRICTION: 0.85;
+    readonly UI_PADDING: 20;
+    readonly BUTTON_HEIGHT: 50;
+    readonly MASTER_VOLUME: 1;
+    readonly MUSIC_VOLUME: 0.7;
+    readonly SFX_VOLUME: 0.8;
+    readonly DEBUG_MODE: false;
+    readonly SHOW_HITBOXES: false;
+    readonly SHOW_VITAL_POINTS: false;
+};
+export declare const PLAYER_COLORS: {
+    readonly PLAYER_1_COLOR: 39423;
+    readonly PLAYER_2_COLOR: 16750848;
+};
+export declare const DIFFICULTY_SETTINGS: {
+    readonly BEGINNER: {
+        readonly AI_REACTION_TIME: 800;
+        readonly DAMAGE_MULTIPLIER: 0.7;
+        readonly TECHNIQUE_SUCCESS_RATE: 0.6;
+    };
+    readonly INTERMEDIATE: {
+        readonly AI_REACTION_TIME: 600;
+        readonly DAMAGE_MULTIPLIER: 1;
+        readonly TECHNIQUE_SUCCESS_RATE: 0.8;
+    };
+    readonly EXPERT: {
+        readonly AI_REACTION_TIME: 400;
+        readonly DAMAGE_MULTIPLIER: 1.3;
+        readonly TECHNIQUE_SUCCESS_RATE: 0.9;
+    };
+    readonly MASTER: {
+        readonly AI_REACTION_TIME: 200;
+        readonly DAMAGE_MULTIPLIER: 1.5;
+        readonly TECHNIQUE_SUCCESS_RATE: 0.95;
+    };
+};
+export declare const GAME_PHASES: {
+    readonly INTRO: "intro";
+    readonly TRAINING: "training";
+    readonly COMBAT: "combat";
+    readonly VICTORY: "victory";
+    readonly DEFEAT: "defeat";
+};
+export declare const GAME_METADATA: {
+    readonly VERSION: "1.0.0";
+    readonly BUILD: "2024.1";
+    readonly TITLE: "흑괘 (Black Trigram)";
+    readonly SUBTITLE: "Korean Martial Arts Combat Simulator";
+    readonly DEVELOPER: "Black Trigram Team";
+    readonly COPYRIGHT: "© 2024 Black Trigram";
+};
+export declare const PERFORMANCE_THRESHOLDS: {
+    readonly TARGET_FPS: 60;
+    readonly MIN_FPS: 30;
+    readonly FRAME_TIME_WARNING: 20;
+    readonly MEMORY_WARNING: 100;
+    readonly GARBAGE_COLLECTION_THRESHOLD: 50;
+};
+export declare const COMBAT_TIMING: {
+    readonly ATTACK_WINDOW: 500;
+    readonly DEFENSE_WINDOW: 300;
+    readonly RECOVERY_TIME: 200;
+    readonly COUNTER_WINDOW: 150;
+};
+export declare const DAMAGE_CONSTANTS: {
+    readonly BASE_DAMAGE: 10;
+    readonly CRITICAL_MULTIPLIER: 2;
+    readonly VITAL_POINT_MULTIPLIER: 1.5;
+    readonly ARMOR_REDUCTION: 0.1;
+    readonly STANCE_DEFENSE_BONUS: 0.2;
+    readonly BALANCE_IMPACT_MULTIPLIER: 0.3;
+    readonly CONSCIOUSNESS_THRESHOLD: 30;
+    readonly PAIN_THRESHOLD: 80;
+    readonly BASE_CRIT_CHANCE: 0.1;
+    readonly TECHNIQUE_ACCURACY_MODIFIER: 1;
+    readonly STANCE_EFFECTIVENESS_RANGE: {
+        readonly MIN: 0.5;
+        readonly MAX: 1.5;
+    };
+    readonly PERFECT_TIMING_BONUS: 0.3;
+};
+export declare const ANIMATION_TIMINGS: {
+    readonly STANCE_TRANSITION: 300;
+    readonly TECHNIQUE_STARTUP: 150;
+    readonly TECHNIQUE_ACTIVE: 100;
+    readonly TECHNIQUE_RECOVERY: 250;
+    readonly HIT_STUN: 200;
+    readonly BLOCK_STUN: 100;
+    readonly KNOCKDOWN_RECOVERY: 1000;
+};
+export declare const UI_LAYOUT: {
+    readonly HUD_HEIGHT: 80;
+    readonly CONTROLS_HEIGHT: 120;
+    readonly SIDEBAR_WIDTH: 200;
+    readonly MARGIN: 20;
+    readonly BUTTON_HEIGHT: 50;
+    readonly BUTTON_WIDTH: 150;
+};
+export declare const AUDIO_DEFAULTS: {
+    readonly MASTER_VOLUME: 0.7;
+    readonly SFX_VOLUME: 0.8;
+    readonly MUSIC_VOLUME: 0.5;
+    readonly AMBIENT_VOLUME: 0.3;
+};
+export declare const HALF_CANVAS_WIDTH: number;
+export declare const HALF_CANVAS_HEIGHT: number;
+export declare const CANVAS_ASPECT_RATIO: number;
+export declare const FRAME_TIME: number;
+export declare const TICK_RATE: 60;
+export declare const PLAYER_DISTANCE: number;
+export declare const CENTER_POSITION_X: number;
+export declare const COMBAT_RANGES: {
+    readonly MELEE_RANGE: 80;
+    readonly CLOSE_RANGE: 120;
+    readonly MEDIUM_RANGE: 200;
+    readonly LONG_RANGE: 300;
+    readonly MAX_RANGE: number;
+};
+export declare const GAME_STATES: {
+    readonly LOADING: "loading";
+    readonly MENU: "menu";
+    readonly CHARACTER_SELECT: "character_select";
+    readonly TRAINING: "training";
+    readonly COMBAT: "combat";
+    readonly PAUSED: "paused";
+    readonly GAME_OVER: "game_over";
+};
+export declare const INPUT_CONSTANTS: {
+    readonly DOUBLE_TAP_TIME: 300;
+    readonly HOLD_THRESHOLD: 500;
+    readonly GESTURE_TIMEOUT: 1000;
+    readonly COMBO_TIMEOUT: 2000;
+};
+export declare const VISUAL_EFFECTS: {
+    readonly HIT_FLASH_DURATION: 100;
+    readonly SCREEN_SHAKE_INTENSITY: 5;
+    readonly PARTICLE_LIFETIME: 1000;
+    readonly GLOW_PULSE_SPEED: 2;
+    readonly STANCE_GLOW_OPACITY: 0.3;
+};
+export declare const TRAINING_CONFIG: {
+    readonly DUMMY_HEALTH: 1000;
+    readonly AUTO_RESET_TIME: 5000;
+    readonly SHOW_FRAME_DATA: true;
+    readonly SHOW_HITBOXES: true;
+    readonly INFINITE_KI: true;
+    readonly INFINITE_STAMINA: true;
+};
+export declare const GAME_MODE_CONFIG: {
+    readonly VERSUS: {
+        readonly allowPause: true;
+        readonly timeLimit: 180;
+        readonly rounds: 3;
+        readonly enableAI: false;
+    };
+    readonly TRAINING: {
+        readonly allowPause: true;
+        readonly timeLimit: null;
+        readonly rounds: 1;
+        readonly enableAI: true;
+        readonly infiniteResources: true;
+    };
+    readonly PRACTICE: {
+        readonly allowPause: true;
+        readonly timeLimit: null;
+        readonly rounds: 1;
+        readonly enableAI: false;
+        readonly infiniteResources: true;
+    };
+};
+export declare const PERFORMANCE_CONFIG: {
+    readonly MAX_PARTICLES: 100;
+    readonly MAX_SOUND_SOURCES: 16;
+    readonly TEXTURE_QUALITY: "high";
+    readonly ENABLE_SHADOWS: true;
+    readonly ENABLE_POST_PROCESSING: true;
+};
+export declare const MARTIAL_ARTS_CONFIG: {
+    readonly VITAL_POINTS_COUNT: 70;
+    readonly TRIGRAM_STANCES_COUNT: 8;
+    readonly PLAYER_ARCHETYPES_COUNT: 5;
+    readonly ATTACK_WINDOW: 500;
+    readonly COUNTER_WINDOW: 300;
+    readonly BLOCK_WINDOW: 200;
+    readonly MIN_STANCE_CHANGE_INTERVAL: 500;
+    readonly STANCE_CHANGE_COST_BASE: 10;
+    readonly BASE_DAMAGE_MULTIPLIER: 1;
+    readonly CRITICAL_HIT_MULTIPLIER: 1.5;
+    readonly VITAL_POINT_MULTIPLIER: 2.5;
+};
+export default GAME_CONFIG;
+//# sourceMappingURL=types.d.ts.map