blacktrigram 0.7.2

package/lib/types/injury.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injury.js","names":[],"sources":["../../src/types/injury.ts"],"sourcesContent":["/**\n * Shared Injury Types\n * \n * **Korean**: 공유 부상 타입\n * \n * Common injury types and data structures used across the trauma visualization\n * system. Separated from React components to avoid coupling system logic to UI.\n * \n * @module types/injury\n * @category Types\n * @korean 부상타입\n */\n\nimport { BodyRegion } from \"./common\";\n\n/**\n * Injury type classification\n * \n * **Korean**: 부상 유형 분류\n * \n * @public\n */\nexport enum InjuryType {\n  /** Blunt force trauma */\n  BRUISE = \"bruise\",\n  /** Sharp weapon/strike */\n  CUT = \"cut\",\n  /** Deep cut with blood trail */\n  LACERATION = \"laceration\",\n  /** Bone damage indicator */\n  FRACTURE = \"fracture\",\n}\n\n/**\n * Individual injury data for visualization\n * \n * **Korean**: 시각화를 위한 개별 부상 데이터\n * \n * Used by both the injury tracking system and trauma visualization components.\n * \n * @public\n */\nexport interface Injury {\n  /** Unique identifier */\n  readonly id: string;\n  /** Body region affected */\n  readonly region: BodyRegion;\n  /** Type of injury */\n  readonly type: InjuryType;\n  /** Position on body [x, y, z] relative to character center */\n  readonly position: [number, number, number];\n  /** Severity (0.0 to 1.0) */\n  readonly severity: number;\n  /** Number of hits to same location (for progressive bruising) */\n  readonly hitCount: number;\n  /** Timestamp when injury was created */\n  readonly timestamp: number;\n  /** Optional player ID for multi-player scenarios */\n  readonly playerId?: string | number;\n}\n"],"mappings":";;;;;;;;AAsBA,IAAY,aAAL,yBAAA,YAAA;;AAEL,YAAA,YAAA;;AAEA,YAAA,SAAA;;AAEA,YAAA,gBAAA;;AAEA,YAAA,cAAA;;KACD"}

package/lib/types/muscle.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Muscle system type definitions for realistic body tension and physiology
+ *
+ * Implements dynamic muscle flex and tension visualization during combat techniques.
+ * Muscles expand (up to +30%) during technique execution and relax gradually afterward.
+ *
+ * @module types/muscle
+ * @category Combat Systems
+ * @korean 근육시스템타입정의
+ */
+import type * as THREE from "three";
+/**
+ * Muscle group names for anatomical targeting
+ *
+ * @korean 근육그룹이름
+ */
+export type MuscleGroupName = "SHOULDER_L" | "SHOULDER_R" | "BICEP_L" | "BICEP_R" | "TRICEP_L" | "TRICEP_R" | "FOREARM_L" | "FOREARM_R" | "PECTORALS" | "CORE" | "ABS" | "OBLIQUES" | "LOWER_ABS" | "LAT_L" | "LAT_R" | "TRAPEZIUS" | "RHOMBOID" | "ERECTOR_SPINAE_L" | "ERECTOR_SPINAE_R" | "HIP_FLEXOR_L" | "HIP_FLEXOR_R" | "QUAD_L" | "QUAD_R" | "HAMSTRING_L" | "HAMSTRING_R" | "CALF_L" | "CALF_R" | "GLUTE_L" | "GLUTE_R";
+/**
+ * Muscle group definition with anatomical positioning and flex properties
+ *
+ * @korean 근육그룹정의
+ */
+export interface MuscleGroup {
+    /** Unique muscle group name */
+    readonly name: MuscleGroupName;
+    /** Base scale when relaxed (normal size) */
+    readonly baseScale: THREE.Vector3;
+    /** Maximum scale when fully flexed (+30% size) */
+    readonly maxFlexScale: THREE.Vector3;
+    /** Position relative to character center */
+    readonly position: THREE.Vector3;
+    /** Geometry parameters for creating instances */
+    readonly geometryParams: {
+        readonly radius: number;
+        readonly length: number;
+        readonly capSegments: number;
+        readonly radialSegments: number;
+    };
+    /** Korean name for bilingual support */
+    readonly korean: string;
+    /** English name for bilingual support */
+    readonly english: string;
+}
+/**
+ * Real-time muscle activation state for a single muscle group
+ *
+ * Updated at 60fps during combat animations.
+ *
+ * @korean 근육활성화상태
+ */
+export interface MuscleActivationState {
+    /** Muscle group identifier */
+    readonly muscleGroup: MuscleGroupName;
+    /** Current tension level (0.0 = relaxed, 1.0 = maximum flex) */
+    tension: number;
+    /** Target tension level for smooth transitions (mutable for performance) */
+    targetTension: number;
+    /** Whether this muscle is currently shaking due to exhaustion */
+    isShaking: boolean;
+}
+/**
+ * Muscle activation mapping for techniques
+ *
+ * Maps muscle groups to their target tension levels (0-1) for a specific technique.
+ *
+ * @example
+ * ```typescript
+ * const jabActivation: MuscleActivationMap = new Map([
+ *   ["SHOULDER_R", 0.7],
+ *   ["BICEP_R", 1.0],  // Maximum flex
+ *   ["TRICEP_R", 0.8],
+ *   ["CORE", 0.5]
+ * ]);
+ * ```
+ *
+ * @korean 근육활성화매핑
+ */
+export type MuscleActivationMap = Map<MuscleGroupName, number>;
+/**
+ * Props for MuscleMesh component rendering individual muscles
+ *
+ * @korean 근육메시속성
+ */
+export interface MuscleMeshProps {
+    /** Muscle group definition with geometry and positioning */
+    readonly muscleGroup: MuscleGroup;
+    /** Current tension level (0.0 to 1.0) */
+    readonly tension: number;
+    /** Whether muscle should shake (exhaustion effect) */
+    readonly isShaking: boolean;
+    /** Base color for muscle rendering */
+    readonly color?: number;
+    /** Metalness for material (default: 0.1) */
+    readonly metalness?: number;
+    /** Roughness for material (default: 0.9) */
+    readonly roughness?: number;
+}
+/**
+ * Configuration for muscle system performance
+ *
+ * @korean 근육시스템성능설정
+ */
+export interface MuscleSystemConfig {
+    /** Target frame time budget in milliseconds (default: 3ms) */
+    readonly maxFrameTime: number;
+    /** Number of muscle groups to render (default: 20) */
+    readonly muscleCount: number;
+    /** Whether to use instancing for optimization (default: false for now) */
+    readonly useInstancing: boolean;
+    /** Relaxation time after technique in seconds (default: 0.3s) */
+    readonly relaxationDelay: number;
+    /** Stamina threshold for exhaustion effects (default: 20%) */
+    readonly exhaustionThreshold: number;
+    /** Shake frequency in Hz when exhausted (default: 20Hz) */
+    readonly shakeFrequency: number;
+    /** Shake amplitude when exhausted (default: 0.02 radians) */
+    readonly shakeAmplitude: number;
+    /** Speed of muscle activation transitions (default: 5.0) */
+    readonly activationSpeed: number;
+    /** Speed of muscle relaxation transitions (default: 3.0) */
+    readonly relaxationSpeed: number;
+    /** Tension threshold for shaking effect (default: 0.3) */
+    readonly shakingTensionThreshold: number;
+}
+/**
+ * Default muscle system configuration
+ *
+ * @korean 기본근육시스템설정
+ */
+export declare const DEFAULT_MUSCLE_CONFIG: MuscleSystemConfig;
+/**
+ * Performance metrics for muscle system monitoring
+ *
+ * @korean 근육시스템성능지표
+ */
+export interface MuscleSystemMetrics {
+    /** Current frame time in milliseconds */
+    readonly frameTime: number;
+    /** Number of active muscle groups being updated */
+    readonly activeMuscles: number;
+    /** Number of muscles currently shaking */
+    readonly shakingMuscles: number;
+    /** Whether system is within performance budget */
+    readonly withinBudget: boolean;
+}
+//# sourceMappingURL=muscle.d.ts.map

package/lib/types/muscle.d.ts.map

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

package/lib/types/muscle.js

@@ -0,0 +1,22 @@
+//#region src/types/muscle.ts
+/**
+* Default muscle system configuration
+*
+* @korean 기본근육시스템설정
+*/
+var DEFAULT_MUSCLE_CONFIG = {
+	maxFrameTime: 3,
+	muscleCount: 20,
+	useInstancing: false,
+	relaxationDelay: .3,
+	exhaustionThreshold: 20,
+	shakeFrequency: 20,
+	shakeAmplitude: .02,
+	activationSpeed: 5,
+	relaxationSpeed: 3,
+	shakingTensionThreshold: .3
+};
+//#endregion
+export { DEFAULT_MUSCLE_CONFIG };
+
+//# sourceMappingURL=muscle.js.map

package/lib/types/muscle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muscle.js","names":[],"sources":["../../src/types/muscle.ts"],"sourcesContent":["/**\n * Muscle system type definitions for realistic body tension and physiology\n *\n * Implements dynamic muscle flex and tension visualization during combat techniques.\n * Muscles expand (up to +30%) during technique execution and relax gradually afterward.\n *\n * @module types/muscle\n * @category Combat Systems\n * @korean 근육시스템타입정의\n */\n\nimport type * as THREE from \"three\";\n\n/**\n * Muscle group names for anatomical targeting\n *\n * @korean 근육그룹이름\n */\nexport type MuscleGroupName =\n  // Shoulders\n  | \"SHOULDER_L\"\n  | \"SHOULDER_R\"\n  // Arms\n  | \"BICEP_L\"\n  | \"BICEP_R\"\n  | \"TRICEP_L\"\n  | \"TRICEP_R\"\n  | \"FOREARM_L\"\n  | \"FOREARM_R\"\n  // Torso front\n  | \"PECTORALS\"\n  | \"CORE\"\n  | \"ABS\"\n  | \"OBLIQUES\"\n  | \"LOWER_ABS\"\n  // Torso back (new - for less boxy appearance)\n  | \"LAT_L\"\n  | \"LAT_R\"\n  | \"TRAPEZIUS\"\n  | \"RHOMBOID\"\n  | \"ERECTOR_SPINAE_L\"\n  | \"ERECTOR_SPINAE_R\"\n  // Hips/Pelvis (new - for hip definition)\n  | \"HIP_FLEXOR_L\"\n  | \"HIP_FLEXOR_R\"\n  // Legs\n  | \"QUAD_L\"\n  | \"QUAD_R\"\n  | \"HAMSTRING_L\"\n  | \"HAMSTRING_R\"\n  | \"CALF_L\"\n  | \"CALF_R\"\n  | \"GLUTE_L\"\n  | \"GLUTE_R\";\n\n/**\n * Muscle group definition with anatomical positioning and flex properties\n *\n * @korean 근육그룹정의\n */\nexport interface MuscleGroup {\n  /** Unique muscle group name */\n  readonly name: MuscleGroupName;\n\n  /** Base scale when relaxed (normal size) */\n  readonly baseScale: THREE.Vector3;\n\n  /** Maximum scale when fully flexed (+30% size) */\n  readonly maxFlexScale: THREE.Vector3;\n\n  /** Position relative to character center */\n  readonly position: THREE.Vector3;\n\n  /** Geometry parameters for creating instances */\n  readonly geometryParams: {\n    readonly radius: number;\n    readonly length: number;\n    readonly capSegments: number;\n    readonly radialSegments: number;\n  };\n\n  /** Korean name for bilingual support */\n  readonly korean: string;\n\n  /** English name for bilingual support */\n  readonly english: string;\n}\n\n/**\n * Real-time muscle activation state for a single muscle group\n *\n * Updated at 60fps during combat animations.\n *\n * @korean 근육활성화상태\n */\nexport interface MuscleActivationState {\n  /** Muscle group identifier */\n  readonly muscleGroup: MuscleGroupName;\n\n  /** Current tension level (0.0 = relaxed, 1.0 = maximum flex) */\n  tension: number;\n\n  /** Target tension level for smooth transitions (mutable for performance) */\n  targetTension: number;\n\n  /** Whether this muscle is currently shaking due to exhaustion */\n  isShaking: boolean;\n}\n\n/**\n * Muscle activation mapping for techniques\n *\n * Maps muscle groups to their target tension levels (0-1) for a specific technique.\n *\n * @example\n * ```typescript\n * const jabActivation: MuscleActivationMap = new Map([\n *   [\"SHOULDER_R\", 0.7],\n *   [\"BICEP_R\", 1.0],  // Maximum flex\n *   [\"TRICEP_R\", 0.8],\n *   [\"CORE\", 0.5]\n * ]);\n * ```\n *\n * @korean 근육활성화매핑\n */\nexport type MuscleActivationMap = Map<MuscleGroupName, number>;\n\n/**\n * Props for MuscleMesh component rendering individual muscles\n *\n * @korean 근육메시속성\n */\nexport interface MuscleMeshProps {\n  /** Muscle group definition with geometry and positioning */\n  readonly muscleGroup: MuscleGroup;\n\n  /** Current tension level (0.0 to 1.0) */\n  readonly tension: number;\n\n  /** Whether muscle should shake (exhaustion effect) */\n  readonly isShaking: boolean;\n\n  /** Base color for muscle rendering */\n  readonly color?: number;\n\n  /** Metalness for material (default: 0.1) */\n  readonly metalness?: number;\n\n  /** Roughness for material (default: 0.9) */\n  readonly roughness?: number;\n}\n\n/**\n * Configuration for muscle system performance\n *\n * @korean 근육시스템성능설정\n */\nexport interface MuscleSystemConfig {\n  /** Target frame time budget in milliseconds (default: 3ms) */\n  readonly maxFrameTime: number;\n\n  /** Number of muscle groups to render (default: 20) */\n  readonly muscleCount: number;\n\n  /** Whether to use instancing for optimization (default: false for now) */\n  readonly useInstancing: boolean;\n\n  /** Relaxation time after technique in seconds (default: 0.3s) */\n  readonly relaxationDelay: number;\n\n  /** Stamina threshold for exhaustion effects (default: 20%) */\n  readonly exhaustionThreshold: number;\n\n  /** Shake frequency in Hz when exhausted (default: 20Hz) */\n  readonly shakeFrequency: number;\n\n  /** Shake amplitude when exhausted (default: 0.02 radians) */\n  readonly shakeAmplitude: number;\n\n  /** Speed of muscle activation transitions (default: 5.0) */\n  readonly activationSpeed: number;\n\n  /** Speed of muscle relaxation transitions (default: 3.0) */\n  readonly relaxationSpeed: number;\n\n  /** Tension threshold for shaking effect (default: 0.3) */\n  readonly shakingTensionThreshold: number;\n}\n\n/**\n * Default muscle system configuration\n *\n * @korean 기본근육시스템설정\n */\nexport const DEFAULT_MUSCLE_CONFIG: MuscleSystemConfig = {\n  maxFrameTime: 3, // 3ms target\n  muscleCount: 20,\n  useInstancing: false,\n  relaxationDelay: 0.3, // 0.3 seconds\n  exhaustionThreshold: 20, // 20% stamina\n  shakeFrequency: 20, // 20Hz\n  shakeAmplitude: 0.02, // 0.02 radians\n  activationSpeed: 5.0, // Fast activation\n  relaxationSpeed: 3.0, // Slower relaxation for realism\n  shakingTensionThreshold: 0.3, // 30% tension minimum for shaking\n} as const;\n\n/**\n * Performance metrics for muscle system monitoring\n *\n * @korean 근육시스템성능지표\n */\nexport interface MuscleSystemMetrics {\n  /** Current frame time in milliseconds */\n  readonly frameTime: number;\n\n  /** Number of active muscle groups being updated */\n  readonly activeMuscles: number;\n\n  /** Number of muscles currently shaking */\n  readonly shakingMuscles: number;\n\n  /** Whether system is within performance budget */\n  readonly withinBudget: boolean;\n}\n"],"mappings":";;;;;;AAmMA,IAAa,wBAA4C;CACvD,cAAc;CACd,aAAa;CACb,eAAe;CACf,iBAAiB;CACjB,qBAAqB;CACrB,gBAAgB;CAChB,gBAAgB;CAChB,iBAAiB;CACjB,iBAAiB;CACjB,yBAAyB;CAC1B"}