valtech-components 2.0.972 → 2.0.975

package/lib/components/organisms/profile-view/profile-view.component.d.ts

@@ -1,4 +1,6 @@
 import { AvatarUploadError, AvatarUploadMetadata, AvatarUploadResult } from '../avatar-upload/types';
+import { ShareProfileModalMetadata } from '../share-profile-modal/types';
+import { CtaCardMetadata } from '../../molecules/cta-card/types';
 import { EmptyStateMetadata } from '../../molecules/empty-state/types';
 import { FormMetadata, FormSubmit } from '../../types';
 import { GetProfileResponse } from '../../../services/auth/types';
@@ -45,7 +47,7 @@ export declare class ProfileViewComponent {
      */
     config?: ProfileViewConfig;
     /** Config mergeada con defaults. @Input gana sobre route data. */
-    readonly resolvedConfig: import("@angular/core").Signal<Required<Omit<ProfileViewConfig, "onSaved" | "onAvatarUploaded">> & Pick<ProfileViewConfig, "onSaved" | "onAvatarUploaded">>;
+    readonly resolvedConfig: import("@angular/core").Signal<Required<Omit<ProfileViewConfig, "onSaved" | "onAvatarUploaded" | "profileBaseUrl">> & Pick<ProfileViewConfig, "onSaved" | "onAvatarUploaded" | "profileBaseUrl">>;
     /** Namespace i18n resuelto (capturado una vez para llamadas no-reactivas). */
     private get ns();
     /**
@@ -58,6 +60,9 @@ export declare class ProfileViewComponent {
     readonly loading: import("@angular/core").WritableSignal<boolean>;
     readonly saving: import("@angular/core").WritableSignal<boolean>;
     readonly loadError: import("@angular/core").WritableSignal<unknown>;
+    readonly shareOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly shareCta: import("@angular/core").Signal<CtaCardMetadata>;
+    readonly shareModal: import("@angular/core").Signal<ShareProfileModalMetadata>;
     private readonly _userId;
     readonly errorState: import("@angular/core").Signal<EmptyStateMetadata>;
     readonly avatarProps: import("@angular/core").Signal<AvatarUploadMetadata>;

package/lib/components/organisms/profile-view/types.d.ts

@@ -25,6 +25,18 @@ export interface ProfileViewConfig {
      * Default `'Settings.Profile'`.
      */
     i18nNamespace?: string;
+    /**
+     * Muestra la CTA de compartir perfil (QR modal). Requiere que el user tenga
+     * handle configurado — si no, la sección no aparece aunque esté en `true`.
+     * Default `true`.
+     */
+    showShareCta?: boolean;
+    /**
+     * URL base de la app para construir el enlace del perfil público.
+     * El enlace final es `${profileBaseUrl}/u/${handle}`.
+     * Ej: `'https://app.myvaltech.com'`.
+     */
+    profileBaseUrl?: string;
     /** Callback tras un guardado de perfil exitoso. */
     onSaved?: (profile: GetProfileResponse) => void;
     /** Callback tras subir/actualizar el avatar exitosamente. */

package/lib/components/organisms/settings-hub/settings-hub.component.d.ts

@@ -0,0 +1,43 @@
+import { ActionCardMetadata } from '../../molecules/action-card/types';
+import { SettingsHubConfig } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-settings-hub` — portada de la sección Settings (organism). Renderiza un
+ * header (título + descripción) + un grid de `val-action-card` que navega a las
+ * sub-vistas. Promovido desde `showcase` (`pages/settings/pages/preferences`)
+ * bajo el proceso de ADR-021.
+ *
+ * Las cards salen de `buildSettingsCards` sobre el catálogo default
+ * (`SETTINGS_SECTIONS_CATALOG`), filtrado/extendido/reordenado por la config.
+ *
+ * Navegación: cards con `routerLink` navegan vía `Router`; la card de logout
+ * (sin ruta) invoca `config.onLogout`. Cada click emite `config.onSectionClick`.
+ *
+ * NO renderiza ion-content — vive dentro de val-page-wrapper.
+ *
+ * Auto-registra sus dos sets de defaults i18n (labels + header) en sus
+ * respectivos namespaces si el consumer no los proveyó.
+ */
+export declare class SettingsHubComponent {
+    private nav;
+    private i18n;
+    private router;
+    private route;
+    /**
+     * Config vía @Input (object-first). Si no se pasa, cae al route data
+     * `settingsHubConfig` (poblado por `provideValtechSettingsRoutes`).
+     * `resolvedConfig` mergea con defaults — @Input gana sobre route data.
+     */
+    config?: SettingsHubConfig;
+    readonly resolvedConfig: import("@angular/core").Signal<Required<Pick<SettingsHubConfig, "i18nNamespace" | "pageI18nNamespace">> & SettingsHubConfig>;
+    private get labelsNs();
+    private get pageNs();
+    readonly pageTitle: import("@angular/core").Signal<string>;
+    readonly pageDescription: import("@angular/core").Signal<string>;
+    /** Cards del HUB, resueltas desde la config. */
+    readonly actionCards: import("@angular/core").Signal<ActionCardMetadata[]>;
+    constructor();
+    onActionClick(action: ActionCardMetadata): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SettingsHubComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SettingsHubComponent, "val-settings-hub", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/settings-hub/settings-hub.i18n.d.ts

@@ -0,0 +1,13 @@
+import { LanguagesContent } from '../../../services/i18n/types';
+/**
+ * Defaults i18n embebidos en `val-settings-hub`. Dos sets, uno por namespace
+ * (ver `SettingsHubConfig.i18nNamespace` / `.pageI18nNamespace`). Auto-registrados
+ * en el constructor SOLO si el namespace no existe (respeta override del consumer).
+ *
+ * `SETTINGS_HUB_LABELS_I18N` — labels de cada sección (namespace `Dashboard` por
+ * default). Mismo set que showcase mantiene en `src/i18n/index.ts` (queda como
+ * override). `SETTINGS_HUB_PAGE_I18N` — header del HUB (namespace
+ * `Settings.Preferences` por default), tomado de la page Preferencias original.
+ */
+export declare const SETTINGS_HUB_LABELS_I18N: LanguagesContent;
+export declare const SETTINGS_HUB_PAGE_I18N: LanguagesContent;

package/lib/components/organisms/settings-hub/settings-sections.d.ts

@@ -0,0 +1,62 @@
+import { ActionCardMetadata } from '../../molecules/action-card/types';
+/**
+ * Modelo de una sección del HUB de settings. Cada sección se proyecta a un
+ * `val-action-card` (vía `buildSettingsCards`). El catálogo default
+ * (`SETTINGS_SECTIONS_CATALOG`) cubre las secciones estándar del factory;
+ * el consumer puede filtrar (`exclude`), reordenar (`order`), reescribir las
+ * rutas base (`basePath`) o sumar las suyas (`include`).
+ */
+export interface SettingsSection {
+    /** Identificador estable de la sección (dispatch de click + filtrado). */
+    token: string;
+    /** i18n key del título de la card (resuelto contra el namespace de labels). */
+    titleKey: string;
+    /** i18n key de la descripción (opcional — logout no la tiene). */
+    descKey?: string;
+    /** Ionicon de la card. */
+    ionicon: string;
+    /**
+     * Ruta de navegación. Las secciones bajo `/app/settings` se reescriben si el
+     * consumer pasa `basePath`. `action-logout` no tiene ruta (callback).
+     */
+    routerLink?: string;
+    /** Muestra el chevron a la derecha. Default `true`. */
+    showChevron?: boolean;
+    /** Card con sombra. Default `true`. */
+    shadowed?: boolean;
+}
+/**
+ * Catálogo default de secciones del HUB de settings (8 entradas). `logout` va
+ * incluida pero sin `routerLink` (la maneja un callback). Mismo set, mismos
+ * tokens/iconos/rutas que el builder original de showcase
+ * (`shared/settings-action-cards.ts`) que esta promoción reemplaza.
+ */
+export declare const SETTINGS_SECTIONS_CATALOG: SettingsSection[];
+/** Opciones del builder `buildSettingsCards`. */
+export interface SettingsCardsOptions {
+    /** Oculta secciones por token (típicamente la entrada de la página actual). */
+    exclude?: string[];
+    /** Secciones extra a sumar al catálogo (las de la app aún no promovidas). */
+    include?: SettingsSection[];
+    /** Orden explícito por token. Las no listadas quedan al final, en su orden. */
+    order?: string[];
+    /** Incluye la card de logout (sin ruta). Default `false`. */
+    includeLogout?: boolean;
+    /**
+     * Reescribe el prefijo `/app/settings` de las rutas del catálogo. Ej.
+     * `basePath: '/app/config'` → `/app/config/general`. Si se omite, las rutas
+     * quedan tal cual el catálogo.
+     */
+    basePath?: string;
+}
+/**
+ * Construye el grid de cards de navegación del HUB de settings (versión
+ * promovida del `buildSettingsActionCards` de showcase). Usa el catálogo
+ * default + las `include` del consumer, filtra `exclude`, gatea logout por
+ * `includeLogout`, reordena por `order` y reescribe las rutas por `basePath`.
+ *
+ * El `t` resuelve los `titleKey`/`descKey` contra el namespace de labels
+ * (default del componente: `Dashboard`). `logout` NO tiene `routerLink` — el
+ * consumer maneja el flujo de cierre de sesión por token / callback.
+ */
+export declare function buildSettingsCards(t: (key: string) => string, options?: SettingsCardsOptions): ActionCardMetadata[];

package/lib/components/organisms/settings-hub/settings.routes.d.ts

@@ -0,0 +1,59 @@
+import { Routes } from '@angular/router';
+import { ProfileViewConfig } from '../profile-view/types';
+import { PreferencesViewConfig } from '../preferences-view/types';
+import { SettingsHubConfig } from './types';
+/**
+ * Opciones de `provideValtechSettingsRoutes`. Agrupa el HUB (`val-settings-hub`)
+ * con las vistas ya promovidas (Perfil + Preferencias) bajo un único `path`
+ * base, y deja `extraRoutes` para las secciones de la app aún no promovidas
+ * (security, account, notifications, organization, …).
+ */
+export interface ValtechSettingsRoutesOptions {
+    /** Path base del bloque de settings. Default `'settings'`. */
+    basePath?: string;
+    /** Config del HUB (pasada por route data `settingsHubConfig`). */
+    hubConfig?: SettingsHubConfig;
+    /** Config de la vista Perfil (pass-through a `provideValtechProfileRoutes`). */
+    profileConfig?: ProfileViewConfig;
+    /** Config de la vista Preferencias (pass-through a `provideValtechPreferencesRoutes`). */
+    preferencesConfig?: PreferencesViewConfig;
+    /** Monta la ruta `profile`. Default `true`. */
+    includeProfile?: boolean;
+    /** Monta la ruta de preferencias. Default `true`. */
+    includePreferences?: boolean;
+    /** Path de la vista Preferencias. Default `'preferences'`. */
+    preferencesPath?: string;
+    /** Rutas extra a sumar como hijas (secciones de la app no promovidas). */
+    extraRoutes?: Routes;
+}
+/**
+ * Helper para montar el bloque completo de Settings en una app del factory: el
+ * HUB de navegación (`val-settings-hub`) en el index + las vistas promovidas
+ * (Perfil, Preferencias) + las rutas propias de la app (`extraRoutes`).
+ *
+ * Pensado para apps nuevas (greenfield) que adoptan el set entero. showcase NO
+ * lo usa hoy (preserva su `settings.routes.ts` por la semántica de sus muchas
+ * secciones no promovidas — ver guía de promoción), pero el provider debe
+ * existir y compilar para el resto de apps.
+ *
+ * @example
+ * ```ts
+ * // app.routes.ts
+ * import { provideValtechSettingsRoutes } from 'valtech-components';
+ *
+ * export const routes: Routes = [
+ *   {
+ *     path: 'app',
+ *     children: [
+ *       ...provideValtechSettingsRoutes({
+ *         hubConfig: { onLogout: () => auth.logoutWithConfirmation() },
+ *         extraRoutes: [
+ *           { path: 'security', loadComponent: () => ... },
+ *         ],
+ *       }),
+ *     ],
+ *   },
+ * ];
+ * ```
+ */
+export declare function provideValtechSettingsRoutes(opts?: ValtechSettingsRoutesOptions): Routes;

package/lib/components/organisms/settings-hub/types.d.ts

@@ -0,0 +1,37 @@
+import { SettingsSection } from './settings-sections';
+/**
+ * Configuración acotada de `val-settings-hub` (object-first). El HUB es la
+ * portada de la sección Settings: un header (título + descripción) + un grid de
+ * `val-action-card` que navega a las sub-vistas.
+ *
+ * Doble namespace i18n:
+ *  - `i18nNamespace` (default `'Dashboard'`) — labels de cada sección
+ *    (`general`, `account`, …). Es el set que comparten dashboard / hub.
+ *  - `pageI18nNamespace` (default `'Settings.Preferences'`) — `pageTitle` /
+ *    `pageDescription` del header del HUB.
+ *
+ * El catálogo de secciones es el default (`SETTINGS_SECTIONS_CATALOG`); se
+ * filtra (`exclude`), reordena (`order`), extiende (`include`) o reescribe sus
+ * rutas (`basePath`). `includeLogout` agrega la card de cierre de sesión (sin
+ * ruta) — su click se delega a `onLogout`.
+ */
+export interface SettingsHubConfig {
+    /** Oculta secciones por token (ej. la propia entrada del HUB). */
+    exclude?: string[];
+    /** Secciones extra a sumar al catálogo (las de la app aún no promovidas). */
+    include?: SettingsSection[];
+    /** Orden explícito por token. Las no listadas quedan al final. */
+    order?: string[];
+    /** Incluye la card de logout (sin ruta). Default `false`. */
+    includeLogout?: boolean;
+    /** Reescribe el prefijo `/app/settings` de las rutas del catálogo. */
+    basePath?: string;
+    /** Namespace i18n de los labels de sección. Default `'Dashboard'`. */
+    i18nNamespace?: string;
+    /** Namespace i18n del header (pageTitle/pageDescription). Default `'Settings.Preferences'`. */
+    pageI18nNamespace?: string;
+    /** Callback al click de la card de logout (sin ruta). */
+    onLogout?: () => void;
+    /** Callback al click de cualquier card, con su token. */
+    onSectionClick?: (token: string) => void;
+}

package/lib/components/organisms/share-profile-modal/types.d.ts

@@ -20,6 +20,8 @@ export interface ShareProfileModalMetadata {
     avatarUrl?: string;
     /** Email — used for the avatar initials/color when no avatarUrl */
     email?: string;
+    /** Handle shown as @handle below the name */
+    handle?: string;
     /** Modal title (val-display). Default: `name` */
     title?: string;
     /** Caption under the QR. Default: i18n `ShareProfileModal.caption` */

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

package/package.json

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

package/public-api.d.ts

@@ -268,6 +268,10 @@ export * from './lib/components/organisms/profile-view/profile.routes';
 export * from './lib/components/organisms/preferences-view/preferences-view.component';
 export * from './lib/components/organisms/preferences-view/types';
 export * from './lib/components/organisms/preferences-view/preferences.routes';
+export * from './lib/components/organisms/settings-hub/settings-hub.component';
+export * from './lib/components/organisms/settings-hub/types';
+export * from './lib/components/organisms/settings-hub/settings-sections';
+export * from './lib/components/organisms/settings-hub/settings.routes';
 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';