@progress/kendo-react-upload 13.3.0-develop.9 → 13.4.0-develop.1

package/interfaces/UploadProps.d.ts

@@ -0,0 +1,242 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { UploadAsyncProps } from './UploadAsyncProps.js';
+import { UploadFileRestrictions } from './UploadFileRestrictions.js';
+import { UploadFileInfo } from './UploadFileInfo.js';
+import { UploadListItemProps } from './UploadListItemProps.js';
+import { UploadOnAddEvent } from './UploadOnAddEvent.js';
+import { UploadOnRemoveEvent } from './UploadOnRemoveEvent.js';
+import { UploadOnStatusChangeEvent } from './UploadOnStatusChangeEvent.js';
+import { UploadOnProgressEvent } from './UploadOnProgressEvent.js';
+import { UploadOnBeforeUploadEvent } from './UploadOnBeforeUploadEvent.js';
+import { UploadOnBeforeRemoveEvent } from './UploadOnBeforeRemoveEvent.js';
+import { UploadOnCancelEvent } from './UploadOnCancelEvent.js';
+import { UploadActionsLayout } from './UploadActionsLayout.js';
+import { UploadSelectMessageProps } from './UploadSelectMessageProps.js';
+/**
+ * Represents the props of the [KendoReact Upload component](https://www.telerik.com/kendo-react-ui/components/upload).
+ */
+export interface UploadProps extends UploadAsyncProps {
+    /**
+     * Adds a custom CSS class to the Upload container element.
+     *
+     * Example:
+     * ```jsx
+     * <Upload className="custom-upload-class" />
+     * ```
+     */
+    className?: string;
+    /**
+     * Enables or disables the selection of multiple files. Defaults to `true`.
+     *
+     * @default true
+     *
+     * @example
+     * ```jsx
+     * <Upload multiple={false} />
+     * ```
+     */
+    multiple?: boolean;
+    /**
+     * Disables the Upload component. Defaults to `false`.
+     *
+     * @default false
+     *
+     * @example
+     * ```jsx
+     * <Upload disabled={true} />
+     * ```
+     */
+    disabled?: boolean;
+    /**
+     * Toggles the visibility of the file list in the Upload component.
+     *
+     * @default true
+     *
+     * @example
+     * ```jsx
+     * <Upload showFileList={false} />
+     * ```
+     */
+    showFileList?: boolean;
+    /**
+     * Toggles the visibility of action buttons when `autoUpload` is set to `false`.
+     *
+     * @default true
+     *
+     * @example
+     * ```jsx
+     * <Upload autoUpload={false} showActionButtons={true} />
+     * ```
+     */
+    showActionButtons?: boolean;
+    /**
+     * Specifies the layout of the action buttons. Defaults to `end`.
+     *
+     * @default "end"
+     *
+     * @example
+     * ```jsx
+     * <Upload actionsLayout="start" />
+     * ```
+     */
+    actionsLayout?: UploadActionsLayout;
+    /**
+     * Sets the `tabIndex` attribute of the Upload component.
+     *
+     * Example:
+     * ```jsx
+     * <Upload tabIndex={0} />
+     * ```
+     */
+    tabIndex?: number | string;
+    /**
+     * Specifies the `id` attribute of the Upload component.
+     *
+     * Example:
+     * ```jsx
+     * <Upload id="upload-component" />
+     * ```
+     */
+    id?: string;
+    /**
+     * Identifies elements that describe the Upload component, similar to the `aria-describedby` attribute.
+     *
+     * Example:
+     * ```jsx
+     * <Upload ariaDescribedBy="upload-description" />
+     * ```
+     */
+    ariaDescribedBy?: string;
+    /**
+     * Identifies elements that label the Upload component, similar to the `aria-labelledby` attribute.
+     *
+     * Example:
+     * ```jsx
+     * <Upload ariaLabelledBy="upload-label" />
+     * ```
+     */
+    ariaLabelledBy?: string;
+    /**
+     * Sets the `accept` attribute of the file input element to specify allowed file types.
+     *
+     * Example:
+     * ```jsx
+     * <Upload accept=".jpg,.png" />
+     * ```
+     */
+    accept?: string;
+    /**
+     * Configures file restrictions such as allowed extensions and maximum file size.
+     *
+     * Example:
+     * ```jsx
+     * <Upload restrictions={{ allowedExtensions: ['.jpg', '.png'], maxFileSize: 1048576 }} />
+     * ```
+     */
+    restrictions?: UploadFileRestrictions;
+    /**
+     * Provides the list of files to be displayed in controlled mode.
+     *
+     * Example:
+     * ```jsx
+     * <Upload files={[{ name: 'file1.jpg', size: 1024 }]} />
+     * ```
+     */
+    files?: Array<UploadFileInfo>;
+    /**
+     * Provides the initial list of files to be displayed in uncontrolled mode.
+     *
+     * Example:
+     * ```jsx
+     * <Upload defaultFiles={[{ name: 'file1.jpg', size: 1024 }]} />
+     * ```
+     */
+    defaultFiles?: Array<UploadFileInfo>;
+    /**
+     * Customizes the rendering of list items in the file list.
+     *
+     * Example:
+     * ```jsx
+     * <Upload listItemUI={(props) => <CustomListItem {...props} />} />
+     * ```
+     */
+    listItemUI?: React.ComponentType<UploadListItemProps>;
+    /**
+     * Customizes the content of the add button in the Upload component.
+     *
+     * Example:
+     * ```jsx
+     * <Upload selectMessageUI={(props) => <CustomSelectMessage {...props} />} />
+     * ```
+     */
+    selectMessageUI?: React.ComponentType<UploadSelectMessageProps>;
+    /**
+     * Triggered when new files are selected for upload.
+     *
+     * Example:
+     * ```jsx
+     * <Upload onAdd={(event) => console.log(event.files)} />
+     * ```
+     */
+    onAdd?: (event: UploadOnAddEvent) => void;
+    /**
+     * Triggered when files are removed. May include a server response if applicable.
+     *
+     * Example:
+     * ```jsx
+     * <Upload onRemove={(event) => console.log(event.files)} />
+     * ```
+     */
+    onRemove?: (event: UploadOnRemoveEvent) => void;
+    /**
+     * Triggered when the status of files changes. May include a server response if applicable.
+     *
+     * Example:
+     * ```jsx
+     * <Upload onStatusChange={(event) => console.log(event.files)} />
+     * ```
+     */
+    onStatusChange?: (event: UploadOnStatusChangeEvent) => void;
+    /**
+     * Triggered when the upload progress of a file changes.
+     *
+     * Example:
+     * ```jsx
+     * <Upload onProgress={(event) => console.log(event.percentComplete)} />
+     * ```
+     */
+    onProgress?: (event: UploadOnProgressEvent) => void;
+    /**
+     * Triggered before a file upload request is made. Can be used to add extra data to the request.
+     *
+     * Example:
+     * ```jsx
+     * <Upload onBeforeUpload={(event) => console.log(event.additionalData)} />
+     * ```
+     */
+    onBeforeUpload?: (event: UploadOnBeforeUploadEvent) => void;
+    /**
+     * Triggered before a file removal request is made. Can be used to add extra data to the request.
+     *
+     * Example:
+     * ```jsx
+     * <Upload onBeforeRemove={(event) => console.log(event.additionalData)} />
+     * ```
+     */
+    onBeforeRemove?: (event: UploadOnBeforeRemoveEvent) => void;
+    /**
+     * Triggered when the user cancels an upload in progress. Useful for custom cancellation logic.
+     *
+     * Example:
+     * ```jsx
+     * <Upload onCancel={(event) => console.log('Upload canceled')} />
+     * ```
+     */
+    onCancel?: (event: UploadOnCancelEvent) => void;
+}

package/interfaces/UploadResponse.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Represents the response type of the Upload.
+ */
+export interface UploadResponse {
+    /**
+     * The response that was provided by the server.
+     */
+    response: any;
+    /**
+     * The HTTP status code from the server response.
+     */
+    status: number;
+    /**
+     * The HTTP status message from the server response.
+     */
+    statusText: string;
+    /**
+     * The headers with which the server responded.
+     */
+    headers: any;
+    /**
+     * The XMLHttpRequest instance of the browser.
+     */
+    request?: XMLHttpRequest;
+}

package/interfaces/UploadSelectMessageProps.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Represents the props of the UI component that is inside the Upload add button.
+ */
+export interface UploadSelectMessageProps {
+    /**
+     * The `select` localized message.
+     */
+    message: any;
+}

package/messages/index.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ */
+export declare const cancel = "upload.cancel";
+/**
+ * @hidden
+ */
+export declare const clearSelectedFiles = "upload.clearSelectedFiles";
+/**
+ * @hidden
+ */
+export declare const dropFilesHere = "upload.dropFilesHere";
+/**
+ * @hidden
+ */
+export declare const headerStatusUploaded = "upload.headerStatusUploaded";
+/**
+ * @hidden
+ */
+export declare const headerStatusUploading = "upload.headerStatusUploading";
+/**
+ * @hidden
+ */
+export declare const invalidFileExtension = "upload.invalidFileExtension";
+/**
+ * @hidden
+ */
+export declare const invalidFiles = "upload.invalidFiles";
+/**
+ * @hidden
+ */
+export declare const invalidMaxFileSize = "upload.invalidMaxFileSize";
+/**
+ * @hidden
+ */
+export declare const invalidMinFileSize = "upload.invalidMinFileSize";
+/**
+ * @hidden
+ */
+export declare const remove = "upload.remove";
+/**
+ * @hidden
+ */
+export declare const retry = "upload.retry";
+/**
+ * @hidden
+ */
+export declare const select = "upload.select";
+/**
+ * @hidden
+ */
+export declare const selectTitle = "upload.selectTitle";
+/**
+ * @hidden
+ */
+export declare const selectNoFilesTitle = "upload.selectNoFilesTitle";
+/**
+ * @hidden
+ */
+export declare const uploadSelectedFiles = "upload.uploadSelectedFiles";
+/**
+ * @hidden
+ */
+export declare const total = "upload.total";
+/**
+ * @hidden
+ */
+export declare const files = "upload.files";
+/**
+ * @hidden
+ */
+export declare const statusUploaded = "upload.statusUploaded";
+/**
+ * @hidden
+ */
+export declare const statusUploadFailed = "upload.statusUploadFailed";
+/**
+ * @hidden
+ */
+export declare const dropZoneHint = "upload.dropZoneHint";
+/**
+ * @hidden
+ */
+export declare const dropZoneNote = "upload.defaultDropZoneNote";
+/**
+ * @hidden
+ */
+export declare const restrictionsDropZoneNote = "upload.dropZoneNote";
+/**
+ * @hidden
+ */
+export declare const messages: {
+    "upload.cancel": string;
+    "upload.clearSelectedFiles": string;
+    "upload.dropFilesHere": string;
+    "upload.headerStatusUploaded": string;
+    "upload.headerStatusUploading": string;
+    "upload.invalidFileExtension": string;
+    "upload.invalidFiles": string;
+    "upload.invalidMaxFileSize": string;
+    "upload.invalidMinFileSize": string;
+    "upload.remove": string;
+    "upload.retry": string;
+    "upload.select": string;
+    "upload.selectTitle": string;
+    "upload.selectNoFilesTitle": string;
+    "upload.uploadSelectedFiles": string;
+    "upload.total": string;
+    "upload.files": string;
+    "upload.statusUploaded": string;
+    "upload.statusUploadFailed": string;
+    "upload.dropZoneHint": string;
+    "upload.defaultDropZoneNote": string;
+    "upload.dropZoneNote": string;
+};

package/package-metadata.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PackageMetadata } from '@progress/kendo-licensing';
+/**
+ * @hidden
+ */
+export declare const packageMetadata: PackageMetadata;

package/package-metadata.js

@@ -5,4 +5,4 @@
  * Licensed under commercial license. See LICENSE.md in the package root for more information
  *-------------------------------------------------------------------------------------------
  */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({name:"@progress/kendo-react-upload",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1768491099,version:"13.3.0-develop.9",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"});exports.packageMetadata=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({name:"@progress/kendo-react-upload",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1770218902,version:"13.4.0-develop.1",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"});exports.packageMetadata=e;

package/package-metadata.mjs

@@ -1,19 +1,13 @@
+// Generated file. DO NOT EDIT.
 /**
- * @license
- *-------------------------------------------------------------------------------------------
- * Copyright © 2026 Progress Software Corporation. All rights reserved.
- * Licensed under commercial license. See LICENSE.md in the package root for more information
- *-------------------------------------------------------------------------------------------
+ * @hidden
  */
-const e = Object.freeze({
-  name: "@progress/kendo-react-upload",
-  productName: "KendoReact",
-  productCode: "KENDOUIREACT",
-  productCodes: ["KENDOUIREACT"],
-  publishDate: 1768491099,
-  version: "13.3.0-develop.9",
-  licensingDocsUrl: "https://www.telerik.com/kendo-react-ui/components/my-license/"
+export const packageMetadata = Object.freeze({
+    name: '@progress/kendo-react-upload',
+    productName: 'KendoReact',
+    productCode: 'KENDOUIREACT',
+    productCodes: ['KENDOUIREACT'],
+    publishDate: 0,
+    version: '13.4.0-develop.1',
+    licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/components/my-license/'
 });
-export {
-  e as packageMetadata
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-upload",
-  "version": "13.3.0-develop.9",
+  "version": "13.4.0-develop.1",
   "description": "React Upload component helps users transfer files from their file systems to dedicated server handlers. KendoReact Upload package",
   "author": "Progress",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -26,10 +26,10 @@
   "sideEffects": false,
   "peerDependencies": {
     "@progress/kendo-licensing": "^1.7.2",
-    "@progress/kendo-react-buttons": "13.3.0-develop.9",
-    "@progress/kendo-react-common": "13.3.0-develop.9",
-    "@progress/kendo-react-intl": "13.3.0-develop.9",
-    "@progress/kendo-react-progressbars": "13.3.0-develop.9",
+    "@progress/kendo-react-buttons": "13.4.0-develop.1",
+    "@progress/kendo-react-common": "13.4.0-develop.1",
+    "@progress/kendo-react-intl": "13.4.0-develop.1",
+    "@progress/kendo-react-progressbars": "13.4.0-develop.1",
     "@progress/kendo-svg-icons": "^4.0.0",
     "axios": "^1.13.2",
     "react": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc",
@@ -56,7 +56,7 @@
     "package": {
       "productName": "KendoReact",
       "productCode": "KENDOUIREACT",
-      "publishDate": 1768491099,
+      "publishDate": 1770218902,
       "licensingDocsUrl": "https://www.telerik.com/kendo-react-ui/components/my-license/"
     }
   },

package/utils/connectionUtils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { UploadFileInfo } from '../interfaces/UploadFileInfo.js';
+import { UploadAsyncProps } from '../interfaces/UploadAsyncProps.js';
+import { UploadHttpHeaders } from '../interfaces/UploadHttpHeaders.js';
+import { AxiosResponse } from 'axios';
+import { UploadResponse } from '../interfaces/UploadResponse.js';
+declare const _default: {
+    populateClientFormData: (data: FormData, clientData: any) => void;
+    populateUploadFormData: (files: UploadFileInfo[], saveField: string, clientData: Object) => FormData;
+    populateRemoveFormData: (fileNames: string[], removeField: string, clientData: Object) => FormData;
+    populateRequestOptions: (headers: UploadHttpHeaders, async: UploadAsyncProps) => any;
+    cloneRequestHeaders: (headers: UploadHttpHeaders) => UploadHttpHeaders;
+    convertAxiosResponse: (event: AxiosResponse<any, any, {}>) => UploadResponse;
+};
+export default _default;

package/utils/stateUtils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { UploadFileInfo } from '../interfaces/UploadFileInfo.js';
+import { UploadFileStatus } from '../interfaces/UploadFileStatus.js';
+import { GroupedFiles } from '../interfaces/FileGroup.js';
+declare const _default: {
+    copyState: (state: UploadFileInfo[] | undefined) => {
+        uid: string;
+        name: string;
+        extension?: string | undefined;
+        size?: number | undefined;
+        validationErrors?: string[] | undefined;
+        status: UploadFileStatus;
+        progress: number;
+        getRawFile?: (() => File) | undefined;
+    }[];
+    addMany: (fileList: UploadFileInfo[], filesState: UploadFileInfo[]) => void;
+    add: (file: UploadFileInfo, filesState: UploadFileInfo[]) => void;
+    groupFilesByUid: (files: UploadFileInfo[]) => GroupedFiles;
+    filesForUpload: (files: GroupedFiles) => GroupedFiles;
+    setFilesStatus: (filesGroup: GroupedFiles, status: UploadFileStatus) => void;
+    flatFileGroup: (fileGroup: GroupedFiles) => UploadFileInfo[];
+    groupForEach: (fileGroup: GroupedFiles, callBack: (currentFiles: UploadFileInfo[], uid: string) => void) => void;
+};
+export default _default;

package/utils/utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { UploadFileInfo } from '../interfaces/UploadFileInfo.js';
+import { GroupedFiles } from '../interfaces/FileGroup.js';
+declare const _default: {
+    fileHasValidationErrors: Function;
+    filesHaveValidationErrors: Function;
+    getTotalFilesSizeMessage: Function;
+    getAllFileInfo: Function;
+    getFileInfo: Function;
+    getFileExtension: Function;
+    htmlEncode: Function;
+    assignGuidToFiles: Function;
+    getFileStatus: (currentFiles: GroupedFiles | UploadFileInfo[]) => boolean[];
+};
+export default _default;

package/utils/validationUtils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+declare const _default: {
+    validateFiles: Function;
+};
+export default _default;