v3.0.2

What's Changed

• chore: add injection points for devtools instrumentation by @divmain in #3613
• fix: drop compat code for legacy browsers by @nolanlawson in #3610
• chore: type safe template references by @ekashida in #3620
• fix: warn only once about deprecated compiler option enableLwcSpread by @seckardt in #3622

New Contributors

• @seckardt made their first contribution in #3622

Full Changelog: v3.0.1...v3.0.2

v3.0.1

What's Changed

• chore: weekly dependencies update by @ravijayaramappa in #3604
• perf(engine-core): optimize ReactiveObserver.reset() by @nolanlawson in #3608
• chore: update dependencies by @ravijayaramappa in #3609

Full Changelog: v3.0.0...v3.0.1

v3.0.0

LWC v3.0.0 contains breaking changes. Please read carefully below if you are upgrading from v2 to v3.

ℹ️ LWC v3 corresponds to Salesforce release Winter '24 (API version 59).

Breaking Changes

Remove support for IE11 and other legacy browsers

ℹ️ This change applies to all LWC components and the entire Salesforce Lightning platform.

Internet Explorer is no longer supported. If you are using the Salesforce Lightning platform, please refer to Supported Browsers and Devices for Lightning Experience and Ending Support for IE11 on the Lightning Platform.

• chore: remove compat support (BREAKING CHANGE) by @nolanlawson in #3586

CSS scope tokens have changed

ℹ️ On the Salesforce Lightning platform, this change only applies to components with an API version of 59 or above.

To scope CSS, LWC automatically adds attributes and classes to DOM elements. These attributes and classes should be considered internal implementation details of the framework, and developers should not rely on them.

In this release, the scope tokens have changed. Before, they used a format like c-foo_foo (for the <c-foo> component). Now, they use a format like lwc-<hash>. For instance:

Old format:

<c-foo c-foo_foo-host>
  <div c-foo_foo></div>
</c-foo>

New format:

<c-foo lwc-1hl7358i549-host>
  <div lwc-1hl7358i549></div>
</c-foo>

If you are relying on these attributes/classes in your tests, or for this.template.querySelector(), please avoid relying on them, as they could change at any time. Instead of this.template.querySelector(), you can also use lwc:ref.

This change was made as part of a performance improvement to optimize SVG rendering.

• feat: add API versioning (BREAKING CHANGE) by @nolanlawson in #3580

HTML template parsing is stricter

ℹ️ On the Salesforce Lightning platform, this change only applies to components with an API version of 59 or above.

Previously, certain HTML syntax errors were ignored by the LWC compiler but emitted a warning. Now, these syntax errors will result in a failed component compilation.

The most common syntax error is the following (in component HTML):

<template>
</template>
</template>

Note the double-ending </template> tag. Previously, this would emit a warning, but it now emits an error.

Other possible syntax errors include:

Unclosed elements:

<template>
  <div>
</template>

Invalid empty tags:

<template>
  <section/>
</template>

Stranded close tags:

</template>

Please fix any syntax warnings in LWC v2 before upgrading to LWC v3 to avoid this issue. We have a codemod that can automatically do this for you.

• feat: add API versioning (BREAKING CHANGE) by @nolanlawson in #3580

Implicit hydration is removed for CustomElementConstructor

ℹ️ This change only affects consumers of the CustomElementConstructor API.

The CustomElementConstructor API now creates custom elements that do not attempt to do implicit hydration (i.e. treating the component as if it were generated by Server-Side Rendering). This change should be a mostly positive one, as it will avoid a class of warnings that affected developers who were using standalone LWC components as custom elements.

• fix: remove implicit hydration (BREAKING CHANGE) by @abdulsattar in #3591

Remove legacy package files and reorganize lwc package

ℹ️ This change only affects consumers of the lwc or @lwc/* open-source packages from npm.

Previously, the LWC packages published to npm used a bespoke format for each package. Some consumers may have taken a reliance on the quirks of these package structures, for instance:

import '@lwc/compiler/dist/commonjs/transformers/transformer.js'
import '@lwc/engine-dom/dist/engine-dom.js'
import '@lwc/synthetic-shadow/dist/synthetic-shadow.js'

Instead, consumers are encouraged to avoid deep-importing from these packages:

import '@lwc/compiler'
import '@lwc/engine-dom'
import '@lwc/synthetic-shadow'

Also, the lwc package used to contain transformed versions of various packages (e.g. IIFE format, UMD format, minified format, etc.).

Now, all packages export a single CommonJS and ES Module file, and the lwc package merely re-exports these other packages. If you need these packages in a special format (IIFE, UMD, minified, etc.), you are encouraged to run your own bundler/minifier to accomplish this, e.g. Rollup and Terser.

• chore: remove legacy dist files (BREAKING CHANGE) by @nolanlawson in #3585
• feat: make lwc re-export other packages (BREAKING CHANGE) by @nolanlawson in #3594

Changes

• chore(nucleus): remove ui-omniscript-components by @nolanlawson in #3590
• chore: fix small spelling typo in function comment by @pelmers in #3593

New Contributors

• @pelmers made their first contribution in #3593

Full Changelog: v2.50.0...v3.0.0

v2.50.0

What's Changed

• chore: update babel deps by @nolanlawson in #3573
• chore: update nx to v16 by @nolanlawson in #3572
• chore: update more babel deps by @nolanlawson in #3576
• chore: update webdriverio to v8 by @nolanlawson in #3575
• feat: add enableLightningWebSecurityTransforms to rollup-plugin by @jdalton in #3582

New Contributors

• @jdalton made their first contribution in #3582

Full Changelog: v2.49.1...v2.50.0

v2.49.1

What's Changed

• feat: remove enableLwcSpread option by @abdulsattar in #3544

Full Changelog: v2.49.0...v2.49.1

v2.49.0

What's Changed

• fix(template-compiler): support custom renderer hooks for external components by @ekashida in #3559
• perf: apply static optimization to lwc:ref by @nolanlawson in #3550
• fix(hydration): log errors/warnings only in dev mode by @nolanlawson in #3534

Full Changelog: v2.48.0...v2.49.0

v2.48.0

What's Changed

• feat(compiler): return cssScopeTokens by @nolanlawson in #3556

Full Changelog: v2.47.0...v2.48.0

v2.47.0

What's Changed

• feat: add LWS flag & import babel plugins by @a-chabot in #3357

New Contributors

• @a-chabot made their first contribution in #3357

Full Changelog: v2.46.0...v2.47.0

v2.46.0

What's Changed

• fix(engine-core): fix lwc:external attribute handling by @nolanlawson in #3508
• feat(compiler): implement mechanism to gather internal metrics and logs by @jye-sf in #3536
• perf(engine-core): optimize static elements with listeners by @nolanlawson in #3519
• fix(rollup-plugin): ensure dependencies are declared by @nolanlawson in #3542

Full Changelog: v2.45.5...v2.46.0

v2.41.4

What's Changed

• fix(engine-core): execute scoped slot fragment in the slot owner's reactive observer by @ravijayaramappa in #3538

Full Changelog: v2.41.3...v2.41.4