semantifold 0.9.0 → 0.10.0

package/build/src/project-cli.js

@@ -0,0 +1,145 @@
+// @ts-check
+import { SemantifoldDiagnostic } from "./diagnostic.js";
+import { ProjectBuilder } from "./project-build.js";
+import { ProjectBuildReporter } from "./project-reporter.js";
+import { ProjectWatchCoordinator } from "./project-watch.js";
+import { ProjectWatchReporter } from "./project-watch-reporter.js";
+/**
+ * Owns one strict command invocation while delegating durable build behavior.
+ */
+export class SemantifoldCli {
+    /** @type {ProjectBuilder} */
+    #builder;
+    /** @type {ProjectWatchCoordinator} */
+    #coordinator;
+    /** @type {import("./project-reporter.js").WritableOutput} */
+    #stdout;
+    /** @type {import("./project-reporter.js").WritableOutput} */
+    #stderr;
+    /**
+     * Creates an importable CLI lifecycle.
+     * @param {{builder?: ProjectBuilder, coordinator?: ProjectWatchCoordinator, stderr?: import("./project-reporter.js").WritableOutput, stdout?: import("./project-reporter.js").WritableOutput}} [options] - Collaborators and sinks.
+     */
+    constructor(options = {}) {
+        this.#builder = options.builder ?? new ProjectBuilder();
+        this.#coordinator = options.coordinator ?? new ProjectWatchCoordinator({ builder: this.#builder });
+        this.#stdout = options.stdout ?? process.stdout;
+        this.#stderr = options.stderr ?? process.stderr;
+    }
+    /**
+     * Runs one command without mutating process exit state.
+     * @param {readonly string[]} arguments_ - Arguments after the executable name.
+     * @returns {Promise<0 | 1>} Exact process status.
+     */
+    async run(arguments_) {
+        const hintedFormat = arguments_.includes("--ndjson") ? "ndjson" : "human";
+        const watchHint = arguments_[0] == "watch";
+        let reporter = watchHint
+            ? new ProjectWatchReporter({ format: hintedFormat, stderr: this.#stderr, stdout: this.#stdout })
+            : new ProjectBuildReporter({ format: hintedFormat, stderr: this.#stderr, stdout: this.#stdout });
+        try {
+            const options = parseSemantifoldCliArguments(arguments_);
+            const command = "command" in options ? options.command : "build";
+            if (options.format != hintedFormat) {
+                reporter = command == "watch"
+                    ? new ProjectWatchReporter({ format: options.format, stderr: this.#stderr, stdout: this.#stdout })
+                    : new ProjectBuildReporter({ format: options.format, stderr: this.#stderr, stdout: this.#stdout });
+            }
+            if (command == "watch") {
+                const result = await this.#coordinator.run(options.projectPath, /** @type {ProjectWatchReporter} */ (reporter), {
+                    check: options.check
+                });
+                return result.status == "stopped" ? 0 : 1;
+            }
+            const controller = new AbortController();
+            const forwardSignal = () => controller.abort("Semantifold CLI received a termination signal.");
+            if (options.check) {
+                process.once("SIGINT", forwardSignal);
+                process.once("SIGTERM", forwardSignal);
+            }
+            let result;
+            try {
+                result = await this.#builder.build(options.projectPath, /** @type {ProjectBuildReporter} */ (reporter), {
+                    check: options.check,
+                    ...(options.check ? { signal: controller.signal } : {})
+                });
+            }
+            finally {
+                if (options.check) {
+                    process.removeListener("SIGINT", forwardSignal);
+                    process.removeListener("SIGTERM", forwardSignal);
+                }
+            }
+            /** @type {ProjectBuildReporter} */ (reporter).succeeded(result);
+            return 0;
+        }
+        catch (error) {
+            if (reporter instanceof ProjectWatchReporter)
+                reporter.watchFailed(error);
+            else
+                reporter.failed(error);
+            return 1;
+        }
+    }
+}
+/**
+ * Parses the intentionally narrow one-shot CLI grammar.
+ * @param {readonly string[]} arguments_ - Arguments after the executable name.
+ * @returns {Readonly<{check: boolean, format: "human" | "ndjson", projectPath: string}> | Readonly<{command: "watch", check: boolean, format: "human" | "ndjson", projectPath: string}>} Validated command options.
+ */
+export function parseSemantifoldCliArguments(arguments_) {
+    if (!Array.isArray(arguments_) || arguments_.length == 0 || arguments_[0] != "build" && arguments_[0] != "watch") {
+        invalidArguments("Expected the command 'semantifold build' or 'semantifold watch'.");
+    }
+    const command = /** @type {"build" | "watch"} */ (arguments_[0]);
+    let format = /** @type {"human" | "ndjson"} */ ("human");
+    let projectPath = "./semantifold.json";
+    let projectSeen = false;
+    let ndjsonSeen = false;
+    let checkSeen = false;
+    for (let index = 1; index < arguments_.length; index += 1) {
+        const argument = arguments_[index];
+        if (argument == "--check") {
+            if (checkSeen)
+                invalidArguments("Option '--check' may be supplied only once.");
+            checkSeen = true;
+            continue;
+        }
+        if (argument == "--ndjson") {
+            if (ndjsonSeen)
+                invalidArguments("Option '--ndjson' may be supplied only once.");
+            ndjsonSeen = true;
+            format = "ndjson";
+            continue;
+        }
+        if (argument == "--project") {
+            if (projectSeen)
+                invalidArguments("Option '--project' may be supplied only once.");
+            const value = arguments_[index + 1];
+            if (typeof value != "string" || value.length == 0 || value.startsWith("--")) {
+                invalidArguments("Option '--project' requires one path value.");
+            }
+            projectSeen = true;
+            projectPath = value;
+            index += 1;
+            continue;
+        }
+        invalidArguments(`Unknown command argument '${argument}'.`);
+    }
+    return command == "watch"
+        ? Object.freeze({ command, check: checkSeen, format, projectPath })
+        : Object.freeze({ check: checkSeen, format, projectPath });
+}
+/**
+ * Throws one stable CLI grammar diagnostic.
+ * @param {string} message - Failure detail.
+ * @returns {never} Always throws.
+ */
+function invalidArguments(message) {
+    throw new SemantifoldDiagnostic({
+        code: "INVALID_CLI_ARGUMENTS",
+        language: "cli",
+        message
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvamVjdC1jbGkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcHJvamVjdC1jbGkuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sRUFBQyxxQkFBcUIsRUFBQyxNQUFNLGlCQUFpQixDQUFBO0FBQ3JELE9BQU8sRUFBQyxjQUFjLEVBQUMsTUFBTSxvQkFBb0IsQ0FBQTtBQUNqRCxPQUFPLEVBQUMsb0JBQW9CLEVBQUMsTUFBTSx1QkFBdUIsQ0FBQTtBQUMxRCxPQUFPLEVBQUMsdUJBQXVCLEVBQUMsTUFBTSxvQkFBb0IsQ0FBQTtBQUMxRCxPQUFPLEVBQUMsb0JBQW9CLEVBQUMsTUFBTSw2QkFBNkIsQ0FBQTtBQUVoRTs7R0FFRztBQUNILE1BQU0sT0FBTyxjQUFjO0lBQ3pCLDZCQUE2QjtJQUM3QixRQUFRLENBQUE7SUFDUixzQ0FBc0M7SUFDdEMsWUFBWSxDQUFBO0lBQ1osNkRBQTZEO0lBQzdELE9BQU8sQ0FBQTtJQUNQLDZEQUE2RDtJQUM3RCxPQUFPLENBQUE7SUFFUDs7O09BR0c7SUFDSCxZQUFZLE9BQU8sR0FBRyxFQUFFO1FBQ3RCLElBQUksQ0FBQyxRQUFRLEdBQUcsT0FBTyxDQUFDLE9BQU8sSUFBSSxJQUFJLGNBQWMsRUFBRSxDQUFBO1FBQ3ZELElBQUksQ0FBQyxZQUFZLEdBQUcsT0FBTyxDQUFDLFdBQVcsSUFBSSxJQUFJLHVCQUF1QixDQUFDLEVBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxRQUFRLEVBQUMsQ0FBQyxDQUFBO1FBQ2hHLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDLE1BQU0sSUFBSSxPQUFPLENBQUMsTUFBTSxDQUFBO1FBQy9DLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDLE1BQU0sSUFBSSxPQUFPLENBQUMsTUFBTSxDQUFBO0lBQ2pELENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsS0FBSyxDQUFDLEdBQUcsQ0FBQyxVQUFVO1FBQ2xCLE1BQU0s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Q0FBQztJQUVELE9BQU8sT0FBTyxJQUFJLE9BQU87UUFDdkIsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBQyxPQUFPLEVBQUUsS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUsV0FBVyxFQUFDLENBQUM7UUFDakUsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBQyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxXQUFXLEVBQUMsQ0FBQyxDQUFBO0FBQzVELENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsU0FBUyxnQkFBZ0IsQ0FBQyxPQUFPO0lBQy9CLE1BQU0sSUFBSSxxQkFBcUIsQ0FBQztRQUM5QixJQUFJLEVBQUUsdUJBQXVCO1FBQzdCLFFBQVEsRUFBRSxLQUFLO1FBQ2YsT0FBTztLQUNSLENBQUMsQ0FBQTtBQUNKLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBAdHMtY2hlY2tcblxuaW1wb3J0IHtTZW1hbnRpZm9sZERpYWdub3N0aWN9IGZyb20gXCIuL2RpYWdub3N0aWMuanNcIlxuaW1wb3J0IHtQcm9qZWN0QnVpbGRlcn0gZnJvbSBcIi4vcHJvamVjdC1idWlsZC5qc1wiXG5pbXBvcnQge1Byb2plY3RCdWlsZFJlcG9ydGVyfSBmcm9tIFwiLi9wcm9qZWN0LXJlcG9ydGVyLmpzXCJcbmltcG9ydCB7UHJvamVjdFdhdGNoQ29vcmRpbmF0b3J9IGZyb20gXCIuL3Byb2plY3Qtd2F0Y2guanNcIlxuaW1wb3J0IHtQcm9qZWN0V2F0Y2hSZXBvcnRlcn0gZnJvbSBcIi4vcHJvamVjdC13YXRjaC1yZXBvcnRlci5qc1wiXG5cbi8qKlxuICogT3ducyBvbmUgc3RyaWN0IGNvbW1hbmQgaW52b2NhdGlvbiB3aGlsZSBkZWxlZ2F0aW5nIGR1cmFibGUgYnVpbGQgYmVoYXZpb3IuXG4gKi9cbmV4cG9ydCBjbGFzcyBTZW1hbnRpZm9sZENsaSB7XG4gIC8qKiBAdHlwZSB7UHJvamVjdEJ1aWxkZXJ9ICovXG4gICNidWlsZGVyXG4gIC8qKiBAdHlwZSB7UHJvamVjdFdhdGNoQ29vcmRpbmF0b3J9ICovXG4gICNjb29yZGluYXRvclxuICAvKiogQHR5cGUge2ltcG9ydChcIi4vcHJvamVjdC1yZXBvcnRlci5qc1wiKS5Xcml0YWJsZU91dHB1dH0gKi9cbiAgI3N0ZG91dFxuICAvKiogQHR5cGUge2ltcG9ydChcIi4vcHJvamVjdC1yZXBvcnRlci5qc1wiKS5Xcml0YWJsZU91dHB1dH0gKi9cbiAgI3N0ZGVyclxuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGFuIGltcG9ydGFibGUgQ0xJIGxpZmVjeWNsZS5cbiAgICogQHBhcmFtIHt7YnVpbGRlcj86IFByb2plY3RCdWlsZGVyLCBjb29yZGluYXRvcj86IFByb2plY3RXYXRjaENvb3JkaW5hdG9yLCBzdGRlcnI/OiBpbXBvcnQoXCIuL3Byb2plY3QtcmVwb3J0ZXIuanNcIikuV3JpdGFibGVPdXRwdXQsIHN0ZG91dD86IGltcG9ydChcIi4vcHJvamVjdC1yZXBvcnRlci5qc1wiKS5Xcml0YWJsZU91dHB1dH19IFtvcHRpb25zXSAtIENvbGxhYm9yYXRvcnMgYW5kIHNpbmtzLlxuICAgKi9cbiAgY29uc3RydWN0b3Iob3B0aW9ucyA9IHt9KSB7XG4gICAgdGhpcy4jYnVpbGRlciA9IG9wdGlvbnMuYnVpbGRlciA/PyBuZXcgUHJvamVjdEJ1aWxkZXIoKVxuICAgIHRoaXMuI2Nvb3JkaW5hdG9yID0gb3B0aW9ucy5jb29yZGluYXRvciA/PyBuZXcgUHJvamVjdFdhdGNoQ29vcmRpbmF0b3Ioe2J1aWxkZXI6IHRoaXMuI2J1aWxkZXJ9KVxuICAgIHRoaXMuI3N0ZG91dCA9IG9wdGlvbnMuc3Rkb3V0ID8/IHByb2Nlc3Muc3Rkb3V0XG4gICAgdGhpcy4jc3RkZXJyID0gb3B0aW9ucy5zdGRlcnIgPz8gcHJvY2Vzcy5zdGRlcnJcbiAgfVxuXG4gIC8qKlxuICAgKiBSdW5zIG9uZSBjb21tYW5kIHdpdGhvdXQgbXV0YXRpbmcgcHJvY2VzcyBleGl0IHN0YXRlLlxuICAgKiBAcGFyYW0ge3JlYWRvbmx5IHN0cmluZ1tdfSBhcmd1bWVudHNfIC0gQXJndW1lbnRzIGFmdGVyIHRoZSBleGVjdXRhYmxlIG5hbWUuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPDAgfCAxPn0gRXhhY3QgcHJvY2VzcyBzdGF0dXMuXG4gICAqL1xuICBhc3luYyBydW4oYXJndW1lbnRzXykge1xuICAgIGNvbnN0IGhpbnRlZEZvcm1hdCA9IGFyZ3VtZW50c18uaW5jbHVkZXMoXCItLW5kanNvblwiKSA/IFwibmRqc29uXCIgOiBcImh1bWFuXCJcbiAgICBjb25zdCB3YXRjaEhpbnQgPSBhcmd1bWVudHNfWzBdID09IFwid2F0Y2hcIlxuICAgIGxldCByZXBvcnRlciA9IHdhdGNoSGludFxuICAgICAgPyBuZXcgUHJvamVjdFdhdGNoUmVwb3J0ZXIoe2Zvcm1hdDogaGludGVkRm9ybWF0LCBzdGRlcnI6IHRoaXMuI3N0ZGVyciwgc3Rkb3V0OiB0aGlzLiNzdGRvdXR9KVxuICAgICAgOiBuZXcgUHJvamVjdEJ1aWxkUmVwb3J0ZXIoe2Zvcm1hdDogaGludGVkRm9ybWF0LCBzdGRlcnI6IHRoaXMuI3N0ZGVyciwgc3Rkb3V0OiB0aGlzLiNzdGRvdXR9KVxuXG4gICAgdHJ5IHtcbiAgICAgIGNvbnN0IG9wdGlvbnMgPSBwYXJzZVNlbWFudGlmb2xkQ2xpQXJndW1lbnRzKGFyZ3VtZW50c18pXG4gICAgICBjb25zdCBjb21tYW5kID0gXCJjb21tYW5kXCIgaW4gb3B0aW9ucyA/IG9wdGlvbnMuY29tbWFuZCA6IFwiYnVpbGRcIlxuXG4gICAgICBpZiAob3B0aW9ucy5mb3JtYXQgIT0gaGludGVkRm9ybWF0KSB7XG4gICAgICAgIHJlcG9ydGVyID0gY29tbWFuZCA9PSBcIndhdGNoXCJcbiAgICAgICAgICA/IG5ldyBQcm9qZWN0V2F0Y2hSZXBvcnRlcih7Zm9ybWF0OiBvcHRpb25zLmZvcm1hdCwgc3RkZXJyOiB0aGlzLiNzdGRlcnIsIHN0ZG91dDogdGhpcy4jc3Rkb3V0fSlcbiAgICAgICAgICA6IG5ldyBQcm9qZWN0QnVpbGRSZXBvcnRlcih7Zm9ybWF0OiBvcHRpb25zLmZvcm1hdCwgc3RkZXJyOiB0aGlzLiNzdGRlcnIsIHN0ZG91dDogdGhpcy4jc3Rkb3V0fSlcbiAgICAgIH1cbiAgICAgIGlmIChjb21tYW5kID09IFwid2F0Y2hcIikge1xuICAgICAgICBjb25zdCByZXN1bHQgPSBhd2FpdCB0aGlzLiNjb29yZGluYXRvci5ydW4ob3B0aW9ucy5wcm9qZWN0UGF0aCwgLyoqIEB0eXBlIHtQcm9qZWN0V2F0Y2hSZXBvcnRlcn0gKi8gKHJlcG9ydGVyKSwge1xuICAgICAgICAgIGNoZWNrOiBvcHRpb25zLmNoZWNrXG4gICAgICAgIH0pXG5cbiAgICAgICAgcmV0dXJuIHJlc3VsdC5zdGF0dXMgPT0gXCJzdG9wcGVkXCIgPyAwIDogMVxuICAgICAgfVxuICAgICAgY29uc3QgY29udHJvbGxlciA9IG5ldyBBYm9ydENvbnRyb2xsZXIoKVxuICAgICAgY29uc3QgZm9yd2FyZFNpZ25hbCA9ICgpID0+IGNvbnRyb2xsZXIuYWJvcnQoXCJTZW1hbnRpZm9sZCBDTEkgcmVjZWl2ZWQgYSB0ZXJtaW5hdGlvbiBzaWduYWwuXCIpXG5cbiAgICAgIGlmIChvcHRpb25zLmNoZWNrKSB7XG4gICAgICAgIHByb2Nlc3Mub25jZShcIlNJR0lOVFwiLCBmb3J3YXJkU2lnbmFsKVxuICAgICAgICBwcm9jZXNzLm9uY2UoXCJTSUdURVJNXCIsIGZvcndhcmRTaWduYWwpXG4gICAgICB9XG4gICAgICBsZXQgcmVzdWx0XG5cbiAgICAgIHRyeSB7XG4gICAgICAgIHJlc3VsdCA9IGF3YWl0IHRoaXMuI2J1aWxkZXIuYnVpbGQob3B0aW9ucy5wcm9qZWN0UGF0aCwgLyoqIEB0eXBlIHtQcm9qZWN0QnVpbGRSZXBvcnRlcn0gKi8gKHJlcG9ydGVyKSwge1xuICAgICAgICAgIGNoZWNrOiBvcHRpb25zLmNoZWNrLFxuICAgICAgICAgIC4uLihvcHRpb25zLmNoZWNrID8ge3NpZ25hbDogY29udHJvbGxlci5zaWduYWx9IDoge30pXG4gICAgICAgIH0pXG4gICAgICB9IGZpbmFsbHkge1xuICAgICAgICBpZiAob3B0aW9ucy5jaGVjaykge1xuICAgICAgICAgIHByb2Nlc3MucmVtb3ZlTGlzdGVuZXIoXCJTSUdJTlRcIiwgZm9yd2FyZFNpZ25hbClcbiAgICAgICAgICBwcm9jZXNzLnJlbW92ZUxpc3RlbmVyKFwiU0lHVEVSTVwiLCBmb3J3YXJkU2lnbmFsKVxuICAgICAgICB9XG4gICAgICB9XG5cbiAgICAgIC8qKiBAdHlwZSB7UHJvamVjdEJ1aWxkUmVwb3J0ZXJ9ICovIChyZXBvcnRlcikuc3VjY2VlZGVkKHJlc3VsdClcblxuICAgICAgcmV0dXJuIDBcbiAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgaWYgKHJlcG9ydGVyIGluc3RhbmNlb2YgUHJvamVjdFdhdGNoUmVwb3J0ZXIpIHJlcG9ydGVyLndhdGNoRmFpbGVkKGVycm9yKVxuICAgICAgZWxzZSByZXBvcnRlci5mYWlsZWQoZXJyb3IpXG5cbiAgICAgIHJldHVybiAxXG4gICAgfVxuICB9XG59XG5cbi8qKlxuICogUGFyc2VzIHRoZSBpbnRlbnRpb25hbGx5IG5hcnJvdyBvbmUtc2hvdCBDTEkgZ3JhbW1hci5cbiAqIEBwYXJhbSB7cmVhZG9ubHkgc3RyaW5nW119IGFyZ3VtZW50c18gLSBBcmd1bWVudHMgYWZ0ZXIgdGhlIGV4ZWN1dGFibGUgbmFtZS5cbiAqIEByZXR1cm5zIHtSZWFkb25seTx7Y2hlY2s6IGJvb2xlYW4sIGZvcm1hdDogXCJodW1hblwiIHwgXCJuZGpzb25cIiwgcHJvamVjdFBhdGg6IHN0cmluZ30+IHwgUmVhZG9ubHk8e2NvbW1hbmQ6IFwid2F0Y2hcIiwgY2hlY2s6IGJvb2xlYW4sIGZvcm1hdDogXCJodW1hblwiIHwgXCJuZGpzb25cIiwgcHJvamVjdFBhdGg6IHN0cmluZ30+fSBWYWxpZGF0ZWQgY29tbWFuZCBvcHRpb25zLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcGFyc2VTZW1hbnRpZm9sZENsaUFyZ3VtZW50cyhhcmd1bWVudHNfKSB7XG4gIGlmICghQXJyYXkuaXNBcnJheShhcmd1bWVudHNfKSB8fCBhcmd1bWVudHNfLmxlbmd0aCA9PSAwIHx8IGFyZ3VtZW50c19bMF0gIT0gXCJidWlsZFwiICYmIGFyZ3VtZW50c19bMF0gIT0gXCJ3YXRjaFwiKSB7XG4gICAgaW52YWxpZEFyZ3VtZW50cyhcIkV4cGVjdGVkIHRoZSBjb21tYW5kICdzZW1hbnRpZm9sZCBidWlsZCcgb3IgJ3NlbWFudGlmb2xkIHdhdGNoJy5cIilcbiAgfVxuICBjb25zdCBjb21tYW5kID0gLyoqIEB0eXBlIHtcImJ1aWxkXCIgfCBcIndhdGNoXCJ9ICovIChhcmd1bWVudHNfWzBdKVxuICBsZXQgZm9ybWF0ID0gLyoqIEB0eXBlIHtcImh1bWFuXCIgfCBcIm5kanNvblwifSAqLyAoXCJodW1hblwiKVxuICBsZXQgcHJvamVjdFBhdGggPSBcIi4vc2VtYW50aWZvbGQuanNvblwiXG4gIGxldCBwcm9qZWN0U2VlbiA9IGZhbHNlXG4gIGxldCBuZGpzb25TZWVuID0gZmFsc2VcbiAgbGV0IGNoZWNrU2VlbiA9IGZhbHNlXG5cbiAgZm9yIChsZXQgaW5kZXggPSAxOyBpbmRleCA8IGFyZ3VtZW50c18ubGVuZ3RoOyBpbmRleCArPSAxKSB7XG4gICAgY29uc3QgYXJndW1lbnQgPSBhcmd1bWVudHNfW2luZGV4XVxuXG4gICAgaWYgKGFyZ3VtZW50ID09IFwiLS1jaGVja1wiKSB7XG4gICAgICBpZiAoY2hlY2tTZWVuKSBpbnZhbGlkQXJndW1lbnRzKFwiT3B0aW9uICctLWNoZWNrJyBtYXkgYmUgc3VwcGxpZWQgb25seSBvbmNlLlwiKVxuICAgICAgY2hlY2tTZWVuID0gdHJ1ZVxuICAgICAgY29udGludWVcbiAgICB9XG4gICAgaWYgKGFyZ3VtZW50ID09IFwiLS1uZGpzb25cIikge1xuICAgICAgaWYgKG5kanNvblNlZW4pIGludmFsaWRBcmd1bWVudHMoXCJPcHRpb24gJy0tbmRqc29uJyBtYXkgYmUgc3VwcGxpZWQgb25seSBvbmNlLlwiKVxuICAgICAgbmRqc29uU2VlbiA9IHRydWVcbiAgICAgIGZvcm1hdCA9IFwibmRqc29uXCJcbiAgICAgIGNvbnRpbnVlXG4gICAgfVxuICAgIGlmIChhcmd1bWVudCA9PSBcIi0tcHJvamVjdFwiKSB7XG4gICAgICBpZiAocHJvamVjdFNlZW4pIGludmFsaWRBcmd1bWVudHMoXCJPcHRpb24gJy0tcHJvamVjdCcgbWF5IGJlIHN1cHBsaWVkIG9ubHkgb25jZS5cIilcbiAgICAgIGNvbnN0IHZhbHVlID0gYXJndW1lbnRzX1tpbmRleCArIDFdXG5cbiAgICAgIGlmICh0eXBlb2YgdmFsdWUgIT0gXCJzdHJpbmdcIiB8fCB2YWx1ZS5sZW5ndGggPT0gMCB8fCB2YWx1ZS5zdGFydHNXaXRoKFwiLS1cIikpIHtcbiAgICAgICAgaW52YWxpZEFyZ3VtZW50cyhcIk9wdGlvbiAnLS1wcm9qZWN0JyByZXF1aXJlcyBvbmUgcGF0aCB2YWx1ZS5cIilcbiAgICAgIH1cbiAgICAgIHByb2plY3RTZWVuID0gdHJ1ZVxuICAgICAgcHJvamVjdFBhdGggPSB2YWx1ZVxuICAgICAgaW5kZXggKz0gMVxuICAgICAgY29udGludWVcbiAgICB9XG4gICAgaW52YWxpZEFyZ3VtZW50cyhgVW5rbm93biBjb21tYW5kIGFyZ3VtZW50ICcke2FyZ3VtZW50fScuYClcbiAgfVxuXG4gIHJldHVybiBjb21tYW5kID09IFwid2F0Y2hcIlxuICAgID8gT2JqZWN0LmZyZWV6ZSh7Y29tbWFuZCwgY2hlY2s6IGNoZWNrU2VlbiwgZm9ybWF0LCBwcm9qZWN0UGF0aH0pXG4gICAgOiBPYmplY3QuZnJlZXplKHtjaGVjazogY2hlY2tTZWVuLCBmb3JtYXQsIHByb2plY3RQYXRofSlcbn1cblxuLyoqXG4gKiBUaHJvd3Mgb25lIHN0YWJsZSBDTEkgZ3JhbW1hciBkaWFnbm9zdGljLlxuICogQHBhcmFtIHtzdHJpbmd9IG1lc3NhZ2UgLSBGYWlsdXJlIGRldGFpbC5cbiAqIEByZXR1cm5zIHtuZXZlcn0gQWx3YXlzIHRocm93cy5cbiAqL1xuZnVuY3Rpb24gaW52YWxpZEFyZ3VtZW50cyhtZXNzYWdlKSB7XG4gIHRocm93IG5ldyBTZW1hbnRpZm9sZERpYWdub3N0aWMoe1xuICAgIGNvZGU6IFwiSU5WQUxJRF9DTElfQVJHVU1FTlRTXCIsXG4gICAgbGFuZ3VhZ2U6IFwiY2xpXCIsXG4gICAgbWVzc2FnZVxuICB9KVxufVxuIl19

package/build/src/project-manifest.d.ts

@@ -0,0 +1,148 @@
+/**
+ * One validated immutable Semantifold project request.
+ */
+export declare class SemantifoldProject {
+    entryModule: string;
+    id: string;
+    manifestPath: string;
+    manifestText: string;
+    projectRoot: string;
+    publicationRoot: string;
+    sources: readonly Readonly<{
+        absolutePath: string;
+        entry: boolean;
+        id: string;
+        language: import("./semantic/types.js").SemanticLanguage;
+        path: string;
+    }>[];
+    targets: readonly Readonly<{
+        buildProjection: string;
+        id: string;
+        language: import("./semantic/types.js").BackendLanguage;
+        role: import("./semantic/types.js").PublicationTargetRole;
+        sourceProjection: string;
+    }>[];
+    version: 1;
+    /**
+     * Constructs a trusted normalized project value for the manifest loader.
+     * @param {NormalizedProject} value - Validated normalized fields.
+     */
+    constructor(value: NormalizedProject);
+}
+/**
+ * Loads and validates the strict versioned project-manifest boundary.
+ */
+export declare class ProjectManifestLoader {
+    /**
+     * Loads one project manifest without reading source content.
+     * @param {string} [projectPath] - Manifest path, relative to the process working directory or absolute.
+     * @returns {Promise<SemantifoldProject>} Immutable normalized project.
+     */
+    load(projectPath?: string): Promise<SemantifoldProject>;
+}
+export type NormalizedProjectSource = {
+    /**
+     * - Canonical project-absolute file path.
+     */
+    absolutePath: string;
+    /**
+     * - Whether this is the sole entry module.
+     */
+    entry: boolean;
+    /**
+     * - Stable semantic module identity.
+     */
+    id: string;
+    /**
+     * - Registered source language.
+     */
+    language: import("./semantic/types.js").SemanticLanguage;
+    /**
+     * - Canonical project-relative file path.
+     */
+    path: string;
+};
+export type NormalizedProjectTarget = {
+    /**
+     * - Generation-relative reserved build projection.
+     */
+    buildProjection: string;
+    /**
+     * - Stable project target identity.
+     */
+    id: string;
+    /**
+     * - Registered target identity.
+     */
+    language: import("./semantic/types.js").BackendLanguage;
+    /**
+     * - Explicit target role.
+     */
+    role: import("./semantic/types.js").PublicationTargetRole;
+    /**
+     * - Generation-relative generated-source projection.
+     */
+    sourceProjection: string;
+};
+export type NormalizedProject = {
+    /**
+     * - Sole entry module identity.
+     */
+    entryModule: string;
+    /**
+     * - Stable project identity.
+     */
+    id: string;
+    /**
+     * - Canonical absolute manifest path.
+     */
+    manifestPath: string;
+    /**
+     * - Exact validated manifest text.
+     */
+    manifestText: string;
+    /**
+     * - Canonical absolute project root.
+     */
+    projectRoot: string;
+    /**
+     * - Canonical absolute publication root.
+     */
+    publicationRoot: string;
+    /**
+     * - Ordered normalized sources.
+     */
+    sources: NormalizedProjectSource[];
+    /**
+     * - Ordered normalized targets.
+     */
+    targets: NormalizedProjectTarget[];
+};
+/**
+ * @typedef NormalizedProjectSource
+ * @property {string} absolutePath - Canonical project-absolute file path.
+ * @property {boolean} entry - Whether this is the sole entry module.
+ * @property {string} id - Stable semantic module identity.
+ * @property {import("./semantic/types.js").SemanticLanguage} language - Registered source language.
+ * @property {string} path - Canonical project-relative file path.
+ */
+/**
+ * @typedef NormalizedProjectTarget
+ * @property {string} buildProjection - Generation-relative reserved build projection.
+ * @property {string} id - Stable project target identity.
+ * @property {import("./semantic/types.js").BackendLanguage} language - Registered target identity.
+ * @property {import("./semantic/types.js").PublicationTargetRole} role - Explicit target role.
+ * @property {string} sourceProjection - Generation-relative generated-source projection.
+ */
+/**
+ * @typedef NormalizedProject
+ * @property {string} entryModule - Sole entry module identity.
+ * @property {string} id - Stable project identity.
+ * @property {string} manifestPath - Canonical absolute manifest path.
+ * @property {string} manifestText - Exact validated manifest text.
+ * @property {string} projectRoot - Canonical absolute project root.
+ * @property {string} publicationRoot - Canonical absolute publication root.
+ * @property {NormalizedProjectSource[]} sources - Ordered normalized sources.
+ * @property {NormalizedProjectTarget[]} targets - Ordered normalized targets.
+ */
+//# sourceMappingURL=project-manifest.d.ts.map

package/build/src/project-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manifest.d.ts","sourceRoot":"","sources":["../../src/project-manifest.js"],"names":[],"mappings":"AA4BA;;GAEG;AACH,qBAAa,kBAAkB;IAMtB,WAAW;IACX,EAAE;IACF,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,eAAe;IACf,OAAO;sBAyZF,MAAM;eACN,OAAO;YACP,MAAM;kBACN,OAAO,qBAAqB,EAAE,gBAAgB;cAC9C,MAAM;;IA5ZX,OAAO;yBAiaF,MAAM;YACN,MAAM;kBACN,OAAO,qBAAqB,EAAE,eAAe;cAC7C,OAAO,qBAAqB,EAAE,qBAAqB;0BACnD,MAAM;;IApaX,OAAO;IAbd;;;OAGG;IACH,YAAY,KAAK,EAFN,iBAEM,EAWhB;CACF;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;;;OAIG;IACG,IAAI,CAAC,WAAW,AAHnB,CACA,EADQ,MAGkC,GAFhC,OAAO,CAAC,kBAAkB,CAAC,CAkCvC;CACF;AAuWE,YAAS,uBAAuB,GAChC;;;;IAAmB,YAAY,EAApB,MAAM,CACjB;;;;IAAoB,KAAK,EAAd,OAAO,CAClB;;;;IAAmB,EAAE,EAAV,MAAM,CACjB;;;;IAA2D,QAAQ,EAAxD,OAAO,qBAAqB,EAAE,gBAAgB,CACzD;;;;IAAmB,IAAI,EAAZ,MAAM,CACnB;CAAA,CAAA;AAGE,YAAS,uBAAuB,GAChC;;;;IAAmB,eAAe,EAAvB,MAAM,CACjB;;;;IAAmB,EAAE,EAAV,MAAM,CACjB;;;;IAA0D,QAAQ,EAAvD,OAAO,qBAAqB,EAAE,eAAe,CACxD;;;;IAAgE,IAAI,EAAzD,OAAO,qBAAqB,EAAE,qBAAqB,CAC9D;;;;IAAmB,gBAAgB,EAAxB,MAAM,CACnB;CAAA,CAAA;AAGE,YAAS,iBAAiB,GAC1B;;;;IAAmB,WAAW,EAAnB,MAAM,CACjB;;;;IAAmB,EAAE,EAAV,MAAM,CACjB;;;;IAAmB,YAAY,EAApB,MAAM,CACjB;;;;IAAmB,YAAY,EAApB,MAAM,CACjB;;;;IAAmB,WAAW,EAAnB,MAAM,CACjB;;;;IAAmB,eAAe,EAAvB,MAAM,CACjB;;;;IAAsC,OAAO,EAAlC,uBAAuB,EAAE,CACpC;;;;IAAsC,OAAO,EAAlC,uBAAuB,EAAE,CACtC;CAAA,CAAA;AA5BD;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;GAUG"}