@ptsecurity/mosaic 17.2.12 → 17.2.14

package/file-upload/multiple-file-upload.component.d.ts

@@ -1,6 +1,6 @@
-import { ChangeDetectorRef, ElementRef, EventEmitter, OnDestroy, Renderer2, TemplateRef } from '@angular/core';
-import { CanDisable, McLocaleService } from '@ptsecurity/mosaic/core';
-import { McFile, McFileItem, McFileValidatorFn, McInputFile, McInputFileLabel } from './file-upload';
+import { AfterViewInit, DoCheck, ElementRef, EventEmitter, QueryList, TemplateRef } from '@angular/core';
+import { CanDisable, CanUpdateErrorState, ErrorStateMatcher } from '@ptsecurity/mosaic/core';
+import { McFile, McFileItem, McFileUploadBase, McFileValidatorFn, McInputFile, McInputFileLabel } from './file-upload';
 import * as i0 from "@angular/core";
 export interface McInputFileMultipleLabel extends McInputFileLabel {
     captionTextWhenSelected: string;
@@ -12,21 +12,37 @@ export interface McInputFileMultipleLabel extends McInputFileLabel {
     [k: string | number | symbol]: unknown;
 }
 export declare const MC_MULTIPLE_FILE_UPLOAD_DEFAULT_CONFIGURATION: McInputFileMultipleLabel;
-export declare class McMultipleFileUploadComponent implements McInputFile, CanDisable, OnDestroy {
-    private renderer;
-    private cdr;
+export declare class McMultipleFileUploadComponent extends McFileUploadBase implements AfterViewInit, DoCheck, McInputFile, CanDisable, CanUpdateErrorState {
     readonly configuration: McInputFileMultipleLabel;
-    private localeService?;
     accept?: string[];
     disabled: boolean;
     errors: string[];
-    files: McFileItem[];
     size: 'compact' | 'default';
+    /**
+     * custom ID for the file input element.
+     */
     inputId: string;
+    /**
+     * @deprecated use `FormControl.errors`
+     */
     customValidation?: McFileValidatorFn[];
+    /** An object used to control the error state of the component. */
+    errorStateMatcher: ErrorStateMatcher;
+    get files(): McFileItem[];
+    set files(currentFileList: McFileItem[]);
+    private _files;
     fileQueueChanged: EventEmitter<McFileItem[]>;
+    /**
+     * Emits an event containing a chunk of files added to the file list.
+     */
+    filesAdded: EventEmitter<McFileItem[]>;
+    /**
+     * Emits an event containing a file and file's index when removed from the file list.
+     */
+    fileRemoved: EventEmitter<[McFileItem, number]>;
     customFileIcon: TemplateRef<HTMLElement>;
     input: ElementRef<HTMLInputElement>;
+    readonly hint: QueryList<TemplateRef<any>>;
     columnDefs: {
         header: string;
         cssClass: string;
@@ -36,10 +52,35 @@ export declare class McMultipleFileUploadComponent implements McInputFile, CanDi
     separatedCaptionTextWhenSelected: string[];
     separatedCaptionTextForCompactSize: string[];
     get acceptedFiles(): string;
+    /**
+     * @deprecated use `FormControl.errors`
+     */
     get hasErrors(): boolean;
-    private localeSubscription;
-    constructor(renderer: Renderer2, cdr: ChangeDetectorRef, configuration: McInputFileMultipleLabel, localeService?: McLocaleService | undefined);
-    ngOnDestroy(): void;
+    get hasHint(): boolean;
+    /**
+     * Indicates an invalid state based on file errors or `errorState`,
+     * applying a CSS class in HTML for visual feedback.
+     */
+    get invalid(): boolean;
+    constructor(configuration: McInputFileMultipleLabel);
+    ngAfterViewInit(): void;
+    ngDoCheck(): void;
+    /** cvaOnChange function registered via registerOnChange (ControlValueAccessor). @docs-private */
+    cvaOnChange: (_: McFileItem[]) => void;
+    /** onTouch function registered via registerOnTouch (ControlValueAccessor). @docs-private */
+    onTouched: () => void;
+    /** Implemented as part of ControlValueAccessor. @docs-private */
+    writeValue(files: FileList | McFileItem[] | null): void;
+    /** Implemented as part of ControlValueAccessor. @docs-private */
+    registerOnChange(fn: any): void;
+    /** Implemented as part of ControlValueAccessor. @docs-private */
+    registerOnTouched(fn: any): void;
+    /**
+     * Sets the disabled state of the control. Implemented as a part of ControlValueAccessor.
+     * @param isDisabled Whether the control should be disabled.
+     * @docs-private
+     */
+    setDisabledState(isDisabled: boolean): void;
     onFileSelectedViaClick({ target }: Event): void;
     onFileDropped(files: FileList | McFile[]): void;
     deleteFile(index: number, event?: MouseEvent): void;
@@ -50,6 +91,6 @@ export declare class McMultipleFileUploadComponent implements McInputFile, CanDi
     private isCorrectExtension;
     private initDefaultParams;
     private makeCaptionText;
-    static ɵfac: i0.ɵɵFactoryDeclaration<McMultipleFileUploadComponent, [null, null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<McMultipleFileUploadComponent, "mc-multiple-file-upload", never, { "accept": { "alias": "accept"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "errors": { "alias": "errors"; "required": false; }; "files": { "alias": "files"; "required": false; }; "size": { "alias": "size"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "customValidation": { "alias": "customValidation"; "required": false; }; }, { "fileQueueChanged": "fileQueueChanged"; }, ["customFileIcon"], ["[hint]"], false, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<McMultipleFileUploadComponent, [{ optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<McMultipleFileUploadComponent, "mc-multiple-file-upload", never, { "accept": { "alias": "accept"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "errors": { "alias": "errors"; "required": false; }; "size": { "alias": "size"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "customValidation": { "alias": "customValidation"; "required": false; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; "files": { "alias": "files"; "required": false; }; }, { "fileQueueChanged": "fileQueueChanged"; "filesAdded": "filesAdded"; "fileRemoved": "fileRemoved"; }, ["customFileIcon", "hint"], ["mc-hint,[hint]"], false, never>;
 }

package/file-upload/multiple-file-upload.component.scss

@@ -142,11 +142,3 @@ $vertical-padding-item: mc-css-variable(file-upload-size-multiple-uploaded-item-
         height: 100%;
     }
 }
-
-.mc-hint {
-    display: block;
-}
-
-.mc-file-upload__hint {
-    margin-top: mc-css-variable(form-field-hint-size-margin-top);
-}

package/file-upload/single-file-upload.component.d.ts

@@ -1,27 +1,62 @@
-import { ChangeDetectorRef, ElementRef, EventEmitter, OnDestroy, Renderer2 } from '@angular/core';
-import { CanDisable, McLocaleService } from '@ptsecurity/mosaic/core';
-import { McFile, McFileItem, McFileValidatorFn, McInputFile, McInputFileLabel } from './file-upload';
+import { DoCheck, ElementRef, EventEmitter } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { CanDisable, ErrorStateMatcher } from '@ptsecurity/mosaic/core';
+import { McFile, McFileItem, McFileUploadBase, McFileValidatorFn, McInputFile, McInputFileLabel } from './file-upload';
 import * as i0 from "@angular/core";
 export declare const MC_SINGLE_FILE_UPLOAD_DEFAULT_CONFIGURATION: McInputFileLabel;
-export declare class McSingleFileUploadComponent implements McInputFile, CanDisable, OnDestroy {
-    private renderer;
-    private cdr;
+export declare class McSingleFileUploadComponent extends McFileUploadBase implements McInputFile, CanDisable, DoCheck, ControlValueAccessor {
     readonly configuration: McInputFileLabel;
-    private localeService?;
+    get file(): McFileItem | null;
+    set file(currentFile: McFileItem | null);
+    private _file;
+    get acceptedFiles(): string;
+    get hasHint(): boolean;
+    /**
+     * Indicates an invalid state based on `errorState`,
+     * applying a CSS class in HTML for visual feedback.
+     */
+    get invalid(): boolean;
     accept: string[];
     disabled: boolean;
+    /**
+     * @deprecated use `FormControl.errors`
+     */
     errors: string[];
-    files: McFileItem[];
     inputId: string;
+    /**
+     * @deprecated use FormControl for validation
+     */
     customValidation?: McFileValidatorFn[];
+    /** An object used to control the error state of the component. */
+    errorStateMatcher: ErrorStateMatcher;
     fileQueueChanged: EventEmitter<McFileItem | null>;
     input: ElementRef<HTMLInputElement>;
-    get acceptedFiles(): string;
     config: McInputFileLabel;
     separatedCaptionText: string[];
-    private localeSubscription;
-    constructor(renderer: Renderer2, cdr: ChangeDetectorRef, configuration: McInputFileLabel, localeService?: McLocaleService | undefined);
-    ngOnDestroy(): void;
+    private readonly hint;
+    constructor(configuration: McInputFileLabel);
+    /** cvaOnChange function registered via registerOnChange (ControlValueAccessor).
+     * @docs-private
+     */
+    cvaOnChange: (_: McFileItem | null) => void;
+    /** onTouch function registered via registerOnTouch (ControlValueAccessor).
+     * @docs-private
+     */
+    onTouched: () => void;
+    ngAfterViewInit(): void;
+    ngDoCheck(): void;
+    /** Implemented as part of ControlValueAccessor. @docs-private */
+    writeValue(file: File | McFileItem | null): void;
+    /** Implemented as part of ControlValueAccessor. @docs-private */
+    registerOnChange(fn: any): void;
+    /** Implemented as part of ControlValueAccessor. @docs-private */
+    registerOnTouched(fn: any): void;
+    /**
+     * Sets the disabled state of the control. Implemented as a part of ControlValueAccessor.
+     * @param isDisabled Whether the control should be disabled.
+     * @docs-private
+     */
+    setDisabledState(isDisabled: boolean): void;
     onFileSelectedViaClick({ target }: Event): void;
     deleteItem(event?: MouseEvent): void;
     onFileDropped(files: FileList | McFile[]): void;
@@ -31,6 +66,6 @@ export declare class McSingleFileUploadComponent implements McInputFile, CanDisa
     private updateLocaleParams;
     private initDefaultParams;
     private makeCaptionText;
-    static ɵfac: i0.ɵɵFactoryDeclaration<McSingleFileUploadComponent, [null, null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<McSingleFileUploadComponent, "mc-single-file-upload", never, { "accept": { "alias": "accept"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "errors": { "alias": "errors"; "required": false; }; "files": { "alias": "files"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "customValidation": { "alias": "customValidation"; "required": false; }; }, { "fileQueueChanged": "fileQueueChanged"; }, never, ["[hint]", "[mc-icon]"], false, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<McSingleFileUploadComponent, [{ optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<McSingleFileUploadComponent, "mc-single-file-upload", never, { "file": { "alias": "file"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "errors": { "alias": "errors"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "customValidation": { "alias": "customValidation"; "required": false; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; }, { "fileQueueChanged": "fileQueueChanged"; }, ["hint"], ["mc-hint,[hint]", "[mc-icon]"], false, never>;
 }

package/file-upload/single-file-upload.component.scss

@@ -41,11 +41,3 @@ $tokens: meta.module-variables(tokens) !default;
         }
     }
 }
-
-.mc-hint {
-    display: block;
-}
-
-.mc-file-upload__hint {
-    margin-top: mc-css-variable(form-field-hint-size-margin-top);
-}

package/form-field/form-field.d.ts

@@ -59,7 +59,7 @@ export declare class McFormField extends McFormFieldMixinBase implements AfterCo
     /** Determines whether a class from the NgControl should be forwarded to the host element. */
     shouldForward(prop: keyof NgControl): boolean;
     ngOnDestroy(): void;
-    runFocusMonitor(): void;
+    runFocusMonitor: () => void;
     stopFocusMonitor(): void;
     /** Throws an error if the form field's control is missing. */
     protected validateControlChild(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ptsecurity/mosaic",
-    "version": "17.2.12",
+    "version": "17.2.14",
     "description": "Mosaic",
     "repository": {
         "type": "git",
@@ -19,9 +19,9 @@
     "peerDependencies": {
         "@angular/cdk": "^17.2.0",
         "@angular/forms": "^17.2.0",
-        "@ptsecurity/cdk": "^17.2.12",
-        "@ptsecurity/mosaic-moment-adapter": "^17.2.12",
-        "@ptsecurity/mosaic-luxon-adapter": "^17.2.12",
+        "@ptsecurity/cdk": "^17.2.14",
+        "@ptsecurity/mosaic-moment-adapter": "^17.2.14",
+        "@ptsecurity/mosaic-luxon-adapter": "^17.2.14",
         "@mosaic-design/date-formatter": "^2.1.7",
         "@ptsecurity/mosaic-icons": "^7.0.8",
         "@mosaic-design/tokens-builder": "^3.1.0",