@poe-platform/safe-bash 0.1.817 → 0.1.819

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

@@ -1,68 +1,71 @@
 import {
   Presentation
-} from "../safe-bash/command-chunks/chunk-XBWD6SI3.js";
-import "../safe-bash/command-chunks/chunk-MDFNUNK5.js";
-import "../safe-bash/command-chunks/chunk-L2VLASZ4.js";
-import "../safe-bash/command-chunks/chunk-EZDWPTYB.js";
-import "../safe-bash/command-chunks/chunk-BIJW6QWB.js";
-import "../safe-bash/command-chunks/chunk-SBXS4S6Y.js";
-import "../safe-bash/command-chunks/chunk-LT2YCGC5.js";
-import "../safe-bash/command-chunks/chunk-S5ER73EA.js";
-import "../safe-bash/command-chunks/chunk-LFSWLJPR.js";
-import "../safe-bash/command-chunks/chunk-6M3JTPKE.js";
-import "../safe-bash/command-chunks/chunk-ICJH6A73.js";
-import "../safe-bash/command-chunks/chunk-U42WHQRH.js";
-import "../safe-bash/command-chunks/chunk-T2FRXSQT.js";
-import "../safe-bash/command-chunks/chunk-QCIAX6HZ.js";
-import "../safe-bash/command-chunks/chunk-5KZMR6AJ.js";
-import "../safe-bash/command-chunks/chunk-BSTABZIK.js";
-import "../safe-bash/command-chunks/chunk-CORUUCS2.js";
-import "../safe-bash/command-chunks/chunk-FJLSYX5P.js";
-import "../safe-bash/command-chunks/chunk-AF2IO57Q.js";
-import "../safe-bash/command-chunks/chunk-FB2WPI3M.js";
-import "../safe-bash/command-chunks/chunk-XVEI4HZL.js";
-import "../safe-bash/command-chunks/chunk-F2NF6FHV.js";
-import "../safe-bash/command-chunks/chunk-HOJ7WDTS.js";
-import "../safe-bash/command-chunks/chunk-LMLBQSAM.js";
-import "../safe-bash/command-chunks/chunk-3K5CVXUV.js";
-import "../safe-bash/command-chunks/chunk-OVUY46QF.js";
-import "../safe-bash/command-chunks/chunk-7B2MHKIW.js";
-import "../safe-bash/command-chunks/chunk-UKAGRRLZ.js";
-import "../safe-bash/command-chunks/chunk-GR4ONCQ5.js";
-import "../safe-bash/command-chunks/chunk-PU5DMQGG.js";
-import "../safe-bash/command-chunks/chunk-YKODRSGT.js";
-import "../safe-bash/command-chunks/chunk-SWIF6BBY.js";
-import "../safe-bash/command-chunks/chunk-DZOKH5BL.js";
-import "../safe-bash/command-chunks/chunk-CGJ7GMHO.js";
-import "../safe-bash/command-chunks/chunk-5V7WIQ2D.js";
-import "../safe-bash/command-chunks/chunk-4IDV763L.js";
-import "../safe-bash/command-chunks/chunk-UPXFSGQG.js";
-import "../safe-bash/command-chunks/chunk-X42MJT2J.js";
-import "../safe-bash/command-chunks/chunk-PPN53PX3.js";
-import "../safe-bash/command-chunks/chunk-UFLMOU3B.js";
-import "../safe-bash/command-chunks/chunk-6JGICYHP.js";
-import "../safe-bash/command-chunks/chunk-WOL3LBXE.js";
-import "../safe-bash/command-chunks/chunk-WHZ6XK7Y.js";
-import "../safe-bash/command-chunks/chunk-B6XTAKKQ.js";
+} from "../safe-bash/command-chunks/chunk-3MFYCMQU.js";
+import "../safe-bash/command-chunks/chunk-OMD45J52.js";
+import "../safe-bash/command-chunks/chunk-2GUI3ZKE.js";
+import "../safe-bash/command-chunks/chunk-PYYAX5FB.js";
+import "../safe-bash/command-chunks/chunk-2VSNIHIW.js";
+import "../safe-bash/command-chunks/chunk-EU5SR3LS.js";
+import "../safe-bash/command-chunks/chunk-DZTT5SLG.js";
+import "../safe-bash/command-chunks/chunk-WV3C6BRD.js";
+import "../safe-bash/command-chunks/chunk-FGK6HLSY.js";
+import "../safe-bash/command-chunks/chunk-ZZ6EIACJ.js";
+import "../safe-bash/command-chunks/chunk-HVLF3Y4B.js";
+import "../safe-bash/command-chunks/chunk-HCZITM4C.js";
+import "../safe-bash/command-chunks/chunk-NR7POLKP.js";
+import "../safe-bash/command-chunks/chunk-XXUMECE4.js";
+import "../safe-bash/command-chunks/chunk-3LMUKOP2.js";
+import "../safe-bash/command-chunks/chunk-ZXIOTUXC.js";
+import "../safe-bash/command-chunks/chunk-HUAQZFON.js";
+import "../safe-bash/command-chunks/chunk-NNYOPI7K.js";
+import "../safe-bash/command-chunks/chunk-HQFX5XKV.js";
+import "../safe-bash/command-chunks/chunk-ZTW2E5OT.js";
+import "../safe-bash/command-chunks/chunk-PAEAEFK3.js";
+import "../safe-bash/command-chunks/chunk-GAYTDZPP.js";
+import "../safe-bash/command-chunks/chunk-ITJDLFPW.js";
+import "../safe-bash/command-chunks/chunk-6REH56FL.js";
+import "../safe-bash/command-chunks/chunk-63WEASJ7.js";
+import "../safe-bash/command-chunks/chunk-ZS4J5B6Y.js";
+import "../safe-bash/command-chunks/chunk-ZWGERYLT.js";
+import "../safe-bash/command-chunks/chunk-JQPDVCBU.js";
+import "../safe-bash/command-chunks/chunk-4HJEZGYN.js";
+import "../safe-bash/command-chunks/chunk-6RE4MZYM.js";
+import "../safe-bash/command-chunks/chunk-64L57DEI.js";
+import "../safe-bash/command-chunks/chunk-RC4TNFNF.js";
+import "../safe-bash/command-chunks/chunk-RKON2TGI.js";
+import "../safe-bash/command-chunks/chunk-LBBJ5S3W.js";
+import "../safe-bash/command-chunks/chunk-U6VSRO6E.js";
+import "../safe-bash/command-chunks/chunk-RESJSUHH.js";
+import "../safe-bash/command-chunks/chunk-NDJPULBE.js";
+import "../safe-bash/command-chunks/chunk-3RDEX4AF.js";
+import "../safe-bash/command-chunks/chunk-75OUKYCM.js";
+import "../safe-bash/command-chunks/chunk-FCGMSOF6.js";
+import "../safe-bash/command-chunks/chunk-LZHFVNEV.js";
+import "../safe-bash/command-chunks/chunk-R36PDP3L.js";
+import "../safe-bash/command-chunks/chunk-7JTJQKIV.js";
+import "../safe-bash/command-chunks/chunk-YXIJOYT6.js";
+import "../safe-bash/command-chunks/chunk-LBILRPVR.js";
+import "../safe-bash/command-chunks/chunk-GNVAW6NL.js";
 import "../safe-bash/command-chunks/chunk-HR2Y6YEP.js";
-import "../safe-bash/command-chunks/chunk-A5SPMSKD.js";
-import "../safe-bash/command-chunks/chunk-TG2RVQLP.js";
-import "../safe-bash/command-chunks/chunk-NCNHJRIY.js";
-import "../safe-bash/command-chunks/chunk-Q65GWGQR.js";
-import "../safe-bash/command-chunks/chunk-FAU2KL6I.js";
-import "../safe-bash/command-chunks/chunk-6W4RMBFH.js";
-import "../safe-bash/command-chunks/chunk-6KJDTKE4.js";
+import "../safe-bash/command-chunks/chunk-UDRJKA3P.js";
+import "../safe-bash/command-chunks/chunk-5KWEZV5H.js";
+import "../safe-bash/command-chunks/chunk-SKF6PGA5.js";
+import "../safe-bash/command-chunks/chunk-KVTZJBLM.js";
+import "../safe-bash/command-chunks/chunk-SKDJCMGI.js";
+import "../safe-bash/command-chunks/chunk-P3LHQOX7.js";
+import "../safe-bash/command-chunks/chunk-O4H7HPMP.js";
 import "../safe-bash/command-chunks/chunk-FWKLBDMK.js";
-import "../safe-bash/command-chunks/chunk-GTOMW4VV.js";
-import "../safe-bash/command-chunks/chunk-7PYDVQPB.js";
-import "../safe-bash/command-chunks/chunk-XFIDOCYH.js";
-import "../safe-bash/command-chunks/chunk-4YFTJS5U.js";
-import "../safe-bash/command-chunks/chunk-MOUCMZZP.js";
+import "../safe-bash/command-chunks/chunk-PNOXBL2B.js";
+import "../safe-bash/command-chunks/chunk-YWP62BAZ.js";
+import "../safe-bash/command-chunks/chunk-QMXOKYMJ.js";
+import "../safe-bash/command-chunks/chunk-6ZHNKHQQ.js";
+import "../safe-bash/command-chunks/chunk-PZVFNPRC.js";
+import "../safe-bash/command-chunks/chunk-S5MBHFLB.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-G3FK5VVG.js";
-import "../safe-bash/command-chunks/chunk-HQEYSSZV.js";
+import "../safe-bash/command-chunks/chunk-HTBUIRTH.js";
+import "../safe-bash/command-chunks/chunk-JLS6XKAR.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
-import "../safe-bash/command-chunks/chunk-KM2SMMXZ.js";
+import "../safe-bash/command-chunks/chunk-VJQ5OWS5.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-NUGQQDGE.js";

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

@@ -35,3 +35,4 @@ export interface MutatePresentationSettingsOptions {
 export declare function readPresentationSettings(input: BinaryInput, context: SelectionContext): Promise<PresentationSettings>;
 export declare function applyPresentationCanvasSettings(document: XmlPart, options: Pick<MutatePresentationSettingsOptions, "width" | "height" | "orientation" | "notesWidth" | "notesHeight" | "notesOrientation" | "slideNumberStart">, propertyDocument?: XmlPart | null): XmlPart;
 export declare function mutatePresentationSettings(input: BinaryInput, options: MutatePresentationSettingsOptions, context: SelectionContext): Promise<Uint8Array>;
+export { openRetainedPresentationSettings, stageRetainedPresentationSettings, type RetainedPresentationSettingsValue } from './retained-presentation-settings.js';

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

@@ -1,29 +1,38 @@
 import {
   applyPresentationCanvasSettings,
   mutatePresentationSettings,
-  readPresentationSettings
-} from "../safe-bash/command-chunks/chunk-LFSWLJPR.js";
-import "../safe-bash/command-chunks/chunk-TG2RVQLP.js";
-import "../safe-bash/command-chunks/chunk-Q65GWGQR.js";
-import "../safe-bash/command-chunks/chunk-FAU2KL6I.js";
-import "../safe-bash/command-chunks/chunk-6W4RMBFH.js";
-import "../safe-bash/command-chunks/chunk-6KJDTKE4.js";
+  openRetainedPresentationSettings,
+  readPresentationSettings,
+  stageRetainedPresentationSettings
+} from "../safe-bash/command-chunks/chunk-ZZ6EIACJ.js";
+import "../safe-bash/command-chunks/chunk-LZHFVNEV.js";
+import "../safe-bash/command-chunks/chunk-R36PDP3L.js";
+import "../safe-bash/command-chunks/chunk-7JTJQKIV.js";
+import "../safe-bash/command-chunks/chunk-5KWEZV5H.js";
+import "../safe-bash/command-chunks/chunk-SKF6PGA5.js";
+import "../safe-bash/command-chunks/chunk-KVTZJBLM.js";
+import "../safe-bash/command-chunks/chunk-SKDJCMGI.js";
+import "../safe-bash/command-chunks/chunk-P3LHQOX7.js";
+import "../safe-bash/command-chunks/chunk-O4H7HPMP.js";
 import "../safe-bash/command-chunks/chunk-FWKLBDMK.js";
-import "../safe-bash/command-chunks/chunk-GTOMW4VV.js";
-import "../safe-bash/command-chunks/chunk-7PYDVQPB.js";
-import "../safe-bash/command-chunks/chunk-XFIDOCYH.js";
-import "../safe-bash/command-chunks/chunk-4YFTJS5U.js";
-import "../safe-bash/command-chunks/chunk-MOUCMZZP.js";
+import "../safe-bash/command-chunks/chunk-PNOXBL2B.js";
+import "../safe-bash/command-chunks/chunk-YWP62BAZ.js";
+import "../safe-bash/command-chunks/chunk-QMXOKYMJ.js";
+import "../safe-bash/command-chunks/chunk-6ZHNKHQQ.js";
+import "../safe-bash/command-chunks/chunk-PZVFNPRC.js";
+import "../safe-bash/command-chunks/chunk-S5MBHFLB.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-G3FK5VVG.js";
-import "../safe-bash/command-chunks/chunk-HQEYSSZV.js";
+import "../safe-bash/command-chunks/chunk-HTBUIRTH.js";
+import "../safe-bash/command-chunks/chunk-JLS6XKAR.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
-import "../safe-bash/command-chunks/chunk-KM2SMMXZ.js";
+import "../safe-bash/command-chunks/chunk-VJQ5OWS5.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";
 export {
   applyPresentationCanvasSettings,
   mutatePresentationSettings,
-  readPresentationSettings
+  openRetainedPresentationSettings,
+  readPresentationSettings,
+  stageRetainedPresentationSettings
 };

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

@@ -10,27 +10,30 @@ import {
   sanitizeProperties,
   stageRetainedProperties,
   validatePropertyValue
-} from "../safe-bash/command-chunks/chunk-AF2IO57Q.js";
-import "../safe-bash/command-chunks/chunk-FB2WPI3M.js";
-import "../safe-bash/command-chunks/chunk-XVEI4HZL.js";
-import "../safe-bash/command-chunks/chunk-A5SPMSKD.js";
-import "../safe-bash/command-chunks/chunk-TG2RVQLP.js";
-import "../safe-bash/command-chunks/chunk-NCNHJRIY.js";
-import "../safe-bash/command-chunks/chunk-Q65GWGQR.js";
-import "../safe-bash/command-chunks/chunk-FAU2KL6I.js";
-import "../safe-bash/command-chunks/chunk-6W4RMBFH.js";
-import "../safe-bash/command-chunks/chunk-6KJDTKE4.js";
+} from "../safe-bash/command-chunks/chunk-6REH56FL.js";
+import "../safe-bash/command-chunks/chunk-63WEASJ7.js";
+import "../safe-bash/command-chunks/chunk-LZHFVNEV.js";
+import "../safe-bash/command-chunks/chunk-R36PDP3L.js";
+import "../safe-bash/command-chunks/chunk-7JTJQKIV.js";
+import "../safe-bash/command-chunks/chunk-UDRJKA3P.js";
+import "../safe-bash/command-chunks/chunk-5KWEZV5H.js";
+import "../safe-bash/command-chunks/chunk-SKF6PGA5.js";
+import "../safe-bash/command-chunks/chunk-KVTZJBLM.js";
+import "../safe-bash/command-chunks/chunk-SKDJCMGI.js";
+import "../safe-bash/command-chunks/chunk-P3LHQOX7.js";
+import "../safe-bash/command-chunks/chunk-O4H7HPMP.js";
 import "../safe-bash/command-chunks/chunk-FWKLBDMK.js";
-import "../safe-bash/command-chunks/chunk-GTOMW4VV.js";
-import "../safe-bash/command-chunks/chunk-7PYDVQPB.js";
-import "../safe-bash/command-chunks/chunk-XFIDOCYH.js";
-import "../safe-bash/command-chunks/chunk-4YFTJS5U.js";
-import "../safe-bash/command-chunks/chunk-MOUCMZZP.js";
+import "../safe-bash/command-chunks/chunk-PNOXBL2B.js";
+import "../safe-bash/command-chunks/chunk-YWP62BAZ.js";
+import "../safe-bash/command-chunks/chunk-QMXOKYMJ.js";
+import "../safe-bash/command-chunks/chunk-6ZHNKHQQ.js";
+import "../safe-bash/command-chunks/chunk-PZVFNPRC.js";
+import "../safe-bash/command-chunks/chunk-S5MBHFLB.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-G3FK5VVG.js";
-import "../safe-bash/command-chunks/chunk-HQEYSSZV.js";
+import "../safe-bash/command-chunks/chunk-HTBUIRTH.js";
+import "../safe-bash/command-chunks/chunk-JLS6XKAR.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
-import "../safe-bash/command-chunks/chunk-KM2SMMXZ.js";
+import "../safe-bash/command-chunks/chunk-VJQ5OWS5.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-NUGQQDGE.js";

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

@@ -3,12 +3,12 @@ import {
   parseRelationships,
   readRelationshipGraph,
   relationshipGraph
-} from "../safe-bash/command-chunks/chunk-4YFTJS5U.js";
-import "../safe-bash/command-chunks/chunk-MOUCMZZP.js";
+} from "../safe-bash/command-chunks/chunk-QMXOKYMJ.js";
+import "../safe-bash/command-chunks/chunk-PZVFNPRC.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-G3FK5VVG.js";
-import "../safe-bash/command-chunks/chunk-HQEYSSZV.js";
-import "../safe-bash/command-chunks/chunk-KM2SMMXZ.js";
+import "../safe-bash/command-chunks/chunk-HTBUIRTH.js";
+import "../safe-bash/command-chunks/chunk-JLS6XKAR.js";
+import "../safe-bash/command-chunks/chunk-VJQ5OWS5.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

package/dist/safe-bash-presentation-engine/resource-limits.js

@@ -1,8 +1,8 @@
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-HQEYSSZV.js";
+import "../safe-bash/command-chunks/chunk-JLS6XKAR.js";
 import {
   resolveOfficeResources
-} from "../safe-bash/command-chunks/chunk-KM2SMMXZ.js";
+} from "../safe-bash/command-chunks/chunk-VJQ5OWS5.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

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

@@ -1,13 +1,17 @@
-import type { ByteSink } from './contracts.js';
-import type { RetainedPackageContext } from './retained-package.js';
-import type { RetainedPackageExtraction } from './retained-package-extraction.js';
+import type { openRetainedMediaExtraction } from "./retained-media-extraction.js";
+import type { ByteSink } from "./contracts.js";
+import type { RetainedPackageContext } from "./retained-package.js";
+import type { openRetainedObjectExtraction } from "./retained-object-extraction.js";
+import type { RetainedPackageExtraction } from "./retained-package-extraction.js";
 /** Store manifest fragments and prefix boundaries before publication. Diagnostic
  * storage survives publication cancellation so completed files can be reported. */
-export declare function stageRetainedExtractionOutput(extraction: RetainedPackageExtraction, settings: RetainedPackageContext, output: {
+export declare function stageRetainedExtractionOutput(extraction: RetainedPackageExtraction | Awaited<ReturnType<typeof openRetainedObjectExtraction>> | Awaited<ReturnType<typeof openRetainedMediaExtraction>>, settings: RetainedPackageContext, output: {
     readonly directory: string;
     readonly json: boolean;
     readonly maxOutputBytes: number;
     readonly allowPartialOutput: boolean;
+    readonly operation?: "extract" | "objects.extract" | "media.extract";
+    readonly dryRun?: boolean;
 }): Promise<Readonly<{
     close: () => Promise<void>;
     path: (name: string) => string;

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

@@ -0,0 +1,26 @@
+import type { ByteSource } from "./contracts.js";
+import type { RetainedPackageArchive, RetainedPackageContext } from './retained-package.js';
+import { rawJson } from './retained-output.js';
+type Archive = Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>;
+/** Font declarations and variant strings remain caller-backed; opaque font bytes
+ * are inventoried without installing, decoding or interpreting them. */
+export declare function openRetainedFonts(archive: Archive, settings: RetainedPackageContext): Promise<Readonly<{
+    close: () => Promise<void>;
+    fonts: () => AsyncGenerator<{
+        [rawJson]: () => ByteSource;
+    }, void, unknown>;
+    summaries(): AsyncGenerator<{
+        part: string;
+        kind: import("./opaque-objects.js").OpaqueObjectKind;
+        bytes: number;
+        activeContent: boolean;
+    }, void, unknown>;
+    declarations(): AsyncGenerator<{
+        [rawJson]: () => ByteSource;
+    }, void, unknown>;
+}>>;
+export declare function stageRetainedFonts(archive: Archive, settings: RetainedPackageContext, output: {
+    readonly json: boolean;
+    readonly maxOutputBytes: number;
+}): Promise<import("./retained-output.js").StagedOutput>;
+export {};

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

@@ -0,0 +1,13 @@
+import type { RetainedPackageArchive, RetainedPackageContext } from "./retained-package.js";
+/** Hash one borrowed archive member while reading its image metadata.
+ * Sequential formats never spill. JPEG's 16-bit segment length bounds Exif
+ * backtracking; TIFF alone uses caller-authorized pages for arbitrary offsets.
+ * The member iterator and all scratch are retired before the result is exposed.
+ */
+export declare function readRetainedImageMetadata(archive: Pick<RetainedPackageArchive, "byteLength" | "read">, part: string, mediaType: string, settings: RetainedPackageContext): Promise<{
+    sha1: string;
+    pixelWidth: number | null;
+    pixelHeight: number | null;
+    dpiX: number;
+    dpiY: number;
+}>;

package/dist/safe-bash-presentation-engine/retained-inspection.js

@@ -1,22 +1,24 @@
 import {
   openRetainedPresentationIndex,
   stageRetainedInspection
-} from "../safe-bash/command-chunks/chunk-FB2WPI3M.js";
-import "../safe-bash/command-chunks/chunk-XVEI4HZL.js";
-import "../safe-bash/command-chunks/chunk-NCNHJRIY.js";
-import "../safe-bash/command-chunks/chunk-Q65GWGQR.js";
-import "../safe-bash/command-chunks/chunk-FAU2KL6I.js";
-import "../safe-bash/command-chunks/chunk-6KJDTKE4.js";
+} from "../safe-bash/command-chunks/chunk-LZHFVNEV.js";
+import "../safe-bash/command-chunks/chunk-R36PDP3L.js";
+import "../safe-bash/command-chunks/chunk-7JTJQKIV.js";
+import "../safe-bash/command-chunks/chunk-SKF6PGA5.js";
+import "../safe-bash/command-chunks/chunk-KVTZJBLM.js";
+import "../safe-bash/command-chunks/chunk-P3LHQOX7.js";
+import "../safe-bash/command-chunks/chunk-O4H7HPMP.js";
 import "../safe-bash/command-chunks/chunk-FWKLBDMK.js";
-import "../safe-bash/command-chunks/chunk-GTOMW4VV.js";
-import "../safe-bash/command-chunks/chunk-7PYDVQPB.js";
-import "../safe-bash/command-chunks/chunk-XFIDOCYH.js";
-import "../safe-bash/command-chunks/chunk-4YFTJS5U.js";
-import "../safe-bash/command-chunks/chunk-MOUCMZZP.js";
+import "../safe-bash/command-chunks/chunk-PNOXBL2B.js";
+import "../safe-bash/command-chunks/chunk-YWP62BAZ.js";
+import "../safe-bash/command-chunks/chunk-QMXOKYMJ.js";
+import "../safe-bash/command-chunks/chunk-6ZHNKHQQ.js";
+import "../safe-bash/command-chunks/chunk-PZVFNPRC.js";
+import "../safe-bash/command-chunks/chunk-S5MBHFLB.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-G3FK5VVG.js";
-import "../safe-bash/command-chunks/chunk-HQEYSSZV.js";
-import "../safe-bash/command-chunks/chunk-KM2SMMXZ.js";
+import "../safe-bash/command-chunks/chunk-HTBUIRTH.js";
+import "../safe-bash/command-chunks/chunk-JLS6XKAR.js";
+import "../safe-bash/command-chunks/chunk-VJQ5OWS5.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

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

@@ -0,0 +1,21 @@
+import type { ByteSource } from "./contracts.js";
+import type { RetainedPackageArchive, RetainedPackageContext } from "./retained-package.js";
+import { type ExtractMediaOptions } from "./media-extraction.js";
+type Archive = Pick<RetainedPackageArchive, "parts" | "has" | "read" | "byteLength">;
+export interface RetainedExtractedMediaMember {
+    readonly part: string;
+    readonly name: string;
+    readonly size: number;
+    readonly sha256: string;
+    readonly contentType: (() => ByteSource) | null;
+    sourceParts(): AsyncGenerator<() => ByteSource>;
+    occurrenceIds(): AsyncGenerator<() => ByteSource>;
+    bytes(): ByteSource;
+}
+/** Admit extraction order, grouping and provenance in caller storage. Archive ownership stays with the caller. */
+export declare function openRetainedMediaExtraction(archive: Archive, fingerprint: string, options: ExtractMediaOptions | undefined, settings: RetainedPackageContext): Promise<Readonly<{
+    close: () => Promise<void>;
+    count: number;
+    members(): AsyncGenerator<RetainedExtractedMediaMember>;
+}>>;
+export {};

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

@@ -0,0 +1,54 @@
+import { type ReadMediaOptions } from "./media.js";
+import type { ByteSource, Location } from "./contracts.js";
+import type { RetainedPackageArchive, RetainedPackageContext } from "./retained-package.js";
+import { OfficeError } from "./errors.js";
+import { rawJson, type StagedOutput } from "./retained-output.js";
+type Archive = Pick<RetainedPackageArchive, "parts" | "has" | "read" | "byteLength">;
+export declare class RetainedMediaSelectionError extends OfficeError {
+    readonly candidates: () => AsyncIterable<Location>;
+    readonly close: () => Promise<void>;
+    constructor(code: "missing-selection" | "ambiguous-selection", candidates: () => AsyncIterable<Location>, close: () => Promise<void>);
+}
+/** Complete media admission into caller-owned records; the archive is borrowed. */
+export declare function openRetainedMedia(archive: Archive, fingerprint: string, input: ReadMediaOptions, settings: RetainedPackageContext): Promise<Readonly<{
+    close: () => Promise<void>;
+    count: number;
+    occurrences(): AsyncGenerator<{
+        [rawJson]: () => ByteSource;
+    }, void, unknown>;
+    media(): AsyncGenerator<{
+        [rawJson]: () => ByteSource;
+    }, void, unknown>;
+    resources(): AsyncGenerator<{
+        occurrence: number;
+        occurrenceId: () => ByteSource;
+        contentType: (() => ByteSource) | null;
+        external: boolean;
+        part: string | null;
+        bytes: number | null;
+        sha256: string | null;
+    }, void, unknown>;
+    summaries(): AsyncGenerator<{
+        name: (() => ByteSource) | null;
+        location: Location;
+        sourcePart: string;
+        shapeId: string | null;
+        kind: "audio" | "video" | "unknown";
+        embedded: number;
+        linked: number;
+    }, void, unknown>;
+}>>;
+export declare function stageRetainedMedia(archive: Archive, fingerprint: string, options: ReadMediaOptions, settings: RetainedPackageContext, format: {
+    readonly operation: "media.list" | "media.get";
+    readonly json: boolean;
+    readonly maxOutputBytes: number;
+}): Promise<{
+    output: StagedOutput;
+    ok: boolean;
+}>;
+export declare function stageRetainedMediaSelectionError(selection: RetainedMediaSelectionError, settings: RetainedPackageContext, format: {
+    readonly operation: string;
+    readonly json: boolean;
+    readonly maxOutputBytes: number;
+}): Promise<StagedOutput>;
+export {};

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

@@ -0,0 +1,25 @@
+import { type StagedOutput } from './retained-output.js';
+import type { ByteSource } from './contracts.js';
+import type { MembershipKind } from './memberships.js';
+import type { RetainedPackageArchive, RetainedPackageContext } from './retained-package.js';
+export interface RetainedMembershipRecord {
+    id(): ByteSource;
+    name(): ByteSource;
+    readonly position: number;
+    slides(): AsyncGenerator<number>;
+}
+/** Ordered records, identity sets and slide references live in caller pages. */
+export declare function openRetainedMemberships(archive: Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>, kind: MembershipKind, settings: RetainedPackageContext): Promise<Readonly<{
+    owner: string;
+    close: () => Promise<void>;
+    records(): AsyncGenerator<RetainedMembershipRecord>;
+}>>;
+/** Stage complete command responses before retiring metadata or exposing a sink. */
+export declare function stageRetainedMemberships(archive: Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>, fingerprint: string, kind: MembershipKind, selection: {
+    readonly token?: string;
+    readonly slide?: number;
+}, settings: RetainedPackageContext, output: {
+    readonly operation: 'sections.list' | 'sections.get' | 'shows.list' | 'shows.get';
+    readonly json: boolean;
+    readonly maxOutputBytes: number;
+}): Promise<StagedOutput>;

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

@@ -0,0 +1,22 @@
+import type { ByteSource } from './contracts.js';
+import type { RetainedPackageArchive, RetainedPackageContext } from './retained-package.js';
+import { rawJson } from './retained-output.js';
+export interface RetainedExtractedObjectMember {
+    readonly part: string;
+    readonly name: string;
+    readonly size: number;
+    readonly sha256: string;
+    bytes(): ByteSource;
+}
+/** Admit the complete opaque inventory, then retain the selected closure and
+ * original relationship parts. The archive and source remain caller-owned. */
+export declare function openRetainedObjectExtraction(archive: Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>, options: {
+    readonly part: string;
+}, settings: RetainedPackageContext): Promise<Readonly<{
+    close: () => Promise<void>;
+    count: number;
+    members(): AsyncGenerator<RetainedExtractedObjectMember>;
+    relationships(): AsyncGenerator<{
+        [rawJson]: () => ByteSource;
+    }, void, unknown>;
+}>>;

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

@@ -0,0 +1,25 @@
+import type { ByteSource } from "./contracts.js";
+import type { OpaqueObjectKind } from './opaque-objects.js';
+import type { RetainedPackageArchive, RetainedPackageContext } from './retained-package.js';
+import { rawJson } from './retained-output.js';
+type Archive = Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>;
+/** Borrow the admitted archive; retain inventory, closure queues and arbitrary
+ * strings in caller storage. Payloads are hashed incrementally, never parsed. */
+export declare function openRetainedObjects(archive: Archive, settings: RetainedPackageContext): Promise<Readonly<{
+    close: () => Promise<void>;
+    count: number;
+    objects(kind?: OpaqueObjectKind): AsyncGenerator<{
+        [rawJson]: () => ByteSource;
+    }, void, unknown>;
+    summaries(): AsyncGenerator<{
+        part: string;
+        kind: OpaqueObjectKind;
+        bytes: number;
+        activeContent: boolean;
+    }, void, unknown>;
+}>>;
+export declare function stageRetainedObjects(archive: Archive, settings: RetainedPackageContext, output: {
+    readonly json: boolean;
+    readonly maxOutputBytes: number;
+}): Promise<import("./retained-output.js").StagedOutput>;
+export {};

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

@@ -1,14 +1,14 @@
 import {
   openPackageArchive
-} from "../safe-bash/command-chunks/chunk-FJLSYX5P.js";
-import "../safe-bash/command-chunks/chunk-XVEI4HZL.js";
+} from "../safe-bash/command-chunks/chunk-ITJDLFPW.js";
+import "../safe-bash/command-chunks/chunk-7JTJQKIV.js";
 import "../safe-bash/command-chunks/chunk-FWKLBDMK.js";
-import "../safe-bash/command-chunks/chunk-MOUCMZZP.js";
+import "../safe-bash/command-chunks/chunk-PZVFNPRC.js";
 import "../safe-bash/command-chunks/chunk-ZITBS2EB.js";
-import "../safe-bash/command-chunks/chunk-G3FK5VVG.js";
-import "../safe-bash/command-chunks/chunk-HQEYSSZV.js";
+import "../safe-bash/command-chunks/chunk-HTBUIRTH.js";
+import "../safe-bash/command-chunks/chunk-JLS6XKAR.js";
 import "../safe-bash/command-chunks/chunk-37XCUS43.js";
-import "../safe-bash/command-chunks/chunk-KM2SMMXZ.js";
+import "../safe-bash/command-chunks/chunk-VJQ5OWS5.js";
 import "../safe-bash/command-chunks/chunk-IOEUZ4EA.js";
 import "../safe-bash/command-chunks/chunk-E6SK3OU2.js";
 import "../safe-bash/command-chunks/chunk-65DS4IOB.js";

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

@@ -0,0 +1,25 @@
+import type { PresentationSettings } from './presentation-settings.js';
+import type { ByteSource } from './contracts.js';
+import type { RetainedPackageArchive, RetainedPackageContext } from './retained-package.js';
+import { type StagedOutput } from './retained-output.js';
+export interface RetainedPresentationSettingsValue extends Omit<PresentationSettings, 'printProperties' | 'viewProperties'> {
+    readonly printProperties: {
+        readonly part: string;
+        xml(): ByteSource;
+    } | null;
+    readonly viewProperties: {
+        readonly part: string;
+        xml(): ByteSource;
+    } | null;
+}
+/** Retained presentation settings; arbitrary print/view XML stays in caller storage. */
+export declare function openRetainedPresentationSettings(archive: Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>, fingerprint: string, settings: RetainedPackageContext): Promise<Readonly<{
+    close: () => Promise<void>;
+    settings(): RetainedPresentationSettingsValue;
+    locations(): AsyncGenerator<import("./contracts.js").Location, void, unknown>;
+}>>;
+export declare function stageRetainedPresentationSettings(archive: Pick<RetainedPackageArchive, 'parts' | 'has' | 'read' | 'byteLength'>, fingerprint: string, settings: RetainedPackageContext, output: {
+    readonly operation: 'settings.list' | 'settings.get';
+    readonly json: boolean;
+    readonly maxOutputBytes: number;
+}): Promise<StagedOutput>;

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

@@ -0,0 +1,20 @@
+import type { ByteSource } from "./contracts.js";
+import type { RetainedXmlDocument, RetainedXmlNode } from "./retained-xml-document.js";
+import type { RetainedPackageContext } from "./retained-package.js";
+/** Owns backed group links, borrows the document until close. Only four corners
+ * and one transform are resident, regardless of group depth or identifier size. */
+export declare function openRetainedShapeGeometry(doc: RetainedXmlDocument, node: RetainedXmlNode, settings: RetainedPackageContext): Promise<{
+    value: null;
+    close: () => Promise<void>;
+} | {
+    value: {
+        coordinateSystem: string;
+        unit: string;
+        groupPath: AsyncGenerator<(() => ByteSource) | null, void, unknown>;
+        corners: {
+            x: number;
+            y: number;
+        }[];
+    };
+    close: () => Promise<void>;
+}>;