From 42d1ed548cf2cc0e010b364bafac033f4576dc40 Mon Sep 17 00:00:00 2001 From: Peter Burns Date: Tue, 29 Oct 2024 14:23:32 -0700 Subject: [PATCH] Mention that updating to TypeScript 5.2 is necessary in the upgrade guide. (#1380) --- packages/lit-dev-content/site/docs/v3/releases/upgrade.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/packages/lit-dev-content/site/docs/v3/releases/upgrade.md b/packages/lit-dev-content/site/docs/v3/releases/upgrade.md index 937d35cac..9d491a2a7 100644 --- a/packages/lit-dev-content/site/docs/v3/releases/upgrade.md +++ b/packages/lit-dev-content/site/docs/v3/releases/upgrade.md @@ -23,8 +23,9 @@ Lit 3.0 has very few breaking changes from Lit 2.x: - APIs marked deprecated in Lit 2.x releases have been removed. - SSR hydration support modules have moved to the `@lit-labs/ssr-client` package. - Type only: Type of `ReactiveElement`'s `renderRoot` and `createRenderRoot()` have been updated. -- Decorator behavior has been unified between TypeScript experimental decorators and standard decorators. - Support was removed for Babel decorators version "2018-09". +- Decorator behavior has been unified between TypeScript experimental decorators and standard decorators. + - As a consequence, if you use TypeScript you'll need to upgrade to at least TypeScript v5.2, to get the updated types for both kinds of decorators. For the vast majority of users there should be no required code changes to upgrade from Lit 2 to Lit 3. Most apps and libraries should be able to extend their npm version ranges to include both 2.x and 3.x, like `"^2.7.0 || ^3.0.0"`.