@kaufmann-lab/ui 0.1.1 → 0.1.3

package/README.md

@@ -1,25 +1,34 @@
 # @kaufmann-lab/ui
 
-Shared Angular component library for the Kaufmann frontends. Consumed by Portal
-LATAM, Portal OTD and Portal Star — including the Ionic mobile app, which is
-still Angular underneath.
+Librería de componentes Angular compartida para los frontends de Kaufmann.
+La consumen Portal LATAM, Portal OTD y Portal Star — incluida la app móvil
+Ionic, que por debajo sigue siendo Angular.
 
-## Requirements
+> **Nota sobre este README**: por ahora solo documenta `<kf-button>` en
+> detalle. La librería ya tiene muchos más componentes (`Input`, `Checkbox`,
+> `Select`, `Modal`, `Card`, `Tabs`, `Toast`, y otros) — para verlos, mirá el
+> código fuente en `projects/ui/src/lib/` en el
+> [repositorio](https://github.com/kaufmann-lab/kaufmann-ui-angular) hasta
+> que esta tabla se complete. Ver también el
+> [CHANGELOG](https://github.com/kaufmann-lab/kaufmann-ui-angular/blob/main/CHANGELOG.md)
+> para el detalle de qué cambió en cada versión publicada.
 
-Angular 22 and TypeScript ~6.0.3. Angular is a peer dependency, so the library
-uses whatever Angular version the host application already has installed. All
-consumers must be on the same Angular major.
+## Requisitos
 
-## Install
+Angular 22 y TypeScript ~6.0.3. Angular es una `peerDependency`, así que la
+librería usa la versión de Angular que ya tenga instalada la aplicación
+anfitriona. Todos los consumidores deben estar en el mismo major de Angular.
+
+## Instalación
 
 ```bash
 pnpm add @kaufmann-lab/ui
 ```
 
-## Usage
+## Uso
 
-Every component is standalone — there is no module to import. Add the component
-to the `imports` of whichever component uses it:
+Todos los componentes son standalone — no hay ningún módulo para importar.
+Agregá el componente a los `imports` de quien lo use:
 
 ```ts
 import { Component } from '@angular/core';
@@ -28,34 +37,36 @@ import { Button } from '@kaufmann-lab/ui';
 @Component({
   selector: 'app-customers',
   imports: [Button],
-  template: `<kf-button (click)="save()">Save</kf-button>`,
+  template: `<kf-button (click)="save()">Guardar</kf-button>`,
 })
 export class Customers {}
 ```
 
-Styles ship compiled inside each component with view encapsulation. Nothing to
-import in `angular.json`, no global stylesheet to wire up.
+Los estilos viajan compilados dentro de cada componente con view
+encapsulation. No hay nada para importar en `angular.json`, ni ninguna hoja
+de estilos global para conectar.
 
-## Components
+## Componentes
 
 ### `<kf-button>`
 
-Wraps a native `<button>`, so keyboard handling, focus and form submission work
-as expected. `(click)` bubbles from the inner button — bind it on the host.
+Envuelve un `<button>` nativo, así que el manejo de teclado, el foco y el
+envío de formularios funcionan como se espera. `(click)` burbujea desde el
+botón interno — bindealo en el host.
 
-| Input | Type | Default | Notes |
-| --- | --- | --- | --- |
-| `variant` | `'primary' \| 'ghost'` | `'primary'` | |
-| `disabled` | `boolean` | `false` | Bare attribute works: `<kf-button disabled>` |
-| `type` | `'button' \| 'submit' \| 'reset'` | `'submit'` | Matches the native default |
+| Input      | Tipo                              | Default     | Notas                                               |
+| ---------- | --------------------------------- | ----------- | --------------------------------------------------- |
+| `variant`  | `'primary' \| 'ghost'`            | `'primary'` |                                                     |
+| `disabled` | `boolean`                         | `false`     | El atributo suelto funciona: `<kf-button disabled>` |
+| `type`     | `'button' \| 'submit' \| 'reset'` | `'submit'`  | Coincide con el default nativo                      |
 
 ```html
-<kf-button (click)="save()">Save</kf-button>
-<kf-button variant="ghost">Cancel</kf-button>
-<kf-button type="button" disabled>Unavailable</kf-button>
+<kf-button (click)="save()">Guardar</kf-button>
+<kf-button variant="ghost">Cancelar</kf-button>
+<kf-button type="button" disabled>No disponible</kf-button>
 ```
 
-Theming is done through a CSS custom property on the host:
+El theming se hace mediante una custom property de CSS en el host:
 
 ```css
 kf-button {