@yuneta/gobj-ui 7.23.103 → 7.23.105

package/README.md

@@ -947,6 +947,43 @@ Two things a host does not have to think about but a maintainer does:
 **New keys for consumers: `anchor view`, `click the element to centre on`,
 `centred: click to release`.**
 
+### The camera belongs to the reader
+
+Once somebody has chosen a zoom, nothing changes it but a camera command. Not a
+**refresh**, not a change of **node mode**, not a new **main topic**: those
+rebuild the CONTENT, and content moving is no reason to move the reader. The
+opening frame is the only one the graph picks — a fit, and only for a graph
+nobody has arranged.
+
+Two mechanisms, because the question is not the same in the two cases:
+
+- **Across a rebuild in the same view**, a NODE is held at the pixel it was on:
+  `yui_graph_viewport_of()` before, `yui_graph_place_at()` after — the pair the
+  folds have always used. It keeps the zoom because it only translates, and it
+  survives a relayout that moves everything, which restoring raw coordinates
+  would not.
+- **Across a RELOAD** the same thing is saved and replayed: the zoom, a NODE,
+  and the viewport pixel that node was on. **Not G6's own position** — an
+  absolute `translateTo()` leaves the camera at `canvasCentre - T/zoom`, so
+  `getPosition()` and `translateTo()` are each other's inverse only at zoom 1,
+  and restoring one with the other brings the zoom back and puts the graph
+  somewhere else. That is the whole reason `yui_graph_place_at()` exists.
+
+Wiring: `C_G6_NODES_TREE` takes a `camera` attr — the viewport to restore on its
+FIRST draw, empty meaning *open fitted* — and publishes **`EV_CAMERA_CHANGED
+{zoom, node, x, y}`** once a move has settled. A saved node this load does not
+have leaves the graph to its opening fit, checked before the zoom is touched:
+a zoom with no framing to go with it is worse than a fit. The settle is a real time (700 ms of
+the browser's `setTimeout`, not a `C_TIMER`): a wheel notch, a pinch and a drag
+each fire `aftertransform` many times, and what is worth saving is where the
+gesture ENDED. It fires for a PAN as well as a zoom — a pan is the reader's just
+as much. `C_YUI_TREEDB_GRAPH` holds the other half: `camera` is one more
+`SDF_PERSIST` attr of the view, saved under its name like `main_topic`, so the
+graph opens where that treedb was left.
+
+A host that does not care persists nothing and loses nothing: the event carries
+`EVF_NO_WARN_SUBS`, and the attr defaults to empty.
+
 ### Moving the cards, and folding without losing your place
 
 The JSON graph and the gobj tree take `drag-element`: a card can be dragged.

package/dist/gobj-ui.cjs.js

@@ -54825,6 +54825,7 @@ var attrs_table$4 = [
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "node_labels", 0, true, "A `shape` node says its name under the figure. Off, it is a coloured figure and nothing else"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "confirm_delete_node", 0, true, "Ask confirmation before deleting a node"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "confirm_unlink_edge", 0, true, "Ask confirmation before unlinking an edge"),
+	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_DICT, "camera", 0, "{}", "Where the reader left the viewport: {zoom, node, x, y} -- a NODE at a viewport pixel, not G6's own position, which does not restore. Empty = the graph opens fitted. Restored on the FIRST draw and published back as EV_CAMERA_CHANGED once a move settles, so a host can persist it"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_STRING, "wide", 0, "40px", "Height of header"),
 	(0, _yuneta_gobj_js.SDATA_END)()
 ];
@@ -54832,6 +54833,9 @@ var PRIVATE_DATA$4 = {
 	anchor_id: "",
 	anchor_state: "off",
 	last_zoom: 1,
+	_camera_placed: false,
+	_camera_restoring: false,
+	_camera_timer: null,
 	_xy: 100,
 	_edge_seq: 0,
 	_history_paused: false,
@@ -54963,8 +54967,13 @@ function mt_start$4(gobj) {
 *          Framework Method: Stop
 ***************************************************************/
 function mt_stop$4(gobj) {
+	let priv = gobj.priv;
 	let shell = yui_shell_of(gobj);
 	if (shell) (0, _yuneta_gobj_js.gobj_unsubscribe_event)(shell, "EV_LANGUAGE_CHANGED", {}, gobj);
+	if (priv._camera_timer) {
+		clearTimeout(priv._camera_timer);
+		priv._camera_timer = null;
+	}
 	return 0;
 }
 /***************************************************************
@@ -55156,6 +55165,7 @@ function configure_events(gobj) {
 		update_link_icon_position(gobj);
 		update_port_icon_position(gobj);
 		update_zoom_readout(gobj);
+		publish_camera_later(gobj);
 		let z = priv.last_zoom;
 		try {
 			z = priv.graph.getZoom();
@@ -56681,6 +56691,83 @@ async function graph_fitview(gobj) {
 }
 var MIN_READABLE_ZOOM = .5;
 /************************************************************
+*  THE CAMERA IS THE READER'S.
+*
+*  Once somebody has chosen a zoom, nothing but a camera
+*  command may change it -- not a refresh, not a change of node
+*  mode, not a new main topic. Those rebuild the CONTENT, and
+*  the content moving is no reason to move the reader.
+*
+*  Two mechanisms, because they answer two different questions:
+*
+*    - across a rebuild in the same view, the anchor pair
+*      (`yui_graph_viewport_of` / `yui_graph_place_at`) keeps a
+*      NODE at the pixel it was on, which survives a relayout
+*      that moves everything;
+*    - across a RELOAD there is no node to hold on to yet, so
+*      the viewport itself is restored -- zoom and position, as
+*      G6 reports them.
+************************************************************/
+var CAMERA_SETTLE_MS = 700;
+function read_camera(gobj) {
+	let graph = gobj.priv.graph;
+	if (!graph || typeof graph.getZoom !== "function") return null;
+	try {
+		let z = graph.getZoom();
+		let node = fold_keep_node(gobj);
+		let vp = node ? yui_graph_viewport_of(graph, node) : null;
+		if (!(0, _yuneta_gobj_js.is_number)(z) || !node || !vp || !(0, _yuneta_gobj_js.is_number)(vp[0]) || !(0, _yuneta_gobj_js.is_number)(vp[1])) return null;
+		return {
+			zoom: z,
+			node,
+			x: vp[0],
+			y: vp[1]
+		};
+	} catch (e) {
+		return null;
+	}
+}
+async function restore_camera(gobj) {
+	let priv = gobj.priv;
+	let graph = priv.graph;
+	let cam = (0, _yuneta_gobj_js.gobj_read_attr)(gobj, "camera");
+	if (!graph || (0, _yuneta_gobj_js.empty_json)(cam) || !(0, _yuneta_gobj_js.is_number)(cam.zoom) || !cam.node || !(0, _yuneta_gobj_js.is_number)(cam.x) || !(0, _yuneta_gobj_js.is_number)(cam.y)) return false;
+	if (!yui_graph_viewport_of(graph, cam.node)) return false;
+	priv._camera_restoring = true;
+	try {
+		await graph.zoomTo(cam.zoom);
+		await yui_graph_place_at(graph, cam.node, [cam.x, cam.y]);
+		return true;
+	} catch (e) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: cannot restore the camera: ${e}`);
+		return false;
+	} finally {
+		priv._camera_restoring = false;
+	}
+}
+/************************************************************
+*  A move settled: tell whoever persists it.
+*
+*  Debounced on a REAL time and with the browser's timer: a
+*  wheel notch, a pinch and a drag each fire `aftertransform`
+*  many times, and what is worth saving is where the gesture
+*  ENDED. (`set_timeout` from gobj-js is a C_TIMER and shadows
+*  the global -- this module imports neither.)
+************************************************************/
+function publish_camera_later(gobj) {
+	let priv = gobj.priv;
+	if (priv._camera_restoring || !priv._camera_placed) return;
+	if (priv._camera_timer) clearTimeout(priv._camera_timer);
+	priv._camera_timer = setTimeout(() => {
+		priv._camera_timer = null;
+		if ((0, _yuneta_gobj_js.gobj_is_destroying)(gobj)) return;
+		let cam = read_camera(gobj);
+		if (!cam) return;
+		(0, _yuneta_gobj_js.gobj_write_attr)(gobj, "camera", cam);
+		(0, _yuneta_gobj_js.gobj_publish_event)(gobj, "EV_CAMERA_CHANGED", cam);
+	}, CAMERA_SETTLE_MS);
+}
+/************************************************************
 *  Fit the graph in the viewport, but never zoom out past the point
 *  where nothing on a card can be read.
 *
@@ -60624,8 +60711,11 @@ async function reconcile_fold_apply(gobj, opts, visible) {
 	}
 	await graph_draw(gobj);
 	if (changed || opts.relayout) await graph_layout(gobj);
-	if (opts.fit) await graph_fit_readable(gobj);
-	else if (opts.keep && opts.keep_vp) await yui_graph_place_at(graph, opts.keep, opts.keep_vp);
+	if (!(opts.restore && await restore_camera(gobj))) {
+		if (opts.fit) await graph_fit_readable(gobj);
+		else if (opts.keep && opts.keep_vp) await yui_graph_place_at(graph, opts.keep, opts.keep_vp);
+	}
+	priv._camera_placed = true;
 	update_resize_handles_position(gobj);
 	update_port_resize_handles_position(gobj);
 	update_edge_icon_position(gobj);
@@ -60777,10 +60867,19 @@ function ac_load_data(gobj, event, kw, src) {
 			(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: auto_layout failed: ${e}`);
 		}
 		apply_layout_direction(gobj);
-		reconcile_fold(gobj, {
-			relayout: true,
+		let vp_opts;
+		if (!priv._camera_placed) vp_opts = {
+			restore: true,
 			fit: auto_laid
-		}).then(() => {
+		};
+		else {
+			let keep = fold_keep_node(gobj);
+			vp_opts = {
+				keep,
+				keep_vp: yui_graph_viewport_of(priv.graph, keep)
+			};
+		}
+		reconcile_fold(gobj, Object.assign({ relayout: true }, vp_opts)).then(() => {
 			sync_history_plugin(gobj);
 			if (priv._pending_focus_topic !== null) {
 				let ft = priv._pending_focus_topic;
@@ -61240,11 +61339,14 @@ function ac_set_main_topic(gobj, event, kw, src) {
 	let priv = gobj.priv;
 	(0, _yuneta_gobj_js.gobj_write_str_attr)(gobj, "main_topic", kw && kw.topic || "");
 	if (!priv._fold_model) return 0;
+	let keep = fold_keep_node(gobj);
+	let vp = yui_graph_viewport_of(priv.graph, keep);
 	rebuild_fold_model(gobj);
 	fold_expand_to_depth(priv._fold_model, priv._fold_state, (0, _yuneta_gobj_js.gobj_read_integer_attr)(gobj, "expand_depth"));
 	reconcile_fold(gobj, {
 		relayout: true,
-		fit: true
+		keep,
+		keep_vp: vp
 	});
 	return 0;
 }
@@ -61270,11 +61372,14 @@ function ac_set_node_mode$1(gobj, event, kw, src) {
 	(0, _yuneta_gobj_js.gobj_write_str_attr)(gobj, "node_mode", mode);
 	priv._open_nodes = /* @__PURE__ */ new Set();
 	if (!priv.graph || !priv._fold_model) return 0;
+	let keep = fold_keep_node(gobj);
+	let vp = yui_graph_viewport_of(priv.graph, keep);
 	reshape_nodes(gobj, all_record_node_ids(gobj));
 	reshape_more_chips(gobj);
 	reconcile_fold(gobj, {
 		relayout: true,
-		fit: true
+		keep,
+		keep_vp: vp
 	});
 	return 0;
 }
@@ -61944,6 +62049,7 @@ function create_gclass$4(gclass_name) {
 		["EV_FIND_NODES", 0],
 		["EV_FIND_RESULT", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_LAYOUT_AUTOSET", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT],
+		["EV_CAMERA_CHANGED", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT | _yuneta_gobj_js.event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_TOGGLE_FOLD", 0],
 		["EV_SHOW_MORE", 0],
 		["EV_EXPAND_ALL", 0],
@@ -62030,6 +62136,7 @@ var attrs_table$3 = [
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_LIST, "loose_topics", _yuneta_gobj_js.sdata_flag_t.SDF_PERSIST, "[]", "Topics whose LOOSE records (no parent) are shown. User preference, per treedb"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_STRING, "node_mode", _yuneta_gobj_js.sdata_flag_t.SDF_PERSIST, "expanded", "How the records are drawn: `expanded` = the cards with their pills and ports, `compact` = one-line pills with the name, `shape` = coloured figures, the topology alone. User preference"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_BOOLEAN, "node_labels", _yuneta_gobj_js.sdata_flag_t.SDF_PERSIST, true, "A `shape` node says its name under its figure. User preference"),
+	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_DICT, "camera", _yuneta_gobj_js.sdata_flag_t.SDF_PERSIST, "{}", "Where the reader left the viewport: {zoom, x, y}. Handed to the engine on creation and written back when a move settles, so the graph opens where it was left. User preference, per treedb"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_POINTER, "gobj_remote_yuno", 0, null, "Remote Yuno to request data"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_STRING, "treedb_name", 0, null, "Remote service treedb name"),
 	(0, _yuneta_gobj_js.SDATA)(_yuneta_gobj_js.data_type_t.DTP_DICT, "descs", 0, null, "Descriptions of topics obtained"),
@@ -62117,7 +62224,8 @@ function mt_create$3(gobj) {
 		main_topic: (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "main_topic") || "",
 		loose_topics: (0, _yuneta_gobj_js.gobj_read_attr)(gobj, "loose_topics") || [],
 		node_mode: (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "node_mode") || "expanded",
-		node_labels: (0, _yuneta_gobj_js.gobj_read_bool_attr)(gobj, "node_labels")
+		node_labels: (0, _yuneta_gobj_js.gobj_read_bool_attr)(gobj, "node_labels"),
+		camera: (0, _yuneta_gobj_js.gobj_read_attr)(gobj, "camera") || {}
 	}, gobj);
 	populate_nodes_tree_options(gobj);
 	if (priv.with_treedb_tables) {}
@@ -63801,6 +63909,23 @@ function ac_layout_autoset(gobj, event, kw, src) {
 	return 0;
 }
 /************************************************************
+*  The reader moved the camera, and it has settled.
+*
+*  Persisted like every other choice of this toolbar, and for the
+*  same reason: a zoom is a decision, and a decision that dies with
+*  the tab has to be taken again every morning. The engine debounces,
+*  so this runs once per gesture and not once per wheel notch.
+************************************************************/
+function ac_camera_changed(gobj, event, kw, src) {
+	(0, _yuneta_gobj_js.gobj_write_attr)(gobj, "camera", {
+		zoom: kw.zoom,
+		x: kw.x,
+		y: kw.y
+	});
+	(0, _yuneta_gobj_js.gobj_save_persistent_attrs)(gobj, "camera");
+	return 0;
+}
+/************************************************************
 *  Forward the find down to the graph child.
 ************************************************************/
 function ac_find_nodes(gobj, event, kw, src) {
@@ -64080,6 +64205,11 @@ function create_gclass$3(gclass_name) {
 			ac_layout_autoset,
 			null
 		],
+		[
+			"EV_CAMERA_CHANGED",
+			ac_camera_changed,
+			null
+		],
 		[
 			"EV_LEGEND_TOPIC",
 			ac_legend_topic,
@@ -64148,6 +64278,7 @@ function create_gclass$3(gclass_name) {
 		["EV_TOGGLE_NODE_LABELS", 0],
 		["EV_FIND_RESULT", 0],
 		["EV_LAYOUT_AUTOSET", 0],
+		["EV_CAMERA_CHANGED", 0],
 		["EV_LEGEND_TOPIC", 0],
 		["EV_LEGEND_STATE", 0],
 		["EV_TOPIC_SELECTED", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT | _yuneta_gobj_js.event_flag_t.EVF_NO_WARN_SUBS],

package/dist/gobj-ui.es.js

@@ -1,5 +1,5 @@
 import * as gobj_js 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_string, escapeHtml, event_flag_t, 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_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, 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_get_ids, 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_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, 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_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, 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_get_ids, 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_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";
@@ -54820,6 +54820,7 @@ var attrs_table$4 = [
 	SDATA(data_type_t.DTP_BOOLEAN, "node_labels", 0, true, "A `shape` node says its name under the figure. Off, it is a coloured figure and nothing else"),
 	SDATA(data_type_t.DTP_BOOLEAN, "confirm_delete_node", 0, true, "Ask confirmation before deleting a node"),
 	SDATA(data_type_t.DTP_BOOLEAN, "confirm_unlink_edge", 0, true, "Ask confirmation before unlinking an edge"),
+	SDATA(data_type_t.DTP_DICT, "camera", 0, "{}", "Where the reader left the viewport: {zoom, node, x, y} -- a NODE at a viewport pixel, not G6's own position, which does not restore. Empty = the graph opens fitted. Restored on the FIRST draw and published back as EV_CAMERA_CHANGED once a move settles, so a host can persist it"),
 	SDATA(data_type_t.DTP_STRING, "wide", 0, "40px", "Height of header"),
 	SDATA_END()
 ];
@@ -54827,6 +54828,9 @@ var PRIVATE_DATA$4 = {
 	anchor_id: "",
 	anchor_state: "off",
 	last_zoom: 1,
+	_camera_placed: false,
+	_camera_restoring: false,
+	_camera_timer: null,
 	_xy: 100,
 	_edge_seq: 0,
 	_history_paused: false,
@@ -54958,8 +54962,13 @@ function mt_start$4(gobj) {
 *          Framework Method: Stop
 ***************************************************************/
 function mt_stop$4(gobj) {
+	let priv = gobj.priv;
 	let shell = yui_shell_of(gobj);
 	if (shell) gobj_unsubscribe_event(shell, "EV_LANGUAGE_CHANGED", {}, gobj);
+	if (priv._camera_timer) {
+		clearTimeout(priv._camera_timer);
+		priv._camera_timer = null;
+	}
 	return 0;
 }
 /***************************************************************
@@ -55151,6 +55160,7 @@ function configure_events(gobj) {
 		update_link_icon_position(gobj);
 		update_port_icon_position(gobj);
 		update_zoom_readout(gobj);
+		publish_camera_later(gobj);
 		let z = priv.last_zoom;
 		try {
 			z = priv.graph.getZoom();
@@ -56676,6 +56686,83 @@ async function graph_fitview(gobj) {
 }
 var MIN_READABLE_ZOOM = .5;
 /************************************************************
+*  THE CAMERA IS THE READER'S.
+*
+*  Once somebody has chosen a zoom, nothing but a camera
+*  command may change it -- not a refresh, not a change of node
+*  mode, not a new main topic. Those rebuild the CONTENT, and
+*  the content moving is no reason to move the reader.
+*
+*  Two mechanisms, because they answer two different questions:
+*
+*    - across a rebuild in the same view, the anchor pair
+*      (`yui_graph_viewport_of` / `yui_graph_place_at`) keeps a
+*      NODE at the pixel it was on, which survives a relayout
+*      that moves everything;
+*    - across a RELOAD there is no node to hold on to yet, so
+*      the viewport itself is restored -- zoom and position, as
+*      G6 reports them.
+************************************************************/
+var CAMERA_SETTLE_MS = 700;
+function read_camera(gobj) {
+	let graph = gobj.priv.graph;
+	if (!graph || typeof graph.getZoom !== "function") return null;
+	try {
+		let z = graph.getZoom();
+		let node = fold_keep_node(gobj);
+		let vp = node ? yui_graph_viewport_of(graph, node) : null;
+		if (!is_number(z) || !node || !vp || !is_number(vp[0]) || !is_number(vp[1])) return null;
+		return {
+			zoom: z,
+			node,
+			x: vp[0],
+			y: vp[1]
+		};
+	} catch (e) {
+		return null;
+	}
+}
+async function restore_camera(gobj) {
+	let priv = gobj.priv;
+	let graph = priv.graph;
+	let cam = gobj_read_attr(gobj, "camera");
+	if (!graph || empty_json(cam) || !is_number(cam.zoom) || !cam.node || !is_number(cam.x) || !is_number(cam.y)) return false;
+	if (!yui_graph_viewport_of(graph, cam.node)) return false;
+	priv._camera_restoring = true;
+	try {
+		await graph.zoomTo(cam.zoom);
+		await yui_graph_place_at(graph, cam.node, [cam.x, cam.y]);
+		return true;
+	} catch (e) {
+		log_error(`${gobj_short_name(gobj)}: cannot restore the camera: ${e}`);
+		return false;
+	} finally {
+		priv._camera_restoring = false;
+	}
+}
+/************************************************************
+*  A move settled: tell whoever persists it.
+*
+*  Debounced on a REAL time and with the browser's timer: a
+*  wheel notch, a pinch and a drag each fire `aftertransform`
+*  many times, and what is worth saving is where the gesture
+*  ENDED. (`set_timeout` from gobj-js is a C_TIMER and shadows
+*  the global -- this module imports neither.)
+************************************************************/
+function publish_camera_later(gobj) {
+	let priv = gobj.priv;
+	if (priv._camera_restoring || !priv._camera_placed) return;
+	if (priv._camera_timer) clearTimeout(priv._camera_timer);
+	priv._camera_timer = setTimeout(() => {
+		priv._camera_timer = null;
+		if (gobj_is_destroying(gobj)) return;
+		let cam = read_camera(gobj);
+		if (!cam) return;
+		gobj_write_attr(gobj, "camera", cam);
+		gobj_publish_event(gobj, "EV_CAMERA_CHANGED", cam);
+	}, CAMERA_SETTLE_MS);
+}
+/************************************************************
 *  Fit the graph in the viewport, but never zoom out past the point
 *  where nothing on a card can be read.
 *
@@ -60619,8 +60706,11 @@ async function reconcile_fold_apply(gobj, opts, visible) {
 	}
 	await graph_draw(gobj);
 	if (changed || opts.relayout) await graph_layout(gobj);
-	if (opts.fit) await graph_fit_readable(gobj);
-	else if (opts.keep && opts.keep_vp) await yui_graph_place_at(graph, opts.keep, opts.keep_vp);
+	if (!(opts.restore && await restore_camera(gobj))) {
+		if (opts.fit) await graph_fit_readable(gobj);
+		else if (opts.keep && opts.keep_vp) await yui_graph_place_at(graph, opts.keep, opts.keep_vp);
+	}
+	priv._camera_placed = true;
 	update_resize_handles_position(gobj);
 	update_port_resize_handles_position(gobj);
 	update_edge_icon_position(gobj);
@@ -60772,10 +60862,19 @@ function ac_load_data(gobj, event, kw, src) {
 			log_error(`${gobj_short_name(gobj)}: auto_layout failed: ${e}`);
 		}
 		apply_layout_direction(gobj);
-		reconcile_fold(gobj, {
-			relayout: true,
+		let vp_opts;
+		if (!priv._camera_placed) vp_opts = {
+			restore: true,
 			fit: auto_laid
-		}).then(() => {
+		};
+		else {
+			let keep = fold_keep_node(gobj);
+			vp_opts = {
+				keep,
+				keep_vp: yui_graph_viewport_of(priv.graph, keep)
+			};
+		}
+		reconcile_fold(gobj, Object.assign({ relayout: true }, vp_opts)).then(() => {
 			sync_history_plugin(gobj);
 			if (priv._pending_focus_topic !== null) {
 				let ft = priv._pending_focus_topic;
@@ -61235,11 +61334,14 @@ function ac_set_main_topic(gobj, event, kw, src) {
 	let priv = gobj.priv;
 	gobj_write_str_attr(gobj, "main_topic", kw && kw.topic || "");
 	if (!priv._fold_model) return 0;
+	let keep = fold_keep_node(gobj);
+	let vp = yui_graph_viewport_of(priv.graph, keep);
 	rebuild_fold_model(gobj);
 	fold_expand_to_depth(priv._fold_model, priv._fold_state, gobj_read_integer_attr(gobj, "expand_depth"));
 	reconcile_fold(gobj, {
 		relayout: true,
-		fit: true
+		keep,
+		keep_vp: vp
 	});
 	return 0;
 }
@@ -61265,11 +61367,14 @@ function ac_set_node_mode$1(gobj, event, kw, src) {
 	gobj_write_str_attr(gobj, "node_mode", mode);
 	priv._open_nodes = /* @__PURE__ */ new Set();
 	if (!priv.graph || !priv._fold_model) return 0;
+	let keep = fold_keep_node(gobj);
+	let vp = yui_graph_viewport_of(priv.graph, keep);
 	reshape_nodes(gobj, all_record_node_ids(gobj));
 	reshape_more_chips(gobj);
 	reconcile_fold(gobj, {
 		relayout: true,
-		fit: true
+		keep,
+		keep_vp: vp
 	});
 	return 0;
 }
@@ -61939,6 +62044,7 @@ function create_gclass$4(gclass_name) {
 		["EV_FIND_NODES", 0],
 		["EV_FIND_RESULT", event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_LAYOUT_AUTOSET", event_flag_t.EVF_OUTPUT_EVENT],
+		["EV_CAMERA_CHANGED", event_flag_t.EVF_OUTPUT_EVENT | event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_TOGGLE_FOLD", 0],
 		["EV_SHOW_MORE", 0],
 		["EV_EXPAND_ALL", 0],
@@ -62025,6 +62131,7 @@ var attrs_table$3 = [
 	SDATA(data_type_t.DTP_LIST, "loose_topics", sdata_flag_t.SDF_PERSIST, "[]", "Topics whose LOOSE records (no parent) are shown. User preference, per treedb"),
 	SDATA(data_type_t.DTP_STRING, "node_mode", sdata_flag_t.SDF_PERSIST, "expanded", "How the records are drawn: `expanded` = the cards with their pills and ports, `compact` = one-line pills with the name, `shape` = coloured figures, the topology alone. User preference"),
 	SDATA(data_type_t.DTP_BOOLEAN, "node_labels", sdata_flag_t.SDF_PERSIST, true, "A `shape` node says its name under its figure. User preference"),
+	SDATA(data_type_t.DTP_DICT, "camera", sdata_flag_t.SDF_PERSIST, "{}", "Where the reader left the viewport: {zoom, x, y}. Handed to the engine on creation and written back when a move settles, so the graph opens where it was left. User preference, per treedb"),
 	SDATA(data_type_t.DTP_POINTER, "gobj_remote_yuno", 0, null, "Remote Yuno to request data"),
 	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"),
@@ -62112,7 +62219,8 @@ function mt_create$3(gobj) {
 		main_topic: gobj_read_str_attr(gobj, "main_topic") || "",
 		loose_topics: gobj_read_attr(gobj, "loose_topics") || [],
 		node_mode: gobj_read_str_attr(gobj, "node_mode") || "expanded",
-		node_labels: gobj_read_bool_attr(gobj, "node_labels")
+		node_labels: gobj_read_bool_attr(gobj, "node_labels"),
+		camera: gobj_read_attr(gobj, "camera") || {}
 	}, gobj);
 	populate_nodes_tree_options(gobj);
 	if (priv.with_treedb_tables) {}
@@ -63796,6 +63904,23 @@ function ac_layout_autoset(gobj, event, kw, src) {
 	return 0;
 }
 /************************************************************
+*  The reader moved the camera, and it has settled.
+*
+*  Persisted like every other choice of this toolbar, and for the
+*  same reason: a zoom is a decision, and a decision that dies with
+*  the tab has to be taken again every morning. The engine debounces,
+*  so this runs once per gesture and not once per wheel notch.
+************************************************************/
+function ac_camera_changed(gobj, event, kw, src) {
+	gobj_write_attr(gobj, "camera", {
+		zoom: kw.zoom,
+		x: kw.x,
+		y: kw.y
+	});
+	gobj_save_persistent_attrs(gobj, "camera");
+	return 0;
+}
+/************************************************************
 *  Forward the find down to the graph child.
 ************************************************************/
 function ac_find_nodes(gobj, event, kw, src) {
@@ -64075,6 +64200,11 @@ function create_gclass$3(gclass_name) {
 			ac_layout_autoset,
 			null
 		],
+		[
+			"EV_CAMERA_CHANGED",
+			ac_camera_changed,
+			null
+		],
 		[
 			"EV_LEGEND_TOPIC",
 			ac_legend_topic,
@@ -64143,6 +64273,7 @@ function create_gclass$3(gclass_name) {
 		["EV_TOGGLE_NODE_LABELS", 0],
 		["EV_FIND_RESULT", 0],
 		["EV_LAYOUT_AUTOSET", 0],
+		["EV_CAMERA_CHANGED", 0],
 		["EV_LEGEND_TOPIC", 0],
 		["EV_LEGEND_STATE", 0],
 		["EV_TOPIC_SELECTED", event_flag_t.EVF_OUTPUT_EVENT | event_flag_t.EVF_NO_WARN_SUBS],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuneta/gobj-ui",
-  "version": "7.23.103",
+  "version": "7.23.105",
   "type": "module",
   "main": "dist/gobj-ui.cjs.js",
   "module": "dist/gobj-ui.es.js",
@@ -24,6 +24,7 @@
   "scripts": {
     "build": "vite build",
     "test": "vitest run",
+    "deploy-round": "node scripts/deploy-round.mjs",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {

package/src/c_g6_nodes_tree.js

@@ -70,6 +70,7 @@ import {
     empty_string,
     is_object,
     is_number,
+    empty_json,
     kw_get_int,
     kw_get_str,
     kw_get_dict_value,
@@ -442,6 +443,9 @@ SDATA(data_type_t.DTP_BOOLEAN,  "node_labels",          0,  true,   "A `shape` n
 SDATA(data_type_t.DTP_BOOLEAN,  "confirm_delete_node",  0,  true,   "Ask confirmation before deleting a node"),
 SDATA(data_type_t.DTP_BOOLEAN,  "confirm_unlink_edge",  0,  true,   "Ask confirmation before unlinking an edge"),
 
+/*---------------- Camera ----------------*/
+SDATA(data_type_t.DTP_DICT,     "camera",               0,  "{}",   "Where the reader left the viewport: {zoom, node, x, y} -- a NODE at a viewport pixel, not G6's own position, which does not restore. Empty = the graph opens fitted. Restored on the FIRST draw and published back as EV_CAMERA_CHANGED once a move settles, so a host can persist it"),
+
 SDATA(data_type_t.DTP_STRING,   "wide",                 0,  "40px", "Height of header"),
 
 SDATA_END()
@@ -452,6 +456,9 @@ let PRIVATE_DATA = {
     anchor_id:      "",     // the node the camera keeps in the middle
     anchor_state:   "off",  // "off" | "arming" | "on"
     last_zoom:      1,      // tells a wheel zoom from a drag in aftertransform
+    _camera_placed: false,  // the first draw has decided the viewport
+    _camera_restoring: false,   // a move WE made: not the reader's, do not publish it
+    _camera_timer:  null,   // browser timer: the gesture has to END before it is saved
 
     _xy:                100,
     _edge_seq:          0,
@@ -657,11 +664,19 @@ function mt_start(gobj)
  ***************************************************************/
 function mt_stop(gobj)
 {
+    let priv = gobj.priv;
     let shell = yui_shell_of(gobj);
     if(shell) {
         gobj_unsubscribe_event(shell, "EV_LANGUAGE_CHANGED", {}, gobj);
     }
 
+    /*  A camera move that settles after the view is gone has nobody
+     *  to tell and a graph that is no longer there to read.  */
+    if(priv._camera_timer) {
+        clearTimeout(priv._camera_timer);
+        priv._camera_timer = null;
+    }
+
     return 0;
 }
 
@@ -1036,6 +1051,11 @@ function configure_events(gobj)
         update_port_icon_position(gobj);
         update_zoom_readout(gobj);
 
+        /*  Before the zoom/pan test below and not inside it: a PAN is
+         *  a camera move too, and it is the reader's just as much as
+         *  a zoom is.  */
+        publish_camera_later(gobj);
+
         /*
          *  A ZOOM re-centres on the anchor; a PAN does not.
          *  `aftertransform` fires for both, and an anchor that also
@@ -3329,6 +3349,126 @@ async function graph_fitview(gobj)
 /*  Below this the cards carry no readable text at all. */
 const MIN_READABLE_ZOOM = 0.5;
 
+
+/************************************************************
+ *  THE CAMERA IS THE READER'S.
+ *
+ *  Once somebody has chosen a zoom, nothing but a camera
+ *  command may change it -- not a refresh, not a change of node
+ *  mode, not a new main topic. Those rebuild the CONTENT, and
+ *  the content moving is no reason to move the reader.
+ *
+ *  Two mechanisms, because they answer two different questions:
+ *
+ *    - across a rebuild in the same view, the anchor pair
+ *      (`yui_graph_viewport_of` / `yui_graph_place_at`) keeps a
+ *      NODE at the pixel it was on, which survives a relayout
+ *      that moves everything;
+ *    - across a RELOAD there is no node to hold on to yet, so
+ *      the viewport itself is restored -- zoom and position, as
+ *      G6 reports them.
+ ************************************************************/
+const CAMERA_SETTLE_MS = 700;
+
+/*  A camera is saved as a NODE at a VIEWPORT PIXEL, plus the zoom --
+ *  never as G6's own position.
+ *
+ *  `translateTo()` does not take viewport pixels: an absolute translate
+ *  leaves the camera at `canvasCentre - T/zoom`, so `getPosition()` and
+ *  `translateTo()` are only each other's inverse at zoom 1. Restoring
+ *  one with the other brought the zoom back and put the graph somewhere
+ *  else, which is exactly what it looks like -- and the reason to write
+ *  the pair down (`yui_graph_place_at`, gobj-ui 7.23.29) was that it
+ *  had already cost fifteen iterations once.
+ *
+ *  A node and a pixel is also the SAME thing the folds keep across a
+ *  rebuild. One idea, used twice.  */
+function read_camera(gobj)
+{
+    let priv = gobj.priv;
+    let graph = priv.graph;
+
+    if(!graph || typeof graph.getZoom !== "function") {
+        return null;
+    }
+    try {
+        let z = graph.getZoom();
+        let node = fold_keep_node(gobj);
+        let vp = node? yui_graph_viewport_of(graph, node) : null;
+        if(!is_number(z) || !node || !vp || !is_number(vp[0]) || !is_number(vp[1])) {
+            return null;
+        }
+        return {zoom: z, node: node, x: vp[0], y: vp[1]};
+    } catch(e) {
+        return null;    /*  between renders: there is no camera to read  */
+    }
+}
+
+/*  Returns true when it placed the viewport, so the caller knows
+ *  not to fit.  */
+async function restore_camera(gobj)
+{
+    let priv = gobj.priv;
+    let graph = priv.graph;
+    let cam = gobj_read_attr(gobj, "camera");
+
+    if(!graph || empty_json(cam) || !is_number(cam.zoom) ||
+            !cam.node || !is_number(cam.x) || !is_number(cam.y)) {
+        return false;   /*  nothing saved, or saved by a version that wrote
+                            G6's own position -- which never restored  */
+    }
+    /*  Checked BEFORE the zoom is touched: a saved node that this load
+     *  does not have (the treedb changed under it) must leave the graph
+     *  to its opening fit, not at a zoom with no framing to go with it.  */
+    if(!yui_graph_viewport_of(graph, cam.node)) {
+        return false;
+    }
+    priv._camera_restoring = true;
+    try {
+        await graph.zoomTo(cam.zoom);
+        await yui_graph_place_at(graph, cam.node, [cam.x, cam.y]);
+        return true;
+    } catch(e) {
+        log_error(`${gobj_short_name(gobj)}: cannot restore the camera: ${e}`);
+        return false;
+    } finally {
+        priv._camera_restoring = false;
+    }
+}
+
+/************************************************************
+ *  A move settled: tell whoever persists it.
+ *
+ *  Debounced on a REAL time and with the browser's timer: a
+ *  wheel notch, a pinch and a drag each fire `aftertransform`
+ *  many times, and what is worth saving is where the gesture
+ *  ENDED. (`set_timeout` from gobj-js is a C_TIMER and shadows
+ *  the global -- this module imports neither.)
+ ************************************************************/
+function publish_camera_later(gobj)
+{
+    let priv = gobj.priv;
+
+    if(priv._camera_restoring || !priv._camera_placed) {
+        return;     /*  our own move, or the opening one  */
+    }
+    if(priv._camera_timer) {
+        clearTimeout(priv._camera_timer);
+    }
+    priv._camera_timer = setTimeout(() => {
+        priv._camera_timer = null;
+        if(gobj_is_destroying(gobj)) {
+            return;
+        }
+        let cam = read_camera(gobj);
+        if(!cam) {
+            return;     /*  Error already logged, or nothing to read  */
+        }
+        gobj_write_attr(gobj, "camera", cam);
+        gobj_publish_event(gobj, "EV_CAMERA_CHANGED", cam);
+    }, CAMERA_SETTLE_MS);
+}
+
 /************************************************************
  *  Fit the graph in the viewport, but never zoom out past the point
  *  where nothing on a card can be read.
@@ -9241,11 +9381,26 @@ async function reconcile_fold_apply(gobj, opts, visible)
         await graph_layout(gobj);
     }
 
-    if(opts.fit) {
-        await graph_fit_readable(gobj);
-    } else if(opts.keep && opts.keep_vp) {
-        await yui_graph_place_at(graph, opts.keep, opts.keep_vp);
-    }
+    /*  THE VIEWPORT, and only here.
+     *
+     *  `restore` is the reader's saved camera coming back on the
+     *  first draw after a reload; `fit` is the opening frame of a
+     *  graph nobody has looked at yet; `keep` holds a node at the
+     *  pixel it was on across a rebuild. Anything else leaves the
+     *  camera alone, which is the default on purpose: a rebuild of
+     *  the CONTENT is not a reason to move the reader.  */
+    if(!(opts.restore && await restore_camera(gobj))) {
+        if(opts.fit) {
+            await graph_fit_readable(gobj);
+        } else if(opts.keep && opts.keep_vp) {
+            await yui_graph_place_at(graph, opts.keep, opts.keep_vp);
+        }
+    }
+    /*  Whichever branch ran -- including none of them, which is a
+     *  graph somebody had arranged and left where it was -- the
+     *  opening viewport is decided from here on, and every move after
+     *  it is the reader's and worth remembering.  */
+    priv._camera_placed = true;
 
     update_resize_handles_position(gobj);
     update_port_resize_handles_position(gobj);
@@ -9484,10 +9639,23 @@ function ac_load_data(gobj, event, kw, src)
          *  nodes are about to be built: settle it first.  */
         apply_layout_direction(gobj);
 
-        /*  A graph laid out by us opens WHOLE (fit). Only when WE laid
-         *  it out — a saved arrangement includes where its owner was
-         *  looking. */
-        reconcile_fold(gobj, {relayout: true, fit: auto_laid}).then(() => {
+        /*  THE FIRST load decides the viewport: the reader's saved
+         *  camera if there is one, else the opening fit -- and only
+         *  when WE laid the graph out, since a saved arrangement
+         *  includes where its owner was looking.
+         *
+         *  Every load AFTER that is a REFRESH, and a refresh must not
+         *  move the camera: the reader asked for fresh data, not for a
+         *  new viewport. It holds a node instead, so the graph does not
+         *  jump even if the layout changed under it.  */
+        let vp_opts;
+        if(!priv._camera_placed) {
+            vp_opts = {restore: true, fit: auto_laid};
+        } else {
+            let keep = fold_keep_node(gobj);
+            vp_opts = {keep: keep, keep_vp: yui_graph_viewport_of(priv.graph, keep)};
+        }
+        reconcile_fold(gobj, Object.assign({relayout: true}, vp_opts)).then(() => {
             sync_history_plugin(gobj);
             /*  Nodes exist and are positioned now: apply a focus
              *  requested before the data was ready (deep link). */
@@ -10160,12 +10328,18 @@ function ac_set_main_topic(gobj, event, kw, src)
     if(!priv._fold_model) {
         return 0;
     }
+    /*  Read BEFORE the model is rebuilt: the node is looked up in the
+     *  tree that is on screen. If the new trunk leaves it out,
+     *  `yui_graph_place_at` finds nothing and the camera simply stays
+     *  where it was -- which is still not a refit.  */
+    let keep = fold_keep_node(gobj);
+    let vp = yui_graph_viewport_of(priv.graph, keep);
     rebuild_fold_model(gobj);
     fold_expand_to_depth(
         priv._fold_model, priv._fold_state,
         gobj_read_integer_attr(gobj, "expand_depth")
     );
-    reconcile_fold(gobj, {relayout: true, fit: true});
+    reconcile_fold(gobj, {relayout: true, keep: keep, keep_vp: vp});
     return 0;
 }
 
@@ -10200,9 +10374,15 @@ function ac_set_node_mode(gobj, event, kw, src)
     if(!priv.graph || !priv._fold_model) {
         return 0;       /*  applied when the records arrive  */
     }
+    /*  The camera is the reader's: a square and a card do not occupy
+     *  the same room, so the graph is laid out again -- and the node
+     *  being read stays at its pixel, at the zoom it was chosen at,
+     *  instead of the whole graph being fitted from scratch.  */
+    let keep = fold_keep_node(gobj);
+    let vp = yui_graph_viewport_of(priv.graph, keep);
     reshape_nodes(gobj, all_record_node_ids(gobj));
     reshape_more_chips(gobj);
-    reconcile_fold(gobj, {relayout: true, fit: true});
+    reconcile_fold(gobj, {relayout: true, keep: keep, keep_vp: vp});
     return 0;
 }
 
@@ -10898,6 +11078,9 @@ function create_gclass(gclass_name)
         ["EV_FIND_NODES",               0],
         ["EV_FIND_RESULT",              event_flag_t.EVF_OUTPUT_EVENT],
         ["EV_LAYOUT_AUTOSET",           event_flag_t.EVF_OUTPUT_EVENT],
+        /*  Optional: a host that does not persist the viewport is not
+         *  doing anything wrong, so no "publish without subscribers".  */
+        ["EV_CAMERA_CHANGED",           event_flag_t.EVF_OUTPUT_EVENT|event_flag_t.EVF_NO_WARN_SUBS],
         ["EV_TOGGLE_FOLD",              0],
         ["EV_SHOW_MORE",                0],
         ["EV_EXPAND_ALL",               0],

package/src/c_yui_treedb_graph.js

@@ -136,6 +136,7 @@ SDATA(data_type_t.DTP_STRING,   "main_topic",       sdata_flag_t.SDF_PERSIST, ""
 SDATA(data_type_t.DTP_LIST,     "loose_topics",     sdata_flag_t.SDF_PERSIST, "[]", "Topics whose LOOSE records (no parent) are shown. User preference, per treedb"),
 SDATA(data_type_t.DTP_STRING,   "node_mode",        sdata_flag_t.SDF_PERSIST, "expanded", "How the records are drawn: `expanded` = the cards with their pills and ports, `compact` = one-line pills with the name, `shape` = coloured figures, the topology alone. User preference"),
 SDATA(data_type_t.DTP_BOOLEAN,  "node_labels",      sdata_flag_t.SDF_PERSIST, true, "A `shape` node says its name under its figure. User preference"),
+SDATA(data_type_t.DTP_DICT,     "camera",           sdata_flag_t.SDF_PERSIST, "{}", "Where the reader left the viewport: {zoom, x, y}. Handed to the engine on creation and written back when a move settles, so the graph opens where it was left. User preference, per treedb"),
 
 /*---------------- Remote Connection ----------------*/
 SDATA(data_type_t.DTP_POINTER,  "gobj_remote_yuno", 0,  null,   "Remote Yuno to request data"),
@@ -281,6 +282,7 @@ function mt_create(gobj)
             loose_topics: gobj_read_attr(gobj, "loose_topics") || [],
             node_mode: gobj_read_str_attr(gobj, "node_mode") || "expanded",
             node_labels: gobj_read_bool_attr(gobj, "node_labels"),
+            camera: gobj_read_attr(gobj, "camera") || {},
         },
         gobj
     );
@@ -2888,6 +2890,23 @@ function ac_layout_autoset(gobj, event, kw, src)
     return 0;
 }
 
+/************************************************************
+ *  The reader moved the camera, and it has settled.
+ *
+ *  Persisted like every other choice of this toolbar, and for the
+ *  same reason: a zoom is a decision, and a decision that dies with
+ *  the tab has to be taken again every morning. The engine debounces,
+ *  so this runs once per gesture and not once per wheel notch.
+ ************************************************************/
+function ac_camera_changed(gobj, event, kw, src)
+{
+    gobj_write_attr(gobj, "camera", {
+        zoom: kw.zoom, x: kw.x, y: kw.y
+    });
+    gobj_save_persistent_attrs(gobj, "camera");
+    return 0;
+}
+
 /************************************************************
  *  Forward the find down to the graph child.
  ************************************************************/
@@ -3128,6 +3147,7 @@ function create_gclass(gclass_name)
             ["EV_SET_NODE_MODE",            ac_set_node_mode,           null],
             ["EV_TOGGLE_NODE_LABELS",       ac_toggle_node_labels,      null],
             ["EV_LAYOUT_AUTOSET",           ac_layout_autoset,          null],
+            ["EV_CAMERA_CHANGED",           ac_camera_changed,          null],
             ["EV_LEGEND_TOPIC",             ac_legend_topic,            null],
             ["EV_LEGEND_STATE",             ac_legend_state,            null],
             ["EV_FIND_RESULT",              ac_find_result,             null],
@@ -3173,6 +3193,7 @@ function create_gclass(gclass_name)
         ["EV_TOGGLE_NODE_LABELS",       0],
         ["EV_FIND_RESULT",              0],
         ["EV_LAYOUT_AUTOSET",           0],
+        ["EV_CAMERA_CHANGED",           0],
         ["EV_LEGEND_TOPIC",             0],
         ["EV_LEGEND_STATE",             0],
         ["EV_TOPIC_SELECTED",