@developmentseed/deck.gl-raster 0.7.0-beta.1 → 0.8.0-beta.1

package/dist/raster-tileset/web-mercator-clamp.js

@@ -0,0 +1,54 @@
+import { triangulateRectangle } from "@developmentseed/raster-reproject";
+/** Maximum latitude representable in Web Mercator (EPSG:3857), in degrees. */
+const MAX_WEB_MERCATOR_LAT = 85.05112877980659;
+/** Tolerance for the north-up check and degenerate-band guard, in degrees. */
+const LAT_EPSILON = 1e-6;
+/**
+ * Compute a {@link InitialTriangulation} that clamps a tile's reprojection mesh
+ * to the latitude band representable in Web Mercator (±85.051°), or `undefined`
+ * if no clamp is needed or possible.
+ *
+ * Beyond ±85.051°, `makeClampedForwardTo3857` collapses every polar vertex onto
+ * the same clamped Y, so the reprojector emits degenerate near-pole triangles
+ * that never converge (see #182 / #351). Seeding the reprojector with the
+ * clamped band avoids meshing those rows entirely.
+ *
+ * Only **north-up geographic** tiles are handled — where latitude is constant
+ * across each row, so the valid band is an axis-aligned rectangle. Rotated or
+ * projected tiles return `undefined` (the caller falls back to the full mesh).
+ *
+ * @param cornerLats WGS84 latitudes of the tile's four corners.
+ * @param maxLat     Web Mercator latitude limit. Defaults to ±85.051°.
+ */
+export function createInitialWebMercatorTriangulation(cornerLats, maxLat = MAX_WEB_MERCATOR_LAT) {
+    const { topLeft, topRight, bottomLeft, bottomRight } = cornerLats;
+    // North-up means latitude is constant across each row, so the clamp band is
+    // an axis-aligned rectangle. Otherwise fall back to the full mesh.
+    const northUp = Math.abs(topLeft - topRight) < LAT_EPSILON &&
+        Math.abs(bottomLeft - bottomRight) < LAT_EPSILON;
+    if (!northUp) {
+        return undefined;
+    }
+    const north = topLeft;
+    const south = bottomLeft;
+    // Degenerate or south-up tile: leave it to the default full mesh.
+    if (north - south <= LAT_EPSILON) {
+        return undefined;
+    }
+    // Nothing to clamp if the whole tile is already within bounds.
+    if (north <= maxLat && south >= -maxLat) {
+        return undefined;
+    }
+    // v runs 0 (north) → 1 (south); lat(v) = north - v * (north - south).
+    const clamp01 = (t) => Math.max(0, Math.min(1, t));
+    const vTop = clamp01((north - maxLat) / (north - south));
+    const vBottom = clamp01((north - -maxLat) / (north - south));
+    // Fully-polar tile (entirely outside ±maxLat): empty band, nothing to render.
+    // Such tiles are normally excluded by the dataset-bounds clamp; guard anyway
+    // so we never emit a degenerate seed.
+    if (vBottom - vTop < LAT_EPSILON) {
+        return undefined;
+    }
+    return triangulateRectangle(0, vTop, 1, vBottom);
+}
+//# sourceMappingURL=web-mercator-clamp.js.map

package/dist/raster-tileset/web-mercator-clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-mercator-clamp.js","sourceRoot":"","sources":["../../src/raster-tileset/web-mercator-clamp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,8EAA8E;AAC9E,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAE/C,8EAA8E;AAC9E,MAAM,WAAW,GAAG,IAAI,CAAC;AAYzB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qCAAqC,CACnD,UAA2B,EAC3B,SAAiB,oBAAoB;IAErC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC;IAElE,4EAA4E;IAC5E,mEAAmE;IACnE,MAAM,OAAO,GACX,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,WAAW;QAC1C,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,WAAW,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC;IACtB,MAAM,KAAK,GAAG,UAAU,CAAC;IACzB,kEAAkE;IAClE,IAAI,KAAK,GAAG,KAAK,IAAI,WAAW,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+DAA+D;IAC/D,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,sEAAsE;IACtE,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;IAE7D,8EAA8E;IAC9E,6EAA6E;IAC7E,sCAAsC;IACtC,IAAI,OAAO,GAAG,IAAI,GAAG,WAAW,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@developmentseed/deck.gl-raster",
-  "version": "0.7.0-beta.1",
+  "version": "0.8.0-beta.1",
   "description": "Georeferenced image data visualization in deck.gl",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,10 +40,10 @@
   "devDependencies": {
     "@luma.gl/core": "^9.3.2",
     "@luma.gl/shadertools": "^9.3.2",
-    "@types/node": "^25.6.0",
+    "@types/node": "^25.9.1",
     "jsdom": "^29.1.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
     "@deck.gl/core": "^9.3.0",
@@ -52,15 +52,15 @@
     "@deck.gl/mesh-layers": "^9.3.0",
     "@luma.gl/core": "^9.3.2",
     "@luma.gl/shadertools": "^9.3.2",
-    "@developmentseed/morecantile": "^0.7.0-beta.1"
+    "@developmentseed/morecantile": "^0.8.0-beta.1"
   },
   "dependencies": {
     "@math.gl/core": "^4.1.0",
     "@math.gl/culling": "^4.1.0",
     "@math.gl/web-mercator": "^4.1.0",
-    "@developmentseed/affine": "^0.7.0-beta.1",
-    "@developmentseed/proj": "^0.7.0-beta.1",
-    "@developmentseed/raster-reproject": "^0.7.0-beta.1"
+    "@developmentseed/affine": "^0.8.0-beta.1",
+    "@developmentseed/proj": "^0.8.0-beta.1",
+    "@developmentseed/raster-reproject": "^0.8.0-beta.1"
   },
   "volta": {
     "extends": "../../package.json"

package/dist/raster-tile-layer/constants.d.ts

@@ -1,11 +0,0 @@
-/** Size of deck.gl's common coordinate space in world units.
- *
- * At zoom 0, one tile covers the whole world (512×512 units); at zoom z, each
- * tile is 512/2^z units.
- */
-export declare const TILE_SIZE = 512;
-/** Size of the globe in web mercator meters. */
-export declare const WEB_MERCATOR_METER_CIRCUMFERENCE = 40075016.686;
-/** Scale factor for converting EPSG:3857 meters into deck.gl world units (512×512). */
-export declare const WEB_MERCATOR_TO_WORLD_SCALE: number;
-//# sourceMappingURL=constants.d.ts.map

package/dist/raster-tile-layer/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/raster-tile-layer/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,gDAAgD;AAChD,eAAO,MAAM,gCAAgC,eAAe,CAAC;AAE7D,uFAAuF;AACvF,eAAO,MAAM,2BAA2B,QACM,CAAC"}

package/dist/raster-tile-layer/constants.js

@@ -1,11 +0,0 @@
-/** Size of deck.gl's common coordinate space in world units.
- *
- * At zoom 0, one tile covers the whole world (512×512 units); at zoom z, each
- * tile is 512/2^z units.
- */
-export const TILE_SIZE = 512;
-/** Size of the globe in web mercator meters. */
-export const WEB_MERCATOR_METER_CIRCUMFERENCE = 40075016.686;
-/** Scale factor for converting EPSG:3857 meters into deck.gl world units (512×512). */
-export const WEB_MERCATOR_TO_WORLD_SCALE = TILE_SIZE / WEB_MERCATOR_METER_CIRCUMFERENCE;
-//# sourceMappingURL=constants.js.map

package/dist/raster-tile-layer/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/raster-tile-layer/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,gDAAgD;AAChD,MAAM,CAAC,MAAM,gCAAgC,GAAG,YAAY,CAAC;AAE7D,uFAAuF;AACvF,MAAM,CAAC,MAAM,2BAA2B,GACtC,SAAS,GAAG,gCAAgC,CAAC"}