valtech-components 2.0.842 → 2.0.843

package/README.md

@@ -5,28 +5,11 @@
 [![npm version](https://img.shields.io/npm/v/valtech-components.svg)](https://www.npmjs.com/package/valtech-components)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-**[Documentation](https://ui.myvaltech.com)**
+Component library for Angular + Ionic + Capacitor apps. **145 components** and **23+ services** for auth, Firebase, i18n, and more.
 
-A comprehensive component library for building modern web and hybrid applications with Angular, Ionic, and Capacitor. Includes **134 UI components** and **23+ specialized services** for authentication, Firebase integration, internationalization, and more.
+**[Full documentation → ui.myvaltech.com](https://ui.myvaltech.com)**
 
-## Features
-
-- **134 UI Components** — Atoms, molecules, organisms, and templates ready to use
-- **Authentication System** — Complete auth with OAuth (Google, Apple), session management, and token handling
-- **Firebase Integration** — Analytics, Firestore, Cloud Messaging, and Storage services
-- **i18n with Signals** — Modern internationalization using Angular Signals for reactive translations
-- **Remote App Configuration** — Feature flags and remote config management
-- **Google Ad Manager** — Built-in ad slot integration
-- **User Feedback System** — Collect and manage user feedback
-- **Storybook Documentation** — Interactive component documentation
-
-## Technologies
-
-- Angular 18+
-- Ionic 8+
-- Capacitor 6+
-- Firebase 10+
-- RxJS 7.8+
+---
 
 ## Installation
 
@@ -34,35 +17,29 @@ A comprehensive component library for building modern web and hybrid application
 npm install valtech-components
 ```
 
-### Peer Dependencies
+**Peer dependencies (required):**
 
 ```bash
-npm install @angular/core @angular/common @ionic/angular ionicons rxjs
+npm install @angular/common @angular/core @ionic/angular ionicons rxjs
 ```
 
-Optional peer dependencies for additional features:
+**Optional — only if you use these features:**
 
 ```bash
-# Firebase services
-npm install @angular/fire firebase
-
-# QR code generation
-npm install qr-code-styling
-
-# Code highlighting
-npm install prismjs
-
-# Carousel support
-npm install swiper
+npm install @angular/fire firebase          # Firebase services
+npm install @capacitor/app @capacitor/clipboard  # Native features
+npm install qr-code-styling                 # QR code component
+npm install prismjs                         # Code highlighting
+npm install swiper                          # Carousel component
 ```
 
-## Usage Paths
+---
 
-Choose the path that fits your needs:
+## Usage
 
-### UI Only (Quick Start)
+### UI only (no backend needed)
 
-**133 of 134 components** work without any backend or Firebase configuration. Just install and use:
+144 of 145 components work standalone — no Firebase, no backend:
 
 ```typescript
 import { ButtonComponent, CardComponent, TextComponent } from 'valtech-components';
@@ -80,11 +57,9 @@ import { ButtonComponent, CardComponent, TextComponent } from 'valtech-component
 export class MyComponent {}
 ```
 
-No providers needed. No Firebase. No backend. Just import and use.
-
-### Full Integration
+### Full integration (auth + Firebase + i18n)
 
-For authentication, Firebase services, and i18n, add providers to your `main.ts`:
+Add providers in `main.ts`:
 
 ```typescript
 import {
@@ -99,234 +74,59 @@ bootstrapApplication(AppComponent, {
   providers: [
     provideValtechFirebase(createFirebaseConfig(firebaseConfig)),
     provideValtechAuth({ apiUrl: 'https://api.yourapp.com' }),
-    provideValtechI18n({ defaultLang: 'en', supportedLangs: ['en', 'es'] }),
+    provideValtechI18n({ defaultLang: 'en', supportedLangs: ['en', 'es', 'pt'] }),
   ],
 });
 ```
 
-**[Full Integration Guide](https://ui.myvaltech.com/docs/guides/firebase-setup)** — Firebase setup, Auth configuration, i18n, and more.
-
-### Components Requiring Backend
-
-| Component | Requirement |
-|-----------|-------------|
-| `LoginComponent` | `AuthService` configured with API endpoint |
-| `ContentReactionComponent` | `FeedbackService` configured with API endpoint |
-
-All other 132 components are fully standalone.
-
 ---
 
 ## Components
 
-| Category | Count | Description |
-|----------|-------|-------------|
-| **Atoms** | 19 | Basic UI elements: avatar, button, icon, text, image, skeleton, progress-bar, qr-code, etc. |
-| **Molecules** | 81 | Compound components: inputs (text, email, phone, pin, date), cards, searchbar, tabs, accordion, pagination, etc. |
-| **Organisms** | 24 | Complex components: forms, data-table, menu, toolbar, login, comment-section, infinite-list, etc. |
-| **Templates** | 10 | Page layouts: page-wrapper, page-content, docs-shell, auth-background, maintenance-page, etc. |
-
-> **[View full component catalog](https://ui.myvaltech.com)**
-
-## Services
-
-### Basic Services (No Configuration Required)
-
-These services work out of the box:
-
-| Service | Description |
-|---------|-------------|
-| `ThemeService` | Theme management (light/dark mode) |
-| `ToastService` | Toast notifications |
-| `NavigationService` | Routing utilities |
-| `DownloadService` | File download helpers |
-| `IconsService` | Ionicons management |
-| `LocaleService` | Simple locale management with localStorage |
-| `LocalStorageService` | localStorage abstraction |
-| `LinkProcessorService` | Automatic URL and markdown link processing |
-| `InAppBrowserService` | Capacitor in-app browser |
-| `ModalService` | Modal dialog management |
-| `ConfirmationDialogService` | Confirmation dialogs |
-| `QrGeneratorService` | QR code generation |
-| `PresetService` | Reusable configuration presets |
-| `PaginationService` | Pagination state management |
-| `SkeletonService` | Skeleton loading states |
-
-### Authentication Services (Requires `provideValtechAuth`)
-
-Requires backend API. See [Auth Setup Guide](https://ui.myvaltech.com/docs/guides/auth-setup).
-
-| Service | Description |
-|---------|-------------|
-| `AuthService` | Main authentication service |
-| `OAuthService` | OAuth providers (Google, Apple) |
-| `SessionService` | Session management |
-| `TokenService` | JWT token handling |
-| `AuthStateService` | Authentication state management |
-| `DeviceService` | Device information |
-
-### Firebase Services (Requires `provideValtechFirebase`)
-
-Requires Firebase project. See [Firebase Setup Guide](https://ui.myvaltech.com/docs/guides/firebase-setup).
-
-| Service | Description |
-|---------|-------------|
-| `FirebaseService` | Firebase initialization |
-| `AnalyticsService` | Firebase Analytics with custom events |
-| `FirestoreService` | Firestore database operations |
-| `MessagingService` | Cloud Messaging (push notifications) |
-| `NotificationsService` | Notification management |
-| `FirebaseStorageService` | Firebase Storage operations |
-
-### i18n Service (Requires `provideValtechI18n`)
-
-| Service | Description |
-|---------|-------------|
-| `I18nService` | Internationalization with Angular Signals |
-
-### Backend-Dependent Services
-
-These services require a configured backend API:
-
-| Service | Description |
-|---------|-------------|
-| `AppConfigService` | Remote configuration and feature flags |
-| `FeedbackService` | User feedback collection |
-
-## Quick Start
-
-### Basic Component Usage
-
-```typescript
-import { Component } from '@angular/core';
-import { TextComponent, ButtonComponent, CardComponent } from 'valtech-components';
-
-@Component({
-  selector: 'app-example',
-  standalone: true,
-  imports: [TextComponent, ButtonComponent, CardComponent],
-  template: `
-    <val-card [props]="{ title: 'Welcome' }">
-      <val-text [props]="{ content: 'Hello, World!', size: 'medium' }" />
-      <val-button
-        [props]="{ text: 'Get Started', color: 'primary' }"
-        (onClick)="handleClick()"
-      />
-    </val-card>
-  `
-})
-export class ExampleComponent {
-  handleClick() {
-    console.log('Button clicked');
-  }
-}
-```
-
-### i18n with Signals
+| Category | Count | Includes |
+|----------|------:|---------|
+| Atoms | 24 | avatar, button, icon, text, image, skeleton, progress-bar, qr-code… |
+| Molecules | 81 | inputs (text, email, phone, pin, date), cards, tabs, accordion, pagination… |
+| Organisms | 31 | forms, data-table, menu, toolbar, login, comment-section, infinite-list… |
+| Templates | 9 | page-wrapper, page-content, docs-shell, auth-background, maintenance-page… |
+| **Total** | **145** | |
 
-```typescript
-import { Component, inject, computed } from '@angular/core';
-import { I18nService, TextComponent } from 'valtech-components';
+Components requiring a backend API: `LoginComponent`, `ContentReactionComponent`.
 
-@Component({
-  selector: 'app-i18n-example',
-  standalone: true,
-  imports: [TextComponent],
-  template: `
-    <val-text [props]="{ content: welcomeText() }" />
-  `
-})
-export class I18nExampleComponent {
-  private i18n = inject(I18nService);
+---
 
-  // Use computed() for reactive translations
-  welcomeText = computed(() => this.i18n.t('home.welcome'));
-}
-```
+## Services
 
-### Authentication
+**No setup required:**
+`ThemeService` · `ToastService` · `NavigationService` · `DownloadService` · `IconsService` · `LocaleService` · `LocalStorageService` · `ModalService` · `ConfirmationDialogService` · `QrGeneratorService` · `PaginationService` · `SkeletonService`
 
-```typescript
-import { Component, inject } from '@angular/core';
-import { AuthService } from 'valtech-components';
+**Requires `provideValtechAuth`:**
+`AuthService` · `OAuthService` · `SessionService` · `TokenService` · `AuthStateService` · `DeviceService`
 
-@Component({
-  selector: 'app-auth-example',
-  template: `...`
-})
-export class AuthExampleComponent {
-  private auth = inject(AuthService);
+**Requires `provideValtechFirebase`:**
+`FirebaseService` · `AnalyticsService` · `FirestoreService` · `MessagingService` · `NotificationsService` · `FirebaseStorageService`
 
-  async loginWithGoogle() {
-    await this.auth.loginWithGoogle();
-  }
+**Requires `provideValtechI18n`:**
+`I18nService`
 
-  async logout() {
-    await this.auth.logout();
-  }
-
-  get isAuthenticated() {
-    return this.auth.isAuthenticated();
-  }
-}
-```
+---
 
-### Firebase Analytics
+## Technologies
 
-```typescript
-import { Component, inject } from '@angular/core';
-import { AnalyticsService } from 'valtech-components';
+Angular 18+ · Ionic 8+ · Capacitor 6+ · Firebase 10+ · RxJS 7.8+
 
-@Component({
-  selector: 'app-analytics-example',
-  template: `...`
-})
-export class AnalyticsExampleComponent {
-  private analytics = inject(AnalyticsService);
-
-  trackEvent() {
-    this.analytics.logEvent('button_click', {
-      button_name: 'signup',
-      page: 'home'
-    });
-  }
-}
-```
+---
 
 ## Development
 
-### Prerequisites
-
-- Node.js 18+
-- npm 9+
-
-### Setup
-
 ```bash
-# Install dependencies
 npm install
-
-# Start Storybook
-npm run storybook
-# Open http://localhost:6006
+npm run storybook     # http://localhost:6006
+npm run build         # build library
+npm run test          # unit tests
 ```
 
-### Available Scripts
-
-| Command | Description |
-|---------|-------------|
-| `npm run build` | Build the library |
-| `npm run build:prod` | Production build (optimized) |
-| `npm run storybook` | Start Storybook dev server (port 6006) |
-| `npm run build-storybook` | Build static Storybook |
-| `npm run test` | Run unit tests |
-| `npm run prettier` | Format source files |
-
-## Documentation
-
-For complete documentation, examples, and API reference, visit:
-
-**[https://ui.myvaltech.com](https://ui.myvaltech.com)**
+---
 
 ## License
 

package/esm2022/lib/version.mjs

@@ -2,5 +2,5 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export const VERSION = '2.0.842';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmVyc2lvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9saWIvdmVyc2lvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxPQUFPLEdBQUcsU0FBUyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBDdXJyZW50IHZlcnNpb24gb2YgdmFsdGVjaC1jb21wb25lbnRzLlxuICogVGhpcyBpcyBhdXRvbWF0aWNhbGx5IHVwZGF0ZWQgZHVyaW5nIHRoZSBwdWJsaXNoIHByb2Nlc3MuXG4gKi9cbmV4cG9ydCBjb25zdCBWRVJTSU9OID0gJzIuMC44NDInO1xuIl19
+export const VERSION = '2.0.843';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmVyc2lvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9saWIvdmVyc2lvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxPQUFPLEdBQUcsU0FBUyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBDdXJyZW50IHZlcnNpb24gb2YgdmFsdGVjaC1jb21wb25lbnRzLlxuICogVGhpcyBpcyBhdXRvbWF0aWNhbGx5IHVwZGF0ZWQgZHVyaW5nIHRoZSBwdWJsaXNoIHByb2Nlc3MuXG4gKi9cbmV4cG9ydCBjb25zdCBWRVJTSU9OID0gJzIuMC44NDMnO1xuIl19

package/fesm2022/valtech-components.mjs

@@ -53,7 +53,7 @@ import 'prismjs/components/prism-json';
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-const VERSION = '2.0.842';
+const VERSION = '2.0.843';
 
 /**
  * Servicio para gestionar presets de componentes.