@saluzi/codegraph 0.1.0 → 0.2.1

package/dist/resolution/types.d.ts

@@ -3,179 +3,260 @@
  *
  * Types for the reference resolution system.
  */
-import { EdgeKind, Language, Node } from '../types'
+import { Language, Node, ReferenceKind } from '../types';
 /**
  * An unresolved reference from extraction
  */
 export interface UnresolvedRef {
-  /** ID of the source node containing the reference */
-  fromNodeId: string
-  /** The name being referenced */
-  referenceName: string
-  /** Type of reference */
-  referenceKind: EdgeKind
-  /** Line where reference occurs */
-  line: number
-  /** Column where reference occurs */
-  column: number
-  /** File path where reference occurs */
-  filePath: string
-  /** Language of the source file */
-  language: Language
-  /** Possible qualified names it might resolve to */
-  candidates?: string[]
+    /** ID of the source node containing the reference */
+    fromNodeId: string;
+    /** The name being referenced */
+    referenceName: string;
+    /** Type of reference */
+    referenceKind: ReferenceKind;
+    /** Line where reference occurs */
+    line: number;
+    /** Column where reference occurs */
+    column: number;
+    /** File path where reference occurs */
+    filePath: string;
+    /** Language of the source file */
+    language: Language;
+    /** Possible qualified names it might resolve to */
+    candidates?: string[];
 }
 /**
  * A resolved reference
  */
 export interface ResolvedRef {
-  /** Original unresolved reference */
-  original: UnresolvedRef
-  /** ID of the target node */
-  targetNodeId: string
-  /** Confidence score (0-1) */
-  confidence: number
-  /** How it was resolved */
-  resolvedBy:
-    | 'exact-match'
-    | 'import'
-    | 'qualified-name'
-    | 'framework'
-    | 'fuzzy'
-    | 'instance-method'
-    | 'file-path'
+    /** Original unresolved reference */
+    original: UnresolvedRef;
+    /** ID of the target node */
+    targetNodeId: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** How it was resolved */
+    resolvedBy: 'exact-match' | 'import' | 'qualified-name' | 'framework' | 'fuzzy' | 'instance-method' | 'file-path' | 'function-ref';
 }
 /**
  * Result of resolution attempt
  */
 export interface ResolutionResult {
-  /** Successfully resolved references */
-  resolved: ResolvedRef[]
-  /** References that couldn't be resolved */
-  unresolved: UnresolvedRef[]
-  /** Statistics */
-  stats: {
-    total: number
-    resolved: number
-    unresolved: number
-    byMethod: Record<string, number>
-  }
+    /** Successfully resolved references */
+    resolved: ResolvedRef[];
+    /** References that couldn't be resolved */
+    unresolved: UnresolvedRef[];
+    /** Statistics */
+    stats: {
+        total: number;
+        resolved: number;
+        unresolved: number;
+        byMethod: Record<string, number>;
+    };
 }
 /**
  * Context for resolution - provides access to the graph
  */
 export interface ResolutionContext {
-  /** Get all nodes in a file */
-  getNodesInFile(filePath: string): Node[]
-  /** Get all nodes by name */
-  getNodesByName(name: string): Node[]
-  /** Get all nodes by qualified name */
-  getNodesByQualifiedName(qualifiedName: string): Node[]
-  /** Get all nodes of a kind */
-  getNodesByKind(kind: Node['kind']): Node[]
-  /** Check if a file exists */
-  fileExists(filePath: string): boolean
-  /** Read file content */
-  readFile(filePath: string): string | null
-  /** Get project root */
-  getProjectRoot(): string
-  /** Get all files */
-  getAllFiles(): string[]
-  /** Get nodes by lowercase name (O(1) lookup for fuzzy matching) */
-  getNodesByLowerName(lowerName: string): Node[]
-  /** Get cached import mappings for a file */
-  getImportMappings(filePath: string, language: Language): ImportMapping[]
-  /**
-   * Project import-path aliases (tsconfig/jsconfig `paths`). Returns
-   * `null` when the project doesn't define any. Cached per resolver
-   * instance — safe to call from any resolver code path. Optional so
-   * existing test fixtures and external context implementations
-   * compile without modification; production resolver implements it.
-   */
-  getProjectAliases?(): import('./path-aliases').AliasMap | null
-  /**
-   * Re-exports declared by a file (`export { x } from './other'`,
-   * `export * from './other'`). Empty array when the file has none.
-   * Optional so older callers compile; the import resolver follows
-   * re-export chains when this is provided.
-   */
-  getReExports?(filePath: string, language: Language): ReExport[]
-  /**
-   * List immediate subdirectories of `relativePath` (relative to the
-   * project root). Returns an empty array when the path doesn't exist
-   * or isn't a directory. Used by framework resolvers that need to
-   * walk build-system metadata (e.g. Cargo workspace globs). Optional
-   * so external context implementations and test fixtures compile
-   * without modification.
-   */
-  listDirectories?(relativePath: string): string[]
+    /** Get all nodes in a file */
+    getNodesInFile(filePath: string): Node[];
+    /** Get all nodes by name */
+    getNodesByName(name: string): Node[];
+    /** Get all nodes by qualified name */
+    getNodesByQualifiedName(qualifiedName: string): Node[];
+    /** Get all nodes of a kind */
+    getNodesByKind(kind: Node['kind']): Node[];
+    /**
+     * Stream nodes of a kind one at a time instead of materializing (and, unlike
+     * `getNodesByKind`, without populating the resolver's per-kind array cache).
+     * For unbounded kinds (`function`, `method`, `struct`) on a symbol-dense
+     * project the full array is gigabytes — the dynamic-edge synthesizers must
+     * use this so their memory stays O(1) in node count (#610, #1212). Optional
+     * so minimal test contexts compile; callers fall back to getNodesByKind.
+     */
+    iterateNodesByKind?(kind: Node['kind']): IterableIterator<Node>;
+    /** Check if a file exists */
+    fileExists(filePath: string): boolean;
+    /** Read file content */
+    readFile(filePath: string): string | null;
+    /**
+     * `readFile(filePath)` split into lines, LRU-cached per file. Receiver-type
+     * inference scans source lines for EVERY `receiver.method()` ref; splitting
+     * the whole file per ref made that O(refs-in-file × file-size) — ~20% of
+     * total index CPU on a Java-heavy repo and a driver of the #1122 watchdog
+     * kill on large ones. Optional so external/test contexts compile without it;
+     * callers fall back to splitting `readFile` themselves.
+     */
+    getFileLines?(filePath: string): string[] | null;
+    /**
+     * The method-definition nodes matching `typeName::methodName` in `language` —
+     * exactly `resolveMethodOnType`'s kind/language/qualifiedName-suffix filter,
+     * LRU-cached per (language, type, method). The uncached path re-fetches every
+     * node sharing the METHOD name (unbounded — tens of thousands on a collision-
+     * heavy Java repo) and re-scans it per ref, the dominant term in the #1122
+     * watchdog kill. Cached entries hold only the small filtered result; per-ref
+     * disambiguation (import FQN, call-site file) stays in the caller so a cached
+     * entry is valid from any call site. Optional for external/test contexts.
+     */
+    getMethodMatches?(typeName: string, methodName: string, language: Language): Node[];
+    /** Get project root */
+    getProjectRoot(): string;
+    /** Get all files */
+    getAllFiles(): string[];
+    /** Get nodes by lowercase name (O(1) lookup for fuzzy matching) */
+    getNodesByLowerName(lowerName: string): Node[];
+    /**
+     * Direct supertypes of the type named `typeName` (same language): the classes
+     * it extends and the interfaces / protocols / traits it implements/conforms to,
+     * by simple name. Backed by the resolved `implements`/`extends` edges, so it is
+     * EMPTY during the first resolution pass (edges aren't built yet) and populated
+     * afterward — the conformance pass uses it to resolve a chained method defined
+     * on a supertype the receiver type conforms to (e.g. a protocol-extension
+     * method). Optional so external/test contexts compile without it.
+     */
+    getSupertypes?(typeName: string, language: Language): string[];
+    /**
+     * Look up a node by its id. Lets matchers derive the FROM-symbol's
+     * enclosing-class scope (Swift implicit-self method scoping, `this.X`
+     * member resolution). Optional so external/test contexts compile
+     * without it.
+     */
+    getNodeById?(id: string): Node | null;
+    /** Get cached import mappings for a file */
+    getImportMappings(filePath: string, language: Language): ImportMapping[];
+    /**
+     * Project import-path aliases (tsconfig/jsconfig `paths`). Returns
+     * `null` when the project doesn't define any. Cached per resolver
+     * instance — safe to call from any resolver code path. Optional so
+     * existing test fixtures and external context implementations
+     * compile without modification; production resolver implements it.
+     */
+    getProjectAliases?(): import('./path-aliases').AliasMap | null;
+    /**
+     * Go module info from `go.mod` at the project root. Returns `null`
+     * when the project has no `go.mod` (non-Go projects, pre-modules
+     * Go code, or projects whose modules live in subdirectories). Used
+     * by the Go branch of import resolution to distinguish in-module
+     * cross-package imports from third-party packages.
+     */
+    getGoModule?(): import('./go-module').GoModule | null;
+    /**
+     * Monorepo workspace member packages, keyed by declared package name.
+     * Returns `null` for single-package repos (no `workspaces` field).
+     * Lets the resolver treat `@scope/ui/sub` as a local import into the
+     * member's directory instead of an external npm package (#629).
+     */
+    getWorkspacePackages?(): import('./workspace-packages').WorkspacePackages | null;
+    /**
+     * Re-exports declared by a file (`export { x } from './other'`,
+     * `export * from './other'`). Empty array when the file has none.
+     * Optional so older callers compile; the import resolver follows
+     * re-export chains when this is provided.
+     */
+    getReExports?(filePath: string, language: Language): ReExport[];
+    /**
+     * List immediate subdirectories of `relativePath` (relative to the
+     * project root). Returns an empty array when the path doesn't exist
+     * or isn't a directory. Used by framework resolvers that need to
+     * walk build-system metadata (e.g. Cargo workspace globs). Optional
+     * so external context implementations and test fixtures compile
+     * without modification.
+     */
+    listDirectories?(relativePath: string): string[];
+    /**
+     * C/C++ include search directories (relative to project root),
+     * extracted from compile_commands.json or discovered by heuristic.
+     * Used by resolveCppIncludePath to search -I directories when
+     * relative resolution fails. Optional so existing callers compile.
+     */
+    getCppIncludeDirs?(): string[];
 }
 /**
  * Result of framework-specific file extraction.
  */
 export interface FrameworkExtractionResult {
-  /** Framework-specific nodes (e.g. routes) */
-  nodes: Node[]
-  /** Framework-specific unresolved references (e.g. route -> handler) */
-  references: UnresolvedRef[]
+    /** Framework-specific nodes (e.g. routes) */
+    nodes: Node[];
+    /** Framework-specific unresolved references (e.g. route -> handler) */
+    references: UnresolvedRef[];
 }
 /**
  * Framework-specific resolver
  */
 export interface FrameworkResolver {
-  /** Framework name */
-  name: string
-  /** Languages this framework applies to. If omitted, applies to all languages. */
-  languages?: Language[]
-  /** Detect if project uses this framework (project-level, called once at startup) */
-  detect(context: ResolutionContext): boolean
-  /** Resolve a reference using framework-specific patterns */
-  resolve(ref: UnresolvedRef, context: ResolutionContext): ResolvedRef | null
-  /**
-   * Extract framework-specific nodes and references from a file.
-   *
-   * Returns route nodes, middleware nodes, etc., plus unresolved references
-   * that link those nodes to handlers (view classes, controller methods,
-   * included modules). Unresolved references flow into the normal resolution
-   * pipeline; the framework's own `resolve()` is one of the strategies tried.
-   */
-  extract?(filePath: string, content: string): FrameworkExtractionResult
+    /** Framework name */
+    name: string;
+    /** Languages this framework applies to. If omitted, applies to all languages. */
+    languages?: Language[];
+    /** Detect if project uses this framework (project-level, called once at startup) */
+    detect(context: ResolutionContext): boolean;
+    /** Resolve a reference using framework-specific patterns */
+    resolve(ref: UnresolvedRef, context: ResolutionContext): ResolvedRef | null;
+    /**
+     * Opt a reference NAME through the resolver's name-exists pre-filter, even when
+     * no node is named that. Needed for dynamic dispatch where the call target is
+     * an attribute/descriptor, not a declared symbol (e.g. Django's
+     * `self._iterable_class(...)`, React effect callbacks). Returning true lets the
+     * ref reach `resolve()` instead of being dropped for having no name match.
+     */
+    claimsReference?(name: string): boolean;
+    /**
+     * Extract framework-specific nodes and references from a file.
+     *
+     * Returns route nodes, middleware nodes, etc., plus unresolved references
+     * that link those nodes to handlers (view classes, controller methods,
+     * included modules). Unresolved references flow into the normal resolution
+     * pipeline; the framework's own `resolve()` is one of the strategies tried.
+     */
+    extract?(filePath: string, content: string): FrameworkExtractionResult;
+    /**
+     * Cross-file finalization pass, called once after all per-file extraction
+     * completes (and again on every incremental sync). Used by frameworks where
+     * a symbol's final representation depends on a sibling file the per-file
+     * `extract()` never saw — e.g. NestJS's `RouterModule.register([...])`
+     * sets route prefixes for controllers declared elsewhere.
+     *
+     * Implementations return route/etc. nodes with mutated fields (typically
+     * `name`); the orchestrator persists each via `updateNode`. The node `id`
+     * MUST be preserved so existing edges (route → handler, etc.) stay intact;
+     * `qualifiedName` SHOULD be preserved so the pass stays idempotent — a
+     * second run can recover the original in-file form from `qualifiedName`.
+     */
+    postExtract?(context: ResolutionContext): Node[];
 }
 /**
  * Import mapping from a file
  */
 export interface ImportMapping {
-  /** Local name used in the file */
-  localName: string
-  /** Original exported name (may differ due to aliasing) */
-  exportedName: string
-  /** Source module/path */
-  source: string
-  /** Whether it's a default import */
-  isDefault: boolean
-  /** Whether it's a namespace import (import * as X) */
-  isNamespace: boolean
-  /** Resolved file path (if local) */
-  resolvedPath?: string
+    /** Local name used in the file */
+    localName: string;
+    /** Original exported name (may differ due to aliasing) */
+    exportedName: string;
+    /** Source module/path */
+    source: string;
+    /** Whether it's a default import */
+    isDefault: boolean;
+    /** Whether it's a namespace import (import * as X) */
+    isNamespace: boolean;
+    /** Resolved file path (if local) */
+    resolvedPath?: string;
 }
 /**
  * Re-export from a file: `export { x } from './other'` or
  * `export * from './other'`. Used by the resolver to chase
  * symbols through barrel files.
  */
-export type ReExport =
-  | {
-      kind: 'named'
-      /** Name as exported by THIS file. */
-      exportedName: string
-      /** Name in the upstream module (differs when renamed: `as`). */
-      originalName: string
-      /** Module specifier of the upstream module. */
-      source: string
-    }
-  | {
-      kind: 'wildcard'
-      /** Module specifier of the upstream module. */
-      source: string
-    }
-//# sourceMappingURL=types.d.ts.map
+export type ReExport = {
+    kind: 'named';
+    /** Name as exported by THIS file. */
+    exportedName: string;
+    /** Name in the upstream module (differs when renamed: `as`). */
+    originalName: string;
+    /** Module specifier of the upstream module. */
+    source: string;
+} | {
+    kind: 'wildcard';
+    /** Module specifier of the upstream module. */
+    source: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/resolution/types.d.ts.map

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

package/dist/resolution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resolution/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/resolution/workspace-packages.d.ts

@@ -0,0 +1,58 @@
+/**
+ * JS/TS workspace (monorepo) package resolution.
+ *
+ * npm / yarn / bun read member packages from the root `package.json`
+ * `workspaces` field; pnpm from `pnpm-workspace.yaml`. A cross-package
+ * import like `@scope/ui/widgets` is LOCAL to the monorepo, but to a
+ * single-package resolver it looks exactly like a third-party npm
+ * specifier — so `isExternalImport` flags it external and the
+ * consumer↔definition edge is never created. For component barrels
+ * (`export { default as X } from './x.svelte'`) that surfaces as a false
+ * `0 callers` on a live component (issue #629).
+ *
+ * This module maps each member package's declared `name` to its
+ * directory so the resolver can rewrite `@scope/ui/widgets` →
+ * `packages/ui/widgets` and then run normal extension/index resolution.
+ *
+ * Scope deliberately small for v1 (mirrors path-aliases.ts):
+ *   - reads `workspaces` (array OR `{ packages: [...] }`) from package.json,
+ *     plus a minimal `pnpm-workspace.yaml` `packages:` list
+ *   - expands one level of `*` / `**` globs (`packages/*`, `apps/*`)
+ *   - subpath resolution is directory-based (`@scope/ui/sub` → `<ui>/sub`);
+ *     it does NOT yet honour a member's `exports` map or `main` field
+ *   - returns null when the project declares no workspaces, so single-
+ *     package repos pay nothing and see no behaviour change.
+ */
+export interface WorkspacePackages {
+    /** Member package `name` → directory relative to projectRoot (posix). */
+    byName: Map<string, string>;
+    /**
+     * Member package `name` → its declared ENTRY FILE relative to projectRoot
+     * (posix), when the member's manifest names one (ohpm's oh-package.json5
+     * `"main": "Index.ets"`). Lets a bare `import { X } from "data"` resolve to
+     * the member's real barrel even when it doesn't follow an index-file
+     * convention — and independent of the CONSUMER's language (a `.ts` file
+     * importing an `.ets` barrel resolves without `.ets` in the TS candidate
+     * list). Absent for npm/pnpm members (their index conventions cover it).
+     */
+    entryByName?: Map<string, string>;
+}
+/**
+ * Load workspace member packages for `projectRoot`. Returns `null` when
+ * the project declares no workspaces (the common single-package case) —
+ * callers then skip all workspace logic.
+ *
+ * Cheap to call repeatedly only via the resolver's per-instance cache;
+ * this function itself touches the filesystem, so the resolver memoises it
+ * the same way it does {@link loadProjectAliases} / {@link loadGoModule}.
+ */
+export declare function loadWorkspacePackages(projectRoot: string): WorkspacePackages | null;
+/**
+ * Rewrite a bare workspace import to a path relative to projectRoot,
+ * WITHOUT an extension — the caller applies the language's extension/index
+ * resolution. `@scope/ui/widgets` → `packages/ui/widgets`; the bare package
+ * name `@scope/ui` → its directory. Returns `null` when no member package
+ * name matches.
+ */
+export declare function resolveWorkspaceImport(importPath: string, ws: WorkspacePackages): string | null;
+//# sourceMappingURL=workspace-packages.d.ts.map

package/dist/resolution/workspace-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-packages.d.ts","sourceRoot":"","sources":["../../src/resolution/workspace-packages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CA6BnF;AAoHD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,iBAAiB,GACpB,MAAM,GAAG,IAAI,CAoBf"}