js.documents 14.1.0 → 14.2.0

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/convert/variant-bridges.cjs

@@ -120,11 +120,11 @@ function sheetToTableBlock(sheet) {
 	const visibleColumns = [];
 	for (let column = 0; column <= maxColumn; column += 1) if (!hiddenColumns.has(column)) visibleColumns.push(column);
 	const columnWidthByIndex = new Map(sheet.columns.map((column) => [column.index, column.widthPt]));
-	const columnWidthsPt = visibleColumns.map((column) => columnWidthByIndex.get(column) ?? 72);
+	const columns = visibleColumns.map((column) => ({ widthPt: columnWidthByIndex.get(column) ?? 72 }));
 	return {
 		kind: "table",
 		rows: visibleRows.map((row) => ({ cells: visibleColumns.map((column) => spreadsheetCellToTableCell(cellByPosition.get(`${String(row)}:${String(column)}`))) })),
-		columnWidthsPt
+		columns
 	};
 }
 function spreadsheetToWordprocessing(doc) {

package/dist/convert/variant-bridges.js

@@ -119,11 +119,11 @@ function sheetToTableBlock(sheet) {
 	const visibleColumns = [];
 	for (let column = 0; column <= maxColumn; column += 1) if (!hiddenColumns.has(column)) visibleColumns.push(column);
 	const columnWidthByIndex = new Map(sheet.columns.map((column) => [column.index, column.widthPt]));
-	const columnWidthsPt = visibleColumns.map((column) => columnWidthByIndex.get(column) ?? 72);
+	const columns = visibleColumns.map((column) => ({ widthPt: columnWidthByIndex.get(column) ?? 72 }));
 	return {
 		kind: "table",
 		rows: visibleRows.map((row) => ({ cells: visibleColumns.map((column) => spreadsheetCellToTableCell(cellByPosition.get(`${String(row)}:${String(column)}`))) })),
-		columnWidthsPt
+		columns
 	};
 }
 function spreadsheetToWordprocessing(doc) {

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/{diagnostics-9twvwLNY.d.cts → diagnostics-CGWySzd-.d.cts}

@@ -2,6 +2,7 @@
 type PptxWriteDiagnosticSeverity = "info" | "warning";
 declare const PptxWriteDiagnosticCodes: {
   readonly TABLE_HEADER_ROW_DROPPED: "pptx-write/table-header-row-dropped";
+  readonly TABLE_HEADER_COLUMN_DROPPED: "pptx-write/table-header-column-dropped";
 };
 type PptxWriteDiagnosticCode = (typeof PptxWriteDiagnosticCodes)[keyof typeof PptxWriteDiagnosticCodes];
 interface PptxWriteDiagnostic {

package/dist/{diagnostics-9twvwLNY.d.ts → diagnostics-CGWySzd-.d.ts}

@@ -2,6 +2,7 @@
 type PptxWriteDiagnosticSeverity = "info" | "warning";
 declare const PptxWriteDiagnosticCodes: {
   readonly TABLE_HEADER_ROW_DROPPED: "pptx-write/table-header-row-dropped";
+  readonly TABLE_HEADER_COLUMN_DROPPED: "pptx-write/table-header-column-dropped";
 };
 type PptxWriteDiagnosticCode = (typeof PptxWriteDiagnosticCodes)[keyof typeof PptxWriteDiagnosticCodes];
 interface PptxWriteDiagnostic {

package/dist/edit/doc/table.cjs

@@ -81,7 +81,7 @@ var DocTable = class {
 	}
 	appendRow() {
 		const node = this.live();
-		const row = buildRow(node.columnWidthsPt.length);
+		const row = buildRow(node.columns.length);
 		node.rows.push(row);
 		return new DocTableRow(row);
 	}
@@ -115,13 +115,13 @@ var DocTable = class {
 	}
 };
 function buildTable(init) {
-	const columnWidthsPt = Array.from({ length: init.columns }, () => DEFAULT_TABLE_WIDTH_PT / init.columns);
+	const columns = Array.from({ length: init.columns }, () => ({ widthPt: DEFAULT_TABLE_WIDTH_PT / init.columns }));
 	const rows = [];
 	for (let r = 0; r < init.rows; r++) rows.push(buildRow(init.columns));
 	return {
 		kind: "table",
 		rows,
-		columnWidthsPt
+		columns
 	};
 }
 //#endregion

package/dist/edit/doc/table.js

@@ -80,7 +80,7 @@ var DocTable = class {
 	}
 	appendRow() {
 		const node = this.live();
-		const row = buildRow(node.columnWidthsPt.length);
+		const row = buildRow(node.columns.length);
 		node.rows.push(row);
 		return new DocTableRow(row);
 	}
@@ -114,13 +114,13 @@ var DocTable = class {
 	}
 };
 function buildTable(init) {
-	const columnWidthsPt = Array.from({ length: init.columns }, () => DEFAULT_TABLE_WIDTH_PT / init.columns);
+	const columns = Array.from({ length: init.columns }, () => ({ widthPt: DEFAULT_TABLE_WIDTH_PT / init.columns }));
 	const rows = [];
 	for (let r = 0; r < init.rows; r++) rows.push(buildRow(init.columns));
 	return {
 		kind: "table",
 		rows,
-		columnWidthsPt
+		columns
 	};
 }
 //#endregion

package/dist/edit/docx/content.cjs

@@ -214,7 +214,7 @@ function appendTable(body, block) {
 	const table = body.appendTable({
 		rows: 0,
 		columns: (0, document_schema_js.tableGridColumnCount)(block),
-		columnWidthsTwips: block.columnWidthsPt.map(require_model_units.ptToTwips)
+		columnWidthsTwips: block.columns.map((c) => require_model_units.ptToTwips(c.widthPt))
 	});
 	const positionsByRow = (0, document_schema_js.walkTableGrid)(block);
 	block.rows.forEach((row, rowIndex) => {

package/dist/edit/docx/content.js

@@ -213,7 +213,7 @@ function appendTable(body, block) {
 	const table = body.appendTable({
 		rows: 0,
 		columns: tableGridColumnCount(block),
-		columnWidthsTwips: block.columnWidthsPt.map(ptToTwips)
+		columnWidthsTwips: block.columns.map((c) => ptToTwips(c.widthPt))
 	});
 	const positionsByRow = walkTableGrid(block);
 	block.rows.forEach((row, rowIndex) => {

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/markdown/table.cjs

@@ -66,7 +66,7 @@ var MarkdownTable = class {
 	}
 	appendRow() {
 		const node = this.live();
-		const row = buildRow(node.columnWidthsPt.length);
+		const row = buildRow(node.columns.length);
 		node.rows.push(row);
 		return new MarkdownTableRow(row);
 	}
@@ -78,13 +78,13 @@ var MarkdownTable = class {
 	}
 };
 function buildTable(init) {
-	const columnWidthsPt = Array.from({ length: init.columns }, () => DEFAULT_TABLE_WIDTH_PT / init.columns);
+	const columns = Array.from({ length: init.columns }, () => ({ widthPt: DEFAULT_TABLE_WIDTH_PT / init.columns }));
 	const rows = [];
 	for (let r = 0; r < init.rows; r++) rows.push(buildRow(init.columns));
 	return {
 		kind: "table",
 		rows,
-		columnWidthsPt
+		columns
 	};
 }
 //#endregion

package/dist/edit/markdown/table.js

@@ -65,7 +65,7 @@ var MarkdownTable = class {
 	}
 	appendRow() {
 		const node = this.live();
-		const row = buildRow(node.columnWidthsPt.length);
+		const row = buildRow(node.columns.length);
 		node.rows.push(row);
 		return new MarkdownTableRow(row);
 	}
@@ -77,13 +77,13 @@ var MarkdownTable = class {
 	}
 };
 function buildTable(init) {
-	const columnWidthsPt = Array.from({ length: init.columns }, () => DEFAULT_TABLE_WIDTH_PT / init.columns);
+	const columns = Array.from({ length: init.columns }, () => ({ widthPt: DEFAULT_TABLE_WIDTH_PT / init.columns }));
 	const rows = [];
 	for (let r = 0; r < init.rows; r++) rows.push(buildRow(init.columns));
 	return {
 		kind: "table",
 		rows,
-		columnWidthsPt
+		columns
 	};
 }
 //#endregion

package/dist/edit/odp/slide.d.cts

@@ -1,7 +1,7 @@
 import { t as ImageInit } from "../../image-D1z0T9Za.cjs";
 import { t as OdpShape } from "../../shape-Kmmxib5z.cjs";
 import { s as OdgVector } from "../../vector-DDP7hgvm.cjs";
-import { o as TableInit, r as OdtTable } from "../../table-Bt9ahRyh.cjs";
+import { o as TableInit, r as OdtTable } from "../../table-DrE6jEWv.cjs";
 import { Box, ContentFormula, ContentVector } from "document-schema.js";
 import { Package, XmlElement, XmlNode } from "odf.js";
 //#region src/edit/odp/slide.d.ts

package/dist/edit/odp/slide.d.ts

@@ -1,7 +1,7 @@
 import { t as ImageInit } from "../../image-D1z0T9Za.js";
 import { t as OdpShape } from "../../shape-ZAfNsCC5.js";
 import { s as OdgVector } from "../../vector-DDP7hgvm.js";
-import { o as TableInit, r as OdtTable } from "../../table-Cou5rKOo.js";
+import { o as TableInit, r as OdtTable } from "../../table-B5htMG3g.js";
 import { Box, ContentFormula, ContentVector } from "document-schema.js";
 import { Package, XmlElement, XmlNode } from "odf.js";
 //#region src/edit/odp/slide.d.ts

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/odt/content.cjs

@@ -136,6 +136,7 @@ function populateOdtTable(table, block) {
 	require_edit_table_grid.assertTableObeysGridRule(block, "populateOdtTable");
 	const gridPositions = (0, document_schema_js.walkTableGrid)(block);
 	const headerFlags = block.rows.map((row) => row.isHeader === true);
+	const columnHeaderFlags = block.columns.map((column) => column.isHeader === true);
 	block.rows.forEach((row, rowIndex) => {
 		const tableRow = table.appendEmptyRow();
 		tableRow.heightPt = row.heightPt;
@@ -155,6 +156,7 @@ function populateOdtTable(table, block) {
 		});
 	});
 	table.setHeaderRows(headerFlags);
+	table.setHeaderColumns(columnHeaderFlags);
 }
 function applyCellDecoration(target, cell) {
 	if (cell.background !== void 0) target.background = (0, document_schema_js.resolveCellFillColor)(cell.background);
@@ -163,7 +165,7 @@ function applyCellDecoration(target, cell) {
 /**
 * The arguments that create the empty `table:table` a ContentTable is written into: no rows, since populateOdtTable appends one per ContentTableRow, and as many columns as the table's grid is wide.
 *
-* The grid width is what the rows and `columnWidthsPt` together state (tableGridColumnCount), so a table whose rows carry cells but which states no column widths still gets one `table:table-column` per grid column; a column with no stated width takes an equal share of the default table width, the same as any column created without one. `columnWidthsPt` is passed through untouched, so a width the table does state is always written.
+* The grid width is what the rows and `columns` together state (tableGridColumnCount), so a table whose rows carry cells but which states no column widths still gets one `table:table-column` per grid column; a column with no stated width takes an equal share of the default table width, the same as any column created without one. Each column's own `widthPt` is passed through untouched, so a width the table does state is always written; `isHeader` is not part of this init at all, since populateOdtTable states it afterwards via OdtTable.setHeaderColumns, the identical two-step `setHeaderRows` already needs for the same reason on the row axis.
 *
 * Throws when the table has no rows: ODF requires a `table:table` to hold at least one `table:table-row`, so no faithful spelling exists, and dropping the table would lose it without a trace. `entryPoint` names the caller in the message. A table that breaks the grid rule is refused by populateOdtTable before it writes anything, and a table with no rows has no grid fault to report, so the two checks never compete.
 */
@@ -172,7 +174,7 @@ function odtTableInit(block, entryPoint) {
 	return {
 		rows: 0,
 		columns: (0, document_schema_js.tableGridColumnCount)(block),
-		columnWidthsPt: block.columnWidthsPt
+		columnWidthsPt: block.columns.map((column) => column.widthPt)
 	};
 }
 function appendTable(body, block) {

package/dist/edit/odt/content.d.cts

@@ -1,6 +1,6 @@
 import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { t as OdtParagraph } from "../../paragraph-CRaLSzWz.cjs";
-import { o as TableInit, r as OdtTable } from "../../table-Bt9ahRyh.cjs";
+import { o as TableInit, r as OdtTable } from "../../table-DrE6jEWv.cjs";
 import { ContentDocument, ContentParagraph, ContentTable } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odt/content.d.ts
@@ -16,7 +16,7 @@ declare function populateOdtTable(table: OdtTable, block: ContentTable): void;
 /**
  * The arguments that create the empty `table:table` a ContentTable is written into: no rows, since populateOdtTable appends one per ContentTableRow, and as many columns as the table's grid is wide.
  *
- * The grid width is what the rows and `columnWidthsPt` together state (tableGridColumnCount), so a table whose rows carry cells but which states no column widths still gets one `table:table-column` per grid column; a column with no stated width takes an equal share of the default table width, the same as any column created without one. `columnWidthsPt` is passed through untouched, so a width the table does state is always written.
+ * The grid width is what the rows and `columns` together state (tableGridColumnCount), so a table whose rows carry cells but which states no column widths still gets one `table:table-column` per grid column; a column with no stated width takes an equal share of the default table width, the same as any column created without one. Each column's own `widthPt` is passed through untouched, so a width the table does state is always written; `isHeader` is not part of this init at all, since populateOdtTable states it afterwards via OdtTable.setHeaderColumns, the identical two-step `setHeaderRows` already needs for the same reason on the row axis.
  *
  * Throws when the table has no rows: ODF requires a `table:table` to hold at least one `table:table-row`, so no faithful spelling exists, and dropping the table would lose it without a trace. `entryPoint` names the caller in the message. A table that breaks the grid rule is refused by populateOdtTable before it writes anything, and a table with no rows has no grid fault to report, so the two checks never compete.
  */