js.documents 14.4.123 → 14.5.0

package/README.md

@@ -383,7 +383,25 @@ One subpath is a declared entry point in its own right: **`documents.js/read`**
 import { pdfToMarkdown } from "documents.js/read";
 ```
 
-It carries the ten `pdfTo*` conversions, `PdfToDocumentOptions`, `readDocumentMetadata` (with `ReadDocumentMetadataOptions`), `readNativeDocumentTree` (with `ReadNativeDocumentTreeOptions`), and `readContentDocument` (with `ReadContentDocumentOptions`) — identical functions to the root barrel's (the same forwarders, run through the composition engine's read half, and the same dispatch through the read-only codec half `src/codecs/read.ts`), never a forked behaviour; `convertDocument` and every X-to-PDF direction stay on the root barrel. `src/read-graph.test.ts` walks the entry's static import graph, follows `pdf-codec` specifiers through that package's real `exports` map into its source, and fails the build if the write path or any font asset becomes reachable.
+It carries the ten `pdfTo*` conversions, `PdfToDocumentOptions`, `readDocumentMetadata` (with `ReadDocumentMetadataOptions`), `readNativeDocumentTree` (with `ReadNativeDocumentTreeOptions`), and `readContentDocument` (with `ReadContentDocumentOptions`) — identical functions to the root barrel's (the same forwarders, run through the composition engine's read half, and the same read-only dispatch: `src/codecs/read.ts`'s `CONTENT_READERS` for a content format, and pdf-codec's `readPdf` directly for pdf), never a forked behaviour; `convertDocument` and every X-to-PDF direction stay on the root barrel. `src/read-graph.test.ts` walks the entry's static import graph, follows `pdf-codec` specifiers through that package's real `exports` map into its source, and fails the build if the write path or any font asset becomes reachable.
+
+### Converting a selection of a PDF's pages
+
+The PDF-sourced entry points that produce content take a `pages` option: the `pdfTo*` conversions (`PdfToDocumentOptions.pages`), `convertDocument` with a pdf source (`UnifiedConversionOptions.pages`), and `readNativeDocumentTree`/`readContentDocument` (`ReadNativeDocumentTreeOptions.pages`). It is pdf-codec's `ReadPdfOptions.pages` threaded through: zero-based page-tree indices, a negative index counted from the end (`-1` is the last page), duplicates collapsed, the result in document order, and `PdfPageSelectionError` for an index naming no page. Two entry points never take it: `readDocumentMetadata` always reads with an empty selection, since metadata never depends on page content, so identifying a document reads no page at all; and `openPdf` always reads every page, since an editor holds a document to write back. `convertDocument` applies `pages` only when the source itself is pdf: a conversion from another format ignores it, including one whose route renders an intermediate pdf internally (docx to ods), because that pdf is not the caller's document.
+
+```ts
+import { pdfToMarkdown } from "documents.js/read";
+
+const coverAndLastPage = pdfToMarkdown(pdfBytes, { pages: [0, 1, 2, -1] });
+```
+
+What a selection skips: the unselected pages' content streams are never fetched, decoded or interpreted, the fonts and images only those pages use are never resolved, and the source's embedded files are never decoded, so the result carries no attachments; a caller holding the `LayoutDocument` checks `pageCount` (set only on a page-selected read) before concluding the document has none (see pdf-codec's README for exactly what is and is not read). That is what lets a caller identify a document from its first pages, or read a code from its last page, inside a memory-capped runtime such as a Cloudflare Worker isolate, without paying for every page's content.
+
+The output holds only the selected pages, and reconstruction sees only them, so a page can come out differently than in a full conversion. Heading detection measures text against the body size, taken as the most common text size across the pages read: a cover page read on its own, dominated by large title text, takes the title's size as its body, so the title becomes a paragraph rather than a heading. Reading the cover together with a few ordinary pages restores the document's real body size.
+
+Markdown output labels each selected page with its original one-based page number, written as `<!-- page N -->` on its own line at the start of the page (`pageNumberMarker`), alongside the `<!-- page break -->` marker between pages that share a section, so a caller can tell which pages it got without re-deriving the selection. The label is output-only: reading markdown back keeps it as an ordinary HTML-comment paragraph, exactly as any other comment in a markdown source is kept. A full conversion writes no labels, so its output is unchanged. A caller composing the stages itself (`readPdf` with `pages`, `reconstructWordprocessing`, then `buildMarkdownText` or `renderContentDocumentToMarkdown`) gets the same labels by passing `pageNumbers: layout.pages.map((page, position) => sourcePageIndex(page, position) + 1)`; `buildMarkdownText` throws `MarkdownPageNumberCountError` when the count does not match the document's pages, and a non-wordprocessing document flattened by `renderContentDocumentToMarkdown` counts as a single page.
+
+Every reconstructed node's frames name the page's index in the source PDF (the same index every destination and form widget names), which is why a page-selected conversion's reported `DocumentTree` carries no `pages` envelope: that array is indexed by frame page index, and a selection cannot fill it. Such a tree cannot be rebuilt to pdf either: `buildDocumentBytes(tree, "pdf")` needs that envelope and throws without it. A later stage's own page-addressing option, such as `page` for an svg target, counts within the selection. A page-selected `LayoutDocument` cannot be written back: `writePdf` refuses one with `PdfPartialDocumentError`. `PdfPageSelectionError`, `PdfPartialDocumentError` and `sourcePageIndex` are exported from the root barrel; the `documents.js/read` entry re-exports nothing (this package allows re-exports only in its root barrel), so a caller of that entry recognises a bad selection by the thrown error's `code` (`pdf/page-out-of-range` or `pdf/page-index-not-integer`), and resolves a page's source index as `page.index ?? position`.
 
 ### Reading and building xlsx content directly
 
@@ -821,8 +839,8 @@ The package is layered from generic primitives outward to the two conversion dir
 - **`src/firebird/`** — Tier 3: gbak logical-backup reader. `reader.ts` (attribute framing + RLE decompression + XDR decoding), `schema.ts`/`data.ts` (table/row walking). No ratified spec — built against Firebird's own engine source.
 - **`src/odb/`** — decoder-selection and pivot-mapping: `read.ts` routes to the right tier, `spreadsheet.ts`/`csv.ts` map to output formats. `odb/sql/` is the bounded SQL engine, `odb/formula/` is the rpt formula engine, `odb/report/` is the renderer, `odb/values.ts` is shared comparison/aggregation semantics.
 - **`src/convert/`** — the composition layer: `convert.ts` (the named conversion functions and their option types), `composition.ts` (the pathfinder, the primitive registry, the bridge/fromPdf executors, and `convertDocumentFromPdf` — the read half of the engine), `composition-to-pdf.ts` (`executeToPdf`, the layout-engine registry, and the full `convertDocument` binding — the write half, split out so a read-only consumer never statically imports a renderer), `from-pdf.ts` (the `pdfTo*` family, `readDocumentMetadata`, `readNativeDocumentTree`, `readContentDocument`, and the `documents.js/read` entry), `codec.ts` (`z.codec()` pairs), `port.ts`/`local.ts` (the `DocumentConverter` port), `variant-bridges.ts` (cross-variant semantic transforms), and `from-package.ts` (`buildDocumentBytes`, which flattens once at the boundary). The tree ⇄ flat transform those construction sites call — `assembleTree`, `decompose`, `flattenTree`, `factorStyles` — is not implemented here: it lives in `document-schema.js`, which owns both encodings. `bijection.test.ts` is this package's own gate on it, re-running the three laws over the real corpus every reader, editor, and conversion here produces.
-- **`src/codecs/`** — `DOCUMENT_FORMAT_CODECS`: every format's read/build capability as data, so `readDocumentMetadata`/`setDocumentMetadata`/`buildDocumentBytes` dispatch through one registry.
-- **`src/metadata/`** — cross-format metadata read/write via `DOCUMENT_FORMAT_CODECS`.
+- **`src/codecs/`** — `DOCUMENT_FORMAT_CODECS`: every format's read/build capability as data, so `setDocumentMetadata`/`buildDocumentBytes` dispatch through one registry; its read halves live in `read.ts`, whose `CONTENT_READERS` `readDocumentMetadata` uses for content formats (it reads pdf through pdf-codec's `readPdf` directly, with no page selected).
+- **`src/metadata/`**: cross-format metadata write via `DOCUMENT_FORMAT_CODECS`; the read side is `readDocumentMetadata` in `src/convert/from-pdf.ts`, which reads a content format through `CONTENT_READERS` and a pdf through `readPdf` with an empty page selection.
 - **`src/package-codec.ts`** — `decodeDocumentPackage`/`encodeDocumentPackage`/`decodeOdbPackage`.
 
 Dependency direction is downward and checkable. Twelve external dependencies each own a distinct concern: `ooxml.js` (docx/pptx/xlsx), `odf.js` (odt/ods/odp/odg), `document-schema.js` (shared schemas + port contracts), `pdf-codec` (PDF codec + text-layout/font primitives), `byte-codec` (byte/image utilities), `markdown-codec` (markdown), `rtf-codec` (rtf), `wpd-codec` (wpd, read-only), `doc-codec` (doc), `xls-codec` (xls), `ppt-codec` (ppt, through this package's own `src/ppt/` envelope adapter), `archive-codec` (the `[MS-CFB]` compound-file detection all three legacy binary codecs' own bytes schemas build on). No `PdfObject`/`PdfDict`/`PdfStream` type appears anywhere in this package.

package/dist/{composition-plan-l6QPO4FX.d.ts → composition-plan-B1Nn2JCQ.d.ts}

@@ -33,6 +33,15 @@ interface UnifiedConversionOptions {
   readonly page?: number;
   readonly onSvgDiagnostic?: SvgDiagnosticSink;
   readonly clock?: ClockPort;
+  /**
+   * The pages of a pdf source to convert, as pdf-codec's `ReadPdfOptions.pages` reads them: zero-based page-tree indices, a negative index counted from the end, duplicates collapsed, the result in document order, and an index naming no page throwing `PdfPageSelectionError`. Only the plan's first hop receives it, and only when the conversion's source is pdf: a conversion from any other format ignores it, including one whose route renders an intermediate pdf internally (docx to ods goes through toPdf then fromPdf), since that pdf is not the caller's document. The unselected pages' content streams, the fonts and images only they use, and the source's embedded files are never read (see `ReadPdfOptions.pages` for exactly what is and is not skipped).
+   *
+   * The output holds only those pages. A markdown target labels each with its original one-based page number (`<!-- page 7 -->` at the start of the page, beside the usual `<!-- page break -->` between pages), so the text says which pages it holds. A page-addressing option of a later stage, such as `page` for an svg target, counts within the selection. Reconstruction infers from the selected pages alone, so a page can reconstruct differently than it would in a full conversion: the body text size heading detection compares against is the most common size across the selection, which on a cover page dominated by large title text is the title's own size, leaving the title a paragraph rather than a heading. The DocumentTree `onDocument` reports carries no `pages` envelope for a page-selected conversion: its frames name source page indices, which an envelope holding only the selected pages could not be indexed by.
+   */
+  readonly pages?: readonly number[];
+}
+interface TextBuildContext {
+  readonly pageNumbers?: readonly number[];
 }
 type ContentFormat = "docx" | "pptx" | "xlsx" | "odt" | "odp" | "ods" | "odg" | "svg" | "csv" | "markdown" | "rtf" | "doc" | "xls" | "ppt" | "epub";
 declare const CONTENT_FORMATS: readonly ContentFormat[];
@@ -51,7 +60,7 @@ interface TextFormatNode {
   readonly family: "markdown" | "csv" | "svg" | "rtf" | "doc" | "xls" | "ppt" | "epub";
   readonly decode: (bytes: Uint8Array<ArrayBuffer>) => string;
   readonly read: (text: string, options?: UnifiedConversionOptions) => ContentDocument;
-  readonly build: (content: ContentDocument, options?: UnifiedConversionOptions) => string;
+  readonly build: (content: ContentDocument, options?: UnifiedConversionOptions & TextBuildContext) => string;
   readonly encode: (text: string) => Uint8Array<ArrayBuffer>;
   readonly hasSourcePackage: false;
 }

package/dist/{composition-plan-CfvhXeOC.cjs → composition-plan-BgsXTscN.cjs}

@@ -23,7 +23,7 @@ const require_csv_write = require("./csv/write.cjs");
 const require_read$1 = require("./read-CahCZMwG.cjs");
 const require_svg_write = require("./svg/write.cjs");
 const require_ports_abort = require("./ports/abort.cjs");
-const require_reconstruct_presentations_prod = require("./reconstruct-presentations-prod-X315aBmI.cjs");
+const require_reconstruct_presentations_prod = require("./reconstruct-presentations-prod-CA4no_aw.cjs");
 const require_convert_pdf_package_tables = require("./convert/pdf-package-tables.cjs");
 const require_convert_variant_bridges = require("./convert/variant-bridges.cjs");
 const require_convert_capability = require("./convert/capability.cjs");
@@ -34,6 +34,7 @@ let doc_codec = require("doc-codec");
 let xls_codec = require("xls-codec");
 let rtf_codec = require("rtf-codec");
 let epub_codec = require("epub-codec");
+let pdf_codec_layout = require("pdf-codec/layout");
 require("markdown-codec");
 let wpd_codec = require("wpd-codec");
 let pdf_codec_read = require("pdf-codec/read");
@@ -127,7 +128,7 @@ const FORMAT_NODES = {
 			signal: options?.signal,
 			images: options?.images
 		}),
-		build: (content) => require_markdown_write.buildMarkdownText(content),
+		build: (content, options) => require_markdown_write.buildMarkdownText(content, { pageNumbers: options?.pageNumbers }),
 		encode: (text) => require_markdown_text.encodeMarkdownText(text),
 		hasSourcePackage: false
 	},
@@ -335,23 +336,31 @@ function executeBridge(source, target, bytes, options) {
 	options?.onDocument?.((0, document_schema_js.assembleTree)(buildContent));
 	return out;
 }
+function layoutPageNumbers(layout) {
+	return layout.pages.map((page, position) => (0, pdf_codec_layout.sourcePageIndex)(page, position) + 1);
+}
 function executeFromPdf(target, bytes, options) {
 	const node = FORMAT_NODES[target];
 	const layout = (0, pdf_codec_read.readPdf)(bytes, {
 		signal: options?.signal,
-		sink: options?.sink
+		sink: options?.sink,
+		pages: options?.pages
 	});
 	const content = RECONSTRUCTORS[node.variant](layout, {
 		signal: options?.signal,
 		onCellTypeInference: options?.onCellTypeInference
 	});
-	const pages = layout.pages.map((page) => ({
+	const selected = options?.pages !== void 0;
+	const pages = selected ? void 0 : layout.pages.map((page) => ({
 		widthPt: page.widthPt,
 		heightPt: page.heightPt
 	}));
 	let out;
 	if (isTextFormatNode(node)) {
-		const text = node.build(content, options);
+		const text = node.build(content, {
+			...options,
+			pageNumbers: selected ? layoutPageNumbers(layout) : void 0
+		});
 		out = node.encode(text);
 	} else {
 		const pkg = node.build(content);
@@ -367,9 +376,12 @@ function runCompositionPlan(plan, bytes, options, executors) {
 	for (let i = 0; i < plan.hops.length; i++) {
 		const hop = plan.hops[i];
 		if (hop === void 0) throw new Error("runCompositionPlan: resolveCompositionPlan returned a malformed hop");
-		const hopOptions = i === plan.hops.length - 1 ? options : options === void 0 ? void 0 : {
+		const isLastHop = i === plan.hops.length - 1;
+		const readsCallerPdf = i === 0 && hop.from === "pdf";
+		const hopOptions = options === void 0 ? void 0 : {
 			...options,
-			onDocument: void 0
+			onDocument: isLastHop ? options.onDocument : void 0,
+			pages: readsCallerPdf ? options.pages : void 0
 		};
 		if (hop.executor === "toPdf") {
 			if (!isSourceContentFormat(hop.from)) throw new Error(`runCompositionPlan: toPdf source '${hop.from}' is not a content format`);

package/dist/{composition-plan-DU9nPPN7.d.cts → composition-plan-Cofo9qPI.d.cts}

@@ -33,6 +33,15 @@ interface UnifiedConversionOptions {
   readonly page?: number;
   readonly onSvgDiagnostic?: SvgDiagnosticSink;
   readonly clock?: ClockPort;
+  /**
+   * The pages of a pdf source to convert, as pdf-codec's `ReadPdfOptions.pages` reads them: zero-based page-tree indices, a negative index counted from the end, duplicates collapsed, the result in document order, and an index naming no page throwing `PdfPageSelectionError`. Only the plan's first hop receives it, and only when the conversion's source is pdf: a conversion from any other format ignores it, including one whose route renders an intermediate pdf internally (docx to ods goes through toPdf then fromPdf), since that pdf is not the caller's document. The unselected pages' content streams, the fonts and images only they use, and the source's embedded files are never read (see `ReadPdfOptions.pages` for exactly what is and is not skipped).
+   *
+   * The output holds only those pages. A markdown target labels each with its original one-based page number (`<!-- page 7 -->` at the start of the page, beside the usual `<!-- page break -->` between pages), so the text says which pages it holds. A page-addressing option of a later stage, such as `page` for an svg target, counts within the selection. Reconstruction infers from the selected pages alone, so a page can reconstruct differently than it would in a full conversion: the body text size heading detection compares against is the most common size across the selection, which on a cover page dominated by large title text is the title's own size, leaving the title a paragraph rather than a heading. The DocumentTree `onDocument` reports carries no `pages` envelope for a page-selected conversion: its frames name source page indices, which an envelope holding only the selected pages could not be indexed by.
+   */
+  readonly pages?: readonly number[];
+}
+interface TextBuildContext {
+  readonly pageNumbers?: readonly number[];
 }
 type ContentFormat = "docx" | "pptx" | "xlsx" | "odt" | "odp" | "ods" | "odg" | "svg" | "csv" | "markdown" | "rtf" | "doc" | "xls" | "ppt" | "epub";
 declare const CONTENT_FORMATS: readonly ContentFormat[];
@@ -51,7 +60,7 @@ interface TextFormatNode {
   readonly family: "markdown" | "csv" | "svg" | "rtf" | "doc" | "xls" | "ppt" | "epub";
   readonly decode: (bytes: Uint8Array<ArrayBuffer>) => string;
   readonly read: (text: string, options?: UnifiedConversionOptions) => ContentDocument;
-  readonly build: (content: ContentDocument, options?: UnifiedConversionOptions) => string;
+  readonly build: (content: ContentDocument, options?: UnifiedConversionOptions & TextBuildContext) => string;
   readonly encode: (text: string) => Uint8Array<ArrayBuffer>;
   readonly hasSourcePackage: false;
 }

package/dist/{composition-plan-f0zaExUW.js → composition-plan-mRolIOZY.js}

@@ -23,7 +23,7 @@ import { buildCsvText } from "./csv/write.js";
 import { i as readSvgContent } from "./read-BSH--XB4.js";
 import { buildSvgText } from "./svg/write.js";
 import { throwIfAborted } from "./ports/abort.js";
-import { _ as reconstructWordprocessing, g as reconstructSpreadsheet, i as reconstructPresentation, r as reconstructDrawing } from "./reconstruct-presentations-prod-B5fkPiRZ.js";
+import { _ as reconstructWordprocessing, g as reconstructSpreadsheet, i as reconstructPresentation, r as reconstructDrawing } from "./reconstruct-presentations-prod-CC8ct-5O.js";
 import { stampPdfPackageTables } from "./convert/pdf-package-tables.js";
 import { drawingToPresentation, presentationToDrawing, presentationToWordprocessing, spreadsheetToWordprocessing, wordprocessingToPresentation } from "./convert/variant-bridges.js";
 import { UnsupportedConversionError } from "./convert/capability.js";
@@ -34,6 +34,7 @@ import { readDocContent, writeDocContent } from "doc-codec";
 import { readXlsContent, writeXlsContent } from "xls-codec";
 import { readRtfContent, rtfBytesFromLatin1, writeRtfContent } from "rtf-codec";
 import { readEpubContent, writeEpubContent } from "epub-codec";
+import { sourcePageIndex } from "pdf-codec/layout";
 import "markdown-codec";
 import { readWpdContent } from "wpd-codec";
 import { readPdf } from "pdf-codec/read";
@@ -127,7 +128,7 @@ const FORMAT_NODES = {
 			signal: options?.signal,
 			images: options?.images
 		}),
-		build: (content) => buildMarkdownText(content),
+		build: (content, options) => buildMarkdownText(content, { pageNumbers: options?.pageNumbers }),
 		encode: (text) => encodeMarkdownText(text),
 		hasSourcePackage: false
 	},
@@ -335,23 +336,31 @@ function executeBridge(source, target, bytes, options) {
 	options?.onDocument?.(assembleTree(buildContent));
 	return out;
 }
+function layoutPageNumbers(layout) {
+	return layout.pages.map((page, position) => sourcePageIndex(page, position) + 1);
+}
 function executeFromPdf(target, bytes, options) {
 	const node = FORMAT_NODES[target];
 	const layout = readPdf(bytes, {
 		signal: options?.signal,
-		sink: options?.sink
+		sink: options?.sink,
+		pages: options?.pages
 	});
 	const content = RECONSTRUCTORS[node.variant](layout, {
 		signal: options?.signal,
 		onCellTypeInference: options?.onCellTypeInference
 	});
-	const pages = layout.pages.map((page) => ({
+	const selected = options?.pages !== void 0;
+	const pages = selected ? void 0 : layout.pages.map((page) => ({
 		widthPt: page.widthPt,
 		heightPt: page.heightPt
 	}));
 	let out;
 	if (isTextFormatNode(node)) {
-		const text = node.build(content, options);
+		const text = node.build(content, {
+			...options,
+			pageNumbers: selected ? layoutPageNumbers(layout) : void 0
+		});
 		out = node.encode(text);
 	} else {
 		const pkg = node.build(content);
@@ -367,9 +376,12 @@ function runCompositionPlan(plan, bytes, options, executors) {
 	for (let i = 0; i < plan.hops.length; i++) {
 		const hop = plan.hops[i];
 		if (hop === void 0) throw new Error("runCompositionPlan: resolveCompositionPlan returned a malformed hop");
-		const hopOptions = i === plan.hops.length - 1 ? options : options === void 0 ? void 0 : {
+		const isLastHop = i === plan.hops.length - 1;
+		const readsCallerPdf = i === 0 && hop.from === "pdf";
+		const hopOptions = options === void 0 ? void 0 : {
 			...options,
-			onDocument: void 0
+			onDocument: isLastHop ? options.onDocument : void 0,
+			pages: readsCallerPdf ? options.pages : void 0
 		};
 		if (hop.executor === "toPdf") {
 			if (!isSourceContentFormat(hop.from)) throw new Error(`runCompositionPlan: toPdf source '${hop.from}' is not a content format`);

package/dist/convert/composition-plan.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_composition_plan = require("../composition-plan-CfvhXeOC.cjs");
+const require_composition_plan = require("../composition-plan-BgsXTscN.cjs");
 exports.buildCompositionGraph = require_composition_plan.buildCompositionGraph;
 exports.isContentFormat = require_composition_plan.isContentFormat;
 exports.isSourceContentFormat = require_composition_plan.isSourceContentFormat;

package/dist/convert/composition-plan.d.cts

@@ -1,2 +1,2 @@
-import { a as buildCompositionGraph, c as resolveCompositionPlan, i as HopExecutor, l as shortestPath, n as ConversionPlan, o as isContentFormat, r as GraphEdge, s as isSourceContentFormat, t as CompositionHop } from "../composition-plan-DU9nPPN7.cjs";
+import { a as buildCompositionGraph, c as resolveCompositionPlan, i as HopExecutor, l as shortestPath, n as ConversionPlan, o as isContentFormat, r as GraphEdge, s as isSourceContentFormat, t as CompositionHop } from "../composition-plan-Cofo9qPI.cjs";
 export { CompositionHop, ConversionPlan, GraphEdge, HopExecutor, buildCompositionGraph, isContentFormat, isSourceContentFormat, resolveCompositionPlan, shortestPath };

package/dist/convert/composition-plan.d.ts

@@ -1,2 +1,2 @@
-import { a as buildCompositionGraph, c as resolveCompositionPlan, i as HopExecutor, l as shortestPath, n as ConversionPlan, o as isContentFormat, r as GraphEdge, s as isSourceContentFormat, t as CompositionHop } from "../composition-plan-l6QPO4FX.js";
+import { a as buildCompositionGraph, c as resolveCompositionPlan, i as HopExecutor, l as shortestPath, n as ConversionPlan, o as isContentFormat, r as GraphEdge, s as isSourceContentFormat, t as CompositionHop } from "../composition-plan-B1Nn2JCQ.js";
 export { CompositionHop, ConversionPlan, GraphEdge, HopExecutor, buildCompositionGraph, isContentFormat, isSourceContentFormat, resolveCompositionPlan, shortestPath };

package/dist/convert/composition-plan.js

@@ -1,2 +1,2 @@
-import { a as shortestPath, i as resolveCompositionPlan, n as isContentFormat, r as isSourceContentFormat, t as buildCompositionGraph } from "../composition-plan-f0zaExUW.js";
+import { a as shortestPath, i as resolveCompositionPlan, n as isContentFormat, r as isSourceContentFormat, t as buildCompositionGraph } from "../composition-plan-mRolIOZY.js";
 export { buildCompositionGraph, isContentFormat, isSourceContentFormat, resolveCompositionPlan, shortestPath };

package/dist/convert/composition-to-pdf.cjs

@@ -7,7 +7,7 @@ const require_ports_abort = require("../ports/abort.cjs");
 const require_sheets = require("../sheets-BQCpNXsE.cjs");
 const require_layout_drawing = require("../layout/drawing.cjs");
 const require_convert_capability = require("./capability.cjs");
-const require_composition_plan = require("../composition-plan-CfvhXeOC.cjs");
+const require_composition_plan = require("../composition-plan-BgsXTscN.cjs");
 let document_schema_js = require("document-schema.js");
 let pdf_codec = require("pdf-codec");
 //#region src/convert/composition-to-pdf.ts

package/dist/convert/composition-to-pdf.d.cts

@@ -1,5 +1,5 @@
 import { DocumentFormat } from "./port.cjs";
-import { S as SourceContentFormat, T as UnifiedConversionOptions } from "../composition-plan-DU9nPPN7.cjs";
+import { S as SourceContentFormat, T as UnifiedConversionOptions } from "../composition-plan-Cofo9qPI.cjs";
 //#region src/convert/composition-to-pdf.d.ts
 declare function executeToPdf(format: SourceContentFormat, bytes: Uint8Array<ArrayBuffer>, options?: UnifiedConversionOptions): Uint8Array<ArrayBuffer>;
 declare function convertDocument(source: DocumentFormat, target: DocumentFormat, bytes: Uint8Array<ArrayBuffer>, options?: UnifiedConversionOptions): Uint8Array<ArrayBuffer>;

package/dist/convert/composition-to-pdf.d.ts

@@ -1,5 +1,5 @@
 import { DocumentFormat } from "./port.js";
-import { S as SourceContentFormat, T as UnifiedConversionOptions } from "../composition-plan-l6QPO4FX.js";
+import { S as SourceContentFormat, T as UnifiedConversionOptions } from "../composition-plan-B1Nn2JCQ.js";
 //#region src/convert/composition-to-pdf.d.ts
 declare function executeToPdf(format: SourceContentFormat, bytes: Uint8Array<ArrayBuffer>, options?: UnifiedConversionOptions): Uint8Array<ArrayBuffer>;
 declare function convertDocument(source: DocumentFormat, target: DocumentFormat, bytes: Uint8Array<ArrayBuffer>, options?: UnifiedConversionOptions): Uint8Array<ArrayBuffer>;

package/dist/convert/composition-to-pdf.js

@@ -6,7 +6,7 @@ import { throwIfAborted } from "../ports/abort.js";
 import { l as convertSpreadsheetToLayout } from "../sheets-DWDvGN-g.js";
 import { convertDrawingToLayout } from "../layout/drawing.js";
 import { UnsupportedConversionError } from "./capability.js";
-import { _ as executeFromPdf, b as runCompositionPlan, c as LAYOUT_CAPABLE, d as READ_ONLY_FORMAT_NODES, g as executeBridge, i as resolveCompositionPlan, s as FORMAT_NODES, v as isReadOnlyContentFormat, y as isTextFormatNode } from "../composition-plan-f0zaExUW.js";
+import { _ as executeFromPdf, b as runCompositionPlan, c as LAYOUT_CAPABLE, d as READ_ONLY_FORMAT_NODES, g as executeBridge, i as resolveCompositionPlan, s as FORMAT_NODES, v as isReadOnlyContentFormat, y as isTextFormatNode } from "../composition-plan-mRolIOZY.js";
 import { assembleTree } from "document-schema.js";
 import { createFontMeasurer, createFontRegistry, loadMathFont, writePdf } from "pdf-codec";
 //#region src/convert/composition-to-pdf.ts

package/dist/convert/composition.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_composition_plan = require("../composition-plan-CfvhXeOC.cjs");
+const require_composition_plan = require("../composition-plan-BgsXTscN.cjs");
 exports.CONTENT_FORMATS = require_composition_plan.CONTENT_FORMATS;
 exports.FORMAT_NODES = require_composition_plan.FORMAT_NODES;
 exports.LAYOUT_CAPABLE = require_composition_plan.LAYOUT_CAPABLE;

package/dist/convert/composition.d.cts

@@ -1,2 +1,2 @@
-import { A as isTextFormatNode, C as THROUGH_PDF_EDGE_COST, D as executeBridge, E as convertDocumentFromPdf, O as executeFromPdf, S as SourceContentFormat, T as UnifiedConversionOptions, _ as READ_ONLY_CONTENT_FORMATS, b as ReadOnlyContentFormat, d as CompositionExecutorBinding, f as ContentFormat, g as MAX_CONVERSION_PATH_NODES, h as LAYOUT_CAPABLE, j as runCompositionPlan, k as isReadOnlyContentFormat, m as FormatNode, p as FORMAT_NODES, u as CONTENT_FORMATS, v as READ_ONLY_FORMAT_NODES, w as TRANSFORMS, x as ReadOnlyFormatNode, y as RECONSTRUCTORS } from "../composition-plan-DU9nPPN7.cjs";
+import { A as isTextFormatNode, C as THROUGH_PDF_EDGE_COST, D as executeBridge, E as convertDocumentFromPdf, O as executeFromPdf, S as SourceContentFormat, T as UnifiedConversionOptions, _ as READ_ONLY_CONTENT_FORMATS, b as ReadOnlyContentFormat, d as CompositionExecutorBinding, f as ContentFormat, g as MAX_CONVERSION_PATH_NODES, h as LAYOUT_CAPABLE, j as runCompositionPlan, k as isReadOnlyContentFormat, m as FormatNode, p as FORMAT_NODES, u as CONTENT_FORMATS, v as READ_ONLY_FORMAT_NODES, w as TRANSFORMS, x as ReadOnlyFormatNode, y as RECONSTRUCTORS } from "../composition-plan-Cofo9qPI.cjs";
 export { CONTENT_FORMATS, CompositionExecutorBinding, ContentFormat, FORMAT_NODES, FormatNode, LAYOUT_CAPABLE, MAX_CONVERSION_PATH_NODES, READ_ONLY_CONTENT_FORMATS, READ_ONLY_FORMAT_NODES, RECONSTRUCTORS, ReadOnlyContentFormat, ReadOnlyFormatNode, SourceContentFormat, THROUGH_PDF_EDGE_COST, TRANSFORMS, UnifiedConversionOptions, convertDocumentFromPdf, executeBridge, executeFromPdf, isReadOnlyContentFormat, isTextFormatNode, runCompositionPlan };

package/dist/convert/composition.d.ts

@@ -1,2 +1,2 @@
-import { A as isTextFormatNode, C as THROUGH_PDF_EDGE_COST, D as executeBridge, E as convertDocumentFromPdf, O as executeFromPdf, S as SourceContentFormat, T as UnifiedConversionOptions, _ as READ_ONLY_CONTENT_FORMATS, b as ReadOnlyContentFormat, d as CompositionExecutorBinding, f as ContentFormat, g as MAX_CONVERSION_PATH_NODES, h as LAYOUT_CAPABLE, j as runCompositionPlan, k as isReadOnlyContentFormat, m as FormatNode, p as FORMAT_NODES, u as CONTENT_FORMATS, v as READ_ONLY_FORMAT_NODES, w as TRANSFORMS, x as ReadOnlyFormatNode, y as RECONSTRUCTORS } from "../composition-plan-l6QPO4FX.js";
+import { A as isTextFormatNode, C as THROUGH_PDF_EDGE_COST, D as executeBridge, E as convertDocumentFromPdf, O as executeFromPdf, S as SourceContentFormat, T as UnifiedConversionOptions, _ as READ_ONLY_CONTENT_FORMATS, b as ReadOnlyContentFormat, d as CompositionExecutorBinding, f as ContentFormat, g as MAX_CONVERSION_PATH_NODES, h as LAYOUT_CAPABLE, j as runCompositionPlan, k as isReadOnlyContentFormat, m as FormatNode, p as FORMAT_NODES, u as CONTENT_FORMATS, v as READ_ONLY_FORMAT_NODES, w as TRANSFORMS, x as ReadOnlyFormatNode, y as RECONSTRUCTORS } from "../composition-plan-B1Nn2JCQ.js";
 export { CONTENT_FORMATS, CompositionExecutorBinding, ContentFormat, FORMAT_NODES, FormatNode, LAYOUT_CAPABLE, MAX_CONVERSION_PATH_NODES, READ_ONLY_CONTENT_FORMATS, READ_ONLY_FORMAT_NODES, RECONSTRUCTORS, ReadOnlyContentFormat, ReadOnlyFormatNode, SourceContentFormat, THROUGH_PDF_EDGE_COST, TRANSFORMS, UnifiedConversionOptions, convertDocumentFromPdf, executeBridge, executeFromPdf, isReadOnlyContentFormat, isTextFormatNode, runCompositionPlan };

package/dist/convert/composition.js

@@ -1,2 +1,2 @@
-import { _ as executeFromPdf, b as runCompositionPlan, c as LAYOUT_CAPABLE, d as READ_ONLY_FORMAT_NODES, f as RECONSTRUCTORS, g as executeBridge, h as convertDocumentFromPdf, l as MAX_CONVERSION_PATH_NODES, m as TRANSFORMS, o as CONTENT_FORMATS, p as THROUGH_PDF_EDGE_COST, s as FORMAT_NODES, u as READ_ONLY_CONTENT_FORMATS, v as isReadOnlyContentFormat, y as isTextFormatNode } from "../composition-plan-f0zaExUW.js";
+import { _ as executeFromPdf, b as runCompositionPlan, c as LAYOUT_CAPABLE, d as READ_ONLY_FORMAT_NODES, f as RECONSTRUCTORS, g as executeBridge, h as convertDocumentFromPdf, l as MAX_CONVERSION_PATH_NODES, m as TRANSFORMS, o as CONTENT_FORMATS, p as THROUGH_PDF_EDGE_COST, s as FORMAT_NODES, u as READ_ONLY_CONTENT_FORMATS, v as isReadOnlyContentFormat, y as isTextFormatNode } from "../composition-plan-mRolIOZY.js";
 export { CONTENT_FORMATS, FORMAT_NODES, LAYOUT_CAPABLE, MAX_CONVERSION_PATH_NODES, READ_ONLY_CONTENT_FORMATS, READ_ONLY_FORMAT_NODES, RECONSTRUCTORS, THROUGH_PDF_EDGE_COST, TRANSFORMS, convertDocumentFromPdf, executeBridge, executeFromPdf, isReadOnlyContentFormat, isTextFormatNode, runCompositionPlan };

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, so 'pdf' is not a reachable target from it: only a package dumped from a <format>-to-pdf conversion or a full pdf-to-<format> conversion carries them. A bridge conversion's own dump (e.g. odt-to-docx) never does, and neither does a page-selected pdf-to-<format> conversion's, whose frames name source page indices a pages array of only the selection could not be indexed by");
 		const { document: layout, formulas, fonts } = packageToLayout(pkg);
 		return (0, pdf_codec.writePdf)(layout, formulas.length > 0 ? {
 			formulas,

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, so 'pdf' is not a reachable target from it: only a package dumped from a <format>-to-pdf conversion or a full pdf-to-<format> conversion carries them. A bridge conversion's own dump (e.g. odt-to-docx) never does, and neither does a page-selected pdf-to-<format> conversion's, whose frames name source page indices a pages array of only the selection could not be indexed by");
 		const { document: layout, formulas, fonts } = packageToLayout(pkg);
 		return writePdf(layout, formulas.length > 0 ? {
 			formulas,

package/dist/convert/from-pdf.cjs

@@ -1,20 +1,24 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_reconstruct_presentations_prod = require("../reconstruct-presentations-prod-X315aBmI.cjs");
+const require_reconstruct_presentations_prod = require("../reconstruct-presentations-prod-CA4no_aw.cjs");
 const require_convert_pdf_package_tables = require("./pdf-package-tables.cjs");
-const require_composition_plan = require("../composition-plan-CfvhXeOC.cjs");
+const require_composition_plan = require("../composition-plan-BgsXTscN.cjs");
 const require_codecs_read = require("../codecs/read.cjs");
 let document_schema_js = require("document-schema.js");
 let pdf_codec_read = require("pdf-codec/read");
 //#region src/convert/from-pdf.ts
 function readDocumentMetadata(format, bytes, options) {
-	if (format === "pdf") return require_codecs_read.readDocumentLayout(bytes, { signal: options?.signal }).metadata;
+	if (format === "pdf") return (0, pdf_codec_read.readPdf)(bytes, {
+		signal: options?.signal,
+		pages: []
+	}).metadata;
 	return require_codecs_read.CONTENT_READERS[format](bytes, { signal: options?.signal }).metadata;
 }
 function readNativeContent(format, bytes, options) {
 	if (format === "pdf") {
 		const layout = (0, pdf_codec_read.readPdf)(bytes, {
 			signal: options?.signal,
-			sink: options?.sink
+			sink: options?.sink,
+			pages: options?.pages
 		});
 		return {
 			content: require_reconstruct_presentations_prod.reconstructWordprocessing(layout, { signal: options?.signal }),
@@ -29,10 +33,10 @@ function readNativeContent(format, bytes, options) {
 function readNativeDocumentTree(format, bytes, options) {
 	const { content, layout } = readNativeContent(format, bytes, options);
 	if (layout !== void 0) {
-		const pages = layout.pages.map((page) => ({
+		const pages = options?.pages === void 0 ? layout.pages.map((page) => ({
 			widthPt: page.widthPt,
 			heightPt: page.heightPt
-		}));
+		})) : void 0;
 		const reported = (0, document_schema_js.assembleTree)(content, pages);
 		require_convert_pdf_package_tables.stampPdfPackageTables(reported, layout);
 		return reported;

package/dist/convert/from-pdf.d.cts

@@ -12,6 +12,10 @@ interface ReadNativeDocumentTreeOptions {
   readonly signal?: AbortSignal;
   readonly images?: MarkdownImageResolver;
   readonly sink?: PdfDiagnosticSink;
+  /**
+   * The pages of a pdf source to read, exactly as UnifiedConversionOptions.pages describes them (zero-based, negative from the end, document order, `PdfPageSelectionError` for an index naming no page). Consulted only for a pdf source, since no other format's reader has pages to select. The unselected pages' content streams, the fonts and images only they use, and the source's embedded files are never read, and the selected pages are reconstructed from themselves alone (see PdfToDocumentOptions.pages for how that can change a cover page's headings). Every frame in the result names the page's index in the source PDF, so a DocumentTree read this way carries no `pages` envelope: that array is indexed by those source indices and a selection cannot fill it.
+   */
+  readonly pages?: readonly number[];
 }
 type ReadContentDocumentOptions = ReadNativeDocumentTreeOptions;
 declare function readNativeDocumentTree(format: DocumentFormat, bytes: Uint8Array<ArrayBuffer>, options?: ReadNativeDocumentTreeOptions): DocumentTree;
@@ -19,6 +23,12 @@ declare function readContentDocument(format: DocumentFormat, bytes: Uint8Array<A
 interface PdfToDocumentOptions {
   readonly signal?: AbortSignal;
   readonly sink?: PdfDiagnosticSink;
+  /**
+   * The pages to convert, exactly as UnifiedConversionOptions.pages describes them: zero-based page-tree indices, a negative index counted from the end, duplicates collapsed, document order, and `PdfPageSelectionError` for an index naming no page. The unselected pages' content streams, the fonts and images only they use, and the source's embedded files are never read. pdfToMarkdown labels each page it writes with its original one-based page number (`<!-- page 7 -->`), so the text says which pages it holds.
+   *
+   * Reconstruction sees only the selected pages, so a page can come out differently than it would in a full conversion. Heading detection measures text against the body size, taken as the most common size across the pages read: a cover page read on its own, dominated by large title text, takes the title's size as its body, and the title is then a paragraph rather than a heading. Reading the cover together with a few ordinary pages restores the document's real body size.
+   */
+  readonly pages?: readonly number[];
   readonly onDocument?: (pkg: DocumentTree) => void;
 }
 declare function pdfToDocx(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;

package/dist/convert/from-pdf.d.ts

@@ -12,6 +12,10 @@ interface ReadNativeDocumentTreeOptions {
   readonly signal?: AbortSignal;
   readonly images?: MarkdownImageResolver;
   readonly sink?: PdfDiagnosticSink;
+  /**
+   * The pages of a pdf source to read, exactly as UnifiedConversionOptions.pages describes them (zero-based, negative from the end, document order, `PdfPageSelectionError` for an index naming no page). Consulted only for a pdf source, since no other format's reader has pages to select. The unselected pages' content streams, the fonts and images only they use, and the source's embedded files are never read, and the selected pages are reconstructed from themselves alone (see PdfToDocumentOptions.pages for how that can change a cover page's headings). Every frame in the result names the page's index in the source PDF, so a DocumentTree read this way carries no `pages` envelope: that array is indexed by those source indices and a selection cannot fill it.
+   */
+  readonly pages?: readonly number[];
 }
 type ReadContentDocumentOptions = ReadNativeDocumentTreeOptions;
 declare function readNativeDocumentTree(format: DocumentFormat, bytes: Uint8Array<ArrayBuffer>, options?: ReadNativeDocumentTreeOptions): DocumentTree;
@@ -19,6 +23,12 @@ declare function readContentDocument(format: DocumentFormat, bytes: Uint8Array<A
 interface PdfToDocumentOptions {
   readonly signal?: AbortSignal;
   readonly sink?: PdfDiagnosticSink;
+  /**
+   * The pages to convert, exactly as UnifiedConversionOptions.pages describes them: zero-based page-tree indices, a negative index counted from the end, duplicates collapsed, document order, and `PdfPageSelectionError` for an index naming no page. The unselected pages' content streams, the fonts and images only they use, and the source's embedded files are never read. pdfToMarkdown labels each page it writes with its original one-based page number (`<!-- page 7 -->`), so the text says which pages it holds.
+   *
+   * Reconstruction sees only the selected pages, so a page can come out differently than it would in a full conversion. Heading detection measures text against the body size, taken as the most common size across the pages read: a cover page read on its own, dominated by large title text, takes the title's size as its body, and the title is then a paragraph rather than a heading. Reading the cover together with a few ordinary pages restores the document's real body size.
+   */
+  readonly pages?: readonly number[];
   readonly onDocument?: (pkg: DocumentTree) => void;
 }
 declare function pdfToDocx(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;

package/dist/convert/from-pdf.js

@@ -1,19 +1,23 @@
-import { _ as reconstructWordprocessing } from "../reconstruct-presentations-prod-B5fkPiRZ.js";
+import { _ as reconstructWordprocessing } from "../reconstruct-presentations-prod-CC8ct-5O.js";
 import { stampPdfPackageTables } from "./pdf-package-tables.js";
-import { h as convertDocumentFromPdf } from "../composition-plan-f0zaExUW.js";
-import { CONTENT_READERS, readDocumentLayout } from "../codecs/read.js";
+import { h as convertDocumentFromPdf } from "../composition-plan-mRolIOZY.js";
+import { CONTENT_READERS } from "../codecs/read.js";
 import { assembleTree } from "document-schema.js";
 import { readPdf } from "pdf-codec/read";
 //#region src/convert/from-pdf.ts
 function readDocumentMetadata(format, bytes, options) {
-	if (format === "pdf") return readDocumentLayout(bytes, { signal: options?.signal }).metadata;
+	if (format === "pdf") return readPdf(bytes, {
+		signal: options?.signal,
+		pages: []
+	}).metadata;
 	return CONTENT_READERS[format](bytes, { signal: options?.signal }).metadata;
 }
 function readNativeContent(format, bytes, options) {
 	if (format === "pdf") {
 		const layout = readPdf(bytes, {
 			signal: options?.signal,
-			sink: options?.sink
+			sink: options?.sink,
+			pages: options?.pages
 		});
 		return {
 			content: reconstructWordprocessing(layout, { signal: options?.signal }),
@@ -28,10 +32,10 @@ function readNativeContent(format, bytes, options) {
 function readNativeDocumentTree(format, bytes, options) {
 	const { content, layout } = readNativeContent(format, bytes, options);
 	if (layout !== void 0) {
-		const pages = layout.pages.map((page) => ({
+		const pages = options?.pages === void 0 ? layout.pages.map((page) => ({
 			widthPt: page.widthPt,
 			heightPt: page.heightPt
-		}));
+		})) : void 0;
 		const reported = assembleTree(content, pages);
 		stampPdfPackageTables(reported, layout);
 		return reported;

package/dist/convert/local.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_convert_capability = require("./capability.cjs");
 const require_convert_port = require("./port.cjs");
-const require_composition_plan = require("../composition-plan-CfvhXeOC.cjs");
+const require_composition_plan = require("../composition-plan-BgsXTscN.cjs");
 const require_convert_composition_to_pdf = require("./composition-to-pdf.cjs");
 const require_convert_convert = require("./convert.cjs");
 //#region src/convert/local.ts

package/dist/convert/local.js

@@ -1,6 +1,6 @@
 import { UnsupportedConversionError } from "./capability.js";
 import { DOCUMENT_FORMATS } from "./port.js";
-import { i as resolveCompositionPlan } from "../composition-plan-f0zaExUW.js";
+import { i as resolveCompositionPlan } from "../composition-plan-mRolIOZY.js";
 import { convertDocument } from "./composition-to-pdf.js";
 import { odfToPdf } from "./convert.js";
 //#region src/convert/local.ts

package/dist/convert/pdf-package-tables.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let pdf_codec_layout = require("pdf-codec/layout");
 //#region src/convert/pdf-package-tables.ts
 function stampPdfPackageTables(pkg, layout) {
 	if (layout.destinations !== void 0 || layout.outline !== void 0) {
@@ -56,7 +57,8 @@ function stampPdfPackageTables(pkg, layout) {
 		...layout.source
 	};
 	const definitions = {};
-	layout.pages.forEach((page, pageIndex) => {
+	layout.pages.forEach((page, position) => {
+		const pageIndex = (0, pdf_codec_layout.sourcePageIndex)(page, position);
 		(page.annotations ?? []).forEach((annotation, annotIndex) => {
 			definitions[`pdf-annot-${String(pageIndex)}-${String(annotIndex)}`] = {
 				kind: "comment",

package/dist/convert/pdf-package-tables.js

@@ -1,3 +1,4 @@
+import { sourcePageIndex } from "pdf-codec/layout";
 //#region src/convert/pdf-package-tables.ts
 function stampPdfPackageTables(pkg, layout) {
 	if (layout.destinations !== void 0 || layout.outline !== void 0) {
@@ -55,7 +56,8 @@ function stampPdfPackageTables(pkg, layout) {
 		...layout.source
 	};
 	const definitions = {};
-	layout.pages.forEach((page, pageIndex) => {
+	layout.pages.forEach((page, position) => {
+		const pageIndex = sourcePageIndex(page, position);
 		(page.annotations ?? []).forEach((annotation, annotIndex) => {
 			definitions[`pdf-annot-${String(pageIndex)}-${String(annotIndex)}`] = {
 				kind: "comment",

package/dist/edit/ods/floating.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_xml_fragment = require("../../xml/fragment.cjs");
 const require_xml_edit = require("../../xml/edit.cjs");
 const require_odf_package_formula = require("../../odf-package/formula.cjs");
+const require_xml_odf_text = require("../../xml/odf-text.cjs");
 const require_odf_package_media = require("../../odf-package/media.cjs");
 const require_edit_odf_repeated_runs = require("../odf-repeated-runs.cjs");
 const require_edit_ods_address = require("./address.cjs");
@@ -63,20 +64,21 @@ function cumulativeRowOffsetPt(pkg, tableElement, anchorRow) {
 	if (cursor < anchorRow) offsetPt += (anchorRow - cursor) * DEFAULT_ROW_HEIGHT_PT;
 	return offsetPt;
 }
-function buildAbsoluteFrame(xPt, yPt, widthPt, heightPt, content) {
+function buildAbsoluteFrame(xPt, yPt, widthPt, heightPt, content, altText) {
+	const children = altText === void 0 ? [content] : [require_xml_fragment.el("svg:title", {}, require_xml_odf_text.encodeOdfText(altText)), content];
 	return require_xml_fragment.el("draw:frame", {
 		"svg:x": (0, odf_js.formatOdfLength)(xPt),
 		"svg:y": (0, odf_js.formatOdfLength)(yPt),
 		"svg:width": (0, odf_js.formatOdfLength)(widthPt),
 		"svg:height": (0, odf_js.formatOdfLength)(heightPt)
-	}, [content]);
+	}, children);
 }
 function insertSheetImage(pkg, tableElement, image) {
 	const { partPath } = require_odf_package_media.addImageMedia(pkg, (0, odf_js.base64ToBytes)(image.base64), image.format);
 	const xPt = cumulativeColumnOffsetPt(pkg, tableElement, image.anchorColumn) + image.offsetXPt;
 	const yPt = cumulativeRowOffsetPt(pkg, tableElement, image.anchorRow) + image.offsetYPt;
 	const imageElement = require_xml_fragment.el("draw:image", { "xlink:href": partPath });
-	const frame = buildAbsoluteFrame(xPt, yPt, image.widthPt, image.heightPt, imageElement);
+	const frame = buildAbsoluteFrame(xPt, yPt, image.widthPt, image.heightPt, imageElement, image.altText);
 	ensureTableShapes(tableElement).children.push(frame);
 }
 function insertSheetEmbeddedObject(pkg, tableElement, object, nextObjectName) {