wpd-codec 3.1.1 → 3.2.0

package/dist/read.js

@@ -1,14 +1,16 @@
 import { uint16At } from "./bytes/view.js";
 import { decodeSingleByteCharacter, decodeWpCharacter } from "./stream/characters.js";
-import { packetByPrefixId, readTypefaceName } from "./container/prefix.js";
+import { packetByPrefixId, readGeneralWpTextBlocks, readTypefaceName } from "./container/prefix.js";
 import { openWpdDocument } from "./container/container.js";
 import { readDocumentSummary } from "./container/summary.js";
 import { NOOP_WPD_DIAGNOSTIC_SINK, WpdDiagnosticCodes } from "./diagnostics.js";
 import { decodeAttributeByte, runAttributesFrom } from "./stream/attributes.js";
 import { eolMappingForSubfunction, isSingleByteEol, subfunctionForSingleByteEol } from "./stream/eol.js";
 import { readMarginPt, readPageForm } from "./stream/page.js";
-import { isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isStyleScopeCloser, isStyleScopeOpener, readDisplayNumberLevel, readSystemStyleNumber, styleSemanticsFor } from "./stream/style.js";
+import { isParagraphNumberDisplayOff, isParagraphNumberDisplayOn, isStyleScopeCloser, isStyleScopeOpener, readDisplayNumberLevel, readStyleBeginBlock, readSystemStyleNumber, styleSemanticsFor } from "./stream/style.js";
 import { findEmbeddedSubfunction, readCellFill, readCellInformation, readCellSpanning, readEmbeddedSubfunctions, readRowInformation, readTableColumnWidthPt } from "./stream/table.js";
+import { readBoxContent } from "./stream/box.js";
+import { readTableFormula } from "./stream/formula.js";
 import { tabEffectFor } from "./stream/tab.js";
 import { tokeniseDocumentArea } from "./stream/tokenise.js";
 import { assembleTree } from "document-schema.js";
@@ -29,6 +31,8 @@ const CROSS_REFERENCE_GROUP = 213;
 const HEADER_FOOTER_GROUP = 214;
 const FOOTNOTE_ENDNOTE_GROUP = 215;
 const MERGE_GROUP = 222;
+const MERGE_FIELD_ON = 76;
+const MERGE_FIELD_OFF = 77;
 const BOX_GROUP = 223;
 const PARAGRAPH_GROUP = 211;
 const PARAGRAPH_SET_JUSTIFICATION = 5;
@@ -48,6 +52,7 @@ const JUSTIFICATION = [
 const THREE_THOUSAND_SIX_HUNDREDTHS_PER_POINT = 50;
 const COLOR_COMPONENT_MAX = 255;
 const NO_SPAN = 1;
+const MAX_STYLE_RESOLUTION_DEPTH = 16;
 function sameAttributes(a, b) {
 	return a.bold === b.bold && a.italic === b.italic && a.underline === b.underline && a.strike === b.strike;
 }
@@ -79,29 +84,35 @@ function flushRun(state) {
 function targetBlocks(state) {
 	return state.table === void 0 ? state.blocks : state.table.cellBlocks;
 }
-function flushParagraph(state) {
+function flushParagraph(state, sink) {
 	flushRun(state);
+	if (state.openMergeFieldStartRun !== void 0) {
+		state.openMergeFieldStartRun = void 0;
+		reportOnce(state, sink, WpdDiagnosticCodes.MergeFieldSpansParagraphs, "A merge field's own On/Off pair straddled a paragraph boundary, which the run-scoped field construct cannot express; its text became ordinary paragraph text with no field tag.");
+	}
 	const alignment = state.pendingAlignment ?? state.alignment;
+	const constructs = state.pendingConstructs.splice(0, state.pendingConstructs.length);
 	const paragraph = {
 		kind: "paragraph",
 		runs: state.runs.splice(0, state.runs.length),
 		...alignment === void 0 ? {} : { alignment },
 		...state.pendingHeadingLevel === void 0 ? {} : { headingLevel: state.pendingHeadingLevel },
-		...state.pendingListLevel === void 0 ? {} : { list: { level: state.pendingListLevel } }
+		...state.pendingListLevel === void 0 ? {} : { list: { level: state.pendingListLevel } },
+		...constructs.length === 0 ? {} : { constructs }
 	};
 	state.pendingHeadingLevel = void 0;
 	state.pendingListLevel = void 0;
 	state.pendingAlignment = void 0;
 	targetBlocks(state).push(paragraph);
 }
-function flushParagraphIfContent(state) {
+function flushParagraphIfContent(state, sink) {
 	if (state.text.length === 0 && state.runs.length === 0) return;
-	flushParagraph(state);
+	flushParagraph(state, sink);
 }
 function effectiveStyle(state) {
 	for (let index = state.styleScopes.length - 1; index >= 0; index -= 1) {
-		const scope = state.styleScopes[index];
-		if (scope !== void 0) return scope;
+		const semantics = state.styleScopes[index]?.semantics;
+		if (semantics !== void 0) return semantics;
 	}
 }
 function appendText(state, text) {
@@ -122,6 +133,9 @@ function readCellAttributes(state, nonDeletable, sink) {
 	const spanning = findEmbeddedSubfunction(subfunctions, 133);
 	const fill = findEmbeddedSubfunction(subfunctions, 134);
 	const row = findEmbeddedSubfunction(subfunctions, 128);
+	const formulaData = findEmbeddedSubfunction(subfunctions, 129);
+	const formula = formulaData === void 0 ? void 0 : readTableFormula(formulaData);
+	if (formulaData !== void 0 && formula === void 0) reportOnce(state, sink, WpdDiagnosticCodes.TableFormulaUnresolved, "A table cell carries a formula this reader could not decode with confidence, so the cell keeps its displayed text but not the formula that produced it.");
 	const cellSpanning = spanning === void 0 ? void 0 : readCellSpanning(spanning);
 	const cellFill = fill === void 0 ? void 0 : readCellFill(fill);
 	if (cellFill?.blended === true) reportOnce(state, sink, WpdDiagnosticCodes.CellFillBlended, "A cell is filled with a shaded blend of two colours, resolved to a 'pattern' fill whose density is this reader's own best-effort derivation, not a value confirmed against a specification.");
@@ -131,13 +145,14 @@ function readCellAttributes(state, nonDeletable, sink) {
 			background: cellFill?.fill,
 			columnSpan: cellSpanning?.columnSpan ?? NO_SPAN,
 			rowSpan: cellSpanning?.rowSpan ?? NO_SPAN,
-			covered: cellSpanning?.coveredFromLeft === true || cellSpanning?.coveredFromAbove === true
+			covered: cellSpanning?.coveredFromLeft === true || cellSpanning?.coveredFromAbove === true,
+			formula
 		},
 		rowHeightPt: row === void 0 ? void 0 : readRowInformation(row)?.heightPt
 	};
 }
-function closeCell(state, table, attributes) {
-	flushParagraphIfContent(state);
+function closeCell(state, table, attributes, sink) {
+	flushParagraphIfContent(state, sink);
 	const blocks = table.cellBlocks;
 	table.cellBlocks = [];
 	if (attributes.covered) return;
@@ -148,7 +163,8 @@ function closeCell(state, table, attributes) {
 		blocks,
 		...attributes.columnSpan > NO_SPAN ? { colSpan: attributes.columnSpan } : {},
 		...attributes.rowSpan > NO_SPAN ? { rowSpan: attributes.rowSpan } : {},
-		...attributes.background === void 0 ? {} : { background: attributes.background }
+		...attributes.background === void 0 ? {} : { background: attributes.background },
+		...attributes.formula === void 0 ? {} : { formula: attributes.formula }
 	};
 	table.cells.push(cell);
 }
@@ -180,14 +196,14 @@ function applyEolMapping(state, mapping, nonDeletable, sink) {
 			appendText(state, " ");
 			return;
 		case "hardReturn":
-			flushParagraph(state);
+			flushParagraph(state, sink);
 			return;
 		case "hardEndOfColumn":
 			reportOnce(state, sink, WpdDiagnosticCodes.ColumnBreakFlattened, "A column break became a paragraph break.");
-			flushParagraph(state);
+			flushParagraph(state, sink);
 			return;
 		case "hardEndOfPage":
-			flushParagraph(state);
+			flushParagraph(state, sink);
 			targetBlocks(state).push({ kind: "pageBreak" });
 			return;
 		case "tableCell":
@@ -197,13 +213,13 @@ function applyEolMapping(state, mapping, nonDeletable, sink) {
 			const table = state.table;
 			if (table === void 0) {
 				reportOnce(state, sink, WpdDiagnosticCodes.TableFlattened, "A table cell or row boundary appeared with no table definition open; its text became a paragraph.");
-				flushParagraph(state);
+				flushParagraph(state, sink);
 				return;
 			}
 			const { attributes, rowHeightPt } = readCellAttributes(state, nonDeletable, sink);
 			if (rowHeightPt !== void 0) table.rowHeightPt = rowHeightPt;
 			const cellIsOpen = state.text.length > 0 || state.runs.length > 0 || table.cellBlocks.length > 0;
-			if (mapping !== "tableOff" || cellIsOpen) closeCell(state, table, attributes);
+			if (mapping !== "tableOff" || cellIsOpen) closeCell(state, table, attributes, sink);
 			if (mapping === "tableCell") return;
 			closeRow(table);
 			if (mapping === "tableOff") closeTable(state);
@@ -232,13 +248,13 @@ function applySingleByteFunction(state, code, sink) {
 			appendText(state, "-");
 			return;
 		case DORMANT_HARD_RETURN:
-			flushParagraph(state);
+			flushParagraph(state, sink);
 			return;
 		case SOFT_END_OF_CENTER_ALIGN:
 			appendText(state, " ");
 			return;
 		case HARD_END_OF_CENTER_ALIGN:
-			flushParagraph(state);
+			flushParagraph(state, sink);
 			return;
 		case START_OF_TEXT_TO_SKIP:
 			state.skipDepth += 1;
@@ -300,13 +316,56 @@ function applyColumnGroup(state, token, sink) {
 	if (token.subgroup === 0) setPageDimension(state, "leftPt", margin, sink);
 	else if (token.subgroup === 1) setPageDimension(state, "rightPt", margin, sink);
 }
-function applyStyleGroup(state, token) {
+function snapshotFormatting(state) {
+	return {
+		activeAttributes: new Set(state.activeAttributes),
+		fontFamily: state.fontFamily,
+		sizePt: state.sizePt,
+		color: state.color
+	};
+}
+function restoreFormattingSnapshot(state, snapshot) {
+	flushRun(state);
+	state.activeAttributes.clear();
+	for (const attribute of snapshot.activeAttributes) state.activeAttributes.add(attribute);
+	state.attributes = runAttributesFrom(state.activeAttributes);
+	state.fontFamily = snapshot.fontFamily;
+	state.sizePt = snapshot.sizePt;
+	state.color = snapshot.color;
+}
+function applyStylePacketBegin(state, token, container, sink) {
+	const prefixId = token.prefixIds[0];
+	if (prefixId === void 0) return;
+	const packet = packetByPrefixId(container.packets, prefixId);
+	if (packet?.packetType !== 48) return;
+	const beginBlock = readStyleBeginBlock(packet.bytes);
+	if (beginBlock === void 0) return;
+	if (state.styleResolutionDepth >= MAX_STYLE_RESOLUTION_DEPTH) {
+		reportOnce(state, sink, WpdDiagnosticCodes.StyleResolutionDepthExceeded, "A chain of styles resolving one another's own packets ran deeper than this reader will follow, so the deepest style's own direct formatting was not applied.");
+		return;
+	}
+	const snapshot = snapshotFormatting(state);
+	const tokens = tokeniseDocumentArea(beginBlock, 0, beginBlock.length);
+	state.styleResolutionDepth += 1;
+	for (const beginToken of tokens) applyToken(state, beginToken, container, sink);
+	state.styleResolutionDepth -= 1;
+	return snapshot;
+}
+function applyStyleGroup(state, token, container, sink) {
 	if (isStyleScopeOpener(token.subgroup)) {
 		const systemStyleNumber = readSystemStyleNumber(token.nonDeletable);
-		state.styleScopes.push(systemStyleNumber === void 0 ? void 0 : styleSemanticsFor(systemStyleNumber));
+		const semantics = systemStyleNumber === void 0 ? void 0 : styleSemanticsFor(systemStyleNumber);
+		const snapshot = applyStylePacketBegin(state, token, container, sink);
+		state.styleScopes.push({
+			semantics,
+			snapshot
+		});
 		return;
 	}
-	if (isStyleScopeCloser(token.subgroup)) state.styleScopes.pop();
+	if (isStyleScopeCloser(token.subgroup)) {
+		const entry = state.styleScopes.pop();
+		if (entry?.snapshot !== void 0) restoreFormattingSnapshot(state, entry.snapshot);
+	}
 }
 function applyDisplayNumberGroup(state, token, sink) {
 	if (isParagraphNumberDisplayOn(token.subgroup)) {
@@ -322,7 +381,7 @@ function applyCharacterGroup(state, token, container, sink) {
 	switch (token.subgroup) {
 		case 42:
 			closeTable(state);
-			flushParagraphIfContent(state);
+			flushParagraphIfContent(state, sink);
 			state.table = {
 				columnWidthsPt: [],
 				rows: [],
@@ -367,6 +426,104 @@ function applyCharacterGroup(state, token, container, sink) {
 		default: return;
 	}
 }
+function applyMergeGroup(state, token, sink) {
+	if (token.subgroup === MERGE_FIELD_ON) {
+		flushRun(state);
+		state.openMergeFieldStartRun = state.runs.length;
+		return;
+	}
+	if (token.subgroup === MERGE_FIELD_OFF) {
+		const startRun = state.openMergeFieldStartRun;
+		state.openMergeFieldStartRun = void 0;
+		if (startRun === void 0) return;
+		flushRun(state);
+		const endRun = state.runs.length;
+		const instruction = state.runs.slice(startRun, endRun).map((run) => run.text).join("");
+		state.pendingConstructs.push({
+			descriptor: {
+				kind: "field",
+				instruction
+			},
+			startRun,
+			endRun
+		});
+		return;
+	}
+	reportOnce(state, sink, WpdDiagnosticCodes.MergeCodeDropped, "This document contains merge codes, which are a form-letter template's placeholders rather than text.");
+}
+function plainTextOf(blocks) {
+	return blocks.filter((block) => block.kind === "paragraph").map((paragraph) => paragraph.runs.map((run) => run.text).join("")).join("\n");
+}
+function applyBoxGroup(state, token, container, sink) {
+	const boxContent = readBoxContent(token.nonDeletable, token.prefixIds);
+	if (boxContent === void 0) {
+		reportOnce(state, sink, WpdDiagnosticCodes.BoxDropped, "This document contains a box -- a figure, text box, equation, or graphic -- whose function-level override names no content this reader can resolve.");
+		return;
+	}
+	const packet = boxContent.contentType === 1 || boxContent.contentType === 2 || boxContent.contentType === 4 ? packetByPrefixId(container.packets, boxContent.contentPrefixId) : void 0;
+	const textBlocks = packet?.packetType !== 8 ? void 0 : readGeneralWpTextBlocks(packet.bytes);
+	if (textBlocks === void 0) {
+		reportOnce(state, sink, WpdDiagnosticCodes.BoxContentUnresolved, "This document contains a box whose content this reader could not read -- an image, OLE object, or other content type this reader does not yet decode into the shared schema.");
+		return;
+	}
+	if (boxContent.frame === void 0) {
+		reportOnce(state, sink, WpdDiagnosticCodes.BoxFrameUnresolved, "This document contains a box whose content this reader could read, but whose function-level override states no width and height this reader can trust, so its content was not lifted.");
+		return;
+	}
+	flushParagraphIfContent(state, sink);
+	const nestedTokens = tokeniseDocumentArea(textBlocks, 0, textBlocks.length);
+	const frame = {
+		xPt: boxContent.frame.xPt,
+		yPt: boxContent.frame.yPt,
+		widthPt: boxContent.frame.widthPt,
+		heightPt: boxContent.frame.heightPt
+	};
+	if (boxContent.contentType === 4) {
+		const { blocks } = foldTokens(nestedTokens, container, sink);
+		const embed = {
+			kind: "embeddedObject",
+			objectKind: "formula",
+			frame,
+			document: {
+				kind: "formula",
+				metadata: {},
+				formula: {
+					mathml: [],
+					source: {
+						format: "wpd",
+						xml: plainTextOf(blocks)
+					}
+				}
+			}
+		};
+		targetBlocks(state).push(embed);
+		return;
+	}
+	const { blocks, page } = foldTokens(nestedTokens, container, sink);
+	const embed = {
+		kind: "embeddedObject",
+		objectKind: "wordprocessing",
+		frame,
+		document: {
+			kind: "wordprocessing",
+			metadata: {},
+			sections: [{
+				pageSize: {
+					widthPt: page.widthPt ?? 612,
+					heightPt: page.heightPt ?? 792
+				},
+				margins: {
+					topPt: page.topPt ?? 72,
+					rightPt: page.rightPt ?? 72,
+					bottomPt: page.bottomPt ?? 72,
+					leftPt: page.leftPt ?? 72
+				},
+				blocks
+			}]
+		}
+	};
+	targetBlocks(state).push(embed);
+}
 function applyVariableFunction(state, token, container, sink) {
 	switch (token.group) {
 		case 208: {
@@ -397,7 +554,7 @@ function applyVariableFunction(state, token, container, sink) {
 			return;
 		}
 		case 221:
-			applyStyleGroup(state, token);
+			applyStyleGroup(state, token, container, sink);
 			return;
 		case 218:
 			applyDisplayNumberGroup(state, token, sink);
@@ -412,10 +569,10 @@ function applyVariableFunction(state, token, container, sink) {
 			reportOnce(state, sink, WpdDiagnosticCodes.NoteDropped, "This document contains a footnote or endnote; its text lives in a prefix packet the flat content model has nowhere to put.");
 			return;
 		case MERGE_GROUP:
-			reportOnce(state, sink, WpdDiagnosticCodes.MergeCodeDropped, "This document contains merge codes, which are a form-letter template's placeholders rather than text.");
+			applyMergeGroup(state, token, sink);
 			return;
 		case BOX_GROUP:
-			reportOnce(state, sink, WpdDiagnosticCodes.BoxDropped, "This document contains a box -- a figure, text box, equation, or graphic -- whose contents were not read.");
+			applyBoxGroup(state, token, container, sink);
 			return;
 		default: return;
 	}
@@ -449,6 +606,32 @@ function applyFixedFunction(state, token, sink) {
 	flushRun(state);
 	state.attributes = next;
 }
+function applyToken(state, token, container, sink) {
+	switch (token.kind) {
+		case "character": {
+			const character = decodeSingleByteCharacter(token.byte);
+			if (character === void 0) {
+				sink({
+					code: WpdDiagnosticCodes.UnmappedCharacter,
+					message: `Byte ${token.byte} in the document area has no character mapping and was rendered as U+FFFD.`
+				});
+				appendText(state, "�");
+				return;
+			}
+			appendText(state, character);
+			return;
+		}
+		case "singleByteFunction":
+			applySingleByteFunction(state, token.code, sink);
+			return;
+		case "variableFunction":
+			applyVariableFunction(state, token, container, sink);
+			return;
+		case "fixedFunction":
+			applyFixedFunction(state, token, sink);
+			return;
+	}
+}
 function foldTokens(tokens, container, sink) {
 	const state = {
 		blocks: [],
@@ -462,6 +645,7 @@ function foldTokens(tokens, container, sink) {
 		alignment: void 0,
 		skipDepth: 0,
 		styleScopes: [],
+		styleResolutionDepth: 0,
 		pendingHeadingLevel: void 0,
 		pendingListLevel: void 0,
 		pendingAlignment: void 0,
@@ -476,32 +660,13 @@ function foldTokens(tokens, container, sink) {
 			changeReported: false
 		},
 		table: void 0,
-		reported: /* @__PURE__ */ new Set()
+		reported: /* @__PURE__ */ new Set(),
+		pendingConstructs: [],
+		openMergeFieldStartRun: void 0
 	};
-	for (const token of tokens) switch (token.kind) {
-		case "character": {
-			const character = decodeSingleByteCharacter(token.byte);
-			if (character === void 0) {
-				sink({
-					code: WpdDiagnosticCodes.UnmappedCharacter,
-					message: `Byte ${token.byte} in the document area has no character mapping and was rendered as U+FFFD.`
-				});
-				appendText(state, "�");
-				break;
-			}
-			appendText(state, character);
-			break;
-		}
-		case "singleByteFunction":
-			applySingleByteFunction(state, token.code, sink);
-			break;
-		case "variableFunction":
-			applyVariableFunction(state, token, container, sink);
-			break;
-		case "fixedFunction": applyFixedFunction(state, token, sink);
-	}
+	for (const token of tokens) applyToken(state, token, container, sink);
 	flushRun(state);
-	if (state.runs.length > 0) flushParagraph(state);
+	if (state.runs.length > 0) flushParagraph(state, sink);
 	if (state.table !== void 0) {
 		closeRow(state.table);
 		closeTable(state);

package/dist/stream/box.cjs

@@ -0,0 +1,122 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_bytes_view = require("../bytes/view.cjs");
+const require_stream_units = require("./units.cjs");
+//#region src/stream/box.ts
+const OVERRIDE_BIT_POSITION = 14;
+const OVERRIDE_BIT_CONTENT = 13;
+const OVERRIDE_BIT_HTML = 7;
+const OVERRIDE_FLAGS_OFFSET = 18;
+const FIRST_OVERRIDE_BLOCK_OFFSET = 20;
+function walkOverrideBlocks(nonDeletable) {
+	if (nonDeletable.length < FIRST_OVERRIDE_BLOCK_OFFSET) return;
+	const flags = require_bytes_view.uint16At(nonDeletable, OVERRIDE_FLAGS_OFFSET);
+	const blocks = /* @__PURE__ */ new Map();
+	let cursor = FIRST_OVERRIDE_BLOCK_OFFSET;
+	for (let bit = 15; bit >= 5; bit -= 1) {
+		if ((flags & 1 << bit) === 0) continue;
+		if (bit === OVERRIDE_BIT_HTML) continue;
+		if (cursor + 2 > nonDeletable.length) return;
+		const size = require_bytes_view.uint16At(nonDeletable, cursor);
+		cursor += 2;
+		if (cursor + size > nonDeletable.length) return;
+		blocks.set(bit, nonDeletable.subarray(cursor, cursor + size));
+		cursor += size;
+	}
+	return {
+		flags,
+		blocks
+	};
+}
+function readContentType(contentBlock) {
+	if (contentBlock.length < 2) return;
+	const flags = require_bytes_view.uint16At(contentBlock, 0);
+	let cursor = 2;
+	if ((flags & 32768) !== 0) {
+		if (cursor + 2 > contentBlock.length) return;
+		cursor += 2;
+	}
+	if ((flags & 16384) === 0) return;
+	return contentBlock[cursor];
+}
+function readPositionOverride(positionBlock) {
+	if (positionBlock.length < 2) return;
+	const flags = require_bytes_view.uint16At(positionBlock, 0);
+	let cursor = 2;
+	let widthWpu;
+	let heightWpu;
+	let xWpu;
+	let yWpu;
+	const need = (bytes) => cursor + bytes <= positionBlock.length;
+	if ((flags & 32768) !== 0) {
+		if (!need(2)) return void 0;
+		cursor += 2;
+	}
+	if ((flags & 16384) !== 0) {
+		if (!need(2)) return void 0;
+		cursor += 2;
+	}
+	if ((flags & 8192) !== 0) {
+		if (!need(5)) return void 0;
+		const horizontalFlags = positionBlock[cursor];
+		const offset = require_bytes_view.uint16At(positionBlock, cursor + 1);
+		if (horizontalFlags !== void 0 && (horizontalFlags & 3) === 0) xWpu = offset;
+		cursor += 5;
+	}
+	if ((flags & 4096) !== 0) {
+		if (!need(3)) return void 0;
+		const verticalFlags = positionBlock[cursor];
+		const offset = require_bytes_view.uint16At(positionBlock, cursor + 1);
+		if (verticalFlags !== void 0 && (verticalFlags & 3) === 0) yWpu = offset;
+		cursor += 3;
+	}
+	if ((flags & 2048) !== 0) {
+		if (!need(3)) return void 0;
+		widthWpu = require_bytes_view.uint16At(positionBlock, cursor + 1);
+		cursor += 3;
+	}
+	if ((flags & 1024) !== 0) {
+		if (!need(3)) return void 0;
+		heightWpu = require_bytes_view.uint16At(positionBlock, cursor + 1);
+		cursor += 3;
+	}
+	return {
+		widthWpu,
+		heightWpu,
+		xWpu,
+		yWpu
+	};
+}
+const BOX_CONTENT_TYPE_TEXT = 1;
+const BOX_CONTENT_TYPE_LINKED_TEXT = 2;
+const BOX_CONTENT_TYPE_IMAGE = 3;
+const BOX_CONTENT_TYPE_EQUATION = 4;
+function readBoxContent(nonDeletable, prefixIds) {
+	const walk = walkOverrideBlocks(nonDeletable);
+	if (walk === void 0) return;
+	const { flags, blocks } = walk;
+	const contentBlock = blocks.get(OVERRIDE_BIT_CONTENT);
+	if (contentBlock === void 0) return;
+	const contentType = readContentType(contentBlock);
+	if (contentType === void 0) return;
+	const contentPrefixId = prefixIds[1 + ((flags & 32768) !== 0 ? 1 : 0)];
+	if (contentPrefixId === void 0) return;
+	const positionBlock = blocks.get(OVERRIDE_BIT_POSITION);
+	const position = positionBlock === void 0 ? void 0 : readPositionOverride(positionBlock);
+	return {
+		contentType,
+		contentPrefixId,
+		frame: position?.widthWpu === void 0 || position.heightWpu === void 0 ? void 0 : {
+			xPt: require_stream_units.pointsFromWpu(position.xWpu ?? 0),
+			yPt: require_stream_units.pointsFromWpu(position.yWpu ?? 0),
+			widthPt: require_stream_units.pointsFromWpu(position.widthWpu),
+			heightPt: require_stream_units.pointsFromWpu(position.heightWpu),
+			positionResolved: position.xWpu !== void 0 && position.yWpu !== void 0
+		}
+	};
+}
+//#endregion
+exports.BOX_CONTENT_TYPE_EQUATION = BOX_CONTENT_TYPE_EQUATION;
+exports.BOX_CONTENT_TYPE_IMAGE = BOX_CONTENT_TYPE_IMAGE;
+exports.BOX_CONTENT_TYPE_LINKED_TEXT = BOX_CONTENT_TYPE_LINKED_TEXT;
+exports.BOX_CONTENT_TYPE_TEXT = BOX_CONTENT_TYPE_TEXT;
+exports.readBoxContent = readBoxContent;

package/dist/stream/box.d.cts

@@ -0,0 +1,20 @@
+//#region src/stream/box.d.ts
+interface WpdBoxFrame {
+  readonly xPt: number;
+  readonly yPt: number;
+  readonly widthPt: number;
+  readonly heightPt: number;
+  readonly positionResolved: boolean;
+}
+interface WpdBoxContent {
+  readonly contentType: number;
+  readonly contentPrefixId: number;
+  readonly frame: WpdBoxFrame | undefined;
+}
+declare const BOX_CONTENT_TYPE_TEXT = 1;
+declare const BOX_CONTENT_TYPE_LINKED_TEXT = 2;
+declare const BOX_CONTENT_TYPE_IMAGE = 3;
+declare const BOX_CONTENT_TYPE_EQUATION = 4;
+declare function readBoxContent(nonDeletable: Uint8Array, prefixIds: readonly number[]): WpdBoxContent | undefined;
+//#endregion
+export { BOX_CONTENT_TYPE_EQUATION, BOX_CONTENT_TYPE_IMAGE, BOX_CONTENT_TYPE_LINKED_TEXT, BOX_CONTENT_TYPE_TEXT, WpdBoxContent, WpdBoxFrame, readBoxContent };

package/dist/stream/box.d.ts

@@ -0,0 +1,20 @@
+//#region src/stream/box.d.ts
+interface WpdBoxFrame {
+  readonly xPt: number;
+  readonly yPt: number;
+  readonly widthPt: number;
+  readonly heightPt: number;
+  readonly positionResolved: boolean;
+}
+interface WpdBoxContent {
+  readonly contentType: number;
+  readonly contentPrefixId: number;
+  readonly frame: WpdBoxFrame | undefined;
+}
+declare const BOX_CONTENT_TYPE_TEXT = 1;
+declare const BOX_CONTENT_TYPE_LINKED_TEXT = 2;
+declare const BOX_CONTENT_TYPE_IMAGE = 3;
+declare const BOX_CONTENT_TYPE_EQUATION = 4;
+declare function readBoxContent(nonDeletable: Uint8Array, prefixIds: readonly number[]): WpdBoxContent | undefined;
+//#endregion
+export { BOX_CONTENT_TYPE_EQUATION, BOX_CONTENT_TYPE_IMAGE, BOX_CONTENT_TYPE_LINKED_TEXT, BOX_CONTENT_TYPE_TEXT, WpdBoxContent, WpdBoxFrame, readBoxContent };