@vaadin/upload 25.1.0-beta2 → 25.1.0-beta3

package/custom-elements.json

@@ -328,10 +328,12 @@
             {
               "kind": "field",
               "name": "i18n",
-              "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.",
+              "privacy": "public",
               "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.",
+              "attribute": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
                 "package": "@vaadin/component-base/src/i18n-mixin.js"
@@ -370,6 +372,11 @@
             },
             {
               "name": "i18n",
+              "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.",
+              "fieldName": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
                 "package": "@vaadin/component-base/src/i18n-mixin.js"
@@ -443,10 +450,12 @@
             {
               "kind": "field",
               "name": "i18n",
-              "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.",
+              "privacy": "public",
               "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.",
+              "attribute": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
                 "package": "@vaadin/component-base/src/i18n-mixin.js"
@@ -517,6 +526,11 @@
             },
             {
               "name": "i18n",
+              "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.",
+              "fieldName": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
                 "package": "@vaadin/component-base/src/i18n-mixin.js"
@@ -945,6 +959,29 @@
               }
             }
           ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the abort button is pressed.",
+              "name": "file-abort"
+            },
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the retry button is pressed.",
+              "name": "file-retry"
+            },
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the start button is pressed.",
+              "name": "file-start"
+            }
+          ],
           "mixins": [
             {
               "name": "UploadFileMixin",
@@ -1078,8 +1115,7 @@
                 "module": "src/vaadin-upload-file-mixin.js"
               }
             }
-          ],
-          "events": []
+          ]
         }
       ],
       "exports": [
@@ -1272,12 +1308,6 @@
               "description": "Fired when disabled changes",
               "name": "disabled-changed"
             },
-            {
-              "name": "eventName",
-              "type": {
-                "text": "CustomEvent"
-              }
-            },
             {
               "name": "file-reject",
               "type": {
@@ -1427,6 +1457,9 @@
               "kind": "field",
               "name": "capture",
               "privacy": "public",
+              "type": {
+                "text": "string"
+              },
               "description": "Pass-through to input's capture attribute. Allows user to trigger device inputs\nsuch as camera or microphone immediately.",
               "attribute": "capture"
             },
@@ -1473,10 +1506,12 @@
             {
               "kind": "field",
               "name": "i18n",
-              "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```",
+              "privacy": "public",
               "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```",
+              "attribute": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
                 "package": "@vaadin/component-base/src/i18n-mixin.js"
@@ -1528,7 +1563,7 @@
               "name": "method",
               "privacy": "public",
               "type": {
-                "text": "!UploadMethod"
+                "text": "string"
               },
               "description": "HTTP Method used to send the files. Only POST and PUT are allowed.",
               "attribute": "method"
@@ -1677,6 +1712,9 @@
             },
             {
               "name": "capture",
+              "type": {
+                "text": "string"
+              },
               "description": "Pass-through to input's capture attribute. Allows user to trigger device inputs\nsuch as camera or microphone immediately.",
               "fieldName": "capture"
             },
@@ -1698,6 +1736,11 @@
             },
             {
               "name": "i18n",
+              "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.",
+              "fieldName": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
                 "package": "@vaadin/component-base/src/i18n-mixin.js"
@@ -1738,7 +1781,7 @@
             {
               "name": "method",
               "type": {
-                "text": "!UploadMethod"
+                "text": "string"
               },
               "description": "HTTP Method used to send the files. Only POST and PUT are allowed.",
               "fieldName": "method"
@@ -1861,6 +1904,9 @@
               "kind": "field",
               "name": "capture",
               "privacy": "public",
+              "type": {
+                "text": "string"
+              },
               "description": "Pass-through to input's capture attribute. Allows user to trigger device inputs\nsuch as camera or microphone immediately.",
               "attribute": "capture",
               "inheritedFrom": {
@@ -1927,10 +1973,12 @@
             {
               "kind": "field",
               "name": "i18n",
-              "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```",
+              "privacy": "public",
               "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```",
+              "attribute": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
                 "package": "@vaadin/component-base/src/i18n-mixin.js"
@@ -1998,7 +2046,7 @@
               "name": "method",
               "privacy": "public",
               "type": {
-                "text": "!UploadMethod"
+                "text": "string"
               },
               "description": "HTTP Method used to send the files. Only POST and PUT are allowed.",
               "attribute": "method",
@@ -2129,6 +2177,7 @@
               "type": {
                 "text": "CustomEvent"
               },
+              "description": "Fired when a file is removed from the list.",
               "inheritedFrom": {
                 "name": "UploadMixin",
                 "module": "src/vaadin-upload-mixin.js"
@@ -2283,6 +2332,9 @@
             },
             {
               "name": "capture",
+              "type": {
+                "text": "string"
+              },
               "description": "Pass-through to input's capture attribute. Allows user to trigger device inputs\nsuch as camera or microphone immediately.",
               "fieldName": "capture",
               "inheritedFrom": {
@@ -2316,6 +2368,11 @@
             },
             {
               "name": "i18n",
+              "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.",
+              "fieldName": "i18n",
               "inheritedFrom": {
                 "name": "I18nMixin",
                 "package": "@vaadin/component-base/src/i18n-mixin.js"
@@ -2372,7 +2429,7 @@
             {
               "name": "method",
               "type": {
-                "text": "!UploadMethod"
+                "text": "string"
               },
               "description": "HTTP Method used to send the files. Only POST and PUT are allowed.",
               "fieldName": "method",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/upload",
-  "version": "25.1.0-beta2",
+  "version": "25.1.0-beta3",
   "publishConfig": {
     "access": "public"
   },
@@ -35,25 +35,25 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/a11y-base": "25.1.0-beta2",
-    "@vaadin/button": "25.1.0-beta2",
-    "@vaadin/component-base": "25.1.0-beta2",
-    "@vaadin/progress-bar": "25.1.0-beta2",
-    "@vaadin/vaadin-themable-mixin": "25.1.0-beta2",
+    "@vaadin/a11y-base": "25.1.0-beta3",
+    "@vaadin/button": "25.1.0-beta3",
+    "@vaadin/component-base": "25.1.0-beta3",
+    "@vaadin/progress-bar": "25.1.0-beta3",
+    "@vaadin/vaadin-themable-mixin": "25.1.0-beta3",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/aura": "25.1.0-beta2",
-    "@vaadin/chai-plugins": "25.1.0-beta2",
-    "@vaadin/test-runner-commands": "25.1.0-beta2",
+    "@vaadin/aura": "25.1.0-beta3",
+    "@vaadin/chai-plugins": "25.1.0-beta3",
+    "@vaadin/test-runner-commands": "25.1.0-beta3",
     "@vaadin/testing-helpers": "^2.0.0",
-    "@vaadin/vaadin-lumo-styles": "25.1.0-beta2",
-    "sinon": "^21.0.0"
+    "@vaadin/vaadin-lumo-styles": "25.1.0-beta3",
+    "sinon": "^21.0.2"
   },
   "customElements": "custom-elements.json",
   "web-types": [
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "ffbedbae08a5160d13bcd1c6fcaa328df5103a05"
+  "gitHead": "4251850231a42298fda23b83928da588831cdb5d"
 }

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

@@ -96,6 +96,10 @@ export interface UploadFileEventMap extends HTMLElementEventMap, UploadFileCusto
  * `--vaadin-upload-file-warning-color`         |
  *
  * 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.
  */
 declare class UploadFile extends UploadFileMixin(ThemableMixin(HTMLElement)) {
   addEventListener<K extends keyof UploadFileEventMap>(

package/src/vaadin-upload-file.js

@@ -77,6 +77,10 @@ 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.
+ *
  * @customElement vaadin-upload-file
  * @extends HTMLElement
  * @mixes UploadFileMixin

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

@@ -273,7 +273,6 @@ export declare class UploadMixinClass {
    * }
    * ```
    *
-   * @type {!UploadI18n}
    * @default {English}
    */
   i18n: UploadI18n;

package/src/vaadin-upload-mixin.js

@@ -147,7 +147,6 @@ export const UploadMixin = (superClass) =>
 
         /**
          * HTTP Method used to send the files. Only POST and PUT are allowed.
-         * @type {!UploadMethod}
          */
         method: {
           type: String,
@@ -329,7 +328,9 @@ export const UploadMixin = (superClass) =>
          * Pass-through to input's capture attribute. Allows user to trigger device inputs
          * such as camera or microphone immediately.
          */
-        capture: String,
+        capture: {
+          type: String,
+        },
 
         /** @private */
         _addButton: {

package/src/vaadin-upload.d.ts

@@ -77,6 +77,11 @@ export type UploadRetryEvent = UploadEvent<{ xhr: XMLHttpRequest; file: UploadFi
  */
 export type UploadAbortEvent = UploadEvent<{ xhr: XMLHttpRequest; file: UploadFile }>;
 
+/**
+ * Fired when a file is removed from the list.
+ */
+export type UploadFileRemoveEvent = UploadEvent<{ file: UploadFile }>;
+
 /**
  * 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
@@ -94,6 +99,8 @@ export type UploadRequestEvent = UploadEvent<{
 export interface UploadCustomEventMap {
   'file-reject': UploadFileRejectEvent;
 
+  'file-remove': UploadFileRemoveEvent;
+
   'files-changed': UploadFilesChangedEvent;
 
   'max-files-reached-changed': UploadMaxFilesReachedChangedEvent;
@@ -191,6 +198,7 @@ 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-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.

package/src/vaadin-upload.js

@@ -89,6 +89,7 @@ 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-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.

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/upload",
-  "version": "25.1.0-beta2",
+  "version": "25.1.0-beta3",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -448,6 +448,17 @@
                 ]
               }
             },
+            {
+              "name": "i18n",
+              "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.",
+              "value": {
+                "type": [
+                  "Object",
+                  "null",
+                  "undefined"
+                ]
+              }
+            },
             {
               "name": "theme",
               "description": "The theme variants to apply to the component.",
@@ -478,7 +489,9 @@
                 "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.",
                 "value": {
                   "type": [
-                    "?"
+                    "Object",
+                    "null",
+                    "undefined"
                   ]
                 }
               },
@@ -593,7 +606,9 @@
               "description": "HTTP Method used to send the files. Only POST and PUT are allowed.",
               "value": {
                 "type": [
-                  "UploadMethod"
+                  "string",
+                  "null",
+                  "undefined"
                 ]
               }
             },
@@ -787,7 +802,9 @@
                 "description": "HTTP Method used to send the files. Only POST and PUT are allowed.",
                 "value": {
                   "type": [
-                    "UploadMethod"
+                    "string",
+                    "null",
+                    "undefined"
                   ]
                 }
               },

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/upload",
-  "version": "25.1.0-beta2",
+  "version": "25.1.0-beta3",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {