pretext-pdf 0.1.1

package/dist/types.d.ts

@@ -0,0 +1,697 @@
+/**
+ * pretext-pdf — Public and internal TypeScript types
+ */
+import type { NamedPageSize } from './page-sizes.js';
+/** Top-level document descriptor. Named PdfDocument to avoid clash with browser window.Document */
+export interface PdfDocument {
+    /** Page size. Default: 'A4' (595×842 pt). Custom: [width, height] in pt. */
+    pageSize?: NamedPageSize | [number, number];
+    /** Page margins in pt. Default: all 72pt (1 inch). */
+    margins?: Partial<Margins>;
+    /** Default font family for body text. Default: 'Inter' */
+    defaultFont?: string;
+    /** Default font size in pt. Default: 12 */
+    defaultFontSize?: number;
+    /** Default line height in pt. Default: fontSize * 1.5 */
+    defaultLineHeight?: number;
+    /** Custom fonts to load and embed. Inter 400 is always available without specifying. */
+    fonts?: FontSpec[];
+    /** Header rendered at top of every page. Supports {{pageNumber}} and {{totalPages}}. */
+    header?: HeaderFooterSpec;
+    /** Footer rendered at bottom of every page. Supports {{pageNumber}} and {{totalPages}}. */
+    footer?: HeaderFooterSpec;
+    /** Watermark overlay rendered on every page behind content. Text or image. */
+    watermark?: WatermarkSpec;
+    /** Password protection and permission control for the output PDF. */
+    encryption?: EncryptionSpec;
+    /** PDF bookmark outline (sidebar navigation). Defaults to enabled. Set to false to disable bookmarks entirely. */
+    bookmarks?: false | BookmarkConfig;
+    /** Automatic word hyphenation using Liang's algorithm. Requires installing the matching `hyphenation.XX` npm package. */
+    hyphenation?: HyphenationConfig;
+    /** PDF document metadata written into the file's properties. */
+    metadata?: DocumentMetadata;
+    /** Document content elements, rendered top-to-bottom. */
+    content: ContentElement[];
+}
+export interface DocumentMetadata {
+    /** Document title shown in PDF viewer title bar. */
+    title?: string;
+    /** Author name. */
+    author?: string;
+    /** Subject / description. */
+    subject?: string;
+    /** Searchable keywords. */
+    keywords?: string[];
+    /** Producing application name. Default: 'pretext-pdf' */
+    creator?: string;
+}
+export interface Margins {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+export interface FontSpec {
+    /** Font family name, e.g. 'Roboto'. Used in fontFamily fields. */
+    family: string;
+    /** Font weight. Default: 400 */
+    weight?: 400 | 700;
+    /** Font style. Default: 'normal' */
+    style?: 'normal' | 'italic';
+    /** Absolute file path (Node.js) or font bytes (browser). */
+    src: string | Uint8Array;
+}
+export interface HeaderFooterSpec {
+    /** Text content. Use {{pageNumber}} and {{totalPages}} as tokens. */
+    text: string;
+    /** Font size in pt. Default: 10 */
+    fontSize?: number;
+    /** Alignment. Default: 'center' */
+    align?: 'left' | 'center' | 'right';
+    /** Font family. Default: document.defaultFont */
+    fontFamily?: string;
+    /** Font weight. Default: 400 */
+    fontWeight?: 400 | 700;
+    /** Text color as 6-digit hex. Default: '#666666' */
+    color?: string;
+}
+export interface WatermarkSpec {
+    /** Text to render as watermark. Either text or image required. */
+    text?: string;
+    /** Absolute path or Uint8Array of a PNG/JPG image. Either text or image required. */
+    image?: string | Uint8Array;
+    /** Font family for text watermark. Default: document.defaultFont */
+    fontFamily?: string;
+    /** Font weight. Default: 400 */
+    fontWeight?: 400 | 700;
+    /** Font size in pt. Default: auto-computed from page diagonal */
+    fontSize?: number;
+    /** Color as 6-digit hex. Default: '#CCCCCC' */
+    color?: string;
+    /** Opacity 0.0–1.0. Default: 0.3 */
+    opacity?: number;
+    /** Rotation in degrees (counter-clockwise). Default: -45 */
+    rotation?: number;
+}
+export interface EncryptionSpec {
+    /** Password required to OPEN the document. If omitted, document opens without a password
+     *  but permissions still apply. */
+    userPassword?: string;
+    /** Password for full unrestricted access. If omitted, a random owner password is generated
+     *  (preventing tools from bypassing permissions). */
+    ownerPassword?: string;
+    /** Permissions granted to anyone who opens the document (with or without user password).
+     *  Only applied when encryption is active. */
+    permissions?: {
+        /** Allow printing. Default: true */
+        printing?: boolean;
+        /** Allow copying text/graphics. Default: true */
+        copying?: boolean;
+        /** Allow modifying content. Default: false */
+        modifying?: boolean;
+        /** Allow adding/editing annotations and forms. Default: true */
+        annotating?: boolean;
+    };
+}
+export interface BookmarkConfig {
+    /** Minimum heading level to include in outline. Default: 1 */
+    minLevel?: 1 | 2 | 3 | 4;
+    /** Maximum heading level to include in outline. Default: 4 */
+    maxLevel?: 1 | 2 | 3 | 4;
+}
+export interface HyphenationConfig {
+    /** Language code matching the `hyphenation.XX` npm package. e.g. 'en-us', 'de', 'fr'. Required. */
+    language: string;
+    /** Minimum word length to attempt hyphenation. Default: 6 */
+    minWordLength?: number;
+    /** Minimum characters before the hyphen. Default: 2 */
+    leftMin?: number;
+    /** Minimum characters after the hyphen. Default: 3 */
+    rightMin?: number;
+}
+export type ContentElement = ParagraphElement | HeadingElement | SpacerElement | TableElement | ImageElement | SvgElement | ListElement | HorizontalRuleElement | PageBreakElement | CodeBlockElement | RichParagraphElement | BlockquoteElement | TocElement | TocEntryElement;
+export interface ParagraphElement {
+    type: 'paragraph';
+    text: string;
+    /** Text direction: 'ltr' = left-to-right, 'rtl' = right-to-left, 'auto' = detect from character dominance. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** Font size in pt. Default: document.defaultFontSize */
+    fontSize?: number;
+    /** Line height in pt. Default: fontSize * 1.5 */
+    lineHeight?: number;
+    /** Font family name. Default: document.defaultFont */
+    fontFamily?: string;
+    /** Font weight. Default: 400 */
+    fontWeight?: 400 | 700;
+    /** Text color as 6-digit hex. Default: '#000000' */
+    color?: string;
+    /** Text alignment. Default: 'left' for LTR, 'right' for RTL (auto-detected) */
+    align?: 'left' | 'center' | 'right' | 'justify';
+    /** Background color as 6-digit hex. Drawn behind the text block. Default: none */
+    bgColor?: string;
+    /** Extra space below this element in pt. Default: 0 */
+    spaceAfter?: number;
+    /** Extra space above this element in pt. Default: 0 */
+    spaceBefore?: number;
+    /** If true, never break this block across pages. Default: false */
+    keepTogether?: boolean;
+    /** Underline all text in this element. Default: false */
+    underline?: boolean;
+    /** Strikethrough all text in this element. Default: false */
+    strikethrough?: boolean;
+    /** Clickable URL for the entire paragraph. Opens in browser when clicked. */
+    url?: string;
+    /** Number of columns for multi-column layout. Default: 1 (single column) */
+    columns?: number;
+    /** Gap between columns in pt. Default: 24 */
+    columnGap?: number;
+    /** Set to false to disable hyphenation for this element. Default: inherits from doc.hyphenation. */
+    hyphenate?: false;
+}
+export interface HeadingElement {
+    type: 'heading';
+    level: 1 | 2 | 3 | 4;
+    text: string;
+    /** Text direction: 'ltr' = left-to-right, 'rtl' = right-to-left, 'auto' = detect from character dominance. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** Font family override. Default: document.defaultFont */
+    fontFamily?: string;
+    /** Font weight override. Default: 700 */
+    fontWeight?: 400 | 700;
+    /** Font size override in pt. Default: per-level default (h1=28, h2=22, h3=18, h4=15) */
+    fontSize?: number;
+    /** Line height override in pt. Default: fontSize * 1.3 */
+    lineHeight?: number;
+    /** Text alignment. Default: 'left' for LTR, 'right' for RTL (auto-detected) */
+    align?: 'left' | 'center' | 'right' | 'justify';
+    /** Text color as 6-digit hex. Default: '#000000' */
+    color?: string;
+    /** Background color as 6-digit hex. Drawn behind the text block. Default: none */
+    bgColor?: string;
+    /** Extra space above this element in pt. Default: 0 */
+    spaceBefore?: number;
+    /** Extra space below this element in pt. Default: per-level default */
+    spaceAfter?: number;
+    /** If true, never break this block across pages. Default: true */
+    keepTogether?: boolean;
+    /** Underline all text in this element. Default: false */
+    underline?: boolean;
+    /** Strikethrough all text in this element. Default: false */
+    strikethrough?: boolean;
+    /** Set to false to exclude this heading from the PDF bookmark outline. Default: included. */
+    bookmark?: false;
+    /** Set to false to disable hyphenation for this element. Default: inherits from doc.hyphenation. */
+    hyphenate?: false;
+    /** Clickable URL for the entire heading. Opens in browser when clicked. */
+    url?: string;
+    /** Named anchor destination for internal links. Allows other spans to link to this heading via href: '#anchorId'. */
+    anchor?: string;
+}
+export interface SpacerElement {
+    type: 'spacer';
+    /** Height in pt */
+    height: number;
+}
+export interface TableElement {
+    type: 'table';
+    columns: ColumnDef[];
+    rows: TableRow[];
+    /** Number of rows treated as headers (repeated on continuation pages). Default: auto-detect rows with isHeader: true */
+    headerRows?: number;
+    /** Border color (hex). Default: '#cccccc' */
+    borderColor?: string;
+    /** Border thickness in pt. Default: 0.5 */
+    borderWidth?: number;
+    /** Background color for header rows (hex). Default: '#f5f5f5' */
+    headerBgColor?: string;
+    /** Cell font size in pt. Default: document.defaultFontSize */
+    fontSize?: number;
+    /** Horizontal cell padding in pt. Default: 8 */
+    cellPaddingH?: number;
+    /** Vertical cell padding in pt. Default: 6 */
+    cellPaddingV?: number;
+    /** Space below table in pt. Default: 0 */
+    spaceAfter?: number;
+    /** Space above table in pt. Default: 0 */
+    spaceBefore?: number;
+}
+export interface ColumnDef {
+    /** Fixed pt (e.g. 80), proportional fraction (e.g. '2*' or '*'), or 'auto' (shrink-to-content). */
+    width: number | string;
+    /** Column default text alignment. Default: 'left' */
+    align?: 'left' | 'center' | 'right';
+}
+export interface TableRow {
+    cells: TableCell[];
+    /** Mark row as a header (styled + repeated on continuation pages). Default: false */
+    isHeader?: boolean;
+}
+export interface TableCell {
+    text: string;
+    /** Text direction: 'ltr', 'rtl', or 'auto'. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** Overrides column alignment for this cell */
+    align?: 'left' | 'center' | 'right';
+    fontWeight?: 400 | 700;
+    /** Font family override for this cell. Default: document.defaultFont */
+    fontFamily?: string;
+    /** Font size override for this cell in pt. Default: table.fontSize ?? document.defaultFontSize */
+    fontSize?: number;
+    /** Text color (hex). Default: '#000000' */
+    color?: string;
+    /** Cell background color (hex). Optional — overrides row/table default. */
+    bgColor?: string;
+    /** Number of columns this cell spans. Default: 1 */
+    colspan?: number;
+}
+export interface ImageElement {
+    type: 'image';
+    /** Absolute file path (Node.js) or raw bytes (browser/Node) */
+    src: string | Uint8Array;
+    /** Image format. Default: 'auto' (detected from magic bytes, then file extension). */
+    format?: 'png' | 'jpg' | 'auto';
+    /** Render width in pt. Omit to auto-size to contentWidth. */
+    width?: number;
+    /** Render height in pt. Omit to preserve aspect ratio. */
+    height?: number;
+    /** Horizontal alignment within content area. Default: 'left' */
+    align?: 'left' | 'center' | 'right';
+    /** Space below image in pt. Default: 0 */
+    spaceAfter?: number;
+    /** Space above image in pt. Default: 0 */
+    spaceBefore?: number;
+}
+export interface SvgElement {
+    type: 'svg';
+    /** SVG content string. Must be a valid SVG document. */
+    svg: string;
+    /** Rendered width in pt. Default: available content width */
+    width?: number;
+    /** Rendered height in pt. Auto-computed from SVG viewBox if not set */
+    height?: number;
+    /** Alignment within content area. Default: 'left' */
+    align?: 'left' | 'center' | 'right';
+    /** Space above element in pt. Default: 8 */
+    spaceBefore?: number;
+    /** Space below element in pt. Default: 8 */
+    spaceAfter?: number;
+}
+export interface ListElement {
+    type: 'list';
+    /** 'ordered' = "1. 2. 3.", 'unordered' = bullet point */
+    style: 'ordered' | 'unordered';
+    items: ListItem[];
+    /** Custom marker for unordered lists. Default: '•' */
+    marker?: string;
+    /** Left indent in pt. Default: 20 */
+    indent?: number;
+    /** Width reserved for marker column in pt. Default: 20 */
+    markerWidth?: number;
+    /** Font size in pt. Default: document.defaultFontSize */
+    fontSize?: number;
+    /** Line height in pt. Default: fontSize * 1.5 */
+    lineHeight?: number;
+    /** Space between list items in pt. Default: 4 */
+    itemSpaceAfter?: number;
+    /** Space below the entire list in pt. Default: 0 */
+    spaceAfter?: number;
+    /** Space above the entire list in pt. Default: 0 */
+    spaceBefore?: number;
+    /** Text color for all list items (hex). Default: '#000000' */
+    color?: string;
+    /**
+     * For ordered lists with nested items: how nested item counters behave.
+     * 'continue' — nested items continue the parent counter (1, 2, 3, 4...).
+     * 'restart'  — nested items restart at 1, parent counter is unaffected.
+     * Default: 'continue'
+     */
+    nestedNumberingStyle?: 'continue' | 'restart';
+}
+export interface ListItem {
+    text: string;
+    /** Text direction: 'ltr', 'rtl', or 'auto'. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** Font weight for this item. Default: 400 */
+    fontWeight?: 400 | 700;
+    /** Nested items — 1 level deep maximum in Phase 2 */
+    items?: ListItem[];
+}
+export interface HorizontalRuleElement {
+    type: 'hr';
+    /** Line thickness in pt. Default: 0.5 */
+    thickness?: number;
+    /** Line color (hex). Default: '#cccccc' */
+    color?: string;
+    /** Space above line in pt. Default: 12 */
+    spaceAbove?: number;
+    /** Space below line in pt. Default: 12 */
+    spaceBelow?: number;
+}
+/** Forces a page break at this position. No-op if already at the top of a page. */
+export interface PageBreakElement {
+    type: 'page-break';
+}
+export interface CodeBlockElement {
+    type: 'code';
+    /** Preformatted source code. Newlines and indentation are preserved. */
+    text: string;
+    /** Text direction. Code blocks should always be 'ltr' (logical order). Default: 'ltr' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /**
+     * Font family for code text. Must be loaded in doc.fonts as a monospace TTF.
+     * There is no default — a font MUST be provided for code blocks.
+     * Recommended: JetBrains Mono, Fira Code, Courier Prime, etc.
+     */
+    fontFamily: string;
+    /** Font size in pt. Default: doc.defaultFontSize - 2 (slightly smaller than body text) */
+    fontSize?: number;
+    /** Line height in pt. Default: fontSize * 1.4 */
+    lineHeight?: number;
+    /** Background box color (hex). Default: '#f6f8fa' */
+    bgColor?: string;
+    /** Text color (hex). Default: '#24292f' */
+    color?: string;
+    /** Padding inside the background box on all 4 sides in pt. Default: 8 */
+    padding?: number;
+    /** Space below element in pt. Default: 12 */
+    spaceAfter?: number;
+    /** Space above element in pt. Default: 12 */
+    spaceBefore?: number;
+    /** If true, never break this block across pages. Default: false */
+    keepTogether?: boolean;
+}
+/**
+ * A paragraph composed of inline spans with mixed formatting (bold, italic, color).
+ * All spans must use the same fontSize — cross-size spans (subscript etc.) are Phase 4.
+ */
+export interface RichParagraphElement {
+    type: 'rich-paragraph';
+    spans: InlineSpan[];
+    /** Text direction: 'ltr', 'rtl', or 'auto'. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** Font size in pt for all spans. Default: doc.defaultFontSize */
+    fontSize?: number;
+    /** Line height in pt. Default: fontSize * 1.5 */
+    lineHeight?: number;
+    /** Text alignment. Default: 'left' for LTR, 'right' for RTL (auto-detected) */
+    align?: 'left' | 'center' | 'right' | 'justify';
+    /** Background color as 6-digit hex. Drawn behind the text block. Default: none */
+    bgColor?: string;
+    /** Extra space above this element in pt. Default: 0 */
+    spaceBefore?: number;
+    /** Extra space below this element in pt. Default: 0 */
+    spaceAfter?: number;
+    /** If true, never break this block across pages. Default: false */
+    keepTogether?: boolean;
+    /** Number of columns for multi-column layout. Default: 1 (single column) */
+    columns?: number;
+    /** Gap between columns in pt. Default: 24 */
+    columnGap?: number;
+}
+export interface InlineSpan {
+    text: string;
+    /** Text direction for this span: 'ltr', 'rtl', or 'auto'. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** Font family. Default: doc.defaultFont */
+    fontFamily?: string;
+    /** Font weight. Default: 400 */
+    fontWeight?: 400 | 700;
+    /** Font style. Default: 'normal'. Requires italic variant in doc.fonts. */
+    fontStyle?: 'normal' | 'italic';
+    /** Text color (hex). Default: '#000000' */
+    color?: string;
+    /** Font size override in pt. When set, overrides the element-level fontSize for this span. Default: element fontSize */
+    fontSize?: number;
+    /** Underline the span text. Default: false */
+    underline?: boolean;
+    /** Draw a line through the middle of the span text. Default: false */
+    strikethrough?: boolean;
+    /** Clickable URL. Opens in browser when clicked in PDF viewer. Auto-applies blue color and underline. */
+    url?: string;
+    /** Internal anchor link: '#anchorId' to jump to a heading with matching anchor. Or external URL. Alias for url. */
+    href?: string;
+}
+/** A composed line from the rich-text compositor — contains multiple styled fragments */
+export interface RichLine {
+    fragments: RichFragment[];
+    /** Total line content width in pt */
+    totalWidth: number;
+    /** Height of this line in pt. Computed as max(fragment.fontSize) * lineHeightRatio (Phase 5B.4) */
+    lineHeight: number;
+}
+/** A single styled run within a RichLine */
+export interface RichFragment {
+    text: string;
+    fontKey: string;
+    fontSize: number;
+    color: string;
+    /** x-offset from the left edge of the text area in pt */
+    x: number;
+    /** Fragment width in pt */
+    width: number;
+    underline?: boolean;
+    strikethrough?: boolean;
+    url?: string;
+    href?: string;
+}
+export interface BlockquoteElement {
+    type: 'blockquote';
+    text: string;
+    /** Text direction: 'ltr', 'rtl', or 'auto'. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** Left border color (hex). Default: '#0070f3' */
+    borderColor?: string;
+    /** Left border width in pt. Default: 3 */
+    borderWidth?: number;
+    /** Background fill color (hex). Default: '#f8f9fa' */
+    bgColor?: string;
+    /** Text color (hex). Default: '#333333' */
+    color?: string;
+    /** Font family. Default: document.defaultFont */
+    fontFamily?: string;
+    /** Font weight. Default: 400 */
+    fontWeight?: 400 | 700;
+    /** Font style. Default: 'normal'. Requires italic variant in doc.fonts if set to 'italic'. */
+    fontStyle?: 'normal' | 'italic';
+    /** Font size in pt. Default: document.defaultFontSize */
+    fontSize?: number;
+    /** Line height in pt. Default: fontSize * 1.5 */
+    lineHeight?: number;
+    /** Shorthand for paddingH and paddingV. Sets both when they are not individually specified. Per-axis overrides take precedence. */
+    padding?: number;
+    /** Horizontal padding (left + right) inside the box in pt. Default: padding ?? 16 */
+    paddingH?: number;
+    /** Vertical padding (top + bottom) inside the box in pt. Default: padding ?? 10 */
+    paddingV?: number;
+    /** Text alignment. Default: 'left' */
+    align?: 'left' | 'center' | 'right' | 'justify';
+    /** Space above this element in pt. Default: 0 */
+    spaceBefore?: number;
+    /** Space below this element in pt. Default: 12 */
+    spaceAfter?: number;
+    /** If true, never break this block across pages. Default: false */
+    keepTogether?: boolean;
+    /** Underline all text in this element. Default: false */
+    underline?: boolean;
+    /** Strikethrough all text in this element. Default: false */
+    strikethrough?: boolean;
+}
+export interface TocElement {
+    type: 'toc';
+    /** TOC title. Default: 'Table of Contents' */
+    title?: string;
+    /** Whether to show the title. Default: true */
+    showTitle?: boolean;
+    /** Minimum heading level to include. Default: 1 */
+    minLevel?: 1 | 2 | 3 | 4;
+    /** Maximum heading level to include. Default: 3 */
+    maxLevel?: 1 | 2 | 3 | 4;
+    /** Font size for TOC entries. Default: doc.defaultFontSize */
+    fontSize?: number;
+    /** Font size for TOC title. Default: fontSize + 4 */
+    titleFontSize?: number;
+    /** Indentation per level in pt. Default: 16 */
+    levelIndent?: number;
+    /** Leader character between entry text and page number. Default: '.' */
+    leader?: string;
+    /** Space after each entry line in pt. Default: 4 */
+    entrySpacing?: number;
+    /** Font family for TOC. Default: doc.defaultFont */
+    fontFamily?: string;
+    /** Space before the entire TOC section. Default: 0 */
+    spaceBefore?: number;
+    /** Space after the entire TOC section. Default: 0 */
+    spaceAfter?: number;
+}
+/** Internal: used as element type for measured TOC entry rows */
+export interface TocEntryElement {
+    type: 'toc-entry';
+    text: string;
+    pageNumber: number;
+    level: 1 | 2 | 3 | 4;
+    levelIndent: number;
+    leader: string;
+    fontFamily: string;
+    fontWeight: number;
+}
+/** Resolved per-element measurement result from Stage 3 */
+export interface MeasuredBlock {
+    element: ContentElement;
+    /** Total height in pt (lineCount * lineHeight, spacer.height, table sum, image height, hr height) */
+    height: number;
+    /** Lines from Pretext layoutWithLines(). Empty array for spacers, tables, images, hr. */
+    lines: PretextLine[];
+    /** Resolved font size in pt. 0 for non-text elements. */
+    fontSize: number;
+    /** Resolved line height in pt. 0 for non-text elements. */
+    lineHeight: number;
+    /** Key into FontMap, e.g. "Inter-400-normal". '' for non-text elements. */
+    fontKey: string;
+    /** Resolved space after in pt */
+    spaceAfter: number;
+    /** Resolved space before in pt (headings, lists, tables, images) */
+    spaceBefore: number;
+    /** Only set when element.type === 'table' */
+    tableData?: MeasuredTableData;
+    /** Only set when element.type === 'image' */
+    imageData?: MeasuredImageData;
+    /** Only set for list item blocks (flattened from ListElement) */
+    listItemData?: ListItemData;
+    /** Only set when element.type === 'code'. Resolved padding in pt. */
+    codePadding?: number;
+    /** Only set when element.type === 'rich-paragraph'. Mixed-font composed lines. */
+    richLines?: RichLine[];
+    /** Only set when element.type === 'blockquote'. Resolved vertical padding in pt. */
+    blockquotePaddingV?: number;
+    /** Only set when element.type === 'blockquote'. Resolved horizontal padding in pt. */
+    blockquotePaddingH?: number;
+    /** Only set when element.type === 'blockquote'. Resolved left border width in pt. */
+    blockquoteBorderWidth?: number;
+    /** Only set when element has columns > 1. Multi-column layout metadata. */
+    columnData?: {
+        columnCount: number;
+        columnGap: number;
+        columnWidth: number;
+        linesPerColumn: number;
+    };
+    /** Set to true if this block is RTL (right-to-left text). Used to apply right-align default in render.ts. */
+    isRTL?: boolean;
+    /** Original logical-order text (for debugging / reference). Only set when isRTL=true. */
+    logicalText?: string;
+    /** Only set when element.type === 'toc-entry'. Rendering metadata for TOC entries. */
+    tocEntryData?: {
+        entryX: number;
+        pageStr: string;
+        leaderChar: string;
+    };
+}
+/** A single line from Pretext's layoutWithLines() */
+export interface PretextLine {
+    text: string;
+    width: number;
+}
+/** A block sliced for a specific page */
+export interface PagedBlock {
+    measuredBlock: MeasuredBlock;
+    /** Inclusive start index into measuredBlock.lines[] — for text elements */
+    startLine: number;
+    /** Exclusive end index into measuredBlock.lines[] — for text elements */
+    endLine: number;
+    /** Inclusive index into body rows (non-header rows) — for table elements */
+    startRow?: number;
+    /** Exclusive index into body rows — for table elements */
+    endRow?: number;
+    /** Y offset from top of the page content area in pt */
+    yFromTop: number;
+}
+/** One page's worth of content */
+export interface RenderedPage {
+    pageIndex: number;
+    blocks: PagedBlock[];
+}
+/** Output of Stage 4 paginate() */
+export interface PaginatedDocument {
+    pages: RenderedPage[];
+    totalPages: number;
+    /** Headings collected during pagination for bookmark generation. */
+    headings: Array<{
+        text: string;
+        level: 1 | 2 | 3 | 4;
+        pageIndex: number;
+    }>;
+}
+/** Resolved page geometry passed between stages */
+export interface PageGeometry {
+    pageWidth: number;
+    pageHeight: number;
+    margins: Margins;
+    contentWidth: number;
+    contentHeight: number;
+    headerHeight: number;
+    footerHeight: number;
+}
+/** Maps font key → embedded PDFFont reference */
+export type FontMap = Map<string, import('pdf-lib').PDFFont>;
+/** Maps image key → embedded PDFImage reference */
+export type ImageMap = Map<string, import('pdf-lib').PDFImage>;
+export interface MeasuredTableData {
+    /** Resolved column widths in pt */
+    columnWidths: number[];
+    /** All rows including headers */
+    rows: MeasuredTableRow[];
+    /** How many rows at the top are header rows */
+    headerRowCount: number;
+    /** Sum of header row heights — used to reserve space on continuation pages */
+    headerRowHeight: number;
+    cellPaddingH: number;
+    cellPaddingV: number;
+    borderWidth: number;
+    borderColor: string;
+    headerBgColor: string;
+}
+export interface MeasuredTableRow {
+    cells: MeasuredTableCell[];
+    /** Max cell content height + 2*cellPaddingV */
+    height: number;
+    isHeader: boolean;
+    /** Column gap indices (0..colCount-2) where vertical lines should be drawn. Gaps spanned by merged cells are excluded. */
+    activeBoundaries: number[];
+}
+export interface MeasuredTableCell {
+    lines: PretextLine[];
+    fontSize: number;
+    lineHeight: number;
+    fontKey: string;
+    fontFamily: string;
+    align: 'left' | 'center' | 'right';
+    color: string;
+    bgColor?: string;
+    /** Number of columns this cell spans */
+    colspan: number;
+    /** Total width in pt after colspan expansion, including border-width between spanned columns */
+    mergedWidth: number;
+    /** RTL text detected in this cell (for alignment defaults) */
+    isRTL?: boolean;
+}
+export interface MeasuredImageData {
+    /** Key into ImageMap, e.g. 'img-3' */
+    imageKey: string;
+    /** Final render width in pt */
+    renderWidth: number;
+    /** Final render height in pt */
+    renderHeight: number;
+    align: 'left' | 'center' | 'right';
+}
+export interface ListItemData {
+    /** Marker string, e.g. "•" or "1." */
+    marker: string;
+    /** Left indent in pt before the marker */
+    indent: number;
+    /** Width of marker column in pt — body text starts after this */
+    markerWidth: number;
+    /** Resolved text color (hex) for this item */
+    color: string;
+    /** Resolved font weight for this item */
+    fontWeight: 400 | 700;
+}
+//# sourceMappingURL=types.d.ts.map