@stupidloud/codegraph 0.7.7

package/dist/resolution/frameworks/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Framework Resolver Registry
+ *
+ * Manages framework-specific resolvers.
+ */
+import { FrameworkResolver, ResolutionContext } from '../types';
+import type { Language } from '../../types';
+/**
+ * Get all framework resolvers
+ */
+export declare function getAllFrameworkResolvers(): FrameworkResolver[];
+/**
+ * Get a resolver by name
+ */
+export declare function getFrameworkResolver(name: string): FrameworkResolver | undefined;
+/**
+ * Detect which frameworks are used in a project
+ */
+export declare function detectFrameworks(context: ResolutionContext): FrameworkResolver[];
+/**
+ * Filter a list of detected frameworks down to ones that apply to a given language.
+ * Frameworks without an explicit `languages` list are treated as universal.
+ */
+export declare function getApplicableFrameworks(detected: FrameworkResolver[], language: Language): FrameworkResolver[];
+/**
+ * Register a custom framework resolver
+ */
+export declare function registerFrameworkResolver(resolver: FrameworkResolver): void;
+export { laravelResolver, FACADE_MAPPINGS } from './laravel';
+export { expressResolver } from './express';
+export { reactResolver } from './react';
+export { svelteResolver } from './svelte';
+export { vueResolver } from './vue';
+export { djangoResolver, flaskResolver, fastapiResolver } from './python';
+export { railsResolver } from './ruby';
+export { springResolver } from './java';
+export { goResolver } from './go';
+export { rustResolver } from './rust';
+export { aspnetResolver } from './csharp';
+export { swiftUIResolver, uikitResolver, vaporResolver } from './swift';
+//# sourceMappingURL=index.d.ts.map

package/dist/resolution/frameworks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA6C5C;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,iBAAiB,EAAE,CAE9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAQhF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,QAAQ,EAAE,QAAQ,GACjB,iBAAiB,EAAE,CAIrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAO3E;AAGD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/resolution/frameworks/index.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Framework Resolver Registry
+ *
+ * Manages framework-specific resolvers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vaporResolver = exports.uikitResolver = exports.swiftUIResolver = exports.aspnetResolver = exports.rustResolver = exports.goResolver = exports.springResolver = exports.railsResolver = exports.fastapiResolver = exports.flaskResolver = exports.djangoResolver = exports.vueResolver = exports.svelteResolver = exports.reactResolver = exports.expressResolver = exports.FACADE_MAPPINGS = exports.laravelResolver = void 0;
+exports.getAllFrameworkResolvers = getAllFrameworkResolvers;
+exports.getFrameworkResolver = getFrameworkResolver;
+exports.detectFrameworks = detectFrameworks;
+exports.getApplicableFrameworks = getApplicableFrameworks;
+exports.registerFrameworkResolver = registerFrameworkResolver;
+const laravel_1 = require("./laravel");
+const express_1 = require("./express");
+const react_1 = require("./react");
+const svelte_1 = require("./svelte");
+const vue_1 = require("./vue");
+const python_1 = require("./python");
+const ruby_1 = require("./ruby");
+const java_1 = require("./java");
+const go_1 = require("./go");
+const rust_1 = require("./rust");
+const csharp_1 = require("./csharp");
+const swift_1 = require("./swift");
+/**
+ * All registered framework resolvers
+ */
+const FRAMEWORK_RESOLVERS = [
+    // PHP
+    laravel_1.laravelResolver,
+    // JavaScript/TypeScript
+    express_1.expressResolver,
+    react_1.reactResolver,
+    svelte_1.svelteResolver,
+    vue_1.vueResolver,
+    // Python
+    python_1.djangoResolver,
+    python_1.flaskResolver,
+    python_1.fastapiResolver,
+    // Ruby
+    ruby_1.railsResolver,
+    // Java
+    java_1.springResolver,
+    // Go
+    go_1.goResolver,
+    // Rust
+    rust_1.rustResolver,
+    // C#
+    csharp_1.aspnetResolver,
+    // Swift
+    swift_1.swiftUIResolver,
+    swift_1.uikitResolver,
+    swift_1.vaporResolver,
+];
+/**
+ * Get all framework resolvers
+ */
+function getAllFrameworkResolvers() {
+    return FRAMEWORK_RESOLVERS;
+}
+/**
+ * Get a resolver by name
+ */
+function getFrameworkResolver(name) {
+    return FRAMEWORK_RESOLVERS.find((r) => r.name === name);
+}
+/**
+ * Detect which frameworks are used in a project
+ */
+function detectFrameworks(context) {
+    return FRAMEWORK_RESOLVERS.filter((resolver) => {
+        try {
+            return resolver.detect(context);
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/**
+ * Filter a list of detected frameworks down to ones that apply to a given language.
+ * Frameworks without an explicit `languages` list are treated as universal.
+ */
+function getApplicableFrameworks(detected, language) {
+    return detected.filter((fw) => !fw.languages || fw.languages.includes(language));
+}
+/**
+ * Register a custom framework resolver
+ */
+function registerFrameworkResolver(resolver) {
+    // Remove existing resolver with same name
+    const index = FRAMEWORK_RESOLVERS.findIndex((r) => r.name === resolver.name);
+    if (index !== -1) {
+        FRAMEWORK_RESOLVERS.splice(index, 1);
+    }
+    FRAMEWORK_RESOLVERS.push(resolver);
+}
+// Re-export framework resolvers
+var laravel_2 = require("./laravel");
+Object.defineProperty(exports, "laravelResolver", { enumerable: true, get: function () { return laravel_2.laravelResolver; } });
+Object.defineProperty(exports, "FACADE_MAPPINGS", { enumerable: true, get: function () { return laravel_2.FACADE_MAPPINGS; } });
+var express_2 = require("./express");
+Object.defineProperty(exports, "expressResolver", { enumerable: true, get: function () { return express_2.expressResolver; } });
+var react_2 = require("./react");
+Object.defineProperty(exports, "reactResolver", { enumerable: true, get: function () { return react_2.reactResolver; } });
+var svelte_2 = require("./svelte");
+Object.defineProperty(exports, "svelteResolver", { enumerable: true, get: function () { return svelte_2.svelteResolver; } });
+var vue_2 = require("./vue");
+Object.defineProperty(exports, "vueResolver", { enumerable: true, get: function () { return vue_2.vueResolver; } });
+var python_2 = require("./python");
+Object.defineProperty(exports, "djangoResolver", { enumerable: true, get: function () { return python_2.djangoResolver; } });
+Object.defineProperty(exports, "flaskResolver", { enumerable: true, get: function () { return python_2.flaskResolver; } });
+Object.defineProperty(exports, "fastapiResolver", { enumerable: true, get: function () { return python_2.fastapiResolver; } });
+var ruby_2 = require("./ruby");
+Object.defineProperty(exports, "railsResolver", { enumerable: true, get: function () { return ruby_2.railsResolver; } });
+var java_2 = require("./java");
+Object.defineProperty(exports, "springResolver", { enumerable: true, get: function () { return java_2.springResolver; } });
+var go_2 = require("./go");
+Object.defineProperty(exports, "goResolver", { enumerable: true, get: function () { return go_2.goResolver; } });
+var rust_2 = require("./rust");
+Object.defineProperty(exports, "rustResolver", { enumerable: true, get: function () { return rust_2.rustResolver; } });
+var csharp_2 = require("./csharp");
+Object.defineProperty(exports, "aspnetResolver", { enumerable: true, get: function () { return csharp_2.aspnetResolver; } });
+var swift_2 = require("./swift");
+Object.defineProperty(exports, "swiftUIResolver", { enumerable: true, get: function () { return swift_2.swiftUIResolver; } });
+Object.defineProperty(exports, "uikitResolver", { enumerable: true, get: function () { return swift_2.uikitResolver; } });
+Object.defineProperty(exports, "vaporResolver", { enumerable: true, get: function () { return swift_2.vaporResolver; } });
+//# sourceMappingURL=index.js.map

package/dist/resolution/frameworks/index.js.map

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

package/dist/resolution/frameworks/java.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Java Framework Resolver
+ *
+ * Handles Spring Boot and general Java patterns.
+ */
+import { FrameworkResolver } from '../types';
+export declare const springResolver: FrameworkResolver;
+//# sourceMappingURL=java.d.ts.map

package/dist/resolution/frameworks/java.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"java.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/java.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAiD,MAAM,UAAU,CAAC;AAG5F,eAAO,MAAM,cAAc,EAAE,iBA+J5B,CAAC"}

package/dist/resolution/frameworks/java.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Java Framework Resolver
+ *
+ * Handles Spring Boot and general Java patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.springResolver = void 0;
+const strip_comments_1 = require("../strip-comments");
+exports.springResolver = {
+    name: 'spring',
+    languages: ['java'],
+    detect(context) {
+        // Check for pom.xml with Spring
+        const pomXml = context.readFile('pom.xml');
+        if (pomXml && (pomXml.includes('spring-boot') || pomXml.includes('springframework'))) {
+            return true;
+        }
+        // Check for build.gradle with Spring
+        const buildGradle = context.readFile('build.gradle');
+        if (buildGradle && (buildGradle.includes('spring-boot') || buildGradle.includes('springframework'))) {
+            return true;
+        }
+        const buildGradleKts = context.readFile('build.gradle.kts');
+        if (buildGradleKts && (buildGradleKts.includes('spring-boot') || buildGradleKts.includes('springframework'))) {
+            return true;
+        }
+        // Check for Spring annotations in Java files
+        const allFiles = context.getAllFiles();
+        for (const file of allFiles) {
+            if (file.endsWith('.java')) {
+                const content = context.readFile(file);
+                if (content && (content.includes('@SpringBootApplication') ||
+                    content.includes('@RestController') ||
+                    content.includes('@Service') ||
+                    content.includes('@Repository'))) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    },
+    resolve(ref, context) {
+        // Pattern 1: Service references (dependency injection)
+        if (ref.referenceName.endsWith('Service')) {
+            const result = resolveByNameAndKind(ref.referenceName, SERVICE_KINDS, SERVICE_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 2: Repository references
+        if (ref.referenceName.endsWith('Repository')) {
+            const result = resolveByNameAndKind(ref.referenceName, SERVICE_KINDS, REPO_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 3: Controller references
+        if (ref.referenceName.endsWith('Controller')) {
+            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, CONTROLLER_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 4: Entity/Model references
+        if (/^[A-Z][a-zA-Z]+$/.test(ref.referenceName)) {
+            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, ENTITY_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.7,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 5: Component references
+        if (ref.referenceName.endsWith('Component') || ref.referenceName.endsWith('Config')) {
+            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, COMPONENT_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.8,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        return null;
+    },
+    extract(filePath, content) {
+        if (!filePath.endsWith('.java'))
+            return { nodes: [], references: [] };
+        const nodes = [];
+        const references = [];
+        const now = Date.now();
+        const safe = (0, strip_comments_1.stripCommentsForRegex)(content, 'java');
+        // @GetMapping("/path"), @PostMapping(value = "/path"), @RequestMapping("/path")
+        const mappingRegex = /@(GetMapping|PostMapping|PutMapping|PatchMapping|DeleteMapping|RequestMapping)\s*\(\s*(?:value\s*=\s*|path\s*=\s*)?["']([^"']+)["'][^)]*\)/g;
+        let match;
+        while ((match = mappingRegex.exec(safe)) !== null) {
+            const [, mappingName, routePath] = match;
+            const line = safe.slice(0, match.index).split('\n').length;
+            const method = mappingName === 'RequestMapping' ? 'ANY' : mappingName.replace(/Mapping$/, '').toUpperCase();
+            const routeNode = {
+                id: `route:${filePath}:${line}:${method}:${routePath}`,
+                kind: 'route',
+                name: `${method} ${routePath}`,
+                qualifiedName: `${filePath}::route:${routePath}`,
+                filePath,
+                startLine: line,
+                endLine: line,
+                startColumn: 0,
+                endColumn: match[0].length,
+                language: 'java',
+                updatedAt: now,
+            };
+            nodes.push(routeNode);
+            // Look for the next public/private/protected method after the annotation
+            const tail = safe.slice(match.index + match[0].length);
+            const methodMatch = tail.match(/\b(?:public|private|protected)\s+[^;{]*?\s+(\w+)\s*\(/);
+            if (methodMatch) {
+                references.push({
+                    fromNodeId: routeNode.id,
+                    referenceName: methodMatch[1],
+                    referenceKind: 'references',
+                    line,
+                    column: 0,
+                    filePath,
+                    language: 'java',
+                });
+            }
+        }
+        return { nodes, references };
+    },
+};
+// Directory patterns
+const SERVICE_DIRS = ['/service/', '/services/'];
+const REPO_DIRS = ['/repository/', '/repositories/'];
+const CONTROLLER_DIRS = ['/controller/', '/controllers/'];
+const ENTITY_DIRS = ['/entity/', '/entities/', '/model/', '/models/', '/domain/'];
+const COMPONENT_DIRS = ['/component/', '/components/', '/config/'];
+const CLASS_KINDS = new Set(['class']);
+const SERVICE_KINDS = new Set(['class', 'interface']);
+/**
+ * Resolve a symbol by name using indexed queries instead of scanning all files.
+ */
+function resolveByNameAndKind(name, kinds, preferredDirPatterns, context) {
+    const candidates = context.getNodesByName(name);
+    if (candidates.length === 0)
+        return null;
+    const kindFiltered = candidates.filter((n) => kinds.has(n.kind));
+    if (kindFiltered.length === 0)
+        return null;
+    // Prefer candidates in framework-conventional directories
+    const preferred = kindFiltered.filter((n) => preferredDirPatterns.some((d) => n.filePath.includes(d)));
+    if (preferred.length > 0)
+        return preferred[0].id;
+    // Fall back to any match
+    return kindFiltered[0].id;
+}
+//# sourceMappingURL=java.js.map

package/dist/resolution/frameworks/java.js.map

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

package/dist/resolution/frameworks/laravel.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Laravel Framework Resolver
+ *
+ * Handles Laravel-specific patterns for reference resolution.
+ */
+import { FrameworkResolver } from '../types';
+/**
+ * Laravel facade mappings to underlying classes
+ * Exported for potential use in facade resolution
+ */
+export declare const FACADE_MAPPINGS: Record<string, string>;
+export declare const laravelResolver: FrameworkResolver;
+//# sourceMappingURL=laravel.d.ts.map

package/dist/resolution/frameworks/laravel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"laravel.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/laravel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAiD,MAAM,UAAU,CAAC;AAG5F;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqBlD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,iBA2I7B,CAAC"}

package/dist/resolution/frameworks/laravel.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * Laravel Framework Resolver
+ *
+ * Handles Laravel-specific patterns for reference resolution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.laravelResolver = exports.FACADE_MAPPINGS = void 0;
+const strip_comments_1 = require("../strip-comments");
+/**
+ * Laravel facade mappings to underlying classes
+ * Exported for potential use in facade resolution
+ */
+exports.FACADE_MAPPINGS = {
+    Auth: 'Illuminate\\Auth\\AuthManager',
+    Cache: 'Illuminate\\Cache\\CacheManager',
+    Config: 'Illuminate\\Config\\Repository',
+    DB: 'Illuminate\\Database\\DatabaseManager',
+    Event: 'Illuminate\\Events\\Dispatcher',
+    File: 'Illuminate\\Filesystem\\Filesystem',
+    Gate: 'Illuminate\\Auth\\Access\\Gate',
+    Hash: 'Illuminate\\Hashing\\HashManager',
+    Log: 'Illuminate\\Log\\LogManager',
+    Mail: 'Illuminate\\Mail\\Mailer',
+    Queue: 'Illuminate\\Queue\\QueueManager',
+    Redis: 'Illuminate\\Redis\\RedisManager',
+    Request: 'Illuminate\\Http\\Request',
+    Response: 'Illuminate\\Http\\Response',
+    Route: 'Illuminate\\Routing\\Router',
+    Session: 'Illuminate\\Session\\SessionManager',
+    Storage: 'Illuminate\\Filesystem\\FilesystemManager',
+    URL: 'Illuminate\\Routing\\UrlGenerator',
+    Validator: 'Illuminate\\Validation\\Factory',
+    View: 'Illuminate\\View\\Factory',
+};
+exports.laravelResolver = {
+    name: 'laravel',
+    languages: ['php'],
+    detect(context) {
+        // Check for artisan file (Laravel signature)
+        return context.fileExists('artisan') || context.fileExists('app/Http/Kernel.php');
+    },
+    resolve(ref, context) {
+        // Pattern 1: Model::method() - Eloquent static calls
+        const modelMatch = ref.referenceName.match(/^([A-Z][a-zA-Z]+)::(\w+)$/);
+        if (modelMatch) {
+            const [, className, methodName] = modelMatch;
+            const result = resolveModelCall(className, methodName, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 2: Facade calls - Auth::user(), Cache::get()
+        const facadeMatch = ref.referenceName.match(/^(Auth|Cache|DB|Log|Mail|Queue|Session|Storage|Validator|Route|Request|Response)::(\w+)$/);
+        if (facadeMatch) {
+            // Facades typically resolve to external Laravel code
+            // Mark as external but note the facade
+            return null; // External, can't resolve to local node
+        }
+        // Pattern 3: Helper function calls - route(), view(), config()
+        if (['route', 'view', 'config', 'env', 'app', 'abort', 'redirect', 'response', 'request', 'session', 'url', 'asset', 'mix'].includes(ref.referenceName)) {
+            // These are Laravel helpers - external
+            return null;
+        }
+        // Pattern 4: Controller method references
+        const controllerMatch = ref.referenceName.match(/^([A-Z][a-zA-Z]+Controller)@(\w+)$/);
+        if (controllerMatch) {
+            const [, controller, method] = controllerMatch;
+            const result = resolveControllerMethod(controller, method, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.9,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        return null;
+    },
+    extract(filePath, content) {
+        if (!filePath.endsWith('.php'))
+            return { nodes: [], references: [] };
+        const nodes = [];
+        const references = [];
+        const now = Date.now();
+        const safe = (0, strip_comments_1.stripCommentsForRegex)(content, 'php');
+        // Route::METHOD('/path', handler-expr)
+        // handler-expr can be: [Class::class, 'method'] | 'Controller@method' | Closure | Class::class
+        const routeRegex = /Route::(get|post|put|patch|delete|options|any)\s*\(\s*['"]([^'"]+)['"]\s*,\s*([^)]+)\)/g;
+        let match;
+        while ((match = routeRegex.exec(safe)) !== null) {
+            const [, method, routePath, handlerExpr] = match;
+            const line = safe.slice(0, match.index).split('\n').length;
+            const upper = method.toUpperCase();
+            const routeNode = {
+                id: `route:${filePath}:${line}:${upper}:${routePath}`,
+                kind: 'route',
+                name: `${upper} ${routePath}`,
+                qualifiedName: `${filePath}::route:${routePath}`,
+                filePath,
+                startLine: line,
+                endLine: line,
+                startColumn: 0,
+                endColumn: match[0].length,
+                language: 'php',
+                updatedAt: now,
+            };
+            nodes.push(routeNode);
+            const handlerName = extractLaravelHandler(handlerExpr);
+            if (handlerName) {
+                references.push({
+                    fromNodeId: routeNode.id,
+                    referenceName: handlerName,
+                    referenceKind: 'references',
+                    line,
+                    column: 0,
+                    filePath,
+                    language: 'php',
+                });
+            }
+        }
+        // Route::resource('name', Controller::class) / Route::apiResource('name', Controller::class)
+        const resourceRegex = /Route::(resource|apiResource)\s*\(\s*['"]([^'"]+)['"]\s*(?:,\s*([^)]+))?\)/g;
+        while ((match = resourceRegex.exec(safe)) !== null) {
+            const [, _fn, resourceName, handlerExpr] = match;
+            const line = safe.slice(0, match.index).split('\n').length;
+            const routeNode = {
+                id: `route:${filePath}:${line}:RESOURCE:${resourceName}`,
+                kind: 'route',
+                name: `resource:${resourceName}`,
+                qualifiedName: `${filePath}::route:${resourceName}`,
+                filePath,
+                startLine: line,
+                endLine: line,
+                startColumn: 0,
+                endColumn: match[0].length,
+                language: 'php',
+                updatedAt: now,
+            };
+            nodes.push(routeNode);
+            if (handlerExpr) {
+                const controllerName = extractLaravelHandler(handlerExpr);
+                if (controllerName) {
+                    references.push({
+                        fromNodeId: routeNode.id,
+                        referenceName: controllerName,
+                        referenceKind: 'imports',
+                        line,
+                        column: 0,
+                        filePath,
+                        language: 'php',
+                    });
+                }
+            }
+        }
+        return { nodes, references };
+    },
+};
+/**
+ * Parse a Laravel route handler expression and return the symbol to link.
+ *  - `[Class::class, 'method']`  -> `method`
+ *  - `'Controller@method'`       -> `method`
+ *  - `Class::class`              -> `Class`
+ *  - anything else (closure etc) -> null
+ */
+function extractLaravelHandler(expr) {
+    const trimmed = expr.trim();
+    // [Class::class, 'method'] — grab the string literal
+    const tupleMatch = trimmed.match(/^\[\s*[^,]+,\s*['"]([^'"]+)['"]\s*\]/);
+    if (tupleMatch)
+        return tupleMatch[1];
+    // 'Controller@method'
+    const atMatch = trimmed.match(/^['"]([^'"@]+)@([^'"]+)['"]$/);
+    if (atMatch)
+        return atMatch[2];
+    // Controller::class
+    const classMatch = trimmed.match(/^([A-Za-z_][A-Za-z0-9_]*)::class/);
+    if (classMatch)
+        return classMatch[1];
+    return null;
+}
+/**
+ * Resolve a Model::method() call
+ */
+function resolveModelCall(className, methodName, context) {
+    // Try app/Models/ first (Laravel 8+)
+    let modelPath = `app/Models/${className}.php`;
+    if (context.fileExists(modelPath)) {
+        const nodes = context.getNodesInFile(modelPath);
+        // Look for the method in this class
+        const methodNode = nodes.find((n) => n.kind === 'method' && n.name === methodName);
+        if (methodNode) {
+            return methodNode.id;
+        }
+        // Return the class itself if method not found
+        const classNode = nodes.find((n) => n.kind === 'class' && n.name === className);
+        if (classNode) {
+            return classNode.id;
+        }
+    }
+    // Try app/ (Laravel 7 and below)
+    modelPath = `app/${className}.php`;
+    if (context.fileExists(modelPath)) {
+        const nodes = context.getNodesInFile(modelPath);
+        const methodNode = nodes.find((n) => n.kind === 'method' && n.name === methodName);
+        if (methodNode) {
+            return methodNode.id;
+        }
+        const classNode = nodes.find((n) => n.kind === 'class' && n.name === className);
+        if (classNode) {
+            return classNode.id;
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a Controller@method reference
+ */
+function resolveControllerMethod(controller, method, context) {
+    // Try app/Http/Controllers/
+    const controllerPath = `app/Http/Controllers/${controller}.php`;
+    if (context.fileExists(controllerPath)) {
+        const nodes = context.getNodesInFile(controllerPath);
+        const methodNode = nodes.find((n) => n.kind === 'method' && n.name === method);
+        if (methodNode) {
+            return methodNode.id;
+        }
+    }
+    // Try name-based lookup for namespaced controllers
+    const controllerCandidates = context.getNodesByName(controller);
+    for (const ctrl of controllerCandidates) {
+        if (ctrl.kind === 'class' && ctrl.filePath.includes('Controllers')) {
+            const nodesInFile = context.getNodesInFile(ctrl.filePath);
+            const methodNode = nodesInFile.find((n) => n.kind === 'method' && n.name === method);
+            if (methodNode) {
+                return methodNode.id;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=laravel.js.map