import type { ExportingMenu } from "./ExportingMenu";
import type { TimeUnit } from "../../core/util/Time";
import { Entity, IEntitySettings, IEntityPrivate, IEntityEvents } from "../../core/util/Entity";
import { Color } from "../../core/util/Color";
import { Root } from "../../core/Root";
export interface IFile {
    path: string;
    bytes: string;
}
export interface IFont {
    name: string;
    normal: IFile;
    bold?: IFile;
    italics?: IFile;
    bolditalics?: IFile;
}
export declare type ExportingTypes = "image" | "data" | "print";
export declare type ExportingFormats = "png" | "jpg" | "svg" | "canvas" | "pdf" | "xlsx" | "csv" | "json" | "html" | "pdfdata" | "print";
export declare type ExportingImageFormats = "png" | "jpg";
export interface IExportingImageSource {
    /**
     * Root element of the extra chart to add to the export.
     */
    source: Root;
    /**
     * Top margin in pixels.
     */
    marginTop?: number;
    /**
     * Right margin in pixels.
     */
    marginRight?: number;
    /**
     * Bottom margin in pixels.
     */
    marginBottom?: number;
    /**
     * Left margin in pixels.
     */
    marginLeft?: number;
    /**
     * Side of the main chart to place the extra chart on.
     *
     * @default "bottom"
     */
    position?: "left" | "right" | "top" | "bottom";
    /**
     * Keeps the export at the main chart's width (or height, for `"left"` and
     * `"right"`), cutting off an extra chart that is larger.
     */
    crop?: boolean;
}
export interface IExportingSettings extends IEntitySettings {
    /**
     * The [[ExportingMenu]] that offers the formats to the user.
     */
    menu?: ExportingMenu;
    /**
     * Background color of exported images. If not set, it is taken from the
     * CSS background of the chart's element, or the nearest parent that has
     * one; white if none does.
     */
    backgroundColor?: Color;
    /**
     * Opacity of the exported image's background: `0` (transparent) to `1`
     * (opaque). JPEG has no transparency.
     *
     * @default 1
     * @since 5.2.34
     */
    backgroundOpacity?: number;
    /**
     * Name of downloaded files, before the extension.
     *
     * @default "chart"
     */
    filePrefix?: string;
    /**
     * Title of the export: the heading of a PDF, the page title when printing
     * and the sheet name in XLSX.
     */
    title?: string;
    /**
     * Charset of exported files.
     *
     * @default "utf-8"
     */
    charset?: string;
    /**
     * Fields to include in data exports, and their column names: keys are
     * fields in the data, values the column names.
     */
    dataFields?: {
        [index: string]: string;
    };
    /**
     * Order of the fields in data exports.
     */
    dataFieldsOrder?: string[];
    /**
     * Fields whose numbers are formatted with `numberFormat`.
     */
    numericFields?: string[];
    /**
     * Number format for the values in `numericFields`. If not set, they are
     * exported as they are.
     */
    numberFormat?: string | Intl.NumberFormatOptions;
    /**
     * Fields whose numbers are timestamps, exported as dates.
     */
    dateFields?: string[];
    /**
     * Date format for dates in data exports. If not set, the root's
     * [[DateFormatter]] format is used.
     */
    dateFormat?: string | Intl.DateTimeFormatOptions;
    /**
     * Fields whose numbers are durations, formatted with `durationFormat`.
     *
     * @since 5.0.16
     */
    durationFields?: string[];
    /**
     * Format for the values in `durationFields`. If not set, the root's
     * [[DurationFormatter]] format is used.
     *
     * @since 5.0.16
     */
    durationFormat?: string;
    /**
     * Time unit the values in `durationFields` are in. If not set, the root's
     * [[DurationFormatter]] `baseUnit` is used.
     *
     * @since 5.0.16
     */
    durationUnit?: TimeUnit;
    /**
     * Other charts to add around the main chart in image exports.
     */
    extraImages?: Array<Root | IExportingImageSource>;
    /**
     * Data for data exports: an array of objects. Without it, the data formats
     * are not offered.
     *
     * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/#Exporting_data} for more info
     */
    dataSource?: any;
    /**
     * PNG format options.
     */
    pngOptions?: IExportingImageOptions;
    /**
     * JPEG format options.
     */
    jpgOptions?: IExportingImageOptions;
    /**
     * SVG format options.
     *
     * @since 5.21.0
     */
    svgOptions?: IExportingSVGOptions;
    /**
     * Options for `exportCanvas()`.
     */
    canvasOptions?: IExportingImageOptions;
    /**
     * PDF format options.
     */
    pdfOptions?: IExportingPDFOptions;
    /**
     * Options for the PDF with a data table.
     */
    pdfdataOptions?: IExportingDataOptions;
    /**
     * XLSX format options.
     */
    xlsxOptions?: IExportingXLSXOptions;
    /**
     * CSV format options.
     */
    csvOptions?: IExportingCSVOptions;
    /**
     * JSON format options.
     */
    jsonOptions?: IExportingJSONOptions;
    /**
     * HTML format options.
     */
    htmlOptions?: IExportingHTMLOptions;
    /**
     * Print options.
     */
    printOptions?: IExportingPrintOptions;
}
export interface IExportingPrivate extends IEntityPrivate {
}
export interface IExportEvent {
    /**
     * Format of the export.
     */
    format: ExportingFormats;
    /**
     * Options of the format.
     */
    options: IExportingFormatOptions;
}
export interface IExportingEvents extends IEntityEvents {
    /**
     * An export started.
     */
    exportstarted: IExportEvent;
    /**
     * An export was set off. It is dispatched before the result is ready, so
     * to use the result, wait for the promise `export()` returns.
     */
    exportfinished: IExportEvent;
    /**
     * A download was requested, before its file is generated.
     */
    downloadstarted: IExportEvent & {
        fileName: string;
    };
    /**
     * Printing was requested, before the image to print is generated.
     */
    printstarted: IExportEvent;
    /**
     * The data for a data export is prepared. A listener can still change
     * `data`.
     */
    dataprocessed: IExportEvent & {
        data: any;
    };
    /**
     * The XLSX workbook is prepared. A listener can still change it before it
     * is written.
     */
    workbookready: IExportEvent & {
        workbook: any;
        workbookOptions: any;
        xlsx: any;
    };
    /**
     * The PDF document definition is prepared. A listener can still change it
     * before the PDF is made.
     */
    pdfdocready: IExportEvent & {
        doc: any;
    };
}
export interface IExportingFormatOptions {
    /**
     * Leaves this format out of the [[ExportingMenu]].
     */
    disabled?: boolean;
}
export interface IExportingImageOptions extends IExportingFormatOptions {
    /**
     * Quality of the image, `0` to `1`: `1` by default, `0.8` for JPG. Only
     * JPEG images use it.
     */
    quality?: number;
    /**
     * Exports the image at the chart's size in CSS pixels. When `false`, it is
     * exported at the screen's resolution: larger on high-density screens.
     *
     * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/exporting-images/#Pixel_ratio} for more info
     * @default false
     */
    maintainPixelRatio?: boolean;
    /**
     * Minimal width of exported image, in pixels.
     *
     * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/exporting-images/#Sizing_exported_image} for more info
     */
    minWidth?: number;
    /**
     * Maximal width of exported image, in pixels.
     *
     * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/exporting-images/#Sizing_exported_image} for more info
     */
    maxWidth?: number;
    /**
     * Minimal height of exported image, in pixels.
     *
     * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/exporting-images/#Sizing_exported_image} for more info
     */
    minHeight?: number;
    /**
     * Maximal height of exported image, in pixels.
     *
     * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/exporting-images/#Sizing_exported_image} for more info
     */
    maxHeight?: number;
}
export interface IExportingSVGOptions extends IExportingFormatOptions {
    /**
     * Number of decimal places in coordinates.
     *
     * @default 3
     */
    precision?: number;
}
export interface IExportingPrintOptions extends IExportingImageOptions {
    /**
     * With `"iframe"` printing, how long in milliseconds to wait before
     * opening the print dialog, so the image is ready. With `"css"`, how long
     * the page stays hidden for printing.
     *
     * @default 500
     */
    delay?: number;
    /**
     * How to print. If one doesn't work in your setup, try the other.
     *
     * * `"iframe"`: prints the image from a hidden `<iframe>`.
     * * `"css"`: hides the rest of the page with CSS while it prints.
     *
     * @default "iframe"
     */
    printMethod?: "css" | "iframe";
    /**
     * Image format to print.
     *
     * @default "png"
     */
    imageFormat?: "png" | "jpg";
}
/**
 * Available PDF page sizes.
 */
export declare type pageSizes = "4A0" | "2A0" | "A0" | "A1" | "A2" | "A3" | "A4" | "A5" | "A6" | "A7" | "A8" | "A9" | "A10" | "B0" | "B1" | "B2" | "B3" | "B4" | "B5" | "B6" | "B7" | "B8" | "B9" | "B10" | "C0" | "C1" | "C2" | "C3" | "C4" | "C5" | "C6" | "C7" | "C8" | "C9" | "C10" | "RA0" | "RA1" | "RA2" | "RA3" | "RA4" | "SRA0" | "SRA1" | "SRA2" | "SRA3" | "SRA4" | "EXECUTIVE" | "FOLIO" | "LEGAL" | "LETTER" | "TABLOID";
export interface IExportingPDFOptions extends IExportingImageOptions {
    /**
     * Adds a table of the `dataSource` data below the chart image.
     */
    includeData?: boolean;
    /**
     * Format of the chart image in the PDF.
     *
     * @default "png"
     */
    imageFormat?: "png" | "jpg";
    /**
     * Font size of the title, the page URL and the data table.
     *
     * @default 14
     */
    fontSize?: number;
    /**
     * Horizontal alignment of the chart image on the page: `"left"`,
     * `"center"` or `"right"`.
     *
     * @default "left"
     */
    align?: "left" | "center" | "middle";
    /**
     * Adds the URL of the page the chart was exported from.
     *
     * @default true
     */
    addURL?: boolean;
    /**
     * Page size.
     *
     * @default "A4"
     */
    pageSize?: pageSizes;
    /**
     * Page orientation.
     *
     * @default "portrait"
     */
    pageOrientation?: "landscape" | "portrait";
    /**
     * Page margins in points (1/72 inch): one number for all four edges,
     * `[horizontal, vertical]`, or `[left, top, right, bottom]`.
     *
     * @default 30
     */
    pageMargins?: number | number[];
    /**
     * Font of the PDF's text. The default font has only Latin and Cyrillic
     * characters, so text in other scripts needs a font that has them.
     *
     * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/exporting-pdf/#Fonts} for more info
     */
    font?: IFont;
    /**
     * More fonts to register, for use by individual elements of the document,
     * e.g. from a `pdfdocready` listener. Used only together with `font`.
     *
     * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/exporting-pdf/#Fonts} for more info
     */
    extraFonts?: Array<IFont>;
}
export interface IExportingDataOptions extends IExportingFormatOptions {
    /**
     * Text for empty values: `"-"` in HTML by default, an empty string in the
     * other formats.
     */
    emptyAs?: string;
    /**
     * Exports dates as timestamps instead of formatted dates.
     *
     * @default false
     */
    useTimestamps?: boolean;
    /**
     * Formats dates in the browser's locale instead of with `dateFormat`.
     *
     * @default false
     */
    useLocale?: boolean;
    /**
     * Swaps rows and columns, so that each field is a row.
     */
    pivot?: boolean;
    /**
     * Adds the column names as the first row (or column, with `pivot`) in CSV,
     * HTML, XLSX and PDF tables.
     *
     * @default true
     */
    addColumnNames?: boolean;
}
export interface IExportingJSONOptions extends IExportingDataOptions {
    /**
     * Indentation of the JSON: a number of spaces, or a string to indent with.
     *
     * @default 2
     */
    indent?: string | number;
    /**
     * Uses the column names from `dataFields` as keys, instead of the field
     * names. Has no effect without `dataFields`.
     *
     * @default true
     */
    renameFields?: boolean;
}
export interface IExportingCSVOptions extends IExportingDataOptions {
    /**
     * Column separator.
     *
     * @default ","
     */
    separator?: string;
    /**
     * Quotes all values, numbers too.
     *
     * @default false
     */
    forceQuotes?: boolean;
    /**
     * Exports the rows in reverse order.
     *
     * @default false
     */
    reverse?: boolean;
    /**
     * Starts the file with a byte order mark, so that Excel reads its UTF-8
     * characters correctly.
     *
     * @default true
     * @since 5.1.0
     */
    addBOM?: boolean;
    /**
     * Protects against spreadsheet formula injection ("CSV injection"): text
     * values that start with `=`, `+`, `-`, `@`, a tab or a carriage return
     * get a single quote in front, so they are read as plain text.
     *
     * @default true
     * @since 5.19.0
     */
    escapeFormulas?: boolean;
}
export interface IExportingHTMLOptions extends IExportingDataOptions {
    /**
     * `class` attribute of the `<table>` tag.
     */
    tableClass?: string;
    /**
     * `class` attribute of the `<tr>` tags.
     */
    rowClass?: string;
    /**
     * `class` attribute of the `<th>` tags.
     */
    headerClass?: string;
    /**
     * `class` attribute of the `<td>` tags.
     */
    cellClass?: string;
}
export interface IExportingXLSXOptions extends IExportingDataOptions {
    /**
     * Protects against spreadsheet formula injection: text values that start
     * with `=`, `+`, `-`, `@`, a tab or a carriage return get a single quote in
     * front, so they are read as plain text.
     *
     * @default true
     * @since 5.19.0
     */
    escapeFormulas?: boolean;
}
/**
 * A plugin that exports the chart as an image, PDF or print, and its data as
 * JSON, CSV, XLSX, HTML or a PDF table.
 *
 * @see {@link https://www.amcharts.com/docs/v5/concepts/exporting/} for more info
 */
export declare class Exporting extends Entity {
    static className: string;
    static classNames: Array<string>;
    _settings: IExportingSettings;
    _privateSettings: IExportingPrivate;
    _events: IExportingEvents;
    protected _afterNew(): void;
    _beforeChanged(): void;
    protected _getFormatOptions(format: ExportingFormats, options?: IExportingFormatOptions): IExportingFormatOptions;
    /**
     * Exports the chart or its data in a format and downloads the file, named
     * `filePrefix` plus the format's extension.
     *
     * @param  format         Format
     * @param  customOptions  Format options, over the format's own options setting
     */
    download(format: ExportingFormats, customOptions?: IExportingFormatOptions): Promise<void>;
    /**
     * Prints the chart.
     *
     * @param  customOptions  Print options, over `printOptions`
     */
    print(customOptions?: IExportingPrintOptions): Promise<void>;
    /**
     * Exports the chart or its data in a format, as a data URI.
     *
     * @param          format  Format
     * @param   customOptions  Format options, over the format's own options setting
     * @return                 Promise of the data URI
     */
    export(format: ExportingFormats, customOptions?: IExportingFormatOptions): Promise<string>;
    /**
     * ==========================================================================
     * Images
     * ==========================================================================
     */
    /**
     * Returns the chart image as a data URI.
     *
     * @param   format         Image format
     * @param   customOptions  Format options
     * @return                 Promise
     */
    exportImage(format: ExportingImageFormats, customOptions?: IExportingImageOptions): Promise<string>;
    /**
     * Returns the chart image as a PNG data URI, using `canvasOptions`.
     *
     * @param   customOptions  Image options
     * @return                 Promise
     */
    exportCanvas(customOptions?: IExportingImageOptions): Promise<string>;
    /**
     * Returns the chart image as an SVG data URI, whichever renderer the chart
     * uses.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     * @since 5.21.0
     */
    exportSVG(customOptions?: IExportingSVGOptions): Promise<string>;
    /**
     * Returns the chart image as SVG markup, with `extraImages` placed around
     * it.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     * @since 5.21.0
     */
    getSVG(customOptions?: IExportingSVGOptions): Promise<string>;
    /**
     * Returns a `<canvas>` element with an image of the chart and its
     * `extraImages`.
     *
     * @param   options  Image options
     * @return           Promise
     */
    getCanvas(options: IExportingImageOptions): Promise<HTMLCanvasElement>;
    /**
     * ==========================================================================
     * JSON
     * ==========================================================================
     */
    /**
     * Returns the data as a JSON file in a data URI.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     */
    exportJSON(customOptions?: IExportingJSONOptions): Promise<string>;
    /**
     * Returns the data as a JSON string.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     */
    getJSON(customOptions?: IExportingJSONOptions): Promise<string>;
    /**
     * ==========================================================================
     * CSV
     * ==========================================================================
     */
    /**
     * Returns the data as a CSV file in a data URI.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     */
    exportCSV(customOptions?: IExportingCSVOptions): Promise<string>;
    /**
     * Returns the data as CSV text.
     *
     * @param   customOptions  CSV options
     * @return                 Promise
     */
    getCSV(customOptions?: IExportingCSVOptions): Promise<string>;
    /**
     * @ignore
     */
    getCSVRow(row: any, options: IExportingCSVOptions, dataFields: any, asIs?: boolean): string;
    /**
     * ==========================================================================
     * HTML
     * ==========================================================================
     */
    /**
     * Returns the data as an HTML table in a data URI.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     */
    exportHTML(customOptions?: IExportingHTMLOptions): Promise<string>;
    /**
     * Returns the data as the markup of an HTML `<table>`.
     *
     * @param   customOptions  HTML options
     * @return                 Promise
     */
    getHTML(customOptions?: IExportingHTMLOptions): Promise<string>;
    /**
     * @ignore
     */
    getHTMLRow(row: any, options: IExportingHTMLOptions, dataFields: any, asIs?: boolean, headerRow?: boolean): string;
    /**
     * ==========================================================================
     * XLSX
     * ==========================================================================
     */
    /**
     * Returns the data as an XLSX file in a data URI.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     */
    exportXLSX(customOptions?: IExportingXLSXOptions): Promise<string>;
    /**
     * Returns the data as an XLSX file, Base64-encoded.
     *
     * @param  customOptions  Format options
     * @return                Promise
     */
    getXLSX(customOptions?: IExportingXLSXOptions): Promise<string>;
    private _normalizeExcelSheetName;
    /**
     * @ignore
     */
    getXLSXRow(row: any, options: IExportingXLSXOptions, dataFields: any, asIs?: boolean): any[];
    /**
     * @ignore
     */
    private _xlsx;
    /**
     * @ignore
     */
    getXLSXLib(): Promise<any>;
    /**
     * ==========================================================================
     * PDF
     * ==========================================================================
     */
    /**
     * Returns a PDF of the chart image, with a data table if `includeData` is
     * set, as a data URI.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     */
    exportPDF(customOptions?: IExportingPDFOptions): Promise<string>;
    /**
     * Returns a PDF of the data as a table, without the chart image, as a data
     * URI.
     *
     * @param   customOptions  Format options
     * @return                 Promise
     */
    exportPDFData(customOptions?: IExportingDataOptions): Promise<string>;
    /**
     * Returns a PDF file, Base64-encoded.
     *
     * @param   customOptions  PDF options
     * @param   includeImage   Include the chart image
     * @param   includeData    Include the data table (also added with `includeData` in the options)
     * @return                 Promise
     */
    getPDF(customOptions?: IExportingPDFOptions, includeImage?: boolean, includeData?: boolean): Promise<string>;
    /**
     * @ignore
     */
    getPDFData(customOptions?: IExportingDataOptions): Promise<any>;
    /**
     * @ignore
     */
    getPDFDataRow(row: any, options: IExportingDataOptions, dataFields?: any, asIs?: boolean): Array<string>;
    /**
     * Returns pdfmake instance.
     *
     * @ignore
     * @return Instance of pdfmake
     */
    getPdfmake(): Promise<any>;
    /**
     * @ignore
     */
    getPageSizeFit(pageSize: pageSizes, margins: number | number[], extraMargin?: number, orientation?: "landscape" | "portrait"): number[];
    /**
     * ==========================================================================
     * Data
     * ==========================================================================
     */
    /**
        * Checks whether `dataSource` is a non-empty array.
        *
        * @return Has data?
        */
    hasData(): boolean;
    /**
     * Returns the data prepared for export: only the `dataFields`, if set,
     * with values formatted per the format's options.
     *
     * @param   format         Format
     * @param   customOptions  Format options
     * @param   renameFields   Use the column names from `dataFields` as keys
     * @return                 Processed data
     */
    getData(format: ExportingFormats, customOptions?: IExportingDataOptions, renameFields?: boolean): any;
    /**
     * @ignore
     */
    getDataFields(data: any): {
        [index: string]: string;
    };
    /**
     * @ignore
     */
    convertEmptyValue(_field: string, value: any, options: IExportingDataOptions): any;
    /**
     * @ignore
     */
    convertToSpecialFormat(field: any, value: any, options: IExportingDataOptions, keepOriginal?: boolean): any;
    /**
     * If `value` is a string that begins with a character a spreadsheet
     * application could treat as the start of a formula, prefixes it with a
     * single quote so it is imported as plain text. This mitigates spreadsheet
     * formula injection ("CSV injection") attacks via untrusted cell data.
     *
     * Non-string values (numbers, dates) are returned unchanged, so legitimate
     * signed numbers are not affected.
     *
     * @ignore
     */
    escapeFormulas(value: any): any;
    /**
     * @ignore
     */
    isDateField(field: string): boolean;
    /**
     * @ignore
     */
    isNumericField(field: string): boolean;
    /**
     * @ignore
     */
    isDurationField(field: string): boolean;
    /**
     * @ignore
     */
    getContentType(type: ExportingFormats): string;
    protected getDisposableCanvas(): HTMLCanvasElement;
    protected disposeCanvas(canvas: HTMLCanvasElement): void;
    /**
     * @ignore
     */
    findBackgroundColor(element: Element): Color;
    /**
     * Downloads a data URI as a file.
     *
     * @param   uri       Data URI with the file's content
     * @param   fileName  File name
     * @param   addBOM    Start the file with a byte order mark
     * @return            `false` if the content could not be decoded
     */
    streamFile(uri: string, fileName: string, addBOM?: boolean): boolean;
    /**
     * @ignore
     */
    downloadSupport(): boolean;
    /**
     * @ignore
     */
    linkDownloadSupport(): boolean;
    /**
     * @ignore
     */
    blobDownloadSupport(): boolean;
    /**
     * ==========================================================================
     * Print
     * ==========================================================================
     */
    /**
     * Prints an image, given as a data URI.
     *
     * @param   data           Data URI of the image
     * @param   customOptions  Print options, over `printOptions`
     * @param   title          Title for the printed page; the page's own title if not given
     */
    initiatePrint(data: string, customOptions?: IExportingPrintOptions, title?: string): void;
    protected _printViaCSS(data: string, customOptions?: IExportingPrintOptions, title?: string): void;
    protected _printViaIframe(data: string, customOptions?: IExportingPrintOptions, title?: string): void;
    /**
     * Returns the formats that can be exported: all that are not `disabled`,
     * but the data formats only when there is data and the browser can
     * download files.
     *
     * @return Formats
     */
    supportedFormats(): ExportingFormats[];
    /**
     * Returns the export types available: `"image"` and `"print"`, and
     * `"data"` when there is data and the browser can download files.
     *
     * @return Supported types
     */
    supportedExportTypes(): ExportingTypes[];
}
//# sourceMappingURL=Exporting.d.ts.map