ppt-codec 1.6.0 → 1.7.0

package/dist/ole/embedded.js

@@ -0,0 +1,63 @@
+import { PptFormatError } from "../errors.js";
+import { childRecords, findChild, readRecordAt } from "../record/tree.js";
+import { RT_ExternalObjectList, RT_ExternalObjectRefAtom, RT_ExternalOleObjectAtom } from "../record/types.js";
+import { decodeUtf16Le } from "../stream/current-user.js";
+import { inflate } from "byte-codec";
+//#region src/ole/embedded.ts
+const EX_OLE_OBJ_ATOM_LEN = 24;
+function readExOleObjAtom(record) {
+	if (record.data.length < EX_OLE_OBJ_ATOM_LEN) throw new PptFormatError(`ExOleObjAtom at offset ${record.offset} carries ${record.data.length} bytes, fewer than the ${EX_OLE_OBJ_ATOM_LEN} its fields need`);
+	const view = new DataView(record.data.buffer, record.data.byteOffset, record.data.byteLength);
+	return {
+		exObjId: view.getUint32(8, true),
+		persistIdRef: view.getUint32(16, true)
+	};
+}
+const PROG_ID_ATOM_INSTANCE = 2;
+function readExOleEmbedContainer(container) {
+	const children = childRecords(container);
+	const objAtom = findChild(children, RT_ExternalOleObjectAtom);
+	if (objAtom === void 0) return;
+	const progIdAtom = children.find((child) => child.header.recType === 4026 && child.header.recInstance === PROG_ID_ATOM_INSTANCE);
+	return {
+		...readExOleObjAtom(objAtom),
+		progId: progIdAtom === void 0 ? void 0 : decodeUtf16Le(progIdAtom.data)
+	};
+}
+function readExternalOleEmbeds(documentChildren) {
+	const embeds = /* @__PURE__ */ new Map();
+	const objList = findChild(documentChildren, RT_ExternalObjectList);
+	if (objList === void 0) return embeds;
+	for (const child of childRecords(objList)) {
+		if (child.header.recType !== 4044) continue;
+		const embed = readExOleEmbedContainer(child);
+		if (embed !== void 0) embeds.set(embed.exObjId, embed);
+	}
+	return embeds;
+}
+function readExObjIdRef(clientData) {
+	const record = findChild(childRecords(clientData), RT_ExternalObjectRefAtom);
+	if (record === void 0 || record.data.length < 4) return;
+	return new DataView(record.data.buffer, record.data.byteOffset, record.data.byteLength).getUint32(0, true);
+}
+const EX_OLE_OBJ_STG_INSTANCE_COMPRESSED = 1;
+function resolveOleObjectStorage(streamBytes, directory, persistIdRef) {
+	const offset = directory.get(persistIdRef);
+	if (offset === void 0) return;
+	let record;
+	try {
+		record = readRecordAt(streamBytes, offset);
+	} catch {
+		return;
+	}
+	if (record.header.recType !== 4113) return;
+	if (record.header.recInstance !== EX_OLE_OBJ_STG_INSTANCE_COMPRESSED) return record.data;
+	if (record.data.length < 4) return;
+	try {
+		return inflate(record.data.subarray(4));
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { readExObjIdRef, readExternalOleEmbeds, resolveOleObjectStorage };

package/dist/read.cjs

@@ -19,6 +19,7 @@ const require_drawing_shapes = require("./drawing/shapes.cjs");
 const require_document_notes = require("./document/notes.cjs");
 const require_document_slide_list = require("./document/slide-list.cjs");
 const require_stream_current_user = require("./stream/current-user.cjs");
+const require_ole_embedded = require("./ole/embedded.cjs");
 const require_stream_persist = require("./stream/persist.cjs");
 let archive_codec = require("archive-codec");
 let document_schema_js = require("document-schema.js");
@@ -30,6 +31,20 @@ const PICTURES_STREAM = "Pictures";
 const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 const DEFAULT_INSET_LEFT_RIGHT_PT = 7.2;
 const DEFAULT_INSET_TOP_BOTTOM_PT = 3.6;
+function insetsForShape(properties, isPicture) {
+	const defaultLeftRight = isPicture ? 0 : DEFAULT_INSET_LEFT_RIGHT_PT;
+	const defaultTopBottom = isPicture ? 0 : DEFAULT_INSET_TOP_BOTTOM_PT;
+	const emuOrDefault = (opid, fallback) => {
+		const property = properties.get(opid);
+		return property === void 0 ? fallback : require_units.emuToPoints(property.value);
+	};
+	return {
+		insetLeftPt: emuOrDefault(129, defaultLeftRight),
+		insetTopPt: emuOrDefault(130, defaultTopBottom),
+		insetRightPt: emuOrDefault(131, defaultLeftRight),
+		insetBottomPt: emuOrDefault(132, defaultTopBottom)
+	};
+}
 const NO_STYLE = {
 	paragraphRuns: [],
 	characterRuns: []
@@ -80,6 +95,23 @@ function imageBlocksFor(pibProperty, context, widthPt, heightPt) {
 		heightPt
 	}];
 }
+function embeddedObjectBlocksFor(clientData, context, frame) {
+	if (clientData === void 0 || context.decodeEmbeddedObject === void 0) return [];
+	const exObjId = require_ole_embedded.readExObjIdRef(clientData);
+	if (exObjId === void 0) return [];
+	const embed = context.externalOleEmbeds.get(exObjId);
+	if (embed === void 0) return [];
+	const storageBytes = require_ole_embedded.resolveOleObjectStorage(context.streamBytes, context.directory, embed.persistIdRef);
+	if (storageBytes === void 0) return [];
+	const decoded = context.decodeEmbeddedObject(storageBytes, embed.progId);
+	if (decoded === void 0) return [];
+	return [{
+		kind: "embeddedObject",
+		objectKind: decoded.objectKind,
+		document: decoded.document,
+		frame
+	}];
+}
 function tableBlockFor(table, context) {
 	const placed = table.cells.flatMap((cell) => cell.anchor === void 0 || cell.anchor.right <= cell.anchor.left || cell.anchor.bottom <= cell.anchor.top ? [] : [{
 		cell,
@@ -194,11 +226,17 @@ function readSlide(base, size, notes, mastersById) {
 				heightPt
 			},
 			...shape.rotationDeg === void 0 ? {} : { rotationDeg: shape.rotationDeg },
-			insetLeftPt: isPicture ? 0 : DEFAULT_INSET_LEFT_RIGHT_PT,
-			insetTopPt: isPicture ? 0 : DEFAULT_INSET_TOP_BOTTOM_PT,
-			insetRightPt: isPicture ? 0 : DEFAULT_INSET_LEFT_RIGHT_PT,
-			insetBottomPt: isPicture ? 0 : DEFAULT_INSET_TOP_BOTTOM_PT,
-			blocks: [...imageBlocksFor(shape.properties.get(260), context, widthPt, heightPt), ...blocksFor(shape.clientTextbox, context)]
+			...insetsForShape(shape.properties, isPicture),
+			blocks: [
+				...imageBlocksFor(shape.properties.get(260), context, widthPt, heightPt),
+				...blocksFor(shape.clientTextbox, context),
+				...embeddedObjectBlocksFor(shape.clientData, context, {
+					xPt: left,
+					yPt: top,
+					widthPt,
+					heightPt
+				})
+			]
 		});
 	}
 	return {
@@ -207,7 +245,7 @@ function readSlide(base, size, notes, mastersById) {
 		notes
 	};
 }
-function readPptStreams(currentUserStream, powerPointDocumentStream, password, picturesStream) {
+function readPptStreams(currentUserStream, powerPointDocumentStream, password, picturesStream, options) {
 	const currentUser = require_stream_current_user.readCurrentUserAtom(currentUserStream);
 	const { directory, currentEdit } = require_stream_persist.buildPersistDirectory(powerPointDocumentStream, currentUser.offsetToCurrentEdit);
 	let streamBytes = powerPointDocumentStream;
@@ -236,6 +274,7 @@ function readPptStreams(currentUserStream, powerPointDocumentStream, password, p
 	const persists = slideList === void 0 ? [] : require_document_slide_list.readSlideListWithText(slideList);
 	const notesBySlideId = readNotesBySlideId(streamBytes, directory, listWithInstance(2));
 	const blips = require_drawing_blips.readBlipStore(documentContainer, currentUser.encrypted ? void 0 : picturesStream);
+	const externalOleEmbeds = require_ole_embedded.readExternalOleEmbeds(children);
 	return {
 		metadata: {},
 		slides: persists.map((persist) => readSlide({
@@ -243,14 +282,16 @@ function readPptStreams(currentUserStream, powerPointDocumentStream, password, p
 			directory,
 			persist,
 			fontNames,
-			blips
+			blips,
+			externalOleEmbeds,
+			decodeEmbeddedObject: options?.decodeEmbeddedObject
 		}, size, notesBySlideId.get(persist.slideId) ?? "", mastersById))
 	};
 }
-function readPptContent(bytes, password) {
+function readPptContent(bytes, password, options) {
 	const streams = (0, archive_codec.readCompoundFile)(bytes);
 	const pictures = streams.find((stream) => stream.path === PICTURES_STREAM);
-	const document = readPptStreams(requireStream(streams, CURRENT_USER_STREAM), requireStream(streams, POWERPOINT_DOCUMENT_STREAM), password, pictures === void 0 ? void 0 : pictures.bytes);
+	const document = readPptStreams(requireStream(streams, CURRENT_USER_STREAM), requireStream(streams, POWERPOINT_DOCUMENT_STREAM), password, pictures === void 0 ? void 0 : pictures.bytes, options);
 	const metadataStream = streams.find((stream) => stream.path === SUMMARY_INFORMATION_STREAM);
 	if (metadataStream === void 0) return document;
 	return {
@@ -258,8 +299,8 @@ function readPptContent(bytes, password) {
 		metadata: (0, archive_codec.summaryInformationToLayoutMetadata)((0, archive_codec.readSummaryInformation)(metadataStream.bytes))
 	};
 }
-function readPpt(bytes, password) {
-	const { metadata, slides } = readPptContent(bytes, password);
+function readPpt(bytes, password, options) {
+	const { metadata, slides } = readPptContent(bytes, password, options);
 	const document = {
 		kind: "presentation",
 		metadata,

package/dist/read.d.cts

@@ -1,4 +1,4 @@
-import { ContentSlide, DocumentTree, LayoutMetadata } from "document-schema.js";
+import { ContentDocument, ContentEmbeddedObjectKind, ContentSlide, DocumentTree, LayoutMetadata } from "document-schema.js";
 //#region src/read.d.ts
 declare const CURRENT_USER_STREAM = "Current User";
 declare const POWERPOINT_DOCUMENT_STREAM = "PowerPoint Document";
@@ -7,12 +7,19 @@ declare const PICTURES_STREAM = "Pictures";
 declare const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 declare const DEFAULT_INSET_LEFT_RIGHT_PT: number;
 declare const DEFAULT_INSET_TOP_BOTTOM_PT: number;
+type DecodeEmbeddedObjectPort = (storageBytes: Uint8Array<ArrayBuffer>, progId: string | undefined) => {
+  readonly objectKind: ContentEmbeddedObjectKind;
+  readonly document: ContentDocument;
+} | undefined;
+interface ReadPptOptions {
+  readonly decodeEmbeddedObject?: DecodeEmbeddedObjectPort;
+}
 interface PptDocument {
   readonly metadata: LayoutMetadata;
   readonly slides: readonly ContentSlide[];
 }
-declare function readPptStreams(currentUserStream: Uint8Array<ArrayBuffer>, powerPointDocumentStream: Uint8Array<ArrayBuffer>, password?: string, picturesStream?: Uint8Array<ArrayBuffer>): PptDocument;
-declare function readPptContent(bytes: Uint8Array<ArrayBuffer>, password?: string): PptDocument;
-declare function readPpt(bytes: Uint8Array<ArrayBuffer>, password?: string): DocumentTree;
+declare function readPptStreams(currentUserStream: Uint8Array<ArrayBuffer>, powerPointDocumentStream: Uint8Array<ArrayBuffer>, password?: string, picturesStream?: Uint8Array<ArrayBuffer>, options?: ReadPptOptions): PptDocument;
+declare function readPptContent(bytes: Uint8Array<ArrayBuffer>, password?: string, options?: ReadPptOptions): PptDocument;
+declare function readPpt(bytes: Uint8Array<ArrayBuffer>, password?: string, options?: ReadPptOptions): DocumentTree;
 //#endregion
-export { CURRENT_USER_STREAM, DEFAULT_INSET_LEFT_RIGHT_PT, DEFAULT_INSET_TOP_BOTTOM_PT, PICTURES_STREAM, POWERPOINT_DOCUMENT_STREAM, PptDocument, SUMMARY_INFORMATION_STREAM, readPpt, readPptContent, readPptStreams };
+export { CURRENT_USER_STREAM, DEFAULT_INSET_LEFT_RIGHT_PT, DEFAULT_INSET_TOP_BOTTOM_PT, DecodeEmbeddedObjectPort, PICTURES_STREAM, POWERPOINT_DOCUMENT_STREAM, PptDocument, ReadPptOptions, SUMMARY_INFORMATION_STREAM, readPpt, readPptContent, readPptStreams };

package/dist/read.d.ts

@@ -1,4 +1,4 @@
-import { ContentSlide, DocumentTree, LayoutMetadata } from "document-schema.js";
+import { ContentDocument, ContentEmbeddedObjectKind, ContentSlide, DocumentTree, LayoutMetadata } from "document-schema.js";
 //#region src/read.d.ts
 declare const CURRENT_USER_STREAM = "Current User";
 declare const POWERPOINT_DOCUMENT_STREAM = "PowerPoint Document";
@@ -7,12 +7,19 @@ declare const PICTURES_STREAM = "Pictures";
 declare const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 declare const DEFAULT_INSET_LEFT_RIGHT_PT: number;
 declare const DEFAULT_INSET_TOP_BOTTOM_PT: number;
+type DecodeEmbeddedObjectPort = (storageBytes: Uint8Array<ArrayBuffer>, progId: string | undefined) => {
+  readonly objectKind: ContentEmbeddedObjectKind;
+  readonly document: ContentDocument;
+} | undefined;
+interface ReadPptOptions {
+  readonly decodeEmbeddedObject?: DecodeEmbeddedObjectPort;
+}
 interface PptDocument {
   readonly metadata: LayoutMetadata;
   readonly slides: readonly ContentSlide[];
 }
-declare function readPptStreams(currentUserStream: Uint8Array<ArrayBuffer>, powerPointDocumentStream: Uint8Array<ArrayBuffer>, password?: string, picturesStream?: Uint8Array<ArrayBuffer>): PptDocument;
-declare function readPptContent(bytes: Uint8Array<ArrayBuffer>, password?: string): PptDocument;
-declare function readPpt(bytes: Uint8Array<ArrayBuffer>, password?: string): DocumentTree;
+declare function readPptStreams(currentUserStream: Uint8Array<ArrayBuffer>, powerPointDocumentStream: Uint8Array<ArrayBuffer>, password?: string, picturesStream?: Uint8Array<ArrayBuffer>, options?: ReadPptOptions): PptDocument;
+declare function readPptContent(bytes: Uint8Array<ArrayBuffer>, password?: string, options?: ReadPptOptions): PptDocument;
+declare function readPpt(bytes: Uint8Array<ArrayBuffer>, password?: string, options?: ReadPptOptions): DocumentTree;
 //#endregion
-export { CURRENT_USER_STREAM, DEFAULT_INSET_LEFT_RIGHT_PT, DEFAULT_INSET_TOP_BOTTOM_PT, PICTURES_STREAM, POWERPOINT_DOCUMENT_STREAM, PptDocument, SUMMARY_INFORMATION_STREAM, readPpt, readPptContent, readPptStreams };
+export { CURRENT_USER_STREAM, DEFAULT_INSET_LEFT_RIGHT_PT, DEFAULT_INSET_TOP_BOTTOM_PT, DecodeEmbeddedObjectPort, PICTURES_STREAM, POWERPOINT_DOCUMENT_STREAM, PptDocument, ReadPptOptions, SUMMARY_INFORMATION_STREAM, readPpt, readPptContent, readPptStreams };

package/dist/read.js

@@ -4,7 +4,7 @@ import { childRecords, findChild } from "./record/tree.js";
 import { RT_Document, RT_DocumentAtom, RT_Drawing, RT_Environment, RT_MainMaster, RT_OutlineTextRefAtom, RT_Slide, RT_SlideAtom, RT_StyleTextPropAtom, RT_TextHeaderAtom, RT_TextMasterStyleAtom } from "./record/types.js";
 import { readStyleTextPropAtom, readTextMasterStyleAtom } from "./text/style.js";
 import { characterCountOf, readTextBody, readTextHeaderAtom } from "./text/atoms.js";
-import { masterUnitsToPoints } from "./units.js";
+import { emuToPoints, masterUnitsToPoints } from "./units.js";
 import { findSlideSchemeColorSchemeAtom, readSlideSchemeColorSchemeAtom } from "./document/color-scheme.js";
 import { buildMasterStyleTable, readSlideAtom } from "./document/master.js";
 import { buildParagraphs } from "./content.js";
@@ -18,6 +18,7 @@ import { readDrawingShapes } from "./drawing/shapes.js";
 import { readNotesContainerAtom, readNotesText } from "./document/notes.js";
 import { readSlideListWithText } from "./document/slide-list.js";
 import { readCurrentUserAtom } from "./stream/current-user.js";
+import { readExObjIdRef, readExternalOleEmbeds, resolveOleObjectStorage } from "./ole/embedded.js";
 import { buildPersistDirectory, resolvePersistObject } from "./stream/persist.js";
 import { readCompoundFile, readSummaryInformation, summaryInformationToLayoutMetadata } from "archive-codec";
 import { assembleTree } from "document-schema.js";
@@ -29,6 +30,20 @@ const PICTURES_STREAM = "Pictures";
 const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 const DEFAULT_INSET_LEFT_RIGHT_PT = 7.2;
 const DEFAULT_INSET_TOP_BOTTOM_PT = 3.6;
+function insetsForShape(properties, isPicture) {
+	const defaultLeftRight = isPicture ? 0 : DEFAULT_INSET_LEFT_RIGHT_PT;
+	const defaultTopBottom = isPicture ? 0 : DEFAULT_INSET_TOP_BOTTOM_PT;
+	const emuOrDefault = (opid, fallback) => {
+		const property = properties.get(opid);
+		return property === void 0 ? fallback : emuToPoints(property.value);
+	};
+	return {
+		insetLeftPt: emuOrDefault(129, defaultLeftRight),
+		insetTopPt: emuOrDefault(130, defaultTopBottom),
+		insetRightPt: emuOrDefault(131, defaultLeftRight),
+		insetBottomPt: emuOrDefault(132, defaultTopBottom)
+	};
+}
 const NO_STYLE = {
 	paragraphRuns: [],
 	characterRuns: []
@@ -79,6 +94,23 @@ function imageBlocksFor(pibProperty, context, widthPt, heightPt) {
 		heightPt
 	}];
 }
+function embeddedObjectBlocksFor(clientData, context, frame) {
+	if (clientData === void 0 || context.decodeEmbeddedObject === void 0) return [];
+	const exObjId = readExObjIdRef(clientData);
+	if (exObjId === void 0) return [];
+	const embed = context.externalOleEmbeds.get(exObjId);
+	if (embed === void 0) return [];
+	const storageBytes = resolveOleObjectStorage(context.streamBytes, context.directory, embed.persistIdRef);
+	if (storageBytes === void 0) return [];
+	const decoded = context.decodeEmbeddedObject(storageBytes, embed.progId);
+	if (decoded === void 0) return [];
+	return [{
+		kind: "embeddedObject",
+		objectKind: decoded.objectKind,
+		document: decoded.document,
+		frame
+	}];
+}
 function tableBlockFor(table, context) {
 	const placed = table.cells.flatMap((cell) => cell.anchor === void 0 || cell.anchor.right <= cell.anchor.left || cell.anchor.bottom <= cell.anchor.top ? [] : [{
 		cell,
@@ -193,11 +225,17 @@ function readSlide(base, size, notes, mastersById) {
 				heightPt
 			},
 			...shape.rotationDeg === void 0 ? {} : { rotationDeg: shape.rotationDeg },
-			insetLeftPt: isPicture ? 0 : DEFAULT_INSET_LEFT_RIGHT_PT,
-			insetTopPt: isPicture ? 0 : DEFAULT_INSET_TOP_BOTTOM_PT,
-			insetRightPt: isPicture ? 0 : DEFAULT_INSET_LEFT_RIGHT_PT,
-			insetBottomPt: isPicture ? 0 : DEFAULT_INSET_TOP_BOTTOM_PT,
-			blocks: [...imageBlocksFor(shape.properties.get(260), context, widthPt, heightPt), ...blocksFor(shape.clientTextbox, context)]
+			...insetsForShape(shape.properties, isPicture),
+			blocks: [
+				...imageBlocksFor(shape.properties.get(260), context, widthPt, heightPt),
+				...blocksFor(shape.clientTextbox, context),
+				...embeddedObjectBlocksFor(shape.clientData, context, {
+					xPt: left,
+					yPt: top,
+					widthPt,
+					heightPt
+				})
+			]
 		});
 	}
 	return {
@@ -206,7 +244,7 @@ function readSlide(base, size, notes, mastersById) {
 		notes
 	};
 }
-function readPptStreams(currentUserStream, powerPointDocumentStream, password, picturesStream) {
+function readPptStreams(currentUserStream, powerPointDocumentStream, password, picturesStream, options) {
 	const currentUser = readCurrentUserAtom(currentUserStream);
 	const { directory, currentEdit } = buildPersistDirectory(powerPointDocumentStream, currentUser.offsetToCurrentEdit);
 	let streamBytes = powerPointDocumentStream;
@@ -235,6 +273,7 @@ function readPptStreams(currentUserStream, powerPointDocumentStream, password, p
 	const persists = slideList === void 0 ? [] : readSlideListWithText(slideList);
 	const notesBySlideId = readNotesBySlideId(streamBytes, directory, listWithInstance(2));
 	const blips = readBlipStore(documentContainer, currentUser.encrypted ? void 0 : picturesStream);
+	const externalOleEmbeds = readExternalOleEmbeds(children);
 	return {
 		metadata: {},
 		slides: persists.map((persist) => readSlide({
@@ -242,14 +281,16 @@ function readPptStreams(currentUserStream, powerPointDocumentStream, password, p
 			directory,
 			persist,
 			fontNames,
-			blips
+			blips,
+			externalOleEmbeds,
+			decodeEmbeddedObject: options?.decodeEmbeddedObject
 		}, size, notesBySlideId.get(persist.slideId) ?? "", mastersById))
 	};
 }
-function readPptContent(bytes, password) {
+function readPptContent(bytes, password, options) {
 	const streams = readCompoundFile(bytes);
 	const pictures = streams.find((stream) => stream.path === PICTURES_STREAM);
-	const document = readPptStreams(requireStream(streams, CURRENT_USER_STREAM), requireStream(streams, POWERPOINT_DOCUMENT_STREAM), password, pictures === void 0 ? void 0 : pictures.bytes);
+	const document = readPptStreams(requireStream(streams, CURRENT_USER_STREAM), requireStream(streams, POWERPOINT_DOCUMENT_STREAM), password, pictures === void 0 ? void 0 : pictures.bytes, options);
 	const metadataStream = streams.find((stream) => stream.path === SUMMARY_INFORMATION_STREAM);
 	if (metadataStream === void 0) return document;
 	return {
@@ -257,8 +298,8 @@ function readPptContent(bytes, password) {
 		metadata: summaryInformationToLayoutMetadata(readSummaryInformation(metadataStream.bytes))
 	};
 }
-function readPpt(bytes, password) {
-	const { metadata, slides } = readPptContent(bytes, password);
+function readPpt(bytes, password, options) {
+	const { metadata, slides } = readPptContent(bytes, password, options);
 	const document = {
 		kind: "presentation",
 		metadata,

package/dist/stream/current-user.cjs

@@ -48,4 +48,5 @@ exports.CURRENT_USER_DOC_FILE_VERSION = CURRENT_USER_DOC_FILE_VERSION;
 exports.CURRENT_USER_FIXED_SIZE = CURRENT_USER_FIXED_SIZE;
 exports.CURRENT_USER_HEADER_TOKEN_ENCRYPTED = CURRENT_USER_HEADER_TOKEN_ENCRYPTED;
 exports.CURRENT_USER_HEADER_TOKEN_PLAIN = CURRENT_USER_HEADER_TOKEN_PLAIN;
+exports.decodeUtf16Le = decodeUtf16Le;
 exports.readCurrentUserAtom = readCurrentUserAtom;

package/dist/stream/current-user.d.cts

@@ -8,6 +8,7 @@ interface CurrentUser {
   readonly encrypted: boolean;
   readonly userName: string;
 }
+declare function decodeUtf16Le(bytes: Uint8Array<ArrayBuffer>): string;
 declare function readCurrentUserAtom(streamBytes: Uint8Array<ArrayBuffer>): CurrentUser;
 //#endregion
-export { CURRENT_USER_DOC_FILE_VERSION, CURRENT_USER_FIXED_SIZE, CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, CurrentUser, readCurrentUserAtom };
+export { CURRENT_USER_DOC_FILE_VERSION, CURRENT_USER_FIXED_SIZE, CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, CurrentUser, decodeUtf16Le, readCurrentUserAtom };

package/dist/stream/current-user.d.ts

@@ -8,6 +8,7 @@ interface CurrentUser {
   readonly encrypted: boolean;
   readonly userName: string;
 }
+declare function decodeUtf16Le(bytes: Uint8Array<ArrayBuffer>): string;
 declare function readCurrentUserAtom(streamBytes: Uint8Array<ArrayBuffer>): CurrentUser;
 //#endregion
-export { CURRENT_USER_DOC_FILE_VERSION, CURRENT_USER_FIXED_SIZE, CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, CurrentUser, readCurrentUserAtom };
+export { CURRENT_USER_DOC_FILE_VERSION, CURRENT_USER_FIXED_SIZE, CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, CurrentUser, decodeUtf16Le, readCurrentUserAtom };

package/dist/stream/current-user.js

@@ -43,4 +43,4 @@ function readCurrentUserAtom(streamBytes) {
 	};
 }
 //#endregion
-export { CURRENT_USER_DOC_FILE_VERSION, CURRENT_USER_FIXED_SIZE, CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, readCurrentUserAtom };
+export { CURRENT_USER_DOC_FILE_VERSION, CURRENT_USER_FIXED_SIZE, CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, decodeUtf16Le, readCurrentUserAtom };

package/dist/units.cjs

@@ -9,8 +9,18 @@ function masterUnitsToPoints(masterUnits) {
 function pointsToMasterUnits(points) {
 	return Math.round(points * 8);
 }
+const EMU_PER_POINT = 12700;
+function emuToPoints(emu) {
+	return emu / EMU_PER_POINT;
+}
+function pointsToEmu(points) {
+	return Math.round(points * EMU_PER_POINT);
+}
 //#endregion
+exports.EMU_PER_POINT = EMU_PER_POINT;
 exports.MASTER_UNITS_PER_POINT = MASTER_UNITS_PER_POINT;
 exports.POINTS_PER_INCH = POINTS_PER_INCH;
+exports.emuToPoints = emuToPoints;
 exports.masterUnitsToPoints = masterUnitsToPoints;
+exports.pointsToEmu = pointsToEmu;
 exports.pointsToMasterUnits = pointsToMasterUnits;

package/dist/units.d.cts

@@ -3,5 +3,8 @@ declare const POINTS_PER_INCH = 72;
 declare const MASTER_UNITS_PER_POINT: number;
 declare function masterUnitsToPoints(masterUnits: number): number;
 declare function pointsToMasterUnits(points: number): number;
+declare const EMU_PER_POINT: number;
+declare function emuToPoints(emu: number): number;
+declare function pointsToEmu(points: number): number;
 //#endregion
-export { MASTER_UNITS_PER_POINT, POINTS_PER_INCH, masterUnitsToPoints, pointsToMasterUnits };
+export { EMU_PER_POINT, MASTER_UNITS_PER_POINT, POINTS_PER_INCH, emuToPoints, masterUnitsToPoints, pointsToEmu, pointsToMasterUnits };

package/dist/units.d.ts

@@ -3,5 +3,8 @@ declare const POINTS_PER_INCH = 72;
 declare const MASTER_UNITS_PER_POINT: number;
 declare function masterUnitsToPoints(masterUnits: number): number;
 declare function pointsToMasterUnits(points: number): number;
+declare const EMU_PER_POINT: number;
+declare function emuToPoints(emu: number): number;
+declare function pointsToEmu(points: number): number;
 //#endregion
-export { MASTER_UNITS_PER_POINT, POINTS_PER_INCH, masterUnitsToPoints, pointsToMasterUnits };
+export { EMU_PER_POINT, MASTER_UNITS_PER_POINT, POINTS_PER_INCH, emuToPoints, masterUnitsToPoints, pointsToEmu, pointsToMasterUnits };

package/dist/units.js

@@ -8,5 +8,12 @@ function masterUnitsToPoints(masterUnits) {
 function pointsToMasterUnits(points) {
 	return Math.round(points * 8);
 }
+const EMU_PER_POINT = 12700;
+function emuToPoints(emu) {
+	return emu / EMU_PER_POINT;
+}
+function pointsToEmu(points) {
+	return Math.round(points * EMU_PER_POINT);
+}
 //#endregion
-export { MASTER_UNITS_PER_POINT, POINTS_PER_INCH, masterUnitsToPoints, pointsToMasterUnits };
+export { EMU_PER_POINT, MASTER_UNITS_PER_POINT, POINTS_PER_INCH, emuToPoints, masterUnitsToPoints, pointsToEmu, pointsToMasterUnits };

package/dist/write.cjs

@@ -8,8 +8,8 @@ const require_record_write = require("./record/write.cjs");
 const require_document_document_atom_write = require("./document/document-atom-write.cjs");
 const require_document_fonts_write = require("./document/fonts-write.cjs");
 const require_drawing_blips = require("./drawing/blips.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");
 const require_document_master_write = require("./document/master-write.cjs");
 const require_document_notes_list_write = require("./document/notes-list-write.cjs");
 const require_document_notes_write = require("./document/notes-write.cjs");
@@ -17,6 +17,7 @@ const require_document_slide_list_write = require("./document/slide-list-write.c
 const require_metadata = require("./metadata.cjs");
 const require_stream_current_user_write = require("./stream/current-user-write.cjs");
 const require_stream_persist_write = require("./stream/persist-write.cjs");
+const require_ole_embedded_write = require("./ole/embedded-write.cjs");
 let archive_codec = require("archive-codec");
 let document_schema_js = require("document-schema.js");
 //#region src/write.ts
@@ -35,10 +36,10 @@ function requireOneSlideSize(slides) {
 	for (const slide of slides) if (slide.size.widthPt !== first.widthPt || slide.size.heightPt !== first.heightPt) throw new require_errors.PptUnsupportedContentError(`ppt-codec's writer cannot express per-slide sizes: slide sizes ${JSON.stringify(first)} and ${JSON.stringify(slide.size)} both appear, but [MS-PPT]'s DocumentAtom states exactly one slide size for the whole presentation`);
 	return first;
 }
-function writeSlideContainer(shapes, notesIdRef, context) {
+function writeSlideContainer(shapes, notesIdRef, context, clientDataFor) {
 	const drawing = require_drawing_shapes_write.writeSlideDrawing(shapes.map((shape) => ({
 		shape,
-		clientData: void 0
+		clientData: clientDataFor(shape)
 	})), context);
 	return {
 		bytes: require_record_write.writeContainer(require_record_types.RT_Slide, [require_document_master_write.writeSlideAtomForSlide(notesIdRef), drawing.bytes]),
@@ -46,6 +47,34 @@ function writeSlideContainer(shapes, notesIdRef, context) {
 		maxSpid: drawing.maxSpid
 	};
 }
+function planOleEmbeds(slides, serialise, firstPersistId) {
+	const embeds = [];
+	const persistObjects = [];
+	const clientDataByShape = /* @__PURE__ */ new Map();
+	if (serialise !== void 0) for (const slide of slides) for (const shape of slide.shapes) {
+		const embedBlock = shape.blocks.find((block) => block.kind === "embeddedObject");
+		if (embedBlock === void 0) continue;
+		const storageBytes = serialise(embedBlock.document);
+		if (storageBytes === void 0) continue;
+		const exObjId = embeds.length + 1;
+		const persistId = firstPersistId + persistObjects.length;
+		embeds.push({
+			exObjId,
+			persistIdRef: persistId,
+			objectKind: embedBlock.objectKind
+		});
+		persistObjects.push({
+			persistId,
+			bytes: require_ole_embedded_write.writeExOleObjStg(storageBytes)
+		});
+		clientDataByShape.set(shape, require_ole_embedded_write.writeOleClientData(exObjId));
+	}
+	return {
+		embeds,
+		persistObjects,
+		clientDataFor: (shape) => clientDataByShape.get(shape)
+	};
+}
 function planBlipStore(slides) {
 	const blips = [];
 	const pibByKey = /* @__PURE__ */ new Map();
@@ -81,10 +110,12 @@ function writePptStreams(document, options = {}) {
 		return index;
 	};
 	const store = planBlipStore(slides);
+	const strict = options.onUnwritableBlock === "throw";
 	const contextFor = (location) => ({
 		fontIndexOf,
 		blipIndexOf: store.pibOf,
 		sink,
+		strict,
 		location
 	});
 	const slidePersistRefs = slides.map((_slide, index) => ({
@@ -92,6 +123,8 @@ function writePptStreams(document, options = {}) {
 		slideId: FIRST_SLIDE_ID + index
 	}));
 	const notesIdRefs = slides.map((slide, index) => slide.notes.length === 0 ? NO_NOTES_ID_REF : FIRST_NOTES_ID + slides.slice(0, index).filter((earlier) => earlier.notes.length > 0).length);
+	const notesCount = notesIdRefs.filter((id) => id !== NO_NOTES_ID_REF).length;
+	const oleEmbeds = planOleEmbeds(slides, options.serialiseEmbeddedObject, FIRST_SLIDE_PERSIST_ID + slides.length + notesCount);
 	let shapeCount = 0;
 	let maxSpid = 0;
 	let drawingCount = 0;
@@ -106,7 +139,7 @@ function writePptStreams(document, options = {}) {
 		const ref = slidePersistRefs[index];
 		const notesIdRef = notesIdRefs[index];
 		if (ref === void 0 || notesIdRef === void 0) throw new require_errors.PptUnsupportedContentError("internal error: slide persist reference missing for a slide being written");
-		const container = writeSlideContainer(slide.shapes, notesIdRef, contextFor(`slide ${index + 1}`));
+		const container = writeSlideContainer(slide.shapes, notesIdRef, contextFor(`slide ${index + 1}`), oleEmbeds.clientDataFor);
 		account(container);
 		return {
 			persistId: ref.persistIdRef,
@@ -132,6 +165,8 @@ function writePptStreams(document, options = {}) {
 	});
 	const environment = require_document_fonts_write.writeEnvironment(fontNames);
 	const documentChildren = [require_document_document_atom_write.writeDocumentAtom(size)];
+	const exObjList = require_ole_embedded_write.writeExObjListContainer(oleEmbeds.embeds);
+	if (exObjList !== void 0) documentChildren.push(exObjList);
 	if (environment !== void 0) documentChildren.push(environment);
 	documentChildren.push(require_drawing_blips.writeDrawingGroupContainer(store.blips, {
 		spidMax: maxSpid,
@@ -152,7 +187,8 @@ function writePptStreams(document, options = {}) {
 			bytes: mainMaster.bytes
 		},
 		...slideContainers,
-		...notesContainers
+		...notesContainers,
+		...oleEmbeds.persistObjects
 	];
 	const persistEntries = [];
 	let offset = 0;

package/dist/write.d.cts

@@ -1,10 +1,14 @@
 import { a as PptDiagnosticSink } from "./diagnostics-CqxAnubw.cjs";
 import { PptDocument } from "./read.cjs";
-import { DocumentTree } from "document-schema.js";
+import { ContentDocument, DocumentTree } from "document-schema.js";
 //#region src/write.d.ts
+type EmbeddedObjectSerialiser = (document: ContentDocument) => Uint8Array<ArrayBuffer> | undefined;
+type PptUnwritableBlockPolicy = "drop" | "throw";
 interface WritePptOptions {
   readonly signal?: AbortSignal;
   readonly sink?: PptDiagnosticSink;
+  readonly serialiseEmbeddedObject?: EmbeddedObjectSerialiser;
+  readonly onUnwritableBlock?: PptUnwritableBlockPolicy;
 }
 declare function writePptStreams(document: PptDocument, options?: WritePptOptions): {
   readonly currentUserStream: Uint8Array<ArrayBuffer>;
@@ -13,4 +17,4 @@ declare function writePptStreams(document: PptDocument, options?: WritePptOption
 declare function writePptContent(document: PptDocument, options?: WritePptOptions): Uint8Array<ArrayBuffer>;
 declare function writePpt(tree: DocumentTree, options?: WritePptOptions): Uint8Array<ArrayBuffer>;
 //#endregion
-export { WritePptOptions, writePpt, writePptContent, writePptStreams };
+export { EmbeddedObjectSerialiser, PptUnwritableBlockPolicy, WritePptOptions, writePpt, writePptContent, writePptStreams };

package/dist/write.d.ts

@@ -1,10 +1,14 @@
 import { a as PptDiagnosticSink } from "./diagnostics-CqxAnubw.js";
 import { PptDocument } from "./read.js";
-import { DocumentTree } from "document-schema.js";
+import { ContentDocument, DocumentTree } from "document-schema.js";
 //#region src/write.d.ts
+type EmbeddedObjectSerialiser = (document: ContentDocument) => Uint8Array<ArrayBuffer> | undefined;
+type PptUnwritableBlockPolicy = "drop" | "throw";
 interface WritePptOptions {
   readonly signal?: AbortSignal;
   readonly sink?: PptDiagnosticSink;
+  readonly serialiseEmbeddedObject?: EmbeddedObjectSerialiser;
+  readonly onUnwritableBlock?: PptUnwritableBlockPolicy;
 }
 declare function writePptStreams(document: PptDocument, options?: WritePptOptions): {
   readonly currentUserStream: Uint8Array<ArrayBuffer>;
@@ -13,4 +17,4 @@ declare function writePptStreams(document: PptDocument, options?: WritePptOption
 declare function writePptContent(document: PptDocument, options?: WritePptOptions): Uint8Array<ArrayBuffer>;
 declare function writePpt(tree: DocumentTree, options?: WritePptOptions): Uint8Array<ArrayBuffer>;
 //#endregion
-export { WritePptOptions, writePpt, writePptContent, writePptStreams };
+export { EmbeddedObjectSerialiser, PptUnwritableBlockPolicy, WritePptOptions, writePpt, writePptContent, writePptStreams };