@lionrapid/core 0.1.0

package/dist/utils/logger.js

@@ -0,0 +1,345 @@
+import { LogLevel } from '../config/logger.config.js';
+// Build-time constants for dead code elimination
+const IS_PRODUCTION = process.env.NODE_ENV === 'production';
+const IS_DEVELOPMENT = process.env.NODE_ENV === 'development';
+const IS_CI = process.env.CI === 'true';
+const LIONRAPID_DEV = process.env.LIONRAPID_DEV === 'true';
+const PERFORMANCE_TRACKING = process.env.LIONRAPID_PERFORMANCE_TRACKING === 'true';
+// Environment-specific configuration
+const LOG_LEVEL_ENV = process.env.LOG_LEVEL || (IS_PRODUCTION ? 'ERROR' : 'DEBUG');
+/**
+ * ANSI color codes for terminal output
+ */
+export const Colors = {
+    // Reset
+    RESET: '\x1b[0m',
+    // Foreground colors
+    BLACK: '\x1b[30m',
+    RED: '\x1b[31m',
+    GREEN: '\x1b[32m',
+    YELLOW: '\x1b[33m',
+    BLUE: '\x1b[34m',
+    MAGENTA: '\x1b[35m',
+    CYAN: '\x1b[36m',
+    WHITE: '\x1b[37m',
+    ORANGE: '\x1b[38;5;208m',
+    // Bright foreground colors
+    BRIGHT_BLACK: '\x1b[90m',
+    BRIGHT_RED: '\x1b[91m',
+    BRIGHT_GREEN: '\x1b[92m',
+    BRIGHT_YELLOW: '\x1b[93m',
+    BRIGHT_BLUE: '\x1b[94m',
+    BRIGHT_MAGENTA: '\x1b[95m',
+    BRIGHT_CYAN: '\x1b[96m',
+    BRIGHT_WHITE: '\x1b[97m',
+    // Styles
+    BOLD: '\x1b[1m',
+    DIM: '\x1b[2m',
+    UNDERLINE: '\x1b[4m',
+};
+// Development logger class - completely eliminated in production
+class DevelopmentLogger {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            level: this.getLogLevelFromEnv(),
+            enabled: this.shouldEnableLogging(),
+            prefix: `${config.packageEmoji || '📦'} ${config.packageName || 'LionRapid'}`,
+            showLineNumbers: LIONRAPID_DEV && !IS_CI,
+            useColors: this.shouldUseColors(),
+            ...config,
+        };
+    }
+    configure(config) {
+        this.config = { ...this.config, ...config };
+    }
+    debug(message, data) {
+        if (!this.config.enabled || this.config.level > LogLevel.DEBUG)
+            return;
+        this.log(LogLevel.DEBUG, message, data);
+    }
+    info(message, data) {
+        if (this.config.level > LogLevel.INFO)
+            return;
+        this.log(LogLevel.INFO, message, data);
+    }
+    warn(message, data) {
+        this.log(LogLevel.WARN, message, data);
+    }
+    error(message, data) {
+        this.log(LogLevel.ERROR, message, data);
+    }
+    time(label) {
+        if (!PERFORMANCE_TRACKING || IS_PRODUCTION)
+            return () => { };
+        const start = IS_DEVELOPMENT ? performance.now() : 0;
+        return () => {
+            if (IS_DEVELOPMENT) {
+                const duration = performance.now() - start;
+                this.debug(`⏱️ ${label}: ${duration.toFixed(2)}ms`, { duration });
+            }
+        };
+    }
+    log(level, message, data) {
+        if (!this.config.enabled || level < this.config.level)
+            return;
+        const levelName = LogLevel[level];
+        const levelEmoji = this.getLevelEmoji(level);
+        const callSite = this.config.showLineNumbers ? this.getCallSite() : null;
+        const logMessage = this.buildColoredMessage(level, levelEmoji, levelName, message, callSite, data);
+        switch (level) {
+            case LogLevel.ERROR:
+                console.error(logMessage);
+                break;
+            case LogLevel.WARN:
+                console.warn(logMessage);
+                break;
+            case LogLevel.INFO:
+                console.info(logMessage);
+                break;
+            default:
+                console.log(logMessage);
+        }
+    }
+    buildColoredMessage(level, emoji, levelName, message, callSite, data) {
+        if (!this.config.useColors) {
+            const locationInfo = callSite
+                ? ` (${callSite.fileName}:${callSite.lineNumber})`
+                : '';
+            let logMessage = `${this.config.prefix} ${emoji} ${levelName} ${message}${locationInfo}`;
+            if (data !== undefined) {
+                logMessage += ` ${JSON.stringify(data)}`;
+            }
+            return logMessage;
+        }
+        const levelColor = this.getLevelColor(level);
+        const reset = Colors.RESET;
+        const coloredPrefix = `${Colors.BOLD}${Colors.ORANGE}${this.config.prefix}${reset}`;
+        const coloredEmoji = emoji;
+        const coloredLevel = `${levelColor}${Colors.BOLD}${levelName}${reset}`;
+        const coloredMessage = `${levelColor}${message}${reset}`;
+        const locationInfo = callSite
+            ? `${Colors.DIM}${Colors.BRIGHT_BLACK} (${callSite.fileName}:${callSite.lineNumber})${reset}`
+            : '';
+        const dataInfo = data !== undefined
+            ? `${Colors.DIM}${Colors.CYAN} ${JSON.stringify(data)}${reset}`
+            : '';
+        return `${coloredPrefix} ${coloredEmoji} ${coloredLevel} ${coloredMessage}${locationInfo}${dataInfo}`;
+    }
+    getLevelColor(level) {
+        switch (level) {
+            case LogLevel.DEBUG:
+                return Colors.BRIGHT_GREEN;
+            case LogLevel.INFO:
+                return Colors.BRIGHT_CYAN;
+            case LogLevel.WARN:
+                return Colors.BRIGHT_YELLOW;
+            case LogLevel.ERROR:
+                return Colors.BRIGHT_RED;
+            default:
+                return Colors.BRIGHT_BLACK;
+        }
+    }
+    getLevelEmoji(level) {
+        switch (level) {
+            case LogLevel.DEBUG:
+                return '🔍';
+            case LogLevel.INFO:
+                return 'ℹ️';
+            case LogLevel.WARN:
+                return '⚠️';
+            case LogLevel.ERROR:
+                return '❌';
+            default:
+                return '📝';
+        }
+    }
+    getCallSite() {
+        try {
+            const stack = new Error().stack;
+            if (!stack)
+                return null;
+            const lines = stack.split('\n');
+            for (let i = 3; i < lines.length; i++) {
+                const line = lines[i];
+                if (line && !line.includes('logger.ts') && !line.includes('Logger')) {
+                    return this.parseStackLine(line);
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return null;
+    }
+    parseStackLine(line) {
+        let match = line.match(/at\s+(.+?)\s+\((.+):(\d+):(\d+)\)/);
+        if (match) {
+            return {
+                functionName: match[1],
+                fileName: this.extractFileName(match[2]),
+                lineNumber: parseInt(match[3], 10),
+            };
+        }
+        match = line.match(/at\s+(.+):(\d+):(\d+)/);
+        if (match) {
+            return {
+                fileName: this.extractFileName(match[1]),
+                lineNumber: parseInt(match[2], 10),
+            };
+        }
+        return null;
+    }
+    extractFileName(filePath) {
+        const parts = filePath.split('/');
+        return parts[parts.length - 1] || filePath;
+    }
+    colorize(text, color) {
+        if (!this.config.useColors)
+            return text;
+        return `${Colors[color]}${text}${Colors.RESET}`;
+    }
+    getColors() {
+        return Colors;
+    }
+    createPackageLogger(packageName, packageEmoji) {
+        return new DevelopmentLogger({
+            ...this.config,
+            packageName,
+            packageEmoji: packageEmoji || '📦',
+        });
+    }
+    getLogLevelFromEnv() {
+        switch (LOG_LEVEL_ENV.toUpperCase()) {
+            case 'DEBUG':
+                return LogLevel.DEBUG;
+            case 'INFO':
+                return LogLevel.INFO;
+            case 'WARN':
+                return LogLevel.WARN;
+            case 'ERROR':
+                return LogLevel.ERROR;
+            case 'NONE':
+                return LogLevel.NONE;
+            default:
+                return LogLevel.DEBUG;
+        }
+    }
+    shouldEnableLogging() {
+        if (LOG_LEVEL_ENV === 'NONE')
+            return false;
+        return true;
+    }
+    shouldUseColors() {
+        if (IS_CI)
+            return false;
+        // Check if we're in a browser environment
+        if (typeof window !== 'undefined') {
+            return true; // Browsers support console colors
+        }
+        // Node.js environment
+        if (typeof process !== 'undefined' &&
+            process.stdout &&
+            !process.stdout.isTTY) {
+            return false;
+        }
+        return IS_DEVELOPMENT;
+    }
+}
+// Production no-op functions - these create completely eliminatable calls
+const noop = () => { };
+const noopWithReturn = () => () => { };
+// Export logger with build-time method elimination
+export const logger = IS_PRODUCTION
+    ? {
+        configure: noop,
+        debug: noop, // ← This eliminates the call completely
+        info: noop, // ← This eliminates the call completely
+        warn: (message, data) => {
+            console.warn(`🦁 LionRapid Core ⚠️ ${message}`, data || '');
+        },
+        error: (message, data) => {
+            console.error(`🦁 LionRapid Core ❌ ${message}`, data || '');
+        },
+        time: noopWithReturn,
+        colorize: (text) => text,
+        getColors: () => Colors,
+        createPackageLogger: (packageName, packageEmoji) => ({
+            configure: noop,
+            debug: noop, // ← Package logger debug also eliminated
+            info: noop, // ← Package logger info also eliminated
+            warn: (message, data) => {
+                const prefix = `${packageEmoji || '📦'} ${packageName}`;
+                console.warn(`${prefix} ⚠️ ${message}`, data || '');
+            },
+            error: (message, data) => {
+                const prefix = `${packageEmoji || '📦'} ${packageName}`;
+                console.error(`${prefix} ❌ ${message}`, data || '');
+            },
+            time: noopWithReturn,
+            colorize: (text) => text,
+            getColors: () => Colors,
+            createPackageLogger: noop,
+        }),
+    }
+    : new DevelopmentLogger({
+        packageName: 'LionRapid Core',
+        packageEmoji: '🦁',
+    });
+// Export Logger class for type compatibility
+export const Logger = IS_PRODUCTION
+    ? function Logger() {
+        return logger;
+    }
+    : DevelopmentLogger;
+// Factory function with build-time elimination
+export const createPackageLogger = (config) => {
+    if (IS_PRODUCTION) {
+        const prefix = `${config.packageEmoji || '📦'} ${config.packageName || 'LionRapid'}`;
+        return {
+            configure: noop,
+            debug: noop, // ← All debug calls eliminated
+            info: noop, // ← All info calls eliminated
+            warn: (message, data) => {
+                console.warn(`${prefix} ⚠️ ${message}`, data || '');
+            },
+            error: (message, data) => {
+                console.error(`${prefix} ❌ ${message}`, data || '');
+            },
+            time: noopWithReturn,
+            colorize: (text) => text,
+            getColors: () => Colors,
+            createPackageLogger: noop,
+        };
+    }
+    return new DevelopmentLogger(config);
+};
+// Performance measurement helper - eliminated in production
+export const measure = (name) => {
+    if (IS_PRODUCTION) {
+        return {
+            start: noop,
+            end: noop,
+            elapsed: () => 0,
+        };
+    }
+    let startTime;
+    return {
+        start: () => {
+            if (IS_DEVELOPMENT) {
+                startTime = performance.now();
+                logger.debug(`⏱️ ${name} - started`);
+            }
+        },
+        end: () => {
+            if (IS_DEVELOPMENT) {
+                const duration = performance.now() - startTime;
+                logger.debug(`⏱️ ${name} - completed in ${duration.toFixed(2)}ms`);
+                return duration;
+            }
+            return 0;
+        },
+        elapsed: () => (IS_DEVELOPMENT ? performance.now() - startTime : 0),
+    };
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,iDAAiD;AACjD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AAC5D,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;AAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC;AACxC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC;AAC3D,MAAM,oBAAoB,GACxB,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,MAAM,CAAC;AAExD,qCAAqC;AACrC,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ;IACR,KAAK,EAAE,SAAS;IAChB,oBAAoB;IACpB,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,gBAAgB;IACxB,2BAA2B;IAC3B,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,UAAU;IACxB,aAAa,EAAE,UAAU;IACzB,WAAW,EAAE,UAAU;IACvB,cAAc,EAAE,UAAU;IAC1B,WAAW,EAAE,UAAU;IACvB,YAAY,EAAE,UAAU;IACxB,SAAS;IACT,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,SAAS,EAAE,SAAS;CACZ,CAAC;AAaX,iEAAiE;AACjE,MAAM,iBAAiB;IACb,MAAM,CAAyB;IAEvC,YAAY,SAA8B,EAAE;QAC1C,IAAI,CAAC,MAAM,GAAG;YACZ,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE;YAChC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE;YACnC,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,IAAI,MAAM,CAAC,WAAW,IAAI,WAAW,EAAE;YAC7E,eAAe,EAAE,aAAa,IAAI,CAAC,KAAK;YACxC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE;YACjC,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,MAA6B;QACrC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK;YAAE,OAAO;QACvE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI;YAAE,OAAO;QAC9C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,oBAAoB,IAAI,aAAa;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAE5D,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,GAAG,EAAE;YACV,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;gBAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;QAC1D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO;QAE9D,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAEzE,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CACzC,KAAK,EACL,UAAU,EACV,SAAS,EACT,OAAO,EACP,QAAQ,EACR,IAAI,CACL,CAAC;QAEF,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,QAAQ,CAAC,KAAK;gBACjB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC1B,MAAM;YACR,KAAK,QAAQ,CAAC,IAAI;gBAChB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACzB,MAAM;YACR,KAAK,QAAQ,CAAC,IAAI;gBAChB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACzB,MAAM;YACR;gBACE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,mBAAmB,CACzB,KAAe,EACf,KAAa,EACb,SAAiB,EACjB,OAAe,EACf,QAAyB,EACzB,IAAc;QAEd,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,QAAQ;gBAC3B,CAAC,CAAC,KAAK,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,GAAG;gBAClD,CAAC,CAAC,EAAE,CAAC;YACP,IAAI,UAAU,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,IAAI,SAAS,IAAI,OAAO,GAAG,YAAY,EAAE,CAAC;YACzF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,UAAU,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,MAAM,aAAa,GAAG,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACpF,MAAM,YAAY,GAAG,KAAK,CAAC;QAC3B,MAAM,YAAY,GAAG,GAAG,UAAU,GAAG,MAAM,CAAC,IAAI,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QACvE,MAAM,cAAc,GAAG,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,EAAE,CAAC;QAEzD,MAAM,YAAY,GAAG,QAAQ;YAC3B,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,IAAI,KAAK,EAAE;YAC7F,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,QAAQ,GACZ,IAAI,KAAK,SAAS;YAChB,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE;YAC/D,CAAC,CAAC,EAAE,CAAC;QAET,OAAO,GAAG,aAAa,IAAI,YAAY,IAAI,YAAY,IAAI,cAAc,GAAG,YAAY,GAAG,QAAQ,EAAE,CAAC;IACxG,CAAC;IAEO,aAAa,CAAC,KAAe;QACnC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,QAAQ,CAAC,KAAK;gBACjB,OAAO,MAAM,CAAC,YAAY,CAAC;YAC7B,KAAK,QAAQ,CAAC,IAAI;gBAChB,OAAO,MAAM,CAAC,WAAW,CAAC;YAC5B,KAAK,QAAQ,CAAC,IAAI;gBAChB,OAAO,MAAM,CAAC,aAAa,CAAC;YAC9B,KAAK,QAAQ,CAAC,KAAK;gBACjB,OAAO,MAAM,CAAC,UAAU,CAAC;YAC3B;gBACE,OAAO,MAAM,CAAC,YAAY,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,KAAe;QACnC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,QAAQ,CAAC,KAAK;gBACjB,OAAO,IAAI,CAAC;YACd,KAAK,QAAQ,CAAC,IAAI;gBAChB,OAAO,IAAI,CAAC;YACd,KAAK,QAAQ,CAAC,IAAI;gBAChB,OAAO,IAAI,CAAC;YACd,KAAK,QAAQ,CAAC,KAAK;gBACjB,OAAO,GAAG,CAAC;YACb;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC;YAChC,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YAExB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACpE,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC5D,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;gBACtB,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACxC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;aACnC,CAAC;QACJ,CAAC;QAED,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC5C,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACxC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;aACnC,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,eAAe,CAAC,QAAgB;QACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,KAA0B;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC;IAED,SAAS;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mBAAmB,CACjB,WAAmB,EACnB,YAAqB;QAErB,OAAO,IAAI,iBAAiB,CAAC;YAC3B,GAAG,IAAI,CAAC,MAAM;YACd,WAAW;YACX,YAAY,EAAE,YAAY,IAAI,IAAI;SACnC,CAAC,CAAC;IACL,CAAC;IAEO,kBAAkB;QACxB,QAAQ,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,KAAK,OAAO;gBACV,OAAO,QAAQ,CAAC,KAAK,CAAC;YACxB,KAAK,MAAM;gBACT,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,KAAK,MAAM;gBACT,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,KAAK,OAAO;gBACV,OAAO,QAAQ,CAAC,KAAK,CAAC;YACxB,KAAK,MAAM;gBACT,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB;gBACE,OAAO,QAAQ,CAAC,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,mBAAmB;QACzB,IAAI,aAAa,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,eAAe;QACrB,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,0CAA0C;QAC1C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,CAAC,kCAAkC;QACjD,CAAC;QACD,sBAAsB;QACtB,IACE,OAAO,OAAO,KAAK,WAAW;YAC9B,OAAO,CAAC,MAAM;YACd,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EACrB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AACtB,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;AAEtC,mDAAmD;AACnD,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa;IACjC,CAAC,CAAC;QACE,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI,EAAE,wCAAwC;QACrD,IAAI,EAAE,IAAI,EAAE,wCAAwC;QACpD,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE;YACxC,OAAO,CAAC,IAAI,CAAC,wBAAwB,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE;YACzC,OAAO,CAAC,KAAK,CAAC,uBAAuB,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI;QAChC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM;QACvB,mBAAmB,EAAE,CAAC,WAAmB,EAAE,YAAqB,EAAE,EAAE,CAAC,CAAC;YACpE,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI,EAAE,yCAAyC;YACtD,IAAI,EAAE,IAAI,EAAE,wCAAwC;YACpD,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE;gBACxC,MAAM,MAAM,GAAG,GAAG,YAAY,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE;gBACzC,MAAM,MAAM,GAAG,GAAG,YAAY,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;gBACxD,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI;YAChC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM;YACvB,mBAAmB,EAAE,IAAI;SAC1B,CAAC;KACH;IACH,CAAC,CAAC,IAAI,iBAAiB,CAAC;QACpB,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;AAEP,6CAA6C;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa;IACjC,CAAC,CAAC,SAAS,MAAM;QACb,OAAO,MAAM,CAAC;IAChB,CAAC;IACH,CAAC,CAAC,iBAAiB,CAAC;AAEtB,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA2B,EAAE,EAAE;IACjE,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,IAAI,MAAM,CAAC,WAAW,IAAI,WAAW,EAAE,CAAC;QACrF,OAAO;YACL,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI,EAAE,+BAA+B;YAC5C,IAAI,EAAE,IAAI,EAAE,8BAA8B;YAC1C,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE;gBACxC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE;gBACzC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI;YAChC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM;YACvB,mBAAmB,EAAE,IAAI;SAC1B,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE;IACtC,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,SAAiB,CAAC;IACtB,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,cAAc,EAAE,CAAC;gBACnB,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAC/C,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,mBAAmB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACnE,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;KACpE,CAAC;AACJ,CAAC,CAAC"}

package/dist/utils/namespace-utils.d.ts

@@ -0,0 +1,30 @@
+import type { ParsedNamespaceKey } from '../types/translation.types.js';
+/**
+ * Namespace parsing utilities for translation keys
+ * Supports patterns like: 'common:welcome', 'user.profile.name', 'errors:validation.required'
+ */
+/**
+ * Parse namespace from translation key
+ * Supports: 'namespace:key' pattern
+ * Future: Could support other patterns like 'namespace.key' or 'namespace/key'
+ *
+ * @param key - Translation key (e.g., 'common:welcome' or 'welcome')
+ * @returns Parsed namespace information
+ */
+export declare function parseNamespaceKey(key: string): ParsedNamespaceKey;
+/**
+ * Create a full namespaced key
+ *
+ * @param key - Clean translation key
+ * @param namespace - Namespace to prepend
+ * @returns Namespaced key (e.g., 'common:welcome')
+ */
+export declare function createNamespacedKey(key: string, namespace?: string): string;
+/**
+ * Validate namespace format
+ *
+ * @param namespace - Namespace to validate
+ * @returns Whether namespace is valid
+ */
+export declare function isValidNamespace(namespace: string): boolean;
+//# sourceMappingURL=namespace-utils.d.ts.map

package/dist/utils/namespace-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-utils.d.ts","sourceRoot":"","sources":["../../src/utils/namespace-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE;;;GAGG;AAGH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAuBjE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG3D"}

package/dist/utils/namespace-utils.js

@@ -0,0 +1,56 @@
+/**
+ * Namespace parsing utilities for translation keys
+ * Supports patterns like: 'common:welcome', 'user.profile.name', 'errors:validation.required'
+ */
+/**
+ * Parse namespace from translation key
+ * Supports: 'namespace:key' pattern
+ * Future: Could support other patterns like 'namespace.key' or 'namespace/key'
+ *
+ * @param key - Translation key (e.g., 'common:welcome' or 'welcome')
+ * @returns Parsed namespace information
+ */
+export function parseNamespaceKey(key) {
+    // Simple namespace pattern: 'namespace:key'
+    const colonIndex = key.indexOf(':');
+    if (colonIndex > 0 && colonIndex < key.length - 1) {
+        // Has explicit namespace
+        const namespace = key.substring(0, colonIndex);
+        const cleanKey = key.substring(colonIndex + 1);
+        return {
+            originalKey: key,
+            namespace,
+            cleanKey,
+            hasExplicitNamespace: true
+        };
+    }
+    // No namespace found
+    return {
+        originalKey: key,
+        cleanKey: key,
+        hasExplicitNamespace: false
+    };
+}
+/**
+ * Create a full namespaced key
+ *
+ * @param key - Clean translation key
+ * @param namespace - Namespace to prepend
+ * @returns Namespaced key (e.g., 'common:welcome')
+ */
+export function createNamespacedKey(key, namespace) {
+    if (!namespace)
+        return key;
+    return `${namespace}:${key}`;
+}
+/**
+ * Validate namespace format
+ *
+ * @param namespace - Namespace to validate
+ * @returns Whether namespace is valid
+ */
+export function isValidNamespace(namespace) {
+    // Simple validation: alphanumeric, underscore, hyphen
+    return /^[a-zA-Z0-9_-]+$/.test(namespace);
+}
+//# sourceMappingURL=namespace-utils.js.map

package/dist/utils/namespace-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-utils.js","sourceRoot":"","sources":["../../src/utils/namespace-utils.ts"],"names":[],"mappings":"AACA;;;GAGG;AAGH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,4CAA4C;IAC5C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,yBAAyB;QACzB,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAE/C,OAAO;YACL,WAAW,EAAE,GAAG;YAChB,SAAS;YACT,QAAQ;YACR,oBAAoB,EAAE,IAAI;SAC3B,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,OAAO;QACL,WAAW,EAAE,GAAG;QAChB,QAAQ,EAAE,GAAG;QACb,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,SAAkB;IACjE,IAAI,CAAC,SAAS;QAAE,OAAO,GAAG,CAAC;IAC3B,OAAO,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,sDAAsD;IACtD,OAAO,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC"}

package/dist/utils/translation-flow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Enhanced translation process flow utilities
+ * Organizes the step-by-step translation resolution process with i18n features
+ */
+import type { TranslationRequest } from '../types/translation.types.js';
+/**
+ * ✅ Enhanced: Parse and prepare translation request with cache keys
+ * This is the entry point that organizes all the parsing logic
+ */
+export declare function prepareTranslationRequest(key: string, currentLocale: string, defaultValueOrParams?: string | Record<string, unknown>, paramsOrDefaultValue?: Record<string, unknown> | string, defaultNamespace?: string, fallbackLocale?: string): TranslationRequest;
+/**
+ * Parse flexible translation parameters
+ */
+export declare function parseTranslationParams(secondParam?: string | Record<string, unknown>, thirdParam?: Record<string, unknown> | string): {
+    defaultValue?: string;
+    params?: Record<string, unknown>;
+};
+//# sourceMappingURL=translation-flow.d.ts.map

package/dist/utils/translation-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-flow.d.ts","sourceRoot":"","sources":["../../src/utils/translation-flow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAQxE;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,oBAAoB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EACvD,gBAAgB,CAAC,EAAE,MAAM,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,kBAAkB,CAkDpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAC5C;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAgC7D"}

package/dist/utils/translation-flow.js

@@ -0,0 +1,74 @@
+/**
+ * Enhanced translation process flow utilities
+ * Organizes the step-by-step translation resolution process with i18n features
+ */
+import { createTranslationContext } from './context-utils.js';
+import { parseNamespaceKey } from './namespace-utils.js';
+import { createIndividualCacheKey, createNamespaceCacheKey, } from './translation-value-utils.js';
+/**
+ * ✅ Enhanced: Parse and prepare translation request with cache keys
+ * This is the entry point that organizes all the parsing logic
+ */
+export function prepareTranslationRequest(key, currentLocale, defaultValueOrParams, paramsOrDefaultValue, defaultNamespace, fallbackLocale) {
+    const startTime = performance.now();
+    // Parse flexible parameters
+    const { defaultValue, params } = parseTranslationParams(defaultValueOrParams, paramsOrDefaultValue);
+    // Parse namespace from key
+    const parsedKey = parseNamespaceKey(key);
+    // Create translation context
+    const context = createTranslationContext(parsedKey, currentLocale, defaultNamespace, fallbackLocale);
+    // ✅ Generate cache keys using unified pattern
+    const individualCacheKey = createIndividualCacheKey(context.locale, context.namespace, parsedKey.cleanKey);
+    const namespaceCacheKey = context.namespace
+        ? createNamespaceCacheKey(context.locale, context.namespace)
+        : undefined;
+    // Generate unique ID for the request (could be a hash or UUID)
+    const id = `${individualCacheKey}-${startTime}`;
+    return {
+        id, // Unique request ID
+        originalKey: key,
+        originalParams: defaultValueOrParams,
+        originalDefaultValue: paramsOrDefaultValue,
+        cleanKey: parsedKey.cleanKey,
+        hasExplicitNamespace: parsedKey.hasExplicitNamespace,
+        parsedParams: params,
+        parsedDefaultValue: defaultValue,
+        locale: currentLocale,
+        namespace: context.namespace, // ✅ Use effective namespace (explicit or default)
+        fallbackLocale,
+        individualCacheKey, // ✅ Ready-to-use cache key
+        namespaceCacheKey, // ✅ Ready-to-use namespace key
+        startTime,
+    };
+}
+/**
+ * Parse flexible translation parameters
+ */
+export function parseTranslationParams(secondParam, thirdParam) {
+    let defaultValue;
+    let params;
+    // Runtime validation: Warn if both params are objects (likely misuse)
+    if (typeof secondParam === 'object' &&
+        typeof thirdParam === 'object' &&
+        process.env.NODE_ENV !== 'production') {
+        console.warn('[LionRapid] Warning: Both secondParam and thirdParam are objects. ' +
+            'Expected pattern: t(key, params, defaultValue) or t(key, defaultValue, params). ' +
+            'Second object will be ignored as it cannot be a defaultValue.');
+    }
+    if (typeof secondParam === 'string') {
+        // t(key, defaultValue) or t(key, defaultValue, params)
+        defaultValue = secondParam;
+        if (typeof thirdParam === 'object') {
+            params = thirdParam;
+        }
+    }
+    else if (typeof secondParam === 'object') {
+        // t(key, params) or t(key, params, defaultValue)
+        params = secondParam;
+        if (typeof thirdParam === 'string') {
+            defaultValue = thirdParam;
+        }
+    }
+    return { defaultValue, params };
+}
+//# sourceMappingURL=translation-flow.js.map

package/dist/utils/translation-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-flow.js","sourceRoot":"","sources":["../../src/utils/translation-flow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,aAAqB,EACrB,oBAAuD,EACvD,oBAAuD,EACvD,gBAAyB,EACzB,cAAuB;IAEvB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEpC,4BAA4B;IAC5B,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,sBAAsB,CACrD,oBAAoB,EACpB,oBAAoB,CACrB,CAAC;IAEF,2BAA2B;IAC3B,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEzC,6BAA6B;IAC7B,MAAM,OAAO,GAAG,wBAAwB,CACtC,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,CACf,CAAC;IAEF,8CAA8C;IAC9C,MAAM,kBAAkB,GAAG,wBAAwB,CACjD,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,SAAS,EACjB,SAAS,CAAC,QAAQ,CACnB,CAAC;IAEF,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS;QACzC,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC;QAC5D,CAAC,CAAC,SAAS,CAAC;IAEd,+DAA+D;IAC/D,MAAM,EAAE,GAAG,GAAG,kBAAkB,IAAI,SAAS,EAAE,CAAC;IAEhD,OAAO;QACL,EAAE,EAAE,oBAAoB;QACxB,WAAW,EAAE,GAAG;QAChB,cAAc,EAAE,oBAAoB;QACpC,oBAAoB,EAAE,oBAAoB;QAC1C,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,oBAAoB,EAAE,SAAS,CAAC,oBAAoB;QACpD,YAAY,EAAE,MAAM;QACpB,kBAAkB,EAAE,YAAY;QAChC,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,kDAAkD;QAChF,cAAc;QACd,kBAAkB,EAAE,2BAA2B;QAC/C,iBAAiB,EAAE,+BAA+B;QAClD,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAA8C,EAC9C,UAA6C;IAE7C,IAAI,YAAgC,CAAC;IACrC,IAAI,MAA2C,CAAC;IAEhD,sEAAsE;IACtE,IACE,OAAO,WAAW,KAAK,QAAQ;QAC/B,OAAO,UAAU,KAAK,QAAQ;QAC9B,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EACrC,CAAC;QACD,OAAO,CAAC,IAAI,CACV,oEAAoE;YAClE,kFAAkF;YAClF,+DAA+D,CAClE,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,uDAAuD;QACvD,YAAY,GAAG,WAAW,CAAC;QAC3B,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC3C,iDAAiD;QACjD,MAAM,GAAG,WAAW,CAAC;QACrB,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,YAAY,GAAG,UAAU,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/utils/translation-value-utils.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Translation value processing utilities
+ * Handles simple strings, nested objects, pluralization, and context
+ */
+/**
+ * ✅ Resolve nested key path in translation object
+ */
+/**
+ * ✅ Resolve nested key from namespace object
+ * Examples:
+ * - resolveNestedKey({user: {profile: {name: "John"}}}, "user.profile.name") → "John"
+ * - resolveNestedKey({items: [{name: "Apple"}]}, "items[0].name") → "Apple"
+ * - resolveNestedKey({welcome: "Hello"}, "welcome") → "Hello"
+ */
+export declare function resolveNestedKey(namespace: Record<string, unknown>, keyPath: string): unknown;
+/**
+ * ✅ Parse key path into array of keys/indices
+ * Examples:
+ * - "user.profile.name" → ["user", "profile", "name"]
+ * - "items[0].name" → ["items", 0, "name"]
+ * - "settings.ui.theme" → ["settings", "ui", "theme"]
+ */
+export declare function parseKeyPath(keyPath: string): (string | number)[];
+/**
+ * ✅ Create individual cache key: locale:namespace:key
+ */
+export declare function createIndividualCacheKey(locale: string, namespace: string | undefined, key: string): string;
+/**
+ * ✅ Create namespace cache key: @locale:namespace
+ */
+export declare function createNamespaceCacheKey(locale: string, namespace: string): string;
+/**
+ * ✅ Check if key is namespace cache entry
+ */
+export declare function isNamespaceCacheKey(key: string): boolean;
+/**
+ * ✅ Parse namespace cache key
+ */
+export declare function parseNamespaceCacheKey(key: string): {
+    locale: string;
+    namespace: string;
+} | null;
+/**
+ * ✅ Parse individual cache key
+ */
+export declare function parseIndividualCacheKey(key: string): {
+    locale: string;
+    namespace?: string;
+    translationKey: string;
+} | null;
+/**
+ * ✅ Flatten nested translations for caching individual keys
+ * Handles both ICU MessageFormat strings and structured objects
+ * Stores full ContentUnit as JSON - includes both text and styles
+ */
+export declare function flattenTranslations(translations: Record<string, unknown>, prefix: string | undefined, locale: string, namespace: string): Record<string, string>;
+//# sourceMappingURL=translation-value-utils.d.ts.map

package/dist/utils/translation-value-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-value-utils.d.ts","sourceRoot":"","sources":["../../src/utils/translation-value-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAoDT;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CA8CjE;AAGD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,GACV,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,GACV;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQ9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,GACV;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBvE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,oBAAK,EACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBxB"}