pretext-pdf 1.1.0 → 1.6.0

package/dist/types-public/elements-block.d.ts

@@ -0,0 +1,246 @@
+/**
+ * pretext-pdf — Structural / block-layout element types.
+ *
+ * Table (+ColumnDef, TableRow, TableCell), List (+ListItem), HR, PageBreak,
+ * Spacer, Toc, FootnoteDef, Comment, FormField.
+ */
+/** @public */
+export interface SpacerElement {
+    type: 'spacer';
+    /** Height in pt */
+    height: number;
+}
+/** @public */
+export interface TableElement {
+    type: 'table';
+    columns: ColumnDef[];
+    rows: TableRow[];
+    /** Default text direction for all cells. Cells can override individually. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** 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;
+}
+/** @public */
+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';
+}
+/** @public */
+export interface TableRow {
+    cells: TableCell[];
+    /** Mark row as a header (styled + repeated on continuation pages). Default: false */
+    isHeader?: boolean;
+}
+/** @public */
+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;
+    /** Number of rows this cell spans. Default: 1 */
+    rowspan?: number;
+    /**
+     * Render digits (0–9) at a fixed slot width (widest digit in font).
+     * Ensures numeric columns align regardless of digit width variation (1 vs 0 etc.).
+     */
+    tabularNumbers?: boolean;
+}
+/** @public */
+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';
+}
+/** @public */
+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 — up to 2 levels deep. */
+    items?: ListItem[];
+}
+/** @public */
+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. Alias: spaceBefore */
+    spaceAbove?: number;
+    /** Space below line in pt. Default: 12. Alias: spaceAfter */
+    spaceBelow?: number;
+    /** Alias for spaceAbove — consistent with paragraph/heading naming */
+    spaceBefore?: number;
+    /** Alias for spaceAfter — consistent with paragraph/heading naming */
+    spaceAfter?: number;
+}
+/**
+ * Forces a page break at this position. No-op if already at the top of a page.
+ * @public
+ */
+export interface PageBreakElement {
+    type: 'page-break';
+}
+/** @public */
+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;
+}
+/**
+ * Defines a footnote. Placed anywhere in doc.content — order doesn't matter.
+ * Rendered at the bottom of the page that contains the matching footnoteRef span.
+ * @public
+ */
+export interface FootnoteDefElement {
+    type: 'footnote-def';
+    /** Unique identifier matched by InlineSpan.footnoteRef */
+    id: string;
+    /** The footnote text rendered at the bottom of the page */
+    text: string;
+    /** Font size in pt. Default: doc.defaultFontSize - 2 */
+    fontSize?: number;
+    /** Font family. Default: doc.defaultFont */
+    fontFamily?: string;
+    /** Space after the footnote def in pt. Default: 4 */
+    spaceAfter?: number;
+}
+/** @public */
+export interface CommentElement {
+    type: 'comment';
+    /** Popup text content. Required. */
+    contents: string;
+    /** Author name. Optional. */
+    author?: string;
+    /** Color as 6-digit hex. Default: '#FFFF00' */
+    color?: string;
+    /** Whether popup is open by default. Default: false */
+    open?: boolean;
+    /** Extra space below in pt. Default: 0 */
+    spaceAfter?: number;
+}
+/** @public */
+export interface FormFieldElement {
+    type: 'form-field';
+    /** AcroForm field type. */
+    fieldType: 'text' | 'checkbox' | 'radio' | 'dropdown' | 'button';
+    /** Unique field name within the document. Required. */
+    name: string;
+    /** Label text rendered above the interactive field. Optional. */
+    label?: string;
+    /** Placeholder text for text fields. */
+    placeholder?: string;
+    /** Pre-filled default value for text fields. */
+    defaultValue?: string;
+    /** Makes text field multi-line. Default: false */
+    multiline?: boolean;
+    /** Maximum character length for text fields. */
+    maxLength?: number;
+    /** Initial checked state for checkboxes. Default: false */
+    checked?: boolean;
+    /** Option list for radio groups and dropdowns. */
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /** Pre-selected value for radio groups and dropdowns. */
+    defaultSelected?: string;
+    /** Field width in pt. Default: full content width */
+    width?: number;
+    /** Field height in pt. Default: auto per fieldType (text=24, multiline=60, radio=20×options, others=24) */
+    height?: number;
+    /** Font size for field text in pt. Default: doc.defaultFontSize */
+    fontSize?: number;
+    /** Field border color as 6-digit hex. Default: '#999999' */
+    borderColor?: string;
+    /** Field background color as 6-digit hex. Default: '#FFFFFF' */
+    backgroundColor?: string;
+    /** Extra space below this field in pt. Default: 8 */
+    spaceAfter?: number;
+    /** Extra space above this field in pt. Default: 0 */
+    spaceBefore?: number;
+    /** If true, never break this element across pages. Default: true */
+    keepTogether?: boolean;
+}
+//# sourceMappingURL=elements-block.d.ts.map

package/dist/types-public/elements-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements-block.d.ts","sourceRoot":"","sources":["../../src/types-public/elements-block.ts"],"names":[],"mappings":"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"}

package/dist/types-public/elements-block.js

@@ -0,0 +1,8 @@
+/**
+ * pretext-pdf — Structural / block-layout element types.
+ *
+ * Table (+ColumnDef, TableRow, TableCell), List (+ListItem), HR, PageBreak,
+ * Spacer, Toc, FootnoteDef, Comment, FormField.
+ */
+export {};
+//# sourceMappingURL=elements-block.js.map

package/dist/types-public/elements-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements-block.js","sourceRoot":"","sources":["../../src/types-public/elements-block.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types-public/elements-media.d.ts

@@ -0,0 +1,199 @@
+/**
+ * pretext-pdf — Media and graphical element types.
+ *
+ * Image variants, FloatGroup, SVG, QrCode, Barcode, Chart, AssemblyPart.
+ */
+import type { PdfDocument } from './document.js';
+import type { ParagraphElement, HeadingElement, RichParagraphElement, InlineSpan } from './elements-text.js';
+interface ImageBase {
+    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;
+}
+type ImageNoFloat = ImageBase & {
+    float?: undefined;
+    floatWidth?: undefined;
+    floatGap?: undefined;
+    floatText?: undefined;
+    floatSpans?: undefined;
+    floatFontSize?: undefined;
+    floatFontFamily?: undefined;
+    floatColor?: undefined;
+};
+type ImageWithFloatText = ImageBase & {
+    /**
+     * If set, renders image + floatText as a two-column composite block.
+     * 'left' = image left, text right. 'right' = image right, text left.
+     * NOTE: Constrained float only — floatText is a single paragraph alongside the image.
+     */
+    float: 'left' | 'right';
+    /** Image column width in pt. Default: 35% of content width. */
+    floatWidth?: number;
+    /** Gap between image and text columns in pt. Default: 12 */
+    floatGap?: number;
+    /** Font size for floatText in pt. Default: doc.defaultFontSize */
+    floatFontSize?: number;
+    /** Font family for floatText. Default: doc.defaultFont */
+    floatFontFamily?: string;
+    /** Text color for floatText as 6-digit hex. Default: '#000000' */
+    floatColor?: string;
+    /** Text rendered alongside the image. Mutually exclusive with floatSpans. */
+    floatText: string;
+    floatSpans?: undefined;
+};
+type ImageWithFloatSpans = ImageBase & {
+    /**
+     * If set, renders image + floatSpans as a two-column composite block.
+     * 'left' = image left, text right. 'right' = image right, text left.
+     * NOTE: Constrained float only — floatSpans is rendered alongside the image.
+     */
+    float: 'left' | 'right';
+    /** Image column width in pt. Default: 35% of content width. */
+    floatWidth?: number;
+    /** Gap between image and text columns in pt. Default: 12 */
+    floatGap?: number;
+    /** Font size for floatText in pt. Default: doc.defaultFontSize */
+    floatFontSize?: number;
+    /** Font family for floatText. Default: doc.defaultFont */
+    floatFontFamily?: string;
+    /** Text color for floatText as 6-digit hex. Default: '#000000' */
+    floatColor?: string;
+    /** Rich-text spans rendered alongside the image. Alternative to floatText for mixed-style float text. */
+    floatSpans: InlineSpan[];
+    floatText?: undefined;
+};
+/** @public */
+export type ImageElement = ImageNoFloat | ImageWithFloatText | ImageWithFloatSpans;
+/** @public */
+export interface FloatGroupElement {
+    type: 'float-group';
+    /** The image to float left or right. */
+    image: {
+        src: string | Uint8Array;
+        format?: 'png' | 'jpg' | 'auto';
+        height?: number;
+    };
+    /** Image position. 'left' = image left, text right. 'right' = image right, text left. */
+    float: 'left' | 'right';
+    /** Image column width in pt. Default: 35% of content width. */
+    floatWidth?: number;
+    /** Gap between image and text columns in pt. Default: 12 */
+    floatGap?: number;
+    /** Content elements rendered in the text column, top-to-bottom. */
+    content: Array<ParagraphElement | HeadingElement | RichParagraphElement>;
+    /** Space above the entire float group in pt. Default: 0 */
+    spaceBefore?: number;
+    /** Space below the entire float group in pt. Default: 12 */
+    spaceAfter?: number;
+}
+interface SvgBase {
+    type: 'svg';
+    /** 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;
+}
+/** @public */
+export type SvgElement = (SvgBase & {
+    svg: string;
+    src?: never;
+}) | (SvgBase & {
+    src: string;
+    svg?: never;
+});
+/** @public */
+export interface QrCodeElement {
+    type: 'qr-code';
+    /** The data to encode (URL, text, UPI string, etc.). Required. Max 2953 chars at error-correction L. */
+    data: string;
+    /** Rendered size in pt (width = height). Default: 80 */
+    size?: number;
+    /** QR error correction level. Default: 'M' */
+    errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
+    /** Module color as 6-digit hex. Default: '#000000' */
+    foreground?: string;
+    /** Background color as 6-digit hex. Default: '#ffffff' */
+    background?: string;
+    /** Quiet-zone modules around the symbol. Default: 4 */
+    margin?: 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;
+}
+/** @public */
+export interface BarcodeElement {
+    type: 'barcode';
+    /**
+     * Barcode symbology. Common values: 'ean13', 'ean8', 'upca', 'code128',
+     * 'code39', 'qrcode', 'pdf417', 'datamatrix', 'itf14', 'azteccode'.
+     * Full list: https://bwip-js.metafloor.com/
+     */
+    symbology: string;
+    /** Data to encode. Format requirements vary by symbology. */
+    data: string;
+    /** Rendered width in pt. Default: 200 */
+    width?: number;
+    /** Rendered height in pt. Default: 60 */
+    height?: number;
+    /** Render human-readable text below the barcode. Default: true */
+    includeText?: boolean;
+    /** 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;
+}
+/** @public */
+export interface ChartElement {
+    type: 'chart';
+    /**
+     * A vega-lite JSON specification object.
+     * Requires `vega` and `vega-lite` to be installed: `npm install vega vega-lite`
+     * @see https://vega.github.io/vega-lite/docs/spec.html
+     */
+    spec: Record<string, unknown>;
+    /** Rendered width in pt. Default: available content width */
+    width?: number;
+    /** Rendered height in pt. Default: 300 */
+    height?: number;
+    /** Optional figure caption rendered below the chart. */
+    caption?: string;
+    /** 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;
+}
+/** @public */
+export type AssemblyPart = {
+    doc: PdfDocument;
+    pdf?: never;
+} | {
+    pdf: Uint8Array;
+    doc?: never;
+};
+export {};
+//# sourceMappingURL=elements-media.d.ts.map

package/dist/types-public/elements-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements-media.d.ts","sourceRoot":"","sources":["../../src/types-public/elements-media.ts"],"names":[],"mappings":"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"}

package/dist/types-public/elements-media.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=elements-media.js.map

package/dist/types-public/elements-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements-media.js","sourceRoot":"","sources":["../../src/types-public/elements-media.ts"],"names":[],"mappings":""}