cavalion-js 1.0.71 → 1.0.73

package/.md

@@ -1,4 +1,6 @@
-* [CHANGELOG.md]() - [README.md]() - [package.json]() - [.js]()
+* [CHANGELOG.md]() - [README.md]() - [package.json]()
+* [.workspace](`(devtools/Workspace<${ws.getSpecializer()}>)`) - [.js]()
+
 
 # cavalion-js
 
@@ -45,15 +47,34 @@
 	- [Scaffold.js](src/js/:)
 	- [Type.js](src/js/:)
 
-# `0913`
+# `2022/11/02`
+
+What about a shared _polyfill_-like file, loaded at startup in order to fill in the gaps of packages that are not updated/compiled just yet.
+
+	if(!js.waitAll) {
+		js.waitAll = function(/* ... */) {
+			return Promise.all(js.copy_args(arguments).flat().map(p => {
+				if(typeof p === "string" && p.endsWith("ms")) { // for syntax/code that says it all
+					return new Promise(resolve => setTimeout(resolve, parseInt(p, 10)));
+				} else if(typeof p === "number") { // ok, we'll do this too ;-)
+					return new Promise(resolve => setTimeout(resolve, p));
+				} else if(!(p instanceof Promise)) {
+					throw new Error("Can not wait for", p);
+				}
+				return p;
+			}));
+		}
+	}
+
+# `2022/09/13`
 
-Working on [README.md]().
+* Working on [README.md]().
 
-# `0725`
+# `2022/07/25`
 
-Enhancing `js.groupBy` to accept multiple keys for grouping.
+* Enhancing `js.groupBy` to accept multiple keys for grouping.
 
-# `0429`
+# `2022/04/29`
 
 I want to be able to activate these source files with [an overlay]([!prototypes/Hover]{}) of Markdown. Or... no, I want to overlay the source I guess. 😇🤨🤔
 
@@ -72,7 +93,7 @@ Still, it would be nice to just:
 * Press (**⇧⌘.**) and overlay _the current context_ (whatever that might be anyways, probably a JavaScript module, rapportage-script) with _whatever_, starting with a _context-local_-[.md]()-file, sprouting in to whatever, but _mas-que-nada_ a starting point in order to...
 * ...overlay notes, bookmarks, links, scripts, photos, ...
 
-# `0424`
+# `2022/04/24`
 
 * `js.args(arr)` - concats and filters `arr` for non-undefined values
 

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+### 2023/03/01 -  1.0.73
+
+* Introduces `js.mi` alias for `js.mixIn`
+* Fixes a bug in `js.sf` (ie. String.format) where specifiers where not handled correctly for %X.Yf like formats
+
+### 2022/11/15 -  1.0.72
+
+* DocumentHook: Adds the events onmouseover and onmouseout
+
+### 2022/11/07
+
+* Adds `js.waitAll()`
+
 ### 2022/07/28 10/29 -  1.0.71
 
 * Adjusts/enhances `js.groupBy()` to use js.get(key,obj) in case obj doesn't have key

package/README.md

@@ -3,7 +3,7 @@
 Cavalion common JavaScript library. It consist of:
 
 * Constructor class registration
-* Console
+* Console printing out vars
 * Data interfaces
 * Design(er) package (in development)
 * Utility Classes
@@ -27,7 +27,7 @@ Cavalion common JavaScript library. It consist of:
 	* [JsObject](src/js/:.js) - _kind of super class_
 		* [Method](src/js/:.js) - _hacking with functions_
 	* [Class](src/js/:.js) - _Class.make() is where the meat is_
-		* [extensions](src/js/:.js)
+		* [extensions](src/js/:.js) - _extending native JS objects_
 			* [mixIn](src/js/:.js)
 		* [nameOf](src/js/:.js)
 		* [Method](src/js/:.js)

package/Resource-o4rk6z5bml.md

@@ -0,0 +1,69 @@
+# JavaScript Classes: The Complete Guide To Creating Your Own Custom Class System
+
+JavaScript is a powerful programming language that allows you to create custom code that works in the browser. If you want to create your own custom class system, then this article is for you. It will teach you how to define classes in JavaScript and turn them into something that can be used anywhere on your website.
+
+## The Basics of JavaScript Classes
+
+In JavaScript, a class is just a special type of function. Classes are in fact "special functions", and just like you can define function expressions and function declarations, the same goes for classes.
+There are two ways to create a class in JavaScript:
+
+The first way is to use a class declaration. To do this, you use the class keyword followed by the name of the class. For example:
+
+	class Rectangle {
+	   // ...
+	}
+
+This creates a new class called Rectangle. You can then add properties and methods to this class by using the prototype property of the Rectangle class:
+
+	Rectangle.prototype.width = 10;
+	Rectangle.prototype.height = 5;
+
+You can also add methods to the prototype:
+
+	Rectangle.prototype.getArea = function() {
+	   return this.width * this.height;
+	}
+
+## Defining a Class System in JavaScript
+
+In JavaScript, a class is a blueprint for an object. It is a template that you can use to create new objects with the same characteristics. A class system is a way of organizing and defining classes so that they can be easily reused and extended.
+
+There are several ways to define a class system in JavaScript. The most common way is to use the prototype-based approach. This approach uses the prototype property of objects to create new classes. The prototype property is an object that contains the properties and methods that will be inherited by all instances of the class.
+
+Another way to define a class system in JavaScript is to use the constructor function. This function allows you to create objects with the same characteristics as the constructor function's prototype object. The constructor function is used to initialize the new object's properties and methods.
+
+Once you have defined your class system, you can use it to create new objects. To do this, you first need to create a constructor function for your class. This function will take any arguments that you want to pass into your new object. Once you have created your constructor function, you can then use the new keyword to create an instance of your class.
+
+## Step by Step Creation of a Class Definition
+
+Assuming you have a basic understanding of Object-Oriented Programming concepts, creating a class in JavaScript is very simple. In fact, there are only a few steps involved:
+
+* 1) First, create a function that will serve as the class constructor. This function should accept any parameters that you wish to pass into the class instance when it is created.
+
+* 2) Next, create any properties or methods that you wish to add to the class. These can be defined directly within the constructor function, or they can be added after the fact using the prototype object.
+
+* 3) Finally, return the newly created class from the constructor function.
+
+That's all there is to it! With these three steps, you can create your own custom classes in JavaScript.
+
+## Using the New Class in JS
+
+Assuming you have a basic understanding of JavaScript classes, let's explore how to use the new class in JS.
+
+As we discussed earlier, the new keyword is used to create an instance of a class. When creating an instance of a class, you must provide the arguments that will be passed to the class constructor function. For example:
+
+	class MyClass {
+	  constructor(arg1, arg2) {
+	    this.arg1 = arg1;
+	    this.arg2 = arg2;
+	  }
+	  myMethod() {
+	    // do something with this.arg1 and this.arg2 here
+	  }
+	}
+
+	const myInstance = new MyClass('foo', 'bar');
+
+## Conclusion
+
+In conclusion, JavaScript classes provide a great way to create your own custom class system. With the help of this guide, you should now be able to create your own custom classes and use them in your web development projects. If you have any questions or if there is anything we missed, please feel free to reach out and let us know. We would be more than happy to help you out.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cavalion-js",
-  "version": "1.0.71",
+  "version": "1.0.73",
   "description": "Cavalion common JavaScript library",
   "main": "index.js",
   "scripts": {

package/src/js/Class.js

@@ -29,7 +29,6 @@ define(function(require) {
 		}
 		return classMap["js/JsObject"];
 	}
-
 	function classConstructorToString() {
 		/**
 		 * toString implementation for constructors
@@ -39,7 +38,6 @@ define(function(require) {
 		}
 		return Function.prototype.toString.apply(this, arguments);
 	}
-
 	function namedFunction(name, f) {
 		/**
 		 * This is Chrome specific (as far as I know). It will show fancy names for
@@ -76,7 +74,6 @@ define(function(require) {
 		}
 		return f;
 	}
-
 	function createConstructor(name) {
 		/**
 		 * Create a constructor function used for instances of Class.defin(e)itions

package/src/js/_js.js

@@ -33,17 +33,14 @@ define(function(require) {
 		$: JsObject.$,
 
 		b: beautify,
-		m: minify,
+		m: minify, mi: mixIn,
 		n: nameOf,
 		sj: JSON.stringify,//serialize.serialize,
 		pj: JSON.parse,
 		sf: String.format,
 		nameOf: nameOf,
 		defineClass: defineClass,
-		mixIn: mixIn,
-		// groupBy: (arr, key) => {
-		// 	return arr.reduce((a, o) => ((a[js.get(key, o)] || (a[js.get(key, o)] = [])).push(o), a), {});
-		// },
+		mixIn: mixIn, 
 		groupBy: (arr, keys, mth) => {
 			/*- groupBy: receives an array of objects and returns an object 
 					which keys hold reference to the resulting groups.
@@ -381,6 +378,17 @@ define(function(require) {
 			 * @returns
 			 */
 			return window.clearTimeout(id);
-		}
-	});
+		},
+		waitAll: function(/* ... */) {
+			return Promise.all(js.copy_args(arguments).flat().map(p => {
+				if(typeof p === "string" && p.endsWith("ms")) { // for syntax/code that says it all
+					return new Promise(resolve => setTimeout(resolve, parseInt(p, 10)));
+				} else if(typeof p === "number") { // ok, we'll do this too ;-)
+					return new Promise(resolve => setTimeout(resolve, p));
+				} else if(!(p instanceof Promise)) {
+					throw new Error("Can not wait for", p);
+				}
+				return p;
+			}));
+		},	});
 });

package/src/js/extensions.js

@@ -274,10 +274,11 @@ define(function(require) {
 						}
 						s.push(value);
 					} else if(ch === "f") {
-	                    if (mod.charAt(0) === ".") {
-	                        len = parseInt(mod.substring(1), 10) || 0;
+						mod = mod.split(".");
+						if(mod.length === 2) {
+	                        len = parseInt(mod[1], 10) || 0;
 	                        value = arguments[i++];
-	                        var i1 = parseInt(value, 10) || 0;
+	                        var i1 = String.format("%" + mod[0] + "d", value);
 	                        var f = Math.abs(value - i1);
 							f *= Math.pow(10, len + 1);
 							f = "" + Math.round(Math.round(f) / 10);
@@ -375,6 +376,16 @@ define(function(require) {
 		}
 		return n;
 	};
+	Math.f_= (value, regexps) => {
+		if(value === undefined || value === null) return null;
+		
+		regexps = regexps || [/0000+.$/, /9999+.$/];
+
+		value = value.toString();
+		regexps.forEach(re => value = value.replace(re, ""));
+
+		return parseFloat(value);
+	};
 
 
 /*--- */

package/src/util/DocumentHook.js

@@ -18,7 +18,7 @@ define(function(require) {
 			_events: [
 			    "ontransitionend",
 			    "ontouchstart", "ontouchend", "ontouchmove", "ontap", "ondbltap", "ongesture",
-				"onclick", "ondblclick",
+				"onclick", "ondblclick", "onmouseout", "onmouseover",
 				"onmousemove", "onmousedown", "onmouseup", "_onmousewheel", "onmouseenter", "onmouseleave",
 				"onkeydown", "onkeyup", "onkeypress",
 				"onfocus", "onblur",

package/src/util/Xml.js

@@ -1,8 +1,31 @@
 define(function() {
-    
+
+	var prettifyXml = function(sourceXml) {
+	    var xmlDoc = new DOMParser().parseFromString(sourceXml, 'application/xml');
+	    var xsltDoc = new DOMParser().parseFromString([
+	        // describes how we want to modify the XML - indent everything
+	        '<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">',
+	        '  <xsl:strip-space elements="*"/>',
+	        '  <xsl:template match="para[content-style][not(text())]">', // change to just text() to strip space in text nodes
+	        '    <xsl:value-of select="normalize-space(.)"/>',
+	        '  </xsl:template>',
+	        '  <xsl:template match="node()|@*">',
+	        '    <xsl:copy><xsl:apply-templates select="node()|@*"/></xsl:copy>',
+	        '  </xsl:template>',
+	        '  <xsl:output indent="yes"/>',
+	        '</xsl:stylesheet>',
+	    ].join('\n'), 'application/xml');
+	
+	    var xsltProcessor = new XSLTProcessor();    
+	    xsltProcessor.importStylesheet(xsltDoc);
+	    var resultDoc = xsltProcessor.transformToDocument(xmlDoc);
+	    var resultXml = new XMLSerializer().serializeToString(resultDoc);
+	    return resultXml;
+	};
+
     var Xml = {
-        
-        beautify(xml) {
+        beautify: prettifyXml,
+        beautify_(xml) {
             var formatted = "";
             var reg = /(>)(<)(\/*)/g;
             xml = xml.replace(reg, "$1\n$2$3");