@platformos/platformos-graph 0.0.19 → 0.0.20

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # shopify/theme-graph
 
+## 0.0.20
+
+### Patch Changes
+
+- bc1b71f: Release changes accumulated since 0.0.19: multi-line and JSON support in tags, refreshed warnings for referenced partials, platformos-graph project structural/dependency model for the supervisor, and updated linter documentation data.
+- MCP Supervisor
+- Updated dependencies [bc1b71f]
+- Updated dependencies [4b6e0aa]
+- Updated dependencies
+  - @platformos/liquid-html-parser@0.0.18
+  - @platformos/platformos-common@0.0.18
+  - @platformos/platformos-check-common@0.0.20
+
 ## 0.0.19
 
 ### Patch Changes

package/bin/platformos-graph

@@ -1,107 +1,47 @@
 #!/usr/bin/env node
 
-const { buildThemeGraph, serializeThemeGraph, toSourceCode } = require('@platformos/theme-graph');
-const {
-  NodeFileSystem,
-  memoize,
-  toSchema,
-  path: pathUtils,
-  recursiveReadDirectory,
-} = require('@platformos/theme-check-node');
-const path = require('path');
-const { URI } = require('vscode-uri');
+const { buildSerializedGraph, buildSerializedFileDependencies } = require('../dist/cli');
 
 const usage = `
 Usage:
-  theme-graph <path-to-theme-directory>
+  platformos-graph <path-to-app-directory> [file]
 
-Example:
-  theme-graph horizon > graph.json
-`;
+Without [file], prints the whole app graph (nodes + edges).
+With [file], prints that single file's dependencies and references.
+A relative [file] is resolved against the project directory.
 
-const identity = (/** @type {any} */ x) => x;
+Examples:
+  platformos-graph ./app > graph.json
+  platformos-graph ./app app/views/partials/header.liquid
+`;
 
-/**
- * Outputs the JSON representing the theme graph for a Shopify theme directory.
- *
- * @param {string} root
- */
-async function main(root) {
+async function main(root, file) {
   if (!root) {
     console.error(usage);
     process.exit(1);
   }
 
-  if (!path.isAbsolute(root)) {
-    root = path.resolve(process.cwd(), root);
-  }
-
-  const getSourceCode = makeGetSourceCode();
-
-  // Preload files to get a sense of what is slow
-  const fs = NodeFileSystem;
-  const rootUri = URI.file(root).toString(true);
-  const filesToPreload = await recursiveReadDirectory(fs, rootUri, ([uri]) =>
-    ['.json', '.liquid'].some((ext) => uri.endsWith(ext)),
-  );
-  await bench('Preloading files', async () => {
-    await Promise.all(
-      filesToPreload.map(async (uri) => {
-        await getSourceCode(uri);
-      }),
-    );
-  });
-
-  /** @type {import('@platformos/theme-graph').WebComponentMap} */
-  const webComponentDefs = new Map();
-
-  /** @type {import('@platformos/theme-graph').Dependencies} */
-  const dependencies = {
-    fs,
-    // @ts-ignore
-    getSectionSchema: memoize(async (name) => {
-      const uri = pathUtils.join(rootUri, 'sections', `${name}.liquid`);
-      const sourceCode = await getSourceCode(uri);
-      return toSchema('theme', uri, /** @type {any} */ (sourceCode), async () => true);
-    }, identity),
-    // @ts-ignore
-    getBlockSchema: memoize(async (name) => {
-      const uri = pathUtils.join(rootUri, 'blocks', `${name}.liquid`);
-      const sourceCode = await getSourceCode(uri);
-      return toSchema('theme', uri, /** @type {any} */ (sourceCode), async () => true);
-    }, identity),
-    getSourceCode,
-    getWebComponentDefinitionReference: (customElementName) =>
-      webComponentDefs.get(customElementName),
-  };
-
-  // Build graph
-  const graph = await bench('Build graph', () => buildThemeGraph(rootUri, dependencies));
-
-  // Serialize into JSON
-  const serializedGraph = serializeThemeGraph(graph);
-
-  // Print result to STDOUT
-  console.log(JSON.stringify(serializedGraph));
-}
+  const result = file
+    ? await bench('Build graph', () => buildSerializedFileDependencies(root, file))
+    : await bench('Build graph', () => buildSerializedGraph(root));
 
-function makeGetSourceCode() {
-  return memoize(async function getSourceCode(uri) {
-    const source = await NodeFileSystem.readFile(uri);
-    return await toSourceCode(URI.file(uri).toString(), source);
-  }, identity);
+  // Print result to STDOUT (diagnostics go to STDERR), so it can be piped.
+  console.log(JSON.stringify(result));
 }
 
 /**
  * @param {string} name
- * @param {(...args: any[]) => Promise<any>} fn
+ * @param {() => Promise<any>} fn
  */
 async function bench(name, fn) {
   const start = performance.now();
   const result = await fn();
   const end = performance.now();
-  console.error(`${name} took ${end - start}ms`);
+  console.error(`${name} took ${(end - start).toFixed(1)}ms`);
   return result;
 }
 
-main(process.argv[2]);
+main(process.argv[2], process.argv[3]).catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/dist/cli.d.ts

@@ -0,0 +1,46 @@
+import { AbstractFileSystem } from '@platformos/platformos-common';
+import { Reference, SerializableGraph } from './types';
+/**
+ * A self-contained {@link AbstractFileSystem} backed by `node:fs`.
+ *
+ * The graph driver speaks file URIs, so every method converts the incoming URI
+ * to a native path with `path.fsPath` and re-emits child URIs with `path.join`
+ * (which preserves the `file://` scheme). This mirrors `NodeFileSystem` from
+ * `@platformos/platformos-check-node` exactly, but is inlined here so the CLI
+ * runs with only this package's own dependencies — `platformos-check-node` is a
+ * dev-only dependency and must not be required at runtime.
+ */
+export declare const nodeFileSystem: AbstractFileSystem;
+/**
+ * The dependency and reference edges of a single module, as produced for the
+ * CLI's single-file mode.
+ */
+export interface SerializableFileDependencies {
+    /** The resolved file URI, as keyed in the graph. */
+    uri: string;
+    /** Outgoing edges — the modules this file renders/includes/runs/queries. */
+    dependencies: Reference[];
+    /** Incoming edges — the modules that render/include/run/query this file. */
+    references: Reference[];
+}
+/**
+ * Builds the platformOS app graph for the project rooted at `root` (a native
+ * filesystem path, absolute or relative to `process.cwd()`) and returns it in
+ * serializable JSON form.
+ *
+ * `fs` is injectable for testing; it defaults to the node-backed filesystem.
+ */
+export declare function buildSerializedGraph(root: string, fs?: AbstractFileSystem): Promise<SerializableGraph>;
+/**
+ * Builds the full app graph for `root` and returns the dependency and reference
+ * edges of the single module at `file`.
+ *
+ * The graph is built from its real entry points (every layout and page), not
+ * seeded from `file`, so that incoming `references` are complete — the same
+ * approach the language server's `AppGraphManager` takes. A file that is not
+ * reachable from any entry point therefore has no node in the graph; rather
+ * than reporting a misleading empty edge set, this throws.
+ *
+ * `fs` is injectable for testing; it defaults to the node-backed filesystem.
+ */
+export declare function buildSerializedFileDependencies(root: string, file: string, fs?: AbstractFileSystem): Promise<SerializableFileDependencies>;

package/dist/cli.js

@@ -0,0 +1,126 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeFileSystem = void 0;
+exports.buildSerializedGraph = buildSerializedGraph;
+exports.buildSerializedFileDependencies = buildSerializedFileDependencies;
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+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 build_1 = require("./graph/build");
+const serialize_1 = require("./graph/serialize");
+/**
+ * A self-contained {@link AbstractFileSystem} backed by `node:fs`.
+ *
+ * The graph driver speaks file URIs, so every method converts the incoming URI
+ * to a native path with `path.fsPath` and re-emits child URIs with `path.join`
+ * (which preserves the `file://` scheme). This mirrors `NodeFileSystem` from
+ * `@platformos/platformos-check-node` exactly, but is inlined here so the CLI
+ * runs with only this package's own dependencies — `platformos-check-node` is a
+ * dev-only dependency and must not be required at runtime.
+ */
+exports.nodeFileSystem = {
+    async readFile(uri) {
+        return promises_1.default.readFile(platformos_check_common_1.path.fsPath(uri), 'utf8');
+    },
+    async readDirectory(uri) {
+        const entries = await promises_1.default.readdir(platformos_check_common_1.path.fsPath(uri), { withFileTypes: true });
+        return entries.map((entry) => [
+            platformos_check_common_1.path.join(uri, entry.name),
+            entry.isDirectory() ? platformos_common_1.FileType.Directory : platformos_common_1.FileType.File,
+        ]);
+    },
+    async stat(uri) {
+        try {
+            const stats = await promises_1.default.stat(platformos_check_common_1.path.fsPath(uri));
+            return {
+                type: stats.isDirectory() ? platformos_common_1.FileType.Directory : platformos_common_1.FileType.File,
+                size: stats.size,
+            };
+        }
+        catch (e) {
+            throw new Error(`Failed to get file stat: ${e}`);
+        }
+    },
+};
+/**
+ * Resolves the given root path (absolute, or relative to `process.cwd()`) to the
+ * forward-slash-normalized `file://` URI of the enclosing platformOS project,
+ * using the same `findRoot` heuristic as the language server (an `app/`,
+ * `modules/`, `.pos`, or `.platformos-check.yml` marker at or above the path).
+ *
+ * Throws when no project is found, so a typo'd or non-platformOS directory fails
+ * loudly instead of silently producing an empty graph. Resolving via `findRoot`
+ * also lets the CLI be pointed anywhere inside a project, not just at its root.
+ *
+ * Normalization is load-bearing: the graph keys every module via `path.join` /
+ * `path.normalize` (forward slashes), so any lookup must key the same way or it
+ * silently misses on Windows, where raw URIs keep backslashes.
+ */
+async function resolveProjectRoot(root, fs) {
+    const absolute = node_path_1.default.isAbsolute(root) ? root : node_path_1.default.resolve(process.cwd(), root);
+    const startUri = platformos_check_common_1.path.normalize(vscode_uri_1.URI.file(absolute));
+    const rootUri = await (0, platformos_check_common_1.findRoot)(startUri, (0, platformos_check_common_1.makeFileExists)(fs));
+    if (!rootUri) {
+        throw new Error(`Not a platformOS project: ${startUri}\n` +
+            `No app/, modules/, .pos, or .platformos-check.yml found at or above this path. ` +
+            `Pass the path to a platformOS app directory.`);
+    }
+    return rootUri;
+}
+/**
+ * Resolves the single-file argument to a graph module key. An absolute path is
+ * taken as-is; a relative path is resolved against the project **root** (not
+ * `process.cwd()`), matching the natural "a file within this project" mental
+ * model — only files under the root can appear in the graph anyway.
+ */
+function resolveFileUri(rootUri, file) {
+    if (node_path_1.default.isAbsolute(file)) {
+        return platformos_check_common_1.path.normalize(vscode_uri_1.URI.file(file));
+    }
+    return platformos_check_common_1.path.join(rootUri, ...file.split(/[\\/]+/).filter(Boolean));
+}
+/**
+ * Builds the platformOS app graph for the project rooted at `root` (a native
+ * filesystem path, absolute or relative to `process.cwd()`) and returns it in
+ * serializable JSON form.
+ *
+ * `fs` is injectable for testing; it defaults to the node-backed filesystem.
+ */
+async function buildSerializedGraph(root, fs = exports.nodeFileSystem) {
+    const graph = await (0, build_1.buildAppGraph)(await resolveProjectRoot(root, fs), { fs });
+    return (0, serialize_1.serializeAppGraph)(graph);
+}
+/**
+ * Builds the full app graph for `root` and returns the dependency and reference
+ * edges of the single module at `file`.
+ *
+ * The graph is built from its real entry points (every layout and page), not
+ * seeded from `file`, so that incoming `references` are complete — the same
+ * approach the language server's `AppGraphManager` takes. A file that is not
+ * reachable from any entry point therefore has no node in the graph; rather
+ * than reporting a misleading empty edge set, this throws.
+ *
+ * `fs` is injectable for testing; it defaults to the node-backed filesystem.
+ */
+async function buildSerializedFileDependencies(root, file, fs = exports.nodeFileSystem) {
+    const rootUri = await resolveProjectRoot(root, fs);
+    const fileUri = resolveFileUri(rootUri, file);
+    const graph = await (0, build_1.buildAppGraph)(rootUri, { fs });
+    const module = graph.modules[fileUri];
+    if (!module) {
+        throw new Error(`File is not part of the app graph: ${fileUri}\n` +
+            `It must exist and be reachable from a layout or page entry point. ` +
+            `Check the path is correct and inside the project root (${rootUri}).`);
+    }
+    return {
+        uri: module.uri,
+        dependencies: module.dependencies,
+        references: module.references,
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/graph/augment.js

@@ -13,7 +13,6 @@ function augmentDependencies(rootUri, ideps) {
                 const contents = await ideps.fs.readFile(uri);
                 return (0, toSourceCode_1.toSourceCode)(uri, contents);
             }, utils_1.identity),
-        getWebComponentDefinitionReference: ideps.getWebComponentDefinitionReference,
     };
 }
 //# sourceMappingURL=augment.js.map

package/dist/graph/augment.js.map

@@ -1 +1 @@
-{"version":3,"file":"augment.js","sourceRoot":"","sources":["../../src/graph/augment.ts"],"names":[],"mappings":";;AAKA,kDAgBC;AArBD,iFAAoE;AACpE,kDAA+C;AAE/C,oCAAoC;AAEpC,SAAgB,mBAAmB,CAAC,OAAe,EAAE,KAAoB;IACvE,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QAEZ,qBAAqB;QACrB,aAAa,EAAE,IAAA,iCAAO,EACpB,KAAK,CAAC,aAAa;YACjB,KAAK,UAAU,oBAAoB,CAAC,GAAG;gBACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC9C,OAAO,IAAA,2BAAY,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACrC,CAAC,EACH,gBAAQ,CACT;QAED,kCAAkC,EAAE,KAAK,CAAC,kCAAkC;KAC7E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"augment.js","sourceRoot":"","sources":["../../src/graph/augment.ts"],"names":[],"mappings":";;AAKA,kDAcC;AAnBD,iFAAoE;AACpE,kDAA+C;AAE/C,oCAAoC;AAEpC,SAAgB,mBAAmB,CAAC,OAAe,EAAE,KAAoB;IACvE,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QAEZ,qBAAqB;QACrB,aAAa,EAAE,IAAA,iCAAO,EACpB,KAAK,CAAC,aAAa;YACjB,KAAK,UAAU,oBAAoB,CAAC,GAAG;gBACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC9C,OAAO,IAAA,2BAAY,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACrC,CAAC,EACH,gBAAQ,CACT;KACF,CAAC;AACJ,CAAC"}

package/dist/graph/module.d.ts

@@ -1,7 +1,22 @@
 import { UriString } from '@platformos/platformos-check-common';
-import { AssetModule, AppGraph, AppModule, LiquidModule } from '../types';
+import { AssetModule, AppGraph, AppModule, GraphQLModule, LiquidModule } from '../types';
 export declare function getModule(appGraph: AppGraph, uri: UriString): AppModule | undefined;
 export declare function getAssetModule(appGraph: AppGraph, asset: string): AssetModule | undefined;
 export declare function getPartialModule(appGraph: AppGraph, partial: string): LiquidModule;
+/**
+ * Create (or fetch the cached) Liquid Partial module for an ALREADY-RESOLVED
+ * full URI — used for `{% function %}` / `{% include %}` targets whose URI is
+ * resolved canonically by `DocumentsLocator` (which handles lib paths, module
+ * prefixes, and extensions). Unlike {@link getPartialModule}, it does not
+ * reconstruct the path from a name. Commands/queries/lib helpers are all
+ * `Partial` kind, consistent with check-common's file-type classification.
+ */
+export declare function getPartialModuleByUri(appGraph: AppGraph, uri: string): LiquidModule;
+/**
+ * Create (or fetch the cached) GraphQL module for an already-resolved
+ * `.graphql` URI — used for `{% graphql op = 'name' %}` targets resolved by
+ * `DocumentsLocator`. A leaf node (no outgoing edges).
+ */
+export declare function getGraphQLModuleByUri(appGraph: AppGraph, uri: string): GraphQLModule;
 export declare function getLayoutModule(appGraph: AppGraph, layoutUri: string | false | undefined): LiquidModule | undefined;
 export declare function getPageModule(appGraph: AppGraph, pageUri: string): LiquidModule;

package/dist/graph/module.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getModule = getModule;
 exports.getAssetModule = getAssetModule;
 exports.getPartialModule = getPartialModule;
+exports.getPartialModuleByUri = getPartialModuleByUri;
+exports.getGraphQLModuleByUri = getGraphQLModuleByUri;
 exports.getLayoutModule = getLayoutModule;
 exports.getPageModule = getPageModule;
 const platformos_check_common_1 = require("@platformos/platformos-check-common");
@@ -74,6 +76,43 @@ function getPartialModule(appGraph, partial) {
         references: [],
     });
 }
+/**
+ * Create (or fetch the cached) Liquid Partial module for an ALREADY-RESOLVED
+ * full URI — used for `{% function %}` / `{% include %}` targets whose URI is
+ * resolved canonically by `DocumentsLocator` (which handles lib paths, module
+ * prefixes, and extensions). Unlike {@link getPartialModule}, it does not
+ * reconstruct the path from a name. Commands/queries/lib helpers are all
+ * `Partial` kind, consistent with check-common's file-type classification.
+ */
+function getPartialModuleByUri(appGraph, uri) {
+    return module(appGraph, {
+        type: "Liquid" /* ModuleType.Liquid */,
+        kind: "partial" /* LiquidModuleKind.Partial */,
+        // Normalize to forward slashes so module keys match the rest of the graph
+        // (getPartialModule/getAssetModule build URIs via path.join, which
+        // normalizes). DocumentsLocator returns `Utils.joinPath(...).toString()`
+        // unnormalized, which on Windows keeps backslashes and breaks key/edge
+        // matching against the normalized URIs everywhere else.
+        uri: platformos_check_common_1.path.normalize(uri),
+        dependencies: [],
+        references: [],
+    });
+}
+/**
+ * Create (or fetch the cached) GraphQL module for an already-resolved
+ * `.graphql` URI — used for `{% graphql op = 'name' %}` targets resolved by
+ * `DocumentsLocator`. A leaf node (no outgoing edges).
+ */
+function getGraphQLModuleByUri(appGraph, uri) {
+    return module(appGraph, {
+        type: "GraphQL" /* ModuleType.GraphQL */,
+        kind: 'graphql',
+        // Normalize to forward slashes — see getPartialModuleByUri.
+        uri: platformos_check_common_1.path.normalize(uri),
+        dependencies: [],
+        references: [],
+    });
+}
 function getLayoutModule(appGraph, layoutUri) {
     if (!layoutUri)
         return undefined;

package/dist/graph/module.js.map

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

package/dist/graph/test-helpers.d.ts

@@ -7,7 +7,7 @@ export declare function makeGetSourceCode(fs: AbstractFileSystem): {
 };
 export declare const fixturesRoot: string;
 export declare const skeleton: string;
-export declare function getDependencies(rootUri: string, fs?: AbstractFileSystem): Promise<{
+export declare function getDependencies(fs?: AbstractFileSystem): {
     fs: AbstractFileSystem;
     getSourceCode: {
         (x: string): Promise<import("..").FileSourceCode>;
@@ -15,8 +15,7 @@ export declare function getDependencies(rootUri: string, fs?: AbstractFileSystem
         invalidate(x: string): void;
         clearCache(): void;
     };
-    getWebComponentDefinitionReference: (customElementName: string) => import("..").WebComponentDefinition | undefined;
-}>;
+};
 export declare function mockImpl(obj: any, method: any, callback: any): import("vitest").MockInstance<any> & (new (...args: unknown[]) => any) & {
     [x: string]: any;
 };

package/dist/graph/test-helpers.js

@@ -8,7 +8,6 @@ const platformos_check_common_1 = require("@platformos/platformos-check-common")
 const platformos_check_node_1 = require("@platformos/platformos-check-node");
 const vitest_1 = require("vitest");
 const vscode_uri_1 = require("vscode-uri");
-const getWebComponentMap_1 = require("../getWebComponentMap");
 const toSourceCode_1 = require("../toSourceCode");
 const utils_1 = require("../utils");
 function makeGetSourceCode(fs) {
@@ -19,15 +18,12 @@ function makeGetSourceCode(fs) {
 }
 exports.fixturesRoot = platformos_check_common_1.path.join(vscode_uri_1.URI.file(__dirname), ...'../../fixtures'.split('/'));
 exports.skeleton = platformos_check_common_1.path.join(exports.fixturesRoot, 'skeleton');
-async function getDependencies(rootUri, fs = platformos_check_node_1.NodeFileSystem) {
+function getDependencies(fs = platformos_check_node_1.NodeFileSystem) {
     const getSourceCode = makeGetSourceCode(fs);
-    const deps = {
+    return {
         fs,
         getSourceCode,
-        getWebComponentDefinitionReference: (customElementName) => webComponentDefs.get(customElementName),
     };
-    const webComponentDefs = await (0, getWebComponentMap_1.getWebComponentMap)(rootUri, deps);
-    return deps;
 }
 // This thing is way too hard to type.
 function mockImpl(obj, method, callback) {

package/dist/graph/test-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/graph/test-helpers.ts"],"names":[],"mappings":";;;AASA,8CAKC;AAKD,0CAYC;AAGD,4BAKC;AAvCD,iFAAiF;AAEjF,6EAAmE;AACnE,mCAA4B;AAC5B,2CAAiC;AACjC,8DAA2D;AAC3D,kDAA+C;AAC/C,oCAAoC;AAEpC,SAAgB,iBAAiB,CAAC,EAAsB;IACtD,OAAO,IAAA,iCAAO,EAAC,KAAK,UAAU,aAAa,CAAC,GAAW;QACrD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,IAAA,2BAAY,EAAC,gBAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC,EAAE,gBAAQ,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,YAAY,GAAG,8BAAS,CAAC,IAAI,CAAC,gBAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACnF,QAAA,QAAQ,GAAG,8BAAS,CAAC,IAAI,CAAC,oBAAY,EAAE,UAAU,CAAC,CAAC;AAE1D,KAAK,UAAU,eAAe,CAAC,OAAe,EAAE,KAAyB,sCAAc;IAC5F,MAAM,aAAa,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG;QACX,EAAE;QACF,aAAa;QACb,kCAAkC,EAAE,CAAC,iBAAyB,EAAE,EAAE,CAChE,gBAAgB,CAAC,GAAG,CAAC,iBAAiB,CAAC;KAC1C,CAAC;IAEF,MAAM,gBAAgB,GAAG,MAAM,IAAA,uCAAkB,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAEjE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sCAAsC;AACtC,SAAgB,QAAQ,CAAC,GAAQ,EAAE,MAAW,EAAE,QAAa;IAC3D,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,WAAE,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC;QAC9C,OAAO,QAAQ,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/graph/test-helpers.ts"],"names":[],"mappings":";;;AAQA,8CAKC;AAKD,0CAMC;AAGD,4BAKC;AAhCD,iFAAiF;AAEjF,6EAAmE;AACnE,mCAA4B;AAC5B,2CAAiC;AACjC,kDAA+C;AAC/C,oCAAoC;AAEpC,SAAgB,iBAAiB,CAAC,EAAsB;IACtD,OAAO,IAAA,iCAAO,EAAC,KAAK,UAAU,aAAa,CAAC,GAAW;QACrD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,IAAA,2BAAY,EAAC,gBAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC,EAAE,gBAAQ,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,YAAY,GAAG,8BAAS,CAAC,IAAI,CAAC,gBAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACnF,QAAA,QAAQ,GAAG,8BAAS,CAAC,IAAI,CAAC,oBAAY,EAAE,UAAU,CAAC,CAAC;AAEjE,SAAgB,eAAe,CAAC,KAAyB,sCAAc;IACrE,MAAM,aAAa,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC5C,OAAO;QACL,EAAE;QACF,aAAa;KACd,CAAC;AACJ,CAAC;AAED,sCAAsC;AACtC,SAAgB,QAAQ,CAAC,GAAQ,EAAE,MAAW,EAAE,QAAa;IAC3D,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,WAAE,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC;QAC9C,OAAO,QAAQ,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/graph/traverse.d.ts

@@ -1,5 +1,31 @@
-import { AugmentedDependencies, AppGraph, AppModule, Range, Reference, Void } from '../types';
+import { UriString } from '@platformos/platformos-check-common';
+import { AugmentedDependencies, AppGraph, AppModule, FileSourceCode, Range, Reference, ReferenceKind, Void } from '../types';
+/** The dependency surface the reference resolver needs: just a filesystem (for DocumentsLocator). */
+type ResolverDependencies = Pick<AugmentedDependencies, 'fs'>;
 export declare function traverseModule(module: AppModule, appGraph: AppGraph, deps: AugmentedDependencies): Promise<Void>;
+/**
+ * Extract one Liquid file's outgoing dependency references, resolved against the
+ * project at `rootUri`, WITHOUT building the whole app graph.
+ *
+ * This is the per-file primitive for consumers that hold a single (possibly
+ * in-flight, not-yet-on-disk) buffer — e.g. a `validate_code`-style tool that
+ * parses the buffer with {@link toSourceCode} and wants the file's resolved
+ * `render`/`include`/`function`/`background`/`graphql`/asset edges with their
+ * canonical target URIs and {@link ReferenceKind}. 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`; unresolved/missing partials are also surfaced by the linter's
+ *   `MissingPartial` check, so prefer that for diagnostics.
+ * - Only statically resolvable references are returned; dynamic targets
+ *   (`{% render some_var %}`) and inline forms are skipped.
+ * - `sourceCode` is parsed by the caller (from the buffer, not disk); only `fs`
+ *   is touched here, for target resolution.
+ */
+export declare function extractFileReferences(rootUri: UriString, sourceUri: UriString, sourceCode: FileSourceCode, deps: ResolverDependencies): Promise<Reference[]>;
 /**
  * The bind method is the method that links two modules together.
  *
@@ -7,8 +33,10 @@ 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, }?: {
     sourceRange?: Range;
-    targetRange?: Range;
     type?: Reference['type'];
+    kind?: ReferenceKind;
 }): void;
+export {};