@progress/kendo-angular-upload 19.1.2-develop.2 → 19.1.2-develop.4

package/fesm2022/progress-kendo-angular-upload.mjs

@@ -27,11 +27,11 @@ import { PopupService } from '@progress/kendo-angular-popup';
 var FileState;
 (function (FileState) {
     /**
-     * The file upload process has failed.
+     * The file upload process failed.
      */
     FileState[FileState["Failed"] = 0] = "Failed";
     /**
-     * An initially selected fake file without a set state.
+     * An initially selected file without a set state.
      */
     FileState[FileState["Initial"] = 1] = "Initial";
     /**
@@ -39,15 +39,15 @@ var FileState;
      */
     FileState[FileState["Selected"] = 2] = "Selected";
     /**
-     * The file is successfully uploaded.
+     * The file uploaded successfully.
      */
     FileState[FileState["Uploaded"] = 3] = "Uploaded";
     /**
-     * The file is in the process of uploading.
+     * The file is uploading.
      */
     FileState[FileState["Uploading"] = 4] = "Uploading";
     /**
-     * The file upload process has been paused.
+     * The file upload process is paused.
      */
     FileState[FileState["Paused"] = 5] = "Paused";
 })(FileState || (FileState = {}));
@@ -194,33 +194,24 @@ class FileMap {
 
 /**
  * Arguments for the `cancel` event. The `cancel` event fires when
- * the user cancels the process of uploading a file or a batch of files.
+ * you cancel the upload of a file or batch of files.
  *
- * ```ts-no-run
- *  @Component({
- *    selector: 'my-upload',
+ * ```typescript
+ * @Component({
  *    template: `
- *    <p>Click the <span class='k-icon k-font-icon k-i-cancel'></span> icon during upload to trigger the event</p>
- *    <kendo-upload
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
- *      (cancel)="cancelEventHandler($event)">
- *    </kendo-upload>
+ *    <kendo-upload  (cancel)="cancelEventHandler($event)">   </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    cancelEventHandler(e: CancelEvent) {
+ *    public cancelEventHandler(e: CancelEvent) {
  *      console.log('Canceling file upload', e.files);
  *    }
- *  }
+ * }
  * ```
  */
 class CancelEvent {
     /**
-     * The list of the files that were going to be uploaded.
+     * The files that you canceled during the upload process.
      */
     files;
     /**
@@ -257,28 +248,21 @@ class PreventableEvent {
 
 /**
  * Arguments for the `clear` event. The `clear` event fires when
- * the **Clear** button is clicked. At this point, the selected files are about to be cleared.
+ * the **Clear** button is clicked and selected files are about to be cleared.
  *
- * ```ts-no-run
- *  @Component({
- *    selector: 'my-upload',
+ * ```typescript
+ * @Component({
  *    template: `
  *    <kendo-upload
- *      [autoUpload]="false"
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (clear)="clearEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    clearEventHandler(e: ClearEvent) {
+ *    public clearEventHandler(e: ClearEvent) {
  *      console.log('Clearing the file upload');
  *    }
- *  }
+ * }
  * ```
  */
 class ClearEvent extends PreventableEvent {
@@ -293,38 +277,32 @@ class ClearEvent extends PreventableEvent {
  * Arguments for the `error` event. The `error` event fires when
  * an `upload` or `remove` operation fails.
  *
- * ```ts-no-run
- *  @Component({
- *    selector: 'my-upload',
+ * ```typescript
+ * @Component({
  *    template: `
  *    <kendo-upload
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (error)="errorEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    errorEventHandler(e: ErrorEvent) {
+ *   public errorEventHandler(e: ErrorEvent) {
  *      console.log('An error occurred');
  *    }
- *  }
+ * }
  * ```
  */
 class ErrorEvent {
     /**
-     * The list of the files that failed to be uploaded or removed.
+     * The array of files that failed to be uploaded or removed.
      */
     files;
     /**
-     * The operation type (`upload` or `remove`).
+     * The operation type that failed (`upload` or `remove`).
      */
     operation;
     /**
-     * The response object returned by the server.
+     * The HTTP response returned by the server containing error details.
      */
     response;
     /**
@@ -343,35 +321,28 @@ class ErrorEvent {
 }
 
 /**
- * Arguments for the `pause` event. The `pause` event fires when the user
- * pauses a file that is currently uploading.
+ * Arguments for the `pause` event. The `pause` event fires when
+ * you pause a file that is currently uploading.
  *
- * ```ts-no-run
+ * ```typescript
  *  @Component({
- *    selector: 'my-upload',
  *    template: `
  *    <kendo-upload
  *      [chunkable]="true"
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (pause)="pauseEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    pauseEventHandler(ev: PauseEvent) {
+ *    public pauseEventHandler(ev: PauseEvent) {
  *      console.log('File paused');
  *    }
  *  }
  * ```
- *
  */
 class PauseEvent {
     /**
-     * The file that is going to be paused.
+     * The file that you paused during the upload process.
      */
     file;
     /**
@@ -385,25 +356,19 @@ class PauseEvent {
 }
 
 /**
- * Arguments for the `remove` event. The `remove` event fires when an uploaded
- * or selected file is about to be removed. If you cancel the event, the removal is prevented.
+ * Arguments for the `remove` event. The `remove` event fires when you are about to remove an uploaded
+ * or selected file. You can cancel this event to prevent removal.
  *
- * ```ts-no-run
+ * ```typescript
  *  @Component({
- *    selector: 'my-upload',
  *    template: `
  *    <kendo-upload
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (remove)="removeEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    removeEventHandler(e: RemoveEvent) {
+ *    public removeEventHandler(e: RemoveEvent) {
  *      console.log('Removing a file');
  *    }
  *  }
@@ -411,15 +376,17 @@ class PauseEvent {
  */
 class RemoveEvent extends PreventableEvent {
     /**
-     * An optional object that is sent to the `remove` handler in the form of a key/value pair.
+     * An optional object that you send to the `remove` handler as key/value pairs.
+     *
      */
     data;
     /**
-     * The list of the files that will be removed.
+     * The files that you will remove from the server.
      */
     files;
     /**
      * The headers of the request.
+     * You can use this to add custom headers to the remove request.
      */
     headers;
     /**
@@ -436,35 +403,28 @@ class RemoveEvent extends PreventableEvent {
 }
 
 /**
- * Arguments for the `resume` event. The `resume` event fires when the user
- * resumes the upload of a file that has been previously paused.
+ * Arguments for the `resume` event. The `resume` event fires when
+ * you resume a previously paused file upload.
  *
- * ```ts-no-run
+ * ```typescript
  *  @Component({
- *    selector: 'my-upload',
  *    template: `
  *    <kendo-upload
  *      [chunkable]="true"
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (resume)="resumeEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    resumeEventHandler(ev: ResumeEvent) {
+ *    public resumeEventHandler(ev: ResumeEvent) {
  *      console.log('File resumed');
  *    }
  *  }
  * ```
- *
  */
 class ResumeEvent {
     /**
-     * The file that is going to be resumed.
+     * The file that you resumed during the upload process.
      */
     file;
     /**
@@ -478,25 +438,19 @@ class ResumeEvent {
 }
 
 /**
- * Arguments for the `select` event. The `select` event fires when the user
- * selects a file or multiple files for upload. If you cancel the event, the selection is prevented.
+ * Arguments for the `select` event. The `select` event fires when
+ * a file or multiple files are selected for upload. The event can be canceled to prevent selection.
  *
- * ```ts-no-run
+ * ```typescript
  *  @Component({
- *    selector: 'my-upload',
  *    template: `
  *    <kendo-upload
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (select)="selectEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    selectEventHandler(e: SelectEvent) {
+ *    public selectEventHandler(e: SelectEvent) {
  *      console.log('File selected');
  *    }
  *  }
@@ -504,7 +458,7 @@ class ResumeEvent {
  */
 class SelectEvent extends PreventableEvent {
     /**
-     * The list of the selected files.
+     * The files that are selected for upload.
      */
     files;
     /**
@@ -520,24 +474,18 @@ class SelectEvent extends PreventableEvent {
 
 /**
  * Arguments for the `success` event. The `success` event fires when
- * the selected files are successfully uploaded or removed.
+ * you successfully upload or remove the selected files.
  *
- * ```ts-no-run
+ * ```typescript
  *  @Component({
- *    selector: 'my-upload',
  *    template: `
  *    <kendo-upload
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (success)="successEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    successEventHandler(e: SuccessEvent) {
+ *    public successEventHandler(e: SuccessEvent) {
  *      console.log('The ' + e.operation + ' was successful!');
  *    }
  *  }
@@ -545,15 +493,15 @@ class SelectEvent extends PreventableEvent {
  */
 class SuccessEvent extends PreventableEvent {
     /**
-     * The list of the files that were uploaded or removed.
+     * The files that you successfully uploaded or removed.
      */
     files;
     /**
-     * The operation type (`upload` or `remove`).
+     * The operation type that succeeded (`upload` or `remove`).
      */
     operation;
     /**
-     * The response object returned by the server.
+     * The HTTP response that the server returns to confirm success.
      */
     response;
     /**
@@ -572,25 +520,19 @@ class SuccessEvent extends PreventableEvent {
 }
 
 /**
- * Arguments for the `upload` event. The `upload` event fires when one or more files are about
- * to be uploaded. If you cancel the event, the upload is prevented. You can add headers to the request.
+ * Arguments for the `upload` event. The `upload` event fires when you are about
+ * to upload one or more files. You can cancel this event to prevent upload and add headers to the request.
  *
- * ```ts-no-run
+ * ```typescript
  *  @Component({
- *    selector: 'my-upload',
  *    template: `
  *    <kendo-upload
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (upload)="uploadEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    uploadEventHandler(e: UploadEvent) {
+ *    public uploadEventHandler(e: UploadEvent) {
  *      e.headers = e.headers.append('X-Foo', 'Bar');
  *    }
  *  }
@@ -598,38 +540,17 @@ class SuccessEvent extends PreventableEvent {
  */
 class UploadEvent extends PreventableEvent {
     /**
-     * The optional object that is sent to the `upload` handler in the form of key/value pair.
-     *
-     * ```ts-no-run
-     *  @Component({
-     *    selector: 'my-upload',
-     *    template: `
-     *    <kendo-upload
-     *      [saveUrl]="uploadSaveUrl"
-     *      [removeUrl]="uploadRemoveUrl"
-     *      (upload)="uploadEventHandler($event)">
-     *    </kendo-upload>
-     *    `
-     *  })
-     *  export class UploadComponent {
-     *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
-     *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
+     * The optional object that you send to the `upload` handler as key/value pairs.
      *
-     *    uploadEventHandler(e: UploadEvent) {
-     *      e.data = {
-     *        description: 'File description'
-     *      };
-     *    }
-     *  }
-     * ```
      */
     data;
     /**
-     * The list of the files that will be uploaded.
+     * The files that you will upload to the server.
      */
     files;
     /**
      * The headers of the request.
+     * You can use this to add custom headers to the upload request.
      */
     headers;
     /**
@@ -647,24 +568,18 @@ class UploadEvent extends PreventableEvent {
 
 /**
  * Arguments for the `uploadprogress` event. The `uploadprogress` event
- * fires when the files are in the process of uploading.
+ * fires when you upload files.
  *
- * ```ts-no-run
+ * ```typescript
  *  @Component({
- *    selector: 'my-upload',
  *    template: `
  *    <kendo-upload
- *      [saveUrl]="uploadSaveUrl"
- *      [removeUrl]="uploadRemoveUrl"
  *      (uploadProgress)="uploadProgressEventHandler($event)">
  *    </kendo-upload>
  *    `
  *  })
  *  export class UploadComponent {
- *    uploadSaveUrl = 'saveUrl'; // should represent an actual API endpoint
- *    uploadRemoveUrl = 'removeUrl'; // should represent an actual API endpoint
- *
- *    uploadProgressEventHandler(e: UploadProgressEvent) {
+ *    public uploadProgressEventHandler(e: UploadProgressEvent) {
  *      console.log(e.files[0].name + ' is ' + e.percentComplete + ' uploaded');
  *    }
  *  }
@@ -672,11 +587,11 @@ class UploadEvent extends PreventableEvent {
  */
 class UploadProgressEvent {
     /**
-     * The list of files that are being uploaded.
+     * The files that you are currently uploading.
      */
     files;
     /**
-     * The portion that has been uploaded.
+     * The upload progress as a percentage from 0 to 100.
      */
     percentComplete;
     /**
@@ -1660,26 +1575,25 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749820388,
-    version: '19.1.2-develop.2',
+    publishDate: 1750156878,
+    version: '19.1.2-develop.4',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
 /**
- * Used to customize the rendering of the files in the list. ([See example.](slug:templates_upload#toc-file-template))
+ * Customizes the rendering of files in the list. ([See example.](slug:templates_upload#toc-file-template))
  *
  * The following context variables are available in the template:
  *
- * * `let-files`&mdash;Provides a reference to the files which are associated with the current item.
- * * `let-state`&mdash;Gets a reference to the current state of each file. If the [`batch`](slug:api_upload_uploadcomponent#toc-batch) option of the Upload is set to `true`, the field reflects the state of the whole batch.
- * * `#myUpload="kendoUpload"` or `#myFileSelect="kendoFileSelect"`&mdash;Provides a reference to the instance of the Upload/FileSelect component. It is exported as `kendoUpload`/`kendoFileSelect` by using the [`exportAs`](https://angular.io/api/core/Component) metadata property.
+ * * `let-files`&mdash;A reference to the files associated with the current item.
+ * * `let-state`&mdash;A reference to the current state of each file. If the [`batch`](slug:api_upload_uploadcomponent#toc-batch) option of the Upload is set to `true`, the field reflects the state of the whole batch.
+ * * `#myUpload="kendoUpload"` or `#myFileSelect="kendoFileSelect"`&mdash;A reference to the instance of the Upload/FileSelect component. It is exported as `kendoUpload`/`kendoFileSelect` by using the [`exportAs`](https://angular.io/api/core/Component) metadata property.
  *
  * @example
  * ```html
- * <kendo-upload #myUpload="kendoUpload" ... >
+ * <kendo-upload #myUpload="kendoUpload">
  *     <ng-template kendoUploadFileTemplate let-files let-state>
  *         <div>Name: {{ files[0].name }} Size: {{ files[0].size }} bytes</div>
- *         ...
  *     </ng-template>
  * </kendo-upload>
  * ```
@@ -1701,20 +1615,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i0.TemplateRef }]; } });
 
 /**
- * Used to customize the rendering of the file info section in the list. All other elements of the default template, such as file icon, action buttons, upload progress etc. will be preserved in place. ([See example.](slug:templates_upload#toc-file-info-template))
+ * Customizes the rendering of the file info section in the list. All other elements of the default template, such as file icon, action buttons, and upload progress, are preserved in place. ([See example](slug:templates_upload#toc-file-info-template)).
  *
  * The following context variables are available in the template:
  *
- * * `let-files`&mdash;Provides a reference to the files which are associated with the current item.
- * * `let-state`&mdash;Gets a reference to the current state of each file. If the [`batch`](slug:api_upload_uploadcomponent#toc-batch) option of the Upload is set to `true`, the field reflects the state of the whole batch.
- * * `#myUpload="kendoUpload"` or `#myFileSelect="kendoFileSelect"`&mdash;Provides a reference to the instance of the Upload/FileSelect component. It is exported as `kendoUpload`/`kendoFileSelect` by using the [`exportAs`](https://angular.io/api/core/Component) metadata property.
+ * * `let-files`&mdash;A reference to the files associated with the current item.
+ * * `let-state`&mdash;A reference to the current state of each file. If the [`batch`](slug:api_upload_uploadcomponent#toc-batch) option of the Upload is set to `true`, the field reflects the state of the whole batch.
+ * * `#myUpload="kendoUpload"` or `#myFileSelect="kendoFileSelect"`&mdash;A reference to the instance of the Upload/FileSelect component. It is exported as `kendoUpload`/`kendoFileSelect` by using the [`exportAs`](https://angular.io/api/core/Component) metadata property.
  *
  * @example
  * ```html
- * <kendo-upload #myUpload="kendoUpload" ... >
+ * <kendo-upload #myUpload="kendoUpload">
  *     <ng-template kendoUploadFileInfoTemplate let-files let-state>
  *         <div>Name: {{ files[0].name }}</div>
- *         ...
  *     </ng-template>
  * </kendo-upload>
  * ```
@@ -1767,18 +1680,21 @@ class UploadFileSelectBase {
      */
     disabled = false;
     /**
-     * Enables the selection of multiple files
-     * If set to `false`, only one file can be selected at a time.
+     * Allows you to select multiple files.
+     * When you set this to `false`, you can select only one file at a time.
+     *
      * @default true
      */
     multiple = true;
     /**
-     * Toggles the visibility of the file list.
+     * Controls the visibility of the file list.
+     *
      * @default true
      */
     showFileList = true;
     /**
-     * Specifies the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
+     * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
+     *
      * @default 0
      */
     tabindex = 0;
@@ -1793,7 +1709,8 @@ class UploadFileSelectBase {
         return this._restrictions;
     }
     /**
-     * Specifies the id of the external drop zone to associate with the component.
+     * Sets the `id` of the external drop zone that you want to associate with the component.
+     *
      */
     zoneId;
     /**
@@ -1811,19 +1728,19 @@ class UploadFileSelectBase {
         return this.disabled;
     }
     /**
-     * Fires when the user navigates outside the component.
+     * Fires when you navigate outside the component.
      */
     onBlur = new EventEmitter();
     /**
-     * Fires when the component is focused.
+     * Fires when you focus the component.
      */
     onFocus = new EventEmitter();
     /**
-     * Fires when files are selected. If prevented, the selected files will not be added to the list.
+     * Fires when you select files. If you prevent this event, the component will not add the selected files to the list.
      */
     select = new EventEmitter();
     /**
-     * Fires when a file is about to be removed. If prevented, the file will remain in the list.
+     * Fires when you are about to remove a file. If you prevent this event, the file will remain in the list.
      */
     remove = new EventEmitter();
     /**
@@ -1916,7 +1833,7 @@ class UploadFileSelectBase {
         }
     }
     /**
-     * Focuses the component's `Select files` button.
+     * Focuses the component's **Select files** button.
      */
     focus() {
         this.zone.runOutsideAngular(() => {
@@ -1934,7 +1851,7 @@ class UploadFileSelectBase {
         this.focus();
     }
     /**
-     * Blurs the component if it was previously focused.
+     * Blurs the component if you previously focused it.
      */
     blur() {
         if (this.navigation.focused) {
@@ -3353,86 +3270,128 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 class Messages extends ComponentMessages {
     /**
      * Sets the text for the **Cancel** button.
+     *
+     * @default 'Cancel'
      */
     cancel;
     /**
      * Sets the text for the **Clear** button.
+     *
+     * @default 'Clear'
      */
     clearSelectedFiles;
     /**
      * Sets the drop-zone hint.
+     *
+     * @default 'Drop files here to upload'
      */
     dropFilesHere;
     /**
      * Sets the external drop-zone hint.
+     *
+     * @default 'Drag and drop files here to upload'
      */
     externalDropFilesHere;
     /**
      * Sets the status message for a batch of files.
+     *
+     * @default 'files'
      */
     filesBatchStatus;
     /**
      * Sets the status message for a batch of files after failed upload.
+     *
+     * @default 'files failed to upload.'
      */
     filesBatchStatusFailed;
     /**
      * Sets the status message for a batch of files after successful upload.
+     *
+     * @default 'files successfully uploaded.'
      */
     filesBatchStatusUploaded;
     /**
      * Sets the file status message after failed upload.
+     *
+     * @default 'File failed to upload.'
      */
     fileStatusFailed;
     /**
      * Sets the file status message after successful upload.
+     *
+     * @default 'File successfully uploaded.'
      */
     fileStatusUploaded;
     /**
      * Sets the header status message when the file upload is paused.
+     *
+     * @default 'Paused'
      */
     headerStatusPaused;
     /**
      * Sets the header status message after the file upload completes.
+     *
+     * @default 'Done'
      */
     headerStatusUploaded;
     /**
      * Sets the header status message during the upload of the file.
+     *
+     * @default 'Uploading...'
      */
     headerStatusUploading;
     /**
      * Sets the text for the invalid `allowedExtensions` restriction message.
+     *
+     * @default 'File type not allowed.'
      */
     invalidFileExtension;
     /**
      * Sets the text for the invalid `maxFileSize` restriction message.
+     *
+     * @default 'File size too large.'
      */
     invalidMaxFileSize;
     /**
      * Sets the text for the invalid `minFileSize` restriction message.
+     *
+     * @default 'File size too small.'
      */
     invalidMinFileSize;
     /**
      * Sets the text for the **Pause** button.
+     *
+     * @default 'Pause'
      */
     pause;
     /**
      * Sets the text for the **Remove** button.
+     *
+     * @default 'Remove'
      */
     remove;
     /**
      * Sets the text for the **Resume** button.
+     *
+     * @default 'Resume'
      */
     resume;
     /**
      * Sets the text for the **Retry** button.
+     *
+     * @default 'Retry'
      */
     retry;
     /**
      * Sets the text for the **Select** button.
+     *
+     * @default 'Select files...'
      */
     select;
     /**
      * Sets the text for the **Upload files** button.
+     *
+     * @default 'Upload'
      */
     uploadSelectedFiles;
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -3532,6 +3491,11 @@ const UPLOAD_VALUE_ACCESSOR = {
 let idx$1 = 0;
 /**
  * Represents the [Kendo UI Upload component for Angular]({% slug overview_upload %}).
+ *
+ * @example
+ * ```html
+ * <kendo-upload> </kendo-upload>
+ * ```
  */
 class UploadComponent extends UploadFileSelectBase {
     uploadService;
@@ -3543,9 +3507,11 @@ class UploadComponent extends UploadFileSelectBase {
     cdr;
     injector;
     /**
-     * By default, the selected files are immediately uploaded
+     * Specifies whether selected files upload automatically
      * ([see example]({% slug fileprocessing_upload %}#toc-automatic-upload-of-files)).
-     * To change this behavior, set `autoUpload` to `false`.
+     * Set `autoUpload` to `false` to change this behavior.
+     *
+     * @default true
      */
     set autoUpload(autoUpload) {
         this.uploadService.async.autoUpload = autoUpload;
@@ -3554,9 +3520,11 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.autoUpload;
     }
     /**
-     * When enabled, all files in the selection are uploaded in one request
+     * Specifies whether all files in the selection upload in a single request
      * ([see example]({% slug fileprocessing_upload %}#toc-upload-of-batches-of-files)).
-     * Any files that are selected one after the other are uploaded in separate requests.
+     * Files selected one after the other upload in separate requests.
+     *
+     * @default false
      */
     set batch(batch) {
         this.uploadService.async.batch = batch;
@@ -3565,11 +3533,13 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.batch;
     }
     /**
-     * Configures whether credentials (cookies, headers) will be sent for cross-site requests
+     * Specifies whether credentials (cookies, headers) are sent for cross-site requests
      * ([see example]({% slug credentials_upload %}#toc-attaching-credentials-to-requests)).
-     * The default values is `true`. Setting `withCredentials` has no effect on same-site requests.
-     * To add credentials to the request, use the `saveHeaders` or `removeHeaders` property,
-     * or the [`upload`]({% slug api_upload_uploadevent %}) event.
+     * Set `withCredentials` has no effect on same-site requests.
+     * Use the `saveHeaders` or `removeHeaders` property to add credentials to the request.
+     * You can also use the [`upload`]({% slug api_upload_uploadevent %}) event.
+     *
+     * @default true
      */
     set withCredentials(withCredentials) {
         this.uploadService.async.withCredentials = withCredentials;
@@ -3578,8 +3548,8 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.withCredentials;
     }
     /**
-     * Sets the [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key which contains the files submitted to `saveUrl`.
-     * The default value is `files`.
+     * Specifies the [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key which contains the files submitted to `saveUrl`.
+     *
      */
     set saveField(saveField) {
         this.uploadService.async.saveField = saveField;
@@ -3588,8 +3558,7 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.saveField;
     }
     /**
-     * Configures the [`HttpHeaders`](https://angular.io/api/common/http/HttpHeaders)
-     * that are attached to each upload request.
+     * Specifies the [`HttpHeaders`](https://angular.io/api/common/http/HttpHeaders) attached to each upload request.
      */
     set saveHeaders(saveHeaders) {
         this.uploadService.async.saveHeaders = saveHeaders;
@@ -3598,8 +3567,8 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.saveHeaders;
     }
     /**
-     * Sets the [`RequestMethod`](https://angular.io/api/http/RequestMethod) of the upload request.
-     * The default value is `POST`.
+     * Specifies the [`RequestMethod`](https://angular.io/api/http/RequestMethod) of the upload request.
+     *
      */
     set saveMethod(saveMethod) {
         this.uploadService.async.saveMethod = saveMethod;
@@ -3608,9 +3577,9 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.saveMethod;
     }
     /**
-     * Sets the URL of the endpoint for the upload request.
-     * The request [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key is named after the `saveField` property.
-     * It contains the list of files to be uploaded.
+     * Specifies the URL of the endpoint for the upload request.
+     * The request [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key uses the name from the `saveField` property.
+     * This key contains the list of files to be uploaded.
      */
     set saveUrl(saveUrl) {
         this.uploadService.async.saveUrl = saveUrl;
@@ -3619,8 +3588,9 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.saveUrl;
     }
     /**
-     * Sets the expected [`response type`](https://angular.io/api/common/http/HttpRequest#responseType) of the server.
-     * It is used to parse the response appropriately.
+     * Specifies the expected [`response type`](https://angular.io/api/common/http/HttpRequest#responseType) of the server.
+     * The response type determines how the response is parsed.
+     *
      * @default 'json'
      */
     set responseType(responseType) {
@@ -3630,15 +3600,13 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.responseType;
     }
     /**
-     * Sets the [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key
-     * which contains the list of file names that are submitted to `removeUrl`.
-     * The default value is `fileNames`.
+     * Specifies the [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key which contains the list of file names submitted to `removeUrl`.
+     *
      */
     set removeField(removeField) { this.uploadService.async.removeField = removeField; }
     get removeField() { return this.uploadService.async.removeField; }
     /**
-     * Configures the [`HttpHeaders`](https://angular.io/api/common/http/HttpHeaders)
-     * that are attached to each `remove` request.
+     * Specifies the [`HttpHeaders`](https://angular.io/api/common/http/HttpHeaders) attached to each `remove` request.
      */
     set removeHeaders(removeHeaders) {
         this.uploadService.async.removeHeaders = removeHeaders;
@@ -3647,8 +3615,8 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.removeHeaders;
     }
     /**
-     * Sets the [`RequestMethod`](https://angular.io/api/http/RequestMethod) of the `remove` request.
-     * The default value is `POST`.
+     * Specifies the [`RequestMethod`](https://angular.io/api/http/RequestMethod) of the `remove` request.
+     *
      */
     set removeMethod(removeMethod) {
         this.uploadService.async.removeMethod = removeMethod;
@@ -3657,9 +3625,9 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.removeMethod;
     }
     /**
-     * Sets the URL of the endpoint for the `remove` request.
-     * The [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) request key is named after the `removeField` property.
-     * It contains the list of file names which will be removed.
+     * Specifies the URL of the endpoint for the `remove` request.
+     * The [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) request key uses the name from the `removeField` property.
+     * This key contains the list of file names to be removed.
      */
     set removeUrl(removeUrl) {
         this.uploadService.async.removeUrl = removeUrl;
@@ -3668,13 +3636,13 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.removeUrl;
     }
     /**
-     * Enables the chunk functionality of the Upload.
+     * Specifies whether the chunk functionality of the Upload is enabled.
      *
      * @default false
      */
     chunkable = false;
     /**
-     * Specifies if the selected files are uploaded simultaneously or one by one.
+     * Specifies whether selected files upload simultaneously or one by one.
      *
      * @default true
      */
@@ -3685,7 +3653,8 @@ class UploadComponent extends UploadFileSelectBase {
         return this.uploadService.async.concurrent;
     }
     /**
-     * Toggles the visibility of the file list.
+     * Specifies whether the file list is visible.
+     *
      * @default true
      */
     showFileList = true;
@@ -3699,7 +3668,9 @@ class UploadComponent extends UploadFileSelectBase {
         return this.tabindex;
     }
     /**
-     * Specifies the possible layout of the action buttons.
+     * Specifies the layout of the action buttons.
+     *
+     * @default 'end'
      */
     actionsLayout = 'end';
     fileSelectInput;
@@ -3708,39 +3679,41 @@ class UploadComponent extends UploadFileSelectBase {
      */
     cancel = new EventEmitter();
     /**
-     * Fires when the file list is about to be cleared. If prevented, the files will not be cleared.
+     * Fires when the file list is about to be cleared.
+     * Prevent this event to keep the files in the list.
      */
     clear = new EventEmitter();
     /**
-     * Fires when all active uploads are completed either successfully or with errors.
+     * Fires when all active uploads complete successfully or with errors.
      */
     complete = new EventEmitter();
     /**
-     * Fires when an `upload` or `remove` operation has failed.
+     * Fires when an `upload` or `remove` operation fails.
      */
     error = new EventEmitter();
     /**
-     * Fires when the upload of a file has been paused.
+     * Fires when the upload of a file is paused.
      */
     pause = new EventEmitter();
     /**
-     * Fires when the upload of a file has been resumed.
+     * Fires when the upload of a file is resumed.
      */
     resume = new EventEmitter();
     /**
-     * Fires when an `upload` or `remove` operation is successfully completed.
+     * Fires when an `upload` or `remove` operation completes successfully.
      */
     success = new EventEmitter();
     /**
-     * Fires when one or more files are about to be uploaded. If prevented, the files will neither be uploaded, nor added to the file list.
+     * Fires when one or more files are about to be uploaded.
+     * Prevent this event to stop the files from uploading and being added to the file list.
      */
     upload = new EventEmitter();
     /**
-     * Fires when one or more files are being uploaded.
+     * Fires when one or more files are uploading.
      */
     uploadProgress = new EventEmitter();
     /**
-     * Fires when the value of the component has changed as a result of a successful `upload`, `remove` or `clear` operation.
+     * Fires when the component value changes after a successful `upload`, `remove`, or `clear` operation.
      */
     valueChange = new EventEmitter();
     get dir() {
@@ -3879,45 +3852,48 @@ class UploadComponent extends UploadFileSelectBase {
     }
     /**
      * Pauses the upload process of a file that is currently uploading.
-     * The `pauseFileByUid` method requires the `chunkable` option of the Upload to be enabled.
+     * This method requires the `chunkable` option of the Upload to be enabled.
      *
-     * @param uid - The `uid` of the file that will be paused.
+     * @param uid The `uid` of the file that will be paused.
      */
     pauseFileByUid(uid) {
         this.uploadService.pauseFile(uid);
     }
     /**
-     * Resumes the upload process for a file that has been previously paused.
-     * The `resumeFileByUid` method requires the `chunkable` option of the Upload to be enabled.
+     * Resumes the upload process for a file that was previously paused.
+     * This method requires the `chunkable` option of the Upload to be enabled.
      *
-     * @param uid - The `uid` of the file that will be resumed.
+     * @param uid The `uid` of the file that will be resumed.
      */
     resumeFileByUid(uid) {
         this.uploadService.resumeFile(uid);
     }
     /**
-     * Triggers the removal of a file or a batch of files.
-     * @param uid - The `uid` of the file or a batch of files that will be removed.
+     * Removes a file or a batch of files.
+     *
+     * @param uid The `uid` of the file or a batch of files that will be removed.
      */
     removeFilesByUid(uid) {
         this.uploadService.removeFiles(uid);
     }
     /**
-     * Triggers another upload attempt of an unsuccessfully uploaded file or a batch of files.
-     * @param uid - The `uid` of the file or a batch of files to be retried.
+     * Retries the upload of a file or batch of files that failed to upload.
+     *
+     * @param uid The `uid` of the file or a batch of files to be retried.
      */
     retryUploadByUid(uid) {
         this.uploadService.retryFiles(uid);
     }
     /**
      * Cancels the upload of a file or a batch of files.
-     * @param uid - The `uid` of the file or a batch of files that will be canceled.
+     *
+     * @param uid The `uid` of the file or a batch of files that will be canceled.
      */
     cancelUploadByUid(uid) {
         this.uploadService.cancelFiles(uid);
     }
     /**
-     * Uploads the currently selected files which pass the set restrictions.
+     * Uploads the currently selected files that pass the set restrictions.
      */
     uploadFiles() {
         if (this.fileList.filesToUpload.length) {
@@ -3925,7 +3901,7 @@ class UploadComponent extends UploadFileSelectBase {
         }
     }
     /**
-     * Visually clears all files from the UI without issuing requests to the remove handler.
+     * Clears all files from the UI without sending requests to the remove handler.
      */
     clearFiles() {
         this.uploadService.clearFiles();
@@ -4115,7 +4091,7 @@ class UploadComponent extends UploadFileSelectBase {
         [disabled]="disabled"
     >
         <div class="k-upload-button-wrap">
-            <button 
+            <button
                 kendoButton
                 #fileSelectButton
                 class="k-upload-button"
@@ -4248,7 +4224,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         [disabled]="disabled"
     >
         <div class="k-upload-button-wrap">
-            <button 
+            <button
                 kendoButton
                 #fileSelectButton
                 class="k-upload-button"
@@ -4357,16 +4333,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 args: ['attr.dir']
             }] } });
 
+/**
+ * Represents the [Kendo UI UploadDropZone directive for Angular]({% slug overview_upload %}).
+ * Use this directive to create external drop zones for Upload and FileSelect components.
+ *
+ * @example
+ * ```html
+ * <div kendoUploadDropZone="upload1">Drop files here</div>
+ * <kendo-upload [saveUrl]="uploadSaveUrl" zoneId="upload1"></kendo-upload>
+ * ```
+ */
 class UploadDropZoneDirective {
     dropZoneService;
     /**
-     * Specifies the id of the drop zone used to associate it with
-     * an existing Upload component.
+     * The id of the drop zone to associate with an existing Upload component.
      */
     zoneId;
     /**
-     * Specifies the id of the drop zone used to associate it with
-     * an existing FileSelect component.
+     * The id of the drop zone to associate with an existing FileSelect component.
      */
     fileSelectZoneId;
     constructor(dropZoneService) {
@@ -4452,6 +4436,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 /**
  * Represents the [Kendo UI UploadDropZone component for Angular]({% slug overview_upload %}).
+ *
+ * @example
+ * ```html
+ * <kendo-uploaddropzone zoneId="upload1">
+ *   Drop files here to upload
+ * </kendo-uploaddropzone>
+ * <kendo-upload [saveUrl]="uploadSaveUrl" zoneId="upload1"></kendo-upload>
+ * ```
  */
 class UploadDropZoneComponent extends DropZoneBase {
     localization;
@@ -4460,24 +4452,23 @@ class UploadDropZoneComponent extends DropZoneBase {
         return this.direction;
     }
     /**
-     * Defines the id of the component.
-     * It is used to associate it with an existing Upload or FileSelect component.
+     * Specifies the id of the component.
+     * Use this id to associate the DropZone with an existing Upload or FileSelect component.
      */
     zoneId;
     /**
-     * Defines the name for an existing icon in a Kendo UI theme.
-     * The icon is rendered inside the DropZone.
+     * Specifies the name for an existing icon in a Kendo UI theme.
+     * The icon renders inside the DropZone.
      */
     icon;
     /**
-     * Defines a CSS class or multiple classes separated by spaces,
-     * which are applied to a span element.
-     * Allows the usage of custom icons.
+     * Specifies a CSS class or multiple classes separated by spaces which apply to a span element.
+     * Use this property to apply custom icons.
      */
     iconClass;
     /**
-     * Defines an SVGIcon to be rendered inside the DropZone.
-     * The input can take either an [existing Kendo SVG icon](slug:svgicon_list) or a custom one.
+     * Specifies an SVGIcon to render inside the DropZone.
+     * The input accepts either an [existing Kendo SVG icon](slug:svgicon_list) or a custom one.
      */
     set svgIcon(icon) {
         if (isDevMode() && icon && this.icon && this.iconClass) {
@@ -4606,6 +4597,14 @@ const FILESELECT_VALUE_ACCESSOR = {
     useExisting: forwardRef(() => FileSelectComponent)
 };
 let idx = 0;
+/**
+ * Represents the [Kendo UI FileSelect component for Angular](slug:overview_fileselect_uploads).
+ *
+ * @example
+ * ```html
+ * <kendo-fileselect> </kendo-fileselect>
+ * ```
+ */
 class FileSelectComponent extends UploadFileSelectBase {
     uploadService;
     localization;
@@ -4620,7 +4619,7 @@ class FileSelectComponent extends UploadFileSelectBase {
         return this.direction;
     }
     /**
-     * Sets the `name` attribute of the `input` element of the FileSelect.
+     * Specifies the `name` attribute of the `input` element of the FileSelect.
      */
     set name(name) {
         this.uploadService.async.saveField = name;
@@ -4629,7 +4628,7 @@ class FileSelectComponent extends UploadFileSelectBase {
         return this.uploadService.async.saveField;
     }
     /**
-     * Fires when the value of the component has changed as a result of a successful `select` or `remove` operation.
+     * Fires when the component value changes after a successful `select` or `remove` operation.
      */
     valueChange = new EventEmitter();
     /**
@@ -4713,13 +4712,15 @@ class FileSelectComponent extends UploadFileSelectBase {
         }
     }
     /**
-     * Removes specific file from the file list.
+     * Removes a specific file from the file list.
+     *
+     * @param uid The `uid` of the file to be removed.
      */
     removeFileByUid(uid) {
         this.uploadService.removeFiles(uid);
     }
     /**
-     * Visually clears all files from the UI.
+     * Clears all files from the UI.
      */
     clearFiles() {
         this.uploadService.clearFiles();
@@ -4871,7 +4872,7 @@ class FileSelectComponent extends UploadFileSelectBase {
             [multiple]="multiple"
             [disabled]="disabled">
             <div class="k-upload-button-wrap">
-            <button 
+            <button
                 kendoButton
                 #fileSelectButton
                 class="k-upload-button"
@@ -4955,7 +4956,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             [multiple]="multiple"
             [disabled]="disabled">
             <div class="k-upload-button-wrap">
-            <button 
+            <button
                 kendoButton
                 #fileSelectButton
                 class="k-upload-button"
@@ -5053,7 +5054,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$1.LocalizationService }]; } });
 
 /**
- * Utility array that contains all `FileSelect` related components and directives
+ * Use the KENDO_FILESELECT utility array to add all FileSelect-related components and directives to a standalone Angular component.
  */
 const KENDO_FILESELECT = [
     FileSelectComponent,
@@ -5064,7 +5065,7 @@ const KENDO_FILESELECT = [
     UploadDropZoneComponent
 ];
 /**
- * Utility array that contains all `Upload` related components and directives
+ * Use the KENDO_UPLOAD utility array to add all Upload-related components and directives to a standalone Angular component.
  */
 const KENDO_UPLOAD = [
     UploadComponent,
@@ -5077,7 +5078,7 @@ const KENDO_UPLOAD = [
     UploadDropZoneComponent
 ];
 /**
- * Utility array that contains all `@progress/kendo-angular-upload` related components and directives
+ * Use the KENDO_UPLOADS utility array to add all `@progress/kendo-angular-upload`-related components and directives to a standalone Angular component.
  */
 const KENDO_UPLOADS = [
     ...KENDO_FILESELECT,