@math.gl/geospatial 5.0.0-alpha.17 → 5.0.0-alpha.19

package/dist/projection/web-mercator.js

@@ -0,0 +1,113 @@
+import { validateScalarOutput, writeScalarOutput } from "./experimental/scalar-output.js";
+const RADIUS = 6378137;
+const RADIANS = Math.PI / 180;
+const FLOAT32_MAX = 3.4028234663852886e38;
+function wrap(longitude) {
+    if (Math.abs(longitude) <= Math.PI)
+        return longitude;
+    const circle = 2 * Math.PI;
+    return ((((longitude + Math.PI) % circle) + circle) % circle) - Math.PI;
+}
+function crs(input) {
+    if (input === undefined)
+        return 'WGS84';
+    if (input === 'WGS84' || input === 'EPSG:4326' || input === 'EPSG:3857')
+        return input;
+    throw new Error('WebMercatorProjectionEngine supports only WGS84, EPSG:4326 and EPSG:3857');
+}
+/** Minimal WGS84 / EPSG:3857 factory, without CRS readers, grids or datum transforms. */
+export class WebMercatorProjectionEngine {
+    createProjection(options = {}) {
+        if (options.mode !== undefined && options.mode !== 'strict' && options.mode !== 'horizontal')
+            throw new Error('Invalid projection mode');
+        return new WebMercatorTransform(crs(options.from), crs(options.to));
+    }
+    async createProjectionAsync(options = {}) {
+        return this.createProjection(options);
+    }
+}
+class WebMercatorTransform {
+    constructor(from, to) {
+        this.from = from;
+        this.to = to;
+        this.lossy = false;
+        this.point = { x: 0, y: 0, z: 0 };
+        this.project = this.project.bind(this);
+        this.unproject = this.unproject.bind(this);
+        this.projectTo = this.projectTo.bind(this);
+        this.unprojectTo = this.unprojectTo.bind(this);
+        this.projectFlat = this.projectFlat.bind(this);
+        this.unprojectFlat = this.unprojectFlat.bind(this);
+        this.projectSync = this.project;
+        this.unprojectSync = this.unproject;
+        this.projectToSync = this.projectTo;
+        this.unprojectToSync = this.unprojectTo;
+        this.projectFlatSync = this.projectFlat;
+        this.unprojectFlatSync = this.unprojectFlat;
+    }
+    async preload() { }
+    project(coordinate) {
+        return this.projectTo(coordinate, new Array(coordinate.length));
+    }
+    unproject(coordinate) {
+        return this.unprojectTo(coordinate, new Array(coordinate.length));
+    }
+    projectTo(coordinate, output) {
+        return this.scalar(coordinate, output, this.from, this.to);
+    }
+    unprojectTo(coordinate, output) {
+        return this.scalar(coordinate, output, this.to, this.from);
+    }
+    projectFlat(coordinates, dimension = 2) {
+        return this.flat(coordinates, dimension, this.from, this.to);
+    }
+    unprojectFlat(coordinates, dimension = 2) {
+        return this.flat(coordinates, dimension, this.to, this.from);
+    }
+    run(x, y, z, from, to) {
+        if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z))
+            throw new Error('Projection requires finite XYZ coordinates');
+        if (from !== 'EPSG:3857' && Math.abs(y) > 90)
+            throw new Error('Coordinate outside geographic domain');
+        if (from !== to && !(from !== 'EPSG:3857' && to !== 'EPSG:3857')) {
+            if (from === 'EPSG:3857') {
+                x = wrap(x / RADIUS) / RADIANS;
+                y = Math.atan(Math.sinh(y / RADIUS)) / RADIANS;
+            }
+            else {
+                if (Math.abs(y) >= 90)
+                    throw new Error('Coordinate outside Web Mercator projection domain');
+                x = wrap(x * RADIANS) * RADIUS;
+                y = (Math.asinh(Math.tan(y * RADIANS)) + 0) * RADIUS;
+            }
+        }
+        if (!Number.isFinite(x) || !Number.isFinite(y))
+            throw new Error('Projected coordinate is not finite');
+        this.point.x = x;
+        this.point.y = y;
+        this.point.z = z;
+    }
+    scalar(coordinate, output, from, to) {
+        validateScalarOutput(coordinate, output, coordinate.length);
+        if (coordinate.length < 2)
+            throw new Error('Projection requires at least two ordinates');
+        this.run(coordinate[0], coordinate[1], coordinate.length >= 3 ? coordinate[2] : 0, from, to);
+        return writeScalarOutput(coordinate, output, this.point, coordinate.length);
+    }
+    flat(coordinates, dimension, from, to) {
+        if (!(coordinates instanceof Float32Array || coordinates instanceof Float64Array))
+            throw new Error('Flat coordinates require Float32Array or Float64Array');
+        if (!Number.isSafeInteger(dimension) || dimension < 2 || coordinates.length % dimension)
+            throw new Error('Invalid flat coordinate dimension');
+        const float32 = coordinates instanceof Float32Array;
+        for (let offset = 0; offset < coordinates.length; offset += dimension) {
+            this.run(coordinates[offset], coordinates[offset + 1], dimension >= 3 ? coordinates[offset + 2] : 0, from, to);
+            if (float32 && (Math.abs(this.point.x) > FLOAT32_MAX || Math.abs(this.point.y) > FLOAT32_MAX))
+                throw new Error('Projected coordinate exceeds Float32 range');
+            coordinates[offset] = this.point.x;
+            coordinates[offset + 1] = this.point.y;
+        }
+        return coordinates;
+    }
+}
+//# sourceMappingURL=web-mercator.js.map

package/dist/projection/web-mercator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-mercator.js","sourceRoot":"","sources":["../../src/projection/web-mercator.ts"],"names":[],"mappings":"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"}

package/dist/subdivide-globe-mesh.d.ts

@@ -0,0 +1,20 @@
+import { type TriangleMesh, type SubdivideTriangleMeshOptions, type SubdividedTriangleMesh } from '@math.gl/geometry/polygon';
+/** Preserve the refinement discriminant when removing the globe adapter's fixed transform. */
+type GlobeSubdivisionOptions<Options> = Options extends unknown ? Omit<Options, 'transform' | 'targetSize'> : never;
+/** Globe axes and either sampled-error or source-edge refinement options. */
+export type SubdivideGlobeMeshOptions = GlobeSubdivisionOptions<SubdivideTriangleMeshOptions> & {
+    /** Equatorial radius; default 6371000. */
+    semiMajorAxis?: number;
+    /** Polar radius; default semiMajorAxis. Positive and at most semiMajorAxis. */
+    semiMinorAxis?: number;
+};
+/** Refine an already triangulated longitude/latitude(/height) mesh onto a globe.
+ * Source angles are degrees, height and tolerance are in axis units. Output is
+ * ECEF Cartesian (X longitude 0, Y longitude 90, Z north), not deck common space.
+ * Unwrap longitudes/split seams first: each triangle must span at most 180 degrees.
+ * Refinement preserves existing holes, winding, seam vertices and attribute
+ * provenance; it does not triangulate or clip polygons. Error is sampled, not certified.
+ */
+export declare function subdivideGlobeMesh(mesh: TriangleMesh, options: SubdivideGlobeMeshOptions): SubdividedTriangleMesh;
+export {};
+//# sourceMappingURL=subdivide-globe-mesh.d.ts.map

package/dist/subdivide-globe-mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subdivide-globe-mesh.d.ts","sourceRoot":"","sources":["../src/subdivide-globe-mesh.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,8FAA8F;AAC9F,KAAK,uBAAuB,CAAC,OAAO,IAAI,OAAO,SAAS,OAAO,GAC3D,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAAC,GACzC,KAAK,CAAC;AAEV,6EAA6E;AAC7E,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,CAAC,4BAA4B,CAAC,GAAG;IAC9F,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,yBAAyB,GACjC,sBAAsB,CAsCxB"}

package/dist/subdivide-globe-mesh.js

@@ -0,0 +1,54 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+// SPDX-FileComment: Original adapter over math.gl subdivision and spheroid kernels. Motivation only: https://github.com/keplergl/kepler.gl/pull/3548 (closed, unmerged). No implementation copied.
+import { spheroidToCartesian } from '@math.gl/core/spheroid';
+import { subdivideTriangleMesh } from '@math.gl/geometry/polygon';
+/** Refine an already triangulated longitude/latitude(/height) mesh onto a globe.
+ * Source angles are degrees, height and tolerance are in axis units. Output is
+ * ECEF Cartesian (X longitude 0, Y longitude 90, Z north), not deck common space.
+ * Unwrap longitudes/split seams first: each triangle must span at most 180 degrees.
+ * Refinement preserves existing holes, winding, seam vertices and attribute
+ * provenance; it does not triangulate or clip polygons. Error is sampled, not certified.
+ */
+export function subdivideGlobeMesh(mesh, options) {
+    const { semiMajorAxis = 6371000, semiMinorAxis = semiMajorAxis, size = 2, ...limits } = options;
+    if (size !== 2 && size !== 3)
+        throw new RangeError('Source size must be 2 or 3');
+    if (!Number.isFinite(semiMajorAxis) ||
+        !Number.isFinite(semiMinorAxis) ||
+        semiMajorAxis <= 0 ||
+        semiMinorAxis <= 0 ||
+        semiMinorAxis > semiMajorAxis)
+        throw new RangeError('Expected positive sphere/oblate axes');
+    // Validate latitude and reject unsplit long edges rather than silently crossing the globe.
+    for (let i = 1; i < mesh.positions.length; i += size)
+        if (Math.abs(mesh.positions[i]) > 90)
+            throw new RangeError('Latitude outside [-90, 90]');
+    for (let i = 0; i < mesh.indices.length; i += 3) {
+        const longitudes = [0, 1, 2].map(j => mesh.positions[mesh.indices[i + j] * size]);
+        if (Math.max(...longitudes) - Math.min(...longitudes) > 180)
+            throw new RangeError('Unwrap longitude seams before globe subdivision');
+    }
+    const geometry = {
+        semiMajorAxis,
+        semiMinorAxis,
+        eccentricitySquared: 1 - (semiMinorAxis / semiMajorAxis) ** 2
+    };
+    return subdivideTriangleMesh(mesh, {
+        ...limits,
+        size,
+        targetSize: 3,
+        transform(position) {
+            const point = {
+                x: (position[0] * Math.PI) / 180,
+                y: (position[1] * Math.PI) / 180,
+                z: size === 3 ? position[2] : 0
+            };
+            if (!spheroidToCartesian(point, geometry))
+                return null;
+            return [point.x, point.y, point.z];
+        }
+    });
+}
+//# sourceMappingURL=subdivide-globe-mesh.js.map

package/dist/subdivide-globe-mesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subdivide-globe-mesh.js","sourceRoot":"","sources":["../src/subdivide-globe-mesh.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAC5D,mMAAmM;AAEnM,OAAO,EAAC,mBAAmB,EAAC,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,qBAAqB,EAItB,MAAM,2BAA2B,CAAC;AAenC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAkB,EAClB,OAAkC;IAElC,MAAM,EAAC,aAAa,GAAG,OAAO,EAAE,aAAa,GAAG,aAAa,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,MAAM,EAAC,GAAG,OAAO,CAAC;IAC9F,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACjF,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC/B,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC/B,aAAa,IAAI,CAAC;QAClB,aAAa,IAAI,CAAC;QAClB,aAAa,GAAG,aAAa;QAE7B,MAAM,IAAI,UAAU,CAAC,sCAAsC,CAAC,CAAC;IAC/D,2FAA2F;IAC3F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI;QAClD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE;YAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAC3F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,GAAG;YACzD,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,QAAQ,GAAG;QACf,aAAa;QACb,aAAa;QACb,mBAAmB,EAAE,CAAC,GAAG,CAAC,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC;KAC9D,CAAC;IACF,OAAO,qBAAqB,CAAC,IAAI,EAAE;QACjC,GAAG,MAAM;QACT,IAAI;QACJ,UAAU,EAAE,CAAC;QACb,SAAS,CAAC,QAAQ;YAChB,MAAM,KAAK,GAAG;gBACZ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAChC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG;gBAChC,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAChC,CAAC;YACF,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tile-matrix.cjs

@@ -22,15 +22,26 @@ __export(tile_matrix_exports, {
   getTileBounds: () => getTileBounds,
   getTileIndex: () => getTileIndex,
   getTileRange: () => getTileRange,
+  getTileRanges: () => getTileRanges,
   isTileIndexInRange: () => isTileIndexInRange,
   selectTileMatrix: () => selectTileMatrix,
   validateTileMatrix: () => validateTileMatrix
 });
 module.exports = __toCommonJS(tile_matrix_exports);
 function validateTileMatrix(matrix) {
+  validateTileMatrixGeometry(matrix);
+}
+function validateTileMatrixGeometry(matrix) {
   if (typeof matrix.id !== "string" || !matrix.id || matrix.origin.length !== 2 || matrix.tileSize.length !== 2 || matrix.matrixSize.length !== 2 || !Number.isFinite(matrix.resolution) || matrix.resolution <= 0 || matrix.resolutionY !== void 0 && (!Number.isFinite(matrix.resolutionY) || matrix.resolutionY <= 0) || !matrix.origin.every(Number.isFinite) || ![...matrix.tileSize, ...matrix.matrixSize].every((value) => Number.isSafeInteger(value) && value > 0) || !["topLeft", "bottomLeft"].includes(matrix.cornerOfOrigin)) {
     throw new RangeError("Invalid tile matrix geometry");
   }
+  const bands = [...matrix.variableMatrixWidths ?? []].sort((first, second) => first.minTileRow - second.minTileRow);
+  let previousRow = -1;
+  for (const band of bands) {
+    if (!Number.isSafeInteger(band.coalesce) || band.coalesce <= 1 || matrix.matrixSize[0] % band.coalesce !== 0 || !Number.isSafeInteger(band.minTileRow) || !Number.isSafeInteger(band.maxTileRow) || band.minTileRow <= previousRow || band.maxTileRow < band.minTileRow || band.maxTileRow >= matrix.matrixSize[1])
+      throw new RangeError("Invalid variable matrix width");
+    previousRow = band.maxTileRow;
+  }
   for (let axis = 0; axis < 2; axis++) {
     const resolution = axis === 1 ? matrix.resolutionY ?? matrix.resolution : matrix.resolution;
     const tileSpan = resolution * matrix.tileSize[axis];
@@ -41,6 +52,7 @@ function validateTileMatrix(matrix) {
       throw new RangeError("Tile matrix extent must be finite");
     }
   }
+  return bands;
 }
 function isTileIndexInRange(matrix, column, row, limits) {
   validateTileMatrix(matrix);
@@ -53,12 +65,14 @@ function getTileBounds(matrix, column, row) {
     throw new RangeError("Tile index outside matrix");
   const width = matrix.resolution * matrix.tileSize[0];
   const height = (matrix.resolutionY ?? matrix.resolution) * matrix.tileSize[1];
-  const minimumX = matrix.origin[0] + column * width;
+  const coalesce = getRowCoalesce(matrix, row);
+  const canonicalColumn = Math.floor(column / coalesce) * coalesce;
+  const minimumX = matrix.origin[0] + canonicalColumn * width;
   const minimumY = matrix.cornerOfOrigin === "topLeft" ? matrix.origin[1] - (row + 1) * height : matrix.origin[1] + row * height;
   return [
     minimumX,
     minimumY,
-    matrix.origin[0] + (column + 1) * width,
+    matrix.origin[0] + (canonicalColumn + coalesce) * width,
     matrix.cornerOfOrigin === "topLeft" ? matrix.origin[1] - row * height : matrix.origin[1] + (row + 1) * height
   ];
 }
@@ -66,23 +80,26 @@ function getTileIndex(matrix, coordinate) {
   validateTileMatrix(matrix);
   if (!coordinate.every(Number.isFinite))
     return null;
-  const column = getTileAxisIndex(matrix.origin[0], 1, matrix.resolution * matrix.tileSize[0], matrix.matrixSize[0], coordinate[0]);
   const row = getTileAxisIndex(matrix.origin[1], matrix.cornerOfOrigin === "topLeft" ? -1 : 1, (matrix.resolutionY ?? matrix.resolution) * matrix.tileSize[1], matrix.matrixSize[1], coordinate[1]);
-  return column === null || row === null ? null : [column, row];
+  if (row === null)
+    return null;
+  const coalesce = getRowCoalesce(matrix, row);
+  const column = getTileAxisIndex(matrix.origin[0], 1, matrix.resolution * matrix.tileSize[0], matrix.matrixSize[0], coordinate[0], coalesce);
+  return column === null ? null : [column, row];
 }
-function getTileAxisIndex(origin, direction, tileSpan, matrixSize, coordinate) {
+function getTileAxisIndex(origin, direction, tileSpan, matrixSize, coordinate, columnStep = 1) {
   const end = origin + direction * (matrixSize * tileSpan);
   if (direction === 1 ? coordinate < origin || coordinate >= end : coordinate > origin || coordinate <= end) {
     return null;
   }
-  return findTileAxisBoundary(origin, direction, tileSpan, matrixSize, coordinate, false) - 1;
+  return (findTileAxisBoundary(origin, direction, tileSpan, matrixSize, coordinate, false, columnStep) - 1) * columnStep;
 }
-function findTileAxisBoundary(origin, direction, tileSpan, matrixSize, coordinate, includeEqualEdge) {
+function findTileAxisBoundary(origin, direction, tileSpan, matrixSize, coordinate, includeEqualEdge, columnStep = 1) {
   let lower = 0;
-  let upper = matrixSize;
+  let upper = matrixSize / columnStep;
   while (lower < upper) {
     const middle = lower + Math.floor((upper - lower) / 2);
-    const edge = origin + direction * (middle * tileSpan);
+    const edge = origin + direction * (middle * columnStep * tileSpan);
     const precedesCoordinate = direction === 1 ? includeEqualEdge ? edge < coordinate : edge <= coordinate : includeEqualEdge ? edge > coordinate : edge >= coordinate;
     if (precedesCoordinate)
       lower = middle + 1;
@@ -97,13 +114,8 @@ function validateTileMatrixLimits(matrix, limits) {
     throw new RangeError("Invalid tile matrix limits");
   }
 }
-function getTileRange(matrix, bounds, limits) {
-  validateTileMatrix(matrix);
-  if (limits)
-    validateTileMatrixLimits(matrix, limits);
-  if (bounds.length !== 4 || !bounds.every(Number.isFinite) || bounds[0] > bounds[2] || bounds[1] > bounds[3]) {
-    throw new RangeError("Tile query bounds must be finite and ordered");
-  }
+function getRegularTileRange(matrix, bounds, limits) {
+  validateTileQueryBounds(bounds);
   const columns = getTileAxisRange(matrix.origin[0], 1, matrix.resolution * matrix.tileSize[0], matrix.matrixSize[0], bounds[0], bounds[2]);
   const topLeft = matrix.cornerOfOrigin === "topLeft";
   const rows = getTileAxisRange(matrix.origin[1], topLeft ? -1 : 1, (matrix.resolutionY ?? matrix.resolution) * matrix.tileSize[1], matrix.matrixSize[1], topLeft ? bounds[3] : bounds[1], topLeft ? bounds[1] : bounds[3]);
@@ -117,9 +129,71 @@ function getTileRange(matrix, bounds, limits) {
   };
   return range.minTileColumn > range.maxTileColumn || range.minTileRow > range.maxTileRow ? null : range;
 }
-function getTileAxisRange(origin, direction, tileSpan, matrixSize, start, end) {
+function validateTileQueryBounds(bounds) {
+  if (bounds.length !== 4 || !bounds.every(Number.isFinite) || bounds[0] > bounds[2] || bounds[1] > bounds[3]) {
+    throw new RangeError("Tile query bounds must be finite and ordered");
+  }
+}
+function getTileRange(matrix, bounds, limits) {
+  var _a;
+  validateTileMatrix(matrix);
+  if ((_a = matrix.variableMatrixWidths) == null ? void 0 : _a.length) {
+    throw new RangeError("Use getTileRanges for variable-width matrices");
+  }
+  if (limits)
+    validateTileMatrixLimits(matrix, limits);
+  return getRegularTileRange(matrix, bounds, limits);
+}
+function getRowCoalesce(matrix, row) {
+  var _a, _b;
+  return ((_b = (_a = matrix.variableMatrixWidths) == null ? void 0 : _a.find((band) => row >= band.minTileRow && row <= band.maxTileRow)) == null ? void 0 : _b.coalesce) ?? 1;
+}
+function getTileRanges(matrix, bounds, limits) {
+  const declaredBands = validateTileMatrixGeometry(matrix);
+  if (limits)
+    validateTileMatrixLimits(matrix, limits);
+  validateTileQueryBounds(bounds);
+  const bands = [];
+  let nextRow = 0;
+  for (const band of declaredBands) {
+    if (nextRow < band.minTileRow) {
+      bands.push({ coalesce: 1, minTileRow: nextRow, maxTileRow: band.minTileRow - 1 });
+    }
+    bands.push(band);
+    nextRow = band.maxTileRow + 1;
+  }
+  if (nextRow < matrix.matrixSize[1]) {
+    bands.push({ coalesce: 1, minTileRow: nextRow, maxTileRow: matrix.matrixSize[1] - 1 });
+  }
+  const topLeft = matrix.cornerOfOrigin === "topLeft";
+  const rows = getTileAxisRange(matrix.origin[1], topLeft ? -1 : 1, (matrix.resolutionY ?? matrix.resolution) * matrix.tileSize[1], matrix.matrixSize[1], topLeft ? bounds[3] : bounds[1], topLeft ? bounds[1] : bounds[3]);
+  if (!rows)
+    return [];
+  const ranges = [];
+  for (const band of bands) {
+    const minimumRow = Math.max(band.minTileRow, rows[0], (limits == null ? void 0 : limits.minTileRow) ?? 0);
+    const maximumRow = Math.min(band.maxTileRow, rows[1], (limits == null ? void 0 : limits.maxTileRow) ?? matrix.matrixSize[1] - 1);
+    if (minimumRow > maximumRow)
+      continue;
+    const columns = getTileAxisRange(matrix.origin[0], 1, matrix.resolution * matrix.tileSize[0], matrix.matrixSize[0], bounds[0], bounds[2], band.coalesce);
+    if (!columns)
+      continue;
+    const minimumColumn = Math.max(columns[0], Math.floor(((limits == null ? void 0 : limits.minTileColumn) ?? 0) / band.coalesce) * band.coalesce);
+    const maximumColumn = Math.min(columns[1], Math.floor(((limits == null ? void 0 : limits.maxTileColumn) ?? matrix.matrixSize[0] - 1) / band.coalesce) * band.coalesce);
+    if (minimumColumn <= maximumColumn)
+      ranges.push({
+        minTileColumn: minimumColumn,
+        maxTileColumn: maximumColumn,
+        minTileRow: minimumRow,
+        maxTileRow: maximumRow,
+        columnStep: band.coalesce
+      });
+  }
+  return ranges;
+}
+function getTileAxisRange(origin, direction, tileSpan, matrixSize, start, end, columnStep = 1) {
   if (start === end) {
-    const index = getTileAxisIndex(origin, direction, tileSpan, matrixSize, start);
+    const index = getTileAxisIndex(origin, direction, tileSpan, matrixSize, start, columnStep);
     return index === null ? null : [index, index];
   }
   const matrixEnd = origin + direction * (matrixSize * tileSpan);
@@ -128,8 +202,8 @@ function getTileAxisRange(origin, direction, tileSpan, matrixSize, start, end) {
   if (direction === 1 ? clippedStart >= clippedEnd : clippedStart <= clippedEnd)
     return null;
   return [
-    findTileAxisBoundary(origin, direction, tileSpan, matrixSize, clippedStart, false) - 1,
-    findTileAxisBoundary(origin, direction, tileSpan, matrixSize, clippedEnd, true) - 1
+    (findTileAxisBoundary(origin, direction, tileSpan, matrixSize, clippedStart, false, columnStep) - 1) * columnStep,
+    (findTileAxisBoundary(origin, direction, tileSpan, matrixSize, clippedEnd, true, columnStep) - 1) * columnStep
   ];
 }
 function selectTileMatrix(matrixSet, targetResolution) {

package/dist/tile-matrix.cjs.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/tile-matrix.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/tile-matrix.d.ts

@@ -1,6 +1,15 @@
 /** Bounds in the matrix coordinate system: minimum X/Y followed by maximum X/Y. */
 export type TileMatrixBounds = readonly [number, number, number, number];
-/** A regular rectangular tile grid at one resolution, independent of service protocols. */
+/** Coalescence of contiguous base-grid columns over an inclusive band of rows. */
+export type VariableMatrixWidth = {
+    /** Number of base columns per tile; an integer greater than one dividing matrix width. */
+    readonly coalesce: number;
+    /** First row in this band, in the matrix's native row direction. */
+    readonly minTileRow: number;
+    /** Last row in this band, inclusive. */
+    readonly maxTileRow: number;
+};
+/** A rectangular tile grid at one resolution, independent of service protocols. */
 export type TileMatrix = {
     /** Opaque identifier; it is not a numeric zoom or array index. */
     readonly id: string;
@@ -14,8 +23,10 @@ export type TileMatrix = {
     readonly cornerOfOrigin: 'topLeft' | 'bottomLeft';
     /** Positive integer tile width and height in pixels. */
     readonly tileSize: readonly [number, number];
-    /** Positive integer matrix width and height in tiles. */
+    /** Positive integer base-grid width and height in tiles, before coalescence. */
     readonly matrixSize: readonly [number, number];
+    /** Optional disjoint row bands; omitted rows have coalescence one. Order is immaterial. */
+    readonly variableMatrixWidths?: readonly VariableMatrixWidth[];
 };
 /** Matrices sharing a coordinate system; no ordering or quadtree relationship is assumed. */
 export type TileMatrixSet = {
@@ -35,29 +46,40 @@ export type TileMatrixLimits = {
     /** Last available row. */
     readonly maxTileRow: number;
 };
+/** An exact row-band range of canonical columns, enumerated using columnStep. */
+export type TileMatrixRowRange = TileMatrixLimits & {
+    /** Increment between canonical columns; rows increment by one. */
+    readonly columnStep: number;
+};
 /** Rejects malformed or numerically unrepresentable matrix geometry. */
 export declare function validateTileMatrix(matrix: TileMatrix): void;
 /** Tests integer indices against the matrix and optional inclusive coverage limits. Does not wrap. */
 export declare function isTileIndexInRange(matrix: TileMatrix, column: number, row: number, limits?: TileMatrixLimits): boolean;
-/** Returns tile bounds in matrix coordinates. Throws for indices outside the matrix. */
+/** Returns the entire tile footprint, including column aliases. Throws for out-of-range indices. */
 export declare function getTileBounds(matrix: TileMatrix, column: number, row: number): TileMatrixBounds;
 /**
  * Finds the containing tile without clamping or wrapping. Tile intervals are half-open in column
  * and row direction: the origin edge belongs to the matrix, the opposite outer edge does not.
- * Returns null for nonfinite coordinates or coordinates outside the matrix.
+ * Returns a canonical column for coalesced rows, or null for nonfinite/outside coordinates.
  */
 export declare function getTileIndex(matrix: TileMatrix, coordinate: readonly [number, number]): [number, number] | null;
 /**
- * Returns a compact inclusive tile range intersecting an X/Y extent, clipped to the matrix and
- * optional coverage limits, or null for no intersection. Positive-area queries exclude tiles
- * that only touch an edge. Zero-width/height queries use point edge ownership on that axis.
- * Bounds must be finite and ordered; no wrapping or coordinate transformation is performed.
+ * Returns a rectangular range for a regular matrix. Variable-width matrices require getTileRanges
+ * so callers cannot accidentally enumerate aliases as separate tiles.
  */
 export declare function getTileRange(matrix: TileMatrix, bounds: TileMatrixBounds, limits?: TileMatrixLimits): TileMatrixLimits | null;
+/**
+ * Returns exact canonical-column ranges, ordered by native row, split at coalescence changes.
+ * Columns advance by columnStep, rows by one. Limits use base-grid indices: a tile is included
+ * when any of its aliases falls within those limits. Canonical columns may precede minTileColumn.
+ * Work and output scale with row bands rather than the number of tiles or rows.
+ */
+export declare function getTileRanges(matrix: TileMatrix, bounds: TileMatrixBounds, limits?: TileMatrixLimits): TileMatrixRowRange[];
 /**
  * Selects the coarsest matrix with resolution at or below the positive finite target, or the
  * finest available matrix when all levels are coarser. Target units must match the matrix set's
  * coordinate units per pixel. Returns null for an empty set; ties retain the first matrix.
+ * Uses nominal uncoalesced resolution; selection is independent of row.
  * Uses the larger axis resolution for anisotropic pixels, so both axes meet the target.
  * Validates every matrix and unique identifiers. Does not sort or mutate the set.
  */

package/dist/tile-matrix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tile-matrix.d.ts","sourceRoot":"","sources":["../src/tile-matrix.ts"],"names":[],"mappings":"AAIA,mFAAmF;AACnF,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzE,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG;IACvB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,6FAA6F;IAC7F,QAAQ,CAAC,cAAc,EAAE,SAAS,GAAG,YAAY,CAAC;IAClD,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD,CAAC;AAEF,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CAC1C,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,6BAA6B;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAmC3D;AAED,sGAAsG;AACtG,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAgBT;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAiB/F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAkBzB;AAgED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,gBAAgB,EACxB,MAAM,CAAC,EAAE,gBAAgB,GACxB,gBAAgB,GAAG,IAAI,CAsCzB;AAyBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,aAAa,EACxB,gBAAgB,EAAE,MAAM,GACvB,UAAU,GAAG,IAAI,CAwBnB"}
+{"version":3,"file":"tile-matrix.d.ts","sourceRoot":"","sources":["../src/tile-matrix.ts"],"names":[],"mappings":"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"}