/**
 * @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} />
     * ```
     *
     * @remarks
     * This property is related to accessibility.
     */
    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" />
     * ```
     *
     * @remarks
     * This property is related to accessibility.
     */
    ariaDescribedBy?: string;
    /**
     * Identifies elements that label the Upload component, similar to the `aria-labelledby` attribute.
     *
     * Example:
     * ```jsx
     * <Upload ariaLabelledBy="upload-label" />
     * ```
     *
     * @remarks
     * This property is related to accessibility.
     */
    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;
}