ngx-eiffage-material 0.0.42 → 0.0.43

package/index.d.ts

@@ -1,6 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { OnInit, ElementRef, WritableSignal, Type, TemplateRef, PipeTransform, InjectionToken, Signal, OnDestroy } from '@angular/core';
-import { FormControl } from '@angular/forms';
+import { FormControl, ControlValueAccessor } from '@angular/forms';
 import { SubscriptSizing } from '@angular/material/form-field';
 import { MatSelect, MatSelectChange } from '@angular/material/select';
 import { MatDialogRef, MatDialogConfig } from '@angular/material/dialog';
@@ -304,6 +304,42 @@ type SortType = 'string' | 'number' | 'date';
 
 type AlertType = 'info' | 'warning' | 'error' | 'success';
 
+type SkeletonVariant = 'text' | 'circle' | 'rect' | 'rounded';
+type SkeletonAnimation = 'shimmer' | 'pulse' | 'none';
+
+/** Visual variant of the file input component. */
+type NgxFileInputVariant = 'default' | 'compact' | 'button';
+/** Validation error codes emitted by the file input. */
+type NgxFileErrorCode = 'SIZE_EXCEEDED' | 'TYPE_NOT_ALLOWED' | 'MAX_FILES_EXCEEDED';
+/** Represents a file selected by the user, with metadata and optional preview. */
+interface NgxFileItem {
+    /** The native File object. */
+    file: File;
+    /** Unique identifier generated internally. */
+    id: string;
+    /** File name. */
+    name: string;
+    /** File size in bytes. */
+    size: number;
+    /** MIME type of the file. */
+    type: string;
+    /** Data URL for image previews. */
+    preview?: string;
+    /** Whether the file passed validation. */
+    status: 'valid' | 'error';
+    /** Validation error message, if any. */
+    error?: string;
+}
+/** Describes a validation error for a specific file. */
+interface NgxFileError {
+    /** The native File that failed validation. */
+    file: File;
+    /** Machine-readable error code. */
+    code: NgxFileErrorCode;
+    /** Human-readable error message. */
+    message: string;
+}
+
 declare class NgxBasicSelect<T> {
     readonly label: _angular_core.InputSignal<string>;
     readonly options: _angular_core.InputSignal<T[]>;
@@ -1035,6 +1071,107 @@ declare class NgxPaginatedSelectBottomSheetComponent<T, U extends PaginatedFilte
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxPaginatedSelectBottomSheetComponent<any, any>, "ngx-paginated-select-bottom-sheet", never, {}, {}, never, never, true, never>;
 }
 
+declare class NgxSkeleton {
+    /** Shape variant of the skeleton: text (horizontal bars), circle, rect, or rounded rect. */
+    variant: _angular_core.InputSignal<SkeletonVariant>;
+    /** Width of the skeleton element. Accepts any valid CSS value (px, %, rem, etc.). */
+    width: _angular_core.InputSignal<string>;
+    /** Height of the skeleton element. Accepts any valid CSS value (px, %, rem, etc.). */
+    height: _angular_core.InputSignal<string>;
+    /** Number of lines to render. Only applies when variant is 'text'. */
+    lines: _angular_core.InputSignal<number>;
+    /** Vertical spacing between text lines. Accepts any valid CSS value. */
+    lineSpacing: _angular_core.InputSignal<string>;
+    /** Width of the last text line for a realistic paragraph effect. Accepts any valid CSS value. */
+    lastLineWidth: _angular_core.InputSignal<string>;
+    /** Type of loading animation: shimmer (sliding highlight), pulse (opacity), or none. */
+    animation: _angular_core.InputSignal<SkeletonAnimation>;
+    /** Duration of one full animation cycle. Accepts any valid CSS time value. */
+    animationDuration: _angular_core.InputSignal<string>;
+    /** Overrides the default border-radius derived from the variant. */
+    borderRadius: _angular_core.InputSignal<string | null>;
+    /** Accessible label read by screen readers. */
+    ariaLabel: _angular_core.InputSignal<string>;
+    /** Whether the component should render multiple stacked lines. */
+    protected isMultiLine: _angular_core.Signal<boolean>;
+    /** Index array used to iterate over text lines in the template. */
+    protected lineIndices: _angular_core.Signal<number[]>;
+    /** Resolved border-radius based on variant with optional override. */
+    protected computedBorderRadius: _angular_core.Signal<string>;
+    /** For circle variant, width equals height to ensure a perfect circle. */
+    protected computedWidth: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxSkeleton, never>;
+    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; }; }, {}, never, never, true, never>;
+}
+
+declare class NgxFileInput implements ControlValueAccessor {
+    private readonly _platform;
+    private readonly _inputId;
+    /** Accepted MIME types or extensions (e.g. `'image/*,.pdf'`). */
+    readonly accept: _angular_core.InputSignal<string>;
+    /** Allow selecting multiple files. */
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Maximum file size in bytes per file. `null` means no limit. */
+    readonly maxSize: _angular_core.InputSignal<number | null>;
+    /** Maximum number of files when `multiple` is true. `null` means no limit. */
+    readonly maxFiles: _angular_core.InputSignal<number | null>;
+    /** Disables the component. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Label text shown inside the drop zone. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Secondary hint text (formats, sizes…). */
+    readonly hint: _angular_core.InputSignal<string | null>;
+    /** Show the file preview list below the drop zone. */
+    readonly showPreview: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Visual variant: `'default'` (large zone), `'compact'` (horizontal), or `'button'`. */
+    readonly variant: _angular_core.InputSignal<NgxFileInputVariant>;
+    /** Emits when valid files are added. */
+    readonly filesSelected: _angular_core.OutputEmitterRef<NgxFileItem[]>;
+    /** Emits when a file is removed from the list. */
+    readonly fileRemoved: _angular_core.OutputEmitterRef<NgxFileItem>;
+    /** Emits for each file that fails validation. */
+    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;
+    /** Derived: valid files only (used as FormControl value). */
+    protected readonly validFiles: _angular_core.Signal<File[]>;
+    private _onChange;
+    private _onTouched;
+    writeValue(files: File[] | null): void;
+    registerOnChange(fn: (value: File[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    onDragOver(event: DragEvent): void;
+    onDragLeave(event: DragEvent): void;
+    onDrop(event: DragEvent): void;
+    onFileInputChange(event: Event): void;
+    openFilePicker(): void;
+    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;
+    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>;
+}
+
 declare class NgxDialogService {
     private readonly _dialog;
     /**
@@ -1169,5 +1306,5 @@ declare class DynamicHostDirective<T> {
 declare const includeNoSensible: (cadena: string, query: string) => boolean;
 declare const base64ToUtf8: (str: string) => string;
 
-export { DynamicHostDirective, NgxAlert, NgxBasicSelect, NgxBasicTable, NgxConfirmDialogComponent, NgxDialog, NgxDialogService, NgxInputFile, NgxLoadingButton, NgxPaginatedSelect, NgxPaginatedSelectBottomSheetComponent, NgxPaginatedTable, NgxTablesIntl, OPERATOR_BY_FILTER_TYPE, PaginatedSearchableSelectComponent, SearchableSelectComponent, USER_ID_FACTORY, base64ToUtf8, includeNoSensible, isFilterOption };
-export type { AdvancedFilter, AlertType, BasicFilter, BasicSelectConfig, BasicTableColumn, BasicTableConfig, ColumnPipe, ConfirmDialogData, DeleteConfirm, FilterConnector, FilterGroup, FilterOperator, FilterOption, FilterRule, FilterType, NgxPaginatedSelectBottomSheetData, PaginatedFilter, PaginatedItems, PaginatedSelectConfig, PaginatedTableColumn, PaginatedTableConfig, RowActionClickEvent, RowActionIconColor, RowSelectionAction, SelectionActionEvent, SortBy, SortType, TableBasicAction, TableRowAction };
+export { DynamicHostDirective, NgxAlert, NgxBasicSelect, NgxBasicTable, NgxConfirmDialogComponent, NgxDialog, NgxDialogService, NgxFileInput, NgxInputFile, NgxLoadingButton, NgxPaginatedSelect, NgxPaginatedSelectBottomSheetComponent, NgxPaginatedTable, NgxSkeleton, NgxTablesIntl, OPERATOR_BY_FILTER_TYPE, PaginatedSearchableSelectComponent, SearchableSelectComponent, USER_ID_FACTORY, base64ToUtf8, includeNoSensible, isFilterOption };
+export type { AdvancedFilter, AlertType, BasicFilter, BasicSelectConfig, BasicTableColumn, BasicTableConfig, ColumnPipe, ConfirmDialogData, DeleteConfirm, FilterConnector, FilterGroup, FilterOperator, FilterOption, FilterRule, FilterType, NgxFileError, NgxFileErrorCode, NgxFileInputVariant, NgxFileItem, NgxPaginatedSelectBottomSheetData, PaginatedFilter, PaginatedItems, PaginatedSelectConfig, PaginatedTableColumn, PaginatedTableConfig, RowActionClickEvent, RowActionIconColor, RowSelectionAction, SelectionActionEvent, SkeletonAnimation, SkeletonVariant, SortBy, SortType, TableBasicAction, TableRowAction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-eiffage-material",
-  "version": "0.0.42",
+  "version": "0.0.43",
   "peerDependencies": {
     "@angular/common": "^20.1.0",
     "@angular/core": "^20.1.0"