silvermoon 0.3.0-rc.2 → 0.4.0

package/dist/src/foundation/installation/installation.d.ts

@@ -0,0 +1,25 @@
+import { access, readFile, realpath } from "node:fs/promises";
+interface InstallationFileSystem {
+    access: typeof access;
+    readFile: typeof readFile;
+    realpath: typeof realpath;
+}
+interface InspectInstallationOptions {
+    entryPath?: string;
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    filesystem?: InstallationFileSystem;
+}
+export type RuntimeSource = "global" | "host" | "source-checkout";
+export declare function classifyRuntimeSource(entryPath: string | undefined, globalExecutable: string | null, executable?: string | null): RuntimeSource;
+export declare function inspectInstallation({ entryPath, env, platform, filesystem, }?: InspectInstallationOptions): Promise<{
+    globalInstallationPresent: boolean;
+    versionError?: string;
+    source: RuntimeSource;
+    entry: string;
+    executable: string | null;
+    packageRoot: string;
+    version: string | null;
+}>;
+export {};
+//# sourceMappingURL=installation.d.ts.map

package/dist/src/foundation/installation/installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../../../src/foundation/installation/installation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI9D,UAAU,sBAAsB;IAC9B,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,QAAQ,EAAE,OAAO,QAAQ,CAAC;CAC3B;AAED,UAAU,0BAA0B;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAwClE,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,aAAa,CAQf;AA8DD,wBAAsB,mBAAmB,CAAC,EACxC,SAAS,EACT,GAAiB,EACjB,QAA2B,EAC3B,UAA2C,GAC5C,GAAE,0BAA+B;;;;;;;;GAiCjC"}

package/dist/src/foundation/installation/installation.js

@@ -0,0 +1,125 @@
+import { access, readFile, realpath } from "node:fs/promises";
+import { delimiter, dirname, extname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const packageRoot = fileURLToPath(new URL(import.meta.url.endsWith(".ts") ? "../../.." : "../../../..", import.meta.url));
+const packageManifest = resolve(packageRoot, "package.json");
+const packageEntry = resolve(packageRoot, import.meta.url.endsWith(".ts")
+    ? "bin/silvermoon.ts"
+    : "dist/bin/silvermoon.js");
+function errorCode(caught) {
+    return caught instanceof Error && "code" in caught && typeof caught.code === "string"
+        ? caught.code
+        : undefined;
+}
+async function firstExecutable(paths, names, filesystem) {
+    for (const directory of paths) {
+        for (const name of names) {
+            const candidate = join(directory, name);
+            try {
+                await filesystem.access(candidate);
+                return resolve(candidate);
+            }
+            catch (error) {
+                const code = errorCode(error);
+                if (code !== "ENOENT" && code !== "EACCES")
+                    throw error;
+            }
+        }
+    }
+    return null;
+}
+export function classifyRuntimeSource(entryPath, globalExecutable, executable) {
+    const entry = resolve(entryPath ?? "").replaceAll("\\", "/").toLowerCase();
+    const global = globalExecutable?.replaceAll("\\", "/").toLowerCase();
+    const command = executable?.replaceAll("\\", "/").toLowerCase();
+    if (command?.includes("/node_modules/.bin/"))
+        return "host";
+    if (global && entry === global)
+        return "global";
+    if (entry.includes("/node_modules/silvermoon/"))
+        return "host";
+    return "source-checkout";
+}
+async function resolvedPath(path, filesystem) {
+    try {
+        return await filesystem.realpath(path);
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT" || errorCode(error) === "EACCES") {
+            return resolve(path);
+        }
+        throw error;
+    }
+}
+async function globalRuntimeEntry(executable, platform, filesystem) {
+    if (!executable)
+        return null;
+    const physicalExecutable = await resolvedPath(executable, filesystem);
+    if (platform !== "win32" || extname(physicalExecutable) === ".js") {
+        return physicalExecutable;
+    }
+    const candidates = [];
+    if (extname(executable).toLowerCase() === ".cmd") {
+        try {
+            const shim = await filesystem.readFile(executable, "utf8");
+            for (const match of shim.matchAll(/"([^"\r\n]*silvermoon\.js)"/gi)) {
+                const target = match[1];
+                if (target === undefined)
+                    continue;
+                candidates.push(resolve(target.replace(/%~?dp0%?/gi, `${dirname(executable)}\\`)));
+            }
+        }
+        catch (error) {
+            const code = errorCode(error);
+            if (code !== "ENOENT" && code !== "EACCES")
+                throw error;
+        }
+    }
+    candidates.push(resolve(dirname(executable), "node_modules", "silvermoon", "dist", "bin", "silvermoon.js"));
+    for (const candidate of candidates) {
+        try {
+            await filesystem.access(candidate);
+            return resolvedPath(candidate, filesystem);
+        }
+        catch (error) {
+            const code = errorCode(error);
+            if (code !== "ENOENT" && code !== "EACCES")
+                throw error;
+        }
+    }
+    return physicalExecutable;
+}
+export async function inspectInstallation({ entryPath, env = process.env, platform = process.platform, filesystem = { access, readFile, realpath }, } = {}) {
+    const runningEntry = entryPath ?? packageEntry;
+    const paths = (env.PATH ?? "").split(delimiter).filter(Boolean);
+    const names = platform === "win32"
+        ? ["silvermoon.cmd", "silvermoon.exe", "silvermoon"]
+        : ["silvermoon"];
+    const executable = await firstExecutable(paths, names, filesystem);
+    const [entry, globalEntry] = await Promise.all([
+        resolvedPath(runningEntry, filesystem),
+        globalRuntimeEntry(executable, platform, filesystem),
+    ]);
+    let version = null;
+    let versionError;
+    try {
+        const manifest = JSON.parse(await filesystem.readFile(packageManifest, "utf8"));
+        version = manifest !== null && typeof manifest === "object"
+            && "version" in manifest && typeof manifest.version === "string"
+            ? manifest.version
+            : null;
+    }
+    catch (error) {
+        versionError = error instanceof Error ? error.message : String(error);
+    }
+    return {
+        source: classifyRuntimeSource(entry, globalEntry, executable),
+        entry,
+        executable,
+        packageRoot,
+        version,
+        ...(versionError === undefined ? {} : { versionError }),
+        globalInstallationPresent: executable !== null,
+    };
+}
+//# sourceMappingURL=installation.js.map

package/dist/src/foundation/installation/installation.js.map

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

package/dist/src/foundation/installation/rules.d.ts

@@ -0,0 +1,12 @@
+interface SemanticVersion {
+    major: string;
+    minor: string;
+    patch: string;
+    prerelease: string[];
+}
+/** @pure */
+export declare function parseSemanticVersion(value: unknown): SemanticVersion | null;
+/** @pure */
+export declare function compareSemanticVersions(left: unknown, right: unknown): 1 | -1 | 0 | null;
+export {};
+//# sourceMappingURL=rules.d.ts.map

package/dist/src/foundation/installation/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/foundation/installation/rules.ts"],"names":[],"mappings":"AAAA,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAKD,YAAY;AACZ,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAe3E;AAQD,YAAY;AACZ,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,qBAkCpE"}

package/dist/src/foundation/installation/rules.js

@@ -0,0 +1,63 @@
+const SEMVER_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|[0-9]*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+/** @pure */
+export function parseSemanticVersion(value) {
+    if (typeof value !== "string")
+        return null;
+    const match = SEMVER_PATTERN.exec(value);
+    const major = match?.[1];
+    const minor = match?.[2];
+    const patch = match?.[3];
+    if (major === undefined || minor === undefined || patch === undefined) {
+        return null;
+    }
+    return {
+        major,
+        minor,
+        patch,
+        prerelease: match?.[4]?.split(".") ?? [],
+    };
+}
+/** @pure */
+function compareNumericIdentifiers(left, right) {
+    if (left.length !== right.length)
+        return left.length < right.length ? -1 : 1;
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** @pure */
+export function compareSemanticVersions(left, right) {
+    const leftVersion = parseSemanticVersion(left);
+    const rightVersion = parseSemanticVersion(right);
+    if (!leftVersion || !rightVersion)
+        return null;
+    for (const field of ["major", "minor", "patch"]) {
+        const comparison = compareNumericIdentifiers(leftVersion[field], rightVersion[field]);
+        if (comparison !== 0)
+            return comparison;
+    }
+    if (leftVersion.prerelease.length === 0) {
+        return rightVersion.prerelease.length === 0 ? 0 : 1;
+    }
+    if (rightVersion.prerelease.length === 0)
+        return -1;
+    const length = Math.max(leftVersion.prerelease.length, rightVersion.prerelease.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftPart = leftVersion.prerelease[index];
+        const rightPart = rightVersion.prerelease[index];
+        if (leftPart === undefined)
+            return -1;
+        if (rightPart === undefined)
+            return 1;
+        if (leftPart === rightPart)
+            continue;
+        const leftNumeric = /^\d+$/.test(leftPart);
+        const rightNumeric = /^\d+$/.test(rightPart);
+        if (leftNumeric && rightNumeric) {
+            return compareNumericIdentifiers(leftPart, rightPart);
+        }
+        if (leftNumeric !== rightNumeric)
+            return leftNumeric ? -1 : 1;
+        return leftPart < rightPart ? -1 : 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=rules.js.map

package/dist/src/foundation/installation/rules.js.map

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

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

@@ -0,0 +1,3 @@
+export { DEFAULT_LANGUAGE, OUTPUT_LANGUAGES, canonicalizeLanguageTag, canonicalizeOutputLanguage, isCanonicalLanguageTag, isChinese, localize, resolveContentTemplateLanguage, resolveLanguage, resolveOutputLanguage, } from "./language.ts";
+export type { OutputLanguage } from "./language.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/language/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,8BAA8B,EAC9B,eAAe,EACf,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,2 @@
+export { DEFAULT_LANGUAGE, OUTPUT_LANGUAGES, canonicalizeLanguageTag, canonicalizeOutputLanguage, isCanonicalLanguageTag, isChinese, localize, resolveContentTemplateLanguage, resolveLanguage, resolveOutputLanguage, } from "./language.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/language/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,8BAA8B,EAC9B,eAAe,EACf,qBAAqB,GACtB,MAAM,eAAe,CAAC"}

package/dist/src/foundation/language/language.d.ts

@@ -0,0 +1,36 @@
+export declare const DEFAULT_LANGUAGE = "en-US";
+export declare const OUTPUT_LANGUAGES: readonly ["en-US", "zh-CN"];
+export type OutputLanguage = (typeof OUTPUT_LANGUAGES)[number];
+/** @pure */
+export declare function isChinese(language: string): boolean;
+/** @pure */
+export declare function localize(language: string, english: string, chinese: string): string;
+/** @pure */
+export declare function canonicalizeLanguageTag(value: string | number | readonly string[] | null | undefined): string;
+/** @pure */
+export declare function isCanonicalLanguageTag(value: string | number | null): boolean;
+/** @pure */
+export declare function canonicalizeOutputLanguage(value: string): string;
+/** @pure */
+export declare function resolveLanguage({ idea, project, global, }?: {
+    idea?: string;
+    project?: string;
+    global?: string;
+}): {
+    tag: string;
+    source: string;
+};
+/** @pure */
+export declare function resolveOutputLanguage({ content, override, }?: {
+    content?: string;
+    override?: string;
+}): {
+    tag: string;
+    source: string;
+};
+/** @pure */
+export declare function resolveContentTemplateLanguage(contentLanguage: string): {
+    tag: OutputLanguage;
+    localized: boolean;
+};
+//# sourceMappingURL=language.d.ts.map

package/dist/src/foundation/language/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../../../src/foundation/language/language.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,UAAU,CAAC;AACxC,eAAO,MAAM,gBAAgB,6BAA6C,CAAC;AAE3E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAI/D,YAAY;AACZ,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,WAEzC;AAED,YAAY;AACZ,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAE1E;AAED,YAAY;AACZ,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAC,MAAM,GAAC,SAAS,MAAM,EAAE,GAAC,IAAI,GAAC,SAAS,UAW5F;AAED,YAAY;AACZ,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAC,MAAM,GAAC,IAAI,WAM/D;AAED,YAAY;AACZ,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,UAoBvD;AAED,YAAY;AACZ,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,OAAO,EACP,MAAM,GACP,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO;;;EAK3D;AAED,YAAY;AACZ,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,QAAQ,GACT,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO;;;EAc9C;AAED,YAAY;AACZ,wBAAgB,8BAA8B,CAAC,eAAe,EAAE,MAAM,GAAG;IACvE,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB,CASA"}

package/dist/src/foundation/language/language.js

@@ -0,0 +1,94 @@
+export const DEFAULT_LANGUAGE = "en-US";
+export const OUTPUT_LANGUAGES = Object.freeze(["en-US", "zh-CN"]);
+const OUTPUT_LANGUAGE_SET = new Set(OUTPUT_LANGUAGES);
+/** @pure */
+export function isChinese(language) {
+    return language?.toLowerCase().startsWith("zh") ?? false;
+}
+/** @pure */
+export function localize(language, english, chinese) {
+    return isChinese(language) ? chinese : english;
+}
+/** @pure */
+export function canonicalizeLanguageTag(value) {
+    if (typeof value !== "string" || value.length === 0 || value.trim() !== value) {
+        throw new Error("language tag must be a non-empty trimmed string");
+    }
+    try {
+        const [canonical] = Intl.getCanonicalLocales(value);
+        if (!canonical)
+            throw new Error("language tag is empty");
+        return canonical;
+    }
+    catch {
+        throw new Error(`invalid BCP 47 language tag: ${value}`);
+    }
+}
+/** @pure */
+export function isCanonicalLanguageTag(value) {
+    try {
+        return canonicalizeLanguageTag(value) === value;
+    }
+    catch {
+        return false;
+    }
+}
+/** @pure */
+export function canonicalizeOutputLanguage(value) {
+    let canonical;
+    try {
+        canonical = canonicalizeLanguageTag(value);
+    }
+    catch (caught) {
+        const error = caught instanceof Error ? caught : new Error(String(caught));
+        Object.assign(error, { exitCode: 2 });
+        throw error;
+    }
+    canonical = {
+        en: "en-US",
+        zh: "zh-CN",
+    }[canonical.toLowerCase()] ?? canonical;
+    if (!OUTPUT_LANGUAGE_SET.has(canonical)) {
+        const error = new Error(`unsupported output language: ${canonical}; expected ${OUTPUT_LANGUAGES.join(" or ")}`);
+        throw Object.assign(error, { exitCode: 2 });
+    }
+    return canonical;
+}
+/** @pure */
+export function resolveLanguage({ idea, project, global, } = {}) {
+    if (idea !== undefined)
+        return { tag: idea, source: "idea" };
+    if (project !== undefined)
+        return { tag: project, source: "project" };
+    if (global !== undefined)
+        return { tag: global, source: "global" };
+    return { tag: DEFAULT_LANGUAGE, source: "default" };
+}
+/** @pure */
+export function resolveOutputLanguage({ content, override, } = {}) {
+    if (override !== undefined) {
+        return {
+            tag: canonicalizeOutputLanguage(override),
+            source: "override",
+        };
+    }
+    if (content?.toLowerCase().startsWith("zh")) {
+        return { tag: "zh-CN", source: "content" };
+    }
+    return {
+        tag: DEFAULT_LANGUAGE,
+        source: content === undefined ? "default" : "content",
+    };
+}
+/** @pure */
+export function resolveContentTemplateLanguage(contentLanguage) {
+    const normalized = contentLanguage.toLowerCase();
+    if (normalized === "zh" || normalized.startsWith("zh-")) {
+        return { tag: "zh-CN", localized: true };
+    }
+    if (normalized === "en" || normalized.startsWith("en-")) {
+        return { tag: "en-US", localized: true };
+    }
+    return { tag: "en-US", localized: false };
+}
+//# sourceMappingURL=language.js.map

package/dist/src/foundation/language/language.js.map

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

package/dist/src/foundation/owned-write/index.d.ts

@@ -0,0 +1,2 @@
+export { cleanupResult, cleanupScaffold, cleanupSummary, createScaffold, ensureDirectoryPath, pathExists, removeCreatedDirectories, removeOwnedFile, withCleanupPlan, } from "./writer.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/owned-write/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/owned-write/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,2 @@
+export { cleanupResult, cleanupScaffold, cleanupSummary, createScaffold, ensureDirectoryPath, pathExists, removeCreatedDirectories, removeOwnedFile, withCleanupPlan, } from "./writer.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/owned-write/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/src/foundation/owned-write/writer.d.ts

@@ -0,0 +1,86 @@
+import { lstat, mkdir, readFile, rm, rmdir, writeFile } from "node:fs/promises";
+type FileSource = string | Uint8Array<ArrayBufferLike>;
+type CleanupFile = readonly [path: string, source: FileSource];
+type CleanupPlan = {
+    cleanupFiles: CleanupFile[];
+    collisionPath: string | null;
+    createdDirectories: string[];
+    rootDirectories: string[];
+};
+type CleanupItem = {
+    path: string;
+    status: "missing" | "preserved" | "preserved-existing" | "preserved-modified" | "removed";
+    error?: string;
+};
+type DirectoryMetadata = {
+    isDirectory(): boolean;
+    isSymbolicLink(): boolean;
+};
+type ScaffoldOperations = {
+    lstat?: typeof lstat;
+    mkdir?: typeof mkdir;
+    readFile?: typeof readFile;
+    rm?: typeof rm;
+    rmdir?: typeof rmdir;
+    writeFile?: typeof writeFile;
+};
+export declare function pathExists(path: string, inspect: (path: string) => Promise<DirectoryMetadata>): Promise<boolean>;
+export declare function removeOwnedFile(path: string, expected: FileSource, read: (path: string) => Promise<Buffer>, remove: (path: string, options: {
+    force: boolean;
+}) => Promise<void>): Promise<{
+    path: string;
+    status: "missing";
+} | {
+    path: string;
+    status: "removed";
+} | {
+    path: string;
+    status: "preserved-modified";
+}>;
+export declare function removeCreatedDirectories(created: readonly string[], removeDirectory: (path: string) => Promise<void>): Promise<CleanupItem[]>;
+export declare function ensureDirectoryPath(root: string, relativePath: string, operations: {
+    inspect: (path: string) => Promise<DirectoryMetadata>;
+    makeDirectory: (path: string) => Promise<unknown>;
+}): Promise<string[]>;
+export declare function cleanupSummary(results: readonly CleanupItem[]): string;
+export declare function cleanupResult(results: CleanupItem[]): {
+    removed: number;
+    preserved: number;
+    items: CleanupItem[];
+};
+export declare function withCleanupPlan(caught: unknown, cleanupPlan: CleanupPlan): Error & {
+    cleanupPlan: CleanupPlan;
+};
+export declare function cleanupScaffold(cleanupPlan: CleanupPlan, operations?: ScaffoldOperations): Promise<{
+    removed: number;
+    preserved: number;
+    items: CleanupItem[];
+}>;
+export declare function createScaffold({ canonicalLanguage, contentLanguage, formatVersion, generateId, operations, repositoryRoot, }: {
+    canonicalLanguage?: string;
+    contentLanguage: string;
+    formatVersion: number;
+    generateId: () => string | Promise<string>;
+    operations?: ScaffoldOperations;
+    repositoryRoot: string;
+}): Promise<{
+    createdIdea: {
+        id: string;
+        path: string;
+        state: string;
+    };
+    paths: {
+        ideaPath: string;
+        statusPath: string;
+        eventsPath: string;
+        ledgerPath: string;
+        outerPath: string;
+        deploymentDocumentPath: string;
+        innerPath: string;
+        implementationDocumentPath: string;
+        idealPath: string;
+        ideaDocumentPath: string;
+    };
+}>;
+export {};
+//# sourceMappingURL=writer.d.ts.map

package/dist/src/foundation/owned-write/writer.d.ts.map

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