@lovalingo/lovalingo 0.5.25 → 0.5.28

package/dist/components/LovalingoProvider.js

@@ -13,77 +13,16 @@ import { usePageviewTracking } from '../hooks/provider/usePageviewTracking';
 import { useSitemapLinkTag } from '../hooks/provider/useSitemapLinkTag';
 import { useStringMissReporting } from '../hooks/provider/useStringMissReporting';
 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 EDIT_MODE_PARAM = "edit_mode";
-const EDIT_KEY_PARAM = "edit_key";
+import { readEditParams } from './provider/editModeUtils';
+import { applySeoBundle as applySeoBundleInternal } from './provider/seoUtils';
+import { mergeEntitlementsSeoEnabled } from "../utils/mergeEntitlements";
+import { useEditModeOverlay } from './provider/useEditModeOverlay';
+import { useHistoryNavigationPatch } from './provider/useHistoryNavigationPatch';
+import { detectLocaleFromLocation, setDocumentLocale } from './provider/localeUtils';
+import { useProviderCache } from './provider/useProviderCache';
+import { DEFAULT_PATH_NORMALIZATION, LIVE_MISSES_QUERY_PARAM, LOCALE_STORAGE_KEY } from './provider/providerConstants';
 // Why: run initial load before first paint on the client to avoid a prehide flash; useEffect on SSR.
 const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
-const LIVE_MISSES_QUERY_PARAM = "lovalingo_live_misses";
-const DEFAULT_PATH_NORMALIZATION = { enabled: true };
-const EDIT_MODE_VALUES = new Set(["1", "true", "yes", "on"]);
-const EDIT_UI_ATTR = "data-lovalingo-edit-ui";
-const EDIT_HIGHLIGHT_ID = "lovalingo-edit-highlight";
-const EDIT_HINT_ID = "lovalingo-edit-hint";
-function readEditParams() {
-    if (typeof window === "undefined")
-        return { enabled: false, editKey: null };
-    const params = new URLSearchParams(window.location.search);
-    const rawFlag = (params.get(EDIT_MODE_PARAM) || params.get("editMode") || "").trim().toLowerCase();
-    const enabled = EDIT_MODE_VALUES.has(rawFlag);
-    const editKey = (params.get(EDIT_KEY_PARAM) || params.get("editKey") || "").trim() || null;
-    return { enabled, editKey };
-}
-function cssEscape(value) {
-    const esc = typeof window !== "undefined" && window?.CSS?.escape;
-    if (typeof esc === "function")
-        return esc(value);
-    return value.replace(/[ !"#$%&'()*+,.\/:;<=>?@[\\\]^`{|}~]/g, "\\$&");
-}
-// Why: build stable, short selectors for exclusions without requiring IDs.
-function buildCssSelector(element, maxDepth = 5) {
-    if (!element || !element.tagName)
-        return null;
-    if (element.id)
-        return `#${cssEscape(element.id)}`;
-    const parts = [];
-    let node = element;
-    let depth = 0;
-    while (node && depth < maxDepth) {
-        const tag = node.tagName.toLowerCase();
-        if (!tag || tag === "html")
-            break;
-        let part = tag;
-        const nodeTag = node.tagName;
-        const classes = Array.from(node.classList || [])
-            .filter(Boolean)
-            .filter((cls) => !cls.startsWith("lovalingo-"))
-            .slice(0, 2);
-        if (classes.length > 0) {
-            part += `.${classes.map(cssEscape).join(".")}`;
-        }
-        const parentEl = node.parentElement;
-        if (parentEl) {
-            const siblings = Array.from(parentEl.children).filter((child) => child instanceof HTMLElement && child.tagName === nodeTag);
-            if (siblings.length > 1) {
-                part += `:nth-of-type(${siblings.indexOf(node) + 1})`;
-            }
-        }
-        parts.unshift(part);
-        const selector = parts.join(" > ");
-        try {
-            if (document.querySelectorAll(selector).length === 1)
-                return selector;
-        }
-        catch {
-            // ignore invalid selector attempts
-        }
-        node = parentEl;
-        depth += 1;
-    }
-    return parts.join(" > ") || null;
-}
 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 = DEFAULT_PATH_NORMALIZATION, // Enable by default
 mode = 'dom', // Default to legacy DOM mode for backward compatibility
@@ -123,7 +62,7 @@ navigateRef, // For path mode routing
         const rules = Array.isArray(pathNormalization?.rules) ? pathNormalization.rules : undefined;
         return rules ? { enabled, rules } : { enabled };
     }, [pathNormalizationKey]);
-    // Why: read locale synchronously from the URL to avoid an initial default-locale render (EN → FR flash) before effects run.
+    // 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;
@@ -163,83 +102,9 @@ navigateRef, // For path mode routing
     const [entitlements, setEntitlements] = useState(() => apiRef.current.getEntitlements());
     const { trackPageviewOnce } = usePageviewTracking({ apiRef, resolvedApiKey });
     const lastNormalizedPathRef = useRef("");
-    const historyPatchedRef = useRef(false);
-    const editSavingRef = useRef(false);
-    const originalHistoryRef = useRef(null);
     const onNavigateRef = useRef(() => undefined);
     const isInternalNavigationRef = useRef(false);
-    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 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
-        }
-        // Why: default to the site's existing background to reduce a visible white flash on non-white themes.
-        try {
-            const bodyBg = window.getComputedStyle(document.body).backgroundColor;
-            if (bodyBg && bodyBg !== "transparent" && bodyBg !== "rgba(0, 0, 0, 0)")
-                return bodyBg;
-            const htmlBg = window.getComputedStyle(document.documentElement).backgroundColor;
-            if (htmlBg && htmlBg !== "transparent" && htmlBg !== "rgba(0, 0, 0, 0)")
-                return htmlBg;
-        }
-        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]);
+    const { brandingEnabled, setBrandingEnabled, setCachedBrandingEnabled, getCachedLoadingBgColor, setCachedLoadingBgColor, } = useProviderCache({ overlayBgColor, resolvedApiKey });
     const config = {
         apiKey: resolvedApiKey,
         publicAnonKey: resolvedApiKey,
@@ -258,19 +123,6 @@ navigateRef, // For path mode routing
         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;
@@ -284,37 +136,7 @@ navigateRef, // For path mode routing
         return () => stop();
     }, []);
     // 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]);
+    const detectLocale = useCallback(() => detectLocaleFromLocation({ routing, allLocales, defaultLocale }), [allLocales, defaultLocale, routing]);
     // Fetch entitlements early so SEO can be enabled even on default locale
     useEffect(() => {
         if (locale !== defaultLocale)
@@ -326,8 +148,9 @@ navigateRef, // For path mode routing
             const bootstrap = await apiRef.current.fetchBootstrap(locale, window.location.pathname + window.location.search);
             if (cancelled)
                 return;
-            if (bootstrap?.entitlements)
-                setEntitlements(bootstrap.entitlements);
+            if (bootstrap?.entitlements) {
+                setEntitlements(mergeEntitlementsSeoEnabled(bootstrap.entitlements, bootstrap.seoEnabled));
+            }
             if (bootstrap?.loading_bg_color)
                 setCachedLoadingBgColor(bootstrap.loading_bg_color);
             if (bootstrap?.entitlements?.brandingRequired) {
@@ -344,117 +167,7 @@ navigateRef, // For path mode routing
         };
     }, [defaultLocale, entitlements, locale, setCachedBrandingEnabled, setCachedLoadingBgColor]);
     const applySeoBundle = useCallback((bundle, hreflangEnabled) => {
-        try {
-            const head = document.head;
-            if (!head)
-                return;
-            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()
-                    : "";
-            const languages = alternates.languages && typeof alternates.languages === "object" ? alternates.languages : {};
-            const hasAnyAlternate = Boolean(alternates.xDefault) || Object.values(languages).some(Boolean);
-            if (!canonicalHref && !(hreflangEnabled && hasAnyAlternate))
-                return;
-            // Why: search engines may ignore hreflang/canonical when multiple conflicting tags exist (we want sitemap + head parity).
-            head
-                .querySelectorAll('link[rel="canonical"], link[rel="alternate"][hreflang], link[data-Lovalingo="hreflang"], link[data-Lovalingo="canonical"]')
-                .forEach((el) => el.remove());
-            if (canonicalHref) {
-                const canonical = document.createElement("link");
-                canonical.rel = "canonical";
-                canonical.href = canonicalHref;
-                canonical.setAttribute("data-Lovalingo", "canonical");
-                head.appendChild(canonical);
-            }
-            if (!hreflangEnabled)
-                return;
-            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
-        }
+        applySeoBundleInternal(bundle, hreflangEnabled);
     }, []);
     // Keep <html lang> in sync and apply default-locale SEO (non-default locales use the bootstrap payload).
     useEffect(() => {
@@ -477,6 +190,7 @@ navigateRef, // For path mode routing
         enhancedPathConfig,
         mode,
         autoApplyRules,
+        seoProp: seo,
         isSeoActive,
         applySeoBundle,
         setEntitlements,
@@ -508,49 +222,7 @@ navigateRef, // For path mode routing
             }
         };
     }, [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;
-        };
-    }, []);
+    useHistoryNavigationPatch(onNavigateRef);
     // Change locale
     const setLocale = useCallback((newLocale) => {
         void (async () => {
@@ -711,134 +383,7 @@ navigateRef, // For path mode routing
         const exclusions = await apiRef.current.fetchExclusions();
         setMarkerEngineExclusions(exclusions);
     }, [editSecretKey, enhancedPathConfig]);
-    useEffect(() => {
-        if (typeof window === "undefined")
-            return;
-        const existingHighlight = document.getElementById(EDIT_HIGHLIGHT_ID);
-        const existingHint = document.getElementById(EDIT_HINT_ID);
-        if (!editMode) {
-            existingHighlight?.remove();
-            existingHint?.remove();
-            return;
-        }
-        const highlight = existingHighlight ||
-            (() => {
-                const node = document.createElement("div");
-                node.id = EDIT_HIGHLIGHT_ID;
-                node.setAttribute(EDIT_UI_ATTR, "true");
-                node.setAttribute("data-lovalingo-exclude", "true");
-                node.style.position = "fixed";
-                node.style.pointerEvents = "none";
-                node.style.zIndex = "2147483646";
-                node.style.border = "2px solid #22c55e";
-                node.style.background = "rgba(34, 197, 94, 0.12)";
-                node.style.borderRadius = "8px";
-                node.style.boxSizing = "border-box";
-                node.style.transition = "transform 80ms ease, width 80ms ease, height 80ms ease";
-                node.style.display = "none";
-                document.body.appendChild(node);
-                return node;
-            })();
-        const hint = existingHint ||
-            (() => {
-                const node = document.createElement("div");
-                node.id = EDIT_HINT_ID;
-                node.setAttribute(EDIT_UI_ATTR, "true");
-                node.setAttribute("data-lovalingo-exclude", "true");
-                node.style.position = "fixed";
-                node.style.left = "12px";
-                node.style.bottom = "12px";
-                node.style.zIndex = "2147483647";
-                node.style.background = "rgba(10, 10, 10, 0.85)";
-                node.style.color = "#ffffff";
-                node.style.fontSize = "12px";
-                node.style.lineHeight = "1.4";
-                node.style.padding = "8px 10px";
-                node.style.borderRadius = "8px";
-                node.style.border = "1px solid rgba(255, 255, 255, 0.15)";
-                node.style.pointerEvents = "none";
-                node.style.maxWidth = "280px";
-                node.textContent = "Edit Mode: click an element to exclude. Press Esc to exit.";
-                document.body.appendChild(node);
-                return node;
-            })();
-        let rafId = null;
-        let pendingTarget = null;
-        const previousCursor = document.body.style.cursor;
-        document.body.style.cursor = "crosshair";
-        const updateHighlight = () => {
-            rafId = null;
-            if (!pendingTarget) {
-                highlight.style.display = "none";
-                return;
-            }
-            const rect = pendingTarget.getBoundingClientRect();
-            if (rect.width <= 0 || rect.height <= 0) {
-                highlight.style.display = "none";
-                return;
-            }
-            highlight.style.display = "block";
-            highlight.style.width = `${rect.width}px`;
-            highlight.style.height = `${rect.height}px`;
-            highlight.style.transform = `translate(${rect.left}px, ${rect.top}px)`;
-        };
-        const onMove = (event) => {
-            const rawTarget = event.target;
-            const target = rawTarget instanceof HTMLElement ? rawTarget : rawTarget instanceof Node ? rawTarget.parentElement : null;
-            if (!target || target.closest(`[${EDIT_UI_ATTR}="true"]`)) {
-                pendingTarget = null;
-            }
-            else if (target === document.body || target === document.documentElement) {
-                pendingTarget = null;
-            }
-            else {
-                pendingTarget = target;
-            }
-            if (rafId !== null)
-                return;
-            rafId = window.requestAnimationFrame(updateHighlight);
-        };
-        const onClick = async (event) => {
-            const rawTarget = event.target;
-            const target = rawTarget instanceof HTMLElement ? rawTarget : rawTarget instanceof Node ? rawTarget.parentElement : null;
-            if (!target || target.closest(`[${EDIT_UI_ATTR}="true"]`))
-                return;
-            event.preventDefault();
-            event.stopPropagation();
-            event.stopImmediatePropagation();
-            const selector = buildCssSelector(target);
-            if (!selector)
-                return;
-            if (editSavingRef.current)
-                return;
-            editSavingRef.current = true;
-            try {
-                await excludeElement(selector);
-            }
-            finally {
-                editSavingRef.current = false;
-            }
-        };
-        const onKeyDown = (event) => {
-            if (event.key === "Escape") {
-                event.preventDefault();
-                setEditMode(false);
-            }
-        };
-        document.addEventListener("mousemove", onMove, true);
-        document.addEventListener("click", onClick, true);
-        document.addEventListener("keydown", onKeyDown, true);
-        return () => {
-            document.removeEventListener("mousemove", onMove, true);
-            document.removeEventListener("click", onClick, true);
-            document.removeEventListener("keydown", onKeyDown, true);
-            if (rafId !== null)
-                window.cancelAnimationFrame(rafId);
-            highlight.remove();
-            hint.remove();
-            document.body.style.cursor = previousCursor;
-        };
-    }, [editMode, excludeElement, setEditMode]);
+    useEditModeOverlay({ editMode, excludeElement, setEditMode });
     const contextValue = {
         locale,
         setLocale,

package/dist/components/provider/__tests__/seoUtils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/provider/__tests__/seoUtils.test.js

@@ -0,0 +1,13 @@
+import { describe, expect, test } from "vitest";
+import { resolveCanonicalHref } from "../seoUtils";
+describe("resolveCanonicalHref", () => {
+    test("prefers alternates canonical when present", () => {
+        expect(resolveCanonicalHref({ canonical_url: "https://example.com/en" }, { canonical: "https://example.com/fr" })).toBe("https://example.com/fr");
+    });
+    test("falls back to seo.canonical_url", () => {
+        expect(resolveCanonicalHref({ canonical_url: "https://example.com/en" }, null)).toBe("https://example.com/en");
+    });
+    test("returns empty when none", () => {
+        expect(resolveCanonicalHref({}, null)).toBe("");
+    });
+});

package/dist/components/provider/editModeUtils.d.ts

@@ -0,0 +1,6 @@
+export declare function readEditParams(): {
+    enabled: boolean;
+    editKey: string | null;
+};
+export declare function cssEscape(value: string): string;
+export declare function buildCssSelector(element: HTMLElement, maxDepth?: number): string | null;

package/dist/components/provider/editModeUtils.js

@@ -0,0 +1,59 @@
+import { EDIT_KEY_PARAM, EDIT_MODE_PARAM, EDIT_MODE_VALUES } from './providerConstants';
+export function readEditParams() {
+    if (typeof window === 'undefined')
+        return { enabled: false, editKey: null };
+    const params = new URLSearchParams(window.location.search);
+    const rawFlag = (params.get(EDIT_MODE_PARAM) || params.get('editMode') || '').trim().toLowerCase();
+    const enabled = EDIT_MODE_VALUES.has(rawFlag);
+    const editKey = (params.get(EDIT_KEY_PARAM) || params.get('editKey') || '').trim() || null;
+    return { enabled, editKey };
+}
+export function cssEscape(value) {
+    const esc = typeof window !== 'undefined' && window?.CSS?.escape;
+    if (typeof esc === 'function')
+        return esc(value);
+    return value.replace(/[ !"#$%&'()*+,.\/:;<=>?@[\\\]^`{|}~]/g, '\\$&');
+}
+// Why: build stable, short selectors for exclusions without requiring IDs.
+export function buildCssSelector(element, maxDepth = 5) {
+    if (!element || !element.tagName)
+        return null;
+    if (element.id)
+        return `#${cssEscape(element.id)}`;
+    const parts = [];
+    let node = element;
+    let depth = 0;
+    while (node && depth < maxDepth) {
+        const tag = node.tagName.toLowerCase();
+        if (!tag || tag === 'html')
+            break;
+        let part = tag;
+        const nodeTag = node.tagName;
+        const classes = Array.from(node.classList || [])
+            .filter(Boolean)
+            .filter((cls) => !cls.startsWith('lovalingo-'))
+            .slice(0, 2);
+        if (classes.length > 0) {
+            part += `.${classes.map(cssEscape).join('.')}`;
+        }
+        const parentEl = node.parentElement;
+        if (parentEl) {
+            const siblings = Array.from(parentEl.children).filter((child) => child instanceof HTMLElement && child.tagName === nodeTag);
+            if (siblings.length > 1) {
+                part += `:nth-of-type(${siblings.indexOf(node) + 1})`;
+            }
+        }
+        parts.unshift(part);
+        const selector = parts.join(' > ');
+        try {
+            if (document.querySelectorAll(selector).length === 1)
+                return selector;
+        }
+        catch {
+            // ignore invalid selector attempts
+        }
+        node = parentEl;
+        depth += 1;
+    }
+    return parts.join(' > ') || null;
+}

package/dist/components/provider/localeUtils.d.ts

@@ -0,0 +1,8 @@
+type DetectLocaleArgs = {
+    routing: 'path' | 'query';
+    allLocales: string[];
+    defaultLocale: string;
+};
+export declare function detectLocaleFromLocation({ routing, allLocales, defaultLocale }: DetectLocaleArgs): string;
+export declare function setDocumentLocale(nextLocale: string): void;
+export {};