valtech-components 2.0.820 → 2.0.821

package/lib/services/firebase/utils/path-builder.d.ts

@@ -1,132 +0,0 @@
-/**
- * Path Builder
- *
- * Utilidades para construir rutas de Firestore con templates.
- * Soporta rutas multi-nivel y anidadas.
- */
-/**
- * Construye una ruta de Firestore reemplazando placeholders.
- *
- * @param template - Template con placeholders en formato {param}
- * @param params - Objeto con los valores a reemplazar
- * @returns Ruta construida
- * @throws Error si faltan parámetros requeridos
- *
- * @example
- * ```typescript
- * // Ruta simple
- * buildPath('users/{userId}', { userId: 'abc123' });
- * // => 'users/abc123'
- *
- * // Ruta anidada
- * buildPath('users/{userId}/documents/{docId}', {
- *   userId: 'abc123',
- *   docId: 'doc456'
- * });
- * // => 'users/abc123/documents/doc456'
- *
- * // Múltiples niveles
- * buildPath('orgs/{orgId}/teams/{teamId}/members/{memberId}', {
- *   orgId: 'org1',
- *   teamId: 'team2',
- *   memberId: 'member3'
- * });
- * // => 'orgs/org1/teams/team2/members/member3'
- * ```
- */
-export declare function buildPath(template: string, params: Record<string, string>): string;
-/**
- * Extrae los nombres de los parámetros de un template de ruta.
- *
- * @param template - Template de ruta
- * @returns Array con los nombres de los parámetros
- *
- * @example
- * ```typescript
- * extractParams('users/{userId}/documents/{docId}');
- * // => ['userId', 'docId']
- * ```
- */
-export declare function extractPathParams(template: string): string[];
-/**
- * Valida que una ruta de Firestore sea válida.
- *
- * @param path - Ruta a validar
- * @returns true si la ruta es válida
- *
- * @example
- * ```typescript
- * isValidPath('users/abc123');           // true
- * isValidPath('users/abc123/documents'); // true
- * isValidPath('users//documents');       // false (segmento vacío)
- * isValidPath('');                       // false (vacío)
- * ```
- */
-export declare function isValidPath(path: string): boolean;
-/**
- * Obtiene la ruta de la colección padre de un documento.
- *
- * @param documentPath - Ruta completa del documento
- * @returns Ruta de la colección padre
- *
- * @example
- * ```typescript
- * getCollectionPath('users/abc123');
- * // => 'users'
- *
- * getCollectionPath('users/abc123/documents/doc456');
- * // => 'users/abc123/documents'
- * ```
- */
-export declare function getCollectionPath(documentPath: string): string;
-/**
- * Obtiene el ID del documento de una ruta.
- *
- * @param documentPath - Ruta completa del documento
- * @returns ID del documento
- *
- * @example
- * ```typescript
- * getDocumentId('users/abc123');
- * // => 'abc123'
- *
- * getDocumentId('users/abc123/documents/doc456');
- * // => 'doc456'
- * ```
- */
-export declare function getDocumentId(documentPath: string): string;
-/**
- * Verifica si una ruta apunta a un documento (número par de segmentos).
- *
- * @param path - Ruta a verificar
- * @returns true si es una ruta de documento
- *
- * @example
- * ```typescript
- * isDocumentPath('users/abc123');           // true
- * isDocumentPath('users');                  // false (colección)
- * isDocumentPath('users/abc123/documents'); // false (colección)
- * ```
- */
-export declare function isDocumentPath(path: string): boolean;
-/**
- * Verifica si una ruta apunta a una colección (número impar de segmentos).
- *
- * @param path - Ruta a verificar
- * @returns true si es una ruta de colección
- */
-export declare function isCollectionPath(path: string): boolean;
-/**
- * Combina una ruta base con segmentos adicionales.
- *
- * @param basePath - Ruta base
- * @param segments - Segmentos adicionales
- * @returns Ruta combinada
- *
- * @example
- * ```typescript
- * joinPath('users', 'abc123', 'documents');
- * // => 'users/abc123/documents'
- * ```
- */
-export declare function joinPath(...segments: string[]): string;

package/lib/services/firebase/utils/query-builder.d.ts

@@ -1,210 +0,0 @@
-/**
- * Query Builder
- *
- * Builder fluido para construir queries de Firestore de manera legible.
- * Alternativa más expresiva a pasar objetos QueryOptions directamente.
- */
-import { OrderDirection, QueryOptions, WhereOperator } from '../types';
-/**
- * Builder fluido para queries de Firestore.
- *
- * @example
- * ```typescript
- * // Construir query con builder
- * const options = new QueryBuilder()
- *   .where('status', '==', 'active')
- *   .where('age', '>=', 18)
- *   .orderBy('createdAt', 'desc')
- *   .limit(10)
- *   .build();
- *
- * // Usar con FirestoreService
- * const users = await firestoreService.getDocs<User>('users', options);
- *
- * // O con método estático
- * const options2 = QueryBuilder.create()
- *   .where('category', '==', 'electronics')
- *   .orderBy('price', 'asc')
- *   .build();
- * ```
- */
-export declare class QueryBuilder {
-    private whereConditions;
-    private orderByConditions;
-    private limitValue?;
-    private startAfterValue?;
-    private startAtValue?;
-    private endBeforeValue?;
-    private endAtValue?;
-    /**
-     * Crea una nueva instancia del builder (método estático alternativo).
-     */
-    static create(): QueryBuilder;
-    /**
-     * Agrega una condición where.
-     *
-     * @param field - Campo a filtrar
-     * @param operator - Operador de comparación
-     * @param value - Valor a comparar
-     *
-     * @example
-     * ```typescript
-     * builder.where('status', '==', 'active')
-     * builder.where('price', '>=', 100)
-     * builder.where('tags', 'array-contains', 'featured')
-     * builder.where('category', 'in', ['electronics', 'books'])
-     * ```
-     */
-    where(field: string, operator: WhereOperator, value: unknown): QueryBuilder;
-    /**
-     * Shortcut para where con operador '=='.
-     *
-     * @example
-     * ```typescript
-     * builder.whereEquals('status', 'active')
-     * // equivalente a: builder.where('status', '==', 'active')
-     * ```
-     */
-    whereEquals(field: string, value: unknown): QueryBuilder;
-    /**
-     * Shortcut para where con operador '!='.
-     */
-    whereNotEquals(field: string, value: unknown): QueryBuilder;
-    /**
-     * Shortcut para where con operador '>'.
-     */
-    whereGreaterThan(field: string, value: unknown): QueryBuilder;
-    /**
-     * Shortcut para where con operador '>='.
-     */
-    whereGreaterOrEqual(field: string, value: unknown): QueryBuilder;
-    /**
-     * Shortcut para where con operador '<'.
-     */
-    whereLessThan(field: string, value: unknown): QueryBuilder;
-    /**
-     * Shortcut para where con operador '<='.
-     */
-    whereLessOrEqual(field: string, value: unknown): QueryBuilder;
-    /**
-     * Shortcut para where con operador 'array-contains'.
-     *
-     * @example
-     * ```typescript
-     * builder.whereArrayContains('tags', 'featured')
-     * ```
-     */
-    whereArrayContains(field: string, value: unknown): QueryBuilder;
-    /**
-     * Shortcut para where con operador 'array-contains-any'.
-     *
-     * @example
-     * ```typescript
-     * builder.whereArrayContainsAny('tags', ['featured', 'new'])
-     * ```
-     */
-    whereArrayContainsAny(field: string, values: unknown[]): QueryBuilder;
-    /**
-     * Shortcut para where con operador 'in'.
-     *
-     * @example
-     * ```typescript
-     * builder.whereIn('status', ['active', 'pending'])
-     * ```
-     */
-    whereIn(field: string, values: unknown[]): QueryBuilder;
-    /**
-     * Shortcut para where con operador 'not-in'.
-     */
-    whereNotIn(field: string, values: unknown[]): QueryBuilder;
-    /**
-     * Agrega ordenamiento por un campo.
-     *
-     * @param field - Campo por el cual ordenar
-     * @param direction - Dirección: 'asc' o 'desc' (default: 'asc')
-     *
-     * @example
-     * ```typescript
-     * builder.orderBy('createdAt', 'desc')
-     * builder.orderBy('name') // asc por defecto
-     * ```
-     */
-    orderBy(field: string, direction?: OrderDirection): QueryBuilder;
-    /**
-     * Shortcut para orderBy descendente.
-     */
-    orderByDesc(field: string): QueryBuilder;
-    /**
-     * Shortcut para orderBy ascendente.
-     */
-    orderByAsc(field: string): QueryBuilder;
-    /**
-     * Limita el número de resultados.
-     *
-     * @param count - Número máximo de documentos
-     *
-     * @example
-     * ```typescript
-     * builder.limit(10)
-     * ```
-     */
-    limit(count: number): QueryBuilder;
-    /**
-     * Cursor para paginación: empezar después de un documento.
-     *
-     * @param cursor - Documento o snapshot desde donde continuar
-     *
-     * @example
-     * ```typescript
-     * // Primera página
-     * const page1 = await service.getPaginated('users', builder.limit(10).build());
-     *
-     * // Siguiente página
-     * const page2 = await service.getPaginated('users',
-     *   builder.startAfter(page1.lastDoc).limit(10).build()
-     * );
-     * ```
-     */
-    startAfter(cursor: unknown): QueryBuilder;
-    /**
-     * Cursor para paginación: empezar en un documento.
-     */
-    startAt(cursor: unknown): QueryBuilder;
-    /**
-     * Cursor para paginación: terminar antes de un documento.
-     */
-    endBefore(cursor: unknown): QueryBuilder;
-    /**
-     * Cursor para paginación: terminar en un documento.
-     */
-    endAt(cursor: unknown): QueryBuilder;
-    /**
-     * Construye el objeto QueryOptions.
-     *
-     * @returns QueryOptions para usar con FirestoreService
-     */
-    build(): QueryOptions;
-    /**
-     * Resetea el builder para reutilización.
-     */
-    reset(): QueryBuilder;
-    /**
-     * Clona el builder actual.
-     */
-    clone(): QueryBuilder;
-}
-/**
- * Función helper para crear un QueryBuilder.
- *
- * @example
- * ```typescript
- * import { query } from 'valtech-components';
- *
- * const options = query()
- *   .where('status', '==', 'active')
- *   .orderBy('createdAt', 'desc')
- *   .limit(10)
- *   .build();
- * ```
- */
-export declare function query(): QueryBuilder;

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

@@ -1,29 +0,0 @@
-import { EnvironmentProviders } from '@angular/core';
-import { I18nConfig } from './types';
-/**
- * Configura el sistema de internacionalización de Valtech Components.
- *
- * @param config Configuración de i18n
- * @returns Providers para agregar en app.config.ts
- *
- * @example
- * // app.config.ts
- * import { provideValtechI18n } from 'valtech-components';
- * import { GLOBAL_CONTENT } from './i18n/_global';
- * import { LOGIN_CONTENT } from './i18n/login.i18n';
- *
- * export const appConfig: ApplicationConfig = {
- *   providers: [
- *     provideValtechI18n({
- *       defaultLanguage: 'es',
- *       supportedLanguages: ['es', 'en'],
- *       detectBrowserLanguage: true,
- *       content: {
- *         '_global': GLOBAL_CONTENT,
- *         'Login': LOGIN_CONTENT,
- *       }
- *     }),
- *   ]
- * };
- */
-export declare function provideValtechI18n(config?: I18nConfig): EnvironmentProviders;

package/lib/services/i18n/default-content.d.ts

@@ -1,30 +0,0 @@
-import { ContentStore } from './types';
-/**
- * Traducciones por defecto de valtech-components.
- *
- * Estas traducciones se cargan automáticamente cuando se usa provideValtechI18n()
- * sin necesidad de configuración adicional.
- *
- * Las apps pueden sobrescribir cualquier key pasando su propio content:
- *
- * @example Sobrescribir traducciones específicas
- * ```typescript
- * provideValtechI18n({
- *   content: {
- *     _global: {
- *       es: { success: '¡Lo hicimos!' },  // Sobrescribe solo esta key
- *       en: { success: 'We did it!' },
- *     },
- *   },
- * })
- * ```
- *
- * @example Desactivar traducciones por defecto
- * ```typescript
- * provideValtechI18n({
- *   includeDefaultContent: false,
- *   content: MY_CUSTOM_CONTENT,
- * })
- * ```
- */
-export declare const VALTECH_DEFAULT_CONTENT: ContentStore;

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

@@ -1,128 +0,0 @@
-import { I18nLang, LanguagesContent, ContentStore } from './types';
-import * as i0 from "@angular/core";
-/**
- * Servicio de internacionalización basado en Angular Signals.
- *
- * Características:
- * - Sin RxJS: usa Signals para evitar memory leaks y congelamiento
- * - Namespace-based: organiza traducciones por contexto
- * - Fallback multi-nivel: namespace → _global → placeholder
- * - Interpolación: soporta {variable} en textos
- *
- * @example
- * // En un componente
- * i18n = inject(I18nService);
- *
- * // Obtener texto
- * const title = this.i18n.t('title', 'Login');
- *
- * // Con interpolación
- * const welcome = this.i18n.t('welcome', 'Login', { name: 'Juan' });
- *
- * // Cambiar idioma
- * this.i18n.setLanguage('en');
- */
-export declare class I18nService {
-    private readonly _lang;
-    private readonly _content;
-    private readonly _supportedLanguages;
-    readonly lang: import("@angular/core").Signal<I18nLang>;
-    readonly supportedLanguages: import("@angular/core").Signal<I18nLang[]>;
-    readonly isSpanish: import("@angular/core").Signal<boolean>;
-    readonly isEnglish: import("@angular/core").Signal<boolean>;
-    constructor();
-    /**
-     * Obtiene texto traducido (alias corto de getText)
-     *
-     * @param key Clave del texto
-     * @param namespace Namespace (default: '_global')
-     * @param data Variables para interpolación
-     * @returns Texto traducido o placeholder [namespace.key]
-     *
-     * @example
-     * i18n.t('submit');                    // busca en _global
-     * i18n.t('title', 'Login');            // busca en Login
-     * i18n.t('welcome', 'Login', {name});  // con interpolación
-     */
-    t(key: string, namespace?: string, data?: Record<string, string>): string;
-    /**
-     * Returns a time-of-day greeting in the current language.
-     *
-     * Uses bundled keys `goodMorning` / `goodAfternoon` / `goodEvening` from `_global`.
-     * Reactive to `lang()` when called inside a `computed()`.
-     *
-     * @param name Optional name to append: "Buenos días, Juan"
-     * @param date Optional date to evaluate (defaults to now)
-     *
-     * @example
-     * greeting = computed(() => {
-     *   this.i18n.lang();
-     *   return this.i18n.greeting(this.auth.user()?.name);
-     * });
-     */
-    greeting(name?: string, date?: Date): string;
-    /**
-     * Obtiene texto traducido
-     *
-     * Fallback order:
-     * 1. content[namespace][lang][key]
-     * 2. content['_global'][lang][key]
-     * 3. "[namespace.key]" (placeholder)
-     */
-    getText(key: string, namespace?: string, data?: Record<string, string>): string;
-    /**
-     * Cambia el idioma de la aplicación
-     *
-     * @param lang Nuevo idioma
-     * @param forceReload Si true, recarga la página (fallback si reactividad falla)
-     */
-    setLanguage(lang: I18nLang, forceReload?: boolean): void;
-    /**
-     * Registra contenido de traducciones para un namespace
-     *
-     * @param namespace Nombre del namespace
-     * @param content Contenido de traducciones
-     *
-     * @example
-     * i18n.registerContent('Login', {
-     *   es: { title: 'Iniciar sesión' },
-     *   en: { title: 'Sign in' }
-     * });
-     */
-    registerContent(namespace: string, content: LanguagesContent): void;
-    /**
-     * Registra múltiples namespaces de una vez
-     *
-     * @param contentStore Objeto con namespaces como keys
-     */
-    registerContentBulk(contentStore: ContentStore): void;
-    /**
-     * Configura los idiomas soportados
-     */
-    setI18nLanguages(languages: I18nLang[]): void;
-    /**
-     * Obtiene todos los namespaces registrados
-     */
-    getNamespaces(): string[];
-    /**
-     * Verifica si un namespace tiene traducciones
-     */
-    hasNamespace(namespace: string): boolean;
-    /**
-     * Carga idioma guardado en localStorage o detecta del navegador
-     */
-    private loadStoredLanguage;
-    /**
-     * Valida si un idioma está soportado
-     */
-    private isValidLanguage;
-    /**
-     * Reemplaza {variable} en texto con valores de data
-     *
-     * @example
-     * interpolate('Hola {name}', { name: 'Juan' }) // 'Hola Juan'
-     */
-    private interpolate;
-    static ɵfac: i0.ɵɵFactoryDeclaration<I18nService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<I18nService>;
-}

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

@@ -1,6 +0,0 @@
-export { I18nLang, LanguagesContent, ContentStore, I18nConfig, LANG_STORAGE_KEY, } from './types';
-export { I18nService } from './i18n.service';
-export { InputI18nHelper, InputMetadataWithI18n, FormMetadataWithI18n, FormSectionWithI18n, ButtonMetadataWithI18n, } from './input-i18n.helper';
-export { TranslatePipe } from './translate.pipe';
-export { provideValtechI18n } from './config';
-export { VALTECH_DEFAULT_CONTENT } from './default-content';

package/lib/services/i18n/input-i18n.helper.d.ts

@@ -1,70 +0,0 @@
-import { InputMetadata, FormMetadata, ButtonMetadata, ComponentState } from '../../components/types';
-import * as i0 from "@angular/core";
-/**
- * Helper para resolver traducciones i18n en InputMetadata y FormMetadata.
- *
- * @example
- * ```typescript
- * helper = inject(InputI18nHelper);
- *
- * // Resolver un input
- * emailInput = this.helper.resolveInput({
- *   ...baseEmailInput,
- *   labelKey: 'email',
- *   placeholderKey: 'emailPlaceholder',
- *   errorKeys: { required: 'emailRequired', email: 'emailInvalid' },
- *   i18nNamespace: '_auth',
- * });
- *
- * // Resolver un form completo
- * loginForm = this.helper.resolveForm(loginFormConfig);
- * ```
- */
-export declare class InputI18nHelper {
-    private i18n;
-    /**
-     * Resuelve traducciones para un InputMetadata.
-     * Si hay keys de i18n, las resuelve; sino, usa los valores directos.
-     */
-    resolveInput(input: InputMetadataWithI18n): InputMetadata;
-    /**
-     * Resuelve traducciones para un FormMetadata completo.
-     * Lee i18n.lang() para crear dependencia reactiva con computed().
-     */
-    resolveForm(form: FormMetadataWithI18n): FormMetadata;
-    /**
-     * Resuelve traducciones para un ButtonMetadata.
-     */
-    resolveButton(button: ButtonMetadataWithI18n, namespace?: string): ButtonMetadata;
-    /**
-     * Resuelve un mapa de error keys a mensajes traducidos.
-     */
-    private resolveErrors;
-    static ɵfac: i0.ɵɵFactoryDeclaration<InputI18nHelper, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<InputI18nHelper>;
-}
-export interface InputMetadataWithI18n extends Partial<InputMetadata> {
-    i18nNamespace?: string;
-    labelKey?: string;
-    placeholderKey?: string;
-    hintKey?: string;
-    errorKeys?: Record<string, string>;
-}
-export interface FormSectionWithI18n {
-    name?: string;
-    nameKey?: string;
-    order: number;
-    fields: InputMetadataWithI18n[];
-}
-export interface FormMetadataWithI18n {
-    name?: string;
-    nameKey?: string;
-    i18nNamespace?: string;
-    sections: FormSectionWithI18n[];
-    actions: ButtonMetadataWithI18n;
-    state: ComponentState;
-}
-export interface ButtonMetadataWithI18n extends Partial<ButtonMetadata> {
-    i18nNamespace?: string;
-    textKey?: string;
-}

package/lib/services/i18n/translate.pipe.d.ts

@@ -1,36 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import * as i0 from "@angular/core";
-/**
- * Pipe de traducción para templates.
- *
- * NOTA: Es impure para detectar cambios de idioma.
- * El costo es mínimo porque I18nService usa Signals internamente.
- *
- * @example
- * <!-- Busca en _global -->
- * {{ 'submit' | t }}
- *
- * <!-- Busca en namespace específico -->
- * {{ 'title' | t:'Login' }}
- *
- * <!-- Con interpolación -->
- * {{ 'welcome' | t:'Login':{ name: userName } }}
- *
- * <!-- En atributos -->
- * <val-button [label]="'submit' | t"></val-button>
- * <val-input [label]="'email' | t:'Login'"></val-input>
- */
-export declare class TranslatePipe implements PipeTransform {
-    private readonly i18n;
-    /**
-     * Transforma una key de traducción a su valor
-     *
-     * @param key Clave del texto
-     * @param namespace Namespace opcional (default: '_global')
-     * @param data Variables para interpolación opcional
-     * @returns Texto traducido
-     */
-    transform(key: string, namespace?: string, data?: Record<string, string>): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TranslatePipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<TranslatePipe, "t", true>;
-}