@yuneta/gobj-ui 5.15.0 → 5.17.0

package/dist/gobj-ui.es.js

@@ -15500,7 +15500,7 @@ function request_print_tranger$1(gobj, path) {
 *  would travel, be refused by the yuno, and come back as a toast --
 *  after the table had already drawn the row.
 ***************************************************************/
-function refuse_if_readonly$1(gobj, event) {
+function refuse_if_readonly$2(gobj, event) {
 	if (!gobj_read_bool_attr(gobj, "readonly")) return false;
 	log_error(`${gobj_short_name(gobj)}: ${event} refused, treedb '${gobj_read_str_attr(gobj, "treedb_name")}' is READ-ONLY`);
 	return true;
@@ -15572,7 +15572,8 @@ function ac_mt_command_answer$1(gobj, event, kw, src) {
 				treedb_name: kw_get_str(gobj, kw_command, "treedb_name", "", 0),
 				topic_name: kw_get_str(gobj, kw_command, "topic_name", "", 0),
 				record: kw_get_dict(gobj, kw_command, "record", {}, 0),
-				created: command === "create-node"
+				created: command === "create-node",
+				command
 			});
 			break;
 		case "delete-node": break;
@@ -15777,7 +15778,7 @@ function ac_treedb_node_deleted$1(gobj, event, kw, src) {
 *  }
 ********************************************/
 function ac_create_record(gobj, event, kw, src) {
-	if (refuse_if_readonly$1(gobj, event)) return -1;
+	if (refuse_if_readonly$2(gobj, event)) return -1;
 	let treedb_name = gobj_read_str_attr(gobj, "treedb_name");
 	let topic_name = gobj_read_attr(src, "topic_name");
 	let record = kw.record;
@@ -15795,7 +15796,7 @@ function ac_create_record(gobj, event, kw, src) {
 *  }
 ********************************************/
 function ac_update_record(gobj, event, kw, src) {
-	if (refuse_if_readonly$1(gobj, event)) return -1;
+	if (refuse_if_readonly$2(gobj, event)) return -1;
 	let treedb_name = gobj_read_str_attr(gobj, "treedb_name");
 	let topic_name = gobj_read_attr(src, "topic_name");
 	let record = kw.record;
@@ -15812,7 +15813,7 @@ function ac_update_record(gobj, event, kw, src) {
 *  }
 ********************************************/
 function ac_delete_record(gobj, event, kw, src) {
-	if (refuse_if_readonly$1(gobj, event)) return -1;
+	if (refuse_if_readonly$2(gobj, event)) return -1;
 	let treedb_name = gobj_read_str_attr(gobj, "treedb_name");
 	let topic_name = gobj_read_attr(src, "topic_name");
 	let record = kw.record;
@@ -17633,7 +17634,7 @@ function write_plan(gobj) {
 *  A read-only topic refuses the write EVENTS too, not only their
 *  buttons.
 ***************************************************************/
-function refuse_if_readonly(gobj, event) {
+function refuse_if_readonly$1(gobj, event) {
 	if (!gobj_read_bool_attr(gobj, "readonly")) return false;
 	log_error(`${gobj_short_name(gobj)}: ${event} refused, topic '${gobj_read_str_attr(gobj, "topic_name")}' is READ-ONLY`);
 	return true;
@@ -17705,7 +17706,10 @@ function ac_load_node_updated(gobj, event, kw, src) {
 		return -1;
 	}
 	let tabulator = gobj_read_attr(gobj, "tabulator");
-	if (tabulator) for (let record of data) tabulator.updateData([record]);
+	if (tabulator) {
+		for (let record of data) if (tabulator.getRow(record.id)) tabulator.updateData([record]);
+		else if (tabulator.getDataCount() > 0) log_error(`${gobj_short_name(gobj)}: updated node is not in the loaded table: ${record.id}`);
+	}
 	return 0;
 }
 /************************************************************
@@ -17730,7 +17734,7 @@ function ac_node_deleted$1(gobj, event, kw, src) {
 *      and the Op column is visible (with row's edit/delete icons)
 ************************************************************/
 function ac_edition_mode(gobj, event, kw, src) {
-	if (refuse_if_readonly(gobj, event)) return -1;
+	if (refuse_if_readonly$1(gobj, event)) return -1;
 	let tabulator = gobj_read_attr(gobj, "tabulator");
 	let editable = gobj_read_bool_attr(gobj, "editable");
 	editable = !editable;
@@ -17774,7 +17778,7 @@ function ac_edition_mode(gobj, event, kw, src) {
 *      - the backend will broadcast the new record that will be added to table
 ************************************************************/
 function ac_new_row(gobj, event, kw, src) {
-	if (refuse_if_readonly(gobj, event)) return -1;
+	if (refuse_if_readonly$1(gobj, event)) return -1;
 	let row = {};
 	let desc = gobj_read_attr(gobj, "desc");
 	for (let i = 0; i < desc.cols.length; i++) {
@@ -17804,7 +17808,7 @@ function ac_new_row(gobj, event, kw, src) {
 *          kw {index:, row:}
 ************************************************************/
 function ac_delete_rows(gobj, event, kw, src) {
-	if (refuse_if_readonly(gobj, event)) return -1;
+	if (refuse_if_readonly$1(gobj, event)) return -1;
 	let tabulator = gobj_read_attr(gobj, "tabulator");
 	if (json_size(kw) === 0) {
 		let rows = tabulator.getSelectedData();
@@ -17868,7 +17872,7 @@ function ac_copy_rows(gobj, event, kw, src) {
 *  From internal
 ************************************************************/
 function ac_paste_rows(gobj, event, kw, src) {
-	if (refuse_if_readonly(gobj, event)) return -1;
+	if (refuse_if_readonly$1(gobj, event)) return -1;
 	if (kw.topic_name === gobj_read_str_attr(gobj, "topic_name") && kw.treedb_name === gobj_read_str_attr(gobj, "treedb_name")) for (let row of kw.rows) gobj_publish_event(gobj, "EV_CREATE_RECORD", {
 		topic_name: gobj_read_str_attr(gobj, "topic_name"),
 		record: row
@@ -17881,7 +17885,7 @@ function ac_paste_rows(gobj, event, kw, src) {
 *  fkeys, times and numbers). Route by the form's mode.
 ************************************************************/
 function ac_form_save_record(gobj, event, kw, src) {
-	if (refuse_if_readonly(gobj, event)) return -1;
+	if (refuse_if_readonly$1(gobj, event)) return -1;
 	let mode = gobj_read_str_attr(src, "form_mode");
 	gobj_publish_event(gobj, mode === "create" ? "EV_CREATE_RECORD" : "EV_UPDATE_RECORD", {
 		topic_name: gobj_read_str_attr(gobj, "topic_name"),
@@ -18289,6 +18293,7 @@ var attrs_table$3 = [
 	SDATA(data_type_t.DTP_STRING, "treedb_name", 0, null, "Remote service treedb name"),
 	SDATA(data_type_t.DTP_DICT, "descs", 0, null, "Descriptions of topics obtained"),
 	SDATA(data_type_t.DTP_BOOLEAN, "system", 0, false, "Manage system topics (true) or user topics (false)"),
+	SDATA(data_type_t.DTP_BOOLEAN, "readonly", 0, false, "The whole treedb is read-only: the graph drops its `edition` mode (the only one that draws write affordances) and refuses every write event. Set it when this yuno is not the MASTER of the treedb's tranger -- only the master can write, and the yuno answers 'READ-ONLY' to a write since SDK 7.13.0 (ask `treedb-info`)"),
 	SDATA(data_type_t.DTP_STRING, "back_route", 0, "", "Optional hash route for a '← topics' button back to the topics grid (host-supplied; empty = no button)"),
 	SDATA(data_type_t.DTP_STRING, "base_route", 0, "", "This view's base route (host-supplied); used to declare its per-topic focus sub-routes to the site map (ROUTING.md contributor)."),
 	SDATA(data_type_t.DTP_DICT, "records", 0, "{}", "Data of topics"),
@@ -18339,6 +18344,7 @@ function mt_create$3(gobj) {
 	if (!subscriber) subscriber = gobj_parent(gobj);
 	gobj_subscribe_event(gobj, null, {}, subscriber);
 	if (!priv.treedb_name) log_error(`${gobj_name(gobj)} -> treedb_name not configured`);
+	if (gobj_read_bool_attr(gobj, "readonly") && priv.operation_mode === "edition") gobj_write_str_attr(gobj, "operation_mode", "reading");
 	let canvas_id = clean_name(gobj_name(gobj)) + "-canvas";
 	gobj_write_attr(gobj, "canvas_id", canvas_id);
 	let $container_canvas = build_ui$3(gobj).querySelector(`#${priv.canvas_id}`);
@@ -18493,6 +18499,8 @@ function destroy_ui(gobj) {
 ************************************************************/
 function make_toolbar(gobj) {
 	gobj.priv;
+	let modes = gobj_read_attr(gobj, "operation_modes");
+	if (gobj_read_bool_attr(gobj, "readonly")) modes = modes.filter((mode) => mode !== "edition");
 	const $toolbar_header = yui_toolbar({}, [
 		[
 			"div",
@@ -18531,7 +18539,7 @@ function make_toolbar(gobj) {
 					[[
 						"select",
 						{ class: "GRAPH_MODE_SELECT" },
-						gobj_read_attr(gobj, "operation_modes").map((item) => [
+						modes.map((item) => [
 							"option",
 							{},
 							item
@@ -19083,6 +19091,19 @@ function refresh_data(gobj) {
 	if (priv.gobj_nodes_tree) gobj_send_event(priv.gobj_nodes_tree, "EV_CLEAR_DATA", {}, gobj);
 	request_treedb_descs(gobj);
 }
+/********************************************
+*  The last gate before a write leaves for the yuno. The `edition`
+*  mode is gone on a replica, so no button can raise these -- but the
+*  G6 child also publishes them from its undo/redo history and from
+*  saving the node geometry, and a write that got this far would
+*  travel, be refused by the yuno, and come back as a toast with the
+*  graph already redrawn.
+********************************************/
+function refuse_if_readonly(gobj, event) {
+	if (!gobj_read_bool_attr(gobj, "readonly")) return false;
+	log_error(`${gobj_short_name(gobj)}: ${event} refused, treedb '${gobj_read_str_attr(gobj, "treedb_name")}' is READ-ONLY`);
+	return true;
+}
 /***************************
 *      Actions
 ***************************/
@@ -19151,7 +19172,15 @@ function ac_mt_command_answer(gobj, event, kw, src) {
 		case "update-node":
 		case "delete-node":
 		case "link-nodes":
-		case "unlink-nodes": break;
+		case "unlink-nodes":
+			if (result >= 0 && kw_get_str(gobj, kw_command, "topic_name", "", 0) !== "__graphs__") gobj_publish_event(gobj, "EV_RECORD_WRITTEN", {
+				treedb_name: kw_get_str(gobj, kw_command, "treedb_name", "", 0),
+				topic_name: kw_get_str(gobj, kw_command, "topic_name", "", 0),
+				record: kw_get_dict(gobj, kw_command, "record", {}, 0),
+				created: command === "create-node",
+				command
+			});
+			break;
 		default: log_error(`${gobj_short_name(gobj)} Command unknown: ${command}`);
 	}
 	return 0;
@@ -19370,7 +19399,9 @@ function ac_edge_clicked(gobj, event, kw, src) {
 *  Send to backend
 ********************************************/
 function ac_create_node(gobj, event, kw, src) {
-	let treedb_name = gobj.priv.treedb_name;
+	let priv = gobj.priv;
+	if (refuse_if_readonly(gobj, event)) return -1;
+	let treedb_name = priv.treedb_name;
 	let topic_name = kw.topic_name;
 	let record = kw.record;
 	return treedb_create_node(gobj, treedb_name, topic_name, record, kw.options || {});
@@ -19385,7 +19416,9 @@ function ac_create_node(gobj, event, kw, src) {
 *  Send to backend
 ********************************************/
 function ac_update_node(gobj, event, kw, src) {
-	let treedb_name = gobj.priv.treedb_name;
+	let priv = gobj.priv;
+	if (refuse_if_readonly(gobj, event)) return -1;
+	let treedb_name = priv.treedb_name;
 	let topic_name = kw.topic_name;
 	let record = kw.record;
 	return treedb_update_node(gobj, treedb_name, topic_name, record, kw.options || {});
@@ -19400,7 +19433,9 @@ function ac_update_node(gobj, event, kw, src) {
 *  Send to backend
 ********************************************/
 function ac_delete_node(gobj, event, kw, src) {
-	let treedb_name = gobj.priv.treedb_name;
+	let priv = gobj.priv;
+	if (refuse_if_readonly(gobj, event)) return -1;
+	let treedb_name = priv.treedb_name;
 	let topic_name = kw.topic_name;
 	let record = kw.record;
 	return treedb_delete_node(gobj, treedb_name, topic_name, record, kw.options || {});
@@ -19415,7 +19450,9 @@ function ac_delete_node(gobj, event, kw, src) {
 *  Send to backend
 ********************************************/
 function ac_link_nodes(gobj, event, kw, src) {
-	let treedb_name = gobj.priv.treedb_name;
+	let priv = gobj.priv;
+	if (refuse_if_readonly(gobj, event)) return -1;
+	let treedb_name = priv.treedb_name;
 	let parent_ref = kw.parent_ref;
 	let child_ref = kw.child_ref;
 	return treedb_link_nodes(gobj, treedb_name, parent_ref, child_ref, kw.options || {});
@@ -19430,7 +19467,9 @@ function ac_link_nodes(gobj, event, kw, src) {
 *  Send to backend
 ********************************************/
 function ac_unlink_nodes(gobj, event, kw, src) {
-	let treedb_name = gobj.priv.treedb_name;
+	let priv = gobj.priv;
+	if (refuse_if_readonly(gobj, event)) return -1;
+	let treedb_name = priv.treedb_name;
 	let parent_ref = kw.parent_ref;
 	let child_ref = kw.child_ref;
 	return treedb_unlink_nodes(gobj, treedb_name, parent_ref, child_ref, kw.options || {});
@@ -19470,6 +19509,10 @@ function ac_set_layout$1(gobj, event, kw, src) {
 function ac_set_operation_mode$1(gobj, event, kw, src) {
 	let priv = gobj.priv;
 	let operation_mode = kw.operation_mode;
+	if (operation_mode === "edition" && gobj_read_bool_attr(gobj, "readonly")) {
+		log_error(`${gobj_short_name(gobj)}: edition mode refused, treedb '${gobj_read_str_attr(gobj, "treedb_name")}' is READ-ONLY`);
+		return -1;
+	}
 	gobj_write_str_attr(gobj, "operation_mode", operation_mode);
 	gobj_save_persistent_attrs(gobj, "operation_mode");
 	let $operation_mode_select = priv.$container.querySelector(".GRAPH_MODE_SELECT");
@@ -19691,6 +19734,7 @@ function create_gclass$3(gclass_name) {
 		["EV_SET_OPERATION_MODE", 0],
 		["EV_SET_FOCUS_TOPIC", 0],
 		["EV_OPERATION_MODE_CHANGED", event_flag_t.EVF_OUTPUT_EVENT | event_flag_t.EVF_NO_WARN_SUBS],
+		["EV_RECORD_WRITTEN", event_flag_t.EVF_OUTPUT_EVENT | event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_SHOW", 0],
 		["EV_HIDE", 0],
 		["EV_TRANSPORT_STATE", 0]
@@ -19710,11 +19754,26 @@ function register_c_yui_treedb_graph() {
 /***********************************************************************
 *          c_yui_treedb_schema.js
 *
-*      Schema-graph landing (prototype): the treedb drawn as a GRAPH OF
-*      TOPICS — one node per topic, one edge per hook/fkey relationship
-*      — from the schema `descs` alone (no data, no backend calls). A
-*      node click opens that topic's table (a real hash navigation via
-*      the host-supplied `node_route`). An alternate landing to the
+*      Schema-graph landing: the treedb drawn the way its `.c` literal
+*      draws it in ASCII (treedb_schema_*.c, treedb_system_schema.c) —
+*      one CARD per topic listing its fields in schema order, one edge
+*      per hook, from the row that declares the hook to the fkey row of
+*      the child it names. Built from the schema `descs` alone: no data,
+*      no backend calls.
+*
+*      WHY THE CARD AND NOT A DOT. A topic is its fields; a schema is
+*      read to find out what a topic holds and what links to what. A
+*      graph of labelled dots answers neither, and the node graph next
+*      door (C_G6_NODES_TREE) answers a different question entirely —
+*      it draws the RECORDS, so on a treedb whose records are schemas
+*      it draws one box per column, hundreds of them, each labelled by
+*      a pkey that may be a rowid. This view draws the schema itself.
+*
+*      The marks are the notation of the `.c` literals, so the drawing
+*      and the source read the same — see schema_rows().
+*
+*      A node click opens that topic's table (a real hash navigation
+*      via the host-supplied `node_route`). An alternate landing to the
 *      topic cards, in the spirit of "every treedb is a graph".
 *
 *          Copyright (c) 2026, ArtGins.
@@ -19724,6 +19783,27 @@ function register_c_yui_treedb_graph() {
 *              Constants
 ***************************************************************/
 var GCLASS_NAME$2 = "C_YUI_TREEDB_SCHEMA";
+/************************************************************
+*   Geometry of a card, in one place: the row height is what
+*   turns a field's index into the vertical position of its
+*   port, so an edge leaves the very row that declares the
+*   hook and lands on the row that declares the fkey.
+************************************************************/
+var CARD_HEADER_H = 30;
+var CARD_ROW_H = 19;
+var CARD_PAD_V = 7;
+var CARD_MIN_W = 210;
+var CARD_MAX_W = 340;
+var topic_colors = [
+	"rgb(237, 201, 73)",
+	"rgb(118, 183, 178)",
+	"rgb(255, 157, 167)",
+	"rgb(175, 122, 161)",
+	"rgb(89, 161, 79)",
+	"rgb(186, 176, 171)",
+	"rgb(66, 146, 198)"
+];
+var SYSTEM_TOPIC_COLOR = "rgb(148, 163, 184)";
 /***************************************************************
 *              Data
 ***************************************************************/
@@ -19785,48 +19865,254 @@ function build_ui$2(gobj) {
 	gobj_write_attr(gobj, "$container", $container);
 }
 /************************************************************
+*   The shape of a hook/fkey field, from the type it declares.
+*   `dict` and `object` are the SAME thing to treedb (both build
+*   a json object keyed by child id), and so are `list` and
+*   `array` — see the hook/fkey switches in tr_treedb.c. A
+*   `string` holds one reference, so it draws as one.
+************************************************************/
+function hook_mark(type) {
+	if (type === "dict" || type === "object") return "{}";
+	if (type === "list" || type === "array") return "[]";
+	return "()";
+}
+/************************************************************
+*   The fields of one topic, as the schema declares them.
+*
+*   The marks are the notation of the schema `.c` literals
+*   (treedb_schema_*.c, treedb_system_schema.c), so the
+*   drawing and the source read the same:
+*      {}   dict hook   (N unique children)
+*      []   list hook   (n not-unique children)
+*      ()   1 child
+*      (↖)  1 fkey      (1 parent)
+*      [↖]  n fkeys     (n parents)
+*      {↖}  N fkeys     (N parents)
+*      *    required
+*      #    the primary key
+*
+*   A column can be BOTH hook and fkey, so the flags are read
+*   here rather than through treedb_get_field_desc's single
+*   `type`, which keeps only the last flag it saw.
+************************************************************/
+function schema_rows(desc) {
+	let rows = [];
+	if (!is_object(desc) || !Array.isArray(desc.cols)) return rows;
+	for (let col of desc.cols) {
+		if (!is_object(col) || !col.id) continue;
+		let flags = Array.isArray(col.flag) ? col.flag : [];
+		let is_hook = flags.indexOf("hook") >= 0;
+		let is_fkey = flags.indexOf("fkey") >= 0;
+		let mark = "";
+		if (is_hook) mark = hook_mark(col.type);
+		if (is_fkey) {
+			let fmark = hook_mark(col.type).replace("}", "↖}").replace("]", "↖]").replace(")", "↖)");
+			mark = mark ? mark + " " + fmark : fmark;
+		}
+		rows.push({
+			name: col.id,
+			type: col.type || "",
+			mark,
+			is_hook,
+			is_fkey,
+			is_pkey: col.id === desc.pkey,
+			required: flags.indexOf("required") >= 0 || flags.indexOf("notnull") >= 0
+		});
+	}
+	return rows;
+}
+/************************************************************
+*   Size of the card that holds those rows. The width follows
+*   the longest line so a long field name is not clipped into
+*   an ellipsis — the point of the drawing is to read them.
+************************************************************/
+function card_size(rows) {
+	let longest = 0;
+	for (let row of rows) {
+		let len = row.name.length + (row.mark ? row.mark.length + 2 : 0) + 2;
+		if (len > longest) longest = len;
+	}
+	let w = Math.round(26 + longest * 6.6);
+	if (w < CARD_MIN_W) w = CARD_MIN_W;
+	if (w > CARD_MAX_W) w = CARD_MAX_W;
+	let h = 44 + rows.length * CARD_ROW_H;
+	return [w, h];
+}
+/************************************************************
+*   Vertical placement of a field's port, as a fraction of the
+*   card height: the centre of its own row.
+************************************************************/
+function row_placement(index, height) {
+	return (37 + index * CARD_ROW_H + CARD_ROW_H / 2) / height;
+}
+/************************************************************
+*   The card itself. Header = topic name on its topic colour;
+*   body = one line per field, in schema order.
+************************************************************/
+function build_card_innerHTML(topic, rows, color, dark) {
+	let surface = dark ? "#1b2230" : "#ffffff";
+	let bg = dark ? `color-mix(in srgb, ${color} 18%, #232b38)` : `color-mix(in srgb, ${color} 6%, ${surface})`;
+	let border = dark ? `color-mix(in srgb, ${color} 85%, #ffffff)` : color;
+	let header_bg = dark ? `color-mix(in srgb, ${color} 45%, #2c3542)` : `color-mix(in srgb, ${color} 28%, ${surface})`;
+	let title_color = dark ? "#e8eaed" : "#0f172a";
+	let text_color = dark ? "#d3d8de" : "#334155";
+	let mute_color = dark ? "#98a2b0" : "#7c8694";
+	let rule_color = dark ? "rgba(255,255,255,0.06)" : "rgba(15,23,42,0.05)";
+	let shadow = dark ? "0 1px 3px rgba(0,0,0,0.45), 0 1px 2px rgba(0,0,0,0.30)" : "0 1px 3px rgba(15,23,42,0.12), 0 1px 2px rgba(15,23,42,0.06)";
+	let rows_html = "";
+	for (let row of rows) {
+		let lead = row.is_pkey ? "#" : row.required ? "*" : "";
+		let name_weight = row.is_pkey || row.required ? "600" : "400";
+		let name_color = row.is_hook || row.is_fkey ? title_color : text_color;
+		rows_html += `    <div class="TREEDB_SCHEMA_FIELD" style="
+        display: flex; align-items: center; gap: 6px;
+        height: ${CARD_ROW_H}px; line-height: ${CARD_ROW_H}px;
+        padding: 0 10px; border-top: 1px solid ${rule_color};
+    ">
+        <span style="
+            width: 8px; flex: 0 0 8px; text-align: center;
+            color: ${mute_color}; font-size: 11px;
+        ">${lead}</span>
+        <span style="
+            flex: 1 1 auto; min-width: 0; overflow: hidden;
+            text-overflow: ellipsis; white-space: nowrap;
+            font-size: 12px; font-weight: ${name_weight}; color: ${name_color};
+        ">${escapeHtml(row.name)}</span>
+        <span style="
+            flex: 0 0 auto; font-size: 11px; color: ${mute_color};
+            font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+        ">${escapeHtml(row.mark)}</span>
+    </div>
+`;
+	}
+	return `
+<div class="TREEDB_SCHEMA_CARD" title="${escapeHtml(topic)}" style="
+    box-sizing: border-box;
+    width: 100%;
+    height: 100%;
+    background: ${bg};
+    border: 1.5px solid ${border};
+    border-radius: 8px;
+    box-shadow: ${shadow};
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    cursor: pointer;
+">
+    <div class="TREEDB_SCHEMA_CARD_HEADER" style="
+        height: ${CARD_HEADER_H}px; line-height: ${CARD_HEADER_H}px;
+        flex: 0 0 ${CARD_HEADER_H}px;
+        padding: 0 10px; background: ${header_bg}; color: ${title_color};
+        font-size: 13px; font-weight: 700;
+        overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+    ">${escapeHtml(topic)}</div>
+    <div class="TREEDB_SCHEMA_CARD_BODY" style="
+        flex: 1 1 auto; padding: ${CARD_PAD_V}px 0; overflow: hidden;
+    ">
+${rows_html}    </div>
+</div>
+`;
+}
+/************************************************************
 *   Derive {nodes, edges} from the schema.
-*   Node  = a topic.  Edge  = a hook (parent -> child) or an
-*   fkey (child -> parent, reversed to parent -> child), deduped.
+*
+*   Node = a topic, drawn as the card the `.c` literal draws in
+*   ASCII: its name and its fields. Edge = a hook, from the row
+*   that declares it to the fkey row of the child it names —
+*   `'hook': {'users': 'departments'}` says both ends, so the
+*   arrow can land where the `.c` drawing lands it. An fkey
+*   whose parent declares no hook still gets its edge, or a
+*   half-declared schema would draw as disconnected.
+*
 *   Left-to-right dagre follows the parent -> child data flow.
 ************************************************************/
 function schema_to_graph(gobj) {
 	let descs = gobj_read_attr(gobj, "descs");
 	let system = gobj_read_bool_attr(gobj, "system");
+	let dark = yui_is_dark();
 	let nodes = [];
-	let topic_set = {};
+	let cards = {};
 	if (!is_object(descs)) return {
 		nodes,
 		edges: []
 	};
+	let idx = 0;
 	for (let topic of Object.keys(descs)) {
-		if (!system && topic.substring(0, 2) === "__") continue;
-		topic_set[topic] = true;
+		let is_system = topic.substring(0, 2) === "__";
+		if (!system && is_system) continue;
+		let rows = schema_rows(descs[topic]);
+		let color;
+		if (is_system) color = SYSTEM_TOPIC_COLOR;
+		else {
+			color = topic_colors[idx % topic_colors.length];
+			idx++;
+		}
+		cards[topic] = {
+			rows,
+			size: card_size(rows),
+			color
+		};
+	}
+	for (let topic of Object.keys(cards)) {
+		let card = cards[topic];
+		let [w, h] = card.size;
+		let ports = [];
+		for (let i = 0; i < card.rows.length; i++) {
+			let row = card.rows[i];
+			if (!row.is_hook && !row.is_fkey) continue;
+			ports.push({
+				key: row.name,
+				placement: [row.is_hook ? 1 : 0, row_placement(i, h)],
+				fill: card.color,
+				stroke: getStrokeColor(card.color)
+			});
+		}
 		nodes.push({
 			id: topic,
-			data: { topic_name: topic }
+			type: "html",
+			style: {
+				size: [w, h],
+				dx: -w / 2,
+				dy: -h / 2,
+				innerHTML: build_card_innerHTML(topic, card.rows, card.color, dark),
+				port: ports.length > 0,
+				ports,
+				portR: 3,
+				portLineWidth: 1
+			},
+			data: {
+				topic_name: topic,
+				rows: card.rows,
+				color: card.color
+			}
 		});
 	}
 	let edge_seen = {};
 	let edges = [];
-	let add_edge = (source, target) => {
-		if (!topic_set[source] || !topic_set[target] || source === target) return;
-		let key = source + "
" + target;
+	let add_edge = (source, source_port, target, target_port) => {
+		if (!cards[source] || !cards[target]) return;
+		let key = `${source}|${source_port}|${target}|${target_port}`;
 		if (edge_seen[key]) return;
 		edge_seen[key] = true;
 		edges.push({
 			id: key,
+			type: "cubic",
 			source,
-			target
+			target,
+			style: {
+				sourcePort: source_port,
+				targetPort: target_port
+			}
 		});
 	};
-	for (let topic of Object.keys(descs)) {
+	for (let topic of Object.keys(cards)) {
 		let desc = descs[topic];
 		if (!is_object(desc) || !Array.isArray(desc.cols)) continue;
 		for (let col of desc.cols) {
-			if (!col) continue;
-			if (is_object(col.hook)) for (let child of Object.keys(col.hook)) add_edge(topic, child);
-			else if (is_object(col.fkey)) for (let parent of Object.keys(col.fkey)) add_edge(parent, topic);
+			if (!is_object(col) || !col.id) continue;
+			if (is_object(col.hook)) for (let child of Object.keys(col.hook)) add_edge(topic, col.id, child, col.hook[child]);
+			if (is_object(col.fkey)) for (let parent of Object.keys(col.fkey)) add_edge(parent, col.fkey[parent], topic, col.id);
 		}
 	}
 	return {
@@ -19835,26 +20121,15 @@ function schema_to_graph(gobj) {
 	};
 }
 /************************************************************
-*   The theme-dependent styles, in ONE place: they are applied
-*   as the graph is built and re-applied on a theme switch
+*   The theme-dependent edge style, in ONE place: applied as
+*   the graph is built and re-applied on a theme switch
 *   (ac_theme), which restyles the LIVE graph — rebuilding it
 *   would drop the user's zoom/pan and any dragged node.
 ************************************************************/
-function node_style(dark) {
-	return {
-		size: 40,
-		fill: "#5B8FF9",
-		labelText: (d) => d.id,
-		labelPlacement: "bottom",
-		labelFill: dark ? "#e6e6e6" : "#333333",
-		labelBackground: true,
-		labelBackgroundFill: dark ? "rgba(0,0,0,0.5)" : "rgba(255,255,255,0.7)",
-		cursor: "pointer"
-	};
-}
 function edge_style(dark) {
 	return {
-		stroke: dark ? "#666666" : "#bbbbbb",
+		stroke: dark ? "#7a8593" : "#9aa4b2",
+		lineWidth: 1.2,
 		endArrow: true
 	};
 }
@@ -19886,13 +20161,12 @@ function build_graph$1(gobj) {
 			container: $container,
 			autoResize: true,
 			data,
-			node: { style: node_style(dark) },
 			edge: { style: edge_style(dark) },
 			layout: {
 				type: "antv-dagre",
 				rankdir: "LR",
-				nodesep: 24,
-				ranksep: 60
+				nodesep: 28,
+				ranksep: 90
 			},
 			behaviors: [
 				"zoom-canvas",
@@ -19977,8 +20251,17 @@ function ac_theme$1(gobj, event, kw, src) {
 	let dark = kw && kw.theme ? kw.theme === "dark" : yui_is_dark();
 	try {
 		graph.setTheme(dark ? "dark" : "light");
-		graph.setNode({ style: node_style(dark) });
 		graph.setEdge({ style: edge_style(dark) });
+		let updates = [];
+		for (let node of graph.getNodeData()) {
+			let data = node.data;
+			if (!is_object(data) || !Array.isArray(data.rows)) continue;
+			updates.push({
+				id: node.id,
+				style: { innerHTML: build_card_innerHTML(data.topic_name, data.rows, data.color, dark) }
+			});
+		}
+		if (updates.length > 0) graph.updateNodeData(updates);
 		graph.draw().catch((e) => {
 			log_error(`${gobj_short_name(gobj)}: schema graph redraw failed: ${e}`);
 		});
@@ -20043,6 +20326,58 @@ function register_c_yui_treedb_schema() {
 	return create_gclass$2(GCLASS_NAME$2);
 }
 //#endregion
+//#region src/treedb_node_label.js
+/***********************************************************************
+*          treedb_node_label.js
+*
+*      Pure, testable logic behind the label of a node in the treedb
+*      graph: WHAT A RECORD IS CALLED, which is not always what it is
+*      keyed by. Kept out of the gclass so it can be unit-tested with
+*      no DOM and no G6.
+*
+*          Copyright (c) 2026, ArtGins.
+*          All Rights Reserved.
+***********************************************************************/
+/************************************************************
+*  What a node is CALLED, which is not always what it is
+*  keyed by.
+*
+*  A topic whose id column is flagged `rowid` or `uuid` keys
+*  its records by a value nobody reads — that is the point of
+*  those flags — and the name a human knows the record by
+*  lives in the secondary key the topic declares (`pkey2s`,
+*  carried in the desc since SDK > 7.13.0). The `topics` and
+*  `cols` topics of treedb_system_schema are the case that
+*  forced this: keyed by rowid, named in `value`, so every
+*  card in the graph read "181", "225", "193".
+*
+*  The pkey stays reachable: it is the card's tooltip.
+*
+*  Falls back to the id whenever the schema does not say
+*  otherwise — an older node whose desc carries no `pkey2s`
+*  included.
+************************************************************/
+function node_label(desc, record) {
+	let id = record.id;
+	let id_col = null;
+	if (Array.isArray(desc.cols)) {
+		for (let col of desc.cols) if (col && col.id === (desc.pkey || "id")) {
+			id_col = col;
+			break;
+		}
+	}
+	if (!id_col || !Array.isArray(id_col.flag)) return id;
+	if (id_col.flag.indexOf("rowid") < 0 && id_col.flag.indexOf("uuid") < 0) return id;
+	let pkey2s = desc.pkey2s;
+	if (typeof pkey2s === "string") pkey2s = pkey2s ? [pkey2s] : [];
+	if (!Array.isArray(pkey2s)) return id;
+	for (let name of pkey2s) {
+		let value = record[name];
+		if (typeof value === "string" && value.length > 0) return value;
+	}
+	return id;
+}
+//#endregion
 //#region node_modules/@babel/runtime/helpers/esm/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
@@ -47575,19 +47910,19 @@ function create_topic_node(gobj, desc, record) {
 		style.size = [116, 40];
 		style.dx = -58;
 		style.dy = -20;
-		style.innerHTML = build_chip_innerHTML(desc.color, priv.theme, record.icon, record.id);
+		style.innerHTML = build_chip_innerHTML(desc.color, priv.theme, record.icon, node_label(desc, record), record.id);
 	} else if (node_treedb_type === "extended") {
 		node_graph_type = "html";
 		style.size = [144, 66];
 		style.dx = -72;
 		style.dy = -33;
-		style.innerHTML = build_node_innerHTML(desc.color, priv.theme, record.icon, record.id, desc.topic_name, true);
+		style.innerHTML = build_node_innerHTML(desc.color, priv.theme, record.icon, node_label(desc, record), desc.topic_name, true, record.id);
 	} else {
 		node_graph_type = "html";
 		style.size = [172, 96];
 		style.dx = -86;
 		style.dy = -48;
-		style.innerHTML = build_node_innerHTML(desc.color, priv.theme, record.icon, record.id, desc.topic_name);
+		style.innerHTML = build_node_innerHTML(desc.color, priv.theme, record.icon, node_label(desc, record), desc.topic_name, false, record.id);
 	}
 	let topic_props = priv._graph_properties[desc.topic_name];
 	let topic_defaults = is_object(topic_props) && is_object(topic_props.defaults) ? topic_props.defaults : null;
@@ -47655,15 +47990,15 @@ function update_topic_node(gobj, desc, node_name, record) {
 		nodedata.data.record = record;
 		if (desc.node_treedb_type === "child") graph.updateNodeData([{
 			id: node_name,
-			style: { innerHTML: build_chip_innerHTML(desc.color, priv.theme, record.icon, record.id) }
+			style: { innerHTML: build_chip_innerHTML(desc.color, priv.theme, record.icon, node_label(desc, record), record.id) }
 		}]);
 		else if (desc.node_treedb_type === "extended") graph.updateNodeData([{
 			id: node_name,
-			style: { innerHTML: build_node_innerHTML(desc.color, priv.theme, record.icon, record.id, desc.topic_name, true) }
+			style: { innerHTML: build_node_innerHTML(desc.color, priv.theme, record.icon, node_label(desc, record), desc.topic_name, true, record.id) }
 		}]);
 		else if (desc.node_treedb_type === "hierarchical") graph.updateNodeData([{
 			id: node_name,
-			style: { innerHTML: build_node_innerHTML(desc.color, priv.theme, record.icon, record.id, desc.topic_name) }
+			style: { innerHTML: build_node_innerHTML(desc.color, priv.theme, record.icon, node_label(desc, record), desc.topic_name, false, record.id) }
 		}]);
 	} catch (e) {
 		log_error(e.message);
@@ -49570,7 +49905,7 @@ function show_node_popover(gobj) {
 		};
 		if (node_graph_type === "hierarchical") {
 			let record = nodeData.data.record || {};
-			updateStyle.innerHTML = build_node_innerHTML(fill, priv.theme, record.icon, record.id, nodeData.data.desc.topic_name);
+			updateStyle.innerHTML = build_node_innerHTML(fill, priv.theme, record.icon, node_label(nodeData.data.desc, record), nodeData.data.desc.topic_name, false, record.id);
 		}
 		graph.updateNodeData([{
 			id: node_id,
@@ -49610,7 +49945,7 @@ function show_node_popover(gobj) {
 			};
 			if (node_graph_type === "hierarchical") {
 				let record = nodeData.data.record || {};
-				restoreStyle.innerHTML = build_node_innerHTML(origFill, priv.theme, record.icon, record.id, nodeData.data.desc.topic_name);
+				restoreStyle.innerHTML = build_node_innerHTML(origFill, priv.theme, record.icon, node_label(nodeData.data.desc, record), nodeData.data.desc.topic_name, false, record.id);
 			}
 			graph.updateNodeData([{
 				id: node_id,
@@ -49711,15 +50046,15 @@ function refresh_html_nodes_theme(gobj, theme) {
 		let record = nd.data.record || {};
 		if (tt === "hierarchical") updates.push({
 			id: nodes[i].id,
-			style: { innerHTML: build_node_innerHTML(nd.data.desc.color, theme, record.icon, record.id, nd.data.desc.topic_name) }
+			style: { innerHTML: build_node_innerHTML(nd.data.desc.color, theme, record.icon, node_label(nd.data.desc, record), nd.data.desc.topic_name, false, record.id) }
 		});
 		else if (tt === "child") updates.push({
 			id: nodes[i].id,
-			style: { innerHTML: build_chip_innerHTML(nd.data.desc.color, theme, record.icon, record.id) }
+			style: { innerHTML: build_chip_innerHTML(nd.data.desc.color, theme, record.icon, node_label(nd.data.desc, record), record.id) }
 		});
 		else if (tt === "extended") updates.push({
 			id: nodes[i].id,
-			style: { innerHTML: build_node_innerHTML(nd.data.desc.color, theme, record.icon, record.id, nd.data.desc.topic_name, true) }
+			style: { innerHTML: build_node_innerHTML(nd.data.desc.color, theme, record.icon, node_label(nd.data.desc, record), nd.data.desc.topic_name, true, record.id) }
 		});
 	}
 	if (updates.length > 0) graph.updateNodeData(updates);
@@ -49751,7 +50086,8 @@ function refresh_default_edges_theme(gobj, theme) {
 *  but lighter (1px border, no shadow, single line). The name is
 *  always legible (ellipsis + native title tooltip on overflow).
 ************************************************************/
-function build_chip_innerHTML(color, theme, icon, id) {
+function build_chip_innerHTML(color, theme, icon, label, key) {
+	let title = key || label;
 	let dark = theme === "dark";
 	let bg = dark ? `color-mix(in srgb, ${color} 30%, #2c3542)` : `color-mix(in srgb, ${color} 10%, ${dark ? "#1b2230" : "#ffffff"})`;
 	let border = dark ? `color-mix(in srgb, ${color} 85%, #ffffff)` : color;
@@ -49762,7 +50098,7 @@ function build_chip_innerHTML(color, theme, icon, id) {
         margin-right: 6px; flex: 0 0 auto;
     "/>`;
 	return `
-<div title="${escapeHtml(id)}" style="
+<div title="${escapeHtml(title)}" style="
     box-sizing: border-box;
     width: 100%;
     height: 100%;
@@ -49779,7 +50115,7 @@ function build_chip_innerHTML(color, theme, icon, id) {
 ">${icon_html}<span style="
         font-size: 12px; font-weight: 600; line-height: 1;
         overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
-    ">${escapeHtml(id)}</span>
+    ">${escapeHtml(label)}</span>
 </div>
 `;
 }
@@ -49793,7 +50129,8 @@ function build_chip_innerHTML(color, theme, icon, id) {
 *  colour is kept (per-topic differentiation) but softened via
 *  color-mix instead of a harsh saturated fill. Theme-aware.
 ************************************************************/
-function build_node_innerHTML(color, theme, icon, id, topic_name, structural) {
+function build_node_innerHTML(color, theme, icon, label, topic_name, structural, key) {
+	let title = key || label;
 	let dark = theme === "dark";
 	let surface = dark ? "#1b2230" : "#ffffff";
 	let bg, border, border_style;
@@ -49823,7 +50160,7 @@ function build_node_innerHTML(color, theme, icon, id, topic_name, structural) {
         overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
     ">${escapeHtml(topic_name)}</div>`;
 	return `
-<div title="${escapeHtml(id)}" style="
+<div title="${escapeHtml(title)}" style="
     box-sizing: border-box;
     width: 100%;
     height: 100%;
@@ -49846,7 +50183,7 @@ function build_node_innerHTML(color, theme, icon, id, topic_name, structural) {
         max-width: 100%; overflow: hidden; text-overflow: ellipsis;
         display: -webkit-box; -webkit-line-clamp: 2;
         -webkit-box-orient: vertical; word-break: break-word;
-    ">${escapeHtml(id)}</div>${sub_html}
+    ">${escapeHtml(label)}</div>${sub_html}
 </div>
 `;
 }
@@ -50067,7 +50404,7 @@ function apply_node_properties(gobj, node_id, fill, stroke, lineWidth, scope) {
 		};
 		if (nd.data.desc.node_treedb_type === "hierarchical") {
 			let record = nd.data.record || {};
-			updateStyle.innerHTML = build_node_innerHTML(fill, priv.theme, record.icon, record.id, nd.data.desc.topic_name);
+			updateStyle.innerHTML = build_node_innerHTML(fill, priv.theme, record.icon, node_label(nd.data.desc, record), nd.data.desc.topic_name, false, record.id);
 		}
 		updates.push({
 			id: nodes[i].id,