doc-codec 2.5.0 → 2.7.0

package/dist/table/write.cjs

@@ -1,7 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_errors = require("../errors.cjs");
+require("../data-stream.cjs");
 require("../text/special.cjs");
 const require_prop_fkp_write = require("../prop/fkp-write.cjs");
+const require_pictures_write = require("../pictures-write.cjs");
 const require_table_tap_write = require("./tap-write.cjs");
 //#region src/table/write.ts
 /** sprmPFInTable (0x2416): a Bool8, "MUST be 1 any time the table depth is greater than zero". */
@@ -9,6 +11,12 @@ const SPRM_P_F_IN_TABLE = 9238;
 /** sprmPFTtp (0x2417): a Bool8 marking a cell mark as the row's own Table Terminating Paragraph mark. */
 const SPRM_P_F_TTP = 9239;
 const TWIPS_PER_POINT = 20;
+function plainRuns(runs) {
+	return runs.map((run) => ({
+		run,
+		extraGrpprl: []
+	}));
+}
 function pushSprm(bytes, opcode, operand) {
 	bytes.push(opcode & 255, opcode >> 8 & 255, ...operand);
 }
@@ -33,7 +41,7 @@ function cellParagraphs(blocks) {
 	return blocks.map((block, index) => {
 		if (block.kind !== "paragraph") throw new require_errors.DocUnsupportedError(`doc-codec's writer does not support a '${block.kind}' block inside a table cell (only paragraphs are; nested tables are a separately-tracked gap -- see the README's scope note)`);
 		return {
-			runs: block.runs,
+			runs: plainRuns(block.runs),
 			properties: block,
 			extraGrpprl: inTableGrpprl(),
 			terminator: index === blocks.length - 1 ? 7 : 13
@@ -189,12 +197,25 @@ function flattenTable(table, blockIndex, onWarning) {
 	});
 	return output;
 }
-function flattenSectionBlocks(blocks, onWarning) {
+function imageParagraph(image, dataStream) {
+	const { data, buildGrpprl } = require_pictures_write.buildInlinePicture(image);
+	const offset = dataStream.append(data);
+	return {
+		runs: [{
+			run: { text: String.fromCharCode(1) },
+			extraGrpprl: buildGrpprl(offset)
+		}],
+		properties: {},
+		extraGrpprl: [],
+		terminator: 13
+	};
+}
+function flattenSectionBlocks(blocks, dataStream, onWarning) {
 	const output = [];
 	blocks.forEach((block, blockIndex) => {
 		if (block.kind === "paragraph") {
 			output.push({
-				runs: block.runs,
+				runs: plainRuns(block.runs),
 				properties: block,
 				extraGrpprl: [],
 				terminator: 13
@@ -205,6 +226,10 @@ function flattenSectionBlocks(blocks, onWarning) {
 			output.push(...flattenTable(block, blockIndex, onWarning));
 			return;
 		}
+		if (block.kind === "image") {
+			output.push(imageParagraph(block, dataStream));
+			return;
+		}
 		throw new require_errors.DocUnsupportedError(`doc-codec's writer does not yet support '${block.kind}' blocks (see README's scope note)`);
 	});
 	return output;

package/dist/table/write.d.cts

@@ -1,2 +1,2 @@
-import { n as WriteWarning, r as flattenSectionBlocks, t as WriteParagraph } from "../write-SN_aIwyF.cjs";
-export { WriteParagraph, WriteWarning, flattenSectionBlocks };
+import { i as flattenSectionBlocks, n as WriteRun, r as WriteWarning, t as WriteParagraph } from "../write-CMB3qF4i.cjs";
+export { WriteParagraph, WriteRun, WriteWarning, flattenSectionBlocks };

package/dist/table/write.d.ts

@@ -1,2 +1,2 @@
-import { n as WriteWarning, r as flattenSectionBlocks, t as WriteParagraph } from "../write-SN_aIwyF.js";
-export { WriteParagraph, WriteWarning, flattenSectionBlocks };
+import { i as flattenSectionBlocks, n as WriteRun, r as WriteWarning, t as WriteParagraph } from "../write-t4rFgnA-.js";
+export { WriteParagraph, WriteRun, WriteWarning, flattenSectionBlocks };

package/dist/table/write.js

@@ -1,6 +1,8 @@
 import { DocFormatError, DocUnsupportedError } from "../errors.js";
+import "../data-stream.js";
 import "../text/special.js";
 import { fitsAloneOnPapxPage } from "../prop/fkp-write.js";
+import { buildInlinePicture } from "../pictures-write.js";
 import { encodeTableRowGrpprl } from "./tap-write.js";
 //#region src/table/write.ts
 /** sprmPFInTable (0x2416): a Bool8, "MUST be 1 any time the table depth is greater than zero". */
@@ -8,6 +10,12 @@ const SPRM_P_F_IN_TABLE = 9238;
 /** sprmPFTtp (0x2417): a Bool8 marking a cell mark as the row's own Table Terminating Paragraph mark. */
 const SPRM_P_F_TTP = 9239;
 const TWIPS_PER_POINT = 20;
+function plainRuns(runs) {
+	return runs.map((run) => ({
+		run,
+		extraGrpprl: []
+	}));
+}
 function pushSprm(bytes, opcode, operand) {
 	bytes.push(opcode & 255, opcode >> 8 & 255, ...operand);
 }
@@ -32,7 +40,7 @@ function cellParagraphs(blocks) {
 	return blocks.map((block, index) => {
 		if (block.kind !== "paragraph") throw new DocUnsupportedError(`doc-codec's writer does not support a '${block.kind}' block inside a table cell (only paragraphs are; nested tables are a separately-tracked gap -- see the README's scope note)`);
 		return {
-			runs: block.runs,
+			runs: plainRuns(block.runs),
 			properties: block,
 			extraGrpprl: inTableGrpprl(),
 			terminator: index === blocks.length - 1 ? 7 : 13
@@ -188,12 +196,25 @@ function flattenTable(table, blockIndex, onWarning) {
 	});
 	return output;
 }
-function flattenSectionBlocks(blocks, onWarning) {
+function imageParagraph(image, dataStream) {
+	const { data, buildGrpprl } = buildInlinePicture(image);
+	const offset = dataStream.append(data);
+	return {
+		runs: [{
+			run: { text: String.fromCharCode(1) },
+			extraGrpprl: buildGrpprl(offset)
+		}],
+		properties: {},
+		extraGrpprl: [],
+		terminator: 13
+	};
+}
+function flattenSectionBlocks(blocks, dataStream, onWarning) {
 	const output = [];
 	blocks.forEach((block, blockIndex) => {
 		if (block.kind === "paragraph") {
 			output.push({
-				runs: block.runs,
+				runs: plainRuns(block.runs),
 				properties: block,
 				extraGrpprl: [],
 				terminator: 13
@@ -204,6 +225,10 @@ function flattenSectionBlocks(blocks, onWarning) {
 			output.push(...flattenTable(block, blockIndex, onWarning));
 			return;
 		}
+		if (block.kind === "image") {
+			output.push(imageParagraph(block, dataStream));
+			return;
+		}
 		throw new DocUnsupportedError(`doc-codec's writer does not yet support '${block.kind}' blocks (see README's scope note)`);
 	});
 	return output;

package/dist/{write-SN_aIwyF.d.ts → write-CMB3qF4i.d.cts}

@@ -1,15 +1,21 @@
+import { t as DataStreamBuilder } from "./data-stream-BLCj4-V1.cjs";
 import { ContentBlock, ContentParagraph, ContentRun } from "document-schema.js";
 //#region src/table/write.d.ts
 /** Reports a non-fatal write-time degradation -- this package's own analogue of byte-codec's/pdf-codec's `onWarning`, adopted here rather than a new shape of its own so a caller already handling one already handles the other. */
 type WriteWarning = (message: string) => void;
+/** One run to write, alongside grpprl bytes appended after encodeCharacterGrpprl's own output for it -- the run-level analogue of WriteParagraph.extraGrpprl below. Every ordinary run carries none (its whole grpprl comes from its own ContentRun fields); imageParagraph's own picture-anchor run is the one exception, since sprmCPicLocation is not a ContentRun field encodeCharacterGrpprl could ever derive on its own. */
+interface WriteRun {
+  readonly run: ContentRun;
+  readonly extraGrpprl: readonly number[];
+}
 interface WriteParagraph {
-  readonly runs: readonly ContentRun[];
+  readonly runs: readonly WriteRun[];
   readonly properties: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentRightPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore" | "list" | "styleId" | "headingLevel">;
   /** Extra grpprl bytes appended after encodeParagraphGrpprl's own output -- sprmPFInTable on every table paragraph, plus sprmPFTtp and the row's own TAP on a row's trailing mark. */
   readonly extraGrpprl: readonly number[];
   /** The character terminating this paragraph in the text stream: PARAGRAPH_MARK normally, CELL_MARK for a table cell or row mark. */
   readonly terminator: number;
 }
-declare function flattenSectionBlocks(blocks: readonly ContentBlock[], onWarning?: WriteWarning): WriteParagraph[];
+declare function flattenSectionBlocks(blocks: readonly ContentBlock[], dataStream: DataStreamBuilder, onWarning?: WriteWarning): WriteParagraph[];
 //#endregion
-export { WriteWarning as n, flattenSectionBlocks as r, WriteParagraph as t };
+export { flattenSectionBlocks as i, WriteRun as n, WriteWarning as r, WriteParagraph as t };

package/dist/{write-SN_aIwyF.d.cts → write-t4rFgnA-.d.ts}

@@ -1,15 +1,21 @@
+import { t as DataStreamBuilder } from "./data-stream-BLCj4-V1.js";
 import { ContentBlock, ContentParagraph, ContentRun } from "document-schema.js";
 //#region src/table/write.d.ts
 /** Reports a non-fatal write-time degradation -- this package's own analogue of byte-codec's/pdf-codec's `onWarning`, adopted here rather than a new shape of its own so a caller already handling one already handles the other. */
 type WriteWarning = (message: string) => void;
+/** One run to write, alongside grpprl bytes appended after encodeCharacterGrpprl's own output for it -- the run-level analogue of WriteParagraph.extraGrpprl below. Every ordinary run carries none (its whole grpprl comes from its own ContentRun fields); imageParagraph's own picture-anchor run is the one exception, since sprmCPicLocation is not a ContentRun field encodeCharacterGrpprl could ever derive on its own. */
+interface WriteRun {
+  readonly run: ContentRun;
+  readonly extraGrpprl: readonly number[];
+}
 interface WriteParagraph {
-  readonly runs: readonly ContentRun[];
+  readonly runs: readonly WriteRun[];
   readonly properties: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentRightPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore" | "list" | "styleId" | "headingLevel">;
   /** Extra grpprl bytes appended after encodeParagraphGrpprl's own output -- sprmPFInTable on every table paragraph, plus sprmPFTtp and the row's own TAP on a row's trailing mark. */
   readonly extraGrpprl: readonly number[];
   /** The character terminating this paragraph in the text stream: PARAGRAPH_MARK normally, CELL_MARK for a table cell or row mark. */
   readonly terminator: number;
 }
-declare function flattenSectionBlocks(blocks: readonly ContentBlock[], onWarning?: WriteWarning): WriteParagraph[];
+declare function flattenSectionBlocks(blocks: readonly ContentBlock[], dataStream: DataStreamBuilder, onWarning?: WriteWarning): WriteParagraph[];
 //#endregion
-export { WriteWarning as n, flattenSectionBlocks as r, WriteParagraph as t };
+export { flattenSectionBlocks as i, WriteRun as n, WriteWarning as r, WriteParagraph as t };

package/dist/write.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_errors = require("./errors.cjs");
+const require_data_stream = require("./data-stream.cjs");
 const require_detect = require("./detect.cjs");
 require("./prop/fkp.cjs");
 const require_style_stsh = require("./style/stsh.cjs");
@@ -22,16 +23,22 @@ const TEXT_FC = 1024;
 const BYTES_PER_CHARACTER = 2;
 function writeDocContent(document, options = {}) {
 	if (document.kind !== "wordprocessing") throw new require_errors.DocUnsupportedError(`doc-codec writes wordprocessing documents only; got a '${document.kind}' document`);
-	if (document.sections.length !== 1) throw new require_errors.DocUnsupportedError(`doc-codec's reader never distinguishes more than one section within a document (see README's "Section properties" scope note): writeDocContent refuses ${document.sections.length} sections rather than silently merging their content into what would read back as one`);
-	const [section] = document.sections;
-	if (section === void 0) throw new require_errors.DocFormatError("a wordprocessing document must carry a section");
-	const writeParagraphs = require_table_write.flattenSectionBlocks(section.blocks, options.onWarning);
-	if (writeParagraphs[writeParagraphs.length - 1]?.terminator !== 13) writeParagraphs.push({
-		runs: [],
-		properties: {},
-		extraGrpprl: [],
-		terminator: 13
+	if (document.sections.length === 0) throw new require_errors.DocFormatError("a wordprocessing document must carry at least one section");
+	const dataStream = new require_data_stream.DataStreamBuilder();
+	const sectionParagraphLists = document.sections.map((section, index) => {
+		const paragraphs = require_table_write.flattenSectionBlocks(section.blocks, dataStream, options.onWarning);
+		closeSection(paragraphs, index === document.sections.length - 1 ? 13 : 12);
+		return paragraphs;
 	});
+	const sectionStartIndices = [];
+	{
+		let runningIndex = 0;
+		for (const paragraphs of sectionParagraphLists) {
+			sectionStartIndices.push(runningIndex);
+			runningIndex += paragraphs.length;
+		}
+	}
+	const writeParagraphs = sectionParagraphLists.flat();
 	const FIRST_NON_HEADING_ISTD = 10;
 	const MAX_HEADING_ISTD = 9;
 	const styleNames = /* @__PURE__ */ new Map();
@@ -72,9 +79,9 @@ function writeDocContent(document, options = {}) {
 	};
 	const numberingTables = require_list_numbering_write.buildNumberingTables(listUsage.definitions);
 	const formatted = writeParagraphs.map((entry) => ({
-		runs: entry.runs.map((run) => ({
-			text: run.text,
-			grpprl: require_prop_chp_write.encodeCharacterGrpprl(run, fontIndexOf)
+		runs: entry.runs.map((writeRun) => ({
+			text: writeRun.run.text,
+			grpprl: [...require_prop_chp_write.encodeCharacterGrpprl(writeRun.run, fontIndexOf), ...writeRun.extraGrpprl]
 		})),
 		grpprl: [...require_prop_pap_write.encodeParagraphGrpprl(entry.properties, ilfoOf), ...entry.extraGrpprl]
 	}));
@@ -132,9 +139,20 @@ function writeDocContent(document, options = {}) {
 		};
 	});
 	const papxPages = require_prop_fkp_write.buildPapxPages(papxParagraphSpecs, textFcLim);
-	const sepx = require_prop_sep_write.buildSepx(require_prop_sep_write.encodeSectionGrpprl(section));
-	const fcSepx = (papxPageStart + papxPages.length) * 512;
-	const wordDocument = new Uint8Array(fcSepx + sepx.length);
+	const sepxPageStart = (papxPageStart + papxPages.length) * 512;
+	const sepxList = document.sections.map((section) => require_prop_sep_write.buildSepx(require_prop_sep_write.encodeSectionGrpprl(section)));
+	const fcSepxList = [];
+	{
+		let sepxCursor = sepxPageStart;
+		for (const sepx of sepxList) {
+			fcSepxList.push(sepxCursor);
+			sepxCursor += sepx.length;
+		}
+	}
+	const lastFcSepx = fcSepxList[fcSepxList.length - 1];
+	const lastSepx = sepxList[sepxList.length - 1];
+	if (lastFcSepx === void 0 || lastSepx === void 0) throw new require_errors.DocFormatError("internal defect: writeDocContent built an empty section list despite the earlier at-least-one-section guard");
+	const wordDocument = new Uint8Array(lastFcSepx + lastSepx.length);
 	const wordView = new DataView(wordDocument.buffer);
 	for (let index = 0; index < text.length; index += 1) wordView.setUint16(characterFc(index), text.charCodeAt(index), true);
 	chpxPages.forEach((page, index) => {
@@ -143,13 +161,22 @@ function writeDocContent(document, options = {}) {
 	papxPages.forEach((page, index) => {
 		wordDocument.set(page, (papxPageStart + index) * 512);
 	});
-	wordDocument.set(sepx, fcSepx);
+	sepxList.forEach((sepx, index) => {
+		const fcSepx = fcSepxList[index];
+		if (fcSepx === void 0) throw new require_errors.DocFormatError(`internal defect: writeDocContent lost section ${String(index)}'s own Sepx placement`);
+		wordDocument.set(sepx, fcSepx);
+	});
+	const sectionStartCps = sectionStartIndices.map((paragraphIndex, index) => {
+		const startCp = paragraphStarts[paragraphIndex];
+		if (startCp === void 0) throw new require_errors.DocFormatError(`internal defect: writeDocContent lost section ${String(index)}'s own start CP`);
+		return startCp;
+	});
 	const clx = require_text_piece_table_write.buildTextClx(text.length, TEXT_FC);
 	const chpxBinTable = require_prop_fkp_write.buildPropertyBinTable([...chpxPages.map(require_prop_fkp_write.firstFcOfPage), textFcLim], chpxPages.map((_, index) => chpxPageStart + index));
 	const papxBinTable = require_prop_fkp_write.buildPropertyBinTable([...papxPages.map(require_prop_fkp_write.firstFcOfPage), textFcLim], papxPages.map((_, index) => papxPageStart + index));
 	const stsh = require_style_stsh.buildStshForStyles(styleNames);
 	const fontTable = fontNames.length > 0 ? require_style_fonts.buildFontTable(fontNames) : void 0;
-	const plcfSed = require_prop_sep_write.buildPlcfSed(text.length, fcSepx);
+	const plcfSed = require_prop_sep_write.buildPlcfSed(sectionStartCps, text.length, fcSepxList);
 	let cursor = 0;
 	const place = (bytes) => {
 		const offset = cursor;
@@ -207,11 +234,32 @@ function writeDocContent(document, options = {}) {
 		path: require_detect.SUMMARY_INFORMATION_STREAM,
 		bytes: (0, archive_codec.writeSummaryInformationStream)(require_metadata.layoutMetadataToSummaryInformation(document.metadata))
 	});
+	const dataStreamBytes = dataStream.build();
+	if (dataStreamBytes.length > 0) streams.push({
+		path: require_detect.DATA_STREAM,
+		bytes: dataStreamBytes
+	});
 	return (0, archive_codec.writeCompoundFile)(streams);
 }
 function sameGrpprl(a, b) {
 	if (a === void 0 || b === void 0) return a === b;
 	return a.length === b.length && a.every((byte, index) => byte === b[index]);
 }
+function closeSection(paragraphs, terminator) {
+	if (paragraphs[paragraphs.length - 1]?.terminator !== 13) paragraphs.push({
+		runs: [],
+		properties: {},
+		extraGrpprl: [],
+		terminator: 13
+	});
+	if (terminator === 13) return;
+	const index = paragraphs.length - 1;
+	const target = paragraphs[index];
+	if (target === void 0) throw new require_errors.DocFormatError("internal defect: closeSection lost its own just-ensured trailing paragraph");
+	paragraphs[index] = {
+		...target,
+		terminator
+	};
+}
 //#endregion
 exports.writeDocContent = writeDocContent;

package/dist/write.d.cts

@@ -1,4 +1,4 @@
-import { n as WriteWarning } from "./write-SN_aIwyF.cjs";
+import { r as WriteWarning } from "./write-CMB3qF4i.cjs";
 import { ContentDocument } from "document-schema.js";
 //#region src/write.d.ts
 interface WriteDocContentOptions {

package/dist/write.d.ts

@@ -1,4 +1,4 @@
-import { n as WriteWarning } from "./write-SN_aIwyF.js";
+import { r as WriteWarning } from "./write-t4rFgnA-.js";
 import { ContentDocument } from "document-schema.js";
 //#region src/write.d.ts
 interface WriteDocContentOptions {

package/dist/write.js

@@ -1,5 +1,6 @@
 import { DocFormatError, DocUnsupportedError } from "./errors.js";
-import { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM } from "./detect.js";
+import { DataStreamBuilder } from "./data-stream.js";
+import { DATA_STREAM, SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM } from "./detect.js";
 import "./prop/fkp.js";
 import { buildStshForStyles } from "./style/stsh.js";
 import "./text/special.js";
@@ -21,16 +22,22 @@ const TEXT_FC = 1024;
 const BYTES_PER_CHARACTER = 2;
 function writeDocContent(document, options = {}) {
 	if (document.kind !== "wordprocessing") throw new DocUnsupportedError(`doc-codec writes wordprocessing documents only; got a '${document.kind}' document`);
-	if (document.sections.length !== 1) throw new DocUnsupportedError(`doc-codec's reader never distinguishes more than one section within a document (see README's "Section properties" scope note): writeDocContent refuses ${document.sections.length} sections rather than silently merging their content into what would read back as one`);
-	const [section] = document.sections;
-	if (section === void 0) throw new DocFormatError("a wordprocessing document must carry a section");
-	const writeParagraphs = flattenSectionBlocks(section.blocks, options.onWarning);
-	if (writeParagraphs[writeParagraphs.length - 1]?.terminator !== 13) writeParagraphs.push({
-		runs: [],
-		properties: {},
-		extraGrpprl: [],
-		terminator: 13
+	if (document.sections.length === 0) throw new DocFormatError("a wordprocessing document must carry at least one section");
+	const dataStream = new DataStreamBuilder();
+	const sectionParagraphLists = document.sections.map((section, index) => {
+		const paragraphs = flattenSectionBlocks(section.blocks, dataStream, options.onWarning);
+		closeSection(paragraphs, index === document.sections.length - 1 ? 13 : 12);
+		return paragraphs;
 	});
+	const sectionStartIndices = [];
+	{
+		let runningIndex = 0;
+		for (const paragraphs of sectionParagraphLists) {
+			sectionStartIndices.push(runningIndex);
+			runningIndex += paragraphs.length;
+		}
+	}
+	const writeParagraphs = sectionParagraphLists.flat();
 	const FIRST_NON_HEADING_ISTD = 10;
 	const MAX_HEADING_ISTD = 9;
 	const styleNames = /* @__PURE__ */ new Map();
@@ -71,9 +78,9 @@ function writeDocContent(document, options = {}) {
 	};
 	const numberingTables = buildNumberingTables(listUsage.definitions);
 	const formatted = writeParagraphs.map((entry) => ({
-		runs: entry.runs.map((run) => ({
-			text: run.text,
-			grpprl: encodeCharacterGrpprl(run, fontIndexOf)
+		runs: entry.runs.map((writeRun) => ({
+			text: writeRun.run.text,
+			grpprl: [...encodeCharacterGrpprl(writeRun.run, fontIndexOf), ...writeRun.extraGrpprl]
 		})),
 		grpprl: [...encodeParagraphGrpprl(entry.properties, ilfoOf), ...entry.extraGrpprl]
 	}));
@@ -131,9 +138,20 @@ function writeDocContent(document, options = {}) {
 		};
 	});
 	const papxPages = buildPapxPages(papxParagraphSpecs, textFcLim);
-	const sepx = buildSepx(encodeSectionGrpprl(section));
-	const fcSepx = (papxPageStart + papxPages.length) * 512;
-	const wordDocument = new Uint8Array(fcSepx + sepx.length);
+	const sepxPageStart = (papxPageStart + papxPages.length) * 512;
+	const sepxList = document.sections.map((section) => buildSepx(encodeSectionGrpprl(section)));
+	const fcSepxList = [];
+	{
+		let sepxCursor = sepxPageStart;
+		for (const sepx of sepxList) {
+			fcSepxList.push(sepxCursor);
+			sepxCursor += sepx.length;
+		}
+	}
+	const lastFcSepx = fcSepxList[fcSepxList.length - 1];
+	const lastSepx = sepxList[sepxList.length - 1];
+	if (lastFcSepx === void 0 || lastSepx === void 0) throw new DocFormatError("internal defect: writeDocContent built an empty section list despite the earlier at-least-one-section guard");
+	const wordDocument = new Uint8Array(lastFcSepx + lastSepx.length);
 	const wordView = new DataView(wordDocument.buffer);
 	for (let index = 0; index < text.length; index += 1) wordView.setUint16(characterFc(index), text.charCodeAt(index), true);
 	chpxPages.forEach((page, index) => {
@@ -142,13 +160,22 @@ function writeDocContent(document, options = {}) {
 	papxPages.forEach((page, index) => {
 		wordDocument.set(page, (papxPageStart + index) * 512);
 	});
-	wordDocument.set(sepx, fcSepx);
+	sepxList.forEach((sepx, index) => {
+		const fcSepx = fcSepxList[index];
+		if (fcSepx === void 0) throw new DocFormatError(`internal defect: writeDocContent lost section ${String(index)}'s own Sepx placement`);
+		wordDocument.set(sepx, fcSepx);
+	});
+	const sectionStartCps = sectionStartIndices.map((paragraphIndex, index) => {
+		const startCp = paragraphStarts[paragraphIndex];
+		if (startCp === void 0) throw new DocFormatError(`internal defect: writeDocContent lost section ${String(index)}'s own start CP`);
+		return startCp;
+	});
 	const clx = buildTextClx(text.length, TEXT_FC);
 	const chpxBinTable = buildPropertyBinTable([...chpxPages.map(firstFcOfPage), textFcLim], chpxPages.map((_, index) => chpxPageStart + index));
 	const papxBinTable = buildPropertyBinTable([...papxPages.map(firstFcOfPage), textFcLim], papxPages.map((_, index) => papxPageStart + index));
 	const stsh = buildStshForStyles(styleNames);
 	const fontTable = fontNames.length > 0 ? buildFontTable(fontNames) : void 0;
-	const plcfSed = buildPlcfSed(text.length, fcSepx);
+	const plcfSed = buildPlcfSed(sectionStartCps, text.length, fcSepxList);
 	let cursor = 0;
 	const place = (bytes) => {
 		const offset = cursor;
@@ -206,11 +233,32 @@ function writeDocContent(document, options = {}) {
 		path: SUMMARY_INFORMATION_STREAM,
 		bytes: writeSummaryInformationStream(layoutMetadataToSummaryInformation$1(document.metadata))
 	});
+	const dataStreamBytes = dataStream.build();
+	if (dataStreamBytes.length > 0) streams.push({
+		path: DATA_STREAM,
+		bytes: dataStreamBytes
+	});
 	return writeCompoundFile(streams);
 }
 function sameGrpprl(a, b) {
 	if (a === void 0 || b === void 0) return a === b;
 	return a.length === b.length && a.every((byte, index) => byte === b[index]);
 }
+function closeSection(paragraphs, terminator) {
+	if (paragraphs[paragraphs.length - 1]?.terminator !== 13) paragraphs.push({
+		runs: [],
+		properties: {},
+		extraGrpprl: [],
+		terminator: 13
+	});
+	if (terminator === 13) return;
+	const index = paragraphs.length - 1;
+	const target = paragraphs[index];
+	if (target === void 0) throw new DocFormatError("internal defect: closeSection lost its own just-ensured trailing paragraph");
+	paragraphs[index] = {
+		...target,
+		terminator
+	};
+}
 //#endregion
 export { writeDocContent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doc-codec",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "A hand-written reader for the Word Binary File Format ([MS-DOC], .doc) against the shared document-schema.js content pivot: FIB parsing, piece-table text reconstruction, and CHPX/PAPX formatting exceptions.",
   "type": "module",
   "repository": {
@@ -78,7 +78,7 @@
   "license": "MIT",
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "archive-codec": "1.9.2",
+    "archive-codec": "1.10.0",
     "document-schema.js": "7.5.0"
   },
   "devDependencies": {