@lwrjs/everywhere 0.12.0-alpha.23 → 0.12.0-alpha.25

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/lwc/v/{6_2_1/s/2670f5386c68fa67ae710174187505e9 → 6_3_2/s/23bea0d197119b82d9452baf31b2d156}/lwc.js

@@ -1,4 +1,4 @@
-LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwc/v/6_3_2', ['exports'], (function (exports) { 'use strict';
 
   /**
    * Copyright (c) 2024 Salesforce, Inc.
@@ -302,13 +302,14 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       case 0 /* APIFeature.LOWERCASE_SCOPE_TOKENS */:
       case 1 /* APIFeature.TREAT_ALL_PARSE5_ERRORS_AS_ERRORS */:
         return apiVersion >= 59 /* APIVersion.V59_246_WINTER_24 */;
-      case 2 /* APIFeature.USE_FRAGMENTS_FOR_LIGHT_DOM_SLOTS */:
       case 3 /* APIFeature.DISABLE_OBJECT_REST_SPREAD_TRANSFORMATION */:
       case 4 /* APIFeature.SKIP_UNNECESSARY_REGISTER_DECORATORS */:
       case 5 /* APIFeature.USE_COMMENTS_FOR_FRAGMENT_BOOKENDS */:
+      case 2 /* APIFeature.USE_FRAGMENTS_FOR_LIGHT_DOM_SLOTS */:
         return apiVersion >= 60 /* APIVersion.V60_248_SPRING_24 */;
-      case 6 /* APIFeature.USE_LIGHT_DOM_SLOT_FORWARDING */:
+      case 8 /* APIFeature.ENABLE_ELEMENT_INTERNALS_AND_FACE */:
       case 7 /* APIFeature.ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE */:
+      case 6 /* APIFeature.USE_LIGHT_DOM_SLOT_FORWARDING */:
         return apiVersion >= 61 /* APIVersion.V61_250_SUMMER_24 */;
     }
   }
@@ -439,9 +440,9 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
   // Increment whenever the LWC template compiler changes
-  const LWC_VERSION = "6.2.1";
+  const LWC_VERSION = "6.3.2";
   const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-  /** version: 6.2.1 */
+  /** version: 6.3.2 */
 
   /**
    * Copyright (c) 2024 Salesforce, Inc.
@@ -455,6 +456,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
    */
   // When deprecating a feature flag, ensure that it is also no longer set in the application. For
   // example, in core, the flag should be removed from LwcPermAndPrefUtilImpl.java
+  /** List of all feature flags available, with the default value `null`. */
   const features = {
     PLACEHOLDER_TEST_FLAG: null,
     ENABLE_FORCE_NATIVE_SHADOW_MODE_FOR_TEST: null,
@@ -472,6 +474,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       value: create(null)
     });
   }
+  /** Feature flags that have been set. */
   const flags = globalThis.lwcRuntimeFlags;
   /**
    * Set the value at runtime of a given feature flag. This method only be invoked once per feature
@@ -527,7 +530,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       setFeatureFlag(name, value);
     }
   }
-  /** version: 6.2.1 */
+  /** version: 6.3.2 */
 
   /**
    * Copyright (c) 2024 Salesforce, Inc.
@@ -655,7 +658,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   }
 
   /*
-   * Copyright (c) 2018, 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
@@ -663,7 +666,6 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   const alreadyLoggedMessages = new Set();
   // Only used in LWC's Karma tests
   if (process.env.NODE_ENV === 'test-karma-lwc') {
-    // @ts-ignore
     window.__lwcResetAlreadyLoggedMessages = () => {
       alreadyLoggedMessages.clear();
     };
@@ -1030,6 +1032,16 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
     }
     return data;
   }
+  function shouldBeFormAssociated(Ctor) {
+    const ctorFormAssociated = Boolean(Ctor.formAssociated);
+    const apiVersion = getComponentAPIVersion(Ctor);
+    const apiFeatureEnabled = 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.
@@ -1295,7 +1307,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
             logError('The `addEventListener` method on ShadowRoot does not support any options.', getAssociatedVMIfPresent(this));
           }
           // Typescript does not like it when you treat the `arguments` object as an array
-          // @ts-ignore type-mismatch
+          // @ts-expect-error type-mismatch
           return originalAddEventListener.apply(this, arguments);
         }
       })
@@ -1344,7 +1356,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
             logError('The `addEventListener` method in `LightningElement` does not support any options.', getAssociatedVMIfPresent(this));
           }
           // Typescript does not like it when you treat the `arguments` object as an array
-          // @ts-ignore type-mismatch
+          // @ts-expect-error type-mismatch
           return originalAddEventListener.apply(this, arguments);
         }
       })
@@ -1736,7 +1748,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       valueMutated(originalTarget, key);
       return true;
     }
-    /*LWC compiler v6.2.1*/
+    /*LWC compiler v6.3.2*/
   }
   const getterMap = new WeakMap();
   const setterMap = new WeakMap();
@@ -1829,7 +1841,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       /* istanbul ignore next */
       return false;
     }
-    /*LWC compiler v6.2.1*/
+    /*LWC compiler v6.3.2*/
   }
   function extract(objectOrArray) {
     if (isArray(objectOrArray)) {
@@ -2186,7 +2198,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
    * This class is the base class for any LWC element.
    * Some elements directly extends this class, others implement it via inheritance.
    */
-  // @ts-ignore
+  // @ts-expect-error When exported, it will conform, but we need to build it first!
   const LightningElement = function () {
     // This should be as performant as possible, while any initialization should be done lazily
     if (isNull(vmBeingConstructed)) {
@@ -2273,69 +2285,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       logError(`this.${methodOrPropName} should not be called during the construction of the custom element for ${getComponentTag(vm)} because the element is not yet in the DOM or has no children yet.`);
     }
   }
-  // List of properties on ElementInternals that are formAssociated can be found in the spec:
-  // https://html.spec.whatwg.org/multipage/custom-elements.html#form-associated-custom-elements
-  const formAssociatedProps = new Set(['setFormValue', 'form', 'setValidity', 'willValidate', 'validity', 'validationMessage', 'checkValidity', 'reportValidity', 'labels']);
-  // Verify that access to a form-associated property of the ElementInternals proxy has formAssociated set in the LWC.
-  function verifyPropForFormAssociation(propertyKey, isFormAssociated) {
-    if (isString(propertyKey) && formAssociatedProps.has(propertyKey) && !isFormAssociated) {
-      //Note this error message mirrors Chrome and Firefox error messages, in Safari the error is slightly different.
-      throw new DOMException(`Failed to execute '${propertyKey}' on 'ElementInternals': The target element is not a form-associated custom element.`);
-    }
-  }
-  const elementInternalsAccessorAllowList = new Set(['shadowRoot', 'role', ...formAssociatedProps]);
-  // Prevent access to properties not defined in the HTML spec in case browsers decide to
-  // provide new APIs that provide access to form associated properties.
-  // This can be removed along with UpgradeableConstructor.
-  function isAllowedElementInternalAccessor(propertyKey) {
-    let isAllowedAccessor = false;
-    // As of this writing all ElementInternal property keys as described in the spec are implemented with strings
-    // in Chrome, Firefox, and Safari
-    if (isString(propertyKey)) {
-      // Allow list is based on HTML spec:
-      // https://html.spec.whatwg.org/multipage/custom-elements.html#the-elementinternals-interface
-      isAllowedAccessor = elementInternalsAccessorAllowList.has(propertyKey) || /^aria/.test(propertyKey);
-      if (!isAllowedAccessor && process.env.NODE_ENV !== 'production') {
-        logWarn('Only properties defined in the ElementInternals HTML spec are available.');
-      }
-    }
-    return isAllowedAccessor;
-  }
-  // Wrap all ElementInternal objects in a proxy to prevent form association when `formAssociated` is not set on an LWC.
-  // This is needed because the 1UpgradeableConstructor1 always sets `formAssociated=true`, which means all
-  // ElementInternal objects will have form-associated properties set when an LWC is placed in a form.
-  // We are doing this to guard against customers taking a dependency on form elements being associated to ElementInternals
-  // when 'formAssociated' has not been set on the LWC.
-  function createElementInternalsProxy(elementInternals, isFormAssociated) {
-    const elementInternalsProxy = new Proxy(elementInternals, {
-      set(target, propertyKey, newValue) {
-        if (isAllowedElementInternalAccessor(propertyKey)) {
-          // Verify that formAssociated is set for form associated properties
-          verifyPropForFormAssociation(propertyKey, isFormAssociated);
-          return Reflect.set(target, propertyKey, newValue);
-        }
-        // As of this writing ElementInternals do not have non-string properties that can be set.
-        return false;
-      },
-      get(target, propertyKey) {
-        if (
-        // Pass through Object.prototype methods such as toString()
-        hasOwnProperty$1.call(Object.prototype, propertyKey) ||
-        // As of this writing, ElementInternals only uses Symbol.toStringTag which is called
-        // on Object.hasOwnProperty invocations
-        Symbol.for('Symbol.toStringTag') === propertyKey ||
-        // ElementInternals allow listed properties
-        isAllowedElementInternalAccessor(propertyKey)) {
-          // Verify that formAssociated is set for form associated properties
-          verifyPropForFormAssociation(propertyKey, isFormAssociated);
-          const propertyValue = Reflect.get(target, propertyKey);
-          return isFunction$1(propertyValue) ? propertyValue.bind(target) : propertyValue;
-        }
-      }
-    });
-    return elementInternalsProxy;
-  }
-  // @ts-ignore
+  // Type assertion because we need to build the prototype before it satisfies the interface.
   LightningElement.prototype = {
     constructor: LightningElement,
     dispatchEvent(event) {
@@ -2488,19 +2438,18 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       const vm = getAssociatedVM(this);
       const {
         elm,
-        def: {
-          formAssociated
-        },
+        apiVersion,
         renderer: {
           attachInternals
         }
       } = vm;
+      if (!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 light DOM or synthetic shadow.');
+        throw new Error('attachInternals API is not supported in synthetic shadow.');
       }
-      const internals = attachInternals(elm);
-      // #TODO[2970]: remove proxy once `UpgradeableConstructor` has been removed
-      return createElementInternalsProxy(internals, Boolean(formAssociated));
+      return attachInternals(elm);
     },
     get isConnected() {
       const vm = getAssociatedVM(this);
@@ -2612,6 +2561,9 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       if (process.env.NODE_ENV !== 'production') {
         warnIfInvokedDuringConstruction(vm, 'childNodes');
       }
+      // getChildNodes returns a NodeList, which has `item(index: number): Node | null`.
+      // NodeListOf<T> extends NodeList, but claims to not return null. That seems inaccurate,
+      // but these are built-in types, so ultimately not our problem.
       return renderer.getChildNodes(vm.elm);
     },
     get firstChild() {
@@ -2739,11 +2691,10 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
    */
   const AdapterToTokenMap = new Map();
   function createContextProviderWithRegister(adapter, registerContextProvider) {
-    let adapterContextToken = AdapterToTokenMap.get(adapter);
-    if (!isUndefined$1(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) => {
@@ -2863,7 +2814,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       ro.observe(() => config = configCallback(component));
       // eslint-disable-next-line @lwc/lwc-internal/no-invalid-todo
       // TODO: dev-mode validation of config based on the adapter.configSchema
-      // @ts-ignore it is assigned in the observe() callback
+      // @ts-expect-error it is assigned in the observe() callback
       callbackWhenConfigIsReady(config);
     };
     return {
@@ -2947,7 +2898,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       });
     }
     return {
-      // @ts-ignore the boundary protection executes sync, connector is always defined
+      // @ts-expect-error the boundary protection executes sync, connector is always defined
       connector,
       computeConfigAndUpdate,
       resetConfigWatcher: () => ro.reset()
@@ -3448,7 +3399,6 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   let warned = false;
   // Only used in LWC's Karma tests
   if (process.env.NODE_ENV === 'test-karma-lwc') {
-    // @ts-ignore
     window.__lwcResetWarnedOnVersionMismatch = () => {
       warned = false;
     };
@@ -3572,7 +3522,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
         if (!isUndefined$1(superAttributeChangedCallback)) {
           // delegate unknown attributes to the super.
           // Typescript does not like it when you treat the `arguments` object as an array
-          // @ts-ignore type-mismatch
+          // @ts-expect-error type-mismatch
           superAttributeChangedCallback.apply(this, arguments);
         }
         return;
@@ -3598,7 +3548,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   }
   function HTMLBridgeElementFactory(SuperClass, publicProperties, methods, observedFields, proto, hasCustomSuperClass) {
     const HTMLBridgeElement = class extends SuperClass {
-      /*LWC compiler v6.2.1*/
+      /*LWC compiler v6.3.2*/
     };
     // generating the hash table for attributes to avoid duplicate fields and facilitate validation
     // and false positives in case of inheritance.
@@ -5161,7 +5111,8 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
     // compatibility, we lower case the tagname here.
     const normalizedTagname = sel.toLowerCase();
     const useNativeLifecycle = shouldUseNativeCustomElementLifecycle(ctor);
-    const elm = createCustomElement(normalizedTagname, upgradeCallback, useNativeLifecycle);
+    const isFormAssociated = shouldBeFormAssociated(ctor);
+    const elm = createCustomElement(normalizedTagname, upgradeCallback, useNativeLifecycle, isFormAssociated);
     vnode.elm = elm;
     vnode.vm = vm;
     linkNodeToShadow(elm, owner, renderer);
@@ -6471,9 +6422,27 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       }
     }
   }
+  // This should be a no-op outside of LWC's Karma tests, where it's not needed
+  let registerFragmentCache = noop;
+  // Only used in LWC's Karma tests
+  if (process.env.NODE_ENV === 'test-karma-lwc') {
+    // Keep track of fragmentCaches, so we can clear them in LWC's Karma tests
+    const fragmentCaches = [];
+    registerFragmentCache = fragmentCache => {
+      fragmentCaches.push(fragmentCache);
+    };
+    window.__lwcResetFragmentCaches = () => {
+      for (const fragmentCache of fragmentCaches) {
+        for (const key of keys(fragmentCache)) {
+          delete fragmentCache[key];
+        }
+      }
+    };
+  }
   function buildParseFragmentFn(createFragmentFn) {
     return (strings, ...keys) => {
       const cache = create(null);
+      registerFragmentCache(cache);
       return function () {
         const {
           context: {
@@ -6494,11 +6463,6 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
         if (hasStyleToken && isSyntheticShadow) {
           cacheKey |= 2 /* FragmentCache.SHADOW_MODE_SYNTHETIC */;
         }
-        if (hasLegacyToken) {
-          // This isn't strictly required for prod, but it's required for our karma tests
-          // since the lwcRuntimeFlag may change over time
-          cacheKey |= 4 /* FragmentCache.HAS_LEGACY_SCOPE_TOKEN */;
-        }
         if (!isUndefined$1(cache[cacheKey])) {
           return cache[cacheKey];
         }
@@ -7463,18 +7427,8 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   function runFormAssociatedCustomElementCallback(vm, faceCb) {
     const {
       renderMode,
-      shadowMode,
-      def: {
-        formAssociated
-      }
+      shadowMode
     } = vm;
-    // Technically the UpgradableConstructor always sets `static formAssociated = true` but silently fail here to match browser behavior.
-    if (isUndefined$1(formAssociated) || isFalse(formAssociated)) {
-      if (process.env.NODE_ENV !== 'production') {
-        logWarn(`Form associated lifecycle methods must have the 'static formAssociated' value set in the component's prototype chain.`);
-      }
-      return;
-    }
     if (shadowMode === 1 /* ShadowMode.Synthetic */ && renderMode !== 0 /* RenderMode.Light */) {
       throw new Error('Form associated lifecycle methods are not available in synthetic shadow. Please use native shadow or light DOM.');
     }
@@ -7750,7 +7704,6 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
           throw new Error('detect-non-standard-aria.ts loaded before @lwc/aria-reflection');
         }
       }
-      // @ts-ignore
       const {
         get,
         set
@@ -8005,7 +7958,8 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       defineCustomElement,
       getTagName
     } = renderer;
-    defineCustomElement(StringToLowerCase.call(getTagName(elm)));
+    const isFormAssociated = shouldBeFormAssociated(ctor);
+    defineCustomElement(StringToLowerCase.call(getTagName(elm)), isFormAssociated);
     const vm = createVM(elm, ctor, renderer, {
       mode,
       owner,
@@ -8421,7 +8375,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       const originalArrayMethod = getOriginalArrayMethod(prop);
       stylesheets[prop] = function arrayMutationWarningWrapper() {
         reportTemplateViolation('stylesheets');
-        // @ts-ignore
+        // @ts-expect-error can't properly determine the right `this`
         return originalArrayMethod.apply(this, arguments);
       };
     }
@@ -8603,7 +8557,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
     }
     return getReadOnlyProxy(obj);
   }
-  /** version: 6.2.1 */
+  /** version: 6.3.2 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -8700,7 +8654,6 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   //
   // Only used in LWC's Karma tests
   if (process.env.NODE_ENV === 'test-karma-lwc') {
-    // @ts-ignore
     window.__lwcResetGlobalStylesheets = () => {
       stylesheetCache.clear();
     };
@@ -8833,11 +8786,9 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   // Another benefit is that only LWC can create components that actually do anything – if you do
   // `customElements.define('x-foo')`, then you don't have access to the upgradeCallback, so it's a dummy custom element.
   // This class should be created once per tag name.
-  const createUpgradableConstructor = () => {
+  const createUpgradableConstructor = isFormAssociated => {
     // TODO [#2972]: this class should expose observedAttributes as necessary
     class UpgradableConstructor extends HTMLElement {
-      // TODO [#3983]: Re-enable formAssociated once there is a solution for the observable behavior it introduces.
-      // static formAssociated = true;
       constructor(upgradeCallback, useNativeLifecycle) {
         super();
         if (useNativeLifecycle) {
@@ -8854,8 +8805,9 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
         // TODO [#2970]: LWC elements cannot be upgraded via new Ctor()
         // Do we want to support this? Throw an error? Currently for backwards compat it's a no-op.
       }
-      /*LWC compiler v6.2.1*/
+      /*LWC compiler v6.3.2*/
     }
+    UpgradableConstructor.formAssociated = isFormAssociated;
     for (const [propName, callback] of entries(LIFECYCLE_CALLBACKS)) {
       UpgradableConstructor.prototype[propName] = function () {
         // If the element is in the WeakMap (i.e. it's marked as native lifecycle), and if it was upgraded by LWC,
@@ -8867,22 +8819,25 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
     }
     return UpgradableConstructor;
   };
-  function getUpgradableConstructor(tagName) {
+  function getUpgradableConstructor(tagName, isFormAssociated) {
     let UpgradableConstructor = cachedConstructors.get(tagName);
     if (isUndefined$1(UpgradableConstructor)) {
       if (!isUndefined$1(customElements.get(tagName))) {
         throw new Error(`Unexpected tag name "${tagName}". This name is a registered custom element, preventing LWC to upgrade the element.`);
       }
-      UpgradableConstructor = createUpgradableConstructor();
+      UpgradableConstructor = createUpgradableConstructor(isFormAssociated);
       customElements.define(tagName, UpgradableConstructor);
       cachedConstructors.set(tagName, UpgradableConstructor);
     }
     return UpgradableConstructor;
   }
-  const createCustomElement = (tagName, upgradeCallback, useNativeLifecycle) => {
-    const UpgradableConstructor = getUpgradableConstructor(tagName);
+  const createCustomElement = (tagName, upgradeCallback, useNativeLifecycle, isFormAssociated) => {
+    const UpgradableConstructor = getUpgradableConstructor(tagName, isFormAssociated);
     elementBeingUpgradedByLWC = true;
     try {
+      if (UpgradableConstructor.formAssociated !== isFormAssociated) {
+        throw new Error(`<${tagName}> was already registered with formAssociated=${UpgradableConstructor.formAssociated}. It cannot be re-registered with formAssociated=${isFormAssociated}. Please rename your component to have a different name than <${tagName}>`);
+      }
       return new UpgradableConstructor(upgradeCallback, useNativeLifecycle);
     } finally {
       elementBeingUpgradedByLWC = false;
@@ -8899,12 +8854,15 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
    * A factory function that produces a renderer.
    * Renderer encapsulates operations that are required to render an LWC component into the underlying
    * runtime environment. In the case of @lwc/enigne-dom, it is meant to be used in a DOM environment.
-   * Example usage:
+   * @param baseRenderer Either null or the base renderer imported from 'lwc'.
+   * @returns The created renderer
+   * @example
    * import { renderer, rendererFactory } from 'lwc';
    * const customRenderer = rendererFactory(renderer);
-   * @param baseRenderer Either null or the base renderer imported from 'lwc'.
    */
   function rendererFactory(baseRenderer) {
+    // Type assertion because this is replaced by rollup with an object, not a string.
+    // See `injectInlineRenderer` in /scripts/rollup/rollup.config.js
     const renderer = function (exports) {
       /**
        * Copyright (c) 2024 Salesforce, Inc.
@@ -8975,7 +8933,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       function isNull(obj) {
         return obj === null;
       }
-      /** version: 6.2.1 */
+      /** version: 6.3.2 */
 
       /*
        * Copyright (c) 2023, salesforce.com, inc.
@@ -8995,7 +8953,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
           this.setNewContext = setNewContext;
           this.setDisconnectedCallback = setDisconnectedCallback;
         }
-        /*LWC compiler v6.2.1*/
+        /*LWC compiler v6.3.2*/
       }
       function registerContextConsumer(elm, adapterContextToken, subscriptionPayload) {
         dispatchEvent(elm, new WireContextSubscriptionEvent(adapterContextToken, subscriptionPayload));
@@ -9254,6 +9212,18 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
     }
     return vm;
   }
+  /**
+   * Replaces an existing DOM node with an LWC component.
+   * @param element The existing node in the DOM that where the root component should be attached.
+   * @param Ctor The LWC class to use as the root component.
+   * @param props Any props for the root component as part of initial client-side rendering. The props must be identical to those passed to renderComponent during SSR.
+   * @throws Throws when called with invalid parameters.
+   * @example
+   * import { hydrateComponent } from 'lwc';
+   * import App from 'x/App';
+   * const elm = document.querySelector('x-app');
+   * hydrateComponent(elm, App, { name: 'Hello World' });
+   */
   function hydrateComponent(element, Ctor, props = {}) {
     if (!(element instanceof Element)) {
       throw new TypeError(`"hydrateComponent" expects a valid DOM element as the first parameter but instead received ${element}.`);
@@ -9274,7 +9244,8 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
         defineCustomElement,
         getTagName
       } = renderer;
-      defineCustomElement(StringToLowerCase.call(getTagName(element)));
+      const isFormAssociated = shouldBeFormAssociated(Ctor);
+      defineCustomElement(StringToLowerCase.call(getTagName(element)), isFormAssociated);
       const vm = createVMWithProps(element, Ctor, props);
       hydrateRoot(vm);
     } catch (e) {
@@ -9299,15 +9270,14 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   /**
    * This function builds a Web Component class from a LWC constructor so it can be
    * registered as a new element via customElements.define() at any given time.
-   * @param Ctor
+   * @param Ctor LWC constructor to build
+   * @returns A Web Component class
    * @example
-   * ```
    * import { buildCustomElementConstructor } from 'lwc';
    * import Foo from 'ns/foo';
    * const WC = buildCustomElementConstructor(Foo);
    * customElements.define('x-foo', WC);
    * const elm = document.createElement('x-foo');
-   * ```
    * @deprecated since version 1.3.11
    */
   function deprecatedBuildCustomElementConstructor(Ctor) {
@@ -9323,6 +9293,13 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       renderer.remove(childNodes[i], node);
     }
   }
+  /**
+   * The real `buildCustomElementConstructor`. Should not be accessible to external users!
+   * @internal
+   * @param Ctor LWC constructor to build
+   * @returns A Web Component class
+   * @see {@linkcode deprecatedBuildCustomElementConstructor}
+   */
   function buildCustomElementConstructor(Ctor) {
     var _a;
     const HtmlPrototype = getComponentHtmlPrototype(Ctor);
@@ -9374,8 +9351,23 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       attributeChangedCallback(name, oldValue, newValue) {
         attributeChangedCallback.call(this, name, oldValue, newValue);
       }
-      /*LWC compiler v6.2.1*/
-    }, _a.observedAttributes = observedAttributes, _a;
+      formAssociatedCallback() {
+        runFormAssociatedCallback(this);
+      }
+      formDisabledCallback() {
+        runFormDisabledCallback(this);
+      }
+      formResetCallback() {
+        runFormResetCallback(this);
+      }
+      formStateRestoreCallback() {
+        runFormStateRestoreCallback(this);
+      }
+      /*LWC compiler v6.3.2*/
+    }, _a.observedAttributes = observedAttributes,
+    // Note CustomElementConstructor is not upgraded by LWC and inherits directly from HTMLElement which means it calls the native
+    // attachInternals API.
+    _a.formAssociated = Boolean(Ctor.formAssociated), _a;
   }
 
   /*
@@ -9443,17 +9435,17 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
    * difference that in the options, you can pass the `is` property set to a Constructor instead of
    * just a string value. The intent is to allow the creation of an element controlled by LWC without
    * having to register the element as a custom element.
-   * @param sel
-   * @param options
-   * @param options.is description
-   * @param options.mode
+   * @param sel The tagname of the element to create
+   * @param options Control the behavior of the created element
+   * @param options.is The LWC component that the element should be
+   * @param options.mode What kind of shadow root to use
+   * @returns The created HTML element
+   * @throws Throws when called with invalid parameters.
    * @example
-   * ```
    * const el = createElement('x-foo', { is: FooCtor });
-   * ```
    */
-  /* eslint-enable jsdoc/valid-types */
-  function createElement(sel, options) {
+  function createElement( /* eslint-enable jsdoc/valid-types */
+  sel, options) {
     if (!isObject(options) || isNull(options)) {
       throw new TypeError(`"createElement" function expects an object as second parameter but received "${toString$1(options)}".`);
     }
@@ -9472,13 +9464,13 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
     const useNativeCustomElementLifecycle =
     // temporary "kill switch"
     !lwcRuntimeFlags.DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE && isAPIFeatureEnabled(7 /* APIFeature.ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE */, apiVersion);
+    const isFormAssociated = shouldBeFormAssociated(Ctor);
     // the custom element from the registry is expecting an upgrade callback
-    /**
+    /*
      * Note: if the upgradable constructor does not expect, or throw when we new it
      * with a callback as the first argument, we could implement a more advanced
      * mechanism that only passes that argument if the constructor is known to be
      * an upgradable custom element.
-     * @param elm
      */
     const upgradeCallback = elm => {
       createVM(elm, Ctor, renderer, {
@@ -9494,7 +9486,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
         DisconnectingSlot.set(elm, disconnectRootElement);
       }
     };
-    return createCustomElement(tagName, upgradeCallback, useNativeCustomElementLifecycle);
+    return createCustomElement(tagName, upgradeCallback, useNativeCustomElementLifecycle, isFormAssociated);
   }
 
   /*
@@ -9509,7 +9501,9 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
   /**
    * EXPERIMENTAL: The purpose of this function is to detect shadowed nodes. THIS API WILL BE REMOVED
    * ONCE LOCKER V1 IS NO LONGER SUPPORTED.
-   * @param node
+   * @param node Node to check
+   * @returns `true` if the the node is shadowed
+   * @example isNodeShadowed(document.querySelector('my-component'))
    */
   function isNodeShadowed(node) {
     if (isFalse(node instanceof _Node)) {
@@ -9581,6 +9575,11 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
    * SPDX-License-Identifier: MIT
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
+  /**
+   * Creates a context provider, given a wire adapter constructor.
+   * @param adapter The wire adapter to create a context provider for.
+   * @returns A new context provider.
+   */
   function createContextProvider(adapter) {
     return createContextProviderWithRegister(adapter, registerContextProvider);
   }
@@ -9597,7 +9596,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       });
     });
   }
-  /** version: 6.2.1 */
+  /** version: 6.3.2 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;