pretext-pdf 1.1.0 → 1.6.0

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

@@ -0,0 +1,327 @@
+/**
+ * pretext-pdf — Text-oriented element types.
+ *
+ * Paragraph, Heading, RichParagraph (and its InlineSpan member),
+ * Blockquote, Callout, CodeBlock.
+ */
+import type { AnnotationSpec } from './document.js';
+/** @public */
+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;
+    /** Extra spacing between characters in pt. Default: 0 */
+    letterSpacing?: number;
+    /** Simulate small-caps: uppercase text at 80% font size. Default: false */
+    smallCaps?: boolean;
+    /**
+     * 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;
+    /** PDF sticky-note annotation attached to this element. */
+    annotation?: AnnotationSpec;
+}
+/** @public */
+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;
+    /** Extra spacing between characters in pt. Default: 0 */
+    letterSpacing?: number;
+    /** Simulate small-caps: uppercase text at 80% font size. Default: false */
+    smallCaps?: boolean;
+    /**
+     * 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;
+    /** PDF sticky-note annotation attached to this element. */
+    annotation?: AnnotationSpec;
+}
+/**
+ * A paragraph composed of inline spans with mixed formatting (bold, italic, color, per-span fontSize).
+ * @public
+ */
+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;
+    /** Extra spacing between characters in pt. Default: 0 */
+    letterSpacing?: number;
+    /** Simulate small-caps: uppercase text at 80% font size. Default: false */
+    smallCaps?: boolean;
+    /**
+     * 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 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;
+    /** Raise text as superscript or lower as subscript. Default: none */
+    verticalAlign?: 'superscript' | 'subscript';
+    /** Simulate small-caps: uppercase text at 80% font size. Default: false */
+    smallCaps?: boolean;
+    /** Extra spacing between characters in pt. Default: 0 */
+    letterSpacing?: number;
+    /**
+     * ID of a matching footnote-def element. When set, this span renders as a
+     * superscript number and pins the footnote def to the bottom of this page.
+     */
+    footnoteRef?: string;
+}
+/** @public */
+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;
+}
+/**
+ * A highlighted callout box with an optional title and preset color schemes.
+ * Useful for info panels, warnings, tips, and notes.
+ * @public
+ */
+export interface CalloutElement {
+    type: 'callout';
+    /** Body text content. Required. */
+    content: string;
+    /**
+     * Preset style that sets default colors.
+     * - 'info': blue (#EFF6FF bg, #3B82F6 border)
+     * - 'warning': amber (#FFFBEB bg, #F59E0B border)
+     * - 'tip': green (#F0FDF4 bg, #22C55E border)
+     * - 'note': gray (#F9FAFB bg, #9CA3AF border)
+     * Default: blue-gray (#F8F9FA bg, #0070F3 border)
+     */
+    style?: 'info' | 'warning' | 'tip' | 'note';
+    /** Optional title rendered above the body (bold, colored). */
+    title?: string;
+    /** Background color as 6-digit hex. Default: per style. */
+    backgroundColor?: string;
+    /** Left border color as 6-digit hex. Default: per style. */
+    borderColor?: string;
+    /** Text color as 6-digit hex. Default: '#1F2937' */
+    color?: string;
+    /** Title color as 6-digit hex. Default: same as borderColor */
+    titleColor?: string;
+    /** Font family. Default: document.defaultFont */
+    fontFamily?: string;
+    /** Font weight. Default: 400 */
+    fontWeight?: 400 | 700;
+    /** Font size in pt. Default: document.defaultFontSize */
+    fontSize?: number;
+    /** Line height in pt. Default: fontSize * 1.5 */
+    lineHeight?: number;
+    /** Shorthand for paddingH and paddingV. Default: 12 */
+    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;
+    /** Space below this element in pt. Default: 12 */
+    spaceAfter?: number;
+    /** Space above this element in pt. Default: 0 */
+    spaceBefore?: number;
+    /** If true, never break this element across pages. Default: false */
+    keepTogether?: boolean;
+    /** Text direction. Default: 'auto' */
+    dir?: 'ltr' | 'rtl' | 'auto';
+}
+/** @public */
+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;
+    /**
+     * Programming language for syntax highlighting. Requires `highlight.js` peer dependency.
+     * When set, tokens are colored using the highlight theme. When unset or highlight.js
+     * is not installed, renders as plain monospace text (existing behavior).
+     * Examples: 'javascript', 'typescript', 'python', 'rust', 'go', 'sql', 'json', 'bash'
+     */
+    language?: string;
+    /**
+     * Custom syntax highlight colors (6-digit hex). Overrides the default GitHub-light theme.
+     * Only used when `language` is set.
+     */
+    highlightTheme?: {
+        keyword?: string;
+        string?: string;
+        comment?: string;
+        number?: string;
+        function?: string;
+        punctuation?: string;
+        type?: string;
+        built_in?: string;
+        literal?: string;
+    };
+}
+//# sourceMappingURL=elements-text.d.ts.map

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

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

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

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

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

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

package/dist/types-public/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * pretext-pdf — Public types barrel.
+ *
+ * Re-exports every public type. The original src/types-public.ts file
+ * also re-exports from here for backward compatibility during the split.
+ */
+export type * from './document.js';
+export type * from './elements-text.js';
+export type * from './elements-block.js';
+export type * from './elements-media.js';
+export type * from './union.js';
+export type * from './validation.js';
+export type * from './render-options.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types-public/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types-public/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,mBAAmB,eAAe,CAAA;AAClC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,qBAAqB,CAAA"}

package/dist/types-public/index.js

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

package/dist/types-public/index.js.map

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

package/dist/types-public/render-options.d.ts

@@ -0,0 +1,38 @@
+/**
+ * pretext-pdf — Top-level render options public type.
+ */
+import type { Logger } from './validation.js';
+/** @public */
+export type RenderOptions = {
+    /** Enable strict validation: reject unknown properties on elements and sub-structures */
+    strict?: boolean;
+    /**
+     * Plugin definitions for custom element types.
+     * Each plugin handles one `type` string across all 4 pipeline stages.
+     * @beta
+     */
+    plugins?: import('../plugin-types.js').PluginDefinition[];
+    /**
+     * Optional logger for diagnostic messages. When provided, advisory warnings
+     * from validation, asset loading (images, QR, barcodes, charts, plugins,
+     * watermarks), and rendering (form fields) are routed through `logger.warn`
+     * instead of `console.warn`.
+     *
+     * @remarks
+     * **Silencing warnings is dangerous.** Passing `{ warn: () => {} }` (or any
+     * no-op) suppresses every advisory warning. That includes silent failures
+     * for broken images, missing fonts, and unreachable URLs — the document
+     * still renders, but the output may be incomplete. Prefer a structured
+     * logger (pino, winston, etc.) in production so warnings remain searchable
+     * and alertable.
+     *
+     * Bidi-js fallback warnings from RTL reordering still go to `console.warn`
+     * directly. They are extremely rare (only fire when bidi-js itself errors)
+     * and routing them requires changes to deferred internal modules. This will
+     * be addressed in a future minor release.
+     *
+     * See {@link Logger} for the interface contract.
+     */
+    logger?: Logger;
+};
+//# sourceMappingURL=render-options.d.ts.map

package/dist/types-public/render-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-options.d.ts","sourceRoot":"","sources":["../../src/types-public/render-options.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAI7C,cAAc;AACd,MAAM,MAAM,aAAa,GAAG;IAC1B,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,EAAE,CAAA;IACzD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/dist/types-public/render-options.js

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

package/dist/types-public/render-options.js.map

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

package/dist/types-public/union.d.ts

@@ -0,0 +1,13 @@
+/**
+ * pretext-pdf — Discriminated union of every public content element.
+ *
+ * This module imports element types from elements-text, elements-block,
+ * and elements-media. Those modules MUST NOT import from this file, to
+ * keep the dependency graph one-directional.
+ */
+import type { ParagraphElement, HeadingElement, RichParagraphElement, BlockquoteElement, CalloutElement, CodeBlockElement } from './elements-text.js';
+import type { SpacerElement, TableElement, ListElement, HorizontalRuleElement, PageBreakElement, TocElement, FootnoteDefElement, CommentElement, FormFieldElement } from './elements-block.js';
+import type { ImageElement, SvgElement, QrCodeElement, BarcodeElement, ChartElement, FloatGroupElement } from './elements-media.js';
+/** @public */
+export type ContentElement = ParagraphElement | HeadingElement | SpacerElement | TableElement | ImageElement | SvgElement | QrCodeElement | BarcodeElement | ChartElement | ListElement | HorizontalRuleElement | PageBreakElement | CodeBlockElement | RichParagraphElement | BlockquoteElement | TocElement | CommentElement | FormFieldElement | CalloutElement | FootnoteDefElement | FloatGroupElement;
+//# sourceMappingURL=union.d.ts.map

package/dist/types-public/union.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/types-public/union.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EAClB,MAAM,qBAAqB,CAAA;AAE5B,cAAc;AACd,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,aAAa,GACb,cAAc,GACd,YAAY,GACZ,WAAW,GACX,qBAAqB,GACrB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,iBAAiB,GACjB,UAAU,GACV,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,iBAAiB,CAAA"}

package/dist/types-public/union.js

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

package/dist/types-public/union.js.map

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

package/dist/types-public/validation.d.ts

@@ -0,0 +1,64 @@
+/**
+ * pretext-pdf — Validation and logging public types.
+ */
+import type { ErrorCode } from '../errors.js';
+/**
+ * A single validation issue returned by {@link validateDocument}.
+ * @public
+ */
+export interface ValidationError {
+    /** JSONPath-style location — e.g. "doc.pageSize" or "doc.content[3].color" */
+    path: string;
+    /** Human-readable description of the issue */
+    message: string;
+    /** The unknown property name, when code is UNKNOWN_PROPERTY */
+    unknownProp?: string;
+    /** Levenshtein-nearest valid property name, when available */
+    suggestion?: string;
+    /** Severity of the issue */
+    severity: 'error' | 'warning';
+    /** Machine-readable error code */
+    code: ErrorCode;
+}
+/**
+ * Return value of {@link validateDocument}.
+ * @public
+ */
+export interface ValidationResult {
+    /** True when the document passed validation with zero errors */
+    valid: boolean;
+    /** All validation errors found (empty when valid is true) */
+    errors: ValidationError[];
+    /** Total number of validation issues. May exceed errors.length when errors are capped at 20. */
+    errorCount: number;
+    /** Warning-severity issue count. Reserved for future use — the validator currently emits only errors, so this is always 0. */
+    warningCount: number;
+}
+/**
+ * Optional logger interface for routing pretext-pdf diagnostic messages.
+ *
+ * @remarks
+ * Diagnostic messages include asset-loading failures (image, font, QR,
+ * barcode, chart, plugin), validation advisories, and rendering warnings
+ * (form-field clashes, watermark fallbacks, etc.). They are advisory — the
+ * render still completes — but most of them indicate a real problem with
+ * input or environment.
+ *
+ * **Behavior:**
+ * - If `logger` is omitted on {@link RenderOptions}, diagnostics route to
+ *   `console.warn` with sensible defaults.
+ * - Passing a no-op (`{ warn: () => {} }`) silences **every** advisory
+ *   warning. This is convenient for tests but **dangerous in production** —
+ *   you lose visibility into broken images, missing fonts, and other
+ *   recoverable failures that you almost certainly want to know about.
+ * - For production, prefer a structured logger such as
+ *   [pino](https://github.com/pinojs/pino) or
+ *   [winston](https://github.com/winstonjs/winston) and adapt it to the
+ *   single-method shape — e.g. `{ warn: pino().warn.bind(pino()) }`.
+ *
+ * @public
+ */
+export interface Logger {
+    warn(message: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/types-public/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/types-public/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAI7C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,kCAAkC;IAClC,IAAI,EAAE,SAAS,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,KAAK,EAAE,OAAO,CAAA;IACd,6DAA6D;IAC7D,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,gGAAgG;IAChG,UAAU,EAAE,MAAM,CAAA;IAClB,8HAA8H;IAC9H,YAAY,EAAE,MAAM,CAAA;CACrB;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAChD"}

package/dist/types-public/validation.js

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

package/dist/types-public/validation.js.map

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