@yuneta/gobj-ui 7.0.1 → 7.2.0

package/dist/gobj-ui.es.js

@@ -11012,7 +11012,7 @@ function ac_expand_collapsed(gobj, event, kw, src) {
 /************************************************************
 *   EV_SEARCH { text }
 ************************************************************/
-function ac_search(gobj, event, kw, src) {
+function ac_search$1(gobj, event, kw, src) {
 	let priv = gobj.priv;
 	priv.search = (kw.text || "").trim().toLowerCase();
 	render_tree(gobj);
@@ -11161,7 +11161,7 @@ function create_gclass$10(gclass_name) {
 		],
 		[
 			"EV_SEARCH",
-			ac_search,
+			ac_search$1,
 			null
 		],
 		[
@@ -16217,6 +16217,9 @@ var attrs_table$5 = [
 	SDATA(data_type_t.DTP_BOOLEAN, "with_refresh_button", 0, true, "Button toolbar REFRESH"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_search_button", 0, true, "Button toolbar SEARCH"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_schema_button", 0, true, "Button toolbar SCHEMA (show the topic's desc)"),
+	SDATA(data_type_t.DTP_BOOLEAN, "with_columns_button", 0, true, "Button toolbar COLUMNS (choose which columns the table shows)"),
+	SDATA(data_type_t.DTP_BOOLEAN, "with_export_button", 0, true, "Button toolbar EXPORT (download as CSV what the table holds)"),
+	SDATA(data_type_t.DTP_BOOLEAN, "with_header_filters", 0, true, "Per-column filter box in the table header, on the columns a text/number match means something (not hooks, fkeys or json)"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_in_row_edit_icons", 0, true, "Add a last column with internal EDIT/DELETE icon"),
 	SDATA(data_type_t.DTP_BOOLEAN, "editable", 0, false, "Edit state"),
 	SDATA(data_type_t.DTP_BOOLEAN, "with_checkbox", 0, true, "Auxiliary first column to select rows"),
@@ -16509,6 +16512,8 @@ function build_ui$5(gobj) {
 	let with_refresh_button = gobj_read_bool_attr(gobj, "with_refresh_button");
 	let with_search_button = gobj_read_bool_attr(gobj, "with_search_button");
 	let with_schema_button = gobj_read_bool_attr(gobj, "with_schema_button");
+	let with_columns_button = gobj_read_bool_attr(gobj, "with_columns_button");
+	let with_export_button = gobj_read_bool_attr(gobj, "with_export_button");
 	if (with_search_button) {
 		let search_id = `${toolbar_id}_search`;
 		let $search_box = createElement2([
@@ -16529,17 +16534,7 @@ function build_ui$5(gobj) {
 		let $search_input = $search_box.querySelector(`#${search_id}`);
 		attach_clear($search_box, $search_input);
 		if ($search_input) $search_input.addEventListener("input", (event) => {
-			let searchText = event.target.value.trim().toLowerCase();
-			let tabulator = gobj_read_attr(gobj, "tabulator");
-			if (!tabulator) return;
-			if (searchText) tabulator.setFilter(function(data) {
-				return Object.entries(data).some(([key, val]) => {
-					if (key.startsWith("_")) return false;
-					if (val === null || val === void 0) return false;
-					return String(val).toLowerCase().includes(searchText);
-				});
-			});
-			else tabulator.clearFilter();
+			gobj_send_event(gobj, "EV_SEARCH", { text: event.target.value.trim() }, gobj);
 		});
 		$view_toolbar.appendChild($search_box);
 	}
@@ -16593,6 +16588,58 @@ function build_ui$5(gobj) {
 		]);
 		$view_toolbar.appendChild($schema);
 	}
+	if (with_columns_button) {
+		let $columns = createElement2([
+			"button",
+			{
+				class: "TREEDB_TABLE_COLUMNS button mr-1",
+				title: t("choose the columns to show"),
+				"data-i18n-title": "choose the columns to show",
+				"aria-label": t("columns"),
+				"data-i18n-aria-label": "columns"
+			},
+			[["i", { class: "yi-table" }], [
+				"span",
+				{
+					class: "is-hidden-mobile",
+					i18n: "columns",
+					style: "padding-left:5px;"
+				},
+				"columns"
+			]],
+			{ "click": (event) => {
+				event.stopPropagation();
+				gobj_send_event(gobj, "EV_OPEN_COLUMNS", {}, gobj);
+			} }
+		]);
+		$view_toolbar.appendChild($columns);
+	}
+	if (with_export_button) {
+		let $export = createElement2([
+			"button",
+			{
+				class: "TREEDB_TABLE_EXPORT button mr-1",
+				title: t("download the rows loaded in this table as csv"),
+				"data-i18n-title": "download the rows loaded in this table as csv",
+				"aria-label": t("export"),
+				"data-i18n-aria-label": "export"
+			},
+			[["i", { class: "yi-download" }], [
+				"span",
+				{
+					class: "is-hidden-mobile",
+					i18n: "export",
+					style: "padding-left:5px;"
+				},
+				"export"
+			]],
+			{ "click": (event) => {
+				event.stopPropagation();
+				gobj_send_event(gobj, "EV_EXPORT_TABLE", {}, gobj);
+			} }
+		]);
+		$view_toolbar.appendChild($export);
+	}
 	let table_id = gobj_read_str_attr(gobj, "table_id");
 	let $container = createElement2([
 		"div",
@@ -16681,6 +16728,7 @@ function col_title_formatter(gobj, col) {
 function create_tabulator(gobj) {
 	let table_id = gobj_read_str_attr(gobj, "table_id");
 	let desc = gobj_read_attr(gobj, "desc");
+	let with_header_filters = gobj_read_bool_attr(gobj, "with_header_filters");
 	let columns = [];
 	let with_checkbox = gobj_read_bool_attr(gobj, "with_checkbox");
 	let with_radio = gobj_read_bool_attr(gobj, "with_radio");
@@ -16724,6 +16772,46 @@ function create_tabulator(gobj) {
 			col_id: cell.getField()
 		}, gobj);
 	}
+	const FILTERABLE = [
+		"string",
+		"integer",
+		"real",
+		"rowid",
+		"uuid",
+		"qualified",
+		"email",
+		"url",
+		"tel",
+		"id",
+		"hex",
+		"currency",
+		"percent"
+	];
+	function fkey_matches(term, value) {
+		if (term === "" || term === null || term === void 0) return true;
+		if (value === null || value === void 0) return false;
+		return (typeof value === "string" ? value : JSON.stringify(value)).toLowerCase().includes(String(term).toLowerCase());
+	}
+	function apply_header_filter(colDef, field_desc) {
+		switch (field_desc.type) {
+			case "boolean":
+				colDef.headerFilter = "tickCross";
+				colDef.headerFilterParams = { tristate: true };
+				break;
+			case "enum":
+				colDef.headerFilter = "list";
+				colDef.headerFilterParams = {
+					values: field_desc.enum_list || [],
+					clearable: true
+				};
+				break;
+			case "fkey":
+				colDef.headerFilter = "input";
+				colDef.headerFilterFunc = fkey_matches;
+				break;
+			default: if (FILTERABLE.includes(field_desc.type)) colDef.headerFilter = "input";
+		}
+	}
 	for (let i = 0; i < desc.cols.length; i++) {
 		let col = desc.cols[i];
 		if (!col.id || col.id[0] === "_") continue;
@@ -16804,6 +16892,7 @@ function create_tabulator(gobj) {
 			hozAlign,
 			formatter: colFormatter
 		};
+		if (with_header_filters) apply_header_filter(colDef, field_desc);
 		if (vertAlign) colDef.vertAlign = vertAlign;
 		if (formatterParams) colDef.formatterParams = formatterParams;
 		if (cellClick) colDef.cellClick = cellClick;
@@ -18013,6 +18102,125 @@ function ac_show_schema(gobj, event, kw, src) {
 	return 0;
 }
 /************************************************************
+*  Filter the loaded rows by a term matched against every non-internal
+*  field. `clearFilter()` with no argument drops only THIS filter: the
+*  per-column header filters are a separate layer and survive, so a
+*  cleared search box does not silently undo them.
+************************************************************/
+function ac_search(gobj, event, kw, src) {
+	let tabulator = gobj_read_attr(gobj, "tabulator");
+	if (!tabulator) {
+		log_error(`${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 Object.entries(data).some(([key, val]) => {
+			if (key.startsWith("_")) return false;
+			if (val === null || val === void 0) return false;
+			return String(val).toLowerCase().includes(term);
+		});
+	});
+	return 0;
+}
+/************************************************************
+*  Which columns the table shows: one checkbox per column, the current
+*  visibility ticked. The internal columns (`_check_box_state_`,
+*  `_operation`) are not offered — they are chrome, not data.
+************************************************************/
+function ac_open_columns(gobj, event, kw, src) {
+	let tabulator = gobj_read_attr(gobj, "tabulator");
+	if (!tabulator) {
+		log_error(`${gobj_short_name(gobj)}: no table, no columns to choose`);
+		return -1;
+	}
+	let shell = yui_shell_of(gobj);
+	if (!shell) {
+		log_error(`${gobj_short_name(gobj)}: no shell, cannot open the column chooser`);
+		return -1;
+	}
+	let $list = createElement2(["div", { class: "TREEDB_COLUMNS_LIST" }]);
+	let columns = tabulator.getColumns();
+	for (let i = 0; i < columns.length; i++) {
+		let column = columns[i];
+		let field = column.getField();
+		if (!field || field[0] === "_") continue;
+		let $cb = createElement2(["input", {
+			type: "checkbox",
+			class: "mr-2"
+		}]);
+		$cb.checked = column.isVisible();
+		$cb.addEventListener("change", () => {
+			gobj_send_event(gobj, "EV_TOGGLE_COLUMN", {
+				field,
+				visible: $cb.checked
+			}, gobj);
+		});
+		$list.appendChild(createElement2([
+			"label",
+			{ class: "checkbox is-block mb-1 TREEDB_COLUMN_ITEM" },
+			[$cb, [
+				"span",
+				{ class: "ml-2" },
+				column.getDefinition().title || field
+			]]
+		]));
+	}
+	yui_shell_show_modal(shell, $list, {
+		dialog: true,
+		logical_class: "TREEDB_COLUMNS_DIALOG",
+		title_prefix: gobj_read_str_attr(gobj, "topic_name"),
+		title: "columns",
+		t
+	});
+	return 0;
+}
+/************************************************************
+*  Show / hide one column.
+************************************************************/
+function ac_toggle_column(gobj, event, kw, src) {
+	let tabulator = gobj_read_attr(gobj, "tabulator");
+	let field = kw && kw.field || "";
+	if (!tabulator || !field) {
+		log_error(`${gobj_short_name(gobj)}: no column '${field}' to toggle`);
+		return -1;
+	}
+	try {
+		if (kw.visible) tabulator.showColumn(field);
+		else tabulator.hideColumn(field);
+	} catch (e) {
+		log_error(`${gobj_short_name(gobj)}: cannot toggle column '${field}': ${e}`);
+		return -1;
+	}
+	return 0;
+}
+/************************************************************
+*  Download what the table HOLDS as CSV: the loaded rows, the visible
+*  columns, search and header filters applied — which is what the reader
+*  is looking at. Not the topic: a server-side dump of every node is not
+*  something this view can stream.
+************************************************************/
+function ac_export_table(gobj, event, kw, src) {
+	let tabulator = gobj_read_attr(gobj, "tabulator");
+	if (!tabulator) {
+		log_error(`${gobj_short_name(gobj)}: no table to export`);
+		return -1;
+	}
+	let name = `${gobj_read_str_attr(gobj, "treedb_name")}-${gobj_read_str_attr(gobj, "topic_name")}.csv`;
+	name = name.replace(/[^\w.\-]+/g, "_");
+	try {
+		tabulator.download("csv", name);
+	} catch (e) {
+		log_error(`${gobj_short_name(gobj)}: CSV export failed: ${e}`);
+		return -1;
+	}
+	return 0;
+}
+/************************************************************
 *  {
 *      href: href
 *  }
@@ -18136,6 +18344,26 @@ function create_gclass$5(gclass_name) {
 			ac_show_schema,
 			null
 		],
+		[
+			"EV_SEARCH",
+			ac_search,
+			null
+		],
+		[
+			"EV_OPEN_COLUMNS",
+			ac_open_columns,
+			null
+		],
+		[
+			"EV_TOGGLE_COLUMN",
+			ac_toggle_column,
+			null
+		],
+		[
+			"EV_EXPORT_TABLE",
+			ac_export_table,
+			null
+		],
 		[
 			"EV_SHOW",
 			ac_show$4,
@@ -18166,6 +18394,10 @@ function create_gclass$5(gclass_name) {
 		["EV_CHANGE_LOCALE", 0],
 		["EV_REFRESH", 0],
 		["EV_SHOW_SCHEMA", 0],
+		["EV_SEARCH", 0],
+		["EV_OPEN_COLUMNS", 0],
+		["EV_TOGGLE_COLUMN", 0],
+		["EV_EXPORT_TABLE", 0],
 		["EV_CREATE_RECORD", event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_UPDATE_RECORD", event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_DELETE_RECORD", event_flag_t.EVF_OUTPUT_EVENT],
@@ -18527,101 +18759,140 @@ function make_toolbar(gobj) {
 	gobj.priv;
 	let modes = gobj_read_attr(gobj, "operation_modes");
 	if (gobj_read_bool_attr(gobj, "readonly")) modes = modes.filter((mode) => mode !== "edition");
+	let left_items = [
+		[
+			"span",
+			{
+				class: "GRAPH_LAYOUT_LABEL is-hidden-mobile",
+				style: "padding-right:5px;",
+				i18n: "layout"
+			},
+			"layout"
+		],
+		[
+			"div",
+			{ class: "select" },
+			[["select", { class: "GRAPH_LAYOUT_SELECT" }]],
+			{ change: (evt) => {
+				evt.stopPropagation();
+				gobj_send_event(gobj, "EV_SET_LAYOUT", { layout: evt.target.value }, gobj);
+			} }
+		],
+		[
+			"span",
+			{
+				class: "GRAPH_MODE_LABEL is-hidden-mobile",
+				style: "padding-left:10px; padding-right:5px;",
+				i18n: "operation mode"
+			},
+			"operation mode"
+		],
+		[
+			"div",
+			{ class: "select" },
+			[[
+				"select",
+				{ class: "GRAPH_MODE_SELECT" },
+				modes.map((item) => [
+					"option",
+					{},
+					item
+				])
+			]],
+			{ change: (evt) => {
+				evt.stopPropagation();
+				gobj_send_event(gobj, "EV_SET_OPERATION_MODE", { operation_mode: evt.target.value }, gobj);
+			} }
+		],
+		[
+			"button",
+			{ class: "GRAPH_REFRESH button" },
+			[["i", { class: "yi-arrows-rotate" }], [
+				"span",
+				{
+					class: "is-hidden-mobile",
+					style: "padding-left:5px;",
+					i18n: "refresh"
+				},
+				"refresh"
+			]],
+			{ click: (evt) => {
+				evt.stopPropagation();
+				gobj_send_event(gobj, "EV_REFRESH_TREEDB", { evt }, gobj);
+			} }
+		],
+		[
+			"button",
+			{
+				class: "button ml-2 TREEDB_JSON_BTN",
+				title: t("raw json"),
+				"aria-label": t("raw json"),
+				"data-i18n-title": "raw json",
+				"data-i18n-aria-label": "raw json"
+			},
+			[["i", { class: "yi-eye" }], [
+				"span",
+				{
+					class: "is-hidden-mobile",
+					style: "padding-left:5px;",
+					i18n: "raw json"
+				},
+				"raw json"
+			]],
+			{ click: (evt) => {
+				evt.stopPropagation();
+				gobj_send_event(gobj, "EV_OPEN_JSON", {}, gobj);
+			} }
+		]
+	];
+	let center_items = [[
+		"div",
+		{
+			class: "GRAPH_FIND control has-icons-left",
+			style: "margin-right:.5rem; max-width:12rem; min-width:7rem;"
+		},
+		[["input", {
+			class: "GRAPH_FIND_INPUT input",
+			type: "text",
+			placeholder: t("search"),
+			"data-i18n-placeholder": "search",
+			"aria-label": t("search"),
+			"data-i18n-aria-label": "search"
+		}], [
+			"span",
+			{ class: "icon is-left" },
+			[["i", { class: "yi-magnifying-glass" }]]
+		]],
+		{ input: (evt) => {
+			evt.stopPropagation();
+			gobj_send_event(gobj, "EV_FIND_NODES", { text: evt.target.value.trim() }, gobj);
+		} }
+	], [
+		"div",
+		{
+			class: "GRAPH_FIND_RESULT is-hidden is-flex is-align-items-center",
+			style: "gap:.3rem; margin-right:.5rem; font-size:.85rem;"
+		},
+		[[
+			"span",
+			{ class: "GRAPH_FIND_COUNT" },
+			""
+		], [
+			"span",
+			{ i18n: "matches" },
+			"matches"
+		]]
+	]];
 	const $toolbar_header = yui_toolbar({}, [
 		[
 			"div",
 			{ class: "yui-horizontal-toolbar-section left" },
-			[
-				[
-					"span",
-					{
-						class: "GRAPH_LAYOUT_LABEL is-hidden-mobile",
-						style: "padding-right:5px;",
-						i18n: "layout"
-					},
-					"layout"
-				],
-				[
-					"div",
-					{ class: "select" },
-					[["select", { class: "GRAPH_LAYOUT_SELECT" }]],
-					{ change: (evt) => {
-						evt.stopPropagation();
-						gobj_send_event(gobj, "EV_SET_LAYOUT", { layout: evt.target.value }, gobj);
-					} }
-				],
-				[
-					"span",
-					{
-						class: "GRAPH_MODE_LABEL is-hidden-mobile",
-						style: "padding-left:10px; padding-right:5px;",
-						i18n: "operation mode"
-					},
-					"operation mode"
-				],
-				[
-					"div",
-					{ class: "select" },
-					[[
-						"select",
-						{ class: "GRAPH_MODE_SELECT" },
-						modes.map((item) => [
-							"option",
-							{},
-							item
-						])
-					]],
-					{ change: (evt) => {
-						evt.stopPropagation();
-						gobj_send_event(gobj, "EV_SET_OPERATION_MODE", { operation_mode: evt.target.value }, gobj);
-					} }
-				],
-				[
-					"button",
-					{ class: "GRAPH_REFRESH button" },
-					[["i", { class: "yi-arrows-rotate" }], [
-						"span",
-						{
-							class: "is-hidden-mobile",
-							style: "padding-left:5px;",
-							i18n: "refresh"
-						},
-						"refresh"
-					]],
-					{ click: (evt) => {
-						evt.stopPropagation();
-						gobj_send_event(gobj, "EV_REFRESH_TREEDB", { evt }, gobj);
-					} }
-				],
-				[
-					"button",
-					{
-						class: "button ml-2 TREEDB_JSON_BTN",
-						title: t("raw json"),
-						"aria-label": t("raw json"),
-						"data-i18n-title": "raw json",
-						"data-i18n-aria-label": "raw json"
-					},
-					[["i", { class: "yi-eye" }], [
-						"span",
-						{
-							class: "is-hidden-mobile",
-							style: "padding-left:5px;",
-							i18n: "raw json"
-						},
-						"raw json"
-					]],
-					{ click: (evt) => {
-						evt.stopPropagation();
-						gobj_send_event(gobj, "EV_OPEN_JSON", {}, gobj);
-					} }
-				]
-			]
+			left_items
 		],
 		[
 			"div",
 			{ class: "yui-horizontal-toolbar-section center" },
-			[]
+			center_items
 		],
 		[
 			"div",
@@ -19553,6 +19824,33 @@ function ac_set_operation_mode$1(gobj, event, kw, src) {
 *  tree, which centres + highlights that topic's nodes (deferring
 *  until its data is loaded).
 ************************************************************/
+/************************************************************
+*  Forward the find down to the graph child.
+************************************************************/
+function ac_find_nodes$1(gobj, event, kw, src) {
+	let priv = gobj.priv;
+	if (priv.gobj_nodes_tree) gobj_send_event(priv.gobj_nodes_tree, "EV_FIND_NODES", { text: kw && kw.text || "" }, gobj);
+	return 0;
+}
+/************************************************************
+*  How many nodes the term matched, from the graph child. Zero with a
+*  term typed is an ANSWER and is shown; an empty box shows nothing.
+************************************************************/
+function ac_find_result(gobj, event, kw, src) {
+	let $container = gobj_read_attr(gobj, "$container");
+	if (!$container) return 0;
+	let $result = $container.querySelector(".GRAPH_FIND_RESULT");
+	let $count = $container.querySelector(".GRAPH_FIND_COUNT");
+	if (!$result || !$count) return 0;
+	if (!(kw && kw.term || "")) {
+		$result.classList.add("is-hidden");
+		$count.textContent = "";
+		return 0;
+	}
+	$count.textContent = String(kw && kw.matches || 0);
+	$result.classList.remove("is-hidden");
+	return 0;
+}
 function ac_set_focus_topic(gobj, event, kw, src) {
 	let priv = gobj.priv;
 	if (priv.gobj_nodes_tree) gobj_send_event(priv.gobj_nodes_tree, "EV_FOCUS_TOPIC", { topic: kw && kw.topic }, gobj);
@@ -19718,6 +20016,16 @@ function create_gclass$4(gclass_name) {
 			ac_set_focus_topic,
 			null
 		],
+		[
+			"EV_FIND_NODES",
+			ac_find_nodes$1,
+			null
+		],
+		[
+			"EV_FIND_RESULT",
+			ac_find_result,
+			null
+		],
 		[
 			"EV_SHOW",
 			ac_show$3,
@@ -19759,6 +20067,8 @@ function create_gclass$4(gclass_name) {
 		["EV_SET_LAYOUT", 0],
 		["EV_SET_OPERATION_MODE", 0],
 		["EV_SET_FOCUS_TOPIC", 0],
+		["EV_FIND_NODES", 0],
+		["EV_FIND_RESULT", 0],
 		["EV_OPERATION_MODE_CHANGED", event_flag_t.EVF_OUTPUT_EVENT | event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_RECORD_WRITTEN", event_flag_t.EVF_OUTPUT_EVENT | event_flag_t.EVF_NO_WARN_SUBS],
 		["EV_SHOW", 0],
@@ -52424,7 +52734,8 @@ var PRIVATE_DATA$1 = {
 	_link_saved_styles: [],
 	_focus_topic: null,
 	_focus_ids: [],
-	_pending_focus_topic: null
+	_pending_focus_topic: null,
+	_pending_find: null
 };
 var __gclass__$1 = null;
 /******************************
@@ -53598,6 +53909,67 @@ function graph_focus_topic(gobj, topic) {
 		log_error(`${gobj_short_name(gobj)}: focus topic apply failed: ${e}`);
 	}
 }
+/************************************************************
+*  Find the nodes whose name, id or topic contains `term`, highlight
+*  them with the same amber 'active' state the topic focus uses, and
+*  centre the viewport on them. Returns how many matched, which is the
+*  half the toolbar needs: a search that finds nothing must SAY so,
+*  because a graph that did not move is also what a graph looks like
+*  when the match is off-screen.
+*
+*  It shares the highlight slot with graph_focus_topic on purpose —
+*  two amber sets at once would say nothing about either. An empty
+*  term clears it. Matching reads the node's LABEL and not only its
+*  id: on a topic keyed by rowid or by a qualified path, the id is a
+*  counter and the name a human knows is elsewhere (see node_label).
+************************************************************/
+function graph_find_nodes(gobj, term) {
+	let priv = gobj.priv;
+	let graph = priv.graph;
+	if (!graph || !priv.graph_rendered) {
+		priv._pending_find = term;
+		return 0;
+	}
+	let data = {};
+	try {
+		data = graph.getData() || {};
+	} catch (e) {
+		log_error(`${gobj_short_name(gobj)}: graph.getData() failed: ${e}`);
+		return 0;
+	}
+	let nodes = is_array(data.nodes) ? data.nodes : [];
+	let states = {};
+	for (let id of priv._focus_ids || []) states[id] = [];
+	let ids = [];
+	if (!empty_string(term)) {
+		let needle = String(term).toLowerCase();
+		for (let n of nodes) {
+			if (!n || !n.data) continue;
+			let record = n.data.record || {};
+			let label = "";
+			try {
+				label = node_label(n.data.desc || {}, record) || "";
+			} catch (e) {
+				label = "";
+			}
+			if ([
+				label,
+				record.id,
+				n.data.topic_name
+			].filter((v) => typeof v === "string").join(" ").toLowerCase().includes(needle)) ids.push(n.id);
+		}
+		for (let id of ids) states[id] = ["active"];
+	}
+	priv._focus_ids = ids;
+	priv._focus_topic = null;
+	try {
+		if (typeof graph.setElementState === "function") graph.setElementState(states);
+		if (ids.length && typeof graph.focusElement === "function") graph.focusElement(ids);
+	} catch (e) {
+		log_error(`${gobj_short_name(gobj)}: find apply failed: ${e}`);
+	}
+	return ids.length;
+}
 async function graph_zoom_in(gobj) {
 	let graph = gobj.priv.graph;
 	const z = graph.getZoom();
@@ -55892,6 +56264,11 @@ function ac_load_data(gobj, event, kw, src) {
 					priv._pending_focus_topic = null;
 					graph_focus_topic(gobj, ft);
 				}
+				if (priv._pending_find !== null) {
+					let term = priv._pending_find;
+					priv._pending_find = null;
+					publish_find_result(gobj, term, graph_find_nodes(gobj, term));
+				}
 			});
 		});
 	});
@@ -56108,6 +56485,25 @@ function ac_focus_topic(gobj, event, kw, src) {
 	graph_focus_topic(gobj, kw && kw.topic);
 	return 0;
 }
+/************************************************************
+*  Tell whoever asked how many nodes the term matched. The count is
+*  the answer to the question the box asks; without it "nothing moved"
+*  and "nothing matched" look the same.
+************************************************************/
+function publish_find_result(gobj, term, matches) {
+	gobj_publish_event(gobj, "EV_FIND_RESULT", {
+		term,
+		matches
+	});
+}
+/************************************************************
+*
+************************************************************/
+function ac_find_nodes(gobj, event, kw, src) {
+	let term = kw && kw.text || "";
+	publish_find_result(gobj, term, graph_find_nodes(gobj, term));
+	return 0;
+}
 function ac_center(gobj, event, kw, src) {
 	graph_center(gobj);
 	return 0;
@@ -56409,6 +56805,11 @@ function create_gclass$1(gclass_name) {
 			ac_focus_topic,
 			null
 		],
+		[
+			"EV_FIND_NODES",
+			ac_find_nodes,
+			null
+		],
 		[
 			"EV_CENTER",
 			ac_center,
@@ -56492,6 +56893,8 @@ function create_gclass$1(gclass_name) {
 		["EV_ZOOM_RESET", 0],
 		["EV_AUTO_FIT", 0],
 		["EV_FOCUS_TOPIC", 0],
+		["EV_FIND_NODES", 0],
+		["EV_FIND_RESULT", event_flag_t.EVF_OUTPUT_EVENT],
 		["EV_CENTER", 0],
 		["EV_FULLSCREEN", 0],
 		["EV_SET_LAYOUT", 0],