trail-code 0.0.0-stage → 0.28.0-semantic.3

package/dist/graph/markdown.d.ts

@@ -0,0 +1,22 @@
+import type { NodeV1 } from "./types.js";
+export declare const MD_EXT = ".md";
+/** Whether this file path is a markdown file. */
+export declare function isMdFile(path: string): boolean;
+export interface MdSection {
+    /** Heading text, e.g. "Reglas de negocio". */
+    name: string;
+    /** Heading level 1-6. */
+    level: number;
+    /** 1-based line number of the heading. */
+    line: number;
+    /** Text content of this section (not including the heading line). */
+    body: string;
+}
+/** Parse a markdown file into a list of sections (one per heading). */
+export declare function parseMdSections(content: string): MdSection[];
+/**
+ * Extract nodes from a markdown file. Returns one FileNode + one node per heading.
+ * Nodes have kind "section" and carry the section body as summary/body_text.
+ */
+export declare function extractMd(absPath: string, relPath: string): NodeV1[];
+//# sourceMappingURL=markdown.d.ts.map

package/dist/graph/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/graph/markdown.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAuBD,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAsC5D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAkEpE"}

package/dist/graph/markdown.js

@@ -0,0 +1,143 @@
+/**
+ * Markdown extraction tier — headings as symbols, sections as nodes.
+ *
+ * Opt-in via `trail build --include-md` (persisted in `.graft/config.json`).
+ * Produces one FileNode + one SectionNode per heading, so `trail ask` and
+ * `trail_search_semantic` can find content in `.md` files.
+ *
+ * No tree-sitter grammar needed: heading structure is simple enough for regex.
+ * Each heading becomes a node; its body is the text until the next same-or-higher
+ * heading. The file node's body is the preamble (text before the first heading).
+ */
+import { readFileSync } from "node:fs";
+import { contentHash } from "../util/id.js";
+export const MD_EXT = ".md";
+/** Whether this file path is a markdown file. */
+export function isMdFile(path) {
+    return path.toLowerCase().endsWith(MD_EXT);
+}
+/** Heading level of a markdown line, or 0 if not a heading. */
+function headingLevel(line) {
+    const m = /^(#{1,6})\s/.exec(line);
+    return m ? m[1].length : 0;
+}
+/** Strip markdown heading prefix and trim. */
+function headingText(line) {
+    return line.replace(/^#{1,6}\s+/, "").trim();
+}
+/** Slugify a heading for use as a symbol name (lowercase, hyphens). */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, "")
+        .trim()
+        .replace(/\s+/g, "-")
+        .slice(0, 80);
+}
+/** Parse a markdown file into a list of sections (one per heading). */
+export function parseMdSections(content) {
+    const lines = content.split("\n");
+    const sections = [];
+    let current = null;
+    let bodyLines = [];
+    let inFence = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip fenced code blocks — headings inside them are not real.
+        if (/^```/.test(line)) {
+            inFence = !inFence;
+        }
+        if (inFence) {
+            if (current)
+                bodyLines.push(line);
+            continue;
+        }
+        const level = headingLevel(line);
+        if (level > 0) {
+            // Close the previous section.
+            if (current) {
+                current.body = bodyLines.join("\n").trim();
+                sections.push(current);
+            }
+            current = { name: headingText(line), level, line: i + 1, body: "" };
+            bodyLines = [];
+        }
+        else {
+            if (current)
+                bodyLines.push(line);
+        }
+    }
+    // Close last section.
+    if (current) {
+        current.body = bodyLines.join("\n").trim();
+        sections.push(current);
+    }
+    return sections;
+}
+/**
+ * Extract nodes from a markdown file. Returns one FileNode + one node per heading.
+ * Nodes have kind "section" and carry the section body as summary/body_text.
+ */
+export function extractMd(absPath, relPath) {
+    let content;
+    try {
+        content = readFileSync(absPath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const lines = content.split("\n");
+    const totalLines = lines.length;
+    const fileHash = contentHash(content);
+    const fileId = relPath;
+    const nodes = [];
+    const sections = parseMdSections(content);
+    // Preamble: text before the first heading.
+    const firstHeadingLine = sections[0]?.line ?? Infinity;
+    const preamble = content
+        .split("\n")
+        .slice(0, firstHeadingLine - 1)
+        .join("\n")
+        .trim();
+    // File node.
+    nodes.push({
+        id: fileId,
+        kind: "file",
+        name: relPath.split("/").pop() ?? relPath,
+        path: relPath,
+        span: `L1-L${totalLines}`,
+        signature: null,
+        exported: false,
+        origin: "generic",
+        body_hash: fileHash,
+        summary_state: "none",
+        summary: preamble.slice(0, 200) || undefined,
+        body_text: preamble || undefined,
+        children: [],
+        edges: [],
+    });
+    // One node per heading.
+    for (let i = 0; i < sections.length; i++) {
+        const section = sections[i];
+        const nextLine = sections[i + 1]?.line ?? totalLines + 1;
+        const symbolId = `${relPath}#${slugify(section.name)}`;
+        nodes.push({
+            id: symbolId,
+            kind: "section",
+            name: section.name,
+            path: relPath,
+            span: `L${section.line}-L${nextLine - 1}`,
+            signature: `${"#".repeat(section.level)} ${section.name}`,
+            exported: false,
+            origin: "generic",
+            body_hash: contentHash(section.body),
+            summary_state: "none",
+            summary: section.body.slice(0, 300) || undefined,
+            body_text: section.body || undefined,
+            children: [],
+            edges: [],
+        });
+    }
+    return nodes;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/graph/markdown.js.map

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

package/dist/graph/native.d.ts

@@ -0,0 +1,46 @@
+import type { Language } from "./extract.js";
+/**
+ * True when `lang`'s native grammar loads and the parser accepts it. The first call
+ * per language does the loading; the answer is cached for the life of the process.
+ * Never throws.
+ */
+export declare function nativeReady(lang: Language): boolean;
+/** What depth-parser.ts uses of a native parser. */
+export interface NativeParser {
+    parse(input: (index: number) => string): {
+        rootNode: unknown;
+    };
+}
+/** The shared native parser, set to `lang`. Throws when that grammar is not
+ * available; callers ask {@link nativeReady} first and send the file elsewhere. */
+export declare function nativeParser(lang: Language): NativeParser;
+/**
+ * The npm packages whose missing binary keeps these languages off the native
+ * parser: what `npm install --allow-scripts=…` has to name. Empty when every one
+ * loaded, or when the ones that failed did load and were rejected by the parser
+ * (an ABI mismatch, which no install flag fixes).
+ */
+export declare function missingNativePackages(langs: Iterable<Language>): string[];
+/** The languages a build parsed with a breadth-tier stand-in because their own
+ * grammar didn't load, and the packages to allow so the next install builds them. */
+export interface NativeFallback {
+    /** Display labels (`javascript`, not the `typescript` grammar that parses it). */
+    languages: string[];
+    packages: string[];
+}
+/**
+ * The one line a build prints when some languages fell back, or null when none did.
+ * One line on purpose: `graft init` passes on only the `⚠`/`✗` lines of the build
+ * it runs, so a second line holding the fix would be dropped there.
+ *
+ * With no packages to allow, the grammar that didn't load is one of the package's
+ * own WASM files, so reinstalling it is the fix.
+ */
+export declare function nativeFallbackNotice(fallback: NativeFallback | undefined, packageName: string): string | null;
+/** Test seam: replace how native modules are required (null restores the real
+ * `require`), and forget everything loaded so far. A missing binary is simulated by
+ * a function that throws for that module id, the way node-gyp-build does. */
+export declare function setNativeRequireForTest(fn: ((id: string) => unknown) | null): void;
+/** The real `require` the seam above wraps, for a test's pass-through. */
+export declare function realNativeRequire(id: string): unknown;
+//# sourceMappingURL=native.d.ts.map

package/dist/graph/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/graph/native.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AA0E7C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAmBnD;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAChE;AAED;mFACmF;AACnF,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,CAUzE;AAED;qFACqF;AACrF,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7G;AAED;;6EAE6E;AAC7E,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,CAKlF;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/graph/native.js

@@ -0,0 +1,169 @@
+/**
+ * The depth tier's native grammars: node tree-sitter and the grammar addons,
+ * loaded on first use and never fatally.
+ *
+ * The depth tier parses on WASM now (depth-parser.ts), and these packages are dev
+ * dependencies only. As dependencies they made installing the package compile C:
+ * `tree-sitter-kotlin` ships no prebuilt binary at all, and `tree-sitter` and
+ * `tree-sitter-python` have none for linux-arm64. They stay for two uses, both
+ * behind depth-parser.ts: test/depth-parity.ts builds real repos on them and on
+ * WASM and diffs the graphs, and a language listed in `NATIVE_ONLY` there parses
+ * on its addon (none is).
+ *
+ * Each module is required the first time it is asked for, and a failure is
+ * remembered: that language's files go to its WASM stand-in in the breadth tier
+ * (`fallbackLangOf` in generic.ts), and the build says which languages fell back
+ * and how to fix it ({@link nativeFallbackNotice}).
+ */
+import { createRequire } from "node:module";
+const nodeRequire = createRequire(import.meta.url);
+const CORE = "tree-sitter";
+/** The module each depth-tier grammar comes from, and the export that is the
+ * grammar when the module ships more than one (typescript+tsx, php+php_only). */
+const GRAMMAR_MODULES = {
+    typescript: { module: "tree-sitter-typescript", pick: "typescript" },
+    tsx: { module: "tree-sitter-typescript", pick: "tsx" },
+    python: { module: "tree-sitter-python" },
+    go: { module: "tree-sitter-go" },
+    r: { module: "tree-sitter-r" },
+    java: { module: "tree-sitter-java" },
+    kotlin: { module: "tree-sitter-kotlin" },
+    swift: { module: "tree-sitter-swift" },
+    php: { module: "tree-sitter-php", pick: "php" },
+};
+/** The name `npm --allow-scripts` needs, where it differs from the module name.
+ * `tree-sitter-r` is an npm alias, and npm matches an allow entry against the real
+ * package only: an alias as the key matches nothing. */
+const NPM_NAME = {
+    "tree-sitter-r": "@davisvaughan/tree-sitter-r",
+};
+let requireModule = (id) => nodeRequire(id);
+const modules = new Map();
+const ready = new Map();
+/** undefined: not tried yet. null: tried, and the core binding is unusable. */
+let parser;
+function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function load(id) {
+    let hit = modules.get(id);
+    if (!hit) {
+        try {
+            hit = { ok: true, value: requireModule(id) };
+        }
+        catch (err) {
+            hit = { ok: false, error: message(err) };
+        }
+        modules.set(id, hit);
+    }
+    return hit;
+}
+function coreParser() {
+    if (parser === undefined) {
+        const core = load(CORE);
+        parser = null;
+        if (core.ok) {
+            try {
+                parser = new core.value();
+            }
+            catch (err) {
+                modules.set(CORE, { ok: false, error: message(err) });
+            }
+        }
+    }
+    return parser;
+}
+function grammarOf(lang) {
+    const { module, pick } = GRAMMAR_MODULES[lang];
+    const m = load(module);
+    if (!m.ok)
+        return null;
+    return pick ? (m.value[pick] ?? null) : m.value;
+}
+/**
+ * True when `lang`'s native grammar loads and the parser accepts it. The first call
+ * per language does the loading; the answer is cached for the life of the process.
+ * Never throws.
+ */
+export function nativeReady(lang) {
+    let ok = ready.get(lang);
+    if (ok === undefined) {
+        ok = false;
+        // Load the grammar even when the core binding failed, so the notice can name
+        // every package that is missing its binary, not only the first.
+        const grammar = grammarOf(lang);
+        const p = coreParser();
+        if (p && grammar) {
+            try {
+                p.setLanguage(grammar);
+                ok = true;
+            }
+            catch {
+                /* an addon built for another tree-sitter ABI: unusable, though it loaded */
+            }
+        }
+        ready.set(lang, ok);
+    }
+    return ok;
+}
+/** The shared native parser, set to `lang`. Throws when that grammar is not
+ * available; callers ask {@link nativeReady} first and send the file elsewhere. */
+export function nativeParser(lang) {
+    if (!nativeReady(lang)) {
+        const { module } = GRAMMAR_MODULES[lang];
+        const why = [CORE, module].map((id) => modules.get(id)).find((m) => m && !m.ok);
+        throw new Error(`the native ${lang} parser is not available${why && !why.ok ? `: ${why.error}` : ""}`);
+    }
+    const p = parser;
+    p.setLanguage(grammarOf(lang));
+    return p;
+}
+/**
+ * The npm packages whose missing binary keeps these languages off the native
+ * parser: what `npm install --allow-scripts=…` has to name. Empty when every one
+ * loaded, or when the ones that failed did load and were rejected by the parser
+ * (an ABI mismatch, which no install flag fixes).
+ */
+export function missingNativePackages(langs) {
+    const out = new Set();
+    for (const lang of langs) {
+        if (nativeReady(lang))
+            continue;
+        for (const id of [CORE, GRAMMAR_MODULES[lang].module]) {
+            const m = modules.get(id);
+            if (m && !m.ok)
+                out.add(NPM_NAME[id] ?? id);
+        }
+    }
+    return [...out].sort();
+}
+/**
+ * The one line a build prints when some languages fell back, or null when none did.
+ * One line on purpose: `graft init` passes on only the `⚠`/`✗` lines of the build
+ * it runs, so a second line holding the fix would be dropped there.
+ *
+ * With no packages to allow, the grammar that didn't load is one of the package's
+ * own WASM files, so reinstalling it is the fix.
+ */
+export function nativeFallbackNotice(fallback, packageName) {
+    if (!fallback || fallback.languages.length === 0)
+        return null;
+    const langs = fallback.languages.join(", ");
+    const what = fallback.languages.length === 1 ? "its parser didn't load" : "their parsers didn't load";
+    const allow = fallback.packages.length > 0 ? `--allow-scripts=${fallback.packages.join(",")} ` : "";
+    return `⚠ ${langs}: basic parsing only, ${what}. To fix: npm install -g ${allow}${packageName}`;
+}
+/** Test seam: replace how native modules are required (null restores the real
+ * `require`), and forget everything loaded so far. A missing binary is simulated by
+ * a function that throws for that module id, the way node-gyp-build does. */
+export function setNativeRequireForTest(fn) {
+    requireModule = fn ?? ((id) => nodeRequire(id));
+    modules.clear();
+    ready.clear();
+    parser = undefined;
+}
+/** The real `require` the seam above wraps, for a test's pass-through. */
+export function realNativeRequire(id) {
+    return nodeRequire(id);
+}
+//# sourceMappingURL=native.js.map

package/dist/graph/native.js.map

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

package/dist/graph/queries/c.scm

@@ -0,0 +1,13 @@
+(struct_specifier name: (type_identifier) @name body:(_)) @definition.class
+
+(declaration type: (union_specifier name: (type_identifier) @name)) @definition.class
+
+(function_declarator declarator: (identifier) @name) @definition.function
+
+(type_definition declarator: (type_identifier) @name) @definition.type
+
+(enum_specifier name: (type_identifier) @name) @definition.type
+
+; graft: call sites (upstream c tags.scm is definition-only)
+(call_expression
+  function: (identifier) @name) @reference.call

package/dist/graph/queries/c_sharp.scm

@@ -0,0 +1,19 @@
+; C# tags — minimal, matched to the tree-sitter-wasms c_sharp grammar node types.
+; (Upstream tree-sitter-c-sharp tags.scm references node types the bundled wasm
+;  grammar version lacks — "Bad node name 'type'" — so graft ships this instead.)
+
+(class_declaration name: (identifier) @name) @definition.class
+(interface_declaration name: (identifier) @name) @definition.interface
+(struct_declaration (identifier) @name) @definition.struct
+(enum_declaration name: (identifier) @name) @definition.enum
+(record_declaration (identifier) @name) @definition.class
+(method_declaration name: (identifier) @name) @definition.method
+(constructor_declaration (identifier) @name) @definition.method
+(property_declaration name: (identifier) @name) @definition.variable
+(namespace_declaration name: (identifier) @name) @definition.module
+
+(invocation_expression
+  function: [
+    (identifier) @name
+    (member_access_expression name: (identifier) @name)
+  ]) @reference.call

package/dist/graph/queries/clojure.scm

@@ -0,0 +1,58 @@
+; Clojure's tree-sitter grammar has no dedicated node types for `defn`/`def`/etc
+; — every form, definition or call alike, is just a `list_lit` whose `value`
+; field lists its children positionally. So a "definition" here is a list whose
+; first symbol is a known defining macro, matched by name via `#any-of?`/`#eq?`,
+; with the second symbol captured as the defined name.
+
+; Definitions
+
+; * namespace
+(list_lit
+  .
+  value: (sym_lit name: (sym_name) @ignore)
+  .
+  value: (sym_lit name: (sym_name) @name)
+  (#eq? @ignore "ns")) @definition.module
+
+; * functions/macros/multimethods
+(list_lit
+  .
+  value: (sym_lit name: (sym_name) @ignore)
+  .
+  value: (sym_lit name: (sym_name) @name)
+  (#any-of? @ignore "defn" "defn-" "defmacro" "defmulti" "defmethod" "definline" "deftest")) @definition.function
+
+; * def / defonce — a Var binding, not necessarily a function
+(list_lit
+  .
+  value: (sym_lit name: (sym_name) @ignore)
+  .
+  value: (sym_lit name: (sym_name) @name)
+  (#any-of? @ignore "def" "defonce")) @definition.variable
+
+; * defprotocol / definterface
+(list_lit
+  .
+  value: (sym_lit name: (sym_name) @ignore)
+  .
+  value: (sym_lit name: (sym_name) @name)
+  (#any-of? @ignore "defprotocol" "definterface")) @definition.interface
+
+; * defrecord / deftype / defstruct — each mints a JVM class
+(list_lit
+  .
+  value: (sym_lit name: (sym_name) @ignore)
+  .
+  value: (sym_lit name: (sym_name) @name)
+  (#any-of? @ignore "defrecord" "deftype" "defstruct")) @definition.class
+
+; References
+
+; * function/macro call — any parenthesized list headed by a symbol. This also
+; matches the def-forms above on their own keyword (e.g. `(defn foo …)` reads
+; as a "call" to `defn`) and special forms (`let`, `if`, `fn`, …); those never
+; resolve to an in-repo definition, so the existing resolver drops them rather
+; than guessing — same trade-off the elixir/ruby queries make.
+(list_lit
+  .
+  value: (sym_lit name: (sym_name) @name)) @reference.call

package/dist/graph/queries/cpp.scm

@@ -0,0 +1,23 @@
+(struct_specifier name: (type_identifier) @name body:(_)) @definition.class
+
+(declaration type: (union_specifier name: (type_identifier) @name)) @definition.class
+
+(function_declarator declarator: (identifier) @name) @definition.function
+
+(function_declarator declarator: (field_identifier) @name) @definition.function
+
+(function_declarator declarator: (qualified_identifier scope: (namespace_identifier) @local.scope name: (identifier) @name)) @definition.method
+
+(type_definition declarator: (type_identifier) @name) @definition.type
+
+(enum_specifier name: (type_identifier) @name) @definition.type
+
+(class_specifier name: (type_identifier) @name) @definition.class
+
+; graft: call sites (upstream cpp tags.scm is definition-only)
+(call_expression
+  function: [
+    (identifier) @name
+    (field_expression field: (field_identifier) @name)
+    (qualified_identifier name: (identifier) @name)
+  ]) @reference.call

package/dist/graph/queries/dart.scm

@@ -0,0 +1,42 @@
+; Dart — breadth-tier tags.scm
+;
+; The Dart grammar does not wrap a function's signature and body in one
+; definition node: `function_signature` / `method_signature` sit as siblings
+; of `function_body` under `program` / `class_body`. Graft's generic extractor
+; expands a captured signature to include a following `function_body` sibling
+; so calls inside the body are attributed to the function (see defScope).
+;
+; Without this query the node-kind walker fallback runs, which:
+;   - skips `function_signature` (type does not match the walker suffixes)
+;   - mints `class_body` as a class (type starts with "class") named after the
+;     first identifier in the body (`int`, `bool`, …)
+;   - mints function-body locals (`initialized_variable_definition`) as symbols
+;
+; Call sites are `identifier` + adjacent `selector`/`argument_part`, not a
+; `call_expression` node. Only that shape is tagged — assignment selectors and
+; bare identifier reads are left alone.
+
+; Top-level functions (direct children of program, not methods)
+(program
+  (function_signature
+    name: (identifier) @name) @definition.function)
+
+; Methods
+(method_signature
+  (function_signature
+    name: (identifier) @name)) @definition.method
+
+(class_definition
+  name: (identifier) @name) @definition.class
+
+; Top-level / static `const`/`final` (`const int kThreshold = 3`)
+(static_final_declaration
+  .
+  (identifier) @name) @definition.constant
+
+; identifier(args) — `isReady(count)`, `Counter.ready → isReady(value)`
+(
+  (identifier) @name
+  .
+  (selector
+    (argument_part))) @reference.call

package/dist/graph/queries/elixir.scm

@@ -0,0 +1,54 @@
+; Definitions
+
+; * modules and protocols
+(call
+  target: (identifier) @ignore
+  (arguments (alias) @name)
+  (#any-of? @ignore "defmodule" "defprotocol")) @definition.module
+
+; * functions/macros
+(call
+  target: (identifier) @ignore
+  (arguments
+    [
+      ; zero-arity functions with no parentheses
+      (identifier) @name
+      ; regular function clause
+      (call target: (identifier) @name)
+      ; function clause with a guard clause
+      (binary_operator
+        left: (call target: (identifier) @name)
+        operator: "when")
+    ])
+  (#any-of? @ignore "def" "defp" "defdelegate" "defguard" "defguardp" "defmacro" "defmacrop" "defn" "defnp")) @definition.function
+
+; References
+
+; ignore calls to kernel/special-forms keywords
+(call
+  target: (identifier) @ignore
+  (#any-of? @ignore "def" "defp" "defdelegate" "defguard" "defguardp" "defmacro" "defmacrop" "defn" "defnp" "defmodule" "defprotocol" "defimpl" "defstruct" "defexception" "defoverridable" "alias" "case" "cond" "else" "for" "if" "import" "quote" "raise" "receive" "require" "reraise" "super" "throw" "try" "unless" "unquote" "unquote_splicing" "use" "with"))
+
+; ignore module attributes
+(unary_operator
+  operator: "@"
+  operand: (call
+    target: (identifier) @ignore))
+
+; * function call
+(call
+  target: [
+   ; local
+   (identifier) @name
+   ; remote
+   (dot
+     right: (identifier) @name)
+  ]) @reference.call
+
+; * pipe into function call
+(binary_operator
+  operator: "|>"
+  right: (identifier) @name) @reference.call
+
+; * modules
+(alias) @name @reference.module