aotrautils 0.0.1839 → 0.0.1841

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (05/04/2026-12:31:28)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (09/04/2026-01:44:04)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -4117,13 +4117,30 @@ window.instanciate=function(className=null){
 	if(className==="Array")	return [];
 
 	
-	const classInWindow=window[className];
-	if(!classInWindow){
+	let classInWindow=globalThis[className];
+	if(typeof(classInWindow)=="undefined"){
 		// TRACE
-		lognow(`WARN : CAUTION : «${className}» class does not seem to be registered in the global window object. This can lead to problems instanciating it in a pure nodejs context.`);
+		lognow(`WARN : CAUTION : «${className}» class does not seem to be registered in the globalThis object. This can lead to problems instanciating it in a pure nodejs context.`);
+		classInWindow=window[className];
+		if(typeof(classInWindow)=="undefined"){
+			// TRACE
+			lognow(`WARN : CAUTION : «${className}» class does not seem to be registered in the window object. This can lead to problems instanciating it in a pure nodejs context.`);
+			if(typeof(global)!="undefined"){
+				lognow(`WARN : Trying with global object...`);
+				classInWindow=global[className];
+				if(!classInWindow){
+					// TRACE
+					lognow(`ERROR : CAUTION : «${className}» class does not seem to be registered in the global object. Cannot instanciate it.`);
+					return newObj;
+				}
+			}else{
+				// TRACE
+				lognow(`ERROR : CAUTION : «${className}» class does not seem to be accessible in the globalThis nor window object, and global object does not exist. Cannot instanciate it.`);
+				return newObj;
+			}
+		}
 	}
 
-	
 // OLD :
 //	try{
 //		try{
@@ -4162,6 +4179,7 @@ window.instanciate=function(className=null){
 //		}
 //	}
 
+	// NEW :
 	newObj=new classInWindow();
 	return newObj;
 };
@@ -5117,6 +5135,264 @@ window.getPathFileName=(path, fileSeparator="/", removeExtension=false)=>{
 }
 
 
+// -------------------------------------------------------------------------
+// ====================================================== ROUTINES ======================================================
+
+
+// ======================== Timeout ========================
+
+// CAUTION : This is not a routine, but a single-use timeout !
+window.MonoThreadedTimeout=class {
+	constructor(actuator, delayMillis){
+		this.actuator=actuator;
+	}
+	start(delayMillis=null){
+		this.started=true;
+		this.time=getNow();
+		this.delayMillis=delayMillis;
+	}
+	doStep(args=null){
+		if(!this.started)	return;
+		if(!hasDelayPassed(this.time, this.delayMillis))	return;
+		return this.stop(args);
+	}
+	stop(args=null){
+		if(!this.started)	return;
+		this.started=false;
+		if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
+		return this;
+	}
+}
+
+window.getMonoThreadedTimeout=function(actuator=null){
+	return new MonoThreadedTimeout(actuator);
+}
+
+
+// ======================== Routine ========================
+
+window.MonoThreadedRoutine=class {
+	constructor(actuator,refreshMillis=null,startDependsOnParentOnly=false){
+
+		this.actuator=actuator;
+		this.startDependsOnParentOnly=startDependsOnParentOnly;
+		this.started=false;
+		this.paused=false;
+		this.time=getNow();
+		this.refreshMillis=refreshMillis;
+		
+		this.durationTimeFactorHolder={durationTimeFactor:1};
+		// Three-states : started, paused, stopped.
+
+	}
+	
+	setDurationTimeFactorHolder(durationTimeFactorHolder){
+		this.durationTimeFactorHolder=durationTimeFactorHolder;
+		return this;
+	}
+	isStarted(){
+		return this.started || this.startDependsOnParentOnly;
+	}
+	start(args=null){
+		// if(this.isStarted()) return;
+		if(this.actuator.terminateFunction && this.actuator.terminateFunction(args)){
+			// CAUTION : Even if the routine is «pre-terminated» before even starting 
+			// (ie. its stop conditions are fullfilled even before it has started)
+			// we all the same have to trigger its stop treatments :
+			if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
+			return;
+		}
+		this.started=true;
+		this.paused=false;
+		return this;
+	}
+	stop(args=null){
+		if(!this.isStarted())	return;
+		this.started=false;
+		if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
+	}
+	pause(args=null){
+		this.paused=true;
+		if(this.actuator.doOnSuspend)	this.actuator.doOnSuspend(args);
+	}
+	resume(args=null){
+		this.paused=false;
+		if(this.actuator.doOnResume)	this.actuator.doOnResume(args);
+	}
+	isPaused(){
+		return this.paused;
+	}
+	doStep(args=null){
+		if(!this.isStarted() || this.paused)	return;
+		// Looping index with a delay :
+		
+		const delayHasPassed=hasDelayPassed(this.time, this.refreshMillis*this.durationTimeFactorHolder.getDurationTimeFactor());
+		if(!this.refreshMillis || delayHasPassed){
+			if(this.refreshMillis && delayHasPassed){
+				this.time=getNow();
+			}
+			// We perform the step :
+			if(this.actuator.terminateFunction && this.actuator.terminateFunction(args)){
+				this.stop(args);
+				return;
+			}
+			if(this.actuator.doOnEachStep)	this.actuator.doOnEachStep(args);
+		}
+		
+	}
+	
+}
+
+
+window.getMonoThreadedRoutine=function(actuator, refreshMillis=null, startDependsOnParentOnly=false){
+	return new MonoThreadedRoutine(actuator, refreshMillis, startDependsOnParentOnly);
+}
+
+
+window.MonoThreadedGoToGoal=class {
+	constructor(actuator,actualValue,goalValue,refreshMillis=null,totalTimeMillis=1000,mode="linear"){
+		
+		this.actuator=actuator;
+		
+		this.actualValue=actualValue;
+		this.mode=mode;
+		this.totalTimeMillis=totalTimeMillis;
+		this.stepValue=((refreshMillis*(goalValue-actualValue))/totalTimeMillis);
+		this.value=actualValue;
+		this.goalValue=goalValue;
+		this.started=false;
+		this.paused=false;
+		this.time=getNow();
+		this.refreshMillis=refreshMillis;
+		
+		this.durationTimeFactorHolder={durationTimeFactor:1};
+	
+		// Three-states : started, paused, stopped.
+	}
+	setDurationTimeFactorHolder(durationTimeFactorHolder){
+		this.durationTimeFactorHolder=durationTimeFactorHolder;
+		
+		// We recalculate total time-dependent values :
+		this.totalTimeMillis=this.totalTimeMillis*this.durationTimeFactorHolder.getDurationTimeFactor();
+		this.stepValue=((this.refreshMillis*(this.goalValue-this.actualValue))/this.totalTimeMillis);
+
+		return this;
+	}
+	isStarted(){
+		return this.started || this.startDependsOnParentOnly;
+	}
+	resetValueAndGoalTo(resetValue){
+		this.value=resetValue;
+		this.goalValue=resetValue;
+		return this;
+	}
+	setNewGoal(goalValue, refreshMillisParam=null, totalTimeMillis=null){
+		if(Math.round(this.value)===Math.round(goalValue))	return;
+		if(refreshMillisParam)	this.refreshMillis=refreshMillisParam;
+		if(totalTimeMillis)			this.totalTimeMillis=totalTimeMillis*this.durationTimeFactorHolder.getDurationTimeFactor();
+
+		this.goalValue=goalValue;
+		this.stepValue=((this.refreshMillis*(this.goalValue-this.value))/this.totalTimeMillis);
+		
+		if(!this.isStarted())	this.start();
+			
+		return this;
+	}
+	start(args=null){
+		
+		if(    this.value===this.goalValue
+		//  || this.isStarted();
+				|| (this.actuator.terminateFunction && this.actuator.terminateFunction())
+				|| this.hasReachedGoal()){
+
+			// CAUTION : Even if the routine is «pre-terminated» before even starting 
+			// (ie. its stop conditions are fullfilled even before it has started)
+			// we all the same have to trigger its stop treatments :
+			if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
+
+			return;
+		}
+		this.started=true;
+		this.paused=false;
+		
+		return this;
+	}
+	stop(args=null){
+		if(!this.isStarted())	return;
+		this.started=false;
+		if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
+	}
+	pause(){
+		this.paused=true;
+	}
+	resume(){
+		this.paused=false;
+	}
+	hasReachedGoal(){
+		if(this.stepValue<0){
+			if(this.value<=this.goalValue)	return true;
+		}else{
+			if(this.goalValue<=this.value)	return true;
+		}
+		return false;
+	}
+	
+	doStep(args=null){
+		if(!this.isStarted() || this.paused)	return this.value;
+
+		// Looping index with a delay :
+		
+		if(!this.refreshMillis || this.hasDelayPassed()){
+			if(this.refreshMillis && this.hasDelayPassed()){
+				this.time=getNow();
+			}
+			
+			// We check if we must stop :
+			if(this.actuator.terminateFunction){
+				if(this.actuator.terminateFunction()){
+					this.stop();
+					this.value=this.goalValue;
+					return this.value;
+				}
+			}else{
+				if(this.hasReachedGoal()){
+					this.stop();
+					this.value=this.goalValue;
+					return this.value;
+				}
+			}
+			
+			// We perform the step :
+			if(this.mode==="exponential"){
+				this.value+=Math.pow(this.stepValue,2);
+			}else{ // default is "linear"
+				this.value+=this.stepValue;
+			}
+			
+			if(this.actuator.doOnEachStep)	this.actuator.doOnEachStep(args);
+		}
+		
+		return this.value;
+	}
+	
+	hasDelayPassed(){
+		return (!this.time || hasDelayPassed(this.time, this.refreshMillis*this.durationTimeFactorHolder.getDurationTimeFactor()));
+	}
+
+	
+}
+
+
+window.getMonoThreadedGoToGoal=function(actuator,actualValue,goalValue,refreshMillis=null,totalTimeMillis=1000,mode="linear"){
+	return new MonoThreadedGoToGoal(actuator,actualValue,goalValue,refreshMillis,totalTimeMillis,mode);
+}
+
+
+// =====================================================================================================================
+
+// -------------------------------------------------------------------------
+
+
 
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
@@ -5126,7 +5402,7 @@ AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (05/04/2026-12:31:28)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (09/04/2026-01:44:04)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -9320,260 +9596,6 @@ function getSpriteMonoThreaded(imagesPool,/*OPTIONAL*/refreshMillis=null,
 		zoomsParam);
 }
 
-// ====================================================== ROUTINES ======================================================
-
-
-// ======================== Timeout ========================
-
-// CAUTION : This is not a routine, but a single-use timeout !
-class MonoThreadedTimeout{
-	constructor(actuator, delayMillis){
-		this.actuator=actuator;
-	}
-	start(delayMillis=null){
-		this.started=true;
-		this.time=getNow();
-		this.delayMillis=delayMillis;
-	}
-	doStep(args=null){
-		if(!this.started)	return;
-		if(!hasDelayPassed(this.time, this.delayMillis))	return;
-		return this.stop(args);
-	}
-	stop(args=null){
-		if(!this.started)	return;
-		this.started=false;
-		if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
-		return this;
-	}
-}
-
-function getMonoThreadedTimeout(actuator=null){
-	return new MonoThreadedTimeout(actuator);
-}
-
-
-// ======================== Routine ========================
-
-class MonoThreadedRoutine{
-	constructor(actuator,refreshMillis=null,startDependsOnParentOnly=false){
-
-		this.actuator=actuator;
-		this.startDependsOnParentOnly=startDependsOnParentOnly;
-		this.started=false;
-		this.paused=false;
-		this.time=getNow();
-		this.refreshMillis=refreshMillis;
-		
-		this.durationTimeFactorHolder={durationTimeFactor:1};
-		// Three-states : started, paused, stopped.
-
-	}
-	
-	setDurationTimeFactorHolder(durationTimeFactorHolder){
-		this.durationTimeFactorHolder=durationTimeFactorHolder;
-		return this;
-	}
-	isStarted(){
-		return this.started || this.startDependsOnParentOnly;
-	}
-	start(args=null){
-		// if(this.isStarted()) return;
-		if(this.actuator.terminateFunction && this.actuator.terminateFunction(args)){
-			// CAUTION : Even if the routine is «pre-terminated» before even starting 
-			// (ie. its stop conditions are fullfilled even before it has started)
-			// we all the same have to trigger its stop treatments :
-			if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
-			return;
-		}
-		this.started=true;
-		this.paused=false;
-		return this;
-	}
-	stop(args=null){
-		if(!this.isStarted())	return;
-		this.started=false;
-		if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
-	}
-	pause(args=null){
-		this.paused=true;
-		if(this.actuator.doOnSuspend)	this.actuator.doOnSuspend(args);
-	}
-	resume(args=null){
-		this.paused=false;
-		if(this.actuator.doOnResume)	this.actuator.doOnResume(args);
-	}
-	isPaused(){
-		return this.paused;
-	}
-	doStep(args=null){
-		if(!this.isStarted() || this.paused)	return;
-		// Looping index with a delay :
-		
-		const delayHasPassed=hasDelayPassed(this.time, this.refreshMillis*this.durationTimeFactorHolder.getDurationTimeFactor());
-		if(!this.refreshMillis || delayHasPassed){
-			if(this.refreshMillis && delayHasPassed){
-				this.time=getNow();
-			}
-			// We perform the step :
-			if(this.actuator.terminateFunction && this.actuator.terminateFunction(args)){
-				this.stop(args);
-				return;
-			}
-			if(this.actuator.doOnEachStep)	this.actuator.doOnEachStep(args);
-		}
-		
-	}
-	
-}
-
-
-function getMonoThreadedRoutine(actuator, refreshMillis=null, startDependsOnParentOnly=false){
-	return new MonoThreadedRoutine(actuator, refreshMillis, startDependsOnParentOnly);
-}
-
-
-class MonoThreadedGoToGoal{
-	constructor(actuator,actualValue,goalValue,refreshMillis=null,totalTimeMillis=1000,mode="linear"){
-		
-		this.actuator=actuator;
-		
-		this.actualValue=actualValue;
-		this.mode=mode;
-		this.totalTimeMillis=totalTimeMillis;
-		this.stepValue=((refreshMillis*(goalValue-actualValue))/totalTimeMillis);
-		this.value=actualValue;
-		this.goalValue=goalValue;
-		this.started=false;
-		this.paused=false;
-		this.time=getNow();
-		this.refreshMillis=refreshMillis;
-		
-		this.durationTimeFactorHolder={durationTimeFactor:1};
-	
-		// Three-states : started, paused, stopped.
-	}
-	setDurationTimeFactorHolder(durationTimeFactorHolder){
-		this.durationTimeFactorHolder=durationTimeFactorHolder;
-		
-		// We recalculate total time-dependent values :
-		this.totalTimeMillis=this.totalTimeMillis*this.durationTimeFactorHolder.getDurationTimeFactor();
-		this.stepValue=((this.refreshMillis*(this.goalValue-this.actualValue))/this.totalTimeMillis);
-
-		return this;
-	}
-	isStarted(){
-		return this.started || this.startDependsOnParentOnly;
-	}
-	resetValueAndGoalTo(resetValue){
-		this.value=resetValue;
-		this.goalValue=resetValue;
-		return this;
-	}
-	setNewGoal(goalValue, refreshMillisParam=null, totalTimeMillis=null){
-		if(Math.round(this.value)===Math.round(goalValue))	return;
-		if(refreshMillisParam)	this.refreshMillis=refreshMillisParam;
-		if(totalTimeMillis)			this.totalTimeMillis=totalTimeMillis*this.durationTimeFactorHolder.getDurationTimeFactor();
-
-		this.goalValue=goalValue;
-		this.stepValue=((this.refreshMillis*(this.goalValue-this.value))/this.totalTimeMillis);
-		
-		if(!this.isStarted())	this.start();
-			
-		return this;
-	}
-	start(args=null){
-		
-		if(    this.value===this.goalValue
-		//  || this.isStarted();
-				|| (this.actuator.terminateFunction && this.actuator.terminateFunction())
-				|| this.hasReachedGoal()){
-
-			// CAUTION : Even if the routine is «pre-terminated» before even starting 
-			// (ie. its stop conditions are fullfilled even before it has started)
-			// we all the same have to trigger its stop treatments :
-			if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
-
-			return;
-		}
-		this.started=true;
-		this.paused=false;
-		
-		return this;
-	}
-	stop(args=null){
-		if(!this.isStarted())	return;
-		this.started=false;
-		if(this.actuator.doOnStop)	this.actuator.doOnStop(args);
-	}
-	pause(){
-		this.paused=true;
-	}
-	resume(){
-		this.paused=false;
-	}
-	hasReachedGoal(){
-		if(this.stepValue<0){
-			if(this.value<=this.goalValue)	return true;
-		}else{
-			if(this.goalValue<=this.value)	return true;
-		}
-		return false;
-	}
-	
-	doStep(args=null){
-		if(!this.isStarted() || this.paused)	return this.value;
-
-		// Looping index with a delay :
-		
-		if(!this.refreshMillis || this.hasDelayPassed()){
-			if(this.refreshMillis && this.hasDelayPassed()){
-				this.time=getNow();
-			}
-			
-			// We check if we must stop :
-			if(this.actuator.terminateFunction){
-				if(this.actuator.terminateFunction()){
-					this.stop();
-					this.value=this.goalValue;
-					return this.value;
-				}
-			}else{
-				if(this.hasReachedGoal()){
-					this.stop();
-					this.value=this.goalValue;
-					return this.value;
-				}
-			}
-			
-			// We perform the step :
-			if(this.mode==="exponential"){
-				this.value+=Math.pow(this.stepValue,2);
-			}else{ // default is "linear"
-				this.value+=this.stepValue;
-			}
-			
-			if(this.actuator.doOnEachStep)	this.actuator.doOnEachStep(args);
-		}
-		
-		return this.value;
-	}
-	
-	hasDelayPassed(){
-		return (!this.time || hasDelayPassed(this.time, this.refreshMillis*this.durationTimeFactorHolder.getDurationTimeFactor()));
-	}
-
-	
-}
-
-
-function getMonoThreadedGoToGoal(actuator,actualValue,goalValue,refreshMillis=null,totalTimeMillis=1000,mode="linear"){
-	return new MonoThreadedGoToGoal(actuator,actualValue,goalValue,refreshMillis,totalTimeMillis,mode);
-}
-
-
-// =====================================================================================================================
-
 
 //if signed :
 //when precision==1/10000, range is -3.2766 to 3.2766
@@ -13206,7 +13228,7 @@ createOritaMicroClient=function(url, port, isNode=false, staticMicroClientIdPara
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (05/04/2026-12:31:28)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (09/04/2026-01:44:04)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14535,10 +14557,10 @@ function rayVsUnitSphereClosestPoint(p, r) {
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
 AOTRAUTILS_GEOMETRY_LIB_IS_LOADED=true;
-/*utils 3D library associated with aotra version : «1_29072022-2359 (05/04/2026-12:31:28)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (09/04/2026-01:44:04)»*/
 /*-----------------------------------------------------------------------------*/
 
-/*utils AI library associated with aotra version : «1_29072022-2359 (05/04/2026-12:31:28)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (09/04/2026-01:44:04)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14684,7 +14706,7 @@ getOpenAIAPIClient=(modelName, apiURL, agentRole, defaultPrompt)=>{
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (05/04/2026-12:31:28)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (09/04/2026-01:44:04)»*/
 /*-----------------------------------------------------------------------------*/
 
 

aotrautils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.1839",
+	"version": "0.0.1841",
 	"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)",