@yuneta/gobj-ui 7.23.161 → 7.23.163

package/README.md

@@ -805,6 +805,75 @@ Searching is a user action, so it crosses the FSM (`EV_SEARCH`) like the rest;
 it used to call `tabulator.setFilter` straight from the DOM handler, where the
 `machine` trace could not see it.
 
+### A hook opens the rows it links
+
+A hook cell shows how many children the row has (`[5675]`). A click on it
+opens the **child topic's table, filtered** to the rows whose fkey names this
+row (since `7.23.162`). Above the table, a chip says which filter is on,
+"filtered by device_types electric_bt", and its ✕ brings the whole topic back.
+
+The child table already pages, searches, opens a record and exports. Until
+`7.23.162` the click opened a popup that listed every child id instead:
+5,675 rows in a box with no height, no scroll and no way to close it but a
+click inside, and the ids did nothing.
+
+- The child topic and its fkey come from the hook's own mapping in the
+  schema, `{child_topic: fkey_col}`:
+
+  ```c
+  'devices': {
+      'header': 'Equipos',
+      'type': 'object',
+      'flag': ['hook'],
+      'hook': {
+          'devices': 'place'
+      }
+  }
+  ```
+
+  A click on this hook opens `devices`, filtered to the rows whose `place`
+  names the clicked row.
+- A hook whose children live in more than one topic asks which one, in the
+  standardized dialog (Escape, Back and a click outside close it).
+- The switch goes through the same entry point as a tab click, so the host
+  puts it in the URL and Back returns to the topic the hook was on. The
+  filter itself is not in the URL.
+- The parent filter and the search box are **one** filter. Tabulator's
+  `setFilter()` replaces every programmatic filter, so as two filters each
+  would wipe the other.
+- A child row matches when its fkey names the parent id, and also its topic
+  and hook when the ref carries them: one row can hang from the same parent
+  through two hooks.
+- The filter works on the rows the table holds. With `with_remote_paging`
+  that is one page, which is one more reason that flag stays off.
+
+The table asks its host to switch, because the tabs belong to the host:
+
+```
+C_YUI_TREEDB_TOPIC_WITH_FORM                      C_YUI_TREEDB_TOPICS
+  EV_OPEN_LINKED {topic_name: "devices", fkey: "place",
+                  parent_topic: "places", parent_id: "es", hook: "devices"}  ──►
+                                          select the tab of `devices`
+  EV_FILTER_BY_PARENT {fkey, parent_topic, parent_id, hook}  ◄──  to that topic's table
+```
+
+`EV_CLEAR_PARENT_FILTER` is the ✕, and `EV_CHOOSE_LINKED` is a pick in the
+"which topic" dialog. All three are input events; `EV_OPEN_LINKED` is the one
+output event, and `C_YUI_TREEDB_TOPICS` declares it.
+
+**The table loads a hook as its count** (since `7.23.163`). Its three loads
+ask with `hook_size`, so a hook arrives as `[{"size": N}]` and not as the ids
+of its children, which nothing in the table reads any more:
+
+```js
+const TABLE_READ_OPTIONS = {list_dict: true, hook_size: true};
+```
+
+The node events still carry whole hooks, so after a live update a row can
+hold the list again; the cell and a delete's question count either shape. The
+search box no longer finds a parent row by the id of one of its children: to
+find what hangs from a row, click its hook.
+
 ### Read-only treedbs: `readonly`
 
 `C_YUI_TREEDB_TOPICS` and `C_YUI_TREEDB_GRAPH` take a **`readonly`** attr; the

package/dist/gobj-ui.cjs.js

@@ -23057,6 +23057,10 @@ function nodes_answer(data) {
 *              Constants
 ***************************************************************/
 var GCLASS_NAME$6 = "C_YUI_TREEDB_TOPICS";
+var TABLE_READ_OPTIONS = {
+	list_dict: true,
+	hook_size: true
+};
 /***************************************************************
 *              Data
 ***************************************************************/
@@ -24089,7 +24093,7 @@ function get_nodes$1(gobj, topic_name) {
 	subscribe_treedb$1(gobj, topic_name);
 	let gobj_topic_form = get_gobj_formtable(gobj, topic_name);
 	if (gobj_topic_form && (0, _yuneta_gobj_js.gobj_read_bool_attr)(gobj_topic_form, "with_remote_paging")) return;
-	treedb_nodes$1(gobj, treedb_name, topic_name, { list_dict: true });
+	treedb_nodes$1(gobj, treedb_name, topic_name, Object.assign({}, TABLE_READ_OPTIONS));
 }
 /************************************************************
 *
@@ -24672,7 +24676,7 @@ function ac_request_page(gobj, event, kw, src) {
 		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: a page request with no topic or no id`);
 		return -1;
 	}
-	if (treedb_nodes$1(gobj, (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "treedb_name"), topic_name, { list_dict: true }, {
+	if (treedb_nodes$1(gobj, (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "treedb_name"), topic_name, Object.assign({}, TABLE_READ_OPTIONS), {
 		from: kw.from,
 		limit: kw.limit,
 		req_id: kw.req_id
@@ -24683,6 +24687,36 @@ function ac_request_page(gobj, event, kw, src) {
 	return 0;
 }
 /********************************************
+*  Event from formtable: open the records a hook of one row links --
+*  the CHILD topic's table, filtered to the rows whose fkey names that
+*  row. A hook is the question "which records hang from this one", and
+*  the child's table is where that answer can be read: it pages, it
+*  searches, it opens a record and it exports -- which a list of ids in
+*  a popup could not do past a few dozen of them.
+*  {
+*      topic_name:     the child topic
+*      fkey:           its fkey column that points back
+*      parent_topic:   the topic of the row the hook is on
+*      parent_id:      that row's id
+*      hook:           the hook column
+*  }
+********************************************/
+function ac_open_linked(gobj, event, kw, src) {
+	let child = get_gobj_formtable(gobj, kw.topic_name);
+	if (!child) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: cannot open '${kw.topic_name}', linked from '${kw.parent_topic}^${kw.parent_id}': that topic is not in this view`);
+		return -1;
+	}
+	select_topic_by_id(gobj, (0, _yuneta_gobj_js.gobj_name)(child));
+	(0, _yuneta_gobj_js.gobj_send_event)(child, "EV_FILTER_BY_PARENT", {
+		fkey: kw.fkey,
+		parent_topic: kw.parent_topic,
+		parent_id: kw.parent_id,
+		hook: kw.hook
+	}, gobj);
+	return 0;
+}
+/********************************************
 *  Event from formtable: the bytes of one asset a `file` column names,
 *  for the form's preview or the table's file popup.
 *
@@ -24796,7 +24830,8 @@ function ac_refresh_topic(gobj, event, kw, src) {
 		(0, _yuneta_gobj_js.gobj_send_event)(gobj_topic_form, "EV_REPULL_PAGE", {}, gobj);
 		return 0;
 	}
-	treedb_nodes$1(gobj, (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "treedb_name"), kw.topic_name, { list_dict: true });
+	let options = Object.assign({}, TABLE_READ_OPTIONS);
+	treedb_nodes$1(gobj, (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "treedb_name"), kw.topic_name, options);
 	return 0;
 }
 /********************************************
@@ -24915,6 +24950,11 @@ function create_gclass$6(gclass_name) {
 			ac_request_asset,
 			null
 		],
+		[
+			"EV_OPEN_LINKED",
+			ac_open_linked,
+			null
+		],
 		[
 			"EV_DELETE_RECORD",
 			ac_delete_record,
@@ -24996,6 +25036,7 @@ function create_gclass$6(gclass_name) {
 		["EV_UPDATE_FIELD", 0],
 		["EV_REQUEST_PAGE", 0],
 		["EV_REQUEST_ASSET", 0],
+		["EV_OPEN_LINKED", 0],
 		["EV_DELETE_RECORD", 0],
 		["EV_RECORD_WRITTEN", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT | _yuneta_gobj_js.event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_REFRESH_TOPIC", 0],
@@ -25660,6 +25701,7 @@ function plan_treedb_writes(flags) {
 *  How many things a hook/fkey value holds.
 ***************************************************************/
 function ref_count(value) {
+	if (Array.isArray(value) && value.length === 1 && value[0] && typeof value[0] === "object" && typeof value[0].size === "number") return value[0].size;
 	if (Array.isArray(value)) return value.length;
 	if (value && typeof value === "object") return Object.keys(value).length;
 	if (typeof value === "string" && value.length > 0) return 1;
@@ -25806,7 +25848,11 @@ var PRIVATE_DATA$5 = {
 	cell_file_modal: null,
 	cell_file_win: null,
 	_pending_assets: null,
-	_asset_seq: 0
+	_asset_seq: 0,
+	parent_filter: null,
+	search_term: "",
+	$parent_filter: null,
+	hook_choice_modal: null
 };
 var __gclass__$5 = null;
 function is_mobile$1() {
@@ -25940,6 +25986,7 @@ function mt_stop$5(gobj) {
 	close_schema_dialog(gobj);
 	close_cell_json_dialog(gobj);
 	close_cell_file_dialog(gobj);
+	close_hook_choice(gobj);
 	drop_pending_assets(gobj);
 	table__destroy(gobj);
 }
@@ -25951,6 +25998,7 @@ function mt_destroy$5(gobj) {
 	close_schema_dialog(gobj);
 	close_cell_json_dialog(gobj);
 	close_cell_file_dialog(gobj);
+	close_hook_choice(gobj);
 	drop_pending_assets(gobj);
 	destroy_ui$2(gobj);
 }
@@ -26310,6 +26358,50 @@ function build_ui$5(gobj) {
 		bar.$el.style.flex = "none";
 		$container.insertBefore(bar.$el, $container.querySelector(`#${table_id}`));
 	}
+	let $parent_filter = (0, _yuneta_gobj_js.createElement2)([
+		"div",
+		{
+			class: "TREEDB_PARENT_FILTER is-hidden",
+			style: "flex:none;"
+		},
+		[
+			[
+				"span",
+				{
+					class: "PARENT_FILTER_LABEL",
+					i18n: "filtered by"
+				},
+				"filtered by"
+			],
+			[
+				"span",
+				{ class: "PARENT_FILTER_TOPIC" },
+				""
+			],
+			[
+				"strong",
+				{ class: "PARENT_FILTER_ID" },
+				""
+			],
+			[
+				"button",
+				{
+					class: "delete PARENT_FILTER_CLEAR",
+					type: "button",
+					title: (0, i18next.t)("clear filter"),
+					"data-i18n-title": "clear filter",
+					"aria-label": (0, i18next.t)("clear filter"),
+					"data-i18n-aria-label": "clear filter"
+				},
+				[],
+				{ click: () => {
+					(0, _yuneta_gobj_js.gobj_send_event)(gobj, "EV_CLEAR_PARENT_FILTER", {}, gobj);
+				} }
+			]
+		]
+	]);
+	gobj.priv.$parent_filter = $parent_filter;
+	$container.insertBefore($parent_filter, $container.querySelector(`#${table_id}`));
 	let $toolbar_slot = $container.querySelector(".toolbar_tabulator_table");
 	if ($table_toolbar instanceof Element) $toolbar_slot.appendChild($table_toolbar);
 	else $toolbar_slot.appendChild((0, _yuneta_gobj_js.createElement2)(["div", {}]));
@@ -26802,6 +26894,7 @@ function create_tabulator(gobj) {
 		yui_tabulator_name_filters(tabulator, i18next.t);
 		yui_tabulator_name_row_selects(tabulator, i18next.t);
 		tabulator._ready = true;
+		apply_row_filters(gobj);
 		update_rowcount();
 		yui_table_filter_clear(tabulator);
 		if (tabulator._pendingData !== void 0) {
@@ -27009,15 +27102,18 @@ function transform__treedb_value_2_table_value(gobj, col, value, row, field) {
 			break;
 		case "hook":
 			let items = (0, _yuneta_gobj_js.treedb_hook_data_size)(value);
-			if (items > 0) value = [
-				"<a class=\"hook_cell\" ",
-				`data-row_id="${row.id}" `,
-				`data-col_id="${col.id}" > `,
-				"<span style=\"\" class=\"icon yi-eye\"></span>",
-				`<span>[&nbsp;<u>${items}</u>&nbsp;]</span>`,
-				"</a>"
-			].join("");
-			else value = "";
+			if (items > 0) {
+				let hook_title = String((0, i18next.t)("show linked records")).replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+				value = [
+					"<a class=\"hook_cell\" ",
+					`title="${hook_title}" aria-label="${hook_title}" `,
+					`data-row_id="${row.id}" `,
+					`data-col_id="${col.id}" > `,
+					"<span style=\"\" class=\"icon yi-eye\"></span>",
+					`<span>[&nbsp;<u>${items}</u>&nbsp;]</span>`,
+					"</a>"
+				].join("");
+			} else value = "";
 			break;
 		case "file":
 		case "fkey":
@@ -27652,6 +27748,153 @@ function close_cell_file_dialog(gobj) {
 	teardown_cell_file(gobj);
 }
 /************************************************************
+*  Ask the host to open the rows of `topic_name` whose `fkey`
+*  names this row -- what a hook of this row links.
+************************************************************/
+function publish_open_linked(gobj, topic_name, fkey, parent_id, hook) {
+	(0, _yuneta_gobj_js.gobj_publish_event)(gobj, "EV_OPEN_LINKED", {
+		topic_name,
+		fkey,
+		parent_topic: (0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "topic_name"),
+		parent_id,
+		hook
+	});
+}
+/************************************************************
+*  "Which child topic?" -- for a hook whose children live in
+*  more than one. The standardized dialog, so Escape, Back and
+*  a click outside close it like every other one.
+************************************************************/
+function open_hook_choice_dialog(gobj, targets, parent_id, hook) {
+	close_hook_choice(gobj);
+	let priv = gobj.priv;
+	let shell = yui_shell_of(gobj);
+	if (!shell) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: no shell, cannot ask which topic to open`);
+		return;
+	}
+	priv.hook_choice_modal = yui_shell_show_modal(shell, (0, _yuneta_gobj_js.createElement2)([
+		"div",
+		{ class: "TREEDB_HOOK_CHOICE" },
+		targets.map((tg) => {
+			return [
+				"button",
+				{
+					class: "button HOOK_CHOICE_TOPIC",
+					type: "button",
+					title: (0, i18next.t)(tg.topic_name),
+					"data-i18n-title": tg.topic_name,
+					"aria-label": (0, i18next.t)(tg.topic_name),
+					"data-i18n-aria-label": tg.topic_name
+				},
+				[[
+					"span",
+					{ i18n: tg.topic_name },
+					tg.topic_name
+				]],
+				{ click: () => {
+					(0, _yuneta_gobj_js.gobj_send_event)(gobj, "EV_CHOOSE_LINKED", {
+						topic_name: tg.topic_name,
+						fkey: tg.fkey,
+						parent_id,
+						hook
+					}, gobj);
+				} }
+			];
+		})
+	]), {
+		dialog: true,
+		logical_class: "TREEDB_HOOK_CHOICE_SHEET",
+		title: "choose a topic",
+		t: i18next.t,
+		on_close: function() {
+			priv.hook_choice_modal = null;
+		}
+	});
+}
+/************************************************************
+*  Close "which child topic?" if it is open.
+************************************************************/
+function close_hook_choice(gobj) {
+	let priv = gobj.priv;
+	if (priv.hook_choice_modal) {
+		let modal = priv.hook_choice_modal;
+		priv.hook_choice_modal = null;
+		modal.close();
+	}
+}
+/************************************************************
+*  Does this row's `pf.fkey` name the parent record? The fkey
+*  arrives as one ref, a list of them or a dict keyed by ref,
+*  each in any of the shapes treedb_decoder_fkey() reads. The
+*  topic and the hook are compared when the ref carries them:
+*  one row can hang from the same parent through two hooks.
+************************************************************/
+function row_links_to(gobj, data, pf) {
+	let col = get_schema_col(gobj, pf.fkey);
+	let v = data ? data[pf.fkey] : null;
+	if (!col || v === null || v === void 0 || v === "") return false;
+	let refs;
+	if ((0, _yuneta_gobj_js.is_array)(v)) refs = v;
+	else if ((0, _yuneta_gobj_js.is_object)(v) && v.id === void 0) refs = Object.keys(v);
+	else refs = [v];
+	for (let ref of refs) {
+		if (ref === null || ref === void 0 || ref === "") continue;
+		let fk = (0, _yuneta_gobj_js.treedb_decoder_fkey)(col, ref);
+		if (!fk || String(fk.id) !== pf.parent_id) continue;
+		if (fk.topic_name && pf.parent_topic && fk.topic_name !== pf.parent_topic) continue;
+		if (fk.hook_name && pf.hook && fk.hook_name !== pf.hook) continue;
+		return true;
+	}
+	return false;
+}
+/************************************************************
+*  The ONE programmatic filter of the table: the parent filter
+*  AND the search term. Kept as state and applied here, because
+*  Tabulator's setFilter() replaces every programmatic filter.
+*  Before `tableBuilt` the state waits; tableBuilt applies it.
+************************************************************/
+function apply_row_filters(gobj) {
+	let priv = gobj.priv;
+	let tabulator = (0, _yuneta_gobj_js.gobj_read_attr)(gobj, "tabulator");
+	if (!tabulator) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: no table to filter`);
+		return;
+	}
+	if (!tabulator._ready) return;
+	let term = priv.search_term || "";
+	let pf = priv.parent_filter;
+	if (!term && !pf) {
+		tabulator.clearFilter();
+		return;
+	}
+	tabulator.setFilter(function(data) {
+		if (pf && !row_links_to(gobj, data, pf)) return false;
+		return !term || row_matches(data, term);
+	});
+}
+/************************************************************
+*  Show or hide the chip that says the parent filter is on.
+************************************************************/
+function render_parent_filter(gobj) {
+	let priv = gobj.priv;
+	let $chip = priv.$parent_filter;
+	if (!$chip) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: no parent-filter chip to paint`);
+		return;
+	}
+	let pf = priv.parent_filter;
+	if (!pf) {
+		$chip.classList.add("is-hidden");
+		return;
+	}
+	let $topic = $chip.querySelector(".PARENT_FILTER_TOPIC");
+	$topic.setAttribute("data-i18n", pf.parent_topic);
+	$topic.textContent = (0, i18next.t)(pf.parent_topic);
+	$chip.querySelector(".PARENT_FILTER_ID").textContent = pf.parent_id;
+	$chip.classList.remove("is-hidden");
+}
+/************************************************************
 *  True if the topic's pkey col carries the "rowid" flag.
 ************************************************************/
 function pkey_is_rowid(gobj) {
@@ -27908,74 +28151,6 @@ function build_fkey_ref(gobj, col, value) {
 	}
 	return refs;
 }
-/***************************************************************************
-*  TODO con límite máximo o máximo height o con scroll
-*      en un gobj propio para gestionar los datos en "page"s
-*      que los hook no vengan rellenos si son muchos y que se puedan gestionar
-*      con un gobj
-***************************************************************************/
-function show_dropdown_popup_menu(gobj, x, y, items, callback) {
-	let $element = (0, _yuneta_gobj_js.createElement2)([
-		"div",
-		{ class: "dropdown popup" },
-		[[
-			"div",
-			{
-				class: "dropdown-menu",
-				role: "menu",
-				style: "min-width:4rem; border: 2px solid var(--bulma-border); padding: 0px;"
-			},
-			[[
-				"div",
-				{
-					class: "dropdown-content",
-					style: "padding: 0;"
-				},
-				[]
-			]]
-		]],
-		{ "click": (evt) => {
-			evt.stopPropagation();
-			destroyModal();
-			if (callback) callback(evt);
-		} }
-	]);
-	const destroyModal = () => {
-		$element.classList.remove("is-active");
-		$element.parentNode.removeChild($element);
-	};
-	let $dropdown_content = $element.querySelector(".dropdown-content");
-	let ids = (0, _yuneta_gobj_js.kwid_get_ids)(gobj, items);
-	for (let id of ids) {
-		let $item = (0, _yuneta_gobj_js.createElement2)([
-			"a",
-			{
-				class: "dropdown-item flex-horizontal-section",
-				"data-value": `${id}`,
-				style: "margin:0px;"
-			},
-			[[
-				"span",
-				{ i18n: `${id}` },
-				`${id}`
-			]],
-			{ "click": (evt) => {
-				evt.stopPropagation();
-				destroyModal();
-				if (callback) callback(evt, this.dataset.value);
-			} }
-		]);
-		$dropdown_content.appendChild($item);
-	}
-	(0, _yuneta_gobj_js.refresh_language)($element, i18next.t);
-	popup_mount_layer(gobj).appendChild($element);
-	$element.style.position = "absolute";
-	$element.style.top = y + "px";
-	$element.style.left = x + "px";
-	$element.classList.add("is-active");
-	let $with_focus = $element.querySelector(".with-focus");
-	if ($with_focus) $with_focus.focus();
-}
 /***************************************************************
 *  A read-only topic refuses the write EVENTS too, not only their
 *  buttons. The buttons are gone, but an event can still arrive: a
@@ -28415,12 +28590,69 @@ function ac_change_locale(gobj, event, kw, src) {
 *  };
 ************************************************************/
 function ac_show_hook_data$1(gobj, event, kw, src) {
-	let webix = (0, _yuneta_gobj_js.gobj_command)((0, _yuneta_gobj_js.gobj_parent)(gobj), "get_topic_data", kw, gobj);
-	let row = (0, _yuneta_gobj_js.kwid_find_one_record)(gobj, webix.data, kw.row_id, null);
-	if (row) {
-		let cell = row[kw.col_id];
-		show_dropdown_popup_menu(gobj, kw.click_x, kw.click_y, cell);
+	let col = get_schema_col(gobj, kw.col_id);
+	let hook = col && (0, _yuneta_gobj_js.is_object)(col.hook) ? col.hook : null;
+	if (!hook || kw.row_id === void 0 || kw.row_id === null) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: hook '${kw.col_id}' names no child topic to open`);
+		return -1;
+	}
+	let targets = Object.keys(hook).map((topic) => {
+		return {
+			topic_name: topic,
+			fkey: hook[topic]
+		};
+	});
+	if (targets.length === 1) {
+		publish_open_linked(gobj, targets[0].topic_name, targets[0].fkey, String(kw.row_id), kw.col_id);
+		return 0;
+	}
+	open_hook_choice_dialog(gobj, targets, String(kw.row_id), kw.col_id);
+	return 0;
+}
+/************************************************************
+*  A hook with several child topics: pick one.
+*  {topic_name, fkey, parent_id, hook}
+************************************************************/
+function ac_choose_linked(gobj, event, kw, src) {
+	close_hook_choice(gobj);
+	publish_open_linked(gobj, kw.topic_name, kw.fkey, kw.parent_id, kw.hook);
+	return 0;
+}
+/************************************************************
+*  Show only the rows linked to one record of another topic.
+*  Sent by the host when a hook of that record was clicked.
+*  {fkey, parent_topic, parent_id, hook}
+*
+*  Over the rows the table HOLDS: with `with_remote_paging` that
+*  is one page, which is one of the reasons that flag stays off.
+************************************************************/
+function ac_filter_by_parent(gobj, event, kw, src) {
+	let priv = gobj.priv;
+	if (!kw || !kw.fkey || kw.parent_id === void 0 || kw.parent_id === null) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: a parent filter with no fkey or no parent`);
+		return -1;
+	}
+	if (!get_schema_col(gobj, kw.fkey)) {
+		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: parent filter on '${kw.fkey}', which is not a column of '${(0, _yuneta_gobj_js.gobj_read_str_attr)(gobj, "topic_name")}'`);
+		return -1;
 	}
+	priv.parent_filter = {
+		fkey: kw.fkey,
+		parent_topic: kw.parent_topic || "",
+		parent_id: String(kw.parent_id),
+		hook: kw.hook || ""
+	};
+	render_parent_filter(gobj);
+	apply_row_filters(gobj);
+	return 0;
+}
+/************************************************************
+*  The ✕ of the parent filter: back to the whole topic.
+************************************************************/
+function ac_clear_parent_filter(gobj, event, kw, src) {
+	gobj.priv.parent_filter = null;
+	render_parent_filter(gobj);
+	apply_row_filters(gobj);
 	return 0;
 }
 /************************************************************
@@ -28731,19 +28963,12 @@ function ac_page_timeout(gobj, event, kw, src) {
 *  cleared search box does not silently undo them.
 ************************************************************/
 function ac_search(gobj, event, kw, src) {
-	let tabulator = (0, _yuneta_gobj_js.gobj_read_attr)(gobj, "tabulator");
-	if (!tabulator) {
+	if (!(0, _yuneta_gobj_js.gobj_read_attr)(gobj, "tabulator")) {
 		(0, _yuneta_gobj_js.log_error)(`${(0, _yuneta_gobj_js.gobj_short_name)(gobj)}: no table to search`);
 		return -1;
 	}
-	let term = (kw && kw.text || "").toLowerCase();
-	if (!term) {
-		tabulator.clearFilter();
-		return 0;
-	}
-	tabulator.setFilter(function(data) {
-		return row_matches(data, term);
-	});
+	gobj.priv.search_term = (kw && kw.text || "").toLowerCase();
+	apply_row_filters(gobj);
 	return 0;
 }
 /************************************************************
@@ -28991,6 +29216,21 @@ function create_gclass$5(gclass_name) {
 			ac_show_hook_data$1,
 			null
 		],
+		[
+			"EV_CHOOSE_LINKED",
+			ac_choose_linked,
+			null
+		],
+		[
+			"EV_FILTER_BY_PARENT",
+			ac_filter_by_parent,
+			null
+		],
+		[
+			"EV_CLEAR_PARENT_FILTER",
+			ac_clear_parent_filter,
+			null
+		],
 		[
 			"EV_SHOW_CELL_JSON",
 			ac_show_cell_json,
@@ -29109,7 +29349,11 @@ function create_gclass$5(gclass_name) {
 		["EV_CLEAR_SELECTION", 0],
 		["EV_SELECT_ROWS", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_UNSELECT_ROWS", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT],
-		["EV_SHOW_HOOK_DATA", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT],
+		["EV_SHOW_HOOK_DATA", 0],
+		["EV_CHOOSE_LINKED", 0],
+		["EV_FILTER_BY_PARENT", 0],
+		["EV_CLEAR_PARENT_FILTER", 0],
+		["EV_OPEN_LINKED", _yuneta_gobj_js.event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_SHOW_CELL_JSON", 0],
 		["EV_SHOW_CELL_FILE", 0],
 		["EV_ASSET_LOADED", 0],