blacktrigram 0.7.2

package/lib/utils/characterScaling.d.ts

@@ -0,0 +1,305 @@
+/**
+ * Unified character scaling system for Black Trigram.
+ *
+ * **Korean**: 통합 캐릭터 스케일링 시스템
+ *
+ * This module provides a physics-first approach to character scaling where:
+ * - All measurements are in METERS for consistency with arena and physics
+ * - Physical attributes (in cm) are converted to meters
+ * - All body part dimensions derive from physical attributes
+ * - Scale factors are based on anatomical proportions
+ *
+ * ## Design Philosophy
+ *
+ * The scaling system ensures that:
+ * 1. Characters appear correctly sized in arenas (6-14 meters wide)
+ * 2. Reach calculations (arm/leg length) match visual representation
+ * 3. Muscle and clothing scale proportionally with body dimensions
+ * 4. Combat animations use realistic distances
+ *
+ * ## Unit Conventions
+ * - Physical attributes: centimeters (totalHeight: 180 = 180cm)
+ * - World space: meters (arena width: 10 = 10m)
+ * - Character model: meters (height: 1.80 = 1.80m)
+ *
+ * @module utils/characterScaling
+ * @category Character Rendering
+ * @korean 캐릭터스케일링
+ */
+import type { PhysicalAttributes } from "../types";
+/**
+ * Reference body proportions as fractions of total height.
+ * Based on canonical human anatomy (8-head proportion system).
+ *
+ * @korean 기준신체비율
+ */
+export declare const BODY_PROPORTIONS: {
+    /** Head is ~1/8 of total height */
+    readonly HEAD_HEIGHT_RATIO: 0.125;
+    /** Neck is ~0.055 of total height */
+    readonly NECK_HEIGHT_RATIO: 0.055;
+    /** Torso (spine) is ~0.33 of total height */
+    readonly TORSO_HEIGHT_RATIO: 0.33;
+    /** Leg (hip to floor) is ~0.48 of total height */
+    readonly LEG_HEIGHT_RATIO: 0.48;
+    /** Upper leg (thigh) is ~55% of total leg length */
+    readonly THIGH_LEG_RATIO: 0.55;
+    /** Lower leg (shin) is ~45% of total leg length */
+    readonly SHIN_LEG_RATIO: 0.45;
+    /** Upper arm is ~55% of total arm length */
+    readonly UPPER_ARM_RATIO: 0.55;
+    /** Forearm is ~45% of total arm length */
+    readonly FOREARM_RATIO: 0.45;
+    /** Hand is ~0.11 of total height (or ~10.5% of total height) */
+    readonly HAND_HEIGHT_RATIO: 0.105;
+    /** Foot length is ~15% of total height */
+    readonly FOOT_LENGTH_RATIO: 0.15;
+    /** Shoulder width is typically 23-25% of height for males */
+    readonly SHOULDER_WIDTH_RATIO: 0.255;
+    /** Hip width is typically 16-18% of height */
+    readonly HIP_WIDTH_RATIO: 0.17;
+    /** Torso depth is typically 10-12% of height */
+    readonly TORSO_DEPTH_RATIO: 0.11;
+};
+/**
+ * Bone length as fraction of total height.
+ * These are anatomically accurate proportions for skeletal rig creation.
+ *
+ * @korean 뼈길이비율
+ */
+export declare const BONE_HEIGHT_RATIOS: {
+    readonly head: 0.125;
+    readonly neck: 0.055;
+    readonly spineUpper: 0.11;
+    readonly spineMiddle: 0.11;
+    readonly spineLower: 0.11;
+    readonly shoulder: 0.055;
+    readonly upperArm: 0.21;
+    readonly elbow: 0.025;
+    readonly forearm: 0.17;
+    readonly wrist: 0.025;
+    readonly hand: 0.105;
+    readonly pelvis: 0.08;
+    readonly hip: 0.05;
+    readonly thigh: 0.265;
+    readonly knee: 0.025;
+    readonly shin: 0.22;
+    readonly foot: 0.05;
+};
+/**
+ * Convert centimeters to meters.
+ *
+ * @param cm - Value in centimeters
+ * @returns Value in meters
+ * @korean cm를미터로
+ */
+export declare function cmToMeters(cm: number): number;
+/**
+ * Convert physical attributes from centimeters to meters.
+ *
+ * @param attrs - Physical attributes in centimeters
+ * @returns Object with key measurements in meters
+ * @korean 신체속성미터변환
+ */
+export declare function getPhysicalMeters(attrs: PhysicalAttributes): {
+    readonly totalHeight: number;
+    readonly armLength: number;
+    readonly legLength: number;
+    readonly shoulderWidth: number;
+    readonly torsoLength: number;
+    readonly headSize: number;
+    readonly neckLength: number;
+};
+/**
+ * Calculate skeleton bone dimensions in meters based on physical attributes.
+ *
+ * Returns actual bone lengths that should be used in SkeletonRig creation.
+ * All values are in meters and anatomically proportioned.
+ *
+ * @param attrs - Physical attributes (in centimeters)
+ * @returns Bone dimensions in meters
+ * @korean 골격치수계산
+ */
+export declare function calculateSkeletonDimensions(attrs: PhysicalAttributes): {
+    readonly pelvisHeight: number;
+    readonly spineLower: number;
+    readonly spineMiddle: number;
+    readonly spineUpper: number;
+    readonly neck: number;
+    readonly head: number;
+    readonly shoulder: number;
+    readonly upperArm: number;
+    readonly elbow: number;
+    readonly forearm: number;
+    readonly wrist: number;
+    readonly hand: number;
+    readonly hip: number;
+    readonly thigh: number;
+    readonly knee: number;
+    readonly shin: number;
+    readonly foot: number;
+    readonly totalHeight: number;
+};
+/**
+ * Base muscle dimensions as fractions of associated bone length.
+ * These are proportional values that scale with bone size.
+ *
+ * @korean 근육비율
+ */
+export declare const MUSCLE_BONE_RATIOS: {
+    readonly shoulder: {
+        readonly radiusFactor: 0.4;
+        readonly lengthFactor: 0.8;
+    };
+    readonly bicep: {
+        readonly radiusFactor: 0.35;
+        readonly lengthFactor: 0.7;
+    };
+    readonly tricep: {
+        readonly radiusFactor: 0.3;
+        readonly lengthFactor: 0.65;
+    };
+    readonly forearm: {
+        readonly radiusFactor: 0.3;
+        readonly lengthFactor: 0.8;
+    };
+    readonly pectorals: {
+        readonly radiusFactor: 0.5;
+        readonly lengthFactor: 0.7;
+    };
+    readonly core: {
+        readonly radiusFactor: 0.45;
+        readonly lengthFactor: 0.9;
+    };
+    readonly abs: {
+        readonly radiusFactor: 0.4;
+        readonly lengthFactor: 0.8;
+    };
+    readonly obliques: {
+        readonly radiusFactor: 0.35;
+        readonly lengthFactor: 0.75;
+    };
+    readonly glute: {
+        readonly radiusFactor: 0.5;
+        readonly lengthFactor: 0.6;
+    };
+    readonly quad: {
+        readonly radiusFactor: 0.35;
+        readonly lengthFactor: 0.8;
+    };
+    readonly hamstring: {
+        readonly radiusFactor: 0.3;
+        readonly lengthFactor: 0.75;
+    };
+    readonly calf: {
+        readonly radiusFactor: 0.28;
+        readonly lengthFactor: 0.6;
+    };
+};
+/**
+ * Calculate muscle dimensions in meters based on skeleton dimensions.
+ *
+ * @param skeletonDims - Skeleton dimensions from calculateSkeletonDimensions
+ * @param muscleMass - Muscle mass in kg for scaling
+ * @param referenceMass - Reference muscle mass (default 35kg)
+ * @returns Muscle dimensions in meters
+ * @korean 근육치수계산
+ */
+export declare function calculateMuscleDimensions(skeletonDims: ReturnType<typeof calculateSkeletonDimensions>, muscleMass: number, referenceMass?: number): Record<string, {
+    readonly radius: number;
+    readonly length: number;
+    readonly scaleFactor: number;
+}>;
+/**
+ * Calculate hand dimensions in meters based on physical attributes.
+ *
+ * @param attrs - Physical attributes
+ * @returns Hand dimensions in meters
+ * @korean 손치수계산
+ */
+export declare function calculateHandDimensions(attrs: PhysicalAttributes): {
+    readonly palmLength: number;
+    readonly palmWidth: number;
+    readonly palmDepth: number;
+    readonly fingerLengths: {
+        readonly thumb: number;
+        readonly index: number;
+        readonly middle: number;
+        readonly ring: number;
+        readonly pinky: number;
+    };
+    readonly fingerWidths: {
+        readonly thumb: number;
+        readonly index: number;
+        readonly middle: number;
+        readonly ring: number;
+        readonly pinky: number;
+    };
+};
+/**
+ * Calculate foot dimensions in meters based on physical attributes.
+ *
+ * @param attrs - Physical attributes
+ * @returns Foot dimensions in meters
+ * @korean 발치수계산
+ */
+export declare function calculateFootDimensions(attrs: PhysicalAttributes): {
+    readonly footLength: number;
+    readonly footWidth: number;
+    readonly footHeight: number;
+    readonly toeLength: number;
+    readonly heelLength: number;
+    readonly ankleRadius: number;
+};
+/**
+ * Clothing fit scale multipliers.
+ * Applied on top of body dimensions.
+ *
+ * @korean 의류핏배율
+ */
+export declare const CLOTHING_FIT_SCALES: {
+    readonly tight: 1.02;
+    readonly fitted: 1.06;
+    readonly regular: 1.1;
+    readonly loose: 1.18;
+    readonly oversized: 1.3;
+};
+export type ClothingFit = keyof typeof CLOTHING_FIT_SCALES;
+/**
+ * Calculate clothing dimensions in meters based on physical attributes.
+ *
+ * @param attrs - Physical attributes
+ * @param fit - Clothing fit type
+ * @returns Clothing dimensions in meters
+ * @korean 의류치수계산
+ */
+export declare function calculateClothingDimensions(attrs: PhysicalAttributes, fit?: ClothingFit): {
+    readonly torsoWidth: number;
+    readonly torsoDepth: number;
+    readonly torsoLength: number;
+    readonly armThickness: number;
+    readonly legThickness: number;
+    readonly fitScale: number;
+};
+/**
+ * Visual amplification factor for better screen readability.
+ * This is applied uniformly to make characters more visible in the arena.
+ * Does NOT affect physics or reach calculations.
+ *
+ * Value of 1.0 = realistic scale (1.8m character in 10m arena)
+ * Value of 1.15 = 15% larger for better visibility
+ *
+ * @korean 시각적증폭계수
+ */
+export declare const VISUAL_SCALE_FACTOR = 1;
+/**
+ * Calculate the uniform scale factor to apply to a character group.
+ * This ensures the character's total height matches their physical height.
+ *
+ * @param attrs - Physical attributes
+ * @param baseSkeletonHeight - Height of the base skeleton rig (before scaling)
+ * @returns Scale factor to apply to character group
+ * @korean 캐릭터스케일계산
+ */
+export declare function calculateCharacterScale(attrs: PhysicalAttributes, baseSkeletonHeight?: number): number;
+//# sourceMappingURL=characterScaling.d.ts.map

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

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

package/lib/utils/characterScaling.js

@@ -0,0 +1,105 @@
+//#region src/utils/characterScaling.ts
+/**
+* Reference body proportions as fractions of total height.
+* Based on canonical human anatomy (8-head proportion system).
+*
+* @korean 기준신체비율
+*/
+var BODY_PROPORTIONS = {
+	HEAD_HEIGHT_RATIO: .125,
+	NECK_HEIGHT_RATIO: .055,
+	TORSO_HEIGHT_RATIO: .33,
+	LEG_HEIGHT_RATIO: .48,
+	THIGH_LEG_RATIO: .55,
+	SHIN_LEG_RATIO: .45,
+	UPPER_ARM_RATIO: .55,
+	FOREARM_RATIO: .45,
+	HAND_HEIGHT_RATIO: .105,
+	FOOT_LENGTH_RATIO: .15,
+	SHOULDER_WIDTH_RATIO: .255,
+	HIP_WIDTH_RATIO: .17,
+	TORSO_DEPTH_RATIO: .11
+};
+/**
+* Bone length as fraction of total height.
+* These are anatomically accurate proportions for skeletal rig creation.
+*
+* @korean 뼈길이비율
+*/
+var BONE_HEIGHT_RATIOS = {
+	head: .125,
+	neck: .055,
+	spineUpper: .11,
+	spineMiddle: .11,
+	spineLower: .11,
+	shoulder: .055,
+	upperArm: .21,
+	elbow: .025,
+	forearm: .17,
+	wrist: .025,
+	hand: .105,
+	pelvis: .08,
+	hip: .05,
+	thigh: .265,
+	knee: .025,
+	shin: .22,
+	foot: .05
+};
+/**
+* Convert centimeters to meters.
+*
+* @param cm - Value in centimeters
+* @returns Value in meters
+* @korean cm를미터로
+*/
+function cmToMeters(cm) {
+	return cm / 100;
+}
+/**
+* Calculate skeleton bone dimensions in meters based on physical attributes.
+*
+* Returns actual bone lengths that should be used in SkeletonRig creation.
+* All values are in meters and anatomically proportioned.
+*
+* @param attrs - Physical attributes (in centimeters)
+* @returns Bone dimensions in meters
+* @korean 골격치수계산
+*/
+function calculateSkeletonDimensions(attrs) {
+	const totalHeightM = cmToMeters(attrs.totalHeight);
+	const armLengthM = cmToMeters(attrs.armLength);
+	const legLengthM = cmToMeters(attrs.legLength);
+	const shoulderWidthM = cmToMeters(attrs.shoulderWidth);
+	const neckLengthM = cmToMeters(attrs.neckLength);
+	const headSizeM = cmToMeters(attrs.headSize);
+	const torsoLengthM = cmToMeters(attrs.torsoLength);
+	const upperArmLength = armLengthM * BODY_PROPORTIONS.UPPER_ARM_RATIO;
+	const forearmLength = armLengthM * BODY_PROPORTIONS.FOREARM_RATIO;
+	const thighLength = legLengthM * BODY_PROPORTIONS.THIGH_LEG_RATIO;
+	const shinLength = legLengthM * BODY_PROPORTIONS.SHIN_LEG_RATIO;
+	const spineSegment = torsoLengthM / 3;
+	return {
+		pelvisHeight: legLengthM + .05,
+		spineLower: spineSegment,
+		spineMiddle: spineSegment,
+		spineUpper: spineSegment,
+		neck: neckLengthM || totalHeightM * BONE_HEIGHT_RATIOS.neck,
+		head: headSizeM || totalHeightM * BONE_HEIGHT_RATIOS.head,
+		shoulder: shoulderWidthM * .25,
+		upperArm: upperArmLength,
+		elbow: totalHeightM * BONE_HEIGHT_RATIOS.elbow,
+		forearm: forearmLength,
+		wrist: totalHeightM * BONE_HEIGHT_RATIOS.wrist,
+		hand: totalHeightM * BONE_HEIGHT_RATIOS.hand,
+		hip: totalHeightM * BONE_HEIGHT_RATIOS.hip,
+		thigh: thighLength,
+		knee: totalHeightM * BONE_HEIGHT_RATIOS.knee,
+		shin: shinLength,
+		foot: .05,
+		totalHeight: totalHeightM
+	};
+}
+//#endregion
+export { calculateSkeletonDimensions, cmToMeters };
+
+//# sourceMappingURL=characterScaling.js.map

package/lib/utils/characterScaling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterScaling.js","names":[],"sources":["../../src/utils/characterScaling.ts"],"sourcesContent":["/**\n * Unified character scaling system for Black Trigram.\n *\n * **Korean**: 통합 캐릭터 스케일링 시스템\n *\n * This module provides a physics-first approach to character scaling where:\n * - All measurements are in METERS for consistency with arena and physics\n * - Physical attributes (in cm) are converted to meters\n * - All body part dimensions derive from physical attributes\n * - Scale factors are based on anatomical proportions\n *\n * ## Design Philosophy\n *\n * The scaling system ensures that:\n * 1. Characters appear correctly sized in arenas (6-14 meters wide)\n * 2. Reach calculations (arm/leg length) match visual representation\n * 3. Muscle and clothing scale proportionally with body dimensions\n * 4. Combat animations use realistic distances\n *\n * ## Unit Conventions\n * - Physical attributes: centimeters (totalHeight: 180 = 180cm)\n * - World space: meters (arena width: 10 = 10m)\n * - Character model: meters (height: 1.80 = 1.80m)\n *\n * @module utils/characterScaling\n * @category Character Rendering\n * @korean 캐릭터스케일링\n */\n\nimport type { PhysicalAttributes } from \"@/types\";\n\n// ============================================================================\n// REFERENCE ANATOMY (Based on average Korean adult male proportions)\n// ============================================================================\n\n/**\n * Reference body proportions as fractions of total height.\n * Based on canonical human anatomy (8-head proportion system).\n *\n * @korean 기준신체비율\n */\nexport const BODY_PROPORTIONS = {\n  /** Head is ~1/8 of total height */\n  HEAD_HEIGHT_RATIO: 0.125,\n  /** Neck is ~0.055 of total height */\n  NECK_HEIGHT_RATIO: 0.055,\n  /** Torso (spine) is ~0.33 of total height */\n  TORSO_HEIGHT_RATIO: 0.33,\n  /** Leg (hip to floor) is ~0.48 of total height */\n  LEG_HEIGHT_RATIO: 0.48,\n  /** Upper leg (thigh) is ~55% of total leg length */\n  THIGH_LEG_RATIO: 0.55,\n  /** Lower leg (shin) is ~45% of total leg length */\n  SHIN_LEG_RATIO: 0.45,\n  /** Upper arm is ~55% of total arm length */\n  UPPER_ARM_RATIO: 0.55,\n  /** Forearm is ~45% of total arm length */\n  FOREARM_RATIO: 0.45,\n  /** Hand is ~0.11 of total height (or ~10.5% of total height) */\n  HAND_HEIGHT_RATIO: 0.105,\n  /** Foot length is ~15% of total height */\n  FOOT_LENGTH_RATIO: 0.15,\n  /** Shoulder width is typically 23-25% of height for males */\n  SHOULDER_WIDTH_RATIO: 0.255,\n  /** Hip width is typically 16-18% of height */\n  HIP_WIDTH_RATIO: 0.17,\n  /** Torso depth is typically 10-12% of height */\n  TORSO_DEPTH_RATIO: 0.11,\n} as const;\n\n/**\n * Bone length as fraction of total height.\n * These are anatomically accurate proportions for skeletal rig creation.\n *\n * @korean 뼈길이비율\n */\nexport const BONE_HEIGHT_RATIOS = {\n  // Head & Neck\n  head: 0.125, // 22.5cm for 180cm person\n  neck: 0.055, // 9.9cm for 180cm person\n\n  // Spine (split into 3 segments)\n  spineUpper: 0.11, // Upper thoracic\n  spineMiddle: 0.11, // Middle thoracic\n  spineLower: 0.11, // Lumbar\n\n  // Shoulders (clavicle + shoulder joint)\n  shoulder: 0.055, // Clavicle length\n\n  // Arms (based on arm length from physical attributes)\n  // Actual values calculated from physicalAttributes.armLength\n  upperArm: 0.21, // ~38cm for 180cm (55% of arm)\n  elbow: 0.025, // Elbow joint\n  forearm: 0.17, // ~31cm for 180cm (45% of arm)\n  wrist: 0.025, // Wrist joint\n  hand: 0.105, // ~19cm for 180cm\n\n  // Pelvis & Hips\n  pelvis: 0.08, // Pelvis height\n  hip: 0.05, // Hip joint\n\n  // Legs (based on leg length from physical attributes)\n  // Actual values calculated from physicalAttributes.legLength\n  thigh: 0.265, // ~48cm for 180cm (55% of leg)\n  knee: 0.025, // Knee joint\n  shin: 0.22, // ~40cm for 180cm (45% of leg)\n  foot: 0.05, // Ankle to ground\n} as const;\n\n// ============================================================================\n// CONVERSION UTILITIES\n// ============================================================================\n\n/**\n * Convert centimeters to meters.\n *\n * @param cm - Value in centimeters\n * @returns Value in meters\n * @korean cm를미터로\n */\nexport function cmToMeters(cm: number): number {\n  return cm / 100;\n}\n\n/**\n * Convert physical attributes from centimeters to meters.\n *\n * @param attrs - Physical attributes in centimeters\n * @returns Object with key measurements in meters\n * @korean 신체속성미터변환\n */\nexport function getPhysicalMeters(attrs: PhysicalAttributes): {\n  readonly totalHeight: number;\n  readonly armLength: number;\n  readonly legLength: number;\n  readonly shoulderWidth: number;\n  readonly torsoLength: number;\n  readonly headSize: number;\n  readonly neckLength: number;\n} {\n  return {\n    totalHeight: cmToMeters(attrs.totalHeight),\n    armLength: cmToMeters(attrs.armLength),\n    legLength: cmToMeters(attrs.legLength),\n    shoulderWidth: cmToMeters(attrs.shoulderWidth),\n    torsoLength: cmToMeters(attrs.torsoLength),\n    headSize: cmToMeters(attrs.headSize),\n    neckLength: cmToMeters(attrs.neckLength),\n  };\n}\n\n// ============================================================================\n// SKELETON DIMENSIONS\n// ============================================================================\n\n/**\n * Calculate skeleton bone dimensions in meters based on physical attributes.\n *\n * Returns actual bone lengths that should be used in SkeletonRig creation.\n * All values are in meters and anatomically proportioned.\n *\n * @param attrs - Physical attributes (in centimeters)\n * @returns Bone dimensions in meters\n * @korean 골격치수계산\n */\nexport function calculateSkeletonDimensions(attrs: PhysicalAttributes): {\n  readonly pelvisHeight: number;\n  readonly spineLower: number;\n  readonly spineMiddle: number;\n  readonly spineUpper: number;\n  readonly neck: number;\n  readonly head: number;\n  readonly shoulder: number;\n  readonly upperArm: number;\n  readonly elbow: number;\n  readonly forearm: number;\n  readonly wrist: number;\n  readonly hand: number;\n  readonly hip: number;\n  readonly thigh: number;\n  readonly knee: number;\n  readonly shin: number;\n  readonly foot: number;\n  readonly totalHeight: number;\n} {\n  const totalHeightM = cmToMeters(attrs.totalHeight);\n  const armLengthM = cmToMeters(attrs.armLength);\n  const legLengthM = cmToMeters(attrs.legLength);\n  const shoulderWidthM = cmToMeters(attrs.shoulderWidth);\n  const neckLengthM = cmToMeters(attrs.neckLength);\n  const headSizeM = cmToMeters(attrs.headSize);\n  const torsoLengthM = cmToMeters(attrs.torsoLength);\n\n  // Calculate arm segments based on actual arm length\n  const upperArmLength = armLengthM * BODY_PROPORTIONS.UPPER_ARM_RATIO;\n  const forearmLength = armLengthM * BODY_PROPORTIONS.FOREARM_RATIO;\n\n  // Calculate leg segments based on actual leg length\n  const thighLength = legLengthM * BODY_PROPORTIONS.THIGH_LEG_RATIO;\n  const shinLength = legLengthM * BODY_PROPORTIONS.SHIN_LEG_RATIO;\n\n  // Spine segments (divide torso into 3 parts)\n  const spineSegment = torsoLengthM / 3;\n\n  return {\n    // Pelvis height = leg length + foot height (to have feet at Y=0)\n    pelvisHeight: legLengthM + 0.05, // 0.05m for foot/ankle height\n\n    // Spine segments\n    spineLower: spineSegment,\n    spineMiddle: spineSegment,\n    spineUpper: spineSegment,\n\n    // Head & Neck (use actual values if available, or proportional)\n    neck: neckLengthM || totalHeightM * BONE_HEIGHT_RATIOS.neck,\n    head: headSizeM || totalHeightM * BONE_HEIGHT_RATIOS.head,\n\n    // Shoulders\n    shoulder: shoulderWidthM * 0.25, // Clavicle is ~25% of shoulder width\n\n    // Arms\n    upperArm: upperArmLength,\n    elbow: totalHeightM * BONE_HEIGHT_RATIOS.elbow,\n    forearm: forearmLength,\n    wrist: totalHeightM * BONE_HEIGHT_RATIOS.wrist,\n    hand: totalHeightM * BONE_HEIGHT_RATIOS.hand,\n\n    // Pelvis & Hip\n    hip: totalHeightM * BONE_HEIGHT_RATIOS.hip,\n\n    // Legs\n    thigh: thighLength,\n    knee: totalHeightM * BONE_HEIGHT_RATIOS.knee,\n    shin: shinLength,\n    foot: 0.05, // Ankle height\n\n    // Total for validation\n    totalHeight: totalHeightM,\n  };\n}\n\n// ============================================================================\n// MUSCLE DIMENSIONS\n// ============================================================================\n\n/**\n * Base muscle dimensions as fractions of associated bone length.\n * These are proportional values that scale with bone size.\n *\n * @korean 근육비율\n */\nexport const MUSCLE_BONE_RATIOS = {\n  // Shoulder muscles (deltoid)\n  shoulder: {\n    radiusFactor: 0.4, // 40% of shoulder bone length\n    lengthFactor: 0.8, // 80% of shoulder bone length\n  },\n\n  // Bicep (front of upper arm)\n  bicep: {\n    radiusFactor: 0.35, // 35% of upper arm length\n    lengthFactor: 0.7, // 70% of upper arm length\n  },\n\n  // Tricep (back of upper arm)\n  tricep: {\n    radiusFactor: 0.3, // 30% of upper arm length\n    lengthFactor: 0.65, // 65% of upper arm length\n  },\n\n  // Forearm\n  forearm: {\n    radiusFactor: 0.3, // 30% of forearm length\n    lengthFactor: 0.8, // 80% of forearm length\n  },\n\n  // Pectorals (chest)\n  pectorals: {\n    radiusFactor: 0.5, // 50% of torso segment\n    lengthFactor: 0.7, // 70% of torso segment\n  },\n\n  // Core/Abs\n  core: {\n    radiusFactor: 0.45, // 45% of torso segment\n    lengthFactor: 0.9, // 90% of torso segment\n  },\n\n  // Abs (lower core)\n  abs: {\n    radiusFactor: 0.4, // 40% of torso segment\n    lengthFactor: 0.8, // 80% of torso segment\n  },\n\n  // Obliques (side core)\n  obliques: {\n    radiusFactor: 0.35, // 35% of torso segment\n    lengthFactor: 0.75, // 75% of torso segment\n  },\n\n  // Glutes\n  glute: {\n    radiusFactor: 0.5, // 50% of hip/pelvis width\n    lengthFactor: 0.6, // 60% of hip area\n  },\n\n  // Quadriceps (front of thigh)\n  quad: {\n    radiusFactor: 0.35, // 35% of thigh length\n    lengthFactor: 0.8, // 80% of thigh length\n  },\n\n  // Hamstring (back of thigh)\n  hamstring: {\n    radiusFactor: 0.3, // 30% of thigh length\n    lengthFactor: 0.75, // 75% of thigh length\n  },\n\n  // Calf\n  calf: {\n    radiusFactor: 0.28, // 28% of shin length\n    lengthFactor: 0.6, // 60% of shin length\n  },\n} as const;\n\n/**\n * Calculate muscle dimensions in meters based on skeleton dimensions.\n *\n * @param skeletonDims - Skeleton dimensions from calculateSkeletonDimensions\n * @param muscleMass - Muscle mass in kg for scaling\n * @param referenceMass - Reference muscle mass (default 35kg)\n * @returns Muscle dimensions in meters\n * @korean 근육치수계산\n */\nexport function calculateMuscleDimensions(\n  skeletonDims: ReturnType<typeof calculateSkeletonDimensions>,\n  muscleMass: number,\n  referenceMass: number = 35,\n): Record<\n  string,\n  {\n    readonly radius: number;\n    readonly length: number;\n    readonly scaleFactor: number;\n  }\n> {\n  // Muscle scale factor based on muscle mass\n  // Uses square root for more natural visual scaling\n  const massRatio = muscleMass / referenceMass;\n  const scaleFactor = Math.sqrt(massRatio);\n\n  return {\n    shoulder: {\n      radius:\n        skeletonDims.shoulder *\n        MUSCLE_BONE_RATIOS.shoulder.radiusFactor *\n        scaleFactor,\n      length: skeletonDims.shoulder * MUSCLE_BONE_RATIOS.shoulder.lengthFactor,\n      scaleFactor,\n    },\n    bicep: {\n      radius:\n        skeletonDims.upperArm *\n        MUSCLE_BONE_RATIOS.bicep.radiusFactor *\n        scaleFactor,\n      length: skeletonDims.upperArm * MUSCLE_BONE_RATIOS.bicep.lengthFactor,\n      scaleFactor,\n    },\n    tricep: {\n      radius:\n        skeletonDims.upperArm *\n        MUSCLE_BONE_RATIOS.tricep.radiusFactor *\n        scaleFactor,\n      length: skeletonDims.upperArm * MUSCLE_BONE_RATIOS.tricep.lengthFactor,\n      scaleFactor,\n    },\n    forearm: {\n      radius:\n        skeletonDims.forearm *\n        MUSCLE_BONE_RATIOS.forearm.radiusFactor *\n        scaleFactor,\n      length: skeletonDims.forearm * MUSCLE_BONE_RATIOS.forearm.lengthFactor,\n      scaleFactor,\n    },\n    pectorals: {\n      radius:\n        skeletonDims.spineMiddle *\n        MUSCLE_BONE_RATIOS.pectorals.radiusFactor *\n        scaleFactor,\n      length:\n        skeletonDims.spineMiddle * MUSCLE_BONE_RATIOS.pectorals.lengthFactor,\n      scaleFactor,\n    },\n    core: {\n      radius:\n        skeletonDims.spineMiddle *\n        MUSCLE_BONE_RATIOS.core.radiusFactor *\n        scaleFactor,\n      length: skeletonDims.spineMiddle * MUSCLE_BONE_RATIOS.core.lengthFactor,\n      scaleFactor,\n    },\n    abs: {\n      radius:\n        skeletonDims.spineLower *\n        MUSCLE_BONE_RATIOS.abs.radiusFactor *\n        scaleFactor,\n      length: skeletonDims.spineLower * MUSCLE_BONE_RATIOS.abs.lengthFactor,\n      scaleFactor,\n    },\n    obliques: {\n      radius:\n        skeletonDims.spineLower *\n        MUSCLE_BONE_RATIOS.obliques.radiusFactor *\n        scaleFactor,\n      length:\n        skeletonDims.spineLower * MUSCLE_BONE_RATIOS.obliques.lengthFactor,\n      scaleFactor,\n    },\n    glute: {\n      radius:\n        skeletonDims.hip * MUSCLE_BONE_RATIOS.glute.radiusFactor * scaleFactor,\n      length: skeletonDims.hip * MUSCLE_BONE_RATIOS.glute.lengthFactor,\n      scaleFactor,\n    },\n    quad: {\n      radius:\n        skeletonDims.thigh * MUSCLE_BONE_RATIOS.quad.radiusFactor * scaleFactor,\n      length: skeletonDims.thigh * MUSCLE_BONE_RATIOS.quad.lengthFactor,\n      scaleFactor,\n    },\n    hamstring: {\n      radius:\n        skeletonDims.thigh *\n        MUSCLE_BONE_RATIOS.hamstring.radiusFactor *\n        scaleFactor,\n      length: skeletonDims.thigh * MUSCLE_BONE_RATIOS.hamstring.lengthFactor,\n      scaleFactor,\n    },\n    calf: {\n      radius:\n        skeletonDims.shin * MUSCLE_BONE_RATIOS.calf.radiusFactor * scaleFactor,\n      length: skeletonDims.shin * MUSCLE_BONE_RATIOS.calf.lengthFactor,\n      scaleFactor,\n    },\n  };\n}\n\n// ============================================================================\n// HAND & FOOT DIMENSIONS\n// ============================================================================\n\n/**\n * Calculate hand dimensions in meters based on physical attributes.\n *\n * @param attrs - Physical attributes\n * @returns Hand dimensions in meters\n * @korean 손치수계산\n */\nexport function calculateHandDimensions(attrs: PhysicalAttributes): {\n  readonly palmLength: number;\n  readonly palmWidth: number;\n  readonly palmDepth: number;\n  readonly fingerLengths: {\n    readonly thumb: number;\n    readonly index: number;\n    readonly middle: number;\n    readonly ring: number;\n    readonly pinky: number;\n  };\n  readonly fingerWidths: {\n    readonly thumb: number;\n    readonly index: number;\n    readonly middle: number;\n    readonly ring: number;\n    readonly pinky: number;\n  };\n} {\n  const totalHeightM = cmToMeters(attrs.totalHeight);\n\n  // Hand is ~10.5% of total height, palm is ~55% of hand\n  const handLength = totalHeightM * BODY_PROPORTIONS.HAND_HEIGHT_RATIO;\n  const palmLength = handLength * 0.55;\n  const fingerBaseLength = handLength * 0.45; // Fingers are 45% of hand\n\n  // Palm width is ~85% of palm length\n  const palmWidth = palmLength * 0.85;\n  const palmDepth = palmLength * 0.25;\n\n  // Finger lengths relative to middle finger (longest)\n  const middleFingerLength = fingerBaseLength;\n\n  return {\n    palmLength,\n    palmWidth,\n    palmDepth,\n    fingerLengths: {\n      thumb: middleFingerLength * 0.65, // Thumb is ~65% of middle finger\n      index: middleFingerLength * 0.95, // Index is ~95% of middle finger\n      middle: middleFingerLength, // Middle is longest\n      ring: middleFingerLength * 0.94, // Ring is ~94% of middle finger\n      pinky: middleFingerLength * 0.75, // Pinky is ~75% of middle finger\n    },\n    fingerWidths: {\n      thumb: palmWidth * 0.2, // Thumb is thickest\n      index: palmWidth * 0.16,\n      middle: palmWidth * 0.16,\n      ring: palmWidth * 0.15,\n      pinky: palmWidth * 0.13, // Pinky is thinnest\n    },\n  };\n}\n\n/**\n * Calculate foot dimensions in meters based on physical attributes.\n *\n * @param attrs - Physical attributes\n * @returns Foot dimensions in meters\n * @korean 발치수계산\n */\nexport function calculateFootDimensions(attrs: PhysicalAttributes): {\n  readonly footLength: number;\n  readonly footWidth: number;\n  readonly footHeight: number;\n  readonly toeLength: number;\n  readonly heelLength: number;\n  readonly ankleRadius: number;\n} {\n  const totalHeightM = cmToMeters(attrs.totalHeight);\n\n  // Foot length is ~15% of total height\n  const footLength = totalHeightM * BODY_PROPORTIONS.FOOT_LENGTH_RATIO;\n\n  return {\n    footLength,\n    footWidth: footLength * 0.38, // Foot width is ~38% of length\n    footHeight: footLength * 0.3, // Foot height at ankle is ~30% of length\n    toeLength: footLength * 0.3, // Toes are ~30% of foot length\n    heelLength: footLength * 0.7, // Heel area is ~70% of foot length\n    ankleRadius: footLength * 0.12, // Ankle joint radius\n  };\n}\n\n// ============================================================================\n// CLOTHING DIMENSIONS\n// ============================================================================\n\n/**\n * Clothing fit scale multipliers.\n * Applied on top of body dimensions.\n *\n * @korean 의류핏배율\n */\nexport const CLOTHING_FIT_SCALES = {\n  tight: 1.02, // 2% larger than body\n  fitted: 1.06, // 6% larger than body\n  regular: 1.1, // 10% larger than body\n  loose: 1.18, // 18% larger than body\n  oversized: 1.3, // 30% larger than body\n} as const;\n\nexport type ClothingFit = keyof typeof CLOTHING_FIT_SCALES;\n\n/**\n * Calculate clothing dimensions in meters based on physical attributes.\n *\n * @param attrs - Physical attributes\n * @param fit - Clothing fit type\n * @returns Clothing dimensions in meters\n * @korean 의류치수계산\n */\nexport function calculateClothingDimensions(\n  attrs: PhysicalAttributes,\n  fit: ClothingFit = \"fitted\",\n): {\n  readonly torsoWidth: number;\n  readonly torsoDepth: number;\n  readonly torsoLength: number;\n  readonly armThickness: number;\n  readonly legThickness: number;\n  readonly fitScale: number;\n} {\n  const phys = getPhysicalMeters(attrs);\n  const fitScale = CLOTHING_FIT_SCALES[fit];\n\n  // Calculate body thickness factor based on mass distribution\n  const bmi = attrs.weight / Math.pow(phys.totalHeight, 2);\n  const thicknessFactor = Math.min(1.3, Math.max(0.85, bmi / 22)); // Normalize around BMI 22\n\n  return {\n    torsoWidth: phys.shoulderWidth * fitScale,\n    torsoDepth: phys.shoulderWidth * 0.45 * fitScale * thicknessFactor,\n    torsoLength: phys.torsoLength * fitScale,\n    armThickness: phys.armLength * 0.12 * fitScale * thicknessFactor,\n    legThickness: phys.legLength * 0.14 * fitScale * thicknessFactor,\n    fitScale,\n  };\n}\n\n// ============================================================================\n// VISUAL SCALING (for render-time adjustments)\n// ============================================================================\n\n/**\n * Visual amplification factor for better screen readability.\n * This is applied uniformly to make characters more visible in the arena.\n * Does NOT affect physics or reach calculations.\n *\n * Value of 1.0 = realistic scale (1.8m character in 10m arena)\n * Value of 1.15 = 15% larger for better visibility\n *\n * @korean 시각적증폭계수\n */\nexport const VISUAL_SCALE_FACTOR = 1.0;\n\n/**\n * Calculate the uniform scale factor to apply to a character group.\n * This ensures the character's total height matches their physical height.\n *\n * @param attrs - Physical attributes\n * @param baseSkeletonHeight - Height of the base skeleton rig (before scaling)\n * @returns Scale factor to apply to character group\n * @korean 캐릭터스케일계산\n */\nexport function calculateCharacterScale(\n  attrs: PhysicalAttributes,\n  baseSkeletonHeight: number = 1.8, // Default skeleton is ~1.8m\n): number {\n  const targetHeight = cmToMeters(attrs.totalHeight);\n  const scale = targetHeight / baseSkeletonHeight;\n  return scale * VISUAL_SCALE_FACTOR;\n}\n"],"mappings":";;;;;;;AAyCA,IAAa,mBAAmB;CAE9B,mBAAmB;CAEnB,mBAAmB;CAEnB,oBAAoB;CAEpB,kBAAkB;CAElB,iBAAiB;CAEjB,gBAAgB;CAEhB,iBAAiB;CAEjB,eAAe;CAEf,mBAAmB;CAEnB,mBAAmB;CAEnB,sBAAsB;CAEtB,iBAAiB;CAEjB,mBAAmB;CACpB;;;;;;;AAQD,IAAa,qBAAqB;CAEhC,MAAM;CACN,MAAM;CAGN,YAAY;CACZ,aAAa;CACb,YAAY;CAGZ,UAAU;CAIV,UAAU;CACV,OAAO;CACP,SAAS;CACT,OAAO;CACP,MAAM;CAGN,QAAQ;CACR,KAAK;CAIL,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACP;;;;;;;;AAaD,SAAgB,WAAW,IAAoB;AAC7C,QAAO,KAAK;;;;;;;;;;;;AA4Cd,SAAgB,4BAA4B,OAmB1C;CACA,MAAM,eAAe,WAAW,MAAM,YAAY;CAClD,MAAM,aAAa,WAAW,MAAM,UAAU;CAC9C,MAAM,aAAa,WAAW,MAAM,UAAU;CAC9C,MAAM,iBAAiB,WAAW,MAAM,cAAc;CACtD,MAAM,cAAc,WAAW,MAAM,WAAW;CAChD,MAAM,YAAY,WAAW,MAAM,SAAS;CAC5C,MAAM,eAAe,WAAW,MAAM,YAAY;CAGlD,MAAM,iBAAiB,aAAa,iBAAiB;CACrD,MAAM,gBAAgB,aAAa,iBAAiB;CAGpD,MAAM,cAAc,aAAa,iBAAiB;CAClD,MAAM,aAAa,aAAa,iBAAiB;CAGjD,MAAM,eAAe,eAAe;AAEpC,QAAO;EAEL,cAAc,aAAa;EAG3B,YAAY;EACZ,aAAa;EACb,YAAY;EAGZ,MAAM,eAAe,eAAe,mBAAmB;EACvD,MAAM,aAAa,eAAe,mBAAmB;EAGrD,UAAU,iBAAiB;EAG3B,UAAU;EACV,OAAO,eAAe,mBAAmB;EACzC,SAAS;EACT,OAAO,eAAe,mBAAmB;EACzC,MAAM,eAAe,mBAAmB;EAGxC,KAAK,eAAe,mBAAmB;EAGvC,OAAO;EACP,MAAM,eAAe,mBAAmB;EACxC,MAAM;EACN,MAAM;EAGN,aAAa;EACd"}

package/lib/utils/clothingColors.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Clothing Color Utilities
+ *
+ * **Korean**: 의류 색상 유틸리티 (Clothing Color Utilities)
+ *
+ * Provides color manipulation and variation functions for clothing customization
+ * while maintaining Korean cyberpunk aesthetic principles.
+ *
+ * @module utils/clothingColors
+ * @category Utilities
+ * @korean 의류색상유틸리티
+ */
+/**
+ * Adjust color brightness
+ *
+ * @param hexColor - Base color as hex number
+ * @param factor - Brightness factor (0 = black, 1 = original, 2 = twice as bright)
+ * @returns Adjusted color as hex number
+ * @korean 색상밝기조정
+ */
+export declare function adjustBrightness(hexColor: number, factor: number): number;
+/**
+ * Adjust color saturation
+ *
+ * @param hexColor - Base color as hex number
+ * @param saturation - Saturation amount (0 = grayscale, 1 = original, >1 = more saturated)
+ * @returns Adjusted color as hex number
+ * @korean 색상채도조정
+ */
+export declare function adjustSaturation(hexColor: number, saturation: number): number;
+/**
+ * Shift color hue
+ *
+ * @param hexColor - Base color as hex number
+ * @param shift - Hue shift amount (0-1, wraps around)
+ * @returns Shifted color as hex number
+ * @korean 색상색조이동
+ */
+export declare function shiftHue(hexColor: number, shift: number): number;
+/**
+ * Blend two colors (Three.js-based color interpolation)
+ *
+ * @param color1 - First color as hex number
+ * @param color2 - Second color as hex number
+ * @param blend - Blend factor (0 = all color1, 1 = all color2)
+ * @returns Blended color as hex number
+ * @korean 색상혼합
+ */
+export declare function blendColorsThree(color1: number, color2: number, blend: number): number;
+/**
+ * Create color variation (for team colors, customization, etc.)
+ *
+ * @param baseColor - Base color as hex number
+ * @param variationType - Type of variation to apply
+ * @returns Variant color as hex number
+ * @korean 색상변형
+ */
+export declare function createColorVariation(baseColor: number, variationType: "lighter" | "darker" | "saturated" | "desaturated" | "complementary"): number;
+/**
+ * Generate team color set from base color
+ *
+ * Useful for multiplayer team identification while maintaining aesthetic
+ *
+ * @param baseColor - Base team color as hex number
+ * @returns Set of related team colors
+ * @korean 팀색상생성
+ */
+export declare function generateTeamColors(baseColor: number): {
+    primary: number;
+    light: number;
+    dark: number;
+    accent: number;
+};
+/**
+ * Apply damage/dirt effect to clothing color
+ *
+ * Simulates visual wear from combat
+ *
+ * @param baseColor - Clean clothing color as hex number
+ * @param damageLevel - Amount of damage (0 = pristine, 1 = heavily damaged)
+ * @returns Damaged color as hex number
+ * @korean 손상색상적용
+ */
+export declare function applyDamageColor(baseColor: number, damageLevel: number): number;
+/**
+ * Check if color is light or dark (for contrast calculations)
+ *
+ * @param hexColor - Color to check as hex number
+ * @returns True if color is light, false if dark
+ * @korean 밝은색상확인
+ */
+export declare function isLightColor(hexColor: number): boolean;
+/**
+ * Get contrasting color for text/UI elements
+ *
+ * @param backgroundColor - Background color as hex number
+ * @returns Contrasting color (black or white) as hex number
+ * @korean 대비색상가져오기
+ */
+export declare function getContrastingColor(backgroundColor: number): number;
+/**
+ * Create color palette from archetype theme
+ *
+ * Generates a cohesive palette maintaining Korean cyberpunk aesthetic
+ *
+ * @param primaryColor - Primary archetype color
+ * @param accentColor - Accent/secondary color
+ * @returns Expanded color palette
+ * @korean 색상팔레트생성
+ */
+export declare function createArchetypePalette(primaryColor: number, accentColor: number): {
+    primary: number;
+    primaryLight: number;
+    primaryDark: number;
+    accent: number;
+    accentLight: number;
+    accentDark: number;
+    neutral: number;
+};
+//# sourceMappingURL=clothingColors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clothingColors.d.ts","sourceRoot":"","sources":["../../src/utils/clothingColors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAU7E;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAStF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,eAAe,GAClF,MAAM,CAoBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAOA;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAc/E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAUA"}

package/lib/utils/clothingMaterials.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Clothing Material Utilities
+ *
+ * **Korean**: 의류 재료 유틸리티 (Clothing Material Utilities)
+ *
+ * Provides material presets and utility functions for clothing materials
+ * following Korean cyberpunk aesthetic principles.
+ *
+ * @module utils/clothingMaterials
+ * @category Utilities
+ * @korean 의류재료유틸리티
+ */
+import type { MaterialPreset } from "../types/clothing";
+/**
+ * Material presets for different clothing types
+ *
+ * These presets define realistic material properties based on
+ * real-world fabric and material characteristics.
+ *
+ * @korean 재료프리셋
+ */
+export declare const CLOTHING_MATERIAL_PRESETS: Record<string, MaterialPreset>;
+/**
+ * Get material preset by name
+ *
+ * @param presetName - Name of the material preset
+ * @returns Material preset configuration
+ * @korean 재료프리셋가져오기
+ */
+export declare function getMaterialPreset(presetName: string): MaterialPreset;
+/**
+ * Blend two material presets
+ *
+ * Useful for creating hybrid materials (e.g., leather with metallic accents)
+ *
+ * @param preset1 - First material preset
+ * @param preset2 - Second material preset
+ * @param blend - Blend factor (0 = all preset1, 1 = all preset2)
+ * @returns Blended material preset
+ * @korean 재료프리셋혼합
+ */
+export declare function blendMaterialPresets(preset1: MaterialPreset, preset2: MaterialPreset, blend: number): MaterialPreset;
+/**
+ * Adjust material preset for wear and tear
+ *
+ * Simulates material degradation over time or from combat damage
+ *
+ * @param preset - Base material preset
+ * @param wearLevel - Wear amount (0 = new, 1 = heavily worn)
+ * @returns Adjusted material preset
+ * @korean 재료마모조정
+ */
+export declare function applyWear(preset: MaterialPreset, wearLevel: number): MaterialPreset;
+/**
+ * Get material preset for archetype-specific style
+ *
+ * Returns appropriate material based on archetype philosophy
+ *
+ * @param archetype - Player archetype
+ * @param clothingType - Type of clothing item
+ * @returns Recommended material preset
+ * @korean 원형재료프리셋
+ */
+export declare function getArchetypeMaterialStyle(archetype: string, clothingType: string): MaterialPreset;
+//# sourceMappingURL=clothingMaterials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clothingMaterials.d.ts","sourceRoot":"","sources":["../../src/utils/clothingMaterials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAiGpE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,GACZ,cAAc,CAShB;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAQnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,cAAc,CAkChB"}