@itwin/core-common 4.0.0-dev.48 → 4.0.0-dev.51

package/lib/esm/geometry/CoordinateReferenceSystem.js

@@ -1,254 +1,254 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Geometry
- */
-// cspell:ignore NAVD, NGVD, NSRS, Helmert
-import { GeodeticDatum } from "./GeodeticDatum";
-import { GeodeticEllipsoid } from "./GeodeticEllipsoid";
-import { Carto2DDegrees, Projection } from "./Projection";
-import { AdditionalTransform } from "./AdditionalTransform";
-/** The extent in latitude, longitude bounds where a horizontal CRS is applicable
- *  @public
- */
-export class HorizontalCRSExtent {
-    constructor(data) {
-        if (data) {
-            this.southWest = Carto2DDegrees.fromJSON(data.southWest);
-            this.northEast = Carto2DDegrees.fromJSON(data.northEast);
-            if (this.northEast.latitude < this.southWest.latitude)
-                this.northEast.latitude = this.southWest.latitude;
-        }
-        else {
-            this.southWest = new Carto2DDegrees();
-            this.northEast = new Carto2DDegrees();
-        }
-    }
-    /** Creates an extent object from JSON representation.
-     * @public */
-    static fromJSON(data) {
-        return new HorizontalCRSExtent(data);
-    }
-    /** Creates a JSON from the Extent definition
-     * @public */
-    toJSON() {
-        return { southWest: this.southWest.toJSON(), northEast: this.northEast.toJSON() };
-    }
-    /** Compares two Extents. It applies a minuscule tolerance to comparing numbers.
-     *  @public */
-    equals(other) {
-        return this.southWest.equals(other.southWest) && this.northEast.equals(other.northEast);
-    }
-}
-/** Horizontal Geographic Coordinate reference System implementation.
- *  An horizontal CRS defines the portion which is horizontal to the Earth surface (within the deformation brought by the projection process).
- *  There are two major classes of Horizontal Coordinate Reference Systems:
- *  - The projected CRS which rely on a projection to flatten the coordinate system space into axises using linear
- *    units (meter, US Survey Feet, ...) relative to some origin.
- *  - The non projected CRS (also named geographic CRS by EPSG nomenclature) that does
- *    not require a projection (projection method = None) and horizontal coordinates are expressed
- *    as longitude and latitude (see [[Cartographic]])
- *  Horizontal Coordinate Systems rely on a projection to flatten the surface of an ellipsoid (see [[GeodeticEllipsoid]]) which is
- *  the mathematical model of the Earth surface.
- *  Explanations in more details of the various concepts can be obtained from other sources including the page on the subject
- *  on itwinJS.org (see https://www.itwinjs.org/learning/geolocation/?term=coordinate+system).
- *  A few details are still required to grasp the model. Geographic Coordinate Reference Systems rely on the concept of geodetic datums
- *  (see [[GeodeticDatum]]) to convert latitude/longitude from one frame of reference to another. Such geodetic datum will bind the ellipsoid
- *  and possibly define transformation steps required to convert from the currently used geodetic datum to the common datum WGS84
- *  used for worldwide data (such as most popular imagery data sources). If there are no rules established to convert to WGS84
- *  or if those rules are secret then the horizontal CRS can be datum-less and must make direct use of the ellipsoid
- *  to define the earth surface.
- *  For this purpose either the geodetic datum must be specified using either datumId or datum properties or both. If
- *  both these values are undefined then it is possible to define the ellipsoid using properties ellipsoidId or ellipsoid or both.
- *  These two pairs of properties are mutually exclusive with datum related properties having precedence. If a datum or datumId is set then
- *  ellipsoid properties will automatically be undefined. If datumId or datum is defined then attempts to set ellipsoidId or ellipsoid
- *  will fail silently, the values remaining undefined. The ellipsoidId will not be a repeat of the ellipsoidId property part of the
- *  geodetic datum definition.
- *  @public
- */
-export class HorizontalCRS {
-    constructor(_data) {
-        this.deprecated = false;
-        if (_data) {
-            this.id = _data.id;
-            this.description = _data.description;
-            this.source = _data.source;
-            this.deprecated = _data.deprecated ?? false;
-            this.epsg = _data.epsg;
-            this.datumId = _data.datumId;
-            this.datum = _data.datum ? GeodeticDatum.fromJSON(_data.datum) : undefined;
-            if (!this.datumId && !this.datum) {
-                this.ellipsoidId = _data.ellipsoidId;
-                this.ellipsoid = _data.ellipsoid ? GeodeticEllipsoid.fromJSON(_data.ellipsoid) : undefined;
-            }
-            this.unit = _data.unit;
-            this.projection = _data.projection ? Projection.fromJSON(_data.projection) : undefined;
-            this.extent = _data.extent ? HorizontalCRSExtent.fromJSON(_data.extent) : undefined;
-        }
-    }
-    /** Creates an Horizontal CRS from JSON representation.
-     * @public */
-    static fromJSON(data) {
-        return new HorizontalCRS(data);
-    }
-    /** Creates a JSON from the Horizontal CRS definition
-     * @public */
-    toJSON() {
-        const data = {};
-        data.id = this.id;
-        data.description = this.description;
-        data.source = this.source;
-        /* We prefer to use the default undef instead of false value for deprecated in Json */
-        if (this.deprecated)
-            data.deprecated = true;
-        data.epsg = this.epsg;
-        data.datumId = this.datumId;
-        if (this.datum)
-            data.datum = this.datum.toJSON();
-        data.ellipsoidId = this.ellipsoidId;
-        if (this.ellipsoid)
-            data.ellipsoid = this.ellipsoid.toJSON();
-        data.unit = this.unit;
-        if (this.projection)
-            data.projection = this.projection.toJSON();
-        if (this.extent)
-            data.extent = this.extent.toJSON();
-        return data;
-    }
-    /** Compares two horizontal CRS. It is not an equivalence test as descriptive properties are also compared
-     * but number compares are applied a minuscule tolerance.
-     *  @public */
-    equals(other) {
-        if (this.id !== other.id ||
-            this.description !== other.description ||
-            this.source !== other.source ||
-            this.deprecated !== other.deprecated ||
-            this.epsg !== other.epsg ||
-            this.datumId !== other.datumId ||
-            this.ellipsoidId !== other.ellipsoidId ||
-            this.unit !== other.unit)
-            return false;
-        if ((this.datum === undefined) !== (other.datum === undefined))
-            return false;
-        if (this.datum && !this.datum.equals(other.datum))
-            return false;
-        if ((this.ellipsoid === undefined) !== (other.ellipsoid === undefined))
-            return false;
-        if (this.ellipsoid && !this.ellipsoid.equals(other.ellipsoid))
-            return false;
-        if ((this.projection === undefined) !== (other.projection === undefined))
-            return false;
-        if (this.projection && !this.projection.equals(other.projection))
-            return false;
-        if ((this.extent === undefined) !== (other.extent === undefined))
-            return false;
-        if (this.extent && !this.extent.equals(other.extent))
-            return false;
-        return true;
-    }
-}
-/** Vertical Coordinate reference System implementation.
- *  The VerticalCRS contains currently a single identifier property of string type. Although
- *  we currently only support five distinct key values "GEOID", "ELLIPSOID", "NAVD88", "NGVD29" and "LOCAL_ELLIPSOID"
- *  we expect to support a broader set in the future including, eventually, user defined vertical CRS
- *  which will require additional parameters to be added.
- *  @public
-*/
-export class VerticalCRS {
-    constructor(data) {
-        this.id = "GEOID";
-        if (data)
-            this.id = data.id;
-    }
-    /** Creates a Vertical CRS from JSON representation.
-     * @public */
-    static fromJSON(data) {
-        return new VerticalCRS(data);
-    }
-    /** Creates a JSON from the Vertical CRS definition
-     * @public */
-    toJSON() {
-        return { id: this.id };
-    }
-    /** Compares two vertical CRS.
-     *  @public */
-    equals(other) {
-        return (this.id === other.id);
-    }
-}
-/** Geographic Coordinate Reference System implementation. This is the class that indicates the definition of a Geographic
- *  coordinate reference system comprised of three components: Horizontal and Vertical and an optional additional transform.
- *  The vertical component (see [[VerticalCRS]]) is the simplest portion containing a simple identifier as a string.
- *  The optional additional transform of which, currently, only the type Helmert 2D with Z offset [[Helmert2DWithZOffset]] is supported
- *  defines a transformation of x,y, and z cartesian coordinate of the projection to the final
- *  Geographic Coordinate Reference System cartesian coordinates.
- *  The horizontal component contains a list of identification and documentation properties as well as
- *  defining details possibly including the projection with method and parameters, the definition of the datum, ellipsoid, extent and so on.
- *  The principle of describing a Geographic CRS is that the definition may be incomplete. The whole set of classes related to geographic
- *  coordinate reference system classes ([[GeodeticEllipsoid]], [[GeodeticDatum]], [[Projection]], [[GeodeticTransform]], ...) are designed
- *  so that they can be parsed from incomplete JSON fragments, or produce incomplete JSON fragments such as would be
- *  generated from a request to a REST API to a server when select OData clauses are used.
- *  Often GeographicCRS would knowingly be created incomplete but with sufficient information to perform conversion from some
- *  reprojection engine (the present set of classes do not provide any GeographicCRS conversion).
- *  For example the following definitions are quite sufficient to request conversion to or from by a reprojection engine:
- *  { horizontalCRS: {id: "LL84"}, verticalCRS: {id:"GEOID"}
- *  or
- *  { horizontalCRS: {datumId: "WGS84", projection: {method: "None"}}, verticalCRS: "ELLIPSOID"}
- *  The reprojection engine will use the engine internal dictionary to obtain the details if it can.
- *  Some definitions will originate from other sources (a parsed WKT for example) and the reprojection engine will require
- *  all mathematical and operational details to perform any conversion (descriptive information are ignored in the conversion process).
- *  @note see important detailed explanation in the [[HorizontalCRS]], [[VerticalCRS]] and [[AdditionalTransform]] documentation.
- *  @note Earth Centered, Earth Fixed coordinate system (ECEF) is a full 3D cartesian system that unambiguously
- *        expressed coordinates relative to the Earth Center. Since there is no horizontal portion independent from
- *        the vertical portion this system cannot be represented by a GeographicCRS and remains a separate concept.
- *  @public
-*/
-export class GeographicCRS {
-    constructor(data) {
-        if (data) {
-            this.horizontalCRS = data.horizontalCRS ? HorizontalCRS.fromJSON(data.horizontalCRS) : undefined;
-            this.verticalCRS = data.verticalCRS ? VerticalCRS.fromJSON(data.verticalCRS) : undefined;
-            this.additionalTransform = data.additionalTransform ? AdditionalTransform.fromJSON(data.additionalTransform) : undefined;
-        }
-    }
-    /** Creates a Geographic CRS from JSON representation.
-     * @public */
-    static fromJSON(data) {
-        return new GeographicCRS(data);
-    }
-    /** Creates a JSON from the Geographic CRS definition
-     * @public */
-    toJSON() {
-        const data = {};
-        if (this.horizontalCRS)
-            data.horizontalCRS = this.horizontalCRS.toJSON();
-        if (this.verticalCRS)
-            data.verticalCRS = this.verticalCRS.toJSON();
-        if (this.additionalTransform)
-            data.additionalTransform = this.additionalTransform.toJSON();
-        return data;
-    }
-    /** Compares two Geographic CRS. It is a strict compare operation not an equivalence test though
-     * number compares are applied a minuscule tolerance.
-     * It takes into account descriptive properties not only mathematical definition properties.
-     * @public
-     */
-    equals(other) {
-        if ((this.horizontalCRS === undefined) !== (other.horizontalCRS === undefined))
-            return false;
-        if (this.horizontalCRS && !this.horizontalCRS.equals(other.horizontalCRS))
-            return false;
-        if ((this.verticalCRS === undefined) !== (other.verticalCRS === undefined))
-            return false;
-        if (this.verticalCRS && !this.verticalCRS.equals(other.verticalCRS))
-            return false;
-        if ((this.additionalTransform === undefined) !== (other.additionalTransform === undefined))
-            return false;
-        if (this.additionalTransform && !this.additionalTransform.equals(other.additionalTransform))
-            return false;
-        return true;
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Geometry
+ */
+// cspell:ignore NAVD, NGVD, NSRS, Helmert
+import { GeodeticDatum } from "./GeodeticDatum";
+import { GeodeticEllipsoid } from "./GeodeticEllipsoid";
+import { Carto2DDegrees, Projection } from "./Projection";
+import { AdditionalTransform } from "./AdditionalTransform";
+/** The extent in latitude, longitude bounds where a horizontal CRS is applicable
+ *  @public
+ */
+export class HorizontalCRSExtent {
+    constructor(data) {
+        if (data) {
+            this.southWest = Carto2DDegrees.fromJSON(data.southWest);
+            this.northEast = Carto2DDegrees.fromJSON(data.northEast);
+            if (this.northEast.latitude < this.southWest.latitude)
+                this.northEast.latitude = this.southWest.latitude;
+        }
+        else {
+            this.southWest = new Carto2DDegrees();
+            this.northEast = new Carto2DDegrees();
+        }
+    }
+    /** Creates an extent object from JSON representation.
+     * @public */
+    static fromJSON(data) {
+        return new HorizontalCRSExtent(data);
+    }
+    /** Creates a JSON from the Extent definition
+     * @public */
+    toJSON() {
+        return { southWest: this.southWest.toJSON(), northEast: this.northEast.toJSON() };
+    }
+    /** Compares two Extents. It applies a minuscule tolerance to comparing numbers.
+     *  @public */
+    equals(other) {
+        return this.southWest.equals(other.southWest) && this.northEast.equals(other.northEast);
+    }
+}
+/** Horizontal Geographic Coordinate reference System implementation.
+ *  An horizontal CRS defines the portion which is horizontal to the Earth surface (within the deformation brought by the projection process).
+ *  There are two major classes of Horizontal Coordinate Reference Systems:
+ *  - The projected CRS which rely on a projection to flatten the coordinate system space into axises using linear
+ *    units (meter, US Survey Feet, ...) relative to some origin.
+ *  - The non projected CRS (also named geographic CRS by EPSG nomenclature) that does
+ *    not require a projection (projection method = None) and horizontal coordinates are expressed
+ *    as longitude and latitude (see [[Cartographic]])
+ *  Horizontal Coordinate Systems rely on a projection to flatten the surface of an ellipsoid (see [[GeodeticEllipsoid]]) which is
+ *  the mathematical model of the Earth surface.
+ *  Explanations in more details of the various concepts can be obtained from other sources including the page on the subject
+ *  on itwinJS.org (see https://www.itwinjs.org/learning/geolocation/?term=coordinate+system).
+ *  A few details are still required to grasp the model. Geographic Coordinate Reference Systems rely on the concept of geodetic datums
+ *  (see [[GeodeticDatum]]) to convert latitude/longitude from one frame of reference to another. Such geodetic datum will bind the ellipsoid
+ *  and possibly define transformation steps required to convert from the currently used geodetic datum to the common datum WGS84
+ *  used for worldwide data (such as most popular imagery data sources). If there are no rules established to convert to WGS84
+ *  or if those rules are secret then the horizontal CRS can be datum-less and must make direct use of the ellipsoid
+ *  to define the earth surface.
+ *  For this purpose either the geodetic datum must be specified using either datumId or datum properties or both. If
+ *  both these values are undefined then it is possible to define the ellipsoid using properties ellipsoidId or ellipsoid or both.
+ *  These two pairs of properties are mutually exclusive with datum related properties having precedence. If a datum or datumId is set then
+ *  ellipsoid properties will automatically be undefined. If datumId or datum is defined then attempts to set ellipsoidId or ellipsoid
+ *  will fail silently, the values remaining undefined. The ellipsoidId will not be a repeat of the ellipsoidId property part of the
+ *  geodetic datum definition.
+ *  @public
+ */
+export class HorizontalCRS {
+    constructor(_data) {
+        this.deprecated = false;
+        if (_data) {
+            this.id = _data.id;
+            this.description = _data.description;
+            this.source = _data.source;
+            this.deprecated = _data.deprecated ?? false;
+            this.epsg = _data.epsg;
+            this.datumId = _data.datumId;
+            this.datum = _data.datum ? GeodeticDatum.fromJSON(_data.datum) : undefined;
+            if (!this.datumId && !this.datum) {
+                this.ellipsoidId = _data.ellipsoidId;
+                this.ellipsoid = _data.ellipsoid ? GeodeticEllipsoid.fromJSON(_data.ellipsoid) : undefined;
+            }
+            this.unit = _data.unit;
+            this.projection = _data.projection ? Projection.fromJSON(_data.projection) : undefined;
+            this.extent = _data.extent ? HorizontalCRSExtent.fromJSON(_data.extent) : undefined;
+        }
+    }
+    /** Creates an Horizontal CRS from JSON representation.
+     * @public */
+    static fromJSON(data) {
+        return new HorizontalCRS(data);
+    }
+    /** Creates a JSON from the Horizontal CRS definition
+     * @public */
+    toJSON() {
+        const data = {};
+        data.id = this.id;
+        data.description = this.description;
+        data.source = this.source;
+        /* We prefer to use the default undef instead of false value for deprecated in Json */
+        if (this.deprecated)
+            data.deprecated = true;
+        data.epsg = this.epsg;
+        data.datumId = this.datumId;
+        if (this.datum)
+            data.datum = this.datum.toJSON();
+        data.ellipsoidId = this.ellipsoidId;
+        if (this.ellipsoid)
+            data.ellipsoid = this.ellipsoid.toJSON();
+        data.unit = this.unit;
+        if (this.projection)
+            data.projection = this.projection.toJSON();
+        if (this.extent)
+            data.extent = this.extent.toJSON();
+        return data;
+    }
+    /** Compares two horizontal CRS. It is not an equivalence test as descriptive properties are also compared
+     * but number compares are applied a minuscule tolerance.
+     *  @public */
+    equals(other) {
+        if (this.id !== other.id ||
+            this.description !== other.description ||
+            this.source !== other.source ||
+            this.deprecated !== other.deprecated ||
+            this.epsg !== other.epsg ||
+            this.datumId !== other.datumId ||
+            this.ellipsoidId !== other.ellipsoidId ||
+            this.unit !== other.unit)
+            return false;
+        if ((this.datum === undefined) !== (other.datum === undefined))
+            return false;
+        if (this.datum && !this.datum.equals(other.datum))
+            return false;
+        if ((this.ellipsoid === undefined) !== (other.ellipsoid === undefined))
+            return false;
+        if (this.ellipsoid && !this.ellipsoid.equals(other.ellipsoid))
+            return false;
+        if ((this.projection === undefined) !== (other.projection === undefined))
+            return false;
+        if (this.projection && !this.projection.equals(other.projection))
+            return false;
+        if ((this.extent === undefined) !== (other.extent === undefined))
+            return false;
+        if (this.extent && !this.extent.equals(other.extent))
+            return false;
+        return true;
+    }
+}
+/** Vertical Coordinate reference System implementation.
+ *  The VerticalCRS contains currently a single identifier property of string type. Although
+ *  we currently only support five distinct key values "GEOID", "ELLIPSOID", "NAVD88", "NGVD29" and "LOCAL_ELLIPSOID"
+ *  we expect to support a broader set in the future including, eventually, user defined vertical CRS
+ *  which will require additional parameters to be added.
+ *  @public
+*/
+export class VerticalCRS {
+    constructor(data) {
+        this.id = "GEOID";
+        if (data)
+            this.id = data.id;
+    }
+    /** Creates a Vertical CRS from JSON representation.
+     * @public */
+    static fromJSON(data) {
+        return new VerticalCRS(data);
+    }
+    /** Creates a JSON from the Vertical CRS definition
+     * @public */
+    toJSON() {
+        return { id: this.id };
+    }
+    /** Compares two vertical CRS.
+     *  @public */
+    equals(other) {
+        return (this.id === other.id);
+    }
+}
+/** Geographic Coordinate Reference System implementation. This is the class that indicates the definition of a Geographic
+ *  coordinate reference system comprised of three components: Horizontal and Vertical and an optional additional transform.
+ *  The vertical component (see [[VerticalCRS]]) is the simplest portion containing a simple identifier as a string.
+ *  The optional additional transform of which, currently, only the type Helmert 2D with Z offset [[Helmert2DWithZOffset]] is supported
+ *  defines a transformation of x,y, and z cartesian coordinate of the projection to the final
+ *  Geographic Coordinate Reference System cartesian coordinates.
+ *  The horizontal component contains a list of identification and documentation properties as well as
+ *  defining details possibly including the projection with method and parameters, the definition of the datum, ellipsoid, extent and so on.
+ *  The principle of describing a Geographic CRS is that the definition may be incomplete. The whole set of classes related to geographic
+ *  coordinate reference system classes ([[GeodeticEllipsoid]], [[GeodeticDatum]], [[Projection]], [[GeodeticTransform]], ...) are designed
+ *  so that they can be parsed from incomplete JSON fragments, or produce incomplete JSON fragments such as would be
+ *  generated from a request to a REST API to a server when select OData clauses are used.
+ *  Often GeographicCRS would knowingly be created incomplete but with sufficient information to perform conversion from some
+ *  reprojection engine (the present set of classes do not provide any GeographicCRS conversion).
+ *  For example the following definitions are quite sufficient to request conversion to or from by a reprojection engine:
+ *  { horizontalCRS: {id: "LL84"}, verticalCRS: {id:"GEOID"}
+ *  or
+ *  { horizontalCRS: {datumId: "WGS84", projection: {method: "None"}}, verticalCRS: "ELLIPSOID"}
+ *  The reprojection engine will use the engine internal dictionary to obtain the details if it can.
+ *  Some definitions will originate from other sources (a parsed WKT for example) and the reprojection engine will require
+ *  all mathematical and operational details to perform any conversion (descriptive information are ignored in the conversion process).
+ *  @note see important detailed explanation in the [[HorizontalCRS]], [[VerticalCRS]] and [[AdditionalTransform]] documentation.
+ *  @note Earth Centered, Earth Fixed coordinate system (ECEF) is a full 3D cartesian system that unambiguously
+ *        expressed coordinates relative to the Earth Center. Since there is no horizontal portion independent from
+ *        the vertical portion this system cannot be represented by a GeographicCRS and remains a separate concept.
+ *  @public
+*/
+export class GeographicCRS {
+    constructor(data) {
+        if (data) {
+            this.horizontalCRS = data.horizontalCRS ? HorizontalCRS.fromJSON(data.horizontalCRS) : undefined;
+            this.verticalCRS = data.verticalCRS ? VerticalCRS.fromJSON(data.verticalCRS) : undefined;
+            this.additionalTransform = data.additionalTransform ? AdditionalTransform.fromJSON(data.additionalTransform) : undefined;
+        }
+    }
+    /** Creates a Geographic CRS from JSON representation.
+     * @public */
+    static fromJSON(data) {
+        return new GeographicCRS(data);
+    }
+    /** Creates a JSON from the Geographic CRS definition
+     * @public */
+    toJSON() {
+        const data = {};
+        if (this.horizontalCRS)
+            data.horizontalCRS = this.horizontalCRS.toJSON();
+        if (this.verticalCRS)
+            data.verticalCRS = this.verticalCRS.toJSON();
+        if (this.additionalTransform)
+            data.additionalTransform = this.additionalTransform.toJSON();
+        return data;
+    }
+    /** Compares two Geographic CRS. It is a strict compare operation not an equivalence test though
+     * number compares are applied a minuscule tolerance.
+     * It takes into account descriptive properties not only mathematical definition properties.
+     * @public
+     */
+    equals(other) {
+        if ((this.horizontalCRS === undefined) !== (other.horizontalCRS === undefined))
+            return false;
+        if (this.horizontalCRS && !this.horizontalCRS.equals(other.horizontalCRS))
+            return false;
+        if ((this.verticalCRS === undefined) !== (other.verticalCRS === undefined))
+            return false;
+        if (this.verticalCRS && !this.verticalCRS.equals(other.verticalCRS))
+            return false;
+        if ((this.additionalTransform === undefined) !== (other.additionalTransform === undefined))
+            return false;
+        if (this.additionalTransform && !this.additionalTransform.equals(other.additionalTransform))
+            return false;
+        return true;
+    }
+}
 //# sourceMappingURL=CoordinateReferenceSystem.js.map