Skip to content

Vaadin Flow Components V25.2.0-alpha2

Pre-release
Pre-release

Choose a tag to compare

@vaadin-bot vaadin-bot released this 02 Apr 12:20
· 796 commits to main since this release
34534b5

Vaadin Flow Components 25.2.0-alpha2

This is a release of the Java integration for Vaadin Components to be used from the Java server side with Vaadin Flow.

Changes in Flow Components from 25.1.0-beta1

Changes in All Components

  • Chore:
    • ⧉ Increase Web-Component version
    • ⧉ Increase Web-Component version
    • ⧉ Increase Web-Component version
    • ⧉ Increase Web-Component version
    • ⧉ Increase Web-Component version
    • ⧉ Increase Web-Component version
    • ⧉ Increase Web-Component version
    • ⧉ Increase Web-Component version

Changes in vaadin-ai-components-flow

  • New Features:

    • ⧉ Implement grid AI controller state management. PR:9058

      ## Description Implements state management for GridAIController: - Introduces new APIs: - GridState getState() - void restoreState(GridState) - Adds public record GridState that holds the current query for the grid - Makes implementation detail GridEntry package-private Fixes https://github.com/orgs/vaadin/projects/103/views/1?filterQuery=&pane=issue&itemId=169426064 ## Type of change - [ ] Bugfix - [x] Feature ## Checklist - [x] I have read the contribution guide: https://vaadin.com/docs/latest/contributing/overview - [x] I have added a description following the guideline. - [x] The issue is created in the corresponding repository and I have referenced it. - [x] I have added tests to ensure my change is effective and works as intended. - [x] New and existing tests are passing locally with my change. - [x] I have performed self-review and corrected misspellings. - [x] Enhancement / new feature was discussed in a corresponding GitHub issue and Acceptance Criteria were created.

    • ⧉ Add chart AI controller state support. PR:9060

      ## Summary - Add ChartState record and getState()/restoreState() API to ChartAIController for capturing and restoring chart state (queries + configuration) - Add addStateChangeListener() for reacting to state changes after AI requests complete Closes https://github.com/orgs/vaadin/projects/103/views/3?pane=issue&itemId=165657963 🤖 Generated with Claude Code ---------

    • ⧉ Add ChartAIController. PR:9029

      ## Summary - Add ChartAIController for AI-powered chart visualization from database data - Add ChartConfigurationApplier for mapping JSON config to Vaadin Chart objects - Add ChartRenderer for the query→series→drawChart pipeline with axis defaults, datetime detection, and configuration reset across chart type switches - Add ChartEntry for per-chart pending state management - Add ConfigurationKeys constants for Highcharts property names Closes https://github.com/orgs/vaadin/projects/103/views/3?pane=issue&itemId=165662231 🤖 Generated with Claude Code ---------

    • ⧉ Add grid ai controller. PR:9027

      ## Description Adds GridAIController that implements AIController. Constructors: - GridAIController(Grid<Map<String, Object>>, DatabaseProvider) APIs: - String getSystemPrompt(). Features: - Default system prompt - Grid tools support - Empty state message - Built-in renderer support - End-aligned columns for number columns - Resizable, sortable, and auto-width by default - Column grouping support - Header formatting Support not included in this PR: - Custom renderers - State management and persistence Fixes https://github.com/orgs/vaadin/projects/103/views/1?filterQuery=&pane=issue&itemId=165824311 ## Type of change - [ ] Bugfix - [x] Feature ## Checklist - [x] I have read the contribution guide: https://vaadin.com/docs/latest/contributing/overview - [x] I have added a description following the guideline. - [x] The issue is created in the corresponding repository and I have referenced it. - [x] I have added tests to ensure my change is effective and works as intended. - [x] New and existing tests are passing locally with my change. - [x] I have performed self-review and corrected misspellings. - [x] Enhancement / new feature was discussed in a corresponding GitHub issue and Acceptance Criteria were created.

    • ⧉ Add grid ai tools. PR:9004

    • ⧉ Add multi grid support and update tool names

    • ⧉ Add ChartAITools. PR:8988

    • ⧉ Add ChartAITools factory for reusable chart LLM tool specs

    • ⧉ Improve chart tool schema with plotOptions, lowercase enums, and better descriptions

      - Add plotOptions support (series stacking, dataLabels, markers, pie innerSize for donuts, column/bar borderRadius) - Lowercase enum values for axis types, legend alignment, and zoomType to match Highcharts API conventions - Add axis type enum to xAxis, yAxis, and zAxis schemas - Support numeric chart height in addition to string - Replace exporting config with plotOptions (more useful for AI) - Improve tool and parameter descriptions

    • ⧉ Implement default data converters

    • ⧉ Database provider tools

    • ⧉ Add controller support to AI orchestrator. PR:8953

    • ⧉ Add data converter interface. PR:8930

    • ⧉ Add database provider interface. PR:8928

  • Fixes:

    • ⧉ Add error handling and input validation to chart AI tools
    • ⧉ Validate query elements and align chartId description in ChartAITools

Changes in vaadin-app-layout-flow

  • New Features:
    • ⧉ Add bindDrawerOpened to AppLayout. PR:8733

Changes in vaadin-avatar-flow

  • New Features:
    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

    • ⧉ Add missing unprefixed theme variants. PR:8851

      Add unprefixed variants and deprecate AURA prefixed duplicates for AvatarGroupVariant (REVERSE), TabSheetVariant (TABS_SHOW_SCROLL_BUTTONS), and TabsVariant (SHOW_SCROLL_BUTTONS)._

Changes in vaadin-badge-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

    • ⧉ Add SMALL variant to BadgeVariant. PR:8840

  • Fixes:

    • ⧉ Make setText and setContent replace all content in default slot. PR:8808

Changes in vaadin-button-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Make bindEnabled and disable on click mutually exclusive. PR:8816

Changes in vaadin-checkbox-flow

  • New Features:

    • ⧉ Add bindIndeterminate to Checkbox. PR:8732

    • ⧉ Add constructors with items signal. PR:8896

      ---------

    • ⧉ Throw if items set happens after items binding. PR:8895

  • Fixes:

    • ⧉ Sync presentation value on data change. PR:8891

Changes in vaadin-combo-box-flow

  • New Features:

    • ⧉ Add constructors with items signal. PR:8896

      ---------

    • ⧉ Throw if items set happens after items binding. PR:8895

  • Fixes:

    • ⧉ Override bind items for combobox. PR:8803. Ticket:23659

      ComboBox requires filter convertor and thus fails for generic data provider. This PR adds: overload for bindItems that takes the converter overload for bindItems that uses default items filter (uses items label generator and contains) unit tests for both methods E2E test. E2E test uses a custom equality checker for value signal and re-uses the Person entity class which equality is based in ID: ComboBox uses ID for refreshing items, whereas item signals should use some other equality (first name + last name), because otherwise signals skip calling the effects and value updates if they see equal values.

Changes in vaadin-confirm-dialog-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Override bindWidth / bindHeight for dialogs. PR:8810

Changes in vaadin-context-menu-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Make bindEnabled and disable on click mutually exclusive. PR:8816

Changes in vaadin-crud-flow

  • New Features:

    • ⧉ Add signal bind methods to grid component. PR:8742

    • ⧉ Add methods to get grid selection as a signal

      Add getSelectedItemSignal() and getSelectedItemsSignal() convenience methods that create a ValueSignal internally, bind it to the selection, and return it — so users can directly get a signal representing the grid's selection state without managing their own signal. This reverts commit 83f2e91.

  • Fixes:

    • ⧉ Clean up selection signal binding on model switch and reduce duplication

      Address review comments: add signal binding cleanup in selection model remove() so bindings are properly released when switching selection modes, and extract shared bindValue logic into GridSelectionSignalHelper to eliminate code duplication between single and multi selection models.

Changes in vaadin-dashboard-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Mark bindVisible as unsupported in dashboard components. PR:8830

Changes in vaadin-date-picker-flow

  • New Features:
    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

Changes in vaadin-date-time-picker-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Run side effects for bindReadOnly. PR:8829

Changes in vaadin-dialog-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Run side effects for Dialog.bindVisible. PR:8826
    • ⧉ Override bindWidth / bindHeight for dialogs. PR:8810

Changes in vaadin-grid-flow

  • New Features:

    • ⧉ Add signal bind methods to grid component. PR:8742

    • ⧉ Add methods to get grid selection as a signal

      Add getSelectedItemSignal() and getSelectedItemsSignal() convenience methods that create a ValueSignal internally, bind it to the selection, and return it — so users can directly get a signal representing the grid's selection state without managing their own signal. This reverts commit 83f2e91.

    • ⧉ Add constructors with items signal. PR:8896

      ---------

    • ⧉ Throw if items set happens after items binding. PR:8895

  • Fixes:

    • ⧉ Clean up selection signal binding on model switch and reduce duplication

      Address review comments: add signal binding cleanup in selection model remove() so bindings are properly released when switching selection modes, and extract shared bindValue logic into GridSelectionSignalHelper to eliminate code duplication between single and multi selection models.

    • ⧉ Sync presentation value on data change. PR:8891

Changes in vaadin-icons-flow

  • New Features:
    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

Changes in vaadin-list-box-flow

  • New Features:

    • ⧉ Throw if items set happens after items binding. PR:8895

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Sync presentation value on data change. PR:8891
    • ⧉ Mark bindRequiredIndicatorVisible as unsupported in ListBox components. PR:8831

Changes in vaadin-login-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Mark AbstractLogin.bindEnabled as not supported. PR:8819

Changes in vaadin-master-detail-layout-flow

  • New Features:
    • ⧉ Add detail placeholder API to MasterDetailLayout. PR:9017

      Add setDetailPlaceholder/getDetailPlaceholder for content shown in the detail area when no detail is selected. The placeholder is hidden in overlay mode, unlike the detail content which becomes an overlay.

    • ⧉ Add MasterDetailLayout constructor with sizes and expand

      Add constructor MasterDetailLayout(String masterSize, String detailSize, Expand expandingSide) for convenient initialization.

Changes in vaadin-messages-flow

  • New Features:
    • ⧉ Add signal bind method to message list component. PR:8783

      Add bindItems(Signal<List<S>>) method and a signal-based constructor to MessageList, allowing items to be reactively bound to signals. The rendered messages update automatically when the list signal or any individual item signal changes. Implementation details: - Extract private updateItems() from setItems() for reuse by the signal effect callback - Guard setItems() and addItem() with throwIfItemsBindingActive() to prevent manual mutation while a signal binding is active - Use SignalBindingFeature for binding lifecycle management - Add unit tests covering signal constructor, reactive updates for both list and item signals, deferred activation until attach, and error cases (mutation while bound, double bind, null signal) - Add manual test page and integration tests for signal binding ---------

Changes in vaadin-progress-bar-flow

  • New Features:
    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

Changes in vaadin-radio-button-flow

  • New Features:

    • ⧉ Add constructors with items signal. PR:8896

      ---------

    • ⧉ Throw if items set happens after items binding. PR:8895

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Sync presentation value on data change. PR:8891
    • ⧉ Run side effects for bindReadOnly. PR:8829

Changes in vaadin-select-flow

  • New Features:
    • ⧉ Add constructors with items signal. PR:8896

      ---------

    • ⧉ Throw if items set happens after items binding. PR:8895

Changes in vaadin-slider-flow

  • New Features:
    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

Changes in vaadin-spreadsheet-flow

  • Fixes:
    • ⧉ Reset freeze pane split positions when switching sheets. PR:9035. Ticket:9006

      ## Summary - Fixes freeze pane state bleeding between sheets when switching tabs in Spreadsheet - When switching from a sheet with a freeze pane split to one without that split type, the previous sheet's split position was not reset to 0, causing it to persist visually - Root cause: commit a1963f9 guarded setHorizontalSplitPosition/setVerticalSplitPosition behind split-exists checks but the else branches never explicitly reset the positions to 0 ## Test plan - [x] New unit tests in SpreadsheetFactoryTest verify all freeze pane combinations (both splits, only rows, only columns, none) and the sheet-switching bleed scenario - [x] Rollback verification: 3 of 5 unit tests fail without the fix, pass with it - [x] Existing regression tests (HiddenAndFrozenIT, LoadFileWithFrozenPaneScrolledIT, MergedCellFrozenIT) all pass 🤖 Generated with Claude Code

Changes in vaadin-tabs-flow

  • New Features:

    • ⧉ Add missing unprefixed theme variants. PR:8851

      Add unprefixed variants and deprecate AURA prefixed duplicates for AvatarGroupVariant (REVERSE), TabSheetVariant (TABS_SHOW_SCROLL_BUTTONS), and TabsVariant (SHOW_SCROLL_BUTTONS)._

    • ⧉ Add new unprefixed variants to TabSheetVariant. PR:8838

    • ⧉ Add shared small size variant for Tabs. PR:8822

  • Fixes:

    • ⧉ Move tabsheet contents to new instance. PR:8879

Changes in vaadin-text-field-flow

  • New Features:

    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

  • Fixes:

    • ⧉ Run side effects for AbstractNumberField.bindMin. PR:8821

Changes in vaadin-time-picker-flow

  • New Features:
    • ⧉ Return SignalBinding from all bind methods. PR:8860

      Change all component-level bind methods from void to returning SignalBinding, enabling fluent .onChange() callbacks. This includes bind methods that delegate to super, to SignalPropertySupport.bind(), to Element.bindProperty/bindAttribute, and methods that throw UnsupportedOperationException.

Changes in vaadin-upload-flow

  • New Features:

    • ⧉ Add separate upload accepted extensions and mime types api. PR:8847
    • ⧉ Add separate upload accepted file types and mime types api
    • ⧉ Add separate upload accepted file types and mime types api
  • Fixes:

    • ⧉ Use suppliers for accepted types
    • ⧉ Use suppliers for accepted types

Changes in vaadin-virtual-list-flow

  • New Features:
    • ⧉ Throw if items set happens after items binding. PR:8895

Compatibility