zimjs 20.0.7 → 20.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zimjs",
-  "version": "20.0.7",
+  "version": "20.0.9",
   "type": "module",
   "main": "./src/zim.js",
   "types": "./ts-src/typings/zim",

package/src/zim.js

@@ -58287,10 +58287,15 @@ Automatically manages user sensor permission via ZIM PermissionAsk if permission
 NOTE: If permission has already been granted, tilt activates immediately.
 If multiple objects call tilt(), turn(), or shake() before permission is granted, they are queued and activated together once the user accepts.
 
+NOTE: To change the text of the Dialog set: F.sensorText = "OKAY?"; // BEFORE calling the tilt() 
+To change buttons of the Dialog set: F.sensorAsk.yes.text = "OUI"; F.sensorAsk.no.text = "NON"; // AFTER calling the tilt() 
+
 ALSO: see noTilt() to remove tilt behaviors.
 
 ALSO: see tiltBoundary() to dynamically change or clear the boundary rectangle.
 
+SEE: https://zimjs.com/020/tilt.html
+
 EXAMPLE
 // Basic rolling ball constrained to stage bounds
 const ball = new Circle(30, red)
@@ -58323,135 +58328,135 @@ ready - (default null) callback function called when permission resolves, receiv
 
 RETURNS obj for chaining
 --*///+34.9
-zim.tilt = function(obj, boundary, damp, factor, mode, type, ready) {
-	var sig = "obj, boundary, damp, factor, mode, type, ready";
-	var duo; if (duo = zob(zim.tilt, arguments, sig)) return duo;
-	if ((obj.type=="AC"||(obj.type=="Emoji"&&obj.svg&&obj.svg.type=="AC"))&&WW.zdf) {WW.zdf.ac("tilt", arguments); return obj;}
-	z_d("34.9");
+	zim.tilt = function(obj, boundary, damp, factor, mode, type, ready) {
+		var sig = "obj, boundary, damp, factor, mode, type, ready";
+		var duo; if (duo = zob(zim.tilt, arguments, sig)) return duo;
+		if ((obj.type=="AC"||(obj.type=="Emoji"&&obj.svg&&obj.svg.type=="AC"))&&WW.zdf) {WW.zdf.ac("tilt", arguments); return obj;}
+		z_d("34.9");
 
-	// MONITOR
-	var mID = "z~tilt";
-	if (obj && obj.mID && ((obj.mID[2] && obj.mID[2]=="-") || obj.mID[0]=="-")) mID = "z~-";
+		// MONITOR
+		var mID = "z~tilt";
+		if (obj && obj.mID && ((obj.mID[2] && obj.mID[2]=="-") || obj.mID[0]=="-")) mID = "z~-";
 
-	if (zot(obj)) return;
+		if (zot(obj)) return;
 
-	// Clean up any existing tilt on this object first
-	if (obj._tiltTicker) zim.noTilt(obj);
-
-	var f = obj.frame || (typeof zdf != "undefined" ? zdf : WW.zdf);
-	var s = obj.stage || (f ? f.stage : null);
-
-	// Set initial boundary
-	zim.tiltBoundary(obj, boundary);
-
-	if (zot(damp)) damp = 0.05;
-	if (zot(factor)) factor = 0.5;
-	var factorX = typeof factor === "object" ? factor.x : factor;
-	var factorY = typeof factor === "object" ? factor.y : factor;
-	if (zot(mode)) mode = "move";
-	if (zot(type)) type = "deviceorientation";
-
-	var dampX = damp ? new zim.Damp(mode == "position" ? obj.x : 0, damp) : null;
-	var dampY = damp ? new zim.Damp(mode == "position" ? obj.y : 0, damp) : null;
-	var currentRot = {x: 0, y: 0, z: 0};
-
-	function updateTilt() {
-		var orient = 0;
-		if (typeof WW != "undefined") {
-			if (WW.screen && WW.screen.orientation && WW.screen.orientation.angle != null) {
-				orient = WW.screen.orientation.angle;
-			} else if (typeof WW.orientation != "undefined") {
-				orient = WW.orientation;
-			}
-		}
-
-		var beta = currentRot.x;
-		var gamma = currentRot.y;
-		var tiltX, tiltY;
-
-		if (orient == 90) {
-			tiltX = beta;
-			tiltY = -gamma;
-		} else if (orient == -90 || orient == 270) {
-			tiltX = -beta;
-			tiltY = gamma;
-		} else if (orient == 180) {
-			tiltX = -gamma;
-			tiltY = -beta;
-		} else {
-			tiltX = gamma;
-			tiltY = beta;
-		}
+		// Clean up any existing tilt on this object first
+		if (obj._tiltTicker) zim.noTilt(obj);
 
-		if (mode == "move") {
-			var rotX = dampX ? dampX.convert(tiltX) : tiltX;
-			var rotY = dampY ? dampY.convert(tiltY) : tiltY;
-			obj.x += rotX * factorX;
-			obj.y += rotY * factorY;
-		} else if (mode == "position") {
-			var targetX = (obj._tiltStartX != null ? obj._tiltStartX : obj.x) + tiltX * factorX * 10;
-			var targetY = (obj._tiltStartY != null ? obj._tiltStartY : obj.y) + tiltY * factorY * 10;
-			obj.x = dampX ? dampX.convert(targetX) : targetX;
-			obj.y = dampY ? dampY.convert(targetY) : targetY;
-		}
+		var f = obj.frame || (typeof zdf != "undefined" ? zdf : WW.zdf);
+		var s = obj.stage || (f ? f.stage : null);
 
-		if (obj._tiltBoundary) {
-			obj.x = zim.constrain(obj.x, obj._tiltBoundary.x, obj._tiltBoundary.x + obj._tiltBoundary.width);
-			obj.y = zim.constrain(obj.y, obj._tiltBoundary.y, obj._tiltBoundary.y + obj._tiltBoundary.height);
-		}
+		// Set initial boundary
+		zim.tiltBoundary(obj, boundary);
 
-		if (s) s.update();
-	}
+		if (zot(damp)) damp = 0.05;
+		if (zot(factor)) factor = 0.5;
+		var factorX = typeof factor === "object" ? factor.x : factor;
+		var factorY = typeof factor === "object" ? factor.y : factor;
+		if (zot(mode)) mode = "move";
+		if (zot(type)) type = "deviceorientation";
 
-	function activate() {
-		obj._tiltStartX = obj.x;
-		obj._tiltStartY = obj.y;
-		if (mode == "position" && dampX && dampY) {
-			dampX.immediate(obj.x);
-			dampY.immediate(obj.y);
-		}
-
-		obj._tiltType = type;
-		obj._tiltListener = function(e) {
-			if (e.rotation) {
-				currentRot.x = e.rotation.x || 0;
-				currentRot.y = e.rotation.y || 0;
-				currentRot.z = e.rotation.z || 0;
+		var dampX = damp ? new zim.Damp(mode == "position" ? obj.x : 0, damp) : null;
+		var dampY = damp ? new zim.Damp(mode == "position" ? obj.y : 0, damp) : null;
+		var currentRot = {x: 0, y: 0, z: 0};
+
+		function updateTilt() {
+			var orient = 0;
+			if (typeof WW != "undefined") {
+				if (WW.screen && WW.screen.orientation && WW.screen.orientation.angle != null) {
+					orient = WW.screen.orientation.angle;
+				} else if (typeof WW.orientation != "undefined") {
+					orient = WW.orientation;
+				}
+			}
+
+			var beta = currentRot.x;
+			var gamma = currentRot.y;
+			var tiltX, tiltY;
+
+			if (orient == 90) {
+				tiltX = beta;
+				tiltY = -gamma;
+			} else if (orient == -90 || orient == 270) {
+				tiltX = -beta;
+				tiltY = gamma;
+			} else if (orient == 180) {
+				tiltX = -gamma;
+				tiltY = -beta;
 			} else {
-				currentRot.x = e.beta || 0;
-				currentRot.y = e.gamma || 0;
-				currentRot.z = e.alpha || 0;
+				tiltX = gamma;
+				tiltY = beta;
 			}
-		};
-		f.on(type, obj._tiltListener);
 
-		obj._tiltTicker = zim.Ticker.add(updateTilt);
-		if (ready) ready(true, obj);
-	}
+			if (mode == "move") {
+				var rotX = dampX ? dampX.convert(tiltX) : tiltX;
+				var rotY = dampY ? dampY.convert(tiltY) : tiltY;
+				obj.x += rotX * factorX;
+				obj.y += rotY * factorY;
+			} else if (mode == "position") {
+				var targetX = (obj._tiltStartX != null ? obj._tiltStartX : obj.x) + tiltX * factorX * 10;
+				var targetY = (obj._tiltStartY != null ? obj._tiltStartY : obj.y) + tiltY * factorY * 10;
+				obj.x = dampX ? dampX.convert(targetX) : targetX;
+				obj.y = dampY ? dampY.convert(targetY) : targetY;
+			}
 
-	// Simple function queue
-	if (f._permissionGranted) {
-		activate();
-	} else if (f._permissionPending) {
-		f._permissionQueue.push(activate);
-	} else {
-		f._permissionPending = true;
-		f._permissionQueue = [activate];
+			if (obj._tiltBoundary) {
+				obj.x = zim.constrain(obj.x, obj._tiltBoundary.x, obj._tiltBoundary.x + obj._tiltBoundary.width);
+				obj.y = zim.constrain(obj.y, obj._tiltBoundary.y, obj._tiltBoundary.y + obj._tiltBoundary.height);
+			}
 
-		new zim.PermissionAsk(function(yes) {
-			f._permissionPending = false;
-			if (yes) {
-				f._permissionGranted = true;
-				zim.loop(f._permissionQueue, function(fn) { fn(); });
+			if (s) s.update();
+		}
+
+		function activate() {
+			obj._tiltStartX = obj.x;
+			obj._tiltStartY = obj.y;
+			if (mode == "position" && dampX && dampY) {
+				dampX.immediate(obj.x);
+				dampY.immediate(obj.y);
+			}
+
+			obj._tiltType = type;
+			obj._tiltListener = function(e) {
+				if (e.rotation) {
+					currentRot.x = e.rotation.x || 0;
+					currentRot.y = e.rotation.y || 0;
+					currentRot.z = e.rotation.z || 0;
+				} else {
+					currentRot.x = e.beta || 0;
+					currentRot.y = e.gamma || 0;
+					currentRot.z = e.alpha || 0;
+				}
+			};
+			f.on(type, obj._tiltListener);
+
+			obj._tiltTicker = zim.Ticker.add(updateTilt);
+			if (ready) ready(true, obj);
+		}
+
+		// Shared Permission check & queueing
+		if (f._permissionGranted) {
+			activate();
+		} else if (f._permissionPending) {
+			f._permissionQueue.push({ activate: activate, reject: function() { if (ready) ready(false, obj); } });
+		} else {
+			f._permissionPending = true;
+			f._permissionQueue = [{ activate: activate, reject: function() { if (ready) ready(false, obj); } }];
+
+			new zim.PermissionAsk(function(yes) {
+				f._permissionPending = false;
+				if (yes) {
+					f._permissionGranted = true;
+					zim.loop(f._permissionQueue, function(item) { item.activate(); });
+				} else {
+					zim.loop(f._permissionQueue, function(item) { item.reject(); });
+				}
 				f._permissionQueue = [];
-			} else {
-				if (ready) ready(false, obj);
-			}
-		}, type);
-	}
+			}, type);
+		}
 
-	return obj;
-};//-34.9
+		return obj;
+	};//-34.9
 
 
 /*--
@@ -58472,33 +58477,31 @@ END EXAMPLE
 
 RETURNS obj for chaining
 --*///+34.91
-zim.noTilt = function(obj) {
-	var sig = "obj";
-	var duo; if (duo = zob(zim.noTilt, arguments, sig)) return duo;
-	z_d("34.91");
-
-	if (zot(obj) || !obj.on || !obj.zimTouch) return;
+	zim.noTilt = function(obj) {
+		var sig = "obj";
+		var duo; if (duo = zob(zim.noTilt, arguments, sig)) return duo;
+		z_d("34.91");
 
-	// MONITOR
-	var mID = "z~noTilt";
-	if (obj && obj.mID && ((obj.mID[2] && obj.mID[2]=="-") || obj.mID[0]=="-")) mID = "z~-";
-	
-	if (zot(obj)) return;
-	var f = obj.frame || (typeof zdf != "undefined" ? zdf : WW.zdf);
+		if (zot(obj) || !obj.on || !obj.zimTouch) return;
 
-	if (obj._tiltListener && f) {
-		f.off(obj._tiltType || "deviceorientation", obj._tiltListener);
-		obj._tiltListener = null;
-	}
-	if (obj._tiltTicker) {
-		zim.Ticker.remove(obj._tiltTicker);
-		obj._tiltTicker = null;
-	}
-	obj._tiltBoundary = null;
+		// MONITOR
+		var mID = "z~noTilt";
+		if (obj && obj.mID && ((obj.mID[2] && obj.mID[2]=="-") || obj.mID[0]=="-")) mID = "z~-";
+		
+		var f = obj.frame || (typeof zdf != "undefined" ? zdf : WW.zdf);
 
-	return obj;
+		if (obj._tiltListener && f) {
+			f.off(obj._tiltType || "deviceorientation", obj._tiltListener);
+			obj._tiltListener = null;
+		}
+		if (obj._tiltTicker) {
+			zim.Ticker.remove(obj._tiltTicker);
+			obj._tiltTicker = null;
+		}
+		obj._tiltBoundary = null;
 
-};//-34.91
+		return obj;
+	};//-34.91
 
 
 /*--
@@ -58610,8 +58613,13 @@ NOTE: If permission has already been granted, turn activates immediately.
 If multiple objects call tilt(), turn(), or shake() before permission is granted, they are queued and activated together once the user accepts.
 Rotation is applied relative to the object's initial rotation when turn() is called (for example, an arrow rotated -90 to point up will maintain that -90 offset).
 
+NOTE: To change the text of the Dialog set: F.sensorText = "OKAY?"; // BEFORE calling the turn() 
+To change buttons of the Dialog set: F.sensorAsk.yes.text = "OUI"; F.sensorAsk.no.text = "NON"; // AFTER calling the turn() 
+
 ALSO: see noTurn() to remove turning behaviors.
 
+SEE: https://zimjs.com/020/turn.html
+
 EXAMPLE
 // Point an arrow with device heading (stays pointing up in world space)
 const arrow = new Arrow({type:"thick"}).sca(4).rot(-90).centerReg().turn();
@@ -58669,7 +58677,8 @@ RETURNS obj for chaining
 		var dampRot = damp ? new zim.Damp(obj.rotation, damp) : null;
 		var startDeviceAngle = null;
 		var currentDeviceAngle = null;
-		var lastMode = null;
+		var lastSteerAng = null;
+		var lastFlatAng = null;
 
 		function angleDiff(a, b) {
 			var diff = (a - b) % 360;
@@ -58686,28 +58695,18 @@ RETURNS obj for chaining
 		}
 
 		function updateTurn() {
-			if (startDeviceAngle === null || currentDeviceAngle === null) return;
-
-			var orient = 0;
-			if (typeof WW != "undefined") {
-				if (WW.screen && WW.screen.orientation && WW.screen.orientation.angle != null) {
-					orient = WW.screen.orientation.angle;
-				} else if (typeof WW.orientation != "undefined") {
-					orient = WW.orientation;
-				}
-			}
+			if (currentDeviceAngle === null) return;
 
 			var startRot = obj._turnStartRot != null ? obj._turnStartRot : 0;
 			var targetRot = obj.rotation;
 
 			if (mode == "relative") {
-				var diff = angleDiff(currentDeviceAngle, startDeviceAngle);
+				var diff = currentDeviceAngle - (startDeviceAngle || 0);
 				targetRot = startRot - diff * factor;
 			} else if (mode == "absolute") {
-				var absHeading = (currentDeviceAngle - orient + 360) % 360;
-				targetRot = startRot - absHeading * factor;
+				targetRot = startRot - currentDeviceAngle * factor;
 			} else if (mode == "continuous") {
-				var cDiff = angleDiff(currentDeviceAngle, startDeviceAngle);
+				var cDiff = angleDiff(currentDeviceAngle, startDeviceAngle || 0);
 				targetRot = obj.rotation - (cDiff * factor * 0.05);
 			}
 
@@ -58729,39 +58728,67 @@ RETURNS obj for chaining
 			obj._turnStartRot = obj.rotation;
 			startDeviceAngle = null;
 			currentDeviceAngle = null;
-			lastMode = null;
+			lastSteerAng = null;
+			lastFlatAng = null;
 			if (dampRot) dampRot.immediate(obj.rotation);
 
 			obj._turnType = type;
 			obj._turnListener = function(e) {
+				var orient = 0;
+				if (typeof WW != "undefined") {
+					if (WW.screen && WW.screen.orientation && WW.screen.orientation.angle != null) {
+						orient = WW.screen.orientation.angle;
+					} else if (typeof WW.orientation != "undefined") {
+						orient = WW.orientation;
+					}
+				}
+
 				var beta = e.rotation ? e.rotation.x : (e.beta || 0);
 				var gamma = e.rotation ? e.rotation.y : (e.gamma || 0);
-				var alpha = e.rotation && e.rotation.z != null ? e.rotation.z : (e.alpha != null ? (360 - e.alpha) : 0);
+				var alpha = e.rotation && e.rotation.z != null ? e.rotation.z : (e.alpha != null ? (360 - e.alpha) % 360 : 0);
 
-				var isUpright = Math.abs(beta) > 20 || Math.abs(gamma) > 20;
-				var curMode = isUpright ? "upright" : "flat";
-				var ang;
-
-				if (isUpright) {
-					var radB = beta * (Math.PI / 180);
-					var radG = gamma * (Math.PI / 180);
-					ang = Math.atan2(Math.sin(radG), Math.cos(radG) * Math.sin(radB)) * (180 / Math.PI);
+				var tiltX, tiltY;
+				if (orient == 90) {
+					tiltX = beta;
+					tiltY = -gamma;
+				} else if (orient == -90 || orient == 270) {
+					tiltX = -beta;
+					tiltY = gamma;
+				} else if (orient == 180) {
+					tiltX = -gamma;
+					tiltY = -beta;
 				} else {
-					ang = alpha;
+					tiltX = gamma;
+					tiltY = beta;
 				}
 
-				if (startDeviceAngle === null) {
-					startDeviceAngle = ang;
-					lastMode = curMode;
-					if (dampRot) dampRot.immediate(obj.rotation);
-				} else if (lastMode !== null && curMode !== lastMode) {
-					// Seamless transition between upright and flat
-					var prevDiff = angleDiff(currentDeviceAngle, startDeviceAngle);
-					startDeviceAngle = ang - prevDiff;
-					lastMode = curMode;
-				}
+				var mag = Math.sqrt(tiltX * tiltX + tiltY * tiltY);
+				var steerAng = Math.atan2(tiltX, tiltY) * (180 / Math.PI);
+				var flatAng = (alpha - orient + 360) % 360;
 
-				currentDeviceAngle = ang;
+				if (mode == "absolute") {
+					currentDeviceAngle = flatAng;
+					if (startDeviceAngle === null) startDeviceAngle = flatAng;
+				} else {
+					if (currentDeviceAngle === null) {
+						startDeviceAngle = 0;
+						currentDeviceAngle = 0;
+						lastSteerAng = steerAng;
+						lastFlatAng = flatAng;
+						if (dampRot) dampRot.immediate(obj.rotation);
+					} else {
+						var dSteer = angleDiff(steerAng, lastSteerAng);
+						var dFlat = angleDiff(flatAng, lastFlatAng);
+
+						// Smoothly blend between flat table (mag <= 20) and upright wheel (mag >= 50)
+						var w = zim.constrain((mag - 20) / 30, 0, 1);
+						var delta = (1 - w) * dFlat + w * dSteer;
+
+						currentDeviceAngle += delta;
+						lastSteerAng = steerAng;
+						lastFlatAng = flatAng;
+					}
+				}
 			};
 			f.on(type, obj._turnListener);
 
@@ -58769,24 +58796,24 @@ RETURNS obj for chaining
 			if (ready) ready(true, obj);
 		}
 
-		// Simple function queue
+		// Shared Permission check & queueing
 		if (f._permissionGranted) {
 			activate();
 		} else if (f._permissionPending) {
-			f._permissionQueue.push(activate);
+			f._permissionQueue.push({ activate: activate, reject: function() { if (ready) ready(false, obj); } });
 		} else {
 			f._permissionPending = true;
-			f._permissionQueue = [activate];
+			f._permissionQueue = [{ activate: activate, reject: function() { if (ready) ready(false, obj); } }];
 
 			new zim.PermissionAsk(function(yes) {
 				f._permissionPending = false;
 				if (yes) {
 					f._permissionGranted = true;
-					zim.loop(f._permissionQueue, function(fn) { fn(); });
-					f._permissionQueue = [];
+					zim.loop(f._permissionQueue, function(item) { item.activate(); });
 				} else {
-					if (ready) ready(false, obj);
+					zim.loop(f._permissionQueue, function(item) { item.reject(); });
 				}
+				f._permissionQueue = [];
 			}, type);
 		}
 
@@ -58851,8 +58878,13 @@ Automatically manages user sensor permission via ZIM PermissionAsk if permission
 NOTE: If permission has already been granted, shake activates immediately.
 If multiple objects call tilt(), turn(), or shake() before permission is granted, they are queued and activated together once the user accepts.
 
+NOTE: To change the text of the Dialog set: F.sensorText = "OKAY?"; // BEFORE calling the shake() 
+To change buttons of the Dialog set: F.sensorAsk.yes.text = "OUI"; F.sensorAsk.no.text = "NON"; // AFTER calling the shake() 
+
 ALSO: see noShake() to remove shake listeners.
 
+SEE: https://zimjs.com/020/shake.html
+
 EXAMPLE
 const color = series(red,green,blue);
 const bottle = new Rectangle(80, 160, purple).centerReg().shake({
@@ -58897,137 +58929,137 @@ Dispatches a "shakestop" event on obj when shaking stops.
 
 RETURNS obj for chaining
 --*///+34.95
-zim.shake = function(obj, call, stopCall, threshold, wait, factor, type, ready) {
-	var sig = "obj, call, stopCall, threshold, wait, factor, type, ready";
-	var duo; if (duo = zob(zim.shake, arguments, sig)) return duo;
-	if ((obj.type=="AC"||(obj.type=="Emoji"&&obj.svg&&obj.svg.type=="AC"))&&WW.zdf) {WW.zdf.ac("shake", arguments); return obj;}
-	z_d("34.95");
+	zim.shake = function(obj, call, stopCall, threshold, wait, factor, type, ready) {
+		var sig = "obj, call, stopCall, threshold, wait, factor, type, ready";
+		var duo; if (duo = zob(zim.shake, arguments, sig)) return duo;
+		if ((obj.type=="AC"||(obj.type=="Emoji"&&obj.svg&&obj.svg.type=="AC"))&&WW.zdf) {WW.zdf.ac("shake", arguments); return obj;}
+		z_d("34.95");
 
-	// MONITOR
-	var mID = "z~shake";
-	if (obj && obj.mID && ((obj.mID[2] && obj.mID[2]=="-") || obj.mID[0]=="-")) mID = "z~-";
+		// MONITOR
+		var mID = "z~shake";
+		if (obj && obj.mID && ((obj.mID[2] && obj.mID[2]=="-") || obj.mID[0]=="-")) mID = "z~-";
 
-	if (zot(obj)) return;
+		if (zot(obj)) return;
 
-	// Clean up any existing shake on this object first
-	if (obj._shakeListener) zim.noShake(obj);
+		// Clean up any existing shake on this object first
+		if (obj._shakeListener) zim.noShake(obj);
 
-	var f = obj.frame || (typeof zdf != "undefined" ? zdf : WW.zdf);
-	var s = obj.stage || (f ? f.stage : null);
+		var f = obj.frame || (typeof zdf != "undefined" ? zdf : WW.zdf);
+		var s = obj.stage || (f ? f.stage : null);
 
-	if (zot(threshold)) threshold = 10;
-	if (zot(wait)) wait = 0.5;
-	if (zot(factor)) factor = 1;
-	if (zot(type)) type = "devicemotion";
+		if (zot(threshold)) threshold = 10;
+		if (zot(wait)) wait = 0.5;
+		if (zot(factor)) factor = 1;
+		if (zot(type)) type = "devicemotion";
 
-	var lastX = 0, lastY = 0, lastZ = 0;
-	var lastTime = 0;
+		var lastX = 0, lastY = 0, lastZ = 0;
+		var lastTime = 0;
 
-	function handleMotion(e) {
-		var acc = e.acceleration && (e.acceleration.x != null || e.acceleration.y != null) ? 
-			e.acceleration : (e.accelerationIncludingGravity || e);
+		function handleMotion(e) {
+			var acc = e.acceleration && (e.acceleration.x != null || e.acceleration.y != null) ? 
+				e.acceleration : (e.accelerationIncludingGravity || e);
 
-		var ax = acc.x || 0;
-		var ay = acc.y || 0;
-		var az = acc.z || 0;
+			var ax = acc.x || 0;
+			var ay = acc.y || 0;
+			var az = acc.z || 0;
 
-		var deltaX = ax - lastX;
-		var deltaY = ay - lastY;
-		var deltaZ = az - lastZ;
+			var deltaX = ax - lastX;
+			var deltaY = ay - lastY;
+			var deltaZ = az - lastZ;
 
-		lastX = ax;
-		lastY = ay;
-		lastZ = az;
+			lastX = ax;
+			lastY = ay;
+			lastZ = az;
 
-		var mag = Math.sqrt(deltaX * deltaX + deltaY * deltaY + deltaZ * deltaZ) * factor;
+			var mag = Math.sqrt(deltaX * deltaX + deltaY * deltaY + deltaZ * deltaZ) * factor;
 
-		if (mag >= threshold) {
-			var now = Date.now();
+			if (mag >= threshold) {
+				var now = Date.now();
 
-			// Reset stop timer on active motion
-			if (obj._shakeStopTimeout) obj._shakeStopTimeout.clear();
+				if (obj._shakeStopTimeout) obj._shakeStopTimeout.clear();
 
-			obj._shakeStopTimeout = zim.timeout(wait, function() {
-				obj._shakeStopTimeout = null;
-				if (stopCall) stopCall(obj);
-				obj.dispatchEvent({
-					type: "shakestop",
-					event: e
+				obj._shakeStopTimeout = zim.timeout(wait, function() {
+					obj._shakeStopTimeout = null;
+					if (stopCall) stopCall(obj);
+					obj.dispatchEvent({
+						type: "shakestop",
+						event: e
+					});
+					if (s) s.update();
 				});
-				if (s) s.update();
-			});
 
-			if (now - lastTime >= wait * 1000) {
-				lastTime = now;
+				if (now - lastTime >= wait * 1000) {
+					lastTime = now;
 
-				var orient = 0;
-				if (typeof WW != "undefined") {
-					if (WW.screen && WW.screen.orientation && WW.screen.orientation.angle != null) {
-						orient = WW.screen.orientation.angle;
-					} else if (typeof WW.orientation != "undefined") {
-						orient = WW.orientation;
+					var orient = 0;
+					if (typeof WW != "undefined") {
+						if (WW.screen && WW.screen.orientation && WW.screen.orientation.angle != null) {
+							orient = WW.screen.orientation.angle;
+						} else if (typeof WW.orientation != "undefined") {
+							orient = WW.orientation;
+						}
 					}
-				}
 
-				var shakeX, shakeY, shakeZ = deltaZ * factor;
-				if (orient == 90) {
-					shakeX = deltaY * factor;
-					shakeY = -deltaX * factor;
-				} else if (orient == -90 || orient == 270) {
-					shakeX = -deltaY * factor;
-					shakeY = deltaX * factor;
-				} else if (orient == 180) {
-					shakeX = -deltaX * factor;
-					shakeY = -deltaY * factor;
-				} else { // 0 portrait
-					shakeX = deltaX * factor;
-					shakeY = deltaY * factor;
-				}
-
-				if (call) call(mag, shakeX, shakeY, shakeZ, obj, e);
-				obj.dispatchEvent({
-					type: "shake",
-					total: mag,
-					x: shakeX,
-					y: shakeY,
-					z: shakeZ,
-					event: e
-				});
+					var shakeX, shakeY, shakeZ = deltaZ * factor;
+					if (orient == 90) {
+						shakeX = deltaY * factor;
+						shakeY = -deltaX * factor;
+					} else if (orient == -90 || orient == 270) {
+						shakeX = -deltaY * factor;
+						shakeY = deltaX * factor;
+					} else if (orient == 180) {
+						shakeX = -deltaX * factor;
+						shakeY = -deltaY * factor;
+					} else {
+						shakeX = deltaX * factor;
+						shakeY = deltaY * factor;
+					}
 
+					if (call) call(mag, shakeX, shakeY, shakeZ, obj, e);
+					obj.dispatchEvent({
+						type: "shake",
+						total: mag,
+						x: shakeX,
+						y: shakeY,
+						z: shakeZ,
+						event: e
+					});
+
+					if (s) s.update();
+				}
 			}
 		}
-	}
 
-	function activate() {
-		obj._shakeType = type;
-		obj._shakeListener = handleMotion;
-		f.on(type, obj._shakeListener);
-		if (ready) ready(true, obj);
-	}
+		function activate() {
+			obj._shakeType = type;
+			obj._shakeListener = handleMotion;
+			f.on(type, obj._shakeListener);
+			if (ready) ready(true, obj);
+		}
 
-	// Simple function queue
-	if (f._permissionGranted) {
-		activate();
-	} else if (f._permissionPending) {
-		f._permissionQueue.push(activate);
-	} else {
-		f._permissionPending = true;
-		f._permissionQueue = [activate];
+		// Shared Permission check & queueing
+		if (f._permissionGranted) {
+			activate();
+		} else if (f._permissionPending) {
+			f._permissionQueue.push({ activate: activate, reject: function() { if (ready) ready(false, obj); } });
+		} else {
+			f._permissionPending = true;
+			f._permissionQueue = [{ activate: activate, reject: function() { if (ready) ready(false, obj); } }];
 
-		new zim.PermissionAsk(function(yes) {
-			f._permissionPending = false;
-			if (yes) {
-				f._permissionGranted = true;
-				zim.loop(f._permissionQueue, function(fn) { fn(); });
+			new zim.PermissionAsk(function(yes) {
+				f._permissionPending = false;
+				if (yes) {
+					f._permissionGranted = true;
+					zim.loop(f._permissionQueue, function(item) { item.activate(); });
+				} else {
+					zim.loop(f._permissionQueue, function(item) { item.reject(); });
+				}
 				f._permissionQueue = [];
-			} else {
-				if (ready) ready(false, obj);
-			}
-		}, type);
-	}
+			}, type);
+		}
 
-	return obj;
-};//-34.95
+		return obj;
+	};//-34.95
 
 
 /*--
@@ -59048,30 +59080,30 @@ END EXAMPLE
 
 RETURNS obj for chaining
 --*///+34.96
-zim.noShake = function(obj) {
-	var sig = "obj";
-	var duo; if (duo = zob(zim.noShake, arguments, sig)) return duo;
-	z_d("34.96");
+	zim.noShake = function(obj) {
+		var sig = "obj";
+		var duo; if (duo = zob(zim.noShake, arguments, sig)) return duo;
+		z_d("34.96");
 
-	if (zot(obj) || !obj.on || !obj.zimTouch) return;
+		if (zot(obj) || !obj.on || !obj.zimTouch) return;
 
-	// MONITOR
-	var mID = "z~noShake";
-	if (obj && obj.mID && ((obj.mID[2] && obj.mID[2]=="-") || obj.mID[0]=="-")) mID = "z~-";
+		// MONITOR
+		var mID = "z~noShake";
+		if (obj && obj.mID && ((obj.mID[2] && obj.mID[2]=="-") || obj.mID[0]=="-")) mID = "z~-";
 
-	var f = obj.frame || (typeof zdf != "undefined" ? zdf : WW.zdf);
+		var f = obj.frame || (typeof zdf != "undefined" ? zdf : WW.zdf);
 
-	if (obj._shakeListener && f) {
-		f.off(obj._shakeType || "devicemotion", obj._shakeListener);
-		obj._shakeListener = null;
-	}
-	if (obj._shakeStopTimeout) {
-		obj._shakeStopTimeout.clear();
-		obj._shakeStopTimeout = null;
-	}
+		if (obj._shakeListener && f) {
+			f.off(obj._shakeType || "devicemotion", obj._shakeListener);
+			obj._shakeListener = null;
+		}
+		if (obj._shakeStopTimeout) {
+			obj._shakeStopTimeout.clear();
+			obj._shakeStopTimeout = null;
+		}
 
-	return obj;
-};//-34.96
+		return obj;
+	};//-34.96
 
 // SUBSECTION HIT TESTS
 
@@ -98631,118 +98663,6 @@ END EXAMPLE
 // See Frame for the cursors property
 //-83.867
 
-/*--
-Tilt - device orientation event
-
-Tilt
-"deviceorientation" Frame event
-
-DESCRIPTION
-The Frame has a "deviceorientation" event to capture tilt or device rotation (like a compass)
-and a "devicemotion" event to capture shaking the device with the accelerometer.
-
-SEE: the tilt() method (just after gesture()) for a one line version
-
-SEE: Shake - for the "devicemotion" event for accelerometer motion
-
-SEE: the PermissionAsk() class which will handle asking for permissions on devices.
-
-EXAMPLE
-// SEE ALSO THE TILT METHOD FOR A ONE LINE VERSION
-
-// TILT OR COMPASS - https://zimjs.com/zapp/Z_Q5UYS
-// for capturing tilt on device (rotation about an axis)
-// be on a mobile device or a device with sensors
-new PermissionAsk(yes=>{
-	if (yes) { // the user answered yes to PermissionAsk
-		// all code goes in here
-		new Label("Tilt the device to move circle").alp(.3).pos(0,30,CENTER);
-		const circle = new Circle().center();
-		const amount = .5;
-		const compass = new Line(60, 4, light, "arrow").rot(90).centerReg(circle); // point up
-		F.on("deviceorientation", e=>{
-		    // for tilt 
-			circle.mov(e.rotation.y*amount, e.rotation.x*amount);
-			circle.x = constrain(circle.x, 0, W);
-			circle.y = constrain(circle.y, 0, H);
-			// for compass use e.rotation.z 
-			// which has 0 angle at device start rotation (not necessarily North)
-			compass.rot(90-e.rotation.z); // rotate opposite device rotation
-			S.update();
-		});
-	} else { // the user answered no to PermissionAsk 		
-		new Pane("SENSOR not available",yellow).show();	
-	}
-});
-END EXAMPLE
-
-EVENTS 
-"deviceorientation" - for tilt 
-	fired as device orientation changes:
-		eventObject.rotation.x (beta in HTML specs) holds rotation about the x axis between -180 and 180 (tipped forward or backward)
-		eventObject.rotation.y (gamma in HTML specs) holds rotation about the y axis between -90 and 90 (tipped left or right)
-		eventObject.rotation.z (alpha in HTML specs) holds rotation about the z axis 0-360 clockwise (relative to orientation when app loads)
-			note rotation.z is 360-alpha compared to the HTML 5 specs
-			note also that beta, gamma and alpha from the HTML 5 specs are also provided
---*///+83.86
-// Device motion and orientation events are available as Frame events
-//-83.86
-
-/*--
-Shake - device motion event
-
-Shake
-"devicemotion" Frame event
-
-DESCRIPTION
-The Frame has a "devicemotion" event to capture shaking the device with the accelerometer.
-
-SEE: Tilt - for the "deviceorientation" event for tilt or compass
-
-SEE: the PermissionAsk() class which will handle asking for permissions on devices.
-
-EXAMPLE
-// SHAKE - https://zimjs.com/zapp/Z_XF8JM
-// for capturing shaking motion on device (acceleration about an axis)
-// be on a mobile device or a device with sensors
-new PermissionAsk(init, "devicemotion");
-function init(yes) {	
-	if (yes) { // the user answered yes to PermissionAsk	
-		// all code goes in here		
-		new Label("Shake the device").center();
-		S.update();
-		let id;
-		F.on("devicemotion", e=>{
-			// for shake	
-		    if (
-		        Math.abs(e.acceleration.x) > 5 ||
-		        Math.abs(e.acceleration.y) > 5 ||
-		        Math.abs(e.acceleration.z) > 5
-		    ) {
-		        if (F.color != green) {
-		            F.color = green;
-		            S.update();
-		        }
-		        if (id) id.clear();
-		        id = timeout(.2, ()=>{
-		            F.color = light;
-		            S.update();
-		        });
-		    } 
-		});
-	} else { // the user answered no to PermissionAsk		
-		new Pane("SENSOR not available",yellow).show();
-	}	
-}
-END EXAMPLE
-
-EVENTS 
-"devicemotion" - for shake
-	fired on moving mobile device - like a shake - eventObject.acceleration holds x, y and z properties of motion   
---*///+83.87
-// Device motion and orientation events are available as Frame events
-//-83.87
-
 /*--
 zim.PermissionAsk = function(callback, permissionType, color, backgroundColor, style, group, inherit)
 
@@ -98758,9 +98678,14 @@ Pre ZIM 018, this was done with a sensors parameter on the Frame.
 The sensors parameter has now been removed and the events are handled with PermissionAsk.
 
 NOTE: this started as SensorAsk but the class has been adjusted to handle other permissions and the name has been changed in ZIM 016
+
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
+
 NOTE: sensor prompt text can be customized prior to calling with F.sensorText = "Custom message";
 
+NOTE: as of ZIM 020 tilt(), turn(), and shake() can be applied as methods to DisplayObjects
+and will call PermissionAsk automatically so would suggest using those methods
+
 EXAMPLE
 // DEVICE ORIENTATION - gives angle of device in all 3 dimensions
 // See https://zimjs.com/zapp/Z_Q5UYS
@@ -98930,42 +98855,71 @@ no - reference to the zim Button with NO
             return;
         }
 
-        // sensors only		
-		if (typeof DeviceOrientationEvent != "undefined" && DeviceOrientationEvent && typeof DeviceOrientationEvent.requestPermission == "function") {
+        // Fast check: if sensors not supported in environment (e.g. non-secure HTTP or missing API)
+        var hasOrientAPI = typeof DeviceOrientationEvent != "undefined" && DeviceOrientationEvent;
+        var hasMotionAPI = typeof DeviceMotionEvent != "undefined" && DeviceMotionEvent;
+        if (WW.isSecureContext === false || (pt == "deviceorientation" && !hasOrientAPI) || (pt == "devicemotion" && !hasMotionAPI)) {
+            callback(false, pt == "deviceorientation" ? 1 : 2);
+            return;
+        }
+
+        var isIOS = (M == "ios" || (typeof navigator != "undefined" && (/iPad|iPhone|iPod/.test(navigator.userAgent) || (navigator.platform === "MacIntel" && navigator.maxTouchPoints > 1))));
+
+        // Sensors probe: Only iOS devices with requestPermission require the PermissionAsk popup
+		if (isIOS && typeof DeviceOrientationEvent != "undefined" && DeviceOrientationEvent && typeof DeviceOrientationEvent.requestPermission == "function") {
 			setPane();
 		} else {
-			var called = false;
-			WW.addEventListener(permissionType, testMe);
+			var tested = false;
+			var timer = setTimeout(function() {
+				if (tested) return;
+				tested = true;
+				WW.removeEventListener(permissionType, testMe);
+				callback(false, 3); // 3 - timeout / no sensor hardware (e.g. desktop)
+			}, 500);
+
 			function testMe(e) {
-				if (okay) return;
-				if (permissionType=="deviceorientation") {
-					if (e.alpha==null || (e.alpha==0&&e.beta==0&&e.gamma==0)) callback(false, 1);
-					else setEvents();
+				if (tested || okay) return;
+				if (permissionType == "deviceorientation") {
+					if (e.alpha != null || e.beta != null || e.gamma != null) {
+						tested = true;
+						clearTimeout(timer);
+						WW.removeEventListener(permissionType, testMe);
+						setEvents();
+					} else {
+						tested = true;
+						clearTimeout(timer);
+						WW.removeEventListener(permissionType, testMe);
+						callback(false, 1);
+					}
 				} else {
-					if (!e.acceleration || e.acceleration.x==null) callback(false, 2);
-					else setEvents();
-				}	
-				called = true;
-				WW.removeEventListener(permissionType, testMe);				               
-            }
-			setTimeout(function(){
-				if (!called) callback(false, 3);
-			}, 5000);
+					var hasAcc = e.acceleration && (e.acceleration.x != null || e.acceleration.y != null || e.acceleration.z != null);
+					var hasGrav = e.accelerationIncludingGravity && (e.accelerationIncludingGravity.x != null || e.accelerationIncludingGravity.y != null || e.accelerationIncludingGravity.z != null);
+					if (hasAcc || hasGrav) {
+						tested = true;
+						clearTimeout(timer);
+						WW.removeEventListener(permissionType, testMe);
+						setEvents();
+					} else {
+						tested = true;
+						clearTimeout(timer);
+						WW.removeEventListener(permissionType, testMe);
+						callback(false, 2);
+					}
+				}
+			}
+			WW.addEventListener(permissionType, testMe);
 		}
 
-		var lastZ = 0;
-		var flip = 0;
 		function deviceorientationEvent(e) {
-			var z = 360-e.alpha;
-			if (Math.abs(z-lastZ) > 180 - 45 && Math.abs(z-lastZ) < 180 + 45) flip = flip == 0 ? 180 : 0;
-			lastZ = z;
-			e.rotation = {x:e.beta, y:e.gamma, z:(z + flip) % 360};
+			var z = e.alpha != null ? (360 - e.alpha) % 360 : 0;
+			e.rotation = {x:e.beta || 0, y:e.gamma || 0, z:z};
 			frame.dispatchEvent(e);			
 		}
 		function devicemotionEvent(e) {
 			frame.dispatchEvent(e);
 		}
 		function setEvents() {
+			if (frame) frame._permissionGranted = true;
 			if (permissionType=="deviceorientation") {		
 				frame.zimDeviceorientationEvent = deviceorientationEvent;
 				WW.addEventListener("deviceorientation", frame.zimDeviceorientationEvent);
@@ -107998,4 +107952,4 @@ export let Ticker = zim.Ticker;
 export let Style = zim.Style;
 export let assets = zim.assets;
 export let assetIDs = zim.assetIDs;
-export let ZIMON = zim.ZIMON;
+export let ZIMON = zim.ZIMON;