feat: funciones frontend React/TS — componentes UI, hooks Wails, charts y tipos

Componentes React reutilizables: card, dialog, tabs, select, alert, badge, button, input, label,
skeleton, tooltip, progress_bar, page_header, form_field, settings_page, crud_page, analytics_page,
dashboard_layout. Charts: area, bar, line, sparkline, kpi_card, chart_container.
Hooks Wails: use_wails_query, use_wails_mutation, use_wails_stream, use_wails_event, use_animated_canvas.
Funciones core: cn, format_compact, chart_colors, get_series_color, wails_cache, theme_config_to_colors.
Tipos: chart_series, wails_ipc, theme_config, component_variants.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-01 20:55:34 +02:00
parent e02a950ee0
commit dc78d8fea3
86 changed files with 5721 additions and 0 deletions
+69
View File
@@ -0,0 +1,69 @@
---
name: use_wails_stream
kind: component
lang: typescript
domain: ui
version: "1.0.0"
purity: impure
signature: "useWailsStream<T>(opts: UseWailsStreamOptions<T>): UseWailsStreamResult<T>"
description: "Hook para streaming de datos Go→TS con buffer configurable, auto-complete, transform y control start/stop. Incluye useWailsLogs."
tags: [wails, stream, hook, ipc, realtime, buffer, component, ui]
uses_functions: [use_wails_event_typescript_ui]
uses_types: []
returns: []
returns_optional: false
error_type: ""
imports: [react]
tested: false
tests: []
test_file_path: ""
file_path: "frontend/functions/ui/use_wails_stream.tsx"
props:
- name: streamName
type: "string"
required: true
description: "Nombre del evento de stream"
- name: startFn
type: "() => Promise<void>"
required: false
description: "Función Go para iniciar el stream"
- name: stopFn
type: "() => Promise<void>"
required: false
description: "Función Go para detener el stream"
- name: bufferSize
type: "number"
required: false
description: "Tamaño máximo del buffer (default 1000)"
- name: transform
type: "(data: unknown) => T"
required: false
description: "Transformar datos entrantes"
emits: [onData, onComplete, onError]
has_state: true
framework: react
variant: [default]
source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
source_license: "MIT"
source_file: "frontend/src/lib/wails/use-wails-stream.tsx"
---
## Ejemplo
```tsx
// Stream de logs en tiempo real
const { data: logs, isStreaming, start, stop, clear } = useWailsStream<string>({
streamName: 'app:logs',
startFn: () => StartLogStream(),
stopFn: () => StopLogStream(),
bufferSize: 500,
autoStart: true,
})
// Versión simplificada para logs
const { data: logs } = useWailsLogs('deploy:logs')
```
## Notas
Protocolo de stream: Go emite chunks en `{streamName}`, completa con `{streamName}:complete`, errores con `{streamName}:error`. Buffer circular con tamaño configurable.