zimjs 19.0.7 → 19.0.9

package/package.json

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

package/src/zim.js

@@ -28529,6 +28529,8 @@ content - (default " ") optional content to be centered in one of three formats:
 		spacingV - vertical space between the content areas		
 		align - default CENTER, or use LEFT or RIGHT
 backgroundColor - (default white) a css color for the background of the Pane
+	to set the backgroundColor after the Pane is made, use the backing property
+		pane.backing.backgroundColor = red;
 color - (default black) a css color for the text color of the Pane
 width - (default AUTO) width of pane - AUTO will matches content width - see also autoPadding and autoPaddingH
 height - (default AUTO) height of pane - AUTO will matches content width - see also autoPadding and autoPaddingV
@@ -28608,6 +28610,8 @@ type - holds the class name as a String
 closeCall - a function to call when the pane closes (see also call parameter of show method)
 closeParams - an object to pass to the closeCall (see also params parameter of show method)
 backing - or display - reference to the pane box
+	use this to set the color, border, etc. afterwards 
+		pane.backing.color = red;
 contentContainer - ZIM Container used to hold added content (formerly the content property)
 	use the add() method or add directly to the contentContainer property of the pane
 content - gives access to the content provided as a parameter to the Pane()
@@ -58985,6 +58989,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
@@ -63723,8 +63729,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.
 
@@ -63735,7 +63744,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
@@ -67872,8 +67881,7 @@ setSpacing(h,v) - set spacings for Tile - h and v are horizontal and vertical sp
 	ZIM Tile() makes spacing arrays for horizontal and vertical spacing based on ZIM VEE calculations from the spacingH and spacingV parameters
 	to change spacing afterwards, new arrays can be provided to setSpacing()
 	the arrays must have col-1 and row-1 items - although h or v can be left null or undefined to keep existing spacing
-remake(items, newSpacingH, newSpacingV, newCount) - pass in an array of items to tile - see items property for editing current list - returns tile for chaining
-	can also change rows and cols and remake()
+remake(items, newSpacingH, newSpacingV, newCount, newCols, newRows) - pass in an array of items to tile - see items property for editing current list - returns tile for chaining	
 	optionally pass in new spacing parameters (these accept ZIM VEE values) and/or a newCount 
 	Note: if the items length is different than the previous items length then the count will be automatically made cols*rows - unless newCount is provided
 resize(width, height) - resize the tile with new width and/or height if the width and/or height parameters were set - returns tile for chaining
@@ -67913,8 +67921,7 @@ These properties can be changed by calling remake()
 	items - an array of items the tile uses
 		modify this and pass in to remake(items) to update the Tile with new items
 		cannot modify count - count will become the length of the array passed to remake()
-	cols - number of columns - can modify - need to call remake() to see changes
-	rows - number of rows - can modify - need to call remake() to see changes
+	cols / rows - (read only) use newCols and newRows parameter of remake()
 These properties can be changed by calling resize(width, height) - set width or height to 0 for no spreading
 	squeezeH - horizontal compression - can modify - need to call resize() to see changes
 	squeezeV - vertical compression - can modify - need to call resize() to see changes
@@ -67979,6 +67986,11 @@ note: the item is not the event object target - as that is the tile
 		if (zot(count)) count = DS.count!=null?DS.count:(unique&&Array.isArray(obj))?obj.length:null;
 		if (count === 0) {count = null; if (zon) {zogy("ZIM Tile() - count parameter of 0 is ignored - see docs");}}
 
+		// Added ZIM 019 Patch 
+
+		var colsO = cols;
+		var rowsO = rows;
+
 		// Added ZIM 018
 
 		var spacingHList = [];
@@ -68461,14 +68473,32 @@ note: the item is not the event object target - as that is the tile
 			return that.items2D[ro][co];
 		};
 
-		this.remake = function(items, newSpacingH, newSpacingV, newCount) {
+		this.remake = function(items, newSpacingH, newSpacingV, newCount, newCols, newRows) {
 
 			// a little complicated so we just remake the spacings if provided or items length has gotten bigger
 			// if items length is different we create a new count - can override with newCount
 			if (zot(items)) items = that.items
 			if (zot(newCount) && items.length != that.items.length) count = that.cols*that.rows;
-			if (!zot(newSpacingH) || !zot(newSpacingV) || items.length > that.items.length) {
+			if (
+				!zot(newSpacingH) || 
+				!zot(newSpacingV) || 
+				items.length > that.items.length || 
+				(!zot(newCols) && newCols != that.cols) || 
+				(!zot(newRows) && newRows != that.rows)
+			) {
 
+				if (!zot(newCols)) colsO = newCols;
+				if (!zot(newRows)) rowsO = newRows;
+				if (colsO <= 0) colsO = 1;
+				if (rowsO <= 0) rowsO = 1;		
+				
+				if (!zot(newCount)) count = newCount
+				else count = items.length;
+
+				if (count > colsO) that.cols = colsO;
+				else that.cols = count;				
+				that.rows = Math.ceil(count/that.cols);
+				
 				if (!zot(newSpacingH)) spacingH = newSpacingH;
 				if (!zot(newSpacingV)) spacingV = newSpacingV;
 
@@ -68667,7 +68697,7 @@ note: the item is not the event object target - as that is the tile
 				if (!resize && backing) backings = [];
 
 				var lastX = (colSize?(spacingHOList[0]?spacingHOList[0]:0):0)/2;
-				var lastY = (rowSize?(spacingHOList[0]?spacingHOList[0]:0):0)/2;
+				var lastY = (rowSize?(spacingVOList[0]?spacingVOList[0]:0):0)/2; // updated to VO from HO - ZIM 019 patch
 							
 				var rect;
 				var cou = 0;
@@ -90766,9 +90796,9 @@ leftMouseDown - read only value as to whether the left mouse button is down
 mousedownEvent - a reference to the frame "stagemousedown" event - can set F.off("stagemousedown", F.mousedownEvent)
 mousemoveEvent - a reference to the frame "stagemousemove" event - can set F.off("stagemousemove", F.mousemoveEvent)
 orientation - VERTICAL or HORIZONTAL (updated live with orientation change)
-visibleLeft, visibleTop, visibleRight, visibleBottom - in "fill" scale mode these give window edge locations relative to the stage
+visibleLeft, visibleTop, visibleRight, visibleBottom - in FILL scale mode these give window edge locations relative to the stage
 	can be used to position items like navigation relative to window as the frame resize event is fired
-	in all scale modes other than "fill", the values are 0, W, 0, H
+	in all scale modes other than FILL, the values are 0, W, 0, H
 zil - reference to zil events that stop canvas from shifting or scrolling - also see allowDefault parameter
 	can set allowDefault property to false then allow specific defaults by removing zil events - see zil global function
 	example: window.removeEventListener("keydown", F.zil[0]); removes keydown preventions (for page up, page down, home, end, etc)
@@ -90778,10 +90808,10 @@ touch - get or set the touch setting - setting to false will not allow touch on
 singleTouch - get or set the singleTouch setting - set to true to turn on single touch and false to turn on multitouch
 	setting either true or false will set the touch property to true
 	also see the touch and singleTouch parameters and touch property
-followBoundary - update with a ZIM Boundary for follow() if "full" mode Frame "resize" event happens, etc.
+followBoundary - update with a ZIM Boundary for follow() if FULL mode Frame "resize" event happens, etc.
 altKey - true if the alt key is being pressed otherwise false
 ctrlKey - true if the ctrl key is being pressed otherwise false
-metaKey - true if the meta key (⌘ command on Mac or ⊞ windows key) is being pressed otherwise false
+metaKey - true if the meta key (command on Mac or windows key) is being pressed otherwise false
 shiftKey - true if the shift key is being pressed otherwise false
 loadFailObj - the object that shows if images are broken - will be given a type property of "EmptyAsset"
 startTime - datestamp of when frame was made - used internally
@@ -102619,6 +102649,8 @@ spacingH - (default 0) a spacing between columns
 spacingV - (default 0) a spacing between rows
 interval - (default 0) the time to animate in s
 	for pixels, noise, dots and bling this is the time between showing different patterns
+		Note: if using a series() for color, this will only animate if the total number of cols x rows 
+		is NOT divisable equally by the number of colors in the series
 	for stripes, slants, hatch, plaid this is the time to move the pattern to the right
 	different patterns may seem to move at different speeds due to the pattern repeat distance
 startPaused - (default false) set to true to start the interval for animation to paused
@@ -102781,6 +102813,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],
@@ -103163,3 +103196,4 @@ export let Style = zim.Style;
 export let assets = zim.assets;
 export let assetIDs = zim.assetIDs;
 export let ZIMON = zim.ZIMON;
+

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

@@ -3380,7 +3380,7 @@ declare namespace zim {
 	export class Tile extends Container {
 		constructor(config_or_obj: DisplayObject | zimVee, cols?: number, rows?: number, spacingH?: number, spacingV?: number, unique?: boolean, width?: number, height?: number, squeezeH?: boolean, squeezeV?: boolean, colSize?: number | zimVee, rowSize?: number | zimVee, align?: string | zimVee, valign?: string | zimVee, count?: number, mirrorH?: boolean, mirrorV?: boolean, snapToPixel?: boolean, clone?: boolean, events?: boolean, exact?: boolean, scaleToH?: number | zimVee, scaleToV?: number | zimVee, scaleToType?: string | zimVee, backgroundColor?: color | zimVee, backing?: DisplayObject | zimVee, backdropColor?: color | zimVee, backdropPadding?: number, backdropPaddingH?: number, backdropPaddingV?: number, mat?: DisplayObject, style?: boolean, group?: string, inherit?: {})
 		constructor(config: { obj: DisplayObject | zimVee, cols?: number, rows?: number, spacingH?: number, spacingV?: number, unique?: boolean, width?: number, height?: number, squeezeH?: boolean, squeezeV?: boolean, colSize?: number | zimVee, rowSize?: number | zimVee, align?: string | zimVee, valign?: string | zimVee, count?: number, mirrorH?: boolean, mirrorV?: boolean, snapToPixel?: boolean, clone?: boolean, events?: boolean, exact?: boolean, scaleToH?: number | zimVee, scaleToV?: number | zimVee, scaleToType?: string | zimVee, backgroundColor?: color | zimVee, backing?: DisplayObject | zimVee, backdropColor?: color | zimVee, backdropPadding?: number, backdropPaddingH?: number, backdropPaddingV?: number, mat?: DisplayObject, style?: boolean, group?: string, inherit?: {} })
-		remake(items?: any[]): this
+		remake(items?: any[], newSpacingH?: number, newSpacingV?: number, newCount?: number, newCols?: number, newRows?: number): this
 		resize(width?: number, height?: number): this
         setProps(obj: [], props: {}): this
 		itemUnderPoint(x: number, y: number, ignoreSpacing?: boolean): DisplayObject
@@ -3391,8 +3391,8 @@ declare namespace zim {
 		readonly current: any[]
 		readonly current2D: any[]
 		readonly current2DCols: any[]
-		cols: number
-		rows: number
+		readonly cols: number
+		readonly rows: number
 		spacingH: number
 		spacingV: number
 		squeezeH: boolean