document-cli 1.6.0 → 1.7.0

package/dist/cli.js

@@ -1194,7 +1194,7 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.6.0";
+var version = "1.7.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {
@@ -1221,7 +1221,7 @@ function createProgram() {
 //#region src/cli.ts
 async function launchTui(startPath, signal) {
 	try {
-		const { runTui } = await import("./tui-CqYlr4nN.js");
+		const { runTui } = await import("./tui-BzdX4QQg.js");
 		await runTui({
 			startPath,
 			signal

package/dist/index.cjs

@@ -1661,7 +1661,7 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.6.0";
+var version = "1.7.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {

package/dist/index.js

@@ -1660,7 +1660,7 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.6.0";
+var version = "1.7.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {

package/dist/{tui-CqYlr4nN.js → tui-BzdX4QQg.js}

@@ -230,6 +230,7 @@ function selectionKeyFor(screen) {
 		case "slideDetail":
 		case "notesEditor": return `${screen.kind}:${screen.slideIndex}`;
 		case "shapeEditor": return `shapeEditor:${screen.slideIndex}:${screen.shapeIndex}`;
+		case "slideTableDetail": return `slideTableDetail:${screen.slideIndex}:${screen.tableIndex}`;
 		case "spreadsheetGrid":
 		case "printSettingsEditor": return `${screen.kind}:${screen.sheetIndex}`;
 		case "cellDetail": return `cellDetail:${screen.sheetIndex}:${screen.row}:${screen.col}`;
@@ -435,6 +436,38 @@ function mutate(state, doc, apply) {
 		undoStack: pushSnapshot(state.undoStack, snapshot)
 	};
 }
+function mutateGuarded(state, doc, apply) {
+	try {
+		return mutate(state, doc, apply);
+	} catch (error) {
+		return withStatus(state, "warning", error instanceof Error ? error.message : String(error));
+	}
+}
+function mergePptxTableCells(table, startRow, startColumn, rowSpan, colSpan) {
+	if (!Number.isInteger(rowSpan) || rowSpan < 1 || !Number.isInteger(colSpan) || colSpan < 1) throw new Error(`mergeSlideTableCells: rowSpan and colSpan must be positive integers, got rowSpan=${rowSpan}, colSpan=${colSpan}`);
+	const rows = table.rows();
+	if (startRow + rowSpan > rows.length) throw new Error(`mergeSlideTableCells: rowSpan ${rowSpan} starting at row ${startRow} exceeds this table's own ${rows.length} rows`);
+	const anchorRow = rows[startRow];
+	if (anchorRow === void 0) throw new Error(`mergeSlideTableCells: row ${startRow} does not exist in this table`);
+	const columnCount = anchorRow.cells().length;
+	if (startColumn + colSpan > columnCount) throw new Error(`mergeSlideTableCells: colSpan ${colSpan} starting at column ${startColumn} exceeds this table's own ${columnCount} columns`);
+	for (let rowOffset = 0; rowOffset < rowSpan; rowOffset++) {
+		const row = rows[startRow + rowOffset];
+		if (row === void 0) throw new Error(`mergeSlideTableCells: row ${startRow + rowOffset} does not exist in this table`);
+		const cells = row.cells();
+		for (let columnOffset = 0; columnOffset < colSpan; columnOffset++) {
+			const cell = cells[startColumn + columnOffset];
+			if (cell === void 0) throw new Error(`mergeSlideTableCells: column ${startColumn + columnOffset} does not exist in row ${startRow + rowOffset}`);
+			if (rowOffset === 0 && columnOffset === 0) {
+				cell.colSpan = colSpan;
+				cell.rowSpan = rowSpan;
+				continue;
+			}
+			if (columnOffset > 0) cell.horizontalMerge = true;
+			if (rowOffset > 0) cell.verticalMerge = true;
+		}
+	}
+}
 function mutateMarkdown(state, doc, source) {
 	const snapshot = encodeMarkdownText(doc.source);
 	return {
@@ -685,11 +718,21 @@ function appReducer(state, action) {
 		case "APPEND_TABLE": {
 			const doc = wordprocessingDocument(state);
 			if (doc === void 0) return wrongDocument(state, "a docx or odt document");
-			return mutate(state, doc, () => {
-				doc.editor.body.appendTable({
+			return mutateGuarded(state, doc, () => {
+				const table = doc.editor.body.appendTable({
 					rows: action.rows,
 					columns: action.columns
 				});
+				if (action.merge !== void 0) table.mergeCells(action.merge.startRow, action.merge.startColumn, action.merge.rowSpan, action.merge.colSpan);
+			});
+		}
+		case "MERGE_TABLE_CELLS": {
+			const doc = wordprocessingDocument(state);
+			if (doc === void 0) return wrongDocument(state, "a docx or odt document");
+			const table = tableAt(doc, action.tableIndex);
+			if (table === void 0) return withStatus(state, "warning", `There is no table at index ${action.tableIndex}`);
+			return mutateGuarded(state, doc, () => {
+				table.mergeCells(action.startRow, action.startColumn, action.rowSpan, action.colSpan);
 			});
 		}
 		case "SET_TABLE_CELL_TEXT": {
@@ -754,6 +797,22 @@ function appReducer(state, action) {
 				});
 			});
 		}
+		case "MERGE_SLIDE_TABLE_CELLS": {
+			const doc = presentationDocument(state);
+			if (doc === void 0) return wrongDocument(state, "a pptx or odp document");
+			if (doc.format === "odp") {
+				const entry = doc.editor.slides()[action.slideIndex]?.tables()[action.tableIndex];
+				if (entry === void 0) return withStatus(state, "warning", `There is no table at index ${action.tableIndex} on slide ${action.slideIndex}`);
+				return mutateGuarded(state, doc, () => {
+					entry.table.mergeCells(action.startRow, action.startColumn, action.rowSpan, action.colSpan);
+				});
+			}
+			const table = doc.editor.slides()[action.slideIndex]?.tables()[action.tableIndex];
+			if (table === void 0) return withStatus(state, "warning", `There is no table at index ${action.tableIndex} on slide ${action.slideIndex}`);
+			return mutateGuarded(state, doc, () => {
+				mergePptxTableCells(table, action.startRow, action.startColumn, action.rowSpan, action.colSpan);
+			});
+		}
 		case "ADD_TEXTBOX": {
 			const doc = shapeHostDocument(state);
 			if (doc === void 0) return wrongDocument(state, "a pptx, odp or odg document");
@@ -826,6 +885,15 @@ function appReducer(state, action) {
 		case "SET_CELL_VALUE": return withSheet(state, action.sheetIndex, (sheet) => {
 			sheet.cell(action.row, action.column).value = action.value;
 		});
+		case "MERGE_CELLS": {
+			const doc = spreadsheetDocument(state);
+			if (doc === void 0) return wrongDocument(state, "an ods document");
+			const sheet = sheetAt(doc, action.sheetIndex);
+			if (sheet === void 0) return withStatus(state, "warning", `There is no sheet at index ${action.sheetIndex}`);
+			return mutateGuarded(state, doc, () => {
+				sheet.mergeCells(action.startRow, action.startColumn, action.rowSpan, action.colSpan);
+			});
+		}
 		case "SET_SHEET_PRINT_SETTINGS": return withSheet(state, action.sheetIndex, (sheet) => {
 			sheet.printSettings = action.printSettings;
 		});
@@ -1606,6 +1674,14 @@ function truncatePreview(text, maxLength) {
 	if (singleLine.length === 0) return "(empty)";
 	return singleLine.length > maxLength ? `${singleLine.slice(0, Math.max(0, maxLength - 1))}…` : singleLine;
 }
+function parsePositiveIntField(raw, fallback) {
+	const parsed = Number.parseInt(raw, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
+}
+function parseNonNegativeIntField(raw, fallback) {
+	const parsed = Number.parseInt(raw, 10);
+	return Number.isInteger(parsed) && parsed >= 0 ? parsed : fallback;
+}
 //#endregion
 //#region src/tui/screens/shared/paragraph-family.tsx
 function paragraphFamilyDocument(openDocument) {
@@ -1669,6 +1745,8 @@ function tableSummary(table) {
 function listSummary(list, index) {
 	return `List ${index} (${list.itemCount} item${list.itemCount === 1 ? "" : "s"})`;
 }
+const DEFAULT_TABLE_ROWS$1 = 2;
+const DEFAULT_TABLE_COLUMNS$1 = 2;
 function ParagraphFamilyBodyList(props) {
 	const { adapter } = props;
 	const state = useAppState();
@@ -1711,9 +1789,88 @@ function ParagraphFamilyBodyList(props) {
 		if (row.kind !== "header") acc.push(rowIndex);
 		return acc;
 	}, []);
+	const [tableWizard, setTableWizard] = useState("closed");
+	const [wizardDraft, setWizardDraft] = useState("");
+	const [wizardRows, setWizardRows] = useState(DEFAULT_TABLE_ROWS$1);
+	const [wizardColumns, setWizardColumns] = useState(DEFAULT_TABLE_COLUMNS$1);
+	const [wizardStartRow, setWizardStartRow] = useState(0);
+	const [wizardStartColumn, setWizardStartColumn] = useState(0);
+	const [wizardRowSpan, setWizardRowSpan] = useState(1);
+	const wizardOpen = tableWizard !== "closed";
+	const closeWizard = () => {
+		setTableWizard("closed");
+	};
+	const commitAppendTable = (merge) => {
+		const newIndex = tables.length;
+		dispatch({
+			type: "APPEND_TABLE",
+			rows: wizardRows,
+			columns: wizardColumns,
+			merge
+		});
+		closeWizard();
+		dispatch({
+			type: "PUSH_SCREEN",
+			screen: {
+				kind: "tableView",
+				blockIndex: newIndex
+			}
+		});
+	};
+	useInput((input) => {
+		if (input === "T") {
+			setWizardDraft(String(DEFAULT_TABLE_ROWS$1));
+			setTableWizard("rows");
+		}
+	}, { isActive: !anyOverlayOpen(state) && !wizardOpen });
+	useInput((input, key) => {
+		if (key.escape) {
+			closeWizard();
+			return;
+		}
+		if (input === "y" || input === "Y") {
+			setWizardDraft("0");
+			setTableWizard("mergeStartRow");
+			return;
+		}
+		if (input === "n" || input === "N" || key.return) commitAppendTable(void 0);
+	}, { isActive: !anyOverlayOpen(state) && tableWizard === "mergePrompt" });
+	const submitWizardRows = (raw) => {
+		setWizardRows(parsePositiveIntField(raw, DEFAULT_TABLE_ROWS$1));
+		setWizardDraft(String(DEFAULT_TABLE_COLUMNS$1));
+		setTableWizard("columns");
+	};
+	const submitWizardColumns = (raw) => {
+		setWizardColumns(parsePositiveIntField(raw, DEFAULT_TABLE_COLUMNS$1));
+		setTableWizard("mergePrompt");
+	};
+	const submitWizardMergeStartRow = (raw) => {
+		setWizardStartRow(Math.min(parseNonNegativeIntField(raw, 0), Math.max(0, wizardRows - 1)));
+		setWizardDraft("0");
+		setTableWizard("mergeStartColumn");
+	};
+	const submitWizardMergeStartColumn = (raw) => {
+		setWizardStartColumn(Math.min(parseNonNegativeIntField(raw, 0), Math.max(0, wizardColumns - 1)));
+		setWizardDraft("1");
+		setTableWizard("mergeRowSpan");
+	};
+	const submitWizardMergeRowSpan = (raw) => {
+		setWizardRowSpan(Math.min(parsePositiveIntField(raw, 1), Math.max(1, wizardRows - wizardStartRow)));
+		setWizardDraft("1");
+		setTableWizard("mergeColSpan");
+	};
+	const submitWizardMergeColSpan = (raw) => {
+		const colSpan = Math.min(parsePositiveIntField(raw, 1), Math.max(1, wizardColumns - wizardStartColumn));
+		commitAppendTable({
+			startRow: wizardStartRow,
+			startColumn: wizardStartColumn,
+			rowSpan: wizardRowSpan,
+			colSpan
+		});
+	};
 	const { selectedIndex } = usePersistedSelection(selectionKeyFor({ kind: "bodyList" }), {
 		itemCount: selectableRowIndices.length,
-		isActive: !anyOverlayOpen(state),
+		isActive: !anyOverlayOpen(state) && !wizardOpen,
 		onBack: () => {
 			dispatch({ type: "POP_SCREEN" });
 		},
@@ -1800,9 +1957,89 @@ function ParagraphFamilyBodyList(props) {
 					});
 				}
 			}),
+			tableWizard === "rows" ? /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				children: "Rows: "
+			}), /* @__PURE__ */ jsx(TextField, {
+				value: wizardDraft,
+				isFocused: true,
+				onChange: setWizardDraft,
+				onSubmit: submitWizardRows,
+				onCancel: closeWizard
+			})] }) : void 0,
+			tableWizard === "columns" ? /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				children: "Columns: "
+			}), /* @__PURE__ */ jsx(TextField, {
+				value: wizardDraft,
+				isFocused: true,
+				onChange: setWizardDraft,
+				onSubmit: submitWizardColumns,
+				onCancel: closeWizard
+			})] }) : void 0,
+			tableWizard === "mergePrompt" ? /* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				children: "Merge cells now? y/N"
+			}) : void 0,
+			tableWizard === "mergeStartRow" ? /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsxs(Text, {
+				color: "cyan",
+				children: [
+					"Merge start row (0-",
+					Math.max(0, wizardRows - 1),
+					"): "
+				]
+			}), /* @__PURE__ */ jsx(TextField, {
+				value: wizardDraft,
+				isFocused: true,
+				onChange: setWizardDraft,
+				onSubmit: submitWizardMergeStartRow,
+				onCancel: closeWizard
+			})] }) : void 0,
+			tableWizard === "mergeStartColumn" ? /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsxs(Text, {
+				color: "cyan",
+				children: [
+					"Merge start column (0-",
+					Math.max(0, wizardColumns - 1),
+					"): "
+				]
+			}), /* @__PURE__ */ jsx(TextField, {
+				value: wizardDraft,
+				isFocused: true,
+				onChange: setWizardDraft,
+				onSubmit: submitWizardMergeStartColumn,
+				onCancel: closeWizard
+			})] }) : void 0,
+			tableWizard === "mergeRowSpan" ? /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsxs(Text, {
+				color: "cyan",
+				children: [
+					"Merge row span (1-",
+					Math.max(1, wizardRows - wizardStartRow),
+					"): "
+				]
+			}), /* @__PURE__ */ jsx(TextField, {
+				value: wizardDraft,
+				isFocused: true,
+				onChange: setWizardDraft,
+				onSubmit: submitWizardMergeRowSpan,
+				onCancel: closeWizard
+			})] }) : void 0,
+			tableWizard === "mergeColSpan" ? /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsxs(Text, {
+				color: "cyan",
+				children: [
+					"Merge column span (1-",
+					Math.max(1, wizardColumns - wizardStartColumn),
+					"): "
+				]
+			}), /* @__PURE__ */ jsx(TextField, {
+				value: wizardDraft,
+				isFocused: true,
+				onChange: setWizardDraft,
+				onSubmit: submitWizardMergeColSpan,
+				onCancel: closeWizard
+			})] }) : void 0,
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: "Enter to open, a to append a paragraph, Esc back"
+				children: "Enter to open, a to append a paragraph, T to append a table, Esc back"
 			})
 		]
 	});
@@ -2079,7 +2316,7 @@ function RunEditorScreen() {
 }
 //#endregion
 //#region src/tui/screens/editors/docx/table-view.tsx
-const CELL_WIDTH$1 = 16;
+const CELL_WIDTH$2 = 16;
 function TableViewScreen() {
 	const state = useAppState();
 	const dispatch = useAppDispatch();
@@ -2087,6 +2324,7 @@ function TableViewScreen() {
 		row: 0,
 		column: 0
 	});
+	const [mergeAnchor, setMergeAnchor] = useState(void 0);
 	const screen = currentScreen(state);
 	const doc = paragraphFamilyDocument(state.openDocument);
 	const table = screen.kind === "tableView" && doc !== void 0 ? liveTableAt(doc, screen.blockIndex) : void 0;
@@ -2095,6 +2333,22 @@ function TableViewScreen() {
 	const columnCount = rows[0]?.cells().length ?? 0;
 	const clampedRow = rowCount === 0 ? 0 : Math.min(cursor.row, rowCount - 1);
 	const clampedColumn = columnCount === 0 ? 0 : Math.min(cursor.column, columnCount - 1);
+	const commitMerge = (anchor) => {
+		if (screen.kind !== "tableView") return;
+		const startRow = Math.min(anchor.row, clampedRow);
+		const startColumn = Math.min(anchor.column, clampedColumn);
+		const rowSpan = Math.abs(clampedRow - anchor.row) + 1;
+		const colSpan = Math.abs(clampedColumn - anchor.column) + 1;
+		dispatch({
+			type: "MERGE_TABLE_CELLS",
+			tableIndex: screen.blockIndex,
+			startRow,
+			startColumn,
+			rowSpan,
+			colSpan
+		});
+		setMergeAnchor(void 0);
+	};
 	useInput((input, key) => {
 		if (table === void 0 || screen.kind !== "tableView") return;
 		if (key.upArrow || input === "k") {
@@ -2126,18 +2380,36 @@ function TableViewScreen() {
 			return;
 		}
 		if (key.escape) {
+			if (mergeAnchor !== void 0) {
+				setMergeAnchor(void 0);
+				return;
+			}
 			dispatch({ type: "POP_SCREEN" });
 			return;
 		}
-		if (key.return && rowCount > 0 && columnCount > 0) dispatch({
-			type: "PUSH_SCREEN",
-			screen: {
-				kind: "tableCellDetail",
-				blockIndex: screen.blockIndex,
+		if (input === "m" && rowCount > 0 && columnCount > 0) {
+			if (mergeAnchor === void 0) setMergeAnchor({
 				row: clampedRow,
-				col: clampedColumn
+				column: clampedColumn
+			});
+			else commitMerge(mergeAnchor);
+			return;
+		}
+		if (key.return && rowCount > 0 && columnCount > 0) {
+			if (mergeAnchor !== void 0) {
+				commitMerge(mergeAnchor);
+				return;
 			}
-		});
+			dispatch({
+				type: "PUSH_SCREEN",
+				screen: {
+					kind: "tableCellDetail",
+					blockIndex: screen.blockIndex,
+					row: clampedRow,
+					col: clampedColumn
+				}
+			});
+		}
 	}, { isActive: !anyOverlayOpen(state) });
 	if (screen.kind !== "tableView") return /* @__PURE__ */ jsx(Text, {
 		color: "red",
@@ -2175,10 +2447,11 @@ function TableViewScreen() {
 				children: "This table has no rows."
 			}) : rows.map((row, rowIndex) => /* @__PURE__ */ jsx(Box, { children: row.cells().map((cell, columnIndex) => {
 				const isSelected = rowIndex === clampedRow && columnIndex === clampedColumn;
+				const isAnchor = rowIndex === mergeAnchor?.row && columnIndex === mergeAnchor?.column;
 				return /* @__PURE__ */ jsx(Box, {
-					width: CELL_WIDTH$1,
+					width: CELL_WIDTH$2,
 					borderStyle: "single",
-					borderColor: isSelected ? "cyan" : "gray",
+					borderColor: isSelected ? "cyan" : isAnchor ? "yellow" : "gray",
 					children: /* @__PURE__ */ jsx(Text, {
 						color: isSelected ? "cyan" : void 0,
 						inverse: isSelected,
@@ -2188,7 +2461,7 @@ function TableViewScreen() {
 			}) }, rowIndex)),
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: "Arrows/hjkl move, Enter to edit a cell, Esc back"
+				children: mergeAnchor === void 0 ? "Arrows/hjkl move, Enter to edit a cell, m to anchor a merge, Esc back" : "Arrows/hjkl to the opposite corner, m/Enter to merge, Esc to cancel"
 			})
 		]
 	});
@@ -4367,6 +4640,30 @@ function ShapeEditorScreen(props) {
 	});
 }
 //#endregion
+//#region src/tui/screens/shared/slide-table.ts
+function resolveSlideTable(doc, slideIndex, tableIndex) {
+	const content = doc.format === "odp" ? readOdpContent(doc.editor.toPackage()) : readPptxContent(doc.editor.toPackage());
+	if (content.kind !== "presentation") throw new Error("readPptxContent/readOdpContent always resolve a presentation package to the presentation ContentDocument variant.");
+	const slide = content.slides[slideIndex];
+	if (slide === void 0) return;
+	return slide.shapes.flatMap((shape) => shape.blocks.filter((block) => block.kind === "table"))[tableIndex];
+}
+function slideTableCellText(cell) {
+	return cell.blocks.filter((block) => block.kind === "paragraph").map((paragraph) => paragraph.runs.map((run) => run.text).join("")).join("\n");
+}
+function summarizeGridTable(table, index) {
+	const rows = table.rows();
+	return {
+		index,
+		rowCount: rows.length,
+		columnCount: rows[0]?.cells().length ?? 0
+	};
+}
+function summarizeSlideTables(doc, slideIndex) {
+	if (doc.format === "odp") return (doc.editor.slides()[slideIndex]?.tables() ?? []).map((entry, index) => summarizeGridTable(entry.table, index));
+	return (doc.editor.slides()[slideIndex]?.tables() ?? []).map((table, index) => summarizeGridTable(table, index));
+}
+//#endregion
 //#region src/tui/screens/editors/pptx/slide-detail.tsx
 const IMAGE_EXTENSION_TO_FORMAT = {
 	png: "png",
@@ -4375,10 +4672,6 @@ const IMAGE_EXTENSION_TO_FORMAT = {
 };
 const DEFAULT_TABLE_ROWS = 2;
 const DEFAULT_TABLE_COLUMNS = 2;
-function parsePositiveIntField(raw, fallback) {
-	const parsed = Number.parseInt(raw, 10);
-	return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
-}
 function imageFormatFromPath(path) {
 	const dotIndex = path.lastIndexOf(".");
 	if (dotIndex < 0) return;
@@ -4399,34 +4692,63 @@ function SlideDetailScreen(props) {
 	const doc = assertPresentationDocument(state.openDocument);
 	const { slideIndex } = props.screen;
 	const slide = doc.editor.slides()[slideIndex];
-	const rows = (slide === void 0 ? [] : slide.shapes()).map((shape, index) => ({
+	const shapes = slide === void 0 ? [] : slide.shapes();
+	const tableSummaries = slide === void 0 ? [] : summarizeSlideTables(doc, slideIndex);
+	const rows = [...shapes.map((shape, index) => ({
+		kind: "shape",
 		index,
 		text: shape.text,
 		frame: shape.frame
-	}));
+	})), ...tableSummaries.length > 0 ? [{
+		kind: "tablesHeader",
+		count: tableSummaries.length
+	}, ...tableSummaries.map((summary) => ({
+		kind: "table",
+		index: summary.index,
+		rowCount: summary.rowCount,
+		columnCount: summary.columnCount
+	}))] : []];
+	const selectableRowIndices = rows.reduce((acc, row, index) => {
+		if (row.kind !== "tablesHeader") acc.push(index);
+		return acc;
+	}, []);
 	const [addMode, setAddMode] = useState("closed");
 	const [draft, setDraft] = useState("");
 	const [imageError, setImageError] = useState(void 0);
 	const [tableRows, setTableRows] = useState(DEFAULT_TABLE_ROWS);
 	const formIsOpen = addMode !== "closed";
 	const { selectedIndex } = useNavigationInput({
-		itemCount: rows.length,
+		itemCount: selectableRowIndices.length,
 		isActive: !overlayOpen && !formIsOpen,
 		onBack: () => {
 			dispatch({ type: "POP_SCREEN" });
 		},
 		onSelect: (index) => {
-			dispatch({
-				type: "SET_SELECTION",
-				key: selectionKeyFor(props.screen),
-				index
-			});
-			dispatch({
+			const rowIndex = selectableRowIndices[index];
+			const row = rowIndex === void 0 ? void 0 : rows[rowIndex];
+			if (row === void 0) return;
+			if (row.kind === "shape") {
+				dispatch({
+					type: "SET_SELECTION",
+					key: selectionKeyFor(props.screen),
+					index
+				});
+				dispatch({
+					type: "PUSH_SCREEN",
+					screen: {
+						kind: "shapeEditor",
+						slideIndex,
+						shapeIndex: row.index
+					}
+				});
+				return;
+			}
+			if (row.kind === "table") dispatch({
 				type: "PUSH_SCREEN",
 				screen: {
-					kind: "shapeEditor",
+					kind: "slideTableDetail",
 					slideIndex,
-					shapeIndex: index
+					tableIndex: row.index
 				}
 			});
 		},
@@ -4434,6 +4756,7 @@ function SlideDetailScreen(props) {
 			setAddMode("chooseKind");
 		}
 	});
+	const listSelectedIndex = selectableRowIndices[selectedIndex] ?? -1;
 	useInput((input, key) => {
 		if (key.escape) {
 			setAddMode("closed");
@@ -4516,9 +4839,9 @@ function SlideDetailScreen(props) {
 					"Slide ",
 					slideIndex + 1,
 					" -- ",
-					rows.length,
+					shapes.length,
 					" shape",
-					rows.length === 1 ? "" : "s"
+					shapes.length === 1 ? "" : "s"
 				]
 			}),
 			slide === void 0 ? /* @__PURE__ */ jsx(Text, {
@@ -4526,20 +4849,45 @@ function SlideDetailScreen(props) {
 				children: "This slide no longer exists -- press Esc to go back"
 			}) : /* @__PURE__ */ jsx(ListView, {
 				items: rows,
-				selectedIndex,
+				selectedIndex: listSelectedIndex,
 				emptyMessage: "No shapes yet -- press 'a' to add one",
-				renderItem: (row, isSelected) => /* @__PURE__ */ jsxs(Text, {
-					color: isSelected ? "cyan" : void 0,
-					inverse: isSelected,
-					children: [
-						row.index + 1,
-						". ",
-						describeSlideFamilyShape({
-							text: row.text,
-							frame: row.frame
-						})
-					]
-				})
+				renderItem: (row, isSelected) => {
+					if (row.kind === "tablesHeader") return /* @__PURE__ */ jsxs(Text, {
+						bold: true,
+						dimColor: true,
+						children: [
+							"Tables (",
+							row.count,
+							")"
+						]
+					});
+					if (row.kind === "table") return /* @__PURE__ */ jsxs(Text, {
+						color: isSelected ? "cyan" : void 0,
+						inverse: isSelected,
+						children: [
+							"  ",
+							"Table ",
+							row.index + 1,
+							" (",
+							row.rowCount,
+							"x",
+							row.columnCount,
+							")"
+						]
+					});
+					return /* @__PURE__ */ jsxs(Text, {
+						color: isSelected ? "cyan" : void 0,
+						inverse: isSelected,
+						children: [
+							row.index + 1,
+							". ",
+							describeSlideFamilyShape({
+								text: row.text,
+								frame: row.frame
+							})
+						]
+					});
+				}
 			}),
 			addMode === "chooseKind" ? /* @__PURE__ */ jsx(Text, {
 				color: "cyan",
@@ -4607,6 +4955,146 @@ function SlideDetailScreen(props) {
 	});
 }
 //#endregion
+//#region src/tui/screens/editors/pptx/slide-table-detail.tsx
+const CELL_WIDTH$1 = 16;
+function SlideTableDetailScreen(props) {
+	const state = useAppState();
+	const dispatch = useAppDispatch();
+	const doc = assertPresentationDocument(state.openDocument);
+	const { slideIndex, tableIndex } = props.screen;
+	const [cursor, setCursor] = useState({
+		row: 0,
+		column: 0
+	});
+	const [mergeAnchor, setMergeAnchor] = useState(void 0);
+	const table = resolveSlideTable(doc, slideIndex, tableIndex);
+	const rows = table?.rows ?? [];
+	const rowCount = rows.length;
+	const columnCount = rows[0]?.cells.length ?? 0;
+	const clampedRow = rowCount === 0 ? 0 : Math.min(cursor.row, rowCount - 1);
+	const clampedColumn = columnCount === 0 ? 0 : Math.min(cursor.column, columnCount - 1);
+	const commitMerge = (anchor) => {
+		const startRow = Math.min(anchor.row, clampedRow);
+		const startColumn = Math.min(anchor.column, clampedColumn);
+		const rowSpan = Math.abs(clampedRow - anchor.row) + 1;
+		const colSpan = Math.abs(clampedColumn - anchor.column) + 1;
+		dispatch({
+			type: "MERGE_SLIDE_TABLE_CELLS",
+			slideIndex,
+			tableIndex,
+			startRow,
+			startColumn,
+			rowSpan,
+			colSpan
+		});
+		setMergeAnchor(void 0);
+	};
+	useInput((input, key) => {
+		if (table === void 0) return;
+		if (key.upArrow || input === "k") {
+			setCursor({
+				row: Math.max(0, clampedRow - 1),
+				column: clampedColumn
+			});
+			return;
+		}
+		if (key.downArrow || input === "j") {
+			setCursor({
+				row: rowCount === 0 ? 0 : Math.min(rowCount - 1, clampedRow + 1),
+				column: clampedColumn
+			});
+			return;
+		}
+		if (key.leftArrow || input === "h") {
+			setCursor({
+				row: clampedRow,
+				column: Math.max(0, clampedColumn - 1)
+			});
+			return;
+		}
+		if (key.rightArrow || input === "l") {
+			setCursor({
+				row: clampedRow,
+				column: columnCount === 0 ? 0 : Math.min(columnCount - 1, clampedColumn + 1)
+			});
+			return;
+		}
+		if (key.escape) {
+			if (mergeAnchor !== void 0) {
+				setMergeAnchor(void 0);
+				return;
+			}
+			dispatch({ type: "POP_SCREEN" });
+			return;
+		}
+		if (input === "m" || key.return) {
+			if (mergeAnchor === void 0) {
+				setMergeAnchor({
+					row: clampedRow,
+					column: clampedColumn
+				});
+				return;
+			}
+			commitMerge(mergeAnchor);
+		}
+	}, { isActive: !anyOverlayOpen(state) });
+	if (table === void 0) return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [/* @__PURE__ */ jsxs(Text, {
+			bold: true,
+			children: [
+				"Slide ",
+				slideIndex + 1,
+				", table ",
+				tableIndex + 1
+			]
+		}), /* @__PURE__ */ jsx(Text, {
+			color: "yellow",
+			children: "This table no longer exists -- press Esc to go back"
+		})]
+	});
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Text, {
+				bold: true,
+				children: [
+					"Slide ",
+					slideIndex + 1,
+					", table ",
+					tableIndex + 1,
+					" (",
+					rowCount,
+					"x",
+					columnCount,
+					")"
+				]
+			}),
+			rows.length === 0 ? /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "This table has no rows."
+			}) : rows.map((row, rowIndex) => /* @__PURE__ */ jsx(Box, { children: row.cells.map((cell, columnIndex) => {
+				const isCursor = rowIndex === clampedRow && columnIndex === clampedColumn;
+				const isAnchor = rowIndex === mergeAnchor?.row && columnIndex === mergeAnchor?.column;
+				return /* @__PURE__ */ jsx(Box, {
+					width: CELL_WIDTH$1,
+					borderStyle: "single",
+					borderColor: isCursor ? "cyan" : isAnchor ? "yellow" : "gray",
+					children: /* @__PURE__ */ jsx(Text, {
+						color: isCursor ? "cyan" : void 0,
+						inverse: isCursor,
+						children: truncatePreview(slideTableCellText(cell), 14)
+					})
+				}, columnIndex);
+			}) }, rowIndex)),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: mergeAnchor === void 0 ? "Arrows/hjkl move, m to anchor a merge, Esc back" : "Arrows/hjkl to the opposite corner, m/Enter to merge, Esc to cancel"
+			})
+		]
+	});
+}
+//#endregion
 //#region src/tui/screens/editors/pptx/index.tsx
 function PptxSlideListScreen() {
 	const doc = useAppState().openDocument;
@@ -5225,7 +5713,8 @@ const RESERVED_LETTERS = /* @__PURE__ */ new Set([
 	"k",
 	"l",
 	"p",
-	"t"
+	"t",
+	"m"
 ]);
 function windowStart(cursor, total, viewport) {
 	const maxStart = Math.max(0, total - viewport);
@@ -5248,6 +5737,7 @@ function OdsSpreadsheetGridScreen() {
 	const [cursorColumn, setCursorColumn] = useState(0);
 	const [viewMode, setViewMode] = useState("grid");
 	const [editSession, setEditSession] = useState(void 0);
+	const [mergeAnchor, setMergeAnchor] = useState(void 0);
 	const { columns: terminalColumns, rows: terminalRows } = useWindowSize();
 	const sheet = resolveSheet(doc.editor, sheetIndex);
 	const { rowCount, columnCount } = sheetExtent(sheet);
@@ -5266,6 +5756,21 @@ function OdsSpreadsheetGridScreen() {
 			seedKind
 		});
 	}
+	function commitMerge(anchor) {
+		const startRow = Math.min(anchor.row, clampedRow);
+		const startColumn = Math.min(anchor.column, clampedColumn);
+		const rowSpan = Math.abs(clampedRow - anchor.row) + 1;
+		const colSpan = Math.abs(clampedColumn - anchor.column) + 1;
+		dispatch({
+			type: "MERGE_CELLS",
+			sheetIndex,
+			startRow,
+			startColumn,
+			rowSpan,
+			colSpan
+		});
+		setMergeAnchor(void 0);
+	}
 	useInput((input) => {
 		if (input === "t") {
 			setViewMode((mode) => mode === "grid" ? "compact" : "grid");
@@ -5313,10 +5818,26 @@ function OdsSpreadsheetGridScreen() {
 			return;
 		}
 		if (key.escape) {
+			if (mergeAnchor !== void 0) {
+				setMergeAnchor(void 0);
+				return;
+			}
 			dispatch({ type: "POP_SCREEN" });
 			return;
 		}
+		if (input === "m") {
+			if (mergeAnchor === void 0) setMergeAnchor({
+				row: clampedRow,
+				column: clampedColumn
+			});
+			else commitMerge(mergeAnchor);
+			return;
+		}
 		if (key.return) {
+			if (mergeAnchor !== void 0) {
+				commitMerge(mergeAnchor);
+				return;
+			}
 			const cell = cells.get(cellKey(clampedRow, clampedColumn));
 			const seedKind = cell === void 0 || cell.value.kind === "empty" ? "string" : cell.value.kind;
 			beginEdit(cell === void 0 ? "" : rawEditableText(cell.value), seedKind);
@@ -5399,10 +5920,11 @@ function OdsSpreadsheetGridScreen() {
 					children: [`${row + 1}`.padStart(4), " "]
 				}), visibleColumns.map((column) => {
 					const isCursor = row === clampedRow && column === clampedColumn;
+					const isAnchor = row === mergeAnchor?.row && column === mergeAnchor?.column;
 					const cell = cells.get(cellKey(row, column));
 					return /* @__PURE__ */ jsx(Text, {
 						inverse: isCursor,
-						color: isCursor ? "cyan" : void 0,
+						color: isCursor ? "cyan" : isAnchor ? "yellow" : void 0,
 						children: padCell(cell === void 0 ? "" : cell.displayText, CELL_WIDTH)
 					}, column);
 				})] }, row))]
@@ -5440,13 +5962,9 @@ function OdsSpreadsheetGridScreen() {
 					setEditSession(void 0);
 				}
 			}),
-			/* @__PURE__ */ jsxs(Text, {
+			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: [
-					"hjkl/arrows move, Enter/type to edit, p print settings, t ",
-					viewMode === "grid" ? "compact list" : "grid",
-					" view, Esc back"
-				]
+				children: mergeAnchor === void 0 ? `hjkl/arrows move, Enter/type to edit, m to anchor a merge, p print settings, t ${viewMode === "grid" ? "compact list" : "grid"} view, Esc back` : "hjkl/arrows to the opposite corner, m/Enter to merge, Esc to cancel"
 			})
 		]
 	});
@@ -6498,6 +7016,7 @@ function ScreenBody({ screen }) {
 		case "slideList": return format === "odp" ? /* @__PURE__ */ jsx(OdpSlideListScreen, {}) : /* @__PURE__ */ jsx(PptxSlideListScreen, {});
 		case "slideDetail": return /* @__PURE__ */ jsx(SlideDetailScreen, { screen });
 		case "shapeEditor": return /* @__PURE__ */ jsx(ShapeEditorScreen, { screen });
+		case "slideTableDetail": return /* @__PURE__ */ jsx(SlideTableDetailScreen, { screen });
 		case "notesEditor": return /* @__PURE__ */ jsx(NotesEditorScreen, { screen });
 		case "sheetList": return /* @__PURE__ */ jsx(OdsSheetListScreen, {});
 		case "spreadsheetGrid": return /* @__PURE__ */ jsx(OdsSpreadsheetGridScreen, {});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-cli",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "CLI and interactive Ink TUI for documents.js: every docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/markdown conversion, bridge, and editor as a scriptable command or a terminal app.",
   "type": "module",
   "repository": {