next-route-graph 1.0.2 → 1.2.0

package/dist/render/index.d.ts

@@ -0,0 +1,20 @@
+import { OutputFormat } from "../types/index.js";
+import { DotRenderer, renderDot } from "./dot.js";
+import { FlatRenderer, renderFlat } from "./flat.js";
+import { HtmlRenderer, renderHtml } from "./html.js";
+import { JsonRenderer, renderJson } from "./json.js";
+import { MarkdownRenderer, renderMarkdown } from "./markdown.js";
+import { MermaidRenderer, renderMermaid } from "./mermaid.js";
+import type { OutputRenderer } from "./renderer.interface.js";
+import { renderTree, TreeRenderer } from "./tree.js";
+import { renderSvg, SvgRenderer } from "./svg.js";
+export { DotRenderer, FlatRenderer, HtmlRenderer, JsonRenderer, MarkdownRenderer, MermaidRenderer, renderDot, renderFlat, renderHtml, renderJson, renderMarkdown, renderMermaid, renderTree, TreeRenderer, renderSvg, SvgRenderer, };
+export type { OutputRenderer };
+/**
+ * Factory function to retrieve an OutputRenderer instance by format name (Strategy Pattern).
+ *
+ * @param format - Output format name (tree, flat, json, mermaid, dot, markdown, html, svg)
+ * @returns Configured OutputRenderer implementation
+ */
+export declare function getRenderer(format: OutputFormat): OutputRenderer;
+//# sourceMappingURL=index.d.ts.map

package/dist/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,CAAC;AAEF,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAqBhE"}

package/dist/render/index.js

@@ -0,0 +1,37 @@
+import { DotRenderer, renderDot } from "./dot.js";
+import { FlatRenderer, renderFlat } from "./flat.js";
+import { HtmlRenderer, renderHtml } from "./html.js";
+import { JsonRenderer, renderJson } from "./json.js";
+import { MarkdownRenderer, renderMarkdown } from "./markdown.js";
+import { MermaidRenderer, renderMermaid } from "./mermaid.js";
+import { renderTree, TreeRenderer } from "./tree.js";
+import { renderSvg, SvgRenderer } from "./svg.js";
+export { DotRenderer, FlatRenderer, HtmlRenderer, JsonRenderer, MarkdownRenderer, MermaidRenderer, renderDot, renderFlat, renderHtml, renderJson, renderMarkdown, renderMermaid, renderTree, TreeRenderer, renderSvg, SvgRenderer, };
+/**
+ * Factory function to retrieve an OutputRenderer instance by format name (Strategy Pattern).
+ *
+ * @param format - Output format name (tree, flat, json, mermaid, dot, markdown, html, svg)
+ * @returns Configured OutputRenderer implementation
+ */
+export function getRenderer(format) {
+    switch (format) {
+        case "flat":
+            return new FlatRenderer();
+        case "json":
+            return new JsonRenderer();
+        case "mermaid":
+            return new MermaidRenderer();
+        case "dot":
+            return new DotRenderer();
+        case "markdown":
+            return new MarkdownRenderer();
+        case "html":
+            return new HtmlRenderer();
+        case "svg":
+            return new SvgRenderer();
+        case "tree":
+            return new TreeRenderer();
+        default:
+            throw new Error(`Unsupported output format: ${String(format)}`);
+    }
+}

package/dist/render/json.d.ts

@@ -0,0 +1,13 @@
+import { AnalysisResult } from "../types/index.js";
+import type { OutputRenderer } from "./renderer.interface.js";
+/**
+ * Formats analysis result as structured, indented JSON.
+ *
+ * @param result - AnalysisResult object
+ * @returns Serialized JSON string
+ */
+export declare function renderJson(result: AnalysisResult): string;
+export declare class JsonRenderer implements OutputRenderer {
+    render(result: AnalysisResult): string;
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/render/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/render/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEzD;AAED,qBAAa,YAAa,YAAW,cAAc;IACjD,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAGvC"}

package/dist/render/json.js

@@ -1,16 +1,14 @@
+/**
+ * Formats analysis result as structured, indented JSON.
+ *
+ * @param result - AnalysisResult object
+ * @returns Serialized JSON string
+ */
 export function renderJson(result) {
-    const output = {
-        project: result.project,
-        router: "app",
-        root: result.root,
-        routes: result.routes.map((r) => ({
-            path: r.path,
-            type: r.type,
-            file: r.file,
-            segmentType: r.segmentType,
-            rendering: r.rendering,
-        })),
-        summary: result.summary,
-    };
-    return JSON.stringify(output, null, 2);
+    return JSON.stringify(result, null, 2);
+}
+export class JsonRenderer {
+    render(result) {
+        return renderJson(result);
+    }
 }

package/dist/render/markdown.d.ts

@@ -0,0 +1,13 @@
+import { AnalysisResult } from "../types/index.js";
+import type { OutputRenderer } from "./renderer.interface.js";
+/**
+ * Formats the route analysis result as a GitHub-flavored Markdown document with a table.
+ *
+ * @param result - AnalysisResult
+ * @returns Formatted Markdown string
+ */
+export declare function renderMarkdown(result: AnalysisResult): string;
+export declare class MarkdownRenderer implements OutputRenderer {
+    render(result: AnalysisResult): string;
+}
+//# sourceMappingURL=markdown.d.ts.map

package/dist/render/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/render/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAS9D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAyD7D;AAED,qBAAa,gBAAiB,YAAW,cAAc;IACrD,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAGvC"}

package/dist/render/markdown.js

@@ -0,0 +1,59 @@
+/**
+ * Escapes pipe characters so Markdown table cells do not break table layout.
+ */
+function escapeCell(val) {
+    return val.replace(/\|/g, "\\|");
+}
+/**
+ * Formats the route analysis result as a GitHub-flavored Markdown document with a table.
+ *
+ * @param result - AnalysisResult
+ * @returns Formatted Markdown string
+ */
+export function renderMarkdown(result) {
+    const lines = [];
+    lines.push(`### Next.js Route Graph: \`${result.project}\``);
+    lines.push("");
+    lines.push(`- **Router:** ${result.router}`);
+    lines.push(`- **Root:** \`${result.root}\``);
+    lines.push(`- **Total Routes:** ${result.summary.routes}`);
+    lines.push(`- **Breakdown:** ${result.summary.server} Server, ${result.summary.client} Client, ${result.summary.dynamic} Dynamic`);
+    lines.push("");
+    lines.push("| Route Path | Type | Segment | Rendering | Methods / Details | File |");
+    lines.push("| :--- | :--- | :--- | :--- | :--- | :--- |");
+    for (const route of result.routes) {
+        const methods = route.methods && route.methods.length > 0
+            ? `\`${escapeCell(route.methods.join(", "))}\``
+            : "-";
+        const segment = `\`${escapeCell(route.segmentType)}\``;
+        const rendering = route.rendering === "client" ? "**Client**" : "Server";
+        const file = `\`${escapeCell(route.file)}\``;
+        lines.push(`| \`${escapeCell(route.path)}\` | ${route.type} | ${segment} | ${rendering} | ${methods} | ${file} |`);
+    }
+    if (result.routes.length === 0) {
+        lines.push("| *(No routes discovered)* | - | - | - | - | - |");
+    }
+    if (result.lint && result.lint.issues.length > 0) {
+        lines.push("");
+        lines.push("#### Route Health Warnings & Issues");
+        lines.push("");
+        lines.push("| Severity | Rule | Message | File / Location |");
+        lines.push("| :--- | :--- | :--- | :--- |");
+        for (const issue of result.lint.issues) {
+            const badge = issue.severity === "error"
+                ? "🛑 Error"
+                : issue.severity === "warning"
+                    ? "⚠️ Warning"
+                    : "ℹ️ Info";
+            const loc = issue.filePath ? `\`${escapeCell(issue.filePath)}\`` : "-";
+            lines.push(`| ${badge} | \`${escapeCell(issue.rule)}\` | ${escapeCell(issue.message.replace(/\n/g, " "))} | ${loc} |`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+export class MarkdownRenderer {
+    render(result) {
+        return renderMarkdown(result);
+    }
+}

package/dist/render/mermaid.d.ts

@@ -0,0 +1,13 @@
+import { AnalysisResult } from "../types/index.js";
+import type { OutputRenderer } from "./renderer.interface.js";
+/**
+ * Generates a Mermaid flowchart diagram representing the App Router routes.
+ *
+ * @param result - AnalysisResult
+ * @returns Mermaid flowchart markdown block
+ */
+export declare function renderMermaid(result: AnalysisResult): string;
+export declare class MermaidRenderer implements OutputRenderer {
+    render(result: AnalysisResult): string;
+}
+//# sourceMappingURL=mermaid.d.ts.map

package/dist/render/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../src/render/mermaid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAgC9D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA+B5D;AAED,qBAAa,eAAgB,YAAW,cAAc;IACpD,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAGvC"}

package/dist/render/mermaid.js

@@ -0,0 +1,64 @@
+import { buildRouteGraph } from "./graph.js";
+/**
+ * Creates a clean Mermaid node label for a route.
+ * Replaces square brackets with HTML character entities to avoid breaking Mermaid node shape syntax.
+ */
+function createNodeLabel(route) {
+    const parts = [route.path];
+    if (route.methods && route.methods.length > 0) {
+        parts.push(`(${route.methods.join("/")})`);
+    }
+    else if (route.rendering === "client") {
+        parts.push("(client)");
+    }
+    else if (route.segmentType !== "static") {
+        parts.push(`(${route.segmentType})`);
+    }
+    // Escape square brackets and quotation marks for safe Mermaid rendering
+    return parts
+        .join(" ")
+        .replace(/&/g, "#38;")
+        .replace(/</g, "#60;")
+        .replace(/>/g, "#62;")
+        .replace(/\r?\n/g, " ")
+        .replace(/\[/g, "#91;")
+        .replace(/\]/g, "#93;")
+        .replace(/"/g, "#quot;");
+}
+/**
+ * Generates a Mermaid flowchart diagram representing the App Router routes.
+ *
+ * @param result - AnalysisResult
+ * @returns Mermaid flowchart markdown block
+ */
+export function renderMermaid(result) {
+    const lines = [];
+    lines.push("```mermaid");
+    lines.push("flowchart TD");
+    lines.push(`  %% Next.js Route Graph for ${result.project.replace(/[\r\n]/g, " ")}`);
+    const routes = result.routes;
+    if (routes.length === 0) {
+        lines.push('  empty["(No routes discovered)"]');
+        lines.push("```");
+        return lines.join("\n");
+    }
+    for (const node of buildRouteGraph(routes)) {
+        const label = node.routes.length
+            ? node.routes.map(createNodeLabel).join(" | ")
+            : createNodeLabel({
+                path: node.path,
+                rendering: "server",
+                segmentType: "static",
+            });
+        lines.push(`  ${node.id}["${label}"]`);
+        if (node.parentId)
+            lines.push(`  ${node.parentId} --> ${node.id}`);
+    }
+    lines.push("```");
+    return lines.join("\n");
+}
+export class MermaidRenderer {
+    render(result) {
+        return renderMermaid(result);
+    }
+}

package/dist/render/renderer.interface.d.ts

@@ -0,0 +1,8 @@
+import { AnalysisResult } from "../types/index.js";
+/**
+ * Common interface for all output formatters (Strategy Pattern)
+ */
+export interface OutputRenderer {
+    render(result: AnalysisResult): string;
+}
+//# sourceMappingURL=renderer.interface.d.ts.map

package/dist/render/renderer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.interface.d.ts","sourceRoot":"","sources":["../../src/render/renderer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC;CACxC"}

package/dist/render/renderer.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/render/svg.d.ts

@@ -0,0 +1,8 @@
+import type { AnalysisResult } from "../types/index.js";
+import type { OutputRenderer } from "./renderer.interface.js";
+/** A real, offline vector diagram suitable for reports, READMEs, and design tools. */
+export declare function renderSvg(result: AnalysisResult): string;
+export declare class SvgRenderer implements OutputRenderer {
+    render(result: AnalysisResult): string;
+}
+//# sourceMappingURL=svg.d.ts.map

package/dist/render/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAgFxD;AAED,qBAAa,WAAY,YAAW,cAAc;IAChD,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAGvC"}

package/dist/render/svg.js

@@ -0,0 +1,76 @@
+import { buildRouteGraph, escapeMarkup } from "./graph.js";
+/** A real, offline vector diagram suitable for reports, READMEs, and design tools. */
+export function renderSvg(result) {
+    const nodes = buildRouteGraph(result.routes);
+    const rowHeight = 70;
+    const width = Math.max(760, ...nodes.map((node) => 340 + node.depth * 28 + Array.from(node.path).length * 9));
+    const height = Math.max(180, 110 + nodes.length * rowHeight);
+    const rows = new Map(nodes.map((node, index) => [node.id, index]));
+    const edges = nodes
+        .filter((node) => node.parentId)
+        .map((node) => {
+        const parentRow = rows.get(node.parentId);
+        const row = rows.get(node.id);
+        const x = 30 + (node.depth - 1) * 28;
+        return `<path d="M${x},${100 + parentRow * rowHeight} V${100 + row * rowHeight} H${x + 28}" fill="none" stroke="#475569"/>`;
+    })
+        .join("\n");
+    const cards = nodes
+        .map((node, index) => {
+        const x = 18 + node.depth * 28;
+        const y = 76 + index * rowHeight;
+        const route = node.routes[0];
+        const color = !route
+            ? "#64748b"
+            : route.type === "route"
+                ? "#d8b4fe"
+                : route.rendering === "client"
+                    ? "#67e8f9"
+                    : "#a5b4fc";
+        const description = node.routes.length === 0
+            ? "segment · no endpoint"
+            : node.routes
+                .map((route) => [
+                route.type === "route"
+                    ? `API ${(route.methods ?? []).join(" / ")}`
+                    : `${route.rendering} page`,
+                route.segmentType !== "static" ? route.segmentType : "",
+                ...(route.parallelSlots ?? []),
+                route.intercepting ? "intercepted" : "",
+            ]
+                .filter(Boolean)
+                .join(" · "))
+                .join(" | ");
+        const title = [
+            node.path,
+            ...node.routes.map((route) => `${route.file}${route.layoutChain?.length ? ` — layouts: ${route.layoutChain.join(" → ")}` : ""}`),
+        ].join("\n");
+        const maxDescription = Math.floor((width - x - 50) / 7);
+        const shortDescription = description.length > maxDescription
+            ? description.slice(0, maxDescription - 1) + "…"
+            : description;
+        return `<g data-node-index="${index}" tabindex="0" role="button" aria-label="${escapeMarkup(title)}">
+      <title>${escapeMarkup(title)}</title>
+      <rect x="${x}" y="${y}" width="${width - x - 18}" height="54" rx="8" fill="#172033" stroke="#334155"/>
+      <rect x="${x}" y="${y + 8}" width="3" height="38" rx="1" fill="${color}"/>
+      <text x="${x + 14}" y="${y + 22}" fill="${color}" font-size="14">${escapeMarkup(node.path)}</text>
+      <text x="${x + 14}" y="${y + 41}" fill="#cbd5e1" font-size="11">${escapeMarkup(shortDescription)}</text>
+    </g>`;
+    })
+        .join("\n");
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}" width="${width}" height="${height}" role="img" aria-labelledby="graph-title graph-description">
+  <title id="graph-title">${escapeMarkup(result.project)} — route map</title>
+  <desc id="graph-description">URL segment hierarchy. Source files, slots, and intercepted variants are preserved. This shows route structure, not imports or navigation.</desc>
+  <style>text{font-family:ui-monospace,Consolas,monospace}g:focus rect:first-of-type,g:hover rect:first-of-type{stroke:#67e8f9;stroke-width:2}g{cursor:pointer;outline:none}</style>
+  <rect width="100%" height="100%" rx="12" fill="#0b1020"/>
+  <text x="22" y="32" fill="#f1f5f9" font-size="17">${escapeMarkup(result.project)} / route map</text>
+  <text x="22" y="54" fill="#94a3b8" font-size="12">${result.routes.length} endpoints · ${escapeMarkup(result.root)} · URL hierarchy</text>
+  ${edges}
+  ${cards || '<text x="22" y="106" fill="#94a3b8" font-size="14">No routes discovered</text>'}
+</svg>`;
+}
+export class SvgRenderer {
+    render(result) {
+        return renderSvg(result);
+    }
+}

package/dist/render/tree.d.ts

@@ -0,0 +1,13 @@
+import { AnalysisResult } from "../types/index.js";
+import type { OutputRenderer } from "./renderer.interface.js";
+/**
+ * Formats the route graph and project summary as a styled terminal tree.
+ *
+ * @param result - Analysis result data
+ * @returns Styled terminal string representation
+ */
+export declare function renderTree(result: AnalysisResult): string;
+export declare class TreeRenderer implements OutputRenderer {
+    render(result: AnalysisResult): string;
+}
+//# sourceMappingURL=tree.d.ts.map

package/dist/render/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/render/tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA2GzD;AAED,qBAAa,YAAa,YAAW,cAAc;IACjD,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CAGvC"}

package/dist/render/tree.js

@@ -1,4 +1,10 @@
 import pc from "picocolors";
+/**
+ * Formats the route graph and project summary as a styled terminal tree.
+ *
+ * @param result - Analysis result data
+ * @returns Styled terminal string representation
+ */
 export function renderTree(result) {
     const lines = [];
     lines.push("");
@@ -11,21 +17,34 @@ export function renderTree(result) {
     lines.push(pc.bold("Routes"));
     lines.push(pc.dim("────────────────────────────────────────"));
     const routes = result.routes;
+    const maxPathLen = Math.max(28, ...routes.map((r) => r.path.length));
     routes.forEach((route, index) => {
         const isLast = index === routes.length - 1;
         const prefix = isLast ? "└── " : "├── ";
-        const pathStr = route.path.padEnd(28, " ");
+        const pathStr = route.path.padEnd(maxPathLen, " ");
         const fileStr = pc.dim(route.file.split("/").pop() || "");
-        let badge = "";
+        const badges = [];
+        // HTTP Methods for API handlers
+        if (route.methods && route.methods.length > 0) {
+            badges.push(pc.magenta(`[${route.methods.join(", ")}]`));
+        }
+        // Rendering or Segment Type
         if (route.rendering === "client") {
-            const clientBadge = pc.cyan("[client]");
-            badge = `  ${clientBadge}`;
+            badges.push(pc.cyan("[client]"));
         }
         else if (route.segmentType !== "static") {
-            const segmentBadge = `[${route.segmentType}]`;
-            badge = `  ${pc.yellow(segmentBadge)}`;
+            badges.push(pc.yellow(`[${route.segmentType}]`));
+        }
+        // Parallel route slots
+        if (route.parallelSlots && route.parallelSlots.length > 0) {
+            badges.push(pc.blue(`[${route.parallelSlots.join(", ")}]`));
+        }
+        // Intercepting route indicator
+        if (route.intercepting) {
+            badges.push(pc.magenta(`[${route.intercepting}]`));
         }
-        const routeLine = `${pc.dim(prefix)}${pc.bold(pathStr)} ${fileStr}${badge}`;
+        const badgeStr = badges.length > 0 ? `  ${badges.join(" ")}` : "";
+        const routeLine = `${pc.dim(prefix)}${pc.bold(pathStr)} ${fileStr}${badgeStr}`;
         lines.push(routeLine);
     });
     if (routes.length === 0) {
@@ -41,8 +60,39 @@ export function renderTree(result) {
     lines.push(`${pc.dim("Layouts      ")}${result.summary.layouts}`);
     lines.push(`${pc.dim("Loading      ")}${result.summary.loading}`);
     lines.push(`${pc.dim("Errors       ")}${result.summary.errors}`);
+    if (result.summary.apiRoutes && result.summary.apiRoutes > 0) {
+        lines.push(`${pc.dim("API Routes   ")}${result.summary.apiRoutes}`);
+    }
+    if (result.summary.parallelRoutes && result.summary.parallelRoutes > 0) {
+        lines.push(`${pc.dim("Parallel     ")}${result.summary.parallelRoutes}`);
+    }
+    if (result.summary.interceptedRoutes && result.summary.interceptedRoutes > 0) {
+        lines.push(`${pc.dim("Intercepted  ")}${result.summary.interceptedRoutes}`);
+    }
+    // Display lint issues if present
+    if (result.lint && result.lint.issues.length > 0) {
+        lines.push("");
+        lines.push(pc.bold("Route Health"));
+        lines.push(pc.dim("────────────────────────────────────────"));
+        for (const issue of result.lint.issues) {
+            const tag = issue.severity === "error"
+                ? pc.red("✖ [error]")
+                : issue.severity === "warning"
+                    ? pc.yellow("▲ [warning]")
+                    : pc.blue("ℹ [info]");
+            lines.push(`${tag} ${pc.bold(issue.rule)}: ${issue.message}`);
+            if (issue.hint) {
+                lines.push(`  ${pc.dim("hint: " + issue.hint)}`);
+            }
+        }
+    }
     lines.push("");
     lines.push(pc.green(`✓ Analysis completed in ${result.executionTimeMs}ms`));
     lines.push("");
     return lines.join("\n");
 }
+export class TreeRenderer {
+    render(result) {
+        return renderTree(result);
+    }
+}

package/dist/types/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Supported Next.js segment dynamics
+ */
+export type SegmentType = "static" | "dynamic" | "catch-all" | "optional-catch-all";
+/**
+ * Next.js App Router special convention files
+ */
+export type SpecialFileType = "page" | "layout" | "loading" | "error" | "global-error" | "not-found" | "template" | "default" | "route";
+/**
+ * React rendering environment
+ */
+export type RenderingType = "client" | "server";
+/**
+ * Standard HTTP methods supported in route handlers
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+/**
+ * Discovered file in the App Router tree
+ */
+export interface DiscoveredFile {
+    relativePath: string;
+    fullPath: string;
+    fileName: string;
+    extension: string;
+}
+/**
+ * App Router convention file entry
+ */
+export interface RouteFile {
+    type: SpecialFileType;
+    fileName: string;
+    relativePath: string;
+    rendering: RenderingType;
+    methods?: HttpMethod[];
+    hasServerActions?: boolean;
+    runtime?: "nodejs" | "edge" | string;
+    dynamicConfig?: "auto" | "force-dynamic" | "error" | "force-static" | string;
+}
+/**
+ * Represents a resolved Next.js route endpoint (page or route handler)
+ */
+export interface RouteEntry {
+    path: string;
+    type: "page" | "route";
+    file: string;
+    segmentType: SegmentType;
+    rendering: RenderingType;
+    methods?: HttpMethod[];
+    hasServerActions?: boolean;
+    runtime?: "nodejs" | "edge" | string;
+    dynamicConfig?: "auto" | "force-dynamic" | "error" | "force-static" | string;
+    files: RouteFile[];
+    parallelSlots?: string[];
+    intercepting?: string;
+    layoutChain?: string[];
+}
+/**
+ * Lint severity level
+ */
+export type LintSeverity = "error" | "warning" | "info";
+/**
+ * Lint issue discovered during route inspection
+ */
+export interface LintIssue {
+    rule: string;
+    severity: LintSeverity;
+    message: string;
+    routePath?: string;
+    filePath?: string;
+    hint?: string;
+}
+/**
+ * Lint summary report
+ */
+export interface LintResult {
+    issues: LintIssue[];
+    hasErrors: boolean;
+    warningCount: number;
+    errorCount: number;
+    infoCount?: number;
+}
+/**
+ * Summary statistics for the scanned project
+ */
+export interface SummaryStats {
+    routes: number;
+    dynamic: number;
+    client: number;
+    server: number;
+    layouts: number;
+    loading: number;
+    errors: number;
+    apiRoutes?: number;
+    parallelRoutes?: number;
+    interceptedRoutes?: number;
+}
+/**
+ * Overall analysis output
+ */
+export interface AnalysisResult {
+    project: string;
+    router: "App Router";
+    root: string;
+    routes: RouteEntry[];
+    summary: SummaryStats;
+    executionTimeMs: number;
+    lint?: LintResult;
+}
+/**
+ * Output format types
+ */
+export type OutputFormat = "tree" | "flat" | "json" | "mermaid" | "dot" | "markdown" | "html" | "svg";
+/**
+ * CLI command line options
+ */
+export interface CLIOptions {
+    flat?: boolean;
+    json?: boolean;
+    mermaid?: boolean;
+    dot?: boolean;
+    markdown?: boolean;
+    svg?: boolean;
+    output?: string;
+    html?: boolean | string;
+    serve?: boolean | number | string;
+    format?: OutputFormat;
+    search?: string;
+    check?: boolean;
+    strict?: boolean;
+    methods?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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