valtech-components 4.0.62 → 4.0.63

package/lib/components/atoms/splash/splash.component.d.ts

@@ -6,15 +6,21 @@ import * as i0 from "@angular/core";
  * app (p.ej. el callback OAuth) que deben verse iguales al arranque, en vez de
  * un segundo loader casi-duplicado.
  *
- * El logo apunta por defecto a `assets/images/main-{light,dark}.svg` — los mismos
- * assets de la app consumer que usa el splash de `index.html` — y resuelven en
- * runtime contra la app. Override por inputs si hace falta. Fondo overridable con
+ * Por defecto renderiza el logo de la app via la CSS var `--main-logo` (un `<div>`
+ * con `background-image`) — cada frontend del factory define `--main-logo` y la
+ * flipea en dark, asi el splash toma el logo correcto sin que el consumer pase nada.
+ * Override opcional: si se pasan `logoLight`/`logoDark` (no vacios), renderiza un
+ * `<img>` con ese src (comportamiento clasico, back-compat). Fondo overridable con
  * las CSS vars `--val-splash-bg` / `--val-splash-bg-dark`.
  */
 export declare class SplashComponent {
-    /** Logo para tema claro. Default = asset de la app (igual que index.html). */
+    /**
+     * Override opcional — src del logo para tema claro. Vacío (default) activa el
+     * modo `--main-logo` (un `<div>` con `background-image: var(--main-logo)` que
+     * toma el logo de la app y respeta dark). Pasalo (no vacío) para forzar `<img>`.
+     */
     readonly logoLight: import("@angular/core").InputSignal<string>;
-    /** Logo para tema oscuro (vía prefers-color-scheme). */
+    /** Override opcional — src del logo para tema oscuro (vía prefers-color-scheme). Solo aplica si `logoLight` no es vacío. */
     readonly logoDark: import("@angular/core").InputSignal<string>;
     /** Texto alternativo del logo. */
     readonly alt: import("@angular/core").InputSignal<string>;

package/lib/components/molecules/entity-card/entity-card.component.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from '@angular/core';
+import { PillMetadata } from '../pill/types';
+import { EntityCardMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-entity-card
+ *
+ * Generic entity card / list row. Two use-cases in one component:
+ *
+ * 1. **Navigable entity** (`clickable: true`, no `actions`) — the whole card is
+ *    a button: chevron on the right, `role="button"` + keyboard support, emits
+ *    `(cardClick)` with the `token`.
+ * 2. **Row with action(s)** (`actions: ButtonMetadata[]`) — buttons on the
+ *    right, each emits `(actionClick)` with its own token.
+ *
+ * Presentational — all text fields are already-resolved strings (no i18n of its
+ * own). Dark-safe: surface/borders/text use theme tokens only.
+ *
+ * @example
+ * ```html
+ * <val-entity-card
+ *   [props]="{ chip: { label: 'En vivo', color: 'success' }, title: 'Bingo', subtitle: 'Hoy 20:00', clickable: true, token: 'evt-1' }"
+ *   (cardClick)="open($event)" />
+ * ```
+ */
+export declare class EntityCardComponent {
+    /** Component configuration (object-first). */
+    readonly props: import("@angular/core").InputSignal<Partial<EntityCardMetadata>>;
+    /** Emits the `token` when the card is navigable and gets clicked/activated. */
+    cardClick: EventEmitter<string>;
+    /** Emits the token of the clicked action button. */
+    actionClick: EventEmitter<string>;
+    /** Merged config. */
+    readonly config: import("@angular/core").Signal<EntityCardMetadata>;
+    /** Action buttons (empty array when none). */
+    readonly actions: import("@angular/core").Signal<import("valtech-components").ButtonMetadata[]>;
+    /**
+     * Badge-mode pill props for the status chip, or null when absent.
+     * `chip.color` is a free-form string (Ionic color name or CSS) per the public
+     * contract; cast to satisfy `PillMetadata.color` (Ionic `Color` union).
+     */
+    readonly chipPillProps: import("@angular/core").Signal<Partial<PillMetadata>>;
+    /** Card is navigable only when `clickable` and there are no actions. */
+    readonly isNavigable: import("@angular/core").Signal<boolean>;
+    onCardClick(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EntityCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EntityCardComponent, "val-entity-card", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; }, { "cardClick": "cardClick"; "actionClick": "actionClick"; }, never, never, true, never>;
+}

package/lib/components/molecules/entity-card/types.d.ts

@@ -0,0 +1,74 @@
+import { ButtonMetadata } from '../../types';
+/**
+ * Optional status chip rendered as an eyebrow at the top-left of the card.
+ * Rendered via `val-pill` (badge mode).
+ */
+export interface EntityCardChip {
+    /** Already-resolved label string. */
+    label: string;
+    /** Ionic color name (`primary`…`dark`) or CSS color. Default: `medium`. */
+    color?: string;
+}
+/**
+ * Configuration for `val-entity-card`.
+ *
+ * Presentational molecule — every text field is an already-resolved string
+ * (the consumer translates via `I18nService.t()`). No i18n of its own.
+ *
+ * Covers two real use-cases:
+ *
+ * 1. **Navigable entity** — set `clickable: true` (and no `actions`). The whole
+ *    card becomes a button: shows a chevron, gains `role="button"` + keyboard
+ *    support, and emits `(cardClick)` with `token`.
+ *
+ * 2. **Row with action(s)** — provide `actions` (e.g. a prize row with an
+ *    "edit"/"assign" button). Each button emits `(actionClick)` with its token.
+ *    When `actions` is present the card is NOT navigable (no chevron).
+ *
+ * @example Navigable event
+ * ```html
+ * <val-entity-card
+ *   [props]="{
+ *     chip: { label: 'En vivo', color: 'success' },
+ *     title: 'Bingo Solidario',
+ *     subtitle: 'Hoy 20:00 · 120 jugadores',
+ *     clickable: true,
+ *     token: 'evt-1'
+ *   }"
+ *   (cardClick)="open($event)" />
+ * ```
+ *
+ * @example Prize row with an action
+ * ```html
+ * <val-entity-card
+ *   [props]="{
+ *     title: 'Línea',
+ *     subtitle: 'Smart TV 50\"',
+ *     endNote: 'Ganador: María P.',
+ *     actions: [
+ *       { text: 'Editar', color: 'dark', fill: 'clear', type: 'button', state: 'ENABLED', token: 'prize-1' }
+ *     ]
+ *   }"
+ *   (actionClick)="edit($event)" />
+ * ```
+ */
+export interface EntityCardMetadata {
+    /** Optional status badge, top-left of the card. Rendered with `val-pill`. */
+    chip?: EntityCardChip;
+    /** Main text (weight 700). Already resolved. */
+    title: string;
+    /** Secondary muted line. Already resolved. */
+    subtitle?: string;
+    /** Additional secondary note (e.g. "Ganador: X"), muted, below `subtitle`. */
+    endNote?: string;
+    /** Action buttons rendered on the right (one `val-button` each). */
+    actions?: ButtonMetadata[];
+    /**
+     * When `true` and there are NO `actions`, the whole card is navigable:
+     * shows a chevron, `role="button"` + `tabindex`, keyboard activation, and
+     * emits `(cardClick)`.
+     */
+    clickable?: boolean;
+    /** Identifier emitted on `(cardClick)`. */
+    token?: 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 = "4.0.62";
+export declare const VERSION = "4.0.63";

package/package.json

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

package/public-api.d.ts

@@ -181,6 +181,8 @@ export * from './lib/components/molecules/article-card/article-card.component';
 export * from './lib/components/molecules/article-card/types';
 export * from './lib/components/molecules/cta-card/cta-card.component';
 export * from './lib/components/molecules/cta-card/types';
+export * from './lib/components/molecules/entity-card/entity-card.component';
+export * from './lib/components/molecules/entity-card/types';
 export * from './lib/components/molecules/invitation-card/invitation-card.component';
 export * from './lib/components/molecules/invitation-card/types';
 export * from './lib/components/molecules/member-card/member-card.component';