@translation-cms/sync 1.2.28 → 1.2.29

package/dist/core/cache-internals/format.js

@@ -0,0 +1,33 @@
+/**
+ * Format a single PreviewRoute for human-readable output.
+ *
+ * Plain string routes are returned as-is.
+ * Object routes (with params) are rendered as `/path (key=value, …)`.
+ *
+ * @example
+ * formatPreviewRoute('/dashboard')                          // → "/dashboard"
+ * formatPreviewRoute({ route: '/blog/[slug]', params: { slug: 'hello' } })
+ *                                                           // → "/blog/[slug] (slug=hello)"
+ */
+export function formatPreviewRoute(route) {
+    if (typeof route === 'string')
+        return route;
+    // Append param list only when params are present
+    const params = route.params
+        ? ` (${Object.entries(route.params)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(', ')})`
+        : '';
+    return `${route.route}${params}`;
+}
+/**
+ * Format an array of PreviewRoutes as a comma-separated string.
+ * Returns `"no route"` for keys that have no associated preview routes
+ * (e.g. keys inside dialogs or overlays).
+ */
+export function formatPreviewRoutes(routes) {
+    if (routes.length === 0)
+        return 'no route';
+    return routes.map(formatPreviewRoute).join(', ');
+}
+//# sourceMappingURL=format.js.map

package/dist/core/cache-internals/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/core/cache-internals/format.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,iDAAiD;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM;QACvB,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;aAC5B,IAAI,CAAC,IAAI,CAAC,GAAG;QACpB,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAC3C,OAAO,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/core/cache-internals/params.d.ts

@@ -0,0 +1,33 @@
+import type { CachedRouteParams } from './types.js';
+/**
+ * Generate route params from detected routes.
+ * Scans all routes, extracts [param] names, generates defaults.
+ *
+ * @example
+ * generateRouteParams(["/[locale]/blog/[slug]", "/about"])
+ * // {
+ * //   "/[locale]/blog/[slug]": { "locale": "en", "slug": "demo" }
+ * // }
+ */
+export declare function generateRouteParams(routes: string[]): Record<string, Record<string, string>>;
+/**
+ * Load route params from cache (if exists).
+ */
+export declare function loadRouteParamsCache(root: string): CachedRouteParams | null;
+/**
+ * Save route params to cache.
+ */
+export declare function saveRouteParamsCache(root: string, params: Record<string, Record<string, string>>): void;
+/**
+ * Write a TypeScript mock-data file exporting all route params as a typed
+ * `cmsRouteParams` constant. Import this in context files, generateStaticParams,
+ * tests, or Storybook stories to get type-safe mock data.
+ *
+ * @example
+ * // src/lib/cms-mock-params.ts (auto-generated)
+ * export const cmsRouteParams = {
+ *   "/[locale]/blog/[slug]": { locale: "en", slug: "demo" },
+ * } as const;
+ */
+export declare function writeMockDataFile(root: string, params: Record<string, Record<string, string>>, relativeOutputPath: string): void;
+//# sourceMappingURL=params.d.ts.map

package/dist/core/cache-internals/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/core/cache-internals/params.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAoEpD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,MAAM,EAAE,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAexC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAU3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC/C,IAAI,CAUN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC9C,kBAAkB,EAAE,MAAM,GAC3B,IAAI,CAqCN"}

package/dist/core/cache-internals/params.js

@@ -0,0 +1,155 @@
+import fs from 'fs';
+import path from 'path';
+import { createHash } from 'crypto';
+/**
+ * Extract dynamic parameter names from a route string.
+ * E.g. "/[locale]/blog/[slug]" → ["locale", "slug"]
+ */
+function extractParamNames(route) {
+    const matches = route.match(/\[(\w+)\]/g) ?? [];
+    return matches.map(m => m.slice(1, -1));
+}
+/**
+ * Generate a deterministic UUID for a param ID.
+ * Same param name always produces the same UUID (for consistency).
+ * Uses MD5 hash of the param name to create a v4-like UUID.
+ */
+function generateDeterministicUUID(paramName) {
+    const hash = createHash('md5')
+        .update(`cms-param:${paramName}`)
+        .digest('hex');
+    // Format as UUID v4-like: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+    return `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20, 32)}`;
+}
+/**
+ * Generate a sensible default value for any dynamic route param name.
+ *
+ * Matches by suffix/pattern so it works generically — e.g. `productId`,
+ * `orderId`, `articleSlug`, `teamName` — without hardcoding every variant.
+ *
+ * For IDs: generates a deterministic UUID so the same param always produces
+ * the same value (important for caching and consistency).
+ *
+ * Fallback: converts the param name from camelCase to kebab-case, which is
+ * both human-readable and a valid value for slug-style params.
+ * e.g. `articleSlug` → `"article-slug"`, `teamName` → `"team-name"`
+ */
+function generateDefaultParamValue(paramName) {
+    const lower = paramName.toLowerCase();
+    // Any param ending in "id" (userId, productId, orderId, …) → deterministic UUID
+    if (lower.endsWith('id'))
+        return generateDeterministicUUID(paramName);
+    // Email addresses
+    if (lower.includes('email'))
+        return 'demo@example.com';
+    // Dates (createdDate, startDate, …)
+    if (lower.includes('date'))
+        return '2024-01-01';
+    // Pagination and numeric indices (page, pageNum, stepIndex, …)
+    if (lower === 'page' ||
+        lower.endsWith('num') ||
+        lower.endsWith('index') ||
+        lower.endsWith('page'))
+        return '1';
+    // Version strings (version, apiVersion, ver, …)
+    if (lower.includes('version') || lower === 'ver')
+        return 'v1';
+    // Fallback: kebab-case the param name so the value is always meaningful
+    return paramName
+        .replace(/([A-Z])/g, '-$1')
+        .toLowerCase()
+        .replace(/^-/, '');
+}
+/**
+ * Generate route params from detected routes.
+ * Scans all routes, extracts [param] names, generates defaults.
+ *
+ * @example
+ * generateRouteParams(["/[locale]/blog/[slug]", "/about"])
+ * // {
+ * //   "/[locale]/blog/[slug]": { "locale": "en", "slug": "demo" }
+ * // }
+ */
+export function generateRouteParams(routes) {
+    const result = {};
+    for (const route of routes) {
+        const params = extractParamNames(route);
+        if (params.length === 0)
+            continue;
+        const defaults = {};
+        for (const param of params) {
+            defaults[param] = generateDefaultParamValue(param);
+        }
+        result[route] = defaults;
+    }
+    return result;
+}
+/**
+ * Load route params from cache (if exists).
+ */
+export function loadRouteParamsCache(root) {
+    const metaPath = path.join(root, '.cms-sync-cache-meta.json');
+    if (!fs.existsSync(metaPath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save route params to cache.
+ */
+export function saveRouteParamsCache(root, params) {
+    const cached = {
+        generated: params,
+        timestamp: new Date().toISOString(),
+    };
+    fs.writeFileSync(path.join(root, '.cms-sync-cache-meta.json'), JSON.stringify(cached, null, 2), 'utf-8');
+}
+/**
+ * Write a TypeScript mock-data file exporting all route params as a typed
+ * `cmsRouteParams` constant. Import this in context files, generateStaticParams,
+ * tests, or Storybook stories to get type-safe mock data.
+ *
+ * @example
+ * // src/lib/cms-mock-params.ts (auto-generated)
+ * export const cmsRouteParams = {
+ *   "/[locale]/blog/[slug]": { locale: "en", slug: "demo" },
+ * } as const;
+ */
+export function writeMockDataFile(root, params, relativeOutputPath) {
+    if (Object.keys(params).length === 0)
+        return;
+    const entries = Object.entries(params)
+        .map(([route, p]) => {
+        const inner = Object.entries(p)
+            .map(([k, v]) => `    ${JSON.stringify(k)}: ${JSON.stringify(v)}`)
+            .join(',\n');
+        return `  ${JSON.stringify(route)}: {\n${inner},\n  }`;
+    })
+        .join(',\n');
+    const content = [
+        '// auto-generated by sync-translations — do not edit manually',
+        '// run `sync-translations sync` to update',
+        '',
+        'export const cmsRouteParams = {',
+        entries + ',',
+        '} as const;',
+        '',
+        'export type CmsRoute = keyof typeof cmsRouteParams;',
+        'export type CmsRouteParams<R extends CmsRoute> = (typeof cmsRouteParams)[R];',
+        '',
+    ].join('\n');
+    const absPath = path.isAbsolute(relativeOutputPath)
+        ? relativeOutputPath
+        : path.join(root, relativeOutputPath);
+    const dir = path.dirname(absPath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(absPath, content, 'utf-8');
+    // eslint-disable-next-line no-console
+    console.log(`[mock-data] Written to ${path.relative(root, absPath)}`);
+}
+//# sourceMappingURL=params.js.map

package/dist/core/cache-internals/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../src/core/cache-internals/params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC;;;GAGG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAChD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAS,yBAAyB,CAAC,SAAiB;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;SACzB,MAAM,CAAC,aAAa,SAAS,EAAE,CAAC;SAChC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,+DAA+D;IAC/D,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;AACxH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,yBAAyB,CAAC,SAAiB;IAChD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAEtC,gFAAgF;IAChF,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAEtE,kBAAkB;IAClB,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAEvD,oCAAoC;IACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IAEhD,+DAA+D;IAC/D,IACI,KAAK,KAAK,MAAM;QAChB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QACvB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAEtB,OAAO,GAAG,CAAC;IAEf,gDAAgD;IAChD,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAE9D,wEAAwE;IACxE,OAAO,SAAS;SACX,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAC/B,MAAgB;IAEhB,MAAM,MAAM,GAA2C,EAAE,CAAC;IAE1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAElC,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,QAAQ,CAAC,KAAK,CAAC,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CACb,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAChB,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAChC,IAAY,EACZ,MAA8C;IAE9C,MAAM,MAAM,GAAsB;QAC9B,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;IACF,EAAE,CAAC,aAAa,CACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,CAAC,EAC5C,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAC/B,OAAO,CACV,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC7B,IAAY,EACZ,MAA8C,EAC9C,kBAA0B;IAE1B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;QAChB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;aAC1B,GAAG,CACA,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAC/D;aACA,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC3D,CAAC,CAAC;SACD,IAAI,CAAC,KAAK,CAAC,CAAC;IAEjB,MAAM,OAAO,GAAG;QACZ,+DAA+D;QAC/D,2CAA2C;QAC3C,EAAE;QACF,iCAAiC;QACjC,OAAO,GAAG,GAAG;QACb,aAAa;QACb,EAAE;QACF,qDAAqD;QACrD,8EAA8E;QAC9E,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAC/C,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/core/cache-internals/pull.d.ts

@@ -0,0 +1,17 @@
+/** Filename of the pull timestamp marker written inside the output directory. */
+export declare const PULL_META_FILE = ".last-pulled";
+/** Default TTL before a pull is considered stale and a re-fetch is triggered. */
+export declare const DEFAULT_PULL_TTL_MS: number;
+/**
+ * Read the timestamp of the last successful pull from the marker file.
+ * Returns the time as a Unix timestamp (ms), or null when the file is absent
+ * or contains an unparseable date.
+ */
+export declare function getLastPulledTime(outputDir: string): number | null;
+/**
+ * Write the current time as an ISO 8601 string to the marker file.
+ * Creates the output directory if it doesn't exist yet.
+ * Called after a successful pull to reset the TTL clock.
+ */
+export declare function saveLastPulledTime(outputDir: string): void;
+//# sourceMappingURL=pull.d.ts.map

package/dist/core/cache-internals/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/core/cache-internals/pull.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,QAAgB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAO1D"}

package/dist/core/cache-internals/pull.js

@@ -0,0 +1,34 @@
+import fs from 'fs';
+import path from 'path';
+/** Filename of the pull timestamp marker written inside the output directory. */
+export const PULL_META_FILE = '.last-pulled';
+/** Default TTL before a pull is considered stale and a re-fetch is triggered. */
+export const DEFAULT_PULL_TTL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Read the timestamp of the last successful pull from the marker file.
+ * Returns the time as a Unix timestamp (ms), or null when the file is absent
+ * or contains an unparseable date.
+ */
+export function getLastPulledTime(outputDir) {
+    const p = path.join(outputDir, PULL_META_FILE);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        const ts = new Date(fs.readFileSync(p, 'utf-8').trim()).getTime();
+        // isNaN guard handles a corrupted or empty file
+        return isNaN(ts) ? null : ts;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write the current time as an ISO 8601 string to the marker file.
+ * Creates the output directory if it doesn't exist yet.
+ * Called after a successful pull to reset the TTL clock.
+ */
+export function saveLastPulledTime(outputDir) {
+    fs.mkdirSync(outputDir, { recursive: true });
+    fs.writeFileSync(path.join(outputDir, PULL_META_FILE), new Date().toISOString(), 'utf-8');
+}
+//# sourceMappingURL=pull.js.map

package/dist/core/cache-internals/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../../src/core/cache-internals/pull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC;AAE7C,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAE9D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAClE,gDAAgD;QAChD,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAChD,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,EAAE,CAAC,aAAa,CACZ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACpC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EACxB,OAAO,CACV,CAAC;AACN,CAAC"}

package/dist/core/cache-internals/sync.d.ts

@@ -0,0 +1,29 @@
+import type { SerializedNamespaces, SyncDiff } from './types.js';
+/**
+ * Load the serialized namespace map from the last successful sync.
+ * Returns null when no cache exists yet or when the file is unreadable.
+ */
+export declare function loadSyncCache(root: string): SerializedNamespaces | null;
+/**
+ * Persist the serialized namespace map as the new sync baseline.
+ * Subsequent runs diff against this to detect changes.
+ */
+export declare function saveSyncCache(root: string, data: SerializedNamespaces): void;
+/**
+ * Returns true when the current scan differs from the cached baseline,
+ * meaning the CMS needs to be updated.
+ * Always returns true when there is no cache yet (first run).
+ */
+export declare function isSyncNeeded(current: SerializedNamespaces, cached: SerializedNamespaces | null): boolean;
+/**
+ * Compute a three-way diff between the current scan and the cached baseline:
+ *
+ *  - `added`         keys present in current but not in cache
+ *  - `removed`       keys present in cache but no longer in current
+ *  - `routesChanged` keys present in both but with different preview routes
+ *  - `unchanged`     count of keys that are identical in both
+ *
+ * Preview routes are compared order-independently by sorting before joining.
+ */
+export declare function computeDiff(current: SerializedNamespaces, cached: SerializedNamespaces | null): SyncDiff;
+//# sourceMappingURL=sync.d.ts.map

package/dist/core/cache-internals/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/core/cache-internals/sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKjE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAQvE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAM5E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,oBAAoB,GAAG,IAAI,GACpC,OAAO,CAIT;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,oBAAoB,GAAG,IAAI,GACpC,QAAQ,CAgDV"}

package/dist/core/cache-internals/sync.js

@@ -0,0 +1,104 @@
+import fs from 'fs';
+import path from 'path';
+/** Filename of the sync baseline cache written at the project root. */
+const CACHE_FILE = '.cms-sync-cache.json';
+/**
+ * Load the serialized namespace map from the last successful sync.
+ * Returns null when no cache exists yet or when the file is unreadable.
+ */
+export function loadSyncCache(root) {
+    const p = path.join(root, CACHE_FILE);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Persist the serialized namespace map as the new sync baseline.
+ * Subsequent runs diff against this to detect changes.
+ */
+export function saveSyncCache(root, data) {
+    fs.writeFileSync(path.join(root, CACHE_FILE), JSON.stringify(data, null, 2), 'utf-8');
+}
+/**
+ * Returns true when the current scan differs from the cached baseline,
+ * meaning the CMS needs to be updated.
+ * Always returns true when there is no cache yet (first run).
+ */
+export function isSyncNeeded(current, cached) {
+    if (!cached)
+        return true;
+    // Stringify comparison is sufficient — order is stable because serializeNamespaces sorts keys
+    return JSON.stringify(current) !== JSON.stringify(cached);
+}
+/**
+ * Compute a three-way diff between the current scan and the cached baseline:
+ *
+ *  - `added`         keys present in current but not in cache
+ *  - `removed`       keys present in cache but no longer in current
+ *  - `routesChanged` keys present in both but with different preview routes
+ *  - `unchanged`     count of keys that are identical in both
+ *
+ * Preview routes are compared order-independently by sorting before joining.
+ */
+export function computeDiff(current, cached) {
+    const added = [];
+    const removed = [];
+    const routesChanged = [];
+    let unchanged = 0;
+    // Forward pass: find added keys and route changes
+    for (const [ns, keys] of Object.entries(current)) {
+        for (const { key, previewRoutes } of keys) {
+            const cachedEntry = cached?.[ns]?.find(k => k.key === key);
+            if (!cachedEntry) {
+                added.push({ namespace: ns, key, routes: previewRoutes });
+            }
+            else {
+                // Sort both sides so route order doesn't cause false positives
+                const before = [...cachedEntry.previewRoutes]
+                    .map(routeToString)
+                    .sort()
+                    .join(',');
+                const after = [...previewRoutes]
+                    .map(routeToString)
+                    .sort()
+                    .join(',');
+                if (before !== after) {
+                    routesChanged.push({
+                        namespace: ns,
+                        key,
+                        before: cachedEntry.previewRoutes,
+                        after: previewRoutes,
+                    });
+                }
+                else {
+                    unchanged++;
+                }
+            }
+        }
+    }
+    // Reverse pass: find keys that exist in cache but are gone from current
+    if (cached) {
+        for (const [ns, keys] of Object.entries(cached)) {
+            for (const { key } of keys) {
+                if (!(current[ns] ?? []).some(k => k.key === key)) {
+                    removed.push({ namespace: ns, key });
+                }
+            }
+        }
+    }
+    return { added, removed, routesChanged, unchanged };
+}
+/**
+ * Normalise a PreviewRoute to a string for stable comparison.
+ * String routes are returned as-is; object routes are JSON-stringified.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function routeToString(r) {
+    return typeof r === 'string' ? r : JSON.stringify(r);
+}
+//# sourceMappingURL=sync.js.map

package/dist/core/cache-internals/sync.js.map

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

package/dist/core/cache-internals/types.d.ts

@@ -0,0 +1,48 @@
+import type { PreviewRoute } from '../../core/scanner.js';
+/**
+ * The serialized form of a NamespaceMap written to the sync cache and sent to
+ * the CMS API. Each namespace maps to an ordered array of key entries so the
+ * structure is JSON-serializable without Maps.
+ */
+export type SerializedNamespaces = Record<string, Array<{
+    key: string;
+    previewRoutes: PreviewRoute[];
+}>>;
+/**
+ * Result of diffing the current scan against the cached baseline.
+ *
+ *  - `added`         keys new since the last sync
+ *  - `removed`       keys that no longer exist in the source
+ *  - `routesChanged` keys whose set of preview routes has changed
+ *  - `unchanged`     count of keys identical in both snapshots
+ */
+export interface SyncDiff {
+    added: Array<{
+        namespace: string;
+        key: string;
+        routes: PreviewRoute[];
+    }>;
+    removed: Array<{
+        namespace: string;
+        key: string;
+    }>;
+    routesChanged: Array<{
+        namespace: string;
+        key: string;
+        before: PreviewRoute[];
+        after: PreviewRoute[];
+    }>;
+    unchanged: number;
+}
+/**
+ * Shape of the `.cms-sync-cache-meta.json` file that stores auto-generated
+ * route params between sync runs.
+ *
+ *  - `generated`   route → param map produced by the last sync
+ *  - `timestamp`   ISO 8601 string of when the cache was last written
+ */
+export interface CachedRouteParams {
+    generated: Record<string, Record<string, string>>;
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/cache-internals/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/cache-internals/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACrC,MAAM,EACN,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CACxD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;IACzE,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,aAAa,EAAE,KAAK,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,YAAY,EAAE,CAAC;QACvB,KAAK,EAAE,YAAY,EAAE,CAAC;KACzB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;CACrB"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/core/cache.d.ts

@@ -0,0 +1,13 @@
+import type { NamespaceMap } from './scanner.js';
+export type { SerializedNamespaces, SyncDiff, CachedRouteParams, } from './cache-internals/types.js';
+export { loadSyncCache, saveSyncCache, isSyncNeeded, computeDiff, } from './cache-internals/sync.js';
+export { generateRouteParams, loadRouteParamsCache, saveRouteParamsCache, writeMockDataFile, } from './cache-internals/params.js';
+export { PULL_META_FILE, DEFAULT_PULL_TTL_MS, getLastPulledTime, saveLastPulledTime, } from './cache-internals/pull.js';
+export { formatPreviewRoute, formatPreviewRoutes, } from './cache-internals/format.js';
+import type { SerializedNamespaces } from './cache-internals/types.js';
+export declare function serializeNamespaces(namespaces: NamespaceMap): {
+    serialized: SerializedNamespaces;
+    totalKeys: number;
+};
+export declare function writeReport(reportPath: string, namespaces: SerializedNamespaces, diff?: any): void;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,YAAY,EACR,oBAAoB,EACpB,QAAQ,EACR,iBAAiB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAMvE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,YAAY,GAAG;IAC3D,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACrB,CAYA;AAMD,wBAAgB,WAAW,CACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,oBAAoB,EAChC,IAAI,CAAC,EAAE,GAAG,GACX,IAAI,CASN"}

package/dist/core/cache.js

@@ -0,0 +1,33 @@
+import fs from 'fs';
+export { loadSyncCache, saveSyncCache, isSyncNeeded, computeDiff, } from './cache-internals/sync.js';
+export { generateRouteParams, loadRouteParamsCache, saveRouteParamsCache, writeMockDataFile, } from './cache-internals/params.js';
+export { PULL_META_FILE, DEFAULT_PULL_TTL_MS, getLastPulledTime, saveLastPulledTime, } from './cache-internals/pull.js';
+export { formatPreviewRoute, formatPreviewRoutes, } from './cache-internals/format.js';
+// ---------------------------------------------------------------------------
+// Serialization
+// ---------------------------------------------------------------------------
+export function serializeNamespaces(namespaces) {
+    const serialized = {};
+    let totalKeys = 0;
+    for (const [ns, keyMap] of Object.entries(namespaces)) {
+        serialized[ns] = [...keyMap.entries()]
+            .map(([key, previewRoutes]) => ({ key, previewRoutes }))
+            .sort((a, b) => a.key.localeCompare(b.key));
+        totalKeys += keyMap.size;
+    }
+    return { serialized, totalKeys };
+}
+// ---------------------------------------------------------------------------
+// Report
+// ---------------------------------------------------------------------------
+export function writeReport(reportPath, namespaces, diff) {
+    const report = {
+        generatedAt: new Date().toISOString(),
+        namespaces,
+    };
+    if (diff)
+        report['diff'] = diff;
+    fs.writeFileSync(reportPath, JSON.stringify(report, null, 2), 'utf-8');
+    console.log(`[report] Written to ${reportPath}`);
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AASpB,OAAO,EACH,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,6BAA6B,CAAC;AAKrC,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,UAAU,mBAAmB,CAAC,UAAwB;IAIxD,MAAM,UAAU,GAAyB,EAAE,CAAC;IAC5C,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;aACvD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,UAAU,WAAW,CACvB,UAAkB,EAClB,UAAgC,EAChC,IAAU;IAEV,MAAM,MAAM,GAA4B;QACpC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,UAAU;KACb,CAAC;IACF,IAAI,IAAI;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEhC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/core/scanner-internals/ast.d.ts

@@ -0,0 +1,40 @@
+/**
+ * AST parsing and traversal utilities.
+ */
+import type { AstNode } from './types.js';
+/**
+ * Walk an AST node depth-first, calling visit() for every node encountered.
+ *
+ * Handles three cases:
+ *  - Arrays     → recurse into each element
+ *  - AST nodes  → call visit(), then recurse into all object-valued properties
+ *  - Primitives → stop (nothing to traverse)
+ */
+export declare function walk(node: unknown, visit: (node: AstNode) => void): void;
+/**
+ * Parse source code into a Babel AST with the appropriate plugins for the
+ * file extension.
+ *
+ *  - `.ts`              → typescript
+ *  - `.tsx`, `.jsx`, `.js` → typescript (if .tsx) + jsx
+ *
+ * `errorRecovery: true` lets the parser continue past syntax errors so a
+ * single broken file doesn't abort the entire scan.
+ */
+export declare function parseSource(filePath: string, source: string): unknown;
+/**
+ * Extract the static string value from a `StringLiteral` or a `TemplateLiteral`
+ * that contains no expressions (i.e. `` `plain string` ``).
+ * Returns null for dynamic expressions or any other node type.
+ */
+export declare function stringValue(node: unknown): string | null;
+/**
+ * Extract namespace string(s) from the first argument of a
+ * `useTranslation()` / `getTranslation()` call.
+ *
+ * Handles:
+ *  - Single string:  `useTranslation('sidebar')`          → `['sidebar']`
+ *  - Array of strings: `useTranslation(['common', 'nav'])` → `['common', 'nav']`
+ */
+export declare function namespacesFromArg(node: unknown): string[];
+//# sourceMappingURL=ast.d.ts.map

package/dist/core/scanner-internals/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/core/scanner-internals/ast.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAYxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAUrE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAiBxD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAWzD"}