@yuneta/gobj-ui 7.23.185 → 7.23.187

package/dist/gobj-ui.cjs.js

@@ -23714,7 +23714,7 @@ function build_ui$6(gobj) {
 							[[
 								"span",
 								{ class: "icon" },
-								[yui_toolbar_icon("yi-hexagon-nodes")]
+								[yui_toolbar_icon("yi-compass-drafting")]
 							], [
 								"span",
 								{ i18n: "schema" },
@@ -23725,6 +23725,29 @@ function build_ui$6(gobj) {
 								(0, _yuneta_gobj_js.gobj_send_event)(gobj, "EV_TOGGLE_LANDING_VIEW", {}, gobj);
 							} }
 						],
+						[
+							"button",
+							{
+								class: "button TREEDB_SCHEMA_JSON_BTN is-hidden",
+								title: (0, i18next.t)("schema json"),
+								"aria-label": (0, i18next.t)("schema json"),
+								"data-i18n-title": "schema json",
+								"data-i18n-aria-label": "schema json"
+							},
+							[[
+								"span",
+								{ class: "icon" },
+								[yui_toolbar_icon("yi-code")]
+							], [
+								"span",
+								{ i18n: "schema json" },
+								"schema json"
+							]],
+							{ click: (evt) => {
+								evt.stopPropagation();
+								(0, _yuneta_gobj_js.gobj_send_event)(gobj, "EV_OPEN_SCHEMA_JSON", {}, gobj);
+							} }
+						],
 						[
 							"div",
 							{
@@ -24168,6 +24191,7 @@ function show_topics_landing(gobj) {
 	let $info = $container.querySelector(".TREEDB_TOPIC_INFO");
 	let $back = $container.querySelector(".TREEDB_TOPICS_BACK");
 	let $toggle = $container.querySelector(".TREEDB_LANDING_TOGGLE");
+	let $schema_json = $container.querySelector(".TREEDB_SCHEMA_JSON_BTN");
 	if ($tabs) $tabs.classList.add("is-hidden");
 	if ($sub) $sub.classList.add("is-hidden");
 	if ($info) $info.classList.add("is-hidden");
@@ -24177,6 +24201,7 @@ function show_topics_landing(gobj) {
 		$toggle.classList.remove("is-hidden");
 		$toggle.classList.toggle("is-primary", schema_mode);
 	}
+	if ($schema_json) $schema_json.classList.toggle("is-hidden", !schema_mode);
 	if (schema_mode) {
 		if ($landing) $landing.classList.add("is-hidden");
 		if ($schema) $schema.classList.remove("is-hidden");
@@ -24246,9 +24271,11 @@ function show_topic_detail(gobj) {
 	let $info = $container.querySelector(".TREEDB_TOPIC_INFO");
 	let $back = $container.querySelector(".TREEDB_TOPICS_BACK");
 	let $toggle = $container.querySelector(".TREEDB_LANDING_TOGGLE");
+	let $schema_json = $container.querySelector(".TREEDB_SCHEMA_JSON_BTN");
 	if ($landing) $landing.classList.add("is-hidden");
 	if ($schema) $schema.classList.add("is-hidden");
 	if ($info) $info.classList.add("is-hidden");
+	if ($schema_json) $schema_json.classList.add("is-hidden");
 	if ($toggle) $toggle.classList.add("is-hidden");
 	if ($tabs) $tabs.classList.remove("is-hidden");
 	if ($sub) $sub.classList.remove("is-hidden");
@@ -24289,8 +24316,10 @@ function show_topic_info(gobj, topic) {
 	let $schema = $container.querySelector(".TREEDB_TOPICS_SCHEMA");
 	let $back = $container.querySelector(".TREEDB_TOPICS_BACK");
 	let $toggle = $container.querySelector(".TREEDB_LANDING_TOGGLE");
+	let $schema_json = $container.querySelector(".TREEDB_SCHEMA_JSON_BTN");
 	if ($landing) $landing.classList.add("is-hidden");
 	if ($schema) $schema.classList.add("is-hidden");
+	if ($schema_json) $schema_json.classList.add("is-hidden");
 	if ($toggle) $toggle.classList.add("is-hidden");
 	if ($tabs) $tabs.classList.add("is-hidden");
 	if ($sub) $sub.classList.add("is-hidden");
@@ -24565,7 +24594,7 @@ function register_sub_routes$1(gobj) {
 	if ((0, _yuneta_gobj_js.is_object)((0, _yuneta_gobj_js.gobj_read_attr)(gobj, "landing_routes"))) nodes.push({
 		route: base + "/schema",
 		label: "schema",
-		icon: "yi-hexagon-nodes",
+		icon: "yi-compass-drafting",
 		gclass: "C_YUI_TREEDB_SCHEMA"
 	});
 	if ((0, _yuneta_gobj_js.is_object)(descs)) for (let topic of Object.keys(descs)) {
@@ -24708,10 +24737,11 @@ function is_mobile$2() {
 *  whole service (lazy drill). CHILD model: the viewer publishes
 *  EV_EXPAND_PATH to us.
 ************************************************************/
-function open_json_viewer$1(gobj) {
+function open_json_viewer$1(gobj, opts) {
 	let priv = gobj.priv;
+	let schema = !!(opts && opts.schema);
 	if (priv.json_win || priv.json_modal) {
-		request_print_tranger$1(gobj, "");
+		if (!schema) request_print_tranger$1(gobj, "");
 		return;
 	}
 	if (!(0, _yuneta_gobj_js.gclass_find_by_name)("C_YUI_JSON")) {
@@ -24721,7 +24751,10 @@ function open_json_viewer$1(gobj) {
 	}
 	let mobile = is_mobile$2();
 	let shell = yui_shell_of(gobj);
-	let jv = (0, _yuneta_gobj_js.gobj_create_service)(`treedb-topics-json-${(0, _yuneta_gobj_js.clean_name)((0, _yuneta_gobj_js.gobj_name)(gobj))}`, "C_YUI_JSON", { subscriber: gobj }, gobj);
+	let jv = (0, _yuneta_gobj_js.gobj_create_service)(`treedb-topics-json-${(0, _yuneta_gobj_js.clean_name)((0, _yuneta_gobj_js.gobj_name)(gobj))}`, "C_YUI_JSON", {
+		subscriber: gobj,
+		json_data: schema ? (0, _yuneta_gobj_js.gobj_read_attr)(gobj, "descs") : null
+	}, gobj);
 	if (!jv) {
 		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: cannot create the JSON viewer`);
 		return;
@@ -24739,7 +24772,7 @@ function open_json_viewer$1(gobj) {
 			dialog: true,
 			logical_class: "TREEDB_JSON_SHEET",
 			title_prefix: priv.treedb_name,
-			title: "raw json",
+			title: schema ? "schema json" : "raw json",
 			t: i18next.t,
 			on_close: () => {
 				if ((0, _yuneta_gobj_js.gobj_is_destroying)(gobj)) return;
@@ -24761,8 +24794,8 @@ function open_json_viewer$1(gobj) {
 			height: 620,
 			logical_class: "TREEDB_JSON_WINDOW",
 			title_prefix: priv.treedb_name,
-			title: "raw json",
-			icon: "yi-eye",
+			title: schema ? "schema json" : "raw json",
+			icon: schema ? "yi-code" : "yi-eye",
 			body: $box,
 			manager: null,
 			on_close: () => {
@@ -24777,7 +24810,7 @@ function open_json_viewer$1(gobj) {
 		}
 		(0, _yuneta_gobj_js.gobj_start)(priv.json_win);
 	}
-	request_print_tranger$1(gobj, "");
+	if (!schema) request_print_tranger$1(gobj, "");
 }
 /************************************************************
 *  Close the JSON viewer (user dismiss / teardown).
@@ -25371,6 +25404,19 @@ function ac_open_json$1(gobj, event, kw, src) {
 	return 0;
 }
 /********************************************
+*  The schema, as the json it is: the `descs` the schema graph is
+*  drawing. Same viewer and same host as the tranger's raw json --
+*  one at a time, so it closes whatever was open first.
+********************************************/
+function ac_open_schema_json(gobj, event, kw, src) {
+	if (!(0, _yuneta_gobj_js.is_object)((0, _yuneta_gobj_js.gobj_read_attr)(gobj, "descs"))) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: schema json with no descs`);
+		return -1;
+	}
+	open_json_viewer$1(gobj, { schema: true });
+	return 0;
+}
+/********************************************
 *  Open the graph where the reader left it: its last visited
 *  route under the graph's base -- `<graph>/<topic>` when a topic
 *  was focused there -- or the bare base when the graph was never
@@ -25504,6 +25550,11 @@ function create_gclass$6(gclass_name) {
 			ac_open_json$1,
 			null
 		],
+		[
+			"EV_OPEN_SCHEMA_JSON",
+			ac_open_schema_json,
+			null
+		],
 		[
 			"EV_OPEN_GRAPH",
 			ac_open_graph,
@@ -25576,6 +25627,7 @@ function create_gclass$6(gclass_name) {
 		["EV_RECORD_WRITTEN", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT | _yuneta_gobj_js.event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_REFRESH_TOPIC", 0],
 		["EV_OPEN_JSON", 0],
+		["EV_OPEN_SCHEMA_JSON", 0],
 		["EV_OPEN_GRAPH", 0],
 		["EV_EXPAND_PATH", 0],
 		["EV_JSON_CLOSED", 0],
@@ -30260,6 +30312,88 @@ function register_c_yui_treedb_topic_with_form() {
 	return create_gclass$5(GCLASS_NAME$5);
 }
 //#endregion
+//#region src/graph_save_plan.js
+/***********************************************************************
+*          graph_save_plan.js
+*
+*      Which topics a Save of the graph has to write, and which it
+*      must leave alone.
+*
+*      The arrangement of a treedb graph lives in `__graphs__`, ONE
+*      record per topic. The Save collected every topic the view had
+*      loaded and wrote all of them, whatever had moved: on a treedb
+*      of five topics, dragging one card appended five records, four
+*      of them saying exactly what the record under them said. The
+*      store is append-only, so those four are there for ever.
+*
+*      This module is the decision, and nothing else: no G6, no DOM,
+*      no gobj. Give it what the view is holding and what the backend
+*      already has, and it answers which topics differ.
+*
+*      Two things it deliberately does NOT do:
+*
+*      - It does not ask the history plugin. The Save button lights
+*        from two places -- `history.canUndo()` for what G6 records
+*        (a move, a resize) and `mark_graph_dirty()` for what it does
+*        not (a colour, a pill, a per-topic default) -- so the undo
+*        stack is not the list of what changed, and reading it as one
+*        would silently drop half the changes. A value comparison
+*        sees both, and keeps working through undo, redo and a
+*        history that was just cleared.
+*
+*      - It does not compare `__origin__`. That key is the node_uuid
+*        of whoever wrote the record, bookkeeping about the write and
+*        not about the arrangement; comparing it would make every
+*        topic differ the first time a second browser saved, and the
+*        record it forces would say nothing new.
+*
+*          Copyright (c) 2026, ArtGins.
+*          All Rights Reserved.
+***********************************************************************/
+/***************************************************************
+*  The properties as they are worth comparing: everything
+*  except who wrote them.
+***************************************************************/
+function arrangement_of(properties) {
+	if (!(0, _yuneta_gobj_js.is_object)(properties)) return {};
+	let out = {};
+	for (const [key, value] of Object.entries(properties)) {
+		if (key === "__origin__") continue;
+		out[key] = value;
+	}
+	return out;
+}
+/***************************************************************
+*  TRUE when the arrangement the view holds for `topic_name`
+*  is not the one the backend already has.
+*
+*  A topic with no saved record has never been written, so
+*  anything it holds is a change -- and an EMPTY arrangement
+*  is not: a topic the view loaded and nobody ever arranged
+*  has nothing to say, and saying it would create a record
+*  that means "no layout".
+***************************************************************/
+function topic_arrangement_changed(live, saved) {
+	let a = arrangement_of(live);
+	if (!saved) return Object.keys(a).length > 0;
+	return !(0, _yuneta_gobj_js.json_is_identical)(a, arrangement_of(saved));
+}
+/***************************************************************
+*  The topics a Save has to write.
+*
+*      live    {topic_name: properties}  what the view holds
+*      saved   {topic_name: properties}  what the backend has
+*
+*  Returns their names, in the order the view holds them.
+***************************************************************/
+function plan_graph_saves(live, saved) {
+	let plan = [];
+	if (!(0, _yuneta_gobj_js.is_object)(live)) return plan;
+	let have = (0, _yuneta_gobj_js.is_object)(saved) ? saved : {};
+	for (const [topic_name, properties] of Object.entries(live)) if (topic_arrangement_changed(properties, have[topic_name])) plan.push(topic_name);
+	return plan;
+}
+//#endregion
 //#region src/treedb_node_label.js
 /***********************************************************************
 *          treedb_node_label.js
@@ -58487,6 +58621,7 @@ var PRIVATE_DATA$4 = {
 	graph: null,
 	__graphs__: [],
 	_graph_properties: {},
+	_saved_graph_properties: {},
 	yet_showed: false,
 	edit_mode: false,
 	operation_mode: null,
@@ -58737,7 +58872,7 @@ function build_graph$1(gobj) {
 		container: priv.$container,
 		animation: false,
 		autoResize: false,
-		zoomRange: [.2, 4],
+		zoomRange: [.02, 4],
 		node: {
 			palette: {
 				type: "group",
@@ -59993,6 +60128,7 @@ function draw_link(gobj, child_topic, child_id, source_col, fkey, verbose) {
 		parent_topic,
 		parent_id,
 		hook_name,
+		child_topic,
 		child_id,
 		is_tree
 	});
@@ -60072,11 +60208,15 @@ function clear_link(gobj, child_topic, child_id, source_col, fkey, verbose) {
 function build_graph_properties(gobj) {
 	let priv = gobj.priv;
 	priv._graph_properties = {};
+	priv._saved_graph_properties = {};
 	for (let i = 0; i < priv.__graphs__.length; i++) {
 		let rec = priv.__graphs__[i];
 		if (!rec.active || !rec.topic) continue;
 		let props = rec.properties;
-		if ((0, _yuneta_gobj_js.is_object)(props)) priv._graph_properties[rec.topic] = props;
+		if ((0, _yuneta_gobj_js.is_object)(props)) {
+			priv._graph_properties[rec.topic] = props;
+			priv._saved_graph_properties[rec.topic] = (0, _yuneta_gobj_js.json_deep_copy)(props);
+		}
 	}
 }
 /************************************************************
@@ -60161,35 +60301,22 @@ function save_geometry(gobj) {
 	}
 	const edges = graph.getData().edges;
 	for (let i = 0; i < edges.length; i++) update_edge_geometry(gobj, edges[i].id);
-	let origin = (0, _yuneta_gobj_js.gobj_read_str_attr)((0, _yuneta_gobj_js.gobj_yuno)(), "node_uuid");
-	for (const [topic_name, properties] of Object.entries(priv._graph_properties)) {
-		properties.__origin__ = origin;
-		let kw_update = {
-			treedb_name: priv.treedb_name,
-			topic_name: "__graphs__",
-			record: {
-				id: topic_name,
-				topic: topic_name,
-				active: true,
-				properties
-			},
-			options: {
-				list_dict: true,
-				autolink: false,
-				create: true
-			}
-		};
-		(0, _yuneta_gobj_js.gobj_publish_event)(gobj, "EV_UPDATE_NODE", kw_update);
-	}
+	let plan = plan_graph_saves(priv._graph_properties, priv._saved_graph_properties);
+	for (let i = 0; i < plan.length; i++) save_topic_graph_properties(gobj, plan[i]);
 }
 /************************************************************
 *  Save __graphs__ properties for a single topic to backend.
+*
+*  The ONE door to `__graphs__`: a caller that knows a topic moved
+*  says so, and this decides whether the backend needs telling.
 ************************************************************/
 function save_topic_graph_properties(gobj, topic_name) {
 	let priv = gobj.priv;
 	let properties = priv._graph_properties[topic_name];
 	if (!properties) return;
+	if (!topic_arrangement_changed(properties, priv._saved_graph_properties[topic_name])) return;
 	properties.__origin__ = (0, _yuneta_gobj_js.gobj_read_str_attr)((0, _yuneta_gobj_js.gobj_yuno)(), "node_uuid");
+	priv._saved_graph_properties[topic_name] = (0, _yuneta_gobj_js.json_deep_copy)(properties);
 	let kw_update = {
 		treedb_name: priv.treedb_name,
 		topic_name: "__graphs__",
@@ -60508,7 +60635,7 @@ async function graph_fit_selection(gobj, ids) {
 	let bw = Math.max(1, maxx - minx);
 	let bh = Math.max(1, maxy - miny);
 	let zoom = Math.min(vw / bw, vh / bh);
-	let range = graph.getZoomRange() || [.2, 4];
+	let range = graph.getZoomRange() || [.02, 4];
 	zoom = Math.max(range[0], Math.min(range[1], zoom));
 	await graph.zoomTo(zoom);
 	await graph.focusElement(ids);
@@ -63245,16 +63372,14 @@ function refresh_html_nodes_theme(gobj, theme) {
 function refresh_default_edges_theme(gobj, theme) {
 	let graph = gobj.priv.graph;
 	if (!graph) return;
-	let dark = theme === "dark";
 	let edges = graph.getData().edges || [];
 	let updates = [];
 	for (let i = 0; i < edges.length; i++) {
 		let d = edges[i].data || {};
 		if (!d.themed_default) continue;
-		let stroke = d.is_tree ? dark ? "#22a7c2" : "#0e7490" : dark ? "#8b94a3" : "#6b7280";
 		updates.push({
 			id: edges[i].id,
-			style: { stroke }
+			style: { stroke: default_edge_stroke(gobj, d, theme) }
 		});
 	}
 	if (updates.length > 0) graph.updateEdgeData(updates);
@@ -63826,21 +63951,54 @@ function apply_edge_properties(gobj, edge_id, lineWidth, stroke, scope) {
 	deselect_edge(gobj);
 }
 /************************************************************
+*  The colour a link is DRAWN in: the colour of the two knobs it
+*  joins.
+*
+*  Both ends of a link wear the CHILD topic's colour -- the
+*  parent's hook port is painted with the colour of whatever may
+*  hang there, and the child's fkey port with its own (see
+*  build_ports) -- so the line between them has one obvious
+*  colour, and a reader follows a link by its hue instead of
+*  tracing a grey thread across the canvas.
+*
+*  It goes through port_rim(): the FILL of a port says which
+*  topic, and a line on the canvas is a graphical object that
+*  needs 3:1 against it, which that mix clears in both themes
+*  (9.11 dark, 3.80 light) while keeping the hue. So a link is
+*  drawn in exactly the colour of the rim of the two knobs it
+*  ends on.
+*
+*  The containment/tree relation (parent and child of the same
+*  topic) is no longer marked by a teal of its own -- it is that
+*  topic's colour like any other link, and what still tells it
+*  apart is its WIDTH.
+*
+*  A topic with no colour, or an edge of a graph with no schema
+*  yet, keeps the neutral grey this used to give everything.
+************************************************************/
+function default_edge_stroke(gobj, d, theme) {
+	let priv = gobj.priv;
+	let desc = (0, _yuneta_gobj_js.is_object)(priv.descs) ? priv.descs[d.child_topic] : null;
+	if (desc && desc.color) return port_rim(desc.color, theme);
+	let dark = theme === "dark";
+	return d.is_tree ? dark ? "#22a7c2" : "#0e7490" : dark ? "#8b94a3" : "#6b7280";
+}
+/************************************************************
 *  The style an edge INHERITS, before anything saved for the
 *  edge itself: its hook's default in the parent topic, else the
 *  parent topic's default for every edge, else the library's.
 *
-*  The library's: neutral grey, teal for the containment/tree
-*  relation (parent and child of the same topic, a
-*  self-hierarchy). `themed_default` says the colour is still the
-*  library's, so a theme toggle re-themes it and leaves a chosen
-*  one alone.
+*  The library's: the colour of the ports it joins (see
+*  default_edge_stroke), and a wider line for the
+*  containment/tree relation. `themed_default` says the colour is
+*  still the library's, so a theme toggle re-themes it and leaves
+*  a chosen one alone.
 ************************************************************/
 function edge_inherited_style_of(gobj, d) {
-	let dark = gobj.priv.theme === "dark";
+	let priv = gobj.priv;
 	let style = {
 		lineWidth: d.is_tree ? 2 : 1.6,
-		stroke: d.is_tree ? dark ? "#22a7c2" : "#0e7490" : dark ? "#8b94a3" : "#6b7280",
+		stroke: default_edge_stroke(gobj, d, priv.theme),
 		themed_default: true
 	};
 	let defs = topic_defaults_of(gobj, d.parent_topic);
@@ -71661,7 +71819,7 @@ function render_toolbar(gobj) {
 	]);
 	let $right = [];
 	if (priv.treedb_id && has_model) {
-		$right.push(toolbar_button("SCHEMA_DIAGRAM_BTN", "yi-hexagon-nodes", priv.diagram ? "topics" : "diagram", "EV_TOGGLE_DIAGRAM", false));
+		$right.push(toolbar_button("SCHEMA_DIAGRAM_BTN", "yi-compass-drafting", priv.diagram ? "topics" : "diagram", "EV_TOGGLE_DIAGRAM", false));
 		$right.push(toolbar_button("SCHEMA_VALIDATE_BTN", "yi-square-check", "check", "EV_VALIDATE", false));
 		$right.push(toolbar_button("SCHEMA_EXPORT_BTN", "yi-download", "export", "EV_EXPORT", false));
 		if (!readonly) $right.push(toolbar_button("SCHEMA_IMPORT_BTN", "yi-upload", "import", "EV_IMPORT", false));