ppt-codec 1.5.0 → 1.6.0

package/dist/drawing/shapes-write.cjs

@@ -3,9 +3,13 @@ const require_record_types = require("../record/types.cjs");
 const require_text_atoms = require("../text/atoms.cjs");
 const require_units = require("../units.cjs");
 const require_content_write = require("../content-write.cjs");
+const require_diagnostics = require("../diagnostics.cjs");
 const require_record_write = require("../record/write.cjs");
+const require_drawing_blips = require("./blips.cjs");
+const require_drawing_properties = require("./properties.cjs");
 const require_text_style_write = require("../text/style-write.cjs");
 //#region src/drawing/shapes-write.ts
+const FSP_CHILD = 2;
 const PATRIARCH_SPID = 1;
 const FIRST_CONTENT_SPID = 2;
 function writeFsp(spid, flags) {
@@ -21,9 +25,22 @@ function writeClientAnchor(xPt, yPt, widthPt, heightPt) {
 function writeTextCharsAtom(text) {
 	return require_record_write.writeAtom(require_record_types.RT_TextCharsAtom, require_record_write.utf16le(text));
 }
-function writeClientTextbox(shape, fontIndexOf) {
-	if (!shape.blocks.some((block) => block.kind === "paragraph")) return;
-	const { text, style } = require_content_write.buildTextBody(shape.blocks, fontIndexOf);
+function writeShapeProperties(shape, pib) {
+	const entries = [];
+	if (shape.rotationDeg !== void 0) entries.push({
+		opid: 4,
+		op: require_drawing_properties.degreesToFixedPoint(shape.rotationDeg)
+	});
+	if (pib !== void 0) entries.push({
+		opid: 260,
+		op: pib,
+		fBid: true
+	});
+	return entries.length === 0 ? void 0 : require_drawing_properties.writeShapePropertyTable(require_record_types.OfficeArtFOPT, entries);
+}
+function writeClientTextbox(textBlocks, fontIndexOf) {
+	if (textBlocks.length === 0) return;
+	const { text, style } = require_content_write.buildTextBody(textBlocks, fontIndexOf);
 	const totalParagraphCount = style.paragraphRuns.reduce((sum, run) => sum + run.count, 0);
 	if (totalParagraphCount !== require_text_atoms.characterCountOf(text)) throw new Error(`internal error: built ${totalParagraphCount} characters of paragraph runs for a ${require_text_atoms.characterCountOf(text)}-character text body`);
 	return require_record_write.writeContainer(require_record_types.OfficeArtClientTextbox, [
@@ -32,9 +49,12 @@ function writeClientTextbox(shape, fontIndexOf) {
 		require_text_style_write.writeStyleTextPropAtom(style)
 	]);
 }
-function writeShape(spid, shape, fontIndexOf, clientData) {
-	const clientTextbox = writeClientTextbox(shape, fontIndexOf);
-	const children = [writeFsp(spid, 0), writeClientAnchor(shape.frame.xPt, shape.frame.yPt, shape.frame.widthPt, shape.frame.heightPt)];
+function writeShape(spid, shape, pib, textBlocks, fontIndexOf, clientData) {
+	const properties = writeShapeProperties(shape, pib);
+	const clientTextbox = writeClientTextbox(textBlocks, fontIndexOf);
+	const children = [writeFsp(spid, 0)];
+	if (properties !== void 0) children.push(properties);
+	children.push(writeClientAnchor(shape.frame.xPt, shape.frame.yPt, shape.frame.widthPt, shape.frame.heightPt));
 	if (clientData !== void 0) children.push(clientData);
 	if (clientTextbox !== void 0) children.push(clientTextbox);
 	return require_record_write.writeContainer(require_record_types.OfficeArtSpContainer, children);
@@ -42,19 +62,186 @@ function writeShape(spid, shape, fontIndexOf, clientData) {
 function writePatriarch() {
 	return require_record_write.writeContainer(require_record_types.OfficeArtSpContainer, [require_record_write.writeAtom(require_record_types.OfficeArtFSPGR, /* @__PURE__ */ new Uint8Array(16), { recVer: 1 }), writeFsp(PATRIARCH_SPID, 5)]);
 }
-function writeDrawing(shapes, fontIndexOf) {
-	const shapeContainers = shapes.map((entry, index) => writeShape(FIRST_CONTENT_SPID + index, entry.shape, fontIndexOf, entry.clientData));
-	return require_record_write.writeContainer(require_record_types.RT_Drawing, [require_record_write.writeContainer(require_record_types.OfficeArtDgContainer, [require_record_write.writeContainer(require_record_types.OfficeArtSpgrContainer, [writePatriarch(), ...shapeContainers])])]);
+function planShapeBlocks(blocks, context) {
+	const textBlocks = [];
+	let pib;
+	let table;
+	const drop = (block, reason) => {
+		context.sink({
+			code: require_diagnostics.PptDiagnosticCodes.BLOCK_DROPPED,
+			severity: "warning",
+			message: `${context.location}: ${reason}`
+		});
+	};
+	for (const block of blocks) {
+		if (block.kind === "paragraph") {
+			textBlocks.push(block);
+			continue;
+		}
+		if (block.kind === "image") {
+			if (!require_drawing_blips.isBlipFormat(block.format)) {
+				context.sink({
+					code: require_diagnostics.PptDiagnosticCodes.IMAGE_DROPPED,
+					severity: "warning",
+					message: `${context.location}: an image block in format '${block.format}' is dropped; MSOBLIPTYPE gives this writer a blip record for PNG and JPEG only`
+				});
+				continue;
+			}
+			if (pib !== void 0) {
+				context.sink({
+					code: require_diagnostics.PptDiagnosticCodes.IMAGE_DROPPED,
+					severity: "warning",
+					message: `${context.location}: a second image block is dropped; a shape carries exactly one blip-store reference, and an earlier image already consumed it`
+				});
+				continue;
+			}
+			pib = context.blipIndexOf(block);
+			continue;
+		}
+		if (block.kind === "table") {
+			if (table !== void 0) {
+				drop(block, "a second 'table' block is dropped; a shape becomes one table group, and an earlier table already did");
+				continue;
+			}
+			table = block;
+			continue;
+		}
+		drop(block, `a '${block.kind}' block is dropped; this writer produces no [MS-PPT] spelling for it`);
+	}
+	if (table !== void 0) {
+		for (const block of textBlocks) drop(block, "a 'paragraph' block is dropped; a shape carrying a table becomes a table group, which holds its text in cells rather than a text body of its own");
+		if (pib !== void 0) context.sink({
+			code: require_diagnostics.PptDiagnosticCodes.IMAGE_DROPPED,
+			severity: "warning",
+			message: `${context.location}: an image block is dropped; a shape carrying a table becomes a table group, which has no blip reference of its own`
+		});
+		return {
+			pib: void 0,
+			textBlocks: [],
+			table
+		};
+	}
+	return {
+		pib,
+		textBlocks,
+		table
+	};
+}
+function tableRowHeights(table, frameHeightMasterUnits) {
+	const stated = table.rows.map((row) => row.heightPt === void 0 ? void 0 : require_units.pointsToMasterUnits(row.heightPt));
+	const unstatedCount = stated.filter((height) => height === void 0).length;
+	if (unstatedCount === 0) return stated.map((height) => {
+		if (height === void 0) throw new Error("internal error: a stated row height became unstated in the same pass");
+		return height;
+	});
+	const remaining = frameHeightMasterUnits - stated.reduce((sum, height) => sum + (height ?? 0), 0);
+	const shared = Math.max(1, Math.round(remaining / unstatedCount));
+	return stated.map((height) => height ?? shared);
+}
+function writeTableGroup(spid, shape, table, context) {
+	const { frame } = shape;
+	const rowHeights = tableRowHeights(table, require_units.pointsToMasterUnits(frame.heightPt));
+	const declaredWidths = table.columnWidthsPt.map(require_units.pointsToMasterUnits);
+	const cellCount = Math.max(1, ...table.rows.map((row) => row.cells.length), declaredWidths.length);
+	const lastDeclared = declaredWidths.at(-1);
+	const equalShare = Math.max(1, Math.round(require_units.pointsToMasterUnits(frame.widthPt) / cellCount));
+	const columnWidthsMasterUnits = Array.from({ length: cellCount }, (_, index) => declaredWidths[index] ?? lastDeclared ?? equalShare);
+	const columnBoundaries = [];
+	let columnEdge = require_units.pointsToMasterUnits(frame.xPt);
+	for (const width of columnWidthsMasterUnits) {
+		columnBoundaries.push(columnEdge);
+		columnEdge += width;
+	}
+	columnBoundaries.push(columnEdge);
+	const rowBoundaries = [];
+	let rowEdge = require_units.pointsToMasterUnits(frame.yPt);
+	for (const height of rowHeights) {
+		rowBoundaries.push(rowEdge);
+		rowEdge += height;
+	}
+	rowBoundaries.push(rowEdge);
+	const rowHeightsPayload = require_drawing_properties.writeIMsoArray(rowHeights, 4);
+	const tableLeft = require_units.pointsToMasterUnits(frame.xPt);
+	const tableTop = require_units.pointsToMasterUnits(frame.yPt);
+	const tableRight = require_units.pointsToMasterUnits(frame.xPt + frame.widthPt);
+	const tableBottom = require_units.pointsToMasterUnits(frame.yPt + frame.heightPt);
+	const groupShape = require_record_write.writeContainer(require_record_types.OfficeArtSpContainer, [
+		require_record_write.writeAtom(require_record_types.OfficeArtFSPGR, require_record_write.concatBytes(require_record_write.i32le(tableLeft), require_record_write.i32le(tableTop), require_record_write.i32le(tableRight), require_record_write.i32le(tableBottom)), { recVer: 1 }),
+		writeFsp(spid, 513),
+		...shape.rotationDeg === void 0 ? [] : [require_drawing_properties.writeShapePropertyTable(require_record_types.OfficeArtFOPT, [{
+			opid: 4,
+			op: require_drawing_properties.degreesToFixedPoint(shape.rotationDeg)
+		}])],
+		require_drawing_properties.writeShapePropertyTable(require_record_types.OfficeArtTertiaryFOPT, [{
+			opid: 927,
+			op: 1
+		}, {
+			opid: 928,
+			op: rowHeightsPayload.length,
+			fBid: true,
+			complex: rowHeightsPayload
+		}]),
+		writeClientAnchor(frame.xPt, frame.yPt, frame.widthPt, frame.heightPt)
+	]);
+	let cellSpid = spid + 1;
+	const cellShapes = table.rows.flatMap((row, rowIndex) => row.cells.map((cell, columnIndex) => {
+		const cellLeft = columnBoundaries[columnIndex];
+		const cellRight = columnBoundaries[columnIndex + 1];
+		const cellTop = rowBoundaries[rowIndex];
+		const cellBottom = rowBoundaries[rowIndex + 1];
+		if (cellLeft === void 0 || cellRight === void 0 || cellTop === void 0 || cellBottom === void 0) throw new Error("internal error: a table cell sits outside the grid boundaries derived from its own table");
+		if (cell.colSpan !== void 0 && cell.colSpan > 1) context.sink({
+			code: require_diagnostics.PptDiagnosticCodes.TABLE_SPAN_DROPPED,
+			severity: "warning",
+			message: `${context.location}: a table cell's colSpan ${String(cell.colSpan)} is dropped; a PowerPoint 97-2003 table is a strict grid of shapes with no merge records, so the cell is written one column wide`
+		});
+		if (cell.rowSpan !== void 0 && cell.rowSpan > 1) context.sink({
+			code: require_diagnostics.PptDiagnosticCodes.TABLE_SPAN_DROPPED,
+			severity: "warning",
+			message: `${context.location}: a table cell's rowSpan ${String(cell.rowSpan)} is dropped; a PowerPoint 97-2003 table is a strict grid of shapes with no merge records, so the cell is written one row tall`
+		});
+		const paragraphs = cell.blocks.filter((block) => block.kind === "paragraph");
+		for (const block of cell.blocks) if (block.kind !== "paragraph") context.sink({
+			code: require_diagnostics.PptDiagnosticCodes.BLOCK_DROPPED,
+			severity: "warning",
+			message: `${context.location}: a '${block.kind}' block inside a table cell is dropped; a table cell in this format is a plain text-box shape with no property table or object reference of its own`
+		});
+		const textbox = writeClientTextbox(paragraphs, context.fontIndexOf);
+		const children = [writeFsp(cellSpid, FSP_CHILD), require_record_write.writeAtom(require_record_types.OfficeArtChildAnchor, require_record_write.concatBytes(require_record_write.i32le(cellLeft), require_record_write.i32le(cellTop), require_record_write.i32le(cellRight), require_record_write.i32le(cellBottom)))];
+		cellSpid += 1;
+		if (textbox !== void 0) children.push(textbox);
+		return require_record_write.writeContainer(require_record_types.OfficeArtSpContainer, children);
+	}));
+	return {
+		bytes: require_record_write.writeContainer(require_record_types.OfficeArtSpgrContainer, [groupShape, ...cellShapes]),
+		shapeCount: 1 + table.rows.reduce((sum, row) => sum + row.cells.length, 0)
+	};
 }
-function writeSlideDrawing(shapes, fontIndexOf) {
-	return writeDrawing(shapes.map((shape) => ({
-		shape,
-		clientData: void 0
-	})), fontIndexOf);
+function writeDrawing(shapes, context) {
+	let nextSpid = FIRST_CONTENT_SPID;
+	let shapeCount = 1;
+	const shapeContainers = [];
+	for (const entry of shapes) {
+		const plan = planShapeBlocks(entry.shape.blocks, context);
+		if (plan.table !== void 0) {
+			const group = writeTableGroup(nextSpid, entry.shape, plan.table, context);
+			nextSpid += group.shapeCount;
+			shapeCount += group.shapeCount;
+			shapeContainers.push(group.bytes);
+			continue;
+		}
+		shapeContainers.push(writeShape(nextSpid, entry.shape, plan.pib, plan.textBlocks, context.fontIndexOf, entry.clientData));
+		nextSpid += 1;
+		shapeCount += 1;
+	}
+	return {
+		bytes: require_record_write.writeContainer(require_record_types.RT_Drawing, [require_record_write.writeContainer(require_record_types.OfficeArtDgContainer, [require_record_write.writeContainer(require_record_types.OfficeArtSpgrContainer, [writePatriarch(), ...shapeContainers])])]),
+		shapeCount,
+		maxSpid: Math.max(PATRIARCH_SPID, nextSpid - 1)
+	};
 }
-function writeDrawingWithClientData(shapes, fontIndexOf) {
-	return writeDrawing(shapes, fontIndexOf);
+function writeSlideDrawing(shapes, context) {
+	return writeDrawing(shapes, context);
 }
 //#endregion
-exports.writeDrawingWithClientData = writeDrawingWithClientData;
 exports.writeSlideDrawing = writeSlideDrawing;

package/dist/drawing/shapes-write.d.cts

@@ -1,10 +1,21 @@
-import { ContentShape } from "document-schema.js";
+import { a as PptDiagnosticSink } from "../diagnostics-CqxAnubw.cjs";
+import { ContentImageBlock, ContentShape } from "document-schema.js";
 //#region src/drawing/shapes-write.d.ts
 interface DrawingShape {
   readonly shape: ContentShape;
   readonly clientData: Uint8Array<ArrayBuffer> | undefined;
 }
-declare function writeSlideDrawing(shapes: readonly ContentShape[], fontIndexOf: (family: string) => number): Uint8Array<ArrayBuffer>;
-declare function writeDrawingWithClientData(shapes: readonly DrawingShape[], fontIndexOf: (family: string) => number): Uint8Array<ArrayBuffer>;
+interface DrawingWritten {
+  readonly bytes: Uint8Array<ArrayBuffer>;
+  readonly shapeCount: number;
+  readonly maxSpid: number;
+}
+interface DrawingWriteContext {
+  readonly fontIndexOf: (family: string) => number;
+  readonly blipIndexOf: (image: ContentImageBlock) => number;
+  readonly sink: PptDiagnosticSink;
+  readonly location: string;
+}
+declare function writeSlideDrawing(shapes: readonly DrawingShape[], context: DrawingWriteContext): DrawingWritten;
 //#endregion
-export { DrawingShape, writeDrawingWithClientData, writeSlideDrawing };
+export { DrawingShape, DrawingWriteContext, DrawingWritten, writeSlideDrawing };

package/dist/drawing/shapes-write.d.ts

@@ -1,10 +1,21 @@
-import { ContentShape } from "document-schema.js";
+import { a as PptDiagnosticSink } from "../diagnostics-CqxAnubw.js";
+import { ContentImageBlock, ContentShape } from "document-schema.js";
 //#region src/drawing/shapes-write.d.ts
 interface DrawingShape {
   readonly shape: ContentShape;
   readonly clientData: Uint8Array<ArrayBuffer> | undefined;
 }
-declare function writeSlideDrawing(shapes: readonly ContentShape[], fontIndexOf: (family: string) => number): Uint8Array<ArrayBuffer>;
-declare function writeDrawingWithClientData(shapes: readonly DrawingShape[], fontIndexOf: (family: string) => number): Uint8Array<ArrayBuffer>;
+interface DrawingWritten {
+  readonly bytes: Uint8Array<ArrayBuffer>;
+  readonly shapeCount: number;
+  readonly maxSpid: number;
+}
+interface DrawingWriteContext {
+  readonly fontIndexOf: (family: string) => number;
+  readonly blipIndexOf: (image: ContentImageBlock) => number;
+  readonly sink: PptDiagnosticSink;
+  readonly location: string;
+}
+declare function writeSlideDrawing(shapes: readonly DrawingShape[], context: DrawingWriteContext): DrawingWritten;
 //#endregion
-export { DrawingShape, writeDrawingWithClientData, writeSlideDrawing };
+export { DrawingShape, DrawingWriteContext, DrawingWritten, writeSlideDrawing };

package/dist/drawing/shapes-write.js

@@ -1,10 +1,14 @@
-import { OfficeArtClientAnchor, OfficeArtClientTextbox, OfficeArtDgContainer, OfficeArtFSP, OfficeArtFSPGR, OfficeArtSpContainer, OfficeArtSpgrContainer, RT_Drawing, RT_TextCharsAtom, RT_TextHeaderAtom } from "../record/types.js";
+import { OfficeArtChildAnchor, OfficeArtClientAnchor, OfficeArtClientTextbox, OfficeArtDgContainer, OfficeArtFOPT, OfficeArtFSP, OfficeArtFSPGR, OfficeArtSpContainer, OfficeArtSpgrContainer, OfficeArtTertiaryFOPT, RT_Drawing, RT_TextCharsAtom, RT_TextHeaderAtom } from "../record/types.js";
 import { characterCountOf } from "../text/atoms.js";
 import { pointsToMasterUnits } from "../units.js";
 import { buildTextBody } from "../content-write.js";
+import { PptDiagnosticCodes } from "../diagnostics.js";
 import { concatBytes, i32le, u32le, utf16le, writeAtom, writeContainer } from "../record/write.js";
+import { isBlipFormat } from "./blips.js";
+import { degreesToFixedPoint, writeIMsoArray, writeShapePropertyTable } from "./properties.js";
 import { writeStyleTextPropAtom } from "../text/style-write.js";
 //#region src/drawing/shapes-write.ts
+const FSP_CHILD = 2;
 const PATRIARCH_SPID = 1;
 const FIRST_CONTENT_SPID = 2;
 function writeFsp(spid, flags) {
@@ -20,9 +24,22 @@ function writeClientAnchor(xPt, yPt, widthPt, heightPt) {
 function writeTextCharsAtom(text) {
 	return writeAtom(RT_TextCharsAtom, utf16le(text));
 }
-function writeClientTextbox(shape, fontIndexOf) {
-	if (!shape.blocks.some((block) => block.kind === "paragraph")) return;
-	const { text, style } = buildTextBody(shape.blocks, fontIndexOf);
+function writeShapeProperties(shape, pib) {
+	const entries = [];
+	if (shape.rotationDeg !== void 0) entries.push({
+		opid: 4,
+		op: degreesToFixedPoint(shape.rotationDeg)
+	});
+	if (pib !== void 0) entries.push({
+		opid: 260,
+		op: pib,
+		fBid: true
+	});
+	return entries.length === 0 ? void 0 : writeShapePropertyTable(OfficeArtFOPT, entries);
+}
+function writeClientTextbox(textBlocks, fontIndexOf) {
+	if (textBlocks.length === 0) return;
+	const { text, style } = buildTextBody(textBlocks, fontIndexOf);
 	const totalParagraphCount = style.paragraphRuns.reduce((sum, run) => sum + run.count, 0);
 	if (totalParagraphCount !== characterCountOf(text)) throw new Error(`internal error: built ${totalParagraphCount} characters of paragraph runs for a ${characterCountOf(text)}-character text body`);
 	return writeContainer(OfficeArtClientTextbox, [
@@ -31,9 +48,12 @@ function writeClientTextbox(shape, fontIndexOf) {
 		writeStyleTextPropAtom(style)
 	]);
 }
-function writeShape(spid, shape, fontIndexOf, clientData) {
-	const clientTextbox = writeClientTextbox(shape, fontIndexOf);
-	const children = [writeFsp(spid, 0), writeClientAnchor(shape.frame.xPt, shape.frame.yPt, shape.frame.widthPt, shape.frame.heightPt)];
+function writeShape(spid, shape, pib, textBlocks, fontIndexOf, clientData) {
+	const properties = writeShapeProperties(shape, pib);
+	const clientTextbox = writeClientTextbox(textBlocks, fontIndexOf);
+	const children = [writeFsp(spid, 0)];
+	if (properties !== void 0) children.push(properties);
+	children.push(writeClientAnchor(shape.frame.xPt, shape.frame.yPt, shape.frame.widthPt, shape.frame.heightPt));
 	if (clientData !== void 0) children.push(clientData);
 	if (clientTextbox !== void 0) children.push(clientTextbox);
 	return writeContainer(OfficeArtSpContainer, children);
@@ -41,18 +61,186 @@ function writeShape(spid, shape, fontIndexOf, clientData) {
 function writePatriarch() {
 	return writeContainer(OfficeArtSpContainer, [writeAtom(OfficeArtFSPGR, /* @__PURE__ */ new Uint8Array(16), { recVer: 1 }), writeFsp(PATRIARCH_SPID, 5)]);
 }
-function writeDrawing(shapes, fontIndexOf) {
-	const shapeContainers = shapes.map((entry, index) => writeShape(FIRST_CONTENT_SPID + index, entry.shape, fontIndexOf, entry.clientData));
-	return writeContainer(RT_Drawing, [writeContainer(OfficeArtDgContainer, [writeContainer(OfficeArtSpgrContainer, [writePatriarch(), ...shapeContainers])])]);
+function planShapeBlocks(blocks, context) {
+	const textBlocks = [];
+	let pib;
+	let table;
+	const drop = (block, reason) => {
+		context.sink({
+			code: PptDiagnosticCodes.BLOCK_DROPPED,
+			severity: "warning",
+			message: `${context.location}: ${reason}`
+		});
+	};
+	for (const block of blocks) {
+		if (block.kind === "paragraph") {
+			textBlocks.push(block);
+			continue;
+		}
+		if (block.kind === "image") {
+			if (!isBlipFormat(block.format)) {
+				context.sink({
+					code: PptDiagnosticCodes.IMAGE_DROPPED,
+					severity: "warning",
+					message: `${context.location}: an image block in format '${block.format}' is dropped; MSOBLIPTYPE gives this writer a blip record for PNG and JPEG only`
+				});
+				continue;
+			}
+			if (pib !== void 0) {
+				context.sink({
+					code: PptDiagnosticCodes.IMAGE_DROPPED,
+					severity: "warning",
+					message: `${context.location}: a second image block is dropped; a shape carries exactly one blip-store reference, and an earlier image already consumed it`
+				});
+				continue;
+			}
+			pib = context.blipIndexOf(block);
+			continue;
+		}
+		if (block.kind === "table") {
+			if (table !== void 0) {
+				drop(block, "a second 'table' block is dropped; a shape becomes one table group, and an earlier table already did");
+				continue;
+			}
+			table = block;
+			continue;
+		}
+		drop(block, `a '${block.kind}' block is dropped; this writer produces no [MS-PPT] spelling for it`);
+	}
+	if (table !== void 0) {
+		for (const block of textBlocks) drop(block, "a 'paragraph' block is dropped; a shape carrying a table becomes a table group, which holds its text in cells rather than a text body of its own");
+		if (pib !== void 0) context.sink({
+			code: PptDiagnosticCodes.IMAGE_DROPPED,
+			severity: "warning",
+			message: `${context.location}: an image block is dropped; a shape carrying a table becomes a table group, which has no blip reference of its own`
+		});
+		return {
+			pib: void 0,
+			textBlocks: [],
+			table
+		};
+	}
+	return {
+		pib,
+		textBlocks,
+		table
+	};
+}
+function tableRowHeights(table, frameHeightMasterUnits) {
+	const stated = table.rows.map((row) => row.heightPt === void 0 ? void 0 : pointsToMasterUnits(row.heightPt));
+	const unstatedCount = stated.filter((height) => height === void 0).length;
+	if (unstatedCount === 0) return stated.map((height) => {
+		if (height === void 0) throw new Error("internal error: a stated row height became unstated in the same pass");
+		return height;
+	});
+	const remaining = frameHeightMasterUnits - stated.reduce((sum, height) => sum + (height ?? 0), 0);
+	const shared = Math.max(1, Math.round(remaining / unstatedCount));
+	return stated.map((height) => height ?? shared);
+}
+function writeTableGroup(spid, shape, table, context) {
+	const { frame } = shape;
+	const rowHeights = tableRowHeights(table, pointsToMasterUnits(frame.heightPt));
+	const declaredWidths = table.columnWidthsPt.map(pointsToMasterUnits);
+	const cellCount = Math.max(1, ...table.rows.map((row) => row.cells.length), declaredWidths.length);
+	const lastDeclared = declaredWidths.at(-1);
+	const equalShare = Math.max(1, Math.round(pointsToMasterUnits(frame.widthPt) / cellCount));
+	const columnWidthsMasterUnits = Array.from({ length: cellCount }, (_, index) => declaredWidths[index] ?? lastDeclared ?? equalShare);
+	const columnBoundaries = [];
+	let columnEdge = pointsToMasterUnits(frame.xPt);
+	for (const width of columnWidthsMasterUnits) {
+		columnBoundaries.push(columnEdge);
+		columnEdge += width;
+	}
+	columnBoundaries.push(columnEdge);
+	const rowBoundaries = [];
+	let rowEdge = pointsToMasterUnits(frame.yPt);
+	for (const height of rowHeights) {
+		rowBoundaries.push(rowEdge);
+		rowEdge += height;
+	}
+	rowBoundaries.push(rowEdge);
+	const rowHeightsPayload = writeIMsoArray(rowHeights, 4);
+	const tableLeft = pointsToMasterUnits(frame.xPt);
+	const tableTop = pointsToMasterUnits(frame.yPt);
+	const tableRight = pointsToMasterUnits(frame.xPt + frame.widthPt);
+	const tableBottom = pointsToMasterUnits(frame.yPt + frame.heightPt);
+	const groupShape = writeContainer(OfficeArtSpContainer, [
+		writeAtom(OfficeArtFSPGR, concatBytes(i32le(tableLeft), i32le(tableTop), i32le(tableRight), i32le(tableBottom)), { recVer: 1 }),
+		writeFsp(spid, 513),
+		...shape.rotationDeg === void 0 ? [] : [writeShapePropertyTable(OfficeArtFOPT, [{
+			opid: 4,
+			op: degreesToFixedPoint(shape.rotationDeg)
+		}])],
+		writeShapePropertyTable(OfficeArtTertiaryFOPT, [{
+			opid: 927,
+			op: 1
+		}, {
+			opid: 928,
+			op: rowHeightsPayload.length,
+			fBid: true,
+			complex: rowHeightsPayload
+		}]),
+		writeClientAnchor(frame.xPt, frame.yPt, frame.widthPt, frame.heightPt)
+	]);
+	let cellSpid = spid + 1;
+	const cellShapes = table.rows.flatMap((row, rowIndex) => row.cells.map((cell, columnIndex) => {
+		const cellLeft = columnBoundaries[columnIndex];
+		const cellRight = columnBoundaries[columnIndex + 1];
+		const cellTop = rowBoundaries[rowIndex];
+		const cellBottom = rowBoundaries[rowIndex + 1];
+		if (cellLeft === void 0 || cellRight === void 0 || cellTop === void 0 || cellBottom === void 0) throw new Error("internal error: a table cell sits outside the grid boundaries derived from its own table");
+		if (cell.colSpan !== void 0 && cell.colSpan > 1) context.sink({
+			code: PptDiagnosticCodes.TABLE_SPAN_DROPPED,
+			severity: "warning",
+			message: `${context.location}: a table cell's colSpan ${String(cell.colSpan)} is dropped; a PowerPoint 97-2003 table is a strict grid of shapes with no merge records, so the cell is written one column wide`
+		});
+		if (cell.rowSpan !== void 0 && cell.rowSpan > 1) context.sink({
+			code: PptDiagnosticCodes.TABLE_SPAN_DROPPED,
+			severity: "warning",
+			message: `${context.location}: a table cell's rowSpan ${String(cell.rowSpan)} is dropped; a PowerPoint 97-2003 table is a strict grid of shapes with no merge records, so the cell is written one row tall`
+		});
+		const paragraphs = cell.blocks.filter((block) => block.kind === "paragraph");
+		for (const block of cell.blocks) if (block.kind !== "paragraph") context.sink({
+			code: PptDiagnosticCodes.BLOCK_DROPPED,
+			severity: "warning",
+			message: `${context.location}: a '${block.kind}' block inside a table cell is dropped; a table cell in this format is a plain text-box shape with no property table or object reference of its own`
+		});
+		const textbox = writeClientTextbox(paragraphs, context.fontIndexOf);
+		const children = [writeFsp(cellSpid, FSP_CHILD), writeAtom(OfficeArtChildAnchor, concatBytes(i32le(cellLeft), i32le(cellTop), i32le(cellRight), i32le(cellBottom)))];
+		cellSpid += 1;
+		if (textbox !== void 0) children.push(textbox);
+		return writeContainer(OfficeArtSpContainer, children);
+	}));
+	return {
+		bytes: writeContainer(OfficeArtSpgrContainer, [groupShape, ...cellShapes]),
+		shapeCount: 1 + table.rows.reduce((sum, row) => sum + row.cells.length, 0)
+	};
 }
-function writeSlideDrawing(shapes, fontIndexOf) {
-	return writeDrawing(shapes.map((shape) => ({
-		shape,
-		clientData: void 0
-	})), fontIndexOf);
+function writeDrawing(shapes, context) {
+	let nextSpid = FIRST_CONTENT_SPID;
+	let shapeCount = 1;
+	const shapeContainers = [];
+	for (const entry of shapes) {
+		const plan = planShapeBlocks(entry.shape.blocks, context);
+		if (plan.table !== void 0) {
+			const group = writeTableGroup(nextSpid, entry.shape, plan.table, context);
+			nextSpid += group.shapeCount;
+			shapeCount += group.shapeCount;
+			shapeContainers.push(group.bytes);
+			continue;
+		}
+		shapeContainers.push(writeShape(nextSpid, entry.shape, plan.pib, plan.textBlocks, context.fontIndexOf, entry.clientData));
+		nextSpid += 1;
+		shapeCount += 1;
+	}
+	return {
+		bytes: writeContainer(RT_Drawing, [writeContainer(OfficeArtDgContainer, [writeContainer(OfficeArtSpgrContainer, [writePatriarch(), ...shapeContainers])])]),
+		shapeCount,
+		maxSpid: Math.max(PATRIARCH_SPID, nextSpid - 1)
+	};
 }
-function writeDrawingWithClientData(shapes, fontIndexOf) {
-	return writeDrawing(shapes, fontIndexOf);
+function writeSlideDrawing(shapes, context) {
+	return writeDrawing(shapes, context);
 }
 //#endregion
-export { writeDrawingWithClientData, writeSlideDrawing };
+export { writeSlideDrawing };

package/dist/drawing/shapes.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_errors = require("../errors.cjs");
 const require_record_tree = require("../record/tree.cjs");
 const require_record_types = require("../record/types.cjs");
+const require_drawing_properties = require("./properties.cjs");
 //#region src/drawing/shapes.ts
 const FSP_GROUP = 1;
 const FSP_PATRIARCH = 4;
@@ -44,7 +45,7 @@ function readClientAnchor(record) {
 	if (recLen === 16) return readRectFields(record, 4, "top-left");
 	throw new require_errors.PptFormatError(`OfficeArtClientAnchor declares recLen 0x${recLen.toString(16)}, neither the 0x8 of a SmallRectStruct nor the 0x10 of a RectStruct`);
 }
-function readShapeProperties(shape) {
+function readShapeIdentity(shape) {
 	const fsp = require_record_tree.findChild(require_record_tree.childRecords(shape), require_record_types.OfficeArtFSP);
 	if (fsp === void 0 || fsp.data.length < 8) throw new require_errors.PptFormatError(`OfficeArtSpContainer at offset ${shape.offset} has no readable OfficeArtFSP, so the shape has neither an identity nor its flags`);
 	const view = new DataView(fsp.data.buffer, fsp.data.byteOffset, 8);
@@ -60,8 +61,18 @@ function resolveAnchor(shape, transform) {
 	const child = require_record_tree.findChild(children, require_record_types.OfficeArtChildAnchor);
 	if (child !== void 0) return applyTransform(transform, readRectFields(child, 4, "left-top"));
 }
+function rotationDegOf(properties) {
+	const rotation = properties.get(4);
+	if (rotation === void 0) return;
+	const degrees = require_drawing_properties.fixedPointToDegrees(rotation.value);
+	return degrees === 0 ? void 0 : degrees;
+}
+function isTableGroup(properties) {
+	const tableProperties = properties.get(927);
+	return tableProperties !== void 0 && (tableProperties.value & 1) !== 0;
+}
 function groupTransform(groupShape, parent) {
-	const { spid, flags } = readShapeProperties(groupShape);
+	const { spid, flags } = readShapeIdentity(groupShape);
 	if ((flags & FSP_PATRIARCH) !== 0) return parent;
 	const children = require_record_tree.childRecords(groupShape);
 	const fspgr = require_record_tree.findChild(children, require_record_types.OfficeArtFSPGR);
@@ -81,17 +92,36 @@ function groupTransform(groupShape, parent) {
 	};
 }
 function collectShape(shape, transform, into) {
-	const { spid, flags } = readShapeProperties(shape);
+	const { spid, flags } = readShapeIdentity(shape);
 	if ((flags & FSP_DELETED) !== 0 || (flags & FSP_GROUP) !== 0) return;
+	const children = require_record_tree.childRecords(shape);
+	const properties = require_drawing_properties.readShapeProperties(shape);
 	into.push({
 		spid,
 		anchor: resolveAnchor(shape, transform),
-		clientTextbox: require_record_tree.findChild(require_record_tree.childRecords(shape), require_record_types.OfficeArtClientTextbox)
+		rotationDeg: rotationDegOf(properties),
+		clientTextbox: require_record_tree.findChild(children, require_record_types.OfficeArtClientTextbox),
+		clientData: require_record_tree.findChild(children, require_record_types.OfficeArtClientData),
+		properties
 	});
 }
 function collectGroup(group, parent, into) {
 	const [groupShape, ...rest] = require_record_tree.childRecords(group);
 	if (groupShape === void 0) return;
+	const groupProperties = require_drawing_properties.readShapeProperties(groupShape);
+	if (isTableGroup(groupProperties)) {
+		const anchor = resolveAnchor(groupShape, parent);
+		if (anchor === void 0) throw new require_errors.PptFormatError(`table group shape ${readShapeIdentity(groupShape).spid} carries no anchor, so the table cannot be placed on the slide`);
+		const tableTransform = groupTransform(groupShape, parent);
+		const cells = [];
+		for (const child of rest) if (child.header.recType === 61444) collectShape(child, tableTransform, cells);
+		into.push({
+			anchor,
+			rotationDeg: rotationDegOf(groupProperties),
+			cells
+		});
+		return;
+	}
 	const transform = groupTransform(groupShape, parent);
 	for (const child of rest) if (child.header.recType === 61443) collectGroup(child, transform, into);
 	else if (child.header.recType === 61444) collectShape(child, transform, into);

package/dist/drawing/shapes.d.cts

@@ -1,4 +1,5 @@
 import { t as PptRecord } from "../tree-Du_LXAF0.cjs";
+import { ShapeProperty } from "./properties.cjs";
 //#region src/drawing/shapes.d.ts
 interface ShapeRect {
   readonly left: number;
@@ -9,8 +10,16 @@ interface ShapeRect {
 interface PptShape {
   readonly spid: number;
   readonly anchor: ShapeRect | undefined;
+  readonly rotationDeg: number | undefined;
   readonly clientTextbox: PptRecord | undefined;
+  readonly clientData: PptRecord | undefined;
+  readonly properties: ReadonlyMap<number, ShapeProperty>;
 }
-declare function readDrawingShapes(drawing: PptRecord): PptShape[];
+interface PptTable {
+  readonly anchor: ShapeRect;
+  readonly rotationDeg: number | undefined;
+  readonly cells: readonly PptShape[];
+}
+declare function readDrawingShapes(drawing: PptRecord): readonly (PptShape | PptTable)[];
 //#endregion
-export { PptShape, ShapeRect, readDrawingShapes };
+export { PptShape, PptTable, ShapeRect, readDrawingShapes };