@navaramap/three-plugins 0.0.4 → 0.0.6

package/dist/index.js

@@ -1,11 +1,11 @@
-import { EventHandler as e, Plugin as t, convertWorldToScreen as n, degreeToRadian as r, eastNorthUpToFixedFrame as i, geodeticToVector3 as a, radianToDegree as o, vector3ToGeodetic as s } from "@navaramap/three";
-import { Matrix4 as c, Vector3 as l } from "three";
+import { EventHandler as e, MAPBOX_ELEVATION_DECODER as t, Plugin as n, TERRARIUM_ELEVATION_DECODER as r, convertWorldToScreen as i, degreeToRadian as a, eastNorthUpToFixedFrame as o, geodeticToVector3 as s, radianToDegree as c, vector3ToGeodetic as l } from "@navaramap/three";
+import { MathUtils as u, Matrix4 as d, Vector3 as f } from "three";
 //#region src/PersonViewPlugin.ts
-var u = {
+var p = {
 	x: 0,
 	y: 0,
 	z: 0
-}, d = {
+}, m = {
 	forward: ["KeyW"],
 	backward: ["KeyS"],
 	turnLeft: ["KeyA"],
@@ -19,12 +19,35 @@ var u = {
 	dash: ["ShiftLeft", "ShiftRight"],
 	orbitCamera: ["AltLeft", "AltRight"],
 	toggleView: ["KeyV"]
-}, f = {
+}, h = {
+	mode: "off",
+	groundOffset: 0,
+	alignToSlope: !0,
+	slopeSampleDistance: 4,
+	maxSlopeTilt: Math.PI / 4,
+	cameraSlopeFollow: 1
+}, g = 10, _ = 6, v = Math.PI / 4, y = [
+	0,
+	1,
+	2,
+	3,
+	4,
+	5,
+	6,
+	7
+].map((e) => {
+	let t = e * Math.PI / 4;
+	return {
+		sin: Math.sin(t),
+		cos: Math.cos(t)
+	};
+}), b = (e, t) => e > 0 && t > 0 ? 1 - Math.exp(-e * t) : 1, x = {
 	allowCameraControl: !1,
 	initialView: "tpv",
 	moveSpeed: 50,
 	rotationSpeed: 3,
 	altSpeed: 30,
+	dashSpeedMultiplier: 2.5,
 	minAlt: 50,
 	maxAlt: 5e3,
 	cameraDistance: 50,
@@ -37,20 +60,23 @@ var u = {
 	startLng: 139.7671,
 	startHeight: 500,
 	startHeading: Math.PI * 1.3
-}, p = 3, m = 1e3, h = class extends t {
+}, S = 3, C = 1e3, w = class extends n {
 	view;
 	config;
+	collision;
 	character;
 	keys;
 	keyToAction;
 	handle = null;
 	modelRef = null;
 	animId = null;
+	placed = !1;
 	lastTime = 0;
 	state;
 	listeners = /* @__PURE__ */ new Set();
+	actionListeners = /* @__PURE__ */ new Set();
 	heldActions = /* @__PURE__ */ new Set();
-	dashMultiplier = 1;
+	dashHeld = !1;
 	orbitKeyHeld = !1;
 	orbitLatched = !1;
 	currentAnimState;
@@ -60,21 +86,33 @@ var u = {
 	movementSuppressed = !1;
 	boundKeyDown;
 	boundKeyUp;
-	_curPos = new l();
-	_east = new l();
-	_north = new l();
-	_worldForward = new l();
-	_offset = new l();
-	_headingMatrix = new c();
-	_characterFrame = new c();
+	_curPos = new f();
+	_east = new f();
+	_north = new f();
+	_worldForward = new f();
+	_offset = new f();
+	_probePos = new f();
+	_headingMatrix = new d();
+	_tiltMatrix = new d();
+	_characterFrame = new d();
+	cameraSlopePitch = 0;
+	slopeGradEast = 0;
+	slopeGradNorth = 0;
+	lastGroundSample;
+	unabsorbedGroundShift = 0;
+	settleVelocity = 0;
+	groundSurfaceHeight;
 	constructor(e = {}) {
 		super();
-		let { character: t, keys: n, ...r } = e;
+		let { character: t, keys: n, collision: r, ...i } = e;
 		this.config = {
-			...f,
+			...x,
+			...i
+		}, this.collision = {
+			...h,
 			...r
 		}, this.character = t ? this.resolveCharacter(t) : null, this.keys = {
-			...d,
+			...m,
 			...n
 		}, this.keyToAction = this.buildKeyMap(this.keys), this.modelHeading = this.config.startHeading, this.cameraHeading = this.config.startHeading, this.viewMode = this.config.initialView, this.currentAnimState = this.character ? this.character.animation.idleClip : null, this.boundKeyDown = this.onKeyDown.bind(this), this.boundKeyUp = this.onKeyUp.bind(this);
 	}
@@ -91,27 +129,31 @@ var u = {
 	}
 	start() {
 		if (!this.view || this.animId != null) return;
-		this.animId = -1;
-		let { startLat: e, startLng: t, startHeight: n, startHeading: i } = this.config, o = a({
-			lat: r(e),
-			lng: r(t),
+		if (this.animId = -1, document.addEventListener("keydown", this.boundKeyDown), document.addEventListener("keyup", this.boundKeyUp), this.placed) {
+			this.resumeLoop(), this.placeChaseCamera(this.state.lat, this.state.lng, this.state.alt, this.cameraHeading), this.applyModelVisibility();
+			return;
+		}
+		this.placed = !0;
+		let { startLat: e, startLng: t, startHeight: n, startHeading: r } = this.config, i = s({
+			lat: a(e),
+			lng: a(t),
 			height: n
 		});
-		if (this.modelHeading = i, this.cameraHeading = i, this.character) {
-			let { animation: e, modelRotationOffset: t, modelScale: n, castShadow: r, receiveShadow: a } = this.character;
+		if (this.modelHeading = r, this.cameraHeading = r, this.character) {
+			let { animation: e, modelRotationOffset: t, modelScale: n, castShadow: a, receiveShadow: o } = this.character;
 			this.handle = this.view.addMesh({
 				gltfModel: {
 					url: this.character.modelUrl,
-					castShadow: r,
-					receiveShadow: a,
+					castShadow: a,
+					receiveShadow: o,
 					animationEnabled: !0,
 					animationAutoPlay: !0,
 					animationActiveClip: e.idleClip,
-					animationSpeed: e.speed,
+					animationSpeed: this.clipSpeed(e.idleClip),
 					animationLoop: !0,
 					animationCrossfadeDuration: e.crossfadeDuration
 				},
-				matrixWorld: this.composeCharacterFrame(o, i),
+				matrixWorld: this.composeCharacterFrame(i, r),
 				rotation: {
 					x: t.x,
 					y: t.y,
@@ -123,27 +165,46 @@ var u = {
 					z: n
 				}
 			}), this.modelRef = this.handle.ref, this.modelRef.on("load", () => {
-				this.view && (this.lastTime = performance.now(), this.animId = requestAnimationFrame(this.tick));
+				!this.view || this.animId == null || this.resumeLoop();
 			});
-		} else this.lastTime = performance.now(), this.animId = requestAnimationFrame(this.tick);
-		this.applyInitialCamera(), this.applyModelVisibility(), document.addEventListener("keydown", this.boundKeyDown), document.addEventListener("keyup", this.boundKeyUp);
+		} else this.resumeLoop();
+		this.applyInitialCamera(), this.applyModelVisibility();
+	}
+	stop() {
+		if (this.animId == null) return;
+		this.releaseControl(), this.view?.cameraFollow(!1), this.view?.cameraFreeLook(!1), this.playAnimation(this.character?.animation.idleClip);
+		let e = {
+			...this.state,
+			speed: 0,
+			animationState: this.currentAnimState
+		};
+		this.hasStateChanged(this.state, e) && (this.state = e, this.notify());
+	}
+	releaseControl() {
+		this.animId != null && this.animId >= 0 && cancelAnimationFrame(this.animId), this.animId = null, document.removeEventListener("keydown", this.boundKeyDown), document.removeEventListener("keyup", this.boundKeyUp), this.heldActions.clear(), this.orbitKeyHeld = !1, this.orbitLatched = !1, this.dashHeld = !1;
+	}
+	resumeLoop() {
+		this.lastTime = performance.now(), this.animId = requestAnimationFrame(this.tick);
 	}
 	teleport(e) {
 		if (!this.view) return;
-		let { lng: t, lat: n, alt: i } = e, o = e.heading == null ? this.cameraHeading : e.heading;
-		if (this.handle && this.character) {
-			let e = a({
-				lat: r(n),
-				lng: r(t),
-				height: i
+		let { lng: t, lat: n } = e, r = e.heading == null ? this.cameraHeading : e.heading, i = {
+			lat: a(n),
+			lng: a(t)
+		}, o = this.resolveGroundHeight(i, i, e.alt, 0);
+		if (this.updateSlopeTilt(i.lat, i.lng, o, 0), this.handle && this.character) {
+			let e = s({
+				lat: i.lat,
+				lng: i.lng,
+				height: o
 			});
-			this.handle.update({ matrixWorld: this.composeCharacterFrame(e, o) });
+			this.handle.update({ matrixWorld: this.composeCharacterFrame(e, r) });
 		}
-		this.modelHeading = o, this.cameraHeading = o, this.placeChaseCamera(n, t, i, o), this.state = {
+		this.modelHeading = r, this.cameraHeading = r, this.placeChaseCamera(n, t, o, r), this.state = {
 			lng: t,
 			lat: n,
-			alt: i,
-			heading: o,
+			alt: o,
+			heading: r,
 			speed: 0,
 			animationState: this.currentAnimState,
 			mode: this.viewMode
@@ -155,6 +216,9 @@ var u = {
 	onStateChange(e) {
 		return this.listeners.add(e), () => this.listeners.delete(e);
 	}
+	onAction(e) {
+		return this.actionListeners.add(e), () => this.actionListeners.delete(e);
+	}
 	setViewMode(e) {
 		this.viewMode !== e && (this.viewMode = e, this.state = {
 			...this.state,
@@ -167,18 +231,27 @@ var u = {
 	setAllowCameraControl(e) {
 		this.config.allowCameraControl = e;
 	}
+	setCollision(e) {
+		this.collision = {
+			...this.collision,
+			...e
+		};
+	}
+	getCollision() {
+		return this.collision;
+	}
 	setHeading(e) {
 		if (!this.view) return;
-		let { lat: t, lng: n, alt: i } = this.state;
+		let { lat: t, lng: n, alt: r } = this.state;
 		if (this.modelHeading = e, this.cameraHeading = e, this.handle && this.character) {
-			let o = a({
-				lat: r(t),
-				lng: r(n),
-				height: i
+			let i = s({
+				lat: a(t),
+				lng: a(n),
+				height: r
 			});
-			this.handle.update({ matrixWorld: this.composeCharacterFrame(o, e) });
+			this.handle.update({ matrixWorld: this.composeCharacterFrame(i, e) });
 		}
-		this.isFreeCamera() || this.placeChaseCamera(t, n, i, e), this.state = {
+		this.isFreeCamera() || this.placeChaseCamera(t, n, r, e), this.state = {
 			...this.state,
 			heading: e
 		}, this.notify();
@@ -204,18 +277,34 @@ var u = {
 	getFpvHeightOffset() {
 		return this.config.fpvHeightOffset;
 	}
+	setAnimationSpeed(e) {
+		this.character && (this.character.animation.speed = e), this.modelRef?.setAnimationSpeed(this.clipSpeed(this.currentAnimState));
+	}
+	getAnimationSpeed() {
+		return this.character?.animation.speed ?? 1;
+	}
+	get model() {
+		return this.handle;
+	}
+	clipSpeed(e) {
+		let t = this.character?.animation;
+		return t ? e === t.dashClip ? t.dashSpeed ?? t.speed ?? 1 : t.walkClip != null && e === t.walkClip ? t.walkSpeed ?? t.speed ?? 1 : t.idleSpeed ?? t.speed ?? 1 : 1;
+	}
 	dispose() {
-		this.animId != null && cancelAnimationFrame(this.animId), this.animId = null, document.removeEventListener("keydown", this.boundKeyDown), document.removeEventListener("keyup", this.boundKeyUp), this.handle &&= (this.handle.delete(), null), this.modelRef = null, this.heldActions.clear(), this.listeners.clear(), this.orbitKeyHeld = !1, this.orbitLatched = !1, this.dashMultiplier = 1, this.view = void 0;
+		this.releaseControl(), this.handle &&= (this.handle.delete(), null), this.modelRef = null, this.placed = !1, this.listeners.clear(), this.actionListeners.clear(), this.view = void 0;
+	}
+	playAnimation(e) {
+		!e || !this.character || !this.modelRef || e !== this.currentAnimState && (this.modelRef.crossFadeAnimation(this.currentAnimState ?? "", e, this.character.animation.crossfadeDuration), this.modelRef.setAnimationSpeed(this.clipSpeed(e)), this.currentAnimState = e);
 	}
 	resolveCharacter(e) {
 		return {
 			modelUrl: e.modelUrl,
 			animation: e.animation,
 			modelRotationOffset: e.modelRotationOffset ? {
-				...u,
+				...p,
 				...e.modelRotationOffset
-			} : u,
-			modelScale: e.modelScale ?? p,
+			} : p,
+			modelScale: e.modelScale ?? S,
 			hideModelInFpv: e.hideModelInFpv ?? !0,
 			castShadow: e.castShadow ?? !1,
 			receiveShadow: e.receiveShadow ?? !1
@@ -242,51 +331,145 @@ var u = {
 		let { startLat: e, startLng: t, startHeight: n, startHeading: r } = this.config;
 		this.placeChaseCamera(e, t, n, r);
 	}
-	placeChaseCamera(e, t, n, r) {
+	placeChaseCamera(e, t, n, r, i = 0) {
 		if (!this.view) return;
-		let { cameraDistance: i, cameraPitch: a, fpvPitch: o, fpvHeightOffset: s, fpvForwardOffset: c } = this.config, l = this.viewMode === "fpv", u = n + s;
-		if (l) {
-			let n = m, i = c + m, a = Math.tan(o) * n, s = this.advanceLatLng(e, t, r, i);
-			this._offset.set(-Math.sin(r) * n, -Math.cos(r) * n, a), this.view.cameraFollow(!0, {
-				lat: s.lat,
-				lng: s.lng,
-				height: u - a
+		let { cameraDistance: a, fpvPitch: o, fpvForwardOffset: s } = this.config, c = this.viewMode === "fpv", l = this.eyeHeightAt(n);
+		if (c) {
+			let a = C, c = s + C, u = this.followSlopeWithPitch(o, e, t, n, r, i), d = Math.tan(u) * a, f = this.advanceLatLng(e, t, r, c);
+			this._offset.set(-Math.sin(r) * a, -Math.cos(r) * a, d), this.view.cameraFollow(!0, {
+				lat: f.lat,
+				lng: f.lng,
+				height: l - d
 			}, this._offset);
 			return;
 		}
-		let d = i * Math.cos(a), f = i * Math.sin(a);
+		let u = this.followSlopeWithPitch(this.config.cameraPitch, e, t, n, r, i), d = a * Math.cos(u), f = a * Math.sin(u);
 		this._offset.set(-Math.sin(r) * d, -Math.cos(r) * d, f), this.view.cameraFollow(!0, {
 			lat: e,
 			lng: t,
-			height: u
+			height: l
 		}, this._offset);
 	}
+	followSlopeWithPitch(e, t, n, r, i, a) {
+		let { cameraDistance: o, cameraLerpSpeed: s } = this.config, { mode: c, cameraSlopeFollow: l } = this.collision, d = 0;
+		if (c !== "off" && l > 0) {
+			let e = this.terrainAlong(t, n, i, o), a = this.terrainAlong(t, n, i + Math.PI, o);
+			e !== void 0 && a !== void 0 && (d = u.clamp(Math.atan2(e - a, 2 * o) * l * this.groundedFactor(r, o), -v, v));
+		}
+		return this.cameraSlopePitch += (d - this.cameraSlopePitch) * b(s, a), e - this.cameraSlopePitch;
+	}
+	groundedFactor(e, t) {
+		let n = this.groundSurfaceHeight;
+		return n === void 0 ? 0 : u.clamp(1 - (e - n) / t, 0, 1);
+	}
+	terrainAlong(e, t, n, r) {
+		let i = this.advanceLatLng(e, t, n, r);
+		return this.sampleTerrain(a(i.lat), a(i.lng));
+	}
 	composeCharacterFrame(e, t) {
-		let n = i(e);
-		return this._headingMatrix.makeRotationZ(-t), this._characterFrame.multiplyMatrices(n, this._headingMatrix);
+		let n = o(e);
+		this._headingMatrix.makeRotationZ(-t), this._characterFrame.multiplyMatrices(n, this._headingMatrix);
+		let r = this.slopeGradEast, i = this.slopeGradNorth;
+		if (r !== 0 || i !== 0) {
+			let e = Math.sin(t), n = Math.cos(t), a = this.collision.maxSlopeTilt, o = u.clamp(Math.atan(r * e + i * n), -a, a), s = u.clamp(-Math.atan(r * n - i * e), -a, a);
+			this._tiltMatrix.makeRotationX(o), this._characterFrame.multiply(this._tiltMatrix), this._tiltMatrix.makeRotationY(s), this._characterFrame.multiply(this._tiltMatrix);
+		}
+		return this._characterFrame;
+	}
+	eyeHeightAt(e) {
+		return e + this.config.fpvHeightOffset;
+	}
+	sampleTerrain(e, t) {
+		return this.view?.sampleTerrainHeight({
+			lat: e,
+			lng: t,
+			height: 0
+		});
+	}
+	resolveGroundHeight(e, t, n, r) {
+		let { mode: i, groundOffset: a } = this.collision;
+		if (i === "off") return this.forgetGroundSamples(), n;
+		let o = this.sampleTerrain(e.lat, e.lng);
+		if (o === void 0) return this.forgetGroundSamples(), n;
+		this.groundSurfaceHeight = o + a;
+		let s = this.groundSurfaceHeight - this.absorbGroundDataShift(e, t, o, n, r);
+		return i === "ground" ? s : Math.max(n, s);
+	}
+	absorbGroundDataShift(e, t, n, r, i) {
+		let a = this.lastGroundSample, o;
+		if (a === void 0) o = (this.sampleTerrain(t.lat, t.lng) ?? n) + this.collision.groundOffset - r;
+		else {
+			let e = this.sampleTerrain(a.lat, a.lng);
+			o = e === void 0 ? 0 : e - a.height;
+		}
+		let s = this.unabsorbedGroundShift + o, c = Math.sign(s);
+		i > 0 && (c !== Math.sign(this.settleVelocity) && (this.settleVelocity = 0), this.settleVelocity += c * g * i);
+		let l = i > 0 ? Math.abs(this.settleVelocity) * i : Math.abs(s);
+		return this.unabsorbedGroundShift = c * Math.max(0, Math.abs(s) - l), this.unabsorbedGroundShift === 0 && (this.settleVelocity = 0), this.lastGroundSample = {
+			lat: e.lat,
+			lng: e.lng,
+			height: n
+		}, this.unabsorbedGroundShift;
+	}
+	forgetGroundSamples() {
+		this.lastGroundSample = void 0, this.unabsorbedGroundShift = 0, this.settleVelocity = 0, this.groundSurfaceHeight = void 0;
+	}
+	updateSlopeTilt(e, t, n, r) {
+		let { mode: i, alignToSlope: a, slopeSampleDistance: o } = this.collision, s = 0, c = 0;
+		if (i !== "off" && a) {
+			let r = this.measureSlopeGradient(e, t);
+			if (!r) return;
+			let i = this.groundedFactor(n, o);
+			s = r.east * i, c = r.north * i;
+		} else if (this.slopeGradEast === 0 && this.slopeGradNorth === 0) return;
+		let l = b(_, r);
+		this.slopeGradEast += (s - this.slopeGradEast) * l, this.slopeGradNorth += (c - this.slopeGradNorth) * l;
+	}
+	measureSlopeGradient(e, t) {
+		let n = this.collision.slopeSampleDistance, r = s({
+			lat: e,
+			lng: t,
+			height: 0
+		}), i = o(r);
+		this._east.setFromMatrixColumn(i, 0).normalize(), this._north.setFromMatrixColumn(i, 1).normalize();
+		let a = 0, c = 0;
+		for (let { sin: e, cos: t } of y) {
+			this._probePos.copy(r).addScaledVector(this._east, e * n).addScaledVector(this._north, t * n);
+			let i = l(this._probePos), o = this.sampleTerrain(i.lat, i.lng);
+			if (o === void 0) return;
+			a += o * e, c += o * t;
+		}
+		let u = 2 / (y.length * n);
+		return {
+			east: a * u,
+			north: c * u
+		};
 	}
-	advanceLatLng(e, t, n, c) {
-		let l = a({
-			lat: r(e),
-			lng: r(t),
+	advanceLatLng(e, t, n, r) {
+		let i = s({
+			lat: a(e),
+			lng: a(t),
 			height: 0
-		}), u = i(l);
-		this._east.setFromMatrixColumn(u, 0).normalize(), this._north.setFromMatrixColumn(u, 1).normalize(), this._worldForward.copy(this._east).multiplyScalar(Math.sin(n)).addScaledVector(this._north, Math.cos(n)), l.addScaledVector(this._worldForward, c);
-		let d = s(l);
+		}), u = o(i);
+		this._east.setFromMatrixColumn(u, 0).normalize(), this._north.setFromMatrixColumn(u, 1).normalize(), this._worldForward.copy(this._east).multiplyScalar(Math.sin(n)).addScaledVector(this._north, Math.cos(n)), i.addScaledVector(this._worldForward, r);
+		let d = l(i);
 		return {
-			lat: o(d.lat),
-			lng: o(d.lng)
+			lat: c(d.lat),
+			lng: c(d.lng)
 		};
 	}
 	notify() {
 		for (let e of this.listeners) e(this.state);
 	}
+	emitAction(e) {
+		for (let t of this.actionListeners) t(e);
+	}
 	onKeyDown(e) {
 		let t = e.target;
 		if (t.tagName === "INPUT" || t.tagName === "TEXTAREA" || t.isContentEditable) return;
 		let n = this.keyToAction.get(e.code);
 		if (n !== void 0) {
-			if (n === "toggleView") {
+			if (e.repeat || this.emitAction(n), n === "toggleView") {
 				if (e.repeat) return;
 				this.toggleViewMode();
 				return;
@@ -297,7 +480,7 @@ var u = {
 			}
 			if (!this.movementSuppressed) {
 				if (n === "dash") {
-					this.dashMultiplier = 2.5;
+					this.dashHeld = !0;
 					return;
 				}
 				this.isMovementAction(n) && (this.orbitLatched = !1), this.heldActions.add(n);
@@ -312,73 +495,73 @@ var u = {
 				return;
 			}
 			if (t === "dash") {
-				this.dashMultiplier = 1;
+				this.dashHeld = !1;
 				return;
 			}
 			this.heldActions.delete(t);
 		}
 	}
 	tick = (e) => {
-		if (!this.view) return;
+		if (!this.view || this.animId == null) return;
 		this.animId = requestAnimationFrame(this.tick);
 		let t = Math.min((e - this.lastTime) / 1e3, .1);
 		this.lastTime = e;
-		let n = 0, c = 0, l = 0;
-		this.heldActions.has("forward") && (c += 1), this.heldActions.has("backward") && --c, this.heldActions.has("turnLeft") && --n, this.heldActions.has("turnRight") && (n += 1), this.heldActions.has("ascend") && (l += 1), this.heldActions.has("descend") && --l;
-		let { moveSpeed: u, rotationSpeed: d, altSpeed: f, minAlt: p, maxAlt: m, cameraLerpSpeed: h } = this.config;
-		n !== 0 && (this.modelHeading += r(d * n));
-		let g = this._curPos;
+		let n = 0, r = 0, i = 0;
+		this.heldActions.has("forward") && (r += 1), this.heldActions.has("backward") && --r, this.heldActions.has("turnLeft") && --n, this.heldActions.has("turnRight") && (n += 1), this.heldActions.has("ascend") && (i += 1), this.heldActions.has("descend") && --i;
+		let { moveSpeed: d, rotationSpeed: f, altSpeed: p, minAlt: m, maxAlt: h, cameraLerpSpeed: g } = this.config, _ = this.dashHeld ? this.config.dashSpeedMultiplier : 1;
+		n !== 0 && (this.modelHeading += a(f * n));
+		let v = this._curPos;
 		if (this.handle && this.modelRef) {
 			let e = this.modelRef.getWorldPosition();
 			if (!e) return;
-			g.copy(e);
-		} else g.copy(a({
-			lat: r(this.state.lat),
-			lng: r(this.state.lng),
+			v.copy(e);
+		} else v.copy(s({
+			lat: a(this.state.lat),
+			lng: a(this.state.lng),
 			height: this.state.alt
 		}));
-		let _ = i(g);
-		this._east.setFromMatrixColumn(_, 0).normalize(), this._north.setFromMatrixColumn(_, 1).normalize();
-		let v = s(g);
-		this._worldForward.copy(this._east).multiplyScalar(Math.sin(this.modelHeading)).addScaledVector(this._north, Math.cos(this.modelHeading)), c !== 0 && g.addScaledVector(this._worldForward, u * this.dashMultiplier * t * c);
-		let y = s(g), b = v.height + l * f * t, x = Math.max(p, Math.min(m, b)), S = o(y.lat), C = o(y.lng), w = x;
-		if (this.handle && this.character) {
-			let e = a({
-				lat: y.lat,
-				lng: y.lng,
-				height: x
+		let y = o(v);
+		this._east.setFromMatrixColumn(y, 0).normalize(), this._north.setFromMatrixColumn(y, 1).normalize();
+		let x = l(v);
+		this._worldForward.copy(this._east).multiplyScalar(Math.sin(this.modelHeading)).addScaledVector(this._north, Math.cos(this.modelHeading)), r !== 0 && v.addScaledVector(this._worldForward, d * _ * t * r);
+		let S = l(v), C = this.collision.mode === "ground" ? x.height : u.clamp(x.height + i * p * t, m, h), w = this.resolveGroundHeight(S, x, C, t), T = c(S.lat), E = c(S.lng), D = w;
+		if (this.updateSlopeTilt(S.lat, S.lng, w, t), this.handle && this.character) {
+			let e = s({
+				lat: S.lat,
+				lng: S.lng,
+				height: w
 			});
 			this.handle.update({ matrixWorld: this.composeCharacterFrame(e, this.modelHeading) });
 		}
-		let T = this.modelHeading - this.cameraHeading;
-		if (T -= Math.round(T / (Math.PI * 2)) * (Math.PI * 2), this.cameraHeading += T * Math.min(t * h, 1), this.isFreeCamera()) if (this.viewMode === "fpv") {
-			let e = this.advanceLatLng(S, C, this.cameraHeading, this.config.fpvForwardOffset);
+		let O = this.modelHeading - this.cameraHeading;
+		if (O -= Math.round(O / (Math.PI * 2)) * (Math.PI * 2), this.cameraHeading += O * b(g, t), this.isFreeCamera()) if (this.viewMode === "fpv") {
+			let e = this.advanceLatLng(T, E, this.cameraHeading, this.config.fpvForwardOffset);
 			this.view.cameraFreeLook(!0, {
 				lat: e.lat,
 				lng: e.lng,
-				height: w + this.config.fpvHeightOffset
+				height: this.eyeHeightAt(D)
 			});
 		} else this.view.cameraFollow(!0, {
-			lat: S,
-			lng: C,
-			height: w + this.config.fpvHeightOffset
+			lat: T,
+			lng: E,
+			height: this.eyeHeightAt(D)
 		});
-		else this.placeChaseCamera(S, C, w, this.cameraHeading);
-		let E = c !== 0 || n !== 0 || l !== 0, D = E && this.dashMultiplier > 1, O = this.currentAnimState;
-		if (this.character && this.modelRef) {
-			let { animation: e } = this.character, t = e.walkClip ?? e.idleClip, n;
-			n = D ? e.dashClip : E ? t : e.idleClip, n !== this.currentAnimState && (this.modelRef.crossFadeAnimation(this.currentAnimState ?? "", n, e.crossfadeDuration), this.currentAnimState = n), O = n;
+		else this.placeChaseCamera(T, E, D, this.cameraHeading, t);
+		let k = r !== 0 || n !== 0 || i !== 0, A = k && this.dashHeld, j = this.currentAnimState;
+		if (this.character) {
+			let { animation: e } = this.character, t = e.walkClip ?? e.idleClip;
+			j = A ? e.dashClip : k ? t : e.idleClip, this.playAnimation(j);
 		}
-		let k = {
-			lng: C,
-			lat: S,
-			alt: w,
+		let M = {
+			lng: E,
+			lat: T,
+			alt: D,
 			heading: this.modelHeading,
-			speed: u * this.dashMultiplier,
-			animationState: O,
+			speed: d * _,
+			animationState: j,
 			mode: this.viewMode
 		};
-		this.hasStateChanged(this.state, k) && (this.state = k, this.notify());
+		this.hasStateChanged(this.state, M) && (this.state = M, this.notify());
 	};
 	hasStateChanged(e, t) {
 		return e.lng !== t.lng || e.lat !== t.lat || e.alt !== t.alt || e.heading !== t.heading || e.speed !== t.speed || e.animationState !== t.animationState || e.mode !== t.mode;
@@ -386,10 +569,10 @@ var u = {
 };
 //#endregion
 //#region src/OverlayPlugin.ts
-function g(e, t, n) {
+function T(e, t, n) {
 	e.style.transform = `translate(${t}px, ${n}px)`, e.style.willChange = "transform";
 }
-var _ = 1e5, v = class extends t {
+var E = 1e5, D = class extends n {
 	view;
 	maxDistance;
 	positions = [];
@@ -397,7 +580,7 @@ var _ = 1e5, v = class extends t {
 	listeners = /* @__PURE__ */ new Set();
 	boundHandler;
 	constructor(e) {
-		super(), this.maxDistance = e?.maxDistance ?? _, this.boundHandler = this.handlePreRender.bind(this);
+		super(), this.maxDistance = e?.maxDistance ?? E, this.boundHandler = this.handlePreRender.bind(this);
 	}
 	async init(e, t) {
 		this.view = e, e.on("preRender", this.boundHandler);
@@ -411,47 +594,47 @@ var _ = 1e5, v = class extends t {
 	dispose() {
 		this.view && this.view.off("preRender", this.boundHandler), this.listeners.clear(), this.positions = [], this.projected.clear();
 	}
-	worldToScreen(e, t, i) {
+	worldToScreen(e, t, n) {
 		if (!this.view) return null;
-		let o = a({
-			lng: r(e),
-			lat: r(t),
-			height: i
-		}), s = n({
+		let r = s({
+			lng: a(e),
+			lat: a(t),
+			height: n
+		}), o = i({
 			width: this.view.screenSize.x,
 			height: this.view.screenSize.y,
 			pixelRatio: this.view.pixelRatio
-		}, this.view.camera.raw, o);
-		return s ? {
-			x: s.x,
-			y: s.y
+		}, this.view.camera.raw, r);
+		return o ? {
+			x: o.x,
+			y: o.y
 		} : null;
 	}
 	handlePreRender() {
 		if (!this.view) return;
-		let e = this.view.camera.positionGeographic, t = a({
-			lng: r(e.lng),
-			lat: r(e.lat),
+		let e = this.view.camera.positionGeographic, t = s({
+			lng: a(e.lng),
+			lat: a(e.lat),
 			height: e.height
 		}), n = /* @__PURE__ */ new Map();
 		for (let e of this.positions) {
-			let i = a({
-				lng: r(e.lng),
-				lat: r(e.lat),
+			let r = s({
+				lng: a(e.lng),
+				lat: a(e.lat),
 				height: e.alt
-			}), o = t.distanceTo(i);
-			if (o > this.maxDistance) continue;
-			let s = this.worldToScreen(e.lng, e.lat, e.alt);
-			s && n.set(e.id, {
-				...s,
-				distance: o
+			}), i = t.distanceTo(r);
+			if (i > this.maxDistance) continue;
+			let o = this.worldToScreen(e.lng, e.lat, e.alt);
+			o && n.set(e.id, {
+				...o,
+				distance: i
 			});
 		}
 		this.projected = n;
-		let i = { projected: this.projected };
-		for (let e of this.listeners) e(i);
+		let r = { projected: this.projected };
+		for (let e of this.listeners) e(r);
 	}
-}, y = "https://api.cesium.com/v1/assets", b = class extends t {
+}, O = "https://api.cesium.com/v1/assets", k = class extends n {
 	view;
 	config;
 	endpoint;
@@ -460,7 +643,7 @@ var _ = 1e5, v = class extends t {
 	}
 	async init(e, t) {
 		this.view = e;
-		let { assetId: n, accessToken: r, endpoint: i = y } = this.config, a = `${i}/${encodeURIComponent(String(n))}/endpoint?access_token=${encodeURIComponent(r)}`, o = await fetch(a);
+		let { assetId: n, accessToken: r, endpoint: i = O } = this.config, a = `${i}/${encodeURIComponent(String(n))}/endpoint?access_token=${encodeURIComponent(r)}`, o = await fetch(a);
 		if (!o.ok) throw Error(`CesiumIonPlugin: failed to fetch asset ${n} endpoint (${o.status} ${o.statusText})`);
 		let s = await o.json();
 		this.endpoint = {
@@ -489,12 +672,19 @@ var _ = 1e5, v = class extends t {
 		});
 		return l.once("deleted", () => c.delete()), l;
 	}
-}, x = /^3\.\d+\.\d+$/;
-function S(e) {
-	if (typeof e.tilejson != "string" || !x.test(e.tilejson)) throw Error(`TileJsonPlugin: invalid or missing "tilejson" version field (got ${JSON.stringify(e.tilejson)}).`);
+}, A = /^3\.\d+\.\d+$/, j = 512, M = "mapbox";
+function N(e) {
+	if (typeof e.tilejson != "string" || !A.test(e.tilejson)) throw Error(`TileJsonPlugin: invalid or missing "tilejson" version field (got ${JSON.stringify(e.tilejson)}).`);
 	if (!Array.isArray(e.tiles) || e.tiles.length === 0) throw Error("TileJsonPlugin: \"tiles\" must be a non-empty array of URL templates.");
 }
-var C = class extends t {
+function P(e) {
+	switch (e) {
+		case "mapbox": return t();
+		case "terrarium": return r();
+		default: throw Error(`TileJsonPlugin: unsupported raster-dem encoding ${JSON.stringify(e)}. Supported encodings: "mapbox", "terrarium".`);
+	}
+}
+var F = class extends n {
 	view;
 	events = new e();
 	credits = [];
@@ -514,27 +704,34 @@ var C = class extends t {
 		let t = this.view;
 		if (!t) throw Error("TileJsonPlugin: addSource() must be called after view.init().");
 		let n = await this.fetchTileJson(e.url);
-		S(n);
+		N(n);
 		let [r, ...i] = n.tiles;
 		i.length > 0 && console.warn(`TileJsonPlugin: TileJSON at ${e.url} lists ${n.tiles.length} mirror tile endpoints; Navara sources use a single URL, so only the first is used.`);
-		let { minzoom: a, maxzoom: o, scheme: s } = n, c = e.id, l = e.type === "raster-tile" ? t.addSource({
-			type: "raster-tile",
+		let a = e.minzoom ?? n.minzoom, o = e.maxzoom ?? n.maxzoom, s = e.scheme ?? n.scheme, c = e.id, l = {
 			url: r,
 			...c === void 0 ? {} : { id: c },
+			...o === void 0 ? {} : { maxZoom: o }
+		}, u = {
+			...l,
 			...a === void 0 ? {} : { minZoom: a },
-			...o === void 0 ? {} : { maxZoom: o },
 			...s === "tms" ? { tms: !0 } : {}
+		}, d;
+		return d = e.type === "raster-tile" ? t.addSource({
+			type: "raster-tile",
+			...u
+		}) : e.type === "raster-dem" ? t.addSource({
+			type: "raster-dem",
+			...u,
+			tileSize: e.tileSize ?? n.tileSize ?? j,
+			elevationDecoder: P(e.encoding ?? n.encoding ?? M)
 		}) : t.addSource({
 			type: "vector-tile",
-			url: r,
-			...c === void 0 ? {} : { id: c },
-			...o === void 0 ? {} : { maxZoom: o }
-		});
-		return n.attribution && this.addCredit(n.attribution), this.events.emit("loaded", {
-			source: l,
+			...l
+		}), n.attribution && this.addCredit(n.attribution), this.events.emit("loaded", {
+			source: d,
 			tilejson: n,
 			attribution: n.attribution
-		}), l;
+		}), d;
 	}
 	dispose() {
 		let e = this.view?.attribution;
@@ -550,4 +747,4 @@ var C = class extends t {
 	}
 };
 //#endregion
-export { b as CesiumIonPlugin, v as OverlayPlugin, h as PersonViewPlugin, C as TileJsonPlugin, g as moveOverlayElement };
+export { k as CesiumIonPlugin, D as OverlayPlugin, w as PersonViewPlugin, F as TileJsonPlugin, T as moveOverlayElement };