doc-codec 1.0.2 → 1.1.1

package/dist/fib/write.d.cts

@@ -0,0 +1,21 @@
+//#region src/fib/write.d.ts
+interface FibWriteSpec {
+  readonly ccpText: number;
+  readonly cbMac: number;
+  readonly fcClx: number;
+  readonly lcbClx: number;
+  readonly fcPlcfSed: number;
+  readonly lcbPlcfSed: number;
+  readonly fcPlcfBteChpx: number;
+  readonly lcbPlcfBteChpx: number;
+  readonly fcPlcfBtePapx: number;
+  readonly lcbPlcfBtePapx: number;
+  readonly fcStshf: number;
+  readonly lcbStshf: number;
+  /** 0/0 when the document uses no font table (see write.ts). */
+  readonly fcSttbfFfn: number;
+  readonly lcbSttbfFfn: number;
+}
+declare function buildFib(spec: FibWriteSpec): Uint8Array<ArrayBuffer>;
+//#endregion
+export { FibWriteSpec, buildFib };

package/dist/fib/write.d.ts

@@ -0,0 +1,21 @@
+//#region src/fib/write.d.ts
+interface FibWriteSpec {
+  readonly ccpText: number;
+  readonly cbMac: number;
+  readonly fcClx: number;
+  readonly lcbClx: number;
+  readonly fcPlcfSed: number;
+  readonly lcbPlcfSed: number;
+  readonly fcPlcfBteChpx: number;
+  readonly lcbPlcfBteChpx: number;
+  readonly fcPlcfBtePapx: number;
+  readonly lcbPlcfBtePapx: number;
+  readonly fcStshf: number;
+  readonly lcbStshf: number;
+  /** 0/0 when the document uses no font table (see write.ts). */
+  readonly fcSttbfFfn: number;
+  readonly lcbSttbfFfn: number;
+}
+declare function buildFib(spec: FibWriteSpec): Uint8Array<ArrayBuffer>;
+//#endregion
+export { FibWriteSpec, buildFib };

package/dist/fib/write.js

@@ -0,0 +1,42 @@
+import { DocFormatError } from "../errors.js";
+import { readUint16LE } from "../bytes.js";
+import { FC_LCB_VALUE_INDEX, FIB_BASE_FLAG, FIB_W_IDENT, LW_OFFSET } from "./offsets.js";
+//#region src/fib/write.ts
+/** [MS-DOC]'s own Fib page: nFib 0x00C1 mandates cbRgFcLcb 0x005D and cswNew 0. */
+const NFIB_WORD_97 = 193;
+const CB_RG_FC_LCB_WORD_97 = 93;
+/** FibBase.nFibBack: "this value SHOULD be 0x00BF" for a document written by an application that does not need older-version compatibility beyond it -- carried verbatim from test-support/fib.ts, which cites the same field. */
+const N_FIB_BACK = 191;
+/** FibBase's own flags word at offset 10: fExtChar "MUST be 1" ([MS-DOC] 2.5.2), independent of fComplex/fWhichTblStm/fEncrypted/fObfuscated (see offsets.ts's own FIB_BASE_FLAG). */
+const FLAG_F_EXT_CHAR = 4096;
+function buildFib(spec) {
+	const bytes = /* @__PURE__ */ new Uint8Array(900);
+	const view = new DataView(bytes.buffer);
+	view.setUint16(0, FIB_W_IDENT, true);
+	view.setUint16(2, NFIB_WORD_97, true);
+	view.setUint16(10, FLAG_F_EXT_CHAR | FIB_BASE_FLAG.fWhichTblStm, true);
+	view.setUint16(12, N_FIB_BACK, true);
+	view.setUint16(32, 14, true);
+	view.setUint16(62, 22, true);
+	const lw = (offset, value) => {
+		view.setInt32(64 + offset, value, true);
+	};
+	lw(LW_OFFSET.cbMac, spec.cbMac);
+	lw(LW_OFFSET.ccpText, spec.ccpText);
+	view.setUint16(152, CB_RG_FC_LCB_WORD_97, true);
+	const pair = (index, fc, lcb) => {
+		const offset = 154 + index * 4;
+		view.setUint32(offset, fc, true);
+		view.setUint32(offset + 4, lcb, true);
+	};
+	pair(FC_LCB_VALUE_INDEX.fcStshf, spec.fcStshf, spec.lcbStshf);
+	pair(FC_LCB_VALUE_INDEX.fcPlcfBteChpx, spec.fcPlcfBteChpx, spec.lcbPlcfBteChpx);
+	pair(FC_LCB_VALUE_INDEX.fcPlcfBtePapx, spec.fcPlcfBtePapx, spec.lcbPlcfBtePapx);
+	pair(FC_LCB_VALUE_INDEX.fcSttbfFfn, spec.fcSttbfFfn, spec.lcbSttbfFfn);
+	pair(FC_LCB_VALUE_INDEX.fcClx, spec.fcClx, spec.lcbClx);
+	pair(FC_LCB_VALUE_INDEX.fcPlcfSed, spec.fcPlcfSed, spec.lcbPlcfSed);
+	if (readUint16LE(bytes, 0) !== 42476) throw new DocFormatError("buildFib produced a Fib whose own wIdent does not read back as 0xA5EC; this is an internal defect, not an input error");
+	return bytes;
+}
+//#endregion
+export { buildFib };

package/dist/fib-CtsLtF96.d.cts

@@ -0,0 +1,37 @@
+//#region src/fib/fib.d.ts
+interface Fib {
+  readonly nFib: number;
+  /** Set when the last save was an incremental ("fast") save. The piece table is what makes such a document readable at all, so this is informational rather than a refusal. */
+  readonly fComplex: boolean;
+  /** 1 selects the "1Table" stream, 0 the "0Table" stream, as the Table stream every fc offset below is relative to. */
+  readonly fWhichTblStm: 0 | 1;
+  readonly cbMac: number;
+  readonly ccpText: number;
+  readonly ccpFtn: number;
+  readonly ccpHdd: number;
+  readonly ccpAtn: number;
+  readonly ccpEdn: number;
+  readonly ccpTxbx: number;
+  readonly ccpHdrTxbx: number;
+  readonly fcStshf: number;
+  readonly lcbStshf: number;
+  readonly fcPlcfBteChpx: number;
+  readonly lcbPlcfBteChpx: number;
+  readonly fcPlcfBtePapx: number;
+  readonly lcbPlcfBtePapx: number;
+  readonly fcClx: number;
+  readonly lcbClx: number;
+  readonly fcPlcfSed: number;
+  readonly lcbPlcfSed: number;
+  readonly fcSttbfFfn: number;
+  readonly lcbSttbfFfn: number;
+  readonly fcPlfLst: number;
+  readonly lcbPlfLst: number;
+  readonly fcPlfLfo: number;
+  readonly lcbPlfLfo: number;
+}
+declare function parseFib(wordDocument: Uint8Array): Fib;
+/** The name of the compound-file stream every `fc` offset in the Fib is relative to, selected by FibBase.fWhichTblStm. */
+declare function tableStreamName(fib: Fib): "0Table" | "1Table";
+//#endregion
+export { parseFib as n, tableStreamName as r, Fib as t };

package/dist/fib-CtsLtF96.d.ts

@@ -0,0 +1,37 @@
+//#region src/fib/fib.d.ts
+interface Fib {
+  readonly nFib: number;
+  /** Set when the last save was an incremental ("fast") save. The piece table is what makes such a document readable at all, so this is informational rather than a refusal. */
+  readonly fComplex: boolean;
+  /** 1 selects the "1Table" stream, 0 the "0Table" stream, as the Table stream every fc offset below is relative to. */
+  readonly fWhichTblStm: 0 | 1;
+  readonly cbMac: number;
+  readonly ccpText: number;
+  readonly ccpFtn: number;
+  readonly ccpHdd: number;
+  readonly ccpAtn: number;
+  readonly ccpEdn: number;
+  readonly ccpTxbx: number;
+  readonly ccpHdrTxbx: number;
+  readonly fcStshf: number;
+  readonly lcbStshf: number;
+  readonly fcPlcfBteChpx: number;
+  readonly lcbPlcfBteChpx: number;
+  readonly fcPlcfBtePapx: number;
+  readonly lcbPlcfBtePapx: number;
+  readonly fcClx: number;
+  readonly lcbClx: number;
+  readonly fcPlcfSed: number;
+  readonly lcbPlcfSed: number;
+  readonly fcSttbfFfn: number;
+  readonly lcbSttbfFfn: number;
+  readonly fcPlfLst: number;
+  readonly lcbPlfLst: number;
+  readonly fcPlfLfo: number;
+  readonly lcbPlfLfo: number;
+}
+declare function parseFib(wordDocument: Uint8Array): Fib;
+/** The name of the compound-file stream every `fc` offset in the Fib is relative to, selected by FibBase.fWhichTblStm. */
+declare function tableStreamName(fib: Fib): "0Table" | "1Table";
+//#endregion
+export { parseFib as n, tableStreamName as r, Fib as t };

package/dist/index.cjs

@@ -5,15 +5,26 @@ const require_fib_offsets = require("./fib/offsets.cjs");
 const require_detect = require("./detect.cjs");
 const require_plc = require("./plc.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_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;
@@ -47,22 +58,39 @@ exports.SECTION_MARK = require_text_special.SECTION_MARK;
 exports.SGC = require_prop_sprm.SGC;
 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;
 exports.SYMBOL_ANCHOR = require_text_special.SYMBOL_ANCHOR;
 exports.WORD_DOCUMENT_STREAM = require_detect.WORD_DOCUMENT_STREAM;
 exports.applyCharacterSprms = require_prop_chp.applyCharacterSprms;
 exports.applyParagraphSprms = require_prop_pap.applyParagraphSprms;
+exports.applySectionSprms = require_prop_sep.applySectionSprms;
+exports.buildChpxPages = require_prop_fkp_write.buildChpxPages;
+exports.buildEmptyStsh = require_style_stsh.buildEmptyStsh;
+exports.buildFib = require_fib_write.buildFib;
+exports.buildFontTable = require_style_fonts.buildFontTable;
+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.buildTextClx = require_text_piece_table_write.buildTextClx;
 exports.characterOffset = require_text_piece_table.characterOffset;
 exports.characterSize = require_text_piece_table.characterSize;
 exports.decodeSprm = require_prop_sprm.decodeSprm;
+exports.encodeCharacterGrpprl = require_prop_chp_write.encodeCharacterGrpprl;
+exports.encodeParagraphGrpprl = require_prop_pap_write.encodeParagraphGrpprl;
+exports.encodeSectionGrpprl = require_prop_sep_write.encodeSectionGrpprl;
 exports.endsParagraph = require_text_special.endsParagraph;
 exports.findLargestAtMost = require_plc.findLargestAtMost;
+exports.firstFcOfPage = require_prop_fkp_write.firstFcOfPage;
 exports.headingLevelFromIstd = require_style_stsh.headingLevelFromIstd;
 exports.isAnchorOnly = require_text_special.isAnchorOnly;
 exports.isDocBytes = require_detect.isDocBytes;
+exports.layoutMetadataToSummaryInformation = require_metadata.layoutMetadataToSummaryInformation;
 exports.operandSize = require_prop_sprm.operandSize;
 exports.parseChpxFkp = require_prop_fkp.parseChpxFkp;
 exports.parseClx = require_text_piece_table.parseClx;
 exports.parseFib = require_fib_fib.parseFib;
+exports.parseFontTable = require_style_fonts.parseFontTable;
 exports.parsePapxFkp = require_prop_fkp.parsePapxFkp;
 exports.parsePlc = require_plc.parsePlc;
 exports.parseStsh = require_style_stsh.parseStsh;
@@ -71,9 +99,12 @@ exports.readDocStreams = require_read.readDocStreams;
 exports.readGrpprl = require_prop_sprm.readGrpprl;
 exports.readInt16LE = require_bytes.readInt16LE;
 exports.readInt32LE = require_bytes.readInt32LE;
+exports.readNumberingDefinitions = require_list_numbering.readNumberingDefinitions;
+exports.readSectionProperties = require_prop_sep.readSectionProperties;
 exports.readTextRange = require_text_characters.readTextRange;
 exports.readUint16LE = require_bytes.readUint16LE;
 exports.readUint32LE = require_bytes.readUint32LE;
 exports.readUint8 = require_bytes.readUint8;
 exports.slice = require_bytes.slice;
 exports.tableStreamName = require_fib_fib.tableStreamName;
+exports.writeDocContent = require_write.writeDocContent;

package/dist/index.d.cts

@@ -1,16 +1,27 @@
 import { readInt16LE, readInt32LE, readUint16LE, readUint32LE, readUint8, slice } from "./bytes.cjs";
-import { WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.cjs";
+import { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.cjs";
 import { DocFormatError, DocUnsupportedError } from "./errors.cjs";
-import { Fib, parseFib, tableStreamName } from "./fib/fib.cjs";
+import { n as parseFib, r as tableStreamName, t as Fib } from "./fib-CtsLtF96.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_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 { 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 { Prl, SGC, Sprm, decodeSprm, operandSize, readGrpprl } from "./prop/sprm.cjs";
+import { a as operandSize, i as decodeSprm, n as SGC, o as readGrpprl, r as Sprm, t as Prl } from "./sprm-Djg5RNiq.cjs";
 import { ChpxFkp, FKP_PAGE_SIZE, PapxFkp, PapxLookup, PapxRecord, PropertyBinTable, parseChpxFkp, parsePapxFkp } from "./prop/fkp.cjs";
+import { ChpxRunToWrite, PapxParagraphToWrite, buildChpxPages, buildPapxPages, buildPropertyBinTable, firstFcOfPage } from "./prop/fkp-write.cjs";
 import { CharacterProperties, applyCharacterSprms } from "./prop/chp.cjs";
-import { ParagraphProperties, applyParagraphSprms } from "./prop/pap.cjs";
-import { STI_USER_DEFINED, STK, Style, StyleSheet, headingLevelFromIstd, parseStsh } from "./style/stsh.cjs";
-import { DocStreams, readDocContent, readDocStreams } from "./read.cjs";
-export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, CharacterProperties, ChpxFkp, DRAWN_OBJECT, 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_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, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, PARAGRAPH_MARK, PapxFkp, PapxLookup, PapxRecord, ParagraphProperties, Piece, PieceTable, Plc, Prl, PropertyBinTable, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SYMBOL_ANCHOR, Sprm, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, characterOffset, characterSize, decodeSprm, endsParagraph, findLargestAtMost, headingLevelFromIstd, isAnchorOnly, isDocBytes, operandSize, parseChpxFkp, parseClx, parseFib, parsePapxFkp, parsePlc, parseStsh, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readTextRange, readUint16LE, readUint32LE, readUint8, slice, tableStreamName };
+import { encodeCharacterGrpprl } from "./prop/chp-write.cjs";
+import { n as applyParagraphSprms, t as ParagraphProperties } from "./pap-BmelEYEP.cjs";
+import { encodeParagraphGrpprl } from "./prop/pap-write.cjs";
+import { SectionProperties, applySectionSprms, readSectionProperties } from "./prop/sep.cjs";
+import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.cjs";
+import { STI_USER_DEFINED, STK, Style, StyleSheet, buildEmptyStsh, headingLevelFromIstd, parseStsh } from "./style/stsh.cjs";
+import { buildFontTable, parseFontTable } from "./style/fonts.cjs";
+import { i as readNumberingDefinitions, n as NumberingDefinitions, r as NumberingLevel, t as NumberingDefinition } from "./numbering-Cir-uGdc.cjs";
+import { DocContent, DocStreams, ParagraphEntry, readDocContent, readDocStreams } from "./read.cjs";
+import { 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_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, NumberingDefinition, NumberingDefinitions, NumberingLevel, PARAGRAPH_MARK, PapxFkp, PapxLookup, PapxParagraphToWrite, PapxRecord, ParagraphEntry, ParagraphProperties, Piece, PieceTable, Plc, Prl, PropertyBinTable, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, SectionProperties, Sprm, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildEmptyStsh, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildTextClx, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readNumberingDefinitions, readSectionProperties, readTextRange, readUint16LE, readUint32LE, readUint8, slice, tableStreamName, writeDocContent };

package/dist/index.d.ts

@@ -1,16 +1,27 @@
 import { readInt16LE, readInt32LE, readUint16LE, readUint32LE, readUint8, slice } from "./bytes.js";
-import { WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.js";
+import { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.js";
 import { DocFormatError, DocUnsupportedError } from "./errors.js";
-import { Fib, parseFib, tableStreamName } from "./fib/fib.js";
+import { n as parseFib, r as tableStreamName, t as Fib } from "./fib-CtsLtF96.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_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 { 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 { Prl, SGC, Sprm, decodeSprm, operandSize, readGrpprl } from "./prop/sprm.js";
+import { a as operandSize, i as decodeSprm, n as SGC, o as readGrpprl, r as Sprm, t as Prl } from "./sprm-Djg5RNiq.js";
 import { ChpxFkp, FKP_PAGE_SIZE, PapxFkp, PapxLookup, PapxRecord, PropertyBinTable, parseChpxFkp, parsePapxFkp } from "./prop/fkp.js";
+import { ChpxRunToWrite, PapxParagraphToWrite, buildChpxPages, buildPapxPages, buildPropertyBinTable, firstFcOfPage } from "./prop/fkp-write.js";
 import { CharacterProperties, applyCharacterSprms } from "./prop/chp.js";
-import { ParagraphProperties, applyParagraphSprms } from "./prop/pap.js";
-import { STI_USER_DEFINED, STK, Style, StyleSheet, headingLevelFromIstd, parseStsh } from "./style/stsh.js";
-import { DocStreams, readDocContent, readDocStreams } from "./read.js";
-export { ANNOTATION_REFERENCE, CELL_MARK, COMPRESSED_CHARACTER_MAP, CharacterProperties, ChpxFkp, DRAWN_OBJECT, 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_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, INLINE_PICTURE, LINE_BREAK, LW_OFFSET, PARAGRAPH_MARK, PapxFkp, PapxLookup, PapxRecord, ParagraphProperties, Piece, PieceTable, Plc, Prl, PropertyBinTable, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SYMBOL_ANCHOR, Sprm, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, characterOffset, characterSize, decodeSprm, endsParagraph, findLargestAtMost, headingLevelFromIstd, isAnchorOnly, isDocBytes, operandSize, parseChpxFkp, parseClx, parseFib, parsePapxFkp, parsePlc, parseStsh, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readTextRange, readUint16LE, readUint32LE, readUint8, slice, tableStreamName };
+import { encodeCharacterGrpprl } from "./prop/chp-write.js";
+import { n as applyParagraphSprms, t as ParagraphProperties } from "./pap-BkFo8dZO.js";
+import { encodeParagraphGrpprl } from "./prop/pap-write.js";
+import { SectionProperties, applySectionSprms, readSectionProperties } from "./prop/sep.js";
+import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.js";
+import { STI_USER_DEFINED, STK, Style, StyleSheet, buildEmptyStsh, headingLevelFromIstd, parseStsh } from "./style/stsh.js";
+import { buildFontTable, parseFontTable } from "./style/fonts.js";
+import { i as readNumberingDefinitions, n as NumberingDefinitions, r as NumberingLevel, t as NumberingDefinition } from "./numbering-DF1z1PyG.js";
+import { DocContent, DocStreams, ParagraphEntry, readDocContent, readDocStreams } from "./read.js";
+import { 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_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, NumberingDefinition, NumberingDefinitions, NumberingLevel, PARAGRAPH_MARK, PapxFkp, PapxLookup, PapxParagraphToWrite, PapxRecord, ParagraphEntry, ParagraphProperties, Piece, PieceTable, Plc, Prl, PropertyBinTable, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, SectionProperties, Sprm, Style, StyleSheet, TextRange, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildEmptyStsh, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildTextClx, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readNumberingDefinitions, readSectionProperties, readTextRange, readUint16LE, readUint32LE, readUint8, slice, tableStreamName, writeDocContent };

package/dist/index.js

@@ -1,16 +1,27 @@
 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_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 { WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.js";
+import { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes } from "./detect.js";
 import { findLargestAtMost, parsePlc } from "./plc.js";
 import { parseFib, 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 } from "./prop/fkp-write.js";
 import { applyCharacterSprms } from "./prop/chp.js";
+import { encodeCharacterGrpprl } from "./prop/chp-write.js";
 import { applyParagraphSprms } from "./prop/pap.js";
-import { STI_USER_DEFINED, STK, headingLevelFromIstd, parseStsh } from "./style/stsh.js";
+import { encodeParagraphGrpprl } from "./prop/pap-write.js";
+import { applySectionSprms, readSectionProperties } from "./prop/sep.js";
+import { buildPlcfSed, buildSepx, encodeSectionGrpprl } from "./prop/sep-write.js";
+import { STI_USER_DEFINED, STK, buildEmptyStsh, headingLevelFromIstd, parseStsh } from "./style/stsh.js";
+import { buildFontTable, parseFontTable } from "./style/fonts.js";
+import { readNumberingDefinitions } from "./list/numbering.js";
 import { readDocContent, readDocStreams } from "./read.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_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, PARAGRAPH_MARK, PropertyBinTable, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SYMBOL_ANCHOR, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, characterOffset, characterSize, decodeSprm, endsParagraph, findLargestAtMost, headingLevelFromIstd, isAnchorOnly, isDocBytes, operandSize, parseChpxFkp, parseClx, parseFib, parsePapxFkp, parsePlc, parseStsh, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readTextRange, readUint16LE, readUint32LE, readUint8, slice, tableStreamName };
+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_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, PARAGRAPH_MARK, PropertyBinTable, SECTION_MARK, SGC, STI_USER_DEFINED, STK, SUMMARY_INFORMATION_STREAM, SYMBOL_ANCHOR, WORD_DOCUMENT_STREAM, applyCharacterSprms, applyParagraphSprms, applySectionSprms, buildChpxPages, buildEmptyStsh, buildFib, buildFontTable, buildPapxPages, buildPlcfSed, buildPropertyBinTable, buildSepx, buildTextClx, characterOffset, characterSize, decodeSprm, encodeCharacterGrpprl, encodeParagraphGrpprl, encodeSectionGrpprl, endsParagraph, findLargestAtMost, firstFcOfPage, headingLevelFromIstd, isAnchorOnly, isDocBytes, layoutMetadataToSummaryInformation, operandSize, parseChpxFkp, parseClx, parseFib, parseFontTable, parsePapxFkp, parsePlc, parseStsh, readDocContent, readDocStreams, readGrpprl, readInt16LE, readInt32LE, readNumberingDefinitions, readSectionProperties, readTextRange, readUint16LE, readUint32LE, readUint8, slice, tableStreamName, writeDocContent };

package/dist/list/numbering.cjs

@@ -0,0 +1,206 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+const require_bytes = require("../bytes.cjs");
+//#region src/list/numbering.ts
+const LSTF_SIZE = 28;
+const LVLF_SIZE = 28;
+const LFO_SIZE = 16;
+/** LSTF's own flags byte ([MS-DOC] 2.9.191), bit 0: "this LSTF represents a simple (one-level) list that has one corresponding LVL. Otherwise... a multi-level list that has nine corresponding LVLs." */
+const LSTF_FLAG_SIMPLE_LIST = 1;
+/** 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. */
+const NUMBER_FORMAT_BY_NFC = {
+	0: "decimal",
+	1: "upperRoman",
+	2: "lowerRoman",
+	3: "upperLetter",
+	4: "lowerLetter",
+	5: "ordinal",
+	6: "cardinalText",
+	7: "ordinalText",
+	8: "hex",
+	9: "chicago",
+	10: "ideographDigital",
+	11: "japaneseCounting",
+	12: "Aiueo",
+	13: "Iroha",
+	14: "decimalFullWidth",
+	15: "decimalHalfWidth",
+	16: "japaneseLegal",
+	17: "japaneseDigitalTenThousand",
+	18: "decimalEnclosedCircle",
+	19: "decimalFullWidth2",
+	20: "aiueoFullWidth",
+	21: "irohaFullWidth",
+	22: "decimalZero",
+	23: "bullet",
+	24: "ganada",
+	25: "chosung",
+	26: "decimalEnclosedFullstop",
+	27: "decimalEnclosedParen",
+	28: "decimalEnclosedCircleChinese",
+	29: "ideographEnclosedCircle",
+	30: "ideographTraditional",
+	31: "ideographZodiac",
+	32: "ideographZodiacTraditional",
+	33: "taiwaneseCounting",
+	34: "ideographLegalTraditional",
+	35: "taiwaneseCountingThousand",
+	36: "taiwaneseDigital",
+	37: "chineseCounting",
+	38: "chineseLegalSimplified",
+	39: "chineseCountingThousand",
+	40: "decimal",
+	41: "koreanDigital",
+	42: "koreanCounting",
+	43: "koreanLegal",
+	44: "koreanDigital2",
+	45: "hebrew1",
+	46: "arabicAlpha",
+	47: "hebrew2",
+	48: "arabicAbjad",
+	49: "hindiVowels",
+	50: "hindiConsonants",
+	51: "hindiNumbers",
+	52: "hindiCounting",
+	53: "thaiLetters",
+	54: "thaiNumbers",
+	55: "thaiCounting",
+	56: "vietnameseCounting",
+	57: "numberInDash",
+	58: "russianLower",
+	59: "russianUpper"
+};
+/** MSONFC's own "Specifies that the sequence will not display any numbering" sentinel -- not itself an ST_NumberFormat value, so this reader's own spelling for it ("none") is a deliberate literal rather than a value MSONFC's table states. */
+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;
+}
+/** LSTF ([MS-DOC] 2.9.191): 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) {
+	return {
+		lsid: require_bytes.readInt32LE(bytes, offset),
+		fSimpleList: (require_bytes.readUint8(bytes, offset + 26) & LSTF_FLAG_SIMPLE_LIST) !== 0
+	};
+}
+/** Xst ([MS-DOC] 2.9.343): cch(2 bytes) then that many raw 16-bit code units, prefixed-length and not null-terminated. Decoded as a plain UTF-16 string -- readLevelText below re-inspects specific character positions afterward for placeholders, which round-trips exactly through String.fromCharCode/charCodeAt since every placeholder value (0-8) sits well within one UTF-16 code unit and never needs a surrogate pair. Returns the decoded text and the byte length consumed, since the caller must advance past it to reach grpprlPapx/grpprlChpx or the next LVL. */
+function readXst(bytes, offset) {
+	const cch = require_bytes.readUint16LE(bytes, offset);
+	let text = "";
+	for (let index = 0; index < cch; index += 1) text += String.fromCharCode(require_bytes.readUint16LE(bytes, offset + 2 + index * 2));
+	return {
+		text,
+		byteLength: 2 + cch * 2
+	};
+}
+/** rgbxchNums ([MS-DOC] 2.9.148's own LVLF field): nine 8-bit one-based character offsets into the LVL's own xst.rgtchar, zero-terminated (a 0 entry, or the end of the fixed 9-byte array, ends the list). Each offset it names is a POSITION in the string, not a value -- readLevelText is what turns a position into the placeholder it names. */
+function readRgbxchNums(bytes, offset) {
+	const positions = [];
+	for (let index = 0; index < 9; index += 1) {
+		const value = require_bytes.readUint8(bytes, offset + index);
+		if (value === 0) break;
+		positions.push(value);
+	}
+	return positions;
+}
+/** Turns an Xst's own decoded text plus its rgbxchNums positions into the '%1.'-style placeholder text NumberingLevel.text states -- the mirror of readXst/readRgbxchNums together. [MS-DOC]'s own Xst field text: "Each placeholder is an unsigned 2-byte integer that specifies the zero-based level that the placeholder is for" -- so the character AT a named position is not a literal code point at all, but a raw level index (0-8) String.fromCharCode/charCodeAt round-trips losslessly; every other position is decoded as ordinary text. A one-based placeholder ('%1' for level 0) matches ooxml.js's own w:lvlText convention, so a consumer already resolving '%1.'/'%2)' style docx templates resolves this reader's templates identically. */
+function readLevelText(xstText, placeholderPositions) {
+	const placeholders = new Set(placeholderPositions);
+	let result = "";
+	for (let index = 0; index < xstText.length; index += 1) {
+		const oneBasedPosition = index + 1;
+		if (placeholders.has(oneBasedPosition)) {
+			const levelIndex = xstText.charCodeAt(index);
+			result += `%${levelIndex + 1}`;
+		} else result += xstText.charAt(index);
+	}
+	return result;
+}
+/** LVL ([MS-DOC] 2.9.196): a 28-byte LVLF, then grpprlPapx (cbGrpprlPapx bytes, skipped -- see this module's own top comment), grpprlChpx (cbGrpprlChpx bytes, skipped), then the level's own Xst. Every LVL is variable-length, so the caller must use byteLength to advance to the next one in the array -- there is no outer length field to skip by instead. */
+function readLvl(bytes, offset) {
+	if (offset + LVLF_SIZE > bytes.length) throw new require_errors.DocFormatError(`PlfLst's own appended LVL array runs past the end of its ${bytes.length}-byte buffer at offset ${offset}, ${LVLF_SIZE} bytes short of one LVLF`);
+	const iStartAt = require_bytes.readInt32LE(bytes, offset);
+	const nfc = require_bytes.readUint8(bytes, offset + 4);
+	const fNoRestart = (require_bytes.readUint8(bytes, offset + 5) & 2) !== 0;
+	const rgbxchNums = readRgbxchNums(bytes, offset + 6);
+	const cbGrpprlChpx = require_bytes.readUint8(bytes, offset + 24);
+	const cbGrpprlPapx = require_bytes.readUint8(bytes, offset + 25);
+	const ilvlRestartLim = require_bytes.readUint8(bytes, offset + 26);
+	const { text: xstText, byteLength: xstByteLength } = readXst(bytes, offset + LVLF_SIZE + cbGrpprlPapx + cbGrpprlChpx);
+	const level = {
+		format: numberFormatFor(nfc),
+		text: readLevelText(xstText, rgbxchNums),
+		startAt: iStartAt
+	};
+	return {
+		level: fNoRestart ? {
+			...level,
+			restart: ilvlRestartLim
+		} : level,
+		byteLength: LVLF_SIZE + cbGrpprlPapx + cbGrpprlChpx + xstByteLength
+	};
+}
+/** PlfLst ([MS-DOC] 2.9.226): cLst(2 bytes, signed) then that many 28-byte LSTF entries -- followed IMMEDIATELY by the appended LVL array FibRgFcLcb97's own fcPlfLst field describes, which lcbPlfLst does not account for and which this function therefore reads past the declared PlfLst length to reach. */
+function parsePlfLst(table, fc, lcb) {
+	const plfLst = require_bytes.slice(table, fc, lcb, "PlfLst");
+	const cLst = require_bytes.readInt16LE(plfLst, 0);
+	if (cLst < 0) throw new require_errors.DocFormatError(`PlfLst.cLst is ${cLst}, a negative LSTF count [MS-DOC] 2.9.226 never permits`);
+	const lstfs = [];
+	for (let index = 0; index < cLst; index += 1) lstfs.push(readLstf(plfLst, 2 + index * LSTF_SIZE));
+	let cursor = fc + lcb;
+	const levelsByLstf = [];
+	for (const lstf of lstfs) {
+		const count = lstf.fSimpleList ? 1 : 9;
+		const levels = [];
+		for (let index = 0; index < count; index += 1) {
+			const { level, byteLength } = readLvl(table, cursor);
+			levels.push(level);
+			cursor += byteLength;
+		}
+		levelsByLstf.push(levels);
+	}
+	return {
+		lstfs,
+		levelsByLstf
+	};
+}
+/** PlfLfo ([MS-DOC] 2.9.225): lfoMac(4 bytes) then that many 16-byte LFO entries (rgLfo), then rgLfoData -- this reader's own scope stops at rgLfo, since resolving ilfo to a list needs only each LFO's own lsid (rgLfoData carries LFOLVL overrides this reader deliberately does not apply; see this module's own top comment). rgLfo sits entirely before rgLfoData in the stream, so not reading rgLfoData at all is a real, not merely partial, saving -- no cursor needs to walk past it. */
+function parseLfoLsids(table, fc, lcb) {
+	const plfLfo = require_bytes.slice(table, fc, lcb, "PlfLfo");
+	const lfoMac = require_bytes.readInt32LE(plfLfo, 0);
+	if (lfoMac < 0) throw new require_errors.DocFormatError(`PlfLfo.lfoMac is ${lfoMac}, a negative LFO count [MS-DOC] 2.9.225 never permits`);
+	const lsids = [];
+	for (let index = 0; index < lfoMac; index += 1) {
+		const offset = 4 + index * LFO_SIZE;
+		if (offset + LFO_SIZE > plfLfo.length) throw new require_errors.DocFormatError(`PlfLfo declares lfoMac=${lfoMac} LFO entries, but its own ${plfLfo.length}-byte buffer has room for only ${Math.floor((plfLfo.length - 4) / LFO_SIZE)}`);
+		lsids.push(require_bytes.readInt32LE(plfLfo, offset));
+	}
+	return lsids;
+}
+/** 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). */
+function readNumberingDefinitions(table, fib) {
+	if (fib.lcbPlfLst === 0 || fib.lcbPlfLfo === 0) return {};
+	const { lstfs, levelsByLstf } = parsePlfLst(table, fib.fcPlfLst, fib.lcbPlfLst);
+	const lsids = parseLfoLsids(table, fib.fcPlfLfo, fib.lcbPlfLfo);
+	const levelsByLsid = /* @__PURE__ */ new Map();
+	lstfs.forEach((lstf, index) => {
+		const levels = levelsByLstf[index];
+		if (levels !== void 0) levelsByLsid.set(lstf.lsid, levels);
+	});
+	const definitions = {};
+	lsids.forEach((lsid, index) => {
+		const levels = levelsByLsid.get(lsid);
+		if (levels === void 0) return;
+		const ilfo = index + 1;
+		const byLevel = {};
+		levels.forEach((level, levelIndex) => {
+			byLevel[String(levelIndex)] = level;
+		});
+		definitions[String(ilfo)] = { levels: byLevel };
+	});
+	return definitions;
+}
+//#endregion
+exports.readNumberingDefinitions = readNumberingDefinitions;

package/dist/list/numbering.d.cts

@@ -0,0 +1,2 @@
+import { i as readNumberingDefinitions, n as NumberingDefinitions, r as NumberingLevel, t as NumberingDefinition } from "../numbering-Cir-uGdc.cjs";
+export { NumberingDefinition, NumberingDefinitions, NumberingLevel, readNumberingDefinitions };

package/dist/list/numbering.d.ts

@@ -0,0 +1,2 @@
+import { i as readNumberingDefinitions, n as NumberingDefinitions, r as NumberingLevel, t as NumberingDefinition } from "../numbering-DF1z1PyG.js";
+export { NumberingDefinition, NumberingDefinitions, NumberingLevel, readNumberingDefinitions };