blacktrigram 0.7.2

package/lib/systems/trigram/techniques/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/systems/trigram/techniques/index.ts"],"sourcesContent":["/**\n * Techniques Module Index\n * 한국 무술 기법 모듈\n *\n * This module provides modular access to all Korean martial arts techniques\n * organized by trigram stance, plus Dark Ops techniques and configuration.\n *\n * Structure:\n * - Individual stance files (Geon, Tae, Li, Jin, Son, Gam, Gan, Gon)\n * - Dark Ops techniques for 암살자 archetype\n * - Configuration and constants\n *\n * @module techniques\n */\n\nimport { TrigramStance } from \"../../../types/common\";\nimport type { KoreanTechnique } from \"../../vitalpoint/types\";\n\n// =====================================================\n// STANCE TECHNIQUE IMPORTS\n// =====================================================\n\n// Basic stance techniques (array only)\nexport { GEON_TECHNIQUES } from \"./GeonTechniques\";\nexport { JIN_TECHNIQUES } from \"./JinTechniques\";\nexport { LI_TECHNIQUES } from \"./LiTechniques\";\nexport { TAE_TECHNIQUES } from \"./TaeTechniques\";\n\n// Extended stance techniques (with helper functions)\nexport {\n  GAM_TECHNIQUE_COUNT,\n  GAM_TECHNIQUES,\n  getGamTechniqueById,\n  getGamTechniquesByType,\n} from \"./GamTechniques\";\nexport {\n  GAN_TECHNIQUE_COUNT,\n  GAN_TECHNIQUES,\n  getGanTechniqueById,\n  getGanTechniquesByType,\n} from \"./GanTechniques\";\nexport {\n  getGonTechniqueById,\n  getGonTechniquesByType,\n  GON_TECHNIQUE_COUNT,\n  GON_TECHNIQUES,\n} from \"./GonTechniques\";\nexport {\n  getSonTechniqueById,\n  getSonTechniquesByType,\n  SON_TECHNIQUE_COUNT,\n  SON_TECHNIQUES,\n} from \"./SonTechniques\";\n\n// Import for composition\nimport { GAM_TECHNIQUES } from \"./GamTechniques\";\nimport { GAN_TECHNIQUES } from \"./GanTechniques\";\nimport { GEON_TECHNIQUES } from \"./GeonTechniques\";\nimport { GON_TECHNIQUES } from \"./GonTechniques\";\nimport { JIN_TECHNIQUES } from \"./JinTechniques\";\nimport { LI_TECHNIQUES } from \"./LiTechniques\";\nimport { SON_TECHNIQUES } from \"./SonTechniques\";\nimport { TAE_TECHNIQUES } from \"./TaeTechniques\";\n\n// =====================================================\n// DARK OPS TECHNIQUE IMPORTS\n// =====================================================\n\nexport {\n  DARK_OPS_ARCHETYPE_BONUSES,\n  DARK_OPS_NIGHT_BONUS,\n  DARK_OPS_SPECIAL_EFFECTS,\n  DARK_OPS_TECHNIQUE_COUNT,\n  DARK_OPS_TECHNIQUES,\n  DARK_OPS_UNITS,\n  getDarkOpsArchetypeBonus,\n  getDarkOpsTechniqueById,\n  getDarkOpsTechniquesByUnit,\n} from \"./DarkOpsTechniques\";\n\n// =====================================================\n// CONFIGURATION IMPORTS\n// =====================================================\n\nexport {\n  ARCHETYPE_TECHNIQUE_BONUSES,\n  calculateDamageEffectiveness,\n  DAMAGE_TYPE_EFFECTIVENESS,\n  getTrigramKey,\n  getTrigramProperties,\n  KOREAN_TECHNIQUE_CATEGORIES,\n  TECHNIQUE_DIFFICULTY_LEVELS,\n  TECHNIQUE_MODIFIERS,\n  TECHNIQUE_NAMING,\n  TECHNIQUE_PROPERTIES,\n  TRIGRAM_TECHNIQUE_PROPERTIES,\n} from \"./TechniqueConfig\";\n\n// =====================================================\n// COMPOSED TRIGRAM TECHNIQUES\n// =====================================================\n\n/**\n * Complete TRIGRAM_TECHNIQUES map organized by stance\n * This is the primary technique lookup used throughout the game\n *\n * 팔괘 기술 전체 맵 (스탠스별 구성)\n */\nexport const TRIGRAM_TECHNIQUES: Record<\n  TrigramStance,\n  readonly KoreanTechnique[]\n> = {\n  [TrigramStance.GEON]: GEON_TECHNIQUES,\n  [TrigramStance.TAE]: TAE_TECHNIQUES,\n  [TrigramStance.LI]: LI_TECHNIQUES,\n  [TrigramStance.JIN]: JIN_TECHNIQUES,\n  [TrigramStance.SON]: SON_TECHNIQUES,\n  [TrigramStance.GAM]: GAM_TECHNIQUES,\n  [TrigramStance.GAN]: GAN_TECHNIQUES,\n  [TrigramStance.GON]: GON_TECHNIQUES,\n} as const;\n\n// =====================================================\n// HELPER FUNCTIONS\n// =====================================================\n\n/**\n * Get all techniques for a specific stance\n */\nexport function getTechniquesByStance(\n  stance: TrigramStance\n): readonly KoreanTechnique[] {\n  return TRIGRAM_TECHNIQUES[stance] ?? [];\n}\n\n/**\n * Get a technique by ID from any stance\n */\nexport function getTechniqueById(id: string): KoreanTechnique | undefined {\n  for (const techniques of Object.values(TRIGRAM_TECHNIQUES)) {\n    const technique = techniques.find((t) => t.id === id);\n    if (technique) return technique;\n  }\n  return undefined;\n}\n\n/**\n * Get all techniques across all stances\n */\nexport function getAllTechniques(): readonly KoreanTechnique[] {\n  return Object.values(TRIGRAM_TECHNIQUES).flat();\n}\n\n/**\n * Get total technique count\n */\nexport function getTotalTechniqueCount(): number {\n  return Object.values(TRIGRAM_TECHNIQUES).reduce(\n    (sum, techniques) => sum + techniques.length,\n    0\n  );\n}\n\n/**\n * Get technique count by stance\n */\nexport function getTechniqueCountByStance(): Record<TrigramStance, number> {\n  return {\n    [TrigramStance.GEON]: GEON_TECHNIQUES.length,\n    [TrigramStance.TAE]: TAE_TECHNIQUES.length,\n    [TrigramStance.LI]: LI_TECHNIQUES.length,\n    [TrigramStance.JIN]: JIN_TECHNIQUES.length,\n    [TrigramStance.SON]: SON_TECHNIQUES.length,\n    [TrigramStance.GAM]: GAM_TECHNIQUES.length,\n    [TrigramStance.GAN]: GAN_TECHNIQUES.length,\n    [TrigramStance.GON]: GON_TECHNIQUES.length,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4GA,IAAa,qBAGT;EACD,cAAc,OAAO;EACrB,cAAc,MAAM;EACpB,cAAc,KAAK;EACnB,cAAc,MAAM;EACpB,cAAc,MAAM;EACpB,cAAc,MAAM;EACpB,cAAc,MAAM;EACpB,cAAc,MAAM;CACtB;;;;AASD,SAAgB,sBACd,QAC4B;AAC5B,QAAO,mBAAmB,WAAW,EAAE;;;;;AAMzC,SAAgB,iBAAiB,IAAyC;AACxE,MAAK,MAAM,cAAc,OAAO,OAAO,mBAAmB,EAAE;EAC1D,MAAM,YAAY,WAAW,MAAM,MAAM,EAAE,OAAO,GAAG;AACrD,MAAI,UAAW,QAAO;;;;;;AAQ1B,SAAgB,mBAA+C;AAC7D,QAAO,OAAO,OAAO,mBAAmB,CAAC,MAAM;;;;;AAMjD,SAAgB,yBAAiC;AAC/C,QAAO,OAAO,OAAO,mBAAmB,CAAC,QACtC,KAAK,eAAe,MAAM,WAAW,QACtC,EACD;;;;;AAMH,SAAgB,4BAA2D;AACzE,QAAO;GACJ,cAAc,OAAO,gBAAgB;GACrC,cAAc,MAAM,eAAe;GACnC,cAAc,KAAK,cAAc;GACjC,cAAc,MAAM,eAAe;GACnC,cAAc,MAAM,eAAe;GACnC,cAAc,MAAM,eAAe;GACnC,cAAc,MAAM,eAAe;GACnC,cAAc,MAAM,eAAe;EACrC"}

package/lib/systems/trigram/types/GonTechniqueExtensions.d.ts

@@ -0,0 +1,506 @@
+/**
+ * ☷ 곤 (GON) - Earth Stance Technique Extensions
+ * Gon-specific metadata for authentic Ssireum/Hapkido grappling mechanics
+ *
+ * Extends base TrigramStanceTechnique with Earth-specific properties:
+ * - Throw trajectory mechanics (던지기 궤적)
+ * - Ground impact multipliers (지면 충격 배수)
+ * - Grappling control duration (잡기 제어 시간)
+ * - Supportive healing (대지 치유)
+ * - Earth visual effects (대지 시각 효과)
+ *
+ * Based on authentic Korean martial arts:
+ * - Ssireum (씨름) - Traditional Korean wrestling
+ * - Hapkido (합기도) - Joint locks and throws
+ *
+ * @module GonTechniqueExtensions
+ * @korean 곤괘기술확장
+ */
+import type { TrigramStanceTechnique, KoreanTechnique } from "../../vitalpoint";
+/**
+ * Throw trajectory types for Gon techniques
+ * 던지기 궤적 유형
+ *
+ * Describes the physical path of the throw for animation and physics
+ *
+ * @korean 던지기궤적유형
+ */
+export type ThrowTrajectory = "arc_over_hip" | "horizontal_sweep" | "forward_drive" | "vertical_slam" | "circular_trip" | "sacrifice_arc" | "clinch_control" | "arc_downward" | "spiral" | "direct_slam";
+/**
+ * Takedown type classification
+ * 넘어뜨리기 분류
+ *
+ * @korean 넘어뜨리기분류
+ */
+export type TakedownType = "leg_reap" | "hip_throw" | "body_lock" | "sacrifice" | "slam" | "sweep";
+/**
+ * Sweep direction for leg techniques
+ * 쓸기 방향
+ *
+ * @korean 쓸기방향
+ */
+export type SweepDirection = "inward" | "outward" | "backwards" | "circular";
+/**
+ * Ending position after throw
+ * 던지기 후 위치
+ *
+ * @korean 던지기후위치
+ */
+export type EndingPosition = "standing_dominant" | "mount" | "side_control" | "back_control" | "ground_mutual";
+/**
+ * Breath loss severity
+ * 호흡 상실 심각도
+ *
+ * @korean 호흡상실심각도
+ */
+export type BreathLoss = "mild" | "moderate" | "severe";
+/**
+ * Lift height for throwing techniques
+ * 들어올리기 높이
+ *
+ * @korean 들어올리기높이
+ */
+export type LiftHeight = "none" | "low" | "medium" | "high";
+/**
+ * Rotational power level
+ * 회전력 수준
+ *
+ * @korean 회전력수준
+ */
+export type RotationalPower = "low" | "medium" | "high";
+/**
+ * Momentum transfer level
+ * 운동량 전달 수준
+ *
+ * @korean 운동량전달수준
+ */
+export type MomentumTransfer = "low" | "medium" | "high";
+/**
+ * Setup speed for technique execution
+ * 기술 준비 속도
+ *
+ * @korean 기술준비속도
+ */
+export type SetupSpeed = "slow" | "medium" | "fast";
+/**
+ * Penetration depth for stance/level change
+ * 침투 깊이
+ *
+ * @korean 침투깊이
+ */
+export type PenetrationDepth = "high" | "medium" | "low";
+/**
+ * Extended Gon technique with Earth-specific mechanics
+ * 대지 특화 기술 확장 인터페이스
+ *
+ * Adds authentic Ssireum/Hapkido grappling mechanics to base technique.
+ * All Gon stance techniques should implement this interface.
+ *
+ * **Korean Martial Arts Context**:
+ * - Ssireum (씨름): Traditional Korean wrestling with satba belt
+ * - Hapkido (합기도): Joint locks, throws, circular motion
+ *
+ * **Earth Philosophy** (대지 철학):
+ * "대지는 모든 것을 품고 키운다" - The earth embraces and nurtures all things
+ *
+ * @korean 확장곤괘기술
+ */
+export interface ExtendedGonTechnique extends TrigramStanceTechnique {
+    /**
+     * Physical trajectory path of the throw
+     * 던지기 궤적
+     *
+     * Determines animation path and physics simulation
+     *
+     * @example "arc_over_hip" for traditional Ssireum throw
+     * @korean 던지기궤적
+     */
+    throwTrajectory: ThrowTrajectory;
+    /**
+     * Ground impact damage multiplier (1.0-2.0 range)
+     * 지면 충격 배수
+     *
+     * Multiplies base damage when opponent hits ground.
+     * - 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)
+     *
+     * **Formula**: `Final Damage = Base Damage × groundImpactMultiplier × (1 + strength_modifier)`
+     *
+     * @example 2.0 for 대지강타 (Ground Pound) - maximum impact
+     * @korean 지면충격배수
+     */
+    groundImpactMultiplier: number;
+    /**
+     * Post-throw control duration in milliseconds
+     * 던지기 후 제어 시간
+     *
+     * Duration attacker maintains positional advantage after throw.
+     * Affects follow-up attack windows and defender recovery time.
+     *
+     * **Range**: 800ms (brief) to 2000ms (dominant)
+     *
+     * @example 1800 for 씨름던지기 (Ssireum Throw) - strong control
+     * @korean 제어시간
+     */
+    controlDuration: number;
+    /**
+     * Earth's supportive healing value (0-10 scale)
+     * 대지 치유 수치
+     *
+     * HP restored from earth connection during technique execution.
+     * Based on Korean philosophy: earth nurtures all things.
+     *
+     * **Typical Range**: 1-6 for combat techniques
+     * - 0-2: Minimal earth connection (aggressive)
+     * - 3-4: Moderate earth connection (standard Ssireum)
+     * - 5-6: Strong earth connection (traditional, sacrifice throws)
+     * - 7-10: RESERVED for meditation/healing techniques
+     *
+     * **Formula**: `HP Restored = supportiveHealing × (1 + earth_affinity_stat)`
+     *
+     * @example 5 for 씨름던지기 - traditional technique bonus
+     * @korean 대지치유
+     */
+    supportiveHealing: number;
+    /**
+     * Whether technique creates earth crack visual effect
+     * 대지 균열 효과 여부
+     *
+     * If true, ground impact creates visual feedback:
+     * - Earth crack patterns (Korean pottery-inspired)
+     * - Dust clouds (yellow-brown 황토색)
+     * - Shockwave ripples (for high impact)
+     *
+     * **Intensity scales with**: groundImpactMultiplier
+     *
+     * @example true for all throws/slams, false for clinch control
+     * @korean 대지균열효과
+     */
+    earthCrackEffect: boolean;
+    /**
+     * Requires traditional Ssireum satba belt grip
+     * 샅바 잡기 필요 여부
+     *
+     * If true, technique uses traditional Korean wrestling belt mechanics
+     *
+     * @optional
+     * @korean 샅바필요
+     */
+    satbaGripRequired?: boolean;
+    /**
+     * Cultural authenticity damage bonus
+     * 전통 무술 보너스
+     *
+     * Damage multiplier for traditional Korean techniques
+     * Rewards using authentic martial arts
+     *
+     * @example 1.15 (15% bonus) for 씨름던지기
+     * @optional
+     * @korean 전통보너스
+     */
+    traditionalBonus?: number;
+    /**
+     * Grip strength for escape difficulty (0-1 scale)
+     * 잡기 강도
+     *
+     * Higher values make technique harder to escape from
+     * 1.0 = unbreakable, 0.0 = no grip
+     *
+     * @optional
+     * @korean 잡기강도
+     */
+    gripStrength?: number;
+    /**
+     * Takedown classification
+     * 넘어뜨리기 유형
+     *
+     * @optional
+     * @korean 넘어뜨리기유형
+     */
+    takedownType?: TakedownType;
+    /**
+     * Sweep direction for leg techniques
+     * 쓸기 방향
+     *
+     * @optional
+     * @korean 쓸기방향
+     */
+    sweepDirection?: SweepDirection;
+    /**
+     * Self-risk factor (0-1 scale)
+     * 자기 위험도
+     *
+     * Chance of self-damage from technique (e.g., sacrifice throws)
+     * 0.2 = 20% chance of taking damage yourself
+     *
+     * @optional
+     * @korean 자기위험도
+     */
+    selfRisk?: number;
+    /**
+     * Counter vulnerability (0-1 scale)
+     * 반격 취약성
+     *
+     * How easily technique can be countered during execution
+     * Higher = more vulnerable to counter-attacks
+     *
+     * @optional
+     * @korean 반격취약성
+     */
+    counterVulnerability?: number;
+    /**
+     * Positional outcome after technique
+     * 기술 후 위치
+     *
+     * @optional
+     * @korean 기술후위치
+     */
+    endingPosition?: EndingPosition;
+    /**
+     * Follow-up technique damage bonus
+     * 연속 공격 보너스
+     *
+     * Damage multiplier for chained techniques
+     *
+     * @example 0.3 (30% bonus) for sacrifice throws
+     * @optional
+     * @korean 연속공격보너스
+     */
+    transitionBonus?: number;
+    /**
+     * Breath restriction level (0-1 scale)
+     * 호흡 제한 수준
+     *
+     * How much technique restricts opponent's breathing
+     * Used for body locks and compression techniques
+     *
+     * @optional
+     * @korean 호흡제한
+     */
+    breathRestriction?: number;
+    /**
+     * Stun chance probability (0-1 scale)
+     * 기절 확률
+     *
+     * Chance technique stuns opponent on impact
+     *
+     * @example 0.4 (40% chance) for 대지강타
+     * @optional
+     * @korean 기절확률
+     */
+    stunChance?: number;
+    /**
+     * Breath loss severity
+     * 호흡 상실 심각도
+     *
+     * How severely technique "knocks the wind out"
+     *
+     * @optional
+     * @korean 호흡상실
+     */
+    breathLoss?: BreathLoss;
+    /**
+     * Setup speed classification
+     * 준비 속도
+     *
+     * @optional
+     * @korean 준비속도
+     */
+    setupSpeed?: SetupSpeed;
+    /**
+     * Penetration depth level
+     * 침투 깊이
+     *
+     * @optional
+     * @korean 침투깊이
+     */
+    penetrationDepth?: PenetrationDepth;
+    /**
+     * Lift height before throw
+     * 들어올리기 높이
+     *
+     * @optional
+     * @korean 들어올리기높이
+     */
+    liftHeight?: LiftHeight;
+    /**
+     * Rotational power level
+     * 회전력 수준
+     *
+     * @optional
+     * @korean 회전력
+     */
+    rotationalPower?: RotationalPower;
+    /**
+     * Momentum transfer level
+     * 운동량 전달
+     *
+     * @optional
+     * @korean 운동량전달
+     */
+    momentumTransfer?: MomentumTransfer;
+}
+/**
+ * Earth crack visual effect intensity
+ * 대지 균열 시각 효과 강도
+ *
+ * @korean 대지균열강도
+ */
+export type EarthCrackIntensity = "none" | "small" | "medium" | "large" | "massive";
+/**
+ * Calculate earth crack visual intensity based on impact
+ * 충격도에 따른 대지 균열 강도 계산
+ *
+ * @param technique - Gon technique with impact multiplier
+ * @param playerStrength - Player's strength stat modifier
+ * @returns Visual effect intensity level
+ *
+ * @korean 대지균열강도계산
+ */
+export declare function calculateEarthCrackIntensity(technique: Pick<ExtendedGonTechnique, "earthCrackEffect" | "groundImpactMultiplier">, playerStrength: number): EarthCrackIntensity;
+/**
+ * Type guard to check if technique is extended Gon technique
+ * 확장 곤괘 기술 여부 확인
+ *
+ * Checks both field presence AND type correctness for core Gon fields.
+ * For value range validation (e.g., groundImpactMultiplier 1.0-2.0),
+ * use `validateGonTechniqueEnhancements()`.
+ *
+ * @param technique - Technique to check
+ * @returns True if technique has all required Gon-specific fields with correct types
+ *
+ * @see validateGonTechniqueEnhancements for runtime value range validation
+ * @korean 확장곤괘기술확인
+ */
+export declare function isExtendedGonTechnique(technique: TrigramStanceTechnique): technique is ExtendedGonTechnique;
+/**
+ * Safely cast a technique to ExtendedGonTechnique after validation.
+ * Helper function to reduce code duplication and improve type safety.
+ *
+ * @param technique - The technique to cast
+ * @returns The technique cast as ExtendedGonTechnique, or null if not valid
+ * @korean 곤기술안전변환
+ */
+export declare function asExtendedGonTechnique(technique: KoreanTechnique): ExtendedGonTechnique | null;
+/**
+ * Validate Gon technique enhancement values
+ * 곤괘 기술 강화 수치 검증
+ *
+ * Ensures all enhancement values are within valid ranges
+ *
+ * @param technique - Extended Gon technique to validate
+ * @returns Validation result with errors if any
+ *
+ * @korean 곤괘기술검증
+ */
+export declare function validateGonTechniqueEnhancements(technique: ExtendedGonTechnique): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Earth philosophy constants
+ * 대지 철학 상수
+ *
+ * @korean 대지철학상수
+ */
+export declare const EARTH_PHILOSOPHY: {
+    /**
+     * Korean philosophy: "The earth embraces and nurtures all things"
+     * 대지는 모든 것을 품고 키운다
+     */
+    readonly CORE_PRINCIPLE: {
+        readonly korean: "대지는 모든 것을 품고 키운다";
+        readonly romanized: "Daeji-neun modeun geoseul pumgo kiwinda";
+        readonly english: "The earth embraces and nurtures all things";
+    };
+    /**
+     * Grounding effect (접지 효과)
+     * Physical earth contact provides regeneration
+     */
+    readonly GROUNDING_EFFECT: {
+        readonly korean: "접지 효과";
+        readonly romanized: "Jeobji Hyogwa";
+        readonly english: "Grounding Effect";
+    };
+    /**
+     * Earth's embrace (대지의 포옹)
+     * Low stance connection provides stamina recovery
+     */
+    readonly EARTH_EMBRACE: {
+        readonly korean: "대지의 포옹";
+        readonly romanized: "Daeji-ui Po-ong";
+        readonly english: "Earth's Embrace";
+    };
+    /**
+     * Nurturing recovery (양육 회복)
+     * Post-throw earth contact provides healing
+     */
+    readonly NURTURING_RECOVERY: {
+        readonly korean: "양육 회복";
+        readonly romanized: "Yangnyuk Hoibok";
+        readonly english: "Nurturing Recovery";
+    };
+};
+/**
+ * Ssireum cultural context
+ * 씨름 문화 배경
+ *
+ * @korean 씨름문화
+ */
+export declare const SSIREUM_CONTEXT: {
+    /**
+     * UNESCO Intangible Cultural Heritage (2018)
+     */
+    readonly UNESCO_STATUS: {
+        readonly year: 2018;
+        readonly category: "Intangible Cultural Heritage of Humanity";
+    };
+    /**
+     * Traditional Ssireum equipment
+     */
+    readonly EQUIPMENT: {
+        /**
+         * Satba - fabric belt wrapped around waist and thigh
+         * 샅바 - 허리와 넓적다리에 감는 천 띠
+         */
+        readonly SATBA: {
+            readonly korean: "샅바";
+            readonly romanized: "Satba";
+            readonly english: "Traditional wrestling belt";
+            readonly description: "Fabric belt wrapped around waist and right thigh for grip techniques";
+        };
+        /**
+         * Morae-pan - sand circle arena
+         * 모래판 - 모래 경기장
+         */
+        readonly ARENA: {
+            readonly korean: "모래판";
+            readonly romanized: "Morae-pan";
+            readonly english: "Sand circle arena";
+            readonly diameter: "8.5m";
+        };
+    };
+    /**
+     * Key Ssireum principles
+     */
+    readonly PRINCIPLES: {
+        readonly POWER_TRANSMISSION: {
+            readonly korean: "힘의 전달";
+            readonly romanized: "Him-ui Jeontal";
+            readonly english: "Power transmission through hips";
+        };
+        readonly CENTER_CONTROL: {
+            readonly korean: "중심 잡기";
+            readonly romanized: "Jungsim Japgi";
+            readonly english: "Controlling opponent's center of gravity";
+        };
+        readonly EARTH_CONNECTION: {
+            readonly korean: "대지와의 연결";
+            readonly romanized: "Daeji-wa-ui Yeongyeol";
+            readonly english: "Connection with earth for power";
+        };
+    };
+};
+//# sourceMappingURL=GonTechniqueExtensions.d.ts.map

package/lib/systems/trigram/types/GonTechniqueExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GonTechniqueExtensions.d.ts","sourceRoot":"","sources":["../../../../src/systems/trigram/types/GonTechniqueExtensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,QAAQ,GACR,aAAa,CAAC;AAElB;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,WAAW,GACX,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AAEZ;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,UAAU,CAAC;AAEf;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,OAAO,GACP,cAAc,GACd,cAAc,GACd,eAAe,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAExD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAGlE;;;;;;;;OAQG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;;;;;;;;;;;;;OAcG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAE/B;;;;;;;;;;;OAWG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;;;;;OAaG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAI1B;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpF;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,IAAI,CAAC,oBAAoB,EAAE,kBAAkB,GAAG,wBAAwB,CAAC,EACpF,cAAc,EAAE,MAAM,GACrB,mBAAmB,CASrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,sBAAsB,GAChC,SAAS,IAAI,oBAAoB,CA4BnC;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,eAAe,GACzB,oBAAoB,GAAG,IAAI,CAO7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,oBAAoB,GAC9B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAoDtC;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;OAGG;;;;;;IAOH;;;OAGG;;;;;;IAOH;;;OAGG;;;;;;IAOH;;;OAGG;;;;;;CAMK,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;;;;;IAMH;;OAEG;;QAED;;;WAGG;;;;;;;QASH;;;WAGG;;;;;;;;IASL;;OAEG;;;;;;;;;;;;;;;;;;CAkBK,CAAC"}

package/lib/systems/trigram/types/GonTechniqueExtensions.js

@@ -0,0 +1,37 @@
+//#region src/systems/trigram/types/GonTechniqueExtensions.ts
+/**
+* Type guard to check if technique is extended Gon technique
+* 확장 곤괘 기술 여부 확인
+*
+* Checks both field presence AND type correctness for core Gon fields.
+* For value range validation (e.g., groundImpactMultiplier 1.0-2.0),
+* use `validateGonTechniqueEnhancements()`.
+*
+* @param technique - Technique to check
+* @returns True if technique has all required Gon-specific fields with correct types
+*
+* @see validateGonTechniqueEnhancements for runtime value range validation
+* @korean 확장곤괘기술확인
+*/
+function isExtendedGonTechnique(technique) {
+	if (!("throwTrajectory" in technique && "groundImpactMultiplier" in technique && "controlDuration" in technique && "supportiveHealing" in technique && "earthCrackEffect" in technique)) return false;
+	const candidate = technique;
+	return typeof candidate.throwTrajectory === "string" && typeof candidate.groundImpactMultiplier === "number" && typeof candidate.controlDuration === "number" && typeof candidate.supportiveHealing === "number" && typeof candidate.earthCrackEffect === "boolean";
+}
+/**
+* Safely cast a technique to ExtendedGonTechnique after validation.
+* Helper function to reduce code duplication and improve type safety.
+* 
+* @param technique - The technique to cast
+* @returns The technique cast as ExtendedGonTechnique, or null if not valid
+* @korean 곤기술안전변환
+*/
+function asExtendedGonTechnique(technique) {
+	const trigramTechnique = technique;
+	if (!isExtendedGonTechnique(trigramTechnique)) return null;
+	return trigramTechnique;
+}
+//#endregion
+export { asExtendedGonTechnique };
+
+//# sourceMappingURL=GonTechniqueExtensions.js.map

package/lib/systems/trigram/types/GonTechniqueExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GonTechniqueExtensions.js","names":[],"sources":["../../../../src/systems/trigram/types/GonTechniqueExtensions.ts"],"sourcesContent":["/**\n * ☷ 곤 (GON) - Earth Stance Technique Extensions\n * Gon-specific metadata for authentic Ssireum/Hapkido grappling mechanics\n *\n * Extends base TrigramStanceTechnique with Earth-specific properties:\n * - Throw trajectory mechanics (던지기 궤적)\n * - Ground impact multipliers (지면 충격 배수)\n * - Grappling control duration (잡기 제어 시간)\n * - Supportive healing (대지 치유)\n * - Earth visual effects (대지 시각 효과)\n *\n * Based on authentic Korean martial arts:\n * - Ssireum (씨름) - Traditional Korean wrestling\n * - Hapkido (합기도) - Joint locks and throws\n *\n * @module GonTechniqueExtensions\n * @korean 곤괘기술확장\n */\n\nimport type { TrigramStanceTechnique, KoreanTechnique } from \"@/systems/vitalpoint\";\n\n/**\n * Throw trajectory types for Gon techniques\n * 던지기 궤적 유형\n *\n * Describes the physical path of the throw for animation and physics\n *\n * @korean 던지기궤적유형\n */\nexport type ThrowTrajectory =\n  | \"arc_over_hip\" // 엉덩이 넘기기 - Over the hip rotation (classic Ssireum)\n  | \"horizontal_sweep\" // 수평 쓸기 - Horizontal sweeping motion\n  | \"forward_drive\" // 앞 밀어붙이기 - Forward driving takedown\n  | \"vertical_slam\" // 수직 강타 - Straight down slam\n  | \"circular_trip\" // 원형 걸기 - Circular tripping motion\n  | \"sacrifice_arc\" // 희생 던지기 궤적 - Sacrifice throw trajectory\n  | \"clinch_control\" // 잡기 제어 - Clinch/grip control (no throw)\n  | \"arc_downward\" // 호 아래로 - Downward arcing throw\n  | \"spiral\" // 나선형 - Spiral/twisting throw\n  | \"direct_slam\"; // 직접 내리찍기 - Direct impact slam\n\n/**\n * Takedown type classification\n * 넘어뜨리기 분류\n *\n * @korean 넘어뜨리기분류\n */\nexport type TakedownType =\n  | \"leg_reap\" // 다리걸기 - Leg reaping technique\n  | \"hip_throw\" // 엉덩이던지기 - Hip throw technique\n  | \"body_lock\" // 몸통잡기 - Body lock takedown\n  | \"sacrifice\" // 희생던지기 - Sacrifice throw\n  | \"slam\" // 내리찍기 - Slam/driving technique\n  | \"sweep\"; // 쓸기 - Sweeping technique\n\n/**\n * Sweep direction for leg techniques\n * 쓸기 방향\n *\n * @korean 쓸기방향\n */\nexport type SweepDirection =\n  | \"inward\" // 안쪽 - Inner reap (안다리걸기)\n  | \"outward\" // 바깥쪽 - Outer reap (바깥다리걸기)\n  | \"backwards\" // 뒤쪽 - Backwards sweep\n  | \"circular\"; // 원형 - Circular sweep\n\n/**\n * Ending position after throw\n * 던지기 후 위치\n *\n * @korean 던지기후위치\n */\nexport type EndingPosition =\n  | \"standing_dominant\" // 서있기 우세 - Opponent down, attacker standing\n  | \"mount\" // 기마 자세 - Top mount position\n  | \"side_control\" // 옆 제어 - Side control position\n  | \"back_control\" // 뒤 제어 - Back control position\n  | \"ground_mutual\"; // 둘 다 지면 - Both fighters on ground\n\n/**\n * Breath loss severity\n * 호흡 상실 심각도\n *\n * @korean 호흡상실심각도\n */\nexport type BreathLoss = \"mild\" | \"moderate\" | \"severe\";\n\n/**\n * Lift height for throwing techniques\n * 들어올리기 높이\n *\n * @korean 들어올리기높이\n */\nexport type LiftHeight = \"none\" | \"low\" | \"medium\" | \"high\";\n\n/**\n * Rotational power level\n * 회전력 수준\n *\n * @korean 회전력수준\n */\nexport type RotationalPower = \"low\" | \"medium\" | \"high\";\n\n/**\n * Momentum transfer level\n * 운동량 전달 수준\n *\n * @korean 운동량전달수준\n */\nexport type MomentumTransfer = \"low\" | \"medium\" | \"high\";\n\n/**\n * Setup speed for technique execution\n * 기술 준비 속도\n *\n * @korean 기술준비속도\n */\nexport type SetupSpeed = \"slow\" | \"medium\" | \"fast\";\n\n/**\n * Penetration depth for stance/level change\n * 침투 깊이\n *\n * @korean 침투깊이\n */\nexport type PenetrationDepth = \"high\" | \"medium\" | \"low\";\n\n/**\n * Extended Gon technique with Earth-specific mechanics\n * 대지 특화 기술 확장 인터페이스\n *\n * Adds authentic Ssireum/Hapkido grappling mechanics to base technique.\n * All Gon stance techniques should implement this interface.\n *\n * **Korean Martial Arts Context**:\n * - Ssireum (씨름): Traditional Korean wrestling with satba belt\n * - Hapkido (합기도): Joint locks, throws, circular motion\n *\n * **Earth Philosophy** (대지 철학):\n * \"대지는 모든 것을 품고 키운다\" - The earth embraces and nurtures all things\n *\n * @korean 확장곤괘기술\n */\nexport interface ExtendedGonTechnique extends TrigramStanceTechnique {\n  // ============= CORE FIELDS (Phase 1 Implementation) =============\n\n  /**\n   * Physical trajectory path of the throw\n   * 던지기 궤적\n   *\n   * Determines animation path and physics simulation\n   *\n   * @example \"arc_over_hip\" for traditional Ssireum throw\n   * @korean 던지기궤적\n   */\n  throwTrajectory: ThrowTrajectory;\n\n  /**\n   * Ground impact damage multiplier (1.0-2.0 range)\n   * 지면 충격 배수\n   *\n   * Multiplies base damage when opponent hits ground.\n   * - 1.0-1.2: Low impact (controlled takedowns)\n   * - 1.3-1.5: Medium impact (standard throws)\n   * - 1.6-1.8: High impact (power throws)\n   * - 1.9-2.0: Maximum impact (slams)\n   *\n   * **Formula**: `Final Damage = Base Damage × groundImpactMultiplier × (1 + strength_modifier)`\n   *\n   * @example 2.0 for 대지강타 (Ground Pound) - maximum impact\n   * @korean 지면충격배수\n   */\n  groundImpactMultiplier: number;\n\n  /**\n   * Post-throw control duration in milliseconds\n   * 던지기 후 제어 시간\n   *\n   * Duration attacker maintains positional advantage after throw.\n   * Affects follow-up attack windows and defender recovery time.\n   *\n   * **Range**: 800ms (brief) to 2000ms (dominant)\n   *\n   * @example 1800 for 씨름던지기 (Ssireum Throw) - strong control\n   * @korean 제어시간\n   */\n  controlDuration: number;\n\n  /**\n   * Earth's supportive healing value (0-10 scale)\n   * 대지 치유 수치\n   *\n   * HP restored from earth connection during technique execution.\n   * Based on Korean philosophy: earth nurtures all things.\n   *\n   * **Typical Range**: 1-6 for combat techniques\n   * - 0-2: Minimal earth connection (aggressive)\n   * - 3-4: Moderate earth connection (standard Ssireum)\n   * - 5-6: Strong earth connection (traditional, sacrifice throws)\n   * - 7-10: RESERVED for meditation/healing techniques\n   *\n   * **Formula**: `HP Restored = supportiveHealing × (1 + earth_affinity_stat)`\n   *\n   * @example 5 for 씨름던지기 - traditional technique bonus\n   * @korean 대지치유\n   */\n  supportiveHealing: number;\n\n  /**\n   * Whether technique creates earth crack visual effect\n   * 대지 균열 효과 여부\n   *\n   * If true, ground impact creates visual feedback:\n   * - Earth crack patterns (Korean pottery-inspired)\n   * - Dust clouds (yellow-brown 황토색)\n   * - Shockwave ripples (for high impact)\n   *\n   * **Intensity scales with**: groundImpactMultiplier\n   *\n   * @example true for all throws/slams, false for clinch control\n   * @korean 대지균열효과\n   */\n  earthCrackEffect: boolean;\n\n  // ============= OPTIONAL ADVANCED FIELDS (Phase 3) =============\n\n  /**\n   * Requires traditional Ssireum satba belt grip\n   * 샅바 잡기 필요 여부\n   *\n   * If true, technique uses traditional Korean wrestling belt mechanics\n   *\n   * @optional\n   * @korean 샅바필요\n   */\n  satbaGripRequired?: boolean;\n\n  /**\n   * Cultural authenticity damage bonus\n   * 전통 무술 보너스\n   *\n   * Damage multiplier for traditional Korean techniques\n   * Rewards using authentic martial arts\n   *\n   * @example 1.15 (15% bonus) for 씨름던지기\n   * @optional\n   * @korean 전통보너스\n   */\n  traditionalBonus?: number;\n\n  /**\n   * Grip strength for escape difficulty (0-1 scale)\n   * 잡기 강도\n   *\n   * Higher values make technique harder to escape from\n   * 1.0 = unbreakable, 0.0 = no grip\n   *\n   * @optional\n   * @korean 잡기강도\n   */\n  gripStrength?: number;\n\n  /**\n   * Takedown classification\n   * 넘어뜨리기 유형\n   *\n   * @optional\n   * @korean 넘어뜨리기유형\n   */\n  takedownType?: TakedownType;\n\n  /**\n   * Sweep direction for leg techniques\n   * 쓸기 방향\n   *\n   * @optional\n   * @korean 쓸기방향\n   */\n  sweepDirection?: SweepDirection;\n\n  /**\n   * Self-risk factor (0-1 scale)\n   * 자기 위험도\n   *\n   * Chance of self-damage from technique (e.g., sacrifice throws)\n   * 0.2 = 20% chance of taking damage yourself\n   *\n   * @optional\n   * @korean 자기위험도\n   */\n  selfRisk?: number;\n\n  /**\n   * Counter vulnerability (0-1 scale)\n   * 반격 취약성\n   *\n   * How easily technique can be countered during execution\n   * Higher = more vulnerable to counter-attacks\n   *\n   * @optional\n   * @korean 반격취약성\n   */\n  counterVulnerability?: number;\n\n  /**\n   * Positional outcome after technique\n   * 기술 후 위치\n   *\n   * @optional\n   * @korean 기술후위치\n   */\n  endingPosition?: EndingPosition;\n\n  /**\n   * Follow-up technique damage bonus\n   * 연속 공격 보너스\n   *\n   * Damage multiplier for chained techniques\n   *\n   * @example 0.3 (30% bonus) for sacrifice throws\n   * @optional\n   * @korean 연속공격보너스\n   */\n  transitionBonus?: number;\n\n  /**\n   * Breath restriction level (0-1 scale)\n   * 호흡 제한 수준\n   *\n   * How much technique restricts opponent's breathing\n   * Used for body locks and compression techniques\n   *\n   * @optional\n   * @korean 호흡제한\n   */\n  breathRestriction?: number;\n\n  /**\n   * Stun chance probability (0-1 scale)\n   * 기절 확률\n   *\n   * Chance technique stuns opponent on impact\n   *\n   * @example 0.4 (40% chance) for 대지강타\n   * @optional\n   * @korean 기절확률\n   */\n  stunChance?: number;\n\n  /**\n   * Breath loss severity\n   * 호흡 상실 심각도\n   *\n   * How severely technique \"knocks the wind out\"\n   *\n   * @optional\n   * @korean 호흡상실\n   */\n  breathLoss?: BreathLoss;\n\n  /**\n   * Setup speed classification\n   * 준비 속도\n   *\n   * @optional\n   * @korean 준비속도\n   */\n  setupSpeed?: SetupSpeed;\n\n  /**\n   * Penetration depth level\n   * 침투 깊이\n   *\n   * @optional\n   * @korean 침투깊이\n   */\n  penetrationDepth?: PenetrationDepth;\n\n  /**\n   * Lift height before throw\n   * 들어올리기 높이\n   *\n   * @optional\n   * @korean 들어올리기높이\n   */\n  liftHeight?: LiftHeight;\n\n  /**\n   * Rotational power level\n   * 회전력 수준\n   *\n   * @optional\n   * @korean 회전력\n   */\n  rotationalPower?: RotationalPower;\n\n  /**\n   * Momentum transfer level\n   * 운동량 전달\n   *\n   * @optional\n   * @korean 운동량전달\n   */\n  momentumTransfer?: MomentumTransfer;\n}\n\n/**\n * Earth crack visual effect intensity\n * 대지 균열 시각 효과 강도\n *\n * @korean 대지균열강도\n */\nexport type EarthCrackIntensity = \"none\" | \"small\" | \"medium\" | \"large\" | \"massive\";\n\n/**\n * Calculate earth crack visual intensity based on impact\n * 충격도에 따른 대지 균열 강도 계산\n *\n * @param technique - Gon technique with impact multiplier\n * @param playerStrength - Player's strength stat modifier\n * @returns Visual effect intensity level\n *\n * @korean 대지균열강도계산\n */\nexport function calculateEarthCrackIntensity(\n  technique: Pick<ExtendedGonTechnique, \"earthCrackEffect\" | \"groundImpactMultiplier\">,\n  playerStrength: number,\n): EarthCrackIntensity {\n  if (!technique.earthCrackEffect) return \"none\";\n\n  const impactScore = technique.groundImpactMultiplier * playerStrength;\n\n  if (impactScore < 1.3) return \"small\";\n  if (impactScore < 1.6) return \"medium\";\n  if (impactScore < 1.9) return \"large\";\n  return \"massive\"; // 대지강타 with high strength = spectacular\n}\n\n/**\n * Type guard to check if technique is extended Gon technique\n * 확장 곤괘 기술 여부 확인\n *\n * Checks both field presence AND type correctness for core Gon fields.\n * For value range validation (e.g., groundImpactMultiplier 1.0-2.0),\n * use `validateGonTechniqueEnhancements()`.\n *\n * @param technique - Technique to check\n * @returns True if technique has all required Gon-specific fields with correct types\n *\n * @see validateGonTechniqueEnhancements for runtime value range validation\n * @korean 확장곤괘기술확인\n */\nexport function isExtendedGonTechnique(\n  technique: TrigramStanceTechnique,\n): technique is ExtendedGonTechnique {\n  const hasRequiredFields =\n    \"throwTrajectory\" in technique &&\n    \"groundImpactMultiplier\" in technique &&\n    \"controlDuration\" in technique &&\n    \"supportiveHealing\" in technique &&\n    \"earthCrackEffect\" in technique;\n\n  if (!hasRequiredFields) {\n    return false;\n  }\n\n  // Runtime type checking for safety - use safer type assertion\n  const candidate = technique as {\n    throwTrajectory: unknown;\n    groundImpactMultiplier: unknown;\n    controlDuration: unknown;\n    supportiveHealing: unknown;\n    earthCrackEffect: unknown;\n  };\n\n  return (\n    typeof candidate.throwTrajectory === \"string\" &&\n    typeof candidate.groundImpactMultiplier === \"number\" &&\n    typeof candidate.controlDuration === \"number\" &&\n    typeof candidate.supportiveHealing === \"number\" &&\n    typeof candidate.earthCrackEffect === \"boolean\"\n  );\n}\n\n/**\n * Safely cast a technique to ExtendedGonTechnique after validation.\n * Helper function to reduce code duplication and improve type safety.\n * \n * @param technique - The technique to cast\n * @returns The technique cast as ExtendedGonTechnique, or null if not valid\n * @korean 곤기술안전변환\n */\nexport function asExtendedGonTechnique(\n  technique: KoreanTechnique\n): ExtendedGonTechnique | null {\n  const trigramTechnique = technique as TrigramStanceTechnique;\n  if (!isExtendedGonTechnique(trigramTechnique)) {\n    return null;\n  }\n  // Safe cast after validation\n  return trigramTechnique as ExtendedGonTechnique;\n}\n\n/**\n * Validate Gon technique enhancement values\n * 곤괘 기술 강화 수치 검증\n *\n * Ensures all enhancement values are within valid ranges\n *\n * @param technique - Extended Gon technique to validate\n * @returns Validation result with errors if any\n *\n * @korean 곤괘기술검증\n */\nexport function validateGonTechniqueEnhancements(\n  technique: ExtendedGonTechnique,\n): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n\n  // Validate groundImpactMultiplier (1.0-2.0)\n  if (\n    technique.groundImpactMultiplier < 1.0 ||\n    technique.groundImpactMultiplier > 2.0\n  ) {\n    errors.push(\n      `groundImpactMultiplier must be 1.0-2.0, got ${technique.groundImpactMultiplier}`,\n    );\n  }\n\n  // Validate controlDuration (800-2000ms)\n  if (technique.controlDuration < 800 || technique.controlDuration > 2000) {\n    errors.push(\n      `controlDuration must be 800-2000ms, got ${technique.controlDuration}ms`,\n    );\n  }\n\n  // Validate supportiveHealing (0-10)\n  if (technique.supportiveHealing < 0 || technique.supportiveHealing > 10) {\n    errors.push(\n      `supportiveHealing must be 0-10, got ${technique.supportiveHealing}`,\n    );\n  }\n\n  // Validate optional fields if present\n  if (technique.gripStrength !== undefined) {\n    if (technique.gripStrength < 0 || technique.gripStrength > 1) {\n      errors.push(`gripStrength must be 0-1, got ${technique.gripStrength}`);\n    }\n  }\n\n  if (technique.selfRisk !== undefined) {\n    if (technique.selfRisk < 0 || technique.selfRisk > 1) {\n      errors.push(`selfRisk must be 0-1, got ${technique.selfRisk}`);\n    }\n  }\n\n  if (technique.traditionalBonus !== undefined) {\n    if (technique.traditionalBonus < 1.0 || technique.traditionalBonus > 2.0) {\n      errors.push(\n        `traditionalBonus must be 1.0-2.0, got ${technique.traditionalBonus}`,\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Earth philosophy constants\n * 대지 철학 상수\n *\n * @korean 대지철학상수\n */\nexport const EARTH_PHILOSOPHY = {\n  /**\n   * Korean philosophy: \"The earth embraces and nurtures all things\"\n   * 대지는 모든 것을 품고 키운다\n   */\n  CORE_PRINCIPLE: {\n    korean: \"대지는 모든 것을 품고 키운다\",\n    romanized: \"Daeji-neun modeun geoseul pumgo kiwinda\",\n    english: \"The earth embraces and nurtures all things\",\n  },\n\n  /**\n   * Grounding effect (접지 효과)\n   * Physical earth contact provides regeneration\n   */\n  GROUNDING_EFFECT: {\n    korean: \"접지 효과\",\n    romanized: \"Jeobji Hyogwa\",\n    english: \"Grounding Effect\",\n  },\n\n  /**\n   * Earth's embrace (대지의 포옹)\n   * Low stance connection provides stamina recovery\n   */\n  EARTH_EMBRACE: {\n    korean: \"대지의 포옹\",\n    romanized: \"Daeji-ui Po-ong\",\n    english: \"Earth's Embrace\",\n  },\n\n  /**\n   * Nurturing recovery (양육 회복)\n   * Post-throw earth contact provides healing\n   */\n  NURTURING_RECOVERY: {\n    korean: \"양육 회복\",\n    romanized: \"Yangnyuk Hoibok\",\n    english: \"Nurturing Recovery\",\n  },\n} as const;\n\n/**\n * Ssireum cultural context\n * 씨름 문화 배경\n *\n * @korean 씨름문화\n */\nexport const SSIREUM_CONTEXT = {\n  /**\n   * UNESCO Intangible Cultural Heritage (2018)\n   */\n  UNESCO_STATUS: {\n    year: 2018,\n    category: \"Intangible Cultural Heritage of Humanity\",\n  },\n\n  /**\n   * Traditional Ssireum equipment\n   */\n  EQUIPMENT: {\n    /**\n     * Satba - fabric belt wrapped around waist and thigh\n     * 샅바 - 허리와 넓적다리에 감는 천 띠\n     */\n    SATBA: {\n      korean: \"샅바\",\n      romanized: \"Satba\",\n      english: \"Traditional wrestling belt\",\n      description:\n        \"Fabric belt wrapped around waist and right thigh for grip techniques\",\n    },\n\n    /**\n     * Morae-pan - sand circle arena\n     * 모래판 - 모래 경기장\n     */\n    ARENA: {\n      korean: \"모래판\",\n      romanized: \"Morae-pan\",\n      english: \"Sand circle arena\",\n      diameter: \"8.5m\",\n    },\n  },\n\n  /**\n   * Key Ssireum principles\n   */\n  PRINCIPLES: {\n    POWER_TRANSMISSION: {\n      korean: \"힘의 전달\",\n      romanized: \"Him-ui Jeontal\",\n      english: \"Power transmission through hips\",\n    },\n    CENTER_CONTROL: {\n      korean: \"중심 잡기\",\n      romanized: \"Jungsim Japgi\",\n      english: \"Controlling opponent's center of gravity\",\n    },\n    EARTH_CONNECTION: {\n      korean: \"대지와의 연결\",\n      romanized: \"Daeji-wa-ui Yeongyeol\",\n      english: \"Connection with earth for power\",\n    },\n  },\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;AAqcA,SAAgB,uBACd,WACmC;AAQnC,KAAI,EANF,qBAAqB,aACrB,4BAA4B,aAC5B,qBAAqB,aACrB,uBAAuB,aACvB,sBAAsB,WAGtB,QAAO;CAIT,MAAM,YAAY;AAQlB,QACE,OAAO,UAAU,oBAAoB,YACrC,OAAO,UAAU,2BAA2B,YAC5C,OAAO,UAAU,oBAAoB,YACrC,OAAO,UAAU,sBAAsB,YACvC,OAAO,UAAU,qBAAqB;;;;;;;;;;AAY1C,SAAgB,uBACd,WAC6B;CAC7B,MAAM,mBAAmB;AACzB,KAAI,CAAC,uBAAuB,iBAAiB,CAC3C,QAAO;AAGT,QAAO"}