js.documents 14.1.0 → 14.1.1

package/README.md

@@ -167,13 +167,13 @@ const pdfFromOdg = odgToPdf(odgBytes);
 const odgBytes2 = pdfToOdg(pdfFromOdg);
 
 const pdfFromOds = odsToPdf(odsBytes);
-const odsBytes2 = pdfToOds(pdfFromOds); // recovers what was printed, then heuristically re-types it -- see Fidelity
+const odsBytes2 = pdfToOds(pdfFromOds); // recovers what was printed, then heuristically re-types it — see Fidelity
 
 const pdfFromXlsx = xlsxToPdf(xlsxBytes); // composes xlsxToOds -> odsToPdf internally
 const xlsxBytes2 = pdfToXlsx(pdfFromXlsx); // composes pdfToOds -> odsToXlsx internally
 
 const pdfFromMarkdown = markdownToPdf(markdownBytes);
-const markdownBytes2 = pdfToMarkdown(pdfFromMarkdown); // the lossiest conversion in the whole package -- see Fidelity; it does carry page boundaries (one '<!-- page break -->' marker per page) and rank-inferred heading levels
+const markdownBytes2 = pdfToMarkdown(pdfFromMarkdown); // the lossiest conversion in the whole package — see Fidelity; it does carry page boundaries (one '<!-- page break -->' marker per page) and rank-inferred heading levels
 
 const pdfFromCsv = csvToPdf(csvBytes); // composes csvToOds -> odsToPdf internally
 const csvBytes2 = pdfToCsv(pdfFromCsv); // composes pdfToOds -> odsToCsv internally; recovers what was printed, then heuristically re-types it
@@ -214,7 +214,7 @@ const docxBytes = odtToDocx(odtBytes);
 const odtBytes2 = docxToOdt(docxBytes);
 
 const docxFromMarkdown = markdownToDocx(markdownBytes);
-const markdownBytes3 = docxToMarkdown(docxFromMarkdown); // colour, font family/size, and explicit alignment have no markdown source construct -- dropped on this hop
+const markdownBytes3 = docxToMarkdown(docxFromMarkdown); // colour, font family/size, and explicit alignment have no markdown source construct — dropped on this hop
 ```
 
 Each takes an optional `{ signal }` — no `onSubstitution`/`sink`, since there is no font substitution or PDF-parse degradation. `odtToDocx`/`markdownToDocx`/`docxToOdt`/`docxToMarkdown` additionally take `onMathDiagnostic`, called per formula construct that degraded crossing the bridge. The csv-sourced bridges (`csvToOds`, `csvToXlsx`, `csvToMarkdown`, `csvToPdf`) take `{ delimiter }` — `'\t'` parses the same format as TSV, since a delimiter is a parse option, not a different document format — and `onCellTypeInference`, the per-decision audit channel the read shares with `pdfToOds`. The csv-target bridges (`odsToCsv`, `xlsxToCsv`, `markdownToCsv`, `pdfToCsv`) take `{ delimiter, sheet }`: csv has no second sheet, so writing a multi-sheet source refuses with `CsvSheetNotSpecifiedError` naming every sheet until a caller selects one. The svg-sourced bridges (`svgToOdg`, `svgToPdf`) take `onSvgDiagnostic`, the reader's per-scope-limit channel; the svg-target bridges (`odgToSvg`, `pdfToSvg`) take `{ page, onSvgDiagnostic }`: an svg is a single drawing, so writing a multi-page source refuses with `SvgMultiPageNotSpecifiedError` naming the page count until `{ page }` selects one (an index, because drawing pages are anonymous where sheets are named).
@@ -254,7 +254,7 @@ import { docxToPdf } from "documents.js";
 
 const pdfBytes = docxToPdf(docxBytes, {
   onDocument: (pkg) => {
-    console.log(pkg.kind); // 'wordprocessing' -- the document kind rides the tree's root
+    console.log(pkg.kind); // 'wordprocessing' — the document kind rides the tree's root
     console.log(pkg.pages?.length); // populated for every X-to-PDF/PDF-to-X conversion
     const content = flattenTree(pkg); // the flat ContentDocument, fully materialised
     const block =
@@ -358,7 +358,7 @@ const patchedBytes = setDocumentMetadata("docx", "docx", docxBytes, {
 import { readNativeDocumentTree } from "documents.js";
 
 const tree = readNativeDocumentTree("xlsx", xlsxBytes);
-console.log(tree.kind); // 'spreadsheet' -- the workbook's own shape, never a projection through some other target
+console.log(tree.kind); // 'spreadsheet' — the workbook's own shape, never a projection through some other target
 ```
 
 Every module under `src/` is deep-importable by package-relative path:
@@ -525,7 +525,7 @@ page.addPath({
     },
   ],
   fill: { r: 1, g: 1, b: 0 },
-}); // a genuine Bezier curve -- writes a real svg:d/svg:viewBox pair, not a polygon approximation
+}); // a genuine Bezier curve — writes a real svg:d/svg:viewBox pair, not a polygon approximation
 page.addTextBox({
   frame: { xPt: 20, yPt: 200, widthPt: 300, heightPt: 30 },
   text: "A label on top",
@@ -802,7 +802,7 @@ The package is layered from generic primitives outward to the two conversion dir
 - **`src/omml/`** — the MathML ⇄ OMML structural translator, both directions. `write.ts` covers the identical construct set `src/mathml/layout.ts` typesets; `read.ts` covers strictly more (reads what Word authored, not just what this package writes). Lives outside `src/mathml/` because its I/O type is `ooxml.js`'s `XmlElement` and `src/mathml/` imports no package.
 - **`src/ooxml/`** — thin adapters over `ooxml.js`'s own flat `readDocxContent`/`readPptxContent` readers, wrapping results into `ContentDocument`. `docx/formula.ts` is the one local reading pass (splicing OOXML math equations). `docx/extras.ts`'s `readDocxExtras` returns comments/footnotes/header-footer parts, section header/footer references, and numbering.
 - **`src/odf/`** — ODF-side counterparts: `readOdtContent`/`readOdpContent`/`readOdsContent`/`readOdgContent` are thin adapters over `odf.js`. `formula/read.ts`/`formula/detect.ts` handle embedded formula detection (genuinely new work with no `odf.js`-side equivalent).
-- **`src/ppt/`** — the one legacy-binary-format adapter with a genuine wrap of its own: `ppt-codec`'s `readPptContent`/`writePptContent` operate on the flat `{ metadata, slides }` shape (mirroring `ooxml.js`'s/`odf.js`'s own upstream flat readers), not a full `'presentation'`-kind `ContentDocument` directly, so `read.ts`/`write.ts` do the envelope wrap/unwrap `src/ooxml/pptx/read.ts`/`src/odf/odp/read.ts` also do for their own formats -- minus the formula/vector-recovery passes those two run, since `ppt-codec` has no upstream equivalent to splice in. `doc` and `xls` need no equivalent module: `doc-codec`'s `readDocContent`/`writeDocContent` and `xls-codec`'s `readXlsContent`/`writeXlsContent` already read/write a real `ContentDocument` directly (the latter over `XlsContentDocument`, a plain narrowed alias), so both are called straight from `src/codecs/read.ts`/`src/codecs/registry.ts`/`src/convert/composition.ts`, exactly like `rtf-codec`'s own pair.
+- **`src/ppt/`** — the one legacy-binary-format adapter with a genuine wrap of its own: `ppt-codec`'s `readPptContent`/`writePptContent` operate on the flat `{ metadata, slides }` shape (mirroring `ooxml.js`'s/`odf.js`'s own upstream flat readers), not a full `'presentation'`-kind `ContentDocument` directly, so `read.ts`/`write.ts` do the envelope wrap/unwrap `src/ooxml/pptx/read.ts`/`src/odf/odp/read.ts` also do for their own formats — minus the formula/vector-recovery passes those two run, since `ppt-codec` has no upstream equivalent to splice in. `doc` and `xls` need no equivalent module: `doc-codec`'s `readDocContent`/`writeDocContent` and `xls-codec`'s `readXlsContent`/`writeXlsContent` already read/write a real `ContentDocument` directly (the latter over `XlsContentDocument`, a plain narrowed alias), so both are called straight from `src/codecs/read.ts`/`src/codecs/registry.ts`/`src/convert/composition.ts`, exactly like `rtf-codec`'s own pair.
 - **`src/latex/`** — the LaTeX presentation → `MathExpression` lowering: `temml.ts` is the pinned-parser boundary (exact-version temml, its internal parse API guarded behind structural type guards), `lower.ts` the mechanical rules and their degradations, `symbols.ts` the glyph/command map and the prose definition scanner, `rational.ts` the exact-rational helpers, `lint.ts` the coherence lint. See [LaTeX lowering into the semantic core](#latex-lowering-into-the-semantic-core).
 - **`src/markdown/`** — third adapter family, via `markdown-codec`. `readMarkdownContent` passes `readMarkdownContent`'s (markdown-codec's flat reader, so named since that package's 4.0.0; the bare `readMarkdown` name is now its tree-form `DocumentTree` reader) result through the math-lowering pass (`math.ts` — markdown-codec's preserved `$$` display blocks and `\( \)` inline spans become two-layer formula blocks, with the document's symbol table seeded from its own prose). `buildMarkdownText` wraps `writeMarkdownContent`, reconstructing markdown math syntax from formula blocks carrying a presentation layer. `text.ts` is the byte↔text boundary. `MarkdownEditor` holds a mutable in-memory `ContentDocument`.
 - **`src/csv/`** — fourth adapter family, sharing the spreadsheet variant with xlsx/ods. `records.ts` is the RFC 4180 record parser/writer (one shared `quoteCsvField`, also used by the `.odb` CSV exporter); `text.ts` is the byte↔text boundary, working the character encoding out from the bytes through [byte-codec](../byte-codec/README.md#text-decoding) rather than assuming UTF-8, so Excel's own windows-1252 export reads, and refusing bytes that are not text at all; `read.ts` turns records into a spreadsheet `ContentDocument` (first record as verbatim string header, data cells through the same cell-typing heuristic `pdfToOds` uses); `write.ts` turns one sheet of a spreadsheet `ContentDocument` back into records via each cell's `displayText`. TSV is the same format with `{ delimiter: '\t' }` on either side.
@@ -825,7 +825,7 @@ pnpm build         # turbo run _build (tsdown -> dist/ (ESM + CJS + .d.ts))
 pnpm typecheck     # turbo run _typecheck _typecheck:node
 pnpm lint          # turbo run _lint (eslint . --fix --cache --max-warnings 0)
 pnpm test          # turbo run _test (vitest run --project unit)
-pnpm test:workers  # turbo run _test:workers (vitest run --config vitest.workers.config.ts -- Cloudflare Workers runtime)
+pnpm test:workers  # turbo run _test:workers (vitest run --config vitest.workers.config.ts — Cloudflare Workers runtime)
 pnpm test:watch    # vitest --project unit
 pnpm test:smoke    # turbo run _test:smoke (rebuilds dist/, verifies ESM/CJS parity, real round trips across all conversions, font resolution, from the built CJS bundle)
 ```

package/dist/bin-dispatch.cjs

@@ -26,7 +26,7 @@ function detectPackageManager(userAgent) {
 	return "npm";
 }
 /**
-* Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice -- the same "dispatcher reserves a subcommand name" model `git` uses.
+* Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice — the same "dispatcher reserves a subcommand name" model `git` uses.
 */
 function resolveBinDispatch(argv, userAgent) {
 	const head = argv[0];

package/dist/bin-dispatch.d.cts

@@ -2,13 +2,13 @@
 interface BinDispatch {
   /** The npm package the launcher resolves and invokes. */
   readonly pkg: "document-cli" | "document-mcp";
-  /** The executable to spawn -- each JS package manager's own download-and-run command. */
+  /** The executable to spawn — each JS package manager's own download-and-run command. */
   readonly command: "npx" | "pnpm" | "yarn" | "bunx";
-  /** Arguments after the command itself -- begins with the manager's fetch flags, then the package name, then the passthrough args. */
+  /** Arguments after the command itself — begins with the manager's fetch flags, then the package name, then the passthrough args. */
   readonly runnerArgs: readonly string[];
 }
 /**
- * Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice -- the same "dispatcher reserves a subcommand name" model `git` uses.
+ * Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice — the same "dispatcher reserves a subcommand name" model `git` uses.
  */
 declare function resolveBinDispatch(argv: readonly string[], userAgent: string | undefined): BinDispatch;
 //#endregion

package/dist/bin-dispatch.d.ts

@@ -2,13 +2,13 @@
 interface BinDispatch {
   /** The npm package the launcher resolves and invokes. */
   readonly pkg: "document-cli" | "document-mcp";
-  /** The executable to spawn -- each JS package manager's own download-and-run command. */
+  /** The executable to spawn — each JS package manager's own download-and-run command. */
   readonly command: "npx" | "pnpm" | "yarn" | "bunx";
-  /** Arguments after the command itself -- begins with the manager's fetch flags, then the package name, then the passthrough args. */
+  /** Arguments after the command itself — begins with the manager's fetch flags, then the package name, then the passthrough args. */
   readonly runnerArgs: readonly string[];
 }
 /**
- * Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice -- the same "dispatcher reserves a subcommand name" model `git` uses.
+ * Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice — the same "dispatcher reserves a subcommand name" model `git` uses.
  */
 declare function resolveBinDispatch(argv: readonly string[], userAgent: string | undefined): BinDispatch;
 //#endregion

package/dist/bin-dispatch.js

@@ -25,7 +25,7 @@ function detectPackageManager(userAgent) {
 	return "npm";
 }
 /**
-* Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice -- the same "dispatcher reserves a subcommand name" model `git` uses.
+* Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice — the same "dispatcher reserves a subcommand name" model `git` uses.
 */
 function resolveBinDispatch(argv, userAgent) {
 	const head = argv[0];

package/dist/convert/composition.cjs

@@ -99,7 +99,7 @@ function latin1ToBytes(text) {
 	const bytes = new Uint8Array(text.length);
 	for (let index = 0; index < text.length; index += 1) {
 		const code = text.charCodeAt(index);
-		if (code > 255) throw new TypeError(`latin1ToBytes: character at index ${String(index)} is U+${code.toString(16).toUpperCase().padStart(4, "0")}, above U+00FF -- this string no longer holds the file's original bytes`);
+		if (code > 255) throw new TypeError(`latin1ToBytes: character at index ${String(index)} is U+${code.toString(16).toUpperCase().padStart(4, "0")}, above U+00FF — this string no longer holds the file's original bytes`);
 		bytes[index] = code;
 	}
 	return bytes;

package/dist/convert/composition.js

@@ -98,7 +98,7 @@ function latin1ToBytes(text) {
 	const bytes = new Uint8Array(text.length);
 	for (let index = 0; index < text.length; index += 1) {
 		const code = text.charCodeAt(index);
-		if (code > 255) throw new TypeError(`latin1ToBytes: character at index ${String(index)} is U+${code.toString(16).toUpperCase().padStart(4, "0")}, above U+00FF -- this string no longer holds the file's original bytes`);
+		if (code > 255) throw new TypeError(`latin1ToBytes: character at index ${String(index)} is U+${code.toString(16).toUpperCase().padStart(4, "0")}, above U+00FF — this string no longer holds the file's original bytes`);
 		bytes[index] = code;
 	}
 	return bytes;

package/dist/convert/convert.cjs

@@ -188,7 +188,7 @@ function markdownToCsv(bytes, options) {
 var OdmUnresolvedSectionError = class extends Error {
 	hrefs;
 	constructor(hrefs) {
-		super(`odmToPdf: ${hrefs.length} chapter section(s) could not be resolved -- no inline content and no resolveSubDocument result for: ${hrefs.join(", ")}`);
+		super(`odmToPdf: ${hrefs.length} chapter section(s) could not be resolved — no inline content and no resolveSubDocument result for: ${hrefs.join(", ")}`);
 		this.name = "OdmUnresolvedSectionError";
 		this.hrefs = hrefs;
 	}

package/dist/convert/convert.js

@@ -187,7 +187,7 @@ function markdownToCsv(bytes, options) {
 var OdmUnresolvedSectionError = class extends Error {
 	hrefs;
 	constructor(hrefs) {
-		super(`odmToPdf: ${hrefs.length} chapter section(s) could not be resolved -- no inline content and no resolveSubDocument result for: ${hrefs.join(", ")}`);
+		super(`odmToPdf: ${hrefs.length} chapter section(s) could not be resolved — no inline content and no resolveSubDocument result for: ${hrefs.join(", ")}`);
 		this.name = "OdmUnresolvedSectionError";
 		this.hrefs = hrefs;
 	}

package/dist/convert/document-fonts.cjs

@@ -17,7 +17,7 @@ function isFontSourceFormat(format) {
 var UnsupportedFontSourceFormatError = class extends Error {
 	format;
 	constructor(format) {
-		super(`'${format}' documents carry no source-embedded font faces to extract -- expected one of docx, pptx, odt, odp, ods, odg`);
+		super(`'${format}' documents carry no source-embedded font faces to extract — expected one of docx, pptx, odt, odp, ods, odg`);
 		this.name = "UnsupportedFontSourceFormatError";
 		this.format = format;
 	}

package/dist/convert/document-fonts.js

@@ -16,7 +16,7 @@ function isFontSourceFormat(format) {
 var UnsupportedFontSourceFormatError = class extends Error {
 	format;
 	constructor(format) {
-		super(`'${format}' documents carry no source-embedded font faces to extract -- expected one of docx, pptx, odt, odp, ods, odg`);
+		super(`'${format}' documents carry no source-embedded font faces to extract — expected one of docx, pptx, odt, odp, ods, odg`);
 		this.name = "UnsupportedFontSourceFormatError";
 		this.format = format;
 	}

package/dist/convert/from-package.cjs

@@ -15,7 +15,7 @@ let pdf_codec = require("pdf-codec");
 //#region src/convert/from-package.ts
 function buildDocumentBytes(pkg, target) {
 	if (target === "pdf") {
-		if (pkg.pages === void 0) throw new Error("this DocumentTree has no pages -- only a package dumped from a <format>-to-pdf or pdf-to-<format> conversion carries them; a bridge conversion's own dump (e.g. odt-to-docx) never does, so 'pdf' is not a reachable target from it");
+		if (pkg.pages === void 0) throw new Error("this DocumentTree has no pages — only a package dumped from a <format>-to-pdf or pdf-to-<format> conversion carries them; a bridge conversion's own dump (e.g. odt-to-docx) never does, so 'pdf' is not a reachable target from it");
 		const { document: layout, formulas, fonts } = packageToLayout(pkg);
 		return (0, pdf_codec.writePdf)(layout, formulas.length > 0 ? {
 			formulas,
@@ -24,7 +24,7 @@ function buildDocumentBytes(pkg, target) {
 	}
 	if (require_convert_capability.READ_ONLY_FORMATS.has(target)) throw new Error(`'${target}' is a read-only format: it cannot be built from a DocumentTree, because there is no ContentDocument-to-${target} builder`);
 	const content = require_codecs_registry.DOCUMENT_FORMAT_CODECS[target].content;
-	if (!content?.write) throw new Error(`DocumentFormat '${target}' has no content.write codec in DOCUMENT_FORMAT_CODECS, is not 'pdf', and is not read-only -- this is an internal invariant violation, not a caller error`);
+	if (!content?.write) throw new Error(`DocumentFormat '${target}' has no content.write codec in DOCUMENT_FORMAT_CODECS, is not 'pdf', and is not read-only — this is an internal invariant violation, not a caller error`);
 	return require_model_bytes.requireArrayBufferBytes(content.write((0, document_schema_js.flattenTree)(pkg)));
 }
 function pageOfFrame(state, frame) {

package/dist/convert/from-package.js

@@ -14,7 +14,7 @@ import { LAYOUT_FORMAT_VERSION, createFontMeasurer, createFontRegistry, loadMath
 //#region src/convert/from-package.ts
 function buildDocumentBytes(pkg, target) {
 	if (target === "pdf") {
-		if (pkg.pages === void 0) throw new Error("this DocumentTree has no pages -- only a package dumped from a <format>-to-pdf or pdf-to-<format> conversion carries them; a bridge conversion's own dump (e.g. odt-to-docx) never does, so 'pdf' is not a reachable target from it");
+		if (pkg.pages === void 0) throw new Error("this DocumentTree has no pages — only a package dumped from a <format>-to-pdf or pdf-to-<format> conversion carries them; a bridge conversion's own dump (e.g. odt-to-docx) never does, so 'pdf' is not a reachable target from it");
 		const { document: layout, formulas, fonts } = packageToLayout(pkg);
 		return writePdf(layout, formulas.length > 0 ? {
 			formulas,
@@ -23,7 +23,7 @@ function buildDocumentBytes(pkg, target) {
 	}
 	if (READ_ONLY_FORMATS.has(target)) throw new Error(`'${target}' is a read-only format: it cannot be built from a DocumentTree, because there is no ContentDocument-to-${target} builder`);
 	const content = DOCUMENT_FORMAT_CODECS[target].content;
-	if (!content?.write) throw new Error(`DocumentFormat '${target}' has no content.write codec in DOCUMENT_FORMAT_CODECS, is not 'pdf', and is not read-only -- this is an internal invariant violation, not a caller error`);
+	if (!content?.write) throw new Error(`DocumentFormat '${target}' has no content.write codec in DOCUMENT_FORMAT_CODECS, is not 'pdf', and is not read-only — this is an internal invariant violation, not a caller error`);
 	return requireArrayBufferBytes(content.write(flattenTree(pkg)));
 }
 function pageOfFrame(state, frame) {

package/dist/csv/write.cjs

@@ -12,7 +12,7 @@ var CsvUnsupportedDocumentKindError = class extends Error {
 var CsvSheetNotSpecifiedError = class extends Error {
 	availableSheets;
 	constructor(availableSheets) {
-		super(`buildCsvText: this document has more than one sheet (${availableSheets.join(", ")}) -- pass { sheet: '<name>' } to select one`);
+		super(`buildCsvText: this document has more than one sheet (${availableSheets.join(", ")}) — pass { sheet: '<name>' } to select one`);
 		this.name = "CsvSheetNotSpecifiedError";
 		this.availableSheets = availableSheets;
 	}
@@ -21,7 +21,7 @@ var CsvSheetNotFoundError = class extends Error {
 	sheet;
 	availableSheets;
 	constructor(sheet, availableSheets) {
-		super(`buildCsvText: sheet "${sheet}" not found -- available sheet(s): ${availableSheets.length === 0 ? "(none)" : availableSheets.join(", ")}`);
+		super(`buildCsvText: sheet "${sheet}" not found — available sheet(s): ${availableSheets.length === 0 ? "(none)" : availableSheets.join(", ")}`);
 		this.name = "CsvSheetNotFoundError";
 		this.sheet = sheet;
 		this.availableSheets = availableSheets;

package/dist/csv/write.js

@@ -11,7 +11,7 @@ var CsvUnsupportedDocumentKindError = class extends Error {
 var CsvSheetNotSpecifiedError = class extends Error {
 	availableSheets;
 	constructor(availableSheets) {
-		super(`buildCsvText: this document has more than one sheet (${availableSheets.join(", ")}) -- pass { sheet: '<name>' } to select one`);
+		super(`buildCsvText: this document has more than one sheet (${availableSheets.join(", ")}) — pass { sheet: '<name>' } to select one`);
 		this.name = "CsvSheetNotSpecifiedError";
 		this.availableSheets = availableSheets;
 	}
@@ -20,7 +20,7 @@ var CsvSheetNotFoundError = class extends Error {
 	sheet;
 	availableSheets;
 	constructor(sheet, availableSheets) {
-		super(`buildCsvText: sheet "${sheet}" not found -- available sheet(s): ${availableSheets.length === 0 ? "(none)" : availableSheets.join(", ")}`);
+		super(`buildCsvText: sheet "${sheet}" not found — available sheet(s): ${availableSheets.length === 0 ? "(none)" : availableSheets.join(", ")}`);
 		this.name = "CsvSheetNotFoundError";
 		this.sheet = sheet;
 		this.availableSheets = availableSheets;

package/dist/edit/docx/image.cjs

@@ -4,7 +4,7 @@ const require_model_units = require("../../model/units.cjs");
 const require_opc_media = require("../../opc/media.cjs");
 //#region src/edit/docx/image.ts
 function assertDocxWritableImageFormat(format) {
-	if (format === "svg") throw new Error("buildDocxPackage: an image block in svg format has no OOXML blip this writer can produce (WordprocessingML's a:blip only references a raster part Word decodes directly -- png/jpeg/gif)");
+	if (format === "svg") throw new Error("buildDocxPackage: an image block in svg format has no OOXML blip this writer can produce (WordprocessingML's a:blip only references a raster part Word decodes directly — png/jpeg/gif)");
 }
 const DRAWING_NS = {
 	wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",

package/dist/edit/docx/image.js

@@ -3,7 +3,7 @@ import { ptToEmu } from "../../model/units.js";
 import { addImageMedia } from "../../opc/media.js";
 //#region src/edit/docx/image.ts
 function assertDocxWritableImageFormat(format) {
-	if (format === "svg") throw new Error("buildDocxPackage: an image block in svg format has no OOXML blip this writer can produce (WordprocessingML's a:blip only references a raster part Word decodes directly -- png/jpeg/gif)");
+	if (format === "svg") throw new Error("buildDocxPackage: an image block in svg format has no OOXML blip this writer can produce (WordprocessingML's a:blip only references a raster part Word decodes directly — png/jpeg/gif)");
 }
 const DRAWING_NS = {
 	wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",

package/dist/edit/docx/paragraph.cjs

@@ -204,7 +204,7 @@ var DocxParagraph = class {
 			if (existing !== void 0) require_xml_edit.removeChild(pPr.children, existing);
 			return;
 		}
-		if (value.numId === void 0) throw new Error("DocxParagraph.list requires a numId -- buildDocxPackage mints one for memberships that lack it; set numId explicitly (see src/edit/docx/numbering.ts)");
+		if (value.numId === void 0) throw new Error("DocxParagraph.list requires a numId — buildDocxPackage mints one for memberships that lack it; set numId explicitly (see src/edit/docx/numbering.ts)");
 		const numPr = require_xml_edit.getOrCreateChildElement(pPr, "w:numPr", require_edit_docx_props.PPR_ORDER, () => require_xml_fragment.el("w:numPr"));
 		numPr.children = [require_xml_fragment.el("w:ilvl", { "w:val": String(value.level) }), require_xml_fragment.el("w:numId", { "w:val": value.numId })];
 	}

package/dist/edit/docx/paragraph.js

@@ -203,7 +203,7 @@ var DocxParagraph = class {
 			if (existing !== void 0) removeChild(pPr.children, existing);
 			return;
 		}
-		if (value.numId === void 0) throw new Error("DocxParagraph.list requires a numId -- buildDocxPackage mints one for memberships that lack it; set numId explicitly (see src/edit/docx/numbering.ts)");
+		if (value.numId === void 0) throw new Error("DocxParagraph.list requires a numId — buildDocxPackage mints one for memberships that lack it; set numId explicitly (see src/edit/docx/numbering.ts)");
 		const numPr = getOrCreateChildElement(pPr, "w:numPr", PPR_ORDER, () => el("w:numPr"));
 		numPr.children = [el("w:ilvl", { "w:val": String(value.level) }), el("w:numId", { "w:val": value.numId })];
 	}

package/dist/edit/ods/sheet.cjs

@@ -65,7 +65,7 @@ var OdsSheet = class {
 	cell(row, column) {
 		const tableElement = this.live();
 		const node = require_edit_ods_address.resolveCellNode(tableElement, row, column);
-		if (node.tag === "table:covered-table-cell") throw new Error(`cell (${row}, ${column}) is covered by a merged range -- address the merge's own anchor cell instead`);
+		if (node.tag === "table:covered-table-cell") throw new Error(`cell (${row}, ${column}) is covered by a merged range — address the merge's own anchor cell instead`);
 		require_edit_ods_column_row.ensureColumnDefaultWidth(this.pkg, tableElement, column);
 		require_edit_ods_column_row.ensureRowDefaultHeight(this.pkg, tableElement, row);
 		return new require_edit_ods_cell.OdsCell(node, this.pkg);

package/dist/edit/ods/sheet.js

@@ -64,7 +64,7 @@ var OdsSheet = class {
 	cell(row, column) {
 		const tableElement = this.live();
 		const node = resolveCellNode(tableElement, row, column);
-		if (node.tag === "table:covered-table-cell") throw new Error(`cell (${row}, ${column}) is covered by a merged range -- address the merge's own anchor cell instead`);
+		if (node.tag === "table:covered-table-cell") throw new Error(`cell (${row}, ${column}) is covered by a merged range — address the merge's own anchor cell instead`);
 		ensureColumnDefaultWidth(this.pkg, tableElement, column);
 		ensureRowDefaultHeight(this.pkg, tableElement, row);
 		return new OdsCell(node, this.pkg);

package/dist/edit/pptx/content.cjs

@@ -45,7 +45,7 @@ function appendShape(slide, shape, options) {
 		}
 	}
 	if (shape.blocks.length === 1 && onlyBlock?.kind === "image") {
-		if (onlyBlock.format === "svg") throw new Error("buildPptxPackage: an image block in svg format has no OOXML blip this writer can produce (PresentationML's a:blip only references a raster part PowerPoint decodes directly -- png/jpeg/gif)");
+		if (onlyBlock.format === "svg") throw new Error("buildPptxPackage: an image block in svg format has no OOXML blip this writer can produce (PresentationML's a:blip only references a raster part PowerPoint decodes directly — png/jpeg/gif)");
 		const imageShape = slide.addImage({
 			frame: shape.frame,
 			format: onlyBlock.format,

package/dist/edit/pptx/content.js

@@ -44,7 +44,7 @@ function appendShape(slide, shape, options) {
 		}
 	}
 	if (shape.blocks.length === 1 && onlyBlock?.kind === "image") {
-		if (onlyBlock.format === "svg") throw new Error("buildPptxPackage: an image block in svg format has no OOXML blip this writer can produce (PresentationML's a:blip only references a raster part PowerPoint decodes directly -- png/jpeg/gif)");
+		if (onlyBlock.format === "svg") throw new Error("buildPptxPackage: an image block in svg format has no OOXML blip this writer can produce (PresentationML's a:blip only references a raster part PowerPoint decodes directly — png/jpeg/gif)");
 		const imageShape = slide.addImage({
 			frame: shape.frame,
 			format: onlyBlock.format,

package/dist/firebird/backup.cjs

@@ -61,7 +61,7 @@ function readBurpHeader(reader) {
 			default: reader.skipAttributeValue();
 		}
 	}
-	if (backupFormatVersion === void 0) throw new FirebirdBackupFormatError("the leading rec_burp record had no att_backup_format attribute -- not a recognisable gbak backup stream");
+	if (backupFormatVersion === void 0) throw new FirebirdBackupFormatError("the leading rec_burp record had no att_backup_format attribute — not a recognisable gbak backup stream");
 	return {
 		backupFormatVersion,
 		transportable,
@@ -88,10 +88,10 @@ function relationToColumns(relation) {
 function readFirebirdBackup(bytes) {
 	const reader = new require_firebird_reader.FirebirdBackupReader(bytes);
 	const leadingRecordType = reader.readTag();
-	if (leadingRecordType !== 0) throw new FirebirdBackupFormatError(`expected the stream to open with rec_burp (tag 0), found tag ${leadingRecordType} -- not a recognisable gbak backup stream`);
+	if (leadingRecordType !== 0) throw new FirebirdBackupFormatError(`expected the stream to open with rec_burp (tag 0), found tag ${leadingRecordType} — not a recognisable gbak backup stream`);
 	const { backupFormatVersion, transportable, compressed } = readBurpHeader(reader);
-	if (backupFormatVersion !== 10) throw new FirebirdBackupFormatError(`backup format version ${backupFormatVersion} is not supported -- this reader has only been built and verified against format version 10 (Firebird 3.0-era gbak output). Refusing to guess at a different format's own attribute/record shape rather than risk silently misdecoding it.`);
-	if (!transportable) throw new FirebirdBackupFormatError("backup is in non-transportable (native binary) row format (att_backup_transportable=false) -- this reader only decodes the transportable/XDR row encoding, the one every real fixture it was built against actually uses (gbak's own default).");
+	if (backupFormatVersion !== 10) throw new FirebirdBackupFormatError(`backup format version ${backupFormatVersion} is not supported — this reader has only been built and verified against format version 10 (Firebird 3.0-era gbak output). Refusing to guess at a different format's own attribute/record shape rather than risk silently misdecoding it.`);
+	if (!transportable) throw new FirebirdBackupFormatError("backup is in non-transportable (native binary) row format (att_backup_transportable=false) — this reader only decodes the transportable/XDR row encoding, the one every real fixture it was built against actually uses (gbak's own default).");
 	let pageSizeBytes;
 	const schema = /* @__PURE__ */ new Map();
 	const relationsInOrder = [];

package/dist/firebird/backup.js

@@ -60,7 +60,7 @@ function readBurpHeader(reader) {
 			default: reader.skipAttributeValue();
 		}
 	}
-	if (backupFormatVersion === void 0) throw new FirebirdBackupFormatError("the leading rec_burp record had no att_backup_format attribute -- not a recognisable gbak backup stream");
+	if (backupFormatVersion === void 0) throw new FirebirdBackupFormatError("the leading rec_burp record had no att_backup_format attribute — not a recognisable gbak backup stream");
 	return {
 		backupFormatVersion,
 		transportable,
@@ -87,10 +87,10 @@ function relationToColumns(relation) {
 function readFirebirdBackup(bytes) {
 	const reader = new FirebirdBackupReader(bytes);
 	const leadingRecordType = reader.readTag();
-	if (leadingRecordType !== 0) throw new FirebirdBackupFormatError(`expected the stream to open with rec_burp (tag 0), found tag ${leadingRecordType} -- not a recognisable gbak backup stream`);
+	if (leadingRecordType !== 0) throw new FirebirdBackupFormatError(`expected the stream to open with rec_burp (tag 0), found tag ${leadingRecordType} — not a recognisable gbak backup stream`);
 	const { backupFormatVersion, transportable, compressed } = readBurpHeader(reader);
-	if (backupFormatVersion !== 10) throw new FirebirdBackupFormatError(`backup format version ${backupFormatVersion} is not supported -- this reader has only been built and verified against format version 10 (Firebird 3.0-era gbak output). Refusing to guess at a different format's own attribute/record shape rather than risk silently misdecoding it.`);
-	if (!transportable) throw new FirebirdBackupFormatError("backup is in non-transportable (native binary) row format (att_backup_transportable=false) -- this reader only decodes the transportable/XDR row encoding, the one every real fixture it was built against actually uses (gbak's own default).");
+	if (backupFormatVersion !== 10) throw new FirebirdBackupFormatError(`backup format version ${backupFormatVersion} is not supported — this reader has only been built and verified against format version 10 (Firebird 3.0-era gbak output). Refusing to guess at a different format's own attribute/record shape rather than risk silently misdecoding it.`);
+	if (!transportable) throw new FirebirdBackupFormatError("backup is in non-transportable (native binary) row format (att_backup_transportable=false) — this reader only decodes the transportable/XDR row encoding, the one every real fixture it was built against actually uses (gbak's own default).");
 	let pageSizeBytes;
 	const schema = /* @__PURE__ */ new Map();
 	const relationsInOrder = [];

package/dist/firebird/data.cjs

@@ -22,7 +22,7 @@ var FirebirdDataParseError = class extends Error {
 var FirebirdCompositeRecordUnsupportedError = class extends Error {
 	recordType;
 	constructor(recordType, context) {
-		super(`Firebird backup: encountered record type ${recordType} while ${context}, which this reader's own bounded implementation does not know how to skip safely (its own attribute/sub-record shape has not been verified against a real fixture) -- refusing to guess rather than risk silently desynchronising the rest of the stream`);
+		super(`Firebird backup: encountered record type ${recordType} while ${context}, which this reader's own bounded implementation does not know how to skip safely (its own attribute/sub-record shape has not been verified against a real fixture) — refusing to guess rather than risk silently desynchronising the rest of the stream`);
 		this.name = "FirebirdCompositeRecordUnsupportedError";
 		this.recordType = recordType;
 	}
@@ -198,7 +198,7 @@ function decodeRowValues(fields, payload) {
 		case "int128":
 		case "dec64":
 		case "dec128":
-		case "unsupported-tz": throw new FirebirdDataParseError(`column "${field.name}" has physical type "${field.physicalType}", which this reader's own bounded implementation does not decode (FB4+-only types not exercised by this reader's Firebird 3.0-era real fixture) -- see the README's .odb Tier 3 Fidelity note`);
+		case "unsupported-tz": throw new FirebirdDataParseError(`column "${field.name}" has physical type "${field.physicalType}", which this reader's own bounded implementation does not decode (FB4+-only types not exercised by this reader's Firebird 3.0-era real fixture) — see the README's .odb Tier 3 Fidelity note`);
 	}
 	for (let i = 0; i < storedFields.length; i++) if (xdr.readInt16() !== 0) rawValues[i] = { kind: "empty" };
 	return rawValues.map((value) => value ?? { kind: "empty" });

package/dist/firebird/data.js

@@ -21,7 +21,7 @@ var FirebirdDataParseError = class extends Error {
 var FirebirdCompositeRecordUnsupportedError = class extends Error {
 	recordType;
 	constructor(recordType, context) {
-		super(`Firebird backup: encountered record type ${recordType} while ${context}, which this reader's own bounded implementation does not know how to skip safely (its own attribute/sub-record shape has not been verified against a real fixture) -- refusing to guess rather than risk silently desynchronising the rest of the stream`);
+		super(`Firebird backup: encountered record type ${recordType} while ${context}, which this reader's own bounded implementation does not know how to skip safely (its own attribute/sub-record shape has not been verified against a real fixture) — refusing to guess rather than risk silently desynchronising the rest of the stream`);
 		this.name = "FirebirdCompositeRecordUnsupportedError";
 		this.recordType = recordType;
 	}
@@ -197,7 +197,7 @@ function decodeRowValues(fields, payload) {
 		case "int128":
 		case "dec64":
 		case "dec128":
-		case "unsupported-tz": throw new FirebirdDataParseError(`column "${field.name}" has physical type "${field.physicalType}", which this reader's own bounded implementation does not decode (FB4+-only types not exercised by this reader's Firebird 3.0-era real fixture) -- see the README's .odb Tier 3 Fidelity note`);
+		case "unsupported-tz": throw new FirebirdDataParseError(`column "${field.name}" has physical type "${field.physicalType}", which this reader's own bounded implementation does not decode (FB4+-only types not exercised by this reader's Firebird 3.0-era real fixture) — see the README's .odb Tier 3 Fidelity note`);
 	}
 	for (let i = 0; i < storedFields.length; i++) if (xdr.readInt16() !== 0) rawValues[i] = { kind: "empty" };
 	return rawValues.map((value) => value ?? { kind: "empty" });

package/dist/hsqldb/binary-script.cjs

@@ -72,14 +72,14 @@ function readResultMetaData(reader) {
 function readDdlStatements(reader) {
 	const recordStart = reader.position;
 	const recordLength = reader.readInt32("the leading DDL result record's own length");
-	if (recordLength <= 4) throw new HsqldbBinaryScriptParseError(`the leading DDL result record declares an implausible length ${recordLength} -- not a recognisable HSQLDB binary script`, recordStart);
+	if (recordLength <= 4) throw new HsqldbBinaryScriptParseError(`the leading DDL result record declares an implausible length ${recordLength} — not a recognisable HSQLDB binary script`, recordStart);
 	const mode = reader.readInt32("the DDL result's own mode");
-	if (mode !== RESULT_MODE_DATA) throw new HsqldbBinaryScriptParseError(`the leading record has Result mode ${mode}, not the DATA mode (${RESULT_MODE_DATA}) a script's own DDL result always carries -- not a recognisable HSQLDB binary script`, recordStart);
+	if (mode !== RESULT_MODE_DATA) throw new HsqldbBinaryScriptParseError(`the leading record has Result mode ${mode}, not the DATA mode (${RESULT_MODE_DATA}) a script's own DDL result always carries — not a recognisable HSQLDB binary script`, recordStart);
 	reader.readInt32("the DDL result's own database id");
 	reader.readInt32("the DDL result's own session id");
 	const columnTypes = readResultMetaData(reader);
 	const firstColumnType = columnTypes[0];
-	if (columnTypes.length !== 1 || firstColumnType !== SQL_TYPE_VARCHAR) throw new HsqldbBinaryScriptParseError(`the DDL result has ${columnTypes.length} column(s) of type [${columnTypes.join(", ")}] -- a script's own DDL result is always the single VARCHAR "COMMAND" column DatabaseScript.getScript builds`, recordStart);
+	if (columnTypes.length !== 1 || firstColumnType !== SQL_TYPE_VARCHAR) throw new HsqldbBinaryScriptParseError(`the DDL result has ${columnTypes.length} column(s) of type [${columnTypes.join(", ")}] — a script's own DDL result is always the single VARCHAR "COMMAND" column DatabaseScript.getScript builds`, recordStart);
 	const rowCount = reader.readInt32("the DDL result's own row count");
 	if (rowCount < 0) throw new HsqldbBinaryScriptParseError(`the DDL result declares a negative row count ${rowCount}`, reader.position);
 	const statements = [];

package/dist/hsqldb/binary-script.js

@@ -71,14 +71,14 @@ function readResultMetaData(reader) {
 function readDdlStatements(reader) {
 	const recordStart = reader.position;
 	const recordLength = reader.readInt32("the leading DDL result record's own length");
-	if (recordLength <= 4) throw new HsqldbBinaryScriptParseError(`the leading DDL result record declares an implausible length ${recordLength} -- not a recognisable HSQLDB binary script`, recordStart);
+	if (recordLength <= 4) throw new HsqldbBinaryScriptParseError(`the leading DDL result record declares an implausible length ${recordLength} — not a recognisable HSQLDB binary script`, recordStart);
 	const mode = reader.readInt32("the DDL result's own mode");
-	if (mode !== RESULT_MODE_DATA) throw new HsqldbBinaryScriptParseError(`the leading record has Result mode ${mode}, not the DATA mode (${RESULT_MODE_DATA}) a script's own DDL result always carries -- not a recognisable HSQLDB binary script`, recordStart);
+	if (mode !== RESULT_MODE_DATA) throw new HsqldbBinaryScriptParseError(`the leading record has Result mode ${mode}, not the DATA mode (${RESULT_MODE_DATA}) a script's own DDL result always carries — not a recognisable HSQLDB binary script`, recordStart);
 	reader.readInt32("the DDL result's own database id");
 	reader.readInt32("the DDL result's own session id");
 	const columnTypes = readResultMetaData(reader);
 	const firstColumnType = columnTypes[0];
-	if (columnTypes.length !== 1 || firstColumnType !== SQL_TYPE_VARCHAR) throw new HsqldbBinaryScriptParseError(`the DDL result has ${columnTypes.length} column(s) of type [${columnTypes.join(", ")}] -- a script's own DDL result is always the single VARCHAR "COMMAND" column DatabaseScript.getScript builds`, recordStart);
+	if (columnTypes.length !== 1 || firstColumnType !== SQL_TYPE_VARCHAR) throw new HsqldbBinaryScriptParseError(`the DDL result has ${columnTypes.length} column(s) of type [${columnTypes.join(", ")}] — a script's own DDL result is always the single VARCHAR "COMMAND" column DatabaseScript.getScript builds`, recordStart);
 	const rowCount = reader.readInt32("the DDL result's own row count");
 	if (rowCount < 0) throw new HsqldbBinaryScriptParseError(`the DDL result declares a negative row count ${rowCount}`, reader.position);
 	const statements = [];

package/dist/hsqldb/cache.cjs

@@ -13,7 +13,7 @@ function parseHsqldbProperties(text) {
 		props.set(line.slice(0, eq).trim(), line.slice(eq + 1).trim());
 	}
 	const compatibleVersion = props.get("hsqldb.compatible_version");
-	if (compatibleVersion !== void 0 && !SUPPORTED_COMPATIBLE_VERSION_PREFIXES.some((prefix) => compatibleVersion.startsWith(prefix))) throw new require_hsqldb_rowformat.HsqldbRowFormatError(`database/properties declares hsqldb.compatible_version "${compatibleVersion}" -- this decoder is scoped to the HSQLDB 1.7.x/1.8.x CACHED-table row-store format (the version LibreOffice's own embedded driver ships) and does not know this version's own on-disk row-store layout`);
+	if (compatibleVersion !== void 0 && !SUPPORTED_COMPATIBLE_VERSION_PREFIXES.some((prefix) => compatibleVersion.startsWith(prefix))) throw new require_hsqldb_rowformat.HsqldbRowFormatError(`database/properties declares hsqldb.compatible_version "${compatibleVersion}" — this decoder is scoped to the HSQLDB 1.7.x/1.8.x CACHED-table row-store format (the version LibreOffice's own embedded driver ships) and does not know this version's own on-disk row-store layout`);
 	return {
 		cacheFileScale: Number(props.get("hsqldb.cache_file_scale") ?? "1") === 1 ? 1 : 8,
 		compatibleVersion
@@ -33,7 +33,7 @@ function parseHsqldbIndexRoots(scriptText) {
 		const tokensText = match[2] ?? "";
 		const tableName = unquoteIdentifier(rawName).toUpperCase();
 		const tokens = tokensText.trim().length === 0 ? [] : tokensText.trim().split(/\s+/);
-		if (tokens.length < 2) throw new require_hsqldb_rowformat.HsqldbRowFormatError(`table "${tableName}"'s SET TABLE...INDEX line has ${tokens.length} token(s) -- every such line carries at least one index root position followed by the table's own identity-sequence value`);
+		if (tokens.length < 2) throw new require_hsqldb_rowformat.HsqldbRowFormatError(`table "${tableName}"'s SET TABLE...INDEX line has ${tokens.length} token(s) — every such line carries at least one index root position followed by the table's own identity-sequence value`);
 		const indexCount = tokens.length - 1;
 		const rootToken = tokens[0] ?? "";
 		const rootPosition = Number(rootToken);

package/dist/hsqldb/cache.js

@@ -12,7 +12,7 @@ function parseHsqldbProperties(text) {
 		props.set(line.slice(0, eq).trim(), line.slice(eq + 1).trim());
 	}
 	const compatibleVersion = props.get("hsqldb.compatible_version");
-	if (compatibleVersion !== void 0 && !SUPPORTED_COMPATIBLE_VERSION_PREFIXES.some((prefix) => compatibleVersion.startsWith(prefix))) throw new HsqldbRowFormatError(`database/properties declares hsqldb.compatible_version "${compatibleVersion}" -- this decoder is scoped to the HSQLDB 1.7.x/1.8.x CACHED-table row-store format (the version LibreOffice's own embedded driver ships) and does not know this version's own on-disk row-store layout`);
+	if (compatibleVersion !== void 0 && !SUPPORTED_COMPATIBLE_VERSION_PREFIXES.some((prefix) => compatibleVersion.startsWith(prefix))) throw new HsqldbRowFormatError(`database/properties declares hsqldb.compatible_version "${compatibleVersion}" — this decoder is scoped to the HSQLDB 1.7.x/1.8.x CACHED-table row-store format (the version LibreOffice's own embedded driver ships) and does not know this version's own on-disk row-store layout`);
 	return {
 		cacheFileScale: Number(props.get("hsqldb.cache_file_scale") ?? "1") === 1 ? 1 : 8,
 		compatibleVersion
@@ -32,7 +32,7 @@ function parseHsqldbIndexRoots(scriptText) {
 		const tokensText = match[2] ?? "";
 		const tableName = unquoteIdentifier(rawName).toUpperCase();
 		const tokens = tokensText.trim().length === 0 ? [] : tokensText.trim().split(/\s+/);
-		if (tokens.length < 2) throw new HsqldbRowFormatError(`table "${tableName}"'s SET TABLE...INDEX line has ${tokens.length} token(s) -- every such line carries at least one index root position followed by the table's own identity-sequence value`);
+		if (tokens.length < 2) throw new HsqldbRowFormatError(`table "${tableName}"'s SET TABLE...INDEX line has ${tokens.length} token(s) — every such line carries at least one index root position followed by the table's own identity-sequence value`);
 		const indexCount = tokens.length - 1;
 		const rootToken = tokens[0] ?? "";
 		const rootPosition = Number(rootToken);

package/dist/hsqldb/rowformat.cjs

@@ -41,9 +41,9 @@ const LEADING_WORD_RE = /^([A-Za-z_][A-Za-z0-9_]*)/;
 function resolveHsqldbTypeCode(declaredType) {
 	const word = LEADING_WORD_RE.exec(declaredType.trim())?.[1]?.toUpperCase();
 	if (word === void 0) throw new HsqldbRowFormatError(`cannot resolve a SQL type name from column type clause "${declaredType}"`);
-	if (UNSUPPORTED_SQL_TYPE_NAMES.has(word)) throw new HsqldbRowFormatError(`column type "${word}" has no document-schema.js ContentCellValue equivalent (binary/object column types are not representable) -- from declared type "${declaredType}"`);
+	if (UNSUPPORTED_SQL_TYPE_NAMES.has(word)) throw new HsqldbRowFormatError(`column type "${word}" has no document-schema.js ContentCellValue equivalent (binary/object column types are not representable) — from declared type "${declaredType}"`);
 	const code = SQL_TYPE_NAME_TO_CODE[word];
-	if (code === void 0) throw new HsqldbRowFormatError(`unrecognised HSQLDB column type "${word}" -- from declared type "${declaredType}"`);
+	if (code === void 0) throw new HsqldbRowFormatError(`unrecognised HSQLDB column type "${word}" — from declared type "${declaredType}"`);
 	return code;
 }
 var HsqldbDataCursor = class {

package/dist/hsqldb/rowformat.js

@@ -40,9 +40,9 @@ const LEADING_WORD_RE = /^([A-Za-z_][A-Za-z0-9_]*)/;
 function resolveHsqldbTypeCode(declaredType) {
 	const word = LEADING_WORD_RE.exec(declaredType.trim())?.[1]?.toUpperCase();
 	if (word === void 0) throw new HsqldbRowFormatError(`cannot resolve a SQL type name from column type clause "${declaredType}"`);
-	if (UNSUPPORTED_SQL_TYPE_NAMES.has(word)) throw new HsqldbRowFormatError(`column type "${word}" has no document-schema.js ContentCellValue equivalent (binary/object column types are not representable) -- from declared type "${declaredType}"`);
+	if (UNSUPPORTED_SQL_TYPE_NAMES.has(word)) throw new HsqldbRowFormatError(`column type "${word}" has no document-schema.js ContentCellValue equivalent (binary/object column types are not representable) — from declared type "${declaredType}"`);
 	const code = SQL_TYPE_NAME_TO_CODE[word];
-	if (code === void 0) throw new HsqldbRowFormatError(`unrecognised HSQLDB column type "${word}" -- from declared type "${declaredType}"`);
+	if (code === void 0) throw new HsqldbRowFormatError(`unrecognised HSQLDB column type "${word}" — from declared type "${declaredType}"`);
 	return code;
 }
 var HsqldbDataCursor = class {

package/dist/hsqldb/script.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 var HsqldbScriptParseError = class extends Error {
 	statement;
 	constructor(message, statement) {
-		super(`HSQLDB script parse error: ${message} -- in statement: ${truncateForMessage(statement)}`);
+		super(`HSQLDB script parse error: ${message} — in statement: ${truncateForMessage(statement)}`);
 		this.name = "HsqldbScriptParseError";
 		this.statement = statement;
 	}
@@ -391,7 +391,7 @@ function parseInsertInto(statement) {
 	if (statement.charAt(i) !== "(") throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": expected "(" to start the VALUES tuple`, statement);
 	const { inner, next: afterTuple } = readBalancedParens(statement, i);
 	const trailing = statement.slice(afterTuple).trim();
-	if (trailing.length > 0) throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": unexpected trailing content after the VALUES tuple ("${trailing}") -- multiple tuples per INSERT are outside this bounded parser's scope`, statement);
+	if (trailing.length > 0) throw new HsqldbScriptParseError(`INSERT INTO "${tableName}": unexpected trailing content after the VALUES tuple ("${trailing}") — multiple tuples per INSERT are outside this bounded parser's scope`, statement);
 	return {
 		tableName,
 		explicitColumns,