@itowns/geographic 2.46.1-next.51 → 2.46.1-next.53

package/lib/Extent.d.ts

@@ -127,12 +127,38 @@ declare class Extent {
      * @param extent - the provided extent
      */
     intersectsExtent(extent: Extent): boolean;
+    /**
+     * Tests whether two extents intersect.
+     *
+     * This method checks if the geographic extents `extentA` and `extentB`
+     * overlap. If their coordinate reference systems (CRS) differ, `extentB`
+     * is reprojected into the CRS of `extentA` before performing the test.
+     *
+     * Extents that touch at an edge or a corner aren't treated as intersecting.
+     *
+     * @param extentA - The reference extent.
+     * @param extentB - The extent to test against.
+     *
+     * @returns `true` if the extents intersect, `false` otherwise.
+     */
     static intersectsExtent(extentA: Extent, extentB: Extent): boolean;
     /**
      * Returns the intersection of this extent with another one.
-     * @param extent - extent to intersect
+     *
+     * This method computes the overlapping region between this extent and
+     * another extent. If their coordinate reference systems (CRS) differ,
+     * the other extent is reprojected into the CRS of this extent before
+     * performing the intersection.
+     *
+     *
+     * @param extent - The extent to intersect with this one.
+     * @param target - The target extent to store the result. If not provided,
+     * a new extent will be created.
+     *
+     * @returns The intersection extent
+     * (may be empty if extents do not intersect).
      */
-    intersect(extent: Extent): Extent;
+    intersect(extent: Extent, target?: Extent): Extent;
     /**
      * Set west, east, south and north values.
      *
@@ -165,7 +191,7 @@ declare class Extent {
      * Union this extent with the input extent.
      * @param extent - the extent to union.
      */
-    union(extent: Extent): void;
+    union(extent: Extent): this;
     /**
      * expandByCoordinates perfoms the minimal extension
      * for the coordinates to belong to this Extent object

package/lib/Extent.js

@@ -243,24 +243,50 @@ class Extent {
   intersectsExtent(extent) {
     return Extent.intersectsExtent(this, extent);
   }
+
+  /**
+   * Tests whether two extents intersect.
+   *
+   * This method checks if the geographic extents `extentA` and `extentB`
+   * overlap. If their coordinate reference systems (CRS) differ, `extentB`
+   * is reprojected into the CRS of `extentA` before performing the test.
+   *
+   * Extents that touch at an edge or a corner aren't treated as intersecting.
+   *
+   * @param extentA - The reference extent.
+   * @param extentB - The extent to test against.
+   *
+   * @returns `true` if the extents intersect, `false` otherwise.
+   */
   static intersectsExtent(extentA, extentB) {
-    // TODO don't work when is on limit
     const other = extentB.crs == extentA.crs ? extentB : extentB.as(extentA.crs, _extent);
     return !(extentA.west >= other.east || extentA.east <= other.west || extentA.south >= other.north || extentA.north <= other.south);
   }
 
   /**
    * Returns the intersection of this extent with another one.
-   * @param extent - extent to intersect
+   *
+   * This method computes the overlapping region between this extent and
+   * another extent. If their coordinate reference systems (CRS) differ,
+   * the other extent is reprojected into the CRS of this extent before
+   * performing the intersection.
+   *
+   *
+   * @param extent - The extent to intersect with this one.
+   * @param target - The target extent to store the result. If not provided,
+   * a new extent will be created.
+   *
+   * @returns The intersection extent
+   * (may be empty if extents do not intersect).
    */
-  intersect(extent) {
+  intersect(extent, target = new Extent(this.crs)) {
     if (!this.intersectsExtent(extent)) {
-      return new Extent(this.crs);
+      return target;
     }
     if (extent.crs != this.crs) {
       extent = extent.as(this.crs, _extent);
     }
-    return new Extent(this.crs, Math.max(this.west, extent.west), Math.min(this.east, extent.east), Math.max(this.south, extent.south), Math.min(this.north, extent.north));
+    return target.set(Math.max(this.west, extent.west), Math.min(this.east, extent.east), Math.max(this.south, extent.south), Math.min(this.north, extent.north));
   }
 
   /**
@@ -360,6 +386,7 @@ class Extent {
         this.north = north;
       }
     }
+    return this;
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itowns/geographic",
-  "version": "2.46.1-next.51",
+  "version": "2.46.1-next.53",
   "description": "Proj4-based three.js geodesy toolkit",
   "type": "module",
   "main": "lib/index.js",

package/src/Extent.ts

@@ -299,8 +299,21 @@ class Extent {
         return Extent.intersectsExtent(this, extent);
     }
 
+    /**
+     * Tests whether two extents intersect.
+     *
+     * This method checks if the geographic extents `extentA` and `extentB`
+     * overlap. If their coordinate reference systems (CRS) differ, `extentB`
+     * is reprojected into the CRS of `extentA` before performing the test.
+     *
+     * Extents that touch at an edge or a corner aren't treated as intersecting.
+     *
+     * @param extentA - The reference extent.
+     * @param extentB - The extent to test against.
+     *
+     * @returns `true` if the extents intersect, `false` otherwise.
+     */
     static intersectsExtent(extentA: Extent, extentB: Extent) {
-        // TODO don't work when is on limit
         const other = extentB.crs == extentA.crs ? extentB : extentB.as(extentA.crs, _extent);
         return !(extentA.west >= other.east ||
             extentA.east <= other.west ||
@@ -310,16 +323,29 @@ class Extent {
 
     /**
      * Returns the intersection of this extent with another one.
-     * @param extent - extent to intersect
+     *
+     * This method computes the overlapping region between this extent and
+     * another extent. If their coordinate reference systems (CRS) differ,
+     * the other extent is reprojected into the CRS of this extent before
+     * performing the intersection.
+     *
+     *
+     * @param extent - The extent to intersect with this one.
+     * @param target - The target extent to store the result. If not provided,
+     * a new extent will be created.
+     *
+     * @returns The intersection extent
+     * (may be empty if extents do not intersect).
      */
-    intersect(extent: Extent) {
+    intersect(extent: Extent, target = new Extent(this.crs)) {
         if (!this.intersectsExtent(extent)) {
-            return new Extent(this.crs);
+            return target;
         }
         if (extent.crs != this.crs) {
             extent = extent.as(this.crs, _extent);
         }
-        return new Extent(this.crs,
+
+        return target.set(
             Math.max(this.west, extent.west),
             Math.min(this.east, extent.east),
             Math.max(this.south, extent.south),
@@ -432,6 +458,8 @@ class Extent {
                 this.north = north;
             }
         }
+
+        return this;
     }
 
     /**