AC: PolymerTemplate to LitTemplate conversion tool [DRAFT]

[mshabarov]

trafficstars

Description

PolymerTemplate API support is removed for Core and Pro users in V24, while support is provided for Prime+. To help Vaadin users migrate to V24 without getting stuck on V23, we've already made a conversion tool with the base functionality.

Conversion tool sources can be found here. The public discussion with improvement suggestions can be found here.

Use cases

As a developer I want to have an automated tool to convert my PolymerTemplate based components to LitTemplate So that I can migrate to Vaadin 24 easier and faster.

Acceptance criteria

• [ ] To be discussed: conversion tool is available for developers as a goal of Maven/Gradle Vaadin plugin, so it can be run from the project root as follows: mvn vaadin:convert-polymer
• [ ] Well covered by automatic tests
• [ ] Documentation is ready and includes: tool's description and manual, use cases, limitations, troubleshooting (if any).

Note: adding a new functionality to the existing conversion tool can be considered in case of bugs, DX feedback or if it covers ~50% or more use cases.

General criteria

• [ ] APIs reviewed

• [ ] Design

• [ ] Performance

• [ ] UX/DX tests in Alpha

• [ ] Documentation:

• [ ] How to test?

• [ ] Limitations: