cavalion-js 1.0.73 → 1.0.75

package/.md

@@ -1,15 +1,20 @@
 * [CHANGELOG.md]() - [README.md]() - [package.json]()
+* [PROMPT.md]()
 * [.workspace](`(devtools/Workspace<${ws.getSpecializer()}>)`) - [.js]()
 
 
 # cavalion-js
 
+* [openai.com](https://chat.:)
+	* [String Word & Line Counter](https://chat.openai.com/c/01217e42-e74a-4d6a-b327-883ebfb3fa58)
+	* [Setting Up SPA Environment](https://chat.openai.com/c/2ff4e435-dd2d-46e3-a08d-58ccae92ee93)
 * [src](:/)
 	* **[console](src/:/)**
 	* **[data](src/:/)** - [design](src/:/)
 	* **[entities](src/:/)** - [entities.js](src/) - [features](src/:/)
 	* [js](src/:/) / [\_js.js](src/js/:) - [extensions.js](src/js/:) - _[global.js](src/js/:)_? - _[define.js](src/js/:)?_ 
 		- [defineClass.js](src/js/:) - [referenceClass.js](src/js/:) 
+			- [JsObject.js](src/js/:) - [Class.js](src/js/:) 
 		- [json.js](src/:) - [locale.js](src/:) - [text.js](src/:)
 		- [script.js](src/:) - [relscript.js](src/:) 
 		- [stylesheet.js](src/:) 
@@ -47,6 +52,26 @@
 	- [Scaffold.js](src/js/:)
 	- [Type.js](src/js/:)
 
+# `2023/05/23` countWords
+
+String.prototype.countLinesAndWords = function() {
+  const lines = this.split('\n').length;
+  const words = this.split(/\s+/).length;
+  return { lines, words };
+};
+
+// Usage example:
+const text = 'Hello\nWorld!\nThis is a sample text.';
+const { lines, words } = text.countLinesAndWords();
+console.log('Number of lines:', lines);
+console.log('Number of words:', words);
+
+# `2023/05/11` Constructing...
+
+The name of the constructor for vcl/ui/Node.closeable is not correct.
+
+![20230511-091729-jjXuKW](https://raw.githubusercontent.com/relluf/screenshots/master/20230511-091729-jjXuKW.png)
+
 # `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.

package/CHANGELOG.md

@@ -1,4 +1,14 @@
-### 2023/03/01 -  1.0.73
+### 2023/06/30 - 1.0.75
+
+* Introduces locales.mixIn, prefixed.has()
+* Ensures that Printer.prottype.print returns the printed value 
+* Refactores String.escape to use JSON.stringify
+
+### 2023/06/30 - 1.0.74
+
+* Introduces `locale.has()`
+
+### 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

package/PROMPT.md

@@ -0,0 +1,19 @@
+> _I want to document my homemade/written cavalion-js library. It deals with a JavaScript class system and some utility classes for manipulating the DOM, printing to a "in-page console". It must be using code examples a lot._
+
+"From now on, I want you to act as a technical writer and JavaScript expert focusing on library documentation.
+
+We are documenting the 'cavalion-js' library, which is a homemade JavaScript library that provides a class system and utility classes for DOM manipulation and printing to an in-page console.
+
+Start with an overview of the library, explaining its purpose, benefits, and main features. Provide a high-level view of the class system and utility classes it includes. Explain what problems this library solves and why someone might choose to use it over other solutions.
+
+Next, delve into the specifics of the JavaScript class system that 'cavalion-js' implements. Explain how to define classes, inherit from other classes, override methods, and use other features of the class system. Use code examples to illustrate these concepts.
+
+Then, document the utility classes for manipulating the DOM. Provide a comprehensive guide to each class, describing what it does and how to use it. Include code examples for each utility, showing how to perform common tasks like selecting elements, manipulating element attributes, and modifying the DOM structure.
+
+After that, cover the in-page console feature. Explain how it works, how to print messages to it, and any customization options it provides. Again, use code examples to clearly demonstrate its usage.
+
+Also, provide a section on installation and setup instructions for the library, and any other important details like browser compatibility or known issues.
+
+Ensure that the documentation is clear, thorough, and easy to follow. Use a lot of code examples to illustrate how to use the various features of 'cavalion-js.' Provide enough detail so that both novice and experienced JavaScript developers can effectively use the library in their projects.
+
+Throughout this process, use the best practices for writing technical documentation, such as clear language, logical organization, and regular updates as the library evolves."

package/package.json

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

package/src/console/Printer.js

@@ -70,7 +70,6 @@ define(function(require) {
 	});
 
 	var Printer = {
-
 		prototype: {
 			_node: null,
 
@@ -105,6 +104,8 @@ define(function(require) {
 				}
 				this._node.appendChild(line.getNode());
 				this._node.scrollTop = this._node.scrollHeight;
+				
+				return arguments.length > 1 ? arguments[1] : arguments[0];
 			}
 		}
 	};

package/src/js/JsObject.js

@@ -16,9 +16,7 @@ define(function(require) {
 	var JsObject = Class.define;
 
 	return (JsObject = JsObject(require, {
-
 		inherits: Object,
-
 		prototype: {
 
 			'@hashCode': null,
@@ -84,7 +82,6 @@ define(function(require) {
 			    return this;
 			}
 		},
-
 		statics: {
 
 			$: references,

package/src/js/Property.js

@@ -18,10 +18,6 @@ define(function(require) {
 	return (Property = Property(require, {
 
 		prototype: {
-
-			/**
-			 *
-			 */
 			constructor: function(declaringClass, name, decl) {
 				this._declaringClass = declaringClass;
 				this._name = name;
@@ -76,10 +72,6 @@ define(function(require) {
 			getDeclaringClass: function() {
 				return this._declaringClass;
 			},
-
-			/**
-			 *
-			 */
 			getPropertyClass: function() {
 				throw new Error("Unknown class");
 			},
@@ -101,10 +93,6 @@ define(function(require) {
 				}
 				return this._editorClass;
 			},
-
-			/**
-			 *
-			 */
 			getEditorInfo: function(path) {
 				return path === undefined ? this._editorInfo : js.get(path, this._editorInfo || {});
 			},
@@ -168,10 +156,6 @@ define(function(require) {
 			isStrict: function() {
 				return this._strict;
 			},
-
-			/**
-			 *
-			 */
 			isReadOnly: function() {
 				return this.__set === Property.prototype.__set;
 			},
@@ -202,10 +186,6 @@ define(function(require) {
 			get: function(obj) {
 				return this.__get(obj);
 			},
-
-			/**
-			 *
-			 */
 			__get: function(obj) {
 				throw new Error("No getter defined");
 			},
@@ -216,10 +196,6 @@ define(function(require) {
 			set: function(obj, value) {
 				return this.__set(obj, value);
 			},
-
-			/**
-			 *
-			 */
 			__set: function(obj, value) {
 				throw new Error("No setter defined");
 			}
@@ -227,10 +203,6 @@ define(function(require) {
 		},
 
 		statics: {
-
-			/**
-			 *
-			 */
 			isReferencedClass: function(cls) {
 				if(Class.isConstructor(cls)) {
 					if(referencedClasses.indexOf(cls) !== -1) {
@@ -241,10 +213,6 @@ define(function(require) {
 				return false;
 			},
 
-
-			/**
-			 *
-			 */
 			registerReferencedClass: function(cls) {
 				if(Class.isConstructor(cls)) {
 					referencedClasses.push(cls);
@@ -252,10 +220,6 @@ define(function(require) {
 					throw new Error(String.format("%s is not a class constructor"));
 				}
 			},
-
-			/**
-			 *
-			 */
 			initialize: function(property, prop) {
 
 				var ctor = property._declaringClass;
@@ -465,171 +429,83 @@ define(function(require) {
 			},
 
 			GetDefaultValue: {
-
-				/**
-				 *
-				 */
 				VALUE: function(obj) {
 					return this._defaultValue;
 				},
-
-				/**
-				 *
-				 */
 				METHOD: function(obj) {
 					return obj[this._defaultValue]();
 				},
-
-				/**
-				 *
-				 */
 				INLINE: function(obj) {
 					return this._defaultValue.apply(obj, []);
 				}
 			},
-
 			Getter: {
-
-				/**
-				 *
-				 */
 				MEMBER: function(obj) {
 					return obj[this._getter];
 				},
-
-				/**
-				 *
-				 */
 				METHOD: function(obj) {
 					return obj[this._getter]();
 				},
-
-				/**
-				 *
-				 */
 				INLINE: function(obj) {
 					return this._getter.apply(obj, []);
 				}
 			},
 
 			IsAssignable: {
-
-				/**
-				 *
-				 */
 				VALUE: function(obj) {
 					return this._assignable;
 				},
-
-				/**
-				 *
-				 */
 				METHOD: function(obj) {
 					return obj[this._assignable](obj);
 				},
-
-				/**
-				 *
-				 */
 				INLINE: function(obj) {
 					return this._assignable.apply(this, [obj]);
 				}
 			},
-
 			IsEnabled: {
-
-				/**
-				 *
-				 */
 				VALUE: function(obj) {
 					return this._enabled;
 				},
-
-				/**
-				 *
-				 */
 				METHOD: function(obj) {
 					return obj[this._enabled]();
 				},
-
-				/**
-				 *
-				 */
 				INLINE: function(obj) {
 					return this._enabled.apply(obj, []);
 				}
 			},
-
 			IsStored: {
-
-				/**
-				 *
-				 */
 				VALUE: function(obj) {
 					return this.hasDefaultValue(obj) ? false : this._stored;
 				},
-
-				/**
-				 *
-				 */
 				METHOD: function(obj) {
 					return this.hasDefaultValue(obj) ? false : obj[this._stored](obj);
 				},
-
-				/**
-				 *
-				 */
 				INLINE: function(obj) {
 					return this.hasDefaultValue(obj) ? false : this._stored.apply(this, [obj]);
 				}
 			},
-
 			IsVisible: {
-
-				/**
-				 *
-				 */
 				VALUE: function(obj) {
 					return this._visible;
 				},
-
-				/**
-				 *
-				 */
 				METHOD: function(obj) {
 					return obj[this._visible]();
 				},
-
-				/**
-				 *
-				 */
 				INLINE: function(obj) {
 					return this._visible.apply(obj, []);
 				}
 			},
 
 			Setter: {
-
-				/**
-				 *
-				 */
 				MEMBER: function(obj, value) {
 					if(this._strict === true && !Type.isCompatible(this._type, value)) {
 						throw new TypeError(String.format("%s is not a valid %s", value, this._type));
 					}
 					return (obj[this._setter] = value);
 				},
-
-				/**
-				 *
-				 */
 				METHOD: function(obj, value) {
 					return obj[this._setter](value);
 				},
-
-				/**
-				 *
-				 */
 				INLINE: function(obj, value) {
 					return this._setter.apply(obj, [value]);
 				}

package/src/js/extensions.js

@@ -141,18 +141,20 @@ define(function(require) {
 		return r.toLowerCase();
 	};
 	String.escape = function (s) {
+		return JSON.stringify(s).slice(1, -1);
 		/**
 		 *
 		 * @param s
 		 * @returns
 		 */
-		return ('"' + s.replace(/(["\\])/g, '\\$1') + '"').
-			replace(/[\f]/g, "\\f").
-			replace(/[\b]/g, "\\b").
-			replace(/\n/g, "\\n").
-			replace(/[\t]/g, "\\t").
-			replace(/[\r]/g, "\\r");
+		// return ('"' + s.replace(/(["\\])/g, '\\$1') + '"').
+		// 	replace(/[\f]/g, "\\f").
+		// 	replace(/[\b]/g, "\\b").
+		// 	replace(/\n/g, "\\n").
+		// 	replace(/[\t]/g, "\\t").
+		// 	replace(/[\r]/g, "\\r");
 	};
+	String.unescape = (escapedString) => JSON.parse(`"${escapedString}"`);
 	String.escapeHtml = function(s) {
 		/**
 		 *

package/src/js.js

@@ -25,7 +25,7 @@ define(function(require) {
 			} catch(e) {
 				return e;
 			}
-		}
+		}		
 	});
 
 });

package/src/locale.js

@@ -14,7 +14,7 @@ define(function(require) {
 
 	function locale(id) {
     	var loc = locale.loc;//arguments.callee.loc;
-    	
+
     	function resolve(id) {
 			/*- Find in the dictionary */
 	    	var r = window.locale[loc][id], i, nid, dash = id.indexOf("-"), dot = id.indexOf(".");
@@ -157,7 +157,7 @@ define(function(require) {
     		locale.define(prefix, arguments[1]);
     	}
     	
-    	return function(id/*, ... */) {
+    	const prefixed = function(id/*, ... */) {
     		if(arguments.length === 0) {
     			return prefix;
     		}
@@ -171,6 +171,10 @@ define(function(require) {
     		}
     		return locale.apply(this, args);
     	};
+    	
+    	prefixed.has = (id) => locale.has(prefix + id);
+    	
+    	return prefixed;
     };
 	locale.define = function(prefix, defaults) {
 		for(var loc in defaults) {
@@ -184,6 +188,7 @@ define(function(require) {
 			// console.log(2, locale[loc], L);	
 		}
     };
+    locale.has = (key) => locale[locale.loc].hasOwnProperty(key);
     
 	if(typeof window !== "undefined" && typeof window.location !== "undefined") {
 		locale.loc = (location.search.split('locale=')[1]||'').split('&')[0];
@@ -240,6 +245,11 @@ define(function(require) {
         		onLoad(dict);
         	});
         },
+        mixIn: function(dict) {
+        	const dest = locale[locale.loc], proto = {};	
+    		dict = unwrap(js.mi(js.obj2kvp(proto), js.obj2kvp(dict)));
+    		js.mi(dest, dict);
+        },
         define: locale.define
 	};
 });