@yuneta/gobj-ui 7.25.20 → 7.25.21

package/README.md

@@ -593,6 +593,13 @@ Two layout facts the browser taught this component, both worth keeping:
 - Output event: `EV_EXPAND_PATH {path, size}` (`EVF_OUTPUT_EVENT`) — the parent
   must declare it in its own FSM (CHILD subscription model), and ANSWER it: the
   stub shows "loading" until `EV_SUBTREE_LOADED` or `EV_SUBTREE_ERROR` arrives.
+  **Every** way the drill can fail is an answer: a request asked out of
+  session, or refused by the transport on its way out, never reaches the
+  backend, so no answer will ever come back for it -- the host answers it
+  itself (`C_YUI_TREEDB_TOPICS` / `C_YUI_TREEDB_GRAPH` since `7.25.21`: `i18n:
+  "no session"`, or the transport's refusal as `error`). While a path is
+  pending the viewer ignores every click on it, so a drill left unanswered
+  is a dead stub for the life of the viewer.
   A host that cannot read a subtree says so with the error, as
   `C_YUI_TREEDB_TOPIC_WITH_FORM` does for its schema, cell and table viewers
   since `7.25.19` (before, it declared nothing: *"Event NOT DEFINED"*):

package/dist/gobj-ui.cjs.js

@@ -25136,6 +25136,27 @@ function request_schema_file(gobj) {
 	if (ret) (0, _yuneta_gobj_js.log_error)(ret);
 }
 /************************************************************
+*  A drill (or the whole document) that will get no answer from the
+*  backend is answered HERE, or its stub shows "loading" for the life
+*  of the viewer: C_YUI_JSON ignores every click on a pending path.
+*  `answer` is {i18n: <key>} or {error: <text>}.
+************************************************************/
+function answer_print_tranger_refused$1(gobj, path, answer) {
+	let jv = gobj.priv.json_gobj;
+	if (!jv || !(0, _yuneta_gobj_js.is_gobj)(jv) || (0, _yuneta_gobj_js.gobj_is_destroying)(jv)) return;
+	if (path) (0, _yuneta_gobj_js.gobj_send_event)(jv, "EV_SUBTREE_ERROR", Object.assign({ path }, answer), gobj);
+	else yui_shell_show_error(yui_shell_of(gobj), answer.i18n || answer.error, { t: i18next.t });
+}
+/************************************************************
+*  The text of a transport's refusal: gobj_command() answers a string,
+*  a command response or a number.
+************************************************************/
+function refusal_text$1(ret) {
+	if (typeof ret === "string" && ret) return ret;
+	if (ret && typeof ret === "object" && typeof ret.comment === "string" && ret.comment) return ret.comment;
+	return "print-tranger failed";
+}
+/************************************************************
 *  The whole tranger, for the raw-json viewer.
 ************************************************************/
 function request_print_tranger$1(gobj, path) {
@@ -25143,11 +25164,12 @@ function request_print_tranger$1(gobj, path) {
 	let remote = (0, _yuneta_gobj_js.gobj_read_pointer_attr)(gobj, "gobj_remote_yuno");
 	if (!remote) {
 		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: No gobj_remote_yuno defined`);
-		let jv = priv.json_gobj;
-		if (path && jv && (0, _yuneta_gobj_js.is_gobj)(jv) && !(0, _yuneta_gobj_js.gobj_is_destroying)(jv)) (0, _yuneta_gobj_js.gobj_send_event)(jv, "EV_SUBTREE_ERROR", {
-			path,
-			i18n: "no session"
-		}, gobj);
+		answer_print_tranger_refused$1(gobj, path, { i18n: "no session" });
+		return;
+	}
+	if (!is_connected$1(gobj)) {
+		(0, _yuneta_gobj_js.log_warning)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: print-tranger '${path || ""}' not asked: no session`);
+		answer_print_tranger_refused$1(gobj, path, { i18n: "no session" });
 		return;
 	}
 	let ret = (0, _yuneta_gobj_js.gobj_command)(remote, "print-tranger", {
@@ -25158,7 +25180,10 @@ function request_print_tranger$1(gobj, path) {
 		path: path || "",
 		__md_command__: { path: path || "" }
 	}, gobj);
-	if (ret) (0, _yuneta_gobj_js.log_error)(ret);
+	if (ret) {
+		(0, _yuneta_gobj_js.log_error)(ret);
+		answer_print_tranger_refused$1(gobj, path, { error: refusal_text$1(ret) });
+	}
 }
 /***************************************************************
 *  The last gate before a write leaves for the yuno. The per-topic
@@ -68344,6 +68369,27 @@ function close_json_viewer(gobj) {
 	}
 }
 /************************************************************
+*  A drill (or the whole document) that will get no answer from the
+*  backend is answered HERE, or its stub shows "loading" for the life
+*  of the viewer: C_YUI_JSON ignores every click on a pending path.
+*  `answer` is {i18n: <key>} or {error: <text>}.
+************************************************************/
+function answer_print_tranger_refused(gobj, path, answer) {
+	let jv = gobj.priv.json_gobj;
+	if (!jv || !(0, _yuneta_gobj_js.is_gobj)(jv) || (0, _yuneta_gobj_js.gobj_is_destroying)(jv)) return;
+	if (path) (0, _yuneta_gobj_js.gobj_send_event)(jv, "EV_SUBTREE_ERROR", Object.assign({ path }, answer), gobj);
+	else yui_shell_show_error(yui_shell_of(gobj), answer.i18n || answer.error, { t: i18next.t });
+}
+/************************************************************
+*  The text of a transport's refusal: gobj_command() answers a string,
+*  a command response or a number.
+************************************************************/
+function refusal_text(ret) {
+	if (typeof ret === "string" && ret) return ret;
+	if (ret && typeof ret === "object" && typeof ret.comment === "string" && ret.comment) return ret.comment;
+	return "print-tranger failed";
+}
+/************************************************************
 *  Fetch the treedb's raw tranger (or one subtree when `path` is set) as
 *  bounded, drillable JSON. Collapsed at 100 so a huge tranger stays a
 *  small payload of `__collapsed__` stubs the viewer expands on demand.
@@ -68352,11 +68398,12 @@ function request_print_tranger(gobj, path) {
 	let priv = gobj.priv;
 	if (!priv.gobj_remote_yuno) {
 		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: No gobj_remote_yuno defined`);
-		let jv = priv.json_gobj;
-		if (path && jv && (0, _yuneta_gobj_js.is_gobj)(jv) && !(0, _yuneta_gobj_js.gobj_is_destroying)(jv)) (0, _yuneta_gobj_js.gobj_send_event)(jv, "EV_SUBTREE_ERROR", {
-			path,
-			i18n: "no session"
-		}, gobj);
+		answer_print_tranger_refused(gobj, path, { i18n: "no session" });
+		return;
+	}
+	if (!is_connected(gobj)) {
+		(0, _yuneta_gobj_js.log_warning)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: print-tranger '${path || ""}' not asked: no session`);
+		answer_print_tranger_refused(gobj, path, { i18n: "no session" });
 		return;
 	}
 	let ret = (0, _yuneta_gobj_js.gobj_command)(priv.gobj_remote_yuno, "print-tranger", {
@@ -68367,7 +68414,10 @@ function request_print_tranger(gobj, path) {
 		path: path || "",
 		__md_command__: { path: path || "" }
 	}, gobj);
-	if (ret) (0, _yuneta_gobj_js.log_error)(ret);
+	if (ret) {
+		(0, _yuneta_gobj_js.log_error)(ret);
+		answer_print_tranger_refused(gobj, path, { error: refusal_text(ret) });
+	}
 }
 /************************************************************
 *  Populate layout dropdown from child's available layouts

package/dist/gobj-ui.es.js

@@ -25131,6 +25131,27 @@ function request_schema_file(gobj) {
 	if (ret) log_error(ret);
 }
 /************************************************************
+*  A drill (or the whole document) that will get no answer from the
+*  backend is answered HERE, or its stub shows "loading" for the life
+*  of the viewer: C_YUI_JSON ignores every click on a pending path.
+*  `answer` is {i18n: <key>} or {error: <text>}.
+************************************************************/
+function answer_print_tranger_refused$1(gobj, path, answer) {
+	let jv = gobj.priv.json_gobj;
+	if (!jv || !is_gobj(jv) || gobj_is_destroying(jv)) return;
+	if (path) gobj_send_event(jv, "EV_SUBTREE_ERROR", Object.assign({ path }, answer), gobj);
+	else yui_shell_show_error(yui_shell_of(gobj), answer.i18n || answer.error, { t });
+}
+/************************************************************
+*  The text of a transport's refusal: gobj_command() answers a string,
+*  a command response or a number.
+************************************************************/
+function refusal_text$1(ret) {
+	if (typeof ret === "string" && ret) return ret;
+	if (ret && typeof ret === "object" && typeof ret.comment === "string" && ret.comment) return ret.comment;
+	return "print-tranger failed";
+}
+/************************************************************
 *  The whole tranger, for the raw-json viewer.
 ************************************************************/
 function request_print_tranger$1(gobj, path) {
@@ -25138,11 +25159,12 @@ function request_print_tranger$1(gobj, path) {
 	let remote = gobj_read_pointer_attr(gobj, "gobj_remote_yuno");
 	if (!remote) {
 		log_error(`${gobj_short_name(gobj)}: No gobj_remote_yuno defined`);
-		let jv = priv.json_gobj;
-		if (path && jv && is_gobj(jv) && !gobj_is_destroying(jv)) gobj_send_event(jv, "EV_SUBTREE_ERROR", {
-			path,
-			i18n: "no session"
-		}, gobj);
+		answer_print_tranger_refused$1(gobj, path, { i18n: "no session" });
+		return;
+	}
+	if (!is_connected$1(gobj)) {
+		log_warning(`${gobj_short_name(gobj)}: print-tranger '${path || ""}' not asked: no session`);
+		answer_print_tranger_refused$1(gobj, path, { i18n: "no session" });
 		return;
 	}
 	let ret = gobj_command(remote, "print-tranger", {
@@ -25153,7 +25175,10 @@ function request_print_tranger$1(gobj, path) {
 		path: path || "",
 		__md_command__: { path: path || "" }
 	}, gobj);
-	if (ret) log_error(ret);
+	if (ret) {
+		log_error(ret);
+		answer_print_tranger_refused$1(gobj, path, { error: refusal_text$1(ret) });
+	}
 }
 /***************************************************************
 *  The last gate before a write leaves for the yuno. The per-topic
@@ -68339,6 +68364,27 @@ function close_json_viewer(gobj) {
 	}
 }
 /************************************************************
+*  A drill (or the whole document) that will get no answer from the
+*  backend is answered HERE, or its stub shows "loading" for the life
+*  of the viewer: C_YUI_JSON ignores every click on a pending path.
+*  `answer` is {i18n: <key>} or {error: <text>}.
+************************************************************/
+function answer_print_tranger_refused(gobj, path, answer) {
+	let jv = gobj.priv.json_gobj;
+	if (!jv || !is_gobj(jv) || gobj_is_destroying(jv)) return;
+	if (path) gobj_send_event(jv, "EV_SUBTREE_ERROR", Object.assign({ path }, answer), gobj);
+	else yui_shell_show_error(yui_shell_of(gobj), answer.i18n || answer.error, { t });
+}
+/************************************************************
+*  The text of a transport's refusal: gobj_command() answers a string,
+*  a command response or a number.
+************************************************************/
+function refusal_text(ret) {
+	if (typeof ret === "string" && ret) return ret;
+	if (ret && typeof ret === "object" && typeof ret.comment === "string" && ret.comment) return ret.comment;
+	return "print-tranger failed";
+}
+/************************************************************
 *  Fetch the treedb's raw tranger (or one subtree when `path` is set) as
 *  bounded, drillable JSON. Collapsed at 100 so a huge tranger stays a
 *  small payload of `__collapsed__` stubs the viewer expands on demand.
@@ -68347,11 +68393,12 @@ function request_print_tranger(gobj, path) {
 	let priv = gobj.priv;
 	if (!priv.gobj_remote_yuno) {
 		log_error(`${gobj_short_name(gobj)}: No gobj_remote_yuno defined`);
-		let jv = priv.json_gobj;
-		if (path && jv && is_gobj(jv) && !gobj_is_destroying(jv)) gobj_send_event(jv, "EV_SUBTREE_ERROR", {
-			path,
-			i18n: "no session"
-		}, gobj);
+		answer_print_tranger_refused(gobj, path, { i18n: "no session" });
+		return;
+	}
+	if (!is_connected(gobj)) {
+		log_warning(`${gobj_short_name(gobj)}: print-tranger '${path || ""}' not asked: no session`);
+		answer_print_tranger_refused(gobj, path, { i18n: "no session" });
 		return;
 	}
 	let ret = gobj_command(priv.gobj_remote_yuno, "print-tranger", {
@@ -68362,7 +68409,10 @@ function request_print_tranger(gobj, path) {
 		path: path || "",
 		__md_command__: { path: path || "" }
 	}, gobj);
-	if (ret) log_error(ret);
+	if (ret) {
+		log_error(ret);
+		answer_print_tranger_refused(gobj, path, { error: refusal_text(ret) });
+	}
 }
 /************************************************************
 *  Populate layout dropdown from child's available layouts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuneta/gobj-ui",
-  "version": "7.25.20",
+  "version": "7.25.21",
   "type": "module",
   "main": "dist/gobj-ui.cjs.js",
   "module": "dist/gobj-ui.es.js",
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@rollup/plugin-terser": "^1.0.0",
     "@vitest/coverage-v8": "^4.1.10",
-    "@yuneta/gobj-js": "^7.25.6",
+    "@yuneta/gobj-js": "^7.25.7",
     "vite": "^8.2.1",
     "vitest": "^4.1.10"
   },

package/src/c_yui_treedb_graph.js

@@ -1312,6 +1312,42 @@ function close_json_viewer(gobj)
     }
 }
 
+/************************************************************
+ *  A drill (or the whole document) that will get no answer from the
+ *  backend is answered HERE, or its stub shows "loading" for the life
+ *  of the viewer: C_YUI_JSON ignores every click on a pending path.
+ *  `answer` is {i18n: <key>} or {error: <text>}.
+ ************************************************************/
+function answer_print_tranger_refused(gobj, path, answer)
+{
+    let jv = gobj.priv.json_gobj;
+    if(!jv || !is_gobj(jv) || gobj_is_destroying(jv)) {
+        return;     /*  no viewer to answer: the refusal is already logged  */
+    }
+    if(path) {
+        gobj_send_event(jv, "EV_SUBTREE_ERROR",
+            Object.assign({path: path}, answer), gobj);
+    } else {
+        yui_shell_show_error(yui_shell_of(gobj),
+            answer.i18n || answer.error, {t: t});
+    }
+}
+
+/************************************************************
+ *  The text of a transport's refusal: gobj_command() answers a string,
+ *  a command response or a number.
+ ************************************************************/
+function refusal_text(ret)
+{
+    if(typeof ret === "string" && ret) {
+        return ret;
+    }
+    if(ret && typeof ret === "object" && typeof ret.comment === "string" && ret.comment) {
+        return ret.comment;
+    }
+    return "print-tranger failed";
+}
+
 /************************************************************
  *  Fetch the treedb's raw tranger (or one subtree when `path` is set) as
  *  bounded, drillable JSON. Collapsed at 100 so a huge tranger stays a
@@ -1322,11 +1358,13 @@ function request_print_tranger(gobj, path)
     let priv = gobj.priv;
     if(!priv.gobj_remote_yuno) {
         log_error(`${gobj_short_name(gobj)}: No gobj_remote_yuno defined`);
-        let jv = priv.json_gobj;
-        if(path && jv && is_gobj(jv) && !gobj_is_destroying(jv)) {
-            gobj_send_event(jv, "EV_SUBTREE_ERROR",
-                {path: path, i18n: "no session"}, gobj);
-        }
+        answer_print_tranger_refused(gobj, path, {i18n: "no session"});
+        return;
+    }
+    if(!is_connected(gobj)) {
+        log_warning(`${gobj_short_name(gobj)}: print-tranger '${path || ""}' ` +
+            `not asked: no session`);
+        answer_print_tranger_refused(gobj, path, {i18n: "no session"});
         return;
     }
     let ret = gobj_command(priv.gobj_remote_yuno, "print-tranger",
@@ -1342,6 +1380,7 @@ function request_print_tranger(gobj, path)
         }, gobj);
     if(ret) {
         log_error(ret);
+        answer_print_tranger_refused(gobj, path, {error: refusal_text(ret)});
     }
 }
 

package/src/c_yui_treedb_topics.js

@@ -1943,6 +1943,42 @@ function request_schema_file(gobj)
     }
 }
 
+/************************************************************
+ *  A drill (or the whole document) that will get no answer from the
+ *  backend is answered HERE, or its stub shows "loading" for the life
+ *  of the viewer: C_YUI_JSON ignores every click on a pending path.
+ *  `answer` is {i18n: <key>} or {error: <text>}.
+ ************************************************************/
+function answer_print_tranger_refused(gobj, path, answer)
+{
+    let jv = gobj.priv.json_gobj;
+    if(!jv || !is_gobj(jv) || gobj_is_destroying(jv)) {
+        return;     /*  no viewer to answer: the refusal is already logged  */
+    }
+    if(path) {
+        gobj_send_event(jv, "EV_SUBTREE_ERROR",
+            Object.assign({path: path}, answer), gobj);
+    } else {
+        yui_shell_show_error(yui_shell_of(gobj),
+            answer.i18n || answer.error, {t: t});
+    }
+}
+
+/************************************************************
+ *  The text of a transport's refusal: gobj_command() answers a string,
+ *  a command response or a number.
+ ************************************************************/
+function refusal_text(ret)
+{
+    if(typeof ret === "string" && ret) {
+        return ret;
+    }
+    if(ret && typeof ret === "object" && typeof ret.comment === "string" && ret.comment) {
+        return ret.comment;
+    }
+    return "print-tranger failed";
+}
+
 /************************************************************
  *  The whole tranger, for the raw-json viewer.
  ************************************************************/
@@ -1952,11 +1988,13 @@ function request_print_tranger(gobj, path)
     let remote = gobj_read_pointer_attr(gobj, "gobj_remote_yuno");
     if(!remote) {
         log_error(`${gobj_short_name(gobj)}: No gobj_remote_yuno defined`);
-        let jv = priv.json_gobj;
-        if(path && jv && is_gobj(jv) && !gobj_is_destroying(jv)) {
-            gobj_send_event(jv, "EV_SUBTREE_ERROR",
-                {path: path, i18n: "no session"}, gobj);
-        }
+        answer_print_tranger_refused(gobj, path, {i18n: "no session"});
+        return;
+    }
+    if(!is_connected(gobj)) {
+        log_warning(`${gobj_short_name(gobj)}: print-tranger '${path || ""}' ` +
+            `not asked: no session`);
+        answer_print_tranger_refused(gobj, path, {i18n: "no session"});
         return;
     }
     let ret = gobj_command(remote, "print-tranger",
@@ -1972,6 +2010,7 @@ function request_print_tranger(gobj, path)
         }, gobj);
     if(ret) {
         log_error(ret);
+        answer_print_tranger_refused(gobj, path, {error: refusal_text(ret)});
     }
 }
 

package/src/treedb_json_drill.wiring.test.js

@@ -0,0 +1,232 @@
+/***********************************************************************
+ *          treedb_json_drill.wiring.test.js
+ *
+ *      The raw-tranger viewer of C_YUI_TREEDB_TOPICS and of
+ *      C_YUI_TREEDB_GRAPH drills into a `__collapsed__` stub by asking
+ *      its host (EV_EXPAND_PATH), and the stub shows "loading" until the
+ *      host answers EV_SUBTREE_LOADED or EV_SUBTREE_ERROR. While the
+ *      path is pending, C_YUI_JSON ignores every further click on it.
+ *
+ *      Before gobj-ui 7.25.21 the host answered only when it had no
+ *      transport at all. A drill asked out of session, or refused by the
+ *      transport on the way out, was logged and never answered: the stub
+ *      stayed on "loading" for the life of the viewer, and no click --
+ *      not even after the reconnect -- asked again.
+ *
+ *      Driven through the real hosts and the real viewer on a document
+ *      double, with a fake transport whose state is the one the hosts
+ *      read and which refuses on demand.
+ *
+ *          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();
+
+if(!globalThis.ResizeObserver) {
+    globalThis.ResizeObserver = class {
+        observe() {}
+        unobserve() {}
+        disconnect() {}
+    };
+}
+
+const {
+    SDATA, SDATA_END, data_type_t,
+    gclass_create,
+    gobj_start_up, gobj_create_yuno, gobj_create, gobj_create_service,
+    gobj_create_pure_child,
+    gobj_start, gobj_send_event,
+    gobj_read_pointer_attr, gobj_subscribe_event,
+    gobj_change_state, gobj_current_state,
+    set_log_callback,
+} = await import("@yuneta/gobj-js");
+
+const logged = [];
+const commands = [];        /*  what the fake transport was asked  */
+let refuse_in_session = false;
+
+/*
+ *  The transport. Out of session it refuses, as gui_agent's routing
+ *  adapter (C_AGENT_TREEDB_LINK) does; in session it refuses only when
+ *  the test says so (a transport that cannot route the command).
+ */
+function remote_command_parser(gobj, command, kw, src)
+{
+    commands.push({command, kw});
+    if(gobj_current_state(gobj) !== "ST_SESSION") {
+        return `cannot route '${command}' -- not in session`;
+    }
+    if(refuse_in_session) {
+        return `cannot route '${command}'`;
+    }
+    return null;
+}
+
+let yuno = null;
+
+beforeAll(async () => {
+    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);
+    gclass_create(
+        "C_TEST_VIEW_HOST",
+        [["EV_RECORD_WRITTEN", 0], ["EV_TOPIC_SELECTED", 0], ["EV_OPERATION_MODE_CHANGED", 0]],
+        [["ST_IDLE", [
+            ["EV_RECORD_WRITTEN", () => 0, null],
+            ["EV_TOPIC_SELECTED", () => 0, null],
+            ["EV_OPERATION_MODE_CHANGED", () => 0, null]
+        ]]],
+        {}, 0, [SDATA_END()], {}, 0, 0, 0, 0
+    );
+    gclass_create(
+        "C_TEST_REMOTE",
+        [],
+        [["ST_SESSION", []], ["ST_DISCONNECTED", []]],
+        {mt_command_parser: remote_command_parser},
+        0, [SDATA_END()], {}, 0, 0, 0, 0
+    );
+
+    /*  The graph's engine, as a silent double: this test is about the
+     *  viewer, not about the graph.  */
+    const ENGINE_EVENTS = [
+        "EV_DESCS", "EV_CLEAR_DATA", "EV_LOAD_DATA", "EV_NODE_CREATED",
+        "EV_NODE_UPDATED", "EV_NODE_DELETED", "EV_GRAPHS_WRITE_REFUSED",
+        "EV_SHOW", "EV_HIDE", "EV_RESIZE", "EV_THEME", "EV_LANGUAGE_CHANGED",
+        "EV_SET_OPERATION_MODE", "EV_SET_LAYOUT"
+    ];
+    gclass_create(
+        "C_G6_NODES_TREE",
+        ENGINE_EVENTS.map((e) => [e, 0]).concat([["EV_UPDATE_NODE", 2]]),
+        [["ST_IDLE", ENGINE_EVENTS.map((e) => [e, () => 0, null])]],
+        {
+            mt_create: (gobj) => {
+                const subscriber = gobj_read_pointer_attr(gobj, "subscriber");
+                if(subscriber) {
+                    gobj_subscribe_event(gobj, null, {}, subscriber);
+                }
+            }
+        },
+        0,
+        [
+            SDATA(data_type_t.DTP_POINTER, "subscriber", 0, null, ""),
+            SDATA(data_type_t.DTP_POINTER, "$container", 0, null, ""),
+            SDATA(data_type_t.DTP_POINTER, "gobj_remote_yuno", 0, null, ""),
+            SDATA(data_type_t.DTP_STRING, "treedb_name", 0, "", ""),
+            SDATA(data_type_t.DTP_JSON, "layout_names", 0, "[]", ""),
+            SDATA(data_type_t.DTP_STRING, "layout", 0, "", ""),
+            SDATA_END()
+        ],
+        {}, 0, 0, 0, 0
+    );
+
+    const {register_c_yui_json} = await import("./c_yui_json.js");
+    const {register_c_yui_treedb_topics} = await import("./c_yui_treedb_topics.js");
+    const {register_c_yui_treedb_graph} = await import("./c_yui_treedb_graph.js");
+    register_c_yui_json();
+    register_c_yui_treedb_topics();
+    register_c_yui_treedb_graph();
+
+    yuno = gobj_create_yuno("json_drill_yuno", "C_TEST_HOST", {});
+    gobj_start(yuno);
+});
+
+beforeEach(() => {
+    logged.length = 0;
+    commands.length = 0;
+    refuse_in_session = false;
+});
+
+/*
+ *  A host of each kind, with its viewer open on a tranger that carries
+ *  one stub. The viewer is the one the host created: it publishes
+ *  EV_EXPAND_PATH to the host, and the host answers it.
+ */
+function build(name, gclass)
+{
+    const remote = gobj_create_service(`${name}_remote`, "C_TEST_REMOTE", {}, yuno);
+    gobj_change_state(remote, "ST_SESSION");
+    const view_host = gobj_create(`${name}_view_host`, "C_TEST_VIEW_HOST", {}, yuno);
+    const host = gobj_create_service(`${name}_host`, gclass, {
+        gobj_remote_yuno: remote,
+        treedb_name: "treedb_test",
+        subscriber: view_host
+    }, view_host);
+    if(gclass === "C_YUI_TREEDB_TOPICS") {
+        gobj_start(host);
+    }
+    const viewer = gobj_create_pure_child(`${name}_jv`, "C_YUI_JSON", {
+        subscriber: host,
+        json_data: {topics: {__collapsed__: {size: 3, path: "topics"}}}
+    }, host);
+    gobj_start(viewer);
+    host.priv.json_gobj = viewer;
+    logged.length = 0;
+    commands.length = 0;
+    return {remote, host, viewer};
+}
+
+function click_stub(viewer)
+{
+    gobj_send_event(viewer, "EV_EXPAND_COLLAPSED", {path: "topics", size: 3}, viewer);
+}
+
+function drills()
+{
+    return commands.filter((c) => c.command === "print-tranger").map((c) => c.kw.path);
+}
+
+for(const gclass of ["C_YUI_TREEDB_TOPICS", "C_YUI_TREEDB_GRAPH"]) {
+    describe(`${gclass}: a drill that cannot go out is answered`, () => {
+
+        test("out of session: the stub says 'no session', and a click after the reconnect asks", () => {
+            const {remote, viewer} = build(`${gclass}_a`, gclass);
+            gobj_change_state(remote, "ST_DISCONNECTED");
+
+            click_stub(viewer);
+
+            expect(drills()).toEqual([]);   /*  not even tried  */
+            expect(viewer.priv.pending.has("topics")).toBe(false);
+            expect(viewer.priv.errors.get("topics")).toEqual(
+                {error: "no session", is_key: true});
+
+            /*  The reconnect: the same stub asks again.  */
+            gobj_change_state(remote, "ST_SESSION");
+            click_stub(viewer);
+            expect(drills()).toEqual(["topics"]);
+            expect(viewer.priv.pending.has("topics")).toBe(true);
+        });
+
+        test("refused by the transport: the stub says why, and can be clicked again", () => {
+            const {viewer} = build(`${gclass}_b`, gclass);
+            refuse_in_session = true;
+
+            click_stub(viewer);
+
+            expect(drills()).toEqual(["topics"]);
+            expect(viewer.priv.pending.has("topics")).toBe(false);
+            expect(viewer.priv.errors.get("topics")).toEqual(
+                {error: "cannot route 'print-tranger'", is_key: false});
+
+            refuse_in_session = false;
+            click_stub(viewer);
+            expect(drills()).toEqual(["topics", "topics"]);
+            expect(viewer.priv.pending.has("topics")).toBe(true);
+        });
+
+        test("in session and sent: the stub waits for its answer", () => {
+            const {viewer} = build(`${gclass}_c`, gclass);
+            click_stub(viewer);
+            expect(drills()).toEqual(["topics"]);
+            expect(viewer.priv.pending.has("topics")).toBe(true);
+            expect(logged.filter((l) => l.level === "error")).toEqual([]);
+        });
+    });
+}