@mokly/mokly 0.8.0

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}

package/dist/config/validate.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedConfig } from "./types.js";
+/** Validate an imported config and resolve every filesystem path. */
+export declare function resolveConfig(value: unknown, configPath: string): ResolvedConfig;
+//# sourceMappingURL=validate.d.ts.map

package/dist/config/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/config/validate.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9D,qEAAqE;AACrE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,MAAM,GACjB,cAAc,CAwGhB"}

package/dist/config/validate.js

@@ -0,0 +1,74 @@
+import path from "node:path";
+import { MoklyError } from "../errors.js";
+import { resolveInside, validateRelativeRoute } from "./paths.js";
+import { optionalModule, requireDirectory, validateReviewOut, validateSourceRoots, } from "./path_validation.js";
+import { resolveModuleResolution } from "./module_resolution.js";
+import { requireString, validateColorSchemes, validateDebounce, validateStringArray, validateStylesheets, validateWatchRules, } from "./rules.js";
+/** Validate an imported config and resolve every filesystem path. */
+export function resolveConfig(value, configPath) {
+    if (!isRecord(value)) {
+        throw new MoklyError("config-invalid", `${configPath} must export an object`);
+    }
+    if (Object.hasOwn(value, "legacy"))
+        throw new MoklyError("config-invalid", "legacy configuration was removed; register whole documents with definePage");
+    const input = value;
+    requireString(input.entriesDir, "entriesDir");
+    requireString(input.mockupsDir, "mockupsDir");
+    if (input.repoRoot !== undefined)
+        requireString(input.repoRoot, "repoRoot");
+    const configDir = path.dirname(configPath);
+    const repoRoot = path.resolve(configDir, input.repoRoot ?? ".");
+    requireDirectory(repoRoot, "repoRoot");
+    const entriesDir = resolveInside(repoRoot, configDir, input.entriesDir, "entriesDir");
+    const mockupsDir = resolveInside(repoRoot, configDir, input.mockupsDir, "mockupsDir");
+    requireDirectory(entriesDir, "entriesDir");
+    requireDirectory(mockupsDir, "mockupsDir");
+    const renderer = optionalModule(repoRoot, configDir, input.renderer, "renderer");
+    const compatibilityTransformer = optionalModule(repoRoot, configDir, input.compatibility?.transformer, "compatibility.transformer");
+    const moduleResolution = resolveModuleResolution(input.moduleResolution, repoRoot, configDir);
+    validateSourceRoots(repoRoot, entriesDir, mockupsDir);
+    const colorSchemes = validateColorSchemes(input.colorSchemes);
+    const stylesheets = validateStylesheets(input.stylesheets ?? []);
+    const watchRules = validateWatchRules(input.watch?.rules ?? []);
+    if (input.review?.base !== undefined)
+        requireString(input.review.base, "review.base");
+    if (input.compatibility?.readManifestV2 !== undefined &&
+        typeof input.compatibility.readManifestV2 !== "boolean") {
+        throw new MoklyError("config-invalid", "compatibility.readManifestV2 must be boolean");
+    }
+    const reviewOut = resolveInside(repoRoot, configDir, input.review?.outDir ?? ".context/mokly-review", "review.outDir");
+    validateReviewOut(reviewOut, {
+        entriesDir,
+        mockupsDir,
+        repoRoot,
+    });
+    return {
+        colorSchemes,
+        compatibility: {
+            readManifestV2: input.compatibility?.readManifestV2 ?? false,
+            ...(compatibilityTransformer
+                ? { transformer: compatibilityTransformer }
+                : {}),
+        },
+        configPath,
+        entriesDir,
+        mockupsDir,
+        moduleResolution,
+        ...(renderer ? { renderer } : {}),
+        repoRoot,
+        review: {
+            base: input.review?.base ?? "origin/main",
+            outDir: reviewOut,
+            sharedImpact: validateStringArray(input.review?.sharedImpact ?? [], "review.sharedImpact").map((glob) => validateRelativeRoute(glob, "review.sharedImpact")),
+        },
+        stylesheets,
+        watch: {
+            debounceMs: validateDebounce(input.watch?.debounceMs),
+            rules: watchRules,
+        },
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=validate.js.map

package/dist/config/validate.js.map

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

package/dist/diagnostics/timings.d.ts

@@ -0,0 +1,30 @@
+export interface TimingEvent {
+    schemaVersion: 1;
+    session: string;
+    pid: number;
+    role: string;
+    event: "start" | "end" | "counts";
+    stage: string;
+    id: number;
+    parentId?: number;
+    elapsedMs: number;
+    durationMs?: number;
+    status?: "ok" | "error";
+    counts?: Readonly<Record<string, number>>;
+}
+interface TimingSink {
+    clock?: () => number;
+    write?: (event: TimingEvent) => void;
+}
+/** Scope profiling to one CLI invocation, including its later asynchronous work. */
+export declare function runWithTimings<T>(enabled: boolean, role: string, operation: () => T, sink?: TimingSink): T;
+/** Bind an external emitter callback to the session in which it was registered. */
+export declare function bindTimings<T extends (...args: never[]) => unknown>(callback: T): T;
+/** Forward opt-in diagnostics to a supervised child without global environment state. */
+export declare function timingArguments(): readonly string[];
+export declare function timeSync<T>(stage: string, operation: () => T): T;
+export declare function timeAsync<T>(stage: string, operation: () => Promise<T>): Promise<T>;
+/** Calculate aggregate numeric metadata only when diagnostics were explicitly enabled. */
+export declare function timingCounts(stage: string, counts: () => Readonly<Record<string, number>>): void;
+export {};
+//# sourceMappingURL=timings.d.ts.map

package/dist/diagnostics/timings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timings.d.ts","sourceRoot":"","sources":["../../src/diagnostics/timings.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C;AAED,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACtC;AAkBD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,CAAC,EAClB,IAAI,GAAE,UAAe,GACpB,CAAC,CAmBH;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACjE,QAAQ,EAAE,CAAC,GACV,CAAC,CAEH;AAED,yFAAyF;AACzF,wBAAgB,eAAe,IAAI,SAAS,MAAM,EAAE,CAEnD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAchE;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC7C,IAAI,CAQN"}

package/dist/diagnostics/timings.js

@@ -0,0 +1,118 @@
+/** Opt-in process-local spans; diagnostics never contain consumer documents or props. */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
+import { performance } from "node:perf_hooks";
+const storage = new AsyncLocalStorage();
+/** Scope profiling to one CLI invocation, including its later asynchronous work. */
+export function runWithTimings(enabled, role, operation, sink = {}) {
+    if (!enabled)
+        return storage.run(undefined, operation);
+    const clock = sink.clock ?? (() => performance.now());
+    return storage.run({
+        session: {
+            id: randomUUID(),
+            role,
+            clock,
+            origin: clock(),
+            sequence: 0,
+            write: sink.write ??
+                ((event) => process.stderr.write(`[mokly:timing] ${JSON.stringify(event)}\n`)),
+        },
+    }, operation);
+}
+/** Bind an external emitter callback to the session in which it was registered. */
+export function bindTimings(callback) {
+    return storage.getStore() ? AsyncLocalStorage.bind(callback) : callback;
+}
+/** Forward opt-in diagnostics to a supervised child without global environment state. */
+export function timingArguments() {
+    return storage.getStore() ? ["--debug-timings"] : [];
+}
+export function timeSync(stage, operation) {
+    const context = storage.getStore();
+    if (!context)
+        return operation();
+    const span = begin(context, stage);
+    return storage.run({ session: context.session, parentId: span.id }, () => {
+        try {
+            const result = operation();
+            span.end("ok");
+            return result;
+        }
+        catch (error) {
+            span.end("error");
+            throw error;
+        }
+    });
+}
+export async function timeAsync(stage, operation) {
+    const context = storage.getStore();
+    if (!context)
+        return operation();
+    const span = begin(context, stage);
+    return storage.run({ session: context.session, parentId: span.id }, async () => {
+        try {
+            const result = await operation();
+            span.end("ok");
+            return result;
+        }
+        catch (error) {
+            span.end("error");
+            throw error;
+        }
+    });
+}
+/** Calculate aggregate numeric metadata only when diagnostics were explicitly enabled. */
+export function timingCounts(stage, counts) {
+    const context = storage.getStore();
+    if (!context)
+        return;
+    emit(context.session, {
+        ...baseEvent(context, stage),
+        event: "counts",
+        counts: counts(),
+    });
+}
+function begin(context, stage) {
+    const base = baseEvent(context, stage);
+    const started = context.session.clock();
+    emit(context.session, { ...base, event: "start" });
+    return {
+        id: base.id,
+        end(status) {
+            const now = context.session.clock();
+            emit(context.session, {
+                ...base,
+                event: "end",
+                status,
+                durationMs: milliseconds(now - started),
+                elapsedMs: milliseconds(now - context.session.origin),
+            });
+        },
+    };
+}
+function baseEvent(context, stage) {
+    const { session, parentId } = context;
+    return {
+        schemaVersion: 1,
+        session: session.id,
+        pid: process.pid,
+        role: session.role,
+        stage,
+        id: ++session.sequence,
+        ...(parentId === undefined ? {} : { parentId }),
+        elapsedMs: milliseconds(session.clock() - session.origin),
+    };
+}
+function milliseconds(value) {
+    return Math.round(value * 100) / 100;
+}
+function emit(session, event) {
+    try {
+        session.write(event);
+    }
+    catch {
+        return;
+    }
+}
+//# sourceMappingURL=timings.js.map

package/dist/diagnostics/timings.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+/** Stable error codes callers and CLI formatting may branch on. */
+export type MoklyErrorCode = "build-invalid" | "cli-invalid" | "config-invalid" | "config-missing" | "export-invalid" | "git-failed" | "manifest-invalid" | "review-invalid" | "server-failed";
+/** Typed user-facing failure from a Mokly boundary. */
+export declare class MoklyError extends Error {
+    readonly code: MoklyErrorCode;
+    constructor(code: MoklyErrorCode, message: string, options?: ErrorOptions);
+}
+/** Convert an unknown caught value into a display-safe message. */
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,YAAY,GACZ,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,CAAC;AAEpB,uDAAuD;AACvD,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAElB,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAK1E;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/dist/errors.js

@@ -0,0 +1,14 @@
+/** Typed user-facing failure from a Mokly boundary. */
+export class MoklyError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(`[mokly/${code}] ${message}`, options);
+        this.name = "MoklyError";
+        this.code = code;
+    }
+}
+/** Convert an unknown caught value into a display-safe message. */
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAYA,uDAAuD;AACvD,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IAE9B,YAAY,IAAoB,EAAE,OAAe,EAAE,OAAsB;QACvE,KAAK,CAAC,UAAU,IAAI,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/export/backup.d.ts

@@ -0,0 +1,18 @@
+import { type ExportDirectoryIdentity } from "./destination.js";
+import type { ExportOperations } from "./operations.js";
+import { type LegacyExportOwnership } from "./ownership.js";
+/** Recovery and deletion policy for a captured, potentially concurrently edited output. */
+export declare class ExportBackup {
+    private readonly output;
+    private readonly backup;
+    private readonly operations;
+    private readonly legacy;
+    constructor(output: string, backup: string, operations: ExportOperations, legacy: LegacyExportOwnership | undefined);
+    /** Validate the tree actually moved, not only the destination observed earlier. */
+    validate(initial: ExportDirectoryIdentity): Promise<void>;
+    /** Restore real directories with OS-enforced exclusion of new destinations. */
+    restore(primary: unknown): Promise<never>;
+    /** Delete only a validated snapshot; new files make non-recursive removal fail. */
+    discard(): Promise<void>;
+}
+//# sourceMappingURL=backup.d.ts.map

package/dist/export/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/export/backup.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB,2FAA2F;AAC3F,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,qBAAqB,GAAG,SAAS;IAG5D,mFAAmF;IAC7E,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,+EAA+E;IACzE,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAwB/C,mFAAmF;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA2B/B"}

package/dist/export/backup.js

@@ -0,0 +1,61 @@
+import path from "node:path";
+import { errorMessage } from "../errors.js";
+import { assertDestination, } from "./destination.js";
+import { exportError } from "./error.js";
+import { assertExportOwnership, EXPORT_MARKER, } from "./ownership.js";
+/** Recovery and deletion policy for a captured, potentially concurrently edited output. */
+export class ExportBackup {
+    output;
+    backup;
+    operations;
+    legacy;
+    constructor(output, backup, operations, legacy) {
+        this.output = output;
+        this.backup = backup;
+        this.operations = operations;
+        this.legacy = legacy;
+    }
+    /** Validate the tree actually moved, not only the destination observed earlier. */
+    async validate(initial) {
+        if (!(await assertExportOwnership(this.backup, this.legacy)))
+            throw exportError(`Export backup disappeared before installation: ${this.backup}.`);
+        await assertDestination(this.backup, initial, this.operations);
+    }
+    /** Restore real directories with OS-enforced exclusion of new destinations. */
+    async restore(primary) {
+        try {
+            if (await this.operations.lstat(this.output))
+                throw exportError(`Export destination was recreated; it was not replaced: ${this.output}.`);
+            const stat = await this.operations.lstat(this.backup);
+            if (!stat?.isDirectory() || stat.isSymbolicLink())
+                throw exportError(`Export backup is not a real directory; recover it manually: ${this.backup}.`);
+            await this.operations.rename(this.backup, this.output);
+        }
+        catch (rollback) {
+            throw exportError(`Export rollback failed; recover the previous site from ${this.backup}. Original failure: ${errorMessage(primary)} Recovery failure: ${errorMessage(rollback)}`, new AggregateError([primary, rollback]));
+        }
+        throw exportError(`Could not install export; the previous output was restored. ${errorMessage(primary)}`, primary);
+    }
+    /** Delete only a validated snapshot; new files make non-recursive removal fail. */
+    async discard() {
+        try {
+            const entries = await assertExportOwnership(this.backup, this.legacy);
+            if (!entries)
+                throw exportError(`Export backup disappeared during cleanup: ${this.backup}.`);
+            const marker = this.legacy && entries.files.includes(this.legacy.marker)
+                ? this.legacy.marker
+                : EXPORT_MARKER;
+            for (const name of entries.files.filter((name) => name !== marker))
+                await this.operations.unlink(path.join(this.backup, name));
+            for (const name of [...entries.directories].sort((a, b) => b.split("/").length - a.split("/").length))
+                await this.operations.rmdir(path.join(this.backup, name));
+            if (entries.files.includes(marker))
+                await this.operations.unlink(path.join(this.backup, marker));
+            await this.operations.rmdir(this.backup);
+        }
+        catch (error) {
+            throw exportError(`Export installed, but backup cleanup failed at ${this.backup}. ${errorMessage(error)}`, error);
+        }
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/export/backup.js.map

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

package/dist/export/cleanup.d.ts

@@ -0,0 +1,5 @@
+/** Preserve both failures, in causal order, without hiding either CLI diagnostic. */
+export declare function failAfterExportCleanup(primary: unknown, cleanup: () => Promise<void>): Promise<never>;
+/** Always drain cleanup, but never replace an earlier operation failure with it. */
+export declare function withExportCleanup<T>(operation: () => Promise<T>, cleanup: () => Promise<void>): Promise<T>;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/export/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/export/cleanup.ts"],"names":[],"mappings":"AAGA,qFAAqF;AACrF,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC3B,OAAO,CAAC,KAAK,CAAC,CAUhB;AAED,oFAAoF;AACpF,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CASZ"}

package/dist/export/cleanup.js

@@ -0,0 +1,25 @@
+import { errorMessage } from "../errors.js";
+import { exportError } from "./error.js";
+/** Preserve both failures, in causal order, without hiding either CLI diagnostic. */
+export async function failAfterExportCleanup(primary, cleanup) {
+    try {
+        await cleanup();
+    }
+    catch (secondary) {
+        throw exportError(`Export failed: ${errorMessage(primary)}\nCleanup also failed: ${errorMessage(secondary)}`, new AggregateError([primary, secondary]));
+    }
+    throw primary;
+}
+/** Always drain cleanup, but never replace an earlier operation failure with it. */
+export async function withExportCleanup(operation, cleanup) {
+    let result;
+    try {
+        result = await operation();
+    }
+    catch (error) {
+        return failAfterExportCleanup(error, cleanup);
+    }
+    await cleanup();
+    return result;
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/export/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/export/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgB,EAChB,OAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,MAAM,WAAW,CACf,kBAAkB,YAAY,CAAC,OAAO,CAAC,0BAA0B,YAAY,CAAC,SAAS,CAAC,EAAE,EAC1F,IAAI,cAAc,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CACzC,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,CAAC;AAChB,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA2B,EAC3B,OAA4B;IAE5B,IAAI,MAAS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,OAAO,EAAE,CAAC;IAChB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/export/content_id.d.ts

@@ -0,0 +1,8 @@
+import type { ReviewArtifactContent } from "../review/types.js";
+/** Stable path/content hashes without locale- or insertion-order dependence. */
+export declare function contentIdentities(files: ReadonlyMap<string, ReviewArtifactContent>): readonly (readonly [string, string])[];
+/** Hash the comparison inventory independently from its containing deployment. */
+export declare function comparisonContentId(files: ReadonlyMap<string, ReviewArtifactContent>): string;
+/** Include alias edges as well as every finalized deployment file. */
+export declare function deploymentContentId(files: ReadonlyMap<string, ReviewArtifactContent>, aliases: ReadonlyMap<string, string>): string;
+//# sourceMappingURL=content_id.d.ts.map

package/dist/export/content_id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content_id.d.ts","sourceRoot":"","sources":["../../src/export/content_id.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,gFAAgF;AAChF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAChD,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAOxC;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAChD,MAAM,CAKR;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACjD,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAMR"}

package/dist/export/content_id.js

@@ -0,0 +1,29 @@
+import crypto from "node:crypto";
+/** Stable path/content hashes without locale- or insertion-order dependence. */
+export function contentIdentities(files) {
+    return [...files]
+        .sort(comparePaths)
+        .map(([name, bytes]) => [
+        name,
+        crypto.createHash("sha256").update(bytes).digest("hex"),
+    ]);
+}
+/** Hash the comparison inventory independently from its containing deployment. */
+export function comparisonContentId(files) {
+    return crypto
+        .createHash("sha256")
+        .update(JSON.stringify(contentIdentities(files)))
+        .digest("hex");
+}
+/** Include alias edges as well as every finalized deployment file. */
+export function deploymentContentId(files, aliases) {
+    const edges = [...aliases].sort(comparePaths);
+    return crypto
+        .createHash("sha256")
+        .update(JSON.stringify([contentIdentities(files), edges]))
+        .digest("hex");
+}
+function comparePaths([left], [right]) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=content_id.js.map

package/dist/export/content_id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content_id.js","sourceRoot":"","sources":["../../src/export/content_id.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAIjC,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAC/B,KAAiD;IAEjD,OAAO,CAAC,GAAG,KAAK,CAAC;SACd,IAAI,CAAC,YAAY,CAAC;SAClB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QACtB,IAAI;QACJ,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KACxD,CAAC,CAAC;AACP,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CACjC,KAAiD;IAEjD,OAAO,MAAM;SACV,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;SAChD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CACjC,KAAiD,EACjD,OAAoC;IAEpC,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9C,OAAO,MAAM;SACV,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;SACzD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CACnB,CAAC,IAAI,CAA6B,EAClC,CAAC,KAAK,CAA6B;IAEnC,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/export/deployment.d.ts

@@ -0,0 +1,5 @@
+import type { StaticDelivery } from "../navigation/delivery.js";
+import type { ReviewArtifactContent } from "../review/types.js";
+/** Hash the complete final artifact, then stamp only its authenticated shell roots. */
+export declare function finalizeDeployment(files: Map<string, ReviewArtifactContent>, shells: ReadonlyMap<string, StaticDelivery>, aliases: ReadonlyMap<string, string>): string;
+//# sourceMappingURL=deployment.d.ts.map

package/dist/export/deployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/export/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAUhE,uFAAuF;AACvF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACzC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAC3C,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAkBR"}

package/dist/export/deployment.js

@@ -0,0 +1,20 @@
+import { deploymentContentId } from "./content_id.js";
+import { exportError } from "./error.js";
+import { readExportShellMetadata, stampExportShell, STAGED_DEPLOYMENT_ID, } from "./shell_metadata.js";
+/** Hash the complete final artifact, then stamp only its authenticated shell roots. */
+export function finalizeDeployment(files, shells, aliases) {
+    const metadata = new Map();
+    for (const [name, expected] of shells) {
+        const bytes = files.get(name);
+        if (bytes === undefined)
+            throw exportError(`Missing static shell metadata document: ${name}`);
+        const shell = readExportShellMetadata(name, Buffer.from(bytes).toString("utf8"), expected);
+        metadata.set(name, shell);
+        files.set(name, stampExportShell(shell, STAGED_DEPLOYMENT_ID));
+    }
+    const deploymentId = deploymentContentId(files, aliases);
+    for (const [name, shell] of metadata)
+        files.set(name, stampExportShell(shell, deploymentId));
+    return deploymentId;
+}
+//# sourceMappingURL=deployment.js.map

package/dist/export/deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../src/export/deployment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,qBAAqB,CAAC;AAE7B,uFAAuF;AACvF,MAAM,UAAU,kBAAkB,CAChC,KAAyC,EACzC,MAA2C,EAC3C,OAAoC;IAEpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,WAAW,CAAC,2CAA2C,IAAI,EAAE,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,uBAAuB,CACnC,IAAI,EACJ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EACnC,QAAQ,CACT,CAAC;QACF,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,QAAQ;QAClC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;IACzD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/export/destination.d.ts

@@ -0,0 +1,18 @@
+import type { ExportOperations } from "./operations.js";
+import { type LegacyExportOwnership } from "./ownership.js";
+/** Identity of the directory inspected before any export generation. */
+export interface ExportDirectoryIdentity {
+    kind: "directory";
+    dev: bigint;
+    ino: bigint;
+    birthtimeNs: bigint;
+}
+/** Initial absence never grants permission to replace a later directory. */
+export type ExportDestination = {
+    kind: "absent";
+} | ExportDirectoryIdentity;
+/** Capture identity on both sides of ownership validation. */
+export declare function captureDestination(output: string, operations: ExportOperations, legacy?: LegacyExportOwnership): Promise<ExportDestination>;
+/** Reject source replacement, disappearance, or creation since inspection. */
+export declare function assertDestination(candidate: string, initial: ExportDestination, operations: ExportOperations): Promise<void>;
+//# sourceMappingURL=destination.d.ts.map

package/dist/export/destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination.d.ts","sourceRoot":"","sources":["../../src/export/destination.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,uBAAuB,CAAC;AAE7E,8DAA8D;AAC9D,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED,8EAA8E;AAC9E,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/export/destination.js

@@ -0,0 +1,36 @@
+import { exportError } from "./error.js";
+import { assertExportOwnership, } from "./ownership.js";
+/** Capture identity on both sides of ownership validation. */
+export async function captureDestination(output, operations, legacy) {
+    const stat = await operations.lstat(output);
+    const initial = stat
+        ? directoryIdentity(stat)
+        : { kind: "absent" };
+    await assertExportOwnership(output, legacy);
+    await assertDestination(output, initial, operations);
+    return initial;
+}
+/** Reject source replacement, disappearance, or creation since inspection. */
+export async function assertDestination(candidate, initial, operations) {
+    const stat = await operations.lstat(candidate);
+    if (initial.kind === "absent"
+        ? stat === undefined
+        : stat?.isDirectory() &&
+            !stat.isSymbolicLink() &&
+            stat.dev === initial.dev &&
+            stat.ino === initial.ino &&
+            stat.birthtimeNs === initial.birthtimeNs)
+        return;
+    throw exportError(`Export destination changed since inspection: ${candidate}. Inspect the destination before retrying.`);
+}
+function directoryIdentity(stat) {
+    if (!stat.isDirectory() || stat.isSymbolicLink())
+        throw exportError("Export ownership requires a real directory.");
+    return {
+        kind: "directory",
+        dev: stat.dev,
+        ino: stat.ino,
+        birthtimeNs: stat.birthtimeNs,
+    };
+}
+//# sourceMappingURL=destination.js.map

package/dist/export/destination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination.js","sourceRoot":"","sources":["../../src/export/destination.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EACL,qBAAqB,GAEtB,MAAM,gBAAgB,CAAC;AAaxB,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,UAA4B,EAC5B,MAA8B;IAE9B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAsB,IAAI;QACrC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACvB,MAAM,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAiB,EACjB,OAA0B,EAC1B,UAA4B;IAE5B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/C,IACE,OAAO,CAAC,IAAI,KAAK,QAAQ;QACvB,CAAC,CAAC,IAAI,KAAK,SAAS;QACpB,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE;YACnB,CAAC,IAAI,CAAC,cAAc,EAAE;YACtB,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG;YACxB,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG;YACxB,IAAI,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW;QAE5C,OAAO;IACT,MAAM,WAAW,CACf,gDAAgD,SAAS,4CAA4C,CACtG,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAoB;IAC7C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE;QAC9C,MAAM,WAAW,CAAC,6CAA6C,CAAC,CAAC;IACnE,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;AACJ,CAAC"}

package/dist/export/error.d.ts

@@ -0,0 +1,6 @@
+import { MoklyError } from "../errors.js";
+/** Contextual failure at the static-export boundary. */
+export declare function exportError(message: string, cause?: unknown): MoklyError;
+/** Stop before committing output after a cancellation request. */
+export declare function assertExportActive(signal?: AbortSignal): void;
+//# sourceMappingURL=error.d.ts.map

package/dist/export/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/export/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAExE;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAE7D"}

package/dist/export/error.js

@@ -0,0 +1,11 @@
+import { MoklyError } from "../errors.js";
+/** Contextual failure at the static-export boundary. */
+export function exportError(message, cause) {
+    return new MoklyError("export-invalid", message, { cause });
+}
+/** Stop before committing output after a cancellation request. */
+export function assertExportActive(signal) {
+    if (signal?.aborted)
+        throw exportError("Export cancelled; retry when ready.");
+}
+//# sourceMappingURL=error.js.map

package/dist/export/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/export/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAe;IAC1D,OAAO,IAAI,UAAU,CAAC,gBAAgB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,WAAW,CAAC,qCAAqC,CAAC,CAAC;AAChF,CAAC"}

package/dist/export/ignored.d.ts

@@ -0,0 +1,3 @@
+/** Recognize proven output/reservations, not unrelated similarly named files. */
+export declare function isExportIgnoredPath(candidate: string, repoRoot: string, mode?: "traverse" | "event"): boolean;
+//# sourceMappingURL=ignored.d.ts.map

package/dist/export/ignored.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored.d.ts","sourceRoot":"","sources":["../../src/export/ignored.ts"],"names":[],"mappings":"AAaA,iFAAiF;AACjF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,UAAU,GAAG,OAAiB,GACnC,OAAO,CA6BT"}