@cr8rcho/alkahest 0.1.1

package/dist/core/adapters/next-app.js

@@ -0,0 +1,62 @@
+import { statSync, existsSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { sourceFileFor, walk, parseReactScreen, titleFromRoute, isReactRouterSpa, isReactNativeApp, isVueApp, isAndroidApp, isRemixApp, isAstroApp, isAngularApp, isRailsApp } from "./react-jsx.js";
+/**
+ * Next.js app-router adapter: treats `app/**​/page.tsx` as screens, parses with ts-morph.
+ * Screen id = route ("/dashboard/settings"). Entry point = root route "/".
+ * JSX signal extraction is shared via react-jsx.ts.
+ */
+const PAGE_RE = /^page\.(tsx|jsx|ts|js)$/;
+function appDirOf(projectRoot) {
+    return ([join(projectRoot, "app"), join(projectRoot, "src", "app")].find((d) => existsSync(d) && statSync(d).isDirectory()) ?? null);
+}
+export const nextAppAdapter = {
+    id: "next",
+    router: "next-app",
+    detect(projectRoot) {
+        return (appDirOf(projectRoot) !== null &&
+            !isReactRouterSpa(projectRoot) &&
+            !isReactNativeApp(projectRoot) &&
+            !isVueApp(projectRoot) &&
+            !isAndroidApp(projectRoot) &&
+            !isRemixApp(projectRoot) &&
+            !isAstroApp(projectRoot) &&
+            !isAngularApp(projectRoot) &&
+            !isRailsApp(projectRoot));
+    },
+    discover(projectRoot) {
+        const appDir = appDirOf(projectRoot);
+        if (!appDir)
+            return [];
+        const files = [];
+        walk(appDir, (file) => {
+            const base = file.slice(file.lastIndexOf(sep) + 1);
+            if (!PAGE_RE.test(base))
+                return;
+            const route = routeFromAppFile(appDir, file);
+            files.push({
+                absPath: file,
+                relPath: relative(projectRoot, file).split(sep).join("/"),
+                id: route,
+                route,
+                title: titleFromRoute(route),
+                isEntry: route === "/", // app-router entry point = root route
+            });
+        });
+        files.sort((a, b) => a.route.localeCompare(b.route));
+        return files;
+    },
+    parse(file) {
+        return parseReactScreen(sourceFileFor(file.absPath));
+    },
+};
+/** app-router file path → route. Strips route groups `(x)`, keeps dynamic `[slug]`. */
+function routeFromAppFile(appDir, file) {
+    const segs = relative(appDir, file)
+        .split(sep)
+        .slice(0, -1)
+        .filter((s) => !(s.startsWith("(") && s.endsWith(")")));
+    const route = "/" + segs.join("/");
+    return route.length > 1 ? route.replace(/\/+$/, "") : "/";
+}
+//# sourceMappingURL=next-app.js.map

package/dist/core/adapters/next-app.js.map

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

package/dist/core/adapters/next-pages.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkAdapter } from "./types.js";
+export declare const nextPagesAdapter: FrameworkAdapter;

package/dist/core/adapters/next-pages.js

@@ -0,0 +1,70 @@
+import { statSync, existsSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { sourceFileFor, walk, parseReactScreen, titleFromRoute, isReactRouterSpa, isReactNativeApp, isVueApp, isAndroidApp, isRemixApp, isAstroApp, isAngularApp, isRailsApp } from "./react-jsx.js";
+/**
+ * Next.js pages-router adapter: treats `pages/**​/*.tsx` as screens (one file = one
+ * route), parses with ts-morph. Screen id = route ("/blog/[slug]"). Entry = "/".
+ * Excludes API routes and the framework files (_app/_document/_error).
+ * JSX signal extraction is shared via react-jsx.ts; only file→route differs from next-app.
+ */
+const PAGE_RE = /\.(tsx|jsx|ts|js)$/;
+const SPECIAL = /^_(app|document|error)$/;
+function pagesDirOf(projectRoot) {
+    return ([join(projectRoot, "pages"), join(projectRoot, "src", "pages")].find((d) => existsSync(d) && statSync(d).isDirectory()) ?? null);
+}
+export const nextPagesAdapter = {
+    id: "next",
+    router: "next-pages",
+    detect(projectRoot) {
+        return (pagesDirOf(projectRoot) !== null &&
+            !isReactRouterSpa(projectRoot) &&
+            !isReactNativeApp(projectRoot) &&
+            !isVueApp(projectRoot) &&
+            !isAndroidApp(projectRoot) &&
+            !isRemixApp(projectRoot) &&
+            !isAstroApp(projectRoot) &&
+            !isAngularApp(projectRoot) &&
+            !isRailsApp(projectRoot));
+    },
+    discover(projectRoot) {
+        const pagesDir = pagesDirOf(projectRoot);
+        if (!pagesDir)
+            return [];
+        const apiDir = join(pagesDir, "api");
+        const files = [];
+        walk(pagesDir, (file) => {
+            if (file.startsWith(apiDir + sep))
+                return; // API routes are not screens
+            if (!PAGE_RE.test(file))
+                return;
+            const base = file.slice(file.lastIndexOf(sep) + 1).replace(PAGE_RE, "");
+            if (SPECIAL.test(base))
+                return; // _app / _document / _error
+            const route = routeFromPageFile(pagesDir, file);
+            files.push({
+                absPath: file,
+                relPath: relative(projectRoot, file).split(sep).join("/"),
+                id: route,
+                route,
+                title: titleFromRoute(route),
+                isEntry: route === "/", // pages-router entry point = root route
+            });
+        });
+        files.sort((a, b) => a.route.localeCompare(b.route));
+        return files;
+    },
+    parse(file) {
+        return parseReactScreen(sourceFileFor(file.absPath));
+    },
+};
+/** pages-router file path → route. `index` drops to its dir, keeps dynamic `[slug]`/`[...all]`. */
+function routeFromPageFile(pagesDir, file) {
+    const segs = relative(pagesDir, file)
+        .replace(PAGE_RE, "")
+        .split(sep);
+    if (segs[segs.length - 1] === "index")
+        segs.pop();
+    const route = "/" + segs.join("/");
+    return route.length > 1 ? route.replace(/\/+$/, "") : "/";
+}
+//# sourceMappingURL=next-pages.js.map

package/dist/core/adapters/next-pages.js.map

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

package/dist/core/adapters/nuxt.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkAdapter } from "./types.js";
+export declare const nuxtAdapter: FrameworkAdapter;

package/dist/core/adapters/nuxt.js

@@ -0,0 +1,59 @@
+import { statSync, existsSync, readFileSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { walkVue, safeReadVue, parseVueSfc, titleFromRoute } from "./vue-sfc.js";
+/**
+ * Nuxt adapter (Vue, file-based). `pages/**​/*.vue` → routes, mirroring Nuxt's filesystem
+ * router. Screen id = route ("/users/[id]"); `index.vue` collapses to its dir; dynamic
+ * `[id]`/`[...slug]` kept. Entry = "/". SFC signal extraction is shared via vue-sfc.ts.
+ */
+function pagesDirOf(projectRoot) {
+    return ([join(projectRoot, "pages"), join(projectRoot, "src", "pages")].find((d) => existsSync(d) && statSync(d).isDirectory()) ?? null);
+}
+function hasNuxtDep(projectRoot) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(projectRoot, "package.json"), "utf8"));
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        return "nuxt" in deps;
+    }
+    catch {
+        return false;
+    }
+}
+export const nuxtAdapter = {
+    id: "nuxt",
+    router: "nuxt-pages",
+    detect(projectRoot) {
+        return hasNuxtDep(projectRoot) && pagesDirOf(projectRoot) !== null;
+    },
+    discover(projectRoot) {
+        const pagesDir = pagesDirOf(projectRoot);
+        if (!pagesDir)
+            return [];
+        const files = [];
+        walkVue(pagesDir, (file) => {
+            const route = routeFromPageFile(pagesDir, file);
+            files.push({
+                absPath: file,
+                relPath: relative(projectRoot, file).split(sep).join("/"),
+                id: route,
+                route,
+                title: titleFromRoute(route),
+                isEntry: route === "/",
+            });
+        });
+        files.sort((a, b) => a.route.localeCompare(b.route));
+        return files;
+    },
+    parse(file) {
+        return parseVueSfc(safeReadVue(file.absPath));
+    },
+};
+/** Nuxt page file → route. `index` collapses to its dir; keeps dynamic `[id]`/`[...slug]`. */
+function routeFromPageFile(pagesDir, file) {
+    const segs = relative(pagesDir, file).replace(/\.vue$/, "").split(sep);
+    if (segs[segs.length - 1] === "index")
+        segs.pop();
+    const route = "/" + segs.join("/");
+    return route.length > 1 ? route.replace(/\/+$/, "") : "/";
+}
+//# sourceMappingURL=nuxt.js.map

package/dist/core/adapters/nuxt.js.map

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

package/dist/core/adapters/rails.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkAdapter } from "./types.js";
+export declare const railsAdapter: FrameworkAdapter;

package/dist/core/adapters/rails.js

@@ -0,0 +1,275 @@
+import { readdirSync, readFileSync, existsSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+// path-helper name (without the _path/_url suffix) → route, rebuilt each discover() and read by parse().
+let helperToRoute = new Map();
+let routeToInfo = new Map();
+export const railsAdapter = {
+    id: "rails",
+    router: "rails-routes",
+    detect(projectRoot) {
+        if (existsSync(join(projectRoot, "config", "routes.rb")))
+            return true;
+        const gemfile = join(projectRoot, "Gemfile");
+        return existsSync(gemfile) && /\bgem\s+["']rails["']/.test(safeRead(gemfile));
+    },
+    discover(projectRoot) {
+        helperToRoute = new Map();
+        routeToInfo = new Map();
+        const routesFile = findRoutesFile(projectRoot);
+        if (!routesFile)
+            return [];
+        const routes = parseRoutes(safeRead(routesFile));
+        const files = [];
+        const usedRelPaths = new Set();
+        for (const r of routes) {
+            if (routeToInfo.has(r.route))
+                continue; // first declaration wins
+            const viewFile = resolveView(projectRoot, r.controller, r.action);
+            const info = { ...r, viewFile };
+            routeToInfo.set(r.route, info);
+            for (const h of r.helpers)
+                helperToRoute.set(h, r.route);
+            const repr = viewFile ?? join(projectRoot, "config", "routes.rb");
+            let relPath = relative(projectRoot, repr).split(sep).join("/");
+            if (usedRelPaths.has(relPath))
+                relPath = `${relPath}#${r.route}`;
+            usedRelPaths.add(relPath);
+            files.push({
+                absPath: repr,
+                relPath,
+                id: r.route,
+                route: r.route,
+                title: titleFromRoute(r.route, `${r.controller}#${r.action}`),
+                isEntry: r.route === "/",
+            });
+        }
+        files.sort((a, b) => a.route.localeCompare(b.route));
+        return files;
+    },
+    parse(file) {
+        const info = routeToInfo.get(file.id);
+        const controllerSrc = info ? actionBody(controllerFile(file, info), info.action) : "";
+        const viewSrc = info?.viewFile ? safeRead(info.viewFile) : "";
+        return parseRails(controllerSrc, viewSrc);
+    },
+};
+const ROOT_RE = /^root\s+(?:to:\s*)?["']([\w/]+)#(\w+)["']/;
+const VERB_RE = /^(?:get|post|put|patch|delete)\s+["']([^"']+)["']\s*(?:,\s*(?:to:\s*)?|=>\s*)["']([\w/]+)#(\w+)["']/;
+const RESOURCES_RE = /^resources?\s+:(\w+)/;
+const RESOURCE_SINGULAR_RE = /^resource\s+:(\w+)/;
+function parseRoutes(src) {
+    const out = [];
+    for (const rawLine of src.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const root = line.match(ROOT_RE);
+        if (root) {
+            out.push({ route: "/", controller: root[1], action: root[2], helpers: ["root"] });
+            continue;
+        }
+        const verb = line.match(VERB_RE);
+        if (verb) {
+            const path = normalize(verb[1]);
+            out.push({ route: path, controller: verb[2], action: verb[3], helpers: [helperFromPath(path)] });
+            continue;
+        }
+        const res = line.match(RESOURCES_RE);
+        if (res && !RESOURCE_SINGULAR_RE.test(line)) {
+            out.push(...expandResources(res[1]));
+            continue;
+        }
+        const sres = line.match(RESOURCE_SINGULAR_RE);
+        if (sres)
+            out.push(...expandSingularResource(sres[1]));
+    }
+    return out;
+}
+/** `resources :posts` → the 7 RESTful routes with their path helpers. */
+function expandResources(name) {
+    const c = name; // controller = plural resource name
+    const singular = singularize(name);
+    return [
+        { route: `/${name}`, controller: c, action: "index", helpers: [name] },
+        { route: `/${name}/new`, controller: c, action: "new", helpers: [`new_${singular}`] },
+        { route: `/${name}/:id`, controller: c, action: "show", helpers: [singular] },
+        { route: `/${name}/:id/edit`, controller: c, action: "edit", helpers: [`edit_${singular}`] },
+    ];
+}
+/** `resource :profile` (singular) → show/new/edit (no index, no :id). */
+function expandSingularResource(name) {
+    const plural = name + "s";
+    return [
+        { route: `/${name}`, controller: plural, action: "show", helpers: [name] },
+        { route: `/${name}/new`, controller: plural, action: "new", helpers: [`new_${name}`] },
+        { route: `/${name}/edit`, controller: plural, action: "edit", helpers: [`edit_${name}`] },
+    ];
+}
+// ---------- controller + view resolution ----------
+function findRoutesFile(projectRoot) {
+    const f = join(projectRoot, "config", "routes.rb");
+    if (existsSync(f))
+        return f;
+    let hit = null;
+    walkRb(projectRoot, (file) => {
+        if (!hit && file.endsWith("routes.rb"))
+            hit = file;
+    });
+    return hit;
+}
+/** app/views/<controller>/<action>.html.erb (also .erb / .haml fallbacks). */
+function resolveView(projectRoot, controller, action) {
+    const bases = [
+        join(projectRoot, "app", "views", controller, action),
+        join(projectRoot, "views", controller, action),
+    ];
+    const exts = [".html.erb", ".html.haml", ".erb", ".haml"];
+    for (const b of bases)
+        for (const e of exts)
+            if (existsSync(b + e))
+                return b + e;
+    return null;
+}
+/** app/controllers/<controller>_controller.rb. */
+function controllerFile(file, info) {
+    // viewFile path: …/app/views/<controller>/<action>… → …/app/controllers/<controller>_controller.rb
+    const abs = file.absPath;
+    const viewsIdx = abs.lastIndexOf(`${sep}views${sep}`);
+    if (viewsIdx >= 0) {
+        const appRoot = abs.slice(0, viewsIdx);
+        const cf = join(appRoot, "controllers", `${info.controller}_controller.rb`);
+        if (existsSync(cf))
+            return cf;
+    }
+    return "";
+}
+/** Body of `def <action>` up to the matching `end` (simple indent-agnostic: next `def`/class `end`). */
+function actionBody(controllerPath, action) {
+    if (!controllerPath)
+        return "";
+    const lines = safeRead(controllerPath).split("\n");
+    const start = lines.findIndex((l) => new RegExp(`^\\s*def\\s+${action}\\b`).test(l));
+    if (start < 0)
+        return "";
+    const out = [lines[start]];
+    for (let i = start + 1; i < lines.length; i++) {
+        if (/^\s*def\s+\w/.test(lines[i]))
+            break; // next action
+        out.push(lines[i]);
+    }
+    return out.join("\n");
+}
+// ---------- signal extraction (controller action + view ERB) ----------
+const LINK_TO = /\blink_to\b[^,]*,\s*(\w+)_(?:path|url)\b/; // link_to 'x', posts_path
+const LINK_TO_LITERAL = /\blink_to\b[^,]*,\s*["'](\/[^"']*)["']/;
+const HREF = /<a\b[^>]*?\shref=["']([^"'#<]+)["']/i;
+const REDIRECT_HELPER = /\bredirect_to\s+(\w+)_(?:path|url)\b/;
+const REDIRECT_LITERAL = /\bredirect_to\s+["'](\/[^"']*)["']/;
+const HTTP_CALL = /\b(?:Net::HTTP|HTTParty|Faraday)[.\w]*\.(get|post|put|delete)\b|\bHTTParty\.(get|post)\s*\(\s*["']([^"']+)["']/;
+const AR_CALL = /\b([A-Z]\w*)\.(all|where|find|find_by|create|count|first|last)\b/;
+const FEATURE_RULES = [
+    { re: /<button\b[^>]*>([^<]*)/i, kind: "button", label: (m) => m[1].trim() || "Button" },
+    { re: /\bsubmit\b/i, kind: "button", label: () => "Submit" },
+    { re: /<(?:input|textarea|select)\b/i, kind: "input", label: () => "Input" },
+    { re: /\b(?:text_field|text_area|select|number_field|email_field)\b/, kind: "input", label: () => "Input" },
+    { re: /\b(?:form_with|form_for|form_tag)\b|<form\b/i, kind: "form", label: () => "Form" },
+];
+function parseRails(controllerSrc, viewSrc) {
+    const navs = [];
+    const calls = [];
+    const features = [];
+    // --- controller action: redirects + ActiveRecord / HTTP calls ---
+    controllerSrc.split(/\r?\n/).forEach((rawLine, i) => {
+        const line = rawLine.trim();
+        const redH = line.match(REDIRECT_HELPER);
+        const redL = line.match(REDIRECT_LITERAL);
+        if (redH)
+            navs.push({ target: helperToRoute.get(redH[1]) ?? null, raw: snippet(line), trigger: "redirect_to", line: i + 1 });
+        else if (redL)
+            navs.push({ target: normalize(redL[1]), raw: snippet(line), trigger: "redirect_to", line: i + 1 });
+        const ar = line.match(AR_CALL);
+        if (ar)
+            calls.push({ url: `${ar[1]}.${ar[2]}`, raw: snippet(line), trigger: "activerecord", line: i + 1 });
+        const httpM = line.match(HTTP_CALL);
+        if (httpM)
+            calls.push({ url: httpM[3] ?? null, method: (httpM[1] ?? httpM[2] ?? "GET").toUpperCase(), raw: snippet(line), trigger: "http", line: i + 1 });
+    });
+    // --- view ERB: link_to / <a href> nav, form features ---
+    viewSrc.split(/\r?\n/).forEach((rawLine, i) => {
+        const line = rawLine.trim();
+        const linkH = line.match(LINK_TO);
+        const linkL = line.match(LINK_TO_LITERAL);
+        const href = line.match(HREF);
+        if (linkH)
+            navs.push({ target: helperToRoute.get(linkH[1]) ?? null, raw: snippet(line), trigger: "link_to", line: i + 1 });
+        else if (linkL)
+            navs.push({ target: normalize(linkL[1]), raw: snippet(line), trigger: "link_to", line: i + 1 });
+        else if (href)
+            navs.push({ target: normalize(href[1]), raw: snippet(line), trigger: "<a href>", line: i + 1 });
+        for (const rule of FEATURE_RULES) {
+            const m = line.match(rule.re);
+            if (m) {
+                features.push({ kind: rule.kind, label: rule.label(m), detail: m[0].trim().slice(0, 40), line: i + 1 });
+                break;
+            }
+        }
+    });
+    return { navs, calls, features, components: [], contains: [] };
+}
+// ---------- helpers ----------
+function helperFromPath(path) {
+    // "/about" → "about"; "/" → "root"; strip params, join segments with _.
+    const segs = path.split("/").filter((s) => s && !s.startsWith(":"));
+    return segs.length ? segs.join("_") : "root";
+}
+function singularize(name) {
+    if (name.endsWith("ies"))
+        return name.slice(0, -3) + "y";
+    if (name.endsWith("ses"))
+        return name.slice(0, -2);
+    if (name.endsWith("s"))
+        return name.slice(0, -1);
+    return name;
+}
+function normalize(path) {
+    let r = path.startsWith("/") ? path : "/" + path;
+    r = r.replace(/\/{2,}/g, "/");
+    return r.length > 1 ? r.replace(/\/+$/, "") : "/";
+}
+function titleFromRoute(route, ca) {
+    if (route === "/")
+        return "Home";
+    const last = route.split("/").filter((s) => s && !s.startsWith(":")).pop() ?? ca;
+    return last.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function walkRb(dir, onFile) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith(".") || entry.name === "node_modules" || entry.name === "vendor" || entry.name === "tmp")
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            walkRb(full, onFile);
+        else if (entry.name.endsWith(".rb"))
+            onFile(full);
+    }
+}
+function safeRead(file) {
+    try {
+        return readFileSync(file, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+function snippet(text) {
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length > 80 ? flat.slice(0, 77) + "..." : flat;
+}
+//# sourceMappingURL=rails.js.map

package/dist/core/adapters/rails.js.map

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

package/dist/core/adapters/react-jsx.d.ts

@@ -0,0 +1,68 @@
+import { Project } from "ts-morph";
+import type { SourceFile } from "ts-morph";
+import type { RawScreen } from "./types.js";
+/** Shared ts-morph project (lazy). allowJs + React JSX so .jsx/.tsx all parse. */
+export declare function project(): Project;
+/** Add a file to the shared project, reusing it if already added (parse is idempotent). */
+export declare function sourceFileFor(absPath: string): SourceFile;
+/** True if any of `names` is a (dev)dependency in the project's package.json. */
+export declare function hasDependency(projectRoot: string, ...names: string[]): boolean;
+/**
+ * A non-Next React SPA that happens to use a `pages/`-style folder shouldn't be read as
+ * Next.js. True when react-router is a dependency and Next.js is not — the Next adapters
+ * bow out in that case (the dependency signal beats the directory-name heuristic).
+ */
+export declare function isReactRouterSpa(projectRoot: string): boolean;
+/**
+ * A React Native / Expo project. Expo Router uses an `app/` dir just like Next's app-router,
+ * so the Next adapters must bow out when this is true (the dependency signal disambiguates).
+ */
+export declare function isReactNativeApp(projectRoot: string): boolean;
+/**
+ * A Remix / React Router 7 (framework mode) project. Routes live in `app/routes/`, so the
+ * `app/` dir would otherwise make the Next app-router adapter claim it — the dependency signal
+ * (`@remix-run/*` or `@react-router/dev`) disambiguates, so the Next adapters bow out.
+ */
+export declare function isRemixApp(projectRoot: string): boolean;
+/**
+ * A Vue/Nuxt project. Nuxt also uses a `pages/` dir, which would otherwise make the Next
+ * pages-router adapter claim it — so the Next adapters bow out when this is true.
+ */
+export declare function isVueApp(projectRoot: string): boolean;
+/**
+ * An Astro project. Astro uses `src/pages/`, which the Next pages-router adapter would otherwise
+ * claim — so the Next adapters bow out when `astro` is a dependency.
+ */
+export declare function isAstroApp(projectRoot: string): boolean;
+/**
+ * An Angular project. Angular's conventional `src/app/` dir collides with Next's app-router,
+ * so the Next adapters bow out when `@angular/core`/`@angular/router` is a dependency.
+ */
+export declare function isAngularApp(projectRoot: string): boolean;
+/**
+ * A Rails project. Rails' `app/` dir collides with Next's app-router; detect by `config/routes.rb`
+ * (Rails has no package.json) or a Gemfile that pulls in rails, so the Next adapters bow out.
+ */
+export declare function isRailsApp(projectRoot: string): boolean;
+/**
+ * An Android/Compose project. Gradle's `app/` module dir collides with Next's app-router
+ * convention, so the Next adapters must bow out. Android projects have no package.json, so
+ * detect by Gradle build files (build.gradle / build.gradle.kts / settings.gradle*).
+ */
+export declare function isAndroidApp(projectRoot: string): boolean;
+/** React/JS source extensions, in resolution-priority order. */
+export declare const SOURCE_EXTS: string[];
+/**
+ * Map each importable name in a file to its module specifier — covers default and named
+ * static imports plus `const X = lazy(() => import("…"))`. Used to turn a route's referenced
+ * component identifier back into the file it lives in.
+ */
+export declare function importMap(sf: SourceFile): Map<string, string>;
+/** Resolve a relative module specifier (from `configDir`) to an on-disk source file, or null. */
+export declare function resolveComponentFile(configDir: string, spec: string | undefined): string | null;
+/** Recursively visit every file under `dir`, skipping node_modules and dotfiles. */
+export declare function walk(dir: string, onFile: (file: string) => void): void;
+/** Last path segment → Title Case, unwrapping dynamic `[slug]`/`:slug`. Shared route→title. */
+export declare function titleFromRoute(route: string): string;
+/** Parse one React/JSX screen file into raw nav/call/feature signals. */
+export declare function parseReactScreen(sf: SourceFile): RawScreen;