@wrongstack/tools 0.299.0 → 0.300.0

package/dist/codebase-index/import-extractor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Import extraction for languages without an AST parser.
+ *
+ * Deliberately imports only — no call or type references. An import statement
+ * has a rigid, line-anchored syntax that a regex reads correctly; a call site
+ * does not, and a regex "call graph" produces edges that look authoritative
+ * while being mostly wrong. Dependency edges are what the Code Atlas is built
+ * around, so extracting those well beats extracting everything badly.
+ *
+ * Languages with a real parser (TS/JS via the compiler API, Go and Python via
+ * their own `ast` modules) never reach this module.
+ */
+import type { Ref, SymbolLang } from './schema.js';
+/** Only the leading window is scanned, mirroring the generic symbol extractor. */
+export declare const IMPORT_MAX_FILE_CHARS: number;
+/** Upper bound on imports recorded per file. */
+export declare const IMPORT_MAX_PER_FILE = 400;
+/**
+ * The name a specifier refers to.
+ *
+ * Path-like and namespace-like specifiers need opposite treatment of the dot:
+ * in `engine/core.h` it introduces a file extension to strip, in
+ * `com.example.Helper` it is the segment separator. The presence of a path
+ * separator is what tells them apart.
+ */
+export declare function lastSegment(specifier: string): string;
+/** True when this language's imports are extracted here rather than by a parser. */
+export declare function hasImportPatterns(lang: SymbolLang): boolean;
+/**
+ * Extract `import` refs from source text. Never throws.
+ *
+ * Returned refs carry `fromId: 0`; the indexer rewrites it to the owning symbol.
+ */
+export declare function extractImports(opts: {
+    content: string;
+    lang: SymbolLang;
+    maxImports?: number;
+}): Ref[];
+//# sourceMappingURL=import-extractor.d.ts.map