zimjs 16.2.5 → 16.2.7

package/package.json

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

package/src/zim.js

@@ -3458,8 +3458,8 @@ NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set
 EXAMPLE
 const blob = new Blob().center();
 const points = blob.segmentPoints;
-S.on("stagemousedown", e=>{
-	const point = blob.globalToLocal(e.stageX, e.stageY)
+S.on("stagemousedown", ()=>{
+	const point = blob.globalToLocal(F.mouseX, F.mouseY)
 	zog(closestPointAlongCurve({x:point.x, y:point.y}, points))
 	// gives index of point on curve before mouse location
 });
@@ -3489,14 +3489,21 @@ RETURNS the index of the closest point in segmentPoints before the given point
 		var index = 0;
 		var secondaryIndex = 0;
 		if (zot(num)) num = 10;
+		var totalD = 0;
+		var totals = [];
+		var lastDist=0;
 		zim.loop(segmentPoints, function(points, i) {
 			// add num more points to estimate closest
+			var dist = zim.distanceAlongCurve(points);
+			totalD += dist;	
 			var cubic = new zim.Bezier(points[0],points[1],points[2],points[3]);
 			zim.loop(num, function (j, total) {
 				// var d = zim.dist(point, zim.pointAlongCurve(segmentPoints(that.points[i], that.points[i<t-1?i+1:0]), j/10));
 				// var testPoint = zim.pointAlongCurve(points, j/total);
 				// var d = zim.dist(point, testPoint);
-				var testPoint = {x:cubic.x(j/total), y:cubic.y(j/total)};
+				totals.push(lastDist+dist*j/total);
+				// if (even) var testPoint = {x:cubic.mx(j/total), y:cubic.my(j/total)};
+				var testPoint = {x:cubic.x(j/total), y:cubic.y(j/total)};				
 				var d = zim.dist(point, testPoint);
 				if (d < closest) {
 					closest = d;
@@ -3505,9 +3512,11 @@ RETURNS the index of the closest point in segmentPoints before the given point
 					secondaryIndex = j;
 				}
 			});
+			lastDist = totalD;
 		});
 		if (percentage) {
-			return (index*num+secondaryIndex)/(segmentPoints.length*num)*100;
+			return (totals[index*num+secondaryIndex]||0)/totalD*100;
+			// return (index*num+secondaryIndex)/(segmentPoints.length*num)*100;
 		} else if (interpolate) {
 			return closestTestPoint;
 		}
@@ -6558,11 +6567,11 @@ NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set
 
 EXAMPLE
 const assets = "flecks.jpg";
-const path = "assets/";
+const path = "https://zimjs.org/assets/";
 new Frame(scaling, width, height, color, outerColor, ready, assets, path);
 function ready() {
 	new Rectangle(W, H, new BitmapColor("flecks.jpg")).addTo();
-	// or use asset("flecks.png") instead of string "flecks.jpg" - but ZIM will figure it out
+	// or use new Pic("flecks.jpg") instead of string "flecks.jpg" - but ZIM will figure it out
 }
 END EXAMPLE
 
@@ -13788,7 +13797,8 @@ clone(exact) - makes a copy of the shape
 	For instance, if the object's color is [blue, green]
 	then its clone might be blue or green - which could be different than the original
 	If exact is set to true then the clone will be the color of the original object
-cloneAll(exact, style, group, inherit) - copies shape and any custom content in shape - experimental - usually shapes do not have content (use a Container)
+	Warning: clone does not clone any content added to a shape - use a Container for that - see cloneAll()
+cloneAll(exact, style, group, inherit) - copies shape and any custom content in shape - experimental
 	exact (default false) in theory will copy ZIM VEE values as they are in the original
 	see main class for style, group, inherit parameters
 dispose() - removes from parent, removes event listeners - must still set outside references to null for garbage collection
@@ -14062,7 +14072,8 @@ clone(exact) - makes a copy of the shape
 	For instance, if the object's color is [blue, green]
 	then its clone might be blue or green - which could be different than the original
 	If exact is set to true then the clone will be the color of the original object
-cloneAll(exact style, group, inherit) - copies shape and any custom content in shape - experimental - usually shapes do not have content (use a Container)
+	Warning: clone does not clone any content added to a shape - use a Container for that - see cloneAll()
+cloneAll(exact style, group, inherit) - copies shape and any custom content in shape - experimental
 	exact (default false) in theory will copy ZIM VEE values as they are in the original
 	see main class for style, group, inherit parameters
 dispose() - removes from parent, removes event listeners - must still set outside references to null for garbage collection
@@ -14305,12 +14316,13 @@ if one color is used, the current color is used and color1 is the second color i
 cache(see Container docs for parameter description) - overrides CreateJS cache() and returns object for chaining
 Leave parameters blank to cache bounds of shape (plus outer edge of border if borderWidth > 0)
 hasProp(property as String) - returns true if property exists on object else returns false
-clone() - makes a copy of the shape
-exact (default false) ZIM VEE (Pick) values are active in clones unless exact is set to true
+clone(exact) - makes a copy of the shape
+	exact (default false) ZIM VEE (Pick) values are active in clones unless exact is set to true
 	For instance, if the object's color is [blue, green]
 	then its clone might be blue or green - which could be different than the original
 	If exact is set to true then the clone will be the color of the original object
-cloneAll(exact style, group, inherit) - copies shape and any custom content in shape - experimental - usually shapes do not have content (use a Container)
+	Warning: clone does not clone any content added to a shape - use a Container for that - see cloneAll()
+cloneAll(exact style, group, inherit) - copies shape and any custom content in shape - experimental
 	exact (default false) in theory will copy ZIM VEE values as they are in the original
 	see main class for style, group, inherit parameters
 exact (default false) in theory will copy ZIM VEE values as they are in the original
@@ -21913,7 +21925,7 @@ zim.LabelOnPath = function(label, path, percentAngle, percents, showPath, allowT
 		return that;
 	};
 
-	that.toggle(true);
+	if (showPath) that.toggle(true);
 
 	if (style!==false) zim.styleTransforms(this, DS);
 	this.clone = function() {
@@ -36134,6 +36146,7 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
         this.type = "NumPad";	
 
 		var that = this;
+
 				
 		function ms(letter, color) {
 			if (zot(color)) color = mist;
@@ -36143,7 +36156,12 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 			ms("C",zim.red.darken(.1)),ms(new zim.Label({text:"␣", size:90, shiftV:-24}),zim.yellow.darken(.1)),ms(new zim.Label({text:"/",size:48,bold:true,shiftV:3})),ms(new zim.Label({text:"*", size:65, shiftV:18})),
 			1,2,3,ms(new zim.Label({text:"-",size:60,shiftV:-3})),4,5,6,ms(new zim.Label({text:"+",size:55,shiftV:3})),
 			7,8,9,ms(new zim.Label({text:"⌫",size:M=="ios"?60:35}), zim.red.darken(.1)),
-			ms(new zim.Label({text:",",size:70,shiftV:-3})),ms(new Label({text:".",size:70,shiftV:-3})),0,ms(new zim.Label({text:"⏎", size:M=="ios"?40:50, shiftV:5}), zim.green.darken(.1))]
+			ms(new zim.Label({text:",",size:70,shiftV:-3})),ms(new Label({text:".",size:70,shiftV:-3})),0,ms(new zim.Label({text:"⏎", size:M=="ios"?40:50, shiftV:5}), zim.green.darken(.1))];
+		
+		
+		function isRTL(){   
+			return getComputedStyle(zdf.canvas).direction == "rtl";						
+		};
 		if (advanced=="simple") {
 			padArray.splice(0,4);
 			padArray.splice(3,1);
@@ -36155,8 +36173,8 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 		} else if (advanced) {
 			padArray.splice(2,0,ms("%", yellow.darken(.1)));
 			padArray.splice(4,0,ms(new zim.Label({text:"^",size:47,shiftV:10}), yellow.darken(.1)));
-			padArray.splice(4,0,ms(")", yellow.darken(.1)));
-			padArray.splice(4,0,ms("(", yellow.darken(.1)));
+			padArray.splice(4,0,ms(isRTL()?"(":")", yellow.darken(.1)));
+			padArray.splice(4,0,ms(isRTL()?")":"(", yellow.darken(.1)));
 		}
 		that.pad = new zim.Pad({
             width:advanced=="simple"?290:380,
@@ -39266,6 +39284,7 @@ Dispatches a "keydown" event with an event object having a letter property
 	keyboard.on("keydown", function(e) {zog(e.letter);}); // logs letter pressed or "del" for delete
 Dispatches a "special" event if the special parameter is used and the special key is pressed
 Dispatches a "close" event when close keyboard icon at bottom right is pressed
+Dispatches "numpadopen" and "numpadclose" events when the NumPad is opened or closed 
 
 ALSO: see the CreateJS Easel Docs for Container events such as:
 added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmove, pressup, removed, rollout, rollover
@@ -40042,15 +40061,18 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 						that.toggled = false;
 						removeCursorShiftMenu();
 					}
+					that.dispatchEvent("numpadclose");
 				});
 			}
 			
 			numPadKey.removeChildAt(2);	
 			if (that.numPad.parent || status === false) {
 				that.numPad.removeFrom();
+				that.dispatchEvent("numpadclose");
 				showNumPadIcon.clone().scaleTo(numPadKey, 60, 60).centerReg(numPadKey,2);
 			} else if (!that.numPad.parent || status === true) {
 				that.numPad.addTo();
+				that.dispatchEvent("numpadopen");
 				hideNumPadIcon.clone().scaleTo(numPadKey, 60, 60).centerReg(numPadKey,2);
 			}
 			currentKeyboard.updateCache();
@@ -50399,9 +50421,8 @@ RETURNS obj for chaining
 			if (!redoChache) obj.updateCache();
 			else obj.cache();
 		}
-		if (obj.alphaMask) {
-			zog(obj.alphaMask.type)
-			obj.alphaMask.updateCache();
+		if (obj.effects && obj.effects.alpha && obj.effects.alpha.alphaMask.updateCache) {			
+			obj.effects.alpha.alphaMask.updateCache();
 		}
 		return obj;
 	};//-33.163
@@ -57323,19 +57344,18 @@ There are settings that can adjust when the Ticker updates so see Usage notes be
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
 
 EXAMPLE
-const circle = new Circle(50, red);
-circle.center();
+const circle = new Circle(50, red).center();
 Ticker.add(()=>{
 	circle.x++;
-}, stage); // stage is optional - will be the first stage made if left out
+}); // can also pass in a specific stage
 
 // to be able to remove the function:
-Ticker.add(tryMe, stage);
+Ticker.add(tryMe);
 function tryMe() {circle.x++;}
 Ticker.remove(tryMe);
 
 // OR with function literal, use the return value
-var tickerFunction = Ticker.add(()=>{circle.x++;}, stage);
+var tickerFunction = Ticker.add(()=>{circle.x++;});
 Ticker.remove(tickerFunction);
 
 // Check to see if a function is in the Ticker for that stage:
@@ -57349,6 +57369,7 @@ however, OPTIMIZE can be overridden as follows (or with the always() method):
 METHODS (static)
 ** As of ZIM 5.1.0, stage is optional and will default to the stage of first Frame object made
 ** WARNING - if you are in a second Frame you should pass stage as a parameter so it does not point to the first Frame's stage
+** NOTE - if no stage is provided, the Ticker will update the stage of the zdf - ZIM default frame (usually the first Frame made)
 Ticker.always(stage) - overrides OPTIMIZE and always runs an update for the stage even with no function in queue
 Ticker.alwaysOff(stage) - stops an always Ticker for a stage
 Ticker.add(function, stage) - adds the function to the Ticker queue for a given stage and returns the function that was added
@@ -57726,7 +57747,7 @@ const pages = new Pages({
 }).addTo();
 
 // handle any events inserted into the swipe arrays
-pages.on("info", function(){zog("info requested")});
+pages.on("info", ()=>{zog("info requested")});
 
 // handle any custom requirements when arriving at a page
 // the event gives you the page object
@@ -57734,13 +57755,13 @@ pages.on("info", function(){zog("info requested")});
 home.name = "home";
 hide.name = "hide";
 find.name = "find";
-pages.on("page", function() {
+pages.on("page", ()=>{
 	zog(pages.page.name); // now we know which page we are on
 })
 
 // you can manually go to pages as well
 // we will make a little triangle to click:
-var back = new Triangle({color:red});
+const back = new Triangle({color:red});
 back.center(find); // add triangle to find page
 // not really supposed to add things to zim shapes
 // they default to mouseChildren false
@@ -57748,8 +57769,7 @@ back.center(find); // add triangle to find page
 // so we have to set the mouseChildren of find to true
 find.mouseChildren = true;
 back.cur();
-back.on("click", function() {pages.go(home, UP)});
-S.update();
+back.on("click", ()=>{pages.go(home, UP)});
 END EXAMPLE
 
 PARAMETERS
@@ -58689,6 +58709,125 @@ Additional "mousedown", "click" or other button events can be added if desired
 	zim.extend(zim.Arrow, zim.Button, "clone", "zimButton", false);
 	//-71.2
 		
+
+/*--
+zim.HotSpot = function(obj, x, y, width, height, call, callOver, callOut, local, talk)
+
+HotSpot
+zim class - extends a zim.Container which extends a createjs.Container
+
+DESCRIPTION
+HotSpot adds an invisible button to a container object (often think of this as the page).
+If you want multiple spots it is more efficient to use the HotSpots class above
+which manages multiple HotSpot objects (otherwise you end up with multiple event functions).
+The spot is a pixel rect with an alpha of .01 and then uses a hitArea of a backing shape.
+The spot will get a cursor of "pointer".
+
+NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
+
+EXAMPLE
+const hs = new HotSpot(S, 100, 100, 50, 50, myFunction);
+function myFunction() {
+	zog("activation!");
+}
+// hs.show(); // uncomment this to see rectangle hotSpot
+END EXAMPLE
+
+PARAMETERS supports DUO - parameters or single object with properties below
+holder - container object in which to place the hotspot (stage for instance)
+x, y, width and height - of the rectangle for the hotspot
+call - the function to call when the spot is pressed
+local - (default true) hotSpot rect is based on local coordinates of the container
+	use when the element scale independently from the stage
+	if set to false then you pass in global coordinates and hotSpot will convert them
+talk - (default "hotspot") text for ZIM Accessibility screen reader
+
+METHODS
+show() - helps when creating the spot to see where it is
+hide() - hides the hotspot
+dispose() - removes the listener and the spot
+
+PROPERTIES
+type - holds the class name as a String
+spot - the actual hotSpot object that gets added to the container can be accessed with the spot property
+eg. hs.spot
+
+ACTIONEVENT
+This component is affected by the general ACTIONEVENT setting
+The default is "mousedown" - if set to something else the component will act on click (press)
+--*///+73
+zim.HotSpot = function(obj, x, y, width, height, call, callOver, callOut, local, talk) {
+	var sig = "obj, x, y, width, height, call, callOver, callOut, local, talk";
+	var duo; if (duo = zob(zim.HotSpot, arguments, sig, this)) return duo;
+	z_d("73");
+	this.zimContainer_constructor(null,null,null,null,false);
+	this.type = "HotSpot";
+
+	if (zot(obj) || !obj.addChild) {zogy("zim controls - HotSpot():\nPlease pass in container object for obj"); return;}
+	if (obj instanceof createjs.Container == false) {zogy("zim controls - HotSpot():\nObjects passed in should be Containers"); return;}
+	if (zot(x) || zot(y) || zot(width) || zot(height)) {zogy("zim controls - HotSpot():\nPlease pass in x, y, width, height"); return;}
+	if (zot(local)) local = true;
+	var eventType = (!zns?WW.ACTIONEVENT=="mousedown":zim.ACTIONEVENT=="mousedown")?"mousedown":"click";
+
+	var w = width; var h = height;
+	var point,newW,newH;
+	if (!local) {
+		point = obj.globalToLocal(x,y);
+		var point2 = obj.globalToLocal(x+w,y+h);
+		newW = point2.x-point.x;
+		newH = point2.y-point.y;
+	} else {
+		point = new zim.Point(x,y);
+		newW = width;
+		newH = height;
+	}
+	var but = new zim.Shape(width, height);
+	but.talk = zot(talk)?"HotSpot":talk;
+	but.alpha = 0;
+	but.graphics.f("black").dr(0,0,newW,newH);
+	but.x = point.x;
+	but.y = point.y;
+	but.cur("pointer");
+	but.expand(0);
+	this.spot = but;
+
+	if (typeof(call) == "function") {
+		var butEvent = but.on(eventType,function(e) {
+			call(e);
+		});
+	}
+	if (typeof(callOver) == "function") {
+		var butOverEvent = but.on("mouseover",function(e) {
+			callOver(e);
+		});
+	}
+	if (typeof(callOut) == "function") {
+		var butOutEvent = but.on("mouseout",function(e) {
+			callOut(e);
+		});
+	}
+	obj.addChild(but);
+
+	this.show = function() {
+		but.alpha = .5;
+		if (obj.stage) obj.stage.update();
+	};
+	this.hide = function() {
+		but.alpha = 0;
+		if (obj.stage) obj.stage.update();
+	};
+	this.dispose = function() {
+		if (butEvent) but.off(eventType, butOverEvent);
+		if (butOverEvent) but.off("mouseover", butOverEvent);
+		if (butOutEvent) but.off("mouseout", butOutEvent);
+		obj.removeChild(but);
+		but = null;
+		return true;
+	};
+};
+zim.extend(zim.HotSpot, zim.Container, "dispose", "zimContainer", false);
+//-73
+
 /*--
 zim.HotSpots = function(spots, local, mouseDowns)
 
@@ -58705,25 +58844,20 @@ NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set
 
 EXAMPLE
 // our first hotSpot will be a 50 pixel square at 100, 100
-// then we will add hotSpots to these items as well
-var circle = new Circle(60, red);
-circle.center();
 
-const button = new Button();
-S.addChild(button);
-button.x = W - button.width - 100;
-button.y = H - button.height - 100;
+// then we will add hotSpots to these items as well
+const circle = new Circle(60, red).center();
+const button = new Button().pos(100,100,RIGHT,BOTTOM);
 
 // make the hotSpots object
 // these are all on the same page
 // gets really handy when you have multiple pages with Pages
 const hs = new HotSpots([
-	{page:stage, rect:[100,100,50,50], call:()=>{zog("hot!");}},
-	{page:stage, rect:circle, call:()=>{zog("circle!");}},
-	{page:stage, rect:button, call:()=>{zog("button!");}},
+	{page:S, rect:[100,100,50,50], call:()=>{zog("hot!");}},
+	{page:S, rect:circle, call:()=>{zog("circle!");}},
+	{page:S, rect:button, call:()=>{zog("button!");}},
 ]);
 // hs.show(); // uncomment this to see rectangle hotSpots
-S.update();
 END EXAMPLE
 
 PARAMETERS supports DUO - parameters or single object with properties below
@@ -58901,125 +59035,6 @@ the class creates HotSpot objects - see the class underneath this one
 	//-72
 
 
-/*--
-zim.HotSpot = function(obj, x, y, width, height, call, callOver, callOut, local, talk)
-
-HotSpot
-zim class - extends a zim.Container which extends a createjs.Container
-
-DESCRIPTION
-HotSpot adds an invisible button to a container object (often think of this as the page).
-If you want multiple spots it is more efficient to use the HotSpots class above
-which manages multiple HotSpot objects (otherwise you end up with multiple event functions).
-The spot is a pixel rect with an alpha of .01 and then uses a hitArea of a backing shape.
-The spot will get a cursor of "pointer".
-
-NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
-
-EXAMPLE
-const hs = new HotSpot(stage, 100, 100, 50, 50, myFunction);
-function myFunction() {
-	zog("activation!");
-}
-// hs.show(); // uncomment this to see rectangle hotSpot
-S.update();
-END EXAMPLE
-
-PARAMETERS supports DUO - parameters or single object with properties below
-holder - container object in which to place the hotspot (stage for instance)
-x, y, width and height - of the rectangle for the hotspot
-call - the function to call when the spot is pressed
-local - (default true) hotSpot rect is based on local coordinates of the container
-	use when the element scale independently from the stage
-	if set to false then you pass in global coordinates and hotSpot will convert them
-talk - (default "hotspot") text for ZIM Accessibility screen reader
-
-METHODS
-show() - helps when creating the spot to see where it is
-hide() - hides the hotspot
-dispose() - removes the listener and the spot
-
-PROPERTIES
-type - holds the class name as a String
-spot - the actual hotSpot object that gets added to the container can be accessed with the spot property
-eg. hs.spot
-
-ACTIONEVENT
-This component is affected by the general ACTIONEVENT setting
-The default is "mousedown" - if set to something else the component will act on click (press)
---*///+73
-	zim.HotSpot = function(obj, x, y, width, height, call, callOver, callOut, local, talk) {
-		var sig = "obj, x, y, width, height, call, callOver, callOut, local, talk";
-		var duo; if (duo = zob(zim.HotSpot, arguments, sig, this)) return duo;
-		z_d("73");
-		this.zimContainer_constructor(null,null,null,null,false);
-		this.type = "HotSpot";
-
-		if (zot(obj) || !obj.addChild) {zogy("zim controls - HotSpot():\nPlease pass in container object for obj"); return;}
-		if (obj instanceof createjs.Container == false) {zogy("zim controls - HotSpot():\nObjects passed in should be Containers"); return;}
-		if (zot(x) || zot(y) || zot(width) || zot(height)) {zogy("zim controls - HotSpot():\nPlease pass in x, y, width, height"); return;}
-		if (zot(local)) local = true;
-		var eventType = (!zns?WW.ACTIONEVENT=="mousedown":zim.ACTIONEVENT=="mousedown")?"mousedown":"click";
-
-		var w = width; var h = height;
-		var point,newW,newH;
-		if (!local) {
-			point = obj.globalToLocal(x,y);
-			var point2 = obj.globalToLocal(x+w,y+h);
-			newW = point2.x-point.x;
-			newH = point2.y-point.y;
-		} else {
-			point = new zim.Point(x,y);
-			newW = width;
-			newH = height;
-		}
-		var but = new zim.Shape(width, height);
-		but.talk = zot(talk)?"HotSpot":talk;
-		but.alpha = 0;
-		but.graphics.f("black").dr(0,0,newW,newH);
-		but.x = point.x;
-		but.y = point.y;
-		but.cur("pointer");
-		but.expand(0);
-		this.spot = but;
-
-		if (typeof(call) == "function") {
-			var butEvent = but.on(eventType,function(e) {
-				call(e);
-			});
-		}
-		if (typeof(callOver) == "function") {
-			var butOverEvent = but.on("mouseover",function(e) {
-				callOver(e);
-			});
-		}
-		if (typeof(callOut) == "function") {
-			var butOutEvent = but.on("mouseout",function(e) {
-				callOut(e);
-			});
-		}
-		obj.addChild(but);
-
-		this.show = function() {
-			but.alpha = .5;
-			if (obj.stage) obj.stage.update();
-		};
-		this.hide = function() {
-			but.alpha = 0;
-			if (obj.stage) obj.stage.update();
-		};
-		this.dispose = function() {
-			if (butEvent) but.off(eventType, butOverEvent);
-			if (butOverEvent) but.off("mouseover", butOverEvent);
-			if (butOutEvent) but.off("mouseout", butOutEvent);
-			obj.removeChild(but);
-			but = null;
-			return true;
-		};
-	};
-	zim.extend(zim.HotSpot, zim.Container, "dispose", "zimContainer", false);
-	//-73
-
 /*--
 zim.Guide = function(obj, vertical, pixels, hideKey, pixelKey, style, group, inherit)
 
@@ -61616,7 +61631,7 @@ note: the item is not the event object target - as that is the tile
 		if (style!==false) zim.styleTransforms(this, DS); // global function - would have put on DisplayObject if had access to it
 
 		this.clone = function(exact) {
-			if (unique) exact = true; // added ZIM 016
+			if (zot(exact) && unique) exact = true; // added ZIM 016
 			if (exact) {
 				var exactItems = [];
 				if (backgroundColor) var exactBackgroundColors = [];
@@ -69758,11 +69773,24 @@ join(obj1, obj2, point1, point2, minAngle, maxAngle, type) - creates and returns
 break(joint) - break a joint created with join()
 	to use, store the result of the join() method in a variable and pass that variable in to break()
 attach(control, obj) attach a physics object (obj) to a ZIM object (control) to like a mousejoint to the ZIM object not the mouse 
-    the control can then be animated, wiggled, dragged and the physics object will follow it
-    returns an id to be able to unattach
-        const id = physics.attach(triangle, circle);
-        timeout(2, ()=>{physics.unattach(id)});
+	the control can then be animated, wiggled, dragged and the physics object will follow it
+	returns an id to be able to unattach
+		const id = physics.attach(triangle, circle);
+		timeout(2, ()=>{physics.unattach(id)});
 unattach(id) unattach a physics object from the ZIM object based on the stored id from attach();
+buoyancy(height, denisity, linear, angular) returns a Box2D buoyancy controller.  Then need to add() or remove() objects 
+	height - (default H/2) is pixels from bottom of the stage 
+	density - (default 3) density of fluid - the higher the more an object floats
+	linear - (default 4) linear damping to reduce movement
+	angular - (default 4) angular damping to reduce rotation
+		the buoyancy controller will have the following methods:
+		add(obj) - add object with physics or an array of objects with physics to buoyancy controller
+			returns buoyancy object for chaining
+		remove(obj) - remove object or an array of objects from buoyancy controller
+			returns buoyancy object for chaining
+		clear() - remove all objects from buoyancy controller
+			returns buoyancy object for chaining
+		dispose() - deletes buoyancy controller
 debug() - activates the debugging - returns object for chaining
 updateDebug() - updates the debug canvas if the frame has been scaled (put in frame resize event)
 removeDebug() - removes the debug canvas - you can add it again later (or toggle, etc.)
@@ -69918,12 +69946,15 @@ dynamic - set to true for dynamic and false for static
 speed - get or set the speed of an object that is controlled by control()
 speedY - get or set the speedY of an object that is controlled by control()
 ** normal x, y, rotation or pos(), loc(), rot() will not work with physics!
-** see the BODY PROPERTIES below for x, y and rotation
+** see the BODY loc(x,y) METHOD and the rotation PROPERTY below
 ** these should really not be set at all in the physics world
 ** but rather let the forces, etc. work them out
 ** it is best to set traditional properties before calling physics()
 
 METHODS - FOR BODY (a physics engine body)
+loc(x,y) - generally, we should not manually adjust x and y but rather use forces
+	but for resetting things, etc. use zimObj.body.loc(x, y)
+	Do not use zimObj.loc() or zimObj.x or zimObj.y - these will only work BEFORE adding physics.
 ** the ZIM DisplayObject body property provides access to the following Box2D methods (note, all start with uppercase):
 ** commonly used methods are handled through ZIM wrapper methods on the DisplayObject
 ** see https://www.box2dflash.org/docs/2.1a/reference/ for very basic docs
@@ -69942,9 +69973,11 @@ PROPERTIES - FOR BODY (a physics engine body)
 zimObj - the ZIM Object that the body is mapped to
 ** traditional properties should be set before calling phyics()
 ** but the following properties are provided
-x - the x position of the body - setting this will also position of the ZIM DisplayObject
-y - the y position of the body - setting this will also position of the ZIM DisplayObject
+x - deprecated - please use the BODY's loc(x, y) method - note: zimObj.body.loc() is not the same as the zimObj.loc() method
+y - deprecated - please use the BODY's loc(x, y) method - note: zimObj.body.loc() is not the same as the zimObj.loc() method
 rotation - the rotation of the body (degrees) - setting this will also rotate the ZIM DisplayObject
+	Also see obj.body.SetFixedRotation() to stop the physics body from rotating https://zimjs.com/zapp/print/Z_C6SBW
+	And the counter rotation technique here: https://zimjs.com/data/
 
 GLOBAL VARIABLES
 ** Making a new Physics() or using physics() on a ZIM DisplayObject
@@ -79092,7 +79125,7 @@ the result of the play() or tone() method will dispatch a "complete" event when
 				}, (releaseTime+1)*1000);
 			};
 			// if (duration) this.stop(startTime+duration-.1);
-			if (duration) setTimeout(function () {
+			if (duration) setTimeout(function () { // reverted back to this in ZIM 015
 				that2.stop();
 			}, (duration-.1) * 1000);
 
@@ -84497,7 +84530,9 @@ dispatches "start", "end" and "error" on the utterance object returned by talk()
 			
 			var SpeechRecognition = SpeechRecognition || webkitSpeechRecognition;
 			var SpeechGrammarList = SpeechGrammarList || window.webkitSpeechGrammarList;
-			var SpeechRecognitionEvent = SpeechRecognitionEvent || webkitSpeechRecognitionEvent;    
+			// this is causing an error on firefox even though they use this in their examples 
+			// and we have all the speec about:config setting set to true
+			// var SpeechRecognitionEvent = SpeechRecognitionEvent || webkitSpeechRecognitionEvent;    
 			var recognition = this.recognition = new SpeechRecognition();
 			recognition.continuous = false;
 			recognition.lang = this.language = "en-US";
@@ -90872,8 +90907,8 @@ export let outline = zim.outline;
 export let blendmodes = zim.blendmodes;
 export let Pages = zim.Pages;
 export let Arrow = zim.Arrow;
-export let HotSpots = zim.HotSpots;
 export let HotSpot = zim.HotSpot;
+export let HotSpots = zim.HotSpots;
 export let Guide = zim.Guide;
 export let Grid = zim.Grid;
 export let Wrapper = zim.Wrapper;
@@ -90948,4 +90983,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;

package/ts-src/typings/zim/index.d.ts

@@ -3616,8 +3616,12 @@ declare namespace zim {
 		borders(boundary?: Boundary | {}): void
 		drag(array?: [any]): void
 		noDrag(): void
+        pause(type?:boolean): void;
 		join(obj1: DisplayObject, obj2: DisplayObject, point1?: Point | {}, point2?: Point | {}, minAngle?: number, maxAngle?: number, type?: string): any
 		break(joint: any): void
+        attach(control:DisplayObject, obj:DisplayObject):string
+        unattach(id:string):void
+        buoyancy(height?:number, denisity?:number, linear?:number, angular?:number):any
 		debug(): void
 		updateDebug(): void
 		removeDebug(): void