@goodbones/core 0.1.0-beta.1 → 0.1.0-beta.10

package/build/esm/infrastructure/manifest-file.js

@@ -1,15 +1,166 @@
+import { existsSync, readFileSync } from "node:fs";
+import * as path from "node:path";
 import { pathToFileURL } from "node:url";
+import { isAlias, isMap, isScalar, isSeq, LineCounter, parseDocument, stringify, } from "yaml";
 import { ConfigInvalid } from "../domain/architecture-error.js";
-export const DEFAULT_CONFIG_FILENAME = "architecture.config.mjs";
-// The manifest, as the file on disk states it, before any decoding. Today that
-// is a JavaScript module and its default export; a manifest in another format
-// changes this function and nothing behind it.
+import { expandIncludes } from "./manifest-include.js";
+// The manifest, as the files on disk state it, before any decoding. A data
+// file — YAML, or JSON, which YAML 1.2 contains — is what any host in any
+// language can read, and is the form the docs are written in. A JavaScript
+// module is the escape hatch a Node host alone honours: for a manifest
+// generated from other data, and for what the ecosystem expects of a config
+// file. Either may `include` further data files, so a monorepo's policy can
+// live beside the packages it governs. Whichever it is, what comes out is one
+// `unknown` value for the decoder, and, from the data formats, a way to turn
+// a path in it back into a file and a line.
+// In discovery order. A repository with none of these is told all four; one
+// with more than one is refused, so nobody edits the wrong file for a week.
+export const MANIFEST_FILENAMES = [
+    "architecture.yaml",
+    "architecture.yml",
+    "architecture.json",
+    "architecture.config.mjs",
+];
+export const findManifestFile = (repoRoot) => {
+    const present = MANIFEST_FILENAMES.filter((name) => existsSync(path.resolve(repoRoot, name)));
+    const [found] = present;
+    if (found === undefined) {
+        throw new ConfigInvalid({
+            configPath: repoRoot,
+            detail: `no architecture manifest found. Looked for ${MANIFEST_FILENAMES.join(", ")} ` +
+                `in this directory; \`architecture init\` writes a starter architecture.yaml.`,
+        });
+    }
+    if (present.length > 1) {
+        throw new ConfigInvalid({
+            configPath: repoRoot,
+            detail: `more than one architecture manifest is present (${present.join(", ")}), and only one ` +
+                `can be the policy. Delete the others, or name one with ARCHITECTURE_CONFIG.`,
+        });
+    }
+    return path.resolve(repoRoot, found);
+};
+const extensionOf = (configPath) => path.extname(configPath).toLowerCase();
+const isDataManifest = (configPath) => [".yaml", ".yml", ".json"].includes(extensionOf(configPath));
+const isModuleManifest = (configPath) => [".mjs", ".js", ".cjs"].includes(extensionOf(configPath));
+// Whichever form the root takes, an `include` in it names a data file, read
+// by the same parser; the locator that comes back answers across every file.
 export const readManifestFile = async (configPath) => {
+    const root = isDataManifest(configPath)
+        ? parseDataFile(configPath)
+        : isModuleManifest(configPath)
+            ? await readModule(configPath)
+            : undefined;
+    if (root === undefined) {
+        throw new ConfigInvalid({
+            configPath,
+            detail: "a manifest is a .yaml, .yml or .json file, or a .mjs/.js module — " +
+                `not ${JSON.stringify(path.basename(configPath))}.`,
+        });
+    }
+    const assembled = expandIncludes(configPath, root, { exists: existsSync, read: parseDataFile });
+    return {
+        configPath,
+        manifest: assembled.value,
+        locate: assembled.locate,
+        files: assembled.files,
+    };
+};
+const readModule = async (configPath) => {
     const module = await import(pathToFileURL(configPath).href).catch((cause) => {
         throw new ConfigInvalid({ configPath, detail: String(cause) });
     });
-    return typeof module === "object" && module !== null && "default" in module
-        ? module.default
-        : module;
+    const value = typeof module === "object" && module !== null && "default" in module ? module.default : module;
+    return { value, locate: undefined };
+};
+// YAML 1.2 core schema, which is what a reader without a YAML background
+// expects: `on` and `no` are strings, not booleans. Merge keys (`<<`) resolve,
+// because the parser handles them before the manifest sees the document, and
+// duplicate keys are refused rather than last-one-wins. A tag the parser does
+// not know is refused too — a manifest is data, and a `!!js/function` in it
+// would be a manifest only one runtime could read.
+const parseDataFile = (configPath) => {
+    let text;
+    try {
+        text = readFileSync(configPath, "utf8");
+    }
+    catch (cause) {
+        throw new ConfigInvalid({ configPath, detail: String(cause) });
+    }
+    const lines = new LineCounter();
+    const document = parseDocument(text, {
+        merge: true,
+        uniqueKeys: true,
+        customTags: [],
+        lineCounter: lines,
+        // A JSON file is read by the same parser; strict JSON is valid YAML.
+        schema: "core",
+    });
+    const problems = [...document.errors, ...document.warnings];
+    if (problems.length > 0) {
+        const file = path.basename(configPath);
+        throw new ConfigInvalid({
+            configPath,
+            detail: "the manifest does not parse:\n" +
+                problems
+                    .map((problem) => {
+                    const [position] = problem.linePos ?? [];
+                    const at = position === undefined
+                        ? ""
+                        : `${file}:${String(position.line)}:${String(position.col)}  `;
+                    return `  ${at}${problem.code}: ${problem.message.split("\n")[0] ?? problem.message}`;
+                })
+                    .join("\n"),
+        });
+    }
+    return {
+        value: document.toJS({ mapAsMap: false }),
+        locate: makeLocator(document, lines),
+    };
+};
+const keyMatches = (pair, segment) => isScalar(pair.key) && String(pair.key.value) === String(segment);
+// Walks the document's own tree by the decoder's path and answers with the
+// position of the deepest thing that exists along it. A map key is reported
+// at the key, where the reader's eye lands; a sequence item at the item. A
+// key merged in through `<<` lives in the fragment it came from, which the
+// walk cannot see — the reader then gets the position of the map instead.
+const makeLocator = (document, lines) => {
+    const positionOf = (node) => {
+        const offset = node?.range?.[0];
+        if (offset === undefined)
+            return null;
+        const { col, line } = lines.linePos(offset);
+        return { line, column: col };
+    };
+    const resolved = (node) => (isAlias(node) ? node.resolve(document) : node);
+    return (manifestPath) => {
+        let current = resolved(document.contents);
+        let position = positionOf(document.contents);
+        for (const segment of manifestPath) {
+            if (isMap(current)) {
+                const pair = current.items.find((one) => keyMatches(one, segment));
+                if (pair === undefined)
+                    break;
+                position = positionOf(isScalar(pair.key) ? pair.key : null) ?? position;
+                current = resolved(pair.value);
+            }
+            else if (isSeq(current) && typeof segment === "number") {
+                const item = current.items[segment];
+                if (item === undefined)
+                    break;
+                position = positionOf(item) ?? position;
+                current = resolved(item);
+            }
+            else {
+                break;
+            }
+        }
+        return position;
+    };
 };
+// The value as a YAML document, for `architecture migrate` and anything else
+// that writes a manifest rather than reads one. Strings are quoted whenever
+// the core schema would read them as something else, and a multi-line one —
+// a probe source — becomes a block scalar.
+export const formatManifestYaml = (manifest) => stringify(manifest, { lineWidth: 100, blockQuote: "literal", schema: "core" });
 //# sourceMappingURL=manifest-file.js.map

package/build/esm/infrastructure/manifest-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-file.js","sourceRoot":"","sources":["../../../src/infrastructure/manifest-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAEjE,+EAA+E;AAC/E,8EAA8E;AAC9E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,UAAkB,EAAoB,EAAE;IAC7E,MAAM,MAAM,GAAY,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC5F,MAAM,IAAI,aAAa,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,IAAI,MAAM;QACzE,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC,MAAM,CAAC;AACb,CAAC,CAAC"}
+{"version":3,"file":"manifest-file.js","sourceRoot":"","sources":["../../../src/infrastructure/manifest-file.ts"],"names":[],"mappings":"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"}

package/build/esm/infrastructure/manifest-include.js

@@ -0,0 +1,187 @@
+import * as path from "node:path";
+import { ConfigInvalid } from "../domain/architecture-error.js";
+import { renderManifestPath, } from "../domain/manifest-location.js";
+const INCLUDABLE = [".yaml", ".yml", ".json"];
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isInclude = (value) => isRecord(value) && "include" in value;
+const isPrefix = (prefix, whole) => prefix.length <= whole.length && prefix.every((segment, index) => whole[index] === segment);
+const makeLocator = (mounts) => {
+    if (!mounts.some((mount) => mount.locate !== undefined))
+        return undefined;
+    return (manifestPath) => {
+        const innermost = mounts
+            .filter((mount) => isPrefix(mount.at, manifestPath))
+            .sort((a, b) => a.at.length - b.at.length)
+            .at(-1);
+        if (innermost === undefined)
+            return null;
+        const found = innermost.locate?.([...innermost.origin, ...manifestPath.slice(innermost.at.length)]) ?? null;
+        if (found === null)
+            return null;
+        return innermost.label === undefined ? found : { ...found, file: innermost.label };
+    };
+};
+export const expandIncludes = (rootPath, root, reader) => {
+    const rootDirectory = path.dirname(rootPath);
+    const labelOf = (file) => path.relative(rootDirectory, file).split(path.sep).join("/");
+    const nameOf = (source) => source.label ?? path.basename(rootPath);
+    const files = [rootPath];
+    const mounts = [{ at: [], origin: [], label: undefined, locate: root.locate }];
+    // Fragments hoisted out of included files, and the file each name came from.
+    const hoisted = {};
+    const definedIn = new Map();
+    const refuse = (source, origin, detail) => {
+        const position = source.locate?.(origin) ?? null;
+        const at = position === null
+            ? ""
+            : `${nameOf(source)}:${String(position.line)}:${String(position.column)}  `;
+        throw new ConfigInvalid({
+            configPath: rootPath,
+            detail: `the manifest does not include:\n  ${at}${renderManifestPath(origin)}: ${detail}`,
+        });
+    };
+    // Checks a reference and reads the file it names. Nothing is placed yet:
+    // where the value lands depends on whether it is a list spliced into a list.
+    const open = (reference, origin, source) => {
+        const { include: specifier, ...rest } = reference;
+        if (typeof specifier !== "string") {
+            return refuse(source, origin, "`include` names a file, as a string.");
+        }
+        const shown = `\`include: ${JSON.stringify(specifier)}\``;
+        const beside = Object.keys(rest);
+        if (beside.length > 0) {
+            return refuse(source, origin, `${shown} stands alone: an included file is replaced whole, so there is nothing for ` +
+                `${beside.map((key) => `\`${key}\``).join(", ")} to override. ` +
+                `To override a fragment, put it under \`defs\` and \`use\` it.`);
+        }
+        const target = path.resolve(path.dirname(source.file), specifier);
+        if (!INCLUDABLE.includes(path.extname(target).toLowerCase())) {
+            return refuse(source, origin, `${shown} names a file that is not YAML or JSON. Only a data file can be included: ` +
+                `a module would make the manifest readable by one runtime only.`);
+        }
+        if (source.stack.includes(target)) {
+            return refuse(source, origin, `${shown} includes a file that is already being included: ` +
+                `${[...source.stack, target].map(labelOf).join(" → ")}.`);
+        }
+        if (!reader.exists(target)) {
+            return refuse(source, origin, `${shown} names a file that does not exist (looked for ${labelOf(target)}, ` +
+                `relative to ${nameOf(source)}).`);
+        }
+        const document = reader.read(target);
+        files.push(target);
+        return {
+            document,
+            source: {
+                file: target,
+                label: labelOf(target),
+                locate: document.locate,
+                stack: [...source.stack, target],
+            },
+        };
+    };
+    // Places an opened file at `at`, whole, and walks it so no reference is
+    // left inside. A top-level `defs` in the file joins the root's, and its
+    // `$schema` is for the editor — unless the file was included somewhere
+    // under `defs`, where it is a fragment or the map itself, and a key by
+    // either name is the author's.
+    const place = (opened, at) => {
+        const { document, source } = opened;
+        mounts.push({ at, origin: [], label: source.label, locate: source.locate });
+        if (!isRecord(document.value) || at[0] === "defs") {
+            return walk(document.value, at, [], source);
+        }
+        const { $schema: _schema, defs, ...body } = document.value;
+        if (defs !== undefined) {
+            if (!isRecord(defs)) {
+                return refuse(source, ["defs"], "`defs` must be a map of named fragments.");
+            }
+            for (const [name, fragment] of Object.entries(defs)) {
+                const already = definedIn.get(name);
+                if (already !== undefined) {
+                    return refuse(source, ["defs", name], `\`defs.${name}\` is already defined in ${already}. Every file's \`defs\` share ` +
+                        `one namespace; rename one of them.`);
+                }
+                definedIn.set(name, nameOf(source));
+                mounts.push({
+                    at: ["defs", name],
+                    origin: ["defs", name],
+                    label: source.label,
+                    locate: source.locate,
+                });
+                hoisted[name] = walk(fragment, ["defs", name], ["defs", name], source);
+            }
+        }
+        return walk(body, at, [], source);
+    };
+    // Appends each item of `list` to `items`. An include standing as an item
+    // whose file holds a list is spliced in, so a list can be split across
+    // files; an item that does not sit at the index it was written at is
+    // mounted on its own.
+    const append = (items, list, at, origin, source, spliced) => {
+        for (const [index, item] of list.entries()) {
+            const itemOrigin = [...origin, index];
+            const slot = [...at, items.length];
+            if (isInclude(item)) {
+                const opened = open(item, itemOrigin, source);
+                if (Array.isArray(opened.document.value)) {
+                    append(items, opened.document.value, at, [], opened.source, true);
+                }
+                else {
+                    items.push(place(opened, slot));
+                }
+                continue;
+            }
+            if (spliced || items.length !== index) {
+                mounts.push({ at: slot, origin: itemOrigin, label: source.label, locate: source.locate });
+            }
+            items.push(walk(item, slot, itemOrigin, source));
+        }
+    };
+    const walk = (value, at, origin, source) => {
+        if (isInclude(value))
+            return place(open(value, origin, source), at);
+        if (Array.isArray(value)) {
+            const items = [];
+            append(items, value, at, origin, source, false);
+            return items;
+        }
+        if (isRecord(value)) {
+            const entries = {};
+            for (const [key, item] of Object.entries(value)) {
+                entries[key] = walk(item, [...at, key], [...origin, key], source);
+            }
+            return entries;
+        }
+        return value;
+    };
+    const rootSource = {
+        file: rootPath,
+        label: undefined,
+        locate: root.locate,
+        stack: [rootPath],
+    };
+    const value = walk(root.value, [], [], rootSource);
+    // Nothing was included: the value and the locator are the reader's own.
+    if (files.length === 1)
+        return { value, locate: root.locate, files };
+    const names = Object.keys(hoisted);
+    if (names.length === 0 || !isRecord(value)) {
+        return { value, locate: makeLocator(mounts), files };
+    }
+    const own = value.defs;
+    if (own !== undefined && !isRecord(own)) {
+        return refuse(rootSource, ["defs"], "`defs` must be a map of named fragments.");
+    }
+    for (const name of names) {
+        if (own !== undefined && name in own) {
+            return refuse(rootSource, ["defs", name], `\`defs.${name}\` is also defined in ${definedIn.get(name) ?? "an included file"}. ` +
+                `Every file's \`defs\` share one namespace; rename one of them.`);
+        }
+    }
+    return {
+        value: { ...value, defs: { ...(own ?? {}), ...hoisted } },
+        locate: makeLocator(mounts),
+        files,
+    };
+};
+//# sourceMappingURL=manifest-include.js.map

package/build/esm/infrastructure/manifest-include.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-include.js","sourceRoot":"","sources":["../../../src/infrastructure/manifest-include.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAGL,kBAAkB,GACnB,MAAM,gCAAgC,CAAC;AAqCxC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAIvE,MAAM,SAAS,GAAG,CAAC,KAAc,EAA6B,EAAE,CAC9D,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC;AAExC,MAAM,QAAQ,GAAG,CAAC,MAAoB,EAAE,KAAmB,EAAW,EAAE,CACtE,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,CAAC;AAiC9F,MAAM,WAAW,GAAG,CAAC,MAA4B,EAA+B,EAAE;IAChF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1E,OAAO,CAAC,YAAY,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,MAAM;aACrB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;aACnD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;aACzC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACV,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,KAAK,GACT,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAChG,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAAgB,EAChB,IAAoB,EACpB,MAAqB,EACH,EAAE;IACpB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CACvC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEnF,MAAM,KAAK,GAAkB,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7F,6EAA6E;IAC7E,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,MAAoB,EAAE,MAAc,EAAS,EAAE;QAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;QACjD,MAAM,EAAE,GACN,QAAQ,KAAK,IAAI;YACf,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;QAChF,MAAM,IAAI,aAAa,CAAC;YACtB,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,qCAAqC,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,MAAM,EAAE;SAC1F,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,IAAI,GAAG,CAAC,SAA2B,EAAE,MAAoB,EAAE,MAAc,EAAU,EAAE;QACzF,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;QAClD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,sCAAsC,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,KAAK,GAAG,cAAc,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,MAAM,CACX,MAAM,EACN,MAAM,EACN,GAAG,KAAK,6EAA6E;gBACnF,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB;gBAC/D,+DAA+D,CAClE,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC7D,OAAO,MAAM,CACX,MAAM,EACN,MAAM,EACN,GAAG,KAAK,4EAA4E;gBAClF,gEAAgE,CACnE,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO,MAAM,CACX,MAAM,EACN,MAAM,EACN,GAAG,KAAK,mDAAmD;gBACzD,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,MAAM,CACX,MAAM,EACN,MAAM,EACN,GAAG,KAAK,iDAAiD,OAAO,CAAC,MAAM,CAAC,IAAI;gBAC1E,eAAe,MAAM,CAAC,MAAM,CAAC,IAAI,CACpC,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,OAAO;YACL,QAAQ;YACR,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;aACjC;SACF,CAAC;IACJ,CAAC,CAAC;IAEF,wEAAwE;IACxE,wEAAwE;IACxE,uEAAuE;IACvE,uEAAuE;IACvE,+BAA+B;IAC/B,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,EAAgB,EAAW,EAAE;QAC1D,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC3D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,0CAA0C,CAAC,CAAC;YAC9E,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,OAAO,MAAM,CACX,MAAM,EACN,CAAC,MAAM,EAAE,IAAI,CAAC,EACd,UAAU,IAAI,4BAA4B,OAAO,gCAAgC;wBAC/E,oCAAoC,CACvC,CAAC;gBACJ,CAAC;gBACD,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC;oBACV,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;oBAClB,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;oBACtB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC;IAEF,yEAAyE;IACzE,uEAAuE;IACvE,qEAAqE;IACrE,sBAAsB;IACtB,MAAM,MAAM,GAAG,CACb,KAAqB,EACrB,IAA4B,EAC5B,EAAgB,EAChB,MAAoB,EACpB,MAAc,EACd,OAAgB,EACV,EAAE;QACR,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;gBAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACpE,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;gBAClC,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5F,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CACX,KAAc,EACd,EAAgB,EAChB,MAAoB,EACpB,MAAc,EACL,EAAE;QACX,IAAI,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAEpE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,GAAmB,EAAE,CAAC;YACjC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,OAAO,GAA4B,EAAE,CAAC;YAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,UAAU,GAAW;QACzB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,CAAC,QAAQ,CAAC;KAClB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IAEnD,wEAAwE;IACxE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IAErE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;IACvB,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,0CAA0C,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;YACrC,OAAO,MAAM,CACX,UAAU,EACV,CAAC,MAAM,EAAE,IAAI,CAAC,EACd,UAAU,IAAI,yBAAyB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,kBAAkB,IAAI;gBAClF,gEAAgE,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE;QACzD,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;QAC3B,KAAK;KACN,CAAC;AACJ,CAAC,CAAC"}

package/build/esm/infrastructure/report-source-fake.js

@@ -0,0 +1,6 @@
+// Keyed by file: a test states which diagnostics another tool reported on
+// which file, and never runs the tool. Every spec is answered alike.
+export const makeReportSourceFake = (staged) => ({
+    diagnosticsOf: (_spec, file) => (staged[file] ?? []).map((one) => ({ ...one, file })),
+});
+//# sourceMappingURL=report-source-fake.js.map

package/build/esm/infrastructure/report-source-fake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-source-fake.js","sourceRoot":"","sources":["../../../src/infrastructure/report-source-fake.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,qEAAqE;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAyE,EAC3D,EAAE,CAAC,CAAC;IAClB,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;CACtF,CAAC,CAAC"}

package/build/esm/infrastructure/report-source-live.js

@@ -0,0 +1,165 @@
+import { spawn, spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { availableParallelism } from "node:os";
+import * as path from "node:path";
+import { ReportUnavailable } from "../domain/architecture-error.js";
+import { indexByFile, parseReport, uniqueDiagnostics } from "../domain/report.js";
+import { reportSourcesOf } from "../ports/report-source.js";
+// The report source on this host: runs a `report` term's commands from the
+// repository root, or reads the files it names, and parses the output once
+// — a report is about the whole repository, a campaign asks per file, and
+// the plugin asks for one file at a time across a whole lint run. Cached
+// per spec for the life of the process: the CLI is one process per `check`,
+// and oxlint's language server is one process per editor session, which
+// sees the report as of when it loaded the plugin. A report the build
+// writes to a file is the predictable form for the editor, and for CI.
+//
+// A term may name several commands — a tool that checks one project at a
+// time, run once per project — and their outputs are one report: parsed
+// each, joined, and a diagnostic two of them print kept once. `read` runs
+// them concurrently, as many at a time as the machine has cores, which is
+// why both hosts call it before any file asks; `diagnosticsOf` with no
+// answer kept runs them one after another, synchronously, and keeps that.
+//
+// A non-zero exit is not a failure — `tsc` exits 2 when there are errors,
+// which is the case the term exists for. A command that cannot be spawned,
+// or a file that is not there, is — and that failure is cached as the report
+// would have been, so the second file to ask gets the same answer without a
+// second spawn. The command is forked from the asking process; under the
+// oxlint plugin that is the linter, which Linux refuses to fork once its AST
+// buffers have merged into one mapping larger than RAM and swap — so the
+// plugin asks at load, and retrying per file would only repeat the refusal.
+const MAX_BUFFER = 256 * 1024 * 1024;
+const fileTextOf = (repoRoot, file) => {
+    const at = path.resolve(repoRoot, file);
+    try {
+        return readFileSync(at, "utf8");
+    }
+    catch (cause) {
+        throw new ReportUnavailable({ kind: "file", source: file, detail: String(cause) });
+    }
+};
+const commandTextSync = (repoRoot, command) => {
+    const run = spawnSync(command, {
+        cwd: repoRoot,
+        shell: true,
+        encoding: "utf8",
+        maxBuffer: MAX_BUFFER,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    if (run.error !== undefined) {
+        throw new ReportUnavailable({ kind: "command", source: command, detail: run.error.message });
+    }
+    return run.stdout;
+};
+const commandText = (repoRoot, command) => new Promise((resolve, reject) => {
+    const child = spawn(command, {
+        cwd: repoRoot,
+        shell: true,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    const chunks = [];
+    let size = 0;
+    child.stdout.on("data", (chunk) => {
+        size += chunk.length;
+        if (size > MAX_BUFFER) {
+            child.kill();
+            reject(new ReportUnavailable({
+                kind: "command",
+                source: command,
+                detail: `stdout exceeded ${String(MAX_BUFFER)} bytes`,
+            }));
+            return;
+        }
+        chunks.push(chunk);
+    });
+    child.stderr.resume();
+    child.on("error", (cause) => {
+        reject(new ReportUnavailable({ kind: "command", source: command, detail: cause.message }));
+    });
+    child.on("close", () => {
+        resolve(Buffer.concat(chunks).toString("utf8"));
+    });
+});
+// `work` over `items`, at most `lanes` at a time, answers in order.
+const inLanes = async (items, lanes, work) => {
+    const answers = new Array(items.length);
+    let next = 0;
+    const lane = async () => {
+        while (next < items.length) {
+            const index = next;
+            next += 1;
+            answers[index] = await work(items[index]);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(lanes, items.length) }, lane));
+    return answers;
+};
+// One command named as a string and the same one as a list of one are the
+// same report.
+const keyOf = (spec) => JSON.stringify([
+    spec.file === undefined ? "command" : "file",
+    reportSourcesOf(spec),
+    spec.format,
+    spec.pattern ?? null,
+]);
+export const makeReportSourceLive = (repoRoot) => {
+    const cache = new Map();
+    const reading = new Map();
+    // The outputs, in the order named, as one report.
+    const indexOf = (spec, texts) => indexByFile(uniqueDiagnostics(texts.flatMap((text) => parseReport(spec.format, text, { repoRoot, pattern: spec.pattern }))));
+    const answerSync = (spec) => {
+        try {
+            const texts = reportSourcesOf(spec).map((source) => spec.file === undefined ? commandTextSync(repoRoot, source) : fileTextOf(repoRoot, source));
+            return indexOf(spec, texts);
+        }
+        catch (cause) {
+            if (cause instanceof ReportUnavailable)
+                return cause;
+            throw cause;
+        }
+    };
+    const answer = async (spec) => {
+        try {
+            const sources = reportSourcesOf(spec);
+            const texts = spec.file === undefined
+                ? await inLanes(sources, availableParallelism(), (command) => commandText(repoRoot, command))
+                : sources.map((file) => fileTextOf(repoRoot, file));
+            return indexOf(spec, texts);
+        }
+        catch (cause) {
+            if (cause instanceof ReportUnavailable)
+                return cause;
+            throw cause;
+        }
+    };
+    const read = (spec) => {
+        const key = keyOf(spec);
+        if (cache.has(key))
+            return Promise.resolve();
+        const pending = reading.get(key);
+        if (pending !== undefined)
+            return pending;
+        const started = answer(spec).then((found) => {
+            cache.set(key, found);
+            reading.delete(key);
+        });
+        reading.set(key, started);
+        return started;
+    };
+    return {
+        read,
+        diagnosticsOf: (spec, file) => {
+            const key = keyOf(spec);
+            let found = cache.get(key);
+            if (found === undefined) {
+                found = answerSync(spec);
+                cache.set(key, found);
+            }
+            if (found instanceof ReportUnavailable)
+                throw found;
+            return found.get(file) ?? [];
+        },
+    };
+};
+//# sourceMappingURL=report-source-live.js.map

package/build/esm/infrastructure/report-source-live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-source-live.js","sourceRoot":"","sources":["../../../src/infrastructure/report-source-live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAmB,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAqB,eAAe,EAAmB,MAAM,2BAA2B,CAAC;AAEhG,2EAA2E;AAC3E,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,sEAAsE;AACtE,uEAAuE;AACvE,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,0EAA0E;AAC1E,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAE5E,MAAM,UAAU,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAErC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,IAAY,EAAU,EAAE;IAC5D,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,OAAe,EAAU,EAAE;IACpE,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,EAAE;QAC7B,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,UAAU;QACrB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,OAAe,EAAmB,EAAE,CACzE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE;QAC3B,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACxC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;QACrB,IAAI,IAAI,GAAG,UAAU,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,CACJ,IAAI,iBAAiB,CAAC;gBACpB,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,mBAAmB,MAAM,CAAC,UAAU,CAAC,QAAQ;aACtD,CAAC,CACH,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,CAAC,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,oEAAoE;AACpE,MAAM,OAAO,GAAG,KAAK,EACnB,KAAuB,EACvB,KAAa,EACb,IAA6B,EACF,EAAE;IAC7B,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,OAAO,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC;YACnB,IAAI,IAAI,CAAC,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/E,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,0EAA0E;AAC1E,eAAe;AACf,MAAM,KAAK,GAAG,CAAC,IAAgB,EAAU,EAAE,CACzC,IAAI,CAAC,SAAS,CAAC;IACb,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;IAC5C,eAAe,CAAC,IAAI,CAAC;IACrB,IAAI,CAAC,MAAM;IACX,IAAI,CAAC,OAAO,IAAI,IAAI;CACrB,CAAC,CAAC;AAIL,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAgB,EAAgB,EAAE;IACrE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEjD,kDAAkD;IAClD,MAAM,OAAO,GAAG,CAAC,IAAgB,EAAE,KAA4B,EAAW,EAAE,CAC1E,WAAW,CACT,iBAAiB,CACf,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACrB,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CACpE,CACF,CACF,CAAC;IAEJ,MAAM,UAAU,GAAG,CAAC,IAAgB,EAA+B,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACjD,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAC3F,CAAC;YACF,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,iBAAiB;gBAAE,OAAO,KAAK,CAAC;YACrD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,EAAE,IAAgB,EAAwC,EAAE;QAC9E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,SAAS;gBACrB,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CACzD,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAC/B;gBACH,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YACxD,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,iBAAiB;gBAAE,OAAO,KAAK,CAAC;YACrD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,IAAgB,EAAiB,EAAE;QAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;gBACzB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxB,CAAC;YACD,IAAI,KAAK,YAAY,iBAAiB;gBAAE,MAAM,KAAK,CAAC;YACpD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/build/esm/infrastructure/syntax-matcher-fake.js

@@ -0,0 +1,33 @@
+const ZERO = { line: 0, column: 0 };
+// Keyed by the source text, as the extractor fake is: a core test states
+// what a snippet's syntax yields and never the parse, which has its own
+// tests in the matcher package. A text not staged parses to no matches; a
+// file whose extension is not among `extensions` does not parse at all,
+// which is the shape of a language with no matcher.
+export const makeSyntaxMatcherFake = (staged, extensions = null) => ({
+    parse: (file, text) => {
+        if (extensions !== null && !extensions.some((extension) => file.endsWith(extension))) {
+            return null;
+        }
+        const matches = staged[text] ?? [];
+        return {
+            // A staged match's line is what a position is anchored by.
+            anchorAt: (position) => matches.find((one) => one.line === position.line)?.anchor ?? null,
+            findAll: (rule) => {
+                const asked = JSON.stringify(rule);
+                return matches
+                    .filter((one) => one.rule === undefined || JSON.stringify(one.rule) === asked)
+                    .map((one) => ({
+                    text: one.text,
+                    captures: new Map(Object.entries(one.captures ?? {})),
+                    range: {
+                        start: one.line === undefined ? ZERO : { line: one.line, column: 0 },
+                        end: one.line === undefined ? ZERO : { line: one.line, column: one.text.length },
+                    },
+                    anchor: one.anchor ?? null,
+                }));
+            },
+        };
+    },
+});
+//# sourceMappingURL=syntax-matcher-fake.js.map

package/build/esm/infrastructure/syntax-matcher-fake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-matcher-fake.js","sourceRoot":"","sources":["../../../src/infrastructure/syntax-matcher-fake.ts"],"names":[],"mappings":"AAeA,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAEpC,yEAAyE;AACzE,wEAAwE;AACxE,0EAA0E;AAC1E,wEAAwE;AACxE,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAA4D,EAC5D,UAAU,GAAiC,IAAI,EAChC,EAAE,CAAC,CAAC;IACnB,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACpB,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YACrF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO;YACL,2DAA2D;YAC3D,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,IAAI;YACzF,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBAChB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACnC,OAAO,OAAO;qBACX,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC;qBAC7E,GAAG,CAAC,CAAC,GAAG,EAAe,EAAE,CAAC,CAAC;oBAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;oBACrD,KAAK,EAAE;wBACL,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;wBACpE,GAAG,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE;qBACjF;oBACD,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI;iBAC3B,CAAC,CAAC,CAAC;YACR,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}