@shrkcrft/graph 0.1.0-alpha.10

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export * from './schema/schema-version.js';
+export * from './schema/node-kind.js';
+export * from './schema/edge-kind.js';
+export * from './schema/node.js';
+export * from './schema/edge.js';
+export * from './schema/manifest.js';
+export * from './schema/file-fingerprint.js';
+export * from './schema/graph-snapshot.js';
+export * from './store/file-fingerprint.js';
+export * from './store/graph-store.js';
+export * from './indexer/extract-ts-file.js';
+export * from './indexer/extract-python-file.js';
+export * from './indexer/extract-go-file.js';
+export * from './indexer/extract-java-file.js';
+export * from './indexer/extract-rust-file.js';
+export * from './indexer/extract-kotlin-file.js';
+export * from './indexer/extract-ruby-file.js';
+export * from './indexer/extract-csharp-file.js';
+export * from './indexer/extract-elixir-file.js';
+export * from './indexer/extract-php-file.js';
+export * from './indexer/extract-dart-file.js';
+export * from './indexer/extract-swift-file.js';
+export * from './indexer/detect-workspace.js';
+export * from './indexer/resolve-imports.js';
+export * from './indexer/index-builder.js';
+export * from './indexer/incremental-updater.js';
+export * from './indexer/unresolved-imports.js';
+export * from './query/query-api.js';
+export * from './query/cycle-detection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAEhD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+// Public surface of @shrkcrft/graph.
+//
+// Schema first; store, extractor, indexer, query API follow.
+export * from "./schema/schema-version.js";
+export * from "./schema/node-kind.js";
+export * from "./schema/edge-kind.js";
+export * from "./schema/node.js";
+export * from "./schema/edge.js";
+export * from "./schema/manifest.js";
+export * from "./schema/file-fingerprint.js";
+export * from "./schema/graph-snapshot.js";
+export * from "./store/file-fingerprint.js";
+export * from "./store/graph-store.js";
+export * from "./indexer/extract-ts-file.js";
+export * from "./indexer/extract-python-file.js";
+export * from "./indexer/extract-go-file.js";
+export * from "./indexer/extract-java-file.js";
+export * from "./indexer/extract-rust-file.js";
+export * from "./indexer/extract-kotlin-file.js";
+export * from "./indexer/extract-ruby-file.js";
+export * from "./indexer/extract-csharp-file.js";
+export * from "./indexer/extract-elixir-file.js";
+export * from "./indexer/extract-php-file.js";
+export * from "./indexer/extract-dart-file.js";
+export * from "./indexer/extract-swift-file.js";
+export * from "./indexer/detect-workspace.js";
+export * from "./indexer/resolve-imports.js";
+export * from "./indexer/index-builder.js";
+export * from "./indexer/incremental-updater.js";
+export * from "./indexer/unresolved-imports.js";
+export * from "./query/query-api.js";
+export * from "./query/cycle-detection.js";

package/dist/indexer/detect-workspace.d.ts

@@ -0,0 +1,18 @@
+export interface IWorkspacePackage {
+    /** package.json name field. */
+    name: string;
+    /** Project-relative directory (POSIX separators). */
+    dir: string;
+    /** Entry point (project-relative) — best-effort. */
+    entry?: string;
+}
+/**
+ * Discover workspace packages from `package.json`'s `workspaces` field.
+ * Supports both the array and the `{ packages: [...] }` form.
+ *
+ * Nx integration is deliberately out of scope here — Nx's project graph
+ * is a separate optional input considered later (see code-intelligence.md
+ * §8.3).
+ */
+export declare function detectWorkspacePackages(projectRoot: string): readonly IWorkspacePackage[];
+//# sourceMappingURL=detect-workspace.d.ts.map

package/dist/indexer/detect-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-workspace.d.ts","sourceRoot":"","sources":["../../src/indexer/detect-workspace.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,iBAAiB,EAAE,CAoDzF"}

package/dist/indexer/detect-workspace.js

@@ -0,0 +1,80 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import * as nodePath from 'node:path';
+/**
+ * Discover workspace packages from `package.json`'s `workspaces` field.
+ * Supports both the array and the `{ packages: [...] }` form.
+ *
+ * Nx integration is deliberately out of scope here — Nx's project graph
+ * is a separate optional input considered later (see code-intelligence.md
+ * §8.3).
+ */
+export function detectWorkspacePackages(projectRoot) {
+    const pkgPath = nodePath.join(projectRoot, 'package.json');
+    if (!existsSync(pkgPath))
+        return [];
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    const wsRaw = raw.workspaces;
+    const patterns = normalizeWorkspaces(wsRaw);
+    const out = [];
+    for (const pattern of patterns) {
+        const dir = pattern.replace(/\/\*?$/, '');
+        const full = nodePath.join(projectRoot, dir);
+        if (!existsSync(full))
+            continue;
+        let entries;
+        try {
+            entries = readdirSync(full);
+        }
+        catch {
+            continue;
+        }
+        for (const child of entries) {
+            const inner = nodePath.join(full, child);
+            try {
+                if (!statSync(inner).isDirectory())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            const childPkg = nodePath.join(inner, 'package.json');
+            if (!existsSync(childPkg))
+                continue;
+            try {
+                const pj = JSON.parse(readFileSync(childPkg, 'utf8'));
+                if (!pj.name)
+                    continue;
+                const relDir = nodePath.relative(projectRoot, inner).split(nodePath.sep).join('/');
+                const entry = pj.main ?? pj.module ?? pj.types;
+                out.push({
+                    name: pj.name,
+                    dir: relDir,
+                    ...(entry ? { entry: `${relDir}/${entry.replace(/^\.\//, '')}` } : {}),
+                });
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+function normalizeWorkspaces(value) {
+    if (!value)
+        return [];
+    if (Array.isArray(value))
+        return value.filter((v) => typeof v === 'string');
+    if (typeof value === 'object') {
+        const packages = value.packages;
+        if (Array.isArray(packages)) {
+            return packages.filter((v) => typeof v === 'string');
+        }
+    }
+    return [];
+}

package/dist/indexer/extract-csharp-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_CSHARP_FILE_SOURCE = "extract-csharp-file@v1";
+/**
+ * Regex-based C# extractor.
+ *
+ * Captured (top-level only — nested types are skipped to stay tight):
+ *   - `[public] class Name`, `[public] sealed class`, `[public] static
+ *     class`, `[public] abstract class`, `[public] partial class`
+ *   - `[public] interface Name`
+ *   - `[public] struct Name`, `[public] readonly struct`
+ *   - `[public] record Name(...)`, `[public] record class`, `[public]
+ *     record struct`
+ *   - `[public] enum Name`
+ *   - `namespace Name { … }` and `namespace Name;` (file-scoped)
+ *
+ * Visibility: `public` → exported. `internal`/`private`/`protected`
+ * → local. C# defaults to `internal` at the namespace level, so the
+ * `isExported` flag honours the explicit modifier; unmodified types
+ * are treated as `internal` (local).
+ *
+ * Imports: classic `using X.Y;`, `using static X.Y.Z;`,
+ * `using alias = X.Y;`. We capture the right-hand path; aliases are
+ * dropped.
+ */
+export declare function extractCsharpFile(fingerprint: IFileFingerprint, absPath: string, content?: string): IExtractedFile;
+//# sourceMappingURL=extract-csharp-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract-csharp-file.d.ts","sourceRoot":"","sources":["../../src/indexer/extract-csharp-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,0BAA0B,2BAA2B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CA6ChB"}

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

@@ -0,0 +1,163 @@
+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_CSHARP_FILE_SOURCE = 'extract-csharp-file@v1';
+/**
+ * Regex-based C# extractor.
+ *
+ * Captured (top-level only — nested types are skipped to stay tight):
+ *   - `[public] class Name`, `[public] sealed class`, `[public] static
+ *     class`, `[public] abstract class`, `[public] partial class`
+ *   - `[public] interface Name`
+ *   - `[public] struct Name`, `[public] readonly struct`
+ *   - `[public] record Name(...)`, `[public] record class`, `[public]
+ *     record struct`
+ *   - `[public] enum Name`
+ *   - `namespace Name { … }` and `namespace Name;` (file-scoped)
+ *
+ * Visibility: `public` → exported. `internal`/`private`/`protected`
+ * → local. C# defaults to `internal` at the namespace level, so the
+ * `isExported` flag honours the explicit modifier; unmodified types
+ * are treated as `internal` (local).
+ *
+ * Imports: classic `using X.Y;`, `using static X.Y.Z;`,
+ * `using alias = X.Y;`. We capture the right-hand path; aliases are
+ * dropped.
+ */
+export function extractCsharpFile(fingerprint, absPath, content) {
+    const text = content ?? readFileSync(absPath, 'utf8');
+    const fileNode = makeFileNode(fingerprint, text);
+    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 attributes like `[Serializable]` or `[Obsolete("…")]`.
+        const stripped = trimmed.replace(/^(?:\[[^\]]*\]\s*)+/, '');
+        // Pull access modifiers + variant modifiers.
+        const visMatch = /^(public|internal|private|protected|protected\s+internal|internal\s+protected|private\s+protected)\s+/.exec(stripped);
+        const isExported = !!visMatch && /\bpublic\b/.test(visMatch[1]);
+        const rest = visMatch ? stripped.slice(visMatch[0].length) : stripped;
+        const noModifiers = rest.replace(/^(?:static\s+|sealed\s+|abstract\s+|partial\s+|readonly\s+|ref\s+|unsafe\s+|new\s+|virtual\s+|override\s+|async\s+)+/, '');
+        let m = /^class\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1, isExported);
+            continue;
+        }
+        m = /^interface\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'interface', i + 1, isExported);
+            continue;
+        }
+        m = /^struct\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1, isExported);
+            continue;
+        }
+        m = /^record(?:\s+(?:class|struct))?\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1, isExported);
+            continue;
+        }
+        m = /^enum\s+([A-Za-z_]\w*)/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'enum', i + 1, isExported);
+            continue;
+        }
+        m = /^namespace\s+([\w.]+)\s*[;{]/.exec(noModifiers);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'namespace', i + 1, true);
+        }
+    }
+    return {
+        fileNode,
+        symbolNodes,
+        edges,
+        rawImportSpecifiers: scanUsings(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: 'csharp' },
+    };
+    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_CSHARP_FILE_SOURCE,
+        data: { visibility: isExported ? 'export' : 'local', declKind, line },
+    });
+}
+function makeFileNode(fp, text) {
+    const label = fp.path.split('/').pop() ?? fp.path;
+    const tags = ['csharp'];
+    if (isCsharpTestPath(fp.path))
+        tags.push('test');
+    const nsMatch = /^namespace\s+([\w.]+)/m.exec(text);
+    return {
+        id: fp.nodeId,
+        kind: NodeKind.File,
+        label,
+        path: fp.path,
+        tags,
+        data: {
+            language: 'csharp',
+            sizeBytes: fp.sizeBytes,
+            sha1: fp.sha1,
+            hasDefaultExport: false,
+            exportCount: 0,
+            localCount: 0,
+            reExportCount: 0,
+            ...(nsMatch ? { csharpNamespace: nsMatch[1] } : {}),
+        },
+    };
+}
+function isCsharpTestPath(rel) {
+    return /(?:^|\/)[\w.-]+Tests?\.cs$/.test(rel) || /(?:^|\/)test\//.test(rel);
+}
+function scanUsings(text) {
+    const out = [];
+    // `using X.Y;`, `using static X.Y.Z;`, `using alias = X.Y.Z;`,
+    // `using alias = X.Y.Generic<int, string>;`
+    const re = /^using\s+(?:static\s+)?(?:[\w]+\s*=\s*)?([\w.]+)(?:\s*<[^;]*>)?\s*;/gm;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const line = lineFromOffset(text, m.index);
+        out.push({ specifier: m[1], line, kind: 'csharp-using' });
+    }
+    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-dart-file.d.ts

@@ -0,0 +1,28 @@
+import type { IFileFingerprint } from '../schema/file-fingerprint.js';
+import type { IExtractedFile } from './extract-ts-file.js';
+export declare const EXTRACT_DART_FILE_SOURCE = "extract-dart-file@v1";
+/**
+ * Regex-based Dart extractor.
+ *
+ * Top-level declarations only (column-0). Detected:
+ *   - `[abstract] class Name [extends X] [with M] [implements I]`
+ *   - `mixin Name`, `mixin Name on X`
+ *   - `enum Name { … }`
+ *   - `typedef Name = …`
+ *   - `extension Name on X { … }`
+ *   - `[Type] name(…) { … }`, `void name(…) { … }` — file-scope functions
+ *
+ * Imports: `import 'package:foo/bar.dart' [as X] [show A, B] [hide C]`;
+ * `export 'package:foo/bar.dart'`. Relative imports captured as-is.
+ *
+ * Visibility: Dart marks private members with a leading underscore.
+ * Public symbols (no leading `_`) get `isExported: true`; otherwise
+ * `local`.
+ *
+ * Out of scope:
+ *   - `part of` / `part` directive handling.
+ *   - Inline `@Annotation()` capture.
+ *   - Class body walking (methods).
+ */
+export declare function extractDartFile(fingerprint: IFileFingerprint, absPath: string, content?: string): IExtractedFile;
+//# sourceMappingURL=extract-dart-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract-dart-file.d.ts","sourceRoot":"","sources":["../../src/indexer/extract-dart-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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CA8DhB"}

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

@@ -0,0 +1,167 @@
+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_DART_FILE_SOURCE = 'extract-dart-file@v1';
+/**
+ * Regex-based Dart extractor.
+ *
+ * Top-level declarations only (column-0). Detected:
+ *   - `[abstract] class Name [extends X] [with M] [implements I]`
+ *   - `mixin Name`, `mixin Name on X`
+ *   - `enum Name { … }`
+ *   - `typedef Name = …`
+ *   - `extension Name on X { … }`
+ *   - `[Type] name(…) { … }`, `void name(…) { … }` — file-scope functions
+ *
+ * Imports: `import 'package:foo/bar.dart' [as X] [show A, B] [hide C]`;
+ * `export 'package:foo/bar.dart'`. Relative imports captured as-is.
+ *
+ * Visibility: Dart marks private members with a leading underscore.
+ * Public symbols (no leading `_`) get `isExported: true`; otherwise
+ * `local`.
+ *
+ * Out of scope:
+ *   - `part of` / `part` directive handling.
+ *   - Inline `@Annotation()` capture.
+ *   - Class body walking (methods).
+ */
+export function extractDartFile(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;
+        // class / abstract class / sealed class / interface class / final class / base class / mixin class
+        let m = /^(?:abstract\s+|sealed\s+|base\s+|interface\s+|final\s+|mixin\s+)*class\s+([A-Za-z_]\w*)/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1);
+            continue;
+        }
+        m = /^mixin\s+([A-Za-z_]\w*)/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1);
+            continue;
+        }
+        m = /^enum\s+([A-Za-z_]\w*)/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'enum', i + 1);
+            continue;
+        }
+        m = /^typedef\s+([A-Za-z_]\w*)/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'type-alias', i + 1);
+            continue;
+        }
+        m = /^extension\s+([A-Za-z_]\w*)/.exec(trimmed);
+        if (m) {
+            pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, m[1], 'class', i + 1);
+            continue;
+        }
+        // File-scope functions: `<Type> name(…)` or `void name(…)`.
+        // Require either a `{` to open a body (anywhere on the line) or
+        // an arrow `=>` so we don't sweep up variable declarations or
+        // function-type fields.
+        m = /^([A-Za-z_]\w*(?:<[^>]*>)?\??)\s+([A-Za-z_]\w*)\s*\(/.exec(trimmed);
+        if (m && (/\{/.test(trimmed) || /=>/.test(trimmed))) {
+            const name = m[2];
+            // Skip constructor-style names that begin with `Type.` (those are
+            // class members, not file-scope functions).
+            if (!name.includes('.')) {
+                pushSymbol(fingerprint, symbolNodes, edges, fileNode.id, name, 'function', i + 1);
+            }
+        }
+    }
+    return {
+        fileNode,
+        symbolNodes,
+        edges,
+        rawImportSpecifiers: scanDartImports(text),
+        importBindings: [],
+        identifierReferences: [],
+    };
+}
+function pushSymbol(fp, nodes, edges, fileId, name, declKind, line) {
+    const isExported = !name.startsWith('_');
+    const sym = {
+        id: `symbol:${fp.path}#${name}`,
+        kind: NodeKind.Symbol,
+        label: name,
+        path: fp.path,
+        line,
+        data: { declKind, visibility: isExported ? 'export' : 'local', isExported, language: 'dart' },
+    };
+    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_DART_FILE_SOURCE,
+        data: { visibility: isExported ? 'export' : 'local', declKind, line },
+    });
+}
+function makeFileNode(fp) {
+    const label = fp.path.split('/').pop() ?? fp.path;
+    const tags = ['dart'];
+    if (isDartTestPath(fp.path))
+        tags.push('test');
+    return {
+        id: fp.nodeId,
+        kind: NodeKind.File,
+        label,
+        path: fp.path,
+        tags,
+        data: {
+            language: 'dart',
+            sizeBytes: fp.sizeBytes,
+            sha1: fp.sha1,
+            hasDefaultExport: false,
+            exportCount: 0,
+            localCount: 0,
+            reExportCount: 0,
+        },
+    };
+}
+function isDartTestPath(rel) {
+    return (/(?:^|\/)test\//.test(rel) ||
+        /(?:^|\/)[\w-]+_test\.dart$/.test(rel));
+}
+function scanDartImports(text) {
+    const out = [];
+    // `import 'package:foo/bar.dart' [as X] [show A] [hide B];`
+    // `export 'package:foo/bar.dart';`
+    const re = /^\s*(import|export)\s+['"]([^'"]+)['"](?:\s+(?:as\s+\w+|show\s+[^;]+|hide\s+[^;]+|deferred\s+as\s+\w+))*\s*;/gm;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const line = lineFromOffset(text, m.index);
+        out.push({ specifier: m[2], line, kind: `dart-${m[1]}` });
+    }
+    const seen = new Set();
+    const deduped = [];
+    for (const it of out) {
+        const k = `${it.kind}|${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-elixir-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_ELIXIR_FILE_SOURCE = "extract-elixir-file@v1";
+/**
+ * Regex-based Elixir extractor.
+ *
+ * Top-level constructs only (column-0):
+ *   - `defmodule Path.To.Mod do` → module
+ *   - `def name(...)` → function (exported)
+ *   - `defp name(...)` → function (local)
+ *   - `defstruct …` and `defprotocol` / `defimpl` headers → struct / protocol
+ *
+ * Nested `def`s under a `defmodule` show up at column 0 in this
+ * extractor's view; that's intentional because they're the publicly
+ * callable functions on that module.
+ *
+ * Imports: `alias Foo.Bar`, `alias Foo.{A, B}`, `import Enum`,
+ * `require Logger`, `use MyAppWeb, :controller`. Aliases inside
+ * `{...}` are expanded.
+ *
+ * Out of scope:
+ *   - Pipe operator chains.
+ *   - Macro definitions (`defmacro`/`defmacrop`).
+ *   - Inline guard clauses (`when ...`).
+ */
+export declare function extractElixirFile(fingerprint: IFileFingerprint, absPath: string, content?: string): IExtractedFile;
+//# sourceMappingURL=extract-elixir-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract-elixir-file.d.ts","sourceRoot":"","sources":["../../src/indexer/extract-elixir-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,0BAA0B,2BAA2B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAiDhB"}