@platformos/platformos-graph 0.0.19 → 0.1.0

package/dist/graph/app-index-resolution.spec.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * The graph resolves `{% render %}` / `{% function %}` / `{% graphql %}` / `layout:`
+ * targets through `IDependencies.app`'s index when it is given one.
+ *
+ * Two things are pinned, and they pull in opposite directions:
+ *
+ * 1. COST. With an app, a name is answered from the O(1) index and the build lists no
+ *    directory at all — except for assets, which never use the index by design.
+ * 2. ANSWER. The graph must be IDENTICAL with the app, without it, and with an app whose
+ *    index is only partly populated. The index is a shortcut through `findOrLocate`, not
+ *    a second resolution rule, so every arm here compares whole graphs.
+ *
+ * The no-app arm is the control for the cost claim: it shows these very lookups DO cost
+ * listings when nothing can answer them, so "no directories listed" is caused by the
+ * index rather than by a fixture with nothing to resolve.
+ */
+const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const platformos_common_1 = require("@platformos/platformos-common");
+const platformos_check_node_1 = require("@platformos/platformos-check-node");
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+const utils_1 = require("../utils");
+const test_helpers_1 = require("./test-helpers");
+const moduleEdges = platformos_check_common_1.path.join(test_helpers_1.fixturesRoot, 'module-edges');
+/** The real filesystem, with every directory listing recorded. */
+function recordingFs() {
+    const listedDirectories = [];
+    const fs = {
+        stat: (uri) => platformos_check_node_1.NodeFileSystem.stat(uri),
+        readFile: (uri) => platformos_check_node_1.NodeFileSystem.readFile(uri),
+        readDirectory: (uri) => {
+            listedDirectories.push(uri);
+            return platformos_check_node_1.NodeFileSystem.readDirectory(uri);
+        },
+    };
+    return { fs, listedDirectories };
+}
+/** Every source file under the root, classified — the app the language server holds. */
+async function wholeApp(rootUri, fs) {
+    return platformos_common_1.App.fromPaths(rootUri, await (0, platformos_common_1.walkAppSourceFiles)(fs, rootUri), fs);
+}
+/** An app that knows the entry points and nothing else, so every target is an index MISS. */
+async function pagesOnlyApp(rootUri, fs) {
+    const whole = await wholeApp(rootUri, fs);
+    return platformos_common_1.App.fromPaths(rootUri, whole.pages().map((file) => file.uri), fs);
+}
+/**
+ * Build the fixture's graph from its pages and layouts, recording what it touched.
+ *
+ * `entryPoints` are passed explicitly — a discovering build walks the project first, and
+ * those listings would swamp the ones under test. The scope is the same one
+ * `buildAppGraph` would have discovered for these fixtures.
+ */
+async function buildRecording(rootUri, makeApp) {
+    const { fs, listedDirectories } = recordingFs();
+    const entryPointsApp = await wholeApp(rootUri, fs);
+    const entryPoints = [...entryPointsApp.pages(), ...entryPointsApp.layouts()].map((file) => file.uri);
+    const app = makeApp ? await makeApp(rootUri, fs) : undefined;
+    const sourcesRead = [];
+    const getSourceCode = (0, test_helpers_1.makeGetSourceCode)(fs);
+    // Everything above is fixture setup — the walks it performed are not what is measured.
+    listedDirectories.length = 0;
+    const graph = await (0, index_1.buildAppGraph)(rootUri, {
+        fs,
+        app,
+        getSourceCode: (uri) => {
+            sourcesRead.push(uri);
+            return getSourceCode(uri);
+        },
+    }, entryPoints);
+    return {
+        graph,
+        // SORTED, not in call order: entry points are traversed concurrently, so which
+        // lookup reaches the filesystem first is a scheduling detail. WHICH directories a
+        // build has to list is the claim.
+        listedDirectories: (0, utils_1.unique)(listedDirectories).sort(),
+        sourcesRead: (0, utils_1.unique)(sourcesRead).sort(),
+    };
+}
+const dir = (rootUri, relative) => platformos_check_common_1.path.join(rootUri, ...relative.split('/'));
+const referenceKey = (reference) => [
+    reference.source.uri,
+    reference.source.range?.join(':') ?? '',
+    reference.kind,
+    reference.type,
+].join('|');
+/**
+ * The graph with every node's REVERSE index (`references`) in a stable order.
+ *
+ * A node's dependents are appended as each caller finishes traversing, and entry points
+ * are traversed concurrently — so their order tracks how long each resolution took,
+ * which is precisely what an index changes. `dependencies` are deliberately NOT sorted:
+ * those come from one file's visit in source order, so a difference there would be a
+ * real one and must still fail.
+ */
+function canonical(graph) {
+    const sortReferences = (module) => ({
+        ...module,
+        references: [...module.references].sort((a, b) => referenceKey(a).localeCompare(referenceKey(b))),
+    });
+    return {
+        ...graph,
+        entryPoints: graph.entryPoints.map(sortReferences),
+        modules: Object.fromEntries(Object.entries(graph.modules).map(([uri, module]) => [uri, sortReferences(module)])),
+    };
+}
+(0, vitest_1.describe)('a graph build over a project with an App index', () => {
+    let indexed;
+    let unindexed;
+    let partialIndex;
+    (0, vitest_1.beforeAll)(async () => {
+        indexed = await buildRecording(test_helpers_1.skeleton, wholeApp);
+        unindexed = await buildRecording(test_helpers_1.skeleton);
+        partialIndex = await buildRecording(test_helpers_1.skeleton, pagesOnlyApp);
+    });
+    (0, vitest_1.it)('lists no directory but the asset one, because the index answers every name', () => {
+        // `app/assets` is here on purpose: `findOrLocate` never indexes an asset, since
+        // nothing reads one and the only question is whether it still exists on disk.
+        (0, vitest_1.expect)(indexed.listedDirectories).toEqual([dir(test_helpers_1.skeleton, 'app/assets')]);
+    });
+    (0, vitest_1.it)('lists a directory per candidate when there is no index to answer from', () => {
+        (0, vitest_1.expect)(unindexed.listedDirectories).toEqual([
+            dir(test_helpers_1.skeleton, 'app/assets'),
+            dir(test_helpers_1.skeleton, 'app/views/layouts'),
+            dir(test_helpers_1.skeleton, 'app/views/partials'),
+        ]);
+    });
+    (0, vitest_1.it)('builds the same graph with the index as without it', () => {
+        (0, vitest_1.expect)(canonical(indexed.graph)).toEqual(canonical(unindexed.graph));
+    });
+    (0, vitest_1.it)('falls back to the filesystem for a name the index does not hold', () => {
+        (0, vitest_1.expect)(canonical(partialIndex.graph)).toEqual(canonical(unindexed.graph));
+        // And the miss really was a miss: the partial and layout directories were listed,
+        // so the equality above is not an app that quietly answered everything.
+        (0, vitest_1.expect)(partialIndex.listedDirectories).toEqual(unindexed.listedDirectories);
+    });
+    (0, vitest_1.it)('never asks for an asset source code, only for the files it traverses', () => {
+        // An Asset node is a leaf whose only fact is existence (an `fs.stat`), so `app.js`
+        // and `app.css` are absent here — which is why an App backing a graph needs no
+        // `.js`/image parsers. Every Liquid file in the fixture IS read: the absence above
+        // is about assets, not about a build that read nothing.
+        (0, vitest_1.expect)(indexed.sourcesRead).toEqual([
+            platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'views', 'layouts', 'application.liquid'),
+            platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'views', 'pages', 'index.liquid'),
+            platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'views', 'partials', 'child.liquid'),
+            platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'views', 'partials', 'header.liquid'),
+            platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'views', 'partials', 'parent.liquid'),
+        ].sort());
+    });
+});
+(0, vitest_1.describe)('a module-prefixed name resolved through an App index', () => {
+    let indexed;
+    let unindexed;
+    (0, vitest_1.beforeAll)(async () => {
+        indexed = await buildRecording(moduleEdges, wholeApp);
+        unindexed = await buildRecording(moduleEdges);
+    });
+    (0, vitest_1.it)('costs no listing at all — this fixture has no assets to except', () => {
+        (0, vitest_1.expect)(indexed.listedDirectories).toEqual([]);
+    });
+    (0, vitest_1.it)('resolves `modules/my_module/…` to the same files the candidate walk finds', () => {
+        (0, vitest_1.expect)(canonical(indexed.graph)).toEqual(canonical(unindexed.graph));
+    });
+});
+//# sourceMappingURL=app-index-resolution.spec.js.map

package/dist/graph/app-index-resolution.spec.js.map

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

package/dist/graph/asset-resolution.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/graph/asset-resolution.spec.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const platformos_common_1 = require("@platformos/platformos-common");
+const vitest_1 = require("vitest");
+const vscode_uri_1 = require("vscode-uri");
+const module_1 = require("./module");
+const ROOT = 'file:///project';
+const emptyGraph = () => ({ rootUri: ROOT, entryPoints: [], modules: {} });
+/**
+ * Assets follow exactly the same placement rules as every other platformOS file type:
+ * `app/assets/` or `modules/<name>/{public,private}/assets/`. Resolution goes through
+ * platformos-common, so the graph cannot disagree with `DocumentsLocator` about where
+ * `{{ 'app.js' | asset_url }}` points.
+ */
+(0, vitest_1.describe)('asset reference resolution', () => {
+    (0, vitest_1.it)("resolves 'app.js' to app/assets/app.js", () => {
+        (0, vitest_1.expect)((0, module_1.getAssetModule)(emptyGraph(), 'app.js').uri).toBe(`${ROOT}/app/assets/app.js`);
+    });
+    (0, vitest_1.it)('keeps a subdirectory instead of collapsing to a basename', () => {
+        (0, vitest_1.expect)((0, module_1.getAssetModule)(emptyGraph(), 'styles/theme.css').uri).toBe(`${ROOT}/app/assets/styles/theme.css`);
+    });
+    (0, vitest_1.it)('routes a modules/<name>/ reference into that module, not into app/assets', () => {
+        (0, vitest_1.expect)((0, module_1.getAssetModule)(emptyGraph(), 'modules/admin/app.css').uri).toBe(`${ROOT}/app/modules/admin/public/assets/app.css`);
+    });
+    (0, vitest_1.it)('ignores a reference with an extension no asset uses', () => {
+        (0, vitest_1.expect)((0, module_1.getAssetModule)(emptyGraph(), 'notes.txt')).toBe(undefined);
+    });
+    (0, vitest_1.it)('agrees with DocumentsLocator for an asset that exists', async () => {
+        const assetUri = `${ROOT}/app/assets/app.js`;
+        const locator = new platformos_common_1.DocumentsLocator({
+            stat: async (uri) => {
+                if (uri !== assetUri)
+                    throw new Error(`ENOENT: ${uri}`);
+                return { type: platformos_common_1.FileType.File, size: 0 };
+            },
+            readFile: async () => '',
+            // Resolution reads the candidate directory's listing, not a stat per spelling.
+            readDirectory: async (uri) => {
+                if (uri !== `${ROOT}/app/assets`)
+                    throw new Error(`ENOENT: ${uri}`);
+                return [[assetUri, platformos_common_1.FileType.File]];
+            },
+        });
+        (0, vitest_1.expect)((0, module_1.getAssetModule)(emptyGraph(), 'app.js').uri).toBe(await locator.locate(vscode_uri_1.URI.parse(ROOT), 'asset', 'app.js'));
+    });
+    (0, vitest_1.it)('classifies an asset URI as an asset module without reconstructing its path', () => {
+        const nested = `${ROOT}/app/assets/styles/theme.css`;
+        const moduleAsset = `${ROOT}/modules/admin/private/assets/app.css`;
+        (0, vitest_1.expect)((0, module_1.getModule)(emptyGraph(), nested)).toMatchObject({
+            type: "Asset" /* ModuleType.Asset */,
+            uri: nested,
+        });
+        // A module ORIGINAL keeps its own path — resolving by name would have moved it to
+        // the app-overwrite slot.
+        (0, vitest_1.expect)((0, module_1.getModule)(emptyGraph(), moduleAsset)).toMatchObject({
+            type: "Asset" /* ModuleType.Asset */,
+            uri: moduleAsset,
+        });
+    });
+    (0, vitest_1.it)('does not treat a root-level assets/ path as part of the app', () => {
+        (0, vitest_1.expect)((0, module_1.getModule)(emptyGraph(), `${ROOT}/assets/app.js`)).toBe(undefined);
+    });
+});
+//# sourceMappingURL=asset-resolution.spec.js.map

package/dist/graph/asset-resolution.spec.js.map

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

package/dist/graph/augment.js

@@ -7,13 +7,15 @@ const utils_1 = require("../utils");
 function augmentDependencies(rootUri, ideps) {
     return {
         fs: ideps.fs,
+        // Passed through as given. There is nothing to default: an absent app means the
+        // caller has none, and `DocumentsLocator` already owns what to do then.
+        app: ideps.app,
         // parse at most once
         getSourceCode: (0, platformos_check_common_1.memoize)(ideps.getSourceCode ??
             async function defaultGetSourceCode(uri) {
                 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,kDAkBC;AAvBD,iFAAoE;AACpE,kDAA+C;AAE/C,oCAAoC;AAEpC,SAAgB,mBAAmB,CAAC,OAAe,EAAE,KAAoB;IACvE,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QAEZ,gFAAgF;QAChF,wEAAwE;QACxE,GAAG,EAAE,KAAK,CAAC,GAAG;QAEd,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/build.d.ts

@@ -1,3 +1,16 @@
 import { UriString } from '@platformos/platformos-check-common';
-import { IDependencies, AppGraph } from '../types';
-export declare function buildAppGraph(rootUri: UriString, ideps: IDependencies, entryPoints?: UriString[]): Promise<AppGraph>;
+import { IDependencies, AppGraph, GraphBuildOptions } from '../types';
+/**
+ * Build the project dependency graph.
+ *
+ * - `entryPoints` omitted → FULL build: a single directory sweep discovers pages
+ *   + layouts (the render entry points) and standalone custom-model-type/schema
+ *   nodes, and every reachable module is materialized.
+ * - `entryPoints` provided → SCOPED build (e.g. an LSP rebuild for changed
+ *   files): built verbatim from those roots. Schema nodes are NOT auto-discovered
+ *   in this mode — schema discovery is a full-build concern.
+ *
+ * `options.includeStructural` (default off) additionally populates each
+ * `LiquidModule.structural`; see {@link GraphBuildOptions}.
+ */
+export declare function buildAppGraph(rootUri: UriString, ideps: IDependencies, entryPoints?: UriString[], options?: GraphBuildOptions): Promise<AppGraph>;

package/dist/graph/build.js

@@ -1,21 +1,60 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildAppGraph = buildAppGraph;
-const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const platformos_common_1 = require("@platformos/platformos-common");
 const augment_1 = require("./augment");
 const module_1 = require("./module");
 const traverse_1 = require("./traverse");
-async function buildAppGraph(rootUri, ideps, entryPoints) {
+/**
+ * Build the project dependency graph.
+ *
+ * - `entryPoints` omitted → FULL build: a single directory sweep discovers pages
+ *   + layouts (the render entry points) and standalone custom-model-type/schema
+ *   nodes, and every reachable module is materialized.
+ * - `entryPoints` provided → SCOPED build (e.g. an LSP rebuild for changed
+ *   files): built verbatim from those roots. Schema nodes are NOT auto-discovered
+ *   in this mode — schema discovery is a full-build concern.
+ *
+ * `options.includeStructural` (default off) additionally populates each
+ * `LiquidModule.structural`; see {@link GraphBuildOptions}.
+ */
+async function buildAppGraph(rootUri, ideps, entryPoints, options = {}) {
     const deps = (0, augment_1.augmentDependencies)(rootUri, ideps);
-    entryPoints =
-        entryPoints ??
-            (await (0, platformos_check_common_1.recursiveReadDirectory)(deps.fs, rootUri, ([uri]) => {
-                if (!uri.endsWith('.liquid'))
-                    return false;
-                // Layouts are entry points — they wrap all page content.
-                // Pages are also entry points — they are directly requested.
-                return (0, platformos_check_common_1.isLayout)(uri) || (0, platformos_check_common_1.isPage)(uri);
-            }));
+    // Table (schema / custom-model-type) files are platform nodes but are NOT
+    // render-reachable — nothing renders them — so they never appear via edge traversal. On
+    // a full build they are discovered as standalone leaf nodes, never entry points, so
+    // reachability/orphan semantics for the render graph are unaffected.
+    let schemaUris = [];
+    // An explicit entryPoints scope is built verbatim (e.g. a scoped LSP rebuild); the
+    // default full build (`entryPoints === undefined`) also discovers standalone Table
+    // nodes. Branching on the parameter directly lets the compiler narrow it below.
+    if (entryPoints === undefined) {
+        // ONE sweep yields both populations, partitioned by SourceCodeType below, so the
+        // tree is walked once. `walkAppSourceFiles` is anchored on APP_SOURCE_SUBTREES: the
+        // walk it replaces started at the root and skipped directories by NAME, which both
+        // dropped `app/views/pages/vendor/**` (a live site section — 137 files on one real
+        // project) and admitted `tmp/app/views/partials/x.liquid`.
+        const discovered = await (0, platformos_common_1.walkAppSourceFiles)(deps.fs, rootUri, ([uri]) => {
+            // Root-ANCHORED classification. The unanchored `getFileType(uri)` this used to call
+            // matched a known directory anywhere in the path, so
+            // `seed/post_import/app/migrations/x.liquid` classified as a Migration while being
+            // correctly absent from the lint's app.
+            const fileType = (0, platformos_common_1.getFileType)(uri, rootUri);
+            // A GRAPH-domain restriction, not a second answer to "what is a source file":
+            // Liquid is the only source that can reference another file, so a non-Liquid entry
+            // point would have no edges to traverse. Which extensions ARE Liquid still comes
+            // from platformos-common, never spelled here — which is also why the `.yml`/`.yaml`
+            // tests that used to partition this sweep are gone: `.yaml` is not a platformOS
+            // extension at all, so spelling it here promised coverage the platform never had.
+            if ((0, platformos_common_1.sourceCodeTypeOf)(uri) === platformos_common_1.SourceCodeType.LiquidHtml) {
+                // Layouts wrap all page content; pages are directly requested — both are entry points.
+                return fileType === platformos_common_1.PlatformOSFileType.Layout || fileType === platformos_common_1.PlatformOSFileType.Page;
+            }
+            return fileType === platformos_common_1.PlatformOSFileType.Table;
+        });
+        entryPoints = discovered.filter((uri) => (0, platformos_common_1.sourceCodeTypeOf)(uri) === platformos_common_1.SourceCodeType.LiquidHtml);
+        schemaUris = discovered.filter((uri) => (0, platformos_common_1.sourceCodeTypeOf)(uri) !== platformos_common_1.SourceCodeType.LiquidHtml);
+    }
     const graph = {
         entryPoints: [],
         modules: {},
@@ -24,7 +63,10 @@ async function buildAppGraph(rootUri, ideps, entryPoints) {
     graph.entryPoints = entryPoints
         .map((uri) => (0, module_1.getModule)(graph, uri))
         .filter((x) => x !== undefined);
-    await Promise.all(graph.entryPoints.map((entry) => (0, traverse_1.traverseModule)(entry, graph, deps)));
+    await Promise.all(graph.entryPoints.map((entry) => (0, traverse_1.traverseModule)(entry, graph, deps, options)));
+    if (schemaUris.length > 0) {
+        await Promise.all(schemaUris.map((uri) => (0, traverse_1.traverseModule)((0, module_1.getSchemaModule)(graph, uri), graph, deps, options)));
+    }
     return graph;
 }
 //# sourceMappingURL=build.js.map

package/dist/graph/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/graph/build.ts"],"names":[],"mappings":";;AAYA,sCA6BC;AAzCD,iFAM6C;AAE7C,uCAAgD;AAChD,qCAAqC;AACrC,yCAA4C;AAErC,KAAK,UAAU,aAAa,CACjC,OAAkB,EAClB,KAAoB,EACpB,WAAyB;IAEzB,MAAM,IAAI,GAAG,IAAA,6BAAmB,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEjD,WAAW;QACT,WAAW;YACX,CAAC,MAAM,IAAA,gDAAY,EAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE;gBAC9C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAC3C,yDAAyD;gBACzD,6DAA6D;gBAC7D,OAAO,IAAA,kCAAQ,EAAC,GAAG,CAAC,IAAI,IAAA,gCAAM,EAAC,GAAG,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC,CAAC;IAEN,MAAM,KAAK,GAAa;QACtB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,OAAO;KACR,CAAC;IAEF,KAAK,CAAC,WAAW,GAAG,WAAW;SAC5B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,kBAAS,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC;SACnC,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAElD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,yBAAc,EAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAExF,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/graph/build.ts"],"names":[],"mappings":";;AA0BA,sCAkEC;AA3FD,qEAMuC;AAEvC,uCAAgD;AAChD,qCAAsD;AACtD,yCAA4C;AAE5C;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,aAAa,CACjC,OAAkB,EAClB,KAAoB,EACpB,WAAyB,EACzB,UAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,IAAA,6BAAmB,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEjD,0EAA0E;IAC1E,wFAAwF;IACxF,oFAAoF;IACpF,qEAAqE;IACrE,IAAI,UAAU,GAAgB,EAAE,CAAC;IAEjC,mFAAmF;IACnF,mFAAmF;IACnF,gFAAgF;IAChF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,iFAAiF;QACjF,oFAAoF;QACpF,mFAAmF;QACnF,mFAAmF;QACnF,2DAA2D;QAC3D,MAAM,UAAU,GAAG,MAAM,IAAA,sCAAkB,EAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE;YACtE,oFAAoF;YACpF,qDAAqD;YACrD,mFAAmF;YACnF,wCAAwC;YACxC,MAAM,QAAQ,GAAG,IAAA,+BAAW,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAE3C,8EAA8E;YAC9E,mFAAmF;YACnF,iFAAiF;YACjF,oFAAoF;YACpF,gFAAgF;YAChF,kFAAkF;YAClF,IAAI,IAAA,oCAAgB,EAAC,GAAG,CAAC,KAAK,kCAAc,CAAC,UAAU,EAAE,CAAC;gBACxD,uFAAuF;gBACvF,OAAO,QAAQ,KAAK,sCAAkB,CAAC,MAAM,IAAI,QAAQ,KAAK,sCAAkB,CAAC,IAAI,CAAC;YACxF,CAAC;YACD,OAAO,QAAQ,KAAK,sCAAkB,CAAC,KAAK,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,oCAAgB,EAAC,GAAG,CAAC,KAAK,kCAAc,CAAC,UAAU,CAAC,CAAC;QAC9F,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,oCAAgB,EAAC,GAAG,CAAC,KAAK,kCAAc,CAAC,UAAU,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,OAAO;KACR,CAAC;IAEF,KAAK,CAAC,WAAW,GAAG,WAAW;SAC5B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,kBAAS,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC;SACnC,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAElD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,yBAAc,EAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEjG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,GAAG,CACf,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,yBAAc,EAAC,IAAA,wBAAe,EAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAC3F,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/graph/build.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/graph/build.spec.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const test_1 = require("@platformos/platformos-check-common/src/test");
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+const toSourceCode_1 = require("../toSourceCode");
+const test_helpers_1 = require("./test-helpers");
+(0, vitest_1.describe)('Module: index', () => {
+    const rootUri = test_helpers_1.skeleton;
+    const p = (part) => platformos_check_common_1.path.join(rootUri, ...part.split('/'));
+    const loc = (part) => vitest_1.expect.objectContaining({ uri: p(part) });
+    let dependencies;
+    (0, vitest_1.beforeAll)(async () => {
+        dependencies = (0, test_helpers_1.getDependencies)();
+    }, 15000);
+    (0, vitest_1.describe)('Unit: buildAppGraph', { timeout: 10000 }, () => {
+        (0, vitest_1.it)('builds a graph of the app', { timeout: 10000 }, async () => {
+            const graph = await (0, index_1.buildAppGraph)(rootUri, dependencies);
+            (0, vitest_1.expect)(graph).toBeDefined();
+        });
+        (0, vitest_1.describe)('with a valid app graph', () => {
+            let graph;
+            (0, vitest_1.beforeEach)(async () => {
+                graph = await (0, index_1.buildAppGraph)(rootUri, dependencies);
+            });
+            (0, vitest_1.it)('has a root URI', () => {
+                (0, vitest_1.expect)(graph.rootUri).toBeDefined();
+                (0, vitest_1.expect)(graph.rootUri).toBe(rootUri);
+            });
+            (0, vitest_1.it)('infers entry points from layouts and pages', () => {
+                (0, vitest_1.expect)(graph.entryPoints).toHaveLength(2);
+                (0, vitest_1.expect)(graph.entryPoints.map((x) => x.uri)).toEqual(vitest_1.expect.arrayContaining([
+                    p('app/views/layouts/application.liquid'),
+                    p('app/views/pages/index.liquid'),
+                ]));
+            });
+            (0, vitest_1.it)("finds app/views/layouts/application.liquid's dependencies", () => {
+                const layout = graph.modules[p('app/views/layouts/application.liquid')];
+                (0, vitest_1.assert)(layout);
+                (0, vitest_1.assert)(layout.type === "Liquid" /* ModuleType.Liquid */);
+                (0, vitest_1.assert)(layout.kind === "layout" /* LiquidModuleKind.Layout */);
+                const deps = layout.dependencies;
+                (0, vitest_1.expect)(deps.map((x) => x.target.uri)).toEqual(vitest_1.expect.arrayContaining([
+                    p('app/assets/app.js'),
+                    p('app/assets/app.css'),
+                    p('app/views/partials/header.liquid'),
+                ]));
+            });
+            (0, vitest_1.it)("finds app/views/partials/parent's dependencies and references", async () => {
+                const parentPartial = graph.modules[p('app/views/partials/parent.liquid')];
+                (0, vitest_1.assert)(parentPartial);
+                (0, vitest_1.assert)(parentPartial.type === "Liquid" /* ModuleType.Liquid */);
+                (0, vitest_1.assert)(parentPartial.kind === "partial" /* LiquidModuleKind.Partial */);
+                // outgoing links — parent renders exactly one partial (child)
+                const deps = parentPartial.dependencies;
+                (0, vitest_1.assert)(deps.map((x) => x.source.uri).every((x) => x === parentPartial.uri));
+                (0, vitest_1.expect)(deps.map((x) => x.target.uri)).toEqual([p('app/views/partials/child.liquid')]);
+                // {% render 'child' %} dependency
+                const parentSource = await dependencies.getSourceCode(p('app/views/partials/parent.liquid'));
+                (0, vitest_1.assert)(parentSource);
+                (0, vitest_1.assert)(parentSource.type === platformos_check_common_1.SourceCodeType.LiquidHtml);
+                (0, vitest_1.expect)(parentPartial.dependencies.map((x) => x.source)).toContainEqual(vitest_1.expect.objectContaining({
+                    uri: p('app/views/partials/parent.liquid'),
+                    range: [
+                        parentSource.source.indexOf('{% render "child"'),
+                        parentSource.source.indexOf('{% render "child"') +
+                            '{% render "child", children: children %}'.length,
+                    ],
+                }));
+            });
+            (0, vitest_1.it)("finds app/views/partials/child's references", () => {
+                const childPartial = graph.modules[p('app/views/partials/child.liquid')];
+                (0, vitest_1.assert)(childPartial);
+                (0, vitest_1.assert)(childPartial.type === "Liquid" /* ModuleType.Liquid */);
+                (0, vitest_1.assert)(childPartial.kind === "partial" /* LiquidModuleKind.Partial */);
+                const refs = childPartial.references;
+                (0, vitest_1.expect)(refs.map((x) => x.source.uri)).toEqual(vitest_1.expect.arrayContaining([
+                    p('app/views/partials/parent.liquid'),
+                    p('app/views/partials/header.liquid'),
+                ]));
+            });
+            (0, vitest_1.it)('tags every layout edge with its kind (asset, asset, render)', () => {
+                const layout = graph.modules[p('app/views/layouts/application.liquid')];
+                (0, vitest_1.assert)(layout);
+                // The complete, ordered edge set — not a membership probe — so an extra,
+                // missing, or mis-kinded edge fails. (Source ranges are pinned by the
+                // dedicated render-dependency test above.)
+                (0, vitest_1.expect)(layout.dependencies.map((d) => ({ target: d.target.uri, type: d.type, kind: d.kind }))).toEqual([
+                    { target: p('app/assets/app.js'), type: 'direct', kind: 'asset' },
+                    { target: p('app/assets/app.css'), type: 'direct', kind: 'asset' },
+                    { target: p('app/views/partials/header.liquid'), type: 'direct', kind: 'render' },
+                ]);
+            });
+        });
+        /**
+         * Entry points come from an ANCHORED walk of the app subtrees, so what a
+         * directory is CALLED never decides whether the graph can see it. The walk this
+         * replaced skipped any directory ending in `vendor`, `build`, `tmp` or `dist`,
+         * which lost every page under `app/views/pages/vendor/**` — a real section of a
+         * real site — while still descending into `tmp/app/views/pages/`, which the
+         * platform does not deploy at all.
+         */
+        (0, vitest_1.describe)('entry points on a project with app directories named like build output', () => {
+            const projectRoot = 'file:///project';
+            const u = (part) => `${projectRoot}/${part}`;
+            let graph;
+            (0, vitest_1.beforeEach)(async () => {
+                const fs = new test_1.MockFileSystem({
+                    'app/views/pages/vendor/index.liquid': `{% render 'vendor/card' %}`,
+                    'app/views/pages/build/status.liquid': `ok`,
+                    'app/views/partials/vendor/card.liquid': `a card`,
+                    'tmp/app/views/pages/scratch.liquid': `not deployed`,
+                    'node_modules/some-pkg/app/views/pages/decoy.liquid': `not ours`,
+                    'dist/app/views/pages/bundled.liquid': `build output`,
+                }, projectRoot);
+                graph = await (0, index_1.buildAppGraph)(projectRoot, {
+                    fs,
+                    getSourceCode: async (uri) => (0, toSourceCode_1.toSourceCode)(uri, await fs.readFile(uri)),
+                });
+            });
+            (0, vitest_1.it)('finds the pages under vendor/ and build/, and nothing outside the app subtrees', () => {
+                (0, vitest_1.expect)(graph.entryPoints.map((entry) => entry.uri).sort()).toEqual([
+                    u('app/views/pages/build/status.liquid'),
+                    u('app/views/pages/vendor/index.liquid'),
+                ]);
+            });
+            (0, vitest_1.it)('traverses them, so a partial under vendor/ is a graph node with a reference', () => {
+                const card = graph.modules[u('app/views/partials/vendor/card.liquid')];
+                (0, vitest_1.assert)(card);
+                (0, vitest_1.expect)(card.references.map((reference) => reference.source.uri)).toEqual([
+                    u('app/views/pages/vendor/index.liquid'),
+                ]);
+            });
+        });
+    });
+});
+//# sourceMappingURL=build.spec.js.map

package/dist/graph/build.spec.js.map

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

package/dist/graph/edge-sources.d.ts

@@ -0,0 +1,28 @@
+import { type UriString } from '@platformos/platformos-check-common';
+import { type AbstractFileSystem } from '@platformos/platformos-common';
+/**
+ * The canonical definition of an EDGE SOURCE: a liquid file whose own content can declare
+ * outgoing edges (a Page, Layout, or Partial). Only these files' add/remove/modify can change
+ * any file's set of dependents — `.graphql`/`.yml`/asset files are leaves.
+ *
+ * "Which files" derives entirely from the file-type classifier, so this predicate never
+ * re-encodes the classification. It is ANCHORED on `rootUri`, because a file's type IS its
+ * position relative to the project root: unanchored, `tmp/app/lib/x.liquid` is a Partial.
+ */
+export declare function isEdgeSource(uri: UriString, rootUri: UriString): boolean;
+/**
+ * Enumerate every edge-source liquid file under a project root — the single canonical primitive
+ * for "which files are the graph's edge sources". Consumers never re-derive the walk or the
+ * {@link isEdgeSource} predicate.
+ *
+ * The walk is `walkAppSourceFiles`, platformos-common's anchored expansion of
+ * `APP_SOURCE_SUBTREES`, so this file names no directory at all and a bundled `react-app/` is
+ * never walked. `edge-sources.spec` pins the scoped result against a whole-tree walk filtered
+ * by {@link isEdgeSource}.
+ *
+ * NOT shared with `buildAppGraph`'s full-build discovery: the two gather DIFFERENT domains —
+ * that one takes render entry points (pages + layouts, partials being edge-reached) plus
+ * standalone schema nodes, this one takes page + layout + partial. They share the walk
+ * primitive and the classifier, which are the parts that must not drift.
+ */
+export declare function enumerateEdgeSources(fs: AbstractFileSystem, rootUri: UriString): Promise<UriString[]>;

package/dist/graph/edge-sources.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEdgeSource = isEdgeSource;
+exports.enumerateEdgeSources = enumerateEdgeSources;
+const platformos_common_1 = require("@platformos/platformos-common");
+/**
+ * The canonical definition of an EDGE SOURCE: a liquid file whose own content can declare
+ * outgoing edges (a Page, Layout, or Partial). Only these files' add/remove/modify can change
+ * any file's set of dependents — `.graphql`/`.yml`/asset files are leaves.
+ *
+ * "Which files" derives entirely from the file-type classifier, so this predicate never
+ * re-encodes the classification. It is ANCHORED on `rootUri`, because a file's type IS its
+ * position relative to the project root: unanchored, `tmp/app/lib/x.liquid` is a Partial.
+ */
+function isEdgeSource(uri, rootUri) {
+    switch ((0, platformos_common_1.getFileType)(uri, rootUri)) {
+        case platformos_common_1.PlatformOSFileType.Layout:
+        case platformos_common_1.PlatformOSFileType.Page:
+        case platformos_common_1.PlatformOSFileType.Partial:
+            return true;
+        default:
+            return false;
+    }
+}
+/**
+ * Enumerate every edge-source liquid file under a project root — the single canonical primitive
+ * for "which files are the graph's edge sources". Consumers never re-derive the walk or the
+ * {@link isEdgeSource} predicate.
+ *
+ * The walk is `walkAppSourceFiles`, platformos-common's anchored expansion of
+ * `APP_SOURCE_SUBTREES`, so this file names no directory at all and a bundled `react-app/` is
+ * never walked. `edge-sources.spec` pins the scoped result against a whole-tree walk filtered
+ * by {@link isEdgeSource}.
+ *
+ * NOT shared with `buildAppGraph`'s full-build discovery: the two gather DIFFERENT domains —
+ * that one takes render entry points (pages + layouts, partials being edge-reached) plus
+ * standalone schema nodes, this one takes page + layout + partial. They share the walk
+ * primitive and the classifier, which are the parts that must not drift.
+ */
+async function enumerateEdgeSources(fs, rootUri) {
+    return (0, platformos_common_1.walkAppSourceFiles)(fs, rootUri, ([uri]) => isEdgeSource(uri, rootUri));
+}
+//# sourceMappingURL=edge-sources.js.map