@acorex/cdk 21.0.2-next.29 → 21.0.2-next.30

package/{uploader/index.d.ts → types/acorex-cdk-uploader.d.ts}

@@ -1,44 +1,47 @@
 import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, TemplateRef } from '@angular/core';
 import { AXEvent } from '@acorex/cdk/common';
-import { AXValidationRuleResult } from '@acorex/core/validation';
 import * as rxjs from 'rxjs';
 import { Subject, BehaviorSubject } from 'rxjs';
 
 /**
- * Triggers the nearest {@link AXUploaderZoneDirective} file dialog on click.
- * Resolves the zone via DI when possible, otherwise walks the DOM (supports content projection).
+ * A directive that provides browse functionality for file uploads.
+ * When applied to an element, clicking it will trigger the file browser dialog.
  * @category Directives
  */
 declare class AXUploaderBrowseDirective implements OnInit, OnDestroy {
-    private readonly elementRef;
-    private readonly platformID;
-    /** When browse + zone share the same host element. */
-    private readonly zoneFromInjector;
-    private readonly onClick;
+    /**
+     * The uploader zone directive instance.
+     * @ignore
+     */
+    private uploaderZone;
+    /**
+     * The element reference for the directive host.
+     * @ignore
+     */
+    private elementRef;
+    /**
+     * Platform ID for browser detection.
+     * @ignore
+     */
+    private platformID;
+    /**
+     * Initializes the directive by adding click event listener and data attribute.
+     */
     ngOnInit(): void;
+    /**
+     * Cleans up the directive by removing event listeners.
+     */
     ngOnDestroy(): void;
-    private resolveZone;
+    /**
+     * Handles the click event to trigger file browser.
+     * @private
+     */
     private handleClick;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXUploaderBrowseDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXUploaderBrowseDirective, "[axUploaderBrowseHandle]", never, {}, {}, never, never, true, never>;
 }
 
-interface AXUploaderChooseFilesResult {
-    accepted: File[];
-    rejected: {
-        file: File;
-        errors: AXValidationRuleResult[];
-    }[];
-}
-interface AXUploaderFileChangeEvent {
-    event: Event;
-    files: File[];
-    rejected?: {
-        file: File;
-        errors: AXValidationRuleResult[];
-    }[];
-}
 type AXUploadStatus = 'new' | 'inprogress' | 'completed' | 'failed' | 'canceled';
 interface AXUploaderChangedEvent extends AXEvent {
     requests: AXUploadRequest[];
@@ -116,11 +119,6 @@ declare class AXUploaderZoneDirective implements OnDestroy {
      * @defaultValue null
      */
     accept: _angular_core.InputSignal<string>;
-    /**
-     * Logical file type name from {@link AXFileService} (e.g. `conversation-image`).
-     * Required for browse handles and validated selection.
-     */
-    fileType: _angular_core.InputSignal<string>;
     /**
      * Custom template for the drag overlay. If provided, this will be used instead of the default overlay.
      */
@@ -179,7 +177,10 @@ declare class AXUploaderZoneDirective implements OnDestroy {
      * Emitted when files are selected or dropped (like HTML file input).
      * Emits an event with files property containing the selected files.
      */
-    fileChange: _angular_core.OutputEmitterRef<AXUploaderFileChangeEvent>;
+    fileChange: _angular_core.OutputEmitterRef<{
+        event: Event;
+        files: File[];
+    }>;
     /**
      * Emitted when files are changed (added, removed, etc.).
      * @deprecated Use fileChange instead for simpler file input-like behavior
@@ -275,114 +276,103 @@ declare class AXUploaderZoneDirective implements OnDestroy {
      */
     browser(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXUploaderZoneDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXUploaderZoneDirective, "[axUploaderZone]", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "fileType": { "alias": "fileType"; "required": false; "isSignal": true; }; "overlayTemplate": { "alias": "overlayTemplate"; "required": false; "isSignal": true; }; "disableBrowse": { "alias": "disableBrowse"; "required": false; "isSignal": true; }; "disableDragDrop": { "alias": "disableDragDrop"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; "onChanged": "onChanged"; "dragEnter": "dragEnter"; "dragLeave": "dragLeave"; "dragOver": "dragOver"; "onFileUploadComplete": "onFileUploadComplete"; "onFilesUploadComplete": "onFilesUploadComplete"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXUploaderZoneDirective, "[axUploaderZone]", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "overlayTemplate": { "alias": "overlayTemplate"; "required": false; "isSignal": true; }; "disableBrowse": { "alias": "disableBrowse"; "required": false; "isSignal": true; }; "disableDragDrop": { "alias": "disableDragDrop"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; "onChanged": "onChanged"; "dragEnter": "dragEnter"; "dragLeave": "dragLeave"; "dragOver": "dragOver"; "onFileUploadComplete": "onFileUploadComplete"; "onFilesUploadComplete": "onFilesUploadComplete"; }, never, never, true, never>;
 }
 
-/** Reference to stored file/media (url and/or mediaId). */
-interface AXUploadReference {
-    url?: string;
-    mediaId?: string;
-    mimeType?: string;
-    size?: number;
-    expiresAt?: number;
-    metadata?: Record<string, unknown>;
-}
-interface AXFileUploadOptions {
-    source: File | Blob;
-    fileName?: string;
-    mimeType?: string;
-    metadata?: Record<string, unknown>;
-    onProgress?: (percent: number) => void;
-    signal?: AbortSignal;
-}
-interface AXUploadResult {
-    url: string;
-    thumbnailUrl?: string;
-    mediaId?: string;
-    size: number;
-    mimeType: string;
-    metadata?: Record<string, unknown>;
-}
-/** Emitted when {@link AXUploaderService.upload} is called. */
-interface AXUploaderUploadEvent extends AXEvent {
-    options: AXFileUploadOptions;
-    resolve: (result: AXUploadResult) => void;
-    reject: (reason: unknown) => void;
-}
-/** Emitted when {@link AXUploaderService.resolveUrl} is called. */
-interface AXUploaderResolveUrlEvent extends AXEvent {
-    reference: AXUploadReference;
-    signal?: AbortSignal;
-    resolve: (url: string) => void;
-    reject: (reason: unknown) => void;
-}
-/** Emitted when {@link AXUploaderService.deleteMedia} is called. */
-interface AXUploaderDeleteMediaEvent extends AXEvent {
-    reference: AXUploadReference;
-    resolve: () => void;
-    reject: (reason: unknown) => void;
-}
-interface AXUploaderBrowseOptions {
-    multiple?: boolean;
-    accept?: string;
-    /** Logical file type name(s) registered in {@link AXFileService}. */
-    fileType?: string | string[];
-}
-interface AXUploaderAddOptions {
-    fileType?: string | string[];
-}
 /**
- * File upload queue and validation via {@link AXFileService}.
- * Storage is implemented by subscribing to upload/resolve/delete events.
+ * Service for managing file uploads with drag-and-drop support, progress tracking, and dialog management.
  * @category Services
  */
 declare class AXUploaderService {
-    private readonly fileService;
+    /**
+     * Translation service for localized text.
+     * @ignore
+     */
+    private translateService;
+    /**
+     * File service for file operations.
+     * @ignore
+     */
+    private fileService;
+    /**
+     * Behavior subject for managing upload requests.
+     * @ignore
+     */
     private readonly _files$;
+    /**
+     * Gets the files behavior subject for observing upload requests.
+     */
     readonly files: rxjs.Observable<AXUploadRequest[]>;
+    /**
+     * Subject for file upload start events.
+     */
     readonly onFileUploadStart: Subject<AXUploaderFileStartEvent>;
+    /**
+     * Subject for file upload complete events.
+     */
     readonly onFileUploadComplete: Subject<AXUploaderFileCompleteEvent>;
+    /**
+     * Subject for all files upload complete events.
+     */
     readonly onFilesUploadComplete: Subject<AXUploaderFilesCompleteEvent>;
+    /**
+     * Subject for file upload canceled events.
+     */
     readonly onFileUploadCanceled: Subject<AXUploaderFileCancelEvent>;
-    /** Subscribe to perform uploads (e.g. HTTP, IndexedDB). */
-    readonly onUpload: Subject<AXUploaderUploadEvent>;
-    /** Subscribe to resolve a stored reference to a playback URL. */
-    readonly onResolveUrl: Subject<AXUploaderResolveUrlEvent>;
-    /** Subscribe to delete stored media. */
-    readonly onDeleteMedia: Subject<AXUploaderDeleteMediaEvent>;
+    /**
+     * Signal indicating if any upload has determined progress.
+     */
+    readonly isAnyDetermined: _angular_core.Signal<boolean>;
+    /**
+     * Observable for total estimated upload time.
+     */
     readonly totalEstimateTime: rxjs.Observable<number>;
-    isAnyDetermined(): boolean;
-    validateFiles(files: File[], fileType: string): Promise<{
-        accepted: File[];
-        rejected: {
-            file: File;
-            errors: AXValidationRuleResult[];
-        }[];
-    }>;
-    getAcceptAttribute(fileType: string | string[]): Promise<string>;
-    upload(options: AXFileUploadOptions): Promise<AXUploadResult>;
-    resolveUrl(reference: AXUploadReference, signal?: AbortSignal): Promise<string>;
-    resolvePlaybackUrl(reference: AXUploadReference, signal?: AbortSignal): Promise<string>;
-    deleteMedia(reference: AXUploadReference): Promise<void>;
-    private hasUploadHandler;
-    private hasResolveUrlHandler;
-    private hasDeleteMediaHandler;
-    add(files: FileList | File[], options?: AXUploaderAddOptions): Promise<AXUploadRequest[]>;
-    /**
-     * Opens the file dialog and returns selected files without enqueueing uploads.
-     * With `fileType`, applies catalog validation; otherwise uses legacy accept-only selection.
-     */
-    chooseFiles(options?: AXUploaderBrowseOptions): Promise<AXUploaderChooseFilesResult>;
-    browse(options?: AXUploaderBrowseOptions): Promise<AXUploadRequest[]>;
+    /**
+     * Converts a File object to an AXUploadRequest.
+     * @private
+     */
+    private convertFileToRequest;
+    /**
+     * Starts uploading files that are in 'new' status.
+     * @private
+     */
+    private startUpload;
+    /**
+     * Binds event handlers to an upload request.
+     * @private
+     */
+    private bindEvents;
+    /**
+     * Opens the file browser dialog and returns selected files as upload requests.
+     * @param options - Configuration options for file selection
+     * @returns Promise that resolves to an array of upload requests
+     */
+    browse(options?: {
+        multiple?: boolean;
+        accept?: string;
+    }): Promise<AXUploadRequest[]>;
+    /**
+     * Adds files to the upload queue and starts the upload process.
+     * @param files - Files to add to the upload queue
+     * @returns Promise that resolves to an array of upload requests
+     */
+    add(files: FileList | File[]): Promise<AXUploadRequest[]>;
+    /**
+     * Cancels all pending and in-progress uploads.
+     */
     cancelAll(): Promise<void>;
+    /**
+     * Clears all completed uploads from the queue.
+     */
     clearAll(): void;
+    /**
+     * Removes a specific upload request from the queue.
+     * @param item - The upload request to remove
+     */
     remove(item: AXUploadRequest): void;
-    private startUpload;
-    private bindEvents;
-    private applyFileTypeValidation;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXUploaderService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXUploaderService>;
 }
 
 export { AXUploadRequest, AXUploaderBrowseDirective, AXUploaderService, AXUploaderZoneDirective };
-export type { AXFileUploadOptions, AXUploadReference, AXUploadResult, AXUploadStatus, AXUploaderAddOptions, AXUploaderBrowseOptions, AXUploaderChangedEvent, AXUploaderChooseFilesResult, AXUploaderDeleteMediaEvent, AXUploaderFileCancelEvent, AXUploaderFileChangeEvent, AXUploaderFileCompleteEvent, AXUploaderFileStartEvent, AXUploaderFilesCompleteEvent, AXUploaderResolveUrlEvent, AXUploaderUploadEvent };
+export type { AXUploadStatus, AXUploaderChangedEvent, AXUploaderFileCancelEvent, AXUploaderFileCompleteEvent, AXUploaderFileStartEvent, AXUploaderFilesCompleteEvent };