@poe-platform/safe-bash 0.1.814 → 0.1.815

package/dist/safe-bash-command-patch/patch-gnu-reject.d.ts

@@ -1,4 +1,4 @@
 import { type ReplayPatch, type ReplayOutcome } from "./stored-patch.js";
 import type { Budget } from "../safe-bash-diff-engine/shared.js";
 import type { ByteSource } from "../safe-bash-contracts/index.js";
-export declare function rejectBytes(patch: ReplayPatch, outcomes: readonly ReplayOutcome[], oldName: string | undefined, newName: string | undefined, indexName: string | undefined, reverse: boolean, budget: Budget, format?: "unified" | "context"): ByteSource;
+export declare function rejectBytes(patch: ReplayPatch, outcomes: Iterable<ReplayOutcome> | AsyncIterable<ReplayOutcome>, oldName: string | undefined, newName: string | undefined, indexName: string | undefined, reverse: boolean, budget: Budget, format?: "unified" | "context"): ByteSource;

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

@@ -1,7 +1,8 @@
 import {
   rejectBytes
-} from "../safe-bash/command-chunks/chunk-3JM7E42I.js";
-import "../safe-bash/command-chunks/chunk-CK2WFJZN.js";
+} from "../safe-bash/command-chunks/chunk-GPGLTWNR.js";
+import "../safe-bash/command-chunks/chunk-KASXIRKD.js";
+import "../safe-bash/command-chunks/chunk-KHUT7BB5.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   rejectBytes

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

@@ -1,7 +1,8 @@
 import {
   PatchPublication
-} from "../safe-bash/command-chunks/chunk-5BIQWWLB.js";
-import "../safe-bash/command-chunks/chunk-CK2WFJZN.js";
+} from "../safe-bash/command-chunks/chunk-CFMJXJS5.js";
+import "../safe-bash/command-chunks/chunk-KASXIRKD.js";
+import "../safe-bash/command-chunks/chunk-KHUT7BB5.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   PatchPublication

package/dist/safe-bash-command-patch/patch-text.d.ts

@@ -0,0 +1,13 @@
+import type { ByteSource } from "../safe-bash-contracts/index.js";
+import type { Budget } from "../safe-bash-diff-engine/shared.js";
+/** Replayable UTF-8 text; the owner retains the source until parsing finishes. */
+export type PatchText = string | {
+    readonly bytes: ByteSource;
+    readonly size: number;
+    readonly terminated: boolean;
+};
+export declare function textSize(text: PatchText): number;
+export declare function terminated(text: PatchText): boolean;
+export declare function patchTextBytes(text: PatchText): ByteSource;
+export declare function materializeText(text: PatchText): Promise<string>;
+export declare function equalPatchText(left: PatchText, right: PatchText, budget: Budget): Promise<boolean>;

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

@@ -1,11 +1,12 @@
 import {
   patchCommand
-} from "../safe-bash/command-chunks/chunk-AVGXFWEB.js";
-import "../safe-bash/command-chunks/chunk-3JM7E42I.js";
-import "../safe-bash/command-chunks/chunk-5BIQWWLB.js";
-import "../safe-bash/command-chunks/chunk-CK2WFJZN.js";
-import "../safe-bash/command-chunks/chunk-SW37YCBW.js";
-import "../safe-bash/command-chunks/chunk-VT7UBPAE.js";
+} from "../safe-bash/command-chunks/chunk-44F5TOHZ.js";
+import "../safe-bash/command-chunks/chunk-GPGLTWNR.js";
+import "../safe-bash/command-chunks/chunk-CFMJXJS5.js";
+import "../safe-bash/command-chunks/chunk-KASXIRKD.js";
+import "../safe-bash/command-chunks/chunk-U3C6IT2C.js";
+import "../safe-bash/command-chunks/chunk-YW2VYN4V.js";
+import "../safe-bash/command-chunks/chunk-KHUT7BB5.js";
 import "../safe-bash/command-chunks/chunk-OQNX2OOS.js";
 import "../safe-bash/command-chunks/chunk-AJEQUVDN.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

package/dist/safe-bash-command-patch/stored-patch.d.ts

@@ -1,5 +1,6 @@
+import { PagedStorage } from "@poe-platform/safe-fs/storage";
 import { type TargetDocuments, type TargetLine } from "./stored-target.js";
-import type { FilePatch, Hunk, HunkApplication, HunkLineBuilder, HunkOutcome, PatchLine } from "./unified.js";
+import type { FilePatch, Hunk, HunkApplication, HunkBuilder, HunkLineBuilder, HunkOutcome, PatchLine } from "./unified.js";
 export interface StoredPatchLine {
     readonly kind: PatchLine["kind"];
     readonly text: TargetLine;
@@ -9,18 +10,42 @@ export interface StoredPatchLines {
     read(index: number): Promise<StoredPatchLine>;
 }
 export type PatchLines = PatchLine[] | StoredPatchLines;
-export type ReplayPatch = FilePatch<PatchLines>;
+export interface StoredPatchHunks {
+    readonly length: number;
+    read(index: number): Promise<Hunk<PatchLines>>;
+}
+export type ReplayPatch = FilePatch<PatchLines, Hunk<PatchLines>[] | StoredPatchHunks>;
 export type ReplayOutcome = HunkOutcome<PatchLines>;
-export type ReplayApplication = HunkApplication<PatchLines>;
+export interface OutcomeSink {
+    push(outcome: ReplayOutcome): number | Promise<void>;
+    pop(): ReplayOutcome | undefined | Promise<ReplayOutcome | undefined>;
+}
+export type ReplayApplication = Omit<HunkApplication<PatchLines>, "outcomes"> & {
+    readonly outcomes?: OutcomeSink;
+};
 export declare function patchLine(hunk: Hunk<PatchLines>, index: number): Promise<StoredPatchLine>;
+export declare function patchHunk(patch: ReplayPatch, index: number): Promise<Hunk<PatchLines>>;
+export declare function patchHunks(patch: ReplayPatch): AsyncGenerator<readonly [number, Hunk<PatchLines>]>;
+declare class BodyLines implements StoredPatchLines {
+    readonly start: number;
+    private readonly records;
+    private readonly data;
+    length: number;
+    constructor(start: number, records: PagedStorage, data: PagedStorage);
+    read(index: number): Promise<StoredPatchLine>;
+}
 /** Hunk payloads and fixed-width records share the invocation's caller-backed cache. */
 export declare class PatchBodyStore {
     private readonly data;
     private readonly records;
+    private readonly hunks;
     private dataEnd;
     private recordEnd;
+    private hunkEnd;
     constructor(documents: TargetDocuments);
-    begin(): HunkLineBuilder<StoredPatchLines>;
+    begin(): HunkLineBuilder<BodyLines>;
+    beginHunks(): HunkBuilder<BodyLines, StoredPatchHunks>;
     close(): Promise<void>;
 }
 export declare function reverseStoredPatch(patch: ReplayPatch): ReplayPatch;
+export {};

package/dist/safe-bash-command-patch/stored-target.d.ts

@@ -2,7 +2,8 @@ import { PagedStorage, PagedStorageCache } from "@poe-platform/safe-fs/storage";
 import { IndexedDocument } from "../safe-bash-diff-engine/document.js";
 import { Budget } from "../safe-bash-diff-engine/shared.js";
 import type { ByteSource } from "../safe-bash-contracts/index.js";
-export type TargetLine = string | {
+import { type PatchText } from "./patch-text.js";
+export type TargetLine = PatchText | {
     document: IndexedDocument;
     index: number;
 } | {

package/dist/safe-bash-command-patch/unified.d.ts

@@ -1,8 +1,13 @@
 import { Budget } from "../safe-bash-diff-engine/shared.js";
+import { type PatchText } from "./patch-text.js";
 export interface PatchLine {
     readonly kind: " " | "+" | "-";
     text: string;
 }
+export interface ParsedPatchLine {
+    readonly kind: PatchLine["kind"];
+    readonly text: PatchText;
+}
 export interface Hunk<Lines = PatchLine[]> {
     readonly oldStart: number;
     readonly oldCount: number;
@@ -11,12 +16,12 @@ export interface Hunk<Lines = PatchLine[]> {
     readonly lines: Lines;
     readonly section?: string;
 }
-export interface FilePatch<Lines = PatchLine[]> {
+export interface FilePatch<Lines = PatchLine[], Hunks = Hunk<Lines>[]> {
     readonly oldPath: string;
     readonly newPath: string;
     readonly oldEpoch: boolean;
     readonly newEpoch: boolean;
-    readonly hunks: Hunk<Lines>[];
+    readonly hunks: Hunks;
     readonly oldHeader?: string;
     readonly newHeader?: string;
     readonly indexPath?: string;
@@ -26,7 +31,9 @@ export interface FilePatch<Lines = PatchLine[]> {
 export declare function startIndex(start: number, count: number): number;
 export interface PatchInput {
     readonly length: number;
-    read(index: number): Promise<string | undefined>;
+    read(index: number, prefix?: number): Promise<string | undefined>;
+    matches?(index: number, text: string): Promise<boolean>;
+    body?(index: number, skip: number, incomplete: boolean): Promise<PatchText>;
 }
 export interface UnifiedCursor {
     readonly lines: readonly string[];
@@ -40,9 +47,16 @@ export declare function parseUnified(text: string | PatchInput, budget: Budget):
 export declare function parseUnifiedSection(cursor: IndexedUnifiedCursor | UnifiedCursor, budget: Budget): Promise<FilePatch[]>;
 export interface HunkLineBuilder<Lines> {
     readonly lines: Lines;
-    append(line: PatchLine): void | Promise<void>;
+    append(line: ParsedPatchLine): void | Promise<void>;
+}
+export interface HunkBuilder<Lines, Hunks> {
+    readonly hunks: Hunks;
+    append(hunk: Hunk<Lines>): void | Promise<void>;
 }
 export declare function parseUnifiedReader<Lines>(cursor: IndexedUnifiedCursor, budget: Budget, single: boolean, createLines: () => HunkLineBuilder<Lines>): Promise<FilePatch<Lines>[]>;
+export declare function parseUnifiedReader<Lines, Hunks extends {
+    readonly length: number;
+}>(cursor: IndexedUnifiedCursor, budget: Budget, single: boolean, createLines: () => HunkLineBuilder<Lines>, createHunks: () => HunkBuilder<Lines, Hunks>): Promise<FilePatch<Lines, Hunks>[]>;
 export declare function reversePatch(patch: FilePatch): FilePatch;
 export interface HunkOutcome<Lines = PatchLine[]> {
     readonly hunk: Hunk<Lines>;

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

@@ -5,7 +5,8 @@ import {
   parseUnifiedSection,
   reversePatch,
   startIndex
-} from "../safe-bash/command-chunks/chunk-VT7UBPAE.js";
+} from "../safe-bash/command-chunks/chunk-YW2VYN4V.js";
+import "../safe-bash/command-chunks/chunk-KHUT7BB5.js";
 import "../safe-bash/command-chunks/chunk-AJEQUVDN.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {

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

@@ -876,22 +876,28 @@ async function* retainedRotations(args, handles, primaryHandle, pageCount, stora
 }
 
 // packages/safe-bash-command-pdftk/src/retained-output.ts
-import { editRetainedDocument as editRetainedDocument2, PdfFileSource as PdfFileSource3, PdfMutableObjectStore as PdfMutableObjectStore4, PdfRetainedDocument, cosBool, dictDelete, dictGet as dictGet4, dictSet as dictSet2, encryptRetainedPdfChunks, retainedCosObjects, saveRetainedDocumentChunks as saveRetainedDocumentChunks2 } from "../pdf-ast/index.js";
-async function* retainedOutput(source, storage, options, selectedId, signal, handles, pageCount, attachments, attachmentPage, stamps, info) {
+import { parseRetainedFormData, editRetainedDocument as editRetainedDocument2, PdfFileSource as PdfFileSource3, PdfMutableObjectStore as PdfMutableObjectStore4, PdfRetainedDocument, cosBool, cosName, dictDelete, dictGet as dictGet4, dictSet as dictSet2, encryptRetainedPdfChunks, retainedCosObjects, saveRetainedDocumentChunks as saveRetainedDocumentChunks2 } from "../pdf-ast/index.js";
+async function* retainedOutput(source, storage, options, selectedId, signal, handles, pageCount, attachments, attachmentPage, stamps, info, formData) {
   const infoUpdates = info?.updates;
   const store = new PdfMutableObjectStore4(storage, { signal });
   let edited;
   let document, plaintext, failed = false;
   try {
-    if (options.operation === "attach_files" || stamps || infoUpdates) {
+    if (options.operation === "attach_files" || stamps || infoUpdates || formData) {
       const pageIndex = attachmentPage !== void 0 && pageCount > 0 ? attachmentPage.toLowerCase() === "end" ? pageCount - 1 : Math.max(0, Math.min(pageCount - 1, (Number.parseInt(attachmentPage, 10) || 1) - 1)) : void 0;
-      edited = await editRetainedDocument2(source, storage, { signal, ...infoUpdates ? { infoUpdates } : {}, ...options.operation === "attach_files" ? { appendAttachments: attachments } : {}, ...stamps ? { stamps } : {}, ...pageIndex !== void 0 ? { attachmentPageIndex: pageIndex } : {} });
+      edited = await editRetainedDocument2(source, storage, { signal, ...formData ? { formUpdates: parseRetainedFormData(formData, storage, { signal }) } : {}, ...infoUpdates ? { infoUpdates } : {}, ...options.operation === "attach_files" ? { appendAttachments: attachments } : {}, ...stamps ? { stamps } : {}, ...pageIndex !== void 0 ? { attachmentPageIndex: pageIndex } : {} });
     }
     const input = edited?.document ?? source;
     const pageReferences = edited ? { pageReferences: async function* () {
       for await (const page of input.pages()) if (page.reference) yield page.reference;
     } } : {};
-    for await (const object of retainedCosObjects(input, storage, { signal })) await store.set(object);
+    for await (const object of retainedCosObjects(input, storage, { signal })) {
+      if (formData && options.replacementFont && object.value.kind === "dict") {
+        const subtype = dictGet4(object.value, "Subtype"), font = dictGet4(object.value, "BaseFont");
+        if (subtype?.kind === "name" && subtype.decoded === "Type1" && font?.kind === "name" && font.decoded === "Helvetica") dictSet2(object.value, "BaseFont", cosName(options.replacementFont.startsWith("/") ? options.replacementFont.slice(1) : options.replacementFont));
+      }
+      await store.set(object);
+    }
     const reference = input.crossReference;
     const chosenId = info?.useUpdatedId ? reference.idArray : selectedId;
     const idArray = options.keepFinalId || options.keepFirstId ? chosenId ?? reference.idArray : reference.idArray ?? chosenId;
@@ -901,7 +907,7 @@ async function* retainedOutput(source, storage, options, selectedId, signal, han
       const form = await document.lookup(dictGet4(root.value, "AcroForm"));
       if (form?.value.kind === "dict" && !form.stream) {
         if (options.dropXfa) dictDelete(form.value, "XFA");
-        if (options.needAppearances) dictSet2(form.value, "NeedAppearances", cosBool(true));
+        if (formData || options.needAppearances) dictSet2(form.value, "NeedAppearances", cosBool(options.needAppearances));
         if (form.reference) await store.set({ objectNumber: form.reference.objectNumber, generationNumber: form.reference.generationNumber, value: form.value });
         else dictSet2(root.value, "AcroForm", form.value);
       }
@@ -1159,6 +1165,7 @@ async function executeRetainedPdftk(context, options) {
   let selectedId;
   const counts = /* @__PURE__ */ new Map();
   const inputs = /* @__PURE__ */ new Map();
+  const formPath = options.operation === "fill_form" ? options.opArgs[0] ?? "-" : void 0;
   const infoPath = options.operation === "update_info" || options.operation === "update_info_utf8" ? options.opArgs[0] ?? "-" : void 0;
   const overlayPath = ["stamp", "multistamp", "background", "multibackground"].includes(options.operation) ? options.opArgs[0] ?? "-" : void 0;
   const attachmentPaths = [];
@@ -1183,13 +1190,13 @@ async function executeRetainedPdftk(context, options) {
   try {
     await context.fs.mkdir(storage.directory, { recursive: true, signal });
     const maximum = context.inputBudget?.maxBytes ?? Infinity;
-    if (options.inputs.some((input) => input.file === "-") || attachmentPaths.includes("-") || overlayPath === "-" || infoPath === "-") {
+    if (options.inputs.some((input) => input.file === "-") || attachmentPaths.includes("-") || overlayPath === "-" || infoPath === "-" || formPath === "-") {
       const source = await PdfFileSource5.fromStream(context.fs, storage.directory, context.stdin, { signal, maxInputBytes: maximum });
       inputs.set("-", source);
       total += source.size;
       context.inputBudget?.check(total);
     }
-    for (const input of [...options.inputs, ...attachmentPaths.map((file) => ({ file })), ...overlayPath !== void 0 ? [{ file: overlayPath }] : [], ...infoPath !== void 0 ? [{ file: infoPath }] : []]) {
+    for (const input of [...options.inputs, ...attachmentPaths.map((file) => ({ file })), ...overlayPath !== void 0 ? [{ file: overlayPath }] : [], ...infoPath !== void 0 ? [{ file: infoPath }] : [], ...formPath !== void 0 ? [{ file: formPath }] : []]) {
       if (inputs.has(input.file)) continue;
       let source;
       try {
@@ -1231,6 +1238,9 @@ async function executeRetainedPdftk(context, options) {
       await source.releaseCache();
     }
     document = await PdfRetainedDocument2.open(inputs.get(primary.file), storage, { signal, recovery: "strict", ...primary.password ? { password: primary.password } : {} });
+    const formSource = formPath === void 0 ? void 0 : inputs.get(formPath);
+    if (formPath !== void 0 && !formSource) return await diagnostic(`Error: Unable to open form data file '${formPath}'
+`);
     const infoSource = infoPath === void 0 ? void 0 : inputs.get(infoPath);
     if (infoPath !== void 0 && !infoSource) return await diagnostic(`Error: Unable to open info file '${infoPath}'
 `);
@@ -1266,7 +1276,7 @@ async function executeRetainedPdftk(context, options) {
     if (options.operation === "cat" || options.operation === "shuffle") {
       assembled = await assembleRetainedPdftk(document, storage, options, counts, handles, async (input) => PdfRetainedDocument2.open(inputs.get(input.file), storage, { signal, recovery: "strict", ...input.password ? { password: input.password } : {} }), signal);
     }
-    output = await PdfFileSource5.fromStream(context.fs, storage.directory, ["output", "rotate", "attach_files", "stamp", "multistamp", "background", "multibackground", "update_info", "update_info_utf8", "cat", "shuffle"].includes(options.operation) ? retainedOutput(assembled?.document ?? document, storage, options, selectedId, signal, new Map([...handles].map(([handle, input]) => [handle, { pageCount: counts.get(input) }])), counts.get(primary), attachments(), attachmentPage, overlayDocument ? [{ source: overlayDocument, mode: options.operation.includes("background") ? "underlay" : "overlay", preserveStreams: true, pages: stampPages() }] : void 0, infoSource ? { updates: retainedInfoUpdates(infoSource.stream(0, infoSource.size, signal), signal), useUpdatedId: idInput === primary } : void 0) : options.operation === "generate_fdf" ? retainedFdf(document, storage, signal) : options.operation === "dump_data_fields" || options.operation === "dump_data_fields_utf8" ? retainedFieldReport(document, options.operation.endsWith("_utf8"), signal) : retainedInspectionReport(document, storage, options.operation.endsWith("_utf8"), signal, options.operation === "dump_data" || options.operation === "dump_data_utf8" ? "document" : "annotations"), { signal });
+    output = await PdfFileSource5.fromStream(context.fs, storage.directory, ["output", "rotate", "attach_files", "stamp", "multistamp", "background", "multibackground", "update_info", "update_info_utf8", "cat", "shuffle", "fill_form"].includes(options.operation) ? retainedOutput(assembled?.document ?? document, storage, options, selectedId, signal, new Map([...handles].map(([handle, input]) => [handle, { pageCount: counts.get(input) }])), counts.get(primary), attachments(), attachmentPage, overlayDocument ? [{ source: overlayDocument, mode: options.operation.includes("background") ? "underlay" : "overlay", preserveStreams: true, pages: stampPages() }] : void 0, infoSource ? { updates: retainedInfoUpdates(infoSource.stream(0, infoSource.size, signal), signal), useUpdatedId: idInput === primary } : void 0, formSource) : options.operation === "generate_fdf" ? retainedFdf(document, storage, signal) : options.operation === "dump_data_fields" || options.operation === "dump_data_fields_utf8" ? retainedFieldReport(document, options.operation.endsWith("_utf8"), signal) : retainedInspectionReport(document, storage, options.operation.endsWith("_utf8"), signal, options.operation === "dump_data" || options.operation === "dump_data_utf8" ? "document" : "annotations"), { 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 {
@@ -1500,7 +1510,7 @@ import {
   cosArray as cosArray4,
   cosDict as cosDict4,
   cosHexString,
-  cosName,
+  cosName as cosName2,
   cosNumber as cosNumber4,
   cosStream,
   cosString as cosString4,
@@ -2124,7 +2134,7 @@ function setDocumentBookmarks(doc, bookmarks) {
   if (bookmarks.length === 0 || doc.pageCount === 0) return;
   const catalog = doc.cos.resolveDict(doc.cos.rootRef);
   if (!catalog) return;
-  const outlinesDict = cosDict4({ Type: cosName("Outlines") });
+  const outlinesDict = cosDict4({ Type: cosName2("Outlines") });
   const outlinesRef = doc.cos.allocateObject(outlinesDict);
   dictSet3(catalog, "Outlines", outlinesRef);
   const stack = [{ ref: outlinesRef, dict: outlinesDict, children: [] }];
@@ -2148,7 +2158,7 @@ function setDocumentBookmarks(doc, bookmarks) {
     const itemDict = cosDict4({
       Title: cosString4(bm.title),
       Parent: parentState.ref,
-      Dest: cosArray4([pageRef, cosName("XYZ"), { kind: "null" }, { kind: "null" }, { kind: "null" }])
+      Dest: cosArray4([pageRef, cosName2("XYZ"), { kind: "null" }, { kind: "null" }, { kind: "null" }])
     });
     const itemRef = doc.cos.allocateObject(itemDict);
     const prevSibling = parentState.children[parentState.children.length - 1];
@@ -2346,7 +2356,7 @@ function applyUpdateInfoText(doc, text) {
         }
         const pdfStyle = PAGE_LABEL_STYLE_TO_PDF[pl.style];
         if (pdfStyle) {
-          lblEntries.S = cosName(pdfStyle);
+          lblEntries.S = cosName2(pdfStyle);
         }
         numsItems.push(cosDict4(lblEntries));
       }
@@ -2381,13 +2391,13 @@ function attachFilesToDocument(doc, filePaths, files, toPageSpec) {
     const baseName = fp.slice(fp.lastIndexOf("/") + 1);
     const efStreamRef = doc.cos.allocateObject(
       cosStream(bytes, {
-        dict: cosDict4({ Type: cosName("EmbeddedFile") }),
+        dict: cosDict4({ Type: cosName2("EmbeddedFile") }),
         compress: true
       })
     );
     const filespecRef = doc.cos.allocateObject(
       cosDict4({
-        Type: cosName("Filespec"),
+        Type: cosName2("Filespec"),
         F: cosString4(baseName),
         UF: cosString4(baseName),
         EF: cosDict4({ F: efStreamRef })
@@ -2403,9 +2413,9 @@ function attachFilesToDocument(doc, filePaths, files, toPageSpec) {
       }
       const annotRef = doc.cos.allocateObject(
         cosDict4({
-          Type: cosName("Annot"),
-          Subtype: cosName("FileAttachment"),
-          Name: cosName("PushPin"),
+          Type: cosName2("Annot"),
+          Subtype: cosName2("FileAttachment"),
+          Name: cosName2("PushPin"),
           Contents: cosString4(baseName),
           FS: filespecRef,
           Rect: cosArray4([cosNumber4(20), cosNumber4(20), cosNumber4(40), cosNumber4(40)])
@@ -2965,7 +2975,7 @@ function* runPdftkCliSteps(argv, files, signal) {
         const subtype = stNode?.kind === "name" ? stNode.decoded : void 0;
         const baseFont = bfNode?.kind === "name" ? bfNode.decoded : void 0;
         if (subtype === "Type1" && baseFont === "Helvetica") {
-          dictSet3(obj.value, "BaseFont", cosName(cleanFontName));
+          dictSet3(obj.value, "BaseFont", cosName2(cleanFontName));
         }
       }
     }
@@ -3061,7 +3071,7 @@ async function executePdftk(context, retainedContext = context) {
     const carrier = getCommandArguments(context);
     const argv = [...carrier.args];
     const parsed = await drainSteps(parsePdftkArgumentsSteps(argv), invocation.signal);
-    if (parsed.options && (["output", "rotate", "attach_files", "stamp", "multistamp", "background", "multibackground", "burst", "update_info", "update_info_utf8", "cat", "shuffle"].includes(parsed.options.operation) && !parsed.options.shouldFlatten || ["dump_data", "dump_data_utf8", "dump_data_annots", "dump_data_annots_utf8", "dump_data_fields", "dump_data_fields_utf8", "generate_fdf", "unpack_files"].includes(parsed.options.operation))) {
+    if (parsed.options && (["output", "rotate", "attach_files", "stamp", "multistamp", "background", "multibackground", "burst", "update_info", "update_info_utf8", "cat", "shuffle", "fill_form"].includes(parsed.options.operation) && !parsed.options.shouldFlatten || ["dump_data", "dump_data_utf8", "dump_data_annots", "dump_data_annots_utf8", "dump_data_fields", "dump_data_fields_utf8", "generate_fdf", "unpack_files"].includes(parsed.options.operation))) {
       return await executeRetainedPdftk({ ...retainedContext, signal: invocation.signal, stdout: invocation.child(context.stdout).output }, parsed.options);
     }
     const vfsFiles = /* @__PURE__ */ new Map();

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-7V6PZR7G.js"));
+      const mod = await (cachedPptxEngineMod ??= import("../safe-bash/command-chunks/command-engine-M7S4QIXV.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-2ETEJOYX.js";
+} from "../safe-bash/command-chunks/chunk-HQ2UN2L2.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-UYJENSWK-VSCGKSQV.js")).createEngine(u), true, wr);
+var H = de(async (u) => (await import("../safe-bash/command-chunks/engine-YUYZJIB4-NZUDFEHL.js")).createEngine(u), true, wr);
 var Do = H.createSsconvertCommand;
 var To = H.createSsconvertCommands;
 var Uo = H.ssconvertCommands;

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

@@ -69,7 +69,7 @@ import {
   mutateNotes,
   readNotes,
   validateNotesOptions
-} from "../safe-bash/command-chunks/chunk-GQGMQMIM.js";
+} from "../safe-bash/command-chunks/chunk-ZIGENXGC.js";
 import {
   insertPlaceholder
 } from "../safe-bash/command-chunks/chunk-AM5LANIE.js";

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

@@ -23,3 +23,4 @@ export declare function mutateNotes(input: BinaryInput, action: "add" | "set" |
     affected: number;
     locations: readonly Location[];
 }>;
+export { openRetainedNotes, stageRetainedNotes, type RetainedNotes, type RetainedNotesRecord } from './retained-notes.js';

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

@@ -1,8 +1,12 @@
 import {
   mutateNotes,
+  openRetainedNotes,
   readNotes,
+  stageRetainedNotes,
   validateNotesOptions
-} from "../safe-bash/command-chunks/chunk-GQGMQMIM.js";
+} from "../safe-bash/command-chunks/chunk-ZIGENXGC.js";
+import "../safe-bash/command-chunks/chunk-4EHY6J2Z.js";
+import "../safe-bash/command-chunks/chunk-NQINS4XY.js";
 import "../safe-bash/command-chunks/chunk-ADHFF2IM.js";
 import "../safe-bash/command-chunks/chunk-KBAQHE5Y.js";
 import "../safe-bash/command-chunks/chunk-W3ZSWK76.js";
@@ -25,6 +29,8 @@ import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   mutateNotes,
+  openRetainedNotes,
   readNotes,
+  stageRetainedNotes,
   validateNotesOptions
 };

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

@@ -0,0 +1,27 @@
+import type { ByteSource } from './contracts.js';
+import type { NotesRecord } from './notes.js';
+import { type SelectionQuery } from './selectors.js';
+import type { RetainedPackageArchive, RetainedPackageContext } from './retained-package.js';
+import { type StagedOutput } from './retained-output.js';
+export interface RetainedNotesRecord extends Omit<NotesRecord, 'part' | 'master' | 'text' | 'bodyShapeId'> {
+    part(): ByteSource;
+    master(): ByteSource;
+    readonly text: (() => ByteSource) | null;
+    readonly bodyShapeId: (() => ByteSource) | null;
+}
+export interface RetainedNotes {
+    readonly count: number;
+    records(): AsyncGenerator<RetainedNotesRecord>;
+    close(): Promise<void>;
+}
+/** Borrow the archive; retain every selected note in caller storage before exposing records. */
+export declare function openRetainedNotes(archive: Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>, fingerprint: string, options: {
+    readonly selection?: SelectionQuery;
+}, settings: RetainedPackageContext, selectBeforeValidation?: boolean): Promise<RetainedNotes>;
+export declare function stageRetainedNotes(archive: Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>, fingerprint: string, options: {
+    readonly selection?: SelectionQuery;
+}, settings: RetainedPackageContext, output: {
+    readonly operation: 'notes.list' | 'notes.get';
+    readonly json: boolean;
+    readonly maxOutputBytes: number;
+}): Promise<StagedOutput>;

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

@@ -1,7 +1,7 @@
 import {
   serializeDocument
-} from "../safe-bash/command-chunks/chunk-FF7UGJWS.js";
-import "../safe-bash/command-chunks/chunk-PIVH35EQ.js";
+} from "../safe-bash/command-chunks/chunk-QDVDBN2N.js";
+import "../safe-bash/command-chunks/chunk-6CDDKNNA.js";
 import "../safe-bash/command-chunks/chunk-CSE4VQKG.js";
 import "../safe-bash/command-chunks/chunk-3I5WTVWZ.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

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

@@ -3,10 +3,10 @@ import {
 } from "../safe-bash/command-chunks/chunk-WJ2ERUCQ.js";
 import {
   serializeDocument
-} from "../safe-bash/command-chunks/chunk-FF7UGJWS.js";
+} from "../safe-bash/command-chunks/chunk-QDVDBN2N.js";
 import {
   parseStoredXml
-} from "../safe-bash/command-chunks/chunk-PIVH35EQ.js";
+} from "../safe-bash/command-chunks/chunk-6CDDKNNA.js";
 import {
   escape,
   evaluate,

package/dist/safe-bash-xml-engine/stored-document.js

@@ -1,6 +1,6 @@
 import {
   StoredXmlDocument
-} from "../safe-bash/command-chunks/chunk-PIVH35EQ.js";
+} from "../safe-bash/command-chunks/chunk-6CDDKNNA.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   StoredXmlDocument