document-cli 1.14.115 → 2.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/document-cli) [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/document-cli) [![Release](https://img.shields.io/github/v/release/ExaDev/document-cli)](https://github.com/ExaDev/document-cli/releases/latest) [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/document-cli/ci.yml?branch=main)](https://github.com/ExaDev/document-cli/actions)
 
-> A command-line interface and an interactive terminal (Ink) app for [`documents.js`](https://github.com/ExaDev/documents.js): every docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/markdown conversion, bridge, and editor documents.js exposes, wired up as a scriptable subcommand or a full-screen terminal editor. Installs as either `document-cli` or `doculi`.
+> A command-line interface and an interactive terminal (Ink) app for [`documents.js`](https://github.com/ExaDev/documents.js): every docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and editor documents.js exposes, wired up as a scriptable subcommand or a full-screen terminal editor. Installs as either `document-cli` or `doculi`.
 
 `document-cli` adds no conversion or editing logic of its own — it is a dispatch layer over `documents.js`'s existing conversion functions, `DocumentConverter` port, live-view editors, and `.odb`/PDF readers. What it adds is two ways to drive them without writing TypeScript: a scriptable, Unix-shaped CLI (stdin/stdout, exit codes, `--json` diagnostics) for pipelines, and a full-screen Ink terminal app for browsing and editing a document interactively.
 
@@ -79,7 +79,7 @@ cat report.docx | document-cli docx-to-pdf - - > report.pdf
 
 ### Commands
 
-**The explicit `<source>-to-<target>` conversions** — one command per pair `createLocalDocumentConverter().conversions` declares in `documents.js` (confirmed by running the built CLI's own `formats` command, not assumed): the nine `<format>-to-pdf` conversions `docx-to-pdf`, `pptx-to-pdf`, `odt-to-pdf`, `odp-to-pdf`, `ods-to-pdf`, `odg-to-pdf`, `odf-to-pdf`, `xlsx-to-pdf`, `markdown-to-pdf`; the eight `pdf-to-<format>` reverse conversions `pdf-to-docx`, `pdf-to-pptx`, `pdf-to-odt`, `pdf-to-odp`, `pdf-to-ods`, `pdf-to-odg`, `pdf-to-xlsx`, `pdf-to-markdown` (`odf-to-pdf` is one-way — there is no `pdf-to-odf` — see documents.js's own README); and sixteen PDF-bypassing bridges — ten same-variant pairs that copy content directly between formats sharing one `ContentDocument` variant (`odt-to-docx`, `docx-to-odt`, `odp-to-pptx`, `pptx-to-odp`, `ods-to-xlsx`, `xlsx-to-ods`, `markdown-to-docx`, `docx-to-markdown`, `markdown-to-odt`, `odt-to-markdown`), plus six cross-variant pairs that swap a document's content variant through a semantic transform (`docx-to-pptx`, `pptx-to-docx`, `odt-to-odp`, `odp-to-odt`, `xlsx-to-markdown`, `markdown-to-xlsx`). Each takes `<input> [output]`:
+**The explicit `<source>-to-<target>` conversions** — one command per pair `createLocalDocumentConverter().conversions` declares in `documents.js` (confirmed by running the built CLI's own `formats` command, not assumed): every ordered pair of the ten content formats — docx, pptx, xlsx, odt, odp, ods, odg, svg, csv, markdown — in both directions as a PDF-bypassing bridge (a pair whose formats share one `ContentDocument` variant, like `odt-to-docx` or `ods-to-xlsx`, copies content across directly; a cross-variant pair, like `docx-to-pptx`, `xlsx-to-markdown`, or `odg-to-svg`, swaps the document's content variant through a semantic transform); each of those ten plus `odf` into pdf (`docx-to-pdf`, `xlsx-to-pdf`, `csv-to-pdf`, `svg-to-pdf`, `odf-to-pdf`, ...); and pdf back into the same ten (`pdf-to-docx`, `pdf-to-xlsx`, `pdf-to-csv`, `pdf-to-svg`, ... — there is no `pdf-to-odf`; `odf-to-pdf` is one-way, see documents.js's own README). Each takes `<input> [output]`:
 
 ```sh
 document-cli docx-to-pdf report.docx report.pdf
@@ -95,7 +95,7 @@ document-cli convert report.docx - --to pdf > report.pdf
 
 **`formats`** — lists every `source -> target` pair the commands above support (`--json` for a machine-readable array), plus a pointer to the commands not on that list because they don't fit the source/target shape (`odm-to-pdf`, `odb-to-csv`, `odb-to-xlsx`, `odb-tables`, `odb-forms`, `odb-reports`, `pdf-inspect`, `from-package`, `fonts`, `docx-extras`, `metadata`, `set-metadata`).
 
-**`from-package <input> [output]`** — reads back a `DocumentPackage` JSON file a previous conversion wrote via `--dump-package` (below) and exports it to a real target format, closing the round trip `--dump-package` otherwise has no return path for. Target resolution matches `convert`: an output path's own extension, or `--to <format>` when it doesn't have one. `pdf` writes the package's own `layout` half directly (`writePdf`); every other format builds a fresh package from the `content` half through the identical `buildXPackage` function the matching `pdf-to-X`/bridge conversion already uses — `xlsx` included, via `ooxml.js`'s own `buildXlsxPackage`. `odf` is the one target rejected outright, since a standalone formula document has no write path from `ContentDocument` at all. Only a file genuinely written by `--dump-package` round-trips here; anything else fails with its `$schema` mismatch named:
+**`from-package <input> [output]`** — reads back a `DocumentPackage` JSON file a previous conversion wrote via `--dump-package` (below) and exports it to a real target format, closing the round trip `--dump-package` otherwise has no return path for. Target resolution matches `convert`: an output path's own extension, or `--to <format>` when it doesn't have one. `pdf` rebuilds the layout from the package's own recorded positions — each content node's `frames` plus the package's `pages` geometry (`layoutDocumentFromPackage` → `writePdf`; a package no longer carries a separate `layout` half at all); every other format builds a fresh package from the `content` half through the identical `buildXPackage` function the matching `pdf-to-X`/bridge conversion already uses — `xlsx` included, via `ooxml.js`'s own `buildXlsxPackage`. `odf` is the one target rejected outright, since a standalone formula document has no write path from `ContentDocument` at all; a `csv` or `svg` target is written through the identical `buildCsvText`/`buildSvgText` functions the codec registry's own write wrappers call, so the `--delimiter`/`--sheet`/`--page` selection flags below reach it exactly as they do a live conversion. Only a file genuinely written by a current `--dump-package` round-trips here; anything else fails with its `$schema` mismatch named, and a dump from the documents.js 1.x `formatVersion` 1 shape (content plus a separate `layout` half) is rejected with an error naming the version change rather than silently accepted:
 
 ```sh
 document-cli docx-to-pdf report.docx report.pdf --dump-package report.package.json
@@ -139,7 +139,7 @@ document-cli pdf-inspect report.pdf
 document-cli pdf-inspect report.pdf --json
 ```
 
-**`fonts <input>`** — lists every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length) — the same embedded faces every `<format>-to-pdf` conversion already extracts and renders through automatically (see [Real fonts](#real-fonts) below); this command just reports what's there without converting anything. Rejects a format with no source-embedded-font concept at all (xlsx, pdf, markdown, odf), naming it:
+**`fonts <input>`** — lists every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length) — the same embedded faces every `<format>-to-pdf` conversion already extracts and renders through automatically (see [Real fonts](#real-fonts) below); this command just reports what's there without converting anything. Rejects a format with no source-embedded-font concept at all (xlsx, csv, svg, pdf, markdown, odf), naming it:
 
 ```sh
 document-cli fonts report.docx
@@ -151,13 +151,13 @@ document-cli fonts report.docx
 document-cli docx-extras report.docx
 ```
 
-**`metadata <input>`** — prints a document's own title/author/subject/keywords/creator/producer/created/modified metadata, for any of the ten supported formats (docx, pptx, xlsx, odt, odp, ods, odg, odf, markdown, pdf). `--json` emits the raw metadata object:
+**`metadata <input>`** — prints a document's own title/author/subject/keywords/creator/producer/created/modified metadata, for any of the twelve supported formats (docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, pdf); csv and svg carry no metadata container of their own, so they always report none. `--json` emits the raw metadata object:
 
 ```sh
 document-cli metadata report.pdf
 ```
 
-**`set-metadata <input> [output]`** — patches a document's own title/author/subject/keywords, leaving every other field untouched (`--set-title`, `--set-author`, `--set-subject`, `--set-keywords` — the last a comma-separated list); source and target format must match, so run `convert`/`from-package` first if a different target format is also needed. A `pdf` source/target patches the parsed PDF directly (`writePdf`) with no layout engine involved — genuinely lossless for everything else on the page; every other format rebuilds a fresh package from that format's own `ContentDocument`, which for docx specifically is lossy (it drops everything `docx-extras` covers, since `buildDocxPackage` has no way to carry that data through a `ContentDocument`-only rebuild):
+**`set-metadata <input> [output]`** — patches a document's own title/author/subject/keywords, leaving every other field untouched (`--set-title`, `--set-author`, `--set-subject`, `--set-keywords` — the last a comma-separated list); source and target format must match, so run `convert`/`from-package` first if a different target format is also needed. A `pdf` source/target patches the parsed PDF directly (`writePdf`) with no layout engine involved — genuinely lossless for everything else on the page; every other format rebuilds a fresh package from that format's own `ContentDocument`, which for docx specifically is lossy (it drops everything `docx-extras` covers, since `buildDocxPackage` has no way to carry that data through a `ContentDocument`-only rebuild); a `csv` or `svg` source/target is rejected outright, since plain text has no metadata container and a rebuild would silently drop the override:
 
 ```sh
 document-cli set-metadata report.docx report.docx --set-title "Q3 Report" --set-author "Finance"
@@ -178,7 +178,9 @@ The explicit conversions, `convert`, `odm-to-pdf`, `odb-to-xlsx`, `odb-to-csv`,
 | `-q, --quiet` | Suppress diagnostic and summary output (the JSON result-summary line still prints in `--json` mode, so a script consuming NDJSON always gets a terminating record). |
 | `--verbose` | Include a full stack trace in the error line when the run fails. |
 
-`--dump-package <file>` is one flag further, registered only on the explicit conversions and `convert` — it writes the intermediate `DocumentPackage` (content + layout) that conversion built to a JSON file, tagged with its own `$schema` so `from-package` (above) can read it back in. Every conversion populates one except `odf-to-pdf`, which accepts but never invokes its own `onDocument` callback (a standalone formula document has no `ContentDocument`/`LayoutDocument` pivot behind it); the sixteen PDF-bypassing bridges (the ten same-variant pairs `odt-to-docx`/`docx-to-odt`, `odp-to-pptx`/`pptx-to-odp`, `ods-to-xlsx`/`xlsx-to-ods`, `markdown-to-docx`/`docx-to-markdown`, `markdown-to-odt`/`odt-to-markdown`, plus the six cross-variant pairs `docx-to-pptx`/`pptx-to-docx`, `odt-to-odp`/`odp-to-odt`, `xlsx-to-markdown`/`markdown-to-xlsx`) populate one too, just with `layout` always `undefined`, since a bridge never runs a layout engine. `odm-to-pdf`/`odb-*`/`set-metadata` don't expose the flag at all, since none of them goes through `DocumentConverter.convert` in the first place. `odb-tables`, `odb-forms`, `odb-reports`, `fonts`, `docx-extras`, `metadata`, `formats`, and `pdf-inspect` each take only their own `--json` (plus `pdf-inspect`'s own `--full`); `odb-query` takes `--sql <text>`/`--query <savedName>` (mutually exclusive) alongside its own `--json`, with none of the shared flags above since it only reads and writes nothing; `from-package` and `set-metadata` each take `--to <format>` alongside the shared flags in this table; `odb-render-report` takes `--report <name>` and `--to <format>` alongside the shared flags and the font flags below; `tui` takes no flags at all, only an optional positional file.
+Three further flags select what a csv or svg edge of a conversion works on, threaded straight into documents.js's own `ConversionOptions`: `--delimiter <char>` (the field delimiter a csv source reads with, or a csv target writes with — default `,`), `--sheet <name>` (the sheet a csv target writes, required when the source document has more than one), and `--page <index>` (the 0-based page an svg target draws, required when the source document has more than one). On the explicit commands they are registered only where the pair can reach the edge in question — `--delimiter` on any pair with a csv edge, `--sheet` on a csv target, `--page` on an svg target — and unconditionally on `convert` and `from-package`, whose target is only known once the output path or `--to` resolves at run time (the same registration reasoning the font flags below document). Leaving `--sheet` or `--page` unanswered on an ambiguous document fails with exit `3`, naming the sheets or page count to pick from:
+
+`--dump-package <file>` is one flag further, registered only on the explicit conversions and `convert` — it writes the intermediate `DocumentPackage` (content carrying its own per-node rendered `frames`, plus the `pages` geometry those frames index into) that conversion built to a JSON file, tagged with its own `$schema` so `from-package` (above) can read it back in. Every conversion populates one, `odf-to-pdf` included — its dump carries a `formula`-kind content and the one A4 page it renders (the formula's glyphs travel through the PDF writer's own positioned-formula channel rather than as frame-stamped page content); every PDF-bypassing bridge (`ods-to-xlsx`, `docx-to-pptx`, `odg-to-svg`, and every other content-format pair above) populates one too, just with `pages` always absent, since a bridge never runs a layout engine. `odm-to-pdf`/`odb-*`/`set-metadata` don't expose the flag at all, since none of them goes through `DocumentConverter.convert` in the first place. `odb-tables`, `odb-forms`, `odb-reports`, `fonts`, `docx-extras`, `metadata`, `formats`, and `pdf-inspect` each take only their own `--json` (plus `pdf-inspect`'s own `--full`); `odb-query` takes `--sql <text>`/`--query <savedName>` (mutually exclusive) alongside its own `--json`, with none of the shared flags above since it only reads and writes nothing; `from-package` and `set-metadata` each take `--to <format>` alongside the shared flags in this table; `odb-render-report` takes `--report <name>` and `--to <format>` alongside the shared flags and the font flags below; `tui` takes no flags at all, only an optional positional file.
 
 ### Real fonts
 
@@ -195,7 +197,7 @@ The flag is repeatable, takes a `.ttf`/`.otf` path, and needs **no accompanying
 
 `--report-font-substitutions` prints each face that resolved to something other than what the document asked for, as it happens, with its structured fields intact (`--json` makes it one more NDJSON record: `{"type":"font-substitution","requestedFamily":"Calibri",…}`). Without it, the same fallbacks are still reported — the `font/substituted` diagnostic lines every conversion already emits — just as rendered messages after the fact rather than structured events as they occur.
 
-Both flags are registered only where they can do something: the nine `<format>-to-pdf` conversions, `convert`, `odm-to-pdf`, and `odb-render-report`. The last two register them unconditionally (like `convert`, whose target isn't known until the output path or `--to` resolves) even though a `docx`/`odt` render has nothing to resolve fonts against — the same non-pdf no-op every other command in this list already documents. A `pdf-to-<format>` reconstruction reads a PDF's own already-positioned glyphs and a format-to-format bridge runs no layout engine at all, so neither resolves a typeface and neither advertises the flags.
+Both flags are registered only where they can do something: the `<format>-to-pdf` conversions, `convert`, `odm-to-pdf`, and `odb-render-report`. The last two register them unconditionally (like `convert`, whose target isn't known until the output path or `--to` resolves) even though a `docx`/`odt` render has nothing to resolve fonts against — the same non-pdf no-op every other command in this list already documents. A `pdf-to-<format>` reconstruction reads a PDF's own already-positioned glyphs and a format-to-format bridge runs no layout engine at all, so neither resolves a typeface and neither advertises the flags.
 
 Diagnostics and the summary line always go to stderr; stdout is reserved for the converted bytes on any command writing to `-`.
 
@@ -206,7 +208,7 @@ Diagnostics and the summary line always go to stderr; stdout is reserved for the
 | `0` | Success. |
 | `1` | The input was unusable — a malformed or encrypted PDF, or any other conversion failure not covered by the codes below. |
 | `2` | A usage error — bad flags, conflicting output destinations, an unrecognised format, or (for a bare/`--help`/`--version` invocation) commander's own exit path. |
-| `3` | documents.js needs more information to finish, not a different file — an unresolved `.odm` chapter, a `.odb` table that wasn't specified (or wasn't found, or has no embedded engine at all, or uses an unsupported HSQLDB script serialisation), or a `.odb` report that wasn't specified when the database declares more than one. |
+| `3` | documents.js needs more information to finish, not a different file — an unresolved `.odm` chapter, a `.odb` table that wasn't specified (or wasn't found, or has no embedded engine at all, or uses an unsupported HSQLDB script serialisation), a `.odb` report that wasn't specified when the database declares more than one, a csv target whose source carries more than one sheet (or a `--sheet` that names one it doesn't), or an svg target whose source carries more than one page (or a `--page` that indexes past the last). |
 | `124` | The run's own `--timeout` elapsed before it finished. |
 | `130` | Interrupted by `SIGINT` (Ctrl+C). |
 
@@ -218,7 +220,7 @@ It supports the same seven formats documents.js's live-view editors cover — do
 
 Markdown (`.md`/`.markdown`) shares the same paragraph/run/table body-list screens docx and odt already use, through documents.js's own `MarkdownEditor` (`openMarkdown`/`createMarkdownEditor`) — a genuine live view over a mutable `ContentDocument`, the same live-view contract every other editor here follows, even though there is no `XmlElement` tree underneath it the way there is for docx/odt (`MarkdownEditor.toMarkdownText()` re-serialises the whole document fresh on every call, rather than exposing a `toBytes()`). Appending a paragraph, appending a run, and toggling bold/italic all go through the identical reducer actions docx/odt use; a markdown run has no underline, colour, font family, or font size at all (CommonMark/GFM has no construct for any of the four), so those keys — along with image insertion, which `MarkdownParagraph` has no counterpart for — are simply absent from a markdown paragraph's own key hints rather than opening a prompt that could only end in a warning. A markdown table can be created and its cells edited through the same 'T' wizard and table-view screens docx/odt use, but GFM tables have no cell-merge concept, so a merge requested alongside table creation still creates the table (unmerged) and reports why the merge itself didn't happen. `:view-source` (markdown documents only) shows the literal text the document was opened with side by side with what a save would write right now — these can genuinely differ even with no edits made this session, from a heading-style, bullet-marker, or line-ending choice the writer normalises. Every save re-serialises the whole document fresh through `buildMarkdownText`, a deliberate, permanent consequence of structured editing rather than something to work around. Diagnostics from the read side (a clamped heading level, a dropped front-matter key, a fenced code block's own info string with nowhere to go, …) now surface into the same diagnostics panel a PDF export's own substitutions already populate, the moment a `.md` file is opened, not only on export. documents.js's own `createMarkdownEditor()` exists now, but this TUI does not yet wire a "new markdown document" flow into `:new`/the new-document picker, so a markdown document can still only be opened from an existing file.
 
-Three further formats open read-only: a `.odb` browses its tables and rows with no write path at all (documents.js's own `.odb` support has no write direction to offer), a `.pdf` browses its pages and positioned items rather than being edited in place, and a `.xlsx` opens as a converted PDF preview — documents.js has no xlsx editor to hold a live view into, so opening one runs `xlsxToPdf` once at open time and browses the result through the identical page-list/page-items/item-detail screens a real `.pdf` uses, with the original bytes kept alongside so a later export re-runs `xlsxToPdf` with the caller's own fonts and diagnostics rather than reusing the fixed preview conversion. A `.odb` additionally browses its *structure* alongside its data: `f` from the table list opens the form browser and `r` the report browser, each listing what the database declares and opening one to show it in full — a form's own data source and field-bound controls (sub-forms nested under their parent), a report's data-source command, band and group structure, and every `rpt:` formula. Both are rendered through the same `src/odb-structure.ts` the `odb-forms`/`odb-reports` commands print, so the two views cannot drift apart, and search filters by line (`/SUM` narrows a long report to its aggregate expressions). `Enter` on a report's own detail screen renders it — its data-source command resolved, its `rpt:` formulas evaluated, its bands laid out — to a real `docx`/`odt`/`pdf` file, through the same two-field destination-path-then-font-list form the PDF-export screen below uses; the TUI counterpart to the `odb-render-report` command. A standalone `.odf` formula document has no TUI editor either — nothing to edit interactively, only a PDF conversion.
+Three further kinds of format open read-only: a `.odb` browses its tables and rows with no write path at all (documents.js's own `.odb` support has no write direction to offer), a `.pdf` browses its pages and positioned items rather than being edited in place, and a `.xlsx`, `.csv`, or `.svg` opens as a converted PDF preview — documents.js has no spreadsheet or svg editor to hold a live view into, so opening one runs `xlsxToPdf`, `csvToPdf`, or `svgToPdf` once at open time and browses the result through the identical page-list/page-items/item-detail screens a real `.pdf` uses, with the original bytes kept alongside so a later export re-runs the same conversion with the caller's own fonts and diagnostics rather than reusing the fixed preview conversion. A `.odb` additionally browses its *structure* alongside its data: `f` from the table list opens the form browser and `r` the report browser, each listing what the database declares and opening one to show it in full — a form's own data source and field-bound controls (sub-forms nested under their parent), a report's data-source command, band and group structure, and every `rpt:` formula. Both are rendered through the same `src/odb-structure.ts` the `odb-forms`/`odb-reports` commands print, so the two views cannot drift apart, and search filters by line (`/SUM` narrows a long report to its aggregate expressions). `Enter` on a report's own detail screen renders it — its data-source command resolved, its `rpt:` formulas evaluated, its bands laid out — to a real `docx`/`odt`/`pdf` file, through the same two-field destination-path-then-font-list form the PDF-export screen below uses; the TUI counterpart to the `odb-render-report` command. A standalone `.odf` formula document has no TUI editor either — nothing to edit interactively, only a PDF conversion.
 
 The export-to-PDF screen (`e` from any editor screen) is a two-field form: a destination path, then an optional comma-separated list of local `.ttf`/`.otf` paths, which are the same `--font-file` faces the CLI takes and are derived the same way — each font's family, weight, and slope come from the file itself. `Enter` on the path field moves to the fonts field and `Enter` there exports, so leaving fonts empty is still "type a path, press Enter twice". Comma-separated rather than space-separated because a font path routinely contains spaces and almost never a comma. A face falling back to a substitute is reported into the same diagnostics panel a character substitution already is, and a bad font path fails the export with the file named, before anything is written to the destination.
 

package/dist/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { a as odbFormSummary, c as formatDocxExtrasLines, d as writeOutput, f as loadProvidedFonts, h as isDocumentFormat, i as formatOdbReportLines, l as readInput, m as inferFormatFromExtension, n as describeOdbReport, o as formatMetadataLines, r as formatOdbFormLines, s as presentMetadataEntries, t as describeOdbForm, u as resolveDefaultOutputPath } from "./odb-structure-DePnGZAI.js";
+import { a as odbFormSummary, c as formatDocxExtrasLines, d as writeOutput, f as loadProvidedFonts, h as isDocumentFormat, i as formatOdbReportLines, l as readInput, m as inferFormatFromExtension, n as describeOdbReport, o as formatMetadataLines, r as formatOdbFormLines, s as presentMetadataEntries, t as describeOdbForm, u as resolveDefaultOutputPath } from "./odb-structure-B1ygPCEa.js";
 import { Command, CommanderError, InvalidArgumentError } from "commander";
 import { writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, resolve } from "node:path";
-import { HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError, OdbNoEmbeddedDataSourceError, OdbReportNotSpecifiedError, OdbTableNotFoundError, OdbTableNotSpecifiedError, OdbUnsupportedFormatError, OdmUnresolvedSectionError, PdfEncryptedError, PdfParseError, UnrecognizedDocumentSchemaError, UnsupportedFontSourceFormatError, buildDocumentBytes, createLocalDocumentConverter, decodeOdbPackage, decodePackage, documentFromJson, documentPackageWithSchema, evaluateSelect, extractSourceFontsForFormat, hsqldbCellDisplayText, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
+import { CsvSheetNotFoundError, CsvSheetNotSpecifiedError, HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError, OdbNoEmbeddedDataSourceError, OdbReportNotSpecifiedError, OdbTableNotFoundError, OdbTableNotSpecifiedError, OdbUnsupportedFormatError, OdmUnresolvedSectionError, PdfEncryptedError, PdfParseError, SvgMultiPageNotSpecifiedError, SvgPageNotFoundError, UnrecognizedDocumentSchemaError, UnsupportedFontSourceFormatError, buildCsvText, buildDocumentBytes, buildSvgText, createLocalDocumentConverter, decodeOdbPackage, decodePackage, documentFromJson, documentPackageWithSchema, documentSchemaKindOf, encodeCsvText, encodeSvgText, evaluateSelect, extractSourceFontsForFormat, hsqldbCellDisplayText, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/runtime/abort.ts
 function combineSignals(a, b) {
@@ -113,7 +113,7 @@ function pdfDiagnosticToDiagnostic(diagnostic) {
 function mapErrorToExit(error, abortReason) {
 	if (abortReason === "interrupt") return 130;
 	if (abortReason === "timeout") return 124;
-	if (error instanceof OdmUnresolvedSectionError || error instanceof OdbTableNotSpecifiedError || error instanceof OdbTableNotFoundError || error instanceof OdbNoEmbeddedDataSourceError || error instanceof OdbUnsupportedFormatError || error instanceof OdbReportNotSpecifiedError) return 3;
+	if (error instanceof OdmUnresolvedSectionError || error instanceof OdbTableNotSpecifiedError || error instanceof OdbTableNotFoundError || error instanceof OdbNoEmbeddedDataSourceError || error instanceof OdbUnsupportedFormatError || error instanceof OdbReportNotSpecifiedError || error instanceof CsvSheetNotSpecifiedError || error instanceof CsvSheetNotFoundError || error instanceof SvgMultiPageNotSpecifiedError || error instanceof SvgPageNotFoundError) return 3;
 	if (error instanceof HsqldbSqlUnsupportedError || error instanceof HsqldbSqlParseError || error instanceof HsqldbSqlEvaluationError) return 1;
 	if (error instanceof UnsupportedFontSourceFormatError) return 2;
 	if (error instanceof PdfEncryptedError || error instanceof PdfParseError) return 1;
@@ -133,7 +133,7 @@ function createFilesystemMarkdownImageResolver(baseDir) {
 }
 //#endregion
 //#region src/commands/shared.ts
-const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, odf, markdown, pdf";
+const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, pdf";
 function resolveTargetFormat(output, out, to) {
 	if (to !== void 0) {
 		if (!isDocumentFormat(to)) return { errorMessage: `unknown --to format '${to}'; expected one of ${KNOWN_DOCUMENT_FORMATS}` };
@@ -176,7 +176,10 @@ function buildConversionAction(source, target) {
 					quiet: options.quiet,
 					command
 				}) : void 0,
-				images: createFilesystemMarkdownImageResolver(input === "-" ? "." : dirname(resolve(input)))
+				images: createFilesystemMarkdownImageResolver(input === "-" ? "." : dirname(resolve(input))),
+				delimiter: options.delimiter,
+				sheet: options.sheet,
+				page: options.page
 			});
 			await writeOutput(resolvedOutput, result.document.bytes);
 			const reporter = createDiagnosticReporter({
@@ -217,7 +220,7 @@ function addVerboseOption(command) {
 	return command.option("--verbose", "include a full stack trace when the run fails", false);
 }
 function addDumpPackageOption(command) {
-	return command.option("--dump-package <file>", "write the intermediate DocumentPackage (content + layout) this conversion built to a JSON file");
+	return command.option("--dump-package <file>", "write the intermediate DocumentPackage (content with its per-node layout frames + page sizes) this conversion built to a JSON file");
 }
 function collectFontFile(value, previous) {
 	return [...previous, value];
@@ -235,6 +238,15 @@ function addConversionFlags(command) {
 	addVerboseOption(command);
 	return command;
 }
+function addDelimiterOption(command) {
+	return command.option("--delimiter <char>", "field delimiter a csv source reads with, or a csv target writes with (default ',')");
+}
+function addSheetOption(command) {
+	return command.option("--sheet <name>", "the sheet a csv target writes, when the source document has more than one");
+}
+function addPageOption(command) {
+	return command.option("--page <index>", "the 0-based page an svg target draws, when the source document has more than one", (value) => Number.parseInt(value, 10));
+}
 //#endregion
 //#region src/commands/convert.ts
 function toConversionCommandOptions(options) {
@@ -246,7 +258,10 @@ function toConversionCommandOptions(options) {
 		verbose: options.verbose,
 		dumpPackage: options.dumpPackage,
 		fontFiles: options.fontFile,
-		reportFontSubstitutions: options.reportFontSubstitutions
+		reportFontSubstitutions: options.reportFontSubstitutions,
+		delimiter: options.delimiter,
+		sheet: options.sheet,
+		page: options.page
 	};
 }
 async function runGenericConvert(input, output, options) {
@@ -279,6 +294,9 @@ function registerConversionCommands(program) {
 		addConversionFlags(command);
 		addDumpPackageOption(command);
 		if (target === "pdf") addFontOptions(command);
+		if (source === "csv" || target === "csv") addDelimiterOption(command);
+		if (target === "csv") addSheetOption(command);
+		if (target === "svg") addPageOption(command);
 		command.action(async (input, output, options) => {
 			process.exitCode = await buildConversionAction(source, target)(input, output, toConversionCommandOptions(options));
 		});
@@ -287,6 +305,9 @@ function registerConversionCommands(program) {
 	addConversionFlags(generic);
 	addDumpPackageOption(generic);
 	addFontOptions(generic);
+	addDelimiterOption(generic);
+	addSheetOption(generic);
+	addPageOption(generic);
 	generic.option("--to <format>", `target format when it cannot be inferred from the output path (${KNOWN_DOCUMENT_FORMATS})`);
 	generic.action(async (input, output, options) => {
 		process.exitCode = await runGenericConvert(input, output, options);
@@ -374,6 +395,11 @@ function registerFormatsCommand(program) {
 }
 //#endregion
 //#region src/commands/from-package.ts
+function isFormatVersionOneRecord(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	if (!("formatVersion" in value)) return false;
+	return value.formatVersion === 1;
+}
 async function runFromPackage(input, output, options) {
 	const command = "from-package";
 	if (output !== void 0 && options.out !== void 0 && output !== options.out) {
@@ -397,12 +423,19 @@ async function runFromPackage(input, output, options) {
 			process.stderr.write(`[${command}] '${input}' is not valid JSON: ${error instanceof Error ? error.message : String(error)}\n`);
 			return 1;
 		}
+		if (documentSchemaKindOf(parsed) === "DocumentPackage" && isFormatVersionOneRecord(parsed)) {
+			process.stderr.write(`[${command}] '${input}' is a DocumentPackage dump at formatVersion 1 (the documents.js 1.x shape: content plus a separate layout half) -- documents.js 2.0.0 replaced it with formatVersion 2 (content carrying its own rendered frames, plus page sizes); re-run the source conversion with --dump-package to write a current dump\n`);
+			return 1;
+		}
 		const result = documentFromJson(parsed);
 		if (result.kind !== "DocumentPackage") {
 			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentPackage -- only a file written by --dump-package can be read back by this command\n`);
 			return 2;
 		}
-		const bytes = buildDocumentBytes(result.value, target.format);
+		const bytes = target.format === "csv" ? encodeCsvText(buildCsvText(result.value.content, {
+			delimiter: options.delimiter,
+			sheet: options.sheet
+		})) : target.format === "svg" ? encodeSvgText(buildSvgText(result.value.content, { page: options.page })) : buildDocumentBytes(result.value, target.format);
 		await writeOutput(resolvedOutput, bytes);
 		createDiagnosticReporter({
 			json: options.json,
@@ -430,6 +463,9 @@ function registerFromPackageCommand(program) {
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
+	addDelimiterOption(command);
+	addSheetOption(command);
+	addPageOption(command);
 	command.option("--to <format>", `target format when it cannot be inferred from the output path (${KNOWN_DOCUMENT_FORMATS})`);
 	command.action(async (input, output, options) => {
 		process.exitCode = await runFromPackage(input, output, options);
@@ -1059,12 +1095,12 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.14.115";
+var version = "2.1.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {
 	const program = new Command("document-cli");
-	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/markdown conversion, bridge, and inspector as a scriptable command");
+	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and inspector as a scriptable command");
 	program.version(version);
 	program.exitOverride((error) => {
 		process.exitCode = error.exitCode === 0 ? 0 : 2;
@@ -1086,7 +1122,7 @@ function createProgram() {
 //#region src/cli.ts
 async function launchTui(startPath, signal) {
 	try {
-		const { runTui } = await import("./tui-Bg4JfhRZ.js");
+		const { runTui } = await import("./tui-tT3An-cI.js");
 		await runTui({
 			startPath,
 			signal

package/dist/index.cjs

@@ -25,6 +25,8 @@ const EXTENSION_TO_FORMAT = {
 	otg: "odg",
 	odf: "odf",
 	otf: "odf",
+	csv: "csv",
+	svg: "svg",
 	markdown: "markdown",
 	md: "markdown",
 	pdf: "pdf"
@@ -38,6 +40,8 @@ const FORMAT_TO_EXTENSION = {
 	ods: "ods",
 	odg: "odg",
 	odf: "odf",
+	csv: "csv",
+	svg: "svg",
 	markdown: "md",
 	pdf: "pdf"
 };
@@ -172,7 +176,7 @@ const EXIT_INTERRUPTED = 130;
 function mapErrorToExit(error, abortReason) {
 	if (abortReason === "interrupt") return 130;
 	if (abortReason === "timeout") return 124;
-	if (error instanceof documents_js.OdmUnresolvedSectionError || error instanceof documents_js.OdbTableNotSpecifiedError || error instanceof documents_js.OdbTableNotFoundError || error instanceof documents_js.OdbNoEmbeddedDataSourceError || error instanceof documents_js.OdbUnsupportedFormatError || error instanceof documents_js.OdbReportNotSpecifiedError) return 3;
+	if (error instanceof documents_js.OdmUnresolvedSectionError || error instanceof documents_js.OdbTableNotSpecifiedError || error instanceof documents_js.OdbTableNotFoundError || error instanceof documents_js.OdbNoEmbeddedDataSourceError || error instanceof documents_js.OdbUnsupportedFormatError || error instanceof documents_js.OdbReportNotSpecifiedError || error instanceof documents_js.CsvSheetNotSpecifiedError || error instanceof documents_js.CsvSheetNotFoundError || error instanceof documents_js.SvgMultiPageNotSpecifiedError || error instanceof documents_js.SvgPageNotFoundError) return 3;
 	if (error instanceof documents_js.HsqldbSqlUnsupportedError || error instanceof documents_js.HsqldbSqlParseError || error instanceof documents_js.HsqldbSqlEvaluationError) return 1;
 	if (error instanceof documents_js.UnsupportedFontSourceFormatError) return 2;
 	if (error instanceof documents_js.PdfEncryptedError || error instanceof documents_js.PdfParseError) return 1;
@@ -247,7 +251,7 @@ function resolveDefaultOutputPath(inputPath, targetFormat) {
 }
 //#endregion
 //#region src/commands/shared.ts
-const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, odf, markdown, pdf";
+const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, pdf";
 function resolveTargetFormat(output, out, to) {
 	if (to !== void 0) {
 		if (!isDocumentFormat(to)) return { errorMessage: `unknown --to format '${to}'; expected one of ${KNOWN_DOCUMENT_FORMATS}` };
@@ -290,7 +294,10 @@ function buildConversionAction(source, target) {
 					quiet: options.quiet,
 					command
 				}) : void 0,
-				images: createFilesystemMarkdownImageResolver(input === "-" ? "." : (0, node_path.dirname)((0, node_path.resolve)(input)))
+				images: createFilesystemMarkdownImageResolver(input === "-" ? "." : (0, node_path.dirname)((0, node_path.resolve)(input))),
+				delimiter: options.delimiter,
+				sheet: options.sheet,
+				page: options.page
 			});
 			await writeOutput(resolvedOutput, result.document.bytes);
 			const reporter = createDiagnosticReporter({
@@ -331,7 +338,7 @@ function addVerboseOption(command) {
 	return command.option("--verbose", "include a full stack trace when the run fails", false);
 }
 function addDumpPackageOption(command) {
-	return command.option("--dump-package <file>", "write the intermediate DocumentPackage (content + layout) this conversion built to a JSON file");
+	return command.option("--dump-package <file>", "write the intermediate DocumentPackage (content with its per-node layout frames + page sizes) this conversion built to a JSON file");
 }
 function collectFontFile(value, previous) {
 	return [...previous, value];
@@ -349,6 +356,15 @@ function addConversionFlags(command) {
 	addVerboseOption(command);
 	return command;
 }
+function addDelimiterOption(command) {
+	return command.option("--delimiter <char>", "field delimiter a csv source reads with, or a csv target writes with (default ',')");
+}
+function addSheetOption(command) {
+	return command.option("--sheet <name>", "the sheet a csv target writes, when the source document has more than one");
+}
+function addPageOption(command) {
+	return command.option("--page <index>", "the 0-based page an svg target draws, when the source document has more than one", (value) => Number.parseInt(value, 10));
+}
 //#endregion
 //#region src/commands/convert.ts
 function toConversionCommandOptions(options) {
@@ -360,7 +376,10 @@ function toConversionCommandOptions(options) {
 		verbose: options.verbose,
 		dumpPackage: options.dumpPackage,
 		fontFiles: options.fontFile,
-		reportFontSubstitutions: options.reportFontSubstitutions
+		reportFontSubstitutions: options.reportFontSubstitutions,
+		delimiter: options.delimiter,
+		sheet: options.sheet,
+		page: options.page
 	};
 }
 async function runGenericConvert(input, output, options) {
@@ -393,6 +412,9 @@ function registerConversionCommands(program) {
 		addConversionFlags(command);
 		addDumpPackageOption(command);
 		if (target === "pdf") addFontOptions(command);
+		if (source === "csv" || target === "csv") addDelimiterOption(command);
+		if (target === "csv") addSheetOption(command);
+		if (target === "svg") addPageOption(command);
 		command.action(async (input, output, options) => {
 			process.exitCode = await buildConversionAction(source, target)(input, output, toConversionCommandOptions(options));
 		});
@@ -401,6 +423,9 @@ function registerConversionCommands(program) {
 	addConversionFlags(generic);
 	addDumpPackageOption(generic);
 	addFontOptions(generic);
+	addDelimiterOption(generic);
+	addSheetOption(generic);
+	addPageOption(generic);
 	generic.option("--to <format>", `target format when it cannot be inferred from the output path (${KNOWN_DOCUMENT_FORMATS})`);
 	generic.action(async (input, output, options) => {
 		process.exitCode = await runGenericConvert(input, output, options);
@@ -546,6 +571,11 @@ function registerFormatsCommand(program) {
 }
 //#endregion
 //#region src/commands/from-package.ts
+function isFormatVersionOneRecord(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	if (!("formatVersion" in value)) return false;
+	return value.formatVersion === 1;
+}
 async function runFromPackage(input, output, options) {
 	const command = "from-package";
 	if (output !== void 0 && options.out !== void 0 && output !== options.out) {
@@ -569,12 +599,19 @@ async function runFromPackage(input, output, options) {
 			process.stderr.write(`[${command}] '${input}' is not valid JSON: ${error instanceof Error ? error.message : String(error)}\n`);
 			return 1;
 		}
+		if ((0, documents_js.documentSchemaKindOf)(parsed) === "DocumentPackage" && isFormatVersionOneRecord(parsed)) {
+			process.stderr.write(`[${command}] '${input}' is a DocumentPackage dump at formatVersion 1 (the documents.js 1.x shape: content plus a separate layout half) -- documents.js 2.0.0 replaced it with formatVersion 2 (content carrying its own rendered frames, plus page sizes); re-run the source conversion with --dump-package to write a current dump\n`);
+			return 1;
+		}
 		const result = (0, documents_js.documentFromJson)(parsed);
 		if (result.kind !== "DocumentPackage") {
 			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentPackage -- only a file written by --dump-package can be read back by this command\n`);
 			return 2;
 		}
-		const bytes = (0, documents_js.buildDocumentBytes)(result.value, target.format);
+		const bytes = target.format === "csv" ? (0, documents_js.encodeCsvText)((0, documents_js.buildCsvText)(result.value.content, {
+			delimiter: options.delimiter,
+			sheet: options.sheet
+		})) : target.format === "svg" ? (0, documents_js.encodeSvgText)((0, documents_js.buildSvgText)(result.value.content, { page: options.page })) : (0, documents_js.buildDocumentBytes)(result.value, target.format);
 		await writeOutput(resolvedOutput, bytes);
 		createDiagnosticReporter({
 			json: options.json,
@@ -602,6 +639,9 @@ function registerFromPackageCommand(program) {
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
+	addDelimiterOption(command);
+	addSheetOption(command);
+	addPageOption(command);
 	command.option("--to <format>", `target format when it cannot be inferred from the output path (${KNOWN_DOCUMENT_FORMATS})`);
 	command.action(async (input, output, options) => {
 		process.exitCode = await runFromPackage(input, output, options);
@@ -1387,12 +1427,12 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.14.115";
+var version = "2.1.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {
 	const program = new commander.Command("document-cli");
-	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/markdown conversion, bridge, and inspector as a scriptable command");
+	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and inspector as a scriptable command");
 	program.version(version);
 	program.exitOverride((error) => {
 		process.exitCode = error.exitCode === 0 ? 0 : 2;

package/dist/index.d.cts

@@ -15,6 +15,9 @@ interface ConversionCommandOptions {
   readonly dumpPackage?: string;
   readonly fontFiles?: readonly string[];
   readonly reportFontSubstitutions?: boolean;
+  readonly delimiter?: string;
+  readonly sheet?: string;
+  readonly page?: number;
 }
 declare function formatError(error: unknown, verbose: boolean): string;
 declare function buildConversionAction(source: DocumentFormat, target: DocumentFormat): (input: string, output: string | undefined, options: ConversionCommandOptions) => Promise<number>;

package/dist/index.d.ts

@@ -15,6 +15,9 @@ interface ConversionCommandOptions {
   readonly dumpPackage?: string;
   readonly fontFiles?: readonly string[];
   readonly reportFontSubstitutions?: boolean;
+  readonly delimiter?: string;
+  readonly sheet?: string;
+  readonly page?: number;
 }
 declare function formatError(error: unknown, verbose: boolean): string;
 declare function buildConversionAction(source: DocumentFormat, target: DocumentFormat): (input: string, output: string | undefined, options: ConversionCommandOptions) => Promise<number>;

package/dist/index.js

@@ -1,6 +1,6 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, resolve } from "node:path";
-import { HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError, OdbNoEmbeddedDataSourceError, OdbReportNotSpecifiedError, OdbTableNotFoundError, OdbTableNotSpecifiedError, OdbUnsupportedFormatError, OdmUnresolvedSectionError, PdfEncryptedError, PdfParseError, UnrecognizedDocumentSchemaError, UnsupportedFontSourceFormatError, buildDocumentBytes, createLocalDocumentConverter, decodeOdbPackage, decodePackage, describeFontFace, documentFromJson, documentPackageWithSchema, evaluateSelect, extractSourceFontsForFormat, hsqldbCellDisplayText, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
+import { CsvSheetNotFoundError, CsvSheetNotSpecifiedError, HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError, OdbNoEmbeddedDataSourceError, OdbReportNotSpecifiedError, OdbTableNotFoundError, OdbTableNotSpecifiedError, OdbUnsupportedFormatError, OdmUnresolvedSectionError, PdfEncryptedError, PdfParseError, SvgMultiPageNotSpecifiedError, SvgPageNotFoundError, UnrecognizedDocumentSchemaError, UnsupportedFontSourceFormatError, buildCsvText, buildDocumentBytes, buildSvgText, createLocalDocumentConverter, decodeOdbPackage, decodePackage, describeFontFace, documentFromJson, documentPackageWithSchema, documentSchemaKindOf, encodeCsvText, encodeSvgText, evaluateSelect, extractSourceFontsForFormat, hsqldbCellDisplayText, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
 import { existsSync, readFileSync } from "node:fs";
 import { Command, InvalidArgumentError } from "commander";
 //#region src/format.ts
@@ -24,6 +24,8 @@ const EXTENSION_TO_FORMAT = {
 	otg: "odg",
 	odf: "odf",
 	otf: "odf",
+	csv: "csv",
+	svg: "svg",
 	markdown: "markdown",
 	md: "markdown",
 	pdf: "pdf"
@@ -37,6 +39,8 @@ const FORMAT_TO_EXTENSION = {
 	ods: "ods",
 	odg: "odg",
 	odf: "odf",
+	csv: "csv",
+	svg: "svg",
 	markdown: "md",
 	pdf: "pdf"
 };
@@ -171,7 +175,7 @@ const EXIT_INTERRUPTED = 130;
 function mapErrorToExit(error, abortReason) {
 	if (abortReason === "interrupt") return 130;
 	if (abortReason === "timeout") return 124;
-	if (error instanceof OdmUnresolvedSectionError || error instanceof OdbTableNotSpecifiedError || error instanceof OdbTableNotFoundError || error instanceof OdbNoEmbeddedDataSourceError || error instanceof OdbUnsupportedFormatError || error instanceof OdbReportNotSpecifiedError) return 3;
+	if (error instanceof OdmUnresolvedSectionError || error instanceof OdbTableNotSpecifiedError || error instanceof OdbTableNotFoundError || error instanceof OdbNoEmbeddedDataSourceError || error instanceof OdbUnsupportedFormatError || error instanceof OdbReportNotSpecifiedError || error instanceof CsvSheetNotSpecifiedError || error instanceof CsvSheetNotFoundError || error instanceof SvgMultiPageNotSpecifiedError || error instanceof SvgPageNotFoundError) return 3;
 	if (error instanceof HsqldbSqlUnsupportedError || error instanceof HsqldbSqlParseError || error instanceof HsqldbSqlEvaluationError) return 1;
 	if (error instanceof UnsupportedFontSourceFormatError) return 2;
 	if (error instanceof PdfEncryptedError || error instanceof PdfParseError) return 1;
@@ -246,7 +250,7 @@ function resolveDefaultOutputPath(inputPath, targetFormat) {
 }
 //#endregion
 //#region src/commands/shared.ts
-const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, odf, markdown, pdf";
+const KNOWN_DOCUMENT_FORMATS = "docx, pptx, xlsx, odt, odp, ods, odg, svg, odf, csv, markdown, pdf";
 function resolveTargetFormat(output, out, to) {
 	if (to !== void 0) {
 		if (!isDocumentFormat(to)) return { errorMessage: `unknown --to format '${to}'; expected one of ${KNOWN_DOCUMENT_FORMATS}` };
@@ -289,7 +293,10 @@ function buildConversionAction(source, target) {
 					quiet: options.quiet,
 					command
 				}) : void 0,
-				images: createFilesystemMarkdownImageResolver(input === "-" ? "." : dirname(resolve(input)))
+				images: createFilesystemMarkdownImageResolver(input === "-" ? "." : dirname(resolve(input))),
+				delimiter: options.delimiter,
+				sheet: options.sheet,
+				page: options.page
 			});
 			await writeOutput(resolvedOutput, result.document.bytes);
 			const reporter = createDiagnosticReporter({
@@ -330,7 +337,7 @@ function addVerboseOption(command) {
 	return command.option("--verbose", "include a full stack trace when the run fails", false);
 }
 function addDumpPackageOption(command) {
-	return command.option("--dump-package <file>", "write the intermediate DocumentPackage (content + layout) this conversion built to a JSON file");
+	return command.option("--dump-package <file>", "write the intermediate DocumentPackage (content with its per-node layout frames + page sizes) this conversion built to a JSON file");
 }
 function collectFontFile(value, previous) {
 	return [...previous, value];
@@ -348,6 +355,15 @@ function addConversionFlags(command) {
 	addVerboseOption(command);
 	return command;
 }
+function addDelimiterOption(command) {
+	return command.option("--delimiter <char>", "field delimiter a csv source reads with, or a csv target writes with (default ',')");
+}
+function addSheetOption(command) {
+	return command.option("--sheet <name>", "the sheet a csv target writes, when the source document has more than one");
+}
+function addPageOption(command) {
+	return command.option("--page <index>", "the 0-based page an svg target draws, when the source document has more than one", (value) => Number.parseInt(value, 10));
+}
 //#endregion
 //#region src/commands/convert.ts
 function toConversionCommandOptions(options) {
@@ -359,7 +375,10 @@ function toConversionCommandOptions(options) {
 		verbose: options.verbose,
 		dumpPackage: options.dumpPackage,
 		fontFiles: options.fontFile,
-		reportFontSubstitutions: options.reportFontSubstitutions
+		reportFontSubstitutions: options.reportFontSubstitutions,
+		delimiter: options.delimiter,
+		sheet: options.sheet,
+		page: options.page
 	};
 }
 async function runGenericConvert(input, output, options) {
@@ -392,6 +411,9 @@ function registerConversionCommands(program) {
 		addConversionFlags(command);
 		addDumpPackageOption(command);
 		if (target === "pdf") addFontOptions(command);
+		if (source === "csv" || target === "csv") addDelimiterOption(command);
+		if (target === "csv") addSheetOption(command);
+		if (target === "svg") addPageOption(command);
 		command.action(async (input, output, options) => {
 			process.exitCode = await buildConversionAction(source, target)(input, output, toConversionCommandOptions(options));
 		});
@@ -400,6 +422,9 @@ function registerConversionCommands(program) {
 	addConversionFlags(generic);
 	addDumpPackageOption(generic);
 	addFontOptions(generic);
+	addDelimiterOption(generic);
+	addSheetOption(generic);
+	addPageOption(generic);
 	generic.option("--to <format>", `target format when it cannot be inferred from the output path (${KNOWN_DOCUMENT_FORMATS})`);
 	generic.action(async (input, output, options) => {
 		process.exitCode = await runGenericConvert(input, output, options);
@@ -545,6 +570,11 @@ function registerFormatsCommand(program) {
 }
 //#endregion
 //#region src/commands/from-package.ts
+function isFormatVersionOneRecord(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	if (!("formatVersion" in value)) return false;
+	return value.formatVersion === 1;
+}
 async function runFromPackage(input, output, options) {
 	const command = "from-package";
 	if (output !== void 0 && options.out !== void 0 && output !== options.out) {
@@ -568,12 +598,19 @@ async function runFromPackage(input, output, options) {
 			process.stderr.write(`[${command}] '${input}' is not valid JSON: ${error instanceof Error ? error.message : String(error)}\n`);
 			return 1;
 		}
+		if (documentSchemaKindOf(parsed) === "DocumentPackage" && isFormatVersionOneRecord(parsed)) {
+			process.stderr.write(`[${command}] '${input}' is a DocumentPackage dump at formatVersion 1 (the documents.js 1.x shape: content plus a separate layout half) -- documents.js 2.0.0 replaced it with formatVersion 2 (content carrying its own rendered frames, plus page sizes); re-run the source conversion with --dump-package to write a current dump\n`);
+			return 1;
+		}
 		const result = documentFromJson(parsed);
 		if (result.kind !== "DocumentPackage") {
 			process.stderr.write(`[${command}] '${input}' is a ${result.kind}, not a DocumentPackage -- only a file written by --dump-package can be read back by this command\n`);
 			return 2;
 		}
-		const bytes = buildDocumentBytes(result.value, target.format);
+		const bytes = target.format === "csv" ? encodeCsvText(buildCsvText(result.value.content, {
+			delimiter: options.delimiter,
+			sheet: options.sheet
+		})) : target.format === "svg" ? encodeSvgText(buildSvgText(result.value.content, { page: options.page })) : buildDocumentBytes(result.value, target.format);
 		await writeOutput(resolvedOutput, bytes);
 		createDiagnosticReporter({
 			json: options.json,
@@ -601,6 +638,9 @@ function registerFromPackageCommand(program) {
 	addJsonOption(command);
 	addQuietOption(command);
 	addVerboseOption(command);
+	addDelimiterOption(command);
+	addSheetOption(command);
+	addPageOption(command);
 	command.option("--to <format>", `target format when it cannot be inferred from the output path (${KNOWN_DOCUMENT_FORMATS})`);
 	command.action(async (input, output, options) => {
 		process.exitCode = await runFromPackage(input, output, options);
@@ -1386,12 +1426,12 @@ function registerSetMetadataCommand(program) {
 }
 //#endregion
 //#region package.json
-var version = "1.14.115";
+var version = "2.1.0";
 //#endregion
 //#region src/program.ts
 function createProgram() {
 	const program = new Command("document-cli");
-	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/markdown conversion, bridge, and inspector as a scriptable command");
+	program.description("every documents.js docx/pptx/odt/odp/ods/odg/odf/pdf/odm/odb/xlsx/csv/svg/markdown conversion, bridge, and inspector as a scriptable command");
 	program.version(version);
 	program.exitOverride((error) => {
 		process.exitCode = error.exitCode === 0 ? 0 : 2;

package/dist/{odb-structure-DePnGZAI.js → odb-structure-B1ygPCEa.js}

@@ -22,6 +22,8 @@ const EXTENSION_TO_FORMAT = {
 	otg: "odg",
 	odf: "odf",
 	otf: "odf",
+	csv: "csv",
+	svg: "svg",
 	markdown: "markdown",
 	md: "markdown",
 	pdf: "pdf"
@@ -35,6 +37,8 @@ const FORMAT_TO_EXTENSION = {
 	ods: "ods",
 	odg: "odg",
 	odf: "odf",
+	csv: "csv",
+	svg: "svg",
 	markdown: "md",
 	pdf: "pdf"
 };

package/dist/{tui-Bg4JfhRZ.js → tui-tT3An-cI.js}

@@ -1,7 +1,7 @@
-import { c as formatDocxExtrasLines, f as loadProvidedFonts, i as formatOdbReportLines, l as readInput, m as inferFormatFromExtension, n as describeOdbReport, o as formatMetadataLines, p as formatToExtension, r as formatOdbFormLines, t as describeOdbForm } from "./odb-structure-DePnGZAI.js";
+import { c as formatDocxExtrasLines, f as loadProvidedFonts, i as formatOdbReportLines, l as readInput, m as inferFormatFromExtension, n as describeOdbReport, o as formatMetadataLines, p as formatToExtension, r as formatOdbFormLines, t as describeOdbForm } from "./odb-structure-B1ygPCEa.js";
 import { readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join } from "node:path";
-import { bytesToBase64, cellReference, columnIndexToLetters, createDocx, createOdg, createOdp, createOds, createOdt, createPdf, createPptx, decodeMarkdownText, decodeOdbPackage, docxToPdf, encodeMarkdownText, hsqldbCellDisplayText, markdownToPdf, odbReportToDocx, odbReportToOdt, odbReportToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openMarkdown, openOdg, openOdp, openOds, openOdt, openPdf, openPptx, parseXml, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, xlsxToPdf } from "documents.js";
+import { bytesToBase64, cellReference, columnIndexToLetters, createDocx, createOdg, createOdp, createOds, createOdt, createPdf, createPptx, csvToPdf, decodeMarkdownText, decodeOdbPackage, docxToPdf, encodeMarkdownText, hsqldbCellDisplayText, markdownToPdf, odbReportToDocx, odbReportToOdt, odbReportToPdf, odgToPdf, odpToPdf, odsToPdf, odtToPdf, openDocx, openMarkdown, openOdg, openOdp, openOds, openOdt, openPdf, openPptx, parseXml, pptxToPdf, readDocxContent, readDocxExtras, readMarkdownContent, readOdbForms, readOdbReportContent, readOdbReports, readOdbTables, readOdgContent, readOdpContent, readOdsContent, readOdtContent, readPdf, readPptxContent, rgbHexToColor, svgToPdf, xlsxToPdf } from "documents.js";
 import { readdirSync } from "node:fs";
 import { Box, Text, render, useApp, useInput, useWindowSize } from "ink";
 import { createContext, useContext, useEffect, useReducer, useState } from "react";
@@ -47,6 +47,16 @@ async function exportToPdf(openDocument, destinationPath, options) {
 		await writeFile(destinationPath, pdfBytes);
 		return;
 	}
+	if (openDocument.format === "csv") {
+		const pdfBytes = csvToPdf(openDocument.bytes, pdfOptions);
+		await writeFile(destinationPath, pdfBytes);
+		return;
+	}
+	if (openDocument.format === "svg") {
+		const pdfBytes = svgToPdf(openDocument.bytes, pdfOptions);
+		await writeFile(destinationPath, pdfBytes);
+		return;
+	}
 	const bytes = openDocument.editor.toBytes();
 	const pdfBytes = convert(openDocument.format, bytes, pdfOptions);
 	await writeFile(destinationPath, pdfBytes);
@@ -148,6 +158,18 @@ async function openDocumentAtPath(path, options = {}) {
 			bytes,
 			path
 		};
+		case "csv": return {
+			format,
+			layout: readPdf(csvToPdf(bytes)),
+			bytes,
+			path
+		};
+		case "svg": return {
+			format,
+			layout: readPdf(svgToPdf(bytes)),
+			bytes,
+			path
+		};
 		case "odf": throw new Error("A standalone .odf formula document has no editor; convert it to PDF (odfToPdf) instead");
 	}
 }
@@ -195,7 +217,7 @@ function createNewDocument(format) {
 	}
 }
 async function saveDocumentTo(openDocument, path) {
-	if (openDocument.format === "odb" || openDocument.format === "xlsx") throw new Error(`A ${openDocument.format} document is opened read-only and cannot be written back`);
+	if (openDocument.format === "odb" || openDocument.format === "xlsx" || openDocument.format === "csv" || openDocument.format === "svg") throw new Error(`A ${openDocument.format} document is opened read-only and cannot be written back`);
 	if (openDocument.format === "markdown") {
 		await writeFile(path, encodeMarkdownText(openDocument.editor.toMarkdownText()));
 		return;
@@ -277,7 +299,9 @@ function rootScreenForFormat(format) {
 		case "odg": return { kind: "pageList" };
 		case "odb": return { kind: "odbTableList" };
 		case "pdf":
-		case "xlsx": return { kind: "pdfPageList" };
+		case "xlsx":
+		case "csv":
+		case "svg": return { kind: "pdfPageList" };
 	}
 }
 function currentScreen(state) {
@@ -414,6 +438,18 @@ function documentWithPath(doc, path) {
 			bytes: doc.bytes,
 			path
 		};
+		case "csv": return {
+			format: "csv",
+			layout: doc.layout,
+			bytes: doc.bytes,
+			path
+		};
+		case "svg": return {
+			format: "svg",
+			layout: doc.layout,
+			bytes: doc.bytes,
+			path
+		};
 	}
 }
 function reopenEditable(doc, bytes) {
@@ -731,7 +767,7 @@ function appReducer(state, action) {
 			selection: {},
 			errorDetail: void 0,
 			stack: [rootScreenForFormat(action.doc.format)]
-		}, "info", action.doc.format === "xlsx" ? `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" ? `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: {
@@ -1317,7 +1353,7 @@ function appReducer(state, action) {
 		case "UNDO": {
 			const doc = state.openDocument;
 			if (doc === void 0) return withStatus(state, "info", "There is nothing to undo");
-			if (doc.format === "odb" || doc.format === "xlsx") return withStatus(state, "warning", `A ${doc.format} document is read-only, so it has no history to undo`);
+			if (doc.format === "odb" || doc.format === "xlsx" || doc.format === "csv" || doc.format === "svg") return withStatus(state, "warning", `A ${doc.format} document is read-only, so it has no history to undo`);
 			const snapshot = state.undoStack.at(-1);
 			if (snapshot === void 0) return withStatus(state, "info", "There is nothing to undo");
 			const restored = doc.format === "markdown" ? {
@@ -7149,7 +7185,7 @@ function OdtBodyListScreen() {
 //#endregion
 //#region src/tui/screens/editors/pdf/shared.ts
 function requirePdfDocument(openDocument) {
-	if (openDocument?.format !== "pdf" && openDocument?.format !== "xlsx") throw new Error("A PDF inspection screen rendered without an open PDF or xlsx document; the app router only reaches this screen group from pdfPageList, which is only ever the root screen of one of those two formats.");
+	if (openDocument?.format !== "pdf" && openDocument?.format !== "xlsx" && openDocument?.format !== "csv" && openDocument?.format !== "svg") throw new Error("A PDF inspection screen rendered without an open PDF, xlsx, csv, or svg document; the app router only reaches this screen group from pdfPageList, which is only ever the root screen of one of those four formats.");
 	return openDocument;
 }
 function isEditablePdfDocument(doc) {
@@ -8712,7 +8748,7 @@ function LauncherScreen() {
 			}),
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
-				children: "A terminal editor for docx, pptx, odt, odp, ods, odg, markdown, odb and pdf -- xlsx opens as a read-only PDF preview."
+				children: "A terminal editor for docx, pptx, odt, odp, ods, odg, markdown, odb and pdf -- xlsx, csv and svg open as read-only PDF previews."
 			}),
 			/* @__PURE__ */ jsx(Text, { children: " " }),
 			/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
@@ -8877,7 +8913,9 @@ function metadataFor(doc) {
 		case "odg": return readOdgContent(doc.editor.toPackage()).metadata;
 		case "markdown": return readMarkdownContent(doc.editor.toMarkdownText()).metadata;
 		case "pdf":
-		case "xlsx": return doc.layout.metadata;
+		case "xlsx":
+		case "csv":
+		case "svg": return doc.layout.metadata;
 		case "odb": throw new Error("A .odb database has no document-level metadata -- it is a table/form/report container, not a single document with its own title/author/etc.");
 	}
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "document-cli",
-  "version": "1.14.115",
-  "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.",
+  "version": "2.1.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 conversion, bridge, and editor as a scriptable command or a terminal app.",
   "type": "module",
   "repository": {
     "type": "git",
@@ -88,7 +88,7 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "commander": "^15.0.0",
-    "documents.js": "^1.102.0",
+    "documents.js": "^2.3.0",
     "ink": "^7.1.1",
     "ink-text-input": "^6.0.0",
     "react": "^19.2.8"