@platformos/platformos-graph 0.0.19 → 0.1.0

package/dist/graph/traverse.d.ts

@@ -1,5 +1,60 @@
-import { AugmentedDependencies, AppGraph, AppModule, Range, Reference, Void } from '../types';
-export declare function traverseModule(module: AppModule, appGraph: AppGraph, deps: AugmentedDependencies): Promise<Void>;
+import { UriString } from '@platformos/platformos-check-common';
+import { AugmentedDependencies, AppGraph, AppModule, FileSourceCode, GraphBuildOptions, ModuleStructural, Range, Reference, ReferenceKind, Void } from '../types';
+/** A resolved outgoing reference: the target graph node + its call-site range + kind (+ named-arg names). */
+export interface ResolvedReference {
+    target: AppModule;
+    sourceRange: Range;
+    kind: ReferenceKind;
+    /** Names of the named arguments at the call site, in source order; omitted when none. */
+    args?: string[];
+}
+/** The dependency surface the reference resolver needs: what `DocumentsLocator` takes. */
+type ResolverDependencies = Pick<AugmentedDependencies, 'fs' | 'app'>;
+export declare function traverseModule(module: AppModule, appGraph: AppGraph, deps: AugmentedDependencies, options?: GraphBuildOptions): Promise<Void>;
+/**
+ * Resolve a single parsed Liquid file's outgoing references — the one place that
+ * knows how each Liquid construct (`render`/`include`, `function`, `background`,
+ * `graphql`, asset filters) maps to a target module + {@link ReferenceKind}.
+ *
+ * Both the full-project traversal ({@link traverseLiquidModule}) and the
+ * standalone per-file primitive ({@link extractFileReferences}) go through this,
+ * so resolution can never drift between "graph build" and "validate one buffer".
+ *
+ * Targets are produced via the module factories (which normalize URIs), so keys
+ * match the rest of the graph on every platform. Unparseable input yields no
+ * references rather than throwing.
+ */
+export declare function resolveLiquidReferences(appGraph: AppGraph, sourceCode: FileSourceCode, deps: ResolverDependencies): Promise<ResolvedReference[]>;
+/**
+ * Extract one Liquid file's outgoing dependency references, resolved against the project at
+ * `rootUri`, WITHOUT building the whole app graph.
+ *
+ * The per-file primitive for consumers holding a single (possibly in-flight, not-yet-on-disk)
+ * buffer. Resolution uses the same `DocumentsLocator`-backed logic as the full graph build, so
+ * a target's URI is identical to the key it would have as a graph node.
+ *
+ * Notes for consumers:
+ * - Targets are returned whether or not they exist on disk (resolution is path-based). To
+ *   distinguish missing targets, `stat` `target.uri` via the same `fs`.
+ * - Only statically resolvable references are returned; dynamic targets
+ *   (`{% render some_var %}`) and inline forms are skipped.
+ * - `sourceCode` is parsed by the caller; nothing but target resolution happens here.
+ */
+export declare function extractFileReferences(rootUri: UriString, sourceUri: UriString, sourceCode: FileSourceCode, deps: ResolverDependencies): Promise<Reference[]>;
+/**
+ * Extract a Liquid file's own structural declarations from an already-parsed source — the
+ * per-file primitive, sibling to {@link extractFileReferences}. Reuses the shared `js-yaml`
+ * frontmatter parse, platformos-common's slug helpers, and check-common's liquid-doc and
+ * translation detection — never a second parser.
+ *
+ * Usage facts come from one walk of the parsed AST and are always present (sorted,
+ * de-duplicated); `doc_params` is in source order. Routing facts come from frontmatter: `slug`
+ * is the frontmatter override else the path-derived slug, for page files only, and
+ * `layout`/`method` when declared.
+ *
+ * Returns `undefined` for a non-Liquid source or one that could not be parsed.
+ */
+export declare function extractStructural(sourceCode: FileSourceCode, uri: UriString): Promise<ModuleStructural | undefined>;
 /**
  * The bind method is the method that links two modules together.
  *
@@ -7,8 +62,12 @@ export declare function traverseModule(module: AppModule, appGraph: AppGraph, de
  *
  * This function mutates the source and target modules.
  */
-export declare function bind(source: AppModule, target: AppModule, { sourceRange, targetRange, type, }?: {
+export declare function bind(source: AppModule, target: AppModule, { sourceRange, type, // the type of dependency, can be 'direct' or 'indirect'
+kind, // the semantic Liquid construct that created the edge
+args, }?: {
     sourceRange?: Range;
-    targetRange?: Range;
     type?: Reference['type'];
+    kind?: ReferenceKind;
+    args?: string[];
 }): void;
+export {};

package/dist/graph/traverse.js

@@ -1,12 +1,21 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.traverseModule = traverseModule;
+exports.resolveLiquidReferences = resolveLiquidReferences;
+exports.extractFileReferences = extractFileReferences;
+exports.extractStructural = extractStructural;
 exports.bind = bind;
+const js_yaml_1 = __importDefault(require("js-yaml"));
 const liquid_html_parser_1 = require("@platformos/liquid-html-parser");
 const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const platformos_common_1 = require("@platformos/platformos-common");
+const vscode_uri_1 = require("vscode-uri");
 const utils_1 = require("../utils");
 const module_1 = require("./module");
-async function traverseModule(module, appGraph, deps) {
+async function traverseModule(module, appGraph, deps, options = {}) {
     // If the module is already traversed, skip it
     if (appGraph.modules[module.uri]) {
         return;
@@ -22,26 +31,88 @@ async function traverseModule(module, appGraph, deps) {
     }
     switch (module.type) {
         case "Liquid" /* ModuleType.Liquid */: {
-            return traverseLiquidModule(module, appGraph, deps);
+            return traverseLiquidModule(module, appGraph, deps, options);
         }
         case "Asset" /* ModuleType.Asset */: {
             return; // Nothing to traverse in assets
         }
+        case "GraphQL" /* ModuleType.GraphQL */: {
+            // Leaf node — GraphQL documents have no platformOS dependencies. We do read the
+            // file once to record the model tables it targets (a neutral platform fact),
+            // from the parse the source code already carries: when the graph reads through
+            // an `App` that is the SAME parse the lint used, not a second one.
+            const sourceCode = await deps.getSourceCode(module.uri);
+            module.tables = (0, platformos_common_1.isGraphqlDocument)(sourceCode.ast) ? (0, platformos_common_1.extractGraphqlTables)(sourceCode.ast) : [];
+            return;
+        }
+        case "Schema" /* ModuleType.Schema */: {
+            // Leaf node — a custom model type / schema file. Read the source once to
+            // record its model table name (the YAML `name:`), a neutral platform fact.
+            const sourceCode = await deps.getSourceCode(module.uri);
+            module.table = (0, platformos_common_1.extractSchemaTable)(sourceCode.source);
+            return;
+        }
         default: {
             return (0, utils_1.assertNever)(module);
         }
     }
 }
-async function traverseLiquidModule(module, appGraph, deps) {
+async function traverseLiquidModule(module, appGraph, deps, options) {
     const sourceCode = await deps.getSourceCode(module.uri);
+    // Surface the file's own structural declarations as a by-product of the parse
+    // — only when the caller opted in (see GraphBuildOptions). Absent
+    // otherwise, and when the file could not be parsed.
+    if (options.includeStructural) {
+        module.structural = await extractStructural(sourceCode, module.uri);
+    }
+    const references = await resolveLiquidReferences(appGraph, sourceCode, deps);
+    for (const reference of references) {
+        bind(module, reference.target, {
+            sourceRange: reference.sourceRange,
+            kind: reference.kind,
+            args: reference.args,
+        });
+    }
+    const modules = (0, utils_1.unique)(references.map((ref) => ref.target));
+    const promises = modules.map((mod) => traverseModule(mod, appGraph, deps, options));
+    return Promise.all(promises);
+}
+/**
+ * Resolve a single parsed Liquid file's outgoing references — the one place that
+ * knows how each Liquid construct (`render`/`include`, `function`, `background`,
+ * `graphql`, asset filters) maps to a target module + {@link ReferenceKind}.
+ *
+ * Both the full-project traversal ({@link traverseLiquidModule}) and the
+ * standalone per-file primitive ({@link extractFileReferences}) go through this,
+ * so resolution can never drift between "graph build" and "validate one buffer".
+ *
+ * Targets are produced via the module factories (which normalize URIs), so keys
+ * match the rest of the graph on every platform. Unparseable input yields no
+ * references rather than throwing.
+ */
+async function resolveLiquidReferences(appGraph, sourceCode, deps) {
     if (sourceCode.ast instanceof Error)
-        return; // can't visit what you can't parse
+        return []; // can't visit what you can't parse
+    // Canonical target resolution (lib paths, module prefixes, extensions) is owned by
+    // platformos-common's DocumentsLocator — never re-derived here.
+    //
+    // `deps.app` is the caller's App, so a name is answered by the index it already holds
+    // (O(1), no I/O) and only an index MISS walks candidate directories. Without one the
+    // locator builds a walk-only stand-in and every reference lists a directory per
+    // candidate path — same answers, thousands of extra listings on a project the language
+    // server had already indexed. See `IDependencies.app`.
+    const documentsLocator = new platformos_common_1.DocumentsLocator(deps.fs, deps.app);
+    const rootUri = vscode_uri_1.URI.parse(appGraph.rootUri);
     const visitor = {
         // {{ 'app.js' | asset_url }}
-        // {{ 'image.png' | asset_img_url }}
-        // {{ 'icon.svg' | inline_asset_content }}
+        //
+        // `asset_url` is the ONLY filter that names an asset. `asset_img_url` and
+        // `inline_asset_content` stood beside it here and are Shopify's, inherited with the fork:
+        // neither is in `filters.json`, so no platformOS template can call one, and the four sample
+        // projects contain zero uses against 1142 of `asset_url`. A dead name in an edge rule is not
+        // harmless — it is a claim about the platform that the next reader has no reason to doubt.
         LiquidFilter: async (node, ancestors) => {
-            if (['asset_url', 'asset_img_url', 'inline_asset_content'].includes(node.name)) {
+            if (node.name === 'asset_url') {
                 const parentNode = ancestors[ancestors.length - 1];
                 if (parentNode.type !== liquid_html_parser_1.NodeTypes.LiquidVariable)
                     return;
@@ -50,63 +121,303 @@ async function traverseLiquidModule(module, appGraph, deps) {
                 if (parentNode.filters[0] !== node)
                     return;
                 const asset = parentNode.expression.value;
-                const assetModule = (0, module_1.getAssetModule)(appGraph, asset);
-                if (!assetModule)
+                // Skip a non-asset value before paying for the filesystem probe below.
+                // Not the only gate: `getAssetModuleByUri` applies the same predicate, so
+                // neither layer relies on the other remembering.
+                if (!(0, module_1.isSupportedAsset)(asset))
+                    return;
+                // Resolve through DocumentsLocator (`'asset'`: app/assets, module
+                // public/assets) — not a hard-coded base — so the target matches the
+                // real on-disk location, with the canonical `app/assets/<name>` as the
+                // fallback for an unresolved asset.
+                const uri = await documentsLocator.locateOrDefault(rootUri, 'asset', asset);
+                if (!uri)
                     return;
+                const target = (0, module_1.getAssetModuleByUri)(appGraph, uri);
+                if (!target)
+                    return; // resolution changed the extension — no asset node
                 return {
-                    target: assetModule,
+                    target,
                     sourceRange: [parentNode.position.start, parentNode.position.end],
+                    kind: 'asset',
                 };
             }
         },
-        // <custom-element></custom-element>
-        HtmlElement: async (node) => {
-            if (node.name.length !== 1)
-                return;
-            if (node.name[0].type !== liquid_html_parser_1.NodeTypes.TextNode)
+        // {% render 'partial' %} / {% include 'partial' %}
+        // Both resolve through DocumentsLocator (like function/graphql), so module
+        // prefixes (`modules/<m>/...`), the lib search path, and `.liquid` /
+        // `.html.liquid` extensions are handled uniformly — not hard-coded to
+        // `app/views/partials`.
+        RenderMarkup: async (node, ancestors) => {
+            const partial = node.partial;
+            const tag = ancestors.at(-1);
+            if (!isStringLiteral(partial))
+                return; // dynamic target — skip
+            const isInclude = tag.type === liquid_html_parser_1.NodeTypes.LiquidTag && tag.name === liquid_html_parser_1.NamedTags.include;
+            const uri = await documentsLocator.locateOrDefault(rootUri, isInclude ? 'include' : 'render', partial.value);
+            if (!uri)
                 return;
-            const nodeNameNode = node.name[0];
-            const nodeName = nodeNameNode.value;
-            if (!nodeName.includes('-'))
-                return; // skip non-custom-elements
-            const result = deps.getWebComponentDefinitionReference(nodeName);
-            if (!result)
+            return {
+                target: (0, module_1.getPartialModuleByUri)(appGraph, uri),
+                sourceRange: [tag.position.start, tag.position.end],
+                kind: isInclude ? 'include' : 'render',
+                args: argNames(node.args),
+            };
+        },
+        // {% function result = 'queries/...' %} / {% function res = 'commands/...' %}
+        FunctionMarkup: async (node, ancestors) => {
+            const target = node.partial;
+            const tag = ancestors.at(-1);
+            if (!isStringLiteral(target))
+                return; // dynamic target — skip
+            const uri = await documentsLocator.locateOrDefault(rootUri, 'function', target.value);
+            if (!uri)
                 return;
-            const { assetName, range } = result;
-            const assetModule = (0, module_1.getAssetModule)(appGraph, assetName);
-            if (!assetModule)
+            return {
+                target: (0, module_1.getPartialModuleByUri)(appGraph, uri),
+                sourceRange: [tag.position.start, tag.position.end],
+                kind: 'function',
+                args: argNames(node.args),
+            };
+        },
+        // {% background job_id = 'partial', ... %} (file-based form)
+        // Runs a partial asynchronously; `node.partial` is the partial reference,
+        // resolved against the same search paths as {% function %}. The inline form
+        // ({% background %}...{% endbackground %}) parses to BackgroundInlineMarkup,
+        // has no file target, and is intentionally not matched here.
+        BackgroundMarkup: async (node, ancestors) => {
+            const target = node.partial;
+            const tag = ancestors.at(-1);
+            if (!isStringLiteral(target))
+                return; // dynamic target — skip
+            const uri = await documentsLocator.locateOrDefault(rootUri, 'function', target.value);
+            if (!uri)
                 return;
             return {
-                target: assetModule,
-                sourceRange: [node.blockStartPosition.start, nodeNameNode.position.end],
-                targetRange: range,
+                target: (0, module_1.getPartialModuleByUri)(appGraph, uri),
+                sourceRange: [tag.position.start, tag.position.end],
+                kind: 'background',
+                args: argNames(node.args),
             };
         },
-        // {% render 'partial' %}
-        RenderMarkup: async (node, ancestors) => {
-            const partial = node.partial;
+        // {% graphql result = 'path/to/operation' %}
+        // `node.name` is the RESULT variable; the operation-file path is `node.graphql`.
+        GraphQLMarkup: async (node, ancestors) => {
+            const op = node.graphql;
             const tag = ancestors.at(-1);
-            if (!(0, utils_1.isString)(partial) && partial.type === liquid_html_parser_1.NodeTypes.String) {
-                return {
-                    target: (0, module_1.getPartialModule)(appGraph, partial.value),
-                    sourceRange: [tag.position.start, tag.position.end],
-                };
-            }
+            if (!isStringLiteral(op))
+                return; // dynamic/inline — no static file
+            const uri = await documentsLocator.locateOrDefault(rootUri, 'graphql', op.value);
+            if (!uri)
+                return;
+            return {
+                target: (0, module_1.getGraphQLModuleByUri)(appGraph, uri),
+                sourceRange: [tag.position.start, tag.position.end],
+                kind: 'graphql',
+                args: argNames(node.args),
+            };
+        },
+        // Frontmatter `layout: name` → page/email → its wrapper layout.
+        // Resolved through DocumentsLocator (`'layout'`: app/views/layouts, module
+        // prefixes, `.html.liquid`/`.liquid`). Only an EXPLICIT, static, non-empty
+        // string layout produces an edge:
+        //  - `layout: ''`        → explicitly no layout (no edge)
+        //  - layout omitted      → no edge (we never synthesize the implicit default)
+        //  - dynamic `{{ ... }}` → no edge (not statically resolvable)
+        //  - non-string value    → no edge
+        // The source range is the whole frontmatter block (tag-level granularity,
+        // like the other edges).
+        YAMLFrontmatter: async (node) => {
+            const data = loadFrontmatter(node.body);
+            if (!data)
+                return; // malformed/empty frontmatter — nothing to resolve
+            const layout = data.layout;
+            if (typeof layout !== 'string' || layout === '' || (0, platformos_common_1.containsLiquid)(layout))
+                return;
+            const uri = await documentsLocator.locateOrDefault(rootUri, 'layout', layout);
+            if (!uri)
+                return;
+            return {
+                target: (0, module_1.getLayoutModuleByUri)(appGraph, uri),
+                sourceRange: [node.position.start, node.position.end],
+                kind: 'layout',
+            };
         },
     };
-    const references = await (0, platformos_check_common_1.visit)(sourceCode.ast, visitor);
-    for (const reference of references) {
-        bind(module, reference.target, {
-            sourceRange: reference.sourceRange,
-            targetRange: reference.targetRange,
-        });
+    return (0, platformos_check_common_1.visit)(sourceCode.ast, visitor);
+}
+/**
+ * Extract one Liquid file's outgoing dependency references, resolved against the project at
+ * `rootUri`, WITHOUT building the whole app graph.
+ *
+ * The per-file primitive for consumers holding a single (possibly in-flight, not-yet-on-disk)
+ * buffer. Resolution uses the same `DocumentsLocator`-backed logic as the full graph build, so
+ * a target's URI is identical to the key it would have as a graph node.
+ *
+ * Notes for consumers:
+ * - Targets are returned whether or not they exist on disk (resolution is path-based). To
+ *   distinguish missing targets, `stat` `target.uri` via the same `fs`.
+ * - Only statically resolvable references are returned; dynamic targets
+ *   (`{% render some_var %}`) and inline forms are skipped.
+ * - `sourceCode` is parsed by the caller; nothing but target resolution happens here.
+ */
+async function extractFileReferences(rootUri, sourceUri, sourceCode, deps) {
+    // A throwaway graph so the URI-normalizing module factories can be reused; it
+    // is never traversed and is discarded with this call.
+    const scratchGraph = { rootUri, entryPoints: [], modules: {} };
+    const references = await resolveLiquidReferences(scratchGraph, sourceCode, deps);
+    return references.map((reference) => ({
+        source: { uri: sourceUri, range: reference.sourceRange },
+        target: { uri: reference.target.uri },
+        type: 'direct',
+        kind: reference.kind,
+        ...argsField(reference.args),
+    }));
+}
+/**
+ * A render/function/graphql target that is a static string literal (e.g.
+ * `{% render 'partial' %}`), narrowed to its `NodeTypes.String` member so the
+ * `.value` is accessible. Dynamic targets (`{% render var %}`) return false and
+ * are skipped — the graph only records statically resolvable edges.
+ */
+function isStringLiteral(node) {
+    return !(0, utils_1.isString)(node) && node.type === liquid_html_parser_1.NodeTypes.String;
+}
+/**
+ * Parse a YAML block (frontmatter body or a schema file) into an object, or
+ * `undefined` for unparseable / non-object YAML. The single `js-yaml` entry
+ * point shared by the layout-edge resolver, schema-table extraction, and
+ * self-structural extraction — so there is one frontmatter/YAML parse path.
+ */
+function loadFrontmatter(body) {
+    let data;
+    try {
+        // A duplicated key must not cost this file its edges — see
+        // PLATFORM_YAML_LOAD_OPTIONS. js-yaml's default throws, and the `catch` below
+        // then reports the file as having no frontmatter and no schema at all, which is
+        // how one repeated key silently removes a layout or partial from the graph.
+        data = js_yaml_1.default.load(body, platformos_common_1.PLATFORM_YAML_LOAD_OPTIONS);
     }
-    const modules = unique(references.map((ref) => ref.target));
-    const promises = modules.map((mod) => traverseModule(mod, appGraph, deps));
-    return Promise.all(promises);
+    catch {
+        return undefined;
+    }
+    return typeof data === 'object' && data !== null ? data : undefined;
 }
-function unique(arr) {
-    return [...new Set(arr)];
+/**
+ * Extract a Liquid file's own structural declarations from an already-parsed source — the
+ * per-file primitive, sibling to {@link extractFileReferences}. Reuses the shared `js-yaml`
+ * frontmatter parse, platformos-common's slug helpers, and check-common's liquid-doc and
+ * translation detection — never a second parser.
+ *
+ * Usage facts come from one walk of the parsed AST and are always present (sorted,
+ * de-duplicated); `doc_params` is in source order. Routing facts come from frontmatter: `slug`
+ * is the frontmatter override else the path-derived slug, for page files only, and
+ * `layout`/`method` when declared.
+ *
+ * Returns `undefined` for a non-Liquid source or one that could not be parsed.
+ */
+async function extractStructural(sourceCode, uri) {
+    // Only a parsed Liquid AST has the structure this analyzes; a `.graphql`/`.yml`
+    // buffer (or an unparseable one) yields no structural facts.
+    if (sourceCode.type !== platformos_check_common_1.SourceCodeType.LiquidHtml || sourceCode.ast instanceof Error) {
+        return undefined;
+    }
+    const renders = new Set();
+    const graphqlQueries = new Set();
+    const filters = new Set();
+    const tags = new Set();
+    const translationKeys = new Set();
+    // `{% doc %}` @param names, in source (signature) order — not sorted/de-duped.
+    const docParams = [];
+    // A single walk of the already-parsed AST collects every usage fact — no
+    // second traversal (the doc `@param` names are read from the parser-produced
+    // `LiquidDocParamNode`s in this same pass, as `extractDocDefinition` would).
+    await (0, platformos_check_common_1.visit)(sourceCode.ast, {
+        RenderMarkup: async (node) => {
+            if (isStringLiteral(node.partial))
+                renders.add(node.partial.value);
+        },
+        GraphQLMarkup: async (node) => {
+            if (isStringLiteral(node.graphql))
+                graphqlQueries.add(node.graphql.value);
+        },
+        LiquidFilter: async (node) => {
+            filters.add(node.name);
+        },
+        LiquidTag: async (node) => {
+            if (typeof node.name === 'string')
+                tags.add(node.name);
+        },
+        // A translation-key usage is a string literal piped through `t`/`translate`,
+        // e.g. `{{ 'greeting.hello' | t }}` — detected via check-common's shared
+        // `isTranslationKeyUsage` so it cannot drift from the translation check.
+        LiquidVariable: async (node) => {
+            if ((0, platformos_check_common_1.isTranslationKeyUsage)(node))
+                translationKeys.add(node.expression.value);
+        },
+        LiquidDocParamNode: async (node) => {
+            docParams.push(node.paramName.value);
+        },
+    });
+    const frontmatter = loadFrontmatterOf(sourceCode);
+    const layout = typeof frontmatter?.layout === 'string' ? frontmatter.layout : undefined;
+    const method = typeof frontmatter?.method === 'string' ? frontmatter.method : undefined;
+    const slug = effectiveSlug(uri, frontmatter);
+    const sorted = (set) => [...set].sort((a, b) => a.localeCompare(b));
+    return {
+        renders_used: sorted(renders),
+        graphql_queries_used: sorted(graphqlQueries),
+        filters_used: sorted(filters),
+        tags_used: sorted(tags),
+        translation_keys: sorted(translationKeys),
+        doc_params: docParams,
+        ...(slug !== undefined ? { slug } : {}),
+        ...(layout !== undefined ? { layout } : {}),
+        ...(method !== undefined ? { method } : {}),
+    };
+}
+/** The parsed frontmatter object of a Liquid file, if it has parseable frontmatter. */
+function loadFrontmatterOf(sourceCode) {
+    if (sourceCode.type !== platformos_check_common_1.SourceCodeType.LiquidHtml)
+        return undefined;
+    const ast = sourceCode.ast;
+    if (ast instanceof Error || ast.type !== liquid_html_parser_1.NodeTypes.Document)
+        return undefined;
+    const node = ast.children.find((child) => child.type === liquid_html_parser_1.NodeTypes.YAMLFrontmatter);
+    return node?.type === liquid_html_parser_1.NodeTypes.YAMLFrontmatter ? loadFrontmatter(node.body) : undefined;
+}
+/**
+ * The effective URL slug for `uri`, delegating to `effectivePageSlug` — the
+ * single slug-derivation shared with `RouteTable`, so the graph's routing fact
+ * can never drift from the platform's actual routing (override-wins, coerced to
+ * a string; else path-derived using the effective format). Returns `undefined`
+ * for a non-page file unless it declares an explicit `slug` override.
+ */
+function effectiveSlug(uri, frontmatter) {
+    const relativePath = (0, platformos_common_1.extractRelativePagePath)(uri);
+    if (relativePath !== null)
+        return (0, platformos_common_1.effectivePageSlug)(relativePath, frontmatter);
+    // Non-page file: only an explicit `slug` override is meaningful.
+    const slug = frontmatter?.slug;
+    return slug !== undefined && slug !== null ? String(slug) : undefined;
+}
+/**
+ * The names of a call site's named arguments, in source order, or `undefined`
+ * when there are none (so an argument-less edge carries no `args` field). Values
+ * are intentionally not captured — names are what cross-checking against a
+ * partial's `@param` signature needs. Every `LiquidNamedArgument` has a string
+ * `name` by construction, so no per-element guard is required.
+ */
+function argNames(args) {
+    return args.length > 0 ? args.map((arg) => arg.name) : undefined;
+}
+/**
+ * The spreadable `args` field for an edge: present only for a non-empty
+ * argument-name list, absent otherwise. The single place the "omit when none"
+ * rule lives, so {@link bind} and {@link extractFileReferences} cannot diverge.
+ */
+function argsField(args) {
+    return args && args.length > 0 ? { args } : {};
 }
 /**
  * The bind method is the method that links two modules together.
@@ -115,12 +426,16 @@ function unique(arr) {
  *
  * This function mutates the source and target modules.
  */
-function bind(source, target, { sourceRange, targetRange, type = 'direct', // the type of dependency, can be 'direct' or 'indirect'
+function bind(source, target, { sourceRange, type = 'direct', // the type of dependency, can be 'direct' or 'indirect'
+kind, // the semantic Liquid construct that created the edge
+args, // names of the named arguments at the call site (omitted when none)
  } = {}) {
     const dependency = {
         source: { uri: source.uri, range: sourceRange },
-        target: { uri: target.uri, range: targetRange },
+        target: { uri: target.uri },
         type: type,
+        kind: kind,
+        ...argsField(args),
     };
     source.dependencies.push(dependency);
     target.references.push(dependency);

package/dist/graph/traverse.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 export { buildAppGraph } from './graph/build';
+export { enumerateEdgeSources, isEdgeSource } from './graph/edge-sources';
+export { extractFileReferences, extractStructural } from './graph/traverse';
+export { dependenciesOf, dependentsOf, exists, isEntryPoint, isOrphan, orphans, reachableFrom, missingDependencies, missingTargets, nearestModules, } from './graph/query';
+export type { NearestModulesOptions } from './graph/query';
 export { serializeAppGraph } from './graph/serialize';
-export { getWebComponentMap, findWebComponentReferences } from './getWebComponentMap';
 export { parseJs, toSourceCode } from './toSourceCode';
+export { appBackedGetSourceCode, graphParsers } from './parsers';
 export * from './types';