ngx-eiffage-material 0.3.0 → 0.5.0

package/index.d.ts

@@ -1124,7 +1124,6 @@ declare class NgxDialog<T = any, R = unknown> implements NgxDialogContext<R> {
     readonly destructive: boolean;
     /** La X no tiene sentido en un diálogo con disableClose (está pensado para no poder cerrarse sin decidir). */
     readonly showClose: boolean;
-    readonly closeLabel: string;
     readonly cancelText: string;
     readonly confirmText: string;
     readonly result: _angular_core.WritableSignal<R | undefined>;
@@ -1138,6 +1137,44 @@ declare class NgxDialog<T = any, R = unknown> implements NgxDialogContext<R> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxDialog<any, any>, "ngx-dialog", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Encabezado de diálogo con botón X para cerrar: el mismo que usa ngx-dialog, para diálogos propios
+ * abiertos con MatDialog. Va en lugar de `<h2 mat-dialog-title>`:
+ *
+ * ```html
+ * <ngx-dialog-header [title]="'Editar proyecto'" icon="edit" />
+ * <!-- o con contenido propio -->
+ * <ngx-dialog-header>{{ (isNew ? 'PROJECTS.create' : 'PROJECTS.edit') | translate }}</ngx-dialog-header>
+ * ```
+ */
+declare class NgxDialogHeader implements DoCheck {
+    private readonly _dialogRef;
+    protected readonly texts: _angular_core.Signal<ngx_eiffage_material.NgxEiffageTexts>;
+    /** Título. También se puede poner como contenido (`<ngx-dialog-header>…</ngx-dialog-header>`). */
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    /** Línea secundaria bajo el título. */
+    readonly subtitle: _angular_core.InputSignal<string | undefined>;
+    /** Icono de Material Symbols delante del título. */
+    readonly icon: _angular_core.InputSignal<string | undefined>;
+    /** Color del icono (p. ej. `var(--mat-sys-error)`). */
+    readonly iconColor: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Muestra la X. Sin indicar, se ve mientras el diálogo se pueda cerrar: se oculta si el diálogo tiene
+     * `disableClose` (también si se activa después, p. ej. durante una subida) y vuelve al quitarlo.
+     */
+    readonly showClose: _angular_core.InputSignal<boolean | undefined>;
+    /** Valor con el que se cierra al pulsar la X. Por defecto `undefined`, igual que con Esc o al pulsar fuera. */
+    readonly closeResult: _angular_core.InputSignal<unknown>;
+    /** disableClose es una propiedad normal del MatDialogRef: se lee en cada comprobación. */
+    private readonly _closable;
+    protected readonly closeVisible: _angular_core.Signal<boolean>;
+    ngDoCheck(): void;
+    /** Cierra el diálogo con `closeResult`. */
+    close(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxDialogHeader, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxDialogHeader, "ngx-dialog-header", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconColor": { "alias": "iconColor"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "closeResult": { "alias": "closeResult"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
 /**
  * @deprecated Usar `NgxDialogService.confirm()` (o `template()` con contenido propio), que tiene el
  * encabezado, el botón X y la opción `destructive` de ngx-dialog. Las tablas ya no lo usan; se
@@ -1778,83 +1815,105 @@ declare class NgxSkeleton {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxSkeleton, "ngx-skeleton", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "lines": { "alias": "lines"; "required": false; "isSignal": true; }; "lineSpacing": { "alias": "lineSpacing"; "required": false; "isSignal": true; }; "lastLineWidth": { "alias": "lastLineWidth"; "required": false; "isSignal": true; }; "animation": { "alias": "animation"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; "borderRadius": { "alias": "borderRadius"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "decorative": { "alias": "decorative"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare class NgxFileInput implements ControlValueAccessor {
-    private readonly _platform;
-    private readonly _inputId;
+/** Familia del fichero, para el color de su icono en ngx-file-input. */
+type FileKind = 'image' | 'pdf' | 'video' | 'audio' | 'generic';
+
+/**
+ * Zona para soltar o seleccionar ficheros, con lista de ficheros y previsualización de imágenes.
+ * Se usa con `formControlName` / `[formControl]` / `ngModel` (valor: los `File[]` válidos) o con `[(files)]`.
+ */
+declare class NgxFileInput implements ControlValueAccessor, AfterViewInit, DoCheck {
+    private readonly _ngControl;
+    private readonly _parentForm;
+    private readonly _host;
+    private readonly _locale;
+    private readonly _isBrowser;
     private readonly _nativeInput;
-    /** Accepted MIME types or extensions (e.g. `'image/*,.pdf'`). */
-    readonly accept: _angular_core.InputSignal<string>;
-    /** Allow selecting multiple files. */
+    protected readonly texts: _angular_core.Signal<ngx_eiffage_material.NgxEiffageTexts>;
+    /** Tipos admitidos: extensiones (`.pdf`), MIME (`application/pdf`) o comodines (`image/*`). `'*'` = cualquiera. */
+    readonly accept: _angular_core.InputSignal<string | string[]>;
+    /** Admite varios ficheros: cada selección se añade a la anterior. */
     readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Maximum file size in bytes per file. `null` means no limit. */
+    /** Tamaño máximo por fichero, en bytes. `null` = sin límite. */
     readonly maxSize: _angular_core.InputSignal<number | null>;
-    /** Maximum number of files when `multiple` is true. `null` means no limit. */
+    /** Número máximo de ficheros válidos (con `multiple`). `null` = sin límite. */
     readonly maxFiles: _angular_core.InputSignal<number | null>;
-    /** Disables the component. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Label text shown inside the drop zone. Por defecto, el texto `fileInput.dropLabel` de la librería. */
+    /** Texto principal. Por defecto, el texto `fileInput.dropLabel` de la librería. */
     readonly label: _angular_core.InputSignal<string | undefined>;
-    protected readonly texts: _angular_core.Signal<ngx_eiffage_material.NgxEiffageTexts>;
-    protected readonly resolvedLabel: _angular_core.Signal<string>;
-    /** Secondary hint text (formats, sizes…). */
+    /** Texto secundario (formatos, tamaños…). */
     readonly hint: _angular_core.InputSignal<string | null>;
-    /** Show the file preview list below the drop zone. */
+    /** Mensaje de error. Se ve cuando el control es inválido y está tocado o el formulario se ha enviado. */
+    readonly error: _angular_core.InputSignal<string>;
+    /** Muestra la lista de ficheros (con miniatura de las imágenes). */
     readonly showPreview: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Visual variant: `'default'` (large zone), `'compact'` (horizontal), or `'button'`. */
+    /** `'default'` (zona grande), `'compact'` (barra horizontal) o `'button'` (solo un botón). */
     readonly variant: _angular_core.InputSignal<NgxFileInputVariant>;
-    /** Emits when valid files are added. */
+    /** Ficheros válidos seleccionados. Admite `[(files)]` para usarlo sin formularios. */
+    readonly files: _angular_core.ModelSignal<File[]>;
+    /** Ficheros válidos añadidos en una selección o al soltar. */
     readonly filesSelected: _angular_core.OutputEmitterRef<NgxFileItem[]>;
-    /** Emits when a file is removed from the list. */
+    /** Fichero quitado de la lista (válido o rechazado). */
     readonly fileRemoved: _angular_core.OutputEmitterRef<NgxFileItem>;
-    /** Emits for each file that fails validation. */
+    /** Un fichero rechazado (tipo, tamaño o número). */
     readonly validationError: _angular_core.OutputEmitterRef<NgxFileError>;
-    /** All file items (valid + invalid). */
-    readonly items: _angular_core.WritableSignal<NgxFileItem[]>;
-    /** Whether the user is dragging files over the drop zone. */
-    readonly isDragOver: _angular_core.WritableSignal<boolean>;
-    /** Brief flash after a successful drop. */
-    readonly showDropConfirm: _angular_core.WritableSignal<boolean>;
-    /** Announcement text for screen readers. */
-    readonly liveAnnouncement: _angular_core.WritableSignal<string>;
-    /** Unique id for the hidden file input. */
-    readonly inputId: string;
-    /** Disabled state coming from `setDisabledState()` (reactive forms). */
+    protected readonly id: string;
+    private readonly _entries;
     private readonly _cvaDisabled;
-    /**
-     * Effective disabled state: the `disabled` input OR the state pushed by the
-     * parent FormControl through `setDisabledState()`.
-     */
+    /** Deshabilitado por el input `disabled` o por el control del formulario. */
     readonly isDisabled: _angular_core.Signal<boolean>;
-    /** Derived: valid files only (used as FormControl value). */
-    protected readonly validFiles: _angular_core.Signal<File[]>;
+    protected readonly isDragOver: _angular_core.WritableSignal<boolean>;
+    protected readonly showDropConfirm: _angular_core.WritableSignal<boolean>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    protected readonly isRequired: _angular_core.WritableSignal<boolean>;
+    protected readonly showError: _angular_core.WritableSignal<boolean>;
+    protected readonly resolvedLabel: _angular_core.Signal<string>;
+    protected readonly acceptAttr: _angular_core.Signal<string>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    /** Lo que pinta la lista: icono, color, tamaño legible y mensaje de error ya traducido. */
+    protected readonly views: _angular_core.Signal<{
+        item: NgxFileItem;
+        icon: string;
+        kind: FileKind;
+        size: string;
+        error: string | null;
+    }[]>;
     private _onChange;
     private _onTouched;
-    writeValue(files: File[] | null): void;
-    registerOnChange(fn: (value: File[]) => void): void;
-    registerOnTouched(fn: () => void): void;
-    setDisabledState(isDisabled: boolean): void;
-    onDragOver(event: DragEvent): void;
-    onDragLeave(event: DragEvent): void;
-    onDrop(event: DragEvent): void;
-    onFileInputChange(event: Event): void;
+    private _controlSub?;
+    private _confirmTimer?;
+    constructor();
+    ngAfterViewInit(): void;
+    ngDoCheck(): void;
+    /** Abre el selector de ficheros del sistema (no hace nada si está deshabilitado). */
     openFilePicker(): void;
+    /** Quita un fichero de la lista, válido o rechazado. */
     removeFile(item: NgxFileItem): void;
-    /** Format bytes to human-readable string. */
-    formatSize(bytes: number): string;
-    /** Get a Material icon name based on MIME type. */
-    getFileIcon(type: string): string;
-    /** Get an accent color class based on MIME type. */
-    getFileColorClass(type: string): string;
-    private _processFiles;
-    private _validateAndCreate;
-    private _toFileItem;
-    private _isTypeAllowed;
-    private _generatePreviews;
-    private _emitChange;
+    protected onZoneKeydown(event: KeyboardEvent): void;
+    protected onZoneBlur(): void;
+    protected onNativeChange(event: Event): void;
+    protected onDragOver(event: DragEvent): void;
+    protected onDragLeave(event: DragEvent): void;
+    protected onDrop(event: DragEvent): void;
+    writeValue(files: File[] | null | undefined): void;
+    registerOnChange(fn: (files: File[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    private _validFiles;
+    private _addFiles;
+    /** Publica los ficheros válidos: model, formulario y estado de tocado. */
+    private _commit;
+    /** Lista nueva a partir de un valor externo (writeValue o [files]); los rechazados se descartan. */
+    private _resetFrom;
+    private _toItem;
+    private _revokePreview;
+    private _message;
+    private _bindControl;
+    private _syncFormState;
+    private _markTouched;
     private _flashDropConfirm;
-    private _generateId;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxFileInput, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxFileInput, "ngx-file-input", never, { "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "showPreview": { "alias": "showPreview"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, { "filesSelected": "filesSelected"; "fileRemoved": "fileRemoved"; "validationError": "validationError"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxFileInput, "ngx-file-input", never, { "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "showPreview": { "alias": "showPreview"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "files": { "alias": "files"; "required": false; "isSignal": true; }; }, { "files": "filesChange"; "filesSelected": "filesSelected"; "fileRemoved": "fileRemoved"; "validationError": "validationError"; }, never, never, true, never>;
 }
 
 /** Opciones comunes a todos los diálogos. */
@@ -1981,5 +2040,5 @@ declare class DynamicHostDirective<T> {
 declare const includeNoSensible: (cadena: string, query: string) => boolean;
 declare const base64ToUtf8: (str: string) => string;
 
-export { AdvancedFilterService, AdvancedFilterUtils, ColumnConfigService, DatosPantallaService, DialogBodyType, DynamicHostDirective, NGX_EIFFAGE_DEFAULT_TEXTS, NGX_EIFFAGE_TEXTS, NgxAlert, NgxBasicSelect, NgxBasicTable, NgxConfirmDialogComponent, NgxDialog, NgxDialogContext, NgxDialogService, NgxFileInput, NgxInputFile, NgxLoadingButton, NgxPaginatedSelect, NgxPaginatedSelectBottomSheetComponent, NgxPaginatedTable, NgxSkeleton, NgxTablesIntl, NgxTexts, OPERATOR_BY_FILTER_TYPE, PaginatedSearchableSelectComponent, SearchableSelectComponent, USER_ID_FACTORY, base64ToUtf8, includeNoSensible, isFilterOption, provideNgxEiffageTexts };
+export { AdvancedFilterService, AdvancedFilterUtils, ColumnConfigService, DatosPantallaService, DialogBodyType, DynamicHostDirective, NGX_EIFFAGE_DEFAULT_TEXTS, NGX_EIFFAGE_TEXTS, NgxAlert, NgxBasicSelect, NgxBasicTable, NgxConfirmDialogComponent, NgxDialog, NgxDialogContext, NgxDialogHeader, NgxDialogService, NgxFileInput, NgxInputFile, NgxLoadingButton, NgxPaginatedSelect, NgxPaginatedSelectBottomSheetComponent, NgxPaginatedTable, NgxSkeleton, NgxTablesIntl, NgxTexts, OPERATOR_BY_FILTER_TYPE, PaginatedSearchableSelectComponent, SearchableSelectComponent, USER_ID_FACTORY, base64ToUtf8, includeNoSensible, isFilterOption, provideNgxEiffageTexts };
 export type { AdvancedFilter, AlertAppearance, AlertType, BasicFilter, BasicSelectConfig, BasicTableColumn, BasicTableConfig, ColumnConfig, ColumnPipe, ColumnValue, ConfigureTableColumnData, ConfirmDialogData, DeleteConfirm, DialogBodyConfig, DialogConfig, DynamicFilter, FilterConnector, FilterGroup, FilterOperator, FilterOption, FilterRule, FilterType, LoadingButtonAppearance, LoadingButtonColor, NgxDialogTemplateContext, NgxEiffageTexts, NgxEiffageTextsOverrides, NgxEiffageTextsSource, NgxFileError, NgxFileErrorCode, NgxFileInputVariant, NgxFileItem, NgxPaginatedSelectBottomSheetData, PaginatedFilter, PaginatedItems, PaginatedSelectConfig, PaginatedTableColumn, PaginatedTableConfig, Pantalla, RowActionClickEvent, RowActionIconColor, RowSelectionAction, SelectionActionEvent, SendType, SkeletonAnimation, SkeletonVariant, SortBy, SortType, TableBasicAction, TableRowAction, TipoPantalla };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-eiffage-material",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "peerDependencies": {
     "@angular/cdk": "^20.0.0 || ^21.0.0 || ^22.0.0",
     "@angular/common": "^20.1.0 || ^21.0.0 || ^22.0.0",