@trackunit/geo-json-utils 1.11.57 → 1.11.58

package/package.json

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

package/src/GeoJsonSchemas.d.ts

@@ -1,69 +1,107 @@
 import { z } from "zod";
 /**
- * A Position is an array of coordinates. [x, y]
- * https://tools.ietf.org/html/rfc7946#section-3.1.1
+ * A Position is an array of coordinates. [longitude, latitude] or [longitude, latitude, altitude]
+ * RFC 7946 Section 3.1.1: "There MUST be two or more elements. The first two elements
+ * are longitude and latitude [...] Altitude or elevation MAY be included as an optional
+ * third element."
  */
-export declare const geoJsonPositionSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+export declare const geoJsonPosition2dSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+export declare const geoJsonPositionSchema: z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>;
 export type GeoJsonPosition = z.infer<typeof geoJsonPositionSchema>;
+export type GeoJsonPosition2d = z.infer<typeof geoJsonPosition2dSchema>;
+/**
+ * 2D bounding box of the GeoJSON object.
+ * The value of the bbox member is an array of length 4.
+ *
+ * [west, south, east, north]
+ *
+ * Note: west may be greater than east for bboxes that cross the
+ * antimeridian (RFC 7946 Section 5.2).
+ *
+ * Zero-height bboxes (north === south) are rejected per RFC 7946 Section 5.2:
+ * "The latitude of the northeast corner is always greater than the latitude
+ * of the southwest corner." Zero-width bboxes (west === east) are not explicitly
+ * forbidden by the RFC for non-antimeridian cases, so they pass.
+ */
+export declare const geoJsonBboxSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>;
+export type GeoJsonBbox = z.infer<typeof geoJsonBboxSchema>;
 /**
  * Point geometry object.
+ * Uses z.object() (not strictObject) so RFC 7946 Section 6.1 "foreign members"
+ * (crs, vendor extensions, etc.) are accepted and stripped during parse.
  * https://tools.ietf.org/html/rfc7946#section-3.1.2
  */
 export declare const geoJsonPointSchema: z.ZodObject<{
     type: z.ZodLiteral<"Point">;
-    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
-}, "strict", z.ZodTypeAny, {
+    coordinates: z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>;
+    bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+}, "strip", z.ZodTypeAny, {
     type: "Point";
-    coordinates: [number, number];
+    coordinates: [number, number] | [number, number, number];
+    bbox?: [number, number, number, number] | undefined;
 }, {
     type: "Point";
-    coordinates: [number, number];
+    coordinates: [number, number] | [number, number, number];
+    bbox?: [number, number, number, number] | undefined;
 }>;
 export type GeoJsonPoint = z.infer<typeof geoJsonPointSchema>;
 /**
  * MultiPoint geometry object.
- *  https://tools.ietf.org/html/rfc7946#section-3.1.3
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
+ * https://tools.ietf.org/html/rfc7946#section-3.1.3
  */
 export declare const geoJsonMultiPointSchema: z.ZodObject<{
     type: z.ZodLiteral<"MultiPoint">;
-    coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">;
-}, "strict", z.ZodTypeAny, {
+    coordinates: z.ZodArray<z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>, "many">;
+    bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+}, "strip", z.ZodTypeAny, {
     type: "MultiPoint";
-    coordinates: [number, number][];
+    coordinates: ([number, number] | [number, number, number])[];
+    bbox?: [number, number, number, number] | undefined;
 }, {
     type: "MultiPoint";
-    coordinates: [number, number][];
+    coordinates: ([number, number] | [number, number, number])[];
+    bbox?: [number, number, number, number] | undefined;
 }>;
 export type GeoJsonMultiPoint = z.infer<typeof geoJsonMultiPointSchema>;
 /**
  * LineString geometry object.
  * Minimum length of 2 positions.
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
  * https://tools.ietf.org/html/rfc7946#section-3.1.4
  */
 export declare const geoJsonLineStringSchema: z.ZodObject<{
     type: z.ZodLiteral<"LineString">;
-    coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">;
-}, "strict", z.ZodTypeAny, {
+    coordinates: z.ZodArray<z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>, "many">;
+    bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+}, "strip", z.ZodTypeAny, {
     type: "LineString";
-    coordinates: [number, number][];
+    coordinates: ([number, number] | [number, number, number])[];
+    bbox?: [number, number, number, number] | undefined;
 }, {
     type: "LineString";
-    coordinates: [number, number][];
+    coordinates: ([number, number] | [number, number, number])[];
+    bbox?: [number, number, number, number] | undefined;
 }>;
 export type GeoJsonLineString = z.infer<typeof geoJsonLineStringSchema>;
 /**
  * MultiLineString geometry object.
+ * Each inner array is a LineString coordinate array (>= 2 positions per RFC 7946 Section 3.1.5).
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
  * https://tools.ietf.org/html/rfc7946#section-3.1.5
  */
 export declare const geoJsonMultiLineStringSchema: z.ZodObject<{
     type: z.ZodLiteral<"MultiLineString">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
-}, "strict", z.ZodTypeAny, {
+    coordinates: z.ZodArray<z.ZodArray<z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>, "many">, "many">;
+    bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+}, "strip", z.ZodTypeAny, {
     type: "MultiLineString";
-    coordinates: [number, number][][];
+    coordinates: ([number, number] | [number, number, number])[][];
+    bbox?: [number, number, number, number] | undefined;
 }, {
     type: "MultiLineString";
-    coordinates: [number, number][][];
+    coordinates: ([number, number] | [number, number, number])[][];
+    bbox?: [number, number, number, number] | undefined;
 }>;
 export type GeoJsonMultiLineString = z.infer<typeof geoJsonMultiLineStringSchema>;
 /**
@@ -78,99 +116,139 @@ export type GeoJsonMultiLineString = z.infer<typeof geoJsonMultiLineStringSchema
       area it bounds, i.e., exterior rings are counterclockwise, and
       holes are clockwise
  */
-export declare const geoJsonLinearRingSchema: z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>;
+export declare const geoJsonLinearRingSchema: z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>, "many">, ([number, number] | [number, number, number])[], ([number, number] | [number, number, number])[]>;
 export type GeoJsonLinearRing = z.infer<typeof geoJsonLinearRingSchema>;
 /**
  * Polygon geometry object.
+ * Must have at least one ring (the exterior ring) per RFC 7946 Section 3.1.6.
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
  * https://tools.ietf.org/html/rfc7946#section-3.1.6
  */
 export declare const geoJsonPolygonSchema: z.ZodObject<{
     type: z.ZodLiteral<"Polygon">;
-    coordinates: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">;
-}, "strict", z.ZodTypeAny, {
+    coordinates: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>, "many">, ([number, number] | [number, number, number])[], ([number, number] | [number, number, number])[]>, "many">;
+    bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+}, "strip", z.ZodTypeAny, {
     type: "Polygon";
-    coordinates: [number, number][][];
+    coordinates: ([number, number] | [number, number, number])[][];
+    bbox?: [number, number, number, number] | undefined;
 }, {
     type: "Polygon";
-    coordinates: [number, number][][];
+    coordinates: ([number, number] | [number, number, number])[][];
+    bbox?: [number, number, number, number] | undefined;
 }>;
 export type GeoJsonPolygon = z.infer<typeof geoJsonPolygonSchema>;
 /**
  * MultiPolygon geometry object.
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
  * https://tools.ietf.org/html/rfc7946#section-3.1.7
  */
 export declare const geoJsonMultiPolygonSchema: z.ZodObject<{
     type: z.ZodLiteral<"MultiPolygon">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">, "many">;
-}, "strict", z.ZodTypeAny, {
+    coordinates: z.ZodArray<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>, "many">, ([number, number] | [number, number, number])[], ([number, number] | [number, number, number])[]>, "many">, "many">;
+    bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+}, "strip", z.ZodTypeAny, {
     type: "MultiPolygon";
-    coordinates: [number, number][][][];
+    coordinates: ([number, number] | [number, number, number])[][][];
+    bbox?: [number, number, number, number] | undefined;
 }, {
     type: "MultiPolygon";
-    coordinates: [number, number][][][];
+    coordinates: ([number, number] | [number, number, number])[][][];
+    bbox?: [number, number, number, number] | undefined;
 }>;
 export type GeoJsonMultiPolygon = z.infer<typeof geoJsonMultiPolygonSchema>;
-export declare const geoJsonGeometrySchema: z.ZodUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"Point">;
-    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
-}, "strict", z.ZodTypeAny, {
-    type: "Point";
-    coordinates: [number, number];
-}, {
-    type: "Point";
-    coordinates: [number, number];
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"MultiPoint">;
-    coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">;
-}, "strict", z.ZodTypeAny, {
-    type: "MultiPoint";
-    coordinates: [number, number][];
-}, {
-    type: "MultiPoint";
-    coordinates: [number, number][];
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"LineString">;
-    coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">;
-}, "strict", z.ZodTypeAny, {
-    type: "LineString";
-    coordinates: [number, number][];
-}, {
-    type: "LineString";
-    coordinates: [number, number][];
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"MultiLineString">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
-}, "strict", z.ZodTypeAny, {
-    type: "MultiLineString";
-    coordinates: [number, number][][];
-}, {
-    type: "MultiLineString";
-    coordinates: [number, number][][];
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"Polygon">;
-    coordinates: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">;
-}, "strict", z.ZodTypeAny, {
-    type: "Polygon";
-    coordinates: [number, number][][];
-}, {
-    type: "Polygon";
-    coordinates: [number, number][][];
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"MultiPolygon">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">, "many">;
-}, "strict", z.ZodTypeAny, {
-    type: "MultiPolygon";
-    coordinates: [number, number][][][];
-}, {
-    type: "MultiPolygon";
-    coordinates: [number, number][][][];
-}>]>;
-export type GeoJsonGeometry = z.infer<typeof geoJsonGeometrySchema>;
 /**
- * 2D bounding box of the GeoJSON object.
- * The value of the Bbox member is an array of length 4.
+ * GeometryCollection and the recursive Geometry union type.
  *
- * [min_lon, min_lat, max_lon, max_lat]
+ * RFC 7946 Section 3.1.8: GeometryCollection contains a "geometries" array
+ * of Geometry objects. Because this is recursive (a GeometryCollection can
+ * contain other GeometryCollections), the types are defined manually to
+ * break the circular z.infer chain.
  */
-export declare const geoJsonBboxSchema: z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>;
-export type GeoJsonBbox = z.infer<typeof geoJsonBboxSchema>;
+export type GeoJsonGeometryCollection = {
+    readonly type: "GeometryCollection";
+    readonly geometries: ReadonlyArray<GeoJsonGeometry>;
+    readonly bbox?: GeoJsonBbox;
+};
+export type GeoJsonGeometry = z.infer<typeof geoJsonPointSchema> | z.infer<typeof geoJsonMultiPointSchema> | z.infer<typeof geoJsonLineStringSchema> | z.infer<typeof geoJsonMultiLineStringSchema> | z.infer<typeof geoJsonPolygonSchema> | z.infer<typeof geoJsonMultiPolygonSchema> | GeoJsonGeometryCollection;
+/**
+ * GeometryCollection schema.
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
+ */
+export declare const geoJsonGeometryCollectionSchema: z.ZodType<GeoJsonGeometryCollection>;
+export declare const geoJsonGeometrySchema: z.ZodType<GeoJsonGeometry>;
+/**
+ * Feature object.
+ * Geometry may be null for unlocated features (RFC 7946 Section 3.2).
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
+ * https://tools.ietf.org/html/rfc7946#section-3.2
+ */
+export declare const geoJsonFeatureSchema: z.ZodObject<{
+    type: z.ZodLiteral<"Feature">;
+    geometry: z.ZodNullable<z.ZodType<GeoJsonGeometry, z.ZodTypeDef, GeoJsonGeometry>>;
+    properties: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "Feature";
+    geometry: GeoJsonGeometry | null;
+    properties: Record<string, unknown> | null;
+    bbox?: [number, number, number, number] | undefined;
+    id?: string | number | undefined;
+}, {
+    type: "Feature";
+    geometry: GeoJsonGeometry | null;
+    properties: Record<string, unknown> | null;
+    bbox?: [number, number, number, number] | undefined;
+    id?: string | number | undefined;
+}>;
+export type GeoJsonFeature = z.infer<typeof geoJsonFeatureSchema>;
+/**
+ * FeatureCollection object.
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
+ * https://tools.ietf.org/html/rfc7946#section-3.3
+ */
+export declare const geoJsonFeatureCollectionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"FeatureCollection">;
+    features: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"Feature">;
+        geometry: z.ZodNullable<z.ZodType<GeoJsonGeometry, z.ZodTypeDef, GeoJsonGeometry>>;
+        properties: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "Feature";
+        geometry: GeoJsonGeometry | null;
+        properties: Record<string, unknown> | null;
+        bbox?: [number, number, number, number] | undefined;
+        id?: string | number | undefined;
+    }, {
+        type: "Feature";
+        geometry: GeoJsonGeometry | null;
+        properties: Record<string, unknown> | null;
+        bbox?: [number, number, number, number] | undefined;
+        id?: string | number | undefined;
+    }>, "many">;
+    bbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>, [number, number, number, number], [number, number, number, number]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "FeatureCollection";
+    features: {
+        type: "Feature";
+        geometry: GeoJsonGeometry | null;
+        properties: Record<string, unknown> | null;
+        bbox?: [number, number, number, number] | undefined;
+        id?: string | number | undefined;
+    }[];
+    bbox?: [number, number, number, number] | undefined;
+}, {
+    type: "FeatureCollection";
+    features: {
+        type: "Feature";
+        geometry: GeoJsonGeometry | null;
+        properties: Record<string, unknown> | null;
+        bbox?: [number, number, number, number] | undefined;
+        id?: string | number | undefined;
+    }[];
+    bbox?: [number, number, number, number] | undefined;
+}>;
+export type GeoJsonFeatureCollection = z.infer<typeof geoJsonFeatureCollectionSchema>;

package/src/GeoJsonUtils.d.ts

@@ -1,18 +1,11 @@
 import { GeoJsonBbox, GeoJsonLinearRing, GeoJsonMultiPolygon, GeoJsonPoint, GeoJsonPolygon, GeoJsonPosition } from "./GeoJsonSchemas";
-import { TuGeoJsonPolygonNoHoles } from "./TuGeoJsonSchemas";
 export declare const EARTH_RADIUS = 6378137;
-export interface TuCoordinate {
-    longitude: number;
-    latitude: number;
-}
-interface TuBoundingBox {
-    nw: TuCoordinate;
-    se: TuCoordinate;
-}
 /**
- * @description Creates a polygon (with no holes) from a bounding box.
+ * @description Creates a polygon from a bounding box.
+ * Handles antimeridian-crossing bboxes (where west > east) by splitting into
+ * a MultiPolygon with one polygon per hemisphere.
  */
-export declare const getPolygonFromBbox: (bbox: GeoJsonBbox) => TuGeoJsonPolygonNoHoles;
+export declare const getPolygonFromBbox: (bbox: GeoJsonBbox) => GeoJsonPolygon | GeoJsonMultiPolygon;
 /**
  * @description Creates a bounding box from a GeoJSON Polygon or MultiPolygon.
  * Handles cases where the polygon crosses the 180/-180 meridian.
@@ -20,26 +13,15 @@ export declare const getPolygonFromBbox: (bbox: GeoJsonBbox) => TuGeoJsonPolygon
 export declare const getBboxFromGeoJsonPolygon: (polygon: GeoJsonPolygon | GeoJsonMultiPolygon) => GeoJsonBbox | null;
 /**
  * @description Creates a round polygon from a point and a radius.
+ * Handles antimeridian crossing per RFC 7946 Section 3.1.9 by splitting
+ * into a MultiPolygon. Clamps polar latitudes to [-90, 90].
+ *
+ * Returns null when the polygon crosses the antimeridian but both hemisphere
+ * intersections yield zero polygons (e.g. very small polygons near the
+ * dateline). In that case, returning the original coordinates would produce
+ * invalid geometry per RFC 7946.
  */
-export declare const getPolygonFromPointAndRadius: (point: GeoJsonPoint, radius: number) => GeoJsonPolygon;
-/**
- * @description Creates a TU bounding box from a GeoJson Polygon.
- * Handles cases where the polygon crosses the 180/-180 meridian.
- */
-export declare const getBoundingBoxFromGeoJsonPolygon: (polygon: GeoJsonPolygon | GeoJsonMultiPolygon) => TuBoundingBox | null;
-/**
- * @description Creates a GeoJSON MultiPolygon from a TU bounding box.
- * It has to return a MultiPolygon because the polygon may cross the 180/-180 meridian
- * and we need to avoid the polygon being ambiguous about which side of the meridian it wraps around.
- * so if it crosses the meridian, we return a MultiPolygon with two polygons, one for the western hemisphere and one for the eastern hemisphere.
- * @param boundingBox The bounding box to create a polygon from
- * @returns {GeoJsonMultiPolygon | GeoJsonPolygon} The polygon created from the bounding box
- */
-export declare const getGeoJsonPolygonFromBoundingBox: (boundingBox: TuBoundingBox) => GeoJsonMultiPolygon | GeoJsonPolygon;
-/**
- * @description Creates TU point coordinate from a GeoJSON Point.
- */
-export declare const getPointCoordinateFromGeoJsonPoint: (point: GeoJsonPoint) => TuCoordinate;
+export declare const getPolygonFromPointAndRadius: (point: GeoJsonPoint, radius: number) => GeoJsonPolygon | GeoJsonMultiPolygon | null;
 /**
  * @description Gets the extreme point of a polygon in a given direction.
  * @param {object} params - The parameters object
@@ -60,27 +42,22 @@ export declare const isGeoJsonPositionInLinearRing: ({ position, linearRing, }:
 }) => boolean | null;
 /**
  * @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.
  */
 export declare const isGeoJsonPointInPolygon: ({ point, polygon, }: {
     point: GeoJsonPoint;
     polygon: GeoJsonPolygon;
 }) => boolean | null;
 /**
- * Checks if polygon1/multi-polygon1 is fully contained within polygon2/multi-polygon2
+ * Checks if polygon1 is fully contained within polygon2.
+ * Correctly handles holes per RFC 7946 Section 3.1.6: a polygon inside
+ * a hole of polygon2 is NOT considered contained.
  */
 export declare const isFullyContainedInGeoJsonPolygon: (polygon1: GeoJsonPolygon, polygon2: GeoJsonPolygon) => boolean | null;
 /**
  * @description Gets the intersection between two GeoJSON polygons/multi-polygons.
  * Returns a MultiPolygon representing the intersection, or null if there is no intersection.
- * @param polygon1 The first polygon/multi-polygon to check intersection
- * @param polygon2 The second polygon/multi-polygon to check intersection
- * @returns {(GeoJsonMultiPolygon | GeoJsonPolygon)} The intersection as either a Polygon or MultiPolygon
  */
 export declare const getGeoJsonPolygonIntersection: (polygon1: GeoJsonPolygon | GeoJsonMultiPolygon, polygon2: GeoJsonPolygon | GeoJsonMultiPolygon) => GeoJsonMultiPolygon | GeoJsonPolygon | null;
-/**
- * @description Creates a TU bounding box from a GeoJSON Bbox.
- * @param bbox The GeoJSON Bbox to create a TU bounding box from
- * @returns {TuBoundingBox} The TU bounding box created from the GeoJSON Bbox
- */
-export declare const getBoundingBoxFromGeoJsonBbox: (bbox: GeoJsonBbox) => TuBoundingBox;
-export {};

package/src/{TUGeoJsonObjectBridgeUtils.d.ts → TuGeoJsonBridgeUtils.d.ts}

@@ -16,7 +16,7 @@ interface GeoJsonFeature {
  * @param inconsistentCoordinates Single point, array of points or nested array of points
  * @returns {GeoJsonPosition[]} Array of standardized coordinates
  */
-export declare const coordinatesToStandardFormat: (inconsistentCoordinates: GeoJsonPosition | Array<GeoJsonPosition> | Array<Array<GeoJsonPosition>> | null | undefined) => [number, number][];
+export declare const coordinatesToStandardFormat: (inconsistentCoordinates: GeoJsonPosition | Array<GeoJsonPosition> | Array<Array<GeoJsonPosition>> | null | undefined) => ([number, number] | [number, number, number])[];
 /**
  * @description Extracts a point coordinate from a GeoJSON object.
  * @param geoObject A GeoJSON object.

package/src/TuGeoJsonConversions.d.ts

@@ -0,0 +1,42 @@
+import { GeoJsonBbox, GeoJsonMultiPolygon, GeoJsonPoint, GeoJsonPolygon, GeoJsonPosition, GeoJsonPosition2d } from "./GeoJsonSchemas";
+/**
+ * @description Converts a GeoJSON position (which may have altitude) to a 2D position.
+ */
+export declare const toPosition2d: (position: GeoJsonPosition) => GeoJsonPosition2d;
+export interface TuCoordinate {
+    longitude: number;
+    latitude: number;
+}
+export interface TuBoundingBox {
+    nw: TuCoordinate;
+    se: TuCoordinate;
+}
+/**
+ * @description Creates a TU bounding box from a GeoJson Polygon.
+ * Handles cases where the polygon crosses the 180/-180 meridian.
+ */
+export declare const getBoundingBoxFromGeoJsonPolygon: (polygon: GeoJsonPolygon | GeoJsonMultiPolygon) => TuBoundingBox | null;
+/**
+ * @description Creates a GeoJSON Polygon or MultiPolygon from a TU bounding box.
+ * Returns a MultiPolygon when the bounding box crosses the 180/-180 meridian,
+ * with one polygon per hemisphere.
+ *
+ * Returns a 2D-only coordinate type since bounding boxes have no altitude.
+ * The return type is assignable to both GeoJsonPolygon | GeoJsonMultiPolygon
+ * (for GeoJSON consumers) and GraphQL AreaInput (for query variables).
+ */
+export declare const getGeoJsonPolygonFromBoundingBox: (boundingBox: TuBoundingBox) => {
+    type: "MultiPolygon";
+    coordinates: Array<Array<Array<GeoJsonPosition2d>>>;
+} | {
+    type: "Polygon";
+    coordinates: Array<Array<GeoJsonPosition2d>>;
+};
+/**
+ * @description Creates TU point coordinate from a GeoJSON Point.
+ */
+export declare const getPointCoordinateFromGeoJsonPoint: (point: GeoJsonPoint) => TuCoordinate;
+/**
+ * @description Creates a TU bounding box from a GeoJSON Bbox.
+ */
+export declare const getBoundingBoxFromGeoJsonBbox: (bbox: GeoJsonBbox) => TuBoundingBox;

package/src/TuGeoJsonSchemas.d.ts

@@ -4,16 +4,17 @@ import { z } from "zod";
  *
  * Same as geoJsonPolygonSchema but type disallows holes by
  * using tuple of one single linear ring instead of an array.
+ * Foreign members (RFC 7946 Section 6.1) are stripped during parse.
  */
 export declare const tuGeoJsonPolygonNoHolesSchema: z.ZodObject<{
     type: z.ZodLiteral<"Polygon">;
-    coordinates: z.ZodTuple<[z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>], null>;
-}, "strict", z.ZodTypeAny, {
+    coordinates: z.ZodTuple<[z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>, "many">, ([number, number] | [number, number, number])[], ([number, number] | [number, number, number])[]>], null>;
+}, "strip", z.ZodTypeAny, {
     type: "Polygon";
-    coordinates: [[number, number][]];
+    coordinates: [([number, number] | [number, number, number])[]];
 }, {
     type: "Polygon";
-    coordinates: [[number, number][]];
+    coordinates: [([number, number] | [number, number, number])[]];
 }>;
 export type TuGeoJsonPolygonNoHoles = z.infer<typeof tuGeoJsonPolygonNoHolesSchema>;
 /**
@@ -21,38 +22,40 @@ export type TuGeoJsonPolygonNoHoles = z.infer<typeof tuGeoJsonPolygonNoHolesSche
  * For when you wish to define an area by a point and a radius.
  *
  * radius is in meters
+ * Foreign members are stripped during parse.
  */
 export declare const tuGeoJsonPointRadiusSchema: z.ZodObject<{
     type: z.ZodLiteral<"PointRadius">;
-    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    coordinates: z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>;
     radius: z.ZodNumber;
-}, "strict", z.ZodTypeAny, {
+}, "strip", z.ZodTypeAny, {
     type: "PointRadius";
-    coordinates: [number, number];
+    coordinates: [number, number] | [number, number, number];
     radius: number;
 }, {
     type: "PointRadius";
-    coordinates: [number, number];
+    coordinates: [number, number] | [number, number, number];
     radius: number;
 }>;
 export type TuGeoJsonPointRadius = z.infer<typeof tuGeoJsonPointRadiusSchema>;
 /**
  * A Polygon with exactly 5 points and 4 horizontal/vertical sides that form a normal rectangular box.
+ * Foreign members are stripped during parse.
  */
 export declare const tuGeoJsonRectangularBoxPolygonSchema: z.ZodEffects<z.ZodObject<{
     type: z.ZodLiteral<"Polygon">;
-    coordinates: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">;
-}, "strict", z.ZodTypeAny, {
+    coordinates: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, [number, number] | [number, number, number], [number, number] | [number, number, number]>, "many">, ([number, number] | [number, number, number])[], ([number, number] | [number, number, number])[]>, "many">;
+}, "strip", z.ZodTypeAny, {
     type: "Polygon";
-    coordinates: [number, number][][];
+    coordinates: ([number, number] | [number, number, number])[][];
 }, {
     type: "Polygon";
-    coordinates: [number, number][][];
+    coordinates: ([number, number] | [number, number, number])[][];
 }>, {
     type: "Polygon";
-    coordinates: [number, number][][];
+    coordinates: ([number, number] | [number, number, number])[][];
 }, {
     type: "Polygon";
-    coordinates: [number, number][][];
+    coordinates: ([number, number] | [number, number, number])[][];
 }>;
 export type TuGeoJsonRectangularBoxPolygon = z.infer<typeof tuGeoJsonRectangularBoxPolygonSchema>;

package/src/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./GeoJsonSchemas";
 export * from "./GeoJsonUtils";
-export * from "./meridianUtils";
-export * from "./TUGeoJsonObjectBridgeUtils";
+export * from "./MeridianUtils";
+export * from "./TuGeoJsonBridgeUtils";
+export * from "./TuGeoJsonConversions";
 export * from "./TuGeoJsonSchemas";