egutierrez
b9716a7cd6
Snapshot de WIP acumulado de sesiones previas antes de merge wave 1 del flow 0008 (kanban_cpp + agent_runner_api + DoD schema). Incluye: - dev/flows/0008-kanban-cpp-and-agent-workflows.md - dev/issues/0112-0119*.md (7 sub-issues) - WIP previo en cmd/fn/doctor.go, registry/*, modules/, cpp/, etc. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
76 lines
4.9 KiB
Markdown
76 lines
4.9 KiB
Markdown
---
|
|
name: data_table
|
|
version: 2.1.0
|
|
lang: cpp
|
|
description: "Reusable C++ ImGui module to render a full TQL-aware data table: chips bar, table grid, viz panels, column-stats inline, drill, color rules, joins, TQL editor, Ask AI, Button renderer, event sink, tooltip per-cell. v2.0.0 splits the 4777 LOC entrypoint into 6 sub-functions. v2.1.0 separates members (module-owned) from uses_functions (consumed registry functions)."
|
|
# members: funciones del registry que el modulo POSEE (renderizan dentro de el).
|
|
# Estas funciones viven en cpp/functions/viz/data_table_*.cpp y NO se usan
|
|
# fuera del modulo. Apps consumidoras NO listan estos miembros en su
|
|
# `uses_functions` cuando declaran `uses_modules: [data_table_cpp]`.
|
|
members:
|
|
- data_table_cpp_viz
|
|
- data_table_chips_cpp_viz
|
|
- data_table_grid_cpp_viz
|
|
- data_table_drill_cpp_viz
|
|
- data_table_color_rules_cpp_viz
|
|
- data_table_ai_panel_cpp_viz
|
|
- data_table_viz_panels_cpp_viz
|
|
# uses_functions: funciones del registry que el modulo CONSUME pero NO posee.
|
|
# Estas son utiles fuera del modulo (compute, TQL stack, lua, llm, join, etc.).
|
|
# Si una app necesita lua_engine/llm_anthropic/join_tables/auto_detect_type
|
|
# STANDALONE (no a traves de data_table), las declara en su `uses_functions`
|
|
# directamente. No es duplicacion — es uso independiente.
|
|
uses_functions:
|
|
- compute_stage_cpp_core
|
|
- compute_pipeline_cpp_core
|
|
- compute_column_stats_cpp_core
|
|
- tql_emit_cpp_core
|
|
- tql_helpers_cpp_core
|
|
- tql_apply_cpp_core
|
|
- tql_to_sql_cpp_core
|
|
- lua_engine_cpp_core
|
|
- join_tables_cpp_core
|
|
- auto_detect_type_cpp_core
|
|
- llm_anthropic_cpp_core
|
|
- viz_render_cpp_viz
|
|
tags: [tables, viz, ui, imgui, tql, cpp]
|
|
dir_path: modules/data_table
|
|
---
|
|
|
|
## Documentation
|
|
|
|
C++ ImGui module to render a full data table with TQL pipeline, viz panels, joins, color rules, declarative cell renderers (Badge, Progress, Duration, Icon, Button, Dots, CategoricalChip, ColorScale), drill, Ask AI and event sink.
|
|
|
|
Entry-point: `data_table::render(id, tables, state, events_out, show_chrome)`.
|
|
|
|
### Opt-in en una app
|
|
|
|
1. `app.md`: anadir `uses_modules: [data_table_cpp]`.
|
|
2. `CMakeLists.txt`: `target_link_libraries(<app> PRIVATE fn_module_data_table)`.
|
|
3. Header: `#include "data_table/data_table.h"` y `#include "core/data_table_types.h"`.
|
|
4. Reservar `data_table::State` persistente entre frames y llamar `data_table::render(...)` cada frame.
|
|
|
|
### Funciones miembro
|
|
|
|
Cada ID en `members` es una funcion del registry que el modulo bundla en su static lib. Cuando una app declara `uses_modules: [data_table_cpp]`, automaticamente "usa" estas funciones a traves del modulo — no hace falta listarlas otra vez en `uses_functions`.
|
|
|
|
### Version policy
|
|
|
|
Semver. Bumps de version se documentan en `## Capability growth log`. Cambios en API publica (`data_table.h`) = major. Adicion de funcionalidad opt-in = minor. Bugfix = patch.
|
|
|
|
## Capability growth log
|
|
|
|
- v2.0.0 (2026-05-17) — **Major internal refactor (issue 0107c)**: split `data_table.cpp` (4777 LOC entrypoint monolitico) en 6 sub-funciones del registry en `cpp/functions/viz/`: `data_table_chips`, `data_table_grid`, `data_table_drill`, `data_table_color_rules`, `data_table_ai_panel`, `data_table_viz_panels`. Entrypoint reducido a 1818 LOC (custom column modal + render orchestration + `ui()` singleton). Nuevo header interno `modules/data_table/data_table_internal.h` con `UiState` aggregator + helpers compartidos (`ops_for_type`, `op_label`, `effective_type`, `view_mode_label`, `parse_hex_color`, `lerp_color_along_stops`, `filters_hash`, `ColInfo`, `auto_promote_aggregated`, etc.). API publica `data_table::render(...)` INTACTA — apps consumidoras NO necesitan cambios. Cada sub-funcion ahora puede testearse aisladamente (issue 0108 testbed agresivo). Members expandido de 13 a 19 (anaden 6 sub-funciones); `audit_data_table_usage_go_infra` + `fn doctor modules` (0107a) auditan drift contra esta lista.
|
|
- v1.5.0 (2026-05-17) — Per-table state isolation: `stats_mode/cache`, `sel_*`, `inspect_*`, `drill_*` movidos de UiState singleton a `State` (fix multi-table). Conditional color extendido con tres modos: `CellBg` (legacy), `CategoricalDot` (autopalette de 12 hash-deterministico), `NumericRange` (gradiente N-color sobre bg). Hover del menu contextual de header restaurado.
|
|
- v1.4.0 (2026-05-16) — CategoricalChip (dot izquierda + text) + ColorScale (gradient N-color en fondo de celda)
|
|
- v1.3.1 (anterior) — Dots renderer via ImDrawList (font-independent)
|
|
- v1.3.0 — Dots renderer para sparkline-like de status timelines
|
|
- v1.2.0 — Joins, drill, color rules, tooltip per-cell, Button event sink
|
|
- v1.0.0 — Initial table + TQL pipeline + chips bar
|
|
|
|
## Notes
|
|
|
|
- El modulo se compila como static lib `fn_module_data_table` (cmake target). Static lib bundla todos los miembros — apps consumidoras solo enlazan UN target.
|
|
- Replaces former `fn_table_viz` target (2026-05-16).
|
|
- Requiere `fn_framework` (para `fn::local_path()` usado en Ask AI export).
|