valtech-components 4.0.982 → 4.0.983

package/lib/components/organisms/article/article.component.d.ts

@@ -107,6 +107,7 @@ export declare class ArticleComponent implements OnInit, AfterViewInit {
         fill?: "default" | "clear" | "outline" | "solid" | "tint";
         type: "reset" | "submit" | "button";
         token?: string;
+        ariaLabel?: string;
         ref?: any;
         handler?: (value: any) => any;
     };

package/lib/components/organisms/field-schema-editor/field-schema-editor.component.d.ts

@@ -0,0 +1,90 @@
+import { EventEmitter, OnInit } from '@angular/core';
+import { FormControl } from '@angular/forms';
+import { FieldOption } from '../../../services/forms/types';
+import { InputMetadata } from '../../types';
+import { EditableFieldDef, FieldSchemaEditorMetadata, FieldSchemaEditorPreset } from './types';
+import * as i0 from "@angular/core";
+/**
+ * Tipos cuyo valor sale de una lista cerrada que define quien arma el
+ * formulario — sin al menos una opción, el campo no se puede responder.
+ * Espejo de `fieldRequiresOptions` que vivía duplicado en bingo.
+ */
+export declare const FIELD_TYPES_WITH_OPTIONS: string[];
+/**
+ * val-field-schema-editor
+ *
+ * Edita UN campo de un formulario dinámico: texto, tipo, placeholder, nota,
+ * obligatoriedad y opciones. Es la pieza que faltaba en la lib — hasta ahora
+ * el único editor de campos con este nivel vivía dentro de bingo
+ * (`checkout-field-modal.component.ts`), invisible para el resto del factory,
+ * y `val-survey-builder` había terminado con una versión pobre de lo mismo
+ * (dos tipos fijos, sin placeholder ni opciones).
+ *
+ * Es agnóstico de dominio a propósito:
+ * - el **catálogo de tipos** (`allowedTypes`) lo decide el consumer, porque es
+ *   él quien sabe qué sabe renderizar su formulario;
+ * - los **presets** los pasa el consumer, porque "correo del comprador" es de
+ *   checkout y no significa nada en una encuesta.
+ *
+ * No trae cáscara de modal: el consumer lo envuelve en `val-modal-layout` (o
+ * en lo que quiera) y dispara `submit()` desde su propio botón, igual que hace
+ * `survey-create-modal` con `val-survey-builder`.
+ */
+export declare class FieldSchemaEditorComponent implements OnInit {
+    props: FieldSchemaEditorMetadata;
+    readonly save: EventEmitter<EditableFieldDef>;
+    private readonly i18n;
+    private readonly formSchemas;
+    readonly labelControl: FormControl<string>;
+    readonly placeholderControl: FormControl<string>;
+    readonly hintControl: FormControl<string>;
+    readonly requiredControl: FormControl<boolean>;
+    readonly typeControl: FormControl<string>;
+    readonly options: import("@angular/core").WritableSignal<FieldOption[]>;
+    readonly validationError: import("@angular/core").WritableSignal<string>;
+    readonly selectedPresetId: import("@angular/core").WritableSignal<string>;
+    /** Se refresca con cada cambio de tipo — `needsOptions` no puede leer el control directo. */
+    private readonly currentType;
+    /** Una vez que se toca el token a mano (o se edita un campo ya guardado) deja de derivarse del label. */
+    private nameLocked;
+    private name;
+    private fieldId;
+    constructor();
+    ngOnInit(): void;
+    t(key: string): string;
+    state(): import("../../types").ComponentState;
+    showPresets(): boolean;
+    needsOptions(): boolean;
+    typeLabel(type: string): string;
+    readonly typeSelectProps: import("@angular/core").Signal<Partial<InputMetadata>>;
+    readonly optionsEditorProps: import("@angular/core").Signal<{
+        title: string;
+        hint: string;
+        addLabel: string;
+        optionsLabel: string;
+        placeholder: string;
+        emptyText: string;
+        removeOptionLabel: string;
+        reorderOptionLabel: string;
+        state: import("../../types").ComponentState;
+        options: FieldOption[];
+    }>;
+    selectPreset(preset: FieldSchemaEditorPreset): void;
+    /**
+     * Valida y emite. Público a propósito: lo llama el consumer desde el botón
+     * de su propia cáscara (modal, página o acordeón).
+     */
+    submit(): boolean;
+    /** El campo tal como está en pantalla, sin validar. */
+    value(): EditableFieldDef;
+    private allowedTypes;
+    /**
+     * Un tipo fuera del catálogo del consumer cae al primero permitido. Pasa al
+     * editar un campo guardado con un tipo que la app ya no ofrece (bingo lo
+     * hacía con ATTACHMENT cuando el medio de pago no lo admite): sin esto, el
+     * select queda en un valor que no está en su lista y se ve vacío.
+     */
+    private coerceType;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FieldSchemaEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FieldSchemaEditorComponent, "val-field-schema-editor", never, { "props": { "alias": "props"; "required": false; }; }, { "save": "save"; }, never, never, true, never>;
+}

package/lib/components/organisms/field-schema-editor/field-schema-editor.i18n.d.ts

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

package/lib/components/organisms/field-schema-editor/types.d.ts

@@ -0,0 +1,60 @@
+import { ComponentState } from '../../types';
+import { FieldOption } from '../../../services/forms/types';
+/**
+ * Un campo en edición — la forma mutable con la que trabaja el editor antes de
+ * convertirse en `FieldSchemaDef` vía `FormSchemaBuilderService.createFieldSchema`.
+ *
+ * No es `FieldSchemaDef` a propósito: ese tipo carga `labelKey`, `order`,
+ * `validators` y los `*Es/*En` de compatibilidad, ninguno de los cuales edita
+ * una persona. El editor trabaja con lo que se escribe en pantalla y deja que
+ * el builder derive el resto.
+ */
+export interface EditableFieldDef {
+    /** Id local estable — sirve para `track` y para reemplazar en la lista al editar. */
+    id: string;
+    /** Token del campo (derivado del label mientras no se edite a mano). */
+    name: string;
+    /** Texto que escribe la organización. No se traduce (regla #4 de CLAUDE.md). */
+    label: string;
+    placeholderText: string;
+    hintText: string;
+    type: string;
+    required: boolean;
+    options?: FieldOption[];
+}
+/**
+ * Un punto de partida ofrecido al crear un campo. Los define el consumer, no
+ * el editor: los presets de un checkout (correo, teléfono, curso) no tienen
+ * nada que ver con los de una encuesta.
+ */
+export interface FieldSchemaEditorPreset {
+    id: string;
+    /** Título de la tarjeta del preset. */
+    label: string;
+    /** Bajada de la tarjeta. Opcional. */
+    description?: string;
+    /** Valores con los que se rellena el editor al elegirlo. */
+    field: Omit<EditableFieldDef, 'id'>;
+}
+export interface FieldSchemaEditorMetadata {
+    /** 'edit' oculta los presets y no re-deriva el `name` desde el label. */
+    mode?: 'new' | 'edit';
+    /** Campo a editar. Ausente = campo nuevo. */
+    field?: EditableFieldDef | null;
+    /**
+     * Catálogo de tipos que este consumer ofrece. Obligatorio y acotado a
+     * propósito: quien usa el editor decide qué tipos tienen sentido en su
+     * dominio (una encuesta pública no ofrece ATTACHMENT, un checkout no ofrece
+     * EMOJI_RATING) y, sobre todo, garantiza que su renderer sepa dibujarlos.
+     */
+    allowedTypes: string[];
+    /** Etiqueta visible por tipo. Si falta una, cae al default i18n del editor. */
+    typeLabels?: Record<string, string>;
+    presets?: FieldSchemaEditorPreset[];
+    presetsTitle?: string;
+    /** Default true. */
+    showPlaceholder?: boolean;
+    /** Default true. */
+    showHint?: boolean;
+    state?: ComponentState;
+}

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

@@ -1,6 +1,9 @@
 import { EventEmitter, OnInit } from '@angular/core';
 import { FormControl } from '@angular/forms';
-import { SurveyBuilderMetadata, SurveyBuilderSaveEvent, SurveyQuestionRow } from './types';
+import { ButtonMetadata } from '../../types';
+import type { Color } from '@ionic/core';
+import { EditableFieldDef, FieldSchemaEditorMetadata } from '../field-schema-editor/types';
+import { SurveyBuilderMetadata, SurveyBuilderSaveEvent } from './types';
 import * as i0 from "@angular/core";
 /**
  * val-survey-builder
@@ -10,11 +13,14 @@ import * as i0 from "@angular/core";
  * 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.
+ * Cada pregunta se edita con `val-field-schema-editor`, el mismo editor que usa
+ * el checkout de bingo — de ahí que una pregunta tenga tipo, placeholder, nota
+ * y opciones, no solo texto. La v1 de este componente tenía su propio editor
+ * pobre (dos tipos, sin opciones); la Fase 5 del ADR-092 lo reemplazó por el
+ * organism compartido en vez de mejorarlo por duplicado.
+ *
+ * El catálogo que ofrece sale de `SURVEY_QUESTION_TYPES` — acotado a lo que
+ * `val-survey-response` sabe renderizar, no a lo que el editor sabe editar.
  */
 export declare class SurveyBuilderComponent implements OnInit {
     props: SurveyBuilderMetadata;
@@ -23,21 +29,27 @@ export declare class SurveyBuilderComponent implements OnInit {
     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 questions: import("@angular/core").WritableSignal<EditableFieldDef[]>;
+    readonly editingId: import("@angular/core").WritableSignal<string>;
+    readonly validationError: import("@angular/core").WritableSignal<string>;
     readonly saving: import("@angular/core").WritableSignal<boolean>;
-    private readonly rowControls;
     constructor();
     ngOnInit(): Promise<void>;
-    private rowFromField;
-    rowLabelControl(row: SurveyQuestionRow): FormControl<string>;
+    t(key: string): string;
+    typeLabel(type: string): string;
+    questionTypes(): string[];
+    editorProps(row: EditableFieldDef): FieldSchemaEditorMetadata;
+    iconAction(token: string, icon: string, label: string, disabled?: boolean, color?: Color): ButtonMetadata;
     addQuestion(): void;
-    removeQuestion(row: SurveyQuestionRow): void;
-    setType(row: SurveyQuestionRow, type: SurveyQuestionRow['type']): void;
+    toggleEdit(row: EditableFieldDef): void;
+    removeQuestion(row: EditableFieldDef): void;
+    duplicate(row: EditableFieldDef): void;
+    move(index: number, delta: number): void;
+    applyQuestion(field: EditableFieldDef): void;
     save(): Promise<void>;
-    t(key: string): string;
+    private rowFromField;
     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/types.d.ts

@@ -1,12 +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.
+ * Tipos de pregunta que ofrece una encuesta.
+ *
+ * El corte no es estético: **todo tipo que esta lista ofrezca, `val-survey-response`
+ * tiene que saber renderizarlo**, o la encuesta se guarda bien y se responde mal
+ * (un rating dibujado como caja de texto). Ampliar acá obliga a ampliar el
+ * renderer en la misma entrega.
+ *
+ * Los seis primeros son de respuesta cerrada — `closedAnswerTypes` en
+ * `backend/go/services/request/aggregate.go` los cuenta por valor en el
+ * dashboard. Los seis últimos son abiertos: el dashboard lista sus respuestas.
+ *
+ * `FILE`/`ATTACHMENT` quedan deliberadamente fuera: una encuesta es pública y
+ * anónima por default, y aceptar subidas ahí es superficie de abuso sin un caso
+ * de uso que lo pida.
+ */
+export declare const SURVEY_QUESTION_TYPES: string[];
+/**
+ * @deprecated Quedó de la v1 del builder (ADR-092 Fase 2), cuando una pregunta
+ * era solo label + uno de dos tipos. Hoy una pregunta es un `EditableFieldDef`
+ * completo — ver `val-field-schema-editor`. No se usa en ningún lado; se
+ * conserva un ciclo para no romper un import perdido.
  */
 export interface SurveyQuestionRow {
-    /** Id local, solo para `track` en el template — no viaja al backend. */
     id: string;
     label: string;
     type: 'TEXTAREA' | 'EMOJI_RATING';
@@ -22,6 +38,8 @@ export interface SurveyBuilderMetadata {
     visibility?: RequestVisibility;
     /** Default true. */
     allowAnonymous?: boolean;
+    /** Acota el catálogo de `SURVEY_QUESTION_TYPES` si una app quiere ofrecer menos. */
+    questionTypes?: string[];
 }
 export interface SurveyBuilderSaveEvent {
     typeConfig: RequestTypeConfig;

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

@@ -1,6 +1,7 @@
 import { EventEmitter, OnInit } from '@angular/core';
 import { FormControl } from '@angular/forms';
-import { RequestTypeConfig } from '../../../services/requests/types';
+import { FieldSchemaDef, RequestTypeConfig } from '../../../services/requests/types';
+import { InputMetadata, InputOption, InputType } from '../../types';
 import { EmptyStateMetadata } from '../../molecules/empty-state/types';
 import { SurveyResponseMetadata, SurveyResponseSubmitEvent } from './types';
 import * as i0 from "@angular/core";
@@ -33,20 +34,60 @@ export declare class SurveyResponseComponent implements OnInit {
     private readonly requests;
     private readonly errors;
     readonly emojiType = "EMOJI_RATING";
+    readonly selectType = InputType.SELECT;
     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 multiSelectError: import("@angular/core").WritableSignal<boolean>;
     readonly nameControl: FormControl<string>;
     readonly emailControl: FormControl<string>;
     private form;
+    /**
+     * Una casilla por opción de cada pregunta MULTI_SELECT, indexada
+     * `"<pregunta>::<opcion>"`. Viven fuera del `form` porque el valor que viaja
+     * al backend es UNA lista por pregunta, no N booleanos: se arma al enviar.
+     */
+    private readonly multiControls;
     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;
+    booleanControl(name: string): FormControl<boolean>;
+    optionControl(name: string, optionId: string): FormControl<boolean>;
+    /** Opciones tal como las escribió quien creó la encuesta — no se traducen. */
+    optionsOf(q: {
+        options?: {
+            id: string;
+            name: string;
+            order?: number;
+        }[];
+    }): InputOption[];
+    /**
+     * `val-radio-input` pide un `InputMetadata` completo (no `Partial`), así que
+     * se arma acá en vez de en el template.
+     */
+    radioProps(q: FieldSchemaDef): InputMetadata;
+    placeholderOf(q: {
+        placeholderText?: string;
+        placeholder?: string;
+    }): string;
+    hintOf(q: {
+        hintText?: string;
+        hint?: string;
+    }): string;
+    /**
+     * Tipo del `<input>` para las preguntas que se responden escribiendo. Nada de
+     * `parseInputType` de `FormSchemaBuilderService`: ese mapea al enum de
+     * `val-form`, y acá no hay `val-form` de por medio (ver el comentario de
+     * clase). Un tipo desconocido cae a texto, que siempre se puede responder.
+     */
+    inputTypeOf(type: string): 'text' | 'email' | 'number' | 'tel';
+    /** Las opciones marcadas de una pregunta MULTI_SELECT, en el orden del schema. */
+    private selectedOptions;
     questionLabel(q: {
         label?: string;
         labelKey?: string;

package/lib/components/types.d.ts

@@ -381,6 +381,12 @@ export interface ButtonMetadata {
     type: 'button' | 'submit' | 'reset';
     /** Optional token identifier */
     token?: string;
+    /**
+     * Nombre accesible del botón. Obligatorio en un botón `icon-only`: sin texto
+     * visible, un lector de pantalla solo anuncia "botón" (el `ion-icon` va
+     * `aria-hidden`). Ignorado cuando el botón tiene texto propio.
+     */
+    ariaLabel?: string;
     /** Optional reference */
     ref?: any;
     /** Action handler */

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

package/package.json

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

package/public-api.d.ts

@@ -240,6 +240,8 @@ export * from './lib/components/organisms/access-request-view/access-request-vie
 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/field-schema-editor/field-schema-editor.component';
+export * from './lib/components/organisms/field-schema-editor/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';