docs: params/output semántico en 506 funciones para composabilidad

Añade campos params y output al frontmatter YAML de las 506 funciones del registry.
Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico)
y cada función describe qué produce su output. Permite a agentes razonar sobre
cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.

functions/tui/clear_screen.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "string: código ANSI para limpiar pantalla"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/confirm_prompt.md

@@ -14,6 +14,10 @@ returns: [result_go_core]
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: prompt
+    desc: "pregunta a mostrar al usuario"
+output: "Result[bool]: true si confirmó, false si rechazó"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/dark_styles.md

@@ -14,6 +14,8 @@ returns: [styles_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "Styles: conjunto de estilos lipgloss oscuros"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/dark_theme.md

@@ -14,6 +14,8 @@ returns: [theme_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "Theme: paleta de colores oscura"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/default_styles.md

@@ -14,6 +14,8 @@ returns: [styles_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "Styles: conjunto de estilos lipgloss por defecto"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/default_theme.md

@@ -14,6 +14,8 @@ returns: [theme_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "Theme: paleta de colores clara/por defecto"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/hide_cursor.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "string: código ANSI para ocultar el cursor"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_base_model.md

@@ -14,6 +14,8 @@ returns: [base_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "BaseModel: modelo base con dimensiones y estilos"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_confirm.md

@@ -14,6 +14,10 @@ returns: [confirm_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: prompt
+    desc: "pregunta a mostrar en el diálogo"
+output: "ConfirmModel: modelo de confirmación interactivo"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_filtered_list.md

@@ -14,6 +14,12 @@ returns: [filtered_list_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: items
+    desc: "array de ListItem con título y descripción"
+  - name: placeholder
+    desc: "texto a mostrar en el input de filtro vacío"
+output: "FilteredListModel: lista con búsqueda en tiempo real"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_list.md

@@ -14,6 +14,10 @@ returns: [list_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: items
+    desc: "array de ListItem para seleccionar"
+output: "ListModel: lista simple seleccionable"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_multi_list.md

@@ -14,6 +14,10 @@ returns: [list_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: items
+    desc: "array de ListItem para seleccionar múltiples"
+output: "ListModel: lista con selección múltiple"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_multi_progress.md

@@ -14,6 +14,8 @@ returns: [multi_progress_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "MultiProgressModel: contenedor para múltiples barras de progreso"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_progress.md

@@ -14,6 +14,12 @@ returns: [progress_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: total
+    desc: "valor total para la barra de progreso"
+  - name: label
+    desc: "etiqueta descriptiva de la operación"
+output: "ProgressModel: barra de progreso"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_progress_with_styles.md

@@ -14,6 +14,14 @@ returns: [progress_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: total
+    desc: "valor total para la barra"
+  - name: label
+    desc: "etiqueta descriptiva"
+  - name: styles
+    desc: "Styles para aplicar a la barra"
+output: "ProgressModel: barra de progreso estilizada"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_spinner.md

@@ -14,6 +14,10 @@ returns: [spinner_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: message
+    desc: "mensaje a mostrar junto al spinner"
+output: "SpinnerModel: spinner con estilos por defecto"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_spinner_with_style.md

@@ -14,6 +14,12 @@ returns: [spinner_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: message
+    desc: "mensaje a mostrar"
+  - name: styles
+    desc: "Styles para personalizar apariencia"
+output: "SpinnerModel: spinner estilizado"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_spinner_with_timeout.md

@@ -14,6 +14,12 @@ returns: [spinner_with_timeout_model_go_tui]
 returns_optional: false
 error_type: ""
 imports: [time]
+params:
+  - name: message
+    desc: "mensaje del spinner"
+  - name: timeout
+    desc: "duración máxima antes de auto-parada"
+output: "SpinnerWithTimeoutModel: spinner con límite de tiempo"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/new_styles.md

@@ -14,6 +14,10 @@ returns: [styles_go_tui]
 returns_optional: false
 error_type: ""
 imports: []
+params:
+  - name: theme
+    desc: "Theme con paleta de colores"
+output: "Styles: estilos lipgloss aplicables a componentes"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/print_error.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: msg
+    desc: "mensaje de error a imprimir"
+output: "sin salida; imprime a stderr con estilo rojo"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/print_info.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: msg
+    desc: "mensaje informativo a imprimir"
+output: "sin salida; imprime a stdout con estilo cyan"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/print_muted.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: msg
+    desc: "mensaje atenuado a imprimir"
+output: "sin salida; imprime a stdout con estilo gris"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/print_success.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: msg
+    desc: "mensaje de éxito a imprimir"
+output: "sin salida; imprime a stdout con estilo verde"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/print_warning.md

@@ -14,6 +14,10 @@ returns: []
 returns_optional: false
 error_type: "error_go_core"
 imports: []
+params:
+  - name: msg
+    desc: "mensaje de advertencia a imprimir"
+output: "sin salida; imprime a stdout con estilo naranja"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/quit_msg.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: ""
 imports: [github.com/charmbracelet/bubbletea]
+params: []
+output: "tea.Msg: mensaje de salida para el event loop"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/run_fullscreen.md

@@ -14,6 +14,10 @@ returns: [result_go_core]
 returns_optional: false
 error_type: "error_go_core"
 imports: [github.com/charmbracelet/bubbletea]
+params:
+  - name: model
+    desc: "modelo Bubble Tea a ejecutar"
+output: "Result[T]: modelo final o error"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/run_model.md

@@ -14,6 +14,10 @@ returns: [result_go_core]
 returns_optional: false
 error_type: "error_go_core"
 imports: [github.com/charmbracelet/bubbletea]
+params:
+  - name: model
+    desc: "modelo Bubble Tea a ejecutar"
+output: "Result[T]: modelo final o error"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/run_with_mouse.md

@@ -14,6 +14,10 @@ returns: [result_go_core]
 returns_optional: false
 error_type: "error_go_core"
 imports: [github.com/charmbracelet/bubbletea]
+params:
+  - name: model
+    desc: "modelo Bubble Tea a ejecutar con soporte de ratón"
+output: "Result[T]: modelo final o error"
 tested: false
 tests: []
 test_file_path: ""

functions/tui/show_cursor.md

@@ -14,6 +14,8 @@ returns: []
 returns_optional: false
 error_type: ""
 imports: []
+params: []
+output: "string: código ANSI para mostrar el cursor"
 tested: false
 tests: []
 test_file_path: ""