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

package/fileselect.component.d.ts

@@ -15,6 +15,14 @@ import * as i0 from "@angular/core";
  * @hidden
  */
 export declare const FILESELECT_VALUE_ACCESSOR: any;
+/**
+ * Represents the [Kendo UI FileSelect component for Angular](slug:overview_fileselect_uploads).
+ *
+ * @example
+ * ```html
+ * <kendo-fileselect> </kendo-fileselect>
+ * ```
+ */
 export declare class FileSelectComponent extends UploadFileSelectBase implements OnInit, OnDestroy {
     protected uploadService: UploadService;
     private localization;
@@ -27,12 +35,12 @@ export declare class FileSelectComponent extends UploadFileSelectBase implements
     fileSelectInput: ElementRef;
     get dir(): string;
     /**
-     * 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: string);
     get name(): string;
     /**
-     * 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: EventEmitter<Array<File>>;
     /**
@@ -56,11 +64,13 @@ export declare class FileSelectComponent extends UploadFileSelectBase implements
     textFor(key: string): string;
     ngOnDestroy(): void;
     /**
-     * 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: string): void;
     /**
-     * Visually clears all files from the UI.
+     * Clears all files from the UI.
      */
     clearFiles(): void;
     /**

package/localization/messages.d.ts

@@ -10,86 +10,128 @@ import * as i0 from "@angular/core";
 export declare class Messages extends ComponentMessages {
     /**
      * Sets the text for the **Cancel** button.
+     *
+     * @default 'Cancel'
      */
     cancel: string;
     /**
      * Sets the text for the **Clear** button.
+     *
+     * @default 'Clear'
      */
     clearSelectedFiles: string;
     /**
      * Sets the drop-zone hint.
+     *
+     * @default 'Drop files here to upload'
      */
     dropFilesHere: string;
     /**
      * Sets the external drop-zone hint.
+     *
+     * @default 'Drag and drop files here to upload'
      */
     externalDropFilesHere: string;
     /**
      * Sets the status message for a batch of files.
+     *
+     * @default 'files'
      */
     filesBatchStatus: string;
     /**
      * Sets the status message for a batch of files after failed upload.
+     *
+     * @default 'files failed to upload.'
      */
     filesBatchStatusFailed: string;
     /**
      * Sets the status message for a batch of files after successful upload.
+     *
+     * @default 'files successfully uploaded.'
      */
     filesBatchStatusUploaded: string;
     /**
      * Sets the file status message after failed upload.
+     *
+     * @default 'File failed to upload.'
      */
     fileStatusFailed: string;
     /**
      * Sets the file status message after successful upload.
+     *
+     * @default 'File successfully uploaded.'
      */
     fileStatusUploaded: string;
     /**
      * Sets the header status message when the file upload is paused.
+     *
+     * @default 'Paused'
      */
     headerStatusPaused: string;
     /**
      * Sets the header status message after the file upload completes.
+     *
+     * @default 'Done'
      */
     headerStatusUploaded: string;
     /**
      * Sets the header status message during the upload of the file.
+     *
+     * @default 'Uploading...'
      */
     headerStatusUploading: string;
     /**
      * Sets the text for the invalid `allowedExtensions` restriction message.
+     *
+     * @default 'File type not allowed.'
      */
     invalidFileExtension: string;
     /**
      * Sets the text for the invalid `maxFileSize` restriction message.
+     *
+     * @default 'File size too large.'
      */
     invalidMaxFileSize: string;
     /**
      * Sets the text for the invalid `minFileSize` restriction message.
+     *
+     * @default 'File size too small.'
      */
     invalidMinFileSize: string;
     /**
      * Sets the text for the **Pause** button.
+     *
+     * @default 'Pause'
      */
     pause: string;
     /**
      * Sets the text for the **Remove** button.
+     *
+     * @default 'Remove'
      */
     remove: string;
     /**
      * Sets the text for the **Resume** button.
+     *
+     * @default 'Resume'
      */
     resume: string;
     /**
      * Sets the text for the **Retry** button.
+     *
+     * @default 'Retry'
      */
     retry: string;
     /**
      * Sets the text for the **Select** button.
+     *
+     * @default 'Select files...'
      */
     select: string;
     /**
      * Sets the text for the **Upload files** button.
+     *
+     * @default 'Upload'
      */
     uploadSelectedFiles: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<Messages, never>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-upload",
-  "version": "19.1.2-develop.2",
+  "version": "19.1.2-develop.4",
   "description": "Kendo UI Angular Upload Component",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -19,7 +19,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1749820388,
+      "publishDate": 1750156878,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -30,16 +30,16 @@
     "@angular/forms": "16 - 20",
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-common": "19.1.2-develop.2",
-    "@progress/kendo-angular-l10n": "19.1.2-develop.2",
-    "@progress/kendo-angular-icons": "19.1.2-develop.2",
-    "@progress/kendo-angular-buttons": "19.1.2-develop.2",
-    "@progress/kendo-angular-progressbar": "19.1.2-develop.2",
+    "@progress/kendo-angular-common": "19.1.2-develop.4",
+    "@progress/kendo-angular-l10n": "19.1.2-develop.4",
+    "@progress/kendo-angular-icons": "19.1.2-develop.4",
+    "@progress/kendo-angular-buttons": "19.1.2-develop.4",
+    "@progress/kendo-angular-progressbar": "19.1.2-develop.4",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.2-develop.2"
+    "@progress/kendo-angular-schematics": "19.1.2-develop.4"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/progress-kendo-angular-upload.mjs",

package/schematics/ngAdd/index.js

@@ -10,9 +10,9 @@ function default_1(options) {
         ], peerDependencies: {
             // peer dep of the icons
             '@progress/kendo-svg-icons': '^4.0.0',
-            '@progress/kendo-angular-buttons': '19.1.2-develop.2',
-            '@progress/kendo-angular-progressbar': '19.1.2-develop.2',
-            '@progress/kendo-angular-popup': '19.1.2-develop.2',
+            '@progress/kendo-angular-buttons': '19.1.2-develop.4',
+            '@progress/kendo-angular-progressbar': '19.1.2-develop.4',
+            '@progress/kendo-angular-popup': '19.1.2-develop.4',
         } });
     return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
 }

package/templates/file-info-template.directive.d.ts

@@ -5,20 +5,19 @@
 import { 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/templates/file-template.directive.d.ts

@@ -5,20 +5,19 @@
 import { 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/types/chunk-metadata.d.ts

@@ -3,8 +3,8 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Contains information which is related to the uploaded file.
- * It is used to process the file chunks and merge them into a file on the back-end.
+ * Contains information related to the uploaded file.
+ * Use this metadata to process file chunks and merge them into a file on the back-end.
  */
 export interface ChunkMetadata {
     /**
@@ -28,7 +28,7 @@ export interface ChunkMetadata {
      */
     chunkIndex: number;
     /**
-     * The total number of chunks that the file is split in.
+     * The total number of chunks that the file is split into.
      */
     totalChunks: number;
 }

package/types/chunk-settings.d.ts

@@ -7,25 +7,25 @@
  */
 export interface ChunkSettings {
     /**
-     * The size of the chunks in bytes. Default is 1MB.
+     * The size of the chunks in bytes.
      *
      * @default 1048576
      */
     size?: number;
     /**
-     * Will attempt a failed chunk upload after the specified number of milliseconds.
+     * The number of milliseconds to wait before retrying a failed chunk upload.
      *
      * @default 100
      */
     autoRetryAfter?: number;
     /**
-     * Determines the number of attempts to retry uploading a failed chunk.
+     * The number of attempts to retry uploading a failed chunk.
      *
      * @default 1
      */
     maxAutoRetries?: number;
     /**
-     * Determines if the file upload process could be paused and later resumed.
+     * Specifies whether the file upload process can be paused and later resumed.
      *
      * @default true
      */

package/types/file-restrictions.d.ts

@@ -7,19 +7,18 @@
  */
 export interface FileRestrictions {
     /**
-     * The list of the allowed file extensions
+     * The list of allowed file extensions
      * ([see example]({% slug filerestrictions_upload %}#toc-file-extension)).
-     * Recognizes entries of both `.type` (for example, `.docx`, `.png`, `.svg`, `.xls`, and others)
-     * and `type` (for example, `docx`, `png`, `svg`, `xls`, and others) values.
+     * Accepts entries of both `.type` (for example, `.docx`, `.png`, `.svg`, `.xls`) and `type` (for example, `docx`, `png`, `svg`, `xls`) values.
      */
     allowedExtensions?: Array<string>;
     /**
-     * Defines the maximum file size in bytes
+     * The maximum file size in bytes
      * ([see example]({% slug filerestrictions_upload %}#toc-maximum-file-size)).
      */
     maxFileSize?: number;
     /**
-     * Defines the minimum file size in bytes
+     * The minimum file size in bytes
      * ([see example]({% slug filerestrictions_upload %}#toc-minimum-file-size)).
      */
     minFileSize?: number;

package/types/file-state.d.ts

@@ -7,11 +7,11 @@
  */
 export declare enum FileState {
     /**
-     * The file upload process has failed.
+     * The file upload process failed.
      */
     Failed = 0,
     /**
-     * An initially selected fake file without a set state.
+     * An initially selected file without a set state.
      */
     Initial = 1,
     /**
@@ -19,15 +19,15 @@ export declare enum FileState {
      */
     Selected = 2,
     /**
-     * The file is successfully uploaded.
+     * The file uploaded successfully.
      */
     Uploaded = 3,
     /**
-     * The file is in the process of uploading.
+     * The file is uploading.
      */
     Uploading = 4,
     /**
-     * The file upload process has been paused.
+     * The file upload process is paused.
      */
     Paused = 5
 }

package/types/operation-type.d.ts

@@ -3,6 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Defines the operation (`upload` or `remove`) for which the `success` or `error` event is raised.
+ * The operation (`upload` or `remove`) for which the `success` or `error` event is raised.
  */
 export type OperationType = "upload" | "remove";