@yuneta/gobj-js 7.9.9 → 7.9.11

package/dist/gobj-js.umd.js

@@ -5396,10 +5396,22 @@
 	*          c_timer.js
 	*
 	*          GClass Timer
-	*          High-level, feed timers from periodic time of yuno
-	*          IN SECONDS! although the parameter is in milliseconds (msec)
+	*          High-level timer, fed by the browser's own timer service
 	*
-	*          Copyright (c) 2025, ArtGins.
+	*          Don't use gobj_start()/gobj_stop(), USE set_timeout..(), clear_timeout()
+	*
+	*          The CONTRACT is the C one (see c_timer.h), and it is the whole
+	*          public surface: set_timeout() arms, clear_timeout() disarms, and
+	*          a one-shot is done once it fires. Whether the gobj is running is
+	*          an INTERNAL matter of this gclass -- nobody asking for a timeout
+	*          has to know it exists, and no caller should have to pair a
+	*          set_timeout() with a gobj_start() to make it work.
+	*
+	*          What feeds the timer is the only thing that differs from C, and
+	*          it is deliberately invisible from outside: there the gobj rides
+	*          the yuno's one-second heartbeat, here it is a native setTimeout().
+	*
+	*          Copyright (c) 2025-2026, ArtGins.
 	*          All Rights Reserved.
 	****************************************************************************/
 	/***************************************************************
@@ -5452,6 +5464,9 @@
 				if (priv.msec > 0) priv.timer_id = setTimeout(function() {
 					gobj_send_event(gobj, "EV_TIMEOUT", {}, gobj);
 				}, priv.msec);
+				if (priv.msec > 0) {
+					if (!gobj_is_running(gobj)) gobj_start(gobj);
+				} else if (gobj_is_running(gobj)) gobj_stop(gobj);
 				break;
 		}
 	}
@@ -5481,11 +5496,15 @@
 	function ac_timeout$1(gobj, event, kw, src) {
 		let priv = gobj.priv;
 		let ev = priv.periodic ? "EV_TIMEOUT_PERIODIC" : "EV_TIMEOUT";
-		if (gobj_is_pure_child(gobj)) gobj_send_event(gobj_parent(gobj), ev, {}, gobj);
-		else gobj_publish_event(gobj, ev, {});
-		if (priv.periodic) priv.timer_id = setTimeout(function() {
+		if (priv.periodic && priv.msec > 0) priv.timer_id = setTimeout(function() {
 			gobj_send_event(gobj, "EV_TIMEOUT", {}, gobj);
 		}, priv.msec);
+		else priv.timer_id = -1;
+		if (gobj_is_pure_child(gobj)) gobj_send_event(gobj_parent(gobj), ev, {}, gobj);
+		else gobj_publish_event(gobj, ev, {});
+		if (!priv.periodic && priv.timer_id === -1) {
+			if (gobj_is_running(gobj)) gobj_stop(gobj);
+		}
 		return 0;
 	}
 	/***************************
@@ -5638,7 +5657,6 @@
 	*          Framework Method: Start
 	***************************************************************/
 	function mt_start$1(gobj) {
-		gobj_start(gobj.priv.gobj_timer);
 		set_timeout_periodic(gobj.priv.gobj_timer, gobj.priv.periodic_timeout);
 		return 0;
 	}
@@ -5646,7 +5664,7 @@
 	*          Framework Method: Stop
 	***************************************************************/
 	function mt_stop$1(gobj) {
-		gobj_stop(gobj.priv.gobj_timer);
+		clear_timeout(gobj.priv.gobj_timer);
 		gobj_stop_children(gobj);
 		return 0;
 	}
@@ -5818,7 +5836,6 @@
 	***************************************************************/
 	function mt_start(gobj) {
 		let priv = gobj.priv;
-		gobj_start(priv.gobj_timer);
 		priv.retry_ms = 0;
 		priv.websocket = setup_websocket(gobj);
 		return 0;
@@ -5829,7 +5846,6 @@
 	function mt_stop(gobj) {
 		let priv = gobj.priv;
 		clear_timeout(priv.gobj_timer);
-		gobj_stop(priv.gobj_timer);
 		if (priv.websocket) close_websocket(gobj);
 		return 0;
 	}