doc-codec 1.0.2 → 1.1.1

package/dist/prop/chp.d.ts

@@ -1,4 +1,4 @@
-import { Prl } from "./sprm.js";
+import { t as Prl } from "../sprm-Djg5RNiq.js";
 import { Color } from "document-schema.js";
 //#region src/prop/chp.d.ts
 interface CharacterProperties {
@@ -8,9 +8,10 @@ interface CharacterProperties {
   strike?: boolean;
   sizePt?: number;
   color?: Color;
+  fontFamily?: string;
   /** The istd of a character style applied by sprmCIstd, carried so a caller can resolve the style's own name. */
   istd?: number;
 }
-declare function applyCharacterSprms(prls: readonly Prl[], into: CharacterProperties): CharacterProperties;
+declare function applyCharacterSprms(prls: readonly Prl[], into: CharacterProperties, fonts?: readonly string[]): CharacterProperties;
 //#endregion
 export { CharacterProperties, applyCharacterSprms };

package/dist/prop/chp.js

@@ -1,5 +1,6 @@
 import { DocFormatError } from "../errors.js";
-import { readUint16LE, readUint8 } from "../bytes.js";
+import { readInt16LE, readUint16LE, readUint8 } from "../bytes.js";
+import { icoColor, readColorRef } from "../color.js";
 import { SGC } from "./sprm.js";
 //#region src/prop/chp.ts
 /** sprmCFBold: a ToggleOperand switching bold. */
@@ -14,100 +15,18 @@ const SPRM_C_KUL = 10814;
 const SPRM_C_HPS = 19011;
 /** sprmCIstd: the istd of a character style to apply. */
 const SPRM_C_ISTD = 18992;
-/** sprmCIco: an Ico value, an index into [MS-DOC] 2.9.126's fixed 17-entry palette. */
+/** sprmCIco: an Ico value, an index into [MS-DOC] 2.9.119's fixed 17-entry palette. */
 const SPRM_C_ICO = 10818;
 /** sprmCCv: a COLORREF, the richer colour sprm that supersedes sprmCIco where both appear. */
 const SPRM_C_CV = 26736;
+/** sprmCRgFtc0: a 2-byte signed index into the font table (SttbfFfn) naming the font used "only if the conditions for using [sprmCRgFtc1/sprmCRgFtc2/sprmCFtcBi] do not apply" -- the default (non-East-Asian, non-complex-script) font, which is the only one this package reads or writes. */
+const SPRM_C_RG_FTC_0 = 19023;
 /** ToggleOperand, [MS-DOC] 2.9.336. 0x80 and 0x81 are relative to the style's own value rather than absolute. */
 const TOGGLE_OFF = 0;
 const TOGGLE_ON = 1;
 const TOGGLE_INHERIT_FROM_STYLE = 128;
 const TOGGLE_INVERT_STYLE = 129;
 const HALF_POINTS_PER_POINT = 2;
-const COLOR_COMPONENT_MAX = 255;
-const ICO_PALETTE = [
-	void 0,
-	[
-		0,
-		0,
-		0
-	],
-	[
-		0,
-		0,
-		255
-	],
-	[
-		0,
-		255,
-		255
-	],
-	[
-		0,
-		255,
-		0
-	],
-	[
-		255,
-		0,
-		255
-	],
-	[
-		255,
-		0,
-		0
-	],
-	[
-		255,
-		255,
-		0
-	],
-	[
-		255,
-		255,
-		255
-	],
-	[
-		0,
-		0,
-		128
-	],
-	[
-		0,
-		128,
-		128
-	],
-	[
-		0,
-		128,
-		0
-	],
-	[
-		128,
-		0,
-		128
-	],
-	[
-		128,
-		0,
-		128
-	],
-	[
-		128,
-		128,
-		0
-	],
-	[
-		128,
-		128,
-		128
-	],
-	[
-		192,
-		192,
-		192
-	]
-];
 function toggle(operand, current) {
 	const value = readUint8(operand, 0);
 	switch (value) {
@@ -118,26 +37,7 @@ function toggle(operand, current) {
 		default: throw new DocFormatError(`ToggleOperand value 0x${value.toString(16)} is none of the four [MS-DOC] 2.9.336 defines (0x00, 0x01, 0x80, 0x81)`);
 	}
 }
-function icoColor(value) {
-	if (value >= ICO_PALETTE.length) throw new DocFormatError(`Ico value 0x${value.toString(16)} is not less than 0x11, the bound [MS-DOC] 2.9.126 places on the palette`);
-	const entry = ICO_PALETTE[value];
-	if (entry === void 0) return void 0;
-	const [r, g, b] = entry;
-	return {
-		r: r / COLOR_COMPONENT_MAX,
-		g: g / COLOR_COMPONENT_MAX,
-		b: b / COLOR_COMPONENT_MAX
-	};
-}
-function colorRefColor(operand) {
-	if (readUint8(operand, 3) !== 0) return void 0;
-	return {
-		r: readUint8(operand, 0) / COLOR_COMPONENT_MAX,
-		g: readUint8(operand, 1) / COLOR_COMPONENT_MAX,
-		b: readUint8(operand, 2) / COLOR_COMPONENT_MAX
-	};
-}
-function applyCharacterSprms(prls, into) {
+function applyCharacterSprms(prls, into, fonts) {
 	for (const prl of prls) {
 		if (prl.sprm.sgc !== SGC.character) continue;
 		switch (prl.sprm.value) {
@@ -162,7 +62,15 @@ function applyCharacterSprms(prls, into) {
 			case SPRM_C_ICO:
 				into.color = icoColor(readUint8(prl.operand, 0));
 				break;
-			case SPRM_C_CV: into.color = colorRefColor(prl.operand);
+			case SPRM_C_CV:
+				into.color = readColorRef(prl.operand, 0);
+				break;
+			case SPRM_C_RG_FTC_0: {
+				const index = readInt16LE(prl.operand, 0);
+				const name = fonts?.[index];
+				if (name !== void 0) into.fontFamily = name;
+				break;
+			}
 		}
 	}
 	return into;

package/dist/prop/fkp-write.cjs

@@ -0,0 +1,139 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+require("./fkp.cjs");
+//#region src/prop/fkp-write.ts
+const MAX_CRUN = 101;
+const MAX_CPARA = 29;
+/** A BxPap is a 1-byte bOffset followed by a 12-byte PHE this package never populates (see fkp.ts: "the specification says SHOULD be zero and SHOULD be ignored"). */
+const BX_PAP_SIZE = 13;
+/** A Chpx's own cb is one byte, and a PapxInFkp's one-byte cb/cb' halves the GrpPrlAndIstd length -- both single-byte fields, so 255 bounds a Chpx record's cb and 510 bounds a PapxInFkp's GrpPrlAndIstd (2 x 255) before either can no longer be expressed. */
+const MAX_CHPX_RECORD_GRPPRL = 255;
+const MAX_GRP_PRL_AND_ISTD = 510;
+function buildChpxPage(runs, fcLim) {
+	const crun = runs.length;
+	if (crun < 1 || crun > MAX_CRUN) return void 0;
+	const page = /* @__PURE__ */ new Uint8Array(512);
+	const view = new DataView(page.buffer);
+	runs.forEach((run, index) => {
+		view.setUint32(index * 4, run.fc, true);
+	});
+	view.setUint32(crun * 4, fcLim, true);
+	page[511] = crun;
+	const rgbStart = (crun + 1) * 4;
+	const frontUsed = rgbStart + crun;
+	let writeAt = 511;
+	for (let index = 0; index < crun; index += 1) {
+		const run = runs[index];
+		if (run === void 0) throw new require_errors.DocFormatError("run missing from a batch already sized");
+		const rgbAt = rgbStart + index;
+		if (run.grpprl === void 0) {
+			page[rgbAt] = 0;
+			continue;
+		}
+		if (run.grpprl.length > MAX_CHPX_RECORD_GRPPRL) return void 0;
+		const record = [run.grpprl.length, ...run.grpprl];
+		writeAt -= record.length;
+		writeAt -= writeAt % 2;
+		if (writeAt < frontUsed) return void 0;
+		page.set(record, writeAt);
+		page[rgbAt] = writeAt / 2;
+	}
+	return page;
+}
+function buildPapxPage(paragraphs, fcLim) {
+	const cpara = paragraphs.length;
+	if (cpara < 1 || cpara > MAX_CPARA) return void 0;
+	const page = /* @__PURE__ */ new Uint8Array(512);
+	const view = new DataView(page.buffer);
+	paragraphs.forEach((paragraph, index) => {
+		view.setUint32(index * 4, paragraph.fc, true);
+	});
+	view.setUint32(cpara * 4, fcLim, true);
+	page[511] = cpara;
+	const bxPapStart = (cpara + 1) * 4;
+	const frontUsed = bxPapStart + cpara * BX_PAP_SIZE;
+	let writeAt = 511;
+	for (let index = 0; index < cpara; index += 1) {
+		const paragraph = paragraphs[index];
+		if (paragraph === void 0) throw new require_errors.DocFormatError("paragraph missing from a batch already sized");
+		const bxPapAt = bxPapStart + index * BX_PAP_SIZE;
+		const grpPrlAndIstd = [
+			paragraph.istd & 255,
+			paragraph.istd >> 8 & 255,
+			...paragraph.grpprl
+		];
+		if (grpPrlAndIstd.length > MAX_GRP_PRL_AND_ISTD) return void 0;
+		const record = grpPrlAndIstd.length % 2 === 1 ? [(grpPrlAndIstd.length + 1) / 2, ...grpPrlAndIstd] : [
+			0,
+			grpPrlAndIstd.length / 2,
+			...grpPrlAndIstd
+		];
+		writeAt -= record.length;
+		writeAt -= writeAt % 2;
+		if (writeAt < frontUsed) return void 0;
+		page.set(record, writeAt);
+		page[bxPapAt] = writeAt / 2;
+	}
+	return page;
+}
+function splitIntoBatches(items, fits, what) {
+	const batches = [];
+	let batch = [];
+	for (const item of items) {
+		const candidate = [...batch, item];
+		if (fits(candidate)) {
+			batch = candidate;
+			continue;
+		}
+		if (batch.length === 0) throw new require_errors.DocFormatError(`a single ${what} does not fit in one 512-byte formatted disk page`);
+		batches.push(batch);
+		batch = [item];
+		if (!fits(batch)) throw new require_errors.DocFormatError(`a single ${what} does not fit in one 512-byte formatted disk page`);
+	}
+	if (batch.length > 0) batches.push(batch);
+	return batches;
+}
+/** Splits `runs` across as many ChpxFkp pages as needed. `fcLim` is the exclusive end of the whole run sequence (the byte offset one past the document's own text). */
+function buildChpxPages(runs, fcLim) {
+	if (runs.length === 0) throw new require_errors.DocFormatError("buildChpxPages requires at least one run");
+	const batches = splitIntoBatches(runs, (batch) => buildChpxPage(batch, 0) !== void 0, "character-formatting run");
+	return batches.map((batch, index) => {
+		const next = batches[index + 1];
+		const page = buildChpxPage(batch, next === void 0 ? fcLim : next[0]?.fc ?? fcLim);
+		if (page === void 0) throw new require_errors.DocFormatError("a ChpxFkp batch that fit during splitting no longer fits when finalised; this is an internal defect");
+		return page;
+	});
+}
+/** Splits `paragraphs` across as many PapxFkp pages as needed. `fcLim` is the exclusive end of the whole paragraph sequence. */
+function buildPapxPages(paragraphs, fcLim) {
+	if (paragraphs.length === 0) throw new require_errors.DocFormatError("buildPapxPages requires at least one paragraph");
+	const batches = splitIntoBatches(paragraphs, (batch) => buildPapxPage(batch, 0) !== void 0, "paragraph-formatting record");
+	return batches.map((batch, index) => {
+		const next = batches[index + 1];
+		const page = buildPapxPage(batch, next === void 0 ? fcLim : next[0]?.fc ?? fcLim);
+		if (page === void 0) throw new require_errors.DocFormatError("a PapxFkp batch that fit during splitting no longer fits when finalised; this is an internal defect");
+		return page;
+	});
+}
+/** A built page's own first rgfc entry -- the byte offset of the first run or paragraph it covers. Reading it back out of the page's own bytes, rather than threading it through as separate metadata, keeps the bin table's keys and the page's own content provably in agreement: there is exactly one place either could disagree with itself. */
+function firstFcOfPage(page) {
+	return new DataView(page.buffer, page.byteOffset, 4).getUint32(0, true);
+}
+/** Builds a PlcBteChpx or PlcBtePapx: the bin table mapping each page's own starting byte offset (plus a final terminating fcLim) to its page number. `firstFcs` must carry exactly one more entry than `pageNumbers` -- see plc.ts's own PLC shape. */
+function buildPropertyBinTable(firstFcs, pageNumbers) {
+	if (firstFcs.length !== pageNumbers.length + 1) throw new require_errors.DocFormatError(`buildPropertyBinTable was given ${firstFcs.length} keys for ${pageNumbers.length} page numbers; a PLC needs exactly one more key than element`);
+	const bytes = new Uint8Array(firstFcs.length * 4 + pageNumbers.length * 4);
+	const view = new DataView(bytes.buffer);
+	firstFcs.forEach((fc, index) => {
+		view.setUint32(index * 4, fc, true);
+	});
+	pageNumbers.forEach((pageNumber, index) => {
+		view.setUint32(firstFcs.length * 4 + index * 4, pageNumber, true);
+	});
+	return bytes;
+}
+//#endregion
+exports.buildChpxPages = buildChpxPages;
+exports.buildPapxPages = buildPapxPages;
+exports.buildPropertyBinTable = buildPropertyBinTable;
+exports.firstFcOfPage = firstFcOfPage;

package/dist/prop/fkp-write.d.cts

@@ -0,0 +1,21 @@
+//#region src/prop/fkp-write.d.ts
+interface ChpxRunToWrite {
+  readonly fc: number;
+  /** undefined writes rgb 0 -- "no exception, default properties" -- exactly what parseChpxFkp reads back as undefined. */
+  readonly grpprl: readonly number[] | undefined;
+}
+interface PapxParagraphToWrite {
+  readonly fc: number;
+  readonly istd: number;
+  readonly grpprl: readonly number[];
+}
+/** Splits `runs` across as many ChpxFkp pages as needed. `fcLim` is the exclusive end of the whole run sequence (the byte offset one past the document's own text). */
+declare function buildChpxPages(runs: readonly ChpxRunToWrite[], fcLim: number): Uint8Array[];
+/** Splits `paragraphs` across as many PapxFkp pages as needed. `fcLim` is the exclusive end of the whole paragraph sequence. */
+declare function buildPapxPages(paragraphs: readonly PapxParagraphToWrite[], fcLim: number): Uint8Array[];
+/** A built page's own first rgfc entry -- the byte offset of the first run or paragraph it covers. Reading it back out of the page's own bytes, rather than threading it through as separate metadata, keeps the bin table's keys and the page's own content provably in agreement: there is exactly one place either could disagree with itself. */
+declare function firstFcOfPage(page: Uint8Array): number;
+/** Builds a PlcBteChpx or PlcBtePapx: the bin table mapping each page's own starting byte offset (plus a final terminating fcLim) to its page number. `firstFcs` must carry exactly one more entry than `pageNumbers` -- see plc.ts's own PLC shape. */
+declare function buildPropertyBinTable(firstFcs: readonly number[], pageNumbers: readonly number[]): Uint8Array;
+//#endregion
+export { ChpxRunToWrite, PapxParagraphToWrite, buildChpxPages, buildPapxPages, buildPropertyBinTable, firstFcOfPage };

package/dist/prop/fkp-write.d.ts

@@ -0,0 +1,21 @@
+//#region src/prop/fkp-write.d.ts
+interface ChpxRunToWrite {
+  readonly fc: number;
+  /** undefined writes rgb 0 -- "no exception, default properties" -- exactly what parseChpxFkp reads back as undefined. */
+  readonly grpprl: readonly number[] | undefined;
+}
+interface PapxParagraphToWrite {
+  readonly fc: number;
+  readonly istd: number;
+  readonly grpprl: readonly number[];
+}
+/** Splits `runs` across as many ChpxFkp pages as needed. `fcLim` is the exclusive end of the whole run sequence (the byte offset one past the document's own text). */
+declare function buildChpxPages(runs: readonly ChpxRunToWrite[], fcLim: number): Uint8Array[];
+/** Splits `paragraphs` across as many PapxFkp pages as needed. `fcLim` is the exclusive end of the whole paragraph sequence. */
+declare function buildPapxPages(paragraphs: readonly PapxParagraphToWrite[], fcLim: number): Uint8Array[];
+/** A built page's own first rgfc entry -- the byte offset of the first run or paragraph it covers. Reading it back out of the page's own bytes, rather than threading it through as separate metadata, keeps the bin table's keys and the page's own content provably in agreement: there is exactly one place either could disagree with itself. */
+declare function firstFcOfPage(page: Uint8Array): number;
+/** Builds a PlcBteChpx or PlcBtePapx: the bin table mapping each page's own starting byte offset (plus a final terminating fcLim) to its page number. `firstFcs` must carry exactly one more entry than `pageNumbers` -- see plc.ts's own PLC shape. */
+declare function buildPropertyBinTable(firstFcs: readonly number[], pageNumbers: readonly number[]): Uint8Array;
+//#endregion
+export { ChpxRunToWrite, PapxParagraphToWrite, buildChpxPages, buildPapxPages, buildPropertyBinTable, firstFcOfPage };

package/dist/prop/fkp-write.js

@@ -0,0 +1,135 @@
+import { DocFormatError } from "../errors.js";
+import "./fkp.js";
+//#region src/prop/fkp-write.ts
+const MAX_CRUN = 101;
+const MAX_CPARA = 29;
+/** A BxPap is a 1-byte bOffset followed by a 12-byte PHE this package never populates (see fkp.ts: "the specification says SHOULD be zero and SHOULD be ignored"). */
+const BX_PAP_SIZE = 13;
+/** A Chpx's own cb is one byte, and a PapxInFkp's one-byte cb/cb' halves the GrpPrlAndIstd length -- both single-byte fields, so 255 bounds a Chpx record's cb and 510 bounds a PapxInFkp's GrpPrlAndIstd (2 x 255) before either can no longer be expressed. */
+const MAX_CHPX_RECORD_GRPPRL = 255;
+const MAX_GRP_PRL_AND_ISTD = 510;
+function buildChpxPage(runs, fcLim) {
+	const crun = runs.length;
+	if (crun < 1 || crun > MAX_CRUN) return void 0;
+	const page = /* @__PURE__ */ new Uint8Array(512);
+	const view = new DataView(page.buffer);
+	runs.forEach((run, index) => {
+		view.setUint32(index * 4, run.fc, true);
+	});
+	view.setUint32(crun * 4, fcLim, true);
+	page[511] = crun;
+	const rgbStart = (crun + 1) * 4;
+	const frontUsed = rgbStart + crun;
+	let writeAt = 511;
+	for (let index = 0; index < crun; index += 1) {
+		const run = runs[index];
+		if (run === void 0) throw new DocFormatError("run missing from a batch already sized");
+		const rgbAt = rgbStart + index;
+		if (run.grpprl === void 0) {
+			page[rgbAt] = 0;
+			continue;
+		}
+		if (run.grpprl.length > MAX_CHPX_RECORD_GRPPRL) return void 0;
+		const record = [run.grpprl.length, ...run.grpprl];
+		writeAt -= record.length;
+		writeAt -= writeAt % 2;
+		if (writeAt < frontUsed) return void 0;
+		page.set(record, writeAt);
+		page[rgbAt] = writeAt / 2;
+	}
+	return page;
+}
+function buildPapxPage(paragraphs, fcLim) {
+	const cpara = paragraphs.length;
+	if (cpara < 1 || cpara > MAX_CPARA) return void 0;
+	const page = /* @__PURE__ */ new Uint8Array(512);
+	const view = new DataView(page.buffer);
+	paragraphs.forEach((paragraph, index) => {
+		view.setUint32(index * 4, paragraph.fc, true);
+	});
+	view.setUint32(cpara * 4, fcLim, true);
+	page[511] = cpara;
+	const bxPapStart = (cpara + 1) * 4;
+	const frontUsed = bxPapStart + cpara * BX_PAP_SIZE;
+	let writeAt = 511;
+	for (let index = 0; index < cpara; index += 1) {
+		const paragraph = paragraphs[index];
+		if (paragraph === void 0) throw new DocFormatError("paragraph missing from a batch already sized");
+		const bxPapAt = bxPapStart + index * BX_PAP_SIZE;
+		const grpPrlAndIstd = [
+			paragraph.istd & 255,
+			paragraph.istd >> 8 & 255,
+			...paragraph.grpprl
+		];
+		if (grpPrlAndIstd.length > MAX_GRP_PRL_AND_ISTD) return void 0;
+		const record = grpPrlAndIstd.length % 2 === 1 ? [(grpPrlAndIstd.length + 1) / 2, ...grpPrlAndIstd] : [
+			0,
+			grpPrlAndIstd.length / 2,
+			...grpPrlAndIstd
+		];
+		writeAt -= record.length;
+		writeAt -= writeAt % 2;
+		if (writeAt < frontUsed) return void 0;
+		page.set(record, writeAt);
+		page[bxPapAt] = writeAt / 2;
+	}
+	return page;
+}
+function splitIntoBatches(items, fits, what) {
+	const batches = [];
+	let batch = [];
+	for (const item of items) {
+		const candidate = [...batch, item];
+		if (fits(candidate)) {
+			batch = candidate;
+			continue;
+		}
+		if (batch.length === 0) throw new DocFormatError(`a single ${what} does not fit in one 512-byte formatted disk page`);
+		batches.push(batch);
+		batch = [item];
+		if (!fits(batch)) throw new DocFormatError(`a single ${what} does not fit in one 512-byte formatted disk page`);
+	}
+	if (batch.length > 0) batches.push(batch);
+	return batches;
+}
+/** Splits `runs` across as many ChpxFkp pages as needed. `fcLim` is the exclusive end of the whole run sequence (the byte offset one past the document's own text). */
+function buildChpxPages(runs, fcLim) {
+	if (runs.length === 0) throw new DocFormatError("buildChpxPages requires at least one run");
+	const batches = splitIntoBatches(runs, (batch) => buildChpxPage(batch, 0) !== void 0, "character-formatting run");
+	return batches.map((batch, index) => {
+		const next = batches[index + 1];
+		const page = buildChpxPage(batch, next === void 0 ? fcLim : next[0]?.fc ?? fcLim);
+		if (page === void 0) throw new DocFormatError("a ChpxFkp batch that fit during splitting no longer fits when finalised; this is an internal defect");
+		return page;
+	});
+}
+/** Splits `paragraphs` across as many PapxFkp pages as needed. `fcLim` is the exclusive end of the whole paragraph sequence. */
+function buildPapxPages(paragraphs, fcLim) {
+	if (paragraphs.length === 0) throw new DocFormatError("buildPapxPages requires at least one paragraph");
+	const batches = splitIntoBatches(paragraphs, (batch) => buildPapxPage(batch, 0) !== void 0, "paragraph-formatting record");
+	return batches.map((batch, index) => {
+		const next = batches[index + 1];
+		const page = buildPapxPage(batch, next === void 0 ? fcLim : next[0]?.fc ?? fcLim);
+		if (page === void 0) throw new DocFormatError("a PapxFkp batch that fit during splitting no longer fits when finalised; this is an internal defect");
+		return page;
+	});
+}
+/** A built page's own first rgfc entry -- the byte offset of the first run or paragraph it covers. Reading it back out of the page's own bytes, rather than threading it through as separate metadata, keeps the bin table's keys and the page's own content provably in agreement: there is exactly one place either could disagree with itself. */
+function firstFcOfPage(page) {
+	return new DataView(page.buffer, page.byteOffset, 4).getUint32(0, true);
+}
+/** Builds a PlcBteChpx or PlcBtePapx: the bin table mapping each page's own starting byte offset (plus a final terminating fcLim) to its page number. `firstFcs` must carry exactly one more entry than `pageNumbers` -- see plc.ts's own PLC shape. */
+function buildPropertyBinTable(firstFcs, pageNumbers) {
+	if (firstFcs.length !== pageNumbers.length + 1) throw new DocFormatError(`buildPropertyBinTable was given ${firstFcs.length} keys for ${pageNumbers.length} page numbers; a PLC needs exactly one more key than element`);
+	const bytes = new Uint8Array(firstFcs.length * 4 + pageNumbers.length * 4);
+	const view = new DataView(bytes.buffer);
+	firstFcs.forEach((fc, index) => {
+		view.setUint32(index * 4, fc, true);
+	});
+	pageNumbers.forEach((pageNumber, index) => {
+		view.setUint32(firstFcs.length * 4 + index * 4, pageNumber, true);
+	});
+	return bytes;
+}
+//#endregion
+export { buildChpxPages, buildPapxPages, buildPropertyBinTable, firstFcOfPage };

package/dist/prop/pap-write.cjs

@@ -0,0 +1,67 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+//#region src/prop/pap-write.ts
+/** sprmPJc: a 1-byte logical justification. */
+const SPRM_P_JC = 9313;
+/** sprmPDxaLeft / sprmPDxaLeft1: 2-byte signed twips. There is no writer-side counterpart for sprmPDxaRight (indent from the right margin): pap.ts's own reader folds it into a ParagraphProperties.indentRightPt field, but ContentParagraphSchema (document-schema.js) carries no such field for any writer to round-trip -- the right-indent value the reader computes is simply not part of the shared schema's paragraph vocabulary. */
+const SPRM_P_DXA_LEFT = 33886;
+const SPRM_P_DXA_LEFT1 = 33888;
+/** sprmPDyaBefore / sprmPDyaAfter: 2-byte unsigned twips. */
+const SPRM_P_DYA_BEFORE = 42003;
+const SPRM_P_DYA_AFTER = 42004;
+/** sprmPDyaLine: a 4-byte LSPD (dyaLine int16, fMultLinespace uint16). */
+const SPRM_P_DYA_LINE = 25618;
+/** sprmPFPageBreakBefore: a 1-byte Bool8. */
+const SPRM_P_F_PAGE_BREAK_BEFORE = 9223;
+const TWIPS_PER_POINT = 20;
+const LSPD_MULTIPLE_DIVISOR = 240;
+const LSPD_MAX_MULTIPLE_DYA_LINE = 31680;
+/** sprmPDxaLeft/Right/Left1's signed 2-byte operand range. */
+const MIN_INT16 = -32768;
+const MAX_INT16 = 32767;
+/** sprmPDyaBefore/After's unsigned 2-byte operand range. */
+const MAX_UINT16 = 65535;
+const JC_VALUE = {
+	left: 0,
+	center: 1,
+	right: 2,
+	justify: 3
+};
+function pushSprm(bytes, opcode, operand) {
+	bytes.push(opcode & 255, opcode >> 8 & 255, ...operand);
+}
+function int16(value, what) {
+	const rounded = Math.round(value);
+	if (rounded < MIN_INT16 || rounded > MAX_INT16) throw new require_errors.DocFormatError(`${what} is ${rounded} twips, outside the ${MIN_INT16}..${MAX_INT16} range a signed 2-byte sprm operand can hold`);
+	const unsigned = rounded < 0 ? rounded + 65536 : rounded;
+	return [unsigned & 255, unsigned >> 8 & 255];
+}
+function uint16(value, what) {
+	const rounded = Math.round(value);
+	if (rounded < 0 || rounded > MAX_UINT16) throw new require_errors.DocFormatError(`${what} is ${rounded} twips, outside the 0..${MAX_UINT16} range an unsigned 2-byte sprm operand can hold`);
+	return [rounded & 255, rounded >> 8 & 255];
+}
+function pointsToTwips(pt) {
+	return pt * TWIPS_PER_POINT;
+}
+function encodeParagraphGrpprl(paragraph) {
+	const bytes = [];
+	if (paragraph.alignment !== void 0) pushSprm(bytes, SPRM_P_JC, [JC_VALUE[paragraph.alignment]]);
+	if (paragraph.indentLeftPt !== void 0) pushSprm(bytes, SPRM_P_DXA_LEFT, int16(pointsToTwips(paragraph.indentLeftPt), "paragraph indentLeftPt"));
+	if (paragraph.indentFirstLinePt !== void 0) pushSprm(bytes, SPRM_P_DXA_LEFT1, int16(pointsToTwips(paragraph.indentFirstLinePt), "paragraph indentFirstLinePt"));
+	if (paragraph.spacingBeforePt !== void 0) pushSprm(bytes, SPRM_P_DYA_BEFORE, uint16(pointsToTwips(paragraph.spacingBeforePt), "paragraph spacingBeforePt"));
+	if (paragraph.spacingAfterPt !== void 0) pushSprm(bytes, SPRM_P_DYA_AFTER, uint16(pointsToTwips(paragraph.spacingAfterPt), "paragraph spacingAfterPt"));
+	if (paragraph.lineSpacing !== void 0) {
+		const dyaLine = Math.round(paragraph.lineSpacing * LSPD_MULTIPLE_DIVISOR);
+		if (dyaLine < 0 || dyaLine > LSPD_MAX_MULTIPLE_DYA_LINE) throw new require_errors.DocFormatError(`paragraph lineSpacing ${paragraph.lineSpacing} produces an LSPD.dyaLine of ${dyaLine}, outside the 0..${LSPD_MAX_MULTIPLE_DYA_LINE} range the multiplier form permits`);
+		pushSprm(bytes, SPRM_P_DYA_LINE, [
+			...int16(dyaLine, "paragraph lineSpacing"),
+			1,
+			0
+		]);
+	}
+	if (paragraph.pageBreakBefore === true) pushSprm(bytes, SPRM_P_F_PAGE_BREAK_BEFORE, [1]);
+	return bytes;
+}
+//#endregion
+exports.encodeParagraphGrpprl = encodeParagraphGrpprl;

package/dist/prop/pap-write.d.cts

@@ -0,0 +1,5 @@
+import { ContentParagraph } from "document-schema.js";
+//#region src/prop/pap-write.d.ts
+declare function encodeParagraphGrpprl(paragraph: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore">): number[];
+//#endregion
+export { encodeParagraphGrpprl };

package/dist/prop/pap-write.d.ts

@@ -0,0 +1,5 @@
+import { ContentParagraph } from "document-schema.js";
+//#region src/prop/pap-write.d.ts
+declare function encodeParagraphGrpprl(paragraph: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore">): number[];
+//#endregion
+export { encodeParagraphGrpprl };

package/dist/prop/pap-write.js

@@ -0,0 +1,66 @@
+import { DocFormatError } from "../errors.js";
+//#region src/prop/pap-write.ts
+/** sprmPJc: a 1-byte logical justification. */
+const SPRM_P_JC = 9313;
+/** sprmPDxaLeft / sprmPDxaLeft1: 2-byte signed twips. There is no writer-side counterpart for sprmPDxaRight (indent from the right margin): pap.ts's own reader folds it into a ParagraphProperties.indentRightPt field, but ContentParagraphSchema (document-schema.js) carries no such field for any writer to round-trip -- the right-indent value the reader computes is simply not part of the shared schema's paragraph vocabulary. */
+const SPRM_P_DXA_LEFT = 33886;
+const SPRM_P_DXA_LEFT1 = 33888;
+/** sprmPDyaBefore / sprmPDyaAfter: 2-byte unsigned twips. */
+const SPRM_P_DYA_BEFORE = 42003;
+const SPRM_P_DYA_AFTER = 42004;
+/** sprmPDyaLine: a 4-byte LSPD (dyaLine int16, fMultLinespace uint16). */
+const SPRM_P_DYA_LINE = 25618;
+/** sprmPFPageBreakBefore: a 1-byte Bool8. */
+const SPRM_P_F_PAGE_BREAK_BEFORE = 9223;
+const TWIPS_PER_POINT = 20;
+const LSPD_MULTIPLE_DIVISOR = 240;
+const LSPD_MAX_MULTIPLE_DYA_LINE = 31680;
+/** sprmPDxaLeft/Right/Left1's signed 2-byte operand range. */
+const MIN_INT16 = -32768;
+const MAX_INT16 = 32767;
+/** sprmPDyaBefore/After's unsigned 2-byte operand range. */
+const MAX_UINT16 = 65535;
+const JC_VALUE = {
+	left: 0,
+	center: 1,
+	right: 2,
+	justify: 3
+};
+function pushSprm(bytes, opcode, operand) {
+	bytes.push(opcode & 255, opcode >> 8 & 255, ...operand);
+}
+function int16(value, what) {
+	const rounded = Math.round(value);
+	if (rounded < MIN_INT16 || rounded > MAX_INT16) throw new DocFormatError(`${what} is ${rounded} twips, outside the ${MIN_INT16}..${MAX_INT16} range a signed 2-byte sprm operand can hold`);
+	const unsigned = rounded < 0 ? rounded + 65536 : rounded;
+	return [unsigned & 255, unsigned >> 8 & 255];
+}
+function uint16(value, what) {
+	const rounded = Math.round(value);
+	if (rounded < 0 || rounded > MAX_UINT16) throw new DocFormatError(`${what} is ${rounded} twips, outside the 0..${MAX_UINT16} range an unsigned 2-byte sprm operand can hold`);
+	return [rounded & 255, rounded >> 8 & 255];
+}
+function pointsToTwips(pt) {
+	return pt * TWIPS_PER_POINT;
+}
+function encodeParagraphGrpprl(paragraph) {
+	const bytes = [];
+	if (paragraph.alignment !== void 0) pushSprm(bytes, SPRM_P_JC, [JC_VALUE[paragraph.alignment]]);
+	if (paragraph.indentLeftPt !== void 0) pushSprm(bytes, SPRM_P_DXA_LEFT, int16(pointsToTwips(paragraph.indentLeftPt), "paragraph indentLeftPt"));
+	if (paragraph.indentFirstLinePt !== void 0) pushSprm(bytes, SPRM_P_DXA_LEFT1, int16(pointsToTwips(paragraph.indentFirstLinePt), "paragraph indentFirstLinePt"));
+	if (paragraph.spacingBeforePt !== void 0) pushSprm(bytes, SPRM_P_DYA_BEFORE, uint16(pointsToTwips(paragraph.spacingBeforePt), "paragraph spacingBeforePt"));
+	if (paragraph.spacingAfterPt !== void 0) pushSprm(bytes, SPRM_P_DYA_AFTER, uint16(pointsToTwips(paragraph.spacingAfterPt), "paragraph spacingAfterPt"));
+	if (paragraph.lineSpacing !== void 0) {
+		const dyaLine = Math.round(paragraph.lineSpacing * LSPD_MULTIPLE_DIVISOR);
+		if (dyaLine < 0 || dyaLine > LSPD_MAX_MULTIPLE_DYA_LINE) throw new DocFormatError(`paragraph lineSpacing ${paragraph.lineSpacing} produces an LSPD.dyaLine of ${dyaLine}, outside the 0..${LSPD_MAX_MULTIPLE_DYA_LINE} range the multiplier form permits`);
+		pushSprm(bytes, SPRM_P_DYA_LINE, [
+			...int16(dyaLine, "paragraph lineSpacing"),
+			1,
+			0
+		]);
+	}
+	if (paragraph.pageBreakBefore === true) pushSprm(bytes, SPRM_P_F_PAGE_BREAK_BEFORE, [1]);
+	return bytes;
+}
+//#endregion
+export { encodeParagraphGrpprl };

package/dist/prop/pap.cjs

@@ -34,6 +34,11 @@ const SPRM_P_F_TTP = 9239;
 const SPRM_P_ILVL = 9738;
 /** sprmPIlfo: which list the paragraph is in, as an index into PlfLfo.rgLfo. */
 const SPRM_P_ILFO = 17931;
+/** sprmPItap: the paragraph's own table depth -- read only far enough to detect a depth greater than 1 (a table nested inside a table cell), which this package refuses rather than mis-reads. */
+const SPRM_P_ITAP = 26185;
+/** sprmPFInnerTableCell / sprmPFInnerTtp: a nested table's own cell-ending or row-ending mark. Neither is acted on beyond refusing the nested table it signals. */
+const SPRM_P_F_INNER_TABLE_CELL = 9291;
+const SPRM_P_F_INNER_TTP = 9292;
 const TWIPS_PER_POINT = 20;
 /** LSPD: "The spacing multiplier is dyaLine/240." */
 const LSPD_MULTIPLE_DIVISOR = 240;
@@ -126,6 +131,11 @@ function applyParagraphSprms(prls, into) {
 				into.listId = ilfo === ILFO_NOT_IN_LIST || ilfo === ILFO_NOT_IN_LIST_ALT ? void 0 : Math.abs(ilfo);
 				break;
 			}
+			case SPRM_P_ITAP:
+				into.tableDepth = require_bytes.readUint32LE(prl.operand, 0);
+				break;
+			case SPRM_P_F_INNER_TABLE_CELL:
+			case SPRM_P_F_INNER_TTP: if (require_bytes.readUint8(prl.operand, 0) !== 0) into.nestedTableMark = true;
 		}
 	}
 	return into;