Dec 10, 2025 · Dec 11, 2025 · Dec 11, 2025 · Dec 12, 2025 · Dec 12, 2025 · Dec 12, 2025
diff --git a/commitlint.config.js b/commitlint.config.js
 * SPDX-License-Identifier: MIT
 * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
 */
 module.exports = {
 export default {
    rules: {
        'body-leading-blank': [1, 'always'],
        'footer-leading-blank': [1, 'always'],
diff --git a/eslint.config.mjs b/eslint.config.mjs
        },
    },
    {
        files: ['**/*.js', '**/*.mjs', '**/*.cjs'],
        files: ['**/*.js', '**/*.mjs'],
        ...tseslint.configs.disableTypeChecked,
    },

diff --git a/package.json b/package.json
        "type": "git",
        "url": "https://github.com/salesforce/lwc.git"
    },
    "type": "module",
    "scripts": {
        "prepare": "husky && yarn build",
        "lint": "eslint . --cache",
        "test:ci": "vitest run --coverage",
        "test:wtr": "nx test @lwc/integration-wtr",
        "test:hydration": "nx test:hydration @lwc/integration-wtr",
        "test:integration": "nx sauce @lwc/integration-wdio",
        "test:wdio": "nx sauce @lwc/integration-wdio",
        "test:performance": "nx test @lwc/perf-benchmarks",
        "test:performance:best": "nx test:best @lwc/perf-benchmarks",
        "test:performance:best:ci": "nx test:best:ci @lwc/perf-benchmarks",
        "rollup": "^4.53.3",
        "terser": "^5.44.1",
        "tslib": "^2.8.1",
        "typescript": "5.8.2",
        "typescript": "~6.0.0-0",
        "typescript-eslint": "8.50.0",
        "vitest": "4.0.16"
    },
        "packages/lwc",
        "playground"
    ],
    "engines": {
        "node": ">=10"
    },
    "volta": {
        "node": "24.11.1",
        "yarn": "1.22.22"
diff --git a/packages/@lwc/aria-reflection/package.json b/packages/@lwc/aria-reflection/package.json
        "url": "https://github.com/salesforce/lwc/issues"
    },
    "license": "MIT",
    "type": "module",
    "publishConfig": {
        "access": "public"
    },
    "engines": {
        "node": ">=16.6.0"
    },
    "volta": {
        "extends": "../../../package.json"
    },
    "main": "dist/index.cjs.js",
    "main": "dist/index.js",
    "module": "dist/index.js",
    "types": "dist/index.d.ts",
    "files": [
diff --git a/packages/@lwc/babel-plugin-component/README.md b/packages/@lwc/babel-plugin-component/README.md
 ## Usage

 ```js
 const babel= require('@babel/core');
 const lwcPlugin= require('@lwc/babel-plugin-component');
 import babelfrom'@babel/core';
 import lwcPluginfrom'@lwc/babel-plugin-component';

 const source = `
 import { LightningElement } from 'lwc';
diff --git a/packages/@lwc/babel-plugin-component/package.json b/packages/@lwc/babel-plugin-component/package.json
        "url": "https://github.com/salesforce/lwc/issues"
    },
    "license": "MIT",
    "type": "module",
    "publishConfig": {
        "access": "public"
    },
    "engines": {
        "node": ">=16.6.0"
    },
    "volta": {
        "extends": "../../../package.json"
    },
    "main": "dist/index.cjs.js",
    "main": "dist/index.js",
    "module": "dist/index.js",
    "types": "dist/index.d.ts",
    "files": [
diff --git a/packages/@lwc/babel-plugin-component/src/__tests__/index.spec.ts b/packages/@lwc/babel-plugin-component/src/__tests__/index.spec.ts
 describe('fixtures', () => {
    testFixtureDir<TestConfig>(
        {
            root: path.resolve(__dirname, 'fixtures'),
            root: path.resolve(import.meta.dirname, 'fixtures'),
            pattern: '**/actual.js',
            ssrVersion: 2,
        },
diff --git a/packages/@lwc/babel-plugin-component/src/component.ts b/packages/@lwc/babel-plugin-component/src/component.ts
 * SPDX-License-Identifier: MIT
 * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
 */
 import { basename, extname } from 'path';
 import { basename, extname } from 'node:path';
 import { addDefault, addNamed } from '@babel/helper-module-imports';
 import { generateCustomElementTagName, getAPIVersionFromNumber } from '@lwc/shared';
 import {
diff --git a/packages/@lwc/compiler/README.md b/packages/@lwc/compiler/README.md
    - `name` (type: `string`, required) - name of the component, e.g. `foo` in `x/foo`.
    - `namespace` (type: `string`, required) - namespace of the component, e.g. `x` in `x/foo`.
    - `stylesheetConfig` (type: `object`, default: `{}`) - Deprecated. Ignored by compiler.
    - `experimentalDynamicComponent` (type: `DynamicImportConfig`, default: `null`) - The configuration to pass to `@lwc/compiler`.
    - `dynamicImports` (type: `DynamicImportConfig`, default: `null`) - The configuration to pass to `@lwc/compiler`.
    - `experimentalDynamicDirective` (type: `boolean`, default: `false`) - The configuration to pass to `@lwc/template-compiler` to enable deprecated dynamic components.
    - `enableDynamicComponents` (type: `boolean`, default: `false`) - The configuration to pass to `@lwc/template-compiler` to enable dynamic components.
    - `outputConfig` (type: `object`, optional) - see below:
diff --git a/packages/@lwc/compiler/package.json b/packages/@lwc/compiler/package.json
        "url": "https://github.com/salesforce/lwc/issues"
    },
    "license": "MIT",
    "type": "module",
    "publishConfig": {
        "access": "public"
    },
    "engines": {
        "node": ">=16.6.0"
    },
    "volta": {
        "extends": "../../../package.json"
    },
    "main": "dist/index.cjs.js",
    "main": "dist/index.js",
    "module": "dist/index.js",
    "types": "dist/index.d.ts",
    "files": [
diff --git a/packages/@lwc/compiler/src/options.ts b/packages/@lwc/compiler/src/options.ts
    namespace: string;
    /** @deprecated Ignored by compiler. */
    stylesheetConfig?: StylesheetConfig;
    // TODO [#5031]: Unify dynamicImports and experimentalDynamicComponent options
    /** Config applied in usage of dynamic import statements in javascript */
 experimentalDynamicComponent?: DynamicImportConfig;
 dynamicImports?: DynamicImportConfig;
    // TODO [#3331]: deprecate and remove lwc:dynamic
    /** Flag to enable usage of dynamic component(lwc:dynamic) directive in HTML template */
    experimentalDynamicDirective?: boolean;
    | 'enableDynamicComponents'
    | 'enableSyntheticElementInternals'
    | 'experimentalDynamicDirective'
    | 'experimentalDynamicComponent'
    | 'dynamicImports'
    | 'componentFeatureFlagModulePath'
    | 'instrumentation';

        },
    };

    constexperimentalDynamicComponent: Required<DynamicImportConfig> = {
    constdynamicImports: Required<DynamicImportConfig> = {
        ...DEFAULT_DYNAMIC_IMPORT_CONFIG,
        ...options.experimentalDynamicComponent,
        ...options.dynamicImports,
    };

    const apiVersion = getAPIVersionFromNumber(options.apiVersion);
        ...options,
        stylesheetConfig,
        outputConfig,
 experimentalDynamicComponent,
 dynamicImports,
        apiVersion,
    };
 }
diff --git a/packages/@lwc/compiler/src/transformers/__tests__/transform-javascript.spec.ts b/packages/@lwc/compiler/src/transformers/__tests__/transform-javascript.spec.ts
        `;
        await transform(actual, 'foo.js', {
            ...BASE_TRANSFORM_OPTIONS,
 experimentalDynamicComponent: {
 dynamicImports: {
                loader: '@custom/loader',
                strictSpecifier: true,
            },
diff --git a/packages/@lwc/compiler/src/transformers/javascript.ts b/packages/@lwc/compiler/src/transformers/javascript.ts
    const {
        isExplicitImport,
        enableSyntheticElementInternals,
        // TODO [#5031]: Unify dynamicImports and experimentalDynamicComponent options
        experimentalDynamicComponent: dynamicImports,
        dynamicImports,
        outputConfig: { sourcemap },
        enableLightningWebSecurityTransforms,
        namespace,
diff --git a/packages/@lwc/compiler/src/transformers/template.ts b/packages/@lwc/compiler/src/transformers/template.ts
    options: NormalizedTransformOptions
 ): TransformResult {
    const {
 experimentalDynamicComponent,
 dynamicImports,
        // TODO [#3370]: remove experimental template expression flag
        experimentalComplexExpressions,
        preserveHtmlComments,
        disableSyntheticShadowSupport,
        experimentalErrorRecoveryMode,
    } = options;
    const experimentalDynamicDirective =
        deprecatedDynamicDirective ?? Boolean(experimentalDynamicComponent);
    const experimentalDynamicDirective = deprecatedDynamicDirective ?? Boolean(dynamicImports);

    let result;
    try {
diff --git a/packages/@lwc/compiler/src/transformers/transformer.ts b/packages/@lwc/compiler/src/transformers/transformer.ts
 * SPDX-License-Identifier: MIT
 * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
 */
 import * as path from 'path';
 import * as path from 'node:path';

 import { isString } from '@lwc/shared';
 import { TransformerErrors, generateCompilerError, invariant } from '@lwc/errors';
diff --git a/packages/@lwc/engine-core/package.json b/packages/@lwc/engine-core/package.json
        "url": "https://github.com/salesforce/lwc/issues"
    },
    "license": "MIT",
    "type": "module",
    "publishConfig": {
        "access": "public"
    },
    "engines": {
        "node": ">=16.6.0"
    },
    "volta": {
        "extends": "../../../package.json"
    },
    "main": "dist/index.cjs.js",
    "main": "dist/index.js",
    "module": "dist/index.js",
    "types": "dist/index.d.ts",
    "files": [
diff --git a/packages/@lwc/engine-core/src/framework/decorators/register.ts b/packages/@lwc/engine-core/src/framework/decorators/register.ts

 interface PropCompilerDef {
    config: PropType; // 0 m
    type: string; // TODO [#1301]: make this an enum
    type: string;
 }
 interface WireCompilerDef {
    method?: number;
        const type = getClassDescriptorType(descriptor);
        const message = `Invalid observed ${fieldName} field. Found a duplicate ${type} with the same name.`;

        // TODO [#3408]: this should throw, not log
        // TODO [#4450]: this should throw, not log
        logError(message);
    }
 }
    assertNotProd(); // this method should never leak to prod
    if (!isUndefined(descriptor)) {
        const type = getClassDescriptorType(descriptor);
        // TODO [#3408]: this should throw, not log
        // TODO [#4450]: this should throw, not log
        logError(
            `Invalid @track ${fieldName} field. Found a duplicate ${type} with the same name.`
        );
    assertNotProd(); // this method should never leak to prod
    if (!isUndefined(descriptor)) {
        const type = getClassDescriptorType(descriptor);
        // TODO [#3408]: this should throw, not log
        // TODO [#4450]: this should throw, not log
        logError(`Invalid @wire ${fieldName} field. Found a duplicate ${type} with the same name.`);
    }
 }
 ) {
    assertNotProd(); // this method should never leak to prod
    if (isUndefined(descriptor) || !isFunction(descriptor.value) || isFalse(descriptor.writable)) {
        // TODO [#3441]: This line of code does not seem possible to reach.
        // TODO [#4450]: This line of code does not seem possible to reach.
        logError(
            `Invalid @wire ${methodName} field. The field should have a valid writable descriptor.`
        );
        const type = getClassDescriptorType(descriptor);
        const message = `Invalid @api ${fieldName} field. Found a duplicate ${type} with the same name.`;

        // TODO [#3408]: this should throw, not log
        // TODO [#4450]: this should throw, not log
        logError(message);
    }
 }
    assertNotProd(); // this method should never leak to prod
    if (isFunction(descriptor.set)) {
        if (!isFunction(descriptor.get)) {
            // TODO [#3441]: This line of code does not seem possible to reach.
            // TODO [#4450]: This line of code does not seem possible to reach.
            logError(
                `Missing getter for property ${fieldName} decorated with @api in ${Ctor}. You cannot have a setter without the corresponding getter.`
            );
            if (method === 1) {
                if (process.env.NODE_ENV !== 'production') {
                    if (!adapter) {
                        // TODO [#3408]: this should throw, not log
                        // TODO [#4450]: this should throw, not log
                        logError(
                            `@wire on method "${fieldOrMethodName}": adapter id must be truthy.`
                        );
            } else {
                if (process.env.NODE_ENV !== 'production') {
                    if (!adapter) {
                        // TODO [#3408]: this should throw, not log
                        // TODO [#4450]: this should throw, not log
                        logError(
                            `@wire on field "${fieldOrMethodName}": adapter id must be truthy.`
                        );
diff --git a/packages/@lwc/engine-core/src/framework/decorators/wire.ts b/packages/@lwc/engine-core/src/framework/decorators/wire.ts
 * }
 */
 export default function wire<
    ReactiveConfig extends ConfigValue = ConfigValue,
    Value = any,
    Context extends ContextValue = ContextValue,
    Class = LightningElement,
 constReactiveConfig extends ConfigValue = ConfigValue,
 constValue = any,
 constContext extends ContextValue = ContextValue,
 constClass = LightningElement,
 >(
    // eslint-disable-next-line @typescript-eslint/no-unused-vars
    adapter:
diff --git a/packages/@lwc/engine-core/src/framework/rendering.ts b/packages/@lwc/engine-core/src/framework/rendering.ts
 ): Record<Key, number> {
    const map: Record<Key, number> = {};

    // TODO [#1637]: simplify this by assuming that all vnodes has keys
    for (let j = beginIdx; j <= endIdx; ++j) {
        const ch = children[j];
        if (isVNode(ch)) {
diff --git a/packages/@lwc/engine-dom/package.json b/packages/@lwc/engine-dom/package.json
        "url": "https://github.com/salesforce/lwc/issues"
    },
    "license": "MIT",
    "type": "module",
    "publishConfig": {
        "access": "public"
    },
    "engines": {
        "node": ">=16.6.0"
    },
    "volta": {
        "extends": "../../../package.json"
    },
    "main": "dist/index.cjs.js",
    "main": "dist/index.js",
    "module": "dist/index.js",
    "types": "dist/index.d.ts",
    "files": [
Original file line number	Diff line number	Diff line change
Expand Up		@@ -4,7 +4,7 @@
		* SPDX-License-Identifier: MIT
		* For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
		*/
		module.exports = {
		export default {
		rules: {
		'body-leading-blank': [1, 'always'],
		'footer-leading-blank': [1, 'always'],
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -189,7 +189,7 @@ export default tseslint.config(
		},
		},
		{
		files: ['*/.js', '*/.mjs', '*/.cjs'],
		files: ['*/.js', '*/.mjs'],
		...tseslint.configs.disableTypeChecked,
		},

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -7,6 +7,7 @@
		"type": "git",
		"url": "https://github.com/salesforce/lwc.git"
		},
		"type": "module",
		"scripts": {
		"prepare": "husky && yarn build",
		"lint": "eslint . --cache",
Expand All		@@ -25,7 +26,7 @@
		"test:ci": "vitest run --coverage",
		"test:wtr": "nx test @lwc/integration-wtr",
		"test:hydration": "nx test:hydration @lwc/integration-wtr",
		"test:integration": "nx sauce @lwc/integration-wdio",
		"test:wdio": "nx sauce @lwc/integration-wdio",
		"test:performance": "nx test @lwc/perf-benchmarks",
		"test:performance:best": "nx test:best @lwc/perf-benchmarks",
		"test:performance:best:ci": "nx test:best:ci @lwc/perf-benchmarks",
Expand DownExpand Up		@@ -72,7 +73,7 @@
		"rollup": "^4.53.3",
		"terser": "^5.44.1",
		"tslib": "^2.8.1",
		"typescript": "5.8.2",
		"typescript": "~6.0.0-0",
		"typescript-eslint": "8.50.0",
		"vitest": "4.0.16"
		},
Expand All		@@ -87,9 +88,6 @@
		"packages/lwc",
		"playground"
		],
		"engines": {
		"node": ">=10"
		},
		"volta": {
		"node": "24.11.1",
		"yarn": "1.22.22"
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -23,13 +23,17 @@
		"url": "https://github.com/salesforce/lwc/issues"
		},
		"license": "MIT",
		"type": "module",
		"publishConfig": {
		"access": "public"
		},
		"engines": {
		"node": ">=16.6.0"
		},
		"volta": {
		"extends": "../../../package.json"
		},
		"main": "dist/index.cjs.js",
		"main": "dist/index.js",
		"module": "dist/index.js",
		"types": "dist/index.d.ts",
		"files": [
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -21,8 +21,8 @@ This babel plugin does the following transform:
		## Usage

		```js
		const babel= require('@babel/core');
		const lwcPlugin= require('@lwc/babel-plugin-component');
		import babelfrom'@babel/core';
		import lwcPluginfrom'@lwc/babel-plugin-component';

		const source = `
		import { LightningElement } from 'lwc';
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -19,13 +19,17 @@
		"url": "https://github.com/salesforce/lwc/issues"
		},
		"license": "MIT",
		"type": "module",
		"publishConfig": {
		"access": "public"
		},
		"engines": {
		"node": ">=16.6.0"
		},
		"volta": {
		"extends": "../../../package.json"
		},
		"main": "dist/index.cjs.js",
		"main": "dist/index.js",
		"module": "dist/index.js",
		"types": "dist/index.d.ts",
		"files": [
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -81,7 +81,7 @@ function transform(source: string, opts = {}) {
		describe('fixtures', () => {
		testFixtureDir<TestConfig>(
		{
		root: path.resolve(__dirname, 'fixtures'),
		root: path.resolve(import.meta.dirname, 'fixtures'),
		pattern: '**/actual.js',
		ssrVersion: 2,
		},
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -42,7 +42,7 @@ const { code } = transformSync(source, filename, options);
		- `name` (type: `string`, required) - name of the component, e.g. `foo` in `x/foo`.
		- `namespace` (type: `string`, required) - namespace of the component, e.g. `x` in `x/foo`.
		- `stylesheetConfig` (type: `object`, default: `{}`) - Deprecated. Ignored by compiler.
		- `experimentalDynamicComponent` (type: `DynamicImportConfig`, default: `null`) - The configuration to pass to `@lwc/compiler`.
		- `dynamicImports` (type: `DynamicImportConfig`, default: `null`) - The configuration to pass to `@lwc/compiler`.
		- `experimentalDynamicDirective` (type: `boolean`, default: `false`) - The configuration to pass to `@lwc/template-compiler` to enable deprecated dynamic components.
		- `enableDynamicComponents` (type: `boolean`, default: `false`) - The configuration to pass to `@lwc/template-compiler` to enable dynamic components.
		- `outputConfig` (type: `object`, optional) - see below:
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -102,9 +102,8 @@ export interface TransformOptions {
		namespace: string;
		/** @deprecated Ignored by compiler. */
		stylesheetConfig?: StylesheetConfig;
		// TODO [#5031]: Unify dynamicImports and experimentalDynamicComponent options
		/** Config applied in usage of dynamic import statements in javascript */
		experimentalDynamicComponent?: DynamicImportConfig;
		dynamicImports?: DynamicImportConfig;
		// TODO [#3331]: deprecate and remove lwc:dynamic
		/** Flag to enable usage of dynamic component(lwc:dynamic) directive in HTML template */
		experimentalDynamicDirective?: boolean;
Expand DownExpand Up		@@ -163,7 +162,7 @@ type OptionalTransformKeys =
		\| 'enableDynamicComponents'
		\| 'enableSyntheticElementInternals'
		\| 'experimentalDynamicDirective'
		\| 'experimentalDynamicComponent'
		\| 'dynamicImports'
		\| 'componentFeatureFlagModulePath'
		\| 'instrumentation';

Expand DownExpand Up		@@ -246,9 +245,9 @@ function normalizeOptions(options: TransformOptions): NormalizedTransformOptions
		},
		};

		constexperimentalDynamicComponent: Required<DynamicImportConfig> = {
		constdynamicImports: Required<DynamicImportConfig> = {
		...DEFAULT_DYNAMIC_IMPORT_CONFIG,
		...options.experimentalDynamicComponent,
		...options.dynamicImports,
		};

		const apiVersion = getAPIVersionFromNumber(options.apiVersion);
Expand All		@@ -258,7 +257,7 @@ function normalizeOptions(options: TransformOptions): NormalizedTransformOptions
		...options,
		stylesheetConfig,
		outputConfig,
		experimentalDynamicComponent,
		dynamicImports,
		apiVersion,
		};
		}
Original file line number	Diff line number	Diff line change
Expand Up		@@ -131,7 +131,7 @@ describe('instrumentation', () => {
		`;
		await transform(actual, 'foo.js', {
		...BASE_TRANSFORM_OPTIONS,
		experimentalDynamicComponent: {
		dynamicImports: {
		loader: '@custom/loader',
		strictSpecifier: true,
		},
Expand Down