blacktrigram 0.7.2

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

@@ -0,0 +1,207 @@
+/**
+ * Keyframe Configuration Helper
+ *
+ * Helper class for configuring animation keyframes with bone rotations, positions,
+ * and integrated anatomy state (hands, feet, facial expressions, muscle activations).
+ * 애니메이션 키프레임 설정 헬퍼 클래스 (해부학 상태 통합)
+ *
+ * @module systems/animation/KeyframeConfig
+ * @korean 키프레임설정
+ */
+import type { AnimationKeyframe, SkeletalAnimation } from "../../../types/skeletal";
+import { BoneName } from "../../../types/skeletal";
+import * as THREE from "three";
+import type { GuardPositionType } from "./KoreanGuardPositions";
+/** Hand highlight mode for striking surface visualization */
+export type HandHighlightMode = "none" | "knuckles" | "palm" | "knife_edge" | "fingertips";
+interface AnimationBuilderLike {
+    _addKeyframe(kf: AnimationKeyframe): void;
+    at(time: number, easing?: string): KeyframeConfig;
+    build(): SkeletalAnimation;
+}
+/**
+ * Keyframe configuration helper
+ *
+ * Provides a fluent API for configuring bone rotations, positions,
+ * and anatomy state (hands, feet, facial expressions) within a single keyframe.
+ *
+ * @example
+ * ```typescript
+ * const kf = new KeyframeConfig();
+ * kf.rotate(BoneName.SHOULDER_R, -0.5, 0, 0.3)
+ *   .position(BoneName.HAND_R, 0.1, 0, 0)
+ *   .setLeftHandPose("fist")
+ *   .setRightHandPose("fist", "knuckles")
+ *   .setFootHighlight("right", true)
+ *   .setFacialExpression("focused");
+ * ```
+ *
+ * @korean 키프레임설정헬퍼
+ */
+export declare class KeyframeConfig {
+    /** Bone rotation data (bone -> euler rotation) */
+    rotations: Map<BoneName, THREE.Euler>;
+    /** Bone position data (bone -> position offset) */
+    positions: Map<BoneName, THREE.Vector3>;
+    /** Parent builder reference for fluent chaining */
+    private builder;
+    /** Keyframe time */
+    private time;
+    /** Keyframe easing function */
+    private easing;
+    /** Left hand pose type */
+    private _leftHandPose?;
+    /** Right hand pose type */
+    private _rightHandPose?;
+    /** Left hand highlight mode */
+    private _leftHandHighlightMode?;
+    /** Right hand highlight mode */
+    private _rightHandHighlightMode?;
+    /** Left foot highlight state */
+    private _leftFootHighlight?;
+    /** Right foot highlight state */
+    private _rightFootHighlight?;
+    /** Facial expression */
+    private _facialExpression?;
+    /** Muscle activation targets */
+    private _muscleActivations?;
+    /**
+     * Associate this keyframe with a builder for the `done()` method
+     * @internal
+     */
+    setBuilder(builder: AnimationBuilderLike, time: number, easing: string): void;
+    /**
+     * Set bone rotation (euler angles in radians)
+     *
+     * @param bone - Target bone name
+     * @param x - X rotation (radians)
+     * @param y - Y rotation (radians)
+     * @param z - Z rotation (radians)
+     * @returns this for chaining
+     *
+     * @example
+     * ```typescript
+     * kf.rotate(BoneName.SHOULDER_R, -0.5, 0, 0.3);
+     * ```
+     *
+     * @korean 뼈회전설정
+     */
+    rotate(bone: BoneName, x: number, y: number, z: number): this;
+    /**
+     * Set bone position offset
+     *
+     * @param bone - Target bone name
+     * @param x - X position offset
+     * @param y - Y position offset
+     * @param z - Z position offset
+     * @returns this for chaining
+     *
+     * @example
+     * ```typescript
+     * kf.position(BoneName.FOOT_R, 0, 0.5, 0.3);
+     * ```
+     *
+     * @korean 뼈위치설정
+     */
+    position(bone: BoneName, x: number, y: number, z: number): this;
+    /**
+     * Apply Korean guard position to arms
+     *
+     * Sets proper Korean martial arts guard positions (막기자세) for defensive posture.
+     * Supports applying guard to one side or both sides.
+     *
+     * @param guardType - Type of guard ("HIGH_GUARD" | "MIDDLE_GUARD" | "LOW_GUARD")
+     * @param side - Which side to apply ("left" | "right" | "both")
+     * @returns this for chaining
+     *
+     * @example
+     * ```typescript
+     * // Apply middle guard to both hands
+     * kf.withGuard("MIDDLE_GUARD");
+     *
+     * // Apply middle guard only to left hand (right hand attacks)
+     * kf.withGuard("MIDDLE_GUARD", "left");
+     * ```
+     *
+     * @korean 방어자세적용
+     */
+    withGuard(guardType: GuardPositionType, side?: "left" | "right" | "both"): this;
+    /**
+     * Set left hand pose for this keyframe
+     *
+     * @param pose - Hand pose type (e.g., "fist", "knife_hand", "open")
+     * @param highlightMode - Optional highlight mode for striking surface
+     * @returns this for chaining
+     *
+     * @korean 왼손자세설정
+     */
+    setLeftHandPose(pose: string, highlightMode?: HandHighlightMode): this;
+    /**
+     * Set right hand pose for this keyframe
+     *
+     * @param pose - Hand pose type (e.g., "fist", "knife_hand", "open")
+     * @param highlightMode - Optional highlight mode for striking surface
+     * @returns this for chaining
+     *
+     * @korean 오른손자세설정
+     */
+    setRightHandPose(pose: string, highlightMode?: HandHighlightMode): this;
+    /**
+     * Set both hands to the same pose
+     *
+     * @param pose - Hand pose type for both hands
+     * @returns this for chaining
+     *
+     * @korean 양손자세설정
+     */
+    setBothHandPoses(pose: string): this;
+    /**
+     * Set foot highlight state for kicks
+     *
+     * @param side - Which foot ("left" | "right" | "both")
+     * @param highlighted - Whether to highlight
+     * @returns this for chaining
+     *
+     * @korean 발강조설정
+     */
+    setFootHighlight(side: "left" | "right" | "both", highlighted: boolean): this;
+    /**
+     * Set facial expression for this keyframe
+     *
+     * @param expression - Facial expression (e.g., "neutral", "focused", "pained")
+     * @returns this for chaining
+     *
+     * @korean 얼굴표정설정
+     */
+    setFacialExpression(expression: string): this;
+    /**
+     * Set muscle activation target for this keyframe
+     *
+     * @param muscleGroup - Muscle group name (e.g., "BICEP_R", "QUAD_L")
+     * @param tension - Tension level (0-1)
+     * @returns this for chaining
+     *
+     * @korean 근육활성화설정
+     */
+    setMuscleActivation(muscleGroup: string, tension: number): this;
+    /**
+     * Set multiple muscle activations at once
+     *
+     * @param activations - Map or object of muscle group to tension
+     * @returns this for chaining
+     *
+     * @korean 다중근육활성화설정
+     */
+    setMuscleActivations(activations: Map<string, number> | Record<string, number>): this;
+    /**
+     * Complete keyframe configuration and return to builder
+     *
+     * @returns Parent builder for method chaining
+     * @throws Error if not associated with a builder
+     *
+     * @korean 키프레임완료
+     */
+    done<T extends AnimationBuilderLike>(): T;
+}
+export {};
+//# sourceMappingURL=KeyframeConfig.d.ts.map

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

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

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

@@ -0,0 +1,264 @@
+import { BoneName } from "../../../types/skeletal.js";
+import { getGuardPosition } from "./KoreanGuardPositions.js";
+import * as THREE from "three";
+//#region src/systems/animation/builders/KeyframeConfig.ts
+/**
+* Keyframe configuration helper
+*
+* Provides a fluent API for configuring bone rotations, positions,
+* and anatomy state (hands, feet, facial expressions) within a single keyframe.
+*
+* @example
+* ```typescript
+* const kf = new KeyframeConfig();
+* kf.rotate(BoneName.SHOULDER_R, -0.5, 0, 0.3)
+*   .position(BoneName.HAND_R, 0.1, 0, 0)
+*   .setLeftHandPose("fist")
+*   .setRightHandPose("fist", "knuckles")
+*   .setFootHighlight("right", true)
+*   .setFacialExpression("focused");
+* ```
+*
+* @korean 키프레임설정헬퍼
+*/
+var KeyframeConfig = class {
+	/** Bone rotation data (bone -> euler rotation) */
+	rotations = /* @__PURE__ */ new Map();
+	/** Bone position data (bone -> position offset) */
+	positions = /* @__PURE__ */ new Map();
+	/** Parent builder reference for fluent chaining */
+	builder = null;
+	/** Keyframe time */
+	time = 0;
+	/** Keyframe easing function */
+	easing = "linear";
+	/** Left hand pose type */
+	_leftHandPose;
+	/** Right hand pose type */
+	_rightHandPose;
+	/** Left hand highlight mode */
+	_leftHandHighlightMode;
+	/** Right hand highlight mode */
+	_rightHandHighlightMode;
+	/** Left foot highlight state */
+	_leftFootHighlight;
+	/** Right foot highlight state */
+	_rightFootHighlight;
+	/** Facial expression */
+	_facialExpression;
+	/** Muscle activation targets */
+	_muscleActivations;
+	/**
+	* Associate this keyframe with a builder for the `done()` method
+	* @internal
+	*/
+	setBuilder(builder, time, easing) {
+		this.builder = builder;
+		this.time = time;
+		this.easing = easing;
+	}
+	/**
+	* Set bone rotation (euler angles in radians)
+	*
+	* @param bone - Target bone name
+	* @param x - X rotation (radians)
+	* @param y - Y rotation (radians)
+	* @param z - Z rotation (radians)
+	* @returns this for chaining
+	*
+	* @example
+	* ```typescript
+	* kf.rotate(BoneName.SHOULDER_R, -0.5, 0, 0.3);
+	* ```
+	*
+	* @korean 뼈회전설정
+	*/
+	rotate(bone, x, y, z) {
+		this.rotations.set(bone, new THREE.Euler(x, y, z));
+		return this;
+	}
+	/**
+	* Set bone position offset
+	*
+	* @param bone - Target bone name
+	* @param x - X position offset
+	* @param y - Y position offset
+	* @param z - Z position offset
+	* @returns this for chaining
+	*
+	* @example
+	* ```typescript
+	* kf.position(BoneName.FOOT_R, 0, 0.5, 0.3);
+	* ```
+	*
+	* @korean 뼈위치설정
+	*/
+	position(bone, x, y, z) {
+		this.positions.set(bone, new THREE.Vector3(x, y, z));
+		return this;
+	}
+	/**
+	* Apply Korean guard position to arms
+	*
+	* Sets proper Korean martial arts guard positions (막기자세) for defensive posture.
+	* Supports applying guard to one side or both sides.
+	*
+	* @param guardType - Type of guard ("HIGH_GUARD" | "MIDDLE_GUARD" | "LOW_GUARD")
+	* @param side - Which side to apply ("left" | "right" | "both")
+	* @returns this for chaining
+	*
+	* @example
+	* ```typescript
+	* // Apply middle guard to both hands
+	* kf.withGuard("MIDDLE_GUARD");
+	*
+	* // Apply middle guard only to left hand (right hand attacks)
+	* kf.withGuard("MIDDLE_GUARD", "left");
+	* ```
+	*
+	* @korean 방어자세적용
+	*/
+	withGuard(guardType, side = "both") {
+		const guard = getGuardPosition(guardType);
+		if (side === "left" || side === "both") {
+			this.rotate(BoneName.SHOULDER_L, guard.left.shoulder[0], guard.left.shoulder[1], guard.left.shoulder[2]);
+			this.rotate(BoneName.ELBOW_L, guard.left.elbow[0], guard.left.elbow[1], guard.left.elbow[2]);
+			this.rotate(BoneName.WRIST_L, guard.left.wrist[0], guard.left.wrist[1], guard.left.wrist[2]);
+		}
+		if (side === "right" || side === "both") {
+			this.rotate(BoneName.SHOULDER_R, guard.right.shoulder[0], guard.right.shoulder[1], guard.right.shoulder[2]);
+			this.rotate(BoneName.ELBOW_R, guard.right.elbow[0], guard.right.elbow[1], guard.right.elbow[2]);
+			this.rotate(BoneName.WRIST_R, guard.right.wrist[0], guard.right.wrist[1], guard.right.wrist[2]);
+		}
+		return this;
+	}
+	/**
+	* Set left hand pose for this keyframe
+	*
+	* @param pose - Hand pose type (e.g., "fist", "knife_hand", "open")
+	* @param highlightMode - Optional highlight mode for striking surface
+	* @returns this for chaining
+	*
+	* @korean 왼손자세설정
+	*/
+	setLeftHandPose(pose, highlightMode) {
+		this._leftHandPose = pose;
+		if (highlightMode) this._leftHandHighlightMode = highlightMode;
+		return this;
+	}
+	/**
+	* Set right hand pose for this keyframe
+	*
+	* @param pose - Hand pose type (e.g., "fist", "knife_hand", "open")
+	* @param highlightMode - Optional highlight mode for striking surface
+	* @returns this for chaining
+	*
+	* @korean 오른손자세설정
+	*/
+	setRightHandPose(pose, highlightMode) {
+		this._rightHandPose = pose;
+		if (highlightMode) this._rightHandHighlightMode = highlightMode;
+		return this;
+	}
+	/**
+	* Set both hands to the same pose
+	*
+	* @param pose - Hand pose type for both hands
+	* @returns this for chaining
+	*
+	* @korean 양손자세설정
+	*/
+	setBothHandPoses(pose) {
+		this._leftHandPose = pose;
+		this._rightHandPose = pose;
+		return this;
+	}
+	/**
+	* Set foot highlight state for kicks
+	*
+	* @param side - Which foot ("left" | "right" | "both")
+	* @param highlighted - Whether to highlight
+	* @returns this for chaining
+	*
+	* @korean 발강조설정
+	*/
+	setFootHighlight(side, highlighted) {
+		if (side === "left" || side === "both") this._leftFootHighlight = highlighted;
+		if (side === "right" || side === "both") this._rightFootHighlight = highlighted;
+		return this;
+	}
+	/**
+	* Set facial expression for this keyframe
+	*
+	* @param expression - Facial expression (e.g., "neutral", "focused", "pained")
+	* @returns this for chaining
+	*
+	* @korean 얼굴표정설정
+	*/
+	setFacialExpression(expression) {
+		this._facialExpression = expression;
+		return this;
+	}
+	/**
+	* Set muscle activation target for this keyframe
+	*
+	* @param muscleGroup - Muscle group name (e.g., "BICEP_R", "QUAD_L")
+	* @param tension - Tension level (0-1)
+	* @returns this for chaining
+	*
+	* @korean 근육활성화설정
+	*/
+	setMuscleActivation(muscleGroup, tension) {
+		this._muscleActivations ??= /* @__PURE__ */ new Map();
+		this._muscleActivations.set(muscleGroup, Math.max(0, Math.min(1, tension)));
+		return this;
+	}
+	/**
+	* Set multiple muscle activations at once
+	*
+	* @param activations - Map or object of muscle group to tension
+	* @returns this for chaining
+	*
+	* @korean 다중근육활성화설정
+	*/
+	setMuscleActivations(activations) {
+		this._muscleActivations ??= /* @__PURE__ */ new Map();
+		if (activations instanceof Map) activations.forEach((tension, group) => {
+			this._muscleActivations.set(group, Math.max(0, Math.min(1, tension)));
+		});
+		else Object.entries(activations).forEach(([group, tension]) => {
+			this._muscleActivations.set(group, Math.max(0, Math.min(1, tension)));
+		});
+		return this;
+	}
+	/**
+	* Complete keyframe configuration and return to builder
+	*
+	* @returns Parent builder for method chaining
+	* @throws Error if not associated with a builder
+	*
+	* @korean 키프레임완료
+	*/
+	done() {
+		if (!this.builder) throw new Error("KeyframeConfig not associated with builder");
+		this.builder._addKeyframe({
+			time: this.time,
+			easing: this.easing,
+			boneRotations: this.rotations,
+			bonePositions: this.positions,
+			leftHandPose: this._leftHandPose,
+			rightHandPose: this._rightHandPose,
+			leftHandHighlightMode: this._leftHandHighlightMode,
+			rightHandHighlightMode: this._rightHandHighlightMode,
+			leftFootHighlight: this._leftFootHighlight,
+			rightFootHighlight: this._rightFootHighlight,
+			facialExpression: this._facialExpression,
+			muscleActivations: this._muscleActivations
+		});
+		return this.builder;
+	}
+};
+//#endregion
+export { KeyframeConfig };
+
+//# sourceMappingURL=KeyframeConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KeyframeConfig.js","names":[],"sources":["../../../../src/systems/animation/builders/KeyframeConfig.ts"],"sourcesContent":["/**\n * Keyframe Configuration Helper\n *\n * Helper class for configuring animation keyframes with bone rotations, positions,\n * and integrated anatomy state (hands, feet, facial expressions, muscle activations).\n * 애니메이션 키프레임 설정 헬퍼 클래스 (해부학 상태 통합)\n *\n * @module systems/animation/KeyframeConfig\n * @korean 키프레임설정\n */\n\nimport type { AnimationKeyframe, SkeletalAnimation } from \"@/types/skeletal\";\nimport { BoneName } from \"@/types/skeletal\";\nimport * as THREE from \"three\";\nimport type { GuardPositionType } from \"./KoreanGuardPositions\";\nimport { getGuardPosition } from \"./KoreanGuardPositions\";\n\n/** Hand highlight mode for striking surface visualization */\nexport type HandHighlightMode =\n  | \"none\"\n  | \"knuckles\"\n  | \"palm\"\n  | \"knife_edge\"\n  | \"fingertips\";\n\n// Forward declaration for builder type\ninterface AnimationBuilderLike {\n  _addKeyframe(kf: AnimationKeyframe): void;\n  at(time: number, easing?: string): KeyframeConfig;\n  build(): SkeletalAnimation;\n}\n\n/**\n * Keyframe configuration helper\n *\n * Provides a fluent API for configuring bone rotations, positions,\n * and anatomy state (hands, feet, facial expressions) within a single keyframe.\n *\n * @example\n * ```typescript\n * const kf = new KeyframeConfig();\n * kf.rotate(BoneName.SHOULDER_R, -0.5, 0, 0.3)\n *   .position(BoneName.HAND_R, 0.1, 0, 0)\n *   .setLeftHandPose(\"fist\")\n *   .setRightHandPose(\"fist\", \"knuckles\")\n *   .setFootHighlight(\"right\", true)\n *   .setFacialExpression(\"focused\");\n * ```\n *\n * @korean 키프레임설정헬퍼\n */\nexport class KeyframeConfig {\n  /** Bone rotation data (bone -> euler rotation) */\n  rotations = new Map<BoneName, THREE.Euler>();\n\n  /** Bone position data (bone -> position offset) */\n  positions = new Map<BoneName, THREE.Vector3>();\n\n  /** Parent builder reference for fluent chaining */\n  private builder: AnimationBuilderLike | null = null;\n\n  /** Keyframe time */\n  private time: number = 0;\n\n  /** Keyframe easing function */\n  private easing: string = \"linear\";\n\n  // ═══════════════════════════════════════════════════════════════════════════\n  // ANATOMY STATE (해부학 상태) - Integrated hand, foot, and facial animation\n  // ═══════════════════════════════════════════════════════════════════════════\n\n  /** Left hand pose type */\n  private _leftHandPose?: string;\n\n  /** Right hand pose type */\n  private _rightHandPose?: string;\n\n  /** Left hand highlight mode */\n  private _leftHandHighlightMode?: HandHighlightMode;\n\n  /** Right hand highlight mode */\n  private _rightHandHighlightMode?: HandHighlightMode;\n\n  /** Left foot highlight state */\n  private _leftFootHighlight?: boolean;\n\n  /** Right foot highlight state */\n  private _rightFootHighlight?: boolean;\n\n  /** Facial expression */\n  private _facialExpression?: string;\n\n  /** Muscle activation targets */\n  private _muscleActivations?: Map<string, number>;\n\n  /**\n   * Associate this keyframe with a builder for the `done()` method\n   * @internal\n   */\n  setBuilder(\n    builder: AnimationBuilderLike,\n    time: number,\n    easing: string,\n  ): void {\n    this.builder = builder;\n    this.time = time;\n    this.easing = easing;\n  }\n\n  /**\n   * Set bone rotation (euler angles in radians)\n   *\n   * @param bone - Target bone name\n   * @param x - X rotation (radians)\n   * @param y - Y rotation (radians)\n   * @param z - Z rotation (radians)\n   * @returns this for chaining\n   *\n   * @example\n   * ```typescript\n   * kf.rotate(BoneName.SHOULDER_R, -0.5, 0, 0.3);\n   * ```\n   *\n   * @korean 뼈회전설정\n   */\n  rotate(bone: BoneName, x: number, y: number, z: number): this {\n    this.rotations.set(bone, new THREE.Euler(x, y, z));\n    return this;\n  }\n\n  /**\n   * Set bone position offset\n   *\n   * @param bone - Target bone name\n   * @param x - X position offset\n   * @param y - Y position offset\n   * @param z - Z position offset\n   * @returns this for chaining\n   *\n   * @example\n   * ```typescript\n   * kf.position(BoneName.FOOT_R, 0, 0.5, 0.3);\n   * ```\n   *\n   * @korean 뼈위치설정\n   */\n  position(bone: BoneName, x: number, y: number, z: number): this {\n    this.positions.set(bone, new THREE.Vector3(x, y, z));\n    return this;\n  }\n\n  /**\n   * Apply Korean guard position to arms\n   *\n   * Sets proper Korean martial arts guard positions (막기자세) for defensive posture.\n   * Supports applying guard to one side or both sides.\n   *\n   * @param guardType - Type of guard (\"HIGH_GUARD\" | \"MIDDLE_GUARD\" | \"LOW_GUARD\")\n   * @param side - Which side to apply (\"left\" | \"right\" | \"both\")\n   * @returns this for chaining\n   *\n   * @example\n   * ```typescript\n   * // Apply middle guard to both hands\n   * kf.withGuard(\"MIDDLE_GUARD\");\n   *\n   * // Apply middle guard only to left hand (right hand attacks)\n   * kf.withGuard(\"MIDDLE_GUARD\", \"left\");\n   * ```\n   *\n   * @korean 방어자세적용\n   */\n  withGuard(\n    guardType: GuardPositionType,\n    side: \"left\" | \"right\" | \"both\" = \"both\",\n  ): this {\n    const guard = getGuardPosition(guardType);\n\n    if (side === \"left\" || side === \"both\") {\n      this.rotate(\n        BoneName.SHOULDER_L,\n        guard.left.shoulder[0],\n        guard.left.shoulder[1],\n        guard.left.shoulder[2],\n      );\n      this.rotate(\n        BoneName.ELBOW_L,\n        guard.left.elbow[0],\n        guard.left.elbow[1],\n        guard.left.elbow[2],\n      );\n      this.rotate(\n        BoneName.WRIST_L,\n        guard.left.wrist[0],\n        guard.left.wrist[1],\n        guard.left.wrist[2],\n      );\n    }\n\n    if (side === \"right\" || side === \"both\") {\n      this.rotate(\n        BoneName.SHOULDER_R,\n        guard.right.shoulder[0],\n        guard.right.shoulder[1],\n        guard.right.shoulder[2],\n      );\n      this.rotate(\n        BoneName.ELBOW_R,\n        guard.right.elbow[0],\n        guard.right.elbow[1],\n        guard.right.elbow[2],\n      );\n      this.rotate(\n        BoneName.WRIST_R,\n        guard.right.wrist[0],\n        guard.right.wrist[1],\n        guard.right.wrist[2],\n      );\n    }\n\n    return this;\n  }\n\n  // ═══════════════════════════════════════════════════════════════════════════\n  // ANATOMY STATE SETTERS (해부학 상태 설정)\n  // ═══════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Set left hand pose for this keyframe\n   *\n   * @param pose - Hand pose type (e.g., \"fist\", \"knife_hand\", \"open\")\n   * @param highlightMode - Optional highlight mode for striking surface\n   * @returns this for chaining\n   *\n   * @korean 왼손자세설정\n   */\n  setLeftHandPose(pose: string, highlightMode?: HandHighlightMode): this {\n    this._leftHandPose = pose;\n    if (highlightMode) {\n      this._leftHandHighlightMode = highlightMode;\n    }\n    return this;\n  }\n\n  /**\n   * Set right hand pose for this keyframe\n   *\n   * @param pose - Hand pose type (e.g., \"fist\", \"knife_hand\", \"open\")\n   * @param highlightMode - Optional highlight mode for striking surface\n   * @returns this for chaining\n   *\n   * @korean 오른손자세설정\n   */\n  setRightHandPose(pose: string, highlightMode?: HandHighlightMode): this {\n    this._rightHandPose = pose;\n    if (highlightMode) {\n      this._rightHandHighlightMode = highlightMode;\n    }\n    return this;\n  }\n\n  /**\n   * Set both hands to the same pose\n   *\n   * @param pose - Hand pose type for both hands\n   * @returns this for chaining\n   *\n   * @korean 양손자세설정\n   */\n  setBothHandPoses(pose: string): this {\n    this._leftHandPose = pose;\n    this._rightHandPose = pose;\n    return this;\n  }\n\n  /**\n   * Set foot highlight state for kicks\n   *\n   * @param side - Which foot (\"left\" | \"right\" | \"both\")\n   * @param highlighted - Whether to highlight\n   * @returns this for chaining\n   *\n   * @korean 발강조설정\n   */\n  setFootHighlight(\n    side: \"left\" | \"right\" | \"both\",\n    highlighted: boolean,\n  ): this {\n    if (side === \"left\" || side === \"both\") {\n      this._leftFootHighlight = highlighted;\n    }\n    if (side === \"right\" || side === \"both\") {\n      this._rightFootHighlight = highlighted;\n    }\n    return this;\n  }\n\n  /**\n   * Set facial expression for this keyframe\n   *\n   * @param expression - Facial expression (e.g., \"neutral\", \"focused\", \"pained\")\n   * @returns this for chaining\n   *\n   * @korean 얼굴표정설정\n   */\n  setFacialExpression(expression: string): this {\n    this._facialExpression = expression;\n    return this;\n  }\n\n  /**\n   * Set muscle activation target for this keyframe\n   *\n   * @param muscleGroup - Muscle group name (e.g., \"BICEP_R\", \"QUAD_L\")\n   * @param tension - Tension level (0-1)\n   * @returns this for chaining\n   *\n   * @korean 근육활성화설정\n   */\n  setMuscleActivation(muscleGroup: string, tension: number): this {\n    this._muscleActivations ??= new Map();\n    this._muscleActivations.set(muscleGroup, Math.max(0, Math.min(1, tension)));\n    return this;\n  }\n\n  /**\n   * Set multiple muscle activations at once\n   *\n   * @param activations - Map or object of muscle group to tension\n   * @returns this for chaining\n   *\n   * @korean 다중근육활성화설정\n   */\n  setMuscleActivations(\n    activations: Map<string, number> | Record<string, number>,\n  ): this {\n    this._muscleActivations ??= new Map();\n    if (activations instanceof Map) {\n      activations.forEach((tension, group) => {\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- initialized above\n        this._muscleActivations!.set(group, Math.max(0, Math.min(1, tension)));\n      });\n    } else {\n      Object.entries(activations).forEach(([group, tension]) => {\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- initialized above\n        this._muscleActivations!.set(group, Math.max(0, Math.min(1, tension)));\n      });\n    }\n    return this;\n  }\n\n  /**\n   * Complete keyframe configuration and return to builder\n   *\n   * @returns Parent builder for method chaining\n   * @throws Error if not associated with a builder\n   *\n   * @korean 키프레임완료\n   */\n  done<T extends AnimationBuilderLike>(): T {\n    if (!this.builder) {\n      throw new Error(\"KeyframeConfig not associated with builder\");\n    }\n    this.builder._addKeyframe({\n      time: this.time,\n      easing: this.easing as \"linear\" | \"ease-in\" | \"ease-out\" | \"ease-in-out\",\n      boneRotations: this.rotations,\n      bonePositions: this.positions,\n      // Anatomy state\n      leftHandPose: this._leftHandPose,\n      rightHandPose: this._rightHandPose,\n      leftHandHighlightMode: this._leftHandHighlightMode,\n      rightHandHighlightMode: this._rightHandHighlightMode,\n      leftFootHighlight: this._leftFootHighlight,\n      rightFootHighlight: this._rightFootHighlight,\n      facialExpression: this._facialExpression,\n      muscleActivations: this._muscleActivations,\n    });\n    return this.builder as T;\n  }\n}\n"],"mappings":"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"}