blacktrigram 0.7.2

package/lib/audio/AudioUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioUtils.js","names":[],"sources":["../../src/audio/AudioUtils.ts"],"sourcesContent":["/**\n * Audio utility functions for Korean martial arts game\n */\n\nimport type { AudioFormat } from \"./types\";\n\nexport const AUDIO_FORMATS: readonly AudioFormat[] = [\n  \"audio/webm\",\n  \"audio/mp3\",\n  \"audio/wav\",\n  \"audio/ogg\",\n] as const;\n\n/**\n * Select the best available audio format based on browser support\n */\nexport function selectAudioFormat(\n  availableFormats: readonly AudioFormat[],\n  preferredFormats: readonly AudioFormat[] = AUDIO_FORMATS\n): AudioFormat | null {\n  // Check each preferred format against available formats\n  for (const preferred of preferredFormats) {\n    if (availableFormats.includes(preferred) && canPlayType(preferred)) {\n      return preferred;\n    }\n  }\n\n  // If no preferred format is available, return the first available that can be played\n  for (const format of availableFormats) {\n    if (canPlayType(format)) {\n      return format;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Get preferred audio URLs based on format selection\n * Returns an array of URLs to try in order of preference\n */\nexport function getPreferredFormat(\n  availableFormats: readonly AudioFormat[],\n  basePath: string\n): string[] {\n  const selectedFormat = selectAudioFormat(availableFormats);\n\n  if (!selectedFormat) {\n    // Fallback to first format if none can be determined\n    const fallbackFormat = availableFormats[0];\n    if (fallbackFormat) {\n      const extension = fallbackFormat.replace(\"audio/\", \"\");\n      return [`${basePath}.${extension}`];\n    }\n    return [];\n  }\n\n  const extension = selectedFormat.replace(\"audio/\", \"\");\n  return [`${basePath}.${extension}`];\n}\n\n/**\n * Check if the browser can play a specific audio type\n */\nexport function canPlayType(format: AudioFormat): boolean {\n  if (typeof Audio === \"undefined\") {\n    // In test environment, mock basic support\n    return [\"audio/mp3\", \"audio/wav\"].includes(format);\n  }\n\n  const audio = new Audio();\n  const support = audio.canPlayType(format);\n  return support === \"probably\" || support === \"maybe\";\n}\n\n/**\n * Clamp volume to valid range (0-1)\n */\nexport function clampVolume(volume: number): number {\n  return Math.max(0, Math.min(1, volume));\n}\n\n/**\n * Get metadata for the best available format\n */\nexport function getBestFormatMetadata(\n  availableFormats: readonly AudioFormat[]\n) {\n  const selectedFormat = selectAudioFormat(availableFormats);\n  return {\n    format: selectedFormat,\n    supported: selectedFormat ? canPlayType(selectedFormat) : false,\n    quality: getFormatQuality(selectedFormat),\n  };\n}\n\nfunction getFormatQuality(\n  format: AudioFormat | null\n): \"high\" | \"medium\" | \"low\" {\n  if (!format) return \"low\";\n\n  switch (format) {\n    case \"audio/wav\":\n      return \"high\";\n    case \"audio/webm\":\n    case \"audio/ogg\":\n      return \"medium\";\n    case \"audio/mp3\":\n    default:\n      return \"medium\";\n  }\n}\n\nexport class AudioUtils {\n  /**\n   * Check if browser can play audio type\n   */\n  static canPlayType(mimeType: string): boolean {\n    const audio = new Audio();\n    const canPlay = audio.canPlayType(mimeType);\n    return canPlay === \"probably\" || canPlay === \"maybe\";\n  }\n\n  /**\n   * Select best audio format from available options\n   */\n  static selectAudioFormat(\n    available: readonly AudioFormat[],\n    preferred: readonly AudioFormat[] = [\n      \"audio/mp3\",\n      \"audio/wav\",\n      \"audio/ogg\",\n      \"audio/webm\",\n    ]\n  ): AudioFormat | null {\n    // Convert to mutable arrays for processing\n    const availableFormats: AudioFormat[] = [...available];\n    const preferredFormats: AudioFormat[] = [...preferred];\n\n    // Find first preferred format that is both available and supported\n    for (const format of preferredFormats) {\n      if (availableFormats.includes(format) && this.canPlayType(format)) {\n        return format;\n      }\n    }\n\n    // Fallback: find any available format that is supported\n    for (const format of availableFormats) {\n      if (this.canPlayType(format)) {\n        return format;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Get best format metadata\n   */\n  static getBestFormatMetadata(formats: readonly AudioFormat[]): {\n    format: AudioFormat | null;\n    supported: boolean;\n    confidence: string;\n  } {\n    const selectedFormat = this.selectAudioFormat(formats);\n\n    if (!selectedFormat) {\n      return {\n        format: null,\n        supported: false,\n        confidence: \"\",\n      };\n    }\n\n    const audio = new Audio();\n    const confidence = audio.canPlayType(selectedFormat);\n\n    return {\n      format: selectedFormat,\n      supported: this.canPlayType(selectedFormat),\n      confidence,\n    };\n  }\n}\n\n/**\n * Detect supported audio formats in the current browser\n */\nexport function detectSupportedFormats(): AudioFormat[] {\n  const audio = new Audio();\n  const formats: AudioFormat[] = [];\n\n  if (audio.canPlayType(\"audio/mp3\")) {\n    formats.push(\"audio/mp3\");\n  }\n\n  if (audio.canPlayType(\"audio/wav\")) {\n    formats.push(\"audio/wav\");\n  }\n\n  if (audio.canPlayType(\"audio/ogg\")) {\n    formats.push(\"audio/ogg\");\n  }\n\n  if (audio.canPlayType(\"audio/webm\")) {\n    formats.push(\"audio/webm\");\n  }\n\n  return formats;\n}\n\n/**\n * Create and configure an audio element\n */\nexport function createAudioElement(\n  url: string,\n  volume: number = 1.0\n): HTMLAudioElement {\n  const audio = new Audio(url);\n  audio.volume = volume;\n  audio.preload = \"auto\";\n  return audio;\n}\n\n/**\n * Validate audio URL format\n */\nexport function validateAudioUrl(url: string): boolean {\n  return typeof url === \"string\" && url.length > 0;\n}\n\n/**\n * Normalize volume to range [0, 1]\n */\nexport function normalizeVolume(volume: number): number {\n  return Math.max(0, Math.min(1, volume));\n}\n\n/**\n * Format audio duration from seconds to mm:ss\n */\nexport function formatDuration(seconds: number): string {\n  const minutes = Math.floor(seconds / 60);\n  const remainingSeconds = Math.floor(seconds % 60);\n  return `${minutes}:${remainingSeconds.toString().padStart(2, \"0\")}`;\n}\n\n/**\n * Check if the Audio API is supported\n */\nexport function isAudioSupported(): boolean {\n  return typeof Audio !== \"undefined\";\n}\n\n/**\n * Get the optimal audio format from supported formats\n */\nexport function getOptimalFormat(\n  supportedFormats: AudioFormat[]\n): AudioFormat | null {\n  const preferredOrder: AudioFormat[] = [\n    \"audio/webm\",\n    \"audio/mp3\",\n    \"audio/wav\",\n    \"audio/ogg\",\n  ];\n\n  for (const format of preferredOrder) {\n    if (supportedFormats.includes(format)) {\n      return format;\n    }\n  }\n\n  return supportedFormats.length > 0 ? supportedFormats[0] : null;\n}\n"],"mappings":"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"}

package/lib/audio/BoneImpactAudioMap.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Body Region Sound Mapping for Black Trigram
+ * Maps body regions and impact intensities to existing audio assets
+ *
+ * Uses only existing sound files - no new audio creation needed:
+ * - hit_flesh_* for soft tissue impacts
+ * - hit_light_* for minor bone contact
+ * - hit_medium_* for solid bone impacts
+ * - hit_heavy_* for devastating bone damage
+ * - hit_critical_* for fracture-level and vital point strikes
+ * - body_realistic_sound_* as ambient bone/flesh mixing
+ */
+import { AudioBodyRegion, ImpactIntensity } from "./types";
+/**
+ * Body region to sound ID mapping
+ * Returns base sound ID without variant number
+ */
+export declare const BODY_REGION_SOUND_MAP: Record<AudioBodyRegion, Record<ImpactIntensity, string>>;
+/**
+ * Number of audio variants per sound type
+ * Used for random selection in combat
+ */
+export declare const SOUND_VARIANT_COUNTS: Record<string, number>;
+/**
+ * Volume multipliers based on impact intensity
+ * Higher damage = louder sounds (as per requirements)
+ */
+export declare const IMPACT_VOLUME_MULTIPLIERS: Record<ImpactIntensity, number>;
+/**
+ * Get sound ID for a bone impact event
+ * @param region - Body region struck
+ * @param intensity - Impact intensity level
+ * @param randomize - Whether to add random variant (default: true)
+ * @returns Sound ID to play (e.g., "hit_critical_3")
+ */
+export declare function getBoneImpactSoundId(region: AudioBodyRegion, intensity: ImpactIntensity, randomize?: boolean): string;
+/**
+ * Calculate impact intensity from damage amount
+ * @param damage - Damage dealt in attack
+ * @param remainingHealth - Target's remaining health (for fracture detection)
+ * @param isVitalPoint - Whether strike hit a vital point
+ * @returns Impact intensity level
+ */
+export declare function calculateImpactIntensity(damage: number, remainingHealth?: number, isVitalPoint?: boolean): ImpactIntensity;
+/**
+ * Detect body region from 3D hit coordinates
+ * Uses Y-axis (vertical) and X-axis (horizontal) to determine region
+ *
+ * @param hitPosition - 3D position where strike landed
+ * @param characterHeight - Total height of character model (default: 2.0)
+ * @returns Body region struck
+ */
+export declare function detectAudioBodyRegion(hitPosition: {
+    x: number;
+    y: number;
+    z?: number;
+}, characterHeight?: number): AudioBodyRegion;
+/**
+ * Get volume multiplier for impact intensity
+ * @param intensity - Impact intensity level
+ * @returns Volume multiplier (0.7 to 1.3)
+ */
+export declare function getImpactVolumeMultiplier(intensity: ImpactIntensity): number;
+//# sourceMappingURL=BoneImpactAudioMap.d.ts.map

package/lib/audio/BoneImpactAudioMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoneImpactAudioMap.d.ts","sourceRoot":"","sources":["../../src/audio/BoneImpactAudioMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,eAAe,EACf,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CA0ChC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAMrE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,eAAe,EAC1B,SAAS,GAAE,OAAc,GACxB,MAAM,CAiBR;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,OAAO,GACrB,eAAe,CAqBjB;AAYD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACjD,eAAe,GAAE,MAAY,GAC5B,eAAe,CAsBjB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,CAE5E"}

package/lib/audio/BoneImpactAudioMap.js

@@ -0,0 +1,133 @@
+//#region src/audio/BoneImpactAudioMap.ts
+/**
+* Body region to sound ID mapping
+* Returns base sound ID without variant number
+*/
+var BODY_REGION_SOUND_MAP = {
+	head: {
+		light: "hit_light",
+		medium: "hit_medium",
+		heavy: "hit_heavy",
+		critical: "hit_critical",
+		fracture: "hit_critical"
+	},
+	torso: {
+		light: "hit_light",
+		medium: "hit_medium",
+		heavy: "hit_heavy",
+		critical: "hit_critical",
+		fracture: "hit_critical"
+	},
+	arms: {
+		light: "hit_flesh",
+		medium: "hit_medium",
+		heavy: "hit_heavy",
+		critical: "hit_critical",
+		fracture: "hit_critical"
+	},
+	legs: {
+		light: "hit_flesh",
+		medium: "hit_medium",
+		heavy: "hit_heavy",
+		critical: "hit_critical",
+		fracture: "hit_critical"
+	},
+	soft_tissue: {
+		light: "hit_flesh",
+		medium: "hit_flesh",
+		heavy: "body_realistic_sound",
+		critical: "hit_critical",
+		fracture: "hit_critical"
+	}
+};
+/**
+* Number of audio variants per sound type
+* Used for random selection in combat
+*/
+var SOUND_VARIANT_COUNTS = {
+	hit_flesh: 4,
+	hit_light: 4,
+	hit_medium: 4,
+	hit_heavy: 4,
+	hit_critical: 4,
+	body_realistic_sound: 1
+};
+/**
+* Volume multipliers based on impact intensity
+* Higher damage = louder sounds (as per requirements)
+*/
+var IMPACT_VOLUME_MULTIPLIERS = {
+	light: .7,
+	medium: .85,
+	heavy: 1,
+	critical: 1.15,
+	fracture: 1.3
+};
+/**
+* Get sound ID for a bone impact event
+* @param region - Body region struck
+* @param intensity - Impact intensity level
+* @param randomize - Whether to add random variant (default: true)
+* @returns Sound ID to play (e.g., "hit_critical_3")
+*/
+function getBoneImpactSoundId(region, intensity, randomize = true) {
+	const baseSoundId = BODY_REGION_SOUND_MAP[region][intensity];
+	if (!randomize) return baseSoundId;
+	const variantCount = SOUND_VARIANT_COUNTS[baseSoundId] ?? 1;
+	if (variantCount === 1) return baseSoundId;
+	return `${baseSoundId}_${Math.floor(Math.random() * variantCount) + 1}`;
+}
+/**
+* Calculate impact intensity from damage amount
+* @param damage - Damage dealt in attack
+* @param remainingHealth - Target's remaining health (for fracture detection)
+* @param isVitalPoint - Whether strike hit a vital point
+* @returns Impact intensity level
+*/
+function calculateImpactIntensity(damage, remainingHealth, isVitalPoint) {
+	if (isVitalPoint) return "critical";
+	if (remainingHealth !== void 0 && remainingHealth < 30 && damage >= 20) return "fracture";
+	if (damage >= 40) return "critical";
+	if (damage >= 25) return "heavy";
+	if (damage >= 10) return "medium";
+	return "light";
+}
+/**
+* Body region detection thresholds
+* Y-axis thresholds for vertical body regions
+*/
+var REGION_DETECTION_THRESHOLDS = {
+	HEAD_MIN: .75,
+	TORSO_MIN: .25,
+	ARMS_X_MIN: .3
+};
+/**
+* Detect body region from 3D hit coordinates
+* Uses Y-axis (vertical) and X-axis (horizontal) to determine region
+*
+* @param hitPosition - 3D position where strike landed
+* @param characterHeight - Total height of character model (default: 2.0)
+* @returns Body region struck
+*/
+function detectAudioBodyRegion(hitPosition, characterHeight = 2) {
+	const { x, y } = hitPosition;
+	const normalizedY = y / characterHeight;
+	if (normalizedY >= REGION_DETECTION_THRESHOLDS.HEAD_MIN) return "head";
+	if (normalizedY >= REGION_DETECTION_THRESHOLDS.TORSO_MIN) {
+		if (Math.abs(x) > REGION_DETECTION_THRESHOLDS.ARMS_X_MIN) return "arms";
+		return "torso";
+	}
+	return "legs";
+}
+/**
+* Get volume multiplier for impact intensity
+* @param intensity - Impact intensity level
+* @returns Volume multiplier (0.7 to 1.3)
+*/
+function getImpactVolumeMultiplier(intensity) {
+	return IMPACT_VOLUME_MULTIPLIERS[intensity];
+}
+//#endregion
+export { calculateImpactIntensity, detectAudioBodyRegion, getBoneImpactSoundId, getImpactVolumeMultiplier };
+
+//# sourceMappingURL=BoneImpactAudioMap.js.map

package/lib/audio/BoneImpactAudioMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoneImpactAudioMap.js","names":[],"sources":["../../src/audio/BoneImpactAudioMap.ts"],"sourcesContent":["/**\n * Body Region Sound Mapping for Black Trigram\n * Maps body regions and impact intensities to existing audio assets\n *\n * Uses only existing sound files - no new audio creation needed:\n * - hit_flesh_* for soft tissue impacts\n * - hit_light_* for minor bone contact\n * - hit_medium_* for solid bone impacts\n * - hit_heavy_* for devastating bone damage\n * - hit_critical_* for fracture-level and vital point strikes\n * - body_realistic_sound_* as ambient bone/flesh mixing\n */\n\nimport { AudioBodyRegion, ImpactIntensity } from \"./types\";\n\n/**\n * Body region to sound ID mapping\n * Returns base sound ID without variant number\n */\nexport const BODY_REGION_SOUND_MAP: Record<\n  AudioBodyRegion,\n  Record<ImpactIntensity, string>\n> = {\n  head: {\n    // Head strikes: skull thud, skull crack sounds\n    light: \"hit_light\", // Glancing temple/jaw hits\n    medium: \"hit_medium\", // Solid jaw/temple strikes\n    heavy: \"hit_heavy\", // Devastating skull impacts\n    critical: \"hit_critical\", // Vital point (temple, back of neck)\n    fracture: \"hit_critical\", // Skull fracture sounds (severe)\n  },\n  torso: {\n    // Torso strikes: rib impact, rib crack, internal organ thuds\n    light: \"hit_light\", // Light rib contact\n    medium: \"hit_medium\", // Solid rib/sternum impact\n    heavy: \"hit_heavy\", // Rib-breaking force, liver strikes\n    critical: \"hit_critical\", // Solar plexus, heart vital points\n    fracture: \"hit_critical\", // Multiple rib fractures, internal damage\n  },\n  arms: {\n    // Arm/limb strikes: limb bone thud, joint crack\n    light: \"hit_flesh\", // Muscle strikes, glancing blows\n    medium: \"hit_medium\", // Solid elbow/forearm bone contact\n    heavy: \"hit_heavy\", // Joint destruction (shoulder, elbow, wrist)\n    critical: \"hit_critical\", // Nerve strikes, joint breaks\n    fracture: \"hit_critical\", // Complete arm bone fracture\n  },\n  legs: {\n    // Leg strikes: knee cap, shin bone, ankle impacts\n    light: \"hit_flesh\", // Thigh muscle strikes\n    medium: \"hit_medium\", // Shin/knee bone impacts\n    heavy: \"hit_heavy\", // Knee destruction, ankle breaks\n    critical: \"hit_critical\", // Vital leg nerve strikes\n    fracture: \"hit_critical\", // Femur/tibia fractures\n  },\n  soft_tissue: {\n    // Soft tissue: muscle thud, flesh impact (no bone contact)\n    light: \"hit_flesh\", // Light muscle contact\n    medium: \"hit_flesh\", // Solid muscle compression\n    heavy: \"body_realistic_sound\", // Deep muscle trauma\n    critical: \"hit_critical\", // Soft vital points (throat, groin)\n    fracture: \"hit_critical\", // Severe soft tissue damage\n  },\n};\n\n/**\n * Number of audio variants per sound type\n * Used for random selection in combat\n */\nexport const SOUND_VARIANT_COUNTS: Record<string, number> = {\n  hit_flesh: 4,\n  hit_light: 4,\n  hit_medium: 4,\n  hit_heavy: 4,\n  hit_critical: 4,\n  body_realistic_sound: 1, // Only 1 variant available\n};\n\n/**\n * Volume multipliers based on impact intensity\n * Higher damage = louder sounds (as per requirements)\n */\nexport const IMPACT_VOLUME_MULTIPLIERS: Record<ImpactIntensity, number> = {\n  light: 0.7, // -30% volume\n  medium: 0.85, // -15% volume\n  heavy: 1.0, // Normal volume\n  critical: 1.15, // +15% volume\n  fracture: 1.3, // +30% volume (bone-breaking audio)\n};\n\n/**\n * Get sound ID for a bone impact event\n * @param region - Body region struck\n * @param intensity - Impact intensity level\n * @param randomize - Whether to add random variant (default: true)\n * @returns Sound ID to play (e.g., \"hit_critical_3\")\n */\nexport function getBoneImpactSoundId(\n  region: AudioBodyRegion,\n  intensity: ImpactIntensity,\n  randomize: boolean = true\n): string {\n  const baseSoundId = BODY_REGION_SOUND_MAP[region][intensity];\n\n  if (!randomize) {\n    return baseSoundId;\n  }\n\n  // Get variant count for this sound type\n  const variantCount = SOUND_VARIANT_COUNTS[baseSoundId] ?? 1;\n\n  if (variantCount === 1) {\n    return baseSoundId;\n  }\n\n  // Random variant selection (1 to variantCount)\n  const variant = Math.floor(Math.random() * variantCount) + 1;\n  return `${baseSoundId}_${variant}`;\n}\n\n/**\n * Calculate impact intensity from damage amount\n * @param damage - Damage dealt in attack\n * @param remainingHealth - Target's remaining health (for fracture detection)\n * @param isVitalPoint - Whether strike hit a vital point\n * @returns Impact intensity level\n */\nexport function calculateImpactIntensity(\n  damage: number,\n  remainingHealth?: number,\n  isVitalPoint?: boolean\n): ImpactIntensity {\n  // Vital point strikes are always critical (highest priority)\n  if (isVitalPoint) {\n    return \"critical\";\n  }\n\n  // Fracture detection: health below 30% + high damage\n  // Note: Assumes maxHealth = 100 (standard across codebase)\n  if (\n    remainingHealth !== undefined &&\n    remainingHealth < 30 &&\n    damage >= 20\n  ) {\n    return \"fracture\";\n  }\n\n  // Intensity based on damage amount\n  if (damage >= 40) return \"critical\";\n  if (damage >= 25) return \"heavy\";\n  if (damage >= 10) return \"medium\";\n  return \"light\";\n}\n\n/**\n * Body region detection thresholds\n * Y-axis thresholds for vertical body regions\n */\nconst REGION_DETECTION_THRESHOLDS = {\n  HEAD_MIN: 0.75,    // Top 25% of body is head\n  TORSO_MIN: 0.25,   // Middle 50% is torso (or arms)\n  ARMS_X_MIN: 0.3,   // Side hits (X > 0.3) in torso range are arms\n} as const;\n\n/**\n * Detect body region from 3D hit coordinates\n * Uses Y-axis (vertical) and X-axis (horizontal) to determine region\n *\n * @param hitPosition - 3D position where strike landed\n * @param characterHeight - Total height of character model (default: 2.0)\n * @returns Body region struck\n */\nexport function detectAudioBodyRegion(\n  hitPosition: { x: number; y: number; z?: number },\n  characterHeight: number = 2.0\n): AudioBodyRegion {\n  const { x, y } = hitPosition;\n  const normalizedY = y / characterHeight; // Normalize to 0-1 range\n\n  // Head region: top 25% of body (HEAD_MIN - 1.0)\n  if (normalizedY >= REGION_DETECTION_THRESHOLDS.HEAD_MIN) {\n    return \"head\";\n  }\n\n  // Torso region: middle 50% of body (TORSO_MIN - HEAD_MIN)\n  if (normalizedY >= REGION_DETECTION_THRESHOLDS.TORSO_MIN) {\n    // Check horizontal position for arms\n    const absX = Math.abs(x);\n    if (absX > REGION_DETECTION_THRESHOLDS.ARMS_X_MIN) {\n      // Hits on the sides are likely arms\n      return \"arms\";\n    }\n    return \"torso\";\n  }\n\n  // Legs region: bottom 25% of body (0 - TORSO_MIN)\n  return \"legs\";\n}\n\n/**\n * Get volume multiplier for impact intensity\n * @param intensity - Impact intensity level\n * @returns Volume multiplier (0.7 to 1.3)\n */\nexport function getImpactVolumeMultiplier(intensity: ImpactIntensity): number {\n  return IMPACT_VOLUME_MULTIPLIERS[intensity];\n}\n"],"mappings":";;;;;AAmBA,IAAa,wBAGT;CACF,MAAM;EAEJ,OAAO;EACP,QAAQ;EACR,OAAO;EACP,UAAU;EACV,UAAU;EACX;CACD,OAAO;EAEL,OAAO;EACP,QAAQ;EACR,OAAO;EACP,UAAU;EACV,UAAU;EACX;CACD,MAAM;EAEJ,OAAO;EACP,QAAQ;EACR,OAAO;EACP,UAAU;EACV,UAAU;EACX;CACD,MAAM;EAEJ,OAAO;EACP,QAAQ;EACR,OAAO;EACP,UAAU;EACV,UAAU;EACX;CACD,aAAa;EAEX,OAAO;EACP,QAAQ;EACR,OAAO;EACP,UAAU;EACV,UAAU;EACX;CACF;;;;;AAMD,IAAa,uBAA+C;CAC1D,WAAW;CACX,WAAW;CACX,YAAY;CACZ,WAAW;CACX,cAAc;CACd,sBAAsB;CACvB;;;;;AAMD,IAAa,4BAA6D;CACxE,OAAO;CACP,QAAQ;CACR,OAAO;CACP,UAAU;CACV,UAAU;CACX;;;;;;;;AASD,SAAgB,qBACd,QACA,WACA,YAAqB,MACb;CACR,MAAM,cAAc,sBAAsB,QAAQ;AAElD,KAAI,CAAC,UACH,QAAO;CAIT,MAAM,eAAe,qBAAqB,gBAAgB;AAE1D,KAAI,iBAAiB,EACnB,QAAO;AAKT,QAAO,GAAG,YAAY,GADN,KAAK,MAAM,KAAK,QAAQ,GAAG,aAAa,GAAG;;;;;;;;;AAW7D,SAAgB,yBACd,QACA,iBACA,cACiB;AAEjB,KAAI,aACF,QAAO;AAKT,KACE,oBAAoB,KAAA,KACpB,kBAAkB,MAClB,UAAU,GAEV,QAAO;AAIT,KAAI,UAAU,GAAI,QAAO;AACzB,KAAI,UAAU,GAAI,QAAO;AACzB,KAAI,UAAU,GAAI,QAAO;AACzB,QAAO;;;;;;AAOT,IAAM,8BAA8B;CAClC,UAAU;CACV,WAAW;CACX,YAAY;CACb;;;;;;;;;AAUD,SAAgB,sBACd,aACA,kBAA0B,GACT;CACjB,MAAM,EAAE,GAAG,MAAM;CACjB,MAAM,cAAc,IAAI;AAGxB,KAAI,eAAe,4BAA4B,SAC7C,QAAO;AAIT,KAAI,eAAe,4BAA4B,WAAW;AAGxD,MADa,KAAK,IAAI,EAAE,GACb,4BAA4B,WAErC,QAAO;AAET,SAAO;;AAIT,QAAO;;;;;;;AAQT,SAAgB,0BAA0B,WAAoC;AAC5E,QAAO,0BAA0B"}

package/lib/audio/VariantSelector.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Audio Variant Selector for Korean martial arts context
+ * Selects appropriate audio variants based on combat context and archetype
+ */
+import type { PlayerArchetype, TrigramStance } from "../types/common";
+import { MusicTrack, MusicTrackId, SoundEffect, SoundEffectId } from "./types";
+export interface AudioVariantContext {
+    readonly archetype?: PlayerArchetype;
+    readonly stance?: TrigramStance;
+    readonly intensity?: "light" | "medium" | "heavy" | "critical";
+    readonly combatPhase?: "intro" | "combat" | "victory" | "defeat";
+    readonly damageAmount?: number;
+    readonly isVitalPoint?: boolean;
+    readonly comboCount?: number;
+}
+export declare class VariantSelector {
+    /**
+     * Select the best sound variant for the given context
+     */
+    static selectSoundVariant(baseSound: SoundEffect, archetype: PlayerArchetype, stance?: TrigramStance): SoundEffect;
+    /**
+     * Select the best music variant for the given context
+     */
+    static selectMusicVariant(baseMusic: MusicTrack, archetype: PlayerArchetype, intensity?: number): MusicTrack;
+    /**
+     * Get attack sound based on damage and archetype
+     */
+    static getAttackSound(context: AudioVariantContext): SoundEffectId;
+    /**
+     * Get hit sound based on damage and vital point status
+     */
+    static getHitSound(context: AudioVariantContext): SoundEffectId;
+    /**
+     * Get appropriate music for combat phase and archetype
+     */
+    static getCombatMusic(context: AudioVariantContext): MusicTrackId;
+    /**
+     * Get stance modifier for audio selection
+     */
+    private static getStanceModifier;
+    /**
+     * Get archetype weight for variant selection
+     */
+    private static getArchetypeWeight;
+    /**
+     * Select context-appropriate audio variant
+     */
+    static selectByContext(baseAssetId: string, context: {
+        archetype: PlayerArchetype;
+        stance?: TrigramStance;
+        intensity?: number;
+    }): {
+        soundId?: string;
+        musicId?: string;
+    };
+    /**
+     * Select the best music variant for the given context
+     */
+    static selectMusicVariantForArchetype(baseMusic: MusicTrack, archetype: PlayerArchetype, intensity?: number): string;
+    /**
+     * Get random variant from available options
+     */
+    static selectRandomVariant(baseAsset: MusicTrack | SoundEffect): string;
+}
+export default VariantSelector;
+export declare function selectCombatSound(context: AudioVariantContext): SoundEffectId;
+export declare function selectHitSound(context: AudioVariantContext): SoundEffectId;
+export declare function selectCombatMusic(context: AudioVariantContext): MusicTrackId;
+//# sourceMappingURL=VariantSelector.d.ts.map

package/lib/audio/VariantSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariantSelector.d.ts","sourceRoot":"","sources":["../../src/audio/VariantSelector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE,eAAe,EAC1B,MAAM,CAAC,EAAE,aAAa,GACrB,WAAW;IA2Cd;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,eAAe,EAC1B,SAAS,GAAE,MAAY,GACtB,UAAU;IAqBb;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;IA0BlE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;IA6B/D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY;IAiBjE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAchC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAWjC;;OAEG;WACW,eAAe,CAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;QACP,SAAS,EAAE,eAAe,CAAC;QAC3B,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAQzC;;OAEG;WACW,8BAA8B,CAC1C,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,eAAe,EAC1B,SAAS,GAAE,MAAY,GACtB,MAAM;IAyBT;;OAEG;WACW,mBAAmB,CAC/B,SAAS,EAAE,UAAU,GAAG,WAAW,GAClC,MAAM;CA2BV;AAED,eAAe,eAAe,CAAC;AAG/B,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAE7E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAE1E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAE5E"}

package/lib/audio/VariantSelector.js

@@ -0,0 +1,177 @@
+//#region src/audio/VariantSelector.ts
+var VariantSelector = class {
+	/**
+	* Select the best sound variant for the given context
+	*/
+	static selectSoundVariant(baseSound, archetype, stance) {
+		if (!baseSound.variations || baseSound.variations.length === 0) return baseSound;
+		let variantIndex;
+		switch (archetype) {
+			case "musa":
+				variantIndex = 0;
+				break;
+			case "amsalja":
+				variantIndex = Math.min(1, baseSound.variations.length - 1);
+				break;
+			case "hacker":
+				variantIndex = Math.min(2, baseSound.variations.length - 1);
+				break;
+			case "jeongbo_yowon":
+				variantIndex = Math.min(3, baseSound.variations.length - 1);
+				break;
+			case "jojik_pokryeokbae":
+				variantIndex = Math.min(4, baseSound.variations.length - 1);
+				break;
+			default: variantIndex = 0;
+		}
+		if (stance) {
+			const stanceModifier = this.getStanceModifier(stance);
+			variantIndex = (variantIndex + stanceModifier) % baseSound.variations.length;
+		}
+		const selectedVariant = baseSound.variations[variantIndex];
+		return {
+			...baseSound,
+			url: selectedVariant,
+			id: `${baseSound.id}_${archetype}_${stance ?? "default"}`
+		};
+	}
+	/**
+	* Select the best music variant for the given context
+	*/
+	static selectMusicVariant(baseMusic, archetype, intensity = .5) {
+		if (!baseMusic.variations || baseMusic.variations.length === 0) return baseMusic;
+		const archetypeWeight = this.getArchetypeWeight(archetype);
+		const intensityWeight = Math.floor(intensity * 3);
+		const variantIndex = (archetypeWeight + intensityWeight) % baseMusic.variations.length;
+		const selectedVariant = baseMusic.variations[variantIndex];
+		return {
+			...baseMusic,
+			url: selectedVariant,
+			id: `${baseMusic.id}_${archetype}_intensity${intensityWeight}`,
+			volume: (baseMusic.volume ?? .7) * (.8 + intensity * .4)
+		};
+	}
+	/**
+	* Get attack sound based on damage and archetype
+	*/
+	static getAttackSound(context) {
+		const { damageAmount = 0, intensity } = context;
+		let soundIntensity = intensity;
+		if (!soundIntensity) if (damageAmount > 50) soundIntensity = "critical";
+		else if (damageAmount > 30) soundIntensity = "heavy";
+		else if (damageAmount > 15) soundIntensity = "medium";
+		else soundIntensity = "light";
+		switch (soundIntensity) {
+			case "critical": return context.isVitalPoint ? "critical_hit" : "attack_critical";
+			case "heavy": return "attack_heavy";
+			case "medium": return "attack_medium";
+			default: return "attack_light";
+		}
+	}
+	/**
+	* Get hit sound based on damage and vital point status
+	*/
+	static getHitSound(context) {
+		const { damageAmount = 0, isVitalPoint = false, intensity } = context;
+		if (isVitalPoint) return "critical_hit";
+		let soundIntensity = intensity;
+		if (!soundIntensity) if (damageAmount > 50) soundIntensity = "critical";
+		else if (damageAmount > 30) soundIntensity = "heavy";
+		else if (damageAmount > 15) soundIntensity = "medium";
+		else soundIntensity = "light";
+		switch (soundIntensity) {
+			case "critical": return "hit_critical";
+			case "heavy": return "hit_heavy";
+			case "medium": return "hit_medium";
+			default: return "hit_light";
+		}
+	}
+	/**
+	* Get appropriate music for combat phase and archetype
+	*/
+	static getCombatMusic(context) {
+		const { combatPhase = "combat" } = context;
+		switch (combatPhase) {
+			case "intro": return "intro_theme";
+			case "victory": return "victory_theme";
+			case "defeat": return "ambient_dojang";
+			default: return "combat_theme";
+		}
+	}
+	/**
+	* Get stance modifier for audio selection
+	*/
+	static getStanceModifier(stance) {
+		return {
+			geon: 0,
+			tae: 1,
+			li: 2,
+			jin: 3,
+			son: 4,
+			gam: 5,
+			gan: 6,
+			gon: 7
+		}[stance] || 0;
+	}
+	/**
+	* Get archetype weight for variant selection
+	*/
+	static getArchetypeWeight(archetype) {
+		return {
+			musa: 0,
+			amsalja: 1,
+			hacker: 2,
+			jeongbo_yowon: 3,
+			jojik_pokryeokbae: 4
+		}[archetype] || 0;
+	}
+	/**
+	* Select context-appropriate audio variant
+	*/
+	static selectByContext(baseAssetId, context) {
+		return {
+			soundId: `${baseAssetId}_${context.archetype}`,
+			musicId: `${baseAssetId}_${context.archetype}`
+		};
+	}
+	/**
+	* Select the best music variant for the given context
+	*/
+	static selectMusicVariantForArchetype(baseMusic, archetype, intensity = 1) {
+		if (!("variations" in baseMusic) || !baseMusic.variations || baseMusic.variations.length === 0) {
+			console.warn(`No variations available for music track: ${baseMusic.id}`);
+			return baseMusic.url;
+		}
+		const variantIndex = (this.getArchetypeWeight(archetype) + Math.floor(intensity * 10)) % baseMusic.variations.length;
+		const selectedVariant = baseMusic.variations[variantIndex];
+		console.log(`Selected variant for ${archetype} at intensity ${intensity}: ${selectedVariant}`);
+		return selectedVariant;
+	}
+	/**
+	* Get random variant from available options
+	*/
+	static selectRandomVariant(baseAsset) {
+		const hasVariations = (asset) => {
+			return "variations" in asset && Array.isArray(asset.variations) && asset.variations.length > 0;
+		};
+		if (!hasVariations(baseAsset)) return baseAsset.url;
+		const variations = baseAsset.variations;
+		if (!variations || variations.length === 0) return baseAsset.url;
+		const selectedVariant = variations[Math.floor(Math.random() * variations.length)];
+		console.log(`Random variant selected: ${selectedVariant}`);
+		return selectedVariant;
+	}
+};
+function selectCombatSound(context) {
+	return VariantSelector.getAttackSound(context);
+}
+function selectHitSound(context) {
+	return VariantSelector.getHitSound(context);
+}
+function selectCombatMusic(context) {
+	return VariantSelector.getCombatMusic(context);
+}
+//#endregion
+export { VariantSelector as default, selectCombatMusic, selectCombatSound, selectHitSound };
+
+//# sourceMappingURL=VariantSelector.js.map

package/lib/audio/VariantSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariantSelector.js","names":[],"sources":["../../src/audio/VariantSelector.ts"],"sourcesContent":["/**\n * Audio Variant Selector for Korean martial arts context\n * Selects appropriate audio variants based on combat context and archetype\n */\n\nimport type { PlayerArchetype, TrigramStance } from \"../types/common\";\nimport { MusicTrack, MusicTrackId, SoundEffect, SoundEffectId } from \"./types\";\n\nexport interface AudioVariantContext {\n  readonly archetype?: PlayerArchetype;\n  readonly stance?: TrigramStance;\n  readonly intensity?: \"light\" | \"medium\" | \"heavy\" | \"critical\";\n  readonly combatPhase?: \"intro\" | \"combat\" | \"victory\" | \"defeat\";\n  readonly damageAmount?: number;\n  readonly isVitalPoint?: boolean;\n  readonly comboCount?: number;\n}\n\nexport class VariantSelector {\n  /**\n   * Select the best sound variant for the given context\n   */\n  static selectSoundVariant(\n    baseSound: SoundEffect,\n    archetype: PlayerArchetype,\n    stance?: TrigramStance\n  ): SoundEffect {\n    if (!baseSound.variations || baseSound.variations.length === 0) {\n      return baseSound;\n    }\n\n    // Select variant based on archetype\n    let variantIndex: number;\n    switch (archetype) {\n      case \"musa\": // Traditional warrior - use original\n        variantIndex = 0;\n        break;\n      case \"amsalja\": // Assassin - use quieter variants\n        variantIndex = Math.min(1, baseSound.variations.length - 1);\n        break;\n      case \"hacker\": // Cyber warrior - use electronic variants\n        variantIndex = Math.min(2, baseSound.variations.length - 1);\n        break;\n      case \"jeongbo_yowon\": // Intelligence - use subtle variants\n        variantIndex = Math.min(3, baseSound.variations.length - 1);\n        break;\n      case \"jojik_pokryeokbae\": // Crime - use aggressive variants\n        variantIndex = Math.min(4, baseSound.variations.length - 1);\n        break;\n      default:\n        variantIndex = 0;\n    }\n\n    // Modify based on stance if provided\n    if (stance) {\n      const stanceModifier = this.getStanceModifier(stance);\n      variantIndex =\n        (variantIndex + stanceModifier) % baseSound.variations.length;\n    }\n\n    const selectedVariant = baseSound.variations[variantIndex];\n\n    return {\n      ...baseSound,\n      url: selectedVariant,\n      id: `${baseSound.id}_${archetype}_${stance ?? \"default\"}`,\n    };\n  }\n\n  /**\n   * Select the best music variant for the given context\n   */\n  static selectMusicVariant(\n    baseMusic: MusicTrack,\n    archetype: PlayerArchetype,\n    intensity: number = 0.5\n  ): MusicTrack {\n    if (!baseMusic.variations || baseMusic.variations.length === 0) {\n      return baseMusic;\n    }\n\n    // Select based on archetype and intensity\n    const archetypeWeight = this.getArchetypeWeight(archetype);\n    const intensityWeight = Math.floor(intensity * 3); // 0-2 range\n\n    const variantIndex =\n      (archetypeWeight + intensityWeight) % baseMusic.variations.length;\n    const selectedVariant = baseMusic.variations[variantIndex];\n\n    return {\n      ...baseMusic,\n      url: selectedVariant,\n      id: `${baseMusic.id}_${archetype}_intensity${intensityWeight}`,\n      volume: (baseMusic.volume ?? 0.7) * (0.8 + intensity * 0.4), // Fix: Handle undefined volume\n    };\n  }\n\n  /**\n   * Get attack sound based on damage and archetype\n   */\n  static getAttackSound(context: AudioVariantContext): SoundEffectId {\n    const { damageAmount = 0, intensity } = context;\n\n    // Determine intensity from damage if not provided\n    let soundIntensity = intensity;\n    if (!soundIntensity) {\n      if (damageAmount > 50) soundIntensity = \"critical\";\n      else if (damageAmount > 30) soundIntensity = \"heavy\";\n      else if (damageAmount > 15) soundIntensity = \"medium\";\n      else soundIntensity = \"light\";\n    }\n\n    // Map intensity to sound ID\n    switch (soundIntensity) {\n      case \"critical\":\n        return context.isVitalPoint ? \"critical_hit\" : \"attack_critical\";\n      case \"heavy\":\n        return \"attack_heavy\";\n      case \"medium\":\n        return \"attack_medium\";\n      case \"light\":\n      default:\n        return \"attack_light\";\n    }\n  }\n\n  /**\n   * Get hit sound based on damage and vital point status\n   */\n  static getHitSound(context: AudioVariantContext): SoundEffectId {\n    const { damageAmount = 0, isVitalPoint = false, intensity } = context;\n\n    if (isVitalPoint) {\n      return \"critical_hit\";\n    }\n\n    // Determine intensity from damage if not provided\n    let soundIntensity = intensity;\n    if (!soundIntensity) {\n      if (damageAmount > 50) soundIntensity = \"critical\";\n      else if (damageAmount > 30) soundIntensity = \"heavy\";\n      else if (damageAmount > 15) soundIntensity = \"medium\";\n      else soundIntensity = \"light\";\n    }\n\n    switch (soundIntensity) {\n      case \"critical\":\n        return \"hit_critical\";\n      case \"heavy\":\n        return \"hit_heavy\";\n      case \"medium\":\n        return \"hit_medium\";\n      case \"light\":\n      default:\n        return \"hit_light\";\n    }\n  }\n\n  /**\n   * Get appropriate music for combat phase and archetype\n   */\n  static getCombatMusic(context: AudioVariantContext): MusicTrackId {\n    const { combatPhase = \"combat\" } = context;\n\n    switch (combatPhase) {\n      case \"intro\":\n        return \"intro_theme\";\n      case \"victory\":\n        return \"victory_theme\";\n      case \"defeat\":\n        return \"ambient_dojang\"; // Somber ambient for defeat\n      case \"combat\":\n      default:\n        // Could vary by archetype in full implementation\n        return \"combat_theme\";\n    }\n  }\n\n  /**\n   * Get stance modifier for audio selection\n   */\n  private static getStanceModifier(stance: TrigramStance): number {\n    const stanceMap: Record<TrigramStance, number> = {\n      geon: 0, // Heaven - original\n      tae: 1, // Lake - fluid\n      li: 2, // Fire - intense\n      jin: 3, // Thunder - explosive\n      son: 4, // Wind - swift\n      gam: 5, // Water - flowing\n      gan: 6, // Mountain - stable\n      gon: 7, // Earth - grounded\n    };\n    return stanceMap[stance] || 0;\n  }\n\n  /**\n   * Get archetype weight for variant selection\n   */\n  private static getArchetypeWeight(archetype: PlayerArchetype): number {\n    const archetypeMap: Record<PlayerArchetype, number> = {\n      musa: 0, // Traditional\n      amsalja: 1, // Stealth\n      hacker: 2, // Tech\n      jeongbo_yowon: 3, // Intelligence\n      jojik_pokryeokbae: 4, // Aggressive\n    };\n    return archetypeMap[archetype] || 0;\n  }\n\n  /**\n   * Select context-appropriate audio variant\n   */\n  public static selectByContext(\n    baseAssetId: string,\n    context: {\n      archetype: PlayerArchetype;\n      stance?: TrigramStance;\n      intensity?: number;\n    }\n  ): { soundId?: string; musicId?: string } {\n    // Return string IDs instead of typed IDs\n    return {\n      soundId: `${baseAssetId}_${context.archetype}`,\n      musicId: `${baseAssetId}_${context.archetype}`,\n    };\n  }\n\n  /**\n   * Select the best music variant for the given context\n   */\n  public static selectMusicVariantForArchetype(\n    baseMusic: MusicTrack,\n    archetype: PlayerArchetype,\n    intensity: number = 1.0\n  ): string {\n    // Fix: Check for variations property existence\n    if (\n      !(\"variations\" in baseMusic) ||\n      !baseMusic.variations ||\n      baseMusic.variations.length === 0\n    ) {\n      console.warn(`No variations available for music track: ${baseMusic.id}`);\n      return baseMusic.url;\n    }\n\n    const archetypeWeight = this.getArchetypeWeight(archetype);\n    const intensityWeight = Math.floor(intensity * 10);\n\n    const variantIndex =\n      (archetypeWeight + intensityWeight) % baseMusic.variations.length;\n    const selectedVariant = baseMusic.variations[variantIndex];\n\n    console.log(\n      `Selected variant for ${archetype} at intensity ${intensity}: ${selectedVariant}`\n    );\n\n    return selectedVariant;\n  }\n\n  /**\n   * Get random variant from available options\n   */\n  public static selectRandomVariant(\n    baseAsset: MusicTrack | SoundEffect\n  ): string {\n    // Fix: Type guard to check for variations\n    const hasVariations = (\n      asset: MusicTrack | SoundEffect\n    ): asset is SoundEffect => {\n      return (\n        \"variations\" in asset &&\n        Array.isArray(asset.variations) &&\n        asset.variations.length > 0\n      );\n    };\n\n    if (!hasVariations(baseAsset)) {\n      return baseAsset.url;\n    }\n\n    // TypeScript knows baseAsset.variations exists due to earlier check\n    const variations = baseAsset.variations;\n    if (!variations || variations.length === 0) {\n      return baseAsset.url;\n    }\n    const randomIndex = Math.floor(Math.random() * variations.length);\n    const selectedVariant = variations[randomIndex];\n\n    console.log(`Random variant selected: ${selectedVariant}`);\n    return selectedVariant;\n  }\n}\n\nexport default VariantSelector;\n\n// Export convenience functions\nexport function selectCombatSound(context: AudioVariantContext): SoundEffectId {\n  return VariantSelector.getAttackSound(context);\n}\n\nexport function selectHitSound(context: AudioVariantContext): SoundEffectId {\n  return VariantSelector.getHitSound(context);\n}\n\nexport function selectCombatMusic(context: AudioVariantContext): MusicTrackId {\n  return VariantSelector.getCombatMusic(context);\n}\n"],"mappings":"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"}

package/lib/audio/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module audio
+ * @category Audio System
+ */
+export * from "./AudioAssetRegistry";
+export * from "./AudioManager";
+export * from "./AudioProvider";
+export * from "./AudioUtils";
+export * from "./types";
+export * from "./VariantSelector";
+export * from "./AudioCache";
+export type { AudioAsset, AudioCategory, AudioPlaybackOptions, SoundEffectId, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/lib/audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAG7B,YAAY,EACV,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,SAAS,CAAC"}

package/lib/audio/index.js

@@ -0,0 +1,41 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { AudioAssetRegistry, audioAssetRegistry } from "./AudioAssetRegistry.js";
+import { AudioCache } from "./AudioCache.js";
+import AudioManager from "./AudioManager.js";
+import { AudioContext, AudioProvider, useAudio } from "./AudioProvider.js";
+import { AUDIO_FORMATS, AudioUtils, canPlayType, clampVolume, createAudioElement, detectSupportedFormats, formatDuration, getBestFormatMetadata, getOptimalFormat, getPreferredFormat, isAudioSupported, normalizeVolume, selectAudioFormat, validateAudioUrl } from "./AudioUtils.js";
+import { AudioCategory } from "./types.js";
+import VariantSelector, { selectCombatMusic, selectCombatSound, selectHitSound } from "./VariantSelector.js";
+//#region src/audio/index.ts
+var audio_exports = /* @__PURE__ */ __exportAll({
+	AUDIO_FORMATS: () => AUDIO_FORMATS,
+	AudioAssetRegistry: () => AudioAssetRegistry,
+	AudioCache: () => AudioCache,
+	AudioCategory: () => AudioCategory,
+	AudioContext: () => AudioContext,
+	AudioManager: () => AudioManager,
+	AudioProvider: () => AudioProvider,
+	AudioUtils: () => AudioUtils,
+	VariantSelector: () => VariantSelector,
+	audioAssetRegistry: () => audioAssetRegistry,
+	canPlayType: () => canPlayType,
+	clampVolume: () => clampVolume,
+	createAudioElement: () => createAudioElement,
+	detectSupportedFormats: () => detectSupportedFormats,
+	formatDuration: () => formatDuration,
+	getBestFormatMetadata: () => getBestFormatMetadata,
+	getOptimalFormat: () => getOptimalFormat,
+	getPreferredFormat: () => getPreferredFormat,
+	isAudioSupported: () => isAudioSupported,
+	normalizeVolume: () => normalizeVolume,
+	selectAudioFormat: () => selectAudioFormat,
+	selectCombatMusic: () => selectCombatMusic,
+	selectCombatSound: () => selectCombatSound,
+	selectHitSound: () => selectHitSound,
+	useAudio: () => useAudio,
+	validateAudioUrl: () => validateAudioUrl
+});
+//#endregion
+export { audio_exports };
+
+//# sourceMappingURL=index.js.map

package/lib/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/audio/index.ts"],"sourcesContent":["// filepath: /workspaces/blacktrigram/src/audio/index.ts\n/**\n * @module audio\n * @category Audio System\n */\n\nexport * from \"./AudioAssetRegistry\";\nexport * from \"./AudioManager\";\nexport * from \"./AudioProvider\";\nexport * from \"./AudioUtils\";\nexport * from \"./types\";\nexport * from \"./VariantSelector\";\nexport * from \"./AudioCache\";\n\n// Re-export types that were missing\nexport type {\n  AudioAsset,\n  AudioCategory,\n  AudioPlaybackOptions,\n  SoundEffectId,\n} from \"./types\";\n"],"mappings":""}