ppt-codec 0.0.0 → 1.0.0

package/dist/read.cjs

@@ -0,0 +1,119 @@
+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_text_atoms = require("./text/atoms.cjs");
+const require_text_style = require("./text/style.cjs");
+const require_content = require("./content.cjs");
+const require_document_document_atom = require("./document/document-atom.cjs");
+const require_document_fonts = require("./document/fonts.cjs");
+const require_document_slide_list = require("./document/slide-list.cjs");
+const require_drawing_shapes = require("./drawing/shapes.cjs");
+const require_stream_current_user = require("./stream/current-user.cjs");
+const require_stream_persist = require("./stream/persist.cjs");
+const require_units = require("./units.cjs");
+let archive_codec = require("archive-codec");
+let document_schema_js = require("document-schema.js");
+//#region src/read.ts
+const CURRENT_USER_STREAM = "Current User";
+const POWERPOINT_DOCUMENT_STREAM = "PowerPoint Document";
+const DEFAULT_INSET_LEFT_RIGHT_PT = 7.2;
+const DEFAULT_INSET_TOP_BOTTOM_PT = 3.6;
+const NO_STYLE = {
+	paragraphRuns: [],
+	characterRuns: []
+};
+function requireStream(streams, name) {
+	const stream = streams.find((candidate) => candidate.path === name);
+	if (stream === void 0) throw new require_errors.PptFormatError(`compound file has no "${name}" stream, which [MS-PPT] requires of every PowerPoint binary document`);
+	return stream.bytes;
+}
+function textRecordsFor(clientTextbox, persist) {
+	const children = require_record_tree.childRecords(clientTextbox);
+	const outlineRef = require_record_tree.findChild(children, require_record_types.RT_OutlineTextRefAtom);
+	if (outlineRef === void 0) return children;
+	if (outlineRef.data.length < 4) throw new require_errors.PptFormatError(`OutlineTextRefAtom at offset ${outlineRef.offset} carries ${outlineRef.data.length} bytes, fewer than the 4 its index field needs`);
+	const index = new DataView(outlineRef.data.buffer, outlineRef.data.byteOffset, outlineRef.data.byteLength).getInt32(0, true);
+	const outlineText = persist.texts[index];
+	if (outlineText === void 0) throw new require_errors.PptFormatError(`OutlineTextRefAtom references text ${index} of slide ${persist.slideId}, which has only ${persist.texts.length} texts in the slide list`);
+	return outlineText.records;
+}
+function blocksFor(clientTextbox, persist, fontNames) {
+	if (clientTextbox === void 0) return [];
+	const records = textRecordsFor(clientTextbox, persist);
+	const text = require_text_atoms.readTextBody(records);
+	if (text === void 0) return [];
+	const styleRecord = require_record_tree.findChild(records, require_record_types.RT_StyleTextPropAtom);
+	const style = styleRecord === void 0 ? NO_STYLE : require_text_style.readStyleTextPropAtom(styleRecord, require_text_atoms.characterCountOf(text));
+	return require_content.buildParagraphs(text, style, fontNames);
+}
+function readSlide(streamBytes, directory, persist, size, fontNames) {
+	const slideContainer = require_stream_persist.resolvePersistObject(streamBytes, directory, persist.persistIdRef, `SlidePersistAtom for slide ${persist.slideId}`);
+	if (slideContainer.header.recType !== 1006) throw new require_errors.PptFormatError(`persist object ${persist.persistIdRef} is record type 0x${slideContainer.header.recType.toString(16)}, not the RT_Slide (0x${require_record_types.RT_Slide.toString(16)}) its SlidePersistAtom promised`);
+	const drawing = require_record_tree.findChild(require_record_tree.childRecords(slideContainer), require_record_types.RT_Drawing);
+	const shapes = [];
+	for (const shape of drawing === void 0 ? [] : require_drawing_shapes.readDrawingShapes(drawing)) {
+		if (shape.anchor === void 0) continue;
+		const left = require_units.masterUnitsToPoints(shape.anchor.left);
+		const top = require_units.masterUnitsToPoints(shape.anchor.top);
+		shapes.push({
+			frame: {
+				xPt: left,
+				yPt: top,
+				widthPt: Math.max(0, require_units.masterUnitsToPoints(shape.anchor.right) - left),
+				heightPt: Math.max(0, require_units.masterUnitsToPoints(shape.anchor.bottom) - top)
+			},
+			insetLeftPt: DEFAULT_INSET_LEFT_RIGHT_PT,
+			insetTopPt: DEFAULT_INSET_TOP_BOTTOM_PT,
+			insetRightPt: DEFAULT_INSET_LEFT_RIGHT_PT,
+			insetBottomPt: DEFAULT_INSET_TOP_BOTTOM_PT,
+			blocks: blocksFor(shape.clientTextbox, persist, fontNames)
+		});
+	}
+	return {
+		size,
+		shapes,
+		notes: ""
+	};
+}
+function readPptStreams(currentUserStream, powerPointDocumentStream) {
+	const currentUser = require_stream_current_user.readCurrentUserAtom(currentUserStream);
+	if (currentUser.encrypted) throw new require_errors.PptEncryptedError("the CurrentUserAtom's headerToken marks this document as encrypted, and this package does not implement [MS-PPT]'s encryption");
+	const { directory, currentEdit } = require_stream_persist.buildPersistDirectory(powerPointDocumentStream, currentUser.offsetToCurrentEdit);
+	const documentContainer = require_stream_persist.resolvePersistObject(powerPointDocumentStream, directory, currentEdit.docPersistIdRef, "UserEditAtom.docPersistIdRef");
+	if (documentContainer.header.recType !== 1e3) throw new require_errors.PptFormatError(`the document persist object is record type 0x${documentContainer.header.recType.toString(16)}, not RT_Document (0x${require_record_types.RT_Document.toString(16)})`);
+	const children = require_record_tree.childRecords(documentContainer);
+	const documentAtomRecord = require_record_tree.findChild(children, require_record_types.RT_DocumentAtom);
+	if (documentAtomRecord === void 0) throw new require_errors.PptFormatError("the DocumentContainer has no DocumentAtom, so the presentation's slide size is unknown");
+	const documentAtom = require_document_document_atom.readDocumentAtom(documentAtomRecord);
+	const size = {
+		widthPt: require_units.masterUnitsToPoints(documentAtom.slideSize.x),
+		heightPt: require_units.masterUnitsToPoints(documentAtom.slideSize.y)
+	};
+	const environment = require_record_tree.findChild(children, require_record_types.RT_Environment);
+	const fontNames = environment === void 0 ? [] : require_document_fonts.readFontNames(environment);
+	const slideList = children.find((record) => record.header.recType === 4080 && record.header.recInstance === 0);
+	return {
+		metadata: {},
+		slides: (slideList === void 0 ? [] : require_document_slide_list.readSlideListWithText(slideList)).map((persist) => readSlide(powerPointDocumentStream, directory, persist, size, fontNames))
+	};
+}
+function readPptContent(bytes) {
+	const streams = (0, archive_codec.readCompoundFile)(bytes);
+	return readPptStreams(requireStream(streams, CURRENT_USER_STREAM), requireStream(streams, POWERPOINT_DOCUMENT_STREAM));
+}
+function readPpt(bytes) {
+	const { metadata, slides } = readPptContent(bytes);
+	const document = {
+		kind: "presentation",
+		metadata,
+		slides: [...slides]
+	};
+	return (0, document_schema_js.assembleTree)(document);
+}
+//#endregion
+exports.CURRENT_USER_STREAM = CURRENT_USER_STREAM;
+exports.POWERPOINT_DOCUMENT_STREAM = POWERPOINT_DOCUMENT_STREAM;
+exports.readPpt = readPpt;
+exports.readPptContent = readPptContent;
+exports.readPptStreams = readPptStreams;

package/dist/read.d.cts

@@ -0,0 +1,13 @@
+import { 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";
+interface PptDocument {
+  readonly metadata: LayoutMetadata;
+  readonly slides: readonly ContentSlide[];
+}
+declare function readPptStreams(currentUserStream: Uint8Array<ArrayBuffer>, powerPointDocumentStream: Uint8Array<ArrayBuffer>): PptDocument;
+declare function readPptContent(bytes: Uint8Array<ArrayBuffer>): PptDocument;
+declare function readPpt(bytes: Uint8Array<ArrayBuffer>): DocumentTree;
+//#endregion
+export { CURRENT_USER_STREAM, POWERPOINT_DOCUMENT_STREAM, PptDocument, readPpt, readPptContent, readPptStreams };

package/dist/read.d.ts

@@ -0,0 +1,13 @@
+import { 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";
+interface PptDocument {
+  readonly metadata: LayoutMetadata;
+  readonly slides: readonly ContentSlide[];
+}
+declare function readPptStreams(currentUserStream: Uint8Array<ArrayBuffer>, powerPointDocumentStream: Uint8Array<ArrayBuffer>): PptDocument;
+declare function readPptContent(bytes: Uint8Array<ArrayBuffer>): PptDocument;
+declare function readPpt(bytes: Uint8Array<ArrayBuffer>): DocumentTree;
+//#endregion
+export { CURRENT_USER_STREAM, POWERPOINT_DOCUMENT_STREAM, PptDocument, readPpt, readPptContent, readPptStreams };

package/dist/read.js

@@ -0,0 +1,114 @@
+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 { 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 { readDrawingShapes } from "./drawing/shapes.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 { assembleTree } from "document-schema.js";
+//#region src/read.ts
+const CURRENT_USER_STREAM = "Current User";
+const POWERPOINT_DOCUMENT_STREAM = "PowerPoint Document";
+const DEFAULT_INSET_LEFT_RIGHT_PT = 7.2;
+const DEFAULT_INSET_TOP_BOTTOM_PT = 3.6;
+const NO_STYLE = {
+	paragraphRuns: [],
+	characterRuns: []
+};
+function requireStream(streams, name) {
+	const stream = streams.find((candidate) => candidate.path === name);
+	if (stream === void 0) throw new PptFormatError(`compound file has no "${name}" stream, which [MS-PPT] requires of every PowerPoint binary document`);
+	return stream.bytes;
+}
+function textRecordsFor(clientTextbox, persist) {
+	const children = childRecords(clientTextbox);
+	const outlineRef = findChild(children, RT_OutlineTextRefAtom);
+	if (outlineRef === void 0) return children;
+	if (outlineRef.data.length < 4) throw new PptFormatError(`OutlineTextRefAtom at offset ${outlineRef.offset} carries ${outlineRef.data.length} bytes, fewer than the 4 its index field needs`);
+	const index = new DataView(outlineRef.data.buffer, outlineRef.data.byteOffset, outlineRef.data.byteLength).getInt32(0, true);
+	const outlineText = persist.texts[index];
+	if (outlineText === void 0) throw new PptFormatError(`OutlineTextRefAtom references text ${index} of slide ${persist.slideId}, which has only ${persist.texts.length} texts in the slide list`);
+	return outlineText.records;
+}
+function blocksFor(clientTextbox, persist, fontNames) {
+	if (clientTextbox === void 0) return [];
+	const records = textRecordsFor(clientTextbox, persist);
+	const text = readTextBody(records);
+	if (text === void 0) return [];
+	const styleRecord = findChild(records, RT_StyleTextPropAtom);
+	const style = styleRecord === void 0 ? NO_STYLE : readStyleTextPropAtom(styleRecord, characterCountOf(text));
+	return buildParagraphs(text, style, fontNames);
+}
+function readSlide(streamBytes, directory, persist, size, fontNames) {
+	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);
+	const shapes = [];
+	for (const shape of drawing === void 0 ? [] : readDrawingShapes(drawing)) {
+		if (shape.anchor === void 0) continue;
+		const left = masterUnitsToPoints(shape.anchor.left);
+		const top = masterUnitsToPoints(shape.anchor.top);
+		shapes.push({
+			frame: {
+				xPt: left,
+				yPt: top,
+				widthPt: Math.max(0, masterUnitsToPoints(shape.anchor.right) - left),
+				heightPt: Math.max(0, masterUnitsToPoints(shape.anchor.bottom) - top)
+			},
+			insetLeftPt: DEFAULT_INSET_LEFT_RIGHT_PT,
+			insetTopPt: DEFAULT_INSET_TOP_BOTTOM_PT,
+			insetRightPt: DEFAULT_INSET_LEFT_RIGHT_PT,
+			insetBottomPt: DEFAULT_INSET_TOP_BOTTOM_PT,
+			blocks: blocksFor(shape.clientTextbox, persist, fontNames)
+		});
+	}
+	return {
+		size,
+		shapes,
+		notes: ""
+	};
+}
+function readPptStreams(currentUserStream, powerPointDocumentStream) {
+	const currentUser = readCurrentUserAtom(currentUserStream);
+	if (currentUser.encrypted) throw new PptEncryptedError("the CurrentUserAtom's headerToken marks this document as encrypted, and this package does not implement [MS-PPT]'s encryption");
+	const { directory, currentEdit } = buildPersistDirectory(powerPointDocumentStream, currentUser.offsetToCurrentEdit);
+	const documentContainer = resolvePersistObject(powerPointDocumentStream, directory, currentEdit.docPersistIdRef, "UserEditAtom.docPersistIdRef");
+	if (documentContainer.header.recType !== 1e3) throw new PptFormatError(`the document persist object is record type 0x${documentContainer.header.recType.toString(16)}, not RT_Document (0x${RT_Document.toString(16)})`);
+	const children = childRecords(documentContainer);
+	const documentAtomRecord = findChild(children, RT_DocumentAtom);
+	if (documentAtomRecord === void 0) throw new PptFormatError("the DocumentContainer has no DocumentAtom, so the presentation's slide size is unknown");
+	const documentAtom = readDocumentAtom(documentAtomRecord);
+	const size = {
+		widthPt: masterUnitsToPoints(documentAtom.slideSize.x),
+		heightPt: masterUnitsToPoints(documentAtom.slideSize.y)
+	};
+	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);
+	return {
+		metadata: {},
+		slides: (slideList === void 0 ? [] : readSlideListWithText(slideList)).map((persist) => readSlide(powerPointDocumentStream, directory, persist, size, fontNames))
+	};
+}
+function readPptContent(bytes) {
+	const streams = readCompoundFile(bytes);
+	return readPptStreams(requireStream(streams, CURRENT_USER_STREAM), requireStream(streams, POWERPOINT_DOCUMENT_STREAM));
+}
+function readPpt(bytes) {
+	const { metadata, slides } = readPptContent(bytes);
+	const document = {
+		kind: "presentation",
+		metadata,
+		slides: [...slides]
+	};
+	return assembleTree(document);
+}
+//#endregion
+export { CURRENT_USER_STREAM, POWERPOINT_DOCUMENT_STREAM, readPpt, readPptContent, readPptStreams };

package/dist/record/header.cjs

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+//#region src/record/header.ts
+const RECORD_HEADER_SIZE = 8;
+const CONTAINER_REC_VER = 15;
+function readRecordHeader(bytes, offset) {
+	if (offset < 0) throw new require_errors.PptFormatError(`record header offset ${offset} is negative; a record cannot begin before the start of its stream`);
+	if (offset + 8 > bytes.length) throw new require_errors.PptFormatError(`record header at offset ${offset} needs 8 bytes but only ${bytes.length - offset} remain`);
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	const versionAndInstance = view.getUint16(offset, true);
+	return {
+		recVer: versionAndInstance & 15,
+		recInstance: versionAndInstance >> 4 & 4095,
+		recType: view.getUint16(offset + 2, true),
+		recLen: view.getUint32(offset + 4, true)
+	};
+}
+function isContainerRecord(header) {
+	return header.recVer === 15;
+}
+//#endregion
+exports.CONTAINER_REC_VER = CONTAINER_REC_VER;
+exports.RECORD_HEADER_SIZE = RECORD_HEADER_SIZE;
+exports.isContainerRecord = isContainerRecord;
+exports.readRecordHeader = readRecordHeader;

package/dist/record/header.d.cts

@@ -0,0 +1,2 @@
+import { a as readRecordHeader, i as isContainerRecord, n as RECORD_HEADER_SIZE, r as RecordHeader, t as CONTAINER_REC_VER } from "../header-C5eAd16_.cjs";
+export { CONTAINER_REC_VER, RECORD_HEADER_SIZE, RecordHeader, isContainerRecord, readRecordHeader };

package/dist/record/header.d.ts

@@ -0,0 +1,2 @@
+import { a as readRecordHeader, i as isContainerRecord, n as RECORD_HEADER_SIZE, r as RecordHeader, t as CONTAINER_REC_VER } from "../header-C5eAd16_.js";
+export { CONTAINER_REC_VER, RECORD_HEADER_SIZE, RecordHeader, isContainerRecord, readRecordHeader };

package/dist/record/header.js

@@ -0,0 +1,21 @@
+import { PptFormatError } from "../errors.js";
+//#region src/record/header.ts
+const RECORD_HEADER_SIZE = 8;
+const CONTAINER_REC_VER = 15;
+function readRecordHeader(bytes, offset) {
+	if (offset < 0) throw new PptFormatError(`record header offset ${offset} is negative; a record cannot begin before the start of its stream`);
+	if (offset + 8 > bytes.length) throw new PptFormatError(`record header at offset ${offset} needs 8 bytes but only ${bytes.length - offset} remain`);
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	const versionAndInstance = view.getUint16(offset, true);
+	return {
+		recVer: versionAndInstance & 15,
+		recInstance: versionAndInstance >> 4 & 4095,
+		recType: view.getUint16(offset + 2, true),
+		recLen: view.getUint32(offset + 4, true)
+	};
+}
+function isContainerRecord(header) {
+	return header.recVer === 15;
+}
+//#endregion
+export { CONTAINER_REC_VER, RECORD_HEADER_SIZE, isContainerRecord, readRecordHeader };

package/dist/record/tree.cjs

@@ -0,0 +1,55 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+const require_record_header = require("./header.cjs");
+//#region src/record/tree.ts
+function readRecordAt(bytes, offset) {
+	const header = require_record_header.readRecordHeader(bytes, offset);
+	const dataOffset = offset + 8;
+	const end = dataOffset + header.recLen;
+	if (end > bytes.length) throw new require_errors.PptFormatError(`record 0x${header.recType.toString(16)} at offset ${offset} declares ${header.recLen} bytes of data but only ${bytes.length - dataOffset} remain in the stream`);
+	return {
+		header,
+		offset,
+		dataOffset,
+		data: bytes.subarray(dataOffset, end),
+		stream: bytes
+	};
+}
+function readRecordSequence(bytes, start, end) {
+	const records = [];
+	let at = start;
+	while (at < end) {
+		if (at + 8 > end) throw new require_errors.PptFormatError(`record sequence ending at ${end} has a trailing ${end - at}-byte fragment, too short for the 8-byte record header`);
+		const record = readRecordAt(bytes, at);
+		const recordEnd = record.dataOffset + record.header.recLen;
+		if (recordEnd > end) throw new require_errors.PptFormatError(`record 0x${record.header.recType.toString(16)} at offset ${at} ends at ${recordEnd}, past the ${end} its container allows`);
+		records.push(record);
+		at = recordEnd;
+	}
+	return records;
+}
+function childRecords(record) {
+	if (!require_record_header.isContainerRecord(record.header)) return [];
+	return readRecordSequence(record.stream, record.dataOffset, record.dataOffset + record.header.recLen);
+}
+function findChild(records, recType) {
+	return records.find((record) => record.header.recType === recType);
+}
+function findChildren(records, recType) {
+	return records.filter((record) => record.header.recType === recType);
+}
+function findDescendants(root, recType) {
+	const found = [];
+	for (const child of childRecords(root)) {
+		if (child.header.recType === recType) found.push(child);
+		found.push(...findDescendants(child, recType));
+	}
+	return found;
+}
+//#endregion
+exports.childRecords = childRecords;
+exports.findChild = findChild;
+exports.findChildren = findChildren;
+exports.findDescendants = findDescendants;
+exports.readRecordAt = readRecordAt;
+exports.readRecordSequence = readRecordSequence;

package/dist/record/tree.d.cts

@@ -0,0 +1,2 @@
+import { a as findDescendants, i as findChildren, n as childRecords, o as readRecordAt, r as findChild, s as readRecordSequence, t as PptRecord } from "../tree-Du_LXAF0.cjs";
+export { PptRecord, childRecords, findChild, findChildren, findDescendants, readRecordAt, readRecordSequence };

package/dist/record/tree.d.ts

@@ -0,0 +1,2 @@
+import { a as findDescendants, i as findChildren, n as childRecords, o as readRecordAt, r as findChild, s as readRecordSequence, t as PptRecord } from "../tree-PMcPNgd-.js";
+export { PptRecord, childRecords, findChild, findChildren, findDescendants, readRecordAt, readRecordSequence };

package/dist/record/tree.js

@@ -0,0 +1,49 @@
+import { PptFormatError } from "../errors.js";
+import { isContainerRecord, readRecordHeader } from "./header.js";
+//#region src/record/tree.ts
+function readRecordAt(bytes, offset) {
+	const header = readRecordHeader(bytes, offset);
+	const dataOffset = offset + 8;
+	const end = dataOffset + header.recLen;
+	if (end > bytes.length) throw new PptFormatError(`record 0x${header.recType.toString(16)} at offset ${offset} declares ${header.recLen} bytes of data but only ${bytes.length - dataOffset} remain in the stream`);
+	return {
+		header,
+		offset,
+		dataOffset,
+		data: bytes.subarray(dataOffset, end),
+		stream: bytes
+	};
+}
+function readRecordSequence(bytes, start, end) {
+	const records = [];
+	let at = start;
+	while (at < end) {
+		if (at + 8 > end) throw new PptFormatError(`record sequence ending at ${end} has a trailing ${end - at}-byte fragment, too short for the 8-byte record header`);
+		const record = readRecordAt(bytes, at);
+		const recordEnd = record.dataOffset + record.header.recLen;
+		if (recordEnd > end) throw new PptFormatError(`record 0x${record.header.recType.toString(16)} at offset ${at} ends at ${recordEnd}, past the ${end} its container allows`);
+		records.push(record);
+		at = recordEnd;
+	}
+	return records;
+}
+function childRecords(record) {
+	if (!isContainerRecord(record.header)) return [];
+	return readRecordSequence(record.stream, record.dataOffset, record.dataOffset + record.header.recLen);
+}
+function findChild(records, recType) {
+	return records.find((record) => record.header.recType === recType);
+}
+function findChildren(records, recType) {
+	return records.filter((record) => record.header.recType === recType);
+}
+function findDescendants(root, recType) {
+	const found = [];
+	for (const child of childRecords(root)) {
+		if (child.header.recType === recType) found.push(child);
+		found.push(...findDescendants(child, recType));
+	}
+	return found;
+}
+//#endregion
+export { childRecords, findChild, findChildren, findDescendants, readRecordAt, readRecordSequence };

package/dist/record/types.cjs

@@ -0,0 +1,87 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/record/types.ts
+const RT_Document = 1e3;
+const RT_DocumentAtom = 1001;
+const RT_Slide = 1006;
+const RT_SlideAtom = 1007;
+const RT_Notes = 1008;
+const RT_Environment = 1010;
+const RT_SlidePersistAtom = 1011;
+const RT_MainMaster = 1016;
+const RT_ExternalObjectList = 1033;
+const RT_DrawingGroup = 1035;
+const RT_Drawing = 1036;
+const RT_List = 2e3;
+const RT_FontCollection = 2005;
+const RT_OutlineTextRefAtom = 3998;
+const RT_TextHeaderAtom = 3999;
+const RT_TextCharsAtom = 4e3;
+const RT_StyleTextPropAtom = 4001;
+const RT_MasterTextPropAtom = 4002;
+const RT_TextMasterStyleAtom = 4003;
+const RT_TextRulerAtom = 4006;
+const RT_TextBytesAtom = 4008;
+const RT_TextSpecialInfoDefaultAtom = 4009;
+const RT_TextSpecialInfoAtom = 4010;
+const RT_FontEntityAtom = 4023;
+const RT_CString = 4026;
+const RT_SlideListWithText = 4080;
+const RT_UserEditAtom = 4085;
+const RT_CurrentUserAtom = 4086;
+const RT_PersistDirectoryAtom = 6002;
+const RT_CryptSession10Container = 12052;
+const SLIDE_LIST_INSTANCE_SLIDES = 0;
+const SLIDE_LIST_INSTANCE_MASTERS = 1;
+const SLIDE_LIST_INSTANCE_NOTES = 2;
+const OfficeArtDgContainer = 61442;
+const OfficeArtSpgrContainer = 61443;
+const OfficeArtSpContainer = 61444;
+const OfficeArtFSPGR = 61449;
+const OfficeArtFSP = 61450;
+const OfficeArtFOPT = 61451;
+const OfficeArtClientTextbox = 61453;
+const OfficeArtChildAnchor = 61455;
+const OfficeArtClientAnchor = 61456;
+//#endregion
+exports.OfficeArtChildAnchor = OfficeArtChildAnchor;
+exports.OfficeArtClientAnchor = OfficeArtClientAnchor;
+exports.OfficeArtClientTextbox = OfficeArtClientTextbox;
+exports.OfficeArtDgContainer = OfficeArtDgContainer;
+exports.OfficeArtFOPT = OfficeArtFOPT;
+exports.OfficeArtFSP = OfficeArtFSP;
+exports.OfficeArtFSPGR = OfficeArtFSPGR;
+exports.OfficeArtSpContainer = OfficeArtSpContainer;
+exports.OfficeArtSpgrContainer = OfficeArtSpgrContainer;
+exports.RT_CString = RT_CString;
+exports.RT_CryptSession10Container = RT_CryptSession10Container;
+exports.RT_CurrentUserAtom = RT_CurrentUserAtom;
+exports.RT_Document = RT_Document;
+exports.RT_DocumentAtom = RT_DocumentAtom;
+exports.RT_Drawing = RT_Drawing;
+exports.RT_DrawingGroup = RT_DrawingGroup;
+exports.RT_Environment = RT_Environment;
+exports.RT_ExternalObjectList = RT_ExternalObjectList;
+exports.RT_FontCollection = RT_FontCollection;
+exports.RT_FontEntityAtom = RT_FontEntityAtom;
+exports.RT_List = RT_List;
+exports.RT_MainMaster = RT_MainMaster;
+exports.RT_MasterTextPropAtom = RT_MasterTextPropAtom;
+exports.RT_Notes = RT_Notes;
+exports.RT_OutlineTextRefAtom = RT_OutlineTextRefAtom;
+exports.RT_PersistDirectoryAtom = RT_PersistDirectoryAtom;
+exports.RT_Slide = RT_Slide;
+exports.RT_SlideAtom = RT_SlideAtom;
+exports.RT_SlideListWithText = RT_SlideListWithText;
+exports.RT_SlidePersistAtom = RT_SlidePersistAtom;
+exports.RT_StyleTextPropAtom = RT_StyleTextPropAtom;
+exports.RT_TextBytesAtom = RT_TextBytesAtom;
+exports.RT_TextCharsAtom = RT_TextCharsAtom;
+exports.RT_TextHeaderAtom = RT_TextHeaderAtom;
+exports.RT_TextMasterStyleAtom = RT_TextMasterStyleAtom;
+exports.RT_TextRulerAtom = RT_TextRulerAtom;
+exports.RT_TextSpecialInfoAtom = RT_TextSpecialInfoAtom;
+exports.RT_TextSpecialInfoDefaultAtom = RT_TextSpecialInfoDefaultAtom;
+exports.RT_UserEditAtom = RT_UserEditAtom;
+exports.SLIDE_LIST_INSTANCE_MASTERS = SLIDE_LIST_INSTANCE_MASTERS;
+exports.SLIDE_LIST_INSTANCE_NOTES = SLIDE_LIST_INSTANCE_NOTES;
+exports.SLIDE_LIST_INSTANCE_SLIDES = SLIDE_LIST_INSTANCE_SLIDES;

package/dist/record/types.d.cts

@@ -0,0 +1,45 @@
+//#region src/record/types.d.ts
+declare const RT_Document = 1000;
+declare const RT_DocumentAtom = 1001;
+declare const RT_Slide = 1006;
+declare const RT_SlideAtom = 1007;
+declare const RT_Notes = 1008;
+declare const RT_Environment = 1010;
+declare const RT_SlidePersistAtom = 1011;
+declare const RT_MainMaster = 1016;
+declare const RT_ExternalObjectList = 1033;
+declare const RT_DrawingGroup = 1035;
+declare const RT_Drawing = 1036;
+declare const RT_List = 2000;
+declare const RT_FontCollection = 2005;
+declare const RT_OutlineTextRefAtom = 3998;
+declare const RT_TextHeaderAtom = 3999;
+declare const RT_TextCharsAtom = 4000;
+declare const RT_StyleTextPropAtom = 4001;
+declare const RT_MasterTextPropAtom = 4002;
+declare const RT_TextMasterStyleAtom = 4003;
+declare const RT_TextRulerAtom = 4006;
+declare const RT_TextBytesAtom = 4008;
+declare const RT_TextSpecialInfoDefaultAtom = 4009;
+declare const RT_TextSpecialInfoAtom = 4010;
+declare const RT_FontEntityAtom = 4023;
+declare const RT_CString = 4026;
+declare const RT_SlideListWithText = 4080;
+declare const RT_UserEditAtom = 4085;
+declare const RT_CurrentUserAtom = 4086;
+declare const RT_PersistDirectoryAtom = 6002;
+declare const RT_CryptSession10Container = 12052;
+declare const SLIDE_LIST_INSTANCE_SLIDES = 0;
+declare const SLIDE_LIST_INSTANCE_MASTERS = 1;
+declare const SLIDE_LIST_INSTANCE_NOTES = 2;
+declare const OfficeArtDgContainer = 61442;
+declare const OfficeArtSpgrContainer = 61443;
+declare const OfficeArtSpContainer = 61444;
+declare const OfficeArtFSPGR = 61449;
+declare const OfficeArtFSP = 61450;
+declare const OfficeArtFOPT = 61451;
+declare const OfficeArtClientTextbox = 61453;
+declare const OfficeArtChildAnchor = 61455;
+declare const OfficeArtClientAnchor = 61456;
+//#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 };

package/dist/record/types.d.ts

@@ -0,0 +1,45 @@
+//#region src/record/types.d.ts
+declare const RT_Document = 1000;
+declare const RT_DocumentAtom = 1001;
+declare const RT_Slide = 1006;
+declare const RT_SlideAtom = 1007;
+declare const RT_Notes = 1008;
+declare const RT_Environment = 1010;
+declare const RT_SlidePersistAtom = 1011;
+declare const RT_MainMaster = 1016;
+declare const RT_ExternalObjectList = 1033;
+declare const RT_DrawingGroup = 1035;
+declare const RT_Drawing = 1036;
+declare const RT_List = 2000;
+declare const RT_FontCollection = 2005;
+declare const RT_OutlineTextRefAtom = 3998;
+declare const RT_TextHeaderAtom = 3999;
+declare const RT_TextCharsAtom = 4000;
+declare const RT_StyleTextPropAtom = 4001;
+declare const RT_MasterTextPropAtom = 4002;
+declare const RT_TextMasterStyleAtom = 4003;
+declare const RT_TextRulerAtom = 4006;
+declare const RT_TextBytesAtom = 4008;
+declare const RT_TextSpecialInfoDefaultAtom = 4009;
+declare const RT_TextSpecialInfoAtom = 4010;
+declare const RT_FontEntityAtom = 4023;
+declare const RT_CString = 4026;
+declare const RT_SlideListWithText = 4080;
+declare const RT_UserEditAtom = 4085;
+declare const RT_CurrentUserAtom = 4086;
+declare const RT_PersistDirectoryAtom = 6002;
+declare const RT_CryptSession10Container = 12052;
+declare const SLIDE_LIST_INSTANCE_SLIDES = 0;
+declare const SLIDE_LIST_INSTANCE_MASTERS = 1;
+declare const SLIDE_LIST_INSTANCE_NOTES = 2;
+declare const OfficeArtDgContainer = 61442;
+declare const OfficeArtSpgrContainer = 61443;
+declare const OfficeArtSpContainer = 61444;
+declare const OfficeArtFSPGR = 61449;
+declare const OfficeArtFSP = 61450;
+declare const OfficeArtFOPT = 61451;
+declare const OfficeArtClientTextbox = 61453;
+declare const OfficeArtChildAnchor = 61455;
+declare const OfficeArtClientAnchor = 61456;
+//#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 };

package/dist/record/types.js

@@ -0,0 +1,45 @@
+//#region src/record/types.ts
+const RT_Document = 1e3;
+const RT_DocumentAtom = 1001;
+const RT_Slide = 1006;
+const RT_SlideAtom = 1007;
+const RT_Notes = 1008;
+const RT_Environment = 1010;
+const RT_SlidePersistAtom = 1011;
+const RT_MainMaster = 1016;
+const RT_ExternalObjectList = 1033;
+const RT_DrawingGroup = 1035;
+const RT_Drawing = 1036;
+const RT_List = 2e3;
+const RT_FontCollection = 2005;
+const RT_OutlineTextRefAtom = 3998;
+const RT_TextHeaderAtom = 3999;
+const RT_TextCharsAtom = 4e3;
+const RT_StyleTextPropAtom = 4001;
+const RT_MasterTextPropAtom = 4002;
+const RT_TextMasterStyleAtom = 4003;
+const RT_TextRulerAtom = 4006;
+const RT_TextBytesAtom = 4008;
+const RT_TextSpecialInfoDefaultAtom = 4009;
+const RT_TextSpecialInfoAtom = 4010;
+const RT_FontEntityAtom = 4023;
+const RT_CString = 4026;
+const RT_SlideListWithText = 4080;
+const RT_UserEditAtom = 4085;
+const RT_CurrentUserAtom = 4086;
+const RT_PersistDirectoryAtom = 6002;
+const RT_CryptSession10Container = 12052;
+const SLIDE_LIST_INSTANCE_SLIDES = 0;
+const SLIDE_LIST_INSTANCE_MASTERS = 1;
+const SLIDE_LIST_INSTANCE_NOTES = 2;
+const OfficeArtDgContainer = 61442;
+const OfficeArtSpgrContainer = 61443;
+const OfficeArtSpContainer = 61444;
+const OfficeArtFSPGR = 61449;
+const OfficeArtFSP = 61450;
+const OfficeArtFOPT = 61451;
+const OfficeArtClientTextbox = 61453;
+const OfficeArtChildAnchor = 61455;
+const OfficeArtClientAnchor = 61456;
+//#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 };