blacktrigram 0.7.2

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

@@ -0,0 +1,288 @@
+/**
+ * Animation Builder - Fluent API for creating skeletal animations
+ *
+ * Provides a cleaner, more maintainable way to define animations with
+ * reduced boilerplate and better readability.
+ *
+ * @module systems/animation/AnimationBuilder
+ * @category Animation System
+ * @korean 애니메이션빌더
+ */
+import * as THREE from "three";
+import type { AnimationKeyframe, SkeletalAnimation } from "../../../types/skeletal";
+import { BoneName } from "../../../types/skeletal";
+/**
+ * Keyframe builder for fluent keyframe construction
+ * @korean 키프레임빌더
+ */
+declare class KeyframeBuilder {
+    private time;
+    private easing;
+    private boneRotations;
+    private bonePositions;
+    private parentBuilder;
+    constructor(time: number, easing?: string);
+    /**
+     * Set parent animation builder (for chaining)
+     * @internal
+     */
+    setParent(parent: AnimationBuilder): this;
+    /**
+     * Add bone rotation to keyframe
+     * @param bone - Bone to rotate
+     * @param x - X rotation in radians
+     * @param y - Y rotation in radians
+     * @param z - Z rotation in radians
+     * @param order - Rotation order (default: XYZ)
+     * @returns This builder for chaining
+     */
+    rotate(bone: BoneName, x: number, y: number, z: number, order?: THREE.EulerOrder): this;
+    /**
+     * Add bone position to keyframe
+     * @param bone - Bone to position
+     * @param x - X position
+     * @param y - Y position
+     * @param z - Z position
+     * @returns This builder for chaining
+     */
+    position(bone: BoneName, x: number, y: number, z: number): this;
+    /**
+     * Build the keyframe and return to animation builder
+     * @returns Animation builder for chaining
+     */
+    build(): AnimationBuilder;
+}
+/**
+ * Animation builder for fluent animation construction
+ * @korean 애니메이션빌더
+ */
+export declare class AnimationBuilder {
+    private animationName;
+    private koreanName;
+    private duration;
+    private loop;
+    private type;
+    private keyframes;
+    private constructor();
+    /**
+     * Create a new animation builder
+     * @param name - Animation name
+     * @returns New animation builder
+     */
+    static create(name: string): AnimationBuilder;
+    /**
+     * Set Korean name for animation
+     * @param name - Korean name
+     * @returns This builder for chaining
+     */
+    withKoreanName(name: string): this;
+    /**
+     * Set animation duration
+     * @param seconds - Duration in seconds
+     * @returns This builder for chaining
+     */
+    withDuration(seconds: number): this;
+    /**
+     * Set animation loop behavior
+     * @param shouldLoop - Whether animation should loop
+     * @returns This builder for chaining
+     */
+    withLoop(shouldLoop: boolean): this;
+    /**
+     * Set animation type
+     * @param animType - Animation type
+     * @returns This builder for chaining
+     */
+    withType(animType: "attack" | "defense" | "movement" | "idle"): this;
+    /**
+     * Add a keyframe to the animation
+     * @param time - Time of keyframe in seconds
+     * @param easing - Easing function name
+     * @returns Keyframe builder for defining keyframe contents
+     */
+    keyframe(time: number, easing?: string): KeyframeBuilder;
+    /**
+     * Add a pre-built keyframe directly
+     * @param keyframe - Complete keyframe
+     * @returns This builder for chaining
+     */
+    addKeyframe(keyframe: AnimationKeyframe): this;
+    /**
+     * Build the complete animation
+     * @returns Complete skeletal animation
+     */
+    build(): SkeletalAnimation;
+}
+/**
+ * Common keyframe factories for reusable animation patterns
+ * @korean 키프레임팩토리
+ */
+export declare class KeyframeFactories {
+    /**
+     * Create a guard return keyframe (return to defensive position)
+     * @param time - Time of keyframe
+     * @returns Guard position keyframe
+     */
+    static guardReturn(time: number): AnimationKeyframe;
+    /**
+     * Create a neutral stance keyframe
+     * @param time - Time of keyframe
+     * @returns Neutral stance keyframe
+     */
+    static neutralStance(time: number): AnimationKeyframe;
+    /**
+     * Create a torso rotation keyframe
+     * @param time - Time of keyframe
+     * @param angle - Rotation angle in radians (positive = clockwise)
+     * @param easing - Easing function
+     * @returns Torso rotation keyframe
+     */
+    static rotateTorso(time: number, angle: number, easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out"): AnimationKeyframe;
+}
+/**
+ * Bone rotation helper utilities
+ * @korean 뼈회전헬퍼
+ */
+export declare class BoneRotationHelpers {
+    /**
+     * Create shoulder rotation for arm extension
+     * @param side - "L" or "R"
+     * @param forward - Forward rotation amount
+     * @param up - Upward rotation amount
+     * @returns Euler rotation
+     */
+    static shoulderExtension(side: "L" | "R", forward: number, up?: number): THREE.Euler;
+    /**
+     * Create elbow rotation for arm bend
+     * @param side - "L" or "R"
+     * @param bend - Bend amount (0 = straight, PI/2 = 90 degrees)
+     * @returns Euler rotation
+     */
+    static elbowBend(side: "L" | "R", bend: number): THREE.Euler;
+    /**
+     * Create hip rotation for leg movement
+     * @param _side - "L" or "R" (reserved for future asymmetric animations)
+     * @param forward - Forward rotation (positive = leg forward)
+     * @param outward - Outward rotation (positive = leg out)
+     * @returns Euler rotation
+     */
+    static hipRotation(_side: "L" | "R", forward: number, outward?: number): THREE.Euler;
+    /**
+     * Create knee rotation for leg bend
+     * @param _side - "L" or "R" (reserved for future asymmetric animations)
+     * @param bend - Bend amount (positive = knee bends)
+     * @returns Euler rotation
+     */
+    static kneeBend(_side: "L" | "R", bend: number): THREE.Euler;
+}
+/**
+ * Reusable animation presets for common combat patterns
+ * @korean 재사용애니메이션프리셋
+ */
+export declare class AnimationPresets {
+    /**
+     * Standard fighting guard position - protects face and body
+     * Both elbows tight, hands at chin/temple level
+     * @korean 기본방어자세
+     */
+    static readonly FIGHTING_GUARD: {
+        readonly leftArm: {
+            readonly shoulder: THREE.Euler;
+            readonly elbow: THREE.Euler;
+            readonly wrist: THREE.Euler;
+        };
+        readonly rightArm: {
+            readonly shoulder: THREE.Euler;
+            readonly elbow: THREE.Euler;
+            readonly wrist: THREE.Euler;
+        };
+    };
+    /**
+     * High guard protecting head - both hands at temple level
+     * Used during kicks or when expecting high attacks
+     * @korean 상단방어자세
+     */
+    static readonly HIGH_GUARD: {
+        readonly leftArm: {
+            readonly shoulder: THREE.Euler;
+            readonly elbow: THREE.Euler;
+            readonly wrist: THREE.Euler;
+        };
+        readonly rightArm: {
+            readonly shoulder: THREE.Euler;
+            readonly elbow: THREE.Euler;
+            readonly wrist: THREE.Euler;
+        };
+    };
+    /**
+     * Kick chamber position - leg lifted, hip rotated
+     * Shared starting position for most kicks
+     * @korean 킥체임버자세
+     */
+    static readonly KICK_CHAMBER_RIGHT: {
+        readonly hip: THREE.Euler;
+        readonly knee: THREE.Euler;
+        readonly ankle: THREE.Euler;
+        readonly supportKnee: THREE.Euler;
+        readonly pelvis: THREE.Euler;
+    };
+    /**
+     * Kick extension position - leg fully extended
+     * @korean 킥확장자세
+     */
+    static readonly KICK_EXTENSION_RIGHT: {
+        readonly hip: THREE.Euler;
+        readonly knee: THREE.Euler;
+        readonly ankle: THREE.Euler;
+        readonly supportKnee: THREE.Euler;
+        readonly pelvis: THREE.Euler;
+    };
+    /**
+     * Punch wind-up - arm coiled, torso rotated back
+     * @korean 펀치준비자세
+     */
+    static readonly PUNCH_WINDUP_RIGHT: {
+        readonly shoulder: THREE.Euler;
+        readonly elbow: THREE.Euler;
+        readonly spine: THREE.Euler;
+        readonly pelvis: THREE.Euler;
+    };
+    /**
+     * Punch extension - arm extended with torso rotation
+     * @korean 펀치확장자세
+     */
+    static readonly PUNCH_EXTENSION_RIGHT: {
+        readonly shoulder: THREE.Euler;
+        readonly elbow: THREE.Euler;
+        readonly spine: THREE.Euler;
+        readonly pelvis: THREE.Euler;
+    };
+}
+/**
+ * Applies common animation patterns to KeyframeBuilder
+ * Allows reusing shared motion patterns across animations
+ * @korean 애니메이션패턴헬퍼
+ */
+export declare class AnimationPatternHelpers {
+    /**
+     * Apply fighting guard to a keyframe
+     * Keeps hands protecting face during kicks
+     * @param kf - KeyframeBuilder to modify
+     * @returns Modified KeyframeBuilder
+     */
+    static applyFightingGuard(kf: KeyframeBuilder): KeyframeBuilder;
+    /**
+     * Apply high guard during kicks
+     * @param kf - KeyframeBuilder to modify
+     * @returns Modified KeyframeBuilder
+     */
+    static applyHighGuard(kf: KeyframeBuilder): KeyframeBuilder;
+    /**
+     * Apply kick chamber for right leg
+     * @param kf - KeyframeBuilder to modify
+     * @returns Modified KeyframeBuilder
+     */
+    static applyKickChamber(kf: KeyframeBuilder): KeyframeBuilder;
+}
+export {};
+//# sourceMappingURL=AnimationBuilder.d.ts.map

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

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

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

@@ -0,0 +1,261 @@
+import "../../../types/skeletal.js";
+import * as THREE from "three";
+//#region src/systems/animation/builders/AnimationBuilder.ts
+/**
+* Animation Builder - Fluent API for creating skeletal animations
+*
+* Provides a cleaner, more maintainable way to define animations with
+* reduced boilerplate and better readability.
+*
+* @module systems/animation/AnimationBuilder
+* @category Animation System
+* @korean 애니메이션빌더
+*/
+/**
+* Keyframe builder for fluent keyframe construction
+* @korean 키프레임빌더
+*/
+var KeyframeBuilder = class {
+	time;
+	easing;
+	boneRotations;
+	bonePositions;
+	parentBuilder = null;
+	constructor(time, easing = "linear") {
+		this.time = time;
+		this.easing = easing;
+		this.boneRotations = /* @__PURE__ */ new Map();
+		this.bonePositions = /* @__PURE__ */ new Map();
+	}
+	/**
+	* Set parent animation builder (for chaining)
+	* @internal
+	*/
+	setParent(parent) {
+		this.parentBuilder = parent;
+		return this;
+	}
+	/**
+	* Add bone rotation to keyframe
+	* @param bone - Bone to rotate
+	* @param x - X rotation in radians
+	* @param y - Y rotation in radians
+	* @param z - Z rotation in radians
+	* @param order - Rotation order (default: XYZ)
+	* @returns This builder for chaining
+	*/
+	rotate(bone, x, y, z, order = "XYZ") {
+		this.boneRotations.set(bone, new THREE.Euler(x, y, z, order));
+		return this;
+	}
+	/**
+	* Add bone position to keyframe
+	* @param bone - Bone to position
+	* @param x - X position
+	* @param y - Y position
+	* @param z - Z position
+	* @returns This builder for chaining
+	*/
+	position(bone, x, y, z) {
+		this.bonePositions.set(bone, new THREE.Vector3(x, y, z));
+		return this;
+	}
+	/**
+	* Build the keyframe and return to animation builder
+	* @returns Animation builder for chaining
+	*/
+	build() {
+		const keyframe = {
+			time: this.time,
+			easing: this.easing,
+			boneRotations: this.boneRotations,
+			bonePositions: this.bonePositions
+		};
+		if (this.parentBuilder) {
+			this.parentBuilder.addKeyframe(keyframe);
+			return this.parentBuilder;
+		}
+		throw new Error("KeyframeBuilder.build() called without a parent AnimationBuilder. Ensure setParent(...) is called before build().");
+	}
+};
+/**
+* Animation builder for fluent animation construction
+* @korean 애니메이션빌더
+*/
+var AnimationBuilder = class AnimationBuilder {
+	animationName;
+	koreanName;
+	duration;
+	loop;
+	type;
+	keyframes;
+	constructor(name) {
+		this.animationName = name;
+		this.koreanName = name;
+		this.duration = 1;
+		this.loop = false;
+		this.type = "idle";
+		this.keyframes = [];
+	}
+	/**
+	* Create a new animation builder
+	* @param name - Animation name
+	* @returns New animation builder
+	*/
+	static create(name) {
+		return new AnimationBuilder(name);
+	}
+	/**
+	* Set Korean name for animation
+	* @param name - Korean name
+	* @returns This builder for chaining
+	*/
+	withKoreanName(name) {
+		this.koreanName = name;
+		return this;
+	}
+	/**
+	* Set animation duration
+	* @param seconds - Duration in seconds
+	* @returns This builder for chaining
+	*/
+	withDuration(seconds) {
+		this.duration = seconds;
+		return this;
+	}
+	/**
+	* Set animation loop behavior
+	* @param shouldLoop - Whether animation should loop
+	* @returns This builder for chaining
+	*/
+	withLoop(shouldLoop) {
+		this.loop = shouldLoop;
+		return this;
+	}
+	/**
+	* Set animation type
+	* @param animType - Animation type
+	* @returns This builder for chaining
+	*/
+	withType(animType) {
+		this.type = animType;
+		return this;
+	}
+	/**
+	* Add a keyframe to the animation
+	* @param time - Time of keyframe in seconds
+	* @param easing - Easing function name
+	* @returns Keyframe builder for defining keyframe contents
+	*/
+	keyframe(time, easing = "linear") {
+		const kfBuilder = new KeyframeBuilder(time, easing);
+		kfBuilder.setParent(this);
+		return kfBuilder;
+	}
+	/**
+	* Add a pre-built keyframe directly
+	* @param keyframe - Complete keyframe
+	* @returns This builder for chaining
+	*/
+	addKeyframe(keyframe) {
+		this.keyframes.push(keyframe);
+		return this;
+	}
+	/**
+	* Build the complete animation
+	* @returns Complete skeletal animation
+	*/
+	build() {
+		return {
+			name: this.animationName,
+			koreanName: this.koreanName,
+			duration: this.duration,
+			loop: this.loop,
+			type: this.type,
+			keyframes: this.keyframes
+		};
+	}
+};
+(class {
+	/**
+	* Standard fighting guard position - protects face and body
+	* Both elbows tight, hands at chin/temple level
+	* @korean 기본방어자세
+	*/
+	static FIGHTING_GUARD = {
+		leftArm: {
+			shoulder: new THREE.Euler(-.35, -.35, .14),
+			elbow: new THREE.Euler(0, 0, -1.75),
+			wrist: new THREE.Euler(.1, 0, 0)
+		},
+		rightArm: {
+			shoulder: new THREE.Euler(-.35, .35, -.14),
+			elbow: new THREE.Euler(0, 0, 1.75),
+			wrist: new THREE.Euler(.1, 0, 0)
+		}
+	};
+	/**
+	* High guard protecting head - both hands at temple level
+	* Used during kicks or when expecting high attacks
+	* @korean 상단방어자세
+	*/
+	static HIGH_GUARD = {
+		leftArm: {
+			shoulder: new THREE.Euler(-.52, -.44, .17),
+			elbow: new THREE.Euler(0, 0, -2.09),
+			wrist: new THREE.Euler(.1, 0, 0)
+		},
+		rightArm: {
+			shoulder: new THREE.Euler(-.52, .44, -.17),
+			elbow: new THREE.Euler(0, 0, 2.09),
+			wrist: new THREE.Euler(.1, 0, 0)
+		}
+	};
+	/**
+	* Kick chamber position - leg lifted, hip rotated
+	* Shared starting position for most kicks
+	* @korean 킥체임버자세
+	*/
+	static KICK_CHAMBER_RIGHT = {
+		hip: new THREE.Euler(1.57, 0, 0),
+		knee: new THREE.Euler(-2, 0, 0),
+		ankle: new THREE.Euler(0, 0, 0),
+		supportKnee: new THREE.Euler(-.25, 0, 0),
+		pelvis: new THREE.Euler(-.1, 0, 0)
+	};
+	/**
+	* Kick extension position - leg fully extended
+	* @korean 킥확장자세
+	*/
+	static KICK_EXTENSION_RIGHT = {
+		hip: new THREE.Euler(1.7, 0, 0),
+		knee: new THREE.Euler(.1, 0, 0),
+		ankle: new THREE.Euler(.5, 0, 0),
+		supportKnee: new THREE.Euler(-.35, 0, 0),
+		pelvis: new THREE.Euler(.15, 0, 0)
+	};
+	/**
+	* Punch wind-up - arm coiled, torso rotated back
+	* @korean 펀치준비자세
+	*/
+	static PUNCH_WINDUP_RIGHT = {
+		shoulder: new THREE.Euler(.3, 0, -.3),
+		elbow: new THREE.Euler(0, 0, 1.8),
+		spine: new THREE.Euler(0, -.15, 0),
+		pelvis: new THREE.Euler(0, -.1, 0)
+	};
+	/**
+	* Punch extension - arm extended with torso rotation
+	* @korean 펀치확장자세
+	*/
+	static PUNCH_EXTENSION_RIGHT = {
+		shoulder: new THREE.Euler(-.7, 0, .5),
+		elbow: new THREE.Euler(0, 0, .05),
+		spine: new THREE.Euler(0, .35, 0),
+		pelvis: new THREE.Euler(0, .2, 0)
+	};
+});
+//#endregion
+export { AnimationBuilder };
+
+//# sourceMappingURL=AnimationBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationBuilder.js","names":[],"sources":["../../../../src/systems/animation/builders/AnimationBuilder.ts"],"sourcesContent":["/**\n * Animation Builder - Fluent API for creating skeletal animations\n *\n * Provides a cleaner, more maintainable way to define animations with\n * reduced boilerplate and better readability.\n *\n * @module systems/animation/AnimationBuilder\n * @category Animation System\n * @korean 애니메이션빌더\n */\n\nimport * as THREE from \"three\";\nimport type { AnimationKeyframe, SkeletalAnimation } from \"@/types/skeletal\";\nimport { BoneName } from \"@/types/skeletal\";\n\n/**\n * Keyframe builder for fluent keyframe construction\n * @korean 키프레임빌더\n */\nclass KeyframeBuilder {\n  private time: number;\n  private easing: string;\n  private boneRotations: Map<BoneName, THREE.Euler>;\n  private bonePositions: Map<BoneName, THREE.Vector3>;\n  private parentBuilder: AnimationBuilder | null = null;\n\n  constructor(time: number, easing: string = \"linear\") {\n    this.time = time;\n    this.easing = easing;\n    this.boneRotations = new Map();\n    this.bonePositions = new Map();\n  }\n\n  /**\n   * Set parent animation builder (for chaining)\n   * @internal\n   */\n  setParent(parent: AnimationBuilder): this {\n    this.parentBuilder = parent;\n    return this;\n  }\n\n  /**\n   * Add bone rotation to keyframe\n   * @param bone - Bone to rotate\n   * @param x - X rotation in radians\n   * @param y - Y rotation in radians\n   * @param z - Z rotation in radians\n   * @param order - Rotation order (default: XYZ)\n   * @returns This builder for chaining\n   */\n  rotate(\n    bone: BoneName,\n    x: number,\n    y: number,\n    z: number,\n    order: THREE.EulerOrder = \"XYZ\",\n  ): this {\n    this.boneRotations.set(bone, new THREE.Euler(x, y, z, order));\n    return this;\n  }\n\n  /**\n   * Add bone position to keyframe\n   * @param bone - Bone to position\n   * @param x - X position\n   * @param y - Y position\n   * @param z - Z position\n   * @returns This builder for chaining\n   */\n  position(bone: BoneName, x: number, y: number, z: number): this {\n    this.bonePositions.set(bone, new THREE.Vector3(x, y, z));\n    return this;\n  }\n\n  /**\n   * Build the keyframe and return to animation builder\n   * @returns Animation builder for chaining\n   */\n  build(): AnimationBuilder {\n    const keyframe: AnimationKeyframe = {\n      time: this.time,\n      easing: this.easing as \"linear\" | \"ease-in\" | \"ease-out\" | \"ease-in-out\",\n      boneRotations: this.boneRotations,\n      bonePositions: this.bonePositions,\n    };\n\n    if (this.parentBuilder) {\n      this.parentBuilder.addKeyframe(keyframe);\n      return this.parentBuilder;\n    }\n\n    // This indicates incorrect usage of the builder API; parent must be set via setParent(...)\n    throw new Error(\n      \"KeyframeBuilder.build() called without a parent AnimationBuilder. Ensure setParent(...) is called before build().\",\n    );\n  }\n}\n\n/**\n * Animation builder for fluent animation construction\n * @korean 애니메이션빌더\n */\nexport class AnimationBuilder {\n  private animationName: string;\n  private koreanName: string;\n  private duration: number;\n  private loop: boolean;\n  private type: \"attack\" | \"defense\" | \"movement\" | \"idle\";\n  private keyframes: AnimationKeyframe[];\n\n  private constructor(name: string) {\n    this.animationName = name;\n    this.koreanName = name;\n    this.duration = 1.0;\n    this.loop = false;\n    this.type = \"idle\";\n    this.keyframes = [];\n  }\n\n  /**\n   * Create a new animation builder\n   * @param name - Animation name\n   * @returns New animation builder\n   */\n  static create(name: string): AnimationBuilder {\n    return new AnimationBuilder(name);\n  }\n\n  /**\n   * Set Korean name for animation\n   * @param name - Korean name\n   * @returns This builder for chaining\n   */\n  withKoreanName(name: string): this {\n    this.koreanName = name;\n    return this;\n  }\n\n  /**\n   * Set animation duration\n   * @param seconds - Duration in seconds\n   * @returns This builder for chaining\n   */\n  withDuration(seconds: number): this {\n    this.duration = seconds;\n    return this;\n  }\n\n  /**\n   * Set animation loop behavior\n   * @param shouldLoop - Whether animation should loop\n   * @returns This builder for chaining\n   */\n  withLoop(shouldLoop: boolean): this {\n    this.loop = shouldLoop;\n    return this;\n  }\n\n  /**\n   * Set animation type\n   * @param animType - Animation type\n   * @returns This builder for chaining\n   */\n  withType(animType: \"attack\" | \"defense\" | \"movement\" | \"idle\"): this {\n    this.type = animType;\n    return this;\n  }\n\n  /**\n   * Add a keyframe to the animation\n   * @param time - Time of keyframe in seconds\n   * @param easing - Easing function name\n   * @returns Keyframe builder for defining keyframe contents\n   */\n  keyframe(time: number, easing: string = \"linear\"): KeyframeBuilder {\n    const kfBuilder = new KeyframeBuilder(time, easing);\n    kfBuilder.setParent(this);\n    return kfBuilder;\n  }\n\n  /**\n   * Add a pre-built keyframe directly\n   * @param keyframe - Complete keyframe\n   * @returns This builder for chaining\n   */\n  addKeyframe(keyframe: AnimationKeyframe): this {\n    this.keyframes.push(keyframe);\n    return this;\n  }\n\n  /**\n   * Build the complete animation\n   * @returns Complete skeletal animation\n   */\n  build(): SkeletalAnimation {\n    return {\n      name: this.animationName,\n      koreanName: this.koreanName,\n      duration: this.duration,\n      loop: this.loop,\n      type: this.type,\n      keyframes: this.keyframes,\n    };\n  }\n}\n\n/**\n * Common keyframe factories for reusable animation patterns\n * @korean 키프레임팩토리\n */\nexport class KeyframeFactories {\n  /**\n   * Create a guard return keyframe (return to defensive position)\n   * @param time - Time of keyframe\n   * @returns Guard position keyframe\n   */\n  static guardReturn(time: number): AnimationKeyframe {\n    return {\n      time,\n      easing: \"ease-in\",\n      boneRotations: new Map([\n        [BoneName.SHOULDER_R, new THREE.Euler(-0.35, 0.35, -0.14, \"XYZ\")],\n        [BoneName.SHOULDER_L, new THREE.Euler(-0.35, -0.35, 0.14, \"XYZ\")],\n        [BoneName.ELBOW_R, new THREE.Euler(0, 0, 1.75, \"XYZ\")],\n        [BoneName.ELBOW_L, new THREE.Euler(0, 0, -1.75, \"XYZ\")],\n        [BoneName.SPINE_UPPER, new THREE.Euler(0, 0, 0, \"XYZ\")],\n        [BoneName.SPINE_MIDDLE, new THREE.Euler(0, 0, 0, \"XYZ\")],\n        [BoneName.PELVIS, new THREE.Euler(0, 0, 0, \"XYZ\")],\n      ]),\n      bonePositions: new Map([\n        [BoneName.HAND_R, new THREE.Vector3(0, 0, 0)],\n        [BoneName.HAND_L, new THREE.Vector3(0, 0, 0)],\n      ]),\n    };\n  }\n\n  /**\n   * Create a neutral stance keyframe\n   * @param time - Time of keyframe\n   * @returns Neutral stance keyframe\n   */\n  static neutralStance(time: number): AnimationKeyframe {\n    return {\n      time,\n      easing: \"linear\",\n      boneRotations: new Map([\n        [BoneName.SPINE_UPPER, new THREE.Euler(0, 0, 0, \"XYZ\")],\n        [BoneName.SPINE_MIDDLE, new THREE.Euler(0, 0, 0, \"XYZ\")],\n        [BoneName.PELVIS, new THREE.Euler(0, 0, 0, \"XYZ\")],\n        [BoneName.HIP_L, new THREE.Euler(0, 0, 0, \"XYZ\")],\n        [BoneName.HIP_R, new THREE.Euler(0, 0, 0, \"XYZ\")],\n      ]),\n      bonePositions: new Map(),\n    };\n  }\n\n  /**\n   * Create a torso rotation keyframe\n   * @param time - Time of keyframe\n   * @param angle - Rotation angle in radians (positive = clockwise)\n   * @param easing - Easing function\n   * @returns Torso rotation keyframe\n   */\n  static rotateTorso(\n    time: number,\n    angle: number,\n    easing: \"linear\" | \"ease-in\" | \"ease-out\" | \"ease-in-out\" = \"linear\",\n  ): AnimationKeyframe {\n    return {\n      time,\n      easing,\n      boneRotations: new Map([\n        [BoneName.SPINE_UPPER, new THREE.Euler(0, angle, 0, \"XYZ\")],\n        [BoneName.SPINE_MIDDLE, new THREE.Euler(0, angle * 0.75, 0, \"XYZ\")],\n        [BoneName.PELVIS, new THREE.Euler(0, angle * 0.5, 0, \"XYZ\")],\n      ]),\n      bonePositions: new Map(),\n    };\n  }\n}\n\n/**\n * Bone rotation helper utilities\n * @korean 뼈회전헬퍼\n */\nexport class BoneRotationHelpers {\n  /**\n   * Create shoulder rotation for arm extension\n   * @param side - \"L\" or \"R\"\n   * @param forward - Forward rotation amount\n   * @param up - Upward rotation amount\n   * @returns Euler rotation\n   */\n  static shoulderExtension(\n    side: \"L\" | \"R\",\n    forward: number,\n    up: number = 0,\n  ): THREE.Euler {\n    const sign = side === \"L\" ? -1 : 1;\n    return new THREE.Euler(up, 0, forward * sign, \"XYZ\");\n  }\n\n  /**\n   * Create elbow rotation for arm bend\n   * @param side - \"L\" or \"R\"\n   * @param bend - Bend amount (0 = straight, PI/2 = 90 degrees)\n   * @returns Euler rotation\n   */\n  static elbowBend(side: \"L\" | \"R\", bend: number): THREE.Euler {\n    const sign = side === \"L\" ? -1 : 1;\n    return new THREE.Euler(0, 0, bend * sign, \"XYZ\");\n  }\n\n  /**\n   * Create hip rotation for leg movement\n   * @param _side - \"L\" or \"R\" (reserved for future asymmetric animations)\n   * @param forward - Forward rotation (positive = leg forward)\n   * @param outward - Outward rotation (positive = leg out)\n   * @returns Euler rotation\n   */\n  static hipRotation(\n    _side: \"L\" | \"R\",\n    forward: number,\n    outward: number = 0,\n  ): THREE.Euler {\n    return new THREE.Euler(forward, outward, 0, \"XYZ\");\n  }\n\n  /**\n   * Create knee rotation for leg bend\n   * @param _side - \"L\" or \"R\" (reserved for future asymmetric animations)\n   * @param bend - Bend amount (positive = knee bends)\n   * @returns Euler rotation\n   */\n  static kneeBend(_side: \"L\" | \"R\", bend: number): THREE.Euler {\n    // NOTE: `_side` is intentionally unused: knee bends are currently symmetric for both legs.\n    // The parameter is kept to preserve API compatibility for future asymmetric leg animations.\n    void _side;\n    // Knee flexion is on X axis (legs extend along -Y, X rotation swings shin forward/backward)\n    // Negative X = flexion (bend), so negate the positive 'bend' input\n    return new THREE.Euler(-bend, 0, 0, \"XYZ\");\n  }\n}\n\n/**\n * Reusable animation presets for common combat patterns\n * @korean 재사용애니메이션프리셋\n */\nexport class AnimationPresets {\n  /**\n   * Standard fighting guard position - protects face and body\n   * Both elbows tight, hands at chin/temple level\n   * @korean 기본방어자세\n   */\n  static readonly FIGHTING_GUARD = {\n    leftArm: {\n      shoulder: new THREE.Euler(-0.35, -0.35, 0.14), // Arms forward, hands near chin\n      elbow: new THREE.Euler(0, 0, -1.75), // ~100° bend (중단막기)\n      wrist: new THREE.Euler(0.1, 0, 0), // Fist aligned\n    },\n    rightArm: {\n      shoulder: new THREE.Euler(-0.35, 0.35, -0.14), // Mirror\n      elbow: new THREE.Euler(0, 0, 1.75), // ~100° bend (중단막기)\n      wrist: new THREE.Euler(0.1, 0, 0), // Fist aligned\n    },\n  } as const;\n\n  /**\n   * High guard protecting head - both hands at temple level\n   * Used during kicks or when expecting high attacks\n   * @korean 상단방어자세\n   */\n  static readonly HIGH_GUARD = {\n    leftArm: {\n      shoulder: new THREE.Euler(-0.52, -0.44, 0.17), // Raised, arms forward (상단막기)\n      elbow: new THREE.Euler(0, 0, -2.09), // ~120° bend tight guard\n      wrist: new THREE.Euler(0.1, 0, 0), // Hand near temple\n    },\n    rightArm: {\n      shoulder: new THREE.Euler(-0.52, 0.44, -0.17), // Mirror\n      elbow: new THREE.Euler(0, 0, 2.09), // ~120° bend tight guard\n      wrist: new THREE.Euler(0.1, 0, 0), // Hand near temple\n    },\n  } as const;\n\n  /**\n   * Kick chamber position - leg lifted, hip rotated\n   * Shared starting position for most kicks\n   * @korean 킥체임버자세\n   */\n  static readonly KICK_CHAMBER_RIGHT = {\n    hip: new THREE.Euler(1.57, 0, 0), // 90° hip flexion\n    knee: new THREE.Euler(-2.0, 0, 0), // Tight chamber\n    ankle: new THREE.Euler(0, 0, 0), // Relaxed\n    supportKnee: new THREE.Euler(-0.25, 0, 0), // Slight bend for balance\n    pelvis: new THREE.Euler(-0.1, 0, 0), // Slight backward tilt\n  } as const;\n\n  /**\n   * Kick extension position - leg fully extended\n   * @korean 킥확장자세\n   */\n  static readonly KICK_EXTENSION_RIGHT = {\n    hip: new THREE.Euler(1.7, 0, 0), // Hip drives forward\n    knee: new THREE.Euler(0.1, 0, 0), // Full extension\n    ankle: new THREE.Euler(0.5, 0, 0), // Dorsiflexion for ball strike\n    supportKnee: new THREE.Euler(-0.35, 0, 0), // Deeper bend for balance\n    pelvis: new THREE.Euler(0.15, 0, 0), // Forward drive\n  } as const;\n\n  /**\n   * Punch wind-up - arm coiled, torso rotated back\n   * @korean 펀치준비자세\n   */\n  static readonly PUNCH_WINDUP_RIGHT = {\n    shoulder: new THREE.Euler(0.3, 0, -0.3),\n    elbow: new THREE.Euler(0, 0, 1.8),\n    spine: new THREE.Euler(0, -0.15, 0),\n    pelvis: new THREE.Euler(0, -0.1, 0),\n  } as const;\n\n  /**\n   * Punch extension - arm extended with torso rotation\n   * @korean 펀치확장자세\n   */\n  static readonly PUNCH_EXTENSION_RIGHT = {\n    shoulder: new THREE.Euler(-0.7, 0, 0.5),\n    elbow: new THREE.Euler(0, 0, 0.05),\n    spine: new THREE.Euler(0, 0.35, 0),\n    pelvis: new THREE.Euler(0, 0.2, 0),\n  } as const;\n}\n\n/**\n * Applies common animation patterns to KeyframeBuilder\n * Allows reusing shared motion patterns across animations\n * @korean 애니메이션패턴헬퍼\n */\nexport class AnimationPatternHelpers {\n  /**\n   * Apply fighting guard to a keyframe\n   * Keeps hands protecting face during kicks\n   * @param kf - KeyframeBuilder to modify\n   * @returns Modified KeyframeBuilder\n   */\n  static applyFightingGuard(kf: KeyframeBuilder): KeyframeBuilder {\n    const guard = AnimationPresets.FIGHTING_GUARD;\n    return kf\n      .rotate(\n        BoneName.SHOULDER_L,\n        guard.leftArm.shoulder.x,\n        guard.leftArm.shoulder.y,\n        guard.leftArm.shoulder.z,\n      )\n      .rotate(\n        BoneName.ELBOW_L,\n        guard.leftArm.elbow.x,\n        guard.leftArm.elbow.y,\n        guard.leftArm.elbow.z,\n      )\n      .rotate(\n        BoneName.SHOULDER_R,\n        guard.rightArm.shoulder.x,\n        guard.rightArm.shoulder.y,\n        guard.rightArm.shoulder.z,\n      )\n      .rotate(\n        BoneName.ELBOW_R,\n        guard.rightArm.elbow.x,\n        guard.rightArm.elbow.y,\n        guard.rightArm.elbow.z,\n      );\n  }\n\n  /**\n   * Apply high guard during kicks\n   * @param kf - KeyframeBuilder to modify\n   * @returns Modified KeyframeBuilder\n   */\n  static applyHighGuard(kf: KeyframeBuilder): KeyframeBuilder {\n    const guard = AnimationPresets.HIGH_GUARD;\n    return kf\n      .rotate(\n        BoneName.SHOULDER_L,\n        guard.leftArm.shoulder.x,\n        guard.leftArm.shoulder.y,\n        guard.leftArm.shoulder.z,\n      )\n      .rotate(\n        BoneName.ELBOW_L,\n        guard.leftArm.elbow.x,\n        guard.leftArm.elbow.y,\n        guard.leftArm.elbow.z,\n      )\n      .rotate(\n        BoneName.SHOULDER_R,\n        guard.rightArm.shoulder.x,\n        guard.rightArm.shoulder.y,\n        guard.rightArm.shoulder.z,\n      )\n      .rotate(\n        BoneName.ELBOW_R,\n        guard.rightArm.elbow.x,\n        guard.rightArm.elbow.y,\n        guard.rightArm.elbow.z,\n      );\n  }\n\n  /**\n   * Apply kick chamber for right leg\n   * @param kf - KeyframeBuilder to modify\n   * @returns Modified KeyframeBuilder\n   */\n  static applyKickChamber(kf: KeyframeBuilder): KeyframeBuilder {\n    const chamber = AnimationPresets.KICK_CHAMBER_RIGHT;\n    return kf\n      .rotate(BoneName.HIP_R, chamber.hip.x, chamber.hip.y, chamber.hip.z)\n      .rotate(BoneName.KNEE_R, chamber.knee.x, chamber.knee.y, chamber.knee.z)\n      .rotate(\n        BoneName.KNEE_L,\n        chamber.supportKnee.x,\n        chamber.supportKnee.y,\n        chamber.supportKnee.z,\n      )\n      .rotate(\n        BoneName.PELVIS,\n        chamber.pelvis.x,\n        chamber.pelvis.y,\n        chamber.pelvis.z,\n      );\n  }\n}\n"],"mappings":"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"}