document-cli 5.11.51 → 5.12.0

package/README.md

@@ -277,8 +277,8 @@ pnpm typecheck     # turbo run _typecheck -> tsc --noEmit
 pnpm lint          # turbo run _lint -> eslint . --fix --cache --max-warnings 0
 pnpm test          # turbo run _test -> vitest run --project unit
 pnpm test:watch    # vitest --project unit
-pnpm test:smoke    # turbo run _test:smoke -> tsdown, then vitest run --project smoke -- spawns the built dist/cli.js as a real child process
-pnpm test:workers  # turbo run _test:workers -> vitest run --config vitest.workers.config.ts -- runs the thin isomorphic slice (src/sql-result-format.ts, src/runtime/exit-codes.ts) under the real Cloudflare Workers runtime (workerd), proving the wrapped documents.js paths execute inside a workerd isolate with no Node-only API usage
+pnpm test:smoke    # turbo run _test:smoke -> tsdown, then vitest run --project smoke — spawns the built dist/cli.js as a real child process
+pnpm test:workers  # turbo run _test:workers -> vitest run --config vitest.workers.config.ts — runs the thin isomorphic slice (src/sql-result-format.ts, src/runtime/exit-codes.ts) under the real Cloudflare Workers runtime (workerd), proving the wrapped documents.js paths execute inside a workerd isolate with no Node-only API usage
 ```
 
 ## Gotchas

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-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-yc8OHoC0.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-Crz3Yzzb.js";
 import { Command, CommanderError, InvalidArgumentError } from "commander";
 import { writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, resolve } from "node:path";
@@ -142,7 +142,7 @@ function resolveTargetFormat(output, out, to) {
 		return { format: to };
 	}
 	const destination = output ?? out;
-	if (destination === void 0) return { errorMessage: "cannot infer a target format -- pass an output path with a recognised extension, --out with one, or --to <format>" };
+	if (destination === void 0) return { errorMessage: "cannot infer a target format — pass an output path with a recognised extension, --out with one, or --to <format>" };
 	const inferred = inferFormatFromExtension(destination);
 	if (inferred === void 0) return { errorMessage: `cannot infer a target format from '${destination}'; pass --to <format> instead` };
 	return { format: inferred };
@@ -275,11 +275,11 @@ function toConversionCommandOptions(options) {
 async function runGenericConvert(input, output, options) {
 	const extension = extname(input).toLowerCase();
 	if (extension === ".odm") {
-		process.stderr.write("convert: '.odm' master documents are not supported by the generic convert command -- use 'odm-to-pdf' instead\n");
+		process.stderr.write("convert: '.odm' master documents are not supported by the generic convert command — use 'odm-to-pdf' instead\n");
 		return 2;
 	}
 	if (extension === ".odb") {
-		process.stderr.write("convert: '.odb' embedded databases are not supported by the generic convert command -- use 'odb-to-csv', 'odb-to-xlsx', or 'odb-tables' instead\n");
+		process.stderr.write("convert: '.odb' embedded databases are not supported by the generic convert command — use 'odb-to-csv', 'odb-to-xlsx', or 'odb-tables' instead\n");
 		return 2;
 	}
 	const source = inferFormatFromExtension(input);
@@ -342,7 +342,7 @@ async function runDocxExtras(input, options) {
 	}
 }
 function registerDocxExtrasCommand(program) {
-	program.command("docx-extras <input>").description("print a docx's own comments, footnotes, headers, footers, and numbering definitions -- data readDocxContent's ContentDocument cannot carry").option("--json", "emit the raw DocxExtras object as JSON instead of a human-readable report", false).action(async (input, options) => {
+	program.command("docx-extras <input>").description("print a docx's own comments, footnotes, headers, footers, and numbering definitions — data readDocxContent's ContentDocument cannot carry").option("--json", "emit the raw DocxExtras object as JSON instead of a human-readable report", false).action(async (input, options) => {
 		process.exitCode = await runDocxExtras(input, options);
 	});
 }
@@ -374,7 +374,7 @@ async function runFonts(input, options) {
 		}
 		for (const face of summaries) {
 			const style = [face.bold ? "bold" : void 0, face.italic ? "italic" : void 0].filter((value) => value !== void 0).join(" ");
-			process.stdout.write(`${face.family}${style === "" ? "" : ` (${style})`} -- ${face.byteLength} bytes\n`);
+			process.stdout.write(`${face.family}${style === "" ? "" : ` (${style})`} — ${face.byteLength} bytes\n`);
 		}
 		return 0;
 	} catch (error) {
@@ -439,7 +439,7 @@ async function runFromPackage(input, output, options) {
 		}
 		const result = documentFromJson(parsed);
 		if (result.kind !== "DocumentTree") {
-			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentTree -- only a file written by --dump-package can be read back by this command\n`);
+			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentTree — only a file written by --dump-package can be read back by this command\n`);
 			return 2;
 		}
 		const content = flattenTree(result.value);
@@ -460,19 +460,19 @@ async function runFromPackage(input, output, options) {
 		return 0;
 	} catch (error) {
 		if (error instanceof UnrecognizedDocumentSchemaError) {
-			process.stderr.write(`[${command}] '${input}' has no recognised $schema -- only a file written by --dump-package can be read back by this command\n`);
+			process.stderr.write(`[${command}] '${input}' has no recognised $schema — only a file written by --dump-package can be read back by this command\n`);
 			return 1;
 		}
 		if (isSchemaVersionMismatchError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a DocumentTree dump from document-schema.js@${error.dumpVersion}, but this CLI's documents.js reads only @${error.installedVersion}-major dumps -- 4.0.0 replaced the flat { formatVersion, content, pages } shape with the tree-form DocumentTree (ExaDev/document-schema.js#20); re-run the source conversion with --dump-package to write a current dump\n`);
+			process.stderr.write(`[${command}] '${input}' is a DocumentTree dump from document-schema.js@${error.dumpVersion}, but this CLI's documents.js reads only @${error.installedVersion}-major dumps — 4.0.0 replaced the flat { formatVersion, content, pages } shape with the tree-form DocumentTree (ExaDev/document-schema.js#20); re-run the source conversion with --dump-package to write a current dump\n`);
 			return 1;
 		}
 		if (isLayoutSchemaDemotedError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a LayoutDocument dump -- LayoutDocument moved to pdf-codec in document-schema.js 4.0.0 and is no longer a schema-stamped input; re-run the source conversion with --dump-package and read that package back instead\n`);
+			process.stderr.write(`[${command}] '${input}' is a LayoutDocument dump — LayoutDocument moved to pdf-codec in document-schema.js 4.0.0 and is no longer a schema-stamped input; re-run the source conversion with --dump-package and read that package back instead\n`);
 			return 1;
 		}
 		if (isDocumentPackageRenamedError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a document-package dump -- DocumentPackage was renamed to DocumentTree in document-schema.js 5.0.0 (ExaDev/documents.js#661); re-run the source conversion with --dump-package to write a current tree-form DocumentTree dump\n`);
+			process.stderr.write(`[${command}] '${input}' is a document-package dump — DocumentPackage was renamed to DocumentTree in document-schema.js 5.0.0 (ExaDev/documents.js#661); re-run the source conversion with --dump-package to write a current tree-form DocumentTree dump\n`);
 			return 1;
 		}
 		process.stderr.write(`${formatError(error, options.verbose)}\n`);
@@ -666,7 +666,7 @@ function resolveQuerySql(pkg, options) {
 	const saved = inventory.queries.find((candidate) => candidate.name === queryName);
 	if (saved === void 0) {
 		const available = inventory.queries.map((candidate) => candidate.name);
-		return { errorMessage: `this .odb declares no saved query named '${queryName}'${available.length === 0 ? "" : ` -- available: ${available.join(", ")}`}` };
+		return { errorMessage: `this .odb declares no saved query named '${queryName}'${available.length === 0 ? "" : ` — available: ${available.join(", ")}`}` };
 	}
 	return { sql: saved.command };
 }
@@ -833,7 +833,7 @@ function registerOdbToCsvCommand(program) {
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
-	command.option("--table <name>", "the table to export -- required when the .odb declares more than one table");
+	command.option("--table <name>", "the table to export — required when the .odb declares more than one table");
 	command.action(async (input, output, options) => {
 		process.exitCode = await runOdbToCsv(input, output, options);
 	});
@@ -854,19 +854,19 @@ function registerOdbReportsCommand(program) {
 	});
 }
 function registerOdbQueryCommand(program) {
-	program.command("odb-query <input>").description("run a bounded SELECT over an embedded .odb database's own extracted tables, given directly or by naming one of its saved queries").option("--sql <text>", "the SELECT statement to run -- mutually exclusive with --query").option("--query <savedName>", "the name of one of the .odb's own saved queries to run -- mutually exclusive with --sql").option("--json", "emit the result set as JSON ({ columns, rows }) instead of a plain-text table", false).action(async (input, options) => {
+	program.command("odb-query <input>").description("run a bounded SELECT over an embedded .odb database's own extracted tables, given directly or by naming one of its saved queries").option("--sql <text>", "the SELECT statement to run — mutually exclusive with --query").option("--query <savedName>", "the name of one of the .odb's own saved queries to run — mutually exclusive with --sql").option("--json", "emit the result set as JSON ({ columns, rows }) instead of a plain-text table", false).action(async (input, options) => {
 		process.exitCode = await runOdbQuery(input, options);
 	});
 }
 function registerOdbRenderReportCommand(program) {
-	const command = program.command("odb-render-report <input> [output]").description("render one of an .odb's own reports -- its query resolved, its rpt: formulas evaluated, its bands laid out -- to docx, odt, or pdf");
+	const command = program.command("odb-render-report <input> [output]").description("render one of an .odb's own reports — its query resolved, its rpt: formulas evaluated, its bands laid out — to docx, odt, or pdf");
 	addOutOption(command);
 	addTimeoutOption(command);
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
 	addFontOptions(command);
-	command.option("--report <name>", "the report to render -- required only when the .odb declares more than one report");
+	command.option("--report <name>", "the report to render — required only when the .odb declares more than one report");
 	command.option("--to <format>", "target format when it cannot be inferred from the output path (docx, odt, pdf)");
 	command.action(async (input, output, options) => {
 		process.exitCode = await runOdbRenderReport(input, output, options);
@@ -1037,7 +1037,7 @@ async function runOutline(input, options) {
 	}
 }
 function registerOutlineCommand(program) {
-	const command = program.command("outline <input>").description(`print a document's outline -- headings, list items, and slide/sheet/page groups as indented text (${KNOWN_DOCUMENT_FORMATS})`);
+	const command = program.command("outline <input>").description(`print a document's outline — headings, list items, and slide/sheet/page groups as indented text (${KNOWN_DOCUMENT_FORMATS})`);
 	addTimeoutOption(command);
 	command.option("--json", "emit the outline tree as JSON instead of indented text (diagnostics as NDJSON on stderr)", false);
 	addQuietOption(command);
@@ -1171,12 +1171,12 @@ 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", [
 		"",
 		"Three write paths: a pdf source/target patches the metadata directly on the parsed PDF (writePdf), and a docx source/target",
-		"patches docProps/core.xml directly on the decoded package -- both with no layout engine or ContentDocument rebuild involved",
-		"at all, so everything else on the page (pdf) or in the package (docx -- comments, footnotes, headers/footers, numbering",
+		"patches docProps/core.xml directly on the decoded package — both with no layout engine or ContentDocument rebuild involved",
+		"at all, so everything else on the page (pdf) or in the package (docx — comments, footnotes, headers/footers, numbering",
 		"definitions included) survives byte-faithful. Every other supported format (pptx, xlsx, odt, odp, ods, odg, markdown, rtf)",
 		"rebuilds a fresh package from that format's own ContentDocument instead.",
 		"",
-		"set-metadata does not convert format -- source and target must match. Run convert/from-package first, then",
+		"set-metadata does not convert format — source and target must match. Run convert/from-package first, then",
 		"set-metadata on the result, if you need a different target format."
 	].join("\n"));
 	addOutOption(command);
@@ -1195,7 +1195,7 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "5.11.51";
+var version = "5.12.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {
@@ -1223,7 +1223,7 @@ function createProgram() {
 //#region src/cli-main.ts
 async function launchTui(startPath, signal) {
 	try {
-		const { runTui } = await import("./tui-CogHEvyJ.js");
+		const { runTui } = await import("./tui-y8MLtP8W.js");
 		await runTui({
 			startPath,
 			signal
@@ -1238,7 +1238,7 @@ function findStartPath(args) {
 	return args.find((arg) => !arg.startsWith("-"));
 }
 /**
-* The real, full-featured CLI entry logic -- `src/cli.ts` (the published npm `bin`, run under a real Node.js install) awaits this at its own top level. The SEA build (`src/sea-entry.ts`) does NOT use this function; it uses `src/cli-main-sea.ts`'s own TUI-free equivalent instead, so that Ink's module graph is never reachable from the SEA bundle's own entry at all -- see this file's own top comment.
+* The real, full-featured CLI entry logic — `src/cli.ts` (the published npm `bin`, run under a real Node.js install) awaits this at its own top level. The SEA build (`src/sea-entry.ts`) does NOT use this function; it uses `src/cli-main-sea.ts`'s own TUI-free equivalent instead, so that Ink's module graph is never reachable from the SEA bundle's own entry at all — see this file's own top comment.
 */
 async function main() {
 	const { signal } = createRuntimeSignal({});

package/dist/index.cjs

@@ -273,7 +273,7 @@ function resolveTargetFormat(output, out, to) {
 		return { format: to };
 	}
 	const destination = output ?? out;
-	if (destination === void 0) return { errorMessage: "cannot infer a target format -- pass an output path with a recognised extension, --out with one, or --to <format>" };
+	if (destination === void 0) return { errorMessage: "cannot infer a target format — pass an output path with a recognised extension, --out with one, or --to <format>" };
 	const inferred = inferFormatFromExtension(destination);
 	if (inferred === void 0) return { errorMessage: `cannot infer a target format from '${destination}'; pass --to <format> instead` };
 	return { format: inferred };
@@ -406,11 +406,11 @@ function toConversionCommandOptions(options) {
 async function runGenericConvert(input, output, options) {
 	const extension = (0, node_path.extname)(input).toLowerCase();
 	if (extension === ".odm") {
-		process.stderr.write("convert: '.odm' master documents are not supported by the generic convert command -- use 'odm-to-pdf' instead\n");
+		process.stderr.write("convert: '.odm' master documents are not supported by the generic convert command — use 'odm-to-pdf' instead\n");
 		return 2;
 	}
 	if (extension === ".odb") {
-		process.stderr.write("convert: '.odb' embedded databases are not supported by the generic convert command -- use 'odb-to-csv', 'odb-to-xlsx', or 'odb-tables' instead\n");
+		process.stderr.write("convert: '.odb' embedded databases are not supported by the generic convert command — use 'odb-to-csv', 'odb-to-xlsx', or 'odb-tables' instead\n");
 		return 2;
 	}
 	const source = inferFormatFromExtension(input);
@@ -537,7 +537,7 @@ async function runDocxExtras(input, options) {
 	}
 }
 function registerDocxExtrasCommand(program) {
-	program.command("docx-extras <input>").description("print a docx's own comments, footnotes, headers, footers, and numbering definitions -- data readDocxContent's ContentDocument cannot carry").option("--json", "emit the raw DocxExtras object as JSON instead of a human-readable report", false).action(async (input, options) => {
+	program.command("docx-extras <input>").description("print a docx's own comments, footnotes, headers, footers, and numbering definitions — data readDocxContent's ContentDocument cannot carry").option("--json", "emit the raw DocxExtras object as JSON instead of a human-readable report", false).action(async (input, options) => {
 		process.exitCode = await runDocxExtras(input, options);
 	});
 }
@@ -569,7 +569,7 @@ async function runFonts(input, options) {
 		}
 		for (const face of summaries) {
 			const style = [face.bold ? "bold" : void 0, face.italic ? "italic" : void 0].filter((value) => value !== void 0).join(" ");
-			process.stdout.write(`${face.family}${style === "" ? "" : ` (${style})`} -- ${face.byteLength} bytes\n`);
+			process.stdout.write(`${face.family}${style === "" ? "" : ` (${style})`} — ${face.byteLength} bytes\n`);
 		}
 		return 0;
 	} catch (error) {
@@ -634,7 +634,7 @@ async function runFromPackage(input, output, options) {
 		}
 		const result = (0, documents_js.documentFromJson)(parsed);
 		if (result.kind !== "DocumentTree") {
-			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentTree -- only a file written by --dump-package can be read back by this command\n`);
+			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentTree — only a file written by --dump-package can be read back by this command\n`);
 			return 2;
 		}
 		const content = (0, document_schema_js.flattenTree)(result.value);
@@ -655,19 +655,19 @@ async function runFromPackage(input, output, options) {
 		return 0;
 	} catch (error) {
 		if (error instanceof documents_js.UnrecognizedDocumentSchemaError) {
-			process.stderr.write(`[${command}] '${input}' has no recognised $schema -- only a file written by --dump-package can be read back by this command\n`);
+			process.stderr.write(`[${command}] '${input}' has no recognised $schema — only a file written by --dump-package can be read back by this command\n`);
 			return 1;
 		}
 		if (isSchemaVersionMismatchError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a DocumentTree dump from document-schema.js@${error.dumpVersion}, but this CLI's documents.js reads only @${error.installedVersion}-major dumps -- 4.0.0 replaced the flat { formatVersion, content, pages } shape with the tree-form DocumentTree (ExaDev/document-schema.js#20); re-run the source conversion with --dump-package to write a current dump\n`);
+			process.stderr.write(`[${command}] '${input}' is a DocumentTree dump from document-schema.js@${error.dumpVersion}, but this CLI's documents.js reads only @${error.installedVersion}-major dumps — 4.0.0 replaced the flat { formatVersion, content, pages } shape with the tree-form DocumentTree (ExaDev/document-schema.js#20); re-run the source conversion with --dump-package to write a current dump\n`);
 			return 1;
 		}
 		if (isLayoutSchemaDemotedError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a LayoutDocument dump -- LayoutDocument moved to pdf-codec in document-schema.js 4.0.0 and is no longer a schema-stamped input; re-run the source conversion with --dump-package and read that package back instead\n`);
+			process.stderr.write(`[${command}] '${input}' is a LayoutDocument dump — LayoutDocument moved to pdf-codec in document-schema.js 4.0.0 and is no longer a schema-stamped input; re-run the source conversion with --dump-package and read that package back instead\n`);
 			return 1;
 		}
 		if (isDocumentPackageRenamedError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a document-package dump -- DocumentPackage was renamed to DocumentTree in document-schema.js 5.0.0 (ExaDev/documents.js#661); re-run the source conversion with --dump-package to write a current tree-form DocumentTree dump\n`);
+			process.stderr.write(`[${command}] '${input}' is a document-package dump — DocumentPackage was renamed to DocumentTree in document-schema.js 5.0.0 (ExaDev/documents.js#661); re-run the source conversion with --dump-package to write a current tree-form DocumentTree dump\n`);
 			return 1;
 		}
 		process.stderr.write(`${formatError(error, options.verbose)}\n`);
@@ -775,7 +775,7 @@ function countOdbFormDefinitionBoundControls(definition) {
 function describeOdbForm(form) {
 	const controlCount = form.forms.reduce((total, definition) => total + countOdbFormDefinitionControls(definition), 0);
 	const boundCount = form.forms.reduce((total, definition) => total + countOdbFormDefinitionBoundControls(definition), 0);
-	return `${form.name} [${form.href}] -- ${form.forms.length} form${form.forms.length === 1 ? "" : "s"}, ${controlCount} control${controlCount === 1 ? "" : "s"} (${boundCount} bound)`;
+	return `${form.name} [${form.href}] — ${form.forms.length} form${form.forms.length === 1 ? "" : "s"}, ${controlCount} control${controlCount === 1 ? "" : "s"} (${boundCount} bound)`;
 }
 function formControlLines(control, depth) {
 	const parts = [control.tag];
@@ -825,7 +825,7 @@ function describeOdbReport(report) {
 	const groupCount = countReportGroups(report.groups);
 	const elementCount = countReportBandElements(report.reportHeader) + countReportBandElements(report.pageHeader) + countReportBandElements(report.detail) + countReportBandElements(report.pageFooter) + countReportBandElements(report.reportFooter) + report.groups.reduce((total, group) => total + countReportGroupElements(group), 0);
 	const source = dataSource === void 0 ? "no data source" : `on ${dataSource}`;
-	return `${report.name} [${report.href}] -- ${source}, ${groupCount} group${groupCount === 1 ? "" : "s"}, ${elementCount} element${elementCount === 1 ? "" : "s"}`;
+	return `${report.name} [${report.href}] — ${source}, ${groupCount} group${groupCount === 1 ? "" : "s"}, ${elementCount} element${elementCount === 1 ? "" : "s"}`;
 }
 function reportElementLine(element, depth) {
 	const parts = [element.tag];
@@ -1017,7 +1017,7 @@ function resolveQuerySql(pkg, options) {
 	const saved = inventory.queries.find((candidate) => candidate.name === queryName);
 	if (saved === void 0) {
 		const available = inventory.queries.map((candidate) => candidate.name);
-		return { errorMessage: `this .odb declares no saved query named '${queryName}'${available.length === 0 ? "" : ` -- available: ${available.join(", ")}`}` };
+		return { errorMessage: `this .odb declares no saved query named '${queryName}'${available.length === 0 ? "" : ` — available: ${available.join(", ")}`}` };
 	}
 	return { sql: saved.command };
 }
@@ -1184,7 +1184,7 @@ function registerOdbToCsvCommand(program) {
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
-	command.option("--table <name>", "the table to export -- required when the .odb declares more than one table");
+	command.option("--table <name>", "the table to export — required when the .odb declares more than one table");
 	command.action(async (input, output, options) => {
 		process.exitCode = await runOdbToCsv(input, output, options);
 	});
@@ -1205,19 +1205,19 @@ function registerOdbReportsCommand(program) {
 	});
 }
 function registerOdbQueryCommand(program) {
-	program.command("odb-query <input>").description("run a bounded SELECT over an embedded .odb database's own extracted tables, given directly or by naming one of its saved queries").option("--sql <text>", "the SELECT statement to run -- mutually exclusive with --query").option("--query <savedName>", "the name of one of the .odb's own saved queries to run -- mutually exclusive with --sql").option("--json", "emit the result set as JSON ({ columns, rows }) instead of a plain-text table", false).action(async (input, options) => {
+	program.command("odb-query <input>").description("run a bounded SELECT over an embedded .odb database's own extracted tables, given directly or by naming one of its saved queries").option("--sql <text>", "the SELECT statement to run — mutually exclusive with --query").option("--query <savedName>", "the name of one of the .odb's own saved queries to run — mutually exclusive with --sql").option("--json", "emit the result set as JSON ({ columns, rows }) instead of a plain-text table", false).action(async (input, options) => {
 		process.exitCode = await runOdbQuery(input, options);
 	});
 }
 function registerOdbRenderReportCommand(program) {
-	const command = program.command("odb-render-report <input> [output]").description("render one of an .odb's own reports -- its query resolved, its rpt: formulas evaluated, its bands laid out -- to docx, odt, or pdf");
+	const command = program.command("odb-render-report <input> [output]").description("render one of an .odb's own reports — its query resolved, its rpt: formulas evaluated, its bands laid out — to docx, odt, or pdf");
 	addOutOption(command);
 	addTimeoutOption(command);
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
 	addFontOptions(command);
-	command.option("--report <name>", "the report to render -- required only when the .odb declares more than one report");
+	command.option("--report <name>", "the report to render — required only when the .odb declares more than one report");
 	command.option("--to <format>", "target format when it cannot be inferred from the output path (docx, odt, pdf)");
 	command.action(async (input, output, options) => {
 		process.exitCode = await runOdbRenderReport(input, output, options);
@@ -1388,7 +1388,7 @@ async function runOutline(input, options) {
 	}
 }
 function registerOutlineCommand(program) {
-	const command = program.command("outline <input>").description(`print a document's outline -- headings, list items, and slide/sheet/page groups as indented text (${KNOWN_DOCUMENT_FORMATS})`);
+	const command = program.command("outline <input>").description(`print a document's outline — headings, list items, and slide/sheet/page groups as indented text (${KNOWN_DOCUMENT_FORMATS})`);
 	addTimeoutOption(command);
 	command.option("--json", "emit the outline tree as JSON instead of indented text (diagnostics as NDJSON on stderr)", false);
 	addQuietOption(command);
@@ -1522,12 +1522,12 @@ 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", [
 		"",
 		"Three write paths: a pdf source/target patches the metadata directly on the parsed PDF (writePdf), and a docx source/target",
-		"patches docProps/core.xml directly on the decoded package -- both with no layout engine or ContentDocument rebuild involved",
-		"at all, so everything else on the page (pdf) or in the package (docx -- comments, footnotes, headers/footers, numbering",
+		"patches docProps/core.xml directly on the decoded package — both with no layout engine or ContentDocument rebuild involved",
+		"at all, so everything else on the page (pdf) or in the package (docx — comments, footnotes, headers/footers, numbering",
 		"definitions included) survives byte-faithful. Every other supported format (pptx, xlsx, odt, odp, ods, odg, markdown, rtf)",
 		"rebuilds a fresh package from that format's own ContentDocument instead.",
 		"",
-		"set-metadata does not convert format -- source and target must match. Run convert/from-package first, then",
+		"set-metadata does not convert format — source and target must match. Run convert/from-package first, then",
 		"set-metadata on the result, if you need a different target format."
 	].join("\n"));
 	addOutOption(command);
@@ -1546,7 +1546,7 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "5.11.51";
+var version = "5.12.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {

package/dist/index.js

@@ -272,7 +272,7 @@ function resolveTargetFormat(output, out, to) {
 		return { format: to };
 	}
 	const destination = output ?? out;
-	if (destination === void 0) return { errorMessage: "cannot infer a target format -- pass an output path with a recognised extension, --out with one, or --to <format>" };
+	if (destination === void 0) return { errorMessage: "cannot infer a target format — pass an output path with a recognised extension, --out with one, or --to <format>" };
 	const inferred = inferFormatFromExtension(destination);
 	if (inferred === void 0) return { errorMessage: `cannot infer a target format from '${destination}'; pass --to <format> instead` };
 	return { format: inferred };
@@ -405,11 +405,11 @@ function toConversionCommandOptions(options) {
 async function runGenericConvert(input, output, options) {
 	const extension = extname(input).toLowerCase();
 	if (extension === ".odm") {
-		process.stderr.write("convert: '.odm' master documents are not supported by the generic convert command -- use 'odm-to-pdf' instead\n");
+		process.stderr.write("convert: '.odm' master documents are not supported by the generic convert command — use 'odm-to-pdf' instead\n");
 		return 2;
 	}
 	if (extension === ".odb") {
-		process.stderr.write("convert: '.odb' embedded databases are not supported by the generic convert command -- use 'odb-to-csv', 'odb-to-xlsx', or 'odb-tables' instead\n");
+		process.stderr.write("convert: '.odb' embedded databases are not supported by the generic convert command — use 'odb-to-csv', 'odb-to-xlsx', or 'odb-tables' instead\n");
 		return 2;
 	}
 	const source = inferFormatFromExtension(input);
@@ -536,7 +536,7 @@ async function runDocxExtras(input, options) {
 	}
 }
 function registerDocxExtrasCommand(program) {
-	program.command("docx-extras <input>").description("print a docx's own comments, footnotes, headers, footers, and numbering definitions -- data readDocxContent's ContentDocument cannot carry").option("--json", "emit the raw DocxExtras object as JSON instead of a human-readable report", false).action(async (input, options) => {
+	program.command("docx-extras <input>").description("print a docx's own comments, footnotes, headers, footers, and numbering definitions — data readDocxContent's ContentDocument cannot carry").option("--json", "emit the raw DocxExtras object as JSON instead of a human-readable report", false).action(async (input, options) => {
 		process.exitCode = await runDocxExtras(input, options);
 	});
 }
@@ -568,7 +568,7 @@ async function runFonts(input, options) {
 		}
 		for (const face of summaries) {
 			const style = [face.bold ? "bold" : void 0, face.italic ? "italic" : void 0].filter((value) => value !== void 0).join(" ");
-			process.stdout.write(`${face.family}${style === "" ? "" : ` (${style})`} -- ${face.byteLength} bytes\n`);
+			process.stdout.write(`${face.family}${style === "" ? "" : ` (${style})`} — ${face.byteLength} bytes\n`);
 		}
 		return 0;
 	} catch (error) {
@@ -633,7 +633,7 @@ async function runFromPackage(input, output, options) {
 		}
 		const result = documentFromJson(parsed);
 		if (result.kind !== "DocumentTree") {
-			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentTree -- only a file written by --dump-package can be read back by this command\n`);
+			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentTree — only a file written by --dump-package can be read back by this command\n`);
 			return 2;
 		}
 		const content = flattenTree(result.value);
@@ -654,19 +654,19 @@ async function runFromPackage(input, output, options) {
 		return 0;
 	} catch (error) {
 		if (error instanceof UnrecognizedDocumentSchemaError) {
-			process.stderr.write(`[${command}] '${input}' has no recognised $schema -- only a file written by --dump-package can be read back by this command\n`);
+			process.stderr.write(`[${command}] '${input}' has no recognised $schema — only a file written by --dump-package can be read back by this command\n`);
 			return 1;
 		}
 		if (isSchemaVersionMismatchError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a DocumentTree dump from document-schema.js@${error.dumpVersion}, but this CLI's documents.js reads only @${error.installedVersion}-major dumps -- 4.0.0 replaced the flat { formatVersion, content, pages } shape with the tree-form DocumentTree (ExaDev/document-schema.js#20); re-run the source conversion with --dump-package to write a current dump\n`);
+			process.stderr.write(`[${command}] '${input}' is a DocumentTree dump from document-schema.js@${error.dumpVersion}, but this CLI's documents.js reads only @${error.installedVersion}-major dumps — 4.0.0 replaced the flat { formatVersion, content, pages } shape with the tree-form DocumentTree (ExaDev/document-schema.js#20); re-run the source conversion with --dump-package to write a current dump\n`);
 			return 1;
 		}
 		if (isLayoutSchemaDemotedError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a LayoutDocument dump -- LayoutDocument moved to pdf-codec in document-schema.js 4.0.0 and is no longer a schema-stamped input; re-run the source conversion with --dump-package and read that package back instead\n`);
+			process.stderr.write(`[${command}] '${input}' is a LayoutDocument dump — LayoutDocument moved to pdf-codec in document-schema.js 4.0.0 and is no longer a schema-stamped input; re-run the source conversion with --dump-package and read that package back instead\n`);
 			return 1;
 		}
 		if (isDocumentPackageRenamedError(error)) {
-			process.stderr.write(`[${command}] '${input}' is a document-package dump -- DocumentPackage was renamed to DocumentTree in document-schema.js 5.0.0 (ExaDev/documents.js#661); re-run the source conversion with --dump-package to write a current tree-form DocumentTree dump\n`);
+			process.stderr.write(`[${command}] '${input}' is a document-package dump — DocumentPackage was renamed to DocumentTree in document-schema.js 5.0.0 (ExaDev/documents.js#661); re-run the source conversion with --dump-package to write a current tree-form DocumentTree dump\n`);
 			return 1;
 		}
 		process.stderr.write(`${formatError(error, options.verbose)}\n`);
@@ -774,7 +774,7 @@ function countOdbFormDefinitionBoundControls(definition) {
 function describeOdbForm(form) {
 	const controlCount = form.forms.reduce((total, definition) => total + countOdbFormDefinitionControls(definition), 0);
 	const boundCount = form.forms.reduce((total, definition) => total + countOdbFormDefinitionBoundControls(definition), 0);
-	return `${form.name} [${form.href}] -- ${form.forms.length} form${form.forms.length === 1 ? "" : "s"}, ${controlCount} control${controlCount === 1 ? "" : "s"} (${boundCount} bound)`;
+	return `${form.name} [${form.href}] — ${form.forms.length} form${form.forms.length === 1 ? "" : "s"}, ${controlCount} control${controlCount === 1 ? "" : "s"} (${boundCount} bound)`;
 }
 function formControlLines(control, depth) {
 	const parts = [control.tag];
@@ -824,7 +824,7 @@ function describeOdbReport(report) {
 	const groupCount = countReportGroups(report.groups);
 	const elementCount = countReportBandElements(report.reportHeader) + countReportBandElements(report.pageHeader) + countReportBandElements(report.detail) + countReportBandElements(report.pageFooter) + countReportBandElements(report.reportFooter) + report.groups.reduce((total, group) => total + countReportGroupElements(group), 0);
 	const source = dataSource === void 0 ? "no data source" : `on ${dataSource}`;
-	return `${report.name} [${report.href}] -- ${source}, ${groupCount} group${groupCount === 1 ? "" : "s"}, ${elementCount} element${elementCount === 1 ? "" : "s"}`;
+	return `${report.name} [${report.href}] — ${source}, ${groupCount} group${groupCount === 1 ? "" : "s"}, ${elementCount} element${elementCount === 1 ? "" : "s"}`;
 }
 function reportElementLine(element, depth) {
 	const parts = [element.tag];
@@ -1016,7 +1016,7 @@ function resolveQuerySql(pkg, options) {
 	const saved = inventory.queries.find((candidate) => candidate.name === queryName);
 	if (saved === void 0) {
 		const available = inventory.queries.map((candidate) => candidate.name);
-		return { errorMessage: `this .odb declares no saved query named '${queryName}'${available.length === 0 ? "" : ` -- available: ${available.join(", ")}`}` };
+		return { errorMessage: `this .odb declares no saved query named '${queryName}'${available.length === 0 ? "" : ` — available: ${available.join(", ")}`}` };
 	}
 	return { sql: saved.command };
 }
@@ -1183,7 +1183,7 @@ function registerOdbToCsvCommand(program) {
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
-	command.option("--table <name>", "the table to export -- required when the .odb declares more than one table");
+	command.option("--table <name>", "the table to export — required when the .odb declares more than one table");
 	command.action(async (input, output, options) => {
 		process.exitCode = await runOdbToCsv(input, output, options);
 	});
@@ -1204,19 +1204,19 @@ function registerOdbReportsCommand(program) {
 	});
 }
 function registerOdbQueryCommand(program) {
-	program.command("odb-query <input>").description("run a bounded SELECT over an embedded .odb database's own extracted tables, given directly or by naming one of its saved queries").option("--sql <text>", "the SELECT statement to run -- mutually exclusive with --query").option("--query <savedName>", "the name of one of the .odb's own saved queries to run -- mutually exclusive with --sql").option("--json", "emit the result set as JSON ({ columns, rows }) instead of a plain-text table", false).action(async (input, options) => {
+	program.command("odb-query <input>").description("run a bounded SELECT over an embedded .odb database's own extracted tables, given directly or by naming one of its saved queries").option("--sql <text>", "the SELECT statement to run — mutually exclusive with --query").option("--query <savedName>", "the name of one of the .odb's own saved queries to run — mutually exclusive with --sql").option("--json", "emit the result set as JSON ({ columns, rows }) instead of a plain-text table", false).action(async (input, options) => {
 		process.exitCode = await runOdbQuery(input, options);
 	});
 }
 function registerOdbRenderReportCommand(program) {
-	const command = program.command("odb-render-report <input> [output]").description("render one of an .odb's own reports -- its query resolved, its rpt: formulas evaluated, its bands laid out -- to docx, odt, or pdf");
+	const command = program.command("odb-render-report <input> [output]").description("render one of an .odb's own reports — its query resolved, its rpt: formulas evaluated, its bands laid out — to docx, odt, or pdf");
 	addOutOption(command);
 	addTimeoutOption(command);
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
 	addFontOptions(command);
-	command.option("--report <name>", "the report to render -- required only when the .odb declares more than one report");
+	command.option("--report <name>", "the report to render — required only when the .odb declares more than one report");
 	command.option("--to <format>", "target format when it cannot be inferred from the output path (docx, odt, pdf)");
 	command.action(async (input, output, options) => {
 		process.exitCode = await runOdbRenderReport(input, output, options);
@@ -1387,7 +1387,7 @@ async function runOutline(input, options) {
 	}
 }
 function registerOutlineCommand(program) {
-	const command = program.command("outline <input>").description(`print a document's outline -- headings, list items, and slide/sheet/page groups as indented text (${KNOWN_DOCUMENT_FORMATS})`);
+	const command = program.command("outline <input>").description(`print a document's outline — headings, list items, and slide/sheet/page groups as indented text (${KNOWN_DOCUMENT_FORMATS})`);
 	addTimeoutOption(command);
 	command.option("--json", "emit the outline tree as JSON instead of indented text (diagnostics as NDJSON on stderr)", false);
 	addQuietOption(command);
@@ -1521,12 +1521,12 @@ 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", [
 		"",
 		"Three write paths: a pdf source/target patches the metadata directly on the parsed PDF (writePdf), and a docx source/target",
-		"patches docProps/core.xml directly on the decoded package -- both with no layout engine or ContentDocument rebuild involved",
-		"at all, so everything else on the page (pdf) or in the package (docx -- comments, footnotes, headers/footers, numbering",
+		"patches docProps/core.xml directly on the decoded package — both with no layout engine or ContentDocument rebuild involved",
+		"at all, so everything else on the page (pdf) or in the package (docx — comments, footnotes, headers/footers, numbering",
 		"definitions included) survives byte-faithful. Every other supported format (pptx, xlsx, odt, odp, ods, odg, markdown, rtf)",
 		"rebuilds a fresh package from that format's own ContentDocument instead.",
 		"",
-		"set-metadata does not convert format -- source and target must match. Run convert/from-package first, then",
+		"set-metadata does not convert format — source and target must match. Run convert/from-package first, then",
 		"set-metadata on the result, if you need a different target format."
 	].join("\n"));
 	addOutOption(command);
@@ -1545,7 +1545,7 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "5.11.51";
+var version = "5.12.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {

package/dist/{odb-structure-yc8OHoC0.js → odb-structure-Crz3Yzzb.js}

@@ -240,7 +240,7 @@ function countOdbFormDefinitionBoundControls(definition) {
 function describeOdbForm(form) {
 	const controlCount = form.forms.reduce((total, definition) => total + countOdbFormDefinitionControls(definition), 0);
 	const boundCount = form.forms.reduce((total, definition) => total + countOdbFormDefinitionBoundControls(definition), 0);
-	return `${form.name} [${form.href}] -- ${form.forms.length} form${form.forms.length === 1 ? "" : "s"}, ${controlCount} control${controlCount === 1 ? "" : "s"} (${boundCount} bound)`;
+	return `${form.name} [${form.href}] — ${form.forms.length} form${form.forms.length === 1 ? "" : "s"}, ${controlCount} control${controlCount === 1 ? "" : "s"} (${boundCount} bound)`;
 }
 function formControlLines(control, depth) {
 	const parts = [control.tag];
@@ -290,7 +290,7 @@ function describeOdbReport(report) {
 	const groupCount = countReportGroups(report.groups);
 	const elementCount = countReportBandElements(report.reportHeader) + countReportBandElements(report.pageHeader) + countReportBandElements(report.detail) + countReportBandElements(report.pageFooter) + countReportBandElements(report.reportFooter) + report.groups.reduce((total, group) => total + countReportGroupElements(group), 0);
 	const source = dataSource === void 0 ? "no data source" : `on ${dataSource}`;
-	return `${report.name} [${report.href}] -- ${source}, ${groupCount} group${groupCount === 1 ? "" : "s"}, ${elementCount} element${elementCount === 1 ? "" : "s"}`;
+	return `${report.name} [${report.href}] — ${source}, ${groupCount} group${groupCount === 1 ? "" : "s"}, ${elementCount} element${elementCount === 1 ? "" : "s"}`;
 }
 function reportElementLine(element, depth) {
 	const parts = [element.tag];

package/dist/{tui-CogHEvyJ.js → tui-y8MLtP8W.js}

@@ -1,4 +1,4 @@
-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-yc8OHoC0.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-Crz3Yzzb.js";
 import { readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join } from "node:path";
 import { bytesToBase64, cellReference, columnIndexToLetters, convertDocument, createDoc, createDocx, createMarkdownEditor, createOdg, createOdp, createOds, createOdt, createPdf, createPpt, createPptx, createXls, csvToPdf, decodeMarkdownText, decodeOdbPackage, docToPdf, docxToPdf, encodeMarkdownText, epubToPdf, hsqldbCellDisplayText, markdownToPdf, odbReportToDocx, odbReportToOdt, odbReportToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDoc, openDocx, openMarkdown, openOdg, openOdp, openOds, openOdt, openPdf, openPpt, openPptx, openXls, parseXml, pptToPdf, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, rtfToPdf, svgToPdf, xlsToPdf, xlsxToPdf } from "documents.js";
@@ -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 has no export-to-PDF path -- ${openDocument.format === "pdf" ? "save it directly instead" : "it is a read-only source with nothing to convert"}`);
+	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.editor.toMarkdownText()), pdfOptions);
@@ -950,7 +950,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" || action.doc.format === "rtf" || action.doc.format === "wpd" || action.doc.format === "doc" || action.doc.format === "xls" || action.doc.format === "ppt" || action.doc.format === "epub" ? `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" || action.doc.format === "wpd" || action.doc.format === "doc" || action.doc.format === "xls" || action.doc.format === "ppt" || action.doc.format === "epub" ? `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: {
@@ -1057,7 +1057,7 @@ function appReducer(state, action) {
 				}
 				table.mergeCells(action.merge.startRow, action.merge.startColumn, action.merge.rowSpan, action.merge.colSpan);
 			});
-			return merge.unsupported ? withStatus(nextState, "warning", "Markdown tables do not support merged cells -- the table was created without merging") : nextState;
+			return merge.unsupported ? withStatus(nextState, "warning", "Markdown tables do not support merged cells — the table was created without merging") : nextState;
 		}
 		case "MERGE_TABLE_CELLS": {
 			const doc = wordprocessingDocument(state);
@@ -2279,7 +2279,7 @@ function StatusLine() {
 				" ",
 				"⚠ ",
 				state.diagnostics.length,
-				" diagnostics -- Ctrl+D"
+				" diagnostics — Ctrl+D"
 			]
 		}) : void 0
 	] });
@@ -2294,7 +2294,7 @@ function requireFieldValue(values, key) {
 function FieldWizard(props) {
 	const [stepIndex, setStepIndex] = useState(0);
 	const field = props.fields[stepIndex];
-	if (field === void 0) throw new Error(`FieldWizard stepIndex ${stepIndex} is out of range for ${props.fields.length} fields -- onComplete always fires before stepIndex can advance past the last field, so this indicates a bug in that advance.`);
+	if (field === void 0) throw new Error(`FieldWizard stepIndex ${stepIndex} is out of range for ${props.fields.length} fields — onComplete always fires before stepIndex can advance past the last field, so this indicates a bug in that advance.`);
 	const [collected, setCollected] = useState({});
 	const [draft, setDraft] = useState(field.defaultValue);
 	return /* @__PURE__ */ jsxs(Box, {
@@ -2334,7 +2334,7 @@ function FieldWizard(props) {
 					stepIndex + 1,
 					" of ",
 					props.fields.length,
-					" -- Enter to continue, Esc to cancel"
+					" — Enter to continue, Esc to cancel"
 				]
 			})
 		]
@@ -2481,7 +2481,7 @@ function FormulaPicker(props) {
 		children: [
 			/* @__PURE__ */ jsx(Text, {
 				bold: true,
-				children: "Insert formula -- choose a preset or write raw MathML"
+				children: "Insert formula — choose a preset or write raw MathML"
 			}),
 			/* @__PURE__ */ jsx(ListView, {
 				items: PICKER_ROWS,
@@ -2819,7 +2819,7 @@ function ParagraphFamilyBodyList(props) {
 			/* @__PURE__ */ jsx(ListView, {
 				items: rows,
 				selectedIndex: listSelectedIndex,
-				emptyMessage: "No paragraphs or tables yet -- press 'a' to append a paragraph.",
+				emptyMessage: "No paragraphs or tables yet — press 'a' to append a paragraph.",
 				renderItem: (row, isSelected) => {
 					if (row.kind === "header") return /* @__PURE__ */ jsx(Text, {
 						bold: true,
@@ -3022,7 +3022,7 @@ async function applyInsertImage(blockIndex, values, dispatch) {
 		dispatch({
 			type: "SET_STATUS",
 			severity: "warning",
-			text: `${path} is not a .png or .jpg/.jpeg file -- image not inserted`
+			text: `${path} is not a .png or .jpg/.jpeg file — image not inserted`
 		});
 		return;
 	}
@@ -3051,7 +3051,7 @@ async function applyInsertImage(blockIndex, values, dispatch) {
 function ParagraphRunsView(props) {
 	if (props.runs.length === 0) return /* @__PURE__ */ jsx(Text, {
 		dimColor: true,
-		children: "(no runs -- press 'a' to append one)"
+		children: "(no runs — press 'a' to append one)"
 	});
 	return /* @__PURE__ */ jsx(Box, { children: props.runs.map((run, index) => {
 		const styled = supportsRunStyleExtras(run);
@@ -4072,7 +4072,7 @@ function isReportRenderTargetFormat(format) {
 }
 async function renderOdbReportTo(doc, destinationPath, options) {
 	const format = detectFormat(destinationPath);
-	if (!isReportRenderTargetFormat(format)) throw new Error(`Cannot tell whether to render "${options.reportName}" as docx, odt, or pdf from '${destinationPath}' -- give the destination one of those three extensions`);
+	if (!isReportRenderTargetFormat(format)) throw new Error(`Cannot tell whether to render "${options.reportName}" as docx, odt, or pdf from '${destinationPath}' — give the destination one of those three extensions`);
 	const fonts = await loadProvidedFonts(options.fontFiles ?? [], { signal: options.signal });
 	const pkg = decodeOdbPackage(new Uint8Array(await readFile(doc.path)));
 	const content = readOdbReportContent(pkg, { report: options.reportName });
@@ -4161,7 +4161,7 @@ function OdbReportRenderScreen() {
 			}), /* @__PURE__ */ jsx(TextField, {
 				value: fontFiles,
 				isFocused: isActive && field === "fonts",
-				placeholder: "optional .ttf/.otf paths, comma-separated -- pdf only",
+				placeholder: "optional .ttf/.otf paths, comma-separated — pdf only",
 				onChange: setFontFiles,
 				onSubmit: submit,
 				onCancel: cancel
@@ -4383,17 +4383,17 @@ function defaultTriangleSubpaths(widthPt, heightPt) {
 //#region src/tui/screens/editors/odg/shared.ts
 function requireOdgDocument(state) {
 	const doc = state.openDocument;
-	if (doc?.format !== "odg") throw new Error(`An odg screen rendered with the open document being ${doc === void 0 ? "no document" : `a '${doc.format}' document`} -- pageList/pageDetail/shapeOrVectorDetail only ever get pushed from odg-routed navigation (rootScreenForFormat maps 'odg' to 'pageList', and every deeper push originates from that screen or its own descendants), so this indicates a routing bug elsewhere, not a state this screen should render around.`);
+	if (doc?.format !== "odg") throw new Error(`An odg screen rendered with the open document being ${doc === void 0 ? "no document" : `a '${doc.format}' document`} — pageList/pageDetail/shapeOrVectorDetail only ever get pushed from odg-routed navigation (rootScreenForFormat maps 'odg' to 'pageList', and every deeper push originates from that screen or its own descendants), so this indicates a routing bug elsewhere, not a state this screen should render around.`);
 	return doc;
 }
 function requirePageDetailScreen(state) {
 	const screen = currentScreen(state);
-	if (screen.kind !== "pageDetail") throw new Error(`OdgPageDetailScreen rendered while the top of the stack is '${screen.kind}', not 'pageDetail' -- app.tsx's ScreenBody switch only mounts this component for that screen kind, so this cannot happen without a routing bug.`);
+	if (screen.kind !== "pageDetail") throw new Error(`OdgPageDetailScreen rendered while the top of the stack is '${screen.kind}', not 'pageDetail' — app.tsx's ScreenBody switch only mounts this component for that screen kind, so this cannot happen without a routing bug.`);
 	return screen;
 }
 function requireShapeOrVectorDetailScreen(state) {
 	const screen = currentScreen(state);
-	if (screen.kind !== "shapeOrVectorDetail") throw new Error(`OdgShapeOrVectorDetailScreen rendered while the top of the stack is '${screen.kind}', not 'shapeOrVectorDetail' -- app.tsx's ScreenBody switch only mounts this component for that screen kind, so this cannot happen without a routing bug.`);
+	if (screen.kind !== "shapeOrVectorDetail") throw new Error(`OdgShapeOrVectorDetailScreen rendered while the top of the stack is '${screen.kind}', not 'shapeOrVectorDetail' — app.tsx's ScreenBody switch only mounts this component for that screen kind, so this cannot happen without a routing bug.`);
 	return screen;
 }
 function vectorsParityMatch(liveVectors, contentVectors) {
@@ -4404,9 +4404,9 @@ function buildPageItems(doc, pageIndex) {
 	const page = doc.editor.pages()[pageIndex];
 	if (page === void 0) return [];
 	const content = readOdgContent(doc.editor.toPackage());
-	if (content.kind !== "drawing") throw new Error(`readOdgContent(doc.editor.toPackage()) returned a '${content.kind}' ContentDocument for an odg-format open document -- an odg package should always read back as the 'drawing' variant, so this indicates a real inconsistency in documents.js's own reader, not a state this screen should paper over.`);
+	if (content.kind !== "drawing") throw new Error(`readOdgContent(doc.editor.toPackage()) returned a '${content.kind}' ContentDocument for an odg-format open document — an odg package should always read back as the 'drawing' variant, so this indicates a real inconsistency in documents.js's own reader, not a state this screen should paper over.`);
 	const contentPage = content.pages[pageIndex];
-	if (contentPage === void 0) throw new Error(`readOdgContent found no page at index ${pageIndex}, but doc.editor.pages() has a page there -- the two read the same live package, so they should always agree on page count.`);
+	if (contentPage === void 0) throw new Error(`readOdgContent found no page at index ${pageIndex}, but doc.editor.pages() has a page there — the two read the same live package, so they should always agree on page count.`);
 	const liveVectors = page.vectors();
 	const parityOk = vectorsParityMatch(liveVectors, contentPage.vectors);
 	const vectorItems = contentPage.vectors.map((vector, index) => ({
@@ -4494,7 +4494,7 @@ function OdgPageListScreen() {
 		}), /* @__PURE__ */ jsx(ListView, {
 			items: pageIndices,
 			selectedIndex,
-			emptyMessage: "No pages yet -- press 'a' to add one",
+			emptyMessage: "No pages yet — press 'a' to add one",
 			renderItem: (pageIndex, isSelected) => {
 				const page = pages[pageIndex];
 				const shapeCount = page === void 0 ? 0 : page.shapes().length;
@@ -4639,7 +4639,7 @@ function warnVectorIsViewOnly(dispatch, label) {
 	dispatch({
 		type: "SET_STATUS",
 		severity: "info",
-		text: `${label} added -- but this page also has a vector element documents.js's OdgPage.vectors() cannot wrap, so every vector on it (including this one) shows read-only in this list rather than risk pairing the wrong live handle to the wrong row.`
+		text: `${label} added — but this page also has a vector element documents.js's OdgPage.vectors() cannot wrap, so every vector on it (including this one) shows read-only in this list rather than risk pairing the wrong live handle to the wrong row.`
 	});
 }
 function warnIfVectorAddedReadOnly(doc, pageIndex, dispatch, label) {
@@ -4733,7 +4733,7 @@ async function applyAddKind$1(kind, pageIndex, doc, values, dispatch) {
 				dispatch({
 					type: "SET_STATUS",
 					severity: "warning",
-					text: `${path} is not a .png or .jpg/.jpeg file -- image not added`
+					text: `${path} is not a .png or .jpg/.jpeg file — image not added`
 				});
 				return;
 			}
@@ -4778,7 +4778,7 @@ function AddItemFlow$1(props) {
 		paddingX: 1,
 		children: [/* @__PURE__ */ jsx(Text, {
 			bold: true,
-			children: "Add item -- choose a kind"
+			children: "Add item — choose a kind"
 		}), /* @__PURE__ */ jsx(ListView, {
 			items: ADD_KIND_OPTIONS$1,
 			selectedIndex,
@@ -4863,7 +4863,7 @@ function OdgPageDetailScreen() {
 			children: [
 				"Page ",
 				pageIndex + 1,
-				" -- ",
+				" — ",
 				items.length,
 				" item",
 				items.length === 1 ? "" : "s"
@@ -4871,7 +4871,7 @@ function OdgPageDetailScreen() {
 		}), /* @__PURE__ */ jsx(ListView, {
 			items: rows,
 			selectedIndex,
-			emptyMessage: "No items yet -- press 'a' to add one",
+			emptyMessage: "No items yet — press 'a' to add one",
 			renderItem: (row, isSelected) => /* @__PURE__ */ jsxs(Text, {
 				color: selectedColor(isSelected),
 				children: [isSelected ? "> " : "  ", describeItem(row.item)]
@@ -4903,7 +4903,7 @@ function buildVectorRows(vector, liveVector, dispatch) {
 				dispatch({
 					type: "SET_STATUS",
 					severity: "warning",
-					text: "A vector stroke cannot be cleared to none through this editor -- enter \"r g b widthPt\" (0-1 colour, pt width) instead"
+					text: "A vector stroke cannot be cleared to none through this editor — enter \"r g b widthPt\" (0-1 colour, pt width) instead"
 				});
 				return;
 			}
@@ -4946,7 +4946,7 @@ function VectorDetail(props) {
 			/* @__PURE__ */ jsx(Text, { children: describeFillStroke(vector) }),
 			/* @__PURE__ */ jsx(Text, {
 				color: "yellow",
-				children: "This page's live vectors (documents.js's `OdgPage.vectors()`) don't line up one-to-one with what odf.js's own reader found here -- likely a `draw:circle`/`polygon`/`polyline`/`custom-shape` element the live accessor has no wrapper for, sitting alongside a plain rect/ellipse/line/path it does. Rather than risk pairing the wrong live handle to this row, every vector on this page is shown read-only until that mismatch is resolved outside this TUI. Open the file in a real ODF editor to change it."
+				children: "This page's live vectors (documents.js's `OdgPage.vectors()`) don't line up one-to-one with what odf.js's own reader found here — likely a `draw:circle`/`polygon`/`polyline`/`custom-shape` element the live accessor has no wrapper for, sitting alongside a plain rect/ellipse/line/path it does. Rather than risk pairing the wrong live handle to this row, every vector on this page is shown read-only until that mismatch is resolved outside this TUI. Open the file in a real ODF editor to change it."
 			}),
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
@@ -4956,7 +4956,7 @@ function VectorDetail(props) {
 	});
 	if (editingField !== void 0) {
 		const row = rows[editingField];
-		if (row === void 0) throw new Error(`VectorDetail is editing field index ${editingField}, but there are only ${rows.length} rows -- selecting a row always sets editingField to a valid index from that same rows array, so this indicates a bug in that selection.`);
+		if (row === void 0) throw new Error(`VectorDetail is editing field index ${editingField}, but there are only ${rows.length} rows — selecting a row always sets editingField to a valid index from that same rows array, so this indicates a bug in that selection.`);
 		return /* @__PURE__ */ jsxs(Box, {
 			flexDirection: "column",
 			borderStyle: "round",
@@ -5115,7 +5115,7 @@ function ShapeDetail(props) {
 	});
 	if (editingField !== void 0) {
 		const row = rows[editingField];
-		if (row === void 0) throw new Error(`ShapeDetail 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.`);
+		if (row === void 0) throw new Error(`ShapeDetail 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",
@@ -5228,7 +5228,7 @@ function assertPresentationDocument(doc) {
 	return doc;
 }
 function assertRichPresentationDocument(doc) {
-	if (doc === void 0 || doc.format !== "pptx" && doc.format !== "odp") throw new Error("Expected an open pptx or odp document here; the screen router in app.tsx should only reach this rich slide-family screen for one of those formats -- a ppt document routes to its own narrower detail screen.");
+	if (doc === void 0 || doc.format !== "pptx" && doc.format !== "odp") throw new Error("Expected an open pptx or odp document here; the screen router in app.tsx should only reach this rich slide-family screen for one of those formats — a ppt document routes to its own narrower detail screen.");
 	return doc;
 }
 const DEFAULT_FRAME_MARGIN_FRACTION = .1;
@@ -5321,7 +5321,7 @@ function SlideFamilySlideList(props) {
 			/* @__PURE__ */ jsx(ListView, {
 				items: rows,
 				selectedIndex,
-				emptyMessage: "No slides yet -- press 'a' to add one",
+				emptyMessage: "No slides yet — press 'a' to add one",
 				renderItem: (row, isSelected) => /* @__PURE__ */ jsx(SlideRowView, {
 					row,
 					isSelected
@@ -5581,7 +5581,7 @@ function ShapeEditorScreen(props) {
 			]
 		}), /* @__PURE__ */ jsx(Text, {
 			color: "yellow",
-			children: "This shape no longer exists -- press Esc to go back"
+			children: "This shape no longer exists — press Esc to go back"
 		})]
 	});
 	return /* @__PURE__ */ jsxs(Box, {
@@ -5847,7 +5847,7 @@ function imageFormatFromPath(path) {
 }
 async function readImageForShape(path) {
 	const format = imageFormatFromPath(path);
-	if (format === void 0) throw new Error(`${path} does not look like a .png or .jpg/.jpeg file -- ADD_IMAGE only accepts those two formats`);
+	if (format === void 0) throw new Error(`${path} does not look like a .png or .jpg/.jpeg file — ADD_IMAGE only accepts those two formats`);
 	return {
 		format,
 		bytes: new Uint8Array(await readFile(path))
@@ -6028,7 +6028,7 @@ function SlideDetailScreen(props) {
 				children: [
 					"Slide ",
 					slideIndex + 1,
-					" -- ",
+					" — ",
 					shapes.length,
 					" shape",
 					shapes.length === 1 ? "" : "s"
@@ -6036,11 +6036,11 @@ function SlideDetailScreen(props) {
 			}),
 			slide === void 0 ? /* @__PURE__ */ jsx(Text, {
 				color: "yellow",
-				children: "This slide no longer exists -- press Esc to go back"
+				children: "This slide no longer exists — press Esc to go back"
 			}) : /* @__PURE__ */ jsx(ListView, {
 				items: rows,
 				selectedIndex: listSelectedIndex,
-				emptyMessage: "No shapes yet -- press 'a' to add one",
+				emptyMessage: "No shapes yet — press 'a' to add one",
 				renderItem: (row, isSelected) => {
 					if (row.kind === "tablesHeader") return /* @__PURE__ */ jsxs(Text, {
 						bold: true,
@@ -6261,7 +6261,7 @@ function SlideTableDetailScreen(props) {
 			]
 		}), /* @__PURE__ */ jsx(Text, {
 			color: "yellow",
-			children: "This table no longer exists -- press Esc to go back"
+			children: "This table no longer exists — press Esc to go back"
 		})]
 	});
 	return /* @__PURE__ */ jsxs(Box, {
@@ -6342,7 +6342,7 @@ function NotesEditorScreen(props) {
 			]
 		}), /* @__PURE__ */ jsx(Text, {
 			color: "yellow",
-			children: "This slide no longer exists -- press Esc to go back"
+			children: "This slide no longer exists — press Esc to go back"
 		})]
 	});
 	return /* @__PURE__ */ jsxs(Box, {
@@ -6622,7 +6622,7 @@ function OdsSheetListScreen() {
 			/* @__PURE__ */ jsx(ListView, {
 				items: rows,
 				selectedIndex,
-				emptyMessage: "This workbook has no sheets yet -- press 'a' to add one.",
+				emptyMessage: "This workbook has no sheets yet — press 'a' to add one.",
 				renderItem: (row, isSelected) => /* @__PURE__ */ jsx(Text, {
 					color: selectedColor(isSelected),
 					inverse: isSelected,
@@ -6826,7 +6826,7 @@ function OdsPrintSettingsEditorScreen() {
 		children: [
 			/* @__PURE__ */ jsxs(Text, {
 				bold: true,
-				children: ["Print settings -- ", sheet.name]
+				children: ["Print settings — ", sheet.name]
 			}),
 			/* @__PURE__ */ jsx(ListView, {
 				items: FIELD_ROWS,
@@ -6913,7 +6913,7 @@ function OdsCellEditor(props) {
 							dispatch({
 								type: "SET_STATUS",
 								severity: "warning",
-								text: `"${text}" is not a valid ${kind} value -- Tab to change kind`
+								text: `"${text}" is not a valid ${kind} value — Tab to change kind`
 							});
 							return;
 						}
@@ -7003,7 +7003,7 @@ async function applyAddSheetImage(sheetIndex, anchorRow, anchorColumn, values, d
 		dispatch({
 			type: "SET_STATUS",
 			severity: "warning",
-			text: `${path} is not a .png or .jpg/.jpeg file -- image not added`
+			text: `${path} is not a .png or .jpg/.jpeg file — image not added`
 		});
 		return;
 	}
@@ -7228,7 +7228,7 @@ function OdsSpreadsheetGridScreen() {
 				items: filteredCompactRows,
 				selectedIndex: compactSelectedIndex,
 				reservedRows: GRID_CHROME_ROWS,
-				emptyMessage: "No populated cells yet -- press 't' to go back to the grid and start typing.",
+				emptyMessage: "No populated cells yet — press 't' to go back to the grid and start typing.",
 				renderItem: (row, isSelected) => /* @__PURE__ */ jsxs(Text, {
 					color: selectedColor(isSelected),
 					inverse: isSelected,
@@ -7586,7 +7586,7 @@ function XlsSheetListScreen() {
 			/* @__PURE__ */ jsx(ListView, {
 				items: rows,
 				selectedIndex,
-				emptyMessage: "This workbook has no sheets yet -- press 'a' to add one.",
+				emptyMessage: "This workbook has no sheets yet — press 'a' to add one.",
 				renderItem: (row, isSelected) => /* @__PURE__ */ jsx(Text, {
 					color: selectedColor(isSelected),
 					inverse: isSelected,
@@ -7698,9 +7698,9 @@ function XlsSpreadsheetGridScreen(props) {
 					bold: true,
 					children: [
 						sheet.name,
-						" -- non-empty cells (",
+						" — non-empty cells (",
 						entries.length,
-						") -- 't' back to grid"
+						") — 't' back to grid"
 					]
 				}),
 				entries.length === 0 ? /* @__PURE__ */ jsx(Text, {
@@ -7813,7 +7813,7 @@ function ListEditorScreen() {
 		} else if (input === "<") dispatch({
 			type: "SET_STATUS",
 			severity: "warning",
-			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"
+			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, {
@@ -7834,7 +7834,7 @@ function ListEditorScreen() {
 	});
 	if (editingIndex !== void 0) {
 		const item = items[editingIndex];
-		if (item === void 0) throw new Error(`ListEditorScreen is editing item index ${editingIndex}, but list ${screen.blockIndex} only has ${items.length} items -- selecting a row always sets editingIndex to a valid index from that same items array, so this indicates a bug in that selection.`);
+		if (item === void 0) throw new Error(`ListEditorScreen is editing item index ${editingIndex}, but list ${screen.blockIndex} only has ${items.length} items — selecting a row always sets editingIndex to a valid index from that same items array, so this indicates a bug in that selection.`);
 		return /* @__PURE__ */ jsxs(Box, {
 			flexDirection: "column",
 			children: [/* @__PURE__ */ jsxs(Text, {
@@ -7880,7 +7880,7 @@ function ListEditorScreen() {
 			/* @__PURE__ */ jsx(ListView, {
 				items: rows,
 				selectedIndex,
-				emptyMessage: "This list has no items yet -- press 'a' to add one.",
+				emptyMessage: "This list has no items yet — press 'a' to add one.",
 				renderItem: (row, isSelected) => {
 					const trimmed = row.item.text.trim();
 					return /* @__PURE__ */ jsxs(Text, {
@@ -8079,7 +8079,7 @@ function PdfPageListScreen() {
 				children: [
 					"Page ",
 					pageIndex + 1,
-					" -- ",
+					" — ",
 					pageSummaryText(page)
 				]
 			})
@@ -8623,7 +8623,7 @@ function buildRowsFor(item, pageIndex, itemIndex, dispatch, onReplaceImage) {
 }
 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)`;
+	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);
@@ -8631,7 +8631,7 @@ async function applyImageReplace(pageIndex, itemIndex, path, dispatch) {
 		dispatch({
 			type: "SET_STATUS",
 			severity: "warning",
-			text: `${path} is not a .png or .jpg/.jpeg file -- image not replaced`
+			text: `${path} is not a .png or .jpg/.jpeg file — image not replaced`
 		});
 		return;
 	}
@@ -8711,7 +8711,7 @@ function EditableItemDetail(props) {
 	});
 	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.`);
+		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",
@@ -8743,7 +8743,7 @@ function EditableItemDetail(props) {
 					pageIndex + 1,
 					", item ",
 					itemIndex + 1,
-					" -- ",
+					" — ",
 					item.kind
 				]
 			}),
@@ -9090,7 +9090,7 @@ async function applyAddKind(kind, pageIndex, values, dispatch) {
 				dispatch({
 					type: "SET_STATUS",
 					severity: "warning",
-					text: `${path} is not a .png or .jpg/.jpeg file -- image not added`
+					text: `${path} is not a .png or .jpg/.jpeg file — image not added`
 				});
 				return;
 			}
@@ -9147,7 +9147,7 @@ function AddItemFlow(props) {
 		paddingX: 1,
 		children: [/* @__PURE__ */ jsx(Text, {
 			bold: true,
-			children: "Add item -- choose a kind"
+			children: "Add item — choose a kind"
 		}), /* @__PURE__ */ jsx(ListView, {
 			items: ADD_KIND_OPTIONS,
 			selectedIndex,
@@ -9243,7 +9243,7 @@ function PdfPageItemsScreen() {
 			/* @__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}".`,
+				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: selectedColor(isSelected),
 					inverse: isSelected,
@@ -9251,7 +9251,7 @@ function PdfPageItemsScreen() {
 						itemIndex + 1,
 						". ",
 						item.kind,
-						" -- ",
+						" — ",
 						previewFor(item)
 					]
 				})
@@ -9543,7 +9543,7 @@ function FilePickerScreen() {
 				bold: true,
 				children: [
 					titleFor(purpose),
-					" -- ",
+					" — ",
 					currentDir
 				]
 			}),
@@ -9612,7 +9612,7 @@ function LauncherScreen() {
 			}),
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: "A terminal editor for docx, pptx, odt, odp, ods, odg, doc, xls, ppt, markdown, odb and pdf -- xlsx, csv, svg, rtf, wpd and epub open as read-only PDF previews."
+				children: "A terminal editor for docx, pptx, odt, odp, ods, odg, doc, xls, ppt, markdown, odb and pdf — xlsx, csv, svg, rtf, wpd and epub open as read-only PDF previews."
 			}),
 			/* @__PURE__ */ jsx(Text, { children: " " }),
 			/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
@@ -9802,7 +9802,7 @@ function metadataFor(doc) {
 		case "rtf":
 		case "wpd":
 		case "epub": 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.");
+		case "odb": throw new Error("A .odb database has no document-level metadata — it is a table/form/report container, not a single document with its own title/author/etc.");
 	}
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-cli",
-  "version": "5.11.51",
+  "version": "5.12.0",
   "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@12.4.1+sha512.2e81e399d73fe8390dab25e06aa788ab7a5908248d2f5a370f82b481147a6a7a367bf8048f9a6fdb6460f21a66f0542dedb8b94ca2c8723596741920b1656d4c",
   "dependencies": {
     "commander": "15.0.0",
-    "document-outline.js": "3.9.22",
-    "document-schema.js": "7.14.0",
-    "documents.js": "14.1.0",
+    "document-outline.js": "3.10.0",
+    "document-schema.js": "7.15.0",
+    "documents.js": "14.2.0",
     "ink": "7.1.1",
     "ink-text-input": "6.0.0",
     "react": "19.2.8"
@@ -111,7 +111,7 @@
     "eslint": "10.8.1",
     "husky": "9.1.7",
     "ink-testing-library": "4.0.0",
-    "odf.js": "11.0.0",
+    "odf.js": "11.1.0",
     "publint": "0.3.22",
     "semantic-release": "25.0.9",
     "tsdown": "0.22.14",