aotrautils 0.0.1157 → 0.0.1159

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (19/03/2025-20:23:20)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (19/03/2025-23:40:54)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -458,7 +458,7 @@ window.aotestMethods.iterateOverScenariiInTest=function(test, doOnEachIteration=
 	if(!doOnEachIteration)	return;
 	return foreach(test,(scenario,scenarioName)=>{
 		const result=doOnEachIteration(test,scenario,scenarioName);
-		if(result)	return result;
+		if(!nothing(result))	return result;
 	},(scenario,scenarioName)=>{ return window.aotestMethods.isScenarioName(scenarioName); });
 };
 
@@ -1896,6 +1896,7 @@ window.nothing=function(nullable, insist=false){
 	// classical (ie. non-associative) array...:
 // NO : USE empty() instead: 	if(isArray(nullable))	return (nullable.length <= 0);
 	
+	// Case parameter is something :
 	return false;
 }
 
@@ -4425,445 +4426,10 @@ window.clearAttribute=function(tree, attrName, maxLevel=null){
 // =========================================================================
 
 
-
-// Flattening :
-
 window.isFlatMap=function(obj){
 	return typeof(obj[ROOT_UUID])!=="undefined" && obj[ROOT_UUID]!=null;
 };
 
-//CAUTION : KNOWN LIMITATIONS : - Does not handle root-level arrays flattening !
-//															- Does not handle anonymous objects functions and methods population !
-window.getAsFlatStructureImpl=function(rawObject
-		,UUID_ATTR_NAME=DEFAULT_UUID_ATTR_NAME/* Yet Another UUID */
-		,CLASSNAME_ATTR_NAME=DEFAULT_CLASSNAME_ATTR_NAME/* Yet Another Classname */
-		,POINTER_TO_ATTR_NAME=DEFAULT_POINTER_TO_ATTR_NAME/* Yet Another PointerTo */
-		){
-	
-		
-		// CAUTION «()=>{}» syntax does not work with methods referring «this» in attributes or methods!
-//	window.objectsRegistry={
-		var objectsRegistry={
-			map:{}, // This map will point to the original objects
-			registerIfNeeded:function(obj){
-				if(this.isRegistered(obj))	return false;
-				this.registerNewObject(obj);
-				return true;
-			},
-			/* private */isRegistered:function(obj){
-				let uuid=obj[UUID_ATTR_NAME];
-				if(!uuid)	return false;
-				let foundObject=this.map[uuid];
-				return typeof(foundObject)!=="undefined" && foundObject;
-			},
-			/* private */registerNewObject:function(obj){
-				let newUUID=(empty(this.map) ? ROOT_UUID : getUUID());
-				obj[UUID_ATTR_NAME]=newUUID;
-				this.map[newUUID]=obj;
-			}
-		};
-//	}
-
-	// var objectsRegistry=window.objectsRegistry;
-	// // We reinit the registry map :
-	// objectsRegistry.map={};
-	
-	// 1) First, we sort up the original structure in the registry and give them all uuids :
-	registerObject(objectsRegistry,rawObject, UUID_ATTR_NAME
-//			,CLASSNAME_ATTR_NAME
-			);
-
-//	 // DBG
-//	 console.log("¬¬¬¬objectsRegistry.map",objectsRegistry.map);
-	
-	
-	// 2) Second, we flatten the javascript structure.
-	let workingOriginalObjectsMap=objectsRegistry.map;
-
-	let resultMap={};
-
-	// We browse through the registry tree map to create the flat new copied structure :
-	foreach(workingOriginalObjectsMap,(workingOriginalObject, uuid)=>{
-		
-		addInFlatMapAndReplaceObjectsWithPointers(resultMap,workingOriginalObject,uuid
-				,UUID_ATTR_NAME,CLASSNAME_ATTR_NAME,POINTER_TO_ATTR_NAME);
-		
-	});
-
-	
-	// Then we remove the technical attributes in the original objects :
-	foreach(workingOriginalObjectsMap,(workingOriginalObject)=>{
-		delete workingOriginalObject[UUID_ATTR_NAME];
-	});
-
-	
-// CANNOT USE stringifyObject(...) function because we are in a common, lower-level library !
-	
-	return resultMap;
-};
-
-
-// (recursively called function)
-/*private*/window.registerObject=function(objectsRegistry,rawObject,UUID_ATTR_NAME
-//		,CLASSNAME_ATTR_NAME
-		){
-
-	if(rawObject==null)
-		return;
-	
-	
-	if(isPrimitive(rawObject) 
-			|| isArray(rawObject)
-			){
-		return;
-	}
-
-	
-//	// DBG
-//	console.log(">>>REGISTER OBJECT:",rawObject);
-	
-	
-	// We add the object to the registry if it is encoutered for the first time :
-	var hasBeenRegistered=objectsRegistry.registerIfNeeded(rawObject);
-	
-	// If object is already present, then we stop here.
-	if(!hasBeenRegistered)	return;
-	
-	
-	// We browse through the subObjects in the structure, to register them :
-	foreach(rawObject,(subObject)=>{
-		
-		
-		if(isArray(subObject)){
-			
-			foreach(subObject,(item)=>{
-				
-			// We add the object to the registry :
-				registerObject(objectsRegistry,item, UUID_ATTR_NAME);
-				
-			},(item)=>{ return isObject(item); });
-			
-
-		}else{
-			
-			// We add the object to the registry :
-			registerObject(objectsRegistry, subObject, UUID_ATTR_NAME);
-
-		}
-
-	}
-	// DBG
-	,(subObject)=>{ return isArray(subObject) || isObject(subObject); }
-);
-	
-	
-	
-};
-
-//(recursively called function)
-/*private*/window.addInFlatMapAndReplaceObjectsWithPointers=function(resultMap,workingOriginalObject,uuid
-		,UUID_ATTR_NAME,CLASSNAME_ATTR_NAME,POINTER_TO_ATTR_NAME){
-	
-	if(workingOriginalObject==null)
-		return;
-	
-	let isAlreadyInNewMap=(resultMap[uuid]!=null);
-	if(isAlreadyInNewMap || workingOriginalObject[POINTER_TO_ATTR_NAME]!=null)
-		return;
-	
-	
-	// The new object is added to the flat map :
-	// (We don't care to set the real class here, because this object will have a JSONtype attribute in the end. This new result object will be a pure JSON information.)
-	// OLD AND BOGUS (SERIOUSLY, DON'T USE IT ANYMORE !) : let result=cloneObjectShallow(workingOriginalObject, null, true);
-	let result=structuredClone(workingOriginalObject);
-
-	
-	// We set the class name to the new result object :
-	let className=getClassName(workingOriginalObject);
-	if(className!=="Array"){ // No need to indicate that this JSON object is an array, since "[" indicates it by the JSON language definition.
-		result[CLASSNAME_ATTR_NAME]=className;
-	}
-	
-	
-//	// DBG
-//	console.log("result[CLASSNAME_ATTR_NAME]",result[CLASSNAME_ATTR_NAME]);
-	
-	
-	// We add the result to the flat map :
-	resultMap[uuid]=result;
-
-	
-	
-	// Attributes processing :
-	foreach(workingOriginalObject,(workingAttr, attrName)=>{
-		
-		
-		// We replace the actual reference to a pointer to this reference :
-		if(isArray(workingAttr)){
-			
-			result[attrName]=[];
-
-			
-			// Array items :
-			foreach(workingAttr,(item,i)=>{
-
-				if(item==null){
-					result[attrName].push(null);
-					return "continue";
-				}
-				// WE ALWAYS SKIP THE FUNCTIONS !
-				if(isFunction(item)){
-					return "continue";
-				}
-				
-				if(isPrimitive(item)
-				|| isArray(item)){
-
-//					// DBG
-//					console.log("%%% workingAttr:",workingAttr);
-//					console.log("%%% result:",result);
-//					console.log("%%% attrName:",attrName);
-//					console.log("%%% item:",item);
-					
-					result[attrName].push(item);
-					return "continue";
-				}
-
-				
-				let attrInArrayUUID=item[UUID_ATTR_NAME];
-				if(attrInArrayUUID==null){
-					
-//					// DBG
-//					console.log("isObject(item)",isObject(item));
-//					console.log("isString(item)",isString(item));
-//					console.log("typeof(item)",typeof(item));
-//					console.log("item",item);
-					
-					
-					// TRACE
-					console.log("ERROR : Attribute «"+item+"» in array should have a uuid under the member name «"+UUID_ATTR_NAME+"» but has none !" +
-							" Complete attribute object :", workingAttr);
-					return "continue";
-				}
-
-
-				let simpleRef={};
-				simpleRef[POINTER_TO_ATTR_NAME]=attrInArrayUUID;
-				
-				
-				
-				result[attrName].push(simpleRef);
-				
-				
-				// We add the result to the flat map :
-				addInFlatMapAndReplaceObjectsWithPointers(resultMap,item,attrInArrayUUID
-						,UUID_ATTR_NAME,CLASSNAME_ATTR_NAME,POINTER_TO_ATTR_NAME);
-				
-					
-				
-			});
-			
-
-		}else{
-			
-			if(workingAttr==null){
-				result[attrName]=null;
-				return "continue";
-			}
-			// WE ALWAYS SKIP THE FUNCTIONS !
-			if(isFunction(workingAttr)){
-				return "continue";
-			}
-			if(!isObject(workingAttr)){
-				result[attrName]=workingAttr;
-				return "continue";
-			}
-
-	
-			let attrUUID=workingAttr[UUID_ATTR_NAME];
-			if(attrUUID==null){
-				// TRACE
-				console.log("ERROR : Attribute «"+attrName+"» should have a uuid under the member name «"+UUID_ATTR_NAME+"» but has none !"
-							+" Complete attribute object :", workingAttr
-						);
-				return "continue";
-			}
-		
-			let simpleRef={};
-			simpleRef[POINTER_TO_ATTR_NAME]=attrUUID;
-		
-		
-			result[attrName]=simpleRef;
-
-			
-			// We add the result to the flat map :
-			addInFlatMapAndReplaceObjectsWithPointers(resultMap,workingAttr,attrUUID
-					,UUID_ATTR_NAME,CLASSNAME_ATTR_NAME,POINTER_TO_ATTR_NAME);
-			
-			
-		}
-		
-		
-		
-	});
-	
-	
-
-	return result;
-	
-};
-
-
-// --------------------------------
-// --------------------------------
-
-// Unflattening :
-
-
-// CAUTION : KNOWN LIMITATIONS : - Does not handle root-level arrays flattening !
-//															 - Does not handle anonymous objects functions and methods population !
-window.getAsTreeStructureImpl=function(oldMap, removeTypeInfo=true
-		,UUID_ATTR_NAME=DEFAULT_UUID_ATTR_NAME/* Yet Another UUID */
-		,CLASSNAME_ATTR_NAME=DEFAULT_CLASSNAME_ATTR_NAME/* Yet Another Classname */
-		,POINTER_TO_ATTR_NAME=DEFAULT_POINTER_TO_ATTR_NAME/* Yet Another PointerTo */
-){
-	
-	// We have in input a map of the following form :
-	// { ("a uuid" : {(non-object attributes key-value pairs)*, (object attributes
-	// as : {<POINTER_TO_ATTR_NAME> : "a uuid"} )*}) }
-
-	if(typeof(oldMap)==="string"){
-		oldMap=parseJSON(oldMap);
-//	oldMap=parseJSON(oldMap.replace(/"/gim,"'"));
-//	oldMap=eval(oldMap);
-	}
-	
-	
-	let resultMap={};
-	
-	// First we clone the existing flat map :
-	foreach(oldMap,(oldObj,uuid)=>{
-		
-		let className=oldObj[CLASSNAME_ATTR_NAME];
-		
-		
-//		// DBG
-//		if(className["JSONref"]){
-//			// DBG
-//			console.log("aaaaaaaaaaaaaaa oldObj:",oldObj);
-//		}
-		
-		// OLD AND BOGUS (SERIOUSLY, DON'T USE IT ANYMORE !) : let newObj=cloneObjectShallow(oldObj, stateOnly, className);
-		let newObj=structuredClone(oldObj);
-		
-		
-//		// DBG
-//		console.log(";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;");
-//		console.log(";;;;;;;;;newObj",newObj);
-//		console.log(";;;;;;;;;resultMap",resultMap);
-//		console.log(";;;;;;;;;attrName",attrName);
-//		console.log(";;;;;;;;;newAttr",newAttr);
-		
-		
-		resultMap[uuid]=newObj;
-		
-		// Then we browse the whole flat map and we remove the technical attributes if wished :
-		let objectToClean=resultMap[uuid];
-		// We always remove the uuid ! (to allow other next flattenings / unflattening cycles)
-		delete objectToClean[UUID_ATTR_NAME];
-		if(removeTypeInfo){
-			delete objectToClean[CLASSNAME_ATTR_NAME];
-
-		}
-
-	});
-	
-
-	
-	// Second we replace all the references with pointers to the live objects :
-	foreach(resultMap,(newObj,uuid)=>{
-		
-		// Attributes processing :
-		foreach(newObj,(newAttr,attrName)=>{
-						
-
-			
-			
-			if(newAttr==null){
-				newObj[attrName]=null;
-				return "continue";
-			}
-			
-			if(isArray(newAttr)){
-				
-					newObj[attrName]=[];
-
-					
-					foreach(newAttr,(itemInArray)=>{
-											
-						// In case non-pointer type objects are also presents in the array :
-						// At this point, we should have only primitite-ish types items :
-						if( itemInArray==null
-								|| !isObject(itemInArray)
-								|| isArray(itemInArray)
-								|| itemInArray[POINTER_TO_ATTR_NAME]==null){
-							
-							newObj[attrName].push(itemInArray);
-							return "continue";
-						}
-						
-						
-						// Pointer-type objects :
-						let uuidTo=itemInArray[POINTER_TO_ATTR_NAME];
-						let foundObjectToInNewMap=resultMap[uuidTo];
-						
-						if(!foundObjectToInNewMap){
-							// If we haven't found the object in the new map yet :
-							// TRACE
-							console.log("ERROR : We could'nt find the object referenced  by this uuid «"+uuidTo+"» anywhere, for attribute of name «"+attrName+"». This should NEVER happen.");
-						}else{
-							newObj[attrName].push(foundObjectToInNewMap);
-						}
-					
-						
-						
-					});
-					
-					
-					
-			}else{
-			
-				let uuidTo=newAttr[POINTER_TO_ATTR_NAME];
-				let foundObjectToInNewMap=resultMap[uuidTo];
-									
-				// If object has already been entered in new map :
-				if(!foundObjectToInNewMap){
-					// If we haven't found the object in the new map yet :
-					// TRACE
-					console.log("ERROR : We could'nt find the object referenced  by this uuid «"+uuidTo+"» anywhere, for attribute of name «"+attrName+"». This should NEVER happen.");
-				}else{
-					//
-					newObj[attrName]=foundObjectToInNewMap;
-				}
-			
-			}
-			
-		},(newAttr)=>{
-				return newAttr==null || isArray(newAttr) || (isObject(newAttr) && newAttr[POINTER_TO_ATTR_NAME]!=null);
-		});
-		
-	});
-	
-	
-	
-	// (We actually only return the first object, for it is the root object)
-	const r=getAt(resultMap,0);
-	return r;
-};
-
-
-
-
 
 // ----------------------------------------------------------------
 // ----------------------------------------------------------------
@@ -4874,6 +4440,9 @@ window.getAsFlatStructure=function(rawObject
 		,CLASSNAME_ATTR_NAME=DEFAULT_CLASSNAME_ATTR_NAME/* Yet Another Classname */
 		,POINTER_TO_ATTR_NAME=DEFAULT_POINTER_TO_ATTR_NAME/* Yet Another PointerTo */
 		){
+// Flattening :
+// OLD : KNOWN LIMITATIONS : - Does not handle root-level arrays flattening !
+//													 - Does not handle anonymous objects functions and methods population !
 	// OLD : return getAsFlatStructureImpl(rawObject,UUID_ATTR_NAME, CLASSNAME_ATTR_NAME, POINTER_TO_ATTR_NAME);
 	return flattenGraph(rawObject, UUID_ATTR_NAME, CLASSNAME_ATTR_NAME, POINTER_TO_ATTR_NAME);
 };
@@ -4923,8 +4492,10 @@ window.getAsTreeStructure=function(oldMap, keepClassName=false
 		,POINTER_TO_ATTR_NAME=DEFAULT_POINTER_TO_ATTR_NAME/* Yet Another PointerTo */
 ){
 
-	// MAYBE DEPRECATED USE JSON.recycle(...) INSTEAD !
-	//return getAsTreeStructureImpl(oldMap, !keepClassName, UUID_ATTR_NAME, CLASSNAME_ATTR_NAME, POINTER_TO_ATTR_NAME);
+// Unflattening :
+// OLD : KNOWN LIMITATIONS : - Does not handle root-level arrays flattening !
+//													 - Does not handle anonymous objects functions and methods population !
+	// OLD :return getAsTreeStructureImpl(oldMap, !keepClassName, UUID_ATTR_NAME, CLASSNAME_ATTR_NAME, POINTER_TO_ATTR_NAME);
 	return restoreGraph(oldMap, keepClassName, UUID_ATTR_NAME, CLASSNAME_ATTR_NAME, POINTER_TO_ATTR_NAME);
 };
 
@@ -5245,7 +4816,7 @@ AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (19/03/2025-20:23:20)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (19/03/2025-23:40:54)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -13817,7 +13388,7 @@ getAORTACClient=function(clientId=getUUID(), serverNodeOrigin="ws://127.0.0.1:40
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (19/03/2025-20:23:20)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (19/03/2025-23:40:54)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -15056,7 +14627,7 @@ function rayVsUnitSphereClosestPoint(p, r) {
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
 AOTRAUTILS_GEOMETRY_LIB_IS_LOADED=true;
-/*utils AI library associated with aotra version : «1_29072022-2359 (19/03/2025-20:23:20)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (19/03/2025-23:40:54)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -15200,7 +14771,7 @@ getOpenAIAPIClient=(modelName, apiURL, agentRole, defaultPrompt)=>{
 
 
 
-/*utils SERVER library associated with aotra version : «1_29072022-2359 (19/03/2025-20:23:20)»*/
+/*utils SERVER library associated with aotra version : «1_29072022-2359 (19/03/2025-23:40:54)»*/
 /*-----------------------------------------------------------------------------*/
 
 

aotrautils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.1157",
+	"version": "0.0.1159",
 	"main": "aotrautils.build.js",
 	"description": "A library for vanilla javascript utils (client-side) used in aotra javascript CMS",
 	"author": "Jeremie Ratomposon <info@alqemia.com> (https://alqemia.com)",