@yuneta/gobj-ui 7.25.18 → 7.25.19

package/src/c_yui_node.js

@@ -1278,6 +1278,65 @@ function ac_nav_clicked(gobj, event, kw, src)
     return 0;
 }
 
+/************************************************************
+ *  The ✕ of a closable item, from a projection nav.  A node's own
+ *  items never carry `closable` (child_nav_items() builds them), so
+ *  this is an item the node does not own the fate of: whether it
+ *  goes away is the app's call, as for the shell's own closable
+ *  tabs.  Handed to the shell, which re-publishes it to the app
+ *  (ac_nav_item_close there).
+ ************************************************************/
+function ac_nav_item_close(gobj, event, kw, src)
+{
+    let shell = yui_shell_of(gobj);
+    if(!shell) {
+        log_error(`${GCLASS_NAME} '${node_path_str(gobj)}': no shell to hand ` +
+            `the close of '${(kw && kw.item_id) || ""}' to`);
+        return -1;
+    }
+    gobj_send_event(shell, "EV_NAV_ITEM_CLOSE", {
+        item_id: (kw && kw.item_id) || "",
+        route:   (kw && kw.route) || "",
+        menu_id: (kw && kw.menu_id) || "",
+        zone:    (kw && kw.zone) || ""
+    }, gobj);
+    return 0;
+}
+
+/************************************************************
+ *  The backdrop of a drawer projection was clicked.  The drawer is
+ *  one of MY navs (a projection with `layout: "drawer"`), not one of
+ *  the shell's, so the shell's close_drawer() cannot find it: the
+ *  node closes it.  A drawer opened through the shell carries the
+ *  shell's own close handler (escape stack, focus trap) on its
+ *  element, and that is what runs then; otherwise it is only hidden.
+ ************************************************************/
+function ac_drawer_close_requested(gobj, event, kw, src)
+{
+    let priv = gobj.priv;
+    let menu_id = (kw && kw.menu_id) || "";
+    let navs = priv.navs.concat(Object.values(priv.zone_navs));
+
+    for(let nav of navs) {
+        if(gobj_read_attr(nav, "layout") !== "drawer") {
+            continue;
+        }
+        if(menu_id && gobj_read_attr(nav, "menu_id") !== menu_id) {
+            continue;
+        }
+        let $c = gobj_read_attr(nav, "$container");
+        if(!$c || !$c.classList.contains("is-active")) {
+            continue;
+        }
+        if(typeof $c.__yui_close_handler__ === "function") {
+            $c.__yui_close_handler__();
+        } else {
+            $c.classList.remove("is-active");
+        }
+    }
+    return 0;
+}
+
 /************************************************************
  *  Runtime API: add a child.  Same path the declared tree takes.
  ************************************************************/
@@ -1666,6 +1725,12 @@ function create_gclass(gclass_name)
         ["ST_OFF", [
             ["EV_ROUTE_CHANGED",        ac_route_changed,       null],
             ["EV_ACTIVATE",             ac_activate,            null],
+            /*  A ZONE projection outlives the path (it is the app's
+             *  standing chrome, stopped only in mt_stop), so its clicks
+             *  reach a root that is off the path too.  */
+            ["EV_NAV_CLICKED",            ac_nav_clicked,             null],
+            ["EV_NAV_ITEM_CLOSE",         ac_nav_item_close,          null],
+            ["EV_DRAWER_CLOSE_REQUESTED", ac_drawer_close_requested,  null],
             ["EV_ADD_NODE",             ac_add_node,            null],
             ["EV_REMOVE_NODE",          ac_remove_node,         null],
             ["EV_SET_PROJECTION",       ac_set_projection,      null],
@@ -1679,6 +1744,8 @@ function create_gclass(gclass_name)
             ["EV_ACTIVATE",             ac_activate,            null],
             ["EV_DEACTIVATE",           ac_deactivate,          null],
             ["EV_NAV_CLICKED",          ac_nav_clicked,         null],
+            ["EV_NAV_ITEM_CLOSE",         ac_nav_item_close,          null],
+            ["EV_DRAWER_CLOSE_REQUESTED", ac_drawer_close_requested,  null],
             ["EV_ADD_NODE",             ac_add_node,            null],
             ["EV_REMOVE_NODE",          ac_remove_node,         null],
             ["EV_SET_PROJECTION",       ac_set_projection,      null],
@@ -1692,6 +1759,8 @@ function create_gclass(gclass_name)
             ["EV_ACTIVATE",             ac_activate,            null],
             ["EV_DEACTIVATE",           ac_deactivate,          null],
             ["EV_NAV_CLICKED",          ac_nav_clicked,         null],
+            ["EV_NAV_ITEM_CLOSE",         ac_nav_item_close,          null],
+            ["EV_DRAWER_CLOSE_REQUESTED", ac_drawer_close_requested,  null],
             ["EV_ADD_NODE",             ac_add_node,            null],
             ["EV_REMOVE_NODE",          ac_remove_node,         null],
             ["EV_SET_PROJECTION",       ac_set_projection,      null],
@@ -1710,6 +1779,8 @@ function create_gclass(gclass_name)
         ["EV_ACTIVATE",             0],
         ["EV_DEACTIVATE",           0],
         ["EV_NAV_CLICKED",          0],
+        ["EV_NAV_ITEM_CLOSE",         0],
+        ["EV_DRAWER_CLOSE_REQUESTED", 0],
         ["EV_ADD_NODE",             0],
         ["EV_REMOVE_NODE",          0],
         ["EV_SET_PROJECTION",       0],

package/src/c_yui_schema_editor.js

@@ -755,8 +755,11 @@ function remote_command(gobj, command, kw, tag)
      *  echoes `__md_command__` AS that frame (c_agent_treedb_link.js).
      *  Same names in both places is what makes the answer readable
      *  whichever one is under this view — and `record_id` is here and
-     *  NOT at the top level because a delete answers with nothing, and a
-     *  parameter the treedb does not know has no business travelling.  */
+     *  NOT at the top level because a parameter the treedb does not know
+     *  has no business travelling. It is echoed at all because an answer
+     *  does not always name its record: a delete answers the node deleted,
+     *  but a REFUSED write answers none, and the view still has to know
+     *  which record it was.  */
     full_kw.__md_command__ = Object.assign({
         purpose:    PURPOSE,
         topic_name: (kw && kw.topic_name) || "",
@@ -981,8 +984,12 @@ function current_topic(gobj)
  *  One line for what the whole view has to say: loading, empty,
  *  or the reason nothing loaded. Carries its i18n key, so it
  *  follows a language change like any other text.
+ *
+ *  `detail` is a NAME (a treedb, a topic) shown as it is, unless
+ *  `detail_is_key` says it is a key: a name is not text to
+ *  translate, and a topic called `nodes` is not "Nodos".
  ***************************************************************/
-function show_notice(gobj, key, detail)
+function show_notice(gobj, key, detail, detail_is_key)
 {
     let $notice = $of(gobj, ".SCHEMA_NOTICE");
 
@@ -998,14 +1005,17 @@ function show_notice(gobj, key, detail)
     $notice.appendChild(createElement2(
         ["span", {class: "SCHEMA_NOTICE_TEXT", i18n: key}, t(key)]
     ));
-    /*  The detail is a KEY too (ours, or the backend's words, which
-     *  translate to themselves when no locale has them), so a change
-     *  of language changes it with the rest. One that repeats the
-     *  title says nothing.  */
+    /*  A detail that is a KEY (the load error: ours, or the backend's
+     *  words, which translate to themselves when no locale has them)
+     *  changes language with the rest. One that repeats the title
+     *  says nothing.  */
     if(detail && detail !== key) {
+        let attrs = {class: "SCHEMA_NOTICE_DETAIL yui-text-quiet ml-2"};
+        if(detail_is_key) {
+            attrs.i18n = `${detail}`;
+        }
         $notice.appendChild(createElement2(
-            ["span", {class: "SCHEMA_NOTICE_DETAIL yui-text-quiet ml-2", i18n: `${detail}`},
-                t(`${detail}`)]
+            ["span", attrs, detail_is_key ? t(`${detail}`) : `${detail}`]
         ));
     }
 }
@@ -1188,7 +1198,7 @@ function render(gobj)
     }
     if(state === "ST_IDLE") {
         show_notice(gobj, priv.load_error ? "cannot load the schemas" : "not connected",
-            priv.load_error);
+            priv.load_error, true);
         destroy_diagram(gobj);
         clear($body);
         return;

package/src/c_yui_treedb_topic_with_form.js

@@ -3696,6 +3696,27 @@ function refuse_if_readonly(gobj, event)
 /************************************************************
  *  From external, at the beginning, load all topic data
  ************************************************************/
+/***************************************************************
+ *  One of MY json viewers (the schema, a cell, the table's records)
+ *  met a `__collapsed__` sentinel and the reader opened it. The
+ *  viewer never fetches: it asks its host, and waits on "loading"
+ *  until it is answered. This view holds records, not a store it can
+ *  read a subtree of -- the lazy drill is `print-tranger`, which the
+ *  TOPICS view runs for its own viewer, over a whole tranger -- so the
+ *  answer is that it cannot, and the viewer shows that on the stub
+ *  instead of loading for ever.
+ ***************************************************************/
+function ac_expand_path(gobj, event, kw, src)
+{
+    let path = (kw && kw.path) || "";
+
+    gobj_send_event(src, "EV_SUBTREE_ERROR", {
+        path:  path,
+        error: t("this part cannot be loaded here")
+    }, gobj);
+    return 0;
+}
+
 /***************************************************************
  *  The language changed (the shell publishes it after the app switched).
  *
@@ -5343,6 +5364,7 @@ function create_gclass(gclass_name)
             ["EV_CHANGE_LOCALE",        ac_change_locale,      null],
             ["EV_REFRESH",              ac_refresh,            null],
             ["EV_SHOW_SCHEMA",          ac_show_schema,        null],
+            ["EV_EXPAND_PATH",          ac_expand_path,        null],
             ["EV_CELL_EDITED",          ac_cell_edited,        null],
             ["EV_REPULL_PAGE",          ac_repull_page,        null],
             ["EV_PAGE_LOADED",          ac_page_loaded,        null],
@@ -5400,6 +5422,7 @@ function create_gclass(gclass_name)
         ["EV_CHANGE_LOCALE",        0],
         ["EV_REFRESH",              0],
         ["EV_SHOW_SCHEMA",          0],
+        ["EV_EXPAND_PATH",          0],
         ["EV_CELL_EDITED",          0],
         ["EV_REPULL_PAGE",          0],
         ["EV_PAGE_LOADED",          0],

package/src/c_yui_treedb_topics.js

@@ -1676,7 +1676,7 @@ function treedb_create_node(gobj, treedb_name, topic_name, record, options)
 /************************************************************
  *  Command to remote service
  ************************************************************/
-function treedb_update_node(gobj, treedb_name, topic_name, record, options, form_write)
+function treedb_update_node(gobj, treedb_name, topic_name, record, options, form_write, created)
 {
     let command = "update-node";
 
@@ -1695,6 +1695,11 @@ function treedb_update_node(gobj, treedb_name, topic_name, record, options, form
     if(form_write) {
         kw.__md_command__.form_write = form_write;
     }
+    if(created) {
+        /*  A create goes out as an update-node (create_only); the answer
+         *  says `created` only if the request says it back.  */
+        kw.__md_command__.created = true;
+    }
     // TODO review msg_iev_write_key(kw, "__topic_name__", topic_name);
 
     let ret = gobj_command(
@@ -1740,7 +1745,9 @@ function treedb_delete_node(gobj, treedb_name, topic_name, record, options)
     );
     if(ret) {
         log_error(ret);
+        return -1;
     }
+    return 0;
 }
 
 /************************************************************
@@ -2217,6 +2224,7 @@ function ac_mt_command_answer(gobj, event, kw, src)
 
         case "create-node":
         case "update-node":
+        case "delete-node":
             /*
              *  The view refreshes itself from the treedb's own
              *  EV_TREEDB_NODE_* events, which arrive for EVERY writer. This
@@ -2230,14 +2238,23 @@ function ac_mt_command_answer(gobj, event, kw, src)
             /*  From what THIS view knows and from the answer, never from
              *  the request: the frame carries back only `__md_command__`,
              *  so `treedb_name` and `record` read there arrived empty.
-             *  `record` is the node the store answered, as it was written.  */
+             *  `record` is the node the store answered, as it was written
+             *  (for a delete, the node deleted). The table's own +New goes
+             *  out as an update-node, so `created` is also what the request
+             *  echoes back in `__md_command__`.  */
             gobj_publish_event(gobj, "EV_RECORD_WRITTEN", {
                 treedb_name: gobj_read_str_attr(gobj, "treedb_name"),
                 topic_name:  kw_get_str(gobj, kw_command, "topic_name", "", 0),
                 record:      answered_record(data),
-                created:     (command === "create-node"),
+                created:     (command === "create-node") ||
+                             kw_command.created === true,
                 command:     command
             });
+            if(command === "delete-node") {
+                /*  The rows go away on the treedb's own EV_TREEDB_NODE_DELETED;
+                 *  a delete has no form waiting for its answer.  */
+                break;
+            }
             settle_form_write(gobj.priv.form_writes,
                 kw_get_int(gobj, kw_command, "form_write", 0, 0),
                 kw_get_str(gobj, kw_command, "topic_name", "", 0));
@@ -2249,10 +2266,6 @@ function ac_mt_command_answer(gobj, event, kw, src)
             );
             break;
 
-        case "delete-node":
-            // Don't process by here, process on subscribed events.
-            break;
-
         default:
             log_error(`${gobj_short_name(gobj)} Command unknown: ${command}`);
     }
@@ -2680,7 +2693,7 @@ function ac_create_record(gobj, event, kw, src)
     };
 
     if(treedb_update_node( // HACK use the powerful update_node
-            gobj, treedb_name, topic_name, record, options, form_write) < 0) {
+            gobj, treedb_name, topic_name, record, options, form_write, true) < 0) {
         answer_form_write(gobj, src, form_write, false);
         return -1;      /*  Error already logged  */
     }

package/src/c_yui_uplot.js

@@ -3,7 +3,7 @@
  *
  *          Graphics, Charts with uPlot
  *
- *          Copyright (c) 2025, ArtGins.
+ *          Copyright (c) 2025-2026, ArtGins.
  *          All Rights Reserved.
  ***********************************************************************/
 
@@ -12,14 +12,12 @@ import {
     SDATA_END,
     data_type_t,
     event_flag_t,
-    kw_flag_t,
     gclass_create,
     createElement2,
     log_error,
     gobj_read_pointer_attr,
     gobj_parent,
     gobj_subscribe_event,
-    kw_get_str,
     gobj_read_attr,
     gobj_read_str_attr,
     gobj_write_attr,
@@ -457,8 +455,15 @@ function ac_add_serie(gobj, event, kw, src)
      *  colour: the old fallback was `Orange`, 1.97:1 on a white page,
      *  and it was what every series past the fourth got.  */
     let color = colors[Math.max(0, idx - 1) % colors.length];
-    kw_get_str(gobj, kw, "stroke", color.stroke, kw_flag_t.KW_CREATE);
-    kw_get_str(gobj, kw, "fill", color.fill, kw_flag_t.KW_CREATE);
+    /*  Only when the host gave none: uPlot takes a stroke or a fill
+     *  that is a FUNCTION (or a gradient) too, and kw_get_str() logs
+     *  a value that is not a string (gobj-js 7.25.5, as C does).  */
+    if(kw.stroke === undefined) {
+        kw.stroke = color.stroke;
+    }
+    if(kw.fill === undefined) {
+        kw.fill = color.fill;
+    }
     //kw["paths"] = beziercurve_path; //rectangle_path;
     uplot.addSeries(kw);
     return 0;

package/src/form_json_expand.wiring.test.js

@@ -0,0 +1,121 @@
+/***********************************************************************
+ *          form_json_expand.wiring.test.js
+ *
+ *      C_YUI_TREEDB_TOPIC_WITH_FORM hosts C_YUI_JSON as a pure CHILD
+ *      (the schema, a cell, the table's records), so it hears every
+ *      event the viewer publishes -- and it did not declare
+ *      EV_EXPAND_PATH, which the viewer publishes when the reader opens
+ *      a `__collapsed__` sentinel. The click answered "Event NOT DEFINED
+ *      in state" and the stub stayed on "loading" for good. The form
+ *      cannot read a subtree (that is print-tranger, which the TOPICS
+ *      view runs for its own viewer), so it says so, and the stub shows
+ *      it.
+ *
+ *      Driven through the real gclasses (C_YUI_SHELL,
+ *      C_YUI_TREEDB_TOPIC_WITH_FORM, C_YUI_JSON) on a document double:
+ *      the event is published by the real viewer the form created.
+ *
+ *          Copyright (c) 2026, ArtGins.
+ *          All Rights Reserved.
+ ***********************************************************************/
+import {describe, test, expect, beforeAll, beforeEach} from "vitest";
+import {install_dom_double} from "../test/dom_double.js";
+
+install_dom_double();
+
+/*  A phone: the viewer opens in the shell's sheet, not in a
+ *  C_YUI_WINDOW, whose markup the document double cannot parse.  */
+globalThis.innerWidth = 400;
+if(globalThis.window) {
+    globalThis.window.innerWidth = 400;
+}
+
+/*  Tabulator watches its table; the document double has no observer.  */
+if(typeof globalThis.ResizeObserver === "undefined") {
+    globalThis.ResizeObserver = class {
+        observe() {}
+        unobserve() {}
+        disconnect() {}
+    };
+}
+
+const {
+    SDATA_END, gclass_create,
+    gobj_start_up, gobj_create_yuno, gobj_create, gobj_create_service,
+    gobj_start, gobj_send_event, gobj_current_state,
+    set_log_callback,
+} = await import("@yuneta/gobj-js");
+const {register_c_yui_shell} = await import("./c_yui_shell.js");
+const {register_c_yui_json} = await import("./c_yui_json.js");
+const {register_c_yui_treedb_topic_with_form} = await import("./c_yui_treedb_topic_with_form.js");
+
+const logged = [];
+let yuno = null;
+
+beforeAll(async () => {
+    /*  The app's i18next, with no locale: a key answers itself.  */
+    const i18next = (await import("i18next")).default;
+    await i18next.init({lng: "en", resources: {}});
+    gobj_start_up(null, null, null, null, null, null, null);
+    set_log_callback((level, msg) => {
+        logged.push({level: String(level), msg: String(msg)});
+    });
+    gclass_create("C_TEST_HOST", [], [["ST_IDLE", []]], {}, 0, [SDATA_END()], {}, 0, 0, 0, 0);
+    register_c_yui_shell();
+    register_c_yui_json();
+    register_c_yui_treedb_topic_with_form();
+    yuno = gobj_create_yuno("form_json_yuno", "C_TEST_HOST", {});
+    gobj_start(yuno);
+});
+
+beforeEach(() => {
+    logged.length = 0;
+});
+
+const DESC = {
+    id: "users",
+    pkey: "id",
+    cols: {
+        id:   {id: "id", header: "Id", type: "string", flag: ["persistent", "required"]},
+        name: {id: "name", header: "Name", type: "string", flag: ["persistent", "writable"]}
+    }
+};
+
+function errors()
+{
+    return logged.filter((l) => l.level === "error").map((l) => l.msg);
+}
+
+describe("a viewer of the form asks to load a truncated part", () => {
+
+    test("the form answers that it cannot, and the stub stops loading", () => {
+        const app = gobj_create("f1_app", "C_TEST_HOST", {}, yuno);
+        const shell = gobj_create("f1_shell", "C_YUI_SHELL",
+            {config: {shell: {}}, default_route: "/home", subscriber: app}, app);
+        gobj_start(shell);
+        const form = gobj_create_service("f1_form", "C_YUI_TREEDB_TOPIC_WITH_FORM", {
+            treedb_name: "treedb_test",
+            topic_name: "users",
+            desc: DESC
+        }, shell);
+        gobj_start(form);
+
+        logged.length = 0;
+        gobj_send_event(form, "EV_SHOW_SCHEMA", {}, form);
+        const viewer = form.priv.schema_gobj;
+        expect(viewer).toBeTruthy();
+        expect(gobj_current_state(viewer)).toBe("ST_READY");
+        logged.length = 0;
+
+        /*  What the stub's click sends: the viewer then PUBLISHES
+         *  EV_EXPAND_PATH to its host.  */
+        gobj_send_event(viewer, "EV_EXPAND_COLLAPSED", {path: "cols`name", size: 40}, viewer);
+
+        expect(viewer.priv.pending.has("cols`name")).toBe(false);
+        expect(viewer.priv.errors.get("cols`name")).toBe("this part cannot be loaded here");
+        /*  The viewer logs what it could not load; nothing else is.  */
+        expect(errors()).toEqual([
+            "C_YUI_JSON: subtree load failed at 'cols`name': this part cannot be loaded here"
+        ]);
+    });
+});

package/src/g6_graphs_write_owed.wiring.test.js

@@ -188,6 +188,43 @@ describe("a refused __graphs__ write keeps the Save lit", () => {
         expect(errors()).toEqual([]);
     });
 
+    /*  Before gobj-ui 7.25.19 only a Save that planned the topic paid
+     *  what was owed. Save #1 and Save #2 both write `users`, #1 is
+     *  refused and its answer lands after #2's echo: the echo made the
+     *  topic saved, so no Save planned it again, and the button stayed
+     *  lit over nothing to write until a reload.  */
+    test("an echo of the topic pays what was owed: the Save goes dark", () => {
+        const g = build("edition");
+        g.tree.priv.descs = {};
+        g.tree.priv.__graphs__ = [];
+        gobj_send_event(g.tree, "EV_GRAPHS_WRITE_REFUSED", {topic: "users"}, g.tree);
+        expect(g.lit()).toBe(true);
+
+        gobj_send_event(g.tree, "EV_NODE_UPDATED", {
+            topic_name: "__graphs__",
+            node: {id: "users", topic: "users", active: true,
+                properties: {nodes: {u1: {x: 30, y: 40}}}}
+        }, g.tree);
+        expect(g.lit()).toBe(false);
+
+        gobj_send_event(g.tree, "EV_SAVE_GRAPH", {}, g.tree);
+        expect(published.filter((p) => p.event === "EV_UPDATE_NODE")).toEqual([]);
+        expect(errors()).toEqual([]);
+    });
+
+    test("an echo of ANOTHER topic leaves it owed", () => {
+        const g = build("edition");
+        g.tree.priv.descs = {};
+        g.tree.priv.__graphs__ = [];
+        gobj_send_event(g.tree, "EV_GRAPHS_WRITE_REFUSED", {topic: "users"}, g.tree);
+        gobj_send_event(g.tree, "EV_NODE_UPDATED", {
+            topic_name: "__graphs__",
+            node: {id: "roles", topic: "roles", active: true, properties: {nodes: {}}}
+        }, g.tree);
+        expect(g.lit()).toBe(true);
+        expect(errors()).toEqual([]);
+    });
+
     test("a reload forgets it: the view holds what the backend holds", () => {
         const g = build("edition");
         gobj_send_event(g.tree, "EV_GRAPHS_WRITE_REFUSED", {topic: "users"}, g.tree);

package/src/node_nav_events.wiring.test.js

@@ -0,0 +1,150 @@
+/***********************************************************************
+ *          node_nav_events.wiring.test.js
+ *
+ *      C_YUI_NODE hosts C_YUI_NAV as a pure CHILD, so it hears every
+ *      event the nav publishes -- and it declared only EV_NAV_CLICKED.
+ *      EV_NAV_ITEM_CLOSE (the ✕ of a closable item) and
+ *      EV_DRAWER_CLOSE_REQUESTED (the backdrop of a drawer projection,
+ *      a layout a node may declare) answered "Event NOT DEFINED in
+ *      state" -- and the drawer stayed open, because the shell that
+ *      closes drawers knows only its own navs. A zone projection also
+ *      outlives the path (it is stopped only in mt_stop), so the clicks
+ *      of a root that is off the path landed on ST_OFF, which declared
+ *      none of the three.
+ *
+ *      Driven through the real gclasses (C_YUI_SHELL, C_YUI_NODE,
+ *      C_YUI_NAV) on a document double: each event is published by the
+ *      real nav the node created.
+ *
+ *          Copyright (c) 2026, ArtGins.
+ *          All Rights Reserved.
+ ***********************************************************************/
+import {describe, test, expect, beforeAll, beforeEach} from "vitest";
+import {install_dom_double} from "../test/dom_double.js";
+
+install_dom_double();
+
+const {
+    SDATA_END, gclass_create,
+    gobj_start_up, gobj_create_yuno, gobj_create, gobj_create_pure_child,
+    gobj_start, gobj_send_event, gobj_publish_event, gobj_read_attr,
+    gobj_current_state, gobj_change_state,
+    set_log_callback,
+} = await import("@yuneta/gobj-js");
+const {register_c_yui_shell} = await import("./c_yui_shell.js");
+const {register_c_yui_nav} = await import("./c_yui_nav.js");
+const {register_c_yui_node} = await import("./c_yui_node.js");
+
+const logged = [];
+const closed = [];          /*  the EV_NAV_ITEM_CLOSE the app heard  */
+let yuno = null;
+
+beforeAll(() => {
+    gobj_start_up(null, null, null, null, null, null, null);
+    set_log_callback((level, msg) => {
+        logged.push({level: String(level), msg: String(msg)});
+    });
+    gclass_create("C_TEST_HOST", [], [["ST_IDLE", []]], {}, 0, [SDATA_END()], {}, 0, 0, 0, 0);
+    /*  An app that uses closable items: it declares what the shell
+     *  re-publishes.  */
+    gclass_create(
+        "C_TEST_APP",
+        [["EV_NAV_ITEM_CLOSE", 0]],
+        [["ST_IDLE", [
+            ["EV_NAV_ITEM_CLOSE", (gobj, event, kw) => {
+                closed.push(kw);
+                return 0;
+            }, null]
+        ]]],
+        {}, 0, [SDATA_END()], {}, 0, 0, 0, 0
+    );
+    register_c_yui_shell();
+    register_c_yui_nav();
+    register_c_yui_node();
+    yuno = gobj_create_yuno("node_nav_yuno", "C_TEST_HOST", {});
+    gobj_start(yuno);
+});
+
+beforeEach(() => {
+    logged.length = 0;
+    closed.length = 0;
+});
+
+let seq = 0;
+
+/*  A tree under a shell, on the path, projecting its children with
+ *  `layout`. Returns the tree and the nav it created.  */
+function build(layout)
+{
+    const name = `n${++seq}`;
+    const app = gobj_create(`${name}_app`, "C_TEST_APP", {}, yuno);
+    gobj_start(app);
+    const shell = gobj_create(`${name}_shell`, "C_YUI_SHELL",
+        {config: {shell: {}}, default_route: "/home", subscriber: app}, app);
+    gobj_start(shell);
+    const tree = gobj_create_pure_child(`${name}_tree`, "C_YUI_NODE", {
+        node_id: "root",
+        base_route: "/tree",
+        projection: {index: {layout: layout}},
+        children: [{id: "a", label: "A"}, {id: "b", label: "B"}]
+    }, shell);
+    gobj_start(tree);
+    gobj_send_event(tree, "EV_ROUTE_CHANGED", {base: "/tree", subpath: ""}, shell);
+    expect(gobj_current_state(tree)).toBe("ST_SELF");
+    const nav = tree.priv.navs[0];
+    expect(nav).toBeTruthy();
+    expect(gobj_read_attr(nav, "layout")).toBe(layout);
+    logged.length = 0;
+    return {app, shell, tree, nav};
+}
+
+function errors()
+{
+    return logged.filter((l) => l.level === "error").map((l) => l.msg);
+}
+
+describe("the events of a C_YUI_NAV reach its C_YUI_NODE", () => {
+
+    test("EV_NAV_ITEM_CLOSE is handed to the shell, and the app hears it", () => {
+        const {nav} = build("tabs");
+        gobj_publish_event(nav, "EV_NAV_ITEM_CLOSE", {
+            item_id: "a", route: "/tree/a", menu_id: "node./tree", zone: ""
+        });
+        expect(errors()).toEqual([]);
+        expect(closed).toEqual([{
+            item_id: "a", route: "/tree/a", menu_id: "node./tree", zone: ""
+        }]);
+    });
+
+    test("EV_DRAWER_CLOSE_REQUESTED closes the node's own drawer", () => {
+        const {nav} = build("drawer");
+        const $drawer = gobj_read_attr(nav, "$container");
+        $drawer.classList.add("is-active");
+
+        gobj_publish_event(nav, "EV_DRAWER_CLOSE_REQUESTED", {
+            menu_id: gobj_read_attr(nav, "menu_id")
+        });
+        expect(errors()).toEqual([]);
+        expect($drawer.classList.contains("is-active")).toBe(false);
+    });
+
+    test("a drawer of another menu is left open", () => {
+        const {nav} = build("drawer");
+        const $drawer = gobj_read_attr(nav, "$container");
+        $drawer.classList.add("is-active");
+        gobj_publish_event(nav, "EV_DRAWER_CLOSE_REQUESTED", {menu_id: "other"});
+        expect(errors()).toEqual([]);
+        expect($drawer.classList.contains("is-active")).toBe(true);
+    });
+
+    test("off the path, a nav that is still there is heard too", () => {
+        const {tree, nav} = build("tabs");
+        /*  What a zone nav is: alive while its root is off the path.  */
+        gobj_change_state(tree, "ST_OFF");
+        gobj_publish_event(nav, "EV_NAV_ITEM_CLOSE", {item_id: "b"});
+        gobj_publish_event(nav, "EV_DRAWER_CLOSE_REQUESTED", {menu_id: "x"});
+        gobj_publish_event(nav, "EV_NAV_CLICKED", {route: "/tree/a", item_id: "a"});
+        expect(errors()).toEqual([]);
+        expect(closed.map((c) => c.item_id)).toEqual(["b"]);
+    });
+});