ppt-codec 1.5.0 → 1.7.0

package/dist/document/color-scheme.d.ts

@@ -4,5 +4,6 @@ import { RgbColor } from "../text/style.js";
 declare function readSlideSchemeColorSchemeAtom(record: PptRecord): readonly RgbColor[];
 /** Resolves a scheme-slot index (0-7, see text/style.ts's own ColorIndexStruct table) against a resolved 8-entry colour scheme. Throws rather than returning undefined for an out-of-range index: readColorIndexStruct already rejects any index outside 0x00-0x07/0xFE/0xFF at parse time, so a RunColor of kind "scheme" reaching this function always carries a genuinely valid slot. */
 declare function resolveSchemeColor(schemeIndex: number, colorScheme: readonly RgbColor[]): RgbColor;
+declare function findSlideSchemeColorSchemeAtom(records: readonly PptRecord[]): PptRecord | undefined;
 //#endregion
-export { readSlideSchemeColorSchemeAtom, resolveSchemeColor };
+export { findSlideSchemeColorSchemeAtom, readSlideSchemeColorSchemeAtom, resolveSchemeColor };

package/dist/document/color-scheme.js

@@ -31,5 +31,8 @@ function resolveSchemeColor(schemeIndex, colorScheme) {
 	if (color === void 0) throw new PptFormatError(`colour scheme slot ${schemeIndex} has no entry in a ${colorScheme.length}-entry colour scheme`);
 	return color;
 }
+function findSlideSchemeColorSchemeAtom(records) {
+	return records.find((record) => record.header.recType === 2032 && record.header.recInstance === SLIDE_SCHEME_REC_INSTANCE);
+}
 //#endregion
-export { readSlideSchemeColorSchemeAtom, resolveSchemeColor };
+export { findSlideSchemeColorSchemeAtom, readSlideSchemeColorSchemeAtom, resolveSchemeColor };

package/dist/document/master-write.cjs

@@ -3,8 +3,8 @@ const require_record_types = require("../record/types.cjs");
 require("../text/atoms.cjs");
 const require_record_write = require("../record/write.cjs");
 const require_document_color_scheme_write = require("./color-scheme-write.cjs");
-const require_drawing_shapes_write = require("../drawing/shapes-write.cjs");
 const require_read = require("../read.cjs");
+const require_drawing_shapes_write = require("../drawing/shapes-write.cjs");
 //#region src/document/master-write.ts
 const SL_TITLE_BODY = 1;
 const SL_BLANK = 16;
@@ -86,7 +86,7 @@ function writeSlideAtomForSlide(notesIdRef) {
 function writeTextMasterStyleAtom(textType) {
 	return require_record_write.writeAtom(require_record_types.RT_TextMasterStyleAtom, require_record_write.u16le(0), { recInstance: textType });
 }
-function writeMainMaster(size, fontIndexOf) {
+function writeMainMaster(size, context) {
 	const placeholders = MASTER_PLACEHOLDER_TYPES.map((placementId, index) => {
 		const frame = placeholderFrames(size)[index];
 		if (frame === void 0) throw new Error("internal error: the main master states more placeholder types than it has rectangles for");
@@ -102,20 +102,25 @@ function writeMainMaster(size, fontIndexOf) {
 			clientData: placeholderClientData(index, placementId)
 		};
 	});
-	return require_record_write.writeContainer(require_record_types.RT_MainMaster, [
-		writeSlideAtom({
-			geom: SL_TITLE_BODY,
-			placeholderTypes: MASTER_PLACEHOLDER_TYPES,
-			masterIdRef: 0,
-			notesIdRef: 0,
-			slideFlags: 0
-		}),
-		writeTextMasterStyleAtom(0),
-		writeTextMasterStyleAtom(1),
-		writeTextMasterStyleAtom(2),
-		require_drawing_shapes_write.writeDrawingWithClientData(placeholders, fontIndexOf),
-		require_document_color_scheme_write.writeSlideSchemeColorSchemeAtom()
-	]);
+	const drawing = require_drawing_shapes_write.writeSlideDrawing(placeholders, context);
+	return {
+		bytes: require_record_write.writeContainer(require_record_types.RT_MainMaster, [
+			writeSlideAtom({
+				geom: SL_TITLE_BODY,
+				placeholderTypes: MASTER_PLACEHOLDER_TYPES,
+				masterIdRef: 0,
+				notesIdRef: 0,
+				slideFlags: 0
+			}),
+			writeTextMasterStyleAtom(0),
+			writeTextMasterStyleAtom(1),
+			writeTextMasterStyleAtom(2),
+			drawing.bytes,
+			require_document_color_scheme_write.writeSlideSchemeColorSchemeAtom()
+		]),
+		shapeCount: drawing.shapeCount,
+		maxSpid: drawing.maxSpid
+	};
 }
 function writeMasterListWithText(persistIdRef) {
 	return require_record_write.writeContainer(require_record_types.RT_SlideListWithText, [require_record_write.writeAtom(require_record_types.RT_SlidePersistAtom, require_record_write.concatBytes(require_record_write.u32le(persistIdRef), require_record_write.u32le(0), require_record_write.i32le(0), require_record_write.u32le(MASTER_SLIDE_ID), require_record_write.u32le(0)))], { recInstance: 1 });

package/dist/document/master-write.d.cts

@@ -1,3 +1,4 @@
+import { DrawingWriteContext, DrawingWritten } from "../drawing/shapes-write.cjs";
 import { PageSize } from "document-schema.js";
 //#region src/document/master-write.d.ts
 declare const MASTER_SLIDE_ID = 2147483648;
@@ -9,7 +10,7 @@ declare function writeSlideAtom(options: {
   readonly slideFlags: number;
 }): Uint8Array<ArrayBuffer>;
 declare function writeSlideAtomForSlide(notesIdRef: number): Uint8Array<ArrayBuffer>;
-declare function writeMainMaster(size: PageSize, fontIndexOf: (family: string) => number): Uint8Array<ArrayBuffer>;
+declare function writeMainMaster(size: PageSize, context: DrawingWriteContext): DrawingWritten;
 declare function writeMasterListWithText(persistIdRef: number): Uint8Array<ArrayBuffer>;
 //#endregion
 export { MASTER_SLIDE_ID, writeMainMaster, writeMasterListWithText, writeSlideAtom, writeSlideAtomForSlide };

package/dist/document/master-write.d.ts

@@ -1,3 +1,4 @@
+import { DrawingWriteContext, DrawingWritten } from "../drawing/shapes-write.js";
 import { PageSize } from "document-schema.js";
 //#region src/document/master-write.d.ts
 declare const MASTER_SLIDE_ID = 2147483648;
@@ -9,7 +10,7 @@ declare function writeSlideAtom(options: {
   readonly slideFlags: number;
 }): Uint8Array<ArrayBuffer>;
 declare function writeSlideAtomForSlide(notesIdRef: number): Uint8Array<ArrayBuffer>;
-declare function writeMainMaster(size: PageSize, fontIndexOf: (family: string) => number): Uint8Array<ArrayBuffer>;
+declare function writeMainMaster(size: PageSize, context: DrawingWriteContext): DrawingWritten;
 declare function writeMasterListWithText(persistIdRef: number): Uint8Array<ArrayBuffer>;
 //#endregion
 export { MASTER_SLIDE_ID, writeMainMaster, writeMasterListWithText, writeSlideAtom, writeSlideAtomForSlide };

package/dist/document/master-write.js

@@ -2,8 +2,8 @@ import { OfficeArtClientData, RT_MainMaster, RT_PlaceholderAtom, RT_SlideAtom, R
 import "../text/atoms.js";
 import { concatBytes, i32le, u16le, u32le, u8, writeAtom, writeContainer } from "../record/write.js";
 import { writeSlideSchemeColorSchemeAtom } from "./color-scheme-write.js";
-import { writeDrawingWithClientData } from "../drawing/shapes-write.js";
 import { DEFAULT_INSET_LEFT_RIGHT_PT, DEFAULT_INSET_TOP_BOTTOM_PT } from "../read.js";
+import { writeSlideDrawing } from "../drawing/shapes-write.js";
 //#region src/document/master-write.ts
 const SL_TITLE_BODY = 1;
 const SL_BLANK = 16;
@@ -85,7 +85,7 @@ function writeSlideAtomForSlide(notesIdRef) {
 function writeTextMasterStyleAtom(textType) {
 	return writeAtom(RT_TextMasterStyleAtom, u16le(0), { recInstance: textType });
 }
-function writeMainMaster(size, fontIndexOf) {
+function writeMainMaster(size, context) {
 	const placeholders = MASTER_PLACEHOLDER_TYPES.map((placementId, index) => {
 		const frame = placeholderFrames(size)[index];
 		if (frame === void 0) throw new Error("internal error: the main master states more placeholder types than it has rectangles for");
@@ -101,20 +101,25 @@ function writeMainMaster(size, fontIndexOf) {
 			clientData: placeholderClientData(index, placementId)
 		};
 	});
-	return writeContainer(RT_MainMaster, [
-		writeSlideAtom({
-			geom: SL_TITLE_BODY,
-			placeholderTypes: MASTER_PLACEHOLDER_TYPES,
-			masterIdRef: 0,
-			notesIdRef: 0,
-			slideFlags: 0
-		}),
-		writeTextMasterStyleAtom(0),
-		writeTextMasterStyleAtom(1),
-		writeTextMasterStyleAtom(2),
-		writeDrawingWithClientData(placeholders, fontIndexOf),
-		writeSlideSchemeColorSchemeAtom()
-	]);
+	const drawing = writeSlideDrawing(placeholders, context);
+	return {
+		bytes: writeContainer(RT_MainMaster, [
+			writeSlideAtom({
+				geom: SL_TITLE_BODY,
+				placeholderTypes: MASTER_PLACEHOLDER_TYPES,
+				masterIdRef: 0,
+				notesIdRef: 0,
+				slideFlags: 0
+			}),
+			writeTextMasterStyleAtom(0),
+			writeTextMasterStyleAtom(1),
+			writeTextMasterStyleAtom(2),
+			drawing.bytes,
+			writeSlideSchemeColorSchemeAtom()
+		]),
+		shapeCount: drawing.shapeCount,
+		maxSpid: drawing.maxSpid
+	};
 }
 function writeMasterListWithText(persistIdRef) {
 	return writeContainer(RT_SlideListWithText, [writeAtom(RT_SlidePersistAtom, concatBytes(u32le(persistIdRef), u32le(0), i32le(0), u32le(MASTER_SLIDE_ID), u32le(0)))], { recInstance: 1 });

package/dist/document/notes-write.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_record_types = require("../record/types.cjs");
 const require_record_write = require("../record/write.cjs");
 const require_document_color_scheme_write = require("./color-scheme-write.cjs");
-const require_drawing_shapes_write = require("../drawing/shapes-write.cjs");
 const require_read = require("../read.cjs");
+const require_drawing_shapes_write = require("../drawing/shapes-write.cjs");
 //#region src/document/notes-write.ts
 const NOTES_BODY_TOP_FRACTION = .5;
 const NOTES_BODY_MARGIN_FRACTION = .05;
@@ -31,12 +31,20 @@ function notesBodyShape(notes, notesPageSize) {
 function writeNotesAtom(slideIdRef) {
 	return require_record_write.writeAtom(require_record_types.RT_NotesAtom, require_record_write.concatBytes(require_record_write.u32le(slideIdRef), require_record_write.u16le(0), require_record_write.u16le(0)), { recVer: 1 });
 }
-function writeNotesContainer(slideIdRef, notes, notesPageSize, fontIndexOf) {
-	return require_record_write.writeContainer(require_record_types.RT_Notes, [
-		writeNotesAtom(slideIdRef),
-		require_drawing_shapes_write.writeSlideDrawing([notesBodyShape(notes, notesPageSize)], fontIndexOf),
-		require_document_color_scheme_write.writeSlideSchemeColorSchemeAtom()
-	]);
+function writeNotesContainer(slideIdRef, notes, notesPageSize, context) {
+	const drawing = require_drawing_shapes_write.writeSlideDrawing([{
+		shape: notesBodyShape(notes, notesPageSize),
+		clientData: void 0
+	}], context);
+	return {
+		bytes: require_record_write.writeContainer(require_record_types.RT_Notes, [
+			writeNotesAtom(slideIdRef),
+			drawing.bytes,
+			require_document_color_scheme_write.writeSlideSchemeColorSchemeAtom()
+		]),
+		shapeCount: drawing.shapeCount,
+		maxSpid: drawing.maxSpid
+	};
 }
 //#endregion
 exports.writeNotesAtom = writeNotesAtom;

package/dist/document/notes-write.d.cts

@@ -1,6 +1,7 @@
+import { DrawingWriteContext, DrawingWritten } from "../drawing/shapes-write.cjs";
 import { PageSize } from "document-schema.js";
 //#region src/document/notes-write.d.ts
 declare function writeNotesAtom(slideIdRef: number): Uint8Array<ArrayBuffer>;
-declare function writeNotesContainer(slideIdRef: number, notes: string, notesPageSize: PageSize, fontIndexOf: (family: string) => number): Uint8Array<ArrayBuffer>;
+declare function writeNotesContainer(slideIdRef: number, notes: string, notesPageSize: PageSize, context: DrawingWriteContext): DrawingWritten;
 //#endregion
 export { writeNotesAtom, writeNotesContainer };

package/dist/document/notes-write.d.ts

@@ -1,6 +1,7 @@
+import { DrawingWriteContext, DrawingWritten } from "../drawing/shapes-write.js";
 import { PageSize } from "document-schema.js";
 //#region src/document/notes-write.d.ts
 declare function writeNotesAtom(slideIdRef: number): Uint8Array<ArrayBuffer>;
-declare function writeNotesContainer(slideIdRef: number, notes: string, notesPageSize: PageSize, fontIndexOf: (family: string) => number): Uint8Array<ArrayBuffer>;
+declare function writeNotesContainer(slideIdRef: number, notes: string, notesPageSize: PageSize, context: DrawingWriteContext): DrawingWritten;
 //#endregion
 export { writeNotesAtom, writeNotesContainer };

package/dist/document/notes-write.js

@@ -1,8 +1,8 @@
 import { RT_Notes, RT_NotesAtom } from "../record/types.js";
 import { concatBytes, u16le, u32le, writeAtom, writeContainer } from "../record/write.js";
 import { writeSlideSchemeColorSchemeAtom } from "./color-scheme-write.js";
-import { writeSlideDrawing } from "../drawing/shapes-write.js";
 import { DEFAULT_INSET_LEFT_RIGHT_PT, DEFAULT_INSET_TOP_BOTTOM_PT } from "../read.js";
+import { writeSlideDrawing } from "../drawing/shapes-write.js";
 //#region src/document/notes-write.ts
 const NOTES_BODY_TOP_FRACTION = .5;
 const NOTES_BODY_MARGIN_FRACTION = .05;
@@ -30,12 +30,20 @@ function notesBodyShape(notes, notesPageSize) {
 function writeNotesAtom(slideIdRef) {
 	return writeAtom(RT_NotesAtom, concatBytes(u32le(slideIdRef), u16le(0), u16le(0)), { recVer: 1 });
 }
-function writeNotesContainer(slideIdRef, notes, notesPageSize, fontIndexOf) {
-	return writeContainer(RT_Notes, [
-		writeNotesAtom(slideIdRef),
-		writeSlideDrawing([notesBodyShape(notes, notesPageSize)], fontIndexOf),
-		writeSlideSchemeColorSchemeAtom()
-	]);
+function writeNotesContainer(slideIdRef, notes, notesPageSize, context) {
+	const drawing = writeSlideDrawing([{
+		shape: notesBodyShape(notes, notesPageSize),
+		clientData: void 0
+	}], context);
+	return {
+		bytes: writeContainer(RT_Notes, [
+			writeNotesAtom(slideIdRef),
+			drawing.bytes,
+			writeSlideSchemeColorSchemeAtom()
+		]),
+		shapeCount: drawing.shapeCount,
+		maxSpid: drawing.maxSpid
+	};
 }
 //#endregion
 export { writeNotesAtom, writeNotesContainer };

package/dist/document/notes.cjs

@@ -26,9 +26,10 @@ function readNotesText(notesContainer) {
 	const drawing = require_record_tree.findChild(require_record_tree.childRecords(notesContainer), require_record_types.RT_Drawing);
 	if (drawing === void 0) return "";
 	const bodies = [];
-	for (const shape of require_drawing_shapes.readDrawingShapes(drawing)) {
-		if (shape.clientTextbox === void 0) continue;
-		const text = require_text_atoms.readTextBody(require_record_tree.childRecords(shape.clientTextbox));
+	for (const entry of require_drawing_shapes.readDrawingShapes(drawing)) {
+		if (!("clientTextbox" in entry)) continue;
+		if (entry.clientTextbox === void 0) continue;
+		const text = require_text_atoms.readTextBody(require_record_tree.childRecords(entry.clientTextbox));
 		if (text === void 0 || text.length === 0) continue;
 		bodies.push(require_text_atoms.splitParagraphs(text).map((paragraph) => paragraph.text).join("\n"));
 	}

package/dist/document/notes.js

@@ -25,9 +25,10 @@ function readNotesText(notesContainer) {
 	const drawing = findChild(childRecords(notesContainer), RT_Drawing);
 	if (drawing === void 0) return "";
 	const bodies = [];
-	for (const shape of readDrawingShapes(drawing)) {
-		if (shape.clientTextbox === void 0) continue;
-		const text = readTextBody(childRecords(shape.clientTextbox));
+	for (const entry of readDrawingShapes(drawing)) {
+		if (!("clientTextbox" in entry)) continue;
+		if (entry.clientTextbox === void 0) continue;
+		const text = readTextBody(childRecords(entry.clientTextbox));
 		if (text === void 0 || text.length === 0) continue;
 		bodies.push(splitParagraphs(text).map((paragraph) => paragraph.text).join("\n"));
 	}

package/dist/drawing/blips.cjs

@@ -0,0 +1,81 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+const require_record_tree = require("../record/tree.cjs");
+const require_record_types = require("../record/types.cjs");
+const require_record_write = require("../record/write.cjs");
+//#region src/drawing/blips.ts
+const MSOBLIP_JPEG = 5;
+const MSOBLIP_PNG = 6;
+function isBlipFormat(format) {
+	return format === "png" || format === "jpeg";
+}
+function blipPayload(record) {
+	const format = record.header.recType === 61470 ? "png" : record.header.recType === 61469 ? "jpeg" : void 0;
+	if (format === void 0) return;
+	const uidCount = (record.header.recInstance & 1) + 1;
+	const dataStart = uidCount * 16 + 1;
+	if (record.data.length < dataStart) throw new require_errors.PptFormatError(`a blip record of type 0x${record.header.recType.toString(16)} declares ${record.header.recInstance.toString(16)} as its instance (so ${uidCount} digest(s)) but carries only ${record.data.length} bytes`);
+	return {
+		format,
+		bytes: record.data.subarray(dataStart)
+	};
+}
+const FBSE_FIXED_SIZE = 36;
+const FO_DELAY_NONE = 4294967295;
+function readStoreEntry(entry, picturesStream) {
+	if (entry.header.recType !== 61447) return blipPayload(entry);
+	const view = new DataView(entry.data.buffer, entry.data.byteOffset, entry.data.byteLength);
+	const cRef = view.getUint32(24, true);
+	const foDelay = view.getUint32(28, true);
+	const cbName = view.getUint8(35);
+	const embeddedAt = entry.dataOffset + FBSE_FIXED_SIZE + cbName;
+	if (embeddedAt < entry.dataOffset + entry.header.recLen) return blipPayload(require_record_tree.readRecordAt(entry.stream, embeddedAt));
+	if (cRef === 0 || foDelay === FO_DELAY_NONE) return;
+	if (picturesStream === void 0) return;
+	return blipPayload(require_record_tree.readRecordAt(picturesStream, foDelay));
+}
+function readBlipStore(documentContainer, picturesStream) {
+	const drawingGroup = require_record_tree.findChild(require_record_tree.childRecords(documentContainer), require_record_types.RT_DrawingGroup);
+	if (drawingGroup === void 0) return [];
+	const dgg = require_record_tree.findChild(require_record_tree.childRecords(drawingGroup), require_record_types.OfficeArtDggContainer);
+	if (dgg === void 0) return [];
+	const bStore = require_record_tree.findChild(require_record_tree.childRecords(dgg), require_record_types.OfficeArtBStoreContainer);
+	if (bStore === void 0) return [];
+	const blips = [];
+	for (const entry of require_record_tree.childRecords(bStore)) {
+		const blip = readStoreEntry(entry, picturesStream);
+		if (blip !== void 0) blips.push(blip);
+	}
+	return blips;
+}
+function blipForPib(blips, pib) {
+	if (pib <= 0) return;
+	return blips[pib - 1];
+}
+const ZERO_DIGEST = /* @__PURE__ */ new Uint8Array(16);
+const TAG_EXTERNAL = 255;
+function writeBlipRecord(blip) {
+	const recType = blip.format === "png" ? require_record_types.OfficeArtBlipPNG : require_record_types.OfficeArtBlipJPEG;
+	const recInstance = blip.format === "png" ? 1760 : 1130;
+	return require_record_write.writeAtom(recType, require_record_write.concatBytes(ZERO_DIGEST, require_record_write.u8(TAG_EXTERNAL), blip.bytes), { recInstance });
+}
+function writeFbse(blip) {
+	const embedded = writeBlipRecord(blip);
+	const blipType = blip.format === "png" ? MSOBLIP_PNG : MSOBLIP_JPEG;
+	return require_record_write.writeAtom(require_record_types.OfficeArtFBSE, require_record_write.concatBytes(require_record_write.u8(blipType), require_record_write.u8(blipType), ZERO_DIGEST, require_record_write.u16le(TAG_EXTERNAL), require_record_write.u32le(embedded.length), require_record_write.u32le(1), require_record_write.u32le(0), require_record_write.u8(0), require_record_write.u8(0), require_record_write.u8(0), require_record_write.u8(0), embedded), {
+		recVer: 2,
+		recInstance: blipType
+	});
+}
+function writeDrawingGroupContainer(blips, counts) {
+	const fdgg = require_record_write.concatBytes(require_record_write.u32le(counts.spidMax), require_record_write.u32le(2), require_record_write.u32le(counts.shapeCount), require_record_write.u32le(counts.drawingCount));
+	const idcl = require_record_write.concatBytes(require_record_write.u32le(1), require_record_write.u32le(counts.spidMax));
+	const dggChildren = [require_record_write.writeAtom(require_record_types.OfficeArtFDGGBlock, require_record_write.concatBytes(fdgg, idcl))];
+	if (blips.length > 0) dggChildren.push(require_record_write.writeContainer(require_record_types.OfficeArtBStoreContainer, blips.map(writeFbse), { recInstance: blips.length }));
+	return require_record_write.writeContainer(require_record_types.RT_DrawingGroup, [require_record_write.writeContainer(require_record_types.OfficeArtDggContainer, dggChildren)]);
+}
+//#endregion
+exports.blipForPib = blipForPib;
+exports.isBlipFormat = isBlipFormat;
+exports.readBlipStore = readBlipStore;
+exports.writeDrawingGroupContainer = writeDrawingGroupContainer;

package/dist/drawing/blips.d.cts

@@ -0,0 +1,16 @@
+import { t as PptRecord } from "../tree-Du_LXAF0.cjs";
+//#region src/drawing/blips.d.ts
+interface PptBlip {
+  readonly format: "png" | "jpeg";
+  readonly bytes: Uint8Array<ArrayBuffer>;
+}
+declare function isBlipFormat(format: string): format is "png" | "jpeg";
+declare function readBlipStore(documentContainer: PptRecord, picturesStream: Uint8Array<ArrayBuffer> | undefined): readonly PptBlip[];
+declare function blipForPib(blips: readonly PptBlip[], pib: number): PptBlip | undefined;
+declare function writeDrawingGroupContainer(blips: readonly PptBlip[], counts: {
+  readonly spidMax: number;
+  readonly shapeCount: number;
+  readonly drawingCount: number;
+}): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PptBlip, blipForPib, isBlipFormat, readBlipStore, writeDrawingGroupContainer };

package/dist/drawing/blips.d.ts

@@ -0,0 +1,16 @@
+import { t as PptRecord } from "../tree-PMcPNgd-.js";
+//#region src/drawing/blips.d.ts
+interface PptBlip {
+  readonly format: "png" | "jpeg";
+  readonly bytes: Uint8Array<ArrayBuffer>;
+}
+declare function isBlipFormat(format: string): format is "png" | "jpeg";
+declare function readBlipStore(documentContainer: PptRecord, picturesStream: Uint8Array<ArrayBuffer> | undefined): readonly PptBlip[];
+declare function blipForPib(blips: readonly PptBlip[], pib: number): PptBlip | undefined;
+declare function writeDrawingGroupContainer(blips: readonly PptBlip[], counts: {
+  readonly spidMax: number;
+  readonly shapeCount: number;
+  readonly drawingCount: number;
+}): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PptBlip, blipForPib, isBlipFormat, readBlipStore, writeDrawingGroupContainer };

package/dist/drawing/blips.js

@@ -0,0 +1,77 @@
+import { PptFormatError } from "../errors.js";
+import { childRecords, findChild, readRecordAt } from "../record/tree.js";
+import { OfficeArtBStoreContainer, OfficeArtBlipJPEG, OfficeArtBlipPNG, OfficeArtDggContainer, OfficeArtFBSE, OfficeArtFDGGBlock, RT_DrawingGroup } from "../record/types.js";
+import { concatBytes, u16le, u32le, u8, writeAtom, writeContainer } from "../record/write.js";
+//#region src/drawing/blips.ts
+const MSOBLIP_JPEG = 5;
+const MSOBLIP_PNG = 6;
+function isBlipFormat(format) {
+	return format === "png" || format === "jpeg";
+}
+function blipPayload(record) {
+	const format = record.header.recType === 61470 ? "png" : record.header.recType === 61469 ? "jpeg" : void 0;
+	if (format === void 0) return;
+	const uidCount = (record.header.recInstance & 1) + 1;
+	const dataStart = uidCount * 16 + 1;
+	if (record.data.length < dataStart) throw new PptFormatError(`a blip record of type 0x${record.header.recType.toString(16)} declares ${record.header.recInstance.toString(16)} as its instance (so ${uidCount} digest(s)) but carries only ${record.data.length} bytes`);
+	return {
+		format,
+		bytes: record.data.subarray(dataStart)
+	};
+}
+const FBSE_FIXED_SIZE = 36;
+const FO_DELAY_NONE = 4294967295;
+function readStoreEntry(entry, picturesStream) {
+	if (entry.header.recType !== 61447) return blipPayload(entry);
+	const view = new DataView(entry.data.buffer, entry.data.byteOffset, entry.data.byteLength);
+	const cRef = view.getUint32(24, true);
+	const foDelay = view.getUint32(28, true);
+	const cbName = view.getUint8(35);
+	const embeddedAt = entry.dataOffset + FBSE_FIXED_SIZE + cbName;
+	if (embeddedAt < entry.dataOffset + entry.header.recLen) return blipPayload(readRecordAt(entry.stream, embeddedAt));
+	if (cRef === 0 || foDelay === FO_DELAY_NONE) return;
+	if (picturesStream === void 0) return;
+	return blipPayload(readRecordAt(picturesStream, foDelay));
+}
+function readBlipStore(documentContainer, picturesStream) {
+	const drawingGroup = findChild(childRecords(documentContainer), RT_DrawingGroup);
+	if (drawingGroup === void 0) return [];
+	const dgg = findChild(childRecords(drawingGroup), OfficeArtDggContainer);
+	if (dgg === void 0) return [];
+	const bStore = findChild(childRecords(dgg), OfficeArtBStoreContainer);
+	if (bStore === void 0) return [];
+	const blips = [];
+	for (const entry of childRecords(bStore)) {
+		const blip = readStoreEntry(entry, picturesStream);
+		if (blip !== void 0) blips.push(blip);
+	}
+	return blips;
+}
+function blipForPib(blips, pib) {
+	if (pib <= 0) return;
+	return blips[pib - 1];
+}
+const ZERO_DIGEST = /* @__PURE__ */ new Uint8Array(16);
+const TAG_EXTERNAL = 255;
+function writeBlipRecord(blip) {
+	const recType = blip.format === "png" ? OfficeArtBlipPNG : OfficeArtBlipJPEG;
+	const recInstance = blip.format === "png" ? 1760 : 1130;
+	return writeAtom(recType, concatBytes(ZERO_DIGEST, u8(TAG_EXTERNAL), blip.bytes), { recInstance });
+}
+function writeFbse(blip) {
+	const embedded = writeBlipRecord(blip);
+	const blipType = blip.format === "png" ? MSOBLIP_PNG : MSOBLIP_JPEG;
+	return writeAtom(OfficeArtFBSE, concatBytes(u8(blipType), u8(blipType), ZERO_DIGEST, u16le(TAG_EXTERNAL), u32le(embedded.length), u32le(1), u32le(0), u8(0), u8(0), u8(0), u8(0), embedded), {
+		recVer: 2,
+		recInstance: blipType
+	});
+}
+function writeDrawingGroupContainer(blips, counts) {
+	const fdgg = concatBytes(u32le(counts.spidMax), u32le(2), u32le(counts.shapeCount), u32le(counts.drawingCount));
+	const idcl = concatBytes(u32le(1), u32le(counts.spidMax));
+	const dggChildren = [writeAtom(OfficeArtFDGGBlock, concatBytes(fdgg, idcl))];
+	if (blips.length > 0) dggChildren.push(writeContainer(OfficeArtBStoreContainer, blips.map(writeFbse), { recInstance: blips.length }));
+	return writeContainer(RT_DrawingGroup, [writeContainer(OfficeArtDggContainer, dggChildren)]);
+}
+//#endregion
+export { blipForPib, isBlipFormat, readBlipStore, writeDrawingGroupContainer };

package/dist/drawing/properties.cjs

@@ -0,0 +1,102 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+const require_record_tree = require("../record/tree.cjs");
+require("../record/types.cjs");
+const require_record_write = require("../record/write.cjs");
+//#region src/drawing/properties.ts
+const OPID_MASK = 16383;
+const OPID_FCOMPLEX = 16384;
+const OPID_FBID = 32768;
+const PROPERTY_ROTATION = 4;
+const PROPERTY_PIB = 260;
+const PROPERTY_TABLE_PROPERTIES = 927;
+const PROPERTY_TABLE_ROW_PROPERTIES = 928;
+const PROPERTY_DX_TEXT_LEFT = 129;
+const PROPERTY_DY_TEXT_TOP = 130;
+const PROPERTY_DX_TEXT_RIGHT = 131;
+const PROPERTY_DY_TEXT_BOTTOM = 132;
+const FIXED_POINT_ONE = 65536;
+function degreesToFixedPoint(degrees) {
+	return Math.round(degrees * FIXED_POINT_ONE);
+}
+function fixedPointToDegrees(raw) {
+	return raw / FIXED_POINT_ONE;
+}
+const TABLE_FLAG_IS_TABLE = 1;
+function readIMsoArray(complex) {
+	if (complex.length < 6) throw new require_errors.PptFormatError(`a complex property's IMsoArray carries ${complex.length} bytes, fewer than the 6 its three count fields need`);
+	const view = new DataView(complex.buffer, complex.byteOffset, complex.byteLength);
+	const elementCount = view.getUint16(0, true);
+	const elementSize = view.getUint16(4, true);
+	const data = complex.subarray(6);
+	if (data.length < elementCount * elementSize) throw new require_errors.PptFormatError(`a complex property's IMsoArray declares ${elementCount} elements of ${elementSize} bytes but only ${data.length} remain`);
+	const elements = [];
+	for (let index = 0; index < elementCount; index += 1) elements.push(view.getInt32(6 + index * elementSize, true));
+	return elements;
+}
+function writeIMsoArray(elements, elementSize) {
+	const data = new Uint8Array(elements.length * elementSize);
+	const view = new DataView(data.buffer);
+	elements.forEach((element, index) => {
+		view.setInt32(index * elementSize, element, true);
+	});
+	return require_record_write.concatBytes(require_record_write.u16le(elements.length), require_record_write.u16le(elements.length), require_record_write.u16le(elementSize), data);
+}
+function readShapeProperties(shape) {
+	const properties = /* @__PURE__ */ new Map();
+	for (const record of require_record_tree.childRecords(shape)) {
+		if (record.header.recType !== 61451 && record.header.recType !== 61729 && record.header.recType !== 61730) continue;
+		const count = record.header.recInstance;
+		const needed = count * 6;
+		if (record.data.length < needed) throw new require_errors.PptFormatError(`a shape property table declares ${count} properties but its ${record.data.length} bytes of data cannot hold the ${needed} its entries need`);
+		const view = new DataView(record.data.buffer, record.data.byteOffset, record.data.byteLength);
+		let complexAt = needed;
+		for (let index = 0; index < count; index += 1) {
+			const at = index * 6;
+			const opid = view.getUint16(at, true);
+			const value = view.getInt32(at + 2, true);
+			const isComplex = (opid & OPID_FCOMPLEX) !== 0;
+			let complex;
+			if (isComplex) {
+				complex = record.data.subarray(complexAt, complexAt + value);
+				complexAt += value;
+				if (complexAt > record.data.length) throw new require_errors.PptFormatError(`a shape property table's complex data declares ${complexAt} bytes in total but the table carries only ${record.data.length}`);
+			}
+			properties.set(opid & OPID_MASK, {
+				value,
+				complex
+			});
+		}
+	}
+	return properties;
+}
+function writeShapePropertyTable(recType, entries) {
+	const ordered = [...entries].sort((a, b) => a.opid - b.opid);
+	const complexParts = [];
+	const entryParts = ordered.map((entry) => {
+		const isComplex = entry.complex !== void 0;
+		const opidWord = entry.opid | (isComplex ? OPID_FCOMPLEX : 0) | (entry.fBid === true ? OPID_FBID : 0);
+		if (isComplex) complexParts.push(entry.complex);
+		return require_record_write.concatBytes(require_record_write.u16le(opidWord), require_record_write.u32le(entry.op));
+	});
+	return require_record_write.writeAtom(recType, require_record_write.concatBytes(...entryParts, ...complexParts), {
+		recVer: 3,
+		recInstance: ordered.length
+	});
+}
+//#endregion
+exports.PROPERTY_DX_TEXT_LEFT = PROPERTY_DX_TEXT_LEFT;
+exports.PROPERTY_DX_TEXT_RIGHT = PROPERTY_DX_TEXT_RIGHT;
+exports.PROPERTY_DY_TEXT_BOTTOM = PROPERTY_DY_TEXT_BOTTOM;
+exports.PROPERTY_DY_TEXT_TOP = PROPERTY_DY_TEXT_TOP;
+exports.PROPERTY_PIB = PROPERTY_PIB;
+exports.PROPERTY_ROTATION = PROPERTY_ROTATION;
+exports.PROPERTY_TABLE_PROPERTIES = PROPERTY_TABLE_PROPERTIES;
+exports.PROPERTY_TABLE_ROW_PROPERTIES = PROPERTY_TABLE_ROW_PROPERTIES;
+exports.TABLE_FLAG_IS_TABLE = TABLE_FLAG_IS_TABLE;
+exports.degreesToFixedPoint = degreesToFixedPoint;
+exports.fixedPointToDegrees = fixedPointToDegrees;
+exports.readIMsoArray = readIMsoArray;
+exports.readShapeProperties = readShapeProperties;
+exports.writeIMsoArray = writeIMsoArray;
+exports.writeShapePropertyTable = writeShapePropertyTable;

package/dist/drawing/properties.d.cts

@@ -0,0 +1,29 @@
+import { t as PptRecord } from "../tree-Du_LXAF0.cjs";
+//#region src/drawing/properties.d.ts
+declare const PROPERTY_ROTATION = 4;
+declare const PROPERTY_PIB = 260;
+declare const PROPERTY_TABLE_PROPERTIES = 927;
+declare const PROPERTY_TABLE_ROW_PROPERTIES = 928;
+declare const PROPERTY_DX_TEXT_LEFT = 129;
+declare const PROPERTY_DY_TEXT_TOP = 130;
+declare const PROPERTY_DX_TEXT_RIGHT = 131;
+declare const PROPERTY_DY_TEXT_BOTTOM = 132;
+declare function degreesToFixedPoint(degrees: number): number;
+declare function fixedPointToDegrees(raw: number): number;
+declare const TABLE_FLAG_IS_TABLE: number;
+declare function readIMsoArray(complex: Uint8Array<ArrayBuffer>): readonly number[];
+declare function writeIMsoArray(elements: readonly number[], elementSize: number): Uint8Array<ArrayBuffer>;
+interface ShapeProperty {
+  readonly value: number;
+  readonly complex: Uint8Array<ArrayBuffer> | undefined;
+}
+declare function readShapeProperties(shape: PptRecord): Map<number, ShapeProperty>;
+interface WritableShapeProperty {
+  readonly opid: number;
+  readonly op: number;
+  readonly fBid?: boolean;
+  readonly complex?: Uint8Array<ArrayBuffer>;
+}
+declare function writeShapePropertyTable(recType: number, entries: readonly WritableShapeProperty[]): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PROPERTY_DX_TEXT_LEFT, PROPERTY_DX_TEXT_RIGHT, PROPERTY_DY_TEXT_BOTTOM, PROPERTY_DY_TEXT_TOP, PROPERTY_PIB, PROPERTY_ROTATION, PROPERTY_TABLE_PROPERTIES, PROPERTY_TABLE_ROW_PROPERTIES, ShapeProperty, TABLE_FLAG_IS_TABLE, WritableShapeProperty, degreesToFixedPoint, fixedPointToDegrees, readIMsoArray, readShapeProperties, writeIMsoArray, writeShapePropertyTable };