@hua-labs/i18n-core 1.0.0

package/dist/components/MissingKeyOverlay.js

@@ -0,0 +1,138 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+/**
+ * 개발 모드에서 누락된 번역 키를 화면에 표시하는 오버레이
+ * Lingui 스타일의 디버그 모드
+ */
+export const MissingKeyOverlay = ({ enabled = process.env.NODE_ENV === 'development', position = 'top-right', style }) => {
+    const [missingKeys, setMissingKeys] = useState([]);
+    const [isVisible, setIsVisible] = useState(false);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        // 누락된 키 이벤트 리스너
+        const handleMissingKey = (event) => {
+            setMissingKeys(prev => [...prev, event.detail]);
+            setIsVisible(true);
+        };
+        // 전역 이벤트 리스너 등록
+        window.addEventListener('i18n:missing-key', handleMissingKey);
+        return () => {
+            window.removeEventListener('i18n:missing-key', handleMissingKey);
+        };
+    }, [enabled]);
+    if (!enabled || !isVisible)
+        return null;
+    const positionStyles = {
+        'top-right': { top: 20, right: 20 },
+        'top-left': { top: 20, left: 20 },
+        'bottom-right': { bottom: 20, right: 20 },
+        'bottom-left': { bottom: 20, left: 20 }
+    };
+    const overlayStyle = {
+        position: 'fixed',
+        zIndex: 9999,
+        backgroundColor: 'rgba(255, 0, 0, 0.9)',
+        color: 'white',
+        padding: '12px 16px',
+        borderRadius: '8px',
+        fontFamily: 'monospace',
+        fontSize: '12px',
+        maxWidth: '400px',
+        maxHeight: '300px',
+        overflow: 'auto',
+        boxShadow: '0 4px 12px rgba(0, 0, 0, 0.3)',
+        border: '2px solid #ff4444',
+        ...positionStyles[position],
+        ...style
+    };
+    const keyStyle = {
+        marginBottom: '8px',
+        padding: '4px 8px',
+        backgroundColor: 'rgba(255, 255, 255, 0.1)',
+        borderRadius: '4px',
+        borderLeft: '3px solid #ff8888'
+    };
+    const headerStyle = {
+        display: 'flex',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+        marginBottom: '12px',
+        paddingBottom: '8px',
+        borderBottom: '1px solid rgba(255, 255, 255, 0.3)'
+    };
+    const closeButtonStyle = {
+        background: 'none',
+        border: 'none',
+        color: 'white',
+        cursor: 'pointer',
+        fontSize: '16px',
+        padding: '0',
+        width: '20px',
+        height: '20px',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center'
+    };
+    const clearButtonStyle = {
+        background: 'rgba(255, 255, 255, 0.2)',
+        border: 'none',
+        color: 'white',
+        cursor: 'pointer',
+        padding: '4px 8px',
+        borderRadius: '4px',
+        fontSize: '10px',
+        marginLeft: '8px'
+    };
+    const handleClose = () => {
+        setIsVisible(false);
+    };
+    const handleClear = () => {
+        setMissingKeys([]);
+    };
+    const formatTime = (timestamp) => {
+        return new Date(timestamp).toLocaleTimeString();
+    };
+    return (_jsxs("div", { style: overlayStyle, children: [_jsxs("div", { style: headerStyle, children: [_jsxs("div", { children: [_jsx("strong", { children: "\uD83D\uDEA8 Missing Translation Keys" }), _jsxs("span", { style: { fontSize: '10px', marginLeft: '8px' }, children: ["(", missingKeys.length, ")"] })] }), _jsxs("div", { children: [_jsx("button", { style: clearButtonStyle, onClick: handleClear, children: "Clear" }), _jsx("button", { style: closeButtonStyle, onClick: handleClose, children: "\u00D7" })] })] }), _jsxs("div", { children: [missingKeys.slice(-10).reverse().map((key, index) => (_jsxs("div", { style: keyStyle, children: [_jsx("div", { style: { fontWeight: 'bold', color: '#ffcccc' }, children: key.key }), _jsxs("div", { style: { fontSize: '10px', marginTop: '2px' }, children: [_jsxs("span", { children: ["Lang: ", key.language] }), key.namespace && _jsxs("span", { style: { marginLeft: '8px' }, children: ["NS: ", key.namespace] }), _jsxs("span", { style: { marginLeft: '8px' }, children: ["Time: ", formatTime(key.timestamp)] })] }), key.component && (_jsxs("div", { style: { fontSize: '10px', color: '#ffaaaa', marginTop: '2px' }, children: ["Component: ", key.component] }))] }, `${key.key}-${key.timestamp}`))), missingKeys.length > 10 && (_jsxs("div", { style: { fontSize: '10px', textAlign: 'center', marginTop: '8px' }, children: ["... and ", missingKeys.length - 10, " more"] }))] })] }));
+};
+/**
+ * 누락된 키를 오버레이에 표시하는 유틸리티 함수
+ */
+export const reportMissingKey = (key, options) => {
+    if (process.env.NODE_ENV === 'development') {
+        const missingKey = {
+            key,
+            namespace: options.namespace,
+            language: options.language,
+            timestamp: Date.now(),
+            component: options.component
+        };
+        // 커스텀 이벤트 발생
+        window.dispatchEvent(new CustomEvent('i18n:missing-key', {
+            detail: missingKey
+        }));
+        // 콘솔에도 로그
+        console.warn(`Missing translation key: ${key}`, {
+            namespace: options.namespace,
+            language: options.language,
+            component: options.component
+        });
+    }
+};
+/**
+ * 누락된 키 오버레이를 자동으로 활성화하는 훅
+ */
+export const useMissingKeyOverlay = (enabled = true) => {
+    const [showOverlay, setShowOverlay] = useState(enabled);
+    useEffect(() => {
+        if (enabled && process.env.NODE_ENV === 'development') {
+            setShowOverlay(true);
+        }
+    }, [enabled]);
+    return {
+        showOverlay,
+        setShowOverlay,
+        reportMissingKey
+    };
+};
+//# sourceMappingURL=MissingKeyOverlay.js.map

package/dist/components/MissingKeyOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MissingKeyOverlay.js","sourceRoot":"","sources":["../../src/components/MissingKeyOverlay.tsx"],"names":[],"mappings":"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"}

package/dist/core/debug-tools.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 조건부 디버깅 도구 - 개발 환경에서만 로드
+ * 번들 크기 최적화를 위해 조건부 로딩
+ */
+export interface DebugTools {
+    highlightMissingKeys: (container: HTMLElement) => void;
+    showTranslationKeys: (container: HTMLElement) => void;
+    performanceMetrics: {
+        translationCount: number;
+        cacheHits: number;
+        cacheMisses: number;
+        loadTimes: number[];
+    };
+    devTools: {
+        open: () => void;
+        close: () => void;
+        isOpen: boolean;
+    };
+    validateTranslations: (translations: Record<string, unknown>) => {
+        missingKeys: string[];
+        duplicateKeys: string[];
+        invalidKeys: string[];
+    };
+}
+/**
+ * 디버깅 도구 팩토리 - 조건부 로딩
+ */
+export declare function createDebugTools(): DebugTools | null;
+/**
+ * 디버깅 도구 활성화 (전역 함수)
+ */
+export declare function enableDebugTools(): void;
+/**
+ * 디버깅 도구 비활성화
+ */
+export declare function disableDebugTools(): void;
+//# sourceMappingURL=debug-tools.d.ts.map

package/dist/core/debug-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-tools.d.ts","sourceRoot":"","sources":["../../src/core/debug-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IAEzB,oBAAoB,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,IAAI,CAAC;IACvD,mBAAmB,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,IAAI,CAAC;IAGtD,kBAAkB,EAAE;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IAGF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,IAAI,CAAC;QACjB,KAAK,EAAE,MAAM,IAAI,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IAGF,oBAAoB,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK;QAC/D,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,GAAG,IAAI,CAiIpD;AAsGD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAgBvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}

package/dist/core/debug-tools.js

@@ -0,0 +1,241 @@
+/**
+ * 조건부 디버깅 도구 - 개발 환경에서만 로드
+ * 번들 크기 최적화를 위해 조건부 로딩
+ */
+/**
+ * 디버깅 도구 팩토리 - 조건부 로딩
+ */
+export function createDebugTools() {
+    // 프로덕션에서는 디버깅 도구 비활성화
+    if (process.env.NODE_ENV === 'production') {
+        return null;
+    }
+    // 개발 환경에서만 로드
+    return {
+        highlightMissingKeys: (container) => {
+            const elements = container.querySelectorAll('[data-i18n-key]');
+            elements.forEach((element) => {
+                const key = element.getAttribute('data-i18n-key');
+                const text = element.textContent;
+                // 번역 키가 텍스트와 다른 경우 하이라이트
+                if (key && text === key) {
+                    element.style.backgroundColor = '#ffeb3b';
+                    element.style.border = '2px solid #f57c00';
+                    element.title = `Missing translation: ${key}`;
+                }
+            });
+        },
+        showTranslationKeys: (container) => {
+            const elements = container.querySelectorAll('[data-i18n-key]');
+            elements.forEach((element) => {
+                const key = element.getAttribute('data-i18n-key');
+                if (key) {
+                    const tooltip = document.createElement('div');
+                    tooltip.style.cssText = `
+            position: absolute;
+            background: #333;
+            color: white;
+            padding: 4px 8px;
+            border-radius: 4px;
+            font-size: 12px;
+            z-index: 10000;
+            pointer-events: none;
+            opacity: 0;
+            transition: opacity 0.2s;
+          `;
+                    tooltip.textContent = `Key: ${key}`;
+                    element.addEventListener('mouseenter', () => {
+                        const rect = element.getBoundingClientRect();
+                        tooltip.style.left = `${rect.left}px`;
+                        tooltip.style.top = `${rect.bottom + 5}px`;
+                        tooltip.style.opacity = '1';
+                        document.body.appendChild(tooltip);
+                    });
+                    element.addEventListener('mouseleave', () => {
+                        tooltip.style.opacity = '0';
+                        setTimeout(() => {
+                            if (tooltip.parentNode) {
+                                tooltip.parentNode.removeChild(tooltip);
+                            }
+                        }, 200);
+                    });
+                }
+            });
+        },
+        performanceMetrics: {
+            translationCount: 0,
+            cacheHits: 0,
+            cacheMisses: 0,
+            loadTimes: [],
+        },
+        devTools: {
+            isOpen: false,
+            open: () => {
+                const devTools = createDevToolsPanel();
+                document.body.appendChild(devTools);
+                devTools.isOpen = true;
+            },
+            close: () => {
+                const existingPanel = document.getElementById('hua-i18n-devtools');
+                if (existingPanel) {
+                    existingPanel.remove();
+                }
+                // devTools 변수는 이 스코프에서 접근할 수 없으므로 전역에서 관리
+                const globalDebugTools = window.__HUA_I18N_DEBUG__;
+                if (globalDebugTools) {
+                    globalDebugTools.devTools.isOpen = false;
+                }
+            },
+        },
+        validateTranslations: (translations) => {
+            const missingKeys = [];
+            const duplicateKeys = [];
+            const invalidKeys = [];
+            const seenKeys = new Set();
+            const traverse = (obj, path = '') => {
+                if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
+                    return;
+                }
+                for (const [key, value] of Object.entries(obj)) {
+                    const currentPath = path ? `${path}.${key}` : key;
+                    // 키 유효성 검사
+                    if (typeof key !== 'string' || key.trim() === '') {
+                        invalidKeys.push(currentPath);
+                    }
+                    // 중복 키 검사
+                    if (seenKeys.has(currentPath)) {
+                        duplicateKeys.push(currentPath);
+                    }
+                    else {
+                        seenKeys.add(currentPath);
+                    }
+                    // 값 검사
+                    if (value === null || value === undefined) {
+                        missingKeys.push(currentPath);
+                    }
+                    else if (typeof value === 'object' && !Array.isArray(value)) {
+                        traverse(value, currentPath);
+                    }
+                }
+            };
+            traverse(translations);
+            return { missingKeys, duplicateKeys, invalidKeys };
+        },
+    };
+}
+/**
+ * 개발자 도구 패널 생성
+ */
+function createDevToolsPanel() {
+    const panel = document.createElement('div');
+    panel.id = 'hua-i18n-devtools';
+    panel.style.cssText = `
+    position: fixed;
+    top: 20px;
+    right: 20px;
+    width: 300px;
+    max-height: 500px;
+    background: #1e1e1e;
+    color: #fff;
+    border-radius: 8px;
+    box-shadow: 0 4px 20px rgba(0,0,0,0.3);
+    z-index: 10000;
+    font-family: 'Monaco', 'Menlo', monospace;
+    font-size: 12px;
+    overflow: hidden;
+  `;
+    const header = document.createElement('div');
+    header.style.cssText = `
+    background: #2d2d2d;
+    padding: 12px;
+    border-bottom: 1px solid #444;
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+  `;
+    header.innerHTML = `
+    <span style="font-weight: bold;">HUA i18n Debug</span>
+    <button id="close-devtools" style="background: none; border: none; color: #fff; cursor: pointer; font-size: 16px;">×</button>
+  `;
+    const content = document.createElement('div');
+    content.style.cssText = `
+    padding: 12px;
+    max-height: 400px;
+    overflow-y: auto;
+  `;
+    // 성능 메트릭
+    const metricsSection = document.createElement('div');
+    metricsSection.innerHTML = `
+    <h4 style="margin: 0 0 8px 0; color: #4fc3f7;">Performance</h4>
+    <div>Translations: <span id="translation-count">0</span></div>
+    <div>Cache Hits: <span id="cache-hits">0</span></div>
+    <div>Cache Misses: <span id="cache-misses">0</span></div>
+    <div>Hit Rate: <span id="hit-rate">0%</span></div>
+  `;
+    // 현재 언어 정보
+    const languageSection = document.createElement('div');
+    languageSection.style.marginTop = '16px';
+    languageSection.innerHTML = `
+    <h4 style="margin: 0 0 8px 0; color: #4fc3f7;">Current Language</h4>
+    <div>Language: <span id="current-language">ko</span></div>
+    <div>Fallback: <span id="fallback-language">en</span></div>
+  `;
+    // 액션 버튼들
+    const actionsSection = document.createElement('div');
+    actionsSection.style.marginTop = '16px';
+    actionsSection.innerHTML = `
+    <h4 style="margin: 0 0 8px 0; color: #4fc3f7;">Actions</h4>
+    <button id="highlight-missing" style="background: #4fc3f7; border: none; color: #000; padding: 4px 8px; border-radius: 4px; cursor: pointer; margin-right: 8px;">Highlight Missing</button>
+    <button id="show-keys" style="background: #4fc3f7; border: none; color: #000; padding: 4px 8px; border-radius: 4px; cursor: pointer;">Show Keys</button>
+  `;
+    content.appendChild(metricsSection);
+    content.appendChild(languageSection);
+    content.appendChild(actionsSection);
+    panel.appendChild(header);
+    panel.appendChild(content);
+    // 이벤트 리스너
+    panel.querySelector('#close-devtools')?.addEventListener('click', () => {
+        panel.remove();
+    });
+    panel.querySelector('#highlight-missing')?.addEventListener('click', () => {
+        const debugTools = createDebugTools();
+        if (debugTools) {
+            debugTools.highlightMissingKeys(document.body);
+        }
+    });
+    panel.querySelector('#show-keys')?.addEventListener('click', () => {
+        const debugTools = createDebugTools();
+        if (debugTools) {
+            debugTools.showTranslationKeys(document.body);
+        }
+    });
+    return panel;
+}
+/**
+ * 디버깅 도구 활성화 (전역 함수)
+ */
+export function enableDebugTools() {
+    if (process.env.NODE_ENV === 'production') {
+        console.warn('Debug tools are not available in production');
+        return;
+    }
+    const debugTools = createDebugTools();
+    if (!debugTools)
+        return;
+    // 전역 객체에 추가
+    window.__HUA_I18N_DEBUG__ = debugTools;
+    // 개발자 도구 열기
+    debugTools.devTools.open();
+    console.log('HUA i18n debug tools enabled. Use window.__HUA_I18N_DEBUG__ to access.');
+}
+/**
+ * 디버깅 도구 비활성화
+ */
+export function disableDebugTools() {
+    const debugTools = window.__HUA_I18N_DEBUG__;
+    if (debugTools) {
+        debugTools.devTools.close();
+        delete window.__HUA_I18N_DEBUG__;
+    }
+}
+//# sourceMappingURL=debug-tools.js.map

package/dist/core/debug-tools.js.map

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

package/dist/core/i18n-resource.d.ts

@@ -0,0 +1,59 @@
+import { TranslationNamespace } from '../types';
+/**
+ * i18n 리소스 관리자
+ * SSR 환경에서 동일 번역 요청 중복 방지 및 전역 캐시 관리
+ */
+export declare class I18nResourceManager {
+    private static instance;
+    private globalCache;
+    private loadingPromises;
+    private cacheStats;
+    private constructor();
+    static getInstance(): I18nResourceManager;
+    /**
+     * 전역 캐시에서 번역 데이터 가져오기
+     */
+    getCachedTranslations(language: string, namespace: string, loader: (lang: string, ns: string) => Promise<TranslationNamespace>): Promise<TranslationNamespace>;
+    /**
+     * 캐시된 번역 데이터 직접 접근
+     */
+    getCachedTranslationsSync(language: string, namespace: string): TranslationNamespace | null;
+    /**
+     * 특정 언어의 모든 네임스페이스 가져오기
+     */
+    getAllTranslationsForLanguage(language: string): Record<string, TranslationNamespace>;
+    /**
+     * 모든 캐시된 번역 데이터 가져오기
+     */
+    getAllCachedTranslations(): Record<string, Record<string, TranslationNamespace>>;
+    /**
+     * 캐시 통계 가져오기
+     */
+    getCacheStats(): {
+        hitRate: number;
+        hits: number;
+        misses: number;
+        size: number;
+    };
+    /**
+     * 캐시 무효화
+     */
+    invalidateCache(language?: string, namespace?: string): void;
+    /**
+     * 캐시 크기 제한 설정
+     */
+    setCacheLimit(maxSize: number): void;
+    /**
+     * SSR 환경에서 하이드레이션
+     */
+    hydrateFromSSR(translations: Record<string, Record<string, TranslationNamespace>>): void;
+    /**
+     * 메모리 사용량 최적화
+     */
+    optimizeMemory(): void;
+}
+/**
+ * 전역 리소스 매니저 인스턴스
+ */
+export declare const i18nResourceManager: I18nResourceManager;
+//# sourceMappingURL=i18n-resource.d.ts.map

package/dist/core/i18n-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-resource.d.ts","sourceRoot":"","sources":["../../src/core/i18n-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmB,MAAM,UAAU,CAAC;AAEjE;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,WAAW,CAA2C;IAC9D,OAAO,CAAC,eAAe,CAAoD;IAC3E,OAAO,CAAC,UAAU,CAIhB;IAEF,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC;;OAEG;IACG,qBAAqB,CACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAClE,OAAO,CAAC,oBAAoB,CAAC;IA2BhC;;OAEG;IACH,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAK3F;;OAEG;IACH,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAarF;;OAEG;IACH,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAchF;;OAEG;IACH,aAAa;;;;;;IAOb;;OAEG;IACH,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAuB5D;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAcpC;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,GAAG,IAAI;IAWxF;;OAEG;IACH,cAAc,IAAI,IAAI;CAIvB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,qBAAoC,CAAC"}

package/dist/core/i18n-resource.js

@@ -0,0 +1,153 @@
+/**
+ * i18n 리소스 관리자
+ * SSR 환경에서 동일 번역 요청 중복 방지 및 전역 캐시 관리
+ */
+export class I18nResourceManager {
+    constructor() {
+        this.globalCache = new Map();
+        this.loadingPromises = new Map();
+        this.cacheStats = {
+            hits: 0,
+            misses: 0,
+            size: 0
+        };
+    }
+    static getInstance() {
+        if (!I18nResourceManager.instance) {
+            I18nResourceManager.instance = new I18nResourceManager();
+        }
+        return I18nResourceManager.instance;
+    }
+    /**
+     * 전역 캐시에서 번역 데이터 가져오기
+     */
+    async getCachedTranslations(language, namespace, loader) {
+        const cacheKey = `${language}:${namespace}`;
+        // 캐시에 있으면 반환
+        if (this.globalCache.has(cacheKey)) {
+            this.cacheStats.hits++;
+            return this.globalCache.get(cacheKey);
+        }
+        // 이미 로딩 중이면 기존 Promise 반환
+        if (this.loadingPromises.has(cacheKey)) {
+            return this.loadingPromises.get(cacheKey);
+        }
+        // 새로 로딩
+        this.cacheStats.misses++;
+        const loadPromise = loader(language, namespace).then(data => {
+            this.globalCache.set(cacheKey, data);
+            this.cacheStats.size = this.globalCache.size;
+            this.loadingPromises.delete(cacheKey);
+            return data;
+        });
+        this.loadingPromises.set(cacheKey, loadPromise);
+        return loadPromise;
+    }
+    /**
+     * 캐시된 번역 데이터 직접 접근
+     */
+    getCachedTranslationsSync(language, namespace) {
+        const cacheKey = `${language}:${namespace}`;
+        return this.globalCache.get(cacheKey) || null;
+    }
+    /**
+     * 특정 언어의 모든 네임스페이스 가져오기
+     */
+    getAllTranslationsForLanguage(language) {
+        const result = {};
+        for (const [key, data] of this.globalCache.entries()) {
+            if (key.startsWith(`${language}:`)) {
+                const namespace = key.split(':')[1];
+                result[namespace] = data;
+            }
+        }
+        return result;
+    }
+    /**
+     * 모든 캐시된 번역 데이터 가져오기
+     */
+    getAllCachedTranslations() {
+        const result = {};
+        for (const [key, data] of this.globalCache.entries()) {
+            const [language, namespace] = key.split(':');
+            if (!result[language]) {
+                result[language] = {};
+            }
+            result[language][namespace] = data;
+        }
+        return result;
+    }
+    /**
+     * 캐시 통계 가져오기
+     */
+    getCacheStats() {
+        return {
+            ...this.cacheStats,
+            hitRate: this.cacheStats.hits / (this.cacheStats.hits + this.cacheStats.misses)
+        };
+    }
+    /**
+     * 캐시 무효화
+     */
+    invalidateCache(language, namespace) {
+        if (language && namespace) {
+            // 특정 언어/네임스페이스만 무효화
+            const cacheKey = `${language}:${namespace}`;
+            this.globalCache.delete(cacheKey);
+            this.loadingPromises.delete(cacheKey);
+        }
+        else if (language) {
+            // 특정 언어의 모든 네임스페이스 무효화
+            for (const key of this.globalCache.keys()) {
+                if (key.startsWith(`${language}:`)) {
+                    this.globalCache.delete(key);
+                    this.loadingPromises.delete(key);
+                }
+            }
+        }
+        else {
+            // 전체 캐시 무효화
+            this.globalCache.clear();
+            this.loadingPromises.clear();
+        }
+        this.cacheStats.size = this.globalCache.size;
+    }
+    /**
+     * 캐시 크기 제한 설정
+     */
+    setCacheLimit(maxSize) {
+        if (this.globalCache.size > maxSize) {
+            // LRU 방식으로 오래된 항목 제거
+            const entries = Array.from(this.globalCache.entries());
+            const toRemove = entries.slice(0, this.globalCache.size - maxSize);
+            for (const [key] of toRemove) {
+                this.globalCache.delete(key);
+            }
+            this.cacheStats.size = this.globalCache.size;
+        }
+    }
+    /**
+     * SSR 환경에서 하이드레이션
+     */
+    hydrateFromSSR(translations) {
+        for (const [language, namespaces] of Object.entries(translations)) {
+            for (const [namespace, data] of Object.entries(namespaces)) {
+                const cacheKey = `${language}:${namespace}`;
+                this.globalCache.set(cacheKey, data);
+            }
+        }
+        this.cacheStats.size = this.globalCache.size;
+    }
+    /**
+     * 메모리 사용량 최적화
+     */
+    optimizeMemory() {
+        // 사용되지 않는 번역 데이터 정리
+        // 실제 구현에서는 사용 통계를 기반으로 정리
+    }
+}
+/**
+ * 전역 리소스 매니저 인스턴스
+ */
+export const i18nResourceManager = I18nResourceManager.getInstance();
+//# sourceMappingURL=i18n-resource.js.map

package/dist/core/i18n-resource.js.map

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