From f448dadd293a149e5aa7e3ec837379c4ab6bac38 Mon Sep 17 00:00:00 2001
From: Artur- <260340+Artur-@users.noreply.github.com>
Date: Tue, 22 Sep 2026 10:14:32 +0000
Subject: [PATCH] docs: reconcile @since tags

Automated reconciliation against the published release history:
add missing tags, correct wrong ones, create minimal @since javadoc
for undocumented types, and remove redundant tags.
---
 .../com/vaadin/browserless/BaseBrowserlessTest.java    |  4 ++++
 .../browserless/BrowserlessApplicationContext.java     |  7 +++++++
 .../com/vaadin/browserless/BrowserlessUIContext.java   |  2 ++
 .../vaadin/browserless/CommercialTesterWrappers.java   |  4 +++-
 .../java/com/vaadin/browserless/ComponentQuery.java    |  1 +
 .../java/com/vaadin/browserless/ComponentTester.java   | 10 ++++++++++
 .../SecuredBrowserlessApplicationContext.java          |  7 +++++++
 .../java/com/vaadin/browserless/TesterWrappers.java    |  6 ++++++
 .../browserless/internal/GridContextMenuSupport.java   |  2 ++
 .../browserless/internal/MenuItemNavigation.java       |  2 ++
 .../browserless/internal/RenderedComponentSupport.java |  2 ++
 .../java/com/vaadin/browserless/locator/Locator.java   |  1 +
 .../java/com/vaadin/flow/component/TextTester.java     |  1 +
 .../flow/component/accordion/AccordionTester.java      |  3 +++
 .../flow/component/avatar/AvatarGroupTester.java       |  1 +
 .../flow/component/breadcrumbs/BreadcrumbsTester.java  |  1 +
 .../com/vaadin/flow/component/card/CardTester.java     |  1 +
 .../vaadin/flow/component/checkbox/CheckboxTester.java |  5 +++++
 .../vaadin/flow/component/checkbox/SwitchTester.java   |  1 +
 .../vaadin/flow/component/combobox/ComboBoxTester.java |  1 +
 .../component/combobox/MultiSelectComboBoxTester.java  |  1 +
 .../flow/component/contextmenu/ContextMenuTester.java  |  2 ++
 .../flow/component/dashboard/DashboardTester.java      |  2 +-
 .../flow/component/datepicker/DatePickerTester.java    |  3 +++
 .../component/datetimepicker/DateTimePickerTester.java |  2 ++
 .../com/vaadin/flow/component/dialog/DialogTester.java |  5 +++++
 .../com/vaadin/flow/component/grid/GridTester.java     |  6 ++++++
 .../grid/contextmenu/GridContextMenuTester.java        |  1 +
 .../vaadin/flow/component/gridpro/GridProTester.java   |  1 +
 .../flow/component/login/LoginOverlayTester.java       |  2 ++
 .../vaadin/flow/component/markdown/MarkdownTester.java |  1 +
 .../vaadin/flow/component/menubar/MenuBarTester.java   |  2 ++
 .../flow/component/splitlayout/SplitLayoutTester.java  |  1 +
 .../flow/component/textfield/NumberFieldTester.java    |  7 +++++++
 .../flow/component/textfield/TextAreaTester.java       |  2 ++
 .../flow/component/textfield/TextFieldTester.java      |  1 +
 .../flow/component/timepicker/TimePickerTester.java    |  3 +++
 .../vaadin/flow/component/treegrid/TreeGridTester.java |  1 +
 .../com/vaadin/flow/component/upload/UploadTester.java |  7 +++++++
 39 files changed, 110 insertions(+), 2 deletions(-)

diff --git a/shared/src/main/java/com/vaadin/browserless/BaseBrowserlessTest.java b/shared/src/main/java/com/vaadin/browserless/BaseBrowserlessTest.java
index 274f39b2..e5bb70c0 100644
--- a/shared/src/main/java/com/vaadin/browserless/BaseBrowserlessTest.java
+++ b/shared/src/main/java/com/vaadin/browserless/BaseBrowserlessTest.java
@@ -94,6 +94,7 @@ protected void initVaadinEnvironment() {
      *
      * @return the set of services implementation classes, never
      *         {@literal null}.
+     * @since 25.3
      */
     protected final Set<Class<?>> allLookupServices() {
         return allLookupServices(testConfiguration());
@@ -117,6 +118,7 @@ protected final Set<Class<?>> allLookupServices() {
      *            {@literal null}
      * @return the set of services implementation classes, never
      *         {@literal null}.
+     * @since 25.3
      */
     @SuppressWarnings("deprecation")
     protected final Set<Class<?>> allLookupServices(
@@ -368,6 +370,7 @@ public <T extends Component> T navigate(String location,
      * their component instance and state; other views are recreated.
      *
      * @return the view shown after the reload
+     * @since 25.4
      */
     public HasElement reload() {
         return BrowserlessDSL.reload(verifyAndGetUI());
@@ -382,6 +385,7 @@ public HasElement reload() {
      * @param <T>
      *            the view type
      * @return the view shown after the reload
+     * @since 25.4
      */
     public <T extends Component> T reload(Class<T> expectedTarget) {
         return BrowserlessDSL.reload(verifyAndGetUI(), expectedTarget);
diff --git a/shared/src/main/java/com/vaadin/browserless/BrowserlessApplicationContext.java b/shared/src/main/java/com/vaadin/browserless/BrowserlessApplicationContext.java
index d285cbfc..df31eb2b 100644
--- a/shared/src/main/java/com/vaadin/browserless/BrowserlessApplicationContext.java
+++ b/shared/src/main/java/com/vaadin/browserless/BrowserlessApplicationContext.java
@@ -554,6 +554,7 @@ Set<Class<?>> getLookupServices() {
          * @throws IllegalArgumentException
          *             if the name is blank or reserved by the browserless
          *             environment
+         * @since 25.3
          */
         public Builder withApplicationProperty(String name, String value) {
             configuration.withApplicationProperty(name, value);
@@ -570,6 +571,7 @@ public Builder withApplicationProperty(String name, String value) {
          * @throws IllegalArgumentException
          *             if a name is blank or reserved by the browserless
          *             environment
+         * @since 25.3
          */
         public Builder withApplicationProperties(
                 Map<String, String> properties) {
@@ -587,6 +589,7 @@ public Builder withApplicationProperties(
          *            the identifiers of the features to enable; must not be
          *            {@code null}
          * @return this builder
+         * @since 25.3
          */
         public Builder withFeatureFlags(String... featureIds) {
             configuration.withFeatureFlags(featureIds);
@@ -602,6 +605,7 @@ public Builder withFeatureFlags(String... featureIds) {
          * @param features
          *            the features to enable; must not be {@code null}
          * @return this builder
+         * @since 25.3
          */
         public Builder withFeatureFlags(Feature... features) {
             configuration.withFeatureFlags(features);
@@ -620,6 +624,7 @@ public Builder withFeatureFlags(Feature... features) {
          *            {@code true} to enable the feature, {@code false} to
          *            disable it
          * @return this builder
+         * @since 25.3
          */
         public Builder withFeatureFlag(String featureId, boolean enabled) {
             configuration.withFeatureFlag(featureId, enabled);
@@ -638,6 +643,7 @@ public Builder withFeatureFlag(String featureId, boolean enabled) {
          *            {@code true} to enable the feature, {@code false} to
          *            disable it
          * @return this builder
+         * @since 25.3
          */
         public Builder withFeatureFlag(Feature feature, boolean enabled) {
             configuration.withFeatureFlag(feature, enabled);
@@ -659,6 +665,7 @@ public Builder withFeatureFlag(Feature feature, boolean enabled) {
          * @param testConfiguration
          *            the configuration to apply; must not be {@code null}
          * @return this builder
+         * @since 25.3
          */
         public Builder withConfiguration(
                 BrowserlessConfiguration testConfiguration) {
diff --git a/shared/src/main/java/com/vaadin/browserless/BrowserlessUIContext.java b/shared/src/main/java/com/vaadin/browserless/BrowserlessUIContext.java
index f186da9c..6c7760a2 100644
--- a/shared/src/main/java/com/vaadin/browserless/BrowserlessUIContext.java
+++ b/shared/src/main/java/com/vaadin/browserless/BrowserlessUIContext.java
@@ -438,6 +438,7 @@ public HasElement getCurrentView() {
      * their component instance and state; other views are recreated.
      *
      * @return the view shown after the reload
+     * @since 25.4
      */
     public HasElement reload() {
         activate();
@@ -453,6 +454,7 @@ public HasElement reload() {
      * @param <T>
      *            the view type
      * @return the view shown after the reload
+     * @since 25.4
      */
     public <T extends Component> T reload(Class<T> expectedTarget) {
         activate();
diff --git a/shared/src/main/java/com/vaadin/browserless/CommercialTesterWrappers.java b/shared/src/main/java/com/vaadin/browserless/CommercialTesterWrappers.java
index 00841248..d711e4e4 100644
--- a/shared/src/main/java/com/vaadin/browserless/CommercialTesterWrappers.java
+++ b/shared/src/main/java/com/vaadin/browserless/CommercialTesterWrappers.java
@@ -36,6 +36,7 @@ public interface CommercialTesterWrappers {
      * @param grid
      *            the GridPro instance to be tested
      * @return a GridProTester instance wrapping the given GridPro
+     * @since 25.3
      */
     default <V> GridProTester<GridPro<V>, V> test(GridPro<V> grid) {
         return BaseBrowserlessTest.internalWrap(GridProTester.class, grid);
@@ -49,6 +50,7 @@ default <V> GridProTester<GridPro<V>, V> test(GridPro<V> grid) {
      * @param itemType
      *            the type of the items in the GridPro
      * @return a GridProTester instance wrapping the given GridPro
+     * @since 25.3
      */
     default <V> GridProTester<GridPro<V>, V> test(GridPro grid,
             Class<V> itemType) {
@@ -72,7 +74,7 @@ default ChartTester<Chart> test(Chart chart) {
      * @param dashboard
      *            the dashboard instance to be tested
      * @return a DashboardTester instance wrapping the given dashboard
-     * @since 1.1
+     * @since 1.1.2
      */
     default DashboardTester<Dashboard> test(Dashboard dashboard) {
         return BaseBrowserlessTest.internalWrap(DashboardTester.class,
diff --git a/shared/src/main/java/com/vaadin/browserless/ComponentQuery.java b/shared/src/main/java/com/vaadin/browserless/ComponentQuery.java
index 6a9d55de..fb557db0 100644
--- a/shared/src/main/java/com/vaadin/browserless/ComponentQuery.java
+++ b/shared/src/main/java/com/vaadin/browserless/ComponentQuery.java
@@ -701,6 +701,7 @@ public ComponentQuery<T> withoutAttribute(String attribute, String value) {
      * @return this element query instance for chaining
      * @throws IllegalArgumentException
      *             if {@code slot} is {@literal null} or blank
+     * @since 25.3
      */
     public ComponentQuery<T> withinSlot(String slot) {
         if (slot == null || slot.isBlank()) {
diff --git a/shared/src/main/java/com/vaadin/browserless/ComponentTester.java b/shared/src/main/java/com/vaadin/browserless/ComponentTester.java
index 737e8f23..98048058 100644
--- a/shared/src/main/java/com/vaadin/browserless/ComponentTester.java
+++ b/shared/src/main/java/com/vaadin/browserless/ComponentTester.java
@@ -106,6 +106,7 @@ public boolean isUsable() {
      * change its value, so it is considered not usable.
      *
      * @return {@code true} if the component is read-only
+     * @since 25.3
      */
     protected boolean isComponentReadOnly() {
         return getComponent() instanceof HasValue<?, ?> hasValue
@@ -200,6 +201,7 @@ public final void ensureComponentIsUsable() {
      * @throws IllegalStateException
      *             if the component is not usable, with details on its current
      *             state.
+     * @since 25.3
      */
     protected void ensureComponentIsUsableOrDetach() {
         try {
@@ -320,6 +322,7 @@ protected static void ensureVisible(Component component) {
      * @throws IllegalStateException
      *             if the component cannot accept focus in its current state,
      *             for example because it is disabled or not attached
+     * @since 25.4
      */
     public void focus() {
         ensureComponentCanBeFocused();
@@ -332,6 +335,7 @@ public void focus() {
      * {@link Focusable#focus()} calls.
      *
      * @return {@code true} if the component is focused
+     * @since 25.4
      */
     public boolean isFocused() {
         return component.getUI().flatMap(FocusTracker::getFocusedComponent)
@@ -353,6 +357,7 @@ public boolean isFocused() {
      * @throws IllegalStateException
      *             if the component cannot accept focus in its current state,
      *             for example because it is disabled or not attached
+     * @since 25.4
      */
     public void blur() {
         ensureComponentCanBeFocused();
@@ -603,6 +608,7 @@ private <V> AbstractFieldSupport<?, V> getFieldSupport(Object target) {
      *             if the component is not usable
      * @throws IllegalArgumentException
      *             if the component does not hold a value
+     * @since 25.3
      */
     protected void clearAsUser() {
         ensureComponentIsUsable();
@@ -628,6 +634,7 @@ protected void clearAsUser() {
      *             visible
      * @throws IllegalArgumentException
      *             if the component does not hold a value
+     * @since 25.3
      */
     protected void clickClearButtonAsUser() {
         ensureComponentIsUsable();
@@ -683,6 +690,7 @@ protected <V> void setValueAsUser(V value) {
      *            the field to set the value to, not {@literal null}.
      * @param value
      *            the new value, may be null.
+     * @since 25.3
      */
     protected <V> void setValueAsUser(HasValue<?, V> field, V value) {
         final AbstractFieldSupport<?, V> fs = getFieldSupport(field);
@@ -712,6 +720,7 @@ protected <V> void setValueAsUser(HasValue<?, V> field, V value) {
      * @param field
      *            the field to check, not {@literal null}.
      * @return {@literal true} if the value can be set as a user
+     * @since 25.3
      */
     protected boolean canSetValueAsUser(HasValue<?, ?> field) {
         return field instanceof AbstractField
@@ -733,6 +742,7 @@ protected boolean canSetValueAsUser(HasValue<?, ?> field) {
      *            the value as the client would send it, may be null.
      * @throws IllegalStateException
      *             if the property does not accept updates from the client
+     * @since 25.3
      */
     protected void setPropertyAsUser(String property, Serializable value) {
         try {
diff --git a/shared/src/main/java/com/vaadin/browserless/SecuredBrowserlessApplicationContext.java b/shared/src/main/java/com/vaadin/browserless/SecuredBrowserlessApplicationContext.java
index f5e867e6..98dc72eb 100644
--- a/shared/src/main/java/com/vaadin/browserless/SecuredBrowserlessApplicationContext.java
+++ b/shared/src/main/java/com/vaadin/browserless/SecuredBrowserlessApplicationContext.java
@@ -217,6 +217,7 @@ public Builder<C> withCloseHook(Runnable hook) {
 
         /**
          * @see BrowserlessApplicationContext.Builder#withApplicationProperty
+         * @since 25.3
          */
         public Builder<C> withApplicationProperty(String name, String value) {
             base.withApplicationProperty(name, value);
@@ -225,6 +226,7 @@ public Builder<C> withApplicationProperty(String name, String value) {
 
         /**
          * @see BrowserlessApplicationContext.Builder#withApplicationProperties
+         * @since 25.3
          */
         public Builder<C> withApplicationProperties(
                 Map<String, String> properties) {
@@ -234,6 +236,7 @@ public Builder<C> withApplicationProperties(
 
         /**
          * @see BrowserlessApplicationContext.Builder#withFeatureFlags(String...)
+         * @since 25.3
          */
         public Builder<C> withFeatureFlags(String... featureIds) {
             base.withFeatureFlags(featureIds);
@@ -242,6 +245,7 @@ public Builder<C> withFeatureFlags(String... featureIds) {
 
         /**
          * @see BrowserlessApplicationContext.Builder#withFeatureFlags(Feature...)
+         * @since 25.3
          */
         public Builder<C> withFeatureFlags(Feature... features) {
             base.withFeatureFlags(features);
@@ -251,6 +255,7 @@ public Builder<C> withFeatureFlags(Feature... features) {
         /**
          * @see BrowserlessApplicationContext.Builder#withFeatureFlag(String,
          *      boolean)
+         * @since 25.3
          */
         public Builder<C> withFeatureFlag(String featureId, boolean enabled) {
             base.withFeatureFlag(featureId, enabled);
@@ -260,6 +265,7 @@ public Builder<C> withFeatureFlag(String featureId, boolean enabled) {
         /**
          * @see BrowserlessApplicationContext.Builder#withFeatureFlag(Feature,
          *      boolean)
+         * @since 25.3
          */
         public Builder<C> withFeatureFlag(Feature feature, boolean enabled) {
             base.withFeatureFlag(feature, enabled);
@@ -268,6 +274,7 @@ public Builder<C> withFeatureFlag(Feature feature, boolean enabled) {
 
         /**
          * @see BrowserlessApplicationContext.Builder#withConfiguration
+         * @since 25.3
          */
         public Builder<C> withConfiguration(
                 BrowserlessConfiguration configuration) {
diff --git a/shared/src/main/java/com/vaadin/browserless/TesterWrappers.java b/shared/src/main/java/com/vaadin/browserless/TesterWrappers.java
index c3c9cd4d..1f8ada9a 100644
--- a/shared/src/main/java/com/vaadin/browserless/TesterWrappers.java
+++ b/shared/src/main/java/com/vaadin/browserless/TesterWrappers.java
@@ -180,6 +180,7 @@ default AccordionTester<Accordion> test(Accordion accordion) {
      * @param avatarGroup
      *            the component to wrap
      * @return a tester for the given component
+     * @since 25.3
      */
     default AvatarGroupTester<AvatarGroup> test(AvatarGroup avatarGroup) {
         return BaseBrowserlessTest.internalWrap(AvatarGroupTester.class,
@@ -201,6 +202,7 @@ default ButtonTester<Button> test(Button button) {
      * @param card
      *            the component to wrap
      * @return a tester for the given component
+     * @since 25.3
      */
     default CardTester<Card> test(Card card) {
         return BaseBrowserlessTest.internalWrap(CardTester.class, card);
@@ -293,6 +295,7 @@ default <V> GridTester<Grid<V>, V> test(Grid grid, Class<V> itemType) {
      *            the type of the items in the grid the menu is attached to
      * @return a GridContextMenuTester instance wrapping the given
      *         GridContextMenu
+     * @since 25.3
      */
     default <V> GridContextMenuTester<GridContextMenu<V>, V> test(
             GridContextMenu<V> gridContextMenu) {
@@ -457,6 +460,7 @@ default IntegerSliderTester<IntegerSlider> test(
      * @param splitLayout
      *            the component to wrap
      * @return a tester for the given component
+     * @since 25.3
      */
     default SplitLayoutTester<SplitLayout> test(SplitLayout splitLayout) {
         return BaseBrowserlessTest.internalWrap(SplitLayoutTester.class,
@@ -532,6 +536,7 @@ default TimePickerTester<TimePicker> test(TimePicker timePicker) {
      * @param <V>
      *            the type of the items in the TreeGrid
      * @return a TreeGridTester instance wrapping the given TreeGrid
+     * @since 25.3
      */
     default <V> TreeGridTester<TreeGrid<V>, V> test(TreeGrid<V> treeGrid) {
         return BaseBrowserlessTest.internalWrap(TreeGridTester.class, treeGrid);
@@ -553,6 +558,7 @@ default <V> TreeGridTester<TreeGrid<V>, V> test(TreeGrid<V> treeGrid) {
      * @param <V>
      *            the type of the items in the TreeGrid
      * @return a TreeGridTester instance wrapping the given TreeGrid
+     * @since 25.3
      */
     default <V> TreeGridTester<TreeGrid<V>, V> test(TreeGrid treeGrid,
             Class<V> itemType) {
diff --git a/shared/src/main/java/com/vaadin/browserless/internal/GridContextMenuSupport.java b/shared/src/main/java/com/vaadin/browserless/internal/GridContextMenuSupport.java
index 294133f5..7c1a8f30 100644
--- a/shared/src/main/java/com/vaadin/browserless/internal/GridContextMenuSupport.java
+++ b/shared/src/main/java/com/vaadin/browserless/internal/GridContextMenuSupport.java
@@ -33,6 +33,8 @@
  * connector does.
  * <p>
  * For internal use only.
+ * 
+ * @since 25.3
  */
 public final class GridContextMenuSupport {
 
diff --git a/shared/src/main/java/com/vaadin/browserless/internal/MenuItemNavigation.java b/shared/src/main/java/com/vaadin/browserless/internal/MenuItemNavigation.java
index b6164bb1..fd3fff2b 100644
--- a/shared/src/main/java/com/vaadin/browserless/internal/MenuItemNavigation.java
+++ b/shared/src/main/java/com/vaadin/browserless/internal/MenuItemNavigation.java
@@ -33,6 +33,8 @@
  * since a user cannot click anything else.
  * <p>
  * For internal use only.
+ * 
+ * @since 25.3
  */
 public final class MenuItemNavigation {
 
diff --git a/shared/src/main/java/com/vaadin/browserless/internal/RenderedComponentSupport.java b/shared/src/main/java/com/vaadin/browserless/internal/RenderedComponentSupport.java
index eb4261ba..6cfedb9a 100644
--- a/shared/src/main/java/com/vaadin/browserless/internal/RenderedComponentSupport.java
+++ b/shared/src/main/java/com/vaadin/browserless/internal/RenderedComponentSupport.java
@@ -32,6 +32,8 @@
  * the client has asked for.
  * <p>
  * For internal use only.
+ * 
+ * @since 25.3
  */
 public final class RenderedComponentSupport {
 
diff --git a/shared/src/main/java/com/vaadin/browserless/locator/Locator.java b/shared/src/main/java/com/vaadin/browserless/locator/Locator.java
index 00c839c6..3d252d32 100644
--- a/shared/src/main/java/com/vaadin/browserless/locator/Locator.java
+++ b/shared/src/main/java/com/vaadin/browserless/locator/Locator.java
@@ -181,6 +181,7 @@ public SELF withoutAttribute(String attribute, String value) {
      * {@link ComponentQuery#withinSlot(String)} for annotated component trees.
      *
      * @see ComponentQuery#withinSlot(String)
+     * @since 25.3
      */
     public SELF withinSlot(String slot) {
         resetCache();
diff --git a/shared/src/main/java/com/vaadin/flow/component/TextTester.java b/shared/src/main/java/com/vaadin/flow/component/TextTester.java
index 374fe95a..64844012 100644
--- a/shared/src/main/java/com/vaadin/flow/component/TextTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/TextTester.java
@@ -31,6 +31,7 @@
  *
  * @param <T>
  *            component type
+ * @since 1.1.2
  */
 @Tests(Text.class)
 public class TextTester<T extends Text> extends ComponentTester<T> {
diff --git a/shared/src/main/java/com/vaadin/flow/component/accordion/AccordionTester.java b/shared/src/main/java/com/vaadin/flow/component/accordion/AccordionTester.java
index c91586d7..0adeb268 100644
--- a/shared/src/main/java/com/vaadin/flow/component/accordion/AccordionTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/accordion/AccordionTester.java
@@ -55,6 +55,7 @@ public void openDetails(String summary) {
      *
      * @throws IllegalStateException
      *             if the component is not usable or if no panel is open
+     * @since 25.3
      */
     public void closeDetails() {
         ensureComponentIsUsable();
@@ -76,6 +77,7 @@ public void closeDetails() {
      *             if no dropdown panel found for summary
      * @throws IllegalStateException
      *             if the component is not usable or if the panel is not open
+     * @since 25.3
      */
     public void closeDetails(String summary) {
         ensureComponentIsUsable();
@@ -99,6 +101,7 @@ public void closeDetails(String summary) {
      *             if no dropdown panel found for summary
      * @throws IllegalStateException
      *             if the component is not usable
+     * @since 25.3
      */
     public void toggleDetails(String summary) {
         ensureComponentIsUsable();
diff --git a/shared/src/main/java/com/vaadin/flow/component/avatar/AvatarGroupTester.java b/shared/src/main/java/com/vaadin/flow/component/avatar/AvatarGroupTester.java
index 7d1f5c62..21417abf 100644
--- a/shared/src/main/java/com/vaadin/flow/component/avatar/AvatarGroupTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/avatar/AvatarGroupTester.java
@@ -39,6 +39,7 @@
  *
  * @param <T>
  *            component type
+ * @since 25.3
  */
 @Tests(AvatarGroup.class)
 public class AvatarGroupTester<T extends AvatarGroup>
diff --git a/shared/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsTester.java b/shared/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsTester.java
index a42daf31..dc10997a 100644
--- a/shared/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsTester.java
@@ -57,6 +57,7 @@ public List<String> getItemTexts() {
      * from an empty string, which is the path of the application root.
      *
      * @return the item paths, with {@code null} for items that have no path
+     * @since 1.1.2
      */
     public List<String> getItemPaths() {
         ensureComponentIsUsable();
diff --git a/shared/src/main/java/com/vaadin/flow/component/card/CardTester.java b/shared/src/main/java/com/vaadin/flow/component/card/CardTester.java
index ebb4fbed..ab960a26 100644
--- a/shared/src/main/java/com/vaadin/flow/component/card/CardTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/card/CardTester.java
@@ -40,6 +40,7 @@
  *
  * @param <T>
  *            component type
+ * @since 25.3
  */
 @Tests(Card.class)
 public class CardTester<T extends Card> extends ComponentTester<T> {
diff --git a/shared/src/main/java/com/vaadin/flow/component/checkbox/CheckboxTester.java b/shared/src/main/java/com/vaadin/flow/component/checkbox/CheckboxTester.java
index e2615c58..307e4ed7 100644
--- a/shared/src/main/java/com/vaadin/flow/component/checkbox/CheckboxTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/checkbox/CheckboxTester.java
@@ -45,6 +45,7 @@ public CheckboxTester(T component) {
      * Checks whether the checkbox is currently checked.
      *
      * @return {@code true} if the checkbox is checked, {@code false} otherwise
+     * @since 25.3
      */
     public boolean isChecked() {
         return getComponent().getValue();
@@ -55,6 +56,8 @@ public boolean isChecked() {
      * <p>
      * Does nothing if the checkbox is already checked, since a user would not
      * click it in that case. The checkbox must be usable either way.
+     * 
+     * @since 25.3
      */
     public void check() {
         clickIfNot(true);
@@ -65,6 +68,8 @@ public void check() {
      * <p>
      * Does nothing if the checkbox is already unchecked, since a user would not
      * click it in that case. The checkbox must be usable either way.
+     * 
+     * @since 25.3
      */
     public void uncheck() {
         clickIfNot(false);
diff --git a/shared/src/main/java/com/vaadin/flow/component/checkbox/SwitchTester.java b/shared/src/main/java/com/vaadin/flow/component/checkbox/SwitchTester.java
index 80570460..bf07edd9 100644
--- a/shared/src/main/java/com/vaadin/flow/component/checkbox/SwitchTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/checkbox/SwitchTester.java
@@ -26,6 +26,7 @@
  *
  * @param <T>
  *            component type
+ * @since 25.3
  */
 @Tests(Switch.class)
 public class SwitchTester<T extends Switch> extends ComponentTester<T> {
diff --git a/shared/src/main/java/com/vaadin/flow/component/combobox/ComboBoxTester.java b/shared/src/main/java/com/vaadin/flow/component/combobox/ComboBoxTester.java
index 598f3159..85c996aa 100644
--- a/shared/src/main/java/com/vaadin/flow/component/combobox/ComboBoxTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/combobox/ComboBoxTester.java
@@ -135,6 +135,7 @@ public void selectItem(String selection) {
      * @throws IllegalStateException
      *             if the component is not usable, or its clear button is not
      *             visible
+     * @since 25.3
      */
     public void clickClearButton() {
         clickClearButtonAsUser();
diff --git a/shared/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxTester.java b/shared/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxTester.java
index 5a72b22c..89f39443 100644
--- a/shared/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxTester.java
@@ -113,6 +113,7 @@ public void selectItem(String... selection) {
      * @throws IllegalStateException
      *             if the component is not usable, or its clear button is not
      *             visible
+     * @since 25.3
      */
     public void clickClearButton() {
         clickClearButtonAsUser();
diff --git a/shared/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuTester.java b/shared/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuTester.java
index a047c07e..8981c11e 100644
--- a/shared/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuTester.java
@@ -428,6 +428,7 @@ public String getItemTooltipText(int topLevelPosition,
      *         are shown in
      * @throws IllegalStateException
      *             if the menu is not open, or is not visible
+     * @since 25.3
      */
     public List<String> getItemTexts() {
         ensureVisible();
@@ -475,6 +476,7 @@ public List<String> getItemTexts() {
      *             if the menu is not open or not visible, if there are multiple
      *             matching items at any level, or if the item at the given path
      *             is disabled or not visible.
+     * @since 25.3
      */
     public List<String> getItemTexts(String topLevelText,
             String... nestedItemsText) {
diff --git a/shared/src/main/java/com/vaadin/flow/component/dashboard/DashboardTester.java b/shared/src/main/java/com/vaadin/flow/component/dashboard/DashboardTester.java
index 4701467a..646285fe 100644
--- a/shared/src/main/java/com/vaadin/flow/component/dashboard/DashboardTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/dashboard/DashboardTester.java
@@ -39,7 +39,7 @@
  *
  * @param <T>
  *            the dashboard type
- * @since 1.1
+ * @since 1.1.2
  */
 @Tests(Dashboard.class)
 public class DashboardTester<T extends Dashboard> extends ComponentTester<T> {
diff --git a/shared/src/main/java/com/vaadin/flow/component/datepicker/DatePickerTester.java b/shared/src/main/java/com/vaadin/flow/component/datepicker/DatePickerTester.java
index 5dbd6502..148c1a30 100644
--- a/shared/src/main/java/com/vaadin/flow/component/datepicker/DatePickerTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/datepicker/DatePickerTester.java
@@ -74,6 +74,7 @@ public void setValue(LocalDate date) {
      *
      * @return {@code true} if the field is not marked invalid and its current
      *         value satisfies the constraints of the field
+     * @since 25.3
      */
     public boolean isValid() {
         final LocalDate date = getComponent().getValue();
@@ -91,6 +92,7 @@ public boolean isValid() {
      *
      * @throws IllegalStateException
      *             if the component is not usable
+     * @since 25.3
      */
     public void clear() {
         clearAsUser();
@@ -106,6 +108,7 @@ public void clear() {
      * @throws IllegalStateException
      *             if the component is not usable, or its clear button is not
      *             visible
+     * @since 25.3
      */
     public void clickClearButton() {
         clickClearButtonAsUser();
diff --git a/shared/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePickerTester.java b/shared/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePickerTester.java
index 40d84c22..e80816eb 100644
--- a/shared/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePickerTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePickerTester.java
@@ -74,6 +74,7 @@ public void setValue(LocalDateTime dateTime) {
      *
      * @return {@code true} if the field is not marked invalid and its current
      *         value satisfies the constraints of the field
+     * @since 25.3
      */
     public boolean isValid() {
         final LocalDateTime dateTime = getComponent().getValue();
@@ -91,6 +92,7 @@ public boolean isValid() {
      *
      * @throws IllegalStateException
      *             if the component is not usable
+     * @since 25.3
      */
     public void clear() {
         clearAsUser();
diff --git a/shared/src/main/java/com/vaadin/flow/component/dialog/DialogTester.java b/shared/src/main/java/com/vaadin/flow/component/dialog/DialogTester.java
index f5faf512..a5e3f631 100644
--- a/shared/src/main/java/com/vaadin/flow/component/dialog/DialogTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/dialog/DialogTester.java
@@ -83,6 +83,7 @@ public void close() {
      * @throws IllegalStateException
      *             if the dialog is not usable, e.g. not open, or close-on-Esc
      *             is disabled
+     * @since 25.3
      */
     public void pressEscape() {
         ensureComponentIsUsable();
@@ -103,6 +104,7 @@ public void pressEscape() {
      * @throws IllegalStateException
      *             if the dialog is not usable, e.g. not open, or
      *             close-on-outside-click is disabled
+     * @since 25.3
      */
     public void clickOutside() {
         ensureComponentIsUsable();
@@ -117,6 +119,7 @@ public void clickOutside() {
      * Check if the dialog is open.
      *
      * @return true if the dialog is open
+     * @since 25.3
      */
     public boolean isOpen() {
         return getComponent().isOpened();
@@ -150,6 +153,7 @@ protected void notUsableReasons(Consumer<String> collector) {
      * @return a query for components of the given type in the dialog's header
      * @throws IllegalStateException
      *             if the dialog is not usable, e.g. not open
+     * @since 25.3
      */
     public <R extends Component> ComponentQuery<R> findInHeader(
             Class<R> componentType) {
@@ -172,6 +176,7 @@ public <R extends Component> ComponentQuery<R> findInHeader(
      * @return a query for components of the given type in the dialog's footer
      * @throws IllegalStateException
      *             if the dialog is not usable, e.g. not open
+     * @since 25.3
      */
     public <R extends Component> ComponentQuery<R> findInFooter(
             Class<R> componentType) {
diff --git a/shared/src/main/java/com/vaadin/flow/component/grid/GridTester.java b/shared/src/main/java/com/vaadin/flow/component/grid/GridTester.java
index 858aafb3..cdd03d13 100644
--- a/shared/src/main/java/com/vaadin/flow/component/grid/GridTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/grid/GridTester.java
@@ -263,6 +263,7 @@ public void selectAll() {
      * @throws IllegalStateException
      *             if not usable, if the row is not selected or if the grid
      *             doesn't support selection
+     * @since 25.3
      */
     public void deselect(int row) {
         ensureComponentIsUsable();
@@ -285,6 +286,7 @@ public void deselect(int row) {
      * @throws IllegalStateException
      *             if not usable, not multi select or the select all checkbox is
      *             hidden
+     * @since 25.3
      */
     public void deselectAll() {
         ensureComponentIsUsable();
@@ -426,6 +428,7 @@ public Component getCellComponent(int row, String columnName) {
      * @throws IllegalArgumentException
      *             when the target column of the cell is not a component
      *             renderer
+     * @since 25.3
      */
     public Component renderCellComponent(int row, int column) {
         ensureVisible();
@@ -457,6 +460,7 @@ public Component renderCellComponent(int row, int column) {
      * @throws IllegalArgumentException
      *             when column for property doesn't exist or the target column
      *             of the cell is not a component renderer
+     * @since 25.3
      */
     public Component renderCellComponent(int row, String columnName) {
         ensureVisible();
@@ -703,6 +707,7 @@ public String getHeaderCell(int column) {
      * as in the grid.
      * 
      * @return visible columns in the grid
+     * @since 25.3
      */
     protected List<Grid.Column<Y>> getColumns() {
         return getComponent().getColumns().stream().filter(Component::isVisible)
@@ -965,6 +970,7 @@ private void doSort(SortDirection currentDirection, Grid.Column<Y> col) {
      * @throws IllegalStateException
      *             if the grid is not usable, or if it has no context menu or
      *             more than one
+     * @since 25.3
      */
     @SuppressWarnings("unchecked")
     public GridContextMenuTester<GridContextMenu<Y>, Y> contextMenu(int row) {
diff --git a/shared/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridContextMenuTester.java b/shared/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridContextMenuTester.java
index cf69c829..8eba6959 100644
--- a/shared/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridContextMenuTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridContextMenuTester.java
@@ -47,6 +47,7 @@
  *            component type
  * @param <Y>
  *            item type
+ * @since 25.3
  */
 @Tests(fqn = { "com.vaadin.flow.component.grid.contextmenu.GridContextMenu" })
 public class GridContextMenuTester<T extends GridContextMenu<Y>, Y>
diff --git a/shared/src/main/java/com/vaadin/flow/component/gridpro/GridProTester.java b/shared/src/main/java/com/vaadin/flow/component/gridpro/GridProTester.java
index 7c079d53..1ae0eb11 100644
--- a/shared/src/main/java/com/vaadin/flow/component/gridpro/GridProTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/gridpro/GridProTester.java
@@ -35,6 +35,7 @@
  *            component type
  * @param <Y>
  *            item type
+ * @since 25.3
  */
 @Tests(fqn = { "com.vaadin.flow.component.gridpro.GridPro" })
 public class GridProTester<T extends GridPro<Y>, Y> extends GridTester<T, Y> {
diff --git a/shared/src/main/java/com/vaadin/flow/component/login/LoginOverlayTester.java b/shared/src/main/java/com/vaadin/flow/component/login/LoginOverlayTester.java
index 7307f631..13e979e4 100644
--- a/shared/src/main/java/com/vaadin/flow/component/login/LoginOverlayTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/login/LoginOverlayTester.java
@@ -98,6 +98,7 @@ public boolean isOpen() {
      * @return a query for components of the given type in the overlay's footer
      * @throws IllegalStateException
      *             if the overlay is not usable, e.g. not open
+     * @since 25.3
      */
     public <R extends Component> ComponentQuery<R> findInFooter(
             Class<R> componentType) {
@@ -121,6 +122,7 @@ public <R extends Component> ComponentQuery<R> findInFooter(
      *         form area
      * @throws IllegalStateException
      *             if the overlay is not usable, e.g. not open
+     * @since 25.3
      */
     public <R extends Component> ComponentQuery<R> findInCustomFormArea(
             Class<R> componentType) {
diff --git a/shared/src/main/java/com/vaadin/flow/component/markdown/MarkdownTester.java b/shared/src/main/java/com/vaadin/flow/component/markdown/MarkdownTester.java
index 77f2bc8b..d08f648e 100644
--- a/shared/src/main/java/com/vaadin/flow/component/markdown/MarkdownTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/markdown/MarkdownTester.java
@@ -23,6 +23,7 @@
  *
  * @param <T>
  *            component type
+ * @since 1.1.2
  */
 @Tests(Markdown.class)
 public class MarkdownTester<T extends Markdown> extends ComponentTester<T> {
diff --git a/shared/src/main/java/com/vaadin/flow/component/menubar/MenuBarTester.java b/shared/src/main/java/com/vaadin/flow/component/menubar/MenuBarTester.java
index 1cba462e..0b36752c 100644
--- a/shared/src/main/java/com/vaadin/flow/component/menubar/MenuBarTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/menubar/MenuBarTester.java
@@ -357,6 +357,7 @@ public String getItemTooltipText(int topLevelPosition,
      *         are shown in
      * @throws IllegalStateException
      *             if the menu bar is not visible
+     * @since 25.3
      */
     public List<String> getItemTexts() {
         ensureVisible();
@@ -401,6 +402,7 @@ public List<String> getItemTexts() {
      *             if the menu bar is not visible, if there are multiple
      *             matching items at any level, or if the item at the given path
      *             is disabled or not visible.
+     * @since 25.3
      */
     public List<String> getItemTexts(String topLevelText,
             String... nestedItemsText) {
diff --git a/shared/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayoutTester.java b/shared/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayoutTester.java
index 573cee75..7141c831 100644
--- a/shared/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayoutTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayoutTester.java
@@ -32,6 +32,7 @@
  *
  * @param <T>
  *            component type
+ * @since 25.3
  */
 @Tests(SplitLayout.class)
 public class SplitLayoutTester<T extends SplitLayout>
diff --git a/shared/src/main/java/com/vaadin/flow/component/textfield/NumberFieldTester.java b/shared/src/main/java/com/vaadin/flow/component/textfield/NumberFieldTester.java
index 88310610..40d1ccb2 100644
--- a/shared/src/main/java/com/vaadin/flow/component/textfield/NumberFieldTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/textfield/NumberFieldTester.java
@@ -73,6 +73,7 @@ public void setValue(V value) {
      *
      * @throws IllegalStateException
      *             if the component is not usable
+     * @since 25.3
      */
     public void clear() {
         clearAsUser();
@@ -88,6 +89,7 @@ public void clear() {
      * @throws IllegalStateException
      *             if the component is not usable, or its clear button is not
      *             visible
+     * @since 25.3
      */
     public void clickClearButton() {
         clickClearButtonAsUser();
@@ -108,6 +110,7 @@ public void clickClearButton() {
      *
      * @return {@code true} if the field is not marked invalid and its current
      *         value satisfies the constraints of the field
+     * @since 25.3
      */
     public boolean isValid() {
         final V value = getComponent().getValue();
@@ -126,6 +129,7 @@ public boolean isValid() {
      *             if the component is not usable, the step buttons are not
      *             visible, or the new value would be outside the
      *             {@literal min - max} range
+     * @since 25.3
      */
     public void stepUp() {
         stepUp(1);
@@ -147,6 +151,7 @@ public void stepUp() {
      *             if the component is not usable, the step buttons are not
      *             visible, or the new value would be outside the
      *             {@literal min - max} range
+     * @since 25.3
      */
     public void stepUp(int times) {
         step(times, true);
@@ -163,6 +168,7 @@ public void stepUp(int times) {
      *             if the component is not usable, the step buttons are not
      *             visible, or the new value would be outside the
      *             {@literal min - max} range
+     * @since 25.3
      */
     public void stepDown() {
         stepDown(1);
@@ -185,6 +191,7 @@ public void stepDown() {
      *             if the component is not usable, the step buttons are not
      *             visible, or the new value would be outside the
      *             {@literal min - max} range
+     * @since 25.3
      */
     public void stepDown(int times) {
         step(times, false);
diff --git a/shared/src/main/java/com/vaadin/flow/component/textfield/TextAreaTester.java b/shared/src/main/java/com/vaadin/flow/component/textfield/TextAreaTester.java
index 993ca7aa..1724e48e 100644
--- a/shared/src/main/java/com/vaadin/flow/component/textfield/TextAreaTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/textfield/TextAreaTester.java
@@ -80,6 +80,7 @@ public void setValue(String value) {
      *
      * @throws IllegalStateException
      *             if the component is not usable
+     * @since 25.3
      */
     public void clear() {
         clearAsUser();
@@ -95,6 +96,7 @@ public void clear() {
      * @throws IllegalStateException
      *             if the component is not usable, or its clear button is not
      *             visible
+     * @since 25.3
      */
     public void clickClearButton() {
         clickClearButtonAsUser();
diff --git a/shared/src/main/java/com/vaadin/flow/component/textfield/TextFieldTester.java b/shared/src/main/java/com/vaadin/flow/component/textfield/TextFieldTester.java
index 863da760..f3558af4 100644
--- a/shared/src/main/java/com/vaadin/flow/component/textfield/TextFieldTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/textfield/TextFieldTester.java
@@ -102,6 +102,7 @@ public void clear() {
      * @throws IllegalStateException
      *             if the component is not usable, or its clear button is not
      *             visible
+     * @since 25.3
      */
     public void clickClearButton() {
         clickClearButtonAsUser();
diff --git a/shared/src/main/java/com/vaadin/flow/component/timepicker/TimePickerTester.java b/shared/src/main/java/com/vaadin/flow/component/timepicker/TimePickerTester.java
index 881f56b2..1d53839b 100644
--- a/shared/src/main/java/com/vaadin/flow/component/timepicker/TimePickerTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/timepicker/TimePickerTester.java
@@ -73,6 +73,7 @@ public void setValue(LocalTime time) {
      *
      * @return {@code true} if the field is not marked invalid and its current
      *         value satisfies the constraints of the field
+     * @since 25.3
      */
     public boolean isValid() {
         final LocalTime time = getComponent().getValue();
@@ -90,6 +91,7 @@ public boolean isValid() {
      *
      * @throws IllegalStateException
      *             if the component is not usable
+     * @since 25.3
      */
     public void clear() {
         clearAsUser();
@@ -105,6 +107,7 @@ public void clear() {
      * @throws IllegalStateException
      *             if the component is not usable, or its clear button is not
      *             visible
+     * @since 25.3
      */
     public void clickClearButton() {
         clickClearButtonAsUser();
diff --git a/shared/src/main/java/com/vaadin/flow/component/treegrid/TreeGridTester.java b/shared/src/main/java/com/vaadin/flow/component/treegrid/TreeGridTester.java
index a52f0763..8a55b188 100644
--- a/shared/src/main/java/com/vaadin/flow/component/treegrid/TreeGridTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/treegrid/TreeGridTester.java
@@ -42,6 +42,7 @@
  *            component type
  * @param <Y>
  *            item type
+ * @since 25.3
  */
 @Tests(fqn = { "com.vaadin.flow.component.treegrid.TreeGrid" })
 public class TreeGridTester<T extends TreeGrid<Y>, Y> extends GridTester<T, Y> {
diff --git a/shared/src/main/java/com/vaadin/flow/component/upload/UploadTester.java b/shared/src/main/java/com/vaadin/flow/component/upload/UploadTester.java
index 9bb1a775..3eef8d77 100644
--- a/shared/src/main/java/com/vaadin/flow/component/upload/UploadTester.java
+++ b/shared/src/main/java/com/vaadin/flow/component/upload/UploadTester.java
@@ -314,6 +314,7 @@ public void uploadFailed(String fileName, String contentType) {
      *            name of the file to remove, as given when it was uploaded
      * @throws IllegalArgumentException
      *             if the file is not in the upload file list
+     * @since 25.3
      */
     public void removeFile(String fileName) {
         ensureComponentIsUsable();
@@ -339,6 +340,7 @@ public void removeFile(String fileName) {
      *            the file to remove
      * @throws IllegalArgumentException
      *             if the file is not in the upload file list
+     * @since 25.3
      */
     public void removeFile(File file) {
         removeFile(file.getName());
@@ -358,6 +360,7 @@ public void removeFile(File file) {
      *
      * @return the outcome of the last simulated upload, one entry per file, or
      *         an empty list if no upload has been simulated yet
+     * @since 25.3
      */
     public List<FileStatus> getLastUploadStatus() {
         return state().lastUpload;
@@ -376,6 +379,7 @@ public List<FileStatus> getLastUploadStatus() {
      *             if no upload has been simulated on the component, or if any
      *             file of the last upload was not uploaded
      * @see #getLastUploadStatus()
+     * @since 25.3
      */
     public void ensureUploaded() {
         List<FileStatus> lastUpload = getLastUploadStatus();
@@ -883,6 +887,8 @@ private static class UploadState implements Serializable {
 
     /**
      * What became of a file handed to the tester for uploading.
+     * 
+     * @since 25.3
      */
     public enum UploadStatus {
         /**
@@ -918,6 +924,7 @@ public enum UploadStatus {
      * @param errorMessage
      *            the rejection or failure message, {@literal null} for an
      *            uploaded file
+     * @since 25.3
      */
     public record FileStatus(String fileName, UploadStatus status,
             String errorMessage) implements Serializable {