@opencodehub/ingestion 0.1.0

package/dist/providers/resolution/stack-graphs-ts.js

@@ -0,0 +1,372 @@
+// TypeScript / TSX / JavaScript ResolverStrategy backed by the clean-room
+// stack-graphs evaluator. Mirrors `stack-graphs-python.ts` but handles the
+// TS-family import/export shapes instead of Python's from/import grammar.
+//
+// Shapes modelled here:
+//   * `import { foo } from "./bar"`          — named import.
+//   * `import foo from "./bar"`              — default import (binds local).
+//   * `import * as ns from "./bar"`          — namespace import (member push).
+//   * `import type { X } from "./y"`         — type-only import, recorded.
+//   * `export { x } from "./bar"`            — named re-export.
+//   * `export { default as foo } from "./b"` — default re-export renamed.
+//   * `export * from "./bar"`                — barrel-star re-export.
+//   * `export default fn|expr`               — default export pop.
+//   * `export function foo`                  — named export pop.
+//
+// We share `stack-graphs/partial-path-engine.ts` for the BFS; the node/edge
+// shape is different from the Python builder though, so we keep our own
+// builder inline rather than extending the shared Python builder.
+//
+// Like the Python strategy we register under the name `"stack-graphs"`. The
+// router in `resolver-strategy.ts` dispatches by `provider.id`, so both
+// strategies coexist under the same opt-in name.
+import { CONFIDENCE_BY_TIER, resolve as threeTierResolve } from "./context.js";
+import { resolveReference } from "./stack-graphs/partial-path-engine.js";
+import { STACK_GRAPHS_HIT_CONFIDENCE } from "./stack-graphs/types.js";
+const TS_STORE = {
+    graphs: new Map(),
+    fallbacks: 0,
+    stackGraphHits: 0,
+};
+/**
+ * Prime the TS cache with per-file stack graphs. Called by the ingestion
+ * parse phase before resolution runs. Uses a store separate from Python's.
+ */
+export function registerTsStackGraphs(graphs) {
+    TS_STORE.graphs.clear();
+    for (const [k, v] of graphs)
+        TS_STORE.graphs.set(k, v);
+}
+/** For tests: drop all TS graphs and reset counters. */
+export function clearTsStackGraphsForTests() {
+    TS_STORE.graphs.clear();
+    TS_STORE.fallbacks = 0;
+    TS_STORE.stackGraphHits = 0;
+}
+/** Stats surfaced to the pipeline for telemetry. */
+export function getTsStackGraphsStats() {
+    return { fallbacks: TS_STORE.fallbacks, hits: TS_STORE.stackGraphHits };
+}
+/** Does this query belong to a TS-family provider? */
+function isTsFamilyQuery(q) {
+    const id = q.provider.id;
+    return id === "typescript" || id === "tsx" || id === "javascript";
+}
+function mapTargetKeyToResolutionId(targetKey) {
+    // targetKey is `${file}:${line}:${qualifiedName}`. Opaque to callers — the
+    // storage layer only cares that it's unique.
+    return targetKey;
+}
+function runStackGraphs(q) {
+    if (TS_STORE.graphs.size === 0)
+        return null;
+    const line = q.referenceLine;
+    const column = q.referenceColumn;
+    if (line === undefined || column === undefined)
+        return null;
+    const graph = TS_STORE.graphs.get(q.callerFile);
+    if (graph === undefined)
+        return null;
+    const refKey = `${line}:${column}`;
+    const refNodeId = graph.referenceIndex.get(refKey);
+    if (refNodeId === undefined)
+        return null;
+    const ref = {
+        file: q.callerFile,
+        line,
+        column,
+        name: q.calleeName,
+    };
+    void ref; // carried for parity with the Python strategy signature
+    try {
+        const { results } = resolveReference(TS_STORE.graphs, q.callerFile, refNodeId);
+        const best = results[0];
+        if (best === undefined)
+            return null;
+        return {
+            targetId: mapTargetKeyToResolutionId(best.targetKey),
+            tier: "import-scoped",
+            confidence: STACK_GRAPHS_HIT_CONFIDENCE,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export const stackGraphsTsResolver = {
+    name: "stack-graphs",
+    resolve(q, index) {
+        if (!isTsFamilyQuery(q)) {
+            return threeTierResolve(q, index);
+        }
+        const hinted = q;
+        const hit = runStackGraphs(hinted);
+        if (hit !== null) {
+            TS_STORE.stackGraphHits++;
+            const clamped = {
+                targetId: hit.targetId,
+                tier: hit.tier,
+                confidence: Math.max(hit.confidence, CONFIDENCE_BY_TIER["import-scoped"]),
+            };
+            return [clamped];
+        }
+        TS_STORE.fallbacks++;
+        return threeTierResolve(q, index);
+    },
+};
+function nextId(g, kind) {
+    g.seq++;
+    return `${g.file}#${kind}-${g.seq}`;
+}
+function addNode(g, kind, opts = {}) {
+    const id = nextId(g, kind);
+    const base = { id, kind, file: g.file };
+    const node = {
+        ...base,
+        ...(opts.symbol !== undefined ? { symbol: opts.symbol } : {}),
+        ...(opts.definitionTarget !== undefined ? { definitionTarget: opts.definitionTarget } : {}),
+        ...(opts.line !== undefined ? { line: opts.line } : {}),
+    };
+    g.nodes.set(id, node);
+    return id;
+}
+function addEdge(g, source, target, precedence = 0) {
+    g.edges.push({ source, target, precedence });
+}
+/**
+ * Build a stack graph for a single TS-family module from an import/export
+ * IR. The graph shape:
+ *
+ *   * module-scope is a `scope` node. ROOT points at it (so external
+ *     lookups hitting this module begin there).
+ *   * Local definitions are `pop` nodes hanging off module-scope, precedence 2.
+ *   * Named imports create a local `pop` for the binding plus a push chain
+ *     `[binding-name, moduleKey]` terminating at ROOT.
+ *   * Default imports are identical to named imports with `imported = "default"`.
+ *   * Namespace imports create a `pop` at the local name whose continuation
+ *     chains straight to ROOT of the target module (the member push is
+ *     generated at the reference site — see `references`).
+ *   * Star re-exports emit a precedence-1 scope edge mirroring Python's
+ *     wildcard handling.
+ *   * Named re-exports create a local `pop` whose target is the remote
+ *     module's export with the same (or renamed-from) name.
+ *   * Default re-exports (`export { default as foo }`) create a local pop
+ *     "foo" targeting the remote default slot.
+ *   * Default exports create a local pop "default" pointing at the target.
+ */
+export function buildTsStackGraph(facts) {
+    const rootNodeId = `${facts.file}#root`;
+    const moduleScopeId = `${facts.file}#module-scope`;
+    const graph = {
+        file: facts.file,
+        nodes: new Map(),
+        edges: [],
+        referenceIndex: new Map(),
+        rootNodeId,
+        moduleScopeId,
+        moduleExportPops: new Map(),
+        seq: 0,
+    };
+    graph.nodes.set(rootNodeId, { id: rootNodeId, kind: "root", file: facts.file });
+    graph.nodes.set(moduleScopeId, { id: moduleScopeId, kind: "scope", file: facts.file });
+    // External queries enter via ROOT — ROOT → module-scope so symbol lookups
+    // can traverse pops attached to module-scope.
+    addEdge(graph, rootNodeId, moduleScopeId, 0);
+    emitLocalDefinitions(graph, facts.localDefinitions);
+    emitImports(graph, facts);
+    emitExports(graph, facts);
+    emitReferences(graph, facts);
+    return {
+        file: facts.file,
+        nodes: new Map(graph.nodes),
+        edges: graph.edges.slice(),
+        rootNodeId: graph.rootNodeId,
+        referenceIndex: new Map(graph.referenceIndex),
+    };
+}
+function emitLocalDefinitions(g, defs) {
+    for (const def of defs) {
+        // A pop node that terminates a successful lookup for `name` inside this
+        // module. Kept on module-scope with precedence 2 so local hits outrank
+        // ambient re-exports (precedence 1) when both match.
+        const defNode = addNode(g, "pop", {
+            symbol: def.name,
+            definitionTarget: def.name,
+            line: def.line,
+        });
+        addEdge(g, g.moduleScopeId, defNode, 2);
+        g.moduleExportPops.set(def.name, defNode);
+    }
+}
+function emitImports(g, facts) {
+    for (const imp of facts.imports) {
+        const targetKey = facts.resolveModule(imp.module);
+        switch (imp.kind) {
+            case "named":
+                bindImport(g, imp.local, imp.name, targetKey, imp.module, imp.line);
+                break;
+            case "default":
+                bindImport(g, imp.local, "default", targetKey, imp.module, imp.line);
+                break;
+            case "namespace":
+                bindNamespaceImport(g, imp.local, targetKey, imp.module, imp.line);
+                break;
+        }
+    }
+}
+/**
+ * Emit the pop + push chain for a named or default import. The pop binds
+ * the local name; a push chain of `[imported-name, targetKey]` terminates
+ * at ROOT so the traversal hops to the module graph that provides the
+ * definition.
+ */
+function bindImport(g, local, imported, targetKey, specifier, line) {
+    const definitionTarget = targetKey !== null ? `${targetKey}.${imported}` : `${specifier}.${imported}`;
+    const defNode = addNode(g, "pop", {
+        symbol: local,
+        definitionTarget,
+        line,
+    });
+    addEdge(g, g.moduleScopeId, defNode, 2);
+    // Push the imported name first so after the pop we expect `[imported, targetKey]`
+    // on the stack; the ROOT hop then emits a push for `targetKey` (the module
+    // identifier) and lands on the target graph's ROOT.
+    const pushImported = addNode(g, "push", { symbol: imported, line });
+    addEdge(g, defNode, pushImported, 0);
+    let cursor = pushImported;
+    if (targetKey !== null) {
+        const pushModule = addNode(g, "push", { symbol: targetKey, line });
+        addEdge(g, cursor, pushModule, 0);
+        cursor = pushModule;
+    }
+    addEdge(g, cursor, g.rootNodeId, 0);
+}
+/**
+ * Namespace imports (`import * as ns`) resolve `ns.member` to the target
+ * module's `member` export. We emit a pop for `ns` plus a push for the
+ * module key — references of the form `ns.x` show up as two push nodes
+ * at the reference site (`x` then `ns`) which pop `ns` here, push `x`,
+ * and hop to ROOT.
+ */
+function bindNamespaceImport(g, local, targetKey, specifier, line) {
+    const definitionTarget = targetKey !== null ? `${targetKey}.*` : `${specifier}.*`;
+    const defNode = addNode(g, "pop", {
+        symbol: local,
+        definitionTarget,
+        line,
+    });
+    addEdge(g, g.moduleScopeId, defNode, 2);
+    if (targetKey !== null) {
+        const pushModule = addNode(g, "push", { symbol: targetKey, line });
+        addEdge(g, defNode, pushModule, 0);
+        addEdge(g, pushModule, g.rootNodeId, 0);
+    }
+    else {
+        addEdge(g, defNode, g.rootNodeId, 0);
+    }
+}
+function emitExports(g, facts) {
+    for (const exp of facts.exports) {
+        switch (exp.kind) {
+            case "named-local":
+                // Local-only export — already represented by the local definition
+                // pop on module-scope. If the def wasn't registered, emit a stub so
+                // external lookups still terminate.
+                if (!g.moduleExportPops.has(exp.name)) {
+                    const stub = addNode(g, "pop", {
+                        symbol: exp.name,
+                        definitionTarget: exp.name,
+                        line: exp.line,
+                    });
+                    addEdge(g, g.moduleScopeId, stub, 2);
+                    g.moduleExportPops.set(exp.name, stub);
+                }
+                break;
+            case "default-local": {
+                const defNode = addNode(g, "pop", {
+                    symbol: "default",
+                    definitionTarget: exp.target,
+                    line: exp.line,
+                });
+                addEdge(g, g.moduleScopeId, defNode, 2);
+                g.moduleExportPops.set("default", defNode);
+                break;
+            }
+            case "named-reexport":
+                emitNamedReexport(g, facts, exp);
+                break;
+            case "default-reexport-as":
+                emitDefaultReexportAs(g, facts, exp);
+                break;
+            case "star-reexport":
+                emitStarReexport(g, facts, exp);
+                break;
+        }
+    }
+}
+/**
+ * `export { imported as name } from "./bar"` — a local pop for `name` whose
+ * traversal hops through ROOT to the remote module's `imported` slot.
+ */
+function emitNamedReexport(g, facts, exp) {
+    const targetKey = facts.resolveModule(exp.module);
+    const definitionTarget = targetKey !== null ? `${targetKey}.${exp.imported}` : `${exp.module}.${exp.imported}`;
+    const defNode = addNode(g, "pop", {
+        symbol: exp.name,
+        definitionTarget,
+        line: exp.line,
+    });
+    addEdge(g, g.moduleScopeId, defNode, 2);
+    g.moduleExportPops.set(exp.name, defNode);
+    const pushImported = addNode(g, "push", { symbol: exp.imported, line: exp.line });
+    addEdge(g, defNode, pushImported, 0);
+    let cursor = pushImported;
+    if (targetKey !== null) {
+        const pushModule = addNode(g, "push", { symbol: targetKey, line: exp.line });
+        addEdge(g, cursor, pushModule, 0);
+        cursor = pushModule;
+    }
+    addEdge(g, cursor, g.rootNodeId, 0);
+}
+/** `export { default as foo } from "./bar"` — same as named-reexport of "default". */
+function emitDefaultReexportAs(g, facts, exp) {
+    emitNamedReexport(g, facts, {
+        kind: "named-reexport",
+        name: exp.name,
+        imported: "default",
+        module: exp.module,
+        line: exp.line,
+    });
+}
+/**
+ * `export * from "./bar"` — every export in `./bar` becomes reachable from
+ * this module. Mirrors Python's wildcard handling: a scope junction on
+ * module-scope (precedence 1 so local pops still win on overlap) plus a
+ * push chain that lands on the remote ROOT.
+ */
+function emitStarReexport(g, facts, exp) {
+    const targetKey = facts.resolveModule(exp.module);
+    const junction = addNode(g, "scope", { line: exp.line });
+    // Precedence 1 — beaten by local definitions/named re-exports (precedence 2)
+    // but outranks ordinary fall-through edges.
+    addEdge(g, g.moduleScopeId, junction, 1);
+    if (targetKey !== null) {
+        const pushModule = addNode(g, "push", { symbol: targetKey, line: exp.line });
+        addEdge(g, junction, pushModule, 0);
+        addEdge(g, pushModule, g.rootNodeId, 0);
+    }
+    else {
+        addEdge(g, junction, g.rootNodeId, 0);
+    }
+}
+function emitReferences(g, facts) {
+    for (const ref of facts.references) {
+        const key = `${ref.line}:${ref.column}`;
+        if (g.referenceIndex.has(key))
+            continue;
+        const pushNode = addNode(g, "push", { symbol: ref.name, line: ref.line });
+        addEdge(g, pushNode, g.moduleScopeId, 0);
+        g.referenceIndex.set(key, pushNode);
+    }
+}
+//# sourceMappingURL=stack-graphs-ts.js.map

package/dist/providers/resolution/stack-graphs-ts.js.map

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

package/dist/providers/ruby.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageProvider } from "./types.js";
+export declare const rubyProvider: LanguageProvider;
+//# sourceMappingURL=ruby.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ruby.d.ts","sourceRoot":"","sources":["../../src/providers/ruby.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAKV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAqOpB,eAAO,MAAM,YAAY,EAAE,gBAwD1B,CAAC"}

package/dist/providers/ruby.js

@@ -0,0 +1,259 @@
+import { innermostEnclosingContainer, innermostEnclosingDef, isInside, pairDefinitionsWithNames, stripComments, } from "./extract-helpers.js";
+/**
+ * Ruby provider.
+ *
+ * Definitions: classes, modules, methods (instance + class/singleton),
+ * top-level constants. `method` nodes nested inside a `class` become
+ * `Method`, top-level `method`s become `Function`. Modules are emitted as
+ * `Module` (for the Ruby sense of "mixable container").
+ *
+ * Heritage: `class Foo < Bar` is captured as `@reference.class` on the
+ * `superclass` child of the class. `include M` / `extend M` / `prepend M`
+ * inside the class body are detected via a pre-pass on the source text —
+ * Ruby's grammar tags these as plain method calls, so we recognize them
+ * by callee name.
+ *
+ * Imports: `require`, `require_relative`, `load` — all surface as plain
+ * method calls in Ruby's grammar. We scan the source text directly.
+ *
+ * Exports: Ruby has no static export modifier. We mark everything with a
+ * leading `_` as not exported (convention-only) and everything else as
+ * exported.
+ */
+const RUBY_DEF_KIND_MAP = {
+    "definition.class": "Class",
+    "definition.module": "Module",
+    "definition.function": "Function",
+    "definition.method": "Method",
+    "definition.constant": "Const",
+};
+function extractRubyDefinitions(input) {
+    const { filePath, captures } = input;
+    const paired = pairDefinitionsWithNames(captures);
+    const defCaptures = captures.filter((c) => c.tag.startsWith("definition."));
+    const out = [];
+    for (const { def, name } of paired) {
+        let kind = RUBY_DEF_KIND_MAP[def.tag];
+        if (kind === undefined)
+            continue;
+        let owner;
+        const ownerDef = innermostEnclosingDef(def, defCaptures);
+        if (ownerDef !== undefined) {
+            const ownerPaired = paired.find((p) => p.def === ownerDef);
+            if (ownerPaired !== undefined)
+                owner = ownerPaired.name.text;
+        }
+        // Promote function -> method when nested in a class/module.
+        if (def.tag === "definition.function" &&
+            (ownerDef?.tag === "definition.class" || ownerDef?.tag === "definition.module")) {
+            kind = "Method";
+        }
+        const qualifiedName = owner !== undefined ? `${owner}.${name.text}` : name.text;
+        const isExported = !name.text.startsWith("_");
+        out.push({
+            kind,
+            name: name.text,
+            qualifiedName,
+            filePath,
+            startLine: def.startLine,
+            endLine: def.endLine,
+            isExported,
+            ...(owner !== undefined ? { owner } : {}),
+        });
+    }
+    return out;
+}
+function extractRubyCalls(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) {
+        const innerName = findNameInside(captures, ref);
+        const calleeName = innerName?.text ?? ref.text;
+        // Drop pseudo-calls that are really import/mixin forms — we handle
+        // those in extractImports / extractHeritage respectively.
+        if (calleeName === "require" ||
+            calleeName === "require_relative" ||
+            calleeName === "load" ||
+            calleeName === "autoload" ||
+            calleeName === "include" ||
+            calleeName === "extend" ||
+            calleeName === "prepend") {
+            continue;
+        }
+        const enclosingDef = innermostEnclosingDef(ref, defCaptures);
+        const callerQualifiedName = enclosingDef
+            ? qualifiedForCapture(enclosingDef, definitions)
+            : "<module>";
+        // Receiver inference: `obj.method(...)`. Ruby also has `self.method`
+        // inside class bodies.
+        let receiver;
+        if (innerName !== undefined) {
+            const idx = ref.text.lastIndexOf(`.${innerName.text}`);
+            if (idx > 0) {
+                const prefix = ref.text.slice(0, idx).trim();
+                if (prefix !== "" && /^[A-Za-z_@][\w:]*$/.test(prefix))
+                    receiver = prefix;
+            }
+        }
+        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 qualifiedForCapture(def, definitions) {
+    for (const d of definitions) {
+        if (d.startLine === def.startLine)
+            return d.qualifiedName;
+    }
+    return "<module>";
+}
+/**
+ * Parse Ruby imports. Covers:
+ *   `require 'mod'`
+ *   `require_relative './mod'`
+ *   `load 'mod.rb'`
+ *   `autoload :Foo, 'foo'`
+ */
+function extractRubyImports(input) {
+    const { filePath, sourceText } = input;
+    const stripped = stripComments(sourceText);
+    const out = [];
+    const re = /\b(require|require_relative|load|autoload)\s*\(?\s*(?::[A-Za-z_][\w]*\s*,\s*)?["']([^"']+)["']/g;
+    for (const m of stripped.matchAll(re)) {
+        const kind = m[1];
+        const source = m[2];
+        out.push({
+            filePath,
+            source,
+            kind: kind === "require_relative" ? "named" : "package-wildcard",
+        });
+    }
+    return out;
+}
+/**
+ * Heritage from Ruby class/module definitions:
+ *   `class Foo < Bar`                → EXTENDS Bar
+ *   `class Foo < Bar; include M; end` → EXTENDS Bar + IMPLEMENTS M
+ *   `class Foo; prepend P; end`       → IMPLEMENTS P
+ *
+ * Tree-sitter-ruby wraps `< Bar` in a `superclass` node. Include/extend/
+ * prepend mixins appear as `call` nodes whose method is `include` etc.
+ * We detect them via text scanning inside the class body since the unified
+ * query treats them as plain calls.
+ */
+function extractRubyHeritage(input) {
+    const { filePath, captures, definitions } = input;
+    const out = [];
+    // `@reference.class` captures from `superclass` field.
+    const superRefs = captures.filter((c) => c.tag === "reference.class");
+    const classDefs = captures.filter((c) => c.tag === "definition.class");
+    for (const ref of superRefs) {
+        const enclosing = innermostEnclosingContainer(ref, classDefs);
+        if (enclosing === undefined)
+            continue;
+        const child = definitions.find((d) => d.kind === "Class" && d.startLine === enclosing.startLine);
+        if (child === undefined)
+            continue;
+        out.push({
+            childQualifiedName: child.qualifiedName,
+            parentName: ref.text,
+            filePath,
+            relation: "EXTENDS",
+            startLine: ref.startLine,
+        });
+    }
+    // `@reference.mixin` captures from `include`/`extend`/`prepend` calls.
+    const mixinRefs = captures.filter((c) => c.tag === "reference.mixin");
+    for (const ref of mixinRefs) {
+        const enclosing = innermostEnclosingContainer(ref, classDefs);
+        if (enclosing === undefined)
+            continue;
+        const child = definitions.find((d) => (d.kind === "Class" || d.kind === "Module") && d.startLine === enclosing.startLine);
+        if (child === undefined)
+            continue;
+        out.push({
+            childQualifiedName: child.qualifiedName,
+            parentName: ref.text,
+            filePath,
+            relation: "IMPLEMENTS",
+            startLine: ref.startLine,
+        });
+    }
+    return out;
+}
+export const rubyProvider = {
+    id: "ruby",
+    extensions: [".rb"],
+    importSemantics: "named",
+    mroStrategy: "c3",
+    typeConfig: { structural: true, nominal: true, generics: false },
+    heritageEdge: "EXTENDS",
+    inferImplicitReceiver: () => "self",
+    isExportedIdentifier: (name) => !name.startsWith("_"),
+    complexityDefinitionKinds: ["method", "singleton_method", "lambda", "block", "do_block"],
+    halsteadOperatorKinds: [
+        "+",
+        "-",
+        "*",
+        "/",
+        "%",
+        "**",
+        "=",
+        "==",
+        "===",
+        "!=",
+        "<",
+        ">",
+        "<=",
+        ">=",
+        "<=>",
+        "&&",
+        "||",
+        "and",
+        "or",
+        "not",
+        "!",
+        "&",
+        "|",
+        "^",
+        "~",
+        "<<",
+        ">>",
+        "+=",
+        "-=",
+        "*=",
+        "/=",
+        "%=",
+        "**=",
+        "&&=",
+        "||=",
+        "?",
+        ":",
+        "=>",
+    ],
+    extractDefinitions: extractRubyDefinitions,
+    extractCalls: extractRubyCalls,
+    extractImports: extractRubyImports,
+    isExported: (def) => def.isExported,
+    extractHeritage: extractRubyHeritage,
+};
+//# sourceMappingURL=ruby.js.map

package/dist/providers/ruby.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruby.js","sourceRoot":"","sources":["../../src/providers/ruby.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,QAAQ,EACR,wBAAwB,EACxB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAe9B;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,iBAAiB,GAAuC;IAC5D,kBAAkB,EAAE,OAAO;IAC3B,mBAAmB,EAAE,QAAQ;IAC7B,qBAAqB,EAAE,UAAU;IACjC,mBAAmB,EAAE,QAAQ;IAC7B,qBAAqB,EAAE,OAAO;CAC/B,CAAC;AAEF,SAAS,sBAAsB,CAAC,KAA8B;IAC5D,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACrC,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5E,MAAM,GAAG,GAA0B,EAAE,CAAC;IAEtC,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QAEjC,IAAI,KAAyB,CAAC;QAC9B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;YAC3D,IAAI,WAAW,KAAK,SAAS;gBAAE,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/D,CAAC;QAED,4DAA4D;QAC5D,IACE,GAAG,CAAC,GAAG,KAAK,qBAAqB;YACjC,CAAC,QAAQ,EAAE,GAAG,KAAK,kBAAkB,IAAI,QAAQ,EAAE,GAAG,KAAK,mBAAmB,CAAC,EAC/E,CAAC;YACD,IAAI,GAAG,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAChF,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAE9C,GAAG,CAAC,IAAI,CAAC;YACP,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa;YACb,QAAQ;YACR,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU;YACV,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAwB;IAChD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAClD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,gBAAgB,CAAC,CAAC;IACpE,MAAM,GAAG,GAAoB,EAAE,CAAC;IAEhC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,SAAS,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;QAE/C,mEAAmE;QACnE,0DAA0D;QAC1D,IACE,UAAU,KAAK,SAAS;YACxB,UAAU,KAAK,kBAAkB;YACjC,UAAU,KAAK,MAAM;YACrB,UAAU,KAAK,UAAU;YACzB,UAAU,KAAK,SAAS;YACxB,UAAU,KAAK,QAAQ;YACvB,UAAU,KAAK,SAAS,EACxB,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,qBAAqB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC7D,MAAM,mBAAmB,GAAG,YAAY;YACtC,CAAC,CAAC,mBAAmB,CAAC,YAAY,EAAE,WAAW,CAAC;YAChD,CAAC,CAAC,UAAU,CAAC;QAEf,qEAAqE;QACrE,uBAAuB;QACvB,IAAI,QAA4B,CAAC;QACjC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YACvD,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7C,IAAI,MAAM,KAAK,EAAE,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;oBAAE,QAAQ,GAAG,MAAM,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,GAAG,CAAC,IAAI,CAAC;YACP,mBAAmB;YACnB,UAAU;YACV,QAAQ;YACR,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CACrB,QAAiC,EACjC,KAAmB;IAEnB,IAAI,IAA8B,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM;YAAE,SAAS;QAC/B,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC;YAAE,SAAS;QAClC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;YAAE,IAAI,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAiB,EACjB,WAA2C;IAE3C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC,aAAa,CAAC;IAC5D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,KAA0B;IACpD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAsB,EAAE,CAAC;IAElC,MAAM,EAAE,GACN,iGAAiG,CAAC;IACpG,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAW,CAAC;QAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAW,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC;YACP,QAAQ;YACR,MAAM;YACN,IAAI,EAAE,IAAI,KAAK,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB;SACjE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,mBAAmB,CAAC,KAA2B;IACtD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAClD,MAAM,GAAG,GAAwB,EAAE,CAAC;IAEpC,uDAAuD;IACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,kBAAkB,CAAC,CAAC;IACvE,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,2BAA2B,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS,CACjE,CAAC;QACF,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,GAAG,CAAC,IAAI,CAAC;YACP,kBAAkB,EAAE,KAAK,CAAC,aAAa;YACvC,UAAU,EAAE,GAAG,CAAC,IAAI;YACpB,QAAQ;YACR,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAC;IACtE,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,2BAA2B,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS,CAC1F,CAAC;QACF,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,GAAG,CAAC,IAAI,CAAC;YACP,kBAAkB,EAAE,KAAK,CAAC,aAAa;YACvC,UAAU,EAAE,GAAG,CAAC,IAAI;YACpB,QAAQ;YACR,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,EAAE,EAAE,MAAM;IACV,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,eAAe,EAAE,OAAO;IACxB,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;IAChE,YAAY,EAAE,SAAS;IACvB,qBAAqB,EAAE,GAAG,EAAE,CAAC,MAAM;IACnC,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;IACrD,yBAAyB,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC;IACxF,qBAAqB,EAAE;QACrB,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,IAAI;QACJ,GAAG;QACH,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,GAAG;QACH,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,KAAK;QACL,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,GAAG;QACH,GAAG;QACH,IAAI;KACL;IAED,kBAAkB,EAAE,sBAAsB;IAC1C,YAAY,EAAE,gBAAgB;IAC9B,cAAc,EAAE,kBAAkB;IAClC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU;IACnC,eAAe,EAAE,mBAAmB;CACrC,CAAC"}