nodes2ts 4.0.1 → 4.0.2

package/dist/export.cjs

@@ -3350,6 +3350,13 @@ var UINT64_MAX = 0xFFFFFFFFFFFFFFFFn;
 
 // src/S2Projections.ts
 var _S2Projections = class _S2Projections {
+  /**
+   * The maximum value of an si- or ti-coordinate. The range of valid (si,ti) values is
+   * [0..MAX_SiTi].
+   */
+  static get MAX_SITI() {
+    return 1n << BigInt(_S2Projections.MAX_LEVEL + 1);
+  }
   static getUNorm(face, u) {
     switch (face) {
       case 0:
@@ -3590,11 +3597,6 @@ _S2Projections.XYZ_TRANSFORMS = [
     }
   }
 ];
-/**
- * The maximum value of an si- or ti-coordinate. The range of valid (si,ti) values is
- * [0..MAX_SiTi].
- */
-_S2Projections.MAX_SITI = 1n << BigInt(_S2Projections.MAX_LEVEL + 1);
 var S2Projections = _S2Projections;
 
 // src/S2CellId.ts
@@ -4242,10 +4244,20 @@ _S2CellId.FACE_BITS = 3;
 _S2CellId.NUM_FACES = 6;
 _S2CellId.MAX_LEVEL = 30;
 // Valid levels: 0..MAX_LEVEL
-_S2CellId.POS_BITS = 2 * _S2CellId.MAX_LEVEL + 1;
-// 61
-_S2CellId.MAX_SIZE = 1 << _S2CellId.MAX_LEVEL;
-// 2^30
+/**
+ * The number of bits used by a position along the Hilbert curve over all
+ * faces (range 1..2*MAX_LEVEL+1). This is a fixed constant encoding the
+ * canonical 64-bit S2 cell ID layout; it must NEVER be derived from a
+ * mutable MAX_LEVEL.
+ */
+_S2CellId.POS_BITS = 2 * 30 + 1;
+// = 61
+/**
+ * The maximum coordinate value for an (i,j) cell index. Equal to 2^30.
+ * Fixed constant matching the 30-level S2 grid.
+ */
+_S2CellId.MAX_SIZE = 1 << 30;
+// = 1073741824
 /** Maximum unsigned 64-bit value (sentinel). */
 _S2CellId.MAX_UNSIGNED = UINT64_MAX;
 // The following lookup tables are used to convert efficiently between an
@@ -4269,6 +4281,10 @@ _S2CellId.LOOKUP_IJ = [];
  * This is the offset required to wrap around from the beginning of the
  * Hilbert curve to the end or vice versa; see next_wrap() and prev_wrap().
  */
+/**
+ * Precomputed wrap offset. Fixed constant; must not be derived from a
+ * mutable POS_BITS.
+ */
 _S2CellId.WRAP_OFFSET = BigInt(_S2CellId.NUM_FACES) << BigInt(_S2CellId.POS_BITS);
 var S2CellId = _S2CellId;
 function initLookupCell(level, i, j, origOrientation, pos, orientation) {
@@ -4333,6 +4349,9 @@ var _S2Cell = class _S2Cell {
       this.init(cellID);
     }
   }
+  static get MAX_CELL_SIZE() {
+    return 1 << S2CellId.MAX_LEVEL;
+  }
   get id() {
     return this.cellID;
   }
@@ -4622,7 +4641,6 @@ var _S2Cell = class _S2Cell {
     };
   }
 };
-_S2Cell.MAX_CELL_SIZE = 1 << S2CellId.MAX_LEVEL;
 // We grow the bounds slightly to make sure that the bounding rectangle
 // also contains the normalized versions of the vertices. Note that the
 // maximum result magnitude is Pi, with a floating-point exponent of 1.
@@ -5302,6 +5320,41 @@ var QueueEntry = class {
 
 // src/export.ts
 var Utils = class {
+  /**
+   * Atomically updates the maximum cell level across all S2 classes.
+   *
+   * This sets the `MAX_LEVEL` field on `S2`, `S2CellId`, and `S2Projections`
+   * in one call, keeping them in sync.
+   *
+   * **What changes:**
+   * - `S2Cell.MAX_CELL_SIZE` (derived via getter from `S2CellId.MAX_LEVEL`)
+   * - `S2Projections.MAX_SITI` (derived via getter)
+   * - `S2CellId.getSizeIJ()` / `S2CellId.getSizeST()` size calculations
+   * - Default max-level caps in `S2RegionCoverer` and `S2Metric`
+   * - `S2CellId.isLeaf()` / `level()` detection of the leaf level
+   *
+   * **What does NOT change:**
+   * - `S2CellId.POS_BITS` (always 61) — the 64-bit S2 cell ID bit layout is
+   *   a fixed canonical format; changing it breaks encoding/decoding.
+   * - `S2CellId.MAX_SIZE` (always 2^30) — the Hilbert-curve grid resolution.
+   * - `S2CellId.WRAP_OFFSET` — derived from the fixed `POS_BITS`.
+   *
+   * For shorter cell tokens, use `parentL(desiredLevel)` or set
+   * `S2RegionCoverer.maxLevel`; `toToken()` naturally produces compact hex
+   * strings for lower-level cells (e.g. level 10 → 6 hex chars).
+   *
+   * @param level — integer in [1, 30]
+   */
+  static setMaxLevel(level) {
+    if (!Number.isInteger(level) || level < 1 || level > 30) {
+      throw new RangeError(
+        `MAX_LEVEL must be an integer in [1, 30], got ${level}`
+      );
+    }
+    S2.MAX_LEVEL = level;
+    S2CellId.MAX_LEVEL = level;
+    S2Projections.MAX_LEVEL = level;
+  }
   /**
    * Calculates a region covering a circle
    * NOTE: The current implementation uses S2Cap while S2Loop would be better (S2Loop is not implemented yet)