@yuneta/gobj-js 7.13.5 → 7.13.7

package/README.md

@@ -589,6 +589,10 @@ set_log_callback(fn)                      // fn(level, message)
 
 // Gate the DIRECT browser-console writes of all the functions above
 set_console_log_enabled(enabled)          // default: true (unchanged behaviour)
+
+// ...and a per-LINE say over them, on top of that switch (7.13.6)
+set_console_log_filter(fn)                // fn(level, msg) -> true to print
+set_console_log_filter(null)              // default: everything prints
 ```
 
 **Three independent output paths.** `set_console_log_enabled(false)` silences
@@ -598,6 +602,15 @@ a GUI route framework output — **including the automata/FSM trace, which arriv
 as `debug`** — into its own monitor window while keeping the browser console
 clean (gobj-ui's dev-window "Output" selector does exactly this).
 
+**Why a filter and not just the switch.** The console write happens **before**
+the sink is called, so nothing downstream can un-print a line: a consumer that
+wants one CLASS of lines kept off the console — the dev monitor hiding the
+`machine` trace's timer traffic, two `EV_TIMEOUT` lines a second for ever — can
+only say so here. The filter decides the **console alone**: the sink still
+receives every line, so a monitor keeps a complete record and decides
+separately what to show. The master switch still wins, and a filter that
+**throws** is ignored — a broken one must never be able to silence the log.
+
 ### Tracing: the `machine` trace, and the levels around it
 
 The FSM is where things happen, so the trace of the FSM **is** the execution
@@ -614,9 +627,26 @@ gobj_global_trace_level()                  // the mask in force
 gobj_trace_level(gobj)                     // global | gclass | gobj, combined
 gobj_repr_global_trace_levels()            // [{name, bit, description, set}]
 gobj_set_deep_trace(1)                     // everything, everywhere
-gobj_set_trace_machine_format(1)           // 1 = one compact line per transition
+gobj_set_trace_machine_format(1)           // 1 = simpler (DEFAULT), 0 = legacy
 ```
 
+**Two shapes for the machine trace**, the C kernel's two, and the same default
+(`1`, since 7.13.7):
+
+```
+1  🔄 EV_TIMEOUT C_TIMER^t ST_IDLE from C_TIMER^t
+0  🔄 mach(C_TIMER^t), st: ST_IDLE, ev: EV_TIMEOUT, ac: fi(), from(C_TIMER^t)
+   🔀🔀 mach(C_TIMER^t), new st(ST_IDLE), prev st(ST_IDLE)
+   <- mach(C_TIMER^t), st: ST_IDLE, ev: EV_TIMEOUT, ret: 0
+```
+
+One line per transition against three. Both name the event, so anything that
+reads the trace back by event name works across the switch. Every line is
+prefixed by its nesting depth (two spaces per level of `__inside__`), so an
+event sent from inside another one's action is indented under it — **keep that
+indentation when you render the line somewhere else**; it is the only thing
+that says a transition happened *during* another.
+
 Levels: `machine`, `create_delete`, `create_delete2`, `subscriptions`,
 `start_stop`, `ev_kw`, `authzs`, `states`, `gbuffers`, `timer`, `fs`,
 `liburing`, `timer_periodic`, `liburing_timer`, `commands`. The ones that only

package/dist/gobj-js.cjs.js

@@ -384,7 +384,7 @@ var Event_Type = class {
 function tab() {
 	return " ".repeat(Math.max(1, __inside__ * 2));
 }
-var __trace_machine_format__ = 0;
+var __trace_machine_format__ = 1;
 function gobj_set_trace_machine_format(format) {
 	__trace_machine_format__ = Number(format) === 1 ? 1 : 0;
 }
@@ -3016,6 +3016,19 @@ var __console_output_enabled__ = true;
 function set_console_log_enabled(enabled) {
 	__console_output_enabled__ = enabled ? true : false;
 }
+var __console_log_filter__ = null;
+function set_console_log_filter(fn) {
+	__console_log_filter__ = typeof fn === "function" ? fn : null;
+}
+function console_wants(level, msg) {
+	if (!__console_output_enabled__) return false;
+	if (!__console_log_filter__) return true;
+	try {
+		return __console_log_filter__(level, msg) ? true : false;
+	} catch (e) {
+		return true;
+	}
+}
 var __in_log_callback__ = false;
 function emit_log_callback(level, msg, hora) {
 	if (__log_callback__ && !__in_log_callback__) {
@@ -3063,9 +3076,9 @@ function log_error(format) {
 	let hora = current_timestamp();
 	if (f_error) {
 		if (f_error === _console.error) {
-			if (__console_output_enabled__) f_error("%c" + hora + " ERROR: " + String(msg), "color:red");
+			if (console_wants("error", msg)) f_error("%c" + hora + " ERROR: " + String(msg), "color:red");
 		} else {
-			if (__console_output_enabled__) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
+			if (console_wants("error", msg)) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
 			f_error(`${hora} ERROR: ${String(msg)}`);
 		}
 	}
@@ -3076,9 +3089,9 @@ function log_warning(format) {
 	let hora = current_timestamp();
 	if (f_warning) {
 		if (f_warning === _console.warn) {
-			if (__console_output_enabled__) f_warning("%c" + hora + " WARNING: " + String(msg), "color:yellow");
+			if (console_wants("warning", msg)) f_warning("%c" + hora + " WARNING: " + String(msg), "color:yellow");
 		} else {
-			if (__console_output_enabled__) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
+			if (console_wants("warning", msg)) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
 			f_warning(`${hora} WARNING: ${String(msg)}`);
 		}
 	}
@@ -3088,7 +3101,7 @@ function log_info(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_info) {
-		if (__console_output_enabled__) f_info("%c" + hora + " INFO: " + String(msg), "color:cyan");
+		if (console_wants("info", msg)) f_info("%c" + hora + " INFO: " + String(msg), "color:cyan");
 	}
 	emit_log_callback("info", msg, hora);
 }
@@ -3096,7 +3109,7 @@ function log_debug(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_debug) {
-		if (__console_output_enabled__) f_debug("%c" + hora + " DEBUG: " + String(msg), "color:silver");
+		if (console_wants("debug", msg)) f_debug("%c" + hora + " DEBUG: " + String(msg), "color:silver");
 	}
 	emit_log_callback("debug", msg, hora);
 }
@@ -3104,12 +3117,12 @@ function trace_msg(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_debug) {
-		if (__console_output_enabled__) f_debug("%c" + hora + " MSG: " + String(msg), "color:cyan");
+		if (console_wants("msg", msg)) f_debug("%c" + hora + " MSG: " + String(msg), "color:cyan");
 	}
 	emit_log_callback("msg", msg, hora);
 }
 function trace_json(jn, msg) {
-	if (__console_output_enabled__) {
+	if (console_wants("json", msg)) {
 		if (msg) window.console.warn("=====> " + msg);
 		window.console.dir(jn);
 	}
@@ -6861,6 +6874,7 @@ exports.safeSrc = safeSrc;
 exports.sdata_flag_t = sdata_flag_t;
 exports.send_http_json_post = send_http_json_post;
 exports.set_console_log_enabled = set_console_log_enabled;
+exports.set_console_log_filter = set_console_log_filter;
 exports.set_log_callback = set_log_callback;
 exports.set_remote_log_functions = set_remote_log_functions;
 exports.set_timeout = set_timeout;