valtech-components 2.0.1032 → 2.0.1033

package/lib/components/organisms/field-list/field-list.component.d.ts

@@ -0,0 +1,55 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { FieldListColumn, FieldListItem, FieldListMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-field-list` — editor de listas de campos repetibles (premios, rondas,
+ * integrantes, etc.). Cada ítem es una **card** con sus campos apilados y un botón
+ * para quitarla; al pie un botón "Agregar". Mobile-first (1 columna), escala a
+ * varias columnas por fila en pantallas anchas.
+ *
+ * Maneja su propio estado interno y emite el array completo en cada cambio
+ * (`itemsChange`). Patrón object-first (`@Input() props`). Auto-registra i18n
+ * (namespace `FieldList`) para los labels por defecto (agregar/quitar/vacío).
+ *
+ * @example
+ * <val-field-list
+ *   [props]="{
+ *     fields: [
+ *       { name: 'nombre', label: 'Nombre' },
+ *       { name: 'descripcion', label: 'Descripción' }
+ *     ],
+ *     items: premios,
+ *     itemLabel: 'Premio {n}',
+ *     addLabel: 'Agregar premio'
+ *   }"
+ *   (itemsChange)="premios = $event" />
+ */
+export declare class FieldListComponent implements OnChanges {
+    private i18n;
+    constructor();
+    /** Props object-first. */
+    props: FieldListMetadata;
+    /** Emite el array completo de ítems en cada add/remove/edición. */
+    itemsChange: EventEmitter<FieldListItem[]>;
+    /** Estado interno de las filas (se siembra desde props.items). */
+    private readonly rowsSig;
+    readonly rows: import("@angular/core").Signal<FieldListItem[]>;
+    readonly fields: import("@angular/core").Signal<FieldListColumn[]>;
+    readonly itemLabel: import("@angular/core").Signal<string>;
+    readonly addIcon: import("@angular/core").Signal<string>;
+    readonly addText: import("@angular/core").Signal<string>;
+    readonly removeText: import("@angular/core").Signal<string>;
+    readonly emptyText: import("@angular/core").Signal<string>;
+    /** Puede agregar si no se alcanzó el máximo. */
+    readonly canAdd: import("@angular/core").Signal<boolean>;
+    ngOnChanges(changes: SimpleChanges): void;
+    private t;
+    /** Reemplaza `{n}` por el número de fila (1-based) en el rótulo de la card. */
+    rowLabel(template: string, index: number): string;
+    addRow(): void;
+    removeRow(index: number): void;
+    updateField(index: number, field: FieldListColumn, value: string | number): void;
+    private emit;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FieldListComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FieldListComponent, "val-field-list", never, { "props": { "alias": "props"; "required": false; }; }, { "itemsChange": "itemsChange"; }, never, never, true, never>;
+}

package/lib/components/organisms/field-list/field-list.i18n.d.ts

@@ -0,0 +1,6 @@
+import { LanguagesContent } from '../../../services/i18n/types';
+/**
+ * Defaults i18n (es/en) embebidos en `val-field-list`. Auto-registrados en el
+ * namespace `FieldList` si el consumer no lo proveyó (anti key-faltante).
+ */
+export declare const FIELD_LIST_I18N: LanguagesContent;

package/lib/components/organisms/field-list/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Tipos de `val-field-list` — editor de listas de campos repetibles.
+ *
+ * Cada ítem de la lista es un registro (`FieldListItem`) con las claves definidas
+ * en `fields`. El componente maneja su propio estado y emite el array completo en
+ * cada cambio (`itemsChange`). Patrón object-first (`@Input() props`).
+ */
+/** Tipo de input soportado por una columna del field-list. */
+export type FieldListInputType = 'text' | 'number';
+/** Definición de un campo (columna) de cada fila. */
+export interface FieldListColumn {
+    /** Clave del campo en el registro de la fila. */
+    name: string;
+    /** Label visible arriba del input. */
+    label: string;
+    /** Placeholder del input. */
+    placeholder?: string;
+    /** Tipo de input (default `text`). */
+    type?: FieldListInputType;
+    /** `inputmode` del input (ej. `numeric` para montos/órdenes). */
+    inputmode?: string;
+    /** Largo máximo (solo `text`). */
+    maxlength?: number;
+    /** Mínimo (solo `number`). */
+    min?: number;
+}
+/** Un ítem de la lista: registro clave→valor según `fields`. */
+export type FieldListItem = Record<string, string | number>;
+/** Props (object-first) de `val-field-list`. */
+export interface FieldListMetadata {
+    /** Esquema de campos de cada fila. */
+    fields: FieldListColumn[];
+    /** Valor inicial de la lista (se clona al estado interno). */
+    items?: FieldListItem[];
+    /** Texto del botón "Agregar" (default i18n). */
+    addLabel?: string;
+    /** Texto/aria del botón quitar (default i18n). */
+    removeLabel?: string;
+    /** Hint mostrado cuando la lista está vacía (default i18n). */
+    emptyText?: string;
+    /**
+     * Template del rótulo de cada card: `{n}` se reemplaza por el número de fila
+     * (1-based). Ej. `"Premio {n}"`. Si se omite, la card no muestra rótulo.
+     */
+    itemLabel?: string;
+    /** Mínimo de filas (no se puede bajar de acá). Default 0. */
+    min?: number;
+    /** Máximo de filas (oculta "Agregar" al alcanzarlo). Default sin límite. */
+    max?: number;
+    /** Ionicon del botón agregar (default `add-outline`). */
+    addIcon?: 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.1032";
+export declare const VERSION = "2.0.1033";

package/package.json

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

package/public-api.d.ts

@@ -308,6 +308,8 @@ export * from './lib/components/organisms/invite-member-modal/invite-member-moda
 export * from './lib/components/organisms/member-detail-modal/member-detail-modal.component';
 export * from './lib/components/organisms/member-detail-modal/types';
 export * from './lib/components/organisms/member-import-modal/member-import-modal.component';
+export * from './lib/components/organisms/field-list/field-list.component';
+export * from './lib/components/organisms/field-list/types';
 export * from './lib/components/organisms/api-keys-modal/api-keys-modal.component';
 export * from './lib/components/organisms/api-key-create-modal/api-key-create-modal.component';
 export * from './lib/components/organisms/api-keys-view/api-keys-view.component';