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
+65
View File
@@ -0,0 +1,65 @@
---
name: use_wails_query
kind: component
lang: typescript
domain: ui
version: "1.0.0"
purity: impure
signature: "useWailsQuery<T>(opts: UseWailsQueryOptions<T>): UseWailsQueryResult<T>"
description: "Hook React Query-like sobre IPC Wails. Cache automático, refetch por intervalo/foco, retry con backoff, invalidación."
tags: [wails, query, hook, ipc, cache, component, ui]
uses_functions: [wails_cache_typescript_core, wails_provider_typescript_ui]
uses_types: [WailsIPC_typescript_ui]
returns: []
returns_optional: false
error_type: ""
imports: [react]
tested: false
tests: []
test_file_path: ""
file_path: "frontend/functions/ui/use_wails_query.tsx"
props:
- name: queryKey
type: "string[]"
required: true
description: "Key única para cache"
- name: queryFn
type: "() => Promise<T>"
required: true
description: "Función que llama al binding Wails"
- name: enabled
type: "boolean"
required: false
description: "Habilitar auto-fetch (default true)"
- name: refetchInterval
type: "number"
required: false
description: "Refetch cada N ms"
- name: staleTime
type: "number"
required: false
description: "Tiempo antes de considerar datos stale"
emits: [onSuccess, 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-query.tsx"
---
## Ejemplo
```tsx
const { data, loading, refetch, invalidate } = useWailsQuery({
queryKey: ['users', 'list'],
queryFn: () => GetUsers(), // Wails binding
refetchInterval: 30000, // Cada 30s
staleTime: 5000, // Fresh por 5s
onSuccess: (users) => console.log(`${users.length} users`),
})
```
## Notas
API inspirada en TanStack Query pero sobre IPC Wails (sin HTTP). Cache compartido via WailsProvider o singleton. Refetch automático en window focus.