doc-codec 2.1.1 → 2.2.1

package/dist/list/numbering-write.js

@@ -0,0 +1,163 @@
+import { DocFormatError } from "../errors.js";
+import { NUMBER_FORMAT_BY_NFC } from "./numbering.js";
+//#region src/list/numbering-write.ts
+const LSTF_SIZE = 28;
+const LVLF_SIZE = 28;
+const LFO_SIZE = 16;
+const LSTF_FLAG_SIMPLE_LIST = 1;
+/** The LVLF flags-byte bit numbering.ts's own reader treats as fNoRestart -- restated here for the reason pap-write.ts's own top comment gives for restating pap.ts's opcodes: this module's own byte layout is coupled to the specification's field table, not to a sibling module's private constant name. */
+const LVLF_FLAG_NO_RESTART = 2;
+/** A non-simple LSTF always carries exactly nine LVLs ([MS-DOC] 2.9.191); sprmPIlvl's own operand range this writer's caller (pap-write.ts) validates against is the same fact restated at the paragraph-property layer. */
+const MAX_LIST_LEVEL = 8;
+const LEVELS_PER_MULTI_LEVEL_LIST = 9;
+/** The format every level this writer invents for a paragraph that leaves ContentListMembership.format unstated, and every level a multi-level list's own dense 0..8 run needs filling but no paragraph ever actually used -- an arbitrary but harmless choice, since an unused level's own appearance is never read back into a context that renders it. */
+const DEFAULT_FORMAT = "decimal";
+/** The glyph this writer states for format 'bullet'. A real Word-format producer typically uses a Private Use Area code point from a symbol font (the README's own "Numbering definitions" section records LibreOffice writing U+F0B7) -- this writer uses the plain, portable Unicode bullet instead, since this is a synthesised definition rather than a captured one, and it round-trips exactly through this package's own reader either way. */
+const BULLET_GLYPH = "•";
+/** The inverse of numbering.ts's own NUMBER_FORMAT_BY_NFC, restricted to whichever of its entries a format string can actually reach -- built once by inverting the single source of truth rather than hand-maintaining a second table that could silently drift from it. Where two nfc values map to the same format string (0x00 and 0x28 both mean "decimal"), the lower one wins, because Object.entries on an object whose own keys are non-negative integer strings iterates in ascending numeric order regardless of insertion order (the one case JavaScript's own key-ordering rules give a numeric guarantee), so the first entry visited for "decimal" is 0x00. */
+const NFC_BY_FORMAT = (() => {
+	const byFormat = /* @__PURE__ */ new Map();
+	for (const [nfcKey, format] of Object.entries(NUMBER_FORMAT_BY_NFC)) if (!byFormat.has(format)) byFormat.set(format, Number(nfcKey));
+	return byFormat;
+})();
+function push16(bytes, value) {
+	bytes.push(value & 255, value >> 8 & 255);
+}
+function push32(bytes, value) {
+	const unsigned = value >>> 0;
+	bytes.push(unsigned & 255, unsigned >> 8 & 255, unsigned >> 16 & 255, unsigned >>> 24 & 255);
+}
+function writeUint32LE(target, offset, value) {
+	const unsigned = value >>> 0;
+	target[offset] = unsigned & 255;
+	target[offset + 1] = unsigned >> 8 & 255;
+	target[offset + 2] = unsigned >> 16 & 255;
+	target[offset + 3] = unsigned >>> 24 & 255;
+}
+function encodeXst(text) {
+	const bytes = [];
+	push16(bytes, text.length);
+	for (let index = 0; index < text.length; index += 1) push16(bytes, text.charCodeAt(index));
+	return bytes;
+}
+/** The exact inverse of numbering.ts's own readLevelText: for a numbered format, a single placeholder for the level's own zero-based index (encoded as a raw code unit, per Xst's own placeholder convention) followed by a literal '.', reproducing readLevelText's '%1.'-style output ('%N' where N = level+1) on a subsequent read; for 'bullet', the literal glyph with no placeholder at all. */
+function buildLevelXst(level, format) {
+	if (format === "bullet") return {
+		xstText: BULLET_GLYPH,
+		positions: []
+	};
+	return {
+		xstText: `${String.fromCharCode(level)}.`,
+		positions: [1]
+	};
+}
+function levelText(level, format) {
+	return format === "bullet" ? BULLET_GLYPH : `%${level + 1}.`;
+}
+function defaultLevel(level, format) {
+	return {
+		format,
+		text: levelText(level, format),
+		startAt: 1
+	};
+}
+function gatherListUsage(memberships) {
+	const ilfoByNumId = /* @__PURE__ */ new Map();
+	const usedLevelsByIlfo = /* @__PURE__ */ new Map();
+	for (const membership of memberships) {
+		if (membership?.numId === void 0) continue;
+		if (membership.level > MAX_LIST_LEVEL) throw new DocFormatError(`paragraph list numId ${JSON.stringify(membership.numId)} names level ${membership.level}, outside the 0..${MAX_LIST_LEVEL} range a non-simple LSTF's fixed nine LVLs ([MS-DOC] 2.9.191) can address`);
+		let ilfo = ilfoByNumId.get(membership.numId);
+		if (ilfo === void 0) {
+			ilfo = ilfoByNumId.size + 1;
+			ilfoByNumId.set(membership.numId, ilfo);
+			usedLevelsByIlfo.set(ilfo, /* @__PURE__ */ new Map());
+		}
+		const used = usedLevelsByIlfo.get(ilfo);
+		if (used === void 0) throw new DocFormatError("internal defect: gatherListUsage minted an ilfo with no levels map of its own");
+		if (!used.has(membership.level)) used.set(membership.level, defaultLevel(membership.level, membership.format ?? DEFAULT_FORMAT));
+	}
+	const definitions = {};
+	for (const [ilfo, used] of usedLevelsByIlfo) {
+		const levelCount = Math.max(...used.keys()) === 0 ? 1 : LEVELS_PER_MULTI_LEVEL_LIST;
+		const levels = {};
+		for (let level = 0; level < levelCount; level += 1) levels[String(level)] = used.get(level) ?? defaultLevel(level, DEFAULT_FORMAT);
+		definitions[String(ilfo)] = { levels };
+	}
+	return {
+		definitions,
+		ilfoByNumId
+	};
+}
+function buildLstfBytes(lsid, fSimpleList) {
+	const lstf = new Array(LSTF_SIZE).fill(0);
+	writeUint32LE(lstf, 0, lsid);
+	lstf[26] = fSimpleList ? LSTF_FLAG_SIMPLE_LIST : 0;
+	return lstf;
+}
+function buildLvlBytes(level, numberingLevel) {
+	const nfc = NFC_BY_FORMAT.get(numberingLevel.format);
+	if (nfc === void 0) throw new DocFormatError(`numbering level format ${JSON.stringify(numberingLevel.format)} has no [MS-OSHARED] 2.2.1.3 MSONFC mapping this writer can state -- only ${JSON.stringify([...NFC_BY_FORMAT.keys()])} round-trip through ContentListMembership.format`);
+	const { xstText, positions } = buildLevelXst(level, numberingLevel.format);
+	const lvlf = new Array(LVLF_SIZE).fill(0);
+	writeUint32LE(lvlf, 0, numberingLevel.startAt);
+	lvlf[4] = nfc;
+	if (numberingLevel.restart !== void 0) {
+		lvlf[5] = LVLF_FLAG_NO_RESTART;
+		lvlf[26] = numberingLevel.restart;
+	}
+	positions.forEach((position, index) => {
+		lvlf[6 + index] = position;
+	});
+	return [...lvlf, ...encodeXst(xstText)];
+}
+/** Encodes a NumberingDefinitions into real PlfLst/PlfLfo bytes -- undefined when it names no lists at all, so writeDocContent can skip both fc/lcb pairs entirely rather than writing an empty-but-present structure no paragraph ever references. Independent of gatherListUsage: any NumberingDefinitions this package's own numbering.ts could produce from a real .doc encodes here too, including a startAt other than 1 or a restart rule, since every LVLF field this function writes comes from the definition's own NumberingLevel rather than an assumed default. */
+function buildNumberingTables(definitions) {
+	const keys = Object.keys(definitions);
+	const keyByIlfo = /* @__PURE__ */ new Map();
+	for (const key of keys) {
+		const ilfo = Number(key);
+		const collidingKey = keyByIlfo.get(ilfo);
+		if (collidingKey !== void 0) throw new DocFormatError(`numbering definition keys ${JSON.stringify(collidingKey)} and ${JSON.stringify(key)} both name lsid ${ilfo} once converted to a number -- [MS-DOC] 2.9.147 requires lsid to be unique for each LSTF`);
+		keyByIlfo.set(ilfo, key);
+	}
+	const ilfos = [...keyByIlfo.keys()].sort((a, b) => a - b);
+	if (ilfos.length === 0) return void 0;
+	const lstfBytes = [];
+	const lvlBytes = [];
+	const rgLfoBytes = [];
+	for (const ilfo of ilfos) {
+		const definition = definitions[String(ilfo)];
+		if (definition === void 0) throw new DocFormatError("internal defect: buildNumberingTables lost a definition for an ilfo its own key list just named");
+		const levelKeys = Object.keys(definition.levels).map(Number).sort((a, b) => a - b);
+		const fSimpleList = levelKeys.length === 1 && levelKeys[0] === 0;
+		const isDenseMultiLevel = levelKeys.length === LEVELS_PER_MULTI_LEVEL_LIST && levelKeys.every((level, index) => level === index);
+		if (!fSimpleList && !isDenseMultiLevel) throw new DocFormatError(`numbering definition for ilfo ${ilfo} names levels ${JSON.stringify(levelKeys)}, but [MS-DOC] 2.9.191's own LSTF states either exactly level 0 alone (a simple list) or a dense 0..${MAX_LIST_LEVEL} run of all nine -- there is no partial shape to write`);
+		lstfBytes.push(...buildLstfBytes(ilfo, fSimpleList));
+		for (const level of levelKeys) {
+			const numberingLevel = definition.levels[String(level)];
+			if (numberingLevel === void 0) throw new DocFormatError("internal defect: buildNumberingTables lost a level its own key list just named");
+			lvlBytes.push(...buildLvlBytes(level, numberingLevel));
+		}
+		const lfo = new Array(LFO_SIZE).fill(0);
+		writeUint32LE(lfo, 0, ilfo);
+		rgLfoBytes.push(...lfo);
+	}
+	const plfLstHeader = [];
+	push16(plfLstHeader, ilfos.length);
+	const plfLst = new Uint8Array([
+		...plfLstHeader,
+		...lstfBytes,
+		...lvlBytes
+	]);
+	const plfLfoHeader = [];
+	push32(plfLfoHeader, ilfos.length);
+	const plfLfo = new Uint8Array([...plfLfoHeader, ...rgLfoBytes]);
+	return {
+		plfLst,
+		lcbPlfLst: plfLstHeader.length + lstfBytes.length,
+		plfLfo
+	};
+}
+//#endregion
+export { buildNumberingTables, gatherListUsage };

package/dist/list/numbering.cjs

@@ -5,7 +5,7 @@ const require_bytes = require("../bytes.cjs");
 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." */
+/** LSTF's own flags byte ([MS-DOC] 2.9.147), 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 = {
@@ -78,14 +78,14 @@ function numberFormatFor(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. */
+/** 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) {
 	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. */
+/** Xst ([MS-DOC] 2.9.353): 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 = "";
@@ -95,7 +95,7 @@ function readXst(bytes, offset) {
 		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. */
+/** rgbxchNums ([MS-DOC] 2.9.150'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) {
@@ -105,7 +105,7 @@ function readRgbxchNums(bytes, offset) {
 	}
 	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. */
+/** 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] 2.9.149's own LVL field text (not Xst's -- Xst is a generic length-prefixed string used all over the format for unrelated fields too): "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 = "";
@@ -118,7 +118,7 @@ function readLevelText(xstText, placeholderPositions) {
 	}
 	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. */
+/** LVL ([MS-DOC] 2.9.149): 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);
@@ -142,11 +142,11 @@ function readLvl(bytes, offset) {
 		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. */
+/** PlfLst ([MS-DOC] 2.9.201): 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`);
+	if (cLst < 0) throw new require_errors.DocFormatError(`PlfLst.cLst is ${cLst}, a negative LSTF count [MS-DOC] 2.9.201 never permits`);
 	const lstfs = [];
 	for (let index = 0; index < cLst; index += 1) lstfs.push(readLstf(plfLst, 2 + index * LSTF_SIZE));
 	let cursor = fc + lcb;
@@ -166,11 +166,11 @@ function parsePlfLst(table, fc, lcb) {
 		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. */
+/** PlfLfo ([MS-DOC] 2.9.200): 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`);
+	if (lfoMac < 0) throw new require_errors.DocFormatError(`PlfLfo.lfoMac is ${lfoMac}, a negative LFO count [MS-DOC] 2.9.200 never permits`);
 	const lsids = [];
 	for (let index = 0; index < lfoMac; index += 1) {
 		const offset = 4 + index * LFO_SIZE;
@@ -203,4 +203,5 @@ function readNumberingDefinitions(table, fib) {
 	return definitions;
 }
 //#endregion
+exports.NUMBER_FORMAT_BY_NFC = NUMBER_FORMAT_BY_NFC;
 exports.readNumberingDefinitions = readNumberingDefinitions;

package/dist/list/numbering.d.cts

@@ -1,2 +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 };
+import { a as readNumberingDefinitions, i as NumberingLevel, n as NumberingDefinition, r as NumberingDefinitions, t as NUMBER_FORMAT_BY_NFC } from "../numbering-Bivayss4.cjs";
+export { NUMBER_FORMAT_BY_NFC, NumberingDefinition, NumberingDefinitions, NumberingLevel, readNumberingDefinitions };

package/dist/list/numbering.d.ts

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

package/dist/list/numbering.js

@@ -4,7 +4,7 @@ import { readInt16LE, readInt32LE, readUint16LE, readUint8, slice } from "../byt
 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." */
+/** LSTF's own flags byte ([MS-DOC] 2.9.147), 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 = {
@@ -77,14 +77,14 @@ function numberFormatFor(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;
 }
-/** 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. */
+/** 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) {
 	return {
 		lsid: readInt32LE(bytes, offset),
 		fSimpleList: (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. */
+/** Xst ([MS-DOC] 2.9.353): 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 = readUint16LE(bytes, offset);
 	let text = "";
@@ -94,7 +94,7 @@ function readXst(bytes, offset) {
 		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. */
+/** rgbxchNums ([MS-DOC] 2.9.150'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) {
@@ -104,7 +104,7 @@ function readRgbxchNums(bytes, offset) {
 	}
 	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. */
+/** 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] 2.9.149's own LVL field text (not Xst's -- Xst is a generic length-prefixed string used all over the format for unrelated fields too): "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 = "";
@@ -117,7 +117,7 @@ function readLevelText(xstText, placeholderPositions) {
 	}
 	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. */
+/** LVL ([MS-DOC] 2.9.149): 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 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 = readInt32LE(bytes, offset);
@@ -141,11 +141,11 @@ function readLvl(bytes, offset) {
 		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. */
+/** PlfLst ([MS-DOC] 2.9.201): 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 = slice(table, fc, lcb, "PlfLst");
 	const cLst = readInt16LE(plfLst, 0);
-	if (cLst < 0) throw new DocFormatError(`PlfLst.cLst is ${cLst}, a negative LSTF count [MS-DOC] 2.9.226 never permits`);
+	if (cLst < 0) throw new DocFormatError(`PlfLst.cLst is ${cLst}, a negative LSTF count [MS-DOC] 2.9.201 never permits`);
 	const lstfs = [];
 	for (let index = 0; index < cLst; index += 1) lstfs.push(readLstf(plfLst, 2 + index * LSTF_SIZE));
 	let cursor = fc + lcb;
@@ -165,11 +165,11 @@ function parsePlfLst(table, fc, lcb) {
 		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. */
+/** PlfLfo ([MS-DOC] 2.9.200): 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 = slice(table, fc, lcb, "PlfLfo");
 	const lfoMac = readInt32LE(plfLfo, 0);
-	if (lfoMac < 0) throw new DocFormatError(`PlfLfo.lfoMac is ${lfoMac}, a negative LFO count [MS-DOC] 2.9.225 never permits`);
+	if (lfoMac < 0) throw new DocFormatError(`PlfLfo.lfoMac is ${lfoMac}, a negative LFO count [MS-DOC] 2.9.200 never permits`);
 	const lsids = [];
 	for (let index = 0; index < lfoMac; index += 1) {
 		const offset = 4 + index * LFO_SIZE;
@@ -202,4 +202,4 @@ function readNumberingDefinitions(table, fib) {
 	return definitions;
 }
 //#endregion
-export { readNumberingDefinitions };
+export { NUMBER_FORMAT_BY_NFC, readNumberingDefinitions };

package/dist/{numbering-Cir-uGdc.d.cts → numbering-Bivayss4.d.cts}

@@ -1,13 +1,15 @@
 import { t as Fib } from "./fib-CtsLtF96.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.148's own nfc field text: "If this is equal to 0xFF..., this level does not have a number sequence"). */
+  /** 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.148), 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". */
+  /** 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 {
@@ -19,4 +21,4 @@ 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 { readNumberingDefinitions as i, NumberingDefinitions as n, NumberingLevel as r, NumberingDefinition as t };
+export { readNumberingDefinitions as a, NumberingLevel as i, NumberingDefinition as n, NumberingDefinitions as r, NUMBER_FORMAT_BY_NFC as t };

package/dist/{numbering-DF1z1PyG.d.ts → numbering-Co4jssbG.d.ts}

@@ -1,13 +1,15 @@
 import { t as Fib } from "./fib-CtsLtF96.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.148's own nfc field text: "If this is equal to 0xFF..., this level does not have a number sequence"). */
+  /** 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.148), 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". */
+  /** 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 {
@@ -19,4 +21,4 @@ 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 { readNumberingDefinitions as i, NumberingDefinitions as n, NumberingLevel as r, NumberingDefinition as t };
+export { readNumberingDefinitions as a, NumberingLevel as i, NumberingDefinition as n, NumberingDefinitions as r, NUMBER_FORMAT_BY_NFC as t };

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

@@ -1,4 +1,4 @@
-import { t as Prl } from "./sprm-Djg5RNiq.cjs";
+import { t as Prl } from "./sprm-DEyvdOo0.cjs";
 import { Alignment } from "document-schema.js";
 //#region src/prop/pap.d.ts
 interface ParagraphProperties {

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

@@ -1,4 +1,4 @@
-import { t as Prl } from "./sprm-Djg5RNiq.js";
+import { t as Prl } from "./sprm-DEyvdOo0.js";
 import { Alignment } from "document-schema.js";
 //#region src/prop/pap.d.ts
 interface ParagraphProperties {

package/dist/prop/chp-write.cjs

@@ -14,7 +14,7 @@ const KUL_SINGLE = 1;
 const SPRM_C_HPS = 19011;
 /** sprmCCv: a 4-byte COLORREF (r, g, b, fAuto). fAuto 0x00 means "use these components", the only form this writer emits. */
 const SPRM_C_CV = 26736;
-/** sprmCRgFtc0: a 2-byte signed index into the font table, [MS-DOC] 2.6.2 -- see style/fonts.ts. */
+/** sprmCRgFtc0: a 2-byte signed index into the font table, [MS-DOC] 2.6.1 -- see style/fonts.ts. */
 const SPRM_C_RG_FTC_0 = 19023;
 const HALF_POINTS_PER_POINT = 2;
 /** sprmCHps's own operand range: an unsigned 2-byte half-point value. */

package/dist/prop/chp-write.js

@@ -13,7 +13,7 @@ const KUL_SINGLE = 1;
 const SPRM_C_HPS = 19011;
 /** sprmCCv: a 4-byte COLORREF (r, g, b, fAuto). fAuto 0x00 means "use these components", the only form this writer emits. */
 const SPRM_C_CV = 26736;
-/** sprmCRgFtc0: a 2-byte signed index into the font table, [MS-DOC] 2.6.2 -- see style/fonts.ts. */
+/** sprmCRgFtc0: a 2-byte signed index into the font table, [MS-DOC] 2.6.1 -- see style/fonts.ts. */
 const SPRM_C_RG_FTC_0 = 19023;
 const HALF_POINTS_PER_POINT = 2;
 /** sprmCHps's own operand range: an unsigned 2-byte half-point value. */

package/dist/prop/chp.d.cts

@@ -1,4 +1,4 @@
-import { t as Prl } from "../sprm-Djg5RNiq.cjs";
+import { t as Prl } from "../sprm-DEyvdOo0.cjs";
 import { Color } from "document-schema.js";
 //#region src/prop/chp.d.ts
 interface CharacterProperties {

package/dist/prop/chp.d.ts

@@ -1,4 +1,4 @@
-import { t as Prl } from "../sprm-Djg5RNiq.js";
+import { t as Prl } from "../sprm-DEyvdOo0.js";
 import { Color } from "document-schema.js";
 //#region src/prop/chp.d.ts
 interface CharacterProperties {

package/dist/prop/pap-write.cjs

@@ -3,9 +3,10 @@ const require_errors = require("../errors.cjs");
 //#region src/prop/pap-write.ts
 /** sprmPJc: a 1-byte logical justification. */
 const SPRM_P_JC = 9313;
-/** sprmPDxaLeft / sprmPDxaLeft1: 2-byte signed twips. There is no writer-side counterpart for sprmPDxaRight (indent from the right margin): pap.ts's own reader folds it into a ParagraphProperties.indentRightPt field, but ContentParagraphSchema (document-schema.js) carries no such field for any writer to round-trip -- the right-indent value the reader computes is simply not part of the shared schema's paragraph vocabulary. */
+/** sprmPDxaLeft / sprmPDxaLeft1 / sprmPDxaRight: 2-byte signed twips. */
 const SPRM_P_DXA_LEFT = 33886;
 const SPRM_P_DXA_LEFT1 = 33888;
+const SPRM_P_DXA_RIGHT = 33885;
 /** sprmPDyaBefore / sprmPDyaAfter: 2-byte unsigned twips. */
 const SPRM_P_DYA_BEFORE = 42003;
 const SPRM_P_DYA_AFTER = 42004;
@@ -13,6 +14,12 @@ const SPRM_P_DYA_AFTER = 42004;
 const SPRM_P_DYA_LINE = 25618;
 /** sprmPFPageBreakBefore: a 1-byte Bool8. */
 const SPRM_P_F_PAGE_BREAK_BEFORE = 9223;
+/** sprmPIlfo: a 2-byte signed one-based index into PlfLfo.rgLfo -- which list membership names. */
+const SPRM_P_ILFO = 17931;
+/** sprmPIlvl: a 1-byte zero-based list level. */
+const SPRM_P_ILVL = 9738;
+/** sprmPIlvl's own 0..8 range: a non-simple list's LSTF always carries exactly nine LVLs ([MS-DOC] 2.9.148), so a level outside it names a depth this format cannot express at all. */
+const MAX_LIST_LEVEL = 8;
 const TWIPS_PER_POINT = 20;
 const LSPD_MULTIPLE_DIVISOR = 240;
 const LSPD_MAX_MULTIPLE_DYA_LINE = 31680;
@@ -44,10 +51,11 @@ function uint16(value, what) {
 function pointsToTwips(pt) {
 	return pt * TWIPS_PER_POINT;
 }
-function encodeParagraphGrpprl(paragraph) {
+function encodeParagraphGrpprl(paragraph, ilfoOf) {
 	const bytes = [];
 	if (paragraph.alignment !== void 0) pushSprm(bytes, SPRM_P_JC, [JC_VALUE[paragraph.alignment]]);
 	if (paragraph.indentLeftPt !== void 0) pushSprm(bytes, SPRM_P_DXA_LEFT, int16(pointsToTwips(paragraph.indentLeftPt), "paragraph indentLeftPt"));
+	if (paragraph.indentRightPt !== void 0) pushSprm(bytes, SPRM_P_DXA_RIGHT, int16(pointsToTwips(paragraph.indentRightPt), "paragraph indentRightPt"));
 	if (paragraph.indentFirstLinePt !== void 0) pushSprm(bytes, SPRM_P_DXA_LEFT1, int16(pointsToTwips(paragraph.indentFirstLinePt), "paragraph indentFirstLinePt"));
 	if (paragraph.spacingBeforePt !== void 0) pushSprm(bytes, SPRM_P_DYA_BEFORE, uint16(pointsToTwips(paragraph.spacingBeforePt), "paragraph spacingBeforePt"));
 	if (paragraph.spacingAfterPt !== void 0) pushSprm(bytes, SPRM_P_DYA_AFTER, uint16(pointsToTwips(paragraph.spacingAfterPt), "paragraph spacingAfterPt"));
@@ -61,6 +69,11 @@ function encodeParagraphGrpprl(paragraph) {
 		]);
 	}
 	if (paragraph.pageBreakBefore === true) pushSprm(bytes, SPRM_P_F_PAGE_BREAK_BEFORE, [1]);
+	if (paragraph.list?.numId !== void 0) {
+		if (paragraph.list.level > MAX_LIST_LEVEL) throw new require_errors.DocFormatError(`paragraph list level ${paragraph.list.level} is outside the 0..${MAX_LIST_LEVEL} range a non-simple LSTF's fixed nine LVLs can address`);
+		pushSprm(bytes, SPRM_P_ILFO, int16(ilfoOf(paragraph.list.numId), "paragraph list ilfo"));
+		pushSprm(bytes, SPRM_P_ILVL, [paragraph.list.level]);
+	}
 	return bytes;
 }
 //#endregion

package/dist/prop/pap-write.d.cts

@@ -1,5 +1,5 @@
 import { ContentParagraph } from "document-schema.js";
 //#region src/prop/pap-write.d.ts
-declare function encodeParagraphGrpprl(paragraph: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore">): number[];
+declare function encodeParagraphGrpprl(paragraph: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentRightPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore" | "list">, ilfoOf: (numId: string) => number): number[];
 //#endregion
 export { encodeParagraphGrpprl };

package/dist/prop/pap-write.d.ts

@@ -1,5 +1,5 @@
 import { ContentParagraph } from "document-schema.js";
 //#region src/prop/pap-write.d.ts
-declare function encodeParagraphGrpprl(paragraph: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore">): number[];
+declare function encodeParagraphGrpprl(paragraph: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentRightPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore" | "list">, ilfoOf: (numId: string) => number): number[];
 //#endregion
 export { encodeParagraphGrpprl };

package/dist/prop/pap-write.js

@@ -2,9 +2,10 @@ import { DocFormatError } from "../errors.js";
 //#region src/prop/pap-write.ts
 /** sprmPJc: a 1-byte logical justification. */
 const SPRM_P_JC = 9313;
-/** sprmPDxaLeft / sprmPDxaLeft1: 2-byte signed twips. There is no writer-side counterpart for sprmPDxaRight (indent from the right margin): pap.ts's own reader folds it into a ParagraphProperties.indentRightPt field, but ContentParagraphSchema (document-schema.js) carries no such field for any writer to round-trip -- the right-indent value the reader computes is simply not part of the shared schema's paragraph vocabulary. */
+/** sprmPDxaLeft / sprmPDxaLeft1 / sprmPDxaRight: 2-byte signed twips. */
 const SPRM_P_DXA_LEFT = 33886;
 const SPRM_P_DXA_LEFT1 = 33888;
+const SPRM_P_DXA_RIGHT = 33885;
 /** sprmPDyaBefore / sprmPDyaAfter: 2-byte unsigned twips. */
 const SPRM_P_DYA_BEFORE = 42003;
 const SPRM_P_DYA_AFTER = 42004;
@@ -12,6 +13,12 @@ const SPRM_P_DYA_AFTER = 42004;
 const SPRM_P_DYA_LINE = 25618;
 /** sprmPFPageBreakBefore: a 1-byte Bool8. */
 const SPRM_P_F_PAGE_BREAK_BEFORE = 9223;
+/** sprmPIlfo: a 2-byte signed one-based index into PlfLfo.rgLfo -- which list membership names. */
+const SPRM_P_ILFO = 17931;
+/** sprmPIlvl: a 1-byte zero-based list level. */
+const SPRM_P_ILVL = 9738;
+/** sprmPIlvl's own 0..8 range: a non-simple list's LSTF always carries exactly nine LVLs ([MS-DOC] 2.9.148), so a level outside it names a depth this format cannot express at all. */
+const MAX_LIST_LEVEL = 8;
 const TWIPS_PER_POINT = 20;
 const LSPD_MULTIPLE_DIVISOR = 240;
 const LSPD_MAX_MULTIPLE_DYA_LINE = 31680;
@@ -43,10 +50,11 @@ function uint16(value, what) {
 function pointsToTwips(pt) {
 	return pt * TWIPS_PER_POINT;
 }
-function encodeParagraphGrpprl(paragraph) {
+function encodeParagraphGrpprl(paragraph, ilfoOf) {
 	const bytes = [];
 	if (paragraph.alignment !== void 0) pushSprm(bytes, SPRM_P_JC, [JC_VALUE[paragraph.alignment]]);
 	if (paragraph.indentLeftPt !== void 0) pushSprm(bytes, SPRM_P_DXA_LEFT, int16(pointsToTwips(paragraph.indentLeftPt), "paragraph indentLeftPt"));
+	if (paragraph.indentRightPt !== void 0) pushSprm(bytes, SPRM_P_DXA_RIGHT, int16(pointsToTwips(paragraph.indentRightPt), "paragraph indentRightPt"));
 	if (paragraph.indentFirstLinePt !== void 0) pushSprm(bytes, SPRM_P_DXA_LEFT1, int16(pointsToTwips(paragraph.indentFirstLinePt), "paragraph indentFirstLinePt"));
 	if (paragraph.spacingBeforePt !== void 0) pushSprm(bytes, SPRM_P_DYA_BEFORE, uint16(pointsToTwips(paragraph.spacingBeforePt), "paragraph spacingBeforePt"));
 	if (paragraph.spacingAfterPt !== void 0) pushSprm(bytes, SPRM_P_DYA_AFTER, uint16(pointsToTwips(paragraph.spacingAfterPt), "paragraph spacingAfterPt"));
@@ -60,6 +68,11 @@ function encodeParagraphGrpprl(paragraph) {
 		]);
 	}
 	if (paragraph.pageBreakBefore === true) pushSprm(bytes, SPRM_P_F_PAGE_BREAK_BEFORE, [1]);
+	if (paragraph.list?.numId !== void 0) {
+		if (paragraph.list.level > MAX_LIST_LEVEL) throw new DocFormatError(`paragraph list level ${paragraph.list.level} is outside the 0..${MAX_LIST_LEVEL} range a non-simple LSTF's fixed nine LVLs can address`);
+		pushSprm(bytes, SPRM_P_ILFO, int16(ilfoOf(paragraph.list.numId), "paragraph list ilfo"));
+		pushSprm(bytes, SPRM_P_ILVL, [paragraph.list.level]);
+	}
 	return bytes;
 }
 //#endregion

package/dist/prop/pap.d.cts

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

package/dist/prop/pap.d.ts

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

package/dist/prop/sep.d.cts

@@ -1,5 +1,5 @@
 import { t as Fib } from "../fib-CtsLtF96.cjs";
-import { t as Prl } from "../sprm-Djg5RNiq.cjs";
+import { t as Prl } from "../sprm-DEyvdOo0.cjs";
 //#region src/prop/sep.d.ts
 interface SectionProperties {
   pageWidthPt?: number;

package/dist/prop/sep.d.ts

@@ -1,5 +1,5 @@
 import { t as Fib } from "../fib-CtsLtF96.js";
-import { t as Prl } from "../sprm-Djg5RNiq.js";
+import { t as Prl } from "../sprm-DEyvdOo0.js";
 //#region src/prop/sep.d.ts
 interface SectionProperties {
   pageWidthPt?: number;