@trackunit/geo-json-utils 1.14.32 → 1.14.35

package/index.cjs.js

@@ -1256,6 +1256,90 @@ const getGeoJsonPolygonIntersection = (polygon1, polygon2) => {
         coordinates: intersectionResult,
     };
 };
+const MIN_LNG = -180;
+const MAX_LNG = 180;
+const MIN_LAT = -90;
+const MAX_LAT = 90;
+const WORLD_LNG_SPAN = MAX_LNG - MIN_LNG;
+const clampLatitude = (lat) => Math.max(MIN_LAT, Math.min(MAX_LAT, lat));
+const normalizeBboxLongitude = (lng) => {
+    const normalized = normalizeLongitude(lng);
+    return normalized === MIN_LNG && lng > 0 ? MAX_LNG : normalized;
+};
+const getUnwrappedBboxLongitudeRange = (bbox) => {
+    const [west, , east] = bbox;
+    const unwrappedEast = west <= east ? east : east + WORLD_LNG_SPAN;
+    return { west, east: unwrappedEast, span: unwrappedEast - west };
+};
+const getBboxLongitudesFromUnwrappedRange = ({ east, west, }) => {
+    if (east - west >= WORLD_LNG_SPAN) {
+        return [MIN_LNG, MAX_LNG];
+    }
+    return [normalizeBboxLongitude(west), normalizeBboxLongitude(east)];
+};
+/**
+ * Scales a GeoJSON bounding box around its centre by a multiplier.
+ *
+ * `scale=1.0` → unchanged; `scale=2.0` → each dimension doubles; `scale=0.5` → half size.
+ * Latitudes are clamped to `[-90, 90]`, longitudes to `[-180, 180]`.
+ * Handles antimeridian-crossing bboxes (west > east).
+ */
+const scaleGeoJsonBbox = (bbox, scale) => {
+    if (scale <= 0) {
+        throw new RangeError("GeoJSON bbox scale must be greater than 0.");
+    }
+    const [, south, , north] = bbox;
+    const latSpan = north - south;
+    const latCenter = (south + north) / 2;
+    const scaledLatSpan = latSpan * scale;
+    const { west: unwrappedWest, east: unwrappedEast, span: lngSpan } = getUnwrappedBboxLongitudeRange(bbox);
+    const lngCenter = (unwrappedWest + unwrappedEast) / 2;
+    const scaledLngSpan = lngSpan * scale;
+    const [scaledWest, scaledEast] = getBboxLongitudesFromUnwrappedRange({
+        west: lngCenter - scaledLngSpan / 2,
+        east: lngCenter + scaledLngSpan / 2,
+    });
+    return [
+        scaledWest,
+        clampLatitude(latCenter - scaledLatSpan / 2),
+        scaledEast,
+        clampLatitude(latCenter + scaledLatSpan / 2),
+    ];
+};
+const resolvePadding = (padding) => {
+    if (typeof padding === "number") {
+        return { n: padding, s: padding, e: padding, w: padding };
+    }
+    if (padding.kind === "axes") {
+        return { n: padding.vertical, s: padding.vertical, e: padding.horizontal, w: padding.horizontal };
+    }
+    return { n: padding.north ?? 0, s: padding.south ?? 0, e: padding.east ?? 0, w: padding.west ?? 0 };
+};
+/**
+ * Pads a GeoJSON bounding box by absolute degree amounts.
+ *
+ * See {@link BboxPadding} for the three supported forms: uniform, axis-grouped, or per-side.
+ * Latitudes are clamped to `[-90, 90]`, longitudes to `[-180, 180]`.
+ */
+const padGeoJsonBbox = (bbox, padding) => {
+    const [, south, , north] = bbox;
+    const { n, s, e, w } = resolvePadding(padding);
+    const paddedSouth = south - s;
+    const paddedNorth = north + n;
+    const clampedSouth = clampLatitude(paddedSouth);
+    const clampedNorth = clampLatitude(paddedNorth);
+    if (clampedNorth <= clampedSouth) {
+        throw new RangeError("GeoJSON bbox padding must leave north greater than south.");
+    }
+    const { west: unwrappedWest, east: unwrappedEast } = getUnwrappedBboxLongitudeRange(bbox);
+    const paddedWest = unwrappedWest - w;
+    const paddedEast = unwrappedEast + e;
+    if (paddedEast < paddedWest) {
+        throw new RangeError("GeoJSON bbox padding must not invert west and east.");
+    }
+    const [west, east] = getBboxLongitudesFromUnwrappedRange({ west: paddedWest, east: paddedEast });
+    return [west, clampedSouth, east, clampedNorth];
+};
 /**
  * Computes the difference of subject minus the union of all clips.
  * Returns null when the subject is fully covered (zero remaining area).
@@ -1788,8 +1872,10 @@ exports.isGeoJsonPointInPolygon = isGeoJsonPointInPolygon;
 exports.isGeoJsonPositionInLinearRing = isGeoJsonPositionInLinearRing;
 exports.isPositionInsideRing = isPositionInsideRing;
 exports.normalizeLongitudes = normalizeLongitudes;
+exports.padGeoJsonBbox = padGeoJsonBbox;
 exports.projectLngLatToWebMercator = projectLngLatToWebMercator;
 exports.projectPolygonalToWebMercator = projectPolygonalToWebMercator;
+exports.scaleGeoJsonBbox = scaleGeoJsonBbox;
 exports.splitPolygonAtAntimeridian = splitPolygonAtAntimeridian;
 exports.splitPolygonWithHolesAtAntimeridian = splitPolygonWithHolesAtAntimeridian;
 exports.toFeatureCollection = toFeatureCollection;

package/index.esm.js

@@ -1254,6 +1254,90 @@ const getGeoJsonPolygonIntersection = (polygon1, polygon2) => {
         coordinates: intersectionResult,
     };
 };
+const MIN_LNG = -180;
+const MAX_LNG = 180;
+const MIN_LAT = -90;
+const MAX_LAT = 90;
+const WORLD_LNG_SPAN = MAX_LNG - MIN_LNG;
+const clampLatitude = (lat) => Math.max(MIN_LAT, Math.min(MAX_LAT, lat));
+const normalizeBboxLongitude = (lng) => {
+    const normalized = normalizeLongitude(lng);
+    return normalized === MIN_LNG && lng > 0 ? MAX_LNG : normalized;
+};
+const getUnwrappedBboxLongitudeRange = (bbox) => {
+    const [west, , east] = bbox;
+    const unwrappedEast = west <= east ? east : east + WORLD_LNG_SPAN;
+    return { west, east: unwrappedEast, span: unwrappedEast - west };
+};
+const getBboxLongitudesFromUnwrappedRange = ({ east, west, }) => {
+    if (east - west >= WORLD_LNG_SPAN) {
+        return [MIN_LNG, MAX_LNG];
+    }
+    return [normalizeBboxLongitude(west), normalizeBboxLongitude(east)];
+};
+/**
+ * Scales a GeoJSON bounding box around its centre by a multiplier.
+ *
+ * `scale=1.0` → unchanged; `scale=2.0` → each dimension doubles; `scale=0.5` → half size.
+ * Latitudes are clamped to `[-90, 90]`, longitudes to `[-180, 180]`.
+ * Handles antimeridian-crossing bboxes (west > east).
+ */
+const scaleGeoJsonBbox = (bbox, scale) => {
+    if (scale <= 0) {
+        throw new RangeError("GeoJSON bbox scale must be greater than 0.");
+    }
+    const [, south, , north] = bbox;
+    const latSpan = north - south;
+    const latCenter = (south + north) / 2;
+    const scaledLatSpan = latSpan * scale;
+    const { west: unwrappedWest, east: unwrappedEast, span: lngSpan } = getUnwrappedBboxLongitudeRange(bbox);
+    const lngCenter = (unwrappedWest + unwrappedEast) / 2;
+    const scaledLngSpan = lngSpan * scale;
+    const [scaledWest, scaledEast] = getBboxLongitudesFromUnwrappedRange({
+        west: lngCenter - scaledLngSpan / 2,
+        east: lngCenter + scaledLngSpan / 2,
+    });
+    return [
+        scaledWest,
+        clampLatitude(latCenter - scaledLatSpan / 2),
+        scaledEast,
+        clampLatitude(latCenter + scaledLatSpan / 2),
+    ];
+};
+const resolvePadding = (padding) => {
+    if (typeof padding === "number") {
+        return { n: padding, s: padding, e: padding, w: padding };
+    }
+    if (padding.kind === "axes") {
+        return { n: padding.vertical, s: padding.vertical, e: padding.horizontal, w: padding.horizontal };
+    }
+    return { n: padding.north ?? 0, s: padding.south ?? 0, e: padding.east ?? 0, w: padding.west ?? 0 };
+};
+/**
+ * Pads a GeoJSON bounding box by absolute degree amounts.
+ *
+ * See {@link BboxPadding} for the three supported forms: uniform, axis-grouped, or per-side.
+ * Latitudes are clamped to `[-90, 90]`, longitudes to `[-180, 180]`.
+ */
+const padGeoJsonBbox = (bbox, padding) => {
+    const [, south, , north] = bbox;
+    const { n, s, e, w } = resolvePadding(padding);
+    const paddedSouth = south - s;
+    const paddedNorth = north + n;
+    const clampedSouth = clampLatitude(paddedSouth);
+    const clampedNorth = clampLatitude(paddedNorth);
+    if (clampedNorth <= clampedSouth) {
+        throw new RangeError("GeoJSON bbox padding must leave north greater than south.");
+    }
+    const { west: unwrappedWest, east: unwrappedEast } = getUnwrappedBboxLongitudeRange(bbox);
+    const paddedWest = unwrappedWest - w;
+    const paddedEast = unwrappedEast + e;
+    if (paddedEast < paddedWest) {
+        throw new RangeError("GeoJSON bbox padding must not invert west and east.");
+    }
+    const [west, east] = getBboxLongitudesFromUnwrappedRange({ west: paddedWest, east: paddedEast });
+    return [west, clampedSouth, east, clampedNorth];
+};
 /**
  * Computes the difference of subject minus the union of all clips.
  * Returns null when the subject is fully covered (zero remaining area).
@@ -1740,4 +1824,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, isGeoJsonPointInPolygon, isGeoJsonPositionInLinearRing, isPositionInsideRing, normalizeLongitudes, projectLngLatToWebMercator, projectPolygonalToWebMercator, splitPolygonAtAntimeridian, splitPolygonWithHolesAtAntimeridian, toFeatureCollection, toPosition2d, tuGeoJsonPointRadiusSchema, tuGeoJsonPolygonNoHolesSchema, tuGeoJsonRectangularBoxPolygonSchema, unprojectPolygonalFromWebMercator, unprojectWebMercatorToLngLat, validateBbox, validateBboxWithFallback, validateFeatureCollection, validatePosition };
+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, isGeoJsonPointInPolygon, isGeoJsonPositionInLinearRing, isPositionInsideRing, normalizeLongitudes, padGeoJsonBbox, projectLngLatToWebMercator, projectPolygonalToWebMercator, scaleGeoJsonBbox, splitPolygonAtAntimeridian, splitPolygonWithHolesAtAntimeridian, toFeatureCollection, toPosition2d, tuGeoJsonPointRadiusSchema, tuGeoJsonPolygonNoHolesSchema, tuGeoJsonRectangularBoxPolygonSchema, unprojectPolygonalFromWebMercator, unprojectWebMercatorToLngLat, validateBbox, validateBboxWithFallback, validateFeatureCollection, validatePosition };

package/package.json

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

package/src/GeoJsonUtils.d.ts

@@ -101,6 +101,41 @@ export declare const isFullyContainedInGeoJsonPolygon: (polygon1: GeoJsonPolygon
  * Returns a MultiPolygon representing the intersection, or null if there is no intersection.
  */
 export declare const getGeoJsonPolygonIntersection: (polygon1: GeoJsonPolygon | GeoJsonMultiPolygon, polygon2: GeoJsonPolygon | GeoJsonMultiPolygon) => GeoJsonMultiPolygon | GeoJsonPolygon | null;
+/**
+ * Scales a GeoJSON bounding box around its centre by a multiplier.
+ *
+ * `scale=1.0` → unchanged; `scale=2.0` → each dimension doubles; `scale=0.5` → half size.
+ * Latitudes are clamped to `[-90, 90]`, longitudes to `[-180, 180]`.
+ * Handles antimeridian-crossing bboxes (west > east).
+ */
+export declare const scaleGeoJsonBbox: (bbox: GeoJsonBbox, scale: number) => GeoJsonBbox;
+/**
+ * Padding argument for {@link padGeoJsonBbox}.
+ *
+ * - `number` — the same padding (in degrees) applied to all four edges.
+ * - `{ kind: 'axes' }` — separate values for horizontal (east/west) and vertical (north/south).
+ * - `{ kind: 'sides' }` — per-edge values; any omitted edge defaults to `0`.
+ *
+ * Positive values expand the bbox; negative values shrink it.
+ */
+export type BboxPadding = number | {
+    readonly kind: "axes";
+    readonly horizontal: number;
+    readonly vertical: number;
+} | {
+    readonly kind: "sides";
+    readonly north?: number;
+    readonly south?: number;
+    readonly east?: number;
+    readonly west?: number;
+};
+/**
+ * Pads a GeoJSON bounding box by absolute degree amounts.
+ *
+ * See {@link BboxPadding} for the three supported forms: uniform, axis-grouped, or per-side.
+ * Latitudes are clamped to `[-90, 90]`, longitudes to `[-180, 180]`.
+ */
+export declare const padGeoJsonBbox: (bbox: GeoJsonBbox, padding: BboxPadding) => GeoJsonBbox;
 /**
  * Computes the difference of subject minus the union of all clips.
  * Returns null when the subject is fully covered (zero remaining area).