@yuneta/gobj-ui 5.14.2 → 5.16.0

package/dist/gobj-ui.es.js

@@ -14399,6 +14399,7 @@ var attrs_table$5 = [
 	SDATA(data_type_t.DTP_BOOLEAN, "system", 0, false, "Manage system topics (true) or user topics (false)"),
 	SDATA(data_type_t.DTP_STRING, "tabs_style", 0, "is-toggle is-fullwidth", "Bulma tab styling"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_cards_landing", 0, false, "Land on a grid of topic cards (list->detail): a card opens its table, with the tabs bar + a back-to-grid button. Off = tabs only (legacy)."),
+	SDATA(data_type_t.DTP_BOOLEAN, "readonly", 0, false, "The whole treedb is read-only: every topic opens without its write affordances and the write events are refused. 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_JSON, "card_action_routes", 0, null, "Per-card hash-route templates {info, table, graph} with a {topic} placeholder (host-supplied, route-agnostic). Present ⇒ cards show 3 icon actions; absent ⇒ a single card that opens the table."),
 	SDATA(data_type_t.DTP_JSON, "landing_routes", 0, null, "Host-supplied hashes for the two landing sub-views {cards, schema}; the toggle navigates to them so the landing is URL-addressable (ROUTING.md). Absent ⇒ toggle flips in-view only (legacy)."),
 	SDATA(data_type_t.DTP_STRING, "base_route", 0, "", "This view's base route (host-supplied); used to declare its sub-routes (topics / info / schema) to the site map (ROUTING.md contributor)."),
@@ -15179,12 +15180,14 @@ function process_treedb_descs$1(gobj) {
 	let descs = gobj_read_attr(gobj, "descs");
 	let system = gobj_read_bool_attr(gobj, "system");
 	let treedb_name = gobj_read_str_attr(gobj, "treedb_name");
+	let readonly = gobj_read_bool_attr(gobj, "readonly");
 	for (const [key, desc] of Object.entries(descs)) {
 		if (system) {} else if (key.substring(0, 2) === "__") continue;
 		let kw_topic_form = {
 			subscriber: gobj,
-			with_new_button: true,
-			with_delete_button: true,
+			readonly,
+			with_new_button: !readonly,
+			with_delete_button: !readonly,
 			treedb_name,
 			topic_name: key,
 			desc
@@ -15489,6 +15492,19 @@ function request_print_tranger$1(gobj, path) {
 	}, gobj);
 	if (ret) log_error(ret);
 }
+/***************************************************************
+*  The last gate before a write leaves for the yuno. The per-topic
+*  children already hide their write buttons when the treedb is
+*  read-only, but the record events converge HERE, and this is the
+*  gclass that owns the treedb: a write that got this far on a replica
+*  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$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;
+}
 /***************************
 *      Actions
 ***************************/
@@ -15556,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;
@@ -15761,6 +15778,7 @@ function ac_treedb_node_deleted$1(gobj, event, kw, src) {
 *  }
 ********************************************/
 function ac_create_record(gobj, event, kw, src) {
+	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;
@@ -15778,6 +15796,7 @@ function ac_create_record(gobj, event, kw, src) {
 *  }
 ********************************************/
 function ac_update_record(gobj, event, kw, src) {
+	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;
@@ -15794,6 +15813,7 @@ function ac_update_record(gobj, event, kw, src) {
 *  }
 ********************************************/
 function ac_delete_record(gobj, event, kw, src) {
+	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;
@@ -16081,6 +16101,68 @@ function yui_tabulator_relocalize(table, t) {
 	}
 }
 //#endregion
+//#region src/treedb_write_plan.js
+/***********************************************************************
+*          treedb_write_plan.js
+*
+*      Which write affordances a treedb topic offers.
+*
+*      Pure, so it can be tested without a DOM: the gclass turns the
+*      plan into buttons and columns, this decides the plan. Same split
+*      as form_toolbar_plan.js.
+*
+*      The rule it exists to state ONCE: `readonly` is not one more
+*      button flag, it is the STATE of the topic and it wins over all of
+*      them. A treedb whose tranger this yuno does not master answers
+*      every write with "READ-ONLY" (the yuno refuses since SDK 7.13.0),
+*      so offering the buttons anyway only turns a fact into an error
+*      message per click. Written as `!readonly && with_x` in five
+*      places it is five places to forget the sixth.
+*
+*          Copyright (c) 2026, ArtGins.
+*          All Rights Reserved.
+***********************************************************************/
+var READONLY_FORM_TOOLBAR = ["copy"];
+/***************************************************************
+*  plan_treedb_writes(flags) -> plan
+*
+*      flags   {readonly, with_edition_mode, with_new_button,
+*               with_delete_button, with_paste_button,
+*               with_in_row_edit_icons}
+*              Every with_* defaults to TRUE when absent, which is
+*              what the gclass attrs default to: a caller that sets
+*              nothing gets the toolbar this view always had.
+*
+*      plan    the same names without the `with_` prefix, plus
+*              `form_toolbar`: the list to hand C_YUI_FORM, or null
+*              to leave the form's own default alone.
+***************************************************************/
+function plan_treedb_writes(flags) {
+	let f = flags || {};
+	let readonly = !!f.readonly;
+	let want = (name) => {
+		return f[name] === void 0 ? true : !!f[name];
+	};
+	if (readonly) return {
+		readonly: true,
+		edition_mode: false,
+		new_button: false,
+		delete_button: false,
+		paste_button: false,
+		in_row_icons: false,
+		form_toolbar: READONLY_FORM_TOOLBAR.slice()
+	};
+	return {
+		readonly: false,
+		edition_mode: want("with_edition_mode"),
+		new_button: want("with_new_button"),
+		delete_button: want("with_delete_button"),
+		paste_button: want("with_paste_button"),
+		in_row_icons: want("with_in_row_edit_icons"),
+		form_toolbar: null
+	};
+}
+//#endregion
 //#region src/c_yui_treedb_topic_with_form.js
 /***********************************************************************
 *          c_yui_treedb_topic_with_form.js
@@ -16102,6 +16184,7 @@ var attrs_table$4 = [
 	SDATA(data_type_t.DTP_STRING, "treedb_name", 0, null, "Remote service treedb name"),
 	SDATA(data_type_t.DTP_STRING, "topic_name", 0, null, "Topic name"),
 	SDATA(data_type_t.DTP_POINTER, "desc", 0, null, "Description of topics"),
+	SDATA(data_type_t.DTP_BOOLEAN, "readonly", 0, false, "The topic cannot be written: no edition mode, no new/delete/paste, no in-row icons, and the record form opens without its save toolbar. Set it when the treedb is not the master of its tranger (only the master can write; the yuno refuses otherwise), or when the user lacks the authz"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_edition_mode", 0, true, "Enable EDITION mode showing EDIT Button toolbar"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_new_button", 0, true, "Button toolbar NEW"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_delete_button", 0, true, "Button toolbar DELETE"),
@@ -16264,11 +16347,12 @@ async function readClipboard(gobj) {
 function build_ui$4(gobj) {
 	function create_table_toolbar() {
 		let $table_toolbar = [];
-		let with_edition_mode = gobj_read_bool_attr(gobj, "with_edition_mode");
-		let with_new_button = gobj_read_bool_attr(gobj, "with_new_button");
-		let with_delete_button = gobj_read_bool_attr(gobj, "with_delete_button");
+		let plan = write_plan(gobj);
+		let with_edition_mode = plan.edition_mode;
+		let with_new_button = plan.new_button;
+		let with_delete_button = plan.delete_button;
 		let with_copy_button = gobj_read_bool_attr(gobj, "with_copy_button");
-		let with_paste_button = gobj_read_bool_attr(gobj, "with_paste_button");
+		let with_paste_button = plan.paste_button;
 		let toolbar_id = gobj_read_str_attr(gobj, "toolbar_id");
 		if (with_edition_mode) {
 			$table_toolbar = createElement2(["div", {
@@ -16711,7 +16795,7 @@ function create_tabulator(gobj) {
 			"</button>"
 		].join("");
 	}
-	if (gobj_read_bool_attr(gobj, "with_in_row_edit_icons")) columns.push({
+	if (write_plan(gobj).in_row_icons) columns.push({
 		field: "_operation",
 		title: "Op",
 		hozAlign: "center",
@@ -16990,15 +17074,17 @@ function open_form_dialog(gobj, mode, record) {
 		},
 		[]
 	]);
+	let form_plan = write_plan(gobj);
 	let form = gobj_create_pure_child("form_" + clean_name(gobj_name(gobj)), "C_YUI_FORM", {
 		template: build_form_template(gobj),
 		record,
 		fkey_options: build_fkey_options(gobj),
 		form_mode: mode,
+		...form_plan.form_toolbar ? { toolbar: form_plan.form_toolbar } : {},
 		render_mode: "edit",
 		pkey: desc.pkey || "id",
 		topic_name,
-		editable: true,
+		editable: !form_plan.readonly,
 		$parent: $body
 	}, gobj);
 	priv.form = form;
@@ -17525,6 +17611,34 @@ function show_dropdown_popup_menu(gobj, x, y, items, callback) {
 	let $with_focus = $element.querySelector(".with-focus");
 	if ($with_focus) $with_focus.focus();
 }
+/***************************************************************
+*  A read-only topic refuses the write EVENTS too, not only their
+*  buttons. The buttons are gone, but an event can still arrive: a
+*  keyboard path, a hosted form that outlived the flag, a caller that
+*  sends EV_SAVE_RECORD itself. Refusing here is what makes `readonly`
+*  a state of the gclass rather than a way of drawing it -- and it
+*  fails LOUDLY, because an ignored write is how the backend used to
+*  behave and what this whole change exists to stop.
+***************************************************************/
+function write_plan(gobj) {
+	return plan_treedb_writes({
+		readonly: gobj_read_bool_attr(gobj, "readonly"),
+		with_edition_mode: gobj_read_bool_attr(gobj, "with_edition_mode"),
+		with_new_button: gobj_read_bool_attr(gobj, "with_new_button"),
+		with_delete_button: gobj_read_bool_attr(gobj, "with_delete_button"),
+		with_paste_button: gobj_read_bool_attr(gobj, "with_paste_button"),
+		with_in_row_edit_icons: gobj_read_bool_attr(gobj, "with_in_row_edit_icons")
+	});
+}
+/***************************************************************
+*  A read-only topic refuses the write EVENTS too, not only their
+*  buttons.
+***************************************************************/
+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;
+}
 /***************************
 *      Actions
 ***************************/
@@ -17592,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;
 }
 /************************************************************
@@ -17617,6 +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$1(gobj, event)) return -1;
 	let tabulator = gobj_read_attr(gobj, "tabulator");
 	let editable = gobj_read_bool_attr(gobj, "editable");
 	editable = !editable;
@@ -17660,6 +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$1(gobj, event)) return -1;
 	let row = {};
 	let desc = gobj_read_attr(gobj, "desc");
 	for (let i = 0; i < desc.cols.length; i++) {
@@ -17689,6 +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$1(gobj, event)) return -1;
 	let tabulator = gobj_read_attr(gobj, "tabulator");
 	if (json_size(kw) === 0) {
 		let rows = tabulator.getSelectedData();
@@ -17752,6 +17872,7 @@ function ac_copy_rows(gobj, event, kw, src) {
 *  From internal
 ************************************************************/
 function ac_paste_rows(gobj, event, kw, src) {
+	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
@@ -17764,6 +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$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"),
@@ -18171,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"),
@@ -18221,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}`);
@@ -18375,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",
@@ -18413,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
@@ -18965,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
 ***************************/
@@ -19033,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;
@@ -19252,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 || {});
@@ -19267,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 || {});
@@ -19282,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 || {});
@@ -19297,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 || {});
@@ -19312,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 || {});
@@ -19352,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");
@@ -19573,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]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuneta/gobj-ui",
-  "version": "5.14.2",
+  "version": "5.16.0",
   "type": "module",
   "main": "dist/gobj-ui.cjs.js",
   "module": "dist/gobj-ui.es.js",

package/src/c_yui_treedb_graph.js

@@ -115,6 +115,7 @@ SDATA(data_type_t.DTP_POINTER,  "gobj_remote_yuno", 0,  null,   "Remote Yuno to
 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"),
@@ -193,6 +194,16 @@ function mt_create(gobj)
         log_error(`${gobj_name(gobj)} -> treedb_name not configured`);
     }
 
+    /*
+     *  `edition` is the ONLY mode that draws write affordances, and the
+     *  mode is a PERSISTED user preference: a graph that was left in
+     *  edition on a master would come back in edition on a replica.
+     *  Fall back to `reading` before the G6 child is born with it.
+     */
+    if(gobj_read_bool_attr(gobj, "readonly") && priv.operation_mode === "edition") {
+        gobj_write_str_attr(gobj, "operation_mode", "reading");
+    }
+
     /*
      *  set canvas_id, before build_ui()
      */
@@ -433,6 +444,11 @@ function make_toolbar(gobj)
      *      Top Header toolbar
      *---------------------------------------*/
     let modes = gobj_read_attr(gobj, "operation_modes");
+    if(gobj_read_bool_attr(gobj, "readonly")) {
+        /*  A mode the user cannot have is not offered: `edition` is the
+         *  one that draws the create / delete / link affordances.  */
+        modes = modes.filter(mode => mode !== "edition");
+    }
     let mode_options = modes.map(item => ['option', {}, item]);
 
     /*
@@ -1342,6 +1358,24 @@ function refresh_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;
+}
+
 
 
 
@@ -1468,7 +1502,36 @@ function ac_mt_command_answer(gobj, event, kw, src)
         case "delete-node":
         case "link-nodes":
         case "unlink-nodes":
-            // Don't process here, process on subscribed events.
+            /*
+             *  The graph redraws itself from the treedb's own EV_TREEDB_NODE_*
+             *  events, which arrive for EVERY writer. This says what those
+             *  cannot: THIS view has just written, and the yuno took it. A host
+             *  whose save is not finished with the record -- a schema editor,
+             *  where the yuno still has to be restarted to re-read the schema --
+             *  needs exactly that, and cannot use the node events without
+             *  answering its own writes in a loop.
+             *
+             *  Same event and same kw as C_YUI_TREEDB_TOPICS, plus `command`:
+             *  in a graph a LINK is as much a write as a record is, and the
+             *  three of them carry different halves of the kw.
+             *
+             *  `__graphs__` is EXCLUDED, and that exclusion is the point of
+             *  reading this comment: the view writes that topic ITSELF, one
+             *  record per topic, every time the layout is saved. It is this
+             *  view's bookkeeping, not the operator's data -- reporting it
+             *  would tell a schema editor that the schema changed because
+             *  somebody dragged a node.
+             */
+            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:     command
+                });
+            }
             break;
 
         default:
@@ -1787,6 +1850,11 @@ function ac_edge_clicked(gobj, event, kw, src)
 function ac_create_node(gobj, event, kw, src)
 {
     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;
@@ -1813,6 +1881,11 @@ function ac_create_node(gobj, event, kw, src)
 function ac_update_node(gobj, event, kw, src)
 {
     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;
@@ -1839,6 +1912,11 @@ function ac_update_node(gobj, event, kw, src)
 function ac_delete_node(gobj, event, kw, src)
 {
     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;
@@ -1865,6 +1943,11 @@ function ac_delete_node(gobj, event, kw, src)
 function ac_link_nodes(gobj, event, kw, src)
 {
     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;
@@ -1891,6 +1974,11 @@ function ac_link_nodes(gobj, event, kw, src)
 function ac_unlink_nodes(gobj, event, kw, src)
 {
     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;
@@ -2001,6 +2089,14 @@ function ac_set_operation_mode(gobj, event, kw, src)
     let priv = gobj.priv;
 
     let operation_mode = kw.operation_mode;
+    if(operation_mode === "edition" && gobj_read_bool_attr(gobj, "readonly")) {
+        /*  The select does not offer it on a replica, so getting here means
+         *  the event came from somewhere else -- and it is the mode that
+         *  turns on every write affordance.  */
+        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");
 
@@ -2168,6 +2264,8 @@ function create_gclass(gclass_name)
         ["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],