doc-codec 2.8.6 → 2.10.0

package/dist/index.cjs

@@ -28,6 +28,7 @@ const require_prop_sep = require("./prop/sep.cjs");
 const require_prop_sep_write = require("./prop/sep-write.cjs");
 const require_style_fonts = require("./style/fonts.cjs");
 const require_list_numbering = require("./list/numbering.cjs");
+const require_subdocument_write = require("./subdocument-write.cjs");
 const require_notes = require("./notes.cjs");
 const require_read = require("./read.cjs");
 const require_write = require("./write.cjs");
@@ -56,6 +57,7 @@ exports.FIB_W_IDENT = require_fib_offsets.FIB_W_IDENT;
 exports.FIELD_BEGIN = require_text_special.FIELD_BEGIN;
 exports.FIELD_END = require_text_special.FIELD_END;
 exports.FIELD_SEPARATOR = require_text_special.FIELD_SEPARATOR;
+exports.FIXED_SEPARATOR_STORY_COUNT = require_headers_footers.FIXED_SEPARATOR_STORY_COUNT;
 exports.FKP_PAGE_SIZE = require_prop_fkp.FKP_PAGE_SIZE;
 exports.FOOTNOTE_REFERENCE = require_text_special.FOOTNOTE_REFERENCE;
 exports.INLINE_PICTURE = require_text_special.INLINE_PICTURE;
@@ -66,6 +68,7 @@ exports.PARAGRAPH_MARK = require_text_special.PARAGRAPH_MARK;
 exports.PropertyBinTable = require_prop_fkp.PropertyBinTable;
 exports.SECTION_MARK = require_text_special.SECTION_MARK;
 exports.SGC = require_prop_sprm.SGC;
+exports.SLOT_ORDER = require_headers_footers.SLOT_ORDER;
 exports.STI_USER_DEFINED = require_style_stsh.STI_USER_DEFINED;
 exports.STK = require_style_stsh.STK;
 exports.SUMMARY_INFORMATION_STREAM = require_detect.SUMMARY_INFORMATION_STREAM;
@@ -78,10 +81,13 @@ exports.base64ToBytes = require_base64.base64ToBytes;
 exports.buildChpxPages = require_prop_fkp_write.buildChpxPages;
 exports.buildFib = require_fib_write.buildFib;
 exports.buildFontTable = require_style_fonts.buildFontTable;
+exports.buildHeaderSubdocument = require_subdocument_write.buildHeaderSubdocument;
+exports.buildNoteSubdocument = require_subdocument_write.buildNoteSubdocument;
 exports.buildPapxPages = require_prop_fkp_write.buildPapxPages;
 exports.buildPlcfSed = require_prop_sep_write.buildPlcfSed;
 exports.buildPropertyBinTable = require_prop_fkp_write.buildPropertyBinTable;
 exports.buildSepx = require_prop_sep_write.buildSepx;
+exports.buildStorySubdocuments = require_subdocument_write.buildStorySubdocuments;
 exports.buildStshForStyles = require_style_stsh.buildStshForStyles;
 exports.buildTextClx = require_text_piece_table_write.buildTextClx;
 exports.bytesToBase64 = require_base64.bytesToBase64;
@@ -101,6 +107,7 @@ exports.isAnchorOnly = require_text_special.isAnchorOnly;
 exports.isDocBytes = require_detect.isDocBytes;
 exports.layoutMetadataToSummaryInformation = require_metadata.layoutMetadataToSummaryInformation;
 exports.operandSize = require_prop_sprm.operandSize;
+exports.paragraphCharacters = require_subdocument_write.paragraphCharacters;
 exports.parseChpxFkp = require_prop_fkp.parseChpxFkp;
 exports.parseClx = require_text_piece_table.parseClx;
 exports.parseFib = require_fib_fib.parseFib;

package/dist/index.d.cts

@@ -13,7 +13,7 @@ import { n as applyParagraphSprms, t as ParagraphProperties } from "./pap-BQ2E17
 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 { FIXED_SEPARATOR_STORY_COUNT, HeaderFooterSlot, HeaderFooterStories, HeaderFooterStory, SLOT_ORDER, readHeaderFooterStories } from "./headers-footers.cjs";
 import { Plc, findLargestAtMost, parsePlc } from "./plc.cjs";
 import { layoutMetadataToSummaryInformation } from "./metadata.cjs";
 import { buildTextClx } from "./text/piece-table-write.cjs";
@@ -27,7 +27,8 @@ import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.c
 import { buildFontTable, parseFontTable } from "./style/fonts.cjs";
 import { NUMBER_FORMAT_BY_NFC, NumberingDefinition, NumberingDefinitions, NumberingLevel, readNumberingDefinitions } from "./list/numbering.cjs";
 import { readSubdocumentStories, storyText } from "./subdocument.cjs";
+import { StorySubdocument, StorySubdocuments, buildHeaderSubdocument, buildNoteSubdocument, buildStorySubdocuments, paragraphCharacters } from "./subdocument-write.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, Comment, DATA_STREAM, DRAWN_OBJECT, DataStreamBuilder, 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, base64ToBytes, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, bytesToBase64, 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 };
+import { WritableDocContent, WriteDocContentOptions, writeDocContent } from "./write.cjs";
+export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, CharacterProperties, ChpxFkp, ChpxRunToWrite, Comment, DATA_STREAM, DRAWN_OBJECT, DataStreamBuilder, 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, FIXED_SEPARATOR_STORY_COUNT, 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, SLOT_ORDER, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, SectionProperties, Sprm, StorySubdocument, StorySubdocuments, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, WritableDocContent, WriteDocContentOptions, applyCharacterSprms, applyParagraphSprms, applySectionSprms, base64ToBytes, buildChpxPages, buildFib, buildFontTable, buildHeaderSubdocument, buildNoteSubdocument, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStorySubdocuments, buildStshForStyles, buildTextClx, bytesToBase64, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, paragraphCharacters, 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

@@ -13,7 +13,7 @@ import { n as applyParagraphSprms, t as ParagraphProperties } from "./pap-iWFIpC
 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 { FIXED_SEPARATOR_STORY_COUNT, HeaderFooterSlot, HeaderFooterStories, HeaderFooterStory, SLOT_ORDER, readHeaderFooterStories } from "./headers-footers.js";
 import { Plc, findLargestAtMost, parsePlc } from "./plc.js";
 import { layoutMetadataToSummaryInformation } from "./metadata.js";
 import { buildTextClx } from "./text/piece-table-write.js";
@@ -27,7 +27,8 @@ import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.j
 import { buildFontTable, parseFontTable } from "./style/fonts.js";
 import { NUMBER_FORMAT_BY_NFC, NumberingDefinition, NumberingDefinitions, NumberingLevel, readNumberingDefinitions } from "./list/numbering.js";
 import { readSubdocumentStories, storyText } from "./subdocument.js";
+import { StorySubdocument, StorySubdocuments, buildHeaderSubdocument, buildNoteSubdocument, buildStorySubdocuments, paragraphCharacters } from "./subdocument-write.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, Comment, DATA_STREAM, DRAWN_OBJECT, DataStreamBuilder, 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, base64ToBytes, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, bytesToBase64, 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 };
+import { WritableDocContent, WriteDocContentOptions, writeDocContent } from "./write.js";
+export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, CharacterProperties, ChpxFkp, ChpxRunToWrite, Comment, DATA_STREAM, DRAWN_OBJECT, DataStreamBuilder, 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, FIXED_SEPARATOR_STORY_COUNT, 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, SLOT_ORDER, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, SectionProperties, Sprm, StorySubdocument, StorySubdocuments, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, WritableDocContent, WriteDocContentOptions, applyCharacterSprms, applyParagraphSprms, applySectionSprms, base64ToBytes, buildChpxPages, buildFib, buildFontTable, buildHeaderSubdocument, buildNoteSubdocument, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStorySubdocuments, buildStshForStyles, buildTextClx, bytesToBase64, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, paragraphCharacters, 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

@@ -15,7 +15,7 @@ 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 { FIXED_SEPARATOR_STORY_COUNT, SLOT_ORDER, readHeaderFooterStories } from "./headers-footers.js";
 import { parseFib, peekFibBaseFlags, tableStreamName } from "./fib/fib.js";
 import { buildFib } from "./fib/write.js";
 import { layoutMetadataToSummaryInformation } from "./metadata.js";
@@ -27,7 +27,8 @@ import { applySectionSprms, readAllSectionProperties } from "./prop/sep.js";
 import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.js";
 import { buildFontTable, parseFontTable } from "./style/fonts.js";
 import { NUMBER_FORMAT_BY_NFC, readNumberingDefinitions } from "./list/numbering.js";
+import { buildHeaderSubdocument, buildNoteSubdocument, buildStorySubdocuments, paragraphCharacters } from "./subdocument-write.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, DATA_STREAM, DRAWN_OBJECT, DataStreamBuilder, 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, base64ToBytes, buildChpxPages, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStshForStyles, buildTextClx, bytesToBase64, 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 };
+export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, DATA_STREAM, DRAWN_OBJECT, DataStreamBuilder, 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, FIXED_SEPARATOR_STORY_COUNT, FKP_PAGE_SIZE, FOOTNOTE_REFERENCE, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, NUMBER_FORMAT_BY_NFC, PARAGRAPH_MARK, PropertyBinTable, SECTION_MARK, SGC, SLOT_ORDER, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, applySectionSprms, base64ToBytes, buildChpxPages, buildFib, buildFontTable, buildHeaderSubdocument, buildNoteSubdocument, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildStorySubdocuments, buildStshForStyles, buildTextClx, bytesToBase64, characterIstdFromGrpprl, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, fitsAloneOnPapxPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, paragraphCharacters, 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.cjs

@@ -74,9 +74,7 @@ const NUMBER_FORMAT_BY_NFC = {
 const NFC_NONE = 255;
 function numberFormatFor(nfc) {
 	if (nfc === NFC_NONE) return "none";
-	const format = NUMBER_FORMAT_BY_NFC[nfc];
-	if (format === void 0) throw new require_errors.DocFormatError(`LVLF.nfc is 0x${nfc.toString(16).padStart(2, "0")}, not a recognised MSONFC value ([MS-OSHARED] 2.2.1.3)`);
-	return format;
+	return NUMBER_FORMAT_BY_NFC[nfc] ?? "decimal";
 }
 /** LSTF ([MS-DOC] 2.9.147): lsid(4) + tplc(4, ignored -- UI-only) + rgistdPara(18, ignored -- this reader has no per-level style cascade to link into) + a flags byte (only fSimpleList, bit 0, acted on) + grfhic(1, ignored -- HTML-export-only incompatibility flags). Fixed 28 bytes. */
 function readLstf(bytes, offset) {

package/dist/list/numbering.js

@@ -73,9 +73,7 @@ const NUMBER_FORMAT_BY_NFC = {
 const NFC_NONE = 255;
 function numberFormatFor(nfc) {
 	if (nfc === NFC_NONE) return "none";
-	const format = NUMBER_FORMAT_BY_NFC[nfc];
-	if (format === void 0) throw new DocFormatError(`LVLF.nfc is 0x${nfc.toString(16).padStart(2, "0")}, not a recognised MSONFC value ([MS-OSHARED] 2.2.1.3)`);
-	return format;
+	return NUMBER_FORMAT_BY_NFC[nfc] ?? "decimal";
 }
 /** LSTF ([MS-DOC] 2.9.147): lsid(4) + tplc(4, ignored -- UI-only) + rgistdPara(18, ignored -- this reader has no per-level style cascade to link into) + a flags byte (only fSimpleList, bit 0, acted on) + grfhic(1, ignored -- HTML-export-only incompatibility flags). Fixed 28 bytes. */
 function readLstf(bytes, offset) {

package/dist/read.cjs

@@ -5,6 +5,7 @@ const require_detect = require("./detect.cjs");
 const require_encryption = require("./encryption.cjs");
 const require_prop_fkp = require("./prop/fkp.cjs");
 const require_style_stsh = require("./style/stsh.cjs");
+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");
@@ -70,7 +71,7 @@ function readDocContent(bytes, password) {
 	const entries = require_text_paragraphs.readParagraphs(range.text, range.fcs, context);
 	const numbering = require_list_numbering.readNumberingDefinitions(table, fib);
 	const sectionProperties = require_prop_sep.readAllSectionProperties(wordDocument, table, fib);
-	const entriesBySection = splitIntoSections(entries, sectionProperties);
+	const entriesBySection = splitIntoSections(markManualPageBreaks(entries, sectionProperties), sectionProperties);
 	const { footnotes, endnotes, comments } = require_notes.readNoteBodies(wordDocument, table, pieceTable, context, fib);
 	const headerFooterStories = require_headers_footers.readHeaderFooterStories(wordDocument, table, pieceTable, context, fib, sectionProperties.length);
 	return {
@@ -87,7 +88,7 @@ function readDocContent(bytes, password) {
 				topPt: properties.marginTopPt ?? DEFAULT_MARGINS.topPt,
 				bottomPt: properties.marginBottomPt ?? DEFAULT_MARGINS.bottomPt
 			},
-			blocks: require_table_read.assembleBlocks(entriesBySection[index] ?? [])
+			blocks: require_table_read.assembleBlocks(entriesBySection[index] ?? [], index === sectionProperties.length - 1)
 		})),
 		numbering,
 		footnotes,
@@ -96,6 +97,22 @@ function readDocContent(bytes, password) {
 		headerFooterStories
 	};
 }
+/** The single block a manual page break reads as -- no fields of its own, exactly the shape every other codec in this family emits for one. */
+const PAGE_BREAK_BLOCK = { kind: "pageBreak" };
+function markManualPageBreaks(entries, sections) {
+	const sectionEndCps = /* @__PURE__ */ new Set();
+	for (let index = 1; index < sections.length; index += 1) {
+		const startCp = sections[index]?.startCp;
+		if (startCp !== void 0) sectionEndCps.add(startCp);
+	}
+	return entries.map((entry) => {
+		if (entry.terminator !== 12 || sectionEndCps.has(entry.endCp)) return entry;
+		return {
+			...entry,
+			blocks: [...entry.blocks, PAGE_BREAK_BLOCK]
+		};
+	});
+}
 function splitIntoSections(entries, sections) {
 	const groups = sections.map(() => []);
 	let sectionIndex = 0;

package/dist/read.js

@@ -4,6 +4,7 @@ import { DATA_STREAM, SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM } from ".
 import { decryptDocStreams } from "./encryption.js";
 import { PropertyBinTable } from "./prop/fkp.js";
 import { parseStsh } from "./style/stsh.js";
+import "./text/special.js";
 import { readParagraphs } from "./text/paragraphs.js";
 import { parseClx } from "./text/piece-table.js";
 import { readTextRange } from "./text/characters.js";
@@ -69,7 +70,7 @@ function readDocContent(bytes, password) {
 	const entries = readParagraphs(range.text, range.fcs, context);
 	const numbering = readNumberingDefinitions(table, fib);
 	const sectionProperties = readAllSectionProperties(wordDocument, table, fib);
-	const entriesBySection = splitIntoSections(entries, sectionProperties);
+	const entriesBySection = splitIntoSections(markManualPageBreaks(entries, sectionProperties), sectionProperties);
 	const { footnotes, endnotes, comments } = readNoteBodies(wordDocument, table, pieceTable, context, fib);
 	const headerFooterStories = readHeaderFooterStories(wordDocument, table, pieceTable, context, fib, sectionProperties.length);
 	return {
@@ -86,7 +87,7 @@ function readDocContent(bytes, password) {
 				topPt: properties.marginTopPt ?? DEFAULT_MARGINS.topPt,
 				bottomPt: properties.marginBottomPt ?? DEFAULT_MARGINS.bottomPt
 			},
-			blocks: assembleBlocks(entriesBySection[index] ?? [])
+			blocks: assembleBlocks(entriesBySection[index] ?? [], index === sectionProperties.length - 1)
 		})),
 		numbering,
 		footnotes,
@@ -95,6 +96,22 @@ function readDocContent(bytes, password) {
 		headerFooterStories
 	};
 }
+/** The single block a manual page break reads as -- no fields of its own, exactly the shape every other codec in this family emits for one. */
+const PAGE_BREAK_BLOCK = { kind: "pageBreak" };
+function markManualPageBreaks(entries, sections) {
+	const sectionEndCps = /* @__PURE__ */ new Set();
+	for (let index = 1; index < sections.length; index += 1) {
+		const startCp = sections[index]?.startCp;
+		if (startCp !== void 0) sectionEndCps.add(startCp);
+	}
+	return entries.map((entry) => {
+		if (entry.terminator !== 12 || sectionEndCps.has(entry.endCp)) return entry;
+		return {
+			...entry,
+			blocks: [...entry.blocks, PAGE_BREAK_BLOCK]
+		};
+	});
+}
 function splitIntoSections(entries, sections) {
 	const groups = sections.map(() => []);
 	let sectionIndex = 0;

package/dist/subdocument-write.cjs

@@ -0,0 +1,108 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("./errors.cjs");
+require("./text/special.cjs");
+const require_headers_footers = require("./headers-footers.cjs");
+const require_table_write = require("./table/write.cjs");
+//#region src/subdocument-write.ts
+/** A plain one-run text run: no character formatting, no extra grpprl -- a note body's own text carries no modelled formatting to state. */
+function textRun(text) {
+	return {
+		run: { text },
+		extraGrpprl: []
+	};
+}
+/** The bare paragraph mark every non-empty story ends with -- no runs, no properties, the "not considered part of the story contents" guard itself. */
+function guardParagraph() {
+	return {
+		runs: [],
+		properties: {},
+		extraGrpprl: [],
+		terminator: 13
+	};
+}
+/** One paragraph's own character footprint in the text stream: every run's own characters plus the paragraph's own terminator. Exported because write.ts counts the main document's own ccpText with the identical arithmetic -- one source, so the two can never disagree about what a paragraph costs. */
+function paragraphCharacters(paragraph) {
+	return 1 + paragraph.runs.reduce((count, run) => count + run.run.text.length, 0);
+}
+/** A CP-only plex (element size 0, [MS-DOC] 2.2.2's own "the data thus has a size of 0 bytes" shape PlcffndTxt/PlcfandTxt/PlcfendTxt/PlcfHdd all share): just the aCP array, one 4-byte little-endian value per key. */
+function buildCpOnlyPlex(keys) {
+	const bytes = new Uint8Array(keys.length * 4);
+	const view = new DataView(bytes.buffer);
+	keys.forEach((key, index) => {
+		view.setUint32(index * 4, key, true);
+	});
+	return bytes;
+}
+function finishSubdocument(paragraphs, storyStarts, characters) {
+	paragraphs.push(guardParagraph());
+	const ccp = characters + 1;
+	return {
+		paragraphs,
+		plex: buildCpOnlyPlex([
+			...storyStarts,
+			characters,
+			ccp
+		]),
+		ccp
+	};
+}
+function buildNoteSubdocument(notes) {
+	const paragraphs = [];
+	const storyStarts = [];
+	let characters = 0;
+	for (const note of notes) {
+		storyStarts.push(characters);
+		const story = note.text.split("\n").map((line) => ({
+			runs: line === "" ? [] : [textRun(line)],
+			properties: {},
+			extraGrpprl: [],
+			terminator: 13
+		}));
+		story.push(guardParagraph());
+		for (const paragraph of story) characters += paragraphCharacters(paragraph);
+		paragraphs.push(...story);
+	}
+	return finishSubdocument(paragraphs, storyStarts, characters);
+}
+function buildHeaderSubdocument(stories, sectionCount, dataStream, onWarning) {
+	const bySlot = /* @__PURE__ */ new Map();
+	for (const story of stories) {
+		if (!Number.isInteger(story.section) || story.section < 0 || story.section >= sectionCount) throw new require_errors.DocFormatError(`a header/footer story names section ${String(story.section)}, but this document has ${String(sectionCount)} sections`);
+		const key = `${String(story.section)}:${story.slot}`;
+		if (bySlot.has(key)) throw new require_errors.DocFormatError(`more than one header/footer story was given for section ${String(story.section)}'s ${story.slot} slot; a slot holds one story`);
+		bySlot.set(key, story);
+	}
+	const paragraphs = [];
+	const storyStarts = [];
+	let characters = 0;
+	for (let count = 0; count < 6; count += 1) storyStarts.push(0);
+	for (let section = 0; section < sectionCount; section += 1) for (const slot of require_headers_footers.SLOT_ORDER) {
+		storyStarts.push(characters);
+		const story = bySlot.get(`${String(section)}:${slot}`);
+		if (story === void 0) continue;
+		let content = require_table_write.flattenSectionBlocks(story.blocks, dataStream, onWarning);
+		if (content.length === 0) content = [{
+			runs: [],
+			properties: {},
+			extraGrpprl: [],
+			terminator: 13
+		}];
+		content.push(guardParagraph());
+		for (const paragraph of content) characters += paragraphCharacters(paragraph);
+		paragraphs.push(...content);
+	}
+	return finishSubdocument(paragraphs, storyStarts, characters);
+}
+function buildStorySubdocuments(document, dataStream, onWarning) {
+	return {
+		footnote: document.footnotes !== void 0 && document.footnotes.length > 0 ? buildNoteSubdocument(document.footnotes) : void 0,
+		header: document.headerFooterStories !== void 0 && document.headerFooterStories.length > 0 ? buildHeaderSubdocument(document.headerFooterStories, document.sections.length, dataStream, onWarning) : void 0,
+		comment: document.comments !== void 0 && document.comments.length > 0 ? buildNoteSubdocument(document.comments) : void 0,
+		endnote: document.endnotes !== void 0 && document.endnotes.length > 0 ? buildNoteSubdocument(document.endnotes) : void 0
+	};
+}
+//#endregion
+exports.buildHeaderSubdocument = buildHeaderSubdocument;
+exports.buildNoteSubdocument = buildNoteSubdocument;
+exports.buildStorySubdocuments = buildStorySubdocuments;
+exports.paragraphCharacters = paragraphCharacters;

package/dist/subdocument-write.d.cts

@@ -0,0 +1,42 @@
+import { t as DataStreamBuilder } from "./data-stream-BLCj4-V1.cjs";
+import { HeaderFooterStory } from "./headers-footers.cjs";
+import { r as WriteWarning, t as WriteParagraph } from "./write-CMB3qF4i.cjs";
+import { ContentDocument } from "document-schema.js";
+//#region src/subdocument-write.d.ts
+/** One written subdocument: its paragraphs (to be appended after the main document's own, in [MS-DOC]'s own subdocument order), the CP-only plex dividing them into stories, and the ccp the FIB states for it. `undefined` never appears here -- a subdocument with no stories is not written at all (write.ts leaves its ccp and fc/lcb pairs zero, exactly what the reader treats as "absent"). */
+interface StorySubdocument {
+  readonly paragraphs: readonly WriteParagraph[];
+  readonly plex: Uint8Array<ArrayBuffer>;
+  readonly ccp: number;
+}
+/** One paragraph's own character footprint in the text stream: every run's own characters plus the paragraph's own terminator. Exported because write.ts counts the main document's own ccpText with the identical arithmetic -- one source, so the two can never disagree about what a paragraph costs. */
+declare function paragraphCharacters(paragraph: WriteParagraph): number;
+declare function buildNoteSubdocument(notes: readonly {
+  readonly text: string;
+}[]): StorySubdocument;
+declare function buildHeaderSubdocument(stories: readonly HeaderFooterStory[], sectionCount: number, dataStream: DataStreamBuilder, onWarning?: WriteWarning): StorySubdocument;
+/** Every story subdocument a document carries, in [MS-DOC]'s own concatenation order (footnote, header, comment, endnote -- the same order notes.ts/read.ts count ccp boundaries in), each undefined when the document carries none of that kind. */
+interface StorySubdocuments {
+  readonly footnote: StorySubdocument | undefined;
+  readonly header: StorySubdocument | undefined;
+  readonly comment: StorySubdocument | undefined;
+  readonly endnote: StorySubdocument | undefined;
+}
+/** The input type's own optional story fields, isolated here so buildStorySubdocuments states its shape once -- writeDocContent's WritableDocContent satisfies it directly. */
+interface StorySources {
+  readonly footnotes?: readonly {
+    readonly text: string;
+  }[];
+  readonly endnotes?: readonly {
+    readonly text: string;
+  }[];
+  readonly comments?: readonly {
+    readonly text: string;
+  }[];
+  readonly headerFooterStories?: readonly HeaderFooterStory[];
+}
+declare function buildStorySubdocuments(document: StorySources & Pick<Extract<ContentDocument, {
+  kind: "wordprocessing";
+}>, "sections">, dataStream: DataStreamBuilder, onWarning?: WriteWarning): StorySubdocuments;
+//#endregion
+export { StorySubdocument, StorySubdocuments, buildHeaderSubdocument, buildNoteSubdocument, buildStorySubdocuments, paragraphCharacters };

package/dist/subdocument-write.d.ts

@@ -0,0 +1,42 @@
+import { t as DataStreamBuilder } from "./data-stream-BLCj4-V1.js";
+import { HeaderFooterStory } from "./headers-footers.js";
+import { r as WriteWarning, t as WriteParagraph } from "./write-t4rFgnA-.js";
+import { ContentDocument } from "document-schema.js";
+//#region src/subdocument-write.d.ts
+/** One written subdocument: its paragraphs (to be appended after the main document's own, in [MS-DOC]'s own subdocument order), the CP-only plex dividing them into stories, and the ccp the FIB states for it. `undefined` never appears here -- a subdocument with no stories is not written at all (write.ts leaves its ccp and fc/lcb pairs zero, exactly what the reader treats as "absent"). */
+interface StorySubdocument {
+  readonly paragraphs: readonly WriteParagraph[];
+  readonly plex: Uint8Array<ArrayBuffer>;
+  readonly ccp: number;
+}
+/** One paragraph's own character footprint in the text stream: every run's own characters plus the paragraph's own terminator. Exported because write.ts counts the main document's own ccpText with the identical arithmetic -- one source, so the two can never disagree about what a paragraph costs. */
+declare function paragraphCharacters(paragraph: WriteParagraph): number;
+declare function buildNoteSubdocument(notes: readonly {
+  readonly text: string;
+}[]): StorySubdocument;
+declare function buildHeaderSubdocument(stories: readonly HeaderFooterStory[], sectionCount: number, dataStream: DataStreamBuilder, onWarning?: WriteWarning): StorySubdocument;
+/** Every story subdocument a document carries, in [MS-DOC]'s own concatenation order (footnote, header, comment, endnote -- the same order notes.ts/read.ts count ccp boundaries in), each undefined when the document carries none of that kind. */
+interface StorySubdocuments {
+  readonly footnote: StorySubdocument | undefined;
+  readonly header: StorySubdocument | undefined;
+  readonly comment: StorySubdocument | undefined;
+  readonly endnote: StorySubdocument | undefined;
+}
+/** The input type's own optional story fields, isolated here so buildStorySubdocuments states its shape once -- writeDocContent's WritableDocContent satisfies it directly. */
+interface StorySources {
+  readonly footnotes?: readonly {
+    readonly text: string;
+  }[];
+  readonly endnotes?: readonly {
+    readonly text: string;
+  }[];
+  readonly comments?: readonly {
+    readonly text: string;
+  }[];
+  readonly headerFooterStories?: readonly HeaderFooterStory[];
+}
+declare function buildStorySubdocuments(document: StorySources & Pick<Extract<ContentDocument, {
+  kind: "wordprocessing";
+}>, "sections">, dataStream: DataStreamBuilder, onWarning?: WriteWarning): StorySubdocuments;
+//#endregion
+export { StorySubdocument, StorySubdocuments, buildHeaderSubdocument, buildNoteSubdocument, buildStorySubdocuments, paragraphCharacters };

package/dist/subdocument-write.js

@@ -0,0 +1,104 @@
+import { DocFormatError } from "./errors.js";
+import "./text/special.js";
+import { SLOT_ORDER } from "./headers-footers.js";
+import { flattenSectionBlocks } from "./table/write.js";
+//#region src/subdocument-write.ts
+/** A plain one-run text run: no character formatting, no extra grpprl -- a note body's own text carries no modelled formatting to state. */
+function textRun(text) {
+	return {
+		run: { text },
+		extraGrpprl: []
+	};
+}
+/** The bare paragraph mark every non-empty story ends with -- no runs, no properties, the "not considered part of the story contents" guard itself. */
+function guardParagraph() {
+	return {
+		runs: [],
+		properties: {},
+		extraGrpprl: [],
+		terminator: 13
+	};
+}
+/** One paragraph's own character footprint in the text stream: every run's own characters plus the paragraph's own terminator. Exported because write.ts counts the main document's own ccpText with the identical arithmetic -- one source, so the two can never disagree about what a paragraph costs. */
+function paragraphCharacters(paragraph) {
+	return 1 + paragraph.runs.reduce((count, run) => count + run.run.text.length, 0);
+}
+/** A CP-only plex (element size 0, [MS-DOC] 2.2.2's own "the data thus has a size of 0 bytes" shape PlcffndTxt/PlcfandTxt/PlcfendTxt/PlcfHdd all share): just the aCP array, one 4-byte little-endian value per key. */
+function buildCpOnlyPlex(keys) {
+	const bytes = new Uint8Array(keys.length * 4);
+	const view = new DataView(bytes.buffer);
+	keys.forEach((key, index) => {
+		view.setUint32(index * 4, key, true);
+	});
+	return bytes;
+}
+function finishSubdocument(paragraphs, storyStarts, characters) {
+	paragraphs.push(guardParagraph());
+	const ccp = characters + 1;
+	return {
+		paragraphs,
+		plex: buildCpOnlyPlex([
+			...storyStarts,
+			characters,
+			ccp
+		]),
+		ccp
+	};
+}
+function buildNoteSubdocument(notes) {
+	const paragraphs = [];
+	const storyStarts = [];
+	let characters = 0;
+	for (const note of notes) {
+		storyStarts.push(characters);
+		const story = note.text.split("\n").map((line) => ({
+			runs: line === "" ? [] : [textRun(line)],
+			properties: {},
+			extraGrpprl: [],
+			terminator: 13
+		}));
+		story.push(guardParagraph());
+		for (const paragraph of story) characters += paragraphCharacters(paragraph);
+		paragraphs.push(...story);
+	}
+	return finishSubdocument(paragraphs, storyStarts, characters);
+}
+function buildHeaderSubdocument(stories, sectionCount, dataStream, onWarning) {
+	const bySlot = /* @__PURE__ */ new Map();
+	for (const story of stories) {
+		if (!Number.isInteger(story.section) || story.section < 0 || story.section >= sectionCount) throw new DocFormatError(`a header/footer story names section ${String(story.section)}, but this document has ${String(sectionCount)} sections`);
+		const key = `${String(story.section)}:${story.slot}`;
+		if (bySlot.has(key)) throw new DocFormatError(`more than one header/footer story was given for section ${String(story.section)}'s ${story.slot} slot; a slot holds one story`);
+		bySlot.set(key, story);
+	}
+	const paragraphs = [];
+	const storyStarts = [];
+	let characters = 0;
+	for (let count = 0; count < 6; count += 1) storyStarts.push(0);
+	for (let section = 0; section < sectionCount; section += 1) for (const slot of SLOT_ORDER) {
+		storyStarts.push(characters);
+		const story = bySlot.get(`${String(section)}:${slot}`);
+		if (story === void 0) continue;
+		let content = flattenSectionBlocks(story.blocks, dataStream, onWarning);
+		if (content.length === 0) content = [{
+			runs: [],
+			properties: {},
+			extraGrpprl: [],
+			terminator: 13
+		}];
+		content.push(guardParagraph());
+		for (const paragraph of content) characters += paragraphCharacters(paragraph);
+		paragraphs.push(...content);
+	}
+	return finishSubdocument(paragraphs, storyStarts, characters);
+}
+function buildStorySubdocuments(document, dataStream, onWarning) {
+	return {
+		footnote: document.footnotes !== void 0 && document.footnotes.length > 0 ? buildNoteSubdocument(document.footnotes) : void 0,
+		header: document.headerFooterStories !== void 0 && document.headerFooterStories.length > 0 ? buildHeaderSubdocument(document.headerFooterStories, document.sections.length, dataStream, onWarning) : void 0,
+		comment: document.comments !== void 0 && document.comments.length > 0 ? buildNoteSubdocument(document.comments) : void 0,
+		endnote: document.endnotes !== void 0 && document.endnotes.length > 0 ? buildNoteSubdocument(document.endnotes) : void 0
+	};
+}
+//#endregion
+export { buildHeaderSubdocument, buildNoteSubdocument, buildStorySubdocuments, paragraphCharacters };

package/dist/subdocument.cjs

@@ -1,15 +1,32 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("./errors.cjs");
 const require_bytes = require("./bytes.cjs");
-const require_plc = require("./plc.cjs");
 const require_text_paragraphs = require("./text/paragraphs.cjs");
 const require_text_characters = require("./text/characters.cjs");
 //#region src/subdocument.ts
+function readStoryPlexKeys(bytes, subdocLength, what) {
+	if (bytes.length < 4 || !Number.isInteger((bytes.length - 4) / 4)) throw new require_errors.DocFormatError(`${what} is ${bytes.length} bytes, which does not yield a whole number of 4-byte keys`);
+	const keys = [];
+	for (let offset = 0; offset < bytes.length; offset += 4) {
+		const raw = require_bytes.readInt32LE(bytes, offset);
+		const previous = keys[keys.length - 1] ?? 0;
+		keys.push(raw < 0 || raw > subdocLength ? previous : Math.max(raw, previous));
+	}
+	return keys;
+}
 function readSubdocumentStories(wordDocument, table, pieceTable, context, subdocStartCp, subdocLength, boundaryFc, boundaryLcb, what) {
 	if (subdocLength <= 0 || boundaryLcb <= 0) return [];
 	const range = require_text_characters.readTextRange(wordDocument, pieceTable, subdocStartCp, subdocStartCp + subdocLength);
 	const entries = require_text_paragraphs.readParagraphs(range.text, range.fcs, context);
-	const plc = require_plc.parsePlc(require_bytes.slice(table, boundaryFc, boundaryLcb, `${what} in the Table stream`), 0, what);
-	return require_text_paragraphs.splitEntriesByBoundaries(entries, plc.keys).slice(0, -1).map((story) => story.slice(0, -1));
+	const keys = readStoryPlexKeys(require_bytes.slice(table, boundaryFc, boundaryLcb, `${what} in the Table stream`), subdocLength, what);
+	return require_text_paragraphs.splitEntriesByBoundaries(entries, keys).slice(0, -1).map((story) => endsWithGuardParagraph(story) ? story.slice(0, -1) : story);
+}
+function endsWithGuardParagraph(story) {
+	const last = story[story.length - 1];
+	if (last === void 0) return false;
+	if (last.blocks.length !== 1) return false;
+	const only = last.blocks[0];
+	return only?.kind === "paragraph" && only.runs.length === 0;
 }
 /** Joins a story's own paragraphs into plain text -- one line per paragraph, matching how ooxml.js's own Footnote/Comment reading concatenates a footnote or comment body's `w:t` runs rather than preserving paragraph/run structure. A footnote, endnote, or comment in this family is carried as text alone; only a header or footer keeps real block flow (headers-footers.ts). Non-paragraph blocks a story's own entries produced (an inline picture split out of one of its paragraphs) contribute no text of their own here, the same way an image has no plain-text spelling in ooxml.js's own footnote/comment reading either. */
 function storyText(entries) {

package/dist/subdocument.js

@@ -1,14 +1,31 @@
-import { slice } from "./bytes.js";
-import { parsePlc } from "./plc.js";
+import { DocFormatError } from "./errors.js";
+import { readInt32LE, slice } from "./bytes.js";
 import { readParagraphs, splitEntriesByBoundaries } from "./text/paragraphs.js";
 import { readTextRange } from "./text/characters.js";
 //#region src/subdocument.ts
+function readStoryPlexKeys(bytes, subdocLength, what) {
+	if (bytes.length < 4 || !Number.isInteger((bytes.length - 4) / 4)) throw new DocFormatError(`${what} is ${bytes.length} bytes, which does not yield a whole number of 4-byte keys`);
+	const keys = [];
+	for (let offset = 0; offset < bytes.length; offset += 4) {
+		const raw = readInt32LE(bytes, offset);
+		const previous = keys[keys.length - 1] ?? 0;
+		keys.push(raw < 0 || raw > subdocLength ? previous : Math.max(raw, previous));
+	}
+	return keys;
+}
 function readSubdocumentStories(wordDocument, table, pieceTable, context, subdocStartCp, subdocLength, boundaryFc, boundaryLcb, what) {
 	if (subdocLength <= 0 || boundaryLcb <= 0) return [];
 	const range = readTextRange(wordDocument, pieceTable, subdocStartCp, subdocStartCp + subdocLength);
 	const entries = readParagraphs(range.text, range.fcs, context);
-	const plc = parsePlc(slice(table, boundaryFc, boundaryLcb, `${what} in the Table stream`), 0, what);
-	return splitEntriesByBoundaries(entries, plc.keys).slice(0, -1).map((story) => story.slice(0, -1));
+	const keys = readStoryPlexKeys(slice(table, boundaryFc, boundaryLcb, `${what} in the Table stream`), subdocLength, what);
+	return splitEntriesByBoundaries(entries, keys).slice(0, -1).map((story) => endsWithGuardParagraph(story) ? story.slice(0, -1) : story);
+}
+function endsWithGuardParagraph(story) {
+	const last = story[story.length - 1];
+	if (last === void 0) return false;
+	if (last.blocks.length !== 1) return false;
+	const only = last.blocks[0];
+	return only?.kind === "paragraph" && only.runs.length === 0;
 }
 /** Joins a story's own paragraphs into plain text -- one line per paragraph, matching how ooxml.js's own Footnote/Comment reading concatenates a footnote or comment body's `w:t` runs rather than preserving paragraph/run structure. A footnote, endnote, or comment in this family is carried as text alone; only a header or footer keeps real block flow (headers-footers.ts). Non-paragraph blocks a story's own entries produced (an inline picture split out of one of its paragraphs) contribute no text of their own here, the same way an image has no plain-text spelling in ooxml.js's own footnote/comment reading either. */
 function storyText(entries) {