blacktrigram 0.7.2

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

@@ -0,0 +1,2857 @@
+import { BoneName } from "../../../types/skeletal.js";
+import { HAND_POSES, KICK_PHASES, MARTIAL_POSES, PUNCH_PHASES, calculateStanceWidth } from "./MartialArtsConstants.js";
+import { KeyframeConfig } from "./KeyframeConfig.js";
+import { applyHandPoseToConfig, applyHandPoseToKeyframe } from "./HandPoseApplicator.js";
+import { applyHighPeakPhaseToConfig, applyKickPhaseToConfig, applyRoundhousePhaseToConfig, applySideKickPhaseToConfig } from "./KickPhaseApplicator.js";
+import { applyMartialPoseToKeyframe } from "./MartialPoseApplicator.js";
+import { applyPunchPhaseToConfig } from "./PunchPhaseApplicator.js";
+import { applyTrigramGuardToConfig, getGuardArmBase } from "./TrigramGuardApplicator.js";
+import * as THREE from "three";
+//#region src/systems/animation/builders/MartialArtsAnimationBuilder.ts
+/**
+* Technique Timing Constants
+*
+* Defines standard timing phases for martial arts techniques to ensure
+* all movements are visible and comprehensible. Minimum total duration
+* is 0.5s to prevent "teleporting" strikes.
+*
+* Korean martial arts emphasize visible technique phases:
+* - 준비 (Preparation) - Wind-up/chamber
+* - 실행 (Execution) - Strike/extension
+* - 회수 (Recovery) - Retraction
+* - 복귀 (Return) - Return to stance
+*
+* @korean 기술타이밍상수
+*/
+var TECHNIQUE_TIMING = {
+	FAST: {
+		chamber: .1,
+		extend: .15,
+		peak: .05,
+		retract: .1,
+		recover: .15,
+		total: .55
+	},
+	FAST_MEDIUM: {
+		chamber: .1,
+		extend: .15,
+		peak: .05,
+		retract: .1,
+		recover: .2,
+		total: .6
+	},
+	MEDIUM_LIGHT: {
+		chamber: .12,
+		extend: .18,
+		peak: .08,
+		retract: .1,
+		recover: .22,
+		total: .7
+	},
+	MEDIUM: {
+		chamber: .15,
+		extend: .2,
+		peak: .08,
+		retract: .12,
+		recover: .18,
+		total: .73
+	},
+	MEDIUM_HEAVY: {
+		chamber: .12,
+		extend: .2,
+		peak: .08,
+		retract: .15,
+		recover: .2,
+		total: .75
+	},
+	HEAVY_LIGHT: {
+		chamber: .15,
+		extend: .2,
+		peak: .1,
+		retract: .15,
+		recover: .2,
+		total: .8
+	},
+	HEAVY_MEDIUM: {
+		chamber: .12,
+		extend: .22,
+		peak: .08,
+		retract: .15,
+		recover: .28,
+		total: .85
+	},
+	HEAVY: {
+		chamber: .2,
+		extend: .3,
+		peak: .12,
+		retract: .15,
+		recover: .23,
+		total: 1
+	},
+	COMBO_FAST: {
+		chamber: .08,
+		extend: .12,
+		peak: .08,
+		retract: .1,
+		recover: .32,
+		total: .7
+	},
+	JUMPING: {
+		chamber: .18,
+		extend: .22,
+		peak: .08,
+		retract: .12,
+		recover: .3,
+		total: .9
+	},
+	COMBO_HEAVY: {
+		chamber: .12,
+		extend: .22,
+		peak: .08,
+		retract: .15,
+		recover: .38,
+		total: .95
+	},
+	SPINNING: {
+		chamber: .3,
+		extend: .35,
+		peak: .12,
+		retract: .15,
+		recover: .28,
+		total: 1.2
+	}
+};
+/**
+* Martial Arts Animation Builder
+*
+* Fluent API for creating Korean martial arts animations with semantic methods.
+* Designed to be readable by martial arts practitioners.
+*
+* @example
+* ```typescript
+* // Create a front kick (앞차기)
+* const frontKick = MartialArtsAnimationBuilder
+*   .create("front_kick", "앞차기")
+*   .asAttack(0.55)
+*   .chamber()           // 준비 - Knee lifts
+*   .withHighGuard()     // 상단방어 - Protect face
+*   .extend()            // 차기 - Leg extends
+*   .retract()           // 회수 - Return to chamber
+*   .recover()           // 복귀 - Return to stance
+*   .build();
+* ```
+*
+* @korean 무술애니메이션빌더
+*/
+var MartialArtsAnimationBuilder = class MartialArtsAnimationBuilder {
+	name;
+	koreanName;
+	duration = .5;
+	type = "attack";
+	loop = false;
+	keyframes = [];
+	currentTime = 0;
+	constructor(name, koreanName) {
+		this.name = name;
+		this.koreanName = koreanName;
+	}
+	/**
+	* Create new martial arts animation
+	* @param name - English animation name
+	* @param koreanName - Korean animation name (한글이름)
+	*/
+	static create(name, koreanName) {
+		return new MartialArtsAnimationBuilder(name, koreanName);
+	}
+	/**
+	* Configure as attack animation (공격 애니메이션)
+	*/
+	asAttack(duration) {
+		this.type = "attack";
+		this.duration = duration;
+		return this;
+	}
+	/**
+	* Configure as defense animation (방어 애니메이션)
+	*/
+	asDefense(duration) {
+		this.type = "defense";
+		this.duration = duration;
+		return this;
+	}
+	/**
+	* Configure as movement animation (이동 애니메이션)
+	*/
+	asMovement(duration, shouldLoop = false) {
+		this.type = "movement";
+		this.duration = duration;
+		this.loop = shouldLoop;
+		return this;
+	}
+	/**
+	* Configure as idle/stance animation (대기 애니메이션)
+	*/
+	asIdle(duration, shouldLoop = true) {
+		this.type = "idle";
+		this.duration = duration;
+		this.loop = shouldLoop;
+		return this;
+	}
+	/**
+	* Configure as stance transition animation (자세 전환 애니메이션)
+	*/
+	asStance(duration, shouldLoop = false) {
+		this.type = "stance";
+		this.duration = duration;
+		this.loop = shouldLoop;
+		return this;
+	}
+	/**
+	* Add initial fighting stance keyframe (기본 자세)
+	*
+	* Adds a neutral fighting stance at time 0 as the starting position
+	* for attack animations. This is the ready position before techniques.
+	*
+	* @korean 기본자세추가
+	*/
+	stance() {
+		const guard = MARTIAL_POSES.GUARD;
+		this.addKeyframe(0, "linear", (kf) => {
+			kf.rotate(BoneName.HIP_R, 0, 0, 0);
+			kf.rotate(BoneName.HIP_L, 0, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.2, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			kf.rotate(BoneName.FOOT_R, 0, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, 0, 0);
+			kf.rotate(BoneName.PELVIS, 0, 0, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, 0, 0);
+			kf.rotate(BoneName.HEAD, 0, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, ...guard.leftShoulder);
+			kf.rotate(BoneName.ELBOW_L, ...guard.leftElbow);
+			kf.rotate(BoneName.SHOULDER_R, ...guard.rightShoulder);
+			kf.rotate(BoneName.ELBOW_R, ...guard.rightElbow);
+			kf.position(BoneName.PELVIS, 0, 0, 0);
+			kf.position(BoneName.FOOT_R, 0, 0, 0);
+			kf.position(BoneName.FOOT_L, 0, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "both");
+		});
+		return this;
+	}
+	/**
+	* Chamber - Knee lifts to waist height (준비자세)
+	* Starting position for all kicks
+	*
+	* Authentic Korean martial arts chamber mechanics:
+	* - Hip flexed to 90° (1.57 rad) bringing knee to torso height
+	* - Knee bent tight (120° angle = -2.0 rad) for power generation
+	* - Support leg slightly bent for stability
+	* - Pelvis tilts back slightly for balance
+	* - Toe neutral, ready for extension
+	*
+	* @korean 준비자세
+	*/
+	chamber(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyKickPhaseToConfig(kf, KICK_PHASES.CHAMBER, {
+				includeAnkle: true,
+				includePelvis: true
+			});
+			kf.rotate(BoneName.SPINE_LOWER, -.05, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, -.03, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.6, .4, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.6);
+			kf.rotate(BoneName.SHOULDER_R, -.6, -.4, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.6);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Extend - Leg snaps forward (차기 - 확장)
+	*
+	* Authentic Korean martial arts extension mechanics:
+	* - Hip maintains elevation (1.7 rad ~97°) for target height
+	* - Knee extends fully (0.1 rad ~6°) for maximum reach
+	* - Ankle dorsiflexes (0.5 rad ~29°) pointing toe/ball of foot
+	* - Pelvis tilts forward (0.15 rad ~9°) for hip thrust
+	* - Support leg bends deeper (-0.35 rad) for power transfer
+	* - Spine remains upright for balance
+	*
+	* This is the impact frame where the strike connects.
+	*
+	* @korean 차기확장
+	*/
+	extend(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyKickPhaseToConfig(kf, KICK_PHASES.EXTENSION, {
+				includeAnkle: true,
+				includePelvis: true
+			});
+			kf.rotate(BoneName.SPINE_LOWER, .05, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .03, 0, 0);
+			kf.position(BoneName.FOOT_R, .6, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.9, .3, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.6);
+			kf.rotate(BoneName.SHOULDER_R, -.9, -.3, -.4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.6);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Retract - Return to chamber (회수)
+	*
+	* Authentic Korean martial arts retraction mechanics:
+	* - Leg returns THROUGH chamber position (proper 낙법)
+	* - Knee bends back to tight position (-2.0 rad)
+	* - Hip maintains height initially, then lowers
+	* - Foot resets to neutral from pointed position
+	* - Pelvis returns to neutral
+	* - Support leg maintains stability
+	*
+	* This is critical for proper technique - the leg must return
+	* through chamber to protect against counters and maintain balance.
+	*
+	* @korean 회수자세
+	*/
+	retract(timeOffset = .15, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyKickPhaseToConfig(kf, KICK_PHASES.CHAMBER, {
+				includeAnkle: true,
+				includePelvis: true,
+				resetFoot: false
+			});
+			kf.rotate(BoneName.SPINE_LOWER, -.05, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, -.03, 0, 0);
+			kf.rotate(BoneName.FOOT_R, 0, 0, 0);
+			kf.position(BoneName.FOOT_R, 0, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.6, .4, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.6);
+			kf.rotate(BoneName.SHOULDER_R, -.6, -.4, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.6);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Set down - Foot returns to ground (착지)
+	* @korean 착지
+	*/
+	setDown(timeOffset = .1, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, 0, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.15, 0, 0);
+			kf.rotate(BoneName.FOOT_R, 0, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Roundhouse chamber - Hip rotates for 돌려차기
+	*
+	* Authentic Taekwondo roundhouse chamber (돌려차기 준비):
+	* - Hip flexed and rotated out (~1.2 rad flex, ~0.8 rad external rotation)
+	* - Knee bent tight (-1.5 rad) preparing for snap
+	* - Pelvis begins rotation (-0.5 rad on Y-axis)
+	* - Spine counter-rotates for power (0.3 rad on Y-axis)
+	* - Support leg stable
+	* - Arms in high guard
+	*
+	* The hip rotation is KEY - it opens the hip for the circular strike path
+	* that defines a roundhouse kick vs. a front kick.
+	*
+	* @korean 돌려차기준비
+	*/
+	roundhouseChamber(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyRoundhousePhaseToConfig(kf, KICK_PHASES.ROUNDHOUSE_CHAMBER);
+			kf.rotate(BoneName.HIP_L, 0, -.2, 0);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .79, 0);
+			kf.rotate(BoneName.PELVIS, 0, -.79, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -.4, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.9, .3, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -2);
+			kf.rotate(BoneName.SHOULDER_R, -.9, -.3, -.4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 2);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Roundhouse extension - Full hip rotation for 돌려차기
+	*
+	* Authentic Taekwondo roundhouse extension (돌려차기 실행):
+	* - Hip fully extended with maximal rotation (1.2 rad flex, 1.6 rad rotation)
+	* - Knee snaps out to nearly straight (-0.1 rad)
+	* - Foot pointed and rotated (0.4 rad dorsiflexion, 0.3 rad rotation)
+	* - Pelvis fully rotated (-1.5 rad) providing hip whip power
+	* - Spine counter-rotates (0.8 rad) for torque generation
+	* - Foot position extends laterally (0.8m forward)
+	* - Support leg pivots on ball of foot
+	*
+	* Enhanced with compensatory torso lean (중심축회전):
+	* - Torso leans AWAY from kicking leg for balance
+	* - Increases reach and prevents backward fall
+	* - 12° lateral lean on Z-axis for high kicks
+	*
+	* The "snap" comes from the sudden knee extension combined with
+	* the hip rotation - this is the signature of Taekwondo roundhouse.
+	*
+	* @korean 돌려차기
+	*/
+	roundhouseExtend(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, 1.2, 0, 1.6);
+			kf.rotate(BoneName.KNEE_R, -.1, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .4, 0, .3);
+			kf.rotate(BoneName.PELVIS, 0, -1.5, 0);
+			this.applyKickTorsoLean(kf, "right", 12);
+			const upperSpineRot = kf.rotations.get(BoneName.SPINE_UPPER);
+			const lowerSpineRot = kf.rotations.get(BoneName.SPINE_LOWER);
+			kf.rotate(BoneName.SPINE_UPPER, upperSpineRot?.x ?? 0, .8, upperSpineRot?.z ?? 0);
+			kf.rotate(BoneName.SPINE_LOWER, lowerSpineRot?.x ?? 0, -1, lowerSpineRot?.z ?? 0);
+			kf.rotate(BoneName.HIP_L, 0, -.4, 0);
+			kf.rotate(BoneName.KNEE_L, -.35, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, 1.57, 0);
+			kf.position(BoneName.FOOT_R, .8, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.9, .3, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.6);
+			kf.rotate(BoneName.SHOULDER_R, -.9, -.3, -.4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.6);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Side kick chamber - Turn sideways for 옆차기
+	*
+	* Authentic Taekwondo side kick chamber (옆차기 준비):
+	* - Body turns 90° sideways (pelvis -1.57 rad on Y-axis)
+	* - Hip flexed and chambered (1.3 rad flex, 0.3 rad rotation)
+	* - Knee bent tight (-1.6 rad) preparing for lateral thrust
+	* - Spine rotates with body (-1.2 rad on Y-axis)
+	* - Lean away from kick for balance (0.2 rad lean)
+	* - Support leg stable and aligned
+	* - Arms protect vital areas
+	*
+	* The perpendicular chamber is essential - the hips must turn
+	* sideways to allow the heel to drive through the target laterally.
+	*
+	* @korean 옆차기준비
+	*/
+	sideKickChamber(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applySideKickPhaseToConfig(kf, KICK_PHASES.SIDE_CHAMBER);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, -.3, 0);
+			kf.rotate(BoneName.HIP_L, 0, -.3, 0);
+			kf.rotate(BoneName.HEAD, 0, -.5, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.7, .5, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.5);
+			kf.rotate(BoneName.SHOULDER_R, -.7, -.5, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.5);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Side kick extension - Lateral heel thrust for 옆차기
+	*
+	* Authentic Taekwondo side kick extension (옆차기 실행):
+	* - Hip extends laterally (1.3 rad flex, 0.7 rad rotation)
+	* - Knee extends fully (-0.1 rad) driving heel through target
+	* - Foot turned heel-first (0.4 rad on Y-axis)
+	* - Pelvis maintains 90° turn (-1.57 rad)
+	* - Spine leans away (0.4 rad) for counterbalance
+	* - Foot extends laterally (0.7m to side)
+	* - Support leg drives power
+	*
+	* The side kick is one of the most powerful kicks because the
+	* entire body mass drives through the heel in a straight line.
+	*
+	* @korean 옆차기
+	*/
+	sideKickExtend(timeOffset = .1, easing = "linear") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, 1.3, 0, .7);
+			kf.rotate(BoneName.KNEE_R, -.1, 0, 0);
+			kf.rotate(BoneName.FOOT_R, 0, .4, 0);
+			kf.rotate(BoneName.PELVIS, 0, -1.57, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -1.2, .2);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -1.2, .4);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, -.3, 0);
+			kf.rotate(BoneName.HIP_L, 0, -.3, 0);
+			kf.position(BoneName.FOOT_R, .7, 0, 0);
+			kf.rotate(BoneName.HEAD, 0, -.5, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.7, .5, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.5);
+			kf.rotate(BoneName.SHOULDER_R, -.7, -.5, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.5);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Axe kick rise - Leg rises high for 내려차기
+	*
+	* Enhanced with hip rotation and support leg positioning
+	* @korean 내려차기올리기
+	*/
+	axeKickRise(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyHighPeakPhaseToConfig(kf, KICK_PHASES.HIGH_PEAK);
+			kf.rotate(BoneName.PELVIS, -.2, -.6, 0);
+			kf.rotate(BoneName.SPINE_LOWER, -.2, -.3, 0);
+			kf.rotate(BoneName.SPINE_UPPER, -.15, -.2, 0);
+			kf.rotate(BoneName.HIP_L, 0, -.2, 0);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .5, 0);
+			kf.position(BoneName.FOOT_R, 0, 1.5, .3);
+			kf.rotate(BoneName.SHOULDER_L, -.9, .3, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -2);
+			kf.rotate(BoneName.SHOULDER_R, -.9, -.3, -.4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 2);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Axe kick chop - Downward heel strike for 내려차기
+	*
+	* Enhanced with hip rotation and guard hands
+	* @korean 내려차기
+	*/
+	axeKickChop(timeOffset = .1, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .8, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.15, 0, 0);
+			kf.rotate(BoneName.FOOT_R, -.3, 0, 0);
+			kf.rotate(BoneName.PELVIS, .1, -.6, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .1, -.3, 0);
+			kf.rotate(BoneName.KNEE_L, -.35, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .5, 0);
+			kf.position(BoneName.FOOT_R, 0, .5, .4);
+			kf.rotate(BoneName.SHOULDER_L, -.9, .3, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -2);
+			kf.rotate(BoneName.SHOULDER_R, -.9, -.3, -.4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 2);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Back kick spin - 180° turn for 뒤차기
+	*
+	* Authentic Taekwondo back kick spin (뒤차기 회전):
+	* - Body rotates 180° (pelvis -1.5 rad initially)
+	* - Spine rotates with body (lower: -1.3 rad, upper: -1.0 rad)
+	* - Head looks over shoulder (0.5 rad) to maintain target visual
+	* - Hip chambers (0.3 rad flex)
+	* - Knee bends (-0.8 rad) preparing for backward thrust
+	* - Support leg maintains balance
+	*
+	* Looking over the shoulder is CRITICAL - you must see the target
+	* to execute an accurate back kick. This is emphasized in all
+	* traditional Korean martial arts.
+	*
+	* @korean 뒤차기회전
+	*/
+	backKickSpin(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, -1.5, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -1.3, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -1, .1);
+			kf.rotate(BoneName.HEAD, 0, .5, 0);
+			kf.rotate(BoneName.HIP_R, .3, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.8, 0, 0);
+			kf.rotate(BoneName.FOOT_R, 0, 0, 0);
+			kf.rotate(BoneName.HIP_L, 0, -.4, 0);
+			kf.rotate(BoneName.KNEE_L, -.35, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, -1.57, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.6, .5, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -2);
+			kf.rotate(BoneName.SHOULDER_R, -.6, -.5, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 2);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Back kick thrust - Heel drives backward for 뒤차기
+	*
+	* Authentic Taekwondo back kick thrust (뒤차기 밀기):
+	* - Body completes 180° rotation (pelvis -3.14 rad = π)
+	* - Hip extends backward (0.5 rad flex maintained)
+	* - Knee extends fully (-0.2 rad) driving heel back
+	* - Foot dorsiflexes (-0.4 rad) presenting heel
+	* - Foot position extends backward (0 forward, 0 up, -0.8 back)
+	* - Head maintains target visual (1.0 rad look-back)
+	* - Spine fully rotated with body
+	* - Support leg powers the thrust
+	*
+	* The back kick delivers tremendous power because the entire
+	* body mass drives through the strongest leg muscles (glutes,
+	* hamstrings) in a straight line backward.
+	*
+	* @korean 뒤차기
+	*/
+	backKickThrust(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, -3.14, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -3, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -2.8, .2);
+			kf.rotate(BoneName.HEAD, 0, 1, 0);
+			kf.rotate(BoneName.HIP_R, .5, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.2, 0, 0);
+			kf.rotate(BoneName.FOOT_R, -.4, 0, 0);
+			kf.position(BoneName.FOOT_R, 0, 0, -.8);
+			kf.rotate(BoneName.HIP_L, 0, -.3, 0);
+			kf.rotate(BoneName.KNEE_L, -.5, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, -.3, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.6, .7, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.4);
+			kf.rotate(BoneName.SHOULDER_R, -.6, -.7, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.4);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Low kick chamber - Small knee lift for low kick (하단차기준비)
+	* @korean 하단차기준비
+	*/
+	lowKickChamber(timeOffset = .08, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .5, 0, .3);
+			kf.rotate(BoneName.KNEE_R, -.8, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			kf.rotate(BoneName.PELVIS, 0, -.2, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Low kick sweep - Shin sweeps at thigh height (하단차기)
+	* @korean 하단차기
+	*/
+	lowKickSweep(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .3, 0, 1.5);
+			kf.rotate(BoneName.KNEE_R, -.15, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .3, 0, .3);
+			kf.rotate(BoneName.PELVIS, 0, -1.2, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .6, 0);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Crescent kick chamber - Leg swings inward (반달차기준비)
+	* @korean 반달차기준비
+	*/
+	crescentKickChamber(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .8, 0, -.8);
+			kf.rotate(BoneName.KNEE_R, -.3, 0, 0);
+			kf.rotate(BoneName.PELVIS, 0, .3, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -.2, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Crescent kick arc - Leg sweeps across body (반달차기)
+	* @korean 반달차기
+	*/
+	crescentKickArc(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, 1.2, 0, 1);
+			kf.rotate(BoneName.KNEE_R, -.1, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .2, 0, 0);
+			kf.rotate(BoneName.PELVIS, 0, -.5, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .4, 0);
+			kf.position(BoneName.FOOT_R, .5, .8, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Push kick chamber - Ball of foot position (밀어차기준비)
+	*
+	* Enhanced with hip rotation and guard hand protection
+	* @korean 밀어차기준비
+	*/
+	pushKickChamber(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, 1.2, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -1.8, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .3, 0, 0);
+			kf.rotate(BoneName.HIP_L, 0, -.2, 0);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .4, 0);
+			kf.rotate(BoneName.PELVIS, -.1, -.3, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.9, .3, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -2);
+			kf.rotate(BoneName.SHOULDER_R, -.9, -.3, -.4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 2);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Push kick thrust - Foot pushes opponent back (밀어차기)
+	*
+	* Enhanced with hip rotation for power and guard hand protection
+	* @korean 밀어차기
+	*/
+	pushKickThrust(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, 1, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.15, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .5, 0, 0);
+			kf.rotate(BoneName.HIP_L, 0, -.3, 0);
+			kf.rotate(BoneName.KNEE_L, -.35, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .8, 0);
+			kf.rotate(BoneName.PELVIS, .1, -.6, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .05, -.3, 0);
+			kf.position(BoneName.FOOT_R, 0, 0, .5);
+			kf.rotate(BoneName.SHOULDER_L, -.9, .3, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -2);
+			kf.rotate(BoneName.SHOULDER_R, -.9, -.3, -.4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 2);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Spinning heel kick - 360° with heel strike (뒤돌려차기)
+	*
+	* Full 360° spin requires complete support foot pivot
+	* @korean 뒤돌려차기
+	*/
+	spinningHeelKick(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, -4.5, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -4.3, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -4, .15);
+			kf.rotate(BoneName.HIP_R, .8, 0, 1.2);
+			kf.rotate(BoneName.KNEE_R, -.2, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .3, 0, .2);
+			kf.position(BoneName.FOOT_R, .6, .5, 0);
+			kf.rotate(BoneName.HIP_L, 0, -.5, 0);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, -2.1, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.7, .4, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -2);
+			kf.rotate(BoneName.SHOULDER_R, -.7, -.4, -.4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 2);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Hook kick extension - Leg extends past target (후려차기 연장)
+	*
+	* Authentic Korean hook kick (후려차기) first phase:
+	* - Body rotates past perpendicular (~100°)
+	* - Leg extends past target like a missed side kick
+	* - Foot positioned to hook back toward target
+	* - Head maintains target visual
+	*
+	* The hook kick is distinct from crescent kick:
+	* - Crescent: sweeps ACROSS body
+	* - Hook: extends PAST, then hooks BACK
+	*
+	* @korean 후려차기연장
+	*/
+	hookKickExtend(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, -1.8, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -1.6, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -1.4, .1);
+			kf.rotate(BoneName.HEAD, 0, .6, 0);
+			kf.rotate(BoneName.HIP_R, 1.3, 0, .5);
+			kf.rotate(BoneName.KNEE_R, -.1, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .2, 0, .4);
+			kf.position(BoneName.FOOT_R, .3, .8, -.5);
+			kf.rotate(BoneName.HIP_L, 0, -.2, 0);
+			kf.rotate(BoneName.KNEE_L, -.35, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.5, .5, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.5);
+			kf.rotate(BoneName.SHOULDER_R, -.5, -.4, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.5);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Hook kick hook-back - Heel hooks back toward target (후려차기 후림)
+	*
+	* Authentic Korean hook kick (후려차기) second phase:
+	* - Leg retracts/hooks back toward target
+	* - Heel is the striking surface (발뒤꿈치)
+	* - Body rotates back toward target during hook
+	* - Snapping motion at knee for power
+	*
+	* The hook motion is what makes this kick unique:
+	* - Extends past, then HOOKS back
+	* - Catches opponent from unexpected angle
+	* - Heel strikes back of head or temple
+	*
+	* @korean 후려차기후림
+	*/
+	hookKickHook(timeOffset = .12, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, -1.3, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -1.2, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -1, .1);
+			kf.rotate(BoneName.HEAD, 0, .4, 0);
+			kf.rotate(BoneName.HIP_R, 1, 0, -.3);
+			kf.rotate(BoneName.KNEE_R, -.6, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .3, 0, -.4);
+			kf.position(BoneName.FOOT_R, 0, .8, .2);
+			kf.rotate(BoneName.HIP_L, 0, -.1, 0);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.6, .4, .2);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.4);
+			kf.rotate(BoneName.SHOULDER_R, -.5, -.3, -.2);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.4);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Tornado kick jump with 360° rotation (회전차기 도약)
+	*
+	* Authentic Korean tornado kick (회전차기) jump phase:
+	* - Jump with full 360° body rotation
+	* - Arms swing to generate rotational momentum
+	* - Body elevates during spin
+	* - Prepares for roundhouse at apex
+	*
+	* @korean 회전차기도약
+	*/
+	tornadoJump(timeOffset = .3) {
+		this.addKeyframe(this.currentTime + timeOffset * .4, "ease-out", (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, -3.14, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -3, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -2.8, 0);
+			kf.position(BoneName.PELVIS, 0, .3, 0);
+			kf.rotate(BoneName.HIP_R, .6, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -1.2, 0, 0);
+			kf.rotate(BoneName.HIP_L, .4, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -1, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.8, .6, .4);
+			kf.rotate(BoneName.SHOULDER_R, -.8, -.6, -.4);
+		});
+		this.addKeyframe(this.currentTime + timeOffset, "ease-in", (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, -6.28, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -6, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -5.8, 0);
+			kf.position(BoneName.PELVIS, 0, .5, 0);
+			kf.rotate(BoneName.HIP_R, 1, 0, .4);
+			kf.rotate(BoneName.KNEE_R, -1.5, 0, 0);
+			kf.rotate(BoneName.HIP_L, .3, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.6, .3, .3);
+			kf.rotate(BoneName.SHOULDER_R, -.6, -.3, -.3);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Punch chamber - Fist at hip with vertical palm (주먹준비자세)
+	* Korean martial arts chamber position with fist vertical (세로주먹)
+	* @param timeOffset Time offset in seconds
+	* @param hand Which hand to chamber ("left" | "right")
+	* @param easing Easing function
+	* @korean 주먹준비자세
+	*/
+	punchChamber(timeOffset = .1, hand = "right", easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyPunchPhaseToConfig(kf, PUNCH_PHASES.CHAMBER, hand, {
+				includeWrist: true,
+				includeOppositeArm: true,
+				includeSpineMiddle: false
+			});
+			this.applyHandPose(kf, HAND_POSES.FIST, hand);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Punch wind-up - Arm coils back (주먹준비)
+	* @param timeOffset Time offset in seconds
+	* @param hand Which hand to wind up ("left" | "right")
+	* @param easing Easing function
+	* @korean 주먹준비
+	*/
+	punchWindup(timeOffset = .08, hand = "right", easing = "linear") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyPunchPhaseToConfig(kf, PUNCH_PHASES.WINDUP, hand, { includeOppositeArm: true });
+			this.applyHandPose(kf, HAND_POSES.FIST, hand);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Punch extension - Arm extends with torso rotation (지르기)
+	* Includes fist rotation from vertical to pronated and hikite
+	*
+	* Enhanced with realistic torso rotation (허리비틀기):
+	* - Straight punches: 20° counter-rotation for power
+	* - Torso rotates OPPOSITE to punch direction
+	* - Sequential spine rotation (lower → mid → upper)
+	*
+	* @param timeOffset Time offset in seconds
+	* @param hand Which hand to extend ("left" | "right")
+	* @param easing Easing function
+	* @korean 지르기
+	*/
+	punchExtend(timeOffset = .07, hand = "right", easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyPunchPhaseToConfig(kf, PUNCH_PHASES.EXTENSION, hand, {
+				includeWrist: true,
+				includeSpineMiddle: true,
+				includeOppositeArm: true
+			});
+			this.applyPunchTorsoRotation(kf, hand, 20);
+			this.applyHandPose(kf, HAND_POSES.FIST, hand);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Punch peak - Maximum extension with full rotation (정점)
+	* Hold at full extension for impact frame
+	*
+	* Enhanced with sustained torso rotation at impact:
+	* - Maintains 20° counter-rotation at peak
+	* - Maximizes power transfer through spine
+	*
+	* @param timeOffset Time offset in seconds
+	* @param hand Which hand is extended ("left" | "right")
+	* @param easing Easing function
+	* @korean 정점
+	*/
+	punchPeak(timeOffset = .05, hand = "right", easing = "linear") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			applyPunchPhaseToConfig(kf, PUNCH_PHASES.PEAK, hand, {
+				includeWrist: true,
+				includeSpineMiddle: true,
+				includeOppositeArm: true
+			});
+			this.applyPunchTorsoRotation(kf, hand, 20);
+			this.applyHandPose(kf, HAND_POSES.FIST, hand);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Cross punch - Left arm punch with full body rotation (크로스)
+	* @korean 크로스
+	*/
+	crossPunch(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, -.7, -.3, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.05);
+			kf.rotate(BoneName.WRIST_L, 0, 0, .2);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -.45, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, 0, -.35, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -.25, 0);
+			kf.rotate(BoneName.PELVIS, 0, -.3, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Palm strike extension - Open palm heel strike (장권)
+	* @korean 장권
+	*/
+	palmStrike(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.7, .3, -.1);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .05);
+			kf.rotate(BoneName.WRIST_R, -.5, 0, .1);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .4, 0);
+			kf.rotate(BoneName.PELVIS, 0, .25, 0);
+			this.applyHandPose(kf, HAND_POSES.OPEN_PALM, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Hook punch - Circular punch targeting temple (후크)
+	* Enhanced with Korean martial arts shoulder rotation and hikite (당기기)
+	*
+	* Enhanced with realistic circular torso rotation (몸통회전):
+	* - Hook punches: 50° rotation for circular power
+	* - Torso rotates INTO the punch for arc generation
+	* - Sequential spine rotation creates whipping motion
+	*
+	* @param timeOffset Time offset in seconds
+	* @param hand Which hand is hooking ("left" | "right")
+	* @param easing Easing function
+	* @korean 후크
+	*/
+	hookPunch(timeOffset = .1, hand = "right", easing = "ease-out") {
+		const isRight = hand === "right";
+		const shoulderBone = isRight ? BoneName.SHOULDER_R : BoneName.SHOULDER_L;
+		const elbowBone = isRight ? BoneName.ELBOW_R : BoneName.ELBOW_L;
+		const wristBone = isRight ? BoneName.WRIST_R : BoneName.WRIST_L;
+		const oppositeShoulder = isRight ? BoneName.SHOULDER_L : BoneName.SHOULDER_R;
+		const oppositeElbow = isRight ? BoneName.ELBOW_L : BoneName.ELBOW_R;
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(shoulderBone, -.1, isRight ? .6 : -.6, isRight ? .4 : -.4);
+			kf.rotate(elbowBone, 0, 0, isRight ? 1.35 : -1.35);
+			kf.rotate(wristBone, 0, isRight ? .2 : -.2, 0);
+			kf.rotate(oppositeShoulder, -.2, 0, isRight ? -.3 : .3);
+			kf.rotate(oppositeElbow, 0, 0, isRight ? -1.1 : 1.1);
+			this.applyHookTorsoRotation(kf, hand, 50);
+			kf.rotate(BoneName.PELVIS, 0, isRight ? .35 : -.35, 0);
+			const rearFoot = isRight ? BoneName.FOOT_R : BoneName.FOOT_L;
+			const rearHip = isRight ? BoneName.HIP_R : BoneName.HIP_L;
+			kf.rotate(rearFoot, 0, isRight ? .4 : -.4, 0);
+			kf.rotate(rearHip, 0, isRight ? .25 : -.25, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, hand);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Hook wind-up - Arm pulls to side (후크준비)
+	* Enhanced with hikite (당기기) preparation
+	* @param timeOffset Time offset in seconds
+	* @param hand Which hand is hooking ("left" | "right")
+	* @param easing Easing function
+	* @korean 후크준비
+	*/
+	hookWindup(timeOffset = .08, hand = "right", easing = "linear") {
+		const isRight = hand === "right";
+		const shoulderBone = isRight ? BoneName.SHOULDER_R : BoneName.SHOULDER_L;
+		const elbowBone = isRight ? BoneName.ELBOW_R : BoneName.ELBOW_L;
+		const oppositeShoulder = isRight ? BoneName.SHOULDER_L : BoneName.SHOULDER_R;
+		const oppositeElbow = isRight ? BoneName.ELBOW_L : BoneName.ELBOW_R;
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(shoulderBone, .1, isRight ? -.6 : .6, isRight ? -.5 : .5);
+			kf.rotate(elbowBone, 0, 0, isRight ? 1.57 : -1.57);
+			kf.rotate(oppositeShoulder, -.1, 0, isRight ? .2 : -.2);
+			kf.rotate(oppositeElbow, 0, 0, isRight ? 1.4 : -1.4);
+			kf.rotate(BoneName.SPINE_UPPER, 0, isRight ? -.3 : .3, 0);
+			kf.rotate(BoneName.PELVIS, 0, isRight ? -.2 : .2, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, hand);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Uppercut punch - Rising punch to chin (어퍼컷)
+	* Enhanced with Korean martial arts leg drive and hikite (당기기)
+	* @param timeOffset Time offset in seconds
+	* @param hand Which hand is uppercutting ("left" | "right")
+	* @param easing Easing function
+	* @korean 어퍼컷
+	*/
+	uppercutPunch(timeOffset = .1, hand = "right", easing = "ease-out") {
+		const isRight = hand === "right";
+		const shoulderBone = isRight ? BoneName.SHOULDER_R : BoneName.SHOULDER_L;
+		const elbowBone = isRight ? BoneName.ELBOW_R : BoneName.ELBOW_L;
+		const oppositeShoulder = isRight ? BoneName.SHOULDER_L : BoneName.SHOULDER_R;
+		const oppositeElbow = isRight ? BoneName.ELBOW_L : BoneName.ELBOW_R;
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(shoulderBone, -.6, isRight ? .3 : -.3, isRight ? .8 : -.8);
+			kf.rotate(elbowBone, 0, 0, isRight ? 1.2 : -1.2);
+			kf.rotate(oppositeShoulder, -.2, 0, isRight ? -.3 : .3);
+			kf.rotate(oppositeElbow, 0, 0, isRight ? -1.1 : 1.1);
+			kf.rotate(BoneName.KNEE_L, .05, 0, 0);
+			kf.rotate(BoneName.KNEE_R, .05, 0, 0);
+			kf.rotate(BoneName.HIP_L, -.1, 0, 0);
+			kf.rotate(BoneName.HIP_R, -.1, 0, 0);
+			kf.rotate(BoneName.PELVIS, -.25, isRight ? .2 : -.2, 0);
+			kf.position(BoneName.PELVIS, 0, .15, .1);
+			this.applyHandPose(kf, HAND_POSES.FIST, hand);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Uppercut crouch - Dip before rising punch (어퍼컷준비)
+	* Enhanced with hikite (당기기) preparation
+	* @param timeOffset Time offset in seconds
+	* @param hand Which hand is uppercutting ("left" | "right")
+	* @param easing Easing function
+	* @korean 어퍼컷준비
+	*/
+	uppercutCrouch(timeOffset = .08, hand = "right", easing = "linear") {
+		const isRight = hand === "right";
+		const shoulderBone = isRight ? BoneName.SHOULDER_R : BoneName.SHOULDER_L;
+		const elbowBone = isRight ? BoneName.ELBOW_R : BoneName.ELBOW_L;
+		const oppositeShoulder = isRight ? BoneName.SHOULDER_L : BoneName.SHOULDER_R;
+		const oppositeElbow = isRight ? BoneName.ELBOW_L : BoneName.ELBOW_R;
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(shoulderBone, .3, 0, isRight ? .2 : -.2);
+			kf.rotate(elbowBone, 0, 0, isRight ? 1.5 : -1.5);
+			kf.rotate(oppositeShoulder, -.1, 0, isRight ? .2 : -.2);
+			kf.rotate(oppositeElbow, 0, 0, isRight ? 1.4 : -1.4);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.4, 0, 0);
+			kf.rotate(BoneName.PELVIS, .15, isRight ? -.1 : .1, 0);
+			kf.position(BoneName.PELVIS, 0, -.1, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, hand);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Overhand punch - Looping downward punch (오버핸드)
+	* @korean 오버핸드
+	*/
+	overhandPunch(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.3, .4, .8);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .8);
+			kf.rotate(BoneName.SPINE_UPPER, .2, .4, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, .15, .3, 0);
+			kf.rotate(BoneName.PELVIS, .1, .25, 0);
+			kf.position(BoneName.PELVIS, 0, -.05, .1);
+			this.applyHandPose(kf, HAND_POSES.HAMMER_FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Elbow strike chamber - Arm crosses body (팔꿈치준비)
+	* @korean 팔꿈치준비
+	*/
+	elbowChamber(timeOffset = .05, easing = "linear") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, 0, .8, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.57);
+			kf.rotate(BoneName.FOREARM_R, 0, -.5, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -.3, 0);
+			kf.position(BoneName.HAND_R, -.2, 0, .3);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Elbow strike - Elbow drives through target (팔꿈치치기)
+	* @korean 팔꿈치치기
+	*/
+	elbowStrike(timeOffset = .07, easing = "linear") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.3, .4, -.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.3);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .6, .15);
+			kf.rotate(BoneName.SPINE_MIDDLE, 0, .5, .1);
+			kf.rotate(BoneName.PELVIS, 0, .4, 0);
+			kf.position(BoneName.ELBOW_R, 0, 0, .7);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Elbow uppercut - Upward elbow strike (팔꿈치올려치기)
+	* @korean 팔꿈치올려치기
+	*/
+	elbowUppercut(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.6, .3, .8);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.4);
+			kf.rotate(BoneName.KNEE_L, -.05, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.05, 0, 0);
+			kf.rotate(BoneName.PELVIS, -.15, 0, 0);
+			kf.position(BoneName.PELVIS, 0, .08, .15);
+			kf.position(BoneName.ELBOW_R, 0, .7, .5);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Knee strike from clinch (무릎차기)
+	*
+	* Enhanced with hip rotation and proper clinch mechanics
+	* @korean 무릎차기
+	*/
+	kneeStrike(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, -.1, -.3, .6);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.8);
+			kf.rotate(BoneName.SHOULDER_R, -.1, .3, -.6);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.8);
+			kf.rotate(BoneName.HIP_R, 1.4, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.5, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .4, 0, 0);
+			kf.rotate(BoneName.PELVIS, .2, -.6, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .1, -.3, 0);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			kf.rotate(BoneName.HIP_L, 0, -.2, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .5, 0);
+			kf.position(BoneName.KNEE_R, 0, .4, .5);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Brachial elbow - Horizontal elbow to brachial nerve (상박치기)
+	* Targets the lateral neck/brachial plexus area
+	* @korean 상박치기
+	*/
+	brachialElbow(timeOffset = .08, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.3, .2, .8);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.6);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .8, .1);
+			kf.rotate(BoneName.SPINE_MIDDLE, 0, .6, .05);
+			kf.rotate(BoneName.PELVIS, 0, .5, 0);
+			kf.position(BoneName.ELBOW_R, .3, .2, .6);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Slashing elbow - Diagonal cutting elbow (베기팔꿈치)
+	* Diagonal slash across opponent's face/temple
+	* @korean 베기팔꿈치
+	*/
+	slashingElbow(timeOffset = .09, easing = "linear") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.6, .3, 1);
+			kf.rotate(BoneName.ELBOW_R, 0, .2, 1.2);
+			kf.rotate(BoneName.SPINE_UPPER, .2, .5, .15);
+			kf.rotate(BoneName.SPINE_MIDDLE, .1, .4, .1);
+			kf.rotate(BoneName.PELVIS, .05, .3, .05);
+			kf.position(BoneName.ELBOW_R, .2, .1, .6);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Spinal elbow - Downward elbow to spine (척추팔꿈치)
+	* Strikes spine from behind or above
+	* @korean 척추팔꿈치
+	*/
+	spinalElbow(timeOffset = .1, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.8, .4, .6);
+			kf.rotate(BoneName.ELBOW_R, 0, .3, 1);
+			kf.rotate(BoneName.SPINE_UPPER, .4, .3, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, .3, .2, 0);
+			kf.rotate(BoneName.PELVIS, .2, .2, 0);
+			kf.position(BoneName.ELBOW_R, .15, -.1, .7);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Side knee - Lateral knee to ribs (옆무릎)
+	* Clinch knee targeting opponent's side
+	* @korean 옆무릎
+	*/
+	sideKneeStrike(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .3, .4, -.6);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.6);
+			kf.rotate(BoneName.SHOULDER_R, .3, -.4, .6);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.6);
+			kf.rotate(BoneName.HIP_R, 1.2, 0, .4);
+			kf.rotate(BoneName.KNEE_R, -.4, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .3, 0, 0);
+			kf.rotate(BoneName.PELVIS, .1, -.4, .1);
+			kf.rotate(BoneName.SPINE_LOWER, .05, -.3, .05);
+			kf.rotate(BoneName.KNEE_L, -.25, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .4, 0);
+			kf.position(BoneName.KNEE_R, .3, .3, .4);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Flying knee - Jumping knee strike (뛰어무릎)
+	* Explosive airborne knee
+	* @korean 뛰어무릎
+	*/
+	flyingKnee(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, -.5, .3, -.4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.4);
+			kf.rotate(BoneName.SHOULDER_R, -.5, -.3, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.4);
+			kf.rotate(BoneName.HIP_R, 1.6, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.3, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .5, 0, 0);
+			kf.rotate(BoneName.HIP_L, -.3, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.1, 0, 0);
+			kf.rotate(BoneName.PELVIS, .3, -.5, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .2, -.3, 0);
+			kf.position(BoneName.PELVIS, 0, .4, .3);
+			kf.position(BoneName.KNEE_R, 0, .6, .6);
+			this.applyHandPose(kf, HAND_POSES.FIST, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Kidney knee - Knee to kidney from side (신장무릎)
+	* Targets kidney area from side clinch
+	* @korean 신장무릎
+	*/
+	kidneyKnee(timeOffset = .11, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .4, .5, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.5);
+			kf.rotate(BoneName.SHOULDER_R, .4, -.5, .5);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.5);
+			kf.rotate(BoneName.HIP_R, 1.3, .2, .3);
+			kf.rotate(BoneName.KNEE_R, -.45, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .35, .1, 0);
+			kf.rotate(BoneName.PELVIS, .15, -.5, .1);
+			kf.rotate(BoneName.SPINE_LOWER, .1, -.35, .05);
+			kf.rotate(BoneName.KNEE_L, -.22, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .45, 0);
+			kf.position(BoneName.KNEE_R, .25, .35, .45);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Femoral knee - Knee to femoral nerve (대퇴부무릎)
+	* Low knee targeting thigh/femoral nerve
+	* @korean 대퇴부무릎
+	*/
+	femoralKnee(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .5, .3, -.4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.3);
+			kf.rotate(BoneName.SHOULDER_R, .5, -.3, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.3);
+			kf.rotate(BoneName.HIP_R, 1.1, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.6, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .25, 0, 0);
+			kf.rotate(BoneName.PELVIS, .25, -.4, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .15, -.25, 0);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, .35, 0);
+			kf.position(BoneName.KNEE_R, 0, .2, .5);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Throat strike - Precise strike to trachea (기도격)
+	* Fingers extended targeting windpipe
+	* @korean 기도격
+	*/
+	throatStrike(timeOffset = .08, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.2, 0, .15);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .3);
+			kf.rotate(BoneName.WRIST_R, -.5, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, .3, .2, -.4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.6);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .15, 0);
+			kf.rotate(BoneName.PELVIS, 0, .1, 0);
+			this.applyHandPose(kf, HAND_POSES.KNIFE_HAND, "right");
+			this.applyHandPose(kf, HAND_POSES.FIST, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Temple strike - Precision temple elbow (관자놀이격)
+	* Horizontal elbow targeting temple
+	* @korean 관자놀이격
+	*/
+	templeElbow(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.8, .9, .7);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.7);
+			kf.rotate(BoneName.WRIST_R, .2, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, .3, .7, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.5);
+			kf.rotate(BoneName.SPINE_UPPER, .1, .55, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, 0, .4, 0);
+			kf.rotate(BoneName.PELVIS, 0, .35, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+			this.applyHandPose(kf, HAND_POSES.GRAB, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Nerve strike - Precision brachial plexus attack (신경격)
+	* Short sharp strike to nerve cluster
+	* @korean 신경격
+	*/
+	nerveStrike(timeOffset = .06, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, .1, .3, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .6);
+			kf.rotate(BoneName.WRIST_R, -.3, -.2, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.6, .3, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.4);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .12, 0);
+			kf.rotate(BoneName.PELVIS, 0, .08, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+			this.applyHandPose(kf, HAND_POSES.FIST, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Jugular strike - Knife hand to jugular vein (경정맥격)
+	* Slicing motion to jugular
+	* @korean 경정맥격
+	*/
+	jugularStrike(timeOffset = .08, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.4, .5, .35);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .4);
+			kf.rotate(BoneName.WRIST_R, -.4, .3, -.2);
+			kf.rotate(BoneName.SHOULDER_L, .2, -.3, -.3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.7);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .28, .05);
+			kf.rotate(BoneName.PELVIS, 0, .18, 0);
+			this.applyHandPose(kf, HAND_POSES.KNIFE_HAND, "right");
+			this.applyHandPose(kf, HAND_POSES.FIST, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Occipital strike - Palm heel to base of skull (후두부격)
+	* Upward palm strike to brain stem area
+	* @korean 후두부격
+	*/
+	occipitalStrike(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -1.1, .2, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .5);
+			kf.rotate(BoneName.WRIST_R, -.8, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, .5, .5, -.4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.2);
+			kf.rotate(BoneName.SPINE_UPPER, -.2, .2, 0);
+			kf.rotate(BoneName.PELVIS, -.1, .15, 0);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.OPEN_PALM, "right");
+			this.applyHandPose(kf, HAND_POSES.GRAB, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Jaw attack - Upward palm to jaw (턱격)
+	* Palm strike causing jaw dislocation
+	* @korean 턱격
+	*/
+	jawStrike(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.9, .1, .3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .3);
+			kf.rotate(BoneName.WRIST_R, -.6, 0, .1);
+			kf.rotate(BoneName.SHOULDER_L, .1, .3, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.5);
+			kf.rotate(BoneName.SPINE_UPPER, -.15, .22, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, -.1, .15, 0);
+			kf.rotate(BoneName.PELVIS, -.08, .12, 0);
+			kf.rotate(BoneName.KNEE_L, -.15, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.OPEN_PALM, "right");
+			this.applyHandPose(kf, HAND_POSES.FIST, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Eye gouge approach - Fingers to eyes (안격)
+	* Two finger strike to eyes
+	* @korean 안격
+	*/
+	eyeGouge(timeOffset = .06, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.35, .15, .25);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .2);
+			kf.rotate(BoneName.WRIST_R, -.2, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, .35, .45, -.35);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.3);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .08, 0);
+			kf.rotate(BoneName.NECK, -.1, .05, 0);
+			this.applyHandPose(kf, HAND_POSES.TWO_FINGER, "right");
+			this.applyHandPose(kf, HAND_POSES.GRAB, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Solar plexus strike - Deep body shot (명치격)
+	* Penetrating strike to solar plexus
+	* @korean 명치격
+	*/
+	solarPlexusStrike(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, .15, .05, .35);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .15);
+			kf.rotate(BoneName.WRIST_R, 0, 0, -.1);
+			kf.rotate(BoneName.SHOULDER_L, .25, -.3, -.35);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.8);
+			kf.rotate(BoneName.SPINE_UPPER, .08, .3, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, .05, .25, 0);
+			kf.rotate(BoneName.PELVIS, .05, .2, 0);
+			kf.position(BoneName.PELVIS, 0, 0, .08);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+			this.applyHandPose(kf, HAND_POSES.FIST, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Liver shot - Hook to liver area (간격)
+	* Hooking punch targeting liver
+	* @korean 간격
+	*/
+	liverShot(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.3, .6, .5);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.2);
+			kf.rotate(BoneName.WRIST_R, 0, .2, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.5, .2, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.5);
+			kf.rotate(BoneName.SPINE_UPPER, .05, .4, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, .03, .3, 0);
+			kf.rotate(BoneName.PELVIS, 0, .25, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+			this.applyHandPose(kf, HAND_POSES.FIST, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Kidney strike - Hook to kidney from behind (신장격)
+	* Rear kidney targeting hook
+	* @korean 신장격
+	*/
+	kidneyStrike(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, .1, .7, .6);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1);
+			kf.rotate(BoneName.WRIST_R, 0, .15, -.1);
+			kf.rotate(BoneName.SHOULDER_L, .4, .5, -.3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.2);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .5, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, 0, .4, 0);
+			kf.rotate(BoneName.PELVIS, 0, .35, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+			this.applyHandPose(kf, HAND_POSES.GRAB, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Spine strike - Downward elbow to spine (척추격)
+	* 12-6 elbow targeting spine
+	* @korean 척추격
+	*/
+	spineStrike(timeOffset = .12, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -1.3, .1, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.9);
+			kf.rotate(BoneName.WRIST_R, .3, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, .6, .4, -.35);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1);
+			kf.rotate(BoneName.SPINE_UPPER, .35, .1, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, .25, .08, 0);
+			kf.rotate(BoneName.PELVIS, .2, .05, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+			this.applyHandPose(kf, HAND_POSES.GRAB, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Groin strike - Low rising knee or palm (낭심격)
+	* Targeting groin area
+	* @korean 낭심격
+	*/
+	groinStrike(timeOffset = .08, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, .4, .1, .3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .4);
+			kf.rotate(BoneName.WRIST_R, -.5, 0, .2);
+			kf.rotate(BoneName.SHOULDER_L, -.4, .3, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.4);
+			kf.rotate(BoneName.SPINE_UPPER, .15, .15, 0);
+			kf.rotate(BoneName.PELVIS, .2, .1, 0);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.OPEN_PALM, "right");
+			this.applyHandPose(kf, HAND_POSES.FIST, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Throw entry - Step in and grab (던지기진입)
+	* @korean 던지기진입
+	*/
+	throwEntry(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .6, .5, -.3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1);
+			kf.rotate(BoneName.SHOULDER_R, .8, -.3, .2);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.2);
+			kf.rotate(BoneName.PELVIS, 0, .8, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .5, 0);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.3, 0, 0);
+			kf.position(BoneName.PELVIS, 0, -.05, .2);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Throw execution - Hip under and throw (던지기)
+	* @korean 던지기
+	*/
+	throwExecute(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, -.4, .8, -.8);
+			kf.rotate(BoneName.SHOULDER_R, -.2, -.6, .6);
+			kf.rotate(BoneName.PELVIS, .5, 1.8, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .6, 1.5, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .7, 1.2, -.2);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.2, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Joint lock application (관절기)
+	* @korean 관절기
+	*/
+	jointLock(timeOffset = .15, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, -.1, 1, -.6);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.7);
+			kf.rotate(BoneName.WRIST_L, 0, -.6, -.4);
+			kf.rotate(BoneName.SHOULDER_R, .1, -.8, .7);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.4);
+			kf.rotate(BoneName.PELVIS, .15, .6, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .25, .4, -.2);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.position(BoneName.PELVIS, 0, -.1, .05);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Wrist lock grab - Two-hand wrist control (손목잡기)
+	* @korean 손목잡기
+	*/
+	wristGrab(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, .2, .3, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1);
+			kf.rotate(BoneName.WRIST_R, .3, -.4, .2);
+			kf.rotate(BoneName.SHOULDER_L, .3, .4, -.3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.2);
+			kf.rotate(BoneName.WRIST_L, -.2, .3, 0);
+			kf.rotate(BoneName.PELVIS, 0, .2, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Wrist lock twist - Apply rotational pressure (손목꺾기)
+	* @korean 손목꺾기
+	*/
+	wristTwist(timeOffset = .15, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.1, .5, .6);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.3);
+			kf.rotate(BoneName.WRIST_R, .5, -.5, .4);
+			kf.rotate(BoneName.SHOULDER_L, .1, .6, -.4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.4);
+			kf.rotate(BoneName.WRIST_L, -.3, .4, -.2);
+			kf.rotate(BoneName.PELVIS, 0, .4, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .1, .3, 0);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Arm bar entry - Wrap arm across body (팔꺾기진입)
+	* @korean 팔꺾기진입
+	*/
+	armBarEntry(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, .2, .6, .5);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.4);
+			kf.rotate(BoneName.SHOULDER_L, .3, .5, -.4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.3);
+			kf.rotate(BoneName.PELVIS, .2, .5, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .1, .4, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Arm bar drop - Go to ground for submission (팔꺾기)
+	* @korean 팔꺾기
+	*/
+	armBarDrop(timeOffset = .2, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.3, .9, .8);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.6);
+			kf.rotate(BoneName.SHOULDER_L, 0, .8, -.6);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.6);
+			kf.rotate(BoneName.PELVIS, 1, .2, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .7, .15, 0);
+			kf.rotate(BoneName.HIP_R, 1.4, 0, .4);
+			kf.rotate(BoneName.KNEE_R, -.3, 0, 0);
+			kf.rotate(BoneName.HIP_L, 1.2, 0, -.3);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			kf.position(BoneName.PELVIS, 0, -.4, -.1);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Slam lift - Hoist opponent up (슬램올리기)
+	* @korean 슬램올리기
+	*/
+	slamLift(timeOffset = .2, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .9, .2, -.3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.8);
+			kf.rotate(BoneName.SHOULDER_R, .9, -.2, .3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .8);
+			kf.rotate(BoneName.KNEE_L, -.1, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.1, 0, 0);
+			kf.rotate(BoneName.PELVIS, -.3, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, -.2, 0, 0);
+			kf.position(BoneName.PELVIS, 0, .1, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Slam down - Drive opponent to ground (슬램)
+	* @korean 슬램
+	*/
+	slamDown(timeOffset = .15, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .3, .3, -.6);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.4);
+			kf.rotate(BoneName.SHOULDER_R, .3, -.3, .6);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.4);
+			kf.rotate(BoneName.KNEE_L, -.6, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.6, 0, 0);
+			kf.rotate(BoneName.PELVIS, .4, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .3, 0, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, .2, 0, 0);
+			kf.position(BoneName.PELVIS, 0, -.15, .2);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Hip throw - Classic hip projection (배대되치기)
+	* Rotating hip throw with arm control
+	* @korean 배대되치기
+	*/
+	hipThrow(timeOffset = .18, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, .3, 2, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .4, 1.6, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .5, 1.3, -.15);
+			kf.rotate(BoneName.SHOULDER_L, -.5, .9, -.7);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.8);
+			kf.rotate(BoneName.SHOULDER_R, -.3, -.5, .5);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.3);
+			kf.rotate(BoneName.KNEE_L, -.5, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.35, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Takedown entry - Shoot and grab legs (태클진입)
+	* Double leg takedown initiation
+	* @korean 태클진입
+	*/
+	takedownShoot(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, .7, .1, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .5, .08, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .4, .05, 0);
+			kf.rotate(BoneName.SHOULDER_L, .6, .4, -.35);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.6);
+			kf.rotate(BoneName.SHOULDER_R, .6, -.4, .35);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .6);
+			kf.rotate(BoneName.KNEE_L, -.8, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -1.2, 0, 0);
+			kf.rotate(BoneName.HIP_R, .6, 0, 0);
+			kf.position(BoneName.PELVIS, 0, -.25, .15);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Takedown finish - Lift and dump (태클완료)
+	* Complete the takedown with dump
+	* @korean 태클완료
+	*/
+	takedownDump(timeOffset = .15, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, .2, .5, 0);
+			kf.rotate(BoneName.SPINE_LOWER, .15, .4, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .1, .35, -.1);
+			kf.rotate(BoneName.SHOULDER_L, .4, .6, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.1);
+			kf.rotate(BoneName.SHOULDER_R, .4, -.6, .5);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.1);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.5, 0, 0);
+			kf.position(BoneName.PELVIS, 0, -.1, .25);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Elbow lock application - Arm bar pressure (팔꿈치꺾기)
+	* Specific elbow hyperextension lock
+	* @korean 팔꿈치꺾기
+	*/
+	elbowLockApply(timeOffset = .18, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, .3, .7, .6);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.5);
+			kf.rotate(BoneName.WRIST_R, .2, -.3, .1);
+			kf.rotate(BoneName.SHOULDER_L, .2, .8, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.6);
+			kf.rotate(BoneName.WRIST_L, -.2, .35, -.1);
+			kf.rotate(BoneName.PELVIS, -.15, .4, 0);
+			kf.rotate(BoneName.SPINE_UPPER, -.25, .35, 0);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.35, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Shoulder lock twist - Shoulder manipulation (어깨꺾기)
+	* Rotational shoulder joint attack
+	* @korean 어깨꺾기
+	*/
+	shoulderLockTwist(timeOffset = .2, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.2, .9, .8);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.2);
+			kf.rotate(BoneName.WRIST_R, .4, -.5, .3);
+			kf.rotate(BoneName.SHOULDER_L, .5, .7, -.4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1);
+			kf.rotate(BoneName.PELVIS, 0, .7, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .1, .55, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, .05, .45, 0);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Finger manipulation - Small joint lock (손가락비틀기)
+	* Precise finger control technique
+	* @korean 손가락비틀기
+	*/
+	fingerLockTwist(timeOffset = .12, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, .15, .4, .35);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .9);
+			kf.rotate(BoneName.WRIST_R, .5, -.6, .4);
+			kf.rotate(BoneName.SHOULDER_L, .2, .5, -.3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1);
+			kf.rotate(BoneName.WRIST_L, -.3, .5, -.2);
+			kf.rotate(BoneName.PELVIS, 0, .25, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .08, .2, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Choke grip - Rear naked choke position (교살잡기)
+	* Setting up blood choke
+	* @korean 교살잡기
+	*/
+	chokeGrip(timeOffset = .15, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.4, .6, .7);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.8);
+			kf.rotate(BoneName.WRIST_R, .2, .3, 0);
+			kf.rotate(BoneName.SHOULDER_L, -.6, .5, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.9);
+			kf.rotate(BoneName.WRIST_L, 0, .2, -.1);
+			kf.rotate(BoneName.SPINE_UPPER, .2, .2, 0);
+			kf.rotate(BoneName.PELVIS, .15, .15, 0);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.35, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "right");
+			this.applyHandPose(kf, HAND_POSES.GRAB, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Ground control - Mounted position (마운트)
+	* Dominant ground position
+	* @korean 마운트
+	*/
+	groundMount(timeOffset = .2, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, .4, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .15, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, .4, .3, -.4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.8);
+			kf.rotate(BoneName.SHOULDER_R, .4, -.3, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .8);
+			kf.rotate(BoneName.HIP_L, .8, 0, -.6);
+			kf.rotate(BoneName.KNEE_L, -1.4, 0, 0);
+			kf.rotate(BoneName.HIP_R, .8, 0, .6);
+			kf.rotate(BoneName.KNEE_R, -1.4, 0, 0);
+			kf.position(BoneName.PELVIS, 0, -.4, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Clinch grab - Arms wrap around opponent (클린치잡기)
+	* @korean 클린치잡기
+	*/
+	clinchGrab(timeOffset = .12, easing = "ease-out") {
+		const clinch = MARTIAL_POSES.CLINCH;
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, ...clinch.leftShoulder);
+			kf.rotate(BoneName.ELBOW_L, ...clinch.leftElbow);
+			kf.rotate(BoneName.SHOULDER_R, ...clinch.rightShoulder);
+			kf.rotate(BoneName.ELBOW_R, ...clinch.rightElbow);
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.4, 0, 0);
+			kf.rotate(BoneName.PELVIS, .2, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.GRAB, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Counter parry - Quick deflection (반격막기)
+	* @korean 반격막기
+	*/
+	counterParry(timeOffset = .08, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .2, .5, -.6);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.9);
+			kf.rotate(BoneName.WRIST_L, 0, .3, 0);
+			kf.rotate(BoneName.SHOULDER_R, .1, 0, -.2);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.5);
+			kf.rotate(BoneName.PELVIS, 0, -.2, 0);
+			this.applyHandPose(kf, HAND_POSES.OPEN_PALM, "left");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Counter strike - Fast return strike (반격치기)
+	* @korean 반격치기
+	*/
+	counterStrike(timeOffset = .08, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_R, -.6, 0, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .1);
+			kf.rotate(BoneName.WRIST_R, 0, 0, -.2);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .35, 0);
+			kf.rotate(BoneName.SPINE_MIDDLE, 0, .25, 0);
+			kf.rotate(BoneName.PELVIS, 0, .2, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Sweep - Low sweeping leg (걸기)
+	* @korean 걸기
+	*/
+	sweep(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.KNEE_L, -1.2, 0, 0);
+			kf.rotate(BoneName.HIP_R, .5, 0, 1.5);
+			kf.rotate(BoneName.KNEE_R, -.15, 0, 0);
+			kf.rotate(BoneName.PELVIS, .3, -.8, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .5, -.4, 0);
+			kf.position(BoneName.FOOT_R, .8, -.1, 0);
+			kf.position(BoneName.PELVIS, .1, -.3, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Counter parry - Deflect incoming attack (막기)
+	* @korean 막기
+	*/
+	parry(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .2, .5, -.8);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.8);
+			kf.rotate(BoneName.WRIST_L, 0, .4, 0);
+			kf.rotate(BoneName.PELVIS, 0, -.3, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -.2, 0);
+			kf.rotate(BoneName.KNEE_L, -.3, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.OPEN_PALM, "left");
+			this.applyHandPose(kf, HAND_POSES.FIST, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* High block defensive pose (상단막기)
+	* @korean 상단막기
+	*/
+	blockHigh(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, -1, .3, -.6);
+			kf.rotate(BoneName.SHOULDER_R, -1, -.3, .6);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.3);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.3);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Low block defensive pose (하단막기)
+	* @korean 하단막기
+	*/
+	blockLow(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, .3, .2, -.4);
+			kf.rotate(BoneName.SHOULDER_R, .3, -.2, .4);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.6);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, .6);
+			kf.rotate(BoneName.KNEE_L, -.35, 0, 0);
+			kf.rotate(BoneName.PELVIS, .1, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Mid-section block - Standard middle block (중단막기)
+	* Arms crossed protecting torso
+	* @korean 중단막기
+	*/
+	blockMiddle(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, -.4, .5, -.5);
+			kf.rotate(BoneName.SHOULDER_R, .2, 0, .3);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -1.1);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.4);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -.15, 0);
+			kf.rotate(BoneName.KNEE_L, -.25, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Knife hand block - Open hand deflection (수도막기)
+	* Blade of hand for blocking
+	* @korean 수도막기
+	*/
+	blockKnifeHand(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SHOULDER_L, -.5, .6, -.5);
+			kf.rotate(BoneName.ELBOW_L, 0, 0, -.7);
+			kf.rotate(BoneName.WRIST_L, -.3, .4, 0);
+			kf.rotate(BoneName.SHOULDER_R, .3, .2, .4);
+			kf.rotate(BoneName.ELBOW_R, 0, 0, 1.3);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -.1, 0);
+			kf.rotate(BoneName.KNEE_L, -.25, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.KNIFE_HAND, "left");
+			this.applyHandPose(kf, HAND_POSES.KNIFE_HAND, "right");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Step forward or backward (스텝)
+	* @korean 스텝
+	*/
+	step(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .3, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.4, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			kf.position(BoneName.PELVIS, 0, 0, .1);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Forward step - Advancing stance (전진)
+	* Weight transfers forward with lead foot
+	* @korean 전진
+	*/
+	forwardStep(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .35, .1, 0);
+			kf.rotate(BoneName.KNEE_R, -.3, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .1, 0, 0);
+			kf.rotate(BoneName.HIP_L, -.1, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.15, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .05, 0, 0);
+			kf.position(BoneName.PELVIS, 0, 0, .15);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Backward step - Retreating stance (후진)
+	* Weight transfers backward with rear foot
+	* @korean 후진
+	*/
+	backwardStep(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, -.1, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.25, 0, 0);
+			kf.rotate(BoneName.HIP_L, .25, .1, 0);
+			kf.rotate(BoneName.KNEE_L, -.35, 0, 0);
+			kf.rotate(BoneName.FOOT_L, .1, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, -.05, 0, 0);
+			kf.position(BoneName.PELVIS, 0, 0, -.15);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Side step left - Lateral evasion (좌측이동)
+	* Quick lateral movement to the left
+	* @korean 좌측이동
+	*/
+	sideStepLeft(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_L, .1, 0, -.3);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			kf.rotate(BoneName.HIP_R, .05, 0, -.15);
+			kf.rotate(BoneName.KNEE_R, -.25, 0, 0);
+			kf.rotate(BoneName.PELVIS, 0, -.1, 0);
+			kf.position(BoneName.PELVIS, -.2, 0, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Side step right - Lateral evasion (우측이동)
+	* Quick lateral movement to the right
+	* @korean 우측이동
+	*/
+	sideStepRight(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .1, 0, .3);
+			kf.rotate(BoneName.KNEE_R, -.2, 0, 0);
+			kf.rotate(BoneName.HIP_L, .05, 0, .15);
+			kf.rotate(BoneName.KNEE_L, -.25, 0, 0);
+			kf.rotate(BoneName.PELVIS, 0, .1, 0);
+			kf.position(BoneName.PELVIS, .2, 0, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Lateral shift movement (측면이동)
+	* @korean 측면이동
+	*/
+	shift(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.KNEE_L, -.25, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.25, 0, 0);
+			kf.rotate(BoneName.PELVIS, 0, .2, 0);
+			kf.position(BoneName.PELVIS, .15, 0, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Rotation/pivot movement (회전)
+	* @korean 회전
+	*/
+	rotate(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, .78, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, .5, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .3, 0);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Full 360° spin (회전)
+	* @korean 전체회전
+	*/
+	spin(timeOffset = .2, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, 3.14, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, 2.8, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, 2.5, 0);
+			kf.rotate(BoneName.HEAD, 0, .5, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Spinning kick finish (회전차기)
+	* @korean 회전차기
+	*/
+	spinKick(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .8, 0, 1.2);
+			kf.rotate(BoneName.KNEE_R, -.2, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .3, 0, .2);
+			kf.position(BoneName.FOOT_R, .5, .3, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Jump/hop movement (점프)
+	* @korean 점프
+	*/
+	jump(timeOffset = .15, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.KNEE_L, -.4, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.4, 0, 0);
+			kf.rotate(BoneName.FOOT_L, .3, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .3, 0, 0);
+			kf.position(BoneName.PELVIS, 0, .15, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Duck/crouch movement (숙이기)
+	* @korean 숙이기
+	*/
+	duck(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.KNEE_L, -.6, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.6, 0, 0);
+			kf.rotate(BoneName.PELVIS, .15, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .2, 0, 0);
+			kf.position(BoneName.PELVIS, 0, -.15, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Lean back movement (뒤로젖히기)
+	* @korean 뒤로젖히기
+	*/
+	lean(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.SPINE_LOWER, -.2, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, -.25, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.15, 0, 0);
+			kf.rotate(BoneName.PELVIS, -.1, 0, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Bob head movement (헤드밥)
+	* @korean 헤드밥
+	*/
+	bob(timeOffset = .08, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.KNEE_L, -.35, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.35, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .15, .2, 0);
+			kf.rotate(BoneName.HEAD, .1, .1, 0);
+			kf.position(BoneName.PELVIS, .05, -.08, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Weave movement (위브)
+	* @korean 위브
+	*/
+	weave(timeOffset = .1, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.KNEE_L, -.25, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.4, 0, 0);
+			kf.rotate(BoneName.SPINE_UPPER, .1, -.25, 0);
+			kf.rotate(BoneName.HEAD, .05, -.15, 0);
+			kf.position(BoneName.PELVIS, -.05, -.05, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Roundhouse kick extension (돌려차기)
+	* @korean 돌려차기
+	*/
+	roundhouse(timeOffset = .12, easing = "ease-out") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, 1.2, 0, 1.6);
+			kf.rotate(BoneName.KNEE_R, -.1, 0, 0);
+			kf.rotate(BoneName.FOOT_R, .4, 0, .3);
+			kf.rotate(BoneName.PELVIS, 0, -1.5, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, .8, 0);
+			kf.position(BoneName.FOOT_R, .8, 0, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Axe kick downward motion (내려차기)
+	* @korean 내려차기
+	*/
+	axeKick(timeOffset = .1, easing = "ease-in") {
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, .8, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.15, 0, 0);
+			kf.rotate(BoneName.FOOT_R, -.3, 0, 0);
+			kf.rotate(BoneName.PELVIS, .1, 0, 0);
+			kf.position(BoneName.FOOT_R, 0, .5, .4);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Apply fighting guard - Hands protect face (경계자세)
+	* @korean 경계자세
+	*/
+	withGuard() {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) {
+			applyMartialPoseToKeyframe(lastKf, MARTIAL_POSES.GUARD);
+			this.applyHandPoseToKeyframe(lastKf, HAND_POSES.FIST, "both");
+		}
+		return this;
+	}
+	/**
+	* Apply high guard - Hands at temple (상단방어)
+	* @korean 상단방어
+	*/
+	withHighGuard() {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) applyMartialPoseToKeyframe(lastKf, MARTIAL_POSES.HIGH_GUARD);
+		return this;
+	}
+	/**
+	* Apply Korean guard position helper
+	*
+	* Private helper method to reduce code duplication across guard methods.
+	* Applies guard positions to the last keyframe in the animation.
+	*
+	* @param guardType - Type of guard to apply
+	* @param side - Which side to apply ("left" | "right" | "both")
+	* @returns this for chaining
+	* @korean 한국방어자세적용헬퍼
+	* @private
+	*/
+	applyKoreanGuard(guardType, side = "both") {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) {
+			const kf = new KeyframeConfig();
+			kf.withGuard(guardType, side);
+			for (const [bone, rotation] of kf.rotations.entries()) lastKf.boneRotations.set(bone, rotation);
+			this.applyHandPoseToKeyframe(lastKf, HAND_POSES.FIST, side);
+		}
+		return this;
+	}
+	/**
+	* Apply Korean high guard position (상단막기)
+	*
+	* Traditional Korean martial arts high guard with hands at temple level
+	* protecting head and face. Uses authentic 막기자세 positioning.
+	*
+	* @param side - Which side to apply ("left" | "right" | "both")
+	* @returns this for chaining
+	* @korean 상단막기자세
+	*/
+	withKoreanHighGuard(side = "both") {
+		return this.applyKoreanGuard("HIGH_GUARD", side);
+	}
+	/**
+	* Apply Korean middle guard position (중단막기)
+	*
+	* Standard Korean martial arts guard at chest/solar plexus level.
+	* Most versatile guard position, used in most fighting stances.
+	*
+	* @param side - Which side to apply ("left" | "right" | "both")
+	* @returns this for chaining
+	* @korean 중단막기자세
+	*/
+	withKoreanMiddleGuard(side = "both") {
+		return this.applyKoreanGuard("MIDDLE_GUARD", side);
+	}
+	/**
+	* Apply Korean low guard position (하단막기)
+	*
+	* Low guard position protecting lower body and groin.
+	* Used in grappling and ground-fighting scenarios.
+	*
+	* @param side - Which side to apply ("left" | "right" | "both")
+	* @returns this for chaining
+	* @korean 하단막기자세
+	*/
+	withKoreanLowGuard(side = "both") {
+		return this.applyKoreanGuard("LOW_GUARD", side);
+	}
+	/**
+	* Apply trigram-specific guard pose (팔괘자세)
+	*
+	* Sets the complete body position for the specified trigram stance,
+	* including arms, legs, torso, and pelvis. Unlike generic guards,
+	* this applies the authentic Korean martial arts posture for each
+	* of the eight trigram stances.
+	*
+	* Use this for:
+	* - Idle stance animations
+	* - Returning to guard after techniques
+	* - Walk/run animations (arms only mode)
+	*
+	* @param stance - Trigram stance (e.g., TrigramStance.GEON)
+	* @param options - Application options (what body parts to apply)
+	* @returns this for chaining
+	*
+	* @example
+	* ```typescript
+	* // Full guard pose in idle stance
+	* builder.at(0).withTrigramGuard(TrigramStance.GEON);
+	*
+	* // Arms only for walk animation (legs handled separately)
+	* builder.at(0).withTrigramGuard(TrigramStance.TAE, {
+	*   includeLegs: false,
+	*   includePelvis: false
+	* });
+	* ```
+	*
+	* @korean 팔괘방어자세
+	*/
+	withTrigramGuard(stance, options) {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) {
+			const kf = new KeyframeConfig();
+			applyTrigramGuardToConfig(kf, stance, options);
+			for (const [bone, rotation] of kf.rotations.entries()) lastKf.boneRotations.set(bone, rotation);
+			this.applyHandPoseToKeyframe(lastKf, HAND_POSES.FIST, "both");
+		}
+		return this;
+	}
+	/**
+	* Get trigram guard arm positions for locomotion animations
+	*
+	* Returns the base arm positions for the specified trigram's guard pose.
+	* Use this when building walk/run animations that need to maintain
+	* the trigram's arm guard while adding swing motion.
+	*
+	* @param stance - Trigram stance
+	* @returns Left and right arm base rotations (shoulder, elbow)
+	*
+	* @example
+	* ```typescript
+	* const arms = builder.getTrigramArmGuard(TrigramStance.GEON);
+	* // Add swing to left shoulder while keeping guard shape
+	* kf.rotate(BoneName.SHOULDER_L,
+	*   arms.left.shoulder[0] + swingOffset,
+	*   arms.left.shoulder[1],
+	*   arms.left.shoulder[2]
+	* );
+	* ```
+	*
+	* @korean 팔괘팔자세가져오기
+	*/
+	static getTrigramArmGuard(stance) {
+		return getGuardArmBase(stance);
+	}
+	/**
+	* Apply clinch position (클린치)
+	* @korean 클린치
+	*/
+	withClinch() {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) applyMartialPoseToKeyframe(lastKf, MARTIAL_POSES.CLINCH);
+		return this;
+	}
+	/**
+	* Helper to apply finger rotations from a hand pose to a keyframe
+	* @internal
+	*/
+	applyHandPose(kf, pose, hand) {
+		applyHandPoseToConfig(kf, pose, hand);
+	}
+	/**
+	* Apply open palm pose - Palm strikes and blocks (장권)
+	* @param hand Which hand(s) to apply the pose to
+	* @korean 손바닥펴기
+	*/
+	withOpenPalm(hand = "both") {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) this.applyHandPoseToKeyframe(lastKf, HAND_POSES.OPEN_PALM, hand);
+		return this;
+	}
+	/**
+	* Apply spear hand pose - Finger strikes to throat/eyes (관수)
+	* @param hand Which hand(s) to apply the pose to
+	* @korean 관수펴기
+	*/
+	withSpearHand(hand = "both") {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) this.applyHandPoseToKeyframe(lastKf, HAND_POSES.SPEAR_HAND, hand);
+		return this;
+	}
+	/**
+	* Apply backfist pose - Knuckle strikes (등주먹)
+	* @param hand Which hand(s) to apply the pose to
+	* @korean 등주먹
+	*/
+	withBackfist(hand = "both") {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) this.applyHandPoseToKeyframe(lastKf, HAND_POSES.BACKFIST, hand);
+		return this;
+	}
+	/**
+	* Apply grab pose - Grappling and holds (잡기)
+	* @param hand Which hand(s) to apply the pose to
+	* @korean 잡기손
+	*/
+	withGrab(hand = "both") {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		if (lastKf) this.applyHandPoseToKeyframe(lastKf, HAND_POSES.GRAB, hand);
+		return this;
+	}
+	/**
+	* Helper to apply finger rotations from a hand pose to an existing keyframe
+	* @internal
+	*/
+	applyHandPoseToKeyframe(kf, pose, hand) {
+		applyHandPoseToKeyframe(kf, pose, hand);
+	}
+	/**
+	* Apply hand pose during a keyframe (inline version for addKeyframe)
+	* @param pose The hand pose to apply
+	* @param hand Which hand(s) to apply the pose to
+	* @korean 손모양적용
+	*/
+	applyHandPoseDuring(kf, pose, hand = "both") {
+		this.applyHandPose(kf, HAND_POSES[pose], hand);
+	}
+	/**
+	* Apply foot positions based on stance width (발너비)
+	* Sets left and right foot X positions symmetrically around center
+	*
+	* @param stanceWidthMultiplier - Multiplier from KOREAN_STANCE_BIOMECHANICS
+	* @param shoulderWidth - Fighter's shoulder width in centimeters
+	* @korean 발너비적용
+	*
+	* @example
+	* ```typescript
+	* // Jin Thunder stance (2.0x shoulder width)
+	* .withFootWidth(2.0, 46)  // 0.92m total width
+	*
+	* // Son Wind stance (0.0x - crane stance)
+	* .withFootWidth(0.0, 46)  // 0m - single leg
+	* ```
+	*/
+	withFootWidth(stanceWidthMultiplier, shoulderWidth) {
+		const lastKf = this.keyframes[this.keyframes.length - 1];
+		const bonePositions = lastKf?.bonePositions;
+		if (bonePositions) {
+			const halfWidth = calculateStanceWidth(stanceWidthMultiplier, shoulderWidth) / 2;
+			const newPositions = /* @__PURE__ */ new Map();
+			bonePositions.forEach((pos, bone) => {
+				newPositions.set(bone, pos);
+			});
+			newPositions.set(BoneName.FOOT_L, new THREE.Vector3(-halfWidth, 0, 0));
+			newPositions.set(BoneName.FOOT_R, new THREE.Vector3(halfWidth, 0, 0));
+			lastKf.bonePositions = newPositions;
+		}
+		return this;
+	}
+	/**
+	* Apply foot positions to current keyframe during addKeyframe
+	* Inline version for use within keyframe callback
+	*
+	* @param kf - KeyframeConfig to modify
+	* @param stanceWidthMultiplier - Multiplier from KOREAN_STANCE_BIOMECHANICS
+	* @param shoulderWidth - Fighter's shoulder width in centimeters
+	* @korean 발너비설정
+	*/
+	applyFootPositionsDuring(kf, stanceWidthMultiplier, shoulderWidth) {
+		const halfWidth = calculateStanceWidth(stanceWidthMultiplier, shoulderWidth) / 2;
+		kf.position(BoneName.FOOT_L, -halfWidth, 0, 0);
+		kf.position(BoneName.FOOT_R, halfWidth, 0, 0);
+	}
+	/**
+	* Recover to fighting guard (복귀)
+	* Returns to neutral stance with torso reset
+	* @korean 복귀
+	*/
+	recover(timeOffset = .1, easing = "ease-in") {
+		const guard = MARTIAL_POSES.GUARD;
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.HIP_R, 0, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.2, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.2, 0, 0);
+			kf.rotate(BoneName.FOOT_R, 0, 0, 0);
+			kf.rotate(BoneName.FOOT_L, 0, 0, 0);
+			kf.rotate(BoneName.PELVIS, 0, 0, 0);
+			this.resetTorsoRotation(kf);
+			kf.rotate(BoneName.SHOULDER_L, ...guard.leftShoulder);
+			kf.rotate(BoneName.ELBOW_L, ...guard.leftElbow);
+			kf.rotate(BoneName.SHOULDER_R, ...guard.rightShoulder);
+			kf.rotate(BoneName.ELBOW_R, ...guard.rightElbow);
+			kf.position(BoneName.PELVIS, 0, 0, 0);
+			kf.position(BoneName.FOOT_R, 0, 0, 0);
+			this.applyHandPose(kf, HAND_POSES.FIST, "both");
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Full 360° spin recovery (회전복귀)
+	* @korean 회전복귀
+	*/
+	spinRecover(timeOffset = .2, easing = "ease-in") {
+		const guard = MARTIAL_POSES.GUARD;
+		this.addKeyframe(this.currentTime + timeOffset, easing, (kf) => {
+			kf.rotate(BoneName.PELVIS, 0, -6.28, 0);
+			kf.rotate(BoneName.SPINE_LOWER, 0, -6.28, 0);
+			kf.rotate(BoneName.SPINE_UPPER, 0, -6.28, 0);
+			kf.rotate(BoneName.HEAD, 0, 0, 0);
+			kf.rotate(BoneName.HIP_R, 0, 0, 0);
+			kf.rotate(BoneName.KNEE_R, -.2, 0, 0);
+			kf.rotate(BoneName.KNEE_L, -.25, 0, 0);
+			kf.rotate(BoneName.SHOULDER_L, ...guard.leftShoulder);
+			kf.rotate(BoneName.ELBOW_L, ...guard.leftElbow);
+			kf.rotate(BoneName.SHOULDER_R, ...guard.rightShoulder);
+			kf.rotate(BoneName.ELBOW_R, ...guard.rightElbow);
+			kf.position(BoneName.PELVIS, 0, -.05, 0);
+		});
+		this.currentTime += timeOffset;
+		return this;
+	}
+	/**
+	* Apply torso rotation for straight punch power generation (주먹허리비틀기)
+	*
+	* Korean martial arts principle: 허리비틀기 (Heori Biteulgi) - Waist twist for power
+	* The torso rotates OPPOSITE to the punch direction, creating torque through
+	* the spine that transfers power into the strike.
+	*
+	* Biomechanics:
+	* - SPINE_LOWER rotates 50% of target angle (foundation rotation)
+	* - SPINE_MIDDLE rotates 70% of target angle (power transfer zone)
+	* - SPINE_UPPER rotates 100% of target angle (maximum rotation at shoulders)
+	*
+	* @param kf - KeyframeConfig to apply rotation to
+	* @param side - Which hand is punching ("left" | "right")
+	* @param rotationDegrees - Target rotation in degrees (15-25° recommended)
+	*
+	* @example
+	* ```typescript
+	* // Right cross with 20° counter-rotation
+	* this.addKeyframe(0.35, "ease-out", (kf) => {
+	*   this.applyPunchTorsoRotation(kf, "right", 20);
+	*   // ... other punch mechanics
+	* });
+	* ```
+	*
+	* @korean 주먹허리비틀기
+	*/
+	applyPunchTorsoRotation(kf, side, rotationDegrees) {
+		const direction = side === "right" ? 1 : -1;
+		const rotationRad = rotationDegrees * Math.PI / 180;
+		const existingUpper = kf.rotations.get(BoneName.SPINE_UPPER);
+		const existingMiddle = kf.rotations.get(BoneName.SPINE_MIDDLE);
+		const existingLower = kf.rotations.get(BoneName.SPINE_LOWER);
+		kf.rotate(BoneName.SPINE_LOWER, existingLower?.x ?? 0, (existingLower?.y ?? 0) + rotationRad * direction * .5, existingLower?.z ?? 0);
+		kf.rotate(BoneName.SPINE_MIDDLE, existingMiddle?.x ?? 0, (existingMiddle?.y ?? 0) + rotationRad * direction * .7, existingMiddle?.z ?? 0);
+		kf.rotate(BoneName.SPINE_UPPER, existingUpper?.x ?? 0, (existingUpper?.y ?? 0) + rotationRad * direction, existingUpper?.z ?? 0);
+	}
+	/**
+	* Apply torso rotation for hook punch circular power (훅허리비틀기)
+	*
+	* Korean martial arts principle: 몸통회전 (Momtong Hoejeon) - Full torso rotation
+	* Hook punches generate power from hip and shoulder rotation in a circular motion.
+	* Larger rotation angle (45-60°) creates the circular arc needed for hooks.
+	*
+	* Biomechanics:
+	* - SPINE_LOWER rotates 50% (hip engagement)
+	* - SPINE_MIDDLE rotates 70% (core power transfer)
+	* - SPINE_UPPER rotates 100% (shoulder whip into target)
+	*
+	* @param kf - KeyframeConfig to apply rotation to
+	* @param side - Which hand is hooking ("left" | "right")
+	* @param rotationDegrees - Target rotation in degrees (45-60° recommended)
+	*
+	* @example
+	* ```typescript
+	* // Right hook with 50° rotation
+	* this.addKeyframe(0.30, "ease-out", (kf) => {
+	*   this.applyHookTorsoRotation(kf, "right", 50);
+	*   // ... other hook mechanics
+	* });
+	* ```
+	*
+	* @korean 훅허리비틀기
+	*/
+	applyHookTorsoRotation(kf, side, rotationDegrees) {
+		const direction = side === "right" ? -1 : 1;
+		const rotationRad = rotationDegrees * Math.PI / 180;
+		const existingLower = kf.rotations.get(BoneName.SPINE_LOWER);
+		const existingMiddle = kf.rotations.get(BoneName.SPINE_MIDDLE);
+		const existingUpper = kf.rotations.get(BoneName.SPINE_UPPER);
+		kf.rotate(BoneName.SPINE_LOWER, existingLower?.x ?? 0, (existingLower?.y ?? 0) + rotationRad * direction * .5, existingLower?.z ?? 0);
+		kf.rotate(BoneName.SPINE_MIDDLE, existingMiddle?.x ?? 0, (existingMiddle?.y ?? 0) + rotationRad * direction * .7, existingMiddle?.z ?? 0);
+		kf.rotate(BoneName.SPINE_UPPER, existingUpper?.x ?? 0, (existingUpper?.y ?? 0) + rotationRad * direction, existingUpper?.z ?? 0);
+	}
+	/**
+	* Apply torso lean for kick balance (차기허리기울이기)
+	*
+	* Korean martial arts principle: 중심축회전 (Jungsim Chuk Hoejeon) - Central axis rotation
+	* When executing kicks, the torso leans AWAY from the kicking leg to:
+	* 1. Maintain balance on the support leg
+	* 2. Increase reach by extending the kick further
+	* 3. Prevent falling backward during high kicks
+	*
+	* Biomechanics:
+	* - SPINE_LOWER leans away from kick (foundation)
+	* - SPINE_MIDDLE leans with lower spine (stability)
+	* - SPINE_UPPER leans slightly less (control)
+	*
+	* @param kf - KeyframeConfig to apply lean to
+	* @param side - Which leg is kicking ("left" | "right")
+	* @param leanDegrees - Amount of lean in degrees (10-20° recommended)
+	*
+	* @example
+	* ```typescript
+	* // Right roundhouse kick with compensatory lean
+	* this.addKeyframe(0.35, "ease-out", (kf) => {
+	*   this.applyKickTorsoLean(kf, "right", 15);
+	*   // ... other kick mechanics
+	* });
+	* ```
+	*
+	* @korean 차기허리기울이기
+	*/
+	applyKickTorsoLean(kf, side, leanDegrees) {
+		const direction = side === "right" ? -1 : 1;
+		const leanRad = leanDegrees * Math.PI / 180;
+		kf.rotate(BoneName.SPINE_LOWER, 0, 0, leanRad * direction * .9);
+		kf.rotate(BoneName.SPINE_MIDDLE, 0, 0, leanRad * direction * .7);
+		kf.rotate(BoneName.SPINE_UPPER, 0, 0, leanRad * direction * .5);
+	}
+	/**
+	* Reset torso to neutral position (허리중립)
+	*
+	* Returns all spine bones to neutral rotation (0, 0, 0).
+	* Used during recovery phases to return to fighting stance.
+	*
+	* @param kf - KeyframeConfig to reset
+	*
+	* @korean 허리중립
+	*/
+	resetTorsoRotation(kf) {
+		kf.rotate(BoneName.SPINE_LOWER, 0, 0, 0);
+		kf.rotate(BoneName.SPINE_MIDDLE, 0, 0, 0);
+		kf.rotate(BoneName.SPINE_UPPER, 0, 0, 0);
+	}
+	/**
+	* Add custom keyframe with callback
+	*/
+	addKeyframe(time, easing, configure) {
+		const kf = new KeyframeConfig();
+		configure(kf);
+		this.keyframes.push({
+			time,
+			easing,
+			boneRotations: kf.rotations,
+			bonePositions: kf.positions
+		});
+	}
+	/**
+	* Add raw keyframe at specific time
+	*/
+	at(time, easing = "linear") {
+		const kf = new KeyframeConfig();
+		kf.setBuilder(this, time, easing);
+		return kf;
+	}
+	/**
+	* Internal: Add keyframe from KeyframeConfig
+	*/
+	_addKeyframe(kf) {
+		this.keyframes.push(kf);
+	}
+	/**
+	* Build the complete animation
+	*
+	* Automatically normalizes timing to ensure animations start at time 0.
+	* This is important for animation system consistency and performance.
+	*/
+	build() {
+		let normalizedKeyframes = this.keyframes;
+		if (this.keyframes.length > 0) {
+			const firstTime = this.keyframes[0].time;
+			if (firstTime !== 0) normalizedKeyframes = this.keyframes.map((kf) => ({
+				...kf,
+				time: kf.time - firstTime
+			}));
+		}
+		return {
+			name: this.name,
+			koreanName: this.koreanName,
+			duration: this.duration,
+			loop: this.loop,
+			type: this.type,
+			keyframes: normalizedKeyframes
+		};
+	}
+};
+//#endregion
+export { MartialArtsAnimationBuilder, TECHNIQUE_TIMING };
+
+//# sourceMappingURL=MartialArtsAnimationBuilder.js.map