document-cli 1.3.0 → 1.4.0

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { a as odbFormSummary, c as writeOutput, d as inferFormatFromExtension, f as isDocumentFormat, i as formatOdbReportLines, l as loadProvidedFonts, n as describeOdbReport, o as readInput, r as formatOdbFormLines, s as resolveDefaultOutputPath, t as describeOdbForm } from "./odb-structure-CX_0zL8_.js";
+import { a as odbFormSummary, c as resolveDefaultOutputPath, f as inferFormatFromExtension, i as formatOdbReportLines, l as writeOutput, n as describeOdbReport, o as formatDocxExtrasLines, p as isDocumentFormat, r as formatOdbFormLines, s as readInput, t as describeOdbForm, u as loadProvidedFonts } from "./odb-structure-DkfNyHGR.js";
 import { Command, CommanderError, InvalidArgumentError } from "commander";
 import { writeFile } from "node:fs/promises";
-import { HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError, OdbNoEmbeddedDataSourceError, OdbReportNotSpecifiedError, OdbTableNotFoundError, OdbTableNotSpecifiedError, OdbUnsupportedFormatError, OdmUnresolvedSectionError, PdfEncryptedError, PdfParseError, UnrecognizedDocumentSchemaError, buildDocxPackage, buildMarkdownText, buildOdgPackage, buildOdpPackage, buildOdsPackage, buildOdtPackage, buildPptxPackage, convertWordprocessingToLayout, createFontMeasurer, createFontRegistry, createLocalDocumentConverter, documentFromJson, documentPackageWithSchema, encodeMarkdownText, encodePackage, evaluateSelect, hsqldbCellDisplayText, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, writePdf } from "documents.js";
+import { HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError, OdbNoEmbeddedDataSourceError, OdbReportNotSpecifiedError, OdbTableNotFoundError, OdbTableNotSpecifiedError, OdbUnsupportedFormatError, OdmUnresolvedSectionError, PdfEncryptedError, PdfParseError, UnrecognizedDocumentSchemaError, buildDocxPackage, buildMarkdownText, buildOdgPackage, buildOdpPackage, buildOdsPackage, buildOdtPackage, buildPptxPackage, convertWordprocessingToLayout, createFontMeasurer, createFontRegistry, createLocalDocumentConverter, decodePackage, documentFromJson, documentPackageWithSchema, encodeMarkdownText, encodePackage, evaluateSelect, extractSourceFonts, hsqldbCellDisplayText, layoutDocumentWithSchema, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, writePdf } from "documents.js";
 import { basename, dirname, extname, join } from "node:path";
-import { decodePackage, encodePackage as encodePackage$1 } from "odf.js";
+import { decodePackage as decodePackage$1, encodePackage as encodePackage$1 } from "odf.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/runtime/abort.ts
 function combineSignals(a, b) {
@@ -280,8 +280,100 @@ function registerConversionCommands(program) {
 	});
 }
 //#endregion
+//#region src/commands/docx-extras.ts
+async function runDocxExtras(input, options) {
+	const command = "docx-extras";
+	const { signal, getAbortReason } = createRuntimeSignal({});
+	try {
+		const inputBytes = await readInput(input, { signal });
+		const pkg = decodePackage(new Uint8Array(inputBytes));
+		const extras = readDocxExtras(pkg);
+		if (options.json) {
+			process.stdout.write(`${JSON.stringify(extras)}\n`);
+			return 0;
+		}
+		for (const line of formatDocxExtrasLines(extras)) process.stdout.write(`${line}\n`);
+		return 0;
+	} catch (error) {
+		process.stderr.write(`[${command}] ${formatError(error, false)}\n`);
+		return mapErrorToExit(error, getAbortReason());
+	}
+}
+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) => {
+		process.exitCode = await runDocxExtras(input, options);
+	});
+}
+//#endregion
+//#region src/commands/fonts.ts
+const FONT_SOURCE_FORMATS = {
+	docx: true,
+	pptx: true,
+	odt: true,
+	odp: true,
+	ods: true,
+	odg: true
+};
+function isFontSourceFormat(format) {
+	return format in FONT_SOURCE_FORMATS;
+}
+function resolveFontSourcePackage(format, bytes) {
+	if (format === "docx" || format === "pptx") return {
+		kind: format,
+		package: decodePackage(bytes)
+	};
+	return {
+		kind: "odf",
+		package: decodePackage$1(bytes)
+	};
+}
+async function runFonts(input, options) {
+	const command = "fonts";
+	const { signal, getAbortReason } = createRuntimeSignal({});
+	try {
+		const format = inferFormatFromExtension(input);
+		if (format === void 0) {
+			process.stderr.write(`[${command}] cannot infer a document format from '${input}'; expected one of docx, pptx, odt, odp, ods, odg\n`);
+			return 2;
+		}
+		if (!isFontSourceFormat(format)) {
+			process.stderr.write(`[${command}] '${format}' documents carry no source-embedded font faces this command can extract; expected one of docx, pptx, odt, odp, ods, odg\n`);
+			return 2;
+		}
+		const inputBytes = await readInput(input, { signal });
+		const source = resolveFontSourcePackage(format, new Uint8Array(inputBytes));
+		const summaries = extractSourceFonts(source).map((face) => ({
+			family: face.family,
+			bold: face.bold,
+			italic: face.italic,
+			byteLength: face.bytes.length
+		}));
+		if (options.json) {
+			process.stdout.write(`${JSON.stringify(summaries)}\n`);
+			return 0;
+		}
+		if (summaries.length === 0) {
+			process.stdout.write("This document embeds no source fonts.\n");
+			return 0;
+		}
+		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`);
+		}
+		return 0;
+	} catch (error) {
+		process.stderr.write(`${formatError(error, false)}\n`);
+		return mapErrorToExit(error, getAbortReason());
+	}
+}
+function registerFontsCommand(program) {
+	program.command("fonts <input>").description("list every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length)").option("--json", "emit the face list as a JSON array instead of a human-readable report", false).action(async (input, options) => {
+		process.exitCode = await runFonts(input, options);
+	});
+}
+//#endregion
 //#region src/commands/formats.ts
-const COMMANDS_NOT_LISTED = "odm-to-pdf, odb-to-csv, odb-to-xlsx, odb-tables, odb-forms, odb-reports, pdf-inspect, from-package";
+const COMMANDS_NOT_LISTED = "odm-to-pdf, odb-to-csv, odb-to-xlsx, odb-tables, odb-forms, odb-reports, pdf-inspect, from-package, fonts, docx-extras";
 function registerFormatsCommand(program) {
 	program.command("formats").description("list every source -> target conversion this CLI supports via a <source>-to-<target> command").option("--json", "emit the conversion list as a JSON array instead of a human-readable table", false).action((options) => {
 		const { conversions } = createLocalDocumentConverter();
@@ -483,7 +575,7 @@ async function runOdbTables(input, options) {
 	const { signal, getAbortReason } = createRuntimeSignal({});
 	try {
 		const inputBytes = await readInput(input, { signal });
-		const pkg = decodePackage(new Uint8Array(inputBytes));
+		const pkg = decodePackage$1(new Uint8Array(inputBytes));
 		const tables = readOdbTables(pkg);
 		if (options.json) {
 			const summary = tables.map((table) => ({
@@ -528,7 +620,7 @@ async function runOdbQuery(input, options) {
 	const { signal, getAbortReason } = createRuntimeSignal({});
 	try {
 		const inputBytes = await readInput(input, { signal });
-		const pkg = decodePackage(new Uint8Array(inputBytes));
+		const pkg = decodePackage$1(new Uint8Array(inputBytes));
 		const resolved = resolveQuerySql(pkg, options);
 		if ("errorMessage" in resolved) {
 			process.stderr.write(`[${command}] ${resolved.errorMessage}\n`);
@@ -550,7 +642,7 @@ async function runOdbForms(input, options) {
 	const { signal, getAbortReason } = createRuntimeSignal({});
 	try {
 		const inputBytes = await readInput(input, { signal });
-		const forms = readOdbForms(decodePackage(new Uint8Array(inputBytes)));
+		const forms = readOdbForms(decodePackage$1(new Uint8Array(inputBytes)));
 		if (options.json) {
 			process.stdout.write(`${JSON.stringify(forms.map((form) => odbFormSummary(form)))}\n`);
 			return 0;
@@ -573,7 +665,7 @@ async function runOdbReports(input, options) {
 	const { signal, getAbortReason } = createRuntimeSignal({});
 	try {
 		const inputBytes = await readInput(input, { signal });
-		const reports = readOdbReports(decodePackage(new Uint8Array(inputBytes)));
+		const reports = readOdbReports(decodePackage$1(new Uint8Array(inputBytes)));
 		if (options.json) {
 			process.stdout.write(`${JSON.stringify(reports)}\n`);
 			return 0;
@@ -657,7 +749,7 @@ async function runOdbRenderReport(input, output, options) {
 	try {
 		const inputBytes = await readInput(input, { signal });
 		const fonts = await loadProvidedFonts(options.fontFile ?? [], { signal });
-		const pkg = decodePackage(new Uint8Array(inputBytes));
+		const pkg = decodePackage$1(new Uint8Array(inputBytes));
 		const bytes = renderOdbReportBytes(readOdbReportContent(pkg, { report: options.report }), targetFormat, {
 			fonts,
 			signal,
@@ -868,7 +960,7 @@ async function runPdfInspect(input, options) {
 			}
 		});
 		if (options.full) {
-			process.stdout.write(`${JSON.stringify(layout, void 0, 2)}\n`);
+			process.stdout.write(`${JSON.stringify(layoutDocumentWithSchema(layout), void 0, 2)}\n`);
 			return 0;
 		}
 		const imagesByFormat = countImagesByFormat(layout.images);
@@ -923,7 +1015,7 @@ function registerPdfInspectCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.3.0";
+var version = "1.4.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {
@@ -940,13 +1032,15 @@ function createProgram() {
 	registerOdmCommand(program);
 	registerOdbCommands(program);
 	registerPdfInspectCommand(program);
+	registerFontsCommand(program);
+	registerDocxExtrasCommand(program);
 	return program;
 }
 //#endregion
 //#region src/cli.ts
 async function launchTui(startPath, signal) {
 	try {
-		const { runTui } = await import("./tui-C8ITn1zQ.js");
+		const { runTui } = await import("./tui-CQCLalYe.js");
 		await runTui({
 			startPath,
 			signal

package/dist/index.cjs

@@ -533,8 +533,158 @@ function registerConversionCommands(program) {
 	});
 }
 //#endregion
+//#region src/docx-extras-format.ts
+const INDENT$1 = "  ";
+function indent$1(depth) {
+	return INDENT$1.repeat(depth);
+}
+function commentLine(comment, position) {
+	const author = comment.author ?? "(no author)";
+	return `${indent$1(1)}[${position}] ${author}: ${comment.text}`;
+}
+function footnoteLine(footnote, position) {
+	const typeSuffix = footnote.type === void 0 ? "" : ` (${footnote.type})`;
+	return `${indent$1(1)}[${position}]${typeSuffix} ${footnote.text}`;
+}
+function commentsSection(comments) {
+	if (comments.length === 0) return [];
+	return ["comments", ...comments.map((comment, index) => commentLine(comment, index + 1))];
+}
+function footnotesSection(footnotes) {
+	if (footnotes.length === 0) return [];
+	return ["footnotes", ...footnotes.map((footnote, index) => footnoteLine(footnote, index + 1))];
+}
+function headerOrFooterSection(label, values) {
+	if (values.length === 0) return [];
+	return [label, ...values.map((text, index) => `${indent$1(1)}[${index + 1}] ${text}`)];
+}
+function numberingLevelLine(ilvl, level) {
+	const restartSuffix = level.restart === void 0 ? "" : `, restarts at level ${level.restart}`;
+	return `${indent$1(2)}level ${ilvl}: ${level.format} ${JSON.stringify(level.text)} starting at ${level.startAt}${restartSuffix}`;
+}
+function numberingSection(numbering) {
+	const numIds = Object.keys(numbering);
+	if (numIds.length === 0) return [];
+	const lines = ["numbering"];
+	for (const numId of numIds) {
+		const definition = numbering[numId];
+		if (definition === void 0) continue;
+		lines.push(`${indent$1(1)}numId ${numId}`);
+		const ilvls = Object.keys(definition.levels).sort((a, b) => Number(a) - Number(b));
+		for (const ilvl of ilvls) {
+			const level = definition.levels[ilvl];
+			if (level === void 0) continue;
+			lines.push(numberingLevelLine(ilvl, level));
+		}
+	}
+	return lines;
+}
+function formatDocxExtrasLines(extras) {
+	const nonEmptySections = [
+		commentsSection(extras.comments),
+		footnotesSection(extras.footnotes),
+		headerOrFooterSection("headers", extras.headers),
+		headerOrFooterSection("footers", extras.footers),
+		numberingSection(extras.numbering)
+	].filter((section) => section.length > 0);
+	if (nonEmptySections.length === 0) return ["This document carries no comments, footnotes, headers, footers, or numbering definitions."];
+	return nonEmptySections.flatMap((section, index) => index === 0 ? section : ["", ...section]);
+}
+//#endregion
+//#region src/commands/docx-extras.ts
+async function runDocxExtras(input, options) {
+	const command = "docx-extras";
+	const { signal, getAbortReason } = createRuntimeSignal({});
+	try {
+		const inputBytes = await readInput(input, { signal });
+		const pkg = (0, documents_js.decodePackage)(new Uint8Array(inputBytes));
+		const extras = (0, documents_js.readDocxExtras)(pkg);
+		if (options.json) {
+			process.stdout.write(`${JSON.stringify(extras)}\n`);
+			return 0;
+		}
+		for (const line of formatDocxExtrasLines(extras)) process.stdout.write(`${line}\n`);
+		return 0;
+	} catch (error) {
+		process.stderr.write(`[${command}] ${formatError(error, false)}\n`);
+		return mapErrorToExit(error, getAbortReason());
+	}
+}
+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) => {
+		process.exitCode = await runDocxExtras(input, options);
+	});
+}
+//#endregion
+//#region src/commands/fonts.ts
+const FONT_SOURCE_FORMATS = {
+	docx: true,
+	pptx: true,
+	odt: true,
+	odp: true,
+	ods: true,
+	odg: true
+};
+function isFontSourceFormat(format) {
+	return format in FONT_SOURCE_FORMATS;
+}
+function resolveFontSourcePackage(format, bytes) {
+	if (format === "docx" || format === "pptx") return {
+		kind: format,
+		package: (0, documents_js.decodePackage)(bytes)
+	};
+	return {
+		kind: "odf",
+		package: (0, odf_js.decodePackage)(bytes)
+	};
+}
+async function runFonts(input, options) {
+	const command = "fonts";
+	const { signal, getAbortReason } = createRuntimeSignal({});
+	try {
+		const format = inferFormatFromExtension(input);
+		if (format === void 0) {
+			process.stderr.write(`[${command}] cannot infer a document format from '${input}'; expected one of docx, pptx, odt, odp, ods, odg\n`);
+			return 2;
+		}
+		if (!isFontSourceFormat(format)) {
+			process.stderr.write(`[${command}] '${format}' documents carry no source-embedded font faces this command can extract; expected one of docx, pptx, odt, odp, ods, odg\n`);
+			return 2;
+		}
+		const inputBytes = await readInput(input, { signal });
+		const source = resolveFontSourcePackage(format, new Uint8Array(inputBytes));
+		const summaries = (0, documents_js.extractSourceFonts)(source).map((face) => ({
+			family: face.family,
+			bold: face.bold,
+			italic: face.italic,
+			byteLength: face.bytes.length
+		}));
+		if (options.json) {
+			process.stdout.write(`${JSON.stringify(summaries)}\n`);
+			return 0;
+		}
+		if (summaries.length === 0) {
+			process.stdout.write("This document embeds no source fonts.\n");
+			return 0;
+		}
+		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`);
+		}
+		return 0;
+	} catch (error) {
+		process.stderr.write(`${formatError(error, false)}\n`);
+		return mapErrorToExit(error, getAbortReason());
+	}
+}
+function registerFontsCommand(program) {
+	program.command("fonts <input>").description("list every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length)").option("--json", "emit the face list as a JSON array instead of a human-readable report", false).action(async (input, options) => {
+		process.exitCode = await runFonts(input, options);
+	});
+}
+//#endregion
 //#region src/commands/formats.ts
-const COMMANDS_NOT_LISTED = "odm-to-pdf, odb-to-csv, odb-to-xlsx, odb-tables, odb-forms, odb-reports, pdf-inspect, from-package";
+const COMMANDS_NOT_LISTED = "odm-to-pdf, odb-to-csv, odb-to-xlsx, odb-tables, odb-forms, odb-reports, pdf-inspect, from-package, fonts, docx-extras";
 function registerFormatsCommand(program) {
 	program.command("formats").description("list every source -> target conversion this CLI supports via a <source>-to-<target> command").option("--json", "emit the conversion list as a JSON array instead of a human-readable table", false).action((options) => {
 		const { conversions } = (0, documents_js.createLocalDocumentConverter)();
@@ -1253,7 +1403,7 @@ async function runPdfInspect(input, options) {
 			}
 		});
 		if (options.full) {
-			process.stdout.write(`${JSON.stringify(layout, void 0, 2)}\n`);
+			process.stdout.write(`${JSON.stringify((0, documents_js.layoutDocumentWithSchema)(layout), void 0, 2)}\n`);
 			return 0;
 		}
 		const imagesByFormat = countImagesByFormat(layout.images);
@@ -1308,7 +1458,7 @@ function registerPdfInspectCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.3.0";
+var version = "1.4.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {
@@ -1325,6 +1475,8 @@ function createProgram() {
 	registerOdmCommand(program);
 	registerOdbCommands(program);
 	registerPdfInspectCommand(program);
+	registerFontsCommand(program);
+	registerDocxExtrasCommand(program);
 	return program;
 }
 //#endregion

package/dist/index.js

@@ -1,8 +1,8 @@
 import { readFile, writeFile } from "node:fs/promises";
-import { HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError, OdbNoEmbeddedDataSourceError, OdbReportNotSpecifiedError, OdbTableNotFoundError, OdbTableNotSpecifiedError, OdbUnsupportedFormatError, OdmUnresolvedSectionError, PdfEncryptedError, PdfParseError, UnrecognizedDocumentSchemaError, buildDocxPackage, buildMarkdownText, buildOdgPackage, buildOdpPackage, buildOdsPackage, buildOdtPackage, buildPptxPackage, convertWordprocessingToLayout, createFontMeasurer, createFontRegistry, createLocalDocumentConverter, documentFromJson, documentPackageWithSchema, encodeMarkdownText, encodePackage, evaluateSelect, hsqldbCellDisplayText, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, writePdf } from "documents.js";
+import { HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError, OdbNoEmbeddedDataSourceError, OdbReportNotSpecifiedError, OdbTableNotFoundError, OdbTableNotSpecifiedError, OdbUnsupportedFormatError, OdmUnresolvedSectionError, PdfEncryptedError, PdfParseError, UnrecognizedDocumentSchemaError, buildDocxPackage, buildMarkdownText, buildOdgPackage, buildOdpPackage, buildOdsPackage, buildOdtPackage, buildPptxPackage, convertWordprocessingToLayout, createFontMeasurer, createFontRegistry, createLocalDocumentConverter, decodePackage, documentFromJson, documentPackageWithSchema, encodeMarkdownText, encodePackage, evaluateSelect, extractSourceFonts, hsqldbCellDisplayText, layoutDocumentWithSchema, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, writePdf } from "documents.js";
 import { basename, dirname, extname, join } from "node:path";
 import { Command, InvalidArgumentError } from "commander";
-import { decodePackage, encodePackage as encodePackage$1 } from "odf.js";
+import { decodePackage as decodePackage$1, encodePackage as encodePackage$1 } from "odf.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/format.ts
 const EXTENSION_TO_FORMAT = {
@@ -532,8 +532,158 @@ function registerConversionCommands(program) {
 	});
 }
 //#endregion
+//#region src/docx-extras-format.ts
+const INDENT$1 = "  ";
+function indent$1(depth) {
+	return INDENT$1.repeat(depth);
+}
+function commentLine(comment, position) {
+	const author = comment.author ?? "(no author)";
+	return `${indent$1(1)}[${position}] ${author}: ${comment.text}`;
+}
+function footnoteLine(footnote, position) {
+	const typeSuffix = footnote.type === void 0 ? "" : ` (${footnote.type})`;
+	return `${indent$1(1)}[${position}]${typeSuffix} ${footnote.text}`;
+}
+function commentsSection(comments) {
+	if (comments.length === 0) return [];
+	return ["comments", ...comments.map((comment, index) => commentLine(comment, index + 1))];
+}
+function footnotesSection(footnotes) {
+	if (footnotes.length === 0) return [];
+	return ["footnotes", ...footnotes.map((footnote, index) => footnoteLine(footnote, index + 1))];
+}
+function headerOrFooterSection(label, values) {
+	if (values.length === 0) return [];
+	return [label, ...values.map((text, index) => `${indent$1(1)}[${index + 1}] ${text}`)];
+}
+function numberingLevelLine(ilvl, level) {
+	const restartSuffix = level.restart === void 0 ? "" : `, restarts at level ${level.restart}`;
+	return `${indent$1(2)}level ${ilvl}: ${level.format} ${JSON.stringify(level.text)} starting at ${level.startAt}${restartSuffix}`;
+}
+function numberingSection(numbering) {
+	const numIds = Object.keys(numbering);
+	if (numIds.length === 0) return [];
+	const lines = ["numbering"];
+	for (const numId of numIds) {
+		const definition = numbering[numId];
+		if (definition === void 0) continue;
+		lines.push(`${indent$1(1)}numId ${numId}`);
+		const ilvls = Object.keys(definition.levels).sort((a, b) => Number(a) - Number(b));
+		for (const ilvl of ilvls) {
+			const level = definition.levels[ilvl];
+			if (level === void 0) continue;
+			lines.push(numberingLevelLine(ilvl, level));
+		}
+	}
+	return lines;
+}
+function formatDocxExtrasLines(extras) {
+	const nonEmptySections = [
+		commentsSection(extras.comments),
+		footnotesSection(extras.footnotes),
+		headerOrFooterSection("headers", extras.headers),
+		headerOrFooterSection("footers", extras.footers),
+		numberingSection(extras.numbering)
+	].filter((section) => section.length > 0);
+	if (nonEmptySections.length === 0) return ["This document carries no comments, footnotes, headers, footers, or numbering definitions."];
+	return nonEmptySections.flatMap((section, index) => index === 0 ? section : ["", ...section]);
+}
+//#endregion
+//#region src/commands/docx-extras.ts
+async function runDocxExtras(input, options) {
+	const command = "docx-extras";
+	const { signal, getAbortReason } = createRuntimeSignal({});
+	try {
+		const inputBytes = await readInput(input, { signal });
+		const pkg = decodePackage(new Uint8Array(inputBytes));
+		const extras = readDocxExtras(pkg);
+		if (options.json) {
+			process.stdout.write(`${JSON.stringify(extras)}\n`);
+			return 0;
+		}
+		for (const line of formatDocxExtrasLines(extras)) process.stdout.write(`${line}\n`);
+		return 0;
+	} catch (error) {
+		process.stderr.write(`[${command}] ${formatError(error, false)}\n`);
+		return mapErrorToExit(error, getAbortReason());
+	}
+}
+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) => {
+		process.exitCode = await runDocxExtras(input, options);
+	});
+}
+//#endregion
+//#region src/commands/fonts.ts
+const FONT_SOURCE_FORMATS = {
+	docx: true,
+	pptx: true,
+	odt: true,
+	odp: true,
+	ods: true,
+	odg: true
+};
+function isFontSourceFormat(format) {
+	return format in FONT_SOURCE_FORMATS;
+}
+function resolveFontSourcePackage(format, bytes) {
+	if (format === "docx" || format === "pptx") return {
+		kind: format,
+		package: decodePackage(bytes)
+	};
+	return {
+		kind: "odf",
+		package: decodePackage$1(bytes)
+	};
+}
+async function runFonts(input, options) {
+	const command = "fonts";
+	const { signal, getAbortReason } = createRuntimeSignal({});
+	try {
+		const format = inferFormatFromExtension(input);
+		if (format === void 0) {
+			process.stderr.write(`[${command}] cannot infer a document format from '${input}'; expected one of docx, pptx, odt, odp, ods, odg\n`);
+			return 2;
+		}
+		if (!isFontSourceFormat(format)) {
+			process.stderr.write(`[${command}] '${format}' documents carry no source-embedded font faces this command can extract; expected one of docx, pptx, odt, odp, ods, odg\n`);
+			return 2;
+		}
+		const inputBytes = await readInput(input, { signal });
+		const source = resolveFontSourcePackage(format, new Uint8Array(inputBytes));
+		const summaries = extractSourceFonts(source).map((face) => ({
+			family: face.family,
+			bold: face.bold,
+			italic: face.italic,
+			byteLength: face.bytes.length
+		}));
+		if (options.json) {
+			process.stdout.write(`${JSON.stringify(summaries)}\n`);
+			return 0;
+		}
+		if (summaries.length === 0) {
+			process.stdout.write("This document embeds no source fonts.\n");
+			return 0;
+		}
+		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`);
+		}
+		return 0;
+	} catch (error) {
+		process.stderr.write(`${formatError(error, false)}\n`);
+		return mapErrorToExit(error, getAbortReason());
+	}
+}
+function registerFontsCommand(program) {
+	program.command("fonts <input>").description("list every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length)").option("--json", "emit the face list as a JSON array instead of a human-readable report", false).action(async (input, options) => {
+		process.exitCode = await runFonts(input, options);
+	});
+}
+//#endregion
 //#region src/commands/formats.ts
-const COMMANDS_NOT_LISTED = "odm-to-pdf, odb-to-csv, odb-to-xlsx, odb-tables, odb-forms, odb-reports, pdf-inspect, from-package";
+const COMMANDS_NOT_LISTED = "odm-to-pdf, odb-to-csv, odb-to-xlsx, odb-tables, odb-forms, odb-reports, pdf-inspect, from-package, fonts, docx-extras";
 function registerFormatsCommand(program) {
 	program.command("formats").description("list every source -> target conversion this CLI supports via a <source>-to-<target> command").option("--json", "emit the conversion list as a JSON array instead of a human-readable table", false).action((options) => {
 		const { conversions } = createLocalDocumentConverter();
@@ -867,7 +1017,7 @@ async function runOdbTables(input, options) {
 	const { signal, getAbortReason } = createRuntimeSignal({});
 	try {
 		const inputBytes = await readInput(input, { signal });
-		const pkg = decodePackage(new Uint8Array(inputBytes));
+		const pkg = decodePackage$1(new Uint8Array(inputBytes));
 		const tables = readOdbTables(pkg);
 		if (options.json) {
 			const summary = tables.map((table) => ({
@@ -912,7 +1062,7 @@ async function runOdbQuery(input, options) {
 	const { signal, getAbortReason } = createRuntimeSignal({});
 	try {
 		const inputBytes = await readInput(input, { signal });
-		const pkg = decodePackage(new Uint8Array(inputBytes));
+		const pkg = decodePackage$1(new Uint8Array(inputBytes));
 		const resolved = resolveQuerySql(pkg, options);
 		if ("errorMessage" in resolved) {
 			process.stderr.write(`[${command}] ${resolved.errorMessage}\n`);
@@ -934,7 +1084,7 @@ async function runOdbForms(input, options) {
 	const { signal, getAbortReason } = createRuntimeSignal({});
 	try {
 		const inputBytes = await readInput(input, { signal });
-		const forms = readOdbForms(decodePackage(new Uint8Array(inputBytes)));
+		const forms = readOdbForms(decodePackage$1(new Uint8Array(inputBytes)));
 		if (options.json) {
 			process.stdout.write(`${JSON.stringify(forms.map((form) => odbFormSummary(form)))}\n`);
 			return 0;
@@ -957,7 +1107,7 @@ async function runOdbReports(input, options) {
 	const { signal, getAbortReason } = createRuntimeSignal({});
 	try {
 		const inputBytes = await readInput(input, { signal });
-		const reports = readOdbReports(decodePackage(new Uint8Array(inputBytes)));
+		const reports = readOdbReports(decodePackage$1(new Uint8Array(inputBytes)));
 		if (options.json) {
 			process.stdout.write(`${JSON.stringify(reports)}\n`);
 			return 0;
@@ -1041,7 +1191,7 @@ async function runOdbRenderReport(input, output, options) {
 	try {
 		const inputBytes = await readInput(input, { signal });
 		const fonts = await loadProvidedFonts(options.fontFile ?? [], { signal });
-		const pkg = decodePackage(new Uint8Array(inputBytes));
+		const pkg = decodePackage$1(new Uint8Array(inputBytes));
 		const bytes = renderOdbReportBytes(readOdbReportContent(pkg, { report: options.report }), targetFormat, {
 			fonts,
 			signal,
@@ -1252,7 +1402,7 @@ async function runPdfInspect(input, options) {
 			}
 		});
 		if (options.full) {
-			process.stdout.write(`${JSON.stringify(layout, void 0, 2)}\n`);
+			process.stdout.write(`${JSON.stringify(layoutDocumentWithSchema(layout), void 0, 2)}\n`);
 			return 0;
 		}
 		const imagesByFormat = countImagesByFormat(layout.images);
@@ -1307,7 +1457,7 @@ function registerPdfInspectCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.3.0";
+var version = "1.4.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {
@@ -1324,6 +1474,8 @@ function createProgram() {
 	registerOdmCommand(program);
 	registerOdbCommands(program);
 	registerPdfInspectCommand(program);
+	registerFontsCommand(program);
+	registerDocxExtrasCommand(program);
 	return program;
 }
 //#endregion

package/dist/{odb-structure-CX_0zL8_.js → odb-structure-DkfNyHGR.js}

@@ -247,6 +247,64 @@ function resolveDefaultOutputPath(inputPath, targetFormat) {
 	return join(directory, `${stem}.${formatToExtension(targetFormat)}`);
 }
 //#endregion
+//#region src/docx-extras-format.ts
+const INDENT$1 = "  ";
+function indent$1(depth) {
+	return INDENT$1.repeat(depth);
+}
+function commentLine(comment, position) {
+	const author = comment.author ?? "(no author)";
+	return `${indent$1(1)}[${position}] ${author}: ${comment.text}`;
+}
+function footnoteLine(footnote, position) {
+	const typeSuffix = footnote.type === void 0 ? "" : ` (${footnote.type})`;
+	return `${indent$1(1)}[${position}]${typeSuffix} ${footnote.text}`;
+}
+function commentsSection(comments) {
+	if (comments.length === 0) return [];
+	return ["comments", ...comments.map((comment, index) => commentLine(comment, index + 1))];
+}
+function footnotesSection(footnotes) {
+	if (footnotes.length === 0) return [];
+	return ["footnotes", ...footnotes.map((footnote, index) => footnoteLine(footnote, index + 1))];
+}
+function headerOrFooterSection(label, values) {
+	if (values.length === 0) return [];
+	return [label, ...values.map((text, index) => `${indent$1(1)}[${index + 1}] ${text}`)];
+}
+function numberingLevelLine(ilvl, level) {
+	const restartSuffix = level.restart === void 0 ? "" : `, restarts at level ${level.restart}`;
+	return `${indent$1(2)}level ${ilvl}: ${level.format} ${JSON.stringify(level.text)} starting at ${level.startAt}${restartSuffix}`;
+}
+function numberingSection(numbering) {
+	const numIds = Object.keys(numbering);
+	if (numIds.length === 0) return [];
+	const lines = ["numbering"];
+	for (const numId of numIds) {
+		const definition = numbering[numId];
+		if (definition === void 0) continue;
+		lines.push(`${indent$1(1)}numId ${numId}`);
+		const ilvls = Object.keys(definition.levels).sort((a, b) => Number(a) - Number(b));
+		for (const ilvl of ilvls) {
+			const level = definition.levels[ilvl];
+			if (level === void 0) continue;
+			lines.push(numberingLevelLine(ilvl, level));
+		}
+	}
+	return lines;
+}
+function formatDocxExtrasLines(extras) {
+	const nonEmptySections = [
+		commentsSection(extras.comments),
+		footnotesSection(extras.footnotes),
+		headerOrFooterSection("headers", extras.headers),
+		headerOrFooterSection("footers", extras.footers),
+		numberingSection(extras.numbering)
+	].filter((section) => section.length > 0);
+	if (nonEmptySections.length === 0) return ["This document carries no comments, footnotes, headers, footers, or numbering definitions."];
+	return nonEmptySections.flatMap((section, index) => index === 0 ? section : ["", ...section]);
+}
+//#endregion
 //#region src/odb-structure.ts
 const INDENT = "  ";
 function indent(depth) {
@@ -379,4 +437,4 @@ function formatOdbReportLines(report) {
 	return lines;
 }
 //#endregion
-export { odbFormSummary as a, writeOutput as c, inferFormatFromExtension as d, isDocumentFormat as f, formatOdbReportLines as i, loadProvidedFonts as l, describeOdbReport as n, readInput as o, formatOdbFormLines as r, resolveDefaultOutputPath as s, describeOdbForm as t, formatToExtension as u };
+export { odbFormSummary as a, resolveDefaultOutputPath as c, formatToExtension as d, inferFormatFromExtension as f, formatOdbReportLines as i, writeOutput as l, describeOdbReport as n, formatDocxExtrasLines as o, isDocumentFormat as p, formatOdbFormLines as r, readInput as s, describeOdbForm as t, loadProvidedFonts as u };

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

@@ -1,8 +1,8 @@
-import { d as inferFormatFromExtension, i as formatOdbReportLines, l as loadProvidedFonts, n as describeOdbReport, o as readInput, r as formatOdbFormLines, t as describeOdbForm, u as formatToExtension } from "./odb-structure-CX_0zL8_.js";
+import { d as formatToExtension, f as inferFormatFromExtension, i as formatOdbReportLines, n as describeOdbReport, o as formatDocxExtrasLines, r as formatOdbFormLines, s as readInput, t as describeOdbForm, u as loadProvidedFonts } from "./odb-structure-DkfNyHGR.js";
 import { readFile, writeFile } from "node:fs/promises";
-import { buildDocxPackage, buildOdtPackage, convertWordprocessingToLayout, createDocx, createFontMeasurer, createFontRegistry, createOdg, createOdp, createOds, createOdt, createPptx, decodeMarkdownText, docxToPdf, encodeMarkdownText, encodePackage, hsqldbCellDisplayText, markdownToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openOdg, openOdp, openOds, openOdt, openPptx, pptxToPdf, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdsContent, readPdf, rgbHexToColor, writePdf, xlsxToPdf } from "documents.js";
+import { buildDocxPackage, buildOdtPackage, convertWordprocessingToLayout, createDocx, createFontMeasurer, createFontRegistry, createOdg, createOdp, createOds, createOdt, createPptx, decodeMarkdownText, docxToPdf, encodeMarkdownText, encodePackage, hsqldbCellDisplayText, markdownToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openOdg, openOdp, openOds, openOdt, openPptx, pptxToPdf, readDocxExtras, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdsContent, readPdf, rgbHexToColor, writePdf, xlsxToPdf } from "documents.js";
 import { basename, dirname, extname, join } from "node:path";
-import { cellReference, columnIndexToLetters, decodePackage, encodePackage as encodePackage$1 } from "odf.js";
+import { cellReference, columnIndexToLetters, decodePackage as decodePackage$1, encodePackage as encodePackage$1 } from "odf.js";
 import { readdirSync } from "node:fs";
 import { Box, Text, render, useApp, useInput, useWindowSize } from "ink";
 import { createContext, useContext, useEffect, useReducer, useState } from "react";
@@ -78,7 +78,7 @@ const ODB_EXTENSION = ".odb";
 async function openDocumentAtPath(path) {
 	const bytes = new Uint8Array(await readFile(path));
 	if (path.toLowerCase().endsWith(ODB_EXTENSION)) {
-		const pkg = decodePackage(bytes);
+		const pkg = decodePackage$1(bytes);
 		return {
 			format: "odb",
 			tables: readOdbTables(pkg),
@@ -209,6 +209,7 @@ function selectionKeyFor(screen) {
 		case "launcher":
 		case "newDocumentPicker":
 		case "bodyList":
+		case "docxExtras":
 		case "slideList":
 		case "sheetList":
 		case "pageList":
@@ -2261,6 +2262,12 @@ function DocxBodyListScreen() {
 	const state = useAppState();
 	const dispatch = useAppDispatch();
 	const doc = state.openDocument;
+	useInput((input) => {
+		if (input === "x" && doc?.format === "docx") dispatch({
+			type: "PUSH_SCREEN",
+			screen: { kind: "docxExtras" }
+		});
+	}, { isActive: doc?.format === "docx" && !anyOverlayOpen(state) });
 	if (doc?.format !== "docx") return /* @__PURE__ */ jsxs(Text, {
 		color: "red",
 		children: [
@@ -2278,6 +2285,65 @@ function DocxBodyListScreen() {
 	return /* @__PURE__ */ jsx(ParagraphFamilyBodyList, { adapter });
 }
 //#endregion
+//#region src/tui/screens/editors/docx/extras.tsx
+const DOCX_EXTRAS_RESERVED_ROWS = 5;
+function DocxExtrasScreen() {
+	const state = useAppState();
+	const dispatch = useAppDispatch();
+	const doc = state.openDocument;
+	const isDocx = doc?.format === "docx";
+	const extras = doc?.format === "docx" ? readDocxExtras(doc.editor.toPackage()) : void 0;
+	const allLines = extras === void 0 ? [] : formatDocxExtrasLines(extras);
+	const query = state.searchQuery.trim().toLowerCase();
+	const lines = query === "" ? allLines : allLines.filter((line) => line.toLowerCase().includes(query));
+	const { selectedIndex } = useNavigationInput({
+		itemCount: lines.length,
+		onSelect: () => {},
+		onBack: () => {
+			dispatch({ type: "POP_SCREEN" });
+		},
+		isActive: isDocx && !anyOverlayOpen(state)
+	});
+	if (!isDocx) return /* @__PURE__ */ jsxs(Text, {
+		color: "red",
+		children: [
+			"DocxExtrasScreen requires an open docx document, found ",
+			doc === void 0 ? "no open document" : doc.format,
+			"."
+		]
+	});
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Text, {
+				bold: true,
+				children: [
+					"Comments, footnotes, headers, footers, numbering (",
+					lines.length,
+					" of ",
+					allLines.length,
+					" lines)"
+				]
+			}),
+			/* @__PURE__ */ jsx(ListView, {
+				items: lines,
+				selectedIndex,
+				reservedRows: DOCX_EXTRAS_RESERVED_ROWS,
+				emptyMessage: query === "" ? "This document carries no comments, footnotes, headers, footers, or numbering definitions." : `No lines match "${state.searchQuery}".`,
+				renderItem: (line, isSelected) => /* @__PURE__ */ jsx(Text, {
+					color: isSelected ? "cyan" : void 0,
+					inverse: isSelected,
+					children: line
+				})
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "Esc to go back to the body list"
+			})
+		]
+	});
+}
+//#endregion
 //#region src/tui/screens/editors/markdown/shared.ts
 function requireMarkdownDocument(openDocument) {
 	if (openDocument?.format !== "markdown") throw new Error("A markdown editing screen rendered without an open markdown document; the app router only reaches this screen group from markdownLineList, which is only ever the root screen of an open markdown document.");
@@ -2686,7 +2752,7 @@ 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`);
 	const fonts = await loadProvidedFonts(options.fontFiles ?? [], { signal: options.signal });
-	const pkg = decodePackage(new Uint8Array(await readFile(doc.path)));
+	const pkg = decodePackage$1(new Uint8Array(await readFile(doc.path)));
 	const bytes = renderReportBytes(readOdbReportContent(pkg, { report: options.reportName }), format, fonts, options);
 	await writeFile(destinationPath, bytes);
 }
@@ -6188,6 +6254,7 @@ function ScreenBody({ screen }) {
 		case "filePicker": return /* @__PURE__ */ jsx(FilePickerScreen, {});
 		case "newDocumentPicker": return /* @__PURE__ */ jsx(NewDocumentPickerScreen, {});
 		case "bodyList": return format === "odt" ? /* @__PURE__ */ jsx(OdtBodyListScreen, {}) : /* @__PURE__ */ jsx(DocxBodyListScreen, {});
+		case "docxExtras": return /* @__PURE__ */ jsx(DocxExtrasScreen, {});
 		case "paragraphDetail": return /* @__PURE__ */ jsx(ParagraphDetailScreen, {});
 		case "runEditor": return /* @__PURE__ */ jsx(RunEditorScreen, {});
 		case "tableView": return /* @__PURE__ */ jsx(TableViewScreen, {});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "CLI and interactive Ink TUI for documents.js: every docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/markdown conversion, bridge, and editor as a scriptable command or a terminal app.",
   "type": "module",
   "repository": {