@trackunit/geo-json-utils 1.14.22 → 1.14.26-alpha-27ad777c16e.0

package/index.cjs.js

@@ -1519,6 +1519,33 @@ const tuGeoJsonRectangularBoxPolygonSchema = zod.z
     }
 });
 
+const DEG_TO_RAD = Math.PI / 180;
+/**
+ * Compute the pixel length of a line segment at a given zoom level,
+ * accounting for Web Mercator latitude distortion.
+ *
+ * Web Mercator tile math: worldSize = tileSize * 2^zoom pixels for 360 degrees of longitude.
+ * Latitude pixels scale by sec(lat).
+ *
+ * Relocated from `@trackunit/react-map` (per ADR-0018 follow-up) since this is pure
+ * Mercator math with no React or DS semantics — appropriate for a vanilla geo utility lib.
+ *
+ * @param x0 - Start longitude (degrees)
+ * @param y0 - Start latitude (degrees)
+ * @param x1 - End longitude (degrees)
+ * @param y1 - End latitude (degrees)
+ * @param zoom - Map zoom level
+ * @param midLatDeg - Mid-point latitude for distortion correction (degrees)
+ * @param tileSize - Tile size in pixels (default 256)
+ */
+const edgePixelLength = (x0, y0, x1, y1, zoom, midLatDeg, tileSize = 256) => {
+    const pxPerDeg = (tileSize * Math.pow(2, zoom)) / 360;
+    const secLat = 1 / Math.cos(midLatDeg * DEG_TO_RAD);
+    const dxPx = (x1 - x0) * pxPerDeg;
+    const dyPx = (y1 - y0) * pxPerDeg * secLat;
+    return Math.sqrt(dxPx * dxPx + dyPx * dyPx);
+};
+
 exports.EARTH_RADIUS = EARTH_RADIUS;
 exports.EMPTY_FEATURE_COLLECTION = EMPTY_FEATURE_COLLECTION;
 exports.boundingBoxCrossesMeridian = boundingBoxCrossesMeridian;
@@ -1526,6 +1553,7 @@ exports.checkCrossesMeridian = checkCrossesMeridian;
 exports.computeGeometryCentroid = computeGeometryCentroid;
 exports.coordinatesToStandardFormat = coordinatesToStandardFormat;
 exports.denormalizeLongitude = denormalizeLongitude;
+exports.edgePixelLength = edgePixelLength;
 exports.extractEdges = extractEdges;
 exports.extractFirstPointCoordinate = extractFirstPointCoordinate;
 exports.extractPositionsFromGeometry = extractPositionsFromGeometry;

package/index.esm.js

@@ -1517,4 +1517,31 @@ const tuGeoJsonRectangularBoxPolygonSchema = z
     }
 });
 
-export { EARTH_RADIUS, EMPTY_FEATURE_COLLECTION, boundingBoxCrossesMeridian, checkCrossesMeridian, computeGeometryCentroid, coordinatesToStandardFormat, denormalizeLongitude, extractEdges, extractFirstPointCoordinate, extractPositionsFromGeometry, geoJsonBboxSchema, geoJsonFeatureCollectionSchema, geoJsonFeatureSchema, geoJsonGeometryCollectionSchema, geoJsonGeometrySchema, geoJsonLineStringSchema, geoJsonLinearRingSchema, geoJsonMultiLineStringSchema, geoJsonMultiPointSchema, geoJsonMultiPolygonSchema, geoJsonPointSchema, geoJsonPolygonSchema, geoJsonPosition2dSchema, geoJsonPositionSchema, getBboxFromGeoJsonPolygon, getBoundingBoxFromGeoJsonBbox, getBoundingBoxFromGeoJsonPolygon, getExtremeGeoJsonPointFromPolygon, getGeoJsonPolygonFromBoundingBox, getGeoJsonPolygonIntersection, getMinMaxLongitudes, getMultipleCoordinatesFromGeoJsonObject, getPointCoordinateFromGeoJsonObject, getPointCoordinateFromGeoJsonPoint, getPolygonFromBbox, getPolygonFromPointAndRadius, isBboxInsideFeatureCollection, isFullyContainedInGeoJsonPolygon, isGeoJsonPointInPolygon, isGeoJsonPositionInLinearRing, isPositionInsideRing, normalizeLongitudes, splitPolygonAtAntimeridian, splitPolygonWithHolesAtAntimeridian, toFeatureCollection, toPosition2d, tuGeoJsonPointRadiusSchema, tuGeoJsonPolygonNoHolesSchema, tuGeoJsonRectangularBoxPolygonSchema, validateBbox, validateBboxWithFallback, validateFeatureCollection, validatePosition };
+const DEG_TO_RAD = Math.PI / 180;
+/**
+ * Compute the pixel length of a line segment at a given zoom level,
+ * accounting for Web Mercator latitude distortion.
+ *
+ * Web Mercator tile math: worldSize = tileSize * 2^zoom pixels for 360 degrees of longitude.
+ * Latitude pixels scale by sec(lat).
+ *
+ * Relocated from `@trackunit/react-map` (per ADR-0018 follow-up) since this is pure
+ * Mercator math with no React or DS semantics — appropriate for a vanilla geo utility lib.
+ *
+ * @param x0 - Start longitude (degrees)
+ * @param y0 - Start latitude (degrees)
+ * @param x1 - End longitude (degrees)
+ * @param y1 - End latitude (degrees)
+ * @param zoom - Map zoom level
+ * @param midLatDeg - Mid-point latitude for distortion correction (degrees)
+ * @param tileSize - Tile size in pixels (default 256)
+ */
+const edgePixelLength = (x0, y0, x1, y1, zoom, midLatDeg, tileSize = 256) => {
+    const pxPerDeg = (tileSize * Math.pow(2, zoom)) / 360;
+    const secLat = 1 / Math.cos(midLatDeg * DEG_TO_RAD);
+    const dxPx = (x1 - x0) * pxPerDeg;
+    const dyPx = (y1 - y0) * pxPerDeg * secLat;
+    return Math.sqrt(dxPx * dxPx + dyPx * dyPx);
+};
+
+export { EARTH_RADIUS, EMPTY_FEATURE_COLLECTION, boundingBoxCrossesMeridian, checkCrossesMeridian, computeGeometryCentroid, coordinatesToStandardFormat, denormalizeLongitude, edgePixelLength, extractEdges, extractFirstPointCoordinate, extractPositionsFromGeometry, geoJsonBboxSchema, geoJsonFeatureCollectionSchema, geoJsonFeatureSchema, geoJsonGeometryCollectionSchema, geoJsonGeometrySchema, geoJsonLineStringSchema, geoJsonLinearRingSchema, geoJsonMultiLineStringSchema, geoJsonMultiPointSchema, geoJsonMultiPolygonSchema, geoJsonPointSchema, geoJsonPolygonSchema, geoJsonPosition2dSchema, geoJsonPositionSchema, getBboxFromGeoJsonPolygon, getBoundingBoxFromGeoJsonBbox, getBoundingBoxFromGeoJsonPolygon, getExtremeGeoJsonPointFromPolygon, getGeoJsonPolygonFromBoundingBox, getGeoJsonPolygonIntersection, getMinMaxLongitudes, getMultipleCoordinatesFromGeoJsonObject, getPointCoordinateFromGeoJsonObject, getPointCoordinateFromGeoJsonPoint, getPolygonFromBbox, getPolygonFromPointAndRadius, isBboxInsideFeatureCollection, isFullyContainedInGeoJsonPolygon, isGeoJsonPointInPolygon, isGeoJsonPositionInLinearRing, isPositionInsideRing, normalizeLongitudes, splitPolygonAtAntimeridian, splitPolygonWithHolesAtAntimeridian, toFeatureCollection, toPosition2d, tuGeoJsonPointRadiusSchema, tuGeoJsonPolygonNoHolesSchema, tuGeoJsonRectangularBoxPolygonSchema, validateBbox, validateBboxWithFallback, validateFeatureCollection, validatePosition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/geo-json-utils",
-  "version": "1.14.22",
+  "version": "1.14.26-alpha-27ad777c16e.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/WebMercatorUtils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Compute the pixel length of a line segment at a given zoom level,
+ * accounting for Web Mercator latitude distortion.
+ *
+ * Web Mercator tile math: worldSize = tileSize * 2^zoom pixels for 360 degrees of longitude.
+ * Latitude pixels scale by sec(lat).
+ *
+ * Relocated from `@trackunit/react-map` (per ADR-0018 follow-up) since this is pure
+ * Mercator math with no React or DS semantics — appropriate for a vanilla geo utility lib.
+ *
+ * @param x0 - Start longitude (degrees)
+ * @param y0 - Start latitude (degrees)
+ * @param x1 - End longitude (degrees)
+ * @param y1 - End latitude (degrees)
+ * @param zoom - Map zoom level
+ * @param midLatDeg - Mid-point latitude for distortion correction (degrees)
+ * @param tileSize - Tile size in pixels (default 256)
+ */
+export declare const edgePixelLength: (x0: number, y0: number, x1: number, y1: number, zoom: number, midLatDeg: number, tileSize?: number) => number;

package/src/index.d.ts

@@ -6,3 +6,4 @@ export * from "./MeridianUtils";
 export * from "./TuGeoJsonBridgeUtils";
 export * from "./TuGeoJsonConversions";
 export * from "./TuGeoJsonSchemas";
+export * from "./WebMercatorUtils";