@shrkcrft/graph 0.1.0-alpha.10

package/dist/indexer/extract-ruby-file.js

@@ -0,0 +1,151 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { EdgeKind } from "../schema/edge-kind.js";
+import { NodeKind } from "../schema/node-kind.js";
+export const EXTRACT_RUBY_FILE_SOURCE = 'extract-ruby-file@v1';
+/**
+ * Regex-based Ruby extractor.
+ *
+ * Top-level constructs only (column-0):
+ *   - `class Name` / `class Name < Base` → class symbol
+ *   - `module Name` → module symbol
+ *   - `def name` / `def self.name` → function symbol
+ *   - `NAME = …` (uppercase identifier) → const symbol
+ *
+ * Ruby has no public/private declarations at the top level — every
+ * top-level symbol is reachable. All emitted symbols have
+ * `isExported: true` for graph consumers; the `visibility` data field
+ * preserves the explicit modifier (`private` / `protected`) when one
+ * precedes the def, otherwise defaults to `export`.
+ *
+ * Imports: `require '...'`, `require_relative '...'`, `load '...'`.
+ * Specifiers are stored exactly as written, without quotes.
+ *
+ * Out of scope:
+ *   - Method-body inspection (visibility modifiers inside class bodies
+ *     toggle subsequent defs; we don't track that state here).
+ *   - Mixins (`include`, `extend`, `prepend`).
+ *   - Singleton classes / `class << self` blocks.
+ */
+export function extractRubyFile(fingerprint, absPath, content) {
+    const text = content ?? readFileSync(absPath, 'utf8');
+    const fileNode = makeFileNode(fingerprint);
+    const symbolNodes = [];
+    const edges = [];
+    const lines = text.split('\n');
+    for (let i = 0; i < lines.length; i += 1) {
+        const raw = lines[i];
+        if (raw.length === 0)
+            continue;
+        if (raw.startsWith(' ') || raw.startsWith('\t'))
+            continue;
+        const trimmed = raw.trimStart();
+        if (trimmed.startsWith('#'))
+            continue;
+        // class Name [< Base]
+        let m = /^class\s+([A-Z][\w:]*)/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1);
+            continue;
+        }
+        // module Name
+        m = /^module\s+([A-Z][\w:]*)/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'module', i + 1);
+            continue;
+        }
+        // def name / def self.name
+        m = /^def\s+(?:self\.)?([A-Za-z_][\w?!=]*)/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'function', i + 1);
+            continue;
+        }
+        // Top-level CONSTANT assignment.
+        m = /^([A-Z][A-Z0-9_]+)\s*=\s*/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'const', i + 1);
+        }
+    }
+    return {
+        fileNode,
+        symbolNodes,
+        edges,
+        rawImportSpecifiers: scanRubyImports(text),
+        importBindings: [],
+        identifierReferences: [],
+    };
+}
+function pushSymbol(fp, nodes, edges, fileId, name, declKind, line) {
+    const sym = {
+        id: `symbol:${fp.path}#${name}`,
+        kind: NodeKind.Symbol,
+        label: name,
+        path: fp.path,
+        line,
+        data: { declKind, visibility: 'export', isExported: true, language: 'ruby' },
+    };
+    nodes.push(sym);
+    edges.push({
+        id: createHash('sha1').update(`${fileId}|${sym.id}|${EdgeKind.DeclaresSymbol}`).digest('hex'),
+        from: fileId,
+        to: sym.id,
+        kind: EdgeKind.DeclaresSymbol,
+        source: EXTRACT_RUBY_FILE_SOURCE,
+        data: { visibility: 'export', declKind, line },
+    });
+}
+function makeFileNode(fp) {
+    const label = fp.path.split('/').pop() ?? fp.path;
+    const tags = ['ruby'];
+    if (isRubyTestPath(fp.path))
+        tags.push('test');
+    return {
+        id: fp.nodeId,
+        kind: NodeKind.File,
+        label,
+        path: fp.path,
+        tags,
+        data: {
+            language: 'ruby',
+            sizeBytes: fp.sizeBytes,
+            sha1: fp.sha1,
+            hasDefaultExport: false,
+            exportCount: 0,
+            localCount: 0,
+            reExportCount: 0,
+        },
+    };
+}
+function isRubyTestPath(rel) {
+    return (/(?:^|\/)(?:spec|test)\//.test(rel) ||
+        /(?:^|\/)[\w-]+_spec\.rb$/.test(rel) ||
+        /(?:^|\/)[\w-]+_test\.rb$/.test(rel));
+}
+function scanRubyImports(text) {
+    const out = [];
+    const re = /^\s*(?:require|require_relative|load|autoload)\s+(?:["']([^"']+)["']|:[A-Za-z_]\w*\s*,\s*["']([^"']+)["'])/gm;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const line = lineFromOffset(text, m.index);
+        const specifier = m[1] ?? m[2];
+        out.push({ specifier, line, kind: 'ruby-require' });
+    }
+    const seen = new Set();
+    const deduped = [];
+    for (const it of out) {
+        const k = `${it.specifier}|${it.line}`;
+        if (seen.has(k))
+            continue;
+        seen.add(k);
+        deduped.push(it);
+    }
+    return deduped;
+}
+function lineFromOffset(text, offset) {
+    let line = 1;
+    for (let i = 0; i < offset && i < text.length; i++) {
+        if (text.charCodeAt(i) === 10)
+            line += 1;
+    }
+    return line;
+}

package/dist/indexer/extract-rust-file.d.ts

@@ -0,0 +1,27 @@
+import type { IFileFingerprint } from '../schema/file-fingerprint.js';
+import type { IExtractedFile } from './extract-ts-file.js';
+export declare const EXTRACT_RUST_FILE_SOURCE = "extract-rust-file@v1";
+/**
+ * Regex-based Rust extractor.
+ *
+ * Top-level items only (column-0). Captured:
+ *   - `[pub] fn name`, `[pub] async fn name` → function
+ *   - `[pub] struct Name`, `[pub] enum Name`, `[pub] trait Name` → class-shaped
+ *   - `[pub] type Name = ...` → type-alias
+ *   - `[pub] const NAME: T = …`, `[pub] static NAME: T = …` → const
+ *   - `[pub] mod name { … }` → module
+ *
+ * Visibility is derived from the presence of a `pub` keyword (incl.
+ * `pub(crate)`, `pub(super)`, `pub(in path::to)`). Items with `pub` →
+ * `isExported: true`; everything else is local.
+ *
+ * Imports: `use a::b::{c, d};` → one specifier per fully-qualified
+ * path. `use a::b::*` is captured as `a::b::*`.
+ *
+ * Out of scope:
+ *   - `impl` blocks (members live inside; we don't walk bodies).
+ *   - Macros (`macro_rules!`), `cfg(...)`-gated items.
+ *   - Item-level attributes other than `pub`.
+ */
+export declare function extractRustFile(fingerprint: IFileFingerprint, absPath: string, content?: string): IExtractedFile;
+//# sourceMappingURL=extract-rust-file.d.ts.map

package/dist/indexer/extract-rust-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-rust-file.d.ts","sourceRoot":"","sources":["../../src/indexer/extract-rust-file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAsDhB"}

package/dist/indexer/extract-rust-file.js

@@ -0,0 +1,186 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { EdgeKind } from "../schema/edge-kind.js";
+import { NodeKind } from "../schema/node-kind.js";
+export const EXTRACT_RUST_FILE_SOURCE = 'extract-rust-file@v1';
+/**
+ * Regex-based Rust extractor.
+ *
+ * Top-level items only (column-0). Captured:
+ *   - `[pub] fn name`, `[pub] async fn name` → function
+ *   - `[pub] struct Name`, `[pub] enum Name`, `[pub] trait Name` → class-shaped
+ *   - `[pub] type Name = ...` → type-alias
+ *   - `[pub] const NAME: T = …`, `[pub] static NAME: T = …` → const
+ *   - `[pub] mod name { … }` → module
+ *
+ * Visibility is derived from the presence of a `pub` keyword (incl.
+ * `pub(crate)`, `pub(super)`, `pub(in path::to)`). Items with `pub` →
+ * `isExported: true`; everything else is local.
+ *
+ * Imports: `use a::b::{c, d};` → one specifier per fully-qualified
+ * path. `use a::b::*` is captured as `a::b::*`.
+ *
+ * Out of scope:
+ *   - `impl` blocks (members live inside; we don't walk bodies).
+ *   - Macros (`macro_rules!`), `cfg(...)`-gated items.
+ *   - Item-level attributes other than `pub`.
+ */
+export function extractRustFile(fingerprint, absPath, content) {
+    const text = content ?? readFileSync(absPath, 'utf8');
+    const fileNode = makeFileNode(fingerprint);
+    const symbolNodes = [];
+    const edges = [];
+    const lines = text.split('\n');
+    for (let i = 0; i < lines.length; i += 1) {
+        const raw = lines[i];
+        if (raw.length === 0)
+            continue;
+        if (raw.startsWith(' ') || raw.startsWith('\t'))
+            continue;
+        if (raw.trimStart().startsWith('//'))
+            continue;
+        // Strip a `pub` (with optional restricted `pub(crate)` style) plus
+        // any `async`/`unsafe`/`extern "C"` modifiers before the declaration
+        // keyword.
+        const pubMatch = /^(pub(?:\s*\([^)]+\))?\s+)?/.exec(raw);
+        const isExported = !!pubMatch[1];
+        const rest = raw.slice(pubMatch[0].length);
+        const trimmed = rest.replace(/^(?:async\s+|unsafe\s+|const\s+(?=fn\b)|extern(?:\s+"[^"]+")?\s+)+/, '');
+        let m = /^fn\s+([A-Za-z_][\w]*)\s*[<(]/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'function', i + 1, isExported);
+            continue;
+        }
+        m = /^(struct|enum|trait|union)\s+([A-Za-z_][\w]*)/.exec(trimmed);
+        if (m) {
+            const kind = m[1] === 'trait' ? 'interface' : 'class';
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[2], kind, i + 1, isExported);
+            continue;
+        }
+        m = /^type\s+([A-Za-z_][\w]*)\s*[=<]/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'type-alias', i + 1, isExported);
+            continue;
+        }
+        m = /^(?:const|static)\s+([A-Za-z_][\w]*)\s*:/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'const', i + 1, isExported);
+            continue;
+        }
+        m = /^mod\s+([A-Za-z_][\w]*)\s*[{;]/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'module', i + 1, isExported);
+        }
+    }
+    return {
+        fileNode,
+        symbolNodes,
+        edges,
+        rawImportSpecifiers: scanRustImports(text),
+        importBindings: [],
+        identifierReferences: [],
+    };
+}
+function pushSymbol(fp, nodes, edges, fileId, name, declKind, line, isExported) {
+    const sym = {
+        id: `symbol:${fp.path}#${name}`,
+        kind: NodeKind.Symbol,
+        label: name,
+        path: fp.path,
+        line,
+        data: { declKind, visibility: isExported ? 'export' : 'local', isExported, language: 'rust' },
+    };
+    nodes.push(sym);
+    edges.push({
+        id: createHash('sha1').update(`${fileId}|${sym.id}|${EdgeKind.DeclaresSymbol}`).digest('hex'),
+        from: fileId,
+        to: sym.id,
+        kind: EdgeKind.DeclaresSymbol,
+        source: EXTRACT_RUST_FILE_SOURCE,
+        data: { visibility: isExported ? 'export' : 'local', declKind, line },
+    });
+}
+function makeFileNode(fp) {
+    const label = fp.path.split('/').pop() ?? fp.path;
+    const tags = ['rust'];
+    if (isRustTestPath(fp.path))
+        tags.push('test');
+    return {
+        id: fp.nodeId,
+        kind: NodeKind.File,
+        label,
+        path: fp.path,
+        tags,
+        data: {
+            language: 'rust',
+            sizeBytes: fp.sizeBytes,
+            sha1: fp.sha1,
+            hasDefaultExport: false,
+            exportCount: 0,
+            localCount: 0,
+            reExportCount: 0,
+        },
+    };
+}
+function isRustTestPath(rel) {
+    return /(?:^|\/)tests\//.test(rel) || /(?:^|\/)[\w-]+_test\.rs$/.test(rel);
+}
+/**
+ * Parse `use` declarations. Supports:
+ *   - `use a::b::c;`
+ *   - `use a::b::{c, d, e as f};`
+ *   - `use a::b::*;`
+ *
+ * Each leaf in the brace group emits its own specifier with the prefix
+ * folded in. Aliases (`x as y`) are dropped — we keep the imported
+ * path.
+ */
+function scanRustImports(text) {
+    const out = [];
+    // Match `use <path>(::{...})?;` allowing newlines inside `{...}`.
+    const useRe = /^use\s+([\s\S]+?);/gm;
+    let m;
+    while ((m = useRe.exec(text)) !== null) {
+        // The greedy regex above would also match `use foo;\nuse bar;` as
+        // a single block. Detect that and bail.
+        const body = m[1];
+        if (body.startsWith('use'))
+            continue;
+        const line = lineFromOffset(text, m.index);
+        const brace = body.indexOf('::{');
+        if (brace < 0) {
+            // Strip optional `as Alias` and any whitespace.
+            const path = body.trim().split(/\s+as\s+/)[0].trim();
+            out.push({ specifier: path, line, kind: 'rust-use' });
+        }
+        else {
+            const prefix = body.slice(0, brace).trim();
+            const closeIdx = body.lastIndexOf('}');
+            const inside = body.slice(brace + 3, closeIdx >= 0 ? closeIdx : body.length);
+            for (const item of inside.split(',')) {
+                const cleaned = item.trim().split(/\s+as\s+/)[0].trim();
+                if (cleaned)
+                    out.push({ specifier: `${prefix}::${cleaned}`, line, kind: 'rust-use' });
+            }
+        }
+    }
+    // De-dupe.
+    const seen = new Set();
+    const deduped = [];
+    for (const it of out) {
+        const k = `${it.specifier}|${it.line}`;
+        if (seen.has(k))
+            continue;
+        seen.add(k);
+        deduped.push(it);
+    }
+    return deduped;
+}
+function lineFromOffset(text, offset) {
+    let line = 1;
+    for (let i = 0; i < offset && i < text.length; i++) {
+        if (text.charCodeAt(i) === 10)
+            line += 1;
+    }
+    return line;
+}

package/dist/indexer/extract-swift-file.d.ts

@@ -0,0 +1,27 @@
+import type { IFileFingerprint } from '../schema/file-fingerprint.js';
+import type { IExtractedFile } from './extract-ts-file.js';
+export declare const EXTRACT_SWIFT_FILE_SOURCE = "extract-swift-file@v1";
+/**
+ * Regex-based Swift extractor.
+ *
+ * Top-level declarations only (column-0). Detected:
+ *   - `[public|open|internal|fileprivate|private] [final] class Name`
+ *   - `struct Name`
+ *   - `enum Name`
+ *   - `protocol Name`
+ *   - `extension Name`
+ *   - `typealias Name = …`
+ *   - `func name(…)`
+ *
+ * Visibility: `public` / `open` → exported, otherwise local.
+ *
+ * Imports: `import Foundation`, `import struct CoreData.NSManagedObject`,
+ * `import class UIKit.UIView` (the second form names a kind + path —
+ * captured as the bare path).
+ *
+ * Out of scope:
+ *   - `@objc` / `@available` annotations.
+ *   - Class methods (the regex captures only column-0 funcs).
+ */
+export declare function extractSwiftFile(fingerprint: IFileFingerprint, absPath: string, content?: string): IExtractedFile;
+//# sourceMappingURL=extract-swift-file.d.ts.map

package/dist/indexer/extract-swift-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-swift-file.d.ts","sourceRoot":"","sources":["../../src/indexer/extract-swift-file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAqEhB"}

package/dist/indexer/extract-swift-file.js

@@ -0,0 +1,168 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { EdgeKind } from "../schema/edge-kind.js";
+import { NodeKind } from "../schema/node-kind.js";
+export const EXTRACT_SWIFT_FILE_SOURCE = 'extract-swift-file@v1';
+/**
+ * Regex-based Swift extractor.
+ *
+ * Top-level declarations only (column-0). Detected:
+ *   - `[public|open|internal|fileprivate|private] [final] class Name`
+ *   - `struct Name`
+ *   - `enum Name`
+ *   - `protocol Name`
+ *   - `extension Name`
+ *   - `typealias Name = …`
+ *   - `func name(…)`
+ *
+ * Visibility: `public` / `open` → exported, otherwise local.
+ *
+ * Imports: `import Foundation`, `import struct CoreData.NSManagedObject`,
+ * `import class UIKit.UIView` (the second form names a kind + path —
+ * captured as the bare path).
+ *
+ * Out of scope:
+ *   - `@objc` / `@available` annotations.
+ *   - Class methods (the regex captures only column-0 funcs).
+ */
+export function extractSwiftFile(fingerprint, absPath, content) {
+    const text = content ?? readFileSync(absPath, 'utf8');
+    const fileNode = makeFileNode(fingerprint);
+    const symbolNodes = [];
+    const edges = [];
+    const lines = text.split('\n');
+    for (let i = 0; i < lines.length; i += 1) {
+        const raw = lines[i];
+        if (raw.length === 0)
+            continue;
+        if (raw.startsWith(' ') || raw.startsWith('\t'))
+            continue;
+        const trimmed = raw.trimStart();
+        if (trimmed.startsWith('//') || trimmed.startsWith('/*'))
+            continue;
+        // Strip leading `@Annotation` style attributes.
+        const stripped = trimmed.replace(/^(?:@\w+(?:\([^)]*\))?\s+)+/, '');
+        const visMatch = /^(public|open|internal|fileprivate|private)\s+/.exec(stripped);
+        const isExported = !!visMatch && (visMatch[1] === 'public' || visMatch[1] === 'open');
+        // For visibility-less declarations, Swift defaults to `internal`
+        // (file-local for the module). Treat as local in graph terms.
+        const explicitlyExported = isExported;
+        const rest = visMatch ? stripped.slice(visMatch[0].length) : stripped;
+        const noModifiers = rest.replace(/^(?:final\s+|indirect\s+|dynamic\s+|static\s+|class\s+(?=func|var|let)|override\s+|mutating\s+|nonisolated\s+|isolated\s+|async\s+|throws\s+)+/, '');
+        let m = /^class\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1, explicitlyExported);
+            continue;
+        }
+        m = /^struct\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1, explicitlyExported);
+            continue;
+        }
+        m = /^enum\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'enum', i + 1, explicitlyExported);
+            continue;
+        }
+        m = /^protocol\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'interface', i + 1, explicitlyExported);
+            continue;
+        }
+        m = /^extension\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1, explicitlyExported);
+            continue;
+        }
+        m = /^typealias\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'type-alias', i + 1, explicitlyExported);
+            continue;
+        }
+        m = /^func\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'function', i + 1, explicitlyExported);
+        }
+    }
+    return {
+        fileNode,
+        symbolNodes,
+        edges,
+        rawImportSpecifiers: scanSwiftImports(text),
+        importBindings: [],
+        identifierReferences: [],
+    };
+}
+function pushSymbol(fp, nodes, edges, fileId, name, declKind, line, isExported) {
+    const sym = {
+        id: `symbol:${fp.path}#${name}`,
+        kind: NodeKind.Symbol,
+        label: name,
+        path: fp.path,
+        line,
+        data: { declKind, visibility: isExported ? 'export' : 'local', isExported, language: 'swift' },
+    };
+    nodes.push(sym);
+    edges.push({
+        id: createHash('sha1').update(`${fileId}|${sym.id}|${EdgeKind.DeclaresSymbol}`).digest('hex'),
+        from: fileId,
+        to: sym.id,
+        kind: EdgeKind.DeclaresSymbol,
+        source: EXTRACT_SWIFT_FILE_SOURCE,
+        data: { visibility: isExported ? 'export' : 'local', declKind, line },
+    });
+}
+function makeFileNode(fp) {
+    const label = fp.path.split('/').pop() ?? fp.path;
+    const tags = ['swift'];
+    if (isSwiftTestPath(fp.path))
+        tags.push('test');
+    return {
+        id: fp.nodeId,
+        kind: NodeKind.File,
+        label,
+        path: fp.path,
+        tags,
+        data: {
+            language: 'swift',
+            sizeBytes: fp.sizeBytes,
+            sha1: fp.sha1,
+            hasDefaultExport: false,
+            exportCount: 0,
+            localCount: 0,
+            reExportCount: 0,
+        },
+    };
+}
+function isSwiftTestPath(rel) {
+    return (/(?:^|\/)Tests\//.test(rel) ||
+        /(?:^|\/)[\w-]+Tests\.swift$/.test(rel));
+}
+function scanSwiftImports(text) {
+    const out = [];
+    // `import Foundation`, `import struct CoreData.NSManagedObject`
+    const re = /^import\s+(?:(?:struct|class|protocol|enum|typealias|func|let|var)\s+)?([\w.]+)/gm;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const line = lineFromOffset(text, m.index);
+        out.push({ specifier: m[1], line, kind: 'swift-import' });
+    }
+    const seen = new Set();
+    const deduped = [];
+    for (const it of out) {
+        const k = `${it.specifier}|${it.line}`;
+        if (seen.has(k))
+            continue;
+        seen.add(k);
+        deduped.push(it);
+    }
+    return deduped;
+}
+function lineFromOffset(text, offset) {
+    let line = 1;
+    for (let i = 0; i < offset && i < text.length; i++) {
+        if (text.charCodeAt(i) === 10)
+            line += 1;
+    }
+    return line;
+}

package/dist/indexer/extract-ts-file.d.ts

@@ -0,0 +1,79 @@
+import type { IEdge } from '../schema/edge.js';
+import type { IFileFingerprint } from '../schema/file-fingerprint.js';
+import type { INode } from '../schema/node.js';
+export declare const EXTRACT_TS_FILE_SOURCE = "extract-ts-file@v1";
+export interface IExtractedFile {
+    fileNode: INode;
+    symbolNodes: readonly INode[];
+    edges: readonly IEdge[];
+    /** Specifiers we observed. Resolution happens later in the indexer. */
+    rawImportSpecifiers: readonly IRawImportSpecifier[];
+    /**
+     * Named / default import bindings: `localName` is what the file uses
+     * to refer to the symbol; resolution to a target file id happens in
+     * the indexer post-pass. Namespace imports (`import * as X`) are
+     * intentionally skipped — the binder would need cross-file member
+     * lookup which is out of scope for the MVP.
+     */
+    importBindings: readonly IImportBinding[];
+    /**
+     * Identifier references found in the file body. The indexer post-pass
+     * filters these against the resolved bindings + the file's own local
+     * symbols and emits `references-symbol` / `calls-symbol` edges.
+     */
+    identifierReferences: readonly IIdentifierReference[];
+}
+export interface IRawImportSpecifier {
+    specifier: string;
+    line: number;
+    /** Best-effort kind: 'static' | 'side-effect' | 'dynamic' | 'require'. */
+    kind: string;
+}
+export interface IImportBinding {
+    /** Identifier name used inside this file. */
+    localName: string;
+    /** Name as exported by the target module. `default` for default imports. */
+    importedName: string;
+    specifier: string;
+    isDefault: boolean;
+    line: number;
+}
+export interface IIdentifierReference {
+    /** Identifier text at the use site. */
+    name: string;
+    line: number;
+    /** True when the identifier appears as the callee of a call expression. */
+    isCall: boolean;
+}
+/**
+ * Extract graph entities from a single TS/TSX/JS/JSX file.
+ *
+ * Re-uses `buildSymbolIndex` for symbol detection (per-file AST, no full
+ * program). Import edges carry the literal specifier; resolution to the
+ * target file id happens in `resolve-imports.ts` (R64).
+ */
+export declare function extractTsFile(fingerprint: IFileFingerprint, absPath: string, content?: string): IExtractedFile;
+/**
+ * Stitch identifier references + import bindings into edges.
+ *
+ * Called by the indexer after per-file extraction + import resolution.
+ * Emits `references-symbol` / `calls-symbol` edges from a file to the
+ * symbol(s) it uses. Same-file references resolve against the file's
+ * own declared symbols; cross-file references resolve via the import
+ * bindings + the resolver's spec → targetPath map.
+ *
+ * Default imports target `symbol:<targetPath>#<defaultExportName>`
+ * when the default export name is known (via the file node's
+ * `defaultExportName` data), or `#default` as a placeholder when not.
+ */
+export declare function stitchPerFileReferences(input: {
+    fileNodeId: string;
+    extracted: IExtractedFile;
+    /** specifier → targetFilePath (POSIX, project-relative). */
+    resolvedSpec: ReadonlyMap<string, string | undefined>;
+    /** targetPath → defaultExportName (if known). */
+    defaultExportNameByPath: ReadonlyMap<string, string | undefined>;
+    /** localName → symbol node id, restricted to this file's own symbols. */
+    localSymbolNamesInThisFile: ReadonlyMap<string, string>;
+}): readonly IEdge[];
+//# sourceMappingURL=extract-ts-file.d.ts.map

package/dist/indexer/extract-ts-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-ts-file.d.ts","sourceRoot":"","sources":["../../src/indexer/extract-ts-file.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAc3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,CAAC;IAChB,WAAW,EAAE,SAAS,KAAK,EAAE,CAAC;IAC9B,KAAK,EAAE,SAAS,KAAK,EAAE,CAAC;IACxB,uEAAuE;IACvE,mBAAmB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD;;;;;;OAMG;IACH,cAAc,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C;;;;OAIG;IACH,oBAAoB,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CA+EhB;AA6ID;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,cAAc,CAAC;IAC1B,4DAA4D;IAC5D,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACtD,iDAAiD;IACjD,uBAAuB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjE,yEAAyE;IACzE,0BAA0B,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzD,GAAG,SAAS,KAAK,EAAE,CA+BnB"}