@yuneta/gobj-ui 7.23.32 → 7.23.34

package/dist/gobj-ui.cjs.js

@@ -32,6 +32,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let _yuneta_gobj_js = require("@yuneta/gobj-js");
+_yuneta_gobj_js = __toESM(_yuneta_gobj_js, 1);
 let i18next = require("i18next");
 i18next = __toESM(i18next, 1);
 let tom_select = require("tom-select");
@@ -64309,6 +64310,10 @@ function dev_view() {
 	return v === "compact" || v === "name" || v === "full" ? v : "detailed";
 }
 var HIDE_PERIODIC_DEFAULT = 1;
+var SIMPLE_MACH_DEFAULT = 1;
+function dev_simple_mach() {
+	return dev_num("dev_automata_simple", SIMPLE_MACH_DEFAULT) ? 1 : 0;
+}
 function dev_hide_periodic() {
 	return dev_num("dev_hide_periodic", HIDE_PERIODIC_DEFAULT) ? true : false;
 }
@@ -64318,7 +64323,16 @@ function dev_route() {
 }
 function apply_console_route() {
 	(0, _yuneta_gobj_js.set_console_log_enabled)(dev_route() !== "window");
+	if (typeof _yuneta_gobj_js.set_console_log_filter === "function") _yuneta_gobj_js.set_console_log_filter((level, msg) => {
+		if (!dev_hide_periodic()) return true;
+		return !log_is_periodic(level, (0, _yuneta_gobj_js.is_string)(msg) ? msg : String(msg));
+	});
+	else if (!__console_filter_warned__) {
+		__console_filter_warned__ = true;
+		console.warn("yui_dev: gobj-js has no set_console_log_filter (needs >= 7.13.6): the Periodic filter applies to this window only, not to the console");
+	}
 }
+var __console_filter_warned__ = false;
 function console_traffic(title, jn, direction, size) {
 	let event = jn && jn.event ? String(jn.event) : "(no event)";
 	let kw = jn && jn.kw && typeof jn.kw === "object" ? jn.kw : jn;
@@ -64348,6 +64362,7 @@ function set_output_route(v) {
 function toggle_pref(key, def) {
 	let v = dev_num(key, def) ? 0 : 1;
 	(0, _yuneta_gobj_js.kw_set_local_storage_value)(key, v);
+	apply_console_route();
 	rerender_all();
 	refresh_dev_chrome();
 }
@@ -64876,7 +64891,7 @@ function render_name(e) {
 	]);
 }
 function render_log(e) {
-	return (0, _yuneta_gobj_js.createElement2)([
+	let $row = (0, _yuneta_gobj_js.createElement2)([
 		"div",
 		{
 			class: "YDEV_LOGROW YDEV_LOG_" + e.level,
@@ -64891,7 +64906,7 @@ function render_log(e) {
 			[
 				"span",
 				{ class: "YDEV_LOG_TXT" },
-				e.text
+				""
 			],
 			[
 				"span",
@@ -64900,6 +64915,9 @@ function render_log(e) {
 			]
 		]
 	]);
+	let $txt = $row.querySelector(".YDEV_LOG_TXT");
+	if ($txt) $txt.textContent = e.text;
+	return $row;
 }
 function render_entry(e) {
 	if (e.kind === "log") return render_log(e);
@@ -64938,15 +64956,28 @@ function rerender_all() {
 		}
 	}
 	logger.replaceChildren(frag);
-	if (shown === 0) {
-		let $empty = document.createElement("div");
-		$empty.className = "YDEV_EMPTY";
-		$empty.textContent = TRAFFIC_LOG.length ? "No messages match the current filters." : "Waiting for activity — console logs and errors show automatically; enable Traffic or Automata for more.";
-		logger.appendChild($empty);
-	}
+	if (shown === 0) logger.appendChild(make_placeholder());
 	logger.scrollTop = logger.scrollHeight;
 	update_stats();
 }
+function make_placeholder() {
+	let $empty = document.createElement("div");
+	$empty.className = "YDEV_EMPTY";
+	$empty.textContent = placeholder_text();
+	return $empty;
+}
+function placeholder_text() {
+	if (TRAFFIC_LOG.length) return "No messages match the current filters.";
+	return "Waiting for activity — console logs and errors show automatically; enable Traffic or Automata for more.";
+}
+function refresh_placeholder() {
+	let logger = document.getElementById("developer-traffic-logger");
+	if (!logger) return;
+	let ph = logger.querySelector(".YDEV_EMPTY");
+	if (!ph) return;
+	let text = placeholder_text();
+	if (ph.textContent !== text) ph.textContent = text;
+}
 function update_stats() {
 	let $s = document.getElementById("ydev-stats");
 	if (!$s) return;
@@ -65050,7 +65081,7 @@ function info_traffic(title, msg, direction, size) {
 		let ph = logger.querySelector(".YDEV_EMPTY");
 		if (ph) ph.remove();
 		append_and_follow(logger, node);
-	}
+	} else refresh_placeholder();
 	update_stats();
 }
 var __in_info_log__ = false;
@@ -65111,7 +65142,7 @@ function info_log(level, msg, hora) {
 			let ph = logger.querySelector(".YDEV_EMPTY");
 			if (ph) ph.remove();
 			append_and_follow(logger, node);
-		}
+		} else refresh_placeholder();
 		update_stats();
 	} finally {
 		__in_info_log__ = false;
@@ -65208,7 +65239,7 @@ function refresh_dev_chrome() {
 		$b.classList.toggle("is-active", dev_hide_periodic());
 	});
 	document.querySelectorAll(".YDEV_CHIP[data-toggle=\"automata-simple\"]").forEach(($b) => {
-		$b.classList.toggle("is-active", !!dev_num("dev_automata_simple", 0));
+		$b.classList.toggle("is-active", !!dev_simple_mach());
 	});
 	let $m = document.getElementById("ydev-muted");
 	if ($m) {
@@ -65300,12 +65331,12 @@ function build_control_bar() {
 			class: "YDEV_CHIP",
 			"data-toggle": "automata-simple",
 			type: "button",
-			title: "Compact automata format (one line per transition, like C)"
+			title: "Machine trace shape. On (default): one line per transition, event first, like the C kernel. Off: the legacy three-line shape (the call, the state change and the return)"
 		},
 		"Simple mach",
 		{ click: (ev) => {
 			ev.stopPropagation();
-			let v = dev_num("dev_automata_simple", 0) ? 0 : 1;
+			let v = dev_simple_mach() ? 0 : 1;
 			(0, _yuneta_gobj_js.kw_set_local_storage_value)("dev_automata_simple", v);
 			(0, _yuneta_gobj_js.gobj_set_trace_machine_format)(v);
 			refresh_dev_chrome();
@@ -65595,7 +65626,7 @@ function apply_dev_traces() {
 	(0, _yuneta_gobj_js.gobj_write_attr)((0, _yuneta_gobj_js.gobj_yuno)(), "trace_subscriptions", subscriptions);
 	(0, _yuneta_gobj_js.gobj_write_attr)((0, _yuneta_gobj_js.gobj_yuno)(), "no_poll", no_poll);
 	i18next.default.options.debug = i18n ? true : false;
-	(0, _yuneta_gobj_js.gobj_set_trace_machine_format)(Number((0, _yuneta_gobj_js.kw_get_local_storage_value)("dev_automata_simple", 0, false)) ? 1 : 0);
+	(0, _yuneta_gobj_js.gobj_set_trace_machine_format)(dev_simple_mach());
 	(0, _yuneta_gobj_js.set_log_callback)(info_log);
 	apply_console_route();
 }

package/dist/gobj-ui.es.js

@@ -1,3 +1,4 @@
+import * as gobj_js from "@yuneta/gobj-js";
 import { SDATA, SDATA_END, clean_name, createElement2, createOneHtml, create_template_record, data_type_t, debounce, duplicate_objects, empty_string, escapeHtml, event_flag_t, gclass_create, gclass_find_by_name, gclass_flag_t, getPositionRelativeToBody, gobj_bottom_gobj, gobj_change_state, gobj_command, gobj_create, gobj_create_pure_child, gobj_create_service, gobj_current_state, gobj_destroy, gobj_find_child, gobj_find_service, gobj_full_name, gobj_gclass_name, gobj_is_destroying, gobj_is_playing, gobj_is_pure_child, gobj_is_running, gobj_is_service, gobj_is_volatil, gobj_match_children, gobj_name, gobj_parent, gobj_post_event, gobj_publish_event, gobj_read_attr, gobj_read_bool_attr, gobj_read_integer_attr, gobj_read_pointer_attr, gobj_read_str_attr, gobj_save_persistent_attrs, gobj_send_event, gobj_set_trace_machine_format, gobj_short_name, gobj_start, gobj_start_tree, gobj_stop, gobj_stop_children, gobj_subscribe_event, gobj_unsubscribe_event, gobj_write_attr, gobj_write_bool_attr, gobj_write_integer_attr, gobj_write_str_attr, gobj_yuno, gobj_yuno_name, is_array, is_boolean, is_date, is_gobj, is_null, is_number, is_object, is_string, json_deep_copy, json_object_size, json_object_update, json_object_update_missing, json_size, kw_clone_by_keys, kw_flag_t, kw_get_dict, kw_get_dict_value, kw_get_int, kw_get_local_storage_value, kw_get_str, kw_has_key, kw_set_dict_value, kw_set_local_storage_value, kwid_find_one_record, kwid_get_ids, kwid_new_dict, log_error, log_warning, msg_iev_get_stack, parseBoolean, parseSVG, refresh_language, safeSrc, sdata_flag_t, set_console_log_enabled, set_log_callback, sprintf, str_in_list, template_get_field_desc, trace_msg, treedb_decoder_fkey, treedb_encoder_fkey, treedb_get_field_desc, treedb_hook_data_size } from "@yuneta/gobj-js";
 import i18next, { t } from "i18next";
 import TomSelect from "tom-select";
@@ -64304,6 +64305,10 @@ function dev_view() {
 	return v === "compact" || v === "name" || v === "full" ? v : "detailed";
 }
 var HIDE_PERIODIC_DEFAULT = 1;
+var SIMPLE_MACH_DEFAULT = 1;
+function dev_simple_mach() {
+	return dev_num("dev_automata_simple", SIMPLE_MACH_DEFAULT) ? 1 : 0;
+}
 function dev_hide_periodic() {
 	return dev_num("dev_hide_periodic", HIDE_PERIODIC_DEFAULT) ? true : false;
 }
@@ -64313,7 +64318,16 @@ function dev_route() {
 }
 function apply_console_route() {
 	set_console_log_enabled(dev_route() !== "window");
+	if (typeof gobj_js.set_console_log_filter === "function") gobj_js.set_console_log_filter((level, msg) => {
+		if (!dev_hide_periodic()) return true;
+		return !log_is_periodic(level, is_string(msg) ? msg : String(msg));
+	});
+	else if (!__console_filter_warned__) {
+		__console_filter_warned__ = true;
+		console.warn("yui_dev: gobj-js has no set_console_log_filter (needs >= 7.13.6): the Periodic filter applies to this window only, not to the console");
+	}
 }
+var __console_filter_warned__ = false;
 function console_traffic(title, jn, direction, size) {
 	let event = jn && jn.event ? String(jn.event) : "(no event)";
 	let kw = jn && jn.kw && typeof jn.kw === "object" ? jn.kw : jn;
@@ -64343,6 +64357,7 @@ function set_output_route(v) {
 function toggle_pref(key, def) {
 	let v = dev_num(key, def) ? 0 : 1;
 	kw_set_local_storage_value(key, v);
+	apply_console_route();
 	rerender_all();
 	refresh_dev_chrome();
 }
@@ -64871,7 +64886,7 @@ function render_name(e) {
 	]);
 }
 function render_log(e) {
-	return createElement2([
+	let $row = createElement2([
 		"div",
 		{
 			class: "YDEV_LOGROW YDEV_LOG_" + e.level,
@@ -64886,7 +64901,7 @@ function render_log(e) {
 			[
 				"span",
 				{ class: "YDEV_LOG_TXT" },
-				e.text
+				""
 			],
 			[
 				"span",
@@ -64895,6 +64910,9 @@ function render_log(e) {
 			]
 		]
 	]);
+	let $txt = $row.querySelector(".YDEV_LOG_TXT");
+	if ($txt) $txt.textContent = e.text;
+	return $row;
 }
 function render_entry(e) {
 	if (e.kind === "log") return render_log(e);
@@ -64933,15 +64951,28 @@ function rerender_all() {
 		}
 	}
 	logger.replaceChildren(frag);
-	if (shown === 0) {
-		let $empty = document.createElement("div");
-		$empty.className = "YDEV_EMPTY";
-		$empty.textContent = TRAFFIC_LOG.length ? "No messages match the current filters." : "Waiting for activity — console logs and errors show automatically; enable Traffic or Automata for more.";
-		logger.appendChild($empty);
-	}
+	if (shown === 0) logger.appendChild(make_placeholder());
 	logger.scrollTop = logger.scrollHeight;
 	update_stats();
 }
+function make_placeholder() {
+	let $empty = document.createElement("div");
+	$empty.className = "YDEV_EMPTY";
+	$empty.textContent = placeholder_text();
+	return $empty;
+}
+function placeholder_text() {
+	if (TRAFFIC_LOG.length) return "No messages match the current filters.";
+	return "Waiting for activity — console logs and errors show automatically; enable Traffic or Automata for more.";
+}
+function refresh_placeholder() {
+	let logger = document.getElementById("developer-traffic-logger");
+	if (!logger) return;
+	let ph = logger.querySelector(".YDEV_EMPTY");
+	if (!ph) return;
+	let text = placeholder_text();
+	if (ph.textContent !== text) ph.textContent = text;
+}
 function update_stats() {
 	let $s = document.getElementById("ydev-stats");
 	if (!$s) return;
@@ -65045,7 +65076,7 @@ function info_traffic(title, msg, direction, size) {
 		let ph = logger.querySelector(".YDEV_EMPTY");
 		if (ph) ph.remove();
 		append_and_follow(logger, node);
-	}
+	} else refresh_placeholder();
 	update_stats();
 }
 var __in_info_log__ = false;
@@ -65106,7 +65137,7 @@ function info_log(level, msg, hora) {
 			let ph = logger.querySelector(".YDEV_EMPTY");
 			if (ph) ph.remove();
 			append_and_follow(logger, node);
-		}
+		} else refresh_placeholder();
 		update_stats();
 	} finally {
 		__in_info_log__ = false;
@@ -65203,7 +65234,7 @@ function refresh_dev_chrome() {
 		$b.classList.toggle("is-active", dev_hide_periodic());
 	});
 	document.querySelectorAll(".YDEV_CHIP[data-toggle=\"automata-simple\"]").forEach(($b) => {
-		$b.classList.toggle("is-active", !!dev_num("dev_automata_simple", 0));
+		$b.classList.toggle("is-active", !!dev_simple_mach());
 	});
 	let $m = document.getElementById("ydev-muted");
 	if ($m) {
@@ -65295,12 +65326,12 @@ function build_control_bar() {
 			class: "YDEV_CHIP",
 			"data-toggle": "automata-simple",
 			type: "button",
-			title: "Compact automata format (one line per transition, like C)"
+			title: "Machine trace shape. On (default): one line per transition, event first, like the C kernel. Off: the legacy three-line shape (the call, the state change and the return)"
 		},
 		"Simple mach",
 		{ click: (ev) => {
 			ev.stopPropagation();
-			let v = dev_num("dev_automata_simple", 0) ? 0 : 1;
+			let v = dev_simple_mach() ? 0 : 1;
 			kw_set_local_storage_value("dev_automata_simple", v);
 			gobj_set_trace_machine_format(v);
 			refresh_dev_chrome();
@@ -65590,7 +65621,7 @@ function apply_dev_traces() {
 	gobj_write_attr(gobj_yuno(), "trace_subscriptions", subscriptions);
 	gobj_write_attr(gobj_yuno(), "no_poll", no_poll);
 	i18next.options.debug = i18n ? true : false;
-	gobj_set_trace_machine_format(Number(kw_get_local_storage_value("dev_automata_simple", 0, false)) ? 1 : 0);
+	gobj_set_trace_machine_format(dev_simple_mach());
 	set_log_callback(info_log);
 	apply_console_route();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuneta/gobj-ui",
-  "version": "7.23.32",
+  "version": "7.23.34",
   "type": "module",
   "main": "dist/gobj-ui.cjs.js",
   "module": "dist/gobj-ui.es.js",

package/src/yui_dev.js

@@ -21,6 +21,14 @@ import {
     gobj_set_trace_machine_format,
 } from "@yuneta/gobj-js";
 
+/*  A NAMESPACE import, deliberately, for one optional API.
+ *
+ *  `set_console_log_filter` arrived in gobj-js 7.13.6, and a NAMED import of
+ *  an export the installed copy does not have is a hard module-load error --
+ *  it would take the whole app down instead of degrading. Read off the
+ *  namespace, a missing export is plain `undefined` and can be tested for. */
+import * as gobj_js from "@yuneta/gobj-js";
+
 import {log_signature, log_is_periodic} from "./dev_machine_trace.js";
 
 import i18next from 'i18next';
@@ -177,6 +185,25 @@ function dev_view()
  *  chip writes the value it already had and appears to do nothing. */
 const HIDE_PERIODIC_DEFAULT = 1;
 
+/*  Which SHAPE the machine trace is written in — the two the C kernel
+ *  offers, and the chip that swaps them:
+ *
+ *      1 (default)  one line per transition, event first
+ *      0            the legacy three-line shape: the call, the state
+ *                   change, and the `<- … ret: N` return
+ *
+ *  1 because that is what the C kernel defaults to, so a browser yuno and
+ *  a node read alike. Like HIDE_PERIODIC_DEFAULT, a CONSTANT and not a
+ *  literal in each of the three places that read it (the chip, the chrome
+ *  and start up): they have to agree on what "unset" means, or the chip
+ *  is born showing the wrong state and its first click does nothing. */
+const SIMPLE_MACH_DEFAULT = 1;
+
+function dev_simple_mach()
+{
+    return dev_num("dev_automata_simple", SIMPLE_MACH_DEFAULT) ? 1 : 0;
+}
+
 function dev_hide_periodic()
 {
     return dev_num("dev_hide_periodic", HIDE_PERIODIC_DEFAULT) ? true : false;
@@ -195,12 +222,46 @@ function dev_route()
 }
 
 /*  Push the current route's console decision down to gobj-js. Called from
- *  apply_dev_traces (startup) and whenever the Output selector changes. */
+ *  apply_dev_traces (startup), whenever the Output selector changes, and
+ *  whenever a filter that the console also obeys is toggled. */
 function apply_console_route()
 {
     set_console_log_enabled(dev_route() !== "window");
+
+    /*  ONE rule, TWO sinks.
+     *
+     *  The window's Periodic filter used to end at the window, so with the
+     *  Output on "Both" the timers were gone from the panel and still
+     *  arriving in the browser console, two lines a second — the same flood,
+     *  one pane over. It cannot be fixed from this side alone: gobj-js writes
+     *  the console line BEFORE it calls the log sink, so nothing here can
+     *  un-print it. It hands out a say instead (`set_console_log_filter`,
+     *  gobj-js >= 7.13.6), and this is the same predicate `entry_hidden()`
+     *  uses, so the two panes cannot disagree about what is noise.
+     *
+     *  Feature-detected rather than required: against an older gobj-js the
+     *  window still filters and the console still floods, exactly as before,
+     *  and the reason is logged once instead of failing. */
+    if(typeof gobj_js.set_console_log_filter === "function") {
+        gobj_js.set_console_log_filter((level, msg) => {
+            if(!dev_hide_periodic()) {
+                return true;
+            }
+            return !log_is_periodic(level, is_string(msg) ? msg : String(msg));
+        });
+    } else if(!__console_filter_warned__) {
+        __console_filter_warned__ = true;
+        console.warn(
+            "yui_dev: gobj-js has no set_console_log_filter (needs >= 7.13.6): " +
+            "the Periodic filter applies to this window only, not to the console"
+        );
+    }
 }
 
+/*  The warning above is worth saying, and worth saying ONCE: this runs on
+ *  every Output change and every filter toggle. */
+let __console_filter_warned__ = false;
+
 /*  Emit one inter-event traffic line to the browser console (routes
  *  "console" and "both"). gobj-js only knows about framework logs, not this
  *  traffic feed, so the console mirror is produced here. */
@@ -253,6 +314,12 @@ function toggle_pref(key, def)
 {
     let v = dev_num(key, def) ? 0 : 1;
     kw_set_local_storage_value(key, v);
+    /*  The console filter closes over dev_hide_periodic(), which reads the
+     *  stored value on each call, so it follows this on its own. Re-pushed
+     *  anyway: a filter installed before this module reached apply_dev_traces
+     *  is the difference between the console obeying the chip and ignoring
+     *  it, and one assignment is cheaper than that class of bug. */
+    apply_console_route();
     rerender_all();
     refresh_dev_chrome();
 }
@@ -773,13 +840,29 @@ function render_name(e)
 /*  A mirrored framework log line (error/warning/info/debug/msg). */
 function render_log(e)
 {
-    return createElement2(
+    let $row = createElement2(
         ['div', {class: 'YDEV_LOGROW YDEV_LOG_' + e.level, title: e.level}, [
             ['span', {class: 'YDEV_LOG_LVL'}, e.level],
-            ['span', {class: 'YDEV_LOG_TXT'}, e.text],
+            ['span', {class: 'YDEV_LOG_TXT'}, ''],
             ['span', {class: 'TRAFFIC_META'}, e.ts],
         ]]
     );
+
+    /*  The text is assigned AFTER, and that is the whole point.
+     *
+     *  createElement2() TRIMS a string content -- it has to, to decide
+     *  whether the string is HTML by looking at its first character -- and
+     *  the machine trace's leading spaces are its NESTING: gobj-js prefixes
+     *  every line with `tab()`, two spaces per level of __inside__, so an
+     *  event sent from inside another one's action is indented under it.
+     *  Passed through createElement2 that indentation was eaten, and the
+     *  window showed a flat column where the console showed a tree. */
+    let $txt = $row.querySelector('.YDEV_LOG_TXT');
+    if($txt) {
+        $txt.textContent = e.text;
+    }
+
+    return $row;
 }
 
 function render_entry(e)
@@ -841,17 +924,55 @@ function rerender_all()
     }
     logger.replaceChildren(frag);
     if(shown === 0) {
-        let $empty = document.createElement('div');
-        $empty.className = 'YDEV_EMPTY';
-        $empty.textContent = TRAFFIC_LOG.length
-            ? "No messages match the current filters."
-            : "Waiting for activity — console logs and errors show automatically; enable Traffic or Automata for more.";
-        logger.appendChild($empty);
+        logger.appendChild(make_placeholder());
     }
     logger.scrollTop = logger.scrollHeight;
     update_stats();
 }
 
+/*  The empty state, which has to say WHICH empty it is.  */
+function make_placeholder()
+{
+    let $empty = document.createElement('div');
+    $empty.className = 'YDEV_EMPTY';
+    $empty.textContent = placeholder_text();
+    return $empty;
+}
+
+function placeholder_text()
+{
+    if(TRAFFIC_LOG.length) {
+        return "No messages match the current filters.";
+    }
+    return "Waiting for activity — console logs and errors show automatically; " +
+        "enable Traffic or Automata for more.";
+}
+
+/*  Keep whatever placeholder is on screen TRUTHFUL.
+ *
+ *  A line that arrives and is filtered out changes the answer without
+ *  changing the screen: the buffer stops being empty, so "Waiting for
+ *  activity — enable Automata for more" becomes a lie, and the window reads
+ *  as "nothing is happening, your traces are off" while it is in fact hiding
+ *  36 of them. Measured on a yuno with one timer and the Periodic filter on,
+ *  which is now the default: the status line said `0/36 shown · 36 hidden`
+ *  and the panel said there was no activity. */
+function refresh_placeholder()
+{
+    let logger = document.getElementById('developer-traffic-logger');
+    if(!logger) {
+        return;
+    }
+    let ph = logger.querySelector('.YDEV_EMPTY');
+    if(!ph) {
+        return;
+    }
+    let text = placeholder_text();
+    if(ph.textContent !== text) {
+        ph.textContent = text;
+    }
+}
+
 /*  Live counters in the status strip. */
 function update_stats()
 {
@@ -1002,6 +1123,8 @@ function info_traffic(title, msg, direction, size)
             ph.remove();
         }
         append_and_follow(logger, node);
+    } else {
+        refresh_placeholder();  /*  hidden, but the buffer is no longer empty  */
     }
     update_stats();
 }
@@ -1092,6 +1215,8 @@ function info_log(level, msg, hora)
                 ph.remove();
             }
             append_and_follow(logger, node);
+        } else {
+            refresh_placeholder();  /*  hidden, but the buffer is no longer empty  */
         }
         update_stats();
     } finally {
@@ -1228,7 +1353,7 @@ function refresh_dev_chrome()
     });
 
     document.querySelectorAll('.YDEV_CHIP[data-toggle="automata-simple"]').forEach(($b) => {
-        $b.classList.toggle('is-active', !!dev_num('dev_automata_simple', 0));
+        $b.classList.toggle('is-active', !!dev_simple_mach());
     });
 
     let $m = document.getElementById('ydev-muted');
@@ -1336,11 +1461,13 @@ function build_control_bar()
      *  emitted while Automata is on. */
     let simple_mach = ['button', {
         class: 'YDEV_CHIP', 'data-toggle': 'automata-simple', type: 'button',
-        title: 'Compact automata format (one line per transition, like C)',
+        title: 'Machine trace shape. On (default): one line per transition, ' +
+            'event first, like the C kernel. Off: the legacy three-line shape ' +
+            '(the call, the state change and the return)',
     }, 'Simple mach', {
         click: (ev) => {
             ev.stopPropagation();
-            let v = dev_num('dev_automata_simple', 0) ? 0 : 1;
+            let v = dev_simple_mach() ? 0 : 1;
             kw_set_local_storage_value('dev_automata_simple', v);
             gobj_set_trace_machine_format(v);
             refresh_dev_chrome();
@@ -1533,9 +1660,8 @@ function apply_dev_traces()
     gobj_write_attr(gobj_yuno(), "no_poll", no_poll);
     i18next.options.debug = i18n ? true : false;
 
-    /*  Compact vs verbose automata trace format (persisted). */
-    gobj_set_trace_machine_format(
-        Number(kw_get_local_storage_value("dev_automata_simple", 0, false)) ? 1 : 0);
+    /*  Which shape the machine trace is written in (persisted). */
+    gobj_set_trace_machine_format(dev_simple_mach());
 
     /*  Mirror the browser console (log_error/warning/info/debug/msg — the
      *  automata FSM trace arrives as debug) into the monitor. info_log no-ops