blacktrigram 0.7.44 → 0.7.45

package/lib/utils/skeletonScaling.d.ts

@@ -51,7 +51,6 @@ import { PhysicalAttributes } from "../types";
  * Defines how physical attributes map to skeleton bone scaling.
  * Each factor is a multiplier applied to the base bone length.
  *
- * @public
  * @korean 뼈크기비율
  */
 export interface BoneScalingFactors {
@@ -94,7 +93,6 @@ export interface BoneScalingFactors {
  * // Amsalja has smaller head: factors.head ~= 0.90 (amplified from ~0.95)
  * ```
  *
- * @public
  * @korean 뼈크기비율계산
  */
 export declare function calculateBoneScalingFactors(attributes: PhysicalAttributes): BoneScalingFactors;
@@ -116,7 +114,6 @@ export declare function calculateBoneScalingFactors(attributes: PhysicalAttribut
  * // Jojik has larger head: returns ~23cm (base 20cm * 1.15)
  * ```
  *
- * @public
  * @korean 크기조정된뼈길이
  */
 export declare function getScaledBoneLength(boneName: string, attributes: PhysicalAttributes): number;
@@ -144,7 +141,6 @@ export declare function getScaledBoneLength(boneName: string, attributes: Physic
  * // Left shoulder at -31cm, right shoulder at +31cm
  * ```
  *
- * @public
  * @korean 어깨오프셋계산
  */
 export declare function calculateShoulderOffset(attributes: PhysicalAttributes): number;
@@ -165,7 +161,6 @@ export declare function calculateShoulderOffset(attributes: PhysicalAttributes):
  * // Amsalja is tall and lean: {width: 40, height: 182, depth: 25}
  * ```
  *
- * @public
  * @korean 히트박스크기계산
  */
 export declare function calculateHitboxDimensions(attributes: PhysicalAttributes): {
@@ -192,7 +187,6 @@ export declare function calculateHitboxDimensions(attributes: PhysicalAttributes
  * // Returns offset based on head size and torso height
  * ```
  *
- * @public
  * @korean 급소위치조정
  */
 export declare function calculateVitalPointAdjustment(vitalPointId: string, attributes: PhysicalAttributes): {
@@ -219,7 +213,6 @@ export declare function calculateVitalPointAdjustment(vitalPointId: string, attr
  * // Jojik has shorter, thicker neck: returns ~0.9 (10% more resistant)
  * ```
  *
- * @public
  * @korean 목조르기효과계산
  */
 export declare function calculateChokeEffectiveness(attributes: PhysicalAttributes): number;
@@ -241,7 +234,6 @@ export declare function calculateChokeEffectiveness(attributes: PhysicalAttribut
  * // Jojik has larger head: returns ~0.95 (5% more resistant)
  * ```
  *
- * @public
  * @korean 머리타격취약성계산
  */
 export declare function calculateHeadStrikeVulnerability(attributes: PhysicalAttributes): number;
@@ -278,7 +270,6 @@ export declare function calculateHeadStrikeVulnerability(attributes: PhysicalAtt
  * // Hacker is lean (43cm shoulders): returns 0.215m
  * ```
  *
- * @public
  * @korean 몸체반경계산
  */
 export declare function calculateBodyRadius(attributes: PhysicalAttributes): number;

package/lib/utils/skeletonScaling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skeletonScaling.d.ts","sourceRoot":"","sources":["../../src/utils/skeletonScaling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAO7C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAqED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAwCpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAkDR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,kBAAkB,GAAG;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAMA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,kBAAkB,GAC7B;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CA6C1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CASR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAOR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAU1E"}
+{"version":3,"file":"skeletonScaling.d.ts","sourceRoot":"","sources":["../../src/utils/skeletonScaling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAO7C;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAqED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAwCpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAkDR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,kBAAkB,GAAG;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAMA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,kBAAkB,GAC7B;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CA6C1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CASR;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAOR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAU1E"}

package/lib/utils/skeletonScaling.js

@@ -33,7 +33,6 @@ import { REFERENCE_ATTRIBUTES as REFERENCE_ATTRIBUTES$1 } from "../constants/bod
 * // Hacker is lean (43cm shoulders): returns 0.215m
 * ```
 *
-* @public
 * @korean 몸체반경계산
 */
 function calculateBodyRadius(attributes) {

package/lib/utils/skeletonScaling.js.map

@@ -1 +1 @@
-{"version":3,"file":"skeletonScaling.js","names":[],"sources":["../../src/utils/skeletonScaling.ts"],"sourcesContent":["/**\n * Skeleton rig scaling based on physical attributes.\n *\n * **Korean**: 골격 크기 조정 (Skeleton Scaling)\n *\n * This module provides functions to scale the skeleton rig based on player\n * physical attributes, allowing each archetype to have anatomically accurate\n * body proportions that affect combat hitboxes, vital point positioning, and\n * visual representation.\n *\n * ## Visual Amplification System\n *\n * Raw physical attribute differences between archetypes are subtle (2-12%).\n * To create recognizable visual silhouettes in 3D, this system applies\n * amplification factors that enhance differences while maintaining realistic\n * proportions:\n *\n * - **Limb Scaling**: 2.5x amplification (subtle 5% difference → 12.5% visual)\n * - **Shoulder Width**: 1.15x additional amplification for silhouette distinction\n * - **Overall Height**: 1.5x amplification (kept subtle for realism)\n *\n * ### Expected Visual Silhouettes\n *\n * Each archetype has a distinct, recognizable body shape:\n *\n * - **해커 (Hacker)**: Compact, narrow shoulders (43cm), shortest limbs - SMALLEST\n * - **암살자 (Amsalja)**: Tall (186cm), lean, long limbs (102cm legs) - TALLEST\n * - **정보요원 (Jeongbo)**: Balanced, average proportions - BASELINE\n * - **무사 (Musa)**: Athletic military build (46cm shoulders) - TRADITIONAL\n * - **조직폭력배 (Jojik)**: Massive, widest shoulders (54cm), imposing - LARGEST\n *\n * ## Integration with Korean Anatomy\n *\n * The scaling system respects Korean martial arts anatomy principles:\n * - **Head vital points** (두부 급소) scale with head size\n * - **Neck vulnerability** (경부 취약성) affected by neck length\n * - **Torso vital points** (몸통 급소) distributed across torso length\n * - **Limb reach** (팔다리 거리) determined by arm/leg length\n * - **Shoulder defense** (어깨 방어) coverage from shoulder width\n *\n * @module utils/skeletonScaling\n * @category Combat System\n * @korean 골격조정\n */\n\nimport { PhysicalAttributes } from \"@/types\";\nimport { BoneName } from \"@/types/skeletal\";\nimport {\n  amplifyScaling,\n  REFERENCE_ATTRIBUTES as BODY_REFERENCE_ATTRIBUTES,\n} from \"../constants/bodyRenderingConstants\";\n\n/**\n * Bone scaling factors for each body region.\n *\n * **Korean**: 뼈 크기 비율 (Bone Scaling Factors)\n *\n * Defines how physical attributes map to skeleton bone scaling.\n * Each factor is a multiplier applied to the base bone length.\n *\n * @public\n * @korean 뼈크기비율\n */\nexport interface BoneScalingFactors {\n  /** Head bone scaling (based on headSize) */\n  readonly head: number;\n  /** Neck bone scaling (based on neckLength) */\n  readonly neck: number;\n  /** Spine bones scaling (based on torsoLength) */\n  readonly spine: number;\n  /** Upper arm bones scaling (based on armLength) */\n  readonly upperArm: number;\n  /** Forearm bones scaling (based on armLength) */\n  readonly forearm: number;\n  /** Thigh bones scaling (based on legLength) */\n  readonly thigh: number;\n  /** Shin bones scaling (based on legLength) */\n  readonly shin: number;\n  /** Shoulder bones scaling (based on shoulderWidth) */\n  readonly shoulder: number;\n  /** Overall skeleton scaling (based on totalHeight) */\n  readonly overall: number;\n}\n\n/**\n * Anatomically correct bone dimensions in centimeters.\n *\n * **Korean**: 해부학적 뼈 치수 (Anatomical Bone Dimensions)\n *\n * These are anatomically accurate bone lengths based on human proportions.\n * For a 178cm reference height, these values create a realistic skeleton.\n *\n * Reference: Human body proportions (8-head canon)\n * - Head: ~12.5% of height (22cm)\n * - Neck: ~5.5% of height (10cm)\n * - Torso: ~33% of height (59cm / 3 segments = 20cm each)\n * - Legs: ~48% of height (85cm total)\n * - Thigh: ~55% of leg length (47cm)\n * - Shin: ~45% of leg length (38cm)\n *\n * @internal\n * @korean 기본뼈치수\n */\nconst BASE_BONE_DIMENSIONS = {\n  // Head region\n  head: 22, // Head bone length in cm (12.5% of 178cm)\n  neck: 10, // Neck bone length in cm (5.5% of 178cm)\n\n  // Torso region - Total torso ~59cm for 178cm person (33%)\n  spineLower: 20, // Lower spine segment (lumbar)\n  spineMiddle: 20, // Middle spine segment (thoracic)\n  spineUpper: 19, // Upper spine segment (upper thoracic)\n  pelvis: 8, // Pelvis/root bone height (~4.5% of height)\n\n  // Arm region (one side) - Total arm ~75cm for 178cm (42% of height)\n  shoulder: 12, // Shoulder/clavicle bone (~6.5% of height)\n  upperArm: 32, // Upper arm (shoulder to elbow) - ~55% of arm\n  forearm: 27, // Forearm (elbow to wrist) - ~45% of arm (including wrist)\n  hand: 19, // Hand length (~10.5% of height)\n\n  // Leg region (one side) - Total leg ~95cm for 178cm (53% of height)\n  hip: 10, // Hip joint height\n  thigh: 48, // Thigh (hip to knee) - ~55% of leg length\n  shin: 40, // Shin (knee to ankle) - ~45% of leg length\n  foot: 5, // Foot/ankle height (ground to ankle)\n\n  // Width measurements\n  shoulderWidth: 43, // Total shoulder width (half = 21.5cm offset)\n  hipWidth: 30, // Total hip width (half = 15cm offset)\n} as const;\n\n/**\n * Reference physical attributes for baseline scaling.\n *\n * **Korean**: 기준 신체 속성 (Reference Physical Attributes)\n *\n * These represent the \"average\" Korean male fighter that the base\n * skeleton rig is designed for. Scaling is calculated relative to\n * these reference values.\n *\n * Uses centralized REFERENCE_ATTRIBUTES from bodyRenderingConstants.\n *\n * @internal\n * @korean 기준신체속성\n */\nconst REFERENCE_ATTRIBUTES: PhysicalAttributes = {\n  ...BODY_REFERENCE_ATTRIBUTES,\n};\n\n// VISUAL_AMPLIFICATION_FACTOR and amplifyScaling imported from bodyRenderingConstants\n\n/**\n * Calculate bone scaling factors from physical attributes.\n *\n * **Korean**: 뼈 크기 비율 계산 (Calculate Bone Scaling Factors)\n *\n * Computes scaling multipliers for each bone region based on the\n * player's physical attributes compared to reference values.\n * Differences are amplified for more noticeable visual distinction\n * between archetypes.\n *\n * @param attributes - Player's physical attributes\n * @returns Bone scaling factors for skeleton rig\n *\n * @example\n * ```typescript\n * const factors = calculateBoneScalingFactors(AMSALJA_PHYSICAL);\n * // Amsalja has longer legs: factors.thigh ~= 1.06 (amplified from ~1.03)\n * // Amsalja has smaller head: factors.head ~= 0.90 (amplified from ~0.95)\n * ```\n *\n * @public\n * @korean 뼈크기비율계산\n */\nexport function calculateBoneScalingFactors(\n  attributes: PhysicalAttributes,\n): BoneScalingFactors {\n  // Calculate raw scaling ratios from physical attributes\n  const rawOverall = attributes.totalHeight / REFERENCE_ATTRIBUTES.totalHeight;\n  const rawHead = attributes.headSize / REFERENCE_ATTRIBUTES.headSize;\n  const rawNeck = attributes.neckLength / REFERENCE_ATTRIBUTES.neckLength;\n  const rawSpine = attributes.torsoLength / REFERENCE_ATTRIBUTES.torsoLength;\n  const rawArm = attributes.armLength / REFERENCE_ATTRIBUTES.armLength;\n  const rawLeg = attributes.legLength / REFERENCE_ATTRIBUTES.legLength;\n  const rawShoulder =\n    attributes.shoulderWidth / REFERENCE_ATTRIBUTES.shoulderWidth;\n\n  // Apply visual amplification for more noticeable archetype differences\n  // Overall height scaling is kept subtle (1.5x) for realism\n  const overall = 1.0 + (rawOverall - 1.0) * 1.5;\n\n  // Head, neck, and body proportions are amplified for visual distinction\n  const head = amplifyScaling(rawHead);\n  const neck = amplifyScaling(rawNeck);\n  const spine = amplifyScaling(rawSpine);\n\n  // Limb proportions amplified for noticeable reach differences\n  const upperArm = amplifyScaling(rawArm);\n  const forearm = amplifyScaling(rawArm);\n  const thigh = amplifyScaling(rawLeg);\n  const shin = amplifyScaling(rawLeg);\n\n  // Shoulder width amplified for body silhouette distinction\n  const shoulder = amplifyScaling(rawShoulder);\n\n  return {\n    head,\n    neck,\n    spine,\n    upperArm,\n    forearm,\n    thigh,\n    shin,\n    shoulder,\n    overall,\n  };\n}\n\n/**\n * Get scaled bone length for a specific bone.\n *\n * **Korean**: 크기 조정된 뼈 길이 (Scaled Bone Length)\n *\n * Returns the scaled length for a specific bone based on the player's\n * physical attributes. Used when creating or updating skeleton rigs.\n *\n * @param boneName - Name of the bone to scale\n * @param attributes - Player's physical attributes\n * @returns Scaled bone length in centimeters\n *\n * @example\n * ```typescript\n * const headLength = getScaledBoneLength(BoneName.HEAD, JOJIK_PHYSICAL);\n * // Jojik has larger head: returns ~23cm (base 20cm * 1.15)\n * ```\n *\n * @public\n * @korean 크기조정된뼈길이\n */\nexport function getScaledBoneLength(\n  boneName: string,\n  attributes: PhysicalAttributes,\n): number {\n  const factors = calculateBoneScalingFactors(attributes);\n\n  // Map bone names to their base dimensions and scaling factors\n  switch (boneName) {\n    // Head region\n    case BoneName.HEAD:\n      return BASE_BONE_DIMENSIONS.head * factors.head;\n    case BoneName.NECK:\n      return BASE_BONE_DIMENSIONS.neck * factors.neck;\n\n    // Spine region\n    case BoneName.SPINE_LOWER:\n      return BASE_BONE_DIMENSIONS.spineLower * factors.spine;\n    case BoneName.SPINE_MIDDLE:\n      return BASE_BONE_DIMENSIONS.spineMiddle * factors.spine;\n    case BoneName.SPINE_UPPER:\n      return BASE_BONE_DIMENSIONS.spineUpper * factors.spine;\n    case BoneName.PELVIS:\n      return BASE_BONE_DIMENSIONS.pelvis * factors.overall;\n\n    // Left arm\n    case BoneName.SHOULDER_L:\n    case BoneName.SHOULDER_R:\n      return BASE_BONE_DIMENSIONS.shoulder * factors.shoulder;\n    case BoneName.UPPER_ARM_L:\n    case BoneName.UPPER_ARM_R:\n      return BASE_BONE_DIMENSIONS.upperArm * factors.upperArm;\n    case BoneName.FOREARM_L:\n    case BoneName.FOREARM_R:\n      return BASE_BONE_DIMENSIONS.forearm * factors.forearm;\n    case BoneName.HAND_L:\n    case BoneName.HAND_R:\n      return BASE_BONE_DIMENSIONS.hand * factors.overall;\n\n    // Left leg\n    case BoneName.THIGH_L:\n    case BoneName.THIGH_R:\n      return BASE_BONE_DIMENSIONS.thigh * factors.thigh;\n    case BoneName.SHIN_L:\n    case BoneName.SHIN_R:\n      return BASE_BONE_DIMENSIONS.shin * factors.shin;\n    case BoneName.FOOT_L:\n    case BoneName.FOOT_R:\n      return BASE_BONE_DIMENSIONS.foot * factors.overall;\n\n    // Default: use overall scaling\n    default:\n      return 10 * factors.overall; // Default bone length\n  }\n}\n\n/**\n * Calculate scaled shoulder offset for skeleton positioning.\n *\n * **Korean**: 어깨 오프셋 계산 (Shoulder Offset Calculation)\n *\n * Determines the horizontal offset for shoulder bones based on\n * shoulder width. Used to position arms correctly on the skeleton.\n *\n * Applies amplification to shoulder width for more noticeable silhouette\n * differences between archetypes:\n * - Jojik (54cm): Offset = 31.05cm (54/2 * 1.15) - WIDE, imposing\n * - Hacker (43cm): Offset = 24.73cm (43/2 * 1.15) - NARROW, compact\n * - Difference: 26% wider shoulder span for visual distinction\n *\n * @param attributes - Player's physical attributes\n * @returns Shoulder offset in centimeters (half of total shoulder width, amplified)\n *\n * @example\n * ```typescript\n * const offset = calculateShoulderOffset(JOJIK_PHYSICAL);\n * // Jojik has wide shoulders: returns ~31cm (54cm width / 2 * 1.15)\n * // Left shoulder at -31cm, right shoulder at +31cm\n * ```\n *\n * @public\n * @korean 어깨오프셋계산\n */\nexport function calculateShoulderOffset(\n  attributes: PhysicalAttributes,\n): number {\n  // Shoulder width is the total span, so divide by 2 for offset from center\n  // Apply amplification factor for more visible width differences\n  const SHOULDER_AMPLIFICATION = 1.15;\n  return (attributes.shoulderWidth / 2) * SHOULDER_AMPLIFICATION;\n}\n\n/**\n * Calculate hitbox dimensions based on physical attributes.\n *\n * **Korean**: 히트박스 크기 계산 (Hitbox Dimension Calculation)\n *\n * Determines the bounding box dimensions for collision detection\n * and hit registration based on body proportions.\n *\n * @param attributes - Player's physical attributes\n * @returns Hitbox dimensions {width, height, depth} in centimeters\n *\n * @example\n * ```typescript\n * const hitbox = calculateHitboxDimensions(AMSALJA_PHYSICAL);\n * // Amsalja is tall and lean: {width: 40, height: 182, depth: 25}\n * ```\n *\n * @public\n * @korean 히트박스크기계산\n */\nexport function calculateHitboxDimensions(attributes: PhysicalAttributes): {\n  width: number;\n  height: number;\n  depth: number;\n} {\n  return {\n    width: attributes.shoulderWidth,\n    height: attributes.totalHeight,\n    depth: attributes.shoulderWidth * 0.5, // Approximate depth from shoulder width\n  };\n}\n\n/**\n * Calculate vital point offset adjustments based on body proportions.\n *\n * **Korean**: 급소 위치 조정 (Vital Point Position Adjustment)\n *\n * Adjusts vital point positions based on scaled skeleton dimensions.\n * Ensures vital points remain anatomically accurate for different\n * body types while maintaining Korean anatomy principles.\n *\n * @param vitalPointId - ID of the vital point to adjust\n * @param attributes - Player's physical attributes\n * @returns Position adjustment {x, y} offset in centimeters\n *\n * @example\n * ```typescript\n * const adjustment = calculateVitalPointAdjustment(\"head_temple\", MUSA_PHYSICAL);\n * // Returns offset based on head size and torso height\n * ```\n *\n * @public\n * @korean 급소위치조정\n */\nexport function calculateVitalPointAdjustment(\n  vitalPointId: string,\n  attributes: PhysicalAttributes,\n): { x: number; y: number } {\n  const factors = calculateBoneScalingFactors(attributes);\n\n  // Determine which body region this vital point belongs to\n  // Use exact prefix matching to avoid ambiguity\n  if (vitalPointId.startsWith(\"head_\")) {\n    // Head vital points scale with head size and torso height\n    return {\n      x: 0,\n      y: (factors.head - 1.0) * 20 + (factors.spine - 1.0) * 60,\n    };\n  } else if (vitalPointId.startsWith(\"neck_\")) {\n    // Neck vital points scale with neck length and torso height\n    return {\n      x: 0,\n      y: (factors.neck - 1.0) * 10 + (factors.spine - 1.0) * 60,\n    };\n  } else if (vitalPointId.startsWith(\"torso_\")) {\n    // Torso vital points scale with torso length\n    return {\n      x: 0,\n      y: (factors.spine - 1.0) * 30,\n    };\n  } else if (\n    vitalPointId.startsWith(\"shoulder_\") ||\n    vitalPointId.startsWith(\"arm_\")\n  ) {\n    // Arm vital points scale with arm length and shoulder width\n    return {\n      x: (factors.shoulder - 1.0) * 15,\n      y: (factors.upperArm - 1.0) * 12,\n    };\n  } else if (\n    vitalPointId.startsWith(\"leg_\") ||\n    vitalPointId.startsWith(\"knee_\")\n  ) {\n    // Leg vital points scale with leg length\n    return {\n      x: 0,\n      y: -(factors.thigh - 1.0) * 15,\n    };\n  }\n\n  // Default: no adjustment\n  return { x: 0, y: 0 };\n}\n\n/**\n * Calculate choke effectiveness modifier based on neck dimensions.\n *\n * **Korean**: 목 조르기 효과 계산 (Choke Effectiveness Calculation)\n *\n * Determines how effective chokes and strangles are based on neck\n * length and thickness. Longer, thinner necks are more vulnerable.\n *\n * @param attributes - Player's physical attributes\n * @returns Choke effectiveness multiplier (1.0 = baseline)\n *\n * @example\n * ```typescript\n * const chokeEffectiveness = calculateChokeEffectiveness(AMSALJA_PHYSICAL);\n * // Amsalja has longer neck: returns ~1.1 (10% more vulnerable)\n *\n * const jojikChoke = calculateChokeEffectiveness(JOJIK_PHYSICAL);\n * // Jojik has shorter, thicker neck: returns ~0.9 (10% more resistant)\n * ```\n *\n * @public\n * @korean 목조르기효과계산\n */\nexport function calculateChokeEffectiveness(\n  attributes: PhysicalAttributes,\n): number {\n  // Longer necks are more vulnerable to chokes\n  const lengthFactor = attributes.neckLength / REFERENCE_ATTRIBUTES.neckLength;\n\n  // Thicker necks (from muscle/weight) resist chokes better\n  const thicknessFactor = REFERENCE_ATTRIBUTES.weight / attributes.weight;\n\n  // Combine factors: longer neck + lighter weight = more vulnerable\n  return lengthFactor * thicknessFactor;\n}\n\n/**\n * Calculate head strike vulnerability based on head size.\n *\n * **Korean**: 머리 타격 취약성 계산 (Head Strike Vulnerability)\n *\n * Determines vulnerability to head strikes based on head size.\n * Larger heads have more mass and resistance, smaller heads are\n * more vulnerable to concussive force.\n *\n * @param attributes - Player's physical attributes\n * @returns Head strike vulnerability multiplier (1.0 = baseline)\n *\n * @example\n * ```typescript\n * const headVuln = calculateHeadStrikeVulnerability(JOJIK_PHYSICAL);\n * // Jojik has larger head: returns ~0.95 (5% more resistant)\n * ```\n *\n * @public\n * @korean 머리타격취약성계산\n */\nexport function calculateHeadStrikeVulnerability(\n  attributes: PhysicalAttributes,\n): number {\n  // Larger heads have more mass, providing some protection\n  const sizeFactor = REFERENCE_ATTRIBUTES.headSize / attributes.headSize;\n\n  // But larger heads are also bigger targets (handled by hitbox size)\n  // Here we only calculate the mass-based resistance\n  return sizeFactor;\n}\n\n/**\n * Calculate body radius for hit distance calculation.\n *\n * **Korean**: 몸체 반경 계산 (Body Radius Calculation)\n *\n * When calculating hit distance, we measure center-to-center, but attacks\n * land on the target's body surface. This function calculates the effective\n * \"depth\" of a fighter's body from their center point based on their\n * physical attributes.\n *\n * The calculation uses torso depth derived from shoulder width, as broader\n * fighters have proportionally deeper torsos. This is more anatomically\n * accurate than using a fixed constant.\n *\n * Formula: shoulderWidth * 0.5 (torso depth ratio) / 100 (cm to meters)\n *\n * Example body radii:\n * - Hacker (43cm shoulders): 0.215m depth → 0.215m radius\n * - Musa (46cm shoulders): 0.23m depth → 0.23m radius\n * - Jojik (54cm shoulders): 0.27m depth → 0.27m radius\n *\n * @param attributes - Player's physical attributes\n * @returns Body radius in meters (distance from center to body surface)\n *\n * @example\n * ```typescript\n * const radius = calculateBodyRadius(JOJIK_PHYSICAL);\n * // Jojik has wide shoulders (54cm): returns 0.27m\n *\n * const hackerRadius = calculateBodyRadius(HACKER_PHYSICAL);\n * // Hacker is lean (43cm shoulders): returns 0.215m\n * ```\n *\n * @public\n * @korean 몸체반경계산\n */\nexport function calculateBodyRadius(attributes: PhysicalAttributes): number {\n  // Body depth is approximately half of shoulder width (anatomical ratio)\n  // This matches calculateHitboxDimensions which uses shoulderWidth * 0.5\n  const bodyDepthCm = attributes.shoulderWidth * 0.5;\n\n  // Convert from centimeters to meters\n  // The radius is the distance from center to body surface (half of total depth)\n  // Since bodyDepthCm represents front-to-back depth, we use it directly as\n  // the distance from center to front surface\n  return bodyDepthCm / 100;\n}\n"],"mappings":";CAiJiD,EAC/C,GAAG,wBACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuYD,SAAgB,oBAAoB,YAAwC;CAS1E,OANoB,WAAW,gBAAgB,KAM1B"}
+{"version":3,"file":"skeletonScaling.js","names":[],"sources":["../../src/utils/skeletonScaling.ts"],"sourcesContent":["/**\n * Skeleton rig scaling based on physical attributes.\n *\n * **Korean**: 골격 크기 조정 (Skeleton Scaling)\n *\n * This module provides functions to scale the skeleton rig based on player\n * physical attributes, allowing each archetype to have anatomically accurate\n * body proportions that affect combat hitboxes, vital point positioning, and\n * visual representation.\n *\n * ## Visual Amplification System\n *\n * Raw physical attribute differences between archetypes are subtle (2-12%).\n * To create recognizable visual silhouettes in 3D, this system applies\n * amplification factors that enhance differences while maintaining realistic\n * proportions:\n *\n * - **Limb Scaling**: 2.5x amplification (subtle 5% difference → 12.5% visual)\n * - **Shoulder Width**: 1.15x additional amplification for silhouette distinction\n * - **Overall Height**: 1.5x amplification (kept subtle for realism)\n *\n * ### Expected Visual Silhouettes\n *\n * Each archetype has a distinct, recognizable body shape:\n *\n * - **해커 (Hacker)**: Compact, narrow shoulders (43cm), shortest limbs - SMALLEST\n * - **암살자 (Amsalja)**: Tall (186cm), lean, long limbs (102cm legs) - TALLEST\n * - **정보요원 (Jeongbo)**: Balanced, average proportions - BASELINE\n * - **무사 (Musa)**: Athletic military build (46cm shoulders) - TRADITIONAL\n * - **조직폭력배 (Jojik)**: Massive, widest shoulders (54cm), imposing - LARGEST\n *\n * ## Integration with Korean Anatomy\n *\n * The scaling system respects Korean martial arts anatomy principles:\n * - **Head vital points** (두부 급소) scale with head size\n * - **Neck vulnerability** (경부 취약성) affected by neck length\n * - **Torso vital points** (몸통 급소) distributed across torso length\n * - **Limb reach** (팔다리 거리) determined by arm/leg length\n * - **Shoulder defense** (어깨 방어) coverage from shoulder width\n *\n * @module utils/skeletonScaling\n * @category Combat System\n * @korean 골격조정\n */\n\nimport { PhysicalAttributes } from \"@/types\";\nimport { BoneName } from \"@/types/skeletal\";\nimport {\n  amplifyScaling,\n  REFERENCE_ATTRIBUTES as BODY_REFERENCE_ATTRIBUTES,\n} from \"../constants/bodyRenderingConstants\";\n\n/**\n * Bone scaling factors for each body region.\n *\n * **Korean**: 뼈 크기 비율 (Bone Scaling Factors)\n *\n * Defines how physical attributes map to skeleton bone scaling.\n * Each factor is a multiplier applied to the base bone length.\n *\n * @korean 뼈크기비율\n */\nexport interface BoneScalingFactors {\n  /** Head bone scaling (based on headSize) */\n  readonly head: number;\n  /** Neck bone scaling (based on neckLength) */\n  readonly neck: number;\n  /** Spine bones scaling (based on torsoLength) */\n  readonly spine: number;\n  /** Upper arm bones scaling (based on armLength) */\n  readonly upperArm: number;\n  /** Forearm bones scaling (based on armLength) */\n  readonly forearm: number;\n  /** Thigh bones scaling (based on legLength) */\n  readonly thigh: number;\n  /** Shin bones scaling (based on legLength) */\n  readonly shin: number;\n  /** Shoulder bones scaling (based on shoulderWidth) */\n  readonly shoulder: number;\n  /** Overall skeleton scaling (based on totalHeight) */\n  readonly overall: number;\n}\n\n/**\n * Anatomically correct bone dimensions in centimeters.\n *\n * **Korean**: 해부학적 뼈 치수 (Anatomical Bone Dimensions)\n *\n * These are anatomically accurate bone lengths based on human proportions.\n * For a 178cm reference height, these values create a realistic skeleton.\n *\n * Reference: Human body proportions (8-head canon)\n * - Head: ~12.5% of height (22cm)\n * - Neck: ~5.5% of height (10cm)\n * - Torso: ~33% of height (59cm / 3 segments = 20cm each)\n * - Legs: ~48% of height (85cm total)\n * - Thigh: ~55% of leg length (47cm)\n * - Shin: ~45% of leg length (38cm)\n *\n * @internal\n * @korean 기본뼈치수\n */\nconst BASE_BONE_DIMENSIONS = {\n  // Head region\n  head: 22, // Head bone length in cm (12.5% of 178cm)\n  neck: 10, // Neck bone length in cm (5.5% of 178cm)\n\n  // Torso region - Total torso ~59cm for 178cm person (33%)\n  spineLower: 20, // Lower spine segment (lumbar)\n  spineMiddle: 20, // Middle spine segment (thoracic)\n  spineUpper: 19, // Upper spine segment (upper thoracic)\n  pelvis: 8, // Pelvis/root bone height (~4.5% of height)\n\n  // Arm region (one side) - Total arm ~75cm for 178cm (42% of height)\n  shoulder: 12, // Shoulder/clavicle bone (~6.5% of height)\n  upperArm: 32, // Upper arm (shoulder to elbow) - ~55% of arm\n  forearm: 27, // Forearm (elbow to wrist) - ~45% of arm (including wrist)\n  hand: 19, // Hand length (~10.5% of height)\n\n  // Leg region (one side) - Total leg ~95cm for 178cm (53% of height)\n  hip: 10, // Hip joint height\n  thigh: 48, // Thigh (hip to knee) - ~55% of leg length\n  shin: 40, // Shin (knee to ankle) - ~45% of leg length\n  foot: 5, // Foot/ankle height (ground to ankle)\n\n  // Width measurements\n  shoulderWidth: 43, // Total shoulder width (half = 21.5cm offset)\n  hipWidth: 30, // Total hip width (half = 15cm offset)\n} as const;\n\n/**\n * Reference physical attributes for baseline scaling.\n *\n * **Korean**: 기준 신체 속성 (Reference Physical Attributes)\n *\n * These represent the \"average\" Korean male fighter that the base\n * skeleton rig is designed for. Scaling is calculated relative to\n * these reference values.\n *\n * Uses centralized REFERENCE_ATTRIBUTES from bodyRenderingConstants.\n *\n * @internal\n * @korean 기준신체속성\n */\nconst REFERENCE_ATTRIBUTES: PhysicalAttributes = {\n  ...BODY_REFERENCE_ATTRIBUTES,\n};\n\n// VISUAL_AMPLIFICATION_FACTOR and amplifyScaling imported from bodyRenderingConstants\n\n/**\n * Calculate bone scaling factors from physical attributes.\n *\n * **Korean**: 뼈 크기 비율 계산 (Calculate Bone Scaling Factors)\n *\n * Computes scaling multipliers for each bone region based on the\n * player's physical attributes compared to reference values.\n * Differences are amplified for more noticeable visual distinction\n * between archetypes.\n *\n * @param attributes - Player's physical attributes\n * @returns Bone scaling factors for skeleton rig\n *\n * @example\n * ```typescript\n * const factors = calculateBoneScalingFactors(AMSALJA_PHYSICAL);\n * // Amsalja has longer legs: factors.thigh ~= 1.06 (amplified from ~1.03)\n * // Amsalja has smaller head: factors.head ~= 0.90 (amplified from ~0.95)\n * ```\n *\n * @korean 뼈크기비율계산\n */\nexport function calculateBoneScalingFactors(\n  attributes: PhysicalAttributes,\n): BoneScalingFactors {\n  // Calculate raw scaling ratios from physical attributes\n  const rawOverall = attributes.totalHeight / REFERENCE_ATTRIBUTES.totalHeight;\n  const rawHead = attributes.headSize / REFERENCE_ATTRIBUTES.headSize;\n  const rawNeck = attributes.neckLength / REFERENCE_ATTRIBUTES.neckLength;\n  const rawSpine = attributes.torsoLength / REFERENCE_ATTRIBUTES.torsoLength;\n  const rawArm = attributes.armLength / REFERENCE_ATTRIBUTES.armLength;\n  const rawLeg = attributes.legLength / REFERENCE_ATTRIBUTES.legLength;\n  const rawShoulder =\n    attributes.shoulderWidth / REFERENCE_ATTRIBUTES.shoulderWidth;\n\n  // Apply visual amplification for more noticeable archetype differences\n  // Overall height scaling is kept subtle (1.5x) for realism\n  const overall = 1.0 + (rawOverall - 1.0) * 1.5;\n\n  // Head, neck, and body proportions are amplified for visual distinction\n  const head = amplifyScaling(rawHead);\n  const neck = amplifyScaling(rawNeck);\n  const spine = amplifyScaling(rawSpine);\n\n  // Limb proportions amplified for noticeable reach differences\n  const upperArm = amplifyScaling(rawArm);\n  const forearm = amplifyScaling(rawArm);\n  const thigh = amplifyScaling(rawLeg);\n  const shin = amplifyScaling(rawLeg);\n\n  // Shoulder width amplified for body silhouette distinction\n  const shoulder = amplifyScaling(rawShoulder);\n\n  return {\n    head,\n    neck,\n    spine,\n    upperArm,\n    forearm,\n    thigh,\n    shin,\n    shoulder,\n    overall,\n  };\n}\n\n/**\n * Get scaled bone length for a specific bone.\n *\n * **Korean**: 크기 조정된 뼈 길이 (Scaled Bone Length)\n *\n * Returns the scaled length for a specific bone based on the player's\n * physical attributes. Used when creating or updating skeleton rigs.\n *\n * @param boneName - Name of the bone to scale\n * @param attributes - Player's physical attributes\n * @returns Scaled bone length in centimeters\n *\n * @example\n * ```typescript\n * const headLength = getScaledBoneLength(BoneName.HEAD, JOJIK_PHYSICAL);\n * // Jojik has larger head: returns ~23cm (base 20cm * 1.15)\n * ```\n *\n * @korean 크기조정된뼈길이\n */\nexport function getScaledBoneLength(\n  boneName: string,\n  attributes: PhysicalAttributes,\n): number {\n  const factors = calculateBoneScalingFactors(attributes);\n\n  // Map bone names to their base dimensions and scaling factors\n  switch (boneName) {\n    // Head region\n    case BoneName.HEAD:\n      return BASE_BONE_DIMENSIONS.head * factors.head;\n    case BoneName.NECK:\n      return BASE_BONE_DIMENSIONS.neck * factors.neck;\n\n    // Spine region\n    case BoneName.SPINE_LOWER:\n      return BASE_BONE_DIMENSIONS.spineLower * factors.spine;\n    case BoneName.SPINE_MIDDLE:\n      return BASE_BONE_DIMENSIONS.spineMiddle * factors.spine;\n    case BoneName.SPINE_UPPER:\n      return BASE_BONE_DIMENSIONS.spineUpper * factors.spine;\n    case BoneName.PELVIS:\n      return BASE_BONE_DIMENSIONS.pelvis * factors.overall;\n\n    // Left arm\n    case BoneName.SHOULDER_L:\n    case BoneName.SHOULDER_R:\n      return BASE_BONE_DIMENSIONS.shoulder * factors.shoulder;\n    case BoneName.UPPER_ARM_L:\n    case BoneName.UPPER_ARM_R:\n      return BASE_BONE_DIMENSIONS.upperArm * factors.upperArm;\n    case BoneName.FOREARM_L:\n    case BoneName.FOREARM_R:\n      return BASE_BONE_DIMENSIONS.forearm * factors.forearm;\n    case BoneName.HAND_L:\n    case BoneName.HAND_R:\n      return BASE_BONE_DIMENSIONS.hand * factors.overall;\n\n    // Left leg\n    case BoneName.THIGH_L:\n    case BoneName.THIGH_R:\n      return BASE_BONE_DIMENSIONS.thigh * factors.thigh;\n    case BoneName.SHIN_L:\n    case BoneName.SHIN_R:\n      return BASE_BONE_DIMENSIONS.shin * factors.shin;\n    case BoneName.FOOT_L:\n    case BoneName.FOOT_R:\n      return BASE_BONE_DIMENSIONS.foot * factors.overall;\n\n    // Default: use overall scaling\n    default:\n      return 10 * factors.overall; // Default bone length\n  }\n}\n\n/**\n * Calculate scaled shoulder offset for skeleton positioning.\n *\n * **Korean**: 어깨 오프셋 계산 (Shoulder Offset Calculation)\n *\n * Determines the horizontal offset for shoulder bones based on\n * shoulder width. Used to position arms correctly on the skeleton.\n *\n * Applies amplification to shoulder width for more noticeable silhouette\n * differences between archetypes:\n * - Jojik (54cm): Offset = 31.05cm (54/2 * 1.15) - WIDE, imposing\n * - Hacker (43cm): Offset = 24.73cm (43/2 * 1.15) - NARROW, compact\n * - Difference: 26% wider shoulder span for visual distinction\n *\n * @param attributes - Player's physical attributes\n * @returns Shoulder offset in centimeters (half of total shoulder width, amplified)\n *\n * @example\n * ```typescript\n * const offset = calculateShoulderOffset(JOJIK_PHYSICAL);\n * // Jojik has wide shoulders: returns ~31cm (54cm width / 2 * 1.15)\n * // Left shoulder at -31cm, right shoulder at +31cm\n * ```\n *\n * @korean 어깨오프셋계산\n */\nexport function calculateShoulderOffset(\n  attributes: PhysicalAttributes,\n): number {\n  // Shoulder width is the total span, so divide by 2 for offset from center\n  // Apply amplification factor for more visible width differences\n  const SHOULDER_AMPLIFICATION = 1.15;\n  return (attributes.shoulderWidth / 2) * SHOULDER_AMPLIFICATION;\n}\n\n/**\n * Calculate hitbox dimensions based on physical attributes.\n *\n * **Korean**: 히트박스 크기 계산 (Hitbox Dimension Calculation)\n *\n * Determines the bounding box dimensions for collision detection\n * and hit registration based on body proportions.\n *\n * @param attributes - Player's physical attributes\n * @returns Hitbox dimensions {width, height, depth} in centimeters\n *\n * @example\n * ```typescript\n * const hitbox = calculateHitboxDimensions(AMSALJA_PHYSICAL);\n * // Amsalja is tall and lean: {width: 40, height: 182, depth: 25}\n * ```\n *\n * @korean 히트박스크기계산\n */\nexport function calculateHitboxDimensions(attributes: PhysicalAttributes): {\n  width: number;\n  height: number;\n  depth: number;\n} {\n  return {\n    width: attributes.shoulderWidth,\n    height: attributes.totalHeight,\n    depth: attributes.shoulderWidth * 0.5, // Approximate depth from shoulder width\n  };\n}\n\n/**\n * Calculate vital point offset adjustments based on body proportions.\n *\n * **Korean**: 급소 위치 조정 (Vital Point Position Adjustment)\n *\n * Adjusts vital point positions based on scaled skeleton dimensions.\n * Ensures vital points remain anatomically accurate for different\n * body types while maintaining Korean anatomy principles.\n *\n * @param vitalPointId - ID of the vital point to adjust\n * @param attributes - Player's physical attributes\n * @returns Position adjustment {x, y} offset in centimeters\n *\n * @example\n * ```typescript\n * const adjustment = calculateVitalPointAdjustment(\"head_temple\", MUSA_PHYSICAL);\n * // Returns offset based on head size and torso height\n * ```\n *\n * @korean 급소위치조정\n */\nexport function calculateVitalPointAdjustment(\n  vitalPointId: string,\n  attributes: PhysicalAttributes,\n): { x: number; y: number } {\n  const factors = calculateBoneScalingFactors(attributes);\n\n  // Determine which body region this vital point belongs to\n  // Use exact prefix matching to avoid ambiguity\n  if (vitalPointId.startsWith(\"head_\")) {\n    // Head vital points scale with head size and torso height\n    return {\n      x: 0,\n      y: (factors.head - 1.0) * 20 + (factors.spine - 1.0) * 60,\n    };\n  } else if (vitalPointId.startsWith(\"neck_\")) {\n    // Neck vital points scale with neck length and torso height\n    return {\n      x: 0,\n      y: (factors.neck - 1.0) * 10 + (factors.spine - 1.0) * 60,\n    };\n  } else if (vitalPointId.startsWith(\"torso_\")) {\n    // Torso vital points scale with torso length\n    return {\n      x: 0,\n      y: (factors.spine - 1.0) * 30,\n    };\n  } else if (\n    vitalPointId.startsWith(\"shoulder_\") ||\n    vitalPointId.startsWith(\"arm_\")\n  ) {\n    // Arm vital points scale with arm length and shoulder width\n    return {\n      x: (factors.shoulder - 1.0) * 15,\n      y: (factors.upperArm - 1.0) * 12,\n    };\n  } else if (\n    vitalPointId.startsWith(\"leg_\") ||\n    vitalPointId.startsWith(\"knee_\")\n  ) {\n    // Leg vital points scale with leg length\n    return {\n      x: 0,\n      y: -(factors.thigh - 1.0) * 15,\n    };\n  }\n\n  // Default: no adjustment\n  return { x: 0, y: 0 };\n}\n\n/**\n * Calculate choke effectiveness modifier based on neck dimensions.\n *\n * **Korean**: 목 조르기 효과 계산 (Choke Effectiveness Calculation)\n *\n * Determines how effective chokes and strangles are based on neck\n * length and thickness. Longer, thinner necks are more vulnerable.\n *\n * @param attributes - Player's physical attributes\n * @returns Choke effectiveness multiplier (1.0 = baseline)\n *\n * @example\n * ```typescript\n * const chokeEffectiveness = calculateChokeEffectiveness(AMSALJA_PHYSICAL);\n * // Amsalja has longer neck: returns ~1.1 (10% more vulnerable)\n *\n * const jojikChoke = calculateChokeEffectiveness(JOJIK_PHYSICAL);\n * // Jojik has shorter, thicker neck: returns ~0.9 (10% more resistant)\n * ```\n *\n * @korean 목조르기효과계산\n */\nexport function calculateChokeEffectiveness(\n  attributes: PhysicalAttributes,\n): number {\n  // Longer necks are more vulnerable to chokes\n  const lengthFactor = attributes.neckLength / REFERENCE_ATTRIBUTES.neckLength;\n\n  // Thicker necks (from muscle/weight) resist chokes better\n  const thicknessFactor = REFERENCE_ATTRIBUTES.weight / attributes.weight;\n\n  // Combine factors: longer neck + lighter weight = more vulnerable\n  return lengthFactor * thicknessFactor;\n}\n\n/**\n * Calculate head strike vulnerability based on head size.\n *\n * **Korean**: 머리 타격 취약성 계산 (Head Strike Vulnerability)\n *\n * Determines vulnerability to head strikes based on head size.\n * Larger heads have more mass and resistance, smaller heads are\n * more vulnerable to concussive force.\n *\n * @param attributes - Player's physical attributes\n * @returns Head strike vulnerability multiplier (1.0 = baseline)\n *\n * @example\n * ```typescript\n * const headVuln = calculateHeadStrikeVulnerability(JOJIK_PHYSICAL);\n * // Jojik has larger head: returns ~0.95 (5% more resistant)\n * ```\n *\n * @korean 머리타격취약성계산\n */\nexport function calculateHeadStrikeVulnerability(\n  attributes: PhysicalAttributes,\n): number {\n  // Larger heads have more mass, providing some protection\n  const sizeFactor = REFERENCE_ATTRIBUTES.headSize / attributes.headSize;\n\n  // But larger heads are also bigger targets (handled by hitbox size)\n  // Here we only calculate the mass-based resistance\n  return sizeFactor;\n}\n\n/**\n * Calculate body radius for hit distance calculation.\n *\n * **Korean**: 몸체 반경 계산 (Body Radius Calculation)\n *\n * When calculating hit distance, we measure center-to-center, but attacks\n * land on the target's body surface. This function calculates the effective\n * \"depth\" of a fighter's body from their center point based on their\n * physical attributes.\n *\n * The calculation uses torso depth derived from shoulder width, as broader\n * fighters have proportionally deeper torsos. This is more anatomically\n * accurate than using a fixed constant.\n *\n * Formula: shoulderWidth * 0.5 (torso depth ratio) / 100 (cm to meters)\n *\n * Example body radii:\n * - Hacker (43cm shoulders): 0.215m depth → 0.215m radius\n * - Musa (46cm shoulders): 0.23m depth → 0.23m radius\n * - Jojik (54cm shoulders): 0.27m depth → 0.27m radius\n *\n * @param attributes - Player's physical attributes\n * @returns Body radius in meters (distance from center to body surface)\n *\n * @example\n * ```typescript\n * const radius = calculateBodyRadius(JOJIK_PHYSICAL);\n * // Jojik has wide shoulders (54cm): returns 0.27m\n *\n * const hackerRadius = calculateBodyRadius(HACKER_PHYSICAL);\n * // Hacker is lean (43cm shoulders): returns 0.215m\n * ```\n *\n * @korean 몸체반경계산\n */\nexport function calculateBodyRadius(attributes: PhysicalAttributes): number {\n  // Body depth is approximately half of shoulder width (anatomical ratio)\n  // This matches calculateHitboxDimensions which uses shoulderWidth * 0.5\n  const bodyDepthCm = attributes.shoulderWidth * 0.5;\n\n  // Convert from centimeters to meters\n  // The radius is the distance from center to body surface (half of total depth)\n  // Since bodyDepthCm represents front-to-back depth, we use it directly as\n  // the distance from center to front surface\n  return bodyDepthCm / 100;\n}\n"],"mappings":";CAgJiD,EAC/C,GAAG,wBACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+XD,SAAgB,oBAAoB,YAAwC;CAS1E,OANoB,WAAW,gBAAgB,KAM1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blacktrigram",
-  "version": "0.7.44",
+  "version": "0.7.45",
   "description": "Black Trigram (흑괘) - Korean Martial Arts Combat Simulator. Reusable game systems, combat mechanics, animation framework, and Korean martial arts data built with React, Three.js, and TypeScript.",
   "type": "module",
   "main": "./lib/index.js",
@@ -196,14 +196,14 @@
     "@testing-library/jest-dom": "6.9.1",
     "@testing-library/react": "16.3.2",
     "@testing-library/user-event": "14.6.1",
-    "@types/node": "25.6.2",
+    "@types/node": "25.7.0",
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "@types/three": "0.184.1",
     "@vitejs/plugin-react": "6.0.1",
     "@vitest/coverage-v8": "4.1.6",
     "@vitest/ui": "4.1.6",
-    "cypress": "15.14.2",
+    "cypress": "15.15.0",
     "cypress-junit-reporter": "1.3.1",
     "cypress-multi-reporters": "2.0.5",
     "cypress-wait-until": "3.0.2",
@@ -215,18 +215,18 @@
     "globals": "17.6.0",
     "jest-axe": "10.0.0",
     "jsdom": "29.1.1",
-    "knip": "6.12.2",
+    "knip": "6.13.1",
     "license-compliance": "3.0.1",
     "mocha-junit-reporter": "2.2.1",
     "mochawesome": "7.1.4",
     "mochawesome-merge": "5.1.1",
     "mochawesome-report-generator": "6.3.2",
     "openai": "6.37.0",
-    "playwright": "1.59.1",
+    "playwright": "1.60.0",
     "postprocessing": "6.39.1",
     "react": "19.2.6",
     "react-dom": "19.2.6",
-    "start-server-and-test": "3.0.4",
+    "start-server-and-test": "3.0.5",
     "three": "0.184.0",
     "ts-morph": "28.0.0",
     "ts-node": "10.9.2",
@@ -237,7 +237,7 @@
     "typedoc-plugin-mermaid": "1.12.0",
     "typedoc-plugin-missing-exports": "4.1.3",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.59.2",
+    "typescript-eslint": "8.59.3",
     "vite": "8.0.12",
     "vite-bundle-analyzer": "1.3.8",
     "vite-tsconfig-paths": "6.1.1",