document-cli 1.9.0 → 1.10.0

package/dist/{tui-D9SLI7oT.js → tui-BVeYd0ry.js}

@@ -1,6 +1,6 @@
 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, bytesToBase64, 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, parseXml, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, writePdf, xlsxToPdf } from "documents.js";
+import { buildDocxPackage, buildOdtPackage, bytesToBase64, convertWordprocessingToLayout, createDocx, createFontMeasurer, createFontRegistry, createOdg, createOdp, createOds, createOdt, createPdf, createPptx, decodeMarkdownText, docxToPdf, encodeMarkdownText, encodePackage, hsqldbCellDisplayText, markdownToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openOdg, openOdp, openOds, openOdt, openPdf, openPptx, parseXml, 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";
@@ -36,7 +36,7 @@ function toPdfOptions(options, fonts) {
 	};
 }
 async function exportToPdf(openDocument, destinationPath, options) {
-	if (openDocument.format === "odb" || openDocument.format === "pdf") throw new Error(`A ${openDocument.format} document is already a read-only source; there is no export-to-PDF path for it`);
+	if (openDocument.format === "odb" || openDocument.format === "pdf") throw new Error(`A ${openDocument.format} document has no export-to-PDF path -- ${openDocument.format === "pdf" ? "save it directly instead" : "it is a read-only source with nothing to convert"}`);
 	const pdfOptions = toPdfOptions(options, await loadProvidedFonts(options.fontFiles ?? [], { signal: options.signal }));
 	if (openDocument.format === "markdown") {
 		const pdfBytes = markdownToPdf(encodeMarkdownText(openDocument.source), pdfOptions);
@@ -120,11 +120,15 @@ async function openDocumentAtPath(path) {
 			editor: openOdg(bytes),
 			path
 		};
-		case "pdf": return {
-			format,
-			layout: readPdf(bytes),
-			path
-		};
+		case "pdf": {
+			const editor = openPdf(bytes);
+			return {
+				format,
+				editor,
+				layout: editor.toLayoutDocument(),
+				path
+			};
+		}
 		case "markdown": return {
 			format,
 			source: decodeMarkdownText(bytes),
@@ -171,10 +175,19 @@ function createNewDocument(format) {
 			editor: createOdg(),
 			path: void 0
 		};
+		case "pdf": {
+			const editor = createPdf();
+			return {
+				format,
+				editor,
+				layout: editor.toLayoutDocument(),
+				path: void 0
+			};
+		}
 	}
 }
 async function saveDocumentTo(openDocument, path) {
-	if (openDocument.format === "odb" || openDocument.format === "pdf" || openDocument.format === "xlsx") throw new Error(`A ${openDocument.format} document is opened read-only and cannot be written back`);
+	if (openDocument.format === "odb" || openDocument.format === "xlsx") throw new Error(`A ${openDocument.format} document is opened read-only and cannot be written back`);
 	if (openDocument.format === "markdown") {
 		await writeFile(path, encodeMarkdownText(openDocument.source));
 		return;
@@ -189,7 +202,8 @@ const EDITABLE_FORMATS = {
 	odt: true,
 	odp: true,
 	ods: true,
-	odg: true
+	odg: true,
+	pdf: true
 };
 const WRITABLE_FORMATS = {
 	...EDITABLE_FORMATS,
@@ -368,6 +382,12 @@ function documentWithPath(doc, path) {
 			editor: doc.editor,
 			path
 		};
+		case "pdf": return {
+			format: "pdf",
+			editor: doc.editor,
+			layout: doc.layout,
+			path
+		};
 		case "odb": return {
 			format: "odb",
 			tables: doc.tables,
@@ -380,11 +400,6 @@ function documentWithPath(doc, path) {
 			source: doc.source,
 			path
 		};
-		case "pdf": return {
-			format: "pdf",
-			layout: doc.layout,
-			path
-		};
 		case "xlsx": return {
 			format: "xlsx",
 			layout: doc.layout,
@@ -425,6 +440,15 @@ function reopenEditable(doc, bytes) {
 			editor: openOdg(bytes),
 			path: doc.path
 		};
+		case "pdf": {
+			const editor = openPdf(bytes);
+			return {
+				format: "pdf",
+				editor,
+				layout: editor.toLayoutDocument(),
+				path: doc.path
+			};
+		}
 	}
 }
 function mutate(state, doc, apply) {
@@ -508,6 +532,40 @@ function drawingDocument(state) {
 	if (doc === void 0) return;
 	return doc.format === "odg" ? doc : void 0;
 }
+function pdfDocument(state) {
+	const doc = state.openDocument;
+	if (doc === void 0) return;
+	return doc.format === "pdf" ? doc : void 0;
+}
+function pdfItemAt(doc, pageIndex, itemIndex) {
+	return doc.editor.page(pageIndex)?.items()[itemIndex];
+}
+function withPdfPage(state, pageIndex, apply) {
+	const doc = pdfDocument(state);
+	if (doc === void 0) return wrongDocument(state, "a pdf document");
+	const page = doc.editor.page(pageIndex);
+	if (page === void 0) return withStatus(state, "warning", `There is no page at index ${pageIndex}`);
+	return mutate(state, doc, () => {
+		apply(page);
+	});
+}
+function withPdfItemMatching(state, pageIndex, itemIndex, guard, kindLabel, apply) {
+	const doc = pdfDocument(state);
+	if (doc === void 0) return wrongDocument(state, "a pdf document");
+	const item = pdfItemAt(doc, pageIndex, itemIndex);
+	if (item === void 0) return withStatus(state, "warning", `Page ${pageIndex} has no item at index ${itemIndex}`);
+	if (!guard(item)) return withStatus(state, "warning", `Item ${itemIndex} on page ${pageIndex} is a ${item.kind} item, not ${kindLabel}`);
+	return mutate(state, doc, () => {
+		apply(item);
+	});
+}
+const isPdfTextItem = (item) => item.kind === "text";
+const isPdfRectItem = (item) => item.kind === "rect";
+const isPdfEllipseItem = (item) => item.kind === "ellipse";
+const isPdfLineItem = (item) => item.kind === "line";
+const isPdfPathItem = (item) => item.kind === "path";
+const isPdfImageItem = (item) => item.kind === "image";
+const isPdfLinkItem = (item) => item.kind === "link";
 function vectorHostDocument(state) {
 	const doc = state.openDocument;
 	if (doc === void 0) return;
@@ -1078,6 +1136,129 @@ function appReducer(state, action) {
 				action.vector.stroke = action.stroke;
 			});
 		}
+		case "ADD_PDF_TEXT": return withPdfPage(state, action.pageIndex, (page) => {
+			page.appendText(action.init);
+		});
+		case "ADD_PDF_RECT": return withPdfPage(state, action.pageIndex, (page) => {
+			page.appendRect(action.init);
+		});
+		case "ADD_PDF_ELLIPSE": return withPdfPage(state, action.pageIndex, (page) => {
+			page.appendEllipse(action.init);
+		});
+		case "ADD_PDF_LINE": return withPdfPage(state, action.pageIndex, (page) => {
+			page.appendLine(action.init);
+		});
+		case "ADD_PDF_PATH": return withPdfPage(state, action.pageIndex, (page) => {
+			page.appendPath(action.init);
+		});
+		case "ADD_PDF_IMAGE": return withPdfPage(state, action.pageIndex, (page) => {
+			page.appendImage(action.init);
+		});
+		case "ADD_PDF_LINK": return withPdfPage(state, action.pageIndex, (page) => {
+			page.appendLink(action.init);
+		});
+		case "REMOVE_PDF_ITEM": {
+			const doc = pdfDocument(state);
+			if (doc === void 0) return wrongDocument(state, "a pdf document");
+			const item = pdfItemAt(doc, action.pageIndex, action.itemIndex);
+			if (item === void 0) return withStatus(state, "warning", `Page ${action.pageIndex} has no item at index ${action.itemIndex}`);
+			return mutate(state, doc, () => {
+				item.remove();
+			});
+		}
+		case "SET_PDF_TEXT_TEXT": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfTextItem, "text", (item) => {
+			item.text = action.text;
+		});
+		case "SET_PDF_TEXT_POSITION": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfTextItem, "text", (item) => {
+			item.xPt = action.xPt;
+			item.yPt = action.yPt;
+		});
+		case "SET_PDF_TEXT_FONT": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfTextItem, "text", (item) => {
+			item.font = action.font;
+		});
+		case "SET_PDF_TEXT_SIZE": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfTextItem, "text", (item) => {
+			item.sizePt = action.sizePt;
+		});
+		case "SET_PDF_TEXT_COLOR": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfTextItem, "text", (item) => {
+			item.color = action.color;
+		});
+		case "SET_PDF_TEXT_ROTATION": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfTextItem, "text", (item) => {
+			item.rotationDeg = action.rotationDeg;
+		});
+		case "SET_PDF_TEXT_WIDTH": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfTextItem, "text", (item) => {
+			item.widthPt = action.widthPt;
+		});
+		case "TOGGLE_PDF_TEXT_UNDERLINE": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfTextItem, "text", (item) => {
+			item.underline = !(item.underline ?? false);
+		});
+		case "SET_PDF_RECT_FRAME": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfRectItem, "rect", (item) => {
+			item.xPt = action.xPt;
+			item.yPt = action.yPt;
+			item.widthPt = action.widthPt;
+			item.heightPt = action.heightPt;
+		});
+		case "SET_PDF_RECT_FILL": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfRectItem, "rect", (item) => {
+			item.fill = action.fill;
+		});
+		case "SET_PDF_RECT_STROKE": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfRectItem, "rect", (item) => {
+			item.stroke = action.stroke;
+		});
+		case "SET_PDF_ELLIPSE_FRAME": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfEllipseItem, "ellipse", (item) => {
+			item.xPt = action.xPt;
+			item.yPt = action.yPt;
+			item.widthPt = action.widthPt;
+			item.heightPt = action.heightPt;
+		});
+		case "SET_PDF_ELLIPSE_FILL": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfEllipseItem, "ellipse", (item) => {
+			item.fill = action.fill;
+		});
+		case "SET_PDF_ELLIPSE_STROKE": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfEllipseItem, "ellipse", (item) => {
+			item.stroke = action.stroke;
+		});
+		case "SET_PDF_LINE_FROM": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfLineItem, "line", (item) => {
+			item.x1Pt = action.x1Pt;
+			item.y1Pt = action.y1Pt;
+		});
+		case "SET_PDF_LINE_TO": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfLineItem, "line", (item) => {
+			item.x2Pt = action.x2Pt;
+			item.y2Pt = action.y2Pt;
+		});
+		case "SET_PDF_LINE_COLOR": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfLineItem, "line", (item) => {
+			item.color = action.color;
+		});
+		case "SET_PDF_LINE_WIDTH": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfLineItem, "line", (item) => {
+			item.widthPt = action.widthPt;
+		});
+		case "SET_PDF_PATH_FILL": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfPathItem, "path", (item) => {
+			item.fill = action.fill;
+		});
+		case "SET_PDF_PATH_FILL_RULE": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfPathItem, "path", (item) => {
+			item.fillRule = action.fillRule;
+		});
+		case "SET_PDF_PATH_STROKE": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfPathItem, "path", (item) => {
+			item.stroke = action.stroke;
+		});
+		case "SET_PDF_IMAGE_FRAME": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfImageItem, "image", (item) => {
+			item.xPt = action.xPt;
+			item.yPt = action.yPt;
+			item.widthPt = action.widthPt;
+			item.heightPt = action.heightPt;
+		});
+		case "SET_PDF_IMAGE_ROTATION": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfImageItem, "image", (item) => {
+			item.rotationDeg = action.rotationDeg;
+		});
+		case "SET_PDF_IMAGE_SOURCE": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfImageItem, "image", (item) => {
+			item.setImage(action.bytes, action.format);
+		});
+		case "SET_PDF_LINK_URI": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfLinkItem, "link", (item) => {
+			item.uri = action.uri;
+		});
+		case "SET_PDF_LINK_FRAME": return withPdfItemMatching(state, action.pageIndex, action.itemIndex, isPdfLinkItem, "link", (item) => {
+			item.xPt = action.xPt;
+			item.yPt = action.yPt;
+			item.widthPt = action.widthPt;
+			item.heightPt = action.heightPt;
+		});
 		case "SET_MARKDOWN_SOURCE": {
 			const doc = markdownDocument(state);
 			if (doc === void 0) return wrongDocument(state, "a markdown document");
@@ -1111,7 +1292,7 @@ function appReducer(state, action) {
 		case "UNDO": {
 			const doc = state.openDocument;
 			if (doc === void 0) return withStatus(state, "info", "There is nothing to undo");
-			if (doc.format === "odb" || doc.format === "pdf" || doc.format === "xlsx") return withStatus(state, "warning", `A ${doc.format} document is read-only, so it has no history to undo`);
+			if (doc.format === "odb" || doc.format === "xlsx") return withStatus(state, "warning", `A ${doc.format} document is read-only, so it has no history to undo`);
 			const snapshot = state.undoStack.at(-1);
 			if (snapshot === void 0) return withStatus(state, "info", "There is nothing to undo");
 			const restored = doc.format === "markdown" ? {
@@ -1195,7 +1376,7 @@ function TextField(props) {
 }
 //#endregion
 //#region src/tui/components/command-palette.tsx
-const USAGE_COLUMN_WIDTH = 32;
+const USAGE_COLUMN_WIDTH = 36;
 const COMMANDS = [
 	{
 		name: "save",
@@ -1214,7 +1395,7 @@ const COMMANDS = [
 	},
 	{
 		name: "new",
-		usage: ":new docx|pptx|odt|odp|ods|odg",
+		usage: ":new docx|pptx|odt|odp|ods|odg|pdf",
 		description: "Create an empty document"
 	},
 	{
@@ -1331,7 +1512,7 @@ async function runCommand(line, state, dispatch) {
 		case "new": {
 			const format = args[0];
 			if (format === void 0 || !isEditableFormat(format)) {
-				warn(dispatch, "Usage: :new docx|pptx|odt|odp|ods|odg");
+				warn(dispatch, "Usage: :new docx|pptx|odt|odp|ods|odg|pdf");
 				return;
 			}
 			dispatch({
@@ -2522,14 +2703,14 @@ const IMAGE_FIELDS = [
 		defaultValue: ""
 	}
 ];
-function inferImageFormat$1(path) {
+function inferImageFormat$2(path) {
 	const extension = path.slice(path.lastIndexOf(".") + 1).toLowerCase();
 	if (extension === "png") return "png";
 	if (extension === "jpg" || extension === "jpeg") return "jpeg";
 }
 async function applyInsertImage(blockIndex, values, dispatch) {
 	const path = requireFieldValue(values, "path");
-	const format = inferImageFormat$1(path);
+	const format = inferImageFormat$2(path);
 	if (format === void 0) {
 		dispatch({
 			type: "SET_STATUS",
@@ -4012,14 +4193,14 @@ function vectorKindLabel(kind) {
 		case "path": return "Path";
 	}
 }
-function formatPt(value) {
+function formatPt$1(value) {
 	return value.toFixed(1);
 }
 function formatFrame(box) {
-	return `${formatPt(box.xPt)},${formatPt(box.yPt)} ${formatPt(box.widthPt)}x${formatPt(box.heightPt)}pt`;
+	return `${formatPt$1(box.xPt)},${formatPt$1(box.yPt)} ${formatPt$1(box.widthPt)}x${formatPt$1(box.heightPt)}pt`;
 }
 function formatPoint$1(point) {
-	return `${formatPt(point.xPt)},${formatPt(point.yPt)}`;
+	return `${formatPt$1(point.xPt)},${formatPt$1(point.yPt)}`;
 }
 function formatColor$1(color) {
 	return `rgb(${color.r.toFixed(2)}, ${color.g.toFixed(2)}, ${color.b.toFixed(2)})`;
@@ -4031,7 +4212,7 @@ function describeVectorGeometry(vector) {
 function describeFillStroke(vector) {
 	const parts = [];
 	if (vector.kind !== "line" && vector.fill !== void 0) parts.push(`fill ${formatColor$1(vector.fill)}`);
-	if (vector.stroke !== void 0) parts.push(`stroke ${formatColor$1(vector.stroke.color)} ${formatPt(vector.stroke.widthPt)}pt`);
+	if (vector.stroke !== void 0) parts.push(`stroke ${formatColor$1(vector.stroke.color)} ${formatPt$1(vector.stroke.widthPt)}pt`);
 	return parts.length === 0 ? "no fill or stroke" : parts.join(", ");
 }
 //#endregion
@@ -4098,7 +4279,7 @@ function OdgPageListScreen() {
 }
 //#endregion
 //#region src/tui/screens/editors/odg/page-detail.tsx
-const ADD_KIND_OPTIONS = [
+const ADD_KIND_OPTIONS$1 = [
 	{
 		kind: "rect",
 		label: "Rectangle"
@@ -4124,7 +4305,7 @@ const ADD_KIND_OPTIONS = [
 		label: "Image"
 	}
 ];
-const GEOMETRY_FIELDS = [
+const GEOMETRY_FIELDS$1 = [
 	{
 		key: "xPt",
 		label: "X (pt)",
@@ -4146,24 +4327,24 @@ const GEOMETRY_FIELDS = [
 		defaultValue: "100"
 	}
 ];
-const FILL_FIELD = {
+const FILL_FIELD$1 = {
 	key: "fill",
 	label: "Fill \"r g b\" (0-1 each), blank for none",
 	defaultValue: "0.8 0.8 0.8"
 };
-const STROKE_FIELD = {
+const STROKE_FIELD$1 = {
 	key: "stroke",
 	label: "Stroke \"r g b widthPt\" (0-1 colour, pt width), blank for none",
 	defaultValue: "0 0 0 1"
 };
-function fieldsForAddKind(kind) {
+function fieldsForAddKind$1(kind) {
 	switch (kind) {
 		case "rect":
 		case "ellipse":
 		case "path": return [
-			...GEOMETRY_FIELDS,
-			FILL_FIELD,
-			STROKE_FIELD
+			...GEOMETRY_FIELDS$1,
+			FILL_FIELD$1,
+			STROKE_FIELD$1
 		];
 		case "line": return [
 			{
@@ -4186,15 +4367,15 @@ function fieldsForAddKind(kind) {
 				label: "To Y (pt)",
 				defaultValue: "40"
 			},
-			STROKE_FIELD
+			STROKE_FIELD$1
 		];
-		case "textbox": return [...GEOMETRY_FIELDS, {
+		case "textbox": return [...GEOMETRY_FIELDS$1, {
 			key: "text",
 			label: "Text",
 			defaultValue: "Text"
 		}];
 		case "image": return [
-			...GEOMETRY_FIELDS,
+			...GEOMETRY_FIELDS$1,
 			{
 				key: "path",
 				label: "Image file path (.png/.jpg/.jpeg)",
@@ -4208,7 +4389,7 @@ function fieldsForAddKind(kind) {
 		];
 	}
 }
-function readFrame(values) {
+function readFrame$1(values) {
 	return {
 		xPt: parseNumberField(requireFieldValue(values, "xPt"), 0),
 		yPt: parseNumberField(requireFieldValue(values, "yPt"), 0),
@@ -4227,19 +4408,19 @@ 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) {
+function inferImageFormat$1(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, doc, values, dispatch) {
+async function applyAddKind$1(kind, pageIndex, doc, values, dispatch) {
 	switch (kind) {
 		case "rect":
 			dispatch({
 				type: "ADD_RECT",
 				containerIndex: pageIndex,
 				init: {
-					frame: readFrame(values),
+					frame: readFrame$1(values),
 					fill: parseColorField(requireFieldValue(values, "fill")),
 					stroke: parseStrokeField(requireFieldValue(values, "stroke"))
 				}
@@ -4251,7 +4432,7 @@ async function applyAddKind(kind, pageIndex, doc, values, dispatch) {
 				type: "ADD_ELLIPSE",
 				containerIndex: pageIndex,
 				init: {
-					frame: readFrame(values),
+					frame: readFrame$1(values),
 					fill: parseColorField(requireFieldValue(values, "fill")),
 					stroke: parseStrokeField(requireFieldValue(values, "stroke"))
 				}
@@ -4284,7 +4465,7 @@ async function applyAddKind(kind, pageIndex, doc, values, dispatch) {
 			warnIfVectorAddedReadOnly(doc, pageIndex, dispatch, "Line");
 			return;
 		case "path": {
-			const frame = readFrame(values);
+			const frame = readFrame$1(values);
 			dispatch({
 				type: "ADD_PATH",
 				containerIndex: pageIndex,
@@ -4302,14 +4483,14 @@ async function applyAddKind(kind, pageIndex, doc, values, dispatch) {
 			dispatch({
 				type: "ADD_TEXTBOX",
 				containerIndex: pageIndex,
-				frame: readFrame(values),
+				frame: readFrame$1(values),
 				text: requireFieldValue(values, "text")
 			});
 			return;
 		case "image": {
-			const frame = readFrame(values);
+			const frame = readFrame$1(values);
 			const path = requireFieldValue(values, "path");
-			const format = inferImageFormat(path);
+			const format = inferImageFormat$1(path);
 			if (format === void 0) {
 				dispatch({
 					type: "SET_STATUS",
@@ -4340,15 +4521,15 @@ async function applyAddKind(kind, pageIndex, doc, values, dispatch) {
 		}
 	}
 }
-function AddItemFlow(props) {
+function AddItemFlow$1(props) {
 	const dispatch = useAppDispatch();
 	const [kind, setKind] = useState(void 0);
 	const { selectedIndex } = useNavigationInput({
-		itemCount: ADD_KIND_OPTIONS.length,
+		itemCount: ADD_KIND_OPTIONS$1.length,
 		isActive: props.isActive && kind === void 0,
 		onBack: props.onCancel,
 		onSelect: (index) => {
-			const option = ADD_KIND_OPTIONS[index];
+			const option = ADD_KIND_OPTIONS$1[index];
 			if (option === void 0) return;
 			setKind(option.kind);
 		}
@@ -4361,7 +4542,7 @@ function AddItemFlow(props) {
 			bold: true,
 			children: "Add item -- choose a kind"
 		}), /* @__PURE__ */ jsx(ListView, {
-			items: ADD_KIND_OPTIONS,
+			items: ADD_KIND_OPTIONS$1,
 			selectedIndex,
 			reservedRows: 6,
 			renderItem: (option, isSelected) => /* @__PURE__ */ jsxs(Text, {
@@ -4371,10 +4552,10 @@ function AddItemFlow(props) {
 		})]
 	});
 	return /* @__PURE__ */ jsx(FieldWizard, {
-		fields: fieldsForAddKind(kind),
+		fields: fieldsForAddKind$1(kind),
 		onCancel: props.onCancel,
 		onComplete: (values) => {
-			applyAddKind(kind, props.pageIndex, props.doc, values, dispatch).then(props.onCreated);
+			applyAddKind$1(kind, props.pageIndex, props.doc, values, dispatch).then(props.onCreated);
 		}
 	});
 }
@@ -4426,7 +4607,7 @@ function OdgPageDetailScreen() {
 			setIsAdding(true);
 		}
 	});
-	if (isAdding) return /* @__PURE__ */ jsx(AddItemFlow, {
+	if (isAdding) return /* @__PURE__ */ jsx(AddItemFlow$1, {
 		pageIndex,
 		doc,
 		isActive: !overlayOpen,
@@ -4479,7 +4660,7 @@ function buildVectorRows(vector, liveVector, dispatch) {
 		});
 	}
 	rows.push({
-		label: `Stroke: ${vector.stroke === void 0 ? "none" : `${formatColor$1(vector.stroke.color)} ${formatPt(vector.stroke.widthPt)}pt`}`,
+		label: `Stroke: ${vector.stroke === void 0 ? "none" : `${formatColor$1(vector.stroke.color)} ${formatPt$1(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);
@@ -4611,7 +4792,7 @@ function ShapeDetail(props) {
 			}
 		},
 		{
-			label: `X: ${formatPt(frame.xPt)}pt`,
+			label: `X: ${formatPt$1(frame.xPt)}pt`,
 			currentValue: String(frame.xPt),
 			commit: (raw) => {
 				dispatch({
@@ -4626,7 +4807,7 @@ function ShapeDetail(props) {
 			}
 		},
 		{
-			label: `Y: ${formatPt(frame.yPt)}pt`,
+			label: `Y: ${formatPt$1(frame.yPt)}pt`,
 			currentValue: String(frame.yPt),
 			commit: (raw) => {
 				dispatch({
@@ -4641,7 +4822,7 @@ function ShapeDetail(props) {
 			}
 		},
 		{
-			label: `Width: ${formatPt(frame.widthPt)}pt`,
+			label: `Width: ${formatPt$1(frame.widthPt)}pt`,
 			currentValue: String(frame.widthPt),
 			commit: (raw) => {
 				dispatch({
@@ -4656,7 +4837,7 @@ function ShapeDetail(props) {
 			}
 		},
 		{
-			label: `Height: ${formatPt(frame.heightPt)}pt`,
+			label: `Height: ${formatPt$1(frame.heightPt)}pt`,
 			currentValue: String(frame.heightPt),
 			commit: (raw) => {
 				dispatch({
@@ -4671,7 +4852,7 @@ function ShapeDetail(props) {
 			}
 		},
 		{
-			label: `Rotation: ${shape.rotationDeg === void 0 ? "none" : `${formatPt(shape.rotationDeg)} deg`}`,
+			label: `Rotation: ${shape.rotationDeg === void 0 ? "none" : `${formatPt$1(shape.rotationDeg)} deg`}`,
 			currentValue: shape.rotationDeg === void 0 ? "" : String(shape.rotationDeg),
 			commit: (raw) => {
 				const trimmed = raw.trim();
@@ -6997,9 +7178,58 @@ function requirePdfDocument(openDocument) {
 	if (openDocument?.format !== "pdf" && openDocument?.format !== "xlsx") throw new Error("A PDF inspection screen rendered without an open PDF or xlsx document; the app router only reaches this screen group from pdfPageList, which is only ever the root screen of one of those two formats.");
 	return openDocument;
 }
+function isEditablePdfDocument(doc) {
+	return doc.format === "pdf";
+}
 function formatSize(widthPt, heightPt) {
 	return `${widthPt.toFixed(0)}×${heightPt.toFixed(0)}pt`;
 }
+function formatPt(value) {
+	return value.toFixed(1);
+}
+function formatColor(color) {
+	const byte = (component) => Math.round(component * 255).toString(16).padStart(2, "0");
+	return `#${byte(color.r)}${byte(color.g)}${byte(color.b)}`;
+}
+function formatStroke(stroke) {
+	return `${formatColor(stroke.color)} @ ${stroke.widthPt.toFixed(1)}pt`;
+}
+function parseRequiredColorField(raw, fallback) {
+	return parseColorField(raw) ?? fallback;
+}
+function parseFontWeight(raw) {
+	return raw.trim().toLowerCase() === "bold" ? "bold" : "normal";
+}
+function parseFontStyle(raw) {
+	return raw.trim().toLowerCase() === "italic" ? "italic" : "normal";
+}
+function parseOptionalNumberField(raw) {
+	const trimmed = raw.trim();
+	if (trimmed.length === 0) return;
+	const parsed = Number.parseFloat(trimmed);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function defaultTriangleLayoutSubpaths(widthPt, heightPt) {
+	return [{
+		startXPt: 0,
+		startYPt: heightPt,
+		segments: [{
+			kind: "line",
+			xPt: widthPt / 2,
+			yPt: 0
+		}, {
+			kind: "line",
+			xPt: widthPt,
+			yPt: heightPt
+		}],
+		closed: true
+	}];
+}
+function inferImageFormat(path) {
+	const extension = path.slice(path.lastIndexOf(".") + 1).toLowerCase();
+	if (extension === "png") return "png";
+	if (extension === "jpg" || extension === "jpeg") return "jpeg";
+}
 //#endregion
 //#region src/tui/screens/editors/pdf/page-list.tsx
 const LAYOUT_ITEM_KIND_ORDER = [
@@ -7088,13 +7318,6 @@ function PdfPageListScreen() {
 function formatPoint(xPt, yPt) {
 	return `(${xPt.toFixed(1)}, ${yPt.toFixed(1)})pt`;
 }
-function formatColor(color) {
-	const byte = (component) => Math.round(component * 255).toString(16).padStart(2, "0");
-	return `#${byte(color.r)}${byte(color.g)}${byte(color.b)}`;
-}
-function formatStroke(stroke) {
-	return `${formatColor(stroke.color)} @ ${stroke.widthPt.toFixed(1)}pt`;
-}
 function fieldsFor(item) {
 	const fields = [["Kind", item.kind]];
 	switch (item.kind) {
@@ -7146,19 +7369,10 @@ function fieldsFor(item) {
 	if (item.sourcePath !== void 0) fields.push(["Source path", item.sourcePath]);
 	return fields;
 }
-function PdfItemDetailScreen() {
-	const state = useAppState();
-	const dispatch = useAppDispatch();
-	const doc = requirePdfDocument(state.openDocument);
-	const screen = currentScreen(state);
-	if (screen.kind !== "pdfItemDetail") throw new Error(`PdfItemDetailScreen rendered while the current screen is "${screen.kind}", not "pdfItemDetail".`);
-	const page = doc.layout.pages[screen.pageIndex];
-	if (page === void 0) throw new Error(`pdfItemDetail was pushed for page ${screen.pageIndex}, but the open PDF has no page at that index.`);
-	const item = page.items[screen.itemIndex];
-	if (item === void 0) throw new Error(`pdfItemDetail was pushed for item ${screen.itemIndex} on page ${screen.pageIndex}, but that page has no item at that index.`);
+function ReadOnlyItemDetail(props) {
 	useInput((input, key) => {
-		if (key.escape || key.leftArrow || input === "h") dispatch({ type: "POP_SCREEN" });
-	}, { isActive: !anyOverlayOpen(state) });
+		if (key.escape || key.leftArrow || input === "h") props.onBack();
+	}, { isActive: props.isActive });
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [
@@ -7166,12 +7380,12 @@ function PdfItemDetailScreen() {
 				bold: true,
 				children: [
 					"Page ",
-					screen.pageIndex + 1,
+					props.pageIndex + 1,
 					", item ",
-					screen.itemIndex + 1
+					props.itemIndex + 1
 				]
 			}),
-			fieldsFor(item).map(([label, value]) => /* @__PURE__ */ jsxs(Text, { children: [
+			fieldsFor(props.item).map(([label, value]) => /* @__PURE__ */ jsxs(Text, { children: [
 				label,
 				": ",
 				value
@@ -7183,109 +7397,996 @@ function PdfItemDetailScreen() {
 		]
 	});
 }
-//#endregion
-//#region src/tui/screens/editors/pdf/page-items.tsx
-const TEXT_PREVIEW_MAX_CHARS = 48;
-function truncate(text, maxChars) {
-	return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
-}
-function pathDimensions(item) {
-	let minX = Number.POSITIVE_INFINITY;
-	let minY = Number.POSITIVE_INFINITY;
-	let maxX = Number.NEGATIVE_INFINITY;
-	let maxY = Number.NEGATIVE_INFINITY;
-	const consider = (xPt, yPt) => {
-		minX = Math.min(minX, xPt);
-		minY = Math.min(minY, yPt);
-		maxX = Math.max(maxX, xPt);
-		maxY = Math.max(maxY, yPt);
-	};
-	for (const subpath of item.subpaths) {
-		consider(subpath.startXPt, subpath.startYPt);
-		for (const segment of subpath.segments) {
-			if (segment.kind === "cubic") {
-				consider(segment.c1xPt, segment.c1yPt);
-				consider(segment.c2xPt, segment.c2yPt);
-			}
-			consider(segment.xPt, segment.yPt);
+function buildFrameRows(frame, onFrameChange) {
+	return [
+		{
+			label: `X: ${formatPt(frame.xPt)}pt`,
+			currentValue: String(frame.xPt),
+			commit: (raw) => onFrameChange({
+				...frame,
+				xPt: parseNumberField(raw, frame.xPt)
+			})
+		},
+		{
+			label: `Y: ${formatPt(frame.yPt)}pt`,
+			currentValue: String(frame.yPt),
+			commit: (raw) => onFrameChange({
+				...frame,
+				yPt: parseNumberField(raw, frame.yPt)
+			})
+		},
+		{
+			label: `Width: ${formatPt(frame.widthPt)}pt`,
+			currentValue: String(frame.widthPt),
+			commit: (raw) => onFrameChange({
+				...frame,
+				widthPt: parseNumberField(raw, frame.widthPt)
+			})
+		},
+		{
+			label: `Height: ${formatPt(frame.heightPt)}pt`,
+			currentValue: String(frame.heightPt),
+			commit: (raw) => onFrameChange({
+				...frame,
+				heightPt: parseNumberField(raw, frame.heightPt)
+			})
 		}
-	}
-	if (minX > maxX) return "empty path";
-	return formatSize(maxX - minX, maxY - minY);
+	];
 }
-function previewFor(item) {
-	switch (item.kind) {
-		case "text": return truncate(item.text, TEXT_PREVIEW_MAX_CHARS);
-		case "link": return item.uri;
-		case "image":
-		case "rect":
-		case "ellipse": return formatSize(item.widthPt, item.heightPt);
-		case "line": return formatSize(Math.abs(item.x2Pt - item.x1Pt), Math.abs(item.y2Pt - item.y1Pt));
-		case "path": return pathDimensions(item);
-	}
+function buildFillStrokeRows(fill, stroke, onFillChange, onStrokeChange) {
+	return [{
+		label: `Fill: ${fill === void 0 ? "none" : formatColor(fill)}`,
+		currentValue: fill === void 0 ? "" : `${fill.r} ${fill.g} ${fill.b}`,
+		commit: (raw) => onFillChange(parseColorField(raw))
+	}, {
+		label: `Stroke: ${stroke === void 0 ? "none" : formatStroke(stroke)}`,
+		currentValue: stroke === void 0 ? "" : `${stroke.color.r} ${stroke.color.g} ${stroke.color.b} ${stroke.widthPt}`,
+		commit: (raw) => onStrokeChange(parseStrokeField(raw))
+	}];
 }
-function PdfPageItemsScreen() {
-	const state = useAppState();
-	const dispatch = useAppDispatch();
-	const doc = requirePdfDocument(state.openDocument);
-	const screen = currentScreen(state);
-	if (screen.kind !== "pdfPageItems") throw new Error(`PdfPageItemsScreen rendered while the current screen is "${screen.kind}", not "pdfPageItems".`);
-	const page = doc.layout.pages[screen.pageIndex];
-	if (page === void 0) throw new Error(`pdfPageItems was pushed for page ${screen.pageIndex}, but the open PDF has no page at that index.`);
-	const query = state.searchQuery.trim().toLowerCase();
-	const indexed = page.items.map((item, itemIndex) => ({
-		item,
-		itemIndex
-	}));
-	const items = query === "" ? indexed : indexed.filter((entry) => `${entry.item.kind} ${previewFor(entry.item)}`.toLowerCase().includes(query));
-	const { selectedIndex } = useNavigationInput({
-		itemCount: items.length,
-		onSelect: (index) => {
-			const entry = items[index];
-			if (entry === void 0) return;
-			dispatch({
-				type: "PUSH_SCREEN",
-				screen: {
-					kind: "pdfItemDetail",
-					pageIndex: screen.pageIndex,
-					itemIndex: entry.itemIndex
-				}
-			});
+function buildTextRows(item, pageIndex, itemIndex, dispatch) {
+	return [
+		{
+			label: `Text: ${item.text}`,
+			currentValue: item.text,
+			commit: (raw) => dispatch({
+				type: "SET_PDF_TEXT_TEXT",
+				pageIndex,
+				itemIndex,
+				text: raw
+			})
 		},
-		onBack: () => {
-			dispatch({ type: "POP_SCREEN" });
+		{
+			label: `X: ${formatPt(item.xPt)}pt`,
+			currentValue: String(item.xPt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_TEXT_POSITION",
+				pageIndex,
+				itemIndex,
+				xPt: parseNumberField(raw, item.xPt),
+				yPt: item.yPt
+			})
 		},
-		isActive: !anyOverlayOpen(state)
-	});
-	return /* @__PURE__ */ jsxs(Box, {
-		flexDirection: "column",
-		children: [/* @__PURE__ */ jsxs(Text, {
-			bold: true,
-			children: [
-				"Page ",
-				screen.pageIndex + 1,
-				" items (",
-				items.length,
-				" of ",
-				page.items.length,
-				")"
+		{
+			label: `Y: ${formatPt(item.yPt)}pt`,
+			currentValue: String(item.yPt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_TEXT_POSITION",
+				pageIndex,
+				itemIndex,
+				xPt: item.xPt,
+				yPt: parseNumberField(raw, item.yPt)
+			})
+		},
+		{
+			label: `Font family: ${item.font.family}`,
+			currentValue: item.font.family,
+			commit: (raw) => {
+				const family = raw.trim();
+				dispatch({
+					type: "SET_PDF_TEXT_FONT",
+					pageIndex,
+					itemIndex,
+					font: {
+						...item.font,
+						family: family.length === 0 ? item.font.family : family
+					}
+				});
+			}
+		},
+		{
+			label: `Font weight: ${item.font.weight} (Enter to toggle)`,
+			currentValue: "",
+			activate: () => dispatch({
+				type: "SET_PDF_TEXT_FONT",
+				pageIndex,
+				itemIndex,
+				font: {
+					...item.font,
+					weight: item.font.weight === "bold" ? "normal" : "bold"
+				}
+			})
+		},
+		{
+			label: `Font style: ${item.font.style} (Enter to toggle)`,
+			currentValue: "",
+			activate: () => dispatch({
+				type: "SET_PDF_TEXT_FONT",
+				pageIndex,
+				itemIndex,
+				font: {
+					...item.font,
+					style: item.font.style === "italic" ? "normal" : "italic"
+				}
+			})
+		},
+		{
+			label: `Size: ${item.sizePt}pt`,
+			currentValue: String(item.sizePt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_TEXT_SIZE",
+				pageIndex,
+				itemIndex,
+				sizePt: parseNumberField(raw, item.sizePt)
+			})
+		},
+		{
+			label: `Colour: ${formatColor(item.color)}`,
+			currentValue: `${item.color.r} ${item.color.g} ${item.color.b}`,
+			commit: (raw) => dispatch({
+				type: "SET_PDF_TEXT_COLOR",
+				pageIndex,
+				itemIndex,
+				color: parseRequiredColorField(raw, item.color)
+			})
+		},
+		{
+			label: `Width: ${item.widthPt === void 0 ? "unset" : `${item.widthPt}pt`}`,
+			currentValue: item.widthPt === void 0 ? "" : String(item.widthPt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_TEXT_WIDTH",
+				pageIndex,
+				itemIndex,
+				widthPt: parseOptionalNumberField(raw)
+			})
+		},
+		{
+			label: `Rotation: ${item.rotationDeg === void 0 ? "unset" : `${item.rotationDeg}°`}`,
+			currentValue: item.rotationDeg === void 0 ? "" : String(item.rotationDeg),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_TEXT_ROTATION",
+				pageIndex,
+				itemIndex,
+				rotationDeg: parseOptionalNumberField(raw)
+			})
+		},
+		{
+			label: `Underline: ${item.underline === true ? "yes" : "no"} (Enter to toggle)`,
+			currentValue: "",
+			activate: () => dispatch({
+				type: "TOGGLE_PDF_TEXT_UNDERLINE",
+				pageIndex,
+				itemIndex
+			})
+		}
+	];
+}
+function buildRectRows(item, pageIndex, itemIndex, dispatch) {
+	return [...buildFrameRows(item, (frame) => dispatch({
+		type: "SET_PDF_RECT_FRAME",
+		pageIndex,
+		itemIndex,
+		...frame
+	})), ...buildFillStrokeRows(item.fill, item.stroke, (fill) => dispatch({
+		type: "SET_PDF_RECT_FILL",
+		pageIndex,
+		itemIndex,
+		fill
+	}), (stroke) => dispatch({
+		type: "SET_PDF_RECT_STROKE",
+		pageIndex,
+		itemIndex,
+		stroke
+	}))];
+}
+function buildEllipseRows(item, pageIndex, itemIndex, dispatch) {
+	return [...buildFrameRows(item, (frame) => dispatch({
+		type: "SET_PDF_ELLIPSE_FRAME",
+		pageIndex,
+		itemIndex,
+		...frame
+	})), ...buildFillStrokeRows(item.fill, item.stroke, (fill) => dispatch({
+		type: "SET_PDF_ELLIPSE_FILL",
+		pageIndex,
+		itemIndex,
+		fill
+	}), (stroke) => dispatch({
+		type: "SET_PDF_ELLIPSE_STROKE",
+		pageIndex,
+		itemIndex,
+		stroke
+	}))];
+}
+function buildLineRows(item, pageIndex, itemIndex, dispatch) {
+	return [
+		{
+			label: `From X: ${formatPt(item.x1Pt)}pt`,
+			currentValue: String(item.x1Pt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_LINE_FROM",
+				pageIndex,
+				itemIndex,
+				x1Pt: parseNumberField(raw, item.x1Pt),
+				y1Pt: item.y1Pt
+			})
+		},
+		{
+			label: `From Y: ${formatPt(item.y1Pt)}pt`,
+			currentValue: String(item.y1Pt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_LINE_FROM",
+				pageIndex,
+				itemIndex,
+				x1Pt: item.x1Pt,
+				y1Pt: parseNumberField(raw, item.y1Pt)
+			})
+		},
+		{
+			label: `To X: ${formatPt(item.x2Pt)}pt`,
+			currentValue: String(item.x2Pt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_LINE_TO",
+				pageIndex,
+				itemIndex,
+				x2Pt: parseNumberField(raw, item.x2Pt),
+				y2Pt: item.y2Pt
+			})
+		},
+		{
+			label: `To Y: ${formatPt(item.y2Pt)}pt`,
+			currentValue: String(item.y2Pt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_LINE_TO",
+				pageIndex,
+				itemIndex,
+				x2Pt: item.x2Pt,
+				y2Pt: parseNumberField(raw, item.y2Pt)
+			})
+		},
+		{
+			label: `Colour: ${formatColor(item.color)}`,
+			currentValue: `${item.color.r} ${item.color.g} ${item.color.b}`,
+			commit: (raw) => dispatch({
+				type: "SET_PDF_LINE_COLOR",
+				pageIndex,
+				itemIndex,
+				color: parseRequiredColorField(raw, item.color)
+			})
+		},
+		{
+			label: `Width: ${item.widthPt}pt`,
+			currentValue: String(item.widthPt),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_LINE_WIDTH",
+				pageIndex,
+				itemIndex,
+				widthPt: Math.max(parseNumberField(raw, item.widthPt), Number.EPSILON)
+			})
+		}
+	];
+}
+function buildPathRows(item, pageIndex, itemIndex, dispatch) {
+	return [{
+		label: `Fill rule: ${item.fillRule ?? "nonzero (default)"} (Enter to cycle)`,
+		currentValue: "",
+		activate: () => dispatch({
+			type: "SET_PDF_PATH_FILL_RULE",
+			pageIndex,
+			itemIndex,
+			fillRule: item.fillRule === "evenodd" ? void 0 : item.fillRule === "nonzero" ? "evenodd" : "nonzero"
+		})
+	}, ...buildFillStrokeRows(item.fill, item.stroke, (fill) => dispatch({
+		type: "SET_PDF_PATH_FILL",
+		pageIndex,
+		itemIndex,
+		fill
+	}), (stroke) => dispatch({
+		type: "SET_PDF_PATH_STROKE",
+		pageIndex,
+		itemIndex,
+		stroke
+	}))];
+}
+function buildImageRows(item, pageIndex, itemIndex, dispatch, onReplaceImage) {
+	return [
+		...buildFrameRows(item, (frame) => dispatch({
+			type: "SET_PDF_IMAGE_FRAME",
+			pageIndex,
+			itemIndex,
+			...frame
+		})),
+		{
+			label: `Rotation: ${item.rotationDeg === void 0 ? "unset" : `${item.rotationDeg}°`}`,
+			currentValue: item.rotationDeg === void 0 ? "" : String(item.rotationDeg),
+			commit: (raw) => dispatch({
+				type: "SET_PDF_IMAGE_ROTATION",
+				pageIndex,
+				itemIndex,
+				rotationDeg: parseOptionalNumberField(raw)
+			})
+		},
+		{
+			label: "Replace image...",
+			currentValue: "",
+			activate: onReplaceImage
+		}
+	];
+}
+function buildLinkRows(item, pageIndex, itemIndex, dispatch) {
+	return [{
+		label: `URI: ${item.uri}`,
+		currentValue: item.uri,
+		commit: (raw) => dispatch({
+			type: "SET_PDF_LINK_URI",
+			pageIndex,
+			itemIndex,
+			uri: raw
+		})
+	}, ...buildFrameRows(item, (frame) => dispatch({
+		type: "SET_PDF_LINK_FRAME",
+		pageIndex,
+		itemIndex,
+		...frame
+	}))];
+}
+function buildRowsFor(item, pageIndex, itemIndex, dispatch, onReplaceImage) {
+	switch (item.kind) {
+		case "text": return buildTextRows(item, pageIndex, itemIndex, dispatch);
+		case "rect": return buildRectRows(item, pageIndex, itemIndex, dispatch);
+		case "ellipse": return buildEllipseRows(item, pageIndex, itemIndex, dispatch);
+		case "line": return buildLineRows(item, pageIndex, itemIndex, dispatch);
+		case "path": return buildPathRows(item, pageIndex, itemIndex, dispatch);
+		case "image": return buildImageRows(item, pageIndex, itemIndex, dispatch, onReplaceImage);
+		case "link": return buildLinkRows(item, pageIndex, itemIndex, dispatch);
+	}
+}
+function pathSummary(item) {
+	const segmentCount = item.subpaths.reduce((total, subpath) => total + subpath.segments.length, 0);
+	return `${item.subpaths.length} subpath${item.subpaths.length === 1 ? "" : "s"}, ${segmentCount} segment${segmentCount === 1 ? "" : "s"} (not editable here -- see documents.js's own PdfPathItem doc comment)`;
+}
+async function applyImageReplace(pageIndex, itemIndex, path, dispatch) {
+	const format = inferImageFormat(path);
+	if (format === void 0) {
+		dispatch({
+			type: "SET_STATUS",
+			severity: "warning",
+			text: `${path} is not a .png or .jpg/.jpeg file -- image not replaced`
+		});
+		return;
+	}
+	try {
+		dispatch({
+			type: "SET_PDF_IMAGE_SOURCE",
+			pageIndex,
+			itemIndex,
+			format,
+			bytes: new Uint8Array(await readInput(path))
+		});
+	} catch (error) {
+		dispatch({
+			type: "SET_STATUS",
+			severity: "error",
+			text: `Could not read ${path}: ${describeError(error)}`
+		});
+	}
+}
+function EditableItemDetail(props) {
+	const dispatch = useAppDispatch();
+	const { doc, pageIndex, itemIndex } = props;
+	const [editingField, setEditingField] = useState(void 0);
+	const [draft, setDraft] = useState("");
+	const [replacingImage, setReplacingImage] = useState(false);
+	const item = doc.editor.page(pageIndex)?.items()[itemIndex];
+	const rows = item === void 0 ? [] : buildRowsFor(item, pageIndex, itemIndex, dispatch, () => setReplacingImage(true));
+	const { selectedIndex } = useNavigationInput({
+		itemCount: rows.length,
+		isActive: props.isActive && editingField === void 0 && !replacingImage,
+		onBack: () => {
+			dispatch({ type: "POP_SCREEN" });
+		},
+		onSelect: (index) => {
+			const row = rows[index];
+			if (row === void 0) return;
+			if (row.activate !== void 0) {
+				row.activate();
+				return;
+			}
+			setDraft(row.currentValue);
+			setEditingField(index);
+		}
+	});
+	if (item === void 0) return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [/* @__PURE__ */ jsxs(Text, {
+			color: "yellow",
+			children: [
+				"There is no item ",
+				itemIndex + 1,
+				" on page ",
+				pageIndex + 1,
+				" any more."
 			]
+		}), /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "Esc to go back"
+		})]
+	});
+	if (replacingImage) return /* @__PURE__ */ jsx(FieldWizard, {
+		fields: [{
+			key: "path",
+			label: "Image file path (.png/.jpg/.jpeg)",
+			defaultValue: ""
+		}],
+		onCancel: () => {
+			setReplacingImage(false);
+		},
+		onComplete: (values) => {
+			applyImageReplace(pageIndex, itemIndex, requireFieldValue(values, "path"), dispatch).then(() => {
+				setReplacingImage(false);
+			});
+		}
+	});
+	if (editingField !== void 0) {
+		const row = rows[editingField];
+		if (row === void 0) throw new Error(`EditableItemDetail 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__ */ jsxs(Text, {
+				bold: true,
+				children: [
+					"Page ",
+					pageIndex + 1,
+					", item ",
+					itemIndex + 1,
+					" -- ",
+					item.kind
+				]
+			}),
+			item.kind === "path" && /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: pathSummary(item)
+			}),
+			item.kind === "image" && /* @__PURE__ */ jsxs(Text, {
+				dimColor: true,
+				children: ["Image ID: ", item.imageId]
+			}),
+			/* @__PURE__ */ jsx(ListView, {
+				items: rows,
+				selectedIndex,
+				reservedRows: 5,
+				renderItem: (row, isSelected) => /* @__PURE__ */ jsx(Text, {
+					color: isSelected ? "cyan" : void 0,
+					inverse: isSelected,
+					children: row.label
+				})
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "Enter to edit a field, Esc to go back"
+			})
+		]
+	});
+}
+function PdfItemDetailScreen() {
+	const state = useAppState();
+	const dispatch = useAppDispatch();
+	const doc = requirePdfDocument(state.openDocument);
+	const screen = currentScreen(state);
+	if (screen.kind !== "pdfItemDetail") throw new Error(`PdfItemDetailScreen rendered while the current screen is "${screen.kind}", not "pdfItemDetail".`);
+	const isActive = !anyOverlayOpen(state);
+	if (!isEditablePdfDocument(doc)) {
+		const page = doc.layout.pages[screen.pageIndex];
+		if (page === void 0) throw new Error(`pdfItemDetail was pushed for page ${screen.pageIndex}, but the open PDF has no page at that index.`);
+		const item = page.items[screen.itemIndex];
+		if (item === void 0) throw new Error(`pdfItemDetail was pushed for item ${screen.itemIndex} on page ${screen.pageIndex}, but that page has no item at that index.`);
+		return /* @__PURE__ */ jsx(ReadOnlyItemDetail, {
+			item,
+			pageIndex: screen.pageIndex,
+			itemIndex: screen.itemIndex,
+			isActive,
+			onBack: () => {
+				dispatch({ type: "POP_SCREEN" });
+			}
+		});
+	}
+	return /* @__PURE__ */ jsx(EditableItemDetail, {
+		doc,
+		pageIndex: screen.pageIndex,
+		itemIndex: screen.itemIndex,
+		isActive
+	});
+}
+//#endregion
+//#region src/tui/screens/editors/pdf/page-items.tsx
+const TEXT_PREVIEW_MAX_CHARS = 48;
+function truncate(text, maxChars) {
+	return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+}
+function pathDimensions(item) {
+	let minX = Number.POSITIVE_INFINITY;
+	let minY = Number.POSITIVE_INFINITY;
+	let maxX = Number.NEGATIVE_INFINITY;
+	let maxY = Number.NEGATIVE_INFINITY;
+	const consider = (xPt, yPt) => {
+		minX = Math.min(minX, xPt);
+		minY = Math.min(minY, yPt);
+		maxX = Math.max(maxX, xPt);
+		maxY = Math.max(maxY, yPt);
+	};
+	for (const subpath of item.subpaths) {
+		consider(subpath.startXPt, subpath.startYPt);
+		for (const segment of subpath.segments) {
+			if (segment.kind === "cubic") {
+				consider(segment.c1xPt, segment.c1yPt);
+				consider(segment.c2xPt, segment.c2yPt);
+			}
+			consider(segment.xPt, segment.yPt);
+		}
+	}
+	if (minX > maxX) return "empty path";
+	return formatSize(maxX - minX, maxY - minY);
+}
+function previewFor(item) {
+	switch (item.kind) {
+		case "text": return truncate(item.text, TEXT_PREVIEW_MAX_CHARS);
+		case "link": return item.uri;
+		case "image":
+		case "rect":
+		case "ellipse": return formatSize(item.widthPt, item.heightPt);
+		case "line": return formatSize(Math.abs(item.x2Pt - item.x1Pt), Math.abs(item.y2Pt - item.y1Pt));
+		case "path": return pathDimensions(item);
+	}
+}
+const ADD_KIND_OPTIONS = [
+	{
+		kind: "text",
+		label: "Text"
+	},
+	{
+		kind: "rect",
+		label: "Rectangle"
+	},
+	{
+		kind: "ellipse",
+		label: "Ellipse"
+	},
+	{
+		kind: "line",
+		label: "Line"
+	},
+	{
+		kind: "path",
+		label: "Path (fixed triangle shape)"
+	},
+	{
+		kind: "image",
+		label: "Image"
+	},
+	{
+		kind: "link",
+		label: "Link"
+	}
+];
+const GEOMETRY_FIELDS = [
+	{
+		key: "xPt",
+		label: "X (pt)",
+		defaultValue: "40"
+	},
+	{
+		key: "yPt",
+		label: "Y (pt)",
+		defaultValue: "40"
+	},
+	{
+		key: "widthPt",
+		label: "Width (pt)",
+		defaultValue: "160"
+	},
+	{
+		key: "heightPt",
+		label: "Height (pt)",
+		defaultValue: "100"
+	}
+];
+const FILL_FIELD = {
+	key: "fill",
+	label: "Fill \"r g b\" (0-1 each), blank for none",
+	defaultValue: "0.8 0.8 0.8"
+};
+const STROKE_FIELD = {
+	key: "stroke",
+	label: "Stroke \"r g b widthPt\" (0-1 colour, pt width), blank for none",
+	defaultValue: "0 0 0 1"
+};
+const REQUIRED_COLOR_FIELD = {
+	key: "color",
+	label: "Colour \"r g b\" (0-1 each)",
+	defaultValue: "0 0 0"
+};
+function fieldsForAddKind(kind) {
+	switch (kind) {
+		case "text": return [
+			{
+				key: "xPt",
+				label: "X (pt)",
+				defaultValue: "40"
+			},
+			{
+				key: "yPt",
+				label: "Y (pt)",
+				defaultValue: "40"
+			},
+			{
+				key: "text",
+				label: "Text",
+				defaultValue: "Text"
+			},
+			{
+				key: "fontFamily",
+				label: "Font family",
+				defaultValue: "Helvetica"
+			},
+			{
+				key: "fontWeight",
+				label: "Font weight (normal/bold)",
+				defaultValue: "normal"
+			},
+			{
+				key: "fontStyle",
+				label: "Font style (normal/italic)",
+				defaultValue: "normal"
+			},
+			{
+				key: "sizePt",
+				label: "Size (pt)",
+				defaultValue: "12"
+			},
+			REQUIRED_COLOR_FIELD
+		];
+		case "rect":
+		case "ellipse":
+		case "path": return [
+			...GEOMETRY_FIELDS,
+			FILL_FIELD,
+			STROKE_FIELD
+		];
+		case "line": return [
+			{
+				key: "fromXPt",
+				label: "From X (pt)",
+				defaultValue: "40"
+			},
+			{
+				key: "fromYPt",
+				label: "From Y (pt)",
+				defaultValue: "40"
+			},
+			{
+				key: "toXPt",
+				label: "To X (pt)",
+				defaultValue: "200"
+			},
+			{
+				key: "toYPt",
+				label: "To Y (pt)",
+				defaultValue: "40"
+			},
+			REQUIRED_COLOR_FIELD,
+			{
+				key: "widthPt",
+				label: "Width (pt)",
+				defaultValue: "1"
+			}
+		];
+		case "image": return [...GEOMETRY_FIELDS, {
+			key: "path",
+			label: "Image file path (.png/.jpg/.jpeg)",
+			defaultValue: ""
+		}];
+		case "link": return [{
+			key: "uri",
+			label: "URI",
+			defaultValue: "https://example.com"
+		}, ...GEOMETRY_FIELDS];
+	}
+}
+function readFrame(values) {
+	return {
+		xPt: parseNumberField(requireFieldValue(values, "xPt"), 0),
+		yPt: parseNumberField(requireFieldValue(values, "yPt"), 0),
+		widthPt: parseNumberField(requireFieldValue(values, "widthPt"), 100),
+		heightPt: parseNumberField(requireFieldValue(values, "heightPt"), 60)
+	};
+}
+async function applyAddKind(kind, pageIndex, values, dispatch) {
+	switch (kind) {
+		case "text":
+			dispatch({
+				type: "ADD_PDF_TEXT",
+				pageIndex,
+				init: {
+					xPt: parseNumberField(requireFieldValue(values, "xPt"), 0),
+					yPt: parseNumberField(requireFieldValue(values, "yPt"), 0),
+					text: requireFieldValue(values, "text"),
+					font: {
+						family: requireFieldValue(values, "fontFamily").trim() || "Helvetica",
+						weight: parseFontWeight(requireFieldValue(values, "fontWeight")),
+						style: parseFontStyle(requireFieldValue(values, "fontStyle"))
+					},
+					sizePt: Math.max(parseNumberField(requireFieldValue(values, "sizePt"), 12), Number.EPSILON),
+					color: parseColorField(requireFieldValue(values, "color")) ?? {
+						r: 0,
+						g: 0,
+						b: 0
+					}
+				}
+			});
+			return;
+		case "rect":
+			dispatch({
+				type: "ADD_PDF_RECT",
+				pageIndex,
+				init: {
+					...readFrame(values),
+					fill: parseColorField(requireFieldValue(values, "fill")),
+					stroke: parseStrokeField(requireFieldValue(values, "stroke"))
+				}
+			});
+			return;
+		case "ellipse":
+			dispatch({
+				type: "ADD_PDF_ELLIPSE",
+				pageIndex,
+				init: {
+					...readFrame(values),
+					fill: parseColorField(requireFieldValue(values, "fill")),
+					stroke: parseStrokeField(requireFieldValue(values, "stroke"))
+				}
+			});
+			return;
+		case "line":
+			dispatch({
+				type: "ADD_PDF_LINE",
+				pageIndex,
+				init: {
+					x1Pt: parseNumberField(requireFieldValue(values, "fromXPt"), 0),
+					y1Pt: parseNumberField(requireFieldValue(values, "fromYPt"), 0),
+					x2Pt: parseNumberField(requireFieldValue(values, "toXPt"), 100),
+					y2Pt: parseNumberField(requireFieldValue(values, "toYPt"), 0),
+					color: parseColorField(requireFieldValue(values, "color")) ?? {
+						r: 0,
+						g: 0,
+						b: 0
+					},
+					widthPt: Math.max(parseNumberField(requireFieldValue(values, "widthPt"), 1), Number.EPSILON)
+				}
+			});
+			return;
+		case "path": {
+			const frame = readFrame(values);
+			dispatch({
+				type: "ADD_PDF_PATH",
+				pageIndex,
+				init: {
+					subpaths: defaultTriangleLayoutSubpaths(frame.widthPt, frame.heightPt),
+					fill: parseColorField(requireFieldValue(values, "fill")),
+					stroke: parseStrokeField(requireFieldValue(values, "stroke"))
+				}
+			});
+			return;
+		}
+		case "image": {
+			const frame = readFrame(values);
+			const path = requireFieldValue(values, "path");
+			const format = inferImageFormat(path);
+			if (format === void 0) {
+				dispatch({
+					type: "SET_STATUS",
+					severity: "warning",
+					text: `${path} is not a .png or .jpg/.jpeg file -- image not added`
+				});
+				return;
+			}
+			try {
+				const bytes = new Uint8Array(await readInput(path));
+				dispatch({
+					type: "ADD_PDF_IMAGE",
+					pageIndex,
+					init: {
+						...frame,
+						format,
+						bytes
+					}
+				});
+			} catch (error) {
+				dispatch({
+					type: "SET_STATUS",
+					severity: "error",
+					text: `Could not read ${path}: ${describeError(error)}`
+				});
+			}
+			return;
+		}
+		case "link": {
+			const frame = readFrame(values);
+			dispatch({
+				type: "ADD_PDF_LINK",
+				pageIndex,
+				init: {
+					uri: requireFieldValue(values, "uri"),
+					...frame
+				}
+			});
+			return;
+		}
+	}
+}
+function AddItemFlow(props) {
+	const dispatch = useAppDispatch();
+	const [kind, setKind] = useState(void 0);
+	const { selectedIndex } = useNavigationInput({
+		itemCount: ADD_KIND_OPTIONS.length,
+		isActive: props.isActive && kind === void 0,
+		onBack: props.onCancel,
+		onSelect: (index) => {
+			const option = ADD_KIND_OPTIONS[index];
+			if (option === void 0) return;
+			setKind(option.kind);
+		}
+	});
+	if (kind === void 0) return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		borderStyle: "round",
+		paddingX: 1,
+		children: [/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			children: "Add item -- choose a kind"
 		}), /* @__PURE__ */ jsx(ListView, {
-			items,
+			items: ADD_KIND_OPTIONS,
 			selectedIndex,
-			emptyMessage: query === "" ? "This page has no items." : `No items match "${state.searchQuery}".`,
-			renderItem: ({ item, itemIndex }, isSelected) => /* @__PURE__ */ jsxs(Text, {
+			reservedRows: 6,
+			renderItem: (option, isSelected) => /* @__PURE__ */ jsxs(Text, {
 				color: isSelected ? "cyan" : void 0,
-				inverse: isSelected,
+				children: [isSelected ? "> " : "  ", option.label]
+			})
+		})]
+	});
+	return /* @__PURE__ */ jsx(FieldWizard, {
+		fields: fieldsForAddKind(kind),
+		onCancel: props.onCancel,
+		onComplete: (values) => {
+			applyAddKind(kind, props.pageIndex, values, dispatch).then(props.onCreated);
+		}
+	});
+}
+function PdfPageItemsScreen() {
+	const state = useAppState();
+	const dispatch = useAppDispatch();
+	const doc = requirePdfDocument(state.openDocument);
+	const editable = isEditablePdfDocument(doc);
+	const screen = currentScreen(state);
+	if (screen.kind !== "pdfPageItems") throw new Error(`PdfPageItemsScreen rendered while the current screen is "${screen.kind}", not "pdfPageItems".`);
+	const page = doc.layout.pages[screen.pageIndex];
+	if (page === void 0) throw new Error(`pdfPageItems was pushed for page ${screen.pageIndex}, but the open PDF has no page at that index.`);
+	const [isAdding, setIsAdding] = useState(false);
+	const overlayOpen = anyOverlayOpen(state);
+	const query = state.searchQuery.trim().toLowerCase();
+	const indexed = page.items.map((item, itemIndex) => ({
+		item,
+		itemIndex
+	}));
+	const items = query === "" ? indexed : indexed.filter((entry) => `${entry.item.kind} ${previewFor(entry.item)}`.toLowerCase().includes(query));
+	const { selectedIndex } = useNavigationInput({
+		itemCount: items.length,
+		isActive: !overlayOpen && !isAdding,
+		onSelect: (index) => {
+			const entry = items[index];
+			if (entry === void 0) return;
+			dispatch({
+				type: "PUSH_SCREEN",
+				screen: {
+					kind: "pdfItemDetail",
+					pageIndex: screen.pageIndex,
+					itemIndex: entry.itemIndex
+				}
+			});
+		},
+		onBack: () => {
+			dispatch({ type: "POP_SCREEN" });
+		},
+		onAppend: editable ? () => {
+			setIsAdding(true);
+		} : void 0
+	});
+	useInput((input) => {
+		if (input !== "d") return;
+		const entry = items[selectedIndex];
+		if (entry === void 0) return;
+		dispatch({
+			type: "REMOVE_PDF_ITEM",
+			pageIndex: screen.pageIndex,
+			itemIndex: entry.itemIndex
+		});
+	}, { isActive: editable && !overlayOpen && !isAdding && items.length > 0 });
+	if (isAdding) return /* @__PURE__ */ jsx(AddItemFlow, {
+		pageIndex: screen.pageIndex,
+		isActive: !overlayOpen,
+		onCancel: () => {
+			setIsAdding(false);
+		},
+		onCreated: () => {
+			setIsAdding(false);
+		}
+	});
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Text, {
+				bold: true,
 				children: [
-					itemIndex + 1,
-					". ",
-					item.kind,
-					" -- ",
-					previewFor(item)
+					"Page ",
+					screen.pageIndex + 1,
+					" items (",
+					items.length,
+					" of ",
+					page.items.length,
+					")"
 				]
+			}),
+			/* @__PURE__ */ jsx(ListView, {
+				items,
+				selectedIndex,
+				emptyMessage: query === "" ? editable ? "This page has no items -- press 'a' to add one" : "This page has no items." : `No items match "${state.searchQuery}".`,
+				renderItem: ({ item, itemIndex }, isSelected) => /* @__PURE__ */ jsxs(Text, {
+					color: isSelected ? "cyan" : void 0,
+					inverse: isSelected,
+					children: [
+						itemIndex + 1,
+						". ",
+						item.kind,
+						" -- ",
+						previewFor(item)
+					]
+				})
+			}),
+			editable && /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "a to add an item, d to delete the selected item"
 			})
-		})]
+		]
 	});
 }
 //#endregion