docs: reconcile @since tags with published release history (25.2)

vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java

@@ -47,6 +47,7 @@
  * inaccessible by keyboard or screen reader.
  *
  * @author Vaadin Ltd
+ * @since 1.0
  */
 @Tag("vaadin-accordion")
 @NpmPackage(value = "@vaadin/accordion", version = "25.2.0")

vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/AccordionPanel.java

@@ -23,6 +23,8 @@
 
 /**
  * An accordion panel which could be opened or closed.
+ * 
+ * @since 1.0
  */
 @Tag("vaadin-accordion-panel")
 @NpmPackage(value = "@vaadin/accordion", version = "25.2.0")
@@ -51,6 +53,7 @@ public AccordionPanel() {
      * @param summary
      *            the summary component to set.
      * @see #setSummaryText(String)
+     * @since 23.1
      */
     public AccordionPanel(String summary) {
         this();
@@ -63,6 +66,7 @@ public AccordionPanel(String summary) {
      * @param summary
      *            the summary component to set.
      * @see #setSummary(Component)
+     * @since 23.1
      */
     public AccordionPanel(Component summary) {
         this();
@@ -104,6 +108,7 @@ public AccordionPanel(Component summary, Component content) {
      *
      * @see #setSummaryText(String)
      * @see #add(Component...)
+     * @since 23.1
      */
     public AccordionPanel(String summary, Component... components) {
         this(summary);
@@ -121,6 +126,7 @@ public AccordionPanel(String summary, Component... components) {
      *
      * @see #setSummary(Component)
      * @see #add(Component...)
+     * @since 23.1
      */
     public AccordionPanel(Component summary, Component... components) {
         this(summary);
@@ -131,6 +137,7 @@ public AccordionPanel(Component summary, Component... components) {
      * Creates the summary container component.
      *
      * @return the summary container
+     * @since 24.0
      */
     protected Component createSummaryContainer() {
         return new AccordionHeading();

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsExperimentalFeatureException.java

@@ -20,6 +20,7 @@
  * features without activating the associated feature flag first.
  *
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public class AIComponentsExperimentalFeatureException extends RuntimeException {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsFeatureFlagProvider.java

@@ -25,6 +25,7 @@
  * AIOrchestrator, modular upload components, and MessageListItem attachments.
  *
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public class AIComponentsFeatureFlagProvider implements FeatureFlagProvider {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAIController.java

@@ -108,6 +108,7 @@
  * @see ChartState
  * @see DataConverter
  * @see DatabaseProviderAITools
+ * @since 25.2
  */
 public class ChartAIController implements AIController {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAITools.java

@@ -45,6 +45,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public final class ChartAITools {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartConfigurationParser.java

@@ -56,6 +56,7 @@
  * {@link Configuration} object.
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public final class ChartConfigurationParser implements Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartRenderer.java

@@ -43,6 +43,7 @@
  * (standalone chart, dashboard) share the same rendering logic.
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public final class ChartRenderer implements Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartState.java

@@ -31,6 +31,7 @@
  * @param configuration
  *            the chart configuration
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public record ChartState(List<String> queries,
         Configuration configuration) implements Serializable {

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ColumnNames.java

@@ -27,6 +27,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public final class ColumnNames implements Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ConfigurationKeys.java

@@ -26,6 +26,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public final class ConfigurationKeys implements Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DataConverter.java

@@ -34,6 +34,7 @@
  *
  * @author Vaadin Ltd
  * @see DefaultDataConverter
+ * @since 25.2
  */
 public interface DataConverter extends Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DefaultDataConverter.java

@@ -118,6 +118,7 @@
  *
  * @author Vaadin Ltd
  * @see ColumnNames
+ * @since 25.2
  */
 public class DefaultDataConverter implements DataConverter {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/PlotOptionsSchemaGenerator.java

@@ -80,6 +80,8 @@
  * <p>
  * Invoked automatically during the Maven build via {@code exec-maven-plugin}.
  * The output is consumed by {@link PlotOptionsSchema} at runtime.
+ * 
+ * @since 25.2
  */
 public final class PlotOptionsSchemaGenerator {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AIAttachment.java

@@ -33,6 +33,7 @@
  * @param data
  *            the raw file data, not {@code null}
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public record AIAttachment(String name, String mimeType,
         byte[] data) implements Serializable {

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AttachmentContentType.java

@@ -19,6 +19,8 @@
  * Supported content type categories for attachments.
  * <p>
  * Intended only for internal use and can be removed in the future.
+ * 
+ * @since 25.1
  */
 public enum AttachmentContentType {
     /** Image content types (image/*). */

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/ChatMessage.java

@@ -45,6 +45,7 @@
  * @param time
  *            the timestamp when the message was created; may be {@code null}
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public record ChatMessage(Role role, String content, String messageId,
         Instant time) implements Serializable {

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FieldValueChange.java

@@ -33,6 +33,7 @@
  *            the field's value at the end of the turn, possibly {@code null}
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public record FieldValueChange(HasValue<?, ?> field, Object oldValue,
         Object newValue) implements Serializable {

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FormAIController.java

@@ -167,6 +167,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public class FormAIController implements AIController {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/ValueOptions.java

@@ -47,6 +47,7 @@
  *            multi-select fields
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public final class ValueOptions<I> {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/AIDataRow.java

@@ -31,6 +31,7 @@
  * @author Vaadin Ltd
  * @see GridAIController
  * @see GridRenderer
+ * @since 25.2
  */
 public final class AIDataRow implements Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAIController.java

@@ -103,6 +103,7 @@
  * @see GridRenderer
  * @see GridState
  * @see DatabaseProviderAITools
+ * @since 25.2
  */
 public class GridAIController implements AIController {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAITools.java

@@ -40,6 +40,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public final class GridAITools {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridRenderer.java

@@ -45,6 +45,7 @@
  *
  * @author Vaadin Ltd
  * @see GridAIController
+ * @since 25.2
  */
 public final class GridRenderer implements Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridState.java

@@ -25,6 +25,7 @@
  * @param query
  *            the SQL query that populates the grid
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public record GridState(String query) implements Serializable {
 }

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIController.java

@@ -31,6 +31,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public interface AIController {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIOrchestrator.java

@@ -125,6 +125,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public class AIOrchestrator implements Serializable {
 
@@ -293,6 +294,7 @@ public void prompt(String userMessage) {
      *             if no UI context is available, or if the orchestrator needs
      *             to be reconnected after deserialization (see
      *             {@link #reconnect(LLMProvider)})
+     * @since 25.2
      */
     public void prompt(String userMessage, List<AIAttachment> attachments) {
         Objects.requireNonNull(attachments, "attachments cannot be null");
@@ -805,6 +807,7 @@ public Reconnector withTools(Object... tools) {
          * @return this reconnector
          * @throws IllegalArgumentException
          *             if any tool name is invalid
+         * @since 25.2
          */
         public Reconnector withController(AIController controller) {
             Objects.requireNonNull(controller, "Controller cannot be null");
@@ -1102,6 +1105,7 @@ public Builder withTools(Object... tools) {
          *             if controller is {@code null}
          * @throws IllegalArgumentException
          *             if any tool name is invalid
+         * @since 25.2
          */
         public Builder withController(AIController controller) {
             Objects.requireNonNull(controller, "Controller cannot be null");
@@ -1167,6 +1171,7 @@ public Builder withAssistantName(String assistantName) {
          * @param listener
          *            the listener to call on each prompt
          * @return this builder
+         * @since 25.2
          */
         public Builder withRequestListener(RequestListener listener) {
             warnIfAlreadySet(this.requestListener, "Request listener");
@@ -1227,6 +1232,7 @@ public Builder withAttachmentClickListener(
          * @param listener
          *            the listener to call after each exchange
          * @return this builder
+         * @since 25.2
          */
         public Builder withResponseListener(ResponseListener listener) {
             warnIfAlreadySet(this.responseListener, "Response listener");
@@ -1265,6 +1271,7 @@ public Builder withResponseListener(ResponseListener listener) {
          *            supplier of the per-turn context string, or {@code null}
          *            to disable session context entirely
          * @return this builder
+         * @since 25.2
          */
         public Builder withMetadata(
                 SerializableSupplier<String> contextSupplier) {

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AttachmentClickListener.java

@@ -19,6 +19,8 @@
 
 /**
  * Listener for attachment click events.
+ * 
+ * @since 25.1
  */
 @FunctionalInterface
 public interface AttachmentClickListener extends Serializable {

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/RequestListener.java

@@ -33,6 +33,8 @@
  * <b>Threading:</b> the listener is called on the UI thread under the session
  * lock. Long-running work should be offloaded to a worker; UI updates do not
  * need an extra {@code ui.access(...)} hop.
+ * 
+ * @since 25.2
  */
 @FunctionalInterface
 public interface RequestListener extends Serializable {

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/ResponseListener.java

@@ -44,6 +44,8 @@
  * <b>Threading:</b> the listener is called from a background thread (Reactor
  * scheduler). Blocking I/O (e.g. database writes) is safe directly. To update
  * Vaadin UI components from this listener, use {@code ui.access()}.
+ * 
+ * @since 25.2
  */
 @FunctionalInterface
 public interface ResponseListener extends Serializable {

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProvider.java

@@ -97,6 +97,7 @@
  * </pre>
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public interface DatabaseProvider extends Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProviderAITools.java

@@ -26,6 +26,7 @@
  * {@link DatabaseProvider}.
  *
  * @author Vaadin Ltd
+ * @since 25.2
  */
 public final class DatabaseProviderAITools {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LLMProvider.java

@@ -43,6 +43,7 @@
  * </pre>
  *
  * @author Vaadin Ltd.
+ * @since 25.1
  */
 public interface LLMProvider {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LangChain4JLLMProvider.java

@@ -92,6 +92,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public class LangChain4JLLMProvider implements LLMProvider {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/SpringAILLMProvider.java

@@ -79,6 +79,7 @@
  * </p>
  *
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public class SpringAILLMProvider implements LLMProvider {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIFileReceiver.java

@@ -24,6 +24,7 @@
  * Interface for file upload components that are used in an AI conversation.
  *
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public interface AIFileReceiver extends Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIInput.java

@@ -23,6 +23,7 @@
  * Interface for input components that are used in an AI conversation.
  *
  * @author Vaadin Ltd
+ * @since 25.1
  */
 public interface AIInput extends Serializable {
 

vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessage.java

@@ -23,6 +23,7 @@
  *
  * @author Vaadin Ltd
  * @see AIMessageList
+ * @since 25.1
  */
 public interface AIMessage extends Serializable {