valtech-components 2.0.794 → 2.0.795

package/lib/services/preferences/preferences.service.d.ts

@@ -1,51 +0,0 @@
-import { HttpClient } from '@angular/common/http';
-import { AuthService } from '../auth/auth.service';
-import { ValtechAuthConfig } from '../auth/types';
-import { FirestoreService } from '../firebase/firestore.service';
-import { I18nService } from '../i18n/i18n.service';
-import { ThemeService } from '../theme.service';
-import { PreferencesLanguage, PreferencesTheme, PreferencesUpdate, PreferencesUpdateResponse } from './preferences.types';
-import * as i0 from "@angular/core";
-/**
- * PreferencesService — preferencias del user en el doc canónico Firestore
- * `/apps/{appId}/users/{uid}/preferences/main`.
- *
- * Read reactivo (signals) via listener Firestore.
- * Write via `PUT /v2/auth/preferences` (cliente NUNCA escribe Firestore directo —
- * ver memoria `feedback_no_direct_firestore_writes`).
- *
- * Side-effects automáticos:
- * - Cuando `theme()` cambia → `ThemeService.Theme = ...`
- * - Cuando `language()` cambia → `I18nService.setLanguage(...)`
- *
- * Auto-bind al user actual via `AuthService.user()`. Sin user (logout) → unbind.
- */
-export declare class PreferencesService {
-    private config;
-    private firestore;
-    private auth;
-    private http;
-    private themeService;
-    private i18n;
-    private readonly _theme;
-    private readonly _language;
-    private readonly _notificationsMaster;
-    /** `true` después del primer snapshot Firestore. Antes, defaults sin side-effects. */
-    private readonly _synced;
-    readonly theme: import("@angular/core").Signal<PreferencesTheme>;
-    readonly language: import("@angular/core").Signal<PreferencesLanguage>;
-    readonly notificationsMaster: import("@angular/core").Signal<boolean>;
-    readonly synced: import("@angular/core").Signal<boolean>;
-    private subscription?;
-    private currentUserId?;
-    constructor(config: ValtechAuthConfig, firestore: FirestoreService, auth: AuthService, http: HttpClient, themeService: ThemeService | null, i18n: I18nService | null);
-    /** Actualiza preferencias via backend. Optimistic UI: aplica local, revierte si falla. */
-    update(partial: PreferencesUpdate): Promise<PreferencesUpdateResponse>;
-    setTheme(theme: PreferencesTheme): Promise<PreferencesUpdateResponse>;
-    setLanguage(language: PreferencesLanguage): Promise<PreferencesUpdateResponse>;
-    setNotificationsMaster(enabled: boolean): Promise<PreferencesUpdateResponse>;
-    private bindToUser;
-    private unbind;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PreferencesService, [null, null, null, null, { optional: true; }, { optional: true; }]>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PreferencesService>;
-}

package/lib/services/preferences/preferences.types.d.ts

@@ -1,35 +0,0 @@
-/**
- * Preferences types — Fase 1 schema simple (theme + language + notifications.master).
- * Doc canónico: /apps/{appId}/users/{uid}/preferences/main
- * Cliente NUNCA escribe directo — todas las mutaciones via PUT /v2/auth/preferences.
- */
-export type PreferencesTheme = 'light' | 'dark' | 'auto';
-export type PreferencesLanguage = 'es' | 'en' | 'pt';
-/** Forma del doc tal como lo escribe el backend (Admin SDK). */
-export interface PreferencesDocument {
-    theme?: PreferencesTheme;
-    language?: PreferencesLanguage;
-    notifications?: {
-        master?: boolean;
-    };
-    /** serverTimestamp escrito por el backend en cada sync. */
-    syncedAt?: unknown;
-}
-/** Payload aceptado por `PUT /v2/auth/preferences` — partial update. */
-export interface PreferencesUpdate {
-    theme?: PreferencesTheme;
-    language?: PreferencesLanguage;
-    notifications?: {
-        master?: boolean;
-    };
-}
-/** Response del backend tras el PUT. */
-export interface PreferencesUpdateResponse {
-    operationId: string;
-    theme: PreferencesTheme | '';
-    language: PreferencesLanguage | '';
-    notifications: {
-        master?: boolean;
-    };
-    updated: boolean;
-}

package/lib/services/presets/config.d.ts

@@ -1,32 +0,0 @@
-import { EnvironmentProviders } from '@angular/core';
-import { PresetConfig } from './types';
-/**
- * Configura el sistema de presets de Valtech Components.
- *
- * @param presets Configuración de presets por componente
- * @returns Providers para agregar en app.config.ts
- *
- * @example
- * // app.config.ts
- * import { provideValtechPresets } from 'valtech-components';
- *
- * export const appConfig: ApplicationConfig = {
- *   providers: [
- *     provideValtechPresets({
- *       button: {
- *         'primary-action': { size: 'large', color: 'primary', fill: 'solid' },
- *         'secondary': { size: 'medium', color: 'secondary', fill: 'outline' },
- *         'danger': { size: 'medium', color: 'danger', fill: 'solid' },
- *       },
- *       card: {
- *         'feature': { variant: 'elevated', padding: 'large' },
- *         'compact': { variant: 'flat', padding: 'small' },
- *       },
- *       input: {
- *         'form-field': { size: 'medium', fill: 'outline', labelPosition: 'floating' },
- *       }
- *     }),
- *   ]
- * };
- */
-export declare function provideValtechPresets(presets: PresetConfig): EnvironmentProviders;

package/lib/services/presets/index.d.ts

@@ -1,3 +0,0 @@
-export { PresetConfig, ComponentPresets, PresetsOptions } from './types';
-export { PresetService } from './preset.service';
-export { provideValtechPresets } from './config';

package/lib/services/presets/preset.service.d.ts

@@ -1,69 +0,0 @@
-import { PresetConfig, ComponentPresets } from './types';
-import * as i0 from "@angular/core";
-/**
- * Servicio para gestionar presets de componentes.
- *
- * Los presets permiten definir configuraciones reutilizables
- * de componentes (tamaño, color, variante, etc.) que se pueden
- * aplicar con un nombre semántico.
- *
- * @example
- * // En un componente
- * presets = inject(PresetService);
- *
- * // Obtener preset
- * const buttonProps = this.presets.get<ButtonMetadata>('button', 'primary-action');
- * // { size: 'large', color: 'primary', fill: 'solid' }
- */
-export declare class PresetService {
-    private readonly _presets;
-    /**
-     * Obtiene un preset específico para un componente
-     *
-     * @param component Tipo de componente (ej: 'button', 'card', 'input')
-     * @param presetName Nombre del preset (ej: 'primary-action', 'compact')
-     * @returns Propiedades del preset o objeto vacío si no existe
-     *
-     * @example
-     * // Obtener preset de botón
-     * const props = presets.get<ButtonMetadata>('button', 'primary-action');
-     *
-     * // Usar en componente
-     * <val-button [props]="props"></val-button>
-     */
-    get<T extends Record<string, unknown>>(component: string, presetName: string): Partial<T>;
-    /**
-     * Verifica si existe un preset
-     */
-    has(component: string, presetName: string): boolean;
-    /**
-     * Registra presets de la aplicación
-     *
-     * @param presets Configuración de presets
-     *
-     * @example
-     * presets.registerPresets({
-     *   button: {
-     *     'primary-action': { size: 'large', color: 'primary' },
-     *   },
-     *   card: {
-     *     'feature': { variant: 'elevated' },
-     *   }
-     * });
-     */
-    registerPresets(presets: PresetConfig): void;
-    /**
-     * Agrega presets para un componente específico (merge con existentes)
-     */
-    registerComponentPresets(component: string, presets: ComponentPresets): void;
-    /**
-     * Obtiene todos los nombres de presets para un componente
-     */
-    getPresetNames(component: string): string[];
-    /**
-     * Obtiene todos los componentes con presets registrados
-     */
-    getRegisteredComponents(): string[];
-    static ɵfac: i0.ɵɵFactoryDeclaration<PresetService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PresetService>;
-}

package/lib/services/presets/types.d.ts

@@ -1,39 +0,0 @@
-/**
- * Presets para un tipo de componente
- *
- * @example
- * const buttonPresets: ComponentPresets = {
- *   'primary-action': { size: 'large', color: 'primary', fill: 'solid' },
- *   'secondary': { size: 'medium', color: 'secondary', fill: 'outline' },
- *   'danger': { size: 'medium', color: 'danger', fill: 'solid' },
- * };
- */
-export type ComponentPresets = Record<string, Record<string, unknown>>;
-/**
- * Configuración completa de presets por componente
- *
- * @example
- * const appPresets: PresetConfig = {
- *   button: {
- *     'primary-action': { size: 'large', color: 'primary', fill: 'solid' },
- *     'secondary': { size: 'medium', color: 'secondary', fill: 'outline' },
- *   },
- *   card: {
- *     'feature': { variant: 'elevated', padding: 'large' },
- *     'compact': { variant: 'flat', padding: 'small' },
- *   },
- *   input: {
- *     'form-field': { size: 'medium', fill: 'outline', labelPosition: 'floating' },
- *   }
- * };
- */
-export type PresetConfig = Record<string, ComponentPresets>;
-/**
- * Opciones para provideValtechPresets()
- */
-export interface PresetsOptions {
-    /**
-     * Presets iniciales de la aplicación
-     */
-    presets: PresetConfig;
-}

package/lib/services/qr-generator/qr-generator.service.d.ts

@@ -1,115 +0,0 @@
-import { QrConfig, QrResult, QrDownloadOptions, QrShareOptions, QR_PRESETS } from './types';
-import * as i0 from "@angular/core";
-/**
- * QrGeneratorService
- *
- * A comprehensive service for generating, customizing, and manipulating QR codes.
- * Uses qr-code-styling library for high-quality, customizable QR code generation.
- *
- * @example Basic usage
- * ```typescript
- * const qr = await this.qrService.generate({ data: 'https://example.com' });
- * console.log(qr.dataUrl); // base64 image
- * ```
- *
- * @example With customization
- * ```typescript
- * const qr = await this.qrService.generate({
- *   data: 'https://example.com',
- *   width: 400,
- *   dotsStyle: 'rounded',
- *   dotsColor: '#3880ff',
- *   logo: { src: 'logo.png', width: 60 }
- * });
- * ```
- *
- * @example Using presets
- * ```typescript
- * const qr = await this.qrService.generateFromPreset('modern', 'https://example.com');
- * ```
- */
-export declare class QrGeneratorService {
-    /**
-     * Generate a QR code with the given configuration.
-     *
-     * @param config - QR code configuration
-     * @returns Promise<QrResult> - Generated QR code result
-     *
-     * @example
-     * ```typescript
-     * const qr = await this.qrService.generate({
-     *   data: 'https://myapp.com/product/123',
-     *   width: 300,
-     *   dotsStyle: 'rounded',
-     *   dotsColor: '#000000',
-     *   backgroundColor: '#ffffff'
-     * });
-     * ```
-     */
-    generate(config: QrConfig): Promise<QrResult>;
-    /**
-     * Generate a QR code using a preset configuration.
-     *
-     * @param preset - Preset name ('default', 'rounded', 'dots', 'classy', 'modern')
-     * @param data - Data to encode
-     * @param overrides - Optional configuration overrides
-     * @returns Promise<QrResult>
-     */
-    generateFromPreset(preset: keyof typeof QR_PRESETS | string, data: string, overrides?: Partial<QrConfig>): Promise<QrResult>;
-    /**
-     * Download the QR code as a file.
-     *
-     * @param qr - QR result to download
-     * @param options - Download options
-     */
-    download(qr: QrResult, options?: QrDownloadOptions): Promise<void>;
-    /**
-     * Copy the QR code to clipboard as an image.
-     *
-     * @param qr - QR result to copy
-     * @returns Promise<boolean> - Whether copy was successful
-     */
-    copyToClipboard(qr: QrResult): Promise<boolean>;
-    /**
-     * Share the QR code using Web Share API.
-     *
-     * @param qr - QR result to share
-     * @param options - Share options
-     * @returns Promise<boolean> - Whether share was successful
-     */
-    share(qr: QrResult, options?: QrShareOptions): Promise<boolean>;
-    /**
-     * Get the QR code as a base64 string (without data URL prefix).
-     *
-     * @param qr - QR result
-     * @returns Base64 string
-     */
-    toBase64(qr: QrResult): string;
-    /**
-     * Get the QR code as a data URL.
-     *
-     * @param qr - QR result
-     * @returns Data URL string
-     */
-    toDataUrl(qr: QrResult): string;
-    /**
-     * Get the QR code as a Blob.
-     *
-     * @param qr - QR result
-     * @returns Blob
-     */
-    toBlob(qr: QrResult): Blob;
-    /**
-     * Check if Web Share API is available.
-     */
-    canShare(): boolean;
-    /**
-     * Check if Clipboard API is available for images.
-     */
-    canCopyToClipboard(): boolean;
-    private buildColorOptions;
-    private getMimeType;
-    private blobToDataUrl;
-    static ɵfac: i0.ɵɵFactoryDeclaration<QrGeneratorService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<QrGeneratorService>;
-}

package/lib/services/qr-generator/types.d.ts

@@ -1,141 +0,0 @@
-/**
- * Style options for QR code dots (data modules).
- */
-export type QrDotsStyle = 'square' | 'dots' | 'rounded' | 'extra-rounded' | 'classy' | 'classy-rounded';
-/**
- * Style options for QR code corner squares.
- */
-export type QrCornersSquareStyle = 'square' | 'dot' | 'extra-rounded';
-/**
- * Style options for QR code corner dots.
- */
-export type QrCornersDotStyle = 'square' | 'dot';
-/**
- * Output format for the generated QR code.
- */
-export type QrOutputFormat = 'svg' | 'png' | 'jpeg' | 'webp';
-/**
- * Error correction level for QR codes.
- * Higher levels allow more damage tolerance but reduce data capacity.
- */
-export type QrErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
-/**
- * Logo/image configuration for the QR code center.
- */
-export interface QrLogoConfig {
-    /** Image source URL or base64 */
-    src: string;
-    /** Logo width (default: 25% of QR size) */
-    width?: number;
-    /** Logo height (default: same as width) */
-    height?: number;
-    /** Margin around the logo */
-    margin?: number;
-    /** Border radius for rounded corners */
-    borderRadius?: number;
-    /** Whether to hide dots behind the logo */
-    hideBackgroundDots?: boolean;
-}
-/**
- * Gradient configuration for QR elements.
- */
-export interface QrGradient {
-    /** Gradient type */
-    type: 'linear' | 'radial';
-    /** Rotation angle in degrees (for linear) */
-    rotation?: number;
-    /** Color stops */
-    colorStops: Array<{
-        offset: number;
-        color: string;
-    }>;
-}
-/**
- * Color configuration - can be solid color or gradient.
- */
-export type QrColorConfig = string | QrGradient;
-/**
- * Complete configuration for QR code generation.
- */
-export interface QrConfig {
-    /** The data to encode (URL, text, etc.) */
-    data: string;
-    /** QR code width in pixels (default: 300) */
-    width?: number;
-    /** QR code height in pixels (default: same as width) */
-    height?: number;
-    /** Quiet zone margin in modules (default: 0) */
-    margin?: number;
-    /** Color/gradient for data dots */
-    dotsColor?: QrColorConfig;
-    /** Background color (default: white) */
-    backgroundColor?: QrColorConfig;
-    /** Color for corner squares */
-    cornersSquareColor?: QrColorConfig;
-    /** Color for corner dots */
-    cornersDotColor?: QrColorConfig;
-    /** Style of data dots (default: 'square') */
-    dotsStyle?: QrDotsStyle;
-    /** Style of corner squares (default: 'square') */
-    cornersSquareStyle?: QrCornersSquareStyle;
-    /** Style of corner dots (default: 'square') */
-    cornersDotStyle?: QrCornersDotStyle;
-    /** Logo/image configuration */
-    logo?: QrLogoConfig;
-    /** Error correction level (default: 'M') */
-    errorCorrectionLevel?: QrErrorCorrectionLevel;
-    /** Output format (default: 'png') */
-    format?: QrOutputFormat;
-    /** Quality for jpeg/webp (0-1, default: 1) */
-    quality?: number;
-}
-/**
- * Result from QR code generation.
- */
-export interface QrResult {
-    /** Original configuration used */
-    config: QrConfig;
-    /** Generated data as base64 data URL */
-    dataUrl: string;
-    /** Generated data as Blob */
-    blob: Blob;
-    /** SVG string (only when format is 'svg') */
-    svg?: string;
-    /** MIME type of the generated image */
-    mimeType: string;
-    /** File extension */
-    extension: string;
-    /** Timestamp of generation */
-    generatedAt: Date;
-}
-/**
- * Options for downloading the QR code.
- */
-export interface QrDownloadOptions {
-    /** Custom filename (without extension) */
-    filename?: string;
-    /** Override format for download */
-    format?: QrOutputFormat;
-}
-/**
- * Options for sharing the QR code.
- */
-export interface QrShareOptions {
-    /** Share title */
-    title?: string;
-    /** Share text/description */
-    text?: string;
-    /** Custom filename for the shared file */
-    filename?: string;
-}
-/**
- * Preset configurations for common use cases.
- */
-export interface QrPreset {
-    name: string;
-    config: Partial<QrConfig>;
-}
-/**
- * Default presets for quick styling.
- */
-export declare const QR_PRESETS: Record<string, Partial<QrConfig>>;

package/lib/services/skeleton/config.d.ts

@@ -1,30 +0,0 @@
-import { EnvironmentProviders } from '@angular/core';
-import { SkeletonConfig } from './types';
-/**
- * Configura el sistema de skeletons para Valtech Components.
- *
- * @param config Configuracion de skeletons
- * @returns Providers para app.config.ts
- *
- * @example
- * // app.config.ts
- * import { provideValtechSkeleton } from 'valtech-components';
- *
- * export const appConfig: ApplicationConfig = {
- *   providers: [
- *     provideValtechSkeleton({
- *       animated: true,
- *       defaultDelay: 100,
- *       defaultMinTime: 500,
- *       templates: [
- *         { name: 'custom-card', component: MyCustomCardSkeleton }
- *       ]
- *     }),
- *   ]
- * };
- *
- * @example
- * // Uso minimo - usa configuracion por defecto
- * providers: [provideValtechSkeleton()]
- */
-export declare function provideValtechSkeleton(config?: SkeletonConfig): EnvironmentProviders;

package/lib/services/skeleton/directives/loading.directive.d.ts

@@ -1,71 +0,0 @@
-import { TemplateRef, OnDestroy } from '@angular/core';
-import { LoadingSource, SkeletonTemplateName } from '../types';
-import * as i0 from "@angular/core";
-/**
- * Directiva estructural simplificada para estados de carga.
- *
- * Soporta multiples fuentes de estado de carga:
- * - Angular Signal<boolean>
- * - RxJS Observable<boolean>
- * - Promise<any> (cargando hasta que se resuelve)
- * - boolean literal
- *
- * @example
- * <!-- Uso simple con signal -->
- * <ng-container *valLoading="isLoading(); skeleton: 'list'">
- *   <app-list [items]="items()"></app-list>
- * </ng-container>
- *
- * @example
- * <!-- Con configuracion -->
- * <ng-container *valLoading="loading$; skeleton: 'grid-cards'; count: 8">
- *   <app-grid [data]="data"></app-grid>
- * </ng-container>
- *
- * @example
- * <!-- Con template personalizado -->
- * <ng-container *valLoading="isLoading(); skeletonTpl: customSkeleton">
- *   <app-content></app-content>
- * </ng-container>
- * <ng-template #customSkeleton>
- *   <val-skeleton [props]="{ type: 'card' }"></val-skeleton>
- * </ng-template>
- */
-export declare class LoadingDirective implements OnDestroy {
-    private readonly templateRef;
-    private readonly viewContainer;
-    private readonly skeletonService;
-    private readonly destroyRef;
-    private readonly _loading;
-    private hasContentView;
-    private skeletonComponentRef;
-    /** Template de skeleton a usar */
-    skeleton: SkeletonTemplateName | string;
-    /** Template personalizado para skeleton */
-    skeletonTpl: TemplateRef<unknown> | null;
-    /** Cantidad de items skeleton */
-    count: number;
-    /** Animacion habilitada */
-    animated: boolean;
-    /** Gap entre items */
-    gap: string | undefined;
-    /** Variante del template */
-    variant: string | undefined;
-    /** Mostrar spinner en lugar de skeleton */
-    spinner: boolean;
-    constructor();
-    /**
-     * Input principal - puede ser boolean, Signal, Observable o Promise.
-     */
-    set loading(source: LoadingSource);
-    ngOnDestroy(): void;
-    private resolveLoadingSource;
-    private updateView;
-    private showSkeleton;
-    private showSkeletonTemplate;
-    private showSpinner;
-    private showFallback;
-    private showContent;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LoadingDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<LoadingDirective, "[valLoading]", never, { "skeleton": { "alias": "valLoadingSkeleton"; "required": false; }; "skeletonTpl": { "alias": "valLoadingSkeletonTpl"; "required": false; }; "count": { "alias": "valLoadingCount"; "required": false; }; "animated": { "alias": "valLoadingAnimated"; "required": false; }; "gap": { "alias": "valLoadingGap"; "required": false; }; "variant": { "alias": "valLoadingVariant"; "required": false; }; "spinner": { "alias": "valLoadingSpinner"; "required": false; }; "loading": { "alias": "valLoading"; "required": false; }; }, {}, never, never, true, never>;
-}

package/lib/services/skeleton/index.d.ts

@@ -1,10 +0,0 @@
-export { SkeletonTemplateName, SkeletonTemplateConfig, LoadingSource, SkeletonDirectiveConfig, LoadingDirectiveConfig, RegisteredSkeletonTemplate, SkeletonConfig, SkeletonTemplateContext, SkeletonTemplateComponent, DEFAULT_SKELETON_CONFIG, } from './types';
-export { SkeletonService } from './skeleton.service';
-export { LoadingDirective } from './directives/loading.directive';
-export { ListSkeletonComponent } from './templates/list-skeleton.component';
-export { GridSkeletonComponent } from './templates/grid-skeleton.component';
-export { FormSkeletonComponent } from './templates/form-skeleton.component';
-export { ProfileSkeletonComponent } from './templates/profile-skeleton.component';
-export { TableSkeletonComponent } from './templates/table-skeleton.component';
-export { DetailSkeletonComponent } from './templates/detail-skeleton.component';
-export { provideValtechSkeleton } from './config';