nodes2ts 4.0.0 → 4.0.1

package/dist/export.cjs

@@ -3600,14 +3600,33 @@ var S2Projections = _S2Projections;
 // src/S2CellId.ts
 var _S2CellId = class _S2CellId {
   /**
-   * Construct an S2CellId from a bigint or decimal string.
+   * Construct an S2CellId from a bigint, decimal string, or number.
    *
    * The string may be signed ("-6533045114107854848") or unsigned
    * ("11913698959601696768"); both are handled via BigInt.asUintN(64, ...).
+   *
+   * Numbers must be finite integers within the safe-integer range
+   * (|n| ≤ Number.MAX_SAFE_INTEGER = 2^53 − 1). Values outside that range
+   * may have silently lost precision in JS before reaching this constructor,
+   * so a RangeError is thrown. Use a bigint literal for large cell IDs
+   * (e.g. `-9182983676231680000n`).
+   *
+   * @throws {TypeError}  if `id` is a non-integer or non-finite number.
+   * @throws {RangeError} if `id` exceeds safe-integer precision (> 2^53 − 1).
    */
   constructor(id) {
     if (typeof id === "string") {
       this.id = BigInt.asUintN(64, BigInt(id));
+    } else if (typeof id === "number") {
+      if (!Number.isInteger(id) || !isFinite(id)) {
+        throw new TypeError(`S2CellId: non-integer or non-finite number: ${id}`);
+      }
+      if (!Number.isSafeInteger(id)) {
+        throw new RangeError(
+          `S2CellId: number ${id} exceeds safe integer precision (> 2^53). Use a bigint literal instead, e.g. ${BigInt(id)}n`
+        );
+      }
+      this.id = BigInt.asUintN(64, BigInt(id));
     } else {
       this.id = BigInt.asUintN(64, id);
     }
@@ -4191,7 +4210,7 @@ var _S2CellId = class _S2CellId {
    * Binary search in a sorted S2CellId array.
    * Returns index if found, or -(insertionPoint+1) if not found.
    *
-   * v4: `_id` accepts bigint, string, or S2CellId (was Long, string, or S2CellId).
+   * v4: `_id` accepts bigint, string, number, or S2CellId (was Long, string, or S2CellId).
    */
   static binarySearch(ids, _id, low = 0) {
     let id;
@@ -4628,7 +4647,7 @@ var S2CellUnion = class {
    * Populates a cell union with the given S2CellIds or 64-bit cell ids, and
    * then calls Normalize().
    *
-   * v4: `cellIds` accepts `bigint[] | string[]` (was `Long[] | string[]`).
+   * v4: `cellIds` accepts `bigint[] | string[] | number[]` (was `Long[] | string[]`).
    */
   initFromIds(cellIds) {
     this.initRawIds(cellIds);