@xsmusices/ui 0.0.0-stage → 1.41.0

package/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) XSMusic. Todos los derechos reservados.
+
+Este paquete es software propietario de XSMusic. Queda prohibida
+su copia, redistribución, modificación, ingeniería inversa o
+cualquier otro uso sin autorización previa y por escrito de XSMusic.
+
+El repositorio de código fuente es privado. La distribución de
+este paquete compilado no concede ninguna licencia de código
+abierto ni derechos adicionales de reutilización.

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# @xsmusices/ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Librería de componentes Angular compartida para los proyectos de XSMusic (admin, app, etc).
+
+## Características
+
+- ✅ **Componentes Standalone** — 100% modulares y reutilizables
+- 🎨 **Diseño Centralizado** — Tema consistent (dark mode, Tailwind CSS)
+- 🌍 **Multi-idioma** — Soporte native para ES/EN sin dependencias externas
+- ♿ **Accesibilidad** — Componentes WCAG compliant
+- 📦 **Tree-shakeable** — Solo empaqueta lo que usas
+
+## Instalación
+
+```bash
+npm install @xsmusices/ui
+```
+
+Luego importa componentes según necesites:
+
+```typescript
+import { XsButtonComponent } from '@xsmusices/ui';
+
+@Component({
+  imports: [XsButtonComponent],
+})
+export class MyComponent {}
+```
+
+## Configuración requerida
+
+La librería no apunta a ningún entorno por defecto. La app debe proveer:
+
+```typescript
+import { XS_API_URL, XS_ENV_NAME } from '@xsmusices/ui';
+
+{ provide: XS_API_URL, useValue: environment.urls.api },
+{ provide: XS_ENV_NAME, useValue: environment.name },
+```
+
+Sin `XS_API_URL` las URLs de imágenes y scraping quedan relativas
+(fallo visible, nunca tráfico accidental contra producción).
+
+## Uso Básico
+
+### Componentes Comunes
+
+```html
+<xs-button label="Enviar"></xs-button>
+<xs-input placeholder="Escribe..."></xs-input>
+<xs-card title="Mi Card"> contenido </xs-card>
+```
+
+## Internacionalización (i18n)
+
+### Cambiar Idioma (Consumidor)
+
+```typescript
+import { XSTranslateService } from '@xsmusices/ui';
+
+constructor(private translate: XSTranslateService) {}
+
+cambiarIdioma() {
+  this.translate.setLanguage('en'); // or 'es'
+}
+```
+
+El idioma se persiste automáticamente en `localStorage`.
+
+## Desarrollo
+
+```bash
+# Dev con watch
+npm run watch
+
+# Build producción
+npm run build:xs-ui
+
+# Tests
+npm run test:xs-ui
+
+# Cobertura
+npm run test:coverage
+```
+
+---
+
+Para documentación completa y catálogo de componentes, ve a [https://ui.xsmusic.es](https://ui.xsmusic.es)
+
+## Further help
+
+To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
+// trigger rebuild