@yuneta/gobj-ui 7.23.171 → 7.23.172

package/src/dev_machine_trace.js

@@ -1,116 +0,0 @@
-/***********************************************************************
- *          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

@@ -1,123 +0,0 @@
-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)";
-
-/*  The other four shapes the SIMPLER format emits (gobj-js 7.13.7 gave them
- *  their format-1 branch; before that they leaked `mach(…)` into it).  */
-const SIMPLE_PUBLISH = "🔝🔝 EV_STATE_CHANGED C_PROT_MQTT^input-2 ST_WAIT_FRAME_HEADER";
-const SIMPLE_FORWARD = "🔝🔄 EV_TX_READY (EV_TX_READY) C_PROT_TCP4H^output-0";
-const SIMPLE_INJECT  = "🔜 EV_ON_MESSAGE C_GATE^gate ST_IDLE";
-const SIMPLE_NESTED  = "        🔄 EV_ON_MESSAGE C_IOGATE^output-iogate-0 ST_IDLE from C_CHANNEL^output-0";
-
-describe("the simpler format's other shapes", () => {
-    it("reads the event out of a publish, a forward and an injection", () => {
-        expect(machine_event_of(SIMPLE_PUBLISH)).toBe("EV_STATE_CHANGED");
-        expect(machine_event_of(SIMPLE_FORWARD)).toBe("EV_TX_READY");
-        expect(machine_event_of(SIMPLE_INJECT)).toBe("EV_ON_MESSAGE");
-    });
-
-    it("the leading INDENTATION does not hide the event", () => {
-        expect(machine_event_of(SIMPLE_NESTED)).toBe("EV_ON_MESSAGE");
-        expect(log_is_periodic("debug", SIMPLE_NESTED)).toBe(false);
-    });
-
-    it("a periodic one is still recognised in every shape", () => {
-        expect(log_is_periodic("debug", "🔝🔝 EV_TIMEOUT C_TIMER^t ST_IDLE")).toBe(true);
-        expect(log_is_periodic("debug", "  🔜 EV_TIMEOUT_PERIODIC C_YUNO^y ST_IDLE")).toBe(true);
-    });
-});
-
-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);
-    });
-});