document-cli 5.1.7 → 5.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/documents.js/tree/main/packages/document-cli) [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/document-cli) [![npm version](https://img.shields.io/npm/v/document-cli)](https://www.npmjs.com/package/document-cli) [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/documents.js/ci.yml?branch=main)](https://github.com/ExaDev/documents.js/actions)
 
-> A command-line interface and an interactive terminal (Ink) app for [`documents.js`](https://github.com/ExaDev/documents.js): every docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and editor documents.js exposes, plus the outline projection [`document-outline.js`](../document-outline.js/README.md) builds over any readable document, wired up as a scriptable subcommand or a full-screen terminal editor. Installs as either `document-cli` or `doculi`.
+> A command-line interface and an interactive terminal (Ink) app for [`documents.js`](https://github.com/ExaDev/documents.js): every docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown/rtf conversion, bridge, and editor documents.js exposes, plus the outline projection [`document-outline.js`](../document-outline.js/README.md) builds over any readable document, wired up as a scriptable subcommand or a full-screen terminal editor. Installs as either `document-cli` or `doculi`.
 
 `document-cli` adds no conversion or editing logic of its own — it is a dispatch layer over `documents.js`'s existing conversion functions, `DocumentConverter` port, live-view editors, and `.odb`/PDF readers. What it adds is two ways to drive them without writing TypeScript: a scriptable, Unix-shaped CLI (stdin/stdout, exit codes, `--json` diagnostics) for pipelines, and a full-screen Ink terminal app for browsing and editing a document interactively.
 
@@ -143,7 +143,7 @@ document-cli pdf-inspect report.pdf
 document-cli pdf-inspect report.pdf --json
 ```
 
-**`fonts <input>`** — lists every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length) — the same embedded faces every `<format>-to-pdf` conversion already extracts and renders through automatically (see [Real fonts](#real-fonts) below); this command just reports what's there without converting anything. Rejects a format with no source-embedded-font concept at all (xlsx, csv, svg, pdf, markdown, odf), naming it:
+**`fonts <input>`** — lists every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length) — the same embedded faces every `<format>-to-pdf` conversion already extracts and renders through automatically (see [Real fonts](#real-fonts) below); this command just reports what's there without converting anything. Rejects a format with no source-embedded-font concept at all (xlsx, csv, svg, pdf, markdown, odf, rtf), naming it:
 
 ```sh
 document-cli fonts report.docx
@@ -155,7 +155,7 @@ document-cli fonts report.docx
 document-cli docx-extras report.docx
 ```
 
-**`metadata <input>`** — prints a document's own title/author/subject/keywords/creator/producer/created/modified metadata, for any of the twelve supported formats (docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, pdf); csv and svg carry no metadata container of their own, so they always report none. `--json` emits the raw metadata object:
+**`metadata <input>`** — prints a document's own title/author/subject/keywords/creator/producer/created/modified metadata, for any of the thirteen supported formats (docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, rtf, pdf); csv and svg carry no metadata container of their own, so they always report none. `--json` emits the raw metadata object:
 
 ```sh
 document-cli metadata report.pdf
@@ -231,7 +231,7 @@ It supports the same seven formats documents.js's live-view editors cover — do
 
 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.
 
-Three further kinds of format open read-only: a `.odb` browses its tables and rows with no write path at all (documents.js's own `.odb` support has no write direction to offer), a `.pdf` browses its pages and positioned items rather than being edited in place, and a `.xlsx`, `.csv`, or `.svg` opens as a converted PDF preview — documents.js has no spreadsheet or svg editor to hold a live view into, so opening one runs `xlsxToPdf`, `csvToPdf`, or `svgToPdf` once at open time and browses the result through the identical page-list/page-items/item-detail screens a real `.pdf` uses, with the original bytes kept alongside so a later export re-runs the same conversion with the caller's own fonts and diagnostics rather than reusing the fixed preview conversion. A `.odb` additionally browses its _structure_ alongside its data: `f` from the table list opens the form browser and `r` the report browser, each listing what the database declares and opening one to show it in full — a form's own data source and field-bound controls (sub-forms nested under their parent), a report's data-source command, band and group structure, and every `rpt:` formula. Both are rendered through the same `src/odb-structure.ts` the `odb-forms`/`odb-reports` commands print, so the two views cannot drift apart, and search filters by line (`/SUM` narrows a long report to its aggregate expressions). `Enter` on a report's own detail screen renders it — its data-source command resolved, its `rpt:` formulas evaluated, its bands laid out — to a real `docx`/`odt`/`pdf` file, through the same two-field destination-path-then-font-list form the PDF-export screen below uses; the TUI counterpart to the `odb-render-report` command. A standalone `.odf` formula document has no TUI editor either — nothing to edit interactively, only a PDF conversion.
+Three further kinds of format open read-only: a `.odb` browses its tables and rows with no write path at all (documents.js's own `.odb` support has no write direction to offer), a `.pdf` browses its pages and positioned items rather than being edited in place, and a `.xlsx`, `.csv`, `.svg`, or `.rtf` opens as a converted PDF preview — documents.js has no spreadsheet, svg, or rtf editor to hold a live view into, so opening one runs `xlsxToPdf`, `csvToPdf`, `svgToPdf`, or `rtfToPdf` once at open time and browses the result through the identical page-list/page-items/item-detail screens a real `.pdf` uses, with the original bytes kept alongside so a later export re-runs the same conversion with the caller's own fonts and diagnostics rather than reusing the fixed preview conversion. A `.odb` additionally browses its _structure_ alongside its data: `f` from the table list opens the form browser and `r` the report browser, each listing what the database declares and opening one to show it in full — a form's own data source and field-bound controls (sub-forms nested under their parent), a report's data-source command, band and group structure, and every `rpt:` formula. Both are rendered through the same `src/odb-structure.ts` the `odb-forms`/`odb-reports` commands print, so the two views cannot drift apart, and search filters by line (`/SUM` narrows a long report to its aggregate expressions). `Enter` on a report's own detail screen renders it — its data-source command resolved, its `rpt:` formulas evaluated, its bands laid out — to a real `docx`/`odt`/`pdf` file, through the same two-field destination-path-then-font-list form the PDF-export screen below uses; the TUI counterpart to the `odb-render-report` command. A standalone `.odf` formula document has no TUI editor either — nothing to edit interactively, only a PDF conversion.
 
 The export-to-PDF screen (`e` from any editor screen) is a two-field form: a destination path, then an optional comma-separated list of local `.ttf`/`.otf` paths, which are the same `--font-file` faces the CLI takes and are derived the same way — each font's family, weight, and slope come from the file itself. `Enter` on the path field moves to the fonts field and `Enter` there exports, so leaving fonts empty is still "type a path, press Enter twice". Comma-separated rather than space-separated because a font path routinely contains spaces and almost never a comma. A face falling back to a substitute is reported into the same diagnostics panel a character substitution already is, and a bad font path fails the export with the file named, before anything is written to the destination.
 

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-CrwHiiuS.js";
+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-DX5OkaeR.js";
 import { Command, CommanderError, InvalidArgumentError } from "commander";
 import { writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, resolve } from "node:path";
@@ -139,7 +139,7 @@ function createFilesystemMarkdownImageResolver(baseDir) {
 }
 //#endregion
 //#region src/commands/shared.ts
-const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, pdf";
+const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, rtf, pdf";
 function resolveTargetFormat(output, out, to) {
 	if (to !== void 0) {
 		if (!isDocumentFormat(to)) return { errorMessage: `unknown --to format '${to}'; expected one of ${KNOWN_DOCUMENT_FORMATS}` };
@@ -1175,8 +1175,8 @@ function registerSetMetadataCommand(program) {
 	const command = program.command("set-metadata <input> [output]").description("patch a document's own title/author/subject/keywords, leaving every other field and every other flag as-is").addHelpText("after", [
 		"",
 		"Two write paths: a pdf source/target patches the metadata directly on the parsed PDF (writePdf), with no layout engine",
-		"involved at all -- genuinely lossless for everything else on the page. Every other supported format (docx, pptx, odt,",
-		"odp, ods, odg, markdown) rebuilds a fresh package from that format's own ContentDocument -- for docx specifically,",
+		"involved at all -- genuinely lossless for everything else on the page. Every other supported format (docx, pptx, xlsx,",
+		"odt, odp, ods, odg, markdown, rtf) rebuilds a fresh package from that format's own ContentDocument -- for docx specifically,",
 		"this is LOSSY: it drops anything docx-extras covers (comments, footnotes, headers/footers, numbering definitions),",
 		"since buildDocxPackage builds a fresh package from the ContentDocument alone, with no way to carry that data through.",
 		"",
@@ -1199,12 +1199,12 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "5.1.7";
+var version = "5.2.1";
 //#endregion
 //#region src/program.ts
 function createProgram() {
 	const program = new Command("document-cli");
-	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and inspector as a scriptable command");
+	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown/rtf conversion, bridge, and inspector as a scriptable command");
 	program.version(version);
 	program.exitOverride((error) => {
 		process.exitCode = error.exitCode === 0 ? 0 : 2;
@@ -1227,7 +1227,7 @@ function createProgram() {
 //#region src/cli.ts
 async function launchTui(startPath, signal) {
 	try {
-		const { runTui } = await import("./tui-D62kBV1i.js");
+		const { runTui } = await import("./tui-BIN_wCkn.js");
 		await runTui({
 			startPath,
 			signal

package/dist/index.cjs

@@ -31,6 +31,7 @@ const EXTENSION_TO_FORMAT = {
 	svg: "svg",
 	markdown: "markdown",
 	md: "markdown",
+	rtf: "rtf",
 	pdf: "pdf"
 };
 const FORMAT_TO_EXTENSION = {
@@ -45,6 +46,7 @@ const FORMAT_TO_EXTENSION = {
 	csv: "csv",
 	svg: "svg",
 	markdown: "md",
+	rtf: "rtf",
 	pdf: "pdf"
 };
 function isDocumentFormat(value) {
@@ -257,7 +259,7 @@ function resolveDefaultOutputPath(inputPath, targetFormat) {
 }
 //#endregion
 //#region src/commands/shared.ts
-const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, pdf";
+const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, rtf, pdf";
 function resolveTargetFormat(output, out, to) {
 	if (to !== void 0) {
 		if (!isDocumentFormat(to)) return { errorMessage: `unknown --to format '${to}'; expected one of ${KNOWN_DOCUMENT_FORMATS}` };
@@ -1513,8 +1515,8 @@ function registerSetMetadataCommand(program) {
 	const command = program.command("set-metadata <input> [output]").description("patch a document's own title/author/subject/keywords, leaving every other field and every other flag as-is").addHelpText("after", [
 		"",
 		"Two write paths: a pdf source/target patches the metadata directly on the parsed PDF (writePdf), with no layout engine",
-		"involved at all -- genuinely lossless for everything else on the page. Every other supported format (docx, pptx, odt,",
-		"odp, ods, odg, markdown) rebuilds a fresh package from that format's own ContentDocument -- for docx specifically,",
+		"involved at all -- genuinely lossless for everything else on the page. Every other supported format (docx, pptx, xlsx,",
+		"odt, odp, ods, odg, markdown, rtf) rebuilds a fresh package from that format's own ContentDocument -- for docx specifically,",
 		"this is LOSSY: it drops anything docx-extras covers (comments, footnotes, headers/footers, numbering definitions),",
 		"since buildDocxPackage builds a fresh package from the ContentDocument alone, with no way to carry that data through.",
 		"",
@@ -1537,12 +1539,12 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "5.1.7";
+var version = "5.2.1";
 //#endregion
 //#region src/program.ts
 function createProgram() {
 	const program = new commander.Command("document-cli");
-	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and inspector as a scriptable command");
+	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown/rtf conversion, bridge, and inspector as a scriptable command");
 	program.version(version);
 	program.exitOverride((error) => {
 		process.exitCode = error.exitCode === 0 ? 0 : 2;

package/dist/index.js

@@ -30,6 +30,7 @@ const EXTENSION_TO_FORMAT = {
 	svg: "svg",
 	markdown: "markdown",
 	md: "markdown",
+	rtf: "rtf",
 	pdf: "pdf"
 };
 const FORMAT_TO_EXTENSION = {
@@ -44,6 +45,7 @@ const FORMAT_TO_EXTENSION = {
 	csv: "csv",
 	svg: "svg",
 	markdown: "md",
+	rtf: "rtf",
 	pdf: "pdf"
 };
 function isDocumentFormat(value) {
@@ -256,7 +258,7 @@ function resolveDefaultOutputPath(inputPath, targetFormat) {
 }
 //#endregion
 //#region src/commands/shared.ts
-const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, pdf";
+const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, rtf, pdf";
 function resolveTargetFormat(output, out, to) {
 	if (to !== void 0) {
 		if (!isDocumentFormat(to)) return { errorMessage: `unknown --to format '${to}'; expected one of ${KNOWN_DOCUMENT_FORMATS}` };
@@ -1512,8 +1514,8 @@ function registerSetMetadataCommand(program) {
 	const command = program.command("set-metadata <input> [output]").description("patch a document's own title/author/subject/keywords, leaving every other field and every other flag as-is").addHelpText("after", [
 		"",
 		"Two write paths: a pdf source/target patches the metadata directly on the parsed PDF (writePdf), with no layout engine",
-		"involved at all -- genuinely lossless for everything else on the page. Every other supported format (docx, pptx, odt,",
-		"odp, ods, odg, markdown) rebuilds a fresh package from that format's own ContentDocument -- for docx specifically,",
+		"involved at all -- genuinely lossless for everything else on the page. Every other supported format (docx, pptx, xlsx,",
+		"odt, odp, ods, odg, markdown, rtf) rebuilds a fresh package from that format's own ContentDocument -- for docx specifically,",
 		"this is LOSSY: it drops anything docx-extras covers (comments, footnotes, headers/footers, numbering definitions),",
 		"since buildDocxPackage builds a fresh package from the ContentDocument alone, with no way to carry that data through.",
 		"",
@@ -1536,12 +1538,12 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "5.1.7";
+var version = "5.2.1";
 //#endregion
 //#region src/program.ts
 function createProgram() {
 	const program = new Command("document-cli");
-	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and inspector as a scriptable command");
+	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown/rtf conversion, bridge, and inspector as a scriptable command");
 	program.version(version);
 	program.exitOverride((error) => {
 		process.exitCode = error.exitCode === 0 ? 0 : 2;

package/dist/{odb-structure-CrwHiiuS.js → odb-structure-DX5OkaeR.js}

@@ -26,6 +26,7 @@ const EXTENSION_TO_FORMAT = {
 	svg: "svg",
 	markdown: "markdown",
 	md: "markdown",
+	rtf: "rtf",
 	pdf: "pdf"
 };
 const FORMAT_TO_EXTENSION = {
@@ -40,6 +41,7 @@ const FORMAT_TO_EXTENSION = {
 	csv: "csv",
 	svg: "svg",
 	markdown: "md",
+	rtf: "rtf",
 	pdf: "pdf"
 };
 function isDocumentFormat(value) {

package/dist/{tui-D62kBV1i.js → tui-BIN_wCkn.js}

@@ -1,7 +1,7 @@
-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-CrwHiiuS.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-DX5OkaeR.js";
 import { readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join } from "node:path";
-import { bytesToBase64, cellReference, columnIndexToLetters, createDocx, createOdg, createOdp, createOds, createOdt, createPdf, createPptx, csvToPdf, decodeMarkdownText, decodeOdbPackage, docxToPdf, encodeMarkdownText, hsqldbCellDisplayText, markdownToPdf, odbReportToDocx, odbReportToOdt, odbReportToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openMarkdown, openOdg, openOdp, openOds, openOdt, openPdf, openPptx, parseXml, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, svgToPdf, xlsxToPdf } from "documents.js";
+import { bytesToBase64, cellReference, columnIndexToLetters, createDocx, createOdg, createOdp, createOds, createOdt, createPdf, createPptx, csvToPdf, decodeMarkdownText, decodeOdbPackage, docxToPdf, encodeMarkdownText, hsqldbCellDisplayText, markdownToPdf, odbReportToDocx, odbReportToOdt, odbReportToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openMarkdown, openOdg, openOdp, openOds, openOdt, openPdf, openPptx, parseXml, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, rtfToPdf, svgToPdf, 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";
@@ -57,6 +57,11 @@ async function exportToPdf(openDocument, destinationPath, options) {
 		await writeFile(destinationPath, pdfBytes);
 		return;
 	}
+	if (openDocument.format === "rtf") {
+		const pdfBytes = rtfToPdf(openDocument.bytes, pdfOptions);
+		await writeFile(destinationPath, pdfBytes);
+		return;
+	}
 	const bytes = openDocument.editor.toBytes();
 	const pdfBytes = convert(openDocument.format, bytes, pdfOptions);
 	await writeFile(destinationPath, pdfBytes);
@@ -170,6 +175,12 @@ async function openDocumentAtPath(path, options = {}) {
 			bytes,
 			path
 		};
+		case "rtf": return {
+			format,
+			layout: readPdf(rtfToPdf(bytes)),
+			bytes,
+			path
+		};
 		case "odf": throw new Error("A standalone .odf formula document has no editor; convert it to PDF (odfToPdf) instead");
 	}
 }
@@ -217,7 +228,7 @@ function createNewDocument(format) {
 	}
 }
 async function saveDocumentTo(openDocument, path) {
-	if (openDocument.format === "odb" || openDocument.format === "xlsx" || openDocument.format === "csv" || openDocument.format === "svg") throw new Error(`A ${openDocument.format} document is opened read-only and cannot be written back`);
+	if (openDocument.format === "odb" || openDocument.format === "xlsx" || openDocument.format === "csv" || openDocument.format === "svg" || openDocument.format === "rtf") 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.editor.toMarkdownText()));
 		return;
@@ -301,7 +312,8 @@ function rootScreenForFormat(format) {
 		case "pdf":
 		case "xlsx":
 		case "csv":
-		case "svg": return { kind: "pdfPageList" };
+		case "svg":
+		case "rtf": return { kind: "pdfPageList" };
 	}
 }
 function currentScreen(state) {
@@ -450,6 +462,12 @@ function documentWithPath(doc, path) {
 			bytes: doc.bytes,
 			path
 		};
+		case "rtf": return {
+			format: "rtf",
+			layout: doc.layout,
+			bytes: doc.bytes,
+			path
+		};
 	}
 }
 function reopenEditable(doc, bytes) {
@@ -768,7 +786,7 @@ function appReducer(state, action) {
 			selection: {},
 			errorDetail: void 0,
 			stack: [rootScreenForFormat(action.doc.format)]
-		}, "info", action.doc.format === "xlsx" || action.doc.format === "csv" || action.doc.format === "svg" ? `Opened ${action.path} as a read-only PDF preview -- press ':' then 'export pdf' to save it as a real PDF` : `Opened ${action.path}`);
+		}, "info", action.doc.format === "xlsx" || action.doc.format === "csv" || action.doc.format === "svg" || action.doc.format === "rtf" ? `Opened ${action.path} as a read-only PDF preview -- press ':' then 'export pdf' to save it as a real PDF` : `Opened ${action.path}`);
 		case "OPEN_FILE_ERROR": return withStatus({
 			...state,
 			errorDetail: {
@@ -1363,7 +1381,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 === "xlsx" || doc.format === "csv" || doc.format === "svg") 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" || doc.format === "csv" || doc.format === "svg" || doc.format === "rtf") 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" ? {
@@ -7207,7 +7225,7 @@ function OdtBodyListScreen() {
 //#endregion
 //#region src/tui/screens/editors/pdf/shared.ts
 function requirePdfDocument(openDocument) {
-	if (openDocument?.format !== "pdf" && openDocument?.format !== "xlsx" && openDocument?.format !== "csv" && openDocument?.format !== "svg") throw new Error("A PDF inspection screen rendered without an open PDF, xlsx, csv, or svg document; the app router only reaches this screen group from pdfPageList, which is only ever the root screen of one of those four formats.");
+	if (openDocument?.format !== "pdf" && openDocument?.format !== "xlsx" && openDocument?.format !== "csv" && openDocument?.format !== "svg" && openDocument?.format !== "rtf") throw new Error("A PDF inspection screen rendered without an open PDF, xlsx, csv, svg, or rtf document; the app router only reaches this screen group from pdfPageList, which is only ever the root screen of one of those five formats.");
 	return openDocument;
 }
 function isEditablePdfDocument(doc) {
@@ -8871,7 +8889,7 @@ function LauncherScreen() {
 			}),
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: "A terminal editor for docx, pptx, odt, odp, ods, odg, markdown, odb and pdf -- xlsx, csv and svg open as read-only PDF previews."
+				children: "A terminal editor for docx, pptx, odt, odp, ods, odg, markdown, odb and pdf -- xlsx, csv, svg and rtf open as read-only PDF previews."
 			}),
 			/* @__PURE__ */ jsx(Text, { children: " " }),
 			/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
@@ -9038,7 +9056,8 @@ function metadataFor(doc) {
 		case "pdf":
 		case "xlsx":
 		case "csv":
-		case "svg": return doc.layout.metadata;
+		case "svg":
+		case "rtf": 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.");
 	}
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "document-cli",
-  "version": "5.1.7",
-  "description": "CLI and interactive Ink TUI for documents.js: every docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and editor as a scriptable command or a terminal app.",
+  "version": "5.2.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": {
     "type": "git",
@@ -92,7 +92,7 @@
     "commander": "^15.0.0",
     "document-outline.js": "^3.2.1",
     "document-schema.js": "^5.4.0",
-    "documents.js": "^6.2.2",
+    "documents.js": "^6.3.1",
     "ink": "^7.1.1",
     "ink-text-input": "^6.0.0",
     "react": "^19.2.8"