blacktrigram 0.7.2

package/lib/utils/stanceHelpers.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Shared utility functions for stance-related operations
+ *
+ * Provides common helpers for stance colors, names, and symbols
+ * to avoid duplication across components.
+ *
+ * @module utils/stanceHelpers
+ * @category Utilities
+ * @korean 자세도우미
+ */
+import { TrigramStance } from "../types/common";
+/**
+ * Get color for each trigram stance
+ * Maps 8 trigrams to Korean cyberpunk color palette
+ *
+ * @param stance - Current trigram stance
+ * @returns Hex color number
+ * @korean 자세색상가져오기
+ */
+export declare const getStanceColor: (stance: TrigramStance) => number;
+/**
+ * Get stance display names (Korean + English)
+ *
+ * @param stance - Current trigram stance
+ * @returns Object with korean, english, and romanized names
+ * @korean 자세이름가져오기
+ */
+export declare const getStanceNames: (stance: TrigramStance) => {
+    korean: string;
+    english: string;
+    romanized: string;
+} | {
+    korean: string;
+    english: string;
+    romanized: string;
+} | {
+    korean: string;
+    english: string;
+    romanized: string;
+} | {
+    korean: string;
+    english: string;
+    romanized: string;
+} | {
+    korean: string;
+    english: string;
+    romanized: string;
+} | {
+    korean: string;
+    english: string;
+    romanized: string;
+} | {
+    korean: string;
+    english: string;
+    romanized: string;
+} | {
+    korean: string;
+    english: string;
+    romanized: string;
+};
+/**
+ * Get trigram Unicode symbol for each stance
+ *
+ * @param stance - Current trigram stance
+ * @returns Unicode trigram symbol
+ * @korean 팔괘기호가져오기
+ */
+export declare const getTrigramSymbol: (stance: TrigramStance) => string;
+/**
+ * Get Korean name for each stance
+ *
+ * @param stance - Current trigram stance
+ * @returns Korean name (Hangul)
+ * @korean 자세한글이름가져오기
+ */
+export declare const getStanceKoreanName: (stance: TrigramStance) => string;
+/**
+ * Get color as hex string for CSS usage
+ *
+ * @param stance - Current trigram stance
+ * @returns Hex color string (e.g., "#FFD700")
+ * @korean 자세CSS색상가져오기
+ */
+export declare const getStanceColorHex: (stance: TrigramStance) => string;
+//# sourceMappingURL=stanceHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stanceHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/stanceHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,aAAa,KAAG,MAYtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,aAAa,KAAG,MAYxD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,aAAa,KAAG,MAE3D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,aAAa,KAAG,MAGzD,CAAC"}

package/lib/utils/stanceHelpers.js

@@ -0,0 +1,132 @@
+import { TrigramStance } from "../types/common.js";
+import { KOREAN_COLORS } from "../types/constants/colors.js";
+import "../types/constants/index.js";
+//#region src/utils/stanceHelpers.ts
+/**
+* Shared utility functions for stance-related operations
+*
+* Provides common helpers for stance colors, names, and symbols
+* to avoid duplication across components.
+*
+* @module utils/stanceHelpers
+* @category Utilities
+* @korean 자세도우미
+*/
+/**
+* Get color for each trigram stance
+* Maps 8 trigrams to Korean cyberpunk color palette
+*
+* @param stance - Current trigram stance
+* @returns Hex color number
+* @korean 자세색상가져오기
+*/
+var getStanceColor = (stance) => {
+	return {
+		[TrigramStance.GEON]: KOREAN_COLORS.TRIGRAM_GEON_PRIMARY,
+		[TrigramStance.TAE]: KOREAN_COLORS.TRIGRAM_TAE_PRIMARY,
+		[TrigramStance.LI]: KOREAN_COLORS.TRIGRAM_LI_PRIMARY,
+		[TrigramStance.JIN]: KOREAN_COLORS.TRIGRAM_JIN_PRIMARY,
+		[TrigramStance.SON]: KOREAN_COLORS.TRIGRAM_SON_PRIMARY,
+		[TrigramStance.GAM]: KOREAN_COLORS.TRIGRAM_GAM_PRIMARY,
+		[TrigramStance.GAN]: KOREAN_COLORS.TRIGRAM_GAN_PRIMARY,
+		[TrigramStance.GON]: KOREAN_COLORS.TRIGRAM_GON_PRIMARY
+	}[stance] ?? KOREAN_COLORS.PRIMARY_CYAN;
+};
+/**
+* Get stance display names (Korean + English)
+*
+* @param stance - Current trigram stance
+* @returns Object with korean, english, and romanized names
+* @korean 자세이름가져오기
+*/
+var getStanceNames = (stance) => {
+	return {
+		[TrigramStance.GEON]: {
+			korean: "건",
+			english: "Heaven",
+			romanized: "Geon"
+		},
+		[TrigramStance.TAE]: {
+			korean: "태",
+			english: "Lake",
+			romanized: "Tae"
+		},
+		[TrigramStance.LI]: {
+			korean: "리",
+			english: "Fire",
+			romanized: "Li"
+		},
+		[TrigramStance.JIN]: {
+			korean: "진",
+			english: "Thunder",
+			romanized: "Jin"
+		},
+		[TrigramStance.SON]: {
+			korean: "손",
+			english: "Wind",
+			romanized: "Son"
+		},
+		[TrigramStance.GAM]: {
+			korean: "감",
+			english: "Water",
+			romanized: "Gam"
+		},
+		[TrigramStance.GAN]: {
+			korean: "간",
+			english: "Mountain",
+			romanized: "Gan"
+		},
+		[TrigramStance.GON]: {
+			korean: "곤",
+			english: "Earth",
+			romanized: "Gon"
+		}
+	}[stance] ?? {
+		korean: "건",
+		english: "Heaven",
+		romanized: "Geon"
+	};
+};
+/**
+* Get trigram Unicode symbol for each stance
+*
+* @param stance - Current trigram stance
+* @returns Unicode trigram symbol
+* @korean 팔괘기호가져오기
+*/
+var getTrigramSymbol = (stance) => {
+	return {
+		[TrigramStance.GEON]: "☰",
+		[TrigramStance.TAE]: "☱",
+		[TrigramStance.LI]: "☲",
+		[TrigramStance.JIN]: "☳",
+		[TrigramStance.SON]: "☴",
+		[TrigramStance.GAM]: "☵",
+		[TrigramStance.GAN]: "☶",
+		[TrigramStance.GON]: "☷"
+	}[stance] ?? "☰";
+};
+/**
+* Get Korean name for each stance
+*
+* @param stance - Current trigram stance
+* @returns Korean name (Hangul)
+* @korean 자세한글이름가져오기
+*/
+var getStanceKoreanName = (stance) => {
+	return getStanceNames(stance).korean;
+};
+/**
+* Get color as hex string for CSS usage
+*
+* @param stance - Current trigram stance
+* @returns Hex color string (e.g., "#FFD700")
+* @korean 자세CSS색상가져오기
+*/
+var getStanceColorHex = (stance) => {
+	return `#${getStanceColor(stance).toString(16).padStart(6, "0").toLowerCase()}`;
+};
+//#endregion
+export { getStanceColor, getStanceColorHex, getStanceKoreanName, getStanceNames, getTrigramSymbol };
+
+//# sourceMappingURL=stanceHelpers.js.map

package/lib/utils/stanceHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stanceHelpers.js","names":[],"sources":["../../src/utils/stanceHelpers.ts"],"sourcesContent":["/**\n * Shared utility functions for stance-related operations\n *\n * Provides common helpers for stance colors, names, and symbols\n * to avoid duplication across components.\n *\n * @module utils/stanceHelpers\n * @category Utilities\n * @korean 자세도우미\n */\n\nimport { TrigramStance } from \"../types/common\";\nimport { KOREAN_COLORS } from \"@/types/constants\";\n\n/**\n * Get color for each trigram stance\n * Maps 8 trigrams to Korean cyberpunk color palette\n *\n * @param stance - Current trigram stance\n * @returns Hex color number\n * @korean 자세색상가져오기\n */\nexport const getStanceColor = (stance: TrigramStance): number => {\n  const stanceColors = {\n    [TrigramStance.GEON]: KOREAN_COLORS.TRIGRAM_GEON_PRIMARY, // Heaven - Gold\n    [TrigramStance.TAE]: KOREAN_COLORS.TRIGRAM_TAE_PRIMARY, // Lake - Sky Blue\n    [TrigramStance.LI]: KOREAN_COLORS.TRIGRAM_LI_PRIMARY, // Fire - Orange Red\n    [TrigramStance.JIN]: KOREAN_COLORS.TRIGRAM_JIN_PRIMARY, // Thunder - Purple\n    [TrigramStance.SON]: KOREAN_COLORS.TRIGRAM_SON_PRIMARY, // Wind - Light Green\n    [TrigramStance.GAM]: KOREAN_COLORS.TRIGRAM_GAM_PRIMARY, // Water - Blue\n    [TrigramStance.GAN]: KOREAN_COLORS.TRIGRAM_GAN_PRIMARY, // Mountain - Brown\n    [TrigramStance.GON]: KOREAN_COLORS.TRIGRAM_GON_PRIMARY, // Earth - Dark Khaki\n  };\n  return stanceColors[stance] ?? KOREAN_COLORS.PRIMARY_CYAN;\n};\n\n/**\n * Get stance display names (Korean + English)\n *\n * @param stance - Current trigram stance\n * @returns Object with korean, english, and romanized names\n * @korean 자세이름가져오기\n */\nexport const getStanceNames = (stance: TrigramStance) => {\n  const names = {\n    [TrigramStance.GEON]: {\n      korean: \"건\",\n      english: \"Heaven\",\n      romanized: \"Geon\",\n    },\n    [TrigramStance.TAE]: { korean: \"태\", english: \"Lake\", romanized: \"Tae\" },\n    [TrigramStance.LI]: { korean: \"리\", english: \"Fire\", romanized: \"Li\" },\n    [TrigramStance.JIN]: { korean: \"진\", english: \"Thunder\", romanized: \"Jin\" },\n    [TrigramStance.SON]: { korean: \"손\", english: \"Wind\", romanized: \"Son\" },\n    [TrigramStance.GAM]: { korean: \"감\", english: \"Water\", romanized: \"Gam\" },\n    [TrigramStance.GAN]: {\n      korean: \"간\",\n      english: \"Mountain\",\n      romanized: \"Gan\",\n    },\n    [TrigramStance.GON]: { korean: \"곤\", english: \"Earth\", romanized: \"Gon\" },\n  };\n  return (\n    names[stance] ?? { korean: \"건\", english: \"Heaven\", romanized: \"Geon\" }\n  );\n};\n\n/**\n * Get trigram Unicode symbol for each stance\n *\n * @param stance - Current trigram stance\n * @returns Unicode trigram symbol\n * @korean 팔괘기호가져오기\n */\nexport const getTrigramSymbol = (stance: TrigramStance): string => {\n  const symbols = {\n    [TrigramStance.GEON]: \"☰\", // Heaven\n    [TrigramStance.TAE]: \"☱\", // Lake\n    [TrigramStance.LI]: \"☲\", // Fire\n    [TrigramStance.JIN]: \"☳\", // Thunder\n    [TrigramStance.SON]: \"☴\", // Wind\n    [TrigramStance.GAM]: \"☵\", // Water\n    [TrigramStance.GAN]: \"☶\", // Mountain\n    [TrigramStance.GON]: \"☷\", // Earth\n  };\n  return symbols[stance] ?? \"☰\";\n};\n\n/**\n * Get Korean name for each stance\n *\n * @param stance - Current trigram stance\n * @returns Korean name (Hangul)\n * @korean 자세한글이름가져오기\n */\nexport const getStanceKoreanName = (stance: TrigramStance): string => {\n  return getStanceNames(stance).korean;\n};\n\n/**\n * Get color as hex string for CSS usage\n *\n * @param stance - Current trigram stance\n * @returns Hex color string (e.g., \"#FFD700\")\n * @korean 자세CSS색상가져오기\n */\nexport const getStanceColorHex = (stance: TrigramStance): string => {\n  const color = getStanceColor(stance);\n  return `#${color.toString(16).padStart(6, \"0\").toLowerCase()}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,kBAAkB,WAAkC;AAW/D,QAVqB;GAClB,cAAc,OAAO,cAAc;GACnC,cAAc,MAAM,cAAc;GAClC,cAAc,KAAK,cAAc;GACjC,cAAc,MAAM,cAAc;GAClC,cAAc,MAAM,cAAc;GAClC,cAAc,MAAM,cAAc;GAClC,cAAc,MAAM,cAAc;GAClC,cAAc,MAAM,cAAc;EACpC,CACmB,WAAW,cAAc;;;;;;;;;AAU/C,IAAa,kBAAkB,WAA0B;AAmBvD,QAlBc;GACX,cAAc,OAAO;GACpB,QAAQ;GACR,SAAS;GACT,WAAW;GACZ;GACA,cAAc,MAAM;GAAE,QAAQ;GAAK,SAAS;GAAQ,WAAW;GAAO;GACtE,cAAc,KAAK;GAAE,QAAQ;GAAK,SAAS;GAAQ,WAAW;GAAM;GACpE,cAAc,MAAM;GAAE,QAAQ;GAAK,SAAS;GAAW,WAAW;GAAO;GACzE,cAAc,MAAM;GAAE,QAAQ;GAAK,SAAS;GAAQ,WAAW;GAAO;GACtE,cAAc,MAAM;GAAE,QAAQ;GAAK,SAAS;GAAS,WAAW;GAAO;GACvE,cAAc,MAAM;GACnB,QAAQ;GACR,SAAS;GACT,WAAW;GACZ;GACA,cAAc,MAAM;GAAE,QAAQ;GAAK,SAAS;GAAS,WAAW;GAAO;EACzE,CAEO,WAAW;EAAE,QAAQ;EAAK,SAAS;EAAU,WAAW;EAAQ;;;;;;;;;AAW1E,IAAa,oBAAoB,WAAkC;AAWjE,QAVgB;GACb,cAAc,OAAO;GACrB,cAAc,MAAM;GACpB,cAAc,KAAK;GACnB,cAAc,MAAM;GACpB,cAAc,MAAM;GACpB,cAAc,MAAM;GACpB,cAAc,MAAM;GACpB,cAAc,MAAM;EACtB,CACc,WAAW;;;;;;;;;AAU5B,IAAa,uBAAuB,WAAkC;AACpE,QAAO,eAAe,OAAO,CAAC;;;;;;;;;AAUhC,IAAa,qBAAqB,WAAkC;AAElE,QAAO,IADO,eAAe,OAAO,CACnB,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa"}

package/lib/utils/threeObjectPool.d.ts

@@ -0,0 +1,323 @@
+/**
+ * Three.js Object Pool for Animation Performance
+ *
+ * Specialized object pooling for frequently created Three.js objects
+ * to reduce garbage collection pressure during animation updates.
+ *
+ * Target: Reduce ~1,344 object allocations per frame to near-zero.
+ *
+ * @module utils/threeObjectPool
+ * @category Performance
+ * @korean Three.js객체풀
+ */
+import * as THREE from "three";
+/**
+ * Pool for THREE.Euler objects used in bone rotations
+ *
+ * Reduces GC pressure from creating new Euler objects every frame.
+ * Prewarmed with 200 objects (2 characters × 28 bones × 3.5 keyframes avg)
+ *
+ * @korean 오일러풀
+ */
+declare class EulerPool {
+    private pool;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    /**
+     * Acquire an Euler object from the pool
+     * @returns Pooled or new Euler object (reset to 0,0,0)
+     */
+    acquire(): THREE.Euler;
+    /**
+     * Return an Euler object to the pool
+     * @param euler - Euler object to return
+     */
+    release(euler: THREE.Euler): void;
+    /**
+     * Pre-populate pool with objects
+     * @param count - Number of objects to create
+     */
+    prewarm(count: number): void;
+    /**
+     * Get current pool size
+     */
+    get size(): number;
+    /**
+     * Clear all pooled objects
+     */
+    clear(): void;
+}
+/**
+ * Pool for THREE.Vector3 objects used in bone positions
+ *
+ * Reduces GC pressure from creating new Vector3 objects every frame.
+ * Prewarmed with 200 objects (2 characters × 28 bones × 3.5 keyframes avg)
+ *
+ * @korean 벡터3풀
+ */
+declare class Vector3Pool {
+    private pool;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    /**
+     * Acquire a Vector3 object from the pool
+     * @returns Pooled or new Vector3 object (reset to 0,0,0)
+     */
+    acquire(): THREE.Vector3;
+    /**
+     * Return a Vector3 object to the pool
+     * @param vector - Vector3 object to return
+     */
+    release(vector: THREE.Vector3): void;
+    /**
+     * Pre-populate pool with objects
+     * @param count - Number of objects to create
+     */
+    prewarm(count: number): void;
+    /**
+     * Get current pool size
+     */
+    get size(): number;
+    /**
+     * Clear all pooled objects
+     */
+    clear(): void;
+}
+/**
+ * Pool for THREE.Matrix4 objects used in bone transformations
+ *
+ * Reduces GC pressure from creating new Matrix4 objects during calculations.
+ * Prewarmed with 100 objects (2 characters × 28 bones × 2 temp matrices)
+ *
+ * @korean 행렬4풀
+ */
+declare class Matrix4Pool {
+    private pool;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    /**
+     * Acquire a Matrix4 object from the pool
+     * @returns Pooled or new Matrix4 object (reset to identity)
+     */
+    acquire(): THREE.Matrix4;
+    /**
+     * Return a Matrix4 object to the pool
+     * @param matrix - Matrix4 object to return
+     */
+    release(matrix: THREE.Matrix4): void;
+    /**
+     * Pre-populate pool with objects
+     * @param count - Number of objects to create
+     */
+    prewarm(count: number): void;
+    /**
+     * Get current pool size
+     */
+    get size(): number;
+    /**
+     * Clear all pooled objects
+     */
+    clear(): void;
+}
+/**
+ * Pool for THREE.Quaternion objects used in rotations
+ *
+ * Reduces GC pressure from quaternion operations.
+ * Prewarmed with 100 objects (2 characters × 28 bones × 2 temp quaternions)
+ *
+ * @korean 쿼터니언풀
+ */
+declare class QuaternionPool {
+    private pool;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    /**
+     * Acquire a Quaternion object from the pool
+     * @returns Pooled or new Quaternion object (reset to identity)
+     */
+    acquire(): THREE.Quaternion;
+    /**
+     * Return a Quaternion object to the pool
+     * @param quat - Quaternion object to return
+     */
+    release(quat: THREE.Quaternion): void;
+    /**
+     * Pre-populate pool with objects
+     * @param count - Number of objects to create
+     */
+    prewarm(count: number): void;
+    /**
+     * Get current pool size
+     */
+    get size(): number;
+    /**
+     * Clear all pooled objects
+     */
+    clear(): void;
+}
+/**
+ * Pool for THREE.Color objects used in material and particle effects
+ *
+ * Reduces GC pressure from creating new Color objects for visual effects,
+ * particle systems, and dynamic material updates.
+ * Prewarmed with 50 objects for typical combat scenarios.
+ *
+ * @korean 색상풀
+ */
+declare class ColorPool {
+    private pool;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    /**
+     * Acquire a Color object from the pool
+     * @returns Pooled or new Color object (reset to white)
+     */
+    acquire(): THREE.Color;
+    /**
+     * Return a Color object to the pool
+     * @param color - Color object to return
+     */
+    release(color: THREE.Color): void;
+    /**
+     * Pre-populate pool with objects
+     * @param count - Number of objects to create
+     */
+    prewarm(count: number): void;
+    /**
+     * Get current pool size
+     */
+    get size(): number;
+    /**
+     * Clear all pooled objects
+     */
+    clear(): void;
+}
+/**
+ * Global Three.js object pools
+ *
+ * Singleton pools for animation system to reduce GC pressure.
+ * Prewarmed during app initialization for optimal performance.
+ *
+ * @example
+ * ```typescript
+ * // Acquire temporary Euler for calculation
+ * const tempEuler = ThreeObjectPools.euler.acquire();
+ * tempEuler.set(x, y, z);
+ * // ... use tempEuler ...
+ * ThreeObjectPools.euler.release(tempEuler);
+ *
+ * // Acquire temporary Color for particle effect
+ * const tempColor = ThreeObjectPools.color.acquire();
+ * tempColor.set(0xff0000);
+ * // ... use tempColor ...
+ * ThreeObjectPools.color.release(tempColor);
+ *
+ * // Prewarm pools on app start
+ * ThreeObjectPools.prewarmAll();
+ * ```
+ *
+ * @korean Three.js객체풀들
+ */
+export declare const ThreeObjectPools: {
+    /** Euler rotation pool */
+    readonly euler: EulerPool;
+    /** Vector3 position pool */
+    readonly vector3: Vector3Pool;
+    /** Matrix4 transformation pool */
+    readonly matrix4: Matrix4Pool;
+    /** Quaternion rotation pool */
+    readonly quaternion: QuaternionPool;
+    /** Color pool for materials and effects */
+    readonly color: ColorPool;
+    /**
+     * Pre-populate all pools with recommended sizes
+     *
+     * Call this during app initialization for optimal performance.
+     * Recommended sizes based on 2 characters with 28 bones each plus effects:
+     * - Euler: 200 objects (rotations)
+     * - Vector3: 200 objects (positions, velocities)
+     * - Matrix4: 100 objects (transformations)
+     * - Quaternion: 100 objects (rotations)
+     * - Color: 50 objects (particle effects, materials)
+     */
+    readonly prewarmAll: () => void;
+    /**
+     * Get current status of all pools
+     * @returns Pool status for monitoring
+     */
+    readonly getStatus: () => {
+        euler: number;
+        vector3: number;
+        matrix4: number;
+        quaternion: number;
+        color: number;
+    };
+    /**
+     * Clear all pools (useful for testing)
+     */
+    readonly clearAll: () => void;
+};
+/**
+ * Helper to execute a function with temporary Euler objects
+ * Automatically acquires and releases Euler objects.
+ *
+ * @param count - Number of Euler objects needed
+ * @param fn - Function that uses the Euler objects
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * const result = withTempEulers(2, ([euler1, euler2]) => {
+ *   euler1.set(x1, y1, z1);
+ *   euler2.set(x2, y2, z2);
+ *   return calculateSomething(euler1, euler2);
+ * });
+ * ```
+ *
+ * @korean 임시오일러사용
+ */
+export declare function withTempEulers<T>(count: number, fn: (eulers: THREE.Euler[]) => T): T;
+/**
+ * Helper to execute a function with temporary Vector3 objects
+ * Automatically acquires and releases Vector3 objects.
+ *
+ * @param count - Number of Vector3 objects needed
+ * @param fn - Function that uses the Vector3 objects
+ * @returns Result of the function
+ *
+ * @korean 임시벡터3사용
+ */
+export declare function withTempVectors<T>(count: number, fn: (vectors: THREE.Vector3[]) => T): T;
+/**
+ * Helper to execute a function with temporary Matrix4 objects
+ * Automatically acquires and releases Matrix4 objects.
+ *
+ * @param count - Number of Matrix4 objects needed
+ * @param fn - Function that uses the Matrix4 objects
+ * @returns Result of the function
+ *
+ * @korean 임시행렬4사용
+ */
+export declare function withTempMatrices<T>(count: number, fn: (matrices: THREE.Matrix4[]) => T): T;
+/**
+ * Helper to execute a function with temporary Color objects
+ * Automatically acquires and releases Color objects.
+ *
+ * @param count - Number of Color objects needed
+ * @param fn - Function that uses the Color objects
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * const avgColor = withTempColors(2, ([color1, color2]) => {
+ *   color1.set(0xff0000);
+ *   color2.set(0x0000ff);
+ *   return color1.lerp(color2, 0.5);
+ * });
+ * ```
+ *
+ * @korean 임시색상사용
+ */
+export declare function withTempColors<T>(count: number, fn: (colors: THREE.Color[]) => T): T;
+export {};
+//# sourceMappingURL=threeObjectPool.d.ts.map

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

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