ngx-eiffage-material 0.3.0 → 0.4.0

package/index.d.ts

@@ -1778,83 +1778,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. */

package/package.json

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