@ziztechnology/dial-library 0.0.11 → 0.0.13

package/dist/index.mjs

@@ -43,6 +43,45 @@ const dialSdkDebugWarn = (moduleName, scope, phase, data) => {
 	} catch {}
 };
 //#endregion
+//#region src/helper/sensor.ts
+const extractFreshVector = (metric, capturedAtMs, maxSampleAgeMs) => {
+	if (!metric?.available || !Number.isFinite(capturedAtMs) || !Number.isFinite(metric.sampledAtMs)) return null;
+	const ageMs = capturedAtMs - metric.sampledAtMs;
+	if (ageMs < 0 || ageMs > maxSampleAgeMs) return null;
+	const { x, y, z } = metric.value;
+	return [
+		x,
+		y,
+		z
+	].every(Number.isFinite) ? {
+		sampledAtMs: metric.sampledAtMs,
+		value: metric.value
+	} : null;
+};
+//#endregion
+//#region src/helper/validation.ts
+const requirePositiveFinite = (name, value, debug) => {
+	dialSdkDebugWarn(debug.moduleName, debug.scope, "called", {
+		name,
+		value
+	});
+	if (!Number.isFinite(value) || value <= 0) {
+		const error = /* @__PURE__ */ new RangeError(`${name} must be a positive finite number`);
+		dialSdkDebugWarn(debug.moduleName, debug.scope, "threw", error);
+		throw error;
+	}
+	dialSdkDebugWarn(debug.moduleName, debug.scope, "returned", { result: value });
+	return value;
+};
+const isRecord = (value, debug) => {
+	const result = typeof value === "object" && value !== null && !Array.isArray(value);
+	if (debug) dialSdkDebugWarn(debug.moduleName, debug.scope, "returned", {
+		value,
+		result
+	});
+	return result;
+};
+//#endregion
 //#region src/sensor/check_status.ts
 const DEBUG_MODULE$5 = "check_status.ts";
 const DEVICE_RIGHT = {
@@ -56,7 +95,7 @@ const ZERO_VECTOR$1 = {
 	z: 0
 };
 const DEFAULT_DRIVING_STATUS_TUNING = Object.freeze({
-	version: "driving-status-calibrated-2026-07",
+	version: "driving-status-calibrated-2026-07-17",
 	maxSampleAgeMs: 1e3,
 	gravityFilterTimeConstantMs: 1e3,
 	biasFilterTimeConstantMs: 1e4,
@@ -69,7 +108,7 @@ const DEFAULT_DRIVING_STATUS_TUNING = Object.freeze({
 	stoppedRawGyroThreshold: .065,
 	drivingGyroThreshold: .04,
 	drivingRawGyroThreshold: .08,
-	stoppedConfirmationMs: 5e3,
+	stoppedConfirmationMs: 3e3,
 	drivingConfirmationMs: 600,
 	longitudinalWindowMs: 800,
 	longitudinalMinimumSamples: 5,
@@ -86,11 +125,15 @@ const DEFAULT_DRIVING_STATUS_TUNING = Object.freeze({
 	verticalBumpRatio: 1.25,
 	longitudinalReversalWindowMs: 400,
 	turnWindowMs: 1500,
-	turnMinimumSamples: 4,
-	turnYawThreshold: .12,
-	turnConfirmationMs: 600,
+	turnMinimumSamples: 3,
+	turnYawThreshold: .08,
+	turnConfirmationMs: 400,
 	turnIntegratedAngleThreshold: .12,
 	turnSignCoherence: .7,
+	turnYawDominanceThreshold: .6,
+	turnLateralEvidenceThreshold: .25,
+	turnVerticalNoiseFloor: .1,
+	turnVerticalBumpRatio: 1.25,
 	turnExitYawThreshold: .04,
 	turnExitConfirmationMs: 700,
 	turnClosureWindowMs: 1500
@@ -154,10 +197,16 @@ const resolveDrivingStatusTuning = (overrides = {}) => {
 		"turnYawThreshold",
 		"turnConfirmationMs",
 		"turnIntegratedAngleThreshold",
+		"turnLateralEvidenceThreshold",
+		"turnVerticalNoiseFloor",
+		"turnVerticalBumpRatio",
 		"turnExitYawThreshold",
 		"turnExitConfirmationMs",
 		"turnClosureWindowMs"
-	]) assertPositiveFinite(field, tuning[field]);
+	]) requirePositiveFinite(field, tuning[field], {
+		moduleName: DEBUG_MODULE$5,
+		scope: "assertPositiveFinite"
+	});
 	for (const field of [
 		"motionMinimumSamples",
 		"longitudinalMinimumSamples",
@@ -167,7 +216,8 @@ const resolveDrivingStatusTuning = (overrides = {}) => {
 	for (const field of [
 		"longitudinalSignCoherence",
 		"rapidLongitudinalSignCoherence",
-		"turnSignCoherence"
+		"turnSignCoherence",
+		"turnYawDominanceThreshold"
 	]) {
 		const value = tuning[field];
 		if (!Number.isFinite(value) || value <= .5 || value > 1) throwLoggedRangeError("resolveDrivingStatusTuning", `${field} must be greater than 0.5 and less than or equal to 1`);
@@ -192,22 +242,25 @@ const extractDrivingSnapshotMetrics = (info, tuning = DEFAULT_DRIVING_STATUS_TUN
 		dialSdkDebugWarn(DEBUG_MODULE$5, "extractDrivingSnapshotMetrics", "returned invalid capture time", { info });
 		return null;
 	}
-	const linearAcceleration = availableFreshVector(info.linearAcceleration, info.capturedAtMs, tuning.maxSampleAgeMs);
-	const gyroscope = availableFreshVector(info.gyroscope, info.capturedAtMs, tuning.maxSampleAgeMs);
-	const gravityMetric = availableFreshVector(info.gravity, info.capturedAtMs, tuning.maxSampleAgeMs);
-	if (linearAcceleration === null || gyroscope === null || gravityMetric === null) {
+	const linearAcceleration = extractFreshVector(info.linearAcceleration, info.capturedAtMs, tuning.maxSampleAgeMs);
+	const gyroscope = extractFreshVector(info.gyroscope, info.capturedAtMs, tuning.maxSampleAgeMs);
+	const gravityMetric = extractFreshVector(info.gravity, info.capturedAtMs, tuning.maxSampleAgeMs);
+	const gravity = availableCorrectedGravity(correction, info.capturedAtMs, tuning.maxSampleAgeMs) ?? (correction.filteredGravity !== void 0 && gravityMetric !== null ? {
+		value: correction.filteredGravity,
+		sampledAtMs: gravityMetric.sampledAtMs
+	} : gravityMetric);
+	if (linearAcceleration === null || gyroscope === null || gravity === null) {
 		dialSdkDebugWarn(DEBUG_MODULE$5, "extractDrivingSnapshotMetrics", "returned unavailable vectors", {
 			linearAcceleration,
 			gyroscope,
-			gravity: gravityMetric
+			gravity
 		});
 		return null;
 	}
-	const gravity = correction.filteredGravity ?? gravityMetric.value;
-	const frame = buildVehicleFrame(gravity, tuning.vehicleRightMinimumNorm);
+	const frame = buildVehicleFrame(gravity.value, tuning.vehicleRightMinimumNorm);
 	if (frame === null) {
 		dialSdkDebugWarn(DEBUG_MODULE$5, "extractDrivingSnapshotMetrics", "returned invalid vehicle frame", {
-			gravity,
+			gravity: gravity.value,
 			vehicleRightMinimumNorm: tuning.vehicleRightMinimumNorm
 		});
 		return null;
@@ -218,7 +271,7 @@ const extractDrivingSnapshotMetrics = (info, tuning = DEFAULT_DRIVING_STATUS_TUN
 		capturedAtMs: info.capturedAtMs,
 		linearAccelerationSampledAtMs: linearAcceleration.sampledAtMs,
 		gyroscopeSampledAtMs: gyroscope.sampledAtMs,
-		gravitySampledAtMs: gravityMetric.sampledAtMs,
+		gravitySampledAtMs: gravity.sampledAtMs,
 		longitudinal: dot(correctedLinear, frame.forward),
 		lateral: dot(correctedLinear, frame.right),
 		vertical: dot(correctedLinear, frame.up),
@@ -287,16 +340,17 @@ const classifyInstantaneousEvidence = (metrics, tuning) => {
 		rejectionReason: null
 	};
 };
-const availableFreshVector = (metric, capturedAtMs, maxSampleAgeMs) => {
-	if (!metric?.available || !isFresh(metric.sampledAtMs, capturedAtMs, maxSampleAgeMs)) return null;
-	const { x, y, z } = metric.value;
+const availableCorrectedGravity = (correction, capturedAtMs, maxSampleAgeMs) => {
+	const { filteredGravity, filteredGravitySampledAtMs } = correction;
+	if (filteredGravity === void 0 || filteredGravitySampledAtMs === void 0 || !isFresh(filteredGravitySampledAtMs, capturedAtMs, maxSampleAgeMs)) return null;
+	const { x, y, z } = filteredGravity;
 	return [
 		x,
 		y,
 		z
 	].every(Number.isFinite) ? {
-		value: metric.value,
-		sampledAtMs: metric.sampledAtMs
+		value: filteredGravity,
+		sampledAtMs: filteredGravitySampledAtMs
 	} : null;
 };
 const isFresh = (sampledAtMs, capturedAtMs, maxSampleAgeMs) => {
@@ -325,13 +379,6 @@ const normalize = (value) => {
 	const length = magnitude(value);
 	return Number.isFinite(length) && length > Number.EPSILON ? scale(value, 1 / length) : null;
 };
-const assertPositiveFinite = (name, value) => {
-	if (!Number.isFinite(value) || value <= 0) {
-		const error = /* @__PURE__ */ new RangeError(`${name} must be a positive finite number`);
-		dialSdkDebugWarn(DEBUG_MODULE$5, "assertPositiveFinite", "threw", error);
-		throw error;
-	}
-};
 const throwLoggedRangeError = (scope, message) => {
 	const error = new RangeError(message);
 	dialSdkDebugWarn(DEBUG_MODULE$5, scope, "threw", error);
@@ -397,8 +444,51 @@ const CAR_RUNNING_STATUS_PRIORITY = {
 	SUDDEN_BRAKING: 5
 };
 //#endregion
+//#region src/helper/async.ts
+const createAbortError = (message, debug) => {
+	dialSdkDebugWarn(debug.moduleName, debug.scope, "called");
+	if (typeof DOMException === "function") {
+		const result = new DOMException(message, "AbortError");
+		dialSdkDebugWarn(debug.moduleName, debug.scope, "returned DOMException", { result });
+		return result;
+	}
+	const error = new Error(message);
+	error.name = "AbortError";
+	dialSdkDebugWarn(debug.moduleName, debug.scope, "returned Error", { result: error });
+	return error;
+};
+const isAbortError = (error, debug) => {
+	const result = error instanceof Error && error.name === "AbortError";
+	if (debug) dialSdkDebugWarn(debug.moduleName, debug.scope, "returned", {
+		error,
+		result
+	});
+	return result;
+};
+const invokeSafely = (callback, args, onError) => {
+	try {
+		callback(...args);
+		return true;
+	} catch (error) {
+		onError(error);
+		return false;
+	}
+};
+//#endregion
 //#region src/sensor/driving_expressions.ts
 const DEBUG_MODULE$3 = "driving_expressions.ts";
+const IS_RECORD_DEBUG$1 = {
+	moduleName: DEBUG_MODULE$3,
+	scope: "isRecord"
+};
+const REQUIRE_POSITIVE_FINITE_DEBUG$1 = {
+	moduleName: DEBUG_MODULE$3,
+	scope: "requirePositiveFinite"
+};
+const CREATE_ABORT_ERROR_DEBUG$1 = {
+	moduleName: DEBUG_MODULE$3,
+	scope: "createAbortError"
+};
 const OFFICIAL_DRIVING_EXPRESSION_FALLBACKS = Object.freeze({
 	STOPPED: Object.freeze({
 		kind: "emoji",
@@ -466,7 +556,7 @@ const parseDrivingExpressionsConfig = (raw, options = {}) => {
 		options
 	});
 	const parsed = parseJsonObject(raw);
-	if (parsed.schemaVersion !== 1 || !isRecord$1(parsed.states)) throw new DrivingExpressionsConfigError("DRIVING_EXPRESSIONS_INVALID_SCHEMA", "drivingExpressions must use schemaVersion 1 and contain a states object");
+	if (parsed.schemaVersion !== 1 || !isRecord(parsed.states, IS_RECORD_DEBUG$1)) throw new DrivingExpressionsConfigError("DRIVING_EXPRESSIONS_INVALID_SCHEMA", "drivingExpressions must use schemaVersion 1 and contain a states object");
 	const knownStatuses = new Set(CAR_RUNNING_STATUSES);
 	const stateKeys = Object.keys(parsed.states);
 	if (stateKeys.length !== CAR_RUNNING_STATUSES.length || stateKeys.some((key) => !knownStatuses.has(key))) throw new DrivingExpressionsConfigError("DRIVING_EXPRESSIONS_INCOMPLETE", "drivingExpressions.states must contain exactly the eight supported statuses");
@@ -492,6 +582,10 @@ const tryParseDrivingExpressionsConfig = (raw, options) => {
 		dialSdkDebugWarn(DEBUG_MODULE$3, "tryParseDrivingExpressionsConfig", "returned", { result });
 		return result;
 	} catch (error) {
+		if (!(error instanceof DrivingExpressionsConfigError)) {
+			dialSdkDebugWarn(DEBUG_MODULE$3, "tryParseDrivingExpressionsConfig", "threw unexpected error", error);
+			throw error;
+		}
 		dialSdkDebugWarn(DEBUG_MODULE$3, "tryParseDrivingExpressionsConfig", "returned null after parse error", error);
 		return null;
 	}
@@ -520,7 +614,7 @@ const readDrivingExpressionsConfig = (raw, options) => {
 const waitForDrivingExpressionsConfig = (options = {}) => {
 	dialSdkDebugWarn(DEBUG_MODULE$3, "waitForDrivingExpressionsConfig", "called", { options });
 	const timeoutMs = requireNonNegativeFinite("timeoutMs", options.timeoutMs ?? 3e3);
-	const pollIntervalMs = requirePositiveFinite$1("pollIntervalMs", options.pollIntervalMs ?? 100);
+	const pollIntervalMs = requirePositiveFinite("pollIntervalMs", options.pollIntervalMs ?? 100, REQUIRE_POSITIVE_FINITE_DEBUG$1);
 	const { signal } = options;
 	return new Promise((resolve, reject) => {
 		const deadlineMs = Date.now() + timeoutMs;
@@ -568,7 +662,7 @@ const waitForDrivingExpressionsConfig = (options = {}) => {
 		};
 		const handleAbort = () => {
 			dialSdkDebugWarn(DEBUG_MODULE$3, "waitForDrivingExpressionsConfig.handleAbort", "called");
-			fail(createAbortError$1());
+			fail(createAbortError("The operation was aborted", CREATE_ABORT_ERROR_DEBUG$1));
 		};
 		const read = () => {
 			dialSdkDebugWarn(DEBUG_MODULE$3, "waitForDrivingExpressionsConfig.read", "called");
@@ -586,7 +680,13 @@ const waitForDrivingExpressionsConfig = (options = {}) => {
 				handleAbort();
 				return;
 			}
-			const config = read();
+			let config;
+			try {
+				config = read();
+			} catch (error) {
+				fail(error);
+				return;
+			}
 			if (config !== null) {
 				finish(config);
 				return;
@@ -881,7 +981,7 @@ const parseDrivingExpressionMedia = (raw, status, options) => {
 		dialSdkDebugWarn(DEBUG_MODULE$3, "parseDrivingExpressionMedia", "returned legacy image", { result });
 		return result;
 	}
-	if (!isRecord$1(raw) || typeof raw.kind !== "string") throw invalidMedia(status, "media must be a structured object with a supported kind");
+	if (!isRecord(raw, IS_RECORD_DEBUG$1) || typeof raw.kind !== "string") throw invalidMedia(status, "media must be a structured object with a supported kind");
 	const mediaAssetId = parseMediaAssetId(raw.mediaAssetId, status);
 	assertFieldsAbsent(raw, status, [
 		"items",
@@ -987,7 +1087,7 @@ const parseJsonObject = (raw) => {
 		});
 		throw error;
 	}
-	if (!isRecord$1(value)) {
+	if (!isRecord(value, IS_RECORD_DEBUG$1)) {
 		const error = new DrivingExpressionsConfigError("DRIVING_EXPRESSIONS_INVALID_SCHEMA", "drivingExpressions must be a JSON object or JSON object string");
 		dialSdkDebugWarn(DEBUG_MODULE$3, "parseJsonObject", "threw", error);
 		throw error;
@@ -1004,7 +1104,7 @@ const readRuntimeDrivingExpressionsValue = () => {
 		return result;
 	}
 	const faceConfig = runtimeGlobal.__TOOOONY_FACE_CONFIG__;
-	if (!isRecord$1(faceConfig)) {
+	if (!isRecord(faceConfig, IS_RECORD_DEBUG$1)) {
 		dialSdkDebugWarn(DEBUG_MODULE$3, "readRuntimeDrivingExpressionsValue", "returned", { result: void 0 });
 		return;
 	}
@@ -1013,7 +1113,7 @@ const readRuntimeDrivingExpressionsValue = () => {
 		dialSdkDebugWarn(DEBUG_MODULE$3, "readRuntimeDrivingExpressionsValue", "returned face config", { result });
 		return result;
 	}
-	const result = isRecord$1(faceConfig.values) ? faceConfig.values.drivingExpressions : void 0;
+	const result = isRecord(faceConfig.values, IS_RECORD_DEBUG$1) ? faceConfig.values.drivingExpressions : void 0;
 	dialSdkDebugWarn(DEBUG_MODULE$3, "readRuntimeDrivingExpressionsValue", "returned legacy face config", { result });
 	return result;
 };
@@ -1135,14 +1235,6 @@ const compact = (value) => {
 	dialSdkDebugWarn(DEBUG_MODULE$3, "compact", "returned", { result: value });
 	return value;
 };
-const isRecord$1 = (value) => {
-	const result = typeof value === "object" && value !== null && !Array.isArray(value);
-	dialSdkDebugWarn(DEBUG_MODULE$3, "isRecord", "returned", {
-		value,
-		result
-	});
-	return result;
-};
 const requireNonNegativeFinite = (name, value) => {
 	dialSdkDebugWarn(DEBUG_MODULE$3, "requireNonNegativeFinite", "called", {
 		name,
@@ -1156,31 +1248,6 @@ const requireNonNegativeFinite = (name, value) => {
 	dialSdkDebugWarn(DEBUG_MODULE$3, "requireNonNegativeFinite", "returned", { result: value });
 	return value;
 };
-const requirePositiveFinite$1 = (name, value) => {
-	dialSdkDebugWarn(DEBUG_MODULE$3, "requirePositiveFinite", "called", {
-		name,
-		value
-	});
-	if (!Number.isFinite(value) || value <= 0) {
-		const error = /* @__PURE__ */ new RangeError(`${name} must be a positive finite number`);
-		dialSdkDebugWarn(DEBUG_MODULE$3, "requirePositiveFinite", "threw", error);
-		throw error;
-	}
-	dialSdkDebugWarn(DEBUG_MODULE$3, "requirePositiveFinite", "returned", { result: value });
-	return value;
-};
-const createAbortError$1 = () => {
-	dialSdkDebugWarn(DEBUG_MODULE$3, "createAbortError", "called");
-	if (typeof DOMException === "function") {
-		const result = new DOMException("The operation was aborted", "AbortError");
-		dialSdkDebugWarn(DEBUG_MODULE$3, "createAbortError", "returned DOMException", { result });
-		return result;
-	}
-	const error = /* @__PURE__ */ new Error("The operation was aborted");
-	error.name = "AbortError";
-	dialSdkDebugWarn(DEBUG_MODULE$3, "createAbortError", "returned Error", { result: error });
-	return error;
-};
 //#endregion
 //#region src/sensor/page_lifecycle.ts
 const DEBUG_MODULE$2 = "page_lifecycle.ts";
@@ -1315,12 +1382,9 @@ const dispatchResume = () => {
 };
 const safeInvoke = (callback) => {
 	dialSdkDebugWarn(DEBUG_MODULE$2, "safeInvoke", "called");
-	try {
-		callback();
-		dialSdkDebugWarn(DEBUG_MODULE$2, "safeInvoke", "returned");
-	} catch (error) {
+	if (invokeSafely(callback, [], (error) => {
 		dialSdkDebugWarn(DEBUG_MODULE$2, "safeInvoke", "callback threw", error);
-	}
+	})) dialSdkDebugWarn(DEBUG_MODULE$2, "safeInvoke", "returned");
 };
 //#endregion
 //#region src/sensor/driving_status_controller.ts
@@ -1330,6 +1394,10 @@ const ZERO_VECTOR = {
 	y: 0,
 	z: 0
 };
+const REQUIRE_POSITIVE_FINITE_DEBUG = {
+	moduleName: DEBUG_MODULE$1,
+	scope: "requirePositiveFinite"
+};
 const createDrivingStatusController = (options = {}) => {
 	dialSdkDebugWarn(DEBUG_MODULE$1, "createDrivingStatusController", "called", { options });
 	const result = new DefaultDrivingStatusController(options);
@@ -1363,6 +1431,18 @@ var DefaultDrivingStatusController = class {
 		this.turnStatus = null;
 		this.turnQuietSinceMs = null;
 		this.oppositeTurnSinceMs = null;
+		this.detectorCandidates = {
+			base: null,
+			rapid_longitudinal: null,
+			longitudinal: null,
+			turn: null
+		};
+		this.detectorRejections = {
+			base: null,
+			rapid_longitudinal: null,
+			longitudinal: null,
+			turn: null
+		};
 		this.requestedRunning = false;
 		this.polling = false;
 		this.lifecycleSuspended = false;
@@ -1401,9 +1481,9 @@ var DefaultDrivingStatusController = class {
 			dialSdkDebugWarn(DEBUG_MODULE$1, "DefaultDrivingStatusController.handleLifecycleResume", "returned");
 		};
 		dialSdkDebugWarn(DEBUG_MODULE$1, "DefaultDrivingStatusController.constructor", "called", { options });
-		this.sensorProvider = options.sensorProvider ?? defaultSensorProvider;
-		this.pollIntervalMs = requirePositiveFinite("pollIntervalMs", options.pollIntervalMs ?? 200);
-		this.unavailableFallbackMs = requirePositiveFinite("unavailableFallbackMs", options.unavailableFallbackMs ?? 3e3);
+		this.sensorProvider = options.sensorProvider ?? unifiedSensorInfo;
+		this.pollIntervalMs = requirePositiveFinite("pollIntervalMs", options.pollIntervalMs ?? 200, REQUIRE_POSITIVE_FINITE_DEBUG);
+		this.unavailableFallbackMs = requirePositiveFinite("unavailableFallbackMs", options.unavailableFallbackMs ?? 3e3, REQUIRE_POSITIVE_FINITE_DEBUG);
 		this.tuning = resolveDrivingStatusTuning(options.tuning);
 		this.clock = options.clock ?? systemClock;
 		this.onDiagnostic = options.onDiagnostic;
@@ -1567,25 +1647,26 @@ var DefaultDrivingStatusController = class {
 				});
 				return;
 			}
-			const gravity = this.updateFilteredGravity(payload);
+			const gravity = this.resolveGravityFrame(payload);
 			const metrics = gravity === null ? null : extractDrivingSnapshotMetrics(payload, this.tuning, {
-				filteredGravity: gravity,
+				filteredGravity: gravity.value,
+				filteredGravitySampledAtMs: gravity.sampledAtMs,
 				linearAccelerationBias: this.linearAccelerationBias,
 				gyroscopeBias: this.gyroscopeBias
 			});
-			const accelerometerSample = extractFreshVectorMetric(payload.accelerometer, payload.capturedAtMs, this.tuning.maxSampleAgeMs);
-			if (metrics === null || accelerometerSample === null) {
+			const accelerometerSample = extractFreshVector(payload.accelerometer, payload.capturedAtMs, this.tuning.maxSampleAgeMs);
+			if (gravity === null || metrics === null || accelerometerSample === null) {
 				dialSdkDebugWarn(DEBUG_MODULE$1, "DefaultDrivingStatusController.poll", "invalid or stale snapshot", {
 					metrics,
 					accelerometerSample
 				});
 				this.processUnavailable("invalid_or_stale_snapshot");
 			} else {
-				this.processAvailable(metrics, accelerometerSample);
+				this.processAvailable(metrics, accelerometerSample, gravity);
 				dialSdkDebugWarn(DEBUG_MODULE$1, "DefaultDrivingStatusController.poll", "processed sample", { capturedAtMs: metrics.capturedAtMs });
 			}
 		} catch (error) {
-			if (!this.polling || generation !== this.generation || pendingRead.signal.aborted || isAbortError$1(error)) {
+			if (!this.polling || generation !== this.generation || pendingRead.signal.aborted || isAbortError(error)) {
 				dialSdkDebugWarn(DEBUG_MODULE$1, "DefaultDrivingStatusController.poll", "ignored provider error", { error });
 				return;
 			}
@@ -1600,21 +1681,44 @@ var DefaultDrivingStatusController = class {
 			});
 		}
 	}
-	updateFilteredGravity(info) {
-		const sample = extractFreshVectorMetric(info.gravity, info.capturedAtMs, this.tuning.maxSampleAgeMs);
-		if (sample === null) return null;
-		if (sample.sampledAtMs === this.lastGravitySampledAtMs) return this.filteredGravity;
+	resolveGravityFrame(info) {
+		const sample = extractFreshVector(info.gravity, info.capturedAtMs, this.tuning.maxSampleAgeMs);
+		if (sample === null) {
+			if (this.filteredGravity === null || this.lastGravitySampledAtMs === null) return null;
+			const ageMs = info.capturedAtMs - this.lastGravitySampledAtMs;
+			return ageMs >= 0 && ageMs <= this.tuning.maxSampleAgeMs ? {
+				value: this.filteredGravity,
+				sampledAtMs: this.lastGravitySampledAtMs,
+				source: "cached"
+			} : null;
+		}
+		if (sample.sampledAtMs === this.lastGravitySampledAtMs && this.filteredGravity !== null) return {
+			value: this.filteredGravity,
+			sampledAtMs: sample.sampledAtMs,
+			source: "live"
+		};
 		if (this.filteredGravity === null || this.lastGravitySampledAtMs === null) this.filteredGravity = { ...sample.value };
 		else {
-			if (sample.sampledAtMs < this.lastGravitySampledAtMs) return this.filteredGravity;
+			if (sample.sampledAtMs < this.lastGravitySampledAtMs) {
+				const ageMs = info.capturedAtMs - this.lastGravitySampledAtMs;
+				return ageMs >= 0 && ageMs <= this.tuning.maxSampleAgeMs ? {
+					value: this.filteredGravity,
+					sampledAtMs: this.lastGravitySampledAtMs,
+					source: "cached"
+				} : null;
+			}
 			const elapsedMs = Math.max(0, sample.sampledAtMs - this.lastGravitySampledAtMs);
 			const alpha = 1 - Math.exp(-elapsedMs / this.tuning.gravityFilterTimeConstantMs);
 			this.filteredGravity = lerpVector(this.filteredGravity, sample.value, alpha);
 		}
 		this.lastGravitySampledAtMs = sample.sampledAtMs;
-		return this.filteredGravity;
+		return {
+			value: this.filteredGravity,
+			sampledAtMs: sample.sampledAtMs,
+			source: "live"
+		};
 	}
-	processAvailable(metrics, accelerometerSample) {
+	processAvailable(metrics, accelerometerSample, gravity) {
 		dialSdkDebugWarn(DEBUG_MODULE$1, "DefaultDrivingStatusController.processAvailable", "called", {
 			metrics,
 			accelerometerSample
@@ -1627,6 +1731,8 @@ var DefaultDrivingStatusController = class {
 			type: "sample_available",
 			atMs: now,
 			capturedAtMs: metrics.capturedAtMs,
+			frameSource: gravity.source,
+			frameAgeMs: metrics.capturedAtMs - gravity.sampledAtMs,
 			tuningVersion: this.tuning.version
 		});
 		const addedLongitudinal = pushUniqueMetric(this.longitudinalWindow, metrics, "linearAccelerationSampledAtMs", Math.max(this.tuning.longitudinalWindowMs, this.tuning.rapidLongitudinalWindowMs));
@@ -1637,6 +1743,10 @@ var DefaultDrivingStatusController = class {
 			return;
 		}
 		const motionMad = calculateCombinedAxisMad(this.motionWindow, this.tuning.motionMinimumSamples);
+		const previousBaseStatus = this.baseStatus;
+		const previousUrgentStatus = this.urgentStatus;
+		const previousLongitudinalStatus = this.normalLongitudinalStatus;
+		const previousTurnStatus = this.turnStatus;
 		const baseCondition = this.updateBaseDetector(motionMad, metrics, accelerometerSample.sampledAtMs, addedMotion);
 		const longitudinalEvidence = detectLongitudinalEvidence(this.longitudinalWindow, this.tuning);
 		if (addedLongitudinal) this.updateLongitudinalDetector(longitudinalEvidence, metrics.linearAccelerationSampledAtMs);
@@ -1648,6 +1758,27 @@ var DefaultDrivingStatusController = class {
 			this.stationaryConfirmed = false;
 		}
 		if (this.stationaryConfirmed) this.updateBias(metrics);
+		const statistics = {
+			base: {
+				sampleCount: this.motionWindow.length,
+				durationMs: vectorWindowDuration(this.motionWindow),
+				motionMad,
+				gyroMagnitude: metrics.gyroMagnitude,
+				rawGyroMagnitude: metrics.rawGyroMagnitude
+			},
+			longitudinal: longitudinalEvidence.normalStatistics,
+			rapidLongitudinal: longitudinalEvidence.rapidStatistics,
+			turn: turnEvidence.statistics
+		};
+		const baseCandidate = baseCondition === "stationary" ? "STOPPED" : baseCondition === "moving" ? "STEADY_DRIVING" : null;
+		this.updateDetectorCandidate("base", baseCandidate, null, statistics, now);
+		this.updateDetectorCandidate("rapid_longitudinal", longitudinalEvidence.rapidCandidate, longitudinalEvidence.rejectionReason, statistics, now);
+		this.updateDetectorCandidate("longitudinal", longitudinalEvidence.normalCandidate, null, statistics, now);
+		this.updateDetectorCandidate("turn", turnEvidence.candidate, turnEvidence.rejectionReason, statistics, now);
+		this.emitDetectorConfirmation("base", previousBaseStatus, this.baseStatus, statistics, now);
+		this.emitDetectorConfirmation("rapid_longitudinal", previousUrgentStatus, this.urgentStatus, statistics, now);
+		this.emitDetectorConfirmation("longitudinal", previousLongitudinalStatus, this.normalLongitudinalStatus, statistics, now);
+		this.emitDetectorConfirmation("turn", previousTurnStatus, this.turnStatus, statistics, now);
 		const pendingCandidate = instantaneousCandidate(metrics, this.tuning);
 		this.setCandidate(pendingCandidate === this.status ? null : pendingCandidate, observationTime(metrics));
 		this.emitDiagnostic({
@@ -1658,7 +1789,10 @@ var DefaultDrivingStatusController = class {
 			rapidCandidate: longitudinalEvidence.rapidCandidate,
 			longitudinalCandidate: longitudinalEvidence.normalCandidate,
 			turnCandidate: turnEvidence.candidate,
-			rejectionReason: longitudinalEvidence.rejectionReason,
+			rejectionReason: longitudinalEvidence.rejectionReason ?? turnEvidence.rejectionReason,
+			frameSource: gravity.source,
+			frameAgeMs: metrics.capturedAtMs - gravity.sampledAtMs,
+			statistics,
 			tuningVersion: this.tuning.version
 		});
 		const hasAction = this.urgentStatus !== null || this.turnStatus !== null || this.normalLongitudinalStatus !== null;
@@ -1766,8 +1900,41 @@ var DefaultDrivingStatusController = class {
 		}
 		this.lastBiasSampledAtMs = sampledAtMs;
 	}
+	updateDetectorCandidate(detector, candidate, rejectionReason, statistics, atMs) {
+		const previousCandidate = this.detectorCandidates[detector];
+		if (previousCandidate !== candidate) {
+			if (previousCandidate !== null) this.emitDetectorTransition(detector, "candidate_exited", previousCandidate, null, statistics, atMs);
+			if (candidate !== null) this.emitDetectorTransition(detector, "candidate_entered", candidate, null, statistics, atMs);
+			this.detectorCandidates[detector] = candidate;
+		}
+		if (rejectionReason !== null && rejectionReason !== this.detectorRejections[detector]) this.emitDetectorTransition(detector, "candidate_rejected", null, rejectionReason, statistics, atMs);
+		this.detectorRejections[detector] = rejectionReason;
+	}
+	emitDetectorConfirmation(detector, previousStatus, status, statistics, atMs) {
+		if (status !== null && status !== previousStatus) this.emitDetectorTransition(detector, "candidate_confirmed", status, null, statistics, atMs);
+	}
+	emitDetectorTransition(detector, phase, status, rejectionReason, statistics, atMs) {
+		this.emitDiagnostic({
+			type: "detector_transition",
+			atMs,
+			detector,
+			phase,
+			status,
+			rejectionReason,
+			statistics,
+			tuningVersion: this.tuning.version
+		});
+	}
 	commitSelectedStatus(now) {
-		const selected = this.urgentStatus ?? this.turnStatus ?? this.normalLongitudinalStatus ?? this.baseStatus;
+		const selected = [
+			this.baseStatus,
+			this.normalLongitudinalStatus,
+			this.turnStatus,
+			this.urgentStatus
+		].reduce((highest, candidate) => {
+			if (candidate === null) return highest;
+			return CAR_RUNNING_STATUS_PRIORITY[candidate] > CAR_RUNNING_STATUS_PRIORITY[highest] ? candidate : highest;
+		}, this.baseStatus);
 		this.commit(selected, now, "candidate_confirmed");
 	}
 	processUnavailable(category) {
@@ -1825,7 +1992,12 @@ var DefaultDrivingStatusController = class {
 			reason,
 			atMs: now
 		};
-		for (const listener of [...this.listeners]) safeCall(listener, event);
+		for (const listener of [...this.listeners]) invokeSafely(listener, [event], (error) => {
+			dialSdkDebugWarn(DEBUG_MODULE$1, "safeCall", "callback threw", {
+				error,
+				value: event
+			});
+		});
 		this.emitDiagnostic({
 			type: "status_committed",
 			atMs: now,
@@ -1868,6 +2040,10 @@ var DefaultDrivingStatusController = class {
 		this.turnStatus = null;
 		this.turnQuietSinceMs = null;
 		this.oppositeTurnSinceMs = null;
+		for (const detector of Object.keys(this.detectorCandidates)) {
+			this.detectorCandidates[detector] = null;
+			this.detectorRejections[detector] = null;
+		}
 	}
 	resetTransientRecognition() {
 		this.clearRecognitionWindows();
@@ -1883,7 +2059,12 @@ var DefaultDrivingStatusController = class {
 			event,
 			hasListener: this.onDiagnostic !== void 0
 		});
-		if (this.onDiagnostic) safeCall(this.onDiagnostic, event);
+		if (this.onDiagnostic) invokeSafely(this.onDiagnostic, [event], (error) => {
+			dialSdkDebugWarn(DEBUG_MODULE$1, "safeCall", "callback threw", {
+				error,
+				value: event
+			});
+		});
 	}
 	attachLifecycleListeners() {
 		if (!this.managePageLifecycle || this.unsubscribePageLifecycle !== null) return;
@@ -1899,36 +2080,57 @@ const detectLongitudinalEvidence = (window, tuning) => {
 	const normalWindow = recentMetrics(window, tuning.longitudinalWindowMs, "linearAccelerationSampledAtMs");
 	let rapidCandidate = null;
 	let rejectionReason = null;
+	const rapidValues = rapidWindow.map((sample) => sample.longitudinal);
+	const rapidMean = trimmedMean(rapidValues);
+	const rapidDirection = Math.sign(rapidMean);
+	const rapidCoherence = signCoherence(rapidValues, rapidDirection, tuning.longitudinalExitThreshold);
+	const rapidPeak = maximumAbsolute(rapidValues);
+	const longitudinalRms = rootMeanSquare(rapidValues);
+	const verticalRms = rootMeanSquare(rapidWindow.map((sample) => sample.vertical));
+	const reversalWindow = recentMetrics(window, tuning.longitudinalReversalWindowMs, "linearAccelerationSampledAtMs");
+	const hasReversal = containsBothSigns(reversalWindow.map((sample) => sample.longitudinal), tuning.longitudinalThreshold);
+	const rapidStatistics = rapidWindow.length === 0 ? null : {
+		sampleCount: rapidWindow.length,
+		durationMs: metricWindowDuration(rapidWindow, "linearAccelerationSampledAtMs"),
+		mean: rapidMean,
+		peak: rapidPeak,
+		coherence: rapidCoherence,
+		longitudinalRms,
+		verticalRms,
+		hasReversal
+	};
 	if (windowCovers(rapidWindow, tuning.rapidLongitudinalMinimumSamples, tuning.rapidLongitudinalWindowMs, "linearAccelerationSampledAtMs")) {
-		const values = rapidWindow.map((sample) => sample.longitudinal);
-		const direction = Math.sign(trimmedMean(values));
-		const coherence = signCoherence(values, direction, tuning.longitudinalExitThreshold);
-		const peak = Math.max(...values.map(Math.abs));
-		const mean = Math.abs(trimmedMean(values));
-		const longitudinalRms = rootMeanSquare(values);
-		const verticalRms = rootMeanSquare(rapidWindow.map((sample) => sample.vertical));
-		const reversalWindow = recentMetrics(window, tuning.longitudinalReversalWindowMs, "linearAccelerationSampledAtMs");
-		const hasReversal = containsBothSigns(reversalWindow.map((sample) => sample.longitudinal), tuning.longitudinalThreshold);
-		if (peak >= tuning.rapidLongitudinalPeakThreshold && mean >= tuning.rapidLongitudinalMeanThreshold) {
+		if (rapidPeak >= tuning.rapidLongitudinalPeakThreshold && Math.abs(rapidMean) >= tuning.rapidLongitudinalMeanThreshold) {
 			if (verticalRms > longitudinalRms * tuning.verticalBumpRatio) rejectionReason = "vertical_bump";
 			else if (hasReversal) rejectionReason = "longitudinal_reversal";
-			else if (direction !== 0 && coherence >= tuning.rapidLongitudinalSignCoherence) rapidCandidate = direction > 0 ? "RAPID_ACCELERATION" : "SUDDEN_BRAKING";
+			else if (rapidDirection !== 0 && rapidCoherence >= tuning.rapidLongitudinalSignCoherence) rapidCandidate = rapidDirection > 0 ? "RAPID_ACCELERATION" : "SUDDEN_BRAKING";
 		}
 	}
 	let normalCandidate = null;
 	let retainedNormal = false;
+	let normalStatistics = null;
 	if (normalWindow.length > 0) {
 		const values = normalWindow.map((sample) => sample.longitudinal);
 		const mean = trimmedMean(values);
 		const direction = Math.sign(mean);
+		const coherence = signCoherence(values, direction, tuning.longitudinalExitThreshold);
+		normalStatistics = {
+			sampleCount: normalWindow.length,
+			durationMs: metricWindowDuration(normalWindow, "linearAccelerationSampledAtMs"),
+			mean,
+			peak: maximumAbsolute(values),
+			coherence
+		};
 		retainedNormal = Math.abs(mean) >= tuning.longitudinalExitThreshold;
-		if (windowCovers(normalWindow, tuning.longitudinalMinimumSamples, tuning.longitudinalWindowMs, "linearAccelerationSampledAtMs") && Math.abs(mean) >= tuning.longitudinalThreshold && signCoherence(values, direction, tuning.longitudinalExitThreshold) >= tuning.longitudinalSignCoherence) normalCandidate = direction > 0 ? "ACCELERATION" : "BRAKING";
+		if (windowCovers(normalWindow, tuning.longitudinalMinimumSamples, tuning.longitudinalWindowMs, "linearAccelerationSampledAtMs") && Math.abs(mean) >= tuning.longitudinalThreshold && coherence >= tuning.longitudinalSignCoherence) normalCandidate = direction > 0 ? "ACCELERATION" : "BRAKING";
 	}
 	return {
 		rapidCandidate,
 		normalCandidate,
 		retainedNormal,
-		rejectionReason
+		rejectionReason,
+		normalStatistics,
+		rapidStatistics
 	};
 };
 const detectTurnEvidence = (window, tuning) => {
@@ -1936,20 +2138,47 @@ const detectTurnEvidence = (window, tuning) => {
 	if (!latest) return {
 		candidate: null,
 		latestYaw: 0,
-		sampledAtMs: 0
+		sampledAtMs: 0,
+		rejectionReason: null,
+		statistics: null
 	};
 	const strongWindow = recentMetrics(window, tuning.turnConfirmationMs, "gyroscopeSampledAtMs");
 	const strongMean = trimmedMean(strongWindow.map((sample) => sample.yaw));
 	const strongDirection = Math.sign(strongMean);
-	const strong = windowCovers(strongWindow, tuning.turnMinimumSamples, tuning.turnConfirmationMs, "gyroscopeSampledAtMs") && Math.abs(strongMean) >= tuning.turnYawThreshold && signCoherence(strongWindow.map((sample) => sample.yaw), strongDirection, tuning.turnExitYawThreshold) >= tuning.turnSignCoherence;
+	const strongCoherence = signCoherence(strongWindow.map((sample) => sample.yaw), strongDirection, tuning.turnExitYawThreshold);
+	const strong = windowCovers(strongWindow, tuning.turnMinimumSamples, tuning.turnConfirmationMs, "gyroscopeSampledAtMs") && Math.abs(strongMean) >= tuning.turnYawThreshold && strongCoherence >= tuning.turnSignCoherence;
 	const signedAngle = integrateYaw(window);
 	const gentleDirection = Math.sign(signedAngle);
-	const gentle = window.length >= tuning.turnMinimumSamples && Math.abs(signedAngle) >= tuning.turnIntegratedAngleThreshold && signCoherence(window.map((sample) => sample.yaw), gentleDirection, tuning.turnExitYawThreshold) >= tuning.turnSignCoherence;
-	const direction = strong ? strongDirection : gentle ? gentleDirection : 0;
+	const gentleCoherence = signCoherence(window.map((sample) => sample.yaw), gentleDirection, tuning.turnExitYawThreshold);
+	const yawRms = rootMeanSquare(window.map((sample) => sample.yaw));
+	const rawGyroRms = rootMeanSquare(window.map((sample) => sample.rawGyroMagnitude));
+	const yawDominance = rawGyroRms <= Number.EPSILON ? 0 : Math.min(1, yawRms / rawGyroRms);
+	const lateralRms = rootMeanSquare(window.map((sample) => sample.lateral));
+	const verticalRms = rootMeanSquare(window.map((sample) => sample.vertical));
+	const gentleShape = window.length >= tuning.turnMinimumSamples && Math.abs(signedAngle) >= tuning.turnIntegratedAngleThreshold && gentleCoherence >= tuning.turnSignCoherence;
+	const verticalDominant = verticalRms > Math.max(lateralRms, tuning.turnVerticalNoiseFloor) * tuning.turnVerticalBumpRatio;
+	const yawDominant = yawDominance >= tuning.turnYawDominanceThreshold;
+	const laterallySupported = lateralRms >= tuning.turnLateralEvidenceThreshold;
+	const rejectionReason = !strong && gentleShape && verticalDominant && !yawDominant ? "vertical_bump" : null;
+	const direction = strong ? strongDirection : gentleShape && rejectionReason === null && (yawDominant || laterallySupported) ? gentleDirection : 0;
 	return {
 		candidate: direction === 0 ? null : direction > 0 ? "LEFT_TURN" : "RIGHT_TURN",
 		latestYaw: latest.yaw,
-		sampledAtMs: latest.gyroscopeSampledAtMs
+		sampledAtMs: latest.gyroscopeSampledAtMs,
+		rejectionReason,
+		statistics: {
+			sampleCount: window.length,
+			durationMs: metricWindowDuration(window, "gyroscopeSampledAtMs"),
+			strongMean,
+			strongCoherence,
+			signedAngle,
+			gentleCoherence,
+			yawRms,
+			rawGyroRms,
+			yawDominance,
+			lateralRms,
+			verticalRms
+		}
 	};
 };
 const instantaneousCandidate = (metrics, tuning) => {
@@ -1990,6 +2219,12 @@ const signCoherence = (values, direction, deadband) => {
 };
 const containsBothSigns = (values, threshold) => values.some((value) => value >= threshold) && values.some((value) => value <= -threshold);
 const rootMeanSquare = (values) => values.length === 0 ? 0 : Math.sqrt(values.reduce((sum, value) => sum + value ** 2, 0) / values.length);
+const maximumAbsolute = (values) => values.length === 0 ? 0 : Math.max(...values.map(Math.abs));
+const metricWindowDuration = (values, timestampKey) => {
+	const first = values[0];
+	const last = values[values.length - 1];
+	return first && last ? Math.max(0, last[timestampKey] - first[timestampKey]) : 0;
+};
 const calculateCombinedAxisMad = (samples, minimumSamples) => {
 	if (samples.length < minimumSamples) return null;
 	const medianX = median(samples.map((sample) => sample.value.x));
@@ -2000,6 +2235,11 @@ const calculateCombinedAxisMad = (samples, minimumSamples) => {
 	const madZ = median(samples.map((sample) => Math.abs(sample.value.z - medianZ)));
 	return Math.hypot(madX, madY, madZ);
 };
+const vectorWindowDuration = (values) => {
+	const first = values[0];
+	const last = values[values.length - 1];
+	return first && last ? Math.max(0, last.sampledAtMs - first.sampledAtMs) : 0;
+};
 const median = (values) => {
 	if (values.length === 0) return 0;
 	const sorted = [...values].sort((left, right) => left - right);
@@ -2009,7 +2249,6 @@ const median = (values) => {
 const pushUniqueMetric = (window, metrics, timestampKey, windowMs) => {
 	const latest = window[window.length - 1];
 	if (latest && metrics[timestampKey] <= latest[timestampKey]) return false;
-	if (window.some((value) => value[timestampKey] === metrics[timestampKey])) return false;
 	window.push(metrics);
 	const cutoffMs = metrics[timestampKey] - windowMs;
 	while (window[0] && window[0][timestampKey] < cutoffMs) window.shift();
@@ -2018,67 +2257,44 @@ const pushUniqueMetric = (window, metrics, timestampKey, windowMs) => {
 const pushUniqueVector = (window, sample, windowMs) => {
 	const latest = window[window.length - 1];
 	if (latest && sample.sampledAtMs <= latest.sampledAtMs) return false;
-	if (window.some((value) => value.sampledAtMs === sample.sampledAtMs)) return false;
 	window.push(sample);
 	const cutoffMs = sample.sampledAtMs - windowMs;
 	while (window[0] && window[0].sampledAtMs < cutoffMs) window.shift();
 	return true;
 };
-const extractFreshVectorMetric = (metric, capturedAtMs, maxSampleAgeMs) => {
-	if (!metric?.available || !Number.isFinite(capturedAtMs) || !Number.isFinite(metric.sampledAtMs)) return null;
-	const ageMs = capturedAtMs - metric.sampledAtMs;
-	if (ageMs < 0 || ageMs > maxSampleAgeMs) return null;
-	const { x, y, z } = metric.value;
-	return [
-		x,
-		y,
-		z
-	].every(Number.isFinite) ? {
-		sampledAtMs: metric.sampledAtMs,
-		value: metric.value
-	} : null;
-};
 const observationTime = (metrics) => Math.max(metrics.linearAccelerationSampledAtMs, metrics.gyroscopeSampledAtMs);
 const lerpVector = (from, to, alpha) => ({
 	x: from.x + (to.x - from.x) * alpha,
 	y: from.y + (to.y - from.y) * alpha,
 	z: from.z + (to.z - from.z) * alpha
 });
-const defaultSensorProvider = () => {
-	const runtimeGlobal = globalThis;
-	if (typeof runtimeGlobal.unifiedSensorInfo !== "function") return Promise.reject(/* @__PURE__ */ new Error("window.unifiedSensorInfo is unavailable"));
-	return runtimeGlobal.unifiedSensorInfo();
-};
 const systemClock = {
 	now: () => Date.now(),
 	setTimeout: (callback, delayMs) => globalThis.setTimeout(callback, delayMs),
 	clearTimeout: (handle) => globalThis.clearTimeout(handle)
 };
 const isBaseStatus = (status) => status === "STOPPED" || status === "STEADY_DRIVING";
-const isAbortError$1 = (error) => error instanceof Error && error.name === "AbortError";
-const requirePositiveFinite = (name, value) => {
-	if (!Number.isFinite(value) || value <= 0) {
-		const error = /* @__PURE__ */ new RangeError(`${name} must be a positive finite number`);
-		dialSdkDebugWarn(DEBUG_MODULE$1, "requirePositiveFinite", "threw", error);
-		throw error;
-	}
-	return value;
-};
-const safeCall = (callback, value) => {
-	try {
-		callback(value);
-	} catch (error) {
-		dialSdkDebugWarn(DEBUG_MODULE$1, "safeCall", "callback threw", {
-			error,
-			value
-		});
-	}
-};
 const noop = () => void 0;
 //#endregion
 //#region src/sensor/driving_expression_player.ts
 const DEBUG_MODULE = "driving_expression_player.ts";
 const MAX_RETAINED_IMAGES = 3;
+const POSITIVE_FINITE_DEBUG = {
+	moduleName: DEBUG_MODULE,
+	scope: "positiveFinite"
+};
+const CREATE_ABORT_ERROR_DEBUG = {
+	moduleName: DEBUG_MODULE,
+	scope: "createAbortError"
+};
+const IS_ABORT_ERROR_DEBUG = {
+	moduleName: DEBUG_MODULE,
+	scope: "isAbortError"
+};
+const IS_RECORD_DEBUG = {
+	moduleName: DEBUG_MODULE,
+	scope: "isRecord"
+};
 const createDrivingExpressionPlayer = (container, options) => {
 	dialSdkDebugWarn(DEBUG_MODULE, "createDrivingExpressionPlayer", "called", {
 		container,
@@ -2095,6 +2311,7 @@ var DefaultDrivingExpressionPlayer = class {
 		this.mediaKind = null;
 		this.errorCategory = null;
 		this.desiredMedia = null;
+		this.desiredMediaRole = null;
 		this.userPaused = false;
 		this.lifecycleSuspended = false;
 		this.paused = false;
@@ -2143,15 +2360,15 @@ var DefaultDrivingExpressionPlayer = class {
 		this.document = container.ownerDocument;
 		this.config = options.config;
 		this.fallbacks = options.fallbacks;
-		this.loadTimeoutMs = positiveFinite("loadTimeoutMs", options.loadTimeoutMs ?? 5e3);
-		this.retryBackoffMs = positiveFinite("retryBackoffMs", options.retryBackoffMs ?? 15e3);
+		this.loadTimeoutMs = requirePositiveFinite("loadTimeoutMs", options.loadTimeoutMs ?? 5e3, POSITIVE_FINITE_DEBUG);
+		this.retryBackoffMs = requirePositiveFinite("retryBackoffMs", options.retryBackoffMs ?? 15e3, POSITIVE_FINITE_DEBUG);
 		this.fit = options.fit ?? "contain";
 		this.tgsRenderer = defaultTgsRenderer;
 		this.fetchImplementation = options.fetch ?? globalThis.fetch?.bind(globalThis);
 		this.onDiagnostic = options.onDiagnostic;
-		this.maxTgsCompressedBytes = positiveFinite("maxTgsCompressedBytes", options.maxTgsCompressedBytes ?? 2 * 1024 * 1024);
-		this.maxTgsJsonBytes = positiveFinite("maxTgsJsonBytes", options.maxTgsJsonBytes ?? 8 * 1024 * 1024);
-		this.maxTgsLayers = positiveFinite("maxTgsLayers", options.maxTgsLayers ?? 500);
+		this.maxTgsCompressedBytes = requirePositiveFinite("maxTgsCompressedBytes", options.maxTgsCompressedBytes ?? 2 * 1024 * 1024, POSITIVE_FINITE_DEBUG);
+		this.maxTgsJsonBytes = requirePositiveFinite("maxTgsJsonBytes", options.maxTgsJsonBytes ?? 8 * 1024 * 1024, POSITIVE_FINITE_DEBUG);
+		this.maxTgsLayers = requirePositiveFinite("maxTgsLayers", options.maxTgsLayers ?? 500, POSITIVE_FINITE_DEBUG);
 		if (options.managePageLifecycle ?? true) this.unsubscribePageLifecycle = subscribeDrivingPageLifecycle(this.handleLifecyclePause, this.handleLifecycleResume);
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.constructor", "created", {
 			loadTimeoutMs: this.loadTimeoutMs,
@@ -2176,24 +2393,33 @@ var DefaultDrivingExpressionPlayer = class {
 		const operation = this.beginOperation();
 		const configured = this.config.states[status];
 		if (configured === void 0) {
-			const fallback = this.fallbacks?.[status];
-			if (fallback === void 0) {
+			const fallback = this.resolveFallback(status);
+			if (fallback.type === "missing") {
+				this.desiredMedia = null;
+				this.desiredMediaRole = null;
 				this.handleFailure(status, null, new DrivingExpressionResolutionError(status), "invalid_config", operation, false);
 				dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.show", "returned after missing config");
 				return;
 			}
-			this.desiredMedia = fallback;
+			this.desiredMedia = fallback.media;
+			this.desiredMediaRole = "fallback";
 			if (this.paused) {
 				this.phase = "idle";
 				dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.show", "deferred fallback while paused");
 				return;
 			}
-			this.renderFallback(status, fallback);
+			if (fallback.type === "unsupported") {
+				this.handleFailure(status, fallback.media, unsupportedFallbackError(fallback.media), "invalid_config", operation, false, false);
+				dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.show", "returned unsupported fallback");
+				return;
+			}
+			this.renderFallback(status, fallback.media);
 			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.show", "returned fallback", { snapshot: this.getSnapshot() });
 			return;
 		}
 		const media = normalizeMedia(configured);
 		this.desiredMedia = media;
+		this.desiredMediaRole = "primary";
 		if (this.paused) {
 			this.phase = "idle";
 			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.show", "deferred media while paused", { media });
@@ -2244,6 +2470,7 @@ var DefaultDrivingExpressionPlayer = class {
 		this.container.replaceChildren();
 		this.status = null;
 		this.desiredMedia = null;
+		this.desiredMediaRole = null;
 		this.phase = "idle";
 		this.mediaKind = null;
 		this.errorCategory = null;
@@ -2312,7 +2539,12 @@ var DefaultDrivingExpressionPlayer = class {
 		}
 		if (this.status !== null && this.desiredMedia !== null) {
 			const operation = this.beginOperation();
-			this.load(this.status, this.desiredMedia, operation);
+			if (this.desiredMediaRole === "fallback") {
+				const status = this.status;
+				const fallback = this.desiredMedia;
+				if (isStaticFallback(fallback)) this.renderFallback(status, fallback);
+				else this.handleFailure(status, fallback, unsupportedFallbackError(fallback), "invalid_config", operation, false, false);
+			} else this.load(this.status, this.desiredMedia, operation);
 		}
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.updatePauseState", "returned", this.getSnapshot());
 	}
@@ -2375,7 +2607,7 @@ var DefaultDrivingExpressionPlayer = class {
 				error,
 				operation
 			});
-			if (!this.isCurrent(operation) || isAbortError(error)) {
+			if (!this.isCurrent(operation) || isAbortError(error, IS_ABORT_ERROR_DEBUG)) {
 				dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.load", "ignored error");
 				return;
 			}
@@ -2596,19 +2828,37 @@ var DefaultDrivingExpressionPlayer = class {
 			status,
 			report
 		});
-		const fallback = this.fallbacks?.[status];
-		if (!fallback) {
+		const fallback = this.resolveFallback(status);
+		if (fallback.type !== "static") {
 			this.container.replaceChildren();
-			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.renderConfiguredFallback", "returned", { result: false });
+			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.renderConfiguredFallback", "returned", {
+				result: false,
+				fallbackType: fallback.type
+			});
 			return false;
 		}
-		this.renderFallback(status, fallback, report);
+		this.renderFallback(status, fallback.media, report);
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.renderConfiguredFallback", "returned", {
 			result: true,
-			fallback
+			fallback: fallback.media
 		});
 		return true;
 	}
+	resolveFallback(status) {
+		const fallback = this.fallbacks?.[status];
+		const result = fallback === void 0 ? { type: "missing" } : isStaticFallback(fallback) ? {
+			type: "static",
+			media: fallback
+		} : {
+			type: "unsupported",
+			media: fallback
+		};
+		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.resolveFallback", "returned", {
+			status,
+			result
+		});
+		return result;
+	}
 	renderFallback(status, fallback, report = true) {
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.renderFallback", "called", {
 			status,
@@ -2621,11 +2871,11 @@ var DefaultDrivingExpressionPlayer = class {
 			this.errorCategory = null;
 		}
 		if (fallback.kind === "emoji") this.renderEmoji(fallback.text);
-		else if (fallback.kind === "image") {
+		else {
 			const image = this.createImage();
 			image.src = fallback.url;
 			this.container.replaceChildren(image);
-		} else this.container.replaceChildren();
+		}
 		if (report) this.emitDiagnostic({
 			type: "media_fallback_applied",
 			status,
@@ -2674,14 +2924,15 @@ var DefaultDrivingExpressionPlayer = class {
 		});
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.markReady", "returned", this.getSnapshot());
 	}
-	handleFailure(status, media, error, category, operation, scheduleRetry = true) {
+	handleFailure(status, media, error, category, operation, scheduleRetry = true, applyFallback = true) {
 		dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.handleFailure", "called", {
 			status,
 			media,
 			error,
 			category,
 			operation,
-			scheduleRetry
+			scheduleRetry,
+			applyFallback
 		});
 		if (!this.isCurrent(operation) || this.failedOperation === operation) {
 			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.handleFailure", "ignored");
@@ -2690,6 +2941,7 @@ var DefaultDrivingExpressionPlayer = class {
 		this.failedOperation = operation;
 		this.stopActiveVideo();
 		this.phase = "error";
+		if (!applyFallback && media !== null) this.mediaKind = media.kind;
 		this.errorCategory = category;
 		this.emitDiagnostic({
 			type: "media_load_failed",
@@ -2698,8 +2950,24 @@ var DefaultDrivingExpressionPlayer = class {
 			category,
 			message: safeErrorMessage(error)
 		});
-		const fallbackApplied = this.renderConfiguredFallback(status);
-		if (!fallbackApplied) {
+		let fallbackApplied = false;
+		const fallback = applyFallback ? this.resolveFallback(status) : { type: "missing" };
+		if (fallback.type === "static") {
+			this.renderFallback(status, fallback.media);
+			fallbackApplied = true;
+		} else if (fallback.type === "unsupported") {
+			this.container.replaceChildren();
+			this.phase = "error";
+			this.mediaKind = fallback.media.kind;
+			this.errorCategory = "invalid_config";
+			this.emitDiagnostic({
+				type: "media_load_failed",
+				status,
+				kind: fallback.media.kind,
+				category: "invalid_config",
+				message: safeErrorMessage(unsupportedFallbackError(fallback.media))
+			});
+		} else {
 			this.phase = "error";
 			this.errorCategory = category;
 		}
@@ -2945,12 +3213,9 @@ var DefaultDrivingExpressionPlayer = class {
 			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.emitDiagnostic", "returned no listener");
 			return;
 		}
-		try {
-			this.onDiagnostic(event);
-			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.emitDiagnostic", "returned", { event });
-		} catch (error) {
+		if (invokeSafely(this.onDiagnostic, [event], (error) => {
 			dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.emitDiagnostic", "listener threw", error);
-		}
+		})) dialSdkDebugWarn(DEBUG_MODULE, "DefaultDrivingExpressionPlayer.emitDiagnostic", "returned", { event });
 	}
 };
 var MediaPlayerError = class extends Error {
@@ -2983,6 +3248,8 @@ const normalizeMedia = (media) => {
 	});
 	return result;
 };
+const isStaticFallback = (media) => media.kind === "emoji" || media.kind === "image";
+const unsupportedFallbackError = (media) => new MediaPlayerError("invalid_config", `Fallback media kind ${media.kind} is unsupported; use emoji or image`);
 const isRetainableImage = (media) => {
 	if (media.mimeType?.split(";", 1)[0]?.trim().toLowerCase() === "image/gif") return false;
 	try {
@@ -3068,7 +3335,7 @@ const waitForElementEvent = (element, successEvent, failureEvent, signal, timeou
 		const handleAbort = () => {
 			dialSdkDebugWarn(DEBUG_MODULE, "waitForElementEvent.handleAbort", "called");
 			cleanup();
-			reject(createAbortError());
+			reject(createAbortError("Aborted", CREATE_ABORT_ERROR_DEBUG));
 		};
 		element.addEventListener(successEvent, handleSuccess, { once: true });
 		element.addEventListener(failureEvent, handleFailure, { once: true });
@@ -3105,7 +3372,7 @@ const withTimeout = (promise, timeoutMs, signal) => {
 		const handleAbort = () => {
 			dialSdkDebugWarn(DEBUG_MODULE, "withTimeout.handleAbort", "called");
 			cleanup();
-			reject(createAbortError());
+			reject(createAbortError("Aborted", CREATE_ABORT_ERROR_DEBUG));
 		};
 		signal.addEventListener("abort", handleAbort, { once: true });
 		timer = globalThis.setTimeout(() => {
@@ -3132,9 +3399,9 @@ const defaultTgsRenderer = async (container, animationData, signal) => {
 		animationData,
 		signal
 	});
-	if (signal.aborted) throw createAbortError();
+	if (signal.aborted) throw createAbortError("Aborted", CREATE_ABORT_ERROR_DEBUG);
 	const module = await import("lottie-web/build/player/lottie_light.js");
-	if (signal.aborted) throw createAbortError();
+	if (signal.aborted) throw createAbortError("Aborted", CREATE_ABORT_ERROR_DEBUG);
 	const animation = module.default.loadAnimation({
 		animationData,
 		autoplay: true,
@@ -3158,7 +3425,7 @@ const defaultTgsRenderer = async (container, animationData, signal) => {
 			dialSdkDebugWarn(DEBUG_MODULE, "defaultTgsRenderer.aborted", "called");
 			cleanup();
 			animation.destroy();
-			reject(createAbortError());
+			reject(createAbortError("Aborted", CREATE_ABORT_ERROR_DEBUG));
 		};
 		const cleanup = () => {
 			dialSdkDebugWarn(DEBUG_MODULE, "defaultTgsRenderer.cleanup", "called");
@@ -3197,7 +3464,7 @@ function validateTgsAnimation(value, maxLayers) {
 		value,
 		maxLayers
 	});
-	if (!isRecord(value) || !Array.isArray(value.layers)) throw new MediaPlayerError("decode", "TGS animation does not contain a layers array");
+	if (!isRecord(value, IS_RECORD_DEBUG) || !Array.isArray(value.layers)) throw new MediaPlayerError("decode", "TGS animation does not contain a layers array");
 	if (value.layers.length > maxLayers) throw new MediaPlayerError("decode", "TGS animation has too many layers");
 	if (typeof value.fr === "number" && (!Number.isFinite(value.fr) || value.fr <= 0 || value.fr > 120)) throw new MediaPlayerError("decode", "TGS animation frame rate is outside the supported range");
 	if (typeof value.ip === "number" && typeof value.op === "number" && (value.op <= value.ip || value.op - value.ip > 3e4)) throw new MediaPlayerError("decode", "TGS animation duration is outside the supported range");
@@ -3252,11 +3519,7 @@ const resetVideo = (video) => {
 	video.pause();
 	video.removeAttribute("src");
 	video.removeAttribute("type");
-	try {
-		video.load();
-	} catch (error) {
-		dialSdkDebugWarn(DEBUG_MODULE, "resetVideo", "load threw", error);
-	}
+	video.load();
 	dialSdkDebugWarn(DEBUG_MODULE, "resetVideo", "returned", { video });
 };
 const styleMediaElement = (element, fit) => {
@@ -3303,39 +3566,6 @@ const redactUrlQueries = (message) => {
 	dialSdkDebugWarn(DEBUG_MODULE, "redactUrlQueries", "returned", { result });
 	return result;
 };
-const createAbortError = () => {
-	dialSdkDebugWarn(DEBUG_MODULE, "createAbortError", "called");
-	if (typeof DOMException !== "undefined") {
-		const result = new DOMException("Aborted", "AbortError");
-		dialSdkDebugWarn(DEBUG_MODULE, "createAbortError", "returned DOMException", { result });
-		return result;
-	}
-	const error = /* @__PURE__ */ new Error("Aborted");
-	error.name = "AbortError";
-	dialSdkDebugWarn(DEBUG_MODULE, "createAbortError", "returned Error", { result: error });
-	return error;
-};
-const isAbortError = (error) => {
-	const result = error instanceof Error && error.name === "AbortError";
-	dialSdkDebugWarn(DEBUG_MODULE, "isAbortError", "returned", {
-		error,
-		result
-	});
-	return result;
-};
-const positiveFinite = (name, value) => {
-	dialSdkDebugWarn(DEBUG_MODULE, "positiveFinite", "called", {
-		name,
-		value
-	});
-	if (!Number.isFinite(value) || value <= 0) {
-		const error = /* @__PURE__ */ new RangeError(`${name} must be a positive finite number`);
-		dialSdkDebugWarn(DEBUG_MODULE, "positiveFinite", "threw", error);
-		throw error;
-	}
-	dialSdkDebugWarn(DEBUG_MODULE, "positiveFinite", "returned", { result: value });
-	return value;
-};
 const safeDestroy = (handle) => {
 	dialSdkDebugWarn(DEBUG_MODULE, "safeDestroy", "called", { handle });
 	try {
@@ -3345,13 +3575,5 @@ const safeDestroy = (handle) => {
 		dialSdkDebugWarn(DEBUG_MODULE, "safeDestroy", "destroy threw", error);
 	}
 };
-const isRecord = (value) => {
-	const result = typeof value === "object" && value !== null && !Array.isArray(value);
-	dialSdkDebugWarn(DEBUG_MODULE, "isRecord", "returned", {
-		value,
-		result
-	});
-	return result;
-};
 //#endregion
 export { BATTERY_HEALTH_LABELS, CAR_RUNNING_LABELS, CAR_RUNNING_STATUSES, CAR_RUNNING_STATUS_PRIORITY, DEFAULT_DRIVING_STATUS_TUNING, DrivingExpressionResolutionError, DrivingExpressionsConfigError, OFFICIAL_DRIVING_EXPRESSIONS_CONFIG, OFFICIAL_DRIVING_EXPRESSION_FALLBACKS, buildVehicleFrame, classifyDrivingSnapshot, createDrivingExpressionPlayer, createDrivingStatusController, extractDrivingSnapshotMetrics, isPublicDrivingMediaUrl, parseDrivingExpressionsConfig, readDrivingExpressionsConfig, resolveDrivingExpression, resolveDrivingExpressionStrict, resolveDrivingStatusTuning, tryParseDrivingExpressionsConfig, unifiedSensorInfo, waitForDrivingExpressionsConfig };