@translation-cms/sync 1.2.1 → 1.2.4

package/dist/core/scanner-internals/types.js

@@ -0,0 +1,29 @@
+/**
+ * Types and constants used throughout the scanner module.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const DEFAULT_EXCLUDED_DIRS = new Set([
+    'node_modules',
+    '.next',
+    'dist',
+    '.git',
+    'out',
+    '.turbo',
+    'scripts',
+    'packages',
+    '.storybook',
+    'coverage',
+]);
+export const DEFAULT_SOURCE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+]);
+/** Return the route string key used for deduplication. */
+export function routeKey(r) {
+    return typeof r === 'string' ? r : r.route;
+}
+//# sourceMappingURL=types.js.map

package/dist/core/scanner-internals/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/scanner-internals/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACzC,cAAc;IACd,OAAO;IACP,MAAM;IACN,MAAM;IACN,KAAK;IACL,QAAQ;IACR,SAAS;IACT,UAAU;IACV,YAAY;IACZ,UAAU;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IAC7C,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;CACT,CAAC,CAAC;AAiDH,0DAA0D;AAC1D,MAAM,UAAU,QAAQ,CAAC,CAAe;IACpC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC"}

package/dist/core/scanner.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Main scanner orchestration.
+ * Coordinates the multi-pass scanning process for translation keys.
+ * Re-exports public types and functions for backward compatibility.
+ */
+export { DEFAULT_EXCLUDED_DIRS, DEFAULT_SOURCE_EXTENSIONS, type ScanOptions, type PreviewRoute, type NamespaceMap, routeKey, } from './scanner-internals/types.js';
+export { walkFiles } from './scanner-internals/file-walker.js';
+export { isRedirectOnlyPage, filePathToRoute, } from './scanner-internals/route-detector.js';
+export { extractKeysFromFile } from './scanner-internals/key-extractor.js';
+import { type ScanOptions, type NamespaceMap } from './scanner-internals/types.js';
+/**
+ * Scans the project for translation keys and optionally merges external preview routes.
+ *
+ * Pass 1: Scan all files, extracting keys and associating them with page/layout routes.
+ * Pass 2: For each page/layout, walk its import tree to assign keys in deeply-nested
+ *         components to the correct preview route.
+ * Pass 3: Merge external preview routes from database or config.
+ */
+export declare function scanProject(root: string, opts?: ScanOptions): NamespaceMap;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/core/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,QAAQ,GACX,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EACH,kBAAkB,EAClB,eAAe,GAClB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAG3E,OAAO,EAGH,KAAK,WAAW,EAChB,KAAK,YAAY,EAEpB,MAAM,8BAA8B,CAAC;AAatC;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,CAoG1E"}

package/dist/core/scanner.js

@@ -0,0 +1,113 @@
+/**
+ * Main scanner orchestration.
+ * Coordinates the multi-pass scanning process for translation keys.
+ * Re-exports public types and functions for backward compatibility.
+ */
+import path from 'path';
+// Re-export types and constants
+export { DEFAULT_EXCLUDED_DIRS, DEFAULT_SOURCE_EXTENSIONS, routeKey, } from './scanner-internals/types.js';
+// Re-export public functions from submodules
+export { walkFiles } from './scanner-internals/file-walker.js';
+export { isRedirectOnlyPage, filePathToRoute, } from './scanner-internals/route-detector.js';
+export { extractKeysFromFile } from './scanner-internals/key-extractor.js';
+// Import utilities needed for orchestration
+import { DEFAULT_EXCLUDED_DIRS, DEFAULT_SOURCE_EXTENSIONS, routeKey, } from './scanner-internals/types.js';
+import { walkFiles } from './scanner-internals/file-walker.js';
+import { filePathToRoute } from './scanner-internals/route-detector.js';
+import { extractKeysFromFile } from './scanner-internals/key-extractor.js';
+import { extractLocalImports, getLayoutChain, } from './scanner-internals/import-resolver.js';
+// ---------------------------------------------------------------------------
+// Project scan
+// ---------------------------------------------------------------------------
+/**
+ * Scans the project for translation keys and optionally merges external preview routes.
+ *
+ * Pass 1: Scan all files, extracting keys and associating them with page/layout routes.
+ * Pass 2: For each page/layout, walk its import tree to assign keys in deeply-nested
+ *         components to the correct preview route.
+ * Pass 3: Merge external preview routes from database or config.
+ */
+export function scanProject(root, opts) {
+    const excludedDirs = new Set([
+        ...DEFAULT_EXCLUDED_DIRS,
+        ...(opts?.excludedDirs ?? []),
+    ]);
+    const sourceExtensions = opts?.sourceExtensions
+        ? new Set(opts.sourceExtensions)
+        : DEFAULT_SOURCE_EXTENSIONS;
+    const routeParams = opts?.routeParams;
+    const pathMappings = opts?.pathMappings;
+    const projectRoot = opts?.projectRoot ?? root;
+    const result = {};
+    let fileCount = 0;
+    // Pass 1: scan all files normally
+    const routeByFile = new Map();
+    for (const file of walkFiles(root, excludedDirs, sourceExtensions)) {
+        const routes = filePathToRoute(root, file);
+        routeByFile.set(file, routes);
+        extractKeysFromFile(file, routes, result);
+        fileCount++;
+    }
+    // Pass 2: for each page/layout file, transitively walk its import tree and
+    // re-scan every non-page/layout component with the same routes. This ensures
+    // keys used in deeply-nested components (e.g. layout → Nav → NavItem) are
+    // associated with the correct preview routes.
+    const scannedWithRoute = new Set(); // "file::route" pairs already done
+    for (const [file, routes] of routeByFile) {
+        if (routes.length === 0)
+            continue;
+        const isPage = path.basename(file).startsWith('page.');
+        const layoutChain = isPage
+            ? getLayoutChain(root, file, sourceExtensions)
+            : [];
+        for (const layout of layoutChain) {
+            const layoutKey = `${layout}::${routes.join('|')}`;
+            if (!scannedWithRoute.has(layoutKey)) {
+                scannedWithRoute.add(layoutKey);
+                extractKeysFromFile(layout, routes, result);
+            }
+        }
+        const queue = [file, ...layoutChain];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            const imports = extractLocalImports(current, sourceExtensions, projectRoot, pathMappings);
+            if (imports.length > 0) {
+                console.log(`[Pass 2] ${path.relative(root, current)} (${routes.join(', ')}) imports: ${imports.map(i => path.relative(root, i)).join(', ')}`);
+            }
+            for (const imported of imports) {
+                const key = `${imported}::${routes.join('|')}`;
+                if (scannedWithRoute.has(key))
+                    continue;
+                scannedWithRoute.add(key);
+                if (!routeByFile.has(imported)) {
+                    console.log(`[Pass 2] Skipping ${path.relative(root, imported)} — not in walk result`);
+                    continue;
+                }
+                if (routeByFile.get(imported).length > 0)
+                    continue;
+                console.log(`[Pass 2] Re-scanning ${path.relative(root, imported)} with routes: ${routes.join(', ')}`);
+                extractKeysFromFile(imported, routes, result);
+                queue.push(imported);
+            }
+        }
+    }
+    // Pass 3: upgrade plain dynamic routes to { route, params } objects using routeParams
+    if (routeParams) {
+        for (const [, keyMap] of Object.entries(result)) {
+            for (const [key, routes] of keyMap.entries()) {
+                const upgraded = routes.map(r => {
+                    const rk = routeKey(r);
+                    const params = routeParams[rk];
+                    if (params && typeof r === 'string') {
+                        return { route: rk, params };
+                    }
+                    return r;
+                });
+                keyMap.set(key, upgraded);
+            }
+        }
+    }
+    console.log(`Scanned ${fileCount} files.`);
+    return result;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/core/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { initPreviewListener, cleanupPreviewListener, registerPreviewAction, unregisterPreviewAction, type PreviewListenerOptions, } from './preview.js';
-export { type TranslationsConfig } from './load-config.js';
+export { initPreviewListener, cleanupPreviewListener, type PreviewListenerOptions, } from './preview/index.js';
+export { type TranslationsConfig } from './config/resolve-config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,sBAAsB,GAC9B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,sBAAsB,GAC9B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-// In-context preview listener
-export { initPreviewListener, cleanupPreviewListener, registerPreviewAction, unregisterPreviewAction, } from './preview.js';
+// Browser: in-context preview listener
+export { initPreviewListener, cleanupPreviewListener, } from './preview/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GAE1B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EACH,mBAAmB,EACnB,sBAAsB,GAEzB,MAAM,oBAAoB,CAAC"}

package/dist/preview/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Translation CMS — Preview Listener
+ *
+ * Add this to your client app to enable live in-context preview of translations
+ * from the CMS. No per-component setup required.
+ *
+ * Usage in Next.js root layout:
+ * ```tsx
+ * 'use client';
+ * import { useEffect } from 'react';
+ * import { initPreviewListener, cleanupPreviewListener } from '@translation-cms/sync/preview';
+ *
+ * export function CMSPreview() {
+ *   useEffect(() => {
+ *     initPreviewListener({ onLocaleSwitch: (locale) => i18n.changeLanguage(locale) });
+ *     return () => cleanupPreviewListener();
+ *   }, []);
+ *   return null;
+ * }
+ * ```
+ *
+ * Precise highlighting (recommended):
+ * Add `data-cms-key="namespace:key"` to elements that render a translation.
+ * The listener will target those elements directly, bypassing text-search heuristics.
+ * ```tsx
+ * <h1 data-cms-key="blog:post.title">{t('blog:post.title')}</h1>
+ * ```
+ */
+export type { PreviewListenerOptions } from './internals/types.js';
+import type { PreviewListenerOptions } from './internals/types.js';
+/**
+ * Initialize the preview listener.
+ * Safe to call multiple times — only initialises once.
+ */
+export declare function initPreviewListener(options?: PreviewListenerOptions): void;
+/** Remove the preview listener and clear all highlights. */
+export declare function cleanupPreviewListener(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/preview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/preview/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAenE,OAAO,KAAK,EAIR,sBAAsB,EACzB,MAAM,sBAAsB,CAAC;AAM9B;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CA4B1E;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,IAAI,CAO7C"}

package/dist/preview/index.js

@@ -0,0 +1,114 @@
+/**
+ * Translation CMS — Preview Listener
+ *
+ * Add this to your client app to enable live in-context preview of translations
+ * from the CMS. No per-component setup required.
+ *
+ * Usage in Next.js root layout:
+ * ```tsx
+ * 'use client';
+ * import { useEffect } from 'react';
+ * import { initPreviewListener, cleanupPreviewListener } from '@translation-cms/sync/preview';
+ *
+ * export function CMSPreview() {
+ *   useEffect(() => {
+ *     initPreviewListener({ onLocaleSwitch: (locale) => i18n.changeLanguage(locale) });
+ *     return () => cleanupPreviewListener();
+ *   }, []);
+ *   return null;
+ * }
+ * ```
+ *
+ * Precise highlighting (recommended):
+ * Add `data-cms-key="namespace:key"` to elements that render a translation.
+ * The listener will target those elements directly, bypassing text-search heuristics.
+ * ```tsx
+ * <h1 data-cms-key="blog:post.title">{t('blog:post.title')}</h1>
+ * ```
+ */
+// Internal imports
+import * as state from './internals/state.js';
+import { highlightTranslationKey, clearHighlights, updateLiveText, } from './internals/highlight.js';
+import { handleLocaleSwitch } from './internals/locales.js';
+import { injectInteractionBlocker, removeInteractionBlocker, } from './internals/interactions.js';
+import { injectStyles } from './internals/styles.js';
+// ---------------------------------------------------------------------------
+// Public functions
+// ---------------------------------------------------------------------------
+/**
+ * Initialize the preview listener.
+ * Safe to call multiple times — only initialises once.
+ */
+export function initPreviewListener(options) {
+    if (state.isInitialized)
+        return;
+    const isDev = typeof window !== 'undefined' &&
+        (window.location.hostname === 'localhost' ||
+            window.location.hostname === '127.0.0.1' ||
+            window.location.search.includes('preview=true'));
+    if (!isDev) {
+        console.log('[CMS Preview] Not in development mode, skipping...');
+        return;
+    }
+    state.initializeState(options ?? {});
+    state.setIsInitialized(true);
+    window.addEventListener('message', handleMessage);
+    injectStyles();
+    // Only inject the interaction blocker when running inside an iframe
+    // (i.e. the CMS preview context). Opening the page directly on localhost
+    // should never have interactions blocked.
+    if (window.top !== window) {
+        injectInteractionBlocker();
+    }
+    console.log('%c[CMS Preview] Ready', 'color: #10b981; font-weight: bold;');
+}
+/** Remove the preview listener and clear all highlights. */
+export function cleanupPreviewListener() {
+    if (!state.isInitialized)
+        return;
+    window.removeEventListener('message', handleMessage);
+    removeInteractionBlocker();
+    clearHighlights();
+    state.resetState();
+    console.log('[CMS Preview] Listener cleaned up');
+}
+// ---------------------------------------------------------------------------
+// Message handler
+// ---------------------------------------------------------------------------
+function handleMessage(event) {
+    const { type } = (event.data ?? {});
+    if (type === 'CMS_HIGHLIGHT_KEY') {
+        const { key, value, locale } = event.data;
+        console.log(`[CMS Preview] Highlighting: ${key} (${locale}) = "${value}"`);
+        // Only switch locale when it actually changed. Switching unconditionally
+        // triggers a re-render in the consuming app, which replaces DOM nodes
+        // and immediately removes the highlight class we just applied.
+        if (locale && locale !== state.activeLocale) {
+            state.setActiveLocale(locale);
+            handleLocaleSwitch(locale);
+        }
+        state.setCurrentLiveValue(null);
+        state.setPendingHighlight({ key, value });
+        highlightTranslationKey(value, key);
+        // If no elements were found (e.g. dialog still animating open), schedule
+        // a backup retry after the animation should have settled.
+        if (state.highlightedElements.length === 0) {
+            setTimeout(() => {
+                if (state.pendingHighlight?.key === key) {
+                    console.log(`[CMS Preview] Retrying highlight for: ${key}`);
+                    highlightTranslationKey(value, key);
+                }
+            }, 600);
+        }
+    }
+    else if (type === 'CMS_LIVE_UPDATE') {
+        const { oldValue, newValue } = event.data;
+        updateLiveText(oldValue, newValue);
+    }
+    else if (type === 'CMS_SWITCH_LOCALE') {
+        const { locale } = event.data;
+        state.setActiveLocale(locale);
+        handleLocaleSwitch(locale);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/preview/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/preview/index.ts"],"names":[],"mappings":"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"}

package/dist/preview/internals/highlight.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Translation highlighting logic.
+ * Handles searching for and highlighting elements that display translations.
+ */
+/**
+ * Find and highlight DOM elements that display the given translation.
+ *
+ * Search order:
+ *   0. data-cms-key attribute match (precise — skips all heuristics)
+ *   1. Exact text node match
+ *   2. Element content match (handles split siblings)
+ *   3. Normalized text node match (strips {{interpolation}} placeholders)
+ *   4. Normalized element match
+ *   5. Key fallback (when value is empty — i18next renders the key as text)
+ */
+export declare function highlightTranslationKey(value: string, key: string): void;
+export declare function clearHighlights(): void;
+/**
+ * Update highlighted elements with live translation changes.
+ */
+export declare function updateLiveText(oldValue: string, newValue: string): void;
+//# sourceMappingURL=highlight.d.ts.map

package/dist/preview/internals/highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../../../src/preview/internals/highlight.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoEH;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAyExE;AAeD,wBAAgB,eAAe,IAAI,IAAI,CAMtC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAuBvE"}

package/dist/preview/internals/highlight.js

@@ -0,0 +1,153 @@
+/**
+ * Translation highlighting logic.
+ * Handles searching for and highlighting elements that display translations.
+ */
+import * as state from './state.js';
+function normalizeForSearch(value) {
+    return value
+        .replace(/\{\{[^}]+\}\}/g, '')
+        .replace(/\{[^}]+\}/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Strategy 0 (precise): find elements with data-cms-key="key" attribute.
+ * When present, this is always preferred over text-content heuristics.
+ */
+function findByDataAttribute(key) {
+    return Array.from(document.querySelectorAll(`[data-cms-key="${CSS.escape(key)}"]`));
+}
+/** Strategy 1: walk text nodes, return parent elements whose text includes value. */
+function findByTextNodes(searchValue) {
+    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, null);
+    const results = [];
+    let node;
+    while ((node = walker.nextNode())) {
+        if (node.textContent?.includes(searchValue)) {
+            const el = node.parentElement;
+            if (el && !el.classList.contains('cms-preview-highlight')) {
+                results.push(el);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Strategy 2: find the most specific element whose combined textContent
+ * includes the value. Works when text is split across siblings.
+ */
+function findByElementContent(searchValue) {
+    const all = Array.from(document.body.querySelectorAll('*'));
+    let best = null;
+    let bestLen = Infinity;
+    for (const el of all) {
+        if (el.textContent?.includes(searchValue) &&
+            !el.classList.contains('cms-preview-highlight')) {
+            const len = el.textContent.length;
+            if (len < bestLen) {
+                bestLen = len;
+                best = el;
+            }
+        }
+    }
+    return best ? [best] : [];
+}
+/**
+ * Find and highlight DOM elements that display the given translation.
+ *
+ * Search order:
+ *   0. data-cms-key attribute match (precise — skips all heuristics)
+ *   1. Exact text node match
+ *   2. Element content match (handles split siblings)
+ *   3. Normalized text node match (strips {{interpolation}} placeholders)
+ *   4. Normalized element match
+ *   5. Key fallback (when value is empty — i18next renders the key as text)
+ */
+export function highlightTranslationKey(value, key) {
+    clearHighlights();
+    // --- Strategy 0: data-cms-key attribute (precise) -----------------------
+    const byAttr = findByDataAttribute(key);
+    if (byAttr.length > 0) {
+        applyHighlights(byAttr, 'data-cms-key attribute');
+        return;
+    }
+    // --- Heuristic fallback strategies --------------------------------------
+    const normalized = value ? normalizeForSearch(value) : '';
+    const hasInterpolation = value ? normalized !== value : false;
+    const candidates = [];
+    if (value && value.trim() !== '') {
+        candidates.push({ label: 'exact text node', search: value, fn: findByTextNodes }, {
+            label: 'element content',
+            search: value,
+            fn: findByElementContent,
+        });
+        if (hasInterpolation && normalized) {
+            candidates.push({
+                label: 'normalized text node',
+                search: normalized,
+                fn: findByTextNodes,
+            }, {
+                label: 'normalized element',
+                search: normalized,
+                fn: findByElementContent,
+            });
+        }
+    }
+    else {
+        const keyWithoutNs = key.includes(':')
+            ? key.split(':').slice(1).join(':')
+            : key;
+        candidates.push({ label: 'key (full)', search: key, fn: findByTextNodes }, { label: 'key (no ns)', search: keyWithoutNs, fn: findByTextNodes }, { label: 'key element', search: key, fn: findByElementContent }, {
+            label: 'key element (no ns)',
+            search: keyWithoutNs,
+            fn: findByElementContent,
+        });
+    }
+    for (const { label, search, fn } of candidates) {
+        const found = fn(search);
+        if (found.length > 0) {
+            state.setCurrentSearchValue(search);
+            applyHighlights(found, label);
+            return;
+        }
+    }
+    console.warn(`[CMS Preview] No elements found for key: "${key}" value: "${value}"`);
+}
+function applyHighlights(elements, matchLabel) {
+    console.log(`[CMS Preview] Highlighting ${elements.length} element(s) via ${matchLabel}`);
+    elements.forEach((el, i) => {
+        el.classList.add('cms-preview-highlight');
+        state.addHighlightedElement(el);
+        if (i === 0) {
+            el.scrollIntoView({ behavior: 'smooth', block: 'center' });
+        }
+    });
+}
+export function clearHighlights() {
+    for (const el of state.highlightedElements) {
+        el.classList.remove('cms-preview-highlight');
+    }
+    state.setHighlightedElements([]);
+    state.setCurrentSearchValue(null);
+}
+/**
+ * Update highlighted elements with live translation changes.
+ */
+export function updateLiveText(oldValue, newValue) {
+    if (state.highlightedElements.length === 0)
+        return;
+    const searchFor = state.currentLiveValue ??
+        (oldValue || state.currentSearchValue) ??
+        oldValue;
+    for (const el of state.highlightedElements) {
+        const walker = document.createTreeWalker(el, NodeFilter.SHOW_TEXT, null);
+        let node;
+        while ((node = walker.nextNode())) {
+            if (node.nodeValue?.includes(searchFor)) {
+                node.nodeValue = node.nodeValue.replace(searchFor, newValue);
+            }
+        }
+    }
+    state.setCurrentLiveValue(newValue);
+}
+//# sourceMappingURL=highlight.js.map

package/dist/preview/internals/highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.js","sourceRoot":"","sources":["../../../src/preview/internals/highlight.ts"],"names":[],"mappings":"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"}

package/dist/preview/internals/interactions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Interaction blocking for preview mode.
+ * Prevents users from clicking links or submitting forms while previewing.
+ */
+/**
+ * Inject a transparent full-page overlay that absorbs pointer events,
+ * and register capture-phase listeners for belt-and-suspenders blocking
+ * (covers keyboard-activated links/buttons the overlay doesn't intercept).
+ */
+export declare function injectInteractionBlocker(): void;
+/**
+ * Remove interaction blocker and event listeners.
+ */
+export declare function removeInteractionBlocker(): void;
+//# sourceMappingURL=interactions.d.ts.map

package/dist/preview/internals/interactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../../src/preview/internals/interactions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAU/C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C"}

package/dist/preview/internals/interactions.js

@@ -0,0 +1,38 @@
+/**
+ * Interaction blocking for preview mode.
+ * Prevents users from clicking links or submitting forms while previewing.
+ */
+import * as state from './state.js';
+/**
+ * Capture-phase handler that swallows all clicks and form submits.
+ * Prevents links from navigating and buttons from firing actions.
+ */
+function blockInteraction(e) {
+    e.preventDefault();
+    e.stopPropagation();
+}
+/**
+ * Inject a transparent full-page overlay that absorbs pointer events,
+ * and register capture-phase listeners for belt-and-suspenders blocking
+ * (covers keyboard-activated links/buttons the overlay doesn't intercept).
+ */
+export function injectInteractionBlocker() {
+    const overlay = document.createElement('div');
+    overlay.id = 'cms-preview-blocker';
+    overlay.style.cssText =
+        'position:fixed;inset:0;z-index:9997;pointer-events:all;cursor:default;';
+    document.body.appendChild(overlay);
+    state.setInteractionBlockerOverlay(overlay);
+    document.addEventListener('click', blockInteraction, true);
+    document.addEventListener('submit', blockInteraction, true);
+}
+/**
+ * Remove interaction blocker and event listeners.
+ */
+export function removeInteractionBlocker() {
+    document.removeEventListener('click', blockInteraction, true);
+    document.removeEventListener('submit', blockInteraction, true);
+    state.interactionBlockerOverlay?.remove();
+    state.setInteractionBlockerOverlay(null);
+}
+//# sourceMappingURL=interactions.js.map

package/dist/preview/internals/interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../../src/preview/internals/interactions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC;;;GAGG;AACH,SAAS,gBAAgB,CAAC,CAAQ;IAC9B,CAAC,CAAC,cAAc,EAAE,CAAC;IACnB,CAAC,CAAC,eAAe,EAAE,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,GAAG,qBAAqB,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,OAAO;QACjB,wEAAwE,CAAC;IAC7E,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAE5C,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACpC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC9D,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC/D,KAAK,CAAC,yBAAyB,EAAE,MAAM,EAAE,CAAC;IAC1C,KAAK,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/preview/internals/locales.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Locale switching logic for preview listener.
+ */
+/**
+ * Handle a locale switch request from the CMS.
+ * Tries the provided callback first, then falls back to window.__cmsSetLocale.
+ */
+export declare function handleLocaleSwitch(locale: string): void;
+//# sourceMappingURL=locales.d.ts.map

package/dist/preview/internals/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/preview/internals/locales.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAmBvD"}