@loaders.gl/tiles 5.0.0-alpha.2 → 5.0.0-alpha.3

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

@@ -0,0 +1,233 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getI3SLinearUnitScale, getI3SVerticalUnitScale } from "./i3s-elevation.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
+        ? getWktCoordinateFrame(spatialReference?.wkt)
+        : getIdentifierCoordinateFrame(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 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
+    });
+}
+/** 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;
+}
+/** Classify common EPSG identifiers used by I3S into their coordinate frames. */
+function getIdentifierCoordinateFrame(identifier) {
+    if (identifier === 4978) {
+        return 'geocentric';
+    }
+    if (identifier === 4326 || identifier === 4490 || identifier === 4979) {
+        return 'geographic';
+    }
+    return 'projected';
+}
+/**
+ * Classify a WKT root coordinate system without guessing when the declaration is ambiguous.
+ *
+ * WKT2 uses `GEODCRS` for both geographic and geocentric systems, so its `CS` declaration is
+ * inspected before assigning a frame.
+ */
+function getWktCoordinateFrame(wkt) {
+    if (!wkt) {
+        return 'unknown';
+    }
+    const normalizedWkt = wkt.trim().toUpperCase();
+    const rootKeyword = normalizedWkt.match(/^([A-Z][A-Z0-9_]*)\s*[\[(]/)?.[1];
+    if (rootKeyword === 'GEOCCS') {
+        return 'geocentric';
+    }
+    if (rootKeyword === 'GEOGCS' ||
+        rootKeyword === 'GEOGRAPHICCRS' ||
+        rootKeyword === 'GEOGRAPHIC2DCRS' ||
+        rootKeyword === 'GEOGRAPHIC3DCRS') {
+        return 'geographic';
+    }
+    if (rootKeyword === 'PROJCS' || rootKeyword === 'PROJCRS' || rootKeyword === 'PROJECTEDCRS') {
+        return 'projected';
+    }
+    if (rootKeyword === 'GEODCRS' || rootKeyword === 'GEODETICCRS') {
+        if (/\bCS\s*[\[(]\s*CARTESIAN\s*,\s*3\b/.test(normalizedWkt)) {
+            return 'geocentric';
+        }
+        if (/\bCS\s*[\[(]\s*ELLIPSOIDAL\s*,\s*[23]\b/.test(normalizedWkt)) {
+            return 'geographic';
+        }
+    }
+    return 'unknown';
+}
+/** 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

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

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

package/dist/spatial/get-spatial-coordinate-frame.d.ts

@@ -0,0 +1,9 @@
+import type { ReadonlyCRSDefinition, SpatialReferenceCoordinateFrame } from '@math.gl/crs';
+/**
+ * Classify a CRS definition into the broad coordinate frame used by 3D format adapters.
+ *
+ * @param definition - CRS definition to classify.
+ * @returns The broad geographic, geocentric, projected, local, or unknown frame.
+ */
+export declare function getSpatialCoordinateFrame(definition: ReadonlyCRSDefinition): SpatialReferenceCoordinateFrame;
+//# sourceMappingURL=get-spatial-coordinate-frame.d.ts.map

package/dist/spatial/get-spatial-coordinate-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-spatial-coordinate-frame.d.ts","sourceRoot":"","sources":["../../src/spatial/get-spatial-coordinate-frame.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,qBAAqB,EAAE,+BAA+B,EAAC,MAAM,cAAc,CAAC;AAczF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,qBAAqB,GAChC,+BAA+B,CA+CjC"}

package/dist/spatial/get-spatial-coordinate-frame.js

@@ -0,0 +1,58 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+const GEOGRAPHIC_CRS = 'EPSG:4326';
+const GEOCENTRIC_CRS = 'EPSG:4978';
+/** Normalize common OGC URL and URN CRS spellings to authority identifiers. */
+function normalizeCrsIdentifier(identifier) {
+    const normalizedIdentifier = identifier.trim().toUpperCase();
+    const ogcMatch = normalizedIdentifier.match(/(?:\/DEF\/CRS\/|URN:OGC:DEF:CRS:)([A-Z0-9_-]+)(?:\/|::)(?:[^/:]*[/:])?([A-Z0-9_.-]+)$/);
+    return ogcMatch ? `${ogcMatch[1]}:${ogcMatch[2]}` : normalizedIdentifier;
+}
+/**
+ * Classify a CRS definition into the broad coordinate frame used by 3D format adapters.
+ *
+ * @param definition - CRS definition to classify.
+ * @returns The broad geographic, geocentric, projected, local, or unknown frame.
+ */
+export function getSpatialCoordinateFrame(definition) {
+    if (typeof definition === 'string') {
+        const normalized = normalizeCrsIdentifier(definition);
+        if (normalized === GEOCENTRIC_CRS || /^GEOCCS\s*[\[(]/.test(normalized)) {
+            return 'geocentric';
+        }
+        if (normalized === GEOGRAPHIC_CRS ||
+            normalized === 'EPSG:4490' ||
+            normalized === 'EPSG:4979' ||
+            normalized === 'OGC:CRS84' ||
+            normalized.includes('+PROJ=LONGLAT') ||
+            normalized.includes('+PROJ=LATLONG') ||
+            /^(?:GEOGCS|GEOGCRS|GEOGRAPHICCRS|GEOGRAPHIC2DCRS|GEOGRAPHIC3DCRS)\s*[\[(]/.test(normalized)) {
+            return 'geographic';
+        }
+        if (/^(?:GEODCRS|GEODETICCRS)\s*[\[(]/.test(normalized)) {
+            return /CS\s*[\[(]\s*CARTESIAN/.test(normalized) ? 'geocentric' : 'geographic';
+        }
+        return 'projected';
+    }
+    const projJsonDefinition = definition;
+    if (projJsonDefinition.type === 'BoundCRS' && projJsonDefinition.source_crs) {
+        return getSpatialCoordinateFrame(projJsonDefinition.source_crs);
+    }
+    if (projJsonDefinition.type === 'CompoundCRS' && projJsonDefinition.components?.[0]) {
+        return getSpatialCoordinateFrame(projJsonDefinition.components[0]);
+    }
+    if (String(projJsonDefinition.type).includes('Projected')) {
+        return 'projected';
+    }
+    if (String(projJsonDefinition.type).includes('Geographic')) {
+        return 'geographic';
+    }
+    if (String(projJsonDefinition.type).includes('Geodetic')) {
+        return projJsonDefinition.coordinate_system?.subtype === 'Cartesian'
+            ? 'geocentric'
+            : 'geographic';
+    }
+    return 'projected';
+}
+//# sourceMappingURL=get-spatial-coordinate-frame.js.map

package/dist/spatial/get-spatial-coordinate-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-spatial-coordinate-frame.js","sourceRoot":"","sources":["../../src/spatial/get-spatial-coordinate-frame.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,MAAM,cAAc,GAAG,WAAW,CAAC;AACnC,MAAM,cAAc,GAAG,WAAW,CAAC;AAEnC,+EAA+E;AAC/E,SAAS,sBAAsB,CAAC,UAAkB;IAChD,MAAM,oBAAoB,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CACzC,uFAAuF,CACxF,CAAC;IACF,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAiC;IAEjC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,UAAU,KAAK,cAAc,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACxE,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IACE,UAAU,KAAK,cAAc;YAC7B,UAAU,KAAK,WAAW;YAC1B,UAAU,KAAK,WAAW;YAC1B,UAAU,KAAK,WAAW;YAC1B,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC;YACpC,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC;YACpC,2EAA2E,CAAC,IAAI,CAAC,UAAU,CAAC,EAC5F,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI,kCAAkC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,OAAO,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QACjF,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,kBAAkB,GAAG,UAK1B,CAAC;IACF,IAAI,kBAAkB,CAAC,IAAI,KAAK,UAAU,IAAI,kBAAkB,CAAC,UAAU,EAAE,CAAC;QAC5E,OAAO,yBAAyB,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,kBAAkB,CAAC,IAAI,KAAK,aAAa,IAAI,kBAAkB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,OAAO,yBAAyB,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3D,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACzD,OAAO,kBAAkB,CAAC,iBAAiB,EAAE,OAAO,KAAK,WAAW;YAClE,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,YAAY,CAAC;IACnB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/spatial/i3s-elevation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resolves an ArcGIS/I3S linear unit to meters.
+ *
+ * @param unit - I3S `heightUnit`, `elevationInfo.unit`, or provider unit.
+ * @returns Meters per unit, or `undefined` when the declaration is unsupported.
+ */
+export declare function getI3SLinearUnitScale(unit: string | undefined): number | undefined;
+/**
+ * Resolves the source-Z conversion declared by an I3S layer.
+ *
+ * Legacy `ZFactor` is an explicit conversion to meters and takes precedence over the descriptive
+ * `heightUnit`. This avoids applying the same feet-to-meters conversion twice on layers that
+ * publish both fields.
+ *
+ * @param heightUnit - Unit declared by `heightModelInfo.heightUnit`.
+ * @param zFactor - Legacy layer conversion factor.
+ * @returns Meters per stored Z unit, or `undefined` for an invalid declaration.
+ */
+export declare function getI3SVerticalUnitScale(heightUnit: string | undefined, zFactor: number | undefined): number | undefined;
+//# sourceMappingURL=i3s-elevation.d.ts.map

package/dist/spatial/i3s-elevation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i3s-elevation.d.ts","sourceRoot":"","sources":["../../src/spatial/i3s-elevation.ts"],"names":[],"mappings":"AA6DA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,GAAG,SAAS,CAKpB"}

package/dist/spatial/i3s-elevation.js

@@ -0,0 +1,90 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+const LINEAR_UNIT_TO_METERS = Object.freeze({
+    meter: 1,
+    millimeter: 0.001,
+    centimeter: 0.01,
+    decimeter: 0.1,
+    kilometer: 1000,
+    foot: 0.3048,
+    yard: 0.9144,
+    mile: 1609.344,
+    'us-foot': 1200 / 3937,
+    'us-inch': 0.0254000508001016,
+    'us-yard': 3600 / 3937,
+    'us-mile': 6336000 / 3937,
+    'clarke-foot': 0.3047972654,
+    'clarke-yard': 0.9143917962,
+    'clarke-link': 0.201166195164,
+    'sears-yard': 0.914398414616,
+    'sears-foot': 0.304799471539,
+    'sears-chain': 20.1167651216,
+    'sears-1922-truncated-chain': 20.116756,
+    'benoit-1895-b-chain': 20.1167824944,
+    'indian-yard': 0.914398530744,
+    'indian-1937-yard': 0.91439523,
+    'gold-coast-foot': 0.304799710181
+});
+const LINEAR_UNIT_ALIASES = Object.freeze({
+    m: 'meter',
+    metre: 'meter',
+    meters: 'meter',
+    metres: 'meter',
+    mm: 'millimeter',
+    millimetre: 'millimeter',
+    millimeters: 'millimeter',
+    millimetres: 'millimeter',
+    cm: 'centimeter',
+    centimetre: 'centimeter',
+    centimeters: 'centimeter',
+    centimetres: 'centimeter',
+    dm: 'decimeter',
+    decimetre: 'decimeter',
+    decimeters: 'decimeter',
+    decimetres: 'decimeter',
+    km: 'kilometer',
+    kilometre: 'kilometer',
+    kilometers: 'kilometer',
+    kilometres: 'kilometer',
+    ft: 'foot',
+    feet: 'foot',
+    'us-survey-foot': 'us-foot',
+    'us-survey-feet': 'us-foot',
+    yd: 'yard',
+    yards: 'yard',
+    mi: 'mile',
+    miles: 'mile'
+});
+/**
+ * Resolves an ArcGIS/I3S linear unit to meters.
+ *
+ * @param unit - I3S `heightUnit`, `elevationInfo.unit`, or provider unit.
+ * @returns Meters per unit, or `undefined` when the declaration is unsupported.
+ */
+export function getI3SLinearUnitScale(unit) {
+    if (!unit) {
+        return undefined;
+    }
+    const normalized = unit.trim().toLowerCase().replaceAll('_', '-');
+    const canonical = LINEAR_UNIT_ALIASES[normalized] || normalized;
+    return LINEAR_UNIT_TO_METERS[canonical];
+}
+/**
+ * Resolves the source-Z conversion declared by an I3S layer.
+ *
+ * Legacy `ZFactor` is an explicit conversion to meters and takes precedence over the descriptive
+ * `heightUnit`. This avoids applying the same feet-to-meters conversion twice on layers that
+ * publish both fields.
+ *
+ * @param heightUnit - Unit declared by `heightModelInfo.heightUnit`.
+ * @param zFactor - Legacy layer conversion factor.
+ * @returns Meters per stored Z unit, or `undefined` for an invalid declaration.
+ */
+export function getI3SVerticalUnitScale(heightUnit, zFactor) {
+    if (zFactor !== undefined) {
+        return Number.isFinite(zFactor) && zFactor > 0 ? zFactor : undefined;
+    }
+    return heightUnit ? getI3SLinearUnitScale(heightUnit) : 1;
+}
+//# sourceMappingURL=i3s-elevation.js.map

package/dist/spatial/i3s-elevation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i3s-elevation.js","sourceRoot":"","sources":["../../src/spatial/i3s-elevation.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,MAAM,qBAAqB,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC5E,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,IAAI,GAAG,IAAI;IACtB,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,IAAI,GAAG,IAAI;IACtB,SAAS,EAAE,OAAO,GAAG,IAAI;IACzB,aAAa,EAAE,YAAY;IAC3B,aAAa,EAAE,YAAY;IAC3B,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,aAAa;IAC5B,4BAA4B,EAAE,SAAS;IACvC,qBAAqB,EAAE,aAAa;IACpC,aAAa,EAAE,cAAc;IAC7B,kBAAkB,EAAE,UAAU;IAC9B,iBAAiB,EAAE,cAAc;CAClC,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC1E,CAAC,EAAE,OAAO;IACV,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,OAAO;IACf,EAAE,EAAE,YAAY;IAChB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,YAAY;IACzB,EAAE,EAAE,YAAY;IAChB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,YAAY;IACzB,EAAE,EAAE,WAAW;IACf,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,WAAW;IACvB,UAAU,EAAE,WAAW;IACvB,EAAE,EAAE,WAAW;IACf,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,WAAW;IACvB,UAAU,EAAE,WAAW;IACvB,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,gBAAgB,EAAE,SAAS;IAC3B,gBAAgB,EAAE,SAAS;IAC3B,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;IACb,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;CACd,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,mBAAmB,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;IAChE,OAAO,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAA8B,EAC9B,OAA2B;IAE3B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/spatial/i3s-spatial-transformer.d.ts

@@ -0,0 +1,189 @@
+import { Matrix4 } from '@math.gl/core';
+import type { TilesetCoordinateFrame, TilesetSpatialOptions, TilesetSpatialReference } from "./spatial-types.js";
+/** Minimal I3S oriented bounding box required by the spatial adapter. */
+export type I3SSpatialObb = {
+    /** Center in source CRS coordinates. */
+    center: ArrayLike<number>;
+    /** Half lengths along the oriented axes. */
+    halfSize: ArrayLike<number>;
+    /** Orientation quaternion. */
+    quaternion: ArrayLike<number>;
+};
+/** Input used to rebuild an I3S node bound in the selected output frame. */
+export type I3SSpatialBounds = {
+    /** Minimum bounding sphere encoded as source center plus radius. */
+    mbs?: ArrayLike<number>;
+    /** Oriented source bound, preferred when available. */
+    obb?: I3SSpatialObb;
+    /** Frame in which I3S vectors and quaternions are expressed. */
+    normalReferenceFrame?: string;
+};
+/** Renderer-ready positions and metadata produced for an I3S geometry resource. */
+export type I3STransformedPositions = {
+    /** Float32 offsets from the stable target origin. */
+    positions: Float32Array;
+    /** Reconstructed absolute source positions retained for normal transformation. */
+    sourcePositions: Float64Array;
+    /** Stable origin in target CRS coordinates. */
+    origin: [number, number, number];
+    /** Origin used by geographic deck.gl coordinate systems. */
+    cartographicOrigin: [number, number, number];
+    /** Renderer coordinate-system discriminator. */
+    coordinateSystem: 'cartesian' | 'lnglat-offsets';
+    /** Translation matrix used for Cartesian target offsets. */
+    modelMatrix: Matrix4;
+};
+/**
+ * Applies one normalized I3S horizontal CRS operation consistently to geometry, normals, origins,
+ * and node bounds.
+ */
+export declare class I3SSpatialTransformer {
+    /** Descriptor attached to output after all adapter-owned spatial values have been transformed. */
+    readonly spatialReference: TilesetSpatialReference;
+    /** Broad coordinate frame of the selected output CRS. */
+    readonly targetCoordinateFrame: TilesetCoordinateFrame;
+    /** Source-to-target position operation. */
+    private readonly positionTransformer;
+    /** Source-to-WGS84 geographic operation used for vector-frame conversion. */
+    private readonly sourceToGeographicTransformer;
+    /** WGS84-geographic-to-target operation used for normal finite differences. */
+    private readonly geographicToTargetTransformer;
+    /** Source frame recorded by I3S metadata. */
+    private readonly sourceCoordinateFrame;
+    /** Source Z multiplier that normalizes stored elevation values to meters. */
+    private readonly sourceVerticalUnitScale;
+    /** I3S elevation placement mode. */
+    private readonly elevationMode?;
+    /** I3S elevation offset normalized to meters. */
+    private readonly elevationOffset;
+    /** Terrain or scene provider selected for the declared placement mode. */
+    private readonly elevationProvider?;
+    /** Provider height multiplier that normalizes returned values to meters. */
+    private readonly providerUnitScale;
+    /** Optional provider-height to layer-height datum operation. */
+    private readonly providerHeightTransformer?;
+    /**
+     * Creates an I3S spatial adapter.
+     *
+     * @param spatialReference - Transformable I3S spatial descriptor.
+     * @param options - Registered geoid and custom resource options used by the shared transformer.
+     */
+    constructor(spatialReference: TilesetSpatialReference, options?: TilesetSpatialOptions);
+    /** Transform one absolute I3S source position. */
+    transformPosition(position: ArrayLike<number>): [number, number, number];
+    /** Transform one absolute I3S source position after asynchronous surface placement. */
+    transformPositionAsync(position: ArrayLike<number>): Promise<[number, number, number]>;
+    /** Transform an already placed, meter-normalized position to the requested target. */
+    private transformPlacedPosition;
+    /** Transform one absolute I3S source position to WGS84 longitude, latitude, and height. */
+    transformSourcePositionToGeographic(position: ArrayLike<number>): [number, number, number];
+    /** Transform one source position to WGS84 after asynchronous elevation placement. */
+    transformSourcePositionToGeographicAsync(position: ArrayLike<number>): Promise<[number, number, number]>;
+    /**
+     * Transform absolute Float64 positions and return stable Float32 offsets around a target origin.
+     *
+     * @param sourcePositions - Absolute positions in source CRS order.
+     * @param sourceOrigin - Stable source origin, normally the node MBS or OBB center.
+     */
+    transformPositions(sourcePositions: ArrayLike<number>, sourceOrigin: ArrayLike<number>): I3STransformedPositions;
+    /**
+     * Transform positions after asynchronously sampling any requested terrain or scene surface.
+     *
+     * @param sourcePositions - Absolute positions in source CRS order.
+     * @param sourceOrigin - Stable source origin, normally the node MBS or OBB center.
+     * @returns Renderer-ready target-frame offsets and stable origin metadata.
+     */
+    transformPositionsAsync(sourcePositions: ArrayLike<number>, sourceOrigin: ArrayLike<number>): Promise<I3STransformedPositions>;
+    /** Transform already placed positions into renderer-relative target coordinates. */
+    private transformPlacedPositions;
+    /**
+     * Transform I3S normals into the selected target basis.
+     *
+     * Earth-centered normals are rotated directly. Vertex-reference-frame normals are first mapped
+     * through the local east/north/up basis at each source position.
+     *
+     * @param normals - Three-component normal vectors.
+     * @param sourcePositions - Absolute source position paired with each normal.
+     * @param normalReferenceFrame - I3S normal frame declaration.
+     */
+    transformNormals(normals: ArrayLike<number>, sourcePositions: ArrayLike<number>, normalReferenceFrame?: string): Float32Array;
+    /**
+     * Rebuild an I3S node bound from transformed corner or sphere-axis samples.
+     *
+     * @param bounds - Source MBS/OBB fields.
+     * @returns A generic tile `region` for geographic output or axis-aligned `box` otherwise.
+     */
+    transformBoundingVolume(bounds: I3SSpatialBounds): {
+        box?: number[];
+        region?: number[];
+    };
+    /** Rebuild an I3S bound in the target frame after asynchronous elevation placement. */
+    transformBoundingVolumeAsync(bounds: I3SSpatialBounds): Promise<{
+        box?: number[];
+        region?: number[];
+    }>;
+    /** Rebuild an I3S bound as a WGS84 geographic region for geographic traversal algorithms. */
+    transformBoundingVolumeToGeographic(bounds: I3SSpatialBounds): {
+        region: number[];
+    };
+    /** Rebuild an I3S bound as WGS84 geographic after asynchronous elevation placement. */
+    transformBoundingVolumeToGeographicAsync(bounds: I3SSpatialBounds): Promise<{
+        region: number[];
+    }>;
+    /** Rebuild an I3S bound as a WGS84 ECEF box for generic `Tileset3D` traversal. */
+    transformBoundingVolumeToGeocentric(bounds: I3SSpatialBounds): {
+        box: number[];
+    };
+    /** Rebuild an I3S bound as WGS84 ECEF after asynchronous elevation placement. */
+    transformBoundingVolumeToGeocentricAsync(bounds: I3SSpatialBounds): Promise<{
+        box: number[];
+    }>;
+    /** Return a WGS84 geographic MBS used by the I3S screen-threshold calculation. */
+    transformBoundingSphereToGeographic(bounds: I3SSpatialBounds): [number, number, number, number];
+    /** Return a placed WGS84 MBS used by the I3S screen-threshold calculation. */
+    transformBoundingSphereToGeographicAsync(bounds: I3SSpatialBounds): Promise<[number, number, number, number]>;
+    /**
+     * Rebuild traversal, target-output, and I3S LOD bounds from one elevation-sampling batch.
+     *
+     * @param bounds - Source MBS/OBB fields.
+     * @returns Parallel bounds in WGS84 ECEF, the selected output frame, and WGS84 geographic.
+     */
+    transformBoundsAsync(bounds: I3SSpatialBounds): Promise<{
+        boundingVolume: {
+            box: number[];
+        };
+        spatialBoundingVolume: {
+            box?: number[];
+            region?: number[];
+        };
+        i3sLodMbs: [number, number, number, number];
+    }>;
+    /**
+     * Rebuild Point Cloud traversal and target-output bounds from one elevation-sampling batch.
+     *
+     * @param bounds - Source OBB fields.
+     * @returns WGS84 geographic traversal bound plus the selected output-frame bound.
+     */
+    transformPointCloudBoundsAsync(bounds: I3SSpatialBounds): Promise<{
+        boundingVolume: {
+            region: number[];
+        };
+        spatialBoundingVolume: {
+            box?: number[];
+            region?: number[];
+        };
+    }>;
+    /** Sample a source I3S bound and normalize every sample to WGS84 geographic coordinates. */
+    private getGeographicBoundSamples;
+    /** Sample, place, and normalize one source bound to WGS84 geographic coordinates. */
+    private getGeographicBoundSamplesAsync;
+    /** Apply a provider's conservative surface range to an entire geographic bound footprint. */
+    private placeGeographicBoundSamples;
+    /** Apply source units and non-surface placement without awaiting external resources. */
+    private placeSourcePositionsSync;
+    /** Apply source units and all I3S elevation-placement modes. */
+    private placeSourcePositions;
+    /** Transform one earth-centered normal to the selected target basis. */
+    private transformEcefNormal;
+}
+//# sourceMappingURL=i3s-spatial-transformer.d.ts.map

package/dist/spatial/i3s-spatial-transformer.d.ts.map

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