@yuneta/gobj-ui 7.25.17 → 7.25.19

package/README.md

@@ -227,6 +227,16 @@ seen*:
   for its treedb nodes, so the graph tab returns to `<graph>/<topic>` with its
   focus and the data tab to the topic that was open.
 
+- **A node hears every event of the navs it projects** (they are its pure
+  children). Since `7.25.19` it declares all three, in every state -- a ZONE
+  projection outlives the path, so a root that is off it still hears its
+  rail: `EV_NAV_CLICKED` (a navigation), `EV_NAV_ITEM_CLOSE` (handed to the
+  shell, which re-publishes it to the app, as for the shell's own closable
+  items) and `EV_DRAWER_CLOSE_REQUESTED` (the node closes its own drawer
+  projection: the shell's `yui_shell_close_drawer()` knows only the shell's
+  navs). Before, the last two answered *"Event NOT DEFINED in state"*, and so
+  did a click on a zone nav of a root in `ST_OFF`.
+
 - **`nav_mode` — the three shapes as one runtime knob.** The two bullets above
   describe what a tree *declares*; `nav_mode` is how a user *chooses* between
   the shapes without the app rewriting anything:
@@ -581,7 +591,15 @@ Two layout facts the browser taught this component, both worth keeping:
   the two-view toggle did when the list was two long), plus `EV_REFRESH` /
   `EV_SHOW` / `EV_HIDE` / `EV_LANGUAGE_CHANGED`.
 - Output event: `EV_EXPAND_PATH {path, size}` (`EVF_OUTPUT_EVENT`) — the parent
-  must declare it in its own FSM (CHILD subscription model). That is the ONLY
+  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.
+  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"*):
+  ```js
+  gobj_send_event(src, "EV_SUBTREE_ERROR",
+      {path: kw.path, error: t("this part cannot be loaded here")}, gobj);
+  ``` That is the ONLY
   one, on purpose: this viewer is a child of its host and subscribes it to
   everything it publishes, so every output event is a mandatory declaration in
   every host's FSM. The graph child's `EV_JSON_ITEM_CLICKED` stops here
@@ -989,6 +1007,50 @@ hold the list again; the cell and a delete's question count either shape. The
 search box no longer finds a parent row by the id of one of its children: to
 find what hangs from a row, click its hook.
 
+### What a write says to the host: `EV_RECORD_WRITTEN`
+
+`C_YUI_TREEDB_TOPICS` and `C_YUI_TREEDB_GRAPH` publish `EV_RECORD_WRITTEN`
+when a write of THEIRS is answered with success: a host whose work is not
+finished with the record (a schema editor, a pending Apply) needs that, and the
+`EV_TREEDB_NODE_*` events cannot tell its own writes from anybody else's. The
+graph does not report `__graphs__`, its own bookkeeping.
+
+```js
+// kw of EV_RECORD_WRITTEN
+{
+    treedb_name: "treedb_test",           // the view's own treedb
+    topic_name:  "yunos",                 // the topic written (the CHILD's, for a link)
+    record:      {id: "1", x: 1, y: 2},   // the node the store answered, as written
+    created:     false,                   // true for a NEW record (see below)
+    command:     "update-node",           // create/update/delete-node, link/unlink-nodes
+    parent_ref:  "realms^r1^yunos",       // graph, link/unlink only
+    child_ref:   "yunos^1"                // graph, link/unlink only
+}
+```
+
+Since `7.25.18` every field carries what it says. They were read from the
+answer's command frame, which carries back only the request's
+`__md_command__` -- `C_IEVENT_CLI` and gui_agent's `C_AGENT_TREEDB_LINK` both
+do -- so `treedb_name` and `record` arrived empty, and a link named no topic.
+`treedb_name` is now the view's, `record` is the node the answer carries (a
+delete answers the node deleted, a link the child), and a link echoes its topic
+and refs in `__md_command__`.
+
+Since `7.25.19` the topics view publishes a successful **delete** too (it
+published nothing: the answer went to an empty `break`), and `created` is
+TRUE for its **+New**: that goes out as an `update-node` with `create_only`,
+so comparing the command with `"create-node"` answered `false` for every
+record the table created. The request now echoes `created: true` in its
+`__md_command__`. The graph creates with `create-node`, and says so the same
+way.
+
+```js
+// the table's +New, answered
+{treedb_name: "treedb_test", topic_name: "users", record: {id: "n1"}, created: true,  command: "update-node"}
+// a row deleted, answered with the node deleted
+{treedb_name: "treedb_test", topic_name: "roles", record: {id: "x"},  created: false, command: "delete-node"}
+```
+
 ### Read-only treedbs: `readonly`
 
 `C_YUI_TREEDB_TOPICS` and `C_YUI_TREEDB_GRAPH` take a **`readonly`** attr; the
@@ -1815,8 +1877,12 @@ the history buttons -- they decide the Save from `history.canUndo()`, and they
 run on every history change, every change of mode and every redraw of the
 theme -- and a refusal heard in reading was never shown. The engine now keeps
 the topic as owed: the Save stays lit while one is, in edition and on entering
-it; the Save that writes the topic again pays it, and a reload of the data
-forgets it (the view holds what the backend holds).
+it; the Save that writes the topic again pays it, a reload of the data
+forgets it (the view holds what the backend holds), and so does an ECHO of the
+topic's `__graphs__` record (since `7.25.19`): the echo is what the backend
+holds, taken as shown and as saved, so nothing is owed any more. Before, a
+refused Save #1 answered after Save #2's echo -- or another browser saving the
+topic -- left the Save lit with nothing to write until a reload.
 
 ```js
 gobj_send_event(engine, "EV_GRAPHS_WRITE_REFUSED", {topic: "users"}, host);  // Save lit

package/dist/gobj-ui.cjs.js

@@ -10901,7 +10901,7 @@ function register_c_yui_map() {
 *
 *          Graphics, Charts with uPlot
 *
-*          Copyright (c) 2025, ArtGins.
+*          Copyright (c) 2025-2026, ArtGins.
 *          All Rights Reserved.
 ***********************************************************************/
 /***************************************************************
@@ -11151,8 +11151,8 @@ function ac_add_serie(gobj, event, kw, src) {
 	let colors = (0, _yuneta_gobj_js.gobj_read_attr)(gobj, "colors");
 	if (!Array.isArray(colors) || !colors.length) colors = CHART_PALETTE;
 	let color = colors[Math.max(0, idx - 1) % colors.length];
-	(0, _yuneta_gobj_js.kw_get_str)(gobj, kw, "stroke", color.stroke, _yuneta_gobj_js.kw_flag_t.KW_CREATE);
-	(0, _yuneta_gobj_js.kw_get_str)(gobj, kw, "fill", color.fill, _yuneta_gobj_js.kw_flag_t.KW_CREATE);
+	if (kw.stroke === void 0) kw.stroke = color.stroke;
+	if (kw.fill === void 0) kw.fill = color.fill;
 	uplot$4.addSeries(kw);
 	return 0;
 }
@@ -16020,7 +16020,7 @@ function ac_hide_diff(gobj, event, kw, src) {
 *  document has no backend to ask for it: the SOURCE truncated
 *  it, and that is the answer, to the viewer that asked.
 ***************************************************************/
-function ac_expand_path(gobj, event, kw, src) {
+function ac_expand_path$1(gobj, event, kw, src) {
 	(0, _yuneta_gobj_js.gobj_send_event)(src, "EV_SUBTREE_ERROR", {
 		path: kw && kw.path || "",
 		error: (0, i18next.t)("collapsed in the source")
@@ -16081,7 +16081,7 @@ function create_gclass$12(gclass_name) {
 			],
 			[
 				"EV_EXPAND_PATH",
-				ac_expand_path,
+				ac_expand_path$1,
 				null
 			]
 		]],
@@ -16118,7 +16118,7 @@ function create_gclass$12(gclass_name) {
 			],
 			[
 				"EV_EXPAND_PATH",
-				ac_expand_path,
+				ac_expand_path$1,
 				null
 			]
 		]],
@@ -24924,9 +24924,20 @@ function treedb_nodes$1(gobj, treedb_name, topic_name, options, page, purpose) {
 	return 0;
 }
 /************************************************************
+*  The record a write answered: the node the store wrote (an
+*  update or a create), deleted, or the child of a link. The
+*  answer's frame carries back only `__md_command__`, never the
+*  request's own record.
+************************************************************/
+function answered_record$1(data) {
+	if (data && typeof data === "object" && !Array.isArray(data)) return data;
+	if (Array.isArray(data) && data[0] && typeof data[0] === "object") return data[0];
+	return {};
+}
+/************************************************************
 *  Command to remote service
 ************************************************************/
-function treedb_update_node$1(gobj, treedb_name, topic_name, record, options, form_write) {
+function treedb_update_node$1(gobj, treedb_name, topic_name, record, options, form_write, created) {
 	let command = "update-node";
 	let gobj_remote_yuno = (0, _yuneta_gobj_js.gobj_read_pointer_attr)(gobj, "gobj_remote_yuno");
 	let kw = {
@@ -24938,6 +24949,7 @@ function treedb_update_node$1(gobj, treedb_name, topic_name, record, options, fo
 	};
 	kw.__md_command__ = { topic_name };
 	if (form_write) kw.__md_command__.form_write = form_write;
+	if (created) kw.__md_command__.created = true;
 	let ret = (0, _yuneta_gobj_js.gobj_command)(gobj_remote_yuno, command, kw, gobj);
 	if (ret) {
 		(0, _yuneta_gobj_js.log_error)(ret);
@@ -24961,7 +24973,11 @@ function treedb_delete_node$1(gobj, treedb_name, topic_name, record, options) {
 	};
 	kw.__md_command__ = { topic_name };
 	let ret = (0, _yuneta_gobj_js.gobj_command)(gobj_remote_yuno, command, kw, gobj);
-	if (ret) (0, _yuneta_gobj_js.log_error)(ret);
+	if (ret) {
+		(0, _yuneta_gobj_js.log_error)(ret);
+		return -1;
+	}
+	return 0;
 }
 /************************************************************
 *  True on a phone-width viewport (Bulma's mobile breakpoint).
@@ -25244,17 +25260,18 @@ function ac_mt_command_answer$2(gobj, event, kw, src) {
 			break;
 		case "create-node":
 		case "update-node":
+		case "delete-node":
 			(0, _yuneta_gobj_js.gobj_publish_event)(gobj, "EV_RECORD_WRITTEN", {
-				treedb_name: (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "treedb_name", "", 0),
+				treedb_name: (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "treedb_name"),
 				topic_name: (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0),
-				record: (0, _yuneta_gobj_js.kw_get_dict)(gobj, kw_command, "record", {}, 0),
-				created: command === "create-node",
+				record: answered_record$1(data),
+				created: command === "create-node" || kw_command.created === true,
 				command
 			});
+			if (command === "delete-node") break;
 			settle_form_write(gobj.priv.form_writes, (0, _yuneta_gobj_js.kw_get_int)(gobj, kw_command, "form_write", 0, 0), (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0));
 			answer_form_write(gobj, get_gobj_formtable(gobj, (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0)), (0, _yuneta_gobj_js.kw_get_int)(gobj, kw_command, "form_write", 0, 0), true);
 			break;
-		case "delete-node": break;
 		default: (0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)} Command unknown: ${command}`);
 	}
 	return 0;
@@ -25522,7 +25539,7 @@ function ac_create_record(gobj, event, kw, src) {
 		create: true,
 		create_only: true,
 		autolink: true
-	}, form_write) < 0) {
+	}, form_write, true) < 0) {
 		answer_form_write(gobj, src, form_write, false);
 		return -1;
 	}
@@ -29440,6 +29457,24 @@ function refuse_if_readonly$2(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 || "";
+	(0, _yuneta_gobj_js.gobj_send_event)(src, "EV_SUBTREE_ERROR", {
+		path,
+		error: (0, i18next.t)("this part cannot be loaded here")
+	}, gobj);
+	return 0;
+}
+/***************************************************************
 *  The language changed (the shell publishes it after the app switched).
 *
 *  The column headers carry their key (col_label's title formatter emits a
@@ -30733,6 +30768,11 @@ function create_gclass$5(gclass_name) {
 			ac_show_schema,
 			null
 		],
+		[
+			"EV_EXPAND_PATH",
+			ac_expand_path,
+			null
+		],
 		[
 			"EV_CELL_EDITED",
 			ac_cell_edited,
@@ -30848,6 +30888,7 @@ function create_gclass$5(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],
@@ -65865,6 +65906,22 @@ function ac_graphs_write_refused(gobj, event, kw, src) {
 	return 0;
 }
 /************************************************************
+*  An echo of a `__graphs__` record is what the backend holds for
+*  its topic now, and the view has just taken it as shown and as
+*  saved: a write of that topic owed from an earlier refusal is
+*  owed no more. Left owed, the Save stayed lit with nothing to
+*  write -- the plan compares the two, and they are equal -- until
+*  a reload: a refused Save #1 answered after Save #2 landed, or
+*  another browser saving the topic, did exactly that.
+************************************************************/
+function settle_owed_graphs_write(gobj, rec) {
+	let priv = gobj.priv;
+	let topic_name = rec && rec.topic;
+	if (!topic_name || !priv._graphs_writes_owed[topic_name]) return;
+	delete priv._graphs_writes_owed[topic_name];
+	update_history_buttons(gobj);
+}
+/************************************************************
 *  Node created, from subscription
 ************************************************************/
 function ac_node_created(gobj, event, kw, src) {
@@ -65876,6 +65933,7 @@ function ac_node_created(gobj, event, kw, src) {
 	if (topic_name === "__graphs__") {
 		priv.__graphs__.push(node);
 		build_graph_properties(gobj);
+		settle_owed_graphs_write(gobj, node);
 		return 0;
 	}
 	if (!priv.descs[topic_name]) {
@@ -65911,6 +65969,7 @@ function ac_node_updated(gobj, event, kw, src) {
 		}
 		if (!found) priv.__graphs__.push(node);
 		apply_graphs_echo(priv._graph_properties, priv._saved_graph_properties, priv.__graphs__, node);
+		settle_owed_graphs_write(gobj, node);
 		return 0;
 	}
 	let desc = priv.descs[topic_name];
@@ -68408,6 +68467,29 @@ function treedb_delete_node(gobj, treedb_name, topic_name, record, options) {
 	if (ret) (0, _yuneta_gobj_js.log_error)(ret);
 }
 /************************************************************
+*  What a link or an unlink asks back with its answer: the
+*  topic of the CHILD (the node a link saves) and both refs.
+*  `child_ref` is "topic^id", `parent_ref` "topic^id^hook".
+************************************************************/
+function link_echo(parent_ref, child_ref) {
+	return {
+		topic_name: typeof child_ref === "string" ? child_ref.split("^")[0] : "",
+		parent_ref,
+		child_ref
+	};
+}
+/************************************************************
+*  The record a write answered: the node the store wrote (an
+*  update or a create), deleted, or the child of a link. The
+*  answer's frame carries back only `__md_command__`, never the
+*  request's own record.
+************************************************************/
+function answered_record(data) {
+	if (data && typeof data === "object" && !Array.isArray(data)) return data;
+	if (Array.isArray(data) && data[0] && typeof data[0] === "object") return data[0];
+	return {};
+}
+/************************************************************
 *  Command to remote service
 ************************************************************/
 function treedb_link_nodes(gobj, treedb_name, parent_ref, child_ref, options) {
@@ -68424,6 +68506,7 @@ function treedb_link_nodes(gobj, treedb_name, parent_ref, child_ref, options) {
 		child_ref,
 		options: options || {}
 	};
+	kw.__md_command__ = link_echo(parent_ref, child_ref);
 	let ret = (0, _yuneta_gobj_js.gobj_command)(priv.gobj_remote_yuno, command, kw, gobj);
 	if (ret) (0, _yuneta_gobj_js.log_error)(ret);
 }
@@ -68444,6 +68527,7 @@ function treedb_unlink_nodes(gobj, treedb_name, parent_ref, child_ref, options)
 		child_ref,
 		options: options || {}
 	};
+	kw.__md_command__ = link_echo(parent_ref, child_ref);
 	let ret = (0, _yuneta_gobj_js.gobj_command)(priv.gobj_remote_yuno, command, kw, gobj);
 	if (ret) (0, _yuneta_gobj_js.log_error)(ret);
 }
@@ -68658,13 +68742,20 @@ function ac_mt_command_answer$1(gobj, event, kw, src) {
 		case "link-nodes":
 		case "unlink-nodes":
 			if (result < 0 && command === "update-node") graphs_write_refused(gobj, (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0), (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "graph_topic", "", 0));
-			if (result >= 0 && (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0) !== "__graphs__") (0, _yuneta_gobj_js.gobj_publish_event)(gobj, "EV_RECORD_WRITTEN", {
-				treedb_name: (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "treedb_name", "", 0),
-				topic_name: (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0),
-				record: (0, _yuneta_gobj_js.kw_get_dict)(gobj, kw_command, "record", {}, 0),
-				created: command === "create-node",
-				command
-			});
+			if (result >= 0 && (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0) !== "__graphs__") {
+				let written = {
+					treedb_name: priv.treedb_name,
+					topic_name: (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "topic_name", "", 0),
+					record: answered_record(data),
+					created: command === "create-node",
+					command
+				};
+				if (command === "link-nodes" || command === "unlink-nodes") {
+					written.parent_ref = (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "parent_ref", "", 0);
+					written.child_ref = (0, _yuneta_gobj_js.kw_get_str)(gobj, kw_command, "child_ref", "", 0);
+				}
+				(0, _yuneta_gobj_js.gobj_publish_event)(gobj, "EV_RECORD_WRITTEN", written);
+			}
 			break;
 		default: (0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)} Command unknown: ${command}`);
 	}
@@ -72913,8 +73004,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");
 	if (!$notice) return;
 	clear($notice);
@@ -72931,14 +73026,15 @@ function show_notice(gobj, key, detail) {
 		},
 		(0, i18next.t)(key)
 	]));
-	if (detail && detail !== key) $notice.appendChild((0, _yuneta_gobj_js.createElement2)([
-		"span",
-		{
-			class: "SCHEMA_NOTICE_DETAIL yui-text-quiet ml-2",
-			i18n: `${detail}`
-		},
-		(0, i18next.t)(`${detail}`)
-	]));
+	if (detail && detail !== key) {
+		let attrs = { class: "SCHEMA_NOTICE_DETAIL yui-text-quiet ml-2" };
+		if (detail_is_key) attrs.i18n = `${detail}`;
+		$notice.appendChild((0, _yuneta_gobj_js.createElement2)([
+			"span",
+			attrs,
+			detail_is_key ? (0, i18next.t)(`${detail}`) : `${detail}`
+		]));
+	}
 }
 /***************************************************************
 *  A button of the toolbar. Every one carries an icon and a
@@ -73125,7 +73221,7 @@ function render(gobj) {
 		return;
 	}
 	if (state === "ST_IDLE") {
-		show_notice(gobj, priv.load_error ? "cannot load the schemas" : "not connected", priv.load_error);
+		show_notice(gobj, priv.load_error ? "cannot load the schemas" : "not connected", priv.load_error, true);
 		destroy_diagram(gobj);
 		clear($body);
 		return;