@yuneta/gobj-ui 7.13.5 → 7.14.0

package/README.md

@@ -866,6 +866,14 @@ id on `.`, which works right up to the first name that carries one),
 `schema_validate.js`, `schema_descs.js`, `schema_to_c.js`, `schema_import.js`,
 `schema_flags.js`, `schema_write_options.js`. Since 6.1.0.
 
+**A drag can be undone.** Reordering a column is a WRITE — `order` is a field —
+so the drop lands in the store the moment you let go. The toolbar grows an
+`Undo the order` button that puts the columns back where they were **before the
+dragging started** (remembered once per topic, before the FIRST drag), shown
+only while there is somewhere to go back to, spent when used, and dropped by a
+refresh. Undoing is another write, like the drag. The host must define the key
+`"undo the order"`.
+
 ### Frontend view — `setup_frontend_view`
 
 `setup_frontend_view(self)` opens the **gobj tree of the app's own yuno** in a

package/dist/gobj-ui.cjs.js

@@ -23517,6 +23517,7 @@ var PRIVATE_DATA$2 = {
 	diagram: false,
 	baseline: null,
 	written: null,
+	order_undo: null,
 	diagram_gobj: null,
 	dialog: null,
 	save_queue: null,
@@ -23751,6 +23752,7 @@ function remote_command(gobj, command, kw) {
 function build_model(gobj) {
 	let priv = gobj.priv;
 	priv.model = build_schema_model(priv.records);
+	priv.order_undo = {};
 	priv.baseline = {};
 	for (let treedb of priv.model.treedbs) for (let topic of treedb.topics) priv.baseline[topic.id] = topic.topic_version;
 }
@@ -23987,7 +23989,10 @@ function render_toolbar(gobj) {
 		$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));
 	}
-	if (priv.topic_name && !readonly && !priv.diagram) $right.push(toolbar_button("SCHEMA_ADD_COL_BTN", "yi-plus", "new column", "EV_ADD_COLUMN", false));
+	if (priv.topic_name && !readonly && !priv.diagram) {
+		if (undo_order_writes(gobj, current_topic(gobj)).length > 0) $right.push(toolbar_button("SCHEMA_UNDO_ORDER_BTN", "yi-arrow-rotate-left", "undo the order", "EV_UNDO_ORDER", false));
+		$right.push(toolbar_button("SCHEMA_ADD_COL_BTN", "yi-plus", "new column", "EV_ADD_COLUMN", false));
+	}
 	if (priv.treedb_id && !priv.topic_name && !readonly && !priv.diagram) $right.push(toolbar_button("SCHEMA_ADD_TOPIC_BTN", "yi-plus", "new topic", "EV_ADD_TOPIC", false));
 	$right.push(toolbar_button("SCHEMA_REFRESH_BTN", "yi-arrows-rotate", "refresh", "EV_REFRESH", state === "ST_LOADING"));
 	let $bar = (0, _yuneta_gobj_js.createElement2)([
@@ -25818,6 +25823,53 @@ function version_writes(gobj, topic) {
 	return writes;
 }
 /***************************************************************
+*  WHERE THE COLUMNS WERE before this session started moving them.
+*
+*  A drag is a WRITE: the order is a field of the column, so the drop
+*  lands in the store the moment you let go, and the only way back used
+*  to be dragging every row to where you thought it was. The order is
+*  remembered once per topic -- before the FIRST drag, not before each
+*  one -- because the operator who tries three arrangements wants the
+*  one they started from, not the third.
+*
+*  A reload drops it (see build_model): what it names is what was on
+*  screen, and a reload brings the stored order instead.
+***************************************************************/
+function remember_order(gobj, topic) {
+	let priv = gobj.priv;
+	if (!topic || !priv.order_undo || priv.order_undo[topic.id]) return;
+	priv.order_undo[topic.id] = topic.cols.map((col) => {
+		return {
+			id: col.id,
+			order: col.order
+		};
+	});
+}
+/***************************************************************
+*  The writes that would put the remembered order back, or an
+*  empty list when there is nothing to undo (no snapshot, or the
+*  columns are already where they were).
+***************************************************************/
+function undo_order_writes(gobj, topic) {
+	let priv = gobj.priv;
+	let snapshot = topic && priv.order_undo ? priv.order_undo[topic.id] : null;
+	if (!snapshot) return [];
+	let writes = [];
+	for (let was of snapshot) {
+		let col = topic.cols.find((c) => c && c.id === was.id);
+		if (!col || col.order === was.order) continue;
+		writes.push({
+			op: "update",
+			topic_name: T_COLS,
+			record: {
+				id: was.id,
+				order: was.order
+			}
+		});
+	}
+	return writes;
+}
+/***************************************************************
 *  Run a list of writes, one at a time, and say so while it
 *  runs. One at a time because each answer patches the model the
 *  next one is computed against, and because a treedb that
@@ -26255,6 +26307,7 @@ function ac_move_column(gobj, event, kw, src) {
 		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: ${event} with no topic open`);
 		return -1;
 	}
+	remember_order(gobj, topic);
 	let from = kw.from;
 	let to = kw.to;
 	let list = topic.cols.slice();
@@ -26278,6 +26331,26 @@ function ac_move_column(gobj, event, kw, src) {
 	return queue_writes(gobj, writes.concat(version_writes(gobj, topic)));
 }
 /***************************************************************
+*  Put the columns back where they were before the dragging
+*  started. Another write, because the drag was one.
+***************************************************************/
+function ac_undo_order(gobj, event, kw, src) {
+	let priv = gobj.priv;
+	let topic = current_topic(gobj);
+	if (refuse_if_readonly(gobj, event)) return -1;
+	if (!topic) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: ${event} with no topic open`);
+		return -1;
+	}
+	let writes = undo_order_writes(gobj, topic);
+	if (writes.length === 0) {
+		(0, _yuneta_gobj_js.log_warning)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: nothing to undo in ${topic.name}`);
+		return 0;
+	}
+	delete priv.order_undo[topic.id];
+	return queue_writes(gobj, writes.concat(version_writes(gobj, topic)));
+}
+/***************************************************************
 *  Editing a topic.
 ***************************************************************/
 function ac_add_topic(gobj, event, kw, src) {
@@ -26705,6 +26778,11 @@ function create_gclass$2(gclass_name) {
 				ac_move_column,
 				null
 			],
+			[
+				"EV_UNDO_ORDER",
+				ac_undo_order,
+				null
+			],
 			[
 				"EV_BUMP_VERSION",
 				ac_bump_version,
@@ -26736,6 +26814,7 @@ function create_gclass$2(gclass_name) {
 		["EV_DELETE_COLUMN", 0],
 		["EV_SAVE_COLUMN", 0],
 		["EV_MOVE_COLUMN", 0],
+		["EV_UNDO_ORDER", 0],
 		["EV_BUMP_VERSION", 0],
 		["EV_VALIDATE", 0],
 		["EV_EXPORT", 0],

package/dist/gobj-ui.es.js

@@ -23504,6 +23504,7 @@ var PRIVATE_DATA$2 = {
 	diagram: false,
 	baseline: null,
 	written: null,
+	order_undo: null,
 	diagram_gobj: null,
 	dialog: null,
 	save_queue: null,
@@ -23738,6 +23739,7 @@ function remote_command(gobj, command, kw) {
 function build_model(gobj) {
 	let priv = gobj.priv;
 	priv.model = build_schema_model(priv.records);
+	priv.order_undo = {};
 	priv.baseline = {};
 	for (let treedb of priv.model.treedbs) for (let topic of treedb.topics) priv.baseline[topic.id] = topic.topic_version;
 }
@@ -23974,7 +23976,10 @@ function render_toolbar(gobj) {
 		$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));
 	}
-	if (priv.topic_name && !readonly && !priv.diagram) $right.push(toolbar_button("SCHEMA_ADD_COL_BTN", "yi-plus", "new column", "EV_ADD_COLUMN", false));
+	if (priv.topic_name && !readonly && !priv.diagram) {
+		if (undo_order_writes(gobj, current_topic(gobj)).length > 0) $right.push(toolbar_button("SCHEMA_UNDO_ORDER_BTN", "yi-arrow-rotate-left", "undo the order", "EV_UNDO_ORDER", false));
+		$right.push(toolbar_button("SCHEMA_ADD_COL_BTN", "yi-plus", "new column", "EV_ADD_COLUMN", false));
+	}
 	if (priv.treedb_id && !priv.topic_name && !readonly && !priv.diagram) $right.push(toolbar_button("SCHEMA_ADD_TOPIC_BTN", "yi-plus", "new topic", "EV_ADD_TOPIC", false));
 	$right.push(toolbar_button("SCHEMA_REFRESH_BTN", "yi-arrows-rotate", "refresh", "EV_REFRESH", state === "ST_LOADING"));
 	let $bar = createElement2([
@@ -25805,6 +25810,53 @@ function version_writes(gobj, topic) {
 	return writes;
 }
 /***************************************************************
+*  WHERE THE COLUMNS WERE before this session started moving them.
+*
+*  A drag is a WRITE: the order is a field of the column, so the drop
+*  lands in the store the moment you let go, and the only way back used
+*  to be dragging every row to where you thought it was. The order is
+*  remembered once per topic -- before the FIRST drag, not before each
+*  one -- because the operator who tries three arrangements wants the
+*  one they started from, not the third.
+*
+*  A reload drops it (see build_model): what it names is what was on
+*  screen, and a reload brings the stored order instead.
+***************************************************************/
+function remember_order(gobj, topic) {
+	let priv = gobj.priv;
+	if (!topic || !priv.order_undo || priv.order_undo[topic.id]) return;
+	priv.order_undo[topic.id] = topic.cols.map((col) => {
+		return {
+			id: col.id,
+			order: col.order
+		};
+	});
+}
+/***************************************************************
+*  The writes that would put the remembered order back, or an
+*  empty list when there is nothing to undo (no snapshot, or the
+*  columns are already where they were).
+***************************************************************/
+function undo_order_writes(gobj, topic) {
+	let priv = gobj.priv;
+	let snapshot = topic && priv.order_undo ? priv.order_undo[topic.id] : null;
+	if (!snapshot) return [];
+	let writes = [];
+	for (let was of snapshot) {
+		let col = topic.cols.find((c) => c && c.id === was.id);
+		if (!col || col.order === was.order) continue;
+		writes.push({
+			op: "update",
+			topic_name: T_COLS,
+			record: {
+				id: was.id,
+				order: was.order
+			}
+		});
+	}
+	return writes;
+}
+/***************************************************************
 *  Run a list of writes, one at a time, and say so while it
 *  runs. One at a time because each answer patches the model the
 *  next one is computed against, and because a treedb that
@@ -26242,6 +26294,7 @@ function ac_move_column(gobj, event, kw, src) {
 		log_error(`${gobj_short_name(gobj)}: ${event} with no topic open`);
 		return -1;
 	}
+	remember_order(gobj, topic);
 	let from = kw.from;
 	let to = kw.to;
 	let list = topic.cols.slice();
@@ -26265,6 +26318,26 @@ function ac_move_column(gobj, event, kw, src) {
 	return queue_writes(gobj, writes.concat(version_writes(gobj, topic)));
 }
 /***************************************************************
+*  Put the columns back where they were before the dragging
+*  started. Another write, because the drag was one.
+***************************************************************/
+function ac_undo_order(gobj, event, kw, src) {
+	let priv = gobj.priv;
+	let topic = current_topic(gobj);
+	if (refuse_if_readonly(gobj, event)) return -1;
+	if (!topic) {
+		log_error(`${gobj_short_name(gobj)}: ${event} with no topic open`);
+		return -1;
+	}
+	let writes = undo_order_writes(gobj, topic);
+	if (writes.length === 0) {
+		log_warning(`${gobj_short_name(gobj)}: nothing to undo in ${topic.name}`);
+		return 0;
+	}
+	delete priv.order_undo[topic.id];
+	return queue_writes(gobj, writes.concat(version_writes(gobj, topic)));
+}
+/***************************************************************
 *  Editing a topic.
 ***************************************************************/
 function ac_add_topic(gobj, event, kw, src) {
@@ -26692,6 +26765,11 @@ function create_gclass$2(gclass_name) {
 				ac_move_column,
 				null
 			],
+			[
+				"EV_UNDO_ORDER",
+				ac_undo_order,
+				null
+			],
 			[
 				"EV_BUMP_VERSION",
 				ac_bump_version,
@@ -26723,6 +26801,7 @@ function create_gclass$2(gclass_name) {
 		["EV_DELETE_COLUMN", 0],
 		["EV_SAVE_COLUMN", 0],
 		["EV_MOVE_COLUMN", 0],
+		["EV_UNDO_ORDER", 0],
 		["EV_BUMP_VERSION", 0],
 		["EV_VALIDATE", 0],
 		["EV_EXPORT", 0],

package/package.json

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

package/src/c_yui_schema_editor.css

@@ -72,12 +72,15 @@
     cursor: pointer;
 }
 
-/*  ...but they hold NAMES, and a treedb name is long: at the shell's 9rem
- *  (144px) `treedb_yuneta_agent` breaks into three lines inside its own
- *  card. Start wider here. The shell default is left alone -- it also
- *  serves grids of short labels, where 12rem would be a lot of air.  */
+/*  ...but they hold NAMES, and a treedb name is long. At the shell's 9rem
+ *  (144px) `treedb_yuneta_agent` broke into THREE lines inside its own
+ *  card, and at 12rem into two: the name shares its row with the icon and
+ *  the card's padding, so what it gets is some 60px less than the card.
+ *  14rem is what fits that name on one line. The shell default is left
+ *  alone -- it also serves grids of short labels, where this would be a
+ *  lot of air.  */
 .C_YUI_SCHEMA_EDITOR .yui-nav-cards {
-    grid-template-columns: repeat(auto-fill, minmax(12rem, 1fr));
+    grid-template-columns: repeat(auto-fill, minmax(14rem, 1fr));
 }
 
 /*  The flag grid: as many columns as fit, never fewer than one.  */

package/src/c_yui_schema_editor.js

@@ -202,6 +202,7 @@ let PRIVATE_DATA = {
      *  version still has to move.  */
     baseline:       null,   /*  {topic id: topic_version} at load time  */
     written:        null,   /*  {topic id: true}  */
+    order_undo:     null,   /*  {topic id: [{id, order}]} before the first drag  */
 
     /*  Children and overlays  */
     diagram_gobj:   null,
@@ -527,6 +528,9 @@ function build_model(gobj)
     let priv = gobj.priv;
 
     priv.model = build_schema_model(priv.records);
+    /*  The order to go back to is the one that was on screen; a reload
+     *  brings the stored one, so what was on screen is gone. */
+    priv.order_undo = {};
     priv.baseline = {};
     for(let treedb of priv.model.treedbs) {
         for(let topic of treedb.topics) {
@@ -768,6 +772,12 @@ function render_toolbar(gobj)
         }
     }
     if(priv.topic_name && !readonly && !priv.diagram) {
+        /*  Only while there IS somewhere to go back to: a drag is a write,
+         *  and this is the way back from one. */
+        if(undo_order_writes(gobj, current_topic(gobj)).length > 0) {
+            $right.push(toolbar_button("SCHEMA_UNDO_ORDER_BTN", "yi-arrow-rotate-left",
+                "undo the order", "EV_UNDO_ORDER", false));
+        }
         $right.push(toolbar_button("SCHEMA_ADD_COL_BTN", "yi-plus",
             "new column", "EV_ADD_COLUMN", false));
     }
@@ -2139,6 +2149,56 @@ function version_writes(gobj, topic)
     return writes;
 }
 
+/***************************************************************
+ *  WHERE THE COLUMNS WERE before this session started moving them.
+ *
+ *  A drag is a WRITE: the order is a field of the column, so the drop
+ *  lands in the store the moment you let go, and the only way back used
+ *  to be dragging every row to where you thought it was. The order is
+ *  remembered once per topic -- before the FIRST drag, not before each
+ *  one -- because the operator who tries three arrangements wants the
+ *  one they started from, not the third.
+ *
+ *  A reload drops it (see build_model): what it names is what was on
+ *  screen, and a reload brings the stored order instead.
+ ***************************************************************/
+function remember_order(gobj, topic)
+{
+    let priv = gobj.priv;
+
+    if(!topic || !priv.order_undo || priv.order_undo[topic.id]) {
+        return;     /*  the first drag already said where we started  */
+    }
+    priv.order_undo[topic.id] = topic.cols.map((col) => {
+        return {id: col.id, order: col.order};
+    });
+}
+
+/***************************************************************
+ *  The writes that would put the remembered order back, or an
+ *  empty list when there is nothing to undo (no snapshot, or the
+ *  columns are already where they were).
+ ***************************************************************/
+function undo_order_writes(gobj, topic)
+{
+    let priv = gobj.priv;
+    let snapshot = (topic && priv.order_undo) ? priv.order_undo[topic.id] : null;
+
+    if(!snapshot) {
+        return [];
+    }
+    let writes = [];
+    for(let was of snapshot) {
+        let col = topic.cols.find((c) => c && c.id === was.id);
+        if(!col || col.order === was.order) {
+            continue;
+        }
+        writes.push({op: "update", topic_name: T_COLS,
+                     record: {id: was.id, order: was.order}});
+    }
+    return writes;
+}
+
 /***************************************************************
  *  Run a list of writes, one at a time, and say so while it
  *  runs. One at a time because each answer patches the model the
@@ -2797,6 +2857,8 @@ function ac_move_column(gobj, event, kw, src)
         return -1;
     }
 
+    remember_order(gobj, topic);
+
     let from = kw.from;
     let to = kw.to;
     let list = topic.cols.slice();
@@ -2817,6 +2879,35 @@ function ac_move_column(gobj, event, kw, src)
     return queue_writes(gobj, writes.concat(version_writes(gobj, topic)));
 }
 
+/***************************************************************
+ *  Put the columns back where they were before the dragging
+ *  started. Another write, because the drag was one.
+ ***************************************************************/
+function ac_undo_order(gobj, event, kw, src)
+{
+    let priv = gobj.priv;
+    let topic = current_topic(gobj);
+
+    if(refuse_if_readonly(gobj, event)) {
+        return -1;
+    }
+    if(!topic) {
+        log_error(`${gobj_short_name(gobj)}: ${event} with no topic open`);
+        return -1;
+    }
+
+    let writes = undo_order_writes(gobj, topic);
+    if(writes.length === 0) {
+        /*  The button is not there in this case; the event can still
+         *  arrive from a keyboard path. */
+        log_warning(`${gobj_short_name(gobj)}: nothing to undo in ${topic.name}`);
+        return 0;
+    }
+    /*  Spent: what it named is where the columns are about to be. */
+    delete priv.order_undo[topic.id];
+    return queue_writes(gobj, writes.concat(version_writes(gobj, topic)));
+}
+
 /***************************************************************
  *  Editing a topic.
  ***************************************************************/
@@ -3209,6 +3300,7 @@ function create_gclass(gclass_name)
             ["EV_DELETE_COLUMN",    ac_delete_column,       null],
             ["EV_SAVE_COLUMN",      ac_save_column,         null],
             ["EV_MOVE_COLUMN",      ac_move_column,         null],
+            ["EV_UNDO_ORDER",       ac_undo_order,          null],
             ["EV_BUMP_VERSION",     ac_bump_version,        null]
         ])],
 
@@ -3251,6 +3343,7 @@ function create_gclass(gclass_name)
         ["EV_DELETE_COLUMN",        0],
         ["EV_SAVE_COLUMN",          0],
         ["EV_MOVE_COLUMN",          0],
+        ["EV_UNDO_ORDER",           0],
         ["EV_BUMP_VERSION",         0],
         ["EV_VALIDATE",             0],
         ["EV_EXPORT",               0],