@vizalice/codegraph 1.5.0

package/dist/resolution/frameworks/swift-objc.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Swift ↔ Objective-C bridge resolver.
+ *
+ * Closes the cross-language flow gap in mixed iOS codebases. The pure
+ * bridging name math lives in `../swift-objc-bridge.ts`; this file wires
+ * it into the resolution pipeline.
+ *
+ * **Two directions to close:**
+ *
+ * 1. **Swift call → ObjC method** — A Swift caller writes
+ *    `imageDownloader.download(url:completion:)`. Tree-sitter-swift parses
+ *    this as a call_expression whose callee identifier is `download`
+ *    (parameter labels live in the argument list, not the callee). The
+ *    name-matcher tries to find any node named `download` and fails (no
+ *    Swift method by that name in this project; the ObjC implementation is
+ *    `-downloadURL:completion:`). We catch it here: from the bare Swift
+ *    name `download`, look up ObjC methods whose bridged Swift base name
+ *    would be `download` (using `swiftBaseNamesForObjcSelector`'s reverse
+ *    map, precomputed once per session).
+ *
+ * 2. **ObjC call → Swift method** — An ObjC caller writes
+ *    `[swiftThing fooWithBar:42]`. Tree-sitter-objc parses this as a
+ *    message_expression with selector `fooWithBar:` (after the multi-
+ *    keyword fix in this branch). The name-matcher tries to find a node
+ *    named `fooWithBar:` — no Swift node has colons in its name, so it
+ *    fails. We catch it: from the ObjC selector, derive candidate Swift
+ *    base names (`['fooWithBar', 'foo']`), and look up Swift methods
+ *    named those.
+ *
+ * **Provenance:** every edge produced here is recorded as a framework-
+ * resolved reference (`resolvedBy: 'framework'`) with `confidence: 0.7`
+ * (matches the django ORM dynamic-dispatch precedent — not exact, but
+ * deterministic from the bridging rule).
+ */
+import { FrameworkResolver } from '../types';
+export declare const swiftObjcBridgeResolver: FrameworkResolver;
+//# sourceMappingURL=swift-objc.d.ts.map

package/dist/resolution/frameworks/swift-objc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swift-objc.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/swift-objc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAE,iBAAiB,EAAiD,MAAM,UAAU,CAAC;AAqN5F,eAAO,MAAM,uBAAuB,EAAE,iBAmDrC,CAAC"}

package/dist/resolution/frameworks/swift-objc.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swiftObjcBridgeResolver = void 0;
+const swift_objc_bridge_1 = require("../swift-objc-bridge");
+/**
+ * Memoized "Swift base name → ObjC method nodes" map.
+ *
+ * Built lazily on first `resolve()` per resolver instance — the resolver is
+ * recreated when the index is rebuilt, so this naturally invalidates with
+ * the graph. Keyed by ResolutionContext identity so multiple projects sharing
+ * a process (the daemon) don't bleed maps between them.
+ */
+const objcByCandidateSwiftBase = new WeakMap();
+/**
+ * Build the reverse-bridge map: for every ObjC method node in the graph,
+ * compute the Swift base names that would auto-bridge to its selector and
+ * record the node under each.
+ *
+ * Runs once per resolver lifetime; the cost scales linearly with the count
+ * of ObjC method nodes. On Wikipedia-iOS (~2500 files, ~25k ObjC methods)
+ * this is a few hundred ms — much cheaper than re-parsing source on each
+ * unresolved ref.
+ */
+/**
+ * Names that are too generic to bridge with any precision. These are common
+ * Cocoa / NSObject conventions that almost every ObjC class implements; if a
+ * Swift caller writes `init()` or `description`, mapping it to an arbitrary
+ * project-local ObjC method of the same name produces noise, not signal.
+ *
+ * Critically, refs of these names virtually always resolve via the regular
+ * name-matcher (every project has many `init` nodes) — skipping them here
+ * just keeps the bridge from competing with name-match on already-handled
+ * refs.
+ */
+const GENERIC_NAMES = new Set([
+    'init',
+    'description',
+    'debugDescription',
+    'hash',
+    'isEqual',
+    'isEqualTo',
+    'copy',
+    'mutableCopy',
+    'class',
+    'self',
+    'count',
+    'length',
+    'value',
+    'name',
+    'data',
+    'string',
+    'object',
+    'add',
+    'remove',
+    'update',
+    'load',
+    'save',
+    'reload',
+    'cancel',
+    'start',
+    'stop',
+    'pause',
+    'resume',
+    'close',
+    'open',
+    'show',
+    'hide',
+    'toString',
+    'dealloc',
+    'release',
+    'retain',
+    'autorelease',
+]);
+function buildObjcMap(context) {
+    const cached = objcByCandidateSwiftBase.get(context);
+    if (cached)
+        return cached;
+    const map = new Map();
+    const objcMethods = context
+        .getNodesByKind('method')
+        .filter((n) => n.language === 'objc');
+    for (const node of objcMethods) {
+        const candidates = (0, swift_objc_bridge_1.swiftBaseNamesForObjcSelector)(node.name);
+        for (const c of candidates) {
+            // Skip the trivial case where the Swift base name equals the ObjC
+            // method name verbatim (no colons) — the regular name-matcher
+            // already handles that and our map would just duplicate the work.
+            if (c === node.name && !node.name.includes(':'))
+                continue;
+            // Skip generic Cocoa names (init, description, etc.) — they would
+            // false-positive against any project-local ObjC method of the same
+            // name. The regular name-matcher handles them.
+            if (GENERIC_NAMES.has(c))
+                continue;
+            const arr = map.get(c);
+            if (arr)
+                arr.push(node);
+            else
+                map.set(c, [node]);
+        }
+    }
+    objcByCandidateSwiftBase.set(context, map);
+    return map;
+}
+/**
+ * Window of source text around a Swift declaration used by `isObjcExposed`
+ * to spot `@objc` / `@nonobjc` annotations. Read line above + the
+ * declaration line — Swift attributes typically sit on the preceding line
+ * (`@objc` on a line of its own) or inline.
+ */
+const SOURCE_PROBE_LINES = 3;
+/**
+ * Read a small window of source ending at `node.startLine`, used to
+ * inspect Swift attribute annotations attached to a declaration. Returns
+ * an empty string if the source can't be read.
+ */
+function declarationSourceWindow(node, context) {
+    const content = context.readFile(node.filePath);
+    if (!content)
+        return '';
+    const lines = content.split(/\r?\n/);
+    const startIdx = Math.max(0, node.startLine - 1 - SOURCE_PROBE_LINES);
+    const endIdx = Math.min(lines.length, node.startLine);
+    return lines.slice(startIdx, endIdx).join('\n');
+}
+/**
+ * Try to resolve a Swift caller's bare reference to an ObjC implementation.
+ *
+ * Strategy: look up the ObjC reverse-bridge map for nodes whose Swift base
+ * name would match. Return the first match (matches the existing
+ * single-target resolution contract).
+ */
+function resolveSwiftCallToObjc(ref, context) {
+    // Swift call sites of `obj.foo(bar:)` reach the resolver as either bare
+    // name `foo` (tree-sitter-swift) or qualified `obj.foo` — strip prefix.
+    const rawName = ref.referenceName.includes('.')
+        ? ref.referenceName.slice(ref.referenceName.lastIndexOf('.') + 1)
+        : ref.referenceName;
+    const map = buildObjcMap(context);
+    const candidates = map.get(rawName);
+    if (!candidates || candidates.length === 0)
+        return null;
+    // Prefer ObjC methods whose corresponding Swift declaration isn't itself
+    // present (so we don't wrongly redirect a Swift call to ObjC when a Swift
+    // method of the same name is the real target — that's the in-language case
+    // and should already be resolved by the name-matcher). Since this resolver
+    // runs AFTER exact-match, any matching Swift node would already have won;
+    // so a candidate reaching us is a legitimate cross-language hit.
+    const target = candidates[0];
+    if (!target)
+        return null;
+    return {
+        original: ref,
+        targetNodeId: target.id,
+        confidence: 0.6,
+        resolvedBy: 'framework',
+    };
+}
+/**
+ * Try to resolve an ObjC caller's selector reference to a Swift `@objc`
+ * implementation.
+ *
+ * Strategy: derive candidate Swift base names from the selector via
+ * `swiftBaseNamesForObjcSelector`. For each, look up Swift methods named
+ * that and verify with a source-window check that the declaration is
+ * `@objc`-exposed (filters out false matches where a Swift function
+ * happens to share the name but isn't bridged).
+ */
+function resolveObjcCallToSwift(ref, context) {
+    // ObjC call sites get receiver-prefixed when the receiver isn't self/super
+    // (see tree-sitter.ts message_expression handling): `[obj foo:bar:]`
+    // becomes `obj.foo:bar:`. Strip the receiver prefix to recover the raw
+    // selector for the bridge math.
+    const rawSelector = ref.referenceName.includes('.')
+        ? ref.referenceName.slice(ref.referenceName.lastIndexOf('.') + 1)
+        : ref.referenceName;
+    // Bridge math only applies to selector-shape names (contain `:`).
+    if (!rawSelector.includes(':'))
+        return null;
+    const candidates = (0, swift_objc_bridge_1.swiftBaseNamesForObjcSelector)(rawSelector);
+    for (const candidate of candidates) {
+        const matches = context
+            .getNodesByName(candidate)
+            .filter((n) => n.language === 'swift' && (n.kind === 'method' || n.kind === 'function'));
+        for (const match of matches) {
+            const window = declarationSourceWindow(match, context);
+            if ((0, swift_objc_bridge_1.isObjcExposed)(window)) {
+                return {
+                    original: ref,
+                    targetNodeId: match.id,
+                    confidence: 0.6,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+    }
+    return null;
+}
+exports.swiftObjcBridgeResolver = {
+    name: 'swift-objc-bridge',
+    // Applies to both languages — bridging crosses the boundary.
+    languages: ['swift', 'objc'],
+    /**
+     * Detect: this resolver is relevant when the project has both Swift and
+     * Objective-C source. Either-side-only projects don't need bridging
+     * (and the empty reverse-map would be a no-op anyway).
+     */
+    detect(context) {
+        const files = context.getAllFiles();
+        let hasSwift = false;
+        let hasObjc = false;
+        for (const f of files) {
+            if (f.endsWith('.swift'))
+                hasSwift = true;
+            else if (f.endsWith('.m') || f.endsWith('.mm'))
+                hasObjc = true;
+            if (hasSwift && hasObjc)
+                return true;
+        }
+        return false;
+    },
+    /**
+     * Let selector-shape references (anything containing a `:`) through the
+     * resolver's name-exists pre-filter — no Swift node has a colon in its
+     * name, so without this opt-in those refs would be dropped before
+     * `resolve()` sees them. Also opt-in `setX:`-style names that aren't
+     * otherwise declared symbols, in case the Swift side is a property.
+     */
+    claimsReference(name) {
+        if (name.includes(':'))
+            return true;
+        // Bare names without colons are handled by the regular name-exists
+        // pre-filter — no need to opt them in here.
+        return false;
+    },
+    /**
+     * Route based on which language the caller is in. The two directions are
+     * symmetric in shape but very different in implementation (forward
+     * direction uses the precomputed reverse-bridge map; reverse direction
+     * uses the deterministic name-derivation).
+     */
+    resolve(ref, context) {
+        if (ref.language === 'swift') {
+            return resolveSwiftCallToObjc(ref, context);
+        }
+        if (ref.language === 'objc') {
+            return resolveObjcCallToSwift(ref, context);
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=swift-objc.js.map

package/dist/resolution/frameworks/swift-objc.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * Swift Framework Resolver
+ *
+ * Handles SwiftUI, UIKit, and Vapor (server-side Swift) patterns.
+ */
+import { FrameworkResolver } from '../types';
+export declare const swiftUIResolver: FrameworkResolver;
+export declare const uikitResolver: FrameworkResolver;
+export declare const vaporResolver: FrameworkResolver;
+//# sourceMappingURL=swift.d.ts.map

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

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