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

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

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,20 @@
+import { type ReadonlyCRSDefinition, type 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;
+/**
+ * Classifies authority identifiers for which the tiles runtime has explicit frame knowledge.
+ *
+ * Unlike {@link getSpatialCoordinateFrame}, this function does not assume that an unrecognized
+ * authority identifier is projected. Draft formats use this strict result to avoid inventing
+ * semantics for unknown authorities or registry codes.
+ *
+ * @param definition - Serialized CRS identifier.
+ * @returns A known frame, or `undefined` when registry semantics are unavailable.
+ */
+export declare function getKnownCrsIdentifierCoordinateFrame(definition: ReadonlyCRSDefinition | undefined): SpatialReferenceCoordinateFrame | undefined;
+//# 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,EAIL,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EAErC,MAAM,cAAc,CAAC;AAOtB;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,qBAAqB,GAChC,+BAA+B,CAoCjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,qBAAqB,GAAG,SAAS,GAC5C,+BAA+B,GAAG,SAAS,CA8B7C"}

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

@@ -0,0 +1,139 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { inferCRSRepresentation, parsePROJString, parseWKTCRS } from '@math.gl/crs';
+import { normalizeCrsIdentifier, WGS84_GEOCENTRIC_CRS, WGS84_GEOGRAPHIC_CRS } from "./normalize-crs-identifier.js";
+/**
+ * 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 representation = inferCRSRepresentation(definition);
+        if (representation === 'wkt') {
+            return getWktCoordinateFrame(definition);
+        }
+        if (representation === 'proj-string') {
+            return getProjStringCoordinateFrame(definition);
+        }
+        return getKnownCrsIdentifierCoordinateFrame(definition) || '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 'unknown';
+}
+/**
+ * Classifies authority identifiers for which the tiles runtime has explicit frame knowledge.
+ *
+ * Unlike {@link getSpatialCoordinateFrame}, this function does not assume that an unrecognized
+ * authority identifier is projected. Draft formats use this strict result to avoid inventing
+ * semantics for unknown authorities or registry codes.
+ *
+ * @param definition - Serialized CRS identifier.
+ * @returns A known frame, or `undefined` when registry semantics are unavailable.
+ */
+export function getKnownCrsIdentifierCoordinateFrame(definition) {
+    if (typeof definition !== 'string') {
+        return undefined;
+    }
+    const normalized = normalizeCrsIdentifier(definition);
+    if (normalized === WGS84_GEOCENTRIC_CRS) {
+        return 'geocentric';
+    }
+    if (normalized === WGS84_GEOGRAPHIC_CRS || normalized === 'OGC:CRS84') {
+        return 'geographic';
+    }
+    const epsgMatch = /^EPSG:(\d+)$/.exec(normalized);
+    if (!epsgMatch) {
+        return undefined;
+    }
+    const identifier = Number(epsgMatch[1]);
+    if (identifier === 7789) {
+        return 'geocentric';
+    }
+    if (identifier === 4490 || identifier === 4979) {
+        return 'geographic';
+    }
+    if (identifier === 3857 ||
+        (identifier >= 32601 && identifier <= 32660) ||
+        (identifier >= 32701 && identifier <= 32760)) {
+        return 'projected';
+    }
+    return undefined;
+}
+/** Classifies a WKT definition using the syntax tree parsed by `@math.gl/crs`. */
+function getWktCoordinateFrame(definition) {
+    let root;
+    try {
+        root = parseWKTCRS(definition).root;
+    }
+    catch {
+        return 'unknown';
+    }
+    switch (root.keyword.toUpperCase()) {
+        case 'GEOCCS':
+            return 'geocentric';
+        case 'GEOGCS':
+        case 'GEOGCRS':
+        case 'GEOGRAPHICCRS':
+        case 'GEOGRAPHIC2DCRS':
+        case 'GEOGRAPHIC3DCRS':
+            return 'geographic';
+        case 'PROJCS':
+        case 'PROJCRS':
+        case 'PROJECTEDCRS':
+            return 'projected';
+        case 'GEODCRS':
+        case 'GEODETICCRS': {
+            const coordinateSystem = root.values.find((value) => value.type === 'node' && value.keyword.toUpperCase() === 'CS');
+            const subtype = coordinateSystem?.values[0];
+            if (subtype?.type !== 'enumeration' && subtype?.type !== 'string') {
+                return 'unknown';
+            }
+            return subtype.value.toUpperCase() === 'CARTESIAN'
+                ? 'geocentric'
+                : subtype.value.toUpperCase() === 'ELLIPSOIDAL'
+                    ? 'geographic'
+                    : 'unknown';
+        }
+        default:
+            return 'unknown';
+    }
+}
+/** Classifies a PROJ string using the syntax tree parsed by `@math.gl/crs`. */
+function getProjStringCoordinateFrame(definition) {
+    try {
+        const projection = parsePROJString(definition).parameters.find(parameter => parameter.name.toLowerCase() === 'proj')?.value;
+        switch (projection?.toLowerCase()) {
+            case 'longlat':
+            case 'latlong':
+                return 'geographic';
+            case 'geocent':
+                return 'geocentric';
+            default:
+                return projection ? 'projected' : 'unknown';
+        }
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# 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":"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"}

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"}