doc-codec 2.4.2 → 2.5.0

package/dist/headers-footers.cjs

@@ -0,0 +1,34 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_subdocument = require("./subdocument.cjs");
+const require_table_read = require("./table/read.cjs");
+//#region src/headers-footers.ts
+/** The six per-section slots' own order within each of Plcfhdd's per-section groups, [MS-DOC]'s own Headers page: "The stories within each group MUST appear in the following order." */
+const SLOT_ORDER = [
+	"evenHeader",
+	"oddHeader",
+	"evenFooter",
+	"oddFooter",
+	"firstHeader",
+	"firstFooter"
+];
+/** The six fixed footnote/endnote-separator stories preceding every section's own six -- footnote separator, footnote continuation separator, footnote continuation notice, endnote separator, endnote continuation separator, endnote continuation notice -- carried by Plcfhdd but not read here, since neither this package's own schema nor ooxml.js's DocxDocument has anywhere to put a separator story. */
+const FIXED_SEPARATOR_STORY_COUNT = 6;
+function readHeaderFooterStories(wordDocument, table, pieceTable, context, fib, sectionCount) {
+	const headerStartCp = fib.ccpText + fib.ccpFtn;
+	const perSectionStories = require_subdocument.readSubdocumentStories(wordDocument, table, pieceTable, context, headerStartCp, fib.ccpHdd, fib.fcPlcfHdd, fib.lcbPlcfHdd, "Plcfhdd").slice(FIXED_SEPARATOR_STORY_COUNT);
+	const stories = [];
+	for (let section = 0; section < sectionCount; section += 1) for (let slotIndex = 0; slotIndex < SLOT_ORDER.length; slotIndex += 1) {
+		const entries = perSectionStories[section * SLOT_ORDER.length + slotIndex];
+		if (entries === void 0 || entries.length === 0) continue;
+		const slot = SLOT_ORDER[slotIndex];
+		if (slot === void 0) continue;
+		stories.push({
+			section,
+			slot,
+			blocks: require_table_read.assembleBlocks(entries)
+		});
+	}
+	return stories;
+}
+//#endregion
+exports.readHeaderFooterStories = readHeaderFooterStories;

package/dist/headers-footers.d.cts

@@ -0,0 +1,16 @@
+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";
+import { ContentBlock } from "document-schema.js";
+//#region src/headers-footers.d.ts
+type HeaderFooterSlot = "evenHeader" | "oddHeader" | "evenFooter" | "oddFooter" | "firstHeader" | "firstFooter";
+interface HeaderFooterStory {
+  /** The 0-based index into DocContent.sections this story belongs to. */
+  readonly section: number;
+  readonly slot: HeaderFooterSlot;
+  readonly blocks: readonly ContentBlock[];
+}
+type HeaderFooterStories = readonly HeaderFooterStory[];
+declare function readHeaderFooterStories(wordDocument: Uint8Array, table: Uint8Array, pieceTable: PieceTable, context: ReadContext, fib: Fib, sectionCount: number): HeaderFooterStories;
+//#endregion
+export { HeaderFooterSlot, HeaderFooterStories, HeaderFooterStory, readHeaderFooterStories };

package/dist/headers-footers.d.ts

@@ -0,0 +1,16 @@
+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";
+import { ContentBlock } from "document-schema.js";
+//#region src/headers-footers.d.ts
+type HeaderFooterSlot = "evenHeader" | "oddHeader" | "evenFooter" | "oddFooter" | "firstHeader" | "firstFooter";
+interface HeaderFooterStory {
+  /** The 0-based index into DocContent.sections this story belongs to. */
+  readonly section: number;
+  readonly slot: HeaderFooterSlot;
+  readonly blocks: readonly ContentBlock[];
+}
+type HeaderFooterStories = readonly HeaderFooterStory[];
+declare function readHeaderFooterStories(wordDocument: Uint8Array, table: Uint8Array, pieceTable: PieceTable, context: ReadContext, fib: Fib, sectionCount: number): HeaderFooterStories;
+//#endregion
+export { HeaderFooterSlot, HeaderFooterStories, HeaderFooterStory, readHeaderFooterStories };

package/dist/headers-footers.js

@@ -0,0 +1,33 @@
+import { readSubdocumentStories } from "./subdocument.js";
+import { assembleBlocks } from "./table/read.js";
+//#region src/headers-footers.ts
+/** The six per-section slots' own order within each of Plcfhdd's per-section groups, [MS-DOC]'s own Headers page: "The stories within each group MUST appear in the following order." */
+const SLOT_ORDER = [
+	"evenHeader",
+	"oddHeader",
+	"evenFooter",
+	"oddFooter",
+	"firstHeader",
+	"firstFooter"
+];
+/** The six fixed footnote/endnote-separator stories preceding every section's own six -- footnote separator, footnote continuation separator, footnote continuation notice, endnote separator, endnote continuation separator, endnote continuation notice -- carried by Plcfhdd but not read here, since neither this package's own schema nor ooxml.js's DocxDocument has anywhere to put a separator story. */
+const FIXED_SEPARATOR_STORY_COUNT = 6;
+function readHeaderFooterStories(wordDocument, table, pieceTable, context, fib, sectionCount) {
+	const headerStartCp = fib.ccpText + fib.ccpFtn;
+	const perSectionStories = readSubdocumentStories(wordDocument, table, pieceTable, context, headerStartCp, fib.ccpHdd, fib.fcPlcfHdd, fib.lcbPlcfHdd, "Plcfhdd").slice(FIXED_SEPARATOR_STORY_COUNT);
+	const stories = [];
+	for (let section = 0; section < sectionCount; section += 1) for (let slotIndex = 0; slotIndex < SLOT_ORDER.length; slotIndex += 1) {
+		const entries = perSectionStories[section * SLOT_ORDER.length + slotIndex];
+		if (entries === void 0 || entries.length === 0) continue;
+		const slot = SLOT_ORDER[slotIndex];
+		if (slot === void 0) continue;
+		stories.push({
+			section,
+			slot,
+			blocks: assembleBlocks(entries)
+		});
+	}
+	return stories;
+}
+//#endregion
+export { readHeaderFooterStories };

package/dist/index.cjs

@@ -4,30 +4,35 @@ const require_bytes = require("./bytes.cjs");
 const require_fib_offsets = require("./fib/offsets.cjs");
 const require_detect = require("./detect.cjs");
 const require_plc = require("./plc.cjs");
+const require_prop_fkp = require("./prop/fkp.cjs");
+const require_prop_sprm = require("./prop/sprm.cjs");
+const require_prop_chp = require("./prop/chp.cjs");
+const require_prop_pap = require("./prop/pap.cjs");
+const require_style_stsh = require("./style/stsh.cjs");
+const require_text_special = require("./text/special.cjs");
+const require_text_paragraphs = require("./text/paragraphs.cjs");
+const require_text_piece_table = require("./text/piece-table.cjs");
+const require_text_characters = require("./text/characters.cjs");
+const require_subdocument = require("./subdocument.cjs");
+const require_headers_footers = require("./headers-footers.cjs");
 const require_fib_fib = require("./fib/fib.cjs");
 const require_fib_write = require("./fib/write.cjs");
 const require_metadata = require("./metadata.cjs");
-const require_text_piece_table = require("./text/piece-table.cjs");
 const require_text_piece_table_write = require("./text/piece-table-write.cjs");
-const require_text_characters = require("./text/characters.cjs");
-const require_text_special = require("./text/special.cjs");
-const require_prop_sprm = require("./prop/sprm.cjs");
-const require_prop_fkp = require("./prop/fkp.cjs");
 const require_prop_fkp_write = require("./prop/fkp-write.cjs");
-const require_prop_chp = require("./prop/chp.cjs");
 const require_prop_chp_write = require("./prop/chp-write.cjs");
-const require_prop_pap = require("./prop/pap.cjs");
 const require_prop_pap_write = require("./prop/pap-write.cjs");
 const require_prop_sep = require("./prop/sep.cjs");
 const require_prop_sep_write = require("./prop/sep-write.cjs");
-const require_style_stsh = require("./style/stsh.cjs");
 const require_style_fonts = require("./style/fonts.cjs");
 const require_list_numbering = require("./list/numbering.cjs");
+const require_notes = require("./notes.cjs");
 const require_read = require("./read.cjs");
 const require_write = require("./write.cjs");
 exports.ANNOTATION_REFERENCE = require_text_special.ANNOTATION_REFERENCE;
 exports.CELL_MARK = require_text_special.CELL_MARK;
 exports.COMPRESSED_CHARACTER_MAP = require_text_characters.COMPRESSED_CHARACTER_MAP;
+exports.DATA_STREAM = require_detect.DATA_STREAM;
 exports.DRAWN_OBJECT = require_text_special.DRAWN_OBJECT;
 exports.DocFormatError = require_errors.DocFormatError;
 exports.DocUnsupportedError = require_errors.DocUnsupportedError;
@@ -99,18 +104,24 @@ exports.parsePapxFkp = require_prop_fkp.parsePapxFkp;
 exports.parsePlc = require_plc.parsePlc;
 exports.parseStsh = require_style_stsh.parseStsh;
 exports.peekFibBaseFlags = require_fib_fib.peekFibBaseFlags;
+exports.readAllSectionProperties = require_prop_sep.readAllSectionProperties;
 exports.readDocContent = require_read.readDocContent;
 exports.readDocStreams = require_read.readDocStreams;
 exports.readGrpprl = require_prop_sprm.readGrpprl;
+exports.readHeaderFooterStories = require_headers_footers.readHeaderFooterStories;
 exports.readInt16LE = require_bytes.readInt16LE;
 exports.readInt32LE = require_bytes.readInt32LE;
+exports.readNoteBodies = require_notes.readNoteBodies;
 exports.readNumberingDefinitions = require_list_numbering.readNumberingDefinitions;
-exports.readSectionProperties = require_prop_sep.readSectionProperties;
+exports.readParagraphs = require_text_paragraphs.readParagraphs;
+exports.readSubdocumentStories = require_subdocument.readSubdocumentStories;
 exports.readTextRange = require_text_characters.readTextRange;
 exports.readUint16LE = require_bytes.readUint16LE;
 exports.readUint32LE = require_bytes.readUint32LE;
 exports.readUint8 = require_bytes.readUint8;
 exports.resolveStyleFormatting = require_style_stsh.resolveStyleFormatting;
 exports.slice = require_bytes.slice;
+exports.splitEntriesByBoundaries = require_text_paragraphs.splitEntriesByBoundaries;
+exports.storyText = require_subdocument.storyText;
 exports.tableStreamName = require_fib_fib.tableStreamName;
 exports.writeDocContent = require_write.writeDocContent;

package/dist/index.d.cts

@@ -1,27 +1,31 @@
 import { readInt16LE, readInt32LE, readUint16LE, readUint32LE, readUint8, slice } from "./bytes.cjs";
-import { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.cjs";
+import { DATA_STREAM, SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.cjs";
 import { DocFormatError, DocUnsupportedError } from "./errors.cjs";
-import { i as tableStreamName, n as parseFib, r as peekFibBaseFlags, t as Fib } from "./fib-DWFta19r.cjs";
+import { i as tableStreamName, n as parseFib, r as peekFibBaseFlags, t as Fib } from "./fib-6BFIx153.cjs";
 import { FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, LW_OFFSET } from "./fib/offsets.cjs";
 import { FibWriteSpec, buildFib } from "./fib/write.cjs";
+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";
+import { a as operandSize, i as decodeSprm, n as SGC, o as readGrpprl, r as Sprm, t as Prl } from "./sprm-DEyvdOo0.cjs";
+import { n as applyCharacterSprms, r as characterIstdFromGrpprl, t as CharacterProperties } from "./chp-BpCqpb7V.cjs";
+import { n as applyParagraphSprms, t as ParagraphProperties } from "./pap-BQ2E17K9.cjs";
+import { a as StyleSheet, c as parseStsh, i as Style, l as resolveStyleFormatting, n as STI_USER_DEFINED, o as buildStshForStyles, r as STK, s as headingLevelFromIstd, t as ResolvedStyleFormatting } from "./stsh-CK59x6XG.cjs";
+import { i as splitEntriesByBoundaries, n as ReadContext, r as readParagraphs, t as ParagraphEntry } from "./paragraphs-DQUp8_HB.cjs";
+import { a as parseClx, i as characterSize, n as PieceTable, r as characterOffset, t as Piece } from "./piece-table-CA18mhjv.cjs";
+import { HeaderFooterSlot, HeaderFooterStories, HeaderFooterStory, readHeaderFooterStories } from "./headers-footers.cjs";
 import { Plc, findLargestAtMost, parsePlc } from "./plc.cjs";
 import { layoutMetadataToSummaryInformation } from "./metadata.cjs";
-import { Piece, PieceTable, characterOffset, characterSize, parseClx } from "./text/piece-table.cjs";
 import { buildTextClx } from "./text/piece-table-write.cjs";
 import { COMPRESSED_CHARACTER_MAP, TextRange, readTextRange } from "./text/characters.cjs";
 import { ANNOTATION_REFERENCE, CELL_MARK, DRAWN_OBJECT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FOOTNOTE_REFERENCE, INLINE_PICTURE, LINE_BREAK, PARAGRAPH_MARK, SECTION_MARK, SYMBOL_ANCHOR, endsParagraph, isAnchorOnly } from "./text/special.cjs";
-import { a as operandSize, i as decodeSprm, n as SGC, o as readGrpprl, r as Sprm, t as Prl } from "./sprm-DEyvdOo0.cjs";
-import { ChpxFkp, FKP_PAGE_SIZE, PapxFkp, PapxLookup, PapxRecord, PropertyBinTable, parseChpxFkp, parsePapxFkp } from "./prop/fkp.cjs";
 import { ChpxRunToWrite, PapxParagraphToWrite, buildChpxPages, buildPapxPages, buildPropertyBinTable, firstFcOfPage, fitsAloneOnPapxPage } from "./prop/fkp-write.cjs";
-import { CharacterProperties, applyCharacterSprms, characterIstdFromGrpprl } from "./prop/chp.cjs";
 import { encodeCharacterGrpprl } from "./prop/chp-write.cjs";
-import { n as applyParagraphSprms, t as ParagraphProperties } from "./pap-BT1p0uzu.cjs";
 import { encodeParagraphGrpprl } from "./prop/pap-write.cjs";
-import { SectionProperties, applySectionSprms, readSectionProperties } from "./prop/sep.cjs";
+import { DocSectionProperties, SectionProperties, applySectionSprms, readAllSectionProperties } from "./prop/sep.cjs";
 import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.cjs";
-import { ResolvedStyleFormatting, STI_USER_DEFINED, STK, Style, StyleSheet, buildStshForStyles, headingLevelFromIstd, parseStsh, resolveStyleFormatting } from "./style/stsh.cjs";
 import { buildFontTable, parseFontTable } from "./style/fonts.cjs";
-import { a as readNumberingDefinitions, i as NumberingLevel, n as NumberingDefinition, r as NumberingDefinitions, t as NUMBER_FORMAT_BY_NFC } from "./numbering-DSpm9w6y.cjs";
-import { DocContent, DocStreams, ParagraphEntry, readDocContent, readDocStreams } from "./read.cjs";
+import { NUMBER_FORMAT_BY_NFC, NumberingDefinition, NumberingDefinitions, NumberingLevel, readNumberingDefinitions } from "./list/numbering.cjs";
+import { readSubdocumentStories, storyText } from "./subdocument.cjs";
+import { Comment, Footnote, NoteBodies, readNoteBodies } from "./notes.cjs";
+import { DocContent, DocStreams, readDocContent, readDocStreams } from "./read.cjs";
 import { WriteDocContentOptions, writeDocContent } from "./write.cjs";
-export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, CharacterProperties, ChpxFkp, ChpxRunToWrite, DRAWN_OBJECT, DocContent, DocFormatError, DocStreams, DocUnsupportedError, FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FKP_PAGE_SIZE, FOOTNOTE_REFERENCE, Fib, FibWriteSpec, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, NUMBER_FORMAT_BY_NFC, NumberingDefinition, NumberingDefinitions, NumberingLevel, PARAGRAPH_MARK, PapxFkp, PapxLookup, PapxParagraphToWrite, PapxRecord, ParagraphEntry, ParagraphProperties, Piece, PieceTable, Plc, Prl, PropertyBinTable, ResolvedStyleFormatting, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, SectionProperties, Sprm, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, WriteDocContentOptions, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, peekFibBaseFlags, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readNumberingDefinitions, readSectionProperties, readTextRange, readUint16LE, readUint32LE, readUint8, resolveStyleFormatting, slice, tableStreamName, writeDocContent };
+export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, CharacterProperties, ChpxFkp, ChpxRunToWrite, Comment, DATA_STREAM, DRAWN_OBJECT, DocContent, DocFormatError, DocSectionProperties, DocStreams, DocUnsupportedError, FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FKP_PAGE_SIZE, FOOTNOTE_REFERENCE, Fib, FibWriteSpec, Footnote, HeaderFooterSlot, HeaderFooterStories, HeaderFooterStory, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, NUMBER_FORMAT_BY_NFC, NoteBodies, NumberingDefinition, NumberingDefinitions, NumberingLevel, PARAGRAPH_MARK, PapxFkp, PapxLookup, PapxParagraphToWrite, PapxRecord, ParagraphEntry, ParagraphProperties, Piece, PieceTable, Plc, Prl, PropertyBinTable, ReadContext, ResolvedStyleFormatting, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, SectionProperties, Sprm, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, WriteDocContentOptions, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, peekFibBaseFlags, readAllSectionProperties, readDocContent, readDocStreams, readGrpprl, readHeaderFooterStories, readInt16LE, readInt32LE, readNoteBodies, readNumberingDefinitions, readParagraphs, readSubdocumentStories, readTextRange, readUint16LE, readUint32LE, readUint8, resolveStyleFormatting, slice, splitEntriesByBoundaries, storyText, tableStreamName, writeDocContent };

package/dist/index.d.ts

@@ -1,27 +1,31 @@
 import { readInt16LE, readInt32LE, readUint16LE, readUint32LE, readUint8, slice } from "./bytes.js";
-import { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.js";
+import { DATA_STREAM, SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.js";
 import { DocFormatError, DocUnsupportedError } from "./errors.js";
-import { i as tableStreamName, n as parseFib, r as peekFibBaseFlags, t as Fib } from "./fib-DWFta19r.js";
+import { i as tableStreamName, n as parseFib, r as peekFibBaseFlags, t as Fib } from "./fib-6BFIx153.js";
 import { FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, LW_OFFSET } from "./fib/offsets.js";
 import { FibWriteSpec, buildFib } from "./fib/write.js";
+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";
+import { a as operandSize, i as decodeSprm, n as SGC, o as readGrpprl, r as Sprm, t as Prl } from "./sprm-DEyvdOo0.js";
+import { n as applyCharacterSprms, r as characterIstdFromGrpprl, t as CharacterProperties } from "./chp-B6AOh85P.js";
+import { n as applyParagraphSprms, t as ParagraphProperties } from "./pap-iWFIpCdo.js";
+import { a as StyleSheet, c as parseStsh, i as Style, l as resolveStyleFormatting, n as STI_USER_DEFINED, o as buildStshForStyles, r as STK, s as headingLevelFromIstd, t as ResolvedStyleFormatting } from "./stsh-Bj0YSEOp.js";
+import { i as splitEntriesByBoundaries, n as ReadContext, r as readParagraphs, t as ParagraphEntry } from "./paragraphs-s2lJ6w2I.js";
+import { a as parseClx, i as characterSize, n as PieceTable, r as characterOffset, t as Piece } from "./piece-table-CA18mhjv.js";
+import { HeaderFooterSlot, HeaderFooterStories, HeaderFooterStory, readHeaderFooterStories } from "./headers-footers.js";
 import { Plc, findLargestAtMost, parsePlc } from "./plc.js";
 import { layoutMetadataToSummaryInformation } from "./metadata.js";
-import { Piece, PieceTable, characterOffset, characterSize, parseClx } from "./text/piece-table.js";
 import { buildTextClx } from "./text/piece-table-write.js";
 import { COMPRESSED_CHARACTER_MAP, TextRange, readTextRange } from "./text/characters.js";
 import { ANNOTATION_REFERENCE, CELL_MARK, DRAWN_OBJECT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FOOTNOTE_REFERENCE, INLINE_PICTURE, LINE_BREAK, PARAGRAPH_MARK, SECTION_MARK, SYMBOL_ANCHOR, endsParagraph, isAnchorOnly } from "./text/special.js";
-import { a as operandSize, i as decodeSprm, n as SGC, o as readGrpprl, r as Sprm, t as Prl } from "./sprm-DEyvdOo0.js";
-import { ChpxFkp, FKP_PAGE_SIZE, PapxFkp, PapxLookup, PapxRecord, PropertyBinTable, parseChpxFkp, parsePapxFkp } from "./prop/fkp.js";
 import { ChpxRunToWrite, PapxParagraphToWrite, buildChpxPages, buildPapxPages, buildPropertyBinTable, firstFcOfPage, fitsAloneOnPapxPage } from "./prop/fkp-write.js";
-import { CharacterProperties, applyCharacterSprms, characterIstdFromGrpprl } from "./prop/chp.js";
 import { encodeCharacterGrpprl } from "./prop/chp-write.js";
-import { n as applyParagraphSprms, t as ParagraphProperties } from "./pap-DOFLMWcG.js";
 import { encodeParagraphGrpprl } from "./prop/pap-write.js";
-import { SectionProperties, applySectionSprms, readSectionProperties } from "./prop/sep.js";
+import { DocSectionProperties, SectionProperties, applySectionSprms, readAllSectionProperties } from "./prop/sep.js";
 import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.js";
-import { ResolvedStyleFormatting, STI_USER_DEFINED, STK, Style, StyleSheet, buildStshForStyles, headingLevelFromIstd, parseStsh, resolveStyleFormatting } from "./style/stsh.js";
 import { buildFontTable, parseFontTable } from "./style/fonts.js";
-import { a as readNumberingDefinitions, i as NumberingLevel, n as NumberingDefinition, r as NumberingDefinitions, t as NUMBER_FORMAT_BY_NFC } from "./numbering-DayjnHXY.js";
-import { DocContent, DocStreams, ParagraphEntry, readDocContent, readDocStreams } from "./read.js";
+import { NUMBER_FORMAT_BY_NFC, NumberingDefinition, NumberingDefinitions, NumberingLevel, readNumberingDefinitions } from "./list/numbering.js";
+import { readSubdocumentStories, storyText } from "./subdocument.js";
+import { Comment, Footnote, NoteBodies, readNoteBodies } from "./notes.js";
+import { DocContent, DocStreams, readDocContent, readDocStreams } from "./read.js";
 import { WriteDocContentOptions, writeDocContent } from "./write.js";
-export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, CharacterProperties, ChpxFkp, ChpxRunToWrite, DRAWN_OBJECT, DocContent, DocFormatError, DocStreams, DocUnsupportedError, FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FKP_PAGE_SIZE, FOOTNOTE_REFERENCE, Fib, FibWriteSpec, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, NUMBER_FORMAT_BY_NFC, NumberingDefinition, NumberingDefinitions, NumberingLevel, PARAGRAPH_MARK, PapxFkp, PapxLookup, PapxParagraphToWrite, PapxRecord, ParagraphEntry, ParagraphProperties, Piece, PieceTable, Plc, Prl, PropertyBinTable, ResolvedStyleFormatting, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, SectionProperties, Sprm, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, WriteDocContentOptions, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, peekFibBaseFlags, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readNumberingDefinitions, readSectionProperties, readTextRange, readUint16LE, readUint32LE, readUint8, resolveStyleFormatting, slice, tableStreamName, writeDocContent };
+export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, CharacterProperties, ChpxFkp, ChpxRunToWrite, Comment, DATA_STREAM, DRAWN_OBJECT, DocContent, DocFormatError, DocSectionProperties, DocStreams, DocUnsupportedError, FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FKP_PAGE_SIZE, FOOTNOTE_REFERENCE, Fib, FibWriteSpec, Footnote, HeaderFooterSlot, HeaderFooterStories, HeaderFooterStory, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, NUMBER_FORMAT_BY_NFC, NoteBodies, NumberingDefinition, NumberingDefinitions, NumberingLevel, PARAGRAPH_MARK, PapxFkp, PapxLookup, PapxParagraphToWrite, PapxRecord, ParagraphEntry, ParagraphProperties, Piece, PieceTable, Plc, Prl, PropertyBinTable, ReadContext, ResolvedStyleFormatting, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, SectionProperties, Sprm, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, WriteDocContentOptions, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, peekFibBaseFlags, readAllSectionProperties, readDocContent, readDocStreams, readGrpprl, readHeaderFooterStories, readInt16LE, readInt32LE, readNoteBodies, readNumberingDefinitions, readParagraphs, readSubdocumentStories, readTextRange, readUint16LE, readUint32LE, readUint8, resolveStyleFormatting, slice, splitEntriesByBoundaries, storyText, tableStreamName, writeDocContent };

package/dist/index.js

@@ -1,27 +1,31 @@
 import { DocFormatError, DocUnsupportedError } from "./errors.js";
 import { readInt16LE, readInt32LE, readUint16LE, readUint32LE, readUint8, slice } from "./bytes.js";
 import { FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, LW_OFFSET } from "./fib/offsets.js";
-import { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.js";
+import { DATA_STREAM, SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.js";
 import { findLargestAtMost, parsePlc } from "./plc.js";
+import { FKP_PAGE_SIZE, PropertyBinTable, parseChpxFkp, parsePapxFkp } from "./prop/fkp.js";
+import { SGC, decodeSprm, operandSize, readGrpprl } from "./prop/sprm.js";
+import { applyCharacterSprms, characterIstdFromGrpprl } from "./prop/chp.js";
+import { applyParagraphSprms } from "./prop/pap.js";
+import { STI_USER_DEFINED, STK, buildStshForStyles, headingLevelFromIstd, parseStsh, resolveStyleFormatting } from "./style/stsh.js";
+import { ANNOTATION_REFERENCE, CELL_MARK, DRAWN_OBJECT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FOOTNOTE_REFERENCE, INLINE_PICTURE, LINE_BREAK, PARAGRAPH_MARK, SECTION_MARK, SYMBOL_ANCHOR, endsParagraph, isAnchorOnly } from "./text/special.js";
+import { readParagraphs, splitEntriesByBoundaries } from "./text/paragraphs.js";
+import { characterOffset, characterSize, parseClx } from "./text/piece-table.js";
+import { COMPRESSED_CHARACTER_MAP, readTextRange } from "./text/characters.js";
+import { readSubdocumentStories, storyText } from "./subdocument.js";
+import { readHeaderFooterStories } from "./headers-footers.js";
 import { parseFib, peekFibBaseFlags, tableStreamName } from "./fib/fib.js";
 import { buildFib } from "./fib/write.js";
 import { layoutMetadataToSummaryInformation } from "./metadata.js";
-import { characterOffset, characterSize, parseClx } from "./text/piece-table.js";
 import { buildTextClx } from "./text/piece-table-write.js";
-import { COMPRESSED_CHARACTER_MAP, readTextRange } from "./text/characters.js";
-import { ANNOTATION_REFERENCE, CELL_MARK, DRAWN_OBJECT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FOOTNOTE_REFERENCE, INLINE_PICTURE, LINE_BREAK, PARAGRAPH_MARK, SECTION_MARK, SYMBOL_ANCHOR, endsParagraph, isAnchorOnly } from "./text/special.js";
-import { SGC, decodeSprm, operandSize, readGrpprl } from "./prop/sprm.js";
-import { FKP_PAGE_SIZE, PropertyBinTable, parseChpxFkp, parsePapxFkp } from "./prop/fkp.js";
 import { buildChpxPages, buildPapxPages, buildPropertyBinTable, firstFcOfPage, fitsAloneOnPapxPage } from "./prop/fkp-write.js";
-import { applyCharacterSprms, characterIstdFromGrpprl } from "./prop/chp.js";
 import { encodeCharacterGrpprl } from "./prop/chp-write.js";
-import { applyParagraphSprms } from "./prop/pap.js";
 import { encodeParagraphGrpprl } from "./prop/pap-write.js";
-import { applySectionSprms, readSectionProperties } from "./prop/sep.js";
+import { applySectionSprms, readAllSectionProperties } from "./prop/sep.js";
 import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.js";
-import { STI_USER_DEFINED, STK, buildStshForStyles, headingLevelFromIstd, parseStsh, resolveStyleFormatting } from "./style/stsh.js";
 import { buildFontTable, parseFontTable } from "./style/fonts.js";
 import { NUMBER_FORMAT_BY_NFC, readNumberingDefinitions } from "./list/numbering.js";
+import { readNoteBodies } from "./notes.js";
 import { readDocContent, readDocStreams } from "./read.js";
 import { writeDocContent } from "./write.js";
-export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, DRAWN_OBJECT, DocFormatError, DocUnsupportedError, FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FKP_PAGE_SIZE, FOOTNOTE_REFERENCE, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, NUMBER_FORMAT_BY_NFC, PARAGRAPH_MARK, PropertyBinTable, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, peekFibBaseFlags, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readNumberingDefinitions, readSectionProperties, readTextRange, readUint16LE, readUint32LE, readUint8, resolveStyleFormatting, slice, tableStreamName, writeDocContent };
+export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, DATA_STREAM, DRAWN_OBJECT, DocFormatError, DocUnsupportedError, FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_BASE_SIZE, FIB_CB_RG_FC_LCB_OFFSET, FIB_CSLW_OFFSET, FIB_CSLW_REQUIRED, FIB_CSW_REQUIRED, FIB_FC_LCB_BLOB_OFFSET, FIB_LKEY_OFFSET, FIB_RG_LW_OFFSET, FIB_RG_LW_SIZE, FIB_RG_W_OFFSET, FIB_RG_W_SIZE, FIB_W_IDENT, FIELD_BEGIN, FIELD_END, FIELD_SEPARATOR, FKP_PAGE_SIZE, FOOTNOTE_REFERENCE, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, NUMBER_FORMAT_BY_NFC, PARAGRAPH_MARK, PropertyBinTable, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, peekFibBaseFlags, readAllSectionProperties, readDocContent, readDocStreams, readGrpprl, readHeaderFooterStories, readInt16LE, readInt32LE, readNoteBodies, readNumberingDefinitions, readParagraphs, readSubdocumentStories, readTextRange, readUint16LE, readUint32LE, readUint8, resolveStyleFormatting, slice, splitEntriesByBoundaries, storyText, tableStreamName, writeDocContent };

package/dist/list/numbering-write.d.cts

@@ -1,4 +1,4 @@
-import { r as NumberingDefinitions } from "../numbering-DSpm9w6y.cjs";
+import { NumberingDefinitions } from "./numbering.cjs";
 import { ContentListMembership } from "document-schema.js";
 //#region src/list/numbering-write.d.ts
 /** One document's own numbering, gathered from every paragraph's list membership (the caller passes the already-flattened sequence, table cells included, so a list used only inside a table cell is still resolved). */

package/dist/list/numbering-write.d.ts

@@ -1,4 +1,4 @@
-import { r as NumberingDefinitions } from "../numbering-DayjnHXY.js";
+import { NumberingDefinitions } from "./numbering.js";
 import { ContentListMembership } from "document-schema.js";
 //#region src/list/numbering-write.d.ts
 /** One document's own numbering, gathered from every paragraph's list membership (the caller passes the already-flattened sequence, table cells included, so a list used only inside a table cell is still resolved). */

package/dist/list/numbering.d.cts

@@ -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-DSpm9w6y.cjs";
+import { t as Fib } from "../fib-6BFIx153.cjs";
+//#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/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 };