ppt-codec 1.0.2 → 1.1.1

package/dist/read.js

@@ -1,21 +1,25 @@
 import { PptEncryptedError, PptFormatError } from "./errors.js";
 import { childRecords, findChild } from "./record/tree.js";
 import { RT_Document, RT_DocumentAtom, RT_Drawing, RT_Environment, RT_OutlineTextRefAtom, RT_Slide, RT_StyleTextPropAtom } from "./record/types.js";
-import { characterCountOf, readTextBody } from "./text/atoms.js";
 import { readStyleTextPropAtom } from "./text/style.js";
+import { characterCountOf, readTextBody } from "./text/atoms.js";
+import { masterUnitsToPoints } from "./units.js";
 import { buildParagraphs } from "./content.js";
 import { readDocumentAtom } from "./document/document-atom.js";
 import { readFontNames } from "./document/fonts.js";
-import { readSlideListWithText } from "./document/slide-list.js";
+import { readNotesListWithText } from "./document/notes-list.js";
 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 { buildPersistDirectory, resolvePersistObject } from "./stream/persist.js";
-import { masterUnitsToPoints } from "./units.js";
-import { readCompoundFile } from "archive-codec";
+import { readCompoundFile, readSummaryInformation, summaryInformationToLayoutMetadata } from "archive-codec";
 import { assembleTree } from "document-schema.js";
 //#region src/read.ts
 const CURRENT_USER_STREAM = "Current User";
 const POWERPOINT_DOCUMENT_STREAM = "PowerPoint Document";
+/** The [MS-OLEPS] Property Set Stream a .ppt's title/author/dates live in when present ([MS-OSHARED] 2.3.3.2.2) -- a genuinely optional stream, unlike the two above, since a valid PowerPoint binary document need not carry document properties at all. */
+const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 const DEFAULT_INSET_LEFT_RIGHT_PT = 7.2;
 const DEFAULT_INSET_TOP_BOTTOM_PT = 3.6;
 const NO_STYLE = {
@@ -46,7 +50,16 @@ function blocksFor(clientTextbox, persist, fontNames) {
 	const style = styleRecord === void 0 ? NO_STYLE : readStyleTextPropAtom(styleRecord, characterCountOf(text));
 	return buildParagraphs(text, style, fontNames);
 }
-function readSlide(streamBytes, directory, persist, size, fontNames) {
+function readNotesBySlideId(streamBytes, directory, notesList) {
+	const notes = /* @__PURE__ */ new Map();
+	if (notesList === void 0) return notes;
+	for (const persist of readNotesListWithText(notesList)) {
+		const notesContainer = resolvePersistObject(streamBytes, directory, persist.persistIdRef, `NotesPersistAtom for notes slide ${persist.notesId}`);
+		notes.set(readNotesContainerAtom(notesContainer).slideIdRef, readNotesText(notesContainer));
+	}
+	return notes;
+}
+function readSlide(streamBytes, directory, persist, size, fontNames, notes) {
 	const slideContainer = resolvePersistObject(streamBytes, directory, persist.persistIdRef, `SlidePersistAtom for slide ${persist.slideId}`);
 	if (slideContainer.header.recType !== 1006) throw new PptFormatError(`persist object ${persist.persistIdRef} is record type 0x${slideContainer.header.recType.toString(16)}, not the RT_Slide (0x${RT_Slide.toString(16)}) its SlidePersistAtom promised`);
 	const drawing = findChild(childRecords(slideContainer), RT_Drawing);
@@ -72,7 +85,7 @@ function readSlide(streamBytes, directory, persist, size, fontNames) {
 	return {
 		size,
 		shapes,
-		notes: ""
+		notes
 	};
 }
 function readPptStreams(currentUserStream, powerPointDocumentStream) {
@@ -91,15 +104,24 @@ function readPptStreams(currentUserStream, powerPointDocumentStream) {
 	};
 	const environment = findChild(children, RT_Environment);
 	const fontNames = environment === void 0 ? [] : readFontNames(environment);
-	const slideList = children.find((record) => record.header.recType === 4080 && record.header.recInstance === 0);
+	const listWithInstance = (instance) => children.find((record) => record.header.recType === 4080 && record.header.recInstance === instance);
+	const slideList = listWithInstance(0);
+	const persists = slideList === void 0 ? [] : readSlideListWithText(slideList);
+	const notesBySlideId = readNotesBySlideId(powerPointDocumentStream, directory, listWithInstance(2));
 	return {
 		metadata: {},
-		slides: (slideList === void 0 ? [] : readSlideListWithText(slideList)).map((persist) => readSlide(powerPointDocumentStream, directory, persist, size, fontNames))
+		slides: persists.map((persist) => readSlide(powerPointDocumentStream, directory, persist, size, fontNames, notesBySlideId.get(persist.slideId) ?? ""))
 	};
 }
 function readPptContent(bytes) {
 	const streams = readCompoundFile(bytes);
-	return readPptStreams(requireStream(streams, CURRENT_USER_STREAM), requireStream(streams, POWERPOINT_DOCUMENT_STREAM));
+	const document = readPptStreams(requireStream(streams, CURRENT_USER_STREAM), requireStream(streams, POWERPOINT_DOCUMENT_STREAM));
+	const metadataStream = streams.find((stream) => stream.path === SUMMARY_INFORMATION_STREAM);
+	if (metadataStream === void 0) return document;
+	return {
+		...document,
+		metadata: summaryInformationToLayoutMetadata(readSummaryInformation(metadataStream.bytes))
+	};
 }
 function readPpt(bytes) {
 	const { metadata, slides } = readPptContent(bytes);
@@ -111,4 +133,4 @@ function readPpt(bytes) {
 	return assembleTree(document);
 }
 //#endregion
-export { CURRENT_USER_STREAM, POWERPOINT_DOCUMENT_STREAM, readPpt, readPptContent, readPptStreams };
+export { CURRENT_USER_STREAM, DEFAULT_INSET_LEFT_RIGHT_PT, DEFAULT_INSET_TOP_BOTTOM_PT, POWERPOINT_DOCUMENT_STREAM, SUMMARY_INFORMATION_STREAM, readPpt, readPptContent, readPptStreams };

package/dist/record/types.cjs

@@ -5,6 +5,7 @@ const RT_DocumentAtom = 1001;
 const RT_Slide = 1006;
 const RT_SlideAtom = 1007;
 const RT_Notes = 1008;
+const RT_NotesAtom = 1009;
 const RT_Environment = 1010;
 const RT_SlidePersistAtom = 1011;
 const RT_MainMaster = 1016;
@@ -13,6 +14,8 @@ const RT_DrawingGroup = 1035;
 const RT_Drawing = 1036;
 const RT_List = 2e3;
 const RT_FontCollection = 2005;
+const RT_ColorSchemeAtom = 2032;
+const RT_PlaceholderAtom = 3011;
 const RT_OutlineTextRefAtom = 3998;
 const RT_TextHeaderAtom = 3999;
 const RT_TextCharsAtom = 4e3;
@@ -42,9 +45,11 @@ const OfficeArtFOPT = 61451;
 const OfficeArtClientTextbox = 61453;
 const OfficeArtChildAnchor = 61455;
 const OfficeArtClientAnchor = 61456;
+const OfficeArtClientData = 61457;
 //#endregion
 exports.OfficeArtChildAnchor = OfficeArtChildAnchor;
 exports.OfficeArtClientAnchor = OfficeArtClientAnchor;
+exports.OfficeArtClientData = OfficeArtClientData;
 exports.OfficeArtClientTextbox = OfficeArtClientTextbox;
 exports.OfficeArtDgContainer = OfficeArtDgContainer;
 exports.OfficeArtFOPT = OfficeArtFOPT;
@@ -53,6 +58,7 @@ exports.OfficeArtFSPGR = OfficeArtFSPGR;
 exports.OfficeArtSpContainer = OfficeArtSpContainer;
 exports.OfficeArtSpgrContainer = OfficeArtSpgrContainer;
 exports.RT_CString = RT_CString;
+exports.RT_ColorSchemeAtom = RT_ColorSchemeAtom;
 exports.RT_CryptSession10Container = RT_CryptSession10Container;
 exports.RT_CurrentUserAtom = RT_CurrentUserAtom;
 exports.RT_Document = RT_Document;
@@ -67,8 +73,10 @@ exports.RT_List = RT_List;
 exports.RT_MainMaster = RT_MainMaster;
 exports.RT_MasterTextPropAtom = RT_MasterTextPropAtom;
 exports.RT_Notes = RT_Notes;
+exports.RT_NotesAtom = RT_NotesAtom;
 exports.RT_OutlineTextRefAtom = RT_OutlineTextRefAtom;
 exports.RT_PersistDirectoryAtom = RT_PersistDirectoryAtom;
+exports.RT_PlaceholderAtom = RT_PlaceholderAtom;
 exports.RT_Slide = RT_Slide;
 exports.RT_SlideAtom = RT_SlideAtom;
 exports.RT_SlideListWithText = RT_SlideListWithText;

package/dist/record/types.d.cts

@@ -4,6 +4,7 @@ declare const RT_DocumentAtom = 1001;
 declare const RT_Slide = 1006;
 declare const RT_SlideAtom = 1007;
 declare const RT_Notes = 1008;
+declare const RT_NotesAtom = 1009;
 declare const RT_Environment = 1010;
 declare const RT_SlidePersistAtom = 1011;
 declare const RT_MainMaster = 1016;
@@ -12,6 +13,8 @@ declare const RT_DrawingGroup = 1035;
 declare const RT_Drawing = 1036;
 declare const RT_List = 2000;
 declare const RT_FontCollection = 2005;
+declare const RT_ColorSchemeAtom = 2032;
+declare const RT_PlaceholderAtom = 3011;
 declare const RT_OutlineTextRefAtom = 3998;
 declare const RT_TextHeaderAtom = 3999;
 declare const RT_TextCharsAtom = 4000;
@@ -41,5 +44,6 @@ declare const OfficeArtFOPT = 61451;
 declare const OfficeArtClientTextbox = 61453;
 declare const OfficeArtChildAnchor = 61455;
 declare const OfficeArtClientAnchor = 61456;
+declare const OfficeArtClientData = 61457;
 //#endregion
-export { OfficeArtChildAnchor, OfficeArtClientAnchor, OfficeArtClientTextbox, OfficeArtDgContainer, OfficeArtFOPT, OfficeArtFSP, OfficeArtFSPGR, OfficeArtSpContainer, OfficeArtSpgrContainer, RT_CString, RT_CryptSession10Container, RT_CurrentUserAtom, RT_Document, RT_DocumentAtom, RT_Drawing, RT_DrawingGroup, RT_Environment, RT_ExternalObjectList, RT_FontCollection, RT_FontEntityAtom, RT_List, RT_MainMaster, RT_MasterTextPropAtom, RT_Notes, RT_OutlineTextRefAtom, RT_PersistDirectoryAtom, RT_Slide, RT_SlideAtom, RT_SlideListWithText, RT_SlidePersistAtom, RT_StyleTextPropAtom, RT_TextBytesAtom, RT_TextCharsAtom, RT_TextHeaderAtom, RT_TextMasterStyleAtom, RT_TextRulerAtom, RT_TextSpecialInfoAtom, RT_TextSpecialInfoDefaultAtom, RT_UserEditAtom, SLIDE_LIST_INSTANCE_MASTERS, SLIDE_LIST_INSTANCE_NOTES, SLIDE_LIST_INSTANCE_SLIDES };
+export { OfficeArtChildAnchor, OfficeArtClientAnchor, OfficeArtClientData, OfficeArtClientTextbox, OfficeArtDgContainer, OfficeArtFOPT, OfficeArtFSP, OfficeArtFSPGR, OfficeArtSpContainer, OfficeArtSpgrContainer, RT_CString, RT_ColorSchemeAtom, RT_CryptSession10Container, RT_CurrentUserAtom, RT_Document, RT_DocumentAtom, RT_Drawing, RT_DrawingGroup, RT_Environment, RT_ExternalObjectList, RT_FontCollection, RT_FontEntityAtom, RT_List, RT_MainMaster, RT_MasterTextPropAtom, RT_Notes, RT_NotesAtom, RT_OutlineTextRefAtom, RT_PersistDirectoryAtom, RT_PlaceholderAtom, RT_Slide, RT_SlideAtom, RT_SlideListWithText, RT_SlidePersistAtom, RT_StyleTextPropAtom, RT_TextBytesAtom, RT_TextCharsAtom, RT_TextHeaderAtom, RT_TextMasterStyleAtom, RT_TextRulerAtom, RT_TextSpecialInfoAtom, RT_TextSpecialInfoDefaultAtom, RT_UserEditAtom, SLIDE_LIST_INSTANCE_MASTERS, SLIDE_LIST_INSTANCE_NOTES, SLIDE_LIST_INSTANCE_SLIDES };

package/dist/record/types.d.ts

@@ -4,6 +4,7 @@ declare const RT_DocumentAtom = 1001;
 declare const RT_Slide = 1006;
 declare const RT_SlideAtom = 1007;
 declare const RT_Notes = 1008;
+declare const RT_NotesAtom = 1009;
 declare const RT_Environment = 1010;
 declare const RT_SlidePersistAtom = 1011;
 declare const RT_MainMaster = 1016;
@@ -12,6 +13,8 @@ declare const RT_DrawingGroup = 1035;
 declare const RT_Drawing = 1036;
 declare const RT_List = 2000;
 declare const RT_FontCollection = 2005;
+declare const RT_ColorSchemeAtom = 2032;
+declare const RT_PlaceholderAtom = 3011;
 declare const RT_OutlineTextRefAtom = 3998;
 declare const RT_TextHeaderAtom = 3999;
 declare const RT_TextCharsAtom = 4000;
@@ -41,5 +44,6 @@ declare const OfficeArtFOPT = 61451;
 declare const OfficeArtClientTextbox = 61453;
 declare const OfficeArtChildAnchor = 61455;
 declare const OfficeArtClientAnchor = 61456;
+declare const OfficeArtClientData = 61457;
 //#endregion
-export { OfficeArtChildAnchor, OfficeArtClientAnchor, OfficeArtClientTextbox, OfficeArtDgContainer, OfficeArtFOPT, OfficeArtFSP, OfficeArtFSPGR, OfficeArtSpContainer, OfficeArtSpgrContainer, RT_CString, RT_CryptSession10Container, RT_CurrentUserAtom, RT_Document, RT_DocumentAtom, RT_Drawing, RT_DrawingGroup, RT_Environment, RT_ExternalObjectList, RT_FontCollection, RT_FontEntityAtom, RT_List, RT_MainMaster, RT_MasterTextPropAtom, RT_Notes, RT_OutlineTextRefAtom, RT_PersistDirectoryAtom, RT_Slide, RT_SlideAtom, RT_SlideListWithText, RT_SlidePersistAtom, RT_StyleTextPropAtom, RT_TextBytesAtom, RT_TextCharsAtom, RT_TextHeaderAtom, RT_TextMasterStyleAtom, RT_TextRulerAtom, RT_TextSpecialInfoAtom, RT_TextSpecialInfoDefaultAtom, RT_UserEditAtom, SLIDE_LIST_INSTANCE_MASTERS, SLIDE_LIST_INSTANCE_NOTES, SLIDE_LIST_INSTANCE_SLIDES };
+export { OfficeArtChildAnchor, OfficeArtClientAnchor, OfficeArtClientData, OfficeArtClientTextbox, OfficeArtDgContainer, OfficeArtFOPT, OfficeArtFSP, OfficeArtFSPGR, OfficeArtSpContainer, OfficeArtSpgrContainer, RT_CString, RT_ColorSchemeAtom, RT_CryptSession10Container, RT_CurrentUserAtom, RT_Document, RT_DocumentAtom, RT_Drawing, RT_DrawingGroup, RT_Environment, RT_ExternalObjectList, RT_FontCollection, RT_FontEntityAtom, RT_List, RT_MainMaster, RT_MasterTextPropAtom, RT_Notes, RT_NotesAtom, RT_OutlineTextRefAtom, RT_PersistDirectoryAtom, RT_PlaceholderAtom, RT_Slide, RT_SlideAtom, RT_SlideListWithText, RT_SlidePersistAtom, RT_StyleTextPropAtom, RT_TextBytesAtom, RT_TextCharsAtom, RT_TextHeaderAtom, RT_TextMasterStyleAtom, RT_TextRulerAtom, RT_TextSpecialInfoAtom, RT_TextSpecialInfoDefaultAtom, RT_UserEditAtom, SLIDE_LIST_INSTANCE_MASTERS, SLIDE_LIST_INSTANCE_NOTES, SLIDE_LIST_INSTANCE_SLIDES };

package/dist/record/types.js

@@ -4,6 +4,7 @@ const RT_DocumentAtom = 1001;
 const RT_Slide = 1006;
 const RT_SlideAtom = 1007;
 const RT_Notes = 1008;
+const RT_NotesAtom = 1009;
 const RT_Environment = 1010;
 const RT_SlidePersistAtom = 1011;
 const RT_MainMaster = 1016;
@@ -12,6 +13,8 @@ const RT_DrawingGroup = 1035;
 const RT_Drawing = 1036;
 const RT_List = 2e3;
 const RT_FontCollection = 2005;
+const RT_ColorSchemeAtom = 2032;
+const RT_PlaceholderAtom = 3011;
 const RT_OutlineTextRefAtom = 3998;
 const RT_TextHeaderAtom = 3999;
 const RT_TextCharsAtom = 4e3;
@@ -41,5 +44,6 @@ const OfficeArtFOPT = 61451;
 const OfficeArtClientTextbox = 61453;
 const OfficeArtChildAnchor = 61455;
 const OfficeArtClientAnchor = 61456;
+const OfficeArtClientData = 61457;
 //#endregion
-export { OfficeArtChildAnchor, OfficeArtClientAnchor, OfficeArtClientTextbox, OfficeArtDgContainer, OfficeArtFOPT, OfficeArtFSP, OfficeArtFSPGR, OfficeArtSpContainer, OfficeArtSpgrContainer, RT_CString, RT_CryptSession10Container, RT_CurrentUserAtom, RT_Document, RT_DocumentAtom, RT_Drawing, RT_DrawingGroup, RT_Environment, RT_ExternalObjectList, RT_FontCollection, RT_FontEntityAtom, RT_List, RT_MainMaster, RT_MasterTextPropAtom, RT_Notes, RT_OutlineTextRefAtom, RT_PersistDirectoryAtom, RT_Slide, RT_SlideAtom, RT_SlideListWithText, RT_SlidePersistAtom, RT_StyleTextPropAtom, RT_TextBytesAtom, RT_TextCharsAtom, RT_TextHeaderAtom, RT_TextMasterStyleAtom, RT_TextRulerAtom, RT_TextSpecialInfoAtom, RT_TextSpecialInfoDefaultAtom, RT_UserEditAtom, SLIDE_LIST_INSTANCE_MASTERS, SLIDE_LIST_INSTANCE_NOTES, SLIDE_LIST_INSTANCE_SLIDES };
+export { OfficeArtChildAnchor, OfficeArtClientAnchor, OfficeArtClientData, OfficeArtClientTextbox, OfficeArtDgContainer, OfficeArtFOPT, OfficeArtFSP, OfficeArtFSPGR, OfficeArtSpContainer, OfficeArtSpgrContainer, RT_CString, RT_ColorSchemeAtom, RT_CryptSession10Container, RT_CurrentUserAtom, RT_Document, RT_DocumentAtom, RT_Drawing, RT_DrawingGroup, RT_Environment, RT_ExternalObjectList, RT_FontCollection, RT_FontEntityAtom, RT_List, RT_MainMaster, RT_MasterTextPropAtom, RT_Notes, RT_NotesAtom, RT_OutlineTextRefAtom, RT_PersistDirectoryAtom, RT_PlaceholderAtom, RT_Slide, RT_SlideAtom, RT_SlideListWithText, RT_SlidePersistAtom, RT_StyleTextPropAtom, RT_TextBytesAtom, RT_TextCharsAtom, RT_TextHeaderAtom, RT_TextMasterStyleAtom, RT_TextRulerAtom, RT_TextSpecialInfoAtom, RT_TextSpecialInfoDefaultAtom, RT_UserEditAtom, SLIDE_LIST_INSTANCE_MASTERS, SLIDE_LIST_INSTANCE_NOTES, SLIDE_LIST_INSTANCE_SLIDES };

package/dist/record/write.cjs

@@ -0,0 +1,75 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./header.cjs");
+//#region src/record/write.ts
+function concatBytes(...parts) {
+	const total = parts.reduce((sum, part) => sum + part.length, 0);
+	const out = new Uint8Array(total);
+	let at = 0;
+	for (const part of parts) {
+		out.set(part, at);
+		at += part.length;
+	}
+	return out;
+}
+function u8(value) {
+	return new Uint8Array([value & 255]);
+}
+function u16le(value) {
+	const bytes = /* @__PURE__ */ new Uint8Array(2);
+	new DataView(bytes.buffer).setUint16(0, value, true);
+	return bytes;
+}
+function i16le(value) {
+	const bytes = /* @__PURE__ */ new Uint8Array(2);
+	new DataView(bytes.buffer).setInt16(0, value, true);
+	return bytes;
+}
+function u32le(value) {
+	const bytes = /* @__PURE__ */ new Uint8Array(4);
+	new DataView(bytes.buffer).setUint32(0, value, true);
+	return bytes;
+}
+function i32le(value) {
+	const bytes = /* @__PURE__ */ new Uint8Array(4);
+	new DataView(bytes.buffer).setInt32(0, value, true);
+	return bytes;
+}
+function asciiBytes(text) {
+	const bytes = new Uint8Array(text.length);
+	for (let i = 0; i < text.length; i++) bytes[i] = text.charCodeAt(i);
+	return bytes;
+}
+function utf16le(text) {
+	const bytes = new Uint8Array(text.length * 2);
+	const view = new DataView(bytes.buffer);
+	for (let i = 0; i < text.length; i++) view.setUint16(i * 2, text.charCodeAt(i), true);
+	return bytes;
+}
+function recordHeaderBytes(recVer, recInstance, recType, recLen) {
+	const bytes = /* @__PURE__ */ new Uint8Array(8);
+	const view = new DataView(bytes.buffer);
+	view.setUint16(0, recVer & 15 | (recInstance & 4095) << 4, true);
+	view.setUint16(2, recType, true);
+	view.setUint32(4, recLen, true);
+	return bytes;
+}
+function writeAtom(recType, data, options = {}) {
+	const { recVer = 0, recInstance = 0 } = options;
+	return concatBytes(recordHeaderBytes(recVer, recInstance, recType, data.length), data);
+}
+function writeContainer(recType, children, options = {}) {
+	const { recInstance = 0 } = options;
+	const body = concatBytes(...children);
+	return concatBytes(recordHeaderBytes(15, recInstance, recType, body.length), body);
+}
+//#endregion
+exports.asciiBytes = asciiBytes;
+exports.concatBytes = concatBytes;
+exports.i16le = i16le;
+exports.i32le = i32le;
+exports.u16le = u16le;
+exports.u32le = u32le;
+exports.u8 = u8;
+exports.utf16le = utf16le;
+exports.writeAtom = writeAtom;
+exports.writeContainer = writeContainer;

package/dist/record/write.d.cts

@@ -0,0 +1,17 @@
+//#region src/record/write.d.ts
+declare function concatBytes(...parts: readonly Uint8Array<ArrayBuffer>[]): Uint8Array<ArrayBuffer>;
+declare function u8(value: number): Uint8Array<ArrayBuffer>;
+declare function u16le(value: number): Uint8Array<ArrayBuffer>;
+declare function i16le(value: number): Uint8Array<ArrayBuffer>;
+declare function u32le(value: number): Uint8Array<ArrayBuffer>;
+declare function i32le(value: number): Uint8Array<ArrayBuffer>;
+declare function asciiBytes(text: string): Uint8Array<ArrayBuffer>;
+declare function utf16le(text: string): Uint8Array<ArrayBuffer>;
+interface RecordWriteOptions {
+  readonly recVer?: number;
+  readonly recInstance?: number;
+}
+declare function writeAtom(recType: number, data: Uint8Array<ArrayBuffer>, options?: RecordWriteOptions): Uint8Array<ArrayBuffer>;
+declare function writeContainer(recType: number, children: readonly Uint8Array<ArrayBuffer>[], options?: Omit<RecordWriteOptions, "recVer">): Uint8Array<ArrayBuffer>;
+//#endregion
+export { RecordWriteOptions, asciiBytes, concatBytes, i16le, i32le, u16le, u32le, u8, utf16le, writeAtom, writeContainer };

package/dist/record/write.d.ts

@@ -0,0 +1,17 @@
+//#region src/record/write.d.ts
+declare function concatBytes(...parts: readonly Uint8Array<ArrayBuffer>[]): Uint8Array<ArrayBuffer>;
+declare function u8(value: number): Uint8Array<ArrayBuffer>;
+declare function u16le(value: number): Uint8Array<ArrayBuffer>;
+declare function i16le(value: number): Uint8Array<ArrayBuffer>;
+declare function u32le(value: number): Uint8Array<ArrayBuffer>;
+declare function i32le(value: number): Uint8Array<ArrayBuffer>;
+declare function asciiBytes(text: string): Uint8Array<ArrayBuffer>;
+declare function utf16le(text: string): Uint8Array<ArrayBuffer>;
+interface RecordWriteOptions {
+  readonly recVer?: number;
+  readonly recInstance?: number;
+}
+declare function writeAtom(recType: number, data: Uint8Array<ArrayBuffer>, options?: RecordWriteOptions): Uint8Array<ArrayBuffer>;
+declare function writeContainer(recType: number, children: readonly Uint8Array<ArrayBuffer>[], options?: Omit<RecordWriteOptions, "recVer">): Uint8Array<ArrayBuffer>;
+//#endregion
+export { RecordWriteOptions, asciiBytes, concatBytes, i16le, i32le, u16le, u32le, u8, utf16le, writeAtom, writeContainer };

package/dist/record/write.js

@@ -0,0 +1,65 @@
+import "./header.js";
+//#region src/record/write.ts
+function concatBytes(...parts) {
+	const total = parts.reduce((sum, part) => sum + part.length, 0);
+	const out = new Uint8Array(total);
+	let at = 0;
+	for (const part of parts) {
+		out.set(part, at);
+		at += part.length;
+	}
+	return out;
+}
+function u8(value) {
+	return new Uint8Array([value & 255]);
+}
+function u16le(value) {
+	const bytes = /* @__PURE__ */ new Uint8Array(2);
+	new DataView(bytes.buffer).setUint16(0, value, true);
+	return bytes;
+}
+function i16le(value) {
+	const bytes = /* @__PURE__ */ new Uint8Array(2);
+	new DataView(bytes.buffer).setInt16(0, value, true);
+	return bytes;
+}
+function u32le(value) {
+	const bytes = /* @__PURE__ */ new Uint8Array(4);
+	new DataView(bytes.buffer).setUint32(0, value, true);
+	return bytes;
+}
+function i32le(value) {
+	const bytes = /* @__PURE__ */ new Uint8Array(4);
+	new DataView(bytes.buffer).setInt32(0, value, true);
+	return bytes;
+}
+function asciiBytes(text) {
+	const bytes = new Uint8Array(text.length);
+	for (let i = 0; i < text.length; i++) bytes[i] = text.charCodeAt(i);
+	return bytes;
+}
+function utf16le(text) {
+	const bytes = new Uint8Array(text.length * 2);
+	const view = new DataView(bytes.buffer);
+	for (let i = 0; i < text.length; i++) view.setUint16(i * 2, text.charCodeAt(i), true);
+	return bytes;
+}
+function recordHeaderBytes(recVer, recInstance, recType, recLen) {
+	const bytes = /* @__PURE__ */ new Uint8Array(8);
+	const view = new DataView(bytes.buffer);
+	view.setUint16(0, recVer & 15 | (recInstance & 4095) << 4, true);
+	view.setUint16(2, recType, true);
+	view.setUint32(4, recLen, true);
+	return bytes;
+}
+function writeAtom(recType, data, options = {}) {
+	const { recVer = 0, recInstance = 0 } = options;
+	return concatBytes(recordHeaderBytes(recVer, recInstance, recType, data.length), data);
+}
+function writeContainer(recType, children, options = {}) {
+	const { recInstance = 0 } = options;
+	const body = concatBytes(...children);
+	return concatBytes(recordHeaderBytes(15, recInstance, recType, body.length), body);
+}
+//#endregion
+export { asciiBytes, concatBytes, i16le, i32le, u16le, u32le, u8, utf16le, writeAtom, writeContainer };

package/dist/stream/current-user-write.cjs

@@ -0,0 +1,13 @@
+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_stream_current_user = require("./current-user.cjs");
+//#region src/stream/current-user-write.ts
+const PRODUCER_USER_NAME = "documents.js";
+const REL_VERSION = 8;
+function writeCurrentUserAtom(offsetToCurrentEdit) {
+	const ansiUserName = require_record_write.asciiBytes(PRODUCER_USER_NAME);
+	return require_record_write.writeAtom(require_record_types.RT_CurrentUserAtom, require_record_write.concatBytes(require_record_write.u32le(20), require_record_write.u32le(require_stream_current_user.CURRENT_USER_HEADER_TOKEN_PLAIN), require_record_write.u32le(offsetToCurrentEdit), require_record_write.u16le(ansiUserName.length), require_record_write.u16le(require_stream_current_user.CURRENT_USER_DOC_FILE_VERSION), require_record_write.u8(3), require_record_write.u8(0), require_record_write.u16le(0), ansiUserName, require_record_write.u32le(REL_VERSION), require_record_write.utf16le(PRODUCER_USER_NAME)));
+}
+//#endregion
+exports.writeCurrentUserAtom = writeCurrentUserAtom;

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

@@ -0,0 +1,4 @@
+//#region src/stream/current-user-write.d.ts
+declare function writeCurrentUserAtom(offsetToCurrentEdit: number): Uint8Array<ArrayBuffer>;
+//#endregion
+export { writeCurrentUserAtom };

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

@@ -0,0 +1,4 @@
+//#region src/stream/current-user-write.d.ts
+declare function writeCurrentUserAtom(offsetToCurrentEdit: number): Uint8Array<ArrayBuffer>;
+//#endregion
+export { writeCurrentUserAtom };

package/dist/stream/current-user-write.js

@@ -0,0 +1,12 @@
+import { RT_CurrentUserAtom } from "../record/types.js";
+import { asciiBytes, concatBytes, u16le, u32le, u8, utf16le, writeAtom } from "../record/write.js";
+import { CURRENT_USER_DOC_FILE_VERSION, CURRENT_USER_HEADER_TOKEN_PLAIN } from "./current-user.js";
+//#region src/stream/current-user-write.ts
+const PRODUCER_USER_NAME = "documents.js";
+const REL_VERSION = 8;
+function writeCurrentUserAtom(offsetToCurrentEdit) {
+	const ansiUserName = asciiBytes(PRODUCER_USER_NAME);
+	return writeAtom(RT_CurrentUserAtom, concatBytes(u32le(20), u32le(CURRENT_USER_HEADER_TOKEN_PLAIN), u32le(offsetToCurrentEdit), u16le(ansiUserName.length), u16le(CURRENT_USER_DOC_FILE_VERSION), u8(3), u8(0), u16le(0), ansiUserName, u32le(REL_VERSION), utf16le(PRODUCER_USER_NAME)));
+}
+//#endregion
+export { writeCurrentUserAtom };

package/dist/stream/current-user.cjs

@@ -22,21 +22,21 @@ function readCurrentUserAtom(streamBytes) {
 	const record = require_record_tree.readRecordAt(streamBytes, 0);
 	if (record.header.recType !== 4086) throw new require_errors.PptFormatError(`Current User stream begins with record type 0x${record.header.recType.toString(16)}, not RT_CurrentUserAtom (0x${require_record_types.RT_CurrentUserAtom.toString(16)})`);
 	const { data } = record;
-	if (data.length < CURRENT_USER_FIXED_SIZE) throw new require_errors.PptFormatError(`CurrentUserAtom carries ${data.length} bytes of data, fewer than the ${CURRENT_USER_FIXED_SIZE}-byte fixed portion the record requires`);
+	if (data.length < 20) throw new require_errors.PptFormatError(`CurrentUserAtom carries ${data.length} bytes of data, fewer than the 20-byte fixed portion the record requires`);
 	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
 	const size = view.getUint32(0, true);
-	if (size !== CURRENT_USER_FIXED_SIZE) throw new require_errors.PptFormatError(`CurrentUserAtom size field is 0x${size.toString(16)}, not the mandated 0x${CURRENT_USER_FIXED_SIZE.toString(16)}`);
+	if (size !== 20) throw new require_errors.PptFormatError(`CurrentUserAtom size field is 0x${size.toString(16)}, not the mandated 0x${20 .toString(16)}`);
 	const headerToken = view.getUint32(4, true);
 	if (headerToken !== 3817979999 && headerToken !== 4090610911) throw new require_errors.PptFormatError(`CurrentUserAtom headerToken is 0x${headerToken.toString(16)}, neither the plaintext 0x${CURRENT_USER_HEADER_TOKEN_PLAIN.toString(16)} nor the encrypted 0x${CURRENT_USER_HEADER_TOKEN_ENCRYPTED.toString(16)}`);
 	const offsetToCurrentEdit = view.getUint32(8, true);
 	const lenUserName = view.getUint16(12, true);
 	const docFileVersion = view.getUint16(14, true);
-	if (docFileVersion !== CURRENT_USER_DOC_FILE_VERSION) throw new require_errors.PptFormatError(`CurrentUserAtom docFileVersion is 0x${docFileVersion.toString(16)}, not the mandated 0x${CURRENT_USER_DOC_FILE_VERSION.toString(16)}`);
-	const ansiEnd = CURRENT_USER_FIXED_SIZE + lenUserName;
+	if (docFileVersion !== 1012) throw new require_errors.PptFormatError(`CurrentUserAtom docFileVersion is 0x${docFileVersion.toString(16)}, not the mandated 0x${CURRENT_USER_DOC_FILE_VERSION.toString(16)}`);
+	const ansiEnd = 20 + lenUserName;
 	if (ansiEnd > data.length) throw new require_errors.PptFormatError(`CurrentUserAtom declares a ${lenUserName}-byte ansiUserName that runs past the record's ${data.length} bytes`);
 	const unicodeStart = ansiEnd + 4;
 	const unicodeEnd = unicodeStart + lenUserName * 2;
-	const userName = unicodeEnd <= data.length && lenUserName > 0 ? decodeUtf16Le(data.subarray(unicodeStart, unicodeEnd)) : decodeAnsi(data.subarray(CURRENT_USER_FIXED_SIZE, ansiEnd));
+	const userName = unicodeEnd <= data.length && lenUserName > 0 ? decodeUtf16Le(data.subarray(unicodeStart, unicodeEnd)) : decodeAnsi(data.subarray(20, ansiEnd));
 	return {
 		offsetToCurrentEdit,
 		encrypted: headerToken === CURRENT_USER_HEADER_TOKEN_ENCRYPTED,
@@ -44,6 +44,8 @@ function readCurrentUserAtom(streamBytes) {
 	};
 }
 //#endregion
+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.readCurrentUserAtom = readCurrentUserAtom;

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

@@ -1,6 +1,8 @@
 //#region src/stream/current-user.d.ts
 declare const CURRENT_USER_HEADER_TOKEN_PLAIN = 3817979999;
 declare const CURRENT_USER_HEADER_TOKEN_ENCRYPTED = 4090610911;
+declare const CURRENT_USER_FIXED_SIZE = 20;
+declare const CURRENT_USER_DOC_FILE_VERSION = 1012;
 interface CurrentUser {
   readonly offsetToCurrentEdit: number;
   readonly encrypted: boolean;
@@ -8,4 +10,4 @@ interface CurrentUser {
 }
 declare function readCurrentUserAtom(streamBytes: Uint8Array<ArrayBuffer>): CurrentUser;
 //#endregion
-export { 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, readCurrentUserAtom };

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

@@ -1,6 +1,8 @@
 //#region src/stream/current-user.d.ts
 declare const CURRENT_USER_HEADER_TOKEN_PLAIN = 3817979999;
 declare const CURRENT_USER_HEADER_TOKEN_ENCRYPTED = 4090610911;
+declare const CURRENT_USER_FIXED_SIZE = 20;
+declare const CURRENT_USER_DOC_FILE_VERSION = 1012;
 interface CurrentUser {
   readonly offsetToCurrentEdit: number;
   readonly encrypted: boolean;
@@ -8,4 +10,4 @@ interface CurrentUser {
 }
 declare function readCurrentUserAtom(streamBytes: Uint8Array<ArrayBuffer>): CurrentUser;
 //#endregion
-export { 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, readCurrentUserAtom };

package/dist/stream/current-user.js

@@ -21,21 +21,21 @@ function readCurrentUserAtom(streamBytes) {
 	const record = readRecordAt(streamBytes, 0);
 	if (record.header.recType !== 4086) throw new PptFormatError(`Current User stream begins with record type 0x${record.header.recType.toString(16)}, not RT_CurrentUserAtom (0x${RT_CurrentUserAtom.toString(16)})`);
 	const { data } = record;
-	if (data.length < CURRENT_USER_FIXED_SIZE) throw new PptFormatError(`CurrentUserAtom carries ${data.length} bytes of data, fewer than the ${CURRENT_USER_FIXED_SIZE}-byte fixed portion the record requires`);
+	if (data.length < 20) throw new PptFormatError(`CurrentUserAtom carries ${data.length} bytes of data, fewer than the 20-byte fixed portion the record requires`);
 	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
 	const size = view.getUint32(0, true);
-	if (size !== CURRENT_USER_FIXED_SIZE) throw new PptFormatError(`CurrentUserAtom size field is 0x${size.toString(16)}, not the mandated 0x${CURRENT_USER_FIXED_SIZE.toString(16)}`);
+	if (size !== 20) throw new PptFormatError(`CurrentUserAtom size field is 0x${size.toString(16)}, not the mandated 0x${20 .toString(16)}`);
 	const headerToken = view.getUint32(4, true);
 	if (headerToken !== 3817979999 && headerToken !== 4090610911) throw new PptFormatError(`CurrentUserAtom headerToken is 0x${headerToken.toString(16)}, neither the plaintext 0x${CURRENT_USER_HEADER_TOKEN_PLAIN.toString(16)} nor the encrypted 0x${CURRENT_USER_HEADER_TOKEN_ENCRYPTED.toString(16)}`);
 	const offsetToCurrentEdit = view.getUint32(8, true);
 	const lenUserName = view.getUint16(12, true);
 	const docFileVersion = view.getUint16(14, true);
-	if (docFileVersion !== CURRENT_USER_DOC_FILE_VERSION) throw new PptFormatError(`CurrentUserAtom docFileVersion is 0x${docFileVersion.toString(16)}, not the mandated 0x${CURRENT_USER_DOC_FILE_VERSION.toString(16)}`);
-	const ansiEnd = CURRENT_USER_FIXED_SIZE + lenUserName;
+	if (docFileVersion !== 1012) throw new PptFormatError(`CurrentUserAtom docFileVersion is 0x${docFileVersion.toString(16)}, not the mandated 0x${CURRENT_USER_DOC_FILE_VERSION.toString(16)}`);
+	const ansiEnd = 20 + lenUserName;
 	if (ansiEnd > data.length) throw new PptFormatError(`CurrentUserAtom declares a ${lenUserName}-byte ansiUserName that runs past the record's ${data.length} bytes`);
 	const unicodeStart = ansiEnd + 4;
 	const unicodeEnd = unicodeStart + lenUserName * 2;
-	const userName = unicodeEnd <= data.length && lenUserName > 0 ? decodeUtf16Le(data.subarray(unicodeStart, unicodeEnd)) : decodeAnsi(data.subarray(CURRENT_USER_FIXED_SIZE, ansiEnd));
+	const userName = unicodeEnd <= data.length && lenUserName > 0 ? decodeUtf16Le(data.subarray(unicodeStart, unicodeEnd)) : decodeAnsi(data.subarray(20, ansiEnd));
 	return {
 		offsetToCurrentEdit,
 		encrypted: headerToken === CURRENT_USER_HEADER_TOKEN_ENCRYPTED,
@@ -43,4 +43,4 @@ function readCurrentUserAtom(streamBytes) {
 	};
 }
 //#endregion
-export { 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, readCurrentUserAtom };

package/dist/stream/persist-write.cjs

@@ -0,0 +1,14 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_record_types = require("../record/types.cjs");
+const require_record_write = require("../record/write.cjs");
+//#region src/stream/persist-write.ts
+function writePersistDirectoryAtom(entries) {
+	const data = require_record_write.concatBytes(...entries.map((entry) => require_record_write.concatBytes(require_record_write.u32le(entry.persistId & 1048575 | 1 << 20), require_record_write.u32le(entry.offset))));
+	return require_record_write.writeAtom(require_record_types.RT_PersistDirectoryAtom, data);
+}
+function writeUserEditAtom(fields) {
+	return require_record_write.writeAtom(require_record_types.RT_UserEditAtom, require_record_write.concatBytes(require_record_write.u32le(fields.lastSlideIdRef), require_record_write.u16le(0), require_record_write.u8(0), require_record_write.u8(3), require_record_write.u32le(fields.offsetLastEdit), require_record_write.u32le(fields.offsetPersistDirectory), require_record_write.u32le(fields.docPersistIdRef), require_record_write.u32le(fields.persistIdSeed), require_record_write.u16le(0), require_record_write.u16le(0)));
+}
+//#endregion
+exports.writePersistDirectoryAtom = writePersistDirectoryAtom;
+exports.writeUserEditAtom = writeUserEditAtom;

package/dist/stream/persist-write.d.cts

@@ -0,0 +1,16 @@
+//#region src/stream/persist-write.d.ts
+interface PersistDirectoryEntryToWrite {
+  readonly persistId: number;
+  readonly offset: number;
+}
+declare function writePersistDirectoryAtom(entries: readonly PersistDirectoryEntryToWrite[]): Uint8Array<ArrayBuffer>;
+interface UserEditFields {
+  readonly lastSlideIdRef: number;
+  readonly offsetLastEdit: number;
+  readonly offsetPersistDirectory: number;
+  readonly docPersistIdRef: number;
+  readonly persistIdSeed: number;
+}
+declare function writeUserEditAtom(fields: UserEditFields): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PersistDirectoryEntryToWrite, UserEditFields, writePersistDirectoryAtom, writeUserEditAtom };

package/dist/stream/persist-write.d.ts

@@ -0,0 +1,16 @@
+//#region src/stream/persist-write.d.ts
+interface PersistDirectoryEntryToWrite {
+  readonly persistId: number;
+  readonly offset: number;
+}
+declare function writePersistDirectoryAtom(entries: readonly PersistDirectoryEntryToWrite[]): Uint8Array<ArrayBuffer>;
+interface UserEditFields {
+  readonly lastSlideIdRef: number;
+  readonly offsetLastEdit: number;
+  readonly offsetPersistDirectory: number;
+  readonly docPersistIdRef: number;
+  readonly persistIdSeed: number;
+}
+declare function writeUserEditAtom(fields: UserEditFields): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PersistDirectoryEntryToWrite, UserEditFields, writePersistDirectoryAtom, writeUserEditAtom };

package/dist/stream/persist-write.js

@@ -0,0 +1,12 @@
+import { RT_PersistDirectoryAtom, RT_UserEditAtom } from "../record/types.js";
+import { concatBytes, u16le, u32le, u8, writeAtom } from "../record/write.js";
+//#region src/stream/persist-write.ts
+function writePersistDirectoryAtom(entries) {
+	const data = concatBytes(...entries.map((entry) => concatBytes(u32le(entry.persistId & 1048575 | 1 << 20), u32le(entry.offset))));
+	return writeAtom(RT_PersistDirectoryAtom, data);
+}
+function writeUserEditAtom(fields) {
+	return writeAtom(RT_UserEditAtom, concatBytes(u32le(fields.lastSlideIdRef), u16le(0), u8(0), u8(3), u32le(fields.offsetLastEdit), u32le(fields.offsetPersistDirectory), u32le(fields.docPersistIdRef), u32le(fields.persistIdSeed), u16le(0), u16le(0)));
+}
+//#endregion
+export { writePersistDirectoryAtom, writeUserEditAtom };