maplibre-gl 3.1.0 → 3.2.0-pre.2

package/src/geo/edge_insets.ts

@@ -7,15 +7,24 @@ import {clamp} from '../util/util';
  * This shifts the apprent center or the vanishing point of the map. This is useful for adding floating UI elements
  * on top of the map and having the vanishing point shift as UI elements resize.
  *
- * @param {number} [top=0]
- * @param {number} [bottom=0]
- * @param {number} [left=0]
- * @param {number} [right=0]
+ * @group Geography and Geometry
  */
-class EdgeInsets {
+export class EdgeInsets {
+    /**
+     * @defaultValue 0
+     */
     top: number;
+    /**
+     * @defaultValue 0
+     */
     bottom: number;
+    /**
+     * @defaultValue 0
+     */
     left: number;
+    /**
+     * @defaultValue 0
+     */
     right: number;
 
     constructor(top: number = 0, bottom: number = 0, left: number = 0, right: number = 0) {
@@ -36,11 +45,10 @@ class EdgeInsets {
     /**
      * Interpolates the inset in-place.
      * This maintains the current inset value for any inset not present in `target`.
-     * @param {PaddingOptions | EdgeInsets} start interpolation start
-     * @param {PaddingOptions} target interpolation target
-     * @param {number} t interpolation step/weight
-     * @returns {EdgeInsets} the insets
-     * @memberof EdgeInsets
+     * @param start - interpolation start
+     * @param target - interpolation target
+     * @param t - interpolation step/weight
+     * @returns the insets
      */
     interpolate(start: PaddingOptions | EdgeInsets, target: PaddingOptions, t: number): EdgeInsets {
         if (target.top != null && start.top != null) this.top = interpolates.number(start.top, target.top, t);
@@ -55,10 +63,9 @@ class EdgeInsets {
      * Utility method that computes the new apprent center or vanishing point after applying insets.
      * This is in pixels and with the top left being (0.0) and +y being downwards.
      *
-     * @param {number} width the width
-     * @param {number} height the height
-     * @returns {Point} the point
-     * @memberof EdgeInsets
+     * @param width - the width
+     * @param height - the height
+     * @returns the point
      */
     getCenter(width: number, height: number): Point {
         // Clamp insets so they never overflow width/height and always calculate a valid center
@@ -83,8 +90,7 @@ class EdgeInsets {
      * Returns the current state as json, useful when you want to have a
      * read-only representation of the inset.
      *
-     * @returns {PaddingOptions} state as json
-     * @memberof EdgeInsets
+     * @returns state as json
      */
     toJSON(): PaddingOptions {
         return {
@@ -100,37 +106,41 @@ class EdgeInsets {
  * Options for setting padding on calls to methods such as {@link Map#fitBounds}, {@link Map#fitScreenCoordinates}, and {@link Map#setPadding}. Adjust these options to set the amount of padding in pixels added to the edges of the canvas. Set a uniform padding on all edges or individual values for each edge. All properties of this object must be
  * non-negative integers.
  *
+ * @group Geography and Geometry
+ *
  * @example
- * var bbox = [[-79, 43], [-73, 45]];
+ * ```ts
+ * let bbox = [[-79, 43], [-73, 45]];
  * map.fitBounds(bbox, {
  *   padding: {top: 10, bottom:25, left: 15, right: 5}
  * });
+ * ```
  *
  * @example
- * var bbox = [[-79, 43], [-73, 45]];
+ * ```ts
+ * let bbox = [[-79, 43], [-73, 45]];
  * map.fitBounds(bbox, {
  *   padding: 20
  * });
- * @see [Fit to the bounds of a LineString](https://maplibre.org/maplibre-gl-js-docs/example/zoomto-linestring/)
- * @see [Fit a map to a bounding box](https://maplibre.org/maplibre-gl-js-docs/example/fitbounds/)
+ * ```
+ * @see [Fit to the bounds of a LineString](https://maplibre.org/maplibre-gl-js/docs/examples/zoomto-linestring/)
+ * @see [Fit a map to a bounding box](https://maplibre.org/maplibre-gl-js/docs/examples/fitbounds/)
  */
 export type PaddingOptions = {
     /**
-     * @property {number} top Padding in pixels from the top of the map canvas.
+     * Padding in pixels from the top of the map canvas.
      */
     top: number;
     /**
-     * @property {number} bottom Padding in pixels from the bottom of the map canvas.
+     * Padding in pixels from the bottom of the map canvas.
      */
     bottom: number;
     /**
-     * @property {number} left Padding in pixels from the left of the map canvas.
+     * Padding in pixels from the left of the map canvas.
      */
     right: number;
     /**
-     * @property {number} right Padding in pixels from the right of the map canvas.
+     * Padding in pixels from the right of the map canvas.
      */
     left: number;
 };
-
-export default EdgeInsets;

package/src/geo/lng_lat.test.ts

@@ -1,4 +1,4 @@
-import LngLat from '../geo/lng_lat';
+import {LngLat} from '../geo/lng_lat';
 
 describe('LngLat', () => {
     test('#constructor', () => {

package/src/geo/lng_lat.ts

@@ -7,6 +7,27 @@ import {wrap} from '../util/util';
 */
 export const earthRadius = 6371008.8;
 
+/**
+ * A {@link LngLat} object, an array of two numbers representing longitude and latitude,
+ * or an object with `lng` and `lat` or `lon` and `lat` properties.
+ *
+ * @group Geography and Geometry
+ *
+ * @example
+ * ```ts
+ * let v1 = new maplibregl.LngLat(-122.420679, 37.772537);
+ * let v2 = [-122.420679, 37.772537];
+ * let v3 = {lon: -122.420679, lat: 37.772537};
+ * ```
+ */
+export type LngLatLike = LngLat | {
+    lng: number;
+    lat: number;
+} | {
+    lon: number;
+    lat: number;
+} | [number, number];
+
 /**
  * A `LngLat` object represents a given longitude and latitude coordinate, measured in degrees.
  * These coordinates are based on the [WGS84 (EPSG:4326) standard](https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84).
@@ -18,19 +39,25 @@ export const earthRadius = 6371008.8;
  * can also accept an `Array` of two numbers and will perform an implicit conversion.
  * This flexible type is documented as {@link LngLatLike}.
  *
- * @param {number} lng Longitude, measured in degrees.
- * @param {number} lat Latitude, measured in degrees.
+ * @group Geography and Geometry
+ *
  * @example
- * var ll = new maplibregl.LngLat(-123.9749, 40.7736);
+ * ```ts
+ * let ll = new maplibregl.LngLat(-123.9749, 40.7736);
  * ll.lng; // = -123.9749
- * @see [Get coordinates of the mouse pointer](https://maplibre.org/maplibre-gl-js-docs/example/mouse-position/)
- * @see [Display a popup](https://maplibre.org/maplibre-gl-js-docs/example/popup/)
- * @see [Create a timeline animation](https://maplibre.org/maplibre-gl-js-docs/example/timeline-animation/)
+ * ```
+ * @see [Get coordinates of the mouse pointer](https://maplibre.org/maplibre-gl-js/docs/examples/mouse-position/)
+ * @see [Display a popup](https://maplibre.org/maplibre-gl-js/docs/examples/popup/)
+ * @see [Create a timeline animation](https://maplibre.org/maplibre-gl-js/docs/examples/timeline-animation/)
  */
-class LngLat {
+export class LngLat {
     lng: number;
     lat: number;
 
+    /**
+     * @param lng - Longitude, measured in degrees.
+     * @param lat - Latitude, measured in degrees.
+     */
     constructor(lng: number, lat: number) {
         if (isNaN(lng) || isNaN(lat)) {
             throw new Error(`Invalid LngLat object: (${lng}, ${lat})`);
@@ -45,11 +72,13 @@ class LngLat {
     /**
      * Returns a new `LngLat` object whose longitude is wrapped to the range (-180, 180).
      *
-     * @returns {LngLat} The wrapped `LngLat` object.
+     * @returns The wrapped `LngLat` object.
      * @example
-     * var ll = new maplibregl.LngLat(286.0251, 40.7736);
-     * var wrapped = ll.wrap();
+     * ```ts
+     * let ll = new maplibregl.LngLat(286.0251, 40.7736);
+     * let wrapped = ll.wrap();
      * wrapped.lng; // = -73.9749
+     * ```
      */
     wrap() {
         return new LngLat(wrap(this.lng, -180, 180), this.lat);
@@ -58,10 +87,12 @@ class LngLat {
     /**
      * Returns the coordinates represented as an array of two numbers.
      *
-     * @returns {[number,number]} The coordinates represented as an array of longitude and latitude.
+     * @returns The coordinates represented as an array of longitude and latitude.
      * @example
-     * var ll = new maplibregl.LngLat(-73.9749, 40.7736);
+     * ```ts
+     * let ll = new maplibregl.LngLat(-73.9749, 40.7736);
      * ll.toArray(); // = [-73.9749, 40.7736]
+     * ```
      */
     toArray(): [number, number] {
         return [this.lng, this.lat];
@@ -70,12 +101,14 @@ class LngLat {
     /**
      * Returns the coordinates represent as a string.
      *
-     * @returns {string} The coordinates represented as a string of the format `'LngLat(lng, lat)'`.
+     * @returns The coordinates represented as a string of the format `'LngLat(lng, lat)'`.
      * @example
-     * var ll = new maplibregl.LngLat(-73.9749, 40.7736);
+     * ```ts
+     * let ll = new maplibregl.LngLat(-73.9749, 40.7736);
      * ll.toString(); // = "LngLat(-73.9749, 40.7736)"
+     * ```
      */
-    toString() {
+    toString(): string {
         return `LngLat(${this.lng}, ${this.lat})`;
     }
 
@@ -83,14 +116,16 @@ class LngLat {
      * Returns the approximate distance between a pair of coordinates in meters
      * Uses the Haversine Formula (from R.W. Sinnott, "Virtues of the Haversine", Sky and Telescope, vol. 68, no. 2, 1984, p. 159)
      *
-     * @param {LngLat} lngLat coordinates to compute the distance to
-     * @returns {number} Distance in meters between the two coordinates.
+     * @param lngLat - coordinates to compute the distance to
+     * @returns Distance in meters between the two coordinates.
      * @example
-     * var new_york = new maplibregl.LngLat(-74.0060, 40.7128);
-     * var los_angeles = new maplibregl.LngLat(-118.2437, 34.0522);
+     * ```ts
+     * let new_york = new maplibregl.LngLat(-74.0060, 40.7128);
+     * let los_angeles = new maplibregl.LngLat(-118.2437, 34.0522);
      * new_york.distanceTo(los_angeles); // = 3935751.690893987, "true distance" using a non-spherical approximation is ~3966km
+     * ```
      */
-    distanceTo(lngLat: LngLat) {
+    distanceTo(lngLat: LngLat): number {
         const rad = Math.PI / 180;
         const lat1 = this.lat * rad;
         const lat2 = lngLat.lat * rad;
@@ -106,12 +141,14 @@ class LngLat {
      *
      * If a `LngLat` object is passed in, the function returns it unchanged.
      *
-     * @param {LngLatLike} input An array of two numbers or object to convert, or a `LngLat` object to return.
-     * @returns {LngLat} A new `LngLat` object, if a conversion occurred, or the original `LngLat` object.
+     * @param input - An array of two numbers or object to convert, or a `LngLat` object to return.
+     * @returns A new `LngLat` object, if a conversion occurred, or the original `LngLat` object.
      * @example
-     * var arr = [-73.9749, 40.7736];
-     * var ll = maplibregl.LngLat.convert(arr);
+     * ```ts
+     * let arr = [-73.9749, 40.7736];
+     * let ll = maplibregl.LngLat.convert(arr);
      * ll;   // = LngLat {lng: -73.9749, lat: 40.7736}
+     * ```
      */
     static convert(input: LngLatLike): LngLat {
         if (input instanceof LngLat) {
@@ -130,23 +167,3 @@ class LngLat {
         throw new Error('`LngLatLike` argument must be specified as a LngLat instance, an object {lng: <lng>, lat: <lat>}, an object {lon: <lng>, lat: <lat>}, or an array of [<lng>, <lat>]');
     }
 }
-
-/**
- * A {@link LngLat} object, an array of two numbers representing longitude and latitude,
- * or an object with `lng` and `lat` or `lon` and `lat` properties.
- *
- * @typedef {LngLat | {lng: number, lat: number} | {lon: number, lat: number} | [number, number]} LngLatLike
- * @example
- * var v1 = new maplibregl.LngLat(-122.420679, 37.772537);
- * var v2 = [-122.420679, 37.772537];
- * var v3 = {lon: -122.420679, lat: 37.772537};
- */
-export type LngLatLike = LngLat | {
-    lng: number;
-    lat: number;
-} | {
-    lon: number;
-    lat: number;
-} | [number, number];
-
-export default LngLat;

package/src/geo/lng_lat_bounds.test.ts

@@ -1,5 +1,5 @@
-import LngLat from './lng_lat';
-import LngLatBounds from './lng_lat_bounds';
+import {LngLat} from './lng_lat';
+import {LngLatBounds} from './lng_lat_bounds';
 
 describe('LngLatBounds', () => {
     test('#constructor', () => {

package/src/geo/lng_lat_bounds.ts

@@ -1,6 +1,24 @@
-import LngLat from './lng_lat';
+import {LngLat} from './lng_lat';
 import type {LngLatLike} from './lng_lat';
 
+/**
+ * A {@link LngLatBounds} object, an array of {@link LngLatLike} objects in [sw, ne] order,
+ * or an array of numbers in [west, south, east, north] order.
+ *
+ * @group Geography and Geometry
+ *
+ * @example
+ * ```ts
+ * let v1 = new maplibregl.LngLatBounds(
+ *   new maplibregl.LngLat(-73.9876, 40.7661),
+ *   new maplibregl.LngLat(-73.9397, 40.8002)
+ * );
+ * let v2 = new maplibregl.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002])
+ * let v3 = [[-73.9876, 40.7661], [-73.9397, 40.8002]];
+ * ```
+ */
+export type LngLatBoundsLike = LngLatBounds | [LngLatLike, LngLatLike] | [number, number, number, number];
+
 /**
  * A `LngLatBounds` object represents a geographical bounding box,
  * defined by its southwest and northeast points in longitude and latitude.
@@ -11,30 +29,38 @@ import type {LngLatLike} from './lng_lat';
  * can also accept an `Array` of two {@link LngLatLike} constructs and will perform an implicit conversion.
  * This flexible type is documented as {@link LngLatBoundsLike}.
  *
- * @param {LngLatLike} [sw] The southwest corner of the bounding box.
- * @param {LngLatLike} [ne] The northeast corner of the bounding box.
+ * @group Geography and Geometry
+ *
  * @example
- * var sw = new maplibregl.LngLat(-73.9876, 40.7661);
- * var ne = new maplibregl.LngLat(-73.9397, 40.8002);
- * var llb = new maplibregl.LngLatBounds(sw, ne);
+ * ```ts
+ * let sw = new maplibregl.LngLat(-73.9876, 40.7661);
+ * let ne = new maplibregl.LngLat(-73.9397, 40.8002);
+ * let llb = new maplibregl.LngLatBounds(sw, ne);
+ * ```
  */
-class LngLatBounds {
+export class LngLatBounds {
     _ne: LngLat;
     _sw: LngLat;
 
     /**
-     * @param {LngLatLike} [sw] The southwest corner of the bounding box.
+     * @param sw - The southwest corner of the bounding box.
      * OR array of 4 numbers in the order of  west, south, east, north
      * OR array of 2 LngLatLike: [sw,ne]
-     * @param {LngLatLike} [ne] The northeast corner of the bounding box.
+     * @param ne - The northeast corner of the bounding box.
      * @example
-     * var sw = new maplibregl.LngLat(-73.9876, 40.7661);
-     * var ne = new maplibregl.LngLat(-73.9397, 40.8002);
-     * var llb = new maplibregl.LngLatBounds(sw, ne);
+     * ```ts
+     * let sw = new maplibregl.LngLat(-73.9876, 40.7661);
+     * let ne = new maplibregl.LngLat(-73.9397, 40.8002);
+     * let llb = new maplibregl.LngLatBounds(sw, ne);
+     * ```
      * OR
-     * var llb = new maplibregl.LngLatBounds([-73.9876, 40.7661, -73.9397, 40.8002]);
+     * ```ts
+     * let llb = new maplibregl.LngLatBounds([-73.9876, 40.7661, -73.9397, 40.8002]);
+     * ```
      * OR
-     * var llb = new maplibregl.LngLatBounds([sw, ne]);
+     * ```ts
+     * let llb = new maplibregl.LngLatBounds([sw, ne]);
+     * ```
      */
     constructor(sw?: LngLatLike | [number, number, number, number] | [LngLatLike, LngLatLike], ne?: LngLatLike) {
         if (!sw) {
@@ -54,10 +80,10 @@ class LngLatBounds {
     /**
      * Set the northeast corner of the bounding box
      *
-     * @param {LngLatLike} ne a {@link LngLatLike} object describing the northeast corner of the bounding box.
-     * @returns {LngLatBounds} `this`
+     * @param ne - a {@link LngLatLike} object describing the northeast corner of the bounding box.
+     * @returns `this`
      */
-    setNorthEast(ne: LngLatLike) {
+    setNorthEast(ne: LngLatLike): this {
         this._ne = ne instanceof LngLat ? new LngLat(ne.lng, ne.lat) : LngLat.convert(ne);
         return this;
     }
@@ -65,10 +91,10 @@ class LngLatBounds {
     /**
      * Set the southwest corner of the bounding box
      *
-     * @param {LngLatLike} sw a {@link LngLatLike} object describing the southwest corner of the bounding box.
-     * @returns {LngLatBounds} `this`
+     * @param sw - a {@link LngLatLike} object describing the southwest corner of the bounding box.
+     * @returns `this`
      */
-    setSouthWest(sw: LngLatLike) {
+    setSouthWest(sw: LngLatLike): this {
         this._sw = sw instanceof LngLat ? new LngLat(sw.lng, sw.lat) : LngLat.convert(sw);
         return this;
     }
@@ -76,10 +102,10 @@ class LngLatBounds {
     /**
      * Extend the bounds to include a given LngLatLike or LngLatBoundsLike.
      *
-     * @param {LngLatLike|LngLatBoundsLike} obj object to extend to
-     * @returns {LngLatBounds} `this`
+     * @param obj - object to extend to
+     * @returns `this`
      */
-    extend(obj: LngLatLike | LngLatBoundsLike) {
+    extend(obj: LngLatLike | LngLatBoundsLike): this {
         const sw = this._sw,
             ne = this._ne;
         let sw2, ne2;
@@ -128,10 +154,12 @@ class LngLatBounds {
     /**
      * Returns the geographical coordinate equidistant from the bounding box's corners.
      *
-     * @returns {LngLat} The bounding box's center.
+     * @returns The bounding box's center.
      * @example
-     * var llb = new maplibregl.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
+     * ```ts
+     * let llb = new maplibregl.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
      * llb.getCenter(); // = LngLat {lng: -73.96365, lat: 40.78315}
+     * ```
      */
     getCenter(): LngLat {
         return new LngLat((this._sw.lng + this._ne.lng) / 2, (this._sw.lat + this._ne.lat) / 2);
@@ -140,67 +168,69 @@ class LngLatBounds {
     /**
      * Returns the southwest corner of the bounding box.
      *
-     * @returns {LngLat} The southwest corner of the bounding box.
+     * @returns The southwest corner of the bounding box.
      */
     getSouthWest(): LngLat { return this._sw; }
 
     /**
      * Returns the northeast corner of the bounding box.
      *
-     * @returns {LngLat} The northeast corner of the bounding box.
+     * @returns The northeast corner of the bounding box.
      */
     getNorthEast(): LngLat { return this._ne; }
 
     /**
      * Returns the northwest corner of the bounding box.
      *
-     * @returns {LngLat} The northwest corner of the bounding box.
+     * @returns The northwest corner of the bounding box.
      */
     getNorthWest(): LngLat { return new LngLat(this.getWest(), this.getNorth()); }
 
     /**
      * Returns the southeast corner of the bounding box.
      *
-     * @returns {LngLat} The southeast corner of the bounding box.
+     * @returns The southeast corner of the bounding box.
      */
     getSouthEast(): LngLat { return new LngLat(this.getEast(), this.getSouth()); }
 
     /**
      * Returns the west edge of the bounding box.
      *
-     * @returns {number} The west edge of the bounding box.
+     * @returns The west edge of the bounding box.
      */
     getWest(): number { return this._sw.lng; }
 
     /**
      * Returns the south edge of the bounding box.
      *
-     * @returns {number} The south edge of the bounding box.
+     * @returns The south edge of the bounding box.
      */
     getSouth(): number { return this._sw.lat; }
 
     /**
      * Returns the east edge of the bounding box.
      *
-     * @returns {number} The east edge of the bounding box.
+     * @returns The east edge of the bounding box.
      */
     getEast(): number { return this._ne.lng; }
 
     /**
      * Returns the north edge of the bounding box.
      *
-     * @returns {number} The north edge of the bounding box.
+     * @returns The north edge of the bounding box.
      */
     getNorth(): number { return this._ne.lat; }
 
     /**
      * Returns the bounding box represented as an array.
      *
-     * @returns {Array<Array<number>>} The bounding box represented as an array, consisting of the
+     * @returns The bounding box represented as an array, consisting of the
      * southwest and northeast coordinates of the bounding represented as arrays of numbers.
      * @example
-     * var llb = new maplibregl.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
+     * ```ts
+     * let llb = new maplibregl.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
      * llb.toArray(); // = [[-73.9876, 40.7661], [-73.9397, 40.8002]]
+     * ```
      */
     toArray() {
         return [this._sw.toArray(), this._ne.toArray()];
@@ -209,11 +239,13 @@ class LngLatBounds {
     /**
      * Return the bounding box represented as a string.
      *
-     * @returns {string} The bounding box represents as a string of the format
+     * @returns The bounding box represents as a string of the format
      * `'LngLatBounds(LngLat(lng, lat), LngLat(lng, lat))'`.
      * @example
-     * var llb = new maplibregl.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
+     * ```ts
+     * let llb = new maplibregl.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
      * llb.toString(); // = "LngLatBounds(LngLat(-73.9876, 40.7661), LngLat(-73.9397, 40.8002))"
+     * ```
      */
     toString() {
         return `LngLatBounds(${this._sw.toString()}, ${this._ne.toString()})`;
@@ -222,7 +254,7 @@ class LngLatBounds {
     /**
      * Check if the bounding box is an empty/`null`-type box.
      *
-     * @returns {boolean} True if bounds have been defined, otherwise false.
+     * @returns True if bounds have been defined, otherwise false.
      */
     isEmpty() {
         return !(this._sw && this._ne);
@@ -231,17 +263,19 @@ class LngLatBounds {
     /**
      * Check if the point is within the bounding box.
      *
-     * @param {LngLatLike} lnglat geographic point to check against.
-     * @returns {boolean} True if the point is within the bounding box.
+     * @param lnglat - geographic point to check against.
+     * @returns `true` if the point is within the bounding box.
      * @example
-     * var llb = new maplibregl.LngLatBounds(
+     * ```ts
+     * let llb = new maplibregl.LngLatBounds(
      *   new maplibregl.LngLat(-73.9876, 40.7661),
      *   new maplibregl.LngLat(-73.9397, 40.8002)
      * );
      *
-     * var ll = new maplibregl.LngLat(-73.9567, 40.7789);
+     * let ll = new maplibregl.LngLat(-73.9567, 40.7789);
      *
      * console.log(llb.contains(ll)); // = true
+     * ```
      */
     contains(lnglat: LngLatLike) {
         const {lng, lat} = LngLat.convert(lnglat);
@@ -262,12 +296,13 @@ class LngLatBounds {
      *
      * Internally, the function calls `LngLat#convert` to convert arrays to `LngLat` values.
      *
-     * @param {LngLatBoundsLike} input An array of two coordinates to convert, or a `LngLatBounds` object to return.
-     * @returns {LngLatBounds} A new `LngLatBounds` object, if a conversion occurred, or the original `LngLatBounds` object.
+     * @param input - An array of two coordinates to convert, or a `LngLatBounds` object to return.
+     * @returns A new `LngLatBounds` object, if a conversion occurred, or the original `LngLatBounds` object.
      * @example
-     * var arr = [[-73.9876, 40.7661], [-73.9397, 40.8002]];
-     * var llb = maplibregl.LngLatBounds.convert(arr);
-     * llb;   // = LngLatBounds {_sw: LngLat {lng: -73.9876, lat: 40.7661}, _ne: LngLat {lng: -73.9397, lat: 40.8002}}
+     * ```ts
+     * let arr = [[-73.9876, 40.7661], [-73.9397, 40.8002]];
+     * let llb = maplibregl.LngLatBounds.convert(arr); // = LngLatBounds {_sw: LngLat {lng: -73.9876, lat: 40.7661}, _ne: LngLat {lng: -73.9397, lat: 40.8002}}
+     * ```
      */
     static convert(input: LngLatBoundsLike | null): LngLatBounds {
         if (input instanceof LngLatBounds) return input;
@@ -278,12 +313,14 @@ class LngLatBounds {
     /**
      * Returns a `LngLatBounds` from the coordinates extended by a given `radius`. The returned `LngLatBounds` completely contains the `radius`.
      *
-     * @param center center coordinates of the new bounds.
-     * @param {number} [radius=0] Distance in meters from the coordinates to extend the bounds.
-     * @returns {LngLatBounds} A new `LngLatBounds` object representing the coordinates extended by the `radius`.
+     * @param center - center coordinates of the new bounds.
+     * @param radius - Distance in meters from the coordinates to extend the bounds.
+     * @returns A new `LngLatBounds` object representing the coordinates extended by the `radius`.
      * @example
-     * var center = new maplibregl.LngLat(-73.9749, 40.7736);
+     * ```ts
+     * let center = new maplibregl.LngLat(-73.9749, 40.7736);
      * maplibregl.LngLatBounds.fromLngLat(100).toArray(); // = [[-73.97501862141328, 40.77351016847229], [-73.97478137858673, 40.77368983152771]]
+     * ```
      */
     static fromLngLat(center: LngLat, radius:number = 0): LngLatBounds {
         const earthCircumferenceInMetersAtEquator = 40075017;
@@ -294,20 +331,3 @@ class LngLatBounds {
             new LngLat(center.lng + lngAccuracy, center.lat + latAccuracy));
     }
 }
-
-/**
- * A {@link LngLatBounds} object, an array of {@link LngLatLike} objects in [sw, ne] order,
- * or an array of numbers in [west, south, east, north] order.
- *
- * @typedef {LngLatBounds | [LngLatLike, LngLatLike] | [number, number, number, number]} LngLatBoundsLike
- * @example
- * var v1 = new maplibregl.LngLatBounds(
- *   new maplibregl.LngLat(-73.9876, 40.7661),
- *   new maplibregl.LngLat(-73.9397, 40.8002)
- * );
- * var v2 = new maplibregl.LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002])
- * var v3 = [[-73.9876, 40.7661], [-73.9397, 40.8002]];
- */
-export type LngLatBoundsLike = LngLatBounds | [LngLatLike, LngLatLike] | [number, number, number, number];
-
-export default LngLatBounds;

package/src/geo/mercator_coordinate.test.ts

@@ -1,5 +1,5 @@
-import LngLat from './lng_lat';
-import MercatorCoordinate, {mercatorScale} from './mercator_coordinate';
+import {LngLat} from './lng_lat';
+import {MercatorCoordinate, mercatorScale} from './mercator_coordinate';
 
 describe('LngLat', () => {
     test('#constructor', () => {