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

package/esm2022/events/select-event.mjs

@@ -4,25 +4,19 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from './preventable-event';
 /**
- * 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');
  *    }
  *  }
@@ -30,7 +24,7 @@ import { PreventableEvent } from './preventable-event';
  */
 export class SelectEvent extends PreventableEvent {
     /**
-     * The list of the selected files.
+     * The files that are selected for upload.
      */
     files;
     /**

package/esm2022/events/success-event.mjs

@@ -5,24 +5,18 @@
 import { PreventableEvent } from './preventable-event';
 /**
  * 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!');
  *    }
  *  }
@@ -30,15 +24,15 @@ import { PreventableEvent } from './preventable-event';
  */
 export 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;
     /**

package/esm2022/events/upload-event.mjs

@@ -4,25 +4,19 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from './preventable-event';
 /**
- * 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');
  *    }
  *  }
@@ -30,38 +24,17 @@ import { PreventableEvent } from './preventable-event';
  */
 export 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;
     /**

package/esm2022/events/upload-progress-event.mjs

@@ -4,24 +4,18 @@
 *-------------------------------------------------------------------------------------------*/
 /**
  * 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');
  *    }
  *  }
@@ -29,11 +23,11 @@
  */
 export 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;
     /**

package/esm2022/fileselect.component.mjs

@@ -36,6 +36,14 @@ export 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>
+ * ```
+ */
 export class FileSelectComponent extends UploadFileSelectBase {
     uploadService;
     localization;
@@ -50,7 +58,7 @@ export 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;
@@ -59,7 +67,7 @@ export 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();
     /**
@@ -143,13 +151,15 @@ export 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();
@@ -301,7 +311,7 @@ export class FileSelectComponent extends UploadFileSelectBase {
             [multiple]="multiple"
             [disabled]="disabled">
             <div class="k-upload-button-wrap">
-            <button 
+            <button
                 kendoButton
                 #fileSelectButton
                 class="k-upload-button"
@@ -385,7 +395,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"

package/esm2022/localization/messages.mjs

@@ -11,86 +11,128 @@ import * as i0 from "@angular/core";
 export 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 });

package/esm2022/package-metadata.mjs

@@ -10,7 +10,7 @@ export const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749820388,
-    version: '19.1.2-develop.2',
+    publishDate: 1750152453,
+    version: '19.1.2-develop.3',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };

package/esm2022/templates/file-info-template.directive.mjs

@@ -5,20 +5,19 @@
 import { Directive, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * 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`—Provides a reference to the files which are associated with the current item.
- * * `let-state`—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"`—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`—A reference to the files associated with the current item.
+ * * `let-state`—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"`—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>
  * ```

package/esm2022/templates/file-template.directive.mjs

@@ -5,20 +5,19 @@
 import { Directive, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * 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`—Provides a reference to the files which are associated with the current item.
- * * `let-state`—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"`—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`—A reference to the files associated with the current item.
+ * * `let-state`—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"`—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>
  * ```

package/esm2022/types/file-state.mjs

@@ -8,11 +8,11 @@
 export 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";
     /**
@@ -20,15 +20,15 @@ export 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 = {}));