postext-pdf 0.1.0

package/dist/pdf-backend/fontHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontHelpers.js","sourceRoot":"","sources":["../../src/pdf-backend/fontHelpers.ts"],"names":[],"mappings":"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"}

package/dist/pdf-backend/headerFooter.d.ts

@@ -0,0 +1,15 @@
+import type { VDTDesignSlot } from 'postext';
+import { type ResourceImageMap } from './renderResourceBlock';
+import { type ArtifactSpec, type StructElem } from './tagging';
+/** How an accessible render tags a design slot: its text goes to the
+ *  element `text()` returns (created on first use), or counts as an
+ *  artifact when `text` is absent (running headers / footers); rules,
+ *  boxes and images are always artifacts of class `artifact`. */
+export interface SlotMark {
+    text?: () => StructElem;
+    artifact: ArtifactSpec;
+}
+import { FontCache } from '../fontCache';
+import { type PageCtx } from './primitives';
+export declare function renderHeaderFooterSlot(ctx: PageCtx, slot: VDTDesignSlot, fontCache: FontCache, images?: ResourceImageMap, mark?: SlotMark): void;
+//# sourceMappingURL=headerFooter.d.ts.map

package/dist/pdf-backend/headerFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerFooter.d.ts","sourceRoot":"","sources":["../../src/pdf-backend/headerFooter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAMd,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAA2B,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAExF;;;iEAGiE;AACjE,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,UAAU,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAQD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,KAAK,OAAO,EAMb,MAAM,cAAc,CAAC;AAuItB,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,gBAAgB,EACzB,IAAI,CAAC,EAAE,QAAQ,GACd,IAAI,CAWN"}

package/dist/pdf-backend/headerFooter.js

@@ -0,0 +1,145 @@
+import { setCharacterSpacing } from 'pdf-lib';
+import { drawEmbeddedResource } from './renderResourceBlock';
+import { tagArtifact, tagContent } from './tagging';
+function tagSlotText(ctx, mark) {
+    if (!mark)
+        return;
+    if (mark.text)
+        tagContent(ctx, mark.text());
+    else
+        tagArtifact(ctx, mark.artifact);
+}
+import { parseFontString } from '../fontString';
+import { colorFromHex, drawTextPx, fillRectPx, pushClipRect, popClip, } from './primitives';
+function drawRoundedBox(ctx, xPx, yPx, wPx, hPx, style) {
+    if (wPx <= 0 || hPx <= 0)
+        return;
+    const { scale, pageHeightPt } = ctx;
+    const radius = Math.max(0, Math.min(style.borderRadiusPx, wPx / 2, hPx / 2));
+    const width = wPx * scale;
+    const height = hPx * scale;
+    if (radius <= 0) {
+        const x = xPx * scale;
+        const y = pageHeightPt - (yPx + hPx) * scale;
+        if (style.backgroundColor) {
+            ctx.page.drawRectangle({
+                x,
+                y,
+                width,
+                height,
+                color: colorFromHex(style.backgroundColor, ctx.colorSpace),
+            });
+        }
+        if (style.borderColor && style.borderWidthPx > 0) {
+            ctx.page.drawRectangle({
+                x,
+                y,
+                width,
+                height,
+                borderColor: colorFromHex(style.borderColor, ctx.colorSpace),
+                borderWidth: style.borderWidthPx * scale,
+            });
+        }
+        return;
+    }
+    // pdf-lib 1.x has no borderRadius on drawRectangle, so a rounded box is an
+    // SVG path. `drawSvgPath` interprets the path in SVG space (y grows
+    // downwards) from the origin passed as `x`/`y`, so anchor it at the top-left
+    // corner of the page and express the corners in top-down points.
+    const r = radius * scale;
+    const sx = xPx * scale;
+    const sy = yPx * scale;
+    const path = `M ${sx + r} ${sy}` +
+        ` L ${sx + width - r} ${sy}` +
+        ` A ${r} ${r} 0 0 1 ${sx + width} ${sy + r}` +
+        ` L ${sx + width} ${sy + height - r}` +
+        ` A ${r} ${r} 0 0 1 ${sx + width - r} ${sy + height}` +
+        ` L ${sx + r} ${sy + height}` +
+        ` A ${r} ${r} 0 0 1 ${sx} ${sy + height - r}` +
+        ` L ${sx} ${sy + r}` +
+        ` A ${r} ${r} 0 0 1 ${sx + r} ${sy} Z`;
+    const origin = { x: 0, y: pageHeightPt };
+    if (style.backgroundColor) {
+        ctx.page.drawSvgPath(path, {
+            ...origin,
+            color: colorFromHex(style.backgroundColor, ctx.colorSpace),
+        });
+    }
+    if (style.borderColor && style.borderWidthPx > 0) {
+        ctx.page.drawSvgPath(path, {
+            ...origin,
+            borderColor: colorFromHex(style.borderColor, ctx.colorSpace),
+            borderWidth: style.borderWidthPx * scale,
+        });
+    }
+}
+function renderTextBlock(ctx, block, fontCache, mark) {
+    if (block.box) {
+        if (mark)
+            tagArtifact(ctx, mark.artifact);
+        drawRoundedBox(ctx, block.bbox.x, block.bbox.y, block.bbox.width, block.bbox.height, block.box);
+    }
+    const font = fontCache.get(block.fontString);
+    if (!font)
+        return;
+    const size = parseFontString(block.fontString)?.sizePx ?? 0;
+    const color = colorFromHex(block.color, ctx.colorSpace);
+    const clip = block.clip;
+    if (clip) {
+        pushClipRect(ctx, block.bbox.x, block.bbox.y, block.bbox.width, block.bbox.height);
+    }
+    const tracked = block.letterSpacingPx !== undefined && block.letterSpacingPx > 0;
+    if (tracked)
+        ctx.page.pushOperators(setCharacterSpacing(block.letterSpacingPx * ctx.scale));
+    tagSlotText(ctx, mark);
+    for (const line of block.lines) {
+        drawTextPx(ctx, line.text, block.bbox.x + line.xOffset, line.baselineY, font, size, color);
+    }
+    if (tracked)
+        ctx.page.pushOperators(setCharacterSpacing(0));
+    if (clip)
+        popClip(ctx);
+}
+function renderRuleBlock(ctx, block) {
+    const color = colorFromHex(block.color, ctx.colorSpace);
+    if (block.direction === 'vertical') {
+        fillRectPx(ctx, block.bbox.x, block.bbox.y, block.thicknessPx, block.bbox.height, color);
+    }
+    else {
+        fillRectPx(ctx, block.bbox.x, block.bbox.y, block.bbox.width, block.thicknessPx, color);
+    }
+}
+function renderBoxBlock(ctx, block) {
+    drawRoundedBox(ctx, block.bbox.x, block.bbox.y, block.bbox.width, block.bbox.height, block.box);
+}
+/** Image block (e.g. a callout icon): drawn from the preloaded resource
+ *  image map, with a neutral placeholder when the image is absent. */
+function renderImageBlock(ctx, block, images) {
+    const { x, y, width, height } = block.bbox;
+    if (width <= 0 || height <= 0)
+        return;
+    const embedded = images?.get(block.fileId);
+    if (embedded) {
+        drawEmbeddedResource(ctx, embedded, x, y, width, height);
+    }
+    else {
+        fillRectPx(ctx, x, y, width, height, colorFromHex('#e8e8e8', ctx.colorSpace));
+    }
+}
+export function renderHeaderFooterSlot(ctx, slot, fontCache, images, mark) {
+    for (const block of slot.blocks) {
+        if (block.kind === 'text') {
+            renderTextBlock(ctx, block, fontCache, mark);
+            continue;
+        }
+        if (mark)
+            tagArtifact(ctx, mark.artifact);
+        if (block.kind === 'rule')
+            renderRuleBlock(ctx, block);
+        else if (block.kind === 'image')
+            renderImageBlock(ctx, block, images);
+        else
+            renderBoxBlock(ctx, block);
+    }
+}
+//# sourceMappingURL=headerFooter.js.map

package/dist/pdf-backend/headerFooter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerFooter.js","sourceRoot":"","sources":["../../src/pdf-backend/headerFooter.ts"],"names":[],"mappings":"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"}

package/dist/pdf-backend/index.d.ts

@@ -0,0 +1,47 @@
+import type { SvgRasterizer } from './renderResourceBlock';
+import type { PdfColorSpace, VDTDocument } from 'postext';
+import { type PdfFontProvider } from '../fontCache';
+import { type ResourceBytesProvider } from './renderResourceBlock';
+export interface RenderToPdfOptions {
+    fontProvider: PdfFontProvider;
+    pageNegative?: boolean;
+    /** Emit a PDF outline tree (bookmarks) so readers can jump between
+     *  headings. Defaults to true. */
+    outlines?: boolean;
+    /** Force every colour in the rendered output through the given PDF colour
+     *  space. Defaults to `'rgb'` (pdf-lib's native output). */
+    colorSpace?: PdfColorSpace;
+    /** Resolver for resource binary bytes by `fileId`. The bytes are sniffed:
+     *  bitmaps embed as images, SVG markup is emitted as vector paths (or
+     *  rasterised in the browser when it uses unsupported features), and a
+     *  single-page PDF (`Resource.svg.pdfFileId` print masters) is embedded
+     *  verbatim. When omitted, resource images are drawn as placeholders. */
+    resourceBytes?: ResourceBytesProvider;
+    /** Emit an accessible, tagged PDF (PDF/UA-1 oriented): logical structure
+     *  tree, alt text on figures, document language and title, decoration
+     *  flagged as artifacts. Defaults to true. */
+    accessible?: boolean;
+    /** Called as the render advances: after the fonts and resources are
+     *  embedded, after every page, and before the file is written. */
+    onProgress?: (progress: RenderProgress) => void;
+    /** Rasterises an SVG the vector subset cannot draw. Defaults to the
+     *  document's `Image` + canvas; a worker must supply one (its host's). */
+    rasterizeSvg?: SvgRasterizer;
+}
+export interface RenderProgress {
+    phase: 'prepare' | 'pages' | 'save';
+    /** Pages rendered so far, and how many there are. */
+    pages: number;
+    totalPages: number;
+}
+export type { PdfFontProvider };
+export type { ResourceBytesProvider } from './renderResourceBlock';
+/**
+ * Render one document — or a book, as the documents of its chapters in
+ * order, each laid out with the continuation of the ones before it — into
+ * one PDF. The chapters share fonts, embedded resources and the structure
+ * tree; page indices in contents links are book-absolute already, so they
+ * resolve across chapters.
+ */
+export declare function renderToPdf(input: VDTDocument | VDTDocument[], options: RenderToPdfOptions): Promise<Uint8Array>;
+//# sourceMappingURL=index.d.ts.map

package/dist/pdf-backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pdf-backend/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE7E,OAAO,KAAK,EAAqB,aAAa,EAAY,WAAW,EAAW,MAAM,SAAS,CAAC;AAEhG,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAqB/D,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;sCACkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;gEAC4D;IAC5D,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B;;;;6EAIyE;IACzE,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC;;kDAE8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;sEACkE;IAClE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD;8EAC0E;IAC1E,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACpC,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY,EAAE,eAAe,EAAE,CAAC;AAChC,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAyLnE;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,EAClC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CA6ErB"}

package/dist/pdf-backend/index.js

@@ -0,0 +1,227 @@
+import { PDFDocument, BlendMode, } from 'pdf-lib';
+import fontkit from '@pdf-lib/fontkit';
+import { computePageTextExtent, dimensionToPx } from 'postext';
+import { FontCache } from '../fontCache';
+import { colorFromHex, fillRectPx, makeScale, popClip, pushClipRect, whiteColor, } from './primitives';
+import { collectFontStrings } from './fontHelpers';
+import { computeContentArea, renderBaselineGrid, renderColumnRule, renderCutLines, } from './pageDecorations';
+import { renderBlock } from './blockRender';
+import { renderHeaderFooterSlot } from './headerFooter';
+import { addOutlines } from './outlines';
+import { addPageLabels } from './pageLabels';
+import { preloadResourceImages, } from './renderResourceBlock';
+import { LinkRegistry } from './links';
+import { StructTree, tagArtifact } from './tagging';
+import { StructureFlow } from './structureFlow';
+/** BCP 47 tag of a postext locale (`/Lang`). */
+function languageTag(locale) {
+    if (!locale)
+        return undefined;
+    const [lang, region] = locale.split('-');
+    return region ? `${lang}-${region.toUpperCase()}` : lang;
+}
+/** Title of the document for the PDF metadata: the declared title, else the
+ *  first heading (PDF/UA-1 §7.1 requires one). */
+function documentTitle(docs) {
+    const declared = docs[0]?.metadata?.title?.trim();
+    if (declared)
+        return declared;
+    let best;
+    for (const doc of docs) {
+        for (const block of doc.blocks) {
+            if (block.type !== 'heading')
+                continue;
+            if (!best || (block.headingLevel ?? 1) < (best.headingLevel ?? 1))
+                best = block;
+            if ((best.headingLevel ?? 1) === 1)
+                break;
+        }
+        if (best && (best.headingLevel ?? 1) === 1)
+            break;
+    }
+    const text = best?.lines.map((l) => l.text).join(' ').replace(/\s+/g, ' ').trim();
+    if (text)
+        return best?.numberPrefix && !text.startsWith(best.numberPrefix) ? `${best.numberPrefix} ${text}` : text;
+    return 'Document';
+}
+/** The heading element an opener band's text belongs to: the part title on
+ *  a part-divider page, else the `span: 'page'` heading the band replaced
+ *  (hidden in its column), else a plain paragraph. */
+function openerTextElem(page, structure) {
+    let elem;
+    return () => {
+        if (elem)
+            return elem;
+        if (page.partInfo)
+            return (elem = structure.partHeading());
+        for (const col of page.columns) {
+            for (const block of col.blocks) {
+                if (block.hidden && block.type === 'heading')
+                    return (elem = structure.blockElem(block));
+            }
+        }
+        return (elem = structure.tree.root.child('P'));
+    };
+}
+function renderPage(pdfDoc, vdtPage, doc, fontCache, pageNegative, colorSpace, resourceCtx, tree) {
+    const scale = makeScale(doc.config.page.dpi);
+    const pageWidthPt = vdtPage.width * scale;
+    const pageHeightPt = vdtPage.height * scale;
+    const page = pdfDoc.addPage([pageWidthPt, pageHeightPt]);
+    const ctx = { page, pageHeightPt, scale, colorSpace, tags: tree?.beginPage(page) };
+    const structure = resourceCtx.structure;
+    // Background: full page white first (cut-mark area stays white), then the
+    // trim+bleed area filled with the configured page background colour.
+    tagArtifact(ctx, { type: 'Background' });
+    fillRectPx(ctx, 0, 0, vdtPage.width, vdtPage.height, whiteColor(colorSpace));
+    const bgHex = doc.config.page.backgroundColor.hex;
+    const trimOff = doc.trimOffset;
+    if (bgHex && bgHex !== 'transparent') {
+        const bleedPx = trimOff > 0
+            ? dimensionToPx(doc.config.page.cutLines.bleed, doc.config.page.dpi)
+            : 0;
+        fillRectPx(ctx, trimOff - bleedPx, trimOff - bleedPx, vdtPage.width - (trimOff - bleedPx) * 2, vdtPage.height - (trimOff - bleedPx) * 2, colorFromHex(bgHex, colorSpace));
+    }
+    tagArtifact(ctx, { type: 'Layout' });
+    if (doc.config.page.baselineGrid.enabled) {
+        // Bound the grid to the page's actual text: from the first text line to
+        // the last (mirrors the canvas backend). Pages with no text draw no grid.
+        const textExtent = computePageTextExtent(vdtPage);
+        if (textExtent) {
+            const contentArea = computeContentArea(vdtPage, doc);
+            const gridLineWidthPx = dimensionToPx(doc.config.page.baselineGrid.lineWidth, doc.config.page.dpi);
+            renderBaselineGrid(ctx, contentArea, doc.baselineGrid, doc.config.page.baselineGrid.color.hex, gridLineWidthPx, textExtent);
+        }
+    }
+    if (doc.config.layout.columnRule.enabled && vdtPage.columns.length > 1) {
+        const crLineWidthPx = dimensionToPx(doc.config.layout.columnRule.lineWidth, doc.config.page.dpi);
+        renderColumnRule(ctx, vdtPage.columns, doc.config.layout.columnRule.color.hex, crLineWidthPx);
+    }
+    // Opener / part bands go under the columns so their backgrounds sit
+    // beneath the body text (mirrors the canvas backend). Their text is the
+    // chapter / part heading; the rest of the band is decoration.
+    if (vdtPage.openerBand) {
+        renderHeaderFooterSlot(ctx, vdtPage.openerBand, fontCache, resourceCtx.images, structure ? { text: openerTextElem(vdtPage, structure), artifact: { type: 'Layout' } } : undefined);
+    }
+    const clipOverhang = dimensionToPx({ value: 2, unit: 'pt' }, doc.config.page.dpi);
+    for (const col of vdtPage.columns) {
+        pushClipRect(ctx, col.bbox.x - clipOverhang, col.bbox.y, col.bbox.width + clipOverhang * 2, col.bbox.height);
+        for (const block of col.blocks) {
+            if (block.tocPart && block.designOverlay)
+                continue;
+            renderBlock(ctx, block, col.bbox.width, col.bbox.x, fontCache, resourceCtx);
+        }
+        popClip(ctx);
+        // A part row of the contents carries a design of its own, which may
+        // run past the column (a band reaching beyond the page numbers): it
+        // is drawn outside the column clip, like a float.
+        for (const block of col.blocks) {
+            if (block.tocPart && block.designOverlay)
+                renderBlock(ctx, block, col.bbox.width, col.bbox.x, fontCache, resourceCtx);
+        }
+    }
+    // Floated resources sit outside the column clip (a `span: 'page'` float can
+    // cross the gutter); they carry an absolute bbox positioned at build time.
+    if (vdtPage.floats) {
+        for (const fb of vdtPage.floats) {
+            renderBlock(ctx, fb, fb.bbox.width, fb.bbox.x, fontCache, resourceCtx);
+        }
+    }
+    // Running headers and footers are pagination artifacts.
+    const pagination = (subtype) => structure ? { artifact: { type: 'Pagination', subtype } } : undefined;
+    if (vdtPage.header)
+        renderHeaderFooterSlot(ctx, vdtPage.header, fontCache, resourceCtx.images, pagination('Header'));
+    if (vdtPage.footer)
+        renderHeaderFooterSlot(ctx, vdtPage.footer, fontCache, resourceCtx.images, pagination('Footer'));
+    // Page negative: overlay white rect with Difference blend across trim+bleed.
+    // Crop marks remain un-inverted (drawn afterwards).
+    tagArtifact(ctx, { type: 'Page' });
+    if (pageNegative) {
+        const bleedPx = trimOff > 0
+            ? dimensionToPx(doc.config.page.cutLines.bleed, doc.config.page.dpi)
+            : 0;
+        const invX = trimOff - bleedPx;
+        const invY = trimOff - bleedPx;
+        const invW = vdtPage.width - (trimOff - bleedPx) * 2;
+        const invH = vdtPage.height - (trimOff - bleedPx) * 2;
+        fillRectPx(ctx, invX, invY, invW, invH, whiteColor(colorSpace), BlendMode.Difference);
+    }
+    renderCutLines(ctx, vdtPage, doc);
+    ctx.tags?.close();
+}
+/**
+ * Render one document — or a book, as the documents of its chapters in
+ * order, each laid out with the continuation of the ones before it — into
+ * one PDF. The chapters share fonts, embedded resources and the structure
+ * tree; page indices in contents links are book-absolute already, so they
+ * resolve across chapters.
+ */
+export async function renderToPdf(input, options) {
+    const docs = Array.isArray(input) ? input : [input];
+    const first = docs[0];
+    if (!first)
+        throw new Error('postext-pdf: nothing to render');
+    const totalPages = docs.reduce((n, d) => n + d.pages.length, 0);
+    const pdfDoc = await PDFDocument.create();
+    pdfDoc.registerFontkit(fontkit);
+    if (first.metadata?.title)
+        pdfDoc.setTitle(first.metadata.title);
+    if (first.metadata?.author)
+        pdfDoc.setAuthor(first.metadata.author);
+    pdfDoc.setCreator('postext');
+    pdfDoc.setProducer('postext-pdf');
+    const fontCache = new FontCache(pdfDoc, options.fontProvider);
+    for (const doc of docs)
+        await fontCache.preloadFontStrings(collectFontStrings(doc));
+    const missing = fontCache.missing();
+    if (missing.length > 0) {
+        throw new Error(`postext-pdf: failed to load font(s): ${missing.join(', ')}`);
+    }
+    const colorSpace = options.colorSpace ?? 'rgb';
+    // Accessible output: the structure tree the pages tag their content into.
+    const tree = (options.accessible ?? true)
+        ? new StructTree(pdfDoc, {
+            title: documentTitle(docs),
+            author: first.metadata?.author,
+            lang: languageTag(first.config.bodyText.hyphenation?.locale),
+            producer: 'postext-pdf',
+            creatorTool: 'postext',
+        })
+        : undefined;
+    // Resource images are embedded up front (async) so page rendering stays
+    // sync; one map for every document, so a figure reused across chapters
+    // is embedded once.
+    const resourceImages = new Map();
+    for (const doc of docs) {
+        await preloadResourceImages(pdfDoc, doc, options.resourceBytes, fontCache, options.fontProvider, resourceImages, options.rasterizeSvg);
+    }
+    options.onProgress?.({ phase: 'prepare', pages: 0, totalPages });
+    // Contents links carry book-absolute page indices; the registry maps them
+    // onto the PDF's pages from the first document's offset.
+    const linkRegistry = new LinkRegistry(first.pageIndexOffset ?? 0);
+    let rendered = 0;
+    for (const doc of docs) {
+        // Block ids restart per document: each gets its own structure flow
+        // (paragraph fragments, lists and callouts never span chapters).
+        const resourceCtx = {
+            images: resourceImages,
+            linkRegistry,
+            structure: tree ? new StructureFlow(tree) : undefined,
+        };
+        for (const page of doc.pages) {
+            renderPage(pdfDoc, page, doc, fontCache, options.pageNegative ?? false, colorSpace, resourceCtx, tree);
+            rendered++;
+            options.onProgress?.({ phase: 'pages', pages: rendered, totalPages });
+        }
+    }
+    // Attach inline-ref link annotations now that every destination is known.
+    linkRegistry.finalize(pdfDoc, tree);
+    if (options.outlines ?? true) {
+        addOutlines(pdfDoc, docs);
+    }
+    addPageLabels(pdfDoc, docs);
+    tree?.finalize();
+    options.onProgress?.({ phase: 'save', pages: rendered, totalPages });
+    return pdfDoc.save();
+}
+//# sourceMappingURL=index.js.map

package/dist/pdf-backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pdf-backend/index.ts"],"names":[],"mappings":"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"}

package/dist/pdf-backend/links.d.ts

@@ -0,0 +1,44 @@
+/**
+ * PDF link helpers for resource references (issue #49 §7) and the contents.
+ *
+ * Each `::resource{id=…}` embed creates a named destination keyed by the
+ * resource id (an `[page /XYZ left top zoom]` array pointing at the embed's
+ * top-left). Each inline `:ref{id=…}` becomes a `/Link` annotation whose
+ * rectangle covers the rendered ref text and whose `/Dest` is the matching
+ * destination. A row of the contents (`:::toc`) becomes a `/Link` to the
+ * top of the page it lists, when that page is in the document.
+ *
+ * Destinations and links can be emitted in any page order, so collection is
+ * two-phase: callers record destinations + pending links during page rendering,
+ * then call {@link finalizeLinks} after every page has been drawn to attach the
+ * annotations (resolving each link to its destination).
+ */
+import { type PDFDocument, type PDFPage } from 'pdf-lib';
+import type { StructElem, StructTree } from './tagging';
+/** Structure bookkeeping of a link in an accessible render: the `Link`
+ *  element wrapping the ref text, and the annotation's `/Contents`. */
+export interface LinkStruct {
+    elem: StructElem;
+    contents: string;
+}
+export declare class LinkRegistry {
+    private readonly pageIndexOffset;
+    private dests;
+    private pending;
+    /** Physical pages before the document's first page. */
+    constructor(pageIndexOffset?: number);
+    /** Record the named destination for a resource embed (idempotent — the first
+     *  embed of a given id wins, matching first-reference numbering). */
+    addDestination(resourceId: string, page: PDFPage, leftPt: number, topPt: number): void;
+    /** Record a pending inline-ref link to be attached at finalize. */
+    addLink(page: PDFPage, rect: [number, number, number, number], resourceId: string, struct?: LinkStruct): void;
+    /** Record a pending link to the top of a book page (a contents row). */
+    addPageLink(page: PDFPage, rect: [number, number, number, number], pageIndex: number, struct?: LinkStruct): void;
+    /** Attach all pending link annotations. Links whose destination resource was
+     *  never embedded are skipped (they still rendered as styled text; in a
+     *  tagged render their `Link` element dissolves into the paragraph). With
+     *  `tree`, each annotation joins its `Link` element (`OBJR` kid,
+     *  `/StructParent`) and carries `/Contents` (PDF/UA-1 §7.18.5). */
+    finalize(pdfDoc: PDFDocument, tree?: StructTree): void;
+}
+//# sourceMappingURL=links.d.ts.map

package/dist/pdf-backend/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/pdf-backend/links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,OAAO,EAEb,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAExD;uEACuE;AACvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsBD,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJ5C,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAqB;IAEpC,uDAAuD;gBAC1B,eAAe,SAAI;IAEhD;yEACqE;IACrE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKtF,mEAAmE;IACnE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAI7G,wEAAwE;IACxE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAIhH;;;;uEAImE;IACnE,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI;CA2DvD"}

package/dist/pdf-backend/links.js

@@ -0,0 +1,110 @@
+/**
+ * PDF link helpers for resource references (issue #49 §7) and the contents.
+ *
+ * Each `::resource{id=…}` embed creates a named destination keyed by the
+ * resource id (an `[page /XYZ left top zoom]` array pointing at the embed's
+ * top-left). Each inline `:ref{id=…}` becomes a `/Link` annotation whose
+ * rectangle covers the rendered ref text and whose `/Dest` is the matching
+ * destination. A row of the contents (`:::toc`) becomes a `/Link` to the
+ * top of the page it lists, when that page is in the document.
+ *
+ * Destinations and links can be emitted in any page order, so collection is
+ * two-phase: callers record destinations + pending links during page rendering,
+ * then call {@link finalizeLinks} after every page has been drawn to attach the
+ * annotations (resolving each link to its destination).
+ */
+import { PDFHexString, PDFName, PDFArray, PDFNumber, } from 'pdf-lib';
+export class LinkRegistry {
+    pageIndexOffset;
+    dests = new Map();
+    pending = [];
+    /** Physical pages before the document's first page. */
+    constructor(pageIndexOffset = 0) {
+        this.pageIndexOffset = pageIndexOffset;
+    }
+    /** Record the named destination for a resource embed (idempotent — the first
+     *  embed of a given id wins, matching first-reference numbering). */
+    addDestination(resourceId, page, leftPt, topPt) {
+        if (this.dests.has(resourceId))
+            return;
+        this.dests.set(resourceId, { page, leftPt, topPt });
+    }
+    /** Record a pending inline-ref link to be attached at finalize. */
+    addLink(page, rect, resourceId, struct) {
+        this.pending.push({ page, rect, resourceId, struct });
+    }
+    /** Record a pending link to the top of a book page (a contents row). */
+    addPageLink(page, rect, pageIndex, struct) {
+        this.pending.push({ page, rect, pageIndex, struct });
+    }
+    /** Attach all pending link annotations. Links whose destination resource was
+     *  never embedded are skipped (they still rendered as styled text; in a
+     *  tagged render their `Link` element dissolves into the paragraph). With
+     *  `tree`, each annotation joins its `Link` element (`OBJR` kid,
+     *  `/StructParent`) and carries `/Contents` (PDF/UA-1 §7.18.5). */
+    finalize(pdfDoc, tree) {
+        const context = pdfDoc.context;
+        const pages = pdfDoc.getPages();
+        // Group annotation refs per page so each page's /Annots array is written once.
+        const perPage = new Map();
+        for (const link of this.pending) {
+            let destArray;
+            if (link.pageIndex !== undefined) {
+                // A page outside the document (a chapter rendered on its own
+                // listing the whole book) gets no link.
+                const target = pages[link.pageIndex - this.pageIndexOffset];
+                if (!target) {
+                    if (link.struct && tree)
+                        tree.dissolve(link.struct.elem);
+                    continue;
+                }
+                destArray = context.obj([target.ref, PDFName.of('XYZ'), null, target.getHeight(), null]);
+            }
+            else {
+                const dest = link.resourceId !== undefined ? this.dests.get(link.resourceId) : undefined;
+                if (!dest) {
+                    if (link.struct && tree)
+                        tree.dissolve(link.struct.elem);
+                    continue;
+                }
+                destArray = context.obj([
+                    dest.page.ref,
+                    PDFName.of('XYZ'),
+                    dest.leftPt,
+                    dest.topPt,
+                    null,
+                ]);
+            }
+            const annot = context.obj({
+                Type: PDFName.of('Annot'),
+                Subtype: PDFName.of('Link'),
+                Rect: context.obj(link.rect),
+                Border: context.obj([0, 0, 0]),
+                F: PDFNumber.of(4),
+                Dest: destArray,
+            });
+            const ref = context.nextRef();
+            if (link.struct && tree) {
+                annot.set(PDFName.of('Contents'), PDFHexString.fromText(link.struct.contents));
+                annot.set(PDFName.of('StructParent'), PDFNumber.of(tree.annotation(link.struct.elem, link.page, ref)));
+            }
+            context.assign(ref, annot);
+            const list = perPage.get(link.page);
+            if (list)
+                list.push(ref);
+            else
+                perPage.set(link.page, [ref]);
+        }
+        for (const [page, refs] of perPage) {
+            const existing = page.node.get(PDFName.of('Annots'));
+            if (existing instanceof PDFArray) {
+                for (const ref of refs)
+                    existing.push(ref);
+            }
+            else {
+                page.node.set(PDFName.of('Annots'), context.obj(refs));
+            }
+        }
+    }
+}
+//# sourceMappingURL=links.js.map