@yuneta/gobj-ui 7.23.185 → 7.23.186

package/dist/gobj-ui.cjs.js

@@ -30260,6 +30260,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 +58569,7 @@ var PRIVATE_DATA$4 = {
 	graph: null,
 	__graphs__: [],
 	_graph_properties: {},
+	_saved_graph_properties: {},
 	yet_showed: false,
 	edit_mode: false,
 	operation_mode: null,
@@ -60072,11 +60155,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 +60248,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__",

package/dist/gobj-ui.es.js

@@ -1,4 +1,4 @@
-import { SDATA, SDATA_END, clean_name, createElement2, createOneHtml, create_template_record, data_type_t, debounce, delete_from_list, duplicate_objects, empty_json, empty_string, escapeHtml, event_flag_t, flat_diff, gclass_create, gclass_find_by_name, gclass_flag_t, getPositionRelativeToBody, gobj_bottom_gobj, gobj_change_state, gobj_command, gobj_create, gobj_create_pure_child, gobj_create_service, gobj_current_state, gobj_destroy, gobj_find_child, gobj_find_service, gobj_full_name, gobj_gclass_name, gobj_get_gclass_trace_level2, gobj_global_trace_level, gobj_global_trace_no_level, gobj_is_destroying, gobj_is_playing, gobj_is_pure_child, gobj_is_running, gobj_is_service, gobj_is_volatil, gobj_match_children, gobj_name, gobj_parent, gobj_post_event, gobj_publish_event, gobj_read_attr, gobj_read_bool_attr, gobj_read_integer_attr, gobj_read_pointer_attr, gobj_read_str_attr, gobj_save_persistent_attrs, gobj_send_event, gobj_set_trace_machine_format, gobj_short_name, gobj_start, gobj_start_tree, gobj_stop, gobj_stop_children, gobj_subscribe_event, gobj_unsubscribe_event, gobj_write_attr, gobj_write_bool_attr, gobj_write_integer_attr, gobj_write_str_attr, gobj_yuno, gobj_yuno_name, is_array, is_boolean, is_date, is_gobj, is_null, is_number, is_object, is_string, json2flat, json_deep_copy, json_object_size, json_object_update, json_object_update_missing, json_size, kw_clone_by_keys, kw_flag_t, kw_get_dict, kw_get_dict_value, kw_get_int, kw_get_local_storage_value, kw_get_str, kw_has_key, kw_set_dict_value, kw_set_local_storage_value, kwid_find_one_record, kwid_new_dict, log_error, log_warning, msg_iev_get_stack, parseBoolean, parseSVG, refresh_language, safeSrc, sdata_flag_t, set_console_log_enabled, set_log_callback, sprintf, str_in_list, template_get_field_desc, trace_level_t, trace_msg, treedb_decoder_fkey, treedb_encoder_fkey, treedb_get_field_desc, treedb_hook_data_size } from "@yuneta/gobj-js";
+import { SDATA, SDATA_END, clean_name, createElement2, createOneHtml, create_template_record, data_type_t, debounce, delete_from_list, duplicate_objects, empty_json, empty_string, escapeHtml, event_flag_t, flat_diff, gclass_create, gclass_find_by_name, gclass_flag_t, getPositionRelativeToBody, gobj_bottom_gobj, gobj_change_state, gobj_command, gobj_create, gobj_create_pure_child, gobj_create_service, gobj_current_state, gobj_destroy, gobj_find_child, gobj_find_service, gobj_full_name, gobj_gclass_name, gobj_get_gclass_trace_level2, gobj_global_trace_level, gobj_global_trace_no_level, gobj_is_destroying, gobj_is_playing, gobj_is_pure_child, gobj_is_running, gobj_is_service, gobj_is_volatil, gobj_match_children, gobj_name, gobj_parent, gobj_post_event, gobj_publish_event, gobj_read_attr, gobj_read_bool_attr, gobj_read_integer_attr, gobj_read_pointer_attr, gobj_read_str_attr, gobj_save_persistent_attrs, gobj_send_event, gobj_set_trace_machine_format, gobj_short_name, gobj_start, gobj_start_tree, gobj_stop, gobj_stop_children, gobj_subscribe_event, gobj_unsubscribe_event, gobj_write_attr, gobj_write_bool_attr, gobj_write_integer_attr, gobj_write_str_attr, gobj_yuno, gobj_yuno_name, is_array, is_boolean, is_date, is_gobj, is_null, is_number, is_object, is_string, json2flat, json_deep_copy, json_is_identical, json_object_size, json_object_update, json_object_update_missing, json_size, kw_clone_by_keys, kw_flag_t, kw_get_dict, kw_get_dict_value, kw_get_int, kw_get_local_storage_value, kw_get_str, kw_has_key, kw_set_dict_value, kw_set_local_storage_value, kwid_find_one_record, kwid_new_dict, log_error, log_warning, msg_iev_get_stack, parseBoolean, parseSVG, refresh_language, safeSrc, sdata_flag_t, set_console_log_enabled, set_log_callback, sprintf, str_in_list, template_get_field_desc, trace_level_t, trace_msg, treedb_decoder_fkey, treedb_encoder_fkey, treedb_get_field_desc, treedb_hook_data_size } from "@yuneta/gobj-js";
 import i18next, { t } from "i18next";
 import TomSelect from "tom-select";
 import { createJSONEditor } from "vanilla-jsoneditor";
@@ -30255,6 +30255,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 (!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 !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 (!is_object(live)) return plan;
+	let have = 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
@@ -58482,6 +58564,7 @@ var PRIVATE_DATA$4 = {
 	graph: null,
 	__graphs__: [],
 	_graph_properties: {},
+	_saved_graph_properties: {},
 	yet_showed: false,
 	edit_mode: false,
 	operation_mode: null,
@@ -60067,11 +60150,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 (is_object(props)) priv._graph_properties[rec.topic] = props;
+		if (is_object(props)) {
+			priv._graph_properties[rec.topic] = props;
+			priv._saved_graph_properties[rec.topic] = json_deep_copy(props);
+		}
 	}
 }
 /************************************************************
@@ -60156,35 +60243,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 = gobj_read_str_attr(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
-			}
-		};
-		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__ = gobj_read_str_attr(gobj_yuno(), "node_uuid");
+	priv._saved_graph_properties[topic_name] = json_deep_copy(properties);
 	let kw_update = {
 		treedb_name: priv.treedb_name,
 		topic_name: "__graphs__",

package/package.json

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

package/src/c_g6_nodes_tree.js

@@ -77,6 +77,7 @@ import {
     kw_get_dict_value,
     kw_set_dict_value,
     kw_clone_by_keys,
+    json_deep_copy,
     json_object_update,
     json_object_update_missing,
     json_object_size,
@@ -91,6 +92,11 @@ import {
     safeSrc,
 } from "@yuneta/gobj-js";
 
+import {
+    plan_graph_saves,
+    topic_arrangement_changed,
+} from "./graph_save_plan.js";
+
 import {
     addClasses,
     removeClasses,
@@ -483,6 +489,7 @@ let PRIVATE_DATA = {
     graph:              null,       // Instance of G6
     __graphs__:         [],         // Rows of __graphs__
     _graph_properties:  {},         // topic_name → {nodes: {node_id: {x,y,size,...}}}
+    _saved_graph_properties: {},    // the same, as the BACKEND has it: what a Save compares against
     yet_showed:         false,
     edit_mode:          false,
     operation_mode:     null,
@@ -3051,6 +3058,7 @@ 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];
@@ -3060,6 +3068,11 @@ function build_graph_properties(gobj)
         let props = rec.properties;
         if(is_object(props)) {
             priv._graph_properties[rec.topic] = props;
+            /*  A COPY: the line above hands the record's own object to
+             *  the view, which then arranges it in place, so anything
+             *  kept by reference would change with it and a Save would
+             *  never find a difference.  */
+            priv._saved_graph_properties[rec.topic] = json_deep_copy(props);
         }
     }
 }
@@ -3205,34 +3218,30 @@ function save_geometry(gobj)
         update_edge_geometry(gobj, edges[i].id);
     }
 
-    // Save one __graphs__ record per topic
-    let origin = gobj_read_str_attr(gobj_yuno(), "node_uuid");
-
-    for(const [topic_name, properties] of Object.entries(priv._graph_properties)) {
-        // Add origin metadata
-        properties.__origin__ = origin;
-
-        let kw_update = {
-            treedb_name: priv.treedb_name,
-            topic_name: "__graphs__",
-            record: {
-                id: topic_name,
-                topic: topic_name,
-                active: true,
-                properties: properties
-            },
-            options: {
-                list_dict: true,
-                autolink: false,
-                create: true    // Create if doesn't exist, update if it does
-            }
-        };
-        gobj_publish_event(gobj, "EV_UPDATE_NODE", kw_update);
+    /*  One __graphs__ record per topic that CHANGED, and nothing for
+     *  the rest. The Save button says that something happened, never
+     *  what: it lights from `history.canUndo()` for the moves G6
+     *  records and from mark_graph_dirty() for everything it does not
+     *  (a colour, a pill, a per-topic default). So the topics are
+     *  chosen by comparing what the view holds against what the
+     *  backend has -- which sees both kinds of change, and goes on
+     *  working after an undo, a redo, or the history.clear() that
+     *  ac_save_graph() does one line before calling this.
+     *
+     *  The store is append-only: a topic written with the content it
+     *  already had is a record that says nothing, for ever. Moving one
+     *  card of a five-topic treedb used to append five.  */
+    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)
 {
@@ -3242,9 +3251,30 @@ function save_topic_graph_properties(gobj, topic_name)
         return;
     }
 
+    /*  A record that says what the record under it says is a record
+     *  that will be read for ever and mean nothing -- the store is
+     *  append-only. It reached here by two doors: the Save, which
+     *  wrote every topic the view had loaded, and the delete of a
+     *  node that carried no geometry of its own.  */
+    if(!topic_arrangement_changed(properties, priv._saved_graph_properties[topic_name])) {
+        return;
+    }
+
     let origin = gobj_read_str_attr(gobj_yuno(), "node_uuid");
     properties.__origin__ = origin;
 
+    /*  What the backend will hold once this is written. Taken BEFORE
+     *  the publish and as a copy, because the object below travels by
+     *  reference and goes on being arranged after the write.
+     *
+     *  Nothing answers an `EV_UPDATE_NODE` of `__graphs__` -- the view
+     *  writes that topic itself and is deliberately not told about it
+     *  (see the EV_RECORD_WRITTEN of C_YUI_TREEDB_GRAPH) -- so this is
+     *  the write taken for granted. A refused one leaves the view
+     *  believing the backend holds an arrangement it does not, until
+     *  the next load reads the records again.  */
+    priv._saved_graph_properties[topic_name] = json_deep_copy(properties);
+
     let kw_update = {
         treedb_name: priv.treedb_name,
         topic_name: "__graphs__",

package/src/graph_save_plan.js

@@ -0,0 +1,108 @@
+/***********************************************************************
+ *          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.
+ ***********************************************************************/
+import {
+    is_object,
+    json_is_identical,
+} from "@yuneta/gobj-js";
+
+/***************************************************************
+ *  The properties as they are worth comparing: everything
+ *  except who wrote them.
+ ***************************************************************/
+function arrangement_of(properties)
+{
+    if(!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 !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(!is_object(live)) {
+        return plan;
+    }
+    let have = 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;
+}
+
+export {
+    plan_graph_saves,
+    topic_arrangement_changed,
+    arrangement_of,
+};

package/src/graph_save_plan.test.js

@@ -0,0 +1,146 @@
+/***********************************************************************
+ *          graph_save_plan.test.js
+ *
+ *      A Save of the graph writes the topics that CHANGED.
+ *
+ *      Measured before this existed, on a live agent treedb: one node
+ *      of `public_services` dragged, Save pressed, and the store took
+ *      five `__graphs__` records -- one per topic the view had loaded
+ *      -- of which four were identical, byte for byte, to the records
+ *      under them. An append-only store keeps them for ever.
+ *
+ *      The cases below are the ones that decide whether a topic is
+ *      written, and two of them are the reason this is a module of its
+ *      own rather than three lines inside the Save.
+ *
+ *          Copyright (c) 2026, ArtGins.
+ *          All Rights Reserved.
+ ***********************************************************************/
+import {describe, test, expect} from "vitest";
+import {
+    plan_graph_saves, topic_arrangement_changed, arrangement_of
+} from "./graph_save_plan.js";
+
+const ORIGIN = "f3163a9f-1f37-412a-b8c9-87a4341f14de";
+
+function layout(nodes, extra)
+{
+    return Object.assign({nodes: nodes, __origin__: ORIGIN}, extra || {});
+}
+
+/*  The shape of the real case: five topics, one card moved.  */
+function five_topics()
+{
+    return {
+        realms:          layout({"artgins.utilities.all": {x: 398, y: 605}}),
+        yunos:           layout({"1": {x: 130, y: 815}, "2": {x: 398, y: 815}}),
+        binaries:        layout({emailsender: {x: 197, y: 985}}),
+        configurations:  layout({"emailsender.artgins": {x: 63, y: 985}}),
+        public_services: layout({"1": {x: 993.7299656271935, y: 1119.9412968754768}}),
+    };
+}
+
+describe("plan_graph_saves", () => {
+    test("nothing moved, nothing is written", () => {
+        const live = five_topics();
+        const saved = five_topics();
+        expect(plan_graph_saves(live, saved)).toEqual([]);
+    });
+
+    test("one card moved writes ONE topic, not five", () => {
+        const live = five_topics();
+        const saved = five_topics();
+        live.public_services.nodes["1"].x = 811.7299656271935;
+        live.public_services.nodes["1"].y = 1167.9412968754768;
+        expect(plan_graph_saves(live, saved)).toEqual(["public_services"]);
+    });
+
+    test("a topic the backend has never seen is written", () => {
+        const live = five_topics();
+        const saved = five_topics();
+        delete saved.binaries;
+        expect(plan_graph_saves(live, saved)).toEqual(["binaries"]);
+    });
+
+    test("...unless it holds nothing: an empty arrangement is not a layout", () => {
+        const live = five_topics();
+        const saved = five_topics();
+        delete saved.binaries;
+        live.binaries = {};
+        expect(plan_graph_saves(live, saved)).toEqual([]);
+    });
+
+    test("no saved side at all is the first Save: every topic with content", () => {
+        expect(plan_graph_saves(five_topics(), {})).toEqual(
+            ["realms", "yunos", "binaries", "configurations", "public_services"]
+        );
+    });
+
+    test("a different __origin__ is not a change", () => {
+        const live = five_topics();
+        const saved = five_topics();
+        live.yunos.__origin__ = "another-browser-entirely";
+        expect(plan_graph_saves(live, saved)).toEqual([]);
+    });
+
+    test("the order the keys were built in is not a change", () => {
+        const saved = {yunos: {nodes: {a: {x: 1, y: 2}}, __origin__: ORIGIN}};
+        const live = {yunos: {__origin__: ORIGIN, nodes: {a: {y: 2, x: 1}}}};
+        expect(plan_graph_saves(live, saved)).toEqual([]);
+    });
+
+    test("a node that lost its entry is a change", () => {
+        const live = five_topics();
+        const saved = five_topics();
+        delete live.yunos.nodes["2"];
+        expect(plan_graph_saves(live, saved)).toEqual(["yunos"]);
+    });
+
+    test("what is not a position counts too: defaults and edges", () => {
+        const live = five_topics();
+        const saved = five_topics();
+        live.realms.defaults = {fill: "#123456"};
+        live.binaries.edges = {"binaries^a|yunos": {lineWidth: 3}};
+        expect(plan_graph_saves(live, saved)).toEqual(["realms", "binaries"]);
+    });
+
+    test("a size added to a card is a change", () => {
+        const live = five_topics();
+        const saved = five_topics();
+        live.binaries.nodes.emailsender.size = [260, 120];
+        expect(plan_graph_saves(live, saved)).toEqual(["binaries"]);
+    });
+
+    test("it answers a plan, never undefined", () => {
+        expect(plan_graph_saves(null, null)).toEqual([]);
+        expect(plan_graph_saves(undefined, five_topics())).toEqual([]);
+    });
+});
+
+describe("topic_arrangement_changed", () => {
+    test("no saved record and content: TRUE", () => {
+        expect(topic_arrangement_changed(layout({a: {x: 1, y: 1}}), undefined)).toBe(true);
+    });
+
+    test("no saved record and nothing to say: FALSE", () => {
+        expect(topic_arrangement_changed({}, undefined)).toBe(false);
+        expect(topic_arrangement_changed({__origin__: ORIGIN}, undefined)).toBe(false);
+    });
+
+    test("the same arrangement: FALSE", () => {
+        const props = layout({a: {x: 1, y: 1}});
+        expect(topic_arrangement_changed(props, props)).toBe(false);
+    });
+});
+
+describe("arrangement_of", () => {
+    test("drops who wrote it and keeps the rest", () => {
+        expect(arrangement_of(layout({a: {x: 1, y: 1}}, {defaults: {fill: "#fff"}})))
+            .toEqual({nodes: {a: {x: 1, y: 1}}, defaults: {fill: "#fff"}});
+    });
+
+    test("anything that is not an object holds no arrangement", () => {
+        expect(arrangement_of(null)).toEqual({});
+        expect(arrangement_of("nodes")).toEqual({});
+    });
+});