@platformos/platformos-graph 0.0.19 → 0.1.0

package/dist/index.js

@@ -14,16 +14,33 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toSourceCode = exports.parseJs = exports.findWebComponentReferences = exports.getWebComponentMap = exports.serializeAppGraph = exports.buildAppGraph = void 0;
+exports.graphParsers = exports.appBackedGetSourceCode = exports.toSourceCode = exports.parseJs = exports.serializeAppGraph = exports.nearestModules = exports.missingTargets = exports.missingDependencies = exports.reachableFrom = exports.orphans = exports.isOrphan = exports.isEntryPoint = exports.exists = exports.dependentsOf = exports.dependenciesOf = exports.extractStructural = exports.extractFileReferences = exports.isEdgeSource = exports.enumerateEdgeSources = exports.buildAppGraph = void 0;
 var build_1 = require("./graph/build");
 Object.defineProperty(exports, "buildAppGraph", { enumerable: true, get: function () { return build_1.buildAppGraph; } });
+var edge_sources_1 = require("./graph/edge-sources");
+Object.defineProperty(exports, "enumerateEdgeSources", { enumerable: true, get: function () { return edge_sources_1.enumerateEdgeSources; } });
+Object.defineProperty(exports, "isEdgeSource", { enumerable: true, get: function () { return edge_sources_1.isEdgeSource; } });
+var traverse_1 = require("./graph/traverse");
+Object.defineProperty(exports, "extractFileReferences", { enumerable: true, get: function () { return traverse_1.extractFileReferences; } });
+Object.defineProperty(exports, "extractStructural", { enumerable: true, get: function () { return traverse_1.extractStructural; } });
+var query_1 = require("./graph/query");
+Object.defineProperty(exports, "dependenciesOf", { enumerable: true, get: function () { return query_1.dependenciesOf; } });
+Object.defineProperty(exports, "dependentsOf", { enumerable: true, get: function () { return query_1.dependentsOf; } });
+Object.defineProperty(exports, "exists", { enumerable: true, get: function () { return query_1.exists; } });
+Object.defineProperty(exports, "isEntryPoint", { enumerable: true, get: function () { return query_1.isEntryPoint; } });
+Object.defineProperty(exports, "isOrphan", { enumerable: true, get: function () { return query_1.isOrphan; } });
+Object.defineProperty(exports, "orphans", { enumerable: true, get: function () { return query_1.orphans; } });
+Object.defineProperty(exports, "reachableFrom", { enumerable: true, get: function () { return query_1.reachableFrom; } });
+Object.defineProperty(exports, "missingDependencies", { enumerable: true, get: function () { return query_1.missingDependencies; } });
+Object.defineProperty(exports, "missingTargets", { enumerable: true, get: function () { return query_1.missingTargets; } });
+Object.defineProperty(exports, "nearestModules", { enumerable: true, get: function () { return query_1.nearestModules; } });
 var serialize_1 = require("./graph/serialize");
 Object.defineProperty(exports, "serializeAppGraph", { enumerable: true, get: function () { return serialize_1.serializeAppGraph; } });
-var getWebComponentMap_1 = require("./getWebComponentMap");
-Object.defineProperty(exports, "getWebComponentMap", { enumerable: true, get: function () { return getWebComponentMap_1.getWebComponentMap; } });
-Object.defineProperty(exports, "findWebComponentReferences", { enumerable: true, get: function () { return getWebComponentMap_1.findWebComponentReferences; } });
 var toSourceCode_1 = require("./toSourceCode");
 Object.defineProperty(exports, "parseJs", { enumerable: true, get: function () { return toSourceCode_1.parseJs; } });
 Object.defineProperty(exports, "toSourceCode", { enumerable: true, get: function () { return toSourceCode_1.toSourceCode; } });
+var parsers_1 = require("./parsers");
+Object.defineProperty(exports, "appBackedGetSourceCode", { enumerable: true, get: function () { return parsers_1.appBackedGetSourceCode; } });
+Object.defineProperty(exports, "graphParsers", { enumerable: true, get: function () { return parsers_1.graphParsers; } });
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAA8C;AAArC,sGAAA,aAAa,OAAA;AACtB,+CAAsD;AAA7C,8GAAA,iBAAiB,OAAA;AAC1B,2DAAsF;AAA7E,wHAAA,kBAAkB,OAAA;AAAE,gIAAA,0BAA0B,OAAA;AACvD,+CAAuD;AAA9C,uGAAA,OAAO,OAAA;AAAE,4GAAA,YAAY,OAAA;AAC9B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAA8C;AAArC,sGAAA,aAAa,OAAA;AACtB,qDAA0E;AAAjE,oHAAA,oBAAoB,OAAA;AAAE,4GAAA,YAAY,OAAA;AAC3C,6CAA4E;AAAnE,iHAAA,qBAAqB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AACjD,uCAWuB;AAVrB,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA;AACZ,+FAAA,MAAM,OAAA;AACN,qGAAA,YAAY,OAAA;AACZ,iGAAA,QAAQ,OAAA;AACR,gGAAA,OAAO,OAAA;AACP,sGAAA,aAAa,OAAA;AACb,4GAAA,mBAAmB,OAAA;AACnB,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AAGhB,+CAAsD;AAA7C,8GAAA,iBAAiB,OAAA;AAC1B,+CAAuD;AAA9C,uGAAA,OAAO,OAAA;AAAE,4GAAA,YAAY,OAAA;AAC9B,qCAAiE;AAAxD,iHAAA,sBAAsB,OAAA;AAAE,uGAAA,YAAY,OAAA;AAC7C,0CAAwB"}

package/dist/parsers.d.ts

@@ -0,0 +1,35 @@
+import { App, Parsers, UriString } from '@platformos/platformos-common';
+import { Program } from 'acorn';
+import { FileSourceCode } from './types';
+/** Parse a JavaScript asset, capturing a syntax error as a value rather than throwing. */
+export declare function parseJs(source: string): Program | Error;
+/**
+ * The file types the GRAPH holds and the linter does not: `.js` assets and images.
+ *
+ * They exist for {@link toSourceCode}'s contract — every URI it is handed comes back as a
+ * `FileSourceCode` — and so an `App` an asset URI is put into can answer `ast` at all. NOT
+ * because a graph build reads them: `traverseModule` returns immediately for an Asset node, and
+ * the only question the graph asks about an asset is whether it EXISTS.
+ *
+ * Registering them on an {@link App} — rather than building a second set of file objects — is
+ * what lets a graph build and a lint run over the same project hold the SAME `AppFile`
+ * instances, so each file is read and parsed at most once for both. The language server does
+ * that; check-node builds no graph, so merging into `nodeParsers` would do nothing.
+ *
+ * THE MCP SUPERVISOR DELIBERATELY DOES NOT SHARE, and this is not a pending to-do: it builds no
+ * graph, parsing per request only the handful of files that could reference the edited one.
+ * Routing those through check-node's shared `App` would win nothing — `lintBuffers` parses the
+ * content it was HANDED and drops the app's entry on the way out — and would risk something,
+ * because that `App` carries UNSAVED buffers while the blast radius runs CONCURRENTLY with the
+ * lint.
+ */
+export declare const graphParsers: Parsers;
+/**
+ * A `getSourceCode` for the graph backed by an {@link App}.
+ *
+ * Pass it as `IDependencies.getSourceCode` and the graph stops parsing anything the
+ * lint has already parsed, and vice versa — they read the same file objects. Files
+ * the app does not contain fall through to `fallback`, which is how a URI outside
+ * the project (or an unclassified file) still gets a source code.
+ */
+export declare function appBackedGetSourceCode(app: App, fallback: (uri: UriString) => Promise<FileSourceCode>): (uri: UriString) => Promise<FileSourceCode>;

package/dist/parsers.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.graphParsers = void 0;
+exports.parseJs = parseJs;
+exports.appBackedGetSourceCode = appBackedGetSourceCode;
+const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const acorn_1 = require("acorn");
+const types_1 = require("./types");
+/** Parse a JavaScript asset, capturing a syntax error as a value rather than throwing. */
+function parseJs(source) {
+    try {
+        return (0, acorn_1.parse)(source, {
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+        });
+    }
+    catch (error) {
+        return (0, platformos_check_common_1.asError)(error);
+    }
+}
+/**
+ * A binary asset has nothing to parse. It is still a graph node — something links
+ * to it — so it gets an `Error` value rather than being absent, exactly as an
+ * unparseable file would.
+ */
+const parseOpaqueAsset = () => new Error('File parsing not implemented');
+/**
+ * The file types the GRAPH holds and the linter does not: `.js` assets and images.
+ *
+ * They exist for {@link toSourceCode}'s contract — every URI it is handed comes back as a
+ * `FileSourceCode` — and so an `App` an asset URI is put into can answer `ast` at all. NOT
+ * because a graph build reads them: `traverseModule` returns immediately for an Asset node, and
+ * the only question the graph asks about an asset is whether it EXISTS.
+ *
+ * Registering them on an {@link App} — rather than building a second set of file objects — is
+ * what lets a graph build and a lint run over the same project hold the SAME `AppFile`
+ * instances, so each file is read and parsed at most once for both. The language server does
+ * that; check-node builds no graph, so merging into `nodeParsers` would do nothing.
+ *
+ * THE MCP SUPERVISOR DELIBERATELY DOES NOT SHARE, and this is not a pending to-do: it builds no
+ * graph, parsing per request only the handful of files that could reference the edited one.
+ * Routing those through check-node's shared `App` would win nothing — `lintBuffers` parses the
+ * content it was HANDED and drops the app's entry on the way out — and would risk something,
+ * because that `App` carries UNSAVED buffers while the blast radius runs CONCURRENTLY with the
+ * lint.
+ */
+exports.graphParsers = {
+    extensions: {
+        js: parseJs,
+        ...Object.fromEntries(types_1.SUPPORTED_ASSET_IMAGE_EXTENSIONS.map((extension) => [extension, parseOpaqueAsset])),
+    },
+};
+/**
+ * A `getSourceCode` for the graph backed by an {@link App}.
+ *
+ * Pass it as `IDependencies.getSourceCode` and the graph stops parsing anything the
+ * lint has already parsed, and vice versa — they read the same file objects. Files
+ * the app does not contain fall through to `fallback`, which is how a URI outside
+ * the project (or an unclassified file) still gets a source code.
+ */
+function appBackedGetSourceCode(app, fallback) {
+    return async (uri) => {
+        const file = app.get(uri);
+        if (!file)
+            return fallback(uri);
+        await file.load();
+        // An AppFile is structurally a SourceCode; its `ast` is typed `unknown` only
+        // because platformos-common sits below the parsers that produce ASTs.
+        return file;
+    };
+}
+//# sourceMappingURL=parsers.js.map

package/dist/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../src/parsers.ts"],"names":[],"mappings":";;;AAOA,0BASC;AA8CD,wDAYC;AAzED,iFAA8D;AAC9D,iCAAqD;AAErD,mCAA2E;AAE3E,0FAA0F;AAC1F,SAAgB,OAAO,CAAC,MAAc;IACpC,IAAI,CAAC;QACH,OAAO,IAAA,aAAU,EAAC,MAAM,EAAE;YACxB,WAAW,EAAE,QAAQ;YACrB,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAA,iCAAO,EAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,gBAAgB,GAAW,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;GAmBG;AACU,QAAA,YAAY,GAAY;IACnC,UAAU,EAAE;QACV,EAAE,EAAE,OAAO;QACX,GAAG,MAAM,CAAC,WAAW,CACnB,wCAAgC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CACnF;KACF;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CACpC,GAAQ,EACR,QAAqD;IAErD,OAAO,KAAK,EAAE,GAAc,EAA2B,EAAE;QACvD,MAAM,IAAI,GAAwB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,6EAA6E;QAC7E,sEAAsE;QACtE,OAAO,IAAiC,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC"}

package/dist/parsers.spec.d.ts

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

package/dist/parsers.spec.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const platformos_common_1 = require("@platformos/platformos-common");
+const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const vitest_1 = require("vitest");
+const parsers_1 = require("./parsers");
+const toSourceCode_1 = require("./toSourceCode");
+const ROOT = 'file:///project';
+const uri = (relativePath) => `${ROOT}/${relativePath}`;
+const fsOver = (files) => ({
+    readFile: async (target) => {
+        const source = files[target];
+        if (source === undefined)
+            throw new Error(`ENOENT: ${target}`);
+        return source;
+    },
+    stat: async () => {
+        throw new Error('not used');
+    },
+    readDirectory: async () => [],
+});
+(0, vitest_1.describe)('graphParsers', () => {
+    (0, vitest_1.it)('registers a JS parser and treats images as opaque', async () => {
+        const jsUri = uri('app/assets/app.js');
+        const pngUri = uri('app/assets/logo.png');
+        const files = { [jsUri]: 'export const a = 1;', [pngUri]: 'binary' };
+        const app = platformos_common_1.App.fromPaths(ROOT, [jsUri, pngUri], fsOver(files), parsers_1.graphParsers);
+        await app.load();
+        (0, vitest_1.expect)(app.get(jsUri).ast.type).toBe('Program');
+        (0, vitest_1.expect)(app.get(pngUri).ast).toEqual(new Error('File parsing not implemented'));
+    });
+    (0, vitest_1.it)('is the same JS parse the buffer path uses', async () => {
+        const source = 'export const a = 1;';
+        const jsUri = uri('app/assets/app.js');
+        const app = platformos_common_1.App.fromPaths(ROOT, [jsUri], fsOver({ [jsUri]: source }), parsers_1.graphParsers);
+        await app.load();
+        const fromBuffer = await (0, toSourceCode_1.toSourceCode)(jsUri, source);
+        (0, vitest_1.expect)(app.get(jsUri).ast).toEqual(fromBuffer.ast);
+    });
+});
+(0, vitest_1.describe)('appBackedGetSourceCode', () => {
+    const parsers = (liquid = vitest_1.vi.fn(platformos_check_common_1.toLiquidHTMLAST)) => ({
+        parsers: { [platformos_common_1.SourceCodeType.LiquidHtml]: liquid, extensions: parsers_1.graphParsers.extensions },
+        liquid,
+    });
+    (0, vitest_1.it)('parses a file at most once across a graph read and a lint read', async () => {
+        const cardUri = uri('app/views/partials/card.liquid');
+        const { parsers: registered, liquid } = parsers();
+        const app = platformos_common_1.App.fromPaths(ROOT, [cardUri], fsOver({ [cardUri]: '<b>card</b>' }), registered);
+        const getSourceCode = (0, parsers_1.appBackedGetSourceCode)(app, async () => {
+            throw new Error('fallback should not be needed');
+        });
+        // The graph asks for it…
+        const forGraph = await getSourceCode(cardUri);
+        void forGraph.ast;
+        // …and the lint reads the same file object.
+        await app.get(cardUri).load();
+        void app.get(cardUri).ast;
+        (0, vitest_1.expect)(forGraph).toBe(app.get(cardUri));
+        (0, vitest_1.expect)(liquid.mock.calls.length).toBe(1);
+    });
+    (0, vitest_1.it)('falls back for a URI the app does not contain', async () => {
+        const app = platformos_common_1.App.fromPaths(ROOT, [], fsOver({}), parsers_1.graphParsers);
+        const outside = 'file:///elsewhere/thing.liquid';
+        const result = await (0, parsers_1.appBackedGetSourceCode)(app, async (target) => (0, toSourceCode_1.toSourceCode)(target, '<b>outside</b>'))(outside);
+        (0, vitest_1.expect)(result.uri).toBe(outside);
+        (0, vitest_1.expect)(result.source).toBe('<b>outside</b>');
+    });
+});
+//# sourceMappingURL=parsers.spec.js.map

package/dist/parsers.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.spec.js","sourceRoot":"","sources":["../src/parsers.spec.ts"],"names":[],"mappings":";;AAAA,qEAA6E;AAC7E,iFAAsE;AACtE,mCAAkD;AAClD,uCAAiE;AACjE,iDAA8C;AAE9C,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAC/B,MAAM,GAAG,GAAG,CAAC,YAAoB,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC;AAEhE,MAAM,MAAM,GAAG,CAAC,KAA6B,EAAE,EAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,EAAE,KAAK,IAAI,EAAE;QACf,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IACD,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;CAC9B,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAA,WAAE,EAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,KAAK,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;QACrE,MAAM,GAAG,GAAG,uBAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,sBAAY,CAAC,CAAC;QAE9E,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAEjB,IAAA,eAAM,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAwB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvE,IAAA,eAAM,EAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,MAAM,GAAG,qBAAqB,CAAC;QACrC,MAAM,KAAK,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,uBAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,sBAAY,CAAC,CAAC;QACpF,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAEjB,MAAM,UAAU,GAAG,MAAM,IAAA,2BAAY,EAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAErD,IAAA,eAAM,EAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,MAAM,OAAO,GAAG,CACd,MAAM,GAAG,WAAE,CAAC,EAAE,CAAC,yCAAe,CAAC,EACc,EAAE,CAAC,CAAC;QACjD,OAAO,EAAE,EAAE,CAAC,kCAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAY,CAAC,UAAU,EAAE;QACrF,MAAM;KACP,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,OAAO,GAAG,GAAG,CAAC,gCAAgC,CAAC,CAAC;QACtD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,uBAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QAC7F,MAAM,aAAa,GAAG,IAAA,gCAAsB,EAAC,GAAG,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,yBAAyB;QACzB,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9C,KAAK,QAAQ,CAAC,GAAG,CAAC;QAClB,4CAA4C;QAC5C,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,EAAE,CAAC;QAC/B,KAAK,GAAG,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,GAAG,CAAC;QAE3B,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAA+B,CAAC,CAAC;QACtE,IAAA,eAAM,EAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,GAAG,GAAG,uBAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,sBAAY,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,gCAAgC,CAAC;QAEjD,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAsB,EAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAChE,IAAA,2BAAY,EAAC,MAAM,EAAE,gBAAgB,CAAC,CACvC,CAAC,OAAO,CAAC,CAAC;QAEX,IAAA,eAAM,EAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/toSourceCode.d.ts

@@ -1,5 +1,17 @@
 import { UriString } from '@platformos/platformos-check-common';
-import { Program } from 'acorn';
 import { FileSourceCode } from './types';
-export declare function parseJs(source: string): Program | Error;
+import { parseJs } from './parsers';
+export { parseJs };
+/**
+ * Build a source code for a graph node from contents already in hand.
+ *
+ * This is the path for callers with no `App`: an in-flight editor buffer, a fixture,
+ * a URI from outside the project. Callers that DO have one should pass
+ * `appBackedGetSourceCode(app, …)` as `getSourceCode` instead — that is what makes a
+ * graph build and a lint run share one parse per file rather than doing one each.
+ *
+ * The JS and image-asset parses come from {@link graphParsers}, so there is exactly
+ * one definition of how each is handled whether the file arrives through the App
+ * model or through here.
+ */
 export declare function toSourceCode(uri: UriString, source: string): Promise<FileSourceCode>;

package/dist/toSourceCode.js

@@ -1,31 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseJs = parseJs;
+exports.parseJs = void 0;
 exports.toSourceCode = toSourceCode;
 const platformos_check_common_1 = require("@platformos/platformos-check-common");
-const acorn_1 = require("acorn");
+const platformos_common_1 = require("@platformos/platformos-common");
+const parsers_1 = require("./parsers");
+Object.defineProperty(exports, "parseJs", { enumerable: true, get: function () { return parsers_1.parseJs; } });
 const utils_1 = require("./utils");
-function parseJs(source) {
-    try {
-        return (0, acorn_1.parse)(source, {
-            ecmaVersion: 'latest',
-            sourceType: 'module',
-        });
-    }
-    catch (error) {
-        return (0, platformos_check_common_1.asError)(error);
-    }
-}
+/**
+ * Build a source code for a graph node from contents already in hand.
+ *
+ * This is the path for callers with no `App`: an in-flight editor buffer, a fixture,
+ * a URI from outside the project. Callers that DO have one should pass
+ * `appBackedGetSourceCode(app, …)` as `getSourceCode` instead — that is what makes a
+ * graph build and a lint run share one parse per file rather than doing one each.
+ *
+ * The JS and image-asset parses come from {@link graphParsers}, so there is exactly
+ * one definition of how each is handled whether the file arrives through the App
+ * model or through here.
+ */
 async function toSourceCode(uri, source) {
     const extension = (0, utils_1.extname)(uri);
-    if (extension === 'json' ||
-        extension === 'liquid' ||
-        extension === 'graphql' ||
-        extension === 'yml' ||
-        extension === 'yaml') {
+    // `sourceCodeTypeOf` is the single answer to which extensions check-common
+    // parses; `.json` is the one addition, and only because `tcToSourceCode` models
+    // an unrecognised buffer as JSON for the editor (see its doc comment). Anything
+    // else is an asset, parsed — or not — by `graphParsers`.
+    if ((0, platformos_common_1.sourceCodeTypeOf)(uri) !== undefined || extension === 'json') {
         return (0, platformos_check_common_1.toSourceCode)(uri, source);
     }
-    const ast = extension === 'js' ? parseJs(source) : new Error('File parsing not implemented');
+    const parse = parsers_1.graphParsers.extensions?.[extension];
+    const ast = (parse ? parse(source, uri) : new Error('File parsing not implemented'));
     const assetSourceCode = { type: 'asset', uri, source, ast };
     return assetSourceCode;
 }

package/dist/toSourceCode.js.map

@@ -1 +1 @@
-{"version":3,"file":"toSourceCode.js","sourceRoot":"","sources":["../src/toSourceCode.ts"],"names":[],"mappings":";;AASA,0BASC;AAED,oCAkBC;AAtCD,iFAI6C;AAC7C,iCAAqD;AAErD,mCAAkC;AAElC,SAAgB,OAAO,CAAC,MAAc;IACpC,IAAI,CAAC;QACH,OAAO,IAAA,aAAU,EAAC,MAAM,EAAE;YACxB,WAAW,EAAE,QAAQ;YACrB,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAA,iCAAO,EAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,GAAc,EAAE,MAAc;IAC/D,MAAM,SAAS,GAAG,IAAA,eAAO,EAAC,GAAG,CAAC,CAAC;IAE/B,IACE,SAAS,KAAK,MAAM;QACpB,SAAS,KAAK,QAAQ;QACtB,SAAS,KAAK,SAAS;QACvB,SAAS,KAAK,KAAK;QACnB,SAAS,KAAK,MAAM,EACpB,CAAC;QACD,OAAO,IAAA,sCAAc,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,GAAG,GACP,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAEnF,MAAM,eAAe,GAAoB,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC7E,OAAO,eAAe,CAAC;AACzB,CAAC"}
+{"version":3,"file":"toSourceCode.js","sourceRoot":"","sources":["../src/toSourceCode.ts"],"names":[],"mappings":";;;AAoBA,oCAkBC;AAtCD,iFAAgG;AAChG,qEAAiE;AAEjE,uCAAkD;AAGzC,wFAHc,iBAAO,OAGd;AAFhB,mCAAkC;AAIlC;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,YAAY,CAAC,GAAc,EAAE,MAAc;IAC/D,MAAM,SAAS,GAAG,IAAA,eAAO,EAAC,GAAG,CAAC,CAAC;IAE/B,2EAA2E;IAC3E,gFAAgF;IAChF,gFAAgF;IAChF,yDAAyD;IACzD,IAAI,IAAA,oCAAgB,EAAC,GAAG,CAAC,KAAK,SAAS,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QAChE,OAAO,IAAA,sCAAc,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAG,sBAAY,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,CACV,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAC7C,CAAC;IAE5B,MAAM,eAAe,GAAoB,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC7E,OAAO,eAAe,CAAC;AACzB,CAAC"}