@math.gl/geospatial 5.0.0-alpha.9 → 5.0.0-beta.2

package/dist/crs/crs-descriptor.d.ts

@@ -0,0 +1,26 @@
+import { type CRSProjectionDomain } from "./projection-domain.js";
+import { type CRSExecutionIdentity } from "./execution-identity.js";
+import type { CRSMetadata } from "./crs-metadata.js";
+import type { CRSBounds, CRSConverter, CRSDescriptor, CRSRenderingScale, CRSRenderingScaleCallback } from "./crs-descriptor-types.js";
+/** Backend-owned operations and rendering policy for an already prepared target CRS. */
+export type CRSDescriptorOptions = Readonly<{
+    metadata: CRSMetadata;
+    /** Optional opaque caller identity. Defaults to getCRSSignature(metadata). */
+    signature?: string;
+    /** Opt-in provenance for execution cache invalidation; never inferred from callbacks. */
+    executionIdentity?: CRSExecutionIdentity;
+    renderingBounds: CRSBounds;
+    /** Backend-supplied target domain, independently snapshotted when present. */
+    projectionDomain?: CRSProjectionDomain;
+    renderingScale: CRSRenderingScale | CRSRenderingScaleCallback;
+    /** WGS84 means longitude/latitude degrees and ellipsoidal height metres. */
+    converter: Readonly<Record<string, CRSConverter>> & {
+        readonly WGS84: CRSConverter;
+    };
+}>;
+/** Assemble a descriptor without native parsing, projection algorithms or authority lookup.
+ * Data is snapshotted; callbacks retain their backend-owned state and lifetime.
+ * Shape validation does not establish geodetic correctness or CRS equivalence.
+ */
+export declare function createCRSDescriptor(options: CRSDescriptorOptions): CRSDescriptor;
+//# sourceMappingURL=crs-descriptor.d.ts.map

package/dist/crs/crs-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-descriptor.d.ts","sourceRoot":"","sources":["../../src/crs/crs-descriptor.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,mBAAmB,EAAC,+BAA4B;AACxF,OAAO,EAA6B,KAAK,oBAAoB,EAAC,gCAA6B;AAE3F,OAAO,KAAK,EAAC,WAAW,EAAU,0BAAuB;AACzD,OAAO,KAAK,EACV,SAAS,EAET,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EAC1B,kCAA+B;AAGhC,wFAAwF;AACxF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,QAAQ,EAAE,WAAW,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,eAAe,EAAE,SAAS,CAAC;IAC3B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,cAAc,EAAE,iBAAiB,GAAG,yBAAyB,CAAC;IAC9D,4EAA4E;IAC5E,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG;QAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;KAAC,CAAC;CACpF,CAAC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA0GhF"}

package/dist/crs/crs-descriptor.js

@@ -0,0 +1,131 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { createCRSProjectionDomain } from "./projection-domain.js";
+import { createCRSExecutionIdentity } from "./execution-identity.js";
+import { getCRSSignature } from "./crs-metadata.js";
+/** Assemble a descriptor without native parsing, projection algorithms or authority lookup.
+ * Data is snapshotted; callbacks retain their backend-owned state and lifetime.
+ * Shape validation does not establish geodetic correctness or CRS equivalence.
+ */
+export function createCRSDescriptor(options) {
+    const source = options.metadata;
+    requireValue(['geographic', 'projected', 'geocentric', 'identity'].includes(source.coordinateFrame), 'coordinateFrame');
+    requireValue(typeof source.projection === 'string' && Boolean(source.projection.trim()), 'projection');
+    requireValue(typeof source.lossy === 'boolean', 'lossy');
+    requireValue(typeof source.axis === 'string' &&
+        source.axis.length === 3 &&
+        /^[ewnsud]+$/.test(source.axis) &&
+        /[ew]/.test(source.axis) &&
+        /[ns]/.test(source.axis) &&
+        /[ud]/.test(source.axis), 'axis');
+    requireValue(positive(source.ellipsoid.semiMajorAxis) && positive(source.ellipsoid.semiMinorAxis), 'ellipsoid');
+    requireValue(Boolean(source.parameters) &&
+        typeof source.parameters === 'object' &&
+        !Array.isArray(source.parameters), 'parameters');
+    const parameters = { ...source.parameters };
+    requireValue(Object.values(parameters).every(value => value === undefined || typeof value === 'string'), 'parameters');
+    const areaOfUse = source.areaOfUse && [...source.areaOfUse];
+    if (areaOfUse)
+        requireValue(areaOfUse.length === 4 && areaOfUse.every(Number.isFinite) && areaOfUse[1] <= areaOfUse[3], 'areaOfUse');
+    const metadata = {
+        coordinateFrame: source.coordinateFrame,
+        projection: source.projection,
+        parameters: Object.freeze(parameters),
+        ellipsoid: Object.freeze({
+            semiMajorAxis: source.ellipsoid.semiMajorAxis,
+            semiMinorAxis: source.ellipsoid.semiMinorAxis
+        }),
+        axis: source.axis,
+        xUnit: copyUnit(source.xUnit),
+        yUnit: copyUnit(source.yUnit),
+        zUnit: copyUnit(source.zUnit),
+        lossy: source.lossy,
+        areaOfUse: areaOfUse && Object.freeze(areaOfUse)
+    };
+    const signature = options.signature ?? getCRSSignature(metadata);
+    requireValue(typeof signature === 'string' && Boolean(signature.trim()), 'signature');
+    const bounds = options.renderingBounds;
+    requireValue(Array.isArray(bounds) &&
+        bounds.length === 2 &&
+        [...bounds].every(row => Array.isArray(row) && row.length === 3 && [...row].every(Number.isFinite)) &&
+        bounds[0].every((minimum, i) => minimum <= bounds[1][i]), 'renderingBounds');
+    const renderingBounds = Object.freeze([
+        Object.freeze([...bounds[0]]),
+        Object.freeze([...bounds[1]])
+    ]);
+    const suppliedScale = options.renderingScale;
+    const renderingScale = typeof suppliedScale === 'function'
+        ? (coordinate) => {
+            const result = suppliedScale(coordinate);
+            return result === null ? null : copyScale(result);
+        }
+        : copyScale(suppliedScale);
+    requireValue(Object.prototype.hasOwnProperty.call(options.converter, 'WGS84'), 'converter.WGS84');
+    const converter = Object.create(null);
+    for (const key of Object.getOwnPropertyNames(options.converter)) {
+        const operations = options.converter[key];
+        requireValue(Boolean(key.trim()), 'converter key');
+        converter[key] = Object.freeze({
+            from: bindConversion(operations, 'from'),
+            to: bindConversion(operations, 'to'),
+            normalize: bindConversion(operations, 'normalize')
+        });
+    }
+    return Object.freeze({
+        ...metadata,
+        signature,
+        ...(options.executionIdentity === undefined
+            ? {}
+            : { executionIdentity: createCRSExecutionIdentity(options.executionIdentity) }),
+        renderingBounds,
+        ...(options.projectionDomain === undefined
+            ? {}
+            : { projectionDomain: createCRSProjectionDomain(options.projectionDomain) }),
+        renderingScale,
+        getRenderingScale: (coordinate) => typeof renderingScale === 'function' ? renderingScale(coordinate) : renderingScale,
+        converter: Object.freeze(converter)
+    });
+}
+function bindConversion(owner, key) {
+    const operation = owner?.[key];
+    requireValue(typeof operation === 'function', `converter.${key}`);
+    function convert(coordinate, output) {
+        // Capture the method and receiver at construction. Never adapt promises into sync conversions.
+        const result = operation.call(owner, coordinate, output);
+        requireSynchronous(result);
+        requireValue(output === undefined ? Array.isArray(result) : result === output, 'converter result: synchronous array or supplied output required');
+        return result;
+    }
+    return convert;
+}
+function copyUnit(unit) {
+    requireValue(typeof unit.name === 'string' &&
+        Boolean(unit.name.trim()) &&
+        ((positive(unit.metersPerUnit) && unit.degreesPerUnit === undefined) ||
+            (positive(unit.degreesPerUnit) && unit.metersPerUnit === undefined)), 'unit');
+    return Object.freeze(unit.metersPerUnit !== undefined
+        ? { name: unit.name, metersPerUnit: unit.metersPerUnit }
+        : { name: unit.name, degreesPerUnit: unit.degreesPerUnit });
+}
+function copyScale(value) {
+    requireSynchronous(value);
+    requireValue(Array.isArray(value) && value.length === 3 && [...value].every(positive), 'renderingScale');
+    return Object.freeze([...value]);
+}
+function positive(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0;
+}
+function requireSynchronous(value) {
+    if (value && typeof value.then === 'function') {
+        // Observe a rejected accidental async result without creating an unhandled rejection.
+        // This cannot cancel work already started by a contract-violating backend.
+        void Promise.resolve(value).catch(() => undefined);
+        throw new TypeError('Invalid CRS descriptor result: synchronous callbacks required');
+    }
+}
+function requireValue(condition, field) {
+    if (!condition)
+        throw new TypeError(`Invalid CRS descriptor ${field}`);
+}
+//# sourceMappingURL=crs-descriptor.js.map

package/dist/crs/crs-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-descriptor.js","sourceRoot":"","sources":["../../src/crs/crs-descriptor.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,OAAO,EAAC,yBAAyB,EAA2B,+BAA4B;AACxF,OAAO,EAAC,0BAA0B,EAA4B,gCAA6B;AAC3F,OAAO,EAAC,eAAe,EAAC,0BAAuB;AA2B/C;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAChC,YAAY,CACV,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,EACtF,iBAAiB,CAClB,CAAC;IACF,YAAY,CACV,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EAC1E,YAAY,CACb,CAAC;IACF,YAAY,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,OAAO,CAAC,CAAC;IACzD,YAAY,CACV,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QACxB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAC1B,MAAM,CACP,CAAC;IACF,YAAY,CACV,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,EACpF,WAAW,CACZ,CAAC;IACF,YAAY,CACV,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;QACxB,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QACrC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EACnC,YAAY,CACb,CAAC;IACF,MAAM,UAAU,GAAG,EAAC,GAAG,MAAM,CAAC,UAAU,EAAC,CAAC;IAC1C,YAAY,CACV,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,EAC1F,YAAY,CACb,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAK,CAAC,GAAG,MAAM,CAAC,SAAS,CAAsC,CAAC;IAClG,IAAI,SAAS;QACX,YAAY,CACV,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAC1F,WAAW,CACZ,CAAC;IACJ,MAAM,QAAQ,GAAgB;QAC5B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QACrC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;YACvB,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,aAAa;YAC7C,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,aAAa;SAC9C,CAAC;QACF,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;KACjD,CAAC;IACF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;IACjE,YAAY,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IACvC,YAAY,CACV,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,CACf,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CACjF;QACD,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC1D,iBAAiB,CAClB,CAAC;IACF,MAAM,eAAe,GAAc,MAAM,CAAC,MAAM,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAiB;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAiB;KAC9C,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAC7C,MAAM,cAAc,GAClB,OAAO,aAAa,KAAK,UAAU;QACjC,CAAC,CAAC,CAAC,UAAyB,EAA4B,EAAE;YACtD,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;YACzC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;QACH,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC/B,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAClG,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAyD,CAAC;IAC9F,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC1C,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACnD,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC;YACxC,EAAE,EAAE,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC;YACpC,SAAS,EAAE,cAAc,CAAC,UAAU,EAAE,WAAW,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,QAAQ;QACX,SAAS;QACT,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAC,iBAAiB,EAAE,0BAA0B,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAC,CAAC;QAC/E,eAAe;QACf,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAC,gBAAgB,EAAE,yBAAyB,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAC,CAAC;QAC5E,cAAc;QACd,iBAAiB,EAAE,CAAC,UAAyB,EAAE,EAAE,CAC/C,OAAO,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,cAAc;QACpF,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;KACpC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,KAAmB,EAAE,GAAuB;IAClE,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC,GAAG,CAAiE,CAAC;IAC/F,YAAY,CAAC,OAAO,SAAS,KAAK,UAAU,EAAE,aAAa,GAAG,EAAE,CAAC,CAAC;IAGlE,SAAS,OAAO,CAAC,UAAyB,EAAE,MAAkB;QAC5D,+FAA+F;QAC/F,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACzD,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,YAAY,CACV,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,EAChE,iEAAiE,CAClE,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAa;IAC7B,YAAY,CACV,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC;YAClE,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,EACxE,MAAM,CACP,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,CAAC,aAAa,KAAK,SAAS;QAC9B,CAAC,CAAC,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAC;QACtD,CAAC,CAAC,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAC,CAC3D,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAwB;IACzC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1B,YAAY,CACV,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EACxE,gBAAgB,CACjB,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAsB,CAAC;AACxD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,IAAI,OAAQ,KAA0B,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACpE,sFAAsF;QACtF,2EAA2E;QAC3E,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACvF,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,SAAkB,EAAE,KAAa;IACrD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;AACzE,CAAC"}

package/dist/crs/crs-identifier.d.ts

@@ -0,0 +1,23 @@
+import type { CRSIdentifier } from "./crs.js";
+/**
+ * Normalizes recognized spellings of an authority CRS identifier to `AUTHORITY:CODE`.
+ *
+ * Recognized forms are `AUTHORITY:CODE`, the WMS 1.3 codes `CRS:84`, `CRS:83` and `CRS:27`,
+ * OGC URNs (`urn:ogc:def:crs:EPSG::32619`) and OGC URIs
+ * (`http://www.opengis.net/def/crs/EPSG/0/32619`). Known authority prefixes (EPSG, OGC, ESRI and IAU) and explicitly known OGC CRS codes
+ * accept case-insensitive input aliases. Other authority and code spellings are preserved.
+ *
+ * A version is removed only when it is empty or `0`, or when it is `1.3` on an OGC `CRS84`,
+ * `CRS83` or `CRS27` code, which the OGC register publishes only at that version. Any other
+ * versioned identifier is returned unchanged, so it does not compare equal to an unversioned one.
+ * Unrecognized strings are also returned unchanged.
+ *
+ * The result identifies a registry entry only. Different codes are never equated: `EPSG:4326` and
+ * `OGC:CRS84` stay distinct, as do Web Mercator aliases. No datum equivalence, axis-order
+ * convention or registry lookup is applied.
+ *
+ * @param identifier - CRS identifier as written by a source or service.
+ * @returns The canonical `AUTHORITY:CODE` identifier, or `identifier` unchanged.
+ */
+export declare function normalizeCRSIdentifier(identifier: CRSIdentifier): CRSIdentifier;
+//# sourceMappingURL=crs-identifier.d.ts.map

package/dist/crs/crs-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-identifier.d.ts","sourceRoot":"","sources":["../../src/crs/crs-identifier.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,iBAAc;AAsBzC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,aAAa,GAAG,aAAa,CAoB/E"}

package/dist/crs/crs-identifier.js

@@ -0,0 +1,74 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+/** WMS 1.3 `CRS:` codes and the OGC register entries they abbreviate. */
+const WMS_CRS_CODES = new Map([
+    ['84', 'CRS84'],
+    ['83', 'CRS83'],
+    ['27', 'CRS27']
+]);
+/** Explicit input conveniences, not a case-insensitivity rule for all registry names. */
+const KNOWN_AUTHORITIES = new Set(['EPSG', 'OGC', 'ESRI', 'IAU']);
+const OGC_CRS_CODES = new Map([
+    ['CRS84', 'CRS84'],
+    ['CRS83', 'CRS83'],
+    ['CRS27', 'CRS27'],
+    ['CRS84H', 'CRS84h']
+]);
+const AUTHORITY_CODE = /^([A-Z][A-Z0-9_-]*):([A-Z0-9_.-]+)$/i;
+const OGC_URN = /^urn:ogc:def:crs:([A-Z][A-Z0-9_-]*):([^:]*):([A-Z0-9_.-]+)$/i;
+const OGC_URI = /^https?:\/\/www\.opengis\.net\/def\/crs\/([A-Z][A-Z0-9_-]*)\/([^/]+)\/([A-Z0-9_.-]+)\/?$/i;
+/**
+ * Normalizes recognized spellings of an authority CRS identifier to `AUTHORITY:CODE`.
+ *
+ * Recognized forms are `AUTHORITY:CODE`, the WMS 1.3 codes `CRS:84`, `CRS:83` and `CRS:27`,
+ * OGC URNs (`urn:ogc:def:crs:EPSG::32619`) and OGC URIs
+ * (`http://www.opengis.net/def/crs/EPSG/0/32619`). Known authority prefixes (EPSG, OGC, ESRI and IAU) and explicitly known OGC CRS codes
+ * accept case-insensitive input aliases. Other authority and code spellings are preserved.
+ *
+ * A version is removed only when it is empty or `0`, or when it is `1.3` on an OGC `CRS84`,
+ * `CRS83` or `CRS27` code, which the OGC register publishes only at that version. Any other
+ * versioned identifier is returned unchanged, so it does not compare equal to an unversioned one.
+ * Unrecognized strings are also returned unchanged.
+ *
+ * The result identifies a registry entry only. Different codes are never equated: `EPSG:4326` and
+ * `OGC:CRS84` stay distinct, as do Web Mercator aliases. No datum equivalence, axis-order
+ * convention or registry lookup is applied.
+ *
+ * @param identifier - CRS identifier as written by a source or service.
+ * @returns The canonical `AUTHORITY:CODE` identifier, or `identifier` unchanged.
+ */
+export function normalizeCRSIdentifier(identifier) {
+    const text = identifier.trim();
+    const authorityCode = AUTHORITY_CODE.exec(text);
+    if (authorityCode) {
+        const [, authority, code] = authorityCode;
+        if (authority.toUpperCase() === 'CRS') {
+            const ogcCode = WMS_CRS_CODES.get(code);
+            return ogcCode ? `OGC:${ogcCode}` : identifier;
+        }
+        return formatIdentifier(authority, code);
+    }
+    const versioned = OGC_URN.exec(text) || OGC_URI.exec(text);
+    if (versioned) {
+        const [, authority, version, code] = versioned;
+        return isUnversioned(authority, version, code) ? formatIdentifier(authority, code) : identifier;
+    }
+    return identifier;
+}
+/** Whether a URN or URI version names no particular revision of the registry entry. */
+function isUnversioned(authority, version, code) {
+    if (version === '' || version === '0')
+        return true;
+    const ogcCode = code.toUpperCase();
+    return (authority.toUpperCase() === 'OGC' &&
+        version === '1.3' &&
+        Array.from(WMS_CRS_CODES.values()).includes(ogcCode));
+}
+function formatIdentifier(authority, code) {
+    const upperAuthority = authority.toUpperCase();
+    const canonicalAuthority = KNOWN_AUTHORITIES.has(upperAuthority) ? upperAuthority : authority;
+    const canonicalCode = canonicalAuthority === 'OGC' ? OGC_CRS_CODES.get(code.toUpperCase()) || code : code;
+    return `${canonicalAuthority}:${canonicalCode}`;
+}
+//# sourceMappingURL=crs-identifier.js.map

package/dist/crs/crs-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-identifier.js","sourceRoot":"","sources":["../../src/crs/crs-identifier.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAI5D,yEAAyE;AACzE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAiB;IAC5C,CAAC,IAAI,EAAE,OAAO,CAAC;IACf,CAAC,IAAI,EAAE,OAAO,CAAC;IACf,CAAC,IAAI,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AACH,yFAAyF;AACzF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAClE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAiB;IAC5C,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,sCAAsC,CAAC;AAC9D,MAAM,OAAO,GAAG,8DAA8D,CAAC;AAC/E,MAAM,OAAO,GACX,2FAA2F,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAyB;IAC9D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAE/B,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,aAAa,CAAC;QAC1C,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QACjD,CAAC;QACD,OAAO,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC;QAC/C,OAAO,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAClG,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,uFAAuF;AACvF,SAAS,aAAa,CAAC,SAAiB,EAAE,OAAe,EAAE,IAAY;IACrE,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,CACL,SAAS,CAAC,WAAW,EAAE,KAAK,KAAK;QACjC,OAAO,KAAK,KAAK;QACjB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CACrD,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,IAAY;IACvD,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,MAAM,aAAa,GACjB,kBAAkB,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACtF,OAAO,GAAG,kBAAkB,IAAI,aAAa,EAAE,CAAC;AAClD,CAAC"}

package/dist/crs/crs-metadata.d.ts

@@ -0,0 +1,43 @@
+export { linearUnits } from "./units-table.js";
+/** Coordinate unit metadata. */
+export type CRSUnit = Readonly<{
+    /** Unit name, such as degrees, radians, meters, kilometers, or feet. */
+    name: string;
+    /** Metres per coordinate unit for linear units; omitted for angular units. */
+    metersPerUnit?: number;
+    /** Degrees per coordinate unit for angular units; omitted for linear units. */
+    degreesPerUnit?: number;
+}>;
+/** Resolved executable CRS metadata, without projection algorithms or rendering conventions. */
+export type CRSMetadata = Readonly<{
+    /** Coordinate representation; identity describes an explicitly local, unreferenced space. */
+    coordinateFrame: 'geographic' | 'projected' | 'geocentric' | 'identity';
+    /** Backend projection name; native engines use PROJ algorithm names. Not a semantic CRS identity. */
+    projection: string;
+    /** Backend parameters. Native engines use resolved PROJ parameters: degrees for angles, metres for lengths. */
+    parameters: Readonly<Record<string, string | undefined>>;
+    /** Resolved rotational ellipsoid. A sphere has equal axes; both axes are in metres. */
+    ellipsoid: Readonly<{
+        semiMajorAxis: number;
+        semiMinorAxis: number;
+    }>;
+    /** Effective array axis order/signs: e/w, n/s, u/d. Independent of authoritative axis order. */
+    axis: string;
+    /** Unit of the X component, such as degrees, radians, meters, kilometers, or feet. */
+    xUnit: CRSUnit;
+    /** Unit of the Y component, such as degrees, radians, meters, kilometers, or feet. */
+    yUnit: CRSUnit;
+    /** Unit of the Z component, such as degrees, radians, meters, kilometers, or feet. */
+    zUnit: CRSUnit;
+    /** Declared geographic area of use in Greenwich degrees: west, south, east, north.
+     * East may be less than west for an extent crossing the antimeridian.
+     */
+    areaOfUse?: readonly [west: number, south: number, east: number, north: number];
+    /** Whether explicit horizontal extraction discarded part of the input definition. */
+    lossy: boolean;
+}>;
+/** Deterministic identity for resolved CRS metadata, independent of object/property order.
+ * This compares execution conventions, not arbitrary semantic equivalence of CRS definitions.
+ */
+export declare function getCRSSignature(crs: CRSMetadata): string;
+//# sourceMappingURL=crs-metadata.d.ts.map

package/dist/crs/crs-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-metadata.d.ts","sourceRoot":"","sources":["../../src/crs/crs-metadata.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,WAAW,EAAC,yBAAsB;AAE1C,gCAAgC;AAChC,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC;IAC7B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,gGAAgG;AAChG,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,6FAA6F;IAC7F,eAAe,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;IACxE,qGAAqG;IACrG,UAAU,EAAE,MAAM,CAAC;IACnB,+GAA+G;IAC/G,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACzD,uFAAuF;IACvF,SAAS,EAAE,QAAQ,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACpE,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,KAAK,EAAE,OAAO,CAAC;IACf,sFAAsF;IACtF,KAAK,EAAE,OAAO,CAAC;IACf,sFAAsF;IACtF,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAChF,qFAAqF;IACrF,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAgBxD"}

package/dist/crs/crs-metadata.js

@@ -0,0 +1,26 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+// Metadata-only entry: importing units/signatures must not pull syntax readers into split bundles.
+export { linearUnits } from "./units-table.js";
+/** Deterministic identity for resolved CRS metadata, independent of object/property order.
+ * This compares execution conventions, not arbitrary semantic equivalence of CRS definitions.
+ */
+export function getCRSSignature(crs) {
+    // Derived rendering bounds and converter objects do not change resolved CRS identity.
+    return JSON.stringify([
+        crs.coordinateFrame,
+        crs.projection,
+        Object.keys(crs.parameters)
+            .sort()
+            .map(key => [key, crs.parameters[key]]),
+        [crs.ellipsoid.semiMajorAxis, crs.ellipsoid.semiMinorAxis],
+        crs.axis,
+        [crs.xUnit.name, crs.xUnit.metersPerUnit, crs.xUnit.degreesPerUnit],
+        [crs.yUnit.name, crs.yUnit.metersPerUnit, crs.yUnit.degreesPerUnit],
+        [crs.zUnit.name, crs.zUnit.metersPerUnit, crs.zUnit.degreesPerUnit],
+        crs.lossy,
+        crs.areaOfUse
+    ]);
+}
+//# sourceMappingURL=crs-metadata.js.map

package/dist/crs/crs-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-metadata.js","sourceRoot":"","sources":["../../src/crs/crs-metadata.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,mGAAmG;AACnG,OAAO,EAAC,WAAW,EAAC,yBAAsB;AAsC1C;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,sFAAsF;IACtF,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,GAAG,CAAC,eAAe;QACnB,GAAG,CAAC,UAAU;QACd,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;aACxB,IAAI,EAAE;aACN,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC;QAC1D,GAAG,CAAC,IAAI;QACR,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;QACnE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;QACnE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;QACnE,GAAG,CAAC,KAAK;QACT,GAAG,CAAC,SAAS;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/crs/crs.d.ts

@@ -0,0 +1,22 @@
+import type { PROJJSONCRS } from "./projjson-types.js";
+/** A registered or named CRS identifier, such as `EPSG:4326` or `WGS84`. */
+export type CRSIdentifier = string;
+/** A coordinate reference system serialized using WKT1 or WKT2. */
+export type WKTCRSDefinition = string;
+/** A coordinate reference system serialized using PROJ string syntax. */
+export type PROJStringDefinition = string;
+/** A serialized or named coordinate reference system definition. */
+export type CRSStringDefinition = CRSIdentifier | WKTCRSDefinition | PROJStringDefinition;
+/** Top-level coordinate reference system object types defined by PROJJSON v0.7. */
+export type PROJJSONCRSType = NonNullable<PROJJSONCRS['type']>;
+type PROJJSONCRSBranchByType<CRS, T> = CRS extends {
+    type?: infer Type;
+} ? T extends Type ? CRS & {
+    type: T;
+} : never : never;
+/** Selects PROJJSON CRS objects with a specific required top-level `type`. */
+export type PROJJSONCRSByType<T extends PROJJSONCRSType> = T extends unknown ? PROJJSONCRSBranchByType<PROJJSONCRS, T> : never;
+/** A serialized CRS definition or a standards-based PROJJSON CRS object. */
+export type CRSDefinition<T extends PROJJSONCRS = PROJJSONCRS> = CRSStringDefinition | T;
+export type { PROJJSONCRS };
+//# sourceMappingURL=crs.d.ts.map

package/dist/crs/crs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs.d.ts","sourceRoot":"","sources":["../../src/crs/crs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,WAAW,EAAC,4BAAyB;AAElD,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,yEAAyE;AACzE,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAE1F,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/D,KAAK,uBAAuB,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,SAAS;IAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAA;CAAC,GAClE,CAAC,SAAS,IAAI,GACZ,GAAG,GAAG;IAAC,IAAI,EAAE,CAAC,CAAA;CAAC,GACf,KAAK,GACP,KAAK,CAAC;AAEV,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,SAAS,OAAO,GACxE,uBAAuB,CAAC,WAAW,EAAE,CAAC,CAAC,GACvC,KAAK,CAAC;AAEV,4EAA4E;AAC5E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,mBAAmB,GAAG,CAAC,CAAC;AAEzF,YAAY,EAAC,WAAW,EAAC,CAAC"}

package/dist/crs/crs.js

@@ -0,0 +1,5 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=crs.js.map

package/dist/crs/crs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs.js","sourceRoot":"","sources":["../../src/crs/crs.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D"}

package/dist/crs/execution-identity.d.ts

@@ -0,0 +1,26 @@
+import type { CRSDescriptor } from "./crs-descriptor-types.js";
+/** Caller-declared execution provenance, not inferred from CRS metadata or callback code.
+ * Change this snapshot whenever any converter's behavior changes. Resource values must
+ * identify contents (e.g. checksums or immutable dataset versions), not mutable URLs.
+ */
+export type CRSExecutionIdentity = Readonly<{
+    backend: string;
+    version: string;
+    /** Selected operation/pipeline and policies applying to all supplied source converters. */
+    operation: string;
+    parameters?: Readonly<Record<string, string | number | boolean | null>>;
+    resources?: Readonly<Record<string, string>>;
+    /** Additional caller revision, including callback state or domain sampling policy. */
+    revision?: string;
+}>;
+/** Validate and freeze an execution identity without loading engines or hashing resources. */
+export declare function createCRSExecutionIdentity(identity: CRSExecutionIdentity): CRSExecutionIdentity;
+/** Deterministic opaque execution key, or null when execution identity is unknown.
+ * Includes CRS signature, converter names and explicit domain geometry. It is not a CRS
+ * equivalence test, cryptographic digest, or complete rendered-mesh cache key. Callers must
+ * also key source data, source CRS, direction, attributes, tessellation and view policy.
+ * Supplying incomplete provenance can still produce unsafe reuse; function bodies and
+ * external resources cannot be inspected here. Recreate descriptors when callbacks change.
+ */
+export declare function getCRSExecutionKey(descriptor: CRSDescriptor): string | null;
+//# sourceMappingURL=execution-identity.d.ts.map

package/dist/crs/execution-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-identity.d.ts","sourceRoot":"","sources":["../../src/crs/execution-identity.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,kCAA+B;AAG1D;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IACxE,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,8FAA8F;AAC9F,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,oBAAoB,CAe/F;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAc3E"}

package/dist/crs/execution-identity.js

@@ -0,0 +1,76 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { createCRSProjectionDomain } from "./projection-domain.js";
+/** Validate and freeze an execution identity without loading engines or hashing resources. */
+export function createCRSExecutionIdentity(identity) {
+    if (!identity || typeof identity !== 'object')
+        throw new TypeError('Invalid execution identity');
+    const backend = nonempty(identity.backend);
+    const version = nonempty(identity.version);
+    const operation = nonempty(identity.operation);
+    const parameters = copyRecord(identity.parameters, false);
+    const resources = copyRecord(identity.resources, true);
+    return Object.freeze({
+        backend,
+        version,
+        operation,
+        parameters,
+        resources,
+        ...(identity.revision === undefined ? {} : { revision: nonempty(identity.revision) })
+    });
+}
+/** Deterministic opaque execution key, or null when execution identity is unknown.
+ * Includes CRS signature, converter names and explicit domain geometry. It is not a CRS
+ * equivalence test, cryptographic digest, or complete rendered-mesh cache key. Callers must
+ * also key source data, source CRS, direction, attributes, tessellation and view policy.
+ * Supplying incomplete provenance can still produce unsafe reuse; function bodies and
+ * external resources cannot be inspected here. Recreate descriptors when callbacks change.
+ */
+export function getCRSExecutionKey(descriptor) {
+    if (descriptor.executionIdentity === undefined)
+        return null;
+    const identity = createCRSExecutionIdentity(descriptor.executionIdentity);
+    const domain = descriptor.projectionDomain === undefined
+        ? null
+        : createCRSProjectionDomain(descriptor.projectionDomain);
+    return JSON.stringify([
+        'math.gl/crs-execution/v1',
+        descriptor.signature,
+        identity,
+        Object.keys(descriptor.converter).sort(),
+        domain
+    ]);
+}
+function nonempty(value) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new TypeError('Invalid execution identity string');
+    return value;
+}
+function copyRecord(value, stringsOnly) {
+    if (value === undefined)
+        return Object.freeze({});
+    if (!value ||
+        typeof value !== 'object' ||
+        Array.isArray(value) ||
+        ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
+        throw new TypeError('Invalid execution identity record');
+    const result = Object.create(null);
+    for (const key of Object.keys(value).sort()) {
+        nonempty(key);
+        const item = value[key];
+        if (stringsOnly)
+            nonempty(item);
+        else if (!(item === null ||
+            typeof item === 'string' ||
+            typeof item === 'boolean' ||
+            (typeof item === 'number' && Number.isFinite(item))))
+            throw new TypeError('Invalid execution parameter');
+        // JSON collapses -0 and 0; reject it rather than claiming identical execution.
+        if (Object.is(item, -0))
+            throw new TypeError('Execution parameters cannot contain negative zero');
+        result[key] = item;
+    }
+    return Object.freeze(result);
+}
+//# sourceMappingURL=execution-identity.js.map

package/dist/crs/execution-identity.js.map

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