@poe-platform/safe-bash 0.1.817 → 0.1.819

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

@@ -74,7 +74,7 @@ function formatBurstFilename(pattern, pageNum) {
 
 // packages/safe-bash-command-pdftk/src/retained-assembly.ts
 import { IntegerTable as IntegerTable2, PagedStorage as PagedStorage2 } from "@poe-platform/safe-fs/storage";
-import { PdfMutableObjectStore as PdfMutableObjectStore2, PdfNameIndex as PdfNameIndex2, PdfFileSource as PdfFileSource2, createRetainedPageCopy, editRetainedDocument, cosArray, cosDict as cosDict2, cosNumber, cosString as cosString2, decodePdfString as decodePdfString2, dictGet as dictGet2, dictSet } from "../pdf-ast/index.js";
+import { PdfTextStore, PdfMutableObjectStore as PdfMutableObjectStore2, PdfNameIndex as PdfNameIndex2, PdfFileSource as PdfFileSource2, createRetainedPageCopy, editRetainedDocument, cosArray, cosDict as cosDict2, cosNumber, cosString as cosString2, decodePdfString as decodePdfString2, dictGet as dictGet2, dictSet } from "../pdf-ast/index.js";
 
 // packages/safe-bash-command-pdftk/src/retained-unpack.ts
 import { IntegerTable, PagedStorage } from "@poe-platform/safe-fs/storage";
@@ -185,6 +185,7 @@ async function* retainedUnpack(document, storage, directory, inputNames, signal,
 async function assembleRetainedPdftk(primary, storage, options, counts, handles, open, signal) {
   const backing = new PagedStorage2({ fs: storage.fs, cwd: storage.directory, env: {}, signal }, 4);
   const sourceBookmarks = new PdfMutableObjectStore2(storage, { signal }), outputBookmarks = new PdfMutableObjectStore2(storage, { signal }), rotations = new PdfMutableObjectStore2(storage, { signal }), attachments = new PdfMutableObjectStore2(storage, { signal });
+  const titles = new PdfTextStore(storage, { signal });
   const names = new PdfNameIndex2(storage, Infinity, signal);
   const states = /* @__PURE__ */ new Map();
   const used = /* @__PURE__ */ new Set(), rangeHandles = new Map([...handles].map(([handle, input]) => [handle, { pageCount: counts.get(input) }]));
@@ -232,10 +233,10 @@ async function assembleRetainedPdftk(primary, storage, options, counts, handles,
     if (result) return result;
     result = { bookmarks: new IntegerTable2(backing, 64), resources: new IntegerTable2(backing, 64) };
     states.set(input, result);
-    for await (const bookmark of source.outlineDetails()) {
+    for await (const bookmark of source.streamOutlineDetails()) {
       await checkpoint();
       const key = BigInt(bookmark.pageIndex) * 2n, previous = await result.bookmarks.get(key + 1n);
-      const ref = await sourceBookmarks.allocate(cosDict2({ Title: cosString2(bookmark.title), Level: cosNumber(bookmark.level), Next: cosNumber(0) }));
+      const ref = await sourceBookmarks.allocate(cosDict2({ Title: cosNumber(await titles.append(bookmark.title())), Level: cosNumber(bookmark.level), Next: cosNumber(0) }));
       if (previous) {
         const row = await sourceBookmarks.get(Number(previous));
         if (row.value.kind === "dict") {
@@ -274,8 +275,9 @@ async function assembleRetainedPdftk(primary, storage, options, counts, handles,
     for await (const object of outputBookmarks.objects()) {
       await checkpoint();
       const value = object.value;
-      if (value.kind !== "array" || value.items[0]?.kind !== "string" || value.items[1]?.kind !== "number" || value.items[2]?.kind !== "number") throw new Error("Invalid output bookmark");
-      yield { title: decodePdfString2(value.items[0]), level: value.items[1].value, pageNumber: value.items[2].value };
+      if (value.kind !== "array" || value.items[0]?.kind !== "number" || value.items[1]?.kind !== "number" || value.items[2]?.kind !== "number") throw new Error("Invalid output bookmark");
+      const title = value.items[0].value;
+      yield { title: () => titles.text(title), level: value.items[1].value, pageNumber: value.items[2].value };
     }
   }
   async function* rotationEdits() {
@@ -296,7 +298,7 @@ async function assembleRetainedPdftk(primary, storage, options, counts, handles,
     }
   }
   try {
-    copy = await createRetainedPageCopy(sources(), storage, { signal, metadata: await primary.info() });
+    copy = await createRetainedPageCopy(sources(), storage, { signal, metadataSource: (key) => primary.streamInfoValue(key) });
     for (const input of used) {
       await checkpoint();
       const source = await document(input);
@@ -328,7 +330,7 @@ async function assembleRetainedPdftk(primary, storage, options, counts, handles,
     await Promise.allSettled([edited?.close(), copy?.close()]);
     throw error;
   } finally {
-    const results = await Promise.allSettled([current?.close(), sourceBookmarks.close(), outputBookmarks.close(), rotations.close(), attachments.close(), names.close(), backing.close()]);
+    const results = await Promise.allSettled([current?.close(), sourceBookmarks.close(), outputBookmarks.close(), rotations.close(), attachments.close(), names.close(), backing.close(), titles.close()]);
     if (!failed) {
       for (const outcome of results) if (outcome.status === "rejected") {
         await Promise.allSettled([edited?.close(), copy?.close()]);
@@ -338,146 +340,555 @@ async function assembleRetainedPdftk(primary, storage, options, counts, handles,
   }
 }
 
-// packages/safe-bash-command-pdftk/src/retained-info-updates.ts
-var styles = { DecimalArabicNumerals: "D", UppercaseRomanNumerals: "R", LowercaseRomanNumerals: "r", UppercaseLetters: "A", LowercaseLetters: "a" };
-async function* lines(chunks, signal) {
-  const decoder = new TextDecoder();
-  let pending = "", work = 0;
-  for await (const bytes of chunks) {
+// packages/safe-bash-command-pdftk/src/info-style-stream.ts
+async function parsePdftkStyleChunks(chunks, signal) {
+  let value = "", oversized = false;
+  for await (const chunk of chunks) {
+    signal.throwIfAborted();
+    if (oversized) continue;
+    if (value.length + chunk.length > "UppercaseRomanNumerals".length) {
+      value = "";
+      oversized = true;
+    } else value += chunk;
+  }
+  return value;
+}
+
+// packages/safe-bash-command-pdftk/src/info-geometry-stream.ts
+import { CompactPdfNumber } from "../pdf-ast/index.js";
+var GeometryNumber = class {
+  decimal = new CompactPdfNumber();
+  state = "start";
+  negative = false;
+  signed = false;
+  trailing = false;
+  special = "";
+  radix = 0;
+  integer = 0n;
+  overflow = false;
+  radixDigits = false;
+  present = false;
+  substantive = false;
+  append(character) {
+    this.present = true;
+    if (!character.trim()) {
+      if (this.state !== "start") this.trailing = true;
+      return;
+    }
+    this.substantive = true;
+    if (this.trailing || this.state === "bad") {
+      this.state = "bad";
+      return;
+    }
+    if (this.state === "special") {
+      this.special += character;
+      if (!"Infinity".startsWith(this.special)) this.state = "bad";
+      return;
+    }
+    if (this.state === "radix") {
+      const code = character.toLowerCase().charCodeAt(0), digit2 = code >= 48 && code <= 57 ? code - 48 : code >= 97 && code <= 102 ? code - 87 : -1;
+      if (digit2 < 0 || digit2 >= this.radix) {
+        this.state = "bad";
+        return;
+      }
+      this.radixDigits = true;
+      if (!this.overflow) {
+        this.integer = this.integer * BigInt(this.radix) + BigInt(digit2);
+        this.overflow = this.integer >= 1n << 1024n;
+      }
+      return;
+    }
+    const digit = character >= "0" && character <= "9";
+    if (this.state === "start" && (character === "+" || character === "-")) {
+      this.signed = true;
+      this.negative = character === "-";
+      this.state = "sign";
+    } else if ((this.state === "start" || this.state === "sign") && character === "I") {
+      this.special = "I";
+      this.state = "special";
+      return;
+    } else if ((this.state === "start" || this.state === "sign") && digit) this.state = character === "0" ? "zero" : "int";
+    else if ((this.state === "start" || this.state === "sign") && character === ".") this.state = "dot";
+    else if (this.state === "zero" && !this.signed && ["x", "b", "o"].includes(character.toLowerCase())) {
+      this.radix = character.toLowerCase() === "x" ? 16 : character.toLowerCase() === "b" ? 2 : 8;
+      this.state = "radix";
+      return;
+    } else if ((this.state === "zero" || this.state === "int") && digit) this.state = "int";
+    else if ((this.state === "zero" || this.state === "int") && character === ".") this.state = "fraction";
+    else if ((this.state === "dot" || this.state === "fraction") && digit) this.state = "fraction";
+    else if ((this.state === "zero" || this.state === "int" || this.state === "fraction") && (character === "e" || character === "E")) this.state = "exp";
+    else if (this.state === "exp" && (character === "+" || character === "-")) this.state = "expSign";
+    else if ((this.state === "exp" || this.state === "expSign" || this.state === "expDigits") && digit) this.state = "expDigits";
+    else {
+      this.state = "bad";
+      return;
+    }
+    this.decimal.append(character.charCodeAt(0));
+  }
+  value() {
+    if (this.state === "start") return 0;
+    if (this.state === "special") return this.special === "Infinity" ? this.negative ? -Infinity : Infinity : NaN;
+    if (this.state === "radix") return this.radixDigits ? this.overflow ? Infinity : Number(this.integer) : NaN;
+    if (["zero", "int", "fraction", "expDigits"].includes(this.state)) return Number(this.decimal.spelling);
+    return NaN;
+  }
+};
+async function parsePdftkGeometryChunks(chunks, signal) {
+  const values = [];
+  let count = 0, finite = true, work = 0, leading = true, pendingZeroes = 0, token = new GeometryNumber();
+  const record = (value) => {
+    if (values.length < 4) values.push(value);
+    count = Math.min(5, count + 1);
+    finite &&= Number.isFinite(value);
+  };
+  const finish = () => {
+    if (token.present) {
+      if (!token.substantive) pendingZeroes = Math.min(5, pendingZeroes + 1);
+      else {
+        while (pendingZeroes) {
+          record(0);
+          pendingZeroes--;
+        }
+        record(token.value());
+      }
+    }
+    token = new GeometryNumber();
+  };
+  for await (const chunk of chunks) {
+    signal.throwIfAborted();
+    for (const character of chunk) {
+      if (++work % 4096 === 0) {
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        signal.throwIfAborted();
+      }
+      if (leading && !character.trim()) continue;
+      leading = false;
+      if (character === " ") finish();
+      else token.append(character);
+    }
+  }
+  signal.throwIfAborted();
+  finish();
+  return { values, count, finite };
+}
+
+// packages/safe-bash-command-pdftk/src/info-integer-stream.ts
+async function parsePdftkIntegerChunks(chunks, signal) {
+  let leading = true, negative = false, digits = "", seen = false, work = 0;
+  const value = () => seen ? (negative ? -1 : 1) * Number.parseInt(digits || "0", 10) : NaN;
+  for await (const chunk of chunks) {
     signal.throwIfAborted();
-    pending += decoder.decode(bytes, { stream: true });
-    let offset = 0, end;
-    while ((end = pending.indexOf("\n", offset)) >= 0) {
+    for (const character of chunk) {
+      if (++work % 4096 === 0) {
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        signal.throwIfAborted();
+      }
+      if (leading) {
+        if (!character.trim()) continue;
+        leading = false;
+        if (character === "-" || character === "+") {
+          negative = character === "-";
+          continue;
+        }
+      }
+      if (character < "0" || character > "9") return value();
+      seen = true;
+      if (!digits.length && character === "0") continue;
+      if (digits.length === 309) return negative ? -Infinity : Infinity;
+      digits += character;
+    }
+  }
+  signal.throwIfAborted();
+  return value();
+}
+
+// packages/safe-bash-command-pdftk/src/info-entity-stream.ts
+async function* decodePdftkEntityChunks(read, signal) {
+  let input = read(0)[Symbol.asyncIterator](), buffer = "", offset = 0, position = 0, ended = false, work = 0, failed = false;
+  async function ready() {
+    signal.throwIfAborted();
+    while (offset === buffer.length && !ended) {
       if (++work % 64 === 0) {
         await new Promise((resolve) => setTimeout(resolve, 0));
         signal.throwIfAborted();
       }
-      yield pending.slice(offset, end);
-      offset = end + 1;
+      const next2 = await input.next();
+      ended = !!next2.done;
+      buffer = next2.value ?? "";
+      offset = 0;
+    }
+  }
+  async function until(delimiter) {
+    await ready();
+    if (ended) return void 0;
+    const found = buffer.indexOf(delimiter, offset), end = found < 0 ? buffer.length : found;
+    const text = buffer.slice(offset, end);
+    position += end - offset;
+    offset = end;
+    return text;
+  }
+  async function next() {
+    await ready();
+    if (ended) return void 0;
+    position++;
+    return buffer[offset++];
+  }
+  async function seek(target) {
+    await input.return?.(void 0);
+    input = read(target)[Symbol.asyncIterator]();
+    buffer = "";
+    offset = 0;
+    position = target;
+    ended = false;
+  }
+  try {
+    while (true) {
+      let consume2 = function(character) {
+        if (first) {
+          first = false;
+          if (character === "x" || character === "X") {
+            radix = 16;
+            return;
+          }
+        }
+        if (stopped) return;
+        if (phase === "space") {
+          if (!character.trim()) return;
+          phase = "first";
+          if (character === "+" || character === "-") {
+            sign = character;
+            return;
+          }
+        }
+        if (phase === "first") {
+          if (radix === 16 && character === "0") {
+            phase = "zero";
+            hasDigit = true;
+            return;
+          }
+          phase = "digits";
+        } else if (phase === "zero") {
+          phase = "digits";
+          if (character === "x" || character === "X") {
+            hasDigit = false;
+            return;
+          }
+        }
+        const value = Number.parseInt(character, radix);
+        if (!Number.isFinite(value)) {
+          stopped = true;
+          return;
+        }
+        hasDigit = true;
+        if (digits || value) {
+          if (digits.length < 310) digits += character;
+          else overflow = true;
+        }
+      };
+      var consume = consume2;
+      const literal = await until("&");
+      if (literal === void 0) break;
+      if (literal) {
+        yield literal;
+        continue;
+      }
+      const start = position;
+      await next();
+      if (await next() !== "#") {
+        yield "&";
+        await seek(start + 1);
+        continue;
+      }
+      let first = true, radix = 10, phase = "space", sign = "", digits = "", hasDigit = false, stopped = false, overflow = false, terminated = false;
+      while (true) {
+        const body = await until(";");
+        if (body === void 0) break;
+        if (!body) {
+          await next();
+          terminated = true;
+          break;
+        }
+        for (const character of body) consume2(character);
+      }
+      if (!terminated) {
+        await seek(start);
+        while (true) {
+          await ready();
+          if (ended) break;
+          const rest = buffer.slice(offset);
+          position += rest.length;
+          offset = buffer.length;
+          yield rest;
+        }
+        break;
+      }
+      const number = !hasDigit ? NaN : overflow ? Infinity : Number.parseInt(sign + (digits || "0"), radix);
+      if (Number.isFinite(number) && number >= 0) yield String.fromCodePoint(number);
+      else {
+        yield "&";
+        await seek(start + 1);
+      }
     }
-    pending = pending.slice(offset);
+  } catch (error) {
+    failed = true;
+    throw error;
+  } finally {
+    await Promise.resolve().then(() => input.return?.(void 0)).catch((error) => {
+      if (!failed) throw error;
+    });
   }
-  pending += decoder.decode();
-  if (pending) yield pending;
 }
-async function* retainedInfoUpdates(chunks, signal) {
-  let mode = "none";
-  let curKey = "";
-  let bmTitle = "";
-  let bmLevel = 1;
-  let bmPage = 1;
-  const pending = [];
-  let plNewIndex = 1;
-  let plStart = 1;
-  let plPrefix = "";
-  let plStyle = "DecimalArabicNumerals";
-  let pmNumber = 0;
-  let pmRotation;
-  let pmMediaRect;
-  let pmDimensions;
-  let pmCropBox;
-  const flushStanza = () => {
-    if (mode === "bookmark" && bmTitle) {
-      pending.push({ kind: "bookmark", title: bmTitle, level: Math.min(Number.MAX_SAFE_INTEGER, Math.max(1, bmLevel)), pageNumber: Math.min(Number.MAX_SAFE_INTEGER, Math.max(1, bmPage)) });
-    } else if (mode === "pagelabel") {
-      pending.push({
-        kind: "label",
-        index: Math.max(0, plNewIndex - 1),
-        start: Math.max(1, plStart),
-        prefix: plPrefix,
-        ...styles[plStyle] ? { style: styles[plStyle] } : {}
-      });
-    } else if (mode === "pagemedia" && pmNumber >= 1) {
-      if (pmRotation !== void 0) pending.push({ kind: "page", pageNumber: pmNumber, property: "rotation", values: [Number.isFinite(pmRotation) ? pmRotation : 0] });
-      if (pmMediaRect !== void 0) pending.push({ kind: "page", pageNumber: pmNumber, property: "media", values: pmMediaRect });
-      if (pmDimensions !== void 0) pending.push({ kind: "page", pageNumber: pmNumber, property: "dimensions", values: pmDimensions });
-      if (pmCropBox !== void 0) pending.push({ kind: "page", pageNumber: pmNumber, property: "crop", values: pmCropBox });
+
+// packages/safe-bash-command-pdftk/src/retained-info-updates.ts
+import { PdfTextStore as PdfTextStore2 } from "../pdf-ast/index.js";
+var styles = { DecimalArabicNumerals: "D", UppercaseRomanNumerals: "R", LowercaseRomanNumerals: "r", UppercaseLetters: "A", LowercaseLetters: "a" };
+var integerFields = ["BookmarkLevel:", "BookmarkPageNumber:", "PageLabelNewIndex:", "PageLabelStart:", "PageMediaNumber:", "PageMediaRotation:"];
+var geometryFields = ["PageMediaRect:", "PageMediaDimensions:", "PageMediaCropBox:", "PageMediaCropRect:"];
+async function* lines(chunks, texts, signal) {
+  async function* decoded() {
+    const decoder = new TextDecoder();
+    for await (const bytes of chunks) for (let at = 0; at < bytes.length; at += 4096) {
+      signal.throwIfAborted();
+      yield decoder.decode(bytes.subarray(at, at + 4096), { stream: true });
     }
-    bmTitle = "";
-    bmLevel = 1;
-    bmPage = 1;
-    plNewIndex = 1;
-    plStart = 1;
-    plPrefix = "";
-    plStyle = "DecimalArabicNumerals";
-    pmNumber = 0;
-    pmRotation = void 0;
-    pmMediaRect = void 0;
-    pmDimensions = void 0;
-    pmCropBox = void 0;
-  };
-  for await (const raw of lines(chunks, signal)) {
-    const line = raw.trim();
-    if (line === "InfoBegin") {
-      flushStanza();
-      yield* pending;
-      pending.length = 0;
-      mode = "info";
-      curKey = "";
-    } else if (line === "BookmarkBegin") {
-      flushStanza();
-      yield* pending;
-      pending.length = 0;
-      mode = "bookmark";
-    } else if (line === "PageLabelBegin") {
-      flushStanza();
-      yield* pending;
-      pending.length = 0;
-      mode = "pagelabel";
-    } else if (line === "PageMediaBegin") {
-      flushStanza();
-      yield* pending;
-      pending.length = 0;
-      mode = "pagemedia";
-    } else if (line.startsWith("PdfID0:")) {
-      yield { kind: "id", index: 0, bytes: hexToBytes(line.slice("PdfID0:".length)) };
-    } else if (line.startsWith("PdfID1:")) {
-      yield { kind: "id", index: 1, bytes: hexToBytes(line.slice("PdfID1:".length)) };
-    } else if (mode === "info" && line.startsWith("InfoKey:")) {
-      curKey = decodePdftkEntities(line.slice("InfoKey:".length).trim());
-    } else if (mode === "info" && line.startsWith("InfoValue:") && curKey) {
-      const val = decodePdftkEntities(line.slice("InfoValue:".length).trim());
-      yield { kind: "info", key: curKey, value: val };
-      mode = "none";
-      curKey = "";
-    } else if (mode === "bookmark" && line.startsWith("BookmarkTitle:")) {
-      bmTitle = decodePdftkEntities(line.slice("BookmarkTitle:".length).trim());
-    } else if (mode === "bookmark" && line.startsWith("BookmarkLevel:")) {
-      bmLevel = Number.parseInt(line.slice("BookmarkLevel:".length).trim(), 10) || 1;
-    } else if (mode === "bookmark" && line.startsWith("BookmarkPageNumber:")) {
-      bmPage = Number.parseInt(line.slice("BookmarkPageNumber:".length).trim(), 10) || 1;
-    } else if (mode === "pagelabel" && line.startsWith("PageLabelNewIndex:")) {
-      plNewIndex = Number.parseInt(line.slice("PageLabelNewIndex:".length).trim(), 10) || 1;
-    } else if (mode === "pagelabel" && line.startsWith("PageLabelStart:")) {
-      plStart = Number.parseInt(line.slice("PageLabelStart:".length).trim(), 10) || 1;
-    } else if (mode === "pagelabel" && line.startsWith("PageLabelPrefix:")) {
-      plPrefix = decodePdftkEntities(line.slice("PageLabelPrefix:".length).trim());
-    } else if (mode === "pagelabel" && line.startsWith("PageLabelNumStyle:")) {
-      plStyle = line.slice("PageLabelNumStyle:".length).trim();
-    } else if (mode === "pagemedia" && line.startsWith("PageMediaNumber:")) {
-      pmNumber = Number.parseInt(line.slice("PageMediaNumber:".length).trim(), 10) || 0;
-    } else if (mode === "pagemedia" && line.startsWith("PageMediaRotation:")) {
-      pmRotation = Number.parseInt(line.slice("PageMediaRotation:".length).trim(), 10) || 0;
-    } else if (mode === "pagemedia" && line.startsWith("PageMediaRect:")) {
-      const parts = line.slice("PageMediaRect:".length).trim().split(" ").filter(Boolean).map(Number);
-      if (parts.length >= 4 && parts.every(Number.isFinite)) {
-        pmMediaRect = [parts[0], parts[1], parts[2], parts[3]];
+    yield decoder.decode();
+  }
+  const input = decoded();
+  let buffer = "", offset = 0, ended = false, failed = false;
+  async function* line() {
+    while (!ended || offset < buffer.length) {
+      if (offset === buffer.length) {
+        const next = await input.next();
+        ended = !!next.done;
+        buffer = next.value ?? "";
+        offset = 0;
+        if (ended) return;
       }
-    } else if (mode === "pagemedia" && line.startsWith("PageMediaDimensions:")) {
-      const parts = line.slice("PageMediaDimensions:".length).trim().split(" ").filter(Boolean).map(Number);
-      if (parts.length >= 2 && Number.isFinite(parts[0]) && Number.isFinite(parts[1])) {
-        pmDimensions = [parts[0], parts[1]];
+      const end = buffer.indexOf("\n", offset);
+      if (end >= 0) {
+        yield buffer.slice(offset, end);
+        offset = end + 1;
+        return;
       }
-    } else if (mode === "pagemedia" && (line.startsWith("PageMediaCropBox:") || line.startsWith("PageMediaCropRect:"))) {
-      const prefix = line.startsWith("PageMediaCropRect:") ? "PageMediaCropRect:" : "PageMediaCropBox:";
-      const parts = line.slice(prefix.length).trim().split(" ").filter(Boolean).map(Number);
-      if (parts.length >= 4 && parts.every(Number.isFinite)) {
-        pmCropBox = [parts[0], parts[1], parts[2], parts[3]];
+      yield buffer.slice(offset);
+      offset = buffer.length;
+    }
+  }
+  try {
+    while (!ended || offset < buffer.length) {
+      const id = await texts.append(line());
+      let start = -1, end = 0, position = 0, head = "";
+      for await (const part of texts.text(id)) {
+        for (let at = 0; at < part.length; at++) {
+          const character = part[at];
+          if (character.trim()) {
+            if (start < 0) start = position;
+            end = position + 1;
+          }
+          if (start >= 0 && head.length < 64) head += character;
+          position++;
+        }
+      }
+      async function* field(skip) {
+        let position2 = 0, leading = true;
+        for await (const part of texts.text(id)) {
+          const from = Math.max(0, start + skip - position2), to = Math.min(part.length, end - position2);
+          if (to > from) {
+            let value = part.slice(from, to);
+            if (leading) {
+              value = value.trimStart();
+              leading = !value.length;
+            }
+            if (value) yield value;
+          }
+          position2 += part.length;
+          if (position2 >= end) break;
+        }
+      }
+      const geometry = geometryFields.find((name) => head.startsWith(name));
+      const integer = integerFields.find((name) => head.startsWith(name));
+      const streamed = head.startsWith("BookmarkTitle:") ? "BookmarkTitle:" : head.startsWith("PageLabelPrefix:") ? "PageLabelPrefix:" : head.startsWith("InfoValue:") ? "InfoValue:" : head.startsWith("InfoKey:") ? "InfoKey:" : void 0;
+      if (streamed) {
+        let body = start + streamed.length;
+        for await (const part of texts.text(id, body)) {
+          const value = part.trimStart();
+          body += part.length - value.length;
+          if (value) break;
+        }
+        async function* readText(offset2) {
+          let position2 = body + offset2;
+          for await (const part of texts.text(id, position2)) {
+            const length = Math.min(part.length, end - position2);
+            if (length <= 0) break;
+            yield part.slice(0, length);
+            position2 += length;
+            if (position2 >= end) break;
+          }
+        }
+        yield { field: streamed, text: () => decodePdftkEntityChunks(readText, signal) };
+      } else if (integer) {
+        yield { integer, value: await parsePdftkIntegerChunks(field(integer.length), signal) };
+      } else if (geometry) {
+        yield { geometry, result: await parsePdftkGeometryChunks(field(geometry.length), signal) };
+      } else if (head.startsWith("PageLabelNumStyle:")) {
+        yield { style: await parsePdftkStyleChunks(field("PageLabelNumStyle:".length), signal) };
+      } else {
+        const begin = ["InfoBegin", "BookmarkBegin", "PageLabelBegin", "PageMediaBegin"].some((name) => end - start === name.length && head.startsWith(name));
+        const known = ["PdfID0:", "PdfID1:", "InfoKey:", "InfoValue:", "BookmarkLevel:", "BookmarkPageNumber:", "PageLabelNewIndex:", "PageLabelStart:", "PageLabelPrefix:", "PageLabelNumStyle:", "PageMediaNumber:", "PageMediaRotation:", "PageMediaRect:", "PageMediaDimensions:", "PageMediaCropBox:", "PageMediaCropRect:"].some((name) => head.startsWith(name));
+        if (!begin && !known) continue;
+        let text = "";
+        for await (const part of field(0)) text += part;
+        yield text;
       }
     }
+  } catch (error) {
+    failed = true;
+    throw error;
+  } finally {
+    await input.return().catch((error) => {
+      if (!failed) throw error;
+    });
+  }
+}
+async function* retainedInfoUpdates(chunks, signal, storage) {
+  const texts = new PdfTextStore2(storage, { signal });
+  let failed = false;
+  try {
+    let mode = "none";
+    let curKey = "";
+    let bmTitle = "";
+    let bmLevel = 1;
+    let bmPage = 1;
+    const pending = [];
+    let plNewIndex = 1;
+    let plStart = 1;
+    let plPrefix = "";
+    let plStyle = "DecimalArabicNumerals";
+    let pmNumber = 0;
+    let pmRotation;
+    let pmMediaRect;
+    let pmDimensions;
+    let pmCropBox;
+    const flushStanza = () => {
+      if (mode === "bookmark" && bmTitle) {
+        pending.push({ kind: "bookmark", title: bmTitle, level: Math.min(Number.MAX_SAFE_INTEGER, Math.max(1, bmLevel)), pageNumber: Math.min(Number.MAX_SAFE_INTEGER, Math.max(1, bmPage)) });
+      } else if (mode === "pagelabel") {
+        pending.push({
+          kind: "label",
+          index: Math.max(0, plNewIndex - 1),
+          start: Math.max(1, plStart),
+          prefix: plPrefix,
+          ...styles[plStyle] ? { style: styles[plStyle] } : {}
+        });
+      } else if (mode === "pagemedia" && pmNumber >= 1) {
+        if (pmRotation !== void 0) pending.push({ kind: "page", pageNumber: pmNumber, property: "rotation", values: [Number.isFinite(pmRotation) ? pmRotation : 0] });
+        if (pmMediaRect !== void 0) pending.push({ kind: "page", pageNumber: pmNumber, property: "media", values: pmMediaRect });
+        if (pmDimensions !== void 0) pending.push({ kind: "page", pageNumber: pmNumber, property: "dimensions", values: pmDimensions });
+        if (pmCropBox !== void 0) pending.push({ kind: "page", pageNumber: pmNumber, property: "crop", values: pmCropBox });
+      }
+      bmTitle = "";
+      bmLevel = 1;
+      bmPage = 1;
+      plNewIndex = 1;
+      plStart = 1;
+      plPrefix = "";
+      plStyle = "DecimalArabicNumerals";
+      pmNumber = 0;
+      pmRotation = void 0;
+      pmMediaRect = void 0;
+      pmDimensions = void 0;
+      pmCropBox = void 0;
+    };
+    for await (const raw of lines(chunks, texts, signal)) {
+      if (typeof raw !== "string") {
+        if ("style" in raw) {
+          if (mode === "pagelabel") plStyle = raw.style;
+          continue;
+        }
+        if ("geometry" in raw) {
+          if (mode !== "pagemedia") continue;
+          const { values, count, finite } = raw.result;
+          if (raw.geometry === "PageMediaDimensions:") {
+            if (count >= 2 && Number.isFinite(values[0]) && Number.isFinite(values[1])) pmDimensions = [values[0], values[1]];
+          } else if (count >= 4 && finite) {
+            const rectangle = [values[0], values[1], values[2], values[3]];
+            if (raw.geometry === "PageMediaRect:") pmMediaRect = rectangle;
+            else pmCropBox = rectangle;
+          }
+          continue;
+        }
+        if ("integer" in raw) {
+          if (mode === "bookmark" && raw.integer === "BookmarkLevel:") bmLevel = raw.value || 1;
+          else if (mode === "bookmark" && raw.integer === "BookmarkPageNumber:") bmPage = raw.value || 1;
+          else if (mode === "pagelabel" && raw.integer === "PageLabelNewIndex:") plNewIndex = raw.value || 1;
+          else if (mode === "pagelabel" && raw.integer === "PageLabelStart:") plStart = raw.value || 1;
+          else if (mode === "pagemedia" && raw.integer === "PageMediaNumber:") pmNumber = raw.value || 0;
+          else if (mode === "pagemedia" && raw.integer === "PageMediaRotation:") pmRotation = raw.value || 0;
+          continue;
+        }
+        if (mode === "bookmark" && raw.field === "BookmarkTitle:") {
+          let nonempty = false;
+          for await (const part of raw.text()) nonempty ||= !!part.length;
+          bmTitle = nonempty ? raw.text : "";
+        } else if (mode === "pagelabel" && raw.field === "PageLabelPrefix:") {
+          for await (const part of raw.text()) {
+            signal.throwIfAborted();
+            void part;
+          }
+          plPrefix = raw.text;
+        } else if (mode === "info" && raw.field === "InfoKey:") {
+          let nonempty = false;
+          for await (const part of raw.text()) nonempty ||= !!part.length;
+          curKey = nonempty ? raw.text : "";
+        } else if (mode === "info" && curKey && raw.field === "InfoValue:") {
+          for await (const part of raw.text()) {
+            signal.throwIfAborted();
+            void part;
+          }
+          yield { kind: "info", key: curKey, value: raw.text };
+          mode = "none";
+          curKey = "";
+        }
+        continue;
+      }
+      const line = raw.trim();
+      if (line === "InfoBegin") {
+        flushStanza();
+        yield* pending;
+        pending.length = 0;
+        mode = "info";
+        curKey = "";
+      } else if (line === "BookmarkBegin") {
+        flushStanza();
+        yield* pending;
+        pending.length = 0;
+        mode = "bookmark";
+      } else if (line === "PageLabelBegin") {
+        flushStanza();
+        yield* pending;
+        pending.length = 0;
+        mode = "pagelabel";
+      } else if (line === "PageMediaBegin") {
+        flushStanza();
+        yield* pending;
+        pending.length = 0;
+        mode = "pagemedia";
+      } else if (line.startsWith("PdfID0:")) {
+        yield { kind: "id", index: 0, bytes: hexToBytes(line.slice("PdfID0:".length)) };
+      } else if (line.startsWith("PdfID1:")) {
+        yield { kind: "id", index: 1, bytes: hexToBytes(line.slice("PdfID1:".length)) };
+      }
+    }
+    flushStanza();
+    yield* pending;
+  } catch (error) {
+    failed = true;
+    throw error;
+  } finally {
+    await texts.close().catch((error) => {
+      if (!failed) throw error;
+    });
   }
-  flushStanza();
-  yield* pending;
 }
 
 // packages/safe-bash-command-pdftk/src/retained-burst.ts
@@ -1280,7 +1691,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", "fill_form", "flatten"].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 });
+    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", "flatten"].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, storage), 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 {
@@ -1542,11 +1953,11 @@ function parseRotationSuffix(raw) {
       return { rest: raw.slice(0, -word.length), rotation: spec };
     }
   }
-  if (lower.endsWith("end") || lower.endsWith("odd") || lower.endsWith("even")) {
+  if (lower === "end" || lower === "rend" || lower.endsWith("-end") || lower.endsWith("-rend") || lower.endsWith("odd") || lower.endsWith("even")) {
     return { rest: raw };
   }
   const lastChar = raw[raw.length - 1];
-  if (raw.length > 1 && lastChar) {
+  if (lastChar) {
     const singleMap = {
       N: { kind: "absolute", degrees: 0 },
       E: { kind: "absolute", degrees: 90 },
@@ -1587,7 +1998,9 @@ function* iteratePdftkRangeToken(token, handles, defaultHandle) {
     if (hKey && work.startsWith(hKey)) {
       const after = work.slice(hKey.length);
       const afterLower = after.toLowerCase();
-      if (after.length === 0 || after[0] >= "0" && after[0] <= "9" || afterLower.startsWith("end") || afterLower.startsWith("r") || afterLower.startsWith("even") || afterLower.startsWith("odd") || afterLower === "north" || afterLower === "east" || afterLower === "south" || afterLower === "west" || afterLower === "left" || afterLower === "right" || afterLower === "down") {
+      const withoutQualifier = afterLower.endsWith("even") ? after.slice(0, -4) : afterLower.endsWith("odd") ? after.slice(0, -3) : after;
+      const rotationOnly = parseRotationSuffix(withoutQualifier);
+      if (after.length === 0 || after[0] >= "0" && after[0] <= "9" || afterLower.startsWith("end") || afterLower.startsWith("r") || afterLower.startsWith("even") || afterLower.startsWith("odd") || rotationOnly.rotation !== void 0 && rotationOnly.rest.length === 0) {
         handle = hKey;
         work = after;
         break;