mapcode-ts 1.0.0 → 1.0.2

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];
   }
   /**
@@ -2349,7 +2350,7 @@ _Territory.LIE = new _Territory(24, "Liechtenstein", null, null, null, null);
 _Territory.ABW = new _Territory(25, "Aruba", null, null, null, null);
 _Territory.MHL = new _Territory(26, "Marshall Islands", null, null, ["WAK"], null);
 _Territory.ASM = new _Territory(27, "American Samoa", null, null, ["US-AS", "USA-AS"], ["Samoa, American"]);
-_Territory.COK = new _Territory(28, "Cook islands", null, null, null, null);
+_Territory.COK = new _Territory(28, "Cook Islands", null, null, null, null);
 _Territory.SPM = new _Territory(29, "Saint Pierre and Miquelon", null, null, null, ["Miquelon"]);
 _Territory.NIU = new _Territory(30, "Niue", null, null, null, null);
 _Territory.KNA = new _Territory(31, "Saint Kitts and Nevis", null, null, null, ["Nevis"]);
@@ -2410,11 +2411,11 @@ _Territory.BHS = new _Territory(85, "Bahamas", null, null, null, null);
 _Territory.TLS = new _Territory(86, "East Timor", [Alphabet.ROMAN, Alphabet.ARABIC], null, null, null);
 _Territory.SWZ = new _Territory(87, "Swaziland", null, null, null, null);
 _Territory.KWT = new _Territory(88, "Kuwait", [Alphabet.ARABIC, Alphabet.ROMAN], null, null, null);
-_Territory.FJI = new _Territory(89, "Fiji Islands", [Alphabet.ROMAN, Alphabet.DEVANAGARI], null, null, null);
+_Territory.FJI = new _Territory(89, "Republic of Fiji", [Alphabet.ROMAN, Alphabet.DEVANAGARI], null, null, null);
 _Territory.NCL = new _Territory(90, "New Caledonia", null, null, null, null);
 _Territory.SVN = new _Territory(91, "Slovenia", null, null, null, null);
 _Territory.ISR = new _Territory(92, "Israel", [Alphabet.HEBREW, Alphabet.ARABIC, Alphabet.ROMAN], null, null, null);
-_Territory.PSE = new _Territory(93, "Palestinian territory", [Alphabet.HEBREW, Alphabet.ARABIC, Alphabet.ROMAN], null, null, null);
+_Territory.PSE = new _Territory(93, "Palestine", [Alphabet.HEBREW, Alphabet.ARABIC, Alphabet.ROMAN], null, null, null);
 _Territory.SLV = new _Territory(94, "El Salvador", null, null, null, null);
 _Territory.BLZ = new _Territory(95, "Belize", null, null, null, null);
 _Territory.DJI = new _Territory(96, "Djibouti", [Alphabet.ARABIC, Alphabet.ROMAN], null, null, null);
@@ -2721,7 +2722,7 @@ _Territory.CA_ON = new _Territory(396, "Ontario", null, _Territory.CAN, null, nu
 _Territory.CA_QC = new _Territory(397, "Quebec", null, _Territory.CAN, null, null);
 _Territory.CA_SK = new _Territory(398, "Saskatchewan", null, _Territory.CAN, null, null);
 _Territory.CA_MB = new _Territory(399, "Manitoba", null, _Territory.CAN, null, null);
-_Territory.CA_NL = new _Territory(400, "Newfoundland", null, _Territory.CAN, null, null);
+_Territory.CA_NL = new _Territory(400, "Newfoundland and Labrador", null, _Territory.CAN, null, null);
 _Territory.CA_NB = new _Territory(401, "New Brunswick", null, _Territory.CAN, null, null);
 _Territory.CA_NS = new _Territory(402, "Nova Scotia", null, _Territory.CAN, null, null);
 _Territory.CA_PE = new _Territory(403, "Prince Edward Island", null, _Territory.CAN, null, null);
@@ -2731,7 +2732,7 @@ _Territory.CA_NU = new _Territory(406, "Nunavut", null, _Territory.CAN, null, nu
 _Territory.RU_MOW = new _Territory(412, "Moscow", [Alphabet.CYRILLIC, Alphabet.ROMAN], _Territory.RUS, null, null);
 _Territory.RU_SPE = new _Territory(413, "Saint Petersburg", [Alphabet.CYRILLIC, Alphabet.ROMAN], _Territory.RUS, null, null);
 _Territory.RU_KGD = new _Territory(414, "Kaliningrad Oblast", [Alphabet.CYRILLIC, Alphabet.ROMAN], _Territory.RUS, null, null);
-_Territory.RU_IN = new _Territory(415, "Ingushetia Republic", [Alphabet.CYRILLIC, Alphabet.ROMAN], _Territory.RUS, null, null);
+_Territory.RU_IN = new _Territory(415, "Republic of Ingushetia", [Alphabet.CYRILLIC, Alphabet.ROMAN], _Territory.RUS, null, null);
 _Territory.RU_AD = new _Territory(416, "Adygea Republic", [Alphabet.CYRILLIC, Alphabet.ROMAN], _Territory.RUS, null, null);
 _Territory.RU_SE = new _Territory(417, "North Ossetia-Alania Republic", [Alphabet.CYRILLIC, Alphabet.ROMAN], _Territory.RUS, null, null);
 _Territory.RU_KB = new _Territory(418, "Kabardino-Balkar Republic", [Alphabet.CYRILLIC, Alphabet.ROMAN], _Territory.RUS, null, null);
@@ -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);