silvermoon 0.3.0-rc.2 → 0.4.0

package/dist/src/foundation/owned-write/writer.js

@@ -0,0 +1,244 @@
+import { lstat, mkdir, readFile, rm, rmdir, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { isValidUlid } from "../idea-model/index.js";
+import { IDEAS_ROOT, ideaPaths } from "../coordinates/index.js";
+import { buildIdeaScaffold } from "../scaffold-plan/index.js";
+const MAX_ID_ATTEMPTS = 32;
+function hasErrorCode(caught, code) {
+    return caught instanceof Error && "code" in caught && caught.code === code;
+}
+function errorMessage(caught) {
+    return caught instanceof Error ? caught.message : String(caught);
+}
+export async function pathExists(path, inspect) {
+    try {
+        await inspect(path);
+        return true;
+    }
+    catch (caught) {
+        if (hasErrorCode(caught, "ENOENT"))
+            return false;
+        throw caught;
+    }
+}
+export async function removeOwnedFile(path, expected, read, remove) {
+    let current;
+    try {
+        current = await read(path);
+    }
+    catch (caught) {
+        if (hasErrorCode(caught, "ENOENT")) {
+            return { path, status: "missing" };
+        }
+        throw caught;
+    }
+    const expectedBytes = Buffer.from(expected);
+    if (current.equals(expectedBytes)) {
+        await remove(path, { force: true });
+        return { path, status: "removed" };
+    }
+    return { path, status: "preserved-modified" };
+}
+export async function removeCreatedDirectories(created, removeDirectory) {
+    const results = [];
+    for (const path of [...created].reverse()) {
+        try {
+            await removeDirectory(path);
+            results.push({ path, status: "removed" });
+        }
+        catch (caught) {
+            results.push({ path, status: "preserved", error: errorMessage(caught) });
+        }
+    }
+    return results;
+}
+export async function ensureDirectoryPath(root, relativePath, operations) {
+    const created = [];
+    let current = root;
+    try {
+        for (const segment of relativePath.split("/")) {
+            current = resolve(current, segment);
+            let metadata;
+            try {
+                metadata = await operations.inspect(current);
+            }
+            catch (caught) {
+                if (!hasErrorCode(caught, "ENOENT"))
+                    throw caught;
+            }
+            if (metadata) {
+                if (!metadata.isDirectory() || metadata.isSymbolicLink()) {
+                    throw new Error(`Silvermoon path segment is not a regular directory: ${current}`);
+                }
+                continue;
+            }
+            try {
+                await operations.makeDirectory(current);
+                created.push(current);
+            }
+            catch (caught) {
+                if (!hasErrorCode(caught, "EEXIST"))
+                    throw caught;
+                metadata = await operations.inspect(current);
+                if (!metadata.isDirectory() || metadata.isSymbolicLink())
+                    throw caught;
+            }
+        }
+        return created;
+    }
+    catch (caught) {
+        throw Object.assign(caught instanceof Error ? caught : new Error(String(caught)), { createdDirectories: created });
+    }
+}
+export function cleanupSummary(results) {
+    const preserved = results.filter(({ status }) => status.startsWith("preserved"));
+    return preserved.length === 0
+        ? "All paths still owned by this operation were removed."
+        : `Preserved ${preserved.length} path(s) because they changed or could not be removed: `
+            + preserved.map(({ path }) => path).join(", ");
+}
+export function cleanupResult(results) {
+    return {
+        removed: results.filter(({ status }) => status === "removed").length,
+        preserved: results.filter(({ status }) => status.startsWith("preserved")).length,
+        items: results,
+    };
+}
+export function withCleanupPlan(caught, cleanupPlan) {
+    const error = caught instanceof Error ? caught : new Error(String(caught));
+    return Object.assign(error, { cleanupPlan });
+}
+export async function cleanupScaffold(cleanupPlan, operations = {}) {
+    const read = operations.readFile ?? readFile;
+    const remove = operations.rm ?? rm;
+    const removeDirectory = operations.rmdir ?? rmdir;
+    const results = [];
+    for (const [path, source] of [...cleanupPlan.cleanupFiles].reverse()) {
+        try {
+            results.push(await removeOwnedFile(path, source, read, remove));
+        }
+        catch (caught) {
+            results.push({
+                path,
+                status: "preserved",
+                error: errorMessage(caught),
+            });
+        }
+    }
+    results.push(...await removeCreatedDirectories(cleanupPlan.createdDirectories, removeDirectory));
+    if (cleanupPlan.collisionPath) {
+        results.push({
+            path: cleanupPlan.collisionPath,
+            status: "preserved-existing",
+        });
+    }
+    results.push(...await removeCreatedDirectories(cleanupPlan.rootDirectories, removeDirectory));
+    return cleanupResult(results);
+}
+export async function createScaffold({ canonicalLanguage, contentLanguage, formatVersion, generateId, operations, repositoryRoot, }) {
+    operations ??= {};
+    const inspect = operations.lstat ?? lstat;
+    const makeDirectory = operations.mkdir ?? mkdir;
+    const write = operations.writeFile ?? writeFile;
+    const fileOperations = {
+        inspect,
+        makeDirectory,
+    };
+    let rootDirectories;
+    try {
+        rootDirectories = await ensureDirectoryPath(repositoryRoot, IDEAS_ROOT, fileOperations);
+    }
+    catch (caught) {
+        throw withCleanupPlan(caught, {
+            cleanupFiles: [],
+            collisionPath: null,
+            createdDirectories: [],
+            rootDirectories: caught instanceof Error
+                && "createdDirectories" in caught
+                && Array.isArray(caught.createdDirectories)
+                ? caught.createdDirectories.filter((path) => typeof path === "string")
+                : [],
+        });
+    }
+    for (let attempt = 0; attempt < MAX_ID_ATTEMPTS; attempt += 1) {
+        let id;
+        let paths;
+        let folder;
+        try {
+            id = await generateId();
+            if (!isValidUlid(id)) {
+                throw new Error(`Generated idea id is not a canonical ULID: ${id}`);
+            }
+            paths = ideaPaths(id);
+            folder = resolve(repositoryRoot, paths.ideaPath);
+            if (await pathExists(folder, inspect))
+                continue;
+        }
+        catch (caught) {
+            throw withCleanupPlan(caught, {
+                cleanupFiles: [],
+                collisionPath: null,
+                createdDirectories: [],
+                rootDirectories,
+            });
+        }
+        const { directoryPaths, files } = buildIdeaScaffold({
+            id,
+            ...(canonicalLanguage === undefined ? {} : { canonicalLanguage }),
+            contentLanguage,
+            formatVersion,
+        });
+        const createdDirectories = [];
+        const cleanupFiles = [];
+        let collisionPath = null;
+        try {
+            for (const relativePath of directoryPaths) {
+                const absolutePath = resolve(repositoryRoot, relativePath);
+                await makeDirectory(absolutePath);
+                createdDirectories.push(absolutePath);
+            }
+            for (const file of files) {
+                const [relativePath, source] = file;
+                if (typeof relativePath !== "string" || typeof source !== "string") {
+                    throw new Error("Invalid scaffold file plan.");
+                }
+                const absolutePath = resolve(repositoryRoot, relativePath);
+                const cleanup = [absolutePath, source];
+                cleanupFiles.push(cleanup);
+                try {
+                    await write(absolutePath, source, { flag: "wx" });
+                }
+                catch (caught) {
+                    if (hasErrorCode(caught, "EEXIST")) {
+                        cleanupFiles.pop();
+                        collisionPath = absolutePath;
+                    }
+                    throw caught;
+                }
+            }
+            return {
+                createdIdea: {
+                    id,
+                    path: paths.ideaPath,
+                    state: "preparing",
+                },
+                paths,
+            };
+        }
+        catch (caught) {
+            throw withCleanupPlan(caught, {
+                cleanupFiles,
+                collisionPath,
+                createdDirectories,
+                rootDirectories,
+            });
+        }
+    }
+    throw withCleanupPlan(new Error(`Could not allocate a unique idea id after ${MAX_ID_ATTEMPTS} attempts.`), {
+        cleanupFiles: [],
+        collisionPath: null,
+        createdDirectories: [],
+        rootDirectories,
+    });
+}
+//# sourceMappingURL=writer.js.map

package/dist/src/foundation/owned-write/writer.js.map

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

package/dist/src/foundation/package-resource/index.d.ts

@@ -0,0 +1,2 @@
+export { inspectNpmTarball, readNpmTarballEntries, requiredEntry, } from "./npm-tarball.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/package-resource/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/package-resource/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/src/foundation/package-resource/index.js

@@ -0,0 +1,2 @@
+export { inspectNpmTarball, readNpmTarballEntries, requiredEntry, } from "./npm-tarball.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/package-resource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/package-resource/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/src/foundation/package-resource/npm-tarball.d.ts

@@ -0,0 +1,15 @@
+import type { InputType } from "node:zlib";
+export declare function readNpmTarballEntries(tarballBytes: NonSharedBuffer | InputType): Map<string, Buffer<ArrayBufferLike>>;
+export declare function requiredEntry(entries: ReadonlyMap<string, Buffer>, path: string): Buffer<ArrayBufferLike>;
+export declare function inspectNpmTarball(tarballPath: string): Promise<{
+    bytes: NonSharedBuffer;
+    entries: Map<string, Buffer<ArrayBufferLike>>;
+    fileCount: number;
+    integrity: string;
+    manifest: any;
+    sha256: string;
+    sha512: string;
+    shasum: string;
+    tarballPath: string;
+}>;
+//# sourceMappingURL=npm-tarball.d.ts.map

package/dist/src/foundation/package-resource/npm-tarball.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-tarball.d.ts","sourceRoot":"","sources":["../../../../src/foundation/package-resource/npm-tarball.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAgD3C,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,eAAe,GAAC,SAAS,wCAuD5E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,2BAI/E;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;GAwB1D"}

package/dist/src/foundation/package-resource/npm-tarball.js

@@ -0,0 +1,124 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { gunzipSync } from "node:zlib";
+function digest(algorithm, bytes, encoding) {
+    return createHash(algorithm).update(bytes).digest(encoding);
+}
+function readTarString(buffer, offset, length) {
+    const field = buffer.subarray(offset, offset + length);
+    const end = field.indexOf(0);
+    return field.subarray(0, end === -1 ? field.length : end).toString("utf8");
+}
+function readTarSize(buffer, offset) {
+    const field = readTarString(buffer, offset, 12).trim();
+    if (!/^[0-7]+$/.test(field)) {
+        throw new Error(`Unsupported tar entry size: ${field || "(empty)"}.`);
+    }
+    return Number.parseInt(field, 8);
+}
+function parsePaxHeader(buffer) {
+    const values = {};
+    let offset = 0;
+    while (offset < buffer.length) {
+        const separator = buffer.indexOf(0x20, offset);
+        if (separator === -1)
+            throw new Error("Malformed PAX header length.");
+        const length = Number.parseInt(buffer.subarray(offset, separator).toString("ascii"), 10);
+        if (!Number.isSafeInteger(length) || length <= 0 || offset + length > buffer.length) {
+            throw new Error("Malformed PAX header record.");
+        }
+        const record = buffer
+            .subarray(separator + 1, offset + length - 1)
+            .toString("utf8");
+        const equals = record.indexOf("=");
+        if (equals === -1)
+            throw new Error("Malformed PAX header value.");
+        values[record.slice(0, equals)] = record.slice(equals + 1);
+        offset += length;
+    }
+    return values;
+}
+export function readNpmTarballEntries(tarballBytes) {
+    let archive;
+    try {
+        archive = gunzipSync(tarballBytes);
+    }
+    catch (error) {
+        throw new Error(`Could not decompress npm tarball: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const entries = new Map();
+    let offset = 0;
+    let pendingPath;
+    while (offset + 512 <= archive.length) {
+        const header = archive.subarray(offset, offset + 512);
+        if (header.every((byte) => byte === 0))
+            break;
+        const name = readTarString(header, 0, 100);
+        const prefix = readTarString(header, 345, 155);
+        const headerPath = prefix ? `${prefix}/${name}` : name;
+        const type = String.fromCharCode(header[156] || 0);
+        const size = readTarSize(header, 124);
+        const contentStart = offset + 512;
+        const contentEnd = contentStart + size;
+        if (contentEnd > archive.length) {
+            throw new Error(`Truncated tar entry: ${headerPath}.`);
+        }
+        const content = archive.subarray(contentStart, contentEnd);
+        offset = contentStart + Math.ceil(size / 512) * 512;
+        if (type === "x") {
+            pendingPath = parsePaxHeader(content).path;
+            continue;
+        }
+        if (type === "L") {
+            pendingPath = readTarString(content, 0, content.length);
+            continue;
+        }
+        const path = pendingPath ?? headerPath;
+        pendingPath = undefined;
+        if (type !== "\0" && type !== "0")
+            continue;
+        if (!path.startsWith("package/")) {
+            throw new Error(`Unexpected npm tarball path: ${path}.`);
+        }
+        const packagePath = path.slice("package/".length);
+        if (!packagePath || entries.has(packagePath)) {
+            throw new Error(`Duplicate or empty npm tarball path: ${path}.`);
+        }
+        entries.set(packagePath, Buffer.from(content));
+    }
+    if (entries.size === 0) {
+        throw new Error("npm tarball does not contain package files.");
+    }
+    return entries;
+}
+export function requiredEntry(entries, path) {
+    const entry = entries.get(path);
+    if (!entry)
+        throw new Error(`npm tarball is missing ${path}.`);
+    return entry;
+}
+export async function inspectNpmTarball(tarballPath) {
+    const resolvedPath = resolve(tarballPath);
+    const bytes = await readFile(resolvedPath);
+    const entries = readNpmTarballEntries(bytes);
+    let manifest;
+    try {
+        manifest = JSON.parse(requiredEntry(entries, "package.json").toString("utf8"));
+    }
+    catch (error) {
+        throw new Error(`Could not parse package.json from npm tarball: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return {
+        bytes,
+        entries,
+        fileCount: entries.size,
+        integrity: `sha512-${digest("sha512", bytes, "base64")}`,
+        manifest,
+        sha256: digest("sha256", bytes, "hex"),
+        sha512: digest("sha512", bytes, "hex"),
+        shasum: digest("sha1", bytes, "hex"),
+        tarballPath: resolvedPath,
+    };
+}
+//# sourceMappingURL=npm-tarball.js.map

package/dist/src/foundation/package-resource/npm-tarball.js.map

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

package/dist/src/foundation/process/index.d.ts

@@ -0,0 +1,3 @@
+export { npmCommand, } from "./npm-command.ts";
+export { runSubprocess, } from "./subprocess.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/process/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/src/foundation/process/index.js

@@ -0,0 +1,3 @@
+export { npmCommand, } from "./npm-command.js";
+export { runSubprocess, } from "./subprocess.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/process/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/src/foundation/process/npm-command.d.ts

@@ -0,0 +1,9 @@
+export declare function npmCommand(args: string[], { platform, execPath, env, }?: {
+    platform?: NodeJS.Platform | undefined;
+    execPath?: string | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+}): {
+    command: string;
+    args: string[];
+};
+//# sourceMappingURL=npm-command.d.ts.map

package/dist/src/foundation/process/npm-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-command.d.ts","sourceRoot":"","sources":["../../../../src/foundation/process/npm-command.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EACzC,QAA2B,EAC3B,QAA2B,EAC3B,GAAiB,GAClB;;;;CAAK;;;EAOL"}

package/dist/src/foundation/process/npm-command.js

@@ -0,0 +1,11 @@
+import { win32 } from "node:path";
+export function npmCommand(args, { platform = process.platform, execPath = process.execPath, env = process.env, } = {}) {
+    if (platform !== "win32")
+        return { command: "npm", args };
+    const configured = env.npm_execpath;
+    const npmCli = configured && /^npm-cli\.js$/i.test(win32.basename(configured))
+        ? configured
+        : win32.resolve(win32.dirname(execPath), "node_modules", "npm", "bin", "npm-cli.js");
+    return { command: execPath, args: [npmCli, ...args] };
+}
+//# sourceMappingURL=npm-command.js.map

package/dist/src/foundation/process/npm-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-command.js","sourceRoot":"","sources":["../../../../src/foundation/process/npm-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,UAAU,CAAC,IAAc,EAAE,EACzC,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAC3B,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAC3B,GAAG,GAAG,OAAO,CAAC,GAAG,GAClB,GAAG,EAAE;IACJ,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC1D,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC;IACpC,MAAM,MAAM,GAAG,UAAU,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5E,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IACvF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/dist/src/foundation/process/subprocess.d.ts

@@ -0,0 +1,8 @@
+import { spawnSync } from "node:child_process";
+import type { SpawnSyncOptionsWithStringEncoding } from "node:child_process";
+export declare function runSubprocess(command: string, args: readonly string[], options: SpawnSyncOptionsWithStringEncoding, { attributes, spanName, spawn, }?: {
+    attributes?: Record<string, unknown>;
+    spanName?: string;
+    spawn?: typeof spawnSync;
+}): import("child_process").SpawnSyncReturns<string>;
+//# sourceMappingURL=subprocess.d.ts.map

package/dist/src/foundation/process/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../../../src/foundation/process/subprocess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,oBAAoB,CAAC;AAI7E,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,kCAAkC,EAC3C,EACE,UAAe,EACf,QAA4B,EAC5B,KAAiB,GAClB,GAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,SAAS,CAAC;CACrB,oDAcP"}

package/dist/src/foundation/process/subprocess.js

@@ -0,0 +1,12 @@
+import { spawnSync } from "node:child_process";
+import { traceSync } from "../trace/index.js";
+export function runSubprocess(command, args, options, { attributes = {}, spanName = "process.command", spawn = spawnSync, } = {}) {
+    return traceSync(spanName, attributes, () => spawn(command, args, options), (completed) => ({
+        attributes: {
+            exitCode: completed.status,
+            signal: completed.signal,
+        },
+        status: completed.status === 0 ? "ok" : "error",
+    }));
+}
+//# sourceMappingURL=subprocess.js.map

package/dist/src/foundation/process/subprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.js","sourceRoot":"","sources":["../../../../src/foundation/process/subprocess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,IAAuB,EACvB,OAA2C,EAC3C,EACE,UAAU,GAAG,EAAE,EACf,QAAQ,GAAG,iBAAiB,EAC5B,KAAK,GAAG,SAAS,MAKf,EAAE;IAEN,OAAO,SAAS,CACd,QAAQ,EACR,UAAU,EACV,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,EACnC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,SAAS,CAAC,MAAM;YAC1B,MAAM,EAAE,SAAS,CAAC,MAAM;SACzB;QACD,MAAM,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;KAChD,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/src/foundation/project-config/config.d.ts

@@ -0,0 +1,30 @@
+export { serializeConfig, validPrimaryBranch } from "./rules.ts";
+export declare const DEFAULT_CONFIG_NAME = ".silvermoon/config.yaml";
+interface FileMetadata {
+    isDirectory(): boolean;
+    isFile(): boolean;
+    isSymbolicLink(): boolean;
+}
+interface ConfigFilesystem {
+    lstat(path: string): Promise<FileMetadata>;
+    readFile(path: string, encoding: "utf8"): Promise<string>;
+}
+interface LoadConfigOptions {
+    filesystem?: ConfigFilesystem;
+    root: string;
+}
+interface LoadConfigSnapshotOptions {
+    gitRoot: string;
+    tree: string;
+}
+export declare function loadConfig({ filesystem, root, }: LoadConfigOptions): Promise<{
+    config: import("./rules.ts").ProjectConfig | null;
+    configPath: string;
+    diagnostics: import("./rules.ts").ConfigDiagnostic[];
+}>;
+export declare function loadConfigSnapshot({ gitRoot, tree, }: LoadConfigSnapshotOptions): Promise<{
+    config: import("./rules.ts").ProjectConfig | null;
+    configPath: string;
+    diagnostics: import("./rules.ts").ConfigDiagnostic[];
+}>;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/foundation/project-config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/foundation/project-config/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKjE,eAAO,MAAM,mBAAmB,4BAAc,CAAC;AAI/C,UAAU,YAAY;IACpB,WAAW,IAAI,OAAO,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC;IAClB,cAAc,IAAI,OAAO,CAAC;CAC3B;AAED,UAAU,gBAAgB;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAED,UAAU,iBAAiB;IACzB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,yBAAyB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAiED,wBAAsB,UAAU,CAAC,EAC/B,UAA+B,EAC/B,IAAI,GACL,EAAE,iBAAiB;;;;GAcnB;AAED,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,EACP,IAAI,GACL,EAAE,yBAAyB;;;;GA8C3B"}