codegraph-java 0.1.0

package/dist/resolution/frameworks/terraform.js

@@ -0,0 +1,277 @@
+"use strict";
+/**
+ * Terraform Framework Resolver
+ *
+ * Terraform's scoping rule is narrow and directory-shaped: `var.X`,
+ * `local.X`, `module.M`, and resource/data references resolve ONLY inside
+ * the same module directory as the reference site. The generic name matcher
+ * resolves by qualified-name alone, so a reference to `var.project_id` from
+ * `modules/net-vpc/main.tf` could bind to a `variable "project_id"` declared
+ * in an unrelated module — a wrong cross-module edge that poisons impact
+ * analysis. This resolver enforces the real semantics:
+ *
+ *   1. Same directory as the reference site → resolve (highest confidence).
+ *   2. `.tfvars` files additionally walk UP to the nearest ancestor
+ *      directory declaring the variable (`terraform apply -var-file=envs/prod.tfvars`
+ *      sets ROOT module variables from a subdirectory).
+ *   3. Otherwise: no edge. Terraform cannot reference across sibling module
+ *      directories, so a non-local candidate is never a correct target.
+ *
+ * It also bridges the module boundary through `:`-scoped references that
+ * only this resolver understands (see the extractor's emitModuleWiring):
+ *
+ *   - `module.M:file`       → the entry file of the module's local source
+ *     directory (an `imports` edge, so a module call connects to the code
+ *     it instantiates).
+ *   - `module.M:var.<in>`   → the child module's `variable "<in>"` node —
+ *     the module block sets that variable, so "what depends on the child's
+ *     var.cidr" reaches every caller.
+ *   - `module.M:output.<o>` → the child module's `output "<o>"` node —
+ *     `module.M.o` uses flow through to the output's definition instead of
+ *     dead-ending at the module declaration.
+ *
+ * The module's `source` is re-read from the declaration's file (cached
+ * lines); only local `./`/`../` sources bridge. Registry/git sources stay
+ * unresolved — an out-of-repo module is a visible boundary, never a guess.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.terraformResolver = void 0;
+const path = __importStar(require("path"));
+/** `module.M:file` / `module.M:var.X` / `module.M:output.X` / `module.M:remote-output.X` — extractor-emitted scoped refs. */
+const SCOPED_REF = /^module\.([^.:\s]+):(file$|var\.|output\.|remote-output\.)/;
+exports.terraformResolver = {
+    name: 'terraform',
+    languages: ['terraform'],
+    detect(context) {
+        return context.getAllFiles().some((f) => f.endsWith('.tf') || f.endsWith('.tfvars') || f.endsWith('.tofu'));
+    },
+    // Scoped refs name no declared symbol; opt them through the resolver's
+    // name-exists pre-filter so they reach resolve() at all.
+    claimsReference(name) {
+        return SCOPED_REF.test(name);
+    },
+    resolve(ref, context) {
+        if (ref.language !== 'terraform')
+            return null;
+        const qname = ref.referenceName;
+        const refDir = dirOf(ref.filePath);
+        // --- module-boundary bridge: module.M:file / module.M:var.X / module.M:output.X ---
+        const scoped = qname.match(/^module\.([^.:\s]+):(.+)$/);
+        if (scoped) {
+            return resolveScopedModuleRef(ref, scoped[1], scoped[2], refDir, context);
+        }
+        const candidates = context.getNodesByQualifiedName(qname);
+        if (candidates.length === 0)
+            return null;
+        // 1. Same directory — the only scope Terraform can actually reference.
+        const sameDir = candidates.filter((c) => dirOf(c.filePath) === refDir);
+        if (sameDir.length > 0) {
+            return {
+                original: ref,
+                targetNodeId: sameDir[0].id,
+                confidence: 0.95,
+                resolvedBy: 'framework',
+            };
+        }
+        // 2. `.tfvars` assignments set ROOT module variables, and var-files are
+        //    routinely kept in a subdirectory (`envs/prod.tfvars`). Walk up to
+        //    the nearest ancestor directory that declares the variable.
+        if (ref.filePath.endsWith('.tfvars') && qname.startsWith('var.')) {
+            const up = nearestAncestorMatch(candidates, refDir);
+            if (up) {
+                return { original: ref, targetNodeId: up.id, confidence: 0.9, resolvedBy: 'framework' };
+            }
+        }
+        // 2b. Provider configurations are the one construct Terraform inherits
+        //     across the module tree: they're declared in the root (or a parent)
+        //     module and passed down, so `provider = aws.east` inside a child
+        //     module legitimately names a configuration declared above it.
+        if (qname.startsWith('provider.')) {
+            const configs = candidates.filter((c) => c.kind === 'namespace');
+            const up = nearestAncestorMatch(configs, refDir);
+            if (up) {
+                return { original: ref, targetNodeId: up.id, confidence: 0.9, resolvedBy: 'framework' };
+            }
+            return null;
+        }
+        // 3. No same-directory declaration → no edge. A candidate in another
+        //    module directory is never the real target (cross-module access only
+        //    exists through module.M inputs/outputs, bridged above), and a wrong
+        //    edge is worse than none.
+        return null;
+    },
+};
+/** Nearest candidate walking UP the directory tree from refDir (exclusive). */
+function nearestAncestorMatch(candidates, refDir) {
+    for (let dir = parentOf(refDir); dir !== null; dir = parentOf(dir)) {
+        const inDir = candidates.filter((c) => dirOf(c.filePath) === dir);
+        if (inDir.length > 0)
+            return inDir[0];
+    }
+    return null;
+}
+/**
+ * Resolve `module.M:<child>` by locating the `module "M"` declaration in the
+ * reference's own directory, reading its `source` attribute, and looking the
+ * child symbol up inside that directory.
+ */
+function resolveScopedModuleRef(ref, moduleName, child, refDir, context) {
+    const decls = context
+        .getNodesByQualifiedName(`module.${moduleName}`)
+        .filter((n) => n.kind === 'module');
+    if (decls.length === 0)
+        return null;
+    // Terraform scoping: the declaration lives in the reference's directory.
+    const decl = decls.find((d) => dirOf(d.filePath) === refDir) ?? (decls.length === 1 ? decls[0] : null);
+    if (!decl)
+        return null;
+    const source = readModuleAttr(decl, 'source', context);
+    if (!source)
+        return null;
+    // --- cloudposse/atmos remote-state: module.M.outputs.X where M is the
+    // stack-config remote-state module reading another COMPONENT's state. The
+    // component name is static in the monorepo case (`component = "vpc"` or
+    // "eks/cluster"), so bridge to that component directory's own
+    // `output "X"` — but only when every gate holds: the module source is the
+    // remote-state module, the component is a string literal, and exactly ONE
+    // directory in the repo matches the component name and declares that
+    // output. Anything dynamic or ambiguous stays a visible boundary.
+    if (child.startsWith('remote-output.')) {
+        if (!/\/remote-state(\/|$)/.test(source))
+            return null;
+        let component = readModuleAttr(decl, 'component', context);
+        if (!component) {
+            // The other half of real-world declarations indirect through a
+            // variable with a literal default in the same directory
+            // (`component = var.vpc_component_name` + `default = "vpc"`) — the
+            // component's declared static wiring. One hop, same literal gate.
+            const viaVar = readNodeSpanMatch(decl, /^\s*component\s*=\s*var\.([A-Za-z0-9_-]+)\s*$/, context);
+            if (viaVar) {
+                const declared = context
+                    .getNodesByQualifiedName(`var.${viaVar}`)
+                    .filter((n) => dirOf(n.filePath) === dirOf(decl.filePath));
+                if (declared.length === 1) {
+                    component = readNodeSpanMatch(declared[0], /^\s*default\s*=\s*"([^"]+)"/, context);
+                }
+            }
+        }
+        if (!component)
+            return null;
+        const outName = child.slice('remote-output.'.length);
+        const outs = context
+            .getNodesByQualifiedName(`output.${outName}`)
+            .filter((o) => {
+            const d = dirOf(o.filePath);
+            return d === component || d.endsWith('/' + component);
+        });
+        if (outs.length === 0)
+            return null;
+        const dirs = new Set(outs.map((o) => dirOf(o.filePath)));
+        if (dirs.size > 1)
+            return null; // two directories claim this component name — never guess
+        return { original: ref, targetNodeId: outs[0].id, confidence: 0.9, resolvedBy: 'framework' };
+    }
+    if (!(source.startsWith('./') || source.startsWith('../'))) {
+        // Registry / git / absolute sources are out-of-repo: stay unresolved.
+        return null;
+    }
+    const targetDir = normalizeRel(joinDirs(dirOf(decl.filePath), source));
+    if (child === 'file') {
+        const tfFiles = context
+            .getAllFiles()
+            .filter((f) => dirOf(f) === targetDir && (f.endsWith('.tf') || f.endsWith('.tofu')))
+            .sort();
+        if (tfFiles.length === 0)
+            return null;
+        const entry = tfFiles.find((f) => f.endsWith('/main.tf') || f === 'main.tf') ?? tfFiles[0];
+        const fileNode = context.getNodesInFile(entry).find((n) => n.kind === 'file');
+        if (!fileNode)
+            return null;
+        return { original: ref, targetNodeId: fileNode.id, confidence: 0.95, resolvedBy: 'framework' };
+    }
+    // child is `var.X` or `output.X` — the child module's own qualified names.
+    const target = context
+        .getNodesByQualifiedName(child)
+        .filter((c) => dirOf(c.filePath) === targetDir);
+    if (target.length === 0)
+        return null;
+    return { original: ref, targetNodeId: target[0].id, confidence: 0.95, resolvedBy: 'framework' };
+}
+/**
+ * A direct string-literal attribute (`source = "…"`, `component = "…"`) of a
+ * module declaration, re-read from its file (project paths are stored
+ * relative; node metadata isn't persisted, so the declaration's line span +
+ * cached file lines are the durable carrier). Non-literal values (variables,
+ * expressions) return null — dynamic wiring is never guessed.
+ */
+function readModuleAttr(decl, name, context) {
+    return readNodeSpanMatch(decl, new RegExp(`^\\s*${name}\\s*=\\s*"([^"]+)"`), context);
+}
+/** First capture of `re` across the node's line span, or null. */
+function readNodeSpanMatch(node, re, context) {
+    const lines = context.getFileLines?.(node.filePath) ?? context.readFile(node.filePath)?.split('\n') ?? null;
+    if (!lines)
+        return null;
+    const end = Math.min(node.endLine, lines.length);
+    for (let i = Math.max(node.startLine - 1, 0); i < end; i++) {
+        const m = lines[i].match(re);
+        if (m)
+            return m[1];
+    }
+    return null;
+}
+/** Directory of a stored (forward-slash, project-relative) path. */
+function dirOf(p) {
+    const d = path.dirname(p);
+    return d === '' ? '.' : d;
+}
+/** Parent directory, or null above the project root. */
+function parentOf(dir) {
+    if (dir === '.' || dir === '')
+        return null;
+    const parent = path.dirname(dir);
+    return parent === dir ? null : parent;
+}
+/** Join a base directory with a `./`/`../` relative source path. */
+function joinDirs(base, rel) {
+    return path.join(base === '.' ? '' : base, rel);
+}
+/** Normalize to the stored path shape: forward slashes, '.' for the root. */
+function normalizeRel(p) {
+    const n = path.normalize(p).replace(/\\/g, '/').replace(/\/+$/, '');
+    return n === '' ? '.' : n;
+}
+//# sourceMappingURL=terraform.js.map

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

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

package/dist/resolution/frameworks/vue-router.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Vue Router — routes declared in a config object, navigation often by NAME.
+ *
+ * `frameworks/vue.ts` reads Nuxt's file convention (`pages/about.vue` is
+ * `/about`), which is half the Vue world. The other half — every plain Vue 3
+ * app — declares its routes in one object:
+ *
+ *   const router = createRouter({
+ *     history: createWebHistory(),
+ *     routes: [
+ *       { name: 'login',   path: '/login',             component: () => import('@/views/Login') },
+ *       { name: 'profile', path: '/profile/:username', component: Profile },
+ *     ],
+ *   })
+ *
+ * `extract()` reads that array into one `route` node per entry, named by its
+ * path the way every other framework's routes are, bound to the component it
+ * names — an identifier, or the last segment of a lazy `() => import(…)`,
+ * which is the `.vue` file's own name.
+ *
+ * **Navigation is usually a name, not a path.** This is what makes Vue
+ * different from React Router and Next.js, where the destination is always a
+ * URL:
+ *
+ *   router.push({ name: 'login' })        // by name — the common idiom
+ *   router.push('/')                      // by path
+ *   router.push({ path: '/', query })     // by path, with extras
+ *   navigateTo('/dashboard')              // Nuxt
+ *
+ * So `resolve()` reads the argument as a name FIRST and falls back to the
+ * path readers every other framework shares. A route's name lives only in the
+ * source — node metadata is not persisted — so the table re-reads the config
+ * files its own route nodes came from, with the same parser `extract` used.
+ * `<router-link to>` / `<RouterLink to>` / `<NuxtLink to>` are markup rather
+ * than calls, so a synthesizer reads them (`vue-router-synthesizer.ts`).
+ *
+ * Left unresolved rather than guessed: a computed destination
+ * (`router.push(postAuthRoute.value)`), a name or path nothing declares, and
+ * a nested `children:` route, whose path is relative to its parent.
+ */
+import type { Node } from '../../types';
+import type { FrameworkResolver, ResolutionContext } from '../types';
+import { type HrefLiteral, type RootedRouteTable, type RouteTable } from './expo-router';
+export interface VueRouteEntry {
+    /** `/profile/:username` — the path, in the form every other framework's routes use. */
+    path: string;
+    /** `profile` — what `router.push({ name })` names, when the entry has one. */
+    name: string | null;
+    /** The component the entry names, by identifier or by the tail of its lazy import. */
+    component: string | null;
+    line: number;
+}
+/**
+ * Every top-level entry of a `routes: [...]` array.
+ *
+ * The array is walked, not pattern-matched: a `name` is written ABOVE the
+ * `path` it belongs to, so reading fields out of a window around each `path`
+ * hands an entry its PREDECESSOR's name — vue-realworld's `login` came out as
+ * `/register`, silently, for every route in the file. So each top-level `{…}`
+ * is matched as a unit and only its own depth-1 fields are read; a nested
+ * `children:` array, a `meta: {…}` and a lazy `component: () => import(…)`
+ * are stepped over rather than searched.
+ *
+ * An entry whose path does not start with `/` is a child route, relative to a
+ * parent this does not compose, and is not a destination on its own.
+ */
+export declare function parseVueRoutes(content: string): VueRouteEntry[];
+/** One app's routes, by path and — Vue's own idiom — by name. */
+export interface VueAppRoutes extends RouteTable {
+    /** `login` → the route node, for `router.push({ name: 'login' })`. */
+    byName: Map<string, Node>;
+}
+export type VueRouteTable = RootedRouteTable<VueAppRoutes>;
+export declare function vueRouteTable(context: ResolutionContext): VueRouteTable;
+/** The verb a navigation call name stands for, or null. */
+export declare function vueNavVerb(name: string): string | null;
+/** The route name in a `{ name: 'login' }` destination, or null for anything else. */
+export declare function routeNameInExpression(expr: string): string | null;
+/** `{ path: '/', query }` — Vue's object destination, whose key is `path`, not `pathname`. */
+export declare function parseVuePathObject(expr: string): HrefLiteral | null;
+export declare const vueRouterResolver: FrameworkResolver;
+//# sourceMappingURL=vue-router.d.ts.map

package/dist/resolution/frameworks/vue-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-router.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/vue-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,EAAY,IAAI,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAEV,iBAAiB,EACjB,iBAAiB,EAGlB,MAAM,UAAU,CAAC;AAIlB,OAAO,EASL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AASvB,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sFAAsF;IACtF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAgC/D;AAyBD,iEAAiE;AACjE,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,sEAAsE;IACtE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;AAkB3D,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAuCvE;AAeD,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAItD;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMjE;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMnE;AA2BD,eAAO,MAAM,iBAAiB,EAAE,iBA0H/B,CAAC"}