document-cli 1.4.0 → 1.6.0

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

@@ -1,6 +1,6 @@
-import { d as formatToExtension, f as inferFormatFromExtension, i as formatOdbReportLines, n as describeOdbReport, o as formatDocxExtrasLines, r as formatOdbFormLines, s as readInput, t as describeOdbForm, u as loadProvidedFonts } from "./odb-structure-DkfNyHGR.js";
+import { c as formatDocxExtrasLines, f as loadProvidedFonts, i as formatOdbReportLines, l as readInput, m as inferFormatFromExtension, n as describeOdbReport, o as formatMetadataLines, p as formatToExtension, r as formatOdbFormLines, t as describeOdbForm } from "./odb-structure-Du1w_hOU.js";
 import { readFile, writeFile } from "node:fs/promises";
-import { buildDocxPackage, buildOdtPackage, convertWordprocessingToLayout, createDocx, createFontMeasurer, createFontRegistry, createOdg, createOdp, createOds, createOdt, createPptx, decodeMarkdownText, docxToPdf, encodeMarkdownText, encodePackage, hsqldbCellDisplayText, markdownToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openOdg, openOdp, openOds, openOdt, openPptx, pptxToPdf, readDocxExtras, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdsContent, readPdf, rgbHexToColor, writePdf, xlsxToPdf } from "documents.js";
+import { buildDocxPackage, buildOdtPackage, convertWordprocessingToLayout, createDocx, createFontMeasurer, createFontRegistry, createOdg, createOdp, createOds, createOdt, createPptx, decodeMarkdownText, docxToPdf, encodeMarkdownText, encodePackage, hsqldbCellDisplayText, markdownToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openOdg, openOdp, openOds, openOdt, openPptx, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, writePdf, xlsxToPdf } from "documents.js";
 import { basename, dirname, extname, join } from "node:path";
 import { cellReference, columnIndexToLetters, decodePackage as decodePackage$1, encodePackage as encodePackage$1 } from "odf.js";
 import { readdirSync } from "node:fs";
@@ -219,7 +219,8 @@ function selectionKeyFor(screen) {
 		case "pdfPageList":
 		case "exportOptions":
 		case "saveAsPrompt":
-		case "markdownLineList": return screen.kind;
+		case "markdownLineList":
+		case "metadata": return screen.kind;
 		case "filePicker": return `filePicker:${screen.purpose}:${screen.cwd}`;
 		case "paragraphDetail":
 		case "tableView":
@@ -489,10 +490,6 @@ function shapeAt(doc, containerIndex, shapeIndex) {
 	if (doc.format === "odg") return doc.editor.pages()[containerIndex]?.shapes()[shapeIndex];
 	return doc.editor.slides()[containerIndex]?.shapes()[shapeIndex];
 }
-function rotatableShapeAt(doc, containerIndex, shapeIndex) {
-	if (doc.format === "odg") return doc.editor.pages()[containerIndex]?.shapes()[shapeIndex];
-	return doc.editor.slides()[containerIndex]?.shapes()[shapeIndex];
-}
 function sheetAt(doc, sheetIndex) {
 	return doc.editor.sheets()[sheetIndex];
 }
@@ -525,8 +522,8 @@ function withSheet(state, sheetIndex, apply) {
 		apply(sheet);
 	});
 }
-function setCellText(cell, text) {
-	const paragraph = cell.paragraphs()[0] ?? cell.appendParagraph();
+function setTextContainerText(container, text) {
+	const paragraph = container.paragraphs()[0] ?? container.appendParagraph();
 	const runs = paragraph.runs();
 	const firstRun = runs[0];
 	if (firstRun === void 0) {
@@ -536,6 +533,9 @@ function setCellText(cell, text) {
 	firstRun.text = text;
 	for (const extra of runs.slice(1)) extra.remove();
 }
+function setCellText(cell, text) {
+	setTextContainerText(cell, text);
+}
 function appReducer(state, action) {
 	switch (action.type) {
 		case "PUSH_SCREEN": return {
@@ -720,6 +720,18 @@ function appReducer(state, action) {
 				appended.list = membership;
 			});
 		}
+		case "SET_LIST_ITEM_TEXT": {
+			const doc = wordprocessingDocument(state);
+			if (doc === void 0) return wrongDocument(state, "a docx or odt document");
+			if (doc.format !== "odt") return wrongDocument(state, "an odt document (lists are an odt-only concept)");
+			const list = doc.editor.lists()[action.blockIndex];
+			if (list === void 0) return withStatus(state, "warning", `There is no list at index ${action.blockIndex}`);
+			const item = list.items()[action.itemIndex];
+			if (item === void 0) return withStatus(state, "warning", `List ${action.blockIndex} has no item at index ${action.itemIndex}`);
+			return mutate(state, doc, () => {
+				setTextContainerText(item, action.text);
+			});
+		}
 		case "ADD_SLIDE": {
 			const doc = presentationDocument(state);
 			if (doc === void 0) return wrongDocument(state, "a pptx or odp document");
@@ -792,16 +804,9 @@ function appReducer(state, action) {
 		case "SET_SHAPE_FRAME": return withShape(state, action.containerIndex, action.shapeIndex, (shape) => {
 			shape.frame = action.frame;
 		});
-		case "SET_SHAPE_ROTATION": {
-			const doc = shapeHostDocument(state);
-			if (doc === void 0) return wrongDocument(state, "a pptx, odp or odg document");
-			if (doc.format === "pptx") return withStatus(state, "warning", "documents.js has no rotation setter for a pptx shape; rotate the shape in odp instead");
-			const shape = rotatableShapeAt(doc, action.containerIndex, action.shapeIndex);
-			if (shape === void 0) return withStatus(state, "warning", `There is no shape ${action.shapeIndex} at index ${action.containerIndex}`);
-			return mutate(state, doc, () => {
-				shape.rotationDeg = action.rotationDeg;
-			});
-		}
+		case "SET_SHAPE_ROTATION": return withShape(state, action.containerIndex, action.shapeIndex, (shape) => {
+			shape.rotationDeg = action.rotationDeg;
+		});
 		case "SET_SLIDE_NOTES": {
 			const doc = presentationDocument(state);
 			if (doc === void 0) return wrongDocument(state, "a pptx or odp document");
@@ -1019,6 +1024,11 @@ const COMMANDS = [
 		usage: ":close",
 		description: "Close the open document"
 	},
+	{
+		name: "undo",
+		usage: ":undo",
+		description: "Undo the last change"
+	},
 	{
 		name: "help",
 		usage: ":help",
@@ -1151,6 +1161,9 @@ async function runCommand(line, state, dispatch) {
 		case "close":
 			dispatch({ type: "REQUEST_CLOSE" });
 			return;
+		case "undo":
+			dispatch({ type: "UNDO" });
+			return;
 		case "help":
 			dispatch({
 				type: "OPEN_OVERLAY",
@@ -1417,6 +1430,10 @@ const GLOBAL_KEYS = [
 		keys: "a",
 		description: "Append a new item to the current list"
 	},
+	{
+		keys: "m",
+		description: "Show the open document's metadata (read-only)"
+	},
 	{
 		keys: "Ctrl+S",
 		description: "Save the open document"
@@ -1425,6 +1442,10 @@ const GLOBAL_KEYS = [
 		keys: "Ctrl+W",
 		description: "Close the open document"
 	},
+	{
+		keys: "Ctrl+Z",
+		description: "Undo the last change"
+	},
 	{
 		keys: "q / Ctrl+C",
 		description: "Quit"
@@ -3014,6 +3035,10 @@ function requireShapeOrVectorDetailScreen(state) {
 	if (screen.kind !== "shapeOrVectorDetail") throw new Error(`OdgShapeOrVectorDetailScreen rendered while the top of the stack is '${screen.kind}', not 'shapeOrVectorDetail' -- app.tsx's ScreenBody switch only mounts this component for that screen kind, so this cannot happen without a routing bug.`);
 	return screen;
 }
+function vectorsParityMatch(liveVectors, contentVectors) {
+	if (liveVectors.length !== contentVectors.length) return false;
+	return liveVectors.every((live, index) => live.kind === contentVectors[index]?.kind);
+}
 function buildPageItems(doc, pageIndex) {
 	const page = doc.editor.pages()[pageIndex];
 	if (page === void 0) return [];
@@ -3021,9 +3046,12 @@ function buildPageItems(doc, pageIndex) {
 	if (content.kind !== "drawing") throw new Error(`readOdgContent(doc.editor.toPackage()) returned a '${content.kind}' ContentDocument for an odg-format open document -- an odg package should always read back as the 'drawing' variant, so this indicates a real inconsistency in documents.js's own reader, not a state this screen should paper over.`);
 	const contentPage = content.pages[pageIndex];
 	if (contentPage === void 0) throw new Error(`readOdgContent found no page at index ${pageIndex}, but doc.editor.pages() has a page there -- the two read the same live package, so they should always agree on page count.`);
-	const vectorItems = contentPage.vectors.map((vector) => ({
+	const liveVectors = page.vectors();
+	const parityOk = vectorsParityMatch(liveVectors, contentPage.vectors);
+	const vectorItems = contentPage.vectors.map((vector, index) => ({
 		kind: "vector",
-		vector
+		vector,
+		liveVector: parityOk ? liveVectors[index] : void 0
 	}));
 	const shapeItems = page.shapes().map((shape, index) => {
 		return {
@@ -3315,15 +3343,19 @@ function warnVectorIsViewOnly(dispatch, label) {
 	dispatch({
 		type: "SET_STATUS",
 		severity: "info",
-		text: `${label} added -- documents.js exposes no way to enumerate an existing odg vector, so it will show in this list read-only and cannot be edited or removed from the TUI.`
+		text: `${label} added -- but this page also has a vector element documents.js's OdgPage.vectors() cannot wrap, so every vector on it (including this one) shows read-only in this list rather than risk pairing the wrong live handle to the wrong row.`
 	});
 }
+function warnIfVectorAddedReadOnly(doc, pageIndex, dispatch, label) {
+	const added = buildPageItems(doc, pageIndex).filter((item) => item.kind === "vector").at(-1);
+	if (added !== void 0 && added.liveVector === void 0) warnVectorIsViewOnly(dispatch, label);
+}
 function inferImageFormat(path) {
 	const extension = path.slice(path.lastIndexOf(".") + 1).toLowerCase();
 	if (extension === "png") return "png";
 	if (extension === "jpg" || extension === "jpeg") return "jpeg";
 }
-async function applyAddKind(kind, pageIndex, values, dispatch) {
+async function applyAddKind(kind, pageIndex, doc, values, dispatch) {
 	switch (kind) {
 		case "rect":
 			dispatch({
@@ -3335,7 +3367,7 @@ async function applyAddKind(kind, pageIndex, values, dispatch) {
 					stroke: parseStrokeField(requireFieldValue(values, "stroke"))
 				}
 			});
-			warnVectorIsViewOnly(dispatch, "Rectangle");
+			warnIfVectorAddedReadOnly(doc, pageIndex, dispatch, "Rectangle");
 			return;
 		case "ellipse":
 			dispatch({
@@ -3347,7 +3379,7 @@ async function applyAddKind(kind, pageIndex, values, dispatch) {
 					stroke: parseStrokeField(requireFieldValue(values, "stroke"))
 				}
 			});
-			warnVectorIsViewOnly(dispatch, "Ellipse");
+			warnIfVectorAddedReadOnly(doc, pageIndex, dispatch, "Ellipse");
 			return;
 		case "line":
 			dispatch({
@@ -3372,7 +3404,7 @@ async function applyAddKind(kind, pageIndex, values, dispatch) {
 					}
 				}
 			});
-			warnVectorIsViewOnly(dispatch, "Line");
+			warnIfVectorAddedReadOnly(doc, pageIndex, dispatch, "Line");
 			return;
 		case "path": {
 			const frame = readFrame(values);
@@ -3386,7 +3418,7 @@ async function applyAddKind(kind, pageIndex, values, dispatch) {
 					stroke: parseStrokeField(requireFieldValue(values, "stroke"))
 				}
 			});
-			warnVectorIsViewOnly(dispatch, "Path");
+			warnIfVectorAddedReadOnly(doc, pageIndex, dispatch, "Path");
 			return;
 		}
 		case "textbox":
@@ -3515,7 +3547,7 @@ function AddItemFlow(props) {
 		fields: fieldsForAddKind(kind),
 		onCancel: props.onCancel,
 		onComplete: (values) => {
-			applyAddKind(kind, props.pageIndex, values, dispatch).then(props.onCreated);
+			applyAddKind(kind, props.pageIndex, props.doc, values, dispatch).then(props.onCreated);
 		}
 	});
 }
@@ -3569,6 +3601,7 @@ function OdgPageDetailScreen() {
 	});
 	if (isAdding) return /* @__PURE__ */ jsx(AddItemFlow, {
 		pageIndex,
+		doc,
 		isActive: !overlayOpen,
 		onCancel: () => {
 			setIsAdding(false);
@@ -3602,19 +3635,75 @@ function OdgPageDetailScreen() {
 }
 //#endregion
 //#region src/tui/screens/editors/odg/shape-or-vector-detail.tsx
+function buildVectorRows(vector, liveVector, dispatch) {
+	const rows = [];
+	if (vector.kind !== "line" && liveVector.kind !== "line") {
+		const fillTarget = liveVector;
+		rows.push({
+			label: `Fill: ${vector.fill === void 0 ? "none" : formatColor$1(vector.fill)}`,
+			currentValue: vector.fill === void 0 ? "" : `${vector.fill.r} ${vector.fill.g} ${vector.fill.b}`,
+			commit: (raw) => {
+				dispatch({
+					type: "SET_VECTOR_FILL",
+					vector: fillTarget,
+					fill: parseColorField(raw)
+				});
+			}
+		});
+	}
+	rows.push({
+		label: `Stroke: ${vector.stroke === void 0 ? "none" : `${formatColor$1(vector.stroke.color)} ${formatPt(vector.stroke.widthPt)}pt`}`,
+		currentValue: vector.stroke === void 0 ? "" : `${vector.stroke.color.r} ${vector.stroke.color.g} ${vector.stroke.color.b} ${vector.stroke.widthPt}`,
+		commit: (raw) => {
+			const stroke = parseStrokeField(raw);
+			if (stroke === void 0) {
+				dispatch({
+					type: "SET_STATUS",
+					severity: "warning",
+					text: "A vector stroke cannot be cleared to none through this editor -- enter \"r g b widthPt\" (0-1 colour, pt width) instead"
+				});
+				return;
+			}
+			dispatch({
+				type: "SET_VECTOR_STROKE",
+				vector: liveVector,
+				stroke
+			});
+		}
+	});
+	return rows;
+}
 function VectorDetail(props) {
-	return /* @__PURE__ */ jsxs(Box, {
+	const dispatch = useAppDispatch();
+	const [editingField, setEditingField] = useState(void 0);
+	const [draft, setDraft] = useState("");
+	const { vector, liveVector, isActive } = props;
+	const rows = liveVector === void 0 ? [] : buildVectorRows(vector, liveVector, dispatch);
+	const { selectedIndex } = useNavigationInput({
+		itemCount: rows.length,
+		isActive: isActive && editingField === void 0,
+		onBack: () => {
+			dispatch({ type: "POP_SCREEN" });
+		},
+		onSelect: (index) => {
+			const row = rows[index];
+			if (row === void 0) return;
+			setDraft(row.currentValue);
+			setEditingField(index);
+		}
+	});
+	if (liveVector === void 0) return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [
 			/* @__PURE__ */ jsxs(Text, {
 				bold: true,
-				children: [vectorKindLabel(props.vector.kind), " (view-only)"]
+				children: [vectorKindLabel(vector.kind), " (view-only)"]
 			}),
-			/* @__PURE__ */ jsxs(Text, { children: ["Geometry: ", describeVectorGeometry(props.vector)] }),
-			/* @__PURE__ */ jsx(Text, { children: describeFillStroke(props.vector) }),
+			/* @__PURE__ */ jsxs(Text, { children: ["Geometry: ", describeVectorGeometry(vector)] }),
+			/* @__PURE__ */ jsx(Text, { children: describeFillStroke(vector) }),
 			/* @__PURE__ */ jsx(Text, {
 				color: "yellow",
-				children: "documents.js's OdgPage has no accessor for an existing rect/ellipse/line/path vector, so there is no live handle to edit or remove this one from the TUI -- open the file in a real ODF editor to change it."
+				children: "This page's live vectors (documents.js's `OdgPage.vectors()`) don't line up one-to-one with what odf.js's own reader found here -- likely a `draw:circle`/`polygon`/`polyline`/`custom-shape` element the live accessor has no wrapper for, sitting alongside a plain rect/ellipse/line/path it does. Rather than risk pairing the wrong live handle to this row, every vector on this page is shown read-only until that mismatch is resolved outside this TUI. Open the file in a real ODF editor to change it."
 			}),
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
@@ -3622,6 +3711,53 @@ function VectorDetail(props) {
 			})
 		]
 	});
+	if (editingField !== void 0) {
+		const row = rows[editingField];
+		if (row === void 0) throw new Error(`VectorDetail is editing field index ${editingField}, but there are only ${rows.length} rows -- selecting a row always sets editingField to a valid index from that same rows array, so this indicates a bug in that selection.`);
+		return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			borderStyle: "round",
+			paddingX: 1,
+			children: [/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				children: row.label
+			}), /* @__PURE__ */ jsx(TextField, {
+				value: draft,
+				isFocused: true,
+				onChange: setDraft,
+				onCancel: () => {
+					setEditingField(void 0);
+				},
+				onSubmit: (value) => {
+					row.commit(value);
+					setEditingField(void 0);
+				}
+			})]
+		});
+	}
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				children: vectorKindLabel(vector.kind)
+			}),
+			/* @__PURE__ */ jsxs(Text, { children: ["Geometry: ", describeVectorGeometry(vector)] }),
+			/* @__PURE__ */ jsx(ListView, {
+				items: rows,
+				selectedIndex,
+				reservedRows: 5,
+				renderItem: (row, isSelected) => /* @__PURE__ */ jsxs(Text, {
+					color: isSelected ? "cyan" : void 0,
+					children: [isSelected ? "> " : "  ", row.label]
+				})
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "Enter to edit a field, Esc to go back"
+			})
+		]
+	});
 }
 function ShapeDetail(props) {
 	const dispatch = useAppDispatch();
@@ -3791,7 +3927,7 @@ function OdgShapeOrVectorDetailScreen() {
 	const item = items[itemIndex];
 	useInput((input, key) => {
 		if (key.escape || key.leftArrow || input === "h") dispatch({ type: "POP_SCREEN" });
-	}, { isActive: !overlayOpen && item?.kind !== "shape" });
+	}, { isActive: !overlayOpen && item === void 0 });
 	if (item === void 0) return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [/* @__PURE__ */ jsxs(Text, {
@@ -3808,7 +3944,11 @@ function OdgShapeOrVectorDetailScreen() {
 			children: "Esc to go back"
 		})]
 	});
-	if (item.kind === "vector") return /* @__PURE__ */ jsx(VectorDetail, { vector: item.vector });
+	if (item.kind === "vector") return /* @__PURE__ */ jsx(VectorDetail, {
+		vector: item.vector,
+		liveVector: item.liveVector,
+		isActive: !overlayOpen
+	});
 	const vectorCount = items.filter((entry) => entry.kind === "vector").length;
 	return /* @__PURE__ */ jsx(ShapeDetail, {
 		pageIndex,
@@ -3950,10 +4090,6 @@ function formatRotationDeg(value) {
 	return value === void 0 ? "(unset)" : `${Math.round(value * ROTATION_DISPLAY_PRECISION) / ROTATION_DISPLAY_PRECISION}°`;
 }
 function RotationField(props) {
-	if (!props.isEditable) return /* @__PURE__ */ jsx(Text, {
-		dimColor: true,
-		children: "[R] Rotation: not available for pptx shapes"
-	});
 	if (props.isEditing) return /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(Text, {
 		color: "cyan",
 		children: "[R] Rotation (deg, blank to unset): "
@@ -3987,7 +4123,6 @@ const FIELD_LABELS = {
 	width: "Width (pt)",
 	height: "Height (pt)"
 };
-const ROTATION_UNAVAILABLE_MESSAGE = "documents.js has no rotation setter for a pptx shape; rotate the shape in odp instead";
 const POINT_DISPLAY_PRECISION = 100;
 function formatPoints(value) {
 	return value === void 0 ? "(unset)" : `${Math.round(value * POINT_DISPLAY_PRECISION) / POINT_DISPLAY_PRECISION}pt`;
@@ -4007,9 +4142,9 @@ function describeFieldValue(key, shape) {
 function roundForDisplay(value) {
 	return Math.round(value * POINT_DISPLAY_PRECISION) / POINT_DISPLAY_PRECISION;
 }
-function initialDraftFor(key, shape, rotatableShape) {
+function initialDraftFor(key, shape) {
 	if (key === "rotation") {
-		const value = rotatableShape?.rotationDeg;
+		const value = shape.rotationDeg;
 		return value === void 0 ? "" : String(roundForDisplay(value));
 	}
 	if (key === "text") return shape.text;
@@ -4022,10 +4157,9 @@ function initialDraftFor(key, shape, rotatableShape) {
 	}
 }
 function FieldRow(props) {
-	const { fieldKey, shape, rotatableShape, isOdp, isSelected, isEditing, draft, onDraftChange, onSubmit, onCancel } = props;
+	const { fieldKey, shape, isSelected, isEditing, draft, onDraftChange, onSubmit, onCancel } = props;
 	if (fieldKey === "rotation") return /* @__PURE__ */ jsx(RotationField, {
-		rotationDeg: rotatableShape?.rotationDeg,
-		isEditable: isOdp,
+		rotationDeg: shape.rotationDeg,
 		isSelected,
 		isEditing,
 		draftValue: draft,
@@ -4074,9 +4208,7 @@ function ShapeEditorScreen(props) {
 	const overlayOpen = anyOverlayOpen(state);
 	const doc = assertPresentationDocument(state.openDocument);
 	const { slideIndex, shapeIndex } = props.screen;
-	const isOdp = doc.format === "odp";
 	const shape = doc.editor.slides()[slideIndex]?.shapes()[shapeIndex];
-	const rotatableShape = doc.format === "odp" ? doc.editor.slides()[slideIndex]?.shapes()[shapeIndex] : void 0;
 	const [editingField, setEditingField] = useState(void 0);
 	const [draft, setDraft] = useState("");
 	const { selectedIndex } = useNavigationInput({
@@ -4089,20 +4221,12 @@ function ShapeEditorScreen(props) {
 			if (shape === void 0) return;
 			const key = FIELD_KEYS[index];
 			if (key === void 0) return;
-			if (key === "rotation" && !isOdp) {
-				dispatch({
-					type: "SET_STATUS",
-					severity: "warning",
-					text: ROTATION_UNAVAILABLE_MESSAGE
-				});
-				return;
-			}
 			dispatch({
 				type: "SET_SELECTION",
 				key: selectionKeyFor(props.screen),
 				index
 			});
-			setDraft(initialDraftFor(key, shape, rotatableShape));
+			setDraft(initialDraftFor(key, shape));
 			setEditingField(key);
 		}
 	});
@@ -4227,8 +4351,6 @@ function ShapeEditorScreen(props) {
 				renderItem: (key, isSelected) => /* @__PURE__ */ jsx(FieldRow, {
 					fieldKey: key,
 					shape,
-					rotatableShape,
-					isOdp,
 					isSelected,
 					isEditing: editingField === key,
 					draft,
@@ -5334,28 +5456,40 @@ function OdsSpreadsheetGridScreen() {
 function ListEditorScreen() {
 	const state = useAppState();
 	const dispatch = useAppDispatch();
+	const overlayOpen = anyOverlayOpen(state);
 	const [isAdding, setIsAdding] = useState(false);
 	const [newItemText, setNewItemText] = useState("");
+	const [editingIndex, setEditingIndex] = useState(void 0);
 	const screen = currentScreen(state);
 	const doc = paragraphFamilyDocument(state.openDocument);
 	const list = screen.kind === "listEditor" && doc?.format === "odt" ? doc.editor.lists()[screen.blockIndex] : void 0;
-	const itemCount = list === void 0 ? 0 : list.items().length;
-	useInput((input, key) => {
-		if (list === void 0 || screen.kind !== "listEditor") return;
-		if (key.escape) {
+	const items = list === void 0 ? [] : list.items();
+	const rows = items.map((item, index) => ({
+		item,
+		index
+	}));
+	const itemCount = items.length;
+	const isNavigationActive = !overlayOpen && !isAdding && editingIndex === void 0;
+	const { selectedIndex } = useNavigationInput({
+		itemCount,
+		isActive: isNavigationActive,
+		onBack: () => {
 			dispatch({ type: "POP_SCREEN" });
-			return;
-		}
-		if (input === "a") {
+		},
+		onSelect: (index) => {
+			setEditingIndex(index);
+		},
+		onAppend: () => {
 			setIsAdding(true);
-			return;
 		}
+	});
+	useInput((input, key) => {
 		if (key.tab || input === ">" || input === "<") dispatch({
 			type: "SET_STATUS",
 			severity: "warning",
 			text: "Indenting a list item needs a new reducer action this pass didn't add -- OdtListItem.addNestedList() has no wiring yet"
 		});
-	}, { isActive: !anyOverlayOpen(state) && !isAdding });
+	}, { isActive: isNavigationActive });
 	if (screen.kind !== "listEditor") return /* @__PURE__ */ jsx(Text, {
 		color: "red",
 		children: "ListEditorScreen rendered outside a listEditor screen."
@@ -5372,6 +5506,36 @@ function ListEditorScreen() {
 			"."
 		]
 	});
+	if (editingIndex !== void 0) {
+		const item = items[editingIndex];
+		if (item === void 0) throw new Error(`ListEditorScreen is editing item index ${editingIndex}, but list ${screen.blockIndex} only has ${items.length} items -- selecting a row always sets editingIndex to a valid index from that same items array, so this indicates a bug in that selection.`);
+		return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			children: [/* @__PURE__ */ jsxs(Text, {
+				bold: true,
+				children: [
+					"List ",
+					screen.blockIndex,
+					", item ",
+					editingIndex + 1
+				]
+			}), /* @__PURE__ */ jsx(RunTextEditor, {
+				initialText: item.text,
+				onCommit: (text) => {
+					dispatch({
+						type: "SET_LIST_ITEM_TEXT",
+						blockIndex: screen.blockIndex,
+						itemIndex: editingIndex,
+						text
+					});
+					setEditingIndex(void 0);
+				},
+				onCancel: () => {
+					setEditingIndex(void 0);
+				}
+			})]
+		});
+	}
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [
@@ -5387,13 +5551,23 @@ function ListEditorScreen() {
 					")"
 				]
 			}),
-			itemCount === 0 ? /* @__PURE__ */ jsx(Text, {
-				dimColor: true,
-				children: "This list has no items yet."
-			}) : Array.from({ length: itemCount }, (_, index) => /* @__PURE__ */ jsxs(Text, {
-				dimColor: true,
-				children: [index + 1, ". (item content is not readable through documents.js's OdtListItem API)"]
-			}, index)),
+			/* @__PURE__ */ jsx(ListView, {
+				items: rows,
+				selectedIndex,
+				emptyMessage: "This list has no items yet -- press 'a' to add one.",
+				renderItem: (row, isSelected) => {
+					const trimmed = row.item.text.trim();
+					return /* @__PURE__ */ jsxs(Text, {
+						color: isSelected ? "cyan" : void 0,
+						inverse: isSelected,
+						children: [
+							row.index + 1,
+							". ",
+							trimmed.length === 0 ? "(empty)" : row.item.text
+						]
+					});
+				}
+			}),
 			isAdding ? /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(Text, {
 				color: "cyan",
 				children: "+ "
@@ -5417,7 +5591,7 @@ function ListEditorScreen() {
 				}
 			})] }) : /* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: "a to add an item, Esc back"
+				children: "Enter to edit an item, a to add, Esc back"
 			})
 		]
 	});
@@ -6240,6 +6414,67 @@ function SaveAsPromptScreen() {
 	});
 }
 //#endregion
+//#region src/tui/format/read-metadata.ts
+function metadataFor(doc) {
+	switch (doc.format) {
+		case "docx": return readDocxContent(doc.editor.toPackage()).metadata;
+		case "pptx": return readPptxContent(doc.editor.toPackage()).metadata;
+		case "odt": return readOdtContent(doc.editor.toPackage()).metadata;
+		case "odp": return readOdpContent(doc.editor.toPackage()).metadata;
+		case "ods": return readOdsContent(doc.editor.toPackage()).metadata;
+		case "odg": return readOdgContent(doc.editor.toPackage()).metadata;
+		case "markdown": return readMarkdownContent(doc.source).metadata;
+		case "pdf":
+		case "xlsx": return doc.layout.metadata;
+		case "odb": throw new Error("A .odb database has no document-level metadata -- it is a table/form/report container, not a single document with its own title/author/etc.");
+	}
+}
+//#endregion
+//#region src/tui/screens/shared/metadata.tsx
+function MetadataScreen() {
+	const state = useAppState();
+	const dispatch = useAppDispatch();
+	const doc = state.openDocument;
+	useInput((input, key) => {
+		if (key.escape || key.leftArrow || input === "h") dispatch({ type: "POP_SCREEN" });
+	}, { isActive: doc !== void 0 && !anyOverlayOpen(state) });
+	if (doc === void 0) return /* @__PURE__ */ jsx(Text, {
+		color: "red",
+		children: "MetadataScreen requires an open document."
+	});
+	let lines;
+	let errorMessage;
+	try {
+		lines = formatMetadataLines(metadataFor(doc));
+	} catch (error) {
+		errorMessage = error instanceof Error ? error.message : String(error);
+	}
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Text, {
+				bold: true,
+				children: [
+					"Document metadata (",
+					doc.format,
+					")"
+				]
+			}),
+			errorMessage !== void 0 ? /* @__PURE__ */ jsx(Text, {
+				color: "yellow",
+				children: errorMessage
+			}) : lines !== void 0 && lines.length > 0 ? lines.map((line) => /* @__PURE__ */ jsx(Text, { children: line }, line)) : /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "This document carries no metadata."
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "Esc / ← / h to go back"
+			})
+		]
+	});
+}
+//#endregion
 //#region src/tui/app.tsx
 function App(props) {
 	return /* @__PURE__ */ jsx(AppStateProvider, {
@@ -6285,6 +6520,7 @@ function ScreenBody({ screen }) {
 		case "pdfItemDetail": return /* @__PURE__ */ jsx(PdfItemDetailScreen, {});
 		case "exportOptions": return /* @__PURE__ */ jsx(ExportOptionsScreen, {});
 		case "saveAsPrompt": return /* @__PURE__ */ jsx(SaveAsPromptScreen, {});
+		case "metadata": return /* @__PURE__ */ jsx(MetadataScreen, {});
 	}
 }
 function Overlay({ state }) {
@@ -6374,6 +6610,10 @@ function AppShell({ startPath }) {
 			dispatch({ type: "REQUEST_CLOSE" });
 			return;
 		}
+		if (key.ctrl && input === "z") {
+			dispatch({ type: "UNDO" });
+			return;
+		}
 		if (input === ":") {
 			dispatch({
 				type: "OPEN_OVERLAY",
@@ -6395,10 +6635,27 @@ function AppShell({ startPath }) {
 			});
 			return;
 		}
-		if (key.ctrl && input === "d") dispatch({
-			type: "OPEN_OVERLAY",
-			overlay: "diagnosticsPanel"
-		});
+		if (key.ctrl && input === "d") {
+			dispatch({
+				type: "OPEN_OVERLAY",
+				overlay: "diagnosticsPanel"
+			});
+			return;
+		}
+		if (input === "m") {
+			if (state.openDocument === void 0) {
+				dispatch({
+					type: "SET_STATUS",
+					severity: "warning",
+					text: "There is no open document to show metadata for"
+				});
+				return;
+			}
+			dispatch({
+				type: "PUSH_SCREEN",
+				screen: { kind: "metadata" }
+			});
+		}
 	}, { isActive: !overlayOpen });
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",