@trackunit/geo-json-utils 1.15.42 → 1.15.45

package/index.cjs.js

@@ -1547,6 +1547,48 @@ const padGeoJsonBbox = (bbox, padding) => {
     const [west, east] = getBboxLongitudesFromUnwrappedRange({ west: paddedWest, east: paddedEast });
     return [west, clampedSouth, east, clampedNorth];
 };
+/**
+ * Expands any bbox axis narrower than `minSpanDegrees` to that span around the axis midpoint.
+ * A single point (or a set of co-located points) produces a zero-area bbox, which
+ * `geoJsonBboxSchema` rejects — north must be *strictly* greater than south (RFC 7946 §5.2) —
+ * so map `fitBounds` calls silently no-op on it. Latitudes are clamped to ±90 after padding,
+ * shifting the window back inside the valid range so the span is preserved even at the poles.
+ * Longitudes use the unwrapped span (so a narrow antimeridian-crossing strip is padded too)
+ * and are wrapped into `[-180, 180]` the same way as {@link padGeoJsonBbox}.
+ *
+ * Wide bboxes are returned as-is (same reference).
+ */
+const ensureMinimumGeoJsonBboxSpan = (bbox, minSpanDegrees) => {
+    const [, minLat, , maxLat] = bbox;
+    const { west: unwrappedWest, east: unwrappedEast, span: lngSpan } = getUnwrappedBboxLongitudeRange(bbox);
+    const lngSpanTooSmall = lngSpan < minSpanDegrees;
+    const latSpanTooSmall = maxLat - minLat < minSpanDegrees;
+    if (!lngSpanTooSmall && !latSpanTooSmall) {
+        return bbox;
+    }
+    const half = minSpanDegrees / 2;
+    let [south, north] = [minLat, maxLat];
+    if (latSpanTooSmall) {
+        const midLat = (minLat + maxLat) / 2;
+        south = midLat - half;
+        north = midLat + half;
+        if (north > MAX_LAT) {
+            south -= north - MAX_LAT;
+            north = MAX_LAT;
+        }
+        if (south < MIN_LAT) {
+            north += MIN_LAT - south;
+            south = MIN_LAT;
+            north = Math.min(north, MAX_LAT);
+        }
+    }
+    if (!lngSpanTooSmall) {
+        return [bbox[0], south, bbox[2], north];
+    }
+    const midLng = (unwrappedWest + unwrappedEast) / 2;
+    const [west, east] = getBboxLongitudesFromUnwrappedRange({ west: midLng - half, east: midLng + half });
+    return [west, south, east, north];
+};
 /**
  * Computes the difference of subject minus the union of all clips.
  * Returns null when the subject is fully covered (zero remaining area).
@@ -2067,6 +2109,7 @@ exports.coordinatesToStandardFormat = coordinatesToStandardFormat;
 exports.denormalizeLongitude = denormalizeLongitude;
 exports.distanceToGeoJsonPolygonBoundary = distanceToGeoJsonPolygonBoundary;
 exports.edgePixelLength = edgePixelLength;
+exports.ensureMinimumGeoJsonBboxSpan = ensureMinimumGeoJsonBboxSpan;
 exports.extractEdges = extractEdges;
 exports.extractFirstPointCoordinate = extractFirstPointCoordinate;
 exports.extractPositionsFromGeometry = extractPositionsFromGeometry;

package/index.esm.js

@@ -1545,6 +1545,48 @@ const padGeoJsonBbox = (bbox, padding) => {
     const [west, east] = getBboxLongitudesFromUnwrappedRange({ west: paddedWest, east: paddedEast });
     return [west, clampedSouth, east, clampedNorth];
 };
+/**
+ * Expands any bbox axis narrower than `minSpanDegrees` to that span around the axis midpoint.
+ * A single point (or a set of co-located points) produces a zero-area bbox, which
+ * `geoJsonBboxSchema` rejects — north must be *strictly* greater than south (RFC 7946 §5.2) —
+ * so map `fitBounds` calls silently no-op on it. Latitudes are clamped to ±90 after padding,
+ * shifting the window back inside the valid range so the span is preserved even at the poles.
+ * Longitudes use the unwrapped span (so a narrow antimeridian-crossing strip is padded too)
+ * and are wrapped into `[-180, 180]` the same way as {@link padGeoJsonBbox}.
+ *
+ * Wide bboxes are returned as-is (same reference).
+ */
+const ensureMinimumGeoJsonBboxSpan = (bbox, minSpanDegrees) => {
+    const [, minLat, , maxLat] = bbox;
+    const { west: unwrappedWest, east: unwrappedEast, span: lngSpan } = getUnwrappedBboxLongitudeRange(bbox);
+    const lngSpanTooSmall = lngSpan < minSpanDegrees;
+    const latSpanTooSmall = maxLat - minLat < minSpanDegrees;
+    if (!lngSpanTooSmall && !latSpanTooSmall) {
+        return bbox;
+    }
+    const half = minSpanDegrees / 2;
+    let [south, north] = [minLat, maxLat];
+    if (latSpanTooSmall) {
+        const midLat = (minLat + maxLat) / 2;
+        south = midLat - half;
+        north = midLat + half;
+        if (north > MAX_LAT) {
+            south -= north - MAX_LAT;
+            north = MAX_LAT;
+        }
+        if (south < MIN_LAT) {
+            north += MIN_LAT - south;
+            south = MIN_LAT;
+            north = Math.min(north, MAX_LAT);
+        }
+    }
+    if (!lngSpanTooSmall) {
+        return [bbox[0], south, bbox[2], north];
+    }
+    const midLng = (unwrappedWest + unwrappedEast) / 2;
+    const [west, east] = getBboxLongitudesFromUnwrappedRange({ west: midLng - half, east: midLng + half });
+    return [west, south, east, north];
+};
 /**
  * Computes the difference of subject minus the union of all clips.
  * Returns null when the subject is fully covered (zero remaining area).
@@ -2056,4 +2098,4 @@ const edgePixelLength = (x0, y0, x1, y1, zoom, midLatDeg, tileSize = 256) => {
     return Math.sqrt(dxPx * dxPx + dyPx * dyPx);
 };
 
-export { EARTH_RADIUS, EMPTY_FEATURE_COLLECTION, boundingBoxCrossesMeridian, checkCrossesMeridian, computeGeometryCentroid, coordinatesToStandardFormat, denormalizeLongitude, distanceToGeoJsonPolygonBoundary, edgePixelLength, extractEdges, extractFirstPointCoordinate, extractPositionsFromGeometry, geoJsonBboxSchema, geoJsonFeatureCollectionSchema, geoJsonFeatureSchema, geoJsonGeometryCollectionSchema, geoJsonGeometrySchema, geoJsonLineStringSchema, geoJsonLinearRingSchema, geoJsonMultiLineStringSchema, geoJsonMultiPointSchema, geoJsonMultiPolygonSchema, geoJsonPointSchema, geoJsonPolygonDifference, geoJsonPolygonSchema, geoJsonPosition2dSchema, geoJsonPositionSchema, getBboxFromGeoJsonPolygon, getBoundingBoxFromGeoJsonBbox, getBoundingBoxFromGeoJsonPolygon, getExtremeGeoJsonPointFromPolygon, getGeoJsonPolygonFromBoundingBox, getGeoJsonPolygonIntersection, getMinMaxLongitudes, getMultipleCoordinatesFromGeoJsonObject, getPointCoordinateFromGeoJsonObject, getPointCoordinateFromGeoJsonPoint, getPolygonFromBbox, getPolygonFromPointAndRadius, isBboxInsideFeatureCollection, isFullyContainedInGeoJsonGeometry, isFullyContainedInGeoJsonPolygon, isFullyContainedInGeometry, isGeoJsonPointInPolygon, isGeoJsonPositionInLinearRing, isPointInPolygon, isPositionInsideRing, lngLatToMercatorPxWS, lngLatToWebMercatorPx, mercatorPxToLngLatWS, normalizeLongitudes, padGeoJsonBbox, pixelsToLatDegrees, projectLngLatToWebMercator, projectPolygonalToWebMercator, scaleGeoJsonBbox, splitAntimeridianCrossingFeatures, splitAntimeridianCrossingGeometry, splitPolygonAtAntimeridian, splitPolygonWithHolesAtAntimeridian, toFeatureCollection, toPosition2d, tuGeoJsonPointRadiusSchema, tuGeoJsonPolygonNoHolesSchema, tuGeoJsonRectangularBoxPolygonSchema, unprojectPolygonalFromWebMercator, unprojectWebMercatorToLngLat, validateBbox, validateBboxWithFallback, validateFeatureCollection, validatePosition, webMercatorPxToLngLat };
+export { EARTH_RADIUS, EMPTY_FEATURE_COLLECTION, boundingBoxCrossesMeridian, checkCrossesMeridian, computeGeometryCentroid, coordinatesToStandardFormat, denormalizeLongitude, distanceToGeoJsonPolygonBoundary, edgePixelLength, ensureMinimumGeoJsonBboxSpan, extractEdges, extractFirstPointCoordinate, extractPositionsFromGeometry, geoJsonBboxSchema, geoJsonFeatureCollectionSchema, geoJsonFeatureSchema, geoJsonGeometryCollectionSchema, geoJsonGeometrySchema, geoJsonLineStringSchema, geoJsonLinearRingSchema, geoJsonMultiLineStringSchema, geoJsonMultiPointSchema, geoJsonMultiPolygonSchema, geoJsonPointSchema, geoJsonPolygonDifference, geoJsonPolygonSchema, geoJsonPosition2dSchema, geoJsonPositionSchema, getBboxFromGeoJsonPolygon, getBoundingBoxFromGeoJsonBbox, getBoundingBoxFromGeoJsonPolygon, getExtremeGeoJsonPointFromPolygon, getGeoJsonPolygonFromBoundingBox, getGeoJsonPolygonIntersection, getMinMaxLongitudes, getMultipleCoordinatesFromGeoJsonObject, getPointCoordinateFromGeoJsonObject, getPointCoordinateFromGeoJsonPoint, getPolygonFromBbox, getPolygonFromPointAndRadius, isBboxInsideFeatureCollection, isFullyContainedInGeoJsonGeometry, isFullyContainedInGeoJsonPolygon, isFullyContainedInGeometry, isGeoJsonPointInPolygon, isGeoJsonPositionInLinearRing, isPointInPolygon, isPositionInsideRing, lngLatToMercatorPxWS, lngLatToWebMercatorPx, mercatorPxToLngLatWS, normalizeLongitudes, padGeoJsonBbox, pixelsToLatDegrees, projectLngLatToWebMercator, projectPolygonalToWebMercator, scaleGeoJsonBbox, splitAntimeridianCrossingFeatures, splitAntimeridianCrossingGeometry, splitPolygonAtAntimeridian, splitPolygonWithHolesAtAntimeridian, toFeatureCollection, toPosition2d, tuGeoJsonPointRadiusSchema, tuGeoJsonPolygonNoHolesSchema, tuGeoJsonRectangularBoxPolygonSchema, unprojectPolygonalFromWebMercator, unprojectWebMercatorToLngLat, validateBbox, validateBboxWithFallback, validateFeatureCollection, validatePosition, webMercatorPxToLngLat };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/geo-json-utils",
-  "version": "1.15.42",
+  "version": "1.15.45",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/GeoJsonUtils.d.ts

@@ -161,6 +161,18 @@ export type BboxPadding = number | {
  * Latitudes are clamped to `[-90, 90]`, longitudes to `[-180, 180]`.
  */
 export declare const padGeoJsonBbox: (bbox: GeoJsonBbox, padding: BboxPadding) => GeoJsonBbox;
+/**
+ * Expands any bbox axis narrower than `minSpanDegrees` to that span around the axis midpoint.
+ * A single point (or a set of co-located points) produces a zero-area bbox, which
+ * `geoJsonBboxSchema` rejects — north must be *strictly* greater than south (RFC 7946 §5.2) —
+ * so map `fitBounds` calls silently no-op on it. Latitudes are clamped to ±90 after padding,
+ * shifting the window back inside the valid range so the span is preserved even at the poles.
+ * Longitudes use the unwrapped span (so a narrow antimeridian-crossing strip is padded too)
+ * and are wrapped into `[-180, 180]` the same way as {@link padGeoJsonBbox}.
+ *
+ * Wide bboxes are returned as-is (same reference).
+ */
+export declare const ensureMinimumGeoJsonBboxSpan: (bbox: GeoJsonBbox, minSpanDegrees: number) => GeoJsonBbox;
 /**
  * Computes the difference of subject minus the union of all clips.
  * Returns null when the subject is fully covered (zero remaining area).