@koobiq/components 20.4.2 → 21.0.0

package/{file-upload/index.d.ts → types/koobiq-components-file-upload.d.ts}

@@ -1,8 +1,8 @@
-import * as _koobiq_components_core from '@koobiq/components/core';
-import { KbqBaseFileUploadLocaleConfig, KbqMultipleFileUploadLocaleConfig, KbqEnumValues, CanUpdateErrorState, ErrorStateMatcher, KbqFileUploadLocaleConfig, KbqDefaultSizes } from '@koobiq/components/core';
 import * as _angular_core from '@angular/core';
-import { ElementRef, InjectionToken, InputSignal, ChangeDetectorRef, Renderer2, DestroyRef, AfterViewInit, DoCheck, TemplateRef, OnDestroy } from '@angular/core';
+import { ElementRef, ChangeDetectorRef, Renderer2, DestroyRef, Signal, WritableSignal, OnChanges, AfterViewInit, DoCheck, TemplateRef, SimpleChanges, InjectionToken, OnDestroy, Provider } from '@angular/core';
 import { OverlayRef } from '@angular/cdk/overlay';
+import * as _koobiq_components_core from '@koobiq/components/core';
+import { KbqEnumValues, ErrorStateMatcher, KbqFileUploadLocaleConfiguration, KbqMultipleFileUploadLocaleConfiguration, KbqDefaultSizes, KbqDeepPartial } from '@koobiq/components/core';
 import { KbqEmptyState } from '@koobiq/components/empty-state';
 import * as i1 from '@angular/cdk/a11y';
 import { FocusOrigin } from '@angular/cdk/a11y';
@@ -90,9 +90,13 @@ declare class KbqFileLoader {
     /**
      * Reflects webkitdirectory attribute,
      * which indicates that elements can only select directories instead of files.
-     * @link [`HTMLInputElement: webkitdirectory property`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitdirectory)
+     * See [`HTMLInputElement: webkitdirectory property`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitdirectory).
      */
     readonly onlyDirectory: _angular_core.InputSignal<boolean | null>;
+    /** Ids of the elements describing the file input, written to its `aria-describedby`. */
+    readonly describedBy: _angular_core.InputSignal<string | null>;
+    /** Whether the file input holds a value the form rejects, reported through `aria-invalid`. */
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Event fires when file selected in file-picker. */
     readonly fileChange: _angular_core.OutputEmitterRef<Event>;
     /** Underlying file input element */
@@ -108,7 +112,7 @@ declare class KbqFileLoader {
     /** @docs-private */
     protected readonly innerOnlyDirectory: _angular_core.Signal<boolean | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqFileLoader, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFileLoader, "[kbqFileLoader]", ["kbqFileLoader"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "for": { "alias": "for"; "required": false; "isSignal": true; }; "onlyDirectory": { "alias": "onlyDirectory"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFileLoader, "[kbqFileLoader]", ["kbqFileLoader"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "for": { "alias": "for"; "required": false; "isSignal": true; }; "onlyDirectory": { "alias": "onlyDirectory"; "required": false; "isSignal": true; }; "describedBy": { "alias": "describedBy"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; }, never, ["*"], true, never>;
 }
 /**
  * Responsible for list update (add/remove)
@@ -129,9 +133,12 @@ declare class KbqFileList<T> {
     addArray(items: T[]): void;
     /** Replaces the current list with the specified items and emits event. */
     replace(items: T[]): void;
-    /** Removes every occurrence of the specified item. Returns the removed items. */
+    /** Removes the first occurrence of the specified item. Returns removed items and emits event. */
     remove(item: T): T[];
-    /** Removes item at specified index. Returns removed items and emits event. */
+    /**
+     * Removes item at specified index. Returns removed items and emits event.
+     * An index outside the list removes nothing, emits nothing and leaves the list untouched.
+     */
     removeAt(index: number): T[];
     private update;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqFileList<any>, never>;
@@ -171,18 +178,19 @@ type KbqFileUploadCaptionContext = {
     captionTextSeparator?: string;
     browseLinkFolder?: string;
 };
-declare const KBQ_FILE_UPLOAD_CONFIGURATION: InjectionToken<KbqBaseFileUploadLocaleConfig | KbqMultipleFileUploadLocaleConfig>;
 /** @docs-private */
-declare abstract class KbqFileUploadBase<T = KbqBaseFileUploadLocaleConfig> implements CanUpdateErrorState {
-    protected abstract localeConfig: InputSignal<Partial<T> | undefined>;
-    /** Tracks whether the component is in an error state based on the control, parent form,
-     * and `errorStateMatcher`, triggering visual updates and state changes if needed. */
+declare abstract class KbqFileUploadBase {
+    /**
+     * Tracks whether the component is in an error state based on the control, parent form,
+     * and `errorStateMatcher`, triggering visual updates and state changes if needed.
+     */
     errorState: boolean;
     /** An object used to control the error state of the component. */
     abstract errorStateMatcher: ErrorStateMatcher;
     /**
      * Emits whenever the component state changes and should cause the parent
      * form-field to update. Implemented as part of `KbqFormFieldControl`.
+     *
      * @docs-private
      */
     readonly stateChanges: Subject<void>;
@@ -198,8 +206,10 @@ declare abstract class KbqFileUploadBase<T = KbqBaseFileUploadLocaleConfig> impl
     protected readonly renderer: Renderer2;
     /** @docs-private */
     protected readonly destroyRef: DestroyRef;
-    /** @docs-private */
-    protected readonly localeService: _koobiq_components_core.KbqLocaleService | null;
+    /** Localized labels of both upload flavours, following the active locale. */
+    readonly localeConfiguration: Signal<KbqFileUploadLocaleConfiguration>;
+    /** Accessible names of the icon-only controls the component renders itself. @docs-private */
+    protected readonly a11yNames: Signal<_koobiq_components_core.KbqA11yLocaleConfiguration>;
     /** @docs-private */
     protected readonly ngControl: NgControl | null;
     /** @docs-private */
@@ -212,21 +222,36 @@ declare abstract class KbqFileUploadBase<T = KbqBaseFileUploadLocaleConfig> impl
     protected readonly elementRef: ElementRef<HTMLElement>;
     /** @docs-private */
     protected readonly dropzoneService: KbqFullScreenDropzoneService;
-    /** implemented as part of base class. Decided not use mixinErrorState, not to overcomplicate
-     * @docs-private */
+    /** Text of the live region that announces changes of the file list. @docs-private */
+    protected readonly announcement: WritableSignal<string>;
+    /** Replaced once per list change; an emission sets only the status signal of its item. */
+    private readonly itemStatuses;
+    constructor();
+    /** Whether the item's `loading` subject last emitted `true`. @docs-private */
+    protected isLoading(item: KbqFileItem): boolean;
+    /** What the item's `progress` subject last emitted, `0` until it does. @docs-private */
+    protected uploadProgress(item: KbqFileItem): number;
+    /** @docs-private */
+    protected setFileList(items: KbqFileItem[]): void;
+    /**
+     * Pushes one message into the live region. Cleared first: a live region speaks on a content
+     * change, so removing two identically named files in a row would otherwise stay silent.
+     *
+     * @docs-private
+     */
+    protected announce(...messages: string[]): void;
+    /** @docs-private */
+    protected withFileName(template: string, fileName: string): string;
+    /** @docs-private */
     updateErrorState(): void;
-    /** Merges base configuration with locale-specific overrides. */
-    protected buildConfig<T>(config: T): T;
 }
 
-interface KbqInputFileMultipleLabel extends KbqMultipleFileUploadLocaleConfig {
-    [k: string | number | symbol]: unknown;
-}
-declare const KBQ_MULTIPLE_FILE_UPLOAD_DEFAULT_CONFIGURATION: KbqMultipleFileUploadLocaleConfig;
-declare class KbqMultipleFileUploadComponent extends KbqFileUploadBase implements AfterViewInit, ControlValueAccessor, DoCheck {
+declare const KBQ_MULTIPLE_FILE_UPLOAD_DEFAULT_CONFIGURATION: KbqMultipleFileUploadLocaleConfiguration;
+declare class KbqMultipleFileUploadComponent extends KbqFileUploadBase implements OnChanges, AfterViewInit, ControlValueAccessor, DoCheck {
     /**
      * A value responsible for progress spinner type.
-     * Loading logic depends on selected mode */
+     * Loading logic depends on selected mode
+     */
     readonly progressMode: _angular_core.InputSignal<ProgressSpinnerMode>;
     /** Array of file type specifiers */
     readonly accept: _angular_core.InputSignal<string[] | undefined>;
@@ -237,18 +262,24 @@ declare class KbqMultipleFileUploadComponent extends KbqFileUploadBase implement
     readonly inputId: _angular_core.InputSignal<string>;
     /** An object used to control the error state of the component. */
     errorStateMatcher: ErrorStateMatcher;
+    /**
+     * The selected files.
+     *
+     * Writing it is the model→view direction, same as `writeValue()`: it fills the list and tells
+     * nobody. `cvaOnChange` and `(filesChange)` belong to the paths a user drives — see
+     * `onFileAdded()` and `deleteFile()` — so a `[files]` binding cannot make the form look edited.
+     */
     get files(): KbqFileItem[];
     set files(currentFileList: KbqFileItem[]);
     /**
-     * Determines which kind of items the upload component can accept.
-     * @default mixed
+     * Determines which kind of items the upload component can accept. Defaults to `'file'`.
      */
-    allowed: _angular_core.InputSignal<"file" | "folder" | "mixed">;
+    readonly allowed: _angular_core.InputSignal<"file" | "folder" | "mixed">;
     /**
      * Controls whether to display fullscreen dropzone.
      * Provide configuration object to enable, or undefined to disable.
      */
-    fullScreenDropZone: _angular_core.InputSignal<boolean | Partial<{
+    readonly fullScreenDropZone: _angular_core.InputSignal<boolean | Partial<{
         caption: string;
         size: _koobiq_components_core.KbqDefaultSizes;
         title: string;
@@ -257,17 +288,11 @@ declare class KbqMultipleFileUploadComponent extends KbqFileUploadBase implement
     /**
      * Controls how newly selected/dropped files are merged into the existing list.
      * `concat` accumulates files across interactions, skipping files that duplicate ones already present.
-     * `replace` discards the previous selection, mirroring native input file multiple behavior.
-     * @default concat
+     * `replace` discards the previous selection, mirroring native input file multiple behavior. Defaults to `'concat'`.
      */
     readonly addStrategy: _angular_core.InputSignal<"concat" | "replace">;
-    /** Optional configuration to override default labels with localized text.*/
-    readonly localeConfig: _angular_core.InputSignal<Partial<KbqMultipleFileUploadLocaleConfig> | undefined>;
     /** Emits an event containing an updated file list. */
     readonly filesChange: _angular_core.OutputEmitterRef<KbqFileItem[]>;
-    /** @deprecated Use `filesChange` instead.
-     * Will be removed in next major release (#DS-5229) */
-    readonly fileQueueChanged: _angular_core.OutputEmitterRef<KbqFileItem[]>;
     /**
      * Emits an event containing a chunk of files added to the file list.
      * Useful when handling added files, skipping filtering file list.
@@ -278,23 +303,38 @@ declare class KbqMultipleFileUploadComponent extends KbqFileUploadBase implement
      * Useful when handle removed files, skipping filtering file list.
      */
     readonly fileRemoved: _angular_core.OutputEmitterRef<[KbqFileItem, number]>;
+    /**
+     * Emits the files a selection or a drop discarded — with the default `concat` strategy, the ones
+     * that duplicate a file already in the list. `accept` is not part of this: it only filters the OS
+     * dialog.
+     */
+    readonly rejected: _angular_core.OutputEmitterRef<File[]>;
     /** File Icon Template */
     protected readonly customFileIcon: _angular_core.Signal<TemplateRef<any> | undefined>;
     protected readonly fileLoader: _angular_core.Signal<KbqFileLoader | undefined>;
+    /** The list's scroll viewport. Absent until there is at least one file to list. */
+    private readonly listViewport;
+    /** File count the scrollbar was last revealed for — see the effect in the constructor. */
+    private announcedFileCount;
     /** @docs-private */
     protected readonly hint: _angular_core.Signal<readonly KbqHint[]>;
     /** @docs-private */
-    hasFocus: boolean;
-    /** @docs-private */
-    readonly resolvedLocaleConfig: _angular_core.Signal<KbqMultipleFileUploadLocaleConfig>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    /** Remove controls of the rendered rows, used to keep focus in the list after a deletion. */
+    private readonly fileActions;
     /** @docs-private */
     protected readonly captionContext: _angular_core.Signal<KbqFileUploadCaptionContext>;
-    /** cvaOnChange function registered via registerOnChange (ControlValueAccessor).
+    /**
+     * cvaOnChange function registered via registerOnChange (ControlValueAccessor).
+     *
      * @docs-private
      */
     cvaOnChange: (_: KbqFileItem[]) => void;
-    /** onTouch function registered via registerOnTouch (ControlValueAccessor).
-     * @docs-private */
+    /**
+     * onTouch function registered via registerOnTouch (ControlValueAccessor).
+     *
+     * @docs-private
+     */
     onTouched: () => void;
     /** @docs-private */
     get input(): ElementRef<HTMLInputElement> | undefined;
@@ -305,31 +345,45 @@ declare class KbqMultipleFileUploadComponent extends KbqFileUploadBase implement
     /**
      * Indicates an invalid state based on `errorState`,
      * applying a CSS class in HTML for visual feedback.
+     *
      * @docs-private
      */
     get invalid(): boolean;
     /** @docs-private */
     protected get captionTextWhenSelected(): string;
-    /** @docs-private */
-    readonly configuration: KbqMultipleFileUploadLocaleConfig | null;
-    private readonly localeId;
     private readonly focusMonitor;
     private readonly platformId;
+    /** @docs-private */
+    readonly errorStateMatcherInput: _angular_core.InputSignal<ErrorStateMatcher | undefined>;
+    /** @docs-private */
+    readonly filesInput: _angular_core.InputSignal<KbqFileItem[] | undefined>;
+    ngOnChanges(changes: SimpleChanges): void;
     constructor();
     ngDoCheck(): void;
     ngAfterViewInit(): void;
-    /** Implemented as part of ControlValueAccessor.
-     * @docs-private */
+    /**
+     * Implemented as part of ControlValueAccessor.
+     *
+     * @docs-private
+     */
     writeValue(files: FileList | KbqFileItem[] | null): void;
-    /** Implemented as part of ControlValueAccessor.
-     * @docs-private */
+    /**
+     * Implemented as part of ControlValueAccessor.
+     *
+     * @docs-private
+     */
     registerOnChange(fn: any): void;
-    /** Implemented as part of ControlValueAccessor.
-     * @docs-private */
+    /**
+     * 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;
@@ -338,63 +392,85 @@ declare class KbqMultipleFileUploadComponent extends KbqFileUploadBase implement
     /** @docs-private */
     onFileDropped(files: KbqFile[]): void;
     /** @docs-private */
-    deleteFile(index: number, event?: MouseEvent, origin?: FocusOrigin): void;
+    deleteFile(index: number, event?: Event, origin?: FocusOrigin): void;
+    /** Body of `deleteFile()`. */
+    private removeFile;
+    /**
+     * Marks the control touched once focus leaves the whole uploader, so the default
+     * `ErrorStateMatcher` shows a `required` error to a user who tabbed through without attaching
+     * anything. Moving between the browse link and a remove control stays inside and does not count.
+     *
+     * @docs-private
+     */
+    protected onFocusOut({ relatedTarget }: FocusEvent): void;
     private mapToFileItem;
     private onFileAdded;
     private isDuplicate;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqMultipleFileUploadComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqMultipleFileUploadComponent, "kbq-multiple-file-upload,kbq-file-upload[multiple]", never, { "progressMode": { "alias": "progressMode"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; "files": { "alias": "files"; "required": false; }; "allowed": { "alias": "allowed"; "required": false; "isSignal": true; }; "fullScreenDropZone": { "alias": "fullScreenDropZone"; "required": false; "isSignal": true; }; "addStrategy": { "alias": "addStrategy"; "required": false; "isSignal": true; }; "localeConfig": { "alias": "localeConfig"; "required": false; "isSignal": true; }; }, { "filesChange": "filesChange"; "fileQueueChanged": "fileQueueChanged"; "filesAdded": "filesAdded"; "fileRemoved": "fileRemoved"; }, ["customFileIcon", "hint"], ["kbq-hint"], true, [{ directive: typeof KbqFileUploadContext; inputs: { "id": "id"; "disabled": "disabled"; }; outputs: {}; }, { directive: typeof KbqFileList; inputs: {}; outputs: { "itemsAdded": "itemsAdded"; "itemRemoved": "itemRemoved"; }; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqMultipleFileUploadComponent, "kbq-multiple-file-upload,kbq-file-upload[multiple]", never, { "progressMode": { "alias": "progressMode"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "allowed": { "alias": "allowed"; "required": false; "isSignal": true; }; "fullScreenDropZone": { "alias": "fullScreenDropZone"; "required": false; "isSignal": true; }; "addStrategy": { "alias": "addStrategy"; "required": false; "isSignal": true; }; "errorStateMatcherInput": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; "filesInput": { "alias": "files"; "required": false; "isSignal": true; }; }, { "filesChange": "filesChange"; "filesAdded": "filesAdded"; "fileRemoved": "fileRemoved"; "rejected": "rejected"; }, ["customFileIcon", "hint"], ["kbq-hint"], true, [{ directive: typeof _koobiq_components_core.KbqLocaleOverridesDirective; inputs: { "kbqLocaleOverrides": "localeOverrides"; }; outputs: {}; }, { directive: typeof KbqFileUploadContext; inputs: { "id": "id"; "disabled": "disabled"; }; outputs: {}; }, { directive: typeof KbqFileList; inputs: {}; outputs: { "itemsAdded": "itemsAdded"; "itemRemoved": "itemRemoved"; }; }]>;
 }
 
-declare const KBQ_SINGLE_FILE_UPLOAD_DEFAULT_CONFIGURATION: KbqFileUploadLocaleConfig['single'];
-declare class KbqSingleFileUploadComponent extends KbqFileUploadBase implements AfterViewInit, ControlValueAccessor, DoCheck {
+declare const KBQ_SINGLE_FILE_UPLOAD_DEFAULT_CONFIGURATION: KbqFileUploadLocaleConfiguration['single'];
+declare class KbqSingleFileUploadComponent extends KbqFileUploadBase implements OnChanges, AfterViewInit, ControlValueAccessor, DoCheck {
     /**
      * A value responsible for progress spinner type.
-     * Loading logic depends on selected mode */
+     * Loading logic depends on selected mode
+     */
     readonly progressMode: _angular_core.InputSignal<ProgressSpinnerMode>;
     /** Array of file type specifiers */
     readonly accept: _angular_core.InputSignal<string[] | undefined>;
     readonly inputId: _angular_core.InputSignal<string>;
     /** An object used to control the error state of the component. */
     errorStateMatcher: ErrorStateMatcher;
+    /**
+     * The selected file, or `null`.
+     *
+     * Writing it is the model→view direction, same as `writeValue()`: it fills the list and tells
+     * nobody. `cvaOnChange` and `(fileChange)` belong to the paths a user drives — see `addFile()`
+     * and `deleteItem()` — so a `[file]` binding cannot make the form look edited.
+     */
     get file(): KbqFileItem | null;
     set file(currentFile: KbqFileItem | null);
     /**
-     * Controls whether to display the file size information.
-     * @default true
+     * Controls whether to display the file size information. Defaults to `true`.
      */
     readonly showFileSize: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
-     * Determines which kind of items the upload component can accept.
-     * @default mixed
+     * Determines which kind of items the upload component can accept. Defaults to `'file'`.
      */
-    allowed: _angular_core.InputSignal<"file" | "folder" | "mixed">;
+    readonly allowed: _angular_core.InputSignal<"file" | "folder" | "mixed">;
     /**
      * Controls whether to display fullscreen dropzone.
      * Provide configuration object to enable, or undefined to disable.
      */
-    fullScreenDropZone: _angular_core.InputSignal<boolean | Partial<{
+    readonly fullScreenDropZone: _angular_core.InputSignal<boolean | Partial<{
         caption: string;
         size: _koobiq_components_core.KbqDefaultSizes;
         title: string;
         autoCapture: boolean;
     }> | undefined>;
-    /** Optional configuration to override default labels with localized text.*/
-    readonly localeConfig: _angular_core.InputSignal<Partial<KbqBaseFileUploadLocaleConfig> | undefined>;
     /** Emits an event containing an updated file. */
     readonly fileChange: _angular_core.OutputEmitterRef<KbqFileItem | null>;
-    /** @deprecated Use `fileChange` instead.
-     * Will be removed in next major release (#DS-5229) */
-    readonly fileQueueChange: _angular_core.OutputEmitterRef<KbqFileItem | null>;
+    /**
+     * Emits the files a selection or a drop discarded: everything past the first one, since the
+     * component holds a single file. `accept` is not part of this — it only filters the OS dialog.
+     */
+    readonly rejected: _angular_core.OutputEmitterRef<File[]>;
     /** @docs-private */
     protected readonly fileLoader: _angular_core.Signal<KbqFileLoader>;
     /** @docs-private */
-    private readonly hint;
-    /** cvaOnChange function registered via registerOnChange (ControlValueAccessor).
+    protected readonly hint: _angular_core.Signal<readonly KbqHint[]>;
+    /** @docs-private */
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    /**
+     * cvaOnChange function registered via registerOnChange (ControlValueAccessor).
+     *
      * @docs-private
      */
     cvaOnChange: (_: KbqFileItem | null) => void;
-    /** onTouch function registered via registerOnTouch (ControlValueAccessor).
+    /**
+     * onTouch function registered via registerOnTouch (ControlValueAccessor).
+     *
      * @docs-private
      */
     onTouched: () => void;
@@ -407,33 +483,46 @@ declare class KbqSingleFileUploadComponent extends KbqFileUploadBase implements
     /**
      * Indicates an invalid state based on file errors or `errorState`,
      * applying a CSS class in HTML for visual feedback.
+     *
      * @docs-private
      */
     get invalid(): boolean;
     /** @docs-private */
-    readonly configuration: KbqBaseFileUploadLocaleConfig | null;
-    /** @docs-private */
     protected readonly captionContext: _angular_core.Signal<KbqFileUploadCaptionContext>;
-    private readonly localeId;
-    /** @docs-private */
-    readonly resolvedLocaleConfig: _angular_core.Signal<KbqBaseFileUploadLocaleConfig>;
     private readonly focusMonitor;
+    private readonly injector;
     private readonly platformId;
+    /** @docs-private */
+    readonly errorStateMatcherInput: _angular_core.InputSignal<ErrorStateMatcher | undefined>;
+    /** @docs-private */
+    readonly fileInput: _angular_core.InputSignal<KbqFileItem | null | undefined>;
+    ngOnChanges(changes: SimpleChanges): void;
     constructor();
     ngDoCheck(): void;
     ngAfterViewInit(): void;
-    /** Implemented as part of ControlValueAccessor.
-     * @docs-private */
+    /**
+     * Implemented as part of ControlValueAccessor.
+     *
+     * @docs-private
+     */
     writeValue(file: File | KbqFileItem | null): void;
-    /** Implemented as part of ControlValueAccessor.
-     * @docs-private */
+    /**
+     * Implemented as part of ControlValueAccessor.
+     *
+     * @docs-private
+     */
     registerOnChange(fn: any): void;
-    /** Implemented as part of ControlValueAccessor.
-     * @docs-private */
+    /**
+     * 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;
@@ -442,10 +531,22 @@ declare class KbqSingleFileUploadComponent extends KbqFileUploadBase implements
     /** @docs-private */
     onFileDropped(files: KbqFile[]): void;
     /** @docs-private */
-    deleteItem(event?: MouseEvent, origin?: FocusOrigin): void;
+    deleteItem(event?: Event, origin?: FocusOrigin): void;
+    /** Body of `deleteItem()`. */
+    private removeFile;
+    /**
+     * Marks the control touched once focus leaves the whole uploader, so the default
+     * `ErrorStateMatcher` shows a `required` error to a user who tabbed through without attaching
+     * anything. Moving between the browse link and the remove control stays inside and does not count.
+     *
+     * @docs-private
+     */
+    protected onFocusOut({ relatedTarget }: FocusEvent): void;
+    /** Keeps the first file — the component holds one — and reports the rest as rejected. */
+    private addFile;
     private mapToFileItem;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqSingleFileUploadComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqSingleFileUploadComponent, "kbq-single-file-upload,kbq-file-upload:not([multiple])", never, { "progressMode": { "alias": "progressMode"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; "file": { "alias": "file"; "required": false; }; "showFileSize": { "alias": "showFileSize"; "required": false; "isSignal": true; }; "allowed": { "alias": "allowed"; "required": false; "isSignal": true; }; "fullScreenDropZone": { "alias": "fullScreenDropZone"; "required": false; "isSignal": true; }; "localeConfig": { "alias": "localeConfig"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; "fileQueueChange": "fileQueueChange"; }, ["hint"], ["[kbq-icon]", "kbq-hint"], true, [{ directive: typeof KbqFileUploadContext; inputs: { "id": "id"; "disabled": "disabled"; "multiple": "multiple"; }; outputs: {}; }, { directive: typeof KbqFileList; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqSingleFileUploadComponent, "kbq-single-file-upload,kbq-file-upload:not([multiple])", never, { "progressMode": { "alias": "progressMode"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "showFileSize": { "alias": "showFileSize"; "required": false; "isSignal": true; }; "allowed": { "alias": "allowed"; "required": false; "isSignal": true; }; "fullScreenDropZone": { "alias": "fullScreenDropZone"; "required": false; "isSignal": true; }; "errorStateMatcherInput": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; "fileInput": { "alias": "file"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; "rejected": "rejected"; }, ["hint"], ["[kbq-icon]", "kbq-hint"], true, [{ directive: typeof _koobiq_components_core.KbqLocaleOverridesDirective; inputs: { "kbqLocaleOverrides": "localeOverrides"; }; outputs: {}; }, { directive: typeof KbqFileUploadContext; inputs: { "id": "id"; "disabled": "disabled"; }; outputs: {}; }, { directive: typeof KbqFileList; inputs: {}; outputs: {}; }]>;
 }
 
 /** Dropzone overlay content configuration. */
@@ -470,17 +571,6 @@ declare const KBQ_DROPZONE_DATA: InjectionToken<Partial<{
     /** Whether focus should be automatically captured when the overlay opens. */
     autoCapture: boolean;
 }>>;
-/**
- * Determines if a mouse event occurred outside the viewport boundaries.
- * @docs-private
- */
-declare const isOutsideViewport: ({ event, innerWidth, innerHeight, xAxisMinThreshold, yAxisMinThreshold }: {
-    event: MouseEvent;
-    innerWidth: number;
-    innerHeight: number;
-    xAxisMinThreshold: number;
-    yAxisMinThreshold: number;
-}) => boolean;
 /**
  * Service that provides full-screen drag-and-drop overlay functionality.
  */
@@ -491,11 +581,13 @@ declare class KbqFullScreenDropzoneService extends KbqDrop implements OnDestroy
     private readonly window;
     private readonly injector;
     private readonly ngZone;
+    private readonly animationsDisabled;
     private overlayRef?;
     constructor();
     ngOnDestroy(): void;
     /**
      * Initializes drag-and-drop event listeners on the document body.
+     *
      * @param config - Dropzone configuration
      */
     init(config?: KbqDropzoneData): void;
@@ -503,6 +595,7 @@ declare class KbqFullScreenDropzoneService extends KbqDrop implements OnDestroy
     stop(): void;
     /**
      * Opens the dropzone overlay.
+     *
      * @param config - Dropzone configuration
      */
     open(config?: KbqDropzoneData): void;
@@ -512,7 +605,10 @@ declare class KbqFullScreenDropzoneService extends KbqDrop implements OnDestroy
     onDrop(event: DragEvent): void;
     /** @docs-private */
     protected createOverlay(): OverlayRef;
-    /** @see https://bugs.webkit.org/show_bug.cgi?id=66547 */
+    /**
+     * Closes the overlay once the drag leaves the page. Safari reports a drag event with no `relatedTarget`
+     * ([WebKit bug 66547](https://bugs.webkit.org/show_bug.cgi?id=66547)), so there the pointer position decides.
+     */
     private onDragLeave;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqFullScreenDropzoneService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<KbqFullScreenDropzoneService>;
@@ -532,6 +628,7 @@ declare class KbqLocalDropzone extends KbqDrop {
     private readonly injector;
     private readonly ngZone;
     private readonly destroyRef;
+    private readonly animationsDisabled;
     private overlayRef?;
     constructor();
     /** Opens the dropzone overlay positioned over the host element. */
@@ -554,18 +651,20 @@ declare class KbqLocalDropzone extends KbqDrop {
 /** Component that displays an empty state for file upload areas. */
 declare class KbqFileUploadEmptyState extends KbqEmptyState {
     /** Title text to display below the upload icon */
-    title: _angular_core.InputSignal<string | undefined>;
+    readonly title: _angular_core.InputSignal<string | undefined>;
     /** Caption text or template to display below the title */
-    caption: _angular_core.InputSignal<string | TemplateRef<any> | undefined>;
-    constructor();
+    readonly caption: _angular_core.InputSignal<string | TemplateRef<unknown> | undefined>;
+    /**
+     * Same input as `KbqEmptyState.size`, redeclared only to default to `big` instead of `normal`.
+     * It used to be a `super()`-time assignment, which an `input()` cannot take.
+     */
+    readonly size: _angular_core.InputSignal<KbqDefaultSizes>;
     /** @docs-private */
-    protected isTemplateRef(value: string | TemplateRef<any>): value is TemplateRef<any>;
+    protected isTemplateRef(value: string | TemplateRef<unknown>): value is TemplateRef<unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqFileUploadEmptyState, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFileUploadEmptyState, "kbq-file-upload-empty-state", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFileUploadEmptyState, "kbq-file-upload-empty-state", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 declare class KbqDropzoneContent {
-    /** @docs-private */
-    protected readonly localeService: _koobiq_components_core.KbqLocaleService | null;
     /** @docs-private */
     protected readonly config: Partial<{
         /** Optional caption text displayed below the title. */
@@ -578,19 +677,27 @@ declare class KbqDropzoneContent {
         autoCapture: boolean;
     }> | null;
     private readonly trapFocus;
-    private readonly localeId;
+    private readonly localeConfiguration;
     constructor();
     /** @docs-private */
-    protected readonly title: _angular_core.Signal<any>;
+    protected readonly title: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqDropzoneContent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqDropzoneContent, "kbq-dropzone-content", never, {}, {}, never, never, true, [{ directive: typeof i1.CdkTrapFocus; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqDropzoneContent, "kbq-dropzone-content", never, {}, {}, never, never, true, [{ directive: typeof i1.CdkTrapFocus; inputs: {}; outputs: {}; }, { directive: typeof _koobiq_components_core.KbqLocaleOverridesDirective; inputs: {}; outputs: {}; }]>;
 }
 
 declare class KbqFileUploadModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqFileUploadModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqFileUploadModule, never, [typeof i1$1.FormsModule, typeof i1$1.ReactiveFormsModule, typeof i2.KbqToolTipModule, typeof i3.KbqProgressSpinnerModule, typeof i4.KbqIconModule, typeof i5.KbqButtonModule, typeof i6.KbqListModule, typeof i7.KbqFormFieldModule, typeof i8.KbqEllipsisCenterModule, typeof _koobiq_components_core.KbqDataSizePipe, typeof i10.KbqLinkModule, typeof i11.AsyncPipe, typeof i11.NgTemplateOutlet, typeof KbqFileDropDirective, typeof KbqSingleFileUploadComponent, typeof KbqMultipleFileUploadComponent], [typeof KbqSingleFileUploadComponent, typeof KbqMultipleFileUploadComponent, typeof KbqFileDropDirective]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqFileUploadModule, never, [typeof i1$1.FormsModule, typeof i1$1.ReactiveFormsModule, typeof i2.KbqToolTipModule, typeof i3.KbqProgressSpinnerModule, typeof i4.KbqIconModule, typeof i5.KbqButtonModule, typeof i6.KbqListModule, typeof i7.KbqFormFieldModule, typeof i8.KbqEllipsisCenterModule, typeof _koobiq_components_core.KbqDataSizePipe, typeof i10.KbqLink, typeof i11.NgTemplateOutlet, typeof KbqFileDropDirective, typeof KbqSingleFileUploadComponent, typeof KbqMultipleFileUploadComponent], [typeof KbqSingleFileUploadComponent, typeof KbqMultipleFileUploadComponent, typeof KbqFileDropDirective]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<KbqFileUploadModule>;
 }
 
-export { KBQ_DROPZONE_DATA, KBQ_FILE_UPLOAD_CONFIGURATION, KBQ_MULTIPLE_FILE_UPLOAD_DEFAULT_CONFIGURATION, KBQ_SINGLE_FILE_UPLOAD_DEFAULT_CONFIGURATION, KbqDrop, KbqDropzoneContent, KbqFileDropDirective, KbqFileList, KbqFileLoader, KbqFileUploadAddStrategy, KbqFileUploadAllowedType, KbqFileUploadBase, KbqFileUploadContext, KbqFileUploadEmptyState, KbqFileUploadModule, KbqFullScreenDropzoneService, KbqLocalDropzone, KbqMultipleFileUploadComponent, KbqSingleFileUploadComponent, isOutsideViewport };
-export type { KbqDropzoneData, KbqFile, KbqFileItem, KbqFileUploadAddStrategyValues, KbqFileUploadAllowedTypeValues, KbqFileUploadCaptionContext, KbqInputFileMultipleLabel };
+/** Localization configuration provider for the labels the file upload components render themselves. */
+declare const KBQ_FILE_UPLOAD_LOCALE_CONFIGURATION: InjectionToken<KbqFileUploadLocaleConfiguration>;
+/**
+ * Utility provider of {@link KBQ_FILE_UPLOAD_LOCALE_CONFIGURATION}. Only the labels you pass are overridden;
+ * the rest keep following the active locale.
+ */
+declare const kbqFileUploadLocaleConfigurationProvider: (configuration: KbqDeepPartial<KbqFileUploadLocaleConfiguration>) => Provider;
+
+export { KBQ_DROPZONE_DATA, KBQ_FILE_UPLOAD_LOCALE_CONFIGURATION, KBQ_MULTIPLE_FILE_UPLOAD_DEFAULT_CONFIGURATION, KBQ_SINGLE_FILE_UPLOAD_DEFAULT_CONFIGURATION, KbqDrop, KbqDropzoneContent, KbqFileDropDirective, KbqFileList, KbqFileLoader, KbqFileUploadAddStrategy, KbqFileUploadAllowedType, KbqFileUploadBase, KbqFileUploadContext, KbqFileUploadEmptyState, KbqFileUploadModule, KbqFullScreenDropzoneService, KbqLocalDropzone, KbqMultipleFileUploadComponent, KbqSingleFileUploadComponent, kbqFileUploadLocaleConfigurationProvider };
+export type { KbqDropzoneData, KbqFile, KbqFileItem, KbqFileUploadAddStrategyValues, KbqFileUploadAllowedTypeValues, KbqFileUploadCaptionContext };