zimjs 18.2.3 → 18.2.5

package/package.json

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

package/src/zim.js

@@ -1743,7 +1743,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 							r = call(obj.item(i), i, total, start, end, obj, io);
 						}					
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -1780,7 +1780,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 							r = call(obj.item(i), i, total, start, end, obj, io);
 						}
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -1814,7 +1814,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 						
 						r = call(props[i], obj[props[i]], i, total, start, end, obj, io);
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -1835,7 +1835,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 						
 						r = call(props[i], obj[props[i]], i, total, start, end, obj, io);
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -2148,8 +2148,8 @@ pauseTimeLeft - if paused, get how much time is left once unpaused
 			obj.paused = state;
 		};
 		obj.next = function() {
-			obj.count++;
-			(call)(obj);
+			obj.count++;				
+			(call)(obj);	
 			checkTotal();
 		};
 		obj.clear = function() {
@@ -9317,6 +9317,7 @@ Used internally by ZIM to globally dispose common connections
 	        if (c.getContext) c.getContext("2d").clearRect(0,0,1,1);
 			delete obj.z_bc;
 		}
+		if (obj.cacheCanvas) obj.uncache();
 		if (zim.KEYFOCUS == obj) zim.KEYFOCUS = null;
 		if (WW.KEYFOCUS == obj) WW.KEYFOCUS = null;		
 		if (obj.veeObj) obj.veeObj = null;
@@ -30553,7 +30554,7 @@ var layer = new Layer().center();
 timeout(100, function(){zog(layer.transformControls);}); // will probably do the trick
 The transformControls property holds the following:
 
-TRANSFORM CONTROL OBJECT PROPERTIES
+TRANSFORM CONTROLS OBJECT PROPERTIES
 visible - read only whether the controls are visible
 ghost - read only as to whether the ghost outline is showing - set with showGhost and hideGhost
 ghostEnabled - read only as to whether the ghost outline will be turned on and off - set with addGhost and removeGhost
@@ -30562,7 +30563,7 @@ stretchXControls - reference to the Container that holds the left and right boxe
 stretchYControls - reference to the Container that holds the top and bottom boxes for stretching
 rotateControls - reference to the Container that holds the outer circles for rotating
 
-TRANSFORM CONTROL OBJECT METHODS
+TRANSFORM CONTROLS OBJECT METHODS
 hide() - hides the controls - returns object for chaining
 show() - shows the controls - returns object for chaining
 recordData(toJSON) - returns an object with type, x, y, scaleX, scaleY, rotation, skewX, skewY, visible PROPERTIES
@@ -52042,7 +52043,7 @@ END EXAMPLE
 
 PARAMETERS supports DUO - parameters or single object with properties below
 boundary - (default null) a ZIM Boundary object for the drag boundary
- 	or a ZIM DisplayObject including stage
+	or a ZIM DisplayObject including stage
 		If the boundary is a display object then ZIM will keep the shape of the dragged object inside the bounds.
 		If the boundary object is a Blob then the dragged object will stay within the Blob (experimental).
 		If the boundary object is a Circle then the registration point of the dragged object will stay within the circle
@@ -52088,7 +52089,7 @@ rect - (depreciated) same as boundary - kept for backwards compatibility when us
 currentTarget - (default false) same as the all parameter - kept for backwards compatibility when using config object
 offStage - (default false) set to true to be able to drag object off stage (thanks Shammi!)
 immediateBoundary - (default false) set to true to add bounds immediately when drag() is set on a Container.
- 	this is normally set to false for a .05 second delay to allow objects to be added to Container before setting bounds.
+	this is normally set to false for a .05 second delay to allow objects to be added to Container before setting bounds.
 singleTouch - (default false) set to true to let only one touch operate the drag 
 	also see Frame() singleTouch setting - but setting on drag will only affect that object's drag
 dropTargets - an object or an array of objects that can receive a drop
@@ -52672,7 +52673,7 @@ RETURNS obj for chaining
 				// if (dampY) dampY.immediate(0);
 
 			} else {
-                obj.downCheck = false; // added ZIM NFT 01
+				obj.downCheck = false; // added ZIM NFT 01
 				var pointerCount = 0;
 				for (var o in obj.pointers) {
 					pointerCount++;
@@ -56881,7 +56882,12 @@ PARAMETERS
 ** supports DUO - parameters or single object with properties below
 ** supports VEE - parameters marked with ZIM VEE mean a zim Pick() object or Pick Literal can be passed
    Pick Literal formats: [1,3,2] - random; {min:10, max:20} - range; series(1,2,3) - order, function(){return result;} - function
-
+** supports OCT - parameter defaults can be set with STYLE control (like CSS) 
+	NOTE: can target parameters in general like 
+		STYLE = {loop:true};
+	to target animate specifically use 
+		STYLE = {Animate:{loop:true}};
+	NOT STYLE = {animate:{loop:true}} as lowercase animate conflicts with setting a animate convenience style
 props - the object literal holding properties and values to animate
 	Basic examples: {x:200} or {rotation:360, alpha:0} or {scale:4} or {x:300, y:300, scale:"2"} (relative scale)
 	There are custom options below including Convenience, ZIM VEE, Relative, and Series properties.
@@ -57253,6 +57259,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 		if (target && target.type && target.type=="AC" && WW.zdf) {WW.zdf.ac("animate", arguments); return target;}
 		if (!zim.animateCheck) {z_d("45"); zim.animateCheck=true;}
 
+
 		if (!target) target = {}; // ZIM 018 replacing: return; from 10.9.0 
 		var AN = zim.ANIMATE;
 		if (WW.ANIMATE != null) AN = WW.ANIMATE;
@@ -57512,7 +57519,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 		// ANIMATION SERIES HANDLING
 		// if an array is passed in to animate() as the obj
 		// then animate treats this as an animation series
-		// [{target:circle, obj:{alpha:0}, time:1}, {target:rect, obj:{alpha:0}, time:1},]
+		// [{target:circle, obj:{alpha:0}, time:1}, {target:rect, obj:{alpha:0}, time:1}]
 
 		if (obj instanceof Array) {
 			currentCount = 1;
@@ -60594,7 +60601,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 	zim.loop = function(obj, call, reverse, interval, step, start, end, immediate, complete, completeParams) {
 		var sig = "obj, call, reverse, interval, step, start, end, immediate, complete, completeParams";
 		var duo; if (duo = zob(zim.loop, arguments, sig)) return duo;
-		
+
 		if (!zim.zimLoopCheck) z_d("45.3");
 		zim.zimLoopCheck = true;
 		if (zot(obj) || zot(call)) return undefined;
@@ -60653,7 +60660,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 							r = call(obj.item(i), i, total, start, end, obj, io);
 						}					
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -60690,7 +60697,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 							r = call(obj.item(i), i, total, start, end, obj, io);
 						}
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -60724,7 +60731,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 						
 						r = call(props[i], obj[props[i]], i, total, start, end, obj, io);
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -60745,7 +60752,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 						
 						r = call(props[i], obj[props[i]], i, total, start, end, obj, io);
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -60765,7 +60772,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 						if (typeof r != 'undefined' && r != "next") return r;
 					}
 				} else {
-					zim.interval(interval, function(io) {
+					zim.interval(interval, function(io) {						
 						i = io.count;
 						if (!immediate) i--;
 						if (step) i *= step;
@@ -60773,7 +60780,7 @@ RETURNS any value returned from the loop - or true if no value is returned from
 						
 						r = call(obj.getChildAt(i), i, total, start, end, obj, io);
 						
-						if (r == 'next') io.next();
+						if (r == 'next' && i < total-1) io.next();
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -60792,9 +60799,8 @@ RETURNS any value returned from the loop - or true if no value is returned from
 						if (!immediate) i--;
 						if (step != 1) i = -start + i*step;
 						
-						r = call(obj.getChildAt(i), i, total, start, end, obj, io);
-						
-						if (r == 'next') io.next();
+						r = call(obj.getChildAt(i), i, total, start, end, obj, io);					
+						if (r == 'next' && i < total-1) io.next();	
 						else if (typeof r != 'undefined') {
 							io.clear();
 							return r;
@@ -61711,9 +61717,9 @@ zim constant and static Class
 Also GLOBALSTYLE zim constant
 
 DESCRIPTION
-STYLE can be used to set any parameter on a DisplayObject and many of the Controls.
-For instance: Circle, Blob, Button, Pane, Bitmap, Sprite, Tile, Pen, Emitter, Scroller, etc.
-These are applied at the time the objects are made.
+STYLE can be used to set any parameter on a DisplayObject, many of the Controls, and some methods.
+For instance: Circle, Blob, Button, Pane, Bitmap, Sprite, Tile, Pen, Emitter, Scroller, drag, animate, etc.
+These are applied at the time the objects are made or method called.
 They are cascading with each level overriding the previous level:
 
 1. GENERAL: any style can be specified in general
@@ -61750,6 +61756,9 @@ STYLE = {big:{width:500}} // will be automatically converted to STYLE = {group:{
 NOTE: As of ZIM 016, group styles for an object will be used even if style for the object is set to false
 this will ignore all styles except those made by a group
 
+NOTE: As of ZIM 019, animate() and drag() can be styled.  
+If the object type is used to target these, use Animate and Drag to avoid conflicting with convenience styles of animate and drag 
+
 EXAMPLE
 STYLE = {
 	corner:20,
@@ -90708,12 +90717,12 @@ SVG will give a "ready" and a "complete" event when loaded.
 These events are triggered 20 ms after making the object if the object is already preloaded.
 
 NOTE: SVG is a container with a bitmap inside (see bitmap property)
-or if the bitmap option is not selected there are other shapes inside.
+or if the bitmap option is not selected there are various shapes inside.
 This means that other objects can be added to the SVG object.
 This is like the ZIM Shapes (Rectangle, Circle, etc.) which are containers and can have objects added to them.
-If doing this, note that the container has its mouseChildren may be turned off
+If doing this, note that the container has its mouseChildren turned off
 so when dragging, for instance, the whole SVG moves rather than the bitmap inside the SVG.
-To interact with objects inside, set pic.mouseChildren = true.
+To interact with objects inside, set mySVG.mouseChildren = true.
 Generally, for clarity, avoid adding objects to Shapes, Pics SVGs unless you are used to the mouseChildren setting.
 
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)
@@ -98172,7 +98181,7 @@ for (z_i = 0; z_i < globalFunctions.length; z_i++) {
   WW[pair[0]] = zim[pair[0]] = pair[1];
 }
 
-if (zns) {
+
 	// these are global regardless
 	var globalsConstants = [
 		["FIT", zim.FIT],
@@ -98229,7 +98238,7 @@ if (zns) {
 	for (z_i = 0; z_i < zim.colors.length; z_i++) {
 		WW[zim.colors[z_i]] = zim.colorsHex[z_i];
 	}
-} else zimplify();
+
 
 WW.zim = zim;
 export default zim;