@loaders.gl/tiles 5.0.0-alpha.1 → 5.0.0-alpha.10

package/dist/raster-set.js

@@ -1,6 +1,7 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { waitForPromiseWithSignals } from '@loaders.gl/loader-utils';
 const DEFAULT_RASTERSET_PROPS = {
     getMetadata: async () => ({
         width: 0,
@@ -18,19 +19,30 @@ const DEFAULT_RASTERSET_PROPS = {
     debounceTime: 0,
     shouldRefetch: () => true
 };
-/** Shared raster request manager used by viewport-driven raster examples and layers. */
+/**
+ * Shared raster request manager used by viewport-driven raster examples and layers.
+ *
+ * @typeParam DataT Raster payload retained by the manager.
+ * @typeParam ParametersT Request parameters accepted by the source.
+ * @typeParam MetadataT Metadata returned by the source.
+ */
 export class RasterSet {
     /** Cached metadata returned by the backing source, if any. */
     metadata = null;
     _opts;
     _listeners = new Set();
     _currentRequest = null;
-    _lastAcceptedRequestId = -1;
     _nextRequestId = 0;
     _loadCounter = 0;
     _timeoutId = null;
     _abortController = null;
+    /** Controller owned by the newest metadata request. */
+    _metadataAbortController = null;
     _finalized = false;
+    /** Generation invalidates metadata from replaced sources. */
+    _sourceGeneration = 0;
+    /** Monotonic metadata request identity. */
+    _metadataRequestId = 0;
     /** Creates a raster manager from a source or direct callbacks. */
     constructor(opts) {
         this._opts = this._normalizeOptions(opts);
@@ -42,6 +54,10 @@ export class RasterSet {
     static fromRasterSource(rasterSource, opts = {}) {
         return new RasterSet({ ...opts, rasterSource });
     }
+    /** Convenience factory for sources whose requests are not viewport-shaped. */
+    static fromCallbacks(opts) {
+        return new RasterSet(opts);
+    }
     /** Whether the manager has no requests in flight and a current raster. */
     get isLoaded() {
         return this._loadCounter === 0 && Boolean(this._currentRequest);
@@ -66,26 +82,46 @@ export class RasterSet {
     /** Updates source callbacks or debounce settings, resetting state when the source changes. */
     setOptions(opts) {
         const previousRasterSource = this._opts.rasterSource;
-        const nextOptions = this._normalizeOptions({ ...this._opts, ...opts });
+        const mergedOptions = { ...this._opts, ...opts };
+        if (opts.rasterSource && opts.rasterSource !== previousRasterSource) {
+            mergedOptions.getRaster = opts.getRaster;
+            mergedOptions.getMetadata = opts.getMetadata;
+        }
+        const nextOptions = this._normalizeOptions(mergedOptions);
         const sourceChanged = previousRasterSource !== nextOptions.rasterSource ||
             this._opts.getRaster !== nextOptions.getRaster ||
             this._opts.getMetadata !== nextOptions.getMetadata;
         this._opts = nextOptions;
         if (sourceChanged) {
             this._cancelScheduledRaster();
+            this._abortActiveRequest();
+            this._metadataAbortController?.abort();
+            this._sourceGeneration++;
             this.metadata = null;
             this._currentRequest = null;
-            this._lastAcceptedRequestId = -1;
-            this._nextRequestId = 0;
             this._emitUpdate();
         }
     }
     /** Loads metadata from the current raster source or callbacks. */
-    async loadMetadata() {
-        this._startLoading();
+    async loadMetadata(options = {}) {
+        if (this._finalized)
+            throw new Error('RasterSet is finalized');
+        options.signal?.throwIfAborted();
+        this._metadataAbortController?.abort();
+        const abortController = new AbortController();
+        this._metadataAbortController = abortController;
+        const abortFromCaller = () => abortController.abort(options.signal?.reason);
+        options.signal?.addEventListener('abort', abortFromCaller, { once: true });
+        const metadataRequestId = ++this._metadataRequestId;
+        const generation = this._sourceGeneration;
         try {
-            const metadata = await this._opts.getMetadata();
-            if (this._finalized) {
+            this._startLoading();
+            abortController.signal.throwIfAborted();
+            const metadata = await waitForPromiseWithSignals(signal => this._opts.getMetadata({ signal }), [abortController.signal]);
+            abortController.signal.throwIfAborted();
+            if (this._finalized ||
+                generation !== this._sourceGeneration ||
+                metadataRequestId !== this._metadataRequestId) {
                 return metadata;
             }
             this.metadata = metadata;
@@ -96,8 +132,14 @@ export class RasterSet {
             return metadata;
         }
         catch (error) {
+            if (abortController.signal.aborted)
+                throw abortController.signal.reason;
+            if (isAbortError(error))
+                throw error;
             const normalizedError = normalizeRasterSetError(error, 'Raster metadata request failed');
-            if (!this._finalized) {
+            if (!this._finalized &&
+                generation === this._sourceGeneration &&
+                metadataRequestId === this._metadataRequestId) {
                 for (const listener of this._listeners) {
                     listener.onMetadataLoadError?.(normalizedError);
                 }
@@ -105,16 +147,25 @@ export class RasterSet {
             throw normalizedError;
         }
         finally {
+            options.signal?.removeEventListener('abort', abortFromCaller);
+            if (this._metadataAbortController === abortController)
+                this._metadataAbortController = null;
             this._finishLoading();
         }
     }
     /** Debounces and issues a new raster request for the supplied parameters. */
     requestRaster(parameters, debounceTime = this._opts.debounceTime) {
+        if (this._finalized)
+            return -1;
         if (!this.shouldRefetchRaster(parameters)) {
+            this._cancelScheduledRaster();
+            this._abortActiveRequest();
+            this._nextRequestId++;
             return this._currentRequest?.requestId ?? -1;
         }
         const requestId = this._nextRequestId++;
         this._cancelScheduledRaster();
+        this._abortActiveRequest();
         if (debounceTime > 0) {
             this._timeoutId = setTimeout(() => {
                 this._timeoutId = null;
@@ -139,6 +190,9 @@ export class RasterSet {
         this._finalized = true;
         this._cancelScheduledRaster();
         this._abortActiveRequest();
+        this._metadataAbortController?.abort();
+        this._metadataAbortController = null;
+        this._loadCounter = 0;
         this._listeners.clear();
     }
     /** Loads a raster immediately and accepts it only if it is the newest completed request. */
@@ -146,20 +200,25 @@ export class RasterSet {
         if (this._finalized) {
             return;
         }
+        const callerSignal = parameters.signal;
+        if (callerSignal?.aborted)
+            return;
+        const abortController = new AbortController();
+        this._abortController = abortController;
+        const abortFromCaller = () => abortController.abort(callerSignal?.reason);
+        callerSignal?.addEventListener('abort', abortFromCaller, { once: true });
         this._startLoading();
-        for (const listener of this._listeners) {
-            listener.onRasterLoadStart?.(requestId, parameters);
-        }
         try {
-            const abortController = new AbortController();
-            this._abortController = abortController;
-            const raster = await this._opts.getRaster({ ...parameters, signal: abortController.signal });
+            abortController.signal.throwIfAborted();
+            for (const listener of this._listeners)
+                listener.onRasterLoadStart?.(requestId, parameters);
+            abortController.signal.throwIfAborted();
+            const raster = await waitForPromiseWithSignals(signal => this._opts.getRaster(withAbortSignal(parameters, signal)), [abortController.signal]);
             if (this._finalized ||
                 abortController.signal.aborted ||
-                requestId <= this._lastAcceptedRequestId) {
+                requestId !== this._nextRequestId - 1) {
                 return;
             }
-            this._lastAcceptedRequestId = requestId;
             this._currentRequest = { requestId, parameters, raster };
             for (const listener of this._listeners) {
                 listener.onRasterLoad?.(this._currentRequest);
@@ -167,18 +226,20 @@ export class RasterSet {
             this._emitUpdate();
         }
         catch (error) {
-            if (isAbortError(error)) {
+            if (abortController.signal.aborted || isAbortError(error)) {
                 return;
             }
             const normalizedError = normalizeRasterSetError(error, 'Raster request failed');
-            if (!this._finalized) {
+            if (!this._finalized && requestId === this._nextRequestId - 1) {
                 for (const listener of this._listeners) {
                     listener.onRasterLoadError?.(requestId, normalizedError, parameters);
                 }
             }
         }
         finally {
-            this._abortController = null;
+            callerSignal?.removeEventListener('abort', abortFromCaller);
+            if (this._abortController === abortController)
+                this._abortController = null;
             this._finishLoading();
         }
     }
@@ -190,9 +251,9 @@ export class RasterSet {
             ...opts,
             rasterSource,
             getMetadata: opts.getMetadata ||
-                (() => {
+                (options => {
                     if (rasterSource) {
-                        return rasterSource.getMetadata();
+                        return rasterSource.getMetadata(options);
                     }
                     return DEFAULT_RASTERSET_PROPS.getMetadata();
                 }),
@@ -210,12 +271,16 @@ export class RasterSet {
     }
     /** Emits one generic update notification to all subscribers. */
     _emitUpdate() {
+        if (this._finalized)
+            return;
         for (const listener of this._listeners) {
             listener.onUpdate?.();
         }
     }
     /** Emits one loading-state transition to all subscribers. */
     _emitLoadingStateChange(isLoading) {
+        if (this._finalized)
+            return;
         for (const listener of this._listeners) {
             listener.onLoadingStateChange?.(isLoading);
         }
@@ -251,6 +316,21 @@ export class RasterSet {
         this._abortController = null;
     }
 }
+/** Adds cancellation to a request while preserving its array/prototype shape. */
+function withAbortSignal(parameters, signal) {
+    const descriptors = Object.getOwnPropertyDescriptors(parameters);
+    delete descriptors.signal;
+    const request = Array.isArray(parameters)
+        ? Object.defineProperties(parameters.slice(), descriptors)
+        : Object.create(Object.getPrototypeOf(parameters), descriptors);
+    Object.defineProperty(request, 'signal', {
+        configurable: true,
+        enumerable: true,
+        value: signal,
+        writable: true
+    });
+    return request;
+}
 /** Normalizes arbitrary thrown values to `Error` instances for raster-set callbacks. */
 function normalizeRasterSetError(error, message) {
     if (error instanceof Error) {

package/dist/raster-set.js.map

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

package/dist/spatial/format-spatial-reference.d.ts

@@ -0,0 +1,68 @@
+import type { ReadonlyCRSDefinition } from '@math.gl/crs';
+import type { TilesetSpatialReference } from "./spatial-types.js";
+/** ArcGIS/I3S spatial reference fields used without depending on the I3S package. */
+type I3SSpatialReferenceLike = {
+    wkid?: number;
+    latestWkid?: number;
+    vcsWkid?: number;
+    latestVcsWkid?: number;
+    wkt?: string;
+};
+/** I3S layer fields needed for spatial metadata discovery. */
+type I3SLayerLike = {
+    spatialReference?: I3SSpatialReferenceLike;
+    fullExtent?: {
+        spatialReference?: I3SSpatialReferenceLike;
+    };
+    heightModelInfo?: {
+        heightModel?: string;
+        vertCRS?: ReadonlyCRSDefinition;
+        heightUnit?: string;
+    };
+    ZFactor?: number;
+    elevationInfo?: {
+        mode?: string;
+        offset?: number;
+        unit?: string;
+    };
+};
+/** 3D Tiles document fields needed for CRS semantic discovery. */
+type Tiles3DLike = {
+    schema?: {
+        classes?: Record<string, unknown>;
+    };
+    schemaUri?: string;
+    metadata?: {
+        class?: string;
+        properties?: Record<string, unknown>;
+    };
+    root?: {
+        boundingVolume?: {
+            region?: unknown;
+        };
+    };
+    extensions?: Record<string, unknown>;
+};
+/**
+ * Discovers normalized spatial metadata from an I3S scene-layer document.
+ *
+ * I3S encodes geographic coordinates in longitude/latitude wire order even for authority
+ * definitions whose formal axis order differs.
+ *
+ * @param layer - Parsed I3S layer document.
+ * @returns Normalized source spatial metadata.
+ */
+export declare function getI3SSpatialReference(layer: I3SLayerLike): TilesetSpatialReference;
+/**
+ * Discovers the 3D Tiles geocentric CRS and coordinate epoch from structured metadata semantics.
+ *
+ * The method intentionally does not infer ECEF from coordinate magnitude. A root `region`
+ * establishes the format's global ellipsoidal frame, while local tilesets without an explicit
+ * semantic remain unknown.
+ *
+ * @param tileset - Parsed 3D Tiles tileset document.
+ * @returns Normalized source spatial metadata.
+ */
+export declare function get3DTilesSpatialReference(tileset: Tiles3DLike): TilesetSpatialReference;
+export {};
+//# sourceMappingURL=format-spatial-reference.d.ts.map

package/dist/spatial/format-spatial-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-spatial-reference.d.ts","sourceRoot":"","sources":["../../src/spatial/format-spatial-reference.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,cAAc,CAAC;AAOxD,OAAO,KAAK,EAAuB,uBAAuB,EAAC,2BAAwB;AAEnF,qFAAqF;AACrF,KAAK,uBAAuB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,8DAA8D;AAC9D,KAAK,YAAY,GAAG;IAClB,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,UAAU,CAAC,EAAE;QAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;KAAC,CAAC;IAC1D,eAAe,CAAC,EAAE;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,qBAAqB,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;CACjE,CAAC;AAKF,kEAAkE;AAClE,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAC,CAAC;IAClE,IAAI,CAAC,EAAE;QAAC,cAAc,CAAC,EAAE;YAAC,MAAM,CAAC,EAAE,OAAO,CAAA;SAAC,CAAA;KAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,uBAAuB,CAqEnF;AA8BD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,WAAW,GAAG,uBAAuB,CA8CxF"}

package/dist/spatial/format-spatial-reference.js

@@ -0,0 +1,291 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getI3SLinearUnitScale, getI3SVerticalUnitScale } from "./i3s-elevation.js";
+import { getKnownCrsIdentifierCoordinateFrame, getSpatialCoordinateFrame } from "./get-spatial-coordinate-frame.js";
+import { createTilesetSpatialReference } from "./spatial-types.js";
+/**
+ * Discovers normalized spatial metadata from an I3S scene-layer document.
+ *
+ * I3S encodes geographic coordinates in longitude/latitude wire order even for authority
+ * definitions whose formal axis order differs.
+ *
+ * @param layer - Parsed I3S layer document.
+ * @returns Normalized source spatial metadata.
+ */
+export function getI3SSpatialReference(layer) {
+    const spatialReference = layer.spatialReference || layer.fullExtent?.spatialReference;
+    const sourceCrs = getI3SCrsDefinition(spatialReference);
+    const verticalCrs = layer.heightModelInfo?.vertCRS || getI3SVerticalCrsDefinition(spatialReference);
+    const heightModel = layer.heightModelInfo?.heightModel;
+    const verticalUnit = layer.heightModelInfo?.heightUnit;
+    const verticalUnitScale = getI3SVerticalUnitScale(verticalUnit, layer.ZFactor);
+    const heightReference = heightModel === 'ellipsoidal'
+        ? 'ellipsoidal'
+        : heightModel === 'gravity_related_height'
+            ? 'orthometric'
+            : 'unknown';
+    const sourceIdentifier = getCrsIdentifier(spatialReference);
+    const coordinateFrame = sourceIdentifier === undefined
+        ? sourceCrs
+            ? getSpatialCoordinateFrame(sourceCrs)
+            : 'unknown'
+        : getSpatialCoordinateFrame(`EPSG:${sourceIdentifier}`);
+    const units = getI3SCoordinateUnits(coordinateFrame, verticalUnit, layer.ZFactor);
+    const warnings = [];
+    const elevationMode = getI3SElevationMode(layer.elevationInfo?.mode);
+    const elevationUnit = layer.elevationInfo ? layer.elevationInfo.unit || 'meter' : undefined;
+    const elevationUnitScale = getI3SLinearUnitScale(elevationUnit);
+    if (verticalUnitScale === undefined) {
+        warnings.push(layer.ZFactor !== undefined
+            ? `I3S ZFactor ${layer.ZFactor} is not a positive finite conversion factor`
+            : `Unsupported I3S vertical unit ${verticalUnit}`);
+    }
+    if (layer.elevationInfo && elevationUnitScale === undefined) {
+        warnings.push(`Unsupported I3S elevation unit ${elevationUnit}`);
+    }
+    if (layer.elevationInfo?.mode && !elevationMode) {
+        warnings.push(`Unsupported I3S elevation mode ${layer.elevationInfo.mode}`);
+    }
+    if (elevationMode && elevationMode !== 'absoluteHeight') {
+        warnings.push(`I3S elevation mode ${elevationMode} requires a terrain or scene elevation provider`);
+    }
+    return createTilesetSpatialReference({
+        sourceCrs,
+        sourceCrsRepresentation: sourceIdentifier !== undefined ? 'identifier' : sourceCrs ? 'wkt' : undefined,
+        sourceCrsAlternatives: sourceIdentifier !== undefined && spatialReference?.wkt
+            ? [{ definition: spatialReference.wkt, representation: 'wkt' }]
+            : undefined,
+        verticalCrs,
+        units,
+        verticalUnitScale: verticalUnitScale ?? Number.NaN,
+        heightReference,
+        elevationMode,
+        elevationOffset: layer.elevationInfo?.offset,
+        elevationUnit,
+        elevationUnitScale: layer.elevationInfo?.mode && !elevationMode
+            ? Number.NaN
+            : (elevationUnitScale ?? (layer.elevationInfo ? Number.NaN : 1)),
+        coordinateFrame,
+        axisOrder: sourceCrs ? 'xyz' : 'unknown',
+        provenance: sourceCrs ? 'metadata' : 'unknown',
+        warnings
+    });
+}
+/** Return per-component I3S units only when their coordinate association is unambiguous. */
+function getI3SCoordinateUnits(coordinateFrame, verticalUnit, zFactor) {
+    if (coordinateFrame === 'geocentric') {
+        return ['meter', 'meter', 'meter'];
+    }
+    if (coordinateFrame === 'geographic' && (verticalUnit || zFactor === undefined)) {
+        return ['degree', 'degree', verticalUnit || 'meter'];
+    }
+    return undefined;
+}
+/** Return a supported I3S elevation mode without widening the public descriptor. */
+function getI3SElevationMode(mode) {
+    switch (mode) {
+        case 'absoluteHeight':
+        case 'onTheGround':
+        case 'relativeToGround':
+        case 'relativeToScene':
+            return mode;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Discovers the 3D Tiles geocentric CRS and coordinate epoch from structured metadata semantics.
+ *
+ * The method intentionally does not infer ECEF from coordinate magnitude. A root `region`
+ * establishes the format's global ellipsoidal frame, while local tilesets without an explicit
+ * semantic remain unknown.
+ *
+ * @param tileset - Parsed 3D Tiles tileset document.
+ * @returns Normalized source spatial metadata.
+ */
+export function get3DTilesSpatialReference(tileset) {
+    const draftSpatialReference = getDraft3DTilesSpatialReference(tileset);
+    if (draftSpatialReference) {
+        return draftSpatialReference;
+    }
+    const geocentricCrs = getTilesetSemanticValue(tileset, 'TILESET_CRS_GEOCENTRIC');
+    const coordinateEpoch = getTilesetSemanticValue(tileset, 'TILESET_CRS_COORDINATE_EPOCH');
+    const warnings = [];
+    let sourceCrs;
+    let provenance = 'unknown';
+    let sourceCrsState;
+    if (typeof geocentricCrs === 'string' && geocentricCrs.toUpperCase() !== 'UNKNOWN') {
+        sourceCrs = geocentricCrs;
+        provenance = 'metadata';
+        sourceCrsState = 'explicit';
+    }
+    else if (geocentricCrs !== undefined) {
+        warnings.push('3D Tiles geocentric CRS is explicitly unknown');
+        provenance = 'metadata';
+        sourceCrsState = 'unknown';
+    }
+    else if (tileset.root?.boundingVolume?.region) {
+        sourceCrs = 'EPSG:4978';
+        provenance = 'format-default';
+        sourceCrsState = 'default';
+    }
+    else if (tileset.schemaUri && !tileset.schema) {
+        warnings.push('External 3D Tiles metadata schema must be loaded before CRS semantics can resolve');
+    }
+    const epoch = parseCoordinateEpoch(coordinateEpoch);
+    if (coordinateEpoch !== undefined && epoch === undefined) {
+        warnings.push('3D Tiles coordinate epoch is not a finite decimal year');
+    }
+    return createTilesetSpatialReference({
+        sourceCrs,
+        sourceCrsState,
+        sourceCrsRepresentation: sourceCrs ? 'identifier' : undefined,
+        coordinateEpoch: epoch,
+        heightReference: sourceCrs ? 'ellipsoidal' : 'unknown',
+        coordinateFrame: sourceCrs ? 'geocentric' : 'unknown',
+        axisOrder: sourceCrs ? 'xyz' : 'unknown',
+        provenance,
+        warnings
+    });
+}
+/** Resolves the draft glTF EXT_geospatial_crs WKID or WKT2 declaration. */
+function getDraft3DTilesSpatialReference(tileset) {
+    const extension = tileset.extensions?.EXT_geospatial_crs;
+    if (!extension) {
+        return undefined;
+    }
+    const warnings = [];
+    let sourceCrs;
+    let verticalCrs;
+    let epoch;
+    let representation;
+    if (extension.format === 'wkid') {
+        const wkidExtension = extension.extensions?.EXT_geospatial_crs_wkid;
+        if (typeof wkidExtension?.authority === 'string' && Number.isInteger(wkidExtension.wkid)) {
+            sourceCrs = `${wkidExtension.authority}:${wkidExtension.wkid}`;
+            representation = 'identifier';
+            if (Number.isInteger(wkidExtension.vcsWkid)) {
+                verticalCrs = `${wkidExtension.authority}:${wkidExtension.vcsWkid}`;
+            }
+            epoch = parseCoordinateEpoch(wkidExtension.epoch);
+            if (wkidExtension.epoch !== undefined && epoch === undefined) {
+                warnings.push('EXT_geospatial_crs_wkid epoch is not a finite decimal year');
+            }
+        }
+        else {
+            warnings.push('EXT_geospatial_crs_wkid requires string authority and integer wkid');
+        }
+    }
+    else if (extension.format === 'wkt2') {
+        const wktExtension = extension.extensions?.EXT_geospatial_crs_wkt2;
+        if (typeof wktExtension?.wkt2 === 'string' && wktExtension.wkt2.trim()) {
+            sourceCrs = wktExtension.wkt2;
+            representation = 'wkt';
+        }
+        else {
+            warnings.push('EXT_geospatial_crs_wkt2 requires a nonempty wkt2 string');
+        }
+    }
+    else {
+        warnings.push(`Unsupported EXT_geospatial_crs format ${String(extension.format)}`);
+    }
+    const coordinateFrame = representation === 'wkt'
+        ? getSpatialCoordinateFrame(sourceCrs)
+        : getKnownCrsIdentifierCoordinateFrame(sourceCrs) || 'unknown';
+    const verticalSemantics = getDraftVerticalCrsSemantics(verticalCrs);
+    if (verticalCrs && !verticalSemantics) {
+        warnings.push(`Unsupported vertical CRS ${String(verticalCrs)}; vertical unit and height reference are unknown`);
+    }
+    const verticalUnit = verticalCrs ? verticalSemantics?.unit : 'meter';
+    return createTilesetSpatialReference({
+        sourceCrs,
+        sourceCrsState: sourceCrs ? 'explicit' : 'unknown',
+        sourceCrsRepresentation: representation,
+        verticalCrs,
+        coordinateEpoch: epoch,
+        units: coordinateFrame === 'geocentric'
+            ? ['meter', 'meter', 'meter']
+            : coordinateFrame === 'geographic' && verticalUnit
+                ? ['degree', 'degree', verticalUnit]
+                : undefined,
+        verticalUnitScale: verticalCrs ? (verticalSemantics?.verticalUnitScale ?? Number.NaN) : 1,
+        heightReference: verticalCrs
+            ? (verticalSemantics?.heightReference ?? 'unknown')
+            : sourceCrs
+                ? 'ellipsoidal'
+                : 'unknown',
+        coordinateFrame,
+        axisOrder: sourceCrs ? 'xyz' : 'unknown',
+        provenance: 'metadata',
+        warnings
+    });
+}
+/** Resolves vertical units and height interpretation for known EPSG vertical CRSs. */
+function getDraftVerticalCrsSemantics(verticalCrs) {
+    if (typeof verticalCrs !== 'string') {
+        return undefined;
+    }
+    const epsgMatch = /^EPSG:(\d+)$/i.exec(verticalCrs);
+    if (!epsgMatch) {
+        return undefined;
+    }
+    switch (Number(epsgMatch[1])) {
+        case 5702: // NGVD29 height (ftUS)
+        case 6360: // NAVD88 height (ftUS)
+            return {
+                unit: 'us-foot',
+                verticalUnitScale: 1200 / 3937,
+                heightReference: 'orthometric'
+            };
+        case 5703: // NAVD88 height
+            return { unit: 'meter', verticalUnitScale: 1, heightReference: 'orthometric' };
+        default:
+            return undefined;
+    }
+}
+/** Parse the 3D Tiles decimal-year string while tolerating legacy numeric producer output. */
+function parseCoordinateEpoch(value) {
+    if (typeof value !== 'string' && typeof value !== 'number') {
+        return undefined;
+    }
+    if (typeof value === 'string' && !value.trim()) {
+        return undefined;
+    }
+    const epoch = Number(value);
+    return Number.isFinite(epoch) ? epoch : undefined;
+}
+/** Return an I3S horizontal CRS definition, preferring current WKID aliases over legacy values. */
+function getI3SCrsDefinition(spatialReference) {
+    const identifier = getCrsIdentifier(spatialReference);
+    if (identifier !== undefined) {
+        return `EPSG:${identifier}`;
+    }
+    return spatialReference?.wkt;
+}
+/** Return an I3S vertical CRS definition. */
+function getI3SVerticalCrsDefinition(spatialReference) {
+    const identifier = spatialReference?.latestVcsWkid ?? spatialReference?.vcsWkid;
+    return identifier === undefined ? undefined : `EPSG:${identifier}`;
+}
+/** Return the preferred horizontal WKID. */
+function getCrsIdentifier(spatialReference) {
+    return spatialReference?.latestWkid ?? spatialReference?.wkid;
+}
+/** Resolve a tileset-wide structured metadata property by its standard semantic. */
+function getTilesetSemanticValue(tileset, semantic) {
+    const classIdentifier = tileset.metadata?.class;
+    if (!classIdentifier) {
+        return undefined;
+    }
+    const classDefinition = tileset.schema?.classes?.[classIdentifier];
+    const propertyDefinitions = classDefinition?.properties;
+    const propertyValues = tileset.metadata?.properties;
+    for (const [propertyIdentifier, propertyDefinition] of Object.entries(propertyDefinitions || {})) {
+        if (propertyDefinition.semantic === semantic) {
+            return propertyValues?.[propertyIdentifier];
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=format-spatial-reference.js.map