zimjs 19.0.8 → 19.1.0

package/package.json

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

package/src/zim.js

@@ -34109,9 +34109,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 +34256,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 +35185,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 +35215,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);
@@ -48722,7 +48739,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 
@@ -53082,7 +53099,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 +53245,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 +53276,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 +53295,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 +53371,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 +53630,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 +53644,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 +53888,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 +53918,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 +53938,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 +53953,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 +54002,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,6 +58353,7 @@ 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
@@ -58989,6 +59073,8 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 
 				if (zot(o.props) && !zot(o.obj)) o.props = o.obj;
 				o.obj = o.props;
+				if (o.loopCall || o.loopWait || o.loopPick || o.loopCount) o.loop = true;
+				if (o.rewindCall || o.rewindWait || o.rewindPick || o.rewindTime || o.rewindEase) o.rewind = true;
 				if (o.loop && (zot(o.loopCount) || o.loopCount <= 0)) {
 					o.loopCount = 0;
 					// this object is looping forever so no point in keeping any next objects
@@ -63727,8 +63813,11 @@ PATH
 zim global variable
 
 DESCRIPTION
-PATH is used by lazy-loaded assets (not using Frame assets parameter or loadAssets() method).
-This will be set by default to the latest path parameter in Frame or in loadAssets().
+PATH can be used to set the URL path to assets for Pic(), Aud(), etc. 
+This only works with lazy-loaded assets so assets not using the Frame() or loadAssets() assets and path parameter. 
+PATH is set by default to the latest path parameter in Frame or in loadAssets().
+
+NOTE: this is NOT paths for ZIM Blobs and Squiggles https://zimjs.com/paths - that is something else.
 
 NOTE: if an lazy-loaded asset has a path in it (as in a /) then the PATH will be ignored.
 
@@ -63739,7 +63828,7 @@ EXAMPLE
 new Pic("image.png").center(); // will look in local directory 
 new Pic("images/image.png").center(); // will look in images/ directory 
 
-PATH = "assets/";
+PATH = "assets/"; // or could be an absolute URL like "https://zimjs.org/assets/"
 new Pic("image.png").center(); // will look in assets/ directory
 new Pic("sound.mp3").play(); // will look in assets/ directory
 new Pic("test/image.png").center(); // will look in test/ directory
@@ -85540,7 +85629,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
@@ -102808,6 +102897,7 @@ for (z_i = 0; z_i < globalFunctions.length; z_i++) {
 		["END", zim.END],
 		["TOP", zim.TOP],
 		["BOTTOM", zim.BOTTOM],
+		["BOT", zim.BOT],
 		["OVER", zim.OVER],
 		["UNDER", zim.UNDER],
 		["HORIZONTAL", zim.HORIZONTAL],