ol 9.0.0-dev.1706534431133 → 9.0.0-dev.1706775218936

package/format/GPX.d.ts

@@ -1,4 +1,76 @@
 export default GPX;
+export type GPXLink = {
+    /**
+     * text
+     */
+    text?: string | undefined;
+    /**
+     * type
+     */
+    type?: string | undefined;
+};
+export type GPXAuthor = {
+    /**
+     * name
+     */
+    name?: string | undefined;
+    /**
+     * email
+     */
+    email?: string | undefined;
+    /**
+     * link
+     */
+    link?: GPXLink | undefined;
+};
+export type GPXMetadata = {
+    /**
+     * name
+     */
+    name?: string | undefined;
+    /**
+     * desc
+     */
+    desc?: string | undefined;
+    /**
+     * author
+     */
+    author?: GPXAuthor | undefined;
+    /**
+     * link
+     */
+    link?: GPXLink | undefined;
+    /**
+     * time
+     */
+    time?: number | undefined;
+    /**
+     * keywords
+     */
+    keywords?: string | undefined;
+    /**
+     * bounds
+     */
+    bounds?: number[] | undefined;
+    /**
+     * extensions
+     */
+    extensions?: any;
+};
+export type GPXCopyright = {
+    /**
+     * author
+     */
+    author?: string | undefined;
+    /**
+     * year
+     */
+    year?: number | undefined;
+    /**
+     * license
+     */
+    license?: string | undefined;
+};
 export type Options = {
     /**
      * Callback function
@@ -65,6 +137,29 @@ declare class GPX extends XMLFeature {
      * @private
      */
     private handleReadExtensions_;
+    /**
+     * Reads a GPX file's metadata tag, reading among other things:
+     *   - the name and description of this GPX
+     *   - its author
+     *   - the copyright associated with this GPX file
+     *
+     * Will return null if no metadata tag is present (or no valid source is given).
+     *
+     * @param {Document|Element|Object|string} source Source.
+     * @return {GPXMetadata | null} Metadata
+     * @api
+     */
+    readMetadata(source: Document | Element | any | string): GPXMetadata | null;
+    /**
+     * @param {Document} doc Document.
+     * @return {GPXMetadata | null} Metadata
+     */
+    readMetadataFromDocument(doc: Document): GPXMetadata | null;
+    /**
+     * @param {Element} node Node.
+     * @return {Object} Metadata
+     */
+    readMetadataFromNode(node: Element): any;
 }
 import Feature from '../Feature.js';
 import XMLFeature from './XMLFeature.js';

package/format/GPX.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPX.d.ts","sourceRoot":"","sources":["GPX.js"],"names":[],"mappings":";;;;;;;;;;6BAkGuB,OAAO,QAAE,IAAI,KAAE,IAAI;;;;;;;;;;;;AAF1C;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AACH;IACE;;OAEG;IACH,2CAeC;IALC;;;OAGG;IACH,wBAA6C;IAG/C;;;OAGG;IACH,8BAYC;CAgFF;oBAlPmB,eAAe;uBAIZ,iBAAiB"}
+{"version":3,"file":"GPX.d.ts","sourceRoot":"","sources":["GPX.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA2KuB,OAAO,QAAE,IAAI,KAAE,IAAI;;;;;;;;;;;;AAF1C;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AACH;IACE;;OAEG;IACH,2CAeC;IALC;;;OAGG;IACH,wBAA6C;IAG/C;;;OAGG;IACH,8BAYC;IAED;;;;;;;;;;;OAWG;IACH,qBAJW,QAAQ,GAAC,OAAO,SAAQ,MAAM,GAC7B,WAAW,GAAG,IAAI,CAc7B;IAED;;;OAGG;IACH,8BAHW,QAAQ,GACP,WAAW,GAAG,IAAI,CAY7B;IAED;;;OAGG;IACH,2BAHW,OAAO,OAgBjB;CAgFF;oBAvXmB,eAAe;uBAIZ,iBAAiB"}

package/format/GPX.js

@@ -10,6 +10,7 @@ import {
   OBJECT_PROPERTY_NODE_FACTORY,
   XML_SCHEMA_INSTANCE_URI,
   createElementNS,
+  isDocument,
   makeArrayPusher,
   makeArraySerializer,
   makeChildAppender,
@@ -17,6 +18,7 @@ import {
   makeSequence,
   makeSimpleNodeFactory,
   makeStructureNS,
+  parse,
   parseNode,
   pushParseAndPop,
   pushSerializeAndPop,
@@ -73,6 +75,12 @@ const GPX_PARSERS = makeStructureNS(NAMESPACE_URIS, {
   'wpt': makeArrayPusher(readWpt),
 });
 
+/**
+ * @typedef {Object} GPXLink
+ * @property {string} [text] text
+ * @property {string} [type] type
+ */
+
 /**
  * @const
  * @type {Object<string, Object<string, import("../xml.js").Parser>>}
@@ -83,6 +91,71 @@ const LINK_PARSERS = makeStructureNS(NAMESPACE_URIS, {
   'type': makeObjectPropertySetter(readString, 'linkType'),
 });
 
+/**
+ * @typedef {Object} GPXAuthor
+ * @property {string} [name] name
+ * @property {string} [email] email
+ * @property {GPXLink} [link] link
+ */
+
+/**
+ * @const
+ * @type {Object<string, Object<string, import("../xml.js").Parser>>}
+ */
+// @ts-ignore
+const AUTHOR_PARSERS = makeStructureNS(NAMESPACE_URIS, {
+  'name': makeObjectPropertySetter(readString),
+  'email': parseEmail,
+  'link': parseLink,
+});
+
+/**
+ * @typedef {Object} GPXMetadata
+ * @property {string} [name] name
+ * @property {string} [desc] desc
+ * @property {GPXAuthor} [author] author
+ * @property {GPXLink} [link] link
+ * @property {number} [time] time
+ * @property {string} [keywords] keywords
+ * @property {Array<number>} [bounds] bounds
+ * @property {Object} [extensions] extensions
+ *
+ */
+
+/**
+ * @const
+ * @type {Object<string, Object<string, import("../xml.js").Parser>>}
+ */
+// @ts-ignore
+const METADATA_PARSERS = makeStructureNS(NAMESPACE_URIS, {
+  'name': makeObjectPropertySetter(readString),
+  'desc': makeObjectPropertySetter(readString),
+  'author': makeObjectPropertySetter(readAuthor),
+  'copyright': makeObjectPropertySetter(readCopyright),
+  'link': parseLink,
+  'time': makeObjectPropertySetter(readDateTime),
+  'keywords': makeObjectPropertySetter(readString),
+  'bounds': parseBounds,
+  'extensions': parseExtensions,
+});
+
+/**
+ * @typedef {Object} GPXCopyright
+ * @property {string} [author] author
+ * @property {number} [year] year
+ * @property {string} [license] license
+ */
+
+/**
+ * @const
+ * @type {Object<string, Object<string, import("../xml.js").Parser>>}
+ */
+// @ts-ignore
+const COPYRIGHT_PARSERS = makeStructureNS(NAMESPACE_URIS, {
+  'year': makeObjectPropertySetter(readPositiveInteger),
+  'license': makeObjectPropertySetter(readString),
+});
+
 /**
  * @const
  * @type {Object<string, Object<string, import("../xml.js").Serializer>>}
@@ -165,6 +238,66 @@ class GPX extends XMLFeature {
     }
   }
 
+  /**
+   * Reads a GPX file's metadata tag, reading among other things:
+   *   - the name and description of this GPX
+   *   - its author
+   *   - the copyright associated with this GPX file
+   *
+   * Will return null if no metadata tag is present (or no valid source is given).
+   *
+   * @param {Document|Element|Object|string} source Source.
+   * @return {GPXMetadata | null} Metadata
+   * @api
+   */
+  readMetadata(source) {
+    if (!source) {
+      return null;
+    }
+    if (typeof source === 'string') {
+      return this.readMetadataFromDocument(parse(source));
+    }
+    if (isDocument(source)) {
+      return this.readMetadataFromDocument(/** @type {Document} */ (source));
+    }
+    return this.readMetadataFromNode(source);
+  }
+
+  /**
+   * @param {Document} doc Document.
+   * @return {GPXMetadata | null} Metadata
+   */
+  readMetadataFromDocument(doc) {
+    for (let n = /** @type {Node} */ (doc.firstChild); n; n = n.nextSibling) {
+      if (n.nodeType === Node.ELEMENT_NODE) {
+        const metadata = this.readMetadataFromNode(/** @type {Element} */ (n));
+        if (metadata) {
+          return metadata;
+        }
+      }
+    }
+    return null;
+  }
+
+  /**
+   * @param {Element} node Node.
+   * @return {Object} Metadata
+   */
+  readMetadataFromNode(node) {
+    if (!NAMESPACE_URIS.includes(node.namespaceURI)) {
+      return null;
+    }
+    for (let n = node.firstElementChild; n; n = n.nextElementSibling) {
+      if (
+        NAMESPACE_URIS.includes(n.namespaceURI) &&
+        n.localName === 'metadata'
+      ) {
+        return pushParseAndPop({}, METADATA_PARSERS, n, []);
+      }
+    }
+    return null;
+  }
+
   /**
    * @param {Element} node Node.
    * @param {import("./Feature.js").ReadOptions} [options] Options.
@@ -589,6 +722,72 @@ function applyLayoutOptions(layoutOptions, flatCoordinates, ends) {
   return layout;
 }
 
+/**
+ * @param {Element} node Node.
+ * @param {Array<any>} objectStack Object stack.
+ * @return {GPXAuthor | undefined} Person object.
+ */
+function readAuthor(node, objectStack) {
+  const values = pushParseAndPop({}, AUTHOR_PARSERS, node, objectStack);
+  if (values) {
+    return values;
+  }
+  return undefined;
+}
+
+/**
+ * @param {Element} node Node.
+ * @param {Array<any>} objectStack Object stack.
+ * @return {GPXCopyright | undefined} Person object.
+ */
+function readCopyright(node, objectStack) {
+  const values = pushParseAndPop({}, COPYRIGHT_PARSERS, node, objectStack);
+  if (values) {
+    const author = node.getAttribute('author');
+    if (author !== null) {
+      values['author'] = author;
+    }
+    return values;
+  }
+  return undefined;
+}
+
+/**
+ * @param {Element} node Node.
+ * @param {Array<*>} objectStack Object stack.
+ */
+function parseBounds(node, objectStack) {
+  const values = /** @type {Object} */ (objectStack[objectStack.length - 1]);
+  const minlat = node.getAttribute('minlat');
+  const minlon = node.getAttribute('minlon');
+  const maxlat = node.getAttribute('maxlat');
+  const maxlon = node.getAttribute('maxlon');
+  if (
+    minlon !== null &&
+    minlat !== null &&
+    maxlon !== null &&
+    maxlat !== null
+  ) {
+    values['bounds'] = [
+      [parseFloat(minlon), parseFloat(minlat)],
+      [parseFloat(maxlon), parseFloat(maxlat)],
+    ];
+  }
+}
+
+/**
+ * @param {Element} node Node.
+ * @param {Array<*>} objectStack Object stack.
+ */
+function parseEmail(node, objectStack) {
+  const values = /** @type {Object} */ (objectStack[objectStack.length - 1]);
+  const id = node.getAttribute('id');
+  const domain = node.getAttribute('domain');
+  if (id !== null && domain !== null) {
+    values['email'] = `${id}@${domain}`;
+  }
+}
+
 /**
  * @param {Element} node Node.
  * @param {Array<*>} objectStack Object stack.

package/geom/Geometry.d.ts

@@ -195,11 +195,11 @@ declare class Geometry extends BaseObject {
      *     string identifier or a {@link module:ol/proj/Projection~Projection} object.
      * @param {import("../proj.js").ProjectionLike} destination The desired projection.  Can be a
      *     string identifier or a {@link module:ol/proj/Projection~Projection} object.
-     * @return {Geometry} This geometry.  Note that original geometry is
+     * @return {this} This geometry.  Note that original geometry is
      *     modified in place.
      * @api
      */
-    transform(source: import("../proj.js").ProjectionLike, destination: import("../proj.js").ProjectionLike): Geometry;
+    transform(source: import("../proj.js").ProjectionLike, destination: import("../proj.js").ProjectionLike): this;
 }
 import BaseObject from '../Object.js';
 //# sourceMappingURL=Geometry.d.ts.map

package/geom/Geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Geometry.d.ts","sourceRoot":"","sources":["Geometry.js"],"names":[],"mappings":";;;;;6BAoBa,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM;;;;;;mBAM7B,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,iBAAiB,GAAG,cAAc,GAAG,oBAAoB,GAAG,QAAQ;AAWpJ;;;;;;;;;;;GAWG;AACH;IACE,cA6CC;IA1CC;;;OAGG;IACH,gBAA4B;IAE5B;;;OAGG;IACH,wBAAyB;IAEzB;;;OAGG;IACH,oDAFU,MAAM,CAEiC;IAEjD;;;OAGG;IACH,sCAFU,MAAM,CAEmB;IAEnC;;;;;;;OAOG;IACH,0DASC;IAGH;;;;;;OAMG;IACH,sCAJW,MAAM,mEAEL,QAAQ,CAQnB;IAED;;;;OAIG;IACH,SAFa,QAAQ,CAIpB;IAED;;;;;;;OAOG;IACH,kBANW,MAAM,KACN,MAAM,gBACN,OAAO,kBAAkB,EAAE,UAAU,sBACrC,MAAM,GACL,MAAM,CAIjB;IAED;;;;OAIG;IACH,cAJW,MAAM,KACN,MAAM,GACL,OAAO,CAKlB;IAED;;;;;;;OAOG;IACH,uBALW,OAAO,kBAAkB,EAAE,UAAU,qEAEpC,OAAO,kBAAkB,EAAE,UAAU,CAOhD;IAED;;;;;;OAMG;IACH,iCAJW,OAAO,kBAAkB,EAAE,UAAU,GACpC,OAAO,CAKlB;IAED;;;;;OAKG;IACH,gCAJW,OAAO,cAAc,EAAE,MAAM,GAE5B,OAAO,cAAc,EAAE,MAAM,CAIxC;IAED;;;;;OAKG;IACH,+DAHY,OAAO,cAAc,EAAE,MAAM,CAYxC;IAED;;;;;;;OAOG;IACH,cAJW,MAAM,UACN,OAAO,kBAAkB,EAAE,UAAU,QAK/C;IAED;;;;;;;;;OASG;IACH,UANW,MAAM,6FAQhB;IAED;;;;;;;;OAQG;IACH,oBAJW,MAAM,GACL,QAAQ,CAKnB;IAED;;;;;;;OAOG;IACH,wCAHW,MAAM,GACL,QAAQ,CAInB;IAED;;;;OAIG;IACH,WAFY,IAAI,CAIf;IAED;;;;;;;;OAQG;IACH,4BAHW,OAAO,YAAY,EAAE,iBAAiB,QAKhD;IAED;;;;;OAKG;IACH,yBAHW,OAAO,cAAc,EAAE,MAAM,GAC5B,OAAO,CAIlB;IAED;;;;;;;OAOG;IACH,kBAJW,MAAM,UACN,MAAM,QAKhB;IAED;;;;;;;;;;;;;;OAcG;IACH,kBARW,OAAO,YAAY,EAAE,cAAc,eAEnC,OAAO,YAAY,EAAE,cAAc,GAElC,QAAQ,CAwCnB;CACF;uBAnVsB,cAAc"}
+{"version":3,"file":"Geometry.d.ts","sourceRoot":"","sources":["Geometry.js"],"names":[],"mappings":";;;;;6BAoBa,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM;;;;;;mBAM7B,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,iBAAiB,GAAG,cAAc,GAAG,oBAAoB,GAAG,QAAQ;AAWpJ;;;;;;;;;;;GAWG;AACH;IACE,cA6CC;IA1CC;;;OAGG;IACH,gBAA4B;IAE5B;;;OAGG;IACH,wBAAyB;IAEzB;;;OAGG;IACH,oDAFU,MAAM,CAEiC;IAEjD;;;OAGG;IACH,sCAFU,MAAM,CAEmB;IAEnC;;;;;;;OAOG;IACH,0DASC;IAGH;;;;;;OAMG;IACH,sCAJW,MAAM,mEAEL,QAAQ,CAQnB;IAED;;;;OAIG;IACH,SAFa,QAAQ,CAIpB;IAED;;;;;;;OAOG;IACH,kBANW,MAAM,KACN,MAAM,gBACN,OAAO,kBAAkB,EAAE,UAAU,sBACrC,MAAM,GACL,MAAM,CAIjB;IAED;;;;OAIG;IACH,cAJW,MAAM,KACN,MAAM,GACL,OAAO,CAKlB;IAED;;;;;;;OAOG;IACH,uBALW,OAAO,kBAAkB,EAAE,UAAU,qEAEpC,OAAO,kBAAkB,EAAE,UAAU,CAOhD;IAED;;;;;;OAMG;IACH,iCAJW,OAAO,kBAAkB,EAAE,UAAU,GACpC,OAAO,CAKlB;IAED;;;;;OAKG;IACH,gCAJW,OAAO,cAAc,EAAE,MAAM,GAE5B,OAAO,cAAc,EAAE,MAAM,CAIxC;IAED;;;;;OAKG;IACH,+DAHY,OAAO,cAAc,EAAE,MAAM,CAYxC;IAED;;;;;;;OAOG;IACH,cAJW,MAAM,UACN,OAAO,kBAAkB,EAAE,UAAU,QAK/C;IAED;;;;;;;;;OASG;IACH,UANW,MAAM,6FAQhB;IAED;;;;;;;;OAQG;IACH,oBAJW,MAAM,GACL,QAAQ,CAKnB;IAED;;;;;;;OAOG;IACH,wCAHW,MAAM,GACL,QAAQ,CAInB;IAED;;;;OAIG;IACH,WAFY,IAAI,CAIf;IAED;;;;;;;;OAQG;IACH,4BAHW,OAAO,YAAY,EAAE,iBAAiB,QAKhD;IAED;;;;;OAKG;IACH,yBAHW,OAAO,cAAc,EAAE,MAAM,GAC5B,OAAO,CAIlB;IAED;;;;;;;OAOG;IACH,kBAJW,MAAM,UACN,MAAM,QAKhB;IAED;;;;;;;;;;;;;;OAcG;IACH,kBARW,OAAO,YAAY,EAAE,cAAc,eAEnC,OAAO,YAAY,EAAE,cAAc,GAElC,IAAI,CAwCf;CACF;uBAnVsB,cAAc"}

package/geom/Geometry.js

@@ -299,7 +299,7 @@ class Geometry extends BaseObject {
    *     string identifier or a {@link module:ol/proj/Projection~Projection} object.
    * @param {import("../proj.js").ProjectionLike} destination The desired projection.  Can be a
    *     string identifier or a {@link module:ol/proj/Projection~Projection} object.
-   * @return {Geometry} This geometry.  Note that original geometry is
+   * @return {this} This geometry.  Note that original geometry is
    *     modified in place.
    * @api
    */

package/interaction/Modify.js

@@ -1586,9 +1586,9 @@ function projectedDistanceToSegmentDataSquared(
     if (segmentData.index === CIRCLE_CIRCUMFERENCE_INDEX) {
       const userProjection = getUserProjection();
       if (userProjection) {
-        circleGeometry = /** @type {import("../geom/Circle.js").default} */ (
-          circleGeometry.clone().transform(userProjection, projection)
-        );
+        circleGeometry = circleGeometry
+          .clone()
+          .transform(userProjection, projection);
       }
       const distanceToCenterSquared = squaredCoordinateDistance(
         circleGeometry.getCenter(),
@@ -1628,9 +1628,9 @@ function closestOnSegmentData(pointCoordinates, segmentData, projection) {
     );
     const userProjection = getUserProjection();
     if (userProjection) {
-      circleGeometry = /** @type {import("../geom/Circle.js").default} */ (
-        circleGeometry.clone().transform(userProjection, projection)
-      );
+      circleGeometry = circleGeometry
+        .clone()
+        .transform(userProjection, projection);
     }
     return toUserCoordinate(
       circleGeometry.getClosestPoint(

package/interaction/Snap.js

@@ -586,9 +586,9 @@ class Snap extends PointerInteraction {
     let circleGeometry = geometry;
     const userProjection = getUserProjection();
     if (userProjection) {
-      circleGeometry = /** @type {import("../geom/Circle.js").default} */ (
-        circleGeometry.clone().transform(userProjection, projection)
-      );
+      circleGeometry = circleGeometry
+        .clone()
+        .transform(userProjection, projection);
     }
     const polygon = fromCircle(circleGeometry);
     if (userProjection) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ol",
-  "version": "9.0.0-dev.1706534431133",
+  "version": "9.0.0-dev.1706775218936",
   "description": "OpenLayers mapping library",
   "keywords": [
     "map",

package/util.js

@@ -33,4 +33,4 @@ export function getUid(obj) {
  * OpenLayers version.
  * @type {string}
  */
-export const VERSION = '9.0.0-dev.1706534431133';
+export const VERSION = '9.0.0-dev.1706775218936';