@trackunit/geo-json-utils 1.14.66 → 1.14.67-alpha-636ec415cd1.0

package/index.cjs.js

@@ -29,6 +29,66 @@ const isPositionInsideRing = (point, ring) => {
     }
     return inside;
 };
+/**
+ * Hole-aware point-in-polygon: true when the point is inside the exterior ring
+ * and outside every hole ring (RFC 7946 Section 3.1.6).
+ *
+ * This is an unvalidated, performance-optimized version of
+ * `isGeoJsonPointInPolygon` for use in hot rendering paths.
+ */
+const isPointInPolygon = (point, polygon) => {
+    const [exteriorRing, ...holeRings] = polygon.coordinates;
+    if (!exteriorRing) {
+        return false;
+    }
+    if (!isPositionInsideRing(point, exteriorRing)) {
+        return false;
+    }
+    return !holeRings.some(hole => isPositionInsideRing(point, hole));
+};
+/**
+ * Whether every outer-ring vertex of `geom1` lies inside `geom2` (holes respected;
+ * for a MultiPolygon `geom2`, "inside" means inside any one member). A degenerate
+ * `geom1` with no outer rings is contained in nothing.
+ *
+ * This is an unvalidated, performance-optimized version of
+ * `isFullyContainedInGeoJsonGeometry` for use in hot rendering paths.
+ */
+const isFullyContainedInGeometry = (geom1, geom2) => {
+    const outerRings1 = [];
+    if (geom1.type === "Polygon") {
+        const outerRing = geom1.coordinates[0];
+        if (outerRing)
+            outerRings1.push(outerRing);
+    }
+    else {
+        for (const poly of geom1.coordinates) {
+            const outerRing = poly[0];
+            if (outerRing)
+                outerRings1.push(outerRing);
+        }
+    }
+    if (outerRings1.length === 0) {
+        return false;
+    }
+    const polygonParts2 = [];
+    if (geom2.type === "Polygon") {
+        polygonParts2.push(geom2);
+    }
+    else {
+        for (const poly of geom2.coordinates) {
+            polygonParts2.push({ type: "Polygon", coordinates: poly });
+        }
+    }
+    for (const outerRing of outerRings1) {
+        for (const position of outerRing) {
+            if (!polygonParts2.some(part => isPointInPolygon(position, part))) {
+                return false;
+            }
+        }
+    }
+    return true;
+};
 /**
  * Check if a bounding box is fully inside any polygon in a feature collection.
  * All four corners of the bbox must be inside the same polygon and outside
@@ -403,12 +463,14 @@ const geoJsonPolygonSchema = zod.z.object({
 });
 /**
  * MultiPolygon geometry object.
+ * Each member is a Polygon coordinate array and must have at least one ring
+ * (its exterior ring), per RFC 7946 Sections 3.1.6/3.1.7.
  * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
  * https://tools.ietf.org/html/rfc7946#section-3.1.7
  */
 const geoJsonMultiPolygonSchema = zod.z.object({
     type: zod.z.literal("MultiPolygon"),
-    coordinates: zod.z.array(zod.z.array(geoJsonLinearRingSchema)),
+    coordinates: zod.z.array(zod.z.array(geoJsonLinearRingSchema).min(1)),
     bbox: geoJsonBboxSchema.optional(),
 });
 /**
@@ -1170,37 +1232,15 @@ const isGeoJsonPositionInLinearRing = ({ position, linearRing, }) => {
  * @description Checks if a point is inside a polygon.
  * Correctly handles holes per RFC 7946 Section 3.1.6: the first ring is the
  * exterior boundary, subsequent rings are holes. A point inside a hole is
- * considered outside the polygon.
+ * considered outside the polygon. Validates, then delegates to the pure
+ * `isPointInPolygon`.
  */
 const isGeoJsonPointInPolygon = ({ point, polygon, }) => {
     const polygonParsed = geoJsonPolygonSchema.safeParse(polygon);
     if (!polygonParsed.success) {
         return null;
     }
-    const [exteriorRing, ...holeRings] = polygonParsed.data.coordinates;
-    if (!exteriorRing) {
-        return null;
-    }
-    // Explicit null checks are intentional: isGeoJsonPositionInLinearRing returns
-    // boolean | null, and using it directly in boolean expressions like
-    // `!result` or `.some()` would silently treat null as false/truthy, masking errors.
-    const insideExterior = isGeoJsonPositionInLinearRing({ position: point.coordinates, linearRing: exteriorRing });
-    if (insideExterior === null) {
-        return null;
-    }
-    if (!insideExterior) {
-        return false;
-    }
-    for (const hole of holeRings) {
-        const insideHole = isGeoJsonPositionInLinearRing({ position: point.coordinates, linearRing: hole });
-        if (insideHole === null) {
-            return null;
-        }
-        if (insideHole) {
-            return false;
-        }
-    }
-    return true;
+    return isPointInPolygon(point.coordinates, polygonParsed.data);
 };
 /**
  * Checks if polygon1 is fully contained within polygon2.
@@ -1423,63 +1463,37 @@ const unprojectPolygonalFromWebMercator = (geometry) => mapPolygonalCoordinates(
  * Generalisation of isFullyContainedInGeoJsonPolygon to Polygon|MultiPolygon arguments.
  * Returns true when every outer-ring vertex of geom1 lies inside geom2 (holes respected).
  * For a MultiPolygon geom2, "inside" means inside any one of its polygon members.
- * Returns null if either geometry fails validation.
+ * Returns null if either geometry fails validation. Once validated, delegates to
+ * the pure `isFullyContainedInGeometry`.
  */
 const isFullyContainedInGeoJsonGeometry = (geom1, geom2) => {
-    const outerRings1 = [];
+    let validGeom1;
     if (geom1.type === "Polygon") {
         const parsed = geoJsonPolygonSchema.safeParse(geom1);
         if (!parsed.success)
             return null;
-        const outerRing = parsed.data.coordinates[0];
-        if (!outerRing)
-            return null;
-        outerRings1.push(outerRing);
+        validGeom1 = parsed.data;
     }
     else {
         const parsed = geoJsonMultiPolygonSchema.safeParse(geom1);
         if (!parsed.success)
             return null;
-        for (const poly of parsed.data.coordinates) {
-            const outerRing = poly[0];
-            if (!outerRing)
-                return null;
-            outerRings1.push(outerRing);
-        }
+        validGeom1 = parsed.data;
     }
-    const polygonParts2 = [];
+    let validGeom2;
     if (geom2.type === "Polygon") {
         const parsed = geoJsonPolygonSchema.safeParse(geom2);
         if (!parsed.success)
             return null;
-        polygonParts2.push(parsed.data);
+        validGeom2 = parsed.data;
     }
     else {
         const parsed = geoJsonMultiPolygonSchema.safeParse(geom2);
         if (!parsed.success)
             return null;
-        for (const poly of parsed.data.coordinates) {
-            polygonParts2.push({ type: "Polygon", coordinates: poly });
-        }
+        validGeom2 = parsed.data;
     }
-    for (const outerRing of outerRings1) {
-        for (const position of outerRing) {
-            const point = { coordinates: position };
-            let insideAny = false;
-            for (const part of polygonParts2) {
-                const result = isGeoJsonPointInPolygon({ point, polygon: part });
-                if (result === null)
-                    return null;
-                if (result) {
-                    insideAny = true;
-                    break;
-                }
-            }
-            if (!insideAny)
-                return false;
-        }
-    }
-    return true;
+    return isFullyContainedInGeometry(validGeom1, validGeom2);
 };
 /**
  * Returns the minimum distance (in coordinate units) from the given position to the
@@ -1919,8 +1933,10 @@ exports.getPolygonFromPointAndRadius = getPolygonFromPointAndRadius;
 exports.isBboxInsideFeatureCollection = isBboxInsideFeatureCollection;
 exports.isFullyContainedInGeoJsonGeometry = isFullyContainedInGeoJsonGeometry;
 exports.isFullyContainedInGeoJsonPolygon = isFullyContainedInGeoJsonPolygon;
+exports.isFullyContainedInGeometry = isFullyContainedInGeometry;
 exports.isGeoJsonPointInPolygon = isGeoJsonPointInPolygon;
 exports.isGeoJsonPositionInLinearRing = isGeoJsonPositionInLinearRing;
+exports.isPointInPolygon = isPointInPolygon;
 exports.isPositionInsideRing = isPositionInsideRing;
 exports.lngLatToMercatorPxWS = lngLatToMercatorPxWS;
 exports.lngLatToWebMercatorPx = lngLatToWebMercatorPx;

package/index.esm.js

@@ -27,6 +27,66 @@ const isPositionInsideRing = (point, ring) => {
     }
     return inside;
 };
+/**
+ * Hole-aware point-in-polygon: true when the point is inside the exterior ring
+ * and outside every hole ring (RFC 7946 Section 3.1.6).
+ *
+ * This is an unvalidated, performance-optimized version of
+ * `isGeoJsonPointInPolygon` for use in hot rendering paths.
+ */
+const isPointInPolygon = (point, polygon) => {
+    const [exteriorRing, ...holeRings] = polygon.coordinates;
+    if (!exteriorRing) {
+        return false;
+    }
+    if (!isPositionInsideRing(point, exteriorRing)) {
+        return false;
+    }
+    return !holeRings.some(hole => isPositionInsideRing(point, hole));
+};
+/**
+ * Whether every outer-ring vertex of `geom1` lies inside `geom2` (holes respected;
+ * for a MultiPolygon `geom2`, "inside" means inside any one member). A degenerate
+ * `geom1` with no outer rings is contained in nothing.
+ *
+ * This is an unvalidated, performance-optimized version of
+ * `isFullyContainedInGeoJsonGeometry` for use in hot rendering paths.
+ */
+const isFullyContainedInGeometry = (geom1, geom2) => {
+    const outerRings1 = [];
+    if (geom1.type === "Polygon") {
+        const outerRing = geom1.coordinates[0];
+        if (outerRing)
+            outerRings1.push(outerRing);
+    }
+    else {
+        for (const poly of geom1.coordinates) {
+            const outerRing = poly[0];
+            if (outerRing)
+                outerRings1.push(outerRing);
+        }
+    }
+    if (outerRings1.length === 0) {
+        return false;
+    }
+    const polygonParts2 = [];
+    if (geom2.type === "Polygon") {
+        polygonParts2.push(geom2);
+    }
+    else {
+        for (const poly of geom2.coordinates) {
+            polygonParts2.push({ type: "Polygon", coordinates: poly });
+        }
+    }
+    for (const outerRing of outerRings1) {
+        for (const position of outerRing) {
+            if (!polygonParts2.some(part => isPointInPolygon(position, part))) {
+                return false;
+            }
+        }
+    }
+    return true;
+};
 /**
  * Check if a bounding box is fully inside any polygon in a feature collection.
  * All four corners of the bbox must be inside the same polygon and outside
@@ -401,12 +461,14 @@ const geoJsonPolygonSchema = z.object({
 });
 /**
  * MultiPolygon geometry object.
+ * Each member is a Polygon coordinate array and must have at least one ring
+ * (its exterior ring), per RFC 7946 Sections 3.1.6/3.1.7.
  * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
  * https://tools.ietf.org/html/rfc7946#section-3.1.7
  */
 const geoJsonMultiPolygonSchema = z.object({
     type: z.literal("MultiPolygon"),
-    coordinates: z.array(z.array(geoJsonLinearRingSchema)),
+    coordinates: z.array(z.array(geoJsonLinearRingSchema).min(1)),
     bbox: geoJsonBboxSchema.optional(),
 });
 /**
@@ -1168,37 +1230,15 @@ const isGeoJsonPositionInLinearRing = ({ position, linearRing, }) => {
  * @description Checks if a point is inside a polygon.
  * Correctly handles holes per RFC 7946 Section 3.1.6: the first ring is the
  * exterior boundary, subsequent rings are holes. A point inside a hole is
- * considered outside the polygon.
+ * considered outside the polygon. Validates, then delegates to the pure
+ * `isPointInPolygon`.
  */
 const isGeoJsonPointInPolygon = ({ point, polygon, }) => {
     const polygonParsed = geoJsonPolygonSchema.safeParse(polygon);
     if (!polygonParsed.success) {
         return null;
     }
-    const [exteriorRing, ...holeRings] = polygonParsed.data.coordinates;
-    if (!exteriorRing) {
-        return null;
-    }
-    // Explicit null checks are intentional: isGeoJsonPositionInLinearRing returns
-    // boolean | null, and using it directly in boolean expressions like
-    // `!result` or `.some()` would silently treat null as false/truthy, masking errors.
-    const insideExterior = isGeoJsonPositionInLinearRing({ position: point.coordinates, linearRing: exteriorRing });
-    if (insideExterior === null) {
-        return null;
-    }
-    if (!insideExterior) {
-        return false;
-    }
-    for (const hole of holeRings) {
-        const insideHole = isGeoJsonPositionInLinearRing({ position: point.coordinates, linearRing: hole });
-        if (insideHole === null) {
-            return null;
-        }
-        if (insideHole) {
-            return false;
-        }
-    }
-    return true;
+    return isPointInPolygon(point.coordinates, polygonParsed.data);
 };
 /**
  * Checks if polygon1 is fully contained within polygon2.
@@ -1421,63 +1461,37 @@ const unprojectPolygonalFromWebMercator = (geometry) => mapPolygonalCoordinates(
  * Generalisation of isFullyContainedInGeoJsonPolygon to Polygon|MultiPolygon arguments.
  * Returns true when every outer-ring vertex of geom1 lies inside geom2 (holes respected).
  * For a MultiPolygon geom2, "inside" means inside any one of its polygon members.
- * Returns null if either geometry fails validation.
+ * Returns null if either geometry fails validation. Once validated, delegates to
+ * the pure `isFullyContainedInGeometry`.
  */
 const isFullyContainedInGeoJsonGeometry = (geom1, geom2) => {
-    const outerRings1 = [];
+    let validGeom1;
     if (geom1.type === "Polygon") {
         const parsed = geoJsonPolygonSchema.safeParse(geom1);
         if (!parsed.success)
             return null;
-        const outerRing = parsed.data.coordinates[0];
-        if (!outerRing)
-            return null;
-        outerRings1.push(outerRing);
+        validGeom1 = parsed.data;
     }
     else {
         const parsed = geoJsonMultiPolygonSchema.safeParse(geom1);
         if (!parsed.success)
             return null;
-        for (const poly of parsed.data.coordinates) {
-            const outerRing = poly[0];
-            if (!outerRing)
-                return null;
-            outerRings1.push(outerRing);
-        }
+        validGeom1 = parsed.data;
     }
-    const polygonParts2 = [];
+    let validGeom2;
     if (geom2.type === "Polygon") {
         const parsed = geoJsonPolygonSchema.safeParse(geom2);
         if (!parsed.success)
             return null;
-        polygonParts2.push(parsed.data);
+        validGeom2 = parsed.data;
     }
     else {
         const parsed = geoJsonMultiPolygonSchema.safeParse(geom2);
         if (!parsed.success)
             return null;
-        for (const poly of parsed.data.coordinates) {
-            polygonParts2.push({ type: "Polygon", coordinates: poly });
-        }
+        validGeom2 = parsed.data;
     }
-    for (const outerRing of outerRings1) {
-        for (const position of outerRing) {
-            const point = { coordinates: position };
-            let insideAny = false;
-            for (const part of polygonParts2) {
-                const result = isGeoJsonPointInPolygon({ point, polygon: part });
-                if (result === null)
-                    return null;
-                if (result) {
-                    insideAny = true;
-                    break;
-                }
-            }
-            if (!insideAny)
-                return false;
-        }
-    }
-    return true;
+    return isFullyContainedInGeometry(validGeom1, validGeom2);
 };
 /**
  * Returns the minimum distance (in coordinate units) from the given position to the
@@ -1875,4 +1889,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, lngLatToMercatorPxWS, lngLatToWebMercatorPx, mercatorPxToLngLatWS, normalizeLongitudes, padGeoJsonBbox, pixelsToLatDegrees, projectLngLatToWebMercator, projectPolygonalToWebMercator, scaleGeoJsonBbox, 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, 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, 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.14.66",
+  "version": "1.14.67-alpha-636ec415cd1.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/GeoJsonGeometryUtils.d.ts

@@ -1,4 +1,4 @@
-import type { GeoJsonBbox, GeoJsonFeatureCollection, GeoJsonGeometry, GeoJsonPosition } from "./GeoJsonSchemas";
+import type { GeoJsonBbox, GeoJsonFeatureCollection, GeoJsonGeometry, GeoJsonMultiPolygon, GeoJsonPolygon, GeoJsonPosition } from "./GeoJsonSchemas";
 type Edge = readonly [GeoJsonPosition, GeoJsonPosition];
 /**
  * Ray-casting point-in-polygon test for a single coordinate ring.
@@ -8,6 +8,23 @@ type Edge = readonly [GeoJsonPosition, GeoJsonPosition];
  * `isGeoJsonPositionInLinearRing` for use in hot rendering paths.
  */
 export declare const isPositionInsideRing: (point: GeoJsonPosition, ring: ReadonlyArray<GeoJsonPosition>) => boolean;
+/**
+ * Hole-aware point-in-polygon: true when the point is inside the exterior ring
+ * and outside every hole ring (RFC 7946 Section 3.1.6).
+ *
+ * This is an unvalidated, performance-optimized version of
+ * `isGeoJsonPointInPolygon` for use in hot rendering paths.
+ */
+export declare const isPointInPolygon: (point: GeoJsonPosition, polygon: GeoJsonPolygon) => boolean;
+/**
+ * Whether every outer-ring vertex of `geom1` lies inside `geom2` (holes respected;
+ * for a MultiPolygon `geom2`, "inside" means inside any one member). A degenerate
+ * `geom1` with no outer rings is contained in nothing.
+ *
+ * This is an unvalidated, performance-optimized version of
+ * `isFullyContainedInGeoJsonGeometry` for use in hot rendering paths.
+ */
+export declare const isFullyContainedInGeometry: (geom1: GeoJsonPolygon | GeoJsonMultiPolygon, geom2: GeoJsonPolygon | GeoJsonMultiPolygon) => boolean;
 /**
  * Check if a bounding box is fully inside any polygon in a feature collection.
  * All four corners of the bbox must be inside the same polygon and outside

package/src/GeoJsonSchemas.d.ts

@@ -140,6 +140,8 @@ export declare const geoJsonPolygonSchema: z.ZodObject<{
 export type GeoJsonPolygon = z.infer<typeof geoJsonPolygonSchema>;
 /**
  * MultiPolygon geometry object.
+ * Each member is a Polygon coordinate array and must have at least one ring
+ * (its exterior ring), per RFC 7946 Sections 3.1.6/3.1.7.
  * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
  * https://tools.ietf.org/html/rfc7946#section-3.1.7
  */

package/src/GeoJsonUtils.d.ts

@@ -84,7 +84,8 @@ export declare const isGeoJsonPositionInLinearRing: ({ position, linearRing, }:
  * @description Checks if a point is inside a polygon.
  * Correctly handles holes per RFC 7946 Section 3.1.6: the first ring is the
  * exterior boundary, subsequent rings are holes. A point inside a hole is
- * considered outside the polygon.
+ * considered outside the polygon. Validates, then delegates to the pure
+ * `isPointInPolygon`.
  */
 export declare const isGeoJsonPointInPolygon: ({ point, polygon, }: {
     point: GeoJsonPoint;
@@ -167,7 +168,8 @@ export declare const unprojectPolygonalFromWebMercator: (geometry: GeoJsonPolygo
  * Generalisation of isFullyContainedInGeoJsonPolygon to Polygon|MultiPolygon arguments.
  * Returns true when every outer-ring vertex of geom1 lies inside geom2 (holes respected).
  * For a MultiPolygon geom2, "inside" means inside any one of its polygon members.
- * Returns null if either geometry fails validation.
+ * Returns null if either geometry fails validation. Once validated, delegates to
+ * the pure `isFullyContainedInGeometry`.
  */
 export declare const isFullyContainedInGeoJsonGeometry: (geom1: GeoJsonPolygon | GeoJsonMultiPolygon, geom2: GeoJsonPolygon | GeoJsonMultiPolygon) => boolean | null;
 /**