@yuneta/gobj-js 7.9.10 → 7.10.0

package/dist/gobj-js.cjs.js

@@ -1415,6 +1415,7 @@ function gobj_destroy(gobj) {
 		gobj_stop(gobj);
 	}
 	gobj.obflag |= obflag_t.obflag_destroying;
+	purge_posted_events(gobj);
 	let trace_creation = __trace_gobj_create_delete__(gobj);
 	if (trace_creation) trace_machine(sprintf("💔💔⏩ destroying: %s", gobj_full_name(gobj)));
 	let parent = gobj_parent(gobj);
@@ -2354,13 +2355,97 @@ function gobj_has_output_event(gobj, event, event_flag) {
 	return true;
 }
 /************************************************************
-*      post_event, by now only in js
+*      Posted events: gobj_send_event(), but on the next turn
+*
+*  Same contract as the C side (see gobj.h). It exists to get out of the
+*  stack you are standing on: gobj_publish_event() dispatches synchronously,
+*  so a subscriber action runs inside the publisher's own stack, and
+*  destroying that publisher there dismantles what is still iterating.
+*
+*  The queue is drained with setTimeout(0) and NOT with queueMicrotask():
+*  a microtask runs before the browser can paint or handle an input, so a
+*  chain of posted events would hold the page exactly the way it used to
+*  hold the event loop in C. A macrotask gives the browser its turn between
+*  one event and the next.
+*
+*  Delivery is a SNAPSHOT: the events queued when the drain begins are the
+*  ones delivered in it, and whatever an action posts while it runs waits
+*  for the following turn.
 ************************************************************/
-function gobj_post_event(gobj, event, kw, src) {
-	setTimeout(() => {
-		if (gobj_is_destroying(gobj)) return;
-		gobj_send_event(gobj, event, kw, src);
-	}, 10);
+var MAX_POSTED_EVENTS = 1e4;
+var __dl_posted_events__ = [];
+var __posted_events_scheduled__ = false;
+function gobj_post_event(dst, event, kw, src) {
+	if (!dst || !(dst instanceof GObj)) {
+		log_error(`gobj_post_event(): gobj dst NULL, event ${event}`);
+		return -1;
+	}
+	if (dst.obflag & (obflag_t.obflag_destroyed | obflag_t.obflag_destroying)) {
+		log_error(`gobj_post_event(): gobj dst DESTROYING, event ${event}`);
+		return -1;
+	}
+	if (empty_string(event)) {
+		log_error(`gobj_post_event(): event EMPTY`);
+		return -1;
+	}
+	if (!gobj_has_event(dst, event, 0)) {
+		log_error(`gobj_post_event(): event NOT DEFINED in gclass ${gobj_gclass_name(dst)}, event ${event}`);
+		return -1;
+	}
+	if (__dl_posted_events__.length >= MAX_POSTED_EVENTS) {
+		log_error(`gobj_post_event(): too many posted events, this is NOT a work queue, event ${event}, pending ${__dl_posted_events__.length}`);
+		return -1;
+	}
+	__dl_posted_events__.push({
+		dst,
+		event,
+		kw,
+		src
+	});
+	if (is_machine_tracing(dst, event) && !is_machine_not_tracing(src, event)) trace_machine(sprintf("📬 posted(%s%s), ev: %s, pending: %d", !dst.running ? "!!" : "", gobj_short_name(dst), event, __dl_posted_events__.length));
+	if (!__posted_events_scheduled__) {
+		__posted_events_scheduled__ = true;
+		setTimeout(gobj_deliver_posted_events, 0);
+	}
+	return 0;
+}
+/************************************************************
+*      How many posted events wait for delivery
+************************************************************/
+function gobj_posted_events_size() {
+	return __dl_posted_events__.length;
+}
+/************************************************************
+*      Deliver the posted events. One turn, one snapshot.
+************************************************************/
+function gobj_deliver_posted_events() {
+	__posted_events_scheduled__ = false;
+	let snapshot = __dl_posted_events__;
+	__dl_posted_events__ = [];
+	let delivered = 0;
+	for (let msg of snapshot) {
+		if (msg.dst.obflag & (obflag_t.obflag_destroyed | obflag_t.obflag_destroying)) continue;
+		gobj_send_event(msg.dst, msg.event, msg.kw, msg.src);
+		delivered++;
+	}
+	if (__dl_posted_events__.length > 0 && !__posted_events_scheduled__) {
+		__posted_events_scheduled__ = true;
+		setTimeout(gobj_deliver_posted_events, 0);
+	}
+	return delivered;
+}
+/************************************************************
+*      Take a gobj out of the queue of posted events.
+*
+*  Called from gobj_destroy(), and the two halves are not the same thing:
+*  as DESTINATION the entry is dropped, as SOURCE only the pointer is
+*  cleared -- the destination still wants its event, and it arrives with
+*  src null, which every action already has to accept.
+************************************************************/
+function purge_posted_events(gobj) {
+	if (__dl_posted_events__.length === 0) return;
+	for (let msg of __dl_posted_events__) if (msg.src === gobj) msg.src = null;
+	__dl_posted_events__ = __dl_posted_events__.filter((msg) => msg.dst !== gobj);
 }
 /************************************************************
 *      send_event
@@ -5654,7 +5739,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;
 }
@@ -5662,7 +5746,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;
 }
@@ -5834,7 +5918,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;
@@ -5845,7 +5928,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;
 }
@@ -6580,6 +6662,7 @@ exports.gobj_create_volatil = gobj_create_volatil;
 exports.gobj_create_yuno = gobj_create_yuno;
 exports.gobj_current_state = gobj_current_state;
 exports.gobj_default_service = gobj_default_service;
+exports.gobj_deliver_posted_events = gobj_deliver_posted_events;
 exports.gobj_destroy = gobj_destroy;
 exports.gobj_find_child = gobj_find_child;
 exports.gobj_find_gobj = gobj_find_gobj;
@@ -6611,6 +6694,7 @@ exports.gobj_parent = gobj_parent;
 exports.gobj_pause = gobj_pause;
 exports.gobj_play = gobj_play;
 exports.gobj_post_event = gobj_post_event;
+exports.gobj_posted_events_size = gobj_posted_events_size;
 exports.gobj_publish_event = gobj_publish_event;
 exports.gobj_read_attr = gobj_read_attr;
 exports.gobj_read_attrs = gobj_read_attrs;