@lovalingo/lovalingo 0.5.4 → 0.5.5

package/LICENSE

@@ -1,6 +1,6 @@
 LOVALINGO COMMERCIAL LICENSE
 
-Copyright (c) 2025 Lovalingo Swiss. All rights reserved.
+Copyright (c) 2026 Lovalingo Swiss. All rights reserved.
 
 NOTICE: This software and associated documentation files (the "Software") are the
 proprietary and confidential information of Lovalingo Swiss.
@@ -143,6 +143,6 @@ please contact Lovalingo Swiss.
 
 MERTENS ADVIES
 Lovalingo Translation Platform
-© 2025 All Rights Reserved
+© 2026 All Rights Reserved
 
 Website: [Contact Lovalingo Swiss for licensing information]

package/README.md

@@ -21,7 +21,10 @@ The runtime now marks translatable text nodes deterministically and exposes mark
 - Coverage is enforced server-side (jobs fail if marker coverage is below the threshold).
 - This is a breaking change: older runtimes will be rejected by the pipeline.
 
-Debug (runtime logs): set `window.__lovalingoDebug = true` before initializing `LovalingoProvider`.
+Debug (runtime logs):
+- append `?lovalingoDebug=1` to the URL (works across reloads)
+- or run `localStorage.setItem("Lovalingo_debug","1")` and reload
+- or set `window.__lovalingoDebug = true` (same-tab only; not persistent)
 
 ## Installation
 
@@ -137,7 +140,7 @@ You still need to serve `/sitemap.xml` on your own domain (recommended: reverse-
 
 ## License
 
-Commercial license (not open source). See `react-package/LICENSE`.
+Commercial license (not open source). See `LICENSE`.
 
 Manual translation control:
 
@@ -349,7 +352,7 @@ export async function GET() {
 
 **COMMERCIAL LICENSE - NOT OPEN SOURCE**
 
-Copyright (c) 2025 Lovalingo Swiss. All rights reserved.
+Copyright (c) 2026 Lovalingo Swiss. All rights reserved.
 
 ### For Agencies & Developers
 

package/dist/components/AixsterProvider.js

@@ -641,6 +641,7 @@ navigateRef, // For path mode routing
             if (previousLocale && previousLocale !== defaultLocale) {
                 logDebug(`[Lovalingo] Switching from ${previousLocale} to ${targetLocale}`);
             }
+            let revealedViaCachedCritical = false;
             const cachedCritical = readCriticalCache(targetLocale, normalizedPath);
             if (cachedCritical?.loading_bg_color) {
                 setCachedLoadingBgColor(cachedCritical.loading_bg_color);
@@ -656,6 +657,7 @@ navigateRef, // For path mode routing
                     applyActiveTranslations(document.body);
                 }
                 disablePrehide();
+                revealedViaCachedCritical = true;
             }
             const bootstrap = await apiRef.current.fetchBootstrap(targetLocale, currentPath);
             const nextEntitlements = bootstrap?.entitlements || apiRef.current.getEntitlements();
@@ -694,6 +696,7 @@ navigateRef, // For path mode routing
             const criticalMap = bootstrap?.critical?.map && typeof bootstrap.critical.map === "object" && !Array.isArray(bootstrap.critical.map)
                 ? bootstrap.critical.map
                 : {};
+            const hasBootstrapCritical = Object.keys(criticalMap).length > 0;
             if (Object.keys(criticalMap).length > 0) {
                 setActiveTranslations(toTranslations(criticalMap, targetLocale));
                 if (mode === "dom") {
@@ -714,6 +717,37 @@ navigateRef, // For path mode routing
                 exclusions,
                 loading_bg_color: bootstrap?.loading_bg_color && /^#[0-9a-fA-F]{6}$/.test(bootstrap.loading_bg_color) ? bootstrap.loading_bg_color : null,
             });
+            const shouldWaitForBundle = !revealedViaCachedCritical && !hasBootstrapCritical;
+            if (shouldWaitForBundle) {
+                // Why: if there's no critical slice for first paint, wait for the bundle (within the prehide failsafe) to avoid a visible flash.
+                const bundle = await apiRef.current.fetchBundle(targetLocale, currentPath);
+                if (bundle?.map && typeof bundle.map === "object") {
+                    const translations = toTranslations(bundle.map, targetLocale);
+                    if (translations.length > 0) {
+                        translationCacheRef.current.set(cacheKey, { translations });
+                        setActiveTranslations(translations);
+                        if (mode === "dom") {
+                            applyActiveTranslations(document.body);
+                        }
+                    }
+                }
+            }
+            else {
+                // Lazy-load the full page bundle after first paint.
+                void (async () => {
+                    const bundle = await apiRef.current.fetchBundle(targetLocale, currentPath);
+                    if (!bundle || !bundle.map)
+                        return;
+                    const translations = toTranslations(bundle.map, targetLocale);
+                    if (translations.length === 0)
+                        return;
+                    translationCacheRef.current.set(cacheKey, { translations });
+                    setActiveTranslations(translations);
+                    if (mode === "dom") {
+                        applyActiveTranslations(document.body);
+                    }
+                })();
+            }
             disablePrehide();
             // Delayed retry scan to catch late-rendering content
             retryTimeoutRef.current = setTimeout(() => {
@@ -730,20 +764,6 @@ navigateRef, // For path mode routing
                     applyDomRules(rules);
                 }
             }, 500);
-            // Lazy-load the full page bundle after first paint.
-            void (async () => {
-                const bundle = await apiRef.current.fetchBundle(targetLocale, currentPath);
-                if (!bundle || !bundle.map)
-                    return;
-                const translations = toTranslations(bundle.map, targetLocale);
-                if (translations.length === 0)
-                    return;
-                translationCacheRef.current.set(cacheKey, { translations });
-                setActiveTranslations(translations);
-                if (mode === "dom") {
-                    applyActiveTranslations(document.body);
-                }
-            })();
         }
         catch (error) {
             errorDebug('Error loading translations:', error);
@@ -903,14 +923,23 @@ navigateRef, // For path mode routing
         });
     }, [allLocales, defaultLocale, locale, routing, loadData, navigateRef, routingConfig.nonLocalizedPaths]);
     // No string-level "misses" from the client: the pipeline (Browser Rendering) is source-of-truth for string discovery.
+    // Why: prevent init/load effects from re-running (and calling bootstrap/bundle again) when loadData changes due to state updates.
+    const loadDataRef = useRef(loadData);
+    useEffect(() => {
+        loadDataRef.current = loadData;
+    }, [loadData]);
+    const detectLocaleRef = useRef(detectLocale);
+    useEffect(() => {
+        detectLocaleRef.current = detectLocale;
+    }, [detectLocale]);
     // Initialize
     useEffect(() => {
-        const initialLocale = detectLocale();
+        const initialLocale = detectLocaleRef.current();
         lastNormalizedPathRef.current = processPath(window.location.pathname, enhancedPathConfig);
         // Track initial page (fallback discovery for pages not present in the routes feed).
         trackPageviewOnce(window.location.pathname + window.location.search);
         // Always prefetch artifacts for the initial locale (pipeline-produced translations + rules).
-        loadData(initialLocale);
+        loadDataRef.current(initialLocale);
         // Set up keyboard shortcut for edit mode
         const handleKeyPress = (e) => {
             if (e.code === editKey && (e.ctrlKey || e.metaKey)) {
@@ -926,7 +955,7 @@ navigateRef, // For path mode routing
                 clearTimeout(retryTimeoutRef.current);
             }
         };
-    }, [detectLocale, enhancedPathConfig, loadData, editKey, trackPageviewOnce]);
+    }, [editKey, enhancedPathConfig, trackPageviewOnce]);
     // Auto-inject sitemap link tag
     useEffect(() => {
         if (sitemap && resolvedApiKey && isSeoActive()) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @Lovalingo/Lovalingo - Proprietary Translation Library
  *
- * Copyright (c) 2025 Lovalingo Swiss. All rights reserved.
+ * Copyright (c) 2026 Lovalingo Swiss. All rights reserved.
  *
  * This software is the intellectual property of Lovalingo Swiss.
  * NOT OPEN SOURCE - All rights reserved.

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
  * @Lovalingo/Lovalingo - Proprietary Translation Library
  *
- * Copyright (c) 2025 Lovalingo Swiss. All rights reserved.
+ * Copyright (c) 2026 Lovalingo Swiss. All rights reserved.
  *
  * This software is the intellectual property of Lovalingo Swiss.
  * NOT OPEN SOURCE - All rights reserved.

package/dist/utils/logger.js

@@ -4,6 +4,23 @@ function isDebugEnabled() {
     const value = globalThis.__lovalingoDebug;
     if (value === true || value === "true" || value === 1)
         return true;
+    try {
+        const params = typeof window !== "undefined" ? new URLSearchParams(window.location.search) : null;
+        const query = params?.get("lovalingoDebug") || params?.get("lovalingo_debug") || "";
+        if (query === "1" || query === "true")
+            return true;
+    }
+    catch {
+        // ignore
+    }
+    try {
+        const stored = typeof window !== "undefined" ? window.localStorage?.getItem("Lovalingo_debug") : null;
+        if (stored === "1" || stored === "true")
+            return true;
+    }
+    catch {
+        // ignore
+    }
     return false;
 }
 export function logDebug(...args) {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.5.4";
+export declare const VERSION = "0.5.5";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.5.4";
+export const VERSION = "0.5.5";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovalingo/lovalingo",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "React translation runtime with i18n routing, deterministic bundles + DOM rules, and zero-flash rendering.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",