roto-rooter 0.0.1

package/dist/parsers/route-parser.d.ts

@@ -0,0 +1,19 @@
+import type { RouteDefinition } from "../types.js";
+/**
+ * Parse the app/routes.ts file and extract route definitions
+ */
+export declare function parseRoutes(rootDir: string): RouteDefinition[];
+/**
+ * Get all route paths as strings for matching
+ */
+export declare function getAllRoutePaths(routes: RouteDefinition[]): string[];
+/**
+ * Check if a URL matches any route
+ */
+export declare function matchRoute(url: string, routes: RouteDefinition[]): RouteDefinition | undefined;
+/**
+ * Check if a dynamic link pattern could match a route
+ * Pattern like "/employees/:param" should match route "/employees/:id"
+ */
+export declare function matchDynamicPattern(pattern: string, routes: RouteDefinition[]): RouteDefinition | undefined;
+//# sourceMappingURL=route-parser.d.ts.map

package/dist/parsers/route-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/route-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAqB9D;AAuND;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAcpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,eAAe,EAAE,GACxB,eAAe,GAAG,SAAS,CAa7B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EAAE,GACxB,eAAe,GAAG,SAAS,CAsD7B"}

package/dist/parsers/route-parser.js

@@ -0,0 +1,275 @@
+import * as fs from "fs";
+import * as path from "path";
+import ts from "typescript";
+import { parseFile, walkAst } from "../utils/ast-utils.js";
+/**
+ * Parse the app/routes.ts file and extract route definitions
+ */
+export function parseRoutes(rootDir) {
+    const routesPath = path.join(rootDir, "app", "routes.ts");
+    if (!fs.existsSync(routesPath)) {
+        throw new Error(`Routes file not found: ${routesPath}`);
+    }
+    const content = fs.readFileSync(routesPath, "utf-8");
+    const sourceFile = parseFile(routesPath, content);
+    const routes = [];
+    walkAst(sourceFile, (node) => {
+        // Look for the default export array
+        if (ts.isExportAssignment(node) && node.expression) {
+            const extracted = extractRoutesFromExpression(node.expression, rootDir);
+            routes.push(...extracted);
+        }
+    });
+    return routes;
+}
+/**
+ * Extract routes from an expression (array literal or call expression)
+ */
+function extractRoutesFromExpression(expr, rootDir) {
+    const routes = [];
+    // Array literal: [route(...), route(...)]
+    if (ts.isArrayLiteralExpression(expr)) {
+        for (const element of expr.elements) {
+            const extracted = extractRoutesFromExpression(element, rootDir);
+            routes.push(...extracted);
+        }
+        return routes;
+    }
+    // "as" expression: [...] satisfies RouteConfig
+    if (ts.isSatisfiesExpression(expr) || ts.isAsExpression(expr)) {
+        return extractRoutesFromExpression(expr.expression, rootDir);
+    }
+    // Call expression: route("/path", "file.tsx") or layout("file.tsx", [...])
+    if (ts.isCallExpression(expr)) {
+        const funcName = ts.isIdentifier(expr.expression)
+            ? expr.expression.text
+            : undefined;
+        if (funcName === "route") {
+            const route = parseRouteCall(expr, rootDir);
+            if (route) {
+                routes.push(route);
+            }
+        }
+        else if (funcName === "layout") {
+            const layoutRoutes = parseLayoutCall(expr, rootDir);
+            routes.push(...layoutRoutes);
+        }
+        else if (funcName === "index") {
+            const route = parseIndexCall(expr, rootDir);
+            if (route) {
+                routes.push(route);
+            }
+        }
+    }
+    return routes;
+}
+/**
+ * Parse a route() call expression
+ * route("/employees", "routes/employees.tsx")
+ * route("/employees/:id", "routes/employees.$id.tsx", { id: "employee-detail" })
+ */
+function parseRouteCall(call, rootDir) {
+    const args = call.arguments;
+    if (args.length < 2) {
+        return undefined;
+    }
+    // First arg: path
+    const pathArg = args[0];
+    if (!ts.isStringLiteral(pathArg)) {
+        return undefined;
+    }
+    const routePath = pathArg.text;
+    // Second arg: file path
+    const fileArg = args[1];
+    if (!ts.isStringLiteral(fileArg)) {
+        return undefined;
+    }
+    const file = fileArg.text;
+    // Third arg (optional): options { id: "..." }
+    let id;
+    let children;
+    if (args.length >= 3) {
+        const thirdArg = args[2];
+        // Check if it's an options object
+        if (ts.isObjectLiteralExpression(thirdArg)) {
+            for (const prop of thirdArg.properties) {
+                if (ts.isPropertyAssignment(prop) &&
+                    ts.isIdentifier(prop.name) &&
+                    prop.name.text === "id" &&
+                    ts.isStringLiteral(prop.initializer)) {
+                    id = prop.initializer.text;
+                }
+            }
+        }
+        // Check if it's a children array
+        if (ts.isArrayLiteralExpression(thirdArg)) {
+            children = extractRoutesFromExpression(thirdArg, rootDir);
+        }
+    }
+    // Fourth arg could be children if third was options
+    if (args.length >= 4) {
+        const fourthArg = args[3];
+        if (ts.isArrayLiteralExpression(fourthArg)) {
+            children = extractRoutesFromExpression(fourthArg, rootDir);
+        }
+    }
+    return createRouteDefinition(routePath, file, id, children);
+}
+/**
+ * Parse a layout() call expression
+ * layout("routes/_layout.tsx", [...])
+ */
+function parseLayoutCall(call, rootDir) {
+    const args = call.arguments;
+    if (args.length < 2) {
+        return [];
+    }
+    // First arg: layout file path
+    const fileArg = args[0];
+    if (!ts.isStringLiteral(fileArg)) {
+        return [];
+    }
+    // Second arg: children array
+    const childrenArg = args[1];
+    const children = extractRoutesFromExpression(childrenArg, rootDir);
+    // Layout itself doesn't define a path, so we just return the children
+    // but we could track the layout file for other checks
+    return children;
+}
+/**
+ * Parse an index() call expression
+ * index("routes/home.tsx")
+ */
+function parseIndexCall(call, rootDir) {
+    const args = call.arguments;
+    if (args.length < 1) {
+        return undefined;
+    }
+    const fileArg = args[0];
+    if (!ts.isStringLiteral(fileArg)) {
+        return undefined;
+    }
+    return createRouteDefinition("/", fileArg.text, undefined, undefined);
+}
+/**
+ * Create a RouteDefinition with computed params and pattern
+ */
+function createRouteDefinition(routePath, file, id, children) {
+    const params = extractParams(routePath);
+    const pattern = pathToRegex(routePath);
+    return {
+        path: routePath,
+        file,
+        id,
+        params,
+        pattern,
+        children: children && children.length > 0 ? children : undefined,
+    };
+}
+/**
+ * Extract param names from a route path
+ * "/employees/:id/tasks/:taskId" -> ["id", "taskId"]
+ */
+function extractParams(routePath) {
+    const params = [];
+    const regex = /:(\w+)/g;
+    let match;
+    while ((match = regex.exec(routePath)) !== null) {
+        params.push(match[1]);
+    }
+    return params;
+}
+/**
+ * Convert a route path to a regex for matching
+ * "/employees/:id" -> /^\/employees\/[^/]+$/
+ */
+function pathToRegex(routePath) {
+    // Escape special regex chars except :
+    let pattern = routePath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    // Replace :param with a capturing group that matches any non-slash characters
+    pattern = pattern.replace(/:(\w+)/g, "([^/]+)");
+    return new RegExp(`^${pattern}$`);
+}
+/**
+ * Get all route paths as strings for matching
+ */
+export function getAllRoutePaths(routes) {
+    const paths = [];
+    function collect(routeList) {
+        for (const route of routeList) {
+            paths.push(route.path);
+            if (route.children) {
+                collect(route.children);
+            }
+        }
+    }
+    collect(routes);
+    return paths;
+}
+/**
+ * Check if a URL matches any route
+ */
+export function matchRoute(url, routes) {
+    for (const route of routes) {
+        if (route.pattern.test(url)) {
+            return route;
+        }
+        if (route.children) {
+            const childMatch = matchRoute(url, route.children);
+            if (childMatch) {
+                return childMatch;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Check if a dynamic link pattern could match a route
+ * Pattern like "/employees/:param" should match route "/employees/:id"
+ */
+export function matchDynamicPattern(pattern, routes) {
+    // Normalize the pattern to compare segment counts and static parts
+    const patternParts = pattern.split("/").filter(Boolean);
+    for (const route of routes) {
+        const routeParts = route.path.split("/").filter(Boolean);
+        if (patternParts.length !== routeParts.length) {
+            continue;
+        }
+        let matches = true;
+        for (let i = 0; i < patternParts.length; i++) {
+            const patternPart = patternParts[i];
+            const routePart = routeParts[i];
+            // Both dynamic - OK
+            if (patternPart.startsWith(":") && routePart.startsWith(":")) {
+                continue;
+            }
+            // Both static - must match exactly
+            if (!patternPart.startsWith(":") && !routePart.startsWith(":")) {
+                if (patternPart !== routePart) {
+                    matches = false;
+                    break;
+                }
+                continue;
+            }
+            // One dynamic, one static - OK (dynamic in pattern matches any route segment)
+            if (patternPart.startsWith(":")) {
+                continue;
+            }
+            // Static in pattern, dynamic in route - doesn't match
+            matches = false;
+            break;
+        }
+        if (matches) {
+            return route;
+        }
+        // Check children
+        if (route.children) {
+            const childMatch = matchDynamicPattern(pattern, route.children);
+            if (childMatch) {
+                return childMatch;
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=route-parser.js.map

package/dist/parsers/route-parser.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Represents a route definition parsed from app/routes.ts
+ */
+export interface RouteDefinition {
+    /** The URL path pattern (e.g., "/employees/:id") */
+    path: string;
+    /** The file path relative to app/ (e.g., "routes/employees.$id.tsx") */
+    file: string;
+    /** Route ID if specified */
+    id?: string;
+    /** Extracted param names from the path (e.g., ["id"]) */
+    params: string[];
+    /** Regex for matching URLs against this route */
+    pattern: RegExp;
+    /** Child routes for layouts */
+    children?: RouteDefinition[];
+}
+/**
+ * Represents a Link found in a component
+ */
+export interface LinkReference {
+    /** The href/to value */
+    href: string;
+    /** Whether this is a template literal with interpolation */
+    isDynamic: boolean;
+    /** The extracted pattern for dynamic links (e.g., "/employees/:param") */
+    pattern?: string;
+    /** Source location */
+    location: SourceLocation;
+    /** The type of link */
+    type: "link" | "redirect" | "navigate";
+}
+/**
+ * Represents a Form found in a component
+ */
+export interface FormReference {
+    /** The action attribute value */
+    action?: string;
+    /** The HTTP method */
+    method: "get" | "post" | "put" | "patch" | "delete";
+    /** Input names within the form */
+    inputNames: string[];
+    /** Source location */
+    location: SourceLocation;
+}
+/**
+ * Represents a useLoaderData or useActionData call
+ */
+export interface DataHookReference {
+    /** The hook name */
+    hook: "useLoaderData" | "useActionData" | "useParams";
+    /** Param names accessed (for useParams) */
+    accessedParams?: string[];
+    /** Source location */
+    location: SourceLocation;
+}
+/**
+ * Analysis result for a single component file
+ */
+export interface ComponentAnalysis {
+    /** The file path */
+    file: string;
+    /** All Link references found */
+    links: LinkReference[];
+    /** All Form references found */
+    forms: FormReference[];
+    /** All data hook references found */
+    dataHooks: DataHookReference[];
+    /** Whether this file exports a loader function */
+    hasLoader: boolean;
+    /** Whether this file exports an action function */
+    hasAction: boolean;
+}
+/**
+ * Source location in a file
+ */
+export interface SourceLocation {
+    file: string;
+    line: number;
+    column: number;
+}
+/**
+ * An issue found by the analyzer
+ */
+export interface AnalyzerIssue {
+    /** The check category */
+    category: "links" | "forms" | "loader" | "params" | "interactive" | "a11y";
+    /** Severity level */
+    severity: "error" | "warning";
+    /** Human-readable message */
+    message: string;
+    /** Source location */
+    location: SourceLocation;
+    /** The problematic code snippet */
+    code?: string;
+    /** Suggestion for fix (e.g., "Did you mean: /employees/:id?") */
+    suggestion?: string;
+}
+/**
+ * Result of running the analyzer
+ */
+export interface AnalyzerResult {
+    /** All issues found */
+    issues: AnalyzerIssue[];
+    /** Routes that were parsed */
+    routes: RouteDefinition[];
+    /** Components that were analyzed */
+    components: ComponentAnalysis[];
+}
+/**
+ * CLI options
+ */
+export interface CliOptions {
+    /** Files to check (empty = all) */
+    files: string[];
+    /** Checks to run (empty = all) */
+    checks: string[];
+    /** Output format */
+    format: "text" | "json";
+    /** Root directory of the project */
+    root: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/ast-utils.d.ts

@@ -0,0 +1,41 @@
+import ts from "typescript";
+/**
+ * Parse a TypeScript/TSX file and return its source file AST
+ */
+export declare function parseFile(filePath: string, content: string): ts.SourceFile;
+/**
+ * Get line and column from a position in a source file
+ */
+export declare function getLineAndColumn(sourceFile: ts.SourceFile, position: number): {
+    line: number;
+    column: number;
+};
+/**
+ * Check if a node is a JSX element with a specific tag name
+ */
+export declare function isJsxElementWithName(node: ts.Node, name: string): node is ts.JsxElement | ts.JsxSelfClosingElement;
+/**
+ * Get JSX attribute value by name
+ */
+export declare function getJsxAttribute(element: ts.JsxElement | ts.JsxSelfClosingElement, attributeName: string): ts.JsxAttribute | undefined;
+/**
+ * Extract string value from a JSX attribute
+ * Returns undefined for complex expressions that can't be statically analyzed
+ */
+export declare function getJsxAttributeStringValue(attr: ts.JsxAttribute): {
+    value: string;
+    isDynamic: boolean;
+} | undefined;
+/**
+ * Check if a node is a call expression to a specific function
+ */
+export declare function isCallTo(node: ts.Node, functionName: string): node is ts.CallExpression;
+/**
+ * Check if a function/variable is exported
+ */
+export declare function isExported(node: ts.Node): boolean;
+/**
+ * Walk the AST and call visitor for each node
+ */
+export declare function walkAst(node: ts.Node, visitor: (node: ts.Node) => void): void;
+//# sourceMappingURL=ast-utils.d.ts.map

package/dist/utils/ast-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-utils.d.ts","sourceRoot":"","sources":["../../src/utils/ast-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,CAQ1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGlC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,IAAI,EAAE,MAAM,GACX,IAAI,IAAI,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,qBAAqB,CAUlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,qBAAqB,EACjD,aAAa,EAAE,MAAM,GACpB,EAAE,CAAC,YAAY,GAAG,SAAS,CAW7B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,EAAE,CAAC,YAAY,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAgCnD;AAmBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,cAAc,CAavF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAGjD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,GAAG,IAAI,CAG7E"}

package/dist/utils/ast-utils.js

@@ -0,0 +1,114 @@
+import ts from "typescript";
+/**
+ * Parse a TypeScript/TSX file and return its source file AST
+ */
+export function parseFile(filePath, content) {
+    return ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true, filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+}
+/**
+ * Get line and column from a position in a source file
+ */
+export function getLineAndColumn(sourceFile, position) {
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(position);
+    return { line: line + 1, column: character + 1 };
+}
+/**
+ * Check if a node is a JSX element with a specific tag name
+ */
+export function isJsxElementWithName(node, name) {
+    if (ts.isJsxElement(node)) {
+        const tagName = node.openingElement.tagName;
+        return ts.isIdentifier(tagName) && tagName.text === name;
+    }
+    if (ts.isJsxSelfClosingElement(node)) {
+        const tagName = node.tagName;
+        return ts.isIdentifier(tagName) && tagName.text === name;
+    }
+    return false;
+}
+/**
+ * Get JSX attribute value by name
+ */
+export function getJsxAttribute(element, attributeName) {
+    const attributes = ts.isJsxElement(element)
+        ? element.openingElement.attributes
+        : element.attributes;
+    for (const attr of attributes.properties) {
+        if (ts.isJsxAttribute(attr) && ts.isIdentifier(attr.name) && attr.name.text === attributeName) {
+            return attr;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract string value from a JSX attribute
+ * Returns undefined for complex expressions that can't be statically analyzed
+ */
+export function getJsxAttributeStringValue(attr) {
+    const initializer = attr.initializer;
+    if (!initializer) {
+        return undefined;
+    }
+    // String literal: href="/path"
+    if (ts.isStringLiteral(initializer)) {
+        return { value: initializer.text, isDynamic: false };
+    }
+    // JSX expression: href={...}
+    if (ts.isJsxExpression(initializer) && initializer.expression) {
+        const expr = initializer.expression;
+        // String literal inside expression: href={"/path"}
+        if (ts.isStringLiteral(expr)) {
+            return { value: expr.text, isDynamic: false };
+        }
+        // Template literal: href={`/employees/${id}`}
+        if (ts.isTemplateExpression(expr)) {
+            return extractTemplatePattern(expr);
+        }
+        // No-substitution template: href={`/employees`}
+        if (ts.isNoSubstitutionTemplateLiteral(expr)) {
+            return { value: expr.text, isDynamic: false };
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract a pattern from a template literal expression
+ * e.g., `/employees/${id}` -> { value: "/employees/${id}", isDynamic: true }
+ */
+function extractTemplatePattern(template) {
+    let pattern = template.head.text;
+    for (const span of template.templateSpans) {
+        // Replace interpolations with :param placeholder
+        pattern += ":param" + span.literal.text;
+    }
+    return { value: pattern, isDynamic: true };
+}
+/**
+ * Check if a node is a call expression to a specific function
+ */
+export function isCallTo(node, functionName) {
+    if (!ts.isCallExpression(node)) {
+        return false;
+    }
+    const expr = node.expression;
+    // Direct call: redirect("/path")
+    if (ts.isIdentifier(expr)) {
+        return expr.text === functionName;
+    }
+    return false;
+}
+/**
+ * Check if a function/variable is exported
+ */
+export function isExported(node) {
+    const modifiers = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+    return modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+}
+/**
+ * Walk the AST and call visitor for each node
+ */
+export function walkAst(node, visitor) {
+    visitor(node);
+    ts.forEachChild(node, (child) => walkAst(child, visitor));
+}
+//# sourceMappingURL=ast-utils.js.map

package/dist/utils/ast-utils.js.map

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

package/dist/utils/suggestion.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Find the best matching suggestion from a list of candidates
+ * Returns undefined if no good match is found
+ */
+export declare function findBestMatch(input: string, candidates: string[], maxDistance?: number): string | undefined;
+/**
+ * Format a "Did you mean?" suggestion
+ */
+export declare function formatSuggestion(match: string | undefined): string | undefined;
+//# sourceMappingURL=suggestion.d.ts.map

package/dist/utils/suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.d.ts","sourceRoot":"","sources":["../../src/utils/suggestion.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,SAAI,GACd,MAAM,GAAG,SAAS,CAiBpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK9E"}

package/dist/utils/suggestion.js

@@ -0,0 +1,30 @@
+import { distance } from "fastest-levenshtein";
+/**
+ * Find the best matching suggestion from a list of candidates
+ * Returns undefined if no good match is found
+ */
+export function findBestMatch(input, candidates, maxDistance = 3) {
+    if (candidates.length === 0) {
+        return undefined;
+    }
+    let bestMatch;
+    let bestDistance = Infinity;
+    for (const candidate of candidates) {
+        const d = distance(input, candidate);
+        if (d < bestDistance && d <= maxDistance) {
+            bestDistance = d;
+            bestMatch = candidate;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Format a "Did you mean?" suggestion
+ */
+export function formatSuggestion(match) {
+    if (!match) {
+        return undefined;
+    }
+    return `Did you mean: ${match}?`;
+}
+//# sourceMappingURL=suggestion.js.map

package/dist/utils/suggestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.js","sourceRoot":"","sources":["../../src/utils/suggestion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,UAAoB,EACpB,WAAW,GAAG,CAAC;IAEf,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,SAA6B,CAAC;IAClC,IAAI,YAAY,GAAG,QAAQ,CAAC;IAE5B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,YAAY,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;YACzC,YAAY,GAAG,CAAC,CAAC;YACjB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,iBAAiB,KAAK,GAAG,CAAC;AACnC,CAAC"}