@lovalingo/lovalingo 0.5.29 → 0.6.0

package/dist/utils/domRules.js

@@ -1,150 +0,0 @@
-const DEFAULT_MATCH_SELECTOR = 'button,a,label,summary,[role="button"],[role="link"],[role="tab"]';
-function ensureStyleTag(id, css) {
-    const existing = document.querySelector(`style[data-lovalingo-rule="${id}"]`);
-    if (existing)
-        return;
-    const style = document.createElement('style');
-    style.setAttribute('data-lovalingo-rule', id);
-    style.textContent = css;
-    document.head.appendChild(style);
-}
-function ensureScriptTag(id, script) {
-    const existing = document.querySelector(`script[data-lovalingo-rule="${id}"]`);
-    if (existing)
-        return;
-    const el = document.createElement('script');
-    el.setAttribute('data-lovalingo-rule', id);
-    el.textContent = script;
-    document.head.appendChild(el);
-}
-function shouldSkipElement(el, ruleId) {
-    return el.hasAttribute(`data-lovalingo-rule-${ruleId}`);
-}
-function markElement(el, ruleId) {
-    el.setAttribute(`data-lovalingo-rule-${ruleId}`, '1');
-}
-function collectElements(rule, matchText) {
-    if (rule.selector)
-        return Array.from(document.querySelectorAll(rule.selector));
-    if (matchText)
-        return Array.from(document.querySelectorAll(DEFAULT_MATCH_SELECTOR));
-    return [];
-}
-export function applyDomRules(rules) {
-    if (!Array.isArray(rules) || rules.length === 0)
-        return 0;
-    let applied = 0;
-    for (const rule of rules) {
-        if (!rule || !rule.id)
-            continue;
-        const payload = rule.payload || {};
-        const matchText = payload.matchText?.trim() || null;
-        switch (rule.rule_type) {
-            case 'css': {
-                const css = payload.css || '';
-                if (css.trim().length > 0) {
-                    ensureStyleTag(rule.id, css);
-                    applied += 1;
-                }
-                break;
-            }
-            case 'script': {
-                const script = payload.script || '';
-                if (script.trim().length > 0) {
-                    ensureScriptTag(rule.id, script);
-                    applied += 1;
-                }
-                break;
-            }
-            case 'remove': {
-                const elements = collectElements(rule, matchText);
-                for (const el of elements) {
-                    if (shouldSkipElement(el, rule.id))
-                        continue;
-                    el.remove();
-                    applied += 1;
-                }
-                break;
-            }
-            case 'add_class': {
-                const className = payload.className || payload.value || '';
-                if (!className.trim())
-                    break;
-                const elements = collectElements(rule, matchText);
-                for (const el of elements) {
-                    if (shouldSkipElement(el, rule.id))
-                        continue;
-                    if (matchText) {
-                        const current = (el.textContent || '').trim();
-                        if (current !== matchText)
-                            continue;
-                    }
-                    className.split(/\s+/).forEach((cls) => cls && el.classList.add(cls));
-                    markElement(el, rule.id);
-                    applied += 1;
-                }
-                break;
-            }
-            case 'set_attribute': {
-                const attribute = payload.attribute || '';
-                const value = payload.value || payload.text || '';
-                if (!attribute || !value)
-                    break;
-                const elements = collectElements(rule, matchText);
-                for (const el of elements) {
-                    if (shouldSkipElement(el, rule.id))
-                        continue;
-                    if (matchText) {
-                        const current = (el.textContent || '').trim();
-                        if (current !== matchText)
-                            continue;
-                    }
-                    el.setAttribute(attribute, value);
-                    markElement(el, rule.id);
-                    applied += 1;
-                }
-                break;
-            }
-            case 'set_html': {
-                const html = payload.html || '';
-                if (!html)
-                    break;
-                const elements = collectElements(rule, matchText);
-                for (const el of elements) {
-                    if (shouldSkipElement(el, rule.id))
-                        continue;
-                    if (matchText) {
-                        const current = (el.textContent || '').trim();
-                        if (current !== matchText)
-                            continue;
-                    }
-                    el.innerHTML = html;
-                    markElement(el, rule.id);
-                    applied += 1;
-                }
-                break;
-            }
-            case 'replace_text':
-            default: {
-                const replacement = payload.text || payload.value || '';
-                if (!replacement)
-                    break;
-                const elements = collectElements(rule, matchText);
-                for (const el of elements) {
-                    if (shouldSkipElement(el, rule.id))
-                        continue;
-                    if (matchText) {
-                        const current = (el.textContent || '').trim();
-                        if (current !== matchText)
-                            continue;
-                    }
-                    el.textContent = replacement;
-                    markElement(el, rule.id);
-                    applied += 1;
-                }
-                break;
-            }
-        }
-    }
-    return applied;
-}

package/dist/utils/hash.d.ts

@@ -1,9 +0,0 @@
-/**
- * Simple, fast hash function for content addressing
- * Uses djb2 algorithm - good distribution, very fast
- */
-export declare function hashContent(text: string): string;
-/**
- * Hash with context (includes placeholders info for uniqueness)
- */
-export declare function hashWithContext(text: string, placeholders?: Map<string, string>): string;

package/dist/utils/hash.js

@@ -1,27 +0,0 @@
-/**
- * Simple, fast hash function for content addressing
- * Uses djb2 algorithm - good distribution, very fast
- */
-export function hashContent(text) {
-    if (!text || text.length === 0) {
-        return '0';
-    }
-    let hash = 5381;
-    for (let i = 0; i < text.length; i++) {
-        hash = ((hash << 5) + hash) + text.charCodeAt(i); // hash * 33 + c
-    }
-    // Convert to positive base36 string (compact representation)
-    return Math.abs(hash).toString(36);
-}
-/**
- * Hash with context (includes placeholders info for uniqueness)
- */
-export function hashWithContext(text, placeholders) {
-    const baseHash = hashContent(text);
-    if (!placeholders || placeholders.size === 0) {
-        return baseHash;
-    }
-    // Include placeholder keys in hash for uniqueness
-    const placeholderKeys = Array.from(placeholders.keys()).sort().join(',');
-    return hashContent(`${text}:${placeholderKeys}`);
-}

package/dist/utils/languageFlags.d.ts

@@ -1,7 +0,0 @@
-export declare function normalizeLocaleCode(locale: unknown): string;
-export declare function parseLocale(locale: unknown): {
-    language: string;
-    region: string | null;
-};
-export declare function countryCodeToFlagEmoji(countryCode: unknown): string | null;
-export declare function resolveLocaleFlag(locale: unknown): string;

package/dist/utils/languageFlags.js

@@ -1,90 +0,0 @@
-const EXACT_LOCALE_FLAG_OVERRIDES = {
-    en: "🇬🇧",
-    ar: "🇸🇦",
-    zh: "🇨🇳",
-    fa: "🇮🇷",
-    he: "🇮🇱",
-};
-const LANGUAGE_DEFAULT_REGION = {
-    ar: "SA",
-    bn: "BD",
-    cs: "CZ",
-    da: "DK",
-    de: "DE",
-    el: "GR",
-    en: "GB",
-    es: "ES",
-    fa: "IR",
-    fi: "FI",
-    fr: "FR",
-    he: "IL",
-    hi: "IN",
-    hu: "HU",
-    hy: "AM",
-    id: "ID",
-    it: "IT",
-    ja: "JP",
-    ko: "KR",
-    nl: "NL",
-    no: "NO",
-    pl: "PL",
-    pt: "PT",
-    ro: "RO",
-    ru: "RU",
-    sk: "SK",
-    sv: "SE",
-    th: "TH",
-    tr: "TR",
-    uk: "UA",
-    vi: "VN",
-    yo: "NG",
-    zh: "CN",
-};
-export function normalizeLocaleCode(locale) {
-    if (typeof locale !== "string")
-        return "";
-    return locale.trim().replace(/_/g, "-").toLowerCase();
-}
-export function parseLocale(locale) {
-    const normalized = normalizeLocaleCode(locale);
-    if (!normalized)
-        return { language: "", region: null };
-    const parts = normalized.split("-").filter(Boolean);
-    const language = parts[0] || "";
-    const regionPart = parts.find((part, index) => index > 0 && /^[a-z]{2}$/.test(part));
-    const region = regionPart ? regionPart.toUpperCase() : null;
-    return { language, region };
-}
-export function countryCodeToFlagEmoji(countryCode) {
-    if (typeof countryCode !== "string")
-        return null;
-    const normalized = countryCode.trim().toUpperCase();
-    if (!/^[A-Z]{2}$/.test(normalized))
-        return null;
-    const first = normalized.charCodeAt(0) + 127397;
-    const second = normalized.charCodeAt(1) + 127397;
-    return String.fromCodePoint(first, second);
-}
-export function resolveLocaleFlag(locale) {
-    const normalized = normalizeLocaleCode(locale);
-    if (!normalized)
-        return "🌐";
-    const exact = EXACT_LOCALE_FLAG_OVERRIDES[normalized];
-    if (exact)
-        return exact;
-    const { language, region } = parseLocale(normalized);
-    if (!language)
-        return "🌐";
-    if (region) {
-        const regionFlag = countryCodeToFlagEmoji(region);
-        if (regionFlag)
-            return regionFlag;
-    }
-    const defaultRegion = LANGUAGE_DEFAULT_REGION[language];
-    if (defaultRegion) {
-        const defaultFlag = countryCodeToFlagEmoji(defaultRegion);
-        if (defaultFlag)
-            return defaultFlag;
-    }
-    return "🌐";
-}

package/dist/utils/logger.d.ts

@@ -1,3 +0,0 @@
-export declare function logDebug(...args: unknown[]): void;
-export declare function warnDebug(...args: unknown[]): void;
-export declare function errorDebug(...args: unknown[]): void;

package/dist/utils/logger.js

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

package/dist/utils/markerEngine.d.ts

@@ -1,12 +0,0 @@
-import type { Exclusion } from "../types";
-import type { MarkerEngineOptions, MarkerStats } from "./markerEngineTypes";
-import { applyActiveTranslations, restoreDom } from "./markerEngineApply";
-import { getCriticalFingerprint } from "./markerEngineCritical";
-import { scanDomForMisses } from "./markerEngineMisses";
-import { addActiveTranslations, setActiveTranslations } from "./markerEngineTranslations";
-export declare function startMarkerEngine(options?: MarkerEngineOptions): typeof stopMarkerEngine;
-export declare function stopMarkerEngine(): void;
-export declare function getMarkerStats(): MarkerStats;
-export declare function setMarkerEngineExclusions(exclusions: Exclusion[] | null): void;
-export { applyActiveTranslations, scanDomForMisses, restoreDom, setActiveTranslations, addActiveTranslations, getCriticalFingerprint };
-export type { MarkerStats, MarkerEngineOptions, DomScanOccurrence, DomScanSegment, DomScanResult, DomMiss, DomMissScanResult, CriticalFingerprint, } from "./markerEngineTypes";

package/dist/utils/markerEngine.js

@@ -1,109 +0,0 @@
-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;
-function scanDomWithGlobals(opts) {
-    const result = scanDom(opts);
-    setGlobalStats(result.stats);
-    return result;
-}
-function setGlobalStats(stats) {
-    lastStats = stats;
-    if (typeof window === "undefined")
-        return;
-    window.__lovalingoMarkersReady = true;
-    window.__lovalingoMarkerStats = stats;
-    const g = window;
-    if (!g.__lovalingo)
-        g.__lovalingo = {};
-    if (!g.__lovalingo.dom)
-        g.__lovalingo.dom = {};
-    g.__lovalingo.dom.getStats = () => lastStats;
-    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 scheduleScan() {
-    if (!running)
-        return;
-    if (scheduled != null)
-        return;
-    scheduled = window.setTimeout(() => {
-        scheduled = null;
-        try {
-            scanDomWithGlobals({ maxSegments: 20000 });
-            if (getActiveTranslationMap()) {
-                applying = true;
-                applyActiveTranslations(document.body);
-            }
-        }
-        finally {
-            applying = false;
-        }
-    }, throttleMs);
-}
-export function startMarkerEngine(options = {}) {
-    if (typeof window === "undefined" || typeof document === "undefined") {
-        return () => undefined;
-    }
-    stopMarkerEngine();
-    running = true;
-    throttleMs = Math.max(20, options.throttleMs ?? DEFAULT_THROTTLE_MS);
-    const startObserver = () => {
-        if (!running)
-            return;
-        if (!document.body) {
-            window.setTimeout(startObserver, 50);
-            return;
-        }
-        observer = new MutationObserver(() => {
-            if (applying)
-                return;
-            scheduleScan();
-        });
-        observer.observe(document.body, {
-            childList: true,
-            subtree: true,
-            characterData: true,
-        });
-        scanDomWithGlobals({ maxSegments: 20000 });
-    };
-    startObserver();
-    return stopMarkerEngine;
-}
-export function stopMarkerEngine() {
-    running = false;
-    if (scheduled != null) {
-        window.clearTimeout(scheduled);
-        scheduled = null;
-    }
-    if (observer) {
-        observer.disconnect();
-        observer = null;
-    }
-}
-export function getMarkerStats() {
-    return lastStats;
-}
-export function setMarkerEngineExclusions(exclusions) {
-    if (!exclusions || exclusions.length === 0) {
-        setCustomExcludeSelector(null);
-        return;
-    }
-    const selectors = exclusions
-        .filter((e) => e && e.type === "css" && typeof e.selector === "string" && e.selector.trim())
-        .map((e) => e.selector.trim());
-    setCustomExcludeSelector(selectors.length ? selectors.join(",") : null);
-}
-export { applyActiveTranslations, scanDomForMisses, restoreDom, setActiveTranslations, addActiveTranslations, getCriticalFingerprint };

package/dist/utils/markerEngineApply.d.ts

@@ -1,3 +0,0 @@
-export declare function applyTranslationMap(bundle: Record<string, string>, root: ParentNode | null): number;
-export declare function applyActiveTranslations(root?: ParentNode | null): number;
-export declare function restoreDom(root?: ParentNode | null): void;

package/dist/utils/markerEngineApply.js

@@ -1,136 +0,0 @@
-import { ATTRIBUTE_MARKS } from "./markerEngineConstants";
-import { findUnsafeContainer, isExcludedElement } from "./markerEngineFilters";
-import { isTranslatableText, normalizeWhitespace } from "./markerEngineDomUtils";
-import { getOrInitAttrOriginal, getOrInitTextOriginal, originalAttrByEl, originalTextByNode } from "./markerEngineOriginals";
-import { getActiveTranslationMap, setActiveTranslationMap } from "./markerEngineState";
-export 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);
-    }
-    setActiveTranslationMap(map);
-    return applyActiveTranslations(root);
-}
-export function applyActiveTranslations(root = document.body) {
-    const map = getActiveTranslationMap();
-    if (!root || !map || map.size === 0)
-        return 0;
-    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 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
-                }
-            }
-        });
-    }
-}

package/dist/utils/markerEngineConstants.d.ts

@@ -1,10 +0,0 @@
-export declare const DEFAULT_THROTTLE_MS = 150;
-export declare const DEFAULT_CRITICAL_BUFFER_PX = 200;
-export declare const DEFAULT_CRITICAL_MAX = 800;
-export declare const EXCLUDE_SELECTOR = "[data-lovalingo-exclude],[data-notranslate],[translate-no],[data-no-translate]";
-export declare const UNSAFE_CONTAINER_TAGS: Set<string>;
-export declare const ATTRIBUTE_MARKS: {
-    attr: string;
-    marker: string;
-}[];
-export declare const unsafeSelector: string;

package/dist/utils/markerEngineConstants.js

@@ -1,12 +0,0 @@
-// Why: keep marker scans cheap while still capturing a small above-the-fold "critical slice" for first paint.
-export const DEFAULT_THROTTLE_MS = 150;
-export const DEFAULT_CRITICAL_BUFFER_PX = 200;
-export const DEFAULT_CRITICAL_MAX = 800;
-export const EXCLUDE_SELECTOR = "[data-lovalingo-exclude],[data-notranslate],[translate-no],[data-no-translate]";
-export const UNSAFE_CONTAINER_TAGS = new Set(["script", "style", "noscript", "template", "svg", "canvas"]);
-export 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" },
-];
-export const unsafeSelector = Array.from(UNSAFE_CONTAINER_TAGS).join(",");

package/dist/utils/markerEngineCritical.d.ts

@@ -1,2 +0,0 @@
-import type { CriticalFingerprint } from "./markerEngineTypes";
-export declare function getCriticalFingerprint(): CriticalFingerprint;