@vaadin/upload 25.1.2 → 25.2.0-alpha10

package/custom-elements.json

@@ -140,6 +140,18 @@
               "description": "Capture attribute for mobile file input.",
               "fieldName": "capture"
             },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "fieldName": "disabled",
+              "inheritedFrom": {
+                "name": "DisabledMixin",
+                "package": "@vaadin/a11y-base/src/disabled-mixin.js"
+              }
+            },
             {
               "name": "manager",
               "type": {
@@ -332,7 +344,7 @@
               "type": {
                 "text": "Object"
               },
-              "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nShould be overridden by subclasses to provide a custom JSDoc with the\ndefault I18N properties.",
+              "description": "The object used to localize this component.\nTo change the default localization, replace this with an object\nthat provides all properties, or just the individual properties\nyou want to change.\n\nThe object has the following JSON structure and default values:\n```js\n{\n  file: {\n    retry: 'Retry',\n    start: 'Start',\n    remove: 'Remove'\n  },\n  error: {\n    tooManyFiles: 'Too Many Files.',\n    fileIsTooBig: 'File is Too Big.',\n    incorrectFileType: 'Incorrect File Type.'\n  },\n  uploading: {\n    status: {\n      connecting: 'Connecting...',\n      stalled: 'Stalled',\n      processing: 'Processing File...',\n      held: 'Queued'\n    },\n    remainingTime: {\n      prefix: 'remaining time: ',\n      unknown: 'unknown remaining time'\n    },\n    error: {\n      serverUnavailable: 'Upload failed, please try again later',\n      unexpectedServerError: 'Upload failed due to server error',\n      forbidden: 'Upload forbidden',\n      fileTooLarge: 'File is too large'\n    }\n  },\n  units: {\n    size: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']\n  }\n}\n```",
               "attribute": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
@@ -454,7 +466,7 @@
               "type": {
                 "text": "Object"
               },
-              "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nShould be overridden by subclasses to provide a custom JSDoc with the\ndefault I18N properties.",
+              "description": "The object used to localize this component.\nTo change the default localization, replace this with an object\nthat provides all properties, or just the individual properties\nyou want to change.\n\nThe object has the following JSON structure and default values:\n```js\n{\n  file: {\n    retry: 'Retry',\n    start: 'Start',\n    remove: 'Remove'\n  },\n  error: {\n    tooManyFiles: 'Too Many Files.',\n    fileIsTooBig: 'File is Too Big.',\n    incorrectFileType: 'Incorrect File Type.'\n  },\n  uploading: {\n    status: {\n      connecting: 'Connecting...',\n      stalled: 'Stalled',\n      processing: 'Processing File...',\n      held: 'Queued'\n    },\n    remainingTime: {\n      prefix: 'remaining time: ',\n      unknown: 'unknown remaining time'\n    },\n    error: {\n      serverUnavailable: 'Upload failed, please try again later',\n      unexpectedServerError: 'Upload failed due to server error',\n      forbidden: 'Upload forbidden',\n      fileTooLarge: 'File is too large'\n    }\n  },\n  units: {\n    size: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']\n  }\n}\n```",
               "attribute": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
@@ -964,21 +976,21 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when the abort button is pressed.",
+              "description": "Fired when the abort button is pressed to request aborting the upload of this file.",
               "name": "file-abort"
             },
             {
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when the retry button is pressed.",
+              "description": "Fired when the retry button is pressed to request retrying the upload of this file.",
               "name": "file-retry"
             },
             {
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when the start button is pressed.",
+              "description": "Fired when the start button is pressed to request starting the upload of this file.",
               "name": "file-start"
             }
           ],
@@ -1510,7 +1522,7 @@
               "type": {
                 "text": "Object"
               },
-              "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following JSON structure and default values:\n\n```js\n{\n  dropFiles: {\n    one: 'Drop file here',\n    many: 'Drop files here'\n  },\n  addFiles: {\n    one: 'Upload File...',\n    many: 'Upload Files...'\n  },\n  error: {\n    tooManyFiles: 'Too Many Files.',\n    fileIsTooBig: 'File is Too Big.',\n    incorrectFileType: 'Incorrect File Type.'\n  },\n  uploading: {\n    status: {\n      connecting: 'Connecting...',\n      stalled: 'Stalled',\n      processing: 'Processing File...',\n      held: 'Queued'\n    },\n    remainingTime: {\n      prefix: 'remaining time: ',\n      unknown: 'unknown remaining time'\n    },\n    error: {\n      serverUnavailable: 'Upload failed, please try again later',\n      unexpectedServerError: 'Upload failed due to server error',\n      forbidden: 'Upload forbidden'\n    }\n  },\n  file: {\n    retry: 'Retry',\n    start: 'Start',\n    remove: 'Remove'\n  },\n  units: {\n    size: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'],\n    sizeBase: 1000\n  },\n  formatSize: function(bytes) {\n    // returns the size followed by the best suitable unit\n  },\n  formatTime: function(seconds, [secs, mins, hours]) {\n    // returns a 'HH:MM:SS' string\n  }\n}\n```",
+              "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following JSON structure and default values:\n\n```js\n{\n  dropFiles: {\n    one: 'Drop file here',\n    many: 'Drop files here'\n  },\n  addFiles: {\n    one: 'Upload File...',\n    many: 'Upload Files...'\n  },\n  error: {\n    tooManyFiles: 'Too Many Files.',\n    fileIsTooBig: 'File is Too Big.',\n    incorrectFileType: 'Incorrect File Type.'\n  },\n  uploading: {\n    status: {\n      connecting: 'Connecting...',\n      stalled: 'Stalled',\n      processing: 'Processing File...',\n      held: 'Queued'\n    },\n    remainingTime: {\n      prefix: 'remaining time: ',\n      unknown: 'unknown remaining time'\n    },\n    error: {\n      serverUnavailable: 'Upload failed, please try again later',\n      unexpectedServerError: 'Upload failed due to server error',\n      forbidden: 'Upload forbidden',\n      fileTooLarge: 'File is too large'\n    }\n  },\n  file: {\n    retry: 'Retry',\n    start: 'Start',\n    remove: 'Remove'\n  },\n  units: {\n    size: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'],\n    sizeBase: 1000\n  },\n  formatSize: function(bytes) {\n    // returns the size followed by the best suitable unit\n  },\n  formatTime: function(seconds, [secs, mins, hours]) {\n    // returns a 'HH:MM:SS' string\n  }\n}\n```",
               "attribute": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
@@ -1977,7 +1989,7 @@
               "type": {
                 "text": "Object"
               },
-              "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following JSON structure and default values:\n\n```js\n{\n  dropFiles: {\n    one: 'Drop file here',\n    many: 'Drop files here'\n  },\n  addFiles: {\n    one: 'Upload File...',\n    many: 'Upload Files...'\n  },\n  error: {\n    tooManyFiles: 'Too Many Files.',\n    fileIsTooBig: 'File is Too Big.',\n    incorrectFileType: 'Incorrect File Type.'\n  },\n  uploading: {\n    status: {\n      connecting: 'Connecting...',\n      stalled: 'Stalled',\n      processing: 'Processing File...',\n      held: 'Queued'\n    },\n    remainingTime: {\n      prefix: 'remaining time: ',\n      unknown: 'unknown remaining time'\n    },\n    error: {\n      serverUnavailable: 'Upload failed, please try again later',\n      unexpectedServerError: 'Upload failed due to server error',\n      forbidden: 'Upload forbidden'\n    }\n  },\n  file: {\n    retry: 'Retry',\n    start: 'Start',\n    remove: 'Remove'\n  },\n  units: {\n    size: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'],\n    sizeBase: 1000\n  },\n  formatSize: function(bytes) {\n    // returns the size followed by the best suitable unit\n  },\n  formatTime: function(seconds, [secs, mins, hours]) {\n    // returns a 'HH:MM:SS' string\n  }\n}\n```",
+              "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following JSON structure and default values:\n\n```js\n{\n  dropFiles: {\n    one: 'Drop file here',\n    many: 'Drop files here'\n  },\n  addFiles: {\n    one: 'Upload File...',\n    many: 'Upload Files...'\n  },\n  error: {\n    tooManyFiles: 'Too Many Files.',\n    fileIsTooBig: 'File is Too Big.',\n    incorrectFileType: 'Incorrect File Type.'\n  },\n  uploading: {\n    status: {\n      connecting: 'Connecting...',\n      stalled: 'Stalled',\n      processing: 'Processing File...',\n      held: 'Queued'\n    },\n    remainingTime: {\n      prefix: 'remaining time: ',\n      unknown: 'unknown remaining time'\n    },\n    error: {\n      serverUnavailable: 'Upload failed, please try again later',\n      unexpectedServerError: 'Upload failed due to server error',\n      forbidden: 'Upload forbidden',\n      fileTooLarge: 'File is too large'\n    }\n  },\n  file: {\n    retry: 'Retry',\n    start: 'Start',\n    remove: 'Remove'\n  },\n  units: {\n    size: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'],\n    sizeBase: 1000\n  },\n  formatSize: function(bytes) {\n    // returns the size followed by the best suitable unit\n  },\n  formatTime: function(seconds, [secs, mins, hours]) {\n    // returns a 'HH:MM:SS' string\n  }\n}\n```",
               "attribute": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
@@ -2166,7 +2178,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when a file cannot be added to the queue due to a constrain.",
+              "description": "Fired when a file cannot be added to the queue due to a constraint: file size, file type, or maxFiles.",
               "inheritedFrom": {
                 "name": "UploadMixin",
                 "module": "src/vaadin-upload-mixin.js"
@@ -2202,7 +2214,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when upload abort is requested.",
+              "description": "Fired when upload abort is requested. If the default is prevented, the upload is not aborted.",
               "inheritedFrom": {
                 "name": "UploadMixin",
                 "module": "src/vaadin-upload-mixin.js"
@@ -2213,7 +2225,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired before the XHR is opened.",
+              "description": "Fired before the XHR is opened. Useful for changing the request URL. If the default is prevented, the XHR is not opened.",
               "inheritedFrom": {
                 "name": "UploadMixin",
                 "module": "src/vaadin-upload-mixin.js"
@@ -2223,7 +2235,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired in case the upload process failed.",
+              "description": "Fired when the upload process fails.",
               "name": "upload-error"
             },
             {
@@ -2242,7 +2254,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when the XHR has been opened but not sent yet.",
+              "description": "Fired when the XHR has been opened but not sent yet. Useful for appending data to the FormData or modifying request parameters. If the default is prevented, the request is not sent.",
               "inheritedFrom": {
                 "name": "UploadMixin",
                 "module": "src/vaadin-upload-mixin.js"
@@ -2253,7 +2265,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when on the server response before analyzing it.",
+              "description": "Fired when the server response is received, before the component analyzes it. If the default is prevented, the component returns and the listener can handle `xhr` and `file` directly; otherwise the normal flow checks `xhr.status` and `file.error`, which can be modified to force a custom outcome.",
               "inheritedFrom": {
                 "name": "UploadMixin",
                 "module": "src/vaadin-upload-mixin.js"
@@ -2264,7 +2276,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when retry upload is requested.",
+              "description": "Fired when retry upload is requested. If the default is prevented, the retry is not performed.",
               "inheritedFrom": {
                 "name": "UploadMixin",
                 "module": "src/vaadin-upload-mixin.js"
@@ -2285,7 +2297,7 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired in case the upload process succeeded.",
+              "description": "Fired when the upload process succeeds.",
               "name": "upload-success"
             }
           ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/upload",
-  "version": "25.1.2",
+  "version": "25.2.0-alpha10",
   "publishConfig": {
     "access": "public"
   },
@@ -35,19 +35,19 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/a11y-base": "~25.1.2",
-    "@vaadin/button": "~25.1.2",
-    "@vaadin/component-base": "~25.1.2",
-    "@vaadin/progress-bar": "~25.1.2",
-    "@vaadin/vaadin-themable-mixin": "~25.1.2",
+    "@vaadin/a11y-base": "25.2.0-alpha10",
+    "@vaadin/button": "25.2.0-alpha10",
+    "@vaadin/component-base": "25.2.0-alpha10",
+    "@vaadin/progress-bar": "25.2.0-alpha10",
+    "@vaadin/vaadin-themable-mixin": "25.2.0-alpha10",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/aura": "~25.1.2",
-    "@vaadin/chai-plugins": "~25.1.2",
-    "@vaadin/test-runner-commands": "~25.1.2",
+    "@vaadin/aura": "25.2.0-alpha10",
+    "@vaadin/chai-plugins": "25.2.0-alpha10",
+    "@vaadin/test-runner-commands": "25.2.0-alpha10",
     "@vaadin/testing-helpers": "^2.0.0",
-    "@vaadin/vaadin-lumo-styles": "~25.1.2",
+    "@vaadin/vaadin-lumo-styles": "25.2.0-alpha10",
     "sinon": "^21.0.2"
   },
   "customElements": "custom-elements.json",
@@ -55,5 +55,5 @@
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "48e5dc507ac5eb8d34839be06cac652f1635fe1c"
+  "gitHead": "1303b6a3eeecb44a9d26f2b53cb56d9e906febdf"
 }

package/src/styles/vaadin-upload-file-base-styles.js

@@ -34,7 +34,6 @@ export const uploadFileStyles = [
       grid-column: 1;
     }
 
-    :host([uploading]) [part='loader'],
     [part='done-icon']:not([hidden]),
     [part='warning-icon']:not([hidden]) {
       display: flex;

package/src/vaadin-upload-file-list-mixin.d.ts

@@ -69,6 +69,43 @@ export declare class UploadFileListMixinClass {
    * To change the default localization, replace this with an object
    * that provides all properties, or just the individual properties
    * you want to change.
+   *
+   * The object has the following JSON structure and default values:
+   * ```js
+   * {
+   *   file: {
+   *     retry: 'Retry',
+   *     start: 'Start',
+   *     remove: 'Remove'
+   *   },
+   *   error: {
+   *     tooManyFiles: 'Too Many Files.',
+   *     fileIsTooBig: 'File is Too Big.',
+   *     incorrectFileType: 'Incorrect File Type.'
+   *   },
+   *   uploading: {
+   *     status: {
+   *       connecting: 'Connecting...',
+   *       stalled: 'Stalled',
+   *       processing: 'Processing File...',
+   *       held: 'Queued'
+   *     },
+   *     remainingTime: {
+   *       prefix: 'remaining time: ',
+   *       unknown: 'unknown remaining time'
+   *     },
+   *     error: {
+   *       serverUnavailable: 'Upload failed, please try again later',
+   *       unexpectedServerError: 'Upload failed due to server error',
+   *       forbidden: 'Upload forbidden',
+   *       fileTooLarge: 'File is too large'
+   *     }
+   *   },
+   *   units: {
+   *     size: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
+   *   }
+   * }
+   * ```
    */
   i18n: UploadFileListI18n;
 }

package/src/vaadin-upload-file-list-mixin.js

@@ -86,6 +86,58 @@ export const UploadFileListMixin = (superClass) =>
       return ['__updateItems(items, __effectiveI18n, disabled, _theme)'];
     }
 
+    /**
+     * The object used to localize this component.
+     * To change the default localization, replace this with an object
+     * that provides all properties, or just the individual properties
+     * you want to change.
+     *
+     * The object has the following JSON structure and default values:
+     * ```js
+     * {
+     *   file: {
+     *     retry: 'Retry',
+     *     start: 'Start',
+     *     remove: 'Remove'
+     *   },
+     *   error: {
+     *     tooManyFiles: 'Too Many Files.',
+     *     fileIsTooBig: 'File is Too Big.',
+     *     incorrectFileType: 'Incorrect File Type.'
+     *   },
+     *   uploading: {
+     *     status: {
+     *       connecting: 'Connecting...',
+     *       stalled: 'Stalled',
+     *       processing: 'Processing File...',
+     *       held: 'Queued'
+     *     },
+     *     remainingTime: {
+     *       prefix: 'remaining time: ',
+     *       unknown: 'unknown remaining time'
+     *     },
+     *     error: {
+     *       serverUnavailable: 'Upload failed, please try again later',
+     *       unexpectedServerError: 'Upload failed due to server error',
+     *       forbidden: 'Upload forbidden',
+     *       fileTooLarge: 'File is too large'
+     *     }
+     *   },
+     *   units: {
+     *     size: ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
+     *   }
+     * }
+     * ```
+     * @type {!UploadFileListI18n}
+     */
+    get i18n() {
+      return super.i18n;
+    }
+
+    set i18n(value) {
+      super.i18n = value;
+    }
+
     constructor() {
       super();
       this.__onManagerFilesChanged = this.__onManagerFilesChanged.bind(this);

package/src/vaadin-upload-file.d.ts

@@ -9,17 +9,17 @@ import { UploadFileMixin } from './vaadin-upload-file-mixin.js';
 export type { UploadFileI18n } from './vaadin-upload-file-mixin.js';
 
 /**
- * Fired when the retry button is pressed.
+ * Fired when the retry button is pressed to request retrying the upload of this file.
  */
 export type UploadFileRetryEvent = CustomEvent<{ file: File }>;
 
 /**
- * Fired when the start button is pressed.
+ * Fired when the start button is pressed to request starting the upload of this file.
  */
 export type UploadFileStartEvent = CustomEvent<{ file: File }>;
 
 /**
- * Fired when the abort button is pressed.
+ * Fired when the abort button is pressed to request aborting the upload of this file.
  */
 export type UploadFileAbortEvent = CustomEvent<{ file: File }>;
 
@@ -97,9 +97,9 @@ export interface UploadFileEventMap extends HTMLElementEventMap, UploadFileCusto
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
- * @fires {CustomEvent} file-abort - Fired when the abort button is pressed.
- * @fires {CustomEvent} file-retry - Fired when the retry button is pressed.
- * @fires {CustomEvent} file-start - Fired when the start button is pressed.
+ * @fires {CustomEvent} file-abort - Fired when the abort button is pressed to request aborting the upload of this file.
+ * @fires {CustomEvent} file-retry - Fired when the retry button is pressed to request retrying the upload of this file.
+ * @fires {CustomEvent} file-start - Fired when the start button is pressed to request starting the upload of this file.
  */
 declare class UploadFile extends UploadFileMixin(ThemableMixin(HTMLElement)) {
   addEventListener<K extends keyof UploadFileEventMap>(

package/src/vaadin-upload-file.js

@@ -77,9 +77,9 @@ import { UploadFileMixin } from './vaadin-upload-file-mixin.js';
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
- * @fires {CustomEvent} file-abort - Fired when the abort button is pressed.
- * @fires {CustomEvent} file-retry - Fired when the retry button is pressed.
- * @fires {CustomEvent} file-start - Fired when the start button is pressed.
+ * @fires {CustomEvent} file-abort - Fired when the abort button is pressed to request aborting the upload of this file.
+ * @fires {CustomEvent} file-retry - Fired when the retry button is pressed to request retrying the upload of this file.
+ * @fires {CustomEvent} file-start - Fired when the start button is pressed to request starting the upload of this file.
  *
  * @customElement vaadin-upload-file
  * @extends HTMLElement
@@ -157,33 +157,6 @@ class UploadFile extends UploadFileMixin(ThemableMixin(PolylitMixin(LumoInjectio
       <slot name="progress"></slot>
     `;
   }
-
-  /**
-   * Fired when the retry button is pressed. It is listened by `vaadin-upload`
-   * which will start a new upload process of this file.
-   *
-   * @event file-retry
-   * @param {Object} detail
-   * @param {Object} detail.file file to retry upload of
-   */
-
-  /**
-   * Fired when the start button is pressed. It is listened by `vaadin-upload`
-   * which will start a new upload process of this file.
-   *
-   * @event file-start
-   * @param {Object} detail
-   * @param {Object} detail.file file to start upload of
-   */
-
-  /**
-   * Fired when abort button is pressed. It is listened by `vaadin-upload` which
-   * will abort the upload in progress, and then remove the file from the list.
-   *
-   * @event file-abort
-   * @param {Object} detail
-   * @param {Object} detail.file file to abort upload of
-   */
 }
 
 defineCustomElement(UploadFile);

package/src/vaadin-upload-helpers.js

@@ -33,7 +33,7 @@ export function getFilesFromDropEvent(dropEvent) {
     .filter((item) => !!item)
     .filter((item) => typeof item.webkitGetAsEntry === 'function')
     .map((item) => item.webkitGetAsEntry())
-    .some((entry) => !!entry && entry.isDirectory);
+    .some((entry) => !!entry?.isDirectory);
 
   if (!containsFolders) {
     return Promise.resolve(dropEvent.dataTransfer.files ? Array.from(dropEvent.dataTransfer.files) : []);

package/src/vaadin-upload-manager.js

@@ -4,8 +4,8 @@
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 
-window.Vaadin = window.Vaadin || {};
-window.Vaadin.featureFlags = window.Vaadin.featureFlags || {};
+window.Vaadin ||= {};
+window.Vaadin.featureFlags ||= {};
 
 /**
  * A pure JavaScript class that manages file upload state and XHR requests.

package/src/vaadin-upload-mixin.d.ts

@@ -252,7 +252,8 @@ export declare class UploadMixinClass {
    *     error: {
    *       serverUnavailable: 'Upload failed, please try again later',
    *       unexpectedServerError: 'Upload failed due to server error',
-   *       forbidden: 'Upload forbidden'
+   *       forbidden: 'Upload forbidden',
+   *       fileTooLarge: 'File is too large'
    *     }
    *   },
    *   file: {

package/src/vaadin-upload-mixin.js

@@ -411,7 +411,8 @@ export const UploadMixin = (superClass) =>
      *     error: {
      *       serverUnavailable: 'Upload failed, please try again later',
      *       unexpectedServerError: 'Upload failed due to server error',
-     *       forbidden: 'Upload forbidden'
+     *       forbidden: 'Upload forbidden',
+     *       fileTooLarge: 'File is too large'
      *     }
      *   },
      *   file: {

package/src/vaadin-upload.d.ts

@@ -197,19 +197,19 @@ export interface UploadEventMap extends HTMLElementEventMap, UploadCustomEventMa
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
- * @fires {CustomEvent} file-reject - Fired when a file cannot be added to the queue due to a constrain.
+ * @fires {CustomEvent} file-reject - Fired when a file cannot be added to the queue due to a constraint: file size, file type, or maxFiles.
  * @fires {CustomEvent} file-remove - Fired when a file is removed from the list.
  * @fires {CustomEvent} files-changed - Fired when the `files` property changes.
  * @fires {CustomEvent} max-files-reached-changed - Fired when the `maxFilesReached` property changes.
- * @fires {CustomEvent} upload-before - Fired before the XHR is opened.
+ * @fires {CustomEvent} upload-before - Fired before the XHR is opened. Useful for changing the request URL. If the default is prevented, the XHR is not opened.
  * @fires {CustomEvent} upload-start - Fired when the XHR is sent.
  * @fires {CustomEvent} upload-progress - Fired as many times as the progress is updated.
- * @fires {CustomEvent} upload-success - Fired in case the upload process succeeded.
- * @fires {CustomEvent} upload-error - Fired in case the upload process failed.
- * @fires {CustomEvent} upload-request - Fired when the XHR has been opened but not sent yet.
- * @fires {CustomEvent} upload-response - Fired when on the server response before analyzing it.
- * @fires {CustomEvent} upload-retry - Fired when retry upload is requested.
- * @fires {CustomEvent} upload-abort - Fired when upload abort is requested.
+ * @fires {CustomEvent} upload-success - Fired when the upload process succeeds.
+ * @fires {CustomEvent} upload-error - Fired when the upload process fails.
+ * @fires {CustomEvent} upload-request - Fired when the XHR has been opened but not sent yet. Useful for appending data to the FormData or modifying request parameters. If the default is prevented, the request is not sent.
+ * @fires {CustomEvent} upload-response - Fired when the server response is received, before the component analyzes it. If the default is prevented, the component returns and the listener can handle `xhr` and `file` directly; otherwise the normal flow checks `xhr.status` and `file.error`, which can be modified to force a custom outcome.
+ * @fires {CustomEvent} upload-retry - Fired when retry upload is requested. If the default is prevented, the retry is not performed.
+ * @fires {CustomEvent} upload-abort - Fired when upload abort is requested. If the default is prevented, the upload is not aborted.
  */
 declare class Upload extends UploadMixin(ThemableMixin(ElementMixin(HTMLElement))) {
   addEventListener<K extends keyof UploadEventMap>(

package/src/vaadin-upload.js

@@ -88,19 +88,19 @@ import { UploadMixin } from './vaadin-upload-mixin.js';
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
- * @fires {CustomEvent} file-reject - Fired when a file cannot be added to the queue due to a constrain.
+ * @fires {CustomEvent} file-reject - Fired when a file cannot be added to the queue due to a constraint: file size, file type, or maxFiles.
  * @fires {CustomEvent} file-remove - Fired when a file is removed from the list.
  * @fires {CustomEvent} files-changed - Fired when the `files` property changes.
  * @fires {CustomEvent} max-files-reached-changed - Fired when the `maxFilesReached` property changes.
- * @fires {CustomEvent} upload-before - Fired before the XHR is opened.
+ * @fires {CustomEvent} upload-before - Fired before the XHR is opened. Useful for changing the request URL. If the default is prevented, the XHR is not opened.
  * @fires {CustomEvent} upload-start - Fired when the XHR is sent.
  * @fires {CustomEvent} upload-progress - Fired as many times as the progress is updated.
- * @fires {CustomEvent} upload-success - Fired in case the upload process succeeded.
- * @fires {CustomEvent} upload-error - Fired in case the upload process failed.
- * @fires {CustomEvent} upload-request - Fired when the XHR has been opened but not sent yet.
- * @fires {CustomEvent} upload-response - Fired when on the server response before analyzing it.
- * @fires {CustomEvent} upload-retry - Fired when retry upload is requested.
- * @fires {CustomEvent} upload-abort - Fired when upload abort is requested.
+ * @fires {CustomEvent} upload-success - Fired when the upload process succeeds.
+ * @fires {CustomEvent} upload-error - Fired when the upload process fails.
+ * @fires {CustomEvent} upload-request - Fired when the XHR has been opened but not sent yet. Useful for appending data to the FormData or modifying request parameters. If the default is prevented, the request is not sent.
+ * @fires {CustomEvent} upload-response - Fired when the server response is received, before the component analyzes it. If the default is prevented, the component returns and the listener can handle `xhr` and `file` directly; otherwise the normal flow checks `xhr.status` and `file.error`, which can be modified to force a custom outcome.
+ * @fires {CustomEvent} upload-retry - Fired when retry upload is requested. If the default is prevented, the retry is not performed.
+ * @fires {CustomEvent} upload-abort - Fired when upload abort is requested. If the default is prevented, the upload is not aborted.
  *
  * @customElement vaadin-upload
  * @extends HTMLElement
@@ -144,112 +144,6 @@ class Upload extends UploadMixin(ElementMixin(ThemableMixin(PolylitMixin(LumoInj
       />
     `;
   }
-
-  /**
-   * Fired when a file cannot be added to the queue due to a constrain:
-   *  file-size, file-type or maxFiles
-   *
-   * @event file-reject
-   * @param {Object} detail
-   * @param {Object} detail.file the file added
-   * @param {string} detail.error the cause
-   */
-
-  /**
-   * Fired before the XHR is opened. Could be used for changing the request
-   * URL. If the default is prevented, then XHR would not be opened.
-   *
-   * @event upload-before
-   * @param {Object} detail
-   * @param {Object} detail.xhr the xhr
-   * @param {Object} detail.file the file being uploaded
-   * @param {Object} detail.file.uploadTarget the upload request URL, initialized with the value of vaadin-upload `target` property
-   */
-
-  /**
-   * Fired when the XHR has been opened but not sent yet. Useful for appending
-   * data keys to the FormData object, for changing some parameters like
-   * headers, etc. If the event is defaultPrevented, `vaadin-upload` will not
-   * send the request allowing the user to do something on his own.
-   *
-   * @event upload-request
-   * @param {Object} detail
-   * @param {Object} detail.xhr the xhr
-   * @param {Object} detail.file the file being uploaded
-   * @param {Object} detail.formData the FormData object
-   */
-
-  /**
-   * Fired when the XHR is sent.
-   *
-   * @event upload-start
-   * @param {Object} detail
-   * @param {Object} detail.xhr the xhr
-   * @param {Object} detail.file the file being uploaded
-   */
-
-  /**
-   * Fired as many times as the progress is updated.
-   *
-   * @event upload-progress
-   * @param {Object} detail
-   * @param {Object} detail.xhr the xhr
-   * @param {Object} detail.file the file being uploaded with loaded info
-   */
-
-  /**
-   * Fired when we have the actual server response, and before the component
-   * analyses it. It's useful for developers to make the upload fail depending
-   * on the server response. If the event is defaultPrevented the vaadin-upload
-   * will return allowing the user to do something on his own like retry the
-   * upload, etc. since he has full access to the `xhr` and `file` objects.
-   * Otherwise, if the event is not prevented default `vaadin-upload` continues
-   * with the normal workflow checking the `xhr.status` and `file.error`
-   * which also might be modified by the user to force a customized response.
-   *
-   * @event upload-response
-   * @param {Object} detail
-   * @param {Object} detail.xhr the xhr
-   * @param {Object} detail.file the file being uploaded
-   */
-
-  /**
-   * Fired in case the upload process succeed.
-   *
-   * @event upload-success
-   * @param {Object} detail
-   * @param {Object} detail.xhr the xhr
-   * @param {Object} detail.file the file being uploaded with loaded info
-   */
-
-  /**
-   * Fired in case the upload process failed.
-   *
-   * @event upload-error
-   * @param {Object} detail
-   * @param {Object} detail.xhr the xhr
-   * @param {Object} detail.file the file being uploaded
-   */
-
-  /**
-   * Fired when retry upload is requested. If the default is prevented, then
-   * retry would not be performed.
-   *
-   * @event upload-retry
-   * @param {Object} detail
-   * @param {Object} detail.xhr the previous upload xhr
-   * @param {Object} detail.file the file being uploaded
-   */
-
-  /**
-   * Fired when retry abort is requested. If the default is prevented, then the
-   * file upload would not be aborted.
-   *
-   * @event upload-abort
-   * @param {Object} detail
-   * @param {Object} detail.xhr the xhr
-   * @param {Object} detail.file the file being uploaded
-   */
 }
 
 defineCustomElement(Upload);