@translation-cms/sync 1.2.28 → 1.2.29

package/dist/next.js

@@ -0,0 +1,110 @@
+/**
+ * Next.js Plugin for automatic translation sync
+ *
+ * Usage in next.config.ts:
+ *   import withTranslationsCMS from '@translation-cms/sync/next';
+ *
+ *   export default withTranslationsCMS(nextConfig, {
+ *       pullOnBuild: true,  // default
+ *       pullOnDev: true,    // default
+ *   });
+ */
+import path from 'path';
+import { runPull } from './commands/pull.js';
+import { resolveConfig, findProjectRoot, loadConfigFile, } from './config/resolve-config.js';
+import { getLastPulledTime } from './core/cache.js';
+import { pullTranslations } from './core/api.js';
+/**
+ * Higher-order function that wraps your Next.js config with automatic translation syncing.
+ *
+ * @param userConfig - Your existing next.config.ts configuration
+ * @param pluginOptions - Plugin-specific options
+ * @returns Enhanced Next.js configuration with sync hooks
+ */
+export function withTranslationsCMS(userConfig, pluginOptions = {}) {
+    const { pullOnBuild = true, pullOnDev = true, watchInterval = 10_000, } = pluginOptions;
+    let initialized = false;
+    // Initialize and run pull if needed
+    const initTranslations = async () => {
+        if (initialized)
+            return;
+        initialized = true;
+        try {
+            const root = findProjectRoot();
+            const fileConfig = loadConfigFile(root);
+            const config = resolveConfig(root, fileConfig);
+            // Only pull if we have valid configuration
+            if (config.cmsUrl && config.projectId && config.apiKey) {
+                const isDev = process.env.NODE_ENV === 'development';
+                const shouldPull = (isDev && pullOnDev) || (!isDev && pullOnBuild);
+                if (shouldPull) {
+                    await runPull(root, config, fileConfig, []);
+                }
+                // In dev mode, start a polling loop to auto-pull when the CMS publishes
+                if (isDev && watchInterval > 0) {
+                    const outputDir = fileConfig.outputDir
+                        ? path.resolve(root, fileConfig.outputDir)
+                        : path.join(root, 'public', 'locales');
+                    startWatcher(config, outputDir, watchInterval);
+                }
+            }
+        }
+        catch (error) {
+            // Log error but don't fail the build
+            // eslint-disable-next-line no-console
+            console.warn('Translation sync failed (continuing with build):', error instanceof Error ? error.message : String(error));
+        }
+    };
+    return {
+        ...userConfig,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        webpack: (config, context) => {
+            // Run sync on webpack initialization (first build/dev startup)
+            if (context.isServer && !initialized) {
+                // eslint-disable-next-line no-console
+                initTranslations().catch(console.error);
+            }
+            // Call any existing webpack config if provided
+            if (typeof userConfig?.webpack === 'function') {
+                return userConfig.webpack(config, context);
+            }
+            return config;
+        },
+    };
+}
+/**
+ * Poll the CMS status endpoint every `intervalMs` ms.
+ * When a publish newer than the last local pull is detected, re-pulls translations.
+ * Errors are silently swallowed so a temporarily unreachable CMS never crashes dev.
+ */
+function startWatcher(config, outputDir, intervalMs) {
+    const statusUrl = `${config.cmsUrl.replace(/\/$/, '')}/api/sync/${config.projectId}/status`;
+    const poll = async () => {
+        try {
+            const res = await fetch(statusUrl, {
+                headers: { 'x-api-key': config.apiKey },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!res.ok)
+                return;
+            const { lastPublishedAt } = (await res.json());
+            if (!lastPublishedAt)
+                return;
+            const lastPulled = getLastPulledTime(outputDir);
+            const publishedMs = new Date(lastPublishedAt).getTime();
+            if (lastPulled === null || publishedMs > lastPulled) {
+                // eslint-disable-next-line no-console
+                console.log('[CMS] New translations detected — pulling...');
+                await pullTranslations(config, { outputDir, force: true });
+            }
+        }
+        catch {
+            // Silently ignore — CMS may be unreachable or dev server starting up
+        }
+    };
+    setInterval(poll, intervalMs);
+    // eslint-disable-next-line no-console
+    console.log(`[CMS] Watching for translation updates every ${intervalMs / 1000}s`);
+}
+export default withTranslationsCMS;
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

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

package/dist/preview/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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';
+export { updateStateDisplay } from './internals/ui-indicators.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;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAuBlE,OAAO,KAAK,EAIR,sBAAsB,EACzB,MAAM,sBAAsB,CAAC;AAM9B;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAoC1E;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,IAAI,CAS7C"}

package/dist/preview/index.js

@@ -0,0 +1,123 @@
+/**
+ * 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 { updateStateDisplay } from './internals/ui-indicators.js';
+// 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';
+import { initInteractiveMode, cleanupInteractiveMode, } from './internals/interactive.js';
+import { injectUIIndicators, removeUIIndicators, } from './internals/ui-indicators.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 NOT in interactive mode
+    // and when running inside an iframe (i.e. the CMS preview context)
+    if (window.top !== window && !options?.interactiveMode) {
+        injectInteractionBlocker();
+    }
+    // Initialize interactive mode if enabled
+    if (options?.interactiveMode) {
+        initInteractiveMode();
+        injectUIIndicators();
+    }
+    console.log(`%c[CMS Preview] Ready ${options?.interactiveMode ? '(interactive mode)' : ''}`, '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();
+    cleanupInteractiveMode();
+    removeUIIndicators();
+    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,31 @@
+/**
+ * Translation highlighting logic.
+ * Handles searching for and highlighting elements that display translations.
+ */
+/**
+ * Find and highlight all DOM elements that display the given translation.
+ *
+ * Search order (first strategy that yields a match wins):
+ *   0. `data-cms-key` attribute  — precise, skips all heuristics
+ *   1. Exact text node match
+ *   2. Element content match     — handles text split across siblings
+ *   3. Normalized text node      — strips `{{interpolation}}` placeholders
+ *   4. Normalized element match
+ *   5. Key fallback              — used when `value` is empty (i18next renders the key)
+ */
+export declare function highlightTranslationKey(value: string, key: string): void;
+/**
+ * Remove the highlight class from all currently highlighted elements and
+ * reset the associated state (element list + search value).
+ */
+export declare function clearHighlights(): void;
+/**
+ * Patch the live text of highlighted elements as the user types a new
+ * translation value in the CMS panel.
+ *
+ * Searches each highlighted element's text nodes for the old value (or the
+ * last live value if the user is already mid-edit) and replaces it in place —
+ * no DOM re-render needed.
+ */
+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;AA+EH;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CA0ExE;AAoBD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAKtC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAwBvE"}

package/dist/preview/internals/highlight.js

@@ -0,0 +1,184 @@
+/**
+ * Translation highlighting logic.
+ * Handles searching for and highlighting elements that display translations.
+ */
+import * as state from './state.js';
+/**
+ * Strip interpolation placeholders (`{{var}}` and `{var}`) and collapse
+ * whitespace so that translated strings with variables can still be matched
+ * against the rendered text in the DOM.
+ */
+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 all text nodes in the document body and return the parent
+ * element of each node whose text includes `searchValue`.
+ * Excludes elements that are already highlighted to avoid double-wrapping.
+ */
+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))
+            continue;
+        const el = node.parentElement;
+        if (el && !el.classList.contains('cms-preview-highlight'))
+            results.push(el);
+    }
+    return results;
+}
+/**
+ * Strategy 2: find the most specific (shortest textContent) element in the
+ * document whose combined `textContent` includes `searchValue`.
+ *
+ * This works when the translated string is split across sibling text nodes,
+ * which the text-node walker cannot detect.
+ */
+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))
+            continue;
+        if (el.classList.contains('cms-preview-highlight'))
+            continue;
+        const len = el.textContent.length;
+        if (len < bestLen) {
+            bestLen = len;
+            best = el;
+        }
+    }
+    return best ? [best] : [];
+}
+/**
+ * Find and highlight all DOM elements that display the given translation.
+ *
+ * Search order (first strategy that yields a match wins):
+ *   0. `data-cms-key` attribute  — precise, skips all heuristics
+ *   1. Exact text node match
+ *   2. Element content match     — handles text split across siblings
+ *   3. Normalized text node      — strips `{{interpolation}}` placeholders
+ *   4. Normalized element match
+ *   5. Key fallback              — used when `value` is empty (i18next renders the key)
+ */
+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() !== '') {
+        // Primary: match on the raw translation value
+        candidates.push({ label: 'exact text node', search: value, fn: findByTextNodes }, {
+            label: 'element content',
+            search: value,
+            fn: findByElementContent,
+        });
+        // Secondary: also try the normalized form when the value contains interpolations
+        if (hasInterpolation && normalized) {
+            candidates.push({
+                label: 'normalized text node',
+                search: normalized,
+                fn: findByTextNodes,
+            }, {
+                label: 'normalized element',
+                search: normalized,
+                fn: findByElementContent,
+            });
+        }
+    }
+    else {
+        // Value is empty — i18next falls back to rendering the key itself as text
+        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)
+            continue;
+        state.setCurrentSearchValue(search);
+        applyHighlights(found, label);
+        return;
+    }
+    console.warn(`[CMS Preview] No elements found for key: "${key}" value: "${value}"`);
+}
+/**
+ * Add the highlight CSS class to each element and scroll the first one into
+ * view. Registers elements with the state module so `clearHighlights` can
+ * remove them later.
+ */
+function applyHighlights(elements, matchLabel) {
+    console.log(`[CMS Preview] Highlighting ${elements.length} element(s) via ${matchLabel}`);
+    for (let i = 0; i < elements.length; i++) {
+        const el = elements[i];
+        if (!el)
+            continue;
+        el.classList.add('cms-preview-highlight');
+        state.addHighlightedElement(el);
+        if (i === 0)
+            el.scrollIntoView({ behavior: 'smooth', block: 'center' });
+    }
+}
+/**
+ * Remove the highlight class from all currently highlighted elements and
+ * reset the associated state (element list + search value).
+ */
+export function clearHighlights() {
+    for (const el of state.highlightedElements)
+        el.classList.remove('cms-preview-highlight');
+    state.setHighlightedElements([]);
+    state.setCurrentSearchValue(null);
+}
+/**
+ * Patch the live text of highlighted elements as the user types a new
+ * translation value in the CMS panel.
+ *
+ * Searches each highlighted element's text nodes for the old value (or the
+ * last live value if the user is already mid-edit) and replaces it in place —
+ * no DOM re-render needed.
+ */
+export function updateLiveText(oldValue, newValue) {
+    if (state.highlightedElements.length === 0)
+        return;
+    // Prefer the last live value so repeated keystrokes replace the previous
+    // intermediate value rather than the original translation
+    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/interactive.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Interactive preview mode: allow clicks, form interactions, navigation.
+ * Editors can explore the app while seeing translations highlighted.
+ */
+/**
+ * Initialize interactive mode:
+ * - Allow form interactions (typing, selecting)
+ * - Intercept navigation to report back to CMS
+ * - Capture/restore app state when navigating
+ */
+export declare function initInteractiveMode(): void;
+/** Clean up interactive mode event listeners. */
+export declare function cleanupInteractiveMode(): void;
+//# sourceMappingURL=interactive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/preview/internals/interactive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAc1C;AAED,iDAAiD;AACjD,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}