doc-codec 1.0.2 → 1.1.1

package/dist/table/tap.cjs

@@ -0,0 +1,217 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_bytes = require("../bytes.cjs");
+const require_prop_sprm = require("../prop/sprm.cjs");
+const require_table_decoration = require("./decoration.cjs");
+//#region src/table/tap.ts
+const SPRM_T_DEF_TABLE = 54792;
+const SPRM_T_DYA_ROW_HEIGHT = 37895;
+/** sprmTMerge: an ItcFirstLim naming a range of cells to horizontally merge, the first cell becoming the anchor -- a spec-conformant mechanism this reader still honours for a genuine third-party producer, even though this package's own writer no longer emits it (see this module's own top-of-file note and table/write.ts's). */
+const SPRM_T_MERGE = 22052;
+/** sprmTVertMerge (0xD62B): a VertMergeOperand naming one cell (itc) and its own VerticalMergeFlag, the incremental per-cell equivalent of sprmTMerge for a vertical merge. */
+const SPRM_T_VERT_MERGE = 54827;
+/** sprmTSetBrc (0xD62F): a TableBrcOperand ([MS-DOC] 2.9.305) restating one cell range's borders on the named sides, with an exact COLORREF rather than TC80's own Ico index. */
+const SPRM_T_SET_BRC = 54831;
+/** sprmTDefTableShd80 (0xD609): a DefTableShd80Operand ([MS-DOC] 2.9.52), the Word 97-era array of one Shd80 per cell starting at the row's first. */
+const SPRM_T_DEF_TABLE_SHD80 = 54793;
+/** sprmTDefTableShd3rd (0xD60C): a DefTableShdOperand ([MS-DOC] 2.9.53) shading cells 45-63 -- index 44 onward. */
+const SPRM_T_DEF_TABLE_SHD_3RD = 54796;
+/** sprmTDefTableShd (0xD612): a DefTableShdOperand shading cells 1-22 -- index 0 onward. */
+const SPRM_T_DEF_TABLE_SHD = 54802;
+/** sprmTDefTableShd2nd (0xD616): a DefTableShdOperand shading cells 23-44 -- index 22 onward. */
+const SPRM_T_DEF_TABLE_SHD_2ND = 54806;
+/** sprmTSetShd (0xD62D): a TableShadeOperand ([MS-DOC] 2.9.308) shading one ItcFirstLim cell range. */
+const SPRM_T_SET_SHD = 54829;
+/** sprmTSetShdOdd (0xD62E): the same TableShadeOperand, applied to every other cell of the range starting at itcFirst -- [MS-DOC] 2.6.3's own worked example, "if the set of cells is 0 through 5, then this sets the background shading for cells 0, 2 and 4". */
+const SPRM_T_SET_SHD_ODD = 54830;
+/** sprmTDefTableShdRaw/Raw2nd/Raw3rd (0xD670-0xD672): the same three DefTableShdOperand arrays, differing from the sprms above only in how ShdNil is treated inside a table style -- which this package neither reads nor writes, so all six resolve identically here. A real producer (LibreOffice) writes both families for the same row. */
+const SPRM_T_DEF_TABLE_SHD_RAW = 54896;
+const SPRM_T_DEF_TABLE_SHD_RAW_2ND = 54897;
+const SPRM_T_DEF_TABLE_SHD_RAW_3RD = 54898;
+/** The first cell index each of the three DefTableShdOperand sprms shades, [MS-DOC] 2.6.3: "Cells 1 - 22 are shaded by sprmTDefTableShd, and cells 23 - 44 are shaded by sprmTDefTableShd2nd" and 45-63 by the third -- one-based there, so zero-based here. */
+const SHD_ARRAY_FIRST_CELL = {
+	[SPRM_T_DEF_TABLE_SHD]: 0,
+	[SPRM_T_DEF_TABLE_SHD_RAW]: 0,
+	[SPRM_T_DEF_TABLE_SHD_2ND]: 22,
+	[SPRM_T_DEF_TABLE_SHD_RAW_2ND]: 22,
+	[SPRM_T_DEF_TABLE_SHD_3RD]: 44,
+	[SPRM_T_DEF_TABLE_SHD_RAW_3RD]: 44
+};
+const TWIPS_PER_POINT = 20;
+/** TC80's own fixed size, [MS-DOC] 2.9.313: tcgrf (2) + wWidth (2) + brcTop/brcLeft/brcBottom/brcRight (4 each). */
+const TC80_SIZE = 20;
+/** The offset of TC80's own first border field, brcTop, past tcgrf and wWidth. The four follow it back to back in CELL_BORDER_SIDES order. */
+const TC80_BORDERS_OFFSET = 4;
+/** TCGRF.horzMerge, [MS-DOC] 2.9.317: 0 not merged, 1 a continuation cell (contributes its layout region, its own contents are not rendered), 2 or 3 the first cell of a horizontally merged set. */
+const HORZ_MERGE_CONTINUATION = 1;
+/** VerticalMergeFlag's fvmMerge: TCGRF.vertMerge continuation (fvmClear=0, fvmMerge=1, fvmRestart=3 -- 2 is not a defined member). */
+const VERT_MERGE_CONTINUATION = 1;
+const VERT_MERGE_RESTART = 3;
+function readTdefTableOperand(operand) {
+	const numberOfColumns = require_bytes.readUint8(operand, 2);
+	const boundariesStart = 3;
+	const columnBoundariesTwips = [];
+	for (let index = 0; index <= numberOfColumns; index += 1) columnBoundariesTwips.push(require_bytes.readInt16LE(operand, boundariesStart + index * 2));
+	const tc80Start = boundariesStart + (numberOfColumns + 1) * 2;
+	const cells = [];
+	for (let index = 0; index < numberOfColumns; index += 1) {
+		const tc80Offset = tc80Start + index * TC80_SIZE;
+		if (tc80Offset + TC80_SIZE > operand.length) {
+			cells.push({
+				horzMerge: 0,
+				vertMerge: 0
+			});
+			continue;
+		}
+		const tcgrf = require_bytes.readUint16LE(operand, tc80Offset);
+		const sides = {
+			top: void 0,
+			left: void 0,
+			bottom: void 0,
+			right: void 0
+		};
+		require_table_decoration.CELL_BORDER_SIDES.forEach((side, sideIndex) => {
+			sides[side] = require_table_decoration.readBrc80(operand, tc80Offset + TC80_BORDERS_OFFSET + sideIndex * 4);
+		});
+		cells.push({
+			horzMerge: tcgrf & 3,
+			vertMerge: tcgrf >> 5 & 3,
+			borders: require_table_decoration.cellBordersFrom(sides)
+		});
+	}
+	return {
+		columnBoundariesTwips,
+		cells
+	};
+}
+/** Replaces one cell's own entry in a definition, keeping every other cell and the row's boundaries untouched -- the shape every incremental sprm below folds through, so none of them has to restate how a definition is rebuilt. */
+function withCells(definition, next) {
+	return {
+		columnBoundariesTwips: definition.columnBoundariesTwips,
+		cells: definition.cells.map(next)
+	};
+}
+/** Overlays the sides one TableBrcOperand names onto a cell's existing borders, leaving every side it does not name as TC80's own Brc80 stated it. A named side whose Brc is a NilBrc removes that side's border, which is how a producer states "this cell has no top border" over a row-level one it would otherwise inherit. */
+function applyBrcToCell(cell, bordersToApply, border) {
+	const sides = {
+		top: cell.borders?.top,
+		left: cell.borders?.left,
+		bottom: cell.borders?.bottom,
+		right: cell.borders?.right
+	};
+	for (const side of require_table_decoration.CELL_BORDER_SIDES) if ((bordersToApply & require_table_decoration.BORDERS_TO_APPLY[side]) !== 0) sides[side] = border;
+	return {
+		horzMerge: cell.horzMerge,
+		vertMerge: cell.vertMerge,
+		borders: require_table_decoration.cellBordersFrom(sides),
+		background: cell.background
+	};
+}
+function withBackground(cell, background) {
+	return {
+		horzMerge: cell.horzMerge,
+		vertMerge: cell.vertMerge,
+		borders: cell.borders,
+		background
+	};
+}
+/** Applies a DefTableShdOperand's ([MS-DOC] 2.9.53) rgShd array from `firstCell` onward. The array carries "only ... elements necessary to define all shaded cells in the row", so cells past its end keep whatever an earlier sprm left them -- an entry that is present and states ShdAuto/ShdNil genuinely clears its own cell, which is how a real producer's full-length array turns a row's unshaded cells back off. */
+function applyShdArray(definition, operand, firstCell, entrySize, colorAt) {
+	const cb = require_bytes.readUint8(operand, 0);
+	const count = Math.floor(cb / entrySize);
+	return withCells(definition, (cell, index) => {
+		const entry = index - firstCell;
+		if (entry < 0 || entry >= count) return cell;
+		return withBackground(cell, colorAt(operand, 1 + entry * entrySize));
+	});
+}
+/** Applies a TableShadeOperand ([MS-DOC] 2.9.308): cb, an ItcFirstLim naming the range, then a single Shd applied to every cell the range covers -- not one Shd per cell. `step` is 1 for sprmTSetShd and 2 for sprmTSetShdOdd, whose own range covers every other cell from itcFirst. */
+function applyTableShade(definition, operand, step) {
+	const itcFirst = require_bytes.readUint8(operand, 1);
+	const itcLim = require_bytes.readUint8(operand, 2);
+	const background = require_table_decoration.readShd(operand, 3);
+	return withCells(definition, (cell, index) => {
+		if (index < itcFirst || index >= itcLim) return cell;
+		if ((index - itcFirst) % step !== 0) return cell;
+		return withBackground(cell, background);
+	});
+}
+function applyTableSprms(prls, into) {
+	for (const prl of prls) if (prl.sprm.sgc === require_prop_sprm.SGC.table && prl.sprm.value === SPRM_T_DEF_TABLE) into.definition = readTdefTableOperand(prl.operand);
+	for (const prl of prls) {
+		if (prl.sprm.sgc !== require_prop_sprm.SGC.table) continue;
+		switch (prl.sprm.value) {
+			case SPRM_T_DEF_TABLE: break;
+			case SPRM_T_DYA_ROW_HEIGHT: {
+				const dyaRowHeight = require_bytes.readInt16LE(prl.operand, 0);
+				const heightPt = Math.abs(dyaRowHeight) / TWIPS_PER_POINT;
+				into.heightPt = heightPt > 0 ? heightPt : void 0;
+				break;
+			}
+			case SPRM_T_MERGE: {
+				if (into.definition === void 0) break;
+				const itcFirst = require_bytes.readUint8(prl.operand, 0);
+				const itcLim = require_bytes.readUint8(prl.operand, 1);
+				into.definition = withCells(into.definition, (cell, index) => {
+					if (index < itcFirst || index >= itcLim) return cell;
+					return {
+						horzMerge: index === itcFirst ? 2 : 1,
+						vertMerge: cell.vertMerge,
+						borders: cell.borders,
+						background: cell.background
+					};
+				});
+				break;
+			}
+			case SPRM_T_VERT_MERGE: {
+				if (into.definition === void 0) break;
+				const itc = require_bytes.readUint8(prl.operand, 1);
+				const vertMergeFlags = require_bytes.readUint8(prl.operand, 2);
+				into.definition = withCells(into.definition, (cell, index) => index === itc ? {
+					horzMerge: cell.horzMerge,
+					vertMerge: vertMergeFlags,
+					borders: cell.borders,
+					background: cell.background
+				} : cell);
+				break;
+			}
+			case SPRM_T_SET_BRC: {
+				if (into.definition === void 0) break;
+				const itcFirst = require_bytes.readUint8(prl.operand, 1);
+				const itcLim = require_bytes.readUint8(prl.operand, 2);
+				const bordersToApply = require_bytes.readUint8(prl.operand, 3);
+				const border = require_table_decoration.readBrc(prl.operand, 4);
+				into.definition = withCells(into.definition, (cell, index) => index < itcFirst || index >= itcLim ? cell : applyBrcToCell(cell, bordersToApply, border));
+				break;
+			}
+			case SPRM_T_DEF_TABLE_SHD:
+			case SPRM_T_DEF_TABLE_SHD_2ND:
+			case SPRM_T_DEF_TABLE_SHD_3RD:
+			case SPRM_T_DEF_TABLE_SHD_RAW:
+			case SPRM_T_DEF_TABLE_SHD_RAW_2ND:
+			case SPRM_T_DEF_TABLE_SHD_RAW_3RD: {
+				if (into.definition === void 0) break;
+				const firstCell = SHD_ARRAY_FIRST_CELL[prl.sprm.value];
+				if (firstCell === void 0) break;
+				into.definition = applyShdArray(into.definition, prl.operand, firstCell, 10, require_table_decoration.readShd);
+				break;
+			}
+			case SPRM_T_DEF_TABLE_SHD80:
+				if (into.definition === void 0) break;
+				into.definition = applyShdArray(into.definition, prl.operand, 0, 2, (operand, offset) => require_table_decoration.readShd80(require_bytes.readUint16LE(operand, offset)));
+				break;
+			case SPRM_T_SET_SHD:
+				if (into.definition === void 0) break;
+				into.definition = applyTableShade(into.definition, prl.operand, 1);
+				break;
+			case SPRM_T_SET_SHD_ODD:
+				if (into.definition === void 0) break;
+				into.definition = applyTableShade(into.definition, prl.operand, 2);
+		}
+	}
+	return into;
+}
+//#endregion
+exports.HORZ_MERGE_CONTINUATION = HORZ_MERGE_CONTINUATION;
+exports.VERT_MERGE_CONTINUATION = VERT_MERGE_CONTINUATION;
+exports.VERT_MERGE_RESTART = VERT_MERGE_RESTART;
+exports.applyTableSprms = applyTableSprms;

package/dist/table/tap.d.cts

@@ -0,0 +1,29 @@
+import { t as Prl } from "../sprm-Djg5RNiq.cjs";
+import { Color, ContentCellBorders } from "document-schema.js";
+//#region src/table/tap.d.ts
+/** TCGRF.horzMerge, [MS-DOC] 2.9.317: 0 not merged, 1 a continuation cell (contributes its layout region, its own contents are not rendered), 2 or 3 the first cell of a horizontally merged set. */
+declare const HORZ_MERGE_CONTINUATION = 1;
+/** VerticalMergeFlag's fvmMerge: TCGRF.vertMerge continuation (fvmClear=0, fvmMerge=1, fvmRestart=3 -- 2 is not a defined member). */
+declare const VERT_MERGE_CONTINUATION = 1;
+declare const VERT_MERGE_RESTART = 3;
+interface TableCellProperties {
+  readonly horzMerge: number;
+  readonly vertMerge: number;
+  /** The cell's own four borders, absent when it states none on any side. */
+  readonly borders?: ContentCellBorders;
+  /** The cell's own flat background colour, absent when it states no shading or states a pattern Color cannot express (see decoration.ts's readShd). */
+  readonly background?: Color;
+}
+interface TableRowDefinition {
+  /** rgdxaCenter, in twips: one more entry than there are physical cells in the row -- column i's width is boundaries[i + 1] - boundaries[i]. */
+  readonly columnBoundariesTwips: readonly number[];
+  /** One entry per physical cell in the row, in document order -- every physical cell the row's own cell marks delimit, horizontally- and vertically-merged-away cells included, exactly as [MS-DOC]'s own model keeps them all present. */
+  readonly cells: readonly TableCellProperties[];
+}
+interface TableRowProperties {
+  definition?: TableRowDefinition;
+  heightPt?: number;
+}
+declare function applyTableSprms(prls: readonly Prl[], into: TableRowProperties): TableRowProperties;
+//#endregion
+export { HORZ_MERGE_CONTINUATION, TableCellProperties, TableRowDefinition, TableRowProperties, VERT_MERGE_CONTINUATION, VERT_MERGE_RESTART, applyTableSprms };

package/dist/table/tap.d.ts

@@ -0,0 +1,29 @@
+import { t as Prl } from "../sprm-Djg5RNiq.js";
+import { Color, ContentCellBorders } from "document-schema.js";
+//#region src/table/tap.d.ts
+/** TCGRF.horzMerge, [MS-DOC] 2.9.317: 0 not merged, 1 a continuation cell (contributes its layout region, its own contents are not rendered), 2 or 3 the first cell of a horizontally merged set. */
+declare const HORZ_MERGE_CONTINUATION = 1;
+/** VerticalMergeFlag's fvmMerge: TCGRF.vertMerge continuation (fvmClear=0, fvmMerge=1, fvmRestart=3 -- 2 is not a defined member). */
+declare const VERT_MERGE_CONTINUATION = 1;
+declare const VERT_MERGE_RESTART = 3;
+interface TableCellProperties {
+  readonly horzMerge: number;
+  readonly vertMerge: number;
+  /** The cell's own four borders, absent when it states none on any side. */
+  readonly borders?: ContentCellBorders;
+  /** The cell's own flat background colour, absent when it states no shading or states a pattern Color cannot express (see decoration.ts's readShd). */
+  readonly background?: Color;
+}
+interface TableRowDefinition {
+  /** rgdxaCenter, in twips: one more entry than there are physical cells in the row -- column i's width is boundaries[i + 1] - boundaries[i]. */
+  readonly columnBoundariesTwips: readonly number[];
+  /** One entry per physical cell in the row, in document order -- every physical cell the row's own cell marks delimit, horizontally- and vertically-merged-away cells included, exactly as [MS-DOC]'s own model keeps them all present. */
+  readonly cells: readonly TableCellProperties[];
+}
+interface TableRowProperties {
+  definition?: TableRowDefinition;
+  heightPt?: number;
+}
+declare function applyTableSprms(prls: readonly Prl[], into: TableRowProperties): TableRowProperties;
+//#endregion
+export { HORZ_MERGE_CONTINUATION, TableCellProperties, TableRowDefinition, TableRowProperties, VERT_MERGE_CONTINUATION, VERT_MERGE_RESTART, applyTableSprms };

package/dist/table/tap.js

@@ -0,0 +1,213 @@
+import { readInt16LE, readUint16LE, readUint8 } from "../bytes.js";
+import { SGC } from "../prop/sprm.js";
+import { BORDERS_TO_APPLY, CELL_BORDER_SIDES, cellBordersFrom, readBrc, readBrc80, readShd, readShd80 } from "./decoration.js";
+//#region src/table/tap.ts
+const SPRM_T_DEF_TABLE = 54792;
+const SPRM_T_DYA_ROW_HEIGHT = 37895;
+/** sprmTMerge: an ItcFirstLim naming a range of cells to horizontally merge, the first cell becoming the anchor -- a spec-conformant mechanism this reader still honours for a genuine third-party producer, even though this package's own writer no longer emits it (see this module's own top-of-file note and table/write.ts's). */
+const SPRM_T_MERGE = 22052;
+/** sprmTVertMerge (0xD62B): a VertMergeOperand naming one cell (itc) and its own VerticalMergeFlag, the incremental per-cell equivalent of sprmTMerge for a vertical merge. */
+const SPRM_T_VERT_MERGE = 54827;
+/** sprmTSetBrc (0xD62F): a TableBrcOperand ([MS-DOC] 2.9.305) restating one cell range's borders on the named sides, with an exact COLORREF rather than TC80's own Ico index. */
+const SPRM_T_SET_BRC = 54831;
+/** sprmTDefTableShd80 (0xD609): a DefTableShd80Operand ([MS-DOC] 2.9.52), the Word 97-era array of one Shd80 per cell starting at the row's first. */
+const SPRM_T_DEF_TABLE_SHD80 = 54793;
+/** sprmTDefTableShd3rd (0xD60C): a DefTableShdOperand ([MS-DOC] 2.9.53) shading cells 45-63 -- index 44 onward. */
+const SPRM_T_DEF_TABLE_SHD_3RD = 54796;
+/** sprmTDefTableShd (0xD612): a DefTableShdOperand shading cells 1-22 -- index 0 onward. */
+const SPRM_T_DEF_TABLE_SHD = 54802;
+/** sprmTDefTableShd2nd (0xD616): a DefTableShdOperand shading cells 23-44 -- index 22 onward. */
+const SPRM_T_DEF_TABLE_SHD_2ND = 54806;
+/** sprmTSetShd (0xD62D): a TableShadeOperand ([MS-DOC] 2.9.308) shading one ItcFirstLim cell range. */
+const SPRM_T_SET_SHD = 54829;
+/** sprmTSetShdOdd (0xD62E): the same TableShadeOperand, applied to every other cell of the range starting at itcFirst -- [MS-DOC] 2.6.3's own worked example, "if the set of cells is 0 through 5, then this sets the background shading for cells 0, 2 and 4". */
+const SPRM_T_SET_SHD_ODD = 54830;
+/** sprmTDefTableShdRaw/Raw2nd/Raw3rd (0xD670-0xD672): the same three DefTableShdOperand arrays, differing from the sprms above only in how ShdNil is treated inside a table style -- which this package neither reads nor writes, so all six resolve identically here. A real producer (LibreOffice) writes both families for the same row. */
+const SPRM_T_DEF_TABLE_SHD_RAW = 54896;
+const SPRM_T_DEF_TABLE_SHD_RAW_2ND = 54897;
+const SPRM_T_DEF_TABLE_SHD_RAW_3RD = 54898;
+/** The first cell index each of the three DefTableShdOperand sprms shades, [MS-DOC] 2.6.3: "Cells 1 - 22 are shaded by sprmTDefTableShd, and cells 23 - 44 are shaded by sprmTDefTableShd2nd" and 45-63 by the third -- one-based there, so zero-based here. */
+const SHD_ARRAY_FIRST_CELL = {
+	[SPRM_T_DEF_TABLE_SHD]: 0,
+	[SPRM_T_DEF_TABLE_SHD_RAW]: 0,
+	[SPRM_T_DEF_TABLE_SHD_2ND]: 22,
+	[SPRM_T_DEF_TABLE_SHD_RAW_2ND]: 22,
+	[SPRM_T_DEF_TABLE_SHD_3RD]: 44,
+	[SPRM_T_DEF_TABLE_SHD_RAW_3RD]: 44
+};
+const TWIPS_PER_POINT = 20;
+/** TC80's own fixed size, [MS-DOC] 2.9.313: tcgrf (2) + wWidth (2) + brcTop/brcLeft/brcBottom/brcRight (4 each). */
+const TC80_SIZE = 20;
+/** The offset of TC80's own first border field, brcTop, past tcgrf and wWidth. The four follow it back to back in CELL_BORDER_SIDES order. */
+const TC80_BORDERS_OFFSET = 4;
+/** TCGRF.horzMerge, [MS-DOC] 2.9.317: 0 not merged, 1 a continuation cell (contributes its layout region, its own contents are not rendered), 2 or 3 the first cell of a horizontally merged set. */
+const HORZ_MERGE_CONTINUATION = 1;
+/** VerticalMergeFlag's fvmMerge: TCGRF.vertMerge continuation (fvmClear=0, fvmMerge=1, fvmRestart=3 -- 2 is not a defined member). */
+const VERT_MERGE_CONTINUATION = 1;
+const VERT_MERGE_RESTART = 3;
+function readTdefTableOperand(operand) {
+	const numberOfColumns = readUint8(operand, 2);
+	const boundariesStart = 3;
+	const columnBoundariesTwips = [];
+	for (let index = 0; index <= numberOfColumns; index += 1) columnBoundariesTwips.push(readInt16LE(operand, boundariesStart + index * 2));
+	const tc80Start = boundariesStart + (numberOfColumns + 1) * 2;
+	const cells = [];
+	for (let index = 0; index < numberOfColumns; index += 1) {
+		const tc80Offset = tc80Start + index * TC80_SIZE;
+		if (tc80Offset + TC80_SIZE > operand.length) {
+			cells.push({
+				horzMerge: 0,
+				vertMerge: 0
+			});
+			continue;
+		}
+		const tcgrf = readUint16LE(operand, tc80Offset);
+		const sides = {
+			top: void 0,
+			left: void 0,
+			bottom: void 0,
+			right: void 0
+		};
+		CELL_BORDER_SIDES.forEach((side, sideIndex) => {
+			sides[side] = readBrc80(operand, tc80Offset + TC80_BORDERS_OFFSET + sideIndex * 4);
+		});
+		cells.push({
+			horzMerge: tcgrf & 3,
+			vertMerge: tcgrf >> 5 & 3,
+			borders: cellBordersFrom(sides)
+		});
+	}
+	return {
+		columnBoundariesTwips,
+		cells
+	};
+}
+/** Replaces one cell's own entry in a definition, keeping every other cell and the row's boundaries untouched -- the shape every incremental sprm below folds through, so none of them has to restate how a definition is rebuilt. */
+function withCells(definition, next) {
+	return {
+		columnBoundariesTwips: definition.columnBoundariesTwips,
+		cells: definition.cells.map(next)
+	};
+}
+/** Overlays the sides one TableBrcOperand names onto a cell's existing borders, leaving every side it does not name as TC80's own Brc80 stated it. A named side whose Brc is a NilBrc removes that side's border, which is how a producer states "this cell has no top border" over a row-level one it would otherwise inherit. */
+function applyBrcToCell(cell, bordersToApply, border) {
+	const sides = {
+		top: cell.borders?.top,
+		left: cell.borders?.left,
+		bottom: cell.borders?.bottom,
+		right: cell.borders?.right
+	};
+	for (const side of CELL_BORDER_SIDES) if ((bordersToApply & BORDERS_TO_APPLY[side]) !== 0) sides[side] = border;
+	return {
+		horzMerge: cell.horzMerge,
+		vertMerge: cell.vertMerge,
+		borders: cellBordersFrom(sides),
+		background: cell.background
+	};
+}
+function withBackground(cell, background) {
+	return {
+		horzMerge: cell.horzMerge,
+		vertMerge: cell.vertMerge,
+		borders: cell.borders,
+		background
+	};
+}
+/** Applies a DefTableShdOperand's ([MS-DOC] 2.9.53) rgShd array from `firstCell` onward. The array carries "only ... elements necessary to define all shaded cells in the row", so cells past its end keep whatever an earlier sprm left them -- an entry that is present and states ShdAuto/ShdNil genuinely clears its own cell, which is how a real producer's full-length array turns a row's unshaded cells back off. */
+function applyShdArray(definition, operand, firstCell, entrySize, colorAt) {
+	const cb = readUint8(operand, 0);
+	const count = Math.floor(cb / entrySize);
+	return withCells(definition, (cell, index) => {
+		const entry = index - firstCell;
+		if (entry < 0 || entry >= count) return cell;
+		return withBackground(cell, colorAt(operand, 1 + entry * entrySize));
+	});
+}
+/** Applies a TableShadeOperand ([MS-DOC] 2.9.308): cb, an ItcFirstLim naming the range, then a single Shd applied to every cell the range covers -- not one Shd per cell. `step` is 1 for sprmTSetShd and 2 for sprmTSetShdOdd, whose own range covers every other cell from itcFirst. */
+function applyTableShade(definition, operand, step) {
+	const itcFirst = readUint8(operand, 1);
+	const itcLim = readUint8(operand, 2);
+	const background = readShd(operand, 3);
+	return withCells(definition, (cell, index) => {
+		if (index < itcFirst || index >= itcLim) return cell;
+		if ((index - itcFirst) % step !== 0) return cell;
+		return withBackground(cell, background);
+	});
+}
+function applyTableSprms(prls, into) {
+	for (const prl of prls) if (prl.sprm.sgc === SGC.table && prl.sprm.value === SPRM_T_DEF_TABLE) into.definition = readTdefTableOperand(prl.operand);
+	for (const prl of prls) {
+		if (prl.sprm.sgc !== SGC.table) continue;
+		switch (prl.sprm.value) {
+			case SPRM_T_DEF_TABLE: break;
+			case SPRM_T_DYA_ROW_HEIGHT: {
+				const dyaRowHeight = readInt16LE(prl.operand, 0);
+				const heightPt = Math.abs(dyaRowHeight) / TWIPS_PER_POINT;
+				into.heightPt = heightPt > 0 ? heightPt : void 0;
+				break;
+			}
+			case SPRM_T_MERGE: {
+				if (into.definition === void 0) break;
+				const itcFirst = readUint8(prl.operand, 0);
+				const itcLim = readUint8(prl.operand, 1);
+				into.definition = withCells(into.definition, (cell, index) => {
+					if (index < itcFirst || index >= itcLim) return cell;
+					return {
+						horzMerge: index === itcFirst ? 2 : 1,
+						vertMerge: cell.vertMerge,
+						borders: cell.borders,
+						background: cell.background
+					};
+				});
+				break;
+			}
+			case SPRM_T_VERT_MERGE: {
+				if (into.definition === void 0) break;
+				const itc = readUint8(prl.operand, 1);
+				const vertMergeFlags = readUint8(prl.operand, 2);
+				into.definition = withCells(into.definition, (cell, index) => index === itc ? {
+					horzMerge: cell.horzMerge,
+					vertMerge: vertMergeFlags,
+					borders: cell.borders,
+					background: cell.background
+				} : cell);
+				break;
+			}
+			case SPRM_T_SET_BRC: {
+				if (into.definition === void 0) break;
+				const itcFirst = readUint8(prl.operand, 1);
+				const itcLim = readUint8(prl.operand, 2);
+				const bordersToApply = readUint8(prl.operand, 3);
+				const border = readBrc(prl.operand, 4);
+				into.definition = withCells(into.definition, (cell, index) => index < itcFirst || index >= itcLim ? cell : applyBrcToCell(cell, bordersToApply, border));
+				break;
+			}
+			case SPRM_T_DEF_TABLE_SHD:
+			case SPRM_T_DEF_TABLE_SHD_2ND:
+			case SPRM_T_DEF_TABLE_SHD_3RD:
+			case SPRM_T_DEF_TABLE_SHD_RAW:
+			case SPRM_T_DEF_TABLE_SHD_RAW_2ND:
+			case SPRM_T_DEF_TABLE_SHD_RAW_3RD: {
+				if (into.definition === void 0) break;
+				const firstCell = SHD_ARRAY_FIRST_CELL[prl.sprm.value];
+				if (firstCell === void 0) break;
+				into.definition = applyShdArray(into.definition, prl.operand, firstCell, 10, readShd);
+				break;
+			}
+			case SPRM_T_DEF_TABLE_SHD80:
+				if (into.definition === void 0) break;
+				into.definition = applyShdArray(into.definition, prl.operand, 0, 2, (operand, offset) => readShd80(readUint16LE(operand, offset)));
+				break;
+			case SPRM_T_SET_SHD:
+				if (into.definition === void 0) break;
+				into.definition = applyTableShade(into.definition, prl.operand, 1);
+				break;
+			case SPRM_T_SET_SHD_ODD:
+				if (into.definition === void 0) break;
+				into.definition = applyTableShade(into.definition, prl.operand, 2);
+		}
+	}
+	return into;
+}
+//#endregion
+export { HORZ_MERGE_CONTINUATION, VERT_MERGE_CONTINUATION, VERT_MERGE_RESTART, applyTableSprms };

package/dist/table/write.cjs

@@ -0,0 +1,136 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+require("../text/special.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". */
+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 pushSprm(bytes, opcode, operand) {
+	bytes.push(opcode & 255, opcode >> 8 & 255, ...operand);
+}
+function inTableGrpprl() {
+	const bytes = [];
+	pushSprm(bytes, SPRM_P_F_IN_TABLE, [1]);
+	return bytes;
+}
+function rowMarkExtraGrpprl(boundaries, cellsToWrite, heightPt) {
+	const bytes = inTableGrpprl();
+	pushSprm(bytes, SPRM_P_F_TTP, [1]);
+	bytes.push(...require_table_tap_write.encodeTableRowGrpprl(boundaries, cellsToWrite, heightPt));
+	return bytes;
+}
+function cellParagraphs(blocks) {
+	if (blocks.length === 0) return [{
+		runs: [],
+		properties: {},
+		extraGrpprl: inTableGrpprl(),
+		terminator: 7
+	}];
+	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,
+			properties: block,
+			extraGrpprl: inTableGrpprl(),
+			terminator: index === blocks.length - 1 ? 7 : 13
+		};
+	});
+}
+function columnBoundariesTwips(columnWidthsPt) {
+	const boundaries = [0];
+	let cumulative = 0;
+	for (const widthPt of columnWidthsPt) {
+		cumulative += widthPt * TWIPS_PER_POINT;
+		boundaries.push(cumulative);
+	}
+	return boundaries;
+}
+function flattenRow(cells, columnCount, boundaries, active) {
+	const paragraphs = [];
+	const cellsToWrite = [];
+	const firstBoundary = boundaries[0];
+	if (firstBoundary === void 0) throw new require_errors.DocFormatError("internal defect: a table's own column-boundary array is empty despite the columnCount guard above");
+	const rowBoundariesTwips = [firstBoundary];
+	let column = 0;
+	for (const cell of cells) {
+		const covered = active.get(column);
+		const isContinuation = cell.blocks.length === 0 && covered !== void 0 && covered.remaining > 0;
+		let span;
+		let vertMerge;
+		let blocks;
+		if (isContinuation) {
+			covered.remaining -= 1;
+			span = covered.span;
+			vertMerge = 1;
+			blocks = [];
+		} else {
+			span = cell.colSpan ?? 1;
+			const rowSpan = cell.rowSpan ?? 1;
+			vertMerge = rowSpan > 1 ? 3 : 0;
+			if (rowSpan > 1) active.set(column, {
+				span,
+				remaining: rowSpan - 1
+			});
+			blocks = cell.blocks;
+		}
+		paragraphs.push(...cellParagraphs(blocks));
+		cellsToWrite.push(isContinuation ? { vertMerge } : {
+			vertMerge,
+			borders: cell.borders,
+			background: cell.background
+		});
+		column += span;
+		const rightBoundary = boundaries[column];
+		if (rightBoundary === void 0) throw new require_errors.DocFormatError(`a table cell's own colSpan runs past the table's ${columnCount}-column grid`);
+		rowBoundariesTwips.push(rightBoundary);
+	}
+	if (column !== columnCount) throw new require_errors.DocFormatError(`a table row's own cells cover ${column} columns (via colSpan), but the table declares ${columnCount} in columnWidthsPt`);
+	return {
+		paragraphs,
+		cellsToWrite,
+		rowBoundariesTwips
+	};
+}
+function flattenTable(table) {
+	const columnCount = table.columnWidthsPt.length;
+	if (columnCount === 0 || table.rows.length === 0) throw new require_errors.DocFormatError("a table must have at least one column and one row to write");
+	const boundaries = columnBoundariesTwips(table.columnWidthsPt);
+	const active = /* @__PURE__ */ new Map();
+	const output = [];
+	for (const row of table.rows) {
+		const { paragraphs, cellsToWrite, rowBoundariesTwips } = flattenRow(row.cells, columnCount, boundaries, active);
+		output.push(...paragraphs);
+		output.push({
+			runs: [],
+			properties: {},
+			extraGrpprl: rowMarkExtraGrpprl(rowBoundariesTwips, cellsToWrite, row.heightPt),
+			terminator: 7
+		});
+	}
+	return output;
+}
+function flattenSectionBlocks(blocks) {
+	const output = [];
+	for (const block of blocks) {
+		if (block.kind === "paragraph") {
+			output.push({
+				runs: block.runs,
+				properties: block,
+				extraGrpprl: [],
+				terminator: 13
+			});
+			continue;
+		}
+		if (block.kind === "table") {
+			output.push(...flattenTable(block));
+			continue;
+		}
+		throw new require_errors.DocUnsupportedError(`doc-codec's writer does not yet support '${block.kind}' blocks (see README's scope note)`);
+	}
+	return output;
+}
+//#endregion
+exports.flattenSectionBlocks = flattenSectionBlocks;

package/dist/table/write.d.cts

@@ -0,0 +1,13 @@
+import { ContentBlock, ContentParagraph, ContentRun } from "document-schema.js";
+//#region src/table/write.d.ts
+interface WriteParagraph {
+  readonly runs: readonly ContentRun[];
+  readonly properties: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore">;
+  /** 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[]): WriteParagraph[];
+//#endregion
+export { WriteParagraph, flattenSectionBlocks };

package/dist/table/write.d.ts

@@ -0,0 +1,13 @@
+import { ContentBlock, ContentParagraph, ContentRun } from "document-schema.js";
+//#region src/table/write.d.ts
+interface WriteParagraph {
+  readonly runs: readonly ContentRun[];
+  readonly properties: Pick<ContentParagraph, "alignment" | "indentLeftPt" | "indentFirstLinePt" | "spacingBeforePt" | "spacingAfterPt" | "lineSpacing" | "pageBreakBefore">;
+  /** 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[]): WriteParagraph[];
+//#endregion
+export { WriteParagraph, flattenSectionBlocks };