zimjs 19.0.9 → 19.1.1

package/package.json

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

package/src/zim.js

@@ -75,7 +75,6 @@ var z_i; // iterator i in global namespace
 ////////////////  ZIM WRAP  //////////////
 // Zim Wrap creates global wrapper functions for less typing
 
-
 /*--
 zog(item1, item2, etc.)         ~ log
 
@@ -12155,7 +12154,6 @@ group - (default null) set to String (or comma delimited String) so STYLE can se
 inherit - (default null) used internally but can receive an {} of styles directly
 
 METHODS
-run(time, label, call, params, wait, waitedCall, waitedParams, loop, loopCount, loopWait, loopCall, loopParams, loopWaitCall, loopWaitParams, loopPick, rewind, rewindWait, rewindCall, rewindParams, rewindWaitCall, rewindWaitParams, rewindTime, rewindEase, startFrame, endFrame, frame, tweek, id, globalControl)
 	The run() method animates the Sprite over an amount of time
 	Would recommend this method over the CreateJS play() and gotoAndPlay()
 	methods because the framerate for these get overwritten by other S.update() calls
@@ -14944,11 +14942,12 @@ EXAMPLE
 new Frame(FILL, 1024, 768, clear, clear, ready);
 function ready() {
 	const fragment = `
+		out vec4 fragColor;
 		void main() {
 			vec2 uv = gl_FragCoord.xy / iResolution.xy;
 			vec3 color = 0.5 + 0.5 * cos(iTime + uv.xyx + vec3(0,2,4));
-			gl_FragColor = vec4(vec3(color), 1.0);
-		} 
+			fragColor = vec4(vec3(color), 1.0);
+		}
 	`;    
 	const shader = new zim.ShaderOverlay(W, H, fragment).center();
 	shader.tag.style.zIndex = -50; // put shader beneath stage
@@ -24686,7 +24685,8 @@ zim.LabelOnArc = function(label, size, font, color, radius, flip, spacing, lette
 			var rev = label.text.split("").reverse().join("");
 			label.text = rev;
 		}
-		letters = that.letters = new zim.Container(that.width, that.height).centerReg(that);
+		zog(that.width, that.height)
+		letters = that.letters = new zim.Container(100,100).center(that);
 
 		that.numLetters = label.text.length;
 		that.letterHeight = label.height;
@@ -24756,7 +24756,8 @@ zim.LabelOnArc = function(label, size, font, color, radius, flip, spacing, lette
 			var letter = letters.getChildAt(i);
 			// var amount = angles[i];
 			lastAngle = letter.rotation = lastAngle + angles[i];
-		}		
+		}	
+		letters.setBounds(null);	
 	}
 
 	this.setProps = function(props) {
@@ -24799,6 +24800,9 @@ zim.LabelOnArc = function(label, size, font, color, radius, flip, spacing, lette
 		}
 	});
 
+	// TODO - in ZIM 020 - add this line
+	// that.setBounds(null);
+
 	if (style!==false) zim.styleTransforms(this, DS);
     this.clone = function() {
         return that.cloneProps(new zim.LabelOnArc(label, size, font, color, radius, flip, spacing, letterSpacing, angles, showCircle, arcColor, arcBorderColor, arcBorderWidth, radiusSpread, rtl, style, this.group, inherit));
@@ -29216,10 +29220,9 @@ content - gives access to the content provided as a parameter to the Panel()
 		buttons - an array of the Button objects if provided
 		config - the original content config object {}
 panelHeight - get and set the height of the panel without scaling it as height does (for width, remake the Panel object)
-titleBar - access to the titleBar container
+titleBar - access to the titleBar container - which also has a backing property
 titleBarlabel - access to the label of the current panel
 text - access to the text of the current panel
-titleBar - gives access to the titleBar Container - which also has a background property
 titleBarLabel - gives access to the titleBar label
 closeIcon - access to the close button
 collapseIcon - access to the ZIM Shape if there is a collapse triangle
@@ -34109,9 +34112,11 @@ dropHeight - (default null) set a height when dropped - overrides scale
 *** Drop parameters that work only when dropping on a dropTarget that is NOT a List
 dropHitTest - (default "bounds") can also be "reg", "circles", "circle", "rect" - see ZIM HitTests
 dropFull - (default true) do not drop on a full target
- 		note - if the object is removed from the target then a drop can occur again on that target 
+ 	note - if the object is removed from the target then a drop can occur again on that target 
+	also see the dropFull property on a target 
 dropSnap - (default true) snap to the target object
 dropEnd - (default true) once dropped on a target a noMouse() is set on the object
+	dropEnd should not be false if dropBack is true - when dropping from a list
 *** End drop parameters that work only when dropping on a target that is NOT a List
 selectedIndex - same as index, kept in for backwards compatibility in ZIM DUO
 style - (default true) set to false to ignore styles set with the STYLE - will receive original parameter defaults
@@ -34254,8 +34259,8 @@ enabled - default is true - set to false to disable
 DROP ITEM PROPERTIES
 dropTarget - is the target dropped on 
 dropList - is list item came from 
-
-// dropEnd should not be false if dropBack is true - when dropping from a list
+dropFull - the target that is dropped on gets a dropFull property 
+	set this to false if programatically removing a dropped object such as for a garbage can
 
 ALSO: see all Window properties - like titleBar, titleBarLabel, resizeHandle, etc.
 
@@ -35183,6 +35188,21 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 										ghost.dropStartY = downItem.dropStartY;
 										ghost.dropStartS = downItem.dropStartS;		
 
+										// ZIM 019 patch
+										// pass through original x,y,scale for objects
+										// that had them and were added to the list
+										if (downItem.dropOriginalX != null) {
+											ghost.dropOriginalX = downItem.dropOriginalX;
+											ghost.dropOriginalY = downItem.dropOriginalY;
+											ghost.dropOriginalS = downItem.dropOriginalS;	
+											ghost.dropStartX = ghost.x;
+											ghost.dropStartY = ghost.y;
+											ghost.dropStartS = ghost.scale;											
+										} else {
+											// flag drag() to not add dropOriginalX, etc.
+											ghost.dropOriginalList = true;	
+										}											
+
 										that.dropItem = ghost;
 										that.dropTarget = target;
 										ghost = null;
@@ -35198,7 +35218,7 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 								target.dropReticle.removeFrom();						
 								if (!dropCopy) that.removeAt(1,itemIndex);
 		
-								if (itemIndex < target.dropReticleIndex && that == target) target.dropReticleIndex--;
+								if (itemIndex < target.dropReticleIndex && that == target && !dropCopy) target.dropReticleIndex--;
 																
 								if (dropCopy) {
 									target.addAt(ghost, target.dropReticleIndex);
@@ -37016,6 +37036,7 @@ barLength - (default 300) the length of the bar (the slider slides along its len
 barWidth - (default 3) the width of the bar (how fat the bar is)
 barColor - (default granite) the color of the bar (any CSS color)
 vertical - (default false) set to true to make slider vertical
+	vertical will have a default value of max
 useTicks - (default false) set to true to show small ticks for each step (step > 0)
 tickColor - (default barColor) set the tick color if ticks are set
 tickStep - (default step - or 1 if no step and useTicks is true) set to adjust tick amount
@@ -37043,7 +37064,7 @@ keyArrowsV - (default true) use up and down arrows when keyArrows is true
 damp - (default null) set to value such as .1 to damp the slider value
 	use with Ticker rather than "change" event - eg:
 	Ticker.add(()=>{circle.x = slider.value;});
-value - |ZIM VEE| (default min) a starting value for the slider
+value - |ZIM VEE| (default min for horizontal or max for vertical) a starting value for the slider
 expand - (default null or 10 for mobile) set to value to expand the interactive area of the slider button
 expandVertical - (default expand) set to value to expand the vertical interactive area of the slider button
 expandBar - (default 20 or 0 for horizontal) set to value to expand the interactive area of the slider bar
@@ -37210,7 +37231,7 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 				.sca(0,1).rot(vertical?-90:0).mov(vertical?-accentOffset-accentSize-barWidth/2:0, vertical?barLength:accentOffset+barWidth/2)
 				.addTo(this);			
 		}
-		function drawAccent() {
+		function drawAccent() {			
 			accent.sca((that.value-that.min)/Math.abs(that.max-that.min), 1);
 		}
 
@@ -37331,7 +37352,7 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 			}
 		}
 
-		var myValue = min;
+		var myValue = vertical?max:min; // ZIM 019 patch
 		var lastValue = 0; // does not include min so always starts at 0
 		this.button = button;
 		this.cur("pointer");
@@ -37678,6 +37699,7 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 
 
 		if (!zot(value)) that.value = value;
+		if (accent) drawAccent();
 		
 		zim.setSwipe(this, false);
 
@@ -48722,7 +48744,7 @@ addChild(), removeChild(), addChildAt(), getChildAt(), contains(), removeAllChil
 PROPERTIES
 type - holds the class name as a String
 index - get or set the index of the item
-selectedItem - the item at the front
+currentItem - the item at the front
 	each item has a content property if the item was added to a container by the carousel (only if item was not a container)
 	each item has a fader property which is a ZIM Rectangle - if the fade was not false or 0
 items - the array of items 
@@ -49224,7 +49246,7 @@ resize() - call the resize event if the scale or position of the Loader is chang
 	Note: if the Frame itself changes location in the HTML document, call a F.update()
 	this will then dispatch an update event to the Loader and it will resize()
 	this is not needed if resizing the window or scrolling - see Frame update() method docs
-save(content, filename, x, y, width, height, cached, cachedBounds, type, data, quality) - save a picture or text (supports ZIM DUO)
+save(content, filename, x, y, width, height, cached, cachedBounds, type, data, quality, remakeCache) - save a picture or text (supports ZIM DUO)
 	content - the Display object to be saved such as a Container, Bitmap, etc. 
 		or text (or Label, TextInput, TextArea) or JSON or object for JSON
 		if text or json, then x, y, width, height, cached, cachedBounds, data, and quality are ignored
@@ -49239,6 +49261,11 @@ save(content, filename, x, y, width, height, cached, cachedBounds, type, data, q
 		otherwise save returns the object for chaining
 	quality - (default .92) a number between 0 an 1 representing the quality of the saved image (jpeg)
 		note, this parameter may be moved to before data in the next version of ZIM 
+	remakeCache - (default true) set to false if cached and do not want to recache due to using updateCache with blendmode
+		BUT - probably want a backing color for blit art
+		so recommend making a new Page(W,H,black) then add the art container to the backing and save the backing 
+		then add the art container back to the stage 
+		then do not set the remakeCache so it stays true and caches the page 
 
 Button methods:
 setBacking(type, newBacking) - dynamically set any type of backing for button (if null removes backing for that type)
@@ -49569,11 +49596,12 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 			uploadTag.addEventListener("drop", uploadEvent);
 		}
 
-		this.save = function(content, filename, x, y, width, height, cached, cachedBounds, type, data, quality) {
+		this.save = function(content, filename, x, y, width, height, cached, cachedBounds, type, data, quality, remakeCache) {
 		
-			var sig = "content, filename, x, y, width, height, cached, cachedBounds, type, data, quality";
+			var sig = "content, filename, x, y, width, height, cached, cachedBounds, type, data, quality, remakeCache";
 			var duo; if (duo = zob(that.save, arguments, sig)) return duo;
 			if (zot(content)) content = frame.stage;			
+			if (zot(remakeCache)) remakeCache = true;			
 
 			if (type=="text") type = "txt";
 			if (zot(type)) type = "png";
@@ -49615,15 +49643,16 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 			if (zot(height)) height = (content.getBounds && content.getBounds()) ? content.getBounds().height : frame.height;
             var cacheO = content.cacheCanvas;
 
-			content.cache(x, y, width, height);
-
+			if (remakeCache) content.cache(x, y, width, height);
 
 			if (data) {
 				var image = content.cacheCanvas.toDataURL('image/' + type, quality);
-				if (cached) {
-					if (cachedBounds) content.cache(cachedBounds.x, cachedBounds.y, cachedBounds.width, cachedBounds.height);
-				} else {
-					content.uncache();
+				if (remakeCache) {
+					if (cached) {
+						if (cachedBounds) content.cache(cachedBounds.x, cachedBounds.y, cachedBounds.width, cachedBounds.height);
+					} else {
+						content.uncache();
+					}
 				}
 				return image;
 			}
@@ -49674,10 +49703,12 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 				// win.document.close();
 
 			// }
-			if (cached || cacheO) {
-				if (cachedBounds) content.cache(cachedBounds.x, cachedBounds.y, cachedBounds.width, cachedBounds.height);
-			} else {
-				content.uncache();
+			if (remakeCache) {
+				if (cached || cacheO) {
+					if (cachedBounds) content.cache(cachedBounds.x, cachedBounds.y, cachedBounds.width, cachedBounds.height);
+				} else {
+					content.uncache();
+				}
 			}
 
 			return that;
@@ -53082,7 +53113,7 @@ RETURNS obj for chaining
 	};//-47.95
 
 /*--
-obj.drag = function(boundary, axis, overCursor, dragCursor, all, swipe, localBoundary, onTop, surround, slide, slideFactor, slideSnap, slideSnapDamp, reg, removeTweens, startBounds, rect, currentTarget, offStage, immediateBoundary, singleTouch, dropTargets, dropCopy, dropSnap, dropBack, dropEnd, dropFull, dropHitTest, dropScale, dropWidth, dropHeight)
+obj.drag = function(boundary, axis, overCursor, dragCursor, all, swipe, localBoundary, onTop, surround, slide, slideFactor, slideSnap, slideSnapDamp, reg, removeTweens, startBounds, rect, currentTarget, offStage, immediateBoundary, singleTouch, dropTargets, dropCopy, dropSnap, dropBack, dropEnd, dropFull, dropHitTest, dropScale, dropWidth, dropHeight, dropOriginal, style, group)
 
 drag
 zim DisplayObject method
@@ -53228,18 +53259,25 @@ singleTouch - (default false) set to true to let only one touch operate the drag
 dropTargets - an object or an array of objects that can receive a drop
 	this can be a List or a Container or a single object	
 	if it is a list see the dropListProps as well to set reticle properties and scroll speed
+	recommend reg(CENTER) on objects and targets
+	then use dropHitTest:"reg"
 dropCopy - (default false) make a copy of the object as it is being dragged
 dropSnap - (default true) snap to the target object
-dropBack - (default true) go back to start if not dropped on a target
+dropBack - (default true) go back to last position if not dropped on a target
+	or back to start if not dropped on a target and the dropOriginal is true
 dropEnd - (default true) once dropped on a target a noMouse() is set on the object
 dropFull - (default true) do not drop on a full target
 	note - if the object is removed from the target then a drop can occur again on that target 
 dropHitTest - (default "bounds") can also be "reg", "circles", "circle", "rect" - see ZIM HitTests
 dropScale - set a scale for the dropped object
+	if the object does not get dropped on a target, it will go back to its starting scale
+	but not necessarily its starting position unless dropBack is set
 dropWidth - set a width for the dropped object - overrides scale
 	height will keep aspect ratio unless dropHeight is provided
 dropHeight - set a height for the dropped object - overrides scale
 	width will keep aspect ratio unless dropWidth is provided 
+dropOriginal - if dropBack is true, will go to original location and scale if obj is not dropped on a target
+	if dropped on a full target and dropFull is true then will go back to last position 
 style - (default true) set to false to ignore styles set with the STYLE - will receive original parameter defaults
 group - (default null) set to String (or comma delimited String) so STYLE can set default styles to the group(s) (like a CSS class)
 
@@ -53252,6 +53290,8 @@ adds a dragPaused property to get or set the pause of the drag - which allows se
 *** if dropTargets is set then drag() adds the following properties to the dragged object:
 dropTarget - on pressup, what target the object is dropped on (or null)
 dropList - which List if any a dropped object has
+dropFull - the target that is dropped on gets a dropFull property 
+	set this to false if programatically removing a dropped object such as for a garbage can
 dropListProps - to be used if planning on dropping object into a List 
 	The dropListProps have the following default values 
 	{
@@ -53269,8 +53309,8 @@ Adds a "slidestop" event to the drag object that is dispatched when the object c
 
 RETURNS obj for chaining
 --*///+31
-	zim.drag = function(obj, boundary, axis, overCursor, dragCursor, all, swipe, localBoundary, onTop, surround, slide, slideFactor, slideSnap, slideSnapDamp, reg, removeTweens, startBounds, rect, currentTarget, offStage, immediateBoundary, singleTouch, dropTargets, dropCopy, dropSnap, dropBack, dropEnd, dropFull, dropHitTest, dropScale, dropWidth, dropHeight, style, group) {
-		var sig = "obj, boundary, axis, overCursor, dragCursor, all, swipe, localBoundary, onTop, surround, slide, slideFactor, slideSnap, slideSnapDamp, reg, removeTweens, startBounds, rect, currentTarget, offStage, immediateBoundary, singleTouch, dropTargets, dropCopy, dropSnap, dropBack, dropEnd, dropFull, dropHitTest, dropScale, dropWidth, dropHeight, style, group";
+	zim.drag = function(obj, boundary, axis, overCursor, dragCursor, all, swipe, localBoundary, onTop, surround, slide, slideFactor, slideSnap, slideSnapDamp, reg, removeTweens, startBounds, rect, currentTarget, offStage, immediateBoundary, singleTouch, dropTargets, dropCopy, dropSnap, dropBack, dropEnd, dropFull, dropHitTest, dropScale, dropWidth, dropHeight, dropOriginal, style, group) {
+		var sig = "obj, boundary, axis, overCursor, dragCursor, all, swipe, localBoundary, onTop, surround, slide, slideFactor, slideSnap, slideSnapDamp, reg, removeTweens, startBounds, rect, currentTarget, offStage, immediateBoundary, singleTouch, dropTargets, dropCopy, dropSnap, dropBack, dropEnd, dropFull, dropHitTest, dropScale, dropWidth, dropHeight, dropOriginal, style, group";
 		var duo; if (duo = zob(zim.drag, arguments, sig)) return duo;
 		if (obj.type=="AC"&&WW.zdf) {WW.zdf.ac("drag", arguments); return obj;}
 		z_d("31");
@@ -53345,6 +53385,7 @@ RETURNS obj for chaining
 		if (zot(dropScale)) dropScale = DS.dropScale!=null?DS.dropScale:null;
 		if (zot(dropWidth)) dropWidth = DS.dropWidth!=null?DS.dropWidth:null;
 		if (zot(dropHeight)) dropHeight = DS.dropHeight!=null?DS.dropHeight:null;
+		if (zot(dropOriginal)) dropOriginal = DS.dropOriginal!=null?DS.dropOriginal:null; // ZIM 019 patch
 
 		if (dropTargets) {
 			slide = false;
@@ -53603,7 +53644,12 @@ RETURNS obj for chaining
 			}
 
 			// DROP - added ZIM 017 Patch
-			if (zot(dragObject.dropStartS)) {				
+			if (zot(dragObject.dropStartS)) {	
+				if (!dragObject.dropOriginalList) {
+					dragObject.dropOriginalX = dragObject.x;
+					dragObject.dropOriginalY = dragObject.y;				
+					dragObject.dropOriginalS = dragObject.scale;
+				}
 				dragObject.dropStartX = dragObject.x;
 				dragObject.dropStartY = dragObject.y;
 				dragObject.dropStartS = dragObject.scale;
@@ -53612,9 +53658,14 @@ RETURNS obj for chaining
 				if (dragObject.clone) {
 					dragObject.dropCopy = dragObject.clone(true).addTo(dragObject.parent, dragObject.parent.getChildIndex(dragObject));
 					dragObject.dropCopy.dropClone = true;
+					if (!dragObject.dropOriginalList) {
+						dragObject.dropCopy.dropOriginalX = dragObject.dropOriginalX;
+						dragObject.dropCopy.dropOriginalY = dragObject.dropOriginalY;
+						dragObject.dropCopy.dropOriginalS = dragObject.dropOriginalS;
+					}					
 					dragObject.dropCopy.dropStartX = dragObject.dropStartX;
 					dragObject.dropCopy.dropStartY = dragObject.dropStartY;
-					dragObject.dropCopy.dropStartS = dragObject.dropStartS;					
+					dragObject.dropCopy.dropStartS = dragObject.dropStartS;				
 					dragObject.dropCopy.noMouse();
 				}
 			} 
@@ -53851,11 +53902,17 @@ RETURNS obj for chaining
 
 			if (obj.dropTargets) {
 				if (!Array.isArray(obj.dropTargets)) obj.dropTargets = [obj.dropTargets];
-				// watch - could drop from one target to another
-				if (dragObject.droppedTarget) {
-					dragObject.droppedTarget.dropFull = false;
-					dragObject.droppedTarget = null;
-				}
+				// // ZIM 019 patch - removed this and moved dropFull = false 
+				// // to if moved to different place		
+				// // the droppedTarget will be overwritten if succesful
+				// // but if not then we want it to be the same as it was		
+				// if (dragObject.droppedTarget) {
+				// 	dragObject.droppedTarget.dropFull = false;
+				// 	dragObject.droppedTarget = null;
+				// }
+								
+				var wasFull = false; // ZIM 019 patch 
+
 				var miss = zim.loop(obj.dropTargets, function(target) {
 
 					if (target.type == "List") {
@@ -53875,10 +53932,15 @@ RETURNS obj for chaining
 							if (dropWidth || dropHeight) placeObject.siz(dropWidth, dropHeight);
 							if (dropEnd) placeObject.noMouse();
 							else placeObject.mouse();	
+							
+							// added in ZIM 019 patch
+							// set last dropTarget dropFull to false
+							if (placeObject.droppedTarget) placeObject.droppedTarget.dropFull = false;	
+
 							placeObject.droppedTarget = target;		
-							target.addAt(placeObject, target.dropReticleIndex);								
-			
+							target.addAt(placeObject, target.dropReticleIndex);			
 							target.dropItem = dragObject;
+
 							dragObject.droppedTarget = target;
 							dragObject.dropTarget = target;
 							target.dropList = target;
@@ -53890,6 +53952,9 @@ RETURNS obj for chaining
 					}
 
 					if (dragObject["hitTest"+String(dropHitTest).charAt(0).toUpperCase() + String(dropHitTest).slice(1)](target)) {
+						
+						wasFull = target.dropFull; // ZIM 019 patch 
+						
 						if (!dropFull || !target.dropFull) {
 							var placeObject = dragObject;
 							if (dropCopy && dragObject.dropCopy) {
@@ -53902,17 +53967,43 @@ RETURNS obj for chaining
 							if (dropScale) placeObject.sca(dropScale);
 							if (dropWidth || dropHeight) placeObject.siz(dropWidth, dropHeight);
 							if (dropEnd) placeObject.noMouse();
-							else placeObject.mouse();						
+							else placeObject.mouse();	
+
+							// added these in ZIM 019 patch	
+							placeObject.dropStartX = placeObject.x;
+							placeObject.dropStartY = placeObject.y;
+							placeObject.dropStartS = placeObject.scale;	
+							// set last dropTarget dropFull to false
+							if (placeObject.droppedTarget) dragObject.droppedTarget.dropFull = false;	
+							// end ZIM 019 patch
+
 							if (dropFull) target.dropFull = true;	
+							
 							placeObject.droppedTarget = target;													
-							placeObject.dropTarget = target;													
+							placeObject.dropTarget = target;	
+																
 							return false;
 						}
 					} 
 				});
+
+				// dropOriginal 
+				// if set to false then once in a system always snaps back to within system 
+				// if set to true if dropped not on target then goes back to original x,y,scale 
+				// otherwise if full then still snaps back inside system
 				if (miss) {		
-					dragObject.dropTarget = dragObject.droppedTarget = null;		
+					// dragObject.dropTarget = dragObject.droppedTarget = null;	// going back to last spot - removed this in ZIM 019 patch
 					if (dropBack) {
+
+						// ZIM 019 Patch to handle dropOrigin		
+						// dropOriginalList means it came originally from a List and will not have a dropOriginalX, etc.
+						if ((!dropFull || !wasFull) && dropOriginal && !dragObject.dropOriginalList) {
+							dragObject.dropStartX = dragObject.dropOriginalX;
+							dragObject.dropStartY = dragObject.dropOriginalY;
+							dragObject.dropStartS = dragObject.dropOriginalS;
+							if (dragObject.droppedTarget) dragObject.droppedTarget.dropFull = false;
+							dragObject.dropTarget = dragObject.droppedTarget = null;
+						} 
 						dragObject.animate({
 							props:{x:dragObject.dropStartX, y:dragObject.dropStartY, scale:dragObject.dropStartS}, 
 							time:.2, 
@@ -53925,7 +54016,13 @@ RETURNS obj for chaining
 							}
 						});
 					} else {
-						dragObject.sca(dragObject.dropStartS);	
+						
+						// added these in ZIM 019 patch	
+						if (dragObject.droppedTarget) dragObject.droppedTarget.dropFull = false;	
+						dragObject.droppedTarget = null;						
+						// end ZIM 019 patch
+
+						dragObject.sca(dragObject.dropOriginalS);	
 						if (dropCopy && dragObject.dropCopy) {
 							swapProperties("x", dragObject, dragObject.dropCopy);
 							swapProperties("y", dragObject, dragObject.dropCopy);
@@ -58270,10 +58367,11 @@ sequence - (default 0) the delay time in seconds to run on children of a contain
 	Note: for a sequence animate() give the animate() an id and pauseAnimate() or stopAnimate() that id.
 sequenceCall - (default null) the function that will be called for each sequence animation 
 	Note: the value of the sequenceCall parameter will be the object that just ended animation unless there is a sequenceParams value
+	To get the object about to animate use the startCall parameter 
 sequenceParams - (default null) a parameter sent to the sequenceCall function
 sequenceReverse - |ZIM VEE| (default false) set to true to sequence through container or array backwards
 sequenceRatio - (default null) set to a value to adjust the rate based on item ratio property
-    see https://zimjs.com/016/normalize.html
+	see https://zimjs.com/016/normalize.html
 	see Container() ratio property and normalize() method which give a ratio property.
 	This will automatically set sequence to 0 so that each item in the container (or tile) is animated individually
 	the sequenceRate value will be multiplied by the item's ratio and then added to the rate (see rate parameter)
@@ -69706,7 +69804,6 @@ Beads
 zim class - extends a zim.Container which extends a createjs.Container
 
 DESCRIPTION
-
 Beads adds objects around a Squiggle or Blob path.
 Different objects can be specified with ZIM VEE (Pick) values
 to put random or sequenced objects around path.
@@ -71747,6 +71844,7 @@ const camera = three.camera;
 
 const controls = new OrbitControls(camera, three.canvas);
 
+Note: put TextureActives above applying any TextureActive textures to three.js objects
 const textureActives = new TextureActives([panel, backing], THREE, three, renderer, scene, camera, controls, 1, 0, 1500);
 
 // can capture raydown, raymove, rayup, rayover and rayout
@@ -72001,6 +72099,8 @@ XR
 TextureActive will detect if XR (AR/VR) is being used and will use the suitable Raycaster
 Additional classes are provided with the ZIM Three helper library for controllers, movement and teleport 
 
+NOTE: put the TextureActives object before applying any TextureActive textures to three.js objects
+
 NOTE: for XR, a layer must be set so the controllers do not get in the way of interactivity
 so in the TextureActives() set layer:1 and when adding meshes use addMesh(mesh, 1)
 
@@ -72047,6 +72147,7 @@ const camera = three.camera;
 
 const controls = new OrbitControls(camera, three.canvas);
 
+Note: put TextureActives above applying any TextureActive textures to three.js objects
 const textureActives = new TextureActives([panel, backing], THREE, three, renderer, scene, camera, controls, 1, 0, 1500);
 
 // can capture raydown, raymove, rayup, rayover and rayout
@@ -76126,7 +76227,13 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 						pp.y < con.y || pp.y > con.y+con.height
 					) return;
 				}
-				if (type == "mousedown") {					
+				if (type == "mousedown") {	
+
+					// added ZIM 019 patch to not include objects outside container if provided unless in mousedownIncludes
+					if (that.mouseDownIncludes || container) under = stage.getObjectUnderPoint(e.stageX, e.stageY, 1);
+					if (container && under && under!=target && !container.contains(under)) {
+						if (mousedownIncludes && mousedownIncludes.indexOf(under) == -1) return;
+					}			
 					if (!Array.isArray(that.mousedownIncludes)) that.mousedownIncludes = [that.mousedownIncludes];
 					if (that.mousedownIncludes.indexOf(container)<0) {
 						for (i=0; i<container.numChildren; i++) {
@@ -76173,9 +76280,13 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 				if (type == "pressdrag" && !target.hitTestPoint(e.stageX/zim.scaX, e.stageY/zim.scaY)) return;
 				moveCheck = false;
 				if (!Array.isArray(that.mousedownIncludes)) that.mousedownIncludes = [that.mousedownIncludes];
-				var inCheck = false;
-	
-				if (that.mouseDownIncludes) under = stage.getObjectUnderPoint(e.stageX, e.stageY, 1);
+				var inCheck = false;	
+				
+				// added ZIM 019 patch to not include objects outside container if provided unless in mousedownIncludes
+				if (that.mouseDownIncludes || container) under = stage.getObjectUnderPoint(e.stageX, e.stageY, 1);
+				if (container && under && under!=target && !container.contains(under)) {
+					if (mousedownIncludes && mousedownIncludes.indexOf(under) == -1) return;
+				}
 
 				for (i=0; i<that.mousedownIncludes.length; i++) {
 					if (under && that.mousedownIncludes[i].hitTestPoint && that.mousedownIncludes[i].hitTestPoint(e.stageX/zim.scaX, e.stageY/zim.scaY) && that.mousedownIncludes[i].contains(under)) {
@@ -76186,7 +76297,7 @@ dispatches a "moving" event if target is moving and "startmoving" and "stopmovin
 					for (i=0; i<container.numChildren; i++) {
 						var child = container.getChildAt(i);
 						// returning on first container?
-						if (that.mousedownIncludes.indexOf(child)==-1 && child.mouseEnabled && child.hitTestPoint && child.hitTestPoint(e.stageX/zim.scaX, e.stageY/zim.scaY)) return;
+						if (that.mousedownIncludes.indexOf(child)==-1 && child.mouseEnabled && child.hitTestPoint && child.hitTestPoint(e.stageX/zim.scaX, e.stageY/zim.scaY)) return;						
 					}
 				}
 				var p = container.globalToLocal(mouseMoveOutside?e.rawX/zim.scaX:e.stageX/zim.scaX, mouseMoveOutside?e.rawY/zim.scaY:e.stageY/zim.scaY);
@@ -85545,7 +85656,7 @@ END EXAMPLE
 EXAMPLE
 // using ZIM VEE series to adjust stroke color and width
 const g = new Generator({draw:gen, maxCount:360/2, strokeColor:green});
-const s = series({min:1, max:4}).step(.1).bounce(); // stroke sizes
+const s = series({min:1, max:4, step:.1}).bounce(); // stroke sizes
 const c = series(blue,pink,green).every(12); // color change
 function gen(count, total, g) {
 	g
@@ -88019,25 +88130,45 @@ dispatches a "ready" event when the sound source is connected and the calculate(
 			} else if (input.type == "SynthSound") {
 				connectSource(input.gain);
 			} else {
-				if (input.type && input.type == "sound") {zogy("ZIM SoundWave: pass in the result of a zim.asset('somesound').play() for the input"); return;}
+				if (input.type && input.type == "sound") {zogy("ZIM SoundWave: pass in the result of an Aud('somesound').play() for the input"); return;}
 				var audio,source;
 				if (input.playbackResource) {
-					audio = input.playbackResource; // a playing zim.asset("somesound").play()
-					if (audio.mediaSourceNode) {
-						source = audio.mediaSourceNode;
-					} else {					
-						source = audioContext.createMediaElementSource(audio);
-					}
+					audio = input.playbackResource; // a playing Aud("somesound").play()
+
+					// ZIM 019 Patch - thanks Vishwas Gagrani for the report
+					// if audio finishes cannot properly remove the source - bug in HTML 5 Audio
+					// which caused errors if trying to do another SoundWave on the audio 
+					// so remember if already had a Soundwave 
+					// and need to use that audioContext and analyser
+					if (audio.firstSource) {
+						source = audio.firstSource;
+						audioContext = audio.audioContext;
+						analyser = audio.analyser;
+					} else {
+						if (audio.mediaSourceNode) {
+							source = audio.mediaSourceNode;
+						} else {
+							source = audioContext.createMediaElementSource(audio);
+						}		
+					}			
 				} else {
 					audio = input; // a playing <audio> tag zid("soundTagID").play()
-					source = audioContext.createMediaElementSource(audio);
-				}				
+					if (audio.firstSource) {
+						source = audio.firstSource;
+						audioContext = audio.audioContext;
+						analyser = audio.analyser;
+					} else {						
+						source = audioContext.createMediaElementSource(audio);		
+					}			
+				}					
+				audio.firstSource = source;	
+				audio.audioContext = audioContext;		
+				audio.analyser = analyser;
 				connectSource(source);
 			}
 		};
 		this.setInput(input);
 
-
 		var steps;
 		var lastSource;
 				
@@ -88124,6 +88255,7 @@ dispatches a "ready" event when the sound source is connected and the calculate(
 			setTimeout(function(){that.dispatchEvent("ready");}, 50);
 		}
 		this.dispose = function(context) {
+			// if (lastSource) lastSource.disconnect();
 			if (lastSource && analyser) lastSource.disconnect(analyser);
 			if (context && audioContext) audioContext.close();
 			if (analyser) analyser.disconnect();
@@ -91678,7 +91810,7 @@ zim.Frame = function(scaling, width, height, color, outerColor, ready, assets, p
 			var duo; if (duo = zob(that.loadAssets, arguments, sig)) return duo;
 		}
 
-		if (!zot(path)) {s
+		if (!zot(path) && path.replace) {
 			path = path.replace(/\/$/,"");
 			path = path + "/";
 			WW.PATH = path;
@@ -92184,7 +92316,7 @@ zim.Frame = function(scaling, width, height, color, outerColor, ready, assets, p
 		// now check auto load assets or broken if second
 		
 		if (WW.PATH!=null) zim.PATH = WW.PATH;
-		if (zim.PATH!=null) {
+		if (zim.PATH!=null && zim.PATH.replace) {
 			zim.PATH = zim.PATH.replace(/\/$/,"");
 			zim.PATH = zim.PATH + "/";
 		}				
@@ -103196,4 +103328,3 @@ export let Style = zim.Style;
 export let assets = zim.assets;
 export let assetIDs = zim.assetIDs;
 export let ZIMON = zim.ZIMON;
-