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

package/build/__generated_site_amd_modules__/1/application/amd/l/en-US/ai/amd-bootstrap/configuration/ci/-/-/s/7c3f260b17cfe185b1f9c047326a6923/config.js

@@ -0,0 +1,7 @@
+/* This script is generated */
+/* Client Bootstrap configuration */
+globalThis.LWR = globalThis.LWR || {};
+Object.assign(globalThis.LWR, {"appId":"amd-bootstrap","bootstrapModule":"@lwrjs/app-service/amd-bootstrap/module/amd/v/0_12_0-alpha_24","autoBoot":true,"imports":{"/1/module/amd/1/l/en-US/mi/%40lwrjs%2Fapp-service%2Famd-bootstrap%2Fmodule%2Famd%2Fv%2F0_12_0-alpha_24/s/8bce578258518655194bd71d1d72aad5/@lwrjs_app-service_amd-bootstrap_module_amd.js":["@lwrjs/app-service/amd-bootstrap/module/amd/v/0_12_0-alpha_24"],"/1/module/amd/1/l/en-US/mi/lwr%2FpreInit%2Fv%2F0_12_0-alpha_24/s/ec0fad0e38a96bb0b88c9f4553460347/lwr_preInit.js":["lwr/preInit/v/0_12_0-alpha_24"],"/1/module/amd/1/l/en-US/mi/lwr%2Finit%2Fv%2F0_12_0-alpha_24/s/f30361ad8ff7af505bf4d465c8499181/lwr_init.js":["lwr/init/v/0_12_0-alpha_24"],"/1/module/amd/1/l/en-US/mi/lwr%2Fmetrics%2Fv%2F0_12_0-alpha_24/s/274c8343f810353bbad085a79709395f/lwr_metrics.js":["lwr/metrics/v/0_12_0-alpha_24"],"/1/module/amd/1/l/en-US/mi/lwc%2Fv%2F6_3_1/s/62e57444bb0d15355b145ddacc9d7286/lwc.js":["lwc/v/6_3_1"],"/1/module/amd/1/l/en-US/mi/lwr%2FeverywhereAmd%2Fv%2F0_12_0-alpha_24/s/cb931ebef2b89dcf8ab51456e3a68864/lwr_everywhereAmd.js":["lwr/everywhereAmd/v/0_12_0-alpha_24"],"/1/module/amd/1/l/en-US/mi/lwr%2Fvault%2Fv%2F0_12_0-alpha_24/s/c92abd8c1fec2d7eff62e4b097abbe14/lwr_vault.js":["lwr/vault/v/0_12_0-alpha_24"]},"index":{"@lwrjs/app-service/amd-bootstrap/module/amd/v/0_12_0-alpha_24":"/1/module/amd/1/l/en-US/mi/%40lwrjs%2Fapp-service%2Famd-bootstrap%2Fmodule%2Famd%2Fv%2F0_12_0-alpha_24/s/8bce578258518655194bd71d1d72aad5/@lwrjs_app-service_amd-bootstrap_module_amd.js","lwr/preInit/v/0_12_0-alpha_24":"/1/module/amd/1/l/en-US/mi/lwr%2FpreInit%2Fv%2F0_12_0-alpha_24/s/ec0fad0e38a96bb0b88c9f4553460347/lwr_preInit.js","lwr/init/v/0_12_0-alpha_24":"/1/module/amd/1/l/en-US/mi/lwr%2Finit%2Fv%2F0_12_0-alpha_24/s/f30361ad8ff7af505bf4d465c8499181/lwr_init.js","lwr/metrics/v/0_12_0-alpha_24":"/1/module/amd/1/l/en-US/mi/lwr%2Fmetrics%2Fv%2F0_12_0-alpha_24/s/274c8343f810353bbad085a79709395f/lwr_metrics.js","lwc/v/6_3_1":"/1/module/amd/1/l/en-US/mi/lwc%2Fv%2F6_3_1/s/62e57444bb0d15355b145ddacc9d7286/lwc.js","lwr/everywhereAmd/v/0_12_0-alpha_24":"/1/module/amd/1/l/en-US/mi/lwr%2FeverywhereAmd%2Fv%2F0_12_0-alpha_24/s/cb931ebef2b89dcf8ab51456e3a68864/lwr_everywhereAmd.js","lwr/vault/v/0_12_0-alpha_24":"/1/module/amd/1/l/en-US/mi/lwr%2Fvault%2Fv%2F0_12_0-alpha_24/s/c92abd8c1fec2d7eff62e4b097abbe14/lwr_vault.js"},"rootComponents":["lwr/everywhereAmd/v/0_12_0-alpha_24"],"serverData":{},"requiredModules":["@lwrjs/app-service/amd-bootstrap/module/amd/v/0_12_0-alpha_24"],"preloadModules":["lwr/preInit/v/0_12_0-alpha_24","lwr/init/v/0_12_0-alpha_24","lwr/metrics/v/0_12_0-alpha_24","lwc/v/6_3_1","lwr/everywhereAmd/v/0_12_0-alpha_24"],"endpoints":{"uris":{"mapping":"/1/mapping/amd/1/l/en-US/mp/"}}});
+globalThis.LWR = {...globalThis.LWR, env: {"SSR":false,"basePath":"","locale":"en-US","assetBasePath":"","uiBasePath":""}};
+globalThis.process={...globalThis.process,env:{...globalThis.process?.env,...{"NODE_ENV":"compat"}}};
+globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: false };

package/build/__generated_site_amd_modules__/1/module/amd/1/l/en-US/mi/@lwrjs/app-service/amd-bootstrap/module/amd/v/0_12_0-alpha_24/s/8bce578258518655194bd71d1d72aad5/@lwrjs_app-service_amd-bootstrap_module_amd.js

@@ -0,0 +1,14 @@
+LWR.define('@lwrjs/app-service/amd-bootstrap/module/amd/v/0_12_0-alpha_24', ['lwr/loader/v/0_12_0-alpha_24', 'lwr/preInit/v/0_12_0-alpha_24', 'lwr/init/v/0_12_0-alpha_24'], (function (_0_12_0Alpha_24$2, _0_12_0Alpha_24, _0_12_0Alpha_24$1) { 'use strict';
+
+    const clientBootstrapConfig = _0_12_0Alpha_24.getClientBootstrapConfig();
+
+    // initialize additional non-configured root components
+    const { rootComponents, serverData } = clientBootstrapConfig;
+    Promise.all(rootComponents.map(async (rootSpecifier) => {
+        const element = _0_12_0Alpha_24$1.toKebabCase(rootSpecifier);
+        return _0_12_0Alpha_24$2.load(rootSpecifier, '@lwrjs/app-service/amd-bootstrap/module/amd/v/0_12_0-alpha_24').then(({default: Ctor}) => {
+            _0_12_0Alpha_24$1.init([[element, Ctor]], serverData);
+        });
+    }));
+
+}));

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

@@ -1,4 +1,4 @@
-LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwc/v/6_3_1', ['exports'], (function (exports) { 'use strict';
 
   /**
    * Copyright (c) 2024 Salesforce, Inc.
@@ -309,6 +309,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
         return apiVersion >= 60 /* APIVersion.V60_248_SPRING_24 */;
       case 6 /* APIFeature.USE_LIGHT_DOM_SLOT_FORWARDING */:
       case 7 /* APIFeature.ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE */:
+      case 8 /* APIFeature.ENABLE_ELEMENT_INTERNALS */:
         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.1";
   const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-  /** version: 6.2.1 */
+  /** version: 6.3.1 */
 
   /**
    * 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.1 */
 
   /**
    * 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();
     };
@@ -1295,7 +1297,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 +1346,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 +1738,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.1*/
   }
   const getterMap = new WeakMap();
   const setterMap = new WeakMap();
@@ -1829,7 +1831,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.1*/
   }
   function extract(objectOrArray) {
     if (isArray(objectOrArray)) {
@@ -2186,7 +2188,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 +2275,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 +2428,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 */, 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 (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 +2551,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() {
@@ -2863,7 +2805,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 +2889,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 +3390,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 +3513,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 +3539,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.1*/
     };
     // generating the hash table for attributes to avoid duplicate fields and facilitate validation
     // and false positives in case of inheritance.
@@ -5161,7 +5102,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 = Boolean(ctor.formAssociated);
+    const elm = createCustomElement(normalizedTagname, upgradeCallback, useNativeLifecycle, isFormAssociated);
     vnode.elm = elm;
     vnode.vm = vm;
     linkNodeToShadow(elm, owner, renderer);
@@ -6471,9 +6413,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 +6454,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 +7418,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 +7695,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 +7949,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       defineCustomElement,
       getTagName
     } = renderer;
-    defineCustomElement(StringToLowerCase.call(getTagName(elm)));
+    defineCustomElement(StringToLowerCase.call(getTagName(elm)), Boolean(ctor.formAssociated));
     const vm = createVM(elm, ctor, renderer, {
       mode,
       owner,
@@ -8421,7 +8365,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 +8547,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
     }
     return getReadOnlyProxy(obj);
   }
-  /** version: 6.2.1 */
+  /** version: 6.3.1 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -8700,7 +8644,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 +8776,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 +8795,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.1*/
     }
+    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 +8809,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 +8844,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 +8923,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.1 */
 
       /*
        * Copyright (c) 2023, salesforce.com, inc.
@@ -8995,7 +8943,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.1*/
       }
       function registerContextConsumer(elm, adapterContextToken, subscriptionPayload) {
         dispatchEvent(elm, new WireContextSubscriptionEvent(adapterContextToken, subscriptionPayload));
@@ -9254,6 +9202,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 +9234,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
         defineCustomElement,
         getTagName
       } = renderer;
-      defineCustomElement(StringToLowerCase.call(getTagName(element)));
+      defineCustomElement(StringToLowerCase.call(getTagName(element)), Boolean(Ctor.formAssociated));
       const vm = createVMWithProps(element, Ctor, props);
       hydrateRoot(vm);
     } catch (e) {
@@ -9299,15 +9259,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 +9282,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 +9340,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.1*/
+    }, _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 +9424,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 +9453,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 = Boolean(Ctor.formAssociated);
     // 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 +9475,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 +9490,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 +9564,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 +9585,7 @@ LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
       });
     });
   }
-  /** version: 6.2.1 */
+  /** version: 6.3.1 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;