valtech-components 2.0.808 → 2.0.810

package/lib/components/molecules/update-banner/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * UpdateBanner Types
+ *
+ * Contenido i18n del banner de actualización de la app.
+ */
+/**
+ * Namespace i18n usado por `val-update-banner`.
+ * Las apps consumidoras pueden sobreescribir estas keys registrando
+ * contenido bajo este namespace en `I18nService`.
+ */
+export declare const UPDATE_BANNER_I18N_NAMESPACE = "UpdateBanner";
+/**
+ * Textos por defecto del banner (fallback si la app no registra el namespace).
+ * Soporta es / en / pt.
+ */
+export declare const UPDATE_BANNER_DEFAULT_CONTENT: {
+    readonly es: {
+        readonly availableTitle: "Hay una versión nueva disponible";
+        readonly availableMessage: "Actualiza para obtener las últimas mejoras.";
+        readonly requiredTitle: "Debes actualizar para continuar";
+        readonly requiredMessage: "Esta versión ya no es compatible. Actualiza para seguir.";
+        readonly updateAction: "Actualizar";
+        readonly dismissAction: "Cerrar";
+    };
+    readonly en: {
+        readonly availableTitle: "A new version is available";
+        readonly availableMessage: "Update to get the latest improvements.";
+        readonly requiredTitle: "You must update to continue";
+        readonly requiredMessage: "This version is no longer supported. Please update.";
+        readonly updateAction: "Update";
+        readonly dismissAction: "Close";
+    };
+    readonly pt: {
+        readonly availableTitle: "Há uma nova versão disponível";
+        readonly availableMessage: "Atualize para obter as últimas melhorias.";
+        readonly requiredTitle: "Você precisa atualizar para continuar";
+        readonly requiredMessage: "Esta versão não é mais compatível. Atualize para seguir.";
+        readonly updateAction: "Atualizar";
+        readonly dismissAction: "Fechar";
+    };
+};

package/lib/components/molecules/update-banner/update-banner.component.d.ts

@@ -1,42 +1,48 @@
-import { BannerMetadata } from '../../organisms/banner/types';
 import * as i0 from "@angular/core";
 /**
  * val-update-banner
  *
- * Banner de actualización que aparece cuando hay una nueva versión disponible.
- * Se cierra automáticamente cuando el usuario hace clic en "Actualizar" o en cerrar.
+ * Avisa al usuario de una versión nueva. Colócalo una sola vez, alto en el
+ * árbol de la app (p.ej. en `app.component` por encima del router outlet)
+ * para que sea visible en cualquier ruta.
  *
  * @example
  * ```html
- * <!-- Uso básico -->
  * <val-update-banner />
- *
- * <!-- El banner solo aparece si hay actualización disponible -->
  * ```
  */
 export declare class UpdateBannerComponent {
-    private appConfig;
-    private i18n;
-    /**
-     * Signal para controlar si el banner fue descartado por el usuario.
-     */
-    private dismissed;
+    private readonly version;
+    private readonly i18n;
     /**
-     * Indica si el banner debe mostrarse.
+     * True cuando el banner está en modo obligatorio (hard gate, no descartable).
      */
-    readonly show: import("@angular/core").Signal<boolean>;
+    readonly required: import("@angular/core").Signal<boolean>;
     /**
-     * Props del banner calculadas reactivamente.
+     * True cuando el banner debe renderizarse:
+     * - siempre que el estado sea `update-required`, o
+     * - si es `update-available` y el usuario no lo descartó.
      */
-    readonly bannerProps: import("@angular/core").Signal<BannerMetadata>;
+    readonly visible: import("@angular/core").Signal<boolean>;
     /**
-     * Maneja el clic en acciones del banner.
+     * Textos resolvidos del banner. Reactivo a idioma y al estado required.
+     * Usa el namespace `UpdateBanner` de `I18nService` con fallback embebido.
      */
-    onAction(token: string): void;
+    readonly t: import("@angular/core").Signal<{
+        title: string;
+        message: string;
+        updateAction: string;
+        dismissAction: string;
+    }>;
+    /** Aplica la actualización (activa el SW si existe + recarga). */
+    onUpdate(): void;
+    /** Descarta el banner opcional. No-op en modo obligatorio. */
+    onDismiss(): void;
     /**
-     * Descarta el banner temporalmente (hasta que se recargue la página).
+     * Resuelve una key i18n del namespace `UpdateBanner` con fallback al
+     * contenido por defecto embebido (es / en / pt).
      */
-    dismiss(): void;
+    private tr;
     static ɵfac: i0.ɵɵFactoryDeclaration<UpdateBannerComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<UpdateBannerComponent, "val-update-banner", never, {}, {}, never, never, true, never>;
 }

package/lib/components/organisms/faq/faq.component.d.ts

@@ -0,0 +1,38 @@
+import { AccordionMetadata } from '../../molecules/accordion/types';
+import { FaqCategory, FaqMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-faq`
+ *
+ * Organism de preguntas frecuentes. Q&A categorizado con accordion colapsable
+ * y buscador en vivo. Pensado para vistas FAQ públicas — el caller puede
+ * reusar la misma data (`FaqMetadata.categories`) para emitir el structured
+ * data `FAQPage` (JSON-LD) y ganar rich results en buscadores.
+ *
+ * Compone `val-accordion` (una por categoría) + `val-searchbar`.
+ *
+ * @example
+ * ```html
+ * <val-faq [props]="{ categories: faqCategories, searchable: true }" />
+ * ```
+ */
+export declare class FaqComponent {
+    private readonly props_;
+    set props(value: FaqMetadata | undefined);
+    get props(): FaqMetadata;
+    /** Término de búsqueda actual (lowercase). */
+    private readonly query;
+    /**
+     * Categorías visibles tras aplicar el filtro de búsqueda. Una categoría
+     * desaparece si ninguna de sus preguntas matchea. El match es sobre
+     * pregunta + respuesta, case-insensitive.
+     */
+    readonly visibleCategories: import("@angular/core").Signal<FaqCategory[]>;
+    /** `true` si se debe mostrar el label de cada categoría. */
+    readonly showCategoryLabel: import("@angular/core").Signal<boolean>;
+    /** Mapea una categoría a `AccordionMetadata` para `val-accordion`. */
+    accordionFor(cat: FaqCategory): AccordionMetadata;
+    onSearch(term: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FaqComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FaqComponent, "val-faq", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/faq/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Tipos del organism `val-faq`.
+ *
+ * Modelo Q&A categorizado. Pensado para vistas FAQ públicas (sitio corporativo)
+ * — el caller también puede usar la misma data para emitir structured data
+ * `FAQPage` (JSON-LD) y ganar rich results en buscadores.
+ */
+/** Una pregunta-respuesta. */
+export interface FaqItem {
+    /** Identificador único dentro de la FAQ — usado como track + accordion value. */
+    id: string;
+    /** La pregunta. */
+    question: string;
+    /** La respuesta. Texto plano (los saltos de línea se respetan). */
+    answer: string;
+}
+/** Grupo de preguntas bajo un tema. */
+export interface FaqCategory {
+    /** Identificador único de la categoría. */
+    id: string;
+    /** Etiqueta visible del grupo. */
+    label: string;
+    /** Preguntas del grupo. */
+    items: FaqItem[];
+}
+/**
+ * Configuración del organism `val-faq`.
+ *
+ * @example
+ * ```html
+ * <val-faq
+ *   [props]="{
+ *     categories: faqCategories,
+ *     searchable: true,
+ *     searchPlaceholder: 'Buscar...',
+ *   }"
+ * />
+ * ```
+ */
+export interface FaqMetadata {
+    /** Categorías con sus preguntas, en orden de aparición. */
+    categories: FaqCategory[];
+    /** Muestra el buscador que filtra preguntas en vivo. Default `true`. */
+    searchable?: boolean;
+    /** Placeholder del buscador. */
+    searchPlaceholder?: string;
+    /** Permite varias preguntas abiertas a la vez. Default `false`. */
+    multiple?: boolean;
+    /** Texto cuando la búsqueda no arroja resultados. */
+    noResultsText?: string;
+    /** Oculta el label de categoría cuando solo hay una. Default `true`. */
+    hideSingleCategoryLabel?: boolean;
+}

package/lib/services/app-version/app-version.service.d.ts

@@ -0,0 +1,64 @@
+import { Signal } from '@angular/core';
+import { AppVersionStatus } from './types';
+import * as i0 from "@angular/core";
+export declare class AppVersionService {
+    /** SwUpdate solo existe si el SW está registrado (prod build). */
+    private readonly swUpdate;
+    /** AppConfigService es opcional: la app puede no wirearlo. */
+    private readonly appConfig;
+    private readonly serviceConfig;
+    private readonly document;
+    private readonly destroyRef;
+    /** True cuando el SW reportó un bundle nuevo listo (`VERSION_READY`). */
+    private readonly swUpdateReady;
+    /**
+     * True cuando el usuario descartó el banner de actualización opcional.
+     * El banner obligatorio (`update-required`) ignora este flag.
+     */
+    private readonly _dismissed;
+    readonly dismissed: Signal<boolean>;
+    /**
+     * Versión local del build actual de la app.
+     * Proviene del provider `provideValtechAppVersion({ currentVersion })`.
+     */
+    readonly currentVersion: Signal<string>;
+    /**
+     * Última versión publicada según el config remoto.
+     * `null` si `AppConfigService` no está disponible o aún no cargó.
+     */
+    readonly latestVersion: Signal<string | null>;
+    /**
+     * Estado de la versión:
+     * - `update-required` — la versión local quedó por debajo de `minVersion`
+     *   del config remoto. Hard gate. Solo si `AppConfigService` tiene datos.
+     * - `update-available` — el SW descargó un bundle nuevo (`VERSION_READY`)
+     *   o `AppConfigService.hasUpdate` es true.
+     * - `up-to-date` — en cualquier otro caso.
+     */
+    readonly status: Signal<AppVersionStatus>;
+    constructor();
+    /**
+     * Aplica la actualización pendiente.
+     *
+     * Si el SW está habilitado, activa la versión descargada y recarga; si no,
+     * solo recarga la página (la web obtiene el bundle nuevo del servidor).
+     */
+    applyUpdate(): Promise<void>;
+    /**
+     * Descarta el banner de actualización opcional.
+     * No tiene efecto sobre el estado `update-required` (hard gate).
+     */
+    dismiss(): void;
+    /**
+     * Fuerza un chequeo de actualización del service worker.
+     * No-op si el SW no está habilitado.
+     */
+    checkNow(): Promise<void>;
+    /**
+     * Suscribe `versionUpdates`, programa chequeos periódicos y reacciona al
+     * volver la app a foreground. Solo actúa si el SW está habilitado.
+     */
+    private wireServiceWorker;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AppVersionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AppVersionService>;
+}

package/lib/services/app-version/config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * AppVersion Provider
+ *
+ * Provider e injection token para el servicio de verificación de versión.
+ */
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+import { AppVersionServiceConfig } from './types';
+/**
+ * Token de inyección para la configuración de AppVersionService.
+ */
+export declare const VALTECH_APP_VERSION: InjectionToken<Required<AppVersionServiceConfig>>;
+/**
+ * Provee el servicio de verificación de versión a la aplicación Angular.
+ *
+ * Detecta cuándo hay una versión nueva de la app combinando dos señales:
+ * - `SwUpdate` (PWA service worker) — bundle nuevo descargado y listo.
+ * - `AppConfigService` (config remoto en Firestore) — `version` / `minVersion`.
+ *
+ * @param config - Configuración del servicio. `currentVersion` es obligatorio.
+ * @returns EnvironmentProviders para usar en bootstrapApplication.
+ *
+ * @example
+ * ```typescript
+ * // main.ts
+ * import { provideValtechAppVersion } from 'valtech-components';
+ * import pkg from '../package.json';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideValtechAppVersion({ currentVersion: pkg.version }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function provideValtechAppVersion(config: AppVersionServiceConfig): EnvironmentProviders;

package/lib/services/app-version/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AppVersion Service Module
+ *
+ * Verificación de versión de la app para PWA / web. Detecta cuándo hay una
+ * versión nueva combinando el service worker (`SwUpdate`) y el config remoto
+ * (`AppConfigService`), con soporte para actualización obligatoria (hard gate).
+ *
+ * @example
+ * ```typescript
+ * // main.ts
+ * import { provideValtechAppVersion } from 'valtech-components';
+ * import pkg from '../package.json';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideValtechAppVersion({ currentVersion: pkg.version }),
+ *   ],
+ * });
+ * ```
+ */
+export * from './types';
+export { VALTECH_APP_VERSION, provideValtechAppVersion } from './config';
+export { AppVersionService } from './app-version.service';

package/lib/services/app-version/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * AppVersion Types
+ *
+ * Tipos para el servicio de verificación de versión de la aplicación.
+ */
+/**
+ * Estado de la versión de la aplicación respecto a la versión publicada.
+ *
+ * - `up-to-date`   — la app está al día, no hay nada que hacer.
+ * - `update-available` — hay una versión nueva (bundle del SW listo o config
+ *   remoto más nuevo). El usuario puede actualizar pero NO está obligado.
+ * - `update-required` — la versión local quedó por debajo de `minVersion`
+ *   del config remoto (hard gate). El usuario DEBE actualizar para continuar.
+ */
+export type AppVersionStatus = 'up-to-date' | 'update-available' | 'update-required';
+/**
+ * Configuración para el proveedor de AppVersionService.
+ *
+ * @property currentVersion - Versión del build actual de la app (semver string).
+ *   Normalmente proviene del `version` de `package.json`.
+ * @property checkIntervalMs - Intervalo (ms) entre llamadas a
+ *   `SwUpdate.checkForUpdate()`. Default: 30 minutos.
+ */
+export interface AppVersionServiceConfig {
+    currentVersion: string;
+    checkIntervalMs?: number;
+}
+/**
+ * Intervalo por defecto de chequeo de actualizaciones: 30 minutos.
+ */
+export declare const DEFAULT_CHECK_INTERVAL_MS: number;
+/**
+ * Configuración por defecto del servicio.
+ */
+export declare const DEFAULT_APP_VERSION_SERVICE_CONFIG: Required<AppVersionServiceConfig>;

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.808";
+export declare const VERSION = "2.0.810";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.808",
+  "version": "2.0.810",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"
@@ -14,6 +14,7 @@
     "@angular/common": "^18.0.0",
     "@angular/core": "^18.0.0",
     "@angular/fire": "^18.0.1",
+    "@angular/service-worker": "^18.0.0",
     "@capacitor/app": ">=5.0.0",
     "@capacitor/clipboard": "^6.0.1",
     "@ionic/angular": "^8.0.0",
@@ -24,6 +25,9 @@
   "peerDependenciesMeta": {
     "@capacitor/app": {
       "optional": true
+    },
+    "@angular/service-worker": {
+      "optional": true
     }
   },
   "dependencies": {

package/public-api.d.ts

@@ -167,6 +167,7 @@ export * from './lib/components/molecules/links-accordion/types';
 export * from './lib/components/molecules/refresher/refresher.component';
 export * from './lib/components/molecules/refresher/types';
 export * from './lib/components/molecules/update-banner/update-banner.component';
+export * from './lib/components/molecules/update-banner/types';
 export * from './lib/components/molecules/action-card/action-card.component';
 export * from './lib/components/molecules/action-card/types';
 export * from './lib/components/molecules/username-input/username-input.component';
@@ -225,6 +226,8 @@ export * from './lib/components/organisms/avatar-upload/avatar-upload.component'
 export * from './lib/components/organisms/avatar-upload/types';
 export * from './lib/components/organisms/skeleton-layout/skeleton-layout.component';
 export * from './lib/components/organisms/skeleton-layout/types';
+export * from './lib/components/organisms/faq/faq.component';
+export * from './lib/components/organisms/faq/types';
 export * from './lib/components/templates/simple/simple.component';
 export * from './lib/components/templates/simple/types';
 export * from './lib/components/templates/page-template/page-template.component';
@@ -265,6 +268,7 @@ export * from './lib/services/preferences';
 export * from './lib/services/page-refresh/page-refresh.service';
 export * from './lib/services/refreshable-stream';
 export * from './lib/services/app-config';
+export * from './lib/services/app-version';
 export * from './lib/services/presets';
 export * from './lib/services/skeleton';
 export * from './lib/services/pagination';