@yuneta/gobj-js 7.9.9 → 7.9.11

package/dist/gobj-js.cjs.js

@@ -5393,10 +5393,22 @@ function create_template_record(template, kw) {
 *          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.
 ****************************************************************************/
 /***************************************************************
@@ -5449,6 +5461,9 @@ function mt_writing$2(gobj, path) {
 			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;
 	}
 }
@@ -5478,11 +5493,15 @@ function mt_destroy$2(gobj) {}
 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;
 }
 /***************************
@@ -5635,7 +5654,6 @@ function mt_writing$1(gobj, path) {}
 *          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;
 }
@@ -5643,7 +5661,7 @@ function mt_start$1(gobj) {
 *          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;
 }
@@ -5815,7 +5833,6 @@ function mt_writing(gobj, path) {
 ***************************************************************/
 function mt_start(gobj) {
 	let priv = gobj.priv;
-	gobj_start(priv.gobj_timer);
 	priv.retry_ms = 0;
 	priv.websocket = setup_websocket(gobj);
 	return 0;
@@ -5826,7 +5843,6 @@ function mt_start(gobj) {
 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;
 }