valtech-components 2.0.946 → 2.0.947

package/lib/components/organisms/fun-modal/fun-modal.component.d.ts

@@ -0,0 +1,44 @@
+import { EventEmitter } from '@angular/core';
+import { FunModalMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-fun-modal` — modal moderno tipo promo/onboarding: imagen o ilustración
+ * arriba, título, cuerpo y botones de acción, con redondeo personalizable.
+ * Sigue la Regla #5 (header canónico vía `val-modal-shell`).
+ *
+ * El padre controla `[isOpen]` y reacciona a `(dismissed)` / `(action)`.
+ *
+ * @example
+ * ```html
+ * <val-fun-modal
+ *   [isOpen]="isOpen()"
+ *   [props]="{
+ *     image: '/promo.png',
+ *     title: '¿Cómo se conecta Lucas con los Salmos?',
+ *     subtitle: 'Pulsa la referencia cruzada para descubrirlo.',
+ *     actions: { position: 'center', columned: false, buttons: [
+ *       { text: 'Probar ahora', color: 'primary', shape: 'round', type: 'button', state: 'ENABLED', token: 'try' }
+ *     ] }
+ *   }"
+ *   (action)="onAction($event)"
+ *   (dismissed)="isOpen.set(false)"
+ * />
+ * ```
+ */
+export declare class FunModalComponent {
+    private _isOpen;
+    /** Controla la visibilidad del modal. */
+    set isOpen(value: boolean);
+    get isOpen(): boolean;
+    /** Configuración del modal. */
+    props: Partial<FunModalMetadata>;
+    /** Emite cuando el user cierra el modal (botón Cerrar o backdrop). */
+    dismissed: EventEmitter<void>;
+    /** Emite con el token del botón de acción presionado. */
+    action: EventEmitter<string>;
+    config: import("@angular/core").Signal<FunModalMetadata & Required<Pick<FunModalMetadata, "borderRadius" | "imageRadius">>>;
+    getBackground(): string | null;
+    close(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FunModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FunModalComponent, "val-fun-modal", never, { "isOpen": { "alias": "isOpen"; "required": false; }; "props": { "alias": "props"; "required": false; }; }, { "dismissed": "dismissed"; "action": "action"; }, never, never, true, never>;
+}

package/lib/components/organisms/fun-modal/types.d.ts

@@ -0,0 +1,37 @@
+import { ButtonGroupMetadata } from '../../molecules/button-group/types';
+/**
+ * Metadata for val-fun-modal.
+ *
+ * Modal moderno tipo promo/onboarding: imagen o ilustración arriba, título,
+ * cuerpo y botones de acción, con redondeo personalizable. Sigue la Regla #5
+ * (header canónico vía `val-modal-shell`).
+ *
+ * Content-driven — pasar strings ya resueltos. Botones reusan
+ * `ButtonGroupMetadata`.
+ */
+export interface FunModalMetadata {
+    /** Imagen / ilustración mostrada arriba del título */
+    image?: string;
+    /** Alt de la imagen */
+    imageAlt?: string;
+    /** Emoji decorativo (alternativa a la imagen) */
+    emoji?: string;
+    /** Título principal (val-display) */
+    title: string;
+    /** Cuerpo / subtítulo (val-title) */
+    subtitle?: string;
+    /** Botones de acción (reusa val-button-group) */
+    actions?: ButtonGroupMetadata;
+    /** Redondeo del modal en px. Default: 28 */
+    borderRadius?: number;
+    /** Redondeo de la imagen en px. Default: 16 */
+    imageRadius?: number;
+    /** Color de fondo del modal (Ionic color o CSS). Default: surface */
+    backgroundColor?: string;
+    /** Label del botón de cierre. Default: i18n `_global.close` */
+    closeLabel?: string;
+}
+/**
+ * Default values for FunModalMetadata.
+ */
+export declare const FUN_MODAL_DEFAULTS: Required<Pick<FunModalMetadata, 'borderRadius' | 'imageRadius'>>;

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

@@ -0,0 +1,49 @@
+import { EventEmitter } from '@angular/core';
+import { QrResult } from '../../../services/qr-generator/types';
+import { ShareEvent } from '../../molecules/share-buttons/types';
+import { ShareProfileModalMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-share-profile-modal` — modal reutilizable para compartir un perfil (o
+ * cualquier entidad) vía QR + URL. Sigue la Regla #5 (header canónico vía
+ * `val-modal-shell`).
+ *
+ * Self-contained: genera el QR con `QrGeneratorService` a partir de `url` al
+ * abrirse. El padre solo controla `[isOpen]` y reacciona a `(dismissed)`.
+ *
+ * @example
+ * ```html
+ * <val-share-profile-modal
+ *   [isOpen]="isOpen()"
+ *   [props]="{ name: 'Víctor Valenzuela', url: 'https://app.myvaltech.com/u/victor', avatarUrl: '/me.jpg' }"
+ *   (dismissed)="isOpen.set(false)"
+ * />
+ * ```
+ */
+export declare class ShareProfileModalComponent {
+    private qrGenerator;
+    private i18n;
+    private _isOpen;
+    /** Controla la visibilidad. Al pasar de cerrado a abierto genera el QR. */
+    set isOpen(value: boolean);
+    get isOpen(): boolean;
+    /** Configuración del modal. */
+    props: Partial<ShareProfileModalMetadata>;
+    /** Emite cuando el user cierra el modal (botón Cerrar o backdrop). */
+    dismissed: EventEmitter<void>;
+    /** Emite al completar una acción de compartir. */
+    shared: EventEmitter<ShareEvent>;
+    private readonly _qr;
+    readonly qr: import("@angular/core").Signal<QrResult>;
+    private readonly _qrError;
+    readonly qrError: import("@angular/core").Signal<boolean>;
+    config: import("@angular/core").Signal<ShareProfileModalMetadata & Required<Pick<ShareProfileModalMetadata, "borderRadius" | "platforms" | "qrTheme" | "qrSize">>>;
+    displayName: import("@angular/core").Signal<string>;
+    caption: import("@angular/core").Signal<string>;
+    constructor();
+    private t;
+    private generateQr;
+    close(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ShareProfileModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ShareProfileModalComponent, "val-share-profile-modal", never, { "isOpen": { "alias": "isOpen"; "required": false; }; "props": { "alias": "props"; "required": false; }; }, { "dismissed": "dismissed"; "shared": "shared"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,45 @@
+import { SharePlatform } from '../../molecules/share-buttons/types';
+import { QrDisplayTheme } from '../../atoms/qr-code/types';
+/**
+ * Metadata for val-share-profile-modal.
+ *
+ * Reusable modal to share a profile (or any entity) via QR + URL: avatar,
+ * name, a QR code encoding the URL, an optional caption and share buttons
+ * (copy link / native / social).
+ *
+ * Content-driven: `name` + `url` are required; the rest is optional. Static
+ * chrome text (caption, button hints) auto-registra defaults i18n
+ * (namespace `ShareProfileModal`) — override pasando los campos directos.
+ */
+export interface ShareProfileModalMetadata {
+    /** Display name shown under the avatar (and default modal title) */
+    name: string;
+    /** URL encoded in the QR and shared by the buttons */
+    url: string;
+    /** Avatar image URL (falls back to initials of `name`) */
+    avatarUrl?: string;
+    /** Email — used for the avatar initials/color when no avatarUrl */
+    email?: string;
+    /** Modal title (val-display). Default: `name` */
+    title?: string;
+    /** Caption under the QR. Default: i18n `ShareProfileModal.caption` */
+    caption?: string;
+    /** Title used by the native share sheet. Default: `name` */
+    shareTitle?: string;
+    /** Text used by the native share sheet / social messages */
+    shareText?: string;
+    /** Platforms shown in the share buttons. Default: ['copy', 'native', 'whatsapp'] */
+    platforms?: SharePlatform[];
+    /** QR visual theme. Default: 'default' */
+    qrTheme?: QrDisplayTheme;
+    /** QR size in pixels. Default: 220 */
+    qrSize?: number;
+    /** Modal corner rounding in px. Default: 24 */
+    borderRadius?: number;
+    /** Close button label. Default: i18n `_global.close` */
+    closeLabel?: string;
+}
+/**
+ * Default values for ShareProfileModalMetadata.
+ */
+export declare const SHARE_PROFILE_MODAL_DEFAULTS: Required<Pick<ShareProfileModalMetadata, 'platforms' | 'qrTheme' | 'qrSize' | 'borderRadius'>>;

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

@@ -42,7 +42,7 @@
  * const article = ContentTransformer.toArticle(json);
  * ```
  */
-export { ContentAuthor, ContentMeta, ContentConfig, ContentDocument, ContentBlock, HeadingBlock, ParagraphBlock, QuoteBlock, CodeBlock, ListBlock, ImageBlock, CalloutBlock, DividerBlock, ButtonBlock, CommandBlock, } from './types';
+export { ContentAuthor, ContentMeta, ContentConfig, ContentDocument as ContentBuilderDocument, ContentBlock, HeadingBlock, ParagraphBlock, QuoteBlock, CodeBlock, ListBlock, ImageBlock, CalloutBlock, DividerBlock, ButtonBlock, CommandBlock, } from './types';
 export { ContentTransformer, toArticle } from './transformer';
 export { BlogPost, BlogPostBuilder, blogPost } from './content-types/blog';
 export { Documentation, DocNavLink, DocsBuilder, docs } from './content-types/documentation';

package/lib/services/content-platform/config.d.ts

@@ -0,0 +1,38 @@
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+import { ValtechContentConfig } from './types';
+/**
+ * Token de inyección para la configuración de la plataforma de contenido.
+ */
+export declare const VALTECH_CONTENT_CONFIG: InjectionToken<ValtechContentConfig>;
+/**
+ * Provee la plataforma de contenido (`ContentService`) a la aplicación Angular.
+ *
+ * Wire en el `main.ts` de la app consumer. El origen es **híbrido** (ADR-020):
+ * el backend siempre está disponible vía `apiUrl`; las `staticSources` son
+ * opcionales — factories lazy generadas build-time por `scripts/build-content.ts`
+ * (mismo patrón que `provideLegalContent`). Cada locale queda code-split por el
+ * `import()` dinámico.
+ *
+ * @param config - Configuración de contenido (`apiUrl`, `appId`, `staticSources?`).
+ * @returns EnvironmentProviders para usar en `bootstrapApplication`.
+ *
+ * @example
+ * ```typescript
+ * // main.ts — solo backend
+ * provideValtechContent({
+ *   apiUrl: environment.apiUrl,
+ *   appId: 'showcase',
+ * });
+ *
+ * // main.ts — híbrido (estático curado + backend)
+ * provideValtechContent({
+ *   apiUrl: environment.apiUrl,
+ *   appId: 'web',
+ *   staticSources: {
+ *     es: () => import('./app/generated/content-store.es').then(m => m.CONTENT_STORE_ES),
+ *     en: () => import('./app/generated/content-store.en').then(m => m.CONTENT_STORE_EN),
+ *   },
+ * });
+ * ```
+ */
+export declare function provideValtechContent(config: ValtechContentConfig): EnvironmentProviders;

package/lib/services/content-platform/content.service.d.ts

@@ -0,0 +1,70 @@
+import { Observable } from 'rxjs';
+import { ArticleMetadata } from '../../components/organisms/article/types';
+import { ContentDocument, ContentDocumentType, ContentLoadOptions } from './types';
+import * as i0 from "@angular/core";
+/**
+ * Servicio de la plataforma de contenido (ADR-020 §2.5).
+ *
+ * Une dos orígenes (**híbrido**):
+ *  - **Estático** — `staticSources` lazy por locale, generadas build-time.
+ *  - **Backend** — DynamoDB + API (`/v2/content*`), publicación sin redeploy.
+ *
+ * Reglas de merge:
+ *  - `list()` une ambos orígenes por `type`. Colisión de `slug` → **estático
+ *    gana** (contenido curado). Ordena por `publishedAt` desc (sin fecha al final).
+ *  - `load()` resuelve estático primero, con **fallback** al backend.
+ *
+ * Render: `toArticle(doc)` convierte `doc.body` (Markdown) a `ArticleMetadata`
+ * vía el `markdown-article-parser` existente — la page hace `<val-article [props]="...">`.
+ *
+ * Requiere `provideValtechContent({ apiUrl, appId, staticSources? })` en `main.ts`.
+ * Sin provider, el servicio queda inerte (`isConfigured() === false`).
+ */
+export declare class ContentService {
+    private readonly config;
+    private readonly http;
+    private readonly parser;
+    /** `true` si `provideValtechContent()` fue llamado en el bootstrap. */
+    readonly isConfigured: import("@angular/core").WritableSignal<boolean>;
+    /** Cache de las promesas de cada factory estática, keyed por locale. */
+    private readonly staticCache;
+    constructor();
+    /**
+     * Lista los documentos publicados de un `type`, uniendo estático + backend.
+     * Colisión de `slug` → estático gana. Ordenados por `publishedAt` desc.
+     *
+     * @param type - Tipo de contenido (`'blog'`, `'news'`, …).
+     * @param options - `{ locale }` (default `'es'`).
+     */
+    list(type: ContentDocumentType, options?: ContentLoadOptions): Observable<ContentDocument[]>;
+    /**
+     * Carga un documento por `slug`: estático primero, fallback al backend.
+     *
+     * @param type - Tipo de contenido.
+     * @param slug - Slug del documento.
+     * @param options - `{ locale }` (default `'es'`).
+     */
+    load(type: ContentDocumentType, slug: string, options?: ContentLoadOptions): Observable<ContentDocument>;
+    /**
+     * Convierte el `body` (Markdown) de un documento en `ArticleMetadata` para
+     * renderizar con `<val-article [props]="...">`. Usa el parser existente.
+     *
+     * @param doc - Documento de contenido a renderizar.
+     * @param config - Override parcial de la `ArticleMetadata` resultante.
+     */
+    toArticle(doc: ContentDocument, config?: Partial<ArticleMetadata>): ArticleMetadata;
+    /** Limpia la cache de fuentes estáticas. Llamar al cambiar de locale en runtime. */
+    invalidate(): void;
+    /** Une estático + backend: estático gana por slug; orden por publishedAt desc. */
+    private merge;
+    /** Comparador: más reciente primero; sin `publishedAt` al final. */
+    private byPublishedDesc;
+    /** Carga (y cachea) los documentos estáticos de un locale, si hay factory. */
+    private loadStatic;
+    /** GET `{apiUrl}/v2/content?type=&locale=` — solo publicados. */
+    private listBackend;
+    /** GET `{apiUrl}/v2/content/{type}/{locale}/{slug}` — detalle publicado. */
+    private loadBackend;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ContentService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ContentService>;
+}

package/lib/services/content-platform/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Content Platform — `ContentService` + `provideValtechContent` (ADR-020).
+ *
+ * Modelo canónico unificado (`ContentDocument`, flat + Markdown) con origen
+ * híbrido (estático build-time + backend DynamoDB/API). Render vía el
+ * `markdown-article-parser` existente.
+ */
+export { ContentDocumentType, ContentDocumentStatus, ContentDocumentSource, ContentDocument, ContentDocumentAuthor, ContentStaticFactory, ValtechContentConfig, ContentLoadOptions, } from './types';
+export { VALTECH_CONTENT_CONFIG, provideValtechContent } from './config';
+export { ContentService } from './content.service';

package/lib/services/content-platform/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Content Platform — modelo canónico de documento de contenido.
+ *
+ * Alineado con ADR-020 §2.1. Es el contrato compartido entre:
+ *  - Backend (servicio `content/` — DynamoDB tabla `content`).
+ *  - Pipeline estático (`scripts/build-content.ts` → `content-store.{locale}.ts`).
+ *  - Esta lib (`ContentService` + `provideValtechContent`).
+ *  - Web (`/blog`, `/news`, …).
+ *
+ * Modelo **unificado** con discriminador `type` — agregar un tipo de contenido
+ * NO requiere tocar backend ni lib. El `body` es Markdown plano, renderizado en
+ * la web vía el `markdown-article-parser` existente (`string MD → ArticleMetadata`).
+ *
+ * NOTA: existe un tipo homónimo `ContentDocument<T>` (block-based, builder) en
+ * `services/content/`, reexportado por el public-api como `ContentBuilderDocument`
+ * para evitar colisión. Este (flat, markdown) es el canónico de la plataforma.
+ */
+/**
+ * Tipo de contenido (discriminador). Extensible — agregar un valor no impacta
+ * backend ni lib; solo la web decide qué rutas exponer.
+ */
+export type ContentDocumentType = 'blog' | 'news' | 'article' | 'documentation' | (string & {});
+/**
+ * Estado de publicación del documento.
+ */
+export type ContentDocumentStatus = 'draft' | 'published' | 'archived';
+/**
+ * Origen del documento — marca de la naturaleza híbrida del pipeline.
+ *  - `static`: autoría en repo, build-time (contenido curado de la empresa).
+ *  - `backend`: DynamoDB + API (publicación sin redeploy / editores).
+ */
+export type ContentDocumentSource = 'static' | 'backend';
+/**
+ * Autor de un documento de contenido.
+ */
+export interface ContentDocumentAuthor {
+    /** Nombre visible del autor. */
+    name: string;
+    /** URL del avatar del autor. */
+    avatar?: string;
+    /** Rol o cargo del autor. */
+    role?: string;
+}
+/**
+ * Documento de contenido unificado (canónico — ADR-020 §2.1).
+ */
+export interface ContentDocument {
+    /** Identificador único — uuid (backend) o `static:{type}:{locale}:{slug}` (estático). */
+    id: string;
+    /** AppID del producto dueño del documento. */
+    appId: string;
+    /** Tipo de contenido (discriminador). */
+    type: ContentDocumentType;
+    /** Slug — único por (appId, type, locale). */
+    slug: string;
+    /** Locale del documento (`'es'` | `'en'` | …). */
+    locale: string;
+    /** Título del documento. */
+    title: string;
+    /** Resumen / extracto para listados y SEO. */
+    excerpt: string;
+    /** URL de la imagen de portada (S3 vía storage service). */
+    coverImage?: string;
+    /** Cuerpo en Markdown — render vía markdown-article-parser. */
+    body: string;
+    /** Autor del documento. */
+    author?: ContentDocumentAuthor;
+    /** Etiquetas para categorización. */
+    tags?: string[];
+    /** Categoría primaria. */
+    category?: string;
+    /** Estado de publicación. */
+    status: ContentDocumentStatus;
+    /** Origen del documento (marca híbrida). */
+    source: ContentDocumentSource;
+    /** Fecha de publicación (ISO 8601). */
+    publishedAt?: string;
+    /** Fecha de creación (ISO 8601). */
+    createdAt: string;
+    /** Fecha de última actualización (ISO 8601). */
+    updatedAt?: string;
+}
+/**
+ * Factory lazy de documentos estáticos para un locale. Generada build-time por
+ * `scripts/build-content.ts`. Se usa con `import()` dinámico para que cada locale
+ * quede code-split (igual patrón que `LegalContentFactory`).
+ */
+export type ContentStaticFactory = () => Promise<ContentDocument[]>;
+/**
+ * Configuración de `provideValtechContent` (ADR-020 §2.5).
+ */
+export interface ValtechContentConfig {
+    /** Base URL de la API backend (sin trailing slash). Ej. `environment.apiUrl`. */
+    apiUrl: string;
+    /** AppID del producto — se envía como query param al backend. */
+    appId: string;
+    /**
+     * Fuentes estáticas lazy keyed por locale (generadas build-time). Opcional —
+     * si no hay, el servicio opera solo contra el backend.
+     *
+     * @example
+     * staticSources: {
+     *   es: () => import('./app/generated/content-store.es').then(m => m.CONTENT_STORE_ES),
+     *   en: () => import('./app/generated/content-store.en').then(m => m.CONTENT_STORE_EN),
+     * }
+     */
+    staticSources?: {
+        [locale: string]: ContentStaticFactory;
+    };
+}
+/**
+ * Opciones de carga/listado de contenido.
+ */
+export interface ContentLoadOptions {
+    /** Locale a resolver (default `'es'`). */
+    locale?: string;
+}

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

package/package.json

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

package/public-api.d.ts

@@ -202,6 +202,10 @@ export * from './lib/components/organisms/banner/banner.component';
 export * from './lib/components/organisms/banner/types';
 export * from './lib/components/organisms/change-password-modal/change-password-modal.component';
 export * from './lib/components/organisms/change-email-modal/change-email-modal.component';
+export * from './lib/components/organisms/share-profile-modal/share-profile-modal.component';
+export * from './lib/components/organisms/share-profile-modal/types';
+export * from './lib/components/organisms/fun-modal/fun-modal.component';
+export * from './lib/components/organisms/fun-modal/types';
 export * from './lib/components/organisms/cookie-banner/cookie-banner.component';
 export * from './lib/components/organisms/cookie-banner/types';
 export * from './lib/components/organisms/debug-console/config';
@@ -314,6 +318,7 @@ export * from './lib/services/image';
 export * from './lib/services/ads';
 export * from './lib/components/molecules/ad-slot/ad-slot.component';
 export * from './lib/services/content';
+export * from './lib/services/content-platform';
 export * from './lib/services/feedback';
 export * from './lib/services/donation';
 export * from './lib/components/molecules/feedback-form/feedback-form.component';