@lovalingo/lovalingo 0.5.5 → 0.5.6

package/dist/components/AixsterProvider.js

@@ -1,1251 +1 @@
-import React, { useMemo, useState, useEffect, useCallback, useRef, useContext } from 'react';
-import { LovalingoContext } from '../context/LovalingoContext';
-import { LangRoutingContext } from '../context/LangRoutingContext';
-import { LovalingoAPI } from '../utils/api';
-import { applyDomRules } from '../utils/domRules';
-import { hashContent } from '../utils/hash';
-import { applyActiveTranslations, getCriticalFingerprint, restoreDom, setActiveTranslations, setMarkerEngineExclusions, startMarkerEngine } from '../utils/markerEngine';
-import { logDebug, warnDebug, errorDebug } from '../utils/logger';
-import { isNonLocalizedPath, stripLocalePrefix } from '../utils/nonLocalizedPaths';
-import { processPath } from '../utils/pathNormalizer';
-import { LanguageSwitcher } from './LanguageSwitcher';
-const LOCALE_STORAGE_KEY = 'Lovalingo_locale';
-const LOADING_BG_STORAGE_PREFIX = "Lovalingo_loading_bg_color";
-const BRANDING_STORAGE_PREFIX = "Lovalingo_branding_enabled";
-const CRITICAL_CACHE_PREFIX = "Lovalingo_critical_v0_3";
-// Why: avoid long blank screens on blocked/untranslated routes by always revealing the original page quickly.
-const PREHIDE_FAILSAFE_MS = 1700;
-export const LovalingoProvider = ({ children, apiKey: apiKeyProp, publicAnonKey, defaultLocale, locales, apiBase = 'https://cdn.lovalingo.com', routing = 'path', // Default to path mode (SEO-friendly, recommended)
-autoPrefixLinks = true, overlayBgColor, autoApplyRules = true, switcherPosition = 'bottom-right', switcherOffsetY = 20, switcherTheme = 'dark', editMode: initialEditMode = false, editKey = 'KeyE', pathNormalization = { enabled: true }, // Enable by default
-mode = 'dom', // Default to legacy DOM mode for backward compatibility
-sitemap = true, // Default: true - Auto-inject sitemap link tag
-seo = true, // Default: true - Can be disabled per project entitlements
-navigateRef, // For path mode routing
- }) => {
-    const metaKey = typeof document !== "undefined"
-        ? document.querySelector('meta[name="lovalingo-public-anon-key"]')?.content?.trim() || ""
-        : "";
-    const resolvedApiKey = (typeof apiKeyProp === "string" && apiKeyProp.trim().length > 0
-        ? apiKeyProp
-        : typeof publicAnonKey === "string" && publicAnonKey.trim().length > 0
-            ? publicAnonKey
-            : globalThis
-                .__LOVALINGO_PUBLIC_ANON_KEY__ ||
-                globalThis.__LOVALINGO_API_KEY__ ||
-                metaKey ||
-                "");
-    const rawLocales = Array.isArray(locales) ? locales : [];
-    // Stabilize locale lists even when callers pass inline arrays (e.g. locales={["en","de"]})
-    // so effects/callbacks don't re-run every render.
-    const localesKey = rawLocales.join(",");
-    const allLocales = useMemo(() => {
-        const base = rawLocales.includes(defaultLocale) ? rawLocales : [defaultLocale, ...rawLocales];
-        return Array.from(new Set(base));
-    }, [defaultLocale, localesKey, rawLocales]);
-    // Why: read locale synchronously from the URL to avoid an initial default-locale render (EN → FR flash) before effects run.
-    const [locale, setLocaleState] = useState(() => {
-        if (typeof window === "undefined")
-            return defaultLocale;
-        if (routing === "path") {
-            const pathLocale = window.location.pathname.split("/")[1];
-            if (pathLocale && allLocales.includes(pathLocale)) {
-                return pathLocale;
-            }
-        }
-        else if (routing === "query") {
-            const params = new URLSearchParams(window.location.search);
-            const queryLocale = params.get("t") || params.get("locale");
-            if (queryLocale && allLocales.includes(queryLocale)) {
-                return queryLocale;
-            }
-        }
-        try {
-            const stored = localStorage.getItem(LOCALE_STORAGE_KEY);
-            if (stored && allLocales.includes(stored)) {
-                return stored;
-            }
-        }
-        catch {
-            // ignore
-        }
-        return defaultLocale;
-    });
-    const [isLoading, setIsLoading] = useState(false);
-    const [editMode, setEditMode] = useState(initialEditMode);
-    const enhancedPathConfig = useMemo(() => (routing === "path" ? { ...pathNormalization, supportedLocales: allLocales } : pathNormalization), [allLocales, pathNormalization, routing]);
-    const apiRef = useRef(new LovalingoAPI(resolvedApiKey, apiBase, enhancedPathConfig));
-    useEffect(() => {
-        apiRef.current = new LovalingoAPI(resolvedApiKey, apiBase, enhancedPathConfig);
-    }, [apiBase, enhancedPathConfig, resolvedApiKey]);
-    const routingConfig = useContext(LangRoutingContext);
-    const [entitlements, setEntitlements] = useState(() => apiRef.current.getEntitlements());
-    const lastPageviewRef = useRef("");
-    const lastPageviewFingerprintRef = useRef("");
-    const pageviewFingerprintTimeoutRef = useRef(null);
-    const pageviewFingerprintRetryTimeoutRef = useRef(null);
-    const lastNormalizedPathRef = useRef("");
-    const historyPatchedRef = useRef(false);
-    const originalHistoryRef = useRef(null);
-    const onNavigateRef = useRef(() => undefined);
-    const retryTimeoutRef = useRef(null);
-    const loadingFailsafeTimeoutRef = useRef(null);
-    const isNavigatingRef = useRef(false);
-    const isInternalNavigationRef = useRef(false);
-    const inFlightLoadKeyRef = useRef(null);
-    const translationCacheRef = useRef(new Map());
-    const exclusionsCacheRef = useRef(null);
-    const domRulesCacheRef = useRef(new Map());
-    const loadingBgStorageKey = `${LOADING_BG_STORAGE_PREFIX}:${resolvedApiKey || "anonymous"}`;
-    const brandingStorageKey = `${BRANDING_STORAGE_PREFIX}:${resolvedApiKey || "anonymous"}`;
-    const readBrandingCache = () => {
-        try {
-            const cached = (localStorage.getItem(brandingStorageKey) || "").trim();
-            if (cached === "0")
-                return false;
-            if (cached === "1")
-                return true;
-        }
-        catch {
-            // ignore
-        }
-        return true;
-    };
-    const [brandingEnabled, setBrandingEnabled] = useState(readBrandingCache);
-    const prehideStateRef = useRef({
-        active: false,
-        timeoutId: null,
-        startedAtMs: null,
-        prevHtmlVisibility: "",
-        prevBodyVisibility: "",
-        prevHtmlBg: "",
-        prevBodyBg: "",
-    });
-    const getCachedLoadingBgColor = useCallback(() => {
-        const configured = (overlayBgColor || "").toString().trim();
-        if (/^#[0-9a-fA-F]{6}$/.test(configured))
-            return configured;
-        try {
-            const cached = localStorage.getItem(loadingBgStorageKey) || "";
-            if (/^#[0-9a-fA-F]{6}$/.test(cached.trim()))
-                return cached.trim();
-        }
-        catch {
-            // ignore
-        }
-        return "#ffffff";
-    }, [loadingBgStorageKey, overlayBgColor]);
-    const setCachedLoadingBgColor = useCallback((color) => {
-        const next = (color || "").toString().trim();
-        if (!/^#[0-9a-fA-F]{6}$/.test(next))
-            return;
-        try {
-            localStorage.setItem(loadingBgStorageKey, next);
-        }
-        catch {
-            // ignore
-        }
-    }, [loadingBgStorageKey]);
-    useEffect(() => {
-        // Why: make `overlayBgColor` the source of truth while keeping the existing cache key for backwards compatibility.
-        const configured = (overlayBgColor || "").toString().trim();
-        if (!/^#[0-9a-fA-F]{6}$/.test(configured))
-            return;
-        setCachedLoadingBgColor(configured);
-    }, [overlayBgColor, setCachedLoadingBgColor]);
-    const setCachedBrandingEnabled = useCallback((enabled) => {
-        try {
-            localStorage.setItem(brandingStorageKey, enabled === false ? "0" : "1");
-        }
-        catch {
-            // ignore
-        }
-    }, [brandingStorageKey]);
-    useEffect(() => {
-        setBrandingEnabled(readBrandingCache());
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [brandingStorageKey]);
-    useEffect(() => {
-        lastPageviewRef.current = "";
-        lastPageviewFingerprintRef.current = "";
-    }, [resolvedApiKey]);
-    const trackPageviewOnce = useCallback((path) => {
-        const next = (path || "").toString();
-        if (!next)
-            return;
-        if (lastPageviewRef.current === next)
-            return;
-        lastPageviewRef.current = next;
-        apiRef.current.trackPageview(next);
-        const trySendFingerprint = () => {
-            if (typeof window === "undefined")
-                return;
-            const markersReady = window.__lovalingoMarkersReady === true;
-            if (!markersReady)
-                return;
-            const fp = getCriticalFingerprint();
-            if (!fp || fp.critical_count <= 0)
-                return;
-            const signature = `${next}|${fp.critical_hash}|${fp.critical_count}`;
-            if (lastPageviewFingerprintRef.current === signature)
-                return;
-            lastPageviewFingerprintRef.current = signature;
-            apiRef.current.trackPageview(next, fp);
-        };
-        if (pageviewFingerprintTimeoutRef.current != null)
-            window.clearTimeout(pageviewFingerprintTimeoutRef.current);
-        if (pageviewFingerprintRetryTimeoutRef.current != null)
-            window.clearTimeout(pageviewFingerprintRetryTimeoutRef.current);
-        // Why: wait briefly for markers/content to settle before computing a critical fingerprint for change detection.
-        pageviewFingerprintTimeoutRef.current = window.setTimeout(trySendFingerprint, 800);
-        pageviewFingerprintRetryTimeoutRef.current = window.setTimeout(trySendFingerprint, 2000);
-    }, []);
-    const forceDisablePrehide = useCallback(() => {
-        if (typeof document === "undefined")
-            return;
-        const html = document.documentElement;
-        const body = document.body;
-        if (!html || !body)
-            return;
-        const state = prehideStateRef.current;
-        if (state.timeoutId != null) {
-            window.clearTimeout(state.timeoutId);
-            state.timeoutId = null;
-        }
-        if (!state.active)
-            return;
-        state.active = false;
-        state.startedAtMs = null;
-        html.style.visibility = state.prevHtmlVisibility;
-        body.style.visibility = state.prevBodyVisibility;
-        html.style.backgroundColor = state.prevHtmlBg;
-        body.style.backgroundColor = state.prevBodyBg;
-    }, []);
-    const enablePrehide = useCallback((bgColor) => {
-        if (typeof document === "undefined")
-            return;
-        const html = document.documentElement;
-        const body = document.body;
-        if (!html || !body)
-            return;
-        const state = prehideStateRef.current;
-        // Why: avoid "perma-hidden" pages when repeated navigation/errors keep prehide active; always hard-stop after a few seconds.
-        if (state.active && state.startedAtMs != null && Date.now() - state.startedAtMs > PREHIDE_FAILSAFE_MS * 3) {
-            forceDisablePrehide();
-        }
-        if (!state.active) {
-            state.active = true;
-            state.startedAtMs = Date.now();
-            state.prevHtmlVisibility = html.style.visibility || "";
-            state.prevBodyVisibility = body.style.visibility || "";
-            state.prevHtmlBg = html.style.backgroundColor || "";
-            state.prevBodyBg = body.style.backgroundColor || "";
-        }
-        html.style.visibility = "hidden";
-        body.style.visibility = "hidden";
-        if (bgColor) {
-            html.style.backgroundColor = bgColor;
-            body.style.backgroundColor = bgColor;
-        }
-        if (state.timeoutId != null) {
-            return;
-        }
-        // Why: avoid a "perma-hide" when navigation events repeatedly re-trigger prehide and keep extending the timeout.
-        state.timeoutId = window.setTimeout(() => forceDisablePrehide(), PREHIDE_FAILSAFE_MS);
-    }, [forceDisablePrehide]);
-    const disablePrehide = forceDisablePrehide;
-    const buildCriticalCacheKey = useCallback((targetLocale, normalizedPath) => {
-        const key = `${resolvedApiKey || "anonymous"}:${targetLocale}:${normalizedPath || "/"}`;
-        return `${CRITICAL_CACHE_PREFIX}:${hashContent(key)}`;
-    }, [resolvedApiKey]);
-    const readCriticalCache = useCallback((targetLocale, normalizedPath) => {
-        const key = buildCriticalCacheKey(targetLocale, normalizedPath);
-        try {
-            const raw = localStorage.getItem(key);
-            if (!raw)
-                return null;
-            const parsed = JSON.parse(raw);
-            if (!parsed || typeof parsed !== "object")
-                return null;
-            const record = parsed;
-            const map = record.map && typeof record.map === "object" && !Array.isArray(record.map) ? record.map : null;
-            const exclusionsRaw = Array.isArray(record.exclusions) ? record.exclusions : [];
-            const exclusions = exclusionsRaw
-                .map((row) => {
-                if (!row || typeof row !== "object")
-                    return null;
-                const r = row;
-                const selector = typeof r.selector === "string" ? r.selector.trim() : "";
-                const type = typeof r.type === "string" ? r.type.trim() : "";
-                if (!selector)
-                    return null;
-                if (type !== "css" && type !== "xpath")
-                    return null;
-                return { selector, type: type };
-            })
-                .filter(Boolean);
-            const bg = typeof record.loading_bg_color === "string" ? record.loading_bg_color.trim() : "";
-            return {
-                map: map || {},
-                exclusions,
-                loading_bg_color: /^#[0-9a-fA-F]{6}$/.test(bg) ? bg : null,
-            };
-        }
-        catch {
-            return null;
-        }
-    }, [buildCriticalCacheKey]);
-    const writeCriticalCache = useCallback((targetLocale, normalizedPath, entry) => {
-        const key = buildCriticalCacheKey(targetLocale, normalizedPath);
-        try {
-            localStorage.setItem(key, JSON.stringify({
-                stored_at: Date.now(),
-                map: entry.map || {},
-                exclusions: entry.exclusions || [],
-                loading_bg_color: entry.loading_bg_color,
-            }));
-        }
-        catch {
-            // ignore
-        }
-    }, [buildCriticalCacheKey]);
-    const config = {
-        apiKey: resolvedApiKey,
-        publicAnonKey: resolvedApiKey,
-        defaultLocale,
-        locales: allLocales,
-        apiBase,
-        routing,
-        autoPrefixLinks,
-        overlayBgColor,
-        switcherPosition,
-        switcherOffsetY,
-        switcherTheme,
-        editMode: initialEditMode,
-        editKey,
-        pathNormalization,
-        mode,
-        autoApplyRules,
-    };
-    const setDocumentLocale = useCallback((nextLocale) => {
-        try {
-            const html = document.documentElement;
-            if (!html)
-                return;
-            html.setAttribute("lang", nextLocale);
-            const rtlLocales = new Set(["ar", "he", "fa", "ur"]);
-            html.setAttribute("dir", rtlLocales.has(nextLocale) ? "rtl" : "ltr");
-        }
-        catch {
-            // ignore
-        }
-    }, []);
-    const isSeoActive = useCallback(() => {
-        // Prop can force-disable SEO; server can also disable per project.
-        const serverEnabled = entitlements?.seoEnabled;
-        if (serverEnabled === false)
-            return false;
-        return seo !== false;
-    }, [entitlements, seo]);
-    // Marker engine: always mark full DOM content for deterministic pipeline extraction.
-    useEffect(() => {
-        const stop = startMarkerEngine({ throttleMs: 120 });
-        return () => stop();
-    }, []);
-    useEffect(() => {
-        return () => disablePrehide();
-    }, [disablePrehide]);
-    // Detect locale from URL or localStorage
-    const detectLocale = useCallback(() => {
-        // 1. Check URL first based on routing mode
-        if (routing === 'path') {
-            // Path mode: language is in path (/en/pricing, /fr/about)
-            const pathLocale = window.location.pathname.split('/')[1];
-            if (allLocales.includes(pathLocale)) {
-                return pathLocale;
-            }
-        }
-        else if (routing === 'query') {
-            // Query mode: language is in query param (/pricing?t=fr)
-            const params = new URLSearchParams(window.location.search);
-            const queryLocale = params.get('t') || params.get('locale');
-            if (queryLocale && allLocales.includes(queryLocale)) {
-                return queryLocale;
-            }
-        }
-        // 2. Check localStorage (fallback for all routing modes)
-        try {
-            const storedLocale = localStorage.getItem(LOCALE_STORAGE_KEY);
-            if (storedLocale && allLocales.includes(storedLocale)) {
-                return storedLocale;
-            }
-        }
-        catch (e) {
-            // localStorage might be unavailable (SSR, private browsing)
-            warnDebug('localStorage not available:', e);
-        }
-        // 3. Default locale
-        return defaultLocale;
-    }, [allLocales, defaultLocale, routing]);
-    // Fetch entitlements early so SEO can be enabled even on default locale
-    useEffect(() => {
-        if (locale !== defaultLocale)
-            return;
-        if (entitlements)
-            return;
-        let cancelled = false;
-        (async () => {
-            const bootstrap = await apiRef.current.fetchBootstrap(locale, window.location.pathname + window.location.search);
-            if (cancelled)
-                return;
-            if (bootstrap?.entitlements)
-                setEntitlements(bootstrap.entitlements);
-            if (bootstrap?.loading_bg_color)
-                setCachedLoadingBgColor(bootstrap.loading_bg_color);
-            if (bootstrap?.entitlements?.brandingRequired) {
-                setBrandingEnabled(true);
-                setCachedBrandingEnabled(true);
-            }
-            else if (typeof bootstrap?.branding_enabled === "boolean") {
-                setBrandingEnabled(bootstrap.branding_enabled);
-                setCachedBrandingEnabled(bootstrap.branding_enabled);
-            }
-        })();
-        return () => {
-            cancelled = true;
-        };
-    }, [defaultLocale, entitlements, locale, setCachedBrandingEnabled, setCachedLoadingBgColor]);
-    const applySeoBundle = useCallback((bundle, hreflangEnabled) => {
-        try {
-            const head = document.head;
-            if (!head)
-                return;
-            head.querySelectorAll('link[data-Lovalingo="hreflang"], link[data-Lovalingo="canonical"]').forEach((el) => el.remove());
-            if (!bundle)
-                return;
-            const seo = (bundle?.seo && typeof bundle.seo === "object" ? bundle.seo : {});
-            const alternates = (bundle?.alternates && typeof bundle.alternates === "object" ? bundle.alternates : {});
-            const setOrCreateMeta = (attrs, content) => {
-                const key = attrs.name ? `meta[name="${attrs.name}"]` : attrs.property ? `meta[property="${attrs.property}"]` : "";
-                const selector = key || "meta";
-                const existing = selector ? head.querySelector(selector) : null;
-                const el = existing || document.createElement("meta");
-                for (const [k, v] of Object.entries(attrs)) {
-                    el.setAttribute(k, v);
-                }
-                el.setAttribute("content", content);
-                if (!existing)
-                    head.appendChild(el);
-            };
-            const setOrCreateTitle = (value) => {
-                const existing = head.querySelector("title");
-                if (existing) {
-                    existing.textContent = value;
-                    return;
-                }
-                const el = document.createElement("title");
-                el.textContent = value;
-                head.appendChild(el);
-            };
-            const getString = (value) => (typeof value === "string" && value.trim() ? value.trim() : "");
-            const title = getString(seo.title);
-            if (title)
-                setOrCreateTitle(title);
-            const description = getString(seo.description);
-            if (description)
-                setOrCreateMeta({ name: "description" }, description);
-            const robots = getString(seo.robots);
-            if (robots)
-                setOrCreateMeta({ name: "robots" }, robots);
-            const ogTitle = getString(seo.og_title);
-            if (ogTitle)
-                setOrCreateMeta({ property: "og:title" }, ogTitle);
-            const ogDescription = getString(seo.og_description);
-            if (ogDescription)
-                setOrCreateMeta({ property: "og:description" }, ogDescription);
-            const ogImage = getString(seo.og_image);
-            if (ogImage)
-                setOrCreateMeta({ property: "og:image" }, ogImage);
-            const ogImageAlt = getString(seo.og_image_alt);
-            if (ogImageAlt)
-                setOrCreateMeta({ property: "og:image:alt" }, ogImageAlt);
-            const twitterCard = getString(seo.twitter_card);
-            if (twitterCard)
-                setOrCreateMeta({ name: "twitter:card" }, twitterCard);
-            const twitterTitle = getString(seo.twitter_title);
-            if (twitterTitle)
-                setOrCreateMeta({ name: "twitter:title" }, twitterTitle);
-            const twitterDescription = getString(seo.twitter_description);
-            if (twitterDescription)
-                setOrCreateMeta({ name: "twitter:description" }, twitterDescription);
-            const twitterImage = getString(seo.twitter_image);
-            if (twitterImage)
-                setOrCreateMeta({ name: "twitter:image" }, twitterImage);
-            const twitterImageAlt = getString(seo.twitter_image_alt);
-            if (twitterImageAlt)
-                setOrCreateMeta({ name: "twitter:image:alt" }, twitterImageAlt);
-            const canonicalHref = typeof seo.canonical_url === "string" && seo.canonical_url.trim()
-                ? seo.canonical_url.trim()
-                : typeof alternates.canonical === "string" && alternates.canonical.trim()
-                    ? alternates.canonical.trim()
-                    : "";
-            if (canonicalHref) {
-                const canonical = document.createElement("link");
-                canonical.rel = "canonical";
-                canonical.href = canonicalHref;
-                canonical.setAttribute("data-Lovalingo", "canonical");
-                head.appendChild(canonical);
-            }
-            if (!hreflangEnabled)
-                return;
-            const languages = alternates.languages && typeof alternates.languages === "object" ? alternates.languages : {};
-            for (const [lang, href] of Object.entries(languages)) {
-                if (!href)
-                    continue;
-                const link = document.createElement("link");
-                link.rel = "alternate";
-                link.hreflang = lang;
-                link.href = href;
-                link.setAttribute("data-Lovalingo", "hreflang");
-                head.appendChild(link);
-            }
-            if (alternates.xDefault) {
-                const xDefault = document.createElement("link");
-                xDefault.rel = "alternate";
-                xDefault.hreflang = "x-default";
-                xDefault.href = alternates.xDefault;
-                xDefault.setAttribute("data-Lovalingo", "hreflang");
-                head.appendChild(xDefault);
-            }
-        }
-        catch {
-            // ignore SEO errors
-        }
-    }, []);
-    // Keep <html lang> in sync and apply default-locale SEO (non-default locales use the bootstrap payload).
-    useEffect(() => {
-        setDocumentLocale(locale);
-        if (locale !== defaultLocale)
-            return;
-        if (!isSeoActive())
-            return;
-        void apiRef.current.fetchSeoBundle(locale).then((bundle) => {
-            applySeoBundle(bundle, Boolean(entitlements?.hreflangEnabled));
-        });
-    }, [applySeoBundle, defaultLocale, entitlements, isSeoActive, locale, setDocumentLocale]);
-    const toTranslations = useCallback((map, targetLocale) => {
-        const out = [];
-        for (const [source_text, translated_text] of Object.entries(map || {})) {
-            if (!source_text || !translated_text)
-                continue;
-            out.push({
-                source_text,
-                translated_text,
-                source_locale: defaultLocale,
-                target_locale: targetLocale,
-            });
-        }
-        return out;
-    }, [defaultLocale]);
-    const loadData = useCallback(async (targetLocale, previousLocale) => {
-        // Cancel any pending retry scan to prevent race conditions
-        if (retryTimeoutRef.current) {
-            clearTimeout(retryTimeoutRef.current);
-            retryTimeoutRef.current = null;
-        }
-        if (loadingFailsafeTimeoutRef.current != null) {
-            window.clearTimeout(loadingFailsafeTimeoutRef.current);
-            loadingFailsafeTimeoutRef.current = null;
-        }
-        // If switching to default locale, clear translations and translate with empty map
-        // This will show original text using stored data-Lovalingo-original-html
-        if (targetLocale === defaultLocale) {
-            disablePrehide();
-            setActiveTranslations(null);
-            restoreDom(document.body); // React-safe: only text/attrs, no DOM structure mutation
-            isNavigatingRef.current = false;
-            return;
-        }
-        if (routing === "path") {
-            const stripped = stripLocalePrefix(window.location.pathname, allLocales);
-            if (isNonLocalizedPath(stripped, routingConfig.nonLocalizedPaths)) {
-                // Why: auth/admin (non-localized) routes must never be blocked or mutated by the translation runtime.
-                disablePrehide();
-                setActiveTranslations(null);
-                restoreDom(document.body);
-                isNavigatingRef.current = false;
-                return;
-            }
-        }
-        const currentPath = window.location.pathname + window.location.search;
-        const normalizedPath = processPath(window.location.pathname, enhancedPathConfig);
-        const cacheKey = `${targetLocale}:${normalizedPath}`;
-        if (inFlightLoadKeyRef.current === cacheKey) {
-            return;
-        }
-        inFlightLoadKeyRef.current = cacheKey;
-        // Check if we have cached translations for this locale + path
-        const cachedEntry = translationCacheRef.current.get(cacheKey);
-        const cachedExclusions = exclusionsCacheRef.current;
-        const cachedDomRules = domRulesCacheRef.current.get(cacheKey);
-        if (cachedEntry && cachedExclusions) {
-            // CACHE HIT - Use cached data immediately (FAST!)
-            logDebug(`[Lovalingo] Using cached translations for ${targetLocale} on ${normalizedPath}`);
-            enablePrehide(getCachedLoadingBgColor());
-            setActiveTranslations(cachedEntry.translations);
-            setMarkerEngineExclusions(cachedExclusions);
-            if (mode === 'dom') {
-                applyActiveTranslations(document.body);
-            }
-            if (autoApplyRules) {
-                if (Array.isArray(cachedDomRules)) {
-                    applyDomRules(cachedDomRules);
-                }
-                void (async () => {
-                    const rules = await apiRef.current.fetchDomRules(targetLocale);
-                    domRulesCacheRef.current.set(cacheKey, rules);
-                    applyDomRules(rules);
-                })();
-            }
-            // Delayed retry scan to catch late-rendering content
-            retryTimeoutRef.current = setTimeout(() => {
-                // Don't scan if we're navigating (prevents React conflicts)
-                if (isNavigatingRef.current) {
-                    return;
-                }
-                logDebug(`[Lovalingo] 🔄 Retry scan for late-rendering content`);
-                if (mode === 'dom') {
-                    applyActiveTranslations(document.body);
-                }
-                if (autoApplyRules) {
-                    const rules = domRulesCacheRef.current.get(cacheKey) || cachedDomRules || [];
-                    applyDomRules(rules);
-                }
-            }, 500);
-            disablePrehide();
-            isNavigatingRef.current = false;
-            if (inFlightLoadKeyRef.current === cacheKey) {
-                inFlightLoadKeyRef.current = null;
-            }
-            return;
-        }
-        // CACHE MISS - Fetch from API
-        logDebug(`[Lovalingo] Fetching translations for ${targetLocale} on ${normalizedPath}`);
-        setIsLoading(true);
-        enablePrehide(getCachedLoadingBgColor());
-        // Why: never keep the app hidden/blocked for longer than the UX budget; show the original content if translations aren't ready fast.
-        loadingFailsafeTimeoutRef.current = window.setTimeout(() => {
-            disablePrehide();
-            setIsLoading(false);
-        }, PREHIDE_FAILSAFE_MS);
-        try {
-            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);
-                enablePrehide(cachedCritical.loading_bg_color);
-            }
-            if (cachedCritical?.exclusions && cachedCritical.exclusions.length > 0) {
-                exclusionsCacheRef.current = cachedCritical.exclusions;
-                setMarkerEngineExclusions(cachedCritical.exclusions);
-            }
-            if (cachedCritical?.map && Object.keys(cachedCritical.map).length > 0) {
-                setActiveTranslations(toTranslations(cachedCritical.map, targetLocale));
-                if (mode === "dom") {
-                    applyActiveTranslations(document.body);
-                }
-                disablePrehide();
-                revealedViaCachedCritical = true;
-            }
-            const bootstrap = await apiRef.current.fetchBootstrap(targetLocale, currentPath);
-            const nextEntitlements = bootstrap?.entitlements || apiRef.current.getEntitlements();
-            if (nextEntitlements)
-                setEntitlements(nextEntitlements);
-            if (bootstrap?.loading_bg_color) {
-                setCachedLoadingBgColor(bootstrap.loading_bg_color);
-                enablePrehide(bootstrap.loading_bg_color);
-            }
-            if ((bootstrap?.entitlements || nextEntitlements)?.brandingRequired) {
-                setBrandingEnabled(true);
-                setCachedBrandingEnabled(true);
-            }
-            else if (typeof bootstrap?.branding_enabled === "boolean") {
-                setBrandingEnabled(bootstrap.branding_enabled);
-                setCachedBrandingEnabled(bootstrap.branding_enabled);
-            }
-            const exclusions = Array.isArray(bootstrap?.exclusions)
-                ? bootstrap.exclusions
-                    .map((row) => {
-                    if (!row || typeof row !== "object")
-                        return null;
-                    const r = row;
-                    const selector = typeof r.selector === "string" ? r.selector.trim() : "";
-                    const type = typeof r.type === "string" ? r.type.trim() : "";
-                    if (!selector)
-                        return null;
-                    if (type !== "css" && type !== "xpath")
-                        return null;
-                    return { selector, type: type };
-                })
-                    .filter(Boolean)
-                : await apiRef.current.fetchExclusions();
-            exclusionsCacheRef.current = exclusions;
-            setMarkerEngineExclusions(exclusions);
-            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") {
-                    applyActiveTranslations(document.body);
-                }
-            }
-            if (autoApplyRules) {
-                const domRules = Array.isArray(bootstrap?.dom_rules) ? bootstrap.dom_rules : await apiRef.current.fetchDomRules(targetLocale);
-                domRulesCacheRef.current.set(cacheKey, domRules);
-                applyDomRules(domRules);
-            }
-            if (isSeoActive() && bootstrap) {
-                const hreflangEnabled = Boolean((bootstrap.entitlements || nextEntitlements)?.hreflangEnabled);
-                applySeoBundle({ seo: bootstrap.seo, alternates: bootstrap.alternates, jsonld: bootstrap.jsonld }, hreflangEnabled);
-            }
-            writeCriticalCache(targetLocale, normalizedPath, {
-                map: criticalMap,
-                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(() => {
-                // Don't scan if we're navigating (prevents React conflicts)
-                if (isNavigatingRef.current) {
-                    return;
-                }
-                logDebug(`[Lovalingo] 🔄 Retry scan for late-rendering content`);
-                if (mode === "dom") {
-                    applyActiveTranslations(document.body);
-                }
-                if (autoApplyRules) {
-                    const rules = domRulesCacheRef.current.get(cacheKey) || [];
-                    applyDomRules(rules);
-                }
-            }, 500);
-        }
-        catch (error) {
-            errorDebug('Error loading translations:', error);
-            disablePrehide();
-        }
-        finally {
-            setIsLoading(false);
-            if (loadingFailsafeTimeoutRef.current != null) {
-                window.clearTimeout(loadingFailsafeTimeoutRef.current);
-                loadingFailsafeTimeoutRef.current = null;
-            }
-            isNavigatingRef.current = false;
-            if (inFlightLoadKeyRef.current === cacheKey) {
-                inFlightLoadKeyRef.current = null;
-            }
-        }
-    }, [
-        applySeoBundle,
-        allLocales,
-        autoApplyRules,
-        defaultLocale,
-        disablePrehide,
-        enablePrehide,
-        enhancedPathConfig,
-        getCachedLoadingBgColor,
-        isSeoActive,
-        mode,
-        readCriticalCache,
-        routing,
-        routingConfig.nonLocalizedPaths,
-        setCachedLoadingBgColor,
-        toTranslations,
-        writeCriticalCache,
-    ]);
-    useEffect(() => {
-        onNavigateRef.current = () => {
-            trackPageviewOnce(window.location.pathname + window.location.search);
-            const nextLocale = detectLocale();
-            const normalizedPath = processPath(window.location.pathname, enhancedPathConfig);
-            const normalizedPathChanged = normalizedPath !== lastNormalizedPathRef.current;
-            lastNormalizedPathRef.current = normalizedPath;
-            // Why: bundles are path-scoped, so SPA navigations within the same locale must trigger a reload for the new route.
-            if (normalizedPathChanged && nextLocale !== defaultLocale && !isInternalNavigationRef.current) {
-                void loadData(nextLocale, locale);
-                return;
-            }
-            if (nextLocale !== locale) {
-                setLocaleState(nextLocale);
-                if (!isInternalNavigationRef.current) {
-                    void loadData(nextLocale, locale);
-                }
-            }
-            else if (mode === "dom" && nextLocale !== defaultLocale) {
-                applyActiveTranslations(document.body);
-            }
-        };
-    }, [defaultLocale, detectLocale, enhancedPathConfig, loadData, locale, mode, trackPageviewOnce]);
-    // SPA router hook-in: patch History API once (prevents stacked wrappers → request storms).
-    useEffect(() => {
-        if (typeof window === "undefined")
-            return;
-        if (historyPatchedRef.current)
-            return;
-        historyPatchedRef.current = true;
-        const historyObj = window.history;
-        const originalPushState = historyObj.pushState.bind(historyObj);
-        const originalReplaceState = historyObj.replaceState.bind(historyObj);
-        originalHistoryRef.current = { pushState: originalPushState, replaceState: originalReplaceState };
-        const safeOnNavigate = () => {
-            try {
-                onNavigateRef.current();
-            }
-            catch {
-                // ignore
-            }
-        };
-        historyObj.pushState = ((...args) => {
-            const ret = originalPushState(...args);
-            safeOnNavigate();
-            return ret;
-        });
-        historyObj.replaceState = ((...args) => {
-            const ret = originalReplaceState(...args);
-            safeOnNavigate();
-            return ret;
-        });
-        window.addEventListener("popstate", safeOnNavigate);
-        window.addEventListener("hashchange", safeOnNavigate);
-        return () => {
-            const originals = originalHistoryRef.current;
-            if (originals) {
-                historyObj.pushState = originals.pushState;
-                historyObj.replaceState = originals.replaceState;
-            }
-            window.removeEventListener("popstate", safeOnNavigate);
-            window.removeEventListener("hashchange", safeOnNavigate);
-            originalHistoryRef.current = null;
-            historyPatchedRef.current = false;
-        };
-    }, []);
-    // Change locale
-    const setLocale = useCallback((newLocale) => {
-        void (async () => {
-            if (!allLocales.includes(newLocale))
-                return;
-            const previousLocale = locale; // Capture current locale before switching
-            // Save to localStorage
-            try {
-                localStorage.setItem(LOCALE_STORAGE_KEY, newLocale);
-            }
-            catch (e) {
-                warnDebug('Failed to save locale to localStorage:', e);
-            }
-            isInternalNavigationRef.current = true;
-            // Prevent MutationObserver work during the switch to avoid React conflicts
-            isNavigatingRef.current = true;
-            // Update URL based on routing strategy
-            if (routing === 'path') {
-                const stripped = stripLocalePrefix(window.location.pathname, allLocales);
-                if (isNonLocalizedPath(stripped, routingConfig.nonLocalizedPaths)) {
-                    // Why: switching languages must not rewrite non-localized routes like "/auth" to "/de/auth".
-                    setLocaleState(newLocale);
-                    isNavigatingRef.current = false;
-                    return;
-                }
-                const pathParts = window.location.pathname.split('/').filter(Boolean);
-                // Strip existing locale
-                if (allLocales.includes(pathParts[0])) {
-                    pathParts.shift();
-                }
-                // Build new path with new locale
-                const basePath = pathParts.join('/');
-                const newPath = `/${newLocale}${basePath ? '/' + basePath : ''}${window.location.search}${window.location.hash}`;
-                // Prefer React Router navigation when available, but gracefully fallback for non-React-Router apps
-                const navigate = navigateRef?.current;
-                if (navigate) {
-                    navigate(newPath);
-                }
-                else {
-                    try {
-                        window.history.pushState({}, '', newPath);
-                    }
-                    catch {
-                        window.location.assign(newPath);
-                    }
-                }
-            }
-            else if (routing === 'query') {
-                const url = new URL(window.location.href);
-                url.searchParams.set('t', newLocale);
-                window.history.pushState({}, '', url.toString());
-            }
-            setLocaleState(newLocale);
-            await loadData(newLocale, previousLocale);
-        })().finally(() => {
-            isInternalNavigationRef.current = false;
-        });
-    }, [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 = 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).
-        loadDataRef.current(initialLocale);
-        // Set up keyboard shortcut for edit mode
-        const handleKeyPress = (e) => {
-            if (e.code === editKey && (e.ctrlKey || e.metaKey)) {
-                e.preventDefault();
-                setEditMode(prev => !prev);
-            }
-        };
-        window.addEventListener('keydown', handleKeyPress);
-        return () => {
-            window.removeEventListener('keydown', handleKeyPress);
-            // Clean up pending retry timeout
-            if (retryTimeoutRef.current) {
-                clearTimeout(retryTimeoutRef.current);
-            }
-        };
-    }, [editKey, enhancedPathConfig, trackPageviewOnce]);
-    // Auto-inject sitemap link tag
-    useEffect(() => {
-        if (sitemap && resolvedApiKey && isSeoActive()) {
-            // Prefer same-origin /sitemap.xml so crawlers discover the canonical sitemap URL.
-            // Reminder: /sitemap.xml should be published by the host app (recommended: build-time copy from Lovalingo CDN).
-            const sitemapUrl = `${window.location.origin}/sitemap.xml`;
-            // Check if link already exists to avoid duplicates
-            const existingLink = document.querySelector(`link[rel="sitemap"][href="${sitemapUrl}"]`);
-            if (existingLink)
-                return;
-            // Create and inject link tag
-            const link = document.createElement('link');
-            link.rel = 'sitemap';
-            link.type = 'application/xml';
-            link.href = sitemapUrl;
-            document.head.appendChild(link);
-            // Cleanup on unmount
-            return () => {
-                const linkToRemove = document.querySelector(`link[rel="sitemap"][href="${sitemapUrl}"]`);
-                if (linkToRemove) {
-                    document.head.removeChild(linkToRemove);
-                }
-            };
-        }
-    }, [sitemap, resolvedApiKey, apiBase, isSeoActive]);
-    // PATH mode: auto-prefix internal links that are missing a locale segment.
-    // This prevents "losing" the current locale when the app renders absolute links like "/projects/slug"
-    // while the user is on "/de/...".
-    useEffect(() => {
-        if (routing !== 'path')
-            return;
-        if (!autoPrefixLinks)
-            return;
-        const supportedLocales = allLocales;
-        const shouldProcessCurrentPath = () => {
-            const parts = window.location.pathname.split('/').filter(Boolean);
-            return parts.length > 0 && supportedLocales.includes(parts[0]);
-        };
-        const buildLocalePrefixedPath = (rawHref) => {
-            if (!rawHref)
-                return null;
-            const trimmed = rawHref.trim();
-            if (!trimmed)
-                return null;
-            // Only rewrite absolute-path or same-origin absolute URLs.
-            const isAbsolutePath = trimmed.startsWith('/');
-            const isAbsoluteUrl = /^https?:\/\//i.test(trimmed) || trimmed.startsWith('//');
-            if (!isAbsolutePath && !isAbsoluteUrl)
-                return null;
-            // Ignore special schemes / fragments
-            if (/^(?:#|mailto:|tel:|sms:|javascript:)/i.test(trimmed))
-                return null;
-            let url;
-            try {
-                url = new URL(trimmed, window.location.origin);
-            }
-            catch {
-                return null;
-            }
-            if (url.origin !== window.location.origin)
-                return null;
-            if (isNonLocalizedPath(url.pathname, routingConfig.nonLocalizedPaths))
-                return null;
-            const parts = url.pathname.split('/').filter(Boolean);
-            // Root ("/") should be locale-prefixed too (e.g. clicking a logo linking to "https://example.com")
-            // when we are currently on a locale URL like "/de/...".
-            if (parts.length === 0) {
-                return `/${locale}${url.search}${url.hash}`;
-            }
-            if (supportedLocales.includes(parts[0]))
-                return null; // already locale-prefixed
-            const pathWithoutLeadingSlashes = url.pathname.replace(/^\/+/, '');
-            const nextPathname = pathWithoutLeadingSlashes
-                ? `/${locale}/${pathWithoutLeadingSlashes}`
-                : `/${locale}`;
-            return `${nextPathname}${url.search}${url.hash}`;
-        };
-        const ORIGINAL_HREF_KEY = 'data-Lovalingo-href-original';
-        const patchAnchor = (a) => {
-            if (!a || a.hasAttribute('data-Lovalingo-exclude'))
-                return;
-            const original = a.getAttribute(ORIGINAL_HREF_KEY) ?? a.getAttribute('href') ?? '';
-            if (!a.getAttribute(ORIGINAL_HREF_KEY) && original) {
-                a.setAttribute(ORIGINAL_HREF_KEY, original);
-            }
-            const fixed = buildLocalePrefixedPath(original);
-            if (fixed) {
-                if (a.getAttribute('href') !== fixed)
-                    a.setAttribute('href', fixed);
-            }
-            else if (original) {
-                // If we previously rewrote it, restore the original when it no longer applies.
-                if (a.getAttribute('href') !== original)
-                    a.setAttribute('href', original);
-            }
-        };
-        const patchAllAnchors = () => {
-            if (!shouldProcessCurrentPath())
-                return;
-            document.querySelectorAll('a[href]').forEach((node) => {
-                if (node instanceof HTMLAnchorElement)
-                    patchAnchor(node);
-            });
-        };
-        // Patch existing anchors (also updates when locale changes)
-        patchAllAnchors();
-        // Patch new anchors when the DOM changes
-        const mo = new MutationObserver((mutations) => {
-            if (!shouldProcessCurrentPath())
-                return;
-            for (const mutation of mutations) {
-                mutation.addedNodes.forEach((node) => {
-                    if (!(node instanceof HTMLElement))
-                        return;
-                    if (node instanceof HTMLAnchorElement) {
-                        patchAnchor(node);
-                        return;
-                    }
-                    node.querySelectorAll?.('a[href]').forEach((a) => {
-                        if (a instanceof HTMLAnchorElement)
-                            patchAnchor(a);
-                    });
-                });
-            }
-        });
-        mo.observe(document.body, { childList: true, subtree: true });
-        // Click interception (capture) to handle cases where frameworks (e.g. React Router <Link>)
-        // navigate based on their "to" prop rather than the DOM href attribute.
-        const onClickCapture = (event) => {
-            if (!shouldProcessCurrentPath())
-                return;
-            if (event.defaultPrevented)
-                return;
-            if (event.button !== 0)
-                return;
-            if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)
-                return;
-            const target = event.target;
-            const a = target?.closest?.('a[href]');
-            if (!a)
-                return;
-            // Let the browser handle new tabs/downloads/etc.
-            if (a.target && a.target !== '_self')
-                return;
-            if (a.hasAttribute('download'))
-                return;
-            if (a.getAttribute('rel')?.includes('external'))
-                return;
-            const original = a.getAttribute(ORIGINAL_HREF_KEY) ?? a.getAttribute('href') ?? '';
-            const fixed = buildLocalePrefixedPath(original);
-            if (!fixed)
-                return;
-            event.preventDefault();
-            event.stopImmediatePropagation();
-            event.stopPropagation();
-            const navigate = navigateRef?.current;
-            if (navigate) {
-                navigate(fixed);
-            }
-            else {
-                window.location.assign(fixed);
-            }
-        };
-        document.addEventListener('click', onClickCapture, true);
-        return () => {
-            mo.disconnect();
-            document.removeEventListener('click', onClickCapture, true);
-        };
-    }, [routing, autoPrefixLinks, allLocales, locale, navigateRef, routingConfig.nonLocalizedPaths]);
-    // Navigation prefetch: warm the HTTP cache for bootstrap + page bundle before the user clicks (reduces EN→FR flash on SPA route changes).
-    useEffect(() => {
-        if (!resolvedApiKey)
-            return;
-        if (typeof window === "undefined" || typeof document === "undefined")
-            return;
-        const connection = navigator?.connection;
-        if (connection?.saveData)
-            return;
-        if (typeof connection?.effectiveType === "string" && /(^|-)2g$/.test(connection.effectiveType))
-            return;
-        const prefetched = new Set();
-        // Why: cap speculative requests to avoid flooding the network on pages with many links.
-        const maxPrefetch = 40;
-        const isAssetPath = (pathname) => {
-            if (pathname === "/robots.txt" || pathname === "/sitemap.xml")
-                return true;
-            if (pathname.startsWith("/.well-known/"))
-                return true;
-            return /\.(?:png|jpg|jpeg|gif|svg|webp|avif|ico|css|js|map|json|xml|txt|pdf|zip|gz|br|woff2?|ttf|eot)$/i.test(pathname);
-        };
-        const pickLocaleForUrl = (url) => {
-            if (routing === "path") {
-                const segment = url.pathname.split("/")[1] || "";
-                if (segment && allLocales.includes(segment))
-                    return segment;
-                return locale;
-            }
-            const q = url.searchParams.get("t") || url.searchParams.get("locale");
-            if (q && allLocales.includes(q))
-                return q;
-            return locale;
-        };
-        const onIntent = (event) => {
-            if (prefetched.size >= maxPrefetch)
-                return;
-            const target = event.target;
-            const anchor = target?.closest?.("a[href]");
-            if (!anchor)
-                return;
-            const href = anchor.getAttribute("href") || "";
-            if (!href || /^(?:#|mailto:|tel:|sms:|javascript:)/i.test(href))
-                return;
-            let url;
-            try {
-                url = new URL(href, window.location.origin);
-            }
-            catch {
-                return;
-            }
-            if (url.origin !== window.location.origin)
-                return;
-            if (isAssetPath(url.pathname))
-                return;
-            const targetLocale = pickLocaleForUrl(url);
-            if (!targetLocale || targetLocale === defaultLocale)
-                return;
-            const normalizedPath = processPath(url.pathname, enhancedPathConfig);
-            const key = `${targetLocale}:${normalizedPath}`;
-            if (prefetched.has(key))
-                return;
-            prefetched.add(key);
-            const pathParam = `${url.pathname}${url.search}`;
-            const bootstrapUrl = `${apiBase}/functions/v1/bootstrap?key=${encodeURIComponent(resolvedApiKey)}&locale=${encodeURIComponent(targetLocale)}&path=${encodeURIComponent(pathParam)}`;
-            const bundleUrl = `${apiBase}/functions/v1/bundle?key=${encodeURIComponent(resolvedApiKey)}&locale=${encodeURIComponent(targetLocale)}&path=${encodeURIComponent(pathParam)}`;
-            void fetch(bootstrapUrl, { cache: "force-cache" }).catch(() => undefined);
-            void fetch(bundleUrl, { cache: "force-cache" }).catch(() => undefined);
-        };
-        document.addEventListener("pointerover", onIntent, { passive: true });
-        document.addEventListener("touchstart", onIntent, { passive: true });
-        document.addEventListener("focusin", onIntent);
-        return () => {
-            document.removeEventListener("pointerover", onIntent);
-            document.removeEventListener("touchstart", onIntent);
-            document.removeEventListener("focusin", onIntent);
-        };
-    }, [allLocales, apiBase, defaultLocale, enhancedPathConfig, locale, resolvedApiKey, routing]);
-    // Dynamic DOM updates are handled by the marker engine observer (React-safe in-place text/attr updates).
-    // No periodic string-miss reporting. Page discovery is tracked via pageview only.
-    const translateElement = useCallback((element) => {
-        if (mode !== "dom")
-            return;
-        applyActiveTranslations(element);
-    }, []);
-    const translateDOM = useCallback(() => {
-        if (mode !== "dom")
-            return;
-        applyActiveTranslations(document.body);
-    }, []);
-    const toggleEditMode = useCallback(() => {
-        setEditMode(prev => !prev);
-    }, []);
-    const excludeElement = useCallback(async (selector) => {
-        await apiRef.current.saveExclusion(selector, 'css');
-        const exclusions = await apiRef.current.fetchExclusions();
-        setMarkerEngineExclusions(exclusions);
-    }, []);
-    const contextValue = {
-        locale,
-        setLocale,
-        isLoading,
-        translationMap: {},
-        config,
-        translateElement,
-        translateDOM,
-        editMode,
-        toggleEditMode,
-        excludeElement,
-    };
-    return (React.createElement(LovalingoContext.Provider, { value: contextValue },
-        children,
-        (() => {
-            if (routing !== "path")
-                return true;
-            if (typeof window === "undefined")
-                return true;
-            const stripped = stripLocalePrefix(window.location.pathname, allLocales);
-            return !isNonLocalizedPath(stripped, routingConfig.nonLocalizedPaths);
-        })() && (React.createElement(LanguageSwitcher, { locales: allLocales, currentLocale: locale, onLocaleChange: setLocale, position: switcherPosition, offsetY: switcherOffsetY, theme: switcherTheme, branding: {
-                required: Boolean(entitlements?.brandingRequired),
-                enabled: brandingEnabled,
-                href: "https://lovalingo.com",
-            } }))));
-};
+export { LovalingoProvider } from "./LovalingoProvider";