diff --git a/packages/lit-dev-content/site/docs/v2/tools/publishing.md b/packages/lit-dev-content/site/docs/v2/tools/publishing.md index fafbf8e9e..4a861963b 100644 --- a/packages/lit-dev-content/site/docs/v2/tools/publishing.md +++ b/packages/lit-dev-content/site/docs/v2/tools/publishing.md @@ -31,7 +31,7 @@ You should also create a README describing how to consume your component. ## Publishing modern JavaScript -We recommend publishing JavaScript modules in standard [ES2019](https://kangax.github.io/compat-table/es2016plus/) syntax, as this is supported on all evergreen browsers and results in the fastest and smallest JavaScript. Users of your package can always use a compiler to support older browsers, but they can't transform legacy JavaScript to modern syntax if you pre-compile your code before publishing. +We recommend publishing JavaScript modules in standard [ES2019](https://compat-table.github.io/compat-table/es2016plus/) syntax, as this is supported on all evergreen browsers and results in the fastest and smallest JavaScript. Users of your package can always use a compiler to support older browsers, but they can't transform legacy JavaScript to modern syntax if you pre-compile your code before publishing. However, it is important that if you are using newly proposed or non-standard JavaScript features such as TypeScript, decorators, and class fields, you _should_ compile those features to standard ES2019 supported natively in browsers before publishing to npm. diff --git a/packages/lit-dev-content/site/docs/v3/tools/publishing.md b/packages/lit-dev-content/site/docs/v3/tools/publishing.md index 079f43fbf..9be157bb1 100644 --- a/packages/lit-dev-content/site/docs/v3/tools/publishing.md +++ b/packages/lit-dev-content/site/docs/v3/tools/publishing.md @@ -31,7 +31,7 @@ You should also create a README describing how to consume your component. ## Publishing modern JavaScript -We recommend publishing JavaScript modules in standard [ES2021](https://kangax.github.io/compat-table/es2016plus/) syntax, as this is supported on all evergreen browsers and results in the fastest and smallest JavaScript. Users of your package can always use a compiler to support older browsers, but they can't transform legacy JavaScript to modern syntax if you pre-compile your code before publishing. +We recommend publishing JavaScript modules in standard [ES2021](https://compat-table.github.io/compat-table/es2016plus/) syntax, as this is supported on all evergreen browsers and results in the fastest and smallest JavaScript. Users of your package can always use a compiler to support older browsers, but they can't transform legacy JavaScript to modern syntax if you pre-compile your code before publishing. However, it is important that if you are using newly proposed or non-standard JavaScript features such as TypeScript, decorators, and class fields, you _should_ compile those features to standard ES2021 supported natively in browsers before publishing to npm. diff --git a/packages/lit-dev-tests/known-good-urls.txt b/packages/lit-dev-tests/known-good-urls.txt index 7ccbfdf1d..b65d68348 100644 --- a/packages/lit-dev-tests/known-good-urls.txt +++ b/packages/lit-dev-tests/known-good-urls.txt @@ -118,7 +118,6 @@ https://jasmine.github.io/ https://modern-web.dev/guides/test-runner/getting-started https://www.npmjs.com/ https://www.typescriptlang.org/docs/handbook/tsconfig-json.html -https://kangax.github.io/compat-table/es2016plus/ https://github.com/WICG/webcomponents/blob/gh-pages/proposals/Scoped-Custom-Element-Registries.md https://docs.npmjs.com/packages-and-modules/contributing-packages-to-the-registry https://github.com/webcomponents/gold-standard/wiki