codegraph-java 0.1.0

package/dist/resolution/synth-utils.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Small helpers the dynamic-edge synthesizers share: a per-match line
+ * resolver over one source string, and "the function this line is in".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FN_KINDS = void 0;
+exports.makeLineAt = makeLineAt;
+exports.enclosingFn = enclosingFn;
+exports.enclosingValue = enclosingValue;
+/** The kinds a call site can be attributed to. */
+exports.FN_KINDS = new Set(['method', 'function', 'component']);
+/**
+ * Per-match line resolver over `src`, 1-based at `baseLine`. The inline
+ * `src.slice(0, idx).split('\n').length` idiom is O(source-length) PER MATCH,
+ * which goes quadratic on a match-dense source (a generated function full of
+ * `.push(` calls re-scanned tens of thousands of times was most of the #1235
+ * indexing wedge). Builds the newline index once — lazily, since most sources
+ * never produce a match — then answers each call with a binary search.
+ */
+function makeLineAt(src, baseLine) {
+    let nl = null;
+    return (idx) => {
+        if (!nl) {
+            nl = [];
+            for (let i = src.indexOf('\n'); i !== -1; i = src.indexOf('\n', i + 1))
+                nl.push(i);
+        }
+        // Count newlines strictly before idx.
+        let lo = 0;
+        let hi = nl.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if (nl[mid] < idx)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        return baseLine + lo;
+    };
+}
+/** Innermost function/method node whose line range contains `line`. */
+function enclosingFn(nodesInFile, line) {
+    let best = null;
+    for (const n of nodesInFile) {
+        if (!exports.FN_KINDS.has(n.kind))
+            continue;
+        const end = n.endLine ?? n.startLine;
+        if (n.startLine <= line && end >= line) {
+            if (!best || n.startLine >= best.startLine)
+                best = n; // prefer the tightest (latest-starting) encloser
+        }
+    }
+    return best;
+}
+/**
+ * The smallest `constant` / `variable` node whose lines contain `line` — the
+ * value a top-level registration is written inside (`const worker = new
+ * Worker('q', async (job) => …)`): what a caller imports and a walk can start
+ * from when no function encloses the site.
+ */
+function enclosingValue(nodesInFile, line) {
+    let best = null;
+    for (const n of nodesInFile) {
+        if (n.kind !== 'constant' && n.kind !== 'variable')
+            continue;
+        const end = n.endLine ?? n.startLine;
+        if (n.startLine <= line && end >= line) {
+            if (!best || n.startLine >= best.startLine)
+                best = n;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=synth-utils.js.map

package/dist/resolution/synth-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synth-utils.js","sourceRoot":"","sources":["../../src/resolution/synth-utils.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAeH,gCAiBC;AAGD,kCAUC;AAQD,wCAUC;AA3DD,kDAAkD;AACrC,QAAA,QAAQ,GAAwB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAE1F;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,GAAW,EAAE,QAAgB;IACtD,IAAI,EAAE,GAAoB,IAAI,CAAC;IAC/B,OAAO,CAAC,GAAW,EAAE,EAAE;QACrB,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,EAAE,GAAG,EAAE,CAAC;YACR,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;gBAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,sCAAsC;QACtC,IAAI,EAAE,GAAG,CAAC,CAAC;QACX,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,GAAG,CAAE,GAAG,GAAG;gBAAE,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;;gBAC5B,EAAE,GAAG,GAAG,CAAC;QAChB,CAAC;QACD,OAAO,QAAQ,GAAG,EAAE,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,SAAgB,WAAW,CAAC,WAA4B,EAAE,IAAY;IACpE,IAAI,IAAI,GAAgB,IAAI,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QACpC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,CAAC;QACrC,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS;gBAAE,IAAI,GAAG,CAAC,CAAC,CAAC,iDAAiD;QACzG,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,WAA4B,EAAE,IAAY;IACvE,IAAI,IAAI,GAAgB,IAAI,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QAC7D,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,CAAC;QACrC,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS;gBAAE,IAAI,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/resolution/tanstack-router-synthesizer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * TanStack Router — navigation written as markup.
+ *
+ *   <Link to="/dashboard/invoices/$invoiceId" params={{ invoiceId: 3 }}>…</Link>
+ *   <Link to="/login">Sign in</Link>
+ *   <Navigate to="/dashboard" />
+ *
+ * A JSX attribute is not a call, so the extractor records no reference for it
+ * and the resolver in `frameworks/tanstack-router.ts` — which binds
+ * `navigate({ to })` and `redirect({ to })` — never sees it. This pass reads
+ * every `to` out of the source, attributes it to the component (the innermost
+ * function) it is written in, matches it against the TanStack route table, and
+ * synthesizes one `navigates` edge from the component to the route.
+ *
+ * What makes this different from React Router's identical-looking `<Link to>`:
+ * TanStack's `to` is the route PATTERN and the values ride beside it in
+ * `params`, so `to="/posts/$postId"` names the route rather than an address —
+ * and it is normalised the same way a route name is instead of being read as a
+ * URL. A `<Link from=…>` with no `to` is a relative link within the route it
+ * is already on, and names no destination of its own.
+ *
+ * Edges are `provenance:'heuristic'`, `synthesizedBy:'tanstack-link'`, with the
+ * destination as written and `registeredAt` = the JSX site. A computed `to` is
+ * nothing; a pattern no route serves is nothing. Nothing here runs on a project
+ * with no TanStack routes.
+ */
+import type { Edge } from '../types';
+import type { ResolutionContext } from './types';
+import type { MaybeYield } from './cooperative-yield';
+export declare function tanstackLinkEdges(ctx: ResolutionContext, onYield: MaybeYield): Promise<Edge[]>;
+//# sourceMappingURL=tanstack-router-synthesizer.d.ts.map

package/dist/resolution/tanstack-router-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-router-synthesizer.d.ts","sourceRoot":"","sources":["../../src/resolution/tanstack-router-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmBtD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CA2DpG"}

package/dist/resolution/tanstack-router-synthesizer.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * TanStack Router — navigation written as markup.
+ *
+ *   <Link to="/dashboard/invoices/$invoiceId" params={{ invoiceId: 3 }}>…</Link>
+ *   <Link to="/login">Sign in</Link>
+ *   <Navigate to="/dashboard" />
+ *
+ * A JSX attribute is not a call, so the extractor records no reference for it
+ * and the resolver in `frameworks/tanstack-router.ts` — which binds
+ * `navigate({ to })` and `redirect({ to })` — never sees it. This pass reads
+ * every `to` out of the source, attributes it to the component (the innermost
+ * function) it is written in, matches it against the TanStack route table, and
+ * synthesizes one `navigates` edge from the component to the route.
+ *
+ * What makes this different from React Router's identical-looking `<Link to>`:
+ * TanStack's `to` is the route PATTERN and the values ride beside it in
+ * `params`, so `to="/posts/$postId"` names the route rather than an address —
+ * and it is normalised the same way a route name is instead of being read as a
+ * URL. A `<Link from=…>` with no `to` is a relative link within the route it
+ * is already on, and names no destination of its own.
+ *
+ * Edges are `provenance:'heuristic'`, `synthesizedBy:'tanstack-link'`, with the
+ * destination as written and `registeredAt` = the JSX site. A computed `to` is
+ * nothing; a pattern no route serves is nothing. Nothing here runs on a project
+ * with no TanStack routes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tanstackLinkEdges = tanstackLinkEdges;
+const strip_comments_1 = require("./strip-comments");
+const query_utils_1 = require("../search/query-utils");
+const expo_router_1 = require("./frameworks/expo-router");
+const nextjs_1 = require("./frameworks/nextjs");
+const tanstack_router_1 = require("./frameworks/tanstack-router");
+const synth_utils_1 = require("./synth-utils");
+const JSX_FILE = /\.(?:[cm]?[jt]sx?)$/;
+/** `<Link … to=` / `<Navigate … to=`, the attribute anywhere in the tag. */
+const LINK_TAG = /<(Link|Navigate)\b([^>]*?)\bto\s*=\s*(?:"([^"]*)"|'([^']*)'|\{\s*)/g;
+/** A tag this pass could possibly match — the cheap prefilter. */
+const HAS_LINK_TAG = /<(?:Link|Navigate)\b/;
+/** Links a single component may carry before it is a navigation menu, not a decision. */
+const MAX_LINKS_PER_COMPONENT = 24;
+async function tanstackLinkEdges(ctx, onYield) {
+    const table = (0, tanstack_router_1.tanstackTable)(ctx);
+    if (table.byRoot.size === 0)
+        return [];
+    const edges = [];
+    const seen = new Set();
+    const perComponent = new Map();
+    let scanned = 0;
+    for (const file of ctx.getAllFiles()) {
+        if (!JSX_FILE.test(file) || (0, query_utils_1.isTestPath)(file))
+            continue;
+        const routes = (0, expo_router_1.routesForFile)(table, file);
+        if (!routes || routes.exact.size === 0)
+            continue;
+        if ((++scanned & 63) === 0)
+            await onYield();
+        const source = ctx.readFile(file);
+        if (!source || !HAS_LINK_TAG.test(source))
+            continue;
+        const safe = (0, strip_comments_1.stripCommentsForRegex)(source, 'typescript');
+        const nodes = ctx.getNodesInFile(file);
+        const lineOf = (0, synth_utils_1.makeLineAt)(safe, 1);
+        LINK_TAG.lastIndex = 0;
+        let m;
+        while ((m = LINK_TAG.exec(safe)) !== null) {
+            let literal = m[3] ?? m[4] ?? null;
+            if (literal === null) {
+                // `to={…}`: a string or a template.
+                const at = m.index + m[0].length;
+                const ch = safe[at];
+                if (ch === '"' || ch === "'" || ch === '`')
+                    literal = (0, expo_router_1.readStringAt)(safe, at);
+            }
+            if (literal === null)
+                continue;
+            const href = (0, tanstack_router_1.tanstackDestination)(JSON.stringify(literal));
+            if (!href)
+                continue;
+            const line = lineOf(m.index);
+            const component = (0, synth_utils_1.enclosingFn)(nodes, line);
+            if (!component)
+                continue;
+            // A destination written as a choice names one route per arm, and the
+            // user reaches every one of them — each is drawn.
+            for (const { node: route, href: arm } of (0, nextjs_1.destinationsForHref)(href, routes)) {
+                const key = `${component.id}>${route.id}`;
+                if (seen.has(key))
+                    continue;
+                const count = (perComponent.get(component.id) ?? 0) + 1;
+                perComponent.set(component.id, count);
+                if (count > MAX_LINKS_PER_COMPONENT)
+                    continue;
+                seen.add(key);
+                edges.push({
+                    source: component.id,
+                    target: route.id,
+                    kind: 'navigates',
+                    line,
+                    provenance: 'heuristic',
+                    metadata: {
+                        synthesizedBy: 'tanstack-link',
+                        href: arm.display,
+                        navMethod: m[1] === 'Navigate' ? 'navigate' : 'link',
+                        registeredAt: `${file}:${line}`,
+                    },
+                });
+            }
+        }
+    }
+    return edges;
+}
+//# sourceMappingURL=tanstack-router-synthesizer.js.map

package/dist/resolution/tanstack-router-synthesizer.js.map

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

package/dist/resolution/tier-synthesizer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Cross-tier channels — the web's equivalent of the React Native bridge.
+ *
+ * A web app is two programs that talk over a wire the graph cannot see: the
+ * page calls `fetch('/api/users', { method: 'POST' })` and the API's
+ * `app.post('/api/users', createUser)` answers; a service puts `'welcome'` on
+ * the `email` queue and a `@Process('welcome')` method picks it up; a
+ * gateway's `this.server.emit('message')` lands in the component that wrote
+ * `socket.on('message', …)`. Each hop is a string on both sides, which is the
+ * evidence that lets a synthesizer close it — exactly as the RN event channel
+ * pairs `sendEvent(withName: "x")` with `addListener('x')`.
+ *
+ * Three channels, one scan:
+ *
+ *  1. **`http-client`** — a literal path in a client call (`fetch`, `axios.post`,
+ *     `ky`, `got`, `$fetch`, `useFetch`, `useSWR`, or a project instance made by
+ *     `axios.create(…)` / `ky.extend(…)`) → the ONE route node `METHOD path` it
+ *     denotes. Template holes match a `:param`; a hole in front of the path
+ *     (`${API_URL}/users`) matches a route by its tail; a variable url, a path
+ *     no route serves, or a path two routes serve alike produce nothing.
+ *     Edge: enclosing function → route, `tier: 'client→server'`.
+ *  2. **`queue-job`** — `queue.add('job', …)` where the queue is named (`new
+ *     Queue('email')`, `@InjectQueue('email')`) → the `@Process('job')` method
+ *     of the `@Processor('email')` class, a WorkerHost's `process`, a
+ *     `new Worker('email', handler)`, or Bull's `queue.process('job', handler)`.
+ *  3. **`event-bus`** — `eventEmitter.emit('user.created')` → `@OnEvent('user.created')`
+ *     (globs honoured); and sockets in both directions: a client's
+ *     `socket.emit('x')` → the server's `@SubscribeMessage('x')` / `socket.on('x')`
+ *     (`tier: 'client→server'`), the server's `server.emit('x')` → the client's
+ *     `socket.on('x', …)` (`tier: 'server→client'`). The in-process
+ *     `.on('x', fn)` ↔ `.emit('x')` pairing stays the emitter pass's.
+ *
+ * Every edge is `kind: 'calls'`, `provenance: 'heuristic'`, and carries
+ * `synthesizedBy`, `channel` (`http` | `queue` | `event` | `socket`), the
+ * `tier` when the direction is known, the `event` / `queue` / `method` /
+ * `href` it was paired on, and `registeredAt` — the route registration, the
+ * decorator, the `.on` — so a reader can check the pairing. Fan-out is capped
+ * per event as the emitter pass caps it; an HTTP pairing needs no cap because
+ * it is exact. Test suites and generated files are never sources: a supertest
+ * call is the test's story, and forty of them would make the route a hub.
+ */
+import type { Edge } from '../types';
+import type { ResolutionContext } from './types';
+import type { MaybeYield } from './cooperative-yield';
+export declare const TIER_CLIENT_TO_SERVER = "client\u2192server";
+export declare const TIER_SERVER_TO_CLIENT = "server\u2192client";
+export declare function crossTierEdges(ctx: ResolutionContext, onYield: MaybeYield): Promise<Edge[]>;
+//# sourceMappingURL=tier-synthesizer.d.ts.map

package/dist/resolution/tier-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-synthesizer.d.ts","sourceRoot":"","sources":["../../src/resolution/tier-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAetD,eAAO,MAAM,qBAAqB,uBAAkB,CAAC;AACrD,eAAO,MAAM,qBAAqB,uBAAkB,CAAC;AAszBrD,wBAAsB,cAAc,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CA4DjG"}