valtech-components 4.0.980 → 4.0.982

package/lib/components/atoms/emoji-rating/emoji-rating.component.d.ts

@@ -0,0 +1,25 @@
+import { EmojiRatingMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-emoji-rating
+ *
+ * Escala corta de calificación con emoji (3-5 caras) — el tipo de pregunta
+ * `EMOJI_RATING` de `services/forms` (ADR-092). Existe como widget propio
+ * porque este tipo NO pasa por el `val-form` genérico: un `FieldSchemaDef`
+ * con un `type` que `FormSchemaBuilderService.parseInputType` no reconoce cae
+ * a texto plano en silencio, que sería incorrecto para una calificación.
+ *
+ * Radio-like: una sola cara seleccionada a la vez. El valor que guarda es
+ * `face.value` (ej. "1".."5"), no el emoji — es lo que
+ * `AggregateResponsesByType` cuenta en el dashboard.
+ *
+ * @example
+ * <val-emoji-rating [props]="{ control: ratingControl, label: '¿Cómo calificarías la experiencia?' }" />
+ */
+export declare class EmojiRatingComponent {
+    props: EmojiRatingMetadata;
+    get faces(): import("./types").EmojiRatingFace[];
+    select(value: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EmojiRatingComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EmojiRatingComponent, "val-emoji-rating", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/atoms/emoji-rating/types.d.ts

@@ -0,0 +1,22 @@
+import { FormControl } from '@angular/forms';
+/** Una cara de la escala. `value` es lo que se guarda (y lo que se agrega en
+ * el dashboard, `services/request.AggregateResponsesByType` cuenta por este
+ * string exacto) — el emoji es solo presentación. */
+export interface EmojiRatingFace {
+    value: string;
+    emoji: string;
+    /** Para lectores de pantalla. Sin esto, un emoji suelto no dice nada. */
+    ariaLabel: string;
+}
+/** Escala 1-5 por defecto: de "muy mal" a "muy bien". Los textos van en
+ * español porque son el fallback — cualquier consumer con soporte i18n pasa
+ * su propio `faces` con `ariaLabel` traducido. */
+export declare const DEFAULT_EMOJI_RATING_FACES: EmojiRatingFace[];
+export interface EmojiRatingMetadata {
+    control: FormControl<string | null>;
+    /** Texto de la pregunta. El componente no trae i18n propio — texto ya resuelto. */
+    label?: string;
+    hint?: string;
+    faces?: EmojiRatingFace[];
+    size?: 'default' | 'small';
+}

package/lib/components/organisms/code-validator/code-validator.component.d.ts

@@ -30,6 +30,13 @@ export declare class CodeValidatorComponent {
      * La regla del producto. Sin esto el componente no valida nada: lee y avisa.
      */
     validate?: ValidateFn;
+    /**
+     * Se emite apenas se lee un código, ANTES de invocar `validate`. Sirve para
+     * lo que no depende del resultado: analítica de intento de escaneo, o que
+     * el producto decida su propia estrategia de reintento alrededor de
+     * `validate` sin que el componente sepa de HTTP.
+     */
+    scanned: EventEmitter<string>;
     validated: EventEmitter<ValidationEntry>;
     closed: EventEmitter<void>;
     /**
@@ -113,5 +120,5 @@ export declare class CodeValidatorComponent {
     private announce;
     private clearTimer;
     static ɵfac: i0.ɵɵFactoryDeclaration<CodeValidatorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CodeValidatorComponent, "val-code-validator", never, { "props": { "alias": "props"; "required": false; }; "validate": { "alias": "validate"; "required": false; }; "_modalRef": { "alias": "_modalRef"; "required": false; }; }, { "validated": "validated"; "closed": "closed"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CodeValidatorComponent, "val-code-validator", never, { "props": { "alias": "props"; "required": false; }; "validate": { "alias": "validate"; "required": false; }; "_modalRef": { "alias": "_modalRef"; "required": false; }; }, { "scanned": "scanned"; "validated": "validated"; "closed": "closed"; }, never, never, true, never>;
 }

package/lib/components/organisms/survey-builder/survey-builder.component.d.ts

@@ -0,0 +1,43 @@
+import { EventEmitter, OnInit } from '@angular/core';
+import { FormControl } from '@angular/forms';
+import { SurveyBuilderMetadata, SurveyBuilderSaveEvent, SurveyQuestionRow } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-survey-builder
+ *
+ * Autoría de una encuesta: título, subtítulo, preguntas — arma o actualiza un
+ * `RequestTypeConfig` con `Type: "<prefix>:<slug>"` (ADR-092), `skipReview:
+ * true` (cada respuesta se agrega, no se revisa una por una) y el `EntityRef`
+ * que le pasa el consumer (ej. el evento de bingo dueño de la encuesta).
+ *
+ * v1 solo ofrece los dos tipos de pregunta que `val-survey-response` sabe
+ * renderizar: emoji-rating y texto libre. Reusa `RequestFormBuilderService`
+ * (`toToken`/`uniqueFieldName`/`createFieldSchema`) para el nombre de campo —
+ * es la misma primitiva que ya arma el formulario dinámico de `request`, no
+ * una reimplementación.
+ */
+export declare class SurveyBuilderComponent implements OnInit {
+    props: SurveyBuilderMetadata;
+    readonly saved: EventEmitter<SurveyBuilderSaveEvent>;
+    private readonly i18n;
+    private readonly requests;
+    private readonly formBuilder;
+    private readonly errors;
+    readonly emojiType = "EMOJI_RATING";
+    readonly titleControl: FormControl<string>;
+    readonly subtitleControl: FormControl<string>;
+    readonly questions: import("@angular/core").WritableSignal<SurveyQuestionRow[]>;
+    readonly saving: import("@angular/core").WritableSignal<boolean>;
+    private readonly rowControls;
+    constructor();
+    ngOnInit(): Promise<void>;
+    private rowFromField;
+    rowLabelControl(row: SurveyQuestionRow): FormControl<string>;
+    addQuestion(): void;
+    removeQuestion(row: SurveyQuestionRow): void;
+    setType(row: SurveyQuestionRow, type: SurveyQuestionRow['type']): void;
+    save(): Promise<void>;
+    t(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SurveyBuilderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SurveyBuilderComponent, "val-survey-builder", never, { "props": { "alias": "props"; "required": false; }; }, { "saved": "saved"; }, never, never, true, never>;
+}

package/lib/components/organisms/survey-builder/survey-builder.i18n.d.ts

@@ -0,0 +1,2 @@
+import { LanguagesContent } from '../../../services/i18n';
+export declare const SURVEY_BUILDER_I18N: LanguagesContent;

package/lib/components/organisms/survey-builder/types.d.ts

@@ -0,0 +1,28 @@
+import { EntityRef, RequestTypeConfig, RequestVisibility } from '../../../services/requests/types';
+/**
+ * Una pregunta en construcción — antes de convertirse en `FieldSchemaDef`.
+ * v1 solo soporta estos dos tipos (ADR-092) — el mismo par que sabe
+ * renderizar `val-survey-response`. Ampliar acá implica ampliar también el
+ * renderer de respuesta, no es un cambio de un solo lado.
+ */
+export interface SurveyQuestionRow {
+    /** Id local, solo para `track` en el template — no viaja al backend. */
+    id: string;
+    label: string;
+    type: 'TEXTAREA' | 'EMOJI_RATING';
+    required: boolean;
+}
+export interface SurveyBuilderMetadata {
+    /** Si se pasa, edita ese tipo existente; si no, crea uno nuevo. */
+    typeId?: string;
+    /** Prefijo del `Type` del RequestTypeConfig — el componente arma `"<prefix>:<slug>"`. */
+    typePrefix?: string;
+    entityRef?: EntityRef;
+    /** Default 'PUBLIC' — el caso más común: link enviado a gente sin cuenta. */
+    visibility?: RequestVisibility;
+    /** Default true. */
+    allowAnonymous?: boolean;
+}
+export interface SurveyBuilderSaveEvent {
+    typeConfig: RequestTypeConfig;
+}

package/lib/components/organisms/survey-response/survey-response.component.d.ts

@@ -0,0 +1,68 @@
+import { EventEmitter, OnInit } from '@angular/core';
+import { FormControl } from '@angular/forms';
+import { RequestTypeConfig } from '../../../services/requests/types';
+import { EmptyStateMetadata } from '../../molecules/empty-state/types';
+import { SurveyResponseMetadata, SurveyResponseSubmitEvent } from './types';
+import * as i0 from "@angular/core";
+/**
+ * val-survey-response
+ *
+ * Toma una encuesta (`RequestTypeConfig` con `Type: "survey:<slug>"`, ADR-092)
+ * y la presenta como formulario de respuesta — el organism que un visitante
+ * ve al abrir el link de una encuesta. Self-contained, igual que
+ * `val-content-reaction`/`val-access-request-view`: lee el tipo, arma el
+ * formulario, envía la respuesta, sin que el consumer tenga que orquestar
+ * nada de eso.
+ *
+ * Solo lee tipos `visibility: 'PUBLIC'` (vía `getPublicRequestType`, sin
+ * auth) — es el caso de uso que describe el ADR (link enviado a compradores,
+ * que pueden no tener cuenta). Encuestas AUTHENTICATED/ORG/INTERNAL están
+ * fuera de alcance de este componente por ahora.
+ *
+ * Cada pregunta se renderiza según su `FieldSchemaDef.type`: `EMOJI_RATING`
+ * usa `val-emoji-rating` (NUNCA pasa por `val-form`, no lo sabe rutear);
+ * cualquier otro tipo (v1: solo `TEXTAREA`) usa `val-textarea-input`. No hay
+ * `val-form` de por medio — un FormGroup armado a mano, porque mezclar tipos
+ * custom con el form genérico es más complicado que construir el propio.
+ */
+export declare class SurveyResponseComponent implements OnInit {
+    props: SurveyResponseMetadata;
+    readonly submitted: EventEmitter<SurveyResponseSubmitEvent>;
+    private readonly i18n;
+    private readonly auth;
+    private readonly requests;
+    private readonly errors;
+    readonly emojiType = "EMOJI_RATING";
+    readonly loading: import("@angular/core").WritableSignal<boolean>;
+    readonly loadError: import("@angular/core").WritableSignal<boolean>;
+    readonly sent: import("@angular/core").WritableSignal<boolean>;
+    readonly sending: import("@angular/core").WritableSignal<boolean>;
+    readonly typeConfig: import("@angular/core").WritableSignal<RequestTypeConfig>;
+    readonly nameControl: FormControl<string>;
+    readonly emailControl: FormControl<string>;
+    private form;
+    constructor();
+    ngOnInit(): Promise<void>;
+    private buildForm;
+    /** Preguntas ordenadas — el template las recorre en este orden. */
+    readonly questions: import("@angular/core").Signal<import("valtech-components").FieldSchemaDef[]>;
+    questionControl(name: string): FormControl;
+    questionLabel(q: {
+        label?: string;
+        labelKey?: string;
+        name: string;
+    }): string;
+    /** Puede responder sin sesión si el tipo lo permite; si no, hace falta login. */
+    readonly canRespond: import("@angular/core").Signal<boolean>;
+    /** Pide nombre+correo solo cuando responde sin sesión — el backend exige
+     * identidad mínima incluso en el camino anónimo (`CreateAnonymousRequest`). */
+    needsIdentity(): boolean;
+    readonly submitState: import("@angular/core").Signal<"ENABLED" | "WORKING">;
+    submit(): Promise<void>;
+    readonly sentState: import("@angular/core").Signal<EmptyStateMetadata>;
+    readonly loadErrorState: import("@angular/core").Signal<EmptyStateMetadata>;
+    readonly loginRequiredState: import("@angular/core").Signal<EmptyStateMetadata>;
+    t(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SurveyResponseComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SurveyResponseComponent, "val-survey-response", never, { "props": { "alias": "props"; "required": false; }; }, { "submitted": "submitted"; }, never, never, true, never>;
+}

package/lib/components/organisms/survey-response/survey-response.i18n.d.ts

@@ -0,0 +1,2 @@
+import { LanguagesContent } from '../../../services/i18n';
+export declare const SURVEY_RESPONSE_I18N: LanguagesContent;

package/lib/components/organisms/survey-response/types.d.ts

@@ -0,0 +1,7 @@
+export interface SurveyResponseMetadata {
+    /** El `TypeID` del RequestTypeConfig (convención: `"survey:<slug>"`). */
+    typeId: string;
+}
+export interface SurveyResponseSubmitEvent {
+    requestId: string;
+}

package/lib/services/qr-generator/types.d.ts

@@ -137,5 +137,16 @@ export interface QrPreset {
 }
 /**
  * Default presets for quick styling.
+ *
+ * ⚠️ 'rounded' / 'dots' / 'classy' / 'modern' usan cornersSquareStyle/
+ * cornersDotStyle NO cuadrados. Los patrones de posición (las 3 esquinas)
+ * necesitan la proporción 1:1:3:1:1 en cuadrado para que un lector los
+ * ubique — redondearlos se ve prolijo pero puede romper la detección en un
+ * decode estático (foto ya tomada, sin los múltiples frames de una cámara
+ * en vivo). Bug real: 'ticket-friendly' tenía este mismo problema hasta el
+ * 2026-08-28 (ver su comentario abajo). Si un preset de estos se va a usar
+ * para un QR que alguien va a re-escanear desde una foto/descarga (no solo
+ * mostrar en pantalla o imprimir grande para escaneo directo), forzar
+ * cornersSquareStyle/cornersDotStyle a 'square' — no usarlo tal cual.
  */
 export declare const QR_PRESETS: Record<string, Partial<QrConfig>>;

package/lib/services/requests/request.service.d.ts

@@ -51,6 +51,13 @@ export declare class RequestService {
     watchComments(appId: string, orgId: string, requestId: string): Observable<RequestComment[]>;
     listRequestTypes(): Observable<ListRequestTypesResponse>;
     getRequestType(typeId: string): Observable<RequestTypeConfig>;
+    /**
+     * Lee un tipo de solicitud SIN requerir sesión — la vía para que un
+     * visitante anónimo con un link a una encuesta PUBLIC pueda renderizar el
+     * formulario antes de responder. El backend rechaza cualquier tipo que no
+     * sea `visibility: 'PUBLIC'` (mismo código que "no existe"). Ver ADR-092.
+     */
+    getPublicRequestType(typeId: string): Observable<RequestTypeConfig>;
     createRequestType(payload: CreateRequestTypePayload): Observable<RequestTypeConfig>;
     updateRequestType(typeId: string, payload: UpdateRequestTypePayload): Observable<RequestTypeConfig>;
     deleteRequestType(typeId: string): Observable<void>;

package/lib/services/requests/types.d.ts

@@ -19,6 +19,8 @@ export interface AppRequest {
     priority?: string;
     submitter: RequestActor;
     assignee?: RequestActor;
+    /** Copiado del RequestTypeConfig al crear — no lo manda quien responde. */
+    entityRef?: EntityRef;
     dueAt?: string;
     createdAt: string;
     updatedAt: string;
@@ -33,6 +35,23 @@ export interface RequestComment {
 }
 export type FieldOption = FormFieldOption;
 export type FieldSchemaDef = FormFieldSchemaDef;
+/**
+ * Tipo de pregunta de escala corta con emoji (3-5 caras). NO es uno de los
+ * tipos que `FormSchemaBuilderService.buildForm` sabe rutear a `val-form` —
+ * un tipo sin mapeo cae a texto plano ahí. Renderizarlo requiere el widget
+ * dedicado `val-emoji-rating`, nunca el form genérico. Ver ADR-092.
+ */
+export declare const FIELD_TYPE_EMOJI_RATING = "EMOJI_RATING";
+/** Identifica la entidad de dominio a la que pertenece un tipo de solicitud
+ * (un evento, una adopción, una receta). Opcional — la mayoría de los tipos
+ * (tickets de soporte, postulaciones) no la necesitan porque el tipo YA es la
+ * entidad. Mismo shape que el `EntityRef` de feedback/chat — no se importa
+ * ninguno de esos paquetes para esto: es un struct de 2 campos, replicarlo es
+ * más barato que acoplar dominios de negocio por un tipo trivial. */
+export interface EntityRef {
+    entityType: string;
+    entityId: string;
+}
 /** Quién puede leer un tipo de solicitud (y sus solicitudes públicas). */
 export type RequestVisibility = 'PUBLIC' | 'AUTHENTICATED' | 'ORG' | 'INTERNAL';
 export interface RequestTypeConfig {
@@ -41,6 +60,15 @@ export interface RequestTypeConfig {
     orgId: string;
     /** Nombre del tipo, escrito por la organización: no se traduce. */
     label: string;
+    /** Bajada del enunciado (ej. encuestas). Label ya cubre el título. */
+    subtitle?: string;
+    entityRef?: EntityRef;
+    /**
+     * true = cada envío se agrega, no se revisa uno por uno (ej. encuestas).
+     * false/undefined (default) = comportamiento histórico: se revisa cada
+     * solicitud (Chesed adopciones, Okhelia recetas).
+     */
+    skipReview?: boolean;
     fieldSchema: FieldSchemaDef[];
     allowAnonymous: boolean;
     /**
@@ -99,6 +127,9 @@ export interface CreateRequestTypePayload {
     typeId?: string;
     /** Nombre del tipo, escrito por la organización: no se traduce. */
     label: string;
+    subtitle?: string;
+    entityRef?: EntityRef;
+    skipReview?: boolean;
     fieldSchema: FieldSchemaDef[];
     allowAnonymous: boolean;
     visibility?: RequestVisibility;
@@ -106,6 +137,9 @@ export interface CreateRequestTypePayload {
 export interface UpdateRequestTypePayload {
     /** Nombre del tipo, escrito por la organización: no se traduce. */
     label: string;
+    subtitle?: string;
+    entityRef?: EntityRef;
+    skipReview?: boolean;
     fieldSchema: FieldSchemaDef[];
     allowAnonymous: boolean;
     visibility?: RequestVisibility;

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

package/package.json

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

package/public-api.d.ts

@@ -20,6 +20,8 @@ export * from './lib/components/atoms/display/display.component';
 export * from './lib/components/atoms/display/types';
 export * from './lib/components/atoms/divider/divider.component';
 export * from './lib/components/atoms/divider/types';
+export * from './lib/components/atoms/emoji-rating/emoji-rating.component';
+export * from './lib/components/atoms/emoji-rating/types';
 export * from './lib/components/atoms/href/href.component';
 export * from './lib/components/atoms/href/types';
 export * from './lib/components/atoms/icon/icon.component';
@@ -236,6 +238,10 @@ export * from './lib/components/molecules/linked-providers/linked-providers.comp
 export * from './lib/components/molecules/linked-providers/types';
 export * from './lib/components/organisms/access-request-view/access-request-view.component';
 export * from './lib/components/organisms/access-request-view/access-request-view.i18n';
+export * from './lib/components/organisms/survey-response/survey-response.component';
+export * from './lib/components/organisms/survey-response/types';
+export * from './lib/components/organisms/survey-builder/survey-builder.component';
+export * from './lib/components/organisms/survey-builder/types';
 export * from './lib/components/molecules/empty-state/empty-state.component';
 export * from './lib/components/molecules/empty-state/factory';
 export * from './lib/components/molecules/empty-state/types';

package/src/lib/components/styles/variables.scss

@@ -104,6 +104,21 @@ $color-default-placeholder: #afbacc;
   --val-container-aside: 0px;
   --val-container-padding: 16px;
 
+  /* RADIO DE BORDE — nueva personalidad de marca (2026-08-28, pedido del CTO):
+   * bordes más redondos, más simpleza. Escala pública consumible desde apps
+   * y desde cualquier componente nuevo — usar var(--val-radius-*, fallback)
+   * en vez de un número suelto. Reemplaza gradualmente a $border-radius-*
+   * (SCSS, solo compile-time, casi sin uso real hoy — ver docs/frontend/
+   * design-personality.md). No se migró aún ningún componente existente a
+   * propósito: este commit solo establece el token.
+   */
+  --val-radius-xs: 10px;
+  --val-radius-sm: 16px;
+  --val-radius-md: 20px;
+  --val-radius-lg: 28px;
+  --val-radius-xl: 36px;
+  --val-radius-full: 999px;
+
   --ion-color-primary: #7026df;
   --ion-color-primary-rgb: 112, 38, 223;
   --ion-color-primary-contrast: #ffffff;