document-cli 5.4.25 → 5.5.1

package/README.md

@@ -227,7 +227,7 @@ Diagnostics and the summary line always go to stderr; stdout is reserved for the
 
 Launch it either bare (`document-cli`, with no arguments) or explicitly with `document-cli tui [file]` — both open the same app; the explicit form additionally opens `file` immediately, skipping the launcher screen. The TUI needs an interactive terminal: a bare invocation with redirected stdout prints help text instead, and an explicit `tui` invocation with redirected stdout fails outright, since there's no terminal for Ink to draw into.
 
-It supports the same seven formats documents.js's live-view editors cover — docx, pptx, odt, odp, ods, odg, markdown — each with a full navigate/edit/save experience built on that format's editor (paragraphs and runs for docx/odt/markdown, slides and shapes for pptx/odp, sheets and cells for ods, pages and vectors/shapes for odg), plus undo (whole-document snapshots taken before each committed mutation), search, a command palette, and PDF export straight from the open document. On a pptx or odp slide, `a` from the shape list also adds a real table (rows then columns, a two-step prompt) alongside the existing textbox/image choices, and `n` opens the slide's own speaker notes for either format — `PptxSlide` and `OdpSlide` both carry a real `.notes` getter/setter, so notes editing was never odp-specific, only gated that way until this phase removed the gate. On a docx document, `x` from the paragraph/table list opens a read-only view of the document's own comments, footnotes, headers/footers, and numbering definitions — a docx-only concept with no odt equivalent, and the TUI counterpart to the `docx-extras` command, rendered through the identical `src/docx-extras-format.ts` line formatter so the two can't drift apart. `m`, global to every screen with a document open, shows that document's own title/author/subject/keywords/etc metadata read-only — every format the `metadata` command covers, including `.odb`/`.pdf`/`.xlsx`. documents.js's own DocxEditor/OdtEditor/PptxEditor/OdpEditor/OdsEditor/OdgEditor now each carry a real `.metadata` getter/setter (ExaDev/documents.js#933), but this TUI has not yet wired an edit flow through it, so `m` still has no matching write screen here (use the `set-metadata` command for that).
+It supports the same seven formats documents.js's live-view editors cover — docx, pptx, odt, odp, ods, odg, markdown — each with a full navigate/edit/save experience built on that format's editor (paragraphs and runs for docx/odt/markdown, slides and shapes for pptx/odp, sheets and cells for ods, pages and vectors/shapes for odg), plus undo (whole-document snapshots taken before each committed mutation), search, a command palette, and PDF export straight from the open document. On a pptx or odp slide, `a` from the shape list also adds a real table (rows then columns, a two-step prompt) alongside the existing textbox/image choices, and `n` opens the slide's own speaker notes for either format — `PptxSlide` and `OdpSlide` both carry a real `.notes` getter/setter, so notes editing was never odp-specific, only gated that way until this phase removed the gate. On a docx document, `x` from the paragraph/table list opens a read-only view of the document's own comments, footnotes, headers/footers, and numbering definitions — a docx-only concept with no odt equivalent, and the TUI counterpart to the `docx-extras` command, rendered through the identical `src/docx-extras-format.ts` line formatter so the two can't drift apart. `m`, global to every screen with a document open, shows that document's own title/author/subject/keywords/etc metadata — every format the `metadata` command covers, including `.odb`/`.pdf`/`.xlsx`. For the seven live-view-editor formats, title/author/subject/keywords are editable in place through documents.js's own `editor.metadata` setter (ExaDev/documents.js#933): select a field and Enter opens it for editing, committing a partial merge that leaves every other field untouched. Every other format (and creator/producer/created/modified on the editable formats too, since those are derived/producer-stamped rather than user-authored) stays read-only here — use the `set-metadata` command for a format with no live-view editor.
 
 Markdown (`.md`/`.markdown`) shares the same paragraph/run/table body-list screens docx and odt already use, through documents.js's own `MarkdownEditor` (`openMarkdown`/`createMarkdownEditor`) — a genuine live view over a mutable `ContentDocument`, the same live-view contract every other editor here follows, even though there is no `XmlElement` tree underneath it the way there is for docx/odt (`MarkdownEditor.toMarkdownText()` re-serialises the whole document fresh on every call, rather than exposing a `toBytes()`). Appending a paragraph, appending a run, and toggling bold/italic all go through the identical reducer actions docx/odt use; a markdown run has no underline, colour, font family, or font size at all (CommonMark/GFM has no construct for any of the four), so those keys — along with image insertion, which `MarkdownParagraph` has no counterpart for — are simply absent from a markdown paragraph's own key hints rather than opening a prompt that could only end in a warning. A markdown table can be created and its cells edited through the same 'T' wizard and table-view screens docx/odt use, but GFM tables have no cell-merge concept, so a merge requested alongside table creation still creates the table (unmerged) and reports why the merge itself didn't happen. `:view-source` (markdown documents only) shows the literal text the document was opened with side by side with what a save would write right now — these can genuinely differ even with no edits made this session, from a heading-style, bullet-marker, or line-ending choice the writer normalises. Every save re-serialises the whole document fresh through `buildMarkdownText`, a deliberate, permanent consequence of structured editing rather than something to work around. Diagnostics from the read side (a clamped heading level, a dropped front-matter key, a fenced code block's own info string with nowhere to go, …) now surface into the same diagnostics panel a PDF export's own substitutions already populate, the moment a `.md` file is opened, not only on export. documents.js's own `createMarkdownEditor()` exists now, but this TUI does not yet wire a "new markdown document" flow into `:new`/the new-document picker, so a markdown document can still only be opened from an existing file.
 
@@ -239,24 +239,24 @@ The export-to-PDF screen (`e` from any editor screen) is a two-field form: a des
 
 The global bindings below apply everywhere; individual screens (a docx run's own bold/italic toggles, an ods cell's own value-kind picker) add their own on top:
 
-| Keys                  | Action                                        |
-| --------------------- | --------------------------------------------- |
-| `↑` / `k`             | Move the selection up                         |
-| `↓` / `j`             | Move the selection down                       |
-| `Enter` / `→` / `l`   | Open or edit the selected item                |
-| `Esc` / `←` / `h`     | Go back to the previous screen                |
-| `PageUp` / `PageDown` | Scroll a page at a time                       |
-| `Home` / `End`        | Jump to the first or last item                |
-| `a`                   | Append a new item to the current list         |
-| `m`                   | Show the open document's metadata (read-only) |
-| `Ctrl+S`              | Save the open document                        |
-| `Ctrl+W`              | Close the open document                       |
-| `Ctrl+Z`              | Undo the last change                          |
-| `q` / `Ctrl+C`        | Quit                                          |
-| `:`                   | Open the command palette                      |
-| `/`                   | Search within the current screen              |
-| `?`                   | Show this help                                |
-| `Ctrl+D`              | Show the diagnostics panel                    |
+| Keys                  | Action                                                                         |
+| --------------------- | ------------------------------------------------------------------------------ |
+| `↑` / `k`             | Move the selection up                                                          |
+| `↓` / `j`             | Move the selection down                                                        |
+| `Enter` / `→` / `l`   | Open or edit the selected item                                                 |
+| `Esc` / `←` / `h`     | Go back to the previous screen                                                 |
+| `PageUp` / `PageDown` | Scroll a page at a time                                                        |
+| `Home` / `End`        | Jump to the first or last item                                                 |
+| `a`                   | Append a new item to the current list                                          |
+| `m`                   | Show the open document's metadata (editable for docx/pptx/odt/odp/ods/odg/pdf) |
+| `Ctrl+S`              | Save the open document                                                         |
+| `Ctrl+W`              | Close the open document                                                        |
+| `Ctrl+Z`              | Undo the last change                                                           |
+| `q` / `Ctrl+C`        | Quit                                                                           |
+| `:`                   | Open the command palette                                                       |
+| `/`                   | Search within the current screen                                               |
+| `?`                   | Show this help                                                                 |
+| `Ctrl+D`              | Show the diagnostics panel                                                     |
 
 ## Architecture
 

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as odbFormSummary, c as formatDocxExtrasLines, d as writeOutput, f as loadProvidedFonts, h as isDocumentFormat, i as formatOdbReportLines, l as readInput, m as inferFormatFromExtension, n as describeOdbReport, o as formatMetadataLines, r as formatOdbFormLines, s as presentMetadataEntries, t as describeOdbForm, u as resolveDefaultOutputPath } from "./odb-structure-DsWeqhGj.js";
+import { a as odbFormSummary, c as presentMetadataEntries, d as resolveDefaultOutputPath, f as writeOutput, g as isDocumentFormat, h as inferFormatFromExtension, i as formatOdbReportLines, l as formatDocxExtrasLines, n as describeOdbReport, o as formatMetadataLines, p as loadProvidedFonts, r as formatOdbFormLines, t as describeOdbForm, u as readInput } from "./odb-structure-DKJ3vi6l.js";
 import { Command, CommanderError, InvalidArgumentError } from "commander";
 import { writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, resolve } from "node:path";
@@ -1199,7 +1199,7 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "5.4.25";
+var version = "5.5.1";
 //#endregion
 //#region src/program.ts
 function createProgram() {
@@ -1227,7 +1227,7 @@ function createProgram() {
 //#region src/cli.ts
 async function launchTui(startPath, signal) {
 	try {
-		const { runTui } = await import("./tui-BYCDgi8p.js");
+		const { runTui } = await import("./tui-C_It5tfz.js");
 		await runTui({
 			startPath,
 			signal

package/dist/index.cjs

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

package/dist/index.js

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

package/dist/{odb-structure-DsWeqhGj.js → odb-structure-DKJ3vi6l.js}

@@ -342,4 +342,4 @@ function formatOdbReportLines(report) {
 	return lines;
 }
 //#endregion
-export { odbFormSummary as a, formatDocxExtrasLines as c, writeOutput as d, loadProvidedFonts as f, isDocumentFormat as h, formatOdbReportLines as i, readInput as l, inferFormatFromExtension as m, describeOdbReport as n, formatMetadataLines as o, formatToExtension as p, formatOdbFormLines as r, presentMetadataEntries as s, describeOdbForm as t, resolveDefaultOutputPath as u };
+export { odbFormSummary as a, presentMetadataEntries as c, resolveDefaultOutputPath as d, writeOutput as f, isDocumentFormat as g, inferFormatFromExtension as h, formatOdbReportLines as i, formatDocxExtrasLines as l, formatToExtension as m, describeOdbReport as n, formatMetadataLines as o, loadProvidedFonts as p, formatOdbFormLines as r, formatMetadataValue as s, describeOdbForm as t, readInput as u };

package/dist/{tui-BYCDgi8p.js → tui-C_It5tfz.js}

@@ -1,11 +1,11 @@
-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-DsWeqhGj.js";
+import { h as inferFormatFromExtension, i as formatOdbReportLines, l as formatDocxExtrasLines, m as formatToExtension, n as describeOdbReport, o as formatMetadataLines, p as loadProvidedFonts, r as formatOdbFormLines, s as formatMetadataValue, t as describeOdbForm, u as readInput } from "./odb-structure-DKJ3vi6l.js";
 import { readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join } from "node:path";
-import { bytesToBase64, cellReference, columnIndexToLetters, convertDocument, createDocx, createOdg, createOdp, createOds, createOdt, createPdf, createPptx, csvToPdf, decodeMarkdownText, decodeOdbPackage, docToPdf, docxToPdf, encodeMarkdownText, hsqldbCellDisplayText, markdownToPdf, odbReportToDocx, odbReportToOdt, odbReportToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openMarkdown, openOdg, openOdp, openOds, openOdt, openPdf, openPptx, parseXml, pptToPdf, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, rtfToPdf, svgToPdf, xlsToPdf, xlsxToPdf } from "documents.js";
+import { bytesToBase64, cellReference, columnIndexToLetters, convertDocument, createDocx, createMarkdownEditor, createOdg, createOdp, createOds, createOdt, createPdf, createPptx, csvToPdf, decodeMarkdownText, decodeOdbPackage, docToPdf, docxToPdf, encodeMarkdownText, hsqldbCellDisplayText, markdownToPdf, odbReportToDocx, odbReportToOdt, odbReportToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openMarkdown, openOdg, openOdp, openOds, openOdt, openPdf, openPptx, parseXml, pptToPdf, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, rtfToPdf, svgToPdf, xlsToPdf, xlsxToPdf } from "documents.js";
 import { readdirSync } from "node:fs";
 import { Box, Text, render, useApp, useInput, useWindowSize } from "ink";
 import { createContext, useContext, useEffect, useReducer, useState } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import TextInput from "ink-text-input";
 //#region src/tui/errors.ts
 function describeError(error) {
@@ -235,6 +235,12 @@ function createNewDocument(format) {
 			editor: createDocx(),
 			path: void 0
 		};
+		case "markdown": return {
+			format,
+			editor: createMarkdownEditor(),
+			originalText: void 0,
+			path: void 0
+		};
 		case "pptx": return {
 			format,
 			editor: createPptx(),
@@ -297,6 +303,9 @@ const WRITABLE_FORMATS = {
 function isEditableFormat(value) {
 	return value in EDITABLE_FORMATS;
 }
+function isEditableDocument(document) {
+	return isEditableFormat(document.format);
+}
 function isWritableFormat(value) {
 	return value in WRITABLE_FORMATS;
 }
@@ -1026,6 +1035,16 @@ function appReducer(state, action) {
 				setTextContainerText(item, action.text);
 			});
 		}
+		case "INDENT_LIST_ITEM": {
+			const doc = wordprocessingDocument(state);
+			if (doc === void 0) return wrongDocument(state, "a docx, odt or markdown 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}`);
+			return mutateGuarded(state, doc, () => {
+				list.indentItem(action.itemIndex);
+			});
+		}
 		case "ADD_LIST": {
 			const doc = wordprocessingDocument(state);
 			if (doc === void 0) return wrongDocument(state, "a docx, odt or markdown document");
@@ -1425,6 +1444,13 @@ function appReducer(state, action) {
 			item.widthPt = action.widthPt;
 			item.heightPt = action.heightPt;
 		});
+		case "SET_METADATA": {
+			const doc = state.openDocument;
+			if (doc === void 0 || !isEditableDocument(doc)) return wrongDocument(state, "an editable document");
+			return mutate(state, doc, () => {
+				doc.editor.metadata = action.overrides;
+			});
+		}
 		case "APPEND_DIAGNOSTIC": return {
 			...state,
 			diagnostics: [...state.diagnostics, action.diagnostic]
@@ -7135,7 +7161,8 @@ function ListEditorScreen() {
 	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 blockIndex = screen.kind === "listEditor" ? screen.blockIndex : void 0;
+	const list = blockIndex !== void 0 && doc?.format === "odt" ? doc.editor.lists()[blockIndex] : void 0;
 	const items = list === void 0 ? [] : list.items();
 	const rows = items.map((item, index) => ({
 		item,
@@ -7157,10 +7184,17 @@ function ListEditorScreen() {
 		}
 	});
 	useInput((input, key) => {
-		if (key.tab || input === ">" || input === "<") dispatch({
+		if (key.tab || input === ">") {
+			if (blockIndex === void 0) return;
+			dispatch({
+				type: "INDENT_LIST_ITEM",
+				blockIndex,
+				itemIndex: selectedIndex
+			});
+		} else if (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"
+			text: "Outdenting isn't reachable from this screen yet -- it only browses top-level lists, with no route into an item's own nested list"
 		});
 	}, { isActive: isNavigationActive });
 	if (screen.kind !== "listEditor") return /* @__PURE__ */ jsx(Text, {
@@ -7265,7 +7299,7 @@ function ListEditorScreen() {
 				}
 			})] }) : /* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: "Enter to edit an item, a to add, Esc back"
+				children: "Enter to edit an item, a to add, Tab/> to indent, Esc back"
 			})
 		]
 	});
@@ -9009,6 +9043,10 @@ const CREATABLE_FORMATS = [
 	{
 		format: "odg",
 		description: "Vector drawing (OpenDocument)"
+	},
+	{
+		format: "markdown",
+		description: "Markdown document"
 	}
 ];
 const EXTENSION_COLUMN_WIDTH = 8;
@@ -9139,13 +9177,58 @@ function metadataFor(doc) {
 }
 //#endregion
 //#region src/tui/screens/shared/metadata.tsx
+const EDITABLE_FIELDS = [
+	{
+		key: "title",
+		label: "title"
+	},
+	{
+		key: "author",
+		label: "author"
+	},
+	{
+		key: "subject",
+		label: "subject"
+	},
+	{
+		key: "keywords",
+		label: "keywords"
+	}
+];
+function parseKeywords(text) {
+	return text.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+function overridesFor(field, text) {
+	switch (field) {
+		case "title": return { title: text };
+		case "author": return { author: text };
+		case "subject": return { subject: text };
+		case "keywords": return { keywords: parseKeywords(text) };
+	}
+}
 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) });
+	const editable = doc !== void 0 && isEditableDocument(doc);
+	const [editingField, setEditingField] = useState(void 0);
+	const [draft, setDraft] = useState("");
+	const isNavigationActive = doc !== void 0 && !anyOverlayOpen(state) && editingField === void 0;
+	const { selectedIndex } = useNavigationInput({
+		itemCount: editable ? EDITABLE_FIELDS.length : 0,
+		isActive: isNavigationActive,
+		onBack: () => {
+			dispatch({ type: "POP_SCREEN" });
+		},
+		onSelect: (index) => {
+			if (doc === void 0 || !editable) return;
+			const field = EDITABLE_FIELDS[index];
+			if (field === void 0) return;
+			const currentValue = metadataFor(doc)[field.key];
+			setDraft(currentValue === void 0 ? "" : formatMetadataValue(currentValue));
+			setEditingField(field.key);
+		}
+	});
 	if (doc === void 0) return /* @__PURE__ */ jsx(Text, {
 		color: "red",
 		children: "MetadataScreen requires an open document."
@@ -9157,6 +9240,37 @@ function MetadataScreen() {
 	} catch (error) {
 		errorMessage = error instanceof Error ? error.message : String(error);
 	}
+	if (editingField !== void 0) {
+		const field = EDITABLE_FIELDS.find((f) => f.key === editingField);
+		return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			children: [
+				/* @__PURE__ */ jsxs(Text, {
+					bold: true,
+					children: ["Editing ", field?.label ?? editingField]
+				}),
+				editingField === "keywords" ? /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: "Comma-separated"
+				}) : void 0,
+				/* @__PURE__ */ jsx(TextField, {
+					value: draft,
+					isFocused: true,
+					onChange: setDraft,
+					onSubmit: (text) => {
+						dispatch({
+							type: "SET_METADATA",
+							overrides: overridesFor(editingField, text)
+						});
+						setEditingField(void 0);
+					},
+					onCancel: () => {
+						setEditingField(void 0);
+					}
+				})
+			]
+		});
+	}
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [
@@ -9175,9 +9289,27 @@ function MetadataScreen() {
 				dimColor: true,
 				children: "This document carries no metadata."
 			}),
-			/* @__PURE__ */ jsx(Text, {
+			editable ? /* @__PURE__ */ jsxs(Fragment, { children: [
+				/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					children: "Edit a field"
+				}),
+				/* @__PURE__ */ jsx(ListView, {
+					items: EDITABLE_FIELDS,
+					selectedIndex,
+					renderItem: (field, isSelected) => /* @__PURE__ */ jsx(Text, {
+						color: isSelected ? "cyan" : void 0,
+						inverse: isSelected,
+						children: field.label
+					})
+				}),
+				/* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: "Enter to edit, Esc / ← / h to go back"
+				})
+			] }) : /* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: "Esc / ← / h to go back"
+				children: "This document's metadata is read-only. Esc / ← / h to go back"
 			})
 		]
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-cli",
-  "version": "5.4.25",
+  "version": "5.5.1",
   "description": "CLI and interactive Ink TUI for documents.js: every docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown/rtf conversion, bridge, and editor as a scriptable command or a terminal app.",
   "type": "module",
   "repository": {
@@ -92,9 +92,9 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "commander": "^15.0.0",
-    "document-outline.js": "^3.5.4",
-    "document-schema.js": "^7.0.0",
-    "documents.js": "^7.5.0",
+    "document-outline.js": "^3.5.5",
+    "document-schema.js": "^7.1.0",
+    "documents.js": "^7.6.1",
     "ink": "^7.1.1",
     "ink-text-input": "^6.0.0",
     "react": "^19.2.8"
@@ -111,7 +111,7 @@
     "eslint": "^10.8.0",
     "husky": "^9.1.7",
     "ink-testing-library": "^4.0.0",
-    "odf.js": "^7.4.0",
+    "odf.js": "^7.4.1",
     "publint": "^0.3.22",
     "semantic-release": "^25.0.8",
     "tsdown": "^0.22.14",