@poe-platform/safe-bash 0.1.811 → 0.1.812

package/dist/safe-bash/command-chunks/{command-engine-BEWABZ75.js → command-engine-BCUQGJJ4.js}

@@ -8781,7 +8781,8 @@ import {
 import { createPresentation } from "../../safe-bash-presentation-engine/creation.js";
 import {
   addSlide,
-  mutateSlides
+  mutateSlides,
+  stageRetainedSlideSettings
 } from "../../safe-bash-presentation-engine/slides.js";
 import { duplicateSlides } from "../../safe-bash-presentation-engine/slide-copy.js";
 import { importSlides } from "../../safe-bash-presentation-engine/slide-import.js";
@@ -11683,7 +11684,7 @@ var declaredOperations = {
   "xml.set": xmlSetSchema,
   capabilities: capabilitiesSchema
 };
-async function execute(request, options2) {
+async function executeRequest(request, options2, owned) {
   if (request.args?.[0] instanceof Uint8Array && request.args[0].length === 4 && request.args[0].every((byte, index) => byte === [100, 105, 102, 102][index]))
     return executeDiffCommand(request, options2);
   const output3 = { json: false, operation: "help" };
@@ -11727,7 +11728,24 @@ async function execute(request, options2) {
     output3.json = args.json;
     output3.operation = args.operation;
     const operation2 = args.operation;
-    if ((args.operation === "inspect" || args.operation === "text.get" || args.operation === "fields.list" || args.operation === "fields.get" || args.operation === "xml.get") && request.streaming) {
+    if (args.operation === "slides.set" && request.streaming) {
+      if (args.token) decodeSelectionToken2(args.token);
+      const input = await request.streaming.openInput(args.input, Math.min(options2.context.limits.maxBytes, options2.context.archiveLimits.maxArchiveBytes));
+      const destination = args.inPlace ? args.input : args.output;
+      const dryRun = args.dryRun ?? false;
+      const staged = await stageRetainedSlideSettings(input, {
+        ...args.mutation,
+        selection: args.selection ?? (args.token ? { token: args.token } : { kind: "slide", ...args.slide === void 0 ? {} : { position: { coordinateSystem: "one-based", value: args.slide } }, ...args.all ? { all: true } : {} }),
+        allowEmpty: args.allowEmpty ?? false
+      }, { ...options2.context, signal: request.signal, workingStorage: request.streaming.workingStorage }, { json: args.json, dryRun, ...destination === void 0 ? {} : { destination }, maxOutputBytes: options2.maxOutputBytes });
+      owned.push(staged);
+      stagedOutput = staged.output;
+      if (destination && destination !== "-") {
+        if (!request.publishOutput) throw Object.assign(new Error("Output publication capability is unavailable."), { code: "publication-unsupported" });
+        publication = { inputPath: args.input, outputPath: destination, bytes: staged.bytes(), originalBytes: input, inPlace: args.inPlace ?? false, force: args.force ?? false, dryRun };
+      }
+      result = success(operation2, null);
+    } else if ((args.operation === "inspect" || args.operation === "text.get" || args.operation === "fields.list" || args.operation === "fields.get" || args.operation === "xml.get") && request.streaming) {
       if (args.token) decodeSelectionToken2(args.token);
       const input = await request.streaming.openInput(args.input, Math.min(options2.context.limits.maxBytes, options2.context.archiveLimits.maxArchiveBytes));
       const hash = sha2564.create();
@@ -13778,6 +13796,7 @@ ${xml.xml}
     await stagedOutput?.close().catch(() => {
     });
     stagedOutput = void 0;
+    if (error instanceof OfficeError16 && error.code === "resource-limit" && error.phase === "publish") return outputLimitFailure(output3.operation, output3.json);
     if (request.signal.aborted)
       return { exitCode: 130, stdout: new Uint8Array(), stderr: new Uint8Array() };
     const office = error instanceof OfficeError16 ? error : void 0;
@@ -13806,24 +13825,8 @@ ${xml.xml}
     human = `pptx: ${diagnostic.code}: ${diagnostic.message}
 `;
   }
-  if (stagedOutput) {
-    let failed = false;
-    try {
-      await stagedOutput.write(request.streaming.stdout);
-    } catch (error) {
-      failed = true;
-      throw error;
-    } finally {
-      try {
-        await stagedOutput.close();
-      } catch (error) {
-        if (!failed) await Promise.reject(error);
-      }
-    }
-    return { exitCode: 0, stdout: new Uint8Array(), stderr: new Uint8Array() };
-  }
   const { json, operation } = output3;
-  const encoded = binary ?? new TextEncoder().encode(
+  const encoded = (stagedOutput ? new Uint8Array() : binary) ?? new TextEncoder().encode(
     json ? `${JSON.stringify(result)}
 ` : human ?? `${JSON.stringify(result.data, null, 2)}
 `
@@ -13893,7 +13896,8 @@ ${JSON.stringify(failure.data)}
   if (publication && result.ok) {
     try {
       request.signal.throwIfAborted();
-      await request.publishOutput(publication);
+      if (publication.bytes instanceof Uint8Array) await request.publishOutput(publication);
+      else if (request.streaming) await request.publishOutput(publication);
     } catch (error) {
       if (request.signal.aborted)
         return { exitCode: 130, stdout: new Uint8Array(), stderr: new Uint8Array() };
@@ -13933,6 +13937,22 @@ ${JSON.stringify(failure.data)}
       };
     }
   }
+  if (stagedOutput) {
+    let failed = false;
+    try {
+      await stagedOutput.write(request.streaming.stdout);
+    } catch (error) {
+      failed = true;
+      throw error;
+    } finally {
+      try {
+        await stagedOutput.close();
+      } catch (error) {
+        if (!failed) await Promise.reject(error);
+      }
+    }
+    return { exitCode: 0, stdout: new Uint8Array(), stderr: new Uint8Array() };
+  }
   if (operation === "validate" && request.streaming) {
     request.signal.throwIfAborted();
     await (json || result.ok ? request.streaming.stdout : request.streaming.stderr).write(encoded);
@@ -13945,6 +13965,23 @@ ${JSON.stringify(failure.data)}
     stderr: json || result.ok ? new Uint8Array() : encoded
   };
 }
+async function execute(request, options2) {
+  const owned = [];
+  let failed = false;
+  try {
+    const result = await executeRequest(request, options2, owned);
+    failed = result.exitCode !== 0;
+    return result;
+  } catch (error) {
+    failed = true;
+    throw error;
+  } finally {
+    const results = await Promise.allSettled(owned.map((value) => value.close()));
+    if (!failed) {
+      for (const result of results) if (result.status === "rejected") await Promise.reject(result.reason);
+    }
+  }
+}
 function createPptxCommandEngine(settings = {}) {
   const context = resourceContext(settings.context);
   const options2 = {

package/dist/safe-bash/command-chunks/{engine-AXXFTGCL-QBQNBI6K.js → engine-LAUEWYSQ-DQCEI5HE.js}

@@ -1,7 +1,7 @@
 import {
   Si,
   gi
-} from "./chunk-5MB64DWR.js";
+} from "./chunk-HWQ2UHMT.js";
 import "./chunk-Z7ESJVFP.js";
 import "./chunk-WHWIZ2B7.js";
 import "./chunk-65DS4IOB.js";

package/dist/safe-bash-command-apply-patch/apply.js

@@ -1,10 +1,10 @@
 import {
   execute
-} from "../safe-bash/command-chunks/chunk-2VCKUNDZ.js";
-import "../safe-bash/command-chunks/chunk-Z5QOVRVH.js";
+} from "../safe-bash/command-chunks/chunk-B2C3UPJS.js";
+import "../safe-bash/command-chunks/chunk-SU26FZLJ.js";
 import "../safe-bash/command-chunks/chunk-66QPYWEF.js";
-import "../safe-bash/command-chunks/chunk-HARUYHH7.js";
-import "../safe-bash/command-chunks/chunk-DPR5CYQV.js";
+import "../safe-bash/command-chunks/chunk-5HUICAWD.js";
+import "../safe-bash/command-chunks/chunk-XITDDJFT.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   execute

package/dist/safe-bash-command-apply-patch/index.js

@@ -1,12 +1,12 @@
 import {
   execute
-} from "../safe-bash/command-chunks/chunk-2VCKUNDZ.js";
-import "../safe-bash/command-chunks/chunk-Z5QOVRVH.js";
+} from "../safe-bash/command-chunks/chunk-B2C3UPJS.js";
+import "../safe-bash/command-chunks/chunk-SU26FZLJ.js";
 import {
   settings
 } from "../safe-bash/command-chunks/chunk-66QPYWEF.js";
-import "../safe-bash/command-chunks/chunk-HARUYHH7.js";
-import "../safe-bash/command-chunks/chunk-DPR5CYQV.js";
+import "../safe-bash/command-chunks/chunk-5HUICAWD.js";
+import "../safe-bash/command-chunks/chunk-XITDDJFT.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 
 // packages/safe-bash-command-apply-patch/src/index.ts

package/dist/safe-bash-command-apply-patch/matcher.js

@@ -2,8 +2,8 @@ import {
   contents,
   normalized,
   normalizedCharacter
-} from "../safe-bash/command-chunks/chunk-Z5QOVRVH.js";
-import "../safe-bash/command-chunks/chunk-DPR5CYQV.js";
+} from "../safe-bash/command-chunks/chunk-SU26FZLJ.js";
+import "../safe-bash/command-chunks/chunk-XITDDJFT.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   contents,

package/dist/safe-bash-command-apply-patch/parser.js

@@ -2,8 +2,8 @@ import {
   parse,
   parseRecords,
   targetPath
-} from "../safe-bash/command-chunks/chunk-HARUYHH7.js";
-import "../safe-bash/command-chunks/chunk-DPR5CYQV.js";
+} from "../safe-bash/command-chunks/chunk-5HUICAWD.js";
+import "../safe-bash/command-chunks/chunk-XITDDJFT.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   parse,

package/dist/safe-bash-command-apply-patch/shared.d.ts

@@ -1,3 +1,4 @@
+import { PagedStorageCache } from "@poe-platform/safe-fs/storage";
 import { type CommandContext, type FsError } from "../safe-bash-contracts/index.js";
 import type { ApplyPatchLimits } from "./options.js";
 export declare class PatchError extends Error {
@@ -12,6 +13,7 @@ export declare class FileFailure extends Error {
 export declare class Work {
     readonly context: CommandContext;
     readonly limits: ApplyPatchLimits;
+    readonly documentCache: PagedStorageCache;
     private units;
     private nextYield;
     private closed;

package/dist/safe-bash-command-apply-patch/shared.js

@@ -3,7 +3,7 @@ import {
   PatchError,
   Work,
   diagnostic
-} from "../safe-bash/command-chunks/chunk-DPR5CYQV.js";
+} from "../safe-bash/command-chunks/chunk-XITDDJFT.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   FileFailure,

package/dist/safe-bash-command-ffmpeg/index.js

@@ -20,7 +20,7 @@ import {
   sliceMp4,
   srtAst,
   webvttAst
-} from "../safe-bash/command-chunks/chunk-VU3EQF7F.js";
+} from "../safe-bash/command-chunks/chunk-2JSDKQ4J.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 
 // packages/safe-bash-command-ffmpeg/src/index.ts

package/dist/safe-bash-command-ffprobe/index.js

@@ -1,8 +1,8 @@
 import {
   createFfprobeCommand
-} from "../safe-bash/command-chunks/chunk-YSY6R6AS.js";
+} from "../safe-bash/command-chunks/chunk-XVLWZTPY.js";
 import "../safe-bash/command-chunks/chunk-MGBHGZEX.js";
-import "../safe-bash/command-chunks/chunk-VU3EQF7F.js";
+import "../safe-bash/command-chunks/chunk-2JSDKQ4J.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 
 // packages/safe-bash-command-ffprobe/src/index.ts

package/dist/safe-bash-command-ffprobe/media.js

@@ -10,9 +10,9 @@ import {
   loadManifestResources,
   resolvePath,
   rethrowRuntimeError
-} from "../safe-bash/command-chunks/chunk-YSY6R6AS.js";
+} from "../safe-bash/command-chunks/chunk-XVLWZTPY.js";
 import "../safe-bash/command-chunks/chunk-MGBHGZEX.js";
-import "../safe-bash/command-chunks/chunk-VU3EQF7F.js";
+import "../safe-bash/command-chunks/chunk-2JSDKQ4J.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   createFfprobeCommand,

package/dist/safe-bash-command-pandoc/command.js

@@ -2,7 +2,7 @@ import {
   eR,
   iR,
   jh
-} from "../safe-bash/command-chunks/chunk-KL3OIBKB.js";
+} from "../safe-bash/command-chunks/chunk-ZEX53S5I.js";
 import "../safe-bash/command-chunks/chunk-7QRIAJEQ.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";

package/dist/safe-bash-command-pandoc/index.js

@@ -24,7 +24,7 @@ import {
   tl,
   tr,
   vP
-} from "../safe-bash/command-chunks/chunk-KL3OIBKB.js";
+} from "../safe-bash/command-chunks/chunk-ZEX53S5I.js";
 import "../safe-bash/command-chunks/chunk-7QRIAJEQ.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";

package/dist/safe-bash-command-patch/index.js

@@ -1,7 +1,7 @@
 import {
   patchCommand
-} from "../safe-bash/command-chunks/chunk-72C3TZ2U.js";
-import "../safe-bash/command-chunks/chunk-WH3TIOTS.js";
+} from "../safe-bash/command-chunks/chunk-3Q247UDJ.js";
+import "../safe-bash/command-chunks/chunk-ZEGNRZV2.js";
 import {
   evalSyncPatch
 } from "../safe-bash/command-chunks/chunk-KSY3QHLY.js";

package/dist/safe-bash-command-patch/patch-publication.js

@@ -1,6 +1,6 @@
 import {
   PatchPublication
-} from "../safe-bash/command-chunks/chunk-WH3TIOTS.js";
+} from "../safe-bash/command-chunks/chunk-ZEGNRZV2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   PatchPublication

package/dist/safe-bash-command-patch/patch.js

@@ -1,7 +1,7 @@
 import {
   patchCommand
-} from "../safe-bash/command-chunks/chunk-72C3TZ2U.js";
-import "../safe-bash/command-chunks/chunk-WH3TIOTS.js";
+} from "../safe-bash/command-chunks/chunk-3Q247UDJ.js";
+import "../safe-bash/command-chunks/chunk-ZEGNRZV2.js";
 import "../safe-bash/command-chunks/chunk-JKLOBSMP.js";
 import "../safe-bash/command-chunks/chunk-2VLAXKTS.js";
 import "../safe-bash/command-chunks/chunk-MOZD7RUY.js";

package/dist/safe-bash-command-pdftk/index.js

@@ -1,5 +1,38 @@
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 
+// packages/safe-bash-command-pdftk/src/retained-fields.ts
+async function* retainedFieldReport(document, utf8, signal) {
+  const encoder = new TextEncoder();
+  let work = 0;
+  async function* line(prefix, value) {
+    let part = prefix;
+    for (const char of String(value)) {
+      const code = char.codePointAt(0);
+      part += !utf8 && code > 127 ? `&#${code};` : char;
+      if (part.length >= 4096) {
+        signal.throwIfAborted();
+        if (++work % 16 === 0) await new Promise((resolve) => setTimeout(resolve, 0));
+        yield encoder.encode(part);
+        part = "";
+      }
+    }
+    signal.throwIfAborted();
+    yield encoder.encode(part + "\n");
+  }
+  for await (const field of document.formFieldDetails()) {
+    yield encoder.encode("---\n");
+    yield* line("FieldType: ", field.type === "checkbox" ? "Button" : field.type === "choice" ? "Choice" : "Text");
+    yield* line("FieldName: ", field.name);
+    if (field.altName) yield* line("FieldNameAlt: ", field.altName);
+    yield* line("FieldFlags: ", field.flags);
+    for await (const value of field.values()) yield* line("FieldValue: ", value);
+    if (field.defaultValue !== void 0 && field.defaultValue !== "") yield* line("FieldValueDefault: ", field.defaultValue);
+    yield* line("FieldJustification: ", field.justification);
+    for await (const option of field.options()) yield* line("FieldStateOption: ", option);
+    if (field.maxLength !== void 0) yield* line("FieldMaxLength: ", field.maxLength);
+  }
+}
+
 // packages/safe-bash-command-pdftk/src/retained.ts
 import { PdfError, PdfFileSource, PdfRetainedDocument, retainedCosObjects } from "../pdf-ast/index.js";
 import { FsError } from "../safe-bash-contracts/errors.js";
@@ -284,7 +317,7 @@ async function executeRetainedPdftk(context, options) {
     }
     const primary = options.inputs[0];
     document = await PdfRetainedDocument.open(inputs.get(primary.file), storage, { signal, recovery: "strict", ...primary.password ? { password: primary.password } : {} });
-    output = await PdfFileSource.fromStream(context.fs, storage.directory, retainedAnnotationReport(document, storage, options.operation.endsWith("_utf8"), signal), { signal });
+    output = await PdfFileSource.fromStream(context.fs, storage.directory, options.operation === "dump_data_fields" || options.operation === "dump_data_fields_utf8" ? retainedFieldReport(document, options.operation.endsWith("_utf8"), signal) : retainedAnnotationReport(document, storage, options.operation.endsWith("_utf8"), signal), { signal });
     const destination = options.outputTarget;
     if (!destination || destination === "-") for await (const bytes of output.stream(0, output.size, signal)) await writeBytes(context.stdout, bytes, signal);
     else {
@@ -2155,7 +2188,7 @@ async function executePdftk(context) {
     const carrier = getCommandArguments(context);
     const argv = [...carrier.args];
     const parsed = await drainSteps(parsePdftkArgumentsSteps(argv), invocation.signal);
-    if (parsed.options && ["dump_data_annots", "dump_data_annots_utf8"].includes(parsed.options.operation)) {
+    if (parsed.options && ["dump_data_annots", "dump_data_annots_utf8", "dump_data_fields", "dump_data_fields_utf8"].includes(parsed.options.operation)) {
       return await executeRetainedPdftk({ ...context, signal: invocation.signal, stdout: invocation.child(context.stdout).output }, parsed.options);
     }
     const vfsFiles = /* @__PURE__ */ new Map();

package/dist/safe-bash-command-pptx/command-engine.d.ts

@@ -17,9 +17,11 @@ export interface AdmittedCommandEngineOptions {
 }
 import type { PptxPublicationRequest } from "../safe-bash-presentation-engine/publication.js";
 export type { PptxPublicationRequest } from "../safe-bash-presentation-engine/publication.js";
-export interface PptxCommandRequest {
-    readonly streaming?: import("./streaming-inputs.js").PptxStreamingIO;
-    readonly publishOutput?: (publication: PptxPublicationRequest) => Promise<void>;
+export type PptxStreamPublicationRequest = Omit<PptxPublicationRequest, "bytes" | "originalBytes"> & {
+    readonly bytes: import("../safe-bash-contracts/index.js").ByteSource;
+    readonly originalBytes: import("./streaming-inputs.js").PptxRetainedInput;
+};
+interface PptxRequestBase {
     readonly preflightOutput?: (publication: PptxPublicationRequest) => Promise<void>;
     /** Trusted adapter transaction: either every requested file is published or none is. */
     readonly publishOutputs?: (publications: readonly PptxPublicationRequest[]) => Promise<void>;
@@ -27,6 +29,13 @@ export interface PptxCommandRequest {
     readonly signal: AbortSignal;
     readonly readInput: (path: string, maxBytes: number) => Promise<Uint8Array>;
 }
+export type PptxCommandRequest = PptxRequestBase & ({
+    readonly streaming?: undefined;
+    readonly publishOutput?: (publication: PptxPublicationRequest) => Promise<void>;
+} | {
+    readonly streaming: import("./streaming-inputs.js").PptxStreamingIO;
+    readonly publishOutput?: (publication: PptxPublicationRequest | PptxStreamPublicationRequest) => Promise<void>;
+});
 export interface PptxCommandOutput {
     readonly exitCode: number;
     readonly stdout: Uint8Array;

package/dist/safe-bash-command-pptx/engine.d.ts

@@ -1,4 +1,4 @@
 export * from "../safe-bash-presentation-engine/index.js";
-import type { PptxCommandEngine, PptxCommandEngineOptions, PptxCommandRequest, PptxCommandOutput, PptxPublicationRequest } from "./command-engine.js";
-export type { PptxCommandEngine, PptxCommandEngineOptions, PptxCommandRequest, PptxCommandOutput, PptxPublicationRequest };
+import type { PptxCommandEngine, PptxCommandEngineOptions, PptxCommandRequest, PptxCommandOutput, PptxPublicationRequest, PptxStreamPublicationRequest } from "./command-engine.js";
+export type { PptxCommandEngine, PptxCommandEngineOptions, PptxCommandRequest, PptxCommandOutput, PptxPublicationRequest, PptxStreamPublicationRequest };
 export declare function createPptxCommandEngine(settings?: PptxCommandEngineOptions): PptxCommandEngine;

package/dist/safe-bash-command-pptx/engine.js

@@ -27,7 +27,7 @@ function createPptxCommandEngine(settings = {}) {
   };
   return Object.freeze({
     async execute(request) {
-      const mod = await (cachedPptxEngineMod ??= import("../safe-bash/command-chunks/command-engine-BEWABZ75.js"));
+      const mod = await (cachedPptxEngineMod ??= import("../safe-bash/command-chunks/command-engine-BCUQGJJ4.js"));
       return mod.createPptxCommandEngine(ownedSettings).execute(request);
     }
   });

package/dist/safe-bash-command-ssconvert/index.js

@@ -10,7 +10,7 @@ import {
   gt,
   j,
   oe
-} from "../safe-bash/command-chunks/chunk-5MB64DWR.js";
+} from "../safe-bash/command-chunks/chunk-HWQ2UHMT.js";
 import {
   a,
   g,
@@ -719,7 +719,7 @@ var le;
 function wr(...u) {
   return le ??= V({ read: readZipArchiveEntries, write: createStoredZipArchive }), le(...u);
 }
-var H = de(async (u) => (await import("../safe-bash/command-chunks/engine-AXXFTGCL-QBQNBI6K.js")).createEngine(u), true, wr);
+var H = de(async (u) => (await import("../safe-bash/command-chunks/engine-LAUEWYSQ-DQCEI5HE.js")).createEngine(u), true, wr);
 var Do = H.createSsconvertCommand;
 var To = H.createSsconvertCommands;
 var Uo = H.ssconvertCommands;

package/dist/safe-bash-diff-engine/document.d.ts

@@ -1,7 +1,8 @@
-import { PagedStorage } from "@poe-platform/safe-fs/storage";
+import { PagedStorage, type PagedStorageCache } from "@poe-platform/safe-fs/storage";
 import { type ByteSource, type CommandContext } from "../safe-bash-contracts/index.js";
 export interface DocumentBudget {
     readonly context: CommandContext;
+    readonly documentCache?: PagedStorageCache;
     step(amount?: number): void;
     checkpoint(): void | Promise<void>;
 }

package/dist/safe-bash-diff-engine/document.js

@@ -11,8 +11,8 @@ async function closeDocumentResources(resources) {
 var IndexedDocument = class {
   constructor(budget, pages = 16) {
     this.budget = budget;
-    this.data = new PagedStorage(budget.context, pages);
-    this.index = new PagedStorage(budget.context, pages);
+    this.data = new PagedStorage(budget.context, pages, budget.documentCache);
+    this.index = new PagedStorage(budget.context, pages, budget.documentCache);
     budget.context.registerCleanup?.(() => this.close());
   }
   budget;
@@ -87,8 +87,10 @@ var IndexedDocument = class {
     const bytes = await this.index.read(8 + position * 24, 24);
     const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
     const line = { start: view.getFloat64(0, true), end: view.getFloat64(8, true), hash: view.getUint32(16, true) };
-    if (this.cache.size === 256) this.cache.delete(this.cache.keys().next().value);
-    this.cache.set(position, line);
+    if (!this.budget.documentCache) {
+      if (this.cache.size === 256) this.cache.delete(this.cache.keys().next().value);
+      this.cache.set(position, line);
+    }
     return line;
   }
   async equal(position, other, otherPosition) {
@@ -110,6 +112,7 @@ var IndexedDocument = class {
     return true;
   }
   retainComparison(position, line, bytes) {
+    if (this.budget.documentCache) return;
     if (this.comparisons.has(position)) return;
     if (this.comparisons.size === 512) this.comparisons.delete(this.comparisons.keys().next().value);
     this.comparisons.set(position, { line, bytes });

package/dist/safe-bash-presentation-engine/command-placeholder.js

@@ -1,7 +1,7 @@
 import {
   insertPlaceholder
-} from "../safe-bash/command-chunks/chunk-ZHRGYR7B.js";
-import "../safe-bash/command-chunks/chunk-5LI2DLNZ.js";
+} from "../safe-bash/command-chunks/chunk-FDCIPJBQ.js";
+import "../safe-bash/command-chunks/chunk-CJQSAATC.js";
 import "../safe-bash/command-chunks/chunk-KJ4XXZIL.js";
 import "../safe-bash/command-chunks/chunk-ATTWQVR2.js";
 import "../safe-bash/command-chunks/chunk-LXLLA4PM.js";
@@ -15,7 +15,8 @@ import "../safe-bash/command-chunks/chunk-EHSM5ZQS.js";
 import "../safe-bash/command-chunks/chunk-2CORNDGF.js";
 import "../safe-bash/command-chunks/chunk-PMAM4N33.js";
 import "../safe-bash/command-chunks/chunk-456PHA3L.js";
-import "../safe-bash/command-chunks/chunk-5OO2P27R.js";
+import "../safe-bash/command-chunks/chunk-NARD63DY.js";
+import "../safe-bash/command-chunks/chunk-ZXR6LXV5.js";
 import "../safe-bash/command-chunks/chunk-L5MCW6CM.js";
 import "../safe-bash/command-chunks/chunk-6M6TM5Z5.js";
 import "../safe-bash/command-chunks/chunk-B5LDP7AA.js";

package/dist/safe-bash-presentation-engine/index.d.ts

@@ -27,7 +27,7 @@ export type { PartView, PackageView, PartRelationship } from "./package-view.js"
 export type { XmlElementView } from "./xml-view.js";
 export { Presentation, type PresentationModel, type PresentationContext, type PresentationPublication } from "./presentation-model.js";
 export { createPresentation, type CreatePresentationOptions, type PresentationProperties, type PresentationSlideInput, type PresentationTextShape } from "./creation.js";
-export { addSlide, mutateSlides, openRetainedSlideSettings, type RetainedSlideSettings, type MutateSlidesOptions, type AddSlideOptions, type PlaceholderText } from "./slides.js";
+export { addSlide, mutateSlides, openRetainedSlideSettings, stageRetainedSlideSettings, type RetainedSlideSettings, type MutateSlidesOptions, type AddSlideOptions, type PlaceholderText } from "./slides.js";
 export { removeSlides, type RemoveSlidesOptions } from "./slide-removal.js";
 export { listLinks, setLink, removeLink, openLinkSession, type LinkAction, type LinkOptions, type SetLinkOptions, type LinkSession, type LinkData } from "./links.js";
 export { ActionSetting, Hyperlink, _Hyperlink, PP_ACTION, PP_ACTION_TYPE, LinkShape, LinkRun, type ActionValue, type LinkModelOwner, type LinkShapeIdentity } from "./links-model.js";

package/dist/safe-bash-presentation-engine/index.js

@@ -1,6 +1,3 @@
-import {
-  openPackageArchive
-} from "../safe-bash/command-chunks/chunk-ZXR6LXV5.js";
 import {
   mutateTags,
   readTags
@@ -95,7 +92,7 @@ import {
 } from "../safe-bash/command-chunks/chunk-JFYWVQ4V.js";
 import {
   insertPlaceholder
-} from "../safe-bash/command-chunks/chunk-ZHRGYR7B.js";
+} from "../safe-bash/command-chunks/chunk-FDCIPJBQ.js";
 import {
   sanitize
 } from "../safe-bash/command-chunks/chunk-M7QE2MN7.js";
@@ -149,7 +146,7 @@ import {
   Presentation,
   SlideLayout,
   SlideLayouts
-} from "../safe-bash/command-chunks/chunk-5LI2DLNZ.js";
+} from "../safe-bash/command-chunks/chunk-CJQSAATC.js";
 import {
   getXmlPart,
   openRetainedXmlPart,
@@ -281,8 +278,12 @@ import {
 import {
   addSlide,
   mutateSlides,
-  openRetainedSlideSettings
-} from "../safe-bash/command-chunks/chunk-5OO2P27R.js";
+  openRetainedSlideSettings,
+  stageRetainedSlideSettings
+} from "../safe-bash/command-chunks/chunk-NARD63DY.js";
+import {
+  openPackageArchive
+} from "../safe-bash/command-chunks/chunk-ZXR6LXV5.js";
 import "../safe-bash/command-chunks/chunk-L5MCW6CM.js";
 import {
   CoreProperties,
@@ -780,6 +781,7 @@ export {
   shapePathXml,
   shapePresets,
   splitSlides,
+  stageRetainedSlideSettings,
   stageRetainedXmlPart,
   textCapitalizationStyles,
   textStrikeStyles,

package/dist/safe-bash-presentation-engine/presentation-model.js

@@ -1,6 +1,6 @@
 import {
   Presentation
-} from "../safe-bash/command-chunks/chunk-5LI2DLNZ.js";
+} from "../safe-bash/command-chunks/chunk-CJQSAATC.js";
 import "../safe-bash/command-chunks/chunk-KJ4XXZIL.js";
 import "../safe-bash/command-chunks/chunk-ATTWQVR2.js";
 import "../safe-bash/command-chunks/chunk-LXLLA4PM.js";
@@ -14,7 +14,8 @@ import "../safe-bash/command-chunks/chunk-EHSM5ZQS.js";
 import "../safe-bash/command-chunks/chunk-2CORNDGF.js";
 import "../safe-bash/command-chunks/chunk-PMAM4N33.js";
 import "../safe-bash/command-chunks/chunk-456PHA3L.js";
-import "../safe-bash/command-chunks/chunk-5OO2P27R.js";
+import "../safe-bash/command-chunks/chunk-NARD63DY.js";
+import "../safe-bash/command-chunks/chunk-ZXR6LXV5.js";
 import "../safe-bash/command-chunks/chunk-L5MCW6CM.js";
 import "../safe-bash/command-chunks/chunk-6M6TM5Z5.js";
 import "../safe-bash/command-chunks/chunk-B5LDP7AA.js";

package/dist/safe-bash-presentation-engine/retained-slide-publication.d.ts

@@ -0,0 +1,24 @@
+import type { ByteSource } from './contracts.js';
+import { type RetainedPackageContext } from './retained-package.js';
+import type { MutateSlidesOptions } from './slides.js';
+import { type StagedOutput } from './retained-output.js';
+export interface RetainedSlideSource {
+    readonly size: number;
+    read(position: number, maximum: number, options: {
+        readonly signal: AbortSignal;
+    }): Promise<Uint8Array>;
+    stream(): ByteSource;
+}
+/** Owns archive and response staging; borrows the caller's immutable input. */
+export declare function stageRetainedSlideSettings(input: RetainedSlideSource, options: Omit<MutateSlidesOptions, 'position'>, settings: RetainedPackageContext, output: {
+    json: boolean;
+    dryRun: boolean;
+    destination?: string;
+    maxOutputBytes: number;
+}): Promise<Readonly<{
+    bytes: () => ByteSource;
+    size: number;
+    fingerprint: string;
+    output: StagedOutput;
+    close: () => Promise<void>;
+}>>;

package/dist/safe-bash-presentation-engine/slides.d.ts

@@ -33,3 +33,4 @@ export declare function prepareSlideInsertion(reader: PackageReader, options: Ad
 export declare function prepareSlideMutationOptions(options: MutateSlidesOptions, context: SelectionContext): readonly SelectionQuery[];
 export declare function mutateSlides(input: BinaryInput, options: MutateSlidesOptions, context: SelectionContext): Promise<Uint8Array>;
 export { openRetainedSlideSettings, type RetainedSlideSettings } from './retained-slide-settings.js';
+export { stageRetainedSlideSettings } from "./retained-slide-publication.js";

package/dist/safe-bash-presentation-engine/slides.js

@@ -3,8 +3,10 @@ import {
   mutateSlides,
   openRetainedSlideSettings,
   prepareSlideInsertion,
-  prepareSlideMutationOptions
-} from "../safe-bash/command-chunks/chunk-5OO2P27R.js";
+  prepareSlideMutationOptions,
+  stageRetainedSlideSettings
+} from "../safe-bash/command-chunks/chunk-NARD63DY.js";
+import "../safe-bash/command-chunks/chunk-ZXR6LXV5.js";
 import "../safe-bash/command-chunks/chunk-L5MCW6CM.js";
 import "../safe-bash/command-chunks/chunk-DM2CPMB4.js";
 import "../safe-bash/command-chunks/chunk-X7FA7ZD5.js";
@@ -29,5 +31,6 @@ export {
   mutateSlides,
   openRetainedSlideSettings,
   prepareSlideInsertion,
-  prepareSlideMutationOptions
+  prepareSlideMutationOptions,
+  stageRetainedSlideSettings
 };