@flaid/devmap 0.6.0 → 0.8.0

package/README.md

@@ -150,8 +150,8 @@ terminal decoration, or streamed partial output.
 
 ## Supported Stacks
 
-- Frontend: Next.js, Astro, SvelteKit, Nuxt, React, Vue, Svelte
-- Backend: Express, NestJS, Fastify, Koa
+- Frontend: Next.js, Astro, SvelteKit, Nuxt, Remix, React Router v7, TanStack Router/Start, Expo Router, SolidStart, Qwik City, Angular, React, Vue, Svelte
+- Backend: Express, NestJS, Fastify, Hono, Elysia, Koa, AdonisJS
 
 Detection covers the full list above; Next.js and Express receive the deepest
 analysis. Multi-package workspaces are classified per project type, so a

package/dist/analyzers/detectors/adonisRouteDetector.d.ts

@@ -0,0 +1,4 @@
+import type { ScannedFile } from "../analysis/index.js";
+import type { RouteInfo } from "./routeDetector.js";
+export declare function detectAdonisRoutes(files: ScannedFile[], graph?: Record<string, string[]>): RouteInfo[];
+//# sourceMappingURL=adonisRouteDetector.d.ts.map

package/dist/analyzers/detectors/adonisRouteDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adonisRouteDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/adonisRouteDetector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAOxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAsCpD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,CA8GtG"}

package/dist/analyzers/detectors/adonisRouteDetector.js

@@ -0,0 +1,242 @@
+import { ts } from "ts-morph";
+import { isArchitectureSource } from "../graph/index.js";
+import { importCallSpecifier, isChainTop, stringValue, unwindChain, unwrapExpression } from "./astUtils.js";
+import { createModuleIndex, isShadowed, walkOutsideShadow } from "./moduleBindings.js";
+import { joinRoutePaths, sortRoutes } from "./routeUtils.js";
+/**
+ * AdonisJS declares every URL in `start/routes.ts` (or files it imports):
+ *
+ *   router.get("/", [HomeController, "index"])
+ *   router.group(() => { ... }).prefix("/api")
+ *   router.resource("posts", PostsController).apiOnly()
+ *   router.on("/").render("pages/home")
+ *
+ * Groups compose their prefix, `resource()` expands to the REST actions it
+ * registers (minus `apiOnly`, `only` and `except`), and the listed file is the
+ * controller that handles the route when it can be found.
+ */
+const ROUTER_MODULES = new Set(["@adonisjs/core/services/router", "@ioc:Adonis/Core/Route"]);
+const GATE = /@adonisjs\/core\/services\/router|@ioc:Adonis\/Core\/Route|\buse\(\s*["']Route["']\s*\)/;
+const VERBS = new Map([
+    ["get", "GET"], ["post", "POST"], ["put", "PUT"], ["patch", "PATCH"], ["delete", "DELETE"], ["any", undefined]
+]);
+const RESOURCE_ACTIONS = [
+    { name: "index", methods: ["GET"], path: "" },
+    { name: "create", methods: ["GET"], path: "/create" },
+    { name: "store", methods: ["POST"], path: "" },
+    { name: "show", methods: ["GET"], path: "/:id" },
+    { name: "edit", methods: ["GET"], path: "/:id/edit" },
+    { name: "update", methods: ["PATCH", "PUT"], path: "/:id" },
+    { name: "destroy", methods: ["DELETE"], path: "/:id" }
+];
+// What a handler that answers with a page calls.
+const PAGE_SIGNAL = /\b(?:view|inertia)\.render|\brenderInertia\b|\.view\.render|\bview\.make\b|\binertia\.render\b|<!doctype|<html\b|<body\b/i;
+export function detectAdonisRoutes(files, graph) {
+    const gated = files.filter((file) => /\.[cm]?[jt]sx?$/.test(file.path) && isArchitectureSource(file.path) && GATE.test(file.content));
+    if (gated.length === 0)
+        return [];
+    const index = createModuleIndex(files, graph);
+    const routes = new Map();
+    const paths = files.map((file) => file.path);
+    for (const file of gated) {
+        const module = index.get(file.path);
+        if (!module)
+            continue;
+        // v6 / v5 import the router; v4 reads it from the container: `const Route = use("Route")`.
+        const names = new Set([...module.imports].filter(([, value]) => ROUTER_MODULES.has(value.specifier)).map(([name]) => name));
+        for (const [name, initializer] of module.variables) {
+            if (ts.isCallExpression(initializer) && ts.isIdentifier(initializer.expression) && initializer.expression.text === "use"
+                && stringValue(initializer.arguments[0]) === "Route") {
+                names.add(name);
+            }
+        }
+        if (names.size === 0)
+            continue;
+        const visit = (scope, base) => {
+            const step = (node) => {
+                if (!ts.isCallExpression(node) || !isChainTop(node))
+                    return;
+                const { root, calls } = unwindChain(node);
+                if (calls.length === 0 || !ts.isIdentifier(root) || !names.has(root.text) || isShadowed(node, root.text))
+                    return;
+                processChain(calls, base);
+                return false;
+            };
+            walkOutsideShadow(scope, undefined, step);
+        };
+        const emit = (base, path, methods, handler) => {
+            const full = joinRoutePaths(base, path);
+            const kind = handler.kind ?? classify(full, methods, handler.signal);
+            const sorted = methods ? [...methods].sort() : undefined;
+            routes.set(`${sorted?.join(",") ?? "*"} ${full} ${handler.file}`, {
+                path: full,
+                file: handler.file,
+                kind,
+                ...(sorted ? { methods: sorted } : {})
+            });
+        };
+        const processChain = (calls, base) => {
+            for (let i = 0; i < calls.length; i += 1) {
+                const call = calls[i];
+                let end = i + 1;
+                while (end < calls.length && !isPrimary(calls[end].name))
+                    end += 1;
+                const modifiers = calls.slice(i + 1, end);
+                if (call.name === "group") {
+                    const callback = call.args.find((arg) => ts.isArrowFunction(unwrapExpression(arg)) || ts.isFunctionExpression(unwrapExpression(arg)));
+                    const prefix = modifiers.filter((item) => item.name === "prefix").map((item) => index.stringOf(item.args[0], module) ?? "").join("/");
+                    const body = callback && unwrapExpression(callback).body;
+                    if (body)
+                        visit(body, joinRoutePaths(base, prefix));
+                }
+                else if (VERBS.has(call.name)) {
+                    const path = index.stringOf(call.args[0], module);
+                    if (path !== undefined) {
+                        const method = VERBS.get(call.name);
+                        emit(base, path, method ? [method] : undefined, handlerOf(call.args[1], module, index, paths));
+                    }
+                }
+                else if (call.name === "route") {
+                    const path = index.stringOf(call.args[0], module);
+                    const methods = methodList(call.args[1]);
+                    if (path !== undefined)
+                        emit(base, path, methods, handlerOf(call.args[2], module, index, paths));
+                }
+                else if (call.name === "on") {
+                    const path = index.stringOf(call.args[0], module);
+                    const renders = modifiers.some((item) => item.name === "render" || item.name === "renderInertia");
+                    if (path !== undefined && renders)
+                        emit(base, path, ["GET"], { file: module.path, kind: "page" });
+                }
+                else if (call.name === "resource" || call.name === "shallowResource") {
+                    expandResource(call, modifiers, base);
+                }
+                i = end - 1;
+            }
+        };
+        const expandResource = (call, modifiers, base) => {
+            const name = index.stringOf(call.args[0], module);
+            if (!name)
+                return;
+            const handler = handlerOf(call.args[1], module, index, paths);
+            const apiOnly = modifiers.some((item) => item.name === "apiOnly");
+            const only = modifiers.find((item) => item.name === "only");
+            const except = modifiers.find((item) => item.name === "except");
+            const listed = (item) => new Set(arrayStrings(item?.args[0]));
+            const segments = name.split(".");
+            const prefix = segments.map((segment, position) => position === segments.length - 1 ? segment : `${segment}/:${singular(segment)}_id`).join("/");
+            for (const action of RESOURCE_ACTIONS) {
+                if (apiOnly && (action.name === "create" || action.name === "edit"))
+                    continue;
+                if (only && !listed(only).has(action.name))
+                    continue;
+                if (except && listed(except).has(action.name))
+                    continue;
+                const signal = handler.controller ? methodSignal(handler.controller, action.name, index) : handler.signal;
+                const kind = apiOnly ? "api" : action.name === "create" || action.name === "edit" ? "page" : undefined;
+                emit(base, `${prefix}${action.path}`, action.methods, { ...handler, signal, ...(kind ? { kind } : {}) });
+            }
+        };
+        visit(module.source, "/");
+    }
+    return sortRoutes([...routes.values()]);
+}
+const PRIMARY = new Set([...VERBS.keys(), "route", "on", "resource", "shallowResource", "group"]);
+function isPrimary(name) {
+    return PRIMARY.has(name);
+}
+/** Where a route is handled: `[Controller, "method"]`, `"#controllers/x.method"`, a class, or a closure. */
+function handlerOf(expression, module, index, paths) {
+    const fallback = { file: module.path };
+    if (!expression)
+        return fallback;
+    const node = unwrapExpression(expression);
+    if (ts.isArrowFunction(node) || ts.isFunctionExpression(node)) {
+        return { ...fallback, signal: PAGE_SIGNAL.test(node.getText()) };
+    }
+    let target;
+    let method;
+    if (ts.isArrayLiteralExpression(node) && node.elements[0]) {
+        target = unwrapExpression(node.elements[0]);
+        method = node.elements[1] ? stringValue(unwrapExpression(node.elements[1])) : undefined;
+    }
+    else if (ts.isIdentifier(node)) {
+        target = node;
+    }
+    let file;
+    if (target && ts.isIdentifier(target)) {
+        file = controllerFile(target.text, module, index);
+    }
+    else if (target) {
+        const specifier = importCallSpecifier(target);
+        file = specifier ? index.resolveSpecifier(module.path, specifier) : undefined;
+    }
+    const text = target === undefined ? stringValue(node) : undefined;
+    if (text !== undefined) {
+        // "#controllers/users_controller.index" (v6) or "UsersController.index" (v5)
+        const [controllerPath, action] = splitHandlerString(text);
+        method = action;
+        file = controllerPath.startsWith("#") || controllerPath.startsWith(".")
+            ? index.resolveSpecifier(module.path, controllerPath)
+            : paths.find((path) => /(?:^|\/)Controllers\//.test(path) && new RegExp(`/${escapeSlash(controllerPath)}\\.[cm]?[jt]s$`).test(path));
+    }
+    const controller = file ? index.get(file) : undefined;
+    if (!file || !controller)
+        return fallback;
+    return { file, controller, signal: method ? methodSignal(controller, method, index) : PAGE_SIGNAL.test(controller.source.text) };
+}
+function controllerFile(name, module, index) {
+    const lazy = module.variables.get(name);
+    const specifier = lazy ? importCallSpecifier(lazy) : undefined;
+    if (specifier)
+        return index.resolveSpecifier(module.path, specifier);
+    const imported = module.imports.get(name);
+    return imported ? index.resolveSpecifier(module.path, imported.specifier) : undefined;
+}
+function splitHandlerString(text) {
+    const match = /^(.*[^./])\.(\w+)$/.exec(text);
+    return match && !match[1].endsWith("/") ? [match[1], match[2]] : [text, undefined];
+}
+function escapeSlash(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** Does the controller action `method` render a page? Falls back to the whole file. */
+function methodSignal(controller, method, _index) {
+    let text;
+    const visit = (node) => {
+        if (text !== undefined)
+            return;
+        if (ts.isMethodDeclaration(node) && ts.isIdentifier(node.name) && node.name.text === method) {
+            text = node.getText();
+            return;
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(controller.source);
+    return PAGE_SIGNAL.test(text ?? controller.source.text);
+}
+function classify(path, methods, signal) {
+    if (/^\/api(?:\/|$)/.test(path))
+        return "api";
+    if (methods && methods.some((method) => method !== "GET"))
+        return "api";
+    return signal ? "page" : "api";
+}
+function methodList(expression) {
+    const methods = arrayStrings(expression).map((method) => method.toUpperCase());
+    return methods.length > 0 ? methods : undefined;
+}
+function arrayStrings(expression) {
+    const node = expression ? unwrapExpression(expression) : undefined;
+    if (!node || !ts.isArrayLiteralExpression(node))
+        return [];
+    return node.elements.flatMap((element) => stringValue(unwrapExpression(element)) ?? []);
+}
+function singular(name) {
+    if (/ies$/.test(name))
+        return `${name.slice(0, -3)}y`;
+    if (/(?:ss|us)$/.test(name))
+        return name;
+    return name.replace(/s$/, "");
+}
+//# sourceMappingURL=adonisRouteDetector.js.map

package/dist/analyzers/detectors/adonisRouteDetector.js.map

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

package/dist/analyzers/detectors/angularRouteDetector.d.ts

@@ -0,0 +1,4 @@
+import type { ScannedFile } from "../analysis/index.js";
+import type { RouteInfo } from "./routeDetector.js";
+export declare function detectAngularRoutes(files: ScannedFile[], graph?: Record<string, string[]>): RouteInfo[];
+//# sourceMappingURL=angularRouteDetector.d.ts.map

package/dist/analyzers/detectors/angularRouteDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angularRouteDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/angularRouteDetector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAgCpD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,CAuHvG"}

package/dist/analyzers/detectors/angularRouteDetector.js

@@ -0,0 +1,186 @@
+import { ts } from "ts-morph";
+import { isArchitectureSource } from "../graph/index.js";
+import { importCallSpecifier, propertyKeyName, unwrapExpression, walk } from "./astUtils.js";
+import { createModuleIndex } from "./moduleBindings.js";
+import { dropShadowedLayouts, joinRoutePaths, sortRoutes } from "./routeUtils.js";
+/**
+ * Angular routes are arrays of `{ path, component }` objects:
+ *
+ *   export const routes: Routes = [
+ *     { path: "", component: HomeComponent },
+ *     { path: "users/:id", loadComponent: () => import("./user").then((m) => m.UserComponent) },
+ *     { path: "admin", loadChildren: () => import("./admin/admin.routes").then((m) => m.ADMIN_ROUTES) },
+ *     { path: "docs", component: DocsShell, children: [{ path: "intro", component: Intro }] },
+ *     { path: "old", redirectTo: "new" },
+ *     { path: "**", component: NotFound }
+ *   ];
+ *
+ * `children` and `loadChildren` (a routes file, or an NgModule whose routing
+ * module calls `RouterModule.forChild`) compose their path onto the parent's.
+ * Redirects render nothing and are not listed; a shell route with an empty
+ * path gives way to the index route at the same URL. The listed file is the
+ * component, resolved through its import or lazy `import()`.
+ */
+const ROUTER_MODULE = /["']@angular\/router["']/;
+const HINT_KEYS = new Set([
+    "component", "loadComponent", "loadChildren", "children", "redirectTo",
+    "canActivate", "canActivateChild", "canMatch", "canDeactivate", "resolve", "title", "data", "pathMatch", "outlet"
+]);
+export function detectAngularRoutes(files, graph) {
+    const gated = files.filter((file) => /\.ts$/.test(file.path) && isArchitectureSource(file.path) && ROUTER_MODULE.test(file.content));
+    if (gated.length === 0)
+        return [];
+    const index = createModuleIndex(files, graph);
+    const cache = new Map();
+    /** Route arrays declared in a file. Lazy route files often skip the `@angular/router` import, so any file can be asked. */
+    const arraysIn = (path) => {
+        const cached = cache.get(path);
+        if (cached)
+            return cached;
+        const found = [];
+        const module = /\.ts$/.test(path) ? index.get(path) : undefined;
+        if (module) {
+            walk(module.source, (node) => {
+                if (ts.isArrayLiteralExpression(node) && looksLikeRoutes(node) && !isChildrenOfRoute(node)) {
+                    found.push({ module, node, name: declaredName(node) });
+                }
+            });
+        }
+        cache.set(path, found);
+        return found;
+    };
+    const arrays = new Map(gated.map((file) => [file.path, arraysIn(file.path)]).filter(([, list]) => list.length > 0));
+    /** Route arrays a `loadChildren` loads: the named export, else the file's arrays, else its routing module's. */
+    const lazyTargets = (module, loader) => {
+        const specifier = importCallSpecifier(loader);
+        const target = specifier ? index.resolveSpecifier(module.path, specifier) : undefined;
+        if (!target)
+            return [];
+        const member = memberName(loader);
+        const pick = (path) => {
+            const here = arraysIn(path);
+            const named = member && member !== "default" ? here.filter((entry) => entry.name === member) : [];
+            return named.length > 0 ? named : here;
+        };
+        const direct = pick(target);
+        if (direct.length > 0)
+            return direct;
+        return (graph?.[target] ?? []).flatMap(pick);
+    };
+    // Arrays that some route loads lazily are walked from there, with their prefix.
+    const lazy = new Set();
+    for (const list of arrays.values()) {
+        for (const entry of list) {
+            walk(entry.node, (node) => {
+                if (!ts.isObjectLiteralExpression(node))
+                    return;
+                const loader = propertyValue(node, "loadChildren");
+                if (loader)
+                    for (const target of lazyTargets(entry.module, loader))
+                        lazy.add(target.node);
+            });
+        }
+    }
+    const entries = [];
+    const stack = new Set();
+    const locate = (module, component, loader) => {
+        const specifier = loader
+            ? importCallSpecifier(loader)
+            : component && ts.isIdentifier(unwrapExpression(component))
+                ? module.imports.get(unwrapExpression(component).text)?.specifier
+                : undefined;
+        return (specifier ? index.resolveSpecifier(module.path, specifier) : undefined) ?? module.path;
+    };
+    const walkArray = (module, array, base) => {
+        if (stack.has(array))
+            return;
+        stack.add(array);
+        for (const element of array.elements) {
+            const item = unwrapExpression(element);
+            if (!ts.isObjectLiteralExpression(item))
+                continue;
+            const path = index.stringOf(propertyValue(item, "path"), module);
+            if (path === undefined)
+                continue;
+            const full = path === "" ? base : joinRoutePaths(base, path);
+            const component = propertyValue(item, "component");
+            const loadComponent = propertyValue(item, "loadComponent");
+            const children = propertyValue(item, "children");
+            const loadChildren = propertyValue(item, "loadChildren");
+            const hasChildren = Boolean(children || loadChildren);
+            if (component || loadComponent) {
+                entries.push({
+                    path: full,
+                    file: locate(module, component, loadComponent),
+                    isIndex: path === "" && !hasChildren,
+                    isLayout: hasChildren
+                });
+            }
+            if (children && ts.isArrayLiteralExpression(unwrapExpression(children))) {
+                walkArray(module, unwrapExpression(children), full);
+            }
+            if (loadChildren) {
+                for (const target of lazyTargets(module, loadChildren))
+                    walkArray(target.module, target.node, full);
+            }
+        }
+        stack.delete(array);
+    };
+    for (const list of arrays.values()) {
+        for (const entry of list) {
+            if (!lazy.has(entry.node))
+                walkArray(entry.module, entry.node, "/");
+        }
+    }
+    const unique = new Map();
+    for (const entry of dropShadowedLayouts(entries))
+        unique.set(`${entry.path}\0${entry.file}`, entry);
+    return sortRoutes([...unique.values()].map((entry) => ({ path: entry.path, file: entry.file, kind: "page" })));
+}
+function propertyValue(node, key) {
+    for (const property of node.properties) {
+        if (ts.isPropertyAssignment(property) && propertyKeyName(property.name) === key) {
+            return unwrapExpression(property.initializer);
+        }
+    }
+    return undefined;
+}
+/** An array holding at least one `{ path: "...", <route key> }` object. */
+function looksLikeRoutes(array) {
+    return array.elements.some((element) => {
+        const item = unwrapExpression(element);
+        if (!ts.isObjectLiteralExpression(item) || propertyValue(item, "path") === undefined)
+            return false;
+        return item.properties.some((property) => (ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property))
+            && HINT_KEYS.has(propertyKeyName(property.name) ?? ""));
+    });
+}
+function isChildrenOfRoute(array) {
+    const parent = array.parent;
+    return ts.isPropertyAssignment(parent) && propertyKeyName(parent.name) === "children";
+}
+/** `export const ADMIN_ROUTES: Routes = [...]` */
+function declaredName(array) {
+    let parent = array.parent;
+    while (ts.isAsExpression(parent) || ts.isSatisfiesExpression(parent) || ts.isParenthesizedExpression(parent))
+        parent = parent.parent;
+    return ts.isVariableDeclaration(parent) && ts.isIdentifier(parent.name) ? parent.name.text : undefined;
+}
+/** `() => import("./x").then((m) => m.ADMIN_ROUTES)` → `ADMIN_ROUTES`. */
+function memberName(loader) {
+    let found;
+    walk(loader, (node) => {
+        if (found || !ts.isArrowFunction(node) || node.parameters.length !== 1)
+            return;
+        const parameter = node.parameters[0].name;
+        const body = unwrapExpression(node.body);
+        if (ts.isIdentifier(parameter)
+            && ts.isPropertyAccessExpression(body)
+            && ts.isIdentifier(body.expression)
+            && body.expression.text === parameter.text) {
+            found = body.name.text;
+        }
+    });
+    return found;
+}
+//# sourceMappingURL=angularRouteDetector.js.map

package/dist/analyzers/detectors/angularRouteDetector.js.map

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

package/dist/analyzers/detectors/astUtils.d.ts

@@ -0,0 +1,31 @@
+import { ts } from "ts-morph";
+/** Parse one source file without building a ts-morph Project. */
+export declare function parseSource(path: string, content: string): ts.SourceFile;
+/** The text of a plain string or an interpolation-free template literal. */
+export declare function stringValue(node: ts.Node | undefined): string | undefined;
+/** Strip `( )`, `as T`, `satisfies T`, `x!` and `await` wrappers. */
+export declare function unwrapExpression(node: ts.Expression): ts.Expression;
+export declare function walk(node: ts.Node, visit: (node: ts.Node) => void): void;
+/** Name of a property key written as an identifier or a string. */
+export declare function propertyKeyName(name: ts.PropertyName): string | undefined;
+/** `() => import("./x")` or `import("./x")`: the specifier of the first dynamic import inside. */
+export declare function importCallSpecifier(expression: ts.Node): string | undefined;
+export type ChainCall = {
+    name: string;
+    args: readonly ts.Expression[];
+    node: ts.CallExpression;
+};
+/**
+ * Unwind `root.a(x).b(y)` into the root expression and the calls in source
+ * order. A call whose callee is not `something.name` ends the chain, and the
+ * expression holding it is the root.
+ */
+export declare function unwindChain(expression: ts.Expression): {
+    root: ts.Expression;
+    calls: ChainCall[];
+};
+/** The outermost call of a chain: the parent is not another call on its result. */
+export declare function isChainTop(node: ts.CallExpression): boolean;
+/** A route path written as a plain string. */
+export declare function pathArgument(node: ts.Expression | undefined): string | undefined;
+//# sourceMappingURL=astUtils.d.ts.map

package/dist/analyzers/detectors/astUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astUtils.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/astUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAE9B,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,CASxE;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKzE;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU,CAgBnE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,GAAG,IAAI,CAGxE;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,GAAG,MAAM,GAAG,SAAS,CAKzE;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM,GAAG,SAAS,CAY3E;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,CAAC;IAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAA;CAAE,CAAC;AAElG;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG;IAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,CAUlG;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,GAAG,OAAO,CAQ3D;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEhF"}

package/dist/analyzers/detectors/astUtils.js

@@ -0,0 +1,85 @@
+import { ts } from "ts-morph";
+/** Parse one source file without building a ts-morph Project. */
+export function parseSource(path, content) {
+    const kind = /\.tsx$/.test(path)
+        ? ts.ScriptKind.TSX
+        : /\.jsx$/.test(path)
+            ? ts.ScriptKind.JSX
+            : /\.[cm]?js$/.test(path)
+                ? ts.ScriptKind.JS
+                : ts.ScriptKind.TS;
+    return ts.createSourceFile(path, content, ts.ScriptTarget.Latest, true, kind);
+}
+/** The text of a plain string or an interpolation-free template literal. */
+export function stringValue(node) {
+    if (node && (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node))) {
+        return node.text;
+    }
+    return undefined;
+}
+/** Strip `( )`, `as T`, `satisfies T`, `x!` and `await` wrappers. */
+export function unwrapExpression(node) {
+    let current = node;
+    for (;;) {
+        if (ts.isParenthesizedExpression(current)
+            || ts.isAsExpression(current)
+            || ts.isSatisfiesExpression(current)
+            || ts.isNonNullExpression(current)
+            || ts.isAwaitExpression(current)
+            || ts.isTypeAssertionExpression(current)) {
+            current = current.expression;
+            continue;
+        }
+        return current;
+    }
+}
+export function walk(node, visit) {
+    visit(node);
+    ts.forEachChild(node, (child) => walk(child, visit));
+}
+/** Name of a property key written as an identifier or a string. */
+export function propertyKeyName(name) {
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNoSubstitutionTemplateLiteral(name)) {
+        return name.text;
+    }
+    return undefined;
+}
+/** `() => import("./x")` or `import("./x")`: the specifier of the first dynamic import inside. */
+export function importCallSpecifier(expression) {
+    let found;
+    walk(expression, (node) => {
+        if (found === undefined
+            && ts.isCallExpression(node)
+            && node.expression.kind === ts.SyntaxKind.ImportKeyword) {
+            found = stringValue(node.arguments[0]);
+        }
+    });
+    return found;
+}
+/**
+ * Unwind `root.a(x).b(y)` into the root expression and the calls in source
+ * order. A call whose callee is not `something.name` ends the chain, and the
+ * expression holding it is the root.
+ */
+export function unwindChain(expression) {
+    const calls = [];
+    let current = unwrapExpression(expression);
+    while (ts.isCallExpression(current) && ts.isPropertyAccessExpression(current.expression)) {
+        calls.push({ name: current.expression.name.text, args: current.arguments, node: current });
+        current = unwrapExpression(current.expression.expression);
+    }
+    return { root: current, calls: calls.reverse() };
+}
+/** The outermost call of a chain: the parent is not another call on its result. */
+export function isChainTop(node) {
+    const parent = node.parent;
+    return !(ts.isPropertyAccessExpression(parent)
+        && parent.expression === node
+        && ts.isCallExpression(parent.parent)
+        && parent.parent.expression === parent);
+}
+/** A route path written as a plain string. */
+export function pathArgument(node) {
+    return node ? stringValue(unwrapExpression(node)) : undefined;
+}
+//# sourceMappingURL=astUtils.js.map

package/dist/analyzers/detectors/astUtils.js.map

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

package/dist/analyzers/detectors/clientRouteDetector.d.ts

@@ -0,0 +1,4 @@
+import type { ScannedFile } from "../analysis/index.js";
+import type { RouteInfo } from "./routeDetector.js";
+export declare function detectClientRoutes(files: ScannedFile[], graph?: Record<string, string[]>): RouteInfo[];
+//# sourceMappingURL=clientRouteDetector.d.ts.map