draw-libre 0.6.0 → 1.0.0

package/dist/index.d.ts

@@ -1,5 +1,568 @@
-import { CircleLayerSpecification, LineLayerSpecification, FillLayerSpecification } from 'maplibre-gl';
-import mapboxgl from 'mapbox-gl';
+/// <reference types="geojson" />
+//#endregion
+//#region src/types.g.d.ts
+type ColorSpecification = string;
+type ProjectionDefinitionT = [string, string, number];
+type ProjectionDefinitionSpecification = string | ProjectionDefinitionT | PropertyValueSpecification<ProjectionDefinitionT>;
+type ResolvedImageSpecification = string;
+type ExpressionInputType = string | number | boolean;
+type VariableExpressionSpecification = ['var', string];
+type CollatorExpressionSpecification = ['collator', {
+  'case-sensitive'?: boolean | ExpressionSpecification;
+  'diacritic-sensitive'?: boolean | ExpressionSpecification;
+  locale?: string | ExpressionSpecification;
+}];
+type InterpolationSpecification = ['linear'] | ['exponential', number] | ['cubic-bezier', number, number, number, number];
+type ExpressionSpecification = ['array', ExpressionSpecification] | ['array', 'string' | 'number' | 'boolean', ExpressionSpecification] | ['array', 'string' | 'number' | 'boolean', number, ExpressionSpecification] | ['boolean', unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | CollatorExpressionSpecification | ['format', ...(string | ['image', ExpressionSpecification] | ExpressionSpecification | {
+  'font-scale'?: number | ExpressionSpecification;
+  'text-font'?: ExpressionSpecification;
+  'text-color'?: ColorSpecification | ExpressionSpecification;
+  'vertical-align'?: 'bottom' | 'center' | 'top';
+})[]] | ['image', string | ExpressionSpecification] | ['literal', unknown] | ['semiliteral', unknown] | ['number', unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ['number-format', number | ExpressionSpecification, {
+  'locale'?: string | ExpressionSpecification;
+  'currency'?: string | ExpressionSpecification;
+  'min-fraction-digits'?: number | ExpressionSpecification;
+  'max-fraction-digits'?: number | ExpressionSpecification;
+}] | ['number-format', number | ExpressionSpecification, {
+  'locale'?: string | ExpressionSpecification;
+  'unit'?: string | ExpressionSpecification;
+  'min-fraction-digits'?: number | ExpressionSpecification;
+  'max-fraction-digits'?: number | ExpressionSpecification;
+}] | ['object', unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ['string', unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ['to-boolean', unknown | ExpressionSpecification] | ['to-color', unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ['to-number', unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ['to-string', unknown | ExpressionSpecification] | ['typeof', unknown | ExpressionSpecification] | ['accumulated'] | ['feature-state', string | ExpressionSpecification] | ['geometry-type'] | ['id'] | ['line-progress'] | ['properties'] | ['at', number | ExpressionSpecification, ExpressionSpecification] | ['get', string | ExpressionSpecification, ExpressionSpecification?] | ['global-state', string] | ['has', string | ExpressionSpecification, ExpressionSpecification?] | ['in', null | ExpressionInputType | ExpressionSpecification, string | ExpressionSpecification] | ['index-of', null | ExpressionInputType | ExpressionSpecification, string | ExpressionSpecification, (number | ExpressionSpecification)?] | ['length', string | ExpressionSpecification] | ['slice', string | ExpressionSpecification, number | ExpressionSpecification, (number | ExpressionSpecification)?] | ['!', boolean | ExpressionSpecification] | ['!=', null | ExpressionInputType | ExpressionSpecification, null | ExpressionInputType | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ['<', string | number | ExpressionSpecification, string | number | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ['<=', string | number | ExpressionSpecification, string | number | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ['==', null | ExpressionInputType | ExpressionSpecification, null | ExpressionInputType | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ['>', string | number | ExpressionSpecification, string | number | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ['>=', string | number | ExpressionSpecification, string | number | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ['all', ...(boolean | ExpressionSpecification)[]] | ['any', ...(boolean | ExpressionSpecification)[]] | ['case', boolean | ExpressionSpecification, null | ExpressionInputType | ExpressionSpecification, ...(boolean | null | ExpressionInputType | ExpressionSpecification)[], null | ExpressionInputType | ExpressionSpecification] | ['coalesce', ...(ExpressionInputType | ExpressionSpecification)[]] | ['match', string | number | ExpressionSpecification, string | number | string[] | number[], null | ExpressionInputType | ExpressionSpecification, ...(string | number | string[] | number[] | null | ExpressionInputType | ExpressionSpecification)[],
+// repeated as above
+null | ExpressionInputType | ExpressionSpecification] | ['within', GeoJSON.GeoJSON] | ['interpolate', InterpolationSpecification, number | ExpressionSpecification, ...(number | ColorSpecification | ExpressionSpecification | ProjectionDefinitionSpecification)[]] | ['interpolate-hcl', InterpolationSpecification, number | ExpressionSpecification, ...(number | ColorSpecification | ExpressionSpecification)[]] | ['interpolate-lab', InterpolationSpecification, number | ExpressionSpecification, ...(number | ColorSpecification | ExpressionSpecification)[]] | ['step', number | ExpressionSpecification, ExpressionInputType | ExpressionSpecification, ...(number | ExpressionInputType | ExpressionSpecification)[]] | ['let', string, ExpressionInputType | ExpressionSpecification, ...(string | ExpressionInputType | ExpressionSpecification)[]] | VariableExpressionSpecification | ['concat', ...(ExpressionInputType | ExpressionSpecification)[]] | ['downcase', string | ExpressionSpecification] | ['is-supported-script', string | ExpressionSpecification] | ['join', string[] | ExpressionSpecification, string | ExpressionSpecification] | ['resolved-locale', CollatorExpressionSpecification] | ['split', string | ExpressionSpecification, string | ExpressionSpecification] | ['upcase', string | ExpressionSpecification] | ['rgb', number | ExpressionSpecification, number | ExpressionSpecification, number | ExpressionSpecification] | ['rgba', number | ExpressionSpecification, number | ExpressionSpecification, number | ExpressionSpecification, number | ExpressionSpecification] | ['to-rgba', ColorSpecification | ExpressionSpecification] | ['-', number | ExpressionSpecification, (number | ExpressionSpecification)?] | ['*', number | ExpressionSpecification, number | ExpressionSpecification, ...(number | ExpressionSpecification)[]] | ['/', number | ExpressionSpecification, number | ExpressionSpecification] | ['%', number | ExpressionSpecification, number | ExpressionSpecification] | ['^', number | ExpressionSpecification, number | ExpressionSpecification] | ['+', ...(number | ExpressionSpecification)[]] | ['abs', number | ExpressionSpecification] | ['acos', number | ExpressionSpecification] | ['asin', number | ExpressionSpecification] | ['atan', number | ExpressionSpecification] | ['ceil', number | ExpressionSpecification] | ['cos', number | ExpressionSpecification] | ['distance', GeoJSON.GeoJSON] | ['e'] | ['floor', number | ExpressionSpecification] | ['ln', number | ExpressionSpecification] | ['ln2'] | ['log10', number | ExpressionSpecification] | ['log2', number | ExpressionSpecification] | ['max', number | ExpressionSpecification, ...(number | ExpressionSpecification)[]] | ['min', number | ExpressionSpecification, ...(number | ExpressionSpecification)[]] | ['pi'] | ['round', number | ExpressionSpecification] | ['sin', number | ExpressionSpecification] | ['sqrt', number | ExpressionSpecification] | ['tan', number | ExpressionSpecification] | ['zoom'] | ['heatmap-density'] | ['elevation'] | ['global-state', string];
+type ExpressionFilterSpecification = boolean | ExpressionSpecification;
+type LegacyFilterSpecification = ['has', string] | ['!has', string] | ['==', string, string | number | boolean] | ['!=', string, string | number | boolean] | ['>', string, string | number | boolean] | ['>=', string, string | number | boolean] | ['<', string, string | number | boolean] | ['<=', string, string | number | boolean] | ['in', string, ...(string | number | boolean)[]] | ['!in', string, ...(string | number | boolean)[]] | ['all', ...LegacyFilterSpecification[]] | ['any', ...LegacyFilterSpecification[]] | ['none', ...LegacyFilterSpecification[]];
+type FilterSpecification = ExpressionFilterSpecification | LegacyFilterSpecification;
+type VisibilitySpecification = 'visible' | 'none' | ExpressionSpecification;
+type TransitionSpecification = {
+  duration?: number;
+  delay?: number;
+};
+type CameraFunctionSpecification<T> = {
+  type: 'exponential';
+  stops: Array<[number, T]>;
+} | {
+  type: 'interval';
+  stops: Array<[number, T]>;
+};
+type SourceFunctionSpecification<T> = {
+  type: 'exponential';
+  stops: Array<[number, T]>;
+  property: string;
+  default?: T;
+} | {
+  type: 'interval';
+  stops: Array<[number, T]>;
+  property: string;
+  default?: T;
+} | {
+  type: 'categorical';
+  stops: Array<[string | number | boolean, T]>;
+  property: string;
+  default?: T;
+} | {
+  type: 'identity';
+  property: string;
+  default?: T;
+};
+type CompositeFunctionSpecification<T> = {
+  type: 'exponential';
+  stops: Array<[{
+    zoom: number;
+    value: number;
+  }, T]>;
+  property: string;
+  default?: T;
+} | {
+  type: 'interval';
+  stops: Array<[{
+    zoom: number;
+    value: number;
+  }, T]>;
+  property: string;
+  default?: T;
+} | {
+  type: 'categorical';
+  stops: Array<[{
+    zoom: number;
+    value: string | number | boolean;
+  }, T]>;
+  property: string;
+  default?: T;
+};
+type PropertyValueSpecification<T> = T | CameraFunctionSpecification<T> | ExpressionSpecification;
+type DataDrivenPropertyValueSpecification<T> = T | CameraFunctionSpecification<T> | SourceFunctionSpecification<T> | CompositeFunctionSpecification<T> | ExpressionSpecification;
+type FillLayerSpecification = {
+  /**
+   * Unique layer name.
+   */
+  "id": string;
+  "type": "fill";
+  /**
+   * Arbitrary properties useful to track with the layer, but do not influence rendering. Properties should be prefixed to avoid collisions, like 'maplibre:'.
+   *
+   * @example
+   * ```json
+   * {"source:comment": "Hydrology FCCODE 460 - Narrow wash"}
+   * ```
+   */
+  "metadata"?: unknown;
+  /**
+   * Name of a source description to be used for this layer. Required for all layer types except `background`.
+   */
+  "source": string;
+  /**
+   * Layer to use from a vector tile source. Required for vector tile sources; prohibited for all other source types, including GeoJSON sources.
+   */
+  "source-layer"?: string;
+  /**
+   * The minimum zoom level for the layer. At zoom levels less than the minzoom, the layer will be hidden.
+   */
+  "minzoom"?: number;
+  /**
+   * The maximum zoom level for the layer. At zoom levels equal to or greater than the maxzoom, the layer will be hidden.
+   */
+  "maxzoom"?: number;
+  /**
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   */
+  "filter"?: FilterSpecification;
+  /**
+   * Layout properties for the layer.
+   */
+  "layout"?: {
+    /**
+     * Sorts features in ascending order based on this value. Features with a higher sort key will appear above features with a lower sort key.
+     */
+    "fill-sort-key"?: DataDrivenPropertyValueSpecification<number>;
+    /**
+     * Whether this layer is displayed.
+     *
+     * @default
+     * ```json
+     * "visible"
+     * ```
+     */
+    "visibility"?: VisibilitySpecification;
+  };
+  /**
+   * Default paint properties for this layer.
+   */
+  "paint"?: {
+    /**
+     * Whether or not the fill should be antialiased.
+     *
+     * @default
+     * ```json
+     * true
+     * ```
+     */
+    "fill-antialias"?: PropertyValueSpecification<boolean>;
+    /**
+     * The opacity of the entire fill layer. In contrast to the `fill-color`, this value will also affect the 1px stroke around the fill, if the stroke is used.
+     *
+     * @default
+     * ```json
+     * 1
+     * ```
+     */
+    "fill-opacity"?: DataDrivenPropertyValueSpecification<number>;
+    "fill-opacity-transition"?: TransitionSpecification;
+    /**
+     * Opacity applied to the layer as a whole. Unlike `fill-opacity` and alpha values in `fill-color`, which are applied per feature and accumulate where fills overlap, `fill-layer-opacity` is applied once so overlapping fills appear as a single surface at the given opacity. When both `fill-opacity` and `fill-layer-opacity` are set, the per-feature, overlap accumulation is preserved, then `fill-layer-opacity` composites the result. This property affects only the layer it is set on and cannot be used to composite multiple layers together or control how this layer blends with layers above or below it.
+     *
+     * ![fill-opacity vs. fill-layer-opacity](assets/fill-layer-opacity.svg)
+     *
+     * @default
+     * ```json
+     * 1
+     * ```
+     */
+    "fill-layer-opacity"?: PropertyValueSpecification<number>;
+    "fill-layer-opacity-transition"?: TransitionSpecification;
+    /**
+     * The color of the filled part of this layer. This color can be specified as `rgba` with an alpha component and the color's opacity will not affect the opacity of the 1px stroke, if it is used. When used with an SDF fill pattern, this serves as the foreground color of the pattern.
+     *
+     * @default
+     * ```json
+     * "#000000"
+     * ```
+     */
+    "fill-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    "fill-color-transition"?: TransitionSpecification;
+    /**
+     * The outline color of the fill. Matches the value of `fill-color` if unspecified.
+     */
+    "fill-outline-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    "fill-outline-color-transition"?: TransitionSpecification;
+    /**
+     * The geometry's offset. Values are `[x, y]` where negatives indicate left and up, respectively.
+     *
+     * @default
+     * ```json
+     * [0, 0]
+     * ```
+     */
+    "fill-translate"?: PropertyValueSpecification<[number, number]>;
+    "fill-translate-transition"?: TransitionSpecification;
+    /**
+     * Controls the frame of reference for `fill-translate`.
+     *
+     * @default
+     * ```json
+     * "map"
+     * ```
+     */
+    "fill-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">;
+    /**
+     * Name of image in sprite to use for drawing image fills. For seamless patterns, image width and height must be a factor of two (2, 4, 8, ..., 512). Note that zoom-dependent expressions will be evaluated only at integer zoom levels.
+     */
+    "fill-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>;
+    "fill-pattern-transition"?: TransitionSpecification;
+  };
+};
+type LineLayerSpecification = {
+  /**
+   * Unique layer name.
+   */
+  "id": string;
+  "type": "line";
+  /**
+   * Arbitrary properties useful to track with the layer, but do not influence rendering. Properties should be prefixed to avoid collisions, like 'maplibre:'.
+   *
+   * @example
+   * ```json
+   * {"source:comment": "Hydrology FCCODE 460 - Narrow wash"}
+   * ```
+   */
+  "metadata"?: unknown;
+  /**
+   * Name of a source description to be used for this layer. Required for all layer types except `background`.
+   */
+  "source": string;
+  /**
+   * Layer to use from a vector tile source. Required for vector tile sources; prohibited for all other source types, including GeoJSON sources.
+   */
+  "source-layer"?: string;
+  /**
+   * The minimum zoom level for the layer. At zoom levels less than the minzoom, the layer will be hidden.
+   */
+  "minzoom"?: number;
+  /**
+   * The maximum zoom level for the layer. At zoom levels equal to or greater than the maxzoom, the layer will be hidden.
+   */
+  "maxzoom"?: number;
+  /**
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   */
+  "filter"?: FilterSpecification;
+  /**
+   * Layout properties for the layer.
+   */
+  "layout"?: {
+    /**
+     * The display of line endings.
+     *
+     * @default
+     * ```json
+     * "butt"
+     * ```
+     */
+    "line-cap"?: DataDrivenPropertyValueSpecification<"butt" | "round" | "square">;
+    /**
+     * The display of lines when joining.
+     *
+     * @default
+     * ```json
+     * "miter"
+     * ```
+     */
+    "line-join"?: DataDrivenPropertyValueSpecification<"bevel" | "round" | "miter">;
+    /**
+     * Used to automatically convert miter joins to bevel joins for sharp angles.
+     *
+     * @default
+     * ```json
+     * 2
+     * ```
+     */
+    "line-miter-limit"?: DataDrivenPropertyValueSpecification<number>;
+    /**
+     * Used to automatically convert round joins to miter joins for shallow angles.
+     *
+     * @default
+     * ```json
+     * 1.05
+     * ```
+     */
+    "line-round-limit"?: DataDrivenPropertyValueSpecification<number>;
+    /**
+     * Sorts features in ascending order based on this value. Features with a higher sort key will appear above features with a lower sort key.
+     */
+    "line-sort-key"?: DataDrivenPropertyValueSpecification<number>;
+    /**
+     * Whether this layer is displayed.
+     *
+     * @default
+     * ```json
+     * "visible"
+     * ```
+     */
+    "visibility"?: VisibilitySpecification;
+  };
+  /**
+   * Default paint properties for this layer.
+   */
+  "paint"?: {
+    /**
+     * The opacity at which the line will be drawn.
+     *
+     * @default
+     * ```json
+     * 1
+     * ```
+     */
+    "line-opacity"?: DataDrivenPropertyValueSpecification<number>;
+    "line-opacity-transition"?: TransitionSpecification;
+    /**
+     * Opacity applied to the layer as a whole. Unlike `line-opacity` and alpha values in `line-color`, which are applied per feature and accumulate where lines overlap, `line-layer-opacity` is applied once so overlapping lines appear as a single surface at the given opacity. When both `line-opacity` and `line-layer-opacity` are set, the per-feature, overlap accumulation is preserved, then layer-opacity composites the result. This property affects only the layer it is set on and cannot be used to composite multiple layers together or control how this layer blends with layers above or below it.
+     *
+     * ![line-opacity vs. line-layer-opacity](assets/line-layer-opacity.svg)
+     *
+     * @default
+     * ```json
+     * 1
+     * ```
+     */
+    "line-layer-opacity"?: PropertyValueSpecification<number>;
+    "line-layer-opacity-transition"?: TransitionSpecification;
+    /**
+     * The color with which the line will be drawn.
+     *
+     * @default
+     * ```json
+     * "#000000"
+     * ```
+     */
+    "line-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    "line-color-transition"?: TransitionSpecification;
+    /**
+     * The geometry's offset. Values are `[x, y]` where negatives indicate left and up, respectively.
+     *
+     * @default
+     * ```json
+     * [0, 0]
+     * ```
+     */
+    "line-translate"?: PropertyValueSpecification<[number, number]>;
+    "line-translate-transition"?: TransitionSpecification;
+    /**
+     * Controls the frame of reference for `line-translate`.
+     *
+     * @default
+     * ```json
+     * "map"
+     * ```
+     */
+    "line-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">;
+    /**
+     * Stroke thickness.
+     *
+     * @default
+     * ```json
+     * 1
+     * ```
+     */
+    "line-width"?: DataDrivenPropertyValueSpecification<number>;
+    "line-width-transition"?: TransitionSpecification;
+    /**
+     * Draws a line casing outside of a line's actual path. Value indicates the width of the inner gap.
+     */
+    "line-gap-width"?: DataDrivenPropertyValueSpecification<number>;
+    "line-gap-width-transition"?: TransitionSpecification;
+    /**
+     * The line's offset. For linear features, a positive value offsets the line to the right, relative to the direction of the line, and a negative value to the left. For polygon features, a positive value results in an inset, and a negative value results in an outset.
+     */
+    "line-offset"?: DataDrivenPropertyValueSpecification<number>;
+    "line-offset-transition"?: TransitionSpecification;
+    /**
+     * Blur applied to the line, in pixels.
+     */
+    "line-blur"?: DataDrivenPropertyValueSpecification<number>;
+    "line-blur-transition"?: TransitionSpecification;
+    /**
+     * Specifies the lengths of the alternating dashes and gaps that form the dash pattern. The lengths are later scaled by the line width. To convert a dash length to pixels, multiply the length by the current line width. GeoJSON sources with `lineMetrics: true` specified won't render dashed lines to the expected scale. Zoom-dependent expressions will be evaluated only at integer zoom levels. The only way to create an array value is using `["literal", [...]]`; arrays cannot be read from or derived from feature properties.
+     */
+    "line-dasharray"?: DataDrivenPropertyValueSpecification<Array<number>>;
+    "line-dasharray-transition"?: TransitionSpecification;
+    /**
+     * Name of image in sprite to use for drawing image lines. For seamless patterns, image width must be a factor of two (2, 4, 8, ..., 512). Note that zoom-dependent expressions will be evaluated only at integer zoom levels.
+     */
+    "line-pattern"?: DataDrivenPropertyValueSpecification<ResolvedImageSpecification>;
+    "line-pattern-transition"?: TransitionSpecification;
+    /**
+     * Defines a gradient with which to color a line feature. Can only be used with GeoJSON sources that specify `"lineMetrics": true`.
+     */
+    "line-gradient"?: ExpressionSpecification;
+  };
+};
+type CircleLayerSpecification = {
+  /**
+   * Unique layer name.
+   */
+  "id": string;
+  "type": "circle";
+  /**
+   * Arbitrary properties useful to track with the layer, but do not influence rendering. Properties should be prefixed to avoid collisions, like 'maplibre:'.
+   *
+   * @example
+   * ```json
+   * {"source:comment": "Hydrology FCCODE 460 - Narrow wash"}
+   * ```
+   */
+  "metadata"?: unknown;
+  /**
+   * Name of a source description to be used for this layer. Required for all layer types except `background`.
+   */
+  "source": string;
+  /**
+   * Layer to use from a vector tile source. Required for vector tile sources; prohibited for all other source types, including GeoJSON sources.
+   */
+  "source-layer"?: string;
+  /**
+   * The minimum zoom level for the layer. At zoom levels less than the minzoom, the layer will be hidden.
+   */
+  "minzoom"?: number;
+  /**
+   * The maximum zoom level for the layer. At zoom levels equal to or greater than the maxzoom, the layer will be hidden.
+   */
+  "maxzoom"?: number;
+  /**
+   * A expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The `feature-state` expression is not supported in filter expressions.
+   */
+  "filter"?: FilterSpecification;
+  /**
+   * Layout properties for the layer.
+   */
+  "layout"?: {
+    /**
+     * Sorts features in ascending order based on this value. Features with a higher sort key will appear above features with a lower sort key.
+     */
+    "circle-sort-key"?: DataDrivenPropertyValueSpecification<number>;
+    /**
+     * Whether this layer is displayed.
+     *
+     * @default
+     * ```json
+     * "visible"
+     * ```
+     */
+    "visibility"?: VisibilitySpecification;
+  };
+  /**
+   * Default paint properties for this layer.
+   */
+  "paint"?: {
+    /**
+     * Circle radius.
+     *
+     * @default
+     * ```json
+     * 5
+     * ```
+     */
+    "circle-radius"?: DataDrivenPropertyValueSpecification<number>;
+    "circle-radius-transition"?: TransitionSpecification;
+    /**
+     * The fill color of the circle.
+     *
+     * @default
+     * ```json
+     * "#000000"
+     * ```
+     */
+    "circle-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    "circle-color-transition"?: TransitionSpecification;
+    /**
+     * Amount to blur the circle. 1 blurs the circle such that only the centerpoint is full opacity.
+     */
+    "circle-blur"?: DataDrivenPropertyValueSpecification<number>;
+    "circle-blur-transition"?: TransitionSpecification;
+    /**
+     * The opacity at which the circle will be drawn.
+     *
+     * @default
+     * ```json
+     * 1
+     * ```
+     */
+    "circle-opacity"?: DataDrivenPropertyValueSpecification<number>;
+    "circle-opacity-transition"?: TransitionSpecification;
+    /**
+     * The geometry's offset. Values are `[x, y]` where negatives indicate left and up, respectively.
+     *
+     * @default
+     * ```json
+     * [0, 0]
+     * ```
+     */
+    "circle-translate"?: PropertyValueSpecification<[number, number]>;
+    "circle-translate-transition"?: TransitionSpecification;
+    /**
+     * Controls the frame of reference for `circle-translate`.
+     *
+     * @default
+     * ```json
+     * "map"
+     * ```
+     */
+    "circle-translate-anchor"?: PropertyValueSpecification<"map" | "viewport">;
+    /**
+     * Controls the scaling behavior of the circle when the map is pitched.
+     *
+     * @default
+     * ```json
+     * "map"
+     * ```
+     */
+    "circle-pitch-scale"?: PropertyValueSpecification<"map" | "viewport">;
+    /**
+     * Orientation of circle when map is pitched.
+     *
+     * @default
+     * ```json
+     * "viewport"
+     * ```
+     */
+    "circle-pitch-alignment"?: PropertyValueSpecification<"map" | "viewport">;
+    /**
+     * The width of the circle's stroke. Strokes are placed outside of the `circle-radius`.
+     */
+    "circle-stroke-width"?: DataDrivenPropertyValueSpecification<number>;
+    "circle-stroke-width-transition"?: TransitionSpecification;
+    /**
+     * The stroke color of the circle.
+     *
+     * @default
+     * ```json
+     * "#000000"
+     * ```
+     */
+    "circle-stroke-color"?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    "circle-stroke-color-transition"?: TransitionSpecification;
+    /**
+     * The opacity of the circle's stroke.
+     *
+     * @default
+     * ```json
+     * 1
+     * ```
+     */
+    "circle-stroke-opacity"?: DataDrivenPropertyValueSpecification<number>;
+    "circle-stroke-opacity-transition"?: TransitionSpecification;
+  };
+};
 
 type AnyFunction = (...args: any) => any;
 type DeepRequired<T> = T extends AnyFunction ? T : {
@@ -44,12 +607,26 @@ type Initial = InitialSteps & {
     geometry: "line" | "polygon";
     closeGeometry: boolean;
 };
+type Paint<T extends {
+    paint?: unknown;
+}> = NonNullable<T["paint"]> | Record<string, any>;
 interface LayersPaint {
+    onLinePoint?: Paint<CircleLayerSpecification>;
+    firstPoint?: Paint<CircleLayerSpecification>;
+    points?: Paint<CircleLayerSpecification>;
+    auxiliaryPoint?: Paint<CircleLayerSpecification>;
+    line?: Paint<LineLayerSpecification>;
+    dynamicLine?: Paint<LineLayerSpecification>;
+    polygon?: Paint<FillLayerSpecification>;
+    breakLine?: Paint<LineLayerSpecification>;
+}
+interface StrictLayersPaint {
     onLinePoint?: CircleLayerSpecification["paint"];
     firstPoint?: CircleLayerSpecification["paint"];
     points?: CircleLayerSpecification["paint"];
     auxiliaryPoint?: CircleLayerSpecification["paint"];
     line?: LineLayerSpecification["paint"];
+    dynamicLine?: LineLayerSpecification["paint"];
     polygon?: FillLayerSpecification["paint"];
     breakLine?: LineLayerSpecification["paint"];
 }
@@ -63,6 +640,7 @@ interface Locale {
     break?: string;
     closeLine?: string;
     createPolygon?: string;
+    removePoint?: string;
 }
 interface DrawOptions {
     pointGeneration?: "manual" | "auto";
@@ -89,7 +667,11 @@ interface DrawOptions {
     dynamicLine?: boolean;
 }
 type RequiredDrawOptions = DeepRequired<Omit<DrawOptions, "layersPaint">> & {
-    layersPaint: LayersPaint;
+    layersPaint: StrictLayersPaint;
+    interaction: {
+        lineHitRadius: number;
+        pointHitRadius: number;
+    };
 };
 
 declare class ListNode {
@@ -99,94 +681,117 @@ declare class ListNode {
     constructor(val?: Step | null, next?: ListNode | null, prev?: ListNode | null);
 }
 
-type UnifiedMap = maplibregl.Map & mapboxgl.Map;
-type IControl = maplibregl.IControl & mapboxgl.IControl;
+interface MapLike {
+    getContainer(): HTMLElement;
+    getCanvasContainer(): HTMLElement;
+}
+interface DrawLibreControl {
+    onAdd(map: MapLike): HTMLElement;
+    onRemove(map: MapLike): void;
+}
+type UnifiedMap = MapLike;
 
 interface ModeEvent {
     geometry: Mode;
     closedGeometry: boolean;
 }
-interface UndoEvent {
+interface StepEvent {
+    id: StepId;
     coordinates: LatLng;
-    originalEvent: MouseEvent;
-    id: Uuid;
     total: number;
     timestamp: number;
-    target: UnifiedMap;
+    target: MapLike;
+}
+interface HistoryEvent {
+    originalEvent?: Event;
+    id?: StepId;
+    coordinates?: LatLng;
+    total: number;
+    timestamp: number;
+    target: MapLike;
+}
+interface UndoEvent extends HistoryEvent {
     type: "mdl:undo";
 }
+interface RedoEvent extends HistoryEvent {
+    type: "mdl:redo";
+}
 interface RemoveAllEvent {
-    originalEvent: MouseEvent;
+    originalEvent?: Event;
     type: "mdl:removeall";
-    target: UnifiedMap;
+    target: MapLike;
 }
 interface SaveEvent {
-    originalEvent: MouseEvent;
+    originalEvent?: Event;
     timestamp: number;
     steps: Step[];
     mode: ModeEvent;
-    target: UnifiedMap;
+    target: MapLike;
     type: "mdl:save";
 }
-interface PointRightClickRemoveEvent {
-    id: Uuid;
-    total: number;
-    timestamp: number;
-    target: UnifiedMap;
-    coordinates: LatLng;
-    type: "mdl:rightclickremove";
+interface PointRemoveEvent extends StepEvent {
+    type: "mdl:pointremove";
 }
-interface PointAddEvent {
-    id: Uuid;
-    total: number;
-    timestamp: number;
-    target: UnifiedMap;
-    coordinates: LatLng;
+interface PointAddEvent extends StepEvent {
     mode: ModeEvent;
     type: "mdl:add";
 }
 interface PointMoveEvent {
     start_coordinates: LatLng;
     end_coordinates: LatLng;
-    id: Uuid;
+    id: StepId;
     total: number;
     timestamp: number;
-    target: UnifiedMap;
+    target: MapLike;
     type: "mdl:moveend";
 }
-interface PointEnterEvent {
-    coordinates: LatLng;
-    id: Uuid;
-    total: number;
-    timestamp: number;
-    target: UnifiedMap;
+interface PointEnterEvent extends StepEvent {
     type: "mdl:pointenter";
 }
-interface PointLeaveEvent {
-    coordinates: LatLng;
-    id: Uuid;
-    total: number;
-    timestamp: number;
-    target: UnifiedMap;
+interface PointLeaveEvent extends StepEvent {
     type: "mdl:pointleave";
 }
 interface ModeChangeEvent {
     mode: Mode | "break";
-    target: UnifiedMap;
+    target: MapLike;
     type: "mdl:modechanged";
 }
 interface UndoStackChangeEvent {
-    mode: Mode | "break";
-    target: UnifiedMap;
+    length: number;
+    target: MapLike;
     type: "mdl:undostackchanged";
 }
 interface RedoStackChangeEvent {
-    mode: Mode | "break";
-    target: UnifiedMap;
+    length: number;
+    target: MapLike;
     type: "mdl:redostackchanged";
 }
+interface BreakEvent {
+    target: MapLike;
+    type: "mdl:break";
+}
+type DrawLibreEventType = {
+    "mdl:add": PointAddEvent;
+    "mdl:pointremove": PointRemoveEvent;
+    "mdl:pointenter": PointEnterEvent;
+    "mdl:pointleave": PointLeaveEvent;
+    "mdl:moveend": PointMoveEvent;
+    "mdl:undo": UndoEvent;
+    "mdl:redo": RedoEvent;
+    "mdl:removeall": RemoveAllEvent;
+    "mdl:save": SaveEvent;
+    "mdl:break": BreakEvent;
+    "mdl:modechanged": ModeChangeEvent;
+    "mdl:undostackchanged": UndoStackChangeEvent;
+    "mdl:redostackchanged": RedoStackChangeEvent;
+};
+
+interface DrawLibreSubscription {
+    unsubscribe(): void;
+}
 
-declare class DrawLibre implements IControl {
+declare class DrawLibre implements DrawLibreControl {
+    #private;
     private container;
     private store;
     private mode;
@@ -197,16 +802,16 @@ declare class DrawLibre implements IControl {
     private cursor;
     private mouseEvents;
     private timelineAdapter;
+    private projection;
+    private readonly events;
     private renderer;
-    static instance: DrawLibre | null;
-    private constructor();
-    static getInstance(options?: DrawOptions): DrawLibre;
+    constructor(options?: DrawOptions);
     /**
      * DO NOT USE IMPLICITLY. PASS TO map.addControl().
      *
      * @example ```ts
      * const map = new Map();
-     * const draw = DrawLibre.getInstance();
+     * const draw = new DrawLibre();
      * map.addControl(draw)
      * ```
      *
@@ -218,13 +823,13 @@ declare class DrawLibre implements IControl {
      * to the DOM: the map will insert the control's element into the DOM
      * as necessary.
      */
-    onAdd: (map: UnifiedMap) => HTMLElement;
+    onAdd: (map: MapLike) => HTMLElement;
     /**
      * DO NOT USE IMPLICITLY. PASS TO map.removeControl().
      *
      * @example ```ts
      * const map = new Map();
-     * const draw = DrawLibre.getInstance();
+     * const draw = new DrawLibre();
      * map.removeControl(draw)
      * ```
      *
@@ -234,7 +839,7 @@ declare class DrawLibre implements IControl {
      */
     onRemove: () => void;
     /**
-     * Adds a series of steps to the store. If a step ID is not provided, it will be automatically generated.
+     * Replaces all steps in the store. If a step ID is not provided, it will be automatically generated.
      *
      * @param step - The step to add to the store, which can be of type Step or LatLng.
      */
@@ -245,14 +850,14 @@ declare class DrawLibre implements IControl {
      * @param id - The ID of the step to retrieve.
      * @returns The step with the specified ID, or null if not found.
      */
-    findStepById: (id: StepId) => Step | null | undefined;
+    findStepById: (id: StepId) => Step | null;
     /**
      * Retrieves a node from the store by its ID.
      *
      * @param id - The ID of the node to retrieve.
      * @returns The node with the specified ID, or null if not found.
      */
-    findNodeById: (id: StepId) => ListNode | null | undefined;
+    findNodeById: (id: StepId) => ListNode | null;
     /**
      * Retrieves all steps from the store, either as an array or as a linked list, based on the type specified.
      *
@@ -260,16 +865,18 @@ declare class DrawLibre implements IControl {
      * @returns An array of all steps or the linked list of steps.
      */
     getAllSteps: (type?: "array" | "linkedlist") => Step[] | {
-        head: ListNode | null | undefined;
-        tail: ListNode | null | undefined;
-        size: number | undefined;
+        head: ListNode | null;
+        tail: ListNode | null;
+        size: number;
     };
-    setOptions: (fn: (options: RequiredDrawOptions) => RequiredDrawOptions) => void;
-    undo: (e: Event) => void;
-    redo: (e: Event) => void;
-    clear: () => void;
-    save: () => void;
-    removeAllSteps: () => void;
+    undo: (e?: Event) => void;
+    redo: (e?: Event) => void;
+    clear: (e?: Event) => void;
+    save: (e?: Event) => void;
+    removeAllSteps: (e?: Event) => void;
+    on: <T extends keyof DrawLibreEventType>(type: T, listener: (event: DrawLibreEventType[T]) => void) => DrawLibreSubscription;
+    once: <T extends keyof DrawLibreEventType>(type: T, listener: (event: DrawLibreEventType[T]) => void) => DrawLibreSubscription;
+    off: <T extends keyof DrawLibreEventType>(type: T, listener: (event: DrawLibreEventType[T]) => void) => void;
 }
 
-export { type DrawOptions, type ModeChangeEvent, type PointAddEvent, type PointEnterEvent, type PointLeaveEvent, type PointMoveEvent, type PointRightClickRemoveEvent, type RedoStackChangeEvent, type RemoveAllEvent, type RequiredDrawOptions, type SaveEvent, type UndoEvent, type UndoStackChangeEvent, type UnifiedMap, DrawLibre as default };
+export { type BreakEvent, type DrawLibreControl, type DrawLibreEventType, type DrawLibreSubscription, type DrawOptions, type LatLng, type MapLike, type ModeChangeEvent, type PointAddEvent, type PointEnterEvent, type PointLeaveEvent, type PointMoveEvent, type PointRemoveEvent, type RedoEvent, type RedoStackChangeEvent, type RemoveAllEvent, type RequiredDrawOptions, type SaveEvent, type Step, type StepId, type UndoEvent, type UndoStackChangeEvent, type UnifiedMap, DrawLibre as default };