roto-rooter 0.0.1

package/README.md

@@ -0,0 +1,52 @@
+# react-router-analyzer
+
+Static analysis tool for React Router 7 applications that catches runtime errors at build time.
+
+## Installation
+
+```bash
+npm install react-router-analyzer
+```
+
+## Usage
+
+```bash
+# Check all files
+npx react-router-analyzer
+
+# Check specific file(s)
+npx react-router-analyzer app/routes/employees.tsx
+
+# Run specific checks only
+npx react-router-analyzer --check links,forms
+
+# Output as JSON
+npx react-router-analyzer --format json
+
+# Set root directory
+npx react-router-analyzer --root ./my-app
+```
+
+## Checks
+
+- **links**: Validates Link, redirect(), and navigate() targets exist as defined routes
+- **forms**: Validates forms submit to routes with action exports
+- **loader**: Validates useLoaderData() is only used in routes with loaders
+- **params**: Validates useParams() accesses only params defined in the route
+- **interactive**: Validates interactive elements have handlers (coming soon)
+- **a11y**: Accessibility checks requiring cross-element analysis (coming soon)
+
+## Programmatic API
+
+```typescript
+import { analyze } from "react-router-analyzer";
+
+const result = analyze({
+  root: "./my-app",
+  files: [],       // empty = all files
+  checks: [],      // empty = all checks
+  format: "text",
+});
+
+console.log(result.issues);
+```

package/dist/analyzer.d.ts

@@ -0,0 +1,6 @@
+import type { AnalyzerResult, CliOptions } from "./types.js";
+/**
+ * Main analyzer - orchestrates parsing and checking
+ */
+export declare function analyze(options: CliOptions): AnalyzerResult;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAId,UAAU,EACX,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAqF3D"}

package/dist/analyzer.js

@@ -0,0 +1,121 @@
+import * as fs from "fs";
+import * as path from "path";
+import { parseRoutes } from "./parsers/route-parser.js";
+import { parseComponent } from "./parsers/component-parser.js";
+import { checkLinks } from "./checks/link-check.js";
+import { checkForms } from "./checks/form-check.js";
+import { checkLoaders } from "./checks/loader-check.js";
+import { checkParams } from "./checks/params-check.js";
+import { checkInteractive } from "./checks/interactive-check.js";
+import { checkA11y } from "./checks/a11y-check.js";
+/**
+ * Main analyzer - orchestrates parsing and checking
+ */
+export function analyze(options) {
+    const { root, files, checks } = options;
+    // Parse routes (always global)
+    let routes = [];
+    try {
+        routes = parseRoutes(root);
+    }
+    catch (error) {
+        // If no routes file, we can't do much
+        return {
+            issues: [
+                {
+                    category: "links",
+                    severity: "error",
+                    message: error instanceof Error
+                        ? error.message
+                        : "Failed to parse routes file",
+                    location: {
+                        file: path.join(root, "app", "routes.ts"),
+                        line: 1,
+                        column: 1,
+                    },
+                },
+            ],
+            routes: [],
+            components: [],
+        };
+    }
+    // Find component files to analyze
+    const componentFiles = findComponentFiles(root, files);
+    // Parse components
+    const components = [];
+    for (const file of componentFiles) {
+        try {
+            const analysis = parseComponent(file);
+            components.push(analysis);
+        }
+        catch (error) {
+            // Skip files that can't be parsed
+            console.error(`Warning: Could not parse ${file}:`, error);
+        }
+    }
+    // Run checks
+    const issues = [];
+    const enabledChecks = new Set(checks.length > 0 ? checks : ["links", "forms", "loader", "params", "interactive", "a11y"]);
+    if (enabledChecks.has("links")) {
+        issues.push(...checkLinks(components, routes));
+    }
+    if (enabledChecks.has("forms")) {
+        issues.push(...checkForms(components, routes, root));
+    }
+    if (enabledChecks.has("loader")) {
+        issues.push(...checkLoaders(components));
+    }
+    if (enabledChecks.has("params")) {
+        issues.push(...checkParams(components, routes, root));
+    }
+    if (enabledChecks.has("interactive")) {
+        issues.push(...checkInteractive(components));
+    }
+    if (enabledChecks.has("a11y")) {
+        issues.push(...checkA11y(components));
+    }
+    // If specific files were provided, filter issues to only those files
+    if (files.length > 0) {
+        const targetFiles = new Set(files.map((f) => path.resolve(f)));
+        const filteredIssues = issues.filter((issue) => targetFiles.has(path.resolve(issue.location.file)));
+        return { issues: filteredIssues, routes, components };
+    }
+    return { issues, routes, components };
+}
+/**
+ * Find all component files to analyze
+ */
+function findComponentFiles(root, specificFiles) {
+    if (specificFiles.length > 0) {
+        // Analyze only specific files (paths are independent of root)
+        return specificFiles.map((f) => path.resolve(f));
+    }
+    // Find all TSX files in app/routes
+    const routesDir = path.join(root, "app", "routes");
+    if (!fs.existsSync(routesDir)) {
+        return [];
+    }
+    const files = [];
+    walkDir(routesDir, (filePath) => {
+        if (filePath.endsWith(".tsx")) {
+            files.push(filePath);
+        }
+    });
+    return files;
+}
+/**
+ * Recursively walk a directory
+ */
+function walkDir(dir, callback) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkDir(fullPath, callback);
+        }
+        else if (entry.isFile()) {
+            callback(fullPath);
+        }
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/analyzer.js.map

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

package/dist/checks/a11y-check.d.ts

@@ -0,0 +1,6 @@
+import type { AnalyzerIssue, ComponentAnalysis } from "../types.js";
+/**
+ * Check accessibility issues
+ */
+export declare function checkA11y(_components: ComponentAnalysis[]): AnalyzerIssue[];
+//# sourceMappingURL=a11y-check.d.ts.map

package/dist/checks/a11y-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-check.d.ts","sourceRoot":"","sources":["../../src/checks/a11y-check.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,aAAa,EAAE,CAM3E"}

package/dist/checks/a11y-check.js

@@ -0,0 +1,13 @@
+// Placeholder for accessibility checks
+// These require cross-element analysis
+/**
+ * Check accessibility issues
+ */
+export function checkA11y(_components) {
+    // TODO: Implement accessibility checks
+    // - div with onClick but no keyboard handling
+    // - Form inputs without label association
+    // - Images without alt text
+    return [];
+}
+//# sourceMappingURL=a11y-check.js.map

package/dist/checks/a11y-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-check.js","sourceRoot":"","sources":["../../src/checks/a11y-check.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,uCAAuC;AAIvC;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,WAAgC;IACxD,uCAAuC;IACvC,8CAA8C;IAC9C,0CAA0C;IAC1C,4BAA4B;IAC5B,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/checks/form-check.d.ts

@@ -0,0 +1,6 @@
+import type { AnalyzerIssue, ComponentAnalysis, RouteDefinition } from "../types.js";
+/**
+ * Check form-action wiring
+ */
+export declare function checkForms(components: ComponentAnalysis[], routes: RouteDefinition[], rootDir: string): AnalyzerIssue[];
+//# sourceMappingURL=form-check.d.ts.map

package/dist/checks/form-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-check.d.ts","sourceRoot":"","sources":["../../src/checks/form-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EAChB,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CAWjB"}

package/dist/checks/form-check.js

@@ -0,0 +1,74 @@
+import * as path from "path";
+import { matchRoute } from "../parsers/route-parser.js";
+import { parseRouteExports } from "../parsers/action-parser.js";
+/**
+ * Check form-action wiring
+ */
+export function checkForms(components, routes, rootDir) {
+    const issues = [];
+    for (const component of components) {
+        for (const form of component.forms) {
+            const formIssues = validateForm(form, component, routes, rootDir);
+            issues.push(...formIssues);
+        }
+    }
+    return issues;
+}
+/**
+ * Validate a single form
+ */
+function validateForm(form, component, routes, rootDir) {
+    const issues = [];
+    // If form has an explicit action, check that route has an action handler
+    if (form.action) {
+        const targetRoute = matchRoute(form.action, routes);
+        if (!targetRoute) {
+            issues.push({
+                category: "forms",
+                severity: "error",
+                message: `Form action targets non-existent route: ${form.action}`,
+                location: form.location,
+                code: `<Form action="${form.action}">`,
+            });
+        }
+        else {
+            // Check if the target route file has an action export
+            const routeFilePath = path.join(rootDir, "app", targetRoute.file);
+            try {
+                const exports = parseRouteExports(routeFilePath);
+                if (!exports.hasAction) {
+                    issues.push({
+                        category: "forms",
+                        severity: "error",
+                        message: `Form action targets route without action export`,
+                        location: form.location,
+                        code: `<Form action="${form.action}">`,
+                        suggestion: `Add an action export to ${targetRoute.file}`,
+                    });
+                }
+            }
+            catch {
+                // File doesn't exist or can't be parsed - route-parser should catch this
+            }
+        }
+    }
+    else {
+        // Form submits to current route - check if current file has action
+        if (!component.hasAction) {
+            issues.push({
+                category: "forms",
+                severity: "error",
+                message: "Form in route with no action export",
+                location: form.location,
+                code: "<Form>",
+                suggestion: "Add an action export to handle form submission",
+            });
+        }
+    }
+    // Check for inputs without name attribute
+    // Note: We track inputNames, but we should also warn about inputs WITHOUT names
+    // This would require more sophisticated tracking in the component parser
+    // For now, we'll skip this check
+    return issues;
+}
+//# sourceMappingURL=form-check.js.map

package/dist/checks/form-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-check.js","sourceRoot":"","sources":["../../src/checks/form-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAM7B,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,UAA+B,EAC/B,MAAyB,EACzB,OAAe;IAEf,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAClE,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,IAAmC,EACnC,SAA4B,EAC5B,MAAyB,EACzB,OAAe;IAEf,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,yEAAyE;IACzE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEpD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,2CAA2C,IAAI,CAAC,MAAM,EAAE;gBACjE,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,iBAAiB,IAAI,CAAC,MAAM,IAAI;aACvC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,sDAAsD;YACtD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;YAClE,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;gBACjD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBACvB,MAAM,CAAC,IAAI,CAAC;wBACV,QAAQ,EAAE,OAAO;wBACjB,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,iDAAiD;wBAC1D,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,iBAAiB,IAAI,CAAC,MAAM,IAAI;wBACtC,UAAU,EAAE,2BAA2B,WAAW,CAAC,IAAI,EAAE;qBAC1D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,mEAAmE;QACnE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,qCAAqC;gBAC9C,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,gDAAgD;aAC7D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,gFAAgF;IAChF,yEAAyE;IACzE,iCAAiC;IAEjC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/checks/interactive-check.d.ts

@@ -0,0 +1,6 @@
+import type { AnalyzerIssue, ComponentAnalysis } from "../types.js";
+/**
+ * Check interactive element completeness
+ */
+export declare function checkInteractive(_components: ComponentAnalysis[]): AnalyzerIssue[];
+//# sourceMappingURL=interactive-check.d.ts.map

package/dist/checks/interactive-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-check.d.ts","sourceRoot":"","sources":["../../src/checks/interactive-check.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,iBAAiB,EAAE,GAC/B,aAAa,EAAE,CAKjB"}

package/dist/checks/interactive-check.js

@@ -0,0 +1,12 @@
+// Placeholder for interactive element completeness checks
+// This would check for buttons without handlers, etc.
+/**
+ * Check interactive element completeness
+ */
+export function checkInteractive(_components) {
+    // TODO: Implement interactive element checks
+    // - Buttons without onClick, type, or form context
+    // - onClick referencing undefined handlers
+    return [];
+}
+//# sourceMappingURL=interactive-check.js.map

package/dist/checks/interactive-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-check.js","sourceRoot":"","sources":["../../src/checks/interactive-check.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,sDAAsD;AAItD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAgC;IAEhC,6CAA6C;IAC7C,mDAAmD;IACnD,2CAA2C;IAC3C,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/checks/link-check.d.ts

@@ -0,0 +1,6 @@
+import type { AnalyzerIssue, ComponentAnalysis, RouteDefinition } from "../types.js";
+/**
+ * Check all links in components against defined routes
+ */
+export declare function checkLinks(components: ComponentAnalysis[], routes: RouteDefinition[]): AnalyzerIssue[];
+//# sourceMappingURL=link-check.d.ts.map

package/dist/checks/link-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-check.d.ts","sourceRoot":"","sources":["../../src/checks/link-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EAChB,MAAM,aAAa,CAAC;AAQrB;;GAEG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,eAAe,EAAE,GACxB,aAAa,EAAE,CAcjB"}

package/dist/checks/link-check.js

@@ -0,0 +1,56 @@
+import { matchRoute, matchDynamicPattern, getAllRoutePaths, } from "../parsers/route-parser.js";
+import { findBestMatch, formatSuggestion } from "../utils/suggestion.js";
+/**
+ * Check all links in components against defined routes
+ */
+export function checkLinks(components, routes) {
+    const issues = [];
+    const allPaths = getAllRoutePaths(routes);
+    for (const component of components) {
+        for (const link of component.links) {
+            const issue = validateLink(link, routes, allPaths);
+            if (issue) {
+                issues.push(issue);
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * Validate a single link
+ */
+function validateLink(link, routes, allPaths) {
+    if (link.isDynamic) {
+        // For dynamic links, check the pattern
+        const pattern = link.pattern || link.href;
+        const match = matchDynamicPattern(pattern, routes);
+        if (!match) {
+            const suggestion = findBestMatch(pattern, allPaths);
+            return {
+                category: "links",
+                severity: "error",
+                message: "No matching route for dynamic link pattern",
+                location: link.location,
+                code: `${link.type === "link" ? "href" : link.type}="${link.href}"`,
+                suggestion: formatSuggestion(suggestion),
+            };
+        }
+    }
+    else {
+        // For static links, do exact matching
+        const match = matchRoute(link.href, routes);
+        if (!match) {
+            const suggestion = findBestMatch(link.href, allPaths);
+            return {
+                category: "links",
+                severity: "error",
+                message: "No matching route",
+                location: link.location,
+                code: `${link.type === "link" ? "href" : link.type}="${link.href}"`,
+                suggestion: formatSuggestion(suggestion),
+            };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=link-check.js.map

package/dist/checks/link-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-check.js","sourceRoot":"","sources":["../../src/checks/link-check.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,UAA+B,EAC/B,MAAyB;IAEzB,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE1C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACnD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,IAAmC,EACnC,MAAyB,EACzB,QAAkB;IAElB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,uCAAuC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC;QAC1C,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACpD,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,4CAA4C;gBACrD,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG;gBACnE,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;aACzC,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,sCAAsC;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAE5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACtD,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,mBAAmB;gBAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG;gBACnE,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;aACzC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/checks/loader-check.d.ts

@@ -0,0 +1,6 @@
+import type { AnalyzerIssue, ComponentAnalysis } from "../types.js";
+/**
+ * Check loader-component binding
+ */
+export declare function checkLoaders(components: ComponentAnalysis[]): AnalyzerIssue[];
+//# sourceMappingURL=loader-check.d.ts.map

package/dist/checks/loader-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-check.d.ts","sourceRoot":"","sources":["../../src/checks/loader-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,iBAAiB,EAAE,GAC9B,aAAa,EAAE,CASjB"}

package/dist/checks/loader-check.js

@@ -0,0 +1,41 @@
+/**
+ * Check loader-component binding
+ */
+export function checkLoaders(components) {
+    const issues = [];
+    for (const component of components) {
+        const componentIssues = validateLoaderUsage(component);
+        issues.push(...componentIssues);
+    }
+    return issues;
+}
+/**
+ * Validate loader usage in a component
+ */
+function validateLoaderUsage(component) {
+    const issues = [];
+    for (const hook of component.dataHooks) {
+        if (hook.hook === "useLoaderData" && !component.hasLoader) {
+            issues.push({
+                category: "loader",
+                severity: "error",
+                message: "useLoaderData() called but route has no loader",
+                location: hook.location,
+                code: "useLoaderData()",
+                suggestion: "Add a loader function or remove the hook",
+            });
+        }
+        if (hook.hook === "useActionData" && !component.hasAction) {
+            issues.push({
+                category: "loader",
+                severity: "warning",
+                message: "useActionData() called but route has no action",
+                location: hook.location,
+                code: "useActionData()",
+                suggestion: "Add an action function or remove the hook",
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=loader-check.js.map

package/dist/checks/loader-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-check.js","sourceRoot":"","sources":["../../src/checks/loader-check.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA+B;IAE/B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,eAAe,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,SAA4B;IACvD,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,gDAAgD;gBACzD,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,iBAAiB;gBACvB,UAAU,EAAE,0CAA0C;aACvD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,gDAAgD;gBACzD,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,iBAAiB;gBACvB,UAAU,EAAE,2CAA2C;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/checks/params-check.d.ts

@@ -0,0 +1,6 @@
+import type { AnalyzerIssue, ComponentAnalysis, RouteDefinition } from "../types.js";
+/**
+ * Check route parameter consistency
+ */
+export declare function checkParams(components: ComponentAnalysis[], routes: RouteDefinition[], rootDir: string): AnalyzerIssue[];
+//# sourceMappingURL=params-check.d.ts.map

package/dist/checks/params-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params-check.d.ts","sourceRoot":"","sources":["../../src/checks/params-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CA4BjB"}

package/dist/checks/params-check.js

@@ -0,0 +1,56 @@
+import * as path from "path";
+/**
+ * Check route parameter consistency
+ */
+export function checkParams(components, routes, rootDir) {
+    const issues = [];
+    // Build a map of file -> route definition
+    const fileToRoute = new Map();
+    function mapRoutes(routeList) {
+        for (const route of routeList) {
+            const fullPath = path.join(rootDir, "app", route.file);
+            fileToRoute.set(fullPath, route);
+            if (route.children) {
+                mapRoutes(route.children);
+            }
+        }
+    }
+    mapRoutes(routes);
+    for (const component of components) {
+        const route = fileToRoute.get(component.file);
+        if (!route) {
+            // Not a route file
+            continue;
+        }
+        const componentIssues = validateParamUsage(component, route);
+        issues.push(...componentIssues);
+    }
+    return issues;
+}
+/**
+ * Validate param usage in a component against its route definition
+ */
+function validateParamUsage(component, route) {
+    const issues = [];
+    const routeParams = new Set(route.params);
+    for (const hook of component.dataHooks) {
+        if (hook.hook === "useParams" && hook.accessedParams) {
+            for (const param of hook.accessedParams) {
+                if (!routeParams.has(param)) {
+                    issues.push({
+                        category: "params",
+                        severity: "error",
+                        message: `useParams() accesses "${param}" but route has no :${param} parameter`,
+                        location: hook.location,
+                        code: `useParams().${param}`,
+                        suggestion: route.params.length > 0
+                            ? `Available params: ${route.params.map((p) => ":" + p).join(", ")}`
+                            : `Route ${route.path} has no parameters`,
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=params-check.js.map

package/dist/checks/params-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params-check.js","sourceRoot":"","sources":["../../src/checks/params-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,UAA+B,EAC/B,MAAyB,EACzB,OAAe;IAEf,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,0CAA0C;IAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;IACvD,SAAS,SAAS,CAAC,SAA4B;QAC7C,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvD,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IACD,SAAS,CAAC,MAAM,CAAC,CAAC;IAElB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,mBAAmB;YACnB,SAAS;QACX,CAAC;QAED,MAAM,eAAe,GAAG,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,SAA4B,EAC5B,KAAsB;IAEtB,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACrD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC;wBACV,QAAQ,EAAE,QAAQ;wBAClB,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,yBAAyB,KAAK,uBAAuB,KAAK,YAAY;wBAC/E,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,eAAe,KAAK,EAAE;wBAC5B,UAAU,EACR,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;4BACrB,CAAC,CAAC,qBAAqB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;4BACpE,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,oBAAoB;qBAC9C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}