@lionrapid/core 0.1.0

package/dist/utils/translation-value-utils.js

@@ -0,0 +1,194 @@
+/**
+ * Translation value processing utilities
+ * Handles simple strings, nested objects, pluralization, and context
+ */
+// import type { TranslationParams } from '../types/translation.types.js';
+// import { interpolateParams } from './translation-utils.js';
+import { logger } from './logger.js';
+/**
+ * ✅ 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 function resolveNestedKey(namespace, keyPath) {
+    if (!namespace || !keyPath) {
+        return undefined;
+    }
+    // Handle simple key (no nesting)
+    if (!keyPath.includes('.') && !keyPath.includes('[')) {
+        return namespace[keyPath];
+    }
+    // Handle nested key navigation
+    try {
+        const keys = parseKeyPath(keyPath);
+        let current = namespace;
+        for (const key of keys) {
+            if (current === null || current === undefined) {
+                logger.debug(`🔍 Nested key resolution stopped at null/undefined for: ${keyPath}`);
+                return undefined;
+            }
+            if (typeof key === 'number') {
+                // Array index access
+                if (!Array.isArray(current)) {
+                    logger.debug(`🔍 Expected array for index ${key} in path: ${keyPath}`);
+                    return undefined;
+                }
+                current = current[key];
+            }
+            else {
+                // Object property access
+                if (typeof current !== 'object') {
+                    logger.debug(`🔍 Expected object for key '${key}' in path: ${keyPath}`);
+                    return undefined;
+                }
+                current = current[key];
+            }
+        }
+        logger.debug(`🔍 Nested key resolved: ${keyPath} → ${typeof current === 'object' ? '[Object]' : current}`);
+        return current;
+    }
+    catch (error) {
+        logger.debug(`🔍 Nested key resolution error for '${keyPath}':`, error);
+        return undefined;
+    }
+}
+/**
+ * ✅ 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 function parseKeyPath(keyPath) {
+    const keys = [];
+    let currentKey = '';
+    let inBrackets = false;
+    for (let i = 0; i < keyPath.length; i++) {
+        const char = keyPath[i];
+        if (char === '.' && !inBrackets) {
+            // End of current key
+            if (currentKey) {
+                keys.push(currentKey);
+                currentKey = '';
+            }
+        }
+        else if (char === '[') {
+            // Start of array index
+            if (currentKey) {
+                keys.push(currentKey);
+                currentKey = '';
+            }
+            inBrackets = true;
+        }
+        else if (char === ']' && inBrackets) {
+            // End of array index
+            if (currentKey) {
+                const index = parseInt(currentKey, 10);
+                if (!isNaN(index)) {
+                    keys.push(index);
+                }
+                else {
+                    // Non-numeric index, treat as string
+                    keys.push(currentKey);
+                }
+                currentKey = '';
+            }
+            inBrackets = false;
+        }
+        else {
+            // Regular character
+            currentKey += char;
+        }
+    }
+    // Add remaining key
+    if (currentKey) {
+        keys.push(currentKey);
+    }
+    return keys;
+}
+/**
+ * ✅ Create individual cache key: locale:namespace:key
+ */
+export function createIndividualCacheKey(locale, namespace, key) {
+    const parts = [locale];
+    if (namespace) {
+        parts.push(namespace);
+    }
+    parts.push(key);
+    return parts.join(':');
+}
+/**
+ * ✅ Create namespace cache key: @locale:namespace
+ */
+export function createNamespaceCacheKey(locale, namespace) {
+    return `@${locale}:${namespace}`;
+}
+/**
+ * ✅ Check if key is namespace cache entry
+ */
+export function isNamespaceCacheKey(key) {
+    return key.startsWith('@');
+}
+/**
+ * ✅ Parse namespace cache key
+ */
+export function parseNamespaceCacheKey(key) {
+    if (!key.startsWith('@'))
+        return null;
+    const parts = key.substring(1).split(':');
+    if (parts.length !== 2)
+        return null;
+    const [locale, namespace] = parts;
+    return { locale, namespace };
+}
+/**
+ * ✅ Parse individual cache key
+ */
+export function parseIndividualCacheKey(key) {
+    if (key.startsWith('@'))
+        return null;
+    const parts = key.split(':');
+    if (parts.length < 2)
+        return null;
+    if (parts.length === 2) {
+        const [locale, translationKey] = parts;
+        return { locale, translationKey };
+    }
+    if (parts.length === 3) {
+        const [locale, namespace, translationKey] = parts;
+        return { locale, namespace, translationKey };
+    }
+    return 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 function flattenTranslations(translations, prefix = '', locale, namespace) {
+    const flattened = {};
+    for (const [key, value] of Object.entries(translations)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        const cacheKey = createIndividualCacheKey(locale, namespace, fullKey);
+        if (typeof value === 'object' && value !== null && 'text' in value && 'styles' in value) {
+            // Server returns ContentUnit format: { text, styles }
+            // Store as JSON to preserve both text and styles
+            flattened[cacheKey] = JSON.stringify(value);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            // Nested object - flatten recursively
+            Object.assign(flattened, flattenTranslations(value, fullKey, locale, namespace));
+        }
+        else {
+            // Fallback for plain strings - wrap in ContentUnit format
+            flattened[cacheKey] = JSON.stringify({ text: String(value), styles: {} });
+        }
+    }
+    return flattened;
+}
+//# sourceMappingURL=translation-value-utils.js.map

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

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@lionrapid/core",
+  "version": "0.1.0",
+  "description": "Core functionality for LionRapid localization library with fixed dist publishing",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./browser": {
+      "import": "./dist/browser/lionrapid.iife.min.js",
+      "default": "./dist/browser/lionrapid.iife.min.js"
+    },
+    "./browser/dev": {
+      "import": "./dist/browser/lionrapid.iife.dev.js",
+      "default": "./dist/browser/lionrapid.iife.dev.js"
+    },
+    "./browser/auto": {
+      "import": "./dist/browser/lionrapid.auto.min.js",
+      "default": "./dist/browser/lionrapid.auto.min.js"
+    },
+    "./browser/auto/dev": {
+      "import": "./dist/browser/lionrapid.auto.dev.js",
+      "default": "./dist/browser/lionrapid.auto.dev.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "dotenv -e ../../.env.production -- tsc -b && node build.browser.js",
+    "build:browser": "node build.browser.js",
+    "dev": "dotenv -e ../../.env.development -- tsc -b --watch",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo .turbo coverage",
+    "test": "dotenv -e ../../.env.test -- vitest run --passWithNoTests",
+    "test:watch": "dotenv -e ../../.env.test -- vitest",
+    "test:coverage": "dotenv -e ../../.env.test -- vitest run --coverage",
+    "typecheck": "dotenv -e ../../.env.development -- tsc --noEmit",
+    "lint": "eslint src --ext .ts --max-warnings 0",
+    "lint:fix": "eslint src --ext .ts --fix"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/ui": "^1.0.0",
+    "dotenv-cli": "^7.3.0",
+    "typescript": "^5.2.0",
+    "vitest": "^1.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hatamoto/tm-integration.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "localization",
+    "i18n",
+    "translation",
+    "typescript",
+    "core",
+    "server-first"
+  ],
+  "author": "Janrau B",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}