@lovalingo/lovalingo 0.0.27 → 0.0.29

package/README.md

@@ -12,6 +12,8 @@ npm install @lovalingo/lovalingo react-router-dom
 
 ## Quick Start
 
+Lovalingo **erzeugt Übersetzungen nicht im Browser**. Die Runtime lädt fertige Artefakte (JSON‑Bundle + DOM‑Rules) vom Backend; die server‑seitige Pipeline rendert Seiten, extrahiert Marker/Strings, übersetzt deterministisch und erzeugt bei Bedarf DOM‑Fixes.
+
 ### Option 1: Path Mode (Recommended - Automatic Language URLs)
 
 **One-line setup** that automatically handles language routing like `/en/pricing`, `/fr/pricing`, `/de/pricing`:
@@ -165,7 +167,10 @@ Then you may omit `publicAnonKey` and Lovalingo will read it from the meta tag o
   - Automatic language routing
   - SEO-optimized URLs
   - Non-localized by default: `/auth`, `/login`, `/signup` (no `/:lang/` prefix)
-  - See [PATH_EXAMPLES.md](./PATH_EXAMPLES.md) for detailed examples
+  - Examples:
+    - `/en/` → English home
+    - `/de/pricing` → German pricing
+    - `/fr/about` → French about
 
 ## Path Mode Helpers (v0.0.x+)
 

package/dist/components/AixsterProvider.d.ts

@@ -6,22 +6,5 @@ interface LovalingoProviderProps extends LovalingoConfig {
     seo?: boolean;
     navigateRef?: React.MutableRefObject<((path: string) => void) | undefined>;
 }
-type LovalingoSeleniumBridge = {
-    getStatus: () => {
-        mode: LovalingoConfig["mode"];
-        locale: string;
-        defaultLocale: string;
-        path: string;
-        missed: number;
-    };
-    flushMisses: () => Promise<{
-        reported: number;
-        locale: string;
-        path: string;
-    }>;
-};
-declare global {
-    var __LOVALINGO_SELENIUM__: LovalingoSeleniumBridge | undefined;
-}
 export declare const LovalingoProvider: React.FC<LovalingoProviderProps>;
 export {};

package/dist/components/AixsterProvider.js

@@ -57,17 +57,12 @@ navigateRef, // For path mode routing
     const apiRef = useRef(new LovalingoAPI(resolvedApiKey, apiBase, enhancedPathConfig));
     const [entitlements, setEntitlements] = useState(() => apiRef.current.getEntitlements());
     const observerRef = useRef(null);
-    const missReportIntervalRef = useRef(null);
     const retryTimeoutRef = useRef(null);
     const isNavigatingRef = useRef(false);
     const isInternalNavigationRef = useRef(false);
     const translationCacheRef = useRef(new Map());
     const exclusionsCacheRef = useRef(null);
     const domRulesCacheRef = useRef(new Map());
-    // NEW: Hash-based translation cache for React Context system
-    const [hashTranslations, setHashTranslations] = useState(new Map());
-    const contextMissQueueRef = useRef(new Set());
-    const contextMissFlushTimeoutRef = useRef(null);
     const config = {
         apiKey: resolvedApiKey,
         publicAnonKey: resolvedApiKey,
@@ -104,77 +99,114 @@ navigateRef, // For path mode routing
             return false;
         return seo !== false;
     }, [entitlements, seo]);
-    const updateSeoLinks = useCallback((activeLocale, hreflangEnabled) => {
+    const updateSeoLinks = useCallback(async (activeLocale, hreflangEnabled) => {
         try {
             const head = document.head;
             if (!head)
                 return;
-            // Remove old links inserted by Lovalingo
             head.querySelectorAll('link[data-Lovalingo="hreflang"], link[data-Lovalingo="canonical"]').forEach((el) => el.remove());
             if (!isSeoActive())
                 return;
-            const all = allLocales;
-            const url = new URL(window.location.href);
-            // Derive a locale-neutral base pathname for path routing
-            let basePathname = url.pathname;
-            if (routing === "path") {
-                const parts = basePathname.split("/").filter(Boolean);
-                if (parts.length > 0 && all.includes(parts[0])) {
-                    parts.shift();
+            const bundle = await apiRef.current.fetchSeoBundle(activeLocale);
+            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);
                 }
-                basePathname = "/" + parts.join("/");
-                if (basePathname === "/") {
-                    // ok
-                }
-                else if (basePathname.endsWith("/") && basePathname.length > 1) {
-                    basePathname = basePathname.slice(0, -1);
-                }
-            }
-            const buildUrlForLocale = (localeForUrl) => {
-                const next = new URL(window.location.origin + basePathname + url.search + url.hash);
-                if (routing === "path") {
-                    const path = basePathname === "/" ? "" : basePathname;
-                    next.pathname = localeForUrl === defaultLocale ? `${path || "/"}` : `/${localeForUrl}${path}`;
-                    return next.toString();
-                }
-                // Query mode: keep pathname, set/remove locale param
-                next.searchParams.delete("t");
-                next.searchParams.delete("locale");
-                if (localeForUrl !== defaultLocale) {
-                    next.searchParams.set("t", localeForUrl);
+                el.setAttribute("content", content);
+                if (!existing)
+                    head.appendChild(el);
+            };
+            const setOrCreateTitle = (value) => {
+                const existing = head.querySelector("title");
+                if (existing) {
+                    existing.textContent = value;
+                    return;
                 }
-                return next.toString();
+                const el = document.createElement("title");
+                el.textContent = value;
+                head.appendChild(el);
             };
-            // Canonical should point to the current locale variant
-            const canonicalHref = buildUrlForLocale(activeLocale);
-            const canonical = document.createElement("link");
-            canonical.rel = "canonical";
-            canonical.href = canonicalHref;
-            canonical.setAttribute("data-Lovalingo", "canonical");
-            head.appendChild(canonical);
+            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;
-            // hreflang alternates for each locale
-            all.forEach((loc) => {
+            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 = loc;
-                link.href = buildUrlForLocale(loc);
+                link.hreflang = lang;
+                link.href = href;
                 link.setAttribute("data-Lovalingo", "hreflang");
                 head.appendChild(link);
-            });
-            // x-default -> default locale
-            const xDefault = document.createElement("link");
-            xDefault.rel = "alternate";
-            xDefault.hreflang = "x-default";
-            xDefault.href = buildUrlForLocale(defaultLocale);
-            xDefault.setAttribute("data-Lovalingo", "hreflang");
-            head.appendChild(xDefault);
+            }
+            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 (e) {
             console.warn("[Lovalingo] updateSeoLinks() failed:", e);
         }
-    }, [allLocales, defaultLocale, routing, isSeoActive]);
+    }, [isSeoActive]);
     // Detect locale from URL or localStorage
     const detectLocale = useCallback(() => {
         // 1. Check URL first based on routing mode
@@ -222,7 +254,7 @@ navigateRef, // For path mode routing
     // Keep <html lang> + canonical/hreflang in sync with routing + entitlements
     useEffect(() => {
         setDocumentLocale(locale);
-        updateSeoLinks(locale, Boolean(entitlements?.hreflangEnabled));
+        void updateSeoLinks(locale, Boolean(entitlements?.hreflangEnabled));
     }, [locale, entitlements, setDocumentLocale, updateSeoLinks]);
     // Load translations and exclusions
     const loadData = useCallback(async (targetLocale, previousLocale, showOverlay = false) => {
@@ -236,10 +268,8 @@ navigateRef, // For path mode routing
         if (targetLocale === defaultLocale) {
             if (showOverlay)
                 setIsNavigationLoading(false);
-            setHashTranslations(new Map());
             translatorRef.current.setTranslations([]);
             translatorRef.current.restoreDOM(); // Safe to restore when going back to source language
-            translatorRef.current.restoreHead();
             isNavigatingRef.current = false;
             return;
         }
@@ -253,15 +283,11 @@ navigateRef, // For path mode routing
         if (cachedEntry && cachedExclusions) {
             // CACHE HIT - Use cached data immediately (FAST!)
             console.log(`[Lovalingo] Using cached translations for ${targetLocale} on ${currentPath}`);
-            setHashTranslations(new Map(Object.entries(cachedEntry.hashMap || {})));
             translatorRef.current.setTranslations(cachedEntry.translations);
             translatorRef.current.setExclusions(cachedExclusions);
             if (mode === 'dom') {
                 translatorRef.current.translateDOM();
             }
-            if (isSeoActive()) {
-                translatorRef.current.translateHead();
-            }
             if (autoApplyRules) {
                 if (Array.isArray(cachedDomRules)) {
                     applyDomRules(cachedDomRules);
@@ -282,25 +308,10 @@ navigateRef, // For path mode routing
                 if (mode === 'dom') {
                     translatorRef.current.translateDOM();
                 }
-                if (isSeoActive()) {
-                    translatorRef.current.translateHead();
-                }
                 if (autoApplyRules) {
                     const rules = domRulesCacheRef.current.get(cacheKey) || cachedDomRules || [];
                     applyDomRules(rules);
                 }
-                if (mode === "dom") {
-                    // Immediately report any misses found
-                    const missed = translatorRef.current.getMissedStrings();
-                    if (missed.length > 0) {
-                        console.log(`[Lovalingo] 📤 Reporting ${missed.length} misses immediately`);
-                        apiRef.current.reportMisses(missed, defaultLocale, targetLocale);
-                        translatorRef.current.clearMissedStrings();
-                    }
-                    else {
-                        console.log(`[Lovalingo] ✅ No misses detected`);
-                    }
-                }
             }, 500);
             if (showOverlay) {
                 setTimeout(() => setIsNavigationLoading(false), 50);
@@ -331,10 +342,8 @@ navigateRef, // For path mode routing
                     target_locale: targetLocale,
                 }))
                 : [];
-            const hashMap = bundle?.hashMap || {};
-            setHashTranslations(new Map(Object.entries(hashMap)));
             // Store in cache for next time
-            translationCacheRef.current.set(cacheKey, { translations, hashMap });
+            translationCacheRef.current.set(cacheKey, { translations });
             exclusionsCacheRef.current = exclusions;
             if (autoApplyRules) {
                 domRulesCacheRef.current.set(cacheKey, domRules);
@@ -344,9 +353,6 @@ navigateRef, // For path mode routing
             if (mode === 'dom') {
                 translatorRef.current.translateDOM();
             }
-            if (isSeoActive()) {
-                translatorRef.current.translateHead();
-            }
             if (autoApplyRules) {
                 applyDomRules(domRules);
             }
@@ -360,25 +366,10 @@ navigateRef, // For path mode routing
                 if (mode === "dom") {
                     translatorRef.current.translateDOM();
                 }
-                if (isSeoActive()) {
-                    translatorRef.current.translateHead();
-                }
                 if (autoApplyRules) {
                     const rules = domRulesCacheRef.current.get(cacheKey) || domRules || [];
                     applyDomRules(rules);
                 }
-                if (mode === "dom") {
-                    // Immediately report any misses found
-                    const missed = translatorRef.current.getMissedStrings();
-                    if (missed.length > 0) {
-                        console.log(`[Lovalingo] 📤 Reporting ${missed.length} misses immediately`);
-                        apiRef.current.reportMisses(missed, defaultLocale, targetLocale);
-                        translatorRef.current.clearMissedStrings();
-                    }
-                    else {
-                        console.log(`[Lovalingo] ✅ No misses detected`);
-                    }
-                }
             }, 500);
             if (showOverlay) {
                 setTimeout(() => setIsNavigationLoading(false), 100);
@@ -450,66 +441,7 @@ navigateRef, // For path mode routing
             isInternalNavigationRef.current = false;
         });
     }, [allLocales, locale, routing, loadData, defaultLocale, navigateRef]);
-    // NEW: Get translation by hash (for React Context system)
-    const getTranslation = useCallback((hash, fallback) => {
-        return hashTranslations.get(hash) || null;
-    }, [hashTranslations]);
-    const queueMiss = useCallback((text) => {
-        const cleaned = (text || "").toString().trim();
-        if (!cleaned || cleaned.length < 2)
-            return;
-        if (locale === defaultLocale)
-            return;
-        contextMissQueueRef.current.add(cleaned);
-        if (contextMissFlushTimeoutRef.current)
-            return;
-        contextMissFlushTimeoutRef.current = setTimeout(() => {
-            contextMissFlushTimeoutRef.current = null;
-            const batch = Array.from(contextMissQueueRef.current);
-            contextMissQueueRef.current.clear();
-            if (batch.length === 0)
-                return;
-            const misses = batch.map((value) => ({
-                text: value,
-                raw: value,
-                placeholderMap: {},
-                semanticContext: "react",
-            }));
-            void apiRef.current.reportMisses(misses, defaultLocale, locale);
-        }, 800);
-    }, [defaultLocale, locale]);
-    // Selenium bridge: allows automation to force-flush misses instead of relying on the 5s interval.
-    useEffect(() => {
-        if (typeof window === "undefined")
-            return;
-        const bridge = {
-            getStatus: () => ({
-                mode,
-                locale,
-                defaultLocale,
-                path: window.location.pathname + window.location.search,
-                missed: translatorRef.current.getMissedStrings().length,
-            }),
-            flushMisses: async () => {
-                // Only flush in DOM mode + non-default locale, matching the normal periodic reporter.
-                if (mode !== "dom" || locale === defaultLocale) {
-                    return { reported: 0, locale, path: window.location.pathname + window.location.search };
-                }
-                const missed = translatorRef.current.getMissedStrings();
-                if (missed.length > 0) {
-                    await apiRef.current.reportMisses(missed, defaultLocale, locale);
-                    translatorRef.current.clearMissedStrings();
-                }
-                return { reported: missed.length, locale, path: window.location.pathname + window.location.search };
-            },
-        };
-        globalThis.__LOVALINGO_SELENIUM__ = bridge;
-        return () => {
-            if (globalThis.__LOVALINGO_SELENIUM__ === bridge) {
-                delete globalThis.__LOVALINGO_SELENIUM__;
-            }
-        };
-    }, [defaultLocale, locale, mode]);
+    // No string-level "misses" from the client: the pipeline (Browser Rendering) is source-of-truth for string discovery.
     // Initialize
     useEffect(() => {
         const initialLocale = detectLocale();
@@ -521,7 +453,7 @@ navigateRef, // For path mode routing
             if (next)
                 setEntitlements(next);
         });
-        // Always prefetch artifacts for the initial locale so context mode has hashMap ready.
+        // Always prefetch artifacts for the initial locale (pipeline-produced translations + rules).
         loadData(initialLocale);
         // Set up keyboard shortcut for edit mode
         const handleKeyPress = (e) => {
@@ -566,7 +498,6 @@ navigateRef, // For path mode routing
     }, [sitemap, resolvedApiKey, apiBase, isSeoActive]);
     // Watch for route changes (browser back/forward + SPA navigation)
     useEffect(() => {
-        let navigationTimeout = null;
         const handlePopState = () => {
             if (isInternalNavigationRef.current)
                 return;
@@ -581,16 +512,11 @@ navigateRef, // For path mode routing
             isNavigatingRef.current = true;
             if (newLocale !== locale) {
                 setLocaleState(newLocale);
-                // Clear any pending navigation
-                if (navigationTimeout)
-                    clearTimeout(navigationTimeout);
                 // Load translations immediately (no delay needed with overlay)
                 loadData(newLocale, previousLocale, true);
             }
             else if (locale !== defaultLocale) {
                 // Same locale but NEW PATH - fetch translations for this path
-                if (navigationTimeout)
-                    clearTimeout(navigationTimeout);
                 // Load translations immediately (no delay needed with overlay)
                 loadData(locale, previousLocale, true);
             }
@@ -614,9 +540,6 @@ navigateRef, // For path mode routing
             }
             // SET NAVIGATION FLAG (MutationObserver callback will ignore while navigating)
             isNavigatingRef.current = true;
-            // Clear any pending navigation translation
-            if (navigationTimeout)
-                clearTimeout(navigationTimeout);
             if (newLocale !== locale) {
                 setLocaleState(newLocale);
                 // Load translations immediately (no delay needed with overlay)
@@ -645,8 +568,6 @@ navigateRef, // For path mode routing
             window.removeEventListener('popstate', handlePopState);
             history.pushState = originalPushState;
             history.replaceState = originalReplaceState;
-            if (navigationTimeout)
-                clearTimeout(navigationTimeout);
         };
     }, [locale, detectLocale, loadData, defaultLocale]);
     // PATH mode: auto-prefix internal links that are missing a locale segment.
@@ -784,7 +705,7 @@ navigateRef, // For path mode routing
             if (!fixed)
                 return;
             event.preventDefault();
-            event.stopImmediatePropagation?.();
+            event.stopImmediatePropagation();
             event.stopPropagation();
             const navigate = navigateRef?.current;
             if (navigate) {
@@ -838,26 +759,7 @@ navigateRef, // For path mode routing
             observerRef.current = null;
         };
     }, [locale, defaultLocale, mode]);
-    // Report missed strings periodically (DOM mode only)
-    useEffect(() => {
-        if (mode !== 'dom')
-            return; // Skip for context mode
-        if (locale === defaultLocale)
-            return;
-        const interval = setInterval(() => {
-            const missed = translatorRef.current.getMissedStrings();
-            if (missed.length > 0) {
-                apiRef.current.reportMisses(missed, defaultLocale, locale);
-                translatorRef.current.clearMissedStrings();
-            }
-        }, 5000);
-        missReportIntervalRef.current = interval;
-        return () => {
-            if (missReportIntervalRef.current) {
-                clearInterval(missReportIntervalRef.current);
-            }
-        };
-    }, [locale, defaultLocale, mode]);
+    // No periodic string-miss reporting. Page discovery is tracked via pageview only.
     const translateElement = useCallback((element) => {
         translatorRef.current.translateElement(element);
     }, []);
@@ -883,8 +785,6 @@ navigateRef, // For path mode routing
         editMode,
         toggleEditMode,
         excludeElement,
-        getTranslation,
-        queueMiss,
     };
     return (React.createElement(LovalingoContext.Provider, { value: contextValue },
         children,

package/dist/components/NavigationOverlay.js

@@ -8,37 +8,15 @@ export const NavigationOverlay = ({ isVisible }) => {
             left: 0,
             right: 0,
             bottom: 0,
-            backdropFilter: 'blur(4px)',
-            WebkitBackdropFilter: 'blur(4px)',
+            backdropFilter: 'blur(3px)',
+            WebkitBackdropFilter: 'blur(3px)',
+            // Keep a tiny alpha background to ensure the element paints (some browsers won't apply backdrop-filter otherwise).
+            backgroundColor: 'rgba(255, 255, 255, 0.01)',
             zIndex: 9999,
-            display: 'flex',
-            alignItems: 'center',
-            justifyContent: 'center',
             animation: 'fadeIn 0.1s ease-in-out',
+            cursor: 'progress',
         }, "data-Lovalingo-exclude": "true" },
-        React.createElement("div", { style: {
-                width: '64px',
-                height: '64px',
-                borderRadius: '50%',
-                backgroundColor: 'rgba(255, 255, 255, 0.95)',
-                boxShadow: '0 2px 8px rgba(0, 0, 0, 0.15)',
-                display: 'flex',
-                alignItems: 'center',
-                justifyContent: 'center',
-            } },
-            React.createElement("div", { style: {
-                    width: '32px',
-                    height: '32px',
-                    border: '3px solid #f0f0f0',
-                    borderTop: '3px solid #3b82f6',
-                    borderRadius: '50%',
-                    animation: 'spin 0.6s linear infinite',
-                } })),
         React.createElement("style", null, `
-        @keyframes spin {
-          0% { transform: rotate(0deg); }
-          100% { transform: rotate(360deg); }
-        }
         @keyframes fadeIn {
           from { opacity: 0; }
           to { opacity: 1; }

package/dist/index.d.ts

@@ -14,7 +14,6 @@
  */
 export { LovalingoProvider } from './components/LovalingoProvider';
 export { LanguageSwitcher } from './components/LanguageSwitcher';
-export { AutoTranslate } from './components/AutoTranslate';
 export { LangRouter } from './components/LangRouter';
 export { LangLink } from './components/LangLink';
 export { useLang } from './hooks/useLang';
@@ -23,4 +22,4 @@ export { useLovalingo } from './hooks/useLovalingo';
 export { useLovalingoTranslate } from './hooks/useLovalingoTranslate';
 export { useLovalingoEdit } from './hooks/useLovalingoEdit';
 export { VERSION } from './version';
-export type { LovalingoConfig, LovalingoContextValue, Translation, Exclusion, HashTranslation, DomRule, DomRuleType } from './types';
+export type { LovalingoConfig, LovalingoContextValue, Translation, Exclusion, DomRule, DomRuleType } from './types';

package/dist/index.js

@@ -15,7 +15,6 @@
 // Core Provider & Components
 export { LovalingoProvider } from './components/LovalingoProvider';
 export { LanguageSwitcher } from './components/LanguageSwitcher';
-export { AutoTranslate } from './components/AutoTranslate';
 // Path Mode Components & Hooks (NEW in v4.2)
 export { LangRouter } from './components/LangRouter';
 export { LangLink } from './components/LangLink';

package/dist/types.d.ts

@@ -18,7 +18,7 @@ export interface LovalingoConfig {
     editMode?: boolean;
     editKey?: string;
     pathNormalization?: PathNormalizationConfig;
-    mode?: 'dom' | 'context';
+    mode?: 'dom';
     autoApplyRules?: boolean;
 }
 export interface LovalingoContextValue {
@@ -32,8 +32,6 @@ export interface LovalingoContextValue {
     editMode: boolean;
     toggleEditMode: () => void;
     excludeElement: (selector: string) => Promise<void>;
-    getTranslation: (hash: string, fallback: string) => string | null;
-    queueMiss: (text: string) => void;
 }
 export interface Translation {
     source_text: string;
@@ -42,13 +40,6 @@ export interface Translation {
     target_locale: string;
     content_hash?: string;
 }
-export interface HashTranslation {
-    content_hash: string;
-    source_text: string;
-    target_text: string;
-    source_locale: string;
-    target_locale: string;
-}
 export interface Exclusion {
     selector: string;
     type: 'css' | 'xpath';
@@ -84,9 +75,3 @@ export interface ExtractedContent {
     placeholderMap: Record<string, PlaceholderData>;
     semanticContext: string;
 }
-export interface MissedTranslation {
-    text: string;
-    raw: string;
-    placeholderMap: Record<string, PlaceholderData>;
-    semanticContext: string;
-}

package/dist/utils/api.d.ts

@@ -1,4 +1,4 @@
-import { Translation, Exclusion, MissedTranslation, DomRule } from '../types';
+import { Translation, Exclusion, DomRule } from '../types';
 import { PathNormalizationConfig } from './pathNormalizer';
 export interface ProjectEntitlements {
     tier: 'starter' | 'startup' | 'global';
@@ -8,6 +8,19 @@ export interface ProjectEntitlements {
     hreflangEnabled: boolean;
     seoEnabled?: boolean;
 }
+export type SeoBundleResponse = {
+    locale?: string;
+    normalized_path?: string;
+    routing_strategy?: string;
+    seo?: Record<string, unknown>;
+    alternates?: {
+        canonical?: string;
+        xDefault?: string;
+        languages?: Record<string, string>;
+    };
+    seoEnabled?: boolean;
+    entitlements?: ProjectEntitlements;
+};
 export declare class LovalingoAPI {
     private apiKey;
     private apiBase;
@@ -21,6 +34,7 @@ export declare class LovalingoAPI {
     private isActivationRequiredResponse;
     getEntitlements(): ProjectEntitlements | null;
     fetchEntitlements(localeHint: string): Promise<ProjectEntitlements | null>;
+    fetchSeoBundle(localeHint: string): Promise<SeoBundleResponse | null>;
     trackPageview(pathOrUrl: string): Promise<void>;
     fetchTranslations(sourceLocale: string, targetLocale: string): Promise<Translation[]>;
     fetchBundle(localeHint: string): Promise<{
@@ -29,6 +43,5 @@ export declare class LovalingoAPI {
     } | null>;
     fetchExclusions(): Promise<Exclusion[]>;
     fetchDomRules(targetLocale: string): Promise<DomRule[]>;
-    reportMisses(misses: MissedTranslation[], sourceLocale: string, targetLocale: string): Promise<void>;
     saveExclusion(selector: string, type: 'css' | 'xpath'): Promise<void>;
 }

package/dist/utils/api.js

@@ -22,8 +22,9 @@ export class LovalingoAPI {
     isActivationRequiredPayload(data) {
         if (!data || typeof data !== "object")
             return false;
-        const status = data.status;
-        const errorCode = data.error_code;
+        const record = data;
+        const status = record["status"];
+        const errorCode = record["error_code"];
         return status === "activation_required" || errorCode === "PROJECT_NOT_ACTIVATED";
     }
     isActivationRequiredResponse(response, data) {
@@ -68,6 +69,31 @@ export class LovalingoAPI {
             return null;
         }
     }
+    async fetchSeoBundle(localeHint) {
+        try {
+            if (!this.hasApiKey()) {
+                this.warnMissingApiKey("fetchSeoBundle");
+                return null;
+            }
+            const normalizedPath = processPath(window.location.pathname, this.pathConfig);
+            const response = await fetch(`${this.apiBase}/functions/v1/seo-bundle?key=${this.apiKey}&locale=${encodeURIComponent(localeHint)}&path=${encodeURIComponent(normalizedPath)}`, { cache: "no-store" });
+            if (this.isActivationRequiredResponse(response)) {
+                this.logActivationRequired("fetchSeoBundle", response);
+                return null;
+            }
+            if (!response.ok)
+                return null;
+            const data = (await response.json());
+            if (this.isActivationRequiredResponse(response, data)) {
+                this.logActivationRequired("fetchSeoBundle", response);
+                return null;
+            }
+            return (data || null);
+        }
+        catch {
+            return null;
+        }
+    }
     async trackPageview(pathOrUrl) {
         try {
             if (!this.hasApiKey())
@@ -188,67 +214,6 @@ export class LovalingoAPI {
             return [];
         }
     }
-    async reportMisses(misses, sourceLocale, targetLocale) {
-        try {
-            if (!this.hasApiKey()) {
-                this.warnMissingApiKey('reportMisses');
-                return;
-            }
-            // Use path normalization utility
-            const normalizedPath = processPath(window.location.pathname, this.pathConfig);
-            // CRITICAL: Filter out invalid misses
-            const validMisses = misses.filter(m => {
-                const isValid = m?.text &&
-                    typeof m.text === 'string' &&
-                    m.text.trim().length > 1;
-                if (!isValid) {
-                    console.warn('[Lovalingo] ⚠️ Filtered invalid miss:', m);
-                }
-                return isValid;
-            });
-            if (validMisses.length === 0) {
-                console.log('[Lovalingo] ℹ️ No valid misses to report');
-                return;
-            }
-            // Format for API
-            const formattedMisses = validMisses.map(m => ({
-                source_text: m.text.trim(), // Tokenized text
-                source_text_raw: m.raw, // Original HTML
-                placeholder_map: m.placeholderMap, // Token → HTML mapping
-                semantic_context: m.semanticContext // Element type
-            }));
-            console.log(`[Lovalingo] 📤 Reporting ${formattedMisses.length} misses to API...`);
-            console.log('[Lovalingo] Sample miss:', formattedMisses[0]);
-            const response = await fetch(`${this.apiBase}/functions/v1/misses`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({
-                    key: this.apiKey,
-                    locale: targetLocale,
-                    misses: formattedMisses,
-                    path: normalizedPath,
-                }),
-            });
-            if (this.isActivationRequiredResponse(response)) {
-                this.logActivationRequired('reportMisses', response);
-                return;
-            }
-            if (!response.ok) {
-                const errorText = await response.text();
-                console.error(`[Lovalingo] ❌ API Error ${response.status}:`, errorText);
-                throw new Error(`Miss reporting failed: ${response.status}`);
-            }
-            const result = await response.json();
-            if (this.isActivationRequiredResponse(response, result)) {
-                this.logActivationRequired("reportMisses", response);
-                return;
-            }
-            console.log('[Lovalingo] ✅ Misses reported:', result);
-        }
-        catch (error) {
-            console.error('[Lovalingo] ❌ Error reporting misses:', error);
-        }
-    }
     async saveExclusion(selector, type) {
         try {
             if (!this.hasApiKey()) {

package/dist/utils/translator.d.ts

@@ -1,8 +1,7 @@
-import { Translation, Exclusion, MissedTranslation } from '../types';
+import { Translation, Exclusion } from '../types';
 export declare class Translator {
     private translationMap;
     private exclusions;
-    private missedStrings;
     private nonTranslatableTerms;
     constructor();
     /**
@@ -26,8 +25,6 @@ export declare class Translator {
     private cleanupPreserveIds;
     setTranslations(translations: Translation[]): void;
     setExclusions(exclusions: Exclusion[]): void;
-    getMissedStrings(): MissedTranslation[];
-    clearMissedStrings(): void;
     private isExcluded;
     /**
      * DOM-BASED EXTRACTION
@@ -80,12 +77,4 @@ export declare class Translator {
      */
     private translateAttribute;
     translateDOM(): void;
-    /**
-     * Translate SEO-relevant <head> elements (title + meta content) that are not part of the body DOM tree.
-     */
-    translateHead(): void;
-    /**
-     * Restore original <head> SEO content (title + meta content) after returning to default locale.
-     */
-    restoreHead(): void;
 }

package/dist/utils/translator.js

@@ -2,7 +2,6 @@ export class Translator {
     constructor() {
         this.translationMap = new Map();
         this.exclusions = [];
-        this.missedStrings = new Map();
         // Brand names that should NEVER be translated
         this.nonTranslatableTerms = new Set([
             'Lovable', 'v0', 'Claude Code', 'Bolt', 'Base44',
@@ -127,12 +126,6 @@ export class Translator {
     setExclusions(exclusions) {
         this.exclusions = exclusions || [];
     }
-    getMissedStrings() {
-        return Array.from(this.missedStrings.values());
-    }
-    clearMissedStrings() {
-        this.missedStrings.clear();
-    }
     isExcluded(element) {
         // Check CSS selectors
         for (const exclusion of this.exclusions) {
@@ -632,14 +625,6 @@ export class Translator {
                 }
                 else {
                     console.log(`[Lovalingo] ❌ Miss: "${sourceText.substring(0, 80)}..."`);
-                    if (sourceText.length < 5000 && this.isTranslatableText(sourceText)) {
-                        this.missedStrings.set(sourceText, {
-                            text: sourceText,
-                            raw: content.rawHTML,
-                            placeholderMap: this.sanitizePlaceholderMap(content.placeholderMap),
-                            semanticContext: content.semanticContext
-                        });
-                    }
                 }
             }
             finally {
@@ -696,14 +681,6 @@ export class Translator {
                 }
                 else {
                     console.log(`[Lovalingo] ❌ Miss (generic): "${sourceText.substring(0, 80)}..."`);
-                    if (sourceText.length < 5000 && this.isTranslatableText(sourceText)) {
-                        this.missedStrings.set(sourceText, {
-                            text: sourceText,
-                            raw: content.rawHTML,
-                            placeholderMap: this.sanitizePlaceholderMap(content.placeholderMap),
-                            semanticContext: element.tagName.toLowerCase()
-                        });
-                    }
                 }
             }
             finally {
@@ -782,15 +759,6 @@ export class Translator {
                     temp.innerHTML = this.reconstructHTML(translated, content.placeholderMap);
                     this.updateTextNodesOnly(el, temp);
                 }
-                else {
-                    // Queue miss using the source used for lookup (prefer tokenized)
-                    this.missedStrings.set(source, {
-                        text: source,
-                        raw: content.rawHTML,
-                        placeholderMap: this.sanitizePlaceholderMap(content.placeholderMap),
-                        semanticContext: tag.toLowerCase()
-                    });
-                }
             }
         }
     }
@@ -821,120 +789,12 @@ export class Translator {
         if (translated) {
             element.setAttribute(attr, translated);
         }
-        else if (sourceValue.length < 500) {
-            // Queue as miss
-            this.missedStrings.set(sourceValue, {
-                text: sourceValue,
-                raw: sourceValue,
-                placeholderMap: {},
-                semanticContext: context
-            });
-        }
     }
     translateDOM() {
         console.log(`[Lovalingo] 🔄 translateDOM() called with ${this.translationMap.size} translations`);
         const startTime = performance.now();
         this.translateElement(document.body);
         const elapsed = performance.now() - startTime;
-        console.log(`[Lovalingo] 🏁 translateDOM() complete in ${elapsed.toFixed(2)}ms. Missed: ${this.missedStrings.size}`);
-    }
-    /**
-     * Translate SEO-relevant <head> elements (title + meta content) that are not part of the body DOM tree.
-     */
-    translateHead() {
-        try {
-            const head = document.head;
-            if (!head)
-                return;
-            const titleEl = head.querySelector("title");
-            if (titleEl) {
-                const originalKey = "data-Lovalingo-title-original";
-                if (!titleEl.getAttribute(originalKey)) {
-                    titleEl.setAttribute(originalKey, titleEl.textContent || "");
-                }
-                const sourceTitle = (titleEl.getAttribute(originalKey) || "").trim();
-                if (sourceTitle && this.isTranslatableText(sourceTitle)) {
-                    const translated = this.translationMap.get(sourceTitle);
-                    if (translated) {
-                        titleEl.textContent = translated;
-                    }
-                    else if (sourceTitle.length < 500) {
-                        this.missedStrings.set(sourceTitle, {
-                            text: sourceTitle,
-                            raw: sourceTitle,
-                            placeholderMap: {},
-                            semanticContext: "title",
-                        });
-                    }
-                }
-            }
-            const metaSelectors = [
-                'meta[name="description"]',
-                'meta[property="og:title"]',
-                'meta[property="og:description"]',
-                'meta[name="twitter:title"]',
-                'meta[name="twitter:description"]',
-            ];
-            metaSelectors.forEach((selector) => {
-                head.querySelectorAll(selector).forEach((node) => {
-                    if (!(node instanceof HTMLMetaElement))
-                        return;
-                    const originalAttrKey = "data-Lovalingo-content-original";
-                    if (!node.getAttribute(originalAttrKey)) {
-                        const content = (node.getAttribute("content") || "").trim();
-                        node.setAttribute(originalAttrKey, content);
-                    }
-                    const sourceValue = (node.getAttribute(originalAttrKey) || "").trim();
-                    if (!sourceValue || sourceValue.length <= 1)
-                        return;
-                    if (!this.isTranslatableText(sourceValue))
-                        return;
-                    const translated = this.translationMap.get(sourceValue);
-                    if (translated) {
-                        node.setAttribute("content", translated);
-                    }
-                    else if (sourceValue.length < 500) {
-                        const context = selector.includes("description") ? "meta-description" : "meta-title";
-                        this.missedStrings.set(sourceValue, {
-                            text: sourceValue,
-                            raw: sourceValue,
-                            placeholderMap: {},
-                            semanticContext: context,
-                        });
-                    }
-                });
-            });
-        }
-        catch (e) {
-            console.warn("[Lovalingo] translateHead() failed:", e);
-        }
-    }
-    /**
-     * Restore original <head> SEO content (title + meta content) after returning to default locale.
-     */
-    restoreHead() {
-        try {
-            const head = document.head;
-            if (!head)
-                return;
-            const titleEl = head.querySelector("title");
-            if (titleEl) {
-                const original = titleEl.getAttribute("data-Lovalingo-title-original");
-                if (original !== null) {
-                    titleEl.textContent = original;
-                }
-            }
-            head.querySelectorAll('meta[data-Lovalingo-content-original]').forEach((node) => {
-                if (!(node instanceof HTMLMetaElement))
-                    return;
-                const original = node.getAttribute("data-Lovalingo-content-original");
-                if (original !== null) {
-                    node.setAttribute("content", original);
-                }
-            });
-        }
-        catch (e) {
-            console.warn("[Lovalingo] restoreHead() failed:", e);
-        }
+        console.log(`[Lovalingo] 🏁 translateDOM() complete in ${elapsed.toFixed(2)}ms.`);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovalingo/lovalingo",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "React translation runtime with i18n routing, deterministic bundles + DOM rules, and zero-flash rendering.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist && tsc",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/dist/components/AutoTranslate.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-interface AutoTranslateProps {
-    children: React.ReactNode;
-}
-/**
- * AutoTranslate component - automatically translates text nodes
- * Uses content hashing for change detection and caching
- */
-export declare const AutoTranslate: React.FC<AutoTranslateProps>;
-export {};

package/dist/components/AutoTranslate.js

@@ -1,69 +0,0 @@
-import React, { useContext } from 'react';
-import { LovalingoContext } from '../context/LovalingoContext';
-import { hashContent } from '../utils/hash';
-/**
- * AutoTranslate component - automatically translates text nodes
- * Uses content hashing for change detection and caching
- */
-export const AutoTranslate = ({ children }) => {
-    const context = useContext(LovalingoContext);
-    if (!context) {
-        // Not wrapped in LovalingoProvider - return children as-is
-        return React.createElement(React.Fragment, null, children);
-    }
-    const { locale, config, getTranslation, queueMiss } = context;
-    // If we're on default locale, no translation needed
-    if (locale === config.defaultLocale) {
-        return React.createElement(React.Fragment, null, children);
-    }
-    // Recursively translate all text nodes
-    const translateChildren = (node) => {
-        // Handle strings (text nodes)
-        if (typeof node === 'string') {
-            const match = node.match(/^(\s*)(.*?)(\s*)$/s);
-            const leading = match?.[1] ?? "";
-            const core = match?.[2] ?? node;
-            const trailing = match?.[3] ?? "";
-            const trimmed = core.trim();
-            // Skip empty or very short strings
-            if (trimmed.length === 0 || trimmed.length < 2) {
-                return node;
-            }
-            // Calculate content hash
-            const contentHash = hashContent(trimmed);
-            // Try to get translation from cache
-            const translation = getTranslation(contentHash, trimmed);
-            if (translation) {
-                // We have translation - return it
-                return `${leading}${translation}${trailing}`;
-            }
-            // No translation yet: report miss (may enqueue deterministic pipeline job) and show original.
-            queueMiss(trimmed);
-            return node;
-        }
-        // Handle numbers
-        if (typeof node === 'number') {
-            return node;
-        }
-        // Handle arrays
-        if (Array.isArray(node)) {
-            return node.map((child, index) => (React.createElement(React.Fragment, { key: index }, translateChildren(child))));
-        }
-        // Handle React elements
-        if (React.isValidElement(node)) {
-            const element = node;
-            // Don't translate if marked as excluded
-            if (element.props?.['data-Lovalingo-exclude']) {
-                return node;
-            }
-            // Clone element with translated children
-            return React.cloneElement(element, {
-                ...element.props,
-                children: translateChildren(element.props.children),
-            });
-        }
-        // Return anything else as-is
-        return node;
-    };
-    return React.createElement(React.Fragment, null, translateChildren(children));
-};