/**
 * Map line module
 */
/**
 * ============================================================================
 * IMPORTS
 * ============================================================================
 * @hidden
 */
import { MapObject, IMapObjectProperties, IMapObjectAdapters, IMapObjectEvents } from "./MapObject";
import { MapLineObject } from "./MapLineObject";
import { MapLineSeriesDataItem, MapLineSeries } from "./MapLineSeries";
import { MapImage } from "./MapImage";
import { IOrientationPoint } from "../../core/defs/IPoint";
import { IGeoPoint } from "../../core/defs/IGeoPoint";
import { ListTemplate, IListEvents } from "../../core/utils/List";
import { Polyline } from "../../core/elements/Polyline";
import { IDisposer } from "../../core/utils/Disposer";
/**
 * ============================================================================
 * REQUISITES
 * ============================================================================
 * @hidden
 */
/**
 * Defines properties for [[MapLine]].
 */
export interface IMapLineProperties extends IMapObjectProperties {
    /**
     * Lat/long coordinates of all line ends and intermediate elbows.
     */
    multiGeoLine?: Array<Array<IGeoPoint>>;
    /**
     * Lat/long coordinates of all line ends and intermediate elbows.
     */
    multiLine?: Array<Array<[number, number]>>;
    /**
     * If `true` it line will be arched in the way to simulate shortest path
     * over curvature of Earth's surface, based on currently used on projection.
     */
    shortestDistance?: boolean;
    /**
     * Instead of setting longitudes/latitudes you can set an array of images which will be connected by the line
     */
    imagesToConnect?: MapImage[];
    /**
     * When line is plotted, if its `shortestDistance` is set to `true` it is
     * bent according to the used projection, to depict the shortest distance how
     * it would go on the actual land.
     *
     * `precision` introduces a setting which can control when such bending
     * occurs.
     *
     * If the distance (in degrees) between line start and end points
     * is less than `precision`, no bending will take place and the line will be
     * straight.
     *
     * Set to large number (e.g. 10000) for perfectly straight line.
     *
     * @since 4.9.1
     * @default 0.1
     */
    precision?: number;
}
/**
 * Defines events for [[MapLine]].
 */
export interface IMapLineEvents extends IMapObjectEvents {
}
/**
 * Defines adapters for [[MapLine]].
 *
 * @see {@link Adapter}
 */
export interface IMapLineAdapters extends IMapObjectAdapters, IMapLineProperties {
}
/**
 * ============================================================================
 * MAIN CLASS
 * ============================================================================
 * @hidden
 */
/**
 * Used to draw a line on the map.
 *
 * @see {@link IMapLineEvents} for a list of available events
 * @see {@link IMapLineAdapters} for a list of available Adapters
 */
export declare class MapLine extends MapObject {
    /**
     * Defines available properties.
     */
    _properties: IMapLineProperties;
    /**
     * Defines available adapters.
     */
    _adapter: IMapLineAdapters;
    /**
     * Defines available events.
     */
    _events: IMapLineEvents;
    /**
     * A line visual element.
     */
    line: Polyline;
    /**
     * A list of actual line objects.
     */
    protected _lineObjects: ListTemplate<MapLineObject>;
    /**
     * A reference to arrow object.
     */
    protected _arrow: MapLineObject;
    /**
     * Related data item.
     */
    _dataItem: MapLineSeriesDataItem;
    /**
     * A map series this object belongs to.
     */
    series: MapLineSeries;
    /**
     * Instead of setting longitudes/latitudes you can set an array of images
     * which will be connected by the line.
     */
    protected _imagesToConnect: MapImage[];
    /**
     * A list of event disposers for images.
     */
    protected _imageListeners: {
        [index: string]: IDisposer;
    };
    /**
     * Constructor
     */
    constructor();
    /**
     * @ignore
     */
    protected createLine(): void;
    /**
     * Converts a position within the line (0-1) to a physical point
     * coordinates.
     *
     * 0 indicates start of the line, 0.5 - middle, while 1 indicates the end.
     *
     * @param position  Position (0-1)
     * @return Coordinates
     */
    positionToPoint(position: number): IOrientationPoint;
    /**
     * A collection of X/Y coordinates for a multi-segment line. E.g.:
     *
     * ```JSON
     * [
     *   // Segment 1
     *   [
     *     { longitude: 3.121, latitude: 0.58 },
     *     { longitude: -5.199, latitude: 21.223 }
     *   ],
     *
     *   // Segment 2
     *   [
     *     { longitude: -5.199, latitude: 21.223 },
     *     { longitude: -12.9, latitude: 25.85 }
     *   ]
     * ]
     * ```
     *
     * @see {@link https://tools.ietf.org/html/rfc7946#section-3.1.5} GeoJSON MultiLineString reference
     * @param multiGeoLine  Coordinates
     */
    /**
    * @return Coordinates
    */
    multiGeoLine: Array<Array<IGeoPoint>>;
    /**
     * A collection of X/Y coordinates for a multi-segment line. E.g.:
     *
     * ```JSON
     * [
     *   // Segment 1
     *   [
     *     [ 100, 150 ],
     *     [ 120, 200 ]
     *   ],
     *
     *   // Segment 2
     *   [
     *     [ 120, 200 ],
     *     [ 150, 100 ]
     *   ]
     * ]
     * ```
     *
     * @param multiLine  Coordinates
     */
    /**
    * @return Coordinates
    */
    multiLine: Array<Array<[number, number]>>;
    /**
     * Instead of setting longitudes/latitudes you can set an array of images
     * which will be connected by the line.
     *
     * Parameter is an array that can hold string `id`'s to of the images, or
     * references to actual [[MapImage]] objects.
     *
     * @param images  Images
     */
    /**
    * @return {MapImages[]}
    */
    imagesToConnect: MapImage[] | string[];
    protected handleImagesToConnect(): void;
    /**
     * (Re)validates the line, effectively forcing it to redraw.
     *
     * @ignore Exclude from docs
     */
    validate(): void;
    /**
     * @ignore
     */
    getFeature(): {
        "type": "Feature";
        geometry: {
            type: "MultiLineString";
            coordinates: Array<Array<[number, number]>>;
        };
    };
    /**
     * @ignore Exclude from docs
     */
    measureElement(): void;
    /**
     * The line should take the shortest path over the globe.
     *
     * Enabling this will make the line look differently in different
     * projections. Only `MapLine` supports this setting, `MapArc` and
     * `MapSplice` don't.
     *
     * @default true
     * @param value  Real path?
     */
    /**
    * @return Real path?
    */
    shortestDistance: boolean;
    /**
     * List of separate line objects the line consists of.
     *
     * @readonly
     * @return List of line objects
     */
    readonly lineObjects: ListTemplate<MapLineObject>;
    /**
     * Decorate a [[LineObject]] when it is added to the line.
     *
     * @param event  Event
     */
    protected handleLineObjectAdded(event: IListEvents<MapLineObject>["inserted"]): void;
    /**
     * A [[MapLineObject]] to use as an option arrowhead on the line.
     *
     * Just accessing this property will create a default arrowhead on the line
     * automatically.
     *
     * @param arrow  Arrow element
     */
    /**
    * @return Arrow element
    */
    arrow: MapLineObject;
    /**
     * Copies line properties and other attributes, like arrow, from another
     * instance of [[MapLine]].
     *
     * @param source  Source map line
     */
    copyFrom(source: this): void;
    /**
     * Latitude of the line center.
     *
     * @readonly
     * @return Latitude
     */
    readonly latitude: number;
    /**
     * Longitude of the line center.
     *
     * @readonly
     * @return Latitude
     */
    readonly longitude: number;
    /**
     * X coordinate for the slice tooltip.
     *
     * @ignore
     * @return X
     */
    getTooltipX(): number;
    /**
     * Y coordinate for the slice tooltip.
     *
     * @ignore
     * @return Y
     */
    getTooltipY(): number;
    /**
     * When line is plotted, if its `shortestDistance` is set to `true` it is
     * bent according to the used projection, to depict the shortest distance how
     * it would go on the actual land.
     *
     * `precision` introduces a setting which can control when such bending
     * occurs.
     *
     * If the distance (in degrees) between line start and end points
     * is less than `precision`, no bending will take place and the line will be
     * straight.
     *
     * Set to large number (e.g. 10000) for perfectly straight line.
     *
     * @since 4.9.1
     * @default 0.1
     * @param  value  Precision
     */
    /**
    * @return Precision
    */
    precision: number;
}