@lwc/engine-core 6.3.1 → 6.3.3

package/dist/framework/main.d.ts

@@ -3,7 +3,7 @@ export { RenderMode, ShadowMode, connectRootElement, createVM, disconnectRootEle
 export { createContextProviderWithRegister } from './wiring';
 export { parseFragment, parseSVGFragment } from './template';
 export { hydrateRoot } from './hydration';
-export { registerComponent, getComponentAPIVersion } from './component';
+export { registerComponent } from './component';
 export { registerTemplate } from './secure-template';
 export { registerDecorators } from './decorators/register';
 export { unwrap } from './membrane';
@@ -14,6 +14,8 @@ export { reportingControl as __unstable__ReportingControl } from './reporting';
 export { swapTemplate, swapComponent, swapStyle } from './hot-swaps';
 export { setHooks } from './overridable-hooks';
 export { freezeTemplate } from './freeze-template';
+export { getComponentAPIVersion } from './component';
+export { shouldBeFormAssociated } from './utils';
 export { getComponentConstructor } from './get-component-constructor';
 export type { RendererAPI, LifecycleCallback } from './renderer';
 export type { ConfigValue as WireConfigValue, ContextValue as WireContextValue, DataCallback, WireAdapter, WireAdapterConstructor, WireAdapterSchemaValue, WireContextSubscriptionPayload, WireContextSubscriptionCallback, } from './wiring';

package/dist/framework/utils.d.ts

@@ -37,4 +37,5 @@ export declare function applyTemporaryCompilerV5SlotFix(data: VElementData): VEl
     svg?: boolean | undefined;
     renderer?: import("./renderer").RendererAPI | undefined;
 };
+export declare function shouldBeFormAssociated(Ctor: LightningElementConstructor): boolean;
 export {};

package/dist/index.cjs.js

@@ -526,6 +526,18 @@ function applyTemporaryCompilerV5SlotFix(data) {
     }
     return data;
 }
+function shouldBeFormAssociated(Ctor) {
+    const ctorFormAssociated = Boolean(Ctor.formAssociated);
+    const apiVersion = getComponentAPIVersion(Ctor);
+    const apiFeatureEnabled = shared.isAPIFeatureEnabled(8 /* APIFeature.ENABLE_ELEMENT_INTERNALS_AND_FACE */, apiVersion);
+    if (process.env.NODE_ENV !== 'production' && ctorFormAssociated && !apiFeatureEnabled) {
+        const tagName = getComponentRegisteredName(Ctor);
+        logWarnOnce(`Component <${tagName}> set static formAssociated to true, but form ` +
+            `association is not enabled because the API version is ${apiVersion}. To enable form association, ` +
+            `update the LWC component API version to 61 or above. https://lwc.dev/guide/versioning`);
+    }
+    return ctorFormAssociated && apiFeatureEnabled;
+}
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -655,7 +667,6 @@ shared.forEach.call(defaultDefHTMLPropertyNames, (propName) => {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-/* eslint @lwc/lwc-internal/no-production-assert: "off" */
 function generateDataDescriptor(options) {
     return shared.assign({
         configurable: true,
@@ -1761,8 +1772,10 @@ LightningElement.prototype = {
     attachInternals() {
         const vm = getAssociatedVM(this);
         const { elm, apiVersion, renderer: { attachInternals }, } = vm;
-        if (!shared.isAPIFeatureEnabled(8 /* APIFeature.ENABLE_ELEMENT_INTERNALS */, apiVersion)) {
-            throw new Error(`The attachInternals API is only supported in API version 61 and above. To use this API please update the LWC component API version.`);
+        if (!shared.isAPIFeatureEnabled(8 /* APIFeature.ENABLE_ELEMENT_INTERNALS_AND_FACE */, apiVersion)) {
+            throw new Error(`The attachInternals API is only supported in API version 61 and above. ` +
+                `The current version is ${apiVersion}. ` +
+                `To use this API, update the LWC component API version. https://lwc.dev/guide/versioning`);
         }
         if (vm.shadowMode === 1 /* ShadowMode.Synthetic */) {
             throw new Error('attachInternals API is not supported in synthetic shadow.');
@@ -2005,11 +2018,10 @@ function createObservedFieldPropertyDescriptor(key) {
  */
 const AdapterToTokenMap = new Map();
 function createContextProviderWithRegister(adapter, registerContextProvider) {
-    let adapterContextToken = AdapterToTokenMap.get(adapter);
-    if (!shared.isUndefined(adapterContextToken)) {
+    if (AdapterToTokenMap.has(adapter)) {
         throw new Error(`Adapter already has a context provider.`);
     }
-    adapterContextToken = guid();
+    const adapterContextToken = guid();
     AdapterToTokenMap.set(adapter, adapterContextToken);
     const providers = new WeakSet();
     return (elmOrComponent, options) => {
@@ -4241,7 +4253,7 @@ function mountCustomElement(vnode, parent, anchor, renderer) {
     // compatibility, we lower case the tagname here.
     const normalizedTagname = sel.toLowerCase();
     const useNativeLifecycle = shouldUseNativeCustomElementLifecycle(ctor);
-    const isFormAssociated = Boolean(ctor.formAssociated);
+    const isFormAssociated = shouldBeFormAssociated(ctor);
     const elm = createCustomElement(normalizedTagname, upgradeCallback, useNativeLifecycle, isFormAssociated);
     vnode.elm = elm;
     vnode.vm = vm;
@@ -5907,7 +5919,7 @@ function getWrappedComponentsListener(vm, listener) {
 }
 
 /*
- * Copyright (c) 2023, Salesforce.com, inc.
+ * Copyright (c) 2024, Salesforce, Inc.
  * All rights reserved.
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
@@ -6128,14 +6140,13 @@ function computeShadowAndRenderMode(Ctor, renderer) {
     return { renderMode, shadowMode };
 }
 function computeShadowMode(def, owner, renderer, hydrated) {
+    if (
     // Force the shadow mode to always be native. Used for running tests with synthetic shadow patches
     // on, but components running in actual native shadow mode
-    if (process.env.NODE_ENV !== 'production' &&
-        lwcRuntimeFlags.ENABLE_FORCE_NATIVE_SHADOW_MODE_FOR_TEST) {
-        return 0 /* ShadowMode.Native */;
-    }
-    if (shared.isTrue(hydrated)) {
+    (process.env.NODE_ENV === 'test-karma-lwc' &&
+        process.env.FORCE_NATIVE_SHADOW_MODE_FOR_TEST) ||
         // hydration only supports native shadow
+        shared.isTrue(hydrated)) {
         return 0 /* ShadowMode.Native */;
     }
     const { isSyntheticShadowDefined } = renderer;
@@ -6971,7 +6982,8 @@ function hydrateCustomElement(elm, vnode, renderer) {
     }
     const { sel, mode, ctor, owner } = vnode;
     const { defineCustomElement, getTagName } = renderer;
-    defineCustomElement(shared.StringToLowerCase.call(getTagName(elm)), Boolean(ctor.formAssociated));
+    const isFormAssociated = shouldBeFormAssociated(ctor);
+    defineCustomElement(shared.StringToLowerCase.call(getTagName(elm)), isFormAssociated);
     const vm = createVM(elm, ctor, renderer, {
         mode,
         owner,
@@ -7585,11 +7597,12 @@ exports.runFormResetCallback = runFormResetCallback;
 exports.runFormStateRestoreCallback = runFormStateRestoreCallback;
 exports.sanitizeAttribute = sanitizeAttribute;
 exports.setHooks = setHooks;
+exports.shouldBeFormAssociated = shouldBeFormAssociated;
 exports.swapComponent = swapComponent;
 exports.swapStyle = swapStyle;
 exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/** version: 6.3.1 */
+/** version: 6.3.3 */
 //# sourceMappingURL=index.cjs.js.map