mapcode-ts 1.0.0 → 1.0.1

package/NOTICE

@@ -0,0 +1,8 @@
+-------------------------------------------------------------------------------
+MAPCODE TYPESCRIPT LIBRARY
+-------------------------------------------------------------------------------
+
+Original C library created by Pieter Geelen. Work on TypeScript version
+of the Mapcode library by Rijn Buve.
+
+Copyright (C) 2014-2026, Stichting Mapcode Foundation (http://www.mapcode.com)

package/README.md

@@ -11,7 +11,7 @@ This is a faithful TypeScript port of the [mapcode-java](https://github.com/mapc
 (version 2.4.19).
 
 Licensed under the [Apache License, Version 2.0](LICENSE).
-Copyright (C) 2014-2024, Stichting Mapcode Foundation. 
+Copyright (C) 2014-2026, Stichting Mapcode Foundation. 
 
 ---
 
@@ -101,8 +101,8 @@ console.log(t.getFullName());     // "Netherlands"
 
 // Request a mapcode rendered in a specific alphabet:
 const m = encodeToShortest(37.9715, 23.7263, Territory.GRC);
-console.log(m.getCode());                         // Roman: "ΗΠ.Θ2" (decoded from Unicode input)
-console.log(m.getCode(Alphabet.GREEK));           // Greek script
+console.log(m.getCode());                         // Roman: "HJ.Q5"
+console.log(m.getCode(Alphabet.GREEK));           // Greek script: "ΗΠ.485"
 ```
 
 ---

package/dist/index.cjs

@@ -1294,16 +1294,14 @@ var _Mapcode = class _Mapcode {
   }
   getCode(precisionOrAlphabet, alphabet) {
     const { precision, alpha } = _Mapcode.resolveArgs(precisionOrAlphabet, alphabet);
+    _Mapcode.checkPrecision(precision);
     if (precision === 0) {
       return convertStringToAlphabet(this.codePrecision8.substring(0, this.codePrecision8.length - 9), alpha);
-    } else if (precision <= 8) {
-      return convertStringToAlphabet(
-        this.codePrecision8.substring(0, this.codePrecision8.length - 8 + precision),
-        alpha
-      );
-    } else {
-      throw new IllegalArgumentError("getCodePrecision: precision must be in [0, 8]");
     }
+    return convertStringToAlphabet(
+      this.codePrecision8.substring(0, this.codePrecision8.length - 8 + precision),
+      alpha
+    );
   }
   getCodeWithTerritoryFullname(precisionOrAlphabet, alphabet) {
     const { precision, alpha } = _Mapcode.resolveArgs(precisionOrAlphabet, alphabet);
@@ -1332,6 +1330,11 @@ var _Mapcode = class _Mapcode {
     }
     return { precision: precisionOrAlphabet, alpha: alphabet ?? null };
   }
+  static checkPrecision(precision) {
+    if (!Number.isInteger(precision) || precision < 0 || precision > 8) {
+      throw new IllegalArgumentError("precision must be an integer in [0, 8]");
+    }
+  }
   /**
    * Return the mapcode precision format, given a mapcode string. Throws if the format is invalid.
    *
@@ -1380,9 +1383,7 @@ var _Mapcode = class _Mapcode {
    * Get a safe maximum for the distance between a decoded mapcode and its original location.
    */
   static getSafeMaxOffsetInMeters(precision) {
-    if (precision < 0 || precision > 8) {
-      throw new IllegalArgumentError("precision must be in [0, 8]");
-    }
+    _Mapcode.checkPrecision(precision);
     return _Mapcode.PRECISION_0_MAX_OFFSET_METERS[precision];
   }
   /**
@@ -3923,6 +3924,11 @@ var DATA_MODEL4 = DataModel.getInstance();
 var createBoundaryForTerritoryRecord2 = Boundary.createBoundaryForTerritoryRecord.bind(Boundary);
 var { X_SIDE, Y_SIDE, NC, xDivider, countCityCoordinatesForCountry, getFirstNamelessRecord } = Common;
 var ENCODE_CHARS2 = Data.ENCODE_CHARS;
+function checkFiniteCoordinate(param, value) {
+  if (!Number.isFinite(value)) {
+    throw new IllegalArgumentError(`Parameter ${param} must be a finite number`);
+  }
+}
 function encodeExtension(pointToEncode, extrax4, extray, dividerx4, dividery, ydirection) {
   let extraDigits = 8;
   let factorx = Point.MAX_PRECISION_FACTOR * dividerx4;
@@ -4243,6 +4249,8 @@ var Encoder = class {
   constructor() {
   }
   static encode(latDeg, lonDeg, territory, limitToOneResult) {
+    checkFiniteCoordinate("latDeg", latDeg);
+    checkFiniteCoordinate("lonDeg", lonDeg);
     return encodeInternal(latDeg, lonDeg, territory, limitToOneResult, null);
   }
 };
@@ -4284,7 +4292,7 @@ function encode(arg0, arg1, arg2) {
   if (arg0 instanceof Point) {
     const point = arg0;
     const restrictToTerritory2 = arg1 ?? null;
-    checkNonnull("point", point);
+    checkDefined("point", point);
     return encode(point.getLatDeg(), point.getLonDeg(), restrictToTerritory2);
   }
   const latDeg = arg0;
@@ -4398,6 +4406,11 @@ function decode2(mapcode, defaultTerritoryContext) {
 function decodeToRectangle(mapcode, defaultTerritoryContext) {
   checkNonnull("mapcode", mapcode);
   const mapcodeZone = decodeToMapcodeZone(mapcode, defaultTerritoryContext ?? null);
+  if (mapcodeZone.isEmpty()) {
+    throw new UnknownMapcodeError(
+      "Unknown mapcode, mapcode=" + mapcode + ", territoryContext=" + defaultTerritoryContext
+    );
+  }
   const southWest = Point.fromLatLonFractions(mapcodeZone.getLatFractionMin(), mapcodeZone.getLonFractionMin());
   const northEast = Point.fromLatLonFractions(mapcodeZone.getLatFractionMax(), mapcodeZone.getLonFractionMax());
   const rectangle = new Rectangle(southWest, northEast);