@poe-platform/safe-bash 0.1.817 → 0.1.819

package/dist/safe-bash/command-chunks/{chunk-LFSWLJPR.js → chunk-ZZ6EIACJ.js}

@@ -1,30 +1,49 @@
+import {
+  openRetainedPresentationIndex
+} from "./chunk-LZHFVNEV.js";
+import {
+  stageRetainedOutput,
+  streamJson
+} from "./chunk-R36PDP3L.js";
 import {
   writePackageArchive
-} from "./chunk-TG2RVQLP.js";
+} from "./chunk-5KWEZV5H.js";
 import {
   readPackage
-} from "./chunk-Q65GWGQR.js";
-import {
-  readBinary
-} from "./chunk-FAU2KL6I.js";
+} from "./chunk-KVTZJBLM.js";
 import {
+  openRetainedPresentationValidation,
   validatePresentation
-} from "./chunk-6W4RMBFH.js";
+} from "./chunk-SKDJCMGI.js";
 import {
-  parseXmlPart
-} from "./chunk-7PYDVQPB.js";
+  dialects
+} from "./chunk-P3LHQOX7.js";
 import {
-  parseContentTypes
-} from "./chunk-XFIDOCYH.js";
+  openRetainedContentTypes
+} from "./chunk-O4H7HPMP.js";
+import {
+  parseXmlPart
+} from "./chunk-YWP62BAZ.js";
 import {
   readRelationshipGraph
-} from "./chunk-4YFTJS5U.js";
+} from "./chunk-QMXOKYMJ.js";
+import {
+  parseContentTypes
+} from "./chunk-6ZHNKHQQ.js";
 import {
   relativePartReference
-} from "./chunk-MOUCMZZP.js";
+} from "./chunk-PZVFNPRC.js";
 import {
-  OfficeError
-} from "./chunk-KM2SMMXZ.js";
+  readBinary
+} from "./chunk-S5MBHFLB.js";
+import {
+  OfficeError,
+  characters,
+  equal,
+  literal,
+  openRetainedXmlDocument,
+  resolveOfficeResources
+} from "./chunk-VJQ5OWS5.js";
 
 // packages/safe-bash-presentation-engine/src/settings-scaling.ts
 function unsupported() {
@@ -76,7 +95,7 @@ function scaleDrawingCanvas(document, sx, sy) {
         const node = child(transform, name, a);
         for (const axis of name === "chOff" ? ["x", "y"] : ["cx", "cy"]) {
           const value = node.attributes.find(
-            (attribute) => attribute.name.namespace === "" && attribute.name.localName === axis
+            (attribute2) => attribute2.name.namespace === "" && attribute2.name.localName === axis
           )?.value;
           if (value === void 0 || !value.trim() || [...value.trim()].some(
             (character, index2) => !(character >= "0" && character <= "9") && !(index2 === 0 && (character === "-" || character === "+"))
@@ -119,8 +138,196 @@ function scaleDrawingCanvas(document, sx, sy) {
   return document;
 }
 
+// packages/safe-bash-presentation-engine/src/retained-presentation-settings.ts
+var invalid = (message) => {
+  throw new OfficeError("invalid-opc", message, "index");
+};
+async function child2(document, parent, name) {
+  let found;
+  for await (const node of document.children(parent)) if (node.kind === "element" && await equal(document.raw(node.localName), literal(name)) && await equal(document.namespace(node), document.namespace(parent))) {
+    if (found) invalid("Duplicate presentation setting.");
+    found = node;
+  }
+  return found;
+}
+async function attribute(document, node, name) {
+  for await (const value of document.attributes(node)) if (await equal(document.raw(value.localName), literal(name)) && await equal(document.namespace(value), literal(""))) return value;
+  return void 0;
+}
+async function numeric(document, node, name) {
+  const value = node && await attribute(document, node, name);
+  if (!value) return null;
+  let started = false, ended = false, digits = false, negative = false, number = 0;
+  for await (const character of characters(document.text(value))) {
+    if (character.trim() === "") {
+      if (started) ended = true;
+      continue;
+    }
+    if (ended) invalid("Invalid numeric presentation setting.");
+    if (!started && (character === "+" || character === "-")) {
+      negative = character === "-";
+      started = true;
+      continue;
+    }
+    started = true;
+    if (character < "0" || character > "9") invalid("Invalid numeric presentation setting.");
+    digits = true;
+    number = number * 10 + (character.charCodeAt(0) - 48);
+    if (!Number.isSafeInteger(number)) invalid("Invalid numeric presentation setting.");
+  }
+  if (!digits) invalid("Invalid numeric presentation setting.");
+  return negative ? -number : number;
+}
+async function openRetainedPresentationSettings(archive, fingerprint, settings2) {
+  const context = { ...resolveOfficeResources(settings2), workingStorage: { ...settings2.workingStorage } };
+  const index = await openRetainedPresentationIndex(archive, fingerprint, context), owned = [index];
+  let closed = false, closing;
+  const close = () => {
+    closed = true;
+    return closing ??= (async () => {
+      const results = await Promise.allSettled(owned.map((item) => item.close()));
+      for (const result of results) if (result.status === "rejected") throw result.reason;
+    })();
+  };
+  const check = () => {
+    if (closed) throw new OfficeError("invalid-handle", "Settings are closed.", "index");
+    if (context.signal?.aborted) throw new OfficeError("cancelled", "Operation cancelled.", "index");
+  };
+  try {
+    const validation = await openRetainedPresentationValidation(archive, context, { ...context.xmlLimits, ...context.relationshipLimits, maxBytes: Math.min(context.xmlLimits.maxBytes, context.relationshipLimits.maxBytes), maxEntries: context.archiveLimits.maxMembers });
+    const valid = validation.valid;
+    try {
+      await validation.close();
+    } catch (error) {
+      if (valid) await Promise.reject(error);
+    }
+    if (!valid) throw new OfficeError("invalid-opc", "Settings require a valid presentation graph.", "validate-intent");
+    const types = await openRetainedContentTypes(archive.read("/[Content_Types].xml"), context);
+    owned.push(types);
+    const main = await openRetainedXmlDocument(archive.read(index.records.main), context);
+    owned.push(main);
+    let dialect = dialects[0];
+    for (const candidate of dialects) if (await equal(main.namespace(main.root), literal(candidate.p))) dialect = candidate;
+    async function related(kind) {
+      let count2 = 0, external = false, part;
+      for await (const edge of index.graph.outgoing(index.records.main)) if (await equal(edge.type(), literal(`${dialect.r}/${kind}`))) {
+        count2++;
+        external ||= edge.external;
+        if (edge.targetPart) {
+          const decoder = new TextDecoder();
+          part = "";
+          for await (const bytes of edge.targetPart()) part += decoder.decode(bytes, { stream: true });
+          part += decoder.decode();
+        }
+      }
+      const label = kind === "presProps" ? "presentation" : "view";
+      if (count2 > 1 || external) invalid(`Ambiguous ${label} properties.`);
+      if (!part) return void 0;
+      if (!await equal(await types.get(part), literal(`application/vnd.openxmlformats-officedocument.presentationml.${kind}+xml`))) invalid(`Invalid ${label} properties content type.`);
+      const document = await openRetainedXmlDocument(archive.read(part), context);
+      owned.push(document);
+      if (!await equal(document.namespace(document.root), literal(dialect.p)) || !await equal(document.raw(document.root.localName), literal(kind === "presProps" ? "presentationPr" : "viewPr"))) invalid(`Invalid ${label} properties root.`);
+      return { part, document };
+    }
+    const properties = await related("presProps"), view = await related("viewProps");
+    const viewXml = view ? () => view.document.markup(view.document.root, true) : void 0;
+    if (viewXml) for await (const ignored of viewXml()) check();
+    const print = properties && await child2(properties.document, properties.document.root, "prnPr");
+    const slide = await child2(main, main.root, "sldSz"), notes = await child2(main, main.root, "notesSz");
+    const width = await numeric(main, slide, "cx"), height = await numeric(main, slide, "cy"), notesWidth = await numeric(main, notes, "cx"), notesHeight = await numeric(main, notes, "cy");
+    const show = properties && await child2(properties.document, properties.document.root, "showPr");
+    const loopAttribute = show && await attribute(properties.document, show, "loop");
+    let loop = "";
+    if (loopAttribute) {
+      let trailing = false;
+      for await (const character of characters(properties.document.text(loopAttribute))) {
+        if (character.trim() === "") {
+          if (loop) trailing = true;
+          continue;
+        }
+        if (trailing || loop.length >= 5) invalid("Invalid slideshow loop setting.");
+        loop += character;
+      }
+      if (!["0", "1", "true", "false"].includes(loop)) invalid("Invalid slideshow loop setting.");
+    }
+    let mode = "", count = 0;
+    if (show) {
+      for (const name of ["present", "browse", "kiosk"]) if (await child2(properties.document, show, name)) {
+        mode = name;
+        count++;
+      }
+    }
+    if (count > 1) invalid("Ambiguous slideshow mode.");
+    const slideNumberStart = await numeric(main, main.root, "firstSlideNum") ?? 1;
+    if (slideNumberStart < -2147483648 || slideNumberStart > 2147483647) invalid("Invalid slide numbering value.");
+    const printXml = print ? () => properties.document.markup(print, true) : void 0;
+    if (printXml) for await (const ignored of printXml()) check();
+    const value = {
+      width,
+      height,
+      orientation: width === null || height === null ? null : width >= height ? "landscape" : "portrait",
+      notesWidth,
+      notesHeight,
+      notesOrientation: notesWidth === null || notesHeight === null ? null : notesWidth >= notesHeight ? "landscape" : "portrait",
+      slideNumberStart,
+      loop: loop === "1" || loop === "true",
+      showType: mode === "browse" ? "window" : mode === "kiosk" ? "kiosk" : "speaker",
+      printProperties: printXml ? { part: properties.part, xml: printXml } : null,
+      viewProperties: viewXml ? { part: view.part, xml: viewXml } : null
+    };
+    check();
+    return Object.freeze({ close, settings() {
+      check();
+      return value;
+    }, async *locations() {
+      check();
+      for await (const record of index.records.records("part")) if (record.scope === "presentation") yield record.location;
+      check();
+    } });
+  } catch (error) {
+    await close().catch(() => {
+    });
+    throw error instanceof OfficeError ? error : new OfficeError(context.signal?.aborted ? "cancelled" : "io-failure", "Settings storage operation failed.", "index");
+  }
+}
+async function* pretty(value, depth = 0) {
+  if (value && typeof value === "object") {
+    const array = Array.isArray(value), entries = array ? value.map((item, i) => [String(i), item]) : Object.entries(value);
+    yield* literal(array ? "[\n" : "{\n");
+    let first = true;
+    for (const [key, item] of entries) {
+      if (!first) yield* literal(",\n");
+      first = false;
+      yield* literal("  ".repeat(depth + 1));
+      if (!array) yield* literal(JSON.stringify(key) + ": ");
+      yield* pretty(item, depth + 1);
+    }
+    yield* literal("\n" + "  ".repeat(depth) + (array ? "]" : "}"));
+  } else yield* streamJson(value);
+}
+async function stageRetainedPresentationSettings(archive, fingerprint, settings2, output) {
+  const format = { ...output };
+  if (!["settings.list", "settings.get"].includes(format.operation)) throw new OfficeError("invalid-value", "Invalid settings read operation.", "usage");
+  const view = await openRetainedPresentationSettings(archive, fingerprint, settings2);
+  let staged;
+  try {
+    const data = { fingerprint, ...format.operation === "settings.list" ? { records: [view.settings()] } : { settings: view.settings() } };
+    async function* render() {
+      if (format.json) yield* streamJson({ version: 1, operation: format.operation, ok: true, data, warnings: [], errors: [], affected: 0, locations: view.locations() });
+      else yield* pretty(data);
+      yield* literal("\n");
+    }
+    staged = await stageRetainedOutput(render(), settings2, format.maxOutputBytes);
+    await view.close();
+    return staged;
+  } catch (error) {
+    await Promise.allSettled([view.close(), staged?.close()]);
+    throw error;
+  }
+}
+
 // packages/safe-bash-presentation-engine/src/presentation-settings.ts
-var dialects = [
+var dialects2 = [
   {
     p: "http://schemas.openxmlformats.org/presentationml/2006/main",
     r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
@@ -133,7 +340,7 @@ var dialects = [
 function escapeAttribute(value) {
   return [...value].map((c) => ({ "&": "&amp;", "<": "&lt;", '"': "&quot;" })[c] ?? c).join("");
 }
-function invalid(message) {
+function invalid2(message) {
   throw new OfficeError("invalid-value", message, "usage");
 }
 function unsupported2(message) {
@@ -142,7 +349,7 @@ function unsupported2(message) {
 function attr(node, localName) {
   return node.attributes.find((a) => a.name.namespace === "" && a.name.localName === localName)?.value;
 }
-function child2(node, name) {
+function child3(node, name) {
   const found = node.children.filter(
     (c) => c.name.namespace === node.name.namespace && c.name.localName === name
   );
@@ -150,7 +357,7 @@ function child2(node, name) {
     throw new OfficeError("invalid-opc", "Duplicate presentation setting.", "index");
   return found[0];
 }
-function numeric(value) {
+function numeric2(value) {
   if (value === void 0) return null;
   const text = value.trim();
   if (!text || [...text].some((c, i) => !(c >= "0" && c <= "9") && !(i === 0 && (c === "-" || c === "+"))) || !Number.isSafeInteger(Number(text)))
@@ -159,7 +366,7 @@ function numeric(value) {
 }
 async function load(input, context) {
   if (!context?.xmlLimits || !context.relationshipLimits)
-    invalid("Explicit XML and relationship limits are required.");
+    invalid2("Explicit XML and relationship limits are required.");
   const source = await readBinary(input, context);
   const reader = await readPackage(source, context);
   const limits = {
@@ -176,9 +383,9 @@ async function load(input, context) {
     );
   const types = parseContentTypes(reader.get("/[Content_Types].xml"), limits);
   const graph = readRelationshipGraph(reader, context.relationshipLimits);
-  const main = graph.outgoing("/").find((e) => dialects.some((d) => e.type === `${d.r}/officeDocument`)).targetPart;
+  const main = graph.outgoing("/").find((e) => dialects2.some((d) => e.type === `${d.r}/officeDocument`)).targetPart;
   const document = parseXmlPart(reader.get(main), context.xmlLimits);
-  const dialect = dialects.find((d) => d.p === document.root.name.namespace);
+  const dialect = dialects2.find((d) => d.p === document.root.name.namespace);
   const properties = graph.outgoing(main).filter((e) => e.type === `${dialect.r}/presProps`);
   if (properties.length > 1 || properties.some((e) => e.external))
     throw new OfficeError("invalid-opc", "Ambiguous presentation properties.", "index");
@@ -191,16 +398,16 @@ async function load(input, context) {
   return { source, reader, limits, graph, main, document, dialect, propertyPart, propertyDocument };
 }
 function settings(document, properties) {
-  const slide = child2(document, "sldSz"), notes = child2(document, "notesSz");
-  const width = slide ? numeric(attr(slide, "cx")) : null, height = slide ? numeric(attr(slide, "cy")) : null;
-  const notesWidth = notes ? numeric(attr(notes, "cx")) : null, notesHeight = notes ? numeric(attr(notes, "cy")) : null;
-  const show = properties && child2(properties, "showPr");
+  const slide = child3(document, "sldSz"), notes = child3(document, "notesSz");
+  const width = slide ? numeric2(attr(slide, "cx")) : null, height = slide ? numeric2(attr(slide, "cy")) : null;
+  const notesWidth = notes ? numeric2(attr(notes, "cx")) : null, notesHeight = notes ? numeric2(attr(notes, "cy")) : null;
+  const show = properties && child3(properties, "showPr");
   const loop = show && attr(show, "loop")?.trim();
   if (loop !== void 0 && !["0", "1", "true", "false"].includes(loop.trim()))
     throw new OfficeError("invalid-opc", "Invalid slideshow loop setting.", "index");
-  const modes = show ? ["present", "browse", "kiosk"].filter((n) => child2(show, n)) : [];
+  const modes = show ? ["present", "browse", "kiosk"].filter((n) => child3(show, n)) : [];
   if (modes.length > 1) throw new OfficeError("invalid-opc", "Ambiguous slideshow mode.", "index");
-  const slideNumberStart = numeric(attr(document, "firstSlideNum")) ?? 1;
+  const slideNumberStart = numeric2(attr(document, "firstSlideNum")) ?? 1;
   if (slideNumberStart < -2147483648 || slideNumberStart > 2147483647)
     throw new OfficeError("invalid-opc", "Invalid slide numbering value.", "index");
   return {
@@ -232,7 +439,7 @@ async function readPresentationSettings(input, context) {
       throw new OfficeError("invalid-opc", "Invalid view properties root.", "index");
     viewProperties = { part: viewPart, xml: view.markup(view.root, true) };
   }
-  const print = propertyDocument && child2(propertyDocument.root, "prnPr");
+  const print = propertyDocument && child3(propertyDocument.root, "prnPr");
   return {
     ...settings(loaded.document.root, propertyDocument?.root),
     printProperties: print ? { part: propertyPart, xml: propertyDocument.markup(print, true) } : null,
@@ -264,19 +471,19 @@ function applyPresentationCanvasSettings(document, options, propertyDocument) {
     if (w === void 0 && h === void 0 && o === void 0) continue;
     let width = w ?? pw, height = h ?? ph;
     if (width === null || height === null)
-      invalid("Both dimensions are required when canvas dimensions are absent.");
+      invalid2("Both dimensions are required when canvas dimensions are absent.");
     if (o === "portrait" && width === height)
-      invalid("Square dimensions have landscape orientation.");
+      invalid2("Square dimensions have landscape orientation.");
     if (o && (o === "landscape" ? width < height : width > height)) {
       if (w !== void 0 || h !== void 0)
-        invalid("Explicit dimensions contradict orientation.");
+        invalid2("Explicit dimensions contradict orientation.");
       [width, height] = [height, width];
     }
     const slideSize = name === "sldSz";
     if ([width, height].some(
       (value) => !Number.isSafeInteger(value) || value < (slideSize ? 914400 : 0) || value > (slideSize ? 51206400 : 27273042316900)
     ))
-      invalid("Resulting canvas dimensions are outside supported edit bounds.");
+      invalid2("Resulting canvas dimensions are outside supported edit bounds.");
     dimensions.push({
       name: pn(name),
       merge: {
@@ -329,24 +536,24 @@ async function mutatePresentationSettings(input, options, context) {
     "scaleContent"
   ];
   if (!options || typeof options !== "object" || ![Object.prototype, null].includes(Object.getPrototypeOf(options)) || Object.keys(options).some((k) => !keys.includes(k)))
-    invalid("Invalid presentation settings object.");
+    invalid2("Invalid presentation settings object.");
   if (!Object.entries(options).some(([key, value]) => key !== "scaleContent" && value !== void 0))
-    invalid("At least one setting is required.");
+    invalid2("At least one setting is required.");
   for (const key of ["orientation", "notesOrientation"])
     if (options[key] !== void 0 && !["portrait", "landscape"].includes(options[key]))
-      invalid("Invalid orientation.");
+      invalid2("Invalid orientation.");
   for (const key of ["width", "height", "notesWidth", "notesHeight"]) {
     const value = options[key];
     const slide = key === "width" || key === "height";
     if (value !== void 0 && (!Number.isSafeInteger(value) || value < (slide ? 914400 : 0) || value > (slide ? 51206400 : 27273042316900)))
-      invalid("Invalid EMU dimensions.");
+      invalid2("Invalid EMU dimensions.");
   }
   if (options.slideNumberStart !== void 0 && (!Number.isSafeInteger(options.slideNumberStart) || options.slideNumberStart < -2147483648 || options.slideNumberStart > 2147483647))
-    invalid("Slide numbering requires a signed 32-bit integer.");
+    invalid2("Slide numbering requires a signed 32-bit integer.");
   for (const value of [options.loop, options.scaleContent])
-    if (value !== void 0 && typeof value !== "boolean") invalid("Expected a boolean setting.");
+    if (value !== void 0 && typeof value !== "boolean") invalid2("Expected a boolean setting.");
   if (options.showType !== void 0 && !["speaker", "window", "kiosk"].includes(options.showType))
-    invalid("Invalid slideshow type.");
+    invalid2("Invalid slideshow type.");
   const loaded = await load(input, context);
   const { reader, graph, main, dialect, limits, source } = loaded;
   const pn = (localName) => ({ namespace: dialect.p, localName });
@@ -369,7 +576,7 @@ async function mutatePresentationSettings(input, options, context) {
   const changes = /* @__PURE__ */ new Map([[main, document.bytes()]]);
   if (options.scaleContent) {
     if (options.width === void 0 && options.height === void 0 && options.orientation === void 0)
-      invalid("Content scaling requires a slide canvas change.");
+      invalid2("Content scaling requires a slide canvas change.");
     const next = settings(document.root, loaded.propertyDocument?.root);
     if (!previous.width || !previous.height || !next.width || !next.height)
       unsupported2("Content scaling requires complete nonzero slide dimensions.");
@@ -475,6 +682,8 @@ async function mutatePresentationSettings(input, options, context) {
 }
 
 export {
+  openRetainedPresentationSettings,
+  stageRetainedPresentationSettings,
   readPresentationSettings,
   applyPresentationCanvasSettings,
   mutatePresentationSettings

package/dist/safe-bash/command-chunks/{chunk-XMRQ6UP2.js → chunk-ZZO3GYEZ.js}

@@ -1,6 +1,6 @@
 import {
   SearchError
-} from "./chunk-5VF2EA7Z.js";
+} from "./chunk-U7J3R7HX.js";
 
 // packages/safe-bash-command-rg/src/shared.ts
 import { readFileStream } from "../../safe-bash-contracts/filesystem.js";
@@ -22,7 +22,6 @@ var emptyBuffer = filledBytes(0);
 var OUT_BUFFER_SIZE = 64 * 1024;
 var sharedOutBuf = new Uint8Array(OUT_BUFFER_SIZE);
 var sharedOutBufInUse = false;
-var sharedOutBufGeneration = 0;
 var Limits = class {
   constructor(context, options) {
     this.context = context;
@@ -97,7 +96,6 @@ var Limits = class {
     if (!buf) {
       if (!sharedOutBufInUse) {
         sharedOutBufInUse = true;
-        sharedOutBufGeneration = sharedOutBufGeneration + 1 | 0;
         this.usingSharedBuf = true;
         buf = this.outBuf = sharedOutBuf;
       } else {
@@ -152,13 +150,6 @@ var Limits = class {
       this.releaseOutBuf();
     }
   }
-  flushCachedSharedSync(len) {
-    if (sharedOutBufInUse) return false;
-    const syncSink = this.context.stdout;
-    if (typeof syncSink.writeRangeSync !== "function") return false;
-    (this._signal ?? this.context.signal).throwIfAborted();
-    return syncSink.writeRangeSync(sharedOutBuf, len) === true;
-  }
   flushSyncOrAsync() {
     if (this.outPos > 0 && this.outBuf) {
       const syncSink = this.context.stdout;
@@ -764,7 +755,6 @@ Object.assign(Limits.prototype, {
 export {
   pathFor,
   OutputClosed,
-  sharedOutBufGeneration,
   Limits,
   fileInput,
   diagnostic,