@nxavis/pdf 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1608 @@
+import * as _react_pdf_types from '@react-pdf/types';
+import { Style } from '@react-pdf/types';
+import * as React$1 from 'react';
+import React__default, { ReactNode } from 'react';
+import { P as PdfxTheme } from './index-CvGTF-AE.js';
+export { B as BorderRadiusScale, C as ColorTokens, F as FontWeights, L as LetterSpacingScale, a as LineHeights, b as PageTokens, c as PrimitiveTokens, S as SpacingScale, d as SpacingTokens, T as ThemePresetName, e as TypographyScale, f as TypographyTokens, g as defaultPrimitives, m as minimalTheme, h as modernTheme, p as professionalTheme, t as themePresets } from './index-CvGTF-AE.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Style as Style$1 } from '@react-pdf/types/style';
+
+/**
+ * Base props shared by all PDFx PDF components.
+ * Every component in the library should extend this interface.
+ */
+interface PDFComponentProps {
+    /** Custom styles to merge with component defaults */
+    style?: Style;
+    /** Content to render — string or nested React PDF elements */
+    children: ReactNode;
+}
+
+/** Base error class for all @nxavis/pdf errors */
+declare class PdfxError extends Error {
+    readonly code: string;
+    readonly suggestion?: string | undefined;
+    constructor(message: string, code: string, suggestion?: string | undefined);
+}
+/** Thrown when input validation fails (theme, props, data) */
+declare class ValidationError extends PdfxError {
+    constructor(message: string, suggestion?: string);
+}
+
+declare const PdfxThemeContext: React$1.Context<PdfxTheme>;
+interface PdfxThemeProviderProps {
+    theme?: PdfxTheme;
+    children: ReactNode;
+}
+declare function PdfxThemeProvider({ theme, children }: PdfxThemeProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Returns the active PdfxTheme from context, or the default theme when called
+ * outside a React render tree (e.g. unit tests).
+ */
+declare function usePdfxTheme(): PdfxTheme;
+
+/**
+ * Create a tw() function from a PdfxTheme.
+ * Maps theme tokens to Tailwind custom colors so you can use
+ * `tw("text-primary bg-muted border-border")` etc.
+ */
+declare function createThemeTw(theme: PdfxTheme, options?: {
+    ptPerRem?: number;
+}): (input: string) => _react_pdf_types.Style;
+/**
+ * Default tw() using the professional theme.
+ * Import and use directly for quick styling.
+ *
+ * @example
+ * ```tsx
+ * <View style={tw("flex-row gap-4 p-6 bg-muted")}>
+ *   <Text style={tw("text-foreground font-bold")}>Label</Text>
+ * </View>
+ * ```
+ */
+declare const tw: (input: string) => _react_pdf_types.Style;
+
+/** Heading font weight override. */
+type HeadingWeight = 'normal' | 'medium' | 'semibold' | 'bold';
+/** Heading letter-spacing scale. */
+type HeadingTracking = 'tighter' | 'tight' | 'normal' | 'wide' | 'wider';
+interface HeadingProps extends PDFComponentProps {
+    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    align?: 'left' | 'center' | 'right';
+    color?: string;
+    transform?: 'uppercase' | 'lowercase' | 'capitalize' | 'none';
+    weight?: HeadingWeight;
+    tracking?: HeadingTracking;
+    noMargin?: boolean;
+    /**
+     * Ensure the heading has enough space below it before a page break occurs.
+     * Uses `minPresenceAhead` to prevent orphaned headings at the bottom of a page.
+     * When true, at least 80pt of space must remain on the page or the heading moves to the next page.
+     * Defaults to **true** — headings never strand alone at the bottom of a page.
+     * Set to false only when you explicitly want a heading to be allowed at the bottom of a page.
+     * @default true
+     */
+    keepWithNext?: boolean;
+}
+
+declare function Heading({ level, align, color, transform, weight, tracking, noMargin, keepWithNext, children, style, }: HeadingProps): react_jsx_runtime.JSX.Element;
+
+/** Typography scale variant. Maps to primitives.typography. */
+type TextVariant = 'xs' | 'sm' | 'base' | 'lg' | 'xl' | '2xl' | '3xl';
+/** Font weight override. */
+type TextWeight = 'normal' | 'medium' | 'semibold' | 'bold';
+/** Text decoration style. */
+type TextDecoration = 'underline' | 'line-through' | 'none';
+interface TextProps extends PDFComponentProps {
+    /** Typography scale variant. Maps to primitives.typography. Default (undefined) uses typography.body. */
+    variant?: TextVariant;
+    /** Text alignment. Maps to textAlign. */
+    align?: 'left' | 'center' | 'right' | 'justify';
+    /** Text color. Use theme token (e.g. 'primary', 'muted') or any CSS color. */
+    color?: string;
+    /** Font weight override. */
+    weight?: TextWeight;
+    /** Render text in italic style. */
+    italic?: boolean;
+    /** Text decoration. 'line-through' is useful for strikethrough pricing. */
+    decoration?: TextDecoration;
+    /** Text transform (uppercase, lowercase, capitalize). */
+    transform?: 'uppercase' | 'lowercase' | 'capitalize';
+    /** Remove paragraph gap margin. Useful inside Stack or tight layouts. */
+    noMargin?: boolean;
+}
+
+declare function Text({ variant, align, color, weight, italic, decoration, transform, noMargin, children, style, }: TextProps): react_jsx_runtime.JSX.Element;
+
+/** Link visual variant — controls default color. */
+type LinkVariant = 'default' | 'muted' | 'primary';
+/** Link underline style. */
+type LinkUnderline = 'always' | 'none';
+interface LinkProps extends PDFComponentProps {
+    /** URL or anchor ID (prefix with # for internal links). Maps to @react-pdf Link src. */
+    href: string;
+    /** Text alignment. Maps to textAlign. */
+    align?: 'left' | 'center' | 'right';
+    /** Text color. Use theme token (e.g. 'primary', 'accent') or any CSS color. Defaults to accent. */
+    color?: string;
+    /** Link visual variant. */
+    variant?: LinkVariant;
+    /** Underline style. always = underlined, none = no underline. */
+    underline?: LinkUnderline;
+}
+
+declare function Link({ href, align, color, variant, underline, children, style, }: LinkProps): react_jsx_runtime.JSX.Element;
+
+/** Gap scale between Stack children. */
+type StackGap = 'none' | 'sm' | 'md' | 'lg' | 'xl';
+/** Stack layout direction. */
+type StackDirection = 'vertical' | 'horizontal';
+/** Cross-axis alignment (alignItems). */
+type StackAlign = 'start' | 'center' | 'end' | 'stretch';
+/** Main-axis distribution (justifyContent). */
+type StackJustify = 'start' | 'center' | 'end' | 'between' | 'around';
+interface StackProps extends PDFComponentProps {
+    /** Gap between children. Maps to theme spacing scale. */
+    gap?: StackGap;
+    /** Layout direction. vertical = column, horizontal = row. */
+    direction?: StackDirection;
+    /** Cross-axis alignment (alignItems). */
+    align?: StackAlign;
+    /** Main-axis distribution (justifyContent). */
+    justify?: StackJustify;
+    /** Enable CSS flex-wrap so children wrap onto multiple lines. */
+    wrap?: boolean;
+    /**
+     * Prevent the Stack from being split across PDF pages.
+     * Maps to react-pdf’s `wrap={false}` on the inner View.
+     * Use for short stacks that should always stay on a single page.
+     */
+    noWrap?: boolean;
+}
+
+declare function Stack({ gap, direction, align, justify, wrap, noWrap, children, style, }: StackProps): react_jsx_runtime.JSX.Element;
+
+/** Vertical spacing (margin) scale around a section. */
+type SectionSpacing = 'none' | 'sm' | 'md' | 'lg' | 'xl';
+/** Inner padding scale of a section. */
+type SectionPadding = 'none' | 'sm' | 'md' | 'lg';
+/** Section visual style variant. */
+type SectionVariant = 'default' | 'callout' | 'highlight' | 'card';
+interface SectionProps extends PDFComponentProps {
+    /** Vertical spacing (margin) around the section. Maps to theme spacing. */
+    spacing?: SectionSpacing;
+    /** Inner padding. Maps to theme spacing. */
+    padding?: SectionPadding;
+    /** Background color. Use theme token (e.g. 'muted', 'primary') or any CSS color. */
+    background?: string;
+    /** Add a border around the section. */
+    border?: boolean;
+    /** Section visual variant. 'callout' adds left accent border. 'highlight' adds muted bg. 'card' adds border + rounded. */
+    variant?: SectionVariant;
+    /** Accent color for callout/highlight left border. Use theme token or CSS color. Defaults to 'primary'. */
+    accentColor?: string;
+    /**
+     * Prevent the section from splitting across page boundaries.
+     * @default false — opt in for callout/highlight/card sections you want kept together.
+     */
+    noWrap?: boolean;
+}
+
+declare function Section({ spacing, padding, background, border, variant, accentColor, noWrap, children, style, }: SectionProps): react_jsx_runtime.JSX.Element;
+
+/** Table visual style variant. */
+type TableVariant = 'line' | 'grid' | 'minimal' | 'striped' | 'compact' | 'bordered' | 'primary-header';
+interface TableProps extends PDFComponentProps {
+    variant?: TableVariant;
+    zebraStripe?: boolean;
+    noWrap?: boolean;
+}
+interface TableSectionProps extends PDFComponentProps {
+}
+interface TableRowProps extends PDFComponentProps {
+    header?: boolean;
+    footer?: boolean;
+    stripe?: boolean;
+    variant?: TableVariant;
+}
+interface TableCellProps extends PDFComponentProps {
+    header?: boolean;
+    footer?: boolean;
+    align?: 'left' | 'center' | 'right';
+    width?: string | number;
+    variant?: TableVariant;
+    _last?: boolean;
+}
+
+declare function TableHeader({ children, style }: TableSectionProps): react_jsx_runtime.JSX.Element;
+declare function TableBody({ children, style }: TableSectionProps): react_jsx_runtime.JSX.Element;
+declare function TableFooter({ children, style }: TableSectionProps): react_jsx_runtime.JSX.Element;
+declare function Table({ children, style, variant, zebraStripe, noWrap, }: TableProps): react_jsx_runtime.JSX.Element;
+declare function TableRow({ header, footer, stripe, children, style, variant, }: TableRowProps): react_jsx_runtime.JSX.Element;
+declare function TableCell({ header, footer, align, width, children, style, variant, _last, }: TableCellProps): react_jsx_runtime.JSX.Element;
+
+/** DataTable row density size. */
+type DataTableSize = 'default' | 'compact';
+/** Column definition for a DataTable. */
+interface DataTableColumn<T = Record<string, unknown>> {
+    key: keyof T & string;
+    header: string;
+    align?: 'left' | 'center' | 'right';
+    width?: string | number;
+    render?: (value: unknown, row: T) => React__default.ReactNode;
+    renderFooter?: (value: unknown) => React__default.ReactNode;
+}
+interface DataTableProps<T = Record<string, unknown>> extends Omit<PDFComponentProps, 'children'> {
+    columns: DataTableColumn<T>[];
+    data: T[];
+    variant?: TableVariant;
+    footer?: Partial<Record<keyof T & string, string | number>>;
+    stripe?: boolean;
+    size?: DataTableSize;
+    /** Prevent the entire table from splitting across pages. Use for short tables that fit on one page. */
+    noWrap?: boolean;
+}
+
+declare function DataTable<T extends Record<string, unknown>>({ columns, data, variant, footer, stripe, size, noWrap, style, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
+
+/** Badge visual variant — controls background and border colors. */
+type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'outline';
+/** Badge size — controls font size and padding. */
+type BadgeSize = 'sm' | 'md' | 'lg';
+interface BadgeProps extends Omit<PDFComponentProps, 'children'> {
+    /** Display text of the badge. */
+    label: string;
+    /** Visual variant. Controls colors. Defaults to 'default'. */
+    variant?: BadgeVariant;
+    /** Badge size. Defaults to 'md'. */
+    size?: BadgeSize;
+    /** Override the background color. Use theme token or any CSS color. */
+    background?: string;
+    /** Override the text color. Use theme token or any CSS color. */
+    color?: string;
+}
+
+declare function Badge({ label, variant, size, background, color, style, }: BadgeProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * KeyValue layout direction.
+ *
+ * - `horizontal` — Key and value appear side by side on one row (ideal for metadata blocks)
+ * - `vertical`   — Key is stacked above the value (ideal for form-like displays)
+ */
+type KeyValueDirection = 'horizontal' | 'vertical';
+/** KeyValue size — scales label/value font sizes together. */
+type KeyValueSize = 'sm' | 'md' | 'lg';
+/** A single key-value pair entry. */
+interface KeyValueEntry {
+    /** The label / field name shown in muted style. */
+    key: string;
+    /** The display value. */
+    value: string;
+    /** Optional color for the value text. Use theme token or CSS color. */
+    valueColor?: string;
+    /** Optional custom styles for the value text. */
+    valueStyle?: Style$1;
+    /** Optional custom styles for the key text. */
+    keyStyle?: Style$1;
+}
+interface KeyValueProps extends Omit<PDFComponentProps, 'children'> {
+    /**
+     * Array of key-value pairs to display.
+     * Each entry has a `key` (label) and `value` (data).
+     */
+    items: KeyValueEntry[];
+    /**
+     * Layout direction. Defaults to 'horizontal'.
+     *
+     * - `horizontal` — Good for invoice headers, summary boxes
+     * - `vertical`   — Good for form field displays
+     */
+    direction?: KeyValueDirection;
+    /**
+     * Show a horizontal divider line between each row.
+     * Most useful with the horizontal direction. Defaults to false.
+     */
+    divided?: boolean;
+    /** Font size scale. Defaults to 'md'. */
+    size?: KeyValueSize;
+    /**
+     * In horizontal layout, controls the label column width as a flex ratio.
+     * Value column takes the remaining space. Defaults to 1 (equal columns).
+     * Use 0.5 for a narrower label, 2 for a wider label.
+     */
+    labelFlex?: number;
+    /** Color override for all keys/labels. Use theme token or CSS color. */
+    labelColor?: string;
+    /** Color override for all values. Use theme token or CSS color. */
+    valueColor?: string;
+    /** Bold the value text. Defaults to false. */
+    boldValue?: boolean;
+    /**
+     * Prevent the KeyValue block from being split across PDF pages.
+     * Useful for short invoice-style metadata blocks that should stay on one page.
+     * @default false
+     */
+    noWrap?: boolean;
+    dividerColor?: string;
+    dividerThickness?: number;
+    dividerMargin?: number;
+}
+
+declare function KeyValue({ items, direction, divided, size, labelFlex, labelColor, valueColor, boldValue, noWrap, dividerColor, dividerThickness, dividerMargin, style, }: KeyValueProps): react_jsx_runtime.JSX.Element;
+
+/** Divider line style. */
+type DividerVariant = 'solid' | 'dashed' | 'dotted';
+/** Divider line weight. */
+type DividerThickness = 'thin' | 'medium' | 'thick';
+/** Vertical spacing around the divider. */
+type DividerSpacing = 'none' | 'sm' | 'md' | 'lg';
+interface DividerProps extends Omit<PDFComponentProps, 'children'> {
+    spacing?: DividerSpacing;
+    variant?: DividerVariant;
+    color?: string;
+    thickness?: DividerThickness;
+    label?: string;
+    width?: string | number;
+}
+
+declare function Divider({ spacing, variant, color, thickness, label, width, style, }: DividerProps): react_jsx_runtime.JSX.Element;
+
+interface PageBreakProps extends Omit<PDFComponentProps, 'children'> {
+    children?: never;
+}
+declare function PageBreak({ style }: PageBreakProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Text alignment for the page number.
+ */
+type PageNumberAlign = 'left' | 'center' | 'right';
+/**
+ * Size preset for the page number text.
+ */
+type PageNumberSize = 'xs' | 'sm' | 'md';
+/**
+ * Props for the PdfPageNumber component.
+ */
+interface PdfPageNumberProps extends Omit<PDFComponentProps, 'children'> {
+    /**
+     * Format string for the page number.
+     * Use `{page}` for current page and `{total}` for total pages.
+     * @default "Page {page} of {total}"
+     * @example "Page {page} of {total}"
+     * @example "{page} / {total}"
+     * @example "- {page} -"
+     */
+    format?: string;
+    /**
+     * Text alignment.
+     * @default "center"
+     */
+    align?: PageNumberAlign;
+    /**
+     * Size preset for the text.
+     * @default "sm"
+     */
+    size?: PageNumberSize;
+    /**
+     * Whether the page number should be fixed (appear on every page).
+     * Use this when placing inside a Page component to repeat on all pages.
+     * @default false
+     */
+    fixed?: boolean;
+    /**
+     * Use muted color (mutedForeground) instead of foreground.
+     * @default true
+     */
+    muted?: boolean;
+    /**
+     * No children allowed.
+     */
+    children?: never;
+}
+
+/**
+ * PdfPageNumber — Displays page numbers with "Page X of Y" format.
+ *
+ * Uses react-pdf's render prop to access pageNumber and totalPages dynamically.
+ * Can be placed inside PageFooter or anywhere in a Page, and supports the `fixed`
+ * prop to repeat on every page.
+ *
+ * @example Basic usage (centered, on every page)
+ * ```tsx
+ * <Page>
+ *   <View style={{ position: 'absolute', bottom: 20, left: 0, right: 0 }}>
+ *     <PdfPageNumber fixed />
+ *   </View>
+ *   {content}
+ * </Page>
+ * ```
+ *
+ * @example Custom format
+ * ```tsx
+ * <PdfPageNumber format="{page} / {total}" align="right" />
+ * ```
+ *
+ * @example Inside a PageFooter (recommended pattern)
+ * ```tsx
+ * <PageFooter variant="centered">
+ *   <PdfPageNumber format="- {page} -" />
+ * </PageFooter>
+ * ```
+ */
+declare function PdfPageNumber({ format, align, size, fixed, muted, style, }: PdfPageNumberProps): react_jsx_runtime.JSX.Element;
+
+type PageHeaderVariant = 'simple' | 'centered' | 'minimal' | 'branded' | 'logo-left' | 'logo-right' | 'two-column';
+interface PageHeaderProps extends Omit<PDFComponentProps, 'children'> {
+    title: string;
+    subtitle?: string;
+    rightText?: string;
+    rightSubText?: string;
+    variant?: PageHeaderVariant;
+    background?: string;
+    titleColor?: string;
+    marginBottom?: number;
+    address?: string;
+    phone?: string;
+    email?: string;
+    /**
+     * @example <Image src="/logo.png" style={{ width: 48, height: 48 }} />
+     */
+    logo?: React.ReactNode;
+    /**
+     * Fix this header to the top of the page, so it will always be visible regardless of content length. This is achieved using `position: 'fixed'` in the PDF layout.
+     * @default false
+     */
+    fixed?: boolean;
+    /**
+     * Prevent the header from being split across PDF pages when placed inline. A partially-rendered header is always visually broken, so this defaults to true. Set to false only for decorative banners that can tolerate splitting.
+     * @default true
+     */
+    noWrap?: boolean;
+}
+declare function PageHeader({ title, subtitle, rightText, rightSubText, variant, background, titleColor, marginBottom, logo, address, phone, email, fixed, noWrap, style, }: PageHeaderProps): react_jsx_runtime.JSX.Element;
+
+type PageFooterVariant = 'simple' | 'centered' | 'branded' | 'minimal' | 'three-column' | 'detailed';
+interface PageFooterProps extends Omit<PDFComponentProps, 'children'> {
+    leftText?: string;
+    rightText?: string;
+    centerText?: string;
+    variant?: PageFooterVariant;
+    background?: string;
+    textColor?: string;
+    marginTop?: number;
+    address?: string;
+    phone?: string;
+    email?: string;
+    website?: string;
+    /**
+     *  Fix this footer to the bottom of the page, so it will always be visible regardless of content length. This is achieved using `position: 'fixed'` in the PDF layout.
+     * @default false
+     */
+    fixed?: boolean;
+    /**
+     * Render this footer at the bottom of the page, but allow it to scroll with the content if the page is long enough. This is achieved using absolute positioning with `position: 'absolute'` and `bottom: 0`.
+     * @default false
+     */
+    sticky?: boolean;
+    /**
+     * When using `sticky`, this value sets the `left` and `right` offsets to match the page's horizontal padding, ensuring the footer content is aligned with the rest of the page content.
+     * @default 0
+     */
+    pagePadding?: number;
+    /**
+     * Prevent the footer from being split across PDF pages when placed inline.
+     * @default true
+     */
+    noWrap?: boolean;
+}
+declare function PageFooter({ leftText, rightText, centerText, variant, background, textColor, marginTop, address, phone, email, website, fixed, sticky, pagePadding, noWrap, style, }: PageFooterProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Position preset for the watermark.
+ */
+type WatermarkPosition = 'center' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+/**
+ * Props for the PdfWatermark component.
+ */
+interface PdfWatermarkProps extends Omit<PDFComponentProps, 'children'> {
+    /**
+     * The text to display as a watermark.
+     * Common values: "DRAFT", "CONFIDENTIAL", "PAID", "VOID", "COPY", "SAMPLE"
+     */
+    text: string;
+    /**
+     * Opacity of the watermark (0 to 1).
+     * @default 0.15
+     */
+    opacity?: number;
+    /**
+     * Font size in PDF points.
+     * @default 60
+     */
+    fontSize?: number;
+    /**
+     * Color of the watermark text.
+     * Can be a hex color or theme color key (e.g., "primary", "destructive").
+     * @default "mutedForeground"
+     */
+    color?: string;
+    /**
+     * Rotation angle in degrees.
+     * Use negative values for counter-clockwise rotation.
+     * @default -45
+     */
+    angle?: number;
+    /**
+     * Position of the watermark on the page.
+     * @default "center"
+     */
+    position?: WatermarkPosition;
+    /**
+     * Whether the watermark should be fixed (appear on every page).
+     * @default true
+     */
+    fixed?: boolean;
+    /**
+     * No children allowed.
+     */
+    children?: never;
+}
+
+/**
+ * PdfWatermark — Displays a diagonal or positioned text overlay on PDF pages.
+ *
+ * Common use cases include "DRAFT", "CONFIDENTIAL", "PAID", "VOID", "COPY", etc.
+ * The watermark uses absolute positioning and appears behind content.
+ * Use the `fixed` prop (default: true) to repeat on every page.
+ *
+ * @example Basic usage (diagonal "DRAFT" on every page)
+ * ```tsx
+ * <Page>
+ *   <PdfWatermark text="DRAFT" />
+ *   {content}
+ * </Page>
+ * ```
+ *
+ * @example Confidential document
+ * ```tsx
+ * <PdfWatermark text="CONFIDENTIAL" color="destructive" opacity={0.1} />
+ * ```
+ *
+ * @example Paid invoice stamp (no rotation)
+ * ```tsx
+ * <PdfWatermark text="PAID" angle={0} color="success" fontSize={80} />
+ * ```
+ *
+ * @example Corner watermark
+ * ```tsx
+ * <PdfWatermark text="COPY" position="top-right" angle={0} fontSize={24} />
+ * ```
+ */
+declare function PdfWatermark({ text, opacity, fontSize, color, angle, position, fixed, style, }: PdfWatermarkProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Alert variant determining color scheme and icon.
+ * - info: Blue theme, information icon (for general notices)
+ * - success: Green theme, checkmark icon (for confirmations)
+ * - warning: Yellow/amber theme, warning icon (for cautions)
+ * - error: Red theme, error icon (for critical alerts)
+ */
+type AlertVariant = 'info' | 'success' | 'warning' | 'error';
+/**
+ * Props for the PdfAlert component.
+ */
+interface PdfAlertProps extends Omit<PDFComponentProps, 'children'> {
+    /**
+     * Alert variant determining color scheme and icon.
+     * @default "info"
+     */
+    variant?: AlertVariant;
+    /**
+     * Optional title displayed prominently at the top.
+     */
+    title?: string;
+    /**
+     * Description text or content.
+     * Can be a string or React nodes for more complex content.
+     */
+    children?: ReactNode;
+    /**
+     * Whether to show the icon.
+     * @default true
+     */
+    showIcon?: boolean;
+    /**
+     * Whether to show the left accent border.
+     * @default true
+     */
+    showBorder?: boolean;
+}
+
+/**
+ * PdfAlert — Displays info, success, warning, or error callout boxes.
+ *
+ * Use for important notices, confirmations, cautions, or critical alerts
+ * in reports, contracts, and documents.
+ *
+ * @example Basic info alert
+ * ```tsx
+ * <PdfAlert variant="info" title="Note">
+ *   This document requires a signature before proceeding.
+ * </PdfAlert>
+ * ```
+ *
+ * @example Success confirmation
+ * ```tsx
+ * <PdfAlert variant="success" title="Payment Confirmed">
+ *   Your payment of $500.00 has been received.
+ * </PdfAlert>
+ * ```
+ *
+ * @example Warning without icon
+ * ```tsx
+ * <PdfAlert variant="warning" title="Deadline Approaching" showIcon={false}>
+ *   Please submit your documents by March 15, 2026.
+ * </PdfAlert>
+ * ```
+ *
+ * @example Error alert
+ * ```tsx
+ * <PdfAlert variant="error" title="Action Required">
+ *   Missing required information. Please review and resubmit.
+ * </PdfAlert>
+ * ```
+ */
+declare function PdfAlert({ variant, title, children, showIcon, showBorder, style, }: PdfAlertProps): react_jsx_runtime.JSX.Element | null;
+
+/** List visual style variant. */
+type ListVariant = 'bullet' | 'numbered' | 'checklist' | 'icon' | 'multi-level' | 'descriptive';
+/** A single list item, optionally with nested children. */
+interface ListItem {
+    /** Primary text / title of the item. */
+    text: string;
+    /** Optional description shown below the title (used by descriptive variant). */
+    description?: string;
+    /** Optional checked state (used by checklist variant). */
+    checked?: boolean;
+    /** Optional nested children (used by multi-level variant). */
+    children?: ListItem[];
+}
+interface PdfListProps {
+    /** Array of list items. */
+    items: ListItem[];
+    /** Visual style of the list. @default 'bullet' */
+    variant?: ListVariant;
+    /** Spacing between list items. @default 'sm' */
+    gap?: 'xs' | 'sm' | 'md';
+    /** Custom style override applied to the outer container. */
+    style?: Style;
+    /** Indent level for nested rendering (internal use). */
+    _level?: number;
+    /**
+     * Prevent the List from being split across PDF pages.
+     * Useful for short lists that should always stay together on a single page.
+     * @default false
+     */
+    noWrap?: boolean;
+}
+
+declare function PdfList({ items, variant, gap, style, noWrap, _level, }: PdfListProps): react_jsx_runtime.JSX.Element;
+
+/** Card visual variant. */
+type CardVariant = 'default' | 'bordered' | 'muted';
+interface PdfCardProps {
+    /** Optional title displayed at the top of the card with a separator line. */
+    title?: string;
+    /** Card body content. */
+    children?: ReactNode;
+    /** Visual style of the card. @default 'default' */
+    variant?: CardVariant;
+    /** Internal padding size. @default 'md' */
+    padding?: 'sm' | 'md' | 'lg';
+    /**
+     * Allow the card to split across page boundaries.
+     * @default false — cards are kept on one page by default.
+     * Set wrap={true} only for tall cards whose content must span pages.
+     */
+    wrap?: boolean;
+    /** Custom style override. */
+    style?: Style;
+}
+
+declare function PdfCard({ title, children, variant, padding, wrap, style, }: PdfCardProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Error correction level for the QR code.
+ * Higher levels allow more damage but require more space.
+ * - L: ~7% recovery
+ * - M: ~15% recovery
+ * - Q: ~25% recovery
+ * - H: ~30% recovery
+ */
+type QRCodeErrorLevel = 'L' | 'M' | 'Q' | 'H';
+/**
+ * Props for the PdfQRCode component.
+ */
+interface PdfQRCodeProps extends Omit<PDFComponentProps, 'children'> {
+    /**
+     * The data to encode in the QR code.
+     * Can be a URL, text, or any string data.
+     */
+    value: string;
+    /**
+     * Size of the QR code in PDF points.
+     * The QR code is always square.
+     * @default 100
+     */
+    size?: number;
+    /**
+     * Color of the QR code modules (dark squares).
+     * Can be a hex color or theme color key.
+     * @default "foreground"
+     */
+    color?: string;
+    /**
+     * Background color of the QR code.
+     * Can be a hex color, theme color key, or "transparent".
+     * @default "background"
+     */
+    backgroundColor?: string;
+    /**
+     * Error correction level.
+     * Higher levels are more resilient but create denser codes.
+     * @default "M"
+     */
+    errorLevel?: QRCodeErrorLevel;
+    /**
+     * Margin around the QR code in modules (not points).
+     * @default 2
+     */
+    margin?: number;
+    /**
+     * Optional caption text below the QR code.
+     */
+    caption?: string;
+    /**
+     * No children allowed.
+     */
+    children?: never;
+}
+
+/**
+ * PdfQRCode — Renders a QR code using native SVG primitives.
+ *
+ * Uses the `qrcode` library for generation and react-pdf's SVG
+ * support for rendering. The result is a crisp, vector QR code
+ * that scales perfectly at any size.
+ *
+ * @example Basic usage
+ * ```tsx
+ * <PdfQRCode value="https://example.com" />
+ * ```
+ *
+ * @example Invoice with payment link
+ * ```tsx
+ * <PdfQRCode
+ *   value="https://pay.example.com/invoice/123"
+ *   size={80}
+ *   caption="Scan to pay"
+ * />
+ * ```
+ *
+ * @example Styled QR code
+ * ```tsx
+ * <PdfQRCode
+ *   value="https://example.com"
+ *   size={120}
+ *   color="primary"
+ *   backgroundColor="muted"
+ *   errorLevel="H"
+ * />
+ * ```
+ */
+declare function PdfQRCode({ value, size, color, backgroundColor, errorLevel, margin, caption, style, }: PdfQRCodeProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * HTTP methods supported by react-pdf for authenticated image requests.
+ */
+type PdfImageHTTPMethod = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+/**
+ * Image source accepted by react-pdf's Image component.
+ * - string: URL, absolute file path, or base64 data URI (`data:image/png;base64,...`)
+ * - object: authenticated URL with custom headers
+ */
+type PdfImageSrc = string | {
+    uri: string;
+    method?: PdfImageHTTPMethod;
+    headers?: Record<string, string>;
+    body?: string;
+};
+/**
+ * Controls how the image fills its container (mirrors CSS object-fit).
+ * - cover: fill, crop excess
+ * - contain: fit inside, preserve aspect ratio, may letterbox
+ * - fill: stretch to exactly fill (distorts aspect ratio)
+ * - none: render at intrinsic size
+ */
+type PdfImageFit = 'cover' | 'contain' | 'fill' | 'none';
+/**
+ * Visual layout variant.
+ *
+ * | Variant      | Width      | Height        | fit     | Notes                    |
+ * |-------------|------------|---------------|---------|--------------------------|
+ * | default     | prop/auto  | prop/auto     | contain | Standard inline image    |
+ * | full-width  | 100%       | prop required | cover   | Banner / hero image      |
+ * | thumbnail   | 80pt       | 80pt          | cover   | Small square preview     |
+ * | avatar      | 48pt       | 48pt          | cover   | Circle-clipped portrait  |
+ * | cover       | 100%       | 160pt         | cover   | Wide cover image         |
+ * | bordered    | 100%/prop  | prop          | contain | Framed with border       |
+ * | rounded     | prop/200pt | prop          | contain | Rounded corners          |
+ */
+type PdfImageVariant = 'default' | 'full-width' | 'thumbnail' | 'avatar' | 'cover' | 'bordered' | 'rounded';
+interface PdfImageProps {
+    /** Image source: URL, base64 data URI, file path, or authenticated object. */
+    src: PdfImageSrc;
+    /** Display variant controlling size and appearance. @default 'default' */
+    variant?: PdfImageVariant;
+    /** Width in PDF points. Required unless variant provides a default. */
+    width?: number | string;
+    /** Height in PDF points. Required unless variant provides a default. */
+    height?: number | string;
+    /** How the image fills its container. @default variant-dependent */
+    fit?: PdfImageFit;
+    /** Focal point for objectFit crop, e.g. '50% 50%' or 'top left'. @default '50% 50%' */
+    position?: string;
+    /** Optional caption text rendered below the image in muted style. */
+    caption?: string;
+    /**
+     * Aspect ratio helper: if width is provided but height is not,
+     * height = width / aspectRatio. E.g. 16/9 for widescreen images.
+     */
+    aspectRatio?: number;
+    /**
+     * Border radius override in PDF points.
+     * Defaults: avatar = 999 (circle), rounded = 8, others = 0.
+     */
+    borderRadius?: number;
+    /**
+     * Prevent the image (+ optional caption) from being split across page boundaries.
+     * @default true — images should never be clipped at the page edge.
+     */
+    noWrap?: boolean;
+    /** Custom style override applied to the image element. */
+    style?: Style;
+}
+/**
+ * PdfImage — a validated, theme-aware wrapper around react-pdf's `<Image>`.
+ *
+ * @example Basic usage
+ * ```tsx
+ * <PdfImage src="https://example.com/photo.jpg" width={200} height={150} />
+ * ```
+ *
+ * @example Base64 (recommended for reliability)
+ * ```tsx
+ * <PdfImage src="data:image/png;base64,iVBORw0KGgo..." variant="avatar" />
+ * ```
+ *
+ * @example Full-width banner with caption
+ * ```tsx
+ * <PdfImage src={bannerUrl} variant="cover" height={120} caption="Q1 2025 Team Photo" />
+ * ```
+ *
+ * @example Aspect ratio helper
+ * ```tsx
+ * <PdfImage src={chartPng} width={400} aspectRatio={16 / 9} />
+ * ```
+ *
+ * Supported formats: JPEG, PNG, GIF (first frame only), BMP, SVG.
+ * Unsupported: WebP, AVIF, HEIC — a console warning is emitted if detected.
+ */
+declare function PdfImage({ src, variant, width, height, fit, position, caption, aspectRatio, borderRadius, noWrap, style, }: PdfImageProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * A4 page width in points (595pt).
+ * Used for calculating safe graph widths.
+ */
+declare const A4_WIDTH = 595;
+/**
+ * Options for calculating graph width.
+ */
+interface GraphWidthOptions {
+    /** Additional container padding (e.g., Section padding). Default: 0 */
+    containerPadding?: number;
+    /** Additional wrapper padding (e.g., graphShell). Default: 0 */
+    wrapperPadding?: number;
+    /** Page size width override. Default: 595 (A4) */
+    pageWidth?: number;
+}
+/**
+ * Calculate the safe graph width based on theme page margins and container context.
+ *
+ * This utility ensures graphs don't overflow their container by accounting for:
+ * - Page margins (from theme)
+ * - Container padding (e.g., Section component)
+ * - Wrapper padding (e.g., a bordered graphShell View)
+ *
+ * @example
+ * ```tsx
+ * const width = getGraphWidth(theme);
+ * // For a graph inside a Section with padding="md" (12pt) and a graphShell (12pt):
+ * const width = getGraphWidth(theme, { containerPadding: 12, wrapperPadding: 12 });
+ * ```
+ */
+declare function getGraphWidth(theme: PdfxTheme, options?: GraphWidthOptions): number;
+/**
+ * Pre-calculated safe graph widths for common scenarios.
+ * These values work with all built-in themes on A4 pages.
+ */
+declare const GRAPH_SAFE_WIDTHS: {
+    /** Safe width for graph directly in page content (no extra containers) */
+    readonly default: 420;
+    /** Safe width for graph inside a Section with md padding */
+    readonly inSection: 400;
+    /** Safe width for graph inside a Section + bordered wrapper (like graphShell) */
+    readonly inSectionWithWrapper: 380;
+};
+type GraphVariant = 'bar' | 'horizontal-bar' | 'line' | 'area' | 'pie' | 'donut';
+type GraphLegendPosition = 'bottom' | 'right' | 'none';
+interface GraphDataPoint {
+    /** Label displayed on axis or legend. */
+    label: string;
+    /** Numeric value. */
+    value: number;
+    /** Optional per-data-point color override (hex). */
+    color?: string;
+}
+interface GraphSeries {
+    /** Series name shown in the legend. */
+    name: string;
+    /** Data points for this series. */
+    data: GraphDataPoint[];
+    /** Optional series-level color override (hex). */
+    color?: string;
+}
+interface GraphProps {
+    /** Chart type. @default 'bar' */
+    variant?: GraphVariant;
+    /**
+     * Single-series data or multi-series data.
+     * - GraphDataPoint[]: single series, used as-is.
+     * - GraphSeries[]: multi-series (bar, line, area only).
+     */
+    data: GraphDataPoint[] | GraphSeries[];
+    /** Chart title rendered above the chart area. */
+    title?: string;
+    /** Optional subtitle / description below title. */
+    subtitle?: string;
+    /** X-axis label. */
+    xLabel?: string;
+    /** Y-axis label. */
+    yLabel?: string;
+    /**
+     * Total SVG width in PDF points.
+     * Ignored when `fullWidth` is true.
+     * @default 420
+     */
+    width?: number;
+    /** Total SVG height in PDF points. @default 260 */
+    height?: number;
+    /**
+     * When true, automatically calculates width based on theme page margins.
+     * Accounts for page margins and optional container/wrapper padding.
+     * @default false
+     */
+    fullWidth?: boolean;
+    /**
+     * Container padding to account for when using fullWidth.
+     * Use this when graph is inside a Section or Card with padding.
+     * @default 0
+     */
+    containerPadding?: number;
+    /**
+     * Wrapper padding to account for when using fullWidth.
+     * Use this when graph is wrapped in a bordered View (like graphShell).
+     * @default 0
+     */
+    wrapperPadding?: number;
+    /** Override the color palette (hex values). */
+    colors?: string[];
+    /** Show numeric value labels on bars or data points. @default false */
+    showValues?: boolean;
+    /** Show horizontal grid lines. @default true */
+    showGrid?: boolean;
+    /** Legend position. @default 'bottom' */
+    legend?: GraphLegendPosition;
+    /** For donut variant: text displayed in the center hole. */
+    centerLabel?: string;
+    /** For line/area: show dots at each data point. @default true */
+    showDots?: boolean;
+    /** For line/area: render smooth bezier curves (false = straight segments). @default false */
+    smooth?: boolean;
+    /** Number of Y-axis ticks. @default 5 */
+    yTicks?: number;
+    /**
+     * Prevent the chart from splitting across page boundaries.
+     * @default true
+     */
+    noWrap?: boolean;
+    /** Custom style override applied to the outer container View. */
+    style?: Style;
+}
+/**
+ * PdfGraph — renders bar, horizontal-bar, line, area, pie, and donut charts
+ * natively inside react-pdf documents using SVG primitives.
+ *
+ * No external chart libraries are required or used — all rendering is done via
+ * react-pdf's built-in SVG support (`<Svg>`, `<Rect>`, `<Path>`, `<Line>`, etc.).
+ *
+ * @example Bar chart
+ * ```tsx
+ * <PdfGraph
+ *   variant="bar"
+ *   title="Monthly Revenue"
+ *   data={[
+ *     { label: 'Jan', value: 42000 },
+ *     { label: 'Feb', value: 38000 },
+ *     { label: 'Mar', value: 55000 },
+ *   ]}
+ * />
+ * ```
+ *
+ * @example Donut chart with center label
+ * ```tsx
+ * <PdfGraph
+ *   variant="donut"
+ *   data={[
+ *     { label: 'Product A', value: 45 },
+ *     { label: 'Product B', value: 30 },
+ *     { label: 'Other', value: 25 },
+ *   ]}
+ *   centerLabel="$1.2M"
+ * />
+ * ```
+ *
+ * **Limitations (by design):**
+ * - No interactivity (PDFs are static)
+ * - No animations
+ * - SVG Text inside charts uses SVG font attributes (not react-pdf StyleSheet fonts)
+ * - For print PDFs use SVG-friendly fonts registered with Font.register()
+ */
+declare function PdfGraph({ variant, data, title, subtitle, xLabel, yLabel, width: explicitWidth, height, fullWidth, containerPadding, wrapperPadding, colors, showValues, showGrid, legend, centerLabel, showDots, smooth, yTicks: yTickCount, noWrap, style, }: GraphProps): react_jsx_runtime.JSX.Element;
+
+/** Visual style variant for the fillable form. */
+type PdfFormVariant = 'underline' | 'box' | 'outlined' | 'ghost';
+/** Column layout for a form section. */
+type FormLayout = 'single' | 'two-column' | 'three-column';
+/** Label position relative to the field. */
+type FormLabelPosition = 'above' | 'left';
+/** A single fillable field definition. */
+interface PdfFormField {
+    /** Field label shown above or beside the blank area. */
+    label: string;
+    /**
+     * Hint text shown inside the blank area (lighter, smaller).
+     * Use this for format hints like "DD/MM/YYYY" or "e.g. John Smith".
+     * If omitted, the field area is completely blank.
+     */
+    hint?: string;
+    /**
+     * Height of the blank field area in points.
+     * @default 18 (single-line) — use larger values for multi-line fields
+     */
+    height?: number;
+    /** Optional flex or fixed width. Useful in multi-column grids. */
+    width?: number | string;
+}
+/** A logical group of fields with an optional section title. */
+interface PdfFormGroup {
+    /** Optional group heading rendered above the fields. */
+    title?: string;
+    /** Fields in this group. */
+    fields: PdfFormField[];
+    /** Column layout for this group's fields. @default 'single' */
+    layout?: FormLayout;
+}
+/** Props for the PdfForm component. */
+interface PdfFormProps {
+    /** Form-level title (e.g. "Application Form", "Service Request"). */
+    title?: string;
+    /** Optional subtitle shown below the title. */
+    subtitle?: string;
+    /** Ordered list of field groups. */
+    groups: PdfFormGroup[];
+    /**
+     * Visual style of the blank field areas.
+     * - `underline` — classic bottom-border only (default, most print-friendly)
+     * - `box`       — full rectangle outline (clearer for dense forms)
+     * - `outlined`  — rounded rectangle outline
+     * - `ghost`     — very light filled rectangle, no border
+     */
+    variant?: PdfFormVariant;
+    /** Label position: above the field or to its left. @default 'above' */
+    labelPosition?: FormLabelPosition;
+    /** Prevent the form from splitting across pages. @default false */
+    noWrap?: boolean;
+    /** Custom @react-pdf/renderer styles applied to the root container. */
+    style?: Style;
+}
+
+declare function PdfForm({ title, subtitle, groups, variant, labelPosition, noWrap, style, }: PdfFormProps): react_jsx_runtime.JSX.Element;
+
+/** Signature block layout variant. */
+type SignatureVariant = 'single' | 'double' | 'inline';
+/** Data for a single signer inside a signature block. */
+interface SignatureSigner {
+    label?: string;
+    name?: string;
+    title?: string;
+    date?: string;
+}
+interface PdfSignatureBlockProps {
+    variant?: SignatureVariant;
+    label?: string;
+    name?: string;
+    title?: string;
+    date?: string;
+    signers?: [SignatureSigner, SignatureSigner];
+    style?: Style;
+}
+
+declare function PdfSignatureBlock({ variant, label, name, title, date, signers, style, }: PdfSignatureBlockProps): react_jsx_runtime.JSX.Element;
+
+interface KeepTogetherProps {
+    /**
+     * Content to keep on the same page.
+     * The outer View is rendered with wrap={false} so the engine treats this subtree as atomic.
+     * If the content is taller than one full page it will overflow (not split), so only use
+     * this for content that is guaranteed to fit on a single page.
+     */
+    children?: ReactNode;
+    /**
+     * If provided, moves the entire block to the next page when fewer than
+     * this many PDF points remain on the current page.
+     * Useful as a softer alternative to wrap={false} for headings/labels with following content.
+     */
+    minPresenceAhead?: number;
+    /** Custom style override applied to the wrapping View. */
+    style?: Style;
+}
+/**
+ * KeepTogether — prevents its children from being split across page boundaries.
+ *
+ * Wraps children in a `<View wrap={false}>` which tells react-pdf's layout engine
+ * to treat the entire subtree as atomic: either the whole block fits on the current
+ * page, or the whole block moves to the next page.
+ *
+ * @example
+ * // Prevent a heading + table from being separated
+ * <KeepTogether>
+ *   <Heading level={2}>Quarterly Financials</Heading>
+ *   <Table>...</Table>
+ * </KeepTogether>
+ *
+ * @example
+ * // Softer version: move to next page only if < 100pt remain
+ * <KeepTogether minPresenceAhead={100}>
+ *   <Heading level={3}>Summary</Heading>
+ *   <Text>Short paragraph that should stay with its heading.</Text>
+ * </KeepTogether>
+ */
+declare function KeepTogether({ children, minPresenceAhead, style }: KeepTogetherProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Invoice template variants.
+ * - classic: Traditional professional look with logo-left header and grid table
+ * - modern: Full-width banner header with horizontal invoice strip
+ * - minimal: Clean minimalist design with inline invoice stamp
+ */
+type InvoiceVariant = 'classic' | 'modern' | 'minimal';
+/**
+ * Company/sender information.
+ */
+interface InvoiceCompany {
+    /** Company or business name */
+    name: string;
+    /** Optional tagline or subtitle */
+    subtitle?: string;
+    /** Full address (can include city, state, country) */
+    address: string;
+    /** Contact email */
+    email?: string;
+    /** Contact phone */
+    phone?: string;
+    /** Tax ID, VAT, or GST number */
+    taxId?: string;
+    /** Logo image source (URL or base64) */
+    logo?: string;
+}
+/**
+ * Client/recipient information.
+ */
+interface InvoiceClient {
+    /** Client name or company */
+    name: string;
+    /** Full address */
+    address: string;
+    /** Contact email */
+    email?: string;
+    /** Contact phone */
+    phone?: string;
+}
+/**
+ * Single line item on the invoice.
+ */
+interface InvoiceLineItem {
+    /** Description of the product or service */
+    description: string;
+    /** Quantity */
+    quantity: number;
+    /** Unit price */
+    unitPrice: number;
+    /** Optional unit label (e.g., "hours", "units") */
+    unit?: string;
+}
+/**
+ * Invoice summary/totals section.
+ */
+interface InvoiceSummary {
+    /** Subtotal before tax */
+    subtotal: number;
+    /** Tax amount */
+    tax?: number;
+    /** Tax rate as percentage (e.g., 7.5 for 7.5%) */
+    taxRate?: number;
+    /** Optional discount amount */
+    discount?: number;
+    /** Optional shipping/handling */
+    shipping?: number;
+    /** Final total */
+    total: number;
+}
+/**
+ * Payment information.
+ */
+interface InvoicePayment {
+    /** Payment methods accepted */
+    methods?: string;
+    /** Bank details or payment instructions */
+    bankDetails?: string;
+    /** Terms (e.g., "Net 30", "Due on receipt") */
+    terms?: string;
+}
+/**
+ * Currency configuration.
+ */
+interface InvoiceCurrency {
+    /** Currency code (e.g., "USD", "EUR", "INR") */
+    code?: string;
+    /** Currency symbol (e.g., "$", "€", "₹") */
+    symbol?: string;
+    /** Decimal places (default: 2) */
+    decimals?: number;
+    /** Symbol position: 'before' or 'after' */
+    position?: 'before' | 'after';
+}
+/**
+ * Props for the InvoiceTemplate component.
+ */
+interface InvoiceTemplateProps {
+    /**
+     * Visual variant of the invoice.
+     * @default "classic"
+     */
+    variant?: InvoiceVariant;
+    /**
+     * Invoice number/identifier.
+     */
+    invoiceNumber: string;
+    /**
+     * Invoice issue date.
+     */
+    invoiceDate: string;
+    /**
+     * Payment due date.
+     */
+    dueDate: string;
+    /**
+     * Sender/company information.
+     */
+    company: InvoiceCompany;
+    /**
+     * Recipient/client information.
+     */
+    client: InvoiceClient;
+    /**
+     * Line items (products/services).
+     */
+    items: InvoiceLineItem[];
+    /**
+     * Invoice totals summary.
+     * If not provided, will be calculated from items.
+     */
+    summary?: InvoiceSummary;
+    /**
+     * Tax rate as percentage (used if summary not provided).
+     * @default 0
+     */
+    taxRate?: number;
+    /**
+     * Payment information.
+     */
+    payment?: InvoicePayment;
+    /**
+     * Currency configuration.
+     * @default { symbol: '$', position: 'before', decimals: 2 }
+     */
+    currency?: InvoiceCurrency;
+    /**
+     * Additional notes or terms (displayed at bottom).
+     */
+    notes?: string;
+    /**
+     * Custom styles for the page.
+     */
+    style?: Style;
+    /**
+     * Document title for PDF metadata.
+     */
+    title?: string;
+}
+
+/**
+ * InvoiceTemplate — A data-driven invoice PDF generator.
+ *
+ * Supports three visual variants: classic, modern, and minimal.
+ * Pass structured data (company, client, items) and get a professional invoice.
+ *
+ * @example Basic usage
+ * ```tsx
+ * <InvoiceTemplate
+ *   invoiceNumber="INV-001"
+ *   invoiceDate="March 1, 2026"
+ *   dueDate="March 31, 2026"
+ *   company={{ name: "Acme Inc", address: "123 Main St" }}
+ *   client={{ name: "Client Co", address: "456 Oak Ave" }}
+ *   items={[{ description: "Consulting", quantity: 10, unitPrice: 150 }]}
+ * />
+ * ```
+ *
+ * @example Modern variant with tax
+ * ```tsx
+ * <InvoiceTemplate
+ *   variant="modern"
+ *   invoiceNumber="INV-002"
+ *   invoiceDate="March 1, 2026"
+ *   dueDate="March 31, 2026"
+ *   company={{ name: "TechCorp", address: "789 Tech Blvd", logo: "/logo.png" }}
+ *   client={{ name: "StartupXYZ", address: "321 Innovation Dr" }}
+ *   items={[{ description: "Development", quantity: 1, unitPrice: 5000 }]}
+ *   taxRate={8.5}
+ * />
+ * ```
+ */
+declare function InvoiceTemplate(props: InvoiceTemplateProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Resume template variants.
+ * - professional: Traditional single-column professional layout
+ * - modern: Two-column design with sidebar for skills/contact
+ * - minimal: Clean minimalist single-column design
+ */
+type ResumeVariant = 'professional' | 'modern' | 'minimal';
+/**
+ * Personal/contact information.
+ */
+interface ResumePersonal {
+    /** Full name */
+    name: string;
+    /** Professional title or headline */
+    title?: string;
+    /** Email address */
+    email?: string;
+    /** Phone number */
+    phone?: string;
+    /** Location (city, country) */
+    location?: string;
+    /** LinkedIn URL or handle */
+    linkedin?: string;
+    /** GitHub URL or handle */
+    github?: string;
+    /** Personal website URL */
+    website?: string;
+    /** Profile photo URL (optional) */
+    photo?: string;
+}
+/**
+ * Professional summary/objective section.
+ */
+interface ResumeSummary {
+    /** Section title (defaults to "Summary" or "Professional Summary") */
+    title?: string;
+    /** Summary content - 2-4 sentences */
+    content: string;
+}
+/**
+ * Single work experience entry.
+ */
+interface ResumeExperience {
+    /** Company or organization name */
+    company: string;
+    /** Job title/role */
+    role: string;
+    /** Start date (e.g., "Jan 2022" or "2022") */
+    startDate: string;
+    /** End date (e.g., "Dec 2024" or "Present") */
+    endDate?: string;
+    /** Location (optional) */
+    location?: string;
+    /** List of achievements/responsibilities */
+    highlights?: string[];
+    /** Brief description (alternative to highlights) */
+    description?: string;
+}
+/**
+ * Single education entry.
+ */
+interface ResumeEducation {
+    /** Institution name */
+    institution: string;
+    /** Degree or certification */
+    degree: string;
+    /** Field of study */
+    field?: string;
+    /** Start date */
+    startDate?: string;
+    /** End date or expected graduation */
+    endDate?: string;
+    /** GPA or honors (optional) */
+    gpa?: string;
+    /** Additional details */
+    highlights?: string[];
+}
+/**
+ * Skill category with items.
+ */
+interface ResumeSkillCategory {
+    /** Category name (e.g., "Languages", "Frameworks", "Tools") */
+    category: string;
+    /** Skills in this category */
+    skills: string[];
+}
+/**
+ * Single project entry.
+ */
+interface ResumeProject {
+    /** Project name */
+    name: string;
+    /** Brief description */
+    description?: string;
+    /** Technologies used */
+    technologies?: string[];
+    /** Project URL (optional) */
+    url?: string;
+    /** Key achievements */
+    highlights?: string[];
+}
+/**
+ * Single certification entry.
+ */
+interface ResumeCertification {
+    /** Certification name */
+    name: string;
+    /** Issuing organization */
+    issuer: string;
+    /** Date obtained */
+    date?: string;
+    /** Credential ID or URL */
+    credentialId?: string;
+}
+/**
+ * Language proficiency entry.
+ */
+interface ResumeLanguage {
+    /** Language name */
+    language: string;
+    /** Proficiency level */
+    proficiency: 'Native' | 'Fluent' | 'Advanced' | 'Intermediate' | 'Basic' | string;
+}
+/**
+ * Props for the ResumeTemplate component.
+ */
+interface ResumeTemplateProps {
+    /**
+     * Visual variant of the resume.
+     * @default "professional"
+     */
+    variant?: ResumeVariant;
+    /**
+     * Personal/contact information (required).
+     */
+    personal: ResumePersonal;
+    /**
+     * Professional summary or objective.
+     */
+    summary?: ResumeSummary;
+    /**
+     * Work experience entries (most recent first).
+     */
+    experience?: ResumeExperience[];
+    /**
+     * Education entries.
+     */
+    education?: ResumeEducation[];
+    /**
+     * Skills organized by category.
+     */
+    skills?: ResumeSkillCategory[];
+    /**
+     * Projects or portfolio items.
+     */
+    projects?: ResumeProject[];
+    /**
+     * Certifications.
+     */
+    certifications?: ResumeCertification[];
+    /**
+     * Languages spoken.
+     */
+    languages?: ResumeLanguage[];
+    /**
+     * Accent color for modern variant.
+     * Uses theme primary color by default.
+     */
+    accentColor?: string;
+    /**
+     * Custom styles for the page.
+     */
+    style?: Style;
+    /**
+     * Document title for PDF metadata.
+     */
+    title?: string;
+}
+
+/**
+ * ResumeTemplate — A data-driven resume/CV PDF generator.
+ *
+ * Supports three visual variants: professional, modern, and minimal.
+ * Pass structured data (personal info, experience, education, skills)
+ * and get a professional resume PDF.
+ *
+ * @example Basic usage
+ * ```tsx
+ * <ResumeTemplate
+ *   personal={{
+ *     name: 'John Doe',
+ *     title: 'Senior Software Engineer',
+ *     email: 'john@example.com',
+ *     phone: '+1 555-1234',
+ *     location: 'San Francisco, CA',
+ *   }}
+ *   experience={[
+ *     {
+ *       company: 'TechCorp',
+ *       role: 'Senior Engineer',
+ *       startDate: 'Jan 2020',
+ *       endDate: 'Present',
+ *       highlights: ['Led team of 5', 'Shipped key features'],
+ *     },
+ *   ]}
+ *   education={[
+ *     {
+ *       institution: 'MIT',
+ *       degree: 'B.S.',
+ *       field: 'Computer Science',
+ *       endDate: '2019',
+ *     },
+ *   ]}
+ *   skills={[
+ *     { category: 'Languages', skills: ['TypeScript', 'Python', 'Go'] },
+ *   ]}
+ * />
+ * ```
+ */
+declare function ResumeTemplate(props: ResumeTemplateProps): react_jsx_runtime.JSX.Element;
+
+export { A4_WIDTH, type AlertVariant, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, type CardVariant, DataTable, type DataTableColumn, type DataTableProps, type DataTableSize, Divider, type DividerProps, type DividerSpacing, type DividerThickness, type DividerVariant, type FormLabelPosition, type FormLayout, GRAPH_SAFE_WIDTHS, type GraphDataPoint, type GraphLegendPosition, type GraphProps, type GraphSeries, type GraphVariant, type GraphWidthOptions, Heading, type HeadingProps, type HeadingTracking, type HeadingWeight, type InvoiceClient, type InvoiceCompany, type InvoiceCurrency, type InvoiceLineItem, type InvoicePayment, type InvoiceSummary, InvoiceTemplate, type InvoiceTemplateProps, type InvoiceVariant, KeepTogether, type KeepTogetherProps, KeyValue, type KeyValueDirection, type KeyValueEntry, type KeyValueProps, type KeyValueSize, Link, type LinkProps, type LinkUnderline, type LinkVariant, type ListItem, type ListVariant, type PDFComponentProps, PageBreak, type PageBreakProps, PageFooter, type PageFooterProps, type PageFooterVariant, PageHeader, type PageHeaderProps, type PageHeaderVariant, type PageNumberAlign, type PageNumberSize, PdfAlert, type PdfAlertProps, PdfCard, type PdfCardProps, PdfForm, type PdfFormField, type PdfFormGroup, type PdfFormProps, type PdfFormVariant, PdfGraph, PdfImage, type PdfImageFit, type PdfImageProps, type PdfImageSrc, type PdfImageVariant, PdfList, type PdfListProps, PdfPageNumber, type PdfPageNumberProps, PdfQRCode, type PdfQRCodeProps, PdfSignatureBlock, type PdfSignatureBlockProps, PdfWatermark, type PdfWatermarkProps, PdfxError, PdfxTheme, PdfxThemeContext, PdfxThemeProvider, type QRCodeErrorLevel, type ResumeCertification, type ResumeEducation, type ResumeExperience, type ResumeLanguage, type ResumePersonal, type ResumeProject, type ResumeSkillCategory, type ResumeSummary, ResumeTemplate, type ResumeTemplateProps, type ResumeVariant, Section, type SectionPadding, type SectionProps, type SectionSpacing, type SectionVariant, type SignatureSigner, type SignatureVariant, Stack, type StackAlign, type StackDirection, type StackGap, type StackJustify, type StackProps, Table, TableBody, TableCell, type TableCellProps, TableFooter, TableHeader, type TableProps, TableRow, type TableRowProps, type TableSectionProps, type TableVariant, Text, type TextDecoration, type TextProps, type TextVariant, type TextWeight, ValidationError, type WatermarkPosition, createThemeTw, getGraphWidth, tw, usePdfxTheme };