@yuneta/gobj-ui 7.23.31 → 7.23.33

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");
@@ -64092,6 +64093,86 @@ function register_c_yui_period() {
 	return create_gclass(GCLASS_NAME);
 }
 //#endregion
+//#region src/dev_machine_trace.js
+/***********************************************************************
+*          dev_machine_trace.js
+*
+*          Reading a MACHINE trace line back.
+*
+*          The developer window mirrors the runtime's log, and the
+*          `machine` trace is most of what lands there once it is on.
+*          Those lines arrive as text, so to the window they were just
+*          "a debug log" -- which is why its `Periodic` filter could
+*          not touch them: the filter works on a signature, and every
+*          mirrored log carried the same one (`log:debug`).
+*
+*          This gives a machine line back its EVENT, which is the only
+*          thing that says whether it is noise. Both formats gobj-js
+*          emits (`gobj_set_trace_machine_format`):
+*
+*            0  verbose  "🔄 mach(C_TIMER^t), st: ST_IDLE, ev: EV_TIMEOUT, ac: …"
+*                        "<- mach(C_TIMER^t), st: ST_IDLE, ev: EV_TIMEOUT, ret: 0"
+*            1  compact  "🔄 EV_TIMEOUT C_TIMER^t ST_IDLE from C_TIMER^t"
+*
+*          Copyright (c) 2026, ArtGins.
+*          All Rights Reserved.
+***********************************************************************/
+var MACHINE_MARK_RE = /\bmach\(/;
+var EVENT_FIELD_RE = /\bev:\s*([A-Za-z0-9_]+)/;
+var EVENT_HEAD_RE = /^\s*\S{0,4}\s*(EV_[A-Za-z0-9_]+)(?=\s|$)/;
+var PERIODIC_EVENT_RE = /PERIODIC|TIMEOUT|HEARTBEAT|PING|POLL/i;
+/************************************************************
+*  The event of a machine trace line, or "" when the line is
+*  not one.
+*
+*  "" is also the answer for a machine line that carries no
+*  event -- a state change ("new st(…), prev st(…)") -- and
+*  that is right: what it reports is not repetitive.
+************************************************************/
+function machine_event_of(text) {
+	if (typeof text !== "string" || text.length === 0) return "";
+	if (MACHINE_MARK_RE.test(text)) {
+		let m = EVENT_FIELD_RE.exec(text);
+		return m ? m[1] : "";
+	}
+	let m = EVENT_HEAD_RE.exec(text);
+	return m ? m[1] : "";
+}
+/************************************************************
+*  Is this event one of the ones that arrive by themselves,
+*  for ever, and say nothing about what the app is doing?
+************************************************************/
+function is_periodic_event(event_name) {
+	if (!event_name) return false;
+	return PERIODIC_EVENT_RE.test(event_name);
+}
+/************************************************************
+*  The signature of a mirrored log line: what the window
+*  counts it under and what its filters match on.
+*
+*  A machine line is signed by its EVENT, so a hundred
+*  EV_TIMEOUTs are one recurring thing rather than a hundred
+*  anonymous debug lines. Everything else is signed by its
+*  level, as before.
+************************************************************/
+function log_signature(level, text) {
+	let event = machine_event_of(text);
+	if (event) return "mach:" + event;
+	return "log:" + (level || "debug");
+}
+/************************************************************
+*  May the periodic filter hide this log line?
+*
+*  Only a machine transition, and only below warning level.
+*  An ERROR that names EV_TIMEOUT -- "Event NOT DEFINED in
+*  state", which is exactly the loud one the framework wants
+*  seen -- must never disappear because of the word in it.
+************************************************************/
+function log_is_periodic(level, text) {
+	if (level === "error" || level === "warning") return false;
+	return is_periodic_event(machine_event_of(text));
+}
+//#endregion
 //#region src/yui_dev.js
 /***********************************************************************
 *          ui_dev.js
@@ -64228,8 +64309,9 @@ function dev_view() {
 	let v = (0, _yuneta_gobj_js.kw_get_local_storage_value)("dev_view_mode", "detailed", false);
 	return v === "compact" || v === "name" || v === "full" ? v : "detailed";
 }
+var HIDE_PERIODIC_DEFAULT = 1;
 function dev_hide_periodic() {
-	return dev_num("dev_hide_periodic", 0) ? true : false;
+	return dev_num("dev_hide_periodic", HIDE_PERIODIC_DEFAULT) ? true : false;
 }
 function dev_route() {
 	let v = (0, _yuneta_gobj_js.kw_get_local_storage_value)("dev_output_route", "both", false);
@@ -64237,7 +64319,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;
@@ -64267,6 +64358,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();
 }
@@ -64305,7 +64397,10 @@ function build_filter_ctx() {
 	};
 }
 function entry_hidden(e, ctx) {
-	if (e.kind === "log") return !!(ctx.search && e.hay.indexOf(ctx.search) < 0);
+	if (e.kind === "log") {
+		if (ctx.hide_periodic && e.periodic) return true;
+		return !!(ctx.search && e.hay.indexOf(ctx.search) < 0);
+	}
 	if (e.dir === 1 && !ctx.out) return true;
 	if (e.dir === 2 && !ctx.inc) return true;
 	if (e.dir === 3 && !ctx.err) return true;
@@ -65006,7 +65101,8 @@ function info_log(level, msg, hora) {
 			dir: 0,
 			size: 0,
 			ts: traffic_now(),
-			sig: "log:" + lvl,
+			sig: log_signature(lvl, text),
+			periodic: log_is_periodic(lvl, text),
 			hay: (lvl + " " + text).toLowerCase(),
 			$node: null
 		};
@@ -65339,12 +65435,12 @@ function build_control_bar() {
 			class: "YDEV_CHIP",
 			"data-toggle": "periodic",
 			type: "button",
-			title: "Hide recurring / periodic events (polls, heartbeats)"
+			title: "Hide the timers: EV_TIMEOUT / PERIODIC / HEARTBEAT / PING transitions, and recurring traffic. On by default"
 		},
 		"⊘ Periodic",
 		{ click: (ev) => {
 			ev.stopPropagation();
-			toggle_pref("dev_hide_periodic", 0);
+			toggle_pref("dev_hide_periodic", HIDE_PERIODIC_DEFAULT);
 		} }
 	];
 	let search = [

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";
@@ -64087,6 +64088,86 @@ function register_c_yui_period() {
 	return create_gclass(GCLASS_NAME);
 }
 //#endregion
+//#region src/dev_machine_trace.js
+/***********************************************************************
+*          dev_machine_trace.js
+*
+*          Reading a MACHINE trace line back.
+*
+*          The developer window mirrors the runtime's log, and the
+*          `machine` trace is most of what lands there once it is on.
+*          Those lines arrive as text, so to the window they were just
+*          "a debug log" -- which is why its `Periodic` filter could
+*          not touch them: the filter works on a signature, and every
+*          mirrored log carried the same one (`log:debug`).
+*
+*          This gives a machine line back its EVENT, which is the only
+*          thing that says whether it is noise. Both formats gobj-js
+*          emits (`gobj_set_trace_machine_format`):
+*
+*            0  verbose  "🔄 mach(C_TIMER^t), st: ST_IDLE, ev: EV_TIMEOUT, ac: …"
+*                        "<- mach(C_TIMER^t), st: ST_IDLE, ev: EV_TIMEOUT, ret: 0"
+*            1  compact  "🔄 EV_TIMEOUT C_TIMER^t ST_IDLE from C_TIMER^t"
+*
+*          Copyright (c) 2026, ArtGins.
+*          All Rights Reserved.
+***********************************************************************/
+var MACHINE_MARK_RE = /\bmach\(/;
+var EVENT_FIELD_RE = /\bev:\s*([A-Za-z0-9_]+)/;
+var EVENT_HEAD_RE = /^\s*\S{0,4}\s*(EV_[A-Za-z0-9_]+)(?=\s|$)/;
+var PERIODIC_EVENT_RE = /PERIODIC|TIMEOUT|HEARTBEAT|PING|POLL/i;
+/************************************************************
+*  The event of a machine trace line, or "" when the line is
+*  not one.
+*
+*  "" is also the answer for a machine line that carries no
+*  event -- a state change ("new st(…), prev st(…)") -- and
+*  that is right: what it reports is not repetitive.
+************************************************************/
+function machine_event_of(text) {
+	if (typeof text !== "string" || text.length === 0) return "";
+	if (MACHINE_MARK_RE.test(text)) {
+		let m = EVENT_FIELD_RE.exec(text);
+		return m ? m[1] : "";
+	}
+	let m = EVENT_HEAD_RE.exec(text);
+	return m ? m[1] : "";
+}
+/************************************************************
+*  Is this event one of the ones that arrive by themselves,
+*  for ever, and say nothing about what the app is doing?
+************************************************************/
+function is_periodic_event(event_name) {
+	if (!event_name) return false;
+	return PERIODIC_EVENT_RE.test(event_name);
+}
+/************************************************************
+*  The signature of a mirrored log line: what the window
+*  counts it under and what its filters match on.
+*
+*  A machine line is signed by its EVENT, so a hundred
+*  EV_TIMEOUTs are one recurring thing rather than a hundred
+*  anonymous debug lines. Everything else is signed by its
+*  level, as before.
+************************************************************/
+function log_signature(level, text) {
+	let event = machine_event_of(text);
+	if (event) return "mach:" + event;
+	return "log:" + (level || "debug");
+}
+/************************************************************
+*  May the periodic filter hide this log line?
+*
+*  Only a machine transition, and only below warning level.
+*  An ERROR that names EV_TIMEOUT -- "Event NOT DEFINED in
+*  state", which is exactly the loud one the framework wants
+*  seen -- must never disappear because of the word in it.
+************************************************************/
+function log_is_periodic(level, text) {
+	if (level === "error" || level === "warning") return false;
+	return is_periodic_event(machine_event_of(text));
+}
+//#endregion
 //#region src/yui_dev.js
 /***********************************************************************
 *          ui_dev.js
@@ -64223,8 +64304,9 @@ function dev_view() {
 	let v = kw_get_local_storage_value("dev_view_mode", "detailed", false);
 	return v === "compact" || v === "name" || v === "full" ? v : "detailed";
 }
+var HIDE_PERIODIC_DEFAULT = 1;
 function dev_hide_periodic() {
-	return dev_num("dev_hide_periodic", 0) ? true : false;
+	return dev_num("dev_hide_periodic", HIDE_PERIODIC_DEFAULT) ? true : false;
 }
 function dev_route() {
 	let v = kw_get_local_storage_value("dev_output_route", "both", false);
@@ -64232,7 +64314,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;
@@ -64262,6 +64353,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();
 }
@@ -64300,7 +64392,10 @@ function build_filter_ctx() {
 	};
 }
 function entry_hidden(e, ctx) {
-	if (e.kind === "log") return !!(ctx.search && e.hay.indexOf(ctx.search) < 0);
+	if (e.kind === "log") {
+		if (ctx.hide_periodic && e.periodic) return true;
+		return !!(ctx.search && e.hay.indexOf(ctx.search) < 0);
+	}
 	if (e.dir === 1 && !ctx.out) return true;
 	if (e.dir === 2 && !ctx.inc) return true;
 	if (e.dir === 3 && !ctx.err) return true;
@@ -65001,7 +65096,8 @@ function info_log(level, msg, hora) {
 			dir: 0,
 			size: 0,
 			ts: traffic_now(),
-			sig: "log:" + lvl,
+			sig: log_signature(lvl, text),
+			periodic: log_is_periodic(lvl, text),
 			hay: (lvl + " " + text).toLowerCase(),
 			$node: null
 		};
@@ -65334,12 +65430,12 @@ function build_control_bar() {
 			class: "YDEV_CHIP",
 			"data-toggle": "periodic",
 			type: "button",
-			title: "Hide recurring / periodic events (polls, heartbeats)"
+			title: "Hide the timers: EV_TIMEOUT / PERIODIC / HEARTBEAT / PING transitions, and recurring traffic. On by default"
 		},
 		"⊘ Periodic",
 		{ click: (ev) => {
 			ev.stopPropagation();
-			toggle_pref("dev_hide_periodic", 0);
+			toggle_pref("dev_hide_periodic", HIDE_PERIODIC_DEFAULT);
 		} }
 	];
 	let search = [

package/package.json

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

package/src/dev_machine_trace.js

@@ -0,0 +1,116 @@
+/***********************************************************************
+ *          dev_machine_trace.js
+ *
+ *          Reading a MACHINE trace line back.
+ *
+ *          The developer window mirrors the runtime's log, and the
+ *          `machine` trace is most of what lands there once it is on.
+ *          Those lines arrive as text, so to the window they were just
+ *          "a debug log" -- which is why its `Periodic` filter could
+ *          not touch them: the filter works on a signature, and every
+ *          mirrored log carried the same one (`log:debug`).
+ *
+ *          This gives a machine line back its EVENT, which is the only
+ *          thing that says whether it is noise. Both formats gobj-js
+ *          emits (`gobj_set_trace_machine_format`):
+ *
+ *            0  verbose  "🔄 mach(C_TIMER^t), st: ST_IDLE, ev: EV_TIMEOUT, ac: …"
+ *                        "<- mach(C_TIMER^t), st: ST_IDLE, ev: EV_TIMEOUT, ret: 0"
+ *            1  compact  "🔄 EV_TIMEOUT C_TIMER^t ST_IDLE from C_TIMER^t"
+ *
+ *          Copyright (c) 2026, ArtGins.
+ *          All Rights Reserved.
+ ***********************************************************************/
+
+
+/*  The verbose format names itself; the compact one does not.  */
+const MACHINE_MARK_RE = /\bmach\(/;
+
+/*  Verbose: the event is the `ev:` field.  */
+const EVENT_FIELD_RE = /\bev:\s*([A-Za-z0-9_]+)/;
+
+/*  Compact: the event is the first token, behind the emoji. Anchored,
+ *  so a line that merely MENTIONS an event ("subscribed to EV_X") is
+ *  not mistaken for a transition.  */
+const EVENT_HEAD_RE = /^\s*\S{0,4}\s*(EV_[A-Za-z0-9_]+)(?=\s|$)/;
+
+/*  What "recurring" means by name. The count-based half of the filter
+ *  lives in the window, which is the only thing that can count.  */
+const PERIODIC_EVENT_RE = /PERIODIC|TIMEOUT|HEARTBEAT|PING|POLL/i;
+
+
+/************************************************************
+ *  The event of a machine trace line, or "" when the line is
+ *  not one.
+ *
+ *  "" is also the answer for a machine line that carries no
+ *  event -- a state change ("new st(…), prev st(…)") -- and
+ *  that is right: what it reports is not repetitive.
+ ************************************************************/
+function machine_event_of(text)
+{
+    if(typeof text !== "string" || text.length === 0) {
+        return "";
+    }
+
+    if(MACHINE_MARK_RE.test(text)) {
+        let m = EVENT_FIELD_RE.exec(text);
+        return m? m[1]: "";
+    }
+
+    let m = EVENT_HEAD_RE.exec(text);
+    return m? m[1]: "";
+}
+
+/************************************************************
+ *  Is this event one of the ones that arrive by themselves,
+ *  for ever, and say nothing about what the app is doing?
+ ************************************************************/
+function is_periodic_event(event_name)
+{
+    if(!event_name) {
+        return false;
+    }
+    return PERIODIC_EVENT_RE.test(event_name);
+}
+
+/************************************************************
+ *  The signature of a mirrored log line: what the window
+ *  counts it under and what its filters match on.
+ *
+ *  A machine line is signed by its EVENT, so a hundred
+ *  EV_TIMEOUTs are one recurring thing rather than a hundred
+ *  anonymous debug lines. Everything else is signed by its
+ *  level, as before.
+ ************************************************************/
+function log_signature(level, text)
+{
+    let event = machine_event_of(text);
+    if(event) {
+        return "mach:" + event;
+    }
+    return "log:" + (level || "debug");
+}
+
+/************************************************************
+ *  May the periodic filter hide this log line?
+ *
+ *  Only a machine transition, and only below warning level.
+ *  An ERROR that names EV_TIMEOUT -- "Event NOT DEFINED in
+ *  state", which is exactly the loud one the framework wants
+ *  seen -- must never disappear because of the word in it.
+ ************************************************************/
+function log_is_periodic(level, text)
+{
+    if(level === "error" || level === "warning") {
+        return false;
+    }
+    return is_periodic_event(machine_event_of(text));
+}
+
+export {
+    machine_event_of,
+    is_periodic_event,
+    log_signature,
+    log_is_periodic,
+};

package/src/dev_machine_trace.test.js

@@ -0,0 +1,98 @@
+import {describe, it, expect} from "vitest";
+import {
+    machine_event_of,
+    is_periodic_event,
+    log_signature,
+    log_is_periodic,
+} from "./dev_machine_trace.js";
+
+/*  Real lines, copied from the developer window.  */
+const VERBOSE_IN =
+    "🔄 mach(C_TIMER^demo_yuno), st: ST_IDLE, ev: EV_TIMEOUT, ac: fi(), from(C_TIMER^demo_yuno)";
+const VERBOSE_RET =
+    "<- mach(C_YUNO^demo_yuno), st: ST_IDLE, ev: EV_TIMEOUT_PERIODIC, ret: 0";
+const VERBOSE_WORK =
+    "🔄 mach(C_YUI_SHELL^shell), st: ST_IDLE, ev: EV_ROUTE_CHANGED, ac: ac_route(), from(C_YUI_NAV^nav)";
+const COMPACT =
+    "🔄 EV_TIMEOUT C_TIMER^demo_yuno ST_IDLE from C_TIMER^demo_yuno";
+const STATE_CHANGE =
+    "🔀🔀 mach(C_TCP^conn), new st(ST_CONNECTED), prev st(ST_WAIT_CONNECTED)";
+const NOT_DEFINED =
+    "📛 mach(C_X^x), st: ST_IDLE, ev: EV_TIMEOUT, 📛📛ERROR Event NOT DEFINED in state📛📛, from(C_TIMER^t)";
+
+describe("machine_event_of", () => {
+    it("reads the event out of the verbose format, both lines of it", () => {
+        expect(machine_event_of(VERBOSE_IN)).toBe("EV_TIMEOUT");
+        expect(machine_event_of(VERBOSE_RET)).toBe("EV_TIMEOUT_PERIODIC");
+        expect(machine_event_of(VERBOSE_WORK)).toBe("EV_ROUTE_CHANGED");
+    });
+
+    it("reads it out of the compact format, where it leads the line", () => {
+        expect(machine_event_of(COMPACT)).toBe("EV_TIMEOUT");
+    });
+
+    it("a state change carries no event, and says so", () => {
+        expect(machine_event_of(STATE_CHANGE)).toBe("");
+    });
+
+    it("a line that merely MENTIONS an event is not a transition", () => {
+        expect(machine_event_of("subscribed to EV_TIMEOUT of C_TIMER^t")).toBe("");
+        expect(machine_event_of("cannot send EV_ON_OPEN")).toBe("");
+    });
+
+    it("is safe on anything that is not a line", () => {
+        expect(machine_event_of("")).toBe("");
+        expect(machine_event_of(null)).toBe("");
+        expect(machine_event_of(undefined)).toBe("");
+        expect(machine_event_of(42)).toBe("");
+    });
+});
+
+describe("is_periodic_event", () => {
+    it("names the events that arrive by themselves for ever", () => {
+        expect(is_periodic_event("EV_TIMEOUT")).toBe(true);
+        expect(is_periodic_event("EV_TIMEOUT_PERIODIC")).toBe(true);
+        expect(is_periodic_event("EV_HEARTBEAT")).toBe(true);
+        expect(is_periodic_event("EV_PING")).toBe(true);
+    });
+
+    it("leaves the ones a user caused alone", () => {
+        expect(is_periodic_event("EV_ROUTE_CHANGED")).toBe(false);
+        expect(is_periodic_event("EV_ON_MESSAGE")).toBe(false);
+        expect(is_periodic_event("")).toBe(false);
+        expect(is_periodic_event(null)).toBe(false);
+    });
+});
+
+describe("log_signature", () => {
+    it("signs a machine line by its EVENT, so a hundred of them are one thing", () => {
+        expect(log_signature("debug", VERBOSE_IN)).toBe("mach:EV_TIMEOUT");
+        expect(log_signature("debug", VERBOSE_RET)).toBe("mach:EV_TIMEOUT_PERIODIC");
+        expect(log_signature("debug", COMPACT)).toBe("mach:EV_TIMEOUT");
+    });
+
+    it("signs everything else by its level, as before", () => {
+        expect(log_signature("error", "connect failed")).toBe("log:error");
+        expect(log_signature("debug", "hello")).toBe("log:debug");
+        expect(log_signature("", "hello")).toBe("log:debug");
+    });
+});
+
+describe("log_is_periodic", () => {
+    it("hides the timer traffic the filter is for", () => {
+        expect(log_is_periodic("debug", VERBOSE_IN)).toBe(true);
+        expect(log_is_periodic("debug", VERBOSE_RET)).toBe(true);
+        expect(log_is_periodic("debug", COMPACT)).toBe(true);
+    });
+
+    it("NEVER hides an error or a warning that names a timeout", () => {
+        expect(log_is_periodic("error", NOT_DEFINED)).toBe(false);
+        expect(log_is_periodic("warning", VERBOSE_RET)).toBe(false);
+        expect(log_is_periodic("error", "connection timeout")).toBe(false);
+    });
+
+    it("leaves a transition somebody caused alone", () => {
+        expect(log_is_periodic("debug", VERBOSE_WORK)).toBe(false);
+        expect(log_is_periodic("debug", "just a log line")).toBe(false);
+    });
+});

package/src/yui_dev.js

@@ -21,6 +21,16 @@ 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';
 
 /***********************************************************************
@@ -164,9 +174,20 @@ function dev_view()
     return (v === "compact" || v === "name" || v === "full") ? v : "detailed";
 }
 
+/*  ON by default. The machine trace is the reason this window
+ *  exists, and a yuno with one timer emits two lines a second for
+ *  ever: leaving the filter off meant the first thing anybody saw
+ *  after enabling Automata was a wall of EV_TIMEOUT with their own
+ *  transitions somewhere inside it. The chip turns it back off.
+ *
+ *  A CONSTANT, and not the literal in two places: the reader and the
+ *  toggle must agree on what "unset" means, or the first click on the
+ *  chip writes the value it already had and appears to do nothing. */
+const HIDE_PERIODIC_DEFAULT = 1;
+
 function dev_hide_periodic()
 {
-    return dev_num("dev_hide_periodic", 0) ? true : false;
+    return dev_num("dev_hide_periodic", HIDE_PERIODIC_DEFAULT) ? true : false;
 }
 
 /*  Where dev output (traffic + all logs + automata) is routed:
@@ -182,12 +203,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. */
@@ -240,6 +295,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();
 }
@@ -300,7 +361,21 @@ function entry_hidden(e, ctx)
 {
     if(e.kind === "log") {
         /*  Mirrored console logs respect the search box only — not the
-         *  in/out/err/periodic traffic filters. */
+         *  in/out/err traffic filters, which are about DIRECTION and a
+         *  log has none.
+         *
+         *  The PERIODIC filter does reach them, and it has to: once
+         *  Automata is on, the machine trace is what floods this
+         *  window, and every one of those lines arrives here as a log.
+         *  It applies to a machine TRANSITION only, and never above
+         *  debug level — see log_is_periodic(). By NAME and not by
+         *  count, unlike the traffic half below: a busy FSM crosses
+         *  the recurrence threshold on almost every event within
+         *  seconds, so counting here would empty the window of the
+         *  very transitions somebody turned Automata on to read. */
+        if(ctx.hide_periodic && e.periodic) {
+            return true;
+        }
         return !!(ctx.search && e.hay.indexOf(ctx.search) < 0);
     }
     if(e.dir === 1 && !ctx.out) {
@@ -1031,10 +1106,16 @@ function info_log(level, msg, hora)
         } else {
             text = is_string(msg) ? msg : String(msg);
         }
+        /*  A machine line is signed by its EVENT, not by "log:debug":
+         *  that is what makes a hundred EV_TIMEOUTs ONE recurring
+         *  thing the filter and the counter can see, instead of a
+         *  hundred anonymous debug lines they cannot tell apart. */
         let entry = {
             kind: "log", level: lvl, text: text,
             dir: 0, size: 0, ts: traffic_now(),
-            sig: "log:" + lvl, hay: (lvl + " " + text).toLowerCase(), $node: null,
+            sig: log_signature(lvl, text),
+            periodic: log_is_periodic(lvl, text),
+            hay: (lvl + " " + text).toLowerCase(), $node: null,
         };
         TRAFFIC_LOG.push(entry);
         if(TRAFFIC_LOG.length > TRAFFIC_MAX) {
@@ -1384,11 +1465,12 @@ function build_control_bar()
 
     let periodic_chip = ['button', {
         class: 'YDEV_CHIP', 'data-toggle': 'periodic', type: 'button',
-        title: 'Hide recurring / periodic events (polls, heartbeats)',
+        title: 'Hide the timers: EV_TIMEOUT / PERIODIC / HEARTBEAT / PING ' +
+            'transitions, and recurring traffic. On by default',
     }, '⊘ Periodic', {
         click: (ev) => {
             ev.stopPropagation();
-            toggle_pref('dev_hide_periodic', 0);
+            toggle_pref('dev_hide_periodic', HIDE_PERIODIC_DEFAULT);
         }
     }];