@math.gl/dggs 5.0.0-alpha.2

package/dist/index.js

@@ -0,0 +1,52 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { A5Decoder } from "./a5-decoder.js";
+import { GeohashDecoder } from "./geohash-decoder.js";
+import { H3Decoder } from "./h3-decoder.js";
+import { PlusCodeDecoder } from "./plus-code-decoder.js";
+import { QuadkeyDecoder } from "./quadkey-decoder.js";
+import { S2Decoder } from "./s2-decoder.js";
+export { A5Decoder };
+export { GeohashDecoder };
+export { H3Decoder };
+export { PlusCodeDecoder };
+export { QuadkeyDecoder, quadkeyToWorldBounds } from "./quadkey-decoder.js";
+export { S2Decoder };
+export { getS2ChildIndex } from "./s2-geometry/s2-token.js";
+/** Lightweight decoders bundled with this module. */
+export const DGGS_DECODERS = [
+    A5Decoder,
+    GeohashDecoder,
+    H3Decoder,
+    PlusCodeDecoder,
+    QuadkeyDecoder,
+    S2Decoder
+];
+/**
+ * Finds a conventional DGGS cell column by name.
+ *
+ * Returns `null` when there is no match or when columns from more than one
+ * decoder match. Callers should ask the user to choose in the ambiguous case.
+ */
+export function findDGGSCellColumn(columnNames, decoders = DGGS_DECODERS) {
+    const actualNames = new Map();
+    for (const columnName of columnNames) {
+        actualNames.set(columnName.toLowerCase(), columnName);
+    }
+    let match = null;
+    for (const decoder of decoders) {
+        for (const candidate of decoder.cellColumnNames) {
+            const columnName = actualNames.get(candidate.toLowerCase());
+            if (!columnName) {
+                continue;
+            }
+            if (match && (match.decoder !== decoder || match.columnName !== columnName)) {
+                return null;
+            }
+            match = { columnName, decoder };
+        }
+    }
+    return match;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,SAAS,EAAC,wBAAqB;AACvC,OAAO,EAAC,cAAc,EAAC,6BAA0B;AACjD,OAAO,EAAC,SAAS,EAAC,wBAAqB;AACvC,OAAO,EAAC,eAAe,EAAC,+BAA4B;AACpD,OAAO,EAAC,cAAc,EAAC,6BAA0B;AACjD,OAAO,EAAC,SAAS,EAAC,wBAAqB;AAGvC,OAAO,EAAC,SAAS,EAAC,CAAC;AACnB,OAAO,EAAC,cAAc,EAAC,CAAC;AACxB,OAAO,EAAC,SAAS,EAAC,CAAC;AACnB,OAAO,EAAC,eAAe,EAAC,CAAC;AACzB,OAAO,EAAC,cAAc,EAAE,oBAAoB,EAAC,6BAA0B;AACvE,OAAO,EAAC,SAAS,EAAC,CAAC;AACnB,OAAO,EAAC,eAAe,EAAC,kCAA+B;AAEvD,qDAAqD;AACrD,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,SAAS;IACT,cAAc;IACd,SAAS;IACT,eAAe;IACf,cAAc;IACd,SAAS;CACV,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAA6B,EAC7B,WAAmC,aAAa;IAEhD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,GAA0B,IAAI,CAAC;IACxC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,EAAE,CAAC;gBAC5E,OAAO,IAAI,CAAC;YACd,CAAC;YACD,KAAK,GAAG,EAAC,UAAU,EAAE,OAAO,EAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/plus-code-decoder.d.ts

@@ -0,0 +1,16 @@
+import { type Bounds2D } from '@math.gl/types';
+import { type DGGSCell } from "./dggs-decoder.js";
+/**
+ * Lightweight geometry decoder for full Google Plus Codes (Open Location Codes).
+ * Short codes require a reference location and are intentionally unsupported.
+ */
+export declare const PlusCodeDecoder: {
+    readonly name: "plus-code";
+    readonly hasNumericRepresentation: false;
+    readonly cellColumnNames: readonly ["plusCode", "plus_code", "openLocationCode", "open_location_code", "olc"];
+    readonly cellToLngLat: (cell: DGGSCell) => [number, number];
+    readonly cellToBoundary: (cell: DGGSCell) => [number, number][];
+    readonly cellToBoundaryFlat: (cell: DGGSCell) => number[];
+    readonly cellToBounds: (cell: DGGSCell) => Bounds2D;
+};
+//# sourceMappingURL=plus-code-decoder.d.ts.map

package/dist/plus-code-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plus-code-decoder.d.ts","sourceRoot":"","sources":["../src/plus-code-decoder.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAC,KAAK,QAAQ,EAAqC,0BAAuB;AAIjF;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;kCAIL,QAAQ,KAAG,CAAC,MAAM,EAAE,MAAM,CAAC;oCACzB,QAAQ,KAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;wCACzB,QAAQ,KAAG,MAAM,EAAE;kCAIzB,QAAQ,KAAG,QAAQ;CAOV,CAAC"}

package/dist/plus-code-decoder.js

@@ -0,0 +1,50 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import OpenLocationCodePackage from 'open-location-code';
+import { getDGGSCellToken } from "./dggs-decoder.js";
+const openLocationCode = new OpenLocationCodePackage.OpenLocationCode();
+/**
+ * Lightweight geometry decoder for full Google Plus Codes (Open Location Codes).
+ * Short codes require a reference location and are intentionally unsupported.
+ */
+export const PlusCodeDecoder = {
+    name: 'plus-code',
+    hasNumericRepresentation: false,
+    cellColumnNames: ['plusCode', 'plus_code', 'openLocationCode', 'open_location_code', 'olc'],
+    cellToLngLat: (cell) => getPlusCodeLngLat(cell),
+    cellToBoundary: (cell) => getPlusCodeBoundary(decodePlusCode(cell)),
+    cellToBoundaryFlat: (cell) => {
+        const area = decodePlusCode(cell);
+        return getPlusCodeBoundary(area).flat();
+    },
+    cellToBounds: (cell) => {
+        const area = decodePlusCode(cell);
+        return [
+            [area.longitudeLo, area.latitudeLo],
+            [area.longitudeHi, area.latitudeHi]
+        ];
+    }
+};
+function getPlusCodeLngLat(cell) {
+    const area = decodePlusCode(cell);
+    return [area.longitudeCenter, area.latitudeCenter];
+}
+function decodePlusCode(cell) {
+    const code = getDGGSCellToken(cell, 'Plus Code');
+    if (!openLocationCode.isFull(code)) {
+        throw new Error(`Plus Code decoder requires a full code: ${code}`);
+    }
+    return openLocationCode.decode(code);
+}
+function getPlusCodeBoundary(area) {
+    const { longitudeLo: west, latitudeLo: south, longitudeHi: east, latitudeHi: north } = area;
+    return [
+        [east, north],
+        [east, south],
+        [west, south],
+        [west, north],
+        [east, north]
+    ];
+}
+//# sourceMappingURL=plus-code-decoder.js.map

package/dist/plus-code-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plus-code-decoder.js","sourceRoot":"","sources":["../src/plus-code-decoder.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,uBAAoD,MAAM,oBAAoB,CAAC;AAEtF,OAAO,EAAkC,gBAAgB,EAAC,0BAAuB;AAEjF,MAAM,gBAAgB,GAAG,IAAI,uBAAuB,CAAC,gBAAgB,EAAE,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,WAAW;IACjB,wBAAwB,EAAE,KAAK;IAC/B,eAAe,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,CAAC;IAC3F,YAAY,EAAE,CAAC,IAAc,EAAoB,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;IAC3E,cAAc,EAAE,CAAC,IAAc,EAAsB,EAAE,CAAC,mBAAmB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACjG,kBAAkB,EAAE,CAAC,IAAc,EAAY,EAAE;QAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,YAAY,EAAE,CAAC,IAAc,EAAY,EAAE;QACzC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO;YACL,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC;YACnC,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC;SACpC,CAAC;IACJ,CAAC;CAC6B,CAAC;AAEjC,SAAS,iBAAiB,CAAC,IAAc;IACvC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,cAAc,CAAC,IAAc;IACpC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACjD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,mBAAmB,CAAC,IAA0B;IACrD,MAAM,EAAC,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAC,GAAG,IAAI,CAAC;IAC1F,OAAO;QACL,CAAC,IAAI,EAAE,KAAK,CAAC;QACb,CAAC,IAAI,EAAE,KAAK,CAAC;QACb,CAAC,IAAI,EAAE,KAAK,CAAC;QACb,CAAC,IAAI,EAAE,KAAK,CAAC;QACb,CAAC,IAAI,EAAE,KAAK,CAAC;KACd,CAAC;AACJ,CAAC"}

package/dist/plus-code.cjs

@@ -0,0 +1,88 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// dist/plus-code.js
+var plus_code_exports = {};
+__export(plus_code_exports, {
+  PlusCodeDecoder: () => PlusCodeDecoder
+});
+module.exports = __toCommonJS(plus_code_exports);
+
+// dist/plus-code-decoder.js
+var import_open_location_code = __toESM(require("open-location-code"), 1);
+
+// dist/dggs-decoder.js
+function getDGGSCellToken(cell, gridName) {
+  if (typeof cell !== "string") {
+    throw new Error(`${gridName} cell identifiers must be strings`);
+  }
+  return cell;
+}
+
+// dist/plus-code-decoder.js
+var openLocationCode = new import_open_location_code.default.OpenLocationCode();
+var PlusCodeDecoder = {
+  name: "plus-code",
+  hasNumericRepresentation: false,
+  cellColumnNames: ["plusCode", "plus_code", "openLocationCode", "open_location_code", "olc"],
+  cellToLngLat: (cell) => getPlusCodeLngLat(cell),
+  cellToBoundary: (cell) => getPlusCodeBoundary(decodePlusCode(cell)),
+  cellToBoundaryFlat: (cell) => {
+    const area = decodePlusCode(cell);
+    return getPlusCodeBoundary(area).flat();
+  },
+  cellToBounds: (cell) => {
+    const area = decodePlusCode(cell);
+    return [
+      [area.longitudeLo, area.latitudeLo],
+      [area.longitudeHi, area.latitudeHi]
+    ];
+  }
+};
+function getPlusCodeLngLat(cell) {
+  const area = decodePlusCode(cell);
+  return [area.longitudeCenter, area.latitudeCenter];
+}
+function decodePlusCode(cell) {
+  const code = getDGGSCellToken(cell, "Plus Code");
+  if (!openLocationCode.isFull(code)) {
+    throw new Error(`Plus Code decoder requires a full code: ${code}`);
+  }
+  return openLocationCode.decode(code);
+}
+function getPlusCodeBoundary(area) {
+  const { longitudeLo: west, latitudeLo: south, longitudeHi: east, latitudeHi: north } = area;
+  return [
+    [east, north],
+    [east, south],
+    [west, south],
+    [west, north],
+    [east, north]
+  ];
+}
+//# sourceMappingURL=plus-code.cjs.map

package/dist/plus-code.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/plus-code.ts", "../src/plus-code-decoder.ts", "../src/dggs-decoder.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;ACIA,gCAAiE;;;ACyC3D,SAAU,iBAAiB,MAAgB,UAAgB;AAC/D,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,IAAI,MAAM,GAAG,QAAQ,mCAAmC;EAChE;AACA,SAAO;AACT;;;AD1CA,IAAM,mBAAmB,IAAI,0BAAAA,QAAwB,iBAAgB;AAM9D,IAAM,kBAAkB;EAC7B,MAAM;EACN,0BAA0B;EAC1B,iBAAiB,CAAC,YAAY,aAAa,oBAAoB,sBAAsB,KAAK;EAC1F,cAAc,CAAC,SAAqC,kBAAkB,IAAI;EAC1E,gBAAgB,CAAC,SAAuC,oBAAoB,eAAe,IAAI,CAAC;EAChG,oBAAoB,CAAC,SAA4B;AAC/C,UAAM,OAAO,eAAe,IAAI;AAChC,WAAO,oBAAoB,IAAI,EAAE,KAAI;EACvC;EACA,cAAc,CAAC,SAA4B;AACzC,UAAM,OAAO,eAAe,IAAI;AAChC,WAAO;MACL,CAAC,KAAK,aAAa,KAAK,UAAU;MAClC,CAAC,KAAK,aAAa,KAAK,UAAU;;EAEtC;;AAGF,SAAS,kBAAkB,MAAc;AACvC,QAAM,OAAO,eAAe,IAAI;AAChC,SAAO,CAAC,KAAK,iBAAiB,KAAK,cAAc;AACnD;AAEA,SAAS,eAAe,MAAc;AACpC,QAAM,OAAO,iBAAiB,MAAM,WAAW;AAC/C,MAAI,CAAC,iBAAiB,OAAO,IAAI,GAAG;AAClC,UAAM,IAAI,MAAM,2CAA2C,IAAI,EAAE;EACnE;AACA,SAAO,iBAAiB,OAAO,IAAI;AACrC;AAEA,SAAS,oBAAoB,MAA0B;AACrD,QAAM,EAAC,aAAa,MAAM,YAAY,OAAO,aAAa,MAAM,YAAY,MAAK,IAAI;AACrF,SAAO;IACL,CAAC,MAAM,KAAK;IACZ,CAAC,MAAM,KAAK;IACZ,CAAC,MAAM,KAAK;IACZ,CAAC,MAAM,KAAK;IACZ,CAAC,MAAM,KAAK;;AAEhB;",
+  "names": ["OpenLocationCodePackage"]
+}

package/dist/plus-code.d.ts

@@ -0,0 +1,2 @@
+export { PlusCodeDecoder } from "./plus-code-decoder.js";
+//# sourceMappingURL=plus-code.d.ts.map

package/dist/plus-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plus-code.d.ts","sourceRoot":"","sources":["../src/plus-code.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,eAAe,EAAC,+BAA4B"}

package/dist/plus-code.js

@@ -0,0 +1,5 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export { PlusCodeDecoder } from "./plus-code-decoder.js";
+//# sourceMappingURL=plus-code.js.map

package/dist/plus-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plus-code.js","sourceRoot":"","sources":["../src/plus-code.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,eAAe,EAAC,+BAA4B"}

package/dist/quadkey-decoder.d.ts

@@ -0,0 +1,14 @@
+import { type Bounds2D } from '@math.gl/types';
+import { type DGGSCell } from "./dggs-decoder.js";
+/** Decoder for the quadkey DGGS */
+export declare const QuadkeyDecoder: {
+    readonly name: "quadkey";
+    readonly hasNumericRepresentation: false;
+    readonly cellColumnNames: readonly ["quadkey", "quadkeyId", "quadkey_id"];
+    readonly cellToLngLat: (cell: DGGSCell) => [number, number];
+    readonly cellToBoundary: (cell: DGGSCell) => [number, number][];
+    readonly cellToBoundaryFlat: (cell: DGGSCell) => number[];
+    readonly cellToBounds: (cell: DGGSCell) => Bounds2D;
+};
+export declare function quadkeyToWorldBounds(quadkey: string): [[number, number], [number, number]];
+//# sourceMappingURL=quadkey-decoder.d.ts.map

package/dist/quadkey-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quadkey-decoder.d.ts","sourceRoot":"","sources":["../src/quadkey-decoder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAC,KAAK,QAAQ,EAAqC,0BAAuB;AAIjF,mCAAmC;AACnC,eAAO,MAAM,cAAc;;;;kCAIJ,QAAQ,KAAG,CAAC,MAAM,EAAE,MAAM,CAAC;oCAEzB,QAAQ,KAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;wCAEzB,QAAQ,KAAG,MAAM,EAAE;kCAEzB,QAAQ,KAAG,QAAQ;CACV,CAAC;AAuCjC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgB1F"}

package/dist/quadkey-decoder.js

@@ -0,0 +1,86 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getDGGSCellToken } from "./dggs-decoder.js";
+const TILE_SIZE = 512;
+/** Decoder for the quadkey DGGS */
+export const QuadkeyDecoder = {
+    name: 'quadkey',
+    hasNumericRepresentation: false,
+    cellColumnNames: ['quadkey', 'quadkeyId', 'quadkey_id'],
+    cellToLngLat: (cell) => getQuadkeyLngLat(getDGGSCellToken(cell, 'Quadkey')),
+    cellToBoundary: (cell) => getQuadkeyBoundary(getDGGSCellToken(cell, 'Quadkey')),
+    cellToBoundaryFlat: (cell) => getQuadkeyBoundaryFlat(getDGGSCellToken(cell, 'Quadkey')),
+    cellToBounds: (cell) => getQuadkeyBounds(getDGGSCellToken(cell, 'Quadkey'))
+};
+function getQuadkeyLngLat(quadkey) {
+    const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);
+    const [w, n] = worldToLngLat(topLeft);
+    const [e, s] = worldToLngLat(bottomRight);
+    return [(e + w) / 2, (s + n) / 2];
+}
+function getQuadkeyBoundary(quadkey) {
+    const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);
+    const [w, n] = worldToLngLat(topLeft);
+    const [e, s] = worldToLngLat(bottomRight);
+    return [
+        [e, n],
+        [e, s],
+        [w, s],
+        [w, n],
+        [e, n]
+    ];
+}
+function getQuadkeyBoundaryFlat(quadkey) {
+    const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);
+    const [w, n] = worldToLngLat(topLeft);
+    const [e, s] = worldToLngLat(bottomRight);
+    return [e, n, e, s, w, s, w, n, e, n];
+}
+function getQuadkeyBounds(quadkey) {
+    const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);
+    const [w, n] = worldToLngLat(topLeft);
+    const [e, s] = worldToLngLat(bottomRight);
+    return [
+        [w, s],
+        [e, n]
+    ];
+}
+export function quadkeyToWorldBounds(quadkey) {
+    let x = 0;
+    let y = 0;
+    let mask = 1 << quadkey.length;
+    const scale = mask / TILE_SIZE;
+    for (let i = 0; i < quadkey.length; i++) {
+        mask >>= 1;
+        const q = parseInt(quadkey[i], 10);
+        if (q % 2)
+            x |= mask;
+        if (q > 1)
+            y |= mask;
+    }
+    return [
+        [x / scale, TILE_SIZE - y / scale],
+        [(x + 0.99) / scale, TILE_SIZE - (y + 0.99) / scale]
+    ];
+}
+// CONSTANTS
+const PI = Math.PI;
+const PI_4 = PI / 4;
+const RADIANS_TO_DEGREES = 180 / PI;
+/**
+ * Unproject world point [x,y] on map onto {lat, lon} on sphere
+ *
+ * @param xy - array with [x,y] members
+ *  representing point on projected map plane
+ * @return - array with [x,y] of point on sphere.
+ *   Has toArray method if you need a GeoJSON Array.
+ *   Per cartographic tradition, lat and lon are specified as degrees.
+ */
+function worldToLngLat(xy) {
+    const [x, y] = xy;
+    const lambda2 = (x / TILE_SIZE) * (2 * PI) - PI;
+    const phi2 = 2 * (Math.atan(Math.exp((y / TILE_SIZE) * (2 * PI) - PI)) - PI_4);
+    return [lambda2 * RADIANS_TO_DEGREES, phi2 * RADIANS_TO_DEGREES];
+}
+//# sourceMappingURL=quadkey-decoder.js.map

package/dist/quadkey-decoder.js.map

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

package/dist/quadkey.cjs

@@ -0,0 +1,106 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// dist/quadkey.js
+var quadkey_exports = {};
+__export(quadkey_exports, {
+  QuadkeyDecoder: () => QuadkeyDecoder,
+  quadkeyToWorldBounds: () => quadkeyToWorldBounds
+});
+module.exports = __toCommonJS(quadkey_exports);
+
+// dist/dggs-decoder.js
+function getDGGSCellToken(cell, gridName) {
+  if (typeof cell !== "string") {
+    throw new Error(`${gridName} cell identifiers must be strings`);
+  }
+  return cell;
+}
+
+// dist/quadkey-decoder.js
+var TILE_SIZE = 512;
+var QuadkeyDecoder = {
+  name: "quadkey",
+  hasNumericRepresentation: false,
+  cellColumnNames: ["quadkey", "quadkeyId", "quadkey_id"],
+  cellToLngLat: (cell) => getQuadkeyLngLat(getDGGSCellToken(cell, "Quadkey")),
+  cellToBoundary: (cell) => getQuadkeyBoundary(getDGGSCellToken(cell, "Quadkey")),
+  cellToBoundaryFlat: (cell) => getQuadkeyBoundaryFlat(getDGGSCellToken(cell, "Quadkey")),
+  cellToBounds: (cell) => getQuadkeyBounds(getDGGSCellToken(cell, "Quadkey"))
+};
+function getQuadkeyLngLat(quadkey) {
+  const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);
+  const [w, n] = worldToLngLat(topLeft);
+  const [e, s] = worldToLngLat(bottomRight);
+  return [(e + w) / 2, (s + n) / 2];
+}
+function getQuadkeyBoundary(quadkey) {
+  const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);
+  const [w, n] = worldToLngLat(topLeft);
+  const [e, s] = worldToLngLat(bottomRight);
+  return [
+    [e, n],
+    [e, s],
+    [w, s],
+    [w, n],
+    [e, n]
+  ];
+}
+function getQuadkeyBoundaryFlat(quadkey) {
+  const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);
+  const [w, n] = worldToLngLat(topLeft);
+  const [e, s] = worldToLngLat(bottomRight);
+  return [e, n, e, s, w, s, w, n, e, n];
+}
+function getQuadkeyBounds(quadkey) {
+  const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);
+  const [w, n] = worldToLngLat(topLeft);
+  const [e, s] = worldToLngLat(bottomRight);
+  return [
+    [w, s],
+    [e, n]
+  ];
+}
+function quadkeyToWorldBounds(quadkey) {
+  let x = 0;
+  let y = 0;
+  let mask = 1 << quadkey.length;
+  const scale = mask / TILE_SIZE;
+  for (let i = 0; i < quadkey.length; i++) {
+    mask >>= 1;
+    const q = parseInt(quadkey[i], 10);
+    if (q % 2)
+      x |= mask;
+    if (q > 1)
+      y |= mask;
+  }
+  return [
+    [x / scale, TILE_SIZE - y / scale],
+    [(x + 0.99) / scale, TILE_SIZE - (y + 0.99) / scale]
+  ];
+}
+var PI = Math.PI;
+var PI_4 = PI / 4;
+var RADIANS_TO_DEGREES = 180 / PI;
+function worldToLngLat(xy) {
+  const [x, y] = xy;
+  const lambda2 = x / TILE_SIZE * (2 * PI) - PI;
+  const phi2 = 2 * (Math.atan(Math.exp(y / TILE_SIZE * (2 * PI) - PI)) - PI_4);
+  return [lambda2 * RADIANS_TO_DEGREES, phi2 * RADIANS_TO_DEGREES];
+}
+//# sourceMappingURL=quadkey.cjs.map

package/dist/quadkey.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/quadkey.ts", "../src/dggs-decoder.ts", "../src/quadkey-decoder.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;AC6CM,SAAU,iBAAiB,MAAgB,UAAgB;AAC/D,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,IAAI,MAAM,GAAG,QAAQ,mCAAmC;EAChE;AACA,SAAO;AACT;;;AC3CA,IAAM,YAAY;AAGX,IAAM,iBAAiB;EAC5B,MAAM;EACN,0BAA0B;EAC1B,iBAAiB,CAAC,WAAW,aAAa,YAAY;EACtD,cAAc,CAAC,SACb,iBAAiB,iBAAiB,MAAM,SAAS,CAAC;EACpD,gBAAgB,CAAC,SACf,mBAAmB,iBAAiB,MAAM,SAAS,CAAC;EACtD,oBAAoB,CAAC,SACnB,uBAAuB,iBAAiB,MAAM,SAAS,CAAC;EAC1D,cAAc,CAAC,SAA6B,iBAAiB,iBAAiB,MAAM,SAAS,CAAC;;AAGhG,SAAS,iBAAiB,SAAe;AACvC,QAAM,CAAC,SAAS,WAAW,IAAI,qBAAqB,OAAO;AAC3D,QAAM,CAAC,GAAG,CAAC,IAAI,cAAc,OAAO;AACpC,QAAM,CAAC,GAAG,CAAC,IAAI,cAAc,WAAW;AACxC,SAAO,EAAE,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC;AAClC;AAEA,SAAS,mBAAmB,SAAe;AACzC,QAAM,CAAC,SAAS,WAAW,IAAI,qBAAqB,OAAO;AAC3D,QAAM,CAAC,GAAG,CAAC,IAAI,cAAc,OAAO;AACpC,QAAM,CAAC,GAAG,CAAC,IAAI,cAAc,WAAW;AACxC,SAAO;IACL,CAAC,GAAG,CAAC;IACL,CAAC,GAAG,CAAC;IACL,CAAC,GAAG,CAAC;IACL,CAAC,GAAG,CAAC;IACL,CAAC,GAAG,CAAC;;AAET;AAEA,SAAS,uBAAuB,SAAe;AAC7C,QAAM,CAAC,SAAS,WAAW,IAAI,qBAAqB,OAAO;AAC3D,QAAM,CAAC,GAAG,CAAC,IAAI,cAAc,OAAO;AACpC,QAAM,CAAC,GAAG,CAAC,IAAI,cAAc,WAAW;AACxC,SAAO,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AACtC;AAEA,SAAS,iBAAiB,SAAe;AACvC,QAAM,CAAC,SAAS,WAAW,IAAI,qBAAqB,OAAO;AAC3D,QAAM,CAAC,GAAG,CAAC,IAAI,cAAc,OAAO;AACpC,QAAM,CAAC,GAAG,CAAC,IAAI,cAAc,WAAW;AACxC,SAAO;IACL,CAAC,GAAG,CAAC;IACL,CAAC,GAAG,CAAC;;AAET;AAEM,SAAU,qBAAqB,SAAe;AAClD,MAAI,IAAI;AACR,MAAI,IAAI;AACR,MAAI,OAAO,KAAK,QAAQ;AACxB,QAAM,QAAQ,OAAO;AAErB,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,aAAS;AACT,UAAM,IAAI,SAAS,QAAQ,CAAC,GAAG,EAAE;AACjC,QAAI,IAAI;AAAG,WAAK;AAChB,QAAI,IAAI;AAAG,WAAK;EAClB;AACA,SAAO;IACL,CAAC,IAAI,OAAO,YAAY,IAAI,KAAK;IACjC,EAAE,IAAI,QAAQ,OAAO,aAAa,IAAI,QAAQ,KAAK;;AAEvD;AAGA,IAAM,KAAK,KAAK;AAChB,IAAM,OAAO,KAAK;AAClB,IAAM,qBAAqB,MAAM;AAWjC,SAAS,cAAc,IAAY;AACjC,QAAM,CAAC,GAAG,CAAC,IAAI;AACf,QAAM,UAAW,IAAI,aAAc,IAAI,MAAM;AAC7C,QAAM,OAAO,KAAK,KAAK,KAAK,KAAK,IAAK,IAAI,aAAc,IAAI,MAAM,EAAE,CAAC,IAAI;AACzE,SAAO,CAAC,UAAU,oBAAoB,OAAO,kBAAkB;AACjE;",
+  "names": []
+}

package/dist/quadkey.d.ts

@@ -0,0 +1,2 @@
+export { QuadkeyDecoder, quadkeyToWorldBounds } from "./quadkey-decoder.js";
+//# sourceMappingURL=quadkey.d.ts.map

package/dist/quadkey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quadkey.d.ts","sourceRoot":"","sources":["../src/quadkey.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,cAAc,EAAE,oBAAoB,EAAC,6BAA0B"}

package/dist/quadkey.js

@@ -0,0 +1,5 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export { QuadkeyDecoder, quadkeyToWorldBounds } from "./quadkey-decoder.js";
+//# sourceMappingURL=quadkey.js.map

package/dist/quadkey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quadkey.js","sourceRoot":"","sources":["../src/quadkey.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,cAAc,EAAE,oBAAoB,EAAC,6BAA0B"}

package/dist/s2-decoder.d.ts

@@ -0,0 +1,26 @@
+import { type Bounds2D } from '@math.gl/types';
+import { type DGGSCell } from "./dggs-decoder.js";
+/** Decoder for the S2 DGGS */
+export declare const S2Decoder: {
+    readonly name: "s2";
+    readonly hasNumericRepresentation: true;
+    readonly cellColumnNames: readonly ["s2", "s2Token", "s2_token", "s2Cell", "s2_cell", "s2CellId", "s2_cell_id"];
+    readonly tokenToCell: (s2Token: string) => bigint;
+    readonly cellToToken: (cell: DGGSCell) => string;
+    readonly cellToLngLat: (cell: DGGSCell) => [number, number];
+    readonly cellToBoundary: (cell: DGGSCell) => [number, number][];
+    readonly cellToBoundaryFlat: (cell: DGGSCell) => number[];
+    readonly cellToBounds: (cell: DGGSCell) => Bounds2D;
+};
+/**
+ * Retrieve S2 geometry center
+ */
+export declare function getS2LngLat(cell: DGGSCell): [number, number];
+/**
+ * Get a polygon with corner coordinates for an s2 cell
+ * @param - This can be an S2 key or token
+ * @return {Float64Array} - a simple polygon in flat array format: [lng0, lat0, lng1, lat1, ...]
+ *   - the polygon is closed, i.e. last coordinate is a copy of the first coordinate
+ */
+export declare function getS2BoundaryFlat(cell: DGGSCell): number[];
+//# sourceMappingURL=s2-decoder.d.ts.map

package/dist/s2-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-decoder.d.ts","sourceRoot":"","sources":["../src/s2-decoder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,KAAK,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAC,KAAK,QAAQ,EAAmB,0BAAuB;AAM/D,8BAA8B;AAC9B,eAAO,MAAM,SAAS;;;;oCAIG,MAAM,KAAG,MAAM;iCAClB,QAAQ,KAAG,MAAM;kCAEhB,QAAQ,KAAG,CAAC,MAAM,EAAE,MAAM,CAAC;oCACzB,QAAQ,KAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;wCACzB,QAAQ,KAAG,MAAM,EAAE;kCACzB,QAAQ,KAAG,QAAQ;CACV,CAAC;AAEjC;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU5D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAK1D"}

package/dist/s2-decoder.js

@@ -0,0 +1,76 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getS2IndexFromToken, getS2TokenFromIndex } from "./s2-geometry/s2-token.js";
+import { getS2GeoBounds } from "./s2-geometry/s2-to-boundary.js";
+import { getS2Cell, IJToST, STToUV, FaceUVToXYZ, XYZToLngLat } from "./s2-geometry/s2-geometry.js";
+/** Decoder for the S2 DGGS */
+export const S2Decoder = {
+    name: 's2',
+    hasNumericRepresentation: true,
+    cellColumnNames: ['s2', 's2Token', 's2_token', 's2Cell', 's2_cell', 's2CellId', 's2_cell_id'],
+    tokenToCell: (s2Token) => getS2IndexFromToken(s2Token),
+    cellToToken: (cell) => typeof cell === 'string' ? cell : getS2TokenFromIndex(cell),
+    cellToLngLat: (cell) => getS2LngLat(cell),
+    cellToBoundary: (cell) => getS2Boundary(cell),
+    cellToBoundaryFlat: (cell) => getS2BoundaryFlat(cell),
+    cellToBounds: (cell) => getS2Bounds(cell)
+};
+/**
+ * Retrieve S2 geometry center
+ */
+export function getS2LngLat(cell) {
+    const s2Index = getS2CellIndex(cell);
+    const s2Cell = getS2Cell(s2Index);
+    const st = IJToST(s2Cell.ij, s2Cell.level, [0.5, 0.5]);
+    const uv = STToUV(st);
+    const xyz = FaceUVToXYZ(s2Cell.face, uv);
+    const lngLat = XYZToLngLat(xyz);
+    return lngLat;
+}
+/**
+ * Get a polygon with corner coordinates for an s2 cell
+ * @param - This can be an S2 key or token
+ * @return {Float64Array} - a simple polygon in flat array format: [lng0, lat0, lng1, lat1, ...]
+ *   - the polygon is closed, i.e. last coordinate is a copy of the first coordinate
+ */
+export function getS2BoundaryFlat(cell) {
+    const s2Index = getS2CellIndex(cell);
+    const float64Array = getS2GeoBounds(s2Index);
+    // TODO - inefficient
+    return Array.from(float64Array);
+}
+function getS2Boundary(cell) {
+    const flatBoundary = getS2BoundaryFlat(cell);
+    const boundary = [];
+    for (let i = 0; i < flatBoundary.length; i += 2) {
+        boundary.push([flatBoundary[i], flatBoundary[i + 1]]);
+    }
+    return boundary;
+}
+function getS2Bounds(cell) {
+    const flatBoundary = getS2Boundary(cell);
+    // We know that we have at least one point, no Infinity will be returned.
+    let xmin = Infinity;
+    let ymin = Infinity;
+    let xmax = -Infinity;
+    let ymax = -Infinity;
+    for (const [x, y] of flatBoundary) {
+        if (x < xmin)
+            xmin = x;
+        if (x > xmax)
+            xmax = x;
+        if (y < ymin)
+            ymin = y;
+        if (y > ymax)
+            ymax = y;
+    }
+    return [
+        [xmin, ymin],
+        [xmax, ymax]
+    ];
+}
+function getS2CellIndex(cell) {
+    return typeof cell === 'bigint' ? cell : getS2IndexFromToken(cell);
+}
+//# sourceMappingURL=s2-decoder.js.map

package/dist/s2-decoder.js.map

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

package/dist/s2-geometry/s2-geometry.d.ts

@@ -0,0 +1,13 @@
+export type S2Cell = {
+    face: number;
+    ij: [number, number];
+    level: number;
+};
+export declare function getS2Cell(s2Index: bigint): S2Cell;
+export declare function fromHilbertQuadKey(hilbertQuadkey: string): S2Cell;
+export declare function toHilbertQuadkey(id: bigint): string;
+export declare function IJToST(ij: [number, number], order: number, offsets: [number, number]): [number, number];
+export declare function STToUV(st: [number, number]): [number, number];
+export declare function FaceUVToXYZ(face: number, [u, v]: [number, number]): [number, number, number];
+export declare function XYZToLngLat([x, y, z]: [number, number, number]): [number, number];
+//# sourceMappingURL=s2-geometry.d.ts.map

package/dist/s2-geometry/s2-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-geometry.d.ts","sourceRoot":"","sources":["../../src/s2-geometry/s2-geometry.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIjD;AAcD,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAqCjE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CA6BnD;AAED,wBAAgB,MAAM,CACpB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlB;AASD,wBAAgB,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE7D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAiB5F;AAED,wBAAgB,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKjF"}