import type { ExportFileNameGetter, ExportParams } from './exportParams';
import type { Column, ColumnGroup } from './iColumn';
import type { AgGridCommon } from './iCommon';
import type { ColumnWidthCallbackParams } from './iExcelCreator';
import type { IRowNode } from './iRowNode';
export type PdfPageOrientation = 'portrait' | 'landscape';
export type PdfBuiltInFontFamily = 'Helvetica' | 'Helvetica-Bold' | 'Times-Roman' | 'Times-Bold' | 'Courier' | 'Courier-Bold';
export type PdfFontFamily = PdfBuiltInFontFamily | (string & {});
export type PdfPageSize = 'A4' | 'Letter' | {
    /** Page width in points. */
    width: number;
    /** Page height in points. */
    height: number;
};
export interface PdfMargin {
    /** Top margin in points. */
    top?: number;
    /** Right margin in points. */
    right?: number;
    /** Bottom margin in points. */
    bottom?: number;
    /** Left margin in points. */
    left?: number;
}
export type PdfTextAlignment = 'left' | 'center' | 'right';
export type PdfFontWeight = 'normal' | 'bold' | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
export type PdfFontStyle = 'normal' | 'italic' | 'oblique';
export type PdfTextDirection = 'ltr' | 'rtl' | 'auto';
export interface PdfFontFace {
    /** Static TrueType font data. */
    data: ArrayBuffer | Uint8Array;
    /**
     * Weight represented by this face.
     * @default 400
     */
    weight?: PdfFontWeight;
    /**
     * Style represented by this face.
     * @default 'normal'
     */
    style?: PdfFontStyle;
}
export interface PdfFontFamilyDefinition {
    /** Family name used by PDF styles. */
    family: string;
    /** Font faces available for this family. */
    faces: PdfFontFace[];
}
export type PdfTextOverflow = 'clip' | 'ellipsis';
export type PdfColumnWidth = number | 'auto' | 'grid';
export type PdfColumnWidthCallback = (params: ColumnWidthCallbackParams) => PdfColumnWidth | null | undefined;
export type PdfImageType = 'jpg' | 'jpeg' | 'png';
export type PdfImageAlignment = 'start' | 'end';
export interface PdfImage {
    /**
     * Identifier used to embed repeated images only once in the PDF.
     */
    id: string;
    /**
     * Base64 image data, with or without a data URL prefix.
     */
    base64: string;
    /**
     * Image format.
     */
    imageType: PdfImageType;
    /**
     * Alternative text for the image.
     */
    altText?: string;
    /**
     * Rendered width in points. When omitted, the intrinsic image width is used at 96 DPI.
     * Setting only one of `width` and `height` preserves the aspect ratio;
     * setting both stretches the image to those dimensions.
     */
    width?: number;
    /**
     * Rendered height in points. When omitted, the intrinsic image height is used at 96 DPI.
     * Setting only one of `width` and `height` preserves the aspect ratio;
     * setting both stretches the image to those dimensions.
     */
    height?: number;
    /**
     * Image alignment relative to adjacent text.
     * @default 'start'
     */
    alignment?: PdfImageAlignment;
    /**
     * Space between the image and adjacent text in points.
     * @default 4
     */
    gap?: number;
}
export interface PdfTextStyle {
    /**
     * Font size in points.
     */
    fontSize?: number;
    /**
     * Font family.
     */
    fontFamily?: PdfFontFamily;
    /**
     * Font weight. When omitted, the weight from the resolved font family is preserved.
     */
    fontWeight?: PdfFontWeight;
    /**
     * Font style.
     * @default 'normal'
     */
    fontStyle?: PdfFontStyle;
    /**
     * Text direction. `auto` uses the first strong directional character.
     * When omitted, the export-level direction is used.
     * Text direction does not change exported column order.
     */
    direction?: PdfTextDirection;
    /**
     * BCP 47 language tag used when selecting language-specific OpenType features.
     * When omitted, the export-level language is used.
     */
    language?: string;
    /**
     * Text colour.
     */
    color?: string;
    /**
     * Distance between text baselines in points.
     * Defaults to the natural line height from the resolved font metrics,
     * with a minimum of `fontSize`.
     */
    lineHeight?: number;
}
export interface PdfCellStyle extends PdfTextStyle {
    /**
     * Background colour.
     */
    backgroundColor?: string;
    /**
     * Border colour.
     */
    borderColor?: string;
    /**
     * Border width in points.
     * Defaults to 1 when `borderColor` is set, otherwise 0.
     */
    borderWidth?: number;
    /**
     * Padding inside the cell in points. A number applies to all sides.
     */
    padding?: number | PdfMargin;
    /**
     * Horizontal alignment for the cell text.
     */
    alignment?: PdfTextAlignment;
    /**
     * Whether text should wrap onto multiple lines. Wrapped content increases the row height as required.
     * @default false
     */
    wrapText?: boolean;
    /**
     * Whether explicit line breaks should be preserved.
     * @default true when wrapText is true, otherwise false
     */
    preserveLineBreaks?: boolean;
    /**
     * Whether repeated, leading and trailing spaces should be preserved when text wraps.
     * @default false
     */
    preserveSpaces?: boolean;
    /**
     * Maximum number of rendered text lines.
     */
    maxLines?: number;
    /**
     * How text exceeding the available width, height or line limit is indicated.
     * @default 'ellipsis'
     */
    overflow?: PdfTextOverflow;
}
export interface PdfCellData {
    /** The value of the cell. */
    value: string | null;
    /** External URI opened when the exported cell text is selected. */
    hyperlink?: string;
    /** Image rendered alongside the cell value. */
    image?: PdfImage;
}
export interface PdfCell {
    /** The data that will be added to the cell. */
    data: PdfCellData;
    /**
     * The number of cells to span across (1 means span 2 columns).
     * @default 0
     */
    mergeAcross?: number;
    /**
     * Optional styling for the cell.
     */
    style?: PdfCellStyle;
}
export type PdfCustomContent = PdfCell[][] | string;
interface PdfStyleCallbackParamsBase<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
    /**
     * 1-based index of the current exported row.
     */
    accumulatedRowIndex: number;
    /**
     * The current value for the exported element.
     */
    value: any;
}
export interface PdfRowStyleCallbackParams<TData = any, TContext = any> extends PdfStyleCallbackParamsBase<TData, TContext> {
    /** The exported element type currently being styled. */
    type: 'row';
    /** The row node for the exported row. */
    node?: IRowNode<TData> | null;
}
export interface PdfCellStyleCallbackParams<TData = any, TContext = any> extends PdfStyleCallbackParamsBase<TData, TContext> {
    /** The exported element type currently being styled. */
    type: 'cell' | 'rowgroup';
    /** The row node for the exported cell. */
    node?: IRowNode<TData> | null;
    /** The current column. */
    column?: Column;
}
export interface PdfHeaderStyleCallbackParams<TData = any, TContext = any> extends PdfStyleCallbackParamsBase<TData, TContext> {
    /** The exported element type currently being styled. */
    type: 'header';
    /** The current column. */
    column?: Column;
}
export interface PdfGroupHeaderStyleCallbackParams<TData = any, TContext = any> extends PdfStyleCallbackParamsBase<TData, TContext> {
    /** The exported element type currently being styled. */
    type: 'groupheader';
    /** The current column group. */
    column?: ColumnGroup;
}
export type PdfStyleCallbackParams<TData = any, TContext = any> = PdfRowStyleCallbackParams<TData, TContext> | PdfCellStyleCallbackParams<TData, TContext> | PdfHeaderStyleCallbackParams<TData, TContext> | PdfGroupHeaderStyleCallbackParams<TData, TContext>;
export interface PdfCellHyperlinkCallbackParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
    /** The final text exported for the cell. */
    value: string;
    /** The 1-based index of the current exported row. */
    accumulatedRowIndex: number;
    /** The row node for the exported cell. */
    node: IRowNode<TData>;
    /** The current column. */
    column: Column;
}
export interface PdfCellImageCallbackParams<TData = any, TContext = any> extends AgGridCommon<TData, TContext> {
    /** The final text exported for the cell. */
    value: string;
    /** The 1-based index of the current exported row. */
    accumulatedRowIndex: number;
    /** The row node for the exported cell. */
    node: IRowNode<TData>;
    /** The current column. */
    column: Column;
}
export interface PdfCellImageResult {
    /** Image rendered in the exported cell. */
    image: PdfImage;
    /** Text rendered alongside the image. When omitted, the exported cell text is removed. */
    value?: string | null;
}
export interface PdfColors {
    /**
     * Background colour for the PDF page.
     * @default theme backgroundColor
     */
    backgroundColor?: string;
    /**
     * Background colour for body rows.
     * @default theme dataBackgroundColor
     */
    dataBackgroundColor?: string;
    /**
     * Alternate background colour for odd body rows.
     * @default theme oddRowBackgroundColor
     */
    oddRowBackgroundColor?: string;
    /**
     * Text colour for body rows.
     * @default theme foregroundColor
     */
    foregroundColor?: string;
    /**
     * Background colour for header rows.
     * @default theme headerBackgroundColor
     */
    headerBackgroundColor?: string;
    /**
     * Text colour for header rows.
     * @default theme headerTextColor
     */
    headerTextColor?: string;
    /**
     * Border colour for cell outlines.
     * @default theme borderColor
     */
    borderColor?: string;
}
export interface PdfDocumentHeadingStyle extends PdfCellStyle {
    /**
     * Margin around the document heading in points. A number applies to all sides.
     */
    margin?: number | PdfMargin;
}
export interface PdfHeaderFooterConfig {
    /** Header and footer configuration applied to every page unless overridden. */
    all?: PdfHeaderFooter;
    /** Header and footer configuration applied to the first page. */
    first?: PdfHeaderFooter;
    /** Header and footer configuration applied to even-numbered pages. */
    even?: PdfHeaderFooter;
}
export interface PdfHeaderFooter {
    /** Up to three header entries positioned left, centre, and right. */
    header?: PdfHeaderFooterContent[];
    /** Up to three footer entries positioned left, centre, and right. */
    footer?: PdfHeaderFooterContent[];
}
interface PdfHeaderFooterContentBase {
    /**
     * Position of the content within the printable page width.
     * When omitted, array entries default to left, centre, and right in order.
     */
    position?: 'Left' | 'Center' | 'Right';
    /** Text styling for this entry. */
    style?: PdfTextStyle;
}
export interface PdfHeaderFooterTextContent extends PdfHeaderFooterContentBase {
    /**
     * Header or footer text. Supports `&[Page]`, `&[Pages]`, `&[Date]`, and `&[Time]` placeholders.
     */
    value: string;
    /** Image rendered alongside the text. */
    image?: PdfImage;
}
export interface PdfHeaderFooterImageContent extends PdfHeaderFooterContentBase {
    /**
     * Header or footer text. Supports `&[Page]`, `&[Pages]`, `&[Date]`, and `&[Time]` placeholders.
     */
    value?: string;
    /** Image rendered alongside the text. */
    image: PdfImage;
}
export type PdfHeaderFooterContent = PdfHeaderFooterTextContent | PdfHeaderFooterImageContent;
export type PdfWatermarkPageSelection = 'all' | 'first' | 'odd' | 'even';
export interface PdfWatermark {
    /** Text displayed diagonally across the exported page content. */
    text: string;
    /**
     * Text opacity from `0` (transparent) to `1` (opaque).
     * @default 0.12
     */
    opacity?: number;
    /**
     * Rotation in degrees.
     * @default -45
     */
    rotation?: number;
    /**
     * Pages on which the watermark is rendered.
     * @default 'all'
     */
    pages?: PdfWatermarkPageSelection;
    /** Text styling for the watermark. */
    style?: PdfTextStyle;
}
export interface PdfPageSetup {
    /**
     * The size of the PDF page.
     * @default 'A4'
     */
    size?: PdfPageSize;
    /**
     * Page orientation.
     * @default 'landscape'
     */
    orientation?: PdfPageOrientation;
    /**
     * Page margins in points. A number applies to all sides.
     * @default 36
     */
    margin?: number | PdfMargin;
}
interface PdfFileParams {
    /**
     * String to use as the file name or a function that returns a string.
     * @default 'export.pdf'
     */
    fileName?: string | ExportFileNameGetter;
    /**
     * The mimeType of the PDF file.
     * @default 'application/pdf'
     */
    mimeType?: string;
}
export interface PdfExportParams extends ExportParams<PdfCustomContent>, PdfFileParams {
    /**
     * Custom static TrueType font families available to this export.
     * Font data must be loaded by the application before export.
     * @default []
     */
    fonts?: PdfFontFamilyDefinition[];
    /**
     * BCP 47 language tag used for text shaping and PDF accessibility metadata.
     * This can be overridden by individual cell styles.
     */
    language?: string;
    /**
     * Default text direction for the PDF document. When omitted, this inherits
     * the grid's `enableRtl` setting. Individual `PdfCellStyle.direction`
     * values take precedence for text. An export-level value of `rtl` also
     * renders table columns in right-to-left order.
     * @default grid enableRtl setting
     */
    direction?: PdfTextDirection;
    /**
     * The document title stored in the PDF metadata.
     * When set, a visible title is rendered above the exported table.
     */
    documentTitle?: string;
    /**
     * Styling for the visible document title.
     */
    documentTitleStyle?: PdfDocumentHeadingStyle;
    /**
     * A visible subtitle rendered below the document title.
     */
    documentSubtitle?: string;
    /**
     * Styling for the visible document subtitle.
     */
    documentSubtitleStyle?: PdfDocumentHeadingStyle;
    /**
     * Set to `true` to render the document title and subtitle on a separate first page.
     * The exported grid begins on the following page.
     * @default false
     */
    coverPage?: boolean;
    /**
     * Page header and footer content.
     */
    headerFooterConfig?: PdfHeaderFooterConfig;
    /**
     * A text watermark rendered across the content of selected pages.
     */
    watermark?: PdfWatermark;
    /**
     * Override PDF colours. Any missing values fall back to the current theme.
     */
    colors?: PdfColors;
    /**
     * Set to `true` to skip applying grid style definitions and callbacks
     * (`rowStyle`, `getRowStyle`, `colDef.cellStyle`, `colDef.headerStyle`).
     * Use this when you want to rely only on `colors` and theme defaults.
     * @default false
     */
    skipGridStyles?: boolean;
    /**
     * Callback that allows overriding styles for rows, cells, row groups,
     * headers and group headers during PDF export.
     * Returned styles are merged after resolved grid styles and take precedence.
     */
    processStyleCallback?(params: PdfStyleCallbackParams): PdfCellStyle | undefined;
    /**
     * Callback that provides an external URI for an exported body cell.
     * The returned URI is added to the PDF as a clickable link annotation.
     */
    processCellHyperlinkCallback?(params: PdfCellHyperlinkCallbackParams): string | null | undefined;
    /**
     * Callback that provides an image for an exported body cell.
     * Return an optional value to replace the exported cell text.
     */
    addImageToCell?(params: PdfCellImageCallbackParams): PdfCellImageResult | null | undefined;
    /**
     * Page size, orientation and margins.
     * @default { size: 'A4', orientation: 'landscape', margin: 36 }
     */
    page?: PdfPageSetup;
    /**
     * Default style applied to every body cell, including custom content rows.
     * Grid styles, row and cell styles, and `processStyleCallback` results
     * override these values.
     * When no style is provided, body cells use `Helvetica` at 10 points.
     * @default { fontFamily: 'Helvetica', fontSize: 10, padding: 4 }
     */
    defaultCellStyle?: PdfCellStyle;
    /**
     * Default style applied to header and group-header cells.
     * Each unset property inherits from `defaultCellStyle`; values set here
     * take precedence. If neither style sets `fontSize`, headers use 11 points.
     * If no font weight is inherited or set, headers use the bold variant of
     * the resolved body font.
     * @default { fontFamily: 'Helvetica-Bold', fontSize: 11, padding: 4 }
     */
    defaultHeaderStyle?: PdfCellStyle;
    /**
     * Controls exported column widths. Use `auto` to size from exported content, `grid` to use the
     * current column width in the grid, a number for a width in points, or a callback for per-column control.
     * Widths are proportionally reduced when their total exceeds the printable page width.
     * @default 'grid'
     */
    columnWidth?: PdfColumnWidth | PdfColumnWidthCallback;
    /**
     * Horizontal indentation in points for each row-group level.
     * @default 12
     */
    rowGroupIndentSize?: number;
    /**
     * Height of body rows in points. If omitted, calculated from font size and padding.
     * @default calculated from font size and padding
     */
    rowHeight?: number;
    /**
     * Height of header rows in points. If omitted, calculated from header font size and padding.
     * @default calculated from header font size and padding
     */
    headerRowHeight?: number;
    /**
     * Set to `false` to avoid repeating header rows on each page.
     * @default true
     */
    repeatHeader?: boolean;
    /**
     * Set to `false` to skip drawing cell borders.
     * @default true
     */
    drawCellBorders?: boolean;
}
export interface IPdfCreator {
    getDataAsPdf(params?: PdfExportParams): Blob | undefined;
    exportDataAsPdf(params?: PdfExportParams): void;
}
export {};