fn_registry/cpp/functions/viz/graph_viewport_selection.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, tested, tests, test_file_path, file_path, framework, params, output, notes

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	tested	tests	test_file_path	file_path	framework	params	output	notes
graph_viewport_selection	function	cpp	viz	1.0.0	pure	void graph_viewport_clear_selection(GraphData& graph, GraphViewportState& state); bool graph_viewport_is_selected(const GraphViewportState& state, int node_idx); void graph_viewport_add_to_selection(GraphData& graph, GraphViewportState& state, int node_idx); void graph_viewport_toggle_selection(GraphData& graph, GraphViewportState& state, int node_idx)	Helpers puros (sin ImGui ni OpenGL) para gestionar la multi-seleccion del viewport: clear, add, toggle, is_selected. Mantienen sincronizados state.selection (vector de indices) y nodes[i].flags (NF_SELECTED bit), ademas de state.selected_node como ultimo focus.	graph viewport selection pure multi-select testable		GraphData_cpp_viz		false			true	selection add/clear/toggle/is_selected out-of-range indices ignored	cpp/tests/test_graph_viewport.cpp	cpp/functions/viz/graph_viewport_selection.cpp	imgui	name desc graph GraphData. Se modifica para setear/limpiar el bit NF_SELECTED en nodes[i].flags. name desc state GraphViewportState. Se modifica state.selection (vector de indices) y state.selected_node. name desc node_idx Indice del nodo. Si esta fuera de rango (negativo o >= node_count) la funcion es no-op.	graph_viewport_is_selected: bool (true si el indice esta en state.selection). El resto: void. selected_node se actualiza al ultimo indice añadido, o al ultimo de la lista al togglear, o -1 si la lista queda vacia.	Issue 0049i. TU separado de graph_viewport.cpp para que los tests unitarios cubran la maquinaria de seleccion sin abrir ventana ImGui. Operaciones idempotentes: añadir un indice ya seleccionado es no-op; togglear lo elimina. Las apps que necesiten seleccion programatica (ej: 'select all of type X') deben usar estas funciones en lugar de tocar state.selection a mano.

graph_viewport_selection

Helpers puros para multi-seleccion en graph_viewport. Viven en su propio TU para que los tests unitarios puedan verificar invariantes (clear deja todo a NF_SELECTED=0, toggle es involutivo, etc.) sin abrir ventana ImGui.

API

void graph_viewport_clear_selection (GraphData& graph, GraphViewportState& state);
bool graph_viewport_is_selected     (const GraphViewportState& state, int node_idx);
void graph_viewport_add_to_selection(GraphData& graph, GraphViewportState& state, int node_idx);
void graph_viewport_toggle_selection(GraphData& graph, GraphViewportState& state, int node_idx);

Invariantes

• state.selection y nodes[i].flags & NF_SELECTED siempre coherentes — no modificar uno sin el otro. Estas funciones lo garantizan.
• state.selected_node es el "ultimo focus": el ultimo añadido o, al togglear fuera, el ultimo de la lista; -1 si la lista esta vacia.
• Indices fuera de rango son no-op (no escriben memoria, no añaden basura).

Composabilidad

graph_viewport los usa internamente al click/Ctrl+click/Esc. Apps externas los usan para seleccion programatica:

// Seleccionar todos los nodos de tipo Person
graph_viewport_clear_selection(g, state);
for (int i = 0; i < g.node_count; ++i) {
    if (g.nodes[i].type_id == person_type_id) {
        graph_viewport_add_to_selection(g, state, i);
    }
}

Tests

Cubiertos en cpp/tests/test_graph_viewport.cpp — cubren add/clear/toggle/ is_selected y out-of-range.