pray-cli 1.9.2 → 1.11.0

package/dist/render/dest.js

@@ -0,0 +1,120 @@
+import { closeSync, constants, ftruncateSync, mkdirSync, readFileSync, unlinkSync, } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { PrayError } from "../errors.js";
+import { sha256Prefixed } from "../hashing.js";
+import { validateDestinationPath } from "../manifest/validate.js";
+import { createBytes, destinationKind, openRegular, readRegularBytes, writeAll, } from "./destination-io.js";
+import { ensureSafeDestinationAncestors } from "./path-guard.js";
+import { expectedProvisionedBytes, plannedProvisionedFiles, } from "./provisioned.js";
+export function provisionedLockRecords(project) {
+    return plannedProvisionedFiles(project).map((file) => {
+        const expected = expectedProvisionedBytes(file.source, project.manifest.symbols ?? {});
+        return {
+            path: file.path.replaceAll("\\", "/"),
+            content_hash: sha256Prefixed(expected),
+            package: file.package,
+            export: file.export,
+        };
+    });
+}
+export function materializeProvisionedExports(project, previousLockfile) {
+    const planned = plannedProvisionedFiles(project);
+    const previous = previousMap(previousLockfile);
+    const plannedPaths = new Set(planned.map((file) => file.path.replaceAll("\\", "/")));
+    for (const file of planned) {
+        writeLeaf(project, file, previous);
+    }
+    if (previousLockfile) {
+        pruneDropped(project, previousLockfile, plannedPaths);
+    }
+}
+export function provisionedDestinationStatus(project, file, previousLockfile) {
+    validateDestinationPath(file.path);
+    ensureSafeDestinationAncestors(project.projectRoot, file.path, file.path);
+    const expected = expectedProvisionedBytes(file.source, project.manifest.symbols ?? {});
+    return classifyDestination(resolve(project.projectRoot, file.path), file.path, expected, previousMap(previousLockfile).get(file.path.replaceAll("\\", "/")));
+}
+function previousMap(lockfile) {
+    const records = new Map();
+    for (const record of lockfile?.provisioned ?? []) {
+        records.set(record.path, record);
+    }
+    return records;
+}
+function writeLeaf(project, file, previous) {
+    validateDestinationPath(file.path);
+    ensureSafeDestinationAncestors(project.projectRoot, file.path, file.path);
+    const destination = resolve(project.projectRoot, file.path);
+    const expected = expectedProvisionedBytes(file.source, project.manifest.symbols ?? {});
+    const record = previous.get(file.path.replaceAll("\\", "/"));
+    const status = classifyDestination(destination, file.path, expected, record);
+    if (status === "write") {
+        mkdirSync(dirname(destination), { recursive: true });
+        ensureSafeDestinationAncestors(project.projectRoot, file.path, file.path);
+        createBytes(destination, file.path, expected);
+        return;
+    }
+    if (status === "unchanged") {
+        return;
+    }
+    if (!record) {
+        throw PrayError.render(`missing lock ownership for \`${file.path}\``);
+    }
+    ensureSafeDestinationAncestors(project.projectRoot, file.path, file.path);
+    updateBytes(destination, file.path, expected, record.content_hash);
+}
+function classifyDestination(destination, display, expected, record) {
+    const kind = destinationKind(destination);
+    if (kind === "missing")
+        return "write";
+    if (kind === "symlink") {
+        throw PrayError.render(`refusing to write \`${display}\` because it is a symbolic link`);
+    }
+    if (kind !== "regular") {
+        throw PrayError.render(`refusing to write \`${display}\`; destination is not a regular file`);
+    }
+    const onDisk = readRegularBytes(destination, display);
+    if (onDisk.equals(expected))
+        return "unchanged";
+    if (record && sha256Prefixed(onDisk) === record.content_hash)
+        return "update";
+    if (record) {
+        throw PrayError.render(`refusing to overwrite \`${display}\`; it was provisioned and then edited`);
+    }
+    throw PrayError.render(`refusing to overwrite \`${display}\`; it already exists and is not the expected provisioned file`);
+}
+function pruneDropped(project, previous, plannedPaths) {
+    for (const record of previous.provisioned ?? []) {
+        validateDestinationPath(record.path);
+        if (plannedPaths.has(record.path)) {
+            continue;
+        }
+        const destination = resolve(project.projectRoot, record.path);
+        ensureSafeDestinationAncestors(project.projectRoot, record.path, record.path);
+        if (destinationKind(destination) !== "regular") {
+            continue;
+        }
+        const onDisk = readRegularBytes(destination, record.path);
+        if (sha256Prefixed(onDisk) === record.content_hash) {
+            ensureSafeDestinationAncestors(project.projectRoot, record.path, record.path);
+            unlinkSync(destination);
+        }
+    }
+}
+function updateBytes(path, display, bytes, authorizedHash) {
+    const descriptor = openRegular(path, display, constants.O_RDWR);
+    try {
+        const onDisk = readFileSync(descriptor);
+        if (onDisk.equals(bytes))
+            return;
+        if (sha256Prefixed(onDisk) !== authorizedHash) {
+            throw PrayError.render(`refusing to overwrite \`${display}\`; it was provisioned and then edited`);
+        }
+        ftruncateSync(descriptor, 0);
+        writeAll(descriptor, bytes);
+    }
+    finally {
+        closeSync(descriptor);
+    }
+}
+//# sourceMappingURL=dest.js.map

package/dist/render/dest.js.map

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

package/dist/render/destination-io.d.ts

@@ -0,0 +1,7 @@
+export type DestinationKind = "missing" | "regular" | "symlink" | "other";
+export declare function createBytes(path: string, display: string, bytes: Buffer): void;
+export declare function readRegularBytes(path: string, display: string): Buffer;
+export declare function openRegular(path: string, display: string, flags: number): number;
+export declare function writeAll(descriptor: number, bytes: Buffer): void;
+export declare function destinationKind(path: string): DestinationKind;
+//# sourceMappingURL=destination-io.d.ts.map

package/dist/render/destination-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-io.d.ts","sourceRoot":"","sources":["../../src/render/destination-io.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1E,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,IAAI,CAWN;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOtE;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWhE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAU7D"}

package/dist/render/destination-io.js

@@ -0,0 +1,67 @@
+import { closeSync, constants, fstatSync, lstatSync, openSync, readFileSync, writeSync, } from "node:fs";
+import { PrayError } from "../errors.js";
+export function createBytes(path, display, bytes) {
+    const descriptor = openPath(path, display, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL);
+    try {
+        writeAll(descriptor, bytes);
+    }
+    finally {
+        closeSync(descriptor);
+    }
+}
+export function readRegularBytes(path, display) {
+    const descriptor = openRegular(path, display, constants.O_RDONLY);
+    try {
+        return readFileSync(descriptor);
+    }
+    finally {
+        closeSync(descriptor);
+    }
+}
+export function openRegular(path, display, flags) {
+    const descriptor = openPath(path, display, flags);
+    if (!fstatSync(descriptor).isFile()) {
+        closeSync(descriptor);
+        throw PrayError.render(`refusing to write \`${display}\`; destination is not a regular file`);
+    }
+    return descriptor;
+}
+export function writeAll(descriptor, bytes) {
+    let offset = 0;
+    while (offset < bytes.length) {
+        offset += writeSync(descriptor, bytes, offset, bytes.length - offset, offset);
+    }
+}
+export function destinationKind(path) {
+    try {
+        const metadata = lstatSync(path);
+        if (metadata.isSymbolicLink())
+            return "symlink";
+        if (metadata.isFile())
+            return "regular";
+        return "other";
+    }
+    catch (error) {
+        if (isCode(error, "ENOENT"))
+            return "missing";
+        throw error;
+    }
+}
+function openPath(path, display, flags) {
+    try {
+        return openSync(path, flags | constants.O_NOFOLLOW, 0o666);
+    }
+    catch (error) {
+        if (isCode(error, "ELOOP")) {
+            throw PrayError.render(`refusing to write \`${display}\` because it is a symbolic link`);
+        }
+        throw error;
+    }
+}
+function isCode(error, code) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === code);
+}
+//# sourceMappingURL=destination-io.js.map

package/dist/render/destination-io.js.map

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

package/dist/render/header.d.ts

@@ -1,4 +1,5 @@
+import type { ManifestTarget } from "../manifest/types.js";
 import type { ResolvedProject } from "../resolve/types.js";
 import type { ContentBuilder } from "./content-builder.js";
-export declare function appendHeaderIfEnabled(builder: ContentBuilder, project: ResolvedProject, output: string): void;
+export declare function appendHeaderIfEnabled(builder: ContentBuilder, project: ResolvedProject, target: ManifestTarget, output: string): void;
 //# sourceMappingURL=header.d.ts.map

package/dist/render/header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/render/header.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,GACb,IAAI,CAgBN"}
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/render/header.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,CAWN"}

package/dist/render/header.js

@@ -1,15 +1,10 @@
-import { basename } from "node:path";
-export function appendHeaderIfEnabled(builder, project, output) {
-    if (!project.manifest.render.header) {
+import { composeHeaderText } from "./compose-dest.js";
+export function appendHeaderIfEnabled(builder, project, target, output) {
+    const header = composeHeaderText(target, output, project.manifest.render.header);
+    if (!header) {
         return;
     }
-    const outputName = basename(output);
-    builder.appendLine("<!-- pray:0 ignore-comments -->");
-    builder.appendEmptyLine();
-    builder.appendLine("# Agent context");
-    builder.appendEmptyLine();
-    builder.appendLine(`Do not edit managed blocks in \`${outputName}\` or provisioned files under \`.agents/\`.`);
-    builder.appendLine("To change shared guidance, update `Prayfile` and run `pray install`.");
+    builder.appendBody(header);
     builder.appendEmptyLine();
 }
 //# sourceMappingURL=header.js.map

package/dist/render/header.js.map

@@ -1 +1 @@
-{"version":3,"file":"header.js","sourceRoot":"","sources":["../../src/render/header.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,MAAM,UAAU,qBAAqB,CACnC,OAAuB,EACvB,OAAwB,EACxB,MAAc;IAEd,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;IACtD,OAAO,CAAC,eAAe,EAAE,CAAC;IAC1B,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACtC,OAAO,CAAC,eAAe,EAAE,CAAC;IAC1B,OAAO,CAAC,UAAU,CAChB,mCAAmC,UAAU,6CAA6C,CAC3F,CAAC;IACF,OAAO,CAAC,UAAU,CAChB,sEAAsE,CACvE,CAAC;IACF,OAAO,CAAC,eAAe,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../src/render/header.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,MAAM,UAAU,qBAAqB,CACnC,OAAuB,EACvB,OAAwB,EACxB,MAAsB,EACtB,MAAc;IAEd,MAAM,MAAM,GAAG,iBAAiB,CAC9B,MAAM,EACN,MAAM,EACN,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAC/B,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,eAAe,EAAE,CAAC;AAC5B,CAAC"}

package/dist/render/legacy.js

@@ -6,7 +6,7 @@ import { appendHeaderIfEnabled } from "./header.js";
 import { appendManagedExport, shouldInlineExport } from "./managed-export.js";
 export function renderLegacyCompose(project, target, output) {
     const builder = new ContentBuilder();
-    appendHeaderIfEnabled(builder, project, output);
+    appendHeaderIfEnabled(builder, project, target, output);
     appendUnboundLocals(builder, project);
     builder.appendLine("## Shared instructions");
     builder.appendEmptyLine();

package/dist/render/legacy.js.map

@@ -1 +1 @@
-{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../src/render/legacy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../src/render/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,MAAM,UAAU,mBAAmB,CACjC,OAAwB,EACxB,MAAsB,EACtB,MAAc;IAEd,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IACrC,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEtC,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;IAC7C,OAAO,CAAC,eAAe,EAAE,CAAC;IAE1B,MAAM,YAAY,GAAmC,EAAE,CAAC;IACxD,KAAK,MAAM,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5C,IACE,CAAC,yBAAyB,CACxB,YAAY,CAAC,WAAW,CAAC,MAAM,EAC/B,OAAO,CAAC,WAAW,CACpB,EACD,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,YAAY,CAAC,eAAe,EAAE,CAAC;YACtD,IAAI,CAAC,kBAAkB,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YACD,mBAAmB,CACjB,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,MAAM,EACN,MAAM,EACN,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAC/B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE;QACzB,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,OAAuB,EACvB,OAAwB;IAExB,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACxD,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAC1B,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAC;QACjD,OAAO,CAAC,eAAe,EAAE,CAAC;IAC5B,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjD,SAAS;QACX,CAAC;QACD,OAAO,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,UAAU,CAChB,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CACrE,CAAC;QACF,OAAO,CAAC,eAAe,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAChB,OAAwB,EACxB,KAAwB;IAExB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CACvC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,YAAY,CACrD,CAAC;IACF,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/dist/render/managed-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"managed-export.d.ts","sourceRoot":"","sources":["../../src/render/managed-export.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,eAAe,EAC7B,UAAU,EAAE,MAAM,GACjB,OAAO,CAGT;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,iBAAiB,EAAE,EACjC,YAAY,EAAE,eAAe,EAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI,CA4BN"}
+{"version":3,"file":"managed-export.d.ts","sourceRoot":"","sources":["../../src/render/managed-export.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,eAAe,EAC7B,UAAU,EAAE,MAAM,GACjB,OAAO,CAOT;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,iBAAiB,EAAE,EACjC,YAAY,EAAE,eAAe,EAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI,CAkCN"}

package/dist/render/managed-export.js

@@ -3,11 +3,17 @@ import { checksumManagedSpanContent, markerId } from "../hashing.js";
 import { substitutePraySymbols } from "../substitute.js";
 export function shouldInlineExport(packageEntry, exportName) {
     const exportEntry = packageEntry.spec.exports.get(exportName);
-    return !exportEntry || exportEntry.kind === "fragment";
+    return (!exportEntry ||
+        exportEntry.kind === "fragment" ||
+        exportEntry.kind === "file");
 }
 export function appendManagedExport(builder, managedSpans, packageEntry, exportName, target, output, symbols) {
     const raw = packageEntry.exportBodies.get(exportName);
-    if (!raw) {
+    if (raw === undefined) {
+        const exportEntry = packageEntry.spec.exports.get(exportName);
+        if (exportEntry?.kind === "file") {
+            throw PrayError.integrity(`compose cannot write binary export ${exportName}; use file: for unmarked bytes`);
+        }
         throw PrayError.render(`package ${packageEntry.declaration.name} is missing cached export ${exportName}`);
     }
     const body = substitutePraySymbols(raw, symbols);

package/dist/render/managed-export.js.map

@@ -1 +1 @@
-{"version":3,"file":"managed-export.js","sourceRoot":"","sources":["../../src/render/managed-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,MAAM,UAAU,kBAAkB,CAChC,YAA6B,EAC7B,UAAkB;IAElB,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9D,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,KAAK,UAAU,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAuB,EACvB,YAAiC,EACjC,YAA6B,EAC7B,UAAkB,EAClB,MAAsB,EACtB,MAAc,EACd,OAA+B;IAE/B,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,SAAS,CAAC,MAAM,CACpB,WAAW,YAAY,CAAC,WAAW,CAAC,IAAI,6BAA6B,UAAU,EAAE,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,QAAQ,CACjB,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,IAAI,UAAU,IAAI,MAAM,CAAC,IAAI,EAAE,CAChE,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1C,YAAY,CAAC,IAAI,CAAC;QAChB,EAAE;QACF,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE,SAAS;QACrB,cAAc,EAAE,0BAA0B,CAAC,IAAI,CAAC;QAChD,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,IAAI;QACtC,MAAM,EAAE,UAAU;QAClB,eAAe,EAAE,YAAY,CAAC,cAAc;QAC5C,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,CAAC,eAAe,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"managed-export.js","sourceRoot":"","sources":["../../src/render/managed-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,MAAM,UAAU,kBAAkB,CAChC,YAA6B,EAC7B,UAAkB;IAElB,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9D,OAAO,CACL,CAAC,WAAW;QACZ,WAAW,CAAC,IAAI,KAAK,UAAU;QAC/B,WAAW,CAAC,IAAI,KAAK,MAAM,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAuB,EACvB,YAAiC,EACjC,YAA6B,EAC7B,UAAkB,EAClB,MAAsB,EACtB,MAAc,EACd,OAA+B;IAE/B,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9D,IAAI,WAAW,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YACjC,MAAM,SAAS,CAAC,SAAS,CACvB,sCAAsC,UAAU,gCAAgC,CACjF,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,CAAC,MAAM,CACpB,WAAW,YAAY,CAAC,WAAW,CAAC,IAAI,6BAA6B,UAAU,EAAE,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,QAAQ,CACjB,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,IAAI,UAAU,IAAI,MAAM,CAAC,IAAI,EAAE,CAChE,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1C,YAAY,CAAC,IAAI,CAAC;QAChB,EAAE;QACF,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE,SAAS;QACrB,cAAc,EAAE,0BAA0B,CAAC,IAAI,CAAC;QAChD,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,IAAI;QACtC,MAAM,EAAE,UAAU;QAClB,eAAe,EAAE,YAAY,CAAC,cAAc;QAC5C,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,CAAC,eAAe,EAAE,CAAC;AAC5B,CAAC"}

package/dist/render/patch.d.ts

@@ -0,0 +1,4 @@
+import type { ManagedSpanRecord } from "../lockfile/types.js";
+export declare function patchRenderedContent(existing: string, fresh: string): string;
+export declare function relocateManagedSpans(content: string, spans: ManagedSpanRecord[]): ManagedSpanRecord[];
+//# sourceMappingURL=patch.d.ts.map

package/dist/render/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../src/render/patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAM9D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8B5E;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,iBAAiB,EAAE,GACzB,iBAAiB,EAAE,CAQrB"}

package/dist/render/patch.js

@@ -0,0 +1,101 @@
+export function patchRenderedContent(existing, fresh) {
+    const existingSegments = splitSegments(existing);
+    const freshSegments = splitSegments(fresh);
+    const freshManaged = new Map(freshSegments
+        .filter((segment) => segment.kind === "managed")
+        .map((segment) => [segment.id, segment.body]));
+    const overlaps = existingSegments.some((segment) => segment.kind === "managed" && freshManaged.has(segment.id));
+    if (!overlaps)
+        return fresh;
+    const used = new Set();
+    let output = "";
+    for (const segment of existingSegments) {
+        if (segment.kind === "text") {
+            output += segment.text;
+            continue;
+        }
+        const body = freshManaged.get(segment.id) ?? segment.body;
+        used.add(segment.id);
+        output += managedSegment(segment.id, body);
+    }
+    for (const segment of freshSegments) {
+        if (segment.kind === "managed" && !used.has(segment.id)) {
+            output += managedSegment(segment.id, segment.body);
+        }
+    }
+    return output.endsWith("\n") ? output : `${output}\n`;
+}
+export function relocateManagedSpans(content, spans) {
+    const positions = markerPositions(linesOf(content));
+    return spans.map((span) => {
+        const position = positions.get(span.id);
+        return position
+            ? { ...span, open_line: position[0], close_line: position[1] }
+            : span;
+    });
+}
+function splitSegments(content) {
+    const lines = linesOf(content);
+    const segments = [];
+    let text = "";
+    for (let index = 0; index < lines.length; index += 1) {
+        const id = markerId(lines[index] ?? "");
+        const close = id ? findClosingMarker(lines, index + 1, id) : undefined;
+        if (id && close !== undefined) {
+            if (text)
+                segments.push({ kind: "text", text });
+            text = "";
+            const bodyLines = lines.slice(index + 1, close);
+            const body = bodyLines.length > 0 ? `${bodyLines.join("\n")}\n` : "";
+            segments.push({ kind: "managed", id, body });
+            index = close;
+        }
+        else {
+            text += `${lines[index] ?? ""}\n`;
+        }
+    }
+    if (text)
+        segments.push({ kind: "text", text });
+    return segments;
+}
+function linesOf(content) {
+    if (!content)
+        return [];
+    const lines = content.split(/\r?\n/);
+    if (content.endsWith("\n"))
+        lines.pop();
+    return lines;
+}
+function findClosingMarker(lines, start, id) {
+    for (let index = start; index < lines.length; index += 1) {
+        if (markerId(lines[index] ?? "") === id)
+            return index;
+    }
+    return undefined;
+}
+function markerPositions(lines) {
+    const positions = new Map();
+    let active;
+    lines.forEach((line, index) => {
+        const id = markerId(line);
+        if (!id || !/^[a-z0-9]+$/.test(id))
+            return;
+        if (!active)
+            active = [id, index + 1];
+        else if (active[0] === id) {
+            positions.set(id, [active[1], index + 1]);
+            active = undefined;
+        }
+    });
+    return positions;
+}
+function markerId(line) {
+    const match = /^<!-- pray:(.+) -->$/.exec(line.trim());
+    const id = match?.[1];
+    return id && id !== "0 ignore-comments" ? id : undefined;
+}
+function managedSegment(id, body) {
+    const content = body ? `${body.replace(/\n+$/, "")}\n` : "";
+    return `<!-- pray:${id} -->\n${content}<!-- pray:${id} -->\n`;
+}
+//# sourceMappingURL=patch.js.map

package/dist/render/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/render/patch.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,KAAa;IAClE,MAAM,gBAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,aAAa;SACV,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC;SAC/C,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAChD,CAAC;IACF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CACpC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CACxE,CAAC;IACF,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,KAA0B;IAE1B,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,OAAO,QAAQ;YACb,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE;YAC9D,CAAC,CAAC,IAAI,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,IAAI,EAAE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,IAAI,GAAG,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,KAAK,GAAG,KAAK,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;QACpC,CAAC;IACH,CAAC;IACD,IAAI,IAAI;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAe,EACf,KAAa,EACb,EAAU;IAEV,KAAK,IAAI,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACzD,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,KAAe;IACtC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;IACtD,IAAI,MAAoC,CAAC;IACzC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,OAAO;QAC3C,IAAI,CAAC,MAAM;YAAE,MAAM,GAAG,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;aACjC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAC1B,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,EAAE,IAAI,EAAE,KAAK,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED,SAAS,cAAc,CAAC,EAAU,EAAE,IAAY;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,OAAO,aAAa,EAAE,SAAS,OAAO,aAAa,EAAE,QAAQ,CAAC;AAChE,CAAC"}

package/dist/render/path-guard.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureSafeDestinationAncestors(projectRoot: string, relativePath: string, display: string): void;
+//# sourceMappingURL=path-guard.d.ts.map

package/dist/render/path-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-guard.d.ts","sourceRoot":"","sources":["../../src/render/path-guard.ts"],"names":[],"mappings":"AAIA,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,IAAI,CAuBN"}

package/dist/render/path-guard.js

@@ -0,0 +1,34 @@
+import { lstatSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { PrayError } from "../errors.js";
+export function ensureSafeDestinationAncestors(projectRoot, relativePath, display) {
+    const parent = dirname(relativePath.replaceAll("\\", "/"));
+    if (parent === ".")
+        return;
+    let current = projectRoot;
+    for (const component of parent.split("/")) {
+        if (!component || component === ".")
+            continue;
+        current = resolve(current, component);
+        try {
+            const metadata = lstatSync(current);
+            if (metadata.isSymbolicLink()) {
+                throw PrayError.render(`refusing to write \`${display}\` because a destination parent is a symbolic link`);
+            }
+            if (!metadata.isDirectory()) {
+                throw PrayError.render(`refusing to write \`${display}\`; a destination parent is not a directory`);
+            }
+        }
+        catch (error) {
+            if (!isNotFound(error))
+                throw error;
+        }
+    }
+}
+function isNotFound(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+//# sourceMappingURL=path-guard.js.map

package/dist/render/path-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-guard.js","sourceRoot":"","sources":["../../src/render/path-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,UAAU,8BAA8B,CAC5C,WAAmB,EACnB,YAAoB,EACpB,OAAe;IAEf,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO;IAC3B,IAAI,OAAO,GAAG,WAAW,CAAC;IAC1B,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,GAAG;YAAE,SAAS;QAC9C,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC9B,MAAM,SAAS,CAAC,MAAM,CACpB,uBAAuB,OAAO,oDAAoD,CACnF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5B,MAAM,SAAS,CAAC,MAAM,CACpB,uBAAuB,OAAO,6CAA6C,CAC5E,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA0B,CAAC,IAAI,KAAK,QAAQ,CAC9C,CAAC;AACJ,CAAC"}

package/dist/render/project.d.ts

@@ -1,8 +1,10 @@
 import { normalizeLineEndings } from "../hashing.js";
+import type { Lockfile } from "../lockfile/types.js";
 import type { ResolvedProject } from "../resolve/types.js";
 import type { RenderedTarget } from "./types.js";
 export declare function renderProject(project: ResolvedProject): RenderedTarget[];
-export declare function writeRenderedTargets(project: ResolvedProject, rendered: RenderedTarget[]): void;
+export declare function writeRenderedTargets(project: ResolvedProject, rendered: RenderedTarget[], previousLockfile?: Lockfile): void;
+export declare function layoutRenderedTargets(project: ResolvedProject, rendered: RenderedTarget[]): RenderedTarget[];
 export { plannedProvisionedFiles } from "./provisioned.js";
 export { normalizeLineEndings };
 //# sourceMappingURL=project.d.ts.map

package/dist/render/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/render/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAIrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,EAAE,CAUxE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,EAAE,GACzB,IAAI,CAQN;AAaD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/render/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAW3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,EAAE,CAUxE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,EAAE,EAC1B,gBAAgB,CAAC,EAAE,QAAQ,GAC1B,IAAI,CAkBN;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,EAAE,GACzB,cAAc,EAAE,CAmBlB;AAcD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/render/project.js

@@ -1,10 +1,14 @@
-import { mkdirSync, writeFileSync } from "node:fs";
+import { mkdirSync } from "node:fs";
 import { resolve } from "node:path";
 import { normalizeLineEndings } from "../hashing.js";
 import { targetMode, targetScoped } from "../manifest/destination.js";
-import { validateProjectRelativePath } from "../manifest/validate.js";
+import { validateDestinationPath } from "../manifest/validate.js";
+import { ensureHtmlCommentComposeDest } from "./compose-dest.js";
+import { materializeProvisionedExports } from "./dest.js";
 import { renderLegacyCompose } from "./legacy.js";
-import { materializeProvisionedExports } from "./provisioned.js";
+import { relocateManagedSpans } from "./patch.js";
+import { ensureSafeDestinationAncestors } from "./path-guard.js";
+import { layoutRenderedContent, writeRenderedContent, } from "./rendered-dest.js";
 import { renderScopedCompose } from "./scoped.js";
 export function renderProject(project) {
     const rendered = [];
@@ -17,16 +21,31 @@ export function renderProject(project) {
     }
     return rendered;
 }
-export function writeRenderedTargets(project, rendered) {
+export function writeRenderedTargets(project, rendered, previousLockfile) {
     for (const target of rendered) {
-        validateProjectRelativePath(target.path);
+        validateDestinationPath(target.path);
+        ensureSafeDestinationAncestors(project.projectRoot, target.path, target.path);
         const path = resolve(project.projectRoot, target.path);
         mkdirSync(resolve(path, ".."), { recursive: true });
-        writeFileSync(path, target.content, "utf8");
+        ensureSafeDestinationAncestors(project.projectRoot, target.path, target.path);
+        writeRenderedContent(path, target.path, target.content);
     }
-    materializeProvisionedExports(project);
+    materializeProvisionedExports(project, previousLockfile);
+}
+export function layoutRenderedTargets(project, rendered) {
+    return rendered.map((target) => {
+        validateDestinationPath(target.path);
+        ensureSafeDestinationAncestors(project.projectRoot, target.path, target.path);
+        const content = layoutRenderedContent(resolve(project.projectRoot, target.path), target.path, target.content);
+        return {
+            ...target,
+            content,
+            managedSpans: relocateManagedSpans(content, target.managedSpans),
+        };
+    });
 }
 function renderTarget(project, target, output) {
+    ensureHtmlCommentComposeDest(output);
     if (targetScoped(target) && targetMode(target) === "compose") {
         return renderScopedCompose(project, target, output);
     }

package/dist/render/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/render/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAwB,EACxB,QAA0B;IAE1B,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,2BAA2B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACvD,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,6BAA6B,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CACnB,OAAwB,EACxB,MAAsB,EACtB,MAAc;IAEd,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/render/project.ts"],"names":[],"mappings":"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"}

package/dist/render/provisioned.d.ts

@@ -2,8 +2,9 @@ import type { ResolvedProject } from "../resolve/types.js";
 export interface PlannedProvisionedFile {
     path: string;
     source: string;
+    package: string;
+    export: string;
 }
 export declare function plannedProvisionedFiles(project: ResolvedProject): PlannedProvisionedFile[];
-export declare function materializeProvisionedExports(project: ResolvedProject): void;
 export declare function expectedProvisionedBytes(source: string, symbols: Record<string, string>): Buffer;
 //# sourceMappingURL=provisioned.d.ts.map

package/dist/render/provisioned.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provisioned.d.ts","sourceRoot":"","sources":["../../src/render/provisioned.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG5E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,sBAAsB,EAAE,CAqC1B;AAcD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAW5E;AACD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAWR"}
+{"version":3,"file":"provisioned.d.ts","sourceRoot":"","sources":["../../src/render/provisioned.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG5E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,sBAAsB,EAAE,CAqC1B;AAeD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAWR"}