valtech-components 2.0.1004 → 2.0.1005

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

@@ -0,0 +1,88 @@
+import { ActionCardMetadata } from '../../molecules/action-card/types';
+import { TitleMetadata } from '../../atoms/title/types';
+import { AboutAction, AboutViewConfig } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-about-view` — vista About full-feature autocontenida (organism).
+ * Promovida desde `showcase` bajo el proceso de ADR-021. Reúne:
+ *  - **HERO** — logo + nombre de marca + tagline + pill de versión (copiable).
+ *  - **Descripción** — título + cuerpo.
+ *  - **Acciones** — action-card de rating built-in (abre `val-content-reaction`
+ *    DIRECTAMENTE vía `ModalService`, sin wrapper local — decisión CTO) + las
+ *    acciones genéricas que el consumer aporte por `config.actions`.
+ *  - **Redes** — links sociales (`config.socialLinks`); sección oculta si vacía.
+ *  - **Footer** — copyright con el año actual.
+ *
+ * Lo app-specific (logo, nombre, versión, redes, acciones share/faq) viaja como
+ * DATA de config — NO como slots (ADR-021). La versión la pasa el consumer
+ * (`config.version` = su `APP_VERSION`); la lib NO importa el `version.ts` de la
+ * app. Si no se pasa versión, el pill se oculta.
+ *
+ * NO renderiza ion-content — vive dentro de val-page-wrapper. `ActivatedRoute`
+ * se inyecta `{ optional: true }` solo para leer el route data de config.
+ *
+ * Auto-registra sus defaults i18n (es/en) en el constructor si el consumer no
+ * proveyó el namespace configurado (default `Settings.About`).
+ *
+ * GOTCHA i18n ContentReaction: `val-content-reaction` exige su namespace
+ * `ContentReaction` registrado donde se use (key faltante en binding + CD =
+ * navegador congelado en dev). `ContentReactionComponent` se auto-registra ese
+ * namespace en SU constructor, y como se abre vía `ModalService` ese constructor
+ * corre antes de que su template binde — queda cubierto. Igual lo importamos
+ * como dependencia explícita de esta vista para que la garantía sea local.
+ */
+export declare class AboutViewComponent {
+    private nav;
+    private i18n;
+    private modalService;
+    private toast;
+    private route;
+    /**
+     * Config vía @Input (object-first). Si no se pasa, se cae al route data
+     * `aboutConfig` (poblado por `provideValtechAboutRoutes`). `resolvedConfig`
+     * mergea con los defaults — `@Input` gana sobre route data.
+     */
+    config?: AboutViewConfig;
+    readonly resolvedConfig: import("@angular/core").Signal<Required<Omit<AboutViewConfig, "onRated">> & Pick<AboutViewConfig, "onRated">>;
+    /** Namespace i18n resuelto (capturado para llamadas no-reactivas). */
+    private get ns();
+    readonly brandName: import("@angular/core").Signal<string>;
+    readonly logoSrc: import("@angular/core").Signal<string>;
+    readonly version: import("@angular/core").Signal<string>;
+    readonly socialLinks: import("@angular/core").Signal<{
+        icon: string;
+        url: string;
+        label: string;
+    }[]>;
+    readonly showRating: import("@angular/core").Signal<boolean>;
+    readonly actions: import("@angular/core").Signal<AboutAction[]>;
+    /** Copyright del footer — año actual interpolado en `copyrightText`. */
+    readonly copyright: import("@angular/core").Signal<string>;
+    /** Title metadata para secciones — bold + size small. */
+    readonly rateActionCard: import("@angular/core").Signal<ActionCardMetadata>;
+    constructor();
+    /** Helper i18n bound al namespace resuelto. Reactivo vía `lang()`. */
+    protected tt(key: string): string;
+    /** Title metadata para secciones — bold + size small. */
+    protected sectionTitle(key: string): TitleMetadata;
+    /** ActionCardMetadata para una acción genérica del consumer. */
+    protected extraActionCard(action: AboutAction): ActionCardMetadata;
+    /** Copia la versión al portapapeles + toast (color dark). */
+    copyVersion(): Promise<void>;
+    /** Abre una URL externa en nueva tab. `mailto:` queda en la misma tab. */
+    openUrl(url: string): void;
+    /**
+     * "Calificar la app" — abre `val-content-reaction` DIRECTAMENTE como sheet
+     * modal (sin wrapper local — decisión CTO). El componente persiste la reacción
+     * contra el backend de feedback y muestra su propio estado de "gracias"; el
+     * sheet se cierra arrastrando (breakpoint 0). El namespace i18n
+     * `ContentReaction` lo auto-registra `ContentReactionComponent` en su
+     * constructor, que corre al crear el modal — sin riesgo de key faltante.
+     *
+     * Sheet (bottom sheet): el contenido scrollea dentro y el botón "Enviar" queda
+     * siempre alcanzable, también en viewports chicos.
+     */
+    openRating(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AboutViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AboutViewComponent, "val-about-view", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/about-view/about-view.i18n.d.ts

@@ -0,0 +1,14 @@
+import { LanguagesContent } from '../../../services/i18n/types';
+/**
+ * Defaults i18n (es/en) embebidos en `val-about-view`. Auto-registrados en el
+ * constructor del componente si el consumer no proveyó el namespace
+ * (`Settings.About` por default). SOLO incluye las keys que la vista usa.
+ *
+ * Textos portados EXACTOS del override `Settings.About` de showcase
+ * (`frontend/showcase/src/i18n/index.ts`). Las keys de las acciones
+ * showcase-specific (`feedback*`, `share*`, `faq*`, `donate*`) NO se incluyen:
+ * esas acciones se modelan ahora como `actions[]` de la config (el consumer
+ * aporta sus propios textos). `copyrightText` se incluye aquí (antes salía del
+ * namespace `Layout`) para que la vista sea autocontenida.
+ */
+export declare const ABOUT_VIEW_I18N: LanguagesContent;

package/lib/components/organisms/about-view/about.routes.d.ts

@@ -0,0 +1,31 @@
+import { Routes } from '@angular/router';
+import { AboutViewConfig } from './types';
+/**
+ * Helper para montar la vista About (`val-about-view`) como ruta en una app del
+ * factory. El `config` se pasa por route `data` (`aboutConfig`) y el componente
+ * lo lee como fallback de su `@Input() config` (el `@Input` gana).
+ *
+ * @example
+ * ```ts
+ * // settings.routes.ts
+ * import { APP_VERSION } from '../version';
+ *
+ * export const settingsRoutes: Routes = [
+ *   ...provideValtechAboutRoutes({ config: { version: APP_VERSION } }), // → /app/about
+ *   { path: 'preferences', loadComponent: () => ... },
+ * ];
+ *
+ * // con redes y acciones extra:
+ * ...provideValtechAboutRoutes({
+ *   config: {
+ *     version: APP_VERSION,
+ *     socialLinks: VALTECH_SOCIAL_LINKS.map(s => ({ icon: s.icon, url: s.url, label: s.name })),
+ *     actions: [{ label: 'Compartir', icon: 'share-social-outline', onClick: () => share() }],
+ *   },
+ * }),
+ * ```
+ */
+export declare function provideValtechAboutRoutes(opts?: {
+    path?: string;
+    config?: AboutViewConfig;
+}): Routes;

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

@@ -0,0 +1,76 @@
+/**
+ * Configuración acotada de `val-about-view` (object-first). La vista About es
+ * app-specific por naturaleza (logo, nombre, versión, redes, acciones extra),
+ * así que lo propio de cada app se parametriza como **DATA de config** — NO como
+ * slots arbitrarios (ADR-021: una vista full-feature no abre slots; si falta
+ * algo, se promueve un nuevo punto de extensión).
+ *
+ * Ejes de variación permitidos:
+ *  - **branding** — `brand.name` / `brand.logoSrc` (qué muestra el HERO).
+ *  - **versión** — `version` la pasa el consumer (la lib NO puede importar el
+ *    `version.ts` de la app). Si no se pasa, se oculta el pill de versión.
+ *  - **redes** — `socialLinks`; si está vacío se oculta la sección social.
+ *  - **rating** — `showRating` + `ratingEntityId` + `onRated`.
+ *  - **acciones extra** — `actions[]` genéricas que el consumer agrega junto a
+ *    la acción de rating built-in.
+ *  - **branding i18n** — `i18nNamespace` (default `'Settings.About'`).
+ */
+/** Marca a mostrar en el HERO (logo + nombre). */
+export interface AboutBrand {
+    /** Nombre de la marca. Default `'Valtech'`. */
+    name?: string;
+    /** Ruta del logo. Default `'assets/images/main-icon.png'`. */
+    logoSrc?: string;
+}
+/**
+ * Acción genérica extra de la sección "Acciones" (además del rating built-in).
+ * El consumer la modela completa (label/descripción/ícono + handler). Las
+ * acciones share/faq de showcase NO son genéricas (Web Share API y ruta interna
+ * de la app), por eso se exponen como `actions` para que cada app aporte las
+ * suyas en vez de hardcodearlas en la lib.
+ */
+export interface AboutAction {
+    /** Texto principal de la action-card. */
+    label: string;
+    /** Texto secundario (opcional). */
+    description?: string;
+    /** Ionicon name (ej. `'share-social-outline'`). */
+    icon?: string;
+    /** Handler del click. */
+    onClick: () => void;
+}
+export interface AboutViewConfig {
+    /** Marca del HERO (logo + nombre). Default Valtech. */
+    brand?: AboutBrand;
+    /**
+     * Versión a mostrar en el pill (el consumer pasa su `APP_VERSION`). La lib NO
+     * importa el `version.ts` de la app. Si no se pasa, el pill de versión se
+     * oculta.
+     */
+    version?: string;
+    /**
+     * Redes sociales. Si está vacío (o no se pasa), la sección social se oculta.
+     * `icon` = ionicon name; `url` = destino; `label` = aria-label.
+     */
+    socialLinks?: {
+        icon: string;
+        url: string;
+        label: string;
+    }[];
+    /** Muestra la action-card de rating built-in. Default `true`. */
+    showRating?: boolean;
+    /**
+     * `entityId` del `entityRef` que recibe `val-content-reaction` al calificar
+     * (el `entityType` es siempre `'app'`). Default `'experience'`.
+     */
+    ratingEntityId?: string;
+    /** Acciones genéricas extra de la sección "Acciones". Default `[]`. */
+    actions?: AboutAction[];
+    /**
+     * Namespace i18n con el que la vista resuelve sus textos.
+     * Default `'Settings.About'`.
+     */
+    i18nNamespace?: string;
+    /** Hook tras enviar la calificación (rating) desde `val-content-reaction`. */
+    onRated?: () => 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.1004";
+export declare const VERSION = "2.0.1005";

package/package.json

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

package/public-api.d.ts

@@ -293,6 +293,9 @@ export * from './lib/components/organisms/notification-preferences-view/notifica
 export * from './lib/components/organisms/permissions-view/permissions-view.component';
 export * from './lib/components/organisms/permissions-view/types';
 export * from './lib/components/organisms/permissions-view/permissions.routes';
+export * from './lib/components/organisms/about-view/about-view.component';
+export * from './lib/components/organisms/about-view/types';
+export * from './lib/components/organisms/about-view/about.routes';
 export * from './lib/services/org/permission-catalog.service';
 export * from './lib/components/organisms/delete-account-modal/delete-account-modal.component';
 export * from './lib/components/organisms/switch-org-modal/switch-org-modal.component';