doc-codec 2.4.3 → 2.6.0

package/dist/list/numbering.d.ts

@@ -1,2 +1,24 @@
-import { a as readNumberingDefinitions, i as NumberingLevel, n as NumberingDefinition, r as NumberingDefinitions, t as NUMBER_FORMAT_BY_NFC } from "../numbering-DayjnHXY.js";
+import { t as Fib } from "../fib-6BFIx153.js";
+//#region src/list/numbering.d.ts
+/** MSONFC ([MS-OSHARED] 2.2.1.3), mapped to its own documented ST_NumberFormat equivalent -- the identical vocabulary ooxml.js's NumberingLevel.format carries verbatim from word/numbering.xml's own w:numFmt/@w:val. Every member through msonfcUCRus (0x3B) is a real numbered/lettered/ideograph format; 0x17 (msonfcBullet) is handled separately below since PlfLfo also treats it as the "no number sequence, but has bullets" case LVLF's own field text calls out by name. */
+declare const NUMBER_FORMAT_BY_NFC: Readonly<Record<number, string>>;
+interface NumberingLevel {
+  /** The ST_NumberFormat-equivalent string MSONFC's own value maps to ("decimal", "upperRoman", "bullet", ...), or "none" for a level with no number sequence at all ([MS-DOC] 2.9.150's own nfc field text: "If this is equal to 0xFF..., this level does not have a number sequence"). */
+  readonly format: string;
+  /** The level's own text template: a placeholder pattern like '%1.' or '%2)' for a numbered format (the digit names which zero-based level's own counter substitutes at that position, one-based in the placeholder itself) -- the identical convention ooxml.js's own NumberingLevel.text carries verbatim from w:lvlText/@w:val -- or a literal bullet glyph string for format 'bullet'. Decoded from the level's own Xst (a raw UTF-16 string) plus its rgbxchNums array, which names which character POSITIONS in that string are placeholders rather than literal text -- see readLevelText below. */
+  readonly text: string;
+  /** iStartAt: the value this level's counter begins from. Meaningless (and not read as anything but 1) for a level with no number sequence. */
+  readonly startAt: number;
+  /** ilvlRestartLim ([MS-DOC] 2.9.150), only when fNoRestart is set: the first (most-significant) zero-based level after which this level's own number sequence does NOT restart. Absent (undefined) is the spec's own default behaviour -- "restarts when a more significant level is encountered" -- not "never restarts". */
+  readonly restart?: number;
+}
+interface NumberingDefinition {
+  /** Keyed by the level's own zero-based ilvl, stringified -- the identical zero-based numbering ContentListMembership.level already uses, so `definitions[membership.numId]?.levels[String(membership.level)]` is the direct lookup path from a paragraph's own membership to its rendering definition. A record rather than a fixed-length array/tuple: a simple (fSimpleList) LSTF states only level 0. */
+  readonly levels: Readonly<Record<string, NumberingLevel>>;
+}
+/** Keyed by a paragraph's own listId (ContentListMembership.numId, stringified) -- prop/pap.ts's own sprmPIlfo, a one-based index into PlfLfo.rgLfo. */
+type NumberingDefinitions = Readonly<Record<string, NumberingDefinition>>;
+/** Resolves PlfLst and PlfLfo into NumberingDefinitions, keyed by the one-based ilfo every listId already is (prop/pap.ts's own Math.abs(ilfo)) -- absent entirely when the file carries neither (fcPlfLst/fcPlfLfo both 0, a document with no lists at all, the common case this reader must not fail on). */
+declare function readNumberingDefinitions(table: Uint8Array, fib: Fib): NumberingDefinitions;
+//#endregion
 export { NUMBER_FORMAT_BY_NFC, NumberingDefinition, NumberingDefinitions, NumberingLevel, readNumberingDefinitions };

package/dist/notes.cjs

@@ -0,0 +1,26 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_subdocument = require("./subdocument.cjs");
+//#region src/notes.ts
+function readNoteBodies(wordDocument, table, pieceTable, context, fib) {
+	const footnoteStartCp = fib.ccpText;
+	const commentStartCp = footnoteStartCp + fib.ccpFtn + fib.ccpHdd;
+	const endnoteStartCp = commentStartCp + fib.ccpAtn;
+	const footnotes = require_subdocument.readSubdocumentStories(wordDocument, table, pieceTable, context, footnoteStartCp, fib.ccpFtn, fib.fcPlcffndTxt, fib.lcbPlcffndTxt, "PlcffndTxt").map((entries, index) => ({
+		id: String(index + 1),
+		text: require_subdocument.storyText(entries)
+	}));
+	const comments = require_subdocument.readSubdocumentStories(wordDocument, table, pieceTable, context, commentStartCp, fib.ccpAtn, fib.fcPlcfandTxt, fib.lcbPlcfandTxt, "PlcfandTxt").map((entries, index) => ({
+		id: String(index + 1),
+		text: require_subdocument.storyText(entries)
+	}));
+	return {
+		footnotes,
+		endnotes: require_subdocument.readSubdocumentStories(wordDocument, table, pieceTable, context, endnoteStartCp, fib.ccpEdn, fib.fcPlcfendTxt, fib.lcbPlcfendTxt, "PlcfendTxt").map((entries, index) => ({
+			id: String(index + 1),
+			text: require_subdocument.storyText(entries)
+		})),
+		comments
+	};
+}
+//#endregion
+exports.readNoteBodies = readNoteBodies;

package/dist/notes.d.cts

@@ -0,0 +1,20 @@
+import { t as Fib } from "./fib-6BFIx153.cjs";
+import { n as ReadContext } from "./paragraphs-DQUp8_HB.cjs";
+import { n as PieceTable } from "./piece-table-CA18mhjv.cjs";
+//#region src/notes.d.ts
+interface Footnote {
+  readonly id: string;
+  readonly text: string;
+}
+interface Comment {
+  readonly id: string;
+  readonly text: string;
+}
+interface NoteBodies {
+  readonly footnotes: readonly Footnote[];
+  readonly endnotes: readonly Footnote[];
+  readonly comments: readonly Comment[];
+}
+declare function readNoteBodies(wordDocument: Uint8Array, table: Uint8Array, pieceTable: PieceTable, context: ReadContext, fib: Fib): NoteBodies;
+//#endregion
+export { Comment, Footnote, NoteBodies, readNoteBodies };

package/dist/notes.d.ts

@@ -0,0 +1,20 @@
+import { t as Fib } from "./fib-6BFIx153.js";
+import { n as ReadContext } from "./paragraphs-s2lJ6w2I.js";
+import { n as PieceTable } from "./piece-table-CA18mhjv.js";
+//#region src/notes.d.ts
+interface Footnote {
+  readonly id: string;
+  readonly text: string;
+}
+interface Comment {
+  readonly id: string;
+  readonly text: string;
+}
+interface NoteBodies {
+  readonly footnotes: readonly Footnote[];
+  readonly endnotes: readonly Footnote[];
+  readonly comments: readonly Comment[];
+}
+declare function readNoteBodies(wordDocument: Uint8Array, table: Uint8Array, pieceTable: PieceTable, context: ReadContext, fib: Fib): NoteBodies;
+//#endregion
+export { Comment, Footnote, NoteBodies, readNoteBodies };

package/dist/notes.js

@@ -0,0 +1,25 @@
+import { readSubdocumentStories, storyText } from "./subdocument.js";
+//#region src/notes.ts
+function readNoteBodies(wordDocument, table, pieceTable, context, fib) {
+	const footnoteStartCp = fib.ccpText;
+	const commentStartCp = footnoteStartCp + fib.ccpFtn + fib.ccpHdd;
+	const endnoteStartCp = commentStartCp + fib.ccpAtn;
+	const footnotes = readSubdocumentStories(wordDocument, table, pieceTable, context, footnoteStartCp, fib.ccpFtn, fib.fcPlcffndTxt, fib.lcbPlcffndTxt, "PlcffndTxt").map((entries, index) => ({
+		id: String(index + 1),
+		text: storyText(entries)
+	}));
+	const comments = readSubdocumentStories(wordDocument, table, pieceTable, context, commentStartCp, fib.ccpAtn, fib.fcPlcfandTxt, fib.lcbPlcfandTxt, "PlcfandTxt").map((entries, index) => ({
+		id: String(index + 1),
+		text: storyText(entries)
+	}));
+	return {
+		footnotes,
+		endnotes: readSubdocumentStories(wordDocument, table, pieceTable, context, endnoteStartCp, fib.ccpEdn, fib.fcPlcfendTxt, fib.lcbPlcfendTxt, "PlcfendTxt").map((entries, index) => ({
+			id: String(index + 1),
+			text: storyText(entries)
+		})),
+		comments
+	};
+}
+//#endregion
+export { readNoteBodies };

package/dist/{pap-BT1p0uzu.d.cts → pap-BQ2E17K9.d.cts}

@@ -19,10 +19,12 @@ interface ParagraphProperties {
   listLevel?: number;
   /** The list identifier (sprmPIlfo), present only when the paragraph is in a list at all. */
   listId?: number;
-  /** sprmPItap's own table depth, present only when the sprm is; a value greater than 1 marks a table nested inside a table cell. */
+  /** sprmPItap's own table depth, present only when the sprm is; a value greater than 1 marks a paragraph belonging to a table nested inside a table cell. */
   tableDepth?: number;
-  /** True when sprmPFInnerTableCell or sprmPFInnerTtp is set -- a nested table's own cell/row-ending mark, carried purely as a refusal signal since this package's table support does not descend into a nested table. */
-  nestedTableMark?: boolean;
+  /** True on a nested table's (depth greater than 1) own cell-ending paragraph mark -- the sprmPFInnerTableCell analogue of sprmPFInTable's own cell-mark boundary at depth 1. */
+  innerTableCellMark?: boolean;
+  /** True on a nested table's (depth greater than 1) own row-ending paragraph mark -- the sprmPFInnerTtp analogue of sprmPFTtp's own row-mark boundary at depth 1. */
+  innerTtpMark?: boolean;
 }
 declare function applyParagraphSprms(prls: readonly Prl[], into: ParagraphProperties): ParagraphProperties;
 //#endregion

package/dist/{pap-DOFLMWcG.d.ts → pap-iWFIpCdo.d.ts}

@@ -19,10 +19,12 @@ interface ParagraphProperties {
   listLevel?: number;
   /** The list identifier (sprmPIlfo), present only when the paragraph is in a list at all. */
   listId?: number;
-  /** sprmPItap's own table depth, present only when the sprm is; a value greater than 1 marks a table nested inside a table cell. */
+  /** sprmPItap's own table depth, present only when the sprm is; a value greater than 1 marks a paragraph belonging to a table nested inside a table cell. */
   tableDepth?: number;
-  /** True when sprmPFInnerTableCell or sprmPFInnerTtp is set -- a nested table's own cell/row-ending mark, carried purely as a refusal signal since this package's table support does not descend into a nested table. */
-  nestedTableMark?: boolean;
+  /** True on a nested table's (depth greater than 1) own cell-ending paragraph mark -- the sprmPFInnerTableCell analogue of sprmPFInTable's own cell-mark boundary at depth 1. */
+  innerTableCellMark?: boolean;
+  /** True on a nested table's (depth greater than 1) own row-ending paragraph mark -- the sprmPFInnerTtp analogue of sprmPFTtp's own row-mark boundary at depth 1. */
+  innerTtpMark?: boolean;
 }
 declare function applyParagraphSprms(prls: readonly Prl[], into: ParagraphProperties): ParagraphProperties;
 //#endregion

package/dist/paragraphs-DQUp8_HB.d.cts

@@ -0,0 +1,31 @@
+import { o as PropertyBinTable } from "./fkp-I-laf-8y.cjs";
+import { t as Prl } from "./sprm-DEyvdOo0.cjs";
+import { t as CharacterProperties } from "./chp-BpCqpb7V.cjs";
+import { t as ParagraphProperties } from "./pap-BQ2E17K9.cjs";
+import { a as StyleSheet } from "./stsh-CK59x6XG.cjs";
+import { ContentBlock } from "document-schema.js";
+//#region src/text/paragraphs.d.ts
+interface ReadContext {
+  readonly chpxTable: PropertyBinTable;
+  readonly papxTable: PropertyBinTable;
+  readonly styles: StyleSheet | undefined;
+  /** The font names sprmCRgFtc0's operand indexes into, or undefined when the document carries no SttbfFfn at all. */
+  readonly fonts: readonly string[] | undefined;
+  readonly characterProperties: Map<string, CharacterProperties>;
+  /** The "Data" stream's own bytes, or undefined when the container carries none -- a valid Word Binary File with no pictures need not have one at all. sprmCPicLocation's operand is an offset into this stream (pictures.ts's readInlinePicture). */
+  readonly dataStream: Uint8Array | undefined;
+}
+/** One paragraph/cell/row-ending mark, still flat -- table/read.ts's assembleBlocks is what folds a run of these into a real ContentTable. `properties` and `grpprl` are carried alongside the already-built `blocks` because table grouping needs sprmPFInTable/sprmPFTtp/sprmPItap (properties) and, on a row's own mark, its table-defining sgc-5 sprms (grpprl) -- neither of which survives onto a plain ContentParagraph. `blocks` is more than one paragraph exactly when an inline picture anchor split this paragraph's own text around it (buildParagraphBlocks) -- ordinarily a single-element array holding the one ContentParagraph this mark closes. */
+interface ParagraphEntry {
+  readonly blocks: readonly ContentBlock[];
+  readonly properties: ParagraphProperties;
+  readonly grpprl: readonly Prl[];
+  /** The character that terminated this paragraph in the text stream: PARAGRAPH_MARK, CELL_MARK, or SECTION_MARK. */
+  readonly terminator: number;
+  /** The character position immediately after this paragraph's own terminator (or, for the trailing no-mark case, the text's own length) -- comparable directly to a boundary plex's own CPs (PlcfSed.aCp, PlcffndTxt.aCp, Plcfhdd's aCp, ...) as long as `text` was itself read starting from that plex's own CP 0. read.ts's splitIntoSections and notes.ts/headers-footers.ts's own splitting use it to locate a story's real boundary. */
+  readonly endCp: number;
+}
+declare function readParagraphs(text: string, fcs: readonly number[], context: ReadContext): ParagraphEntry[];
+declare function splitEntriesByBoundaries(entries: readonly ParagraphEntry[], boundaries: readonly number[]): ParagraphEntry[][];
+//#endregion
+export { splitEntriesByBoundaries as i, ReadContext as n, readParagraphs as r, ParagraphEntry as t };

package/dist/paragraphs-s2lJ6w2I.d.ts

@@ -0,0 +1,31 @@
+import { o as PropertyBinTable } from "./fkp-I-laf-8y.js";
+import { t as Prl } from "./sprm-DEyvdOo0.js";
+import { t as CharacterProperties } from "./chp-B6AOh85P.js";
+import { t as ParagraphProperties } from "./pap-iWFIpCdo.js";
+import { a as StyleSheet } from "./stsh-Bj0YSEOp.js";
+import { ContentBlock } from "document-schema.js";
+//#region src/text/paragraphs.d.ts
+interface ReadContext {
+  readonly chpxTable: PropertyBinTable;
+  readonly papxTable: PropertyBinTable;
+  readonly styles: StyleSheet | undefined;
+  /** The font names sprmCRgFtc0's operand indexes into, or undefined when the document carries no SttbfFfn at all. */
+  readonly fonts: readonly string[] | undefined;
+  readonly characterProperties: Map<string, CharacterProperties>;
+  /** The "Data" stream's own bytes, or undefined when the container carries none -- a valid Word Binary File with no pictures need not have one at all. sprmCPicLocation's operand is an offset into this stream (pictures.ts's readInlinePicture). */
+  readonly dataStream: Uint8Array | undefined;
+}
+/** One paragraph/cell/row-ending mark, still flat -- table/read.ts's assembleBlocks is what folds a run of these into a real ContentTable. `properties` and `grpprl` are carried alongside the already-built `blocks` because table grouping needs sprmPFInTable/sprmPFTtp/sprmPItap (properties) and, on a row's own mark, its table-defining sgc-5 sprms (grpprl) -- neither of which survives onto a plain ContentParagraph. `blocks` is more than one paragraph exactly when an inline picture anchor split this paragraph's own text around it (buildParagraphBlocks) -- ordinarily a single-element array holding the one ContentParagraph this mark closes. */
+interface ParagraphEntry {
+  readonly blocks: readonly ContentBlock[];
+  readonly properties: ParagraphProperties;
+  readonly grpprl: readonly Prl[];
+  /** The character that terminated this paragraph in the text stream: PARAGRAPH_MARK, CELL_MARK, or SECTION_MARK. */
+  readonly terminator: number;
+  /** The character position immediately after this paragraph's own terminator (or, for the trailing no-mark case, the text's own length) -- comparable directly to a boundary plex's own CPs (PlcfSed.aCp, PlcffndTxt.aCp, Plcfhdd's aCp, ...) as long as `text` was itself read starting from that plex's own CP 0. read.ts's splitIntoSections and notes.ts/headers-footers.ts's own splitting use it to locate a story's real boundary. */
+  readonly endCp: number;
+}
+declare function readParagraphs(text: string, fcs: readonly number[], context: ReadContext): ParagraphEntry[];
+declare function splitEntriesByBoundaries(entries: readonly ParagraphEntry[], boundaries: readonly number[]): ParagraphEntry[][];
+//#endregion
+export { splitEntriesByBoundaries as i, ReadContext as n, readParagraphs as r, ParagraphEntry as t };

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 };