chore(registry): notes en huerfanas usadas por framework/apps

Auditoria del issue 0044: anota en notes: el contexto de consumo de
huerfanos que no pueden registrarse en uses_functions porque sus
consumidores no son funciones del registry:
- consumido por cpp/framework/app_base.cpp (framework no indexado)
- consumido por cpp/apps/{shaders_lab,chart_demo,text_editor_smoke}/main.cpp
- scaffolding/demo en primitives_gallery

31 huerfanas anotadas. Las que quedan en uses_functions=[] tras esto
son hojas legitimas (no llaman a nada) o realmente sin uso (lista
DEAD reportada en el issue 0044).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

cpp/functions/core/app_about.md

@@ -29,6 +29,7 @@ params:
   - name: label
     desc: "Texto del MenuItem en la menubar (default 'About...')"
 output: "about_window_set_info muta el estado global del modulo. about_window_render es no-op si la ventana esta cerrada. about_window_menu_item retorna true si el usuario clico"
+notes: "consumido por cpp/framework/app_base.cpp"
 ---
 
 # app_about

cpp/functions/core/app_settings.md

@@ -29,6 +29,7 @@ params:
   - name: label
     desc: "Texto del MenuItem en la menubar (default 'Settings...')"
 output: "settings() devuelve referencia mutable al estado vivo. settings_window_render() es no-op si la ventana esta cerrada. add_section es idempotente por id"
+notes: "consumido por cpp/framework/app_base.cpp"
 ---
 
 # app_settings

cpp/functions/core/dashboard_panel.md

@@ -27,6 +27,7 @@ params:
   - name: min_height
     desc: "Alto minimo del panel en pixels (0 = sin restriccion)"
 output: "true si el panel es visible y se debe renderizar contenido; llamar siempre dashboard_panel_end() independientemente del valor de retorno"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # dashboard_panel

cpp/functions/core/file_watcher.md

@@ -20,6 +20,7 @@ test_file_path: ""
 file_path: "cpp/functions/core/file_watcher.cpp"
 params: []
 output: "FileWatcher opaco con cola interna de eventos. poll() devuelve std::vector<FileEvent> con {path, kind in {Modified, Created, Deleted}}. Errores acumulados en last_error()."
+notes: "consumido por cpp/apps/text_editor_smoke/main.cpp; scaffolding/demo en primitives_gallery"
 ---
 
 # file_watcher

cpp/functions/core/fps_overlay.md

@@ -21,6 +21,7 @@ file_path: "cpp/functions/core/fps_overlay.cpp"
 framework: imgui
 params: []
 output: "Renderiza el overlay de FPS en el frame ImGui actual"
+notes: "consumido por cpp/framework/app_base.cpp"
 ---
 
 # fps_overlay

cpp/functions/core/fullscreen_window.md

@@ -23,6 +23,7 @@ params:
   - name: id
     desc: "Identificador ImGui de la ventana, default ##fullscreen (el prefijo ## oculta el texto del titulo)"
 output: "true si la ventana es visible (siempre true en fullscreen); llamar siempre fullscreen_window_end() independientemente del valor de retorno"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # fullscreen_window

cpp/functions/core/layout_storage_sqlite.md

@@ -26,6 +26,7 @@ params:
   - name: blob
     desc: "Contenido INI serializado con ImGui::SaveIniSettingsToMemory."
 output: "Las funciones bool retornan true en exito, false en error SQLite. load_blob retorna string vacia si el layout no existe o hay error. list retorna vector vacio en error. Ningun error se propaga como excepcion."
+notes: "consumido por cpp/apps/shaders_lab/main.cpp"
 ---
 
 # layout_storage_sqlite

cpp/functions/core/layouts_menu.md

@@ -25,6 +25,7 @@ params:
   - name: cb
     desc: "LayoutCallbacks con los cinco hooks (list, on_apply, on_save, on_delete, on_reset) y el campo active_name para marcar el layout activo. Callbacks nulos se saltan silenciosamente."
 output: "true si el usuario disparo alguna accion (aplicar layout, guardar, borrar o reset) en este frame."
+notes: "consumido por cpp/apps/shaders_lab/main.cpp"
 ---
 
 # layouts_menu

cpp/functions/core/orbit_camera.md

@@ -27,6 +27,7 @@ params:
   - name: wheel
     desc: "Float scroll wheel (Imgui::GetIO().MouseWheel). distance *= (1 - wheel*0.1), clamp >0.1"
 output: "orbit_camera_matrices: CameraMatrices con view (lookAt eye→origin, up=Y) y proj (perspective). Ambas row-major; al pasar a glUniformMatrix4fv usar transpose=GL_TRUE. orbit_camera_handle_drag: muta cam in-place, sin allocacion."
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # orbit_camera

cpp/functions/core/panel_menu.md

@@ -27,6 +27,7 @@ params:
   - name: count
     desc: "Numero de elementos en items."
 output: "true si el usuario togglo algun panel este frame; false si no hubo cambios o si la MainMenuBar no se abrio (solo para panel_menu)."
+notes: "consumido por cpp/apps/shaders_lab/main.cpp"
 ---
 
 # panel_menu

cpp/functions/core/text_editor.md

@@ -24,6 +24,7 @@ source_license: "MIT"
 source_file: "TextEditor.h, TextEditor.cpp"
 params: []
 output: "TextEditorState opaco — encapsula el editor del vendor + buffer de texto cacheado + flag dirty. Render devuelve true cuando el contenido cambio en el frame actual."
+notes: "consumido por cpp/apps/text_editor_smoke/main.cpp; scaffolding/demo en primitives_gallery"
 ---
 
 # text_editor

cpp/functions/core/tokens.md

@@ -21,6 +21,7 @@ file_path: "cpp/functions/core/tokens.cpp"
 framework: imgui
 params: []
 output: "Tokens constexpr accesibles como fn_tokens::colors::*, spacing::*, radius::*, font_size::*. apply_dark_theme() aplica los tokens al ImGuiStyle global."
+notes: "consumido por cpp/framework/app_base.cpp; scaffolding/demo en primitives_gallery"
 ---
 
 # tokens

cpp/functions/core/tween_curves.md

@@ -25,6 +25,7 @@ params:
   - name: t
     desc: "Progreso normalizado en [0,1]. Para t<0 o t>1 algunas curvas extrapolan razonablemente, otras saturan."
 output: "f(t) — valor de la curva en t. Para curvas no oscilantes f(0)=0 y f(1)=1. Para elastic/bounce f(0)=0 y f(1)=1 pero f puede salir del rango [0,1] en valores intermedios."
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # tween_curves

cpp/functions/gfx/dag_catalog.md

@@ -21,6 +21,7 @@ test_file_path: ""
 file_path: "cpp/functions/gfx/dag_catalog.cpp"
 params: []
 output: "dag_catalog(): referencia const estable al vector de DagNodeDef (instancia estatica, no se invalida). dag_find(name): puntero al nodo con ese nombre o nullptr si no existe."
+notes: "consumido por cpp/apps/shaders_lab/main.cpp"
 ---
 
 ## Nodos incluidos

cpp/functions/gfx/gl_loader.md

@@ -21,6 +21,7 @@ file_path: "cpp/functions/gfx/gl_loader.cpp"
 framework: opengl
 params: []
 output: "true si todos los simbolos se resolvieron (Linux siempre true; Windows depende de que el contexto GL este activo antes de llamar). false si algun simbolo no esta disponible en el driver."
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # gl_loader

cpp/functions/gfx/mesh_obj_load.md

@@ -27,6 +27,7 @@ params:
   - name: path
     desc: "Ruta absoluta o relativa del .obj a leer (mesh_obj_load impuro)"
 output: "Mesh con positions/normals (stride 3, mismo length) y indices (tri-list, multiplo de 3). Si no hay vn, normales por face (flat shading) y vertices duplicados por face. Mesh vacio si parse falla."
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # mesh_obj_load

cpp/functions/gfx/shaderlab_db.md

@@ -34,6 +34,7 @@ params:
   - name: err
     desc: "Mensaje de error opcional si save falla (constraint, schema, IO)."
 output: "Persistencia en la tabla generators de shaders_lab.db. Las listas vienen ordenadas por label."
+notes: "consumido por cpp/apps/shaders_lab/main.cpp"
 ---
 
 ## Schema

cpp/functions/gfx/uniform_parser.md

@@ -28,6 +28,7 @@ params:
   - name: glsl_source
     desc: "Código fuente GLSL completo del fragment shader. Se escanea línea a línea buscando declaraciones uniform con anotaciones opcionales."
 output: "Vector de UniformDescriptor ordenado según aparición en el shader. Cada descriptor tiene nombre, tipo GLSL, widget ImGui, rangos min/max, valor por defecto y flags (log_scale, step, default_bool)."
+notes: "consumido por cpp/apps/shaders_lab/main.cpp"
 ---
 
 # uniform_parser

cpp/functions/viz/candlestick.md

@@ -39,6 +39,7 @@ params:
   - name: tooltip
     desc: "Si true, muestra tooltip con valores O/H/L/C al hacer hover sobre una vela"
 output: "Renderiza el grafico de velas OHLC en el frame ImGui actual, sin retornar valor"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # candlestick

cpp/functions/viz/chord.md

@@ -31,6 +31,7 @@ params:
   - name: size
     desc: "Tamano del area cuadrada del chord. Default 400x400"
 output: "Renderiza arcos en el borde y cuerdas curvas internas usando AddConvexPolyFilled + AddText"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # chord

cpp/functions/viz/contour.md

@@ -35,6 +35,7 @@ params:
   - name: size
     desc: "Tamano del rect de render. x <= 0 usa el ancho disponible"
 output: "Renderiza los contornos como segmentos de linea (AddLine) con color por nivel (gradiente azul->amarillo)"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # contour

cpp/functions/viz/gauge.md

@@ -31,6 +31,7 @@ params:
   - name: radius
     desc: "Radio del gauge en pixels (default 60.0)"
 output: "Renderiza el gauge en el frame ImGui actual, reservando espacio con ImGui::Dummy"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # gauge

cpp/functions/viz/graph_force_layout.md

@@ -25,6 +25,7 @@ params:
   - name: config
     desc: "Parametros de la simulacion: repulsion (fuerza coulombiana), attraction (spring constant), damping (decay de velocidad), theta (precision Barnes-Hut 0=exacto/1=rapido), gravity (atraccion al centro), max_velocity, iterations."
 output: "Energia cinetica total (suma de |v|^2). Cuando cae por debajo de un umbral elegido por el caller, el layout ha convergido y se puede dejar de llamar."
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # graph_force_layout

cpp/functions/viz/heatmap.md

@@ -33,6 +33,7 @@ params:
   - name: scale_max
     desc: "Valor maximo de la escala de color (0 para autodetectar)"
 output: "Renderiza el heatmap en el frame ImGui actual"
+notes: "consumido por cpp/apps/chart_demo/main.cpp; scaffolding/demo en primitives_gallery"
 ---
 
 # heatmap

cpp/functions/viz/sankey.md

@@ -29,6 +29,7 @@ params:
   - name: size
     desc: "Tamano del diagrama. x <= 0 usa el ancho disponible"
 output: "Renderiza nodos como rectangulos verticales por columna y links como bandas con bezier cubico, con alpha bajo y color del nodo origen"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # sankey

cpp/functions/viz/scatter_3d.md

@@ -25,6 +25,7 @@ params:
   - name: cfg
     desc: "fn::Scatter3DConfig — xs, ys, zs (length n), sizes opcional, colors opcional (ImU32 RGBA), size del plot"
 output: "Renderiza una nube de puntos 3D dentro del frame ImGui actual; soporta orbit (drag), zoom (wheel) y pan"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # scatter_3d

cpp/functions/viz/sparkline.md

@@ -31,6 +31,7 @@ params:
   - name: height
     desc: "Alto en pixels del sparkline (default 20.0)"
 output: "Renderiza el sparkline inline en el frame ImGui actual, reservando espacio con ImGui::Dummy"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # sparkline

cpp/functions/viz/surface_plot_3d.md

@@ -25,6 +25,7 @@ params:
   - name: cfg
     desc: "fn::SurfacePlot3DConfig — z (nx*ny row-major), nx, ny, x/y_min, x/y_max, labels, size, show_colormap"
 output: "Renderiza una superficie 3D dentro del frame ImGui actual; soporta orbit (drag), zoom (wheel) y pan via ImPlot3D"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # surface_plot_3d

cpp/functions/viz/table_view.md

@@ -31,6 +31,7 @@ params:
   - name: row_count
     desc: "Numero de filas de datos, sin contar el header"
 output: "true si la tabla se renderizo visible, false si fue clipped o skipped por ImGui"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # table_view

cpp/functions/viz/treemap.md

@@ -27,6 +27,7 @@ params:
   - name: size
     desc: "Tamano del rect del treemap. x <= 0 usa el ancho disponible"
 output: "Renderiza el treemap en el frame ImGui actual usando AddRectFilled + AddText sobre el WindowDrawList"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # treemap

cpp/functions/viz/voronoi.md

@@ -31,6 +31,7 @@ params:
   - name: size
     desc: "Tamano del area Voronoi. x <= 0 usa el ancho disponible"
 output: "Renderiza la teselacion de Voronoi como mosaico de tiles 4x4 px coloreados + seeds visibles como circulos blancos sobre negros"
+notes: "scaffolding/demo en primitives_gallery"
 ---
 
 # voronoi