ppt-codec 0.0.0 → 1.0.1

package/dist/stream/current-user.cjs

@@ -0,0 +1,49 @@
+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");
+//#region src/stream/current-user.ts
+const CURRENT_USER_HEADER_TOKEN_PLAIN = 3817979999;
+const CURRENT_USER_HEADER_TOKEN_ENCRYPTED = 4090610911;
+const CURRENT_USER_FIXED_SIZE = 20;
+const CURRENT_USER_DOC_FILE_VERSION = 1012;
+function decodeAnsi(bytes) {
+	let text = "";
+	for (const byte of bytes) text += String.fromCharCode(byte);
+	return text;
+}
+function decodeUtf16Le(bytes) {
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	let text = "";
+	for (let at = 0; at + 1 < bytes.length; at += 2) text += String.fromCharCode(view.getUint16(at, true));
+	return text;
+}
+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`);
+	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)}`);
+	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 (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));
+	return {
+		offsetToCurrentEdit,
+		encrypted: headerToken === CURRENT_USER_HEADER_TOKEN_ENCRYPTED,
+		userName
+	};
+}
+//#endregion
+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

@@ -0,0 +1,11 @@
+//#region src/stream/current-user.d.ts
+declare const CURRENT_USER_HEADER_TOKEN_PLAIN = 3817979999;
+declare const CURRENT_USER_HEADER_TOKEN_ENCRYPTED = 4090610911;
+interface CurrentUser {
+  readonly offsetToCurrentEdit: number;
+  readonly encrypted: boolean;
+  readonly userName: string;
+}
+declare function readCurrentUserAtom(streamBytes: Uint8Array<ArrayBuffer>): CurrentUser;
+//#endregion
+export { CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, CurrentUser, readCurrentUserAtom };

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

@@ -0,0 +1,11 @@
+//#region src/stream/current-user.d.ts
+declare const CURRENT_USER_HEADER_TOKEN_PLAIN = 3817979999;
+declare const CURRENT_USER_HEADER_TOKEN_ENCRYPTED = 4090610911;
+interface CurrentUser {
+  readonly offsetToCurrentEdit: number;
+  readonly encrypted: boolean;
+  readonly userName: string;
+}
+declare function readCurrentUserAtom(streamBytes: Uint8Array<ArrayBuffer>): CurrentUser;
+//#endregion
+export { CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, CurrentUser, readCurrentUserAtom };

package/dist/stream/current-user.js

@@ -0,0 +1,46 @@
+import { PptFormatError } from "../errors.js";
+import { readRecordAt } from "../record/tree.js";
+import { RT_CurrentUserAtom } from "../record/types.js";
+//#region src/stream/current-user.ts
+const CURRENT_USER_HEADER_TOKEN_PLAIN = 3817979999;
+const CURRENT_USER_HEADER_TOKEN_ENCRYPTED = 4090610911;
+const CURRENT_USER_FIXED_SIZE = 20;
+const CURRENT_USER_DOC_FILE_VERSION = 1012;
+function decodeAnsi(bytes) {
+	let text = "";
+	for (const byte of bytes) text += String.fromCharCode(byte);
+	return text;
+}
+function decodeUtf16Le(bytes) {
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	let text = "";
+	for (let at = 0; at + 1 < bytes.length; at += 2) text += String.fromCharCode(view.getUint16(at, true));
+	return text;
+}
+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`);
+	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)}`);
+	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 (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));
+	return {
+		offsetToCurrentEdit,
+		encrypted: headerToken === CURRENT_USER_HEADER_TOKEN_ENCRYPTED,
+		userName
+	};
+}
+//#endregion
+export { CURRENT_USER_HEADER_TOKEN_ENCRYPTED, CURRENT_USER_HEADER_TOKEN_PLAIN, readCurrentUserAtom };

package/dist/stream/persist.cjs

@@ -0,0 +1,71 @@
+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");
+//#region src/stream/persist.ts
+const USER_EDIT_LEN_WITHOUT_ENCRYPT_SESSION = 28;
+const USER_EDIT_LEN_WITH_ENCRYPT_SESSION = 32;
+function readUserEditAtom(record) {
+	if (record.header.recType !== 4085) throw new require_errors.PptFormatError(`expected RT_UserEditAtom (0x${require_record_types.RT_UserEditAtom.toString(16)}) at offset ${record.offset}, found record type 0x${record.header.recType.toString(16)}`);
+	const { recLen } = record.header;
+	if (recLen !== USER_EDIT_LEN_WITHOUT_ENCRYPT_SESSION && recLen !== USER_EDIT_LEN_WITH_ENCRYPT_SESSION) throw new require_errors.PptFormatError(`UserEditAtom at offset ${record.offset} declares recLen 0x${recLen.toString(16)}, neither 0x${USER_EDIT_LEN_WITHOUT_ENCRYPT_SESSION.toString(16)} nor 0x${USER_EDIT_LEN_WITH_ENCRYPT_SESSION.toString(16)}`);
+	const { data } = record;
+	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	return {
+		lastSlideIdRef: view.getUint32(0, true),
+		offsetLastEdit: view.getUint32(8, true),
+		offsetPersistDirectory: view.getUint32(12, true),
+		docPersistIdRef: view.getUint32(16, true),
+		persistIdSeed: view.getUint32(20, true),
+		encryptSessionPersistIdRef: recLen === USER_EDIT_LEN_WITH_ENCRYPT_SESSION ? view.getUint32(28, true) : void 0
+	};
+}
+function readPersistDirectoryAtom(record) {
+	if (record.header.recType !== 6002) throw new require_errors.PptFormatError(`expected RT_PersistDirectoryAtom (0x${require_record_types.RT_PersistDirectoryAtom.toString(16)}) at offset ${record.offset}, found record type 0x${record.header.recType.toString(16)}`);
+	const { data } = record;
+	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	const entries = /* @__PURE__ */ new Map();
+	let at = 0;
+	while (at < data.length) {
+		if (at + 4 > data.length) throw new require_errors.PptFormatError(`PersistDirectoryAtom at offset ${record.offset} has a ${data.length - at}-byte trailing fragment, too short for a PersistDirectoryEntry header word`);
+		const packed = view.getUint32(at, true);
+		const persistId = packed & 1048575;
+		const cPersist = packed >>> 20 & 4095;
+		if (cPersist === 0) throw new require_errors.PptFormatError(`PersistDirectoryEntry at offset ${record.dataOffset + at} declares cPersist 0x000, but the spec requires at least 0x001`);
+		at += 4;
+		const offsetsEnd = at + cPersist * 4;
+		if (offsetsEnd > data.length) throw new require_errors.PptFormatError(`PersistDirectoryEntry at offset ${record.dataOffset + at - 4} declares ${cPersist} offsets, which run past the atom's ${data.length} bytes`);
+		for (let i = 0; i < cPersist; i++) entries.set(persistId + i, view.getUint32(at + i * 4, true));
+		at = offsetsEnd;
+	}
+	return entries;
+}
+function buildPersistDirectory(streamBytes, offsetToCurrentEdit) {
+	const edits = [];
+	let at = offsetToCurrentEdit;
+	while (true) {
+		const edit = readUserEditAtom(require_record_tree.readRecordAt(streamBytes, at));
+		edits.push(edit);
+		if (edit.offsetLastEdit === 0) break;
+		if (edit.offsetLastEdit >= at) throw new require_errors.PptFormatError(`UserEditAtom at offset ${at} points at a previous edit at offset ${edit.offsetLastEdit}, which is not earlier in the stream; the edit chain would cycle`);
+		at = edit.offsetLastEdit;
+	}
+	const directory = /* @__PURE__ */ new Map();
+	for (const edit of [...edits].reverse()) for (const [persistId, offset] of readPersistDirectoryAtom(require_record_tree.readRecordAt(streamBytes, edit.offsetPersistDirectory))) directory.set(persistId, offset);
+	const currentEdit = edits[0];
+	if (currentEdit === void 0) throw new require_errors.PptFormatError("the user edit chain produced no edits, so no document persist object can be located");
+	return {
+		directory,
+		currentEdit
+	};
+}
+function resolvePersistObject(streamBytes, directory, persistId, describe) {
+	const offset = directory.get(persistId);
+	if (offset === void 0) throw new require_errors.PptFormatError(`${describe} references persist object ${persistId}, which the persist directory does not contain`);
+	return require_record_tree.readRecordAt(streamBytes, offset);
+}
+//#endregion
+exports.buildPersistDirectory = buildPersistDirectory;
+exports.readPersistDirectoryAtom = readPersistDirectoryAtom;
+exports.readUserEditAtom = readUserEditAtom;
+exports.resolvePersistObject = resolvePersistObject;

package/dist/stream/persist.d.cts

@@ -0,0 +1,20 @@
+import { t as PptRecord } from "../tree-Du_LXAF0.cjs";
+//#region src/stream/persist.d.ts
+interface UserEdit {
+  readonly lastSlideIdRef: number;
+  readonly offsetLastEdit: number;
+  readonly offsetPersistDirectory: number;
+  readonly docPersistIdRef: number;
+  readonly persistIdSeed: number;
+  readonly encryptSessionPersistIdRef: number | undefined;
+}
+declare function readUserEditAtom(record: PptRecord): UserEdit;
+declare function readPersistDirectoryAtom(record: PptRecord): Map<number, number>;
+interface PersistDirectory {
+  readonly directory: ReadonlyMap<number, number>;
+  readonly currentEdit: UserEdit;
+}
+declare function buildPersistDirectory(streamBytes: Uint8Array<ArrayBuffer>, offsetToCurrentEdit: number): PersistDirectory;
+declare function resolvePersistObject(streamBytes: Uint8Array<ArrayBuffer>, directory: ReadonlyMap<number, number>, persistId: number, describe: string): PptRecord;
+//#endregion
+export { PersistDirectory, UserEdit, buildPersistDirectory, readPersistDirectoryAtom, readUserEditAtom, resolvePersistObject };

package/dist/stream/persist.d.ts

@@ -0,0 +1,20 @@
+import { t as PptRecord } from "../tree-PMcPNgd-.js";
+//#region src/stream/persist.d.ts
+interface UserEdit {
+  readonly lastSlideIdRef: number;
+  readonly offsetLastEdit: number;
+  readonly offsetPersistDirectory: number;
+  readonly docPersistIdRef: number;
+  readonly persistIdSeed: number;
+  readonly encryptSessionPersistIdRef: number | undefined;
+}
+declare function readUserEditAtom(record: PptRecord): UserEdit;
+declare function readPersistDirectoryAtom(record: PptRecord): Map<number, number>;
+interface PersistDirectory {
+  readonly directory: ReadonlyMap<number, number>;
+  readonly currentEdit: UserEdit;
+}
+declare function buildPersistDirectory(streamBytes: Uint8Array<ArrayBuffer>, offsetToCurrentEdit: number): PersistDirectory;
+declare function resolvePersistObject(streamBytes: Uint8Array<ArrayBuffer>, directory: ReadonlyMap<number, number>, persistId: number, describe: string): PptRecord;
+//#endregion
+export { PersistDirectory, UserEdit, buildPersistDirectory, readPersistDirectoryAtom, readUserEditAtom, resolvePersistObject };

package/dist/stream/persist.js

@@ -0,0 +1,67 @@
+import { PptFormatError } from "../errors.js";
+import { readRecordAt } from "../record/tree.js";
+import { RT_PersistDirectoryAtom, RT_UserEditAtom } from "../record/types.js";
+//#region src/stream/persist.ts
+const USER_EDIT_LEN_WITHOUT_ENCRYPT_SESSION = 28;
+const USER_EDIT_LEN_WITH_ENCRYPT_SESSION = 32;
+function readUserEditAtom(record) {
+	if (record.header.recType !== 4085) throw new PptFormatError(`expected RT_UserEditAtom (0x${RT_UserEditAtom.toString(16)}) at offset ${record.offset}, found record type 0x${record.header.recType.toString(16)}`);
+	const { recLen } = record.header;
+	if (recLen !== USER_EDIT_LEN_WITHOUT_ENCRYPT_SESSION && recLen !== USER_EDIT_LEN_WITH_ENCRYPT_SESSION) throw new PptFormatError(`UserEditAtom at offset ${record.offset} declares recLen 0x${recLen.toString(16)}, neither 0x${USER_EDIT_LEN_WITHOUT_ENCRYPT_SESSION.toString(16)} nor 0x${USER_EDIT_LEN_WITH_ENCRYPT_SESSION.toString(16)}`);
+	const { data } = record;
+	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	return {
+		lastSlideIdRef: view.getUint32(0, true),
+		offsetLastEdit: view.getUint32(8, true),
+		offsetPersistDirectory: view.getUint32(12, true),
+		docPersistIdRef: view.getUint32(16, true),
+		persistIdSeed: view.getUint32(20, true),
+		encryptSessionPersistIdRef: recLen === USER_EDIT_LEN_WITH_ENCRYPT_SESSION ? view.getUint32(28, true) : void 0
+	};
+}
+function readPersistDirectoryAtom(record) {
+	if (record.header.recType !== 6002) throw new PptFormatError(`expected RT_PersistDirectoryAtom (0x${RT_PersistDirectoryAtom.toString(16)}) at offset ${record.offset}, found record type 0x${record.header.recType.toString(16)}`);
+	const { data } = record;
+	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	const entries = /* @__PURE__ */ new Map();
+	let at = 0;
+	while (at < data.length) {
+		if (at + 4 > data.length) throw new PptFormatError(`PersistDirectoryAtom at offset ${record.offset} has a ${data.length - at}-byte trailing fragment, too short for a PersistDirectoryEntry header word`);
+		const packed = view.getUint32(at, true);
+		const persistId = packed & 1048575;
+		const cPersist = packed >>> 20 & 4095;
+		if (cPersist === 0) throw new PptFormatError(`PersistDirectoryEntry at offset ${record.dataOffset + at} declares cPersist 0x000, but the spec requires at least 0x001`);
+		at += 4;
+		const offsetsEnd = at + cPersist * 4;
+		if (offsetsEnd > data.length) throw new PptFormatError(`PersistDirectoryEntry at offset ${record.dataOffset + at - 4} declares ${cPersist} offsets, which run past the atom's ${data.length} bytes`);
+		for (let i = 0; i < cPersist; i++) entries.set(persistId + i, view.getUint32(at + i * 4, true));
+		at = offsetsEnd;
+	}
+	return entries;
+}
+function buildPersistDirectory(streamBytes, offsetToCurrentEdit) {
+	const edits = [];
+	let at = offsetToCurrentEdit;
+	while (true) {
+		const edit = readUserEditAtom(readRecordAt(streamBytes, at));
+		edits.push(edit);
+		if (edit.offsetLastEdit === 0) break;
+		if (edit.offsetLastEdit >= at) throw new PptFormatError(`UserEditAtom at offset ${at} points at a previous edit at offset ${edit.offsetLastEdit}, which is not earlier in the stream; the edit chain would cycle`);
+		at = edit.offsetLastEdit;
+	}
+	const directory = /* @__PURE__ */ new Map();
+	for (const edit of [...edits].reverse()) for (const [persistId, offset] of readPersistDirectoryAtom(readRecordAt(streamBytes, edit.offsetPersistDirectory))) directory.set(persistId, offset);
+	const currentEdit = edits[0];
+	if (currentEdit === void 0) throw new PptFormatError("the user edit chain produced no edits, so no document persist object can be located");
+	return {
+		directory,
+		currentEdit
+	};
+}
+function resolvePersistObject(streamBytes, directory, persistId, describe) {
+	const offset = directory.get(persistId);
+	if (offset === void 0) throw new PptFormatError(`${describe} references persist object ${persistId}, which the persist directory does not contain`);
+	return readRecordAt(streamBytes, offset);
+}
+//#endregion
+export { buildPersistDirectory, readPersistDirectoryAtom, readUserEditAtom, resolvePersistObject };

package/dist/text/atoms.cjs

@@ -0,0 +1,70 @@
+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");
+//#region src/text/atoms.ts
+const TEXT_TYPE_TITLE = 0;
+const TEXT_TYPE_BODY = 1;
+const TEXT_TYPE_NOTES = 2;
+const TEXT_TYPE_OTHER = 4;
+const TEXT_TYPE_CENTER_BODY = 5;
+const TEXT_TYPE_CENTER_TITLE = 6;
+const TEXT_TYPE_HALF_BODY = 7;
+const TEXT_TYPE_QUARTER_BODY = 8;
+const PARAGRAPH_SEPARATOR = "\r";
+const LINE_BREAK = "\v";
+function readTextHeaderAtom(record) {
+	if (record.header.recType !== 3999) throw new require_errors.PptFormatError(`expected RT_TextHeaderAtom (0x${require_record_types.RT_TextHeaderAtom.toString(16)}), found record type 0x${record.header.recType.toString(16)}`);
+	if (record.data.length < 4) throw new require_errors.PptFormatError(`TextHeaderAtom carries ${record.data.length} bytes, fewer than the 4 its textType field needs`);
+	return new DataView(record.data.buffer, record.data.byteOffset, record.data.byteLength).getUint32(0, true);
+}
+function decodeTextBytes(bytes) {
+	let text = "";
+	for (const byte of bytes) text += String.fromCharCode(byte);
+	return text;
+}
+function decodeTextChars(bytes) {
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	let text = "";
+	for (let at = 0; at + 1 < bytes.length; at += 2) text += String.fromCharCode(view.getUint16(at, true));
+	return text;
+}
+function readTextBody(records) {
+	const chars = require_record_tree.findChild(records, require_record_types.RT_TextCharsAtom);
+	if (chars !== void 0) return decodeTextChars(chars.data);
+	const bytes = require_record_tree.findChild(records, require_record_types.RT_TextBytesAtom);
+	if (bytes !== void 0) return decodeTextBytes(bytes.data);
+}
+function characterCountOf(text) {
+	return text.length + 1;
+}
+function splitParagraphs(text) {
+	const paragraphs = [];
+	let start = 0;
+	while (start <= text.length) {
+		const separatorAt = text.indexOf("\r", start);
+		const end = separatorAt === -1 ? text.length : separatorAt;
+		paragraphs.push({
+			text: text.slice(start, end).split("\v").join("\n"),
+			start
+		});
+		if (separatorAt === -1) break;
+		start = separatorAt + 1;
+	}
+	return paragraphs;
+}
+//#endregion
+exports.LINE_BREAK = LINE_BREAK;
+exports.PARAGRAPH_SEPARATOR = PARAGRAPH_SEPARATOR;
+exports.TEXT_TYPE_BODY = TEXT_TYPE_BODY;
+exports.TEXT_TYPE_CENTER_BODY = TEXT_TYPE_CENTER_BODY;
+exports.TEXT_TYPE_CENTER_TITLE = TEXT_TYPE_CENTER_TITLE;
+exports.TEXT_TYPE_HALF_BODY = TEXT_TYPE_HALF_BODY;
+exports.TEXT_TYPE_NOTES = TEXT_TYPE_NOTES;
+exports.TEXT_TYPE_OTHER = TEXT_TYPE_OTHER;
+exports.TEXT_TYPE_QUARTER_BODY = TEXT_TYPE_QUARTER_BODY;
+exports.TEXT_TYPE_TITLE = TEXT_TYPE_TITLE;
+exports.characterCountOf = characterCountOf;
+exports.readTextBody = readTextBody;
+exports.readTextHeaderAtom = readTextHeaderAtom;
+exports.splitParagraphs = splitParagraphs;

package/dist/text/atoms.d.cts

@@ -0,0 +1,22 @@
+import { t as PptRecord } from "../tree-Du_LXAF0.cjs";
+//#region src/text/atoms.d.ts
+declare const TEXT_TYPE_TITLE = 0;
+declare const TEXT_TYPE_BODY = 1;
+declare const TEXT_TYPE_NOTES = 2;
+declare const TEXT_TYPE_OTHER = 4;
+declare const TEXT_TYPE_CENTER_BODY = 5;
+declare const TEXT_TYPE_CENTER_TITLE = 6;
+declare const TEXT_TYPE_HALF_BODY = 7;
+declare const TEXT_TYPE_QUARTER_BODY = 8;
+declare const PARAGRAPH_SEPARATOR = "\r";
+declare const LINE_BREAK = "\v";
+declare function readTextHeaderAtom(record: PptRecord): number;
+declare function readTextBody(records: readonly PptRecord[]): string | undefined;
+declare function characterCountOf(text: string): number;
+interface TextParagraph {
+  readonly text: string;
+  readonly start: number;
+}
+declare function splitParagraphs(text: string): TextParagraph[];
+//#endregion
+export { LINE_BREAK, PARAGRAPH_SEPARATOR, TEXT_TYPE_BODY, TEXT_TYPE_CENTER_BODY, TEXT_TYPE_CENTER_TITLE, TEXT_TYPE_HALF_BODY, TEXT_TYPE_NOTES, TEXT_TYPE_OTHER, TEXT_TYPE_QUARTER_BODY, TEXT_TYPE_TITLE, TextParagraph, characterCountOf, readTextBody, readTextHeaderAtom, splitParagraphs };

package/dist/text/atoms.d.ts

@@ -0,0 +1,22 @@
+import { t as PptRecord } from "../tree-PMcPNgd-.js";
+//#region src/text/atoms.d.ts
+declare const TEXT_TYPE_TITLE = 0;
+declare const TEXT_TYPE_BODY = 1;
+declare const TEXT_TYPE_NOTES = 2;
+declare const TEXT_TYPE_OTHER = 4;
+declare const TEXT_TYPE_CENTER_BODY = 5;
+declare const TEXT_TYPE_CENTER_TITLE = 6;
+declare const TEXT_TYPE_HALF_BODY = 7;
+declare const TEXT_TYPE_QUARTER_BODY = 8;
+declare const PARAGRAPH_SEPARATOR = "\r";
+declare const LINE_BREAK = "\v";
+declare function readTextHeaderAtom(record: PptRecord): number;
+declare function readTextBody(records: readonly PptRecord[]): string | undefined;
+declare function characterCountOf(text: string): number;
+interface TextParagraph {
+  readonly text: string;
+  readonly start: number;
+}
+declare function splitParagraphs(text: string): TextParagraph[];
+//#endregion
+export { LINE_BREAK, PARAGRAPH_SEPARATOR, TEXT_TYPE_BODY, TEXT_TYPE_CENTER_BODY, TEXT_TYPE_CENTER_TITLE, TEXT_TYPE_HALF_BODY, TEXT_TYPE_NOTES, TEXT_TYPE_OTHER, TEXT_TYPE_QUARTER_BODY, TEXT_TYPE_TITLE, TextParagraph, characterCountOf, readTextBody, readTextHeaderAtom, splitParagraphs };

package/dist/text/atoms.js

@@ -0,0 +1,56 @@
+import { PptFormatError } from "../errors.js";
+import { findChild } from "../record/tree.js";
+import { RT_TextBytesAtom, RT_TextCharsAtom, RT_TextHeaderAtom } from "../record/types.js";
+//#region src/text/atoms.ts
+const TEXT_TYPE_TITLE = 0;
+const TEXT_TYPE_BODY = 1;
+const TEXT_TYPE_NOTES = 2;
+const TEXT_TYPE_OTHER = 4;
+const TEXT_TYPE_CENTER_BODY = 5;
+const TEXT_TYPE_CENTER_TITLE = 6;
+const TEXT_TYPE_HALF_BODY = 7;
+const TEXT_TYPE_QUARTER_BODY = 8;
+const PARAGRAPH_SEPARATOR = "\r";
+const LINE_BREAK = "\v";
+function readTextHeaderAtom(record) {
+	if (record.header.recType !== 3999) throw new PptFormatError(`expected RT_TextHeaderAtom (0x${RT_TextHeaderAtom.toString(16)}), found record type 0x${record.header.recType.toString(16)}`);
+	if (record.data.length < 4) throw new PptFormatError(`TextHeaderAtom carries ${record.data.length} bytes, fewer than the 4 its textType field needs`);
+	return new DataView(record.data.buffer, record.data.byteOffset, record.data.byteLength).getUint32(0, true);
+}
+function decodeTextBytes(bytes) {
+	let text = "";
+	for (const byte of bytes) text += String.fromCharCode(byte);
+	return text;
+}
+function decodeTextChars(bytes) {
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	let text = "";
+	for (let at = 0; at + 1 < bytes.length; at += 2) text += String.fromCharCode(view.getUint16(at, true));
+	return text;
+}
+function readTextBody(records) {
+	const chars = findChild(records, RT_TextCharsAtom);
+	if (chars !== void 0) return decodeTextChars(chars.data);
+	const bytes = findChild(records, RT_TextBytesAtom);
+	if (bytes !== void 0) return decodeTextBytes(bytes.data);
+}
+function characterCountOf(text) {
+	return text.length + 1;
+}
+function splitParagraphs(text) {
+	const paragraphs = [];
+	let start = 0;
+	while (start <= text.length) {
+		const separatorAt = text.indexOf("\r", start);
+		const end = separatorAt === -1 ? text.length : separatorAt;
+		paragraphs.push({
+			text: text.slice(start, end).split("\v").join("\n"),
+			start
+		});
+		if (separatorAt === -1) break;
+		start = separatorAt + 1;
+	}
+	return paragraphs;
+}
+//#endregion
+export { LINE_BREAK, PARAGRAPH_SEPARATOR, TEXT_TYPE_BODY, TEXT_TYPE_CENTER_BODY, TEXT_TYPE_CENTER_TITLE, TEXT_TYPE_HALF_BODY, TEXT_TYPE_NOTES, TEXT_TYPE_OTHER, TEXT_TYPE_QUARTER_BODY, TEXT_TYPE_TITLE, characterCountOf, readTextBody, readTextHeaderAtom, splitParagraphs };

package/dist/text/style.cjs

@@ -0,0 +1,173 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+const require_record_types = require("../record/types.cjs");
+//#region src/text/style.ts
+const ALIGN_LEFT = 0;
+const ALIGN_CENTER = 1;
+const ALIGN_RIGHT = 2;
+const ALIGN_JUSTIFY = 3;
+const ALIGN_DISTRIBUTED = 4;
+const ALIGN_THAI_DISTRIBUTED = 5;
+const ALIGN_JUSTIFY_LOW = 6;
+const PF_BULLET_FONT = 16;
+const PF_BULLET_COLOR = 32;
+const PF_BULLET_SIZE = 64;
+const PF_BULLET_CHAR = 128;
+const PF_LEFT_MARGIN = 256;
+const PF_INDENT = 1024;
+const PF_ALIGN = 2048;
+const PF_LINE_SPACING = 4096;
+const PF_SPACE_BEFORE = 8192;
+const PF_SPACE_AFTER = 16384;
+const PF_DEFAULT_TAB_SIZE = 32768;
+const PF_FONT_ALIGN = 65536;
+const PF_TAB_STOPS = 1 << 20;
+const PF_TEXT_DIRECTION = 1 << 21;
+const CF_BOLD = 1;
+const CF_ITALIC = 2;
+const CF_UNDERLINE = 4;
+const CF_SHADOW = 16;
+const CF_EMBOSS = 512;
+const CF_TYPEFACE = 65536;
+const CF_SIZE = 1 << 17;
+const CF_COLOR = 1 << 18;
+const CF_POSITION = 1 << 19;
+const CF_OLD_EA_TYPEFACE = 1 << 21;
+const CF_ANSI_TYPEFACE = 1 << 22;
+const CF_SYMBOL_TYPEFACE = 1 << 23;
+const STYLE_BOLD = 1;
+const STYLE_ITALIC = 2;
+const STYLE_UNDERLINE = 4;
+const STYLE_SHADOW = 16;
+const STYLE_EMBOSS = 512;
+const COLOR_INDEX_SRGB = 254;
+var FieldCursor = class {
+	data;
+	describe;
+	at;
+	view;
+	constructor(data, start, describe) {
+		this.data = data;
+		this.describe = describe;
+		this.at = start;
+		this.view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	}
+	get offset() {
+		return this.at;
+	}
+	require(size) {
+		if (this.at + size > this.data.length) throw new require_errors.PptFormatError(`${this.describe} needs ${size} more bytes at offset ${this.at} but the atom holds only ${this.data.length}`);
+		const at = this.at;
+		this.at += size;
+		return at;
+	}
+	u16() {
+		return this.view.getUint16(this.require(2), true);
+	}
+	i16() {
+		return this.view.getInt16(this.require(2), true);
+	}
+	u32() {
+		return this.view.getUint32(this.require(4), true);
+	}
+	bytes(size) {
+		const at = this.require(size);
+		return this.data.subarray(at, at + size);
+	}
+	skip(size) {
+		this.require(size);
+	}
+};
+function readColorIndexStruct(cursor) {
+	const [red, green, blue, index] = cursor.bytes(4);
+	if (red === void 0 || green === void 0 || blue === void 0 || index === void 0) throw new require_errors.PptFormatError("ColorIndexStruct read returned fewer than its four bytes");
+	return index === COLOR_INDEX_SRGB ? {
+		red,
+		green,
+		blue
+	} : void 0;
+}
+function readTextPFException(cursor, indentLevel) {
+	const masks = cursor.u32();
+	if ((masks & 15) !== 0) cursor.skip(2);
+	if ((masks & PF_BULLET_CHAR) !== 0) cursor.skip(2);
+	if ((masks & PF_BULLET_FONT) !== 0) cursor.skip(2);
+	if ((masks & PF_BULLET_SIZE) !== 0) cursor.skip(2);
+	if ((masks & PF_BULLET_COLOR) !== 0) cursor.skip(4);
+	const alignment = (masks & PF_ALIGN) !== 0 ? cursor.u16() : void 0;
+	for (const mask of [
+		PF_LINE_SPACING,
+		PF_SPACE_BEFORE,
+		PF_SPACE_AFTER,
+		PF_LEFT_MARGIN,
+		PF_INDENT,
+		PF_DEFAULT_TAB_SIZE
+	]) if ((masks & mask) !== 0) cursor.skip(2);
+	if ((masks & PF_TAB_STOPS) !== 0) cursor.skip(cursor.u16() * 4);
+	if ((masks & PF_FONT_ALIGN) !== 0) cursor.skip(2);
+	if ((masks & 917504) !== 0) cursor.skip(2);
+	if ((masks & PF_TEXT_DIRECTION) !== 0) cursor.skip(2);
+	return {
+		indentLevel,
+		alignment
+	};
+}
+function styleFlag(masks, maskBit, fontStyle, styleBit) {
+	if ((masks & maskBit) === 0 || fontStyle === void 0) return;
+	return (fontStyle & styleBit) !== 0;
+}
+function readTextCFException(cursor) {
+	const masks = cursor.u32();
+	const fontStyle = (masks & 16055) !== 0 ? cursor.u16() : void 0;
+	const fontRef = (masks & CF_TYPEFACE) !== 0 ? cursor.u16() : void 0;
+	if ((masks & CF_OLD_EA_TYPEFACE) !== 0) cursor.skip(2);
+	if ((masks & CF_ANSI_TYPEFACE) !== 0) cursor.skip(2);
+	if ((masks & CF_SYMBOL_TYPEFACE) !== 0) cursor.skip(2);
+	const sizePt = (masks & CF_SIZE) !== 0 ? cursor.i16() : void 0;
+	const color = (masks & CF_COLOR) !== 0 ? readColorIndexStruct(cursor) : void 0;
+	if ((masks & CF_POSITION) !== 0) cursor.skip(2);
+	return {
+		bold: styleFlag(masks, CF_BOLD, fontStyle, STYLE_BOLD),
+		italic: styleFlag(masks, CF_ITALIC, fontStyle, STYLE_ITALIC),
+		underline: styleFlag(masks, CF_UNDERLINE, fontStyle, STYLE_UNDERLINE),
+		shadow: styleFlag(masks, CF_SHADOW, fontStyle, STYLE_SHADOW),
+		emboss: styleFlag(masks, CF_EMBOSS, fontStyle, STYLE_EMBOSS),
+		fontRef,
+		sizePt,
+		color
+	};
+}
+function readRuns(cursor, characterCount, describe, readProperties) {
+	const runs = [];
+	let covered = 0;
+	while (covered < characterCount) {
+		const count = cursor.u32();
+		const properties = readProperties(cursor);
+		covered += count;
+		if (covered > characterCount) throw new require_errors.PptFormatError(`${describe} cover ${covered} characters, more than the ${characterCount} in the corresponding text body`);
+		runs.push({
+			count,
+			properties
+		});
+	}
+	return runs;
+}
+function readStyleTextPropAtom(record, characterCount) {
+	if (record.header.recType !== 4001) throw new require_errors.PptFormatError(`expected RT_StyleTextPropAtom (0x${require_record_types.RT_StyleTextPropAtom.toString(16)}), found record type 0x${record.header.recType.toString(16)}`);
+	const cursor = new FieldCursor(record.data, 0, "StyleTextPropAtom");
+	return {
+		paragraphRuns: readRuns(cursor, characterCount, "StyleTextPropAtom paragraph runs", (at) => {
+			return readTextPFException(at, at.u16());
+		}),
+		characterRuns: readRuns(cursor, characterCount, "StyleTextPropAtom character runs", readTextCFException)
+	};
+}
+//#endregion
+exports.ALIGN_CENTER = ALIGN_CENTER;
+exports.ALIGN_DISTRIBUTED = ALIGN_DISTRIBUTED;
+exports.ALIGN_JUSTIFY = ALIGN_JUSTIFY;
+exports.ALIGN_JUSTIFY_LOW = ALIGN_JUSTIFY_LOW;
+exports.ALIGN_LEFT = ALIGN_LEFT;
+exports.ALIGN_RIGHT = ALIGN_RIGHT;
+exports.ALIGN_THAI_DISTRIBUTED = ALIGN_THAI_DISTRIBUTED;
+exports.readStyleTextPropAtom = readStyleTextPropAtom;