@deck.gl/core 9.3.0-alpha.2 → 9.3.0-alpha.3

package/dist/controllers/terrain-controller.d.ts

@@ -0,0 +1,29 @@
+import MapController from "./map-controller.js";
+import { MapState, MapStateProps } from "./map-controller.js";
+import type { ControllerProps, InteractionState } from "./controller.js";
+import type { MjolnirGestureEvent, MjolnirWheelEvent } from 'mjolnir.js';
+/**
+ * Controller that extends MapController with terrain-aware behavior.
+ * The camera smoothly follows terrain elevation during pan/zoom.
+ */
+export default class TerrainController extends MapController {
+    /** Cached terrain altitude from depth picking at viewport center (smoothed) */
+    private _terrainAltitude?;
+    /** Raw (unsmoothed) terrain altitude from latest pick */
+    private _terrainAltitudeTarget?;
+    setProps(props: ControllerProps & MapStateProps & {
+        rotationPivot?: 'center' | '2d' | '3d';
+        getAltitude?: (pos: [number, number]) => number | undefined;
+    }): void;
+    protected updateViewport(newControllerState: MapState, extraProps?: Record<string, any> | null, interactionState?: InteractionState): void;
+    protected _onPanStart(event: MjolnirGestureEvent): boolean;
+    protected _onWheel(event: MjolnirWheelEvent): boolean;
+    protected _onDoubleClick(event: MjolnirGestureEvent): boolean;
+    private _pickTerrainCenterAltitude;
+    /**
+     * Utility function to return viewport that looks the same, but with
+     * a position shifted to [0, 0, altitude]
+     */
+    private _rebaseViewport;
+}
+//# sourceMappingURL=terrain-controller.d.ts.map

package/dist/controllers/terrain-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-controller.d.ts","sourceRoot":"","sources":["../../src/controllers/terrain-controller.ts"],"names":[],"mappings":"AAIA,OAAO,aAAa,4BAAyB;AAC7C,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,4BAAyB;AACzD,OAAO,KAAK,EAAC,eAAe,EAAE,gBAAgB,EAAC,wBAAqB;AACpE,OAAO,KAAK,EAAC,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,YAAY,CAAC;AAEvE;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa;IAC1D,+EAA+E;IAC/E,OAAO,CAAC,gBAAgB,CAAC,CAAqB;IAC9C,yDAAyD;IACzD,OAAO,CAAC,sBAAsB,CAAC,CAAqB;IAEpD,QAAQ,CACN,KAAK,EAAE,eAAe,GACpB,aAAa,GAAG;QACd,aAAa,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;QACvC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;KAC7D;IAoBL,SAAS,CAAC,cAAc,CACtB,kBAAkB,EAAE,QAAQ,EAC5B,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,EAC7C,gBAAgB,GAAE,gBAAqB,GACtC,IAAI;IA6BP,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO;IAK1D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAKrD,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO;IAK7D,OAAO,CAAC,0BAA0B;IAYlC;;;OAGG;IACH,OAAO,CAAC,eAAe;CAqCxB"}

package/dist/controllers/terrain-controller.js

@@ -0,0 +1,108 @@
+// deck.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import MapController from "./map-controller.js";
+/**
+ * Controller that extends MapController with terrain-aware behavior.
+ * The camera smoothly follows terrain elevation during pan/zoom.
+ */
+export default class TerrainController extends MapController {
+    constructor() {
+        super(...arguments);
+        /** Cached terrain altitude from depth picking at viewport center (smoothed) */
+        this._terrainAltitude = undefined;
+        /** Raw (unsmoothed) terrain altitude from latest pick */
+        this._terrainAltitudeTarget = undefined;
+    }
+    setProps(props) {
+        super.setProps({ rotationPivot: '3d', ...props });
+        // Drive smoothing animation when terrain altitude hasn't converged yet.
+        if (this._terrainAltitude !== undefined &&
+            this._terrainAltitudeTarget !== undefined &&
+            Math.abs(this._terrainAltitudeTarget - this._terrainAltitude) > 0.01) {
+            this.updateViewport(new this.ControllerState({
+                makeViewport: this.makeViewport,
+                ...this.props,
+                ...this.state
+            }));
+        }
+    }
+    updateViewport(newControllerState, extraProps = null, interactionState = {}) {
+        const SMOOTHING = 0.05;
+        // No interactions yet, do not update
+        if (this._terrainAltitudeTarget === undefined)
+            return;
+        if (this._terrainAltitude === undefined) {
+            // First interaction, rebase to avoid jump
+            this._terrainAltitude = this._terrainAltitudeTarget;
+            extraProps = this._rebaseViewport(this._terrainAltitudeTarget, newControllerState, extraProps);
+        }
+        else {
+            // Standard interaction, smoothly blend target into actual altitude
+            this._terrainAltitude += (this._terrainAltitudeTarget - this._terrainAltitude) * SMOOTHING;
+        }
+        const viewportProps = newControllerState.getViewportProps();
+        const pos = viewportProps.position || [0, 0, 0];
+        extraProps = {
+            ...extraProps,
+            position: [pos[0], pos[1], this._terrainAltitude]
+        };
+        super.updateViewport(newControllerState, extraProps, interactionState);
+    }
+    _onPanStart(event) {
+        this._pickTerrainCenterAltitude();
+        return super._onPanStart(event);
+    }
+    _onWheel(event) {
+        this._pickTerrainCenterAltitude();
+        return super._onWheel(event);
+    }
+    _onDoubleClick(event) {
+        this._pickTerrainCenterAltitude();
+        return super._onDoubleClick(event);
+    }
+    _pickTerrainCenterAltitude() {
+        // TODO use async picking?
+        if (!this.pickPosition) {
+            return;
+        }
+        const { x, y, width, height } = this.props;
+        const pickResult = this.pickPosition(x + width / 2, y + height / 2);
+        if (pickResult?.coordinate && pickResult.coordinate.length >= 3) {
+            this._terrainAltitudeTarget = pickResult.coordinate[2];
+        }
+    }
+    /**
+     * Utility function to return viewport that looks the same, but with
+     * a position shifted to [0, 0, altitude]
+     */
+    _rebaseViewport(altitude, newControllerState, extraProps) {
+        const viewportProps = newControllerState.getViewportProps();
+        const oldViewport = this.makeViewport({ ...viewportProps, position: [0, 0, 0] });
+        const oldCameraPos = oldViewport.cameraPosition;
+        const centerZOffset = altitude * oldViewport.distanceScales.unitsPerMeter[2];
+        const cameraHeightAboveOldCenter = oldCameraPos[2];
+        const newCameraHeightAboveCenter = cameraHeightAboveOldCenter - centerZOffset;
+        if (newCameraHeightAboveCenter <= 0) {
+            return extraProps;
+        }
+        const zoomDelta = Math.log2(cameraHeightAboveOldCenter / newCameraHeightAboveCenter);
+        const newZoom = viewportProps.zoom + zoomDelta;
+        const newViewport = this.makeViewport({
+            ...viewportProps,
+            zoom: newZoom,
+            position: [0, 0, altitude]
+        });
+        const { width, height } = viewportProps;
+        const screenCenter = [width / 2, height / 2];
+        const worldPoint = oldViewport.unproject(screenCenter, { targetZ: altitude });
+        if (worldPoint &&
+            'panByPosition3D' in newViewport &&
+            typeof newViewport.panByPosition3D === 'function') {
+            const adjusted = newViewport.panByPosition3D(worldPoint, screenCenter);
+            return { ...extraProps, position: [0, 0, altitude], zoom: newZoom, ...adjusted };
+        }
+        return extraProps;
+    }
+}
+//# sourceMappingURL=terrain-controller.js.map

package/dist/controllers/terrain-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-controller.js","sourceRoot":"","sources":["../../src/controllers/terrain-controller.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,aAAa,4BAAyB;AAK7C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa;IAA5D;;QACE,+EAA+E;QACvE,qBAAgB,GAAY,SAAS,CAAC;QAC9C,yDAAyD;QACjD,2BAAsB,GAAY,SAAS,CAAC;IAgItD,CAAC;IA9HC,QAAQ,CACN,KAIG;QAEH,KAAK,CAAC,QAAQ,CAAC,EAAC,aAAa,EAAE,IAAI,EAAE,GAAG,KAAK,EAAC,CAAC,CAAC;QAEhD,wEAAwE;QACxE,IACE,IAAI,CAAC,gBAAgB,KAAK,SAAS;YACnC,IAAI,CAAC,sBAAsB,KAAK,SAAS;YACzC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,EACpE,CAAC;YACD,IAAI,CAAC,cAAc,CACjB,IAAI,IAAI,CAAC,eAAe,CAAC;gBACvB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,GAAG,IAAI,CAAC,KAAK;gBACb,GAAG,IAAI,CAAC,KAAK;aACP,CAAC,CACV,CAAC;QACJ,CAAC;IACH,CAAC;IAES,cAAc,CACtB,kBAA4B,EAC5B,aAAyC,IAAI,EAC7C,mBAAqC,EAAE;QAEvC,MAAM,SAAS,GAAG,IAAI,CAAC;QAEvB,qCAAqC;QACrC,IAAI,IAAI,CAAC,sBAAsB,KAAK,SAAS;YAAE,OAAO;QAEtD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,0CAA0C;YAC1C,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,sBAAsB,CAAC;YACpD,UAAU,GAAG,IAAI,CAAC,eAAe,CAC/B,IAAI,CAAC,sBAAsB,EAC3B,kBAAkB,EAClB,UAAU,CACX,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;QAC7F,CAAC;QAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,gBAAgB,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,UAAU,GAAG;YACX,GAAG,UAAU;YACb,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC;SAClD,CAAC;QAEF,KAAK,CAAC,cAAc,CAAC,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACzE,CAAC;IAES,WAAW,CAAC,KAA0B;QAC9C,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAES,QAAQ,CAAC,KAAwB;QACzC,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAES,cAAc,CAAC,KAA0B;QACjD,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAEO,0BAA0B;QAChC,0BAA0B;QAC1B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,MAAM,EAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;QACpE,IAAI,UAAU,EAAE,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,sBAAsB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,eAAe,CACrB,QAAgB,EAChB,kBAA4B,EAC5B,UAAsC;QAEtC,MAAM,aAAa,GAAG,kBAAkB,CAAC,gBAAgB,EAAE,CAAC;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,EAAC,GAAG,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAC,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,WAAW,CAAC,cAAc,CAAC;QAEhD,MAAM,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,0BAA0B,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,0BAA0B,GAAG,0BAA0B,GAAG,aAAa,CAAC;QAC9E,IAAI,0BAA0B,IAAI,CAAC,EAAE,CAAC;YACpC,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,0BAA0B,GAAG,0BAA0B,CAAC,CAAC;QACrF,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,SAAS,CAAC;QAE/C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;YACpC,GAAG,aAAa;YAChB,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC;SAC3B,CAAC,CAAC;QACH,MAAM,EAAC,KAAK,EAAE,MAAM,EAAC,GAAG,aAAa,CAAC;QACtC,MAAM,YAAY,GAAqB,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,EAAC,OAAO,EAAE,QAAQ,EAAC,CAAC,CAAC;QAC5E,IACE,UAAU;YACV,iBAAiB,IAAI,WAAW;YAChC,OAAO,WAAW,CAAC,eAAe,KAAK,UAAU,EACjD,CAAC;YACD,MAAM,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACvE,OAAO,EAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAC,CAAC;QACjF,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/dist.dev.js

@@ -11505,6 +11505,7 @@ ${source3}`;
     PointLight: () => PointLight,
     PostProcessEffect: () => PostProcessEffect,
     TRANSITION_EVENTS: () => TRANSITION_EVENTS,
+    TerrainController: () => TerrainController,
     Tesselator: () => Tesselator,
     TransitionInterpolator: () => TransitionInterpolator,
     UNIT: () => UNIT,
@@ -39689,6 +39690,103 @@ void main(void) {
   };
   GlobeView.displayName = "GlobeView";
 
+  // src/controllers/terrain-controller.ts
+  var TerrainController = class extends MapController {
+    constructor() {
+      super(...arguments);
+      /** Cached terrain altitude from depth picking at viewport center (smoothed) */
+      this._terrainAltitude = void 0;
+      /** Raw (unsmoothed) terrain altitude from latest pick */
+      this._terrainAltitudeTarget = void 0;
+    }
+    setProps(props) {
+      super.setProps({ rotationPivot: "3d", ...props });
+      if (this._terrainAltitude !== void 0 && this._terrainAltitudeTarget !== void 0 && Math.abs(this._terrainAltitudeTarget - this._terrainAltitude) > 0.01) {
+        this.updateViewport(
+          new this.ControllerState({
+            makeViewport: this.makeViewport,
+            ...this.props,
+            ...this.state
+          })
+        );
+      }
+    }
+    updateViewport(newControllerState, extraProps = null, interactionState = {}) {
+      const SMOOTHING = 0.05;
+      if (this._terrainAltitudeTarget === void 0)
+        return;
+      if (this._terrainAltitude === void 0) {
+        this._terrainAltitude = this._terrainAltitudeTarget;
+        extraProps = this._rebaseViewport(
+          this._terrainAltitudeTarget,
+          newControllerState,
+          extraProps
+        );
+      } else {
+        this._terrainAltitude += (this._terrainAltitudeTarget - this._terrainAltitude) * SMOOTHING;
+      }
+      const viewportProps = newControllerState.getViewportProps();
+      const pos = viewportProps.position || [0, 0, 0];
+      extraProps = {
+        ...extraProps,
+        position: [pos[0], pos[1], this._terrainAltitude]
+      };
+      super.updateViewport(newControllerState, extraProps, interactionState);
+    }
+    _onPanStart(event) {
+      this._pickTerrainCenterAltitude();
+      return super._onPanStart(event);
+    }
+    _onWheel(event) {
+      this._pickTerrainCenterAltitude();
+      return super._onWheel(event);
+    }
+    _onDoubleClick(event) {
+      this._pickTerrainCenterAltitude();
+      return super._onDoubleClick(event);
+    }
+    _pickTerrainCenterAltitude() {
+      if (!this.pickPosition) {
+        return;
+      }
+      const { x, y, width, height } = this.props;
+      const pickResult = this.pickPosition(x + width / 2, y + height / 2);
+      if (pickResult?.coordinate && pickResult.coordinate.length >= 3) {
+        this._terrainAltitudeTarget = pickResult.coordinate[2];
+      }
+    }
+    /**
+     * Utility function to return viewport that looks the same, but with
+     * a position shifted to [0, 0, altitude]
+     */
+    _rebaseViewport(altitude, newControllerState, extraProps) {
+      const viewportProps = newControllerState.getViewportProps();
+      const oldViewport = this.makeViewport({ ...viewportProps, position: [0, 0, 0] });
+      const oldCameraPos = oldViewport.cameraPosition;
+      const centerZOffset = altitude * oldViewport.distanceScales.unitsPerMeter[2];
+      const cameraHeightAboveOldCenter = oldCameraPos[2];
+      const newCameraHeightAboveCenter = cameraHeightAboveOldCenter - centerZOffset;
+      if (newCameraHeightAboveCenter <= 0) {
+        return extraProps;
+      }
+      const zoomDelta = Math.log2(cameraHeightAboveOldCenter / newCameraHeightAboveCenter);
+      const newZoom = viewportProps.zoom + zoomDelta;
+      const newViewport = this.makeViewport({
+        ...viewportProps,
+        zoom: newZoom,
+        position: [0, 0, altitude]
+      });
+      const { width, height } = viewportProps;
+      const screenCenter = [width / 2, height / 2];
+      const worldPoint = oldViewport.unproject(screenCenter, { targetZ: altitude });
+      if (worldPoint && "panByPosition3D" in newViewport && typeof newViewport.panByPosition3D === "function") {
+        const adjusted = newViewport.panByPosition3D(worldPoint, screenCenter);
+        return { ...extraProps, position: [0, 0, altitude], zoom: newZoom, ...adjusted };
+      }
+      return extraProps;
+    }
+  };
+
   // src/lib/layer-extension.ts
   var LayerExtension = class {
     static get componentName() {

package/dist/index.cjs

@@ -50,6 +50,7 @@ __export(dist_exports, {
   PointLight: () => PointLight,
   PostProcessEffect: () => PostProcessEffect,
   TRANSITION_EVENTS: () => TRANSITION_EVENTS,
+  TerrainController: () => TerrainController,
   Tesselator: () => Tesselator,
   TransitionInterpolator: () => TransitionInterpolator,
   UNIT: () => UNIT,
@@ -229,7 +230,7 @@ var json_loader_default = {
 
 // dist/lib/init.js
 function checkVersion() {
-  const version = true ? "9.3.0-alpha.2" : globalThis.DECK_VERSION || "untranspiled source";
+  const version = true ? "9.3.0-alpha.3" : globalThis.DECK_VERSION || "untranspiled source";
   const existingVersion = globalThis.deck && globalThis.deck.VERSION;
   if (existingVersion && existingVersion !== version) {
     throw new Error(`deck.gl - multiple versions detected: ${existingVersion} vs ${version}`);
@@ -13383,6 +13384,95 @@ var GlobeView = class extends View {
 GlobeView.displayName = "GlobeView";
 var globe_view_default = GlobeView;
 
+// dist/controllers/terrain-controller.js
+var TerrainController = class extends MapController {
+  constructor() {
+    super(...arguments);
+    this._terrainAltitude = void 0;
+    this._terrainAltitudeTarget = void 0;
+  }
+  setProps(props) {
+    super.setProps({ rotationPivot: "3d", ...props });
+    if (this._terrainAltitude !== void 0 && this._terrainAltitudeTarget !== void 0 && Math.abs(this._terrainAltitudeTarget - this._terrainAltitude) > 0.01) {
+      this.updateViewport(new this.ControllerState({
+        makeViewport: this.makeViewport,
+        ...this.props,
+        ...this.state
+      }));
+    }
+  }
+  updateViewport(newControllerState, extraProps = null, interactionState = {}) {
+    const SMOOTHING = 0.05;
+    if (this._terrainAltitudeTarget === void 0)
+      return;
+    if (this._terrainAltitude === void 0) {
+      this._terrainAltitude = this._terrainAltitudeTarget;
+      extraProps = this._rebaseViewport(this._terrainAltitudeTarget, newControllerState, extraProps);
+    } else {
+      this._terrainAltitude += (this._terrainAltitudeTarget - this._terrainAltitude) * SMOOTHING;
+    }
+    const viewportProps = newControllerState.getViewportProps();
+    const pos = viewportProps.position || [0, 0, 0];
+    extraProps = {
+      ...extraProps,
+      position: [pos[0], pos[1], this._terrainAltitude]
+    };
+    super.updateViewport(newControllerState, extraProps, interactionState);
+  }
+  _onPanStart(event) {
+    this._pickTerrainCenterAltitude();
+    return super._onPanStart(event);
+  }
+  _onWheel(event) {
+    this._pickTerrainCenterAltitude();
+    return super._onWheel(event);
+  }
+  _onDoubleClick(event) {
+    this._pickTerrainCenterAltitude();
+    return super._onDoubleClick(event);
+  }
+  _pickTerrainCenterAltitude() {
+    if (!this.pickPosition) {
+      return;
+    }
+    const { x, y, width, height } = this.props;
+    const pickResult = this.pickPosition(x + width / 2, y + height / 2);
+    if ((pickResult == null ? void 0 : pickResult.coordinate) && pickResult.coordinate.length >= 3) {
+      this._terrainAltitudeTarget = pickResult.coordinate[2];
+    }
+  }
+  /**
+   * Utility function to return viewport that looks the same, but with
+   * a position shifted to [0, 0, altitude]
+   */
+  _rebaseViewport(altitude, newControllerState, extraProps) {
+    const viewportProps = newControllerState.getViewportProps();
+    const oldViewport = this.makeViewport({ ...viewportProps, position: [0, 0, 0] });
+    const oldCameraPos = oldViewport.cameraPosition;
+    const centerZOffset = altitude * oldViewport.distanceScales.unitsPerMeter[2];
+    const cameraHeightAboveOldCenter = oldCameraPos[2];
+    const newCameraHeightAboveCenter = cameraHeightAboveOldCenter - centerZOffset;
+    if (newCameraHeightAboveCenter <= 0) {
+      return extraProps;
+    }
+    const zoomDelta = Math.log2(cameraHeightAboveOldCenter / newCameraHeightAboveCenter);
+    const newZoom = viewportProps.zoom + zoomDelta;
+    const newViewport = this.makeViewport({
+      ...viewportProps,
+      zoom: newZoom,
+      position: [0, 0, altitude]
+    });
+    const { width, height } = viewportProps;
+    const screenCenter = [width / 2, height / 2];
+    const worldPoint = oldViewport.unproject(screenCenter, { targetZ: altitude });
+    if (worldPoint && "panByPosition3D" in newViewport && typeof newViewport.panByPosition3D === "function") {
+      const adjusted = newViewport.panByPosition3D(worldPoint, screenCenter);
+      return { ...extraProps, position: [0, 0, altitude], zoom: newZoom, ...adjusted };
+    }
+    return extraProps;
+  }
+};
+
 // dist/lib/layer-extension.js
 var LayerExtension = class {
   static get componentName() {