@opencodehub/ingestion 0.1.0

package/dist/providers/ts-shared.js

@@ -0,0 +1,328 @@
+/**
+ * Shared TypeScript/TSX extraction logic.
+ *
+ * Both `.ts` and `.tsx` files share grammar semantics for imports, classes,
+ * interfaces, and type aliases — the only difference is JSX parsing, which
+ * the parse worker handles by selecting the `tsx` grammar. So both providers
+ * delegate to the functions in this file.
+ */
+import { getLine, innermostEnclosingDef, isInside, pairDefinitionsWithNames, splitNamedImports, stripComments, } from "./extract-helpers.js";
+// ---------------------------------------------------------------------------
+// Definitions
+// ---------------------------------------------------------------------------
+const TS_DEF_KIND_MAP = {
+    "definition.class": "Class",
+    "definition.interface": "Interface",
+    "definition.function": "Function",
+    "definition.method": "Method",
+    "definition.type": "TypeAlias",
+    "definition.constant": "Const",
+    "definition.module": "Namespace",
+};
+export function extractTsDefinitions(input) {
+    const { filePath, captures, sourceText } = input;
+    const paired = pairDefinitionsWithNames(captures);
+    const defCaptures = captures.filter((c) => c.tag.startsWith("definition."));
+    const out = [];
+    for (const { def, name } of paired) {
+        const kind = TS_DEF_KIND_MAP[def.tag];
+        if (kind === undefined)
+            continue;
+        // Derive owner for nested definitions (e.g. methods inside a class).
+        const ownerDef = innermostEnclosingDef(def, defCaptures);
+        let owner;
+        if (ownerDef !== undefined) {
+            const ownerPaired = paired.find((p) => p.def === ownerDef);
+            if (ownerPaired !== undefined)
+                owner = ownerPaired.name.text;
+        }
+        const qualifiedName = owner !== undefined ? `${owner}.${name.text}` : name.text;
+        // Use the header line for export/declaration analysis.
+        const headerLine = getLine(sourceText, def.startLine);
+        const exported = isTsDefExported(headerLine, kind, ownerDef !== undefined);
+        const rec = {
+            kind,
+            name: name.text,
+            qualifiedName,
+            filePath,
+            startLine: def.startLine,
+            endLine: def.endLine,
+            isExported: exported,
+            ...(owner !== undefined ? { owner } : {}),
+            ...(kind === "Const" ? { isConst: /\bconst\b/.test(headerLine) } : {}),
+        };
+        out.push(rec);
+    }
+    return out;
+}
+/**
+ * TS/JS export detection. A declaration is exported when the header line
+ * contains an `export` keyword. For class members the parent's export state
+ * controls visibility — downstream phases may re-check via `isExported()`.
+ */
+function isTsDefExported(headerLine, _kind, isNested) {
+    if (isNested) {
+        // Method/field visibility is governed by its class, not the member line.
+        // Treat as exported when `public` or no explicit modifier (TS default).
+        if (/\bprivate\b/.test(headerLine) || /\bprotected\b/.test(headerLine))
+            return false;
+        return true;
+    }
+    return /\bexport\b/.test(headerLine);
+}
+// ---------------------------------------------------------------------------
+// Calls
+// ---------------------------------------------------------------------------
+export function extractTsCalls(input) {
+    const { filePath, captures, definitions } = input;
+    const defCaptures = captures.filter((c) => c.tag.startsWith("definition."));
+    const callRefs = captures.filter((c) => c.tag === "reference.call");
+    const out = [];
+    for (const ref of callRefs) {
+        // The `@name` capture sits inside the `@reference.call` range.
+        const innerName = findNameInside(captures, ref);
+        const calleeName = innerName?.text ?? ref.text;
+        const enclosingDef = innermostEnclosingDef(ref, defCaptures);
+        const callerQualifiedName = enclosingDef
+            ? qualifiedForCapture(enclosingDef, definitions)
+            : "<module>";
+        // Distinguish `obj.method()` from bare `fn()`: the call capture range
+        // starts where the member expression begins, so reading the source line
+        // in front of the name lets us infer a receiver.
+        const receiver = inferTsReceiver(ref, innerName);
+        out.push({
+            callerQualifiedName,
+            calleeName,
+            filePath,
+            startLine: ref.startLine,
+            ...(receiver !== undefined ? { calleeOwner: receiver } : {}),
+        });
+    }
+    return out;
+}
+function findNameInside(captures, outer) {
+    let best;
+    for (const c of captures) {
+        if (c.tag !== "name")
+            continue;
+        if (!isInside(c, outer))
+            continue;
+        if (best === undefined || c.startLine < best.startLine)
+            best = c;
+    }
+    return best;
+}
+function inferTsReceiver(ref, name) {
+    if (name === undefined)
+        return undefined;
+    // `ref.text` is the full call expression source (e.g. `this.foo(x)` or
+    // `obj.method(y)`). Everything before the last `.` ahead of the callee
+    // name is the receiver expression.
+    const text = ref.text;
+    const nameText = name.text;
+    const idx = text.lastIndexOf(`.${nameText}`);
+    if (idx <= 0)
+        return undefined;
+    const receiverExpr = text.slice(0, idx).trim();
+    if (receiverExpr === "")
+        return undefined;
+    // We only keep simple receivers (identifiers or `this`). Chained
+    // expressions like `a.b.c.method()` surface the full chain — keep the
+    // full prefix so downstream typing can further resolve it.
+    if (receiverExpr === "this")
+        return "this";
+    // A pure identifier receiver is the most common and useful case.
+    if (/^[A-Za-z_$][\w$]*$/.test(receiverExpr))
+        return receiverExpr;
+    return receiverExpr;
+}
+function qualifiedForCapture(def, definitions) {
+    for (const d of definitions) {
+        if (d.startLine === def.startLine)
+            return d.qualifiedName;
+    }
+    return "<module>";
+}
+// ---------------------------------------------------------------------------
+// Imports
+// ---------------------------------------------------------------------------
+const IMPORT_NAMED_OR_NS = /^\s*import\s+(.+?)\s+from\s+(['"])([^'"]+)\2\s*;?\s*$/;
+const IMPORT_BARE = /^\s*import\s+(['"])([^'"]+)\1\s*;?\s*$/;
+const DYNAMIC_IMPORT = /import\s*\(\s*(['"])([^'"]+)\1\s*\)/g;
+const REQUIRE_CALL = /require\s*\(\s*(['"])([^'"]+)\1\s*\)/g;
+/**
+ * Parse TS/JS import statements. Covers:
+ *   - `import X from "m"`
+ *   - `import { a, b as c } from "m"`
+ *   - `import * as ns from "m"`
+ *   - `import X, { a } from "m"`
+ *   - `import "side-effect"`
+ *   - `import("dyn")` anywhere in source
+ *   - `require("x")` for CommonJS
+ *
+ * `.js` / `.ts` / `.mjs` / `.cjs` suffixes are preserved verbatim in `source`;
+ * consumers can strip via `provider.preprocessImportPath`.
+ */
+export function extractTsImports(input) {
+    const { filePath, sourceText } = input;
+    const stripped = stripComments(sourceText);
+    const lines = stripped.split("\n");
+    const out = [];
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (line === "" || !line.startsWith("import")) {
+            // still handle dynamic imports / requires below via file-level scan
+            continue;
+        }
+        const bare = IMPORT_BARE.exec(line);
+        if (bare !== null) {
+            out.push({ filePath, source: bare[2], kind: "named" });
+            continue;
+        }
+        const named = IMPORT_NAMED_OR_NS.exec(line);
+        if (named === null)
+            continue;
+        const clause = named[1].trim();
+        const source = named[3];
+        for (const entry of parseTsImportClause(clause)) {
+            out.push({ filePath, source, ...entry });
+        }
+    }
+    // Dynamic imports + CommonJS requires: scan the whole stripped source.
+    for (const m of stripped.matchAll(DYNAMIC_IMPORT)) {
+        out.push({ filePath, source: m[2], kind: "namespace" });
+    }
+    for (const m of stripped.matchAll(REQUIRE_CALL)) {
+        out.push({ filePath, source: m[2], kind: "namespace" });
+    }
+    return out;
+}
+function parseTsImportClause(clause) {
+    const out = [];
+    let remaining = clause;
+    // `import X` followed optionally by `, { a, b }` or `, * as ns`
+    const defaultMatch = /^([A-Za-z_$][\w$]*)(\s*,\s*)?/.exec(remaining);
+    if (defaultMatch !== null && !/^[A-Za-z_$][\w$]*\s*\{/.test(remaining)) {
+        const defaultName = defaultMatch[1];
+        // Must not be `from` (which would indicate no default and we mis-matched).
+        if (defaultName !== "from") {
+            out.push({ kind: "default", localAlias: defaultName });
+            remaining = remaining.slice(defaultMatch[0].length).trim();
+        }
+    }
+    // `* as ns`
+    const nsMatch = /^\*\s+as\s+([A-Za-z_$][\w$]*)\s*$/.exec(remaining);
+    if (nsMatch !== null) {
+        out.push({
+            kind: "namespace",
+            isWildcard: true,
+            localAlias: nsMatch[1],
+        });
+        return out;
+    }
+    // `{ a, b as c }`
+    const namedMatch = /^\{([\s\S]*)\}\s*$/.exec(remaining);
+    if (namedMatch !== null) {
+        const entries = splitNamedImports(namedMatch[1]);
+        const names = entries.map((e) => e.alias ?? e.name);
+        if (names.length > 0) {
+            out.push({ kind: "named", importedNames: names });
+        }
+    }
+    return out;
+}
+export function preprocessTsImportPath(raw) {
+    // Strip `.js` / `.ts` / `.mjs` / `.cjs` / `.tsx` / `.jsx` suffixes so TS
+    // import specifiers collapse onto their source-side files during symbol
+    // lookup. Only strip when the suffix is a known script extension.
+    return raw.replace(/\.(?:js|ts|mjs|cjs|jsx|tsx)$/, "");
+}
+// ---------------------------------------------------------------------------
+// Heritage
+// ---------------------------------------------------------------------------
+export function extractTsHeritage(input) {
+    const { filePath, captures, definitions } = input;
+    // The unified query emits:
+    //   `(implements_clause (type_identifier) @name @reference.interface)`
+    // for `implements I1, I2`. For `extends Parent` we don't have a dedicated
+    // capture — fall back to regex-scanning the class/interface header line.
+    const out = [];
+    // IMPLEMENTS via capture.
+    const implementsRefs = captures.filter((c) => c.tag === "reference.interface");
+    for (const ref of implementsRefs) {
+        const child = findChildDef(ref, definitions);
+        if (child === undefined)
+            continue;
+        out.push({
+            childQualifiedName: child,
+            parentName: ref.text,
+            filePath,
+            relation: "IMPLEMENTS",
+            startLine: ref.startLine,
+        });
+    }
+    // EXTENDS via regex on definition header lines. Covers:
+    //   `class Foo extends Bar { ... }`
+    //   `interface Foo extends A, B { ... }`
+    for (const def of definitions) {
+        if (def.kind !== "Class" && def.kind !== "Interface")
+            continue;
+        const headerLine = getLine(input.captures[0]?.text ?? "", 0); // dummy; replaced below
+        const rawLine = readHeaderFromCaptures(input, def.startLine);
+        const extendsMatch = /extends\s+([^\s{]+(?:\s*,\s*[^\s{]+)*)/.exec(rawLine ?? headerLine);
+        if (extendsMatch === null)
+            continue;
+        const list = extendsMatch[1]
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        for (const parent of list) {
+            // Strip generic args: `Bar<T>` -> `Bar`.
+            const bare = parent.replace(/<.*$/, "").trim();
+            if (bare.length === 0)
+                continue;
+            out.push({
+                childQualifiedName: def.qualifiedName,
+                parentName: bare,
+                filePath,
+                relation: "EXTENDS",
+                startLine: def.startLine,
+            });
+        }
+    }
+    return out;
+}
+function readHeaderFromCaptures(input, startLine) {
+    // The extract-heritage inputs don't include `sourceText`; we fall back
+    // to reconstructing from the largest capture's text. Providers pass the
+    // class/interface definition capture whose text starts at startLine.
+    for (const c of input.captures) {
+        if (c.tag.startsWith("definition.") && c.startLine === startLine) {
+            // Return only the first line of the capture text (the header).
+            const idx = c.text.indexOf("\n");
+            return idx === -1 ? c.text : c.text.slice(0, idx);
+        }
+    }
+    return "";
+}
+function findChildDef(ref, definitions) {
+    // Walk definitions and find the one whose range contains `ref.startLine`
+    // and is a class/interface. Prefer the nearest enclosing one.
+    let best;
+    for (const d of definitions) {
+        if (d.kind !== "Class" && d.kind !== "Interface")
+            continue;
+        if (ref.startLine < d.startLine || ref.startLine > d.endLine)
+            continue;
+        if (best === undefined || d.startLine > best.startLine)
+            best = d;
+    }
+    return best?.qualifiedName;
+}
+// ---------------------------------------------------------------------------
+// isExported bridge
+// ---------------------------------------------------------------------------
+export function tsIsExported(def) {
+    return def.isExported;
+}
+//# sourceMappingURL=ts-shared.js.map

package/dist/providers/ts-shared.js.map

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

package/dist/providers/tsx.d.ts

@@ -0,0 +1,7 @@
+import type { LanguageProvider } from "./types.js";
+/**
+ * TSX provider. Same semantics as TypeScript for imports/classes/types;
+ * the parse worker already selects the `tsx` grammar for JSX-aware AST.
+ */
+export declare const tsxProvider: LanguageProvider;
+//# sourceMappingURL=tsx.d.ts.map

package/dist/providers/tsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsx.d.ts","sourceRoot":"","sources":["../../src/providers/tsx.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,gBAuEzB,CAAC"}

package/dist/providers/tsx.js

@@ -0,0 +1,79 @@
+import { detectHttpCallsTsJs } from "./http-detect.js";
+import { extractTsCalls, extractTsDefinitions, extractTsHeritage, extractTsImports, preprocessTsImportPath, tsIsExported, } from "./ts-shared.js";
+import { extractTsFamilyPropertyAccesses } from "./typescript-family-accesses.js";
+/**
+ * TSX provider. Same semantics as TypeScript for imports/classes/types;
+ * the parse worker already selects the `tsx` grammar for JSX-aware AST.
+ */
+export const tsxProvider = {
+    id: "tsx",
+    extensions: [".tsx"],
+    importSemantics: "named",
+    mroStrategy: "first-wins",
+    typeConfig: { structural: true, nominal: false, generics: true },
+    heritageEdge: "EXTENDS",
+    inferImplicitReceiver: () => "this",
+    preprocessImportPath: preprocessTsImportPath,
+    isExportedIdentifier: (_name, context) => context === "top-level",
+    // Shares the TS-family stack-graphs backend — see typescript.ts.
+    resolverStrategyName: "stack-graphs",
+    complexityDefinitionKinds: [
+        "function_declaration",
+        "function_expression",
+        "arrow_function",
+        "method_definition",
+        "method_signature",
+        "generator_function_declaration",
+        "generator_function",
+    ],
+    halsteadOperatorKinds: [
+        "+",
+        "-",
+        "*",
+        "/",
+        "%",
+        "=",
+        "==",
+        "===",
+        "!=",
+        "!==",
+        "<",
+        ">",
+        "<=",
+        ">=",
+        "&&",
+        "||",
+        "!",
+        "&",
+        "|",
+        "^",
+        "~",
+        "<<",
+        ">>",
+        ">>>",
+        "+=",
+        "-=",
+        "*=",
+        "/=",
+        "%=",
+        "&=",
+        "|=",
+        "^=",
+        "<<=",
+        ">>=",
+        "?",
+        ":",
+        "??",
+        "?.",
+        "...",
+        "=>",
+    ],
+    extractDefinitions: extractTsDefinitions,
+    extractCalls: extractTsCalls,
+    extractImports: extractTsImports,
+    isExported: (def) => tsIsExported(def),
+    extractHeritage: extractTsHeritage,
+    detectOutboundHttp: ({ sourceText }) => detectHttpCallsTsJs(sourceText),
+    extractPropertyAccesses: extractTsFamilyPropertyAccesses,
+};
+//# sourceMappingURL=tsx.js.map

package/dist/providers/tsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsx.js","sourceRoot":"","sources":["../../src/providers/tsx.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAElF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,EAAE,EAAE,KAAK;IACT,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO;IACxB,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;IAChE,YAAY,EAAE,SAAS;IACvB,qBAAqB,EAAE,GAAG,EAAE,CAAC,MAAM;IACnC,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,WAAW;IACjE,iEAAiE;IACjE,oBAAoB,EAAE,cAAc;IACpC,yBAAyB,EAAE;QACzB,sBAAsB;QACtB,qBAAqB;QACrB,gBAAgB;QAChB,mBAAmB;QACnB,kBAAkB;QAClB,gCAAgC;QAChC,oBAAoB;KACrB;IACD,qBAAqB,EAAE;QACrB,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,KAAK;QACL,GAAG;QACH,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,GAAG;QACH,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,IAAI;KACL;IAED,kBAAkB,EAAE,oBAAoB;IACxC,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,CAAC,GAAwB,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC;IAC3D,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,CAAC;IACvE,uBAAuB,EAAE,+BAA+B;CACzD,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,166 @@
+import type { LanguageId } from "@opencodehub/core-types";
+import type { ParseCapture } from "../parse/types.js";
+import type { ExtractedCall, ExtractedDefinition, ExtractedHeritage, ExtractedImport, PropertyAccess } from "./extraction-types.js";
+export type { LanguageId } from "@opencodehub/core-types";
+/**
+ * Strategy used to linearize a class's method resolution order.
+ *  - `c3`: Python / Dylan — full C3 linearization, raises on ambiguity.
+ *  - `first-wins`: TypeScript / JavaScript / Rust — left-to-right source order.
+ *  - `single-inheritance`: Java / C# / Kotlin — single `extends` chain.
+ *  - `none`: Go and similar — no traditional inheritance walk.
+ */
+export type MroStrategyName = "c3" | "first-wins" | "single-inheritance" | "none";
+/**
+ * Shape of how the language expresses module-to-module imports.
+ *  - `named`:            `import { foo } from "bar";` (TS/JS/Java/C#/Rust).
+ *  - `namespace`:        `import mod` / `from mod import x` (Python).
+ *  - `package-wildcard`: `import "fmt"` pulls the whole package symbol set (Go).
+ */
+export type ImportSemantics = "named" | "namespace" | "package-wildcard";
+export interface TypeExtractionConfig {
+    /** Structural typing (TS interfaces, Python duck typing). */
+    readonly structural: boolean;
+    /** Nominal typing (Java / C# / Rust / Go). */
+    readonly nominal: boolean;
+    /** Language has generics / parametric polymorphism. */
+    readonly generics: boolean;
+}
+/** Inputs to {@link LanguageProvider.extractDefinitions}. */
+export interface ExtractDefinitionsInput {
+    readonly filePath: string;
+    readonly captures: readonly ParseCapture[];
+    readonly sourceText: string;
+}
+/** Inputs to {@link LanguageProvider.extractCalls}. */
+export interface ExtractCallsInput {
+    readonly filePath: string;
+    readonly captures: readonly ParseCapture[];
+    readonly definitions: readonly ExtractedDefinition[];
+}
+/** Inputs to {@link LanguageProvider.extractImports}. */
+export interface ExtractImportsInput {
+    readonly filePath: string;
+    readonly sourceText: string;
+}
+/** Inputs to {@link LanguageProvider.extractHeritage}. */
+export interface ExtractHeritageInput {
+    readonly filePath: string;
+    readonly captures: readonly ParseCapture[];
+    readonly definitions: readonly ExtractedDefinition[];
+}
+/**
+ * An outbound HTTP call site detected statically from source.
+ *
+ * `urlTemplate` preserves the literal URL or template (e.g. `"/users/:id"`,
+ * `"https://api.example.com/users/{id}"`). Downstream phases normalize path
+ * templates so `{id}` and `:id` hash to the same route target.
+ */
+export interface HttpCall {
+    readonly method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | "TRACE";
+    readonly urlTemplate: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    /** Client library: `fetch`, `axios`, `requests`, `httpx`, `restTemplate`, `okhttp`, etc. */
+    readonly clientLibrary: string;
+}
+/** Inputs to {@link LanguageProvider.detectOutboundHttp}. */
+export interface DetectOutboundHttpInput {
+    readonly filePath: string;
+    readonly captures: readonly ParseCapture[];
+    readonly sourceText: string;
+}
+/**
+ * Inputs to {@link LanguageProvider.extractPropertyAccesses}. Per-file bundle
+ * feeding the ACCESSES-edge walker. `definitions` are the extract output of
+ * this same file so the walker can attach every access to an enclosing
+ * symbol by (startLine <= line <= endLine) containment.
+ */
+export interface ExtractionContext {
+    readonly filePath: string;
+    readonly captures: readonly ParseCapture[];
+    readonly sourceText: string;
+    readonly definitions: readonly ExtractedDefinition[];
+}
+export interface LanguageProvider {
+    readonly id: LanguageId;
+    readonly extensions: readonly string[];
+    readonly importSemantics: ImportSemantics;
+    readonly mroStrategy: MroStrategyName;
+    readonly typeConfig: TypeExtractionConfig;
+    /**
+     * Edge label used to express the type-hierarchy relation. Go has neither
+     * extends nor implements, so it is `null`.
+     */
+    readonly heritageEdge: "EXTENDS" | "IMPLEMENTS" | null;
+    /** Strip `.js` suffix for TS, resolve `__init__.py`, etc. */
+    readonly preprocessImportPath?: (raw: string) => string;
+    /** Is this identifier exported from its declaration site? */
+    readonly isExportedIdentifier?: (name: string, context: "top-level" | "class-member") => boolean;
+    /** Name used for the implicit receiver inside a method body. */
+    readonly inferImplicitReceiver?: (callerKind: string) => "self" | "this" | undefined;
+    /**
+     * Optional opt-in for an alternative reference-resolution backend. Unset
+     * providers use the three-tier walker (`"three-tier-default"`). Known
+     * values map to the registry in `resolution/resolver-strategy.ts`:
+     *   - `"stack-graphs"` — clean-room stack-graphs evaluator (Python only).
+     * Unknown values silently fall back to the default.
+     */
+    readonly resolverStrategyName?: string;
+    /**
+     * Tree-sitter node-type names that start a new function/method/constructor
+     * body for complexity counting. The complexity phase dispatches on these;
+     * providers without a table are silently skipped by the phase.
+     */
+    readonly complexityDefinitionKinds?: readonly string[];
+    /**
+     * Tree-sitter node-type names that count as Halstead operators. Every other
+     * leaf/identifier in the body counts as an operand. Omission disables the
+     * Halstead-volume computation for that language (phase emits complexity
+     * only).
+     */
+    readonly halsteadOperatorKinds?: readonly string[];
+    /**
+     * Given unified parse captures for a file, emit one record per symbol
+     * defined in the file. Qualified names encode nesting (e.g. `Foo.bar`).
+     */
+    extractDefinitions(input: ExtractDefinitionsInput): readonly ExtractedDefinition[];
+    /**
+     * Emit one record per call site. Downstream phases apply 3-tier + MRO
+     * resolution; this hook only identifies the callee name plus any
+     * inferrable receiver (`this` / `self` / typed prefix).
+     */
+    extractCalls(input: ExtractCallsInput): readonly ExtractedCall[];
+    /**
+     * Parse import statements from source text. Regex-based rather than AST-
+     * based because the captures we have today are symbol-oriented; imports
+     * add very little parse-cost on top at MVP.
+     */
+    extractImports(input: ExtractImportsInput): readonly ExtractedImport[];
+    /**
+     * Predicate companion to {@link ExtractedDefinition.isExported} — useful
+     * when downstream phases want to re-check a bare definition record.
+     */
+    isExported(def: ExtractedDefinition): boolean;
+    /**
+     * Emit inheritance, trait-impl, and interface-implements edges.
+     */
+    extractHeritage(input: ExtractHeritageInput): readonly ExtractedHeritage[];
+    /**
+     * Detect outbound HTTP call sites: `fetch("/api/users")`,
+     * `axios.post(url, body)`, `requests.get(url)`, `restTemplate.getForObject(url)`, etc.
+     *
+     * Optional: providers that do not implement this hook are treated as
+     * "no outbound HTTP detection" silently. Return an empty array for
+     * languages / client libraries the provider does not recognise.
+     */
+    detectOutboundHttp?(input: DetectOutboundHttpInput): readonly HttpCall[];
+    /**
+     * Emit one {@link PropertyAccess} record per `receiver.property` read or
+     * write observed inside a function/method body. Providers that do not
+     * implement this hook emit no ACCESSES edges. Returned records must be
+     * sorted by `(enclosingSymbolId, propertyName, startLine)` for
+     * downstream determinism.
+     */
+    extractPropertyAccesses?(input: ExtractionContext): readonly PropertyAccess[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/providers/types.js

@@ -0,0 +1,7 @@
+// Clean-room language-provider types for OpenCodeHub ingestion.
+//
+// `LanguageId` has a single source of truth in `@opencodehub/core-types`;
+// this module re-exports it for providers that still reach for
+// `../providers/types.js`.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,0EAA0E;AAC1E,+DAA+D;AAC/D,2BAA2B"}

package/dist/providers/typescript-family-accesses.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared property-access extractor for TypeScript / TSX / JavaScript.
+ *
+ * All three languages use the same member-expression surface syntax and the
+ * same assignment operators. This module wires the generic walker in
+ * `extract/property-access.ts` to that dialect and converts the walker's
+ * output into {@link PropertyAccess} records anchored to the enclosing
+ * Function / Method / Constructor's `NodeId`.
+ */
+import type { PropertyAccess } from "./extraction-types.js";
+import type { ExtractionContext } from "./types.js";
+/** Entry point wired into TS, TSX, and JS provider objects. */
+export declare function extractTsFamilyPropertyAccesses(input: ExtractionContext): readonly PropertyAccess[];
+//# sourceMappingURL=typescript-family-accesses.d.ts.map

package/dist/providers/typescript-family-accesses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-family-accesses.d.ts","sourceRoot":"","sources":["../../src/providers/typescript-family-accesses.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAuB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,+DAA+D;AAC/D,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,iBAAiB,GACvB,SAAS,cAAc,EAAE,CAE3B"}