@saluzi/codegraph 0.1.0 → 0.2.0

package/dist/resolution/frameworks/cargo-workspace.js

@@ -1,225 +0,0 @@
-"use strict";
-/**
- * Cargo Workspace Resolver Helper
- *
- * Parses a project's root Cargo.toml and member crate manifests to
- * build a crate-name -> member-directory map. Used by the Rust
- * resolver to resolve `use crate_name::...` references that point
- * into workspace member crates.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCargoWorkspaceCrateMap = getCargoWorkspaceCrateMap;
-const picomatch_1 = __importDefault(require("picomatch"));
-const GLOB_CHARS = /[*?[\]{}!]/;
-const SKIP_DIRS = new Set(['target', 'node_modules', '.git', 'dist', 'build']);
-const MAX_GLOB_WALK_DEPTH = 5;
-function getSection(content, sectionName) {
-    const lines = content.split('\n');
-    let inSection = false;
-    const sectionLines = [];
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (!inSection) {
-            if (trimmed === `[${sectionName}]`) {
-                inSection = true;
-            }
-            continue;
-        }
-        if (/^\[[^\]]+\]$/.test(trimmed)) {
-            break;
-        }
-        sectionLines.push(line);
-    }
-    if (!inSection)
-        return null;
-    return sectionLines.join('\n');
-}
-function extractQuotedValues(valueList) {
-    const values = [];
-    let quote = null;
-    let escaped = false;
-    let current = '';
-    for (const ch of valueList) {
-        if (!quote) {
-            if (ch === '"' || ch === "'") {
-                quote = ch;
-                current = '';
-            }
-            continue;
-        }
-        if (escaped) {
-            current += ch;
-            escaped = false;
-            continue;
-        }
-        if (ch === '\\') {
-            escaped = true;
-            continue;
-        }
-        if (ch === quote) {
-            values.push(current.trim());
-            quote = null;
-            current = '';
-            continue;
-        }
-        current += ch;
-    }
-    return values.filter(Boolean);
-}
-function escapeRegExp(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-function getArrayValue(section, key) {
-    const keyRegex = new RegExp(`\\b${escapeRegExp(key)}\\b\\s*=`, 'm');
-    const keyMatch = keyRegex.exec(section);
-    if (!keyMatch)
-        return null;
-    let i = keyMatch.index + keyMatch[0].length;
-    while (i < section.length && /\s/.test(section.charAt(i)))
-        i++;
-    if (section.charAt(i) !== '[')
-        return null;
-    i++;
-    let inQuote = null;
-    let escaped = false;
-    let depth = 1;
-    const start = i;
-    while (i < section.length) {
-        const ch = section.charAt(i);
-        if (inQuote) {
-            if (escaped) {
-                escaped = false;
-            }
-            else if (ch === '\\') {
-                escaped = true;
-            }
-            else if (ch === inQuote) {
-                inQuote = null;
-            }
-            i++;
-            continue;
-        }
-        if (ch === '"' || ch === "'") {
-            inQuote = ch;
-            i++;
-            continue;
-        }
-        if (ch === '[') {
-            depth++;
-            i++;
-            continue;
-        }
-        if (ch === ']') {
-            depth--;
-            if (depth === 0) {
-                return section.slice(start, i);
-            }
-            i++;
-            continue;
-        }
-        i++;
-    }
-    return null;
-}
-function parseWorkspaceMembers(cargoToml) {
-    const workspaceSection = getSection(cargoToml, 'workspace');
-    if (!workspaceSection)
-        return [];
-    const membersValue = getArrayValue(workspaceSection, 'members');
-    if (!membersValue)
-        return [];
-    return extractQuotedValues(membersValue);
-}
-function parsePackageName(cargoToml) {
-    const packageSection = getSection(cargoToml, 'package');
-    if (!packageSection)
-        return null;
-    const packageNameMatch = packageSection.match(/name\s*=\s*["']([^"'\n]+)["']/);
-    return packageNameMatch?.[1]?.trim() ?? null;
-}
-function addCrateAlias(map, crateName, memberPath) {
-    const normalized = crateName.replace(/-/g, '_');
-    map.set(crateName, memberPath);
-    if (normalized !== crateName) {
-        map.set(normalized, memberPath);
-    }
-}
-function cleanPath(memberPath) {
-    return memberPath.replace(/\\/g, '/').replace(/\/$/, '');
-}
-function expandGlobMember(member, context) {
-    if (!context.listDirectories)
-        return [];
-    const firstGlobIdx = member.search(GLOB_CHARS);
-    const staticPrefix = member
-        .slice(0, firstGlobIdx)
-        .replace(/[^/]*$/, '')
-        .replace(/\/$/, '');
-    const matcher = (0, picomatch_1.default)(member, { dot: false });
-    const matches = [];
-    const seen = new Set();
-    function walk(dir, depth) {
-        if (depth > MAX_GLOB_WALK_DEPTH)
-            return;
-        const children = context.listDirectories(dir);
-        for (const child of children) {
-            if (SKIP_DIRS.has(child) || child.startsWith('.'))
-                continue;
-            const rel = dir === '.' ? child : `${dir}/${child}`;
-            if (matcher(rel) && !seen.has(rel)) {
-                seen.add(rel);
-                matches.push(rel);
-            }
-            walk(rel, depth + 1);
-        }
-    }
-    walk(staticPrefix || '.', 0);
-    return matches;
-}
-function expandMembers(members, context) {
-    const expanded = [];
-    const seen = new Set();
-    for (const member of members) {
-        const candidates = GLOB_CHARS.test(member)
-            ? expandGlobMember(member, context)
-            : [member];
-        for (const candidate of candidates) {
-            const cleaned = cleanPath(candidate);
-            if (seen.has(cleaned))
-                continue;
-            seen.add(cleaned);
-            expanded.push(cleaned);
-        }
-    }
-    return expanded;
-}
-/**
- * Build a map from crate-name aliases to workspace member directory paths.
- * Example: "mytool-core" and "mytool_core" -> "crates/mytool-core"
- *
- * Supports glob members (e.g. `members = ["crates/*"]`) via picomatch
- * when the context exposes `listDirectories`.
- */
-function getCargoWorkspaceCrateMap(context) {
-    const result = new Map();
-    const rootCargoToml = context.readFile('Cargo.toml');
-    if (!rootCargoToml)
-        return result;
-    const rawMembers = parseWorkspaceMembers(rootCargoToml);
-    const members = expandMembers(rawMembers, context);
-    for (const memberPath of members) {
-        const memberCargoPath = `${memberPath}/Cargo.toml`;
-        const memberCargoToml = context.readFile(memberCargoPath);
-        if (!memberCargoToml)
-            continue;
-        const packageName = parsePackageName(memberCargoToml);
-        if (!packageName)
-            continue;
-        addCrateAlias(result, packageName, memberPath);
-    }
-    return result;
-}
-//# sourceMappingURL=cargo-workspace.js.map

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

@@ -1,8 +0,0 @@
-/**
- * C# Framework Resolver
- *
- * Handles ASP.NET Core, ASP.NET MVC, and common C# patterns.
- */
-import { FrameworkResolver } from '../types'
-export declare const aspnetResolver: FrameworkResolver
-//# sourceMappingURL=csharp.d.ts.map

package/dist/resolution/frameworks/csharp.js

@@ -1,213 +0,0 @@
-"use strict";
-/**
- * C# Framework Resolver
- *
- * Handles ASP.NET Core, ASP.NET MVC, and common C# patterns.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.aspnetResolver = void 0;
-const strip_comments_1 = require("../strip-comments");
-exports.aspnetResolver = {
-    name: 'aspnet',
-    languages: ['csharp'],
-    detect(context) {
-        // Check for .csproj files with ASP.NET references
-        const allFiles = context.getAllFiles();
-        for (const file of allFiles) {
-            if (file.endsWith('.csproj')) {
-                const content = context.readFile(file);
-                if (content && (content.includes('Microsoft.AspNetCore') ||
-                    content.includes('Microsoft.NET.Sdk.Web') ||
-                    content.includes('System.Web.Mvc'))) {
-                    return true;
-                }
-            }
-        }
-        // Check for Program.cs with WebApplication
-        const programCs = context.readFile('Program.cs');
-        if (programCs && (programCs.includes('WebApplication') ||
-            programCs.includes('CreateHostBuilder') ||
-            programCs.includes('UseStartup'))) {
-            return true;
-        }
-        // Check for Startup.cs (ASP.NET Core signature)
-        if (context.fileExists('Startup.cs')) {
-            return true;
-        }
-        // Check for Controllers directory
-        return allFiles.some((f) => f.includes('/Controllers/') && f.endsWith('Controller.cs'));
-    },
-    resolve(ref, context) {
-        // Pattern 1: Controller references
-        if (ref.referenceName.endsWith('Controller')) {
-            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, CONTROLLER_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.85,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 2: Service references (dependency injection)
-        if (ref.referenceName.endsWith('Service') || ref.referenceName.startsWith('I') && ref.referenceName.length > 1) {
-            const result = resolveByNameAndKind(ref.referenceName, SERVICE_KINDS, SERVICE_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.85,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 3: Repository references
-        if (ref.referenceName.endsWith('Repository')) {
-            const result = resolveByNameAndKind(ref.referenceName, SERVICE_KINDS, REPO_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.85,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 4: Model/Entity references
-        if (/^[A-Z][a-zA-Z]+$/.test(ref.referenceName)) {
-            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, MODEL_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.7,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        // Pattern 5: ViewModel references
-        if (ref.referenceName.endsWith('ViewModel') || ref.referenceName.endsWith('Dto')) {
-            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, VIEWMODEL_DIRS, context);
-            if (result) {
-                return {
-                    original: ref,
-                    targetNodeId: result,
-                    confidence: 0.8,
-                    resolvedBy: 'framework',
-                };
-            }
-        }
-        return null;
-    },
-    extract(filePath, content) {
-        if (!filePath.endsWith('.cs'))
-            return { nodes: [], references: [] };
-        const nodes = [];
-        const references = [];
-        const now = Date.now();
-        const safe = (0, strip_comments_1.stripCommentsForRegex)(content, 'csharp');
-        // [HttpGet("path")], [HttpPost("path")], etc.
-        const attrRegex = /\[(HttpGet|HttpPost|HttpPut|HttpPatch|HttpDelete)\s*\(\s*"([^"]+)"\s*\)\]/g;
-        let match;
-        while ((match = attrRegex.exec(safe)) !== null) {
-            const [, verb, routePath] = match;
-            const method = verb.replace(/^Http/, '').toUpperCase();
-            const line = safe.slice(0, match.index).split('\n').length;
-            const routeNode = {
-                id: `route:${filePath}:${line}:${method}:${routePath}`,
-                kind: 'route',
-                name: `${method} ${routePath}`,
-                qualifiedName: `${filePath}::route:${routePath}`,
-                filePath,
-                startLine: line,
-                endLine: line,
-                startColumn: 0,
-                endColumn: match[0].length,
-                language: 'csharp',
-                updatedAt: now,
-            };
-            nodes.push(routeNode);
-            // Capture the next method declaration
-            const tail = safe.slice(match.index + match[0].length);
-            const methodMatch = tail.match(/(?:public|private|protected|internal)\s+[\w<>,\s\[\]]+?\s+(\w+)\s*\(/);
-            if (methodMatch) {
-                references.push({
-                    fromNodeId: routeNode.id,
-                    referenceName: methodMatch[1],
-                    referenceKind: 'references',
-                    line,
-                    column: 0,
-                    filePath,
-                    language: 'csharp',
-                });
-            }
-        }
-        // Minimal APIs: app.MapGet("/path", handler)
-        const minimalRegex = /\.Map(Get|Post|Put|Patch|Delete)\s*\(\s*"([^"]+)"\s*,\s*([^,)]+)/g;
-        while ((match = minimalRegex.exec(safe)) !== null) {
-            const [, verb, routePath, handlerExpr] = match;
-            const method = verb.toUpperCase();
-            const line = safe.slice(0, match.index).split('\n').length;
-            const routeNode = {
-                id: `route:${filePath}:${line}:${method}:${routePath}`,
-                kind: 'route',
-                name: `${method} ${routePath}`,
-                qualifiedName: `${filePath}::route:${routePath}`,
-                filePath,
-                startLine: line,
-                endLine: line,
-                startColumn: 0,
-                endColumn: match[0].length,
-                language: 'csharp',
-                updatedAt: now,
-            };
-            nodes.push(routeNode);
-            const handlerName = extractCSharpTailIdent(handlerExpr);
-            if (handlerName) {
-                references.push({
-                    fromNodeId: routeNode.id,
-                    referenceName: handlerName,
-                    referenceKind: 'references',
-                    line,
-                    column: 0,
-                    filePath,
-                    language: 'csharp',
-                });
-            }
-        }
-        return { nodes, references };
-    },
-};
-/** Extract last identifier from an expression like `MyService.Handler` or `Handler`. */
-function extractCSharpTailIdent(expr) {
-    const cleaned = expr.trim().replace(/\s+/g, '');
-    const m = cleaned.match(/(?:\.|^)([A-Za-z_][A-Za-z0-9_]*)$/);
-    return m ? m[1] : null;
-}
-// Directory patterns
-const CONTROLLER_DIRS = ['/Controllers/'];
-const SERVICE_DIRS = ['/Services/', '/Service/', '/Application/'];
-const REPO_DIRS = ['/Repositories/', '/Repository/', '/Data/', '/Infrastructure/'];
-const MODEL_DIRS = ['/Models/', '/Model/', '/Entities/', '/Entity/', '/Domain/'];
-const VIEWMODEL_DIRS = ['/ViewModels/', '/ViewModel/', '/DTOs/', '/Dto/'];
-const CLASS_KINDS = new Set(['class']);
-const SERVICE_KINDS = new Set(['class', 'interface']);
-/**
- * Resolve a symbol by name using indexed queries instead of scanning all files.
- */
-function resolveByNameAndKind(name, kinds, preferredDirPatterns, context) {
-    const candidates = context.getNodesByName(name);
-    if (candidates.length === 0)
-        return null;
-    const kindFiltered = candidates.filter((n) => kinds.has(n.kind));
-    if (kindFiltered.length === 0)
-        return null;
-    // Prefer candidates in framework-conventional directories
-    const preferred = kindFiltered.filter((n) => preferredDirPatterns.some((d) => n.filePath.includes(d)));
-    if (preferred.length > 0)
-        return preferred[0].id;
-    // Fall back to any match
-    return kindFiltered[0].id;
-}
-//# sourceMappingURL=csharp.js.map

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

@@ -1,51 +0,0 @@
-/**
- * Drupal Framework Resolver
- *
- * Supports Drupal 8/9/10/11 (Composer-based projects). Drupal 7 is not supported.
- *
- * ## What this resolver does
- *
- * 1. **Detection** — reads composer.json and checks for any `drupal/*` dependency in
- *    `require` or `require-dev`.
- *
- * 2. **Route extraction** — parses `*.routing.yml` files and emits `route` nodes for each
- *    Drupal route, with `references` edges to the `_controller`, `_form`, or entity handler
- *    class/method.
- *
- * 3. **Hook detection** — scans `.module`, `.install`, `.theme`, and `.inc` files for Drupal
- *    hook implementations. Two strategies are used:
- *      a. Docblock: `@Implements hook_X()` → precise, no false positives.
- *      b. Name pattern: function `{moduleName}_{hookSuffix}()` → catches hooks without
- *         docblocks but may produce false positives on helper functions.
- *    Detected hooks emit an `UnresolvedRef` from the implementing function node to the
- *    canonical `hook_X` name, linking implementations to the hook when `codegraph_callers`
- *    is invoked.
- *
- * ## Design decisions (review in future iterations)
- *
- * - Hook graph resolution (v1): hook references are stored as UnresolvedRef pointing to the
- *   canonical `hook_X` name. If Drupal core is indexed, these will resolve to core hook
- *   definitions. Without core, they remain unresolved but are still searchable via
- *   `codegraph_search("form_alter")`. Full hook-node creation (virtual nodes for every hook)
- *   is deferred to a future iteration.
- *
- * - Services / plugins (out of scope for v1): `*.services.yml` service definitions and plugin
- *   annotations (`@Block`, `@FormElement`, etc.) are not extracted. Add a TODO below when
- *   ready to implement.
- *
- * - Twig templates (out of scope for v1): `.twig` files are tracked as file nodes but no
- *   symbol extraction is performed (no tree-sitter Twig grammar). Implement when a Twig
- *   grammar WASM is available.
- *
- * ## TODOs for future iterations
- *
- * - TODO: Extract service definitions from `*.services.yml` files (class → service-id edges).
- * - TODO: Extract plugin annotations (`@Block`, `@FormElement`, `@Field`, etc.) from PHP
- *   docblocks and emit plugin nodes with references to the annotated class.
- * - TODO: Add Twig symbol extraction when a tree-sitter Twig grammar becomes available.
- * - TODO: Improve hook resolution: create virtual `hook_*` nodes so `codegraph_callers`
- *   returns all implementations even when Drupal core is not indexed.
- */
-import { FrameworkResolver } from '../types'
-export declare const drupalResolver: FrameworkResolver
-//# sourceMappingURL=drupal.d.ts.map