@jafreck/lore 0.3.5 → 0.3.7

package/dist/indexer/stages/scip-source.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @module indexer/stages/scip-source
+ *
+ * Pipeline stage: for SCIP-covered languages, populate `files`, `symbols`,
+ * `symbol_refs`, `type_refs`, `symbol_relationships`, and `file_imports`
+ * **directly from the SCIP index** — bypassing tree-sitter entirely.
+ *
+ * This is the SCIP-primary architecture.  SCIP is the source of truth for
+ * both the symbol table and the call graph.  For each SCIP document:
+ *
+ * 1. **Symbols**: Definition occurrences → `symbols` rows; kinds inferred
+ *    from SCIP descriptor suffixes; spans from `enclosing_range`.
+ * 2. **Refs**: Non-definition, non-local reference occurrences →
+ *    `symbol_refs` rows with both `caller_id` and `callee_id` resolved
+ *    using containment (which symbol's span encloses this ref?) and
+ *    definition lookup (where is the referenced SCIP symbol defined?).
+ *
+ * SCIP refs are inserted **pre-resolved** with `resolution_method =
+ * 'scip_definition'`.  The downstream resolution stage only processes
+ * refs from non-SCIP languages.
+ *
+ * ## Data written
+ *
+ * Same tables as `SourceIndexStage`: `files`, `symbols`, `symbols_fts`,
+ * `symbol_refs`, `type_refs`, `symbol_relationships`, `file_imports`.
+ *
+ * ## Pipeline ordering
+ *
+ * This stage runs **before** `SourceIndexStage`.  It stores which
+ * languages and files it handled in `context.scipSourcedLanguages` and
+ * `context.scipSourcedFiles` so the tree-sitter path can skip them.
+ */
+import type { PipelineContext, PipelineStage } from '../pipeline.js';
+/**
+ * Infer a Lore symbol `kind` from a SCIP symbol string.
+ *
+ * SCIP symbol syntax:  `<scheme> <package> (<descriptor>)+`
+ * Descriptor suffixes:
+ *   - `/`  → Namespace (module/package)
+ *   - `#`  → Type (class, interface, enum)
+ *   - `.`  → Term (variable, constant, property, enum member)
+ *   - `().` → Method/Function
+ *   - `(name)` → Parameter
+ *   - `[name]` → Type parameter
+ *   - `name:` → Meta (object property)
+ */
+declare function inferKindFromScipSymbol(scipSymbol: string, docHint: string): string;
+/**
+ * Extract a human-readable name from a SCIP symbol string.
+ *
+ * E.g. `scip-typescript npm pkg 1.0 src/\`file.ts\`/MyClass#myMethod().`
+ * → `myMethod`
+ */
+declare function extractNameFromScipSymbol(scipSymbol: string): string;
+/**
+ * Estimate the end line of a symbol whose `enclosing_range` was absent.
+ *
+ * Strategy: from the definition line, scan forward for curly-brace blocks
+ * (classes, functions, structs in C-family / Rust / Go / Java / etc.) or
+ * indentation-based blocks (Python).  If nothing works, scan to the next
+ * definition or EOF.
+ */
+declare function estimateSymbolEndLine(sourceLines: string[], defLine: number, nextDefLine: number | null): number;
+/**
+ * Infer a `ref_kind` for a type reference from its surrounding source context.
+ *
+ * Reads the source line at `refLine` and applies simple pattern matching to
+ * distinguish parameter, return, field, variable, generic_arg and bound usages.
+ * Falls back to `'other'` when the context is ambiguous.
+ */
+declare function inferTypeRefKind(sourceLines: string[], refLine: number, refChar: number): string;
+export declare class ScipSourceStage implements PipelineStage {
+    readonly name = "scip-source";
+    execute(context: PipelineContext, mode: 'build' | 'update'): Promise<void>;
+    dispose(): Promise<void>;
+    private loadScipIndex;
+}
+/**
+ * Classify a SCIP symbol reference into the graph edge type it represents.
+ *
+ * SCIP descriptor suffixes:
+ *   `().`  → Method/Function → call edge (symbol_refs)
+ *   `#`    → Type            → type edge (type_refs)
+ *   `.`    → Term (variable, property, constant, enum member) → skip
+ *   `/`    → Namespace (module) → skip
+ *   `:`    → Meta (object property) → skip
+ *   `)`    → Parameter → skip
+ *   `]`    → Type parameter → type edge (type_refs)
+ */
+declare function classifyScipReference(scipSymbol: string): 'call' | 'type' | 'skip';
+/**
+ * Extract the actual import/require path from a source line.
+ *
+ * Handles common patterns across languages:
+ * - JS/TS: `import ... from 'path'`, `require('path')`
+ * - Python: `import path`, `from path import ...`
+ * - Go: `"path"`  (inside import block)
+ * - Java/Kotlin/Scala: `import path.to.Class`
+ * - Rust: `use path::to::item`
+ * - C/C++: `#include "path"` or `#include <path>`
+ * - Ruby: `require 'path'`, `require_relative 'path'`
+ * - PHP: `use Path\\To\\Class`
+ * - C#: `using Namespace.Name`
+ * - Dart: `import 'path'`
+ *
+ * Returns `null` when no recognizable import pattern is found.
+ */
+declare function extractImportPathFromSource(line: string): string | null;
+/**
+ * Determine the Lore language for a SCIP document.
+ *
+ * Many SCIP indexers (including scip-typescript) leave the `language` field
+ * blank.  When that happens, infer from the file extension.
+ */
+declare function inferLoreLanguage(scipLanguage: string, relativePath: string): string | null;
+export { estimateSymbolEndLine as _estimateSymbolEndLine, inferTypeRefKind as _inferTypeRefKind, extractImportPathFromSource as _extractImportPathFromSource, inferKindFromScipSymbol as _inferKindFromScipSymbol, inferLoreLanguage as _inferLoreLanguage, classifyScipReference as _classifyScipReference, extractNameFromScipSymbol as _extractNameFromScipSymbol, };
+//# sourceMappingURL=scip-source.d.ts.map

package/dist/indexer/stages/scip-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scip-source.d.ts","sourceRoot":"","sources":["../../../src/indexer/stages/scip-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAaH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAarE;;;;;;;;;;;;GAYG;AACH,iBAAS,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsC5E;AAED;;;;;GAKG;AACH,iBAAS,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqB7D;AAkBD;;;;;;;GAOG;AACH,iBAAS,qBAAqB,CAC5B,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,CA2CR;AAID;;;;;;GAMG;AACH,iBAAS,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiCzF;AAID,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,iBAAiB;IAExB,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwgB1E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAMhB,aAAa;CA4D5B;AAID;;;;;;;;;;;GAWG;AACH,iBAAS,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAgB3E;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8ChE;AAqDD;;;;;GAKG;AACH,iBAAS,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAepF;AAKD,OAAO,EACL,qBAAqB,IAAI,sBAAsB,EAC/C,gBAAgB,IAAI,iBAAiB,EACrC,2BAA2B,IAAI,4BAA4B,EAC3D,uBAAuB,IAAI,wBAAwB,EACnD,iBAAiB,IAAI,kBAAkB,EACvC,qBAAqB,IAAI,sBAAsB,EAC/C,yBAAyB,IAAI,0BAA0B,GACxD,CAAC"}