@lovalingo/lovalingo 0.5.25 → 0.5.28

package/dist/utils/markerEngine.js

@@ -1,41 +1,21 @@
-import { hashContent } from "./hash";
-// Why: keep marker scans cheap while still capturing a small above-the-fold "critical slice" for first paint.
-const DEFAULT_THROTTLE_MS = 150;
-const DEFAULT_CRITICAL_BUFFER_PX = 200;
-const DEFAULT_CRITICAL_MAX = 800;
-const EXCLUDE_SELECTOR = "[data-lovalingo-exclude],[data-notranslate],[translate-no],[data-no-translate]";
-const UNSAFE_CONTAINER_TAGS = new Set(["script", "style", "noscript", "template", "svg", "canvas"]);
-const ATTRIBUTE_MARKS = [
-    { attr: "title", marker: "data-lovalingo-title-original" },
-    { attr: "aria-label", marker: "data-lovalingo-aria-label-original" },
-    { attr: "placeholder", marker: "data-lovalingo-placeholder-original" },
-];
-const unsafeSelector = Array.from(UNSAFE_CONTAINER_TAGS).join(",");
+import { DEFAULT_THROTTLE_MS } from "./markerEngineConstants";
+import { applyActiveTranslations, applyTranslationMap, restoreDom } from "./markerEngineApply";
+import { getCriticalFingerprint } from "./markerEngineCritical";
+import { scanDom } from "./markerEngineScan";
+import { scanDomForMisses } from "./markerEngineMisses";
+import { addActiveTranslations, setActiveTranslations } from "./markerEngineTranslations";
+import { buildEmptyStats } from "./markerEngineStats";
+import { getActiveTranslationMap, setCustomExcludeSelector } from "./markerEngineState";
 let observer = null;
 let scheduled = null;
 let running = false;
 let lastStats = buildEmptyStats();
 let throttleMs = DEFAULT_THROTTLE_MS;
 let applying = false;
-let customExcludeSelector = null;
-let activeTranslationMap = null;
-const originalTextByNode = new WeakMap();
-const originalAttrByEl = new WeakMap();
-function buildEmptyStats() {
-    return {
-        totalTextNodes: 0,
-        markedNodes: 0,
-        skippedUnsafeNodes: 0,
-        skippedExcludedNodes: 0,
-        skippedNonTranslatableNodes: 0,
-        totalChars: 0,
-        markedChars: 0,
-        skippedUnsafeChars: 0,
-        skippedExcludedChars: 0,
-        skippedNonTranslatableChars: 0,
-        coverageRatio: 0,
-        coverageRatioChars: 0,
-    };
+function scanDomWithGlobals(opts) {
+    const result = scanDom(opts);
+    setGlobalStats(result.stats);
+    return result;
 }
 function setGlobalStats(stats) {
     lastStats = stats;
@@ -49,422 +29,11 @@ function setGlobalStats(stats) {
     if (!g.__lovalingo.dom)
         g.__lovalingo.dom = {};
     g.__lovalingo.dom.getStats = () => lastStats;
-    g.__lovalingo.dom.scan = () => scanDom({ maxSegments: 20000, includeCritical: true });
+    g.__lovalingo.dom.scan = () => scanDomWithGlobals({ maxSegments: 20000, includeCritical: true });
     g.__lovalingo.dom.getCriticalFingerprint = () => getCriticalFingerprint();
     g.__lovalingo.dom.apply = (bundle) => ({ applied: applyTranslationMap(bundle, document.body) });
     g.__lovalingo.dom.restore = () => restoreDom(document.body);
 }
-function isExcludedElement(el) {
-    if (!el)
-        return false;
-    if (el.closest(EXCLUDE_SELECTOR))
-        return true;
-    if (customExcludeSelector) {
-        try {
-            if (el.closest(customExcludeSelector))
-                return true;
-        }
-        catch {
-            // ignore invalid selector strings
-        }
-    }
-    return false;
-}
-function findUnsafeContainer(el) {
-    if (!el)
-        return null;
-    if (!unsafeSelector)
-        return null;
-    return el.closest(unsafeSelector);
-}
-function getStableKey(el) {
-    const owner = el.closest("[data-lovalingo-key]");
-    const key = owner?.getAttribute("data-lovalingo-key") || "";
-    return key.trim();
-}
-function getElementIndex(el) {
-    const parent = el.parentElement;
-    if (!parent)
-        return 0;
-    const children = Array.from(parent.children);
-    const idx = children.indexOf(el);
-    return idx >= 0 ? idx : 0;
-}
-function getTextNodeIndex(node) {
-    let index = 0;
-    let prev = node.previousSibling;
-    while (prev) {
-        if (prev.nodeType === Node.TEXT_NODE)
-            index += 1;
-        prev = prev.previousSibling;
-    }
-    return index;
-}
-function buildElementPath(el) {
-    const parts = [];
-    let current = el;
-    while (current && current.tagName && current !== document.body) {
-        const tag = current.tagName.toLowerCase();
-        const idx = getElementIndex(current);
-        parts.push(`${tag}[${idx}]`);
-        current = current.parentElement;
-    }
-    parts.push("body");
-    return parts.reverse().join("/");
-}
-function normalizeWhitespace(value) {
-    return (value || "").toString().replace(/\s+/g, " ").trim();
-}
-function isTranslatableText(text) {
-    if (!text || text.trim().length < 2)
-        return false;
-    if (/^(__[A-Z0-9_]+__\s*)+$/.test(text))
-        return false;
-    if (/^\d+(\.\d+)?$/.test(text))
-        return false;
-    if (!/[a-zA-Z\u00C0-\u024F\u1E00-\u1EFF]/.test(text))
-        return false;
-    return true;
-}
-function buildStableId(el, text, textIndex) {
-    const key = getStableKey(el);
-    const path = buildElementPath(el);
-    const raw = `${path}#text[${textIndex}]|${text.trim()}|${key}`;
-    return hashContent(raw);
-}
-function buildSelector(el) {
-    const id = el.id;
-    if (id)
-        return `#${id.replace(/[^a-zA-Z0-9_-]/g, "\\$&")}`;
-    const className = el.className;
-    if (typeof className === "string" && className.trim()) {
-        const classes = className
-            .split(/\s+/)
-            .map((c) => c.trim())
-            .filter(Boolean)
-            .slice(0, 3)
-            .map((c) => `.${c.replace(/[^a-zA-Z0-9_-]/g, "\\$&")}`)
-            .join("");
-        if (classes)
-            return classes;
-    }
-    return null;
-}
-function getOrInitTextOriginal(node, parent) {
-    const existing = originalTextByNode.get(node);
-    if (existing)
-        return existing;
-    const raw = node.nodeValue || "";
-    const leading = raw.match(/^\s*/)?.[0] ?? "";
-    const trailing = raw.match(/\s*$/)?.[0] ?? "";
-    const trimmed = raw.trim();
-    const id = buildStableId(parent, trimmed, getTextNodeIndex(node));
-    const created = { raw, trimmed, leading, trailing, id };
-    originalTextByNode.set(node, created);
-    return created;
-}
-function getOrInitAttrOriginal(el, attr) {
-    let map = originalAttrByEl.get(el);
-    if (!map) {
-        map = new Map();
-        originalAttrByEl.set(el, map);
-    }
-    const existing = map.get(attr);
-    if (existing != null)
-        return existing;
-    const value = (el.getAttribute(attr) || "").toString();
-    map.set(attr, value);
-    return value;
-}
-function isInViewport(rect, viewportHeight, bufferPx) {
-    if (!rect)
-        return false;
-    if (!Number.isFinite(rect.top) || !Number.isFinite(rect.bottom))
-        return false;
-    if (rect.width <= 0 || rect.height <= 0)
-        return false;
-    return rect.bottom > -bufferPx && rect.top < viewportHeight + bufferPx;
-}
-function getTextNodeRect(node) {
-    try {
-        const range = document.createRange();
-        range.selectNodeContents(node);
-        const rect = range.getBoundingClientRect();
-        if (rect && rect.width > 0 && rect.height > 0)
-            return rect;
-    }
-    catch {
-        // ignore
-    }
-    try {
-        return node.parentElement ? node.parentElement.getBoundingClientRect() : null;
-    }
-    catch {
-        return null;
-    }
-}
-function considerTextNode(node, stats, segments, occurrences, seen, maxSegments, critical) {
-    const raw = node.nodeValue || "";
-    if (!raw)
-        return;
-    const trimmed = raw.trim();
-    if (!trimmed)
-        return;
-    stats.totalTextNodes += 1;
-    stats.totalChars += raw.length;
-    const parent = node.parentElement;
-    if (!parent)
-        return;
-    if (isExcludedElement(parent)) {
-        stats.skippedExcludedNodes += 1;
-        stats.skippedExcludedChars += raw.length;
-        return;
-    }
-    const unsafe = findUnsafeContainer(parent);
-    if (unsafe) {
-        stats.skippedUnsafeNodes += 1;
-        stats.skippedUnsafeChars += raw.length;
-        return;
-    }
-    if (!isTranslatableText(trimmed)) {
-        stats.skippedNonTranslatableNodes += 1;
-        stats.skippedNonTranslatableChars += raw.length;
-        return;
-    }
-    const original = getOrInitTextOriginal(node, parent);
-    stats.markedNodes += 1;
-    stats.markedChars += raw.length;
-    if (segments.length < maxSegments) {
-        const originalText = normalizeWhitespace(original.trimmed) || null;
-        const currentText = normalizeWhitespace(node.nodeValue || "") || null;
-        segments.push({
-            kind: "text",
-            selector: buildSelector(parent),
-            original: originalText,
-            current: currentText,
-            html: null,
-        });
-        if (originalText && !seen.has(originalText)) {
-            seen.add(originalText);
-            occurrences.push({ source_text: originalText, semantic_context: "text" });
-        }
-        if (critical?.enabled && originalText && !critical.seen.has(originalText)) {
-            const rect = getTextNodeRect(node);
-            if (isInViewport(rect, critical.viewportHeight, critical.bufferPx)) {
-                critical.seen.add(originalText);
-                critical.occurrences.push({ source_text: originalText, semantic_context: "critical:text" });
-            }
-        }
-    }
-}
-function considerAttributes(root, segments, occurrences, seen, maxSegments, critical) {
-    const nodes = root.querySelectorAll("[title],[aria-label],[placeholder]");
-    nodes.forEach((el) => {
-        if (isExcludedElement(el))
-            return;
-        if (findUnsafeContainer(el))
-            return;
-        for (const { attr } of ATTRIBUTE_MARKS) {
-            const value = el.getAttribute(attr);
-            if (!value)
-                continue;
-            const trimmed = value.trim();
-            if (!trimmed || !isTranslatableText(trimmed))
-                continue;
-            const original = normalizeWhitespace(getOrInitAttrOriginal(el, attr)) || null;
-            const current = normalizeWhitespace(el.getAttribute(attr) || "") || null;
-            const kind = (attr === "title" ? "title" : attr === "aria-label" ? "aria-label" : "placeholder");
-            if (segments.length < maxSegments) {
-                segments.push({
-                    kind,
-                    selector: buildSelector(el),
-                    original,
-                    current,
-                    html: null,
-                });
-            }
-            if (original && !seen.has(original)) {
-                seen.add(original);
-                occurrences.push({ source_text: original, semantic_context: `attr:${attr}` });
-            }
-            if (critical?.enabled && original && !critical.seen.has(original)) {
-                let rect = null;
-                try {
-                    rect = el.getBoundingClientRect();
-                }
-                catch {
-                    rect = null;
-                }
-                if (isInViewport(rect, critical.viewportHeight, critical.bufferPx)) {
-                    critical.seen.add(original);
-                    critical.occurrences.push({ source_text: original, semantic_context: `critical:attr:${attr}` });
-                }
-            }
-        }
-    });
-}
-function finalizeStats(stats) {
-    const eligibleNodes = stats.totalTextNodes -
-        stats.skippedUnsafeNodes -
-        stats.skippedExcludedNodes -
-        stats.skippedNonTranslatableNodes;
-    const eligibleChars = stats.totalChars -
-        stats.skippedUnsafeChars -
-        stats.skippedExcludedChars -
-        stats.skippedNonTranslatableChars;
-    stats.coverageRatio = eligibleNodes > 0 ? stats.markedNodes / eligibleNodes : 1;
-    stats.coverageRatioChars = eligibleChars > 0 ? stats.markedChars / eligibleChars : 1;
-}
-function scanCriticalTexts() {
-    const root = document.body;
-    const viewportHeight = Math.max(0, Math.floor(window.innerHeight || 0));
-    const viewportWidth = Math.max(0, Math.floor(window.innerWidth || 0));
-    const viewport = { width: viewportWidth, height: viewportHeight };
-    if (!root || viewportHeight <= 0)
-        return { texts: [], viewport };
-    const seen = new Set();
-    const texts = [];
-    const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
-    let node = walker.nextNode();
-    while (node && texts.length < DEFAULT_CRITICAL_MAX) {
-        if (node.nodeType !== Node.TEXT_NODE) {
-            node = walker.nextNode();
-            continue;
-        }
-        const textNode = node;
-        const raw = textNode.nodeValue || "";
-        const trimmed = raw.trim();
-        if (!trimmed || !isTranslatableText(trimmed)) {
-            node = walker.nextNode();
-            continue;
-        }
-        const parent = textNode.parentElement;
-        if (!parent || isExcludedElement(parent) || findUnsafeContainer(parent)) {
-            node = walker.nextNode();
-            continue;
-        }
-        const original = getOrInitTextOriginal(textNode, parent);
-        const originalText = normalizeWhitespace(original.trimmed);
-        if (!originalText || seen.has(originalText)) {
-            node = walker.nextNode();
-            continue;
-        }
-        const rect = getTextNodeRect(textNode);
-        if (!isInViewport(rect, viewportHeight, DEFAULT_CRITICAL_BUFFER_PX)) {
-            node = walker.nextNode();
-            continue;
-        }
-        seen.add(originalText);
-        texts.push(originalText);
-        node = walker.nextNode();
-    }
-    if (texts.length < DEFAULT_CRITICAL_MAX) {
-        const nodes = root.querySelectorAll("[title],[aria-label],[placeholder]");
-        nodes.forEach((el) => {
-            if (texts.length >= DEFAULT_CRITICAL_MAX)
-                return;
-            if (isExcludedElement(el) || findUnsafeContainer(el))
-                return;
-            let rect = null;
-            try {
-                rect = el.getBoundingClientRect();
-            }
-            catch {
-                rect = null;
-            }
-            if (!isInViewport(rect, viewportHeight, DEFAULT_CRITICAL_BUFFER_PX))
-                return;
-            for (const { attr } of ATTRIBUTE_MARKS) {
-                if (texts.length >= DEFAULT_CRITICAL_MAX)
-                    break;
-                const value = el.getAttribute(attr);
-                if (!value)
-                    continue;
-                const trimmed = value.trim();
-                if (!trimmed || !isTranslatableText(trimmed))
-                    continue;
-                const original = normalizeWhitespace(getOrInitAttrOriginal(el, attr));
-                if (!original || seen.has(original))
-                    continue;
-                seen.add(original);
-                texts.push(original);
-            }
-        });
-    }
-    return { texts, viewport };
-}
-export function getCriticalFingerprint() {
-    if (typeof window === "undefined" || typeof document === "undefined") {
-        return { critical_count: 0, critical_hash: "0", viewport: { width: 0, height: 0 } };
-    }
-    const { texts, viewport } = scanCriticalTexts();
-    const normalized = texts.map((t) => normalizeWhitespace(t)).filter(Boolean);
-    // Why: sort to stay stable across minor DOM reordering without affecting the set of critical strings.
-    normalized.sort((a, b) => a.localeCompare(b));
-    return {
-        critical_count: normalized.length,
-        critical_hash: hashContent(normalized.join("\n")),
-        viewport,
-    };
-}
-function scanDom(opts) {
-    const root = document.body;
-    if (!root) {
-        const empty = buildEmptyStats();
-        setGlobalStats(empty);
-        return { version: 1, stats: empty, segments: [], occurrences: [], truncated: false };
-    }
-    const stats = buildEmptyStats();
-    const maxSegments = Math.max(0, Math.floor(opts.maxSegments || 0)) || 20000;
-    const includeCritical = opts.includeCritical === true;
-    const viewportHeight = includeCritical ? Math.max(0, Math.floor(window.innerHeight || 0)) : 0;
-    const viewportWidth = includeCritical ? Math.max(0, Math.floor(window.innerWidth || 0)) : 0;
-    // Why: include a small buffer so "near the fold" text is ready without delaying first paint.
-    const critical = includeCritical
-        ? {
-            enabled: true,
-            viewportHeight,
-            bufferPx: DEFAULT_CRITICAL_BUFFER_PX,
-            max: DEFAULT_CRITICAL_MAX,
-            seen: new Set(),
-            occurrences: [],
-        }
-        : null;
-    const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
-    const nodes = [];
-    const segments = [];
-    const occurrences = [];
-    const seen = new Set();
-    let node = walker.nextNode();
-    while (node) {
-        if (node.nodeType === Node.TEXT_NODE)
-            nodes.push(node);
-        node = walker.nextNode();
-    }
-    nodes.forEach((textNode) => {
-        if (critical?.enabled && critical.occurrences.length >= critical.max) {
-            critical.enabled = false;
-        }
-        considerTextNode(textNode, stats, segments, occurrences, seen, maxSegments, critical);
-    });
-    considerAttributes(root, segments, occurrences, seen, maxSegments, critical);
-    finalizeStats(stats);
-    setGlobalStats(stats);
-    const truncated = segments.length >= maxSegments;
-    return {
-        version: 1,
-        stats,
-        segments,
-        occurrences,
-        ...(includeCritical
-            ? {
-                critical_occurrences: critical?.occurrences ?? [],
-                viewport: { width: viewportWidth, height: viewportHeight },
-            }
-            : {}),
-        truncated,
-    };
-}
 function scheduleScan() {
     if (!running)
         return;
@@ -473,8 +42,8 @@ function scheduleScan() {
     scheduled = window.setTimeout(() => {
         scheduled = null;
         try {
-            scanDom({ maxSegments: 20000 });
-            if (activeTranslationMap) {
+            scanDomWithGlobals({ maxSegments: 20000 });
+            if (getActiveTranslationMap()) {
                 applying = true;
                 applyActiveTranslations(document.body);
             }
@@ -508,7 +77,7 @@ export function startMarkerEngine(options = {}) {
             subtree: true,
             characterData: true,
         });
-        scanDom({ maxSegments: 20000 });
+        scanDomWithGlobals({ maxSegments: 20000 });
     };
     startObserver();
     return stopMarkerEngine;
@@ -529,265 +98,12 @@ export function getMarkerStats() {
 }
 export function setMarkerEngineExclusions(exclusions) {
     if (!exclusions || exclusions.length === 0) {
-        customExcludeSelector = null;
+        setCustomExcludeSelector(null);
         return;
     }
     const selectors = exclusions
         .filter((e) => e && e.type === "css" && typeof e.selector === "string" && e.selector.trim())
         .map((e) => e.selector.trim());
-    customExcludeSelector = selectors.length ? selectors.join(",") : null;
-}
-export function setActiveTranslations(translations) {
-    if (!translations || translations.length === 0) {
-        activeTranslationMap = null;
-        return;
-    }
-    const map = new Map();
-    for (const t of translations) {
-        const source = normalizeWhitespace((t?.source_text || "").toString());
-        const translated = (t?.translated_text ?? "").toString();
-        if (!source || !translated)
-            continue;
-        map.set(source, translated);
-    }
-    activeTranslationMap = map;
-}
-export function addActiveTranslations(translations) {
-    if (!translations)
-        return 0;
-    const map = activeTranslationMap ?? new Map();
-    let added = 0;
-    if (Array.isArray(translations)) {
-        for (const t of translations) {
-            const source = normalizeWhitespace((t?.source_text || "").toString());
-            const translated = (t?.translated_text ?? "").toString();
-            if (!source || !translated)
-                continue;
-            if (map.get(source) === translated)
-                continue;
-            map.set(source, translated);
-            added += 1;
-        }
-    }
-    else {
-        for (const [keyRaw, valueRaw] of Object.entries(translations || {})) {
-            const source = normalizeWhitespace((keyRaw || "").toString());
-            const translated = (valueRaw ?? "").toString();
-            if (!source || !translated)
-                continue;
-            if (map.get(source) === translated)
-                continue;
-            map.set(source, translated);
-            added += 1;
-        }
-    }
-    activeTranslationMap = map;
-    return added;
-}
-function applyTranslationMap(bundle, root) {
-    if (!root)
-        return 0;
-    const map = new Map();
-    for (const [k, v] of Object.entries(bundle || {})) {
-        const source = normalizeWhitespace((k || "").toString());
-        const translated = (v ?? "").toString();
-        if (!source || !translated)
-            continue;
-        map.set(source, translated);
-    }
-    activeTranslationMap = map;
-    return applyActiveTranslations(root);
-}
-export function applyActiveTranslations(root = document.body) {
-    if (!root || !activeTranslationMap || activeTranslationMap.size === 0)
-        return 0;
-    const map = activeTranslationMap;
-    let applied = 0;
-    const walk = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
-    const nodes = [];
-    let node = walk.nextNode();
-    while (node) {
-        if (node.nodeType === Node.TEXT_NODE)
-            nodes.push(node);
-        node = walk.nextNode();
-    }
-    for (const textNode of nodes) {
-        const parent = textNode.parentElement;
-        if (!parent)
-            continue;
-        const raw = textNode.nodeValue || "";
-        const trimmed = raw.trim();
-        if (!trimmed)
-            continue;
-        if (isExcludedElement(parent))
-            continue;
-        if (findUnsafeContainer(parent))
-            continue;
-        if (!isTranslatableText(trimmed))
-            continue;
-        const original = getOrInitTextOriginal(textNode, parent);
-        const key = normalizeWhitespace(original.trimmed);
-        const translation = map.get(key);
-        if (!translation)
-            continue;
-        const next = `${original.leading}${translation}${original.trailing}`;
-        if (textNode.nodeValue === next)
-            continue;
-        try {
-            textNode.nodeValue = next;
-            applied += 1;
-        }
-        catch {
-            // ignore
-        }
-    }
-    if (root instanceof HTMLElement) {
-        const elements = root.querySelectorAll("[title],[aria-label],[placeholder]");
-        elements.forEach((el) => {
-            if (isExcludedElement(el))
-                return;
-            if (findUnsafeContainer(el))
-                return;
-            for (const { attr } of ATTRIBUTE_MARKS) {
-                const current = el.getAttribute(attr);
-                if (!current)
-                    continue;
-                const trimmed = current.trim();
-                if (!trimmed || !isTranslatableText(trimmed))
-                    continue;
-                const original = normalizeWhitespace(getOrInitAttrOriginal(el, attr));
-                const translation = map.get(original);
-                if (!translation)
-                    continue;
-                if (el.getAttribute(attr) === translation)
-                    continue;
-                try {
-                    el.setAttribute(attr, translation);
-                    applied += 1;
-                }
-                catch {
-                    // ignore
-                }
-            }
-        });
-    }
-    return applied;
-}
-export function scanDomForMisses(opts) {
-    const root = document.body;
-    const misses = [];
-    if (!root) {
-        return { misses };
-    }
-    // Why: allow live miss scans even when bundles are empty so first-time pages still report.
-    const translationMap = activeTranslationMap;
-    const hasTranslations = Boolean(translationMap && translationMap.size > 0);
-    const max = Math.max(0, Math.floor(opts.max || 0));
-    if (max <= 0)
-        return { misses };
-    const ignore = opts.ignore || new Set();
-    const seen = new Set();
-    const recordMiss = (text, context) => {
-        if (!text || seen.has(text) || ignore.has(text))
-            return;
-        if (hasTranslations && translationMap.has(text))
-            return;
-        if (misses.length >= max)
-            return;
-        seen.add(text);
-        misses.push({ source_text: text, semantic_context: context });
-    };
-    const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
-    let node = walker.nextNode();
-    while (node && misses.length < max) {
-        if (node.nodeType !== Node.TEXT_NODE) {
-            node = walker.nextNode();
-            continue;
-        }
-        const textNode = node;
-        const parent = textNode.parentElement;
-        if (!parent || isExcludedElement(parent) || findUnsafeContainer(parent)) {
-            node = walker.nextNode();
-            continue;
-        }
-        const raw = textNode.nodeValue || "";
-        const trimmed = raw.trim();
-        if (!trimmed || !isTranslatableText(trimmed)) {
-            node = walker.nextNode();
-            continue;
-        }
-        const original = getOrInitTextOriginal(textNode, parent);
-        const key = normalizeWhitespace(original.trimmed);
-        if (key) {
-            recordMiss(key, "text");
-        }
-        node = walker.nextNode();
-    }
-    if (misses.length < max) {
-        const nodes = root.querySelectorAll("[title],[aria-label],[placeholder]");
-        nodes.forEach((el) => {
-            if (misses.length >= max)
-                return;
-            if (isExcludedElement(el) || findUnsafeContainer(el))
-                return;
-            for (const { attr } of ATTRIBUTE_MARKS) {
-                if (misses.length >= max)
-                    break;
-                const value = el.getAttribute(attr);
-                if (!value)
-                    continue;
-                const trimmed = value.trim();
-                if (!trimmed || !isTranslatableText(trimmed))
-                    continue;
-                const original = normalizeWhitespace(getOrInitAttrOriginal(el, attr));
-                if (!original)
-                    continue;
-                const context = attr === "title" ? "attr:title" : attr === "aria-label" ? "attr:aria-label" : "attr:placeholder";
-                recordMiss(original, context);
-            }
-        });
-    }
-    return { misses };
-}
-export function restoreDom(root = document.body) {
-    if (!root)
-        return;
-    const walk = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
-    let node = walk.nextNode();
-    while (node) {
-        if (node.nodeType === Node.TEXT_NODE) {
-            const textNode = node;
-            const original = originalTextByNode.get(textNode);
-            if (original && textNode.nodeValue !== original.raw) {
-                try {
-                    textNode.nodeValue = original.raw;
-                }
-                catch {
-                    // ignore
-                }
-            }
-        }
-        node = walk.nextNode();
-    }
-    if (root instanceof HTMLElement) {
-        const elements = root.querySelectorAll("[title],[aria-label],[placeholder]");
-        elements.forEach((el) => {
-            const originals = originalAttrByEl.get(el);
-            if (!originals)
-                return;
-            for (const { attr } of ATTRIBUTE_MARKS) {
-                const original = originals.get(attr);
-                if (original == null)
-                    continue;
-                if (el.getAttribute(attr) === original)
-                    continue;
-                try {
-                    el.setAttribute(attr, original);
-                }
-                catch {
-                    // ignore
-                }
-            }
-        });
-    }
+    setCustomExcludeSelector(selectors.length ? selectors.join(",") : null);
 }
+export { applyActiveTranslations, scanDomForMisses, restoreDom, setActiveTranslations, addActiveTranslations, getCriticalFingerprint };