valtech-components 2.0.800 → 2.0.802

package/lib/components/templates/page-wrapper/page-wrapper.component.d.ts

@@ -1,6 +1,8 @@
 import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
 import { ViewWillEnter, ViewWillLeave } from '@ionic/angular/standalone';
 import { ContainerSize } from '../../atoms/container/types';
+import { RefreshEvent } from '../../molecules/refresher/types';
+import { PageRefreshService } from '../../../services/page-refresh/page-refresh.service';
 import { PageWrapperMetadata } from './types';
 import * as i0 from "@angular/core";
 /**
@@ -29,6 +31,13 @@ export declare class PageWrapperComponent implements ViewWillEnter, ViewWillLeav
     private nav;
     private router;
     private routerSubscription?;
+    /** Bus del pull-to-refresh — la página activa registra su handler aquí. */
+    protected pageRefresh: PageRefreshService;
+    /**
+     * Handler del gesto pull-to-refresh. Delega en el handler que registró la
+     * página activa (`PageRefreshService.run`) y cierra el spinner al terminar.
+     */
+    onPageRefresh(event: RefreshEvent): Promise<void>;
     /**
      * Page wrapper configuration.
      * Signal-based input for full reactivity with computed().

package/lib/services/auth/guards.d.ts

@@ -3,6 +3,9 @@ import { CanActivateFn } from '@angular/router';
  * Guard que verifica si el usuario está autenticado.
  * Redirige a loginRoute si no está autenticado.
  *
+ * Preserva la URL solicitada en el query param `returnUrl` para que la
+ * página de login pueda devolver al usuario a su destino tras autenticarse.
+ *
  * @example
  * ```typescript
  * import { authGuard } from 'valtech-components';

package/lib/services/page-refresh/page-refresh.service.d.ts

@@ -0,0 +1,64 @@
+import * as i0 from "@angular/core";
+/**
+ * Handler de refresh que registra una página. Puede ser sync o async —
+ * `val-page-wrapper` espera (`await`) a que termine antes de cerrar el spinner.
+ */
+export type PageRefreshHandler = () => Promise<void> | void;
+/**
+ * PageRefreshService — bus del pull-to-refresh estándar del factory.
+ *
+ * **Por qué existe:** `val-page-wrapper` posee un único `<ion-content>` y todas
+ * las páginas se renderizan dentro vía `<router-outlet>`. Un `<ion-refresher>`
+ * tiene que vivir dentro de ese `ion-content`, así que el refresher NO puede
+ * declararse en el template de cada página — vive una sola vez en
+ * `val-page-wrapper`. Este servicio es el puente: la página activa registra
+ * *qué hacer* al refrescar; el page-wrapper dispara el gesto y cierra el spinner.
+ *
+ * **Uso en una página** (ver `frontend/CLAUDE.md` — es el patrón estándar):
+ *
+ * ```ts
+ * export class MiPage implements ViewWillEnter, ViewWillLeave {
+ *   private pageRefresh = inject(PageRefreshService);
+ *
+ *   ionViewWillEnter(): void {
+ *     this.pageRefresh.register(() => this.reload());
+ *   }
+ *   ionViewWillLeave(): void {
+ *     this.pageRefresh.unregister();
+ *   }
+ *
+ *   private async reload(): Promise<void> {
+ *     // re-fetch / re-suscribir streams / etc.
+ *   }
+ * }
+ * ```
+ *
+ * Páginas que no llaman `register()` simplemente no muestran refresher —
+ * opt-in, sin impacto.
+ */
+export declare class PageRefreshService {
+    private handler;
+    /**
+     * `true` cuando hay una página con handler registrado. `val-page-wrapper`
+     * renderiza el `<val-refresher>` sólo cuando esto es `true`.
+     */
+    readonly hasHandler: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * Registra el handler de refresh de la página activa. Llamar en
+     * `ionViewWillEnter`. Si ya había uno, lo reemplaza (sólo hay una página
+     * activa a la vez en el router-outlet de Ionic).
+     */
+    register(handler: PageRefreshHandler): void;
+    /**
+     * Quita el handler. Llamar en `ionViewWillLeave` para que el refresher
+     * desaparezca al salir de la vista.
+     */
+    unregister(): void;
+    /**
+     * Ejecuta el handler registrado y espera a que termine. Lo invoca
+     * `val-page-wrapper` al detectar el gesto de pull. No-op si no hay handler.
+     */
+    run(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PageRefreshService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PageRefreshService>;
+}

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

@@ -9,6 +9,12 @@ export declare class ToastService {
     constructor(toastController: ToastController);
     /**
      * Presents a toast notification with the given options.
+     *
+     * Estándar Valtech: todos los toasts son `color: 'dark'` y `position: 'top'`.
+     * Estos son los defaults cuando el caller no los especifica — no hace falta
+     * pasarlos en cada llamada. El diferenciador semántico (éxito/error) va en
+     * el mensaje, no en el color.
+     *
      * @param request Toast options (message, duration, position, color, etc.)
      */
     presentToast(request: ToastOptions): Promise<void>;

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "2.0.800";
+export declare const VERSION = "2.0.802";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.800",
+  "version": "2.0.802",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -262,6 +262,7 @@ export * from './lib/services/firebase';
 export * from './lib/services/auth';
 export * from './lib/services/i18n';
 export * from './lib/services/preferences';
+export * from './lib/services/page-refresh/page-refresh.service';
 export * from './lib/services/app-config';
 export * from './lib/services/presets';
 export * from './lib/services/skeleton';