@translation-cms/sync 1.2.1 → 1.2.4

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

@@ -0,0 +1,80 @@
+/**
+ * AST parsing and traversal utilities.
+ */
+import { parse } from '@babel/parser';
+import path from 'path';
+/**
+ * Walk an AST tree depth-first, calling visit() for each node.
+ */
+export function walk(node, visit) {
+    if (!node || typeof node !== 'object')
+        return;
+    if (Array.isArray(node)) {
+        for (const item of node)
+            walk(item, visit);
+        return;
+    }
+    const n = node;
+    if (typeof n.type === 'string')
+        visit(n);
+    for (const value of Object.values(n)) {
+        if (value && typeof value === 'object')
+            walk(value, visit);
+    }
+}
+/**
+ * Parse source code using Babel with appropriate plugins based on file extension.
+ */
+export function parseSource(filePath, source) {
+    const ext = path.extname(filePath);
+    const plugins = [];
+    if (ext === '.ts' || ext === '.tsx')
+        plugins.push('typescript');
+    if (ext !== '.ts')
+        plugins.push('jsx'); // .tsx, .jsx, .js
+    return parse(source, {
+        sourceType: 'module',
+        plugins,
+        errorRecovery: true,
+    });
+}
+/**
+ * Returns the string value of a StringLiteral or no-expression TemplateLiteral node.
+ */
+export function stringValue(node) {
+    if (!node || typeof node !== 'object')
+        return null;
+    const n = node;
+    if (n.type === 'StringLiteral' && typeof n.value === 'string')
+        return n.value;
+    if (n.type === 'TemplateLiteral') {
+        const exprs = n.expressions;
+        const quasis = n.quasis;
+        if (exprs.length === 0 && quasis.length === 1) {
+            const quasi = quasis[0];
+            if (quasi?.value) {
+                return quasi.value.cooked ?? null;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Extracts namespace string(s) from a useTranslation/getTranslation argument.
+ * Handles both single strings and arrays of strings.
+ */
+export function namespacesFromArg(node) {
+    const single = stringValue(node);
+    if (single)
+        return [single];
+    if (!node || typeof node !== 'object')
+        return [];
+    const n = node;
+    if (n.type === 'ArrayExpression') {
+        return n.elements
+            .map(stringValue)
+            .filter((s) => s !== null);
+    }
+    return [];
+}
+//# sourceMappingURL=ast.js.map

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

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

package/dist/core/scanner-internals/file-walker.d.ts

@@ -0,0 +1,9 @@
+/**
+ * File system traversal utilities.
+ */
+/**
+ * Recursively walk through files in a directory, yielding file paths that match
+ * the source extensions and are not in excluded directories.
+ */
+export declare function walkFiles(dir: string, excludedDirs: Set<string>, sourceExtensions: Set<string>): Generator<string>;
+//# sourceMappingURL=file-walker.d.ts.map

package/dist/core/scanner-internals/file-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-walker.d.ts","sourceRoot":"","sources":["../../../src/core/scanner-internals/file-walker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAiB,SAAS,CACtB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,SAAS,CAAC,MAAM,CAAC,CAgBnB"}

package/dist/core/scanner-internals/file-walker.js

@@ -0,0 +1,25 @@
+/**
+ * File system traversal utilities.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * Recursively walk through files in a directory, yielding file paths that match
+ * the source extensions and are not in excluded directories.
+ */
+export function* walkFiles(dir, excludedDirs, sourceExtensions) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            if (excludedDirs.has(entry.name))
+                continue;
+            yield* walkFiles(path.join(dir, entry.name), excludedDirs, sourceExtensions);
+        }
+        else if (entry.isFile()) {
+            if (sourceExtensions.has(path.extname(entry.name))) {
+                yield path.join(dir, entry.name);
+            }
+        }
+    }
+}
+//# sourceMappingURL=file-walker.js.map

package/dist/core/scanner-internals/file-walker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-walker.js","sourceRoot":"","sources":["../../../src/core/scanner-internals/file-walker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,SAAS,CAAC,CAAC,SAAS,CACtB,GAAW,EACX,YAAyB,EACzB,gBAA6B;IAE7B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC3C,KAAK,CAAC,CAAC,SAAS,CACZ,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAC1B,YAAY,EACZ,gBAAgB,CACnB,CAAC;QACN,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxB,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/core/scanner-internals/import-resolver.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Import path resolution and traversal.
+ * Handles aliased imports (@/path), relative imports (../path), and layout chains.
+ */
+/**
+ * Extract all local imports (relative and aliased) from a source file via AST.
+ */
+export declare function extractLocalImports(filePath: string, sourceExtensions: Set<string>, root?: string, pathMappings?: Record<string, string[]>): string[];
+/**
+ * For a given page file, find all wrapping layout files up to the app root.
+ */
+export declare function getLayoutChain(root: string, pageFile: string, sourceExtensions: Set<string>): string[];
+//# sourceMappingURL=import-resolver.d.ts.map

package/dist/core/scanner-internals/import-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/scanner-internals/import-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4EH;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC7B,IAAI,CAAC,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACxC,MAAM,EAAE,CAoDV;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,MAAM,EAAE,CAeV"}

package/dist/core/scanner-internals/import-resolver.js

@@ -0,0 +1,124 @@
+/**
+ * Import path resolution and traversal.
+ * Handles aliased imports (@/path), relative imports (../path), and layout chains.
+ */
+import fs from 'fs';
+import path from 'path';
+import { parseSource, walk } from './ast.js';
+/**
+ * Resolve an aliased import path (e.g., @/components/button) to an absolute file path.
+ * Uses tsconfig path mappings if provided.
+ */
+function resolveAliasedImport(importPath, root, sourceExtensions, pathMappings) {
+    if (!pathMappings)
+        return null;
+    for (const [alias, targets] of Object.entries(pathMappings)) {
+        const pattern = alias.replace(/\*/g, '(.*)');
+        const regex = new RegExp(`^${pattern}$`);
+        const match = importPath.match(regex);
+        if (match) {
+            const captured = match[1] ?? '';
+            for (const target of targets) {
+                const resolved = target.replace(/\*/g, captured);
+                const fullPath = path.join(root, resolved);
+                if (sourceExtensions.has(path.extname(fullPath))) {
+                    if (fs.existsSync(fullPath))
+                        return fullPath;
+                }
+                else {
+                    for (const ext of sourceExtensions) {
+                        const candidate = fullPath + ext;
+                        if (fs.existsSync(candidate))
+                            return candidate;
+                    }
+                    for (const ext of sourceExtensions) {
+                        const candidate = path.join(fullPath, 'index' + ext);
+                        if (fs.existsSync(candidate))
+                            return candidate;
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a relative import path to an absolute file path.
+ */
+function resolveLocalImport(fromDir, importPath, sourceExtensions) {
+    const joined = path.join(fromDir, importPath);
+    if (sourceExtensions.has(path.extname(joined))) {
+        return fs.existsSync(joined) ? joined : null;
+    }
+    for (const ext of sourceExtensions) {
+        const candidate = joined + ext;
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    for (const ext of sourceExtensions) {
+        const candidate = path.join(joined, 'index' + ext);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * Extract all local imports (relative and aliased) from a source file via AST.
+ */
+export function extractLocalImports(filePath, sourceExtensions, root, pathMappings) {
+    let source;
+    try {
+        source = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    let ast;
+    try {
+        ast = parseSource(filePath, source);
+    }
+    catch {
+        return [];
+    }
+    const fromDir = path.dirname(filePath);
+    const results = [];
+    walk(ast, node => {
+        if (node.type !== 'ImportDeclaration' &&
+            node.type !== 'ExportNamedDeclaration' &&
+            node.type !== 'ExportAllDeclaration')
+            return;
+        const src = node.source;
+        if (!src || typeof src.value !== 'string')
+            return;
+        const importPath = src.value;
+        let resolved = null;
+        if (importPath.startsWith('.')) {
+            resolved = resolveLocalImport(fromDir, importPath, sourceExtensions);
+        }
+        else if (root && pathMappings) {
+            resolved = resolveAliasedImport(importPath, root, sourceExtensions, pathMappings);
+        }
+        if (resolved && !results.includes(resolved)) {
+            results.push(resolved);
+        }
+    });
+    return results;
+}
+/**
+ * For a given page file, find all wrapping layout files up to the app root.
+ */
+export function getLayoutChain(root, pageFile, sourceExtensions) {
+    const layouts = [];
+    let dir = path.dirname(pageFile);
+    while (dir.startsWith(root)) {
+        for (const ext of sourceExtensions) {
+            const candidate = path.join(dir, `layout${ext}`);
+            if (fs.existsSync(candidate)) {
+                layouts.push(candidate);
+            }
+        }
+        dir = path.dirname(dir);
+    }
+    return layouts;
+}
+//# sourceMappingURL=import-resolver.js.map

package/dist/core/scanner-internals/import-resolver.js.map

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

package/dist/core/scanner-internals/key-extractor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Extraction of translation keys from source files.
+ * Finds t('key') calls, useTranslation() bindings, and Trans components.
+ */
+import type { NamespaceMap } from './types.js';
+/**
+ * Extract translation keys from a source file.
+ * Handles:
+ *   - const { t } = useTranslation('ns') / getTranslation('ns')
+ *   - const { t: myT } = useTranslation(...)
+ *   - const t = await client.getTranslations(locale, 'ns')
+ *   - t('namespace:key') calls
+ *   - <Trans i18nKey="namespace:key"> components
+ */
+export declare function extractKeysFromFile(filePath: string, routes: string[], result: NamespaceMap): void;
+//# sourceMappingURL=key-extractor.d.ts.map

package/dist/core/scanner-internals/key-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-extractor.d.ts","sourceRoot":"","sources":["../../../src/core/scanner-internals/key-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,YAAY,CAAC;AA0BxD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,YAAY,GACrB,IAAI,CA2JN"}

package/dist/core/scanner-internals/key-extractor.js

@@ -0,0 +1,172 @@
+/**
+ * Extraction of translation keys from source files.
+ * Finds t('key') calls, useTranslation() bindings, and Trans components.
+ */
+import fs from 'fs';
+import path from 'path';
+import { parseSource, walk, stringValue, namespacesFromArg } from './ast.js';
+/**
+ * Add a key to the namespace map with its associated routes.
+ * Skips keys that look like paths or are suspiciously short/numeric.
+ */
+function addKey(map, namespace, key, routes) {
+    // Skip keys that look like URL paths or are suspiciously short/numeric
+    if (key.startsWith('/') || key.startsWith('.') || /^\d+$/.test(key))
+        return;
+    if (!map[namespace])
+        map[namespace] = new Map();
+    const existing = map[namespace].get(key) ?? [];
+    if (routes.length > 0) {
+        const merged = new Set(existing);
+        for (const route of routes)
+            merged.add(route);
+        map[namespace].set(key, Array.from(merged));
+    }
+    else if (existing.length === 0) {
+        map[namespace].set(key, []);
+    }
+}
+/**
+ * Extract translation keys from a source file.
+ * Handles:
+ *   - const { t } = useTranslation('ns') / getTranslation('ns')
+ *   - const { t: myT } = useTranslation(...)
+ *   - const t = await client.getTranslations(locale, 'ns')
+ *   - t('namespace:key') calls
+ *   - <Trans i18nKey="namespace:key"> components
+ */
+export function extractKeysFromFile(filePath, routes, result) {
+    let source;
+    try {
+        source = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    let ast;
+    try {
+        ast = parseSource(filePath, source);
+    }
+    catch {
+        return;
+    }
+    // --- Step 1: collect namespace bindings ---
+    // Maps the local variable name (e.g. 't') → the namespace(s) it's bound to.
+    const tBindings = new Map();
+    walk(ast, node => {
+        if (node.type !== 'VariableDeclaration')
+            return;
+        for (const decl of node.declarations) {
+            const init = decl.init;
+            if (!init)
+                continue;
+            // Unwrap await
+            const call = init.type === 'AwaitExpression'
+                ? init.argument
+                : init;
+            if (!call || call.type !== 'CallExpression')
+                continue;
+            const callee = call.callee;
+            const args = call.arguments;
+            // useTranslation('ns') / getTranslation('ns')
+            const isHook = callee.type === 'Identifier' &&
+                (callee.name === 'useTranslation' ||
+                    callee.name === 'getTranslation');
+            // client.getTranslations(locale, 'ns') / client.getT(locale, 'ns')
+            const isCmsStyle = callee.type === 'MemberExpression' &&
+                callee.property.type === 'Identifier' &&
+                /^getTranslations(?:WithFallback)?$|^getT$/.test(callee.property.name);
+            if (!isHook && !isCmsStyle)
+                continue;
+            const namespaces = isHook
+                ? namespacesFromArg(args[0])
+                : namespacesFromArg(args[1]); // CMS style: getTranslations(locale, ns)
+            if (!namespaces.length)
+                continue;
+            const id = decl.id;
+            if (id.type === 'Identifier') {
+                // const t = useTranslation(...)
+                tBindings.set(id.name, namespaces);
+            }
+            else if (id.type === 'ObjectPattern') {
+                // const { t } = useTranslation(...) or const { t: myT } = useTranslation(...)
+                for (const prop of id.properties) {
+                    if (prop.type !== 'ObjectProperty')
+                        continue;
+                    const keyNode = prop.key;
+                    const valNode = prop.value;
+                    const origName = keyNode.type === 'Identifier'
+                        ? keyNode.name
+                        : null;
+                    if (!origName ||
+                        (origName !== 't' && origName !== 'tDynamic'))
+                        continue;
+                    const boundName = valNode.type === 'Identifier'
+                        ? valNode.name
+                        : origName;
+                    tBindings.set(boundName, namespaces);
+                }
+            }
+        }
+    });
+    // --- Step 2: extract keys from t('...') call expressions ---
+    // Only extract from variables that are explicitly bound to translation functions.
+    walk(ast, node => {
+        if (node.type !== 'CallExpression')
+            return;
+        const callee = node.callee;
+        if (callee.type !== 'Identifier')
+            return;
+        const varName = callee.name;
+        // Only process if this variable is bound to a translation function
+        if (!tBindings.has(varName))
+            return;
+        const args = node.arguments;
+        const keyStr = stringValue(args[0]);
+        if (!keyStr)
+            return;
+        const colonIdx = keyStr.indexOf(':');
+        if (colonIdx > 0) {
+            // Explicit namespace: t('namespace:key')
+            addKey(result, keyStr.slice(0, colonIdx), keyStr.slice(colonIdx + 1), routes);
+        }
+        else {
+            // Bare key: t('key') with a known namespace binding — warn and register
+            const namespaces = tBindings.get(varName);
+            console.warn(`[WARN] Bare key in ${path.relative(process.cwd(), filePath)}: ${varName}('${keyStr}') — use ${varName}('namespace:${keyStr}') instead`);
+            for (const ns of namespaces)
+                addKey(result, ns, keyStr, routes);
+        }
+    });
+    // --- Step 3: <Trans i18nKey="namespace:key"> ---
+    walk(ast, node => {
+        if (node.type !== 'JSXOpeningElement')
+            return;
+        const name = node.name;
+        if (name.type !== 'JSXIdentifier' || name.name !== 'Trans')
+            return;
+        for (const attr of node.attributes) {
+            if (attr.type !== 'JSXAttribute')
+                continue;
+            const attrName = attr.name;
+            if (attrName.type !== 'JSXIdentifier' ||
+                attrName.name !== 'i18nKey')
+                continue;
+            const value = attr.value;
+            let keyStr = null;
+            if (value?.type === 'StringLiteral') {
+                keyStr = value.value;
+            }
+            else if (value?.type === 'JSXExpressionContainer') {
+                keyStr = stringValue(value.expression);
+            }
+            if (!keyStr)
+                continue;
+            const colonIdx = keyStr.indexOf(':');
+            if (colonIdx <= 0)
+                continue;
+            addKey(result, keyStr.slice(0, colonIdx), keyStr.slice(colonIdx + 1), routes);
+        }
+    });
+}
+//# sourceMappingURL=key-extractor.js.map

package/dist/core/scanner-internals/key-extractor.js.map

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

package/dist/core/scanner-internals/route-detector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Route detection from Next.js file paths.
+ * Maps source files (page.tsx, layout.tsx) to their corresponding route strings.
+ */
+/**
+ * Returns true when a page file only calls redirect() without rendering any JSX.
+ * Such pages are skipped from the preview route list because they have no UI to preview.
+ */
+export declare function isRedirectOnlyPage(filePath: string): boolean;
+/**
+ * Maps a source file path to Next.js route string(s).
+ * - page.tsx  → the route template it represents (e.g. /blog/[slug], /[locale]/about)
+ * - layout.tsx → the route template of its directory
+ * - Dynamic segments are kept as-is — resolved at preview time via project preview_params
+ * - Redirect-only pages (no JSX, just redirect()) → []
+ * - All other files (components, hooks, …) → []
+ */
+export declare function filePathToRoute(root: string, filePath: string): string[];
+//# sourceMappingURL=route-detector.d.ts.map

package/dist/core/scanner-internals/route-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-detector.d.ts","sourceRoot":"","sources":["../../../src/core/scanner-internals/route-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuC5D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBxE"}

package/dist/core/scanner-internals/route-detector.js

@@ -0,0 +1,74 @@
+/**
+ * Route detection from Next.js file paths.
+ * Maps source files (page.tsx, layout.tsx) to their corresponding route strings.
+ */
+import fs from 'fs';
+import path from 'path';
+import { parseSource, walk } from './ast.js';
+/**
+ * Returns true when a page file only calls redirect() without rendering any JSX.
+ * Such pages are skipped from the preview route list because they have no UI to preview.
+ */
+export function isRedirectOnlyPage(filePath) {
+    let source;
+    try {
+        source = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return false;
+    }
+    let ast;
+    try {
+        ast = parseSource(filePath, source);
+    }
+    catch {
+        return false;
+    }
+    let hasRedirect = false;
+    let hasJsxReturn = false;
+    walk(ast, node => {
+        if (node.type === 'CallExpression') {
+            const callee = node.callee;
+            if (callee.type === 'Identifier' && callee.name === 'redirect') {
+                hasRedirect = true;
+            }
+        }
+        if (node.type === 'ReturnStatement') {
+            const arg = node.argument;
+            if (!arg)
+                return;
+            const expr = arg.type === 'ParenthesizedExpression'
+                ? arg.expression
+                : arg;
+            if (expr?.type === 'JSXElement' || expr?.type === 'JSXFragment') {
+                hasJsxReturn = true;
+            }
+        }
+    });
+    return hasRedirect && !hasJsxReturn;
+}
+/**
+ * Maps a source file path to Next.js route string(s).
+ * - page.tsx  → the route template it represents (e.g. /blog/[slug], /[locale]/about)
+ * - layout.tsx → the route template of its directory
+ * - Dynamic segments are kept as-is — resolved at preview time via project preview_params
+ * - Redirect-only pages (no JSX, just redirect()) → []
+ * - All other files (components, hooks, …) → []
+ */
+export function filePathToRoute(root, filePath) {
+    const base = path.basename(filePath, path.extname(filePath));
+    if (base !== 'page')
+        return [];
+    // Skip pages that only redirect — no UI to preview
+    if (isRedirectOnlyPage(filePath))
+        return [];
+    const rel = path.relative(root, filePath).replace(/\\/g, '/');
+    const appMatch = rel.match(/^(?:src\/)?app\/(.*?)page\.[jt]sx?$/);
+    if (!appMatch)
+        return [];
+    let routePath = appMatch[1] ?? '';
+    routePath = routePath.replace(/\([^)]+\)\//g, ''); // strip route groups
+    routePath = routePath.replace(/\/$/, ''); // strip trailing slash
+    return ['/' + routePath];
+}
+//# sourceMappingURL=route-detector.js.map

package/dist/core/scanner-internals/route-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-detector.js","sourceRoot":"","sources":["../../../src/core/scanner-internals/route-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAG7C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAC/C,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACD,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACD,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE;QACb,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiB,CAAC;YACtC,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC7D,WAAW,GAAG,IAAI,CAAC;YACvB,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAsC,CAAC;YACxD,IAAI,CAAC,GAAG;gBAAE,OAAO;YACjB,MAAM,IAAI,GACN,GAAG,CAAC,IAAI,KAAK,yBAAyB;gBAClC,CAAC,CAAE,GAAG,CAAC,UAAsB;gBAC7B,CAAC,CAAC,GAAG,CAAC;YACd,IAAI,IAAI,EAAE,IAAI,KAAK,YAAY,IAAI,IAAI,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC9D,YAAY,GAAG,IAAI,CAAC;YACxB,CAAC;QACL,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,IAAI,CAAC,YAAY,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAE/B,mDAAmD;IACnD,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,IAAI,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB;IACxE,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,uBAAuB;IAEjE,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * Types and constants used throughout the scanner module.
+ */
+export declare const DEFAULT_EXCLUDED_DIRS: Set<string>;
+export declare const DEFAULT_SOURCE_EXTENSIONS: Set<string>;
+/** Options that control the file-system scan behaviour. */
+export interface ScanOptions {
+    /**
+     * Extra directories to exclude on top of the built-in defaults.
+     * @example ["e2e", "fixtures"]
+     */
+    excludedDirs?: string[];
+    /**
+     * Override the full set of file extensions to scan.
+     * When omitted the defaults (.ts .tsx .js .jsx) are used.
+     */
+    sourceExtensions?: string[];
+    /**
+     * External preview routes from database or config (namespace:key → routes[])
+     * These are applied in Pass 3.
+     * Keys are route patterns, values are mock params for dynamic segments.
+     * @example
+     * {
+     *   "/[locale]/blog/[slug]": { "slug": "first-post" },
+     *   "/[locale]/products/[slug]": { "slug": "product-a" }
+     * }
+     */
+    routeParams?: Record<string, Record<string, string>>;
+    /**
+     * TypeScript path mappings from tsconfig.json (for resolving aliased imports).
+     * @example { "@/*": ["./src/*"] }
+     */
+    pathMappings?: Record<string, string[]>;
+    /**
+     * Project root directory (used for resolving path aliases).
+     * Defaults to the root directory passed to scanProject.
+     */
+    projectRoot?: string;
+}
+/** A preview route — either a plain path string or an object with per-route params. */
+export type PreviewRoute = string | {
+    route: string;
+    params?: Record<string, string>;
+};
+/** namespace → (key → previewRoutes[]) */
+export type NamespaceMap = Record<string, Map<string, PreviewRoute[]>>;
+/** Return the route string key used for deduplication. */
+export declare function routeKey(r: PreviewRoute): string;
+/** AST node type for type-safe walking. */
+export type AstNode = {
+    type: string;
+} & Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/scanner-internals/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,eAAO,MAAM,qBAAqB,aAWhC,CAAC;AAEH,eAAO,MAAM,yBAAyB,aAKpC,CAAC;AAMH,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAClB,MAAM,GACN;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEzD,0CAA0C;AAC1C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAEvE,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAEhD;AAED,2CAA2C;AAC3C,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}