egutierrez
5f4f1f7508
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.
83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
---
|
|
name: progress_bar
|
|
kind: component
|
|
lang: ts
|
|
domain: ui
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "ProgressBar(props: ProgressBarProps): JSX.Element"
|
|
description: "Barra de progreso con variantes de color y tamaño, buffer, animación, modo indeterminado y display de valor."
|
|
tags: [progress, loading, component, ui, feedback]
|
|
uses_functions: [cn_ts_core]
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: ""
|
|
imports: [class-variance-authority]
|
|
output: "Componente ProgressBar que renderiza barra de progreso con animaciones, buffer y modo indeterminado"
|
|
tested: false
|
|
tests: []
|
|
test_file_path: ""
|
|
file_path: "frontend/functions/ui/progress_bar.tsx"
|
|
props:
|
|
- name: value
|
|
type: "number"
|
|
required: true
|
|
description: "Valor actual de progreso"
|
|
- name: max
|
|
type: "number"
|
|
required: false
|
|
description: "Valor máximo (default 100)"
|
|
- name: buffer
|
|
type: "number"
|
|
required: false
|
|
description: "Valor de buffer secundario (opcional)"
|
|
- name: showValue
|
|
type: "boolean"
|
|
required: false
|
|
description: "Mostrar porcentaje como texto superpuesto"
|
|
- name: animated
|
|
type: "boolean"
|
|
required: false
|
|
description: "Activar animación de rayas (stripes)"
|
|
- name: indeterminate
|
|
type: "boolean"
|
|
required: false
|
|
description: "Modo indeterminado sin valor conocido"
|
|
- name: size
|
|
type: "'sm' | 'md' | 'lg'"
|
|
required: false
|
|
description: "Altura de la barra (default md)"
|
|
- name: color
|
|
type: "'primary' | 'success' | 'warning' | 'destructive'"
|
|
required: false
|
|
description: "Color semántico (default primary)"
|
|
- name: label
|
|
type: "string"
|
|
required: false
|
|
description: "aria-label para accesibilidad"
|
|
emits: []
|
|
has_state: false
|
|
framework: react
|
|
variant: [primary, success, warning, destructive]
|
|
source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library"
|
|
source_license: "MIT"
|
|
source_file: "frontend/src/components/ui/progress/progress-bar.tsx"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```tsx
|
|
<ProgressBar value={75} color="success" showValue />
|
|
<ProgressBar value={0} indeterminate />
|
|
<ProgressBar value={50} buffer={80} animated />
|
|
<ProgressBar value={30} size="lg" color="warning" />
|
|
```
|
|
|
|
## Notas
|
|
|
|
El porcentaje se clampea a [0, 100] internamente. El buffer se renderiza como capa semitransparente detrás del fill.
|
|
Las animaciones de stripes e indeterminate requieren keyframes definidos en el CSS global:
|
|
- `progress-stripes`: background-position de 0 a 1rem
|
|
- `progress-indeterminate`: translateX de -100% a 300%
|