@yuneta/gobj-ui 7.25.18 → 7.25.20

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;
@@ -2810,6 +2820,19 @@ function run_next_write(gobj)
     let command = write_command(write.op);
     let options = write_options(write.op);
 
+    /*  Out of session a write is not sent, and ends here. A direct
+     *  C_IEVENT_CLI answers a command out of session with null -- the
+     *  answer of a request that LEFT -- so without this the editor
+     *  waited in ST_SAVING, inert, for an answer that never comes
+     *  (before gobj-ui 7.25.20). What the queue wrote before is not
+     *  known to the next session: it reads the model again.  */
+    if(!transport_in_session(gobj)) {
+        log_warning(`${gobj_short_name(gobj)}: no session, '${command}' ` +
+            `of '${write.topic_name}' was not sent`);
+        priv.reload_on_open = true;
+        return end_writes(gobj, "cannot reach the treedb");
+    }
+
     priv.write_tag++;
     if(remote_command(gobj, command, {
         topic_name: write.topic_name,
@@ -2817,7 +2840,7 @@ function run_next_write(gobj)
         options:    options,
         record_id:  write.record.id || ""
     }, {write: priv.write_tag}) < 0) {
-        return end_writes(gobj, t("cannot reach the treedb"));
+        return end_writes(gobj, "cannot reach the treedb");  /*  a key: the toast translates it  */
     }
     return 0;
 }

package/src/c_yui_treedb_graph.js

@@ -1325,7 +1325,7 @@ function request_print_tranger(gobj, path)
         let jv = priv.json_gobj;
         if(path && jv && is_gobj(jv) && !gobj_is_destroying(jv)) {
             gobj_send_event(jv, "EV_SUBTREE_ERROR",
-                {path: path, error: t("no session")}, gobj);
+                {path: path, i18n: "no session"}, gobj);
         }
         return;
     }
@@ -1498,7 +1498,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)
+function treedb_update_node(gobj, treedb_name, topic_name, record, options, graphs_load)
 {
     let priv = gobj.priv;
 
@@ -1525,6 +1525,11 @@ function treedb_update_node(gobj, treedb_name, topic_name, record, options)
      *  arranges, so that topic has to travel here.  */
     if(topic_name === "__graphs__") {
         kw.__md_command__.graph_topic = graph_topic_of(record);
+        /*  And the engine's LOAD it was sent from: a refusal answered
+         *  after a reload is not about the arrangement shown now.  */
+        if(graphs_load !== undefined) {
+            kw.__md_command__.graphs_load = graphs_load;
+        }
     }
 
     let ret = gobj_command(priv.gobj_remote_yuno,
@@ -2162,7 +2167,8 @@ function ac_mt_command_answer(gobj, event, kw, src)
             if(result < 0 && command === "update-node") {
                 graphs_write_refused(gobj,
                     kw_get_str(gobj, kw_command, "topic_name", "", 0),
-                    kw_get_str(gobj, kw_command, "graph_topic", "", 0));
+                    kw_get_str(gobj, kw_command, "graph_topic", "", 0),
+                    kw_command ? kw_command.graphs_load : undefined);
             }
             if(result >= 0 &&
                 kw_get_str(gobj, kw_command, "topic_name", "", 0) !== "__graphs__") {
@@ -2533,9 +2539,10 @@ function ac_update_node(gobj, event, kw, src)
     let topic_name = kw.topic_name;
     let record = kw.record;
     let options = kw.options || {};
+    let graphs_load = kw.graphs_load;
 
     if(refuse_if_readonly(gobj, event)) {
-        graphs_write_refused(gobj, topic_name, graph_topic_of(record));
+        graphs_write_refused(gobj, topic_name, graph_topic_of(record), graphs_load);
         return -1;
     }
 
@@ -2545,7 +2552,7 @@ function ac_update_node(gobj, event, kw, src)
     if(topic_name === "__graphs__" && !is_connected(gobj)) {
         log_warning(`${gobj_short_name(gobj)}: no session, the arrangement ` +
             `was not sent`);
-        graphs_write_refused(gobj, topic_name, graph_topic_of(record));
+        graphs_write_refused(gobj, topic_name, graph_topic_of(record), graphs_load);
         return -1;
     }
 
@@ -2554,10 +2561,11 @@ function ac_update_node(gobj, event, kw, src)
         treedb_name,
         topic_name,
         record,
-        options
+        options,
+        graphs_load
     );
     if(ret < 0) {
-        graphs_write_refused(gobj, topic_name, graph_topic_of(record));
+        graphs_write_refused(gobj, topic_name, graph_topic_of(record), graphs_load);
     }
     return ret;
 }
@@ -2578,9 +2586,11 @@ function graph_topic_of(record)
  *  (C_G6_NODES_TREE) took it for granted when it left -- nothing
  *  answers it when it lands -- so it is told, and its next Save
  *  writes the topic again. Other topics are the operator's data:
- *  the answer's error says what happened to them.
+ *  the answer's error says what happened to them. `graphs_load` is
+ *  the engine's load the write was sent from, handed back so it can
+ *  tell a refusal of an earlier load from one of the current.
  ************************************************************/
-function graphs_write_refused(gobj, topic_name, topic)
+function graphs_write_refused(gobj, topic_name, topic, graphs_load)
 {
     let priv = gobj.priv;
 
@@ -2594,7 +2604,11 @@ function graphs_write_refused(gobj, topic_name, topic)
     if(!priv.gobj_nodes_tree) {
         return;     /*  no engine: nothing believes it was saved  */
     }
-    gobj_send_event(priv.gobj_nodes_tree, "EV_GRAPHS_WRITE_REFUSED", {topic: topic}, gobj);
+    let kw = {topic: topic};
+    if(graphs_load !== undefined) {
+        kw.graphs_load = graphs_load;
+    }
+    gobj_send_event(priv.gobj_nodes_tree, "EV_GRAPHS_WRITE_REFUSED", kw, gobj);
 }
 
 /********************************************

package/src/c_yui_treedb_topic_with_form.js

@@ -3696,6 +3696,28 @@ 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,
+        i18n:      "this part cannot be loaded here",
+        by_design: true
+    }, gobj);
+    return 0;
+}
+
 /***************************************************************
  *  The language changed (the shell publishes it after the app switched).
  *
@@ -5343,6 +5365,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 +5423,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;
 }
 
 /************************************************************
@@ -1948,7 +1955,7 @@ function request_print_tranger(gobj, path)
         let jv = priv.json_gobj;
         if(path && jv && is_gobj(jv) && !gobj_is_destroying(jv)) {
             gobj_send_event(jv, "EV_SUBTREE_ERROR",
-                {path: path, error: t("no session")}, gobj);
+                {path: path, i18n: "no session"}, gobj);
         }
         return;
     }
@@ -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,204 @@
+/***********************************************************************
+ *          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,
+    gobj_create_pure_child, gobj_read_attr,
+    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 {t} = await import("i18next");
+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);
+}
+
+function warnings()
+{
+    return logged.filter((l) => l.level === "warning").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);
+        /*  The KEY travels, not its translation: the stub draws t(key)
+         *  with data-i18n, so it changes language with the app.  */
+        expect(viewer.priv.errors.get("cols`name")).toEqual(
+            {error: "this part cannot be loaded here", is_key: true});
+        /*  A host saying it cannot, by design, is a WARNING: an ERROR
+         *  on every click broke the clean-console check of a deploy and
+         *  reached the backend through the remote log.  */
+        expect(errors()).toEqual([]);
+        expect(warnings()).toEqual([
+            "C_YUI_JSON: subtree not loaded at 'cols`name': this part cannot be loaded here"
+        ]);
+
+    });
+});
+
+describe("the stub of a subtree that was not loaded", () => {
+
+    /*  A host answering with a KEY that it cannot, by design.  */
+    function make_viewer(name, answer)
+    {
+        gclass_create(`C_TEST_JSON_HOST_${name}`, [["EV_EXPAND_PATH", 0]], [
+            ["ST_IDLE", [["EV_EXPAND_PATH", function(gobj, event, kw, src) {
+                gobj_send_event(src, "EV_SUBTREE_ERROR",
+                    Object.assign({path: kw.path}, answer), gobj);
+                return 0;
+            }, null]]]
+        ], {}, 0, [SDATA_END()], {}, 0, 0, 0, 0);
+        const host = gobj_create(`${name}_host`, `C_TEST_JSON_HOST_${name}`, {}, yuno);
+        gobj_start(host);
+        const viewer = gobj_create_pure_child(`${name}_jv`, "C_YUI_JSON", {
+            json_data: {a: {__collapsed__: {size: 3, path: "a"}}}
+        }, host);
+        gobj_start(viewer);
+        return viewer;
+    }
+
+    function stub_error(viewer)
+    {
+        return gobj_read_attr(viewer, "$container").querySelector(".JSON_STUB_ERR");
+    }
+
+    test("a key is drawn translated, carries data-i18n, and follows the language", async () => {
+        const i18next = (await import("i18next")).default;
+        i18next.addResource("es", "translation",
+            "this part cannot be loaded here", "esta parte no se puede cargar aqui");
+
+        const viewer = make_viewer("s1",
+            {i18n: "this part cannot be loaded here", by_design: true});
+        logged.length = 0;
+        gobj_send_event(viewer, "EV_EXPAND_COLLAPSED", {path: "a", size: 3}, viewer);
+
+        let el = stub_error(viewer);
+        expect(el).toBeTruthy();
+        expect(el.getAttribute("data-i18n")).toBe("this part cannot be loaded here");
+        expect(el.textContent).toBe("this part cannot be loaded here");
+        expect(errors()).toEqual([]);
+        expect(warnings()).toEqual([
+            "C_YUI_JSON: subtree not loaded at 'a': this part cannot be loaded here"
+        ]);
+
+        await i18next.changeLanguage("es");
+        try {
+            gobj_send_event(viewer, "EV_LANGUAGE_CHANGED", {}, viewer);
+            expect(stub_error(viewer).textContent).toBe("esta parte no se puede cargar aqui");
+            expect(t("this part cannot be loaded here")).toBe("esta parte no se puede cargar aqui");
+        } finally {
+            await i18next.changeLanguage("en");
+        }
+    });
+
+    test("a failure in free text is drawn as it came, and is an ERROR", () => {
+        const viewer = make_viewer("s2", {error: "print-tranger failed"});
+        logged.length = 0;
+        gobj_send_event(viewer, "EV_EXPAND_COLLAPSED", {path: "a", size: 3}, viewer);
+
+        let el = stub_error(viewer);
+        expect(el.getAttribute("data-i18n")).toBe(null);
+        expect(el.textContent).toBe("print-tranger failed");
+        expect(errors()).toEqual([
+            "C_YUI_JSON: subtree load failed at 'a': print-tranger failed"
+        ]);
+    });
+});