zimjs 17.2.3 → 17.2.5

package/.gitattributes

@@ -20,3 +20,4 @@
 *.PDF	 diff=astextplain
 *.rtf	 diff=astextplain
 *.RTF	 diff=astextplain
+

package/package.json

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

package/src/zim.js

@@ -29112,6 +29112,10 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 		}
 
 		this._enabled = true;
+		var lastReadOnly;
+		setTimeout(function() {
+			lastReadOnly = that.readOnly;
+		},50);
 		Object.defineProperty(that, 'enabled', {
 			get: function() {
 				return that._enabled;
@@ -29123,6 +29127,18 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 				} else {
 					setDrag();
 				}
+				if (that.blinker) {
+					if (!value) {
+						that.blinker.vis(false);
+						that.selection.vis(false);
+						lastReadOnly = that.readOnly;
+						that.readOnly = true;
+					} else {
+						that.readOnly = lastReadOnly;
+						if (!that.readOnly) that.blinker.vis(true);
+						that.selection.vis(true);
+					}
+				}
 				zenable(that, value);
 			}
 		});
@@ -31109,7 +31125,12 @@ align - get or set the horizontal alignment of the text
 color - gets or sets the label text color
 backgroundColor - gets or sets the background color
 readOnly - get or set the field as readOnly - also see readOnly parameter
+	read only of true will allow selection and copy but not typing and cursor will be removed
+	set enabled to false to not allow selection and copy
 enabled - default is true - set to false to disable
+	setting enabled false will remember the readOnly setting when enabled is set to false 
+	so when set to true again it will be that remembered readOnly and will not rememember any changes to readOnly made in-between 
+	so any in-between readOnly changes will have to be re-applied after enabled is set back to true
 veeObj - an object with ZIM VEE original parameters:value allowing the ZIM VEE values to be referenced
 	for instance, obj.prop = Pick.choose(obj.veeObj.prop); will reset the the prop to the result of the original ZIM VEE value
 
@@ -31522,14 +31543,16 @@ zim.TextInput = function(width, height, placeholder, text, size, font, color, ba
 	
 	Object.defineProperty(that, 'readOnly', {
 		get: function() {
-			return readOnly;
+			return readOnly;			
 		},
 		set: function(value) {			
 			readOnly = value;
 			that.htmlTag.readOnly = readOnly;
+			if (value) that.blinker.vis(false);
+			else that.blinker.vis(true);
 		}
 	});
-	if (readOnly) that.htmlTag.readOnly = true;
+	that.readOnly = readOnly;
 
 	Object.defineProperty(that, 'focus', {
 		get: function() {
@@ -46644,10 +46667,12 @@ loader.on("loaded", e=>{
 	S.update();
 });
 
-// and to later save for instance in a button event:
-saveButton.on("click") {
-	loader.save(stage); // or some other container... can specify crop bounds too
-}
+// if wanting a save button
+const saveButton = new Button({label:"SAVE"})
+	.pos(10,10,RIGHT,BOTTOM)
+	.tap(()=>{
+		loader.save(S); // or some other container... can specify crop bounds too
+	}
 END EXAMPLE
 
 EXAMPLE
@@ -46886,7 +46911,7 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 		if (accept) uploadTag.setAttribute("accept", accept);
 		uploadTag.hidden = true;
 		uploadTag.zimDisplay = uploadTag.style.display || "inline-block";
-		uploadTag.style.cssText = "border:thin solid grey; z-index:2; width:" + 0 + "px; height:" + 0 + "px; overflow:hidden; outline:none;"
+		uploadTag.style.cssText = "border:thin solid grey; z-index:2; width:" + width + "px; height:" + height + "px; overflow:hidden; outline:none;"
 								+ "position:absolute; left:0px; top:0px; display:none; cursor:pointer; opacity: 0; filter: alpha(opacity=0);";
 
 		this.addEventListener('mousedown', function() { // added for zim.Accessibility
@@ -47368,6 +47393,7 @@ value - get or set the text content of the TextArea
 text - get or set the text value
 focus - get or set if the TextArea tag has focus or use setFocus() to set (might need timeout 100ms before setting)
 readOnly - set to true to not be able to edit or to false to be able to edit (always can select)
+	set enabled to false to disable selection
 maxLength - get or set the maximum number of characters typed - will not truncate existing characters until typed
 tag - the HTML textarea tag - just a regular HMTL form tag which can be styled
 background - access to the Rectangle() used for the background
@@ -47376,6 +47402,8 @@ background - access to the Rectangle() used for the background
 blendMode - how the object blends with what is underneath - such as "difference", "multiply", etc. same as CreateJS compositeOperation
 keyFocus - get or set the keyboard focus on the component - see also zim.KEYFOCUS
 	will be set to true if this component is the first made or component is the last to be used
+enabled - get or set enabled of TextArea 
+	this will remember last readOnly so any setting of readonly in between enabled settings will have to be reapplied.
 frame - get or set the frame - set this if changing frames
 
 ALSO: see ZIM Container for properties such as:
@@ -47687,6 +47715,30 @@ added, click, dblclick, mousedown, mouseout, mouseover, pressdown (ZIM), pressmo
 				}
 			}
 		});
+
+		that._enabled = true;
+		var lastReadOnly = that.readOnly;
+		Object.defineProperty(that, 'enabled', {
+			get: function() {
+				zog("here")
+				return that._enabled;
+			},
+			set: function(value) {
+				if (!value) {
+					lastReadOnly = that.readOnly;
+					that.readOnly = false; // needed to remove selection
+					that.focus = false;						
+					that.tag.style.pointerEvents = "none";
+					setTimeout(function() {						
+						that.readOnly = true;
+					},50); // setting readonly brings back selection even after blur - bug in HTML
+				} else {
+					that.tag.style.pointerEvents = "unset"; // tried all, unset, inherent, auto, initial, revert
+					that.readOnly = lastReadOnly; // does not bring selection back
+				}				
+				zenable(that, value);
+			}
+		});
 	
 		this.resizeEvent = frame.on("resize", that.resize);
 		this.updateEvent = frame.on("update", that.resize);
@@ -51130,7 +51182,7 @@ RETURNS obj for chaining
 
 			if (e.stageX == null) return; // added for TextureActive drag in 2D view
 
-			if (slide) {				
+			if (slide) {	
 				dragObject.dispatchEvent("slidestart");
 				
 				if (dragObject.parent) {
@@ -51172,6 +51224,12 @@ RETURNS obj for chaining
 					lastBackT = upT = 0;
 				}				
 
+				if (Math.abs(dX) < 1 && Math.abs(dY) < 1) {
+					hasMoved = false;
+					dragObject.dispatchEvent("slidestop");
+					zim.Ticker.remove(obj.zimDragTicker);
+				}
+
 				// if (dampX) dampX.immediate(50);
 				// if (dampY) dampY.immediate(0);
 
@@ -51253,7 +51311,8 @@ RETURNS obj for chaining
 						}
 					} 
 				});
-				if (miss) {				
+				if (miss) {		
+					dragObject.dropTarget = dragObject.droppedTarget = null;		
 					if (dropBack) {
 						dragObject.animate({
 							props:{x:dragObject.dropStartX, y:dragObject.dropStartY, scale:dragObject.dropStartS}, 
@@ -51362,7 +51421,7 @@ RETURNS obj for chaining
 				o.y = desiredY;
 				o.slideStartX = null;
 				o.slideStartY = null;
-				if (hasMoved) {
+				if (hasMoved) {					
 					o.dispatchEvent("slidestop");
 					zim.Ticker.remove(obj.zimDragTicker);
 				}
@@ -51387,7 +51446,7 @@ RETURNS obj for chaining
 		function setUpSlide() {
 			obj.zimDragTicker = function() {
 				if (zot(obj.slideStartX)) return; // don't stop other things like window scrollbar from moving object
-
+				
 				if (!dragObject) dragObject = obj; // could be risky if intending to drag children
 				if (obj.downCheck) {
 					var point;
@@ -58074,7 +58133,7 @@ RETURNS the target for chaining (or null if no target is provided and run on zim
 				// if (internal) target.percentComplete = target.pathRatio = 0;
 
 				if (zot(command)) command = true;
-				if (target.pan == undefined) {
+				if (target.pan == undefined && target.type != "Timer") { // hmmm what about other objects with paused properties...
 					if (target.type != undefined) target.paused = true;
 					target.animating = false;
 				}
@@ -79163,7 +79222,6 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 							}
 						});
 					}
-
 					if (
 						cache && 
 						!particle.emitShape && 
@@ -79275,7 +79333,7 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 					else max = zik(life);
 					var min;
 					if (interval.min) min = interval.min;
-					else if (Array.isArray(interval)) min = zim.arrayMinmin(interval).min;
+					else if (Array.isArray(interval)) min = zim.arrayMinMax(interval).min;
 					else min = zik(interval);
 					warm = Math.min(200, Math.round(max/min));
 				}		
@@ -79520,6 +79578,7 @@ zim.Emitter = function(obj, width, height, interval, num, life, fade, shrink, wa
 		return that.cloneProps(new zim.Emitter(objClone, width, height, that.interval, that.num, that.life, that.fade, that.shrink, warm, that.decayTime, that.decayStart, that.trace, that.traceFadeTime, that.traceShiftX, that.traceShiftY, that.angle, that.emitterForce, that.gravity, that.wind, that.layers, that.animation, zim.copy(that.random), that.horizontal, that.vertical, that.sink, that.sinkForce, cache, that.events, startPaused, that.pool, that.poolMin, particles, focusWarm, style, that.group, inherit));
 	};
 
+	
 	this.dispose = function() {
 		if (that.zimInterval) that.zimInterval.clear();
 		if (emitterTicker) {
@@ -83743,7 +83802,10 @@ zim.VR = function(content, angle, distance, parallax, parallaxAngle, damp, paral
 
 VR
 zim class - extends a ZIM Container which extends a CreateJS Container
-NOTE: Also see the ZIM Three Helper Module for XR controllers, movement and teleport in three.js with ZIM TextureActive (this VR() class is not related)
+
+NOTE: Also see the ZIM Three Helper Module for XR controllers, movement and teleport in three.js
+with ZIM TextureActive (this VR() class is much simplified and not related to TextureActive)
+See: https://zimjs.com/three - for proper 3D
 
 DESCRIPTION
 Copies the content and displays a left and right channel (side-by-side) to be viewed with a VR helmet.
@@ -83790,7 +83852,8 @@ So if you have a label variable for the Label in the original content,
 you can access the label in the right hand channel with label.vrMatch
 The right channel objects also have vrMatch properties so label.vrMatch.vrMatch is the label ;-)
 
-SEE: https://zimjs.com/vr/
+SEE: https://zimjs.com/vr.html
+SEE: https://zimjs.com/vr/sample.html
 
 NOTE: as of ZIM 5.5.0 the zim namespace is no longer required (unless zns is set to true before running zim)