blacktrigram 0.7.2

package/lib/systems/animation/builders/AnimationFactoryPresets.d.ts

@@ -0,0 +1,280 @@
+/**
+ * Animation Factory Presets
+ *
+ * Reusable factory functions to reduce code duplication across animation files.
+ * Provides preset configurations for common animation patterns.
+ *
+ * 애니메이션 팩토리 프리셋 - 코드 중복 감소를 위한 재사용 가능한 팩토리 함수
+ *
+ * @module systems/animation/builders/AnimationFactoryPresets
+ * @korean 애니메이션팩토리프리셋
+ */
+import type { TrigramStance } from "../../../types/common";
+import type { SkeletalAnimation } from "../../../types/skeletal";
+import type { LeadFoot } from "../utils/AnimationMirror";
+import { getAnimationForStance } from "../utils/AnimationMirror";
+/**
+ * Standard timing configurations for different technique speeds
+ * 다양한 기술 속도에 대한 표준 타이밍 구성
+ */
+export declare const TIMING_PRESETS: {
+    /** Fast techniques (550ms) - Jabs, quick strikes */
+    readonly FAST: {
+        readonly chamber: 0.1;
+        readonly extend: 0.15;
+        readonly peak: 0.05;
+        readonly retract: 0.1;
+        readonly recover: 0.15;
+        readonly total: 0.55;
+    };
+    /** Fast-Medium techniques (600ms) - Low kicks, lead hooks */
+    readonly FAST_MEDIUM: {
+        readonly chamber: 0.1;
+        readonly extend: 0.15;
+        readonly peak: 0.05;
+        readonly retract: 0.1;
+        readonly recover: 0.2;
+        readonly total: 0.6;
+    };
+    /** Medium-Light techniques (700ms) - Front kicks, uppercuts */
+    readonly MEDIUM_LIGHT: {
+        readonly chamber: 0.12;
+        readonly extend: 0.18;
+        readonly peak: 0.08;
+        readonly retract: 0.1;
+        readonly recover: 0.22;
+        readonly total: 0.7;
+    };
+    /** Medium techniques (730ms) - Crosses, roundhouse kicks */
+    readonly MEDIUM: {
+        readonly chamber: 0.15;
+        readonly extend: 0.2;
+        readonly peak: 0.08;
+        readonly retract: 0.12;
+        readonly recover: 0.18;
+        readonly total: 0.73;
+    };
+    /** Medium-Heavy techniques (750ms) - Side kicks */
+    readonly MEDIUM_HEAVY: {
+        readonly chamber: 0.12;
+        readonly extend: 0.2;
+        readonly peak: 0.08;
+        readonly retract: 0.15;
+        readonly recover: 0.2;
+        readonly total: 0.75;
+    };
+    /** Heavy-Light techniques (800ms) - Spinning kicks */
+    readonly HEAVY_LIGHT: {
+        readonly chamber: 0.15;
+        readonly extend: 0.2;
+        readonly peak: 0.1;
+        readonly retract: 0.15;
+        readonly recover: 0.2;
+        readonly total: 0.8;
+    };
+    /** Heavy-Medium techniques (850ms) - Crescent kicks */
+    readonly HEAVY_MEDIUM: {
+        readonly chamber: 0.12;
+        readonly extend: 0.22;
+        readonly peak: 0.08;
+        readonly retract: 0.15;
+        readonly recover: 0.28;
+        readonly total: 0.85;
+    };
+    /** Heavy techniques (1000ms) - Jumping techniques */
+    readonly HEAVY: {
+        readonly chamber: 0.2;
+        readonly extend: 0.3;
+        readonly peak: 0.12;
+        readonly retract: 0.15;
+        readonly recover: 0.23;
+        readonly total: 1;
+    };
+};
+/**
+ * Configuration for kick animation creation
+ * 발차기 애니메이션 생성 설정
+ */
+/**
+ * Timing configuration for technique animations
+ */
+interface TechniqueTiming {
+    readonly chamber: number;
+    readonly extend: number;
+    readonly peak: number;
+    readonly retract: number;
+    readonly recover: number;
+    readonly total: number;
+}
+export interface KickConfig {
+    readonly name: string;
+    readonly koreanName: string;
+    readonly timing: TechniqueTiming;
+    readonly kickType: "front" | "roundhouse" | "side" | "axe" | "back" | "low" | "crescent" | "spin";
+    readonly guardDuringKick?: "middle" | "high";
+    readonly guardAtPeak?: "middle" | "high";
+}
+/**
+ * Create a standard kick animation with proper phases
+ *
+ * All kicks follow the Korean martial arts pattern:
+ * 1. 기본자세 (Stance) - Fighting stance at t=0
+ * 2. 준비 (Chamber) - Knee lifts
+ * 3. 차기 (Extension) - Leg extends
+ * 4. 정점 (Peak) - Hold at extension
+ * 5. 회수 (Retraction) - Return through chamber
+ * 6. 복귀 (Recovery) - Return to stance
+ *
+ * @param config - Kick configuration
+ * @returns Complete kick animation
+ *
+ * @korean 표준발차기애니메이션생성
+ */
+export declare function createKickAnimation(config: KickConfig): SkeletalAnimation;
+/**
+ * Configuration for punch animation creation
+ * 주먹 애니메이션 생성 설정
+ */
+export interface PunchConfig {
+    readonly name: string;
+    readonly koreanName: string;
+    readonly timing: TechniqueTiming;
+    readonly punchType: "jab" | "cross" | "hook" | "uppercut" | "palm" | "backfist";
+    readonly hand: "left" | "right";
+    readonly guardHand?: "left" | "right";
+}
+/**
+ * Create a standard punch animation with proper phases
+ *
+ * All punches follow Korean martial arts pattern:
+ * 1. 준비 (Chamber) - Fist at hip
+ * 2. 지르기 (Extension) - Arm extends with rotation
+ * 3. 정점 (Peak) - Maximum reach
+ * 4. 복귀 (Recovery) - Return to guard
+ *
+ * @param config - Punch configuration
+ * @returns Complete punch animation
+ *
+ * @korean 표준주먹애니메이션생성
+ */
+export declare function createPunchAnimation(config: PunchConfig): SkeletalAnimation;
+/**
+ * Configuration for locomotion animations
+ * 이동 애니메이션 설정
+ */
+export interface LocomotionConfig {
+    readonly stance: TrigramStance;
+    readonly type: "walk" | "run" | "idle";
+    readonly duration?: number;
+}
+/**
+ * Create a trigram-specific locomotion animation
+ *
+ * Note: Uses basic locomotion with trigram guard applied.
+ * For more complex trigram-specific locomotion patterns,
+ * use the dedicated StanceLocomotionAnimations module.
+ *
+ * @param config - Locomotion configuration
+ * @returns Complete locomotion animation with trigram styling
+ *
+ * @korean 팔괘별이동애니메이션생성
+ */
+export declare function createTrigramLocomotion(config: LocomotionConfig): SkeletalAnimation;
+/**
+ * Configuration for defensive animations
+ * 방어 애니메이션 설정
+ */
+export interface DefenseConfig {
+    readonly name: string;
+    readonly koreanName: string;
+    readonly timing: TechniqueTiming;
+    readonly defenseType: "block" | "parry" | "slip" | "bob" | "weave";
+    readonly height: "high" | "middle" | "low";
+}
+/**
+ * Create a defensive animation
+ *
+ * @param config - Defense configuration
+ * @returns Complete defensive animation
+ *
+ * @korean 방어애니메이션생성
+ */
+export declare function createDefenseAnimation(config: DefenseConfig): SkeletalAnimation;
+/**
+ * Create both orthodox and southpaw versions of an animation
+ *
+ * Useful for creating complete animation sets that work for both stance sides.
+ *
+ * @param baseAnimation - Base animation (assumed orthodox/left-foot-forward)
+ * @returns Object with both stance versions
+ *
+ * @korean 양자세애니메이션생성
+ */
+export declare function createBothStances(baseAnimation: SkeletalAnimation): {
+    readonly orthodox: SkeletalAnimation;
+    readonly southpaw: SkeletalAnimation;
+};
+/**
+ * Get animation for player's current stance side
+ *
+ * @param baseAnimation - Base animation (orthodox)
+ * @param leadFoot - Player's current lead foot
+ * @param cache - Optional cache for mirrored animations
+ * @returns Animation matching player's stance
+ *
+ * @korean 자세에맞는애니메이션선택
+ */
+export { getAnimationForStance };
+/**
+ * Create a combo animation from a sequence of techniques
+ *
+ * @param name - Combo name
+ * @param koreanName - Korean name
+ * @param techniques - Array of technique names to chain
+ * @returns Complete combo animation
+ *
+ * @korean 콤보애니메이션생성
+ */
+export declare function createComboAnimation(name: string, koreanName: string, techniques: readonly string[]): SkeletalAnimation;
+/**
+ * Pre-built kick animations using factory
+ * 팩토리를 사용한 사전 빌드 발차기 애니메이션
+ */
+export declare const PRESET_KICKS: {
+    readonly FRONT_KICK: SkeletalAnimation;
+    readonly ROUNDHOUSE_KICK: SkeletalAnimation;
+    readonly SIDE_KICK: SkeletalAnimation;
+    readonly LOW_KICK: SkeletalAnimation;
+};
+/**
+ * Pre-built punch animations using factory
+ * 팩토리를 사용한 사전 빌드 주먹 애니메이션
+ */
+export declare const PRESET_PUNCHES: {
+    readonly JAB: SkeletalAnimation;
+    readonly CROSS: SkeletalAnimation;
+    readonly LEAD_HOOK: SkeletalAnimation;
+    readonly REAR_UPPERCUT: SkeletalAnimation;
+};
+/**
+ * Pre-built combo animations using factory
+ * 팩토리를 사용한 사전 빌드 콤보 애니메이션
+ */
+export declare const PRESET_COMBOS: {
+    readonly JAB_CROSS: SkeletalAnimation;
+    readonly ONE_TWO_HOOK: SkeletalAnimation;
+    readonly JAB_CROSS_KICK: SkeletalAnimation;
+};
+/**
+ * Create a trigram-specific breathing/idle animation
+ *
+ * Each trigram has a unique breathing pattern reflecting its elemental nature.
+ *
+ * @param stance - Trigram stance
+ * @returns Breathing animation for the stance
+ *
+ * @korean 팔괘호흡애니메이션생성
+ */
+export declare function createTrigramBreathing(stance: TrigramStance): SkeletalAnimation;
+export type { LeadFoot };
+//# sourceMappingURL=AnimationFactoryPresets.d.ts.map

package/lib/systems/animation/builders/AnimationFactoryPresets.d.ts.map

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

package/lib/systems/animation/builders/AnimationFactoryPresets.js

@@ -0,0 +1,234 @@
+import { MartialArtsAnimationBuilder, TECHNIQUE_TIMING } from "./MartialArtsAnimationBuilder.js";
+import "../utils/AnimationMirror.js";
+//#region src/systems/animation/builders/AnimationFactoryPresets.ts
+/**
+* Standard timing configurations for different technique speeds
+* 다양한 기술 속도에 대한 표준 타이밍 구성
+*/
+var TIMING_PRESETS = {
+	FAST: TECHNIQUE_TIMING.FAST,
+	FAST_MEDIUM: TECHNIQUE_TIMING.FAST_MEDIUM,
+	MEDIUM_LIGHT: TECHNIQUE_TIMING.MEDIUM_LIGHT,
+	MEDIUM: TECHNIQUE_TIMING.MEDIUM,
+	MEDIUM_HEAVY: TECHNIQUE_TIMING.MEDIUM_HEAVY,
+	HEAVY_LIGHT: TECHNIQUE_TIMING.HEAVY_LIGHT,
+	HEAVY_MEDIUM: TECHNIQUE_TIMING.HEAVY_MEDIUM,
+	HEAVY: TECHNIQUE_TIMING.HEAVY
+};
+/**
+* Create a standard kick animation with proper phases
+*
+* All kicks follow the Korean martial arts pattern:
+* 1. 기본자세 (Stance) - Fighting stance at t=0
+* 2. 준비 (Chamber) - Knee lifts
+* 3. 차기 (Extension) - Leg extends
+* 4. 정점 (Peak) - Hold at extension
+* 5. 회수 (Retraction) - Return through chamber
+* 6. 복귀 (Recovery) - Return to stance
+*
+* @param config - Kick configuration
+* @returns Complete kick animation
+*
+* @korean 표준발차기애니메이션생성
+*/
+function createKickAnimation(config) {
+	const { name, koreanName, timing, kickType, guardDuringKick = "middle", guardAtPeak = "middle" } = config;
+	const builder = MartialArtsAnimationBuilder.create(name, koreanName).asAttack(timing.total).stance().withKoreanMiddleGuard();
+	const applyGuard = (type) => {
+		if (type === "high") builder.withKoreanHighGuard();
+		else builder.withKoreanMiddleGuard();
+	};
+	switch (kickType) {
+		case "front":
+			builder.chamber(timing.chamber).withKoreanMiddleGuard().extend(timing.extend);
+			applyGuard(guardDuringKick);
+			builder.extend(timing.peak);
+			applyGuard(guardAtPeak);
+			break;
+		case "roundhouse":
+			builder.roundhouseChamber(timing.chamber).withKoreanMiddleGuard().roundhouseExtend(timing.extend);
+			applyGuard(guardDuringKick);
+			builder.roundhouseExtend(timing.peak);
+			applyGuard(guardAtPeak);
+			break;
+		case "side":
+			builder.sideKickChamber(timing.chamber).withKoreanHighGuard().sideKickExtend(timing.extend);
+			applyGuard(guardDuringKick);
+			builder.sideKickExtend(timing.peak);
+			applyGuard(guardAtPeak);
+			break;
+		case "axe":
+			builder.axeKickRise(timing.chamber).withKoreanHighGuard().axeKickChop(timing.extend);
+			applyGuard(guardDuringKick);
+			builder.axeKick(timing.peak);
+			applyGuard(guardAtPeak);
+			break;
+		case "back":
+			builder.backKickSpin(timing.chamber).withKoreanHighGuard().backKickThrust(timing.extend);
+			applyGuard(guardDuringKick);
+			builder.backKickThrust(timing.peak);
+			applyGuard(guardAtPeak);
+			break;
+		case "low":
+			builder.lowKickChamber(timing.chamber).withKoreanMiddleGuard().lowKickSweep(timing.extend);
+			applyGuard(guardDuringKick);
+			builder.lowKickSweep(timing.peak);
+			applyGuard(guardAtPeak);
+			break;
+		case "crescent":
+			builder.crescentKickChamber(timing.chamber).withKoreanHighGuard().crescentKickArc(timing.extend);
+			applyGuard(guardDuringKick);
+			builder.crescentKickArc(timing.peak);
+			applyGuard(guardAtPeak);
+			break;
+		case "spin":
+			builder.spin(timing.chamber).withKoreanHighGuard().spinKick(timing.extend);
+			applyGuard(guardDuringKick);
+			builder.spinKick(timing.peak);
+			applyGuard(guardAtPeak);
+			break;
+	}
+	builder.retract(timing.retract).recover(timing.recover).withKoreanMiddleGuard();
+	return builder.build();
+}
+/**
+* Create a standard punch animation with proper phases
+*
+* All punches follow Korean martial arts pattern:
+* 1. 준비 (Chamber) - Fist at hip
+* 2. 지르기 (Extension) - Arm extends with rotation
+* 3. 정점 (Peak) - Maximum reach
+* 4. 복귀 (Recovery) - Return to guard
+*
+* @param config - Punch configuration
+* @returns Complete punch animation
+*
+* @korean 표준주먹애니메이션생성
+*/
+function createPunchAnimation(config) {
+	const { name, koreanName, timing, punchType, hand, guardHand = hand === "left" ? "right" : "left" } = config;
+	const builder = MartialArtsAnimationBuilder.create(name, koreanName).asAttack(timing.total);
+	switch (punchType) {
+		case "jab":
+		case "cross":
+			builder.punchChamber(timing.chamber, hand).withKoreanMiddleGuard(guardHand).punchExtend(timing.extend, hand).withKoreanMiddleGuard(guardHand).punchPeak(timing.peak, hand).withKoreanMiddleGuard(guardHand);
+			break;
+		case "hook":
+			builder.hookWindup(timing.chamber, hand).withKoreanMiddleGuard(guardHand).hookPunch(timing.extend + timing.peak, hand).withKoreanMiddleGuard(guardHand);
+			break;
+		case "uppercut":
+			builder.uppercutCrouch(timing.chamber).withKoreanMiddleGuard(guardHand).uppercutPunch(timing.extend + timing.peak).withKoreanMiddleGuard(guardHand);
+			break;
+		case "palm":
+			builder.punchWindup(timing.chamber).palmStrike(timing.extend).palmStrike(timing.peak);
+			break;
+		case "backfist":
+			builder.punchChamber(timing.chamber, hand).withKoreanMiddleGuard(guardHand).withBackfist(hand).punchExtend(timing.extend, hand).withKoreanMiddleGuard(guardHand).withBackfist(hand).punchPeak(timing.peak, hand).withKoreanMiddleGuard(guardHand);
+			break;
+	}
+	builder.recover(timing.retract + timing.recover).withKoreanMiddleGuard();
+	return builder.build();
+}
+/**
+* Create a combo animation from a sequence of techniques
+*
+* @param name - Combo name
+* @param koreanName - Korean name
+* @param techniques - Array of technique names to chain
+* @returns Complete combo animation
+*
+* @korean 콤보애니메이션생성
+*/
+function createComboAnimation(name, koreanName, techniques) {
+	const timing = TECHNIQUE_TIMING.COMBO_FAST;
+	const totalDuration = timing.total * techniques.length;
+	const builder = MartialArtsAnimationBuilder.create(name, koreanName).asAttack(totalDuration).stance().withKoreanMiddleGuard();
+	techniques.forEach((technique, _index) => {
+		switch (technique) {
+			case "jab":
+				builder.punchChamber(timing.chamber, "left").punchExtend(timing.extend, "left").punchPeak(timing.peak, "left");
+				break;
+			case "cross":
+				builder.punchChamber(timing.chamber, "right").punchExtend(timing.extend, "right").punchPeak(timing.peak, "right");
+				break;
+			case "hook":
+				builder.hookWindup(timing.chamber, "left").hookPunch(timing.extend + timing.peak, "left");
+				break;
+			case "uppercut":
+				builder.uppercutCrouch(timing.chamber).uppercutPunch(timing.extend + timing.peak);
+				break;
+			case "front_kick":
+				builder.chamber(timing.chamber).extend(timing.extend);
+				break;
+			case "roundhouse":
+				builder.roundhouseChamber(timing.chamber).roundhouseExtend(timing.extend);
+				break;
+		}
+		if (_index < techniques.length - 1) builder.recover(timing.recover * .5);
+	});
+	builder.recover(timing.recover).withKoreanMiddleGuard();
+	return builder.build();
+}
+createKickAnimation({
+	name: "front_kick",
+	koreanName: "앞차기",
+	timing: TIMING_PRESETS.MEDIUM_LIGHT,
+	kickType: "front"
+}), createKickAnimation({
+	name: "roundhouse_kick",
+	koreanName: "돌려차기",
+	timing: TIMING_PRESETS.HEAVY_LIGHT,
+	kickType: "roundhouse",
+	guardDuringKick: "high",
+	guardAtPeak: "high"
+}), createKickAnimation({
+	name: "side_kick",
+	koreanName: "옆차기",
+	timing: TIMING_PRESETS.MEDIUM_HEAVY,
+	kickType: "side",
+	guardDuringKick: "high",
+	guardAtPeak: "high"
+}), createKickAnimation({
+	name: "low_kick",
+	koreanName: "하단차기",
+	timing: TIMING_PRESETS.FAST_MEDIUM,
+	kickType: "low"
+});
+createPunchAnimation({
+	name: "jab",
+	koreanName: "잽",
+	timing: TIMING_PRESETS.FAST,
+	punchType: "jab",
+	hand: "left"
+}), createPunchAnimation({
+	name: "cross",
+	koreanName: "크로스",
+	timing: TIMING_PRESETS.MEDIUM,
+	punchType: "cross",
+	hand: "right"
+}), createPunchAnimation({
+	name: "lead_hook",
+	koreanName: "리드훅",
+	timing: TIMING_PRESETS.MEDIUM,
+	punchType: "hook",
+	hand: "left"
+}), createPunchAnimation({
+	name: "rear_uppercut",
+	koreanName: "리어어퍼컷",
+	timing: TIMING_PRESETS.MEDIUM,
+	punchType: "uppercut",
+	hand: "right"
+});
+createComboAnimation("jab_cross", "잽-크로스", ["jab", "cross"]), createComboAnimation("one_two_hook", "원투훅", [
+	"jab",
+	"cross",
+	"hook"
+]), createComboAnimation("jab_cross_kick", "잽크로스킥", [
+	"jab",
+	"cross",
+	"front_kick"
+]);
+//#endregion
+export { TIMING_PRESETS, createComboAnimation, createKickAnimation, createPunchAnimation };
+
+//# sourceMappingURL=AnimationFactoryPresets.js.map

package/lib/systems/animation/builders/AnimationFactoryPresets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationFactoryPresets.js","names":[],"sources":["../../../../src/systems/animation/builders/AnimationFactoryPresets.ts"],"sourcesContent":["/**\n * Animation Factory Presets\n *\n * Reusable factory functions to reduce code duplication across animation files.\n * Provides preset configurations for common animation patterns.\n *\n * 애니메이션 팩토리 프리셋 - 코드 중복 감소를 위한 재사용 가능한 팩토리 함수\n *\n * @module systems/animation/builders/AnimationFactoryPresets\n * @korean 애니메이션팩토리프리셋\n */\n\nimport type { TrigramStance } from \"../../../types/common\";\nimport type { SkeletalAnimation } from \"../../../types/skeletal\";\nimport type { LeadFoot } from \"../utils/AnimationMirror\";\nimport {\n  getAnimationForStance,\n  mirrorAnimation,\n} from \"../utils/AnimationMirror\";\nimport {\n  MartialArtsAnimationBuilder,\n  TECHNIQUE_TIMING,\n} from \"./MartialArtsAnimationBuilder\";\n\n// ═══════════════════════════════════════════════════════════════════════════\n// TIMING PRESETS (타이밍 프리셋)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Standard timing configurations for different technique speeds\n * 다양한 기술 속도에 대한 표준 타이밍 구성\n */\nexport const TIMING_PRESETS = {\n  /** Fast techniques (550ms) - Jabs, quick strikes */\n  FAST: TECHNIQUE_TIMING.FAST,\n  /** Fast-Medium techniques (600ms) - Low kicks, lead hooks */\n  FAST_MEDIUM: TECHNIQUE_TIMING.FAST_MEDIUM,\n  /** Medium-Light techniques (700ms) - Front kicks, uppercuts */\n  MEDIUM_LIGHT: TECHNIQUE_TIMING.MEDIUM_LIGHT,\n  /** Medium techniques (730ms) - Crosses, roundhouse kicks */\n  MEDIUM: TECHNIQUE_TIMING.MEDIUM,\n  /** Medium-Heavy techniques (750ms) - Side kicks */\n  MEDIUM_HEAVY: TECHNIQUE_TIMING.MEDIUM_HEAVY,\n  /** Heavy-Light techniques (800ms) - Spinning kicks */\n  HEAVY_LIGHT: TECHNIQUE_TIMING.HEAVY_LIGHT,\n  /** Heavy-Medium techniques (850ms) - Crescent kicks */\n  HEAVY_MEDIUM: TECHNIQUE_TIMING.HEAVY_MEDIUM,\n  /** Heavy techniques (1000ms) - Jumping techniques */\n  HEAVY: TECHNIQUE_TIMING.HEAVY,\n} as const;\n\n// ═══════════════════════════════════════════════════════════════════════════\n// KICK FACTORY (발차기 팩토리)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Configuration for kick animation creation\n * 발차기 애니메이션 생성 설정\n */\n/**\n * Timing configuration for technique animations\n */\ninterface TechniqueTiming {\n  readonly chamber: number;\n  readonly extend: number;\n  readonly peak: number;\n  readonly retract: number;\n  readonly recover: number;\n  readonly total: number;\n}\n\nexport interface KickConfig {\n  readonly name: string;\n  readonly koreanName: string;\n  readonly timing: TechniqueTiming;\n  readonly kickType:\n    | \"front\"\n    | \"roundhouse\"\n    | \"side\"\n    | \"axe\"\n    | \"back\"\n    | \"low\"\n    | \"crescent\"\n    | \"spin\";\n  readonly guardDuringKick?: \"middle\" | \"high\";\n  readonly guardAtPeak?: \"middle\" | \"high\";\n}\n\n/**\n * Create a standard kick animation with proper phases\n *\n * All kicks follow the Korean martial arts pattern:\n * 1. 기본자세 (Stance) - Fighting stance at t=0\n * 2. 준비 (Chamber) - Knee lifts\n * 3. 차기 (Extension) - Leg extends\n * 4. 정점 (Peak) - Hold at extension\n * 5. 회수 (Retraction) - Return through chamber\n * 6. 복귀 (Recovery) - Return to stance\n *\n * @param config - Kick configuration\n * @returns Complete kick animation\n *\n * @korean 표준발차기애니메이션생성\n */\nexport function createKickAnimation(config: KickConfig): SkeletalAnimation {\n  const {\n    name,\n    koreanName,\n    timing,\n    kickType,\n    guardDuringKick = \"middle\",\n    guardAtPeak = \"middle\",\n  } = config;\n\n  const builder = MartialArtsAnimationBuilder.create(name, koreanName)\n    .asAttack(timing.total)\n    .stance()\n    .withKoreanMiddleGuard();\n\n  // Helper to apply guard based on type\n  const applyGuard = (type: \"middle\" | \"high\") => {\n    if (type === \"high\") {\n      builder.withKoreanHighGuard();\n    } else {\n      builder.withKoreanMiddleGuard();\n    }\n  };\n\n  // Apply kick-type specific chamber and extension\n  switch (kickType) {\n    case \"front\":\n      builder\n        .chamber(timing.chamber)\n        .withKoreanMiddleGuard()\n        .extend(timing.extend);\n      applyGuard(guardDuringKick);\n      builder.extend(timing.peak);\n      applyGuard(guardAtPeak);\n      break;\n\n    case \"roundhouse\":\n      builder\n        .roundhouseChamber(timing.chamber)\n        .withKoreanMiddleGuard()\n        .roundhouseExtend(timing.extend);\n      applyGuard(guardDuringKick);\n      builder.roundhouseExtend(timing.peak);\n      applyGuard(guardAtPeak);\n      break;\n\n    case \"side\":\n      builder\n        .sideKickChamber(timing.chamber)\n        .withKoreanHighGuard()\n        .sideKickExtend(timing.extend);\n      applyGuard(guardDuringKick);\n      builder.sideKickExtend(timing.peak);\n      applyGuard(guardAtPeak);\n      break;\n\n    case \"axe\":\n      builder\n        .axeKickRise(timing.chamber)\n        .withKoreanHighGuard()\n        .axeKickChop(timing.extend);\n      applyGuard(guardDuringKick);\n      builder.axeKick(timing.peak);\n      applyGuard(guardAtPeak);\n      break;\n\n    case \"back\":\n      builder\n        .backKickSpin(timing.chamber)\n        .withKoreanHighGuard()\n        .backKickThrust(timing.extend);\n      applyGuard(guardDuringKick);\n      builder.backKickThrust(timing.peak);\n      applyGuard(guardAtPeak);\n      break;\n\n    case \"low\":\n      builder\n        .lowKickChamber(timing.chamber)\n        .withKoreanMiddleGuard()\n        .lowKickSweep(timing.extend);\n      applyGuard(guardDuringKick);\n      builder.lowKickSweep(timing.peak);\n      applyGuard(guardAtPeak);\n      break;\n\n    case \"crescent\":\n      builder\n        .crescentKickChamber(timing.chamber)\n        .withKoreanHighGuard()\n        .crescentKickArc(timing.extend);\n      applyGuard(guardDuringKick);\n      builder.crescentKickArc(timing.peak);\n      applyGuard(guardAtPeak);\n      break;\n\n    case \"spin\":\n      builder\n        .spin(timing.chamber)\n        .withKoreanHighGuard()\n        .spinKick(timing.extend);\n      applyGuard(guardDuringKick);\n      builder.spinKick(timing.peak);\n      applyGuard(guardAtPeak);\n      break;\n  }\n\n  // Common recovery for all kicks\n  builder\n    .retract(timing.retract)\n    .recover(timing.recover)\n    .withKoreanMiddleGuard();\n\n  return builder.build();\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// PUNCH FACTORY (주먹 팩토리)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Configuration for punch animation creation\n * 주먹 애니메이션 생성 설정\n */\nexport interface PunchConfig {\n  readonly name: string;\n  readonly koreanName: string;\n  readonly timing: TechniqueTiming;\n  readonly punchType:\n    | \"jab\"\n    | \"cross\"\n    | \"hook\"\n    | \"uppercut\"\n    | \"palm\"\n    | \"backfist\";\n  readonly hand: \"left\" | \"right\";\n  readonly guardHand?: \"left\" | \"right\";\n}\n\n/**\n * Create a standard punch animation with proper phases\n *\n * All punches follow Korean martial arts pattern:\n * 1. 준비 (Chamber) - Fist at hip\n * 2. 지르기 (Extension) - Arm extends with rotation\n * 3. 정점 (Peak) - Maximum reach\n * 4. 복귀 (Recovery) - Return to guard\n *\n * @param config - Punch configuration\n * @returns Complete punch animation\n *\n * @korean 표준주먹애니메이션생성\n */\nexport function createPunchAnimation(config: PunchConfig): SkeletalAnimation {\n  const {\n    name,\n    koreanName,\n    timing,\n    punchType,\n    hand,\n    guardHand = hand === \"left\" ? \"right\" : \"left\",\n  } = config;\n\n  const builder = MartialArtsAnimationBuilder.create(name, koreanName).asAttack(\n    timing.total,\n  );\n\n  // Apply punch-type specific phases\n  switch (punchType) {\n    case \"jab\":\n    case \"cross\":\n      builder\n        .punchChamber(timing.chamber, hand)\n        .withKoreanMiddleGuard(guardHand)\n        .punchExtend(timing.extend, hand)\n        .withKoreanMiddleGuard(guardHand)\n        .punchPeak(timing.peak, hand)\n        .withKoreanMiddleGuard(guardHand);\n      break;\n\n    case \"hook\":\n      builder\n        .hookWindup(timing.chamber, hand)\n        .withKoreanMiddleGuard(guardHand)\n        .hookPunch(timing.extend + timing.peak, hand)\n        .withKoreanMiddleGuard(guardHand);\n      break;\n\n    case \"uppercut\":\n      builder\n        .uppercutCrouch(timing.chamber)\n        .withKoreanMiddleGuard(guardHand)\n        .uppercutPunch(timing.extend + timing.peak)\n        .withKoreanMiddleGuard(guardHand);\n      break;\n\n    case \"palm\":\n      builder\n        .punchWindup(timing.chamber)\n        .palmStrike(timing.extend)\n        .palmStrike(timing.peak);\n      break;\n\n    case \"backfist\":\n      // Use standard punch mechanics for backfist\n      builder\n        .punchChamber(timing.chamber, hand)\n        .withKoreanMiddleGuard(guardHand)\n        .withBackfist(hand)\n        .punchExtend(timing.extend, hand)\n        .withKoreanMiddleGuard(guardHand)\n        .withBackfist(hand)\n        .punchPeak(timing.peak, hand)\n        .withKoreanMiddleGuard(guardHand);\n      break;\n  }\n\n  // Common recovery\n  builder.recover(timing.retract + timing.recover).withKoreanMiddleGuard();\n\n  return builder.build();\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// LOCOMOTION FACTORY (이동 팩토리)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Configuration for locomotion animations\n * 이동 애니메이션 설정\n */\nexport interface LocomotionConfig {\n  readonly stance: TrigramStance;\n  readonly type: \"walk\" | \"run\" | \"idle\";\n  readonly duration?: number;\n}\n\n/**\n * Standard locomotion durations\n */\nconst LOCOMOTION_DURATIONS = {\n  walk: 1.0, // 1 second per step cycle\n  run: 0.6, // Faster for running\n  idle: 3.0, // Breathing cycle\n} as const;\n\n/**\n * Create a trigram-specific locomotion animation\n *\n * Note: Uses basic locomotion with trigram guard applied.\n * For more complex trigram-specific locomotion patterns,\n * use the dedicated StanceLocomotionAnimations module.\n *\n * @param config - Locomotion configuration\n * @returns Complete locomotion animation with trigram styling\n *\n * @korean 팔괘별이동애니메이션생성\n */\nexport function createTrigramLocomotion(\n  config: LocomotionConfig,\n): SkeletalAnimation {\n  const { stance, type, duration = LOCOMOTION_DURATIONS[type] } = config;\n\n  const builder = MartialArtsAnimationBuilder.create(\n    `${stance.toLowerCase()}_${type}`,\n    `${stance} ${type === \"walk\" ? \"걷기\" : type === \"run\" ? \"달리기\" : \"대기\"}`,\n  );\n\n  switch (type) {\n    case \"walk\":\n      builder\n        .asMovement(duration, true)\n        .stance()\n        .withTrigramGuard(stance)\n        .step(duration * 0.5)\n        .withTrigramGuard(stance);\n      break;\n\n    case \"run\":\n      builder\n        .asMovement(duration, true)\n        .stance()\n        .withTrigramGuard(stance)\n        .step(duration * 0.3)\n        .withTrigramGuard(stance);\n      break;\n\n    case \"idle\":\n      builder.asIdle(duration, true).stance().withTrigramGuard(stance);\n      break;\n  }\n\n  return builder.build();\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// DEFENSIVE ANIMATION FACTORY (방어 애니메이션 팩토리)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Configuration for defensive animations\n * 방어 애니메이션 설정\n */\nexport interface DefenseConfig {\n  readonly name: string;\n  readonly koreanName: string;\n  readonly timing: TechniqueTiming;\n  readonly defenseType: \"block\" | \"parry\" | \"slip\" | \"bob\" | \"weave\";\n  readonly height: \"high\" | \"middle\" | \"low\";\n}\n\n/**\n * Create a defensive animation\n *\n * @param config - Defense configuration\n * @returns Complete defensive animation\n *\n * @korean 방어애니메이션생성\n */\nexport function createDefenseAnimation(\n  config: DefenseConfig,\n): SkeletalAnimation {\n  const { name, koreanName, timing, defenseType, height } = config;\n\n  const builder = MartialArtsAnimationBuilder.create(name, koreanName)\n    .asDefense(timing.total)\n    .stance()\n    .withKoreanMiddleGuard();\n\n  switch (defenseType) {\n    case \"block\":\n      if (height === \"high\") {\n        builder.blockHigh(timing.chamber + timing.extend).withKoreanHighGuard();\n      } else if (height === \"low\") {\n        builder.blockLow(timing.chamber + timing.extend).withKoreanLowGuard();\n      } else {\n        // Middle block - use parry mechanics with high guard\n        builder.parry(timing.chamber + timing.extend).withKoreanMiddleGuard();\n      }\n      break;\n\n    case \"parry\":\n      builder.parry(timing.chamber + timing.extend);\n      break;\n\n    case \"slip\":\n      builder.duck(timing.chamber + timing.extend);\n      break;\n\n    case \"bob\":\n      builder.bob(timing.chamber + timing.extend);\n      break;\n\n    case \"weave\":\n      builder.weave(timing.chamber + timing.extend);\n      break;\n  }\n\n  builder.recover(timing.retract + timing.recover).withKoreanMiddleGuard();\n\n  return builder.build();\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// STANCE MIRRORING UTILITIES (자세 반전 유틸리티)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Create both orthodox and southpaw versions of an animation\n *\n * Useful for creating complete animation sets that work for both stance sides.\n *\n * @param baseAnimation - Base animation (assumed orthodox/left-foot-forward)\n * @returns Object with both stance versions\n *\n * @korean 양자세애니메이션생성\n */\nexport function createBothStances(baseAnimation: SkeletalAnimation): {\n  readonly orthodox: SkeletalAnimation;\n  readonly southpaw: SkeletalAnimation;\n} {\n  return {\n    orthodox: baseAnimation,\n    southpaw: mirrorAnimation(baseAnimation, {\n      nameSuffix: \"_southpaw\",\n      koreanNameSuffix: \"(사우스포)\",\n    }),\n  };\n}\n\n/**\n * Get animation for player's current stance side\n *\n * @param baseAnimation - Base animation (orthodox)\n * @param leadFoot - Player's current lead foot\n * @param cache - Optional cache for mirrored animations\n * @returns Animation matching player's stance\n *\n * @korean 자세에맞는애니메이션선택\n */\nexport { getAnimationForStance };\n\n// ═══════════════════════════════════════════════════════════════════════════\n// COMBO FACTORY (콤보 팩토리)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Create a combo animation from a sequence of techniques\n *\n * @param name - Combo name\n * @param koreanName - Korean name\n * @param techniques - Array of technique names to chain\n * @returns Complete combo animation\n *\n * @korean 콤보애니메이션생성\n */\nexport function createComboAnimation(\n  name: string,\n  koreanName: string,\n  techniques: readonly string[],\n): SkeletalAnimation {\n  const timing = TECHNIQUE_TIMING.COMBO_FAST;\n  const totalDuration = timing.total * techniques.length;\n\n  const builder = MartialArtsAnimationBuilder.create(name, koreanName)\n    .asAttack(totalDuration)\n    .stance()\n    .withKoreanMiddleGuard();\n\n  // Chain techniques with fast transitions\n  techniques.forEach((technique, _index) => {\n    switch (technique) {\n      case \"jab\":\n        builder\n          .punchChamber(timing.chamber, \"left\")\n          .punchExtend(timing.extend, \"left\")\n          .punchPeak(timing.peak, \"left\");\n        break;\n      case \"cross\":\n        builder\n          .punchChamber(timing.chamber, \"right\")\n          .punchExtend(timing.extend, \"right\")\n          .punchPeak(timing.peak, \"right\");\n        break;\n      case \"hook\":\n        builder\n          .hookWindup(timing.chamber, \"left\")\n          .hookPunch(timing.extend + timing.peak, \"left\");\n        break;\n      case \"uppercut\":\n        builder\n          .uppercutCrouch(timing.chamber)\n          .uppercutPunch(timing.extend + timing.peak);\n        break;\n      case \"front_kick\":\n        builder.chamber(timing.chamber).extend(timing.extend);\n        break;\n      case \"roundhouse\":\n        builder\n          .roundhouseChamber(timing.chamber)\n          .roundhouseExtend(timing.extend);\n        break;\n    }\n\n    // Quick recovery between techniques (except last)\n    if (_index < techniques.length - 1) {\n      builder.recover(timing.recover * 0.5);\n    }\n  });\n\n  // Final recovery\n  builder.recover(timing.recover).withKoreanMiddleGuard();\n\n  return builder.build();\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// PRESET ANIMATIONS (프리셋 애니메이션)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Pre-built kick animations using factory\n * 팩토리를 사용한 사전 빌드 발차기 애니메이션\n */\nexport const PRESET_KICKS = {\n  FRONT_KICK: createKickAnimation({\n    name: \"front_kick\",\n    koreanName: \"앞차기\",\n    timing: TIMING_PRESETS.MEDIUM_LIGHT,\n    kickType: \"front\",\n  }),\n\n  ROUNDHOUSE_KICK: createKickAnimation({\n    name: \"roundhouse_kick\",\n    koreanName: \"돌려차기\",\n    timing: TIMING_PRESETS.HEAVY_LIGHT,\n    kickType: \"roundhouse\",\n    guardDuringKick: \"high\",\n    guardAtPeak: \"high\",\n  }),\n\n  SIDE_KICK: createKickAnimation({\n    name: \"side_kick\",\n    koreanName: \"옆차기\",\n    timing: TIMING_PRESETS.MEDIUM_HEAVY,\n    kickType: \"side\",\n    guardDuringKick: \"high\",\n    guardAtPeak: \"high\",\n  }),\n\n  LOW_KICK: createKickAnimation({\n    name: \"low_kick\",\n    koreanName: \"하단차기\",\n    timing: TIMING_PRESETS.FAST_MEDIUM,\n    kickType: \"low\",\n  }),\n} as const;\n\n/**\n * Pre-built punch animations using factory\n * 팩토리를 사용한 사전 빌드 주먹 애니메이션\n */\nexport const PRESET_PUNCHES = {\n  JAB: createPunchAnimation({\n    name: \"jab\",\n    koreanName: \"잽\",\n    timing: TIMING_PRESETS.FAST,\n    punchType: \"jab\",\n    hand: \"left\",\n  }),\n\n  CROSS: createPunchAnimation({\n    name: \"cross\",\n    koreanName: \"크로스\",\n    timing: TIMING_PRESETS.MEDIUM,\n    punchType: \"cross\",\n    hand: \"right\",\n  }),\n\n  LEAD_HOOK: createPunchAnimation({\n    name: \"lead_hook\",\n    koreanName: \"리드훅\",\n    timing: TIMING_PRESETS.MEDIUM,\n    punchType: \"hook\",\n    hand: \"left\",\n  }),\n\n  REAR_UPPERCUT: createPunchAnimation({\n    name: \"rear_uppercut\",\n    koreanName: \"리어어퍼컷\",\n    timing: TIMING_PRESETS.MEDIUM,\n    punchType: \"uppercut\",\n    hand: \"right\",\n  }),\n} as const;\n\n/**\n * Pre-built combo animations using factory\n * 팩토리를 사용한 사전 빌드 콤보 애니메이션\n */\nexport const PRESET_COMBOS = {\n  JAB_CROSS: createComboAnimation(\"jab_cross\", \"잽-크로스\", [\"jab\", \"cross\"]),\n\n  ONE_TWO_HOOK: createComboAnimation(\"one_two_hook\", \"원투훅\", [\n    \"jab\",\n    \"cross\",\n    \"hook\",\n  ]),\n\n  JAB_CROSS_KICK: createComboAnimation(\"jab_cross_kick\", \"잽크로스킥\", [\n    \"jab\",\n    \"cross\",\n    \"front_kick\",\n  ]),\n} as const;\n\n// ═══════════════════════════════════════════════════════════════════════════\n// TRIGRAM BREATHING ANIMATION (팔괘 호흡)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Create a trigram-specific breathing/idle animation\n *\n * Each trigram has a unique breathing pattern reflecting its elemental nature.\n *\n * @param stance - Trigram stance\n * @returns Breathing animation for the stance\n *\n * @korean 팔괘호흡애니메이션생성\n */\nexport function createTrigramBreathing(\n  stance: TrigramStance,\n): SkeletalAnimation {\n  return createTrigramLocomotion({\n    stance,\n    type: \"idle\",\n    duration: 3.0,\n  });\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// EXPORTS\n// ═══════════════════════════════════════════════════════════════════════════\n\nexport type { LeadFoot };\n"],"mappings":"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"}

package/lib/systems/animation/builders/HandPoseApplicator.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Hand Pose Application Utilities
+ *
+ * Utilities for applying hand poses to animation keyframes.
+ * 손 모양 적용 유틸리티
+ *
+ * @module systems/animation/HandPoseApplicator
+ * @korean 손모양적용기
+ */
+import type { AnimationKeyframe } from "../../../types/skeletal";
+import type { KeyframeConfig } from "./KeyframeConfig";
+import { HAND_POSES } from "./MartialArtsConstants";
+/** Hand pose type from HAND_POSES constant */
+export type HandPose = (typeof HAND_POSES)[keyof typeof HAND_POSES];
+/** Which hand(s) to apply a pose to */
+export type HandSelection = "left" | "right" | "both";
+/**
+ * Apply hand pose to a KeyframeConfig (builder pattern)
+ *
+ * @param kf - KeyframeConfig to apply pose to
+ * @param pose - Hand pose data from HAND_POSES
+ * @param hand - Which hand(s) to apply ("left" | "right" | "both")
+ *
+ * @example
+ * ```typescript
+ * applyHandPoseToConfig(kf, HAND_POSES.FIST, "right");
+ * ```
+ *
+ * @korean KeyframeConfig에손모양적용
+ */
+export declare function applyHandPoseToConfig(kf: KeyframeConfig, pose: HandPose, hand: HandSelection): void;
+/**
+ * Apply hand pose to an AnimationKeyframe (direct mutation)
+ *
+ * @param kf - AnimationKeyframe to apply pose to
+ * @param pose - Hand pose data from HAND_POSES
+ * @param hand - Which hand(s) to apply ("left" | "right" | "both")
+ *
+ * @example
+ * ```typescript
+ * applyHandPoseToKeyframe(animKeyframe, HAND_POSES.GRAB, "both");
+ * ```
+ *
+ * @korean AnimationKeyframe에손모양적용
+ */
+export declare function applyHandPoseToKeyframe(kf: AnimationKeyframe, pose: HandPose, hand: HandSelection): void;
+/**
+ * Get a hand pose by name
+ *
+ * @param poseName - Name of the pose from HAND_POSES
+ * @returns The hand pose data
+ *
+ * @korean 손모양가져오기
+ */
+export declare function getHandPose(poseName: keyof typeof HAND_POSES): HandPose;
+//# sourceMappingURL=HandPoseApplicator.d.ts.map

package/lib/systems/animation/builders/HandPoseApplicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandPoseApplicator.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/builders/HandPoseApplicator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,8CAA8C;AAC9C,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAiGtD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,aAAa,GAClB,IAAI,CAcN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,iBAAiB,EACrB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,aAAa,GAClB,IAAI,CAiBN;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,OAAO,UAAU,GAAG,QAAQ,CAEvE"}