@translation-cms/sync 1.2.1 → 1.2.3

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,35 @@
+/**
+ * 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;
+/**
+ * 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;AAEhB;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CASjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAUrE;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,65 @@
+/**
+ * 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;
+/**
+ * Reset all state when cleaning up.
+ */
+export function resetState() {
+    isInitialized = false;
+    highlightedElements = [];
+    opts = {};
+    currentLiveValue = null;
+    currentSearchValue = null;
+    activeLocale = null;
+    interactionBlockerOverlay = null;
+    pendingHighlight = null;
+}
+/**
+ * Initialize state with global values.
+ */
+export function initializeState(options) {
+    opts = options;
+    // 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;;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;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC3D,IAAI,GAAG,OAAO,CAAC;IACf,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,49 @@
+/**
+ * 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;
+}
+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;
+}
+//# 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;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;CAC7C"}

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/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,7 @@
+/**
+ * i18n scaffolding logic.
+ * Creates i18n configuration files and dictionary placeholders.
+ */
+import { ScaffoldOptions, ScaffoldResult } from './types.js';
+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,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CA8BlE"}

package/dist/scaffold/intenrals/scaffold.js

@@ -0,0 +1,34 @@
+/**
+ * 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';
+export function scaffoldI18n(opts) {
+    const { i18nDir, overwrite = false } = opts;
+    const dictsDir = path.join(i18nDir, 'dictionaries');
+    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);
+        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

package/dist/scaffold/intenrals/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/scaffold/intenrals/scaffold.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EACH,WAAW,EACX,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,gBAAgB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,UAAU,YAAY,CAAC,IAAqB;IAC9C,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAEpD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,KAAK,GAA4C;QACnD,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE;QAC5C,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE;QACtC,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE;QACxC,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE;QACxC,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE;QAC9C,EAAE,GAAG,EAAE,sBAAsB,EAAE,OAAO,EAAE,gBAAgB,EAAE;QAC1D,EAAE,GAAG,EAAE,sBAAsB,EAAE,OAAO,EAAE,gBAAgB,EAAE;KAC7D,CAAC;IAEF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,KAAK,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,SAAS;QACb,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * i18n file templates.
+ */
+export declare const SETTINGS_TS = "import type { InitOptions } from 'i18next';\n\n// These imports resolve after running: sync-translations pull\nimport en from './dictionaries/en.json';\nimport type nl from './dictionaries/nl.json';\n\nexport const fallbackLng = 'nl' as const;\nexport const languages = ['nl', 'en'] as const;\nexport const defaultNS = 'common' as const;\nexport const cookieName = 'i18next';\n\nexport type Locale = (typeof languages)[number];\n\nexport const allNamespaces = Object.keys(\n    en\n) as readonly (keyof typeof en)[];\n\nexport type Dicts = {\n    en: typeof en;\n    nl: typeof nl;\n};\n\n// Re-export for convenience\nexport type { AppNamespace, Namespace } from './types';\n\nexport function getOptions(\n    lng: string = fallbackLng,\n    ns: string | readonly string[] = allNamespaces\n): InitOptions {\n    return {\n        supportedLngs: [...languages],\n        fallbackLng: lng,\n        lng,\n        fallbackNS: defaultNS,\n        defaultNS,\n        ns,\n        resources: {},\n        partialBundledLanguages: true,\n        interpolation: {\n            escapeValue: false,\n        },\n    };\n}\n";
+export declare const TYPES_TS = "import type { allNamespaces, Dicts, languages } from './settings';\n\nexport type Locale = (typeof languages)[number];\nexport type AppNamespace = (typeof allNamespaces)[number];\nexport type Namespace = AppNamespace | readonly AppNamespace[];\n\ntype PluralSuffix = '_zero' | '_one' | '_two' | '_few' | '_many' | '_other';\n\ntype StripPluralSuffix<K extends string> =\n    K extends `${infer Base}${PluralSuffix}` ? Base : K;\n\nexport type LeafPaths<T> = T extends {\n    [key: string]: string | number | boolean | null | object;\n}\n    ? {\n          [K in keyof T & string]: T[K] extends\n              | string\n              | number\n              | boolean\n              | null\n              ? K | StripPluralSuffix<K>\n              : T[K] extends object\n                ? `${K}.${LeafPaths<T[K]> & string}`\n                : never;\n      }[keyof T & string]\n    : never;\n\nexport type I18nKey = {\n    [Lang in keyof Dicts]: {\n        [Ns in keyof Dicts[Lang]]: `${Ns & string}:${LeafPaths<Dicts[Lang][Ns]> & string}`;\n    }[keyof Dicts[Lang]];\n}[keyof Dicts];\n\nexport type TranslationKey<\n    Ns extends AppNamespace | readonly AppNamespace[] | undefined = undefined,\n> = Ns extends undefined\n    ? I18nKey\n    : Ns extends readonly (infer N extends AppNamespace)[]\n      ? `${N}:${LeafPaths<Dicts['en'][N]> & string}`\n      : Ns extends AppNamespace\n        ? `${Ns}:${LeafPaths<Dicts['en'][Ns]> & string}`\n        : never;\n\nexport type TranslationKeys<\n    Ns extends AppNamespace | readonly AppNamespace[] | undefined,\n> = (key: TranslationKey<Ns>, options?: any) => string;\n";
+export declare const CLIENT_TS = "'use client';\n\nimport { useCallback } from 'react';\nimport {\n    initReactI18next,\n    Trans,\n    useTranslation as useTranslationOrg,\n    type UseTranslationOptions,\n} from 'react-i18next';\n\nexport { Trans };\n\nimport i18next, { type i18n as I18nInstance, type TOptions } from 'i18next';\n\nimport en from './dictionaries/en.json';\nimport nl from './dictionaries/nl.json';\n\nimport {\n    getOptions,\n    type AppNamespace,\n    type Locale,\n} from './settings';\nimport type { TranslationKeys } from './types';\n\nconst resources = { en, nl } as const;\n\ntype StringTOptions = Omit<TOptions, 'returnDetails' | 'returnObjects'>;\n\nlet i18nInstance: I18nInstance | null = null;\n\nexport async function initI18nClient(locale: Locale): Promise<I18nInstance> {\n    if (i18nInstance) {\n        if (i18nInstance.language !== locale) {\n            await i18nInstance.changeLanguage(locale);\n        }\n        return i18nInstance;\n    }\n\n    i18nInstance = i18next.createInstance();\n\n    await i18nInstance.use(initReactI18next).init({\n        ...getOptions(locale),\n        resources,\n    });\n\n    return i18nInstance;\n}\n\nexport function useTranslation<\n    Ns extends AppNamespace | readonly AppNamespace[],\n>(ns: Ns, hookOptions?: UseTranslationOptions<undefined>) {\n    const namespacesToLoad: AppNamespace[] = Array.isArray(ns)\n        ? [...ns]\n        : ns\n          ? [ns]\n          : [];\n\n    const result = useTranslationOrg(namespacesToLoad, hookOptions);\n    const { t: tOrg } = result;\n\n    const tBase = useCallback(\n        (key: string, tOptions?: StringTOptions): string => {\n            return tOrg(key, {\n                ...tOptions,\n                returnDetails: false,\n                returnObjects: false,\n            } as TOptions) as string;\n        },\n        [tOrg]\n    );\n\n    const t = tBase as TranslationKeys<Ns>;\n    const tDynamic = tBase;\n\n    return {\n        ...result,\n        t,\n        tDynamic,\n    };\n}\n";
+export declare const SERVER_TS = "import { initReactI18next } from 'react-i18next/initReactI18next';\nimport { cookies, headers } from 'next/headers';\nimport { createInstance, type TOptions } from 'i18next';\nimport resourcesToBackend from 'i18next-resources-to-backend';\n\nimport {\n    cookieName,\n    fallbackLng,\n    getOptions,\n    languages,\n    type Locale,\n} from './settings';\nimport type { AppNamespace, I18nKey, TranslationKeys } from './types';\n\ntype StringTOptions = Omit<TOptions, 'returnDetails' | 'returnObjects'>;\n\nexport async function initI18n(locale: string) {\n    const i18n = createInstance();\n\n    await i18n\n        .use(initReactI18next)\n        .use(\n            resourcesToBackend((language: string, namespace: string) =>\n                import(`./dictionaries/${language}.json`).then(module => {\n                    return (module.default as Record<string, unknown>)[namespace] ?? {};\n                })\n            )\n        )\n        .init(getOptions(locale, []));\n\n    return i18n;\n}\n\nexport async function getTranslation<\n    Ns extends AppNamespace | readonly AppNamespace[],\n>(ns: Ns, options: { keyPrefix?: string } = {}) {\n    const lng = await getLocale();\n    const i18n = await initI18n(lng);\n\n    const namespacesToLoad: readonly AppNamespace[] = ns\n        ? Array.isArray(ns)\n            ? ns\n            : [ns]\n        : [];\n\n    if (namespacesToLoad.length > 0) {\n        await i18n.loadNamespaces(namespacesToLoad);\n    }\n\n    const fixedT = i18n.getFixedT(lng, namespacesToLoad, options.keyPrefix);\n\n    const t = (key: I18nKey, tOptions?: StringTOptions): string => {\n        return fixedT(key, {\n            ...tOptions,\n            returnDetails: false,\n            returnObjects: false,\n        } as TOptions) as string;\n    };\n\n    return {\n        t: t as TranslationKeys<Ns>,\n        tDynamic: t,\n        i18n,\n    };\n}\n\nexport async function getLocale(): Promise<Locale> {\n    const isSupportedLocale = (value: string): value is Locale =>\n        (languages as readonly string[]).includes(value);\n\n    try {\n        const cookieStore = await cookies();\n        const localeCookie = cookieStore.get(cookieName);\n        if (localeCookie?.value && isSupportedLocale(localeCookie.value)) {\n            return localeCookie.value;\n        }\n\n        const headersList = await headers();\n        const acceptLanguage = headersList.get('accept-language') ?? '';\n        const supported = new Set(\n            (languages as readonly string[]).map(l => l.toLowerCase())\n        );\n\n        const preferences = acceptLanguage\n            .split(',')\n            .map((part): { code: string; q: number } | null => {\n                const trimmed = part.trim();\n                if (!trimmed) return null;\n                const [tag = '', qPartRaw] = trimmed.split(';');\n                const qPart = qPartRaw?.trim();\n                const q = qPart?.startsWith('q=') ? Number(qPart.slice(2)) : 1;\n                const code = (tag.trim().split('-')[0] ?? '').toLowerCase();\n                if (!code || !Number.isFinite(q) || q <= 0 || q > 1) return null;\n                return { code, q };\n            })\n            .filter((x): x is { code: string; q: number } => x !== null)\n            .sort((a, b) => b.q - a.q);\n\n        const best = preferences.find(x => supported.has(x.code));\n        if (best) return best.code as Locale;\n    } catch {\n        // cookies()/headers() unavailable at build time\n    }\n\n    return fallbackLng;\n}\n";
+export declare const PROVIDER_TSX = "'use client';\n\nimport { useEffect, useState } from 'react';\nimport { I18nextProvider } from 'react-i18next';\nimport type { i18n as I18nInstance } from 'i18next';\n\nimport { initI18nClient } from './client';\nimport { cookieName, type Locale } from './settings';\n\ninterface TranslationProviderProps {\n    children: React.ReactNode;\n    locale: Locale;\n}\n\n/**\n * Root provider for i18n. Add to your root layout:\n *\n * ```tsx\n * import { TranslationProvider } from '@/lib/i18n/provider';\n * import { getLocale } from '@/lib/i18n/server';\n *\n * export default async function RootLayout({ children }) {\n *     const locale = await getLocale();\n *     return (\n *         <html lang={locale}>\n *             <body>\n *                 <TranslationProvider locale={locale}>\n *                     {children}\n *                 </TranslationProvider>\n *             </body>\n *         </html>\n *     );\n * }\n * ```\n */\nexport function TranslationProvider({ children, locale }: TranslationProviderProps) {\n    const [i18n, setI18n] = useState<I18nInstance | null>(null);\n\n    useEffect(() => {\n        initI18nClient(locale).then(setI18n);\n    }, [locale]);\n\n    useEffect(() => {\n        if (!i18n) return;\n        const handleLanguageChanged = (lng: string) => {\n            document.documentElement.lang = lng;\n            const expires = new Date();\n            expires.setFullYear(expires.getFullYear() + 1);\n            document.cookie = `${cookieName}=${encodeURIComponent(lng)}; expires=${expires.toUTCString()}; path=/; SameSite=Lax`;\n        };\n        handleLanguageChanged(i18n.language);\n        i18n.on('languageChanged', handleLanguageChanged);\n        return () => { i18n.off('languageChanged', handleLanguageChanged); };\n    }, [i18n]);\n\n    if (!i18n) return null;\n\n    return <I18nextProvider i18n={i18n}>{children}</I18nextProvider>;\n}\n";
+export declare const PLACEHOLDER_DICT: string;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/scaffold/intenrals/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,WAAW,gmCA2CvB,CAAC;AAEF,eAAO,MAAM,QAAQ,qlDA8CpB,CAAC;AAEF,eAAO,MAAM,SAAS,09DAgFrB,CAAC;AAEF,eAAO,MAAM,SAAS,k+GA0GrB,CAAC;AAEF,eAAO,MAAM,YAAY,o3DA2DxB,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAA0C,CAAC"}

package/dist/{scaffold.js → scaffold/intenrals/templates.js}

@@ -1,9 +1,7 @@
-import fs from 'fs';
-import path from 'path';
-// ---------------------------------------------------------------------------
-// File templates
-// ---------------------------------------------------------------------------
-const SETTINGS_TS = `import type { InitOptions } from 'i18next';
+/**
+ * i18n file templates.
+ */
+export const SETTINGS_TS = `import type { InitOptions } from 'i18next';
 
 // These imports resolve after running: sync-translations pull
 import en from './dictionaries/en.json';
@@ -47,7 +45,7 @@ export function getOptions(
     };
 }
 `;
-const TYPES_TS = `import type { allNamespaces, Dicts, languages } from './settings';
+export const TYPES_TS = `import type { allNamespaces, Dicts, languages } from './settings';
 
 export type Locale = (typeof languages)[number];
 export type AppNamespace = (typeof allNamespaces)[number];
@@ -94,7 +92,7 @@ export type TranslationKeys<
     Ns extends AppNamespace | readonly AppNamespace[] | undefined,
 > = (key: TranslationKey<Ns>, options?: any) => string;
 `;
-const CLIENT_TS = `'use client';
+export const CLIENT_TS = `'use client';
 
 import { useCallback } from 'react';
 import {
@@ -175,7 +173,7 @@ export function useTranslation<
     };
 }
 `;
-const SERVER_TS = `import { initReactI18next } from 'react-i18next/initReactI18next';
+export const SERVER_TS = `import { initReactI18next } from 'react-i18next/initReactI18next';
 import { cookies, headers } from 'next/headers';
 import { createInstance, type TOptions } from 'i18next';
 import resourcesToBackend from 'i18next-resources-to-backend';
@@ -282,7 +280,7 @@ export async function getLocale(): Promise<Locale> {
     return fallbackLng;
 }
 `;
-const PROVIDER_TSX = `'use client';
+export const PROVIDER_TSX = `'use client';
 
 import { useEffect, useState } from 'react';
 import { I18nextProvider } from 'react-i18next';
@@ -342,31 +340,5 @@ export function TranslationProvider({ children, locale }: TranslationProviderPro
     return <I18nextProvider i18n={i18n}>{children}</I18nextProvider>;
 }
 `;
-const PLACEHOLDER_DICT = JSON.stringify({ common: {} }, null, 4);
-export function scaffoldI18n(opts) {
-    const { i18nDir, overwrite = false } = opts;
-    const dictsDir = path.join(i18nDir, 'dictionaries');
-    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);
-        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
+export const PLACEHOLDER_DICT = JSON.stringify({ common: {} }, null, 4);
+//# sourceMappingURL=templates.js.map

package/dist/scaffold/intenrals/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/scaffold/intenrals/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C1B,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CvB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFxB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0GxB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2D3B,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC"}

package/dist/{scaffold.d.ts → scaffold/intenrals/types.d.ts}

@@ -1,3 +1,6 @@
+/**
+ * Types for i18n scaffolding.
+ */
 export interface ScaffoldOptions {
     /** Absolute path to the i18n directory, e.g. /project/src/lib/i18n */
     i18nDir: string;
@@ -8,5 +11,4 @@ export interface ScaffoldResult {
     written: string[];
     skipped: string[];
 }
-export declare function scaffoldI18n(opts: ScaffoldOptions): ScaffoldResult;
-//# sourceMappingURL=scaffold.d.ts.map
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/scaffold/intenrals/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC5B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/scaffold/intenrals/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for i18n scaffolding.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scaffold/intenrals/types.js.map

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

package/package.json

@@ -1,28 +1,25 @@
 {
     "name": "@translation-cms/sync",
-    "version": "1.2.1",
+    "version": "1.2.3",
     "description": "Scan translation keys in your codebase and sync them to the Translations CMS",
     "type": "module",
     "main": "./dist/index.js",
     "bin": {
-        "sync-translations": "./dist/cli-entry.js"
+        "sync-translations": "./dist/bin.js"
     },
     "exports": {
         ".": {
             "import": "./dist/index.js",
             "types": "./dist/index.d.ts"
         },
-        "./cli": {
-            "import": "./dist/cli.js",
-            "types": "./dist/cli.d.ts"
-        },
         "./preview": {
             "import": "./dist/preview.js",
             "types": "./dist/preview.d.ts"
         }
     },
     "files": [
-        "dist"
+        "dist",
+        "schema.json"
     ],
     "scripts": {
         "build": "tsc",
@@ -49,5 +46,8 @@
     "devDependencies": {
         "@types/react": "^18",
         "typescript": "^5.9.3"
+    },
+    "dependencies": {
+        "@babel/parser": "^7.29.2"
     }
 }

package/schema.json

@@ -0,0 +1,64 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "sync-translations config",
+    "description": "Configuration file for the sync-translations CLI. Place as .translationsrc.json in your project root.",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+        "$schema": {
+            "type": "string"
+        },
+        "cmsUrl": {
+            "type": "string",
+            "description": "CMS URL — overrides NEXT_PUBLIC_CMS_URL env var.",
+            "examples": ["https://cms.example.com"]
+        },
+        "projectId": {
+            "type": "string",
+            "description": "Project ID — overrides NEXT_PUBLIC_CMS_PROJECT_ID env var."
+        },
+        "apiKey": {
+            "type": "string",
+            "description": "API key — overrides NEXT_PUBLIC_CMS_ANON_KEY / CMS_SYNC_API_KEY env var."
+        },
+        "excludedDirs": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Additional directories to exclude when scanning for translation keys. Merged with built-in defaults: node_modules, .next, dist, .git, out, .turbo, scripts, packages, .storybook, coverage.",
+            "examples": [["e2e", "fixtures", "mocks"]]
+        },
+        "sourceExtensions": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "File extensions to scan. When set, replaces the default list.",
+            "default": [".ts", ".tsx", ".js", ".jsx"],
+            "examples": [[".ts", ".tsx", ".js", ".jsx", ".vue"]]
+        },
+        "outputDir": {
+            "type": "string",
+            "description": "Default output directory for pulled translation files.",
+            "default": "./public/locales",
+            "examples": ["./src/lib/i18n/dictionaries", "./public/locales"]
+        },
+        "pullTtlMs": {
+            "type": "number",
+            "description": "TTL in milliseconds before the pull cache expires and translations are re-fetched.",
+            "default": 300000,
+            "examples": [300000, 600000]
+        },
+        "routeParams": {
+            "type": "object",
+            "description": "Mock params for dynamic route segments, used to generate preview URLs. Keys are route patterns, values are param maps.",
+            "additionalProperties": {
+                "type": "object",
+                "additionalProperties": { "type": "string" }
+            },
+            "examples": [
+                {
+                    "/[locale]/blog/[slug]": { "slug": "first-post" },
+                    "/[locale]/products/[id]": { "id": "product-a" }
+                }
+            ]
+        }
+    }
+}

package/dist/cli-entry.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli-entry.d.ts.map

package/dist/cli-entry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-entry.d.ts","sourceRoot":"","sources":["../src/cli-entry.ts"],"names":[],"mappings":""}