@platformos/platformos-graph 0.0.20 → 0.1.0

package/dist/cli.js

@@ -10,7 +10,6 @@ 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");
 /**
@@ -30,7 +29,7 @@ exports.nodeFileSystem = {
     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),
+            platformos_check_common_1.path.childUri(uri, entry.name),
             entry.isDirectory() ? platformos_common_1.FileType.Directory : platformos_common_1.FileType.File,
         ]);
     },
@@ -50,8 +49,9 @@ exports.nodeFileSystem = {
 /**
  * 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).
+ * using the same `findRoot` heuristic as the language server (an `app/` — or its
+ * legacy `marketplace_builder/` sibling — `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`
@@ -61,14 +61,19 @@ exports.nodeFileSystem = {
  * `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) {
+async function resolveGraphRoot(root, fs) {
+    // Only the cwd-relative step stays here: `process.cwd()` is node-specific, and the resolution
+    // itself lives in platformos-check-common so the linter shares it rather than owning a copy.
     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));
+    const { given, root: rootUri } = await (0, platformos_check_common_1.resolveProjectRoot)(absolute, (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.`);
+        // The marker list is derived rather than restated, so it cannot drift from what findRoot
+        // actually looks for. The wording is unchanged from when it was hand-written — this is a
+        // refactor, and the existing message assertion is what proves it stayed one.
+        const markers = platformos_check_common_1.PROJECT_ROOT_MARKERS.join(', ').replace(/, ([^,]*)$/, ', or $1');
+        throw new Error(`Not a platformOS project: ${given}\n` +
+            `No ${markers} found ` +
+            `at or above this path. Pass the path to a platformOS app directory.`);
     }
     return rootUri;
 }
@@ -80,7 +85,7 @@ async function resolveProjectRoot(root, fs) {
  */
 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 (0, platformos_common_1.uriFromPath)(file);
     }
     return platformos_check_common_1.path.join(rootUri, ...file.split(/[\\/]+/).filter(Boolean));
 }
@@ -92,7 +97,7 @@ function resolveFileUri(rootUri, file) {
  * `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 });
+    const graph = await (0, build_1.buildAppGraph)(await resolveGraphRoot(root, fs), { fs });
     return (0, serialize_1.serializeAppGraph)(graph);
 }
 /**
@@ -108,7 +113,7 @@ async function buildSerializedGraph(root, fs = exports.nodeFileSystem) {
  * `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 rootUri = await resolveGraphRoot(root, fs);
     const fileUri = resolveFileUri(rootUri, file);
     const graph = await (0, build_1.buildAppGraph)(rootUri, { fs });
     const module = graph.modules[fileUri];

package/dist/cli.js.map

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

package/dist/cli.spec.d.ts

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

package/dist/cli.spec.js

@@ -0,0 +1,235 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const platformos_common_1 = require("@platformos/platformos-common");
+const vitest_1 = require("vitest");
+const cli_1 = require("./cli");
+const test_helpers_1 = require("./graph/test-helpers");
+const skeletonPath = platformos_check_common_1.path.fsPath(test_helpers_1.skeleton);
+const p = (rel) => platformos_check_common_1.path.join(test_helpers_1.skeleton, ...rel.split('/'));
+const fsPathOf = (rel) => node_path_1.default.join(skeletonPath, ...rel.split('/'));
+(0, vitest_1.describe)('platformos-graph CLI: buildSerializedGraph', () => {
+    (0, vitest_1.it)('serializes the full node and edge set for a project path', async () => {
+        const graph = await (0, cli_1.buildSerializedGraph)(skeletonPath);
+        // Root is the project path re-expressed as a file URI.
+        (0, vitest_1.expect)(graph.rootUri).toBe((0, platformos_common_1.uriFromPath)(skeletonPath));
+        // Whole node set, sorted by URI so the assertion is order-independent.
+        // (`app/assets/*` sorts ahead of `app/views/*`.)
+        (0, vitest_1.expect)([...graph.nodes].sort((a, b) => a.uri.localeCompare(b.uri))).toEqual([
+            {
+                uri: p('app/assets/app.css'),
+                type: "Asset" /* ModuleType.Asset */,
+                kind: 'unused',
+                exists: true,
+            },
+            {
+                uri: p('app/assets/app.js'),
+                type: "Asset" /* ModuleType.Asset */,
+                kind: 'unused',
+                exists: true,
+            },
+            {
+                uri: p('app/views/layouts/application.liquid'),
+                type: "Liquid" /* ModuleType.Liquid */,
+                kind: "layout" /* LiquidModuleKind.Layout */,
+                exists: true,
+            },
+            {
+                uri: p('app/views/pages/index.liquid'),
+                type: "Liquid" /* ModuleType.Liquid */,
+                kind: "page" /* LiquidModuleKind.Page */,
+                exists: true,
+            },
+            {
+                uri: p('app/views/partials/child.liquid'),
+                type: "Liquid" /* ModuleType.Liquid */,
+                kind: "partial" /* LiquidModuleKind.Partial */,
+                exists: true,
+            },
+            {
+                uri: p('app/views/partials/header.liquid'),
+                type: "Liquid" /* ModuleType.Liquid */,
+                kind: "partial" /* LiquidModuleKind.Partial */,
+                exists: true,
+            },
+            {
+                uri: p('app/views/partials/parent.liquid'),
+                type: "Liquid" /* ModuleType.Liquid */,
+                kind: "partial" /* LiquidModuleKind.Partial */,
+                exists: true,
+            },
+        ]);
+        // Whole edge set, reduced to (source, target, type, kind) and sorted, so an
+        // extra, missing, or mis-kinded edge fails the assertion.
+        const edges = graph.edges
+            .map((edge) => ({
+            source: edge.source.uri,
+            target: edge.target.uri,
+            type: edge.type,
+            kind: edge.kind,
+        }))
+            .sort((a, b) => a.source.localeCompare(b.source) || a.target.localeCompare(b.target));
+        (0, vitest_1.expect)(edges).toEqual([
+            {
+                source: p('app/views/layouts/application.liquid'),
+                target: p('app/assets/app.css'),
+                type: 'direct',
+                kind: 'asset',
+            },
+            {
+                source: p('app/views/layouts/application.liquid'),
+                target: p('app/assets/app.js'),
+                type: 'direct',
+                kind: 'asset',
+            },
+            {
+                source: p('app/views/layouts/application.liquid'),
+                target: p('app/views/partials/header.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+            {
+                source: p('app/views/pages/index.liquid'),
+                target: p('app/views/layouts/application.liquid'),
+                type: 'direct',
+                kind: 'layout',
+            },
+            {
+                source: p('app/views/pages/index.liquid'),
+                target: p('app/views/partials/parent.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+            {
+                source: p('app/views/partials/header.liquid'),
+                target: p('app/views/partials/child.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+            {
+                source: p('app/views/partials/parent.liquid'),
+                target: p('app/views/partials/child.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+        ]);
+    });
+});
+(0, vitest_1.describe)('platformos-graph CLI: nodeFileSystem', () => {
+    (0, vitest_1.it)('reads a file by URI', async () => {
+        const uri = platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'assets', 'app.js');
+        (0, vitest_1.expect)(await cli_1.nodeFileSystem.readFile(uri)).toBe('// Skeleton app bundle (asset reference target).\n');
+    });
+    (0, vitest_1.it)('stats a directory and a file', async () => {
+        (0, vitest_1.expect)(await cli_1.nodeFileSystem.stat(platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'assets'))).toEqual({
+            type: platformos_common_1.FileType.Directory,
+            size: vitest_1.expect.any(Number),
+        });
+        (0, vitest_1.expect)(await cli_1.nodeFileSystem.stat(platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'assets', 'app.css'))).toEqual({
+            type: platformos_common_1.FileType.File,
+            size: vitest_1.expect.any(Number),
+        });
+    });
+    (0, vitest_1.it)('lists a directory as [childUri, FileType] tuples', async () => {
+        const entries = await cli_1.nodeFileSystem.readDirectory(platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'assets'));
+        (0, vitest_1.expect)([...entries].sort((a, b) => a[0].localeCompare(b[0]))).toEqual([
+            [platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'assets', 'app.css'), platformos_common_1.FileType.File],
+            [platformos_check_common_1.path.join(test_helpers_1.skeleton, 'app', 'assets', 'app.js'), platformos_common_1.FileType.File],
+        ]);
+    });
+});
+(0, vitest_1.describe)('platformos-graph CLI: buildSerializedFileDependencies', () => {
+    const edge = (ref) => ({
+        source: ref.source.uri,
+        target: ref.target.uri,
+        type: ref.type,
+        kind: ref.kind,
+    });
+    (0, vitest_1.it)('returns the outgoing and incoming edges of a single file', async () => {
+        const result = await (0, cli_1.buildSerializedFileDependencies)(skeletonPath, fsPathOf('app/views/partials/parent.liquid'));
+        (0, vitest_1.expect)(result.uri).toBe(p('app/views/partials/parent.liquid'));
+        (0, vitest_1.expect)(result.dependencies.map(edge)).toEqual([
+            {
+                source: p('app/views/partials/parent.liquid'),
+                target: p('app/views/partials/child.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+        ]);
+        (0, vitest_1.expect)(result.references.map(edge)).toEqual([
+            {
+                source: p('app/views/pages/index.liquid'),
+                target: p('app/views/partials/parent.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+        ]);
+    });
+    (0, vitest_1.it)('returns no dependencies for a leaf partial and every incoming reference', async () => {
+        const result = await (0, cli_1.buildSerializedFileDependencies)(skeletonPath, fsPathOf('app/views/partials/child.liquid'));
+        (0, vitest_1.expect)(result.uri).toBe(p('app/views/partials/child.liquid'));
+        (0, vitest_1.expect)(result.dependencies).toEqual([]);
+        (0, vitest_1.expect)(result.references.map(edge).sort((a, b) => a.source.localeCompare(b.source))).toEqual([
+            {
+                source: p('app/views/partials/header.liquid'),
+                target: p('app/views/partials/child.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+            {
+                source: p('app/views/partials/parent.liquid'),
+                target: p('app/views/partials/child.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+        ]);
+    });
+    (0, vitest_1.it)('resolves a relative file argument against the project root, not the cwd', async () => {
+        const result = await (0, cli_1.buildSerializedFileDependencies)(skeletonPath, 'app/views/partials/parent.liquid');
+        (0, vitest_1.expect)(result.uri).toBe(p('app/views/partials/parent.liquid'));
+        (0, vitest_1.expect)(result.dependencies.map(edge)).toEqual([
+            {
+                source: p('app/views/partials/parent.liquid'),
+                target: p('app/views/partials/child.liquid'),
+                type: 'direct',
+                kind: 'render',
+            },
+        ]);
+    });
+    (0, vitest_1.it)('throws for a file that is not part of the app graph', async () => {
+        const missing = fsPathOf('app/views/partials/nonexistent.liquid');
+        const missingUri = (0, platformos_common_1.uriFromPath)(missing);
+        const rootUri = (0, platformos_common_1.uriFromPath)(skeletonPath);
+        const error = await (0, cli_1.buildSerializedFileDependencies)(skeletonPath, missing).catch((e) => e);
+        (0, vitest_1.expect)(error).toBeInstanceOf(Error);
+        (0, vitest_1.expect)(error.message).toBe(`File is not part of the app graph: ${missingUri}\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}).`);
+    });
+});
+(0, vitest_1.describe)('platformos-graph CLI: project-root validation', () => {
+    /**
+     * A filesystem where nothing exists. Injected so `findRoot` walks up from the
+     * given path entirely in memory — no real disk, no dependency on what sits
+     * above the OS temp dir — and deterministically finds no project marker.
+     */
+    const emptyFs = {
+        stat: () => Promise.reject(new Error('ENOENT')),
+        readFile: () => Promise.reject(new Error('ENOENT')),
+        readDirectory: () => Promise.resolve([]),
+    };
+    (0, vitest_1.it)('throws instead of emitting an empty graph for a non-platformOS directory', async () => {
+        const dir = node_path_1.default.resolve('no-such-project', 'sub');
+        const startUri = (0, platformos_common_1.uriFromPath)(dir);
+        const error = await (0, cli_1.buildSerializedGraph)(dir, emptyFs).catch((e) => e);
+        (0, vitest_1.expect)(error).toBeInstanceOf(Error);
+        (0, vitest_1.expect)(error.message).toBe(`Not a platformOS project: ${startUri}\n` +
+            `No app/, marketplace_builder/, modules/, .pos, or .platformos-check.yml found ` +
+            `at or above this path. Pass the path to a platformOS app directory.`);
+    });
+});
+//# sourceMappingURL=cli.spec.js.map

package/dist/cli.spec.js.map

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

package/dist/graph/app-index-resolution.spec.d.ts

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

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,6 +7,9 @@ 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) {

package/dist/graph/augment.js.map

@@ -1 +1 @@
-{"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"}
+{"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"}