@translation-cms/sync 1.2.28 → 1.2.30

package/dist/preview/internals/interactive.js

@@ -0,0 +1,122 @@
+/**
+ * Interactive preview mode: allow clicks, form interactions, navigation.
+ * Editors can explore the app while seeing translations highlighted.
+ */
+import * as state from './state.js';
+import { updateStateDisplay } from './ui-indicators.js';
+/**
+ * Initialize interactive mode:
+ * - Allow form interactions (typing, selecting)
+ * - Intercept navigation to report back to CMS
+ * - Capture/restore app state when navigating
+ */
+export function initInteractiveMode() {
+    if (!window.top || window.top === window) {
+        // Not in an iframe — no need to intercept navigation
+        return;
+    }
+    // Capture state before navigation
+    window.addEventListener('click', handleLinkClick, true);
+    window.addEventListener('submit', handleFormSubmit, true);
+    // Track URL changes (for Single Page Apps)
+    trackURLChanges();
+    console.log('[CMS Preview] Interactive mode enabled');
+}
+/** Clean up interactive mode event listeners. */
+export function cleanupInteractiveMode() {
+    window.removeEventListener('click', handleLinkClick, true);
+    window.removeEventListener('submit', handleFormSubmit, true);
+}
+// ---------------------------------------------------------------------------
+// Event handlers
+// ---------------------------------------------------------------------------
+/**
+ * Intercept link clicks to:
+ * 1. Capture current app state
+ * 2. Report navigation to CMS
+ * 3. Wait for page load, then restore state
+ */
+function handleLinkClick(event) {
+    const elem = event.target;
+    const link = elem.closest('a');
+    if (!link || !link.href)
+        return;
+    // Don't intercept external links or special links
+    if (link.target === '_blank' ||
+        link.target === '_parent' ||
+        link.target === '_top' ||
+        link.hasAttribute('download')) {
+        return;
+    }
+    // Check if it's a navigation link (not anchor-only)
+    const url = new URL(link.href);
+    const currentUrl = new URL(window.location.href);
+    // If it's just an anchor change, don't capture state
+    if (url.hostname === currentUrl.hostname &&
+        url.pathname === currentUrl.pathname &&
+        url.search === currentUrl.search &&
+        url.hash !== currentUrl.hash) {
+        return;
+    }
+    // Capture state before navigation
+    const appState = state.stateCapture?.();
+    // Report navigation to CMS
+    reportNavigation(url.href, appState);
+    // Set up state restoration after page loads
+    if (appState && state.stateRestore) {
+        window.addEventListener('load', () => {
+            state.stateRestore?.(appState);
+        });
+    }
+}
+/**
+ * Intercept form submissions to report to CMS.
+ */
+function handleFormSubmit(event) {
+    const form = event.target;
+    if (!form || !form.action)
+        return;
+    const appState = state.stateCapture?.();
+    reportNavigation(form.action, appState);
+}
+/**
+ * Track URL changes in Single Page Apps (detect history pushes).
+ */
+function trackURLChanges() {
+    const originalPushState = window.history.pushState;
+    const originalReplaceState = window.history.replaceState;
+    window.history.pushState = function (state, unused, url) {
+        const result = originalPushState.call(window.history, state, unused, url);
+        if (url)
+            reportNavigation(String(url));
+        return result;
+    };
+    window.history.replaceState = function (state, unused, url) {
+        const result = originalReplaceState.call(window.history, state, unused, url);
+        if (url)
+            reportNavigation(String(url));
+        return result;
+    };
+}
+// ---------------------------------------------------------------------------
+// Message reporting
+// ---------------------------------------------------------------------------
+/**
+ * Send navigation event to CMS.
+ * Allows the CMS to know which route/URL we're viewing.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function reportNavigation(url, appState) {
+    if (!window.top || window.top === window)
+        return;
+    const message = {
+        type: 'CMS_NAVIGATE',
+        url,
+        state: appState,
+    };
+    // Update UI displays
+    updateStateDisplay(appState);
+    window.top.postMessage(message, '*');
+    console.log(`[CMS Preview] Navigated to: ${url}`);
+}
+//# sourceMappingURL=interactive.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../../src/preview/internals/interactive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC;QACvC,qDAAqD;QACrD,OAAO;IACX,CAAC;IAED,kCAAkC;IAClC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAE1D,2CAA2C;IAC3C,eAAe,EAAE,CAAC;IAElB,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AAC1D,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,sBAAsB;IAClC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAAY;IACjC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAqB,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAsB,CAAC;IAEpD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO;IAEhC,kDAAkD;IAClD,IACI,IAAI,CAAC,MAAM,KAAK,QAAQ;QACxB,IAAI,CAAC,MAAM,KAAK,SAAS;QACzB,IAAI,CAAC,MAAM,KAAK,MAAM;QACtB,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAC/B,CAAC;QACC,OAAO;IACX,CAAC;IAED,oDAAoD;IACpD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEjD,qDAAqD;IACrD,IACI,GAAG,CAAC,QAAQ,KAAK,UAAU,CAAC,QAAQ;QACpC,GAAG,CAAC,QAAQ,KAAK,UAAU,CAAC,QAAQ;QACpC,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM;QAChC,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,EAC9B,CAAC;QACC,OAAO;IACX,CAAC;IAED,kCAAkC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;IAExC,2BAA2B;IAC3B,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAErC,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACjC,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;YACjC,KAAK,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACP,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAY;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAyB,CAAC;IAC7C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO;IAElC,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;IACxC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAS,eAAe;IACpB,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IACnD,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;IAEzD,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,UACvB,KAAU,EACV,MAAc,EACd,GAAyB;QAEzB,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CACjC,MAAM,CAAC,OAAO,EACd,KAAK,EACL,MAAM,EACN,GAAG,CACN,CAAC;QACF,IAAI,GAAG;YAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,YAAY,GAAG,UAC1B,KAAU,EACV,MAAc,EACd,GAAyB;QAEzB,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CACpC,MAAM,CAAC,OAAO,EACd,KAAK,EACL,MAAM,EACN,GAAG,CACN,CAAC;QACF,IAAI,GAAG;YAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;GAGG;AACH,8DAA8D;AAC9D,SAAS,gBAAgB,CAAC,GAAW,EAAE,QAA8B;IACjE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO;IAEjD,MAAM,OAAO,GAAuB;QAChC,IAAI,EAAE,cAAc;QACpB,GAAG;QACH,KAAK,EAAE,QAAQ;KAClB,CAAC;IAEF,qBAAqB;IAErB,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAE7B,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;AACtD,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"}

package/dist/preview/internals/locales.js

@@ -0,0 +1,24 @@
+/**
+ * Locale switching logic for preview listener.
+ */
+import * as state from './state.js';
+/**
+ * Handle a locale switch request from the CMS.
+ * Tries the provided callback first, then falls back to window.__cmsSetLocale.
+ */
+export function handleLocaleSwitch(locale) {
+    console.log(`[CMS Preview] Switching locale to: ${locale}`);
+    if (state.opts.onLocaleSwitch) {
+        state.opts.onLocaleSwitch(locale);
+        return;
+    }
+    // Fallback: look for window.__cmsSetLocale (set by the consuming app)
+    const globalObj = globalThis;
+    if (typeof globalObj['__cmsSetLocale'] === 'function') {
+        globalObj['__cmsSetLocale'](locale);
+        return;
+    }
+    console.warn('[CMS Preview] No locale switch handler found. ' +
+        'Provide onLocaleSwitch option or expose window.__cmsSetLocale(locale).');
+}
+//# sourceMappingURL=locales.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locales.js","sourceRoot":"","sources":["../../../src/preview/internals/locales.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC7C,OAAO,CAAC,GAAG,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;IAE5D,IAAI,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO;IACX,CAAC;IAED,sEAAsE;IACtE,MAAM,SAAS,GAAG,UAAqC,CAAC;IACxD,IAAI,OAAO,SAAS,CAAC,gBAAgB,CAAC,KAAK,UAAU,EAAE,CAAC;QACnD,SAAS,CAAC,gBAAgB,CAAyB,CAAC,MAAM,CAAC,CAAC;QAC7D,OAAO;IACX,CAAC;IAED,OAAO,CAAC,IAAI,CACR,gDAAgD;QAC5C,wEAAwE,CAC/E,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * State management for preview listener.
+ */
+import type { PreviewListenerOptions } from './types.js';
+export declare let isInitialized: boolean;
+export declare let highlightedElements: HTMLElement[];
+export declare let opts: PreviewListenerOptions;
+export declare let currentLiveValue: string | null;
+export declare let currentSearchValue: string | null;
+export declare let activeLocale: string | null;
+export declare let interactionBlockerOverlay: HTMLDivElement | null;
+export declare let pendingHighlight: {
+    key: string;
+    value: string;
+} | null;
+export declare let stateCapture: (() => Record<string, any>) | undefined;
+export declare let stateRestore: ((state: Record<string, any>) => void) | undefined;
+/**
+ * Reset all state when cleaning up.
+ */
+export declare function resetState(): void;
+/**
+ * Initialize state with global values.
+ */
+export declare function initializeState(options: PreviewListenerOptions): void;
+export declare function setIsInitialized(value: boolean): void;
+export declare function setActiveLocale(value: string | null): void;
+export declare function setCurrentLiveValue(value: string | null): void;
+export declare function setPendingHighlight(value: {
+    key: string;
+    value: string;
+} | null): void;
+export declare function setCurrentSearchValue(value: string | null): void;
+export declare function setHighlightedElements(value: HTMLElement[]): void;
+export declare function addHighlightedElement(el: HTMLElement): void;
+export declare function setInteractionBlockerOverlay(value: HTMLDivElement | null): void;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/preview/internals/state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,eAAO,IAAI,aAAa,SAAQ,CAAC;AACjC,eAAO,IAAI,mBAAmB,EAAE,WAAW,EAAO,CAAC;AACnD,eAAO,IAAI,IAAI,EAAE,sBAA2B,CAAC;AAC7C,eAAO,IAAI,gBAAgB,EAAE,MAAM,GAAG,IAAW,CAAC;AAClD,eAAO,IAAI,kBAAkB,EAAE,MAAM,GAAG,IAAW,CAAC;AACpD,eAAO,IAAI,YAAY,EAAE,MAAM,GAAG,IAAW,CAAC;AAC9C,eAAO,IAAI,yBAAyB,EAAE,cAAc,GAAG,IAAW,CAAC;AACnE,eAAO,IAAI,gBAAgB,EAAE;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB,GAAG,IAAW,CAAC;AAIhB,eAAO,IAAI,YAAY,EAAE,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;AAEjE,eAAO,IAAI,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;AAE5E;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAWjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAYrE;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAErD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE9D;AAED,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC7C,IAAI,CAEN;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAEjE;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAE3D;AAED,wBAAgB,4BAA4B,CACxC,KAAK,EAAE,cAAc,GAAG,IAAI,GAC7B,IAAI,CAEN"}

package/dist/preview/internals/state.js

@@ -0,0 +1,74 @@
+/**
+ * State management for preview listener.
+ */
+export let isInitialized = false;
+export let highlightedElements = [];
+export let opts = {};
+export let currentLiveValue = null;
+export let currentSearchValue = null;
+export let activeLocale = null;
+export let interactionBlockerOverlay = null;
+export let pendingHighlight = null;
+// Interactive mode callbacks
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export let stateCapture;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export let stateRestore;
+/**
+ * Reset all state when cleaning up.
+ */
+export function resetState() {
+    isInitialized = false;
+    highlightedElements = [];
+    opts = {};
+    currentLiveValue = null;
+    currentSearchValue = null;
+    activeLocale = null;
+    interactionBlockerOverlay = null;
+    pendingHighlight = null;
+    stateCapture = undefined;
+    stateRestore = undefined;
+}
+/**
+ * Initialize state with global values.
+ */
+export function initializeState(options) {
+    opts = options;
+    stateCapture = options.stateCapture;
+    stateRestore = options.stateRestore;
+    // Seed activeLocale from the URL's ?locale= param so that the first
+    // CMS_HIGHLIGHT_KEY doesn't needlessly trigger a locale switch (and
+    // re-render) when the iframe already loaded with the correct locale.
+    try {
+        activeLocale = new URL(window.location.href).searchParams.get('locale');
+    }
+    catch {
+        activeLocale = null;
+    }
+}
+// Setter functions for accessing from different modules
+export function setIsInitialized(value) {
+    isInitialized = value;
+}
+export function setActiveLocale(value) {
+    activeLocale = value;
+}
+export function setCurrentLiveValue(value) {
+    currentLiveValue = value;
+}
+export function setPendingHighlight(value) {
+    pendingHighlight = value;
+}
+export function setCurrentSearchValue(value) {
+    currentSearchValue = value;
+}
+export function setHighlightedElements(value) {
+    highlightedElements = value;
+}
+export function addHighlightedElement(el) {
+    highlightedElements.push(el);
+}
+export function setInteractionBlockerOverlay(value) {
+    interactionBlockerOverlay = value;
+}
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/preview/internals/state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,IAAI,aAAa,GAAG,KAAK,CAAC;AACjC,MAAM,CAAC,IAAI,mBAAmB,GAAkB,EAAE,CAAC;AACnD,MAAM,CAAC,IAAI,IAAI,GAA2B,EAAE,CAAC;AAC7C,MAAM,CAAC,IAAI,gBAAgB,GAAkB,IAAI,CAAC;AAClD,MAAM,CAAC,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AACpD,MAAM,CAAC,IAAI,YAAY,GAAkB,IAAI,CAAC;AAC9C,MAAM,CAAC,IAAI,yBAAyB,GAA0B,IAAI,CAAC;AACnE,MAAM,CAAC,IAAI,gBAAgB,GAGhB,IAAI,CAAC;AAEhB,6BAA6B;AAC7B,8DAA8D;AAC9D,MAAM,CAAC,IAAI,YAAqD,CAAC;AACjE,8DAA8D;AAC9D,MAAM,CAAC,IAAI,YAAgE,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,UAAU;IACtB,aAAa,GAAG,KAAK,CAAC;IACtB,mBAAmB,GAAG,EAAE,CAAC;IACzB,IAAI,GAAG,EAAE,CAAC;IACV,gBAAgB,GAAG,IAAI,CAAC;IACxB,kBAAkB,GAAG,IAAI,CAAC;IAC1B,YAAY,GAAG,IAAI,CAAC;IACpB,yBAAyB,GAAG,IAAI,CAAC;IACjC,gBAAgB,GAAG,IAAI,CAAC;IACxB,YAAY,GAAG,SAAS,CAAC;IACzB,YAAY,GAAG,SAAS,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC3D,IAAI,GAAG,OAAO,CAAC;IACf,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACpC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACpC,oEAAoE;IACpE,oEAAoE;IACpE,qEAAqE;IACrE,IAAI,CAAC;QACD,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACL,YAAY,GAAG,IAAI,CAAC;IACxB,CAAC;AACL,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC3C,aAAa,GAAG,KAAK,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAoB;IAChD,YAAY,GAAG,KAAK,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACpD,gBAAgB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAC/B,KAA4C;IAE5C,gBAAgB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACtD,kBAAkB,GAAG,KAAK,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAoB;IACvD,mBAAmB,GAAG,KAAK,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAe;IACjD,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,4BAA4B,CACxC,KAA4B;IAE5B,yBAAyB,GAAG,KAAK,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * CSS styles for preview highlight elements.
+ */
+/**
+ * Inject highlight styles into the document.
+ */
+export declare function injectStyles(): void;
+//# sourceMappingURL=styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/preview/internals/styles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAoBnC"}

package/dist/preview/internals/styles.js

@@ -0,0 +1,28 @@
+/**
+ * CSS styles for preview highlight elements.
+ */
+import * as state from './state.js';
+/**
+ * Inject highlight styles into the document.
+ */
+export function injectStyles() {
+    const custom = state.opts.highlightStyles ?? {};
+    const outline = custom.outline ?? '2px solid #3B82F6';
+    const outlineOffset = custom.outlineOffset ?? '3px';
+    const borderRadius = custom.borderRadius ?? '3px';
+    const backgroundColor = custom.backgroundColor ?? 'transparent';
+    const style = document.createElement('style');
+    style.textContent = `
+        .cms-preview-highlight {
+            outline: ${outline} !important;
+            outline-offset: ${outlineOffset} !important;
+            border-radius: ${borderRadius};
+            background-color: ${backgroundColor};
+            position: relative;
+            z-index: 9999;
+            transition: outline 0.15s ease;
+        }
+    `;
+    document.head.appendChild(style);
+}
+//# sourceMappingURL=styles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../src/preview/internals/styles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,YAAY;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,mBAAmB,CAAC;IACtD,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC;IACpD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC;IAClD,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,aAAa,CAAC;IAEhE,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,KAAK,CAAC,WAAW,GAAG;;uBAED,OAAO;8BACA,aAAa;6BACd,YAAY;gCACT,eAAe;;;;;KAK1C,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * Message types and public API types for preview listener.
+ */
+export interface CMSHighlightMessage {
+    type: 'CMS_HIGHLIGHT_KEY';
+    key: string;
+    value: string;
+    locale: string;
+}
+export interface CMSLiveUpdateMessage {
+    type: 'CMS_LIVE_UPDATE';
+    oldValue: string;
+    newValue: string;
+}
+/**
+ * Switch the active locale without reloading the page.
+ * Requires your app to expose a `window.__cmsSetLocale(locale)` callback.
+ * The CMS sends this when the user changes locale in the preview toolbar.
+ */
+export interface CMSSwitchLocaleMessage {
+    type: 'CMS_SWITCH_LOCALE';
+    locale: string;
+}
+/**
+ * Sent from app to CMS when user navigates in interactive mode.
+ * Allows CMS to track which route the editor is viewing.
+ */
+export interface CMSNavigateMessage {
+    type: 'CMS_NAVIGATE';
+    url: string;
+    state?: Record<string, any>;
+}
+export interface PreviewListenerOptions {
+    /**
+     * Custom CSS to apply to highlighted elements.
+     * If not provided, uses default blue outline.
+     */
+    highlightStyles?: {
+        outline?: string;
+        outlineOffset?: string;
+        borderRadius?: string;
+        backgroundColor?: string;
+    };
+    /**
+     * Called when the CMS requests a locale switch.
+     * Use this to integrate with your i18n library:
+     *
+     * ```ts
+     * initPreviewListener({
+     *   onLocaleSwitch: (locale) => i18n.changeLanguage(locale),
+     * });
+     * ```
+     *
+     * When omitted, the listener looks for `window.__cmsSetLocale(locale)`.
+     */
+    onLocaleSwitch?: (locale: string) => void;
+    /**
+     * Enable interactive mode: allow clicks, form interactions, navigation.
+     * When enabled, the preview is fully interactive instead of read-only.
+     * @default false
+     */
+    interactiveMode?: boolean;
+    /**
+     * Capture the current app state (e.g., open dialogs, form values).
+     * Called before navigation to preserve context.
+     */
+    stateCapture?: () => Record<string, any>;
+    /**
+     * Restore app state after navigation (e.g., reopen dialogs).
+     * Allows editors to maintain their position when clicking through.
+     */
+    stateRestore?: (state: Record<string, any>) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/preview/internals/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAMD,MAAM,WAAW,sBAAsB;IACnC;;;OAGG;IACH,eAAe,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IAEH,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC;;;OAGG;IAEH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CACvD"}

package/dist/preview/internals/types.js

@@ -0,0 +1,5 @@
+/**
+ * Message types and public API types for preview listener.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/preview/internals/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/preview/internals/ui-indicators.d.ts

@@ -0,0 +1,15 @@
+/**
+ * UI Indicators for interactive preview mode.
+ * Shows current URL, state, and navigation feedback.
+ */
+/**
+ * Create and inject the UI breadcrumb bar showing current URL/state.
+ */
+export declare function injectUIIndicators(): void;
+/** Remove UI indicators. */
+export declare function removeUIIndicators(): void;
+/**
+ * Update the state display (e.g., showing captured state summary).
+ */
+export declare function updateStateDisplay(state: Record<string, any> | undefined): void;
+//# sourceMappingURL=ui-indicators.d.ts.map

package/dist/preview/internals/ui-indicators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-indicators.d.ts","sourceRoot":"","sources":["../../../src/preview/internals/ui-indicators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAkDzC;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GACvC,IAAI,CAqBN"}

package/dist/preview/internals/ui-indicators.js

@@ -0,0 +1,92 @@
+/**
+ * UI Indicators for interactive preview mode.
+ * Shows current URL, state, and navigation feedback.
+ */
+/**
+ * Create and inject the UI breadcrumb bar showing current URL/state.
+ */
+export function injectUIIndicators() {
+    // Create container
+    const container = document.createElement('div');
+    container.id = 'cms-preview-ui-indicators';
+    container.setAttribute('data-cms-ui', 'true');
+    container.innerHTML = `
+    <div style="
+        position: fixed;
+        top: 0;
+        left: 0;
+        right: 0;
+        height: 40px;
+        background: #3b82f6;
+        color: white;
+        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+        font-size: 12px;
+        padding: 8px 16px;
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        box-shadow: 0 2px 8px rgba(0,0,0,0.15);
+        z-index: 2147483647;
+        gap: 16px;
+    ">
+        <div style="flex: 1; display: flex; align-items: center; gap: 8px;">
+            <span style="
+                font-weight: 600;
+                padding: 2px 8px;
+                background: rgba(255,255,255,0.2);
+                border-radius: 4px;
+                white-space: nowrap;
+            ">CMS Preview</span>
+        </div>
+        <div id="cms-ui-state" style="
+            font-size: 10px;
+            padding: 2px 8px;
+            background: rgba(0,0,0,0.1);
+            border-radius: 4px;
+            max-width: 200px;
+            overflow: hidden;
+            text-overflow: ellipsis;
+        "></div>
+    </div>
+    `;
+    document.body?.insertBefore(container, document.body.firstChild);
+    // Adjust body padding to make room for the indicator
+    document.body.style.paddingTop = '40px';
+    console.log('[CMS Preview] UI indicators injected');
+}
+/** Remove UI indicators. */
+export function removeUIIndicators() {
+    const container = document.getElementById('cms-preview-ui-indicators');
+    if (container) {
+        container.remove();
+        // Restore body padding
+        document.body.style.paddingTop = '0px';
+    }
+}
+/**
+ * Update the state display (e.g., showing captured state summary).
+ */
+export function updateStateDisplay(state) {
+    const stateEl = document.getElementById('cms-ui-state');
+    if (!stateEl)
+        return;
+    if (!state || Object.keys(state).length === 0) {
+        stateEl.textContent = '';
+        return;
+    }
+    // Show a summary of captured state
+    const summary = Object.entries(state)
+        .map(([key, val]) => {
+        if (typeof val === 'number')
+            return `${key}: ${val}`;
+        if (typeof val === 'boolean')
+            return `${key}: ${val}`;
+        if (typeof val === 'string')
+            return `${key}: "${val.slice(0, 10)}"`;
+        return `${key}: …`;
+    })
+        .slice(0, 3)
+        .join(', ');
+    stateEl.textContent = `State: ${summary}${Object.keys(state).length > 3 ? '…' : ''}`;
+}
+//# sourceMappingURL=ui-indicators.js.map

package/dist/preview/internals/ui-indicators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-indicators.js","sourceRoot":"","sources":["../../../src/preview/internals/ui-indicators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAC9B,mBAAmB;IACnB,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,GAAG,2BAA2B,CAAC;IAC3C,SAAS,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC9C,SAAS,CAAC,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsCrB,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEjE,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;AACxD,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,kBAAkB;IAC9B,MAAM,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC,2BAA2B,CAAC,CAAC;IACvE,IAAI,SAAS,EAAE,CAAC;QACZ,SAAS,CAAC,MAAM,EAAE,CAAC;QACnB,uBAAuB;QACvB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;IAC3C,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAC9B,KAAsC;IAEtC,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,WAAW,GAAG,EAAE,CAAC;QACzB,OAAO;IACX,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;QAChB,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,GAAG,KAAK,GAAG,EAAE,CAAC;QACrD,IAAI,OAAO,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,GAAG,KAAK,GAAG,EAAE,CAAC;QACtD,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;QACpE,OAAO,GAAG,GAAG,KAAK,CAAC;IACvB,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhB,OAAO,CAAC,WAAW,GAAG,UAAU,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACzF,CAAC"}

package/dist/scaffold/index.d.ts

@@ -0,0 +1,3 @@
+export { scaffoldI18n } from './intenrals/scaffold.js';
+export type { ScaffoldOptions, ScaffoldResult } from './intenrals/types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/scaffold/index.js

@@ -0,0 +1,3 @@
+// Re-export public API
+export { scaffoldI18n } from './intenrals/scaffold.js';
+//# sourceMappingURL=index.js.map

package/dist/scaffold/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/scaffold/intenrals/scaffold.d.ts

@@ -0,0 +1,24 @@
+/**
+ * i18n scaffolding logic.
+ * Creates i18n configuration files and dictionary placeholders.
+ */
+import { ScaffoldOptions, ScaffoldResult } from './types.js';
+/**
+ * Generate the i18n boilerplate inside `opts.i18nDir` (e.g. `src/lib/i18n/`).
+ *
+ * Writes five TypeScript modules and two placeholder JSON dictionaries:
+ *   - `settings.ts`          — locale list, default locale, namespace config
+ *   - `types.ts`             — shared `I18nKey` type and locale type
+ *   - `client.ts`            — `useTranslation` re-export for client components
+ *   - `server.ts`            — `getTranslation` helper for server components
+ *   - `provider.tsx`         — `<I18nProvider>` wrapper component
+ *   - `dictionaries/en.json` — empty English dictionary placeholder
+ *   - `dictionaries/nl.json` — empty Dutch dictionary placeholder
+ *
+ * Existing files are skipped unless `overwrite: true` is set, so re-running
+ * the command after the user has edited their i18n setup is safe by default.
+ *
+ * @returns Lists of written and skipped relative paths for CLI reporting.
+ */
+export declare function scaffoldI18n(opts: ScaffoldOptions): ScaffoldResult;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold/intenrals/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/scaffold/intenrals/scaffold.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAgClE"}

package/dist/scaffold/intenrals/scaffold.js

@@ -0,0 +1,53 @@
+/**
+ * i18n scaffolding logic.
+ * Creates i18n configuration files and dictionary placeholders.
+ */
+import fs from 'fs';
+import path from 'path';
+import { SETTINGS_TS, TYPES_TS, CLIENT_TS, SERVER_TS, PROVIDER_TSX, PLACEHOLDER_DICT, } from './templates.js';
+/**
+ * Generate the i18n boilerplate inside `opts.i18nDir` (e.g. `src/lib/i18n/`).
+ *
+ * Writes five TypeScript modules and two placeholder JSON dictionaries:
+ *   - `settings.ts`          — locale list, default locale, namespace config
+ *   - `types.ts`             — shared `I18nKey` type and locale type
+ *   - `client.ts`            — `useTranslation` re-export for client components
+ *   - `server.ts`            — `getTranslation` helper for server components
+ *   - `provider.tsx`         — `<I18nProvider>` wrapper component
+ *   - `dictionaries/en.json` — empty English dictionary placeholder
+ *   - `dictionaries/nl.json` — empty Dutch dictionary placeholder
+ *
+ * Existing files are skipped unless `overwrite: true` is set, so re-running
+ * the command after the user has edited their i18n setup is safe by default.
+ *
+ * @returns Lists of written and skipped relative paths for CLI reporting.
+ */
+export function scaffoldI18n(opts) {
+    const { i18nDir, overwrite = false } = opts;
+    const dictsDir = path.join(i18nDir, 'dictionaries');
+    // Ensure both the i18n root and the dictionaries sub-directory exist
+    fs.mkdirSync(dictsDir, { recursive: true });
+    const files = [
+        { rel: 'settings.ts', content: SETTINGS_TS },
+        { rel: 'types.ts', content: TYPES_TS },
+        { rel: 'client.ts', content: CLIENT_TS },
+        { rel: 'server.ts', content: SERVER_TS },
+        { rel: 'provider.tsx', content: PROVIDER_TSX },
+        { rel: 'dictionaries/en.json', content: PLACEHOLDER_DICT },
+        { rel: 'dictionaries/nl.json', content: PLACEHOLDER_DICT },
+    ];
+    const written = [];
+    const skipped = [];
+    for (const { rel, content } of files) {
+        const abs = path.join(i18nDir, rel);
+        // Skip files that already exist unless the caller explicitly asked to overwrite
+        if (fs.existsSync(abs) && !overwrite) {
+            skipped.push(rel);
+            continue;
+        }
+        fs.writeFileSync(abs, content, 'utf-8');
+        written.push(rel);
+    }
+    return { written, skipped };
+}
+//# sourceMappingURL=scaffold.js.map