doc-codec 2.4.3 → 2.5.0

package/dist/pictures.cjs

@@ -0,0 +1,93 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_bytes = require("./bytes.cjs");
+//#region src/pictures.ts
+const PICF_SIZE = 68;
+const PICF_MM_OFFSET = 6;
+const PICF_DXA_GOAL_OFFSET = 28;
+const PICF_DYA_GOAL_OFFSET = 30;
+const PICF_MX_OFFSET = 32;
+const PICF_MY_OFFSET = 34;
+/** MFPF.mm's MM_SHAPEFILE value, [MS-DOC] 2.9.181 -- the one case PICFAndOfficeArtData carries an extra cchPicName/stPicName pair (the picture's own source file name) before `picture` begins. */
+const MM_SHAPEFILE = 102;
+const RECORD_HEADER_SIZE = 8;
+/** OfficeArtBlipJPEG, [MS-ODRAW] 2.2.27. */
+const BLIP_JPEG = 61469;
+/** OfficeArtBlipPNG, [MS-ODRAW] 2.2.28. */
+const BLIP_PNG = 61470;
+/** rh.recInstance values naming a single rgbUid (16 bytes) rather than two (32 bytes) -- [MS-ODRAW] 2.2.27's own table for JPEG (RGB and CMYK) and 2.2.28's for PNG. */
+const ONE_UID_INSTANCES = /* @__PURE__ */ new Set([
+	1130,
+	1762,
+	1760
+]);
+const TWO_UID_INSTANCES = /* @__PURE__ */ new Set([
+	1131,
+	1763,
+	1761
+]);
+/** The one byte following rgbUid(1|2) in every OfficeArtBlip variant this module reads, before the raw file bytes themselves. */
+const BLIP_TAG_SIZE = 1;
+const TWIPS_PER_POINT = 20;
+/** mx/my, [MS-DOC] PICMID: "the ratio, measured in tenths of a percent, between the final display width/height and the initial picture width/height". */
+const SCALE_DENOMINATOR = 1e3;
+function readRecordHeader(data, offset) {
+	return {
+		recInstance: require_bytes.readUint16LE(data, offset) >> 4 & 4095,
+		recType: require_bytes.readUint16LE(data, offset + 2),
+		recLen: require_bytes.readUint32LE(data, offset + 4)
+	};
+}
+/** Resolves one inline picture character's own sprmCPicLocation offset into a ContentImageBlock, or undefined when the picture's own blip is a format this package does not decode (see this module's own top comment) -- never thrown, since an unsupported picture format is exactly the kind of absence the rest of this reader already treats as "read with fewer properties than it states" rather than a document-level failure. */
+function readInlinePicture(dataStream, picLocation) {
+	const picf = require_bytes.slice(dataStream, picLocation, PICF_SIZE, "PICF in the Data stream");
+	const mm = require_bytes.readUint16LE(picf, PICF_MM_OFFSET);
+	const dxaGoal = require_bytes.readInt16LE(picf, PICF_DXA_GOAL_OFFSET);
+	const dyaGoal = require_bytes.readInt16LE(picf, PICF_DYA_GOAL_OFFSET);
+	const mx = require_bytes.readUint16LE(picf, PICF_MX_OFFSET);
+	const my = require_bytes.readUint16LE(picf, PICF_MY_OFFSET);
+	let cursor = picLocation + PICF_SIZE;
+	if (mm === MM_SHAPEFILE) {
+		const cchPicName = require_bytes.readUint8(dataStream, cursor);
+		cursor += 1 + cchPicName;
+	}
+	const shapeHeader = readRecordHeader(dataStream, cursor);
+	cursor += RECORD_HEADER_SIZE + shapeHeader.recLen;
+	const blipHeader = readRecordHeader(dataStream, cursor);
+	const format = blipFormat(blipHeader.recType);
+	if (format === void 0) return void 0;
+	const uidBytes = ONE_UID_INSTANCES.has(blipHeader.recInstance) ? 16 : TWO_UID_INSTANCES.has(blipHeader.recInstance) ? 32 : void 0;
+	if (uidBytes === void 0) return void 0;
+	const blipDataStart = cursor + RECORD_HEADER_SIZE + uidBytes + BLIP_TAG_SIZE;
+	const blipDataLength = blipHeader.recLen - uidBytes - BLIP_TAG_SIZE;
+	return {
+		kind: "image",
+		format,
+		base64: bytesToBase64(require_bytes.slice(dataStream, blipDataStart, blipDataLength, "OfficeArtBlip file data in the Data stream")),
+		widthPt: dxaGoal * mx / SCALE_DENOMINATOR / TWIPS_PER_POINT,
+		heightPt: dyaGoal * my / SCALE_DENOMINATOR / TWIPS_PER_POINT
+	};
+}
+function blipFormat(recType) {
+	switch (recType) {
+		case BLIP_JPEG: return "jpeg";
+		case BLIP_PNG: return "png";
+		default: return;
+	}
+}
+const BASE64_TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function bytesToBase64(bytes) {
+	let out = "";
+	const len = bytes.length;
+	for (let index = 0; index < len; index += 3) {
+		const b0 = bytes[index] ?? 0;
+		const b1 = index + 1 < len ? bytes[index + 1] ?? 0 : 0;
+		const b2 = index + 2 < len ? bytes[index + 2] ?? 0 : 0;
+		out += BASE64_TABLE.charAt(b0 >> 2);
+		out += BASE64_TABLE.charAt((b0 & 3) << 4 | b1 >> 4);
+		out += index + 1 < len ? BASE64_TABLE.charAt((b1 & 15) << 2 | b2 >> 6) : "=";
+		out += index + 2 < len ? BASE64_TABLE.charAt(b2 & 63) : "=";
+	}
+	return out;
+}
+//#endregion
+exports.readInlinePicture = readInlinePicture;

package/dist/pictures.d.cts

@@ -0,0 +1,6 @@
+import { ContentImageBlock } from "document-schema.js";
+//#region src/pictures.d.ts
+/** Resolves one inline picture character's own sprmCPicLocation offset into a ContentImageBlock, or undefined when the picture's own blip is a format this package does not decode (see this module's own top comment) -- never thrown, since an unsupported picture format is exactly the kind of absence the rest of this reader already treats as "read with fewer properties than it states" rather than a document-level failure. */
+declare function readInlinePicture(dataStream: Uint8Array, picLocation: number): ContentImageBlock | undefined;
+//#endregion
+export { readInlinePicture };

package/dist/pictures.d.ts

@@ -0,0 +1,6 @@
+import { ContentImageBlock } from "document-schema.js";
+//#region src/pictures.d.ts
+/** Resolves one inline picture character's own sprmCPicLocation offset into a ContentImageBlock, or undefined when the picture's own blip is a format this package does not decode (see this module's own top comment) -- never thrown, since an unsupported picture format is exactly the kind of absence the rest of this reader already treats as "read with fewer properties than it states" rather than a document-level failure. */
+declare function readInlinePicture(dataStream: Uint8Array, picLocation: number): ContentImageBlock | undefined;
+//#endregion
+export { readInlinePicture };

package/dist/pictures.js

@@ -0,0 +1,92 @@
+import { readInt16LE, readUint16LE, readUint32LE, readUint8, slice } from "./bytes.js";
+//#region src/pictures.ts
+const PICF_SIZE = 68;
+const PICF_MM_OFFSET = 6;
+const PICF_DXA_GOAL_OFFSET = 28;
+const PICF_DYA_GOAL_OFFSET = 30;
+const PICF_MX_OFFSET = 32;
+const PICF_MY_OFFSET = 34;
+/** MFPF.mm's MM_SHAPEFILE value, [MS-DOC] 2.9.181 -- the one case PICFAndOfficeArtData carries an extra cchPicName/stPicName pair (the picture's own source file name) before `picture` begins. */
+const MM_SHAPEFILE = 102;
+const RECORD_HEADER_SIZE = 8;
+/** OfficeArtBlipJPEG, [MS-ODRAW] 2.2.27. */
+const BLIP_JPEG = 61469;
+/** OfficeArtBlipPNG, [MS-ODRAW] 2.2.28. */
+const BLIP_PNG = 61470;
+/** rh.recInstance values naming a single rgbUid (16 bytes) rather than two (32 bytes) -- [MS-ODRAW] 2.2.27's own table for JPEG (RGB and CMYK) and 2.2.28's for PNG. */
+const ONE_UID_INSTANCES = /* @__PURE__ */ new Set([
+	1130,
+	1762,
+	1760
+]);
+const TWO_UID_INSTANCES = /* @__PURE__ */ new Set([
+	1131,
+	1763,
+	1761
+]);
+/** The one byte following rgbUid(1|2) in every OfficeArtBlip variant this module reads, before the raw file bytes themselves. */
+const BLIP_TAG_SIZE = 1;
+const TWIPS_PER_POINT = 20;
+/** mx/my, [MS-DOC] PICMID: "the ratio, measured in tenths of a percent, between the final display width/height and the initial picture width/height". */
+const SCALE_DENOMINATOR = 1e3;
+function readRecordHeader(data, offset) {
+	return {
+		recInstance: readUint16LE(data, offset) >> 4 & 4095,
+		recType: readUint16LE(data, offset + 2),
+		recLen: readUint32LE(data, offset + 4)
+	};
+}
+/** Resolves one inline picture character's own sprmCPicLocation offset into a ContentImageBlock, or undefined when the picture's own blip is a format this package does not decode (see this module's own top comment) -- never thrown, since an unsupported picture format is exactly the kind of absence the rest of this reader already treats as "read with fewer properties than it states" rather than a document-level failure. */
+function readInlinePicture(dataStream, picLocation) {
+	const picf = slice(dataStream, picLocation, PICF_SIZE, "PICF in the Data stream");
+	const mm = readUint16LE(picf, PICF_MM_OFFSET);
+	const dxaGoal = readInt16LE(picf, PICF_DXA_GOAL_OFFSET);
+	const dyaGoal = readInt16LE(picf, PICF_DYA_GOAL_OFFSET);
+	const mx = readUint16LE(picf, PICF_MX_OFFSET);
+	const my = readUint16LE(picf, PICF_MY_OFFSET);
+	let cursor = picLocation + PICF_SIZE;
+	if (mm === MM_SHAPEFILE) {
+		const cchPicName = readUint8(dataStream, cursor);
+		cursor += 1 + cchPicName;
+	}
+	const shapeHeader = readRecordHeader(dataStream, cursor);
+	cursor += RECORD_HEADER_SIZE + shapeHeader.recLen;
+	const blipHeader = readRecordHeader(dataStream, cursor);
+	const format = blipFormat(blipHeader.recType);
+	if (format === void 0) return void 0;
+	const uidBytes = ONE_UID_INSTANCES.has(blipHeader.recInstance) ? 16 : TWO_UID_INSTANCES.has(blipHeader.recInstance) ? 32 : void 0;
+	if (uidBytes === void 0) return void 0;
+	const blipDataStart = cursor + RECORD_HEADER_SIZE + uidBytes + BLIP_TAG_SIZE;
+	const blipDataLength = blipHeader.recLen - uidBytes - BLIP_TAG_SIZE;
+	return {
+		kind: "image",
+		format,
+		base64: bytesToBase64(slice(dataStream, blipDataStart, blipDataLength, "OfficeArtBlip file data in the Data stream")),
+		widthPt: dxaGoal * mx / SCALE_DENOMINATOR / TWIPS_PER_POINT,
+		heightPt: dyaGoal * my / SCALE_DENOMINATOR / TWIPS_PER_POINT
+	};
+}
+function blipFormat(recType) {
+	switch (recType) {
+		case BLIP_JPEG: return "jpeg";
+		case BLIP_PNG: return "png";
+		default: return;
+	}
+}
+const BASE64_TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function bytesToBase64(bytes) {
+	let out = "";
+	const len = bytes.length;
+	for (let index = 0; index < len; index += 3) {
+		const b0 = bytes[index] ?? 0;
+		const b1 = index + 1 < len ? bytes[index + 1] ?? 0 : 0;
+		const b2 = index + 2 < len ? bytes[index + 2] ?? 0 : 0;
+		out += BASE64_TABLE.charAt(b0 >> 2);
+		out += BASE64_TABLE.charAt((b0 & 3) << 4 | b1 >> 4);
+		out += index + 1 < len ? BASE64_TABLE.charAt((b1 & 15) << 2 | b2 >> 6) : "=";
+		out += index + 2 < len ? BASE64_TABLE.charAt(b2 & 63) : "=";
+	}
+	return out;
+}
+//#endregion
+export { readInlinePicture };

package/dist/piece-table-CA18mhjv.d.cts

@@ -0,0 +1,28 @@
+//#region src/text/piece-table.d.ts
+interface Piece {
+  /** The first character position this piece supplies, PlcPcd.aCp[i]. */
+  readonly cpStart: number;
+  /** One past the last character position this piece supplies, PlcPcd.aCp[i + 1]. */
+  readonly cpEnd: number;
+  /** FcCompressed's 30-bit offset field as stored -- NOT yet halved for a compressed piece. Use characterOffset() rather than this directly. */
+  readonly fc: number;
+  /** True when the piece's characters occupy one byte each and its real byte offset is `fc / 2`. */
+  readonly compressed: boolean;
+  /** Pcd's fNoParaLast: "If this bit is 1, the text MUST NOT contain a paragraph mark." */
+  readonly noParaLast: boolean;
+  /** Pcd.Prm, [MS-DOC] 2.8.36 -- further property modifications for this piece's text, carried verbatim and not yet applied (see README's scope note). */
+  readonly prm: number;
+}
+interface PieceTable {
+  readonly pieces: readonly Piece[];
+  /** PlcPcd.aCp itself: one more entry than there are pieces, so a lookup can bracket every piece and terminate at the document's end. */
+  readonly cpKeys: readonly number[];
+  /** The final aCp entry, one past the last character position the document defines. */
+  readonly lastCp: number;
+}
+declare function parseClx(clx: Uint8Array): PieceTable;
+declare function characterOffset(piece: Piece, cp: number): number;
+/** The number of bytes one character occupies in this piece: one for a compressed (8-bit) piece, two for an uncompressed (16-bit) one. */
+declare function characterSize(piece: Piece): 1 | 2;
+//#endregion
+export { parseClx as a, characterSize as i, PieceTable as n, characterOffset as r, Piece as t };

package/dist/piece-table-CA18mhjv.d.ts

@@ -0,0 +1,28 @@
+//#region src/text/piece-table.d.ts
+interface Piece {
+  /** The first character position this piece supplies, PlcPcd.aCp[i]. */
+  readonly cpStart: number;
+  /** One past the last character position this piece supplies, PlcPcd.aCp[i + 1]. */
+  readonly cpEnd: number;
+  /** FcCompressed's 30-bit offset field as stored -- NOT yet halved for a compressed piece. Use characterOffset() rather than this directly. */
+  readonly fc: number;
+  /** True when the piece's characters occupy one byte each and its real byte offset is `fc / 2`. */
+  readonly compressed: boolean;
+  /** Pcd's fNoParaLast: "If this bit is 1, the text MUST NOT contain a paragraph mark." */
+  readonly noParaLast: boolean;
+  /** Pcd.Prm, [MS-DOC] 2.8.36 -- further property modifications for this piece's text, carried verbatim and not yet applied (see README's scope note). */
+  readonly prm: number;
+}
+interface PieceTable {
+  readonly pieces: readonly Piece[];
+  /** PlcPcd.aCp itself: one more entry than there are pieces, so a lookup can bracket every piece and terminate at the document's end. */
+  readonly cpKeys: readonly number[];
+  /** The final aCp entry, one past the last character position the document defines. */
+  readonly lastCp: number;
+}
+declare function parseClx(clx: Uint8Array): PieceTable;
+declare function characterOffset(piece: Piece, cp: number): number;
+/** The number of bytes one character occupies in this piece: one for a compressed (8-bit) piece, two for an uncompressed (16-bit) one. */
+declare function characterSize(piece: Piece): 1 | 2;
+//#endregion
+export { parseClx as a, characterSize as i, PieceTable as n, characterOffset as r, Piece as t };

package/dist/prop/chp.d.cts

@@ -1,18 +1,2 @@
-import { t as Prl } from "../sprm-DEyvdOo0.cjs";
-import { Color } from "document-schema.js";
-//#region src/prop/chp.d.ts
-interface CharacterProperties {
-  bold?: boolean;
-  italic?: boolean;
-  underline?: boolean;
-  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, fonts?: readonly string[]): CharacterProperties;
-declare function characterIstdFromGrpprl(prls: readonly Prl[]): number | undefined;
-//#endregion
+import { n as applyCharacterSprms, r as characterIstdFromGrpprl, t as CharacterProperties } from "../chp-BpCqpb7V.cjs";
 export { CharacterProperties, applyCharacterSprms, characterIstdFromGrpprl };

package/dist/prop/chp.d.ts

@@ -1,18 +1,2 @@
-import { t as Prl } from "../sprm-DEyvdOo0.js";
-import { Color } from "document-schema.js";
-//#region src/prop/chp.d.ts
-interface CharacterProperties {
-  bold?: boolean;
-  italic?: boolean;
-  underline?: boolean;
-  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, fonts?: readonly string[]): CharacterProperties;
-declare function characterIstdFromGrpprl(prls: readonly Prl[]): number | undefined;
-//#endregion
+import { n as applyCharacterSprms, r as characterIstdFromGrpprl, t as CharacterProperties } from "../chp-B6AOh85P.js";
 export { CharacterProperties, applyCharacterSprms, characterIstdFromGrpprl };

package/dist/prop/fkp.d.cts

@@ -1,33 +1,2 @@
-//#region src/prop/fkp.d.ts
-/** Every FKP is exactly one 512-byte page, whatever the compound file's own sector size. */
-declare const FKP_PAGE_SIZE = 512;
-interface ChpxFkp {
-  readonly rgfc: readonly number[];
-  /** The Chpx's grpprl for run `index`, or undefined when the run's rgb entry is zero and it carries no exception. */
-  grpprl(index: number): Uint8Array | undefined;
-}
-interface PapxRecord {
-  readonly istd: number;
-  readonly grpprl: Uint8Array;
-}
-interface PapxFkp {
-  readonly rgfc: readonly number[];
-  /** The PapxInFkp for paragraph `index`, or undefined when its BxPap.bOffset is zero and the paragraph takes the defaults. */
-  papx(index: number): PapxRecord | undefined;
-}
-declare function parseChpxFkp(page: Uint8Array): ChpxFkp;
-declare function parsePapxFkp(page: Uint8Array): PapxFkp;
-interface PapxLookup extends PapxRecord {
-  /** The byte offset one past the end of the paragraph this record covers -- PapxFkp.rgfc[k + 1], the paragraph boundary [MS-DOC] 2.4.2 derives its own from. */
-  readonly fcLim: number;
-}
-declare class PropertyBinTable {
-  #private;
-  constructor(wordDocument: Uint8Array, plc: Uint8Array, what: string);
-  /** The direct character-formatting grpprl covering `fc`, or undefined when the offset is outside the table or its run carries no exception. */
-  chpxGrpprl(fc: number): Uint8Array | undefined;
-  /** The direct paragraph-formatting record covering `fc`, or undefined when the offset is outside the table or its paragraph carries no exception. */
-  papx(fc: number): PapxLookup | undefined;
-}
-//#endregion
+import { a as PapxRecord, c as parsePapxFkp, i as PapxLookup, n as FKP_PAGE_SIZE, o as PropertyBinTable, r as PapxFkp, s as parseChpxFkp, t as ChpxFkp } from "../fkp-I-laf-8y.cjs";
 export { ChpxFkp, FKP_PAGE_SIZE, PapxFkp, PapxLookup, PapxRecord, PropertyBinTable, parseChpxFkp, parsePapxFkp };

package/dist/prop/fkp.d.ts

@@ -1,33 +1,2 @@
-//#region src/prop/fkp.d.ts
-/** Every FKP is exactly one 512-byte page, whatever the compound file's own sector size. */
-declare const FKP_PAGE_SIZE = 512;
-interface ChpxFkp {
-  readonly rgfc: readonly number[];
-  /** The Chpx's grpprl for run `index`, or undefined when the run's rgb entry is zero and it carries no exception. */
-  grpprl(index: number): Uint8Array | undefined;
-}
-interface PapxRecord {
-  readonly istd: number;
-  readonly grpprl: Uint8Array;
-}
-interface PapxFkp {
-  readonly rgfc: readonly number[];
-  /** The PapxInFkp for paragraph `index`, or undefined when its BxPap.bOffset is zero and the paragraph takes the defaults. */
-  papx(index: number): PapxRecord | undefined;
-}
-declare function parseChpxFkp(page: Uint8Array): ChpxFkp;
-declare function parsePapxFkp(page: Uint8Array): PapxFkp;
-interface PapxLookup extends PapxRecord {
-  /** The byte offset one past the end of the paragraph this record covers -- PapxFkp.rgfc[k + 1], the paragraph boundary [MS-DOC] 2.4.2 derives its own from. */
-  readonly fcLim: number;
-}
-declare class PropertyBinTable {
-  #private;
-  constructor(wordDocument: Uint8Array, plc: Uint8Array, what: string);
-  /** The direct character-formatting grpprl covering `fc`, or undefined when the offset is outside the table or its run carries no exception. */
-  chpxGrpprl(fc: number): Uint8Array | undefined;
-  /** The direct paragraph-formatting record covering `fc`, or undefined when the offset is outside the table or its paragraph carries no exception. */
-  papx(fc: number): PapxLookup | undefined;
-}
-//#endregion
+import { a as PapxRecord, c as parsePapxFkp, i as PapxLookup, n as FKP_PAGE_SIZE, o as PropertyBinTable, r as PapxFkp, s as parseChpxFkp, t as ChpxFkp } from "../fkp-I-laf-8y.js";
 export { ChpxFkp, FKP_PAGE_SIZE, PapxFkp, PapxLookup, PapxRecord, PropertyBinTable, parseChpxFkp, parsePapxFkp };

package/dist/prop/pap.cjs

@@ -36,7 +36,7 @@ const SPRM_P_ILVL = 9738;
 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. */
+/** sprmPFInnerTableCell / sprmPFInnerTtp: a nested table's (table depth greater than 1) own cell-ending or row-ending mark, [MS-DOC] 2.4.3's Overview of Tables -- the paragraph-mark (0x000D) analogues of sprmPFInTable's cell-mark (0x0007) boundary and sprmPFTtp's row-mark at depth 1. */
 const SPRM_P_F_INNER_TABLE_CELL = 9291;
 const SPRM_P_F_INNER_TTP = 9292;
 const TWIPS_PER_POINT = 20;
@@ -135,7 +135,9 @@ function applyParagraphSprms(prls, into) {
 				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;
+				into.innerTableCellMark = require_bytes.readUint8(prl.operand, 0) !== 0;
+				break;
+			case SPRM_P_F_INNER_TTP: into.innerTtpMark = require_bytes.readUint8(prl.operand, 0) !== 0;
 		}
 	}
 	return into;

package/dist/prop/pap.d.cts

@@ -1,2 +1,2 @@
-import { n as applyParagraphSprms, t as ParagraphProperties } from "../pap-BT1p0uzu.cjs";
+import { n as applyParagraphSprms, t as ParagraphProperties } from "../pap-BQ2E17K9.cjs";
 export { ParagraphProperties, applyParagraphSprms };

package/dist/prop/pap.d.ts

@@ -1,2 +1,2 @@
-import { n as applyParagraphSprms, t as ParagraphProperties } from "../pap-DOFLMWcG.js";
+import { n as applyParagraphSprms, t as ParagraphProperties } from "../pap-iWFIpCdo.js";
 export { ParagraphProperties, applyParagraphSprms };

package/dist/prop/pap.js

@@ -35,7 +35,7 @@ const SPRM_P_ILVL = 9738;
 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. */
+/** sprmPFInnerTableCell / sprmPFInnerTtp: a nested table's (table depth greater than 1) own cell-ending or row-ending mark, [MS-DOC] 2.4.3's Overview of Tables -- the paragraph-mark (0x000D) analogues of sprmPFInTable's cell-mark (0x0007) boundary and sprmPFTtp's row-mark at depth 1. */
 const SPRM_P_F_INNER_TABLE_CELL = 9291;
 const SPRM_P_F_INNER_TTP = 9292;
 const TWIPS_PER_POINT = 20;
@@ -134,7 +134,9 @@ function applyParagraphSprms(prls, into) {
 				into.tableDepth = readUint32LE(prl.operand, 0);
 				break;
 			case SPRM_P_F_INNER_TABLE_CELL:
-			case SPRM_P_F_INNER_TTP: if (readUint8(prl.operand, 0) !== 0) into.nestedTableMark = true;
+				into.innerTableCellMark = readUint8(prl.operand, 0) !== 0;
+				break;
+			case SPRM_P_F_INNER_TTP: into.innerTtpMark = readUint8(prl.operand, 0) !== 0;
 		}
 	}
 	return into;

package/dist/prop/sep.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
 const require_bytes = require("../bytes.cjs");
 const require_plc = require("../plc.cjs");
 const require_prop_sprm = require("./sprm.cjs");
@@ -47,17 +48,26 @@ function applySectionSprms(prls, into) {
 	}
 	return into;
 }
-/** Resolves the document's first section's own page size and margins from PlcfSed/Sepx -- absent entirely when the file carries no PlcfSed at all (lcbPlcfSed 0), which read.ts's own DEFAULT_PAGE_SIZE/DEFAULT_MARGINS then stand in for field by field, exactly as an individual unstated sprm already does. This reader only ever resolves the section covering the whole main document (see read.ts's own DocContent comment on why more than one section is out of scope), so it reads PlcfSed's first Sed regardless of how many the file actually carries. */
-function readSectionProperties(wordDocument, table, fib) {
-	if (fib.lcbPlcfSed === 0) return {};
+/** Resolves every section PlcfSed/Sepx states, in document order -- a single zero-start entry with no properties when the file carries no PlcfSed at all (lcbPlcfSed 0) or an empty one, which read.ts's own DEFAULT_PAGE_SIZE/DEFAULT_MARGINS then stand in for field by field, exactly as an individual unstated sprm already does, matching what a single-section document with no PlcfSed at all would resolve to anyway. */
+function readAllSectionProperties(wordDocument, table, fib) {
+	if (fib.lcbPlcfSed === 0) return [{ startCp: 0 }];
 	const plc = require_plc.parsePlc(require_bytes.slice(table, fib.fcPlcfSed, fib.lcbPlcfSed, "PlcfSed in the Table stream"), SED_SIZE, "PlcfSed");
-	if (plc.count === 0) return {};
-	const sed = plc.element(0);
-	const fcSepx = require_bytes.readUint32LE(sed, SED_FC_SEPX_OFFSET);
-	const cb = require_bytes.readUint16LE(wordDocument, fcSepx);
-	const grpprl = require_bytes.slice(wordDocument, fcSepx + 2, cb, "Sepx grpprl in the WordDocument stream");
-	return applySectionSprms(require_prop_sprm.readGrpprl(grpprl), {});
+	if (plc.count === 0) return [{ startCp: 0 }];
+	const sections = [];
+	for (let index = 0; index < plc.count; index += 1) {
+		const startCp = plc.keys[index];
+		if (startCp === void 0) throw new require_errors.DocFormatError(`internal defect: PlcfSed key ${index} is absent from a PLC of ${plc.count} elements`);
+		const sed = plc.element(index);
+		const fcSepx = require_bytes.readUint32LE(sed, SED_FC_SEPX_OFFSET);
+		const cb = require_bytes.readUint16LE(wordDocument, fcSepx);
+		const grpprl = require_bytes.slice(wordDocument, fcSepx + 2, cb, "Sepx grpprl in the WordDocument stream");
+		sections.push({
+			startCp,
+			...applySectionSprms(require_prop_sprm.readGrpprl(grpprl), {})
+		});
+	}
+	return sections;
 }
 //#endregion
 exports.applySectionSprms = applySectionSprms;
-exports.readSectionProperties = readSectionProperties;
+exports.readAllSectionProperties = readAllSectionProperties;

package/dist/prop/sep.d.cts

@@ -1,4 +1,4 @@
-import { t as Fib } from "../fib-DWFta19r.cjs";
+import { t as Fib } from "../fib-6BFIx153.cjs";
 import { t as Prl } from "../sprm-DEyvdOo0.cjs";
 //#region src/prop/sep.d.ts
 interface SectionProperties {
@@ -10,7 +10,11 @@ interface SectionProperties {
   marginBottomPt?: number;
 }
 declare function applySectionSprms(prls: readonly Prl[], into: SectionProperties): SectionProperties;
-/** Resolves the document's first section's own page size and margins from PlcfSed/Sepx -- absent entirely when the file carries no PlcfSed at all (lcbPlcfSed 0), which read.ts's own DEFAULT_PAGE_SIZE/DEFAULT_MARGINS then stand in for field by field, exactly as an individual unstated sprm already does. This reader only ever resolves the section covering the whole main document (see read.ts's own DocContent comment on why more than one section is out of scope), so it reads PlcfSed's first Sed regardless of how many the file actually carries. */
-declare function readSectionProperties(wordDocument: Uint8Array, table: Uint8Array, fib: Pick<Fib, "fcPlcfSed" | "lcbPlcfSed">): SectionProperties;
+/** One section's own resolved properties (page size, margins) alongside `startCp`, the character position PlcfSed.aCp[i] names as where its text begins in the main document -- [MS-DOC] 2.8.26: "Each CP specifies the beginning of a range of text in the main document that constitutes a section." read.ts's own splitIntoSections groups the main document's paragraph entries by these boundaries. */
+interface DocSectionProperties extends SectionProperties {
+  readonly startCp: number;
+}
+/** Resolves every section PlcfSed/Sepx states, in document order -- a single zero-start entry with no properties when the file carries no PlcfSed at all (lcbPlcfSed 0) or an empty one, which read.ts's own DEFAULT_PAGE_SIZE/DEFAULT_MARGINS then stand in for field by field, exactly as an individual unstated sprm already does, matching what a single-section document with no PlcfSed at all would resolve to anyway. */
+declare function readAllSectionProperties(wordDocument: Uint8Array, table: Uint8Array, fib: Pick<Fib, "fcPlcfSed" | "lcbPlcfSed">): readonly DocSectionProperties[];
 //#endregion
-export { SectionProperties, applySectionSprms, readSectionProperties };
+export { DocSectionProperties, SectionProperties, applySectionSprms, readAllSectionProperties };

package/dist/prop/sep.d.ts

@@ -1,4 +1,4 @@
-import { t as Fib } from "../fib-DWFta19r.js";
+import { t as Fib } from "../fib-6BFIx153.js";
 import { t as Prl } from "../sprm-DEyvdOo0.js";
 //#region src/prop/sep.d.ts
 interface SectionProperties {
@@ -10,7 +10,11 @@ interface SectionProperties {
   marginBottomPt?: number;
 }
 declare function applySectionSprms(prls: readonly Prl[], into: SectionProperties): SectionProperties;
-/** Resolves the document's first section's own page size and margins from PlcfSed/Sepx -- absent entirely when the file carries no PlcfSed at all (lcbPlcfSed 0), which read.ts's own DEFAULT_PAGE_SIZE/DEFAULT_MARGINS then stand in for field by field, exactly as an individual unstated sprm already does. This reader only ever resolves the section covering the whole main document (see read.ts's own DocContent comment on why more than one section is out of scope), so it reads PlcfSed's first Sed regardless of how many the file actually carries. */
-declare function readSectionProperties(wordDocument: Uint8Array, table: Uint8Array, fib: Pick<Fib, "fcPlcfSed" | "lcbPlcfSed">): SectionProperties;
+/** One section's own resolved properties (page size, margins) alongside `startCp`, the character position PlcfSed.aCp[i] names as where its text begins in the main document -- [MS-DOC] 2.8.26: "Each CP specifies the beginning of a range of text in the main document that constitutes a section." read.ts's own splitIntoSections groups the main document's paragraph entries by these boundaries. */
+interface DocSectionProperties extends SectionProperties {
+  readonly startCp: number;
+}
+/** Resolves every section PlcfSed/Sepx states, in document order -- a single zero-start entry with no properties when the file carries no PlcfSed at all (lcbPlcfSed 0) or an empty one, which read.ts's own DEFAULT_PAGE_SIZE/DEFAULT_MARGINS then stand in for field by field, exactly as an individual unstated sprm already does, matching what a single-section document with no PlcfSed at all would resolve to anyway. */
+declare function readAllSectionProperties(wordDocument: Uint8Array, table: Uint8Array, fib: Pick<Fib, "fcPlcfSed" | "lcbPlcfSed">): readonly DocSectionProperties[];
 //#endregion
-export { SectionProperties, applySectionSprms, readSectionProperties };
+export { DocSectionProperties, SectionProperties, applySectionSprms, readAllSectionProperties };

package/dist/prop/sep.js

@@ -1,3 +1,4 @@
+import { DocFormatError } from "../errors.js";
 import { readInt16LE, readUint16LE, readUint32LE, slice } from "../bytes.js";
 import { parsePlc } from "../plc.js";
 import { SGC, readGrpprl } from "./sprm.js";
@@ -46,16 +47,25 @@ function applySectionSprms(prls, into) {
 	}
 	return into;
 }
-/** Resolves the document's first section's own page size and margins from PlcfSed/Sepx -- absent entirely when the file carries no PlcfSed at all (lcbPlcfSed 0), which read.ts's own DEFAULT_PAGE_SIZE/DEFAULT_MARGINS then stand in for field by field, exactly as an individual unstated sprm already does. This reader only ever resolves the section covering the whole main document (see read.ts's own DocContent comment on why more than one section is out of scope), so it reads PlcfSed's first Sed regardless of how many the file actually carries. */
-function readSectionProperties(wordDocument, table, fib) {
-	if (fib.lcbPlcfSed === 0) return {};
+/** Resolves every section PlcfSed/Sepx states, in document order -- a single zero-start entry with no properties when the file carries no PlcfSed at all (lcbPlcfSed 0) or an empty one, which read.ts's own DEFAULT_PAGE_SIZE/DEFAULT_MARGINS then stand in for field by field, exactly as an individual unstated sprm already does, matching what a single-section document with no PlcfSed at all would resolve to anyway. */
+function readAllSectionProperties(wordDocument, table, fib) {
+	if (fib.lcbPlcfSed === 0) return [{ startCp: 0 }];
 	const plc = parsePlc(slice(table, fib.fcPlcfSed, fib.lcbPlcfSed, "PlcfSed in the Table stream"), SED_SIZE, "PlcfSed");
-	if (plc.count === 0) return {};
-	const sed = plc.element(0);
-	const fcSepx = readUint32LE(sed, SED_FC_SEPX_OFFSET);
-	const cb = readUint16LE(wordDocument, fcSepx);
-	const grpprl = slice(wordDocument, fcSepx + 2, cb, "Sepx grpprl in the WordDocument stream");
-	return applySectionSprms(readGrpprl(grpprl), {});
+	if (plc.count === 0) return [{ startCp: 0 }];
+	const sections = [];
+	for (let index = 0; index < plc.count; index += 1) {
+		const startCp = plc.keys[index];
+		if (startCp === void 0) throw new DocFormatError(`internal defect: PlcfSed key ${index} is absent from a PLC of ${plc.count} elements`);
+		const sed = plc.element(index);
+		const fcSepx = readUint32LE(sed, SED_FC_SEPX_OFFSET);
+		const cb = readUint16LE(wordDocument, fcSepx);
+		const grpprl = slice(wordDocument, fcSepx + 2, cb, "Sepx grpprl in the WordDocument stream");
+		sections.push({
+			startCp,
+			...applySectionSprms(readGrpprl(grpprl), {})
+		});
+	}
+	return sections;
 }
 //#endregion
-export { applySectionSprms, readSectionProperties };
+export { applySectionSprms, readAllSectionProperties };