valtech-components 2.0.687 → 2.0.689

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

@@ -1,113 +0,0 @@
-import { Signal } from '@angular/core';
-import { Observable } from 'rxjs';
-/**
- * Estrategia de paginacion.
- */
-export type PaginationStrategy = 'offset' | 'cursor' | 'page';
-/**
- * Estado de paginacion.
- */
-export interface PaginationState<T> {
-    /** Items actuales */
-    items: T[];
-    /** Pagina actual (para estrategia offset/page) */
-    page: number;
-    /** Tamano de pagina */
-    pageSize: number;
-    /** Conteo total (si se conoce) */
-    total?: number;
-    /** Cursor para siguiente pagina (para estrategia cursor) */
-    nextCursor?: unknown;
-    /** Cursor para pagina anterior */
-    prevCursor?: unknown;
-    /** Si existen mas items */
-    hasMore: boolean;
-    /** Estado de carga */
-    isLoading: boolean;
-    /** Estado de error */
-    error?: Error;
-}
-/**
- * Parametros para funcion de carga.
- */
-export interface PaginationLoadParams {
-    /** Estrategia de paginacion */
-    strategy: PaginationStrategy;
-    /** Numero de pagina */
-    page: number;
-    /** Tamano de pagina */
-    pageSize: number;
-    /** Cursor (para estrategia cursor) */
-    cursor?: unknown;
-    /** Direccion de carga */
-    direction: 'forward' | 'backward';
-}
-/**
- * Resultado de funcion de carga.
- */
-export interface PaginationLoadResult<T> {
-    /** Items cargados */
-    items: T[];
-    /** Si hay mas items */
-    hasMore: boolean;
-    /** Total de items (opcional) */
-    total?: number;
-    /** Cursor para siguiente pagina */
-    nextCursor?: unknown;
-    /** Cursor para pagina anterior */
-    prevCursor?: unknown;
-}
-/**
- * Configuracion para crear un controlador de paginacion.
- */
-export interface PaginationConfig<T> {
-    /** Estrategia de paginacion */
-    strategy: PaginationStrategy;
-    /** Tamano de pagina */
-    pageSize?: number;
-    /** Items iniciales (opcional) */
-    initialItems?: T[];
-    /** Funcion de carga */
-    loadFn: (params: PaginationLoadParams) => Observable<PaginationLoadResult<T>> | Promise<PaginationLoadResult<T>>;
-    /** Funcion de tracking para items */
-    trackBy?: (item: T) => unknown;
-}
-/**
- * Interface del controlador de paginacion.
- */
-export interface PaginationController<T> {
-    /** Estado reactivo como signal */
-    state: Signal<PaginationState<T>>;
-    /** Signal de items (accessor de conveniencia) */
-    items: Signal<T[]>;
-    /** Signal de carga */
-    isLoading: Signal<boolean>;
-    /** Signal de mas items */
-    hasMore: Signal<boolean>;
-    /** Signal de error */
-    error: Signal<Error | null>;
-    /** Signal de pagina actual */
-    currentPage: Signal<number>;
-    /** Signal de total */
-    total: Signal<number | undefined>;
-    /** Cargar siguiente pagina */
-    loadNext(): Promise<void>;
-    /** Cargar pagina anterior (si soportado) */
-    loadPrevious(): Promise<void>;
-    /** Refresh (recargar desde inicio) */
-    refresh(): Promise<void>;
-    /** Reset a estado inicial */
-    reset(): void;
-    /** Actualizar un item */
-    updateItem(predicate: (item: T) => boolean, updates: Partial<T>): void;
-    /** Remover un item */
-    removeItem(predicate: (item: T) => boolean): void;
-    /** Agregar items al inicio */
-    prependItems(items: T[]): void;
-    /** Agregar items al final */
-    appendItems(items: T[]): void;
-}
-/**
- * Estado inicial para controladores de paginacion.
- */
-export declare function createInitialPaginationState<T>(pageSize: number, initialItems?: T[]): PaginationState<T>;

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';